下载专区

M56 AT 命令手册 GSM/GPRS 系列 版本：M56_AT 命令手册_V1.0 日期：2018-09-30 状态：受控文件 www.quectel.com M56 AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2018，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2018. 上海移远通信技术股份有限公司 1 / 216 M56 AT 命令手册 文档历史 修订记录 版本 1.0 日期 2018-09-30 作者 马进永 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 216 M56 AT 命令手册 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................ 3 表格索引 ..................................................................................................................................................... 9 1 引言 ................................................................................................................................................... 10 1.1. 本章概要 ................................................................................................................................. 10 1.2. AT 命令术语缩写和惯例 .......................................................................................................... 10 1.3. AT 命令语法............................................................................................................................ 10 1.3.1. AT 命令类型 ................................................................................................................. 10 1.3.2. AT 命令连写 ..................................................................................................................11 1.4. 支持的字符集 ...........................................................................................................................11 1.5. 流控简介 ................................................................................................................................. 12 1.5.1. 软件流控 ...................................................................................................................... 12 1.5.2. 硬件流控 ...................................................................................................................... 12 2 AT 命令详解 ...................................................................................................................................... 13 2.1. AT 命令格式 ........................................................................................................................... 13 2.2. ATI 显示产品 ID 信息 ............................................................................................................. 13 2.3. AT+GMI 请求制造商 ID 信息 .................................................................................................. 14 2.4. AT+GMM 请求 TA 制造商和型号信息..................................................................................... 14 2.5. AT+GMR 请求 TA 软件版本信息 ............................................................................................ 15 2.6. AT+GOI 请求全球目标识别 ID................................................................................................ 15 2.7. AT+CGMI 请求制造商 ID 信息 ............................................................................................... 16 2.8. AT+CGMM 请求 TA 制造商和型号信息 .................................................................................. 16 2.9. AT+CGMR 请求 TA 软件版本信息.......................................................................................... 17 2.10. AT+GSN 请求 TA 序列号（IMEI 号） .................................................................................... 18 2.11. AT+CGSN 请求 TA 序列号（IMEI 号） .................................................................................. 18 2.12. AT+QGSN 请求 TA 序列号（IMEI 号）.................................................................................. 19 2.13. AT&F 设置所有 TA 参数为出厂配置 ....................................................................................... 20 2.14. AT&V 显示当前配置 ............................................................................................................... 21 2.15. AT&W 保存用户配置参数 ....................................................................................................... 21 2.16. ATQ 设置结果码显示模式 ...................................................................................................... 22 2.17. ATV 设置 TA 响应返回内容格式 ............................................................................................. 23 2.18. ATX 设置 CONNECT 结果码格式和检测呼叫进程 ................................................................. 24 2.19. ATZ 复位为缺省配置 .............................................................................................................. 25 2.20. AT+CFUN 设置模块功能 ........................................................................................................ 25 2.21. AT+QPOWD 关机 .................................................................................................................. 27 2.22. AT+CMEE 上报移动设备错误 ................................................................................................ 28 2.23. AT+CSCS 选择 TE 字符集 ..................................................................................................... 29 2.24. AT+GCAP 请求 TA 功能列表.................................................................................................. 30 3 串行接口控制命令 ............................................................................................................................. 32 3.1. AT&C 设置 DCD 功能模式 ..................................................................................................... 32 上海移远通信技术股份有限公司 3 / 216 M56 AT 命令手册 3.2. AT&D 设置 DTR 功能模式...................................................................................................... 32 3.3. AT+ICF 设置 TE-TA 帧格式.................................................................................................... 33 3.4. AT+IFC 设置 TE-TA 流控 ....................................................................................................... 34 3.5. AT+IPR 设置 TE-TA 波特率 ................................................................................................... 35 3.5.1. 自适应波特率 ............................................................................................................... 37 3.5.1.1. 自适应波特率操作要求................................................................................................. 37 3.5.1.2. 自适应波特率和 MUX................................................................................................... 37 3.5.1.3. 自适应波特率和 Windows 调制解调器 ...................................................................... 37 3.6. AT+QEAUART 设置多串口功能 ........................................................................................... 38 3.7. AT+QSEDCB 设置多串口的参数.......................................................................................... 39 4 状态控制命令 .................................................................................................................................... 41 4.1. AT+CEER 上报移动设备错误................................................................................................. 41 4.2. AT+CPAS 模块活动状态 ........................................................................................................ 42 4.3. AT+QINDRI 开启关闭 RI 引脚提示......................................................................................... 43 4.4. AT+QMOSTAT 开启或关闭去电呼叫状态报告........................................................................ 44 4.5. AT+QIURC 初始化完成提示上报 ........................................................................................... 45 4.6. AT+QEXTUNSOL 开启关闭专有 URC 上报 ........................................................................... 46 4.7. AT+QINISTAT 初始化状态查询 .............................................................................................. 47 4.8. AT+QNSTATUS 查询 GSM 网络状态..................................................................................... 48 4.9. AT+QNITZ 同步网络时间 ....................................................................................................... 48 4.10. AT+QLTS 获取最近一次的网络同步时间................................................................................ 49 4.11. AT+CTZU 网络时间同步以及更新 RTC 时间.......................................................................... 50 4.12. AT+CTZR 网络时间同步上报 ................................................................................................. 51 4.13. AT+QSIMDET 开启或关闭(U)SIM 卡检测功能 ....................................................................... 52 4.14. AT+QSIMSTAT (U)SIM 卡插拔状态报告 .............................................................................. 53 4.15. AT+QCGTIND 语音/数据呼叫结束提示 .................................................................................. 55 5 (U)SIM 卡相关命令 ............................................................................................................................ 57 5.1. AT+CIMI 请求国际移动台设备标识（IMSI 号） ..................................................................... 57 5.2. AT+CLCK 设备锁定 ............................................................................................................... 58 5.3. AT+CPIN 输入 PIN................................................................................................................. 60 5.4. AT+CPWD 设备锁定 .............................................................................................................. 61 5.5. AT+CRSM (U)SIM 卡接入限制............................................................................................. 63 5.6. AT+CSIM 通用(U)SIM 操作.................................................................................................... 64 5.7. AT+QCSPWD 更改 PS 超级密码 ........................................................................................... 65 5.8. AT+CCID 显示 CCID.............................................................................................................. 65 5.9. AT+QCCID 显示 CCID........................................................................................................... 66 5.10. AT+QGID 获取(U)SIM 卡 GID................................................................................................ 67 5.11. AT+QSIMVOL 固定(U)SIM 卡工作电压.................................................................................. 67 5.12. AT+QSPN 读取(U)SIM 卡服务运营商名称 ............................................................................. 68 5.13. AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数......................................................................... 69 6 网络服务命令 .................................................................................................................................... 70 6.1. AT+COPS 选择营运商 ........................................................................................................... 70 6.2. AT+CREG 网络注册信息 ........................................................................................................ 72 上海移远通信技术股份有限公司 4 / 216 M56 AT 命令手册 6.3. AT+CSQ 信号质量 ................................................................................................................. 73 6.4. AT+CPOL 优选运营商列表..................................................................................................... 74 6.5. AT+COPN 查询运营商列表 .................................................................................................... 75 6.6. AT+QBAND 查询运营商列表 ................................................................................................. 76 6.7. AT+QENG 开启或关闭工程模式 ............................................................................................ 77 6.8. AT+QSCANF GSM 频率功率扫描 ........................................................................................ 80 6.9. AT+QLOCKF 锁 GSM 频率.................................................................................................... 81 7 呼叫控制命令 .................................................................................................................................... 83 7.1. ATA 呼叫应答 ......................................................................................................................... 83 7.2. ATD 移动台呼叫某一号码 ...................................................................................................... 84 7.3. ATH 挂机控制 ........................................................................................................................ 85 7.4. +++ 数据模式切换至命令模式 ................................................................................................ 86 7.5. ATO 命令模式切换至数据模式 ............................................................................................... 87 7.6. ATP 选择脉冲拨号 ................................................................................................................. 88 7.7. ATS0 自动应答前振铃次数..................................................................................................... 88 7.8. ATS6 盲拨号前暂停控制 ........................................................................................................ 89 7.9. ATS7 等待呼叫建立完成时间 ................................................................................................. 90 7.10. ATS8 暂停拨号时间 ............................................................................................................... 90 7.11. ATS10 挂机延时..................................................................................................................... 91 7.12. ATT 音频拨号 ......................................................................................................................... 92 7.13. AT+CSTA 选择地址类型......................................................................................................... 92 7.14. AT+CLCC 查询当前呼叫 ........................................................................................................ 93 7.15. AT+CR 业务上报控制............................................................................................................. 94 7.16. AT+CRC 蜂窝结果码.............................................................................................................. 96 7.17. AT+CSNS 单一编码方案........................................................................................................ 97 7.18. AT+QSFR 配置语音编码模式................................................................................................. 98 7.19. AT+QSPCH 语音信道类型上报 .............................................................................................. 99 7.20. AT+QDISH ATH 使能控制 .................................................................................................. 100 8 GPRS 相关命令............................................................................................................................... 101 8.1. AT+CGATT GPRS 附着和分离........................................................................................... 101 8.2. AT+CGDCONT 定义 PDP 上下文 ........................................................................................ 102 8.3. AT+CGQREQ 请求的服务质量 ............................................................................................ 103 8.4. AT+CGQMIN 可接受的最小服务质量................................................................................... 104 8.5. AT+CGACT PDP 上下文激活和去激活 ................................................................................. 105 8.6. AT+CGDATA 进入数据模式.................................................................................................. 107 8.7. AT+CGPADDR 显示 PDP 地址 ............................................................................................ 107 8.8. AT+CGCLASS GPRS 移动台类别 ..................................................................................... 108 8.9. AT+CGEREP 非请求 GPRS 事件上报控制 .......................................................................... 109 8.10. AT+CGREG GPRS 网络注册状态.......................................................................................110 8.11. AT+QGPCLASS 配置 GPRS 多时隙级别..............................................................................112 9 TCP/IP 相关命令 ............................................................................................................................. 113 9.1. AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 ..................................................................113 9.2. AT+QISEND 发送 TCP 或 UDP 数据 ....................................................................................114 上海移远通信技术股份有限公司 5 / 216 M56 AT 命令手册 9.3. AT+QICLOSE 关闭 TCP 或 UDP 连接 ..................................................................................115 9.4. AT+QIDEACT 关闭 GPRS/CSD PDP 场景 ...........................................................................117 9.5. AT+QILPORT 配置本地端口号..............................................................................................117 9.6. AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码...............................................118 9.7. AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） .................................................119 9.8. AT+QILOCIP 获取本地 IP 地址 ............................................................................................ 120 9.9. AT+QISTAT 查询当前连接状态 ............................................................................................ 120 9.10. AT+QISTATE 查询当前接入的连接状态 ............................................................................... 122 9.11. AT+QISSTAT 查询当前 Server 状态..................................................................................... 123 9.12. AT+QIDNSCFG 配置域名服务器 DNS................................................................................. 124 9.13. AT+QIDNSGIP 域名解析 ..................................................................................................... 125 9.14. AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 ............................................................... 126 9.15. AT+QIHEAD 配置接收数据时是否显示 IP 头 ....................................................................... 126 9.16. AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 ................................................................ 127 9.17. AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' ................................................ 128 9.18. AT+QISERVER 配置为服务器 ............................................................................................. 129 9.19. AT+QICSGP 设置 CSD 或 GPRS 连接模式 ......................................................................... 130 9.20. AT+QISRVC 选择当前可操作连接 ....................................................................................... 131 9.21. AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号 ................................. 132 9.22. AT+QISCON 保存 TCP/IP 应用场景配置 ............................................................................. 132 9.23. AT+QIMODE 配置 TCP/IP 应用模式 .................................................................................... 134 9.24. AT+QITCFG 配置透明传输模式 ........................................................................................... 135 9.25. AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议 ....................................................... 136 9.26. AT+QIMUX 控制是否启用多路连接...................................................................................... 137 9.27. AT+QISHOWLA 控制是否显示本地 IP 地址 ......................................................................... 137 9.28. AT+QIFGCNT 配置前置场景................................................................................................ 138 9.29. AT+QISACK 查询发送数据信息 ........................................................................................... 139 9.30. AT+QINDI 配置是否缓存接收到的数据 ................................................................................ 140 9.31. AT+QIRD 读取缓存的数据 ................................................................................................... 141 9.32. AT+QISDE 控制 AT+QISEND 是否允许数据回显 ................................................................ 142 9.33. AT+QPING PING 远程服务器 ............................................................................................ 143 9.34. AT+QNTP 通过网络时间服务器同步本地时间...................................................................... 144 9.35. AT+QIKALIVE 设置 TCP/IP 心跳包参数............................................................................... 145 10 补充业务命令 .................................................................................................................................. 147 10.1. AT+CCFC 设置呼叫转移 ...................................................................................................... 147 10.2. AT+CCUG 封闭用户组......................................................................................................... 149 10.3. AT+CCWA 呼叫等待 ............................................................................................................ 150 10.4. AT+CHLD 呼叫保持和多方通话 ........................................................................................... 151 10.5. AT+CLIP 来电号码显示设置................................................................................................. 153 10.6. AT+QCLIP 配置来电是否显示主叫号码名称 ........................................................................ 154 10.7. AT+CLIR 主叫识别限制........................................................................................................ 156 10.8. AT+COLP 显示被叫识别 ...................................................................................................... 157 10.9. AT+QCOLP 配置去电是否显示主叫号码名称语法................................................................ 158 10.10. AT+CUSD 非结构化附加业务 .............................................................................................. 159 上海移远通信技术股份有限公司 6 / 216 M56 AT 命令手册 10.11. AT+CSSN 附加业务通知...................................................................................................... 161 11 音频控制命令 .................................................................................................................................. 163 11.1. ATL 设置监听扬声器音量 ..................................................................................................... 163 11.2. ATM 设置监听扬声器模式 .................................................................................................... 164 11.3. AT+CALM 来电警报模式...................................................................................................... 164 11.4. AT+CRSL 来电音量等级 ...................................................................................................... 165 11.5. AT+CLVL 扬声器音量等级.................................................................................................... 166 11.6. AT+CMUT 上行静音控制 ..................................................................................................... 167 11.7. AT+QMIC 配置麦克风增益等级............................................................................................ 168 11.8. AT+QAUDCH 切换音频通道 ................................................................................................ 168 11.9. AT+QAUDLOOP 音频通道回环测试 .................................................................................... 169 11.10. AT+QLTONE 产生本地定制单音 .......................................................................................... 170 12 硬件相关命令 .................................................................................................................................. 171 12.1. AT+CCLK 实时时钟 ............................................................................................................. 171 12.2. AT+CBC 查询电池电量和充电状态 ...................................................................................... 172 12.3. AT+QADC 读取 ADC ......................................................................................................... 173 12.4. AT+QSCLK 慢时钟配置 ....................................................................................................... 173 12.5. AT+QLEDMODE 网络指示灯配置........................................................................................ 174 12.6. AT+QVBATT 配置电压阀值 ................................................................................................ 175 12.7. AT+QRIMODE 设置 RI 时长............................................................................................... 177 13 摄像机功能相关命令........................................................................................................................ 179 13.1. AT+QCAMOPEN 打开摄像功能 ........................................................................................... 179 13.2. AT+QCAMIDFY 开始/停止解码 ............................................................................................ 180 13.2.1. 解码结果的 URC ........................................................................................................ 180 13.3. AT+QCAMCLOSE 关闭摄像功能 ......................................................................................... 181 13.4. AT+QCAMSEL 清除已识别的摄像头类型信息 ..................................................................... 182 13.5. AT+QCAMAPPVER 读取解码库版本信息............................................................................ 182 13.6. AT+QUID 获取模块的芯片唯一识别码（ID 号） .................................................................. 183 14 其他命令.......................................................................................................................................... 185 14.1. A/ 重复上一条 AT 指令 ......................................................................................................... 185 14.2. ATE 命令回显模式 ............................................................................................................... 185 14.3. ATS3 配置命令行终止符 ...................................................................................................... 186 14.4. ATS4 设置响应格式字符 ...................................................................................................... 186 14.5. ATS5 配置命令行编辑字符................................................................................................... 187 15 附录 ................................................................................................................................................. 188 15.1. 参考文档 ............................................................................................................................... 188 15.2. 术语缩写 ............................................................................................................................... 188 15.3. AT&F 影响到的 AT 命令及参数 ............................................................................................. 190 15.4. AT&W 影响到 AT 命令参数列表 ............................................................................................ 191 15.5. ATZ 影响到的 AT 命令参数列表 ............................................................................................ 193 15.6. AT&V 显示当前配置信息....................................................................................................... 195 15.7. AT&V 内容格式对照表 .......................................................................................................... 196 上海移远通信技术股份有限公司 7 / 216 M56 AT 命令手册 15.8. URCs 说明列表..................................................................................................................... 197 15.9. +CME ERROR 错误报告列表 ............................................................................................... 199 15.10. 错误扩展列表 ........................................................................................................................ 202 15.10.1. Location ID 扩展错误报告列表 ................................................................................... 202 15.10.2. 协议栈层（PS）错误列表 .......................................................................................... 203 15.10.3. MM 层内部错误列表................................................................................................... 215 15.10.4. PPP/IP 栈错误列表 .................................................................................................... 216 上海移远通信技术股份有限公司 8 / 216 M56 AT 命令手册 表格索引 表 1：参考文档 ................................................................................................................................................ 188 表 2：术语缩写 ................................................................................................................................................ 188 表 3：AT&F 影响到的 AT 命令及参数 .............................................................................................................. 190 表 4：AT&W 影响到的 AT 命令参数列表 ......................................................................................................... 191 表 5：ATZ 影响到的 AT 命令参数列表 ............................................................................................................. 193 表 6：AT&V 显示当前配置信息........................................................................................................................ 195 表 7：ATV 内容格式对照表.............................................................................................................................. 196 表 8：URCS 说明列表 ..................................................................................................................................... 197 表 9：+CME ERROR 错误代码列表................................................................................................................ 199 表 10：LOCATION ID 扩展错误报告列表 ........................................................................................................ 202 表 11：协议栈层（PS）错误列表 .................................................................................................................... 203 表 12：MM 层内部错误列表 ............................................................................................................................ 215 表 13：PPP/IP 栈错误列表 .............................................................................................................................. 216 上海移远通信技术股份有限公司 9 / 216 M56 AT 命令手册 1 引言 1.1. 本章概要 该文档主要描述 M56 模块软件 AT 指令集及参数详解。 1.2. AT 命令术语缩写和惯例 文档内提及的 GSM 模块包括移动设备 ME（Mobile Equipment）、移动台 MS（Mobile Station）、终端 适配器 TA（Terminal Adapter）、数据通信设备 DCE（Data Communication Equipment）和传真 FAX（包 括传真 Modem 和传真板）。 通过串口发送 AT 命令，即可使用 GSM 模块。串行线终端的应用设备包括终端设备 TE（Terminal Equipment）、数据终端设备 DTE（Data Terminal Equipment）或其他应用设备。这些终端或应用设备可能 运行在嵌入式系统内。 文档内涉及的相关名词术语缩写均基于 GSM 规范书写。 1.3. AT 命令语法 文档内所有 AT 命令行必须以'AT'或'at'作为开头，以回车（）作为结尾。 返回响应通常紧随命令之后，其样式为''（）。AT 命令介绍过程中，只详细介绍，均被有意省略。 1.3.1. AT 命令类型 文档内 AT 命令类型包含如下三种： 基础类命令：此类 AT 命令格式有'AT'或者'AT&'，其中''是命令自带，''是指 该命令支持一个或多个参数。例如：'ATE'，该命令用于关闭或使能回显功能，即 DCE 会依据''值 决定是否把接收的字符回显给 DTE。''是可选配参数，若没有被赋值，将使用默认值。 上海移远通信技术股份有限公司 10 / 216 M56 AT 命令手册 参数类命令：此类 AT 命令格式有'ATS=[]'，其中''是 S 寄存器的索引，''是赋予的参 数值。在该 AT 命令中，''是可选配参数，若没有被赋值，将使用默认值。 扩展类命令：通常来讲，扩展类命令根据操作格式及应用功能可分为几种类型，详见 2.1 章节。 AT 命令语法说明：  方括号（[ ]）中的值为可缺省值；  选配参数和必配参数必须在操作的参数范围内进行设置并按规定的顺序排列，各参数间必须使用 逗号隔开。举例：AT+CPWD=,,，该命令用于为 AT+CLCK 命令锁定 义的设备锁定功能设置新的密码；  如果参数是字符串（例如：），则该字符串必须放在双引号中。举例：'12345'，'CMNET' 等，双引号中的各项符号可看作是字符串；  命令的可选子参数或 TA 返回结果的可选部分位于方括号中；  不使用双引号时，字符串中各字符间的空格可忽略不计；  实际操作中，和[ ]不必输入；  所有 AT 命令本身不区分大小写，但其参数对大小写敏感。 1.3.2. AT 命令连写 在需要连续执行多个 AT 命令时，必须等到上一条 AT 命令作了最终响应（例如：返回 OK、ERROR、 +CME ERROR: 等），才能继续操作下一条 AT 命令。该动作强烈建议执行。 1.4. 支持的字符集 GSM 模块 AT 命令接口默认使用 GSM 字符集，字符集可以通过 AT+CSCS 命令（GSM 07.07）进行 查询和配置。其支持的字符集如下：  GSM  UCS2  HEX  IRA  PCCP437  8859-1 字符集会影响短消息和广播消息的读取、编辑、发送和接收，电话簿、(U)SIM 卡工具箱等字符串的输 入和显示。 上海移远通信技术股份有限公司 11 / 216 M56 AT 命令手册 1.5. 流控简介 流控对于保障 GSM 模块与 DTE 之间可靠通信尤其重要。若一次数据或传真呼叫过程中，发送端的数 据发送速度大于接收端的数据接收速度，当接收缓存接近满时，接收端应该有方法将发送端暂停发送，直 到它的数据传输速度重新赶上发送端数据发送速度或有缓存可使用，这就是流控。 通常来讲，有软件流控和硬件流控两种方法来实现流控。M56 模块支持此两种流控功能。在客户实际 应用中，建议选择硬件流控。 M56 默认流控功能关闭。 1.5.1. 软件流控 软件流控发送不同的字符去暂停（XOFF，十进制 19）和恢复（XON，十进制 17）数据流。它适用于 仅仅有三根线的串口通信。 M56 默认流控功能关闭。软件流控需要通过 AT+IFC=1,1 命令进行配置。 由于该配置不自动保存，若希望重启后仍保持有效，需通过 AT&W 保存到用户配置表中。同时，确保 所使用的串口通讯工具（例如：超级终端）是否支持软件流控。 备注 当有二进制数据发送或接收时，软件流控不应该被采用。因为 DTE 可能把二进制数据当做软件流控字符。 1.5.2. 硬件流控 M56 默认流控功能关闭，若要使用硬件（RTS/CTS）流控，需要通过 AT+IFC=2,2 命令进行配置。 该配置不支持自动保存，若希望重启后有效，则需要设置 AT+IFC=2,2 后执行 AT&W 进行保存。 硬件流控通过 RTS/CTS 信号来实现。当接收缓存快满的时候，模块把 CTS 信号设置为无效，数据传 输被暂停。当模块的接收缓存可以接收更多数据时，CTS 信号被重新设置为有效。 上海移远通信技术股份有限公司 12 / 216 M56 AT 命令手册 2 AT 命令详解 2.1. AT 命令格式 测试命令 查询命令 设置命令 执行命令 AT+=? 该命令用于查询设置命令或内部程序设置的参数及其参数值范围 AT+? 该命令用于查询参数的当前值 AT+= 该命令用于设置用户自定义的参数值 AT+ 该命令用于读出 GSM 模块内部程序所控制的不可变参数 2.2. ATI 显示产品 ID 信息 该命令用于显示产品 ID 信息，TA 上报一行或多行制造商信息及软件版本信息。 语法 ATI 显示产品 ID 信息 执行命令 ATI 响应 Quectel_Ltd Quectel_M56 Revision: M56FAR01A01 最大响应时间 参考 V.25ter OK 300ms 上海移远通信技术股份有限公司 13 / 216 M56 AT 命令手册 2.3. AT+GMI 请求制造商 ID 信息 该命令用于请求制造商 ID 信息，TA 上报一行或多行让用户识别 TA 制造商的文本信息。 语法 AT+GMI 请求制造商 ID 信息 测试命令 AT+GMI=? 执行命令 AT+GMI 响应 OK 响应 Quectel_Ltd Quectel_M56 Revision: MTK 0828 最大响应时间 参考 V.25ter OK 300ms 2.4. AT+GMM 请求 TA 制造商和型号信息 该命令用于请求 TA 制造商和型号信息，TA 上报一行或多行设备制造商和型号的信息。 语法 AT+GMM 请求 TA 制造商和型号信息 测试命令 响应 AT+GMM=? OK 执行命令 响应 AT+GMM Quectel_M56 最大响应时间 参考 V.25ter OK 300ms 上海移远通信技术股份有限公司 14 / 216 2.5. AT+GMR 请求 TA 软件版本信息 该命令用于请求 TA 软件版本信息，TA 上报一行或多行软件版本信息。 语法 AT+GMR 请求 TA 软件版本信息 测试命令 AT+GMR=? 执行命令 AT+GMR 响应 OK 响应 Revision: M56FAR01A01 最大响应时间 参考 V.25ter OK 300ms M56 AT 命令手册 2.6. AT+GOI 请求全球目标识别 ID 该命令用于请求全球目标识别 ID，TA 上报一行或多行设备标识信息（该设备基于 ISO 系统注册的唯 一设备标识）。 语法 AT+GOI 请求全球目标识别 ID 测试命令 响应 AT+GOI=? OK 执行命令 响应 AT+GOI M56 最大响应时间 参考 V.25ter OK 300ms 上海移远通信技术股份有限公司 15 / 216 M56 AT 命令手册 2.7. AT+CGMI 请求制造商 ID 信息 该命令用于请求制造商 ID 信息，TA 上报一行或多行让用户识别 TA 制造商的文本信息。 语法 AT+CGMI 请求制造商 ID 信息 测试命令 AT+CGMI=? 执行命令 AT+CGMI 响应 OK 响应 Quectel_Ltd Quectel_M56 Revision: MTK 0828 最大响应时间 参考 GSM07.07 OK 300ms 备注 功能同 AT+GMI。 2.8. AT+CGMM 请求 TA 制造商和型号信息 该命令用于请求 TA 制造商和型号信息，TA 上报一行或多行设备制造商和型号的信息。 语法 AT+CGMM 请求 TA 制造商和型号信息 测试命令 响应 AT+CGMM=? OK 执行命令 响应 AT+CGMM Quectel_M56 最大响应时间 OK 300ms 上海移远通信技术股份有限公司 16 / 216 参考 GSM07.07 备注 功能同 AT+GMM。 M56 AT 命令手册 2.9. AT+CGMR 请求 TA 软件版本信息 该命令用于请求 TA 软件版本信息，TA 上报一行或多行软件版本信息。 语法 AT+CGMR 请求 TA 软件版本信息 测试命令 AT+CGMR=? 执行命令 AT+CGMR 响应 OK 响应 Revision: M56FAR01A01 最大响应时间 参考 GSM07.07 OK 300ms 备注 功能同 AT+GMR。 上海移远通信技术股份有限公司 17 / 216 M56 AT 命令手册 2.10. AT+GSN 请求 TA 序列号（IMEI 号） 该命令用于请求 TA 序列号，TA 上报 ME 设备的国际移动台设备识别（IMEI 号码）。 语法 AT+GSN 请求 TA 序列号（IMEI 号） 测试命令 响应 AT+GSN=? OK 执行命令 响应 AT+GSN 最大响应时间 参考 GSM07.07 OK 300ms 参数 IMEI 号 备注 每台 ME 设备的序列号（IMEI 号）不同。 2.11. AT+CGSN 请求 TA 序列号（IMEI 号） 该命令用于请求 TA 序列号，TA 上报 ME 设备的国际移动台设备识别码（IMEI 号）。 语法 AT+CGSN 请求 TA 序列号（IMEI 号） 测试命令 响应 AT+CGSN=? OK 执行命令 响应 AT+CGSN 上海移远通信技术股份有限公司 18 / 216 最大响应时间 参考 GSM07.07 参数 IMEI 号 OK 300ms 备注 1. 每台 ME 设备的序列号（IMEI 号）不同。 2. 功能同 AT+GSN。 M56 AT 命令手册 2.12. AT+QGSN 请求 TA 序列号（IMEI 号） 该命令用于请求 TA 序列号，TA 上报 ME 设备的国际移动台设备识别码（IMEI 号）。 语法 AT+QGSN 请求 TA 序列号（IMEI 号） 测试命令 响应 AT+QGSN=? OK 执行命令 响应 AT+QGSN +QGSN: 最大响应时间 参考 Quectel OK 300ms 参数 IMEI 号 上海移远通信技术股份有限公司 19 / 216 备注 1. 每台 ME 设备的序列号（IMEI 号）不同。 2. 功能同 AT+GSN 和 AT+CGSN。 M56 AT 命令手册 2.13. AT&F 设置所有 TA 参数为出厂配置 该命令可把 TA 部分配置当前参数设置为制造商的默认配置。所有 GPRS 相关应用参数配置不被 AT&F 影响。 语法 AT&F 设置所有 TA 参数为出厂配置 执行命令 响应 AT&F[] OK 最大响应时间 参考 V.25ter 300ms 参数 数字参数 0 返回当前配置参数及参数值 备注 1. 所有相关参数恢复制造商默认配置，详见表 3。 2. AT&F 操作影响的部分参数可以通过 AT&W 进行保存，ATZ 恢复为缺省配置。 3. 可通过 AT&W 保存 AT&F 恢复出厂默认配置，详见表 4。 4. 可通过 ATZ 恢复 AT&F 部分对应参数所保存的配置，详见表 5。 5. 必须在模块处于空闲状态方可进行 AT&F 操作。 上海移远通信技术股份有限公司 20 / 216 2.14. AT&V 显示当前配置 语法 AT&V 显示当前配置 执行命令 AT&V[] 最大响应时间 参考 V.25ter 响应 ACTIVE PROFILE … OK 300ms 参数 数字参数 0 返回当前配置参数及参数值 详情请见附录表 6。 2.15. AT&W 保存用户配置参数 该命令将用户设置的一些命令参数保存到非易失性存储器内。 语法 AT&W 保存用户配置参数 执行命令 AT&W[] 最大响应时间 参考 V.25ter 响应 OK 300ms M56 AT 命令手册 上海移远通信技术股份有限公司 21 / 216 参数 0 保存到用户当前配置表内 M56 AT 命令手册 备注 1. AT&W 将用户配置在重启 TA 之后保持有效。 2. 通过 AT&F 恢复 AT&W 部分对应参数的出厂默认配置。 3. 可通过 ATZ 恢复 AT&W 部分对应参数所保存的配置。 4. 必须在模块处于空闲状态方可进行 AT&W 操作。 5. 对于 AT&W 章节列举的 AT 命令，若希望模块重启后其参数保持不变，都需要通过 AT&W 保存，而 V.25，07.05，07.07 和 GPRS 中其他大多数 AT 命令会自动保存参数，即配置后重启参数不变。 2.16. ATQ 设置结果码显示模式 该命令用于设置 TA 是否向 TE 发送结果码。 语法 ATQ 设置结果码显示模式 执行命令 ATQ[] 最大响应时间 参考 V.25ter 响应 当=0，返回： OK 当=1，返回： (none) 300ms 参数 数字参数 0 向 TE 发送结果码 1 结果码被抑制，不发送结果码至 TE 备注 1. 该设置不会影响响应内的内容。 2. ATQ 不带参数设置时参数默认值为 0。 上海移远通信技术股份有限公司 22 / 216 M56 AT 命令手册 2.17. ATV 设置 TA 响应返回内容格式 该命令用于设置结果码和返回结果的传送格式（数字格式或字符格式），并设置头部和尾部的内容，这 些内容是与结果码和返回结果信息一起发送。 语法 ATV 设置 TA 响应返回内容格式 执行命令 ATV[] 最大响应时间 参考 V.25ter 响应 当=0，返回： 0 当=1，返回： OK 300ms 参数 0 1 信息返回结果： 短字符型结果码： 信息返回结果： 短字符型结果码： 备注 设置 ATV0 后，返回信息（如下列举例中的+CSQ: 30,0）前没有回车换行，返回的结果码 OK 变成了数 字 0。 举例 ATV1 OK AT+CSQ +CSQ: 30, 0 OK ATV0 0 AT+CSQ +CSQ: 30, 0 上海移远通信技术股份有限公司 23 / 216 0 详情请见附录表 7。 M56 AT 命令手册 2.18. ATX 设置 CONNECT 结果码格式和检测呼叫进程 使用该命令，可设置 TA 是否向 TE 发送某一个特定的结果码。 语法 ATX 设置 CONNECT 结果码格式和检测呼叫进程 执行命令 响应 ATX[] OK 最大响应时间 参考 V.25ter 300ms 参数 0 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均禁用 1 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均禁用 2 进入在线数据状态时即给定连接结果码。遇忙检测禁用，可启用拨号音 3 进入在线数据状态时即给定连接结果码。拨号音检测禁用，但可启用遇忙检测 4 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均可启用（AT&F） 备注 1. ATX 不带参数设置时参数默认值为 0。 2. AT&F 恢复出厂设置参数值为 4。 上海移远通信技术股份有限公司 24 / 216 M56 AT 命令手册 2.19. ATZ 复位为缺省配置 语法 ATZ 复位为缺省配置 执行命令 ATZ[] 最大响应时间 参考 V.25ter 响应 OK 300ms 参数 0 返回当前配置参数及参数值 备注 1. 所有相关参数恢复制造商默认配置。 2. AT&F 操作影响的部分参数可以通过 AT&W 进行保存，ATZ 恢复为缺省配置。 3. 必须在模块处于空闲状态方可进行 ATZ 操作。 2.20. AT+CFUN 设置模块功能 该命令是用来切换模块各功能模式。可用来重启 ME 或将模块在全功能，最小功能，关闭射频电路的 接收和发送等模式切换。 语法 AT+CFUN 设置模块功能 测试命令 AT+CFUN=? 响应 +CFUN: (取值列表),(取值列表) 查询命令 AT+CFUN? OK 响应 +CFUN: OK 上海移远通信技术股份有限公司 25 / 216 配置命令 AT+CFUN=[,] 最大响应时间 参考 GSM07.07 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 15s，受网络状态影响. M56 AT 命令手册 参数 0 最小功能模式 1 全功能模式（默认） 4 关闭射频电路的接收和发送功能模式 0 在设置功能等级后，不复位立即有效 1 在设置功能等级后，模块复位有效 备注 1. 为 1 是模块会进行复位动作，此时 GSM，GPRS 网络会注销启动后重新注册。 2. 该命令操作只能在模块处于空闲状态下操作，不然会导致其他功能操作异常。 举例 举例一：设置模块最小功能模式。该命令首先注销网络，之后取消激活(U)SIM 卡 AT+CFUN=0 +CPIN: NOT READY OK AT+COPS? +COPS: 0 //无网络 OK AT+CPIN? +CME ERROR: 13 //(U)SIM 卡读取失败 举例二：设置模块全功能模式。该命令首先激活(U)SIM 卡，之后注册网络 AT+CFUN=1 OK +CPIN: SIM PIN 上海移远通信技术股份有限公司 26 / 216 AT+CPIN=1234 +CPIN: READY OK AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE' OK //注册上网络 M56 AT 命令手册 2.21. AT+QPOWD 关机 语法 AT+QPOWD 关机 配置命令 AT+QPOWD= 最大响应时间 参考 Quectel 当=1 时，返回： NORMAL POWER DOWN 当=0 时，返回： OK 300ms 参数 0 立即关机 1 正常关机 备注 该命令操作只能在模块处于空闲状态下操作，不然会导致其他功能操作异常。 上海移远通信技术股份有限公司 27 / 216 举例 AT+QPOWD=1 NORMAL POWER DOWN AT+QPOWD=0 OK M56 AT 命令手册 //模块正常关机提示 NORMAL POWER DOWN //模块立即关机 2.22. AT+CMEE 上报移动设备错误 该命令用于启用或禁用+CME ERROR: 结果码。用于指示与 ME 功能相关的错误。 语法 AT+CMEE 上报移动设备错误 测试命令 AT+CMEE=? 响应 +CMEE: (取值列表) 查询命令 AT+CMEE? OK 响应 +CMEE: 配置命令 AT+CMEE= 最大响应时间 参考 GSM07.07 OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 禁用结果码+CME ERROR: ，使能 ERROR 1 启用结果码+CME ERROR: ，使用数值型的取值（AT&F） 2 启用结果码+CME ERROR: ，使用详细描述的取值 上海移远通信技术股份有限公司 28 / 216 备注 详细结果码对照请参照表 9。 M56 AT 命令手册 举例 AT+CMEE=0 //禁用结果码+CME ERROR: ，使能 ERROR OK AT+CPIN=1234 ERROR AT+CMEE=1 //启用结果码+CME ERROR: ，使用数值型的取值 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 //启用结果码+CME ERROR: ，使用详细描述的取值 OK AT+CPIN? +CME ERROR: SIM not inserted 2.23. AT+CSCS 选择 TE 字符集 该命令设置模块使用的字符集，以使用户终端能够在 TE 和 ME 的字符集之间正确转换字符串。 语法 AT+CSCS 选择 TE 字符集 测试命令 AT+CSCS=? 响应 +CSCS: (取值列表) 查询命令 AT+CSCS? OK 响应 +CSCS: 配置命令 AT+CSCS= OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 上海移远通信技术股份有限公司 29 / 216 最大响应时间 参考 GSM07.07 300ms 参数 'GSM' GSM 默认字符集 'HEX' 十六进制，取值范围：00~FF 'IRA' 国际参考字符集 'PCCP437' PC 字符集编码 'UCS2' 16 位通用多字节编码字符集，字符串从 0000~FFFF '8859-1' ISO8859 拉丁 1 字符集 备注 该命令操作只能在模块处于空闲状态下操作，否则会导致其他功能操作异常。 M56 AT 命令手册 举例 AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //查询当前字符集 //设置字符集为'UCS2'编码 2.24. AT+GCAP 请求 TA 功能列表 语法 AT+GCAP 请求 TA 功能列表 测试命令 响应 AT+GCAP=? OK 上海移远通信技术股份有限公司 30 / 216 执行命令 AT+GCAP 最大响应时间 参考 V.25TER 响应 +GCAP: OK 300ms 参数 +CGSM 支持 GSM 功能 +FCLASS 支持 FAX 功能 M56 AT 命令手册 上海移远通信技术股份有限公司 31 / 216 M56 AT 命令手册 3 串行接口控制命令 3.1. AT&C 设置 DCD 功能模式 该命令可设置 109（DCD）电路状态与远端接收线上信号检测之间的联系。 语法 AT&C 设置 DCD 功能模式 执行命令 AT&C[] 最大响应时间 参考 V.25ter 响应 OK 300ms 参数 0 1 DCD 线路打开 DCD 线路只在数据载波存在时打开 3.2. AT&D 设置 DTR 功能模式 该命令用于数据模式下，当 circuit108/2 (DTR)从 ON 变为 OFF 状态时 TA 的响应状态。 语法 AT&D 设置 DTR 功能模式 执行命令 AT&D[] 最大响应时间 响应 OK 300ms 上海移远通信技术股份有限公司 32 / 216 参考 V.25ter 参数 0 1 2 M56 AT 命令手册 TA 忽略 DTR 状态 DTR 由 ON 至 OFF：TA 在保持当前数据通话的同时，切换至命令模式 DTR 由 ON 至 OFF：TA 释放数据通话，切换至命令模式。当 DTR=OFF 时，为自 动应答关闭状态 3.3. AT+ICF 设置 TE-TA 帧格式 语法 AT+ICF 设置 TE-TA 帧格式 测试命令 AT+ICF=? 查询命令 AT+ICF? 配置命令 AT+ICF=[,] 最大响应时间 参考 V.25ter 响应 +ICF: (取值列表),(取值列表) OK 响应 +ICF: , OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 1 2 3 8 数据位 0 奇偶校验位 2 停止位 8 数据位 1 奇偶校验位 1 停止位 8 数据位 0 奇偶校验位 1 停止位 上海移远通信技术股份有限公司 33 / 216 4 5 6 0 1 3 7 数据位 0 奇偶校验位 2 停止位 7 数据位 1 奇偶校验位 1 停止位 7 数据位 0 奇偶校验位 1 停止位 奇数位 偶数位 空格 备注 1. 该命令适用于命令模式。 2. 在参数中，'0 奇偶校验位' 表示无奇偶校验位。 3. 若设置为无奇偶校验位，则配置被忽略。 M56 AT 命令手册 3.4. AT+IFC 设置 TE-TA 流控 在使用 V.42 差错控制的情况下，AT+IFC 可控制 DTE 和 DCE 在数据状态下的本地流控操作。 语法 AT+IFC 设置 TE-TA 流控 测试命令 AT+IFC=? 响应 +IFC: (取值列表),(取值列表) 查询命令 AT+IFC? OK 响应 +IFC: , 配置命令 AT+IFC=, OK 响应 OK 若出错，返回： ERROR 最大响应时间 参考 V.25ter 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 34 / 216 参数 指定 TE 接收来自 TA 数据时采用的流控方法 0 无流控（默认） 1 软件流控，不向远程 DCE 传送 DC1/DC3 字符 2 硬件流控 指定 TA 接收来自 TE 数据时采用的流控方法 0 无流控（默认） 1 软件流控 2 硬件流控 备注 流量控制适用于数据模式。 举例 AT+IFC=2,2 OK AT+IFC? +IFC: 2,2 OK //设置硬件流控 M56 AT 命令手册 3.5. AT+IPR 设置 TE-TA 波特率 该命令用于设置 DTE-DCE 的波特率。在接收到其结果码后，该配置命令才生效。 语法 AT+IPR 设置 TE-TA 波特率 测试命令 AT+IPR=? 响应 +IPR: (自适应波特率下支持的速率取值列表),( 固定波特率下支持的速率取值列表) 查询命令 AT+IPR? OK 响应 +IPR: OK 上海移远通信技术股份有限公司 35 / 216 配置命令 AT+IPR= 最大响应时间 参考 V.25ter 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms M56 AT 命令手册 参数 0（自适应波特率） 300 600 1200 2400 4800 9600 14400 19200 28800 38400 57600 115200 备注 1. AT+IPR 默认配置为 0（自适应波特率）。 2. 若自适应波特率功能打开，TA 会自动同步上 TE 的波特率。 3. 若设置为固定波特率，需保证 TE 和 TA 所配置的波特率相同。 4. AT+IPR 的值不受 AT&F 和 ATZ 影响。但是可以通过 AT&W 保存当前配置，AT&V 显示当前 配置。 5. 在多路复用模式下，不可以通过 AT+IPR 配置当前串口通讯波特率，使用 AT&W 保存操作亦无效。 6. 可以通过输入'AT'字符串确认是否返回 OK 来判断配置的波特率是否有效。 举例 AT+IPR=115200 OK AT&W OK //设置固定波特率为 115200bps //保存配置的固定波特率，即此时模块重启后串口通讯速率为 115200bps 上海移远通信技术股份有限公司 36 / 216 M56 AT 命令手册 AT+IPR? +IPR: 115200 OK 3.5.1. 自适应波特率 DTE 与 DCE 之间的同步是为了确保 DTE 与 DCE 成功同步并使 DCE（=ME）检测到 DTE 使用的波 特率。当开启模块，串口波特率设置为自适应波特率，此时输入'用的波字符串是必要的，它允许 DCE 同 步上 DTE 波特率。在发送第一个 AT 字符前最好等待 2 至 3 秒，否则将可能返回一些不确定字符。 如果需要同时使用自适应波特率和自动应答功能，可以在激活自适应波特率时先进行 DTE-DCE 同步， 然后配置自动应答模式。 3.5.1.1. 自适应波特率操作要求  串行接口必须工作在 8 位数据位，无奇偶校验位和 1 位停止位的出厂默认设置。  不能使用命令'A/'。  在自适应波特率状态下，可以通过使用字符串'AT'或者'At'（而非'aT'或'at'）同步波特率。  若希望 AT+IPR=0 设置在模块重启后仍然有效，需通过 AT&W 保存波特率配置。  当自适应波特率启用时，在波特率被同步以前，所有上报的 URC，如 RDY 等都不会被输出。 3.5.1.2.自适应波特率和 MUX 如果自适应波特率被启用，不建议切换到 MUX 模式。 3.5.1.3.自适应波特率和 Windows 调制解调器 在建立 GPRS/CSD 拨号连接时，Windows 调制解调器使用的波特率会被侦测到。但是一些 Windows 调制解调器驱动程序在 GPRS 拨号结束后会将 TE 的波特率切换回默认值，这会导致 Windows 调制解调器 接收不到响应。为了避免这种情况发生，不建议在启用自适应波特率的情况下去建立 GPRS/CSD 拨号。 基于同样的原因，也不建议在启用自适应波特率的情况下使用 PC 端 FAX 应用程序去建立 FAX 连接， 如 WinFax。 上海移远通信技术股份有限公司 37 / 216 M56 AT 命令手册 备注 为了确保 DCE 和 DTE 之间通讯的可靠性和避免由于波特率不确定导致的问题，强烈建议在开机后配置 为固定波特率并将设置保存，如操作 AT+IPR=115200&W。 3.6. AT+QEAUART 设置多串口功能 语法 AT+QEAUART 设置多串口功能 测试命令 AT+QEAUART=? 响应 +QEAUART: (取值列表), 查询命令 AT+QEAUART? OK 响应 +QEAUART: , OK 配置命令 ERROR 响应 AT+QEAUART=, OK 最大响应时间 参考 GSM07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 禁用多串口功能 1 UART1 和 UART3 作为 AT 串口 2 UART1 和 UART2 作为 AT 串口 2 UART2 作为调试串口 99 不将串口作为调试串口 上海移远通信技术股份有限公司 38 / 216 M56 AT 命令手册 3.7. AT+QSEDCB 设置多串口的参数 语法 AT+QSEDCB 设置多串口的参数 测试命令 AT+QSEDCB=? 响应 +QSEDCB: ( 参 数 列 表 ),( 参 数 列 表 ), (参数列表),(参数列表) 查询命令 AT+QSEDCB? OK 响应 +QSEDCB: ,,, 配置命令 AT+QSEDCB=,, ,, 最大响应 参考 GSM07.07 OK ERROR 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 波特率 1200 2400 4800 9600 14400 19200 28800 38400 57600 115200 数据位 5 6 7 上海移远通信技术股份有限公司 39 / 216 M56 AT 命令手册 8 停止位 1 2 3 奇偶校验位 0 无 1 奇数 2 偶数 3 总为 1 选择要配置的 UART 口 2 UART2 3 UART3 备注 1. 这个命令可以通过 AT&W 来保存。 2. 如果 UART3 被配置为多串口，命令 AT+QSEDCB 将会执行成功，否则将返回失败。 上海移远通信技术股份有限公司 40 / 216 M56 AT 命令手册 4 状态控制命令 4.1. AT+CEER 上报移动设备错误 语法 AT+CEER 上报移动设备错误 测试命令 AT+CEER=? 查询命令 AT+CEER 最大响应时间 参考 GSM07.07 响应 OK 响应 +CEER: , OK 300ms 参数 错误类型 ID 号 最后一次呼叫连接释放原因 备注 及报告值参考表 10。表 10 提供了下列原因的扩展报告： 1) 最近一次呼叫建立失败（发起或应答）或呼叫内修改。 2) 最近一次呼叫释放。 举例 AT+CEER +CEER: 0,0 OK ATD10086; //正常状态下，查询错误报告，返回 0【No error (default)】 上海移远通信技术股份有限公司 41 / 216 M56 AT 命令手册 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK NO CARRIER AT+CEER +CEER: 1,16 //通话建立，对方挂断通话，查询报告错误号提示：1【Cause for protocol stack (PS) layer】，16 (Normal call clearing) OK 4.2. AT+CPAS 模块活动状态 语法 AT+CPAS 模块活动状态 测试命令 AT+CPAS=? 查询命令 AT+CPAS 最大响应时间 参考 GSM07.07 响应 +CPAS: (取值列表) OK 响应 +CPAS: OK 300ms 参数 0 2 3 4 准备（ME 允许来自 TA/TE 的命令） 未知（ME 未授权响应指令） 振铃（ME 准备好接收来自 TA/TE 的命令，但正在振铃） 呼叫进行中（ME 准备好来自 TA/TE 的命令，但当前有一个呼叫正在进行） 举例 AT+CPAS +CPAS: 0 上海移远通信技术股份有限公司 42 / 216 OK //模块处于空闲状态，=0 ATD10086; OK AT+CLCC +CLCC: 1,0,3,0,0,'10086',129,'' OK AT+CPAS +CPAS: 3 OK //模块处于呼叫振铃状态，=3 AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK AT+CPAS +CPAS: 4 OK //模块处于呼叫建立状态，=4 4.3. AT+QINDRI 开启关闭 RI 引脚提示 语法 AT+QINDRI 开启关闭 RI 引脚提示 查询命令 响应 AT+QINDRI? +QINDRI: 配置命令 AT+QINDRI= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms M56 AT 命令手册 上海移远通信技术股份有限公司 43 / 216 参数 0 关闭 1 开启 M56 AT 命令手册 4.4. AT+QMOSTAT 开启或关闭去电呼叫状态报告 语法 AT+QMOSTAT 开启或关闭去电呼叫状态报告 测试命令 响应 AT+QMOSTAT=? +QMOSTAT: (取值列表) 查询命令 AT+QMOSTAT? OK 响应 +QMOSTAT: 配置命令 AT+QMOSTAT= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 配置是否开启去电呼叫状态报告 0 关闭，不显示去电通话状态 1 开启，显示去电的通话状态。拨号后，呼叫响铃后显示'MO RING'，呼叫连接建立 成功后显示'MO CONNECTED' 举例 AT+QMOSTAT=1 OK 上海移远通信技术股份有限公司 44 / 216 ATD10086; OK MO RING MO CONNECTED //呼叫振铃，显示 MO RING //呼叫连接建立成功，显示 MO CONNECTED M56 AT 命令手册 4.5. AT+QIURC 初始化完成提示上报 语法 AT+QIURC 初始化完成提示上报 测试命令 AT+QIURC=? 响应 +QIURC: (取值列表) 查询命令 AT+QIURC? OK 响应 +QIURC: 配置命令 AT+QIURC= OK 响应 OK 若出错，返回： ERROR 最大响应时间 参考 Quectel 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 1 关闭显示 开启显示 备注 当=1 时，模块开机初始化完成后，终端会上报 'Call Ready' 提示。 上海移远通信技术股份有限公司 45 / 216 M56 AT 命令手册 4.6. AT+QEXTUNSOL 开启关闭专有 URC 上报 语法 AT+QEXTUNSOL 开启关闭专有 URC 上报 测试命令 响应 AT+QEXTUNSOL=? +QEXTUNSOL: (取值列表) 查询命令 AT+QEXTUNSOL=, OK 响应 OK 若出错，返回： ERROR 最大响应时间 参考 Quectel 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 字符串参数（字符串需要加双引号）。当前专有 URC 提示参数值 'SQ' 信号质量报告。显示信号强度和误码率（类似于 AT+CSQ），当信号值或误码率 值有变化时上报+CSQN: ,提示。 'FN' 可用网络被禁止时有效。当返回到非注册状态时，该提示表明所有可用的 PLMN 已被禁止。 'MW' SMS 等待指示。当接收到一条 SMS 时，该 SMS 会被解码并检查是否还有一条 或多条消息在等待的指示（例如，语音邮件，电子邮件，传真等）。如果有等待 指示，会上报+QMWT: ,,,,,提 示。其中表示消息存储器类型，表示消息存储的位置索引， ,,,表示相应类型的等待消息的数量（‘0’表示清除 指示，其他非‘0’值表示等待消息的数量，空白表示没有对应类型的等待消息）。 'UR' URC 码。根据通话状态的转换上报 URC 提示+QGURC: 。同一次状态 的转换可能上报多个 URC，其中表示当前通话状态。 : 0 当前通话被终止，至少还存在一个被保持的通话 1 开始主动拨打电话 2 主动拨打电话失败 3 主动拨打电话，对方正在振铃 4 通话被转入呼叫等待状态 上海移远通信技术股份有限公司 46 / 216 M56 AT 命令手册 'BC' 'BM' 'SM' 'CC' 0 1 2 5 主动拨打的电话被接通 6 通话被终止 7 通话被挂起 8 在紧急拨号模式下拨打非紧急号码 9 主动拨打的电话没有应答 10 主动拨打电话，对方忙 电池充电报告。显示电池连接状态和充电进度（类似于 AT+CBC）报告。 显示格式为+CBCN: , 显示频段。按+QBAND: 格式报告频段变化情况（与 AT+QBAND 类似） 额外的 SMS 信息提示。以+TSMSINFO: 格式的 URC 显示额 外的 SMS 事件。其中是标准的 CMS 错误提示（与 AT+CMEE 命令显示的一样）。 通话信息。当有通话断开时，以+CCINFO: ,格式上报断开的通话 ID 和仍然进行的通话 ID 关闭 开启 查询 4.7. AT+QINISTAT 初始化状态查询 语法 AT+QINISTAT 初始化状态查询 测试命令 AT+QINISTAT=? 执行命令 AT+QINISTAT 最大响应时间 参考 Quectel 响应 OK 响应 +QINISTAT: OK 300ms 参数 0 ME 初始化操作开始 1 ME 可接收执行 AT 命令 2 电话本初始化完成 3 短消息初始化完成 上海移远通信技术股份有限公司 47 / 216 备注 当=3 时，表示(U)SIM 卡相关可操作功能初始化完成。 4.8. AT+QNSTATUS 查询 GSM 网络状态 语法 AT+QNSTATUS 查询 GSM 网络状态 测试命令 响应 AT+QNSTATUS=? OK 执行命令 响应 AT+QNSTATUS +QNSTATUS: 最大响应时间 参考 Quectel OK 300ms 参数 255 未准备好检测网络状态 0 网络状态正常 1 无可用小区 2 限制服务状态（可拨打紧急电话） 4.9. AT+QNITZ 同步网络时间 语法 AT+QNITZ 同步网络时间 测试命令 AT+QNITZ=? 响应 +QNITZ: (取值列表) OK 上海移远通信技术股份有限公司 M56 AT 命令手册 48 / 216 查询命令 AT+QNITZ? 配置命令 AT+QNITZ= 最大响应时间 参考 Quectel 响应 +QNITZ: OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms M56 AT 命令手册 参数 0 禁用同步网络时间 1 启用同步网络时间, 开启同步网络时间功能，会直接上报'+QNITZ: ,' 备注 该功能应用需要当地的 GSM 网络支持网络时间同步。 4.10. AT+QLTS 获取最近一次的网络同步时间 语法 AT+QLTS 获取最次一次的网络同步时间 测试命令 响应 AT+QLTS=? OK 执行命令 响应 AT+QLTS +QLTS: , OK 若错误与 ME 功能相关，则返回： +CME ERROR: 上海移远通信技术股份有限公司 49 / 216 M56 AT 命令手册 最大响应时间 参考 Quectel 300ms 参数 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年，月，日，小时，分钟，秒和时区（用 当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围-48~+48） Daylight Savinng Time，零时区时，格式为'04/05/06,22:10:00+08,0' 备注 1. 该功能应用需要当地的 GSM 网络支持网络时间同步. 2. 该功能必须要设置 AT+QNITZ=1 时有效。 4.11. AT+CTZU 网络时间同步以及更新 RTC 时间 语法 AT+CTZR 网络时间同步以及更新 RTC 时间 测试命令 响应 AT+CTZU=? +CTZU: (取值列表) 查询命令 AT+CTZU? OK 响应 +CTZU: 配置命令 AT+CTZU= 最大响应时间 参考 Quectel OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 50 / 216 参数 0 1 2 3 4 M56 AT 命令手册 NITZ 时不自动更新 RTC 时间 NITZ 时自动更新 RTC 时间 NITZ 时自动更新 GMT 时间至 RTC，时区保存在 NVROM，DST 无效 NITZ 时自动更新本地时间至 RTC，时区保存在 NVROM 同=2 模式 备注 1. 该功能应用需要当地的 GSM 网络支持网络时间同步。 2. AT+CTZU 的参数无需保存，可以自动写入 Flash。 4.12. AT+CTZR 网络时间同步上报 语法 AT+CTZR 网络时间同步上报 测试命令 AT+CTZR=? 查询命令 AT+CTZR? 配置命令 AT+CTZR= 最大响应时间 参考 Quectel 响应 +CTZR: (取值列表) OK 响应 +CTZR: OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 1 网络时间同步时不上报时区信息的改变 网络时间同步时上报时区信息的改变，以+CTZV: 格式上报 上海移远通信技术股份有限公司 51 / 216 M56 AT 命令手册 2 网络时间同步时上报时区信息的改变，以+CTZE: ,,[]格式上报 4.13. AT+QSIMDET 开启或关闭(U)SIM 卡检测功能 语法 AT+QSIMDET 开启或关闭(U)SIM 卡检测功能 测试命令 响应 AT+QSIMDET=? +QSIMDET: ( 取 值 列 表 ),( 取 值 列 表),(取值列表) 查询命令 AT+QSIMDET? OK 响应 +QSIMDET: ,, 配置命令 AT+QSIMDET=[,[,]] 最大响应时间 参考 Quectel OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 配置是否开启(U)SIM 卡检测功能 0 关闭 1 开启 配置(U)SIM 卡插入时的检测引脚电平 0 低电平 1 高电平 配置(U)SIM 卡检测引脚 0 配置 SIM_PRESENCE 引脚作为(U)SIM 卡的检测引脚 1 配置 DTR 引脚作为(U)SIM 卡的检测引脚 上海移远通信技术股份有限公司 52 / 216 M56 AT 命令手册 备注 1. 此命令可使用 AT&W 保存。 2. M56 中 SIM_PRESENCE 和 DTR 引脚是复用的，所以 M56 只支持 DTR 引脚作为(U)SIM 卡的检测 引脚，所以开启(U)SIM 卡检测功能应设置为 1。 举例 AT+QSIMDET=1,0,1 OK //配置 DTR 引脚作为(U)SIM 卡的检测引脚，(U)SIM 卡插入时为 DTR 低电平 +CPIN: NOT READY //(U)SIM 卡已掉卡 +CPIN: READY //(U)SIM 卡已插入 4.14. AT+QSIMSTAT (U)SIM 卡插拔状态报告 语法 AT+QSIMSTAT (U)SIM 卡插拔状态报告 测试命令 响应 AT+QSIMSTAT=? +QSIMSTAT: (取值列表) 查询命令 AT+QSIMSTAT? OK 响应 +QSIMSTAT: , 配置命令 AT+QSIMSTAT= 最大响应时间 参考 Quectel OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 53 / 216 参数 配置是否开启(U)SIM 卡插拔状态上报 0 关闭 1 开启 (U)SIM 卡插入状态，此参数不允许设置 0 拔出 1 插入 M56 AT 命令手册 备注 1. 当(U)SIM 卡插入或拔出，URC 提示：+QSIMSTAT: ,。 2. 此命令可用 AT&W 保存。 举例 AT+QSIMSTAT? +QSIMSTAT: 0,1 OK AT+QSIMDET=1,0,1 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 //查询(U)SIM 卡插入状态 //开启(U)SIM 卡插拔状态上报 OK +CPIN: NOT READY +QSIMSTAT: 1,0 AT+QSIMSTAT? +QSIMSTAT: 1,0 //(U)SIM 卡插拔状态上报，拔出 OK +QSIMSTAT: 1,1 //(U)SIM 卡插拔状态上报，插入 +CPIN: READY //(U)SIM 卡已插入 上海移远通信技术股份有限公司 54 / 216 4.15. AT+QCGTIND 语音/数据呼叫结束提示 语法 AT+QCGTIND 语音/数据呼叫结束提示 测试命令 响应 AT+QCGTIND=? +QCGTIND: (取值列表) 查询命令 AT+QCGTIND? OK 响应 +QCGTIND: 配置命令 AT+QCGTIND= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 配置是否开启提示语音/数据呼叫结束的 URC 到终端 0 关闭 1 开启 呼叫建立的连接类型 0 语音 1 数据 2 PPP 连接 备注 语音/数据呼叫结束，URC 提示：+QCGTIND: 。 M56 AT 命令手册 上海移远通信技术股份有限公司 55 / 216 举例 ATD10086; OK +QCGTIND: 0 //语音通话连接挂断时上报提示，为 0 NO CARRIER M56 AT 命令手册 上海移远通信技术股份有限公司 56 / 216 M56 AT 命令手册 5 (U)SIM 卡相关命令 5.1. AT+CIMI 请求国际移动台设备标识（IMSI 号） 语法 AT+CIMI 请求国际移动台设备标识（IMSI 号） 测试命令 响应 AT+CIMI=? OK 执行命令 响应 AT+CIMI 最大响应时间 参考 GSM 07.07 OK 300ms 参数 国际移动设备标识 举例 AT+CIMI 460023210226023 OK //查询返回 ME 内，当前(U)SIM 卡的 IMSI 号 上海移远通信技术股份有限公司 57 / 216 M56 AT 命令手册 5.2. AT+CLCK 设备锁定 该命令用于锁定、解锁、查询 ME 或网络设备。一般需要输入密码。当查询网络业务（=2） 状态时，只有当该业务对任何参数都是非激活状态，才返回'非激活'状态（=0）的返回结 果。当设定或查询网络设备时，该命令将被终止执行。 语法 AT+CLCK 设备锁定 测试命令 AT+CLCK=? 响应 +CLCK: (取值列表) 配置命令 AT+CLCK=,[,[ ,]] OK 响应 当不等于 2 且操作执行成功，返回： OK 当等于 2 且操作执行成功，返回： +CLCK: [,] ... OK 最大响应时间 5s 参考 GSM07.07 参数 'PS' PH-SIM（将 ME 锁定于(U)SIM 卡上)（当其他(U)SIM 卡插入该被锁 ME 内，ME 提示输 入密码；可以设置 ME，使之能够识别使用过的几个 SIM 卡，这样在插入这些卡后，ME 不会提 示输入密码） 'SC' (U)SIM [(U)SIM 卡锁，当 ME 重新启动时(U)SIM 请求输入 PIN 码)] 'AO' BAOC（禁止所有呼出呼叫，请参考 GSM02.88[6] clause 1） 'OI' BOIC （禁止所有国际呼出呼叫，请参考 GSM02.88[6] clause 1） 'OX' BOIC-exHC（禁止所有国际呼出呼叫，归属国除外，请参考 GSM02.88[6] clause 1） 'AI' BAIC（禁止所有呼入呼叫，请参考 GSM02.88[6] clause 2） 'IR' BIC-Roam（归属国以外漫游时，禁止所有呼入呼叫，请参考 GSM02.88 [6] clause 2） 'AB' 禁止所有服务，仅当=0 有效（请参考 GSM02.30[19]） 'AG' 禁止所有呼出服务，仅当=0 有效（请参考 GSM02.30[19]） 'AC' 禁止所有呼入服务，仅当=0 有效（请参考 GSM02.30[19]） 'FD' (U)SIM 卡固定拨号特点，当 ME 操作锁'FD'，此时只有'FD'内的号码可以呼叫 上海移远通信技术股份有限公司 58 / 216 M56 AT 命令手册 'PF' 将 ME 锁定到插入的第一张(U)SIM 卡上（当插入其他(U)SIM 卡，ME 提示输入密码） 'PN' 网络个性化（请参考 GSM 02.22） 'PU' 网络子集个性化（请参考 GSM 02.22） 'PP' 服务供应商个性化（请参考 GSM 02.22） 'PC' 公司个性化（请参考 GSM 02.22） 0 解锁 1 锁定 2 查询状态 密码 1 语音 2 数据 4 传真 7 短消息（默认）以外所有类别 8 短消息 16 同步数据电路 32 异步数据电路 0 未激活 1 激活 备注 如果 ME 内未插入(U)SIM 卡或 PIN 码未解，操作 AT+CLCK 锁，会返回+CME ERROR: 相关报错。 举例 AT+CLCK='SC', 2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 //查询当前 SC 锁状态，未锁 //设置 SC 锁，密码为：1234 OK AT+CLCK='SC',0,'1234' OK //查询当前 SC 锁状态，已锁 //解除 SC 锁，密码为：1234 上海移远通信技术股份有限公司 59 / 216 M56 AT 命令手册 5.3. AT+CPIN 输入 PIN 使用该配置命令，可向 ME 发送操作需要的密码[(U)SIM PIN，(U)SIM PUK，PH-SIM PIN 等]。如果操 作返回的是(U)SIM PUK 或者(U)SIM PUK2，则为 PUK1 码或 PUK2 码，且需要写入第二个参数，该用来取代(U)SIM 卡中的原有 PIN 码。 查询命令返回的字符串采用字母数字混编方式，指示是否需要密码。 语法 AT+CPIN 输入 PIN 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 +CPIN: 配置命令 AT+CPIN=[,] 最大响应时间 参考 GSM 07.07 OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 5s 参数 READY ME 不再需要提供密码 SIM PIN ME 等待提供(U)SIM 卡的 PIN 码 SIM PUK ME 等待提供(U)SIM 卡的 PUK 码 PH_SIM PIN ME 等待提供从终端到最初(U)SIM 卡的密码（防盗） PH_SIM PUK ME 等待提供从终端到最初(U)SIM 卡的 PUK 密码 SIM PIN2 ME 等待提供(U)SIM 卡 PIN2（例如：当编辑 FDN 号码薄，可能返回 +CME ERROR: 17） SIM PUK2 ME 等待提供(U)SIM 卡的 PUK2（在执行该命令过程中可能返回+CME ERROR: 18） 原密码（字符型）（(U)SIM 卡的 PIN 码或 PUK 密码，如：SIM PUK 或者 PH-SIM PUK） 新密码（字符型） 上海移远通信技术股份有限公司 60 / 216 举例 AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 +CPIN: READY //查询有 PIN 码锁定 OK AT+CPIN? +CPIN: READY //输入 PIN 码 OK AT+CPIN? +CPIN: SIM PUK //PIN 码锁被解除 OK //查询有 PUK 码锁定 AT+CPIN='26601934','1234' +CPIN: READY OK AT+CPIN? +CPIN: READY //输入 PUK 码和新 PIN 码 OK //PUK 锁被解除 M56 AT 命令手册 5.4. AT+CPWD 设备锁定 该命令可以修改设备锁定命令 AT+CLCK 定义的设备锁定密码。 语法 AT+CPWD 设备锁定 测试命令 AT+CPWD=? 响应 +CPWD: (取值列表),(取值列表) 配置命令 AT+CPWD=,, OK 响应 OK 若出错，返回： ERROR 上海移远通信技术股份有限公司 61 / 216 最大响应时间 参考 GSM 07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 5s M56 AT 命令手册 参数 'PS' 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' 'AB' 'AG' 'AC' 'FD' 'P2' PH-SIM（将 ME 锁定于(U)SIM 卡上，当其他(U)SIM 卡插入该被锁 ME 内，ME 提 示输入密码；可以设置 ME，使之能够识别使用过的几个(U)SIM 卡，在插入这些卡 后，ME 不会提示输入密码） (U)SIM [(U)SIM 卡锁，当 ME 重新启动时(U)SIM 请求输入 PIN 码] BAOC（禁止所有呼出呼叫，请参考 GSM02.88[6] clause 1） BOIC（禁止所有国际呼出呼叫，请参考 GSM02.88[6] clause 1） BOIC-exHC（禁止所有国际呼出呼叫，归属国除外，请参考 GSM02.88[6] clause1） BAIC（禁止所有呼入呼叫，请参考 GSM02.88[6] clause 2） BIC-Roam（归属国以外漫游时，禁止所有呼入呼叫，请参考 GSM02.88 [6] clause2） 禁止所有服务，仅当=0 有效（请参考 GSM02.30[19]） 禁止所有呼出服务，仅当=0 有效（请参考 GSM02.30[19]） 禁止所有呼入服务，仅当=0 有效（请参考 GSM02.30[19]） (U)SIM 卡固定拨号特点，当 ME 操作锁'FD'，此时只有'FD'内的号码可以呼叫 (U)SIM PIN2 字符型；与 ME 用户接口使用的设备锁密码、修改密码命令设置的密码相同 字符型；新设定的密码 整数型；表示密码最大长度 举例 AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' OK AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='4321' +CPIN: READY OK //设置新 PIN 码为 4321 //重启模块 //重启模块或重激活(U)SIM 卡，会提示输入新 PIN 码解 PIN 锁 上海移远通信技术股份有限公司 62 / 216 M56 AT 命令手册 5.5. AT+CRSM (U)SIM 卡接入限制 语法 AT+CRSM (U)SIM 卡接入限制 测试命令 AT+CRSM=? 配置命令 AT+CRSM=[,[,,,[,]]] 响应 OK 响应 +CRSM: ,[,] OK 若出错，返回： ERROR 最大响应时间 参考 GSM 07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 , 176 二进制读出 178 记录读出 192 获得返回结果 214 二进制更新 220 记录更新 242 状态 其他参数值保留；请参考 GSM11.11 整数型；用于标识(U)SIM 卡中的基础数据文件 整数型；范围 0-255，ME 传送到(U)SIM 的参数，请参考 GSM11.11[28] 参考 参考 将写入到(U)SIM 卡上的信息（十六进制；请参考 AT+CSCS） 整数型；返回 0-255 SIM 卡中与该命令实际运行相关的信息，命令可能执行成功，也可 能执行失败，两种情况下这些参数都被发送给 TE，请参考 GSM11.11 前一个命令执行成功完成后返回的结果（十六进制；请参考 AT+CSCS） 上海移远通信技术股份有限公司 63 / 216 M56 AT 命令手册 举例 AT+CRSM=242 +CRSM: 145,211,'000000007F100200000000000A13000C0400838A808A' OK //242 为(U)SIM 卡状态查询的指令码（参考 11.11），145 为 SW1，211 为 SW2， '000000007F100200000000000A13000C0400838A808A'为(U)SIM 卡返回的内容，可以根 据 GSM11.11 中的相关规定来解析具体的参数 5.6. AT+CSIM 通用(U)SIM 操作 语法 AT+CSIM 通用(U)SIM 操作 测试命令 AT+CSIM=? 配置命令 AT+CSIM=, 最大响应时间 参考 GSM 07.07 响应 OK 响应 +CSIM: , OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 整数类型；发往 TE 的或者的字符长度（例如：原始字节数的 两倍） 字符串类型（字符串应该包含在引号内）：16 进制格式，GSM 11.11 SIM 命令从 ME 到 (U)SIM 字符串类型（字符串应该包含在引号内）：16 进制格式，GSM 11.11 响应从(U)SIM 卡 到命令 上海移远通信技术股份有限公司 64 / 216 M56 AT 命令手册 5.7. AT+QCSPWD 更改 PS 超级密码 语法 AT+QCSPWD 更改 PS 超级密码 测试命令 AT+QCSPWD=? 配置命令 AT+QCSPWD=, 最大响应时间 参考 Quectel 响应 OK 响应 OK 若出错，返回： ERROR 300ms 参数 字符串类型；长度必须为 8 位的旧密码 字符串类型；长度必须为 8 位的新密码 备注 1. 旧密码的缺省值是'12345678'； 2. 如果模块被锁，AT+CLCK 开启后密码丢失或者状态是 PH-SIM PUK，都可以使用超级密码来解锁。 5.8. AT+CCID 显示 CCID 语法 AT+CCID 显示 CCID 测试命令 AT+CCID=? 执行命令 AT+CCID 最大响应时间 响应 OK 响应 +CCID: OK 300ms 上海移远通信技术股份有限公司 65 / 216 参考 Quectel 参数 当前(U)SIM 卡的 CCID 号 M56 AT 命令手册 举例 AT+CCID //查询当前(U)SIM 卡的 CCID 号为 898600220909A0206023 +CCID: '898600220909A0206023' OK 5.9. AT+QCCID 显示 CCID 语法 AT+QCCID 显示 CCID 测试命令 AT+QCCID=? 执行命令 AT+QCCID 最大响应时间 参考 Quectel 举例 AT+QCCID 898600220909A0206023 OK 响应 OK 响应 OK 300ms //查询当前(U)SIM 卡的 ICCID 号为 898600220909A0206023 上海移远通信技术股份有限公司 66 / 216 5.10. AT+QGID 获取(U)SIM 卡 GID 语法 AT+QGID 获取(U)SIM 卡 GID 执行命令 AT+QGID 最大响应时间 参考 Quectel 响应 +QGID: OK 若出错，返回： ERROR 300ms 参数 GID1 GID2 备注 如果(U)SIM 卡支持 GID，那么 GID 值将返回，否则返回 0xFF。 M56 AT 命令手册 5.11. AT+QSIMVOL 固定(U)SIM 卡工作电压 语法 AT+QSIMVOL 固定(U)SIM 卡工作电压 测试命令 AT+QSIMVOL=? 响应 +QSIMVOL: (取值列表) 查询命令 AT+QSIMVOL? OK 响应 +QSIMVOL: 上海移远通信技术股份有限公司 67 / 216 配置命令 AT+QSIMVOL= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 自动选择 1.8V 和 3.0V (U)SIM 卡工作电压 1 固定(U)SIM 卡工作电压为 1.8V 2 固定(U)SIM 卡工作电压为 3.0V 备注 该命令设置成功后会自动保存，模块重启后该命令才能生效。 M56 AT 命令手册 5.12. AT+QSPN 读取(U)SIM 卡服务运营商名称 语法 AT+QSPN 读取(U)SIM 卡服务运营商名称 查询命令 响应 AT+QSPN? +QSPN: , 最大响应时间 参考 Quectel OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 68 / 216 参数 字符串类型；(U)SIM 卡注册的服务运营商名称 0 不显示 PLMN，已经注册上 PLMN 1 显示 PLMN 备注 如果模块未插卡，执行则上报相关错误。 M56 AT 命令手册 5.13. AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数 语法 AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数 执行命令 响应 AT+QTRPIN +QTRPIN: ,,, 最大响应时间 参考 Quectel OK 300ms 参数 输入 PIN 码的剩余次数 输入 PIN2 码的剩余次数 输入 PUK 码的剩余次数 输入 PUK2 码的剩余次数 上海移远通信技术股份有限公司 69 / 216 M56 AT 命令手册 6 网络服务命令 6.1. AT+COPS 选择营运商 语法 AT+COPS 选择营运商 测试命令 AT+COPS=? 响应 +COPS: (取值列表,长字母数字格式,短字母数 字格式,数字格式)[,,(取值列表),(取值列表)] 查询命令 AT+COPS? OK 响应 +COPS: [,[,]] 配置命令 AT+COPS=[,[,]] OK 响应 OK 若出错，返回： ERROR 最大响应时间 参考 GSM 07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 75s，受网络状态影响 参数 0 未知 1 可用运营商 2 当前运运商 3 禁用运运商 上海移远通信技术股份有限公司 70 / 216 M56 AT 命令手册 字符型 表示该字符串采用字母数字型还是数字型；数字型表示 GSM 未知区标号） （请参考 GSM04.08[8]10.5.1.3 章节），该号码包括一个 3 位 BCD 国家代码（符 合 ITU-TE.212 Annex A[10]标准）和一个 2 位 BCD 网络代码，后者与管理有关 0 自动，字段可忽略 1 手动，字段不可忽略 2 从注册网络注销 3 仅设置（用于查询命令 AT+COPS?）；不尝试进行注册或注销（ 字段可忽略）；该取值不适用于查询命令的返回结果 4 手动/自动，字段不可忽略；如果手动选择失败，将进入自动选择模式 （=0） 0 长字符型（采用字母数字格式），最多 16 个字符 1 短字符型（采用字母数字格式），最多 8 个字符 2 数字型 备注 1. 配置命令选择并注册 GSM 网络营运商。设置 ME 是自动选择营运商，还是使用该命 令强制选择营运商。  当=0 时，ME 将自动尝试选择可使用的运营商。  当=1 时，ME 将强制注册选择的运营商，若该运营商无效则当前 ME 不会搜索 其他可用运营商，直到=0 时 ME 才会重新注册网络。如果 ME 重启后仍然在=1 下且没有 RPLMN 的话，ME 会保持在不注册网络的状态直到使用命令改变成自动注册模式。  当=4 时，若手动选择运营商不可用，ME 会自动选择当前网络中可用运营商继续尝试注 册。 2. 该命令设置成功后会自动保存。 举例 AT+COPS=? +COPS: (2,'CHINA MOBILE','CMCC','46000'),(3,'CHINA UNICOM GSM','CU-GSM','46001') ,,(0-4),(0-2) OK //列举当前所有网络营运商 AT+COPS? +COPS: 0,0,'CHINA MOBILE' OK //查询用长字符型表示当前已注册的网络营运商 上海移远通信技术股份有限公司 71 / 216 M56 AT 命令手册 6.2. AT+CREG 网络注册信息 语法 AT+CREG 网络注册信息 测试命令 AT+CREG=? 查询命令 AT+CREG? 配置命令 AT+CREG= 最大响应时间 参考 GSM 07.07 响应 +CREG: (取值列表) OK 响应 用户终端返回结果码显示状态，返回一个整数，表示 ME 是否已经注册。仅当=2 并且 ME 已经在网络中注册时， 返回未知信息和。 +CREG: ,[,,] OK 若错误与 ME 功能相关，则返回： +CME ERROR: 响应 OK 300ms 参数 0 禁用网络注册非请求结果码 1 启用网络注册非请求结果码+CREG: 2 启用网络注册和位置信息非请求结果码+CREG: [,,] 0 未注册；ME 当前没有搜索到要注册业务的新营运商 1 已注册，本地网 2 未注册，但 ME 正在搜索要注册业务的新营运商 3 注册被拒绝 4 未知 5 已注册，漫游 字符型：二个字节（16 进制格式）位置区编号 字符型：二个字节（16 进制格式）小区 ID 上海移远通信技术股份有限公司 72 / 216 M56 AT 命令手册 备注 URC 上报： 1. 当=1 时，MT 的网络注册状态有变化，上报：+CREG: 2. 当=2 时，MT 的网络注册状态有变化或者网络 Cell 有变化上报：+CREG: [,,] 举例 AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'1878','0873' //已注册 //带小区 ID 和位置区号 6.3. AT+CSQ 信号质量 语法 AT+CSQ 信号质量 测试命令 AT+CSQ=? 执行命令 AT+CSQ 最大响应时间 参考 GSM 07.07 响应 +CSQ: (取值列表),(取值列表) OK 响应 +CSQ: , OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 73 / 216 参数 0 小于等于-113dB 1 -111dBm 2...30 -109dBm ... -53dBm 31 大于等于-51dBm 99 未知或不可测 百分比格式 0...7 RXQUA 值，参考 GSM05.08[20] 7.2.4 章节 99 未知或不可测 举例 AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,0 OK //查询当前 CSQ 信号值为 28，误码率为 0 M56 AT 命令手册 6.4. AT+CPOL 优选运营商列表 语法 AT+CPOL 优选运营商列表 测试命令 AT+CPOL=? 响应 +CPOL: (取值列表),(取值列表) 查询命令 AT+CPOL? OK 响应 +CPOL: ,, … OK 配置命令 AT+CPOL=[,[,<oper 若错误与 ME 功能相关，则返回： +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 74 / 216 M56 AT 命令手册 >]] 最大响应时间 参考 GSM 07.07 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 整数型；(U)SIM 卡优选运营商列表中运营商的序号 0 长字符串型（采用字母数字格式）的 1 短字符串型（采用字母数字格式）的 2 数字型的 字符型；指明该格式采用字母数字混编方式还是数字方式（参考 AT+COPS） 备注 有些(U)SIM 卡不支持写入新的运营商列表。 6.5. AT+COPN 查询运营商列表 语法 AT+COPN 查询运营商列表 测试命令 AT+COPN=? 执行命令 AT+COPN 最大响应时间 响应 OK 响应 +COPN: , … OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 75 / 216 M56 AT 命令手册 参考 GSM 07.07 参数 字符型；数字格式的运营商（请参考 AT+COPS） 字符型；长字符串格式（采用字母数字格式）的运营商（请参考 AT+COPS） 备注 1. AT+COPN 命令运行结束后，返回营运商列表并输出 OK。 2. AT+COPN 命令运行时，返回 OK 前不可再次运行该命令或其他命令，否则会出现异常。 6.6. AT+QBAND 查询运营商列表 语法 AT+QBAND 查询运营商列表 测试命令 AT+QBAND=? 查询命令 AT+QBAND? 配置命令 AT+QBAND= 最大响应时间 参考 Quectel 响应 +QBAND: (取值列表) OK 响应 +QBAND: OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 30s，受网络状态影响 上海移远通信技术股份有限公司 76 / 216 参数 字符串参数，以下是支持的频段列表 'EGSM_MODE' 'DCS_MODE' 'PCS_MODE' 'GSM850_MODE' 'EGSM_DCS_MODE' 'GSM850_PCS_MODE' 'GSM850_EGSM_DCS_PCS_MODE' 备注 频段设置信息存放在用户不可擦写的存储区域。 M56 AT 命令手册 6.7. AT+QENG 开启或关闭工程模式 该命令可用于获取当前服务小区及邻近的 1~6 个小区信息。 语法 AT+QENG 开启或关闭工程模式 测试命令 AT+QENG=? 响应 +QENG: (取值列表),(取值列表) 查询命令 AT+QENG? OK 响应 小区信息提示类型由参数控制： +QENG: , 当前服务小区信息提示： +QENG: 0,,,,,,,< dbm>,,,,,,,,,, 邻近 1~6 小区信息提示： [+QENG: 1,list of (,,,,, ,,,,)相邻小区列表] OK 上海移远通信技术股份有限公司 77 / 216 M56 AT 命令手册 配置命令 AT+QENG=[,] 最大响应时间 参考 Quectel 获取载波列表： [+QENG: 2,list of ()…] BA 内的测量频点列表： [+QENG: 4,record number of the list, list of (, ,)] OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 关闭工程模式，字段被忽略 1 开启工程模式 2 开启工程模式，并激活自动上报网络信息 0 只提示当前服务小区信息 1 显示当前服务小区信息及邻近 1~6 个小区信息 2 显示当前服务小区信息及载波列表 3 显示当前服务小区信息，邻近 1~6 个小区信息以及载波列表 4 显示当前服务小区信息，邻近 1~6 个小区信息，载波列表以及 BA 测量结果列表 移动国家码 移动网络码 位置区号码，十六进制数据 小区号，十六进制数据 BCCH 信道的绝对无线频道编号 基站识别码 以 dBm 为单位的接收信号等级 C1 值 C2 值 访问一个 CCH 信道时的最大发射功率等级 允许访问系统的最小接收信号等级 TCH 信道的绝对无线频道编号，'h'道的表示跳频。 时序号 MAIO 值 HSN 值 上海移远通信技术股份有限公司 78 / 216 M56 AT 命令手册 时间提前量，范围 0~63 接收质量(sub)，范围为 0~7 接收质量(full)，范围为 0~7 相邻 6 个小区的序号 1~6 频点号 备注 1. 当=2 时，每 5 秒自动上报 URC 提示。 2. 参数和为十六进制数据；其他数据为十进制数据。 3. 如果未检测到区域数据，参数将被‘x’字符代替。 4. 如果不是检测专有模式，参数,,,,,,不显示参数 值，以字符‘x’代替。 5. 在一个连接中，如果网络支持跳频，那么 TCH 信道是不稳定的。在这种模式下使用’h’进行表 示。 6. 在专有模式下，当前服务小区的和不能更新，用‘-1’表示非法值进行显示。同时，和 在一定的条件下也不能更新，仍然保持在空闲模式下的值。这是因为在这种模式下，ME 不能 更新小区选择和重选的参数。当连接结束时，移动设备回到空闲模式，将给出正确的值。 7. 如果 TA 报告临近小区的信息，临近 6 个小区的信息将上报。如果有的小区信息无法测量，‘x’将填写 在这些小区的参数中。 8. 在专有模式中,临近小区的和参数可能被测量到，并上报一个无意义的值。临近小区的 , , 和参数无法被测量，'x'将填写在所有 6 个小区的这些参数中。 9. 命令不报告接收信号等级和接收质量，AT+CSQ 可用于获取这两个参数。 10. AT+QSPCH 可以用于在通话过程中重新获取语音信道类型(FR, HR, EFR, AMR_FR, AMR_HR)。 11. BA 测量结果列表最多支持 32 个，若有 BCCH 值无法获取基站信息，则以'x'代替。该值仅包括 BA 列表中的所有已测量的 BCCH 值，非整个 BA 列表。 举例 空闲模式： AT+QENG=2 OK +QENG: 0,460,00,1806,2602,64,46,-72,119,119,5,8,x,x,x,x,x,x,x 专有检测模式： AT+QENG=2,3 OK +QENG: 0,460,00,1806,2031,17,41,-73,-1,-1,5,8,h,7,0,24,1,0,1 +QENG: 1,1,17,-74,41,111,95,460,00,1806,2031,2,2,-74,45,110,94,460,00,1878,151,3,22,-77,40,100,84,460,00,1 806,2012,4,24,-77,45,97,81,460,00,1806,2013,5,25,-81,40,83,67,460,00,1806,2032,6,532,-92,48,-1,-1,x 上海移远通信技术股份有限公司 79 / 216 ,x,x,x //注：该功能模式需特殊版本支持 M56 AT 命令手册 6.8. AT+QSCANF GSM 频率功率扫描 语法 AT+QSCANF GSM 频率功率扫描 测试命令 AT+QSCANF=? 响应 +QSCANF: (取值列表),(取值列表) 配置命令 AT+QSCANF=, 最大响应时间 参考 Quectel OK 响应 当=9999，且执行成功返回： +QSCANF: 1, CH113, -63.5 2, CH80, -64.2 4, CH22, -64.5 … 20, CH116, -74.2 OK 当为指定参数值，且执行成功返回： +QSCANF: CH, 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 Band 900 1 Band 1800 2 Band 1900 3 9999 Band 850 扫描所有频段频率 0-1023 扫描指定频段频率 频率信号强度，单位 dBm 上海移远通信技术股份有限公司 80 / 216 M56 AT 命令手册 备注 进行频率功率扫描操作，需确保 ME 的 RF 功能已关闭，即 AT+CFUN=0 或 4。关于如何使用 AT+CFUN 切换功能模式状态，请参考 AT+CFUN 命令。 6.9. AT+QLOCKF 锁 GSM 频率 语法 AT+QLOCKF 锁 GSM 频率 测试命令 AT+QLOCKF=? 响应 +QLOCKF: ( 取 值 列 表 ),( 取 值 列 表),(取值列表) 查询命令 AT+QLOCKF? OK 响应 +QLOCKF: 配置命令 AT+QLOCKF=,, OK 响应 OK 若出错，返回： ERROR 最大响应时间 参考 Quectel 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 关闭频锁功能 1 开启频锁功能 2 开启锁频功能并开机自动切换到上次锁定的频点 0 非 1900 频段小区 1 1900 频段小区 2 自动选择是否 1900 频段小区 0-1024 频率信息 0 ME 未指定锁于一个指定频率 上海移远通信技术股份有限公司 81 / 216 1 ME 指定锁于一个指定频率 M56 AT 命令手册 上海移远通信技术股份有限公司 82 / 216 M56 AT 命令手册 7 呼叫控制命令 7.1. ATA 呼叫应答 语法 ATA 呼叫应答 执行命令 ATA 最大响应时间 参考 V.25ter 响应 语音呼叫并成功建立连接，响应为： OK 若不能建立连接，响应为： NO CARRIER 若无呼叫进入时操作，响应为： +CME ERROR: 1s，受网络状态影响 备注 1. ATA 操作忽略同一行命令中 A 后面的附加命令。 2. 在执行 ATA 操作过程中收到某一字符，该命令可能被中止执行。但是在建立连接的某些状态中（如： 握手状态），该命令不会被中断。 3. 该命令无需以终止符作为结尾。 举例 RING AT+CLCC +CLCC: 1,1,4,0,0,'02154450290',129,'' OK //语音呼叫呼入 ATA //接听语音呼叫 上海移远通信技术股份有限公司 83 / 216 M56 AT 命令手册 OK 7.2. ATD 移动台呼叫某一号码 该命令用于建立语音、数据或传真的主叫，还可以用于控制补充业务。 语法 ATD 移动台呼叫某一号码 执行命令 ATD[][;] 最大响应时间 参考 V.25ter 响应 若没有拨号音且（参数设置 ATX2 或者 ATX4），返回： NO DIALTONE 若遇忙占线（参数设置 ATX3 或者 ATX4），返回： BUSY 若连接无法建立成功或对方无应答，返回： NO CARRIER 若连接成功且为语音呼叫，返回： OK 若错误与 ME 功能相关，则返回： +CME ERROR: 1s，受网络状态影响 参数 紧急呼叫： 拨号位字符串和可选配 V.25ter 修改量： 拨号位：0-9，*，#，+，A，B，C 以下 V.25ter 拨号修改量可忽略： ,（逗号），T，P，!，W，@ 标准的紧急呼叫号码 112【不需要(U)SIM 卡】 GSM 修改量字符串： I 激活 CLIR（主叫用户不允许在被叫用户话机上显示自己的电话号码） i 禁止 CLIR（主叫用户允许在被叫用户话机上显示自己的电话号码） G 仅为本次呼叫激活闭合用户组请求 上海移远通信技术股份有限公司 84 / 216 M56 AT 命令手册 g 仅为本次呼叫不激活闭合用户组请求 仅用来建立语音呼叫，TA 保持命令模式不变 备注 1. 若在执行 ATD 过程中收到 ATH 命令，该命令可能被终止执行。但是在建立连接的某些状态（如：握 手状态），该命令不会被中止执行。 2. 参数'I'和'i'仅适用于拨号字符中无'*#'码的情况。 3. 默认为最后的号码，此号码可以使用 ATDL 来拨号。 4. 带有'*#'码的 ATD 命令将被作为语音呼叫处理，因此，该命令必须以分号';'结尾。 5. 关于结果码的设置和呼叫监控参数的详细介绍，请参考 ATX 命令。 6. ATD 命令的响应： 对于语音呼叫，可设置两种不同的响应模式：  在 TA 拨号完成后或者在呼叫建立成功后，立即返回 OK。 此设置由 AT+COLP 命令控制。出厂默认设置为 AT+COLP=0，这将使得 TA 在拨号完成后， 立即返回 OK。除此之外，TA 将返回 BUSY，NODIALTONE，NO CARRIER。  在一个已激活的语音呼叫中，使用 ATD： 在已存在一个已激活的语音呼叫时，用户发起了第二个语音呼叫，此时第一个语音呼叫将被自 动的设置为呼叫保持状态，所有呼叫的当前状态，可以随时使用 AT+CLCC 进行查询。 举例 ATD10086; OK //ATD 建立语音呼叫 7.3. ATH 挂机控制 该命令可以终止当前所有的通话。 语法 ATH 挂机控制 执行命令 ATH[0] 最大响应时间 参考 V.25ter 响应 OK 90s，受网络状态影响 上海移远通信技术股份有限公司 85 / 216 备注 在 Circuit109（DCD）关闭后，返回 OK； M56 AT 命令手册 7.4. +++ 数据模式切换至命令模式 该命令可以将 ME 从数据模式切换至 AT 命令模式。 语法 +++ 数据模式切换至命令模式 执行命令 +++ 最大响应时间 参考 V.25ter 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 备注 1. 为避免'+++'被错误的识别为数据，需遵循以下注意事项：  '+++'输入前 T1 时间（0.5 秒）内无字符。  连续输入'+++'，中间不能有其他字符；每个+间隔时间不能超过 1 秒，TCP 透传应用下每个+ 间隔不能超过 20ms。  '+++'输入后 T1 时间（0.5 秒）内无字符输入。 2. 切换至命令模式，否则重新进入步骤 1。 3. 可通过 AT 命令 ATO，从命令模式返回数据模式。 上海移远通信技术股份有限公司 86 / 216 M56 AT 命令手册 7.5. ATO 命令模式切换至数据模式 该命令可以将 ME 从 AT 命令模式切换至数据模式。 语法 ATO 命令模式切换至数据模式 执行命令 ATO[n] 响应 TA 保持数据传输连接，从命令模式切换回数据模式： CONNECT/CONNECT 最大响应时间 参考 V.25ter 若无法恢复至数据模式： NO CARRIER 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 从 AT 命令模式切换至数据模式 备注 1. TA 从命令模式返回至数据模式 CONNECT，只有当 ATX中设置大于 0 时， 才输出。 2. 可以是速率、差错控制等。 上海移远通信技术股份有限公司 87 / 216 7.6. ATP 选择脉冲拨号 操作 ATP 设置为脉冲拨号。 语法 ATP 选择脉冲拨号 执行命令 ATP 最大响应时间 参考 V.25ter 备注 GSM 网络中无效。 响应 OK 300ms M56 AT 命令手册 7.7. ATS0 自动应答前振铃次数 该命令用于设置自动应答前的振铃次数。若设置为非零取值，呼叫指示（RING）达到设置次数后， ME 自动应答。 语法 ATS0 自动应答前振铃次数 查询命令 响应 ATS0? 配置命令 ATS0= 最大响应时间 参考 V.25ter OK 响应 OK 300ms 上海移远通信技术股份有限公司 88 / 216 参数 0 禁用自动应答（默认） 1~255 达到指定的振铃次数后，启用自动应答 备注 若值设置过高，呼叫方可能在呼叫被自动应答前停止呼叫。 举例 ATS0=3 OK RING RING RING //设置三次振铃后自动接听 //呼叫进入 //三次 RING 提示后，自动接听来电 M56 AT 命令手册 7.8. ATS6 盲拨号前暂停控制 该命令用于盲拨号前暂停控制。当拨号音检测功能关闭，表示指定 DCE 在连线与拨号操作间需要 等待的秒数。 语法 ATS6 盲拨号前暂停控制 查询命令 响应 ATS6? 配置命令 ATS6= 最大响应时间 参考 V.25ter OK 响应 OK 300ms 参数 0-2-10 盲拨号前需要等待的秒数（默认为 2） 上海移远通信技术股份有限公司 89 / 216 备注 GSM 网络中无效。 M56 AT 命令手册 7.9. ATS7 等待呼叫建立完成时间 该命令可设置 TA 在应答或发起数据通话时，等待呼叫建立的秒数。 语法 ATS7 等待呼叫建立完成时间 查询命令 响应 ATS7? 配置命令 ATS7= 最大响应时间 参考 V.25ter OK 响应 OK 300ms 参数 1-60-255 建立连接或释放呼叫所用的秒数 备注 1. 若 ATS0=设置的值太高，呼叫建立可能失败。 2. 确保 ATS7 与 ATS0 的正确设置，如：ATS7=20 和 ATS0=30，则呼叫建立失败。 3. ATS7 仅用于数据连接。 7.10. ATS8 暂停拨号时间 在拨号字符串中出现逗号拨号修改量时，使用该命令，可设置在建立到拨号网络的呼叫寻址信息信令 时，TA 暂停的秒数。 上海移远通信技术股份有限公司 90 / 216 语法 ATS8 暂停拨号时间 查询命令 ATS8? 配置命令 ATS8= 最大响应时间 参考 V.25ter 响应 OK 响应 OK 300ms 参数 0 1-2-255 拨号字符串中出现逗号时，禁止 DCE 中断 暂停的秒数 备注 GSM 网络中无效。 M56 AT 命令手册 7.11. ATS10 挂机延时 该命令可设置在 DCE 指示接收线路信号不存在后，DCE 连接到该线路的剩余时间。 语法 ATS10 挂机延时 查询命令 响应 ATS10? 配置命令 ATS10= 最大响应时间 OK 响应 OK 300ms 上海移远通信技术股份有限公司 91 / 216 参考 V.25ter 参数 1-15-254 以 100 毫秒为单位的时延 7.12. ATT 音频拨号 该命令用于设置为 DTMF 音频拨号。 语法 ATT 音频拨号 执行命令 ATT 最大响应时间 参考 V.25ter 响应 OK 300ms 备注 GSM 网络中无效。 7.13. AT+CSTA 选择地址类型 根据 GSM 规范，该命令可选择拨号命令（ATD）的号码类型。 语法 AT+CSTA 选择地址类型 测试命令 AT+CSTA=? 响应 +CSTA: (取值列表) OK 上海移远通信技术股份有限公司 M56 AT 命令手册 92 / 216 查询命令 AT+CSTA? 最大响应时间 参考 GSM 07.07 响应 +CSTA: OK 300ms 参数 129 未知类型，默认值（IDSN 格式号码） 145 拨号字符串包含国际接入代码字符'+'（ISDN 格式号码） 161 国家号码类型（IDSN 格式号码） 其他 参考 GSM04.08[8]10.5.4.7 章节 M56 AT 命令手册 7.14. AT+CLCC 查询当前呼叫 该命令用于查询当前 ME 对 TE 的呼叫。 语法 AT+CLCC 查询当前呼叫 测试命令 AT+CLCC=? 执行命令 AT+CLCC 响应 OK 响应 如果命令成功但是没有呼叫，将不会有信息发送到 TE，只返 回 OK +CLCC: ,,,,[,, [,'']] ... 最大响应时间 参考 GSM 07.07 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 93 / 216 M56 AT 命令手册 参数 整数型，呼叫识别号（参考 GSM 02.30 4.5.5.1 章节）；该参数可被使用在 AT+CHLD 0 移动发起的呼叫 1 移动终止的呼叫 呼叫状态 0 激活中 1 保持中 2 拨号中（MO 呼叫） 3 振铃中（MO 呼叫） 4 入局呼叫（MT 呼叫） 5 等待中（MT 呼叫） 承载/电信业务 0 语音 1 数据 2 传真 9 未知 0 呼叫不参加多方通话（如：会议） 1 呼叫参加多方通话（如：会议） 字符型；由规定的电话号码格式 指定的字符型电话号码 129 未知类型（IDSN 格式） 145 国际号码（IDSN 格式） 举例 AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK //ME 当前存在已建立连接的主叫语音通话 7.15. AT+CR 业务上报控制 该命令用于控制是否将中间结果码+CR: 从 TA 返回给 TE。若返回，则该中间结果码将在连接 传输过程中的某一点上进行传输。与此同时，在传输差错控制或数据压缩报告之前，以及传输中间结果码 CONNECT 之前，TA 已经在连接传输过程中决定了所用业务的速率和质量。 上海移远通信技术股份有限公司 94 / 216 语法 AT+CR 业务上报控制 测试命令 AT+CR=? 查询命令 AT+CR? 配置命令 AT+CR=[] 最大响应时间 参考 GSM 07.07 响应 +CR: (取值列表) OK 响应 +CR: OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms URC 提示： +CR: 参数 0 禁用上报 1 启用上报 ASYNC 异步透传 SYNC 同步透传 REL ASYNC 异步非透传 REL SYNC 同步非透传 M56 AT 命令手册 上海移远通信技术股份有限公司 95 / 216 M56 AT 命令手册 7.16. AT+CRC 蜂窝结果码 该命令用于控制呼入指示或用于 PDP 上下文激活的 GPRS 网络请求是否使用扩展格式。若使用该格 式，则将使用非请求结果码+CRING: 把来电提示给 TE，而不是使用一般的铃音。 语法 AT+CRC 蜂窝结果码 测试命令 AT+CRC=? 响应 +CRC: (取值列表) 查询命令 AT+CRC? OK 响应 +CRC: 配置命令 AT+CRC=[] 最大响应时间 参考 GSM 07.07 OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms URC 提示： +CRING: 参数 0 1 禁用扩展格式 启用扩展格式 举例 AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK //启用扩展格式 //语音来电提示 //禁用扩展格式 上海移远通信技术股份有限公司 96 / 216 RING ATH OK //语音来电提示 M56 AT 命令手册 7.17. AT+CSNS 单一编码方案 移动台作为被叫，建立单一编码方案的呼叫时，该命令可以设置承载或电信业务。 语法 AT+CSNS 单一编码方案 测试命令 AT+CSNS=? 响应 +CSNS: (取值列表) 查询命令 AT+CSNS? OK 响应 +CSNS: 配置命令 AT+CSNS=[] 最大响应时间 参考 GSM 07.07 OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 1 2 3 4 5 6 7 语音 语音/传真交替模式，语音优先 传真 语音/数据交替模式，语音优先 数据 语音/传真交替模式，传真优先 语音/数据交替模式，数据优先 数据跟随语音模式 上海移远通信技术股份有限公司 97 / 216 7.18. AT+QSFR 配置语音编码模式 语法 AT+QSFR 配置语音编码模式 测试命令 AT+QSFR=? 查询命令 AT+QSFR? 配置命令 AT+QSFR= 最大响应时间 参考 Quectel 响应 +QSFR: (取值列表) OK 响应 +QSFR: OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 自动 1 FR 2 HR 3 EFR 4 AMR_FR 5 AMR_HR 6 FR 和 EFR，FR 优先 7 EFR 和 FR，EFR 优先 8 EFR 和 HR，EFR 优先 9 EFR 和 AMR_FR，EFR 优先 10 AMR_FR 和 FR，AMR_FR 优先 11 AMR_FR 和 HR，AMR_FR 优先 12 AMR_FR 和 EFR，AMR_FR 优先 13 AMR_HR 和 FR，AMR_HR 优先 14 AMR_HR 和 HR，AMR_HR 优先 上海移远通信技术股份有限公司 M56 AT 命令手册 98 / 216 15 AMR_HR 和 EFR，AMR_HR 优先 备注 该命令配置自动保存，重启有效。 M56 AT 命令手册 7.19. AT+QSPCH 语音信道类型上报 语法 AT+QSPCH 语音信道类型上报 测试命令 AT+QSPCH=? 查询命令 AT+QSPCH? 配置命令 AT+QSPCH= 最大响应时间 参考 Quectel 响应 +QSPCH: (取值列表) OK 响应 +QSPCH: , OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 当语音信道类型发生变化时，URC 上报： +QSPCH: , 参数 0 关闭上报 1 开启上报 语音通道类型 0 NO SPEECH TCH 1 FR 2 HR 上海移远通信技术股份有限公司 99 / 216 3 EFR 4 AMR_FR 5 AMR_HR M56 AT 命令手册 7.20. AT+QDISH ATH 使能控制 语法 AT+QDISH ATH 使能控制 测试命令 AT+QDISH=? 查询命令 AT+QDISH? 配置命令 AT+QDISH= 最大响应时间 参考 Quectel 响应 +QDISH: (取值列表) OK 响应 +QDISH: OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 ATH 命令有效 1 ATH 命令无效 上海移远通信技术股份有限公司 100 / 216 M56 AT 命令手册 8 GPRS 相关命令 8.1. AT+CGATT GPRS 附着和分离 该命令用于将 MT 附着 GPRS 业务，或将 MT 从 GPRS 业务分离。该命令执行成功后，MT 保持 V.25ter 命令状态。若 MT 已处于请求状态，则忽略执行命令操作，且返回 OK。 当附着状态转为分离状态时，将自动去激活所有 PDP 上下文。 语法 AT+CGATT GPRS 附着和分离 测试命令 AT+CGATT=? 响应 +CGATT: (取值列表) 查询命令 AT+CGATT? OK 响应 +CGATT: 配置命令 AT+CGATT= 最大响应时间 参考 GSM 07.07 OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 75s，受网络状态影响 参数 GPRS 附着状态 0 分离 上海移远通信技术股份有限公司 101 / 216 1 附着 举例 AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //GPRS 附着 //GPRS 分离 //查询 GPRS 附着状态 M56 AT 命令手册 8.2. AT+CGDCONT 定义 PDP 上下文 该命令可为 PDP 上下文定义参数，该 PDP 上下文是由本地上下文标识参数标识的。该配置命令 的特殊形式 AT+CGDCONT=将使上下文号码的取值成为未定义取值。 语法 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT: ( 取 值 列 表 ),,, ,(取值列表),(取值 列表) 查询命令 AT+CGDCONT? OK 响应 +CGDCONT: ,,,,, … 配置命令 AT+CGDCONT=[,,[ APN>[,[,[,]]]]] OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 上海移远通信技术股份有限公司 102 / 216 M56 AT 命令手册 最大响应时间 参考 GSM 07.07 300ms 参数 1~3 数值型参数；用于指定 PDP 上下文标识。该参数对 TE-MT 接口而言是本地参数， 并且可用于其他 PDP 上下文相关命令。 'IP' （分组数据协议类型）字符型参数；用于指定分组数据协议的类型。仅支持'IP'， 互联网协议 IP（Internet Protocol）（IETF STD5）。 接入点名称；表示一个字符串参数，用于选择 GGSN 或外部分组数据网络的逻辑名称。若 该参数取值为空或省略，则需要请求签约值。 字符型参数；用于表示对于特定 PDP 上下文，MT 分配的地址空间。若该参数取值为空或 省略，则 TE 在 PDP 启动过程中提供其他取值；若不能提供其他取值，则需要请求动态地 址。即便在 PDP 启动过程中已分配地址，该命令的读出形式仍继续返回为空。使用 AT+CGPADDR 命令，可读出该分配地址。 关闭（若取值省略，则该参数为缺省值）；数值型参数；用于控制 PDP 数据压缩。 关闭（若取值省略，则该参数为缺省值）；数值型参数；用于控制 PDP 头。 举例 AT+CGDCONT=1,'IP','CMNET' OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' 8.3. AT+CGQREQ 请求的服务质量 AT+CGQREQ 允许 MT 向网络发送 'PDP 上下文激活需求' 消息时，TE 指定一个服务质量。 使用配置命令，可为上下文指定一个由（本地）上下文标识参数标识的配置项。该命令的特殊形 式，即 AT+CGQREQ=，取消定义过的服务质量。 语法 AT+CGQREQ 请求的服务质量 测试命令 AT+CGQREQ=? 响应 +CGQREQ: ,(取值列表),(取值列表),(取值列表),(取值列表),(取值列表) OK 上海移远通信技术股份有限公司 103 / 216 M56 AT 命令手册 查询命令 AT+CGQREQ? 响应 +CGQREQ: ,,,,, … 配置命令 AT+CGQREQ=[,[, [,[,[,]]]]] OK 响应 OK 若出错，返回： ERROR 最大响应时间 参考 GSM 07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 整数型参数；用于指定优先级别 整数型参数；用于指定延时级别 数值型参数；用于指定处理不常见数据丢失的可靠性级别 整数型参数；用于指定峰值吞吐量级别 整数型参数；用于定义平均吞吐量级别 8.4. AT+CGQMIN 可接受的最小服务质量 AT+CGQMIN 允许 TE 指定一个可接受的最小服务质量。该配置项由 MT 检验，用于与 'PDP 上下文 激活' 消息所返回的协商配置进行比较。 使用配置命令，可为上下文指定一个由（本地）上下文标识参数标识的配置项。该命令的特殊形 式，即 AT+CGQMIN=，取消定义过的可接受最小服务质量。 语法 AT+CGQMIN 可接受的最小服务质量 测试命令 响应 AT+CGQMIN=? +CGQMIN: ,(取值列表),(取值列表),(取值列表),(取值列表),(取值列表) 查询命令 AT+CGQMIN? OK 响应 +CGQMIN: ,,,,, … 配置命令 AT+CGQMIN=[,[,< delay>[,[,[,]]]]] OK 响应 OK 若出错，返回： ERROR 最大响应时间 参考 GSM 07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 整数型参数；用于指定优先级别 整数型参数；用于指定延时级别 数值型参数；用于指定处理不常见数据丢失的可靠性级别 整数型参数；用于指定峰值吞吐量级别 整数型参数；用于定义平均吞吐量级别 8.5. AT+CGACT PDP 上下文激活和去激活 该命令可激活或去激活指定的 PDP 上下文。该命令执行成功后，MT 保持 V.25ter 命令状态。若 PDP 上下文已处于请求状态，则该状态保持不变。当执行该命令的激活形式时，若 MT 没有附着 GPRS，MT 首 先进行 GPRS 附着，然后尝试激活指定的上下文。 上海移远通信技术股份有限公司 105 / 216 语法 AT+CGACT PDP 上下文激活和去激活 测试命令 响应 AT+CGACT=? +CGACT: (取值列表) 查询命令 AT+CGACT? OK 响应 +CGACT: , … 配置命令 AT+CGACT=[,] 最大响应时间 参考 GSM 07.07 OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 150s，受网络状态影响 M56 AT 命令手册 参数 PDP 上下文激活和去激活 0 去激活 1 激活 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT。缺省值为 1。 举例 AT+CGDCONT=1,'IP','CMNET' OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' AT+CGACT=1,1 //PDP 激活 OK AT+CGACT=0,1 //PDP 去激活 NO CARRIER 上海移远通信技术股份有限公司 106 / 216 M56 AT 命令手册 8.6. AT+CGDATA 进入数据模式 该命令设置 MT 使用一个或多个 GPRS PDP 类型，执行相应的操作，在 TE 和网络间建立通信。 MT 不处理 AT 命令中 AT+CGDATA 之后的命令。 语法 AT+CGDATA 进入数据模式 测试命令 AT+CGDATA=? 响应 +CGDATA: (取值列表) 配置命令 AT+CGDATA=[,[,[,… ]]] OK 响应 OK 若出错，返回： ERROR 最大响应时间 参考 GSM 07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 字符型参数；用于表示 TE 和 MT 之间网络建立通信时 PDP 上下文使用的 2 层协议： 'PPP' 点到点协议，为一个分组数据协议，例如 IP 服务 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 8.7. AT+CGPADDR 显示 PDP 地址 该命令可返回指定上下文标识的 PDP 地址列表。 语法 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (取值列表) 上海移远通信技术股份有限公司 107 / 216 M56 AT 命令手册 查询命令 AT+CGPADDR= 最大响应时间 参考 GSM 07.07 OK 响应 +CGPADDR: [,] OK 若出错，返回： ERROR 300ms 参数 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 字符型参数；用于标识特定 PDP 上下文 MT 所获取的地址。该地址可以是静态的，也可以 是动态的。对于静止地址来说，当上下文定义后通过 AT+CGDCONT 命令设置的地址；对 于动态地址来说，在最后一次 PDP 上下文激活过程中，使用被参考的上下文定义时 所指配的地址。当地址不可用时，则省 举例 AT+CGDCONT=1,'IP','CMNET' OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' AT+CGACT=1,1 //激活 PDP 场景=1 OK AT+CGPADDR=1 //查询场景=1 的 PDP 地址 +CGPADDR: 1,'10.76.51.180' OK 8.8. AT+CGCLASS GPRS 移动台类别 该命令可根据指定的 GPRS 移动台类别设置 MT，使之能够进行操作。 语法 AT+CGCLASS GPRS 移动台类别 测试命令 响应 AT+CGCLASS=? +CGCLASS: (取值列表) 上海移远通信技术股份有限公司 108 / 216 M56 AT 命令手册 查询命令 AT+CGCLASS? 配置命令 AT+CGCLASS= 最大响应时间 参考 GSM 07.07 OK 响应 +CGCLASS: OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 30s，受网络状态影响 参数 字符型参数；表示 GPRS 移动台的类别（按功能的降序排列） 'B' 类别 B 'CG' 仅在 GPRS 模式下为类别 C 'CC' 仅在电路交换模式下为类别 C（最低级别） 8.9. AT+CGEREP 非请求 GPRS 事件上报控制 该命令可根据指定的 GPRS 移动台类别设置 MT，使之能够进行操作。 语法 AT+CGEREP 非请求 GPRS 事件上报控制 测试命令 响应 AT+CGEREP=? +CGEREP: (取值列表) 查询命令 AT+CGEREP? OK 响应 +CGEREP: OK 上海移远通信技术股份有限公司 109 / 216 配置命令 AT+CGEREP= 最大响应时间 参考 GSM 07.07 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms M56 AT 命令手册 参数 0 缓冲 MT 中的非请求结果码；若 MT 结果码缓冲器已满，则丢弃最旧的结果码。不转发 结果码给 TE 1 当保留 MT-TE 链路时（比如：在线数据模式下），丢弃非请求结果码；否则，直接转发 给 TE 请参考 AT+CGDCONT 请参考 AT+CGDCONT 请参考 AT+CGDCONT 请参考 AT+CGCLASS 备注 相关 URC 上报： +CGEV: NW DEACT ,[,] +CGEV: ME DEACT ,[,] +CGEV: NW DETACH +CGEV: ME CLASS 8.10. AT+CGREG GPRS 网络注册状态 该命令可控制关于 GPRS 注册状态一些中间结果码的显示。  当=1 并且 GPRS 注册状态发生改变，会有+CGREG: 的提示；  当=2，GPRS 注册状态发生改变且注册小区发生改变，会有+CGREG: [,,]的 提示。 上海移远通信技术股份有限公司 110 / 216 语法 AT+CGREG GPRS 网络注册状态 测试命令 AT+CGREG=? 响应 +CGREG: (取值列表) 查询命令 AT+CGREG? OK 响应 +CGREG: ,[,,] 配置命令 AT+CGREG=[] 最大响应时间 参考 GSM 07.07 OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms M56 AT 命令手册 参数 0 禁用网络注册非请求结果码+CGREG: 1 启用网络注册非请求结果码+CGREG: 2 启用网络注册非请求结果码+CGREG: [,,] 0 未注册；ME 当前没有搜索注册业务的新营运商 1 已注册，本地网 2 未注册，但 ME 正在搜索注册业务的新营运商 3 注册被拒绝 4 未知 5 已注册，漫游 字符型；2 位十六进制位置区代码（比如：00C3 相当于十六进制中的 195） 字符型；2 位十六进制小区编号 举例 AT+CGATT=0 NO CARRIER +CGREG: 0,'1878','0873' AT+CGATT=1 上海移远通信技术股份有限公司 111 / 216 OK +CGREG: 2,'1878','0873' +CGREG: 1,'1878','0873' M56 AT 命令手册 8.11. AT+QGPCLASS 配置 GPRS 多时隙级别 语法 AT+QGPCLASS 配置 GPRS 多时隙级别 测试命令 响应 AT+QGPCLASS=? MULTISLOT CLASS: (取值列表) 查询命令 AT+QGPCLASS? OK 响应 MULTISLOT CLASS: 配置命令 AT+QGPCLASS= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 GPRS 多时隙级别 上海移远通信技术股份有限公司 112 / 216 M56 AT 命令手册 9 TCP/IP 相关命令 9.1. AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 语法 AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 测试命令 响应 AT+QIOPEN=? +QIOPEN: (取值列表),(IP address range),(port r ange) +QIOPEN: (取值列表),(domain name),(port rang e) 配置命令 AT+QIOPEN=[,],/, OK 响应 如果格式正确，返回： OK 若出错，返回： ERROR 如果连接已经存在，返回： ALREAY CONNECT 最大响应时间 参考 Quectel 返回 OK 后，如果 AT+QIMODE=0 且连接成功，返回： [,]CONNECT OK 返回 OK 后，如果 AT+QIMODE=1 且连接成功，返回： CONNECT 返回 OK 后，如果连接失败，返回： [,]CONNECT FAIL OK、ERROR 或 ALREADY CONNECT 的超时时间为 300ms， [,]CONNECT OK 或[,]CONNECT FAIL 的超 时时间为 75s，受网络状态影响 上海移远通信技术股份有限公司 113 / 216 M56 AT 命令手册 参数 0~5 表明连接序号（M56F 支持 6 个 SOCKET 同时存在。当且仅 AT+QIMUX=1 时， 该参数有效。当 AT+QIMUX=0 时，该参数必须缺省（请参考 AT+QIMUX） 字符串类型；表明连接类型 'TCP' 建立 TCP 连接 'UDP' 建立 UDP 连接 字符串类型；表明远端服务器 IP 地址 远端服务器端口号 字符串类型；表明远端服务器域名地址 备注 1. 当 ME 状态（可以通过 AT+QISTAT 查询）为 IP INITIAL 或者 IP STATUS 或者 IP CLOSE 时才建立 连接。若非以上状态，需要通过操作 AT+QIDEACT 或 AT+QICLOSE 使 ME 处于以上状态才能正常 建立连接。 2. 当 AT+QIMUX=0 时，当前已存在连接或 AT+QIMUX=1 时，指定序号也存在连接，那么再次操作 AT+QIOPEN 会返回 ALREADY CONNECT。 9.2. AT+QISEND 发送 TCP 或 UDP 数据 语法 AT+QISEND 发送 TCP 或者 UDP 数据 测试命令 响应 AT+QISEND=? +QISEND: 执行命令 OK 响应 AT+QISEND 响应'>'，输入数据，执行 CTRL+Z 来发 送，执行 ESC 来终止操作 如果连接存在，发送成功返回： SEND OK 如果连接存在，发送失败返回： SEND FAIL 配置命令 1）单路连接时（AT+QIMUX=0） AT+QISEND= 如果 TCP 或 UDP 连接未建立，返回： ERROR 响应 如果连接存在，发送成功返回： SEND OK 上海移远通信技术股份有限公司 114 / 216 M56 AT 命令手册 响应'>'，输入数据，直到数据长度达到 如果连接存在，发送失败返回： 字长发送 SEND FAIL 2）多路连接时（AT+QIMUX=1） 如果 TCP 或 UDP 连接未建立，返回： AT+QISEND=[,] ERROR 若缺省，响应'>'，输入数据， 执行 CTRL+Z 来发送，执行 ESC 来终止 操作； 若不缺省，响应'>'，输入数据， 直到数据长度达到字长发送 最大响应时间 300ms 参考 Quectel 参数 数字参数；表明连接序号；该参数仅适用于 AT+QIMUX=1，若 AT+QIMUX=0，该参数必须 缺省 数字参数；表明发送数据长度。该数值最大支持 1460 字节 备注 1. 执行命令 AT+QISEND 操作，仅在 AT+QIMUX=0 可操作。 2. AT+QISEND 不可发送空字符，返回 SEND FAIL。 3. 只有在 TCP 或 UDP 连接建立时发送数据。 4. SEND OK 提示只表明数据已经传输至窗口进行发送，并不表示该数据已经收到确认报文。为确保 数据确认发送至对方，可以通过执行 AT+QISACK 命令进行查询。 9.3. AT+QICLOSE 关闭 TCP 或 UDP 连接 语法 AT+QICLOSE 关闭 TCP 或 UDP 连接 测试命令 响应 AT+QICLOSE=? OK 执行命令 AT+QICLOSE 响应 如果关闭连接成功返回： CLOSE OK 上海移远通信技术股份有限公司 115 / 216 M56 AT 命令手册 配置命令 AT+QICLOSE= 最大响应时间 参考 Quectel 如果关闭连接失败，返回： ERROR 响应 如果关闭连接成功返回： ,CLOSE OK 如果关闭连接失败，返回： ERROR 300ms 参数 数字参数；表明连接序号； 该参数仅适用于 AT+QIMUX=1，若 AT+QIMUX=0，该参数必须缺省 备注 1. 对于 AT+QICLOSE 操作：  当 AT+QISRVC=1 且 AT+QIMUX=0 时，返回 CLOSE OK，关闭 ME 作为 Client 连接远程 Server 的连接。  当 AT+QISRVC=1 且 AT+QIMUX=1 时，返回 ERROR。  当 AT+QISRVC=2 且 AT+QIMUX=0 时，返回 CLOSE OK，关闭 ME 作为 Server，远程 Client 连接 ME 建立的连接。  当 AT+QISRVC=2 且 AT+QIMUX=0 时，此时若无其他 Client 处于监听状态，该操作将使 ME 退出监听状态。  当 AT+QISRVC=2 且 AT+QIMUX=1 时，ME 作为 Server，该操作将关闭 ME 作为 Server，远 程 Client 连接 ME 建立的所有连接并且退出监听状态。 2. 对于 AT+QICLOSE=操作：  该命令操作只在 AT+QIMUX=1 时有效。  当 AT+QISRVC=1 且 AT+QIMUX=1 时，该操作将会关闭 ME 作为第的 Client 连接远 程 Server 的连接并保留 ME 作为 Server 接入的 Client 连接。  当 AT+QISRVC=2 且 AT+QIMUX=1 时，该操作将会关闭 ME 作为 Server 接入的第的 远程 Client 连接。 3. 当 AT+QISRVC=1 且 AT+QIMUX=0 时，AT+QICLOSE 只在 AT+QISTAT 为 CONNECTING 或 CONNECT OK 状态时操作成功，其他状态返回 ERROR。关闭连接成功后，状态变化为 IP CLOSE。 上海移远通信技术股份有限公司 116 / 216 M56 AT 命令手册 9.4. AT+QIDEACT 关闭 GPRS/CSD PDP 场景 语法 AT+QIDEACT 关闭 GPRS/CSD PDP 场景 测试命令 响应 AT+QIDEACT=? OK 配置命令 AT+QIDEACT 响应 如果关闭成功，返回： DEACT OK 最大响应时间 参考 Quectel 如果关闭失败，返回： ERROR 40s，受网络状态影响 CSD 相关配置暂不支持 备注 1. AT+QIDEACT 可关闭除 IP INITIAL 状态的任何 GPRS/CSD PDP 场景。关闭成功后，状态恢复至 IP INITIAL。 2. AT+QIMUX=0 时，AT+QIDEACT 可关闭当前连接和场景。 3. AT+QIMUX=1 时，AT+QIDEACT 使所有连接和场景关闭。 9.5. AT+QILPORT 配置本地端口号 语法 AT+QILPORT 配置本地端口号 测试命令 AT+QILPORT=? 查询命令 AT+QILPORT? 响应 +QILPORT: (取值列表) OK 响应 : ... OK 上海移远通信技术股份有限公司 117 / 216 配置命令 AT+QILPORT=, 最大响应时间 参考 Quectel 响应 OK 若出错，返回： ERROR 300ms CSD 相关配置暂不支持 参数 字符串参数；表明连接类型 'TCP' TCP 本地端口号 'UDP' UDP 本地端口号 0~65535 数字参数；表明本地端口号 M56 AT 命令手册 9.6. AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码 语法 AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码 测试命令 响应 AT+QIREGAPP=? +QIREGAPP: 'APN','USER','PWD' 查询命令 AT+QIREGAPP? OK 响应 +QIREGAPP: ,, 执行命令 AT+QIREGAPP OK 响应 OK 配置命令 AT+QIREGAPP=,,< password>[,] 若出错，返回： ERROR 响应 OK 若出错，返回： ERROR 上海移远通信技术股份有限公司 118 / 216 M56 AT 命令手册 最大响应时间 参考 Quectel 300ms CSD 相关配置暂不支持 参数 字符串参数；表明 GPRS/CSD 接入点名称 字符串参数；表明 GPRS/CSD 接入点用户名 字符串参数；表明 GPRS/CSD 接入点用户密码 表明 CSD 数据传输速率 备注 1. 当且仅当 ME 处于 IP INITIAL 状态时，执行命令和配置命令操作有效，操作成功后 ME 状态将变化 为 IP START。 2. AT+QICSGP 控制该执行命令参数的缺省值。 9.7. AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） 语法 AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） 测试命令 响应 AT+QIACT=? OK 执行命令 响应 AT+QIACT OK 最大响应时间 参考 Quectel 若出错，返回： ERROR 150s，受网络状态影响 CSD 相关配置暂不支持 备注 1. AT+QIACT 只有在 IP START 状态下才能操作并激活移动场景，执行后状态变化为 IPCONFIG。 2. 在 ME 接收激活场景操作后，如果移动场景激活成功，状态变化为 IP GPRSACT，返回 OK，否则 返回 ERROR。 上海移远通信技术股份有限公司 119 / 216 M56 AT 命令手册 9.8. AT+QILOCIP 获取本地 IP 地址 语法 AT+QILOCIP 获取本地 IP 地址 测试命令 AT+QILOCIP=? 执行命令 AT+QILOCIP 最大响应时间 参考 Quectel 响应 OK 响应 若执行成功，返回： 若出错，返回： ERROR 300ms CSD 相关配置暂不支持 参数 字符串参数；表明 GPRS/CSD 方式下获取的 IP 地址 备注 只有在移动场景已激活状态：IP GPRSACT、TCP/UDP CONNECTING、CONNECT OK、IP CLOSE 下才可以通过 AT+QILOCIP 查询到本地 IP 地址，否则返回 ERROR。 9.9. AT+QISTAT 查询当前连接状态 语法 AT+QISTAT 查询当前连接状态 测试命令 AT+QISTAT=? 执行命令 AT+QISTAT 响应 OK 响应 当 AT+QIMUX=0 是，返回： OK 上海移远通信技术股份有限公司 120 / 216 M56 AT 命令手册 最大响应时间 参考 Quectel STATE: 当 AT+QIMUX=1 是，返回： (+QISTAT: ,,,) 列 表 OK 300ms CSD 相关配置暂不支持 参数 字符串参数；表明连接状态 'IP INITIAL' 初始化 'IP START' 启动任务 'IP CONFIG' 配置场景 'IP IND' 激活 GPRS/CSD 场景中 'IP GPRSACT' 接收场景配置 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） 'TCP CONNECTING' TCP 连接中 'UDP CONNECTING' UDP 连接中 'IP CLOSE' TCP/UDP 连接关闭 'CONNECT OK' TCP/UDP 连接成功 'PDP DEACT' GPRS/CSD 场景异常关闭 在 ATV0 配置下，数字和字符串对应含义如下： 0 'IP INITIAL' 1 'IP START' 2 'IP CONFIG' 3 'IP IND' 4 'IP GPRSACT' 5 'IP STATUS' 6 'TCP CONNECTING' or 'UDP CONNECTING' 7 'IP CLOSE' 8 'CONNECT OK' 9 'PDP DEACT' 连接序号，范围为 0-5 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 上海移远通信技术股份有限公司 121 / 216 M56 AT 命令手册 9.10. AT+QISTATE 查询当前接入的连接状态 语法 AT+QISTATE 查询当前连接状态 测试命令 AT+QISTATE=? 执行命令 AT+QISTATE 响应 OK 响应 当 AT+QIMUX=0 是，返回： OK STATE: 当 AT+QIMUX=1 是，返回： OK STATE: +QISTATE: ,,,, 最大响应时间 参考 Quectel OK 若出错，返回： ERROR 300ms CSD 相关配置暂不支持 参数 字符串参数；表明连接状态，当 AT+QIMUX=0 时： 'IP INITIAL' 初始化 'IP START' 启动任务 'IP CONFIG' 配置场景 'IP IND' 激活 GPRS/CSD 场景中 'IP GPRSACT' 接收场景配置 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） 'TCP CONNECTING' TCP 连接中 'UDP CONNECTING' UDP 连接中 'IP CLOSE' TCP/UDP 连接关闭 'CONNECT OK' TCP/UDP 连接成功 'PDP DEACT' GPRS/CSD 场景异常关闭 当 AT+QIMUX=1 时： 上海移远通信技术股份有限公司 122 / 216 M56 AT 命令手册 'IP INITIAL' 初始化 'IP START' 启动任务 'IP CONFIG' 配置场景 'IP IND' 激活 GPRS/CSD 场景中 'IP GPRSACT' 接收场景配置 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） 'IP PROCESSING' 数据阶段 'PDP DEACT' GPRS/CSD 场景异常关闭 连接序号，范围为 0-5 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 字符串参数；表明接入连接状态，有 INITIAL 或 CONNECTED 9.11. AT+QISSTAT 查询当前 Server 状态 语法 AT+QISSTAT 查询当前 Server 状态 测试命令 响应 AT+QISSTAT=? OK 执行命令 AT+QISSTAT 响应 当 AT+QIMUX=0 是，返回： OK S: 当 AT+QIMUX=1 是，返回： OK S: C: ,,, 最大响应时间 参考 Quectel 若出错，返回： ERROR 300ms 上海移远通信技术股份有限公司 123 / 216 M56 AT 命令手册 参数 字符串参数；表明连接状态 'INITIAL' 初始化 'OPENNING' 启动任务 'LISTENING' 监听状态 'CLOSING' 关闭过程中 连接序号，范围为 0-4（当模块做 Server 工作时，最多能接入 5 路连接） 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 9.12. AT+QIDNSCFG 配置域名服务器 DNS 语法 AT+QIDNSCFG 配置域名服务器 DNS 测试命令 响应 AT+QIDNSCFG=? OK 查询命令 响应 AT+QIDNSCFG? PrimaryDns: SecondaryDns: 配置命令 AT+QIDNSCFG=[,] 最大响应时间 OK 响应 OK 若出错，返回： ERROR 300ms 参考 Quectel 参数 字符串参数；表明主域名服务器的 IP 地址 字符串参数；表明二级域名服务器的 IP 地址 上海移远通信技术股份有限公司 124 / 216 M56 AT 命令手册 备注 当激活 GPRS/CSD 场景时，TA 会主动向 GPRS/CSD 网络获取 DNS 服务器。因此强烈建议在状态为 IP GPRSACT，IP STATUS，CONNECT OK 和 IP CLOSE 时，配置 DNS 服务器。 9.13. AT+QIDNSGIP 域名解析 语法 AT+QIDNSGIP 域名解析 测试命令 AT+QIDNSGIP=? 配置命令 AT+QIDNSGIP= 最大响应时间 参考 Quectel 响应 OK 响应 OK 返回 OK 后，若解析成功： 返回 OK 后，若解析失败： ERROR: STATE: 14s，受网络状态影响 参数 字符串参数；表明 Internet 上注册的域名 字符串参数；表明 IP 地址对应的域名 数字参数；表明错误代码号 1 DNS 未授权错误 2 参数配置错误 3 网络错误 4 未找到服务器 5 超时 6 未配置 7 无内存 8 未知错误 参考 AT+QISTAT 上海移远通信技术股份有限公司 125 / 216 9.14. AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 语法 AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 测试命令 响应 AT+QIDNSIP=? +QIDNSIP: (取值列表) 查询命令 AT+QIDNSIP? OK 响应 +QIDNSIP: 配置命令 AT+QIDNSIP= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 数字参数；表明连接使用 IP 地址连接还是使用域名连接 0 使用 IP 地址连接 1 使用域名方式连接 9.15. AT+QIHEAD 配置接收数据时是否显示 IP 头 语法 AT+QIHEAD 配置接收数据时是否显示 IP 头 测试命令 响应 AT+QIHEAD=? +QIHEAD: (取值列表) OK 上海移远通信技术股份有限公司 M56 AT 命令手册 126 / 216 查询命令 AT+QIHEAD? 配置命令 AT+QIHEAD= 最大响应时间 参考 Quectel 响应 +QIHEAD: OK 响应 OK 若出错，返回： ERROR 300ms 参数 数字参数；表明接收数据时是否显示 IP 头 0 不显示 IP 头 1 显示 IP 头，格式为 'IPD(data length):' M56 AT 命令手册 9.16. AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 语法 AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 测试命令 响应 AT+QIAUTOS=? +QIAUTOS: (取值列表),(取值列表) 查询命令 AT+QIAUTOS? OK 响应 +QIAUTOS: , 配置命令 AT+QIAUTOS=[,] 最大响应时间 参考 OK 响应 OK 若出错，返回： ERROR 300ms 上海移远通信技术股份有限公司 127 / 216 Quectel M56 AT 命令手册 参数 数字参数；表明发送 TCP/UDP 数据时是否设置自动发送功能 0 未设置自动发送数据（缺省值） 1 设置自动发送数据 数字参数；表明自动发送数据时间。操作 AT+QISEND，输入数据耗时后，数据自动 发送 9.17. AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' 语法 AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' 测试命令 响应 AT+QIPROMPT=? +QIPROMPT: (取值列表) 查询命令 OK 响应 AT+QIPROMPT? +QIPROMPT: OK 配置命令 响应 AT+QIPROMPT= OK 最大响应时间 参考 Quectel 若出错，返回： ERROR 300ms 参数 数字参数；表明 AT+QISEND 操作后，是否显示'>'和'SEND OK' 0 发送成功时不显示'>'，返回'SEND OK' 1 发送成功时显示'>'，返回'SEND OK' 2 发送成功时不显示'>'，不返回'SEND OK' 3 发送成功时显示'>'，返回', SEND OK' 上海移远通信技术股份有限公司 128 / 216 9.18. AT+QISERVER 配置为服务器 语法 AT+QISERVER 配置为服务器 测试命令 AT+QISERVER=? 查询命令 AT+QISERVER? 执行命令 AT+QISERVER 配置命令 AT+QISERVER=[,] 最大响应时间 参考 Quectel 响应 OK 响应 +QISERVER: , OK 响应 OK 若出错，返回： ERROR 成功配置为服务器，返回： SERVER OK 配置为服务器失败，返回： CONNECT FAIL 响应 OK 若出错，返回： ERROR 150s，受网络状态影响 参数 数字参数；是否配置成服务器 0 不配置成服务器 1 配置成服务器 当前已连入的客户端的数量，范围为 1-5 数字参数；表明配置的服务器类型 0 TCP 服务器 1 UDP 服务器 服务器最大可接入连接数，默认为 1，范围为 1-5 M56 AT 命令手册 上海移远通信技术股份有限公司 129 / 216 备注 当 AT+QIMUX=0 时，参数被缺省。 M56 AT 命令手册 9.19. AT+QICSGP 设置 CSD 或 GPRS 连接模式 语法 AT+QICSGP 设置 CSD 或 GPRS 连接模式 测试命令 AT+QICSGP=? 响应 +QICSGP: 0-CSD,DIAL NUMBER,USER NAME,PASSW ORD,RATE(0-3) +QICSGP: 1-GPRS,APN,USER NAME,PASSWORD 查询命令 AT+QICSGP? OK 响应 +QICSGP: 配置命令 AT+QICSGP=,[(,,)/(,< user name>,,)] OK 响应 OK 若出错，返回： ERROR 最大响应时间 300ms 参考 Quectel CSD 相关配置暂不支持 参数 数字参数；表明无线连接模式 0 CSD 连接 1 GPRS 连接 GPRS 连接配置的参数说明： 字符串参数；表明接入点名称 字符串参数；表明用户名 字符串参数；表明用户密码 CSD 连接配置的参数说明： 字符串参数；表明 CSD 号码 上海移远通信技术股份有限公司 130 / 216 字符串参数；表明 CSD 连接用户名 字符串参数；表明 CSD 连接用户密码 数字参数；表明 CSD 连接速率 0 2400 1 4800 2 9600（缺省值） 3 14400 M56 AT 命令手册 9.20. AT+QISRVC 选择当前可操作连接 语法 AT+QISRVC 选择当前可操作连接 测试命令 AT+QISRVC=? 响应 +QISRVC: (取值列表) 查询命令 AT+QISRVC? OK 响应 +QISRVC: 配置命令 AT+QISRVC= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms CSD 相关配置暂不支持 参数 数字参数；用于选择当前可操作连接 1 选择 ME 作为 Client 的连接 2 选择 ME 作为 Server 的连接 备注 该操作用于以下情况：当前存在两路或多路连接，一路连接是 ME 作为 Client 连接远程 Server，一路连 接时 ME 作为 Server 接入远程 Client，通过该命令可区分和选择当前操作的连接。 上海移远通信技术股份有限公司 131 / 216 M56 AT 命令手册 9.21. AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号 语法 AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号 测试命令 AT+QISHOWRA=? 响应 +QISHOWRA: (取值列表) 查询命令 AT+QISHOWRA? OK 响应 +QISHOWRA: (取值列表) 配置命令 AT+QISHOWRA= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 数字参数；表明接收数据时是否显示发送方的 IP 地址和端口号 0 不显示（默认值） 1 显示，格式为：RECV FROM:: 9.22. AT+QISCON 保存 TCP/IP 应用场景配置 语法 AT+QISCON 保存 TCP/IP 应用场景配置 测试命令 AT+QISCON=? 查询命令 AT+QISCON? 响应 OK 响应 显示 TCP/IP 上下文： SHOW APPTCPIP CONTEXT 上海移远通信技术股份有限公司 132 / 216 M56 AT 命令手册 执行命令 AT+QISCON 最大响应时间 参考 Quectel +QIDNSIP: +QIPROMPT: +QIHEAD: +QISHOWRA: +QICSGP: Gprs Config APN: Gprs Config UserId: Gprs Config Password: Gprs Config inactivityTimeout: App Tcpip Mode: [In Transparent Transfer Mode Number of Retry: Wait Time: Send Size: esc:] OK 响应 OK 300ms 参数 请参考 AT+QIDNSIP 请参考 AT+QIPROMPT 请参考 AT+QIHEAD 请参考 AT+QISHOWRA 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 以下配置仅属于透明传输模式： 请参考 AT+QITCFG 请参考 AT+QITCFG 请参考 AT+QITCFG 请参考 AT+QITCFG 上海移远通信技术股份有限公司 133 / 216 M56 AT 命令手册 备注 1. 执行命令保存以下 AT 命令配置：AT+QIDNSIP，AT+QIPROMPT，AT+QIHEAD，AT+QISHOWRA， AT+QICSGP，AT+QITCFG。 2. 执行命令操作只影响当前前置场景各参数配置（请参考 AT+QIFGCNT）。 9.23. AT+QIMODE 配置 TCP/IP 应用模式 语法 AT+QIMODE 配置 TCP/IP 应用模式 测试命令 响应 AT+QIMODE=? +QIMODE: (取值列表) 查询命令 AT+QIMODE? OK 响应 +QIMODE: 配置命令 AT+QIMODE= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 0 非透传模式 1 透传模式（在该模式下，建立连接成功后，UART 将会进入数据模式。接收到的数据将 直接输出至串口，可通过'+++'退出数据模式，ATO 操作返回数据模式） 上海移远通信技术股份有限公司 134 / 216 M56 AT 命令手册 9.24. AT+QITCFG 配置透明传输模式 语法 AT+QITCFG 配置透明传输模式 测试命令 AT+QITCFG=? 响应 +QITCFG: (取值列表,取值列表,取值列表,取值列表) 查询命令 AT+QITCFG? OK 响应 +QITCFG: ,,, 配置命令 AT+QITCFG=,,< SendSz>, 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 一个 IP 包的重传次数 间隔发送时间，单位为 100ms 每次发送数据字节数 是否开启转义序列，缺省值是 TRUE 备注 1. 最大值为 1460 字节。 2. 和都可以指示发送数据操作。当发送的数据长度大于或等于时，将 优先发送长度的数据给远程连接；当发送的数据长度小于 时，将会等待 时长，时间到后将串口已输入的数据发送出去。 3. 该命令只在 AT+QIMUX=0 状态下有效。 上海移远通信技术股份有限公司 135 / 216 M56 AT 命令手册 9.25. AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议 语法 AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议 测试命令 AT+QISHOWPT=? 响应 +QISHOWPT: (取值列表) 查询命令 AT+QISHOWPT? OK 响应 +QISHOWPT: 配置命令 AT+QISHOWPT= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 数字参数；配置在接收到 TCP 或 UDP 数据时，接收数据 IP 头内是否显示传输协议 0 不显示 1 显示，格式为：IPD(data length)(TCP/UDP): 备注 该=1 只在 AT+QIHEAD=1 时有效。 上海移远通信技术股份有限公司 136 / 216 9.26. AT+QIMUX 控制是否启用多路连接 语法 AT+QIMUX 控制是否启用多路连接 测试命令 AT+QIMUX=? 响应 +QIMUX: (取值列表) 查询命令 AT+QIMUX? OK 响应 +QIMUX: 配置命令 AT+QIMUX= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 数字参数；控制当前场景下连接模式 0 不启用多路连接 1 启用多路连接 M56 AT 命令手册 9.27. AT+QISHOWLA 控制是否显示本地 IP 地址 语法 AT+QISHOWLA 控制是否显示本地 IP 地址 测试命令 响应 AT+QISHOWLA=? +QISHOWLA: (取值列表) 查询命令 AT+QISHOWLA? OK 响应 +QISHOWLA: 上海移远通信技术股份有限公司 137 / 216 M56 AT 命令手册 配置命令 AT+QISHOWLA= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 数字参数；表明在接收到数据前是否显示数据发送的目的 IP 地址 0 不显示 1 显示，格式为：TO: 9.28. AT+QIFGCNT 配置前置场景 语法 AT+QIFGCNT 配置前置场景 测试命令 AT+QIFGCNT=? 查询命令 AT+QIFGCNT? 配置命令 AT+QIFGCNT= 最大响应时间 参考 Quectel 响应 +QIFGCNT: (取值列表) OK 响应 +QIFGCNT: , OK 响应 OK 若出错，返回： ERROR 300ms 上海移远通信技术股份有限公司 138 / 216 参数 数字参数；表明当前前置场景序号，范围为 0-1 数字参数；表明当前场景受控于哪一个通道 0 VIRTUAL_UART_1 1 VIRTUAL_UART_2 2 VIRTUAL_UART_3 3 VIRTUAL_UART_4 255 当前场景未受控于任何通道 M56 AT 命令手册 9.29. AT+QISACK 查询发送数据信息 语法 AT+QISACK 查询发送数据信息 测试命令 AT+QISACK=? 查询命令 AT+QISACK 配置命令 AT+QISACK= 最大响应时间 参考 Quectel 响应 OK 响应 +QISACK: ,, OK 响应 +QISACK: ,, OK 300ms 参数 查询的连接序号 数字参数；表明已发送数据大小 数字参数；表明已发送并得到远程接收方确认的数据大小 数字参数；表明已发送但未得到远程接收方确认的数据大小 上海移远通信技术股份有限公司 139 / 216 M56 AT 命令手册 备注 1. 执行命令仅在 AT+QIMUX=0 时有效。 2. 配置命令仅在 AT+QIMUX=1 时有效。 3. 该命令操作受控于 AT+QISRVC 配置。当 AT+QISRVC=1 时，查询的是 ME 作为 Client 向远程 Server 发送数据信息；当 AT+QISRVC=2 时，查询的是 ME 作为 Server 向远程 Client 发送的数据信息。 9.30. AT+QINDI 配置是否缓存接收到的数据 语法 AT+QINDI 配置是否缓存接收到的数据 测试命令 响应 AT+QINDI=? +QINDI: (取值列表) 查询命令 AT+QINDI? OK 响应 +QINDI: 配置命令 AT+QINDI= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 数字参数；表明是否缓存接收到的数据 0 不缓存；接收到数据直接输出至串口 1 缓存模式 1；接收到数据将会向串口上报提示，格式为：+QIRDI: ,,（此 时可以通过 AT+QIRD 读取缓存的数据） 2 缓存模式 2；接收到数据将会向串口上报提示，格式为： +QIRDI: ,,,,,。每个 Socket 将建立一个缓存，接收 的数据将被保存在缓存中，直到通过 AT+QIRD 读取缓存的数据，缓存数据不应超过 400KB 数字参数；表明哪个场景接收到了新数据并缓存到缓存器内（可参考 AT+QIFGCNT）， 范围为 0-1 上海移远通信技术股份有限公司 140 / 216 M56 AT 命令手册 数字参数；表明 ME 是作为 Server 还是作为 Client 建立的连接接收到数据 1 ME 作为 Client 连接 2 ME 作为 Server 连接 数字参数；表明 ME 是哪一路连接接收到数据，范围为 0-5（当 AT+QIMUX=0 时，=0） 9.31. AT+QIRD 读取缓存的数据 语法 AT+QIRD 读取缓存的数据 测试命令 AT+QIRD=? 配置命令 AT+QIRD=,,, 最大响应时间 参考 Quectel 响应 +QIRD: (取值列表,取值列表,取值列表, 取值列表) OK 响应 [+QIRD: :,,] OK 若出错，返回： ERROR 300ms 参数 数字参数；表明哪个场景接收到了新数据并缓存到缓存器内（可参考 AT+QIFGCNT），范围 是 0-1 数字参数；表明 ME 是作为 Server 还是作为 Client 建立的连接接收到数据 1 ME 作为 Client 连接 2 ME 作为 Server 连接 数字参数；表明 ME 是哪一路连接接收到数据，范围为 0-5（当 AT+QIMUX=0 时，=0） 读取数据长度，范围为 1-1500 发送数据方的 IP 地址 发送数据方的端口号 字符串类型；表明传输协议类型 TCP TCP 协议 上海移远通信技术股份有限公司 141 / 216 UDP UDP 协议 读取到的真实数据长度 读取到的数据内容 M56 AT 命令手册 9.32. AT+QISDE 控制 AT+QISEND 是否允许数据回显 语法 AT+QISDE 控制 AT+QISEND 是否允许数据回显 测试命令 响应 AT+QISDE=? +QISDE: (取值列表) 查询命令 AT+QISDE? OK 响应 +QISDE: 配置命令 AT+QISDE= 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 参数 数字参数；表明在操作 AT+QISEND 发送数据时，是否允许数据回显 0 不回显 1 回显 上海移远通信技术股份有限公司 142 / 216 M56 AT 命令手册 9.33. AT+QPING PING 远程服务器 语法 AT+QPING PING 远程服务器 测试命令 AT+QPING=? 响应 +QPING: 'HOST',(取值列表),(取值 列表) 配置命令 AT+QPING=''[,[][,]] OK 响应 OK [+QPING: [,,,,] …] 最大响应时间 参考 Quectel +QPING: [,,,,,,] 若出错，返回： ERROR 取决于 参数 字符串参数；远程服务器地址，可以是 IP 地址格式亦可以是域名格式 数字参数；每一次 PING 请求响应最大超时时间；单位：秒，范围：1-255，默认 1s 数字参数；PING 请求次数；范围：1-10，默认：4 PING 请求结果： 0 收到远程服务器响应，提示：,,, 1 PING 请求超时 远程服务器 IP 地址 每一次 PING 发送的数据长度 PING 请求耗时，单位：毫秒 PING 请求返回的当前时间 结束结果码 2 正常结束；成功激活 GPRS 连接上远程服务器，提示： ,,,,, 3 TCP/IP 协议栈忙 上海移远通信技术股份有限公司 143 / 216 4 未找到远程服务器 5 激活 PDP 场景失败 发送 PING 请求总次数 发送 PING 请求并收到响应总次数 PING 请求超时次数 最小响应时间，单位：毫秒 最大响应时间，单位：毫秒 平均响应时间，单位：毫秒 M56 AT 命令手册 9.34. AT+QNTP 通过网络时间服务器同步本地时间 语法 AT+QNTP 通过网络时间服务器同步本地时间 测试命令 响应 AT+QNTP=? +QNTP: 'SERVER',(取值列表) 查询命令 AT+QNTP? OK 响应 +QNTP: '', 执行命令 AT+QNTP 配置命令 AT+QNTP=''[,] 最大响应时间 参考 Quectel OK 响应 OK +QNTP: 若出错，返回： ERROR 响应 OK +QNTP: 若出错，返回： ERROR 120s，受网络状态影响 上海移远通信技术股份有限公司 144 / 216 参数 字符串参数；时间服务器的 IP 地址或域名 时间服务器的端口号 时间同步结果 0 本地时间同步成功 1 本地时间同步失败，未知错误 2 时间服务器无响应 3 TCP/IP 协议栈忙 4 未找到时间服务器 5 激活 PDP 场景失败 备注 中国默认国际时间服务器地址为'210.72.145.44'，端口号是 123。 M56 AT 命令手册 9.35. AT+QIKALIVE 设置 TCP/IP 心跳包参数 语法 AT+QIKALIVE 设置 TCP/IP 心跳包参数 测试命令 响应 AT+QIKALIVE=? +QIKALIVE: ( 取 值 列 表 )[,( 取 值 列 表),(取值列表)] 查询命令 AT+QIKALIVE? OK 响应 +QIKALIVE: ,, 配置命令 AT+QIKALIVE=[,,] 最大响应时间 参考 Quectel OK 响应 OK 若出错，返回： ERROR 300ms 上海移远通信技术股份有限公司 145 / 216 参数 0 关闭检测心跳包功能 1 打开检测心跳包功能 发送心跳包的频率 60 参数范围为 60-1800 秒，默认值为 60 秒 如果心跳包发送失败，再次发送间隔时间 10 参数范围为 10-20 秒，默认值为 10 秒 备注 重启后参数恢复默认值。 M56 AT 命令手册 上海移远通信技术股份有限公司 146 / 216 M56 AT 命令手册 10 补充业务命令 10.1. AT+CCFC 设置呼叫转移 AT+CCFC 根据 GSM 02.82[4]，对呼叫转移业务进行控制，同时支持注册、删除、激活、去激活和状 态查询。 语法 AT+CCFC 设置呼叫转移 测试命令 AT+CCFC=? 响应 +CCFC: (取值列表) 设置命令 AT+CCFC=,[,,[,[,[,[,time]]]]]] OK 响应 若不等于 2 且操作成功： OK 若等于 2 且操作成功（当且仅当=0~3）： +CCFC: ,[,,[,,[,]]] ... 最大响应时间 参考 GSM 07.07 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 无条件 1 移动遇忙 上海移远通信技术股份有限公司 147 / 216 M56 AT 命令手册 2 无应答 3 不可及 4 所有呼叫转移(0-3)（请参考 GSM 02.30[19]） 5 所有条件呼叫转移(1-3)（请参考 GSM 02.30[19]） 0 禁用 1 启用 2 状态查询 3 注册 4 删除 字符型；呼叫转移地址的电话号码，其格式符合所规定的 整数型的八位字节地址类型（请参考 GSM 04.08[8] 10.5.4.7 章节）；当拨号字符串包括国际 接入代码字符'+'时，缺省值为 145；其他情况下，缺省值为 129 字符型；由规定的字符型子地址的格式 整数型的八位字节子地址类型（请参考 GSM 04.08[8] 10.5.4.8 章节） 1 语音 2 数据 4 传真 7 语音，数据和传真 8 短消息 16 同步数据电路 32 异步数据电路 1…30 如果启用或禁止'无应答'，该参数使得再改呼叫转移前有秒数的等待时间，默认值 为 20 0 非激活 1 激活 举例 AT+CCFC=0, 2,'15021012496' OK //设置无条件转移至 15021012496 AT+CCFC=0,2 //查询无条件转移设置，转移成功 +CCFC: 1, 1,'+8615021012496',145 OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0, 15 //删除无条件转移 //查询无条件转移设置，设置删除 OK 上海移远通信技术股份有限公司 148 / 216 M56 AT 命令手册 10.2. AT+CCUG 封闭用户组 该命令可控制 CUG（Closed User Group）附加业务（详情请参考 GSM 02.85[21]）。用户可选择 CUG 索引、抑制 OA（Outgoing Access）、抑制优先 CUG。 语法 AT+CCUG 封闭用户组 测试命令 AT+CCUG=? 查询命令 AT+CCUG? 响应 OK 响应 +CCUG: ,, 设置命令 AT+CCUG=[][,[,]] 最大响应时间 参考 GSM 07.07 OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 1 0...9 10 0 1 2 4 禁用暂时模式下提供的 CUG 业务 启用暂时模式下提供的 CUG 业务 CUG 索引 无索引（优先 CUG 取自用户数据） 无信息 抑制 OA 抑制优先 CUG 抑制 OA 和优先 CUG 上海移远通信技术股份有限公司 149 / 216 M56 AT 命令手册 10.3. AT+CCWA 呼叫等待 该命令根据 GSM02.83[5]，对呼叫等待业务进行禁用，启用及查询控制。 语法 AT+CCWA 呼叫等待 测试命令 AT+CCWA=? 响应 +CCWA: (取值列表) 查询命令 AT+CCWA? OK 响应 +CCWA: 配置命令 AT+CCWA=[],[,]] OK 响应 当不等于 2 且操作成功： OK 当等于 2 且操作成功： +CCWA: , ... OK 最大响应时间 参考 GSM 07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 相关 URC 上报： +CCWA: ,,[,] 参数 在 TA 设置或显示结果码的显示状态 0 禁用 1 启用 若没有给定该参数，则不能询问网络 0 禁用 1 启用 2 查询状态 代表每一种信息类别的整数的总和 1 语音（电话业务） 上海移远通信技术股份有限公司 150 / 216 M56 AT 命令手册 2 数据 4 传真 16 同步数据电路 32 异步数据电路 0 非激活 1 激活 字符串类型；电话号码的地址类型必须符合的要求 整型格式的地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 可选字符类型，字母数字的表示对应电话号码簿中的位置 备注 1. 如果对于任何，例如+CCWA: 0,7，服务都没有被激活，这种情况下，=0 将会返 回。 2. 当=2，所有的激活的呼叫转移号码将被上报，在这种模式下，按任何键，命令都可以被终 止。 举例 AT+CCWA=1,1 OK ATD10086; OK +CCWA: '02154450293',129,1 //启用在 TA 设置或显示结果码的显示状态 //建立通话 //通话中来电，来电处于呼叫等待状态中 10.4. AT+CHLD 呼叫保持和多方通话 使用该命令，可将当前通话暂时从 ME 释放，但是网络和多方通话仍然保持该连接。具有两个通话（一 个通话保持，另一个通话在用或提示）的用户可以连接到其他各方的通话，并释放自己的连接。 语法 AT+CHLD 呼叫保持和多方通话 测试命令 AT+CHLD=? 响应 +CHLD: (取值列表) OK 上海移远通信技术股份有限公司 151 / 216 M56 AT 命令手册 配置命令 AT+CHLD=[] 最大响应时间 参考 GSM 07.07 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 释放所有保持的呼叫或者等待中的呼叫（UDUB 用户决定忙）。如果有电话处于等待状 态，终止等待的电话，否则，终止所有保持的电话 1 如果存在当前呼叫，释放所有当前呼叫并将接听另外一个已保持或等待中的呼叫。当只 有一路通话时，该操作不能结束已激活的通话 1X 释放当前某一特定的呼叫 X（X=1~7） 2 如果存在当前呼叫，保持所有当前呼叫并接听另外一个已保持或等待中的呼叫 2X 保持除通讯必须支持的呼叫 X（X=1~7）外的所有当前呼叫 3 为会话增加一个已保持通话 备注 该业务仅适用于电信服务 11（报告：电话）。 举例 AT+CCWA=1,1 OK ATD10086; OK //启用在 TA 设置或显示结果码的显示状态 //建立通话 +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129,'' //通话中来电，来电处于呼叫等待状态中 //保持第一路通话，并接入第二路呼叫等待的通话 //第一路通话被保持 +CLCC: 2,1,0,0,0,'02154450293',129,'' //第二路通话被接入 OK AT+CHLD=21 OK //激活第一路通话，保持第二路通话 上海移远通信技术股份有限公司 152 / 216 AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' //第一路通话被接入 +CLCC: 2,1,1,0,1,'02154450293',129,'' //第二路通话被保持 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129,'' //激活所有通话，实现 3 方通话 +CLCC: 2,1,0,0,1,'02154450293',129,'' OK M56 AT 命令手册 10.5. AT+CLIP 来电号码显示设置 语法 AT+CLIP 来电号码显示设置 测试命令 AT+CLIP=? 查询命令 AT+CLIP? 配置命令 AT+CLIP=[] 最大响应时间 参考 GSM 07.07 响应 +CLIP: (取值列表),(取值列表) OK 响应 +CLIP: OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 15s，受网络状态影响 URC 上报： 当可在 TE 显示 CLI 且主叫方允许的情况下，当所有 RING 或 +CRING: 的返回结果从 TA 发送到 TE 后，将返回： +CLIP: ,,'[]',[],'[]', 上海移远通信技术股份有限公司 153 / 216 M56 AT 命令手册 参数 0 不显示结果码 1 显示结果码 0 未提供 CLIP 业务 1 提供 CLIP 业务 2 未知 字符型；由规定的电话号码格式 整数型的八位字节地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 字符串类型；电话本中条目对应的字符表示（该参数由 AT+QCLIP 控制 是否显示字符串内容） 0 CLI 有效 1 CLI 由发起端保留 2 CLI 由于网络问题或者由于发起端网络的限制而不可行 备注 1. 配置命令可启用或禁用 CLI 显示在 TE 上。但对附加业务 CLIP 在网络中的执行没有影响。 2. 查询命令给定的状态，并根据 GSM02.81[3]触发对 CLIP 业务的配置状态的查询。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,'',,'',0 10.6. AT+QCLIP 配置来电是否显示主叫号码名称 语法 AT+QCLIP 配置来电是否显示主叫号码名称 测试命令 响应 AT+QCLIP=? +QCLIP: (取值列表) 上海移远通信技术股份有限公司 154 / 216 查询命令 AT+QCLIP? 配置命令 AT+QCLIP= 最大响应时间 参考 Quectel OK 响应 +QCLIP: OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 来电是否显示主叫号码名称 0 不显示 1 显示 备注 该命令仅在 AT+CLIP=1 下有效。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+QCLIP=1 OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,'',,'QUECTEL',0 M56 AT 命令手册 上海移远通信技术股份有限公司 155 / 216 M56 AT 命令手册 10.7. AT+CLIR 主叫识别限制 当主叫方发起呼叫时，使用该命令可启用或禁止在被叫方显示 CLI。对于所有的接下来的去电，已经设 置了一个默认值作为临时模式，那么这个命令将会覆盖 CLIR 设置（默认是限制或者允许）。通过使用相反 的命令，这个设置被撤销。 语法 AT+CLIR 主叫识别限制 测试命令 AT+CLIR=? 响应 +CLIR: (取值列表) 查询命令 AT+CLIR? OK 响应 +CLIR: , 配置命令 AT+CLIR=[] 最大响应时间 参考 GSM 07.07 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 15s，受网络状态影响 参数 设置出局呼叫的调整状态 0 依据 CLIR 业务的开通状态使用提示指示语 1 CLIR 调用 2 CLIR 抑制 显示主叫在网络中的 CLIR 业务状态 0 未提供 CLIR 业务 1 永久方式下提供的 CLIR 业务 2 未知（如：无网络等） 3 暂时模式下提供的 CLIR 业务受限 4 暂时模式下提供的 CLIR 业务不受限 上海移远通信技术股份有限公司 156 / 216 备注 使用该命令功能，需要注意对应(U)SIM 卡是否支持号码隐藏业务。 M56 AT 命令手册 10.8. AT+COLP 显示被叫识别 当主叫方在发起呼叫时，使用该命令可启用或禁止显示呼叫识别。在任何的+CR 或者 V.25ter 响应之 前，中间结果码直接从 TA 返回给 TE。 语法 AT+COLP 显示被叫识别 测试命令 AT+COLP=? 响应 +COLP: (取值列表) 查询命令 AT+COLP? OK 响应 +COLP: , 配置命令 AT+COLP=[] 最大响应时间 参考 GSM 07.07 OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 15s，受网络状态影响 URC 上报： 当使能（并且被叫用户容许），在任何+CR 和 V.25ter 响应之 前，一个中间结果码返回： +COLP: ,[,,[,]] 参数 0 不显示结果码 1 显示结果码 0 未提供 COLP 业务 1 提供 COLP 业务 2 未知 字符型；由规定的电话号码格式 上海移远通信技术股份有限公司 157 / 216 M56 AT 命令手册 整数型的八位字节地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 字符串类型；子地址格式符合 整型格式的子地址类型（参考 GSM04.08[8] 10.5.4.8 章节） 字符串类型；电话本中条目对应的字符表示（该参数由 AT+QCOLP 控制是 否显示字符串内容） 备注 查询命令给定的状态，并根据 GSM02.81[3]，可触发对 COLP 业务的配置状态的查询（中给定）。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,'',0,'' OK 10.9. AT+QCOLP 配置去电是否显示主叫号码名称语法 语法 AT+QCOLP 配置去电是否显示主叫号码名称语法 测试命令 响应 AT+QCOLP=? +QCOLP: (取值列表) 查询命令 AT+QCOLP? OK 响应 +QCOLP: 配置命令 AT+QCOLP= OK 响应 OK 若错误与 ME 功能相关，则返回： 上海移远通信技术股份有限公司 158 / 216 +CME ERROR: 最大响应时间 参考 Quectel 300ms 参数 是否显示+COLP 字符串名称 0 不显示 1 显示 备注 该命令仅在 AT+COLP=1 下有效。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+QCOLP=1 OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,'',0,'QUECTEL' OK M56 AT 命令手册 10.10. AT+CUSD 非结构化附加业务 该命令根据 GSM02.90[23]，用于对 USSD（Unstuctured Supplementary Service Data）进行控制。 该命令支持网络和移动发起的操作。用于启用或禁用非请求结果码（网络返回的 USSD 返回结果 或网络发起操作）+CUSD: [,[,]]显示在 TE 上的。 指定时，移动发起的 USSD 字符串或网络发起操作的返回结果 USSD 字符串将发送给网络。通 过非请求结果码+CUSD，返回网络侧的返回结果 USSD 字符串。 上海移远通信技术股份有限公司 159 / 216 语法 AT+CUSD 非结构化附加业务 测试命令 AT+CUSD=? 查询命令 AT+CUSD? 配置命令 AT+CUSD=[[,[,]]] 最大响应时间 参考 GSM 07.07 响应 +CUSD: (取值列表) OK 响应 +CUSD: OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 120s，受网络状态影响 M56 AT 命令手册 参数 用于指示非结构化附加业务数据控制的数字参数 0 禁用结果码显示在 TA 上 1 启用结果码显示在 TA 上 2 取消会话（不适用于查询命令的返回结果） 字符串类型；USSD 字符串（如果表示使用 GSM03.38[25]中的缺省符号值，ME/TA 将根 据 GSM07.05[24]Annex A，将 GSM 中的符号集转换为当前 TE 的字符集） GSM03.38[25]中采用整数型的小区广播数据编码方案（默认值为 0） 举例 AT+CSCS='UCS2' OK AT+CUSD=1,'002A0031003000300023' +CUSD: 1,'0031002E59296C14000A0032002E65B095FB000A0033002E8BC15238000A0034002E5F6979680 00A0035002E751F6D3B000A0036002E5A314E50000A0037002E5E385DDE98CE91C7000A002A002 E900051FA000A', 72 OK 上海移远通信技术股份有限公司 160 / 216 M56 AT 命令手册 10.11. AT+CSSN 附加业务通知 该命令表示与附加业务有关的由网络发起的通知。使用该配置命令，可启用或禁用 TA 的通知结果码显 示在 TE 上。 当 =1 ， 并 且 在 移 动 终 端 发 起 呼 叫 的 过 程 中 收 到 附 加 业 务 通 知 时 ， 中 间 结 果 码 +CSSI: [,]将被发送给 TE。 当=1，并且在移动终端终止呼叫过程中收到附加业务通知时，或在收到前转校验附加业务通知时， 非请求结果码+CSSU: 将被发送给 TE。 语法 AT+CSSN 附加业务通知 测试命令 AT+CSSN=? 响应 +CSSN: (取值列表),(取值列表) 查询命令 AT+CSSN? OK 响应 +CSSN: , 配置命令 AT+CSSN=[[,]] 最大响应时间 参考 GSM 07.07 OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 在发起呼叫建立后，用以表示是否显示+CSSI: [,]结果码状态的数字参数 0 禁用 1 启用 当接收到呼叫转移补充业务通知，一个终端呼叫建立或者在呼叫进行中的时候，用以表示是 否显示+CSSU: 结果码状态的数字参数 0 禁用 1 启用 0 激活无条件呼叫转移 上海移远通信技术股份有限公司 161 / 216 1 激活有条件呼叫转移 2 呼叫已经被转移 3 呼叫等待中 4 是 CUG 呼叫（也会出现） 5 禁止出局呼叫 6 禁止入局呼叫 7 CLIR 抑制关闭 关闭的用户组索引号 0 指示这是一个呼叫转移的呼叫 M56 AT 命令手册 上海移远通信技术股份有限公司 162 / 216 11 音频控制命令 11.1. ATL 设置监听扬声器音量 语法 ATL 设置监听扬声器音量 执行命令 ATL 最大响应时间 参考 V.25ter 参数 0 低扬声器音量 1 中低扬声器音量 2 中扬声器音量 3 高扬声器音量 备注 GSM 网络中无效。 响应 OK 300ms M56 AT 命令手册 上海移远通信技术股份有限公司 163 / 216 11.2. ATM 设置监听扬声器模式 语法 ATM 设置监听扬声器模式 执行命令 ATM 最大响应时间 参考 V.25ter 响应 OK 300ms 参数 0 扬声器关闭 1 扬声器被打开，当有载波被检测到 2 扬声器打开 备注 ATL 以及 ATM 命令仅在 V.25ter 生效，对 GSM 网络无效。 11.3. AT+CALM 来电警报模式 语法 AT+CALM 来电警报模式 测试命令 AT+CALM=? 查询命令 AT+CALM? 配置命令 AT+CALM= 响应 +CALM: (取值列表) OK 响应 +CALM: OK 响应 OK 上海移远通信技术股份有限公司 M56 AT 命令手册 164 / 216 最大响应时间 参考 GSM 07.07 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 1 正常模式 静音模式（禁止播放来自 ME 的所有声音） 备注 该配置命令仅适用于来电铃音控制。 M56 AT 命令手册 11.4. AT+CRSL 来电音量等级 语法 AT+CRSL 来电音量等级 测试命令 AT+CRSL=? 查询命令 AT+CRSL? 配置命令 AT+CRSL= 最大响应时间 参考 GSM 07.07 响应 +CRSL: (取值列表) OK 响应 +CRSL: OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 165 / 216 参数 整数型，制造商自定义范围：0-100。最小值为最低音量等级。 M56 AT 命令手册 11.5. AT+CLVL 扬声器音量等级 语法 AT+CLVL 扬声器音量等级 测试命令 AT+CLVL=? 查询命令 AT+CLVL? 配置命令 AT+CLVL= 最大响应时间 参考 GSM 07.07 响应 +CLVL: (取值列表) OK 响应 +CLVL: OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 整数型；制造商自定义范围：0-100。最小值为最低音量等级。 上海移远通信技术股份有限公司 166 / 216 11.6. AT+CMUT 上行静音控制 语法 AT+CMUT 上行静音控制 测试命令 AT+CMUT=? 查询命令 AT+CMUT? 配置命令 AT+CMUT= 最大响应时间 参考 GSM 07.07 响应 +CMUT: (取值列表) OK 响应 +CMUT: OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 关闭静音 1 打开静音（MIC 被静音） 备注 仅在呼叫过程中，该命令操作有效。 M56 AT 命令手册 上海移远通信技术股份有限公司 167 / 216 M56 AT 命令手册 11.7. AT+QMIC 配置麦克风增益等级 语法 AT+QMIC 配置麦克风增益等级 测试命令 AT+QMIC=? 查询命令 AT+QMIC? 配置命令 AT+QMIC=, 最大响应时间 参考 Quectel 响应 +QMIC: (取值列表),(取值列表) OK 响应 +QMIC: ,, OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 2 主免提通道 侧音增益等级范围：0-15 11.8. AT+QAUDCH 切换音频通道 语法 AT+QAUDCH 切换音频通道 测试命令 AT+QAUDCH=? 响应 +QAUDCH: (取值列表) OK 上海移远通信技术股份有限公司 168 / 216 查询命令 AT+QAUDCH? 配置命令 AT+QAUDCH=[] 最大响应时间 参考 Quectel 响应 +QAUDCH: OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 2 主免提通道（默认） M56 AT 命令手册 11.9. AT+QAUDLOOP 音频通道回环测试 语法 AT+QAUDLOOP 音频通道回环测试 测试命令 响应 AT+QAUDLOOP=? +QAUDLOOP: (取值列表),(取值列表) 配置命令 AT+QAUDLOOP=[,] 最大响应时间 参考 Quectel OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 169 / 216 参数 0 停止测试 1 开始测试 2 主免提通道 M56 AT 命令手册 11.10. AT+QLTONE 产生本地定制单音 语法 AT+QLTONE 产生本地定制单音 测试命令 AT+QLTONE=? 响应 +QLTONE: (取值列表),(取值列表),(取值列表),(取值列表),(取 值列表) 配置命令 AT+QLTONE=,,< periodOn>,, 最大响应时间 OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 取决于要播放的定制单音长度 参考 Quectel 参数 0 停止播放 1 开始播放 播放单音频率 一个周期内播放单音的时长 一个周期内静音的时长 单音播放总时长，单位为毫秒 备注 当开始播放指定频率单音时，模块会持续播放该单音时长，然后再停止播放单音 时长，依次循环。直至总时长结束。 上海移远通信技术股份有限公司 170 / 216 M56 AT 命令手册 12 硬件相关命令 12.1. AT+CCLK 实时时钟 语法 AT+CCLK 实时时钟 测试命令 AT+CCLK=? 查询命令 AT+CCLK? 配置命令 AT+CCLK= 最大响应时间 参考 GSM 07.07 响应 OK 响应 +CCLK: OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年，月，日，小时，分钟，秒和时 区（用当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围-47 ~ +48） 举例 AT+CCLK? //查询当前 ME 时间 +CCLK: '08/01/04, 00:19:43+00' 上海移远通信技术股份有限公司 171 / 216 M56 AT 命令手册 OK 12.2. AT+CBC 查询电池电量和充电状态 语法 AT+CBC 查询电池电量和充电状态 测试命令 AT+CBC=? 响应 +CBC: (取值列表),(取值列表),(voltage) 执行命令 AT+CBC 最大响应时间 参考 GSM 07.07 OK 响应 +CBC: ,, OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 充电状态 0 不在充电 电池电量级别 0...100 电池相对于其原始电量的百分比 电池电压（单位：mV） 备注 由于 M56 不支持充电功能，和不适用；仍然有效反映 VBAT 的电压值。 上海移远通信技术股份有限公司 172 / 216 M56 AT 命令手册 12.3. AT+QADC 读取 ADC 语法 AT+QADC 读取 ADC 测试命令 AT+QADC=? 查询命令 AT+QADC? 最大响应时间 参考 GSM 07.07 参数 状态 0 失败 1 成功 0-2800 电压 响应 +QADC: (取值列表),(取值列表) OK 响应 +QADC: , OK 300ms 12.4. AT+QSCLK 慢时钟配置 语法 AT+QSCLK 慢时钟配置 测试命令 AT+QSCLK=? 查询命令 AT+QSCLK? 响应 +QSCLK: (取值列表) OK 响应 +QSCLK: OK 上海移远通信技术股份有限公司 173 / 216 M56 AT 命令手册 配置命令 AT+QSCLK= 最大响应时间 参考 Quectel 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 禁用慢时钟 1 启用慢时钟，拉高 DTR 生效，拉低 DTR 唤醒 2 启用慢时钟，5 秒内串口无数据交互即进入睡眠模式；有数据时唤醒 备注 模式 2 下，第一次串口数据会被丢弃，仅仅起唤醒作用。建议此模式下先发一个 AT 来唤醒模块再继续其 他业务。 12.5. AT+QLEDMODE 网络指示灯配置 语法 AT+QLEDMODE 网络指示灯配置 测试命令 AT+QLEDMODE=? 响应 +QLEDMODE: (取值列表) 查询命令 AT+QLEDMODE? OK 响应 +QLEDMODE: 配置命令 AT+QLEDMODE= OK 响应 OK 若出错，返回： ERROR 上海移远通信技术股份有限公司 174 / 216 M56 AT 命令手册 最大响应时间 参考 Quectel 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 0 1 2 来电振铃时网络指示灯快速闪烁 来电振铃对网络指示灯无影响 来电振铃对网络指示灯无影响，但此时有 URC 上报，串口 RI 引脚不会变化，直到振铃 结束 12.6. AT+QVBATT 配置电压阀值 语法 AT+QVBATT 配置电压阀值 测试命令 AT+QVBATT=? 查询命令 AT+QVBATT? 响应 +QVBATT: 0,(3451-3600),(0,1) +QVBATT: 1,(3100-3450),(0,1) +QVBATT: 2,(4300-4550),(0,1) +QVBATT: 3,(4551-4730),(0,1) OK 响应 +QVBATT: 0,, +QVBATT: 1,, +QVBATT: 2,, +QVBATT: 3,, 配置命令 AT+QVBATT=[,[,]] OK 响应 如果个数正确，返回 OK 如果 省略，并且 是合法的, 这个命令可以用来查询对应的设置电压值和状态, 返回 +QVBATT: ,, 上海移远通信技术股份有限公司 175 / 216 M56 AT 命令手册 最大响应时间 参考 Quectel Quectel OK 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 参数 配置电压阈值的类型. 0 低电压报警的阈值 1 低电压关机的阀值 2 高电压报警的阀值 3 高电压关机的阀值 电压阀值. 单位: mV 对应的功能，是处于打开还是关闭状态。 低电压报警和低电压关机功能，默认是打开的。 高电压报警和高电压关机功能，默认是关闭的。 0 功能关闭。 1 功能打开 备注 1. 当供电电压到达对应的阀值时，会上报下面的 URC： UNDER_VOLTAGE WARNING UNDER_VOLTAGE POWER DOWN OVER_VOLTAGE WARNING OVER_VOLTAGE POWER DOWN 2. 这个命令设置的参数，可以通过 AT&W 保存。 举例 AT+QVBATT=? +QVBATT: 0,(3451-3600),(0,1) +QVBATT: 1,(3100-3450),(0,1) +QVBATT: 2,(4300-4550),(0,1) +QVBATT: 3,(4551-4730),(0,1) OK AT+QVBATT? +QVBATT: 0,3500,1 +QVBATT: 1,3100,1 //测试命令，查询阀值设置范围。 //查询命令。 上海移远通信技术股份有限公司 176 / 216 +QVBATT: 2,4500,0 +QVBATT: 3,4600,0 OK AT+QVBATT=0,3490 OK AT+QVBATT=0 +QVBATT: 0,3490,1 OK AT+QVBATT=1,3300,0 OK AT+QVBATT=1 +QVBATT: 1,3300,0 OK M56 AT 命令手册 //设置低电压报警的电压值为 3490mV。 //查询低电压报警的阀值电压和开启状态。 //0 是低电压报警功能类型，3490 是低电压报警的阀值电压， 1 是低电压报警功能是处于打开状态。 //低电压关机功能关闭。 //查询低电压关机功能的阀值电压和状态。 //1 是低电压关机功能，3300 是低电压关机的阀值电压，0 是低电压关闭功能处于关闭状态。 12.7. AT+QRIMODE 设置 RI 时长 语法 AT+QRIMODE 设置 RI 时长 查询命令 AT+QRIMODE=? 查询命令 AT+QRIMODE? 配置命令 AT+QRIMODE= 最大响应时间 响应 +QRIMODE: (取值列表) OK 响应 +QRIMODE: OK 响应 OK 若出错，返回： ERROR 若错误与 ME 功能相关，则返回： +CME ERROR: 300ms 上海移远通信技术股份有限公司 177 / 216 M56 AT 命令手册 参考 Quectel 参数 0 收到短消息时 RI 拉低 120ms，收到其他 URC 提示时 RI 拉低 120ms 1 收到短消息时 RI 拉低 120ms，收到其他 URC 提示时 RI 拉低 50ms 2 收到短消息时 RI 拉低 120ms，其他 URC 对 RI 引脚无影响 3 收到短消息时 RI 拉低 120ms，非透传模式下 TCP 来数据+QIRDI: 上报 URC 时将 RI 引脚拉低 120ms；收到其他 URC 提示时 RI 拉低 120ms 上海移远通信技术股份有限公司 178 / 216 M56 AT 命令手册 13 摄像机功能相关命令 13.1. AT+QCAMOPEN 打开摄像功能 语法 AT+QCAMOPEN 打开摄像功能 测试命令 AT+QCAMOPEN=? 响应 +QCAMOPEN: , 配置命令 AT+QCAMOPEN=, 最大响应时间 参考 Quectel OK 响应 OK 若错误与 ME 功能相关，则返回： +CME ERROR: 1000ms 参数 图像高，单位像素，取值范围 50~480 图像宽，单位像素，取值范围 50~640 备注 没有识别到摄像头时，返回错误码：7300。 上海移远通信技术股份有限公司 179 / 216 13.2. AT+QCAMIDFY 开始/停止解码 语法 AT+QCAMIDFY 开始/停止解码 测试命令 AT+QCAMIDFY=? 执行命令 AT+QCAMIDFY= 最大响应时间 参考 Quectel 响应 +QCAMIDFY: (取值列表) OK 响应 OK 300ms 参数 0 停止解码 1 开始解码 13.2.1. 解码结果的 URC 语法 解码结果的 URC +QCAMPRES: ,,, 上报解码结果 参数 解码结果 0 成功 1 无解码库 其他 失败 解析的一维码或者二维码类型 解码结果数据的长度。单位：字节 解码数据，输出结果与解码库有关 上海移远通信技术股份有限公司 M56 AT 命令手册 180 / 216 举例 AT+QCAMOPEN=480,640 OK AT+QCAMIDFY=1 OK +QCAMPRES: 0,18,9,135683066 13.3. AT+QCAMCLOSE 关闭摄像功能 语法 AT+QCAMCLOSE 关闭摄像功能 测试命令 AT+QCAMCLOSE=? 执行命令 AT+QCAMCLOSE 最大响应时间 参考 Quectel 响应 OK 响应 OK 1000ms 举例 AT+QCAMOPEN=240,320 OK AT+QCAMIDFY=1 OK +QCAMPRES: 0,18,9,135683066 AT+QCAMIDFY=0 OK AT+QCAMCLOSE OK 上海移远通信技术股份有限公司 M56 AT 命令手册 181 / 216 M56 AT 命令手册 13.4. AT+QCAMSEL 清除已识别的摄像头类型信息 第一次打开摄像功能，会自动识别摄像头的类型，并保存到 NVRAM 中，如果在已经识别到摄像头的 设备上，更换另一款摄像头，需要清除 NVRAM 中，已经保存的类型信息。 语法 AT+QCAMSEL 清除已识别的摄像头类型信息 测试命令 响应 AT+QCAMSEL=? OK 执行命令 响应 AT+QCAMSEL OK 最大响应时间 300ms 参考 Quectel 备注 该命令生效，需要重启模块。 13.5. AT+QCAMAPPVER 读取解码库版本信息 在解码库的应用程序中，添加对应解码库的版本信息，MCU 通过 AT 命令来读取对应解码库的版本信 息。 语法 AT+QCAMAPPVER 读取解码库版本信息 测试命令 响应 AT+QCAMAPPVER=? OK 执行命令 响应 AT+QCAMAPPVER +QCAMAPPVER: 最大响应时间 参考 Quectel OK 300ms 上海移远通信技术股份有限公司 182 / 216 参数 解码库的版本信息 M56 AT 命令手册 备注 该命令必须配合包含版本信息的解码库使用，如果烧录没有设置解码库版本信息的版本，执行该命令， 会造成异常的情况，不烧录解码库的话，返回为空。 举例 AT+QCAMAPPVER +QCAMAPPVER: '1.0.10000-2018.03.14-MTK Copyright (C) 2018, Quectel All Rights Reserved.' OK 13.6. AT+QUID 获取模块的芯片唯一识别码（ID 号） 语法 AT+QUID 获取模块芯片唯一识别码（ID 号） 测试命令 AT+QUID=? 读命令 AT+QUID? 响应 OK 响应 +QUID: 最大响应时间 参考 Quectel OK 300ms 参数 模块芯片唯一 ID 号，格式为，长度固定 32 个字节的十六进制字符串。 上海移远通信技术股份有限公司 183 / 216 举例 AT+QUID? +QUID: d5980c2b4137d186186117d457dcd93b OK M56 AT 命令手册 上海移远通信技术股份有限公司 184 / 216 M56 AT 命令手册 14 其他命令 14.1. A/ 重复上一条 AT 指令 语法 A/ 重复上一条 AT 指令 执行命令 A/ 最大响应时间 参考 V.25ter 响应 上一条 AT 指令执行的返回 取决于上一个 AT 命令 举例 AT OK A/ OK //重复上一次执行的 AT 操作 14.2. ATE 命令回显模式 使用该命令，可设置 TA 在命令状态下是否回显从 TE 接收到的字符。 语法 ATE 命令回显模式 执行命令 ATE[] 最大响应时间 参考 V.25ter 响应 OK 300ms 上海移远通信技术股份有限公司 185 / 216 参数 0 关闭回显 1 启用回显 14.3. ATS3 配置命令行终止符 使用该命令，可设置用于 AT 命令行终止符，该字符能被 TA 识别。 语法 ATS3 配置命令行终止符 查询命令 响应 ATS3? 配置命令 ATS3= 最大响应时间 参考 V.25ter OK 响应 OK 300ms 参数 0-13-127 命令行终止符（默认为 13=） M56 AT 命令手册 14.4. ATS4 设置响应格式字符 使用该命令，可设置用于获取结果码和信息文本的字符，该字符是由 TA 产生的。 语法 ATS4 设置响应格式字符 查询命令 响应 ATS4? OK 上海移远通信技术股份有限公司 186 / 216 配置命令 ATS4= 最大响应时间 参考 V.25ter 响应 OK 300ms 参数 0-10-127 响应格式字符（默认为 10=） 14.5. ATS5 配置命令行编辑字符 使用该命令，可设置用于删除命令行中的字符，该字符由 TA 产生。 语法 ATS5 设置响应格式字符 查询命令 响应 ATS5? 配置命令 ATS5= 最大响应时间 参考 V.25ter OK 响应 OK 300ms 参数 0-8-127 命令行编辑字符（默认为 8=） M56 AT 命令手册 上海移远通信技术股份有限公司 187 / 216 M56 AT 命令手册 15 附录 15.1. 参考文档 表 1：参考文档 序号 [1] [2] [3] [4] [5] 文档名 Quectel_GSM 模块 AT 命令应用指导 Quectel_GSM_TCP/IP_Application_Notes Quectel_GPRS_Startup_User_Guide Quectel_GSM_MUX_Application_Notes Quectel_M56_硬件设计手册 备注 GSM 模块 AT 命令应用指导 TCP/IP 应用指导 GPRS 配置应用指导 MUX 应用指导 M56 硬件设计手册 15.2. 术语缩写 表 2：术语缩写 缩写 ADC AMR ARP CLI CSD 描述 Analog-to-Digital Converter Adaptive Multi-Rate Antenna Reference Point Command-line Interface Circuit Switch Data 上海移远通信技术股份有限公司 188 / 216 CTS CUG DCD DCE DTE DTR GPRS IDSN ISDN ME MS OA PDP PSC RTS (U)SIM TA TCP TE UDP URC Clear To Send Closed User Group Dynamic Content Delivery Data Communication Equipment Data Terminal Equipment Data Terminal Ready General Packet Radio Service International Dalit Solidarity Network Integrated Services Digital Network Mobile Equipment Mobile Station Ongoing Access Packet Data Protocol Primary Synchronization Code Request To Send (Universal) Subscriber Identity Module Terminal Adapter Transmission Control Protocol Terminal Equipment User Datagram Protocol Unsolicited Result Code M56 AT 命令手册 上海移远通信技术股份有限公司 189 / 216 15.3. AT&F 影响到的 AT 命令及参数 表 3：AT&F 影响到的 AT 命令及参数 AT 命令 ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT&C AT&D AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR 参数名称 ,, 上海移远通信技术股份有限公司 默认值 1 0 0 13 10 8 2 60 2 15 1 4 1 0 0 0,0,0 0 'GSM' 129 0 0 M56 AT 命令手册 190 / 216 M56 AT 命令手册 AT+CMEE AT+COLP AT+QDISH AT+CRSL AT+CLVL AT+CUSD AT+CSSN AT+CSNS AT+QMIC AT+QSCLK AT+QCLIP AT+QCOLP AT+QIURC AT+QEXTUNSOL AT+QRIMODE 1 0 0 60 AT+QAUDCH=2 时，默认值为：35 0 , 0,0 0 ,, 4,9,12 0 0 0 1 0 0 15.4. AT&W 影响到 AT 命令参数列表 表 4：AT&W 影响到的 AT 命令参数列表 AT 指令 ATE ATQ ATS0 ATS3 参数名称 上海移远通信技术股份有限公司 是否通过 AT&V 显示 是 是 是 是 191 / 216 ATS4 是 ATS5 是 ATS6 是 ATS7 是 ATS8 是 ATS10 是 ATV 是 ATX 是 AT&C 是 AT&D 是 AT+ICF , 是 AT+IFC , 是 AT+IPR 是 AT+CREG 是 AT+CCUG ,, 是 AT+CCWA 是 AT+CSCS 是 AT+CLIP 是 AT+CMEE 是 AT+COLP 是 AT+CR 是 AT+QDISH 否 AT+CRSL 否 AT+CLVL 否 AT+CUSD 是 上海移远通信技术股份有限公司 M56 AT 命令手册 192 / 216 AT+CSNS AT+QSIDET AT+QMIC AT+QSCLK AT+QCLIP AT+QCOLP AT+QIURC AT+QEXTUNSOL AT+QRIMODE AT+QSIMDET AT+QSIMSTAT 是 是 ,, 否 是 是 否 否 否 ,, 是 是 M56 AT 命令手册 15.5. ATZ 影响到的 AT 命令参数列表 表 5：ATZ 影响到的 AT 命令参数列表 AT 指令 ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 参数名称 上海移远通信技术股份有限公司 默认值 1 0 0 13 10 8 2 60 193 / 216 ATS8 ATS10 ATV ATX AT&C AT&D AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR AT+CMEE AT+COLP AT+CR AT+QDISH AT+CRSL AT+CLVL AT+CUSD AT+CSSN AT+CSNS AT+QMIC AT+QSCLK M56 AT 命令手册 2 15 1 4 1 0 0 ,, 0,0,0 0 'GSM' 129 0 0 1 0 0 0 60 当 AT+QAUDCH=2 时，默认值为： 35 0 , 0,0 0 ,, 4,9,8 0 上海移远通信技术股份有限公司 194 / 216 AT+QCLIP AT+QCOLP AT+QIURC AT+QEXTUNSOL AT+QRIMODE AT+QSIMDET AT+QSIMSTAT ,, 0 0 1 0 0 0,0,0 0 15.6. AT&V 显示当前配置信息 表 6：AT&V 显示当前配置信息 AT&V 或 AT&V0 AT&V ACTIVE PROFILE E: 1 Q: 0 V: 1 X: 4 S0: 0 S2: 43 S3: 13 S4: 10 S5: 8 S6: 2 S7: 60 S8: 2 S10: 15 +CR: 0 +FCLASS: 0 +CMGF: 0 +CSDH: 0 +CMEE: 1 +CBST: 7,0,1 +IFC: 0,0 上海移远通信技术股份有限公司 M56 AT 命令手册 195 / 216 +ICF: 3,3 +CNMI: 2,1,0,0,0 +CSCS: 'GSM' +IPR: 0 &C: 1 &D: 0 +CSTA: 129 +CRLP: 61,61,128,6,0,3 +CCWE: 0 +QSIMSTAT: 0 +CCUG: 0,0,0 +CLIP: 0 +COLP: 0 +CCWA: 0 +CAOC: 1 +CLIR: 0 +CUSD: 0 +CREG: 0 +QSIMDET: 0,0,0 +QMIC: 4,9,8 +QCLIP: 0 +QCOLP: 0 +CSNS: 0 OK 15.7. AT&V 内容格式对照表 表 7：ATV 内容格式对照表 ATV1 OK CONNECT RING NO CARRIER ERROR ATV0 0 1 2 3 4 M56 AT 命令手册 描述 执行命令的正确确认 连接已经建立，DCE 从命令状态切换为数据状态 DCE 已经检测到一个来自网络的呼叫 连接中断或尝试建立连接失败 命令不能被识别，超出命令行的最大长度，参数值无效 或命令进程中的其他问题 上海移远通信技术股份有限公司 196 / 216 NO DIALTONE BUSY NO ANSWER PROCEEDING CONNECT M56 AT 命令手册 6 7 8 9 制造商特殊需求 无法检测到拨号音 检测到忙音信号（占线） 若'@'拨号修改量被使用，则紧跟 5 秒静默时间的远程 振铃没有在定时器（S7）超时前检测到，即无应答。 一条 AT 命令正在被处理 与 CONNECT 相同，但包含制造商特殊需求定义的文 本，该文本可以是指定的 DTE 速率，行速度，错误控 制，数据压缩或其他状态 15.8. URCs 说明列表 表 8：URCs 说明列表 序号 1 2 3 4 5 6 7 8 9 URC 显示 含义 +CGEV: NW DEACT ,[,] +CGEV: ME DEACT ,[,] +CGEV: NW DETACH 网络去 GPRS 附着 +CGEV: ME DETACH ME 去 GPRS 附着 +CGREG: 1 网络去注册 +CGREG: 0 网络未注册 +CGREG: 1,, 网络注册及本地小区信息 +CGREG: 0,, 网络未注册及本地小区信息 +CSQN: , 信号质量改变 10 禁止可用网络 11 +QGURC: 通话状态相关结果码 12 +CBCN: , 显示电池充电状态及电量等级 上海移远通信技术股份有限公司 条件 AT+CGEREP=1 AT+CGEREP=1 AT+CGEREP=1 AT+CGEREP=1 AT+CGREG=1 AT+CGREG=1 AT+CGREG=2 AT+CGREG=2 AT+QEXTUNSOL ='SQ',1 AT+QEXTUNSOL ='FN',1 AT+QEXTUNSOL ='UR',1 AT+QEXTUNSOL ='BC',1 197 / 216 M56 AT 命令手册 13 +QBAND: 显示频率模式 AT+QEXTUNSOL ='BM',1 +CCINFO: , 的呼叫序号且保留剩余的通话数目 ='CC',1 15 RING 来电指示 N/A 16 Call Ready 设置准备好建立或接受呼叫 N/A 17 UNDER_VOLTAGE POWER D 低电压关机指示 N/A OWN 18 UNDER_VOLTAGE WARNING 低电压报警 N/A 19 OVER_VOLTAGE POWER DO 高电压关机指示 N/A WN 20 OVER_VOLTAGE WARNING 高电压报警 N/A 21 UNDER_VOLTAGE POWER D 正常关机 N/A OWN +COLP: , 当 TE 作为呼叫发起方，显示被叫识 22 [,,[,]] 别相关信息 AT+COLP=1 +CLIP: 23 ,,'[]',[ 显示主叫识别相关信息 ], AT+CLIP=1 '[]', 24 +CRING: 来电指示 AT+CRC=1 25 +CREG: ME GSM 网络注册状态指示 AT+CREG=1 ME GSM 网络注册状态及小区信息 26 +CREG: [,,] 指示，当网络注册状态及小区信息更 AT+CREG=2 改时上报 27 +CCWA: ,,[,] AT+CCWA=1,1 28 RDY ME 初始化完毕 N/A 29 +CFUN: 1 ME 全功能模式 N/A 30 +CPIN: SIM 卡 PIN 状态 N/A 31 MO RING 去电呼叫振铃 AT+QMOSTAT=1 32 MO CONNECTED 去电呼叫建立成功 33 +QCAMPRES: ,,< Camera 解码结果 length>, AT+QMOSTAT=1 AT+QCAMIDFY= 1 上海移远通信技术股份有限公司 198 / 216 M56 AT 命令手册 15.9. +CME ERROR 错误报告列表 非请求结果码+CME ERROR: 表示移动设备或网络报错，类似于 ERROR 错误结果码。一旦命 令被执行，不管正确与否，都要返回 OK 或者 ERROR 结果。 表 9：+CME ERROR 错误代码列表 错误码 0 1 2 3 4 5 6 7 8 10 11 12 13 14 15 16 17 18 20 错误描述 Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required PH_SIM_PUK_REQUIRED SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy SIM wrong Incorrect password SIM PIN2 required SIM PUK2 required Memory full 上海移远通信技术股份有限公司 199 / 216 M56 AT 命令手册 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 48 Long dial-number storage is full 100 Unknow 103 Illegal MS 106 Illegal ME 107 GPRS services not allowed 111 PLMN not allowed 112 Location area not allowed 上海移远通信技术股份有限公司 200 / 216 113 132 133 134 148 149 150 151 152 153 154 302 600 601 602 603 604 605 606 607 608 609 610 3513 3515 M56 AT 命令手册 Roaming not allowed in this location area Service option not supported Requested service option not subscribed Service option temporarily out of order Unspecified GPRS error PDP authentication failure Invalid mobile class Link NS SP person PIN required Link NS SP person PUK required Link SIM C person PIN required Link SIM C person PUK required Command conflict No Error Unrecognized command Return error Syntax error Unspecified Data transfer already Action already Not AT command Multi command too long Abort COPS No call disconnect Unread records on SIM PS busy 上海移远通信技术股份有限公司 201 / 216 3517 3518 3738 3742 3765 3769 3771 3772 3773 3774 3775 3779 3780 3790 3791 7300 SM not ready Invalid parameter CSCS mode not found CPOL operation format wrong Invalid input value Unable to get control Call setup in progress SIM powered down Invalid CFUN state Invalid ARFCN The pin is not in GPIO mode No enough length for sc Incorrect data length Empty destination address Call is in progress Camera open fail M56 AT 命令手册 15.10. 错误扩展列表 15.10.1. Location ID 扩展错误报告列表 表 10：Location ID 扩展错误报告列表 ID 描述 0 No error (default) 1 Cause for protocol stack (PS) layer 2 Internal cause for Mobility Management (MM) layer 上海移远通信技术股份有限公司 202 / 216 M56 AT 命令手册 3 Cause for PPP/IP-Stack 15.10.2. 协议栈层（PS）错误列表 表 11：协议栈层（PS）错误列表 原因 CM Cause 0 1 3 6 8 10 11 16 17 18 19 21 22 25 26 27 28 29 30 描述 Radio link fail Unassigned number No route to destination Channel unacceptable Operator determined barring Call barred Reserved Normal call clearing User busy No user responding User alerting, no answer Call rejected Number changed Pre-emption Non-selected user clearing Destination out of order Invalid number format (incomplete number) Facility rejected Response to STATUS ENQUIRY 上海移远通信技术股份有限公司 203 / 216 M56 AT 命令手册 31 Normal, unspecified 34 No circuit/channel available 38 Network out of order 41 Temporary failure 42 Switching equipment congestion 43 Access information discarded 44 Requested circuit/channel not available 47 Resource unavailable, unspecified 49 Quality of service unavailable 50 Requested facility not subscribed 55 Incoming calls barred within the CUG 57 Bearer capability not authorized 58 Bearer capability not presently available 63 Service or option not available, unspecified 65 Bearer service not implemented 68 ACM equal or greater than ACM maximum 69 Requested facility not implemented 70 Only restricted digital information bearer capability is available 79 Service or option not implemented, unspecified 81 Invalid transaction identifier value 87 User not member of CUG 88 Incompatible destination 91 Invalid transit network selection 95 Semantically incorrect message 96 Invalid mandatory information 上海移远通信技术股份有限公司 204 / 216 M56 AT 命令手册 97 Message type non-existent or not implemented 98 Message type not compatible with protocol state 99 Information element non-existent or not implemented 100 Conditional information element error 101 Message not compatible with protocol 102 Recovery on timer expiry 111 Protocol error, unspecified 127 Interworking, unspecified 128 Telematic interworking not supported 129 Short message Type 0 not supported 130 Cannot replace short message 143 Unspecified TP-PID error 144 Data coding scheme (alphabet) not supported 145 Message class not supported 159 Unspecified TP-DCS error 160 Command cannot be acted 161 Command unsupported 175 Unspecified TP-Command error 176 TPDU not supported 192 SC busy 193 No SC subscription 194 SC system failure 195 Invalid SME address 196 Destination SME barred 197 SM Rejected-Duplicate SM 上海移远通信技术股份有限公司 205 / 216 M56 AT 命令手册 198 TP-VPF not supported 199 TP-VP not supported 210 Error in MS 211 Memory Capacity Exceeded 212 (U)SIM Application Toolkit Busy 213 (U)SIM data download error 224 CP retry exceed 225 RP trim timeout 255 Unspecified error cause 304 Invalid PDU mode parameter 305 Invalid TEXT mode parameter 313 (U)SIM failure 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 340 No+CNMA acknowledgement expected 500 Unknown error 513 Message length exceeds maximum length 514 Invalid request parameters 515 ME storage failure 516 Invalid bearer service 517 Invalid service mode 518 Invalid storage type 519 Invalid message format 上海移远通信技术股份有限公司 206 / 216 520 521 522 523 524 525 526 527 528 530 531 532 CC Cause 768 769 770 771 772 773 774 775 776 777 778 896 M56 AT 命令手册 Too many MO concatenated messages SMSAL not ready SMSAL no more service Not support TP-Status-Report&TP-Command in storage Reserved MTI No free entity in RL layer The port number is already registered There is no free entity for port number More message to send state error GPRS is suspended ME storage full (U)SIM is refreshing Command not allowed Illegal card ID Call allocation fail BC fill fail Call REEST Illegal DTMF tone Illegal BC Modify actual mode Data action fail No response from network Call accept not allowed General cause 上海移远通信技术股份有限公司 207 / 216 897 898 SS Cause 1024 1025 1033 1034 1035 1036 1037 1040 1041 1042 1043 1044 1045 1051 1053 1054 1058 1059 1060 1061 1062 1067 M56 AT 命令手册 CSD call is aborted by user during call establishment or MT call abort MO call/USSD CSD call is disconnected due to lower layer failure Cause none Unknown subscriber Illegal subscriber Bearer service not provisioned Tele service not provisioned Illegal equipment Call barred Illegal SS operation SS error status SS not available SS subscription violation SS incompatibility Facility not supported Absent subscriber Short term denial Long term denial System failure Data missing Unexpected data value PW registration failure Negative PW check Number of PW attempts violation 上海移远通信技术股份有限公司 208 / 216 1078 1095 1096 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 M56 AT 命令手册 Position method failure Unknown alphabet USSD busy Rejected by user Rejected by network Deflection to served subscriber Special service code Invalid deflection to number Max number of MPTY participants exceeded Resources not available General problem, unrecognized component General problem, mistyped component General problem, badly structured component Invoke problem, duplicate invoked Invoke problem, unrecognized operation Invoke problem, mistyped parameter Invoke problem, resource limitation Invoke problem, initiating release Invoke problem, unrecognized linked ID Invoke problem, linked resource unexpected Invoke problem, unexpected linked operation Return result problem, RR unrecognized invoked Return result problem, RR, return result unexpected Return result problem, RR mistyped parameter Return error problem, RE, unrecognized invoked 上海移远通信技术股份有限公司 209 / 216 1167 1168 1169 1170 MM Cause 2048 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2068 2069 2070 M56 AT 命令手册 Return error problem, RE return error unexpected Return error problem, RE unrecognized error Return error problem, RE unexpected error Return error problem, RE mistyped parameter Cause none IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME GPRS not allowed None GPRS not allowed MS ID not derived by network Implicit detach PLMN not allowed Location area not allowed Roaming area not allowed GPRS not allowed in PLMN No suitable cells in LA MSC temp not reachable Network failure MAC failure Sync failure Congestion 上海移远通信技术股份有限公司 210 / 216 2080 2081 2082 2086 2088 2096 2111 2143 2144 2145 2146 2147 2148 2149 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 M56 AT 命令手册 Serve option not supported Request serve option not subscribed Serve option temp out of order Call cannot be identified No PDP context activated Retry upon entry into a new cell Retry upon entry into a new cell Semantically incorrect message Invalid MM info Message type non existent Message type incompatible with protocol state IE not implemented Conditional MM IE error Message not compatible with protocol state Protocol error unspecified Access barred Assignment reject Random access failure RR no service PLMN search reject emergency RR connection release Authentication failure IMSI detach Abort by network Connection timeout 上海移远通信技术股份有限公司 211 / 216 2170 2171 2172 2173 2174 2175 SIM Cause 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 SM Cause 3080 3097 3098 3099 Enqueue fail Not updated State not allowed Emergency not allowed No service Access class barred Command success Command fail Fatal error No inserted CHV not init CHV verify error CHV block Access not allow SAT command busy DL error Memory problem Technical problem PUK unlock Operator determined barring LLC SND failure Insufficient resource Unknown APN 上海移远通信技术股份有限公司 M56 AT 命令手册 212 / 216 3100 3101 3102 3103 3104 3105 3106 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3153 3167 3168 3169 3170 3171 3172 M56 AT 命令手册 Unknown PDP address or type Authentication failure Activation reject GGSN Activation reject Unsupported service option Unsubscribed service option Out of order service option Regular deactivation QOS not accepted Network fail Reactivation required Unsupported network context activation Semantic error in TFT operation Syntactical error in TFT operation Unknown PDP context Semantic error in packet filter Syntax error in packet filter PDP context WO TFT already act Invalid TI Incorrect message Invalid MAND info Unimplemented message type Incompatible message type protocol state Unimplemented IE Conditional IE error 上海移远通信技术股份有限公司 213 / 216 3173 3183 3184 ABM Cause 3273 3274 3275 3276 3277 3278 3279 3280 3283 3284 3285 3286 TCM Cause 3372 3373 3374 3375 3376 3377 3378 3379 Incompatible message protocol state Unspecified Startup failure Success Invalid network account ID GPRS reactivate GPRS protocol rejection CSD reactivate CSD PPP negotiated failed CSD action failed CSD call setup failed Rejected Slot limited Abort None auto deactivation Invalid parameter NSAPI not in use ACL action not allowed ACL SIM file full ACL add entry failed ACL del entry failed ACL set entry failed ACL (U)SIM read failed M56 AT 命令手册 上海移远通信技术股份有限公司 214 / 216 3380 ACL (U)SIM write failed 15.10.3. MM 层内部错误列表 表 12：MM 层内部错误列表 原因 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 描述 Forbidden PLMN Access class barred No coverage GPRS service not allowed Timer expiry (U)SIM inserted (U)SIM removed (U)SIM absent (U)SIM invalid for PS (U)SIM invalid for CS (U)SIM invalid for PS and CS Low layer fail Connection in progress Not updated Connection establish failure Connection abort Connection failure Emergency not allowed No GPRS coverage Abnormal LU 上海移远通信技术股份有限公司 M56 AT 命令手册 215 / 216 M56 AT 命令手册 132 Abnormal LU less then 4 times 133 Same LAI IMSI attaching 15.10.4. PPP/IP 栈错误列表 表 13：PPP/IP 栈错误列表 原因 0 1 2 3 4 5 6 7 8 9 10 11 12 13 描述 No error LCP fail Authentication fail IPCP fail ESC detect Plug out detect PPP GPRS dialup already activated PPP not activated by external modem yet PPP already activated by external modem PPP not activated by WAP over CSD yet PPP already activated by WAP over CSD PPP wrong CSD mode ID PPP detect AT command during dialup PPP detect escape during dialup 上海移远通信技术股份有限公司 216 / 216

LTE Standard(U)系列 AT 命令手册 LTE Standard 模块系列 版本：1.1 日期：2024-02-03 状态：受控文件 LTE Standard(U)系列 AT 命令手册 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 279 LTE Standard(U)系列 AT 命令手册 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 279 LTE Standard(U)系列 AT 命令手册 文档历史 修订记录 版本 日期 - 2021-03-08 1.0 2021-11-01 1.1. 2024-02-03 作者 Fei XUE/ Braden HE/ Marvin NING/ Kevin WANG/ Herry GENG Fei XUE/ Braden HE/ Marvin NING/ Kevin WANG/ Herry GENG Reilly NIAN/ Dony ZHAO/ Ryan YI/ Joe TU/ Marvin NING/ Kevin WANG 变更表述 文档创建 受控版本 1. 新增 EC200D 系列、EC200G-CN、EC600G 系 列、EG700G-CN、EC800G-CN、EG800G 系列、 EG912U-GL 和 EG915G-EU 模块及其相关信息。 2. 新增有关文件系统中预制文件不可随意删除的备 注（第 1 章）。 3. 删除 AT+QSCLK 命令。 4. 更新 AT+IFC 命令备注信息（第 3.3 章）。 5. 更 新 AT+IPR 命 令 中 参 数 的 取 值 （第 3.5 章）。 6. 新增以下串口控制命令： AT+CBAUD（第 3.6 章） AT+QIPR（第 3.7 章） AT+QICF（第 3.8 章） AT+QIFC（第 3.9 章） 7. 更新 AT+CEER 命令（第 4.2 章）。 8. 新增 AT+QINDCFG 命令参数的取 值（第 4.3 章）。 9. 新增 AT+QCFG='urc/ri/ring'命令参数 的取值（第 4.5.13 章）。 10. 更新 AT+QCFG='fota/times'命令（第 4.5.20 章）。 上海移远通信技术股份有限公司 3 / 279 上海移远通信技术股份有限公司 LTE Standard(U)系列 AT 命令手册 11. 新增以下状态控制命令： AT+QRDY（第 4.4 章） AT+QCFG='nwscanmodeex'（第 4.5.2 章） AT+QCFG='creg/emergency'（第 4.5.4 章） AT+QCFG='nat/subnet'（第 4.5.9 章） AT+QCFG='usbnetmac'（第 4.5.10 章） AT+QCFG='apready'（第 4.5.17 章） AT+QCFG='pkalive/ip'（第 4.5.22 章） AT+QCFG='led/sim'（第 4.5.24 章） AT+QCFG='sleepind/level'（第 4.5.26 章） AT+QCFG='wakeupin/level'（第 4.5.27 章） AT+QCFG='ntp'（第 4.5.28 章） AT+QCFG='esmfail/times'（第 4.5.29 章） AT+QCFG='rtc/cfg'（第 4.5.30 章） AT+QCFG='pdn/pco'（第 4.5.31 章） 12. 新 增 AT+CLCK 命 令 参 数 支 持 的 取 值 （第 5.2 章）。 13. 新增(U)SIM 卡相关命令： AT+QPINC（第 5.14 章） 14. 新 增 AT+CREG 命 令 支 持 的 取 值 （第 6.2 章）。 15. 新增 AT+QNWINFO 命令参数和取 值（第 6.9 章）。 16. 更新 WCDMA 下 AT+QCSQ 命令查询和上报的 信号强度说明（第 6.11 章）。 17. 新增以下音频命令： AT+QAUDSTOP（第 12.6 章） AT+QDAI（第 12.9 章） AT+QWTTS（第 12.13 章） AT+QAUDCFG='urc'（第 12.15 章） AT+ QICMIC（第 12.16 章） AT+QRXGAIN（第 12.17 章） AT+QICSIDET（第 12.18 章） AT+QLDTMF（第 12.19 章） AT+QWDTMF（第 12.20 章） AT+VTS （第 12.21 章） AT+QLTONE（第 12.22 章） AT+QLTONEX（第 12.23 章） AT+QTONEDET（第 12.24 章） 18. 新增模块支持的音频模式相关备注（第 12.7 章）。 19. 新增 AT+QAUDSW 命令备注（第 12.10 章）。 20. 更新 AT+QTTS 命令（第 12.12 章）。 4 / 279 LTE Standard(U)系列 AT 命令手册 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 5 表格索引 ..................................................................................................................................................... 11 1 引言 ..................................................................................................................................................... 12 1.1. 适用模块 ................................................................................................................................... 12 1.2. AT 命令语句.............................................................................................................................. 13 1.2.1. 定义 ............................................................................................................................... 13 1.2.2. AT 命令语句................................................................................................................... 13 1.3. 支持的字符集............................................................................................................................ 14 1.4. AT 命令端口.............................................................................................................................. 15 1.5. 未经请求的结果码 .................................................................................................................... 15 1.6. 关闭程序 ................................................................................................................................... 15 1.7. AT 示例声明.............................................................................................................................. 15 2 通用命令 .............................................................................................................................................. 16 2.1. ATI 显示 MT 的 ID 信息.......................................................................................................... 16 2.2. AT+GMI 请求制造商信息 ....................................................................................................... 17 2.3. AT+GMM 请求 MT 型号 ID .................................................................................................... 17 2.4. AT+GMR 请求 TA 固件版本 ID .............................................................................................. 18 2.5. AT+CGMI 请求制造商信息 .................................................................................................... 18 2.6. AT+CGMM 请求 MT 型号 ID.................................................................................................. 19 2.7. AT+CGMR 请求 TA 固件版本 ID............................................................................................ 19 2.8. AT+GSN 请求国际移动设备识别码和序列号......................................................................... 20 2.9. AT+CGSN 请求国际移动设备识别码和序列号 ...................................................................... 21 2.10. AT&F 重置 AT 设置命令为出厂设置 ...................................................................................... 22 2.11. AT&V 显示当前设置............................................................................................................... 23 2.12. AT&W 存储当前设置到用户自定义配置文件 ......................................................................... 23 2.13. ATZ 从用户自定义文件中还原 AT 命令设置 .......................................................................... 24 2.14. ATQ 设置结果码回显模式 ...................................................................................................... 24 2.15. ATV TA 响应格式 ................................................................................................................... 25 2.16. ATE 设置命令回显模式 .......................................................................................................... 27 2.17. A/ 重复上一个命令行 ............................................................................................................. 27 2.18. ATS3 设置命令行终止符 ........................................................................................................ 28 2.19. ATS4 设置响应格式字符 ........................................................................................................ 29 2.20. ATS5 设置命令行编辑字符 .................................................................................................... 29 2.21. ATX 设置 CONNECT 结果码格式和检测呼叫进程 ................................................................ 30 2.22. AT+CFUN 设置功能模式 ....................................................................................................... 30 2.23. AT+CMEE 设置错误讯息格式................................................................................................ 32 2.24. AT+CSCS 选择 TE 字符集 .................................................................................................... 33 2.25. AT+QURCCFG 配置 URC 输出端口 ..................................................................................... 34 3 串口控制命令....................................................................................................................................... 36 上海移远通信技术股份有限公司 5 / 279 LTE Standard(U)系列 AT 命令手册 3.1. AT&C 设置 DCD 信号模式....................................................................................................... 36 3.2. AT&D 设置 DTR 信号模式 ..................................................................................................... 36 3.3. AT+IFC 设置串口的流控方式................................................................................................. 37 3.4. AT+ICF 设置串口通信的帧格式和校验算法........................................................................... 38 3.5. AT+IPR 设置固定的串口通信波特率 ....................................................................................... 39 3.6. AT+CBAUD 设置主串口通信波特率 ...................................................................................... 41 3.7. AT+QIPR 设置 UART2（辅助串口）/UART3 通信波特率 .................................................... 42 3.8. AT+QICF 设置 UART2（辅助串口）/UART3 通信的帧格式和校验算法............................... 44 3.9. AT+QIFC 设置 UART2（辅助串口）/UART3 的流控方式..................................................... 45 4 状态控制命令....................................................................................................................................... 47 4.1. AT+CPAS 查询 ME 活动状态................................................................................................. 47 4.2. AT+CEER 拓展错误上报 ....................................................................................................... 48 4.3. AT+QINDCFG 控制 URC 上报 .............................................................................................. 50 4.4. AT+QRDY 查询初始化状态 ................................................................................................... 53 4.5. AT+QCFG 扩展命令 .............................................................................................................. 54 4.5.1. AT+QCFG='nwscanmode' 配置网络制式.................................................................. 55 4.5.2. AT+QCFG='nwscanmodeex' 配置网络搜索模式....................................................... 56 4.5.3. AT+QCFG='band' 配置网络搜索频段 ........................................................................ 57 4.5.4. AT+QCFG='creg/emergency' 配置 emergency 网络信息显示 .................................. 59 4.5.5. AT+QCFG='qoos' 配置 OOS 状态下搜网定时器信息................................................ 60 4.5.6. AT+QCFG='airplanecontrol' 开启/关闭飞行模式控制................................................ 61 4.5.7. AT+QCFG='usbnet' 配置 USB 网络端口协议............................................................ 62 4.5.8. AT+QCFG='nat/cid' 开启 PDP 上下文的 NAT 功能 ................................................... 63 4.5.9. AT+QCFG='nat/subnet' 配置 PDP 上下文的 NAT 子网参数...................................... 64 4.5.10. AT+QCFG='usbnetmac' 配置 USB 网卡的 MAC 地址............................................... 65 4.5.11. AT+QCFG='urc/ri/other' 指定通用 URC RI 行为........................................................ 66 4.5.12. AT+QCFG='urc/ri/smsincoming' 指定短信类 URC RI 行为....................................... 67 4.5.13. AT+QCFG='urc/ri/ring' 指定来电类 URC RI 行为 ...................................................... 68 4.5.14. AT+QCFG='urc/delay' 设置 RI 脉冲结束后 URC 上报的延迟时间 ............................ 69 4.5.15. AT+QCFG='urc/cache' 打开/关闭 URC 缓存............................................................. 69 4.5.16. AT+QCFG='risignaltype' 设置 RI 信号输出位置 ........................................................ 70 4.5.17. AT+QCFG='apready' 设置 AP_READY 引脚行为..................................................... 71 4.5.18. AT+QCFG='cmux/urcport' 设置 CMUX 口 URC 输出方式 ........................................ 72 4.5.19. AT+QCFG='fota/cid' 配置 FOTA 下载 PDP 场景 ID .................................................. 73 4.5.20. AT+QCFG='fota/times' 配置 HTTP 方式 FOTA 下载信息.......................................... 74 4.5.21. AT+QCFG='fota/path' 配置 FOTA 目标固件包的存储媒介 ........................................ 75 4.5.22. AT+QCFG='pkalive/ip' 配置 PDP 保活参数............................................................... 75 4.5.23. AT+QCFG='ledmode' 配置网络状态灯（NET_STATUS）输出模式......................... 77 4.5.24. AT+QCFG='led/sim' 配置双卡双待下网络状态灯（NET_MODE 和 NET_STATUS）指 向的(U)SIM 卡 ID........................................................................................................... 77 4.5.25. AT+QCFG='tone/incoming' 配置来电铃声................................................................. 78 4.5.26. AT+QCFG='sleepind/level' 配置 SLEEP_IND 引脚的输出电平 ................................ 79 4.5.27. AT+QCFG='wakeupin/level' 配置 WAKEUP_IN 引脚唤醒行为，加载/卸载 USB ..... 80 4.5.28. AT+QCFG='ntp' 配置 NTP 最大重传次数和间隔....................................................... 81 上海移远通信技术股份有限公司 6 / 279 LTE Standard(U)系列 AT 命令手册 4.5.29. 4.5.30. 4.5.31. AT+QCFG='esmfail/times' 设置注册 LTE 最大连续失败次数并回落到 GSM 网络 .... 82 AT+QCFG='rtc/cfg' 设置 RTC 启动配置 .................................................................... 83 AT+QCFG='pdn/pco' 配置 PDN 请求中的 PCO 在模块驻网附着时是否携带加密信元 ....................................................................................................................................... 84 5 (U)SIM 卡相关命令.............................................................................................................................. 86 5.1. AT+CIMI 查询 IMSI ................................................................................................................ 86 5.2. AT+CLCK 功能锁定 ............................................................................................................... 87 5.3. AT+CPIN PIN 管理 ................................................................................................................ 88 5.4. AT+CPWD 修改密码.............................................................................................................. 90 5.5. AT+CSIM (U)SIM 卡访问....................................................................................................... 91 5.6. AT+CRSM (U)SIM 卡受限访问.............................................................................................. 92 5.7. AT+QCCID 查询 ICCID ......................................................................................................... 93 5.8. AT+QINISTAT 查询(U)SIM 卡初始化状态.............................................................................. 94 5.9. AT+QSIMDET (U)SIM 卡检测 ............................................................................................... 95 5.10. AT+QSIMSTAT (U)SIM 卡插拔状态上报 ............................................................................... 96 5.11. AT+CCHO 开启逻辑信道....................................................................................................... 97 5.12. AT+CGLA UICC 逻辑信道访问.............................................................................................. 98 5.13. AT+CCHC 关闭逻辑信道 ....................................................................................................... 99 5.14. AT+QPINC 获取 PIN/PUK 剩余重试次数 ............................................................................ 100 6 网络服务相关命令 ............................................................................................................................. 102 6.1. AT+COPS 选择运营商......................................................................................................... 102 6.2. AT+CREG CS 域网络注册状态 ........................................................................................... 104 6.3. AT+CSQ 查询信号强度........................................................................................................ 106 6.4. AT+CPOL 配置首选运营商列表........................................................................................... 107 6.5. AT+COPN 查询运营商列表 ................................................................................................. 108 6.6. AT+CTZU 自动更新时区...................................................................................................... 109 6.7. AT+CTZR 上报时区变化.......................................................................................................110 6.8. AT+QLTS 获取通过网络同步的最新时间.............................................................................. 111 6.9. AT+QNWINFO 查询网络信息...............................................................................................113 6.10. AT+QSPN 查询运营商名称 ..................................................................................................115 6.11. AT+QCSQ 查询和上报信号强度...........................................................................................116 6.12. AT+CIND 指示器状态查询 ....................................................................................................118 7 呼叫相关命令..................................................................................................................................... 120 7.1. ATA 呼叫应答 ....................................................................................................................... 120 7.2. ATD 发起呼叫 ...................................................................................................................... 121 7.3. ATH 挂断当前连接 ............................................................................................................... 122 7.4. AT+CVHU 控制语音通话挂断 .............................................................................................. 122 7.5. AT+CHUP 挂断通话............................................................................................................. 123 7.6. +++ 从数据模式切换至命令模式.......................................................................................... 124 7.7. ATO 从命令模式切换至数据模式 ......................................................................................... 125 7.8. ATS0 设置自动应答前振铃次数 ........................................................................................... 125 7.9. ATS7 设置呼叫建立完成等待时间 ....................................................................................... 126 7.10. AT+CSTA 选择地址类型 ...................................................................................................... 127 上海移远通信技术股份有限公司 7 / 279 LTE Standard(U)系列 AT 命令手册 7.11. AT+CLCC 查询当前 ME 呼叫 .............................................................................................. 128 7.12. AT+CRC 设置来电指示扩展格式 ......................................................................................... 130 7.13. AT+QECCNUM 配置紧急呼叫号码 ..................................................................................... 131 7.14. AT+QHUP 指定原因终止呼叫.............................................................................................. 133 7.15. AT+QCHLDIPMPTY 挂断 VoLTE 会议呼叫......................................................................... 134 8 电话本相关命令 ................................................................................................................................. 137 8.1. AT+CNUM 查询本机号码..................................................................................................... 137 8.2. AT+CPBF 搜索电话本记录 .................................................................................................... 138 8.3. AT+CPBR 读取电话本记录.................................................................................................. 139 8.4. AT+CPBS 设置电话本存储器 .............................................................................................. 140 8.5. AT+CPBW 写入电话本记录 ................................................................................................. 141 9 短消息相关命令 ................................................................................................................................. 144 9.1. AT+CSMS 选择短消息服务类型 .......................................................................................... 144 9.2. AT+CMGF 配置短消息模式 ................................................................................................. 145 9.3. AT+CSCA 设置短消息服务中心地址 ................................................................................... 146 9.4. AT+CPMS 配置短消息首选存储位置................................................................................... 147 9.5. AT+CMGD 删除短消息 ........................................................................................................ 149 9.6. AT+CMGL 按照状态读取短消息 .......................................................................................... 150 9.7. AT+CMGR 按照索引读取短消息 ......................................................................................... 153 9.8. AT+CMGS 发送短消息 ........................................................................................................ 157 9.9. AT+CMMS 发送多条短消息................................................................................................. 158 9.10. AT+CMGW 存储短消息 ....................................................................................................... 159 9.11. AT+CMSS 从存储器发送短消息 .......................................................................................... 161 9.12. AT+CNMA 新短消息确认....................................................................................................... 163 9.13. AT+CNMI 设置新短消息上报方式........................................................................................ 164 9.14. AT+CSDH 设置文本模式下参数显示 ................................................................................... 166 9.15. AT+CSMP 设置短消息文本模式参数................................................................................... 167 9.16. AT+QCMGS 发送级联短消息 .............................................................................................. 168 9.17. AT+QCMGR 读取级联短消息 .............................................................................................. 170 10 分组域命令 ........................................................................................................................................ 172 10.1. AT+CGATT PS 域附着或去附着 .......................................................................................... 172 10.2. AT+CGDCONT 定义 PDP 上下文 ....................................................................................... 173 10.3. AT+CGQREQ 服务质量参数（请求的） ............................................................................. 175 10.4. AT+CGQMIN 服务质量参数（最低可接受的） ................................................................... 177 10.5. AT+CGACT PDP 上下文激活/去激活 .................................................................................. 180 10.6. AT+CGDATA 进入数传状态 ................................................................................................. 181 10.7. AT+CGPADDR 显示 PDP 地址............................................................................................ 182 10.8. AT+CGCLASS GPRS 移动台类别 ...................................................................................... 183 10.9. AT+CGREG PS 域网络注册状态......................................................................................... 184 10.10. AT+CGEREP 分组域事件上报 ............................................................................................ 186 10.11. AT+CGSMS 选择 MO 短消息服务....................................................................................... 188 10.12. AT+CEREG EPS 网络注册状态 .......................................................................................... 189 10.13. AT+QGDCNT 流量统计 ....................................................................................................... 190 上海移远通信技术股份有限公司 8 / 279 LTE Standard(U)系列 AT 命令手册 10.14. AT+QAUGDCNT 自动保存流量统计 ................................................................................... 191 10.15. AT+CGCONTRDP PDP 上下文读取动态参数..................................................................... 192 10.16. AT+QNETDEVCTL 网卡拨号配置 ....................................................................................... 194 11 补充业务命令..................................................................................................................................... 196 11.1. AT+CCFC 呼叫转移............................................................................................................. 196 11.2. AT+CCWA 呼叫等待控制..................................................................................................... 198 11.3. AT+CHLD 呼叫相关补充业务 .............................................................................................. 200 11.4. AT+CLIP 主叫号码显示 ....................................................................................................... 202 11.5. AT+CLIR 主叫线路识别限制 ................................................................................................ 203 11.6. AT+COLP 被接线识别显示 .................................................................................................. 204 11.7. AT+CSSN 补充业务通知 ..................................................................................................... 206 11.8. AT+CUSD 非结构化补充数据业务....................................................................................... 207 12 音频命令 ............................................................................................................................................ 209 12.1. AT+CLVL 扬声器音量等级选择............................................................................................ 209 12.2. AT+QAUDLOOP 控制音频循环测试.................................................................................... 210 12.3. AT+QAUDRD 录制音频文件................................................................................................ 210 12.4. AT+QPSND 在本地或向远端播放音频文件 ......................................................................... 212 12.5. AT+QAUDPLAY 本地播放音频文件..................................................................................... 214 12.6. AT+QAUDSTOP 停止播放媒体文件 .................................................................................... 215 12.7. AT+QAUDMOD 设置音频模式 ............................................................................................ 216 12.8. AT+QIIC 读写 IIC ................................................................................................................. 217 12.9. AT+QDAI 数字音频配置....................................................................................................... 218 12.10. AT+QAUDSW Codec 切换 .................................................................................................. 220 12.11. AT+QAUDPASW 切换音频 PA 类型 .................................................................................... 221 12.12. AT+QTTS 播放文本 ............................................................................................................. 222 12.13. AT+QWTTS 向远端播放或发送文本.................................................................................... 224 12.14. AT+QTTSETUP 配置 TTS 参数........................................................................................... 225 12.15. AT+QAUDCFG='urc' 启用/禁用模块使用 URC 上报采样率 ............................................... 227 12.16. AT+QICMIC 设置麦克风的上行增益.................................................................................... 228 12.17. AT+QRXGAIN 设置下行增益............................................................................................... 228 12.18. AT+QICSIDET 设置当前模式的侧音增益 ............................................................................ 229 12.19. AT+QLDTMF 播放/停止播放本地 DTMF 音......................................................................... 230 12.20. AT+QWDTMF 向远端播放/发送 DTMF 音........................................................................... 232 12.21. AT+VTS 向对端发送 DTMF 音 ............................................................................................ 233 12.22. AT+QLTONE 播放本地定制音调.......................................................................................... 234 12.23. AT+QLTONEX 播放本地定制音调 ....................................................................................... 236 12.24. AT+QTONEDET 启用/禁用 DTMF 检测 .............................................................................. 237 13 硬件相关命令..................................................................................................................................... 239 13.1. AT+QPOWD 关闭模块......................................................................................................... 239 13.2. AT+CCLK 实时时钟 ............................................................................................................. 240 13.3. AT+CBC 查询电池充电状态和电量...................................................................................... 241 13.4. AT+QADC 查询 ADC 值 ...................................................................................................... 242 13.5. AT+QWIFISCAN 同步扫描 Wi-Fi AP（热点）信息 ............................................................. 242 上海移远通信技术股份有限公司 9 / 279 LTE Standard(U)系列 AT 命令手册 13.6. AT+QWIFISCANEX 异步扫描 AP（热点）信息.................................................................. 244 14 附录 ................................................................................................................................................... 247 14.1. 参考文档及术语缩写............................................................................................................... 247 14.2. AT&F 影响到的 AT 命令及参数............................................................................................... 252 14.3. AT&W 影响到的 AT 命令及参数 ............................................................................................. 254 14.4. ATZ 影响到的 AT 命令及参数 ................................................................................................. 255 14.5. CME ERROR 错误码汇总 ...................................................................................................... 255 14.6. CMS ERROR 错误码汇总 ...................................................................................................... 257 14.7. URC 汇总 ............................................................................................................................... 258 14.8. SMS 字符集转换 .................................................................................................................... 261 14.9. AT+CEER 扩展错误报告列表................................................................................................. 267 上海移远通信技术股份有限公司 10 / 279 LTE Standard(U)系列 AT 命令手册 表格索引 表 1：适用模块 ........................................................................................................................................... 12 表 2：AT 命令类型...................................................................................................................................... 14 表 3：AT&V 响应 ........................................................................................................................................ 23 表 4：ATV0&ATV1 结果码数值等效项和简要说明 ..................................................................................... 26 表 5：信号强度类型.................................................................................................................................. 117 表 6：延迟类别 ......................................................................................................................................... 177 表 7：URC +QAUDRIND: 0,中的描述 ............................................................................. 212 表 8：参考文档 ......................................................................................................................................... 247 表 9：术语缩写 ......................................................................................................................................... 247 表 10：AT&F 影响到的 AT 命令及参数..................................................................................................... 252 表 11：AT&W 影响到的 AT 命令及参数.................................................................................................... 254 表 12：ATZ 影响到的 AT 命令及参数 ....................................................................................................... 255 表 13：+CME ERROR: 错误码描述 ................................................................................................ 255 表 14：+CMS ERROR: 错误码描述 ................................................................................................ 257 表 15：URC 汇总 ..................................................................................................................................... 258 表 16：SMS 文本输入和输出方式............................................................................................................ 261 表 17：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） ........................................................... 261 表 18：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） ........................................................... 262 表 19：GSM 扩展字符（GSM 编码）...................................................................................................... 263 表 20：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'） ............................................................. 264 表 21：IRA 扩展字符 ................................................................................................................................ 264 表 22：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'） ............................................................. 265 表 23：GSM 扩展字符（ISO-8859-1/Unicode） ..................................................................................... 266 表 24：错误位置 ID 列表 .......................................................................................................................... 267 表 25：错误报告列表................................................................................................................................ 267 上海移远通信技术股份有限公司 11 / 279 LTE Standard(U)系列 AT 命令手册 1 引言 本文档介绍移远通信 LTE Standard(U)系列（如下表所示）模块支持的 AT 命令集。 1.1. 适用模块 表 1：适用模块 模块系列 ECx00G ECx00U EGx00U EGx00G EG91xU - 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U-GL EG915U 系列 EG915G-EU 上海移远通信技术股份有限公司 12 / 279 LTE Standard(U)系列 AT 命令手册 备注 存在文件系统中的 GNSS、BT 和 TTS 等功能的预置文件不可随意删除。 1.2. AT 命令语句 1.2.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 模块支持的 AT 命令集是国际标准（例如 3GPP TS 27.007、3GPP TS 27.005 和 ITU-T Recommendation V.25ter）以及移远通信开发的 AT 命令组合，从语法上分为三类：基础类、S 参数类和扩展类，如下所列： ⚫ 基础类 基础类 AT 命令的格式为 AT 或 AT&，其中 是命令， 是该命令的参数。 以 ATE 为例，DCE 会根据 的取值确定是否将接收到的字符回显给 DTE。若 为可 选参数，则其被省略时将使用其默认值。 ⚫ S 参数类 此类 AT 命令格式有 ATS=，其中是 S 寄存器的索引，是赋予的参数值。 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 上海移远通信技术股份有限公司 13 / 279 LTE Standard(U)系列 AT 命令手册 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 可以用分号（;）将多个命令放在同一行。此时只有第一个命令带有 AT 前缀。命令可以是大写或小写。 输入 AT 命令时，可以忽略空格。但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内； ⚫ 在 AT 命令名称中的 =、? 或 =? 内。 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一对回车符/换行符。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.3. 支持的字符集 LTE Standard(U)系列模块的 AT 命令接口默认使用 GSM 字符集，其支持的字符集如下： ⚫ GSM format ⚫ UCS2 ⚫ IRA 可以使用 AT+CSCS（3GPP TS 27.007）来配置和查询字符集，并在 3GPP TS 27.005 中对其进行定 义。字符集会影响 SMS 和 SMS 广播消息的发送和接收，以及电话簿条目文本字段的输入和显示。 上海移远通信技术股份有限公司 14 / 279 LTE Standard(U)系列 AT 命令手册 1.4. AT 命令端口 主串口端口和两个 USB 端口（USB MODEM 端口和 USB AT 端口）支持 AT 命令通信和数据传输。 1.5. 未经请求的结果码 作为未经请求的结果码和上报消息，URC 不会作为与已执行的 AT 命令相关的响应的一部分发出。 URC 由 LTE Standard(U)系列模块发出的报告消息，无需 TE 请求，并且在发生特定事件时自动发布。若发 生来电（RING），收到的短消息等，高低压警报，高低温警报等。 1.6. 关闭程序 建议执行 AT+QPOWD 关闭模块，因为这是最安全，最好的方法。通过让模块从网络注销并允许软件 在断开电源连接之前进入安全的数据状态来实现此过程。 发送 AT+QPOWD 后，请勿执行任何其他 AT 命令。成功执行命令后，模块将输出消息 POWERED DOWN，然后进入关机状态。为了避免数据丢失，建议在输出 URC POWERED DOWN 后等待 1 秒以断开 电源。若 65 秒后仍未收到 POWERED DOWN，则必须强制断开电源。 1.7. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 15 / 279 LTE Standard(U)系列 AT 命令手册 2 通用命令 2.1. ATI 显示 MT 的 ID 信息 该命令用于提供 MT 的 ID 信息。 ATI 显示 MT 的 ID 信息 执行命令 ATI 最大响应时间 特性说明 参考 V.25ter 响应 Quectel Revision: OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 字符串类型。MT 固件版本的 ID 信息。 举例 ATI Quectel EC200U Revision: EC200UCNAAR01A04M08 OK 上海移远通信技术股份有限公司 16 / 279 LTE Standard(U)系列 AT 命令手册 2.2. AT+GMI 请求制造商信息 该命令与 AT+CGMI 的作用相同，用于返回制造商 ID 信息。 AT+GMI 请求制造商信息 测试命令 AT+GMI=? 执行命令 AT+GMI 响应 OK 响应 Quectel 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 2.3. AT+GMM 请求 MT 型号 ID 该命令与 AT+CGMM 的作用相同，用于返回 MT 型号 ID 信息。 AT+GMM 请求 MT 型号 ID 测试命令 AT+GMM=? 执行命令 AT+GMM 响应 OK 响应 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 上海移远通信技术股份有限公司 17 / 279 LTE Standard(U)系列 AT 命令手册 2.4. AT+GMR 请求 TA 固件版本 ID 该命令与 AT+CGMR 的作用相同，用于提供 TA 固件版本的 ID 信息。 AT+GMR 请求 TA 固件版本 ID 测试命令 AT+GMR=? 执行命令 AT+GMR 响应 OK 响应 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 参数 字符串类型。TA 固件版本的 ID 信息。 举例 AT+GMR EC200UCNAAR01A04M08 OK 2.5. AT+CGMI 请求制造商信息 该命令与 AT+GMI 的作用相同，用于返回制造商信息。 AT+CGMI 请求制造商信息 测试命令 AT+CGMI=? 执行命令 AT+CGMI 响应 OK 响应 Quectel OK 上海移远通信技术股份有限公司 18 / 279 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 / LTE Standard(U)系列 AT 命令手册 2.6. AT+CGMM 请求 MT 型号 ID 该命令与 AT+GMM 的作用相同，用于返回 MT 型号 ID 信息。 AT+CGMM 请求 MT 型号 ID 测试命令 AT+CGMM=? 执行命令 AT+CGMM 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 OK 响应 OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 2.7. AT+CGMR 请求 TA 固件版本 ID 该命令与 AT+GMR 的作用相同，用于提供 TA 固件版本 ID 信息。 AT+CGMR 请求 TA 固件版本 ID 测试命令 AT+CGMR=? 执行命令 AT+CGMR 响应 OK 响应 最大响应时间 OK 300 毫秒 上海移远通信技术股份有限公司 19 / 279 特性说明 / 参考 3GPP TS 27.007 参数 字符串类型。TA 固件版本的 ID 信息。 LTE Standard(U)系列 AT 命令手册 2.8. AT+GSN 请求国际移动设备识别码和序列号 该命令与 AT+CGSN 的作用相同，用于返回 ME 的国际移动设备识别码（IMEI 号）和序列号（SN 号）。 AT+GSN 请求国际移动设备识别码和序列号 测试命令 AT+GSN=? 响应 +CSN: (支持的列表) 设置命令 AT+GSN= OK 响应 若=0，查询 ME 的 SN 号： +GSN: OK 若=1，查询 ME 的 IMEI 号： +GSN: 执行命令 AT+GSN OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 若出现任何错误与 ME 相关： +CMS ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 20 / 279 V.25ter LTE Standard(U)系列 AT 命令手册 参数 整型。控制查询 SN 号还是 IMEI 号。 0 查询 ME 的 SN 号。 1 查询 ME 的 IMEI 号。 字符串类型。ME 的 SN 号。 字符串类型。ME 的 IMEI 号。 错误码。详情参考第 14.5 章。 备注 每台 ME 设备的 SN 号或 IMEI 号不同，因此可以用来识别 ME。 2.9. AT+CGSN 请求国际移动设备识别码和序列号 该命令与 AT+GSN 的作用相同，用于返回 ME 的国际移动设备识别码（IMEI 号）和序列号（SN 号）。 AT+CGSN 请求国际移动设备识别码和序列号 测试命令 AT+CGSN=? 响应 +CGSN: (支持的列表) 设置命令 AT+CGSN= OK 响应 若=0，查询 ME 的 SN 号： +CGSN : OK 若=1，查询 ME 的 IMEI 号： +CGSN : 执行命令 AT+CGSN OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 21 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现任何错误与 ME 相关： +CMS ERROR: 300 毫秒 / 参数 整型。控制查询 SN 号还是 IMEI 号。 0 查询 ME 的 SN 号。 1 查询 ME 的 IMEI 号。 字符串类型。ME 的 SN 号。 字符串类型。ME 的 IMEI 号。 错误码。详情参考第 14.5 章。 备注 每台 ME 设备的序列号或 IMEI 号不同，因此可以用来识别 ME。 2.10. AT&F 重置 AT 设置命令为出厂设置 该命令用于将 AT 设置命令重置为出厂设置（详情参考表 10）。 AT&F 重置 AT 设置命令为出厂设置 执行命令 响应 AT&F[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 参数 整型。 0 将 AT 设置命令重置为出厂设置。 上海移远通信技术股份有限公司 22 / 279 LTE Standard(U)系列 AT 命令手册 2.11. AT&V 显示当前设置 该命令用于显示一些 AT 命令参数的当前设置（详情参考表 3），包括不可读的单字母 AT 命令参数。 AT&V 显示当前设置 执行命令 AT&V 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 / 表 3：AT&V 响应 AT&V &C: 1 &D: 2 &F: 0 &W: 0 E: 1 Q: 0 V: 1 X: 4 Z: 0 S0: 0 S3: 13 S4: 10 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 OK 2.12. AT&W 存储当前设置到用户自定义配置文件 该命令用于将当前的 AT 命令设置存储到 NVM 中用户自定义配置文件（详情参考表 11）。 上海移远通信技术股份有限公司 23 / 279 LTE Standard(U)系列 AT 命令手册 AT&W 存储当前设置到用户自定义配置文件 执行命令 响应 AT&W[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 参数 整型。 0 配置文件编号。用于存储当前的 AT 命令设置。 2.13. ATZ 从用户自定义文件中还原 AT 命令设置 该命令用于从用户自定义文件中还原 AT 命令设置。若之前已通过 AT&W 将 AT 命令设置存储在 NVM 中，则从 NVM 中的用户自定义配置文件中还原 AT 命令设置（详情参考表 12）。 同一命令行的任何其他 AT 命令都可以忽略。 ATZ 从用户自定义文件中还原 AT 命令设置 执行命令 响应 ATZ[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 参数 整型。 0 重置文件编号 2.14. ATQ 设置结果码回显模式 该命令用于控制是否将结果码发送到 TE，作为响应发送的其他信息不受影响。 上海移远通信技术股份有限公司 24 / 279 LTE Standard(U)系列 AT 命令手册 ATQ 设置结果码回显模式 执行命令 ATQ 最大响应时间 特性说明 参考 V.25ter 响应 若=0： OK 若=1： （无） 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。 0 发送结果码。 1 结果码被禁止而不发送。 2.15. ATV TA 响应格式 该命令用于确定与 AT 命令结果码和信息响应一起发送的首尾内容。 表 4 列出了结果码，其数值等效项以及每种用法的简要说明。 ATV TA 响应格式 执行命令 ATV 响应 若=0： 0 最大响应时间 特性说明 参考 V.25ter 若=1： OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 25 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。 0 信息返回： 短结果码格式： 1 信息返回： 长结果码格式： 举例 ATV1 OK AT+CSQ +CSQ: 30,99 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //设置=1。 //当=1 时，结果码是 OK。 //设置=0。 //当=0 时，结果码是 0。 表 4：ATV0&ATV1 结果码数值等效项和简要说明 ATV1 OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY NO ANSWER ATV0 0 1 2 3 4 6 7 8 描述 确认执行命令 已建立连接；DCE 正从命令模式转换为数据模式 DCE 已检测到来自网络的来电信号 连接已终止或尝试建立连接失败 无法识别命令，超过命令行最大字符长度，参数值无效或其 他处理命令行的问题 未检测到拨号音 检测到占线（忙音）信号 使用了 @（等待静默应答）拨号修饰符，连接计时器（S7） 计时结束前，未检测到远程振铃后的五秒静音。 上海移远通信技术股份有限公司 26 / 279 LTE Standard(U)系列 AT 命令手册 2.16. ATE 设置命令回显模式 该命令用于控制 TA 是否在 AT 命令模式下回显从 TE 接收的字符。 ATE 设置命令回显模式 执行命令 ATE 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。是否回显从 TE 收到的字符。 0 关闭 1 开启 2.17. A/ 重复上一个命令行 该命令用于重复上一个 AT 命令行，'/'表示行终止符。 A/ 重复上一个命令行 执行命令 A/ 特性说明 参考 V.25ter 响应 重复上一个命令 / 备注 EC200D 系列模块暂不支持该命令。 上海移远通信技术股份有限公司 27 / 279 举例 ATI Quectel EC200U Revision: EC200UCNAAR01A04M08 OK A/ Quectel EC200U Revision: EC200UCNAAR01A04M08 OK LTE Standard(U)系列 AT 命令手册 //重复上一个命令。 2.18. ATS3 设置命令行终止符 该命令用于确定 TA 识别的字符以终止输入的命令行。同时生成结果代码和信息文本以及通过 ATS4 设 置的字符值。 ATS3 设置命令行终止符 查询命令 响应 ATS3? 设置命令 ATS3= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。命令行终止符。范围：0~127；默认值：13。 上海移远通信技术股份有限公司 28 / 279 LTE Standard(U)系列 AT 命令手册 2.19. ATS4 设置响应格式字符 该命令用于确定 TA 为结果代码和信息文本生成的字符，以及通过 ATS3 设置的命令行终止字符。 ATS4 设置响应格式字符 查询命令 响应 ATS4? 设置命令 ATS4= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。响应格式字符。范围：0~127；默认值：10。 2.20. ATS5 设置命令行编辑字符 该命令用于确定 TA 用来从 AT 命令行删除紧接前一个字符的编辑字符值（等同于退格键）。 ATS5 设置命令行编辑字符 查询命令 响应 ATS5? 设置命令 ATS5= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 29 / 279 参数 LTE Standard(U)系列 AT 命令手册 整型。响应编辑字符。范围：0~127；默认值：8。 2.21. ATX 设置 CONNECT 结果码格式和检测呼叫进程 该命令用于确定 TA 是否将特定的结果代码发送到 TE。它还控制 TA 在开始拨号时是否检测拨号音和 占线（忙音）信号。 ATX 设置 CONNECT 结果码格式和检测呼叫进程 执行命令 响应 ATX OK 最大响应时间 300 毫秒 特性说明 参考 该命令立即生效； 执行 AT&W 后将保存参数配置。 V.25ter 参数 整型。 0 仅返回 CONNECT 结果码，拨号音和忙音检测均禁用。 1 仅返回 CONNECT 结果码，拨号音和忙音检测均禁用。 2 返回 CONNECT 结果码，禁用忙音检测，启用拨号音检测。 3 返回 CONNECT 结果码，禁用拨号音检测，启用忙音检测。 4 返回 CONNECT 结果码，拨号音和忙音检测均启用。 备注 EC200D 系列模块暂不支持该命令。 2.22. AT+CFUN 设置功能模式 此命令用于控制功能模式，同时还可以用于重置 UE。 上海移远通信技术股份有限公司 30 / 279 LTE Standard(U)系列 AT 命令手册 AT+CFUN 设置功能模式 测试命令 AT+CFUN=? 查询命令 AT+CFUN? 设置命令 AT+CFUN=[,] 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 +CFUN: (支持的列表),(支持的列表) OK 响应 +CFUN: OK 响应 OK 若出现任何错误与 ME 相关： +CME ERROR: 15 秒，取决于网络状态 该命令立即生效； 参数配置不保存。 参数 整型。功能模式。 0 最小功能模式 1 全功能模式 4 禁用 UE 发送和接收 RF 信号功能（飞行模式） 整型。是否复位。 0 设置功能模式前，不触发复位。 1 触发复位。复位后，该设备可以正常使用。该值仅适用于=1。 错误码。详请参考第 14.5 章。 举例 AT+CFUN=0 OK AT+COPS? +COPS: 0 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 //设置 UE 为最小功能模式。 //无网络。 //(U)SIM 卡读取失败。 //设置 UE 为全功能模式。 上海移远通信技术股份有限公司 31 / 279 OK +CPIN: SIM PIN AT+CPIN='1234' OK +CPIN: READY +QUSIM: 1 +QIND: SMS DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE',7 OK LTE Standard(U)系列 AT 命令手册 //注册上网络。 2.23. AT+CMEE 设置错误讯息格式 该命令用于禁用或启用将最终结果码+CME ERROR: 作为错误的指示。启用后，出现错误则返回 +CME ERROR: 的最终结果代码，而不是 ERROR。 AT+CMEE 设置错误讯息格式 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) 查询命令 AT+CMEE? OK 响应 +CMEE: 设置命令 AT+CMEE= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 32 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。 0 禁用结果码并改用 ERROR。 1 启用结果码，使用数值型取值。 2 启用结果码，使用详细值取值。 举例 AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted //禁用结果码。 //仅显示 ERROR。 //启用数值型结果错误码。 //启用具有详细（字符串）值的错误结果码。 2.24. AT+CSCS 选择 TE 字符集 该设置命令用于把 TE 使用的字符集报给 MT，以使 MT 能够在 TE 和 MT 的字符集之间正确转换字符 串。 AT+CSCS 选择 TE 字符集 测试命令 AT+CSCS=? 响应 +CSCS: (支持的列表) 查询命令 AT+CSCS? OK 响应 +CSCS: 设置命令 AT+CSCS= 最大响应时间 OK 响应 OK 300 毫秒 上海移远通信技术股份有限公司 33 / 279 LTE Standard(U)系列 AT 命令手册 特性说明 参考 3GPP TS 27.007 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 字符串类型。 'GSM' GSM 默认字符集 'HEX' 仅由从 00 到 FF 的十六进制字符串组成 'PCCP936' PCCP936 字符集 'IRA' 国际参考字符集 'UCS2' UCS2 字符集 备注 EC200D 系列模块取值暂不支持'PCCP936'。 举例 AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //查询当前字符集。 //字符集为 GSM。 //设置字符集为 UCS2。 //配置后，查询字符集为 UCS2。 2.25. AT+QURCCFG 配置 URC 输出端口 该命令用于配置 URC 的输出端口。 AT+QURCCFG 配置 URC 输出端口 测试命令 AT+QURCCFG=? 响应 +QURCCFG: 'urcport',(支持的列表) OK 上海移远通信技术股份有限公司 34 / 279 LTE Standard(U)系列 AT 命令手册 设置命令 AT+QURCCFG='urcport'[,] 响应 若省略可选参数，则查询当前配置： +QURCCFG: 'urcport', OK 最大响应时间 特性说明 若指定可选参数，则配置 URC 的输出端口： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。设置 URC 的输出端口。 'usbat' USB AT 端口 'usbmodem' USB 调制解调器端口 'uart1' 主串口 'uart2' 辅助串口 'uart3' 串口 3（仅当模块不支持 GNSS 时有效） 'usbnmea' USB 串口 1（EC200D 系列模块暂不支持） 'usbext' USB 扩展 AT 端口（仅 EC200D 系列模块支持） 'all' 所有端口 举例 AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1','uart2','uart3','usbext','all') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' //查询URC输出端口的当前配置。 OK AT+QURCCFG='urcport','usbmodem' OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' //将URC输出端口配置为USB调制解调器端口。 OK 上海移远通信技术股份有限公司 35 / 279 LTE Standard(U)系列 AT 命令手册 3 串口控制命令 3.1. AT&C 设置 DCD 信号模式 该命令用于设置 DCD 信号模式。 AT&C 设置 DCD 信号模式 执行命令 AT&C[] 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。 0 DCD 信号一直保持开启 1 检测到网络侧的载波信号时，DCD 信号保持开启；未检测到载波信号时，DCD 信号保持 关闭。 3.2. AT&D 设置 DTR 信号模式 该命令用于设置在端口处于数据模式时，DTR 信号从低电平转变至高电平后 TA 对应的状态。 AT&D 设置 DTR 信号模式 执行命令 AT&D[] 最大响应时间 响应 OK 300 毫秒 特性说明 该命令立即生效； 上海移远通信技术股份有限公司 36 / 279 LTE Standard(U)系列 AT 命令手册 参考 V.25ter 执行 AT&W 后将保存参数配置。 参数 整型。 0 TA 忽略 DTR 管脚信号变化 1 DTR 由低电平上拉至高电平：保持呼叫连接并切换为命令模式 2 DTR 由低电平上拉至高电平：断开数据连接并切换为命令模式。当 DTR 处于高电平时， 禁用自动应答功能。 3.3. AT+IFC 设置串口的流控方式 该命令用于设置串口通信的流控方式。 AT+IFC 设置串口的流控方式 测试命令 AT+IFC=? 响应 +IFC: (支持的列表),(支持的列 表) 查询命令 AT+IFC? OK 响应 +IFC: , 设置命令 数据模式下，设置串口的流控方式 AT+IFC=, OK 响应 OK 最大响应时间 300 毫秒 特性说明 参考 V.25ter 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 37 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。指定 TE 从 TA 接收数据时的流控行为。 0 无 2 RTS 流控 整型。指定 TA 从 TE 接收数据时的流控行为。 0 无 2 CTS 流控 备注 通常，流控用于传输大量数据的场景。 举例 AT+IFC=2,2 OK AT+IFC? +IFC: 2,2 OK //打开硬件流控。 3.4. AT+ICF 设置串口通信的帧格式和校验算法 该命令用于设置串口通信的帧格式和校验算法。 AT+ICF 设置串口通信的帧格式和校验算法 测试命令 AT+ICF=? 响应 +ICF: (支持的列表),(支持的列表) 查询命令 AT+ICF? OK 响应 +ICF: , 设置命令 AT+ICF=[,[]] 最大响应时间 OK 响应 OK 或者 ERROR 300 毫秒 上海移远通信技术股份有限公司 38 / 279 LTE Standard(U)系列 AT 命令手册 特性说明 参考 V.25ter 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。帧格式。 1 8 个数据位，2 个停止位 2 8 个数据位，1 个停止位，1 个校验位 3 8 个数据位，1 个停止位，无校验位 整型。校验算法。仅当=2 时有效。 0 奇校验 1 偶校验 备注 1. 该命令仅在命令模式下适用。 2. 若配置为 1 或 3，则无效。 3.5. AT+IPR 设置固定的串口通信波特率 该命令用于设置固定的串口通信波特率。 AT+IPR 设置固定的串口通信波特率 测试命令 AT+IPR=? 响应 +IPR: (自动检测的列表),(支持固定的列表) 查询命令 AT+IPR? OK 响应 +IPR: 设置命令 AT+IPR= 最大响应时间 特性说明 参考 OK 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 39 / 279 V.25ter LTE Standard(U)系列 AT 命令手册 参数 整型。每秒的波特率。单位：bps。 0 自适应波特率 ⚫ ECx00U、EGx00U 和 EG91xU 系列模块支持的波特率如下： 1200、2400、4800、9600、14400、19200、28800、33600、38400、57600、115200、 230400、250000、460800、500000、921600、1000000、1843200、2100000 ⚫ EC200D 系列模块支持的波特率如下： 1200、2400、4800、9600、19200、38400、57600、115200、187500、230400, 460800、 921600、2000000、3250000 ⚫ ECx00G、EGx00G 系列和 EG915G-EU 模块支持的波特率如下： 1200、2400、4800、9600、14400、19200、28800、33600、38400、57600、115200、 230400、250000、460800、500000、921600、1000000、1843200、2000000 备注 1. 若设置固定的波特率，请确保 TE（DTE，通常为外部处理器）和 TA（DCE，移远通信模块）配置了 相同的波特率。 2. 在多路复用模式下，波特率无法通过 AT+IPR=设置。 3. 设置命令执行并返回 OK 后，波特率设置生效。 4. AT+IPR=0 表示配置为自适应波特率，需要 TE 先发 AT 或者 at 进行波特率自动匹配。模块匹配成功 后，没有返回结果，执行任意 AT 命令成功后，表示匹配成功。 举例 AT+IPR=115200 OK AT&W OK AT+IPR? +IPR: 115200 OK AT+IPR=115200;&W OK //设置固定波特率为 115200 bps。 //保存当前配置，模块重启后，串口通信速率仍为 115200 bps。 //固定波特率为 115200 bps 并保存当前配置。 上海移远通信技术股份有限公司 40 / 279 LTE Standard(U)系列 AT 命令手册 3.6. AT+CBAUD 设置主串口通信波特率 该命令用于设置主串口的固定通信波特率。 AT+CBAUD 设置主串口通信波特率 测试命令 AT+CBAUD=? 响应 +CBAUD: (支持的固定的列表) 查询命令 AT+CBAUD? OK 响应 +CBAUD: 设置命令 AT+CBAUD= OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。固定波特率。单位：bps。 0 自适应波特率 ⚫ ECx00U、EGx00U 和 EG91xU 系列模块支持的波特率如下： 1200、2400、4800、9600、14400、19200、28800、33600、38400、57600、115200、 230400、250000、460800、500000、921600、1000000、1843200、2100000 ⚫ EC200D 系列模块支持的波特率如下： 1200、2400、4800、9600、19200、38400、57600、115200、187500、230400、460800、 921600、2000000、3250000 ⚫ ECx00G、EGx00G 系列和 EG915G-EU 模块支持的波特率如下： 1200、2400、4800、9600、14400、19200、28800、33600、38400、57600、115200、 230400、250000、460800、500000、921600、1000000、1843200、2100000 备注 1. 若设置固定的波特率，请确保 TE（DTE，通常为外部处理器）和 TA（DCE，移远通信模块）配置了 相同的波特率。 2. 在多路复用模式下，波特率无法通过 AT+CBAUD=设置。 上海移远通信技术股份有限公司 41 / 279 3. 设置命令执行并返回 OK 后，波特率设置生效。 LTE Standard(U)系列 AT 命令手册 举例 AT+CBAUD=460800 OK AT+CBAUD? +CBAUD: 460800 OK //设置固定波特率为 460800 bps。 3.7. AT+QIPR 设置 UART2（辅助串口）/UART3 通信波特率 该命令用于设置 UART2（辅助串口）或 UART3 的通信波特率。 AT+QIPR 设置 UART2（辅助串口）/UART3 的通信波特率 测试命令 AT+QIPR=? 响应 +QIPR: (支持的列表),(支持的列表) 查询命令 AT+QIPR? OK 响应 +QIPR: , +QIPR: , 设置命令 AT+QIPR=, OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后保存参数配置。 参数 整型。UART 名称。 1 UART2（辅助串口） 2 UART3 上海移远通信技术股份有限公司 42 / 279 LTE Standard(U)系列 AT 命令手册 整型。波特率。单位：bps。 0 表示自适应波特率 ⚫ ECx00U 系列、EGx00U 和 EG91xU 系列模块支持的波特率如下： 1200、2400、4800, 9600、14400、19200、28800、33600、38400、57600、 115200、230400、250000、460800、500000、921600、1000000、1843200、 2100000 ⚫ EC200D 系列模块支持的波特率如下： 1200、2400、4800、9600、19200、38400、57600、115200、187500、230400、 460800、921600、2000000、3250000 ⚫ ECx00G、EGx00G 系列和 EG915G-EU 模块支持的波特率如下： 1200、2400、 4800、9600、14400、19200、28800、33600、38400、57600、 115200、230400、250000、460800、500000、921600、1000000、1843200、 2100000 备注 1. 若设置固定的波特率（不为 0），请确保 TE（DTE，通常为外部处理器）和 TA（DCE，移远通 信模块）配置了相同的波特率。 2. 在多路复用模式下，波特率无法通过 AT+QIPR=,设置。 3. 设置命令执行并返回 OK 后，波特率设置生效。 举例 AT+QIPR=1,460800 OK AT+QIPR? +QIPR: 1,460800 +QIPR: 2,115200 //设置 UART2 的固定波特率为 460800 bps。 OK AT&W OK //保存当前配置：模块重启后，UART2 通信波特率维持为 460800 bps。 //重启模块 AT+QIPR? +QIPR: 1,460800 +QIPR: 2,115200 OK 上海移远通信技术股份有限公司 43 / 279 LTE Standard(U)系列 AT 命令手册 3.8. AT+QICF 设置 UART2（辅助串口）/UART3 通信的帧格式和校验算法 该命令用于设置 UART2（辅助串口）或 UART3 通信的帧格式和校验算法。 AT+QICF 设置 UART2（辅助串口）/UART3 通信的帧格式和校验算法 测试命令 AT+QICF=? 响应 +QICF: ( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的列表) 查询命令 AT+QICF? OK 响应 +QICF: ,, +QICF: ,, 设置命令 AT+QICF=[,[,]] OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后保存参数配置。 参数 整型。UART 名称。 1 UART2（辅助串口） 2 UART3 整型。帧格式。 1 8 个数据位，2 个停止位，无校验位 2 8 个数据位，1 个停止位，1 个校验位 3 8 个数据位，1 个停止位，无校验位 整型。校验算法。仅当=2 时有效。 0 奇校验 1 偶校验 备注 1. 该命令仅在命令模式下适用。 2. 若配置为 1 或 3，则无效。 上海移远通信技术股份有限公司 44 / 279 LTE Standard(U)系列 AT 命令手册 3. 执行 AT+QICF?查询当前配置时，若返回值为 1 或 3，则无需关注返回的第三个参数。 举例 AT+QICF=2,3 OK AT+QICF? +QICF: 1,3,0 +QICF: 2,3,0 OK AT&W OK //重启模块 AT+QICF? +QICF: 1,3,0 +QICF: 2,3,0 OK //设置 UART3 帧格式为 8 个数据位，1 个停止位，无校验位。 //保存当前配置：模块重启后，UART3 帧格式维持为 8 个数据位，1 个停止位， 无校验位。 3.9. AT+QIFC 设置 UART2（辅助串口）/UART3 的流控方式 该命令用于设置 UART2（辅助串口）或 UART3 的流控方式。 AT+QIFC 设置固定的 UART2（辅助串口）/UART3 的流控方式 测试命令 AT+QIFC=? 响应 +QIFC: (支持的列表),(支持的列 表),(支持的列表) 查询命令 AT+QIFC? OK 响应 +QIFC: ,, +QIFC: ,, 设置命令 AT+QIFC=[,[,]] 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后保存参数配置。 参数 整型。UART 名称。 1 UART2（辅助串口） 2 UART3 整型。指定 TE 从 TA 接收数据时的流控行为。 0 无 2 RTS 流控 整型。指定 TA 从 TE 接收数据时的流控行为。 0 无 2 CTS 流控 备注 通常，流控用于传输大量数据的场景。 举例 AT+QIFC=1,2,2 OK AT+QIFC? +QICF: 1,2,2 +QICF: 2,0,0 OK AT&W OK //重启模块 AT+QIFC? +QIFC: 1,2,2 +QIFC: 2,0,0 OK //打开 UART2 硬件流控。 //保存当前配置：模块重启后，UART2 硬件流控维持打开。 上海移远通信技术股份有限公司 46 / 279 LTE Standard(U)系列 AT 命令手册 4 状态控制命令 4.1. AT+CPAS 查询 ME 活动状态 该命令用于查询 ME 的活动状态。 AT+CPAS 查询 ME 活动状态 测试命令 AT+CPAS=? 响应 +CPAS: (支持的列表) 执行命令 AT+CPAS OK 响应 TA 返回 ME 的活动状态： +CPAS: OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现任何错误与 ME 相关： +CME ERROR: 300 毫秒 / 参数 整型。ME 活动状态。 0 就绪 2 未知 3 响铃 4 呼叫进行中 错误码。详情参考第 14.5 章。 上海移远通信技术股份有限公司 47 / 279 LTE Standard(U)系列 AT 命令手册 举例 AT+CPAS +CPAS: 0 OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129 OK AT+CPAS +CPAS: 4 OK //处于就绪状态。 //正在响铃。 //呼叫进行中。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块暂不支持该命令。 4.2. AT+CEER 拓展错误上报 该命令用于查询拓展的错误并上报上次操作失败的原因，例如： ⚫ 拨打电话失败 ⚫ 通话失败（无论手机作为主叫或被叫） ⚫ 无法通过补充业务修改呼叫 ⚫ 无法激活，注册，查询，停用或注销补充业务 ⚫ 无法附着 GPRS，激活 PDP 上下文 ⚫ 无法去附着 GPRS，去激活 PDP 上下文 AT+CEER 拓展错误上报 测试命令 AT+CEER=? 响应 +CEER: (支持的列表) 上海移远通信技术股份有限公司 48 / 279 LTE Standard(U)系列 AT 命令手册 查询命令 AT+CEER? 设置命令 AT+CEER= 执行命令 AT+CEER 最大响应时间 特性说明 OK 响应 +CEER: OK 响应 OK 或者 ERROR 若出现任何错误与 ME 相关： +CME ERROR: 响应 +CEER:, OK 或者 +CEER: , OK 或者 +CEER: ,, OK 或者 ERROR 若出现任何错误与 ME 相关： +CME ERROR: 300 毫秒 该命令立即生效。 参数配置自动保存。 参数 整型。AT+CEER 响应格式。 0 响应格式为+CEER: , 1 响应格式为+CEER: , 整型。错误位置 ID。 整型。数字类型错误码。 上海移远通信技术股份有限公司 49 / 279 LTE Standard(U)系列 AT 命令手册 字符串类型错误码。 字符串类型。错误码分类。 错误码。详情参考第 14.5 章。 备注 1. EC200D 系列模块暂不支持该命令。 2. ECx00G、EGx00G 系列和 EG915G-EU 模块暂不支持通话。 4.3. AT+QINDCFG 控制 URC 上报 该命令用于控制 URC 的上报。 AT+QINDCFG 控制 URC 上报 测试命令 AT+QINDCFG=? 响应 +QINDCFG: 'all',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'csq',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'act',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'smsfull',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'smsincoming',(支持的列表),(支持 的列表) +QINDCFG: 'ring',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'psm',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'rach',( 支 持 的 列 表 ),( 支 持 的 列表) 设置命令 AT+QINDCFG=[,[ ,]] OK 响应 若省略可选参数，则查询当前配置： +QINDCFG: , OK 若指定任意可选参数，则配置 URC 的上报： OK 上海移远通信技术股份有限公司 50 / 279 最大响应时间 特性说明 参数 LTE Standard(U)系列 AT 命令手册 或者 ERROR 若出现任何错误与 ME 相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置是否保存取决于。 字符串类型。URC 类型。 'all' 是否上报所有类型的 URC。默认打开。 'csq' 信号强度和信道误码率变化指示（类似 AT+CSQ）。默认关闭。 若配置为打开，将上报 URC：+QIND: 'csq',, 'act' 网络访问技术变化指示。默认关闭。如果配置为打开，则将上报 URC：+QIND: 'act',。 是字符串类型。取值如下：: 'GSM' 'EGPRS' 'WCDMA' 'LTE' 'HSDPA' 'HSUPA' 'HSDPA&HSUPA' 'UNKNOWN' 例如： +QIND: 'act','LTE' +QIND: 'act','UNKNOWN' 'act'的描述如下： 1. 若模块未注册网络，则为'UNKNOWN'。 2. 如果配置为打开，则将立即上报'act'的 URC。仅当网络访问 技术发生变化时，才会上报新的 URC。 'smsfull' 短消息存储已满指示。默认关闭。若配置为打开，将上报 URC： +QIND: 'smsfull', 'smsincoming' 新消息指示。默认打开。相关 URC 为：+CMTI、+CMT、+CDS 'ring' RING 指示。默认打开。 'psm' PSM 指示。默认打开。 在进入 PSM 休眠时将上报 URC：+QIND: ENTER PSM 在 PSM 唤醒时将上报 URC：+QIND: EXIT PSM 'rach' 随机接入结果指示。默认关闭。如果配置为打开，则将上报 URC： +QIND:'rach',,,,,, 上海移远通信技术股份有限公司 51 / 279 LTE Standard(U)系列 AT 命令手册 字符串类型。取值如下： 'GSM' 'WCDMA' 'LTE' 整型。表示随机接入的结果，0 表示成功，其它参数均 表示失败。 ,,, 不同服务模式对应的 参数，参见下表。 'GSM' 'WCDMA' 'LTE' 整型。绝对无线频道编号。 整型。基站识别码。 字符串类型。十六进制格式的两字节位置区号。 字符串类型。十六进制格式的四字节。 整型。UTRA 绝对无线频率信道。 整型。小区主扰码。 整型。E-UTRA 绝对射频信道号。 整型。物理小区标识。 字符串型类型。十六进制格式的两字节跟踪区号。 整型。打开/关闭指定 URC 的上报。 0 关闭 1 打开 整型。是否将参数配置保存至 NVRAM。 0 不保存 1 保存 错误码。详情参考第 14.5 章。 备注 1. EC200D 系列模块暂不支持配置 URC 类型'psm'。 2. ECx00G、ECx00U、EGx00G、EG91xU 系列和 EG915G-EU 模块暂不支持配置 URC 类型'rach'。 3. 针对 ECx00G、EGx00G 系列，仅支持 VoLTE 功能的模块支持配置 URC 类型'ring'；EG915G-EU 暂不支持支持配置 URC 类型'ring'。 上海移远通信技术股份有限公司 52 / 279 LTE Standard(U)系列 AT 命令手册 4.4. AT+QRDY 查询初始化状态 该命令用于查询模块开机时的初始化状态。 AT+QRDY 查询初始化状态 查询命令 AT+QRDY? 响应 +QRDY: 最大响应时间 特性说明 OK 300 毫秒 / 参数 十六进制数字。模块开机时初始化状态。 0x0 协议栈初始化完成 0x1 蓝牙功能初始化完成 0x2 音频功能初始化完成 0x3 Wi-Fi 功能初始化完成 0x4 休眠功能初始化完成 0xffff 开机初始化完成 备注 1. 指定功能初始化完成后，方可执行该功能相关 AT 命令。模块开机初始化完成后，可执行所有功能相 关 AT 命令。 2. EC200D 系列模块暂不支持该命令。 举例 AT+QRDY? +QRDY: 0xffff OK //开机初始化完成 上海移远通信技术股份有限公司 53 / 279 4.5. AT+QCFG 扩展命令 LTE Standard(U)系列 AT 命令手册 AT+QCFG 扩展命令 测试命令 AT+QCFG=? +QCFG: 'nwscanmode',(支持的列表),(支持 的列表) +QCFG: 'nwscanmodeex', (支持的列表) +QCFG: 'band',(支持的列表),(支持的列表),(支持的列表) +QCFG: 'creg/emergency',(支持的列表) +QCFG: 'qoos',(支持的列表),(支持的范 围),(支持的范围),(支持的范围) +QCFG: 'airplanecontrol',(支持的列表) +QCFG: 'usbnet',(支持的列表) +QCFG: 'nat/cid',(支持的列表) +QCFG='nat/subnet',(支持的列表),,< subnet_mask> +QCFG: 'usbnetmac', +QCFG: 'urc/ri/other',(支持的列表),(支持的范围),(支持的范围) +QCFG: 'urc/ri/smsincoming',(支持的列表),(支 持的范围),(支持的范围) +QCFG: 'urc/ri/ring',(支持的列表),(支持的范围),(支持的范围) +QCFG: 'urc/delay',(支持的范围) +QCFG: 'urc/cache',(支持的范围) +QCFG: 'risignaltype',(支持的列表) +QCFG='apready',(支持的列表),(支持的 列表) +QCFG: 'cmux/urcport',(支持的范围) +QCFG: 'fota/cid',(支持的范围) +QCFG: 'fota/times',(支持的范围),(支持的范围),(支持的范围) +QCFG: 'fota/path', +QCFG: 'pkalive/ip',(支持的列表) ,,(支持的范围) +QCFG: 'ledmode',(支持的范围) +QCFG: 'led/sim',(支持的列表) +QCFG: 'tone/incoming',(支持的范围) +QCFG: 'sleepind/level',(支持的列表) +QCFG: 'wakeupin/level',(支持的列表),(支持的列表) +QCFG: 'ntp',(支持的范围),(支持的范围) 上海移远通信技术股份有限公司 54 / 279 最大响应时间 特性说明 LTE Standard(U)系列 AT 命令手册 +QCFG: 'urc/interval',(支持的列表),(支持的范围),(支持的范围) +QCFG: 'esmfail/times',(支持的范围) … OK 300 毫秒 / 备注 以上仅展示命令响应的示例。命令的实际响应结果由使用的模块决定。 4.5.1. AT+QCFG='nwscanmode' 配置网络制式 该命令用于配置搜索的网络制式。 AT+QCFG='nwscanmode' 配置网络制式 设置命令 AT+QCFG='nwscanmode'[,[,]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'nwscanmode', OK 若指定任意可选参数，则配置网络制式： OK 或 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 决定命令生效方式。 参数配置自动保存。 参数 整型。网络制式。 ECx00U 系列、EGx00U、EG91xU 系列模块支持的制式如下： 上海移远通信技术股份有限公司 55 / 279 LTE Standard(U)系列 AT 命令手册 0 自动（GSM/LTE） 1 仅 GSM 3 仅 LTE EC200D 系列模块支持的制式如下： 0 自动（WCDMA/LTE） 2 仅 WCDMA 3 仅 LTE ECx00G、EGx00G 系列和 EG915G-EU 模块支持的制式如下： 3 仅 LTE 整型。命令生效方式。 0 UE 重启后生效 1 立即生效 错误码。详情参考第 14.5 章。 备注 对于网络制式只支持 LTE 的模块，仅取默认值 3。 4.5.2. AT+QCFG='nwscanmodeex' 配置网络搜索模式 AT+QCFG='nwscanmodeex' 配置网络搜索模式 设置命令 AT+QCFG='nwscanmodeex'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'nwscanmodeex', OK 最大响应时间 特性说明 若指定可选参数，则配置网络搜索模式： OK 或 ERROR 300毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。网络搜索模式。范围：4、8、12、16、20、24和28。 4 仅GSM 8 仅WCDMA 上海移远通信技术股份有限公司 56 / 279 LTE Standard(U)系列 AT 命令手册 12 GSM + WCDMA 16 仅LTE 20 GSM + LTE 24 WCDMA + LTE 28 GSM + WCDMA + LTE 备注 1. 当 Bit 2，Bit 3 和 Bit 4 设置为 1 时，对应 AT+QCFG='nwscanmode'参数=0。 Bit 2：GSM Bit 3：WCDMA Bit 4：LTE 例如，如需配置网络搜索模式为 LTE only，则参数设置为 16，对应 16 进制数 0001 0000。 2. 该命令仅适用于 EC200D 系列模块。 举例 AT+QCFG='nwscanmodeex',28 OK AT+QCFG='nwscanmodeex' +QCFG: 'nwscanmode',28 OK //28 对应 16 进制数为 0001 1100。配置网络搜索模式为 GSM, WCDMA, LTE。 //查询当前配置。 4.5.3. AT+QCFG='band' 配置网络搜索频段 该命令指定 UE 的网络搜索频段。 AT+QCFG='band' 配置网络搜索频段 设置命令 响应 AT+QCFG='band'[,,[,]] +QCFG: 'band',, OK 若指定任意可选参数，则配置网络搜索频段： OK 或 ERROR 若错误与 ME 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 57 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 决定命令生效方式。 参数配置自动保存。 参数 十六进制数字。该值指定 GSM 和 WCDMA 的频段。若设置为 0，则表示不改变 GSM 和 WCDMA 的频段。 例：00000003 = 00000001 (EGSM900) + 00000002 (DCS1800) 00000000 不改变 00000001 EGSM900 00000002 DCS1800 00000004 GSM850 00000008 PCS1900 EC200D 系列模块还支持以下取值： 00000010 WCDMA 2100 00000020 WCDMA 1900 00000040 WCDMA 850 00000080 WCDMA 900 00000100 WCDMA 800 00000200 WCDMA 1700 0000FFFF GSM&WCDMA 全频段 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持 GSM 和 WCDMA 的频段，只能设 置为 0。 十六进制数字。该值指定 LTE 的频段。若设置为 0，则表示不改变 LTE 的频段。 例：0x15 = 0x1 (LTE B1) + 0x4 (LTE B3) + 0x10 (LTE B5) 0 不改变 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x2 (CM_BAND_PREF_LTE_EUTRAN_BAND2) LTE B2 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x8 (CM_BAND_PREF_LTE_EUTRAN_BAND4) LTE B4 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x40 (CM_BAND_PREF_LTE_EUTRAN_BAND7) LTE B7 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 0x80000 (CM_BAND_PREF_LTE_EUTRAN_BAND20) LTE B20 0x8000000 (CM_BAND_PREF_LTE_EUTRAN_BAND28) LTE B28 0x200000000 (CM_BAND_PREF_LTE_EUTRAN_BAND34) LTE B34 0x2000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND38) LTE B38 0x4000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND39) LTE B39 0x8000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND40) LTE B40 0x10000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND41) LTE B41 0x20000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND66) LTE B66 0x7FFFFFFFFFFFFFFF (CM_BAND_PREF_ANY) 全频段 上海移远通信技术股份有限公司 58 / 279 LTE Standard(U)系列 AT 命令手册 整型。命令生效方式。 0 UE 重启后生效 1 立即生效 错误码。详情参考第 14.5 章。 备注 1. 上述只提供命令响应的一个例子。不同的命令响应根据实际模块使用来决定。 2. 模块实际支持的频段详情请参考各模块的产品规格书。 4.5.4. AT+QCFG='creg/emergency' 配置 emergency 网络信息显示 该命令用于配置在 emergency 下是否显示网络信息。 AT+QCFG='creg/emergency' 配置 emergency 网络信息显示 执行命令 AT+QCFG='creg/emergency'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'creg/emergency', OK 若指定配置参数，则配置在 emergency 下是否显示网络信息： OK 或 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。使能或禁止 emergency 下的网络信息显示。 0 emergency 下不显示网络信息 1 emergency 下显示网络信息 错误码。详情参考第 14.5 章。 上海移远通信技术股份有限公司 59 / 279 LTE Standard(U)系列 AT 命令手册 4.5.5. AT+QCFG='qoos' 配置 OOS 状态下搜网定时器信息 该命令用于配置 OOS 状态下无网定时器和限制服务定时器相关参数。 AT+QCFG='qoos' 配置 OOS 状态下搜网定时器信息 设置命令 AT+QCFG='qoos'[,[,[, [,]]]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'qoos',,,, OK 最大响应时间 特性说明 若指定任意可选参数，配置 OOS 状态下无网定时器和限制服 务定时器信息： OK 或 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。OOS 使能机制。 0 关闭 OOS 机制，无网或限制服务时，按照默认逻辑搜网。 1 打开 OOS 机制，仅在无网服务时进行 OOS 搜网。 2 打开 OOS 机制，在无网或限制服务下进行 OOS 搜网。 整型。定时器初始时长。范围：0~255；单位：秒；默认值：0。 整型。循环次数。范围：0~255；默认值：0。 整型。定时器最大时长。范围：0~255；单位：分钟；默认值：60。 错误码。详情参考第 14.5 章。 备注 1. 当设置为 0 时，省略定时器配置参数、和。 2. 为 1，为 0 时，按照默认逻辑搜网。 3. 为非 0，为 0 或省略时，定时器时长将保持。 4. 与为非 0 时，必须大于。当大于时，循环次数达 到后，定时器下次启动时长为本次时长的 2 倍，最大不会超过；若省略， 最大时长不超过 1 小时。 5. 查询配置时，若为 0，、和参数会被省略。 6. 默认定时器时长设置逻辑：无网定时器时长固定为 12 秒，限制服务定时器第一次时长为 12 秒，重 复 5 次之后并且小区未变化，定时器时长固定为 1 小时。 7. EC200D 系列模块暂不支持该命令。 上海移远通信技术股份有限公司 60 / 279 举例 AT+QCFG='qoos',2,20,5,60 OK AT+QCFG='qoos',1,30,3,50 OK AT+QCFG='qoos',0 OK LTE Standard(U)系列 AT 命令手册 //设置无网和限制服务定时器初始时长 20 秒，循环 5 次，最大时 长为 60 分钟。 //设置无网定时器初始时长30秒，循环3次，最大时长为50分钟。 //关闭OOS机制，无网和限制服务定时器按照默认逻辑执行。 4.5.6. AT+QCFG='airplanecontrol' 开启/关闭飞行模式控制 该命令用于开启/关闭飞行模式控制功能。 AT+QCFG='airplanecontrol' 开启/关闭飞行模式控制 设置命令 AT+QCFG='airplanecontrol'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'airplanecontrol',, OK 若指定可选参数，则开启/关闭飞行模式控制： OK 或 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。开启/关闭飞行模式控制功能。 0 关闭飞行模式控制功能 1 开启飞行模式控制功能 整型。飞行模式状态。 0 当前不处于飞行模式 1 当前处于飞行模式 错误码。详情参考第 14.5 章。 上海移远通信技术股份有限公司 61 / 279 LTE Standard(U)系列 AT 命令手册 备注 1. 开启飞行模式控制后，当 W_DISABLE#引脚改变时，输出 URC +QIND: airplanestatus,。 2. 开启飞行模式控制后，W_DISABLE#引脚拉低，将进入飞行模式；W_DISABLE#引脚拉高，将退出飞 行模式；在 W_DISABLE#引脚为低电平的状态下，执行 AT+CFUN=1，会返回 ERROR，禁止退出飞 行模式。 3. 开启飞行模式控制后，模块开机会先检测 W_DISABLE#引脚的电平；如果为低电平，模块会立刻进 入飞行模式。 4. 参考相应模块的硬件设计手册获取更多关于 W_DISABLE#引脚的详情。 5. EC200D 系列模块暂不支持该命令。 举例 AT+QCFG='airplanecontrol' +QCFG: 'airplanecontrol',0,0 //返回当前飞行模式功能配置。 OK AT+QCFG='airplanecontrol',1 OK //拉低 W_DISABLE#引脚 +QIND: airplanestatus,1 AT+CFUN? +CFUN: 4 //开启飞行模式控制功能。 //由于 W_DISABLE#引脚拉低，此时进入飞行模式。 //处于飞行模式。 OK //拉高 W_DISABLE#引脚 +QIND: airplanestatus,0 AT+CFUN? +CFUN: 1 //由于 W_DISABLE#引脚拉高，此时退出飞行模式。 //处于全功能模式。 OK 4.5.7. AT+QCFG='usbnet' 配置 USB 网络端口协议 该命令用于配置 USB 网络端口使用的协议。 AT+QCFG='usbnet' 配置 USB 网络端口协议 设置命令 AT+QCFG='usbnet'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'usbnet', OK 上海移远通信技术股份有限公司 62 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 若指定可选参数，则配置 USB 网络端口协议： OK 或 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效。 参数配置自动保存。 参数 整型。USB 网络端口使用的协议。 1 ECM 3 RNDIS 错误码。详情参考第 14.5 章。 4.5.8. AT+QCFG='nat/cid' 开启 PDP 上下文的 NAT 功能 该命令用于开启指定 PDP 上下文的 NAT 功能。 AT+QCFG='nat/cid' 开启 PDP 上下文的 NAT 功能 设置命令 AT+QCFG='nat/cid'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'nat/cid', OK 若指定可选参数，则开启指定 PDP 上下文的 NAT 功能： OK 或 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效。 参数配置自动保存。 上海移远通信技术股份有限公司 63 / 279 LTE Standard(U)系列 AT 命令手册 参数 十六进制类型。每一位代表 PDP 的 NAT 功能是否开启。 该值以 32 位表示，低 16 位中的位[0:6]分别代表 SIM0 的 PDP CID1~PDP CID7，高 16 位中的 位[16:22]分别代表 SIM1 的 PDP CID1~ PDP CID7。每张(U)SIM 卡最多支持 7 路 PDP。 针对 EC200D 系列模块，低 16 位中的位[0:10]分别代表 SIM0 的 PDP CID1~PDP CID11,高 16 位中的位[16:26]分别代表 SIM1 的 PDP CID1~PDP CID11。 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块每张 USIM 卡最多支持 11 路 PDP。 举例 AT+QCFG='nat/cid' +QCFG: 'nat/cid',0x0 //查询当前配置。 OK AT+QCFG='nat/cid',0x10005 OK //使能 SIM0 的 PDP CID1 和 CID 3 NAT；使能 SIM1 的 PDP CID1 NAT。 4.5.9. AT+QCFG='nat/subnet' 配置 PDP 上下文的 NAT 子网参数 该命令用于配置 PDP 上下文的 NAT 子网参数。 AT+QCFG='nat/subnet' 配置 PDP 上下文的 NAT 子网参数 设置命令 AT+QCFG='nat/subnet'[,,[,]] 响应 若省略所有可选参数，则查询当前配置： +QCFG: 'nat/subnet',,, OK 若仅指定可选参数，则删除指定 PDP 上下文的 NAT 子 网参数配置： OK 或 ERROR 若指定所有可选参数，则配置指定 PDP 上下文的 NAT 子网参 上海移远通信技术股份有限公司 64 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 数： OK 或 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效。 参数配置自动保存。 参数 整型。场景 ID。范围：1~7。 字符串类型。NAT 子网地址。 字符串类型。NAT 子网掩码。 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 4.5.10. AT+QCFG='usbnetmac' 配置 USB 网卡的 MAC 地址 该命令用来配置USB网卡的MAC地址。 AT+QCFG='usbnetmac' 配置 USB 网卡的 MAC 地址 设置命令 AT+QCFG='usbnetmac'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'usbnetmac', OK 特性说明 若指定可选参数，则配置 USB 网卡的 MAC 地址： OK 或 ERROR 该命令重启后生效。 参数配置自动保存。 上海移远通信技术股份有限公司 65 / 279 LTE Standard(U)系列 AT 命令手册 参数 字符串类型。USB 网卡需要配置的 MAC 地址，6 个字节，其中每个字节间以:分割开。 备注 配置该命令后，模块 OS 重启会读出相应的 MAC 地址，并配置到 USB 网卡。如果没有配置该命令或者 该命令配置不成功，模块 OS 没有读出相应的 MAC 地址，OS 会使用默认的 MAC 配置 USB 网卡。 举例 AT+QCFG='usbnetmac',AE:0C:29:00:31:1B OK AT+QCFG ='usbnetmac' +QCFG: 'usbnetmac',AE:0C:29:00:31:1B OK //配置 USB 网卡 MAC 地址 //查询 USB 网卡 MAC 地址 4.5.11. AT+QCFG='urc/ri/other' 指定通用 URC RI 行为 该命令用于指定通用 URC 出现时的 RI 行为。 AT+QCFG='urc/ri/other' 指定通用 URC RI 行为 设置命令 AT+QCFG='urc/ri/other'[,[,[,]]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'urc/ri/other',,, OK 若指定任意可选参数，则指定通用 URC RI 行为： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 66 / 279 LTE Standard(U)系列 AT 命令手册 参数 字符串类型。通用 URC 出现时的 RI 行为。 'off 无 RI 行为 'pulse' 脉冲。RI 上产生的脉冲，脉冲周期由指定。 整型。脉冲周期。仅当配置为'pulse'时有效。范围：1~2000；默认值： 120；单位：毫秒。 整型。脉冲个数。仅当配置为'pulse'时有效。相邻两个脉冲之间的时间间 隔为。范围：1~5。 错误码。详情参考第 14.5 章。 4.5.12. AT+QCFG='urc/ri/smsincoming' 指定短信类 URC RI 行为 该命令用于指定短信类 URC 出现时的 RI 行为。 AT+QCFG='urc/ri/smsincoming' 指定短信类 URC RI 行为 设置命令 AT+QCFG='urc/ri/smsincoming'[,[,[,]]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'urc/ri/smsincoming',,, OK 若指定可选参数，则指定短信类 URC RI 行为： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。短信类 URC 出现时的 RI 行为。 'off 无 RI 行为 'pulse' 脉冲。RI 上产生的脉冲，脉冲周期由指定。 整型。脉冲周期。仅当配置为'pulse'时有效。范围：1~2000；默认值： 120；单位：毫秒。 整型。脉冲个数。仅当配置为'pulse'时有效。相邻两个脉冲之间的时间间 上海移远通信技术股份有限公司 67 / 279 隔为。范围：1~5。 错误码。详情参考第 14.5 章。 LTE Standard(U)系列 AT 命令手册 4.5.13. AT+QCFG='urc/ri/ring' 指定来电类 URC RI 行为 该命令用于指定来电类 URC 出现时的 RI 行为。 AT+QCFG='urc/ri/ring' 指定来电类 URC RI 行为 设置命令 AT+QCFG='urc/ri/ring'[,[,[,]]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'urc/ri/other',,, OK 若指定可选参数，则指定来电类 URC RI 行为： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。来电类 URC 出现时的 RI 行为。 'off 无 RI 行为 'pulse' 脉冲。RI 上产生的脉冲，脉冲周期由指定。 'atuo' 脉冲。振铃时输出 ring 的 URC 时，将 RI 拉低。退出振铃时将 RI 拉高。 整型。脉冲周期。仅当配置为'pulse'时有效。范围：1~2000；默认值： 120；单位：毫秒。 整型。脉冲个数。仅当配置为'pulse'时有效。相邻两个脉冲之间的时间间 隔为。范围：1~5。 错误码。详情参考第 14.5 章。 上海移远通信技术股份有限公司 68 / 279 LTE Standard(U)系列 AT 命令手册 4.5.14. AT+QCFG='urc/delay' 设置 RI 脉冲结束后 URC 上报的延迟时间 该命令用于设置 RI 脉冲结束后 URC 上报的延迟时间。 AT+QCFG='urc/delay' 设置 RI 脉冲结束后 URC 上报的延迟时间 设置命令 AT+QCFG='urc/delay'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'urc/delay', OK 若指定可选参数，则指定 RI 脉冲结束时 URC 延迟时间： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。RI 脉冲结束后 URC 上报的延迟时间。仅当 RI 脉冲大于等于 0 时有效。范围： 0~120；单位：毫秒；默认值：0，表示无延迟。 错误码。详情参考第 14.5 章。 4.5.15. AT+QCFG='urc/cache' 打开/关闭 URC 缓存 该命令用于打开/关闭 URC 缓存功能。 AT+QCFG='urc/cache' 打开/关闭 URC 缓存 设置命令 AT+QCFG='urc/cache'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'urc/cache', OK 若指定可选参数，则打开或关闭 URC 缓存功能： OK 或者 上海移远通信技术股份有限公司 69 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。打开/关闭 URC 缓存。打开 URC 缓存后，所有 URC 将会被缓存起来，直到关闭 URC 缓存功能后，URC 才会被输出。 0 关闭 URC 缓存 1 打开 URC 缓存 错误码。详情参考第 14.5 章。 4.5.16. AT+QCFG='risignaltype' 设置 RI 信号输出位置 该命令用于设置 RI 信号的输出位置。 AT+QCFG='risignaltype' 设置 RI 信号的输出位置 设置命令 AT+QCFG='risignaltype'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'risignaltype', OK 若指定可选参数，则设置 RI 信号输出位置： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 70 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。RI 信号输出位置。仅当 RI 脉冲配置值大于 0 时有效。 'respective' RI 信号输出到 URC 端口上。 如果 URC 输出到主串口上，则 RI 信号输出到主串口的 RI 引脚上； 如果 URC 输出到非主串口上，将不会有 RI 信号。 'physical' RI 信号输出到主串口的 RI 引脚上 错误码。详情参考第 14.5 章。 4.5.17. AT+QCFG='apready' 设置 AP_READY 引脚行为 该命令用于查询和设置 AP_READY 引脚行为。通过外部 MCU 可以根据需求更改 AP_READY 引脚的 有效电平。 当有 URC 需要上报时，如果 AP_READY 引脚电平无效，则先缓存 URC，再检测 AP_READY 引脚电 平。当 AP_READY 引脚电平变为有效时，将输出 URC。MAIN_RI 引脚上产生的脉冲信号仍然可以按照配 置的模式输出，脉冲信号不会被缓存。 AT+QCFG='apready' 设置 AP_Ready 引脚行为 设置命令 AT+QCFG='apready'[,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'apready',, OK 最大响应时间 特性说明 若指定可选参数，则设置 AP_Ready 引脚行为： OK 或 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。使能/禁用 AP_READY 引脚行为。 0 禁用 1 使能 整型。指示器引脚的有效电平。该参数仅在使能 AP_READY 检测功能时生效，指定 AP_READY 的默认电平。 0 低电平 1 高电平 上海移远通信技术股份有限公司 71 / 279 错误码。详情参考第 14.5 章。 LTE Standard(U)系列 AT 命令手册 备注 1. 最多缓存 120 条 URC，若超过 120 条，最先缓存的 URC 将会被新的 URC 覆盖。 2. 通话过程中只缓存一条 RING URC。 3. 模块是否支持该命令取决于是否存在相关硬件引脚，详情参见各模块的硬件设计手册。 4. EC800G-CN 模块不支持该命令。 举例 AT+QCFG='apready',1,0 OK AT+QCFG='apready' +QCFG: 'apready',1,0 OK 4.5.18. AT+QCFG='cmux/urcport' 设置 CMUX 口 URC 输出方式 该命令用于设置 CMUX 口 URC 的输出方式。 AT+QCFG='cmux/urcport' 设置 CMUX 口 URC 输出方式 设置命令 AT+QCFG='cmux/urcport'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'cmux/urcport', OK 若指定可选参数，则设置 CMUX 口 URC 输出方式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 72 / 279 参数 整型。CMUX 口 URC 输出方式。 0 输出到所有 CMUX 口 1 输出到所有 CMUX 1 2 输出到所有 CMUX 2 3 输出到所有 CMUX 3 4 输出到所有 CMUX 4 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 LTE Standard(U)系列 AT 命令手册 4.5.19. AT+QCFG='fota/cid' 配置 FOTA 下载 PDP 场景 ID 该命令用于配置 FOTA 下载所使用的 PDP 场景 ID。 AT+QCFG='fota/cid' 配置 FOTA 下载 PDP 场景 ID 设置命令 AT+QCFG='fota/cid'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'fota/cid', OK 若指定可选参数，则配置 FOTA 下载 PDP 场景 ID： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。场景 ID。范围：1~7；默认值：1。 错误码。详情参考第 14.5 章。 上海移远通信技术股份有限公司 73 / 279 备注 EC200D 系列模块暂不支持该命令。 LTE Standard(U)系列 AT 命令手册 4.5.20. AT+QCFG='fota/times' 配置 HTTP 方式 FOTA 下载信息 该命令用于配置 HTTP 方式 FOTA 下载的连接超时时间、出错重传次数和重传的时间间隔。 AT+QCFG='fota/times' 配置 HTTP 方式 FOTA 下载信息 设置命令 AT+QCFG='fota/times'[,[,[,]]] 响应 若省略可选参数，则查询当前配置： +QCFG:'fota/times',,, OK 若指定任意可选参数，则配置 HTTP 方式 FOTA 下载的连接 超时时间、出错重传次数和重传的时间间隔： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。HTTP 方式 FOTA 下载的连接超时时间。范围：1~120；默认值：60；单位：秒。 整型。HTTP 方式 FOTA 下载的出错重传次数。范围：1~24；默认值：6；单位：次。 整型。HTTP 方式 FOTA 下载的重传时间间隔。范围：1~120；默认值：6；单位：秒。 错误码。详情参考第 14.5 章。 上海移远通信技术股份有限公司 74 / 279 LTE Standard(U)系列 AT 命令手册 4.5.21. AT+QCFG='fota/path' 配置 FOTA 目标固件包的存储媒介 该命令用于配置 FOTA 目标固件包的存储媒介。 AT+QCFG='fota/path' 配置 FOTA 目标固件包的存储媒介 设置命令 AT+QCFG='fota/path'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'fota/path', OK 若指定可选参数，则配置 FOTA 目标固件包的存储媒介： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。存储媒介类型。有关不同模块支持的存储类型详情，请参考文档 [1]。 'UFS:' UFS。支持设置子目录。 'EFS:' 外置 Flash。支持设置子目录。 'SD:' SD 卡。只支持设置根目录。 错误码。详情参考第 14.5 章。 备注 1. EC200D 系列模块暂不支持该命令。 2. ECx00G、EGx00G 系列和 EG915G-EU 模块不支持 SD 卡。 4.5.22. AT+QCFG='pkalive/ip' 配置 PDP 保活参数 该命令主要用于配置 PDP 保活功能指定的远端 IP 与端口号。 上海移远通信技术股份有限公司 75 / 279 LTE Standard(U)系列 AT 命令手册 AT+QCFG='pkalive/ip' 配置 PDP 保活参数 设置命令 AT+QCFG='pkalive/ip',[,[,]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'pkalive/ip',,, OK 最大响应时间 特性说明 若指定任意可选参数，则配置 PDP 保活功能指定的远 端 IP 与端口号： OK 或 ERROR 300 毫秒 参数配置立即生效； 参数配置不保存。 默认值为：9 参数 整型。协议类型。 1 IPv4 2 IPv6 字符串类型。 为 1 时，的默认值为'216.239.57.155'，否则，响应 ERROR。 为 2 时，的默认值为'2000:0:0:0:1:2345:6789:abcd'，否则，响 应 ERROR。 整型。远程服务器端口。范围：0~65535；默认值：9。0 表示使用默认值。 备注 EC200D 系列模块暂不支持该命令。 举例 AT+QCFG='pkalive/ip',1,'216.239.57.155',9 //配置 PDP IPv4 场景下保活功能远端服务器 IP 地址 和端口号。 OK AT+QCFG='pkalive/ip',2,'2000:0:0:0:1:2345:6789:abcd',9 //配置 PDP IPv6 场景下保活功能 远端服务器 IP 地址和端口号。 OK 上海移远通信技术股份有限公司 76 / 279 LTE Standard(U)系列 AT 命令手册 4.5.23. AT+QCFG='ledmode' 配置网络状态灯（NET_STATUS）输出模式 该命令用于配置网络状态灯（NET_STATUS）输出模式。 AT+QCFG='ledmode' 配置网络状态灯输出模式 设置命令 AT+QCFG='ledmode'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'ledmode', OK 若指定可选参数，则配置网络状态灯输出模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。网络状态灯的输出模式。 0 modem 模式。默认闪烁方式。 1 Mini PCIe 模式。模块搜索到网络时，NET_STATUS 引脚输出为高电平，其它情况 下输出低电平。 错误码。详情参考第 14.5 章。 4.5.24. AT+QCFG='led/sim' 配置双卡双待下网络状态灯（NET_MODE 和 NET_STATUS） 指向的(U)SIM 卡 ID 该命令用于配置双卡双待下，网络状态灯（NET_MODE 和 NET_STATUS）指向的(U)SIM 卡 ID。 AT+QCFG='led/sim' 配置双卡双待下网络状态灯（NET_MODE 和 NET_STATUS）指向 的(U)SIM 卡 ID 设置命令 响应 AT+QCFG='led/sim'[,] 若省略可选参数，则查询当前配置： +QCFG: 'led/sim', OK 上海移远通信技术股份有限公司 77 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 若指定可选参数，则配置双卡双待下网络状态灯指向的 (U)SIM 卡 ID： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。(U)SIM 卡 ID。 0 (U)SIM1 1 (U)SIM2 错误码。详情参考第 14.5 章。 备注 针对 EC600G 系列模块，该命令可选，详情请咨询移远通信技术支持；EG700U-CN 和 EG700G-CN 模 块不支持该命令。 4.5.25. AT+QCFG='tone/incoming' 配置来电铃声 该命令用于配置来电铃声。 AT+QCFG='tone/incoming' 配置来电铃声 设置命令 响应 AT+QCFG='tone/incoming'[,] 若省略可选参数，则查询当前配置： +QCFG: 'tone/incoming', OK 若指定可选参数，则配置来电铃声： OK 或者 ERROR 若错误与 ME 功能相关： 上海移远通信技术股份有限公司 78 / 279 LTE Standard(U)系列 AT 命令手册 +CME ERROR: 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。来电铃声配置。 0 关闭来电铃声 2 使能来电铃声，铃声类型为 tone 音 3 使能来电铃声，铃声为用户自定义，需要将铃声改名为 CustRingTone.wav 并上传 到模块的文件系统 UFS 目录。 错误码。详情参考第 14.5 章。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 4.5.26. AT+QCFG='sleepind/level' 配置 SLEEP_IND 引脚的输出电平 该命令用于配置模块处于睡眠休眠时，SLEEP_IND 引脚的输出电平。 AT+QCFG ='sleepind/level' 配置 SLEEP_IND 引脚的输出电平 设置命令 AT+QCFG='sleepind/level'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'sleepind/level', OK 最大响应时间 特性说明 若指定可选参数，则配置 SLEEP_IND 引脚的输出电平： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 79 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。表示模块进入睡眠模式后 SLEEP_IND 的输出电平。 0 模块进入睡眠模式时，SLEEP_IND 引脚输出高电平 1 模块进入睡眠模式时，SLEEP_IND 引脚输出低电平 备注 模块是否支持该功能取决于是否存在相关硬件引脚，详情参见各模块的硬件设计手册。 4.5.27. AT+QCFG='wakeupin/level' 配置 WAKEUP_IN 引脚唤醒行为，加载/卸载 USB 该命令用于使能或禁止通过 WAKEUP_IN 引脚唤醒模块，以及加载/卸载 USB。 AT+QCFG='wakeupin/level' 配置 WAKEUP_IN 引脚唤醒行为 设置命令 AT+QCFG='wakeupin/level'[, [,]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'wakeupin/level',, OK 若指定任意可选参数，则配置是否通过 WAKEUP_IN 引脚唤醒 模块，以及是否加载/卸载 USB： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。触发动作的 WAKEUP_IN 引脚电平。 0 低电平 1 高电平 整型。当 WAKEUP_IN 引脚为指定电平时触发的动作。 0 无任何动作 1 若为 0，WAKEUP_IN 引脚低电平时唤醒模块，高电平时允许模块进入睡眠 若为 1，WAKEUP_IN 引脚高电平时唤醒模块，低电平时允许模块进入睡眠 2 若为 0，WAKEUP_IN 引脚低电平时加载 USB，高电平时卸载 USB 上海移远通信技术股份有限公司 80 / 279 LTE Standard(U)系列 AT 命令手册 若为 1，WAKEUP_IN 引脚高电平时加载 USB，低电平时卸载 USB 3 若为 0，WAKEUP_IN 引脚低电平时唤醒模块并加载 USB，高电平时允许模块 进入睡眠并卸载 USB 若为 1，WAKEUP_IN 引脚高电平时唤醒模块并加载 USB，低电平时允许模块 进入休眠并卸载 USB 备注 1. 模块是否支持该功能取决于是否存在相关硬件引脚，详情参见各模块的硬件设计手册。 2. EC200D 系列模块仅支持取值为 0 和 1。 举例 AT+QCFG='wakeupin/level',0,1 OK AT+QCFG='wakeupin/level' +QCFG: 'wakeupin/level',0,1 //设置 WAKEUP_IN 引脚为低电平时唤醒模块。 //查询当前配置。 OK 4.5.28. AT+QCFG='ntp' 配置 NTP 最大重传次数和间隔 该命令用于配置 NTP 最大重传次数和间隔。 AT+QCFG='ntp' 配置 NTP 最大重传次数和间隔 设置命令 AT+QCFG='ntp'[,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'ntp',, OK 最大响应时间 特性说明 若指定可选参数，则配置 NTP 最大重传次数和间隔： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 81 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。NTP 重传次数。范围：1~10；默认值：3。 整型。NTP 重传间隔。范围：5~60；默认值：15。单位：秒。 举例 AT+QCFG='ntp' +QCFG: 'ntp',3,15 //查询当前配置。 OK AT+QCFG='ntp',5,20 OK AT+QCFG='ntp' +QCFG: 'ntp',5,20 //设置 NTP 最大重传次数和间隔。 //查询当前配置。 OK 4.5.29. AT+QCFG='esmfail/times' 设置注册 LTE 最大连续失败次数并回落到 GSM 网 络 在 Data Centric 模式下，该命令用于设置模块注册 LTE 连续失败达到指定次数时会回落到 GSM 网络。 该命令只对支持 GSM 的模块有效。 AT+QCFG='esmfail/times' 设置注册 LTE 最大连续失败次数并回落到 GSM 网络 设置命令 AT+QCFG='esmfail/times'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'esmfail/times', OK 若指定可选参数，则设置模块注册 LTE 最大连续失败次数： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 82 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。模块注册 LTE 最大连续失败次数。范围：0~5；默认值：5。当为 0 时，表示 模块注册 LTE 失败后不会回落到 GSM 网络。 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 举例 AT+QCFG=? +QCFG: 'esmfail/times',(0-5) OK AT+QCFG='esmfail/times',4 OK AT+QCFG='esmfail/times' +QCFG: 'esmfail/times',4 OK 4.5.30. AT+QCFG='rtc/cfg' 设置 RTC 启动配置 该命令用于设置 RTC 启动配置。 AT+QCFG='rtc/cfg' 设置 RTC 启动配置 设置命令 AT+QCFG='rtc/cfg'[,,< RTC_enable>,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'rtc/cfg',,,, OK 最大响应时间 特性说明 若指定可选参数，则设置 RTC 启动配置： OK 或者 ERROR 300 毫秒 该命令在模块重启后生效； 上海移远通信技术股份有限公司 83 / 279 LTE Standard(U)系列 AT 命令手册 参数配置自动保存。 参数 整型。是否将 NV 保存的时间作为 RTC 初始值。 0 否 1 是 整型。是否将 RTC 寄存器的时间作为 RTC 初始值。 0 否 1 是 整型。连接基站后，是否同步基站时间到 RTC 时间。 0 不同步 1 同步 整型。注网后的时区配置。 0 注网后，更新为网络时区 1 注网后，保持原有时区 2 注网后，重置时区为 0 举例 AT+QCFG='rtc/cfg' +QCFG: 'rtc/cfg',0,0,1,0 OK AT+QCFG='rtc/cfg',1,1,1,1 OK 4.5.31. AT+QCFG='pdn/pco' 配置 PDN 请求中的 PCO 在模块驻网附着时是否携带加 密信元 该命令用于配置 PDN 请求中的 PCO 在模块驻网附着时是否携带加密信元。 AT+QCFG='pdn/pco' 测试命令 AT+QCFG=? 配置 PDN 请求中的 PCO 在模块驻网附着时是否携带加密信元 响应 +QCFG: 'pdn/pco',(支持的列表) … 设置命令 AT+QCFG='pdn/pco'[,] OK 响应 若省略可选参数，该查询当前配置： +QCFG: 'pdn/pco', 上海移远通信技术股份有限公司 84 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 OK 若指定可选参数，则配置 PDN 请求中的 PCO 在驻网附着时是 否携带加密信元： OK 或者 ERROR 若出现任何错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效。 参数配置掉电后保存。 参数 整型。配置 PDN 请求中的 PCO 在模块驻网附着时是否携带加密信元。 0 携带 1 不携带 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 举例 AT+QCFG='pdn/pco' +QCFG: 'pdn/pco',0 OK AT+QCFG='pdn/pco',1 OK AT+QCFG='pdn/pco' +QCFG: 'pdn/pco',1 OK 上海移远通信技术股份有限公司 85 / 279 LTE Standard(U)系列 AT 命令手册 5 (U)SIM 卡相关命令 5.1. AT+CIMI 查询 IMSI 该命令用于查询(U)SIM 卡的国际移动用户识别码（IMSI），IMSI 允许 TE 识别 MT 中的(U)SIM 卡或 UICC（GSM 或者(U)SIM）中的活动应用程序。 AT+CIMI 查询 IMSI 测试命令 AT+CIMI=? 执行命令 AT+CIMI 响应 OK 响应 TA 返回，识别 MT 中的(U)SIM 卡。 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。国际移动用户识别码（无双引号的字符串）。 错误码。详情参考第 14.5 章。 举例 AT+CIMI 460023210226023 OK //查询 MT 中的(U)SIM 卡的 IMSI。 上海移远通信技术股份有限公司 86 / 279 LTE Standard(U)系列 AT 命令手册 5.2. AT+CLCK 功能锁定 该命令用于锁定、解锁 MT 或者网络功能，以及查询锁定状态。当正在设置或查询网络功能时，可中止 该命令。设置命令中，通常不可省略。当查询网络服务状态（为 2）时，若所有 类型的服务状态未激活，则命令响应行返回未激活的情况。 AT+CLCK 功能锁定 测试命令 AT+CLCK=? 响应 +CLCK: (支持的列表) 设置命令 AT+CLCK=,[, [,]] OK 响应 当不等于 2 且命令执行成功： OK 当等于 2 且命令执行成功： +CLCK: [,] [+CLCK: [,]] […] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 5秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。 'SC' (U)SIM（锁定卡槽中当前所选的(U)SIM/UICC 卡）。(U)SIM/UICC 在 MT 开机且执 行锁定命令时需要一个密码。 'AO' BAOC（禁止所有呼出，详情参考 3GPP TS 22.088） 'OI' BOIC（禁止所有国际呼出，详情参考 3GPP TS 22.088） 'OX' BOIC-exHC（禁止所有国际呼出，归属国除外，详情参考 3GPP TS 22.088） ''AI'' BAIC（禁止所有呼入，详情参考 3GPP TS 22.088） ''IR'' BIC-Roam（归属地以外漫游时，禁止所有呼入，详情参考 3GPP TS 22.088 ） ''AB'' 禁止所有业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 ''AC'' 禁止呼入业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 ''AG'' 禁止呼出业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 'FD' UICC（GSM 或(U)SIM）固定拨号存储器功能中的(U)SIM 卡或活动应用程序（若 当前会话中 PIN2 未完成身份验证，则需在中输入 PIN2）。 上海移远通信技术股份有限公司 87 / 279 LTE Standard(U)系列 AT 命令手册 整型。操作模式。 0 解锁 1 锁定 2 查询状态 字符串类型。密码。 整型。数据类别。 1 语音 2 数据 4 传真 7 短消息以外所有电话通讯 8 短消息 16 数据线路同步 32 数据线路异步 整型。业务状态。 0 打开 1 关闭 备注 参数取值'AI'、'IR'、'AB'、'AC'和'AG'仅适用于 EC200D 系列模块。 举例 AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK //查询(U)SIM 卡状态。 //(U)SIM 卡未被锁定。 //锁定(U)SIM 卡，且密码为'1234'。 //查询(U)SIM 卡状态。 //(U)SIM 卡被锁定。 //解锁(U)SIM 卡。 5.3. AT+CPIN PIN 管理 该命令用于向 MT 发送操作需要的密码或查询 MT 在操作前是否需要输入密码，密码可为(U)SIM PIN、 (U)SIM PUK 等。 上海移远通信技术股份有限公司 88 / 279 LTE Standard(U)系列 AT 命令手册 查询命令返回字母数字字符串，指示是否需要密码。 MT 存储了操作前所需的密码，例如(U)SIM PIN 或(U)SIM PUK。如果要输入两次 PIN，MT 将自动重 复输入 PIN。如果没有 PIN 请求待处理，则不会采取任何措施，并且将返回+CME ERROR 给 TE。当 MT PIN 的类型为 SIM PIN/SIM PUK 等时，MT 处于限制功能模式，需要通过设置命令发送密码给模块来解锁， 解锁成功后返回 OK，MT 解除限制模式。当 MT 不在限制模式时，设置命令发送密码则会报错。 如果 MT PIN 的类型为 SIM PUK 或 SIM PUK2，则需要输入第二个参数，用于替换(U)SIM 中旧的 PIN 码。 AT+CPIN PIN 管理 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 +CPIN: 设置命令 AT+CPIN=[,] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 5秒 该命令立即生效； 参数配置自动保存。 参数 无引号的字符串类型。表示需要的密码类型。 READY 无密码等待输入 MT SIM PIN MT 正在等待(U)SIM PIN SIM PUK MT 正在等待(U)SIM PUK SIM PIN2 MT 正在等待(U)SIM PIN2 SIM PUK2 MT 正在等待(U)SIM PUK2 字符串类型。密码。请求的密码类型为 PUK，例如(U)SIM PUK1 或者其他密码，则必须输 入。 字符串类型。新密码。若请求的密码类型为 PUK，则需要重新输入新密码。 举例 //输入 PIN AT+CPIN? +CPIN: SIM PIN //查询有 PIN 码锁定。 上海移远通信技术股份有限公司 89 / 279 OK AT+CPIN='1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //输入 PUK 和 PIN AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //输入 PIN。 LTE Standard(U)系列 AT 命令手册 //已输入 PIN 码。 //正在等待输入(U)SIM PUK 码。 //输入 PUK 码和新密码。 //已输入 PUK 码。 5.4. AT+CPWD 修改密码 该命令用于修改 AT+CLCK 定义的功能锁定密码。测试命令返回两个参数，分别列出可用的功能及其 密码的最大长度。 AT+CPWD 修改密码 测试命令 AT+CPWD=? 响应 +CPWD: ('SC',8),('P2',8) 设置命令 AT+CPWD=,, OK 响应 OK 最大响应时间 5秒 特性说明 参考 该命令立即生效； 参数配置自动保存。 3GPP TS 27.007 上海移远通信技术股份有限公司 90 / 279 LTE Standard(U)系列 AT 命令手册 参数 字符串类型。 'SC' (U)SIM（锁定卡槽中当前所选的(U)SIM/UICC 卡）。(U)SIM/UICC 在 MT 开机且 执行锁定命令时需要一个密码。 'P2' (U)SIM PIN2 整型。密码最大长度。 字符串类型。从用户界面或使用该命令指定的密码。 字符串类型。新密码。 举例 AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' OK //重启模块或重新激活(U)SIM 卡。 AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='4321' OK +CPIN: READY //修改(U)SIM 卡密码为'4321'。 //正在等待输入(U)SIM PIN 码。 //必须输入 PIN 码以定义新密码'4321'。 5.5. AT+CSIM (U)SIM 卡访问 该命令允许通过 TE 上的远程应用直接控制安装在当前所选卡槽中的(U)SIM 卡。而且 TE 应在 GSM 指定的帧内处理(U)SIM 信息。 AT+CSIM (U)SIM 卡访问 测试命令 AT+CSIM=? 设置命令 AT+CSIM=, 响应 OK 响应 +CSIM: , OK 或者 ERROR 上海移远通信技术股份有限公司 91 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。或字符串的长度。 十六进制字符串类型。MT 发送至(U)SIM 卡的命令，格式参考 3GPP TS 51.011。 字符串类型。(U)SIM 卡向 MT 发送的响应，格式参考 3GPP TS 51.011。 错误码。详情参考第 14.5 章。 5.6. AT+CRSM (U)SIM 卡受限访问 该命令可以对(U)SIM 数据库的进行简单而有限的访问，用于向 MT 传输(U)SIM 命令（） 及其所需的参数。 AT+CRSM (U)SIM 卡受限访问 测试命令 响应 AT+CRSM=? 设置命令 OK 响应 AT+CRSM=[,[,,,[,][,]]] +CRSM: ,[,] OK 或者 ERROR 最大响应时间 特性说明 参考 GSM 07.07 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 92 / 279 LTE Standard(U)系列 AT 命令手册 参数 , , , 整型。(U)SIM 命令。 176 READ BINARY（读取二进制文件） 178 READ RECORD（读取记录内容） 192 GET RESPONSE（获取响应） 214 UPDATE BINARY（更新二进制文件） 220 UPDATE RECORD（更新记录内容） 242 STATUS（状态查询） 整型。对于来说，它是(U)SIM 上基本数据文件的标识符。 MT 传送到(U)SIM 卡的参数。除 GET RESPONSE 和 STATUS 外，其他命令均需 包含此参数。参数值参考 3GPP TS 51.011。 十六进制字符格式。待写入到(U)SIM 卡上的信息。详情参考 AT+CSCS。 十六进制字符格式。(U)SIM/UICC 中基本文件路径。 整型。(U)SIM 关于实际命令执行的信息。在命令执行成功或失败时，这些参数都 会传递给 TE。 十六进制字符串格式。命令发送成功后的响应。详情参考 AT+CSCS。STATUS 和 GET RESPONSE 返回有关当前基本数据字段信息，该信息包括文件类型及其大小 （参考 3GPP TS 51.011）。在 READ BINARY、READ RECORD 或 RETRIEVE DATA 命令之后，将返回所请求的数据。成功执行 UPDATE BINARY、UPDATE RECORD 或 SET DATA 命令后，不会返回。 错误码。详情参考第 14.5 章。 举例 AT+CRSM=214,28539,0,0,12,'FFFFFFFFFFFFFFFFFFFFFFFF' +CRSM: 144,0,'' OK 5.7. AT+QCCID 查询 ICCID 该命令用于查询(U)SIM 卡的 ICCID（集成电路卡识别码）。 AT+QCCID 查询 ICCID 测试命令 AT+QCCID=? 执行命令 AT+QCCID 响应 OK 响应 +QCCID: OK 或者 上海移远通信技术股份有限公司 93 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 ERROR 300 毫秒 / 参数 字符串类型。集成电路卡识别码（无双引号的字符串）。 错误码。详情参考第 14.5 章。 举例 AT+QCCID //查询(U)SIM 卡的 ICCID。 +QCCID: 89860025128306012474 OK 5.8. AT+QINISTAT 查询(U)SIM 卡初始化状态 该命令用于查询(U)SIM 卡初始化状态。 AT+QINISTAT 查询(U)SIM 卡初始化状态 测试命令 AT+QINISTAT=? 响应 +QINISTAT: (支持的范围) 执行命令 AT+QINISTAT OK 响应 +QINISTAT: 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。(U)SIM 卡初始化状态。实际值是以下四个数字中任意几个数字之和（例如：7 = 1 + 2 + 4 表示 CPIN READY + SMS DONE + PB DONE，即 CPIN 已就绪，SMS 初始化完成且电 话簿初始化完成)。 0 初始化状态 上海移远通信技术股份有限公司 94 / 279 LTE Standard(U)系列 AT 命令手册 1 CPIN READY。CPIN 已就绪，可执行锁定/解锁 PIN 操作。 2 SMS DONE。SMS 初始化完成。 4 PB DONE。电话簿初始化完成。 5.9. AT+QSIMDET (U)SIM 卡检测 该命令用于启用(U)SIM 卡的热插拔功能。GPIO 中断用于检测(U)SIM 卡，插入(U)SIM 卡时需设置检 测引脚的电平。 AT+QSIMDET (U)SIM 卡检测 测试命令 AT+QSIMDET=? 响应 +QSIMDET: (支持的列表),(支持的列 表) 查询命令 AT+QSIMDET? OK 响应 +QSIMDET: , 设置命令 AT+QSIMDET=, OK 响应 OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用(U)SIM 卡检测功能。 0 禁用 1 启用 整型。插入(U)SIM 卡时，引脚检测的电平。 0 低电平 1 高电平 备注 1. 若配置的值与硬件设计不一致，热插拔功能无效。 2. 对于 EC200D 系列模块，该命令重启后生效。 上海移远通信技术股份有限公司 95 / 279 举例 AT+QSIMDET=1,0 OK //拔出(U)SIM 卡 +CPIN: NOT READY //插入(U)SIM 卡 +CPIN: READY LTE Standard(U)系列 AT 命令手册 //(U)SIM 卡插入时，(U)SIM 检测引脚为低电平。 //(U)SIM 卡已就绪。 5.10. AT+QSIMSTAT (U)SIM 卡插拔状态上报 该命令用于查询/启用/禁用(U)SIM 卡的插拔状态上报功能。 AT+QSIMSTAT (U)SIM 卡插拔状态上报 测试命令 AT+QSIMSTAT=? 响应 +QSIMSTAT: (支持的列表) 查询命令 AT+QSIMSTAT? OK 响应 +QSIMSTAT: , 设置命令 AT+QSIMSTAT= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用(U)SIM 卡插拔状态上报功能。当开启时，将上报 URC +QSIMSTAT: ,指示(U)SIM 卡的插拔状态。 0 禁用 1 启用 整型。(U)SIM 卡的插拔状态。该参数不允许配置。 0 拔出 1 插入 2 未知状态。该状态出现在(U)SIM 卡初始化之前。 上海移远通信技术股份有限公司 96 / 279 举例 AT+QSIMSTAT? +QSIMSTAT: 0,1 OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 OK //拔出(U)SIM 卡 +QSIMSTAT: 1,0 +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK //插入(U)SIM 卡 +QSIMSTAT : 1,1 +CPIN: READY LTE Standard(U)系列 AT 命令手册 //查询(U)SIM 卡的插拔状态。 //设置(U)SIM 卡插入时，(U)SIM 检测引脚为低电平。 //使能(U)SIM 卡的插拔状态上报功能。 //查询当前(U)SIM 卡的插拔状态。 //上报(U)SIM 卡的插拔状态：拔出。 //查询当前(U)SIM 卡的插拔状态。 //上报(U)SIM 卡的插拔状态：插入。 5.11. AT+CCHO 开启逻辑信道 该命令用于开启(U)SIM 卡的逻辑信道。 AT+CCHO 开启逻辑信道 测试命令 AT+CCHO=? 设置命令 AT+CCHO= 响应 OK 响应 最大响应时间 OK 或者 ERROR 300 毫秒 上海移远通信技术股份有限公司 97 / 279 LTE Standard(U)系列 AT 命令手册 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型。UICC 中的所有可选应用程序，以 1 到 16 字节方式编码的 DF 名称 来引用。 整型。智能卡上的目标应用程序使用逻辑信道的会话 ID。 备注 APDU 命令中 CLASS 字节包含逻辑信道号，故发送到 UICC 的所有 APDU 命令都会包含逻辑信道号。 因此需由 MT 端负责管理 ADPU CLASS 字节中的逻辑信道部分，并确保选择的逻辑信道和执行命令返 回的相关联。有关 APDU 命令协议的逻辑信道详情请参考 3GPP TS 31.101。 举例 AT+CCHO=? OK AT+CCHO='A0000000871002FF86FFFF89FFFFFFFF' +CCHO: 1 OK //测试命令。 //由 AID 字符串组成。 //会话 ID 为 1。 5.12. AT+CGLA UICC 逻辑信道访问 该命令用于访问 UICC 逻辑信道。 AT+CGLA UICC 逻辑信道访问 测试命令 AT+CGLA=? 响应 OK 设置命令 AT+CGLA=,, 响应 +CGLA: , OK 或者 ERROR 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 98 / 279 LTE Standard(U)系列 AT 命令手册 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。会话ID。用于将APDU 命令发送到UICC 的会话的标识符。智能卡上的目标应 用程序使用逻辑信道而非默认信道（信道'0'）时，必须输入该参数向UICC 发送命 令。 整型。在 或 中发送给 TE 的字符长度（是命令或响应实际 长度的两倍）。 十六进制字符格式。MT 传递给 UICC 的命令。详情可参考 3GPP TS 31.101 中的 AT+CSCS。 十六进制字符格式。UICC 给 MT 传递的命令的响应。详情可参考 3GPP TS 31.101 中 的 AT+CSCS。 举例 AT+CGLA=? OK AT+CGLA=1,14,'00A40804022F00' +CGLA: 4,'6121' //测试命令。 //该命令为 00A40804022F00。 //长度为 4，响应为 6121。 OK 5.13. AT+CCHC 关闭逻辑信道 该命令使用指定的关闭(U)SIM 卡的逻辑信道。 AT+CCHC 关闭逻辑信道 测试命令 AT+CCHC=? 设置命令 AT+CCHC= 最大响应时间 特性说明 响应 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 99 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。智能卡上的目标应用程序使用逻辑信道的会话 ID。 举例 AT+CCHC=? OK AT+CCHC=1 OK //测试命令。 //关闭逻辑信道 1。 5.14. AT+QPINC 获取 PIN/PUK 剩余重试次数 该命令用于查询剩余输入(U)SIM PIN/PUK 密码的次数。 AT+QPINC 获取 PIN 剩余重试次数 测试命令 AT+QPINC=? 响应 +QPINC: (支持的列表) 查询命令 AT+QPINC? OK 响应 +QPINC: 'SC',, +QPINC: 'P2',, 设置命令 AT+QPINC= OK 响应 +QPINC: ,, 最大响应时间 特性说明 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 100 / 279 LTE Standard(U)系列 AT 命令手册 参数 字符串类型。 ''SC'' (U)SIM PIN ''P2'' (U)SIM PIN2 整型。剩余输入 PIN 密码的次数。范围：0~3。 整型。剩余输入 PUK 密码的次数。范围：0~10。 错误码。 上海移远通信技术股份有限公司 101 / 279 LTE Standard(U)系列 AT 命令手册 6 网络服务相关命令 6.1. AT+COPS 选择运营商 该命令用于查询、当前注册的运营商及注网状态，同时还可用于配置注册的运营商以及网络制式。 测试命令返回五个参数，均代表网络中出现的运营商，任意格式的运营商不可用时应返回空字段。运营 商列表显示顺序为：归属地网络，(U)SIM 卡推荐网络和其他网络。 查询命令返回当前找网模式和当前所选运营商。如果未选择任何运营商，则不会返回、 和。 设置命令用于强制选择并注册 GSM/LTE 网络运营商，即使所选的网络运营商不可用，也不可选择其他 任何运营商（=4 除外）。所选运营商名称的格式也应适用于查询命令 AT+COPS?。 AT+COPS 选择运营商 测试命令 AT+COPS=? 响应 +COPS: [ 支 持 的 运 营 商 列 表 (, 长 字 符 , 短 字 符 ,数字[,])][,,(支持的范围),(支持的 范围)] OK 查询命令 AT+COPS? 若错误与 ME 功能相关： +CME ERROR: 响应 +COPS: [,[,][,]] OK 设置命令 AT+COPS=[,[,[,]]] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 若错误与 ME 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 102 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 180 秒，取决于网络状态 / 参数 整型。运营商状态。 0 未知 1 可用运营商 2 当前选择的运营商 3 禁止选择的运营商 运营商。表示该参数的格式。决定是否省略该参数。 整型。 0 自动搜网，省略 1 手动搜网，不可省略且可选 2 手动注销网络 3 仅设置（用于查询命令 AT+COPS?）；不进行注册或注销（省略和 ）；该取值不适用于查询命令的返回结果。 4 手动和自动搜网的组合模式，字段不可省略；如果手动选择失败，将进入自 动选择模式（=0） 整型。的格式。 0 长字符串格式，最多 16 个字符 1 短字符串格式 2 数字格式。 整型。网络接入技术。 0 GSM 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA 和 HSUPA 7 E-UTRAN 错误码。详情参考第 14.5 章。 举例 AT+COPS=? //列举当前所有的网络运营商。 +COPS: (1,'CHN-UNICOM','UNICOM','46001',0),(2,'CHN-UNICOM','UNICOM','46001',7),(3,'CH INA MOBILE','CMCC','46000',0),(0-4),(0-2) OK AT+COPS? +COPS: 0,0,'CHN-UNICOM',7 //查询当前模块的注网状态。 上海移远通信技术股份有限公司 103 / 279 LTE Standard(U)系列 AT 命令手册 OK 备注 ECx00U、EGx00U 和 EG91xU 系列模块支持参数取值 0 和 7；EC200D 系列模块支持参数 取值 2 和 4~7；ECx00G、EGx00G 系列和 EG915G-EU 模块支持参数取值 7。 6.2. AT+CREG CS 域网络注册状态 查询命令返回网络注册状态和结果码显示状态。表示 ME 的网络注册状态。仅当 ME 注册到网 络和=2 时，才会返回位置信息和。 设置命令设置是否上报 URC 并在=1 且 ME 网络注册状态发生变化时，控制是否显示 URC +CREG: 。 AT+CREG CS 域网络注册状态 测试命令 AT+CREG=? 响应 +CREG: (支持的范围) 查询命令 AT+CREG? OK 响应 +CREG: ,[,,[,]] OK 设置命令 AT+CREG[=] 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 响应 OK 300 毫秒 该命令立即生效； 需执行 AT&W 保存参数配置。 上海移远通信技术股份有限公司 104 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。是否启用网络注册相关 URC。 0 禁用网络注册 URC 1 启用网络注册 URC +CREG: 2 启用带有位置信息的网络注册 URC +CREG: [,,[,]] 整型。注册状态。 0 未注册；ME 当前未搜索要注册的运营商 1 已注册，归属地网络 2 未注册，ME 正在搜索要注册的运营商 3 注册被拒绝 4 未知状态 5 已注册，漫游网络 字符串类型。位置区编号。2 个字节（十六进制格式）。 字符串类型。16 位（GSM）或 28 位（UMTS/LTE）小区 ID。十六进制格式。 整型。网络接入技术。 0 GSM 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA 和 HSUPA 7 E-UTRAN 错误码。详情参考第 14.5 章。 备注 ECx00U、EGx00U 和 EG91xU 系列模块支持参数取值 0 和 7；EC200D 系列模块支持参数 取值 2, 4~7；ECx00G、EGx00G 系列和 EG915G-EU 模块支持参数取值 7。 举例 AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'D509','80D413D',7 //URC 上报 ME 已经注册到网络。 //启用带有位置信息的网络注册 URC。 //URC 上报带小区 ID 和位置区号的运营商。 上海移远通信技术股份有限公司 105 / 279 LTE Standard(U)系列 AT 命令手册 6.3. AT+CSQ 查询信号强度 该命令用于查询当前服务小区接收信号强度和信道误码率。 测试命令返回 TA 支持的值。 执行命令返回 ME 返回的接收信号强度指示和信道误码率。 AT+CSQ 查询信号强度 测试命令 AT+CSQ=? 响应 +CSQ: (支持的列表),(支持的列表) 执行命令 AT+CSQ OK 响应 +CSQ: , 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 / 参数 整型。接收信号强度指示。 0 小于等于-113 dBm 1 -111 dBm 2~30 31 -109 ~ -53 dBm 大于等于-51 dBm 99 未知或不可测 整型。信道误码率。百分比格式。 0~7 3GPP TS 45.008 subclause 8.2.4 表格中的 RxQual 值 99 未知或不可测 举例 AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ 上海移远通信技术股份有限公司 106 / 279 LTE Standard(U)系列 AT 命令手册 +CSQ: 28,99 OK //查询当前信号强度指示为 28，误码率未知或不可测。 备注 执行网络相关命令（如 AT+CCWA 和 AT+CCFC）后，建议等待 3 秒再执行 AT+CSQ 以确保之前执行 的命令所需的网络访问已经完成。 6.4. AT+CPOL 配置首选运营商列表 该命令用于配置或者查询首选运营商列表。 AT+CPOL 配置首选运营商列表 测试命令 AT+CPOL=? 响应 +CPOL: (支持的列表),(支持的范围) 查询命令 AT+CPOL? OK 响应 查询首选运营商列表： +CPOL: ,,[,,,,] [+CPOL: ,,[,,,, …] 设置命令 AT+CPOL=[,[,[,,,]]] OK 响应 配置首选运营商列表： OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若指定但省略，后面的参数都将被省略。 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 107 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。(U)SIM 卡 PLMN 的序号。 整型。的格式。 0 长字符串格式 1 短字符串格式 2 数字格式 字符串类型。运营商。表示该参数格式采用字符串格式还是数字格式（参 考 AT+COPS）。 整型。是否选择 GSM 接入技术。 0 未选 1 已选 整型。是否选择 GSM compact 接入技术。 0 未选 1 已选 整型。是否选择 UTRAN 接入技术。 0 未选 1 已选 整型。是否选择 E-UTRAN 接入技术。 0 未选 1 已选 备注 、、和取值取决于(U)SIM 卡或 UICC 卡中具有接入技 术的 PLMN 选择器列表。 6.5. AT+COPN 查询运营商列表 该命令用于从 ME 查询运营商名称列表，命令返回 ME 存储中含字符串格式名称的运营商编 码。 AT+COPN 查询运营商列表 测试命令 AT+COPN=? 执行命令 AT+COPN 响应 OK 响应 +COPN: , [+COPN: , …] OK 上海移远通信技术股份有限公司 108 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 取决于运营商个数 / 参数 字符串类型。数字格式的运营商名称（请参考 AT+COPS）。 字符串类型。长字母数字格式的运营商名称（请参考 AT+COPS）。 错误码。详情参考第 14.5 章。 6.6. AT+CTZU 自动更新时区 该命令用于启用或者禁用通过 NITZ 自动更新时区功能。 AT+CTZU 自动更新时区 测试命令 AT+CTZU=? 响应 +CTZU: (支持的范围) 设置命令 AT+CTZU= 查询命令 AT+CTZU? OK 响应 OK 或者 ERROR 响应 +CTZU: 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 109 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。自动更新时区模式。 0 禁用通过 NITZ 自动更新时区 1 启用通过 NITZ 自动更新时区 3 启用通过 NITZ 自动更新时区并更新本地时间至系统时间 举例 AT+CTZU? +CTZU: 0 OK AT+CTZU=? +CTZU: (0,1,3) OK AT+CTZU=1 OK AT+CTZU? +CTZU: 1 OK //查询当前时区更新模式。 //测试命令。 //启用通过 NITZ 自动更新时区功能。 //查询当前时区更新模式。 6.7. AT+CTZR 上报时区变化 该命令用于启用/禁用时区变化事件的上报。若启用上报，则时区变化时 MT 会返回 URC +CTZV: 或者+CTZE: ,,。 AT+CTZR 上报时区变化 测试命令 AT+CTZR=? 响应 +CTZR: (支持的范围) 设置命令 AT+CTZR= 查询命令 AT+CTZR? OK 响应 OK 或者 ERROR 响应 +CTZR: OK 上海移远通信技术股份有限公司 110 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。是否上报时区变化。 0 不上报 1 通过 URC +CTZV: 上报时区变化 2 通过 URC +CTZE: ,,上报时区信息和本地时间 字符串类型。表示本地时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异）与夏 令时之和；格式为'±zz'，为两个整型数字的固定宽度。范围：-48 ~ +56。为保证固定宽 度，-9 ~ +9 之间的数字前加 0，例如：'-09'，'+00'，'+09'。 整型。表示中是否包括夏令时调整。 0 不包括夏令时调整 1 包括+1 小时（相当于中的一个小时）的夏令时调整 2 包括+2 小时（相当于中的两个小时）的夏令时调整 字符串类型。本地时间，格式：'YYYY/MM/DD,hh:mm:ss'，用于表示年（YYYY），月 （MM），日（DD），时（hh），分（mm）和秒（ss）。传送时区信息时由网络提供该 参数值，并在扩展 URC 中显示。 举例 AT+CTZR=2 OK AT+CTZR? +CTZR: 2 OK +CTZE: '+32',0,'2017/11/04,06:51:13' //使能通过 URC +CTZV: 上报时区变化。 //查询当前时区上报状态。 //通过URC上报时区信息和本地时间。 6.8. AT+QLTS 获取通过网络同步的最新时间 该命令用于获取通过网络同步的最新时间。 执行命令返回网络同步的最新的时间。 上海移远通信技术股份有限公司 111 / 279 LTE Standard(U)系列 AT 命令手册 AT+QLTS 获取通过网络同步的最新时间 测试命令 AT+QLTS=? 响应 +QLTS: (支持的范围) 执行命令 AT+QLTS OK 响应 +QLTS: , 设置命令 AT+QLTS= OK 响应 +QLTS: , OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。查询网络时间模式。 0 查询通过网络同步的最新时间 1 查询通过网络同步的最新时间计算出的当前 GMT 时间 2 查询通过网络同步的最新时间计算出的当前本地时间 字符串类型。格式为'YYYY/MM/dd,hh:mm:ss±zz', 用于表示年（yyyy），月（MM），日（dd）， 时（hh），分（mm），秒（ss），时区（zz，该字段以 15 分钟为单位显示本地时间和 GMT 时 间的差异，范围：-48 ~ +48），例如：2004 年 5 月 6 日 22:10:00 GMT 时间加 2 小时等于 '2004/05/06,22:10:00+08'。 整型。是否包括夏令时调整。 0 不包括夏令时调整 1 包括+1 小时的夏令时调整 2 包括+2 小时的夏令时调整 错误码。详情参考第 14.5 章。 备注 若时间未通过网络同步，执行该命令后返回不带时间的字符串+QLTS: ''。 上海移远通信技术股份有限公司 112 / 279 LTE Standard(U)系列 AT 命令手册 举例 AT+QLTS=? +QLTS: (0-2) //查询支持的网络时间模式。 OK AT+QLTS //查询通过网络同步的最新时间。 +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=0 //查询通过网络同步的最新时间，功能同执行命令 AT+QLTS 一致。 +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=1 //查询通过网络同步的最新时间计算出的当前 GMT 时间。 +QLTS: '2017/01/13,03:41:22+32,0' OK AT+QLTS=2 //查询通过网络同步的最新时间计算出的当前本地时间。 +QLTS: '2017/01/13,11:41:23+32,0' OK 6.9. AT+QNWINFO 查询网络信息 该命令用于查询网络信息，例如选择的接入技术、运营商以及选择的频段。 AT+QNWINFO 查询网络信息 测试命令 AT+QNWINFO=? 执行命令 AT+QNWINFO 响应 OK 响应 +QNWINFO: ,,, 最大响应时间 特性说明 OK 300 毫秒 / 上海移远通信技术股份有限公司 113 / 279 参数 字符串类型。网络接入技术。 'No Service' 'GSM' 'GPRS' 'EDGE' 'WCDMA' 'HSDPA' 'HSUPA' 'HSPA+' 'TDD LTE' 'FDD LTE' 字符串类型。数字格式运营商名称。 字符串类型。选择的频段。 'GSM 850' 'GSM 900' 'GSM 1800' 'GSM 1900' 'WCDMA 2100' 'WCDMA 1900' 'WCDMA 1700 US' 'WCDMA 850' 'WCDMA 800' 'WCDMA 900' 'LTE BAND 1' 'LTE BAND 2' 'LTE BAND 3' 'LTE BAND 4' 'LTE BAND 5' 'LTE BAND 7' 'LTE BAND 8' 'LTE BAND 20' 'LTE BAND 28' 'LTE BAND 34' 'LTE BAND 38' 'LTE BAND 39' 'LTE BAND 40' 'LTE BAND 41' 'LTE BAND 66' 整型。信道 ID。 LTE Standard(U)系列 AT 命令手册 上海移远通信技术股份有限公司 114 / 279 LTE Standard(U)系列 AT 命令手册 备注 1. 仅 EC200D 系列模块支持参数取值'WCDMA', 'HSDPA', 'HSUPA', 'HSPA+'。 2. 仅 EC200D 模块支持 WCDMA 频段（'WCDMA 2100'、'WCDMA 1900'、'WCDMA 1700 US'、 'WCDMA 850'、'WCDMA 800'和'WCDMA 900'）。 3. ECx00G、EGx00G 系列和 EG915G-EU 模块取值仅支持'TDD LTE'和'FDD LTE'； 取值仅支持 LTE BAND。 举例 AT+QNWINFO=? OK AT+QNWINFO +QNWINFO: 'FDD LTE','46011','LTE BAND 3',1650 OK 6.10. AT+QSPN 查询运营商名称 该命令用于查询运营商名称。 AT+QSPN 查询运营商名称 测试命令 AT+QSPN=? 执行命令 AT+QSPN 最大响应时间 特性说明 响应 OK 响应 +QSPN: ,,,, OK 300 毫秒 / 参数 字符串类型。网络名称全称。 字符串类型。网络名称简称。 字符串类型。运营商名称。 整型。网络名称全称或简称使用的字母表。 0 GSM 7 位默认字母表 1 UCS2 字符串类型。已注册的 PLMN。 上海移远通信技术股份有限公司 115 / 279 LTE Standard(U)系列 AT 命令手册 备注 1. 若=0，和格式为 GSM 7 位默认字母表的字符串。 2. 若=1，和格式为 UCS2 十六进制字符串。 3. EC200D 系列模块暂不支持该命令。 举例 AT+QSPN //查询已注册的 PLMN 的 EONS 信息。 +QSPN: 'CHN-UNICOM','UNICOM','',0,'46001' OK 6.11. AT+QCSQ 查询和上报信号强度 该命令用于查询和上报当前服务网络的信号强度。如果 MT 在不同的服务模式下注册多个网络，则可 以查询每种模式下网络的信号强度。无论 MT 是否注册了网络，用户都可以运行此命令来查询信号强度，如 果 MT 已驻网，可以执行 AT+QCSQ=1 使能 MT 主动上报检测到的信号强度。如果 MT 未使用任何服务网 络或服务模式不确定，则将返回'NOSERVICE'作为查询结果。 AT+QCSQ 查询和上报信号强度 测试命令 AT+QCSQ=? 响应 +QCSQ: (支持的列表) 设置命令 AT+QCSQ= 查询命令 AT+QCSQ? OK 响应 OK 响应 +QCSQ: 执行命令 AT+QCSQ OK 响应 +QCSQ: ,[,[,[,[,]]]] 最大响应时间 特性说明 OK 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 116 / 279 LTE Standard(U)系列 AT 命令手册 参数 字符串类型。表示 MT 主动上报信号强度的服务模式。 'NOSERVICE' NOSERVICE 模式 'GSM' GSM/GPRS 模式 'WCDMA' WCDMA/HSDPA/HSPA 模式 'LTE' LTE 模式 表示不同服务模式对应的信号强度类型，详见表 5。 整型。GSM 网络下的接收信号强度指示。单位：dBm。 整型。WCDMA 网络下的接收信号强度指示。单位：dBm。 整型。WCDMA 网络下的接收信号码功率。单位：dBm。 整型。WCDMA 网络下的下行载波干扰比。单位：dBm。 整型。LTE 网络下的接收信号强度指示。单位：dBm。 整型。LTE 网络下的参考信号接收功率。单位：dBm。 整型。LTE 网络下的信号与干扰加噪声比。单位：dB。 整型。LTE 网络下的参考信号接收质量。单位：dB。 整型。是否使能 URC 上报。 0 禁用 URC 上报 1 使能 URC 上报 表 5：信号强度类型 'NOSERVICE' 'GSM' 'WCDMA' 'LTE' 无 无 无 无 无 无 无 无 备注 1. URC 上报格式如下：+QCSQ: [,[,[,[,]]]]。MT 在 信号强度变化时通过此 URC 主动上报当前信号强度。 2. 设置命令控制 URC 使能/禁用，默认禁用 URC（=0）。如果=1，则 MT 可以在信 号强度变化时主动上报当前信号强度。 3. 仅 EC200D 系列模块支持 WCDMA 制式，因此 WCDMA 网络下的相关配置仅 EC200D 系列模块支 持。 4. ECx00G、EGx00G 系列和 EG915G-EU 模块仅支持 LTE 模式。 5. 查询时，模块返回 RSSI 的绝对值。 6. 查询时，EC200D 系列模块返回真实的 SINR 值。其余模块返回等级值，实际 SINR 值转 换公式为：Y = X/2 - 23.5。（X：通过 AT+QCSQ 查询的值。Y：转换后的实际 SINR 值； 上海移远通信技术股份有限公司 117 / 279 范围：-23~40；单位：dB。） 举例 AT+QCSQ //查询信号强度。 +QCSQ: 'LTE',62,-91,75,-10 OK AT+QCSQ? +QCSQ: 0 //查询 URC 配置。 OK AT+QCSQ=? //支持的列表。 +QCSQ: 'NOSERVICE','GSM','LTE' OK LTE Standard(U)系列 AT 命令手册 6.12. AT+CIND 指示器状态查询 AT+CIND 指示器状态查询 测试命令 AT+CIND=? 查询命令 AT+CIND? 最大响应时间 特性说明 响应 +CIND:(,( 支 持 的 列 表 ))[,(,( 支 持 的 列表))[,...]] OK 响应 +CIND: [,[,...]] OK 若错误与 ME 相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。指示状态，详见备注。 整型。指示事件，与相关联，详见备注。 错误码。详情参考第 14.5 章。 上海移远通信技术股份有限公司 118 / 279 备注 与的值描述如下： 'battchg' 'signal' 'service' 'sounder' 'message' 'call' 'roam' 'smsfull' LTE Standard(U)系列 AT 命令手册 电池电量。范围：0~5。 信号强度指示。范围：0~5。 信号从弱到强分为 0~5 五个级别。 网络服务状态指示。 0 未注网 1 注册到已知网络 探测仪活动。暂不支持该值。 接收的短信。 0 未收到短信 1 收到短信 通话状态指示。 0 无通话 1 通话 漫游指示。 0 已在所有权或未注册网络中注册 1 注册到漫游网络 短信存储指示。 0 短信存储空间已满 1 存储位置可用 举例 AT+CIND=? +CIND: ('battchg',(0-5)),('signal',(0-5)),('service',(0,1)),('sounder',(0,1)),('message',(0,1)),('call', (0,1)),('roam',(0,1)),('smsfull',(0,1)) OK AT+CIND? +CIND: 0,3,1,0,0,0,1,0 OK 上海移远通信技术股份有限公司 119 / 279 LTE Standard(U)系列 AT 命令手册 7 呼叫相关命令 7.1. ATA 呼叫应答 该命令用于连接模块以应答由 URC RING 指示的语音来电。执行该命令后，MT 发送摘机信号到远程 站。 ATA 呼叫应答 执行命令 ATA 响应 若语音拨号并成功建立连接： OK 最大响应时间 特性说明 参考 V.25ter 若不能建立连接： NO CARRIER 90 秒，取决于网络状态 / 备注 1. ATA 操作忽略同一行命令中其他命令。 2. 若在执行 ATA 过程中收到字符，该命令可能被终止执行。但是在建立连接的某些状态（如：握手状 态），该命令不会被中止执行。 3. ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 RING AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,1,4,0,0,'02154450290',129 OK ATA OK //语音来电。 //LTE 模式下 PS 呼叫。 //来电。 //使用 ATA 应答此语音呼叫。 上海移远通信技术股份有限公司 120 / 279 LTE Standard(U)系列 AT 命令手册 7.2. ATD 发起呼叫 该命令用于建立语音主叫，还可以用于控制补充业务。 ATD 发起呼叫 执行命令 ATD[][;] 响应 若连接无法建立成功： NO CARRIER 最大响应时间 特性说明 参考 V.25ter 若成功发起语音呼叫： OK 5 秒，取决于网络状态（AT+COLP=0） / 参数 拨号位字符串和 V.25ter 中可选的拨号修饰符。 拨号位：0~9，*，#，+，A，B，C 以下 V.25ter 拨号修饰符可忽略： ,（逗号），T，P，!，W，@ 字符串类型。GSM 拨号修饰符。 I 激活 CLIR（主叫用户不允许在被叫用户话机上显示自己的电话号码） i 禁止 CLIR（主叫用户允许在被叫用户话机上显示自己的电话号码） G 仅在本次呼叫中激活闭合用户群调用 g 仅在本次呼叫中去激活闭合用户群调用 仅在建立语音呼叫时可用，呼叫结束后返回至命令状态。 备注 1. 若在执行 ATD 过程中收到 ATH 或某一字符，该命令可能被终止执行。但是在建立连接的某些状态 （如：握手状态），该命令不会被中止执行。 2. =I/i 仅适用于拨号字符中无'*'或'#'的情况。 3. 使用 ATD 拨号后响应： 对于语音呼叫，可设置两种不同的响应模式： 拨号完成后或者在呼叫建立成功后，TA 立即返回 OK。此设置由 AT+COLP 控制。默认设置为 AT+COLP=0，即拨号完成后，TA 立即返回 OK。否则 TA 返回 OK、BUSY、NO DIAL TONE 或 NO CARRIER。 4. 在一个已激活的语音呼叫中，使用 ATD： ⚫ 当已有一个已激活的语音呼叫，用户发起第二个语音呼叫时，第一个语音呼叫将自动设置为呼 上海移远通信技术股份有限公司 121 / 279 LTE Standard(U)系列 AT 命令手册 叫保持状态。 ⚫ 所有呼叫的当前状态均可随时使用 AT+CLCC 进行查询。 5. ECx00G、EGx00G 系列和 EG915G-EU 模块仅支持使用该命令进行 PPP 拨号，不支持语音拨号。 举例 ATD10086; OK //拨号。 7.3. ATH 挂断当前连接 该命令用于断开当前数据通话或语音通话，即本地 TE 从命令行断开并终止通话。也可使用 AT+CHUP 挂断语音通话。 ATH 挂断当前连接 执行命令 ATH[n] 最大响应时间 特性说明 参考 V.25ter 响应 OK 90 秒，取决于网络状态 / 参数 整型。 0 从命令行断开当前所有通话并终止通话 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块仅支持使用该命令挂断 PPP 连接，不支持挂断语音连接。 7.4. AT+CVHU 控制语音通话挂断 该命令用于控制 ATH 是否可用于断开语音通话。 上海移远通信技术股份有限公司 122 / 279 LTE Standard(U)系列 AT 命令手册 AT+CVHU 控制语音通话挂断 测试命令 AT+CVHU=? 查询命令 AT+CVHU? 设置命令 AT+CVHU= 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 +CVHU: (支持的列表) OK 响应 +CVHU: OK 响应 OK 或者 ERROR 300 毫秒 / 参数 整型。 0 ATH 可用于断开语音通话 1 ATH 不可用于断开语音通话，仅返回 OK 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 7.5. AT+CHUP 挂断通话 该命令用于取消所有活跃、等待、保持状态的语音通话。若需断开数据通话，需使用 ATH。 AT+CHUP 挂断通话 测试命令 响应 AT+CHUP=? 执行命令 OK 响应 AT+CHUP OK 或者 上海移远通信技术股份有限公司 123 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 ERROR 90 秒，取决于网络状态 / 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 RING AT+CHUP OK //来电。 //挂断通话。 7.6. +++ 从数据模式切换至命令模式 该命令仅在 TA 处于数据模式时可用。+++字符使 TA 取消 AT 接口上的数据流并切换到命令模式。这样 可以在保持与远程服务器的数据连接或 GPRS 连接的同时输入 AT 命令。 +++ 从数据模式切换至命令模式 执行命令 +++ 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 / 备注 1. 为防止+++转义序列被误解为数据，应遵循以下规则： 1) 输入+++前 1 秒内请勿输入任何字符。 2) 1 秒钟内输入+++，在此时间内不能输入其他字符。 3) 输入+++后 1 秒钟内请勿输入任何字符。 4) 成功切换到命令模式；否则，返回步骤 1)。 2. 要从命令模式返回数据模式，请输入 ATO。 上海移远通信技术股份有限公司 124 / 279 LTE Standard(U)系列 AT 命令手册 3. 切换为命令模式的另一种方法是通过更改 DTR 电平，有关详细信息，参见 AT&D。 7.7. ATO 从命令模式切换至数据模式 该命令用于恢复连接，并从命令模式切换回数据模式。 ATO 从命令模式切换至数据模式 执行命令 ATO[n] 响应 恢复连接失败： NO CARRIER 最大响应时间 特性说明 参考 V.25ter 恢复连接成功，TA 从命令模式返回至数据模式： CONNECT 300 毫秒 / 参数 整型。 0 从命令模式切换回数据模式 备注 当 TA 成功从命令模式切换回到数据模式时，将返回 CONNECT。仅当 ATX 的参数值大于 0 时，才输出 CONNECT 。 7.8. ATS0 设置自动应答前振铃次数 该命令用于设置来电的自动应答前振铃次数。 ATS0 设置自动应答前振铃次数 查询命令 响应 ATS0? 上海移远通信技术股份有限公司 125 / 279 LTE Standard(U)系列 AT 命令手册 设置命令 ATS0= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 该命令立即生效； 需执行 AT&W 保存参数配置。 参数 整型。设置来电的自动应答前的振铃次数。 0 禁用自动应答 1~255 达到指定的振铃次数后，启用自动应答 备注 1. 若设置的值过大，呼叫方可能在呼叫被自动应答前挂断。 2. ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 ATS0=3 OK RING RING RING //设置三次振铃后自动接听。 //来电。 //振铃 3 次后自动应答呼叫。 7.9. ATS7 设置呼叫建立完成等待时间 该命令用于设置在应答或发起通话时，指定等待呼叫建立完成的时间。若指定等待时间内，无连接创建 完成，模块将断开连接。 ATS7 设置呼叫建立完成等待时间 查询命令 响应 ATS7? 上海移远通信技术股份有限公司 126 / 279 LTE Standard(U)系列 AT 命令手册 设置命令 ATS7= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 该命令立即生效； 需执行 AT&W 保存参数配置。 参数 整型。 0 禁用 1~255 等待连接创建完成的秒数；单位：秒 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 7.10. AT+CSTA 选择地址类型 该命令用于根据 3GPP 规范选择进一步拨号命令 ATD 的号码类型。测试命令返回所有支持的值。 AT+CSTA 选择地址类型 测试命令 AT+CSTA=? 响应 +CSTA: (支持的列表) 查询命令 AT+CSTA? OK 响应 +CSTA: 设置命令 AT+CSTA= 最大响应时间 特性说明 OK 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 127 / 279 LTE Standard(U)系列 AT 命令手册 参考 3GPP TS 27.007 参数 整型。当前地址类型。 129 未知类型 145 国际类型（包含字符'+'） 161 国家类型 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 7.11. AT+CLCC 查询当前 ME 呼叫 该命令用于查询所有当前呼叫。若命令成功但无呼叫，将不会有信息发送到 TE，只返回 OK。 AT+CLCC 查询当前 ME 呼叫 测试命令 AT+CLCC=? 执行命令 AT+CLCC 响应 OK 响应 [+CLCC: ,,,,[,, [,]] [+CLCC: ,,,,[,, [,]] [...] OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。呼叫识别号（请参考 3GPP TS 22.030 subclause 4.5.5.1）。该参数可用于 AT+CHLD。 整型。 上海移远通信技术股份有限公司 128 / 279 LTE Standard(U)系列 AT 命令手册 0 主叫（MO） 1 被叫（MT） 整型。呼叫状态。 0 激活状态 1 呼叫保持状态 2 主叫，拨号状态 3 主叫，回铃音状态 4 被叫，来电状态 5 被叫，呼叫等待状态 整型。承载/用户终端业务。 0 语音呼叫 1 数据呼叫 2 传真 整型。 0 不在多方通话中 1 在多方通话中 字符串类型。电话号码。由规定电话号码格式。 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。通常有 3 种类型： 129 未知类型 145 国际号码（包含字符'+'） 161 国家号码 字母数字格式的，与电话簿中的条目相对应。 错误码。详情参考第 14.5 章。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 ATD10086; OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 OK //发起通话。 //发起通话且通话已被接听。 上海移远通信技术股份有限公司 129 / 279 LTE Standard(U)系列 AT 命令手册 7.12. AT+CRC 设置来电指示扩展格式 该命令用于控制来电指示是否使用扩展格式。若使用扩展格式，来电时将使用 URC +CRING: 向 TE 提示，而不是使用 RING。 AT+CRC 设置来电指示扩展格式 测试命令 AT+CRC=? 响应 +CRC: (支持的列表) 查询命令 AT+CRC? OK 响应 +CRC: 设置命令 AT+CRC=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。 0 禁用扩展格式 1 启用扩展格式 字符串类型。 ASYNC 异步透明 SYNC 同步透明 REL ASYNC 异步非透明 REL SYNC 同步非透明 FAX 传真 VOICE 语音 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 上海移远通信技术股份有限公司 130 / 279 举例 AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK RING ATH OK //启用扩展格式。 //语音来电提示。 //禁用扩展格式。 //语音来电提示。 LTE Standard(U)系列 AT 命令手册 7.13. AT+QECCNUM 配置紧急呼叫号码 该命令用于查询、增加和删除 ECC 号码（紧急呼叫号码）。ECC 号码分两种：一种是未插(U)SIM 卡时 的 ECC 号码，默认是 911、112、00、08、110、999、118 和 119；另一种是插(U)SIM 卡时的 ECC 号码， 默认是 911 和 112。911 和 112 始终属于 ECC 号码，且不可删除。ECC 号码自动保存至 NV。若(U)SIM 卡 中含 ECC 文件，则 ECC 文件中的号码也被作为 ECC 号码。 每种 ECC 号码最多支持 20 个号码。 AT+QECCNUM 配置紧急呼叫号码 测试命令 AT+QECCNUM=? 响应 +QECCNUM: (支持的范围) 设置命令 AT+QECCNUM=,[,[,,…[,]]] OK 响应 若 为 0 ， 指 定 ， 查 询 ECC 号 码 ， 省 略 ： +QECCNUM: ,,[,…] OK 查询命令 若不为 0（为 1 时增加 ECC 号码；为 2 时删除 ECC 号码），至少需要输入 1 个 ECC 号码： OK 或者 ERROR 响应 上海移远通信技术股份有限公司 131 / 279 LTE Standard(U)系列 AT 命令手册 AT+QECCNUM? 最大响应时间 特性说明 +QECCNUM: 0,,[,…] +QECCNUM: 1,,[,…] OK 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。ECC 号码操作模式。 0 查询 ECC 号码 1 增加 ECC 号码 2 删除 ECC 号码 整型。ECC 号码类型。 0 未插(U)SIM 卡时的 ECC 号码 1 插(U)SIM 卡时的 ECC 号码 字符串类型。ECC 号码。例如：'110'、'119'。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 AT+QECCNUM=? +QECCNUM: (0-2) //查询支持的 ECC 号码操作模式。 OK AT+QECCNUM? //查询插(U)SIM 卡和不插(U)SIM 卡时的 ECC 号码。 +QECCNUM: 0,'911','112','00','08','110','999','118','119' +QECCNUM: 1,'911','112' OK AT+QECCNUM=0,1 +QECCNUM: 1,'911','112' //查询插(U)SIM 卡时的 ECC 号码。 OK AT+QECCNUM=1,1,'110','234' //增加'110'和'234'作为插(U)SIM 卡时的 ECC 号码。 OK AT+QECCNUM=0,1 //查询插(U)SIM 卡时的 ECC 号码。 +QECCNUM: 1, '911','112','110','234' 上海移远通信技术股份有限公司 132 / 279 LTE Standard(U)系列 AT 命令手册 OK AT+QECCNUM=2,1,'110' //从插(U)SIM 卡时的 ECC 号码中删除'110'。 OK AT+QECCNUM=0,1 //查询插(U)SIM 卡时的 ECC 号码。 +QECCNUM: 1, '911','112','234' OK 7.14. AT+QHUP 指定原因终止呼叫 该命令可以终止由主机指定的释放原因（参见 3GPP TS 24.008）的一个或多个呼叫（包括语音呼叫和 数据呼叫）。 AT+QHUP 指定原因终止呼叫 测试命令 AT+QHUP=? 设置命令 AT+QHUP=[,] 响应 OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 90 秒，由网络状况决定 / 参数 整型。释放原因。网络指示的释放原因（参见 3GPP TS 24.008）。 1 未分配号码 16 清除正常呼叫 17 用户忙 18 无用户响应 21 呼叫被拒绝 27 终点故障 31 正常，未指定 88 不兼容的目的地 整型。 当前呼叫列表中的呼叫识别号码索引，由 AT+CLCC 指定，可选。AT+QHUP 可 以终止由指定索引号标识的呼叫。默认值 0 表示所有呼叫。 上海移远通信技术股份有限公司 133 / 279 LTE Standard(U)系列 AT 命令手册 0 终止当前所有呼叫。但是，如果电路同时切换数据呼叫和语音呼叫， 则此命令仅终止 CSD 呼叫。 1…7 终止由指定索引号标识的呼叫 错误码。详情参考第 14.5 章。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 AT+QHUP=? //测试命令。 OK ATD10010; //拨打 10010。 OK AT+CLCC //查询呼叫状态。 +CLCC: 1,0,0,0,0,'10010',129 OK AT+QHUP=17,1 //终止 ID 为 1 的呼叫。断开连接原因为用户忙。 OK ATD10010; //拨打 10010。 OK AT+CLCC //查询呼叫状态。 +CLCC: 1,0,0,0,0,'10010',129 OK AT+QHUP=16 OK AT+CLCC OK //终止当前所有呼叫。断开连接原因为清除正常呼叫。 7.15. AT+QCHLDIPMPTY 挂断 VoLTE 会议呼叫 该命令用于在 VoLTE 会议中挂断呼叫。 AT+QCHLDIPMPTY 测试命令 AT+QCHLDIPMPTY=? 挂断 VoLTE 会议呼叫 响应 +QCHLDIPMPTY: OK 上海移远通信技术股份有限公司 134 / 279 设置命令 AT+QCHLDIPMPTY= 最大响应时间 特性说明 响应 OK 或者 ERROR 300 毫秒 / LTE Standard(U)系列 AT 命令手册 参数 拨号位字符串和 V.25ter 中可选的拨号修饰符。 拨号位：0~9，*，#，+，A，B，C 以下 V.25ter 拨号修饰符可忽略： ,（逗号），T，P，!，W，@ 举例 AT+QCHLDIPMPTY=? +QCHLDIPMPTY: OK ATD13866783782; OK AT+CLCC +CLCC: 2,1,0,1,0,'',128 +CLCC: 1,0,0,0,0,'13866783782',129 OK AT+CHLD=2 OK AT+CLCC +CLCC: 2,1,0,1,0,'',128 +CLCC: 1,0,1,0,0,'13866783782',129 OK ATD15155196746; OK AT+CLCC +CLCC: 2,1,0,1,0,'',128 +CLCC: 1,0,1,0,0,'13866783782',129 +CLCC: 3,1,0,1,0,'',128 +CLCC: 4,0,0,0,0,'15155196746',129 OK //测试命令。 //建立呼叫。 //激活第二路呼叫。 //保持正在通话呼叫并接听另一呼叫（等待呼叫或保持呼叫）。 //查询呼叫状态。 //保持第二路呼叫。 //建立呼叫。 //保持第二路呼叫。 //激活第四路呼叫。 上海移远通信技术股份有限公司 135 / 279 LTE Standard(U)系列 AT 命令手册 AT+CHLD=3 OK AT+CLCC +CLCC: 2,1,0,1,0,'',128 +CLCC: 3,1,0,1,0,'',128 +CLCC: 5,0,0,0,0,'sip:mmtel',128 OK AT+QCHLDIPMPTY='13866783782' OK AT+QCHLDIPMPTY='15155196746' OK //激活一个保持中的呼叫以建立多方通话。 //挂断一个已激活呼叫。 //挂断一个已激活呼叫。 备注 1、 EC200D 系列模块暂不支持该命令。 2、 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 上海移远通信技术股份有限公司 136 / 279 LTE Standard(U)系列 AT 命令手册 8 电话本相关命令 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持电话本相关命令。 8.1. AT+CNUM 查询本机号码 该命令用于读取(U)SIM 卡中所有本机号码记录。 AT+CNUM 查询本机号码 测试命令 AT+CNUM=? 执行命令 AT+CNUM 响应 OK 响应 [+CNUM: [],,] [+CNUM: [],,] OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。与相关联，使用的字符集应为 AT+CSCS 设置的字符集。 字符串类型。电话号码。格式由决定。 上海移远通信技术股份有限公司 137 / 279 LTE Standard(U)系列 AT 命令手册 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。通常有 3 种类型： 129 未知类型 145 国际号码（包含字符'+'） 161 国家号码 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 8.2. AT+CPBF 搜索电话本记录 该命令用于搜索当前电话本存储器中以给定的字符串开头的电话本记录，返回的所有记录以 字母数字顺序排列。 AT+CPBF 搜索电话本记录 测试命令 AT+CPBF=? 响应 +CPBF: , 设置命令 AT+CPBF= OK 响应 [+CPBF: ,,,] … OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 ME 功能相关： +CME ERROR: 取决于电话本记录数量。 / 上海移远通信技术股份有限公司 138 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。的最大长度。 整型。的最大长度。 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 整型。电话号码在存储器中的位置。 字符串类型。电话号码。格式由决定。 整型。号码地址类型。 129 未知类型 145 国际号码（包含字符'+'） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 8.3. AT+CPBR 读取电话本记录 该命令用于读取电话本存储器中位置在与之间（闭区间）的电话本记录。如果只输 入，则只返回在位置的电话本记录。 AT+CPBR 读取电话本记录 测试命令 AT+CPBR=? 响应 +CPBR: (支持的列表),, 设置命令 AT+CPBR=[,] OK 响应 +CPBR: ,,, [+CPBR: ,,, […]] OK 或者 ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 取决于电话本记录数量。 上海移远通信技术股份有限公司 139 / 279 LTE Standard(U)系列 AT 命令手册 特性说明 / 参考 3GPP 27.007 参数 整型。电话本存储器位置索引号。 整型。的最大长度。 整型。的最大长度。 整型。需读取的电话号码在存储器中的起始位置。 整型。需读取的电话号码在存储器中的终止位置。 字符串类型。电话号码。格式由决定。 整型。号码地址类型。 129 未知类型 145 国际号码（包含字符'+'） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 8.4. AT+CPBS 设置电话本存储器 该命令用于设置电话本存储器，使用其他电话本相关命令是也会使用该存储器。 AT+CPBS 设置电话本存储器 测试命令 AT+CPBS=? 响应 +CPBS: (支持的列表) OK 或者 ERROR 查询命令 AT+CPBS? 若错误与 ME 功能相关： +CME ERROR: 响应 +CPBS: ,, 上海移远通信技术股份有限公司 140 / 279 LTE Standard(U)系列 AT 命令手册 设置命令 AT+CPBS= 最大响应时间 特性说明 参数 3GPP 27.007 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。电话本存储器。 'SM' (U)SIM 电话本 'FD' (U)SIM 卡固定拨号电话本（AT+CPBW 操作需要 PIN2 码） 'LD' (U)SIM 卡最后拨号电话本（可能不适用于 AT+CPBW） 'ME' ME 电话本 'ON' (U)SIM 卡本机号码列表（MSISDN） 整型。当前存储器中已用的存储单元。 整型。当前存储器中总计的存储单元。 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 8.5. AT+CPBW 写入电话本记录 该命令用于在当前存储器指定位置中添加、删除电话本记录。 上海移远通信技术股份有限公司 141 / 279 LTE Standard(U)系列 AT 命令手册 AT+CPBW 写入电话本记录 测试命令 AT+CPBW=? 响应 +CPBW: (支持的范围),,(支持的列 表), OK 或者 ERROR 设置命令 AT+CPBW=[][,[,[,]]] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。电话本存储器位置索引号。若未指定该参数，将使用第一个电话本条目。若仅设置 ，则指定位置的电话本记录将被删除。 整型。的最大长度。 整型。的最大长度。 字符串类型。电话号码。格式由决定。 整型。号码地址类型。 129 未知类型 145 国际号码（包含字符'+'） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 上海移远通信技术股份有限公司 142 / 279 LTE Standard(U)系列 AT 命令手册 举例 AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK AT+CPBW=10 OK //添加一条电话条目。 //删除一条电话条目。 上海移远通信技术股份有限公司 143 / 279 LTE Standard(U)系列 AT 命令手册 9 短消息相关命令 9.1. AT+CSMS 选择短消息服务类型 该命令用于选择短消息服务类型并返回 ME 支持的短消息类型。 AT+CSMS 选择短消息服务类型 测试命令 AT+CSMS=? 响应 +CSMS: (支持的列表) 查询命令 AT+CSMS? OK 响应 +CSMS: ,,, 设置命令 AT+CSMS= OK 响应 +CSMS: ,, OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效，参数配置自动保存。 参数 整型。短消息服务类型。 0 详情参考 3GPP TS 23.040 和 3GPP TS 23.041（SMS 的 AT 命令语法与3GPP TS 27.005 Phase 2 4.7.0 版本兼容；支持不需要新命令语法的 Phase 2+功能（例如： 使用 Phase 2+新编码方案修正消息路由）） 1 详情参考 3GPP TS 23.040 和 3GPP TS 23.041（SMS 的 AT 命令语法与3GPP TS 27.005 Phase 2+版本兼容；设置为 1 时的要求已在对应命令描述中说明） 整型。被叫短消息。 上海移远通信技术股份有限公司 144 / 279 LTE Standard(U)系列 AT 命令手册 0 不支持 1 支持 整型。主叫短消息。 0 不支持 1 支持 整型。广播类型短消息。 0 不支持 1 支持 错误码。详情参考第 14.6 章。 举例 AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //列出支持的短消息服务类型。 //设置短消息服务类型为 1。 //查询当前短消息服务类型。 9.2. AT+CMGF 配置短消息模式 该命令用于指定短消息采用的格式。表示 TA 和 TE 之间读写短消息时，采用的是文本模式还 是 PDU 模式。消息格式可设置为 PDU 模式（使用整个 TP 数据单元）或者文本模式（消息报头和正文分 别以不同的参数形式展示）。文本模式通过 AT+CSCS 指定的来告知 TA 和 TE 交互中消息正文使 用的字符集。 AT+CMGF 配置短消息模式 测试命令 AT+CMGF=? 响应 +CMGF: (支持的列表) 查询命令 AT+CMGF? OK 响应 +CMGF: OK 上海移远通信技术股份有限公司 145 / 279 设置命令 AT+CMGF[=] 最大响应时间 特性说明 参考 3GPP TS 27.005 参数 整型。短消息模式。 0 PDU 模式 1 文本模式 响应 OK 300 毫秒 / LTE Standard(U)系列 AT 命令手册 9.3. AT+CSCA 设置短消息服务中心地址 该设置命令用于当主动发送短消息后，更新 SMSC（短消息服务中心）地址。在文本模式下，可使用设 置命令进行设置。在 PDU 模式下，仅当 SMSC 地址的长度编码为=0 时，方可使用设置命令进行设 置。 AT+CSCA 设置短消息服务中心地址 测试命令 响应 AT+CSCA=? 查询命令 OK 响应 AT+CSCA? +CSCA: , 设置命令 AT+CSCA=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 146 / 279 LTE Standard(U)系列 AT 命令手册 参数 字符串类型。短消息服务中心地址。详情参考 3GPP TS 24.011 RP SC 地址 Address-Value 字段；BCD 码（或 GSM 7 位默认字母字符）转换为当前选择的 TE 字符集的字符（参考 3GPP TS 27.007 中 AT+CSCS）。地址类型由定义。 整型。短消息服务中心地址类型。详情参考 3GPP TS 24.011 RP SC 地址中的八位字节 Type-of-Address（参考）。 错误码。详情参考第 14.6 章。 举例 AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //设置短消息服务中心地址。 //查询短消息服务中心地址。 9.4. AT+CPMS 配置短消息首选存储位置 该命令用于选择查询或配置短消息的存储位置，包括、和。 AT+CPMS 配置短消息首选存储位置 测试命令 AT+CPMS=? 响应 +CPMS: (支持的列表),(支持的列表),(支持 的列表) 查询命令 AT+CPMS? OK 响应 +CPMS: ,,,,,,,, 设置命令 AT+CPMS=[,[,]] OK 响应 +CPMS: ,,,,, OK 若错误与 ME 功能相关： +CMS ERROR: 上海移远通信技术股份有限公司 147 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 字符串类型。若没有建立到 TE 的路由（参考 AT+CNMI），则接收的短消息存储在该存储器 内。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 整型。中当前短消息的数量。 整型。中可存储的短消息的总数量。 错误码。详情参考第 14.6 章。 举例 AT+CPMS? //查询当前短消息存储器信息。 +CPMS: 'ME',0,20,'ME',0,20,'ME',0,20 OK AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //将短消息存储器更改为'SM'。 OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //查询当前短消息存储器信息。 OK 上海移远通信技术股份有限公司 148 / 279 LTE Standard(U)系列 AT 命令手册 9.5. AT+CMGD 删除短消息 该命令用于删除短消息首选存储器中位于的短消息。若指定且不为0，ME 应省略并遵守参数规则。 AT+CMGD 删除短消息 测试命令 AT+CMGD=? 响应 +CMGD: (支持的范围),(支持的范围) 设置命令 AT+CMGD=[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。存储器位置编号。若为'ME'或'MT'，的范围为 0~99；若 为'SM'，的范围取决于(U)SIM 卡的短信存储数量。 整型。 0 删除指定的短消息 1 删除存储器中所有的已读短消息 2 删除存储器中所有的已读短消息和已发送的短消息 3 删除存储器中所有的已读短消息、已发送和未发送的短消息 4 删除存储器中所有短消息 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 错误码。详情参考第 14.6 章。 举例 AT+CMGD=1 OK AT+CMGD=1,4 //删除存储器中=1 的短消息。 //删除存储器中所有短消息。 上海移远通信技术股份有限公司 149 / 279 LTE Standard(U)系列 AT 命令手册 OK 9.6. AT+CMGL 按照状态读取短消息 该命令用于获取存储器中对应消息状态的短消息。若短消息状态为'REC UNREAD'，则存储 器中短消息的状态将变更为'REC READ'。若执行 AT+CMGL 但不设置，模块将返回状态为'REC UNREAD'的短消息列表。 AT+CMGL 按照状态读取短消息 测试命令 AT+CMGL=? 响应 +CMGL: (支持的列表) 设置命令 AT+CMGL[=] OK 响应 若缺省可选参数（即执行 AT+CMGL），则列出短消息存储器 的所有状态为'REC UNREAD'的短消息，然后存储器中短消息的状态 变更为'REC READ'。 若指定可选参数： 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-SUBMIT 和/或 SMS-DELIVER： +CMGL: ,,,[],[][,,][ +CMGL: ,,,[],[][,,][...]] 对于 SMS-STATUS-REPORT： +CMGL: ,,,,[],[],,, [ +CMGL: ,,,,[],[],,, [...]] 对于 SMS-COMMAND： +CMGL: ,,,[ +CMGL: ,,,[...]] 对于 CBM 存储： +CMGL: ,,,,,[ +CMGL: ,,,,,[...]] 上海移远通信技术股份有限公司 150 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 2）PDU 模式（AT+CMGF=0）且该命令执行成功： +CMGL: ,,[], +CMGL: ,,[alpha],[...]] OK 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 1）文本模式下，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式下，整型。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 整型。存储器位置编号。 字符串类型。目标地址。详情参考 3GPP TS 23.040 中的 TP-Destination-Address Address- Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中 的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 字符串类型。始发地址。详情参考 3GPP TS 23.040 中的 TP-Originating-Address Address- Value 字段；BCD 码（GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的 字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 字符串类型。字母数字格式的或，对应 MT 电话簿中的条目。该功能的实现按照 出厂设定，所使用的字符集应与 AT+CSCS 选择的字符集相同（详情参考 3GPP TS 27.007 中对该命令的定义）。 字符串类型。短消息服务中心时间戳。详情参考 3GPP TS 23.040 TP-Service-Center-Time- Stamp 中的时间字符（参考）。 上海移远通信技术股份有限公司 151 / 279 LTE Standard(U)系列 AT 命令手册 整型。目标地址类型。详情参考 3GPP TS 24.011 TP- Destination-Address 中的八位字节 Type-of-Address。 整型。始发地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address 中的八位字节 Type-of-Address（默认值参考）。 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示消息正文的长度；最大长度为 160 字节； PDU 模式（AT+CMGF=0）下，以八位字节为单位的实际 TP 数据单元的长度（即 RP 层 的短消息服务中心地址中的八位字符将不计算在该长度内）；最大长度为 163 字节。 短消息情况下：3GPP 23.040 TP-User-Data，在文本模式下返回。格式定义如下： - 若（参见第 9.7 章）使用 3GPP TS 23.038 GSM 7 位默认字母格式字符， 未设置 3GPP TS 23.040 TP-User-Data-Header-Indication。 1) 若 TE 字符集为'HEX'之外的字符集（请参考 3GPP TS 27.007 中的选择 TE 字符 集命令 AT+CSCS），则根据 3GPP TS 27.005 Annex A 规则，ME/TA 将 GSM 字 母格式字符转换为当前的 TE 字符集。 2) 若 TE 字符集为'HEX'，则 ME/TA 将 GSM 字母格式字符的每个 7 位字符转换为 包含两个 IRA 字符的十六进制数字（如：字符 π（GSM 7 位默认字十进制数 22） 表示为 16（IRA 49 和 55）。 - 若（参见第 9.7 章）使用 8 位或 UCS2 数据编码方案，或者已设置 3GPP TS 23.040 TP-User-Data-Header-Indication：ME/TA 将每个 8 位字节转换为包含两 个 IRA 字符的十六进制数字（如：整数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 小区广播情况下：3GPP TS 23.041 CBM 消息内容，在文本模式下返回。格式定义如下： - 若（参见第 9.7 章）使用 3GPP TS 23.038 GSM 7 位默认字母格式字符： 1) 若 TE 字符集为'HEX'之外的字符集（请参考 3GPP TS 27.007 中的选择 TE 字符 集命令 AT+CSCS），则根据 3GPP TS 27.005 Annex A 规则，ME/TA 将 GSM 字 母格式字符转换为当前的 TE 字符集。 2) 若 TE 字符集为'HEX'，则 ME/TA 将 GSM 字母格式字符的每个 7 位字符转换为 包含两个 IRA 字符的十六进制数字。 - 若（参见第 9.7章）使用8位或UCS2数据编码方案：ME/TA 将每个8 位字节 转换为包含两个IRA 字符的十六进制数字。 短消息情况下：3GPP TS 24.011 服务中心地址和 3GPP TS 23.040 TPDU，十六进制格式； ME/TA 将 TP 数据单元中每个八位字节转换为包含 2 个 IRA 字符的十六进制数字（如： 整数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 整型。取决于命令或结果码：3GPP TS 23.040 SMS-DELIVER、SMS-SUBMIT（默认值： 17）、SMS-STATUS-REPORT 或 SMS-COMMAND（默认值：2）的第一个八位字节。 整型。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。详情参考 3GPP TS 23.040 TP-Recipient-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。详情参考 3GPP TS 24.011 TP-Recipient-Address 中的八位字节 Type-of-Address （默认参考）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Service-Centre-Time-Stamp（参见）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Discharge-Time。格式为：'yy/MM/dd, 上海移远通信技术股份有限公司 152 / 279 LTE Standard(U)系列 AT 命令手册 hh:mm:ss+zz'，格式中的字符依次代表年（后两位）、月、日、时、分、秒、时区。例如： 1994 年 5 月 6 日 22:10:00, GMT+2 小时用'94/05/06, 22:10:00+08'表示。 整型。详情参考 3GPP TS 23.040 TP-Status。 整型。详情参考 3GPP TS 23.040 TP-Command-Type（默认为 0）。 整型。详情参考 3GPP TS 23.041 CBM 序号。 整型。详情参考 3GPP TS 23.041 CBM 短消息标识符。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 4~7。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 0~3。 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 错误码。详情参考第 14.6 章。 举例 AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, OK //设置短消息为文本模式。 //列举短消息存储器中的所有短消息。 备注 存储器中短消息存储空间决定列出短消息的操作。 9.7. AT+CMGR 按照索引读取短消息 该命令用于从存储器中读取指定的短消息。若该短消息处于'REC UNREAD'，则其 在存储器中的状态将会变为'REC READ'。 AT+CMGR 按照索引读取短消息 测试命令 AT+CMGR=? 设置命令 AT+CMGR= 响应 OK 响应 1）文本模式（AT+CMGF=1）且该命令执行成功： 上海移远通信技术股份有限公司 153 / 279 最大响应时间 特性说明 参考 3GPP TS 27.005 LTE Standard(U)系列 AT 命令手册 对于 SMS-DELIVER： +CMGR: ,,[],[,,,,,,,] OK 对于 SMS-SUBMIT： +CMGR: ,,[][,,,,,[],,,] OK 对于 SMS-STATUS-REPORT： +CMGR: ,,,[],[],,, OK 对于 SMS-COMMAND： +CMGR: ,,[,,[],[],[], ] OK 对于 CBM 存储： +CMGR: ,,,,, OK 2）PDU 模式（AT+CMGF=0）且该命令执行成功： +CMGR: ,[], OK 若错误与 ME 功能相关： +CMS ERROR: 取决于短消息内容的长度。 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 154 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。存储器的位置编号。 1）文本模式，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式，整型。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 字符串类型。字母数字格式的或，对应 MT 电话簿中的条目。该功能的实现按照出 厂设定，所使用的字符集应与 AT+CSCS 选择的字符集相同（详情参考 3GPP TS 27.007 中 对该命令的定义）。 字符串类型。目标地址。详情参考 3GPP TS 23.040 中的 TP-Destination-Address AddressValue 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中 的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字符串类型。始发地址。详情参考 3GPP TS 23.040 中的 TP-Originating-Address AddressValue 字段；BCD 码（GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字 符（详情参考 TS 27.007 中的 AT+CSCS）。地址类型由指定。 字符串类型。短消息服务中心时间戳。详情参考 3GPP TS 23.040 TP-Service-Center-TimeStamp（参见）。 整型。取决于命令或结果码：3GPP TS 23.040 SMS-DELIVER、 SMS-SUBMIT（默认值： 17）、SMS-STATUS-REPORT 或 SMS-COMMAND（默认值：2）的第一个八位字节。 整型。协议标识符。详情参考 3GPP TS 23.040 TP-Protocol-Identifier。默认值：0。 整型。数据编码方案。取决于命令或结果码。详情参考 3GPP TS 23.038 短消息数据编码方 案（默认值为 0）或者小区广播数据编码方案。 整型或时间字符串类型。有效期。取决于 SMS-SUBMIT 的设置。详情参考 3GPP TS 23.040 TP-Validity-Period（参见）。 整型。短消息编号。详情参考 3GPP TS 23.040 TP-Message-Number。 整型。短消息参考。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。详情参考 3GPP TS 23.040 TP-Recipient-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 AT+CSCS）。 地址类型由指定。 整型。详情参考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address（参见）。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address 中的八位字节 Type-of-Address。 整型。始发地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address 中的八位字节 Type-of-Address（默认参考）。 上海移远通信技术股份有限公司 155 / 279 LTE Standard(U)系列 AT 命令手册 字符串类型。短消息服务中心地址。详情参考 3GPP TS 24.011 RP SC 地址 Address-Value； BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。短消息服务中心地址类型。详情参考 3GPP TS 24.011 RP SC 地址 Type-of-Address （默认参考）。 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示消息正文的长度；最大长度为 160 字节； PDU 模式（AT+CMGF=0）下，以八位字节为单位的实际 TP 数据单元的长度（即 RP 层的 短消息服务中心地址中的八位字节将不计算在该长度内）；最大长度为 163 字节。 短消息的文本内容。详情参见第 14.8 章。 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制格 式：ME/TA 把 TP 数据单元中每八位字节转换为包含 2 个 IRA 字符的十六进制数字（如：整 数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Discharge-Time。格式为：'yy/MM/dd, hh:mm:ss+zz'，格式中的字符依次代表年（后两位）、月、日、时、分、秒、时区。例如： 1994 年 5 月 6 日 22:10:00，GMT+2 小时用'94/05/06, 22:10:00+08'表示。 整型。详情参考 3GPP TS 23.040 TP-Status。 整型。详情参考 3GPP TS 23.040 TP-Command-Type（默认为 0）。 整型。详情参考 3GPP TS 23.041 CBM 序号。 整型。消息标识符。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 4~7。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 0~3。 详情参考 3GPP TS 23.040 TP-Command-Data 文本模式响应。ME/TA 把 TP 数据单元中每 八位字节转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值为 42 的八位字节作为两 个字符（2A，即 IRA 50 和 65）发送给 TE）。 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 错误码。详情参考第 14.6 章。 举例 +CMTI: 'SM',3 //已收到新短消息，存储在(U)SIM 卡为 3 的位置。 AT+CSDH=1 OK AT+CMGR=3 //读取短消息。 +CMGR: 'REC UNREAD','+8615021012496',,'13/12/13,15:06:37+32',145,4,0,0,'+8613800210500', 145,27 OK 上海移远通信技术股份有限公司 156 / 279 LTE Standard(U)系列 AT 命令手册 9.8. AT+CMGS 发送短消息 该命令用于将短消息（SMS-SUBMIT）从 TE 发送到网络侧。调用设置命令后，返回>后输入待发数据， 然后按 Ctrl+Z 表示 PDU 结束并发送短消息。可按 ESC 取消发送，取消成功也会返回 OK 表示终止确认。 发送成功后，将返回短消息参考值到 TE。 AT+CMGS 发送短消息 测试命令 AT+CMGS=? 设置命令 1）文本模式（AT+CMGF=1）： AT+CMGS=[,] >输入文本 Ctrl+Z 发送/ESC 取消发送 2）PDU 模式（AT+CMGF=0）： AT+CMGS= >指定 PDU Ctrl+Z 发送/ESC 取消发送 响应 OK 响应 1）文本模式（AT+CMGF=1）且发送成功： +CMGS: OK 2）PDU 模式（AT+CMGF=0）且发送成功： +CMGS: OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 120 秒，取决于网络状态 该命令立即生效； 参数配置不保存 参数 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address 中的八位字节 Type-of-Address。 整型。消息长度。 文本模式（AT+CMGF=1）下，表示消息正文（或，详见第 9.7 章）的字符 长度；最大长度为 160 字节； PDU 模式（AT+CMGF=0）下，表示八位字节格式的实际 TP 数据单元长度（即 RP 层的短 消息服务中心地址中的八位字节将不计算在该长度内）；最大长度为 158 字节。 整型。消息参考值。详情参考 3GPP TS 23.040 TP-Message-Reference。 错误码。详情参考第 14.6 章。 上海移远通信技术股份有限公司 157 / 279 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' >This is a test from Quectel +CMGS: 247 OK LTE Standard(U)系列 AT 命令手册 //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息内容，Ctrl+Z 发送，ESC 退出发送。 9.9. AT+CMMS 发送多条短消息 该命令用于控制短消息中断协议链路的连续性。若启用该功能（且当前使用的网络支持），链路保持打 开，此情况下可快速发送多条短消息。 AT+CMMS 发送多条短消息 测试命令 AT+CMMS=? 响应 +CMMS: (支持的范围) 查询命令 AT+CMMS? OK 响应 +CMMS: 设置命令 AT+CMMS[=] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 120 秒，取决于网络状态 该命令立即生效； 参数配置自动保存 上海移远通信技术股份有限公司 158 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。是否启用短消息中断协议链路功能。 0 禁用此功能 1 保持该功能启用状态，直到要发送的最新命令（AT+CMGS、AT+CMSS 等）的响应与 下 一条要发送的命令之间的时间间隔超过 1~5 秒（具体值取决于 ME）。随后 ME 关闭链路， MT 自动切换为 0。 2 启用该功能。若要发送的最新命令（AT+CMGS、AT+CMSS 等）的响应与下一条要发送 的命令之间的时间间隔超过 1~5 秒（具体值取决于 ME），ME 关闭链路，但 MT 不会自动 切换为 0。 错误码。详情参考第 14.6 章。 备注 执行查询命令后，隔 5~10 秒后再执行设置命令，否则，可能会返回错误码+CMS ERROR: 500。 9.10. AT+CMGW 存储短消息 该命令用于写入一条短消息并存储至，并返回已存储短消息的存储位置。通过， 可将短消息设置为指定的状态。默认情况下，短消息状态设置为'STO UNSENT'。文本输入的语法同 AT+CMGS 的设置命令相同。 AT+CMGW 存储短消息 测试命令 AT+CMGW=? 设置命令 1）文本模式（AT+CMGF=1）： AT+CMGW=[,[,]] >输入文本 Ctrl+Z 发送/ ESC 取消发送 2）PDU 模式（AT+CMGF=0）： AT+CMGW=[,] >指定 PDU Ctrl+Z 发送/ ESC 取消发送 最大响应时间 特性说明 参考 响应 OK 响应 +CMGW: OK 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置不保存 上海移远通信技术股份有限公司 159 / 279 GSM 07.05 LTE Standard(U)系列 AT 命令手册 参数 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字符串类型。始发地址。详情参考 3GPP TS 23.040 TP-Originating-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。始发地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address 中的八位字节 Type-of-Address（默认参考）。 1）文本模式，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式，整型。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 整型。始发地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address 中的八位字节 Type-of-Address。 整型。消息长度。 文本模式（AT+CMGF=1）下，表示消息正文（或，详见第 9.7 章）的字符 长度；最大长度为 160 字节； PDU 模式（AT+CMGF=0）下，表示八位字节格式的实际 TP 数据单元长度（即 RP 层的 短消息服务中心地址中的八位字节将不计算在该长度内）；最大长度为 163 字节。 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制 格式；ME/TA 将 TP 数据单元中每八位字符转换为包含 2 个 IRA 字符的十六进制数字（如： 整数取值为 42 的八位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE）。 整型。存储器中的短消息序号。 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 错误码。详情参考第 14.6 章。 上海移远通信技术股份有限公司 160 / 279 LTE Standard(U)系列 AT 命令手册 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' >This is a test from Quectel +CMGW: 4 //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息文本内容，按 Ctrl+Z 写入短消息，按 ESC 退出发送。 OK AT+CMGF=0 //设置短消息模式为 PDU 模式。 OK AT+CMGW=18 >0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK 9.11. AT+CMSS 从存储器发送短消息 该命令用于从存储器中发送指定的短消息（SMS-SUBMIT）。若指定 SMS-SUBMIT 短消息目标地址，则在发送短消息时使用新地址替换存储器中短消息包含的目标地址。发送成功后， 将返回参考值到 TE，其参数值可用于识别发送状态报告 URC 中的短消息。 AT+CMSS 从存储器发送短消息 测试命令 AT+CMSS=? 设置命令 AT+CMSS=[,[,]] 响应 OK 响应 1）文本模式（AT+CMGF=1）且执行成功： +CMSS: [,] OK 2）PDU 模式（AT+CMGF=0）且执行成功： +CMSS: [,] OK 最大响应时间 若错误与 ME 功能相关： +CMS ERROR: / 上海移远通信技术股份有限公司 161 / 279 LTE Standard(U)系列 AT 命令手册 特性说明 参考 3GPP TS 27.005 该命令立即生效； 参数配置不保存 参数 整型。存储器位置编号。 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）；地址类型由指定。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address 中的八位字节 Type-of-Address。 整型。短消息参考。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。短消息服务中心时间戳。详情参考 3GPP TS 23.040 TP-Service-Centre-TimeStamp 中的时间字符（参考）。 字符串类型。格式与短消息中的的格式相同，但无 3GPP TS 24.011 SC 中的地址字 段。 错误码。详情参考第 14.6 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK AT+CMSS=4 +CMSS: 54 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息内容，Ctrl+Z 发送短消息，ESC 退出发送。 //从存储器中发送为 4 的短消息。 上海移远通信技术股份有限公司 162 / 279 LTE Standard(U)系列 AT 命令手册 9.12. AT+CNMA 新短消息确认 该命令用于确认直接发送至 TE 的新消息（SMS-DELIVER 或 SMS-STATUS-REPORT）是否已经成功 发送。若 UE 未在需求时间内收到确认（网络超时），会发送 RP-ERROR 至网络。UE 可通过设置 AT+CNMI 的参数和为 0 自动禁止发送至 TE。 AT+CNMA 新短消息确认 测试命令 AT+CNMA=? 响应 +CNMA: (支持的范围) 执行命令 AT+CNMA OK 响应 OK 或者 ERROR 设置命令 AT+CNMA= 若错误与 ME 功能相关： +CMS ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。PDU 模式所需参数。 0 命令操作类似文本模式 1 发送肯定应答（RP-ACK）至网络，仅 PDU 模式下接受 2 发送否定应答（RP-ERROR）至网络，仅 PDU 模式下接受 错误码。详情参考第 14.6 章。 备注 仅当 AT+CSMS 中为 1（phase 2+）且模块下发了如下对应 URC 时方可使用执行命令和设置 上海移远通信技术股份有限公司 163 / 279 LTE Standard(U)系列 AT 命令手册 命令： +CMT: =2，新消息类别为 CLASS 0、1、3 和无 +CMT: =3，新消息类别为 CLASS 0 和 3 +CDS: =1 举例 AT+CSMS=1 OK AT+CNMI=1,2,0,0,0 OK AT+CMGF=1 OK AT+CSDH=1 OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. AT+CNMA //收到新短消息，直接输出短消息内容。 //向网络发送确认消息。 OK AT+CNMA +CMS ERROR: 340 //第二次返回错误，仅需确认一次。 9.13. AT+CNMI 设置新短消息上报方式 该命令用于配置模块收到新短消息时的上报方式。 该设置命令选择在 TE 处于活动状态时（DTR 处于低电平），从网络接收到的新消息指示给 TE 的方式。 如果 TE 处于非活动状态（DTR 处于高电平），则应按照 3GPP TS 23.038 中的规定进行消息接收。 AT+CNMI 设置新短消息上报方式 测试命令 AT+CNMI=? 响应 +CNMI: (支持的范围),(支持的范围),(支持的 列表),(支持的范围),(支持的列表) 查询命令 AT+CNMI? OK 响应 +CNMI: ,,,, 设置命令 OK 响应 AT+CNMI[=[,[,[,[,]]]]] 最大响应时间 特性说明 参考 3GPP TS 27.005 或者 ERROR 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。 0 缓冲 TA 中的非请求结果码。若 TA 结果码缓冲区已满，结果码指示可以存储在其他缓冲 区或者丢弃最早的结果码指示，替换为新接收到的指示。 1 若 TA-TE 间的链路被保留（即处于在线数据模式），丢弃指示并拒绝新接收的短消息结 果码指示，否则，直接转发给 TE。 2 若 TA-TE 间的链路被保留（比如：处于在线数据模式），缓冲 TA 中的非请求结果码并将 结果码发送给 TE，否则，直接转发给 TE。 3 直接将结果码发送给 TE。TA 处于在线数据模式时，TA-TE 间链路特定的带内技术用于 嵌入结果代码和数据。 整型。新短消息上报方式。存储接收到的短消息规则取决于其数据编码方案（参考 3GPP TS 23.038）和首选存储器（AT+CPMS）设置。 0 不将新短消息提示发送给 TE。 1 若新短消息存储至 ME/TA，新短消息提示通过 URC +CMTI: ,方式发 送给 TE。 2 新短消息（CLASS 2 消息除外）通过 URC +CMT: [],（PDU 模式）或者+CMT: ,[],[,,,,,,,]（文本模式；斜体参数解释详见 AT+CSDH） 方式发送给 TE。CLASS 2 消息结果指示如=1 所定义。 3 在收到 CLASS 3 短消息时，新短消息通过=2 时定义的 URC 发送给 TE。其他类 型的短消息通过=1 时定义的 URC 指示发送给 TE。 整型。存储接收的 CBM 规则取决于其数据编码方案（详情参考 3GPP TS 23.038）和选择小 区广播消息类型的设置。 0 无 CBM 指示发送到 TE 2 收到的 CBM 使用如下 URC 直接发送到 TE： +CBM: （PDU 模式） 或者 +CBM: ,,,,（文本模式） 整型。短消息状态报告的上报方式。 0 不将状态报告 SMS-STATUS-REPORT 发给 TE 1 状态报告 SMS-STATUS-REPORT 通过如下 URC 上报 TE： 上海移远通信技术股份有限公司 165 / 279 LTE Standard(U)系列 AT 命令手册 +CDS: （PDU 模式） 或者 +CDS: ,,[],[],,,（文本模式） 整型。 0 当为 1 或 2 时，将 TA 缓冲区的非请求结果码发送至 TE（返回 OK 后刷新）。 1 当为 1 或 2 时，清空 TA 缓冲区的非请求结果码。 错误码。详情参考第 14.6 章。 备注 URC 说明： +CMTI: , +CMT: [], +CBM: 表示接收到新消息 表示直接输出短消息 表示直接输出小区广播消息 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CNMI=1,2,0,1,0 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //设置 SMS-DELIVER 消息直接发送至 TE。 +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel //收到新短消息，直接输出短消息内容。 9.14. AT+CSDH 设置文本模式下参数显示 该命令用于控制是否在文本模式下的结果码中显示详细的报头信息。 AT+CSDH 设置文本模式下参数显示 测试命令 AT+CSDH=? 响应 +CSDH: (支持的列表) 查询命令 AT+CSDH? OK 响应 +CSDH: 设置命令 OK 响应 上海移远通信技术股份有限公司 166 / 279 LTE Standard(U)系列 AT 命令手册 AT+CSDH[=] 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 或者 ERROR 300 毫秒 / 参数 整型。 0 在短消息命令+CMT，+CMGL，+CMGR 结果码中不显示下述头信息： 对于文本模式下的 SMS-DELIVER 和 SMS-SUBMIT 类型短消息，在+CSCA 和 +CSMP 的结果码中不包含、、、、和；在+CMT、 +CMGL、+CMGR 结果码中不显示、或者。 1 在结果码中显示头信息 举例 AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT','', OK AT+CSDH=1 OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 OK 9.15. AT+CSMP 设置短消息文本模式参数 在文本模式下（AT+CMGF=1），当向网络侧发送短消息或将短消息存放在存储器中时，该命令用于设 置需要附加的参数取值。除此之外，还可以用于设置从短消息服务中心接收到该短消息时的有效期（ 的取值范围：0~255）或定义有效期结束的绝对时间（为字符串）。 上海移远通信技术股份有限公司 167 / 279 LTE Standard(U)系列 AT 命令手册 AT+CSMP 设置短消息文本模式参数 测试命令 响应 AT+CSMP=? 查询命令 OK 响应 AT+CSMP? +CSMP: ,,, 设置命令 OK 响应 AT+CSMP=[,[,[,]]] OK 最大响应时间 300 毫秒 特性说明 / 参考 3GPP TS 27.005 参数 整型。TPDU 的第一个字节。对于不同的消息类型的详情参考 3GPP TS 23.040。 整型或者字符串类型。有效期。取决于 SMS-SUBMIT 的的设置，详细参考 3GPP TS 23.040 TP-Validity-Period（参考）。 整型。协议标识符。详情参考 3GPP TS 23.040 TP-Protocol-Identifier。默认值：0。 整型。数据编码方案。取决于命令或结果码：3GPP TS 23.038 SMS 数据编码方案（默认值： 0），或者小区广播数据编码方案。 9.16. AT+QCMGS 发送级联短消息 该命令用于发送级联短消息。与 AT+CMGS 不同，通过该命令发送一个级联短信时，每段级联短消息 都必须由附加参数（、和）标识。分段发送所有短消息时，必须多次（由 设置）执行该命令。该命令仅用于文本模式下（AT+CMGF=1）。 AT+QCMGS 发送级联短消息 测试命令 AT+QCMGS=? 设置命令 文本模式（AT+CMGF=1）: AT+QCMGS=[,],,, >输入文本 Ctrl+Z 发送/Ctrl+ESC 取消发送 响应 OK 响应 若处于文本模式下（AT+CMGF=1）且命令执行成功： +QCMGS: OK 或者 ERROR 上海移远通信技术股份有限公司 168 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。用户数据头（UDH）中的消息标识。范围：0~255。该参数由用户定义和输 入。同一条级联消息的所有分段必须使用相同的。不同的级联消息应使用不 同的。 整型。级联消息序号。范围：0~7。 =0：忽略该值并将其视为非级联消息。 整型。一条级联消息的分段数量。范围：0~7。 =0 或 1：忽略该值并将其视为非级联消息。 参见 AT+CMGS。 参见 AT+CMGS。 参见 AT+CMGS。 错误码。详情参考第 14.6 章。 备注 1. 对于级联短消息来说，最大长度将根据用户数据头（UDH）的长度的进行缩减。3GPP TS 23.040 定义了两种 UDH 长度：6 字节和 7 字节。因此，两种为 8 位（6 字节）和 16 位（7 字节）。 AT+QCMGS 使用 8 位。 ⚫ GSM 7 位默认字母数据编码方案情况下，每个分段级联消息的最大长度为（140-6）* 8 / 7 = 153 个字符。 ⚫ 16 位 UCS2 数据编码方案情况下，每个分段级联消息的最大长度为（140-6）/ 2 = 67 个字符。 ⚫ 8 位数据编码方案情况下，每个分段级联消息的最大长度为 140-6=134 个字符。 2. 整型。MS 发送给 SC 的 SMS-SUBMIT 或 SMS-COMMAND 的参考号，位于 MessageReference 字段，用于确认是否已从 SC 副本接收到 SMS-DELIVER。 UDH 字段，级联短消息标识。与不同，同一条级联消息的所有分段使用相同的， 但是必须递增。 3. AT+QCMGS 不支持在 PDU 模式下（AT+CMGF=0）发送消息。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+QCMGS='15056913384',120,1,2 >ABCD //设置 SMS 模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //设置为 120，并发送第一段级联 SMS。 上海移远通信技术股份有限公司 169 / 279 +QCMGS: 190 OK AT+QCMGS='15056913384',120,2,2 >EFGH +QCMGS: 191 OK LTE Standard(U)系列 AT 命令手册 //发送第二段级联 SMS。 9.17. AT+QCMGR 读取级联短消息 该命令的功能与 AT+CMGR 相似，但该命令读取的是一个分段级联消息。命令执行成功后，响应的结 果中包含参数、和，并且根据这三个参数，可以将几个分段消息级联到同一 段短消息中。该命令仅用于文本模式（AT+CMGF=1）。 AT+QCMGR 读取级联短消息 测试命令 AT+QCMGR=? 设置命令 AT+QCMGR= 响应 OK 响应 若处于文本模式下（AT+CMGF=1）且命令执行成功： 对于 SMS-DELIVER 来说： +QCMGR: ,,[],[,,,,,,,][,,,< msg_total>] OK 对于 SMS-SUBMIT 来说： +QCMGR: ,,[][,,,,,[],,,][,,,< msg_total>] OK 对于 SMS-STATUS-REPORT 来说： +QCMGR: ,,,[],[],,, OK 对于 SMS-COMMAND 来说： 上海移远通信技术股份有限公司 170 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 +QCMGR: ,,[,,[],[],[],] OK 若错误与 ME 功能相关： +CMS ERROR: 取决于消息内容长度 / 参数 整型。用户数据头（UDH）中的消息标识。范围：0~65535。同一条级联消息的所有分 段必须使用相同的。不同的级联消息应使用不同的。 整型。级联消息序号。范围：1~7。 整型。一条级联消息的分段数量。范围：2~7。 错误码。详情参考第 14.6 章。 备注 1. 该命令中出现的其他参数，详情请参考 AT+CMGR。 2. AT+QCMGR 的与 AT+QCMGS 中的不同。UE 可能会收到 8 位或 16 位的级联 消息。因此，它的最大值有两种情况：8 位为 255，而 16 位为 65535。 3. 若读取的消息不是级联消息，响应结果中将不显示、和。 举例 +CMTI: 'SM',3 //收到第一条分段级联消息。 +CMTI: 'SM',4 //收到第二条分段级联消息。 AT+QCMGR=3 //读取第一条分段级联消息。 +QCMGR: 'REC UNREAD','+8615056913384',,'13/07/30,14:44:37+32',120,1,2 ABCD OK AT+QCMGR=4 //读取第二条分段级联消息。 +QCMGR: 'REC UNREAD','+8615056913384',,'13/07/30,14:44:37+32',120,2,2 EFGH OK 上海移远通信技术股份有限公司 171 / 279 LTE Standard(U)系列 AT 命令手册 10 分组域命令 10.1. AT+CGATT PS 域附着或去附着 该设置命令用于将 MT 附着于 PS 域，或者将 MT 从 PS 域分离。命令完成后，MT 保持在 V.250 命令 状态。如果 MT 已经处于请求状态，则将忽略该命令，并且仍响应 OK。如果 MT 无法实现请求状态，将响 应 ERROR 或+CME ERROR。 AT+CGATT PS 域附着或去附着 测试命令 AT+CGATT=? 响应 +CGATT: (支持的列表) 查询命令 AT+CGATT? OK 响应 +CGATT: 设置命令 AT+CGATT= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 140 秒，取决于网络状态 该命令是否生效取决于网络状态； 参数配置不保存。 参数 整型。PS 服务状态。 0 分离状态 1 附着状态 上海移远通信技术股份有限公司 172 / 279 LTE Standard(U)系列 AT 命令手册 其他值为预留值，设置后将返回 ERROR。 错误码。详情参考第 14.5 章。 举例 AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //附着于 PS 域。 //从 PS 域分离。 //查询当前 PS 域状态。 10.2. AT+CGDCONT 定义 PDP 上下文 该 命 令 为 指 定 的 上 下 文 标 识 所 标 识 的 PDP 上 下 文 参 数 。 设 置 命 令 的 一 种 特 殊 形 式 AT+CGDCONT=表示删除对应的 PDP 上下文参数，使其变成未定义。不允许更改已激活上下 文的定义。 该查询命令返回每个已定义 PDP 上下文的当前配置。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT：(支持的范围),,,,(支持的范围),(支持的范 围),(支持的范围),(支持的 范围) 查询命令 AT+CGDCONT? OK 响应 +CGDCONT: ,,,,,,, […] 设置命令 AT+CGDCONT=[,[ ,[,[,[,[,[,]]]]]]] OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 173 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 该命令立即生效； 自动保存参数配置。 参数 整型。PDP 上下文标识，用于指定特定 PDP 上下文的定义。该参数是 TE-MT 接口 的本地参数，在其他与 PDP 上下文相关的命令中使用。允许值的范围由测试命令返回 （最小值为 1）。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 配置双栈 UE 功能，支持 IPv4 与 IPv6（RFC 2460） 字符串类型。接入点名称，用于选择 GGSN 或外部分组数据网络的逻辑名称。若该值为 空或省略时，将使用订阅值。 字符串类型。用于标识适用于 PDP 的地址空间中的 MT。如果该值为空或被省略，则 TE 在 PDP 启动过程中提供该值，否则，将请求动态地址。可以使用 AT+CGPADDR 读 取分配的地址。 整型。控制 PDP 数据是否需要压缩（仅适用于 SNDCP） （详情请参考 3GPP TS 44.065）。 0 关闭 1 打开（制造商指定） 2 V.42bis 整型。控制 PDP 头部数据压缩（详情请参考 3GPP TS 44.065 和 3GPP TS 25.323）。 0 关闭 1 打开 2 RFC1144 3 RFC2507 4 RFC3095 整型。控制 MT/TA 请求获取 IPv4 地址信息的方式。 0 通过 NAS 信令获取 IPv4 地址 1 通过 DHCP 获取 IPv4 地址 整型。PDP 上下文的上下文激活请求类型。 0 PDP 上下文用于新的 PDP 上下文建立或从非 3GPP 接入网切换（MT 如何确 定 PDP 上下文是用于新的 PDP 上下文建立还是用于接入网切换视具体情况 而定） 1 PDP 上下文用于紧急承载服务 上海移远通信技术股份有限公司 174 / 279 LTE Standard(U)系列 AT 命令手册 备注 EC200D 系列模块支持的和取值仅为 0 和 1。 10.3. AT+CGQREQ 服务质量参数（请求的） 在 TE 激活 PDP 上下文时，该命令允许 TE 指定服务质量参数。 该设置命令指定上下文参数。设置命令的一种特殊形式 AT+CGQREQ=会使上下文标识符 请求的参数处于未定义状态。查询命令返回每一个已定义的上下文的当前配置。详细信息请参考 3GPP TS 23.107。 AT+CGQREQ 服务质量参数（请求的） 测试命令 AT+CGQREQ=? 响应 +CGQREQ: ,(支持的范围),(支持的 范围),(支持的范围),(支持的范围), (支持的范围) 查询命令 AT+CGQREQ? OK 响应 [+CGQREQ: ,,,>reliability>,,] [+CGQREQ: ,,,,,] […] 设置命令 AT+CGQREQ=[,[,[,[,[ ,]]]]] OK 响应 OK 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 300 毫秒 特性说明 参考 3GPP TS 27.007 该命令立即生效； 自动保存参数配置。 上海移远通信技术股份有限公司 175 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。特定 PDP 上下文的定义（详情请参考 AT+CGDCONT）。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 配置双栈 UE 功能，支持 IPv4 与 IPv6（RFC 2460） 整型。优先等级。 0 网络订阅值 1 高优先级。服务优先级在 2 级和 3 级优先级之前 2 正常优先级。服务优先级在 3 级优先级之前 3 低优先级。继续保持服务 整型。延迟类别。该参数定义通过网络传输 SDU 时发生的端到端传输延迟。详情请参 考表 6。 0 网络订阅值 1 < 0.5 2 < 5 3 < 50 4 未指定 整型。依赖等级。 0 网络订阅值 1 不能有效处理数据丢失、非实时传输的误码铭感应用 2 不能有效处理偶尔数据丢失、非实时传输的误码铭感应用 3 能有效处理数据丢失，GMM/SM 和 SMS 非实时性传输的误码敏感应用 4 能有效处理数据丢失、实时传输的误码敏感应用 5 能有效处理数据丢失、实时传输的误码不敏感应用 整型。每秒峰值吞吐量等级（以字节计）。 0 网络订阅值 1 高达 1 000（8 kbit/s） 2 高达 2 000（16 kbit/s） 3 高达 4 000（32 kbit/s） 4 高达 8 000（64 kbit/s） 5 高达 16 000（128 kbit/s） 6 高达 32 000（256 kbit/s） 7 高达 64 000（512 kbit/s） 8 高达 128 000（1024 kbit/s） 9 高达 256 000（2048 kbit/s） 整型。每秒平均吞吐量等级（以字节计）。 0 网络订阅值 1 100（~0.22 bit/s） 2 200（~0.44 bit/s） 3 500（~1.11 bit/s） 4 1 000（~2.2 bit/s） 上海移远通信技术股份有限公司 176 / 279 5 2 000（~4.4 bit/s） 6 5 000（~11.1 bit/s） 7 10 000（~22 bit/s） 8 20 000（~44 bit/s） 9 50 000（~111 bit/s） 10 100 000（~0.22 kbit/s） 11 200 000（~0.44 kbit/s） 12 500 000（~1.11 kbit/s） 13 1000 000（~2.2 kbit/s） 14 2 000 000（~4.4 kbit/s） 15 5 000 000（~11.1 kbit/s） 16 10 000 000（~22 kbit/s） 17 20 000 000（~44 kbit/s） 18 50 000 000（~111 kbit/s） 31 最大能力 错误码。详情请参考第 14.5 章。 LTE Standard(U)系列 AT 命令手册 表 6：延迟类别 SDU 大小 128 个八位字节 1024 个八位字节 延迟类别 1（预测） 2（预测） 3（预测） 4（最大能力） 1（预测） 2（预测） 3（预测） 4（最大能力） 平均传输延迟 < 0.5 < 5 < 50 未指定 < 0.5 < 5 < 50 未指定 95% < 1.5 < 25 < 250 / < 1.5 < 25 < 250 / 10.4. AT+CGQMIN 服务质量参数（最低可接受的） 该命令允许 TE 指定最低可接受的配置文件参数，当激活 PDP 上下文时，由 MT 根据协商的参数检查 该最低可接受的配置文件。设置命令指定上下文标识符标识的上下文的参数。 上海移远通信技术股份有限公司 177 / 279 LTE Standard(U)系列 AT 命令手册 设置命令的一种特殊形式 AT+CGQMIN=会使上下文标识符的最低可接受的配置文件处于 未定义状态，此时将不会对协商的配置文件进行检查。查询命令返回每个已定义 PDP 上下文的当前配置。 详情请参考 3GPP TS 23.107。 AT+CGQMIN 服务质量参数（最低可接受的） 测试命令 AT+CGQMIN=? 响应 +CGQMIN: ,(支持的范围),(支持 的列表),(支持的范围),(支持的范 围),(支持的范围) 查询命令 AT+CGQMIN? OK 响应 [+CGQMIN: ,,,,,] [+CGQMIN: ,,,,,] […] 设置命令 AT+CGQMIN=[,[,< delay>[,[,[, ]]]]] OK 响应 OK 若出现 ME 相关错误： +CME ERROR: 最大响应时间 300 毫秒 特性说明 参考 3GPP TS 27.007 该命令立即生效； 不保存参数配置。 参数 整型。特定 PDP 上下文的定义（详情请参考 AT+CGDCONT）。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 配置双栈 UE 功能，支持 IPv4 与 IPv6（RFC 2460） 整型。优先等级。 0 网络订阅值 1 高优先级。服务优先级在 2 级和 3 级优先级之前 2 正常优先级。服务优先级在 3 级优先级之前 3 低优先级。继续保持服务 上海移远通信技术股份有限公司 178 / 279 LTE Standard(U)系列 AT 命令手册 整型。延迟类别。该参数定义通过网络传输 SDU 时发生的端到端传输延迟。详情请参 考表 6。 0 网络订阅值 1 < 0.5 2 < 5 3 < 50 4 未指定 整型。依赖等级。 0 网络订阅值 1 不能有效处理数据丢失、非实时传输的误码铭感应用 2 不能有效处理偶尔数据丢失、非实时传输的误码铭感应用 3 能有效处理数据丢失，GMM/SM 和 SMS 非实时性传输的误码敏感应用 4 能有效处理数据丢失、实时传输的误码敏感应用 5 能有效处理数据丢失、实时传输的误码不敏感应用 整型。每秒峰值吞吐量等级（以字节计）。 0 网络订阅值 1 高达 1 000（8 kbit/s） 2 高达 2 000（16 kbit/s） 3 高达 4 000（32 kbit/s） 4 高达 8 000（64 kbit/s） 5 高达 16 000（128 kbit/s） 6 高达 32 000（256 kbit/s） 7 高达 64 000（512 kbit/s） 8 高达 128 000（1024 kbit/s） 9 高达 256 000（2048 kbit/s） 整型。每秒平均吞吐量等级（以字节计）。 0 网络订阅值 1 100（~0.22 bit/s） 2 200（~0.44 bit/s） 3 500（~1.11 bit/s） 4 1 000（~2.2 bit/s） 5 2 000（~4.4 bit/s） 6 5 000（~11.1 bit/s） 7 10 000（~22 bit/s） 8 20 000（~44 bit/s） 9 50 000（~111 bit/s） 10 100 000（~0.22 kbit/s） 11 200 000（~0.44 kbit/s） 12 500 000（~1.11 kbit/s） 13 1000 000（~2.2 kbit/s） 14 2 000 000（~4.4 kbit/s） 15 5 000 000（~11.1 kbit/s） 16 10 000 000（~22 kbit/s） 17 20 000 000（~44 kbit/s） 上海移远通信技术股份有限公司 179 / 279 18 50 000 000（~111 kbit/s） 31 最大能力 错误码。详情请参考第 14.5 章。 LTE Standard(U)系列 AT 命令手册 10.5. AT+CGACT PDP 上下文激活/去激活 该设置命令用于激活或去激活指定的 PDP 上下文。命令设置完成后，MT 保持 V.250 命令状态。若任 意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；在执行激活命令时，如果 MT 没有附着 PS， 则 MT 会先进行 PS 附着，然后尝试激活指定的上下文。如果无指定激活或去激活命令时，将会激活 或去激活所有定义的上下文。 AT+CGACT PDP 上下文激活/去激活 测试命令 AT+CGACT=? 响应 +CGACT: (支持的列表) 查询命令 AT+CGACT? OK 响应 +CGACT: , [+CGACT: , …] 设置命令 AT+CGACT=, OK 响应： OK 或者 NO CARRIER 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现任何 ME 错误： +CME ERROR: 150 秒，取决于网络状态 该命令是否生效取决于网络状态； 参数配置不保存。 参数 整型。PDP 上下文激活状态。 0 去激活 1 激活 上海移远通信技术股份有限公司 180 / 279 LTE Standard(U)系列 AT 命令手册 其他值为预留值，设置后将返回 ERROR。 整型。指定 PDP 上下文的定义（详情请参考 AT+CGDCONT）。 错误码。详情请参考第 14.5 章。 备注 1. ECx00U、EGx00U 和 EG91xU 系列模块若启用 VoLTE 功能，则的范围为 1~5。 2. EC200D 系列模块若启用 VoLTE 功能，则的范围为 1~9。 举例 AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGACT=0,1 OK //定义 PDP 上下文。 //激活 PDP。 //去激活 PDP。 10.6. AT+CGDATA 进入数传状态 执行设置命令后，MT 将使用一种或多种分组域 PDP 类型进行操作，使 TE 与网络之间建立通信，可 能也会包括进行 PS 附着及一个或多个 PDP 上下文激活操作。MT 不会处理 AT 命令行中 AT+CGDATA 之 后的命令。 若 MT 无法接收的值，将返回 ERROR 或+CME ERROR。若可以接收，MT 将返回中间结果代 码 CONNECT 并输入 V.250 在线数传状态。数据传输完成且第二层协议终止流程已成功完成后，将重新进 入命令状态，MT 将返回最终结果码 OK。 AT+CGDATA 进入数传状态 测试命令 AT+CGDATA=? 响应 +CGDATA: (支持的列表) 设置命令 AT+CGDATA=[,[,[,… ]]] OK 响应 CONNECT 或者 ERROR 若出现任何 ME 错误： +CME ERROR: 上海移远通信技术股份有限公司 181 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 该命令是否生效取决于网络状态； 参数配置不保存。 参数 字符串类型。TE 和 MT 之间使用的第二层协议。 PPP IP 等 PDP 的点对点协议。 不支持其他值，若配置为其他值，将返回 ERROR。 整型。特定 PDP 上下文的定义（详情请参考 AT+CGDCONT）。 错误码。详情请参考第 14.5 章。 10.7. AT+CGPADDR 显示 PDP 地址 该设置命令返回指定上下文标识符的 PDP 地址列表。若未指定，则返回所有已定义上下文的地 址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (支持的已定义的列表) 设置命令 AT+CGPADDR[=[,[,…]]] OK 响应 +CGPADDR: , [+CGPADDR: , …] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 或者 ERROR 300 毫秒 该命令是否生效取决于网络状态； 参数配置不保存。 上海移远通信技术股份有限公司 182 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。特定 PDP 上下文的定义（详情请参考 AT+CGDCONT）。 字符串类型。PDP 地址，用于在适用于 PDP 的地址空间中识别 TE。 地址可以为静态或动态： 静态地址在定义上下文时由 AT+CGDCONT 设置。 动态地址在上一次 PDP 上下文激活（使用了指定的上下文定义）期间分配。若无 可用的地址，则省略。 举例 AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' OK //定义 PDP 上下文。 //激活 PDP。 //显示 PDP 地址。 10.8. AT+CGCLASS GPRS 移动台类别 该命令使 MT 按照指定的 GPRS 移动台操作模式进行操作。详情请参考 3GPP TS 23.060。 AT+CGCLASS GPRS 移动台类别 测试命令 AT+CGCLASS=? 响应 +CGCLASS: (支持的列表) 查询命令 AT+CGCLASS? OK 响应 +CGCLASS: 设置命令 AT+CGCLASS= OK 响应 OK 或者 ERROR 最大响应时间 若错误与 ME 相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 183 / 279 LTE Standard(U)系列 AT 命令手册 特性说明 参考 3GPP TS 27.007 该命令重启生效； 参数配置自动保存。 参数 字符串类型。表示 GPRS 移动台类别（按功能降序排列）。 'B' Class-B 操作模式（A/Gb 模式）或 CS/PS 操作模式（Iu 模式） 'CG' 仅 PS 模式（A/Gb 模式）或 PS 操作模式（Iu 模式） 其他值为预留值，设置后将返回 ERROR。 错误码。详情参考第 14.5 章。 备注 1. ='B'表示 MT 可处理 PS 或 CS 业务，但不能同时进行；='CG'表示 MT 仅处理 PS 业务。 2. EC200D 系列模块仅支持'B'。 3. ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 10.9. AT+CGREG PS 域网络注册状态 该命令用于查询网络注册状态并控制非请求结果码上报： ⚫ =1 时，控制 URC +CGREG: 的上报，该 URC 表示 MT 的 GPRS 网络注册状态的变化。 ⚫ =2 时，控制 URC +CGREG: [,[],[],[]]的上报，该 URC 表示 GPRS 网 络小区的变化。 AT+CGREG PS 域网络注册状态 测试命令 AT+CGREG=? 响应 +CGREG: (支持的范围) 查询命令 AT+CGREG? OK 响应 +CGREG: ,[,,[,]] 设置命令 AT+CGREG[=] OK 响应 OK 或者 上海移远通信技术股份有限公司 184 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。控制指定 URC 的上报。 0 禁止上报网络注册 URC 1 允许上报网络注册 URC +CGREG: 2 允许上报网络注册和位置信息 URC： +CGREG: [,,[,]] 整型。GPRS 注册状态。 0 未注册。MT 当前未搜索注册业务的运营商。UE 处于 GMM 状态 GMM-NULL 或 GMM-DEREGISTERED-INITIATED。GPRS 服务被禁用，但用户请求后允许 UE 附着 于 GPRS。 1 已注册，归属地网络。UE 处于归属地 PLMN 的 GMM 状态 GMM-REGISTERED 或 GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED。 2 未注册，但 MT 当前正尝试附着或搜索网络以进行注册。UE 处于 GMM 状态 GMM- DEREGISTERED 或 GMM-REGISTERED-INITIATED。GPRS 服务处于使能状 态，但允 许的 PLMN 当前不可用。UE 将会在允许的 PLMN 可用时开始附着 GPRS。 3 注册被拒绝。UE 处于 GMM 状态 GMM-NULL。GPRS 服务为禁用状态且用户请求时 UE 无法附着 GPRS。 4 未知 5 已注册，漫游状态 字符串类型。十六进制格式的两字节位置区号（例如：'00C3'等价于十进制的 195）。 字符串类型。十六进制格式的 16 位（GSM）或 28 位（LTE）小区 ID 。 整型。网络接入技术。 0 GSM 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 备注 ECx00U、EGx00U 系列和 EG91xU 系列模块支持参数取值 0 和 7；EC200D 系列模块支持参数 取值 2, 4~7；ECx00G、EGx00G 系列和 EG915G-EU 模块支持参数取值 7。 上海移远通信技术股份有限公司 185 / 279 举例 AT+CGREG=2 OK AT+CGATT=0 OK +CGREG: 2 AT+CGATT=1 OK +CGREG: 1,'D5D5','8054BBF',7 LTE Standard(U)系列 AT 命令手册 10.10. AT+CGEREP 分组域事件上报 当分组域或网络中发生某些事件时，该设置命令启用/禁用从 MT 发送非请求结果码+CGEV 至 TE。 控制该命令指定的非请求结果码的处理。当指定为 1 时，控制缓存的非请求结果码。 AT+CGEREP 分组域事件上报 测试命令 AT+CGEREP=? 响应 +CGEREP: (支持的列表),(支持的列表) 查询命令 AT+CGEREP? OK 响应 +CGEREP: , 设置命令 AT+CGEREP=[,] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。控制该命令中指定的非请求结果码的处理。 0 缓存 MT 中的非请求结果码；若 MT 结果码缓存已满，最早的非请求结果码将被丢弃。 上海移远通信技术股份有限公司 186 / 279 LTE Standard(U)系列 AT 命令手册 结果码将不会转发至 TE。 1 当 MT-TE 间的链路被占用时（比如：在线数据模式下），丢弃非请求结果码；反之， 直接转发至 TE。 整型。控制缓存代码。 0 当为 1 时，清除 MT 中缓存的指定的非请求结果码 1 当为 1 时，MT 中缓存的指定的非请求结果码刷新到 TE（返回 OK 后刷新） 备注 非请求结果码及其对应的事件定义如下： 1. +CGEV: REJECT ,：当MT无法通过+CRING非请求结果码将PDP上下 文激活事件上报TE且MT被自动拒绝时将向网络请求激活PDP上下文。 备注：该事件不适用于EPS。 2. +CGEV: NW REACT ,,[]：网络已经请求上下文重新激活。若MT 已知悉，则会提供用于重新激活上下文的。 备注：该事件不适用于EPS。 3. +CGEV: NW DEACT ,,[]：网络强制去激活上下文。若MT知悉 ，则会提供用于激活上下文的。 4. +CGEV: ME DEACT ,,[]：ME已强制去激活了上下文。若MT已知 悉，则会提供用于激活上下文的。 5. +CGEV: NW DETACH：网络已强制去附着分组域，表示已经去激活所有的已激活的上下文。去激 活的上下文不会分开上报。 6. +CGEV: ME DETACH：ME已强制去附着分组域，表示已经去激活所有的已激活的上下文。去激活 的上下文不会分开上报。 7. +CGEV: NW CLASS ：网络已强制更换移动台类型，且上报最高可用类型（详情请参考 AT+CGCLASS）。 8. +CGEV: ME CLASS ：ME已强制更换移动台类型，且上报最高可用类型（详情请参考 AT+CGCLASS）。 9. +CGEV: PDN ACT ：已激活上下文。该上下文表示LTE的PDN连接或GSM的第一个PDP上下 文。 10. +CGEV: PDN DEACT ：去激活上下文。该上下文表示LTE的PDN连接或GSM的第一个PDP 上下文。 11. EC200D系列模块暂不支持该命令。 举例 AT+CGEREP=? +CGEREP: (0,1),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK 上海移远通信技术股份有限公司 187 / 279 LTE Standard(U)系列 AT 命令手册 10.11. AT+CGSMS 选择 MO 短消息服务 该命令用于指定 MT 用于发送 MO（移动终端发起）短消息的服务或优选服务。 AT+CGSMS 选择 MO 短消息服务 测试命令 AT+CGSMS=? 响应 +CGSMS: (支持的范围) 查询命令 AT+CGSMS? OK 响应 +CGSMS: 设置命令 AT+CGSMS=[] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 相关： +CME ERROR: 300 毫秒 / 参数 整型。使用的服务或优选服务。 0 PS 域 1 CS 域 2 优选 PS 域（PS 域不可用时使用 CS 域） 3 优选 CS 域（CS 域不可用时使用 PS 域） 错误码。详情参考第 14.5 章。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 上海移远通信技术股份有限公司 188 / 279 LTE Standard(U)系列 AT 命令手册 10.12. AT+CEREG EPS 网络注册状态 该命令用于查询网络状态并控制网络注册状态的非请求结果码的上报。 ⚫ =1 时，控制 URC +CEREG: 的上报，该 URC 表示 E-UTRAN 中 MT 的 EPS 网络注册 状态的变化。 ⚫ =2 时，控制 URC +CEREG: [,,[,]]的上报，该 URC 表示 E-UTRAN 中的网络小区的变化。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 响应 +CEREG: (支持的列表) 查询命令 AT+CEREG? OK 响应 +CEREG: ,[,,[,]] 设置命令 AT+CEREG[=] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。控制非请求结果码的上报。 0 禁止上报网络注册 URC 1 允许上报网络注册 URC +CEREG: 2 允许上报网络注册和位置信息 URC +CEREG: [,,[,]] 整型。 0 未注册，MT 当前未搜索到注册业务的运营商。 1 已注册，归属地网络。 2 未注册，但 MT 当前正尝试附着或搜索网络以进行注册。 3 注册被拒绝。 4 未知 5 已注册，漫游状态 上海移远通信技术股份有限公司 189 / 279 LTE Standard(U)系列 AT 命令手册 字符串类型。十六进制格式的两字节跟踪区编码。 字符串类型。十六进制格式的 28 字节（E-UTRAN）小区 ID。 整型。网络接入技术。 0 GSM 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA 和 HSUPA 7 E-UTRAN 备注 ECx00U、EGx00U 系列和 EG91xU 系列模块支持参数取值 0 和 7；EC200D 系列模块支持参数 取值 2, 4~7；ECx00G、EGx00G 系列和 EG915G-EU 模块支持参数取值 7。 10.13. AT+QGDCNT 流量统计 该命令用于查询模块发送或接收的字节数。 AT+QGDCNT 流量统计 测试命令 AT+QGDCNT=? 响应 +QGDCNT: (支持的列表) 查询命令 AT+QGDCNT? OK 响应 +QGDCNT: , 设置命令 AT+QGDCNT= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 相关： +CME ERROR: 300 毫秒 该命令是否生效取决于网络状态； 参数配置不保存。 上海移远通信技术股份有限公司 190 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。流量统计操作。 0 重置 1 保存统计结果到 NV 若需要自动保存结果，请参考 AT+QAUGDCNT。 整型。发送数据的流量大小（以字节计）。 整型。接收数据的流量大小（以字节计）。 错误码。详情参考第 14.5 章。 备注 MT 开机后，将从 NV 中的流量统计结果中加载和。NV 中的默认结果为 0。 举例 AT+QGDCNT=? +QGDCNT: (0,1) //测试命令。 OK AT+QGDCNT? //查询发送或接收的字节数。 +QGDCNT: 3832,4618 OK AT+QGDCNT=1 OK AT+QGDCNT=0 OK //保存结果至 NV。 //重启数据计数器。 10.14. AT+QAUGDCNT 自动保存流量统计 该命令允许 AT+QGDCNT 自动将结果保存至 NV。 AT+QGDCNT 自动保存流量统计 测试命令 AT+QAUGDCNT=? 响应 +QAUGDCNT: (支持的列表) 查询命令 AT+QAUGDCNT? OK 响应 +QAUGDCNT: 上海移远通信技术股份有限公司 191 / 279 LTE Standard(U)系列 AT 命令手册 设置命令 AT+QAUGDCNT= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 若错误与 ME 相关： +CME ERROR: 300 毫秒 该命令是否生效取决于网络状态； 参数配置不保存。 参数 整型。通过 AT+QGDCNT 自动将结果保存至 NV 的时间间隔。范围：0、30~65535； 默认值：0；单位：秒。若设置为 0，则禁用自动保存功能。 错误码。详情参考第 14.5 章。 举例 AT+QAUGDCNT=? //测试命令。 +QAUGDCNT: (0,30-65535) OK AT+QAUGDCNT=35 OK AT+QAUGDCNT? +QAUGDCNT: 35 //设置为 35。 //查询自动保存的时间间隔。 OK 10.15. AT+CGCONTRDP PDP 上下文读取动态参数 AT+CGCONTRDP PDP 上下文读取动态参数 测试命令 AT+CGCONTRDP=? 响应 +CGCONTRDP:(支持的列表) OK 上海移远通信技术股份有限公司 192 / 279 设置命令 AT+CGCONTRDP[=] 最大响应时间 特性说明 LTE Standard(U)系列 AT 命令手册 响应 +CGCONTRDP: ,,[,[,[,[,[,[,[,[,[,[,[,[,[,]]]]]]]]]]]]]] [+CGCONTRDP: ,,[,[,[,[,[,[,[,[,[,[,[,[,[,]]]]]]]]]]]]] [...] OK 或者 ERROR 300 毫秒 / 参数 整型。用来指定某个非辅助 PDP 上下文。此参数是 TE-MT 接口的本地参数，用于 与 PDP 上下文相关的其他命令。 整型。承载的标识。例如 EPS 中的 EPS 承载，GPRS 中的 NSAPI。 1 RmNet 呼叫已准备就绪，MCU 可以通过 DHCP 或 QMI 获取 IP 地址 2 RmNet 呼叫已连接 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。 字符串类型。表示 MT 的 IP 地址和子网掩码。该字符串为点分隔数字 （0~255）参数的形式，如下所示： IPv4 的形式为'a1.a2.a3.a4.m1.m2.m3.m4'或 IPv6 的形式为'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a 15.a16.m1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15.m16'。 字符串类型。表示 MT 的网关地址。该字符串为点分隔数字（0~255）参数的形式。 字符串类型。表示主 DNS 服务器的 IP 地址。 字符串类型。表示备用 DNS 服务器的 IP 地址。 字符串类型。表示主 P-CSCF 服务器的 IP 地址。 字符串类型。表示备用 P-CSCF 服务器的 IP 地址。 整型。表示 PDP 上下文是否仅用于 IM CN 子系统相关的信令。 上海移远通信技术股份有限公司 193 / 279 LTE Standard(U)系列 AT 命令手册 0 PDP 上下文不仅用于 IM CN 子系统相关的信令 1 PDP 上下文仅用于 IM CN 子系统相关的信令 整型。表示 PDP 上下文使用 LIPA PDN 连接提供连接。TE 不能设置该参数。 0 未收到有关 PDP 上下文使用 LIPA PDN 连接提供连接的指示 1 收到有关 PDP 上下文使用 LIPA PDN 连接提供连接的指示 整型。表示以字节为单位的 IPv4 MTU 大小。 整型。表示是否可以通过 WLAN 卸载指定的 PDN 连接的流量。指 3GPP TS 24.008 subclause 10.5.6.20 中指定的 WLAN 卸载可接受性 IE 的位 1 和位 2。 0 在 S1 模式下或在 Iu 模式下时，无法通过 WLAN 卸载 PDN 连接的流量。 1 在 S1 模式下，可以通过 WLAN 卸载 PDN 连接的流量，但在 Iu 模式下不可行。 2 在 Iu 模式下，可以通过 WLAN 卸载 PDN 连接的流量，但在 S1 模式下不可行。 3 在 S1 模式下或在 Iu 模式下时，可以通过 WLAN 卸载 PDN 连接的流量。 整数类型。表示 MS 和网络是否支持 TFT 中的本地 IP 地址（请参考 3GPP TS 24.301 和 3GPP TS 24.008 subclause 10.5.6.3）。 0 表示 MS 或网络或两者都不支持 TFT 中的本地 IP 地址 1 表示 MS 和网络支持 TFT 中的本地 IP 地址 整型。表示以字节为单位的非 IP MTU 大小。 整型。表示允许 UE 在 6 分钟的间隔内发送的最大上行消息 数。指 3GPP TS 24.30 subclause 9.9.4.28 中规定的服务 PLMN 速率控制 IE 的八位位组 3 至 4。 10.16. AT+QNETDEVCTL 网卡拨号配置 该命令用于连接和断开网卡拨号。 AT+QNETDEVCTL 网卡拨号配置 测试命令 AT+QNETDEVCTL=? 响应 +QNETDEVCTL: ( 支 持 的 列 表 ),(支 持 的 范 围),(支持的范围) 查询命令 AT+QNETDEVCTL? OK 响应 +QNETDEVCTL: ,,, 设置命令 OK 响应 AT+QNETDEVCTL=[,[,]] 或者 +CME ERROR: 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 194 / 279 LTE Standard(U)系列 AT 命令手册 特性说明 该命令立即生效。 当=3 时，参数配置自动保存； 当=1 时，参数配置不保存。 参数 整型。网卡连接类型。 0 断开网卡连接 1 手动连接网卡 3 自动连接网卡。若连接失败，则以每 2 秒、4 秒、8 秒、16 秒、32 秒...倍数时 间间隔进行重试，最大间隔时间 5 分钟。 整型。PDP 上下文索引号。范围：1~7。 整型。是否开启 URC +QNETDEVSTATUS: 上报。 0 关闭 URC 上报 1 开启 URC 上报 整型。网卡连接状态。 0 连接失败 1 连接成功 整型。指定 PDN 的连接状态。 0 未连接 1 已连接 错误码。详情参考第 14.5 章。 备注 1. 当为 1、3 时，此时若缺省，则不进行 URC 上报。 2. EC200D 系列模块支持的范围为 1~11。 举例 AT+QNETDEVCTL=1,1,1 OK +QNETDEVSTATUS: 1 AT+QNETDEVCTL=0 OK AT+QNETDEVCTL=3,2 OK AT+QNETDEVCTL? +QNETDEVCTL: 3,2,0,1 OK //设置网卡拨号方式为手动连接，使用第一路 PDP，开启 URC 上报。 //断开网卡拨号。 //设置网卡拨号方式为自动，使用第二路 PDP，关闭 URC 上报。 上海移远通信技术股份有限公司 195 / 279 LTE Standard(U)系列 AT 命令手册 11 补充业务命令 11.1. AT+CCFC 呼叫转移 该命令用于控制呼叫转移补充服务，包括注册、删除、激活、去激活和状态查询。详情请参考 3GPP TS 22.082。TA 控制呼叫转移补充服务，支持注册，删除，激活，去激活和状态查询。 AT+CCFC 呼叫转移 测试命令 AT+CCFC=? 响应 +CCFC: (支持的范围) 设置命令 AT+CCFC=,[,[,[,[,[,[,time]]]]]] OK 响应 若不为2且命令执行成功： OK 若为2且命令执行成功： 若已注册呼叫转移号码： +CCFC: ,[,,[,,[,]]] […] OK 若未注册呼叫转移号码（即所有业务类型均未激活）： +CCFC: , OK 其中=0，=1 最大响应时间 特性说明 若错误与MT功能相关： +CME ERROR: 300 毫秒 该命令是否生效取决于网络状态； 参数配置不保存。 上海移远通信技术股份有限公司 196 / 279 LTE Standard(U)系列 AT 命令手册 参考 3GPP TS 27.007 参数 整型。配置转移条件。 0 无条件转移 1 遇忙转移 2 无应答转移 3 不可达转移 4 所有呼叫转移（0~3） 5 所有条件呼叫转移（1~3） 整型。控制呼叫转移补充服务。 0 禁用 1 启用 2 查询状态（=0、1、2或3） 3 注册 4 删除 字符串类型。呼叫转移地址的电话号码，格式由指定。 整型。地址类型。当拨号字符串中包含国际接入码字符'+'时，默认值：145；若不包含， 默认值：129。 字符串类型。子地址，格式由指定。 整型。子地址类型。 整型。业务类型；取值以下业务类别的累计值。 1 语音 2 数据 4 传真 8 短消息服务 整型。当启用或查询'无应答转移'（即=2），此参数表示在无应答转移前等待的时 长。范围：1~30；默认值：20；单位：秒。 整型。 0 未激活 1 激活 错误码。详情参考第 14.5 章。 举例 AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, OK AT+CCFC=0,4 //注册用于无条件呼叫转移的目的地号码。 //未指定的情况下，查询无条件呼叫转移状态。 //删除注册的无条件呼叫转移目的地号码。 上海移远通信技术股份有限公司 197 / 279 LTE Standard(U)系列 AT 命令手册 OK AT+CCFC=0,2 +CCFC: 0,1 OK //查询状态，显示没有目的地号码。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 11.2. AT+CCWA 呼叫等待控制 该命令根据 3GPP TS 22.083 控制呼叫等待服务，包括激活、去激活和状态查询。TA 使用设置命令控 制呼叫等待服务，支持激活，去激活和状态查询。 AT+CCWA 呼叫等待控制 测试命令 AT+CCWA=? 响应 +CCWA: (支持的列表) 查询命令 AT+CCWA? OK 响应 +CCWA: 设置命令 AT+CCWA=[,[,]] OK 响应 若不为 2 且命令执行成功： OK 若为 2 且命令执行成功： +CCWA:, [+CCWA:, ...] OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 若不省略，该命令是否生效取决于网络状态； 若省略，该命令立即生效； 上海移远通信技术股份有限公司 198 / 279 LTE Standard(U)系列 AT 命令手册 参考 3GPP TS 27.007 参数配置不保存。 参数 整型。控制当启用 TA 显示呼叫等待（即启用呼叫等待）且在已建立的呼叫期间收到被 叫接入，将上报如下 URC： +CCWA: ,,[,] 0 禁用 URC 上报 1 启用 URC 上报 整型。当省略时，网络将忽略 AT+CCWA。 0 禁用 1 启用 2 查询状态 整型。业务类别，取值为以下类别的累计值。 1 语音（电话业务） 2 数据（所有承载服务） 4 传真（传真服务） 整型。表示是否启用呼叫等待服务。 0 禁用 1 启用 字符串类型。呼叫地址的电话号码，格式由指定。 整型。八字节地址类型。 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 可选字符串类型。以字母数字形式表示对应在电话簿中的位置。 错误码。详情请参考第 14.5 章。 备注 1. 若处于未激活状态，此时返回的应为 0。例如，+CCWA: 0,7。 2. =2 时，将上报所有呼叫等待业务类别。此时，按任意键均可中止该命令。 3. ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 AT+CCWA=1,1 OK ATD10086; OK //启用 URC 上报。 //建立呼叫。 上海移远通信技术股份有限公司 199 / 279 +CCWA: '02154450293',129,1 LTE Standard(U)系列 AT 命令手册 //通话中来电，来电处于呼叫等待状态中。 11.3. AT+CHLD 呼叫相关补充业务 此命令用于控制以下补充业务： ⚫ 暂时与 MT 断开连接但与网络保持连接的呼叫； ⚫ 多方通话（电话会议）； ⚫ 同时保持两方呼叫的服务用户（一方呼叫保持，另一方处于激活或警报状态）可以连接另一方呼 叫且释放自己的连接。 根据 3GPP TS 22.030 中的定义，可以将呼叫保持、恢复、释放并添加到会话中，并进行转移。 该命令基于 GSM 补充业务 HOLD（呼叫保持；详情参考 3GPP TS 22.083 clause 2），MPTY（多方通 话；详情参考 3GPP TS 22.084）和 ECT（显式呼叫转移；详情参考 3GPP TS 22.091）。GSM 标准中描述 了该命令与基于其他 GSM 补充业务命令交互的过程。呼叫保持、多方通话和显式呼叫转移仅适用于电话业 务（即用户终端业务 11）。 该设置命令用于控制呼叫保持、多方通话和显式呼叫转移，支持呼叫保持、呼叫恢复、呼叫释放、添加 至对话以及呼叫转移功能。 AT+CHLD 呼叫相关补充业务 测试命令 AT+CHLD=? 响应 +CHLD: (支持的列表) 设置命令 AT+CHLD= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令是否生效取决于网络状态； 参数配置不保存。 上海移远通信技术股份有限公司 200 / 279 LTE Standard(U)系列 AT 命令手册 参数 0 挂断所有保持的呼叫或呼叫等待的 UDUB（用户决定用户忙）。如果有呼叫处于等 待状态，则挂断等待中的呼叫；否则，挂断所有进行的呼叫（若当前存在呼叫） 1 挂断正在通话的呼叫并接听另一呼叫（等待呼叫或保持呼叫） 1X 挂断第 X 个呼叫（X=1~7） 2 保持正在通话中的呼叫并接听另一呼叫（等待呼叫或保持呼叫） 2X 保持除第 X 个呼叫（X=1~7）外的所有其他呼叫 3 建立多方通话 错误码。详情请参考第 14.5 章。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 ATD10086; OK +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129 +CLCC: 2,1,0,0,0,'02154450293',129 OK AT+CHLD=21 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 +CLCC: 2,1,1,0,1,'02154450293',129 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129 +CLCC: 2,1,0,0,1,'02154450293',129 OK //建立呼叫。 //通话中来电，来电处于呼叫等待状态中。 //保持第一路通话，并接入第二路呼叫等待的通话。 //保持第一路呼叫。 //接入第二路呼叫等待的通话。 //保持除第一路呼叫以外的其他呼叫。 //接入第一路通话。 //保持第二路通话。 //将保持的呼叫添加到进行中的通话中建立多方电话会议。 上海移远通信技术股份有限公司 201 / 279 LTE Standard(U)系列 AT 命令手册 11.4. AT+CLIP 主叫号码显示 该命令为 GSM 补充业务 CLIP（主叫号码显示），用于在被叫时使被呼叫方获取主叫方身份。TA 使用 设置命令用于使能或禁用 TE 端来电号码上报，对网络中 CLIP 的执行不会产生影响。 AT+CLIP 主叫号码显示 测试命令 AT+CLIP=? 响应 +CLIP: (支持的列表) 查询命令 AT+CLIP? OK 响应 +CLIP: , 设置命令 AT+CLIP= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 15 秒，受网络状态影响 / 参数 整型。控制当启用在 TE 显示 CLIP（且主叫方允许）时，被叫通话里返回 RING（或者 +CRING: ）后，将上报如下 URC： +CLIP: ,,[subaddr],[satype],[], 0 禁用 URC 上报 1 启用 URC 上报 整型。 0 未提供 CLIP 业务 1 提供 CLIP 业务 2 未知 字符串类型。呼叫地址的电话号码，格式由指定。 字符串类型。子地址，格式由定义。 整型。八位字节子地址类型（详情参考 3GPP TS 24.008 subclause 10.5.4.8）。 整型。八位字节的地址类型。 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 上海移远通信技术股份有限公司 202 / 279 LTE Standard(U)系列 AT 命令手册 161 国际号码 可选字符串类型。以字母数字形式表示对应在电话簿中的位置。 整型。 0 CLI 有效 1 主叫方拒绝 CLI 2 由于网络问题或主叫方网络限制造成 CLI 不可用 错误码。详情参考第 14.5 章。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,,,'QUECTEL',0 11.5. AT+CLIR 主叫线路识别限制 该命令指根据 3GPP TS 22.081 的 CLIR 补充服务（主叫线路识别限制）和 3GPP TS 24.607 的 OIR 补充服务（主叫识别限制），允许在主叫方发起呼叫时启用或禁用显示主叫号码身份信息。使用设置命令发 起呼叫时，TA 启用或禁用显示主叫号码身份信息。 当临时模式（临时限制或临时允许）作为后续所有主叫的默认值时，该设置命令可以修改 CLIR 的订阅 信息（默认是限制或者允许）。使用相反的命令可以取消该订阅。 AT+CLIR 主叫线路识别限制 测试命令 AT+CLIR=? 响应 +CLIR: (支持的范围) 查询命令 AT+CLIR? OK 响应 +CLIR: , OK 上海移远通信技术股份有限公司 203 / 279 LTE Standard(U)系列 AT 命令手册 设置命令 AT+CLIR= 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 OK 若错误与 ME 功能相关： +CME ERROR: 15 秒，受网络状态影响 / 参数 整型。调整呼出电话状态。 0 根据 CLIR 服务的订阅来显示 1 启用 CLIR 2 禁用 CLIR 整型。是否在网络中提供 CLIR 业务。 0 CLIR 业务未提供 1 CLIR 业务在永久模式下提供 2 未知（如：无网络等） 3 CLIR 业务临时限制 4 CLIR 业务临时允许 错误码。详情请参考第 14.5 章。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 11.6. AT+COLP 被接线识别显示 该命令指根据 GSM 补充服务 COLP（被接线识别显示），主叫方在建立主叫后可获取被叫号码身份信 息。该命令启用或禁用在 TE 显示被叫号码身份信息，对网络中补充业务 COLR 的执行没有影响。 在任何+CR 或 V.25ter 响应之前，TA 返回中间结果码 TE。 AT+COLP 被接线识别显示 测试命令 AT+COLP=? 响应 +COLP: (支持的列表) 上海移远通信技术股份有限公司 204 / 279 LTE Standard(U)系列 AT 命令手册 查询命令 AT+COLP? 设置命令 AT+COLP= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 +COLP: , OK 响应 OK 15 秒，取决于网络状态 / 参数 整型。禁用/启用在 MT 中显示结果码。 0 禁用 1 启用，启用结果码显示（且被叫方允许）后，返回任何+CR 或 V.25 ter 响应之前， 将返回如下中间结果码： +COLP: ,,[],[],[] 整型。是否在网络中提供用户 COLP 业务。 0 不提供 COLP 业务 1 提供 COLP 业务 2 未知（如：无网络等） 字符串类型。电话号码，格式由指定。 整型。八位字节地址类型。 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 字符串类型。子地址，格式由指定。 整型。八位字节子地址类型（参考 3GPP TS 24.008 subclause 10.5.4.8）。 可选字符串类型。以字母数字形式表示对应在电话簿中的位置。 备注 ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK 上海移远通信技术股份有限公司 205 / 279 ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK LTE Standard(U)系列 AT 命令手册 11.7. AT+CSSN 补充业务通知 该命令指与补充服务有关的网络发起的通知，该设置命令启用或禁用 TA 将通知结果码上报 TE。 AT+CSSN 补充业务通知 测试命令 AT+CSSN=? 响应 +CSSN: (支持的列表),(支持的列表) 查询命令 AT+CSSN? OK 响应 +CSSN: , 设置命令 AT+CSSN=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。启用/禁用 TA 上报中间结果码+CSSI: 至 TE。 0 禁用 1 启用 整型。启用/禁用 TA 上报非请求结果码+CSSU: 至 TE。 0 禁用 1 启用 整型。由厂商指定，支持的参数取值如下： 0 无条件呼叫转移处于激活状态 上海移远通信技术股份有限公司 206 / 279 LTE Standard(U)系列 AT 命令手册 1 部分条件呼叫转移处于激活状态 2 呼叫已经转移 3 呼叫等待中 5 禁止呼出 整型。由厂商指定，支持的参数取值如下： 0 来电为转接电话 2 通话保持中（语音通话中） 3 通话已恢复（语音通话中） 5 保持中的通话被另一方挂断 10 转接另一来电 错误码。详情参考第 14.5 章。 备注 1. 当=1 且主叫建立后收到补充业务通知，将在响应其他主叫建立结果码前响应+CSSI: 至 TE。 2. 当=1 且被叫建立后或在通话期间收到补充业务通知，将响应非请求结果码+CSSU: 至 TE。 3. ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 11.8. AT+CUSD 非结构化补充数据业务 该命令根据 3GPP TS 22.090，控制非结构化补充数据业务（USSD）。该命令支持网络与 TE 发起的操 作。 该设置命令指定时，TE 发起的 USSD 字符串或网络响应的 USSD 字符串将发送给网络。网 络响应的 USSD 字符串在后续 URC+CUSD 中返回。 AT+CUSD 非结构化补充数据业务 测试命令 AT+CUSD=? 响应 +CUSD: (支持的范围) 查询命令 AT+CUSD? OK 响应 +CUSD: 设置命令 AT+CUSD=[[,[,]] ] OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 207 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 120 秒，取决于网络状态 该命令立即生效； 参数配置不保存。 参数 整型。是否向 TE 上报结果码。 0 禁用结果码上报 1 启用结果码上报。对于网络端响应或发起的 USSD，格式为 +CUSD: [,,[]]。 2 取消会话（不适用于查询命令的响应结果） 字符串类型。发送至网络的 USSD。若参数缺省，则无法访问网络。 字符串类型。从网络接收的 USSD。 整型。详情参考 3GPP TS 23.038 小区广播数据编码方案。默认值：15。 整型。网络响应或发起的 USSD。 0 无需进一步的用户操作（网络发起的 USSD 通知或 TE 发起操作后无需进一步的信 息） 1 需要进一步的用户操作（网络发起的 USSD 请求或 TE 发起操作后需要进一步的信 息） 2 网络终止 USSD 3 另一本地客户端已响应 4 不支持该操作 5 网络超时 错误码。详情参考第 14.5 章。 备注 EC200D 系列、ECx00G、EGx00G 系列和 EG915G-EU 模块不支持该命令。 上海移远通信技术股份有限公司 208 / 279 LTE Standard(U)系列 AT 命令手册 12 音频命令 12.1. AT+CLVL 扬声器音量等级选择 该命令用于选择 MT 内部扬声器的音量等级。 AT+CLVL 扬声器音量等级选择 测试命令 AT+CLVL=? 响应 +CLVL: (支持的列表) 查询命令 AT+CLVL? OK 响应 +CLVL: 设置命令 AT+CLVL= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与ME功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 自动保存参数配置。 参数 整型。出厂特定范围的音量级别（最小值代表最低的声音级别）。范围：0~5；默认值：3。 错误码。详情参考第 14.5 章。 上海移远通信技术股份有限公司 209 / 279 LTE Standard(U)系列 AT 命令手册 12.2. AT+QAUDLOOP 控制音频循环测试 该命令用于启用或者禁用音频循环测试。 AT+QAUDLOOP 控制音频循环测试 测试命令 AT+QAUDLOOP=? 响应 +QAUDLOOP: (支持的列表) 查询命令 AT+QAUDLOOP? OK 响应 +QAUDLOOP: 设置命令 AT+QAUDLOOP= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。是否启用音频循环测试。 0 禁用 1 启用 错误码。详情参考第 14.5 章。 12.3. AT+QAUDRD 录制音频文件 该命令录制语音通话时的上行或下行语音，或在空闲状态下从本地麦克风录制音频并保存音频文件。 AT+QAUDRD 录制音频文件 测试命令 AT+QAUDRD=? 响应 +QAUDRD: ( 支 持 的 列 表 ),,( 支 持 的 列表),(支持的列表) 查询命令 OK 响应 上海移远通信技术股份有限公司 210 / 279 LTE Standard(U)系列 AT 命令手册 AT+QAUDRD? +QAUDRD: 设置命令 AT+QAUDRD=[,[,[,]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。音频录制状态。 0 不在录制 1 录制中 整型。控制音频录制开始或停止。 0 停止录制 1 开始录制 字符串类型。录制的音频文件的名称，包括文件路径（UFS 目录），文件名和文件扩展 名。 整型。文件格式。 13 WAV_PCM16、AMRNB、AMRWB 或 PCM 整型。录制本地或通话音频。 0 录制本地音频 1 录制通话音频（上行+下行） 错误码。详情请参考第 14.5 章。 备注 1. 模块支持 wav 音频文件格式（=13）。 2. 若录制文件的名称和格式与路径下已有文件的名称和格式都相同，或者发生未知错误，则模块上报 URC +QAUDRIND: 0,1。 3. 若当前录制被其他音频任务中断，则模块上报 URC +QAUDRIND: 0,6。 4. 若录制空间不足，则模块上报 URC +QAUDRIND: 0,3。 5. 若文件格式与文件扩展名不一致，模块将报错。 6. 在非通话模式下禁止录制通话音频，在通话模式下禁止录制本地音频。 7. EC200D 系列模块暂只支持录制本地音频，不支持录制通话上下行音频。 8. 针对 ECx00G、EGx00G 系列，仅支持 VoLTE 功能的模块支持该命令，详情请咨询移远通信技术支 持；EG915G-EU 模块暂不支持该命令。 上海移远通信技术股份有限公司 211 / 279 表 7：URC +QAUDRIND: 0,中的描述 0 1 3 6 含义 已保存 未知错误 录制空间不足 被其他录制任务中断 LTE Standard(U)系列 AT 命令手册 举例 AT+QAUDRD=1,'UFS:A.wav',13,0 OK AT+QAUDRD=0 OK AT+QAUDRD=1,'UFS:B.wav',13,1 OK AT+QAUDRD=0 OK //以 wav 格式录制本地音频，并将其存储在 UFS 中。 //停止录制。 //以 wav 格式录制通话音频，并将其存储在 UFS 中。 //停止录制。 12.4. AT+QPSND 在本地或向远端播放音频文件 该命令用于本地音频播放或向远端播放本地音频文件。文件格式支持 wav、pcm、amr、awb 和 mp3。 AT+QPSND 在本地或向远端播放音频文件 测试命令 AT+QPSND=? 响应 +QPSND: ( 支 持 的 列 表 ),,( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表) 查询命令 AT+QPSND? OK 响应 +QPSND: 设置命令 AT+QPSND=,,< repeat>[,[,]] OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 212 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 播放结束后： +QPSND: 0 300 毫秒 / 参数 整型。 0 模块不在播放中 1 模块播放中 整型。 0 停止播放 1 开始播放 字符串类型。播放的音频文件的名称，包括文件路径（默认为 UFS 目录），文件名和文 件扩展名。 整型。是否重复播放。 0 仅播放一次 1 重复播放 整型。上行音频是否静音。 0 静音 1 未静音 整型。下行音频是否静音。 0 静音 1 未静音 错误码。详情请参考第 14.5 章。 备注 1. 在播放上行音频时，该模块仅支持 8 kHz 线性，单波格式。 2. 在通话模式下禁止下行音频回放，在非通话模式下禁止上行音频回放。 3. 若发生未知错误，则模块上报 URC +QPSND: 0,1。 4. EC200D 系列模块只支持播放本地音频文件，不支持播放到远端，不支持 awb 格式文件。 5. ECx00G、EGx00G 系列和 EG915G-EU 模块暂只支持播放本地音频文件，不支持播放到远端。 上海移远通信技术股份有限公司 213 / 279 LTE Standard(U)系列 AT 命令手册 举例 AT+QPSND=1,'UFS:A.wav',0 OK +QPSND: 0 AT+QPSND=1,'UFS:A.wav',0,1,0 OK +QPSND: 0 //播放存储在 UFS 中的音频文件（A.wav）。 //通话进行时，向远端播放音频文件（A.wav）。 //播放结束。 备注 AT+QPSND 不支持同时将和设置为 0 或 1。 12.5. AT+QAUDPLAY 本地播放音频文件 该命令用于本地播放音频文件。文件格式支持 wav、pcm、amr、awb 和 mp3。 AT+QAUDPLAY 本地播放音频文件 测试命令 AT+QAUDPLAY=? 响应 +QAUDPLAY: ,(支持的列表) 查询命令 AT+QAUDPLAY? OK 响应 +QAUDPLAY: 设置命令 AT+QAUDPLAY=, OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放结束后： +QAUDPLAY: 0 300 毫秒 该命令立即生效； 上海移远通信技术股份有限公司 214 / 279 不保存参数配置。 LTE Standard(U)系列 AT 命令手册 参数 整型。模块状态。 0 模块不在播放中 1 模块播放中 字符串类型。播放的音频文件的名称，包括文件路径（默认为 UFS 目录），文件名和文 件扩展名。 整型。是否重复播放。 0 仅播放一次 1 重复播放 错误码。详情请参考第 14.5 章。 备注 1. 若发生未知错误，则模块上报 URC +QAUDPIND: 0,1。 2. 若当前播放被其他音频任务中断，则模块上报 URC +QAUDPIND: 0,6。 3. EC200D 系列模块不支持播放 awb 音频文件。 12.6. AT+QAUDSTOP 停止播放媒体文件 该命令用于停止播放媒体文件。 AT+QAUDSTOP 停止播放媒体文件 测试命令 AT+QAUDSTOP=? 执行命令 AT+QAUDSTOP 响应 OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 215 / 279 参数 错误码。详情请参考第 14.5 章。 LTE Standard(U)系列 AT 命令手册 12.7. AT+QAUDMOD 设置音频模式 该命令用于设置连接设备所需的音频模式。 AT+QAUDMOD 设置音频模式 测试命令 AT+QAUDMOD=? 响应 +QAUDMOD: (支持的范围) 查询命令 AT+QAUDMOD? OK 响应 +QAUDMOD: 设置命令 AT+QAUDMOD= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在下一次音频信号活跃时生效； 不保存参数配置。 参数 整型。当前配置的音频模式。 0 话柄 1 耳机 2 扬声器 错误码。详情参考第 14.5 章。 备注 模块支持的音频模式如下表所示： 上海移远通信技术股份有限公司 216 / 279 模块 EC200D ECx00G EGx00G EG915G-EU EC200U EG700U-CN EC600U EG500U-CN EG91xU 话柄 √ / √ / √ LTE Standard(U)系列 AT 命令手册 支持的音频模式 耳机 扬声器 / / / √ √ √ √ √ √ / 12.8. AT+QIIC 读写 IIC 该命令用于从外围设备读取或写入 IIC 寄存器。 AT+QIIC 读写 IIC 测试命令 AT+QIIC=? 响应 +QIIC: (支持的列表),(支持的列表),(支持的范围),(支持的列表),(支持的范围) 设置命令 AT+QIIC=,,,[,] OK 响应 若指定可选参数： OK 若省略可选参数： +QIIC: 最大响应时间 特性说明 OK 300 毫秒 该命令立即生效； 不保存参数配置。 上海移远通信技术股份有限公司 217 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。 0 设置命令 1 查询命令 十六进制整型。7 位从设备地址。范围：0~0xFF。 十六进制整型。寄存器地址。范围：0~0xFF。 整型。 1 读/写一个字节 2 读/写两个字节 十六进制整型。写入值。范围：0~0xFFFF。 备注 1. 该命令的参数为十六进制类型，设置,,参数值时须加前缀'0x'。 2. 为从设备地址（7 位，不包含读/写位），详情请参考设备的规格书。 3. EC200D 系列模块暂不支持该命令。 举例 AT+QIIC=1,0x1B,0x0c,1 //读取寄存器位置的 1 字节寄存器内容：从机地址：0x1B； 寄存器地址：0x0c。 +QIIC: 0x50 OK AT+QIIC=0,0x1B,0x0c,1,0x5f OK //写入寄存器位置的 1 字节寄存器内容：从机地址：0x1B；寄 存器地址：12；写入值：0x5f。 12.9. AT+QDAI 数字音频配置 该命令用于配置外置 Codec 模式下，数字音频输入/输出格式。 AT+QDAI 数字音频配置 测试命令 AT+QDAI=? 响应 +QDAI: ( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表),(支持的列表),(支持的列表), (支持 的列表) OK 上海移远通信技术股份有限公司 218 / 279 LTE Standard(U)系列 AT 命令手册 查询命令 AT+QDAI? 响应 +QDAI: [,,,,,,,] 设置命令 OK 响应 AT+QDAI=[,,,[,[,[,,]]]] ERROR 最大响应时间 300 毫秒 特性说明 该命令重启后生效； 保存参数配置。 参数 整型。音频输入/输出设备。 0 使用用户自定义外置 Codec 作为数字音频输入/输出设备 1 使用 NAU88C10 作为数字音频输入/输出设备 3 使用 ALC5616 作为数字音频输入/输出设备 整型。主从模式。 0 主模式（不支持） 1 从模式，模块作为从机 整型。帧同步类型。 0 PCM 短帧同步 1 IIS 短帧同步 整型。时钟频率。（暂不支持） 整型。数据格式。（暂不支持） 整型。采样率。（暂不支持） 整型。使用的时隙的总数。（暂不支持） 整型。使用的第几个时隙。（暂不支持） 备注 1. EC200D 系列模块不支持该命令；ECx00G、EGx00G 系列和 EG915G-EU 系列模块暂不支持该命 令。 2. 数字音频格式为短帧同步，采样率支持 8~44.1 kHz，支持 1~4 通道，采样位深为 16 bits。 3. 该命令与 AT+QAUDSW 命令配合使用。在指定数字音频输出设备和格式后，要使用 AT+QAUDSW 命令切换到外置 Codec 模式。 上海移远通信技术股份有限公司 219 / 279 LTE Standard(U)系列 AT 命令手册 12.10. AT+QAUDSW Codec 切换 该命令用于切换内置或外部 Codec。 AT+QAUDSW Codec 切换 测试命令 AT+QAUDSW=? 响应 +QAUDSW: (支持的列表) 查询命令 AT+QAUDSW? OK 响应 +QAUDSW: 设置命令 AT+QAUDSW= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 掉电保存参数配置。 参数 整型。 0 外置 Codec 1 内置 Codec 备注 1. EC200D 系列模块暂不支持该命令。 2. 对于外置 Codec，ECx00U 和 EGx00U 系列模块当前适配了 ALC5616、NAU88C10；ECx00G 和 EG700G-CN 系列模块当前适配了 ES8311。用户在确保硬件上 IIC、PCM/IIS 连接完善的情况下， 发送 AT+QAUDSW=0 后，模块会自动识别当前连接的 Codec 是否支持，若已经支持当前连接的 Codec 模块，则返回 OK，并且重启后模块将会在播放/录音/通话时使用内置的寄存器参数，自动控 制 Codec。用户也可以通过 AT+QIIC 命令去手动控制 Codec 寄存区；若模块不可自动识别当前连接 的 Codec，则此命令会报错（若模块可自动识别此 Codec 但此命令仍然报错，请确认硬件上 IIC 是 上海移远通信技术股份有限公司 220 / 279 LTE Standard(U)系列 AT 命令手册 否 已 连 接 ）。 用 户 可 以 使 用 AT+QDAI 命 令 配 置 在 自 定 义 Codec 模 式 下 工 作 ， 然 后 再 发 送 AT+QAUDSW=0 切换到外置 Codec 模式。这种情况下，重启后，模块将不会自动控制 Codec，用 户可自己使用 AT+QIIC 命令去控制外置 Codec。 3. ECx00U 和 EGx00U 系列模块当前只支持 PCM/IIS 从模式，即 Codec 作为主机，模块作为从机。若 使用了模块不可自动识别的外置 Codec，用户需要自行通过 AT+QIIC 命令或者其他途径配置外置 Codec 的 PCM/IIS 时钟。其中 PCM_SYNC 时钟需要等于模块播放/录音/通话的采样率，用户可以在 模块开机时发送 AT+QAUDCFG='urc',1 使能模块通过 URC 上报采样率，随后在开始播放/录音/通 话时模块会通过 URC 的方式将采样率告诉上位机。PCM_CLK = PCM_SYNC × 通道数 × 采样位 深。ECx00U 和 EGx00U 系列模块支持 1~4 通道，采样位深为 16 bit，传输格式为短帧同步。 4. ECx00G、EGx00G 系列和 EG915G-EU 模块当前只支持 PCM 主模式，即 Codec 作为从机，模块 作为主机。支持 1~4 通道，采样位深为 16 bit，传输格式为短帧同步。在使用模块不可自动识别的 Codec 时，用户可根据对应的 Codec 使用方法，通过 AT+QIIC 命令或其他途径配置外置 Codec 寄 存器。 5. ECx00U 和 EGx00U 系列模块，使用移远通信提供的 EVB 调试外置 Codec 功能时，需要飞线，具 体飞线方式可联系移远通信技术支持获悉。 12.11. AT+QAUDPASW 切换音频 PA 类型 该命令用于切换音频 PA 类型。 AT+QAUDPASW 切换音频 PA 类型 测试命令 AT+QAUDPASW=? 响应 +QAUDPASW: (支持的列表) 查询命令 AT+QAUDPASW? OK 响应 +QAUDPASW: 设置命令 AT+QAUDPASW= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置不保存。 上海移远通信技术股份有限公司 221 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。PA 类型。 0 AB 类 1 D类 备注 EC200D、ECx00G、EGx00G 系列和 EG915G-EU 模块暂不支持该命令。 12.12. AT+QTTS 播放文本 该命令用于播放文本。 AT+QTTS 播放文本 测试命令 AT+QTTS=? 响应 +QTTS: (支持的范围),,(支持的范围) 查询命令 AT+QTTS? OK 响应 +QTTS: 设置命令 AT+QTTS=[,[, ]] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 文本播放完成时： +QTTS: 0 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 222 / 279 LTE Standard(U)系列 AT 命令手册 参数 整型。开始或停止播放，指示格式。范围：0~2。 0 停止播放，可省略 1 开始播放，使用 UCS2 编码 2 开始播放，是字符型，通常是 ASCII 字符，中文使用 GBK 编码 字符串类型。待播放文本。文本格式取决于。最大长度：548 字节。 整型。TTS 播放设备。 0 通过内置/外置 Codec 播放 TTS 文本 1 通过内置/外置 Codec 播放 TTS 文本，并且将音频数据输出到 USB AT 口 2 通过内置/外置 Codec 播放 TTS 文本，并且将音频数据输出到 USB Modem 口 3 通过内置/外置 Codec 播放 TTS 文本，并且将音频数据输出到 USB NMEA 口（在 EC200D 系列模块上为 USB EXT 口） 整型。TTS 播放器状态。 0 空闲 1 繁忙 错误码。详情请参考第 14.5 章。 备注 1. 模块支持在无通话状态下执行此命令播放文本。 2. 通话时文本播放会被中断。 3. 模块支持文本和音频播放，但不支持同时播放。 4. EC200D 系列模块没有 USB NMEA，当为 3 时，音频数据会输出到 USB EXT 口 5. ECx00G、EGx00G 系列模块中仅支持 GNSS 功能的型号具备 USB NMEA 口，支持为 3。有关 GNSS 功能的支持详情，请咨询移远通信技术支持。 举例 AT+QTTS=? +QTTS: (0-2),,(0-3) //测试命令。 OK AT+QTTS=1,'6B228FCE4F7F752879FB8FDC6A215757' //播放 UCS2 字符串文本。 OK +QTTS: 0 AT+QTTS=2,'hello world,你好' OK //播放 ASCII 字符串文本。 +QTTS: 0 AT+QTTS=0 OK //停止播放。 上海移远通信技术股份有限公司 223 / 279 LTE Standard(U)系列 AT 命令手册 12.13. AT+QWTTS 向远端播放或发送文本 该命令用于在通话时向远端播放或发送文本。 AT+QWTTS 向远端播放或发送文本 测试命令 AT+QWTTS=? 响应 +QWTTS: (支持的列表),(支持的列表),(支 持的范围), 查询命令 AT+QWTTS? OK 响应 +QWTTS: 设置命令 AT+QWTTS=,,[,] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 文本播放完成时： +QWTTS: 0 最大响应时间 特性说明 当 TTS 播放被来电中断时： +QWTTS: 4111 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。取消静音上行链路。 1 取消静音上行链路 整型。静音下行链路。 0 静音下行链路 整型。开始或停止播放并指定格式。 0 停止播放，可忽略 1 开始播放，使用 UCS2 编码 2 开始播放，是字符型，通常是 ASCII 字符，中文使用 GBK 编码 上海移远通信技术股份有限公司 224 / 279 LTE Standard(U)系列 AT 命令手册 整型。待播放/发送文本。文本格式取决于。最大长度：548 字节。 整型。TTS 播放器状态。 0 空闲 1 繁忙 错误码。详情请参考第 14.5 章。 备注 针对 ECx00G 和 EGx00G 系列，仅支持 VoLTE 功能的模块支持该命令，详情请咨询移远通信技术支持； EG915G-EU 暂不支持该命令。 举例 AT+QWTTS=? +QWTTS: (1),(0),(0-2), //测试命令。 OK AT+QWTTS=1,0,1,'6B228FCE4F7F752879FB8FDC6A215757' OK //通话时播放 UCS2 字符串并发送至远 端。 +QWTTS: 0 AT+QWTTS=1,0,2,'hello world,你好' OK //通话时播放 ASCII 字符串并发送至远端。 +QWTTS: 0 AT+QWTTS=1,0,0 OK //文本播放完成。 //停止播放。 12.14. AT+QTTSETUP 配置 TTS 参数 该命令用于设置 TTS 速度或调节音量。 AT+QTTSETUP 配置 TTS 参数 测试命令 AT+QTTSETUP=? 响应 +QTTSETUP: (支持的列表),(支持的列表),(支持 的范围) 查询命令 AT+QTTSETUP? OK 响应 OK 上海移远通信技术股份有限公司 225 / 279 LTE Standard(U)系列 AT 命令手册 设置命令 AT+QTTSETUP=,[,] 响应 若=1，则指定可选参数： OK 或者 ERROR 若=2，则省略可选参数： +QTTSETUP: 2,, 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。设置或查询参数值。 1 设置 2 查询 整型。 1 速度 2 音量 整型。速度或音量值。 如=2，设置命令中省略，表示查询当前速度或音量。 速度 范围：-32768~32767；正常速度：0；默认值：0。 音量 范围：-32768~32767；默认值：0。 错误码。详情请参考第14.5章。 举例 AT+QTTSETUP=? +QTTSETUP: (1,2),(1,2),(-32768-32767) OK AT+QTTSETUP=1,2,0 OK //测试命令。 //设置音量为 0。 上海移远通信技术股份有限公司 226 / 279 LTE Standard(U)系列 AT 命令手册 12.15. AT+QAUDCFG='urc' 启用/禁用模块使用 URC 上报采样率 AT+QAUDCFG='urc' 测试命令 AT+QAUDCFG=? 启用/禁用模块使用 URC 上报采样率 响应 … +QAUDCFG: 'urc',(支持的列表) 设置命令 AT+QAUDCFG='urc'[,] OK 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'urc', OK 若指定可选参数，则启用/禁用模块使用 URC 上报采样率： OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: / 该命令立即生效； 自动保存参数配置。 参数 整型。启用/禁用模块使用 URC 上报采样率。 0 禁用。模块在播放、录音和通话时不会通过 URC 上报采样率 1 启用。用户若使用 PCM 主从方式控制外置 Codec，模块将在播放、录音和通话时，通 过 URC 实时上报采样率，用户可以使用上报的值配置 PCM 主机的 PCM_CLK 和 PCM_SYNC 时钟。 错误码。详情请参考第 14.5 章。 备注 1. 使能该命令后，模块上报采样率 URC 的格式为：+QSAMPRATE: 。即为本次播放/ 录音/通话所使用的采样率（单位：kHz）。 2. EC200D 系列模块不支持该命令。 上海移远通信技术股份有限公司 227 / 279 LTE Standard(U)系列 AT 命令手册 12.16. AT+QICMIC 设置麦克风的上行增益 该命令用于设置麦克风的上行增益。 AT+ QICMIC 设置麦克风的上行增益 测试命令 AT+QICMIC=? 响应 +QICMIC: (支持的范围),(支持的范围) 查询命令 AT+QICMIC? OK 响应 +QICMIC: , 设置命令 AT+QICMIC=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。上行模拟增益。范围：0~7。不同音频模式下默认值可能不同。 整型。上行数字增益。范围：0~15。不同音频模式下默认值可能不同。 错误码。详情请参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 12.17. AT+QRXGAIN 设置下行增益 该命令用于设置播放/通话的下行增益。 上海移远通信技术股份有限公司 228 / 279 LTE Standard(U)系列 AT 命令手册 AT+QRXGAIN 设置下行增益 测试命令 AT+QRXGAIN=? 查询命令 AT+QRXGAIN? 设置命令 AT+QRXGAIN= 最大响应时间 特性说明 响应 +QRXGAIN: (支持的范围) OK 响应 +QRXGAIN: OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。下行增益。范围：0~65535。不同音频模式下默认值可能不同。 错误码。详情请参考第 14.5 章。 备注 EC200D 系列模块暂不支持该命令。 12.18. AT+QICSIDET 设置当前模式的侧音增益 该命令用于设置当前模式的侧音增益。 AT+QICSIDET 设置当前模式的侧音增益 测试命令 AT+QICSIDET=? 响应 +QICSIDET: (支持的范围) OK 上海移远通信技术股份有限公司 229 / 279 LTE Standard(U)系列 AT 命令手册 查询命令 AT+QICSIDET? 设置命令 AT+QICSIDET= 最大响应时间 特性说明 响应 +QICSIDET: OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。当前模式的侧音增益。范围：0~15。不同音频模式下默认值可能不同。 错误码。详情请参考第 14.5 章。 备注 1. 此命令仅在使用 AT+QAUDLOOP（请参考第 12.2 章）禁用音频循环测试后才有效。 2. EC200D 系列、ECx00G、EGx00G 系列和 EG915G-EU 模块暂不支持该命令。 12.19. AT+QLDTMF 播放/停止播放本地 DTMF 音 该命令用于播放或停止播放本地 DTMF 音。 AT+QLDTMF 播放/停止播放本地 DTMF 音 测试命令 AT+QLDTMF=? 响应 +QLDTMF: ( 支 持 的 范 围 ),( 支 持 的 列 表),(支持的列表) 设置命令 AT+QLDTMF=,[,< y>] OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 230 / 279 LTE Standard(U)系列 AT 命令手册 执行命令 停止播放本地 DTMF 音 AT+QLDTMF 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 播放完成时： +QLDTMF: 5 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。每个 DTMF 的播放时间和静音时间。范围：1~1000；单位由指定。 字符串类型。DTMF 音。逗号隔开，也可不加逗号。最大长度：39 字符（包含逗号）； DTMF 格式：0~9、*、#、A~G；需加双引号（'...'）。 整型。控制参数的时间单位。 若省略或=0，的单位是 0.1 秒； 若=1，的单位是 0.01 秒。 错误码。详情请参考第 14.5 章。 举例 AT+QLDTMF=? //测试命令。 +QLDTMF: (1-1000),(0-9,*,#,A-G),(0,1) OK AT+QLDTMF=2,'A,B,1,2,#' //播放 A、B、1、2、#，播放时间和静音时间均为 200 毫秒。 OK AT+QLDTMF OK //停止播放。 备注 针对 ECx00G 和 EGx00G 系列，仅支持 VoLTE 功能的模块支持该命令，详情请咨询移远通信技术支持； EG915G-EU 模块暂不支持该命令。 上海移远通信技术股份有限公司 231 / 279 LTE Standard(U)系列 AT 命令手册 12.20. AT+QWDTMF 向远端播放/发送 DTMF 音 该命令用于向远端播放或发送 DTMF 音。 AT+QWDTMF 向远端播放/发送 DTMF 音 测试命令 AT+QWDTMF=? 响应 +QWDTMF: ( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的范围) 设置命令 AT+QWDTMF=,,< DTMF_string>,,[] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 执行命令 停止播放 DTMF 音 AT+QWDTMF 最大响应时间 特性说明 播放完成时返回： +QWDTMF: 5 响应 OK 300 毫秒 / 参数 整型。取消静音上行链路。 1 取消静音上行链路 整型。静音下行链路。 0 静音下行链路 字符串类型。DTMF 音。逗号隔开，也可不加逗号。最大长度：39 字符（包含逗号）； DTMF 格式：0~9、*、#、A~G；需加双引号（'...'）。 整型。 若省略参数，则表示播放和停顿的持续时间。 若指定参数，则表示播放的持续时间。 范围：10~1000；单位：毫秒。 整型。停顿的持续时间。范围：10~1000；单位：毫秒。 错误码。详情请参考第 14.5 章。 上海移远通信技术股份有限公司 232 / 279 LTE Standard(U)系列 AT 命令手册 举例 AT+QWDTMF=? +QWDTMF: (1),(0),(0-9,*,#,A-G),(10-1000) OK AT+QWDTMF=1,0,'1,2,3,A,B',500 OK AT+QWDTMF=1,0,'AB',100,120 OK AT+QWDTMF OK //测试命令。 //播放 1、2、3、A、B，播放时间 500 毫秒， 停顿时间 500 毫秒。 //播放 A、B，播放时间 100 毫秒， 停顿时间 120 毫秒。 //停止播放。 备注 针对 ECx00G 和 EGx00G 系列，仅支持 VoLTE 功能的模块支持该命令，详情请咨询移远通信技术支持； EG915G-EU 模块暂不支持该命令。 12.21. AT+VTS 向对端发送 DTMF 音 该命令用于发送 ASCII 字符，使 MSC 将 DTMF 音发送到对端。该命令只能在语音呼叫中使用。 AT+VTS 生成 DTMF 音 测试命令 AT+VTS=? 响应 +VTS: (支持的列表),(支持的范 围) 设置命令 AT+VTS=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 取决于和的长度 该命令立即生效。 参数配置不保存。 上海移远通信技术股份有限公司 233 / 279 LTE Standard(U)系列 AT 命令手册 参考 3GPP TS 27.007 参数 字符串类型。ASCII 字符集 0-9、#、*、A、B、C、D 需加上引号（'...'）。 整型。每个 DTMF 音的持续时间（以 10 毫秒为公差）。 范围：100~1000。默认值：300。单位：毫秒。 如果持续时间小于网络指定的最短时间，则实际持续时间为网络指定的时间。 错误码。详情请参考第 14.5 章。 举例 ATD12345678900; OK AT+VTS='1' OK AT+VTS='1234567890A' OK //拨号 //对端能够听到 DTMF 音 //一次发送多个 DTMF 音 备注 针对 ECx00G 和 EGx00G 系列，仅支持 VoLTE 功能的模块支持该命令，详情请咨询移远通信技术支持； EG915G-EU 模块暂不支持该命令。 12.22. AT+QLTONE 播放本地定制音调 该命令用于播放本地定制音调。 AT+QLTONE 播放本地定制音调 测试命令 AT+QLTONE=? 响应 +QLTONE: ( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的范围),(支持的范围),(支 持的范围) 设置命令 AT+QLTONE=[,, ,,] OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 234 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 播放完成时返回： +QLTONE: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。停止或开始播放。 0 停止播放 1 开始播放 整型。音调频率。范围：50~3500；单位：赫兹。 整型。音调的播放时间。范围：1~1000；单位：毫秒。 整型。音调的静音时间。范围：1~1000；单位：毫秒。 整型。音调的总时长。范围：1~15300000；单位：毫秒。 错误码。详情请参考第 14.5 章。 举例 AT+QLTONE=? //测试命令。 +QLTONE: (0,1),(50-3500),(1-1000),(1-1000),(1-15300000) OK AT+QLTONE=1,1000,200,300,3000 OK //播放 1000 赫兹音调，播放时间 200 毫秒，静音时间 300 毫秒， 总时长 3000 毫秒。 +QLTONE: 0 AT+QLTONE=0 OK //停止播放。 备注 针对 ECx00G 和 EGx00G 系列，仅支持 VoLTE 功能的模块支持该命令，详情请咨询移远通信技术支持； EG915G-EU 模块暂不支持该命令。 上海移远通信技术股份有限公司 235 / 279 LTE Standard(U)系列 AT 命令手册 12.23. AT+QLTONEX 播放本地定制音调 该命令用于播放本地定制音调。 AT+QLTONEX 播放本地定制音调 测试命令 AT+QLTONEX=? 响应 +QLTONEX: ( 支 持 的 列 表 ),,( 支 持 的 范围) 设置命令 AT+QLTONEX=[,, ] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放完成时返回： +QLTONEX: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。停止或开始播放。 0 停止播放 1 开始播放 字符串类型。待播放音调配置。格式为： ',,,,' 整型。待播放音调的最低频率。范围：50~3500；单位：赫兹。 整型。待播放音调的最高频率。范围：50~3500；单位：赫兹。 整型。音调的播放时间。范围：1~1000；单位：毫秒。 整型。音调的静音时间。范围：1~1000；单位：毫秒。 整型。待播放音调编号。范围：0~4。 整型。音调的总时长。范围：10~65535；单位：毫秒。 错误码。详情请参考第 14.5 章。 上海移远通信技术股份有限公司 236 / 279 LTE Standard(U)系列 AT 命令手册 举例 AT+QLTONEX=? +QLTONEX: (0,1),,(10-65535) OK AT+QLTONEX=1,'500,1000,400,400,1','300,800,600,600,0',4000 //播放 500~1000 赫兹音调，播放时间 400 毫秒，静音时间 400 毫秒；播放 300~800 赫兹音调，播放时间 600 毫秒，静音时间 600 毫秒；循环播放，直到总时间达到 4000 毫秒。 OK +QLTONEX: 0 AT+QLTONEX=0 OK //停止播放。 备注 针对 ECx00G 和 EGx00G 系列，仅支持 VoLTE 功能的模块支持该命令，详情请咨询移远通信技术支持； EG915G-EU 模块暂不支持该命令。 12.24. AT+QTONEDET 启用/禁用 DTMF 检测 该命令用于启用或禁用 DTMF 检测。若启用此功能，远端发送的 DTMF 音会被检测并上报到指定的串 口。 AT+QTONEDET 启用/禁用 DTMF 检测 测试命令 AT+QTONEDET=? 响应 +QTONEDET: (支持的列表) 查询命令 AT+QTONEDET? OK 响应 +QTONEDET: 设置命令 AT+QTONEDET= OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： 上海移远通信技术股份有限公司 237 / 279 LTE Standard(U)系列 AT 命令手册 最大响应时间 特性说明 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用 DTMF 检测。 0 禁用 1 启用 错误码。详情请参考第 14.5 章。 备注 DTMF 字符-ASCII： DTMF 0 1 2 3 4 5 6 7 ASCII 48 49 50 51 52 53 54 55 DTMF 8 9 A B C D * # ASCII 56 57 65 66 67 68 42 35 备注 EC200D、ECx00G 和 EGx00G 系列 EG915G-EU 模块暂不支持该命令。 上海移远通信技术股份有限公司 238 / 279 LTE Standard(U)系列 AT 命令手册 13 硬件相关命令 13.1. AT+QPOWD 关闭模块 该命令用于关闭模块。命令执行成功后立即返回 OK，随后 UE 注销网络。注销完成后 UE 输出 POWERED DOWN 并进入关机状态。注销网络最大时长为 60 秒。为避免数据丢失，在输出 POWERED DOWN 或拉低模块 STATUS 引脚之前，不能断开 UE 电源。 AT+QPOWD 关闭模块 测试命令 AT+QPOWD=? 响应 +QPOWD: (支持的列表) 设置命令 AT+QPOWD[=] OK 响应 OK 最大响应时间 特性说明 POWERED DOWN 300 毫秒 / 参数 整型。模块关机。 0 立即关机 1 正常关机 上海移远通信技术股份有限公司 239 / 279 LTE Standard(U)系列 AT 命令手册 13.2. AT+CCLK 实时时钟 该命令用于设置和查询模块实时时钟（RTC）。 AT+CCLK 实时时钟 测试命令 AT+CCLK=? 查询命令 AT+CCLK? 响应 OK 响应 +CCLK: 设置命令 AT+CCLK= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。格式：'yy/MM/dd,hh:mm:ss±zz'，分别表示年（最后两位）、月、日、小时、分 钟、秒和时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异；范围：-48 ~ +56）。例 如，1994 年 5 月 6 日 22:10:00 GMT + 2 小时等于'94/05/06,22:10:00+08'。 错误码。详情参考第 14.5 章。 举例 AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //查询本地时间。 上海移远通信技术股份有限公司 240 / 279 LTE Standard(U)系列 AT 命令手册 13.3. AT+CBC 查询电池充电状态和电量 该命令用于查询 MT 的电池充电状态和电池当前电量。 AT+CBC 查询电池充电状态和电量 测试命令 AT+CBC=? 响应 +CBC: (支持的范围),(支持的范围), 执行命令 AT+CBC OK 响应 +CBC: ,, 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。电池充电状态。 0 ME 未充电 1 ME 正在充电 2 充电已完成 整型。电池电量。 0–100 电池剩余的百分比电量 电池电压。单位：mV。 错误码。详情参考第 14.5 章。 备注 EC200D 系列模块不支持充电功能，仅返回模块供电引脚电压值，单位：mV。充电状态和电量值为0。 上海移远通信技术股份有限公司 241 / 279 LTE Standard(U)系列 AT 命令手册 13.4. AT+QADC 查询 ADC 值 该命令用于读取 ADC 通道的电压值。 AT+QADC 查询 ADC 值 测试命令 AT+QADC=? 响应 +QADC: (支持的列表) 查询命令 AT+QADC= OK 响应 +QADC: , 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。ADC 通道号。 0 ADC0 1 ADC1 2 ADC2 3 ADC3 整型。指定 ADC 通道的电压。单位：mV。 备注 1. EC200U 系列和 EC200G-CN 模块暂不支持 ADC3。 2. EC200D 系列、EC800G-CN、EG800G 系列和 EG91xU 系列模块暂不支持 ADC2和 ADC3。 3. EG915G-EU 模块暂不支持 ADC0和 ADC3。 13.5. AT+QWIFISCAN 同步扫描 Wi-Fi AP（热点）信息 AT+QWIFISCAN 同步扫描 Wi-Fi AP（热点）信息 测试命令 AT+QWIFISCAN=? 响应 +QWIFISCAN: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) 上海移远通信技术股份有限公司 242 / 279 LTE Standard(U)系列 AT 命令手册 查询命令 AT+QWIFISCAN? OK 响应 +QWIFISCAN: ,, 设置命令 AT+QWIFISCAN=,, OK 或者 ERROR 响应 [+QWIFISCAN: -,-,,,] […] 执行命令 AT+QWIFISCAN OK 或者 ERROR 响应 [+QWIFISCAN: -,-,,,] […] 最大响应时间 特性说明 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。扫描一个信道所需的时间。范围：4000~65000；默认值：12000。 整型。扫描周期。范围：1~3；默认值：1。 整型。扫描到的 AP 最大个数。范围：4~30；默认值：5。 整型。热点信号强度。范围：-111 ~ -46。 字符串类型。十六进制格式。热点 Mac 地址。 整型。AP 信道。范围：1~13。 备注 1. 文档适用模块的 Wi-Fi Scan 功能可选，因此上述命令只适用于支持 Wi-Fi Scan 的模块。 2. 同步扫描 Wi-Fi AP 信息时，先上报查询结果，再返回 OK。 3. 执行命令使用参数默认值扫描 Wi-Fi AP 信息。 4. EC200D 系列模块暂不支持该命令。 上海移远通信技术股份有限公司 243 / 279 LTE Standard(U)系列 AT 命令手册 5. ECx00G、EGx00G 系列和 EG915G-EU 模块扫描超时会返回 ERROR。 举例 AT+QWIFISCAN=? +QWIFISCAN: (4000-65000),(1-3),(4-30) OK AT+QWIFISCAN? +QWIFISCAN: 12000,1,5 //查询 Wi-Fi AP 信息同步扫描配置。 OK AT+QWIFISCAN //使用默认配置同步扫描 Wi-Fi AP 信息。 +QWIFISCAN: (-,-,-91,'44:00:4D:D5:26:E1',6) +QWIFISCAN: (-,-,-90,'44:00:4D:D5:26:E0',6) +QWIFISCAN: (-,-,-89,'44:00:4D:D5:27:01',11) +QWIFISCAN: (-,-,-89,'44:00:4D:D5:27:00',11) OK AT+QWIFISCAN=10000,1,13 //同步扫描 Wi-Fi AP 信息。 +QWIFISCAN: (-,-,-88,'44:00:4D:D5:26:E0',6) +QWIFISCAN: (-,-,-86,'44:00:4D:D5:26:E1',6) +QWIFISCAN: (-,-,-70,'44:00:4D:D5:27:00',11) +QWIFISCAN: (-,-,-68,'44:00:4D:D5:27:01',11) OK 13.6. AT+QWIFISCANEX 异步扫描 AP（热点）信息 AT+QWIFISCANEX 异步扫描 AP（热点）信息 测试命令 AT+QWIFISCANEX=? 响应 +QWIFISCANEX: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) 查询命令 AT+QWIFISCANEX? OK 响应 +QWIFISCANEX: ,, 上海移远通信技术股份有限公司 244 / 279 LTE Standard(U)系列 AT 命令手册 设置命令 AT+QWIFISCANEX=,, OK 或者 ERROR 响应 OK [+QWIFISCANEX: -,-,,,] […] 执行命令 AT+QWIFISCANEX 或者 ERROR 响应 OK [+QWIFISCANEX: -,-,,,] […] 最大响应时间 特性说明 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。扫描一个信道所需的时间。范围：4000~65000；默认值：12000。 整型。扫描周期。范围：1~3；默认值：1。 整型。扫描到的 AP 最大个数。范围：4~30；默认值：5。 整型。热点信号强度。参考范围：-111 ~ -46。 字符串类型。十六进制格式。热点 Mac 地址。 整型。AP 信道。范围：1~13。 备注 1. 文档适用模块的 Wi-Fi Scan 功能可选，因此上述命令只适用于支持 Wi-Fi Scan 的模块。 2. 异步扫描 Wi-Fi 热点信息时，先返回 OK；若查询到 Wi-Fi AP 信息，再异步上报查询结果。 3. 执行命令使用参数默认值扫描 Wi-Fi AP 信息。 4. EC200D 系列模块暂不支持该命令。 5. ECx00G、EGx00G 系列和 EG915G-EU 模块扫描超时会上报+QWIFISCANEX: SCAN TIMEOUT， 其他的错误会上报+QWIFISCANEX: ERROR。 上海移远通信技术股份有限公司 245 / 279 LTE Standard(U)系列 AT 命令手册 举例 AT+QWIFISCANEX=? +QWIFISCANEX: (4000-65000),(1-3),(4-30) OK AT+QWIFISCANEX? +QWIFISCANEX: 12000,1,5 //查询 Wi-Fi AP 信息异步扫描配置。 OK AT+QWIFISCANEX OK //使用默认配置异步扫描 Wi-Fi AP 信息。 +QWIFISCANEX: (-,-,-91,'44:00:4D:D5:26:E1',6) +QWIFISCANEX: (-,-,-90,'44:00:4D:D5:26:E0',6) +QWIFISCANEX: (-,-,-89,'44:00:4D:D5:27:01',11) +QWIFISCANEX: (-,-,-89,'44:00:4D:D5:27:00',11) AT+QWIFISCANEX=10000,1,13 //异步扫描 Wi-Fi AP 信息。 OK +QWIFISCANEX: (-,-,-88,'44:00:4D:D5:26:E0',6) +QWIFISCANEX: (-,-,-86,'44:00:4D:D5:26:E1',6) +QWIFISCANEX: (-,-,-70,'44:00:4D:D5:27:00',11) +QWIFISCANEX: (-,-,-68,'44:00:4D:D5:27:01',11) 上海移远通信技术股份有限公司 246 / 279 LTE Standard(U)系列 AT 命令手册 14 附录 14.1. 参考文档及术语缩写 表 8：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_FILE_应用指导 表 9：术语缩写 术语 3GPP ACK ACL ADC AID AMR APN ARFCN ASCII BCD CBM CCH 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 Acknowledgement 确认消息 Access Control List 访问控制列表 Analog To Digital Converter 模数转换器 Application Identifier 应用标识符 Adaptive Multi-Rate 自适应多速率 Access Point Name 接入点名称 Absolute Radio-Frequency Channel Number 绝对射频信道号 American Standard Code for Information 美国信息交换标准码 Interchange Binary-Coded Decimal 二进制编码的十进数 Cell Broadcast Message 小区广播消息 Control Channel 控制信道 上海移远通信技术股份有限公司 247 / 279 CDMA CFU CLI CLIP CLIR CMUX COL COLP COLR CPT CS CSD DCD DCE DCS DNS DTE DTMF DTR ECC ECT EGPRS EMM EONS EPS LTE Standard(U)系列 AT 命令手册 Code Division Multiple Access Call Forwarding Unconditional Calling Line Identification Calling Line Identification Presentation Calling Line Identification Restriction Connection Multiplexing Connected Line Connected Line Identification Presentation Connected Line Identification Restriction Communication Production Technology Circuit Switched/Circuit Switching Circuit Switched Data Data Carrier Detection Data Circuit-terminating Equipment Data Coding Scheme Domain Name Server Data Terminal Equipment Dual-Tone Multifrequency Data Terminal Ready Emergency Call Explicit Call Transfer Enhanced General Packet Radio Service EPS Mobility Management Enhanced Operator Name String Evolved Packet System 码分多址（利用码序列相关性实现的 多址通信） 无条件呼转 主叫线路识别 主叫线路识别提示 主叫线路识别限制 连接（串口）多路复用 被叫线路 被叫线路识别提示 被叫线路识别限制 通信生产技术 电路交换 电路交换数据 数据载波检测 数据电路终端设备 数据编码方案 域名系统（服务）协议 数据终端设备 双音多频 数据终端就绪 紧急通讯中心 呼叫转接 增强型数据速率 GSM 演进技术 EPS 移动管理 增强型运营商名称字符串 演进型分组系统 上海移远通信技术股份有限公司 248 / 279 ESM E-UTRAN FDD GERAN GGSN GMT GPIO GPRS GSM HLR HSDPA HSUPA ICCID IETF IIC IMEI IMSI IPv4 IPv6 IRA IRAT ISDN LIPA LLC LTE LTE Standard(U)系列 AT 命令手册 EPS Session Management EPS 会话管理 Evolved Universal Terrestrial Radio Access 演进型通用陆地无线接入网 Network Frequency Division Duplex 频分双工 GSM/EDGE Radio Access Network GSM/EDGE 无线通讯网络 Gateway GPRS Support Node 网关 GPRS 支持节点 Greenwich Mean Time 格林威治时间 General-Purpose Input/Output 通用型输入/输出 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Home Location Register 归属位置寄存器 High Speed Downlink Packet Access 高速下行分组接入 High Speed Uplink Packet Access 高速上行分组接入 Integrated Circuit Card Identifier 集成电路卡识别码 The Internet Engineering Task Force 互联网工程任务组 Inter-Integrated Circuit 集成电路总线 International Mobile Equipment Identity 国际移动设备识别码 International Mobile Subscriber Identity 国际移动用户识别码 Internet Protocol version 4 第 4 版互联网协议 Internet Protocol version 6 第 6 版互联网协议 International Reference Alphabet (7-bit coded 7-bit 国际参考字母编码字符集 character set) Inter-Radio Access Technology 异系统切换 Integrated Services Digital Network 综合业务数字网 Local IP Access 本地 IP 接入 Logical Link Control 逻辑链路控制 Long-Term Evolution 长期演进 上海移远通信技术股份有限公司 249 / 279 MCU ME MO MPTY MS MSC MSISDN MT MTU NAS NAT NITZ NSAPI NTP NV OIR PA PDN PDP PDU PIN PLMN PPP PS PUK LTE Standard(U)系列 AT 命令手册 Microprogrammed Control Unit 微程序控制器 Mobile Equipment 移动设备 Mobile Original 移动主叫 MultiParty 多方通话 Mobile Station 移动台 Mobile Services Switching Center 移动服务交换中心 Mobile Subscriber International Integrated 移动台国际用户识别码 Service Digital Network number Mobile Terminal 移动终端 Maximum Transmission Unit 最大传输单元 Non-Access Stratum 非接入层 Network Address Translator 网络地址转换 Network Identity and Time Zone / Network 网络标识和时区 Informed Time Zone Network Service Access Point Identifier 网络服务接入点标识符 Network Time Protocol 网络时间协议 Non-Volatile Memory 非易失性存储器 Originating Identification Restriction 主叫识别限制 Power Amplifier 功率放大器 Public Data Network 公用数据网络 Packet Data Protocol 分组数据协议 Protocol Data Unit 协议数据单元 Personal Identification Number 个人识别号 Public Land Mobile Network 公共陆地移动网络 Point-to-Point Protocol 点到点协议 Packet Switch 分组交换 PIN Unlock Key 个人识别密码解锁码 上海移远通信技术股份有限公司 250 / 279 QCI QMI QoS RAT RDI RI RPLMN RRC RTC RTS/CTS RxQual SDU SINR SMS SMSC SN SNDCP TA TDD TE TFT UART UCS2 UDH UDUB LTE Standard(U)系列 AT 命令手册 QoS Class Identifier QoS 等级标识 Qualcomm MSM (Mobile Station Modem) 高通 MSM（移动站 Modem）接口 Interface Quality of Service 服务质量 Radio Access Technology 无线接入技术 Remote Defect Indication 远端缺陷指示 Ring Indicator 振铃指示 Registered PLMN 已注册 PLMN Radio Resource Control 无线资源控制 Real-Time Clock 实时时钟 Request To Send/Clear To Send 请求/清除发送 Receive Quality 接收质量 Service Data Unit 服务数据单元 Signal-to-interference-plus-noise Ratio 信干噪比 Short Messag Service 短消息业务 Short Message Service Center 短消息服务中心 Serial Number SubNetwork Dependence Protocol Terminal Adapter 序列号 Convergence 子网相关汇聚协议 终端适配器 Time Division Duplex 时分双工 Terminal Equipment 终端设备 Traffic Flow Template 业务流模板 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Universal Character Set (UCS-2) Format 通用字符集格式 User Data Header 用户数据头 User Determined User Busy 用户决定用户忙 上海移远通信技术股份有限公司 251 / 279 UE UFS UMTS UICC UIM UL UMTS URC USB (U)SIM USSD UTRAN VLR VoLTE WLAN LTE Standard(U)系列 AT 命令手册 User Equipment 用户设备 User File System 用户文件系统 Universal Mobile Telecommunications System 通用移动通信系统 Universal Integrated Circuit Card 通用集成电路卡 User Identity Module 用户识别模块 Uplink 上行链路 Universal Mobile Telecommunications System 通用移动通信系统 Unsolicited Result Code 非请求结果码 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module （通用）用户识别模块 Unstructured Supplementary Service Data 非结构化补充数据业务 Universal Terrestrial Radio Access Network 通用陆地无线接入网 Visitor Location Register 拜访位置寄存器 Voice (voice calls) over LTE. A standard highspeed wireless communication for mobile phones and data terminals, including Internet of things devices and wearables. 长期演进语音承载 Wireless Local Area Network 无线局域网 14.2. AT&F 影响到的 AT 命令及参数 表 10：AT&F 影响到的 AT 命令及参数 AT 命令 ATE ATQ ATS0 参数名称 默认值 1 0 0 上海移远通信技术股份有限公司 252 / 279 ATS3 ATS4 ATS5 ATS7 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CMEE AT+CSCS AT+CSTA AT+CRC AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CPMS AT+CNMI AT+CMMS AT+CVHU AT+CLIP AT+COLP AT+CLIR ,,, ,, ,,,, LTE Standard(U)系列 AT 命令手册 13 10 8 0 1 4 1 2 0 0 1 'GSM' 129 0 0 0 17,167,0,0 0 'ME','ME','ME' 2,1,0,0,0 0 0 0 0 0 上海移远通信技术股份有限公司 253 / 279 AT+CSSN AT+CTZR AT+CPBS AT+CGEREP AT+CEREG AT+CCWA AT+CUSD AT+QAUDLOOP , 14.3. AT&W 影响到的 AT 命令及参数 表 11：AT&W 影响到的 AT 命令及参数 AT 命令 参数名称 ATE ATQ ATS0 ATS7 ATV ATX AT&C AT&D AT+IPR AT+CREG AT+CGREG AT+CEREG 上海移远通信技术股份有限公司 LTE Standard(U)系列 AT 命令手册 0 0 'SM' 0,0 0 0 0 0 是否通过 AT&V 显示 是 是 是 是 是 是 是 是 否 否 否 否 254 / 279 14.4. ATZ 影响到的 AT 命令及参数 表 12：ATZ 影响到的 AT 命令及参数 AT 命令 ATE ATQ ATS0 ATS7 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CEREG 参数名称 LTE Standard(U)系列 AT 命令手册 默认值 1 0 0 0 1 4 1 2 0 0 0 14.5. CME ERROR 错误码汇总 最终结果码+CME ERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果码。 同一命令行中未执行任一命令，则不会返回 ERROR 或 OK 结果码。 值常用于普通消息命令。下表列举了部分通用或 GPRS 相关 ERROR 码，此表不包含 GSM 规范 中描述的 GSM 协议错误相关错误码。 表 13：+CME ERROR: 错误码描述 错误码 0 1 英文含义 Phone failure No connection to phone 中文含义 拨打电话失败 电话未连接 上海移远通信技术股份有限公司 255 / 279 LTE Standard(U)系列 AT 命令手册 2 Phone-adaptor link reserved 保留电话适配器连接 3 Operation not allowed 操作不允许 4 Operation not supported 操作不支持 5 PH-SIM PIN required 需要 PH SIM 卡 PIN 码 6 PH-FSIM PIN required 需要 PH FSIM 卡 PIN 码 7 PH-FSIM PUK required 需要 PH FSIM 卡 PUK 码 10 SIM not inserted 未插入 SIM 卡 11 SIM PIN required 需要 SIM 卡 PIN 码 12 SIM PUK required 需要 SIM 卡 PUK 码 13 SIM failure SIM 卡失败 14 SIM busy SIM 卡忙 15 SIM wrong SIM 卡错误 16 Incorrect password 密码不正确 17 SIM PIN2 required 需要 SIM 卡 PIN2 码 18 SIM PUK2 required 需要 SIM 卡 PUK2 码 20 Memory full 内存已满 21 Invalid index 无效索引 22 Not found 未发现 23 Memory failure 内存不足 24 Text string too long 文本字符过长 25 Invalid characters in text string 无效文本字符 26 Dial string too long 拨号字符过长 27 Invalid characters in dial string 无效拨号字符 30 No network service 无网络服务 31 Network timeout 网络超时 32 Network not allowed - emergency calls only 网络不允许-仅支持紧急通话 40 Network personalization PIN required 需要网络个性化 PIN 41 Network personalization PUK required 需要网络个性化 PUK 上海移远通信技术股份有限公司 256 / 279 LTE Standard(U)系列 AT 命令手册 42 Network subset personalization PIN required 需要网络子集个性化 PIN 43 Network subset personalization PUK required 需要网络子集个性化 PUK 44 Service provider personalization PIN required 需要网络服务商个性化 PIN 45 Service provider personalization PUK required 需要网络服务商个性化 PUK 46 Corporate personalization PIN required 需要企业个性化 PIN 47 Corporate personalization PUK required 需要企业个性化 PUK 901 Audio unknown error 音频未知错误 902 Audio invalid parameters 音频无效参数 903 Audio operation not supported 音频操作不支持 904 Audio device busy 音频设备忙 919 Audio initialization uncompleted 音频功能未初始化完毕 14.6. CMS ERROR 错误码汇总 最终结果码+CMS ERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果码， 同一命令行中未执行任一命令，则不会返回 ERROR 或 OK 结果码。值常用于普通消息命令。 值常用于普通消息命令。 表 14：+CMS ERROR: 错误码描述 错误码 107 300 301 302 303 304 305 英文含义 Other General problems ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode 中文含义 其他常规问题 ME 失败 保留 SMS ME 操作不允许 操作不支持 无效 PDU 模式 无效文本模式 上海移远通信技术股份有限公司 257 / 279 LTE Standard(U)系列 AT 命令手册 310 SIM not inserted 未插入 SIM 卡 311 SIM pin necessary 需要 SIM 卡 PIN 码 312 PH SIM pin necessary 需要 PH SIM 卡 PIN 码 313 SIM failure SIM 卡失败 314 SIM busy SIM 卡忙 315 SIM wrong SIM 卡错误 316 SIM PUK required 需要 SIM PUK 317 SIM PIN2 required 需要 SIM PIN2 318 SIM PUK2 required 需要 SIM PUK2 320 Memory failure 内存不足 321 Invalid memory index 无效内存索引 322 Memory full 内存已满 330 SMSC address unknown 未知 SMSC 地址 331 No network 无网络 332 Network timeout 网络超时 340 No +CNMA acknowledgement expected 无期望 NMA 确认字符 350 Unknown 未知原因 500 Unknown 未知原因 510 Message blocked 消息堵塞 14.7. URC 汇总 表 15：URC 汇总 序号 URC 含义 条件 1 +CREG: 指示 ME 网络注册状态 AT+CREG=1 +CREG: [,,[,< 邻区更改后，指示当前网络是否已 2 AcT>]] 使用位置区号指示了 ME 状态 AT+CREG=2 上海移远通信技术股份有限公司 258 / 279 LTE Standard(U)系列 AT 命令手册 3 +CEREG: 指示 ME 网络注册状态 AT+CREG=1 4 +CEREG: [,,[, E-UTRAN 中的网络小区的变化 AT+CEREG=2 ]] 5 +CGREG: 指示 ME 网络注册状态 AT+CGREG=1 6 +CGREG: [,[],[],[],[]] 7 +CTZV: 时区上报 AT+CTZR=1 8 +CTZE: ,, 扩展时区上报 AT+CTZR=2 9 +CMTI: , 收到新的短消息并保存至内存 参见 AT+CNMI 10 +CMT: [], 收到新的短消息并直接输出到 TE （PDU 模式） 参见 AT+CNMI +CMT: ,[], 11 [,,,,,,,] 12 +CBM: 收到新 CBM 并直接输出（PDU 模 式） 参见 AT+CNMI 13 +CBM: ,,,, 14 +CDS: 收到新 CDS 并直接输出（PDU 模 式） 参见 AT+CNMI 15 +CDS: ,,[],[],,, 收到新 CDS 并直接输出（文本模 式） 参见 AT+CNMI +COLP: ,,[],[],[] 路） AT+COLP=1 +CLIP: ,,[sub 17 addr],[satype],[], 18 +CRING: 通过非请求结果码而非正常 RING 向 TE 指示来电 AT+CRC=1 19 +CCWA: ,,[,] AT+CCWA=1,1 20 +CSSI: 向 TE 指示+CSSI 中间结果码显示 状态 AT+CSSN=1 21 +CSSU: 向 TE 指示+CSSU 非请求结果码显 示状态 AT+CSSN=,1 +CUSD: 22 [,,[]] 网络下发的 USSD 响应或网络发起 的操作 AT+CUSD=1 上海移远通信技术股份有限公司 259 / 279 LTE Standard(U)系列 AT 命令手册 23 RDY MT 初始化成功 N/A 24 +CFUN: 1 MT 的所有功能均可用 N/A 25 +CPIN: (U) SIM 卡引脚状态 N/A 26 +QIND: SMS DONE SMS 初始化完成 N/A 27 +QIND: PB DONE 电话簿初始化完成 N/A 28 POWERED DOWN 模块掉电 AT+QPOWD +CGEV: REJECT , 绝 AT+CGEREP=1,1 30 +CGEV: NW REACT ,,[] AT+CGEREP=1,1 31 +CGEV: NW DEACT ,,[] AT+CGEREP=1,1 32 +CGEV: ME DEACT ,,[] AT+CGEREP=1,1 33 +CGEV: NW DETACH 网络强制去附着分组域 AT+CGEREP=1,1 34 +CGEV: ME DETACH ME 强制去附着分组域 AT+CGEREP=1,1 35 +CGEV: NW CLASS 网络强制更改 MS 类别 AT+CGEREP=1,1 36 +CGEV: ME CLASS ME 强制更改 MS 类别 AT+CGEREP=1,1 37 +CGEV: PDN ACT 已激活上下文 AT+CGEREP=1,1 38 +CGEV: PDN DEACT 去激活上下文 AT+CGEREP=1,1 39 +USIM: 0 使用 SIM 卡 N/A 40 +USIM: 1 使用 USIM 卡 N/A 41 +QIND: 'csq',, 信号强度和信道误码率变化指示 参见 AT+QINDCFG 42 +QIND: 'smsfull', 短消息存储已满指示 参见 AT+QINDCFG 43 +QIND: 'act', 网络访问技术变化指示 参见 AT+QINDCFG +QIND: 44 airplanestatus, 参见 开启飞行模式控制后，指示 W_DISABLE#引脚改变 AT+QCFG='airplanecontr ol' +QSIMSTAT: 45 , 指示(U)SIM 卡的插拔状态 参见 AT+QSIMSTAT 46 +QCSQ: [,[,[,[,]]]] 上海移远通信技术股份有限公司 260 / 279 47 +QNETDEVSTATUS: 指示网卡连接状态 48 +QAUDRIND: 0, 音频录制失败原因 +QAUDPIND: 49 0,1/+QAUDPIND: 0,6 音频播放失败原因 LTE Standard(U)系列 AT 命令手册 参见 AT+QNETDEVCTL 参见 AT+QAUDRD 参见 AT+QAUDPLAY 14.8. SMS 字符集转换 3GPP TS 23.038 DCS（数据编码方案）中针对 SMS 定义了三种字母表：GSM 7-bit 默认字母，8-bit 数据和 UCS2（16-bit）。AT+CSMP 用于文本模式（AT+CMGF=1）下设置 DCS。文本模式下，DCS 和 AT+CSCS 决定 SMS 文本输入和输出的方式。 表 16：SMS 文本输入和输出方式 DCS GSM 7-bit GSM 7-bit GSM 7-bit UCS2 8-bit AT+CSCS GSM IRA UCS2 - SMS 文本输入和输出方式 输入或输出 GSM 字符集 输入或输出 IRA 字符集。 输入：UE 将 IRA 字符转换为 GSM 字符。 输出：UE 将 GSM 字符转换为 IRA 字符。 输入或输出类似于 PDU 模式的十六进制字符串。 因此，仅支持字符 0– 9 和 A–F。 输入：UE 将 UCS2 十六进制字符串转换为 GSM 字符。 输出：UE 将 GSM 字符转换为 UCS2 十六进制字符串。 忽略 AT+CSCS 值，输入或输出类似于 PDU 模式的十六进制字符串。 仅支持字符 0–9 和 A–F。 忽略 AT+CSCS 值，输入或输出类似于 PDU 模式的十六进制字符串。 仅支持字符 0–9 和 A–F。 当 DCS 为 GSM 7-bit 时，需要进行输入或输出转换，详情参考如下表格。 表 17：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） 序号 0 1 2 3 4 5 0 00 10 20 30 40 50 1 01 11 21 31 41 51 2 02 12 22 32 42 52 6 7 60 70 61 71 62 72 上海移远通信技术股份有限公司 261 / 279 LTE Standard(U)系列 AT 命令手册 3 03 13 23 33 43 53 4 04 14 24 34 44 54 5 05 15 25 35 45 55 6 06 16 26 36 46 56 7 07 17 27 37 47 57 8 08 18 28 38 48 58 9 09 19 29 39 49 59 A 0A Submit 2A 3A 4A 5A B 0B Cancel 2B 3B 4B 5B C 0C 1C 2C 3C 4C 5C D 0D 1A 2D 3D 4D 5D E 0E 1E 2E 3E 4E 5E F 0F 1F 2F 3F 4F 5F 表 18：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） 序号 0 1 2 3 4 5 0 00 10 20 30 40 50 1 01 11 21 31 41 51 2 02 12 22 32 42 52 3 03 13 23 33 43 53 4 04 14 24 34 44 54 5 05 15 25 35 45 55 6 06 16 26 36 46 56 7 07 17 27 37 47 57 8 08 18 28 38 48 58 9 09 19 29 39 49 59 63 73 64 74 65 75 66 76 67 77 68 78 69 79 6A 7A 6B 7B 6C 7C 6D 7D 6E 7E 6F 7F 6 7 60 70 61 71 62 72 63 73 64 74 65 75 66 76 67 77 68 78 69 79 上海移远通信技术股份有限公司 262 / 279 LTE Standard(U)系列 AT 命令手册 A 0D0A 2A 3A 4A 5A B 0B 2B 3B 4B 5B C 0C 1C 2C 3C 4C 5C D 0D 1A 2D 3D 4D 5D E 0E 1E 2E 3E 4E 5E F 0F 1F 2F 3F 4F 5F 表 19：GSM 扩展字符（GSM 编码） 序号 0 1 2 3 4 5 0 1B40 1 2 3 4 1B14 5 6 7 8 1B28 9 1B29 A B C 1B3C D 1B3D E 1B3E F 1B2F 6A 7A 6B 7B 6C 7C 6D 7D 6E 7E 6F 7F 6 7 上海移远通信技术股份有限公司 263 / 279 LTE Standard(U)系列 AT 命令手册 表 20：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'） 序号 0 1 2 3 4 0 20 20 30 00 1 20 20 21 31 41 2 20 20 22 32 42 3 20 20 23 33 43 4 20 20 02 34 44 5 20 20 25 35 45 6 20 20 26 36 46 7 20 20 27 37 47 8 backspace 20 28 38 48 9 20 20 29 39 49 A 0A Submit 2A 3A 4A B 20 Cancel 2B 3B 4B C 20 20 2C 3C 4C D 0D 20 2D 3D 4D E 20 20 2E 3E 4E F 20 20 2F 3F 4F 5 6 50 20 51 61 52 62 53 63 54 64 55 65 56 66 57 67 58 68 59 69 5A 6A 1B3C 6B 1B2F 6C 1B3E 6D 1B14 6E 11 6F 7 70 71 72 73 74 75 76 77 78 79 7A 1B28 1B40 1B29 1B3D 20 表 21：IRA 扩展字符 序号 A B C D E F 0 20 20 20 20 7F 20 1 40 20 20 5D 20 7D 2 20 20 20 20 20 08 3 01 20 20 20 20 20 4 24 20 5B 20 7B 20 5 03 20 0E 20 0F 20 6 20 20 1C 5C 1D 7C 上海移远通信技术股份有限公司 264 / 279 LTE Standard(U)系列 AT 命令手册 7 5F 20 09 20 8 20 20 20 0B 9 20 20 1F 20 A 20 20 20 20 B 20 20 20 20 C 20 20 20 5E D 20 20 20 20 E 20 20 20 20 F 20 60 20 1E 表 22：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'） 序号 0 1 2 3 4 0 40 20 20 30 A1 1 A3 5F 21 31 41 2 24 20 22 32 42 3 A5 20 23 33 43 4 E8 20 A4 34 44 5 E9 20 25 35 45 6 F9 20 26 36 46 7 EC 20 27 37 47 8 F2 20 28 38 48 9 C7 20 29 39 49 A 0D0A 2A 3A 4A B D8 2B 3B 4B C F8 C6 2C 3C 4C D 0D E6 2D 3D 4D 20 20 04 0C 05 06 20 20 20 20 07 7E 20 20 20 20 20 20 5 6 7 50 BF 70 51 61 71 52 62 72 53 63 73 54 64 74 55 65 75 56 66 76 57 67 77 58 68 78 59 69 79 5A 6A 7A C4 6B E4 D6 6C F6 D1 6D F1 上海移远通信技术股份有限公司 265 / 279 LTE Standard(U)系列 AT 命令手册 E C5 DF 2E 3E 4E DC 6E FC F E5 C9 2F 3F 4F A7 6F E0 表 23：GSM 扩展字符（ISO-8859-1/Unicode） 序号 0 1 2 3 4 5 6 7 0 7C 1 2 3 4 5E 5 6 7 8 7B 9 7D A B C 5B D 7E E 5D F 5C 由于 UCS2 字符集的低 8 位与 IRA 字符相同，所以： ⚫ DCS 等于 GSM 7-bit 且 AT+CSCS='UCS2'转换表与 AT+CSCS='IRA'相似。 ⚫ fmt 等于 GSM 7-bit 且 AT+CSCS='GSM'转换表与 AT+CSCS='GSM'相似。 ⚫ fmt 等于 GSM 7-bit 且 AT+CSCS='IRA'转换表与 AT+CSCS='IRA'相似。 ⚫ fmt 等于 GSM 7-bit 且 AT+CSCS='UCS2'转换表与 AT+CSCS='IRA'相似。 上海移远通信技术股份有限公司 266 / 279 SMS 文本输入或输出的方式差异详情参考表 16。 LTE Standard(U)系列 AT 命令手册 14.9. AT+CEER 扩展错误报告列表 表 24：错误位置 ID 列表 错误位置 ID 英文含义 0 CS internal cause 1 CS network cause 2 CS network reject 3 PS internal cause 4 PS network cause 5 PS LTE cause 6 PS LTE local cause 中文含义 CS 域内部原因 CS 域网络原因 CS 域网络拒绝 PS 域内部原因 PS 域网络原因 PS 域 LTE 原因 PS 域 LTE 本地原因 表 25：错误报告列表 CS 域内部原因 英文含义 -1 No cause information available (default) 0 Phone is offline 21 No service available 25 Network release, no reason given 27 Received incoming call 29 Client ended call 34 UIM not present 35 Access attempt already in progress 36 Access failure, unknown source 中文含义 无原因信息 电话脱机 无服务 网络释放，未指明原因 接听来电 客户端结束通话 UIM 不存在 接入尝试已存在 接入失败，未知源 上海移远通信技术股份有限公司 267 / 279 LTE Standard(U)系列 AT 命令手册 38 Concur service not supported by network 39 No response received from network 45 GPS call ended for user call 46 SMS call ended for user call 47 Data call ended for emergency call 48 Rejected during redirect or handoff 100 Lower-layer ended call 101 Call origination request failed 102 Client rejected incoming call 103 Client rejected setup indication 104 Network ended call 105 No funds available 106 No service available 108 Full service not available 109 Maximum packet calls exceeded 301 Video connection lost 302 Video call setup failure 303 Video protocol closed after setup 304 Video protocol setup failure 305 Internal error CS 域网络原因 英文含义 1 Unassigned/unallocated number 3 No route to destination 6 Channel unacceptable 8 Operator determined barring 网络不支持 Concur 服务 未接收到网络响应 终止 GPS 呼叫以支持用户呼叫 终止短消息呼叫以支持用户呼叫 终止数据呼叫以支持紧急呼叫 转接或切换时被拒绝 底层结束通话 主叫请求失败 客户端拒绝来电 客户端拒绝设置指示 网络结束通话 无可用资金 无服务 全服务不可用 超过最大分组通话数 视频连接断开 视频通话设置错误 视频协议设置后被关闭 视频协议设置失败 内部错误 中文含义 未分配的号码（空号） 无至目的地的路由 不可接受的信道 运营者决定的闭锁业务 上海移远通信技术股份有限公司 268 / 279 LTE Standard(U)系列 AT 命令手册 16 Normal call clearing 正常呼叫清除 17 User busy 用户忙 18 No user responding 无用户响应 19 User alerting, no answer 用户振铃，无应答 21 Call rejected 呼叫被拒绝 22 Number changed 号码改变 26 Non selected user clearing 非选定用户清除 27 Destination out of order 终点故障 28 Invalid/incomplete number 无效/不完全的号码 29 Facility rejected 设施被拒绝 30 Response to status enquiry 对状态询问的响应 31 Normal, unspecified 正常，未指定 34 No circuit/channel available 无电路/信道可用 38 Network out of order 网络故障 41 Temporary failure 临时故障 42 Switching equipment congestion 交换设备拥塞 43 Access information discarded 接入信息被丢弃 44 Requested circuit/channel not available 请求的电路/信道不可用 47 Resources unavailable, unspecified 资源不可用，未指定 49 Quality of service unavailable 服务质量不可用 50 Requested facility not subscribed 请求设备未预定 55 Incoming calls barred within the CUG CUG 内的来电阻断 57 Bearer capability not authorized 承载容量未批准 58 Bearer capability not available 承载容量当前不可用 63 Service/option not available 服务/选择不可用 上海移远通信技术股份有限公司 269 / 279 LTE Standard(U)系列 AT 命令手册 65 Bearer service not implemented 68 ACM >= ACM max 69 Requested facility not implemented 70 Only RDI bearer is available 79 Service/option not implemented 81 Invalid transaction identifier value 87 User not member of CUG 88 Incompatible destination 91 Invalid transit network selection 95 Semantically incorrect message 96 Invalid mandatory information 97 Message non-existent/not implemented 98 Message type not compatible with state 99 IE non-existent/not implemented 100 Conditional IE error 101 Message not compatible with state 102 Recovery on timer expiry 111 Protocol error, unspecified 127 Interworking, unspecified CS 域网络拒绝 英文含义 2 IMSI unknown in HLR 3 Illegal MS 4 IMSI unknown in VLR 5 IMEI not accepted 6 Illegal ME 承载服务未实施 ACM 等同或大于 ACM max 请求设备未实施 仅 RDI 承载可用 服务/选择未实施 无效交易标识符 用户非 CUG 成员 不兼容的目的地 无效转接网选择 语义错误消息 无效强制信息 消息不存在或未实施 消息类型与协议状态不兼容 信息元素不存在或未实施 条件 IE 错误 消息与协议状态不兼容 计时器到时恢复 协议错误，未指定 互通，未指定 中文含义 HLR 未定义该 IMSI 非法 MS VLR 未定义该 IMSI 不可接受的 IMEI 非法 ME 上海移远通信技术股份有限公司 270 / 279 LTE Standard(U)系列 AT 命令手册 7 GPRS services not allowed 不允许的 GPRS 服务 8 GPRS and non GPRS services not allowed 不允许的 GPRS 及非 GPRS 服务 9 MS identity cannot be derived 无法获取用户身份 10 Implicitly detached 用户隐式分离 11 PLMN not allowed 不允许的 PLMN 12 Location area not allowed 不允许的位置区域 13 Roaming not allowed 不允许漫游 14 GPRS services not allowed in PLMN 当前的 PLMN 不允许 GPRS 服务 15 No suitable cells in location area 本位置区不存在匹配的小区 16 MSC temporary not reachable MSC 暂时不可达 17 Network failure 网络错误 20 MAC failure MAC 错误 21 Synch failure 同步失败 22 Congestion 拥塞 23 GSM authentication unacceptable GSM 鉴权失败 32 Service option not supported 不支持的服务选择 33 Requested service option not subscribed 为预定请求的服务选择 34 Service option temporary out of order 服务选择暂时故障 38 Call cannot be identified 呼叫无法识别 40 No PDP context activated 无激活的 PDP 上下文 95 Semantically incorrect message 语义错误消息 96 Invalid mandatory information 无效强制信息 97 Message type non-existent 消息类型不存在 98 Message type not compatible with state 消息类型与协议状态不兼容 99 Information element non-existent 信息元素不存在 上海移远通信技术股份有限公司 271 / 279 101 Message not compatible with state 161 RR release indication 162 RR random access failure 163 RRC release indication 164 RRC close session indication 165 RRC open session failure 166 Low level failure 167 Low level failure no redial allowed 168 Invalid SIM 169 No service 170 Timer T3230 expired 171 No cell available 172 Wrong state 173 Access class blocked 174 Abort message received 175 Other cause 176 Timer T303 expired 177 No resources 178 Release pending 179 Invalid user data PS 域内部原因 英文含义 0 Invalid connection identifier 1 Invalid NSAPI 2 Invalid primary NSAPI 7 PDP establish timeout 上海移远通信技术股份有限公司 LTE Standard(U)系列 AT 命令手册 消息与协议状态不兼容 RR 释放指示 RR 随机接入失败 RRC 释放指示 RRC 关闭会话指示 RRC 打开会话失败 底层错误 底层错误，不允许重拨 无效 SIM 卡 无服务 定时器 T303 过期 无小区可用 错误状态 接入类型受阻 接收到中止消息 其他原因 定时器 T303 过期 无资源 待释放 无效用户数据 中文含义 无效连接标识符 无效 NSAPI 无效首选 NSAPI PDP 创建超时 272 / 279 LTE Standard(U)系列 AT 命令手册 3 Invalid field 4 SNDCP failure 5 RAB setup failure 6 No GPRS context 8 PDP activate timeout 9 PDP modify timeout 10 PDP inactive max timeout 11 PDP lower layer error 12 PDP duplicate 13 Access technology change 14 PDP unknown reason PS 域网络原因 英文含义 25 LLC or SNDCP failure 26 Insufficient resources 27 Missing or unknown APN 28 Unknown PDP address or PDP type 29 User authentication failed 30 Activation rejected by GGSN 31 Activation rejected, unspecified 32 Service option not supported 33 Requested service option not subscribed 34 Service option temporary out of order 35 NSAPI already used (not sent) 36 Regular deactivation 37 QoS not accepted 无效字段 SNDCP 失败 RAB 设置失败 无 GPRS 上下文 PDP 激活超时 PDP 修改超时 PDP 不活跃最大时间超时 PDP 底层错误 PDP 重复 接入技术改变 PDP 未知原因 中文含义 LLC 或 SDNCP 错误 资源不足 丢失或未知 APN 未知 PDP 地址或 PDP 类型 用户鉴权失败 激活请求被 GGSN 拒绝 激活请求被拒绝，未指定 不支持的服务选择 未预定请求的服务选择 服务选择暂时故障 NSAPI 已被占用（未发送） 常规去激活 不接受的服务质量 上海移远通信技术股份有限公司 273 / 279 LTE Standard(U)系列 AT 命令手册 38 Network failure 39 Reactivation required 40 Feature not supported 41 Semantic error in the TFT operation 42 Syntactical error in the TFT operation 43 Unknown PDP context 44 PDP context without TFT already activated 45 Semantic errors in packet filter 46 Syntactical errors in packet filter 81 Invalid transaction identifier 95 Semantically incorrect message 96 Invalid mandatory information 97 Message non-existent/not implemented 98 Message type not compatible with state 99 IE non-existent/not implemented 100 Conditional IE error 101 Message not compatible with state 111 Protocol error, unspecified PS 域 LTE 原因 英文含义 网络错误 需重新激活 功能不支持 TFT 操作语义错误 TFT 操作语法错误 未知 PDP 上下文 无 TFT 的 PDP 上下文已被激活 分组过滤器语义错误 分组过滤器语法错误 无效交易标识符 语义错误信息 无效强制信息 消息不存在或未实施 消息类型与协议状态不兼容 信息元素不存在或未实施 条件 IE 错误 消息与协议状态不兼容 协议错误，未指定 中文含义 8 Operator determined barring 运营者决定的闭锁业务 26 Insufficient Resources 资源不足 27 Missing or unknown APN 丢失或未知 APN 28 Unknown PDP address or PDP type 未知 PDP 地址或 PDP 类型 29 User Aauthentication faile 用户鉴权失败 30 Activation rejected by Servicing GW or PDN GW 激活请求被服务 GW 或 PDN GW 拒绝 上海移远通信技术股份有限公司 274 / 279 LTE Standard(U)系列 AT 命令手册 31 Activation rejected, unspecified 激活请求被拒绝，未指定 32 Service option not supported 不支持的服务选择 33 Requested service option not subscribed 未预定请求的服务选择 34 Service option temporarily out of order 服务选择暂时故障 35 PTI already In use PTI 已被占用 36 Regular deactivation 常规去激活 37 QoS not accepted 不接受的服务质量 38 Network failure 网络错误 39 Reactivation required 需重新激活 40 Feature not supported 功能不支持 41 Semantic error in the TFT operation TFT 操作语义错误 42 Syntactical error in the TFT operation TFT 操作语法错误 43 Unknown Bearer context 未知承载上下文 44 Semantic errors in packet filter 分组过滤器语义错误 45 Syntactical errors in packet filter 分组过滤器语法错误 46 Bearer Context without TFT already Active 无 TFT 的承载上下文已被激活 47 PTI mismatch PTI 搭配错误 49 PDN disconnected ,Not allowed PDN 断开连接，不允许 50 PDN type IPV4 only Allowed 仅允许 PDN 类型为 IPv4 51 PDN type IPV6 only Allowed 仅允许 PDN 类型为 IPv6 52 Single ADR bearers only Allowed 仅允许单独 ADR 承载 53 ESM info not recieved ESM 信息未收到 54 PDN connection does not exist PDN 连接不存在 55 Multiple PDN connection for given APN not allowed 指定 APN 不允许多 PDN 连接 56 Collision with network init request 与网络初始化请求冲突 上海移远通信技术股份有限公司 275 / 279 LTE Standard(U)系列 AT 命令手册 59 Unsupported QCI value 不支持的 QCI 值 81 Invalid PTI value 无效 PTI 值 95 Symantically invalid message 语义错误消息 96 Invalid mandatory information 无效强制信息 97 Message non-existent/not implemented 消息不存在或未实施 98 Message type not compatible with state 消息类型与协议状态不兼容 99 Info Elemant non existent 信息要素不存在 100 Conditional IE error 条件 IE 错误 101 Message type not compatible with state 消息类型与协议状态不兼容 111 Protocol error, unspecified 协议错误，未指定 112 PS 域 LTE 本地 原因 APN restrict value incompatible with ACT context 英文含义 APN 限制值与 ACT 上下文不适配 中文含义 3 Illegal UE 非法 UE 6 Illegal ME 非法 ME 7 EPS services not allowed 不允许的 EPS 服务 9 UE id can't be driven by network UE ID 无法被网络驱动 10 Implicitly Detached 用户隐式分离 11 PLMN not allowed 不允许的 PLMN 12 Tracking area not allowed 不允许的跟踪区域 13 Roaming not allowed in this tracking area 此跟踪区域不允许漫游 15 No Suitable cells in tracking area 跟踪区域无合适小区 18 CS Domain Not available CS 域不可用 25 Not Authorized for this CSG CSG 未授权 38 CS fallback call EST not allowed EST 不允许的 CS 回电 39 CS domain temperarly not allowed 暂时不允许的 CS 域 上海移远通信技术股份有限公司 276 / 279 LTE Standard(U)系列 AT 命令手册 43 Unknown EPS bearer context 未知 EPS 承载上下文 256 Released AT RRC 释放的 AT RRC 257 Signal Connection Released 释放的信号连接 258 EMM detached EMM 分离 259 EMM attach failed EMM 驻留失败 260 EMM attach started EMM 开始驻留 261 NAS service request failed NAS 服务请求失败 262 ESM activate dedicated bearer reactivater by ESM 通过网络激活指定承载重新激活 network 器 263 Lower layer failure 底层失败 264 Lower layer failure 底层失败 265 Network activater dedicated bearer with ID of deffered bearer 网络使用承载 ID 激活指定承载 266 BAD OTA message BAD OTA 消息 267 DS rejected the call DS 拒绝来电 268 Context transferred due to IRAT 由 IRAT 传输的内容 269 DS explicit deactivation DS 显式去激活 270 ESM MSGR failure ESM MSGR 失败 271 Local Cause not available 本地原因不可用 272 Rejected due to connected state 因已连接状态拒绝 273 NAS Service request failed, no throttle NAS 服务请求失败，无节流 274 ACL failure ACL 失败 275 NAS Service request failed , DS disallow NAS 服务请求失败，DS 驳回 276 EMM T3417 expired EMM T3417 定时器过时 277 EMM T3417 ext expired EMM T3417 ext 定时器过时 278 NAS LRRC UL data CNF failure TXN NAS LRRC 上行数据 CNF 失败 TXN 279 NAS LRRC UL data CNF failure HO NAS LRRC 上行数据 CNF 失败 HO 上海移远通信技术股份有限公司 277 / 279 LTE Standard(U)系列 AT 命令手册 280 NAS LRRC UL data CNF failure CONN NAS LRRC 上行数据 CNF 失败 CONN release 释放 281 NAS LRRC UL data CNF failure RLF NAS LRRC 上行数据 CNF 失败 RLF 282 NAS LRRC UL data CNF failure control Not NAS LRRC 上行数据 CNF 失败控制 CONN Not CONN 283 NAS LRRC connection EST success NAS LRRC 连接 EST 成功 284 NAS LRRC connection EST failure NAS LRRC 连接 EST 失败 285 NAS LRRC connection EST failure, aborted NAS LRRC 连接 EST 失败，中止 286 NAS LRRC connection EST failure, access barrer NAS LRRC 连接 EST 失败，接入受阻 287 NAS LRRC connection EST failure, CELL resel NAS LRRC 连接 EST 失败，小区释放 288 NAS LRRC connection EST failure, config failure NAS LRRC 连接 EST 失败，配置失败 289 NAS LRRC connection EST failure, timer NAS LRRC 连接 EST 失败，定时器超 expired 时 290 NAS LRRC connection EST failure, link failure NAS LRRC 连接 EST 失败，链路失败 291 NAS LRRC connection EST failure, not camped NAS LRRC 连接 EST 失败，不可驻留 292 NAS LRRC connection EST failure, SI failure NAS LRRC 连接 EST 失败，SI 失败 293 NAS LRRC connection EST failure, CONN NAS LRRC 连接 EST 失败，CONN 拒 reject 绝 294 NAS LRRC connection release normal NAS LRRC 连接释放，正常 295 NAS LRRC connection release RLF NAS LRRC 连接释放，RLF 296 NAS LRRC connection release CRE failure NAS LRRC 连接释放，CRE 失败 297 NAS LRRC connection release QOS during CRE NAS LRRC 连接释放，CRE 时 QoS 298 NAS LRRC connection release aborted NAS LRRC 连接释放，中止 299 NAS LRRC connection release SIB read error NAS LRRC 连接释放，SIB 读取错误 300 NAS LRRC connection release aborted IRAT success NAS LRRC 连接释放，中止 IRAT 成功 301 NAS Reject LRRC radio link failure NAS 拒绝 LRRC 无线电链路失败 302 NAS service request failure, LTE network reject NAS 服务请求失败，LTE 网络拒绝 上海移远通信技术股份有限公司 278 / 279 LTE Standard(U)系列 AT 命令手册 303 NAS detach with reattach, LTE network detach NAS 分离后重连，LTE 网络分离 304 NAS detach without reacttach, LTE network detach NAS 分离后不重连，LTE 网络分离 上海移远通信技术股份有限公司 279 / 279

LTE Standard(A)系列 AT 命令手册 LTE Standard 模块系列 版本：1.1 日期：2022-02-21 状态：受控文件 M10_ATC Confidential / Released 1 / 10 LTE Standard(A)系列 AT 命令手册 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 189 LTE Standard(A)系列 AT 命令手册 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 189 LTE Standard(A)系列 AT 命令手册 文档历史 修订记录 版本 1.0 日期 2021-09-10 2021-12-13 作者 Yule DENG/ Isaac SHI Yule DENG/ Isaac SHI Yule DENG/ 1.1 2022-02-21 Isaac SHI 变更表述 文档创建 受控版本 1. 增加文档适用模块 EC200A 系列、EC800N-CN 和 EG915N-EU。 2. 删除命令 A/。 3. 删除命令 AT+QCELL。 4. 新增 EC200A 系列暂不支持打开/关闭 URC 缓存 相关批注（第 4.3.9 章）。 5. 更新命令 AT+QINDCFG 的参数的取值 （第 4.4 章）。 6. 更新 AT+CPBW 的示例（第 8.5 章）。 7. 更新命令 AT+CGSMS 的参数的默认值 为 3（第 10.13 章）。 8. 新增批注（第 4.3.9 章）。 9. 更新 URC 汇总（第 12.7 章）。 上海移远通信技术股份有限公司 3 / 189 LTE Standard(A)系列 AT 命令手册 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 8 1 引言 ........................................................................................................................................................ 9 1.1. 本章概要 ...................................................................................................................................... 9 1.2. 定义 ........................................................................................................................................... 10 1.3. AT 命令语句............................................................................................................................... 10 1.4. AT 命令响应............................................................................................................................... 11 1.5. 支持的字符集............................................................................................................................. 11 1.6. AT 命令端口............................................................................................................................... 12 1.7. 未经请求的结果码 ..................................................................................................................... 12 1.8. 关闭程序 .................................................................................................................................... 12 1.9. AT 示例声明............................................................................................................................... 12 2 通用命令 ............................................................................................................................................... 13 2.1. ATI 显示 MT 的 ID 信息........................................................................................................... 13 2.2. AT+GMI 请求制造商信息 ........................................................................................................ 14 2.3. AT+GMM 请求 TA 型号 ID ...................................................................................................... 14 2.4. AT+GMR 请求 TA 固件版本 ID ............................................................................................... 15 2.5. AT+CGMI 请求制造商信息 ..................................................................................................... 15 2.6. AT+CGMM 请求 TA 型号 ID ................................................................................................... 16 2.7. AT+CGMR 请求 TA 固件版本 ID............................................................................................. 16 2.8. AT+GSN 请求国际移动设备识别码（IMEI 号） ..................................................................... 17 2.9. AT+CGSN 请求国际移动设备识别码...................................................................................... 18 2.10. AT&F 重置 AT 命令设置为出厂设置........................................................................................ 18 2.11. AT&V 显示当前配置................................................................................................................ 19 2.12. AT&W 存储当前设置到用户自定义配置文件 .......................................................................... 20 2.13. ATZ 从用户定义配置文件还原所有 AT 命令设置 .................................................................... 20 2.14. ATQ 设置结果码回显模式 ....................................................................................................... 21 2.15. ATV TA 响应格式 .................................................................................................................... 21 2.16. ATE 设置命令回显模式 ........................................................................................................... 23 2.17. ATS3 设置命令行终止符 ......................................................................................................... 23 2.18. ATS4 设置响应格式字符 ......................................................................................................... 24 2.19. ATS5 设置命令行编辑字符 ..................................................................................................... 24 2.20. ATX 设置 CONNECT 结果码格式和检测呼叫进程 ................................................................. 25 2.21. AT+CFUN 设置功能模式 ........................................................................................................ 26 2.22. AT+CMEE 设置错误讯息格式................................................................................................. 27 2.23. AT+CSCS 选择 TE 字符集...................................................................................................... 28 2.24. AT+QURCCFG 配置 URC 指示选项 ...................................................................................... 29 2.25. AT+QPPPDROP 终止 PPP 连接 ............................................................................................ 31 3 串口控制命令........................................................................................................................................ 32 上海移远通信技术股份有限公司 4 / 189 LTE Standard(A)系列 AT 命令手册 3.1. AT&C 设置 DCD 信号模式...................................................................................................... 32 3.2. AT&D 设置 DTR 信号模式 ...................................................................................................... 32 3.3. AT+IFC 设置串口的流控方式.................................................................................................. 33 3.4. AT+IPR 设置固定的串口通信波特率....................................................................................... 34 4 状态控制命令........................................................................................................................................ 36 4.1. AT+CPAS 查询 ME 活动状态.................................................................................................. 36 4.2. AT+CEER 上报扩展错误 ........................................................................................................ 37 4.3. AT+QCFG 扩展命令 ............................................................................................................... 38 4.3.1. AT+QCFG='gprsattach' 配置 GPRS 附着模式 ........................................................... 39 4.3.2. AT+QCFG='nwscanmode' 配置网络搜索模式............................................................ 40 4.3.3. AT+QCFG='nwscanseq' 配置网络搜索顺序............................................................... 41 4.3.4. AT+QCFG='roamservice' 配置漫游服务 .................................................................... 42 4.3.5. AT+QCFG='servicedomain' 配置服务域 .................................................................... 43 4.3.6. AT+QCFG='band' 配置频段........................................................................................ 44 4.3.7. AT+QCFG='urc/ri/other' 设置其他 URC 上报时的 RI 行为 ......................................... 45 4.3.8. AT+QCFG='urcdelay' 设置 URC 延迟时间................................................................. 46 4.3.9. AT+QCFG='urc/cache' 打开/关闭 URC 缓存.............................................................. 46 4.3.10. AT+QCFG='usbnet' 配置网卡接口 ............................................................................. 48 4.3.11. AT+QCFG='ppp/termframe' 启用/禁用 PPP TERM 帧发送功能 ................................ 49 4.3.12. AT+QCFG='airplanecontrol' 启用/禁用通过 W_DISABLE#控制飞行模式.................. 50 4.3.13. AT+QCFG='urc/ri/ring' 设置来电 URC 上报时的 RI 行为 ........................................... 52 4.3.14. AT+QCFG='risignaltype' RI 信号输出载体 ................................................................. 53 4.3.15. AT+QCFG=''uart2ipr'' 配置波特率 ............................................................................... 54 4.3.16. AT+QCFG='nat' 配置网卡工作模式 ............................................................................ 55 4.4. AT+QINDCFG 控制 URC 上报 ............................................................................................... 56 5 (U)SIM 卡相关命令............................................................................................................................... 59 5.1. AT+CIMI 查询 IMSI ................................................................................................................. 59 5.2. AT+CLCK 功能锁定 ................................................................................................................ 60 5.3. AT+CPIN PIN 管理 ................................................................................................................. 62 5.4. AT+CPWD 修改密码............................................................................................................... 63 5.5. AT+CSIM 通用(U)SIM 卡访问................................................................................................. 65 5.6. AT+CRSM (U)SIM 卡受限访问............................................................................................... 66 5.7. AT+QCCID 查询 ICCID........................................................................................................... 67 5.8. AT+QPINC 获取 PIN 剩余重试次数........................................................................................ 67 5.9. AT+QINISTAT 查询(U)SIM 卡初始化状态............................................................................... 68 5.10. AT+QSIMDET (U)SIM 卡检测 ................................................................................................ 69 5.11. AT+QSIMSTAT (U)SIM 卡插拔状态上报 ................................................................................ 70 6 网络服务命令........................................................................................................................................ 72 6.1. AT+COPS 选择运营商............................................................................................................ 72 6.2. AT+CREG CS 域网络注册状态 .............................................................................................. 74 6.3. AT+CSQ 查询信号强度........................................................................................................... 75 6.4. AT+CPOL 配置首选运营商列表.............................................................................................. 77 6.5. AT+COPN 查询运营商名称列表 ............................................................................................. 78 上海移远通信技术股份有限公司 5 / 189 LTE Standard(A)系列 AT 命令手册 6.6. AT+CTZU 自动更新时区......................................................................................................... 79 6.7. AT+CTZR 上报时区变化......................................................................................................... 80 6.8. AT+QLTS 获取通过网络同步的最新时间................................................................................ 82 6.9. AT+QNWINFO 查询网络信息................................................................................................. 83 7 呼叫相关命令........................................................................................................................................ 85 7.1. ATA 呼叫应答 .......................................................................................................................... 85 7.2. ATD 发起呼叫 ......................................................................................................................... 86 7.3. AT+COLP 被叫线路识别显示 ................................................................................................. 87 7.4. ATH 挂断现有连接 .................................................................................................................. 89 7.5. AT+CHUP 挂断语音通话 ........................................................................................................ 89 7.6. +++ 从数据模式切换至命令模式............................................................................................. 90 7.7. ATO 从命令模式切换至数据模式 ............................................................................................ 91 7.8. ATS0 设置自动应答前振铃次数 .............................................................................................. 91 7.9. AT+CLCC 查询当前 ME 呼叫 ................................................................................................. 92 7.10. AT^DSCI 指示呼叫状态 .......................................................................................................... 94 8 电话本相关命令.................................................................................................................................... 96 8.1. AT+CNUM 查询本机号码........................................................................................................ 96 8.2. AT+CPBF 搜索电话本 .............................................................................................................. 97 8.3. AT+CPBR 读取电话本条目..................................................................................................... 98 8.4. AT+CPBS 设置电话本存储器 ................................................................................................. 99 8.5. AT+CPBW 写入电话本 ......................................................................................................... 100 9 短消息相关命令 .................................................................................................................................. 102 9.1. AT+CSMS 选择短消息服务类型 ........................................................................................... 102 9.2. AT+CMGF 配置短消息模式 .................................................................................................. 103 9.3. AT+CSCA 设置短消息服务中心地址 .................................................................................... 104 9.4. AT+CPMS 配置短消息首选存储位置.................................................................................... 105 9.5. AT+CMGD 删除短消息 ......................................................................................................... 106 9.6. AT+CMGL 按状态读取短消息............................................................................................... 108 9.7. AT+CMGR 按照索引读取短消息 ...........................................................................................111 9.8. AT+CMGS 发送短消息 ......................................................................................................... 114 9.9. AT+CMMS 发送多条短消息.................................................................................................. 116 9.10. AT+CMGW 存储短消息 ........................................................................................................ 117 9.11. AT+CMSS 从存储器发送短消息 ........................................................................................... 119 9.12. AT+CNMA 新短消息确认 ...................................................................................................... 120 9.13. AT+CNMI 设置短消息上报方式 ............................................................................................ 122 9.14. AT+CSCB 选择小区广播消息类型........................................................................................ 124 9.15. AT+CSDH 设置文本模式下参数显示 .................................................................................... 125 9.16. AT+CSMP 设置短消息文本模式参数.................................................................................... 126 9.17. AT+QCMGS 发送级联短消息 ............................................................................................... 127 9.18. AT+QCMGR 读取级联短消息............................................................................................... 128 10 分组域命令 ......................................................................................................................................... 131 10.1. AT+CGATT PS 域附着或去附着 ........................................................................................... 131 上海移远通信技术股份有限公司 6 / 189 LTE Standard(A)系列 AT 命令手册 10.2. AT+CGDCONT 定义 PDP 上下文 ........................................................................................ 132 10.3. AT+CGQREQ 服务质量参数（请求的） .............................................................................. 134 10.4. AT+CGQMIN 服务质量参数（最低可接受的） .................................................................... 136 10.5. AT+CGEQREQ 3G 服务质量参数（请求的）...................................................................... 139 10.6. AT+CGEQMIN 3G 服务质量参数（最低可接受）................................................................ 143 10.7. AT+CGACT PDP 上下文激活/去激活 ................................................................................... 147 10.8. AT+CGDATA 进入数据传输状态........................................................................................... 148 10.9. AT+CGPADDR 显示 PDP 地址............................................................................................. 149 10.10. AT+CGCLASS GPRS 移动站点等级.................................................................................... 150 10.11. AT+CGREG PS 域网络注册状态.......................................................................................... 151 10.12. AT+CGEREP 分组域事件上报.............................................................................................. 152 10.13. AT+CGSMS 选择 MO 短消息服务........................................................................................ 154 10.14. AT+CEREG EPS 网络注册状态 ........................................................................................... 155 10.15. AT+QGDCNT 流量统计 ........................................................................................................ 156 10.16. AT+QAUGDCNT 自动保存流量统计 .................................................................................... 158 10.17. AT+QNETDEVCTL 连接 USB 网卡 ...................................................................................... 159 11 硬件相关命令...................................................................................................................................... 161 11.1. AT+QPOWD 关闭模块.......................................................................................................... 161 11.2. AT+CCLK 实时时钟 .............................................................................................................. 161 11.3. AT+QSCLK 禁用/启用睡眠模式............................................................................................ 162 12 附录 .................................................................................................................................................... 164 12.1. 术语缩写 .................................................................................................................................. 164 12.2. AT&F 影响到的 AT 命令及参数................................................................................................ 168 12.3. AT&W 影响到的 AT 命令及参数 .............................................................................................. 169 12.4. ATZ 影响到的 AT 命令及参数.................................................................................................. 170 12.5. CME ERROR 错误码汇总 ....................................................................................................... 171 12.6. CMS ERROR 错误码汇总 ....................................................................................................... 173 12.7. URC 汇总 ................................................................................................................................ 174 12.8. SMS 字符集转换...................................................................................................................... 177 12.9. AT+CEER 扩展错误报告列表.................................................................................................. 183 上海移远通信技术股份有限公司 7 / 189 LTE Standard(A)系列 AT 命令手册 表格索引 表 1：适用模块............................................................................................................................................. 9 表 2：AT 命令类型...................................................................................................................................... 10 表 3：AT&V 响应 ........................................................................................................................................ 19 表 4：ATV0&ATV1 结果代码数值等效项和简要说明 ................................................................................. 22 表 5：延迟类别......................................................................................................................................... 136 表 6：术语缩写......................................................................................................................................... 164 表 7：AT&F 影响到的 AT 命令及参数....................................................................................................... 168 表 8：AT&W 影响到的 AT 命令及参数 ..................................................................................................... 169 表 9：ATZ 影响到的 AT 命令及参数 ......................................................................................................... 170 表 10：+CME ERROR: 错误码描述 ................................................................................................ 171 表 11：+CMS ERROR: 错误码描述 ................................................................................................ 173 表 12：URC 汇总 ..................................................................................................................................... 174 表 13：SMS 文本输入和输出方式............................................................................................................ 177 表 14：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） ........................................................... 177 表 15：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） ........................................................... 178 表 16：GSM 扩展字符（GSM 编码）...................................................................................................... 179 表 17：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'）.............................................................. 179 表 18：IRA 扩展字符................................................................................................................................ 180 表 19：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'）.............................................................. 181 表 20：GSM 扩展字符（ISO-8859-1/Unicode） ..................................................................................... 182 表 21：AT+CEER 扩展错误报告列表....................................................................................................... 183 上海移远通信技术股份有限公司 8 / 189 LTE Standard(A)系列 AT 命令手册 1 引言 1.1. 本章概要 本文档介绍移远通信 LTE Standard(A)系列模块支持的 AT 命令集。 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200T 系列 EC200S 系列 EC200A 系列 EC200N-CN EC600S-CN EC600N-CN EC800N-CN EG912Y-EU EG915N-EU 上海移远通信技术股份有限公司 9 / 189 LTE Standard(A)系列 AT 命令手册 1.2. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.3. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了， 仅显示命令和响应。 模块实现的 AT 命令可以在语法上分为两类：基础类、S 参数类和扩展类，如下所列。 ⚫ 基础类 基础类 AT 命令的格式为 AT或 AT&，其中是命令，是该命令的参数。以 ATE为例，DCE 会根据的取值确定是否将接收到的字符回显给 DTE。若为可选参数， 则其被省略时将使用其默认值。 ⚫ S 参数类 此类 AT 命令格式有 ATS=，其中是 S 寄存器的索引，是赋予的参数值。 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 189 LTE Standard(A)系列 AT 命令手册 可以用分号（;）将多个命令放在同一行。此时只有第一个命令带有 AT 前缀。命令可以是大写或小写。 输入 AT 命令时，可以忽略空格。但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内； ⚫ 在 AT 命令名称中的 =、? 或 =? 内。 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.4. AT 命令响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或+CME ERROR: ，表示已经准备 好接收新命令。在返回最终的 OK，ERROR 或+CME ERROR: 之前，会发送请求的响应消息。 以下是响应消息的格式： +CMD1: OK 或者 OK 1.5. 支持的字符集 模块的 AT 命令接口默认使用 GSM 字符集，其支持的字符集如下： ⚫ GSM format ⚫ UCS2 ⚫ IRA 上海移远通信技术股份有限公司 11 / 189 LTE Standard(A)系列 AT 命令手册 可以使用 AT+CSCS（3GPP TS 27.007）来配置和查询字符集，并在 3GPP TS 27.005 中对其进行定 义。字符集会影响 SMS 和 SMS 广播消息的发送和接收，以及电话簿条目文本字段的输入和显示。 1.6. AT 命令端口 主串口端口和两个 USB 端口（USB MODEM 端口和 USB AT 端口）支持 AT 命令通信和数据传输。 1.7. 未经请求的结果码 作为未经请求的结果码和上报消息，URC 是由模块发出的报告消息，无需 TE 请求，并且在发生特定 事件时自动发布，而不会作为与已执行的 AT 命令相关的响应的一部分发出。导致 URC 上报的特定事件包 括来电（RING）、收到短消息、高/低压警报和高/低温警报等。 1.8. 关闭程序 通过执行 AT+QPOWD 来关闭模块是最安全方式，因此推荐使用此方法来关闭模块。通过让模块从网 络注销并允许软件在断开电源连接之前进入安全的数据状态来实现此过程。 发送 AT+QPOWD 后，请勿执行任何其他 AT 命令。成功执行命令后，模块将输出消息 POWERED DOWN，然后进入关机状态。为了避免数据丢失，建议在输出 URC POWERED DOWN 后等待 3 秒以断开 电源。若 65 秒后仍未收到 POWER DOWN，则必须强制断开电源。 1.9. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 12 / 189 LTE Standard(A)系列 AT 命令手册 2 通用命令 2.1. ATI 显示 MT 的 ID 信息 该命令用于提供 MT 的 ID 信息。 ATI 显示 MT 的 ID 信息 执行命令 ATI 最大响应时间 特性说明 参考 V.25ter 响应 Quectel Revision: OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 字符串类型。MT 固件版本的 ID 信息。 举例 ATI Quectel EC200TCN Revision: EC200TCNDAR01A01M1G OK 上海移远通信技术股份有限公司 13 / 189 LTE Standard(A)系列 AT 命令手册 2.2. AT+GMI 请求制造商信息 该命令与 AT+CGMI 的作用相同，用于返回制造商 ID 信息。 AT+GMI 请求制造商信息 测试命令 AT+GMI=? 执行命令 AT+GMI 响应 OK 响应 Quectel 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 2.3. AT+GMM 请求 TA 型号 ID 该命令与 AT+CGMM 的作用相同，用于返回 TA 型号 ID 信息。 AT+GMM 请求 TA 型号 ID 测试命令 AT+GMM=? 执行命令 AT+GMM 响应 OK 响应 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 上海移远通信技术股份有限公司 14 / 189 LTE Standard(A)系列 AT 命令手册 2.4. AT+GMR 请求 TA 固件版本 ID 该命令与 AT+CGMR 的作用相同，用于提供 TA 固件版本的 ID 信息。 AT+GMR 请求 TA 固件版本 ID 测试命令 AT+GMR=? 执行命令 AT+GMR 响应 OK 响应 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 参数 字符串类型。TA 固件版本的 ID 信息，包括行终止符，在信息文本中不得超过 2048 个 字符。 举例 AT+GMR EC200TCNDAR01A01M1G OK 2.5. AT+CGMI 请求制造商信息 该命令与 AT+GMI 的作用相同，用于返回制造商信息。 AT+CGMI 请求制造商信息 测试命令 AT+CGMI=? 执行命令 AT+CGMI 响应 OK 响应 Quectel OK 上海移远通信技术股份有限公司 15 / 189 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 / LTE Standard(A)系列 AT 命令手册 2.6. AT+CGMM 请求 TA 型号 ID 该命令与 AT+GMM 的作用相同，用于返回 TA 型号 ID 信息。 AT+CGMM 请求 TA 型号 ID 测试命令 AT+CGMM=? 执行命令 AT+CGMM 响应 OK 响应 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 2.7. AT+CGMR 请求 TA 固件版本 ID 该命令与 AT+GMR 的作用相同，用于提供 TA 固件版本 ID 信息。 AT+CGMR 请求 TA 固件版本 ID 测试命令 AT+CGMR=? 执行命令 AT+CGMR 响应 OK 响应 OK 上海移远通信技术股份有限公司 16 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 / 参数 字符串类型。产品固件版本的 ID 信息，包括行终止符，在信息文本中不得超过 2048 个 字符。 2.8. AT+GSN 请求国际移动设备识别码（IMEI 号） 该命令与 AT+CGSN 的作用相同，用于返回 ME 的国际移动设备识别码（IMEI 号），允许用户识别单 个 ME 设备。 AT+GSN 请求国际移动设备识别码（IMEI 号） 测试命令 响应 AT+GSN=? 执行命令 OK 响应 AT+GSN 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 参数 字符串类型。ME 的 IMEI 号。 备注 每台 ME 设备的序列号（IMEI 号）不同，因此可以用来识别 ME。 上海移远通信技术股份有限公司 17 / 189 LTE Standard(A)系列 AT 命令手册 2.9. AT+CGSN 请求国际移动设备识别码 该命令与 AT+GSN 的作用相同，用于返回 ME 的国际移动设备识别码（IMEI 号）。 AT+CGSN 请求国际移动设备识别码（IMEI 号） 测试命令 响应 AT+CGSN=? 执行命令 OK 响应 AT+CGSN 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 / 参数 字符串类型。ME 的 IMEI 号。 备注 每台 ME 设备的序列号（IMEI 号）不同，因此可以用来识别 ME。 2.10. AT&F 重置 AT 命令设置为出厂设置 该命令用于将 AT 命令设置重置为制造商指定的默认值（详情参考表 7）。 AT&F 重置 AT 命令设置为出厂设置 执行命令 响应 AT&F[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 上海移远通信技术股份有限公司 18 / 189 参数 LTE Standard(A)系列 AT 命令手册 整型。 0 将所有 AT 命令设置重置为出厂设置。 2.11. AT&V 显示当前配置 该命令用于显示一些 AT 命令参数的当前配置（详情参考表 3），包括不可读的单字母 AT 命令参数。 AT&V 显示当前配置 执行命令 AT&V 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 / 表 3：AT&V 响应 AT&V &C: 1 &D: 2 &F: 0 &W: 0 E: 1 Q: 0 V: 1 X: 4 Z: 0 S0: 0 S3: 13 S4: 10 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 OK 上海移远通信技术股份有限公司 19 / 189 LTE Standard(A)系列 AT 命令手册 2.12. AT&W 存储当前设置到用户自定义配置文件 该命令用于将当前的 AT 命令设置存储到 NVM 中的用户自定义配置文件中（详情参考表 8）。在上电或 执行 ATZ 时，将从用户自定义的配置文件中自动恢复 AT 命令设置。 AT&W 存储当前设置到用户定义配置文件 执行命令 响应 AT&W[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 参数 整型。 0 配置文件编号。用于存储当前的 AT 命令设置。 2.13. ATZ 从用户定义配置文件还原所有 AT 命令设置 该命令用于将 AT 命令设置重置为制造商的默认设置，与 AT&F 类似。若之前已将 AT 命令设置存储在 AT&W 中，则从 NVM 中的用户定义配置文件中还原 AT 命令设置（详情参考表 8）。 同一命令行的任何其他 AT 命令都可以忽略。 ATZ 从用户定义配置文件还原所有 AT 命令设置 执行命令 响应 ATZ[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 参数 整型。 0 重置配置文件编号为 0。 上海移远通信技术股份有限公司 20 / 189 LTE Standard(A)系列 AT 命令手册 2.14. ATQ 设置结果码回显模式 该命令用于控制是否将结果码发送到 TE，作为响应发送的其他信息不受影响。 ATQ 设置结果码回显模式 执行命令 ATQ 响应 若=0： OK 最大响应时间 特性说明 参考 V.25ter 若=1： （无） 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。 0 TA 发送结果码。 1 结果码被禁止而不发送。 2.15. ATV TA 响应格式 该命令用于确定与 AT 命令结果码和信息响应一起发送的首尾的内容。 表 4 列出了结果码，其数值等效项以及每种用法的简要说明。 ATV TA 响应格式 执行命令 ATV 响应 若=0： 0 最大响应时间 特性说明 若=1： OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 21 / 189 LTE Standard(A)系列 AT 命令手册 参考 V.25ter 参数 整型。 0 信息返回： 短结果码格式： 1 信息返回： 长结果码格式： 举例 ATV1 OK AT+CSQ +CSQ: 30,99 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //设置=1。 //当=1 时，结果码是 OK。 //设置=0。 //当=0 时，结果码是 0。 表 4：ATV0&ATV1 结果代码数值等效项和简要说明 ATV1 OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY NO ANSWER ATV0 0 1 2 3 4 6 7 8 描述 确认执行命令 已建立连接；DCE 正从命令模式转换为数据模式 DCE 已检测到来自网络的来电信号 连接已终止或尝试建立连接失败 无法识别命令，超过命令行最大字符长度，参数值无效或其 他处理命令行的问题 未检测到拨号音 检测到占线（忙音）信号 使用了 @（等待静默应答）拨号修饰符，连接计时器（S7） 上海移远通信技术股份有限公司 22 / 189 LTE Standard(A)系列 AT 命令手册 计时结束前，未检测到远程振铃后的五秒静音。 2.16. ATE 设置命令回显模式 该命令用于控制 TA 是否在 AT 命令模式下回显从 TE 接收的字符。 ATE 设置命令回显模式 执行命令 ATE 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。是否回显从 TE 收到的字符。 0 关闭 1 开启 2.17. ATS3 设置命令行终止符 该命令用于确定 TA 识别的字符以终止输入的命令行。同时生成结果代码和信息文本以及通过 ATS4 设 置的字符值。 ATS3 设置命令行终止符 查询命令 响应 ATS3? 设置命令 ATS3= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 / 上海移远通信技术股份有限公司 23 / 189 LTE Standard(A)系列 AT 命令手册 参数 整型。命令行终止符。范围：0~127。（默认值 13=）。 2.18. ATS4 设置响应格式字符 该命令用于确定 TA 为结果代码和信息文本生成的字符，以及通过 ATS3 设置的命令行终止字符。 ATS4 设置响应格式字符 查询命令 响应 ATS4? 设置命令 ATS4= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 / 参数 整型。响应格式字符。范围：0~127。（默认值 10=）。 2.19. ATS5 设置命令行编辑字符 该命令用于确定 TA 用来从 AT 命令行删除紧接前一个字符的编辑字符值（等同于退格键）。 ATS5 设置命令行编辑字符 查询命令 响应 ATS5? 设置命令 ATS5= 最大响应时间 OK 响应 OK 300 毫秒 上海移远通信技术股份有限公司 24 / 189 LTE Standard(A)系列 AT 命令手册 特性说明 / 参考 V.25ter 参数 整型。响应编辑字符。范围：0~127。（默认值 8=）。 2.20. ATX 设置 CONNECT 结果码格式和检测呼叫进程 该命令用于确定 TA 是否将特定的结果代码发送到 TE。它还控制 TA 在开始拨号时是否检测拨号音和 占线（忙音）信号。 ATX 设置 CONNECT 结果码格式和检测呼叫进程 执行命令 响应 ATX OK 最大响应时间 300 毫秒 特性说明 参考 该命令立即生效； 执行 AT&W 后将保存参数配置。 V.25ter 参数 整型。 0 仅返回 CONNECT 结果码，拨号音和忙音检测均禁用。 1 仅返回 CONNECT 结果码，拨号音和忙音检测均禁用。 2 返回 CONNECT 结果码，禁用忙音检测，启用拨号音检测。 3 返回 CONNECT 结果码，禁用拨号音检测，启用忙音检测。 4 返回 CONNECT 结果码，拨号音和忙音检测均启用。 上海移远通信技术股份有限公司 25 / 189 LTE Standard(A)系列 AT 命令手册 2.21. AT+CFUN 设置功能模式 此命令用于控制功能模式，同时还可以用于重置 UE。 AT+CFUN 设置功能模式 测试命令 AT+CFUN=? 响应 +CFUN: (支持的范围),(支持的列表) 查询命令 AT+CFUN? OK 响应 +CFUN: 设置命令 AT+CFUN=[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现任何错误与 ME 相关： +CME ERROR: 15 秒，取决于网络状态 / 参数 整型。功能模式。 0 最小功能模式 1 全功能模式 3 禁用 ME 接收射频信号 4 禁用 ME 发送和接收射频信号功能 5 禁用(U)SIM 整型。 0 设置为功能模式前，不触发复位。（省略时的默认设置） 1 触发复位。复位后，该设备可以正常使用。该值仅适用于=1。 错误码。参考第 12.5 章。 举例 AT+CFUN=0 OK AT+COPS? +COPS: 0 //设置 UE 为最小功能模式。 //无网络。 上海移远通信技术股份有限公司 26 / 189 LTE Standard(A)系列 AT 命令手册 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN=1234 OK +CPIN: READY +QUSIM: 1 +QIND: PB DONE +QIND: SMS DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE',7 OK //(U)SIM 卡读取失败。 //设置 UE 为全功能模式。 //注册上网络。 2.22. AT+CMEE 设置错误讯息格式 该命令用于设置错误结果码的格式：ERROR、错误编号或详细消息，如+CME ERROR: 和 +CMS ERROR: 。 AT+CMEE 设置错误讯息格式 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) 查询命令 AT+CMEE? OK 响应 +CMEE: OK 上海移远通信技术股份有限公司 27 / 189 LTE Standard(A)系列 AT 命令手册 设置命令 AT+CMEE= 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 OK 300 毫秒 / 参数 整型。 0 禁用结果码。 1 启用结果码，使用数值型取值。 2 启用结果码，使用字符型取值。 举例 AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted //禁用结果码。 //仅显示 ERROR。 //启用数值型结果错误码。 //启用具有详细（字符串）值的错误结果码。 2.23. AT+CSCS 选择 TE 字符集 该设置命令用于把 TE 使用的字符集报给 UE，以使 UE 能够在 TE 和 UE 的字符集之间正确转换字符 串。 AT+CSCS 选择 TE 字符集 测试命令 AT+CSCS=? 响应 +CSCS: (支持的列表) 查询命令 OK 响应 上海移远通信技术股份有限公司 28 / 189 LTE Standard(A)系列 AT 命令手册 AT+CSCS? 设置命令 AT+CSCS= 最大响应时间 特性说明 参考 3GPP TS 27.007 +CSCS: OK 响应 OK 300 毫秒 / 参数 字符串类型。 'GSM' GSM 默认字符集 'IRA' 国际参考字符集 'UCS2' UCS2 字符集 举例 AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //查询当前字符集。 //字符集为 GSM。 //设置字符集为 UCS2。 //配置后，查询字符集为 UCS2。 2.24. AT+QURCCFG 配置 URC 指示选项 该命令用于配置 URC 的输出端口。 AT+QURCCFG 测试命令 AT+QURCCFG=? 配置 URC 指示选项 响应 +QURCCFG: 'urcport',(支持的列表) 设置命令 OK 响应 上海移远通信技术股份有限公司 29 / 189 LTE Standard(A)系列 AT 命令手册 AT+QURCCFG='urcport'[,] +QURCCFG: 'urcport', OK 最大响应时间 特性说明 若指定可选参数，则配置 URC 的输出端口： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。设置 URC 的输出端口。 'usbat' USB AT 端口 'usbmodem' USB 调制解调器端口 'uart1' 主串口 举例 AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' OK AT+QURCCFG='urcport','usbmodem' OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' OK 上海移远通信技术股份有限公司 30 / 189 LTE Standard(A)系列 AT 命令手册 2.25. AT+QPPPDROP 终止 PPP 连接 该命令用于终止 PPP 连接。 AT+QPPPDROP 终止 PPP 连接 测试命令 AT+QPPPDROP=? 响应 +QPPPDROP: (支持的范围) 设置命令 AT+QPPPDROP[=] 最大响应时间 特性说明 OK 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。断开 PPP 连接的操作。 0 断开 PPP 连接，不向对端发送 TERM REQ 帧。 1 断开 PPP 连接并自动向对端发送 TERM REQ 帧。 2 通过向对端发送 TERM REQ 帧来断开 PPP 连接。 备注 1. 该命令立即返回 OK，然后执行以下步骤： 步骤 1：检查 PPP 链路是否存在。若存在，则执行步骤 2。 步骤 2：断开 PPP 连接，从拨号端口输出 NO CARRIER。 2. 若为 1，则仅在存在 PPP 连接且拨号端口处于数据模式时向对端发送 TERM REQ 帧。 3. 若省略，断开连接的过程与设置为 1 时相同。 举例 AT+QPPPDROP //从 USB_AT 端口发送命令 OK //从 USB_AT 端口接收结果 //MCU 的拨号端口接收模块的 TERM REQ 帧 7E FF 7D 23 C0 21 7D 25 7D 25 7D 20 7D 24 5C A4 7E NO CARRIER //PPP 连接已终止并从拨号端口输出该 URC。若设置了 ATV0，模块输出 NO CARRIER 作为数字格式（3）。 上海移远通信技术股份有限公司 31 / 189 LTE Standard(A)系列 AT 命令手册 3 串口控制命令 3.1. AT&C 设置 DCD 信号模式 该命令用于设置 DCD 信号模式，与检测远端的线路信号有关。 AT&C 设置 DCD 信号模式 执行命令 AT&C[] 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。确定 DCD 信号如何与检测到的远端线路信号相关联。 0 DCD 信号一直保持开启 1 仅检测到网络侧的载波信号时，DCD 信号保持开启。 3.2. AT&D 设置 DTR 信号模式 该命令用于设置在端口处于数据模式时，DTR 信号从低电平转变至高电平后 UE 对应的状态。 AT&D 设置 DTR 信号模式 执行命令 AT&D[] 最大响应时间 特性说明 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 32 / 189 LTE Standard(A)系列 AT 命令手册 参考 V.25ter 参数 整型。 0 TA 忽略 DTR 引脚信号变化。 1 DTR 由低电平上拉至高电平：保持呼叫连接并切换为命令模式。 2 DTR 由低电平上拉至高电平：断开数据连接并切换为命令模式。当 DTR 处于高电平时， 禁用自动应答功能。 3.3. AT+IFC 设置串口的流控方式 该命令用于设置串口通信的流控方式。 AT+IFC 设置串口的流控方式 测试命令 AT+IFC=? 响应 +IFC: (支持的列表),(支持的列 表) 查询命令 AT+IFC? OK 响应 +IFC: , 设置命令 AT+IFC=, 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。指定 TE 从 TA 接收数据时的流控行为。 0 无 2 RTS 流控 上海移远通信技术股份有限公司 33 / 189 LTE Standard(A)系列 AT 命令手册 整型。指定 TA 从 TE 接收数据时的流控行为。 0 无 2 CTS 流控 备注 1. AT+IFC的值可以用AT&F、ATZ和AT&W恢复。 2. 和的值必须相同。 举例 AT+IFC=2,2 OK AT+IFC? +IFC: 2,2 OK //打开硬件流控 3.4. AT+IPR 设置固定的串口通信波特率 该命令用于查询和设置串口的波特率。默认波特率值（）为 115200 bps。的设置不会被 AT&F 恢复。 AT+IPR 设置固定的串口通信波特率 测试命令 AT+IPR=? 响应 +IPR: (自动检测的列表),(支持固定的列表) 查询命令 AT+IPR? OK 响应 +IPR: 设置命令 AT+IPR= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 34 / 189 LTE Standard(A)系列 AT 命令手册 参数 整型。每秒的波特率。单位：bps。 4800 9600 19200 38400 57600 115200 230400 460800 921600 备注 1. 若设置固定的波特率，请确保 TE（DTE，通常为外部处理器）和 TA（DCE，移远通信模块）设置了 相同的波特率。 2. AT+IPR的值不可以用AT&F，ATZ和AT&W恢复。 3. 设置命令执行并返回 OK 后，波特率设置生效。 举例 AT+IPR=115200 OK AT&W OK AT+IPR? +IPR: 115200 OK AT+IPR=115200;&W OK //设置固定波特率为 115200 bps //保存当前配置，模块重启后，串口通信速率仍为 115200 bps。 //固定波特率为 115200 bps 并保存当前配置。 上海移远通信技术股份有限公司 35 / 189 LTE Standard(A)系列 AT 命令手册 4 状态控制命令 4.1. AT+CPAS 查询 ME 活动状态 该命令用于查询 ME 的活动状态。 AT+CPAS 查询 ME 活动状态 测试命令 AT+CPAS=? 响应 +CPAS: (支持的列表) 执行命令 AT+CPAS OK 响应 TA 返回 MT 的活动状态： +CPAS: OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现任何错误与 ME 相关： +CME ERROR: 300 毫秒 / 参数 整型。 0 就绪 2 未知 3 响铃 4/6 呼叫进行中或保持通话 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 36 / 189 举例 AT+CPAS +CPAS: 0 OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129 OK AT+CPAS +CPAS: 4 OK //处于就绪状态 //正在响铃 //呼叫中 LTE Standard(A)系列 AT 命令手册 4.2. AT+CEER 上报扩展错误 该命令用于查询扩展错误并上报上次操作失败的原因，例如： ⚫ 拨打电话失败 ⚫ 通话失败（无论手机作为主叫或被叫） ⚫ 无法通过补充业务修改呼叫 ⚫ 无法激活、注册、查询、停用或注销补充业务 ⚫ 无法附着 GPRS 或激活 PDP 上下文 ⚫ 无法去附着 GPRS 或去激活 PDP 上下文 AT+CEER 上报拓展错误 测试命令 AT+CEER=? 执行命令 AT+CEER 响应 OK 响应 +CEER: OK 或者 上海移远通信技术股份有限公司 37 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 ERROR 若出现任何错误与 ME 相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。网络下发失败原因信息。上次拨打电话或通话失败的原因（详情参考 第 12.9 章）。上报 CS 和 PS 域呼叫类型。原因数据是从呼叫管理事件中获取的，并在 本地缓存以供此命令以后使用。 错误码。参考第 12.5 章。 4.3. AT+QCFG 扩展命令 该命令用于查询和配置 UE 的多种设置。 AT+QCFG 扩展命令 测试命令 AT+QCFG=? 响应 +QCFG: 'gprsattach',(支持的列表),(支持 的列表) +QCFG: 'nwscanmode',(支持的范围) +QCFG: 'nwscanseq',(支持的范围) +QCFG: 'roamservice',(支持的列表),(支持 的列表) +QCFG: 'servicedomain',(支持的范围),(支持的 列表) +QCFG: 'band',( 支 持 的 列 表 ),( 支 持 的 列表) +QCFG: 'urc/ri/other',( 支 持 的 列 表 ),( 支 持 的 范围),(支持的范围) +QCFG: 'urcdelay',(支持的范围) +QCFG: 'urc/cache',(支持的列表) +QCFG: 'usbnet',(支持的列表) +QCFG: 'ppp/termframe',(支持的列表) +QCFG: 'airplanecontrol',(支持的列表) +QCFG: 'urc/ri/ring',( 支 持 的 列 表 ),( 支 持 的 范围),(支持的范围) +QCFG: 'risignaltype',(支持的列表) 上海移远通信技术股份有限公司 38 / 189 最大响应时间 LTE Standard(A)系列 AT 命令手册 +QCFG: 'uart2ipr',(支持的列表) +QCFG: 'nat',(支持的列表) 300 毫秒 4.3.1. AT+QCFG='gprsattach' 配置 GPRS 附着模式 该命令用于指定 UE 开机时的 GPRS 附着模式。 AT+QCFG='gprsattach' 配置 GPRS 附着模式 设置命令 AT+QCFG='gprsattach'[,[,]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'gprsattach',, OK 若指定任意可选参数，则配置 GPRS 附着模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。UE 开机时的 GPRS 附着模式。 0 手动附着 1 自动附着 整型。命令生效方式。 0 UE 重启后生效（暂不支持） 1 立即生效 错误码。参考第 12.5 章。 备注 该配置会影响模块支持的网络制式。例如，如果当前的网络制式中包含 LTE 网络制式，当 设置为 0 时，LTE 网络制式将被移除；当设置为 1 时，模块将恢复 LTE 网络制式。 上海移远通信技术股份有限公司 39 / 189 LTE Standard(A)系列 AT 命令手册 4.3.2. AT+QCFG='nwscanmode' 配置网络搜索模式 该命令用于指定待搜索的网络制式。 AT+QCFG='nwscanmode' 配置网络搜索模式 设置命令 响应 AT+QCFG='nwscanmode'[,] +QCFG: 'nwscanmode', OK 若指定可选参数，则配置网络搜索模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。网络搜索模式。 0 自动（LTE/WCDMA/GSM） 1 仅 GSM 2 仅 WCDMA 3 仅 LTE 错误码。参考第 12.5 章。 备注 若配置的网络搜索模式与模块当前配置不符，该命令将返回错误信息。例如，当网络搜索模式为仅 LTE 时，若模块服务域配置为仅限 CS 域，则该命令返回错误信息。 上海移远通信技术股份有限公司 40 / 189 LTE Standard(A)系列 AT 命令手册 4.3.3. AT+QCFG='nwscanseq' 配置网络搜索顺序 该命令用于指定网络搜索顺序。 AT+QCFG='nwscanseq' 配置网络搜索顺序 设置命令 响应 AT+QCFG='nwscanseq'[,] 若省略可选参数，则查询当前配置： +QCFG: 'nwscanseq', OK 若指定可选参数，则配置网络搜索顺序： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。网络搜索顺序。 0 自动（LTE/WCDMA/GSM） 1 仅 GSM 2 仅 WCDMA 3 仅 LTE 4 GSM/WCDMA/LTE 5 WCDMA/GSM/LTE 6 LTE/WCDMA 7 LTE/GSM 8 WCDMA/LTE 9 WCDMA/GSM 10 GSM/LTE 11 GSM/WCDMA 12 LTE/WCDMA/GSM 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 41 / 189 LTE Standard(A)系列 AT 命令手册 备注 1. 若网络搜索模式改变，该命令立即生效；否则该命令仅在模块重启后生效。 2. 若网络搜索模式与模块当前配置不符，该命令将返回错误信息。例如，当网络搜索模式为仅 LTE 时， 若模块服务域配置为仅限 CS 域，则该命令返回错误信息。 4.3.4. AT+QCFG='roamservice' 配置漫游服务 该命令启用或禁用漫游服务。 AT+QCFG='roamservice' 配置漫游服务 设置命令 AT+QCFG='roamservice'[,[,]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'roamservice',, OK 若指定可选参数，则配置漫游服务模式： 最大响应时间 特性说明 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。漫游服务模式。 1 禁用漫游服务 2 启用漫游服务 255 自动 整型。命令生效方式。 0 UE 重启后生效（暂不支持） 1 立即生效 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 42 / 189 LTE Standard(A)系列 AT 命令手册 4.3.5. AT+QCFG='servicedomain' 配置服务域 该命令用于指定已注册的服务域。 AT+QCFG='servicedomain' 配置服务域 设置命令 响应 AT+QCFG='servicedomain'[,[,]] +QCFG: 'servicedomain',, OK 若指定任意可选参数，则配置 UE 的服务域： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。UE 的服务域。 0 仅限 CS 域 1 仅限 PS 域 2 CS 域和 PS 域共存 整型。命令生效方式。 0 UE 重启后生效（暂不支持） 1 立即生效 错误码。参考第 12.5 章。 备注 该配置会影响模块支持的网络制式。例如，如果当前的网络制式中包含 LTE 网络制式，当模块的服务域 设置为仅限 CS 域时，LTE 网络制式将被移除；当模块的服务域设置为'仅限 PS 域'或'CS 域和 PS 域共存'时，模块将恢复 LTE 网络制式。 上海移远通信技术股份有限公司 43 / 189 LTE Standard(A)系列 AT 命令手册 4.3.6. AT+QCFG='band' 配置频段 该命令用于指定 UE 优先搜索的频段。 AT+QCFG='band' 配置频段 设置命令 AT+QCFG='band'[,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'band',, OK 若指定可选参数，则配置优先搜索的频段： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 十六进制数字。该值指定 GSM 和 WCDMA 的频段。若设置为 0，则表示不改变 GSM 和 WCDMA 的频段。例如：00000013 = 00000001 (GSM900) + 00000002 (GSM1800) + 00000010 (WCDMA 2100)。 00000000 不改变 00000001 GSM900 00000002 GSM1800 00000010 WCDMA 2100 00000020 WCDMA 1900 00000040 WCDMA 850 00000080 WCDMA 900 0000FFFF 全频段 十六进制数字。该值指定 LTE 的频段。若设置为 0，则表示不改变 LTE 的频段。例如： 0x15 = 0x1 (LTE B1) + 0x4 (LTE B3) + 0x10 (LTE B5)。 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x40 (CM_BAND_PREF_LTE_EUTRAN_BAND7) LTE B7 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 0x200000000(CM_BAND_PREF_LTE_EUTRAN_BAND34) LTE B34 上海移远通信技术股份有限公司 44 / 189 LTE Standard(A)系列 AT 命令手册 0x2000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND38) 0x4000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND39) 0x8000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND40) 0x10000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND41) 0x800000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND72) 0x7FFFFFFFFFFFFFFF (CM_BAND_PREF_ANY) 错误码。参考第 12.5 章。 LTE B38 LTE B39 LTE B40 LTE B41 LTE B72 全频段 备注 若模块不支持当前设置的频段，该命令返回错误信息。 4.3.7. AT+QCFG='urc/ri/other' 设置其他 URC 上报时的 RI 行为 该命令用于设置其他 URC 上报时的 RI（振铃指示器）行为。 AT+QCFG='urc/ri/other' 设置其他 URC 上报时的 RI 行为 设置命令 AT+QCFG='urc/ri/other'[,[,< pulse_duration>[,]]] 响应 若省略可选参数，则查询当前配置： +QCFG:'urc/ri/other',,, OK 若指定任意可选参数，则配置其他 URC 上报时的 RI 行为： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。URC 上报时的 RI 行为。 'off' 无变化，RI 保持关闭状态。 'pulse' 脉冲，脉冲宽度由指定。 整型。脉冲宽度。仅当配置为'pulse'时有效。范围：5~2000；默认值： 上海移远通信技术股份有限公司 45 / 189 LTE Standard(A)系列 AT 命令手册 120；单位：毫秒。 整型。脉冲个数。仅当配置为'pulse'时有效。相邻两个脉冲之间的时间 间隔为。范围：1~5；默认值：1；单位：秒。 错误码。参考第 12.5 章。 4.3.8. AT+QCFG='urcdelay' 设置 URC 延迟时间 该命令用于设置自 RI 脉冲开始时起的 URC 延迟时间。 AT+QCFG='urcdelay' 设置 URC 延迟时间 设置命令 AT+QCFG='urcdelay'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'urcdelay', OK 若指定可选参数，则设置 URC 输出时间： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。自 RI 脉冲开始时起的 URC 延迟时间。范围：0~120；单位：秒。 0 无延迟 错误码。参考第 12.5 章。 4.3.9. AT+QCFG='urc/cache' 打开/关闭 URC 缓存 该命令用于打开或关闭 URC 缓存功能。 AT+QCFG='urc/cache' 打开/关闭 URC 缓存 设置命令 AT+QCFG='urc/cache'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'urc/cache', 上海移远通信技术股份有限公司 46 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 OK 若指定可选参数，则打开或关闭 URC 缓存功能： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。 0 关闭 URC 缓存 1 打开 URC 缓存 错误码。参考第 12.5 章。 举例 AT+QCFG='urc/cache' +QCFG: 'urc/cache',0 //URC 缓存功能关闭 OK AT+QCFG='urc/cache',1 OK AT+QCFG='urc/cache' +QCFG: 'urc/cache',1 //打开 URC 缓存 OK //呼叫并发送 2 条信息至模块 AT+QCFG='urc/cache',0 OK //关闭 URC 缓存 RING //输出缓存的 URC NO CARRIER //输出缓存的 URC +CMTI: 'ME',0 //输出缓存的 URC 上海移远通信技术股份有限公司 47 / 189 LTE Standard(A)系列 AT 命令手册 +CMTI: 'ME',1 AT+QCFG='urc/cache' +QCFG: 'urc/cache',0 OK //输出缓存的 URC //URC 缓存功能关闭 备注 EC200A 系列模块暂不支持该命令。 4.3.10. AT+QCFG='usbnet' 配置网卡接口 该命令用于配置配置网卡接口。 AT+QCFG ='usbnet' 配置网卡接口 设置命令 AT+QCFG='usbnet'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'usbnet', OK 若指定可选参数，则配置配置网卡接口： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。网络接口使用的协议。 1 ECM 接口协议 3 RNIDS 接口协议 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 48 / 189 LTE Standard(A)系列 AT 命令手册 4.3.11. AT+QCFG='ppp/termframe' 启用/禁用 PPP TERM 帧发送功能 该命令用于启用或禁用模块自行挂断 PPP 时的 PPP TERM 帧发送功能。 AT+QCFG='ppp/termframe' 启用/禁用 PPP TERM 帧发送功能 设置命令 AT+QCFG='ppp/termframe'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'ppp/termframe', 最大响应时间 特性说明 OK 若指定可选参数，则启用或禁用 PPP TERM 帧发送 功能： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。启用或禁用模块自行挂断 PPP 时的 PPP TERM 帧发送功能。 0 禁用 1 启用 错误码。参考第 12.5 章。 备注 若通过 AT+QPPPDROP 挂断带有 TERM 帧的 PPP，无论设置为 0 或 1，模块都将发送 TERM 帧 至 MCU。 举例 AT+QCFG='ppp/termframe',1 OK AT+QCFG='ppp/termframe' +QCFG: 'ppp/termframe',1 OK 上海移远通信技术股份有限公司 49 / 189 LTE Standard(A)系列 AT 命令手册 4.3.12. AT+QCFG='airplanecontrol' 启用/禁用通过 W_DISABLE#控制飞行模式 该命令用于启用或禁用通过 W_DISABLE#控制飞行模式。 AT+QCFG='airplanecontrol' 启用/禁用通过 W_DISABLE#控制飞行模式 设置命令 响应 AT+QCFG='airplanecontrol'[,] 若省略可选参数，则查询当前配置： +QCFG: 'airplanecontrol',, OK 若指定可选参数，则配置是否启用通过W_DISABLE#引脚控 制飞行模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用通过W_DISABLE#引脚控制飞行模式。 0 禁用通过W_DISABLE#引脚控制飞行模式。 1 启用通过W_DISABLE#引脚控制飞行模式。当W_DISABLE#引脚处于激活状态时，模 块进入飞行模式；当W_DISABLE#引脚处于未激活状态时，模块退出飞行模式。当 W_DISABLE#引脚处于激活状态时，禁止通过AT+CFUN=1使模块退出飞行模式。当 W_DISABLE# 引脚状态改变时，会上报URC +QIND: airplanestatus,。 整型。 0 退出飞行模式。 1 进入飞行模式。 错误码。参考第12.5章。 备注 1. W_DISABLE#引脚默认为拉高状态，可通过拉低电平激活该引脚。 2. 关于 W_DISABLE#引脚的更多信息，可参考相应模块的硬件设计。 上海移远通信技术股份有限公司 50 / 189 LTE Standard(A)系列 AT 命令手册 举例 AT+QCFG='airplanecontrol' +QCFG: 'airplanecontrol',0,0 //禁用通过 W_DISABLE#引脚控制飞行模式。 OK //激活 W_DISABLE#引脚。 AT+QCFG='airplanecontrol',1 OK //启用通过 W_DISABLE#引脚控制飞行模式。 +QIND: airplanestatus,1 AT+CFUN? +CFUN: 4 //由于 W_DISABLE#引脚被激活，进入飞行模式。 //处于飞行模式。 OK //去激活 W_DISABLE#引脚。 +QIND: airplanestatus,0 AT+CFUN? +CFUN: 1 //退出飞行模式。 //处于正常模式。 OK //重启 modem AT+QCFG='airplanecontrol' +QCFG: 'ariplanecontrol',1,0 //设置重启后生效。 OK //激活 W_DISABLE#引脚。 +QIND: airplanestatus,1 AT+CFUN? +CFUN: 4 //进入飞行模式。 //处于飞行模式。 OK 上海移远通信技术股份有限公司 51 / 189 LTE Standard(A)系列 AT 命令手册 4.3.13. AT+QCFG='urc/ri/ring' 设置来电 URC 上报时的 RI 行为 该命令用于设置来电 URC 上报时的 RI（振铃指示器）行为。 AT+QCFG='urc/ri/ring' 设置来电 URC 上报时的 RI 行为 设置命令 AT+QCFG='urc/ri/ring'[,[,[,]]] 响应 若省略可选参数，则查询当前配置： +QCFG:'urc/ri/ring',,, OK 若指定任意可选参数，则设置来电 URC 上报时的 RI 行为： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。来电 URC 上报时的 RI 行为。 'off' 无变化，RI 保持关闭状态。 'pulse' 脉冲，脉冲宽度由指定。 整型。脉冲宽度。仅当设置为'pulse'时有效。如无需该参数，可设置为空。 范围：5~2000；默认值：120；单位：毫秒。 整型。脉冲个数。仅当设置为'pulse'时有效。相邻两个脉冲之间的时间间 隔为。范围：1~5；默认值：1。 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 52 / 189 LTE Standard(A)系列 AT 命令手册 4.3.14. AT+QCFG='risignaltype' RI 信号输出载体 该命令用于指定 RI（振铃指示器）信号输出载体。 AT+QCFG='risignaltype' RI 信号输出载体 设置命令 响应 AT+QCFG='risignaltype',[] +QCFG: 'risignaltype', OK 若指定可选参数，则配置 RI 信号输出载体： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。RI 信号输出载体。 'respective' 振铃指示输出端口。 例如，若当前使用 UART 口，RI 引脚会同时产生振铃跳变。若 使用其他 USB 端口，RI 引脚不会有实际电平变化。若 URC 在 不支持振铃指示的 USB AT 端口输出，则没有振铃指示。 AT+QURCCFG='urcport'可以获取显示 URC 的输出端口。 'physical' 无论在哪个端口上报 URC，RI 引脚都会发生振铃跳变。 错误码。参考第 12.5 章。 举例 AT+QCFG='risignaltype' +QCFG: 'risignaltype','respective' OK AT+QCFG='risignaltype','physical' OK AT+QCFG='risignaltype' +QCFG: 'risignaltype','physical' 上海移远通信技术股份有限公司 53 / 189 LTE Standard(A)系列 AT 命令手册 OK 4.3.15. AT+QCFG=''uart2ipr'' 配置波特率 该命令用于配置 UART2 的波特率。 AT+QCFG=''uart2ipr'' 配置波特率 设置命令 AT+QCFG='uart2ipr'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'uart2ipr', OK 若指定可选参数，则配置 UART2 的波特率： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。UART2 的波特率。 4800 9600 19200 38400 57600 115200 230400 460800 921600 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 54 / 189 LTE Standard(A)系列 AT 命令手册 4.3.16. AT+QCFG='nat' 配置网卡工作模式 该命令用于配置网卡工作模式。 AT+QCFG='nat' 配置网卡工作模式 设置命令 AT+QCFG='nat'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'nat', OK 若指定可选参数，则配置网卡工作模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。网卡的工作模式。 0 路由模式 1 网卡模式 错误码。参考第 12.5 章。 举例 AT+QCFG='nat',1 OK //配置当前网卡工作模式为网卡模式 上海移远通信技术股份有限公司 55 / 189 LTE Standard(A)系列 AT 命令手册 4.4. AT+QINDCFG 控制 URC 上报 该命令用于控制 URC 上报。 AT+QINDCFG 控制 URC 上报 测试命令 AT+QINDCFG=? 响应 +QINDCFG: (支持的 列表),(支持的列 表),(支持的列表) 设置命令 AT+QINDCFG=[,[,< savetonvram>]] OK 响应 若省略可选参数，则查询当前配置： +QINDCFG: , OK 若指定可选参数，则配置 URC 上报： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置是否保存取决于。 参数 整型。URC 类型。 'all' 是否上报所有类型的 URC。默认打开。 'csq' 信号强度和信道误码率变化指示（类似 AT+CSQ）。默认关闭。若配置 为打开，将上报 URC：+QIND: 'csq',, 'datastatus' 数据服务状态指示。默认关闭。若配置为打开，将上报 URC： +QIND: 'datastatus',, 是整型。取值如下： 0 SUSPEND_NO_CAUSE 1 SUSPEND_BY_RAU_ATTACH 2 SUSPEND_BY_LAU 3 SUSPEND_BY_TAU 4 SUSPEND_BY_CS_SERVICE 5 SUSPEND_BY_DS_OPERATION 上海移远通信技术股份有限公司 56 / 189 LTE Standard(A)系列 AT 命令手册 'mode' 'smsfull' 'smsincoming' 'act' 'sqi' 6 SUSPEND_BY_POWERUP 网络主模式和子模式指示。默认关闭。若配置为打开，将上报 URC： ^MODE:, 是整型。取值如下： 0 SYSINFO_SYSTEMO_MODE_NO_SERVICE 1 SYSINFO_SYSTEMO_MODE_RESERVED_1 2 SYSINFO_SYSTEMO_MODE_RESERVED_2 3 SYSINFO_SYSTEMO_MODE_GSM_GPRS 5 SYSINFO_SYSTEMO_MODE_WCDMA 17 SYSINFO_SYSTEMO_MODE_LTE 是整型。取值如下： 0 SYSINFO_SYSTEMO_SUBMODE_NO_SERVICE 1 SYSINFO_SYSTEMO_SUBMODE_GSM 3 SYSINFO_SYSTEMO_SUBMODE_GSM_EGPRS 5 SYSINFO_SYSTEMO_SUBMODE_UTRAN_HSDPA 6 SYSINFO_SYSTEMO_SUBMODE_UTRAN_HSUPA 7 SYSINFO_SYSTEMO_SUBMODE_UTRAN_HSPA 8 SYSINFO_SYSTEMO_SUBMODE_UTRAN 17 SYSINFO_SYSTEMO_SUBMODE_EUTRAN 短消息存储已满指示。默认关闭。若配置为打开，将上报 URC： +QIND: 'smsfull', 新消息指示。默认打开。相关 URC 为： +CMTI、+CMT、+CDS 网络制式变化。默认关闭。如果配置为打开，则将上报 URC： +QIND: 'act', 是字符串类型。取值如下： ''GSM'' ''EGPRS'' ''WCDMA'' ''HSDPA'' ''HSUPA'' ''HSDPA&HSUPA'' ''LTE'' ''UNKNOWN'' URC 的示例如下： +QIND: 'act','HSDPA&HSUPA' +QIND: 'act','UNKNOWN' 'act'的描述如下： 1. 若模块未注册网络，则为'UNKNOWN'。 2. 如果配置为打开，则将立即上报'act'的 URC。仅当网络制式发 生变化时，才会上报新的 URC。 参考信号接收功率、参考接收质量和信号与干扰加噪声比变化指示（默认 关闭）。若配置为打开，将上报 URC： +QIND: 'SQI',,, 上海移远通信技术股份有限公司 57 / 189 LTE Standard(A)系列 AT 命令手册 整型。参考信号接收功率。单位：dBm。（参考 3GPP 36.214 第 5.1.1 章） 整 型 。 参 考 接 收 质 量 。 单 位 ： dB 。 （参考 3GPP 36.214 第 5.1.3 章） 整型。信号与干扰加噪声比。范围：-20~30；单位：dB。 'phonebook' 传入电话本指示（默认打开）。相关 URC 为：+QIND: PB DONE 'ring' 来电指示（默认打开）。相关 URC 为：RING 'nocarrier' 来电挂机指示（默认打开）。相关 URC 为：NO CARRIER 整型。打开/关闭指定 URC 的上报。 0 关闭 1 打开 整型。是否将参数配置保存至 NVM。 0 不保存 1 保存 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 58 / 189 LTE Standard(A)系列 AT 命令手册 5 (U)SIM 卡相关命令 5.1. AT+CIMI 查询 IMSI 该命令用于查询(U)SIM 卡的国际移动用户识别码（IMSI），IMSI 允许 TE 识别 MT 中的(U)SIM 卡或 UICC （GSM 或者(U)SIM）中的活动应用程序。 AT+CIMI 查询 IMSI 测试命令 AT+CIMI=? 执行命令 AT+CIMI 响应 OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。国际移动用户识别码（无双引号的字符串）。 错误码。参考第 12.5 章。 举例 AT+CIMI 460023210226023 OK //查询 ME 中的(U)SIM 卡的 IMSI。 上海移远通信技术股份有限公司 59 / 189 LTE Standard(A)系列 AT 命令手册 5.2. AT+CLCK 功能锁定 该命令用于锁定、解锁 MT 或者网络功能，以及查询锁定状态。当正在设置或查询网络功能时，可中 止该命令。该命令一般需要用到密码。当查询网络服务状态（为 2）时，若所有类型的服 务状态未激活，则命令响应行应返回未激活的情况。PF、PN、PU、PP 和 PC 锁的默认密钥为'12341234'。 AT+CLCK 功能锁定 测试命令 AT+CLCK=? 响应 +CLCK: (支持的列表) 设置命令 AT+CLCK=,[,[ ,]] OK 响应 当不等于 2 且命令执行成功： OK 当等于 2 且命令执行成功： +CLCK: [,] [+CLCK: [,]] […] OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 5秒 / 参数 字符串类型。 ''SC'' (U)SIM（锁定卡槽中当前所选的(U)SIM/UICC 卡）。(U)SIM/UICC 在 MT 开机且 执行锁定命令时需要一个密码。 ''AO'' BAOC（禁止所有呼出，详情参考 3GPP TS 22.088 clause 1） ''OI'' BOIC（禁止所有国际呼出，详情参考 3GPP TS 22.088 clause 1） ''OX'' BOIC-exHC（禁止所有国际呼出，归属国除外，详情参考 3GPP TS 22.088 clause 1） ''AI'' BAIC（禁止所有呼入，详情参考 3GPP TS 22.088 clause 2） ''IR'' BIC-Roam（归属地以外漫游时，禁止所有呼入，详情参考 3GPP TS 22.088 clause 2） 上海移远通信技术股份有限公司 60 / 189 LTE Standard(A)系列 AT 命令手册 ''AB'' 禁止所有业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 ''AG'' 禁止呼出业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 ''AC'' 禁止呼入业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 ''FD'' UICC（GSM 或(U)SIM）固定拨号存储器功能中的(U)SIM 卡或活动应用程序（若 当前会话中 PIN2 未完成身份验证，则需在中输入 PIN2）。 ''PF'' 将电话锁定到最先插入的(U)SIM/UICC 卡（在本文档中也称为 PH-FSIM）（当插入 其他(U)SIM/UICC 卡时，MT 需要一个密码）。 ''PN'' 网络个性化（详情参考 3GPP TS 22.022） ''PU'' 网络子集个性化（详情参考 3GPP TS 22.022） ''PP'' 服务供应商个性化（详情参考 3GPP TS 22.022） ''PC'' 企业个性化（详情参考 3GPP TS 22.022） 整型。操作模式。 0 解锁 1 锁定 2 查询状态 字符串类型。密码。 整型。数据类别。 1 语音 2 数据 4 传真 7 短消息以外所有电话通讯 8 短消息 16 数据线路同步 32 数据线路异步 整型。设备状态。 0 未锁定 1 已锁定 错误码。参考第12.5章。 举例 AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK //查询(U)SIM 卡状态。 //(U)SIM 卡未被锁定。 //锁定 U(SIM)卡，且密码为'1234'。 //查询(U)SIM 卡状态。 //(U)SIM 卡被锁定。 //解锁(U)SIM 卡。 上海移远通信技术股份有限公司 61 / 189 LTE Standard(A)系列 AT 命令手册 5.3. AT+CPIN PIN 管理 该命令用于输入密码或查询模块在操作前是否需要输入密码，密码可为(U)SIM PIN、(U)SIM PUK、 PH-SIM PIN 等。如果要输入两次 PIN，TA 将自动重复输入 PIN。如果没有 PIN 请求待处理，则不会采取 任何措施，并且将返回+CME ERROR 给 TE。 如果 MT PIN 的类型为(U)SIM PUK 或(U)SIM PUK2，则需要输入第二个参数，用于替换 (U)SIM 中的旧 PIN 码。 AT+CPIN PIN 管理 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 TA 返回字母数字格式，指示是否需要密码。 +CPIN: 设置命令 AT+CPIN=[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 5 s / 参数 字符串类型。 READY SIM PIN SIM PUK SIM PIN2 SIM PUK2 PH-NET PIN PH-NET PUK PH-NETSUB PIN PH-NETSUB PUK PH-SP PIN PH-SP PUK 无密码等待输入 MT MT 正在等待输入(U)SIM PIN MT 正在等待输入(U)SIM PUK MT 正在等待输入(U)SIM PIN2 MT 正在等待输入(U)SIM PUK2 MT 正在等待输入网络个性化密码 MT 正在等待输入网络个性化解锁密码 MT 正在等待输入网络子集个性化密码 MT 正在等待输入网络子集个性化解锁密码 MT 正在等待输入服务提供商的个性化密码 MT 正在等待输入服务提供商的个性化解锁密码 上海移远通信技术股份有限公司 62 / 189 LTE Standard(A)系列 AT 命令手册 PH-CORP PIN MT 正在等待输入企业个性化密码 PH-CORP PUK MT 正在等待输入企业个性化解锁密码 字符串类型。密码。请求的密码类型为 PUK，例如(U)SIM PUK1、PH-FSIM PUK 或者其 他密码，则必须输入。 字符串类型。新密码。若请求的密码类型为 PUK，则需要重新输入新密码。 错误码。参考第 12.5 章。 举例 //输入 PIN AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 OK +CPIN: READY AT+CPIN? +CPIN: READY OK //输入 PUK 和 PIN AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //正在等待输入(U)SIM PIN 码。 //输入 PIN 码。 //已输入 PIN 码。 //正在等待输入(U)SIM PUK 码。 //输入 PUK 码和新密码。 //已输入 PUK 码。 5.4. AT+CPWD 修改密码 该命令用于修改 AT+CLCK 定义的功能锁定密码。测试命令返回两个参数，分别列出可用的功能及其 密码的最大长度。 上海移远通信技术股份有限公司 63 / 189 LTE Standard(A)系列 AT 命令手册 AT+CPWD 修改密码 测试命令 AT+CPWD=? 响应 +CPWD: (支持的列表), 设置命令 AT+CPWD=,, 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 若错误与 ME 功能相关： +CME ERROR: 5秒 / 参数 字符串类型。 ''SC'' (U)SIM（锁定卡槽中当前所选的(U)SIM/UICC 卡）。(U)SIM/UICC 在 MT 开 机且执行锁定命令时需要一个密码。 ''AO'' BAOC（禁止所有呼出，详情参考 3GPP TS 22.088 clause 1） ''OI' BOIC（禁止所有国际呼出，详情参考 3GPP TS 22.088 clause 1） ''OX'' BOIC-exHC（禁止所有国际呼出，归属国除外，详情参考 3GPP TS 22.088 clause 1） ''AI' BAIC（禁止所有呼入，详情参考 3GPP TS 22.088 clause 2） ''IR'' BIC-Roam（归属地以外漫游时，禁止所有呼入，详情参考 3GPP TS 22.088 clause 2） ''AB'' 禁止所有业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 ''AG'' 禁止呼出业务（详情参考 3GPP TS 22.030），仅当=0 时有效 ''AC' 禁止呼入业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 ''P2'' (U)SIM PIN2 整型。密码最大长度。 字符串类型。从用户界面或使用该命令指定的密码。 字符串类型。新密码。 错误码。参考第 12.5 章。 举例 AT+CPIN? +CPIN: READY 上海移远通信技术股份有限公司 64 / 189 OK AT+CPWD='SC','1234','4321' OK //重启模块或重新激活(U)SIM 卡 AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='4321' OK +CPIN: READY LTE Standard(A)系列 AT 命令手册 //修改(U)SIM 卡密码为'4321'。 //查询 PIN 码被锁定 //必须输入 PIN 码以定义新密码'4321'。 5.5. AT+CSIM 通用(U)SIM 卡访问 该命令允许通过 TE 上的远程应用直接控制安装在当前所选卡槽中的(U)SIM 卡。而且 TE 应在 GSM/UMTS 指定的帧内处理(U)SIM 卡信息。 AT+CSIM 通用(U)SIM 卡访问 测试命令 AT+CSIM=? 设置命令 AT+CSIM=, 响应 OK 响应 +CSIM: , OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。或字符串的长度。 MT 发送至(U)SIM 卡的命令，格式参考 3GPP TS 51.011。 (U)SIM 卡向 MT 发送的响应，格式参考 3GPP TS 51.011。 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 65 / 189 LTE Standard(A)系列 AT 命令手册 5.6. AT+CRSM (U)SIM 卡受限访问 该 命 令 可 以 对 (U)SIM 数 据 库 的 进 行 简 单 而 有 限 的 访 问 ， 用 于 向 MT 传 输 (U)SIM 命 令 编 号 （）及其所需的参数。 AT+CRSM (U)SIM 卡受限访问 测试命令 响应 AT+CRSM=? 设置命令 OK 响应 AT+CRSM=[,[,<P1 +CRSM: ,[,] >,,[,][,]]] OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 , , , 整型。(U)SIM 命令编号。 176 READ BINARY（读取二进制文件） 178 READ RECORD（读取记录内容） 192 GET RESPONSE（获取响应） 214 UPDATE BINARY（更新二进制文件） 220 UPDATE RECORD（更新记录内容） 242 STATUS（状态查询） 整型。对于来说，它是(U)SIM 上基本数据文件的标识符。 整型。MT 传送到(U)SIM 卡的参数。除 GET RESPONSE 和 STATUS 外，其 他命令均需包含此参数。参数值参考 3GPP TS 51.011。 十六进制字符格式。待写入到(U)SIM 卡上的信息。详情参考 AT+CSCS。 十六进制字符格式。UICC 中基本文件路径。 整型。(U)SIM 关于实际命令执行的信息。在命令执行成功或失败时，这些参数 都会传递给 TE。 十六进制字符串格式。命令发送成功后的响应。详情参考 AT+CSCS。STATUS 和 GET RESPONSE 返回有关当前基本数据字段信息，该信息包括文件类型及 其大小，参考 3GPP TS 51.011。在 READ BINARY、READ RECORD 或 RETRIEVE 0DATA 命令之后，将返回所请求的数据。成功执行 UPDATE BINARY、UPDATE RECORD 或 SET DATA 命令后，不会返回。 上海移远通信技术股份有限公司 66 / 189 错误码。参考第 12.5 章。 LTE Standard(A)系列 AT 命令手册 5.7. AT+QCCID 查询 ICCID 该命令用于查询(U)SIM 卡的集成电路卡识别码（ICCID）。 AT+QCCID 查询 ICCID 测试命令 AT+QCCID=? 执行命令 AT+QCCID 响应 OK 响应 +QCCID: 最大响应时间 特性说明 OK 或者 ERROR 300 毫秒 / 参数 整型。(U)SIM 卡的集成电路卡识别码。 举例 AT+QCCID +QCCID: 89860025128306012474 OK //查询(U)SIM 卡的 ICCID。 5.8. AT+QPINC 获取 PIN 剩余重试次数 该命令用于查询剩余输入(U)SIM PIN/PUK 密码的次数。 AT+QPINC 获取 PIN 剩余重试次数 测试命令 AT+QPINC=? 响应 +QPINC: (支持的列表) 上海移远通信技术股份有限公司 67 / 189 LTE Standard(A)系列 AT 命令手册 查询命令 AT+QPINC? 设置命令 AT+QPINC= 最大响应时间 特性说明 OK 响应 +QPINC: 'SC',, +QPINC: 'P2',, OK 响应 +QPINC: ,, OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。 ''SC'' (U)SIM PIN ''P2'' (U)SIM PIN2 整型。剩余输入 PIN 密码的次数。范围：0~3。 整型。剩余输入 PUK 密码的次数。范围：0~10。 错误码。参考第 12.5 章。 5.9. AT+QINISTAT 查询(U)SIM 卡初始化状态 该命令用于查询(U)SIM 卡初始化状态。 AT+QINISTAT 查询(U)SIM 卡初始化状态 测试命令 AT+QINISTAT=? 响应 +QINISTAT: (支持的范围) 执行命令 AT+QINISTAT OK 响应 +QINISTAT: OK 上海移远通信技术股份有限公司 68 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 / 参数 整型。(U)SIM 卡初始化状态。实际值是以下四个数字中任意几个数字之和（例如：7 = 1 + 2 + 4 表示 CPIN READY + SMS DONE + PB DONE，即 CPIN 已就绪，SMS 初始化完成且电 话簿初始化完成)。 0 初始化状态。 1 CPIN 已就绪，可执行锁定/解锁 PIN 操作。 2 SMS 初始化完成。 4 电话簿初始化完成。 5.10. AT+QSIMDET (U)SIM 卡检测 该命令用于启用(U)SIM 卡的热插拔功能。GPIO 中断用于检测(U)SIM 卡，插入(U)SIM 卡时需设置 (U)SIM 卡检测引脚的电平。 AT+ QSIMDET 测试命令 AT+QSIMDET=? (U)SIM 卡检测 响应 +QSIMDET: (支持的列表),(支持的列 表) 查询命令 AT+QSIMDET? OK 响应 +QSIMDET: , 设置命令 OK 响应 AT+QSIMDET=, OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 69 / 189 LTE Standard(A)系列 AT 命令手册 参数 整型。启用/禁用(U)SIM 卡检测功能。 0 禁用 1 启用 整型。插入(U)SIM 卡时，引脚检测的电平。 0 低电平 1 高电平 备注 若配置的值与硬件设计不一致，则热插拔功能将无效。 举例 AT+QSIMDET=1,0 OK +CPIN: NOT READY +CPIN: READY //(U)SIM 卡插入时，(U)SIM 检测引脚电平设为低电平。 //CPIN 已就绪 5.11. AT+QSIMSTAT (U)SIM 卡插拔状态上报 该命令用于查询/启用/禁用(U)SIM 卡的插拔状态上报功能。 AT+QSIMSTAT (U)SIM 卡插拔状态上报 测试命令 AT+QSIMSTAT=? 响应 +QSIMSTAT: (支持的列表) 查询命令 AT+QSIMSTAT? OK 响应 +QSIMSTAT: , 设置命令 AT+QSIMSTAT= 最大响应时间 OK 响应 OK 或者 ERROR 300 毫秒 上海移远通信技术股份有限公司 70 / 189 LTE Standard(A)系列 AT 命令手册 特性说明 该命令重启后生效； 参数配置自动保存。 参数 整型。启用/禁用(U)SIM 卡插拔状态上报功能。当开启时，将上报 URC +QSIMSTAT: ,指示(U)SIM 卡的插拔状态。 0 禁用 1 启用 整型。(U)SIM 卡的插拔状态。该参数不允许配置。 0 拔出 1 插入 2 未知状态。该状态出现在(U)SIM 卡初始化之前。 举例 AT+QSIMSTAT? +QSIMSTAT: 0,1 //查询(U)SIM 卡的插拔状态。 OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 //使能(U)SIM 卡的插拔状态上报功能。 OK +QSIMSTAT : 1,0 //上报(U)SIM 卡的插拔状态：拔出。 +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK +QSIMSTAT: 1,1 //上报(U)SIM 卡的插拔状态：插入。 +CPIN: READY 上海移远通信技术股份有限公司 71 / 189 LTE Standard(A)系列 AT 命令手册 6 网络服务命令 6.1. AT+COPS 选择运营商 该命令用于查询当前运营商及其状态，并允许设置自动或手动网络选择。 测试命令返回五个参数，分别代表网络中出现的运营商。若有任意参数不可用，则对应取值为空字 段。返回运营商列表显示顺序为：归属地网络、(U)SIM 卡推荐网络和其他网络。 查询命令返回当前找网模式和当前所选运营商。如果未选择任何运营商，则不会返回、 和。 设置命令用于强制选择并注册 GSM/UMTS/LTE 网络运营商，即使所选的网络运营商不可用，也不可 选择其他任何运营商（=4 除外）。所选运营商名称的格式也应适用于查询命令 AT+COPS?。 AT+COPS 选择运营商 测试命令 AT+COPS=? 响应 +COPS: [支持的运营商列表(,长字符,短字符 ,数字[,])][,,(支持的范围),(支持 的范围)] OK 查询命令 AT+COPS? 若错误与 ME 功能相关： +CME ERROR: 响应 +COPS: [,[,][,]] OK 设置命令 AT+COPS=[,[,[,]]] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 若错误与 ME 功能相关： 上海移远通信技术股份有限公司 72 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 +CME ERROR: 180 秒，取决于网络状态 / 参数 整型。运营商状态。 0 未知 1 可用运营商 2 当前选择的运营商 3 禁止选择的运营商 字符串类型。运营商。表示该字符串采用的格式。 整型。网络选择模式。 0 自动搜网，省略 1 手动搜网，不可省略且可选 2 手动注销网络 3 仅设置（用于查询命令 AT+COPS?）；不进行注册或注销（省略 和）；该取值不适用于查询命令的返回结果。 4 手动和自动搜网的组合模式，字段不可省略。如果手动选择失败，将进入自 动选择模式（=0）。 整型。的格式。 0 长字符串格式，最多 16 个字符 1 短字符串格式 2 数字格式，GSM 位置区域识别号码 整型。网络制式。取值 3、4、5 和 6 仅适用于当 MS 处于数据服务状态时查询命令的返回结 果，且不可用于设置命令。 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 8 UTRAN HSPA+ 错误码。参考第 12.5 章。 举例 AT+COPS=? //列举当前所有的网络运营商。 +COPS: (1,'CHN-UNICOM','UNICOM','46001',2),(1,'CHN-UNICOM','UNICOM','46001',0),(2,'CH N-UNICOM','UNICOM','46001',7),(1, 'CHN-CT', 'CT','46011',7),(3,'CHINA MOBILE','CMCC','4 上海移远通信技术股份有限公司 73 / 189 6000',0),,(0,1,2,3,4),(0,1,2) OK AT+COPS? +COPS: 0,0,'CHN-UNICOM',7 OK LTE Standard(A)系列 AT 命令手册 //查询当前选择的网络运营商。 6.2. AT+CREG CS 域网络注册状态 查询命令返回 CS 域网络注册状态和结果码显示状态。表示 ME 的网络注册状态。仅当 ME 注册 到网络和=2 时，才会返回位置信息和。 设置命令设置是否上报 URC 并在=1 且 ME 网络注册状态发生变化时，控制是否显示 URC +CREG: 。 AT+CREG CS 域网络注册状态 测试命令 AT+CREG=? 响应 +CREG: (支持的范围) 查询命令 AT+CREG? OK 响应 +CREG: ,[,,[,]] OK 设置命令 AT+CREG[=] 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 响应 OK 300 毫秒 该命令立即生效； 需执行 AT&W 保存参数配置 参数 整型。是否启用网络注册相关 URC。 0 禁用网络注册 URC 上海移远通信技术股份有限公司 74 / 189 LTE Standard(A)系列 AT 命令手册 1 启用网络注册 URC +CREG: 2 启用带有位置信息的网络注册 URC： +CREG: [,,[,]] 整型。注册状态。 0 未注册；ME 当前未搜索要注册的运营商 1 已注册，归属地网络 2 未注册，ME 正在搜索要注册的运营商 3 注册被拒绝 4 未知状态 5 已注册，漫游网络 字符串类型。位置区编号。2 个字节（十六进制格式）。 字符串类型。小区 ID。16 位（GSM）或 28 位（UMTS/LTE）（十六进制格式）。 整型。网络制式。 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 8 UTRAN HSPA+ 错误码。参考第 12.5 章。 举例 AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK //URC 上报 ME 已经注册到归属地网络。 //启用带有位置信息的网络注册 URC。 +CREG: 1,''D509'',''80D413D'',7 //URC 上报带小区 ID 和位置区号的运营商。 6.3. AT+CSQ 查询信号强度 该命令用于查询当前服务小区接收信号强度和信道误码率。 测试命令返回 TA 支持的值。 执行命令获取 ME 返回的接收信号强度指示和信道误码率。 上海移远通信技术股份有限公司 75 / 189 LTE Standard(A)系列 AT 命令手册 AT+CSQ 查询信号强度 测试命令 AT+CSQ=? 执行命令 AT+CSQ 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 +CSQ: (支持的列表),(支持的列表) OK 响应 +CSQ: , OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。接收信号强度指示。 0 小于等于-113 dBm 1 -111 dBm 2~30 -109 ~ -53 dBm 31 大于等于-51 dBm 99 未知或不可测 100 小于等于-116 dBm 101 -115 dBm 102~190 -114 ~ -26 dBm 191 大于等于-25 dBm 199 未知或不可测 100~199 扩展用于 TD-SCDMA 指示接收信号码功率（RSCP） 整型。信道误码率。百分比格式。 0~7 3GPP TS 45.008 第 8.2.4 章表格中的 RxQual 值。 99 未知或不可测 错误码。参考第 12.5 章。 举例 AT+CSQ=? +CSQ: (0-31,99),(0-7,99) 上海移远通信技术股份有限公司 76 / 189 LTE Standard(A)系列 AT 命令手册 OK AT+CSQ +CSQ: 28,99 OK //查询当前接收信号强度为 28，误码率未知或不可测 备注 执行网络相关命令（如 AT+CCWA 和 AT+CCFC）后，建议等待 3 秒再执行 AT+CSQ 以确保之前执行 的命令所需的网络访问已经完成。 6.4. AT+CPOL 配置首选运营商列表 该命令用于配置或者查询首选运营商列表。 AT+CPOL 配置首选运营商列表 测试命令 AT+CPOL=? 响应 +CPOL: (支持的列表),(支持的范围) 查询命令 AT+CPOL? OK 响应 查询首选运营商的列表： +CPOL: ,,[,,,,] [+CPOL: ,,[,,,,]] […] 设置命令 AT+CPOL=[,[,[,, ,]]] OK 响应 配置首选运营商列表： OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若指定但省略，后面的参数都将被省略。 300 毫秒 / 上海移远通信技术股份有限公司 77 / 189 LTE Standard(A)系列 AT 命令手册 参数 整型。(U)SIM 卡 PLMN 的顺序。 整型。的显示格式。 0 长字符串格式 1 短字符串格式 2 数字格式 字符串类型。表示该参数格式采用字符串格式还是数字格式（参考 AT+COPS）。 整型。是否选择 GSM 网络制式。 0 未选 1 选定 整型。是否选择 GSM compact 网络制式。 0 未选 1 选定 整型。是否选择 UTRAN 网络制式。 0 未选 1 选定 整型。是否选择 E-UTRAN 网络制式。 0 未选 1 选定 备注 网络制式选择参数、、和对于具有网络制式的 PLMN 选择器的(U)SIM 卡或 UICC 卡来说是必须的。 6.5. AT+COPN 查询运营商名称列表 该命令用于从 ME 查询运营商名称列表，命令返回 ME 存储器中字符串格式（）和数字格式 （）的运营商名称。 AT+COPN 查询运营商名称列表 测试命令 AT+COPN=? 执行命令 AT+COPN 响应 OK 响应 +COPN: , [+COPN: , […]] OK 上海移远通信技术股份有限公司 78 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 取决于运营商个数 / 参数 字符串类型。数字格式的运营商名称（详情参考 AT+COPS）。 字符串类型。字符串格式的运营商名称（详情参考 AT+COPS）。 错误码。参考第 12.5 章。 6.6. AT+CTZU 自动更新时区 该命令用于启用或者禁用通过 NITZ 自动更新时区功能。 AT+CTZU 自动更新时区 测试命令 AT+CTZU=? 响应 +CTZU: (支持的列表) 查询命令 AT+CTZU? OK 响应 +CTZU: 设置命令 AT+CTZU= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 或者 ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 79 / 189 LTE Standard(A)系列 AT 命令手册 参数 整型。自动更新时区模式。 0 禁用通过 NITZ 自动更新时区 1 启用通过 NITZ 自动更新时区并更新 GMT 时间至 URC 3 启用通过 NITZ 自动更新时区并更新本地时间至 RTC 举例 AT+CTZU? +CTZU: 1 OK AT+CTZU=? +CTZU: (0,1,3) OK AT+CTZU=0 OK AT+CTZU? +CTZU: 0 OK 6.7. AT+CTZR 上报时区变化 该命令用于启用或禁用时区变化事件的上报。若启用上报，则时区变化时 MT 会返回 URC +CTZV: 或者+CTZE: ,,。 AT+CTZR 上报时区变化 测试命令 AT+CTZR=? 响应 +CTZR: (支持的范围) 查询命令 AT+CTZR? OK 响应 +CTZR: 设置命令 AT+CTZR= OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 80 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。是否上报时区变化。 0 不上报 1 通过 URC +CTZV: 上报时区变化 2 通过 URC +CTZE: ,,上报扩展时区信息和本地时间 字符串类型。表示本地时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异）与夏 令时之和。格式为'±zz'，为两个整型数字的固定宽度。范围：-48 ~ +56。为保证固定宽 度，-9 ~ +9 之间的数字前加 0，例如：'-09'、'+00'、'+09'。 整型。表示中是否包括夏令时调整。 0 不包括夏令时调整 1 包括+1 小时（相当于中的一个小时）的夏令时调整 2 包括+2 小时（相当于中的两个小时）的夏令时调整 字符串类型。本地时间。格式：'YYYY/MM/DD,hh:mm:ss'，用于表示年（YYYY）、月 （MM）、日（DD）、时（hh）、分（mm）和秒（ss）。传送时区信息时由网络提供 该参数值，并 URC 扩展时区报告中显示。 错误码。参考第 12.5 章。 举例 AT+CTZR=2 OK AT+CTZR? +CTZR: 2 OK +CTZE: '+32',0, '2017/11/04,06:51:13' //通过URC上报扩展时区和本地时间。 上海移远通信技术股份有限公司 81 / 189 LTE Standard(A)系列 AT 命令手册 6.8. AT+QLTS 获取通过网络同步的最新时间 该命令用于获取通过网络同步的最新时间。 AT+QLTS 获取通过网络同步的最新时间 测试命令 AT+QLTS=? 响应 +QLTS: (支持的范围) 设置命令 AT+QLTS= OK 响应 +QLTS: , 执行命令 AT+QLTS OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 响应 +QLTS: , 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。查询网络时间模式。 0 查询通过网络同步的最新时间 1 查询通过网络同步的最新时间计算出的当前 GMT 时间 2 查询通过网络同步的最新时间计算出的当前本地时间 字符串类型。格式为'yyyy/MM/dd,hh:mm:ss±zz'，用于表示年（yyyy），月（MM），日（dd）， 时（hh），分（mm），秒（ss），时区（zz，该字段以 15 分钟为单位显示本地时间和 GMT 时间的差异；范围：-48 ~ +48）。例如：2004 年 5 月 6 日 22:10:00，GMT 时间加 2 小时等 于'2004/05/06, 22:10:00+08'。 夏令时。 错误码。参考第 12.5 章。 备注 若时间未通过网络同步，执行该命令后返回不带时间的字符串+QLTS: ''。 上海移远通信技术股份有限公司 82 / 189 LTE Standard(A)系列 AT 命令手册 举例 AT+QLTS=? +QLTS: (0-2) //查询支持的网络时间模式。 OK AT+QLTS //查询通过网络同步的最新时间。 +QLTS: '2019/01/13,03:40:48+32,0' OK AT+QLTS=0 //查询通过网络同步的最新时间，功能同执行命令 AT+QLTS 一致。 +QLTS: '2019/01/13,03:40:48+32,0' OK AT+QLTS=1 //查询通过网络同步的最新时间计算出的当前 GMT 时间。 +QLTS: '2019/01/13,03:41:22+32,0' OK AT+QLTS=2 //查询通过网络同步的最新时间计算出的当前本地时间。 +QLTS: '2019/01/13,11:41:23+32,0' OK 6.9. AT+QNWINFO 查询网络信息 该命令用于查询网络信息，例如选择的网络制式、运营商以及选择的频段。 AT+QNWINFO 查询网络信息 测试命令 AT+QNWINFO=? 执行命令 AT+QNWINFO 响应 OK 响应 +QNWINFO: ,,, 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。选择的网络制式。 ''NONE'' ''GSM'' 上海移远通信技术股份有限公司 83 / 189 ''GPRS'' ''EDGE'' ''WCDMA'' ''HSDPA'' ''HSUPA'' ''HSPA+'' ''TDD LTE'' ''FDD LTE'' 字符串类型。数字格式运营商名称。 字符串类型。选择的频段。 ''GSM 1800'' ''GSM 900'' ''WCDMA 2100'' ''WCDMA 850'' ''WCDMA 900'' ''LTE BAND 1'' ''LTE BAND 3'' ''LTE BAND 5'' ''LTE BAND 7'' ''LTE BAND 8'' ''LTE BAND 20'' ''LTE BAND 28'' ''LTE BAND 34'' ''LTE BAND 38'' ''LTE BAND 39'' ''LTE BAND 40’’ ''LTE BAND 41'' 整型。信道 ID。 举例 AT+QNWINFO=? OK AT+QNWINFO +QNWINFO: 'FDD LTE',46001,'LTE BAND 3',1650 OK LTE Standard(A)系列 AT 命令手册 上海移远通信技术股份有限公司 84 / 189 LTE Standard(A)系列 AT 命令手册 7 呼叫相关命令 7.1. ATA 呼叫应答 该命令用于连接模块以应答由 URC RING 指示的语音来电或者数据来电。执行该命令后，MT 发送摘 机信号到远程站。 ATA 呼叫应答 执行命令 ATA 响应 若数据拨号并成功建立连接： CONNECT 此时 TA 切换到数据模式 仅 当 ATX 设 置 的 大 于 0 时 ， 返 回 CONNECT。 TA 切换到命令模式并呼叫释放： OK 若语音拨号并成功建立连接： OK 最大响应时间 特性说明 参考 V.25ter 若不能建立连接： NO CARRIER 90 秒，取决于网络状态 / 备注 1. ATA 操作忽略同一行命令中其他命令。 2. 若在执行 ATA 过程中收到字符，该命令可能被终止执行。但是在建立连接的某些状态（如：握手状 态），该命令不会被中止执行。 3. 请参考第 2.20 章的 ATX。 上海移远通信技术股份有限公司 85 / 189 举例 RING AT+CLCC +CLCC: 1,0,0,1,0,'',128 AT+CLCC +CLCC: 2,1,4,0,0,'02154450290',129 OK ATA OK LTE Standard(A)系列 AT 命令手册 //语音来电 //LTE 模式下 PS 呼叫 //来电 //使用 ATA 应答此语音呼叫 7.2. ATD 发起呼叫 该命令用于建立语音或数据主叫，还可以用于控制补充业务。 ATD 发起呼叫 执行命令 ATD[][;] 响应 若无拨号音且设置 ATX2 或者 ATX4： NO DIAL TONE 若遇忙占线且设置 ATX3 或者 ATX4： BUSY 若连接未成功建立： NO CARRIER 若成功发起非语音呼叫： CONNECT TA 切换为数据模式。 仅当 ATX设置的大于 0 时，返回。 呼叫释放后 MT 返回命令模式： OK 最大响应时间 特性说明 参考 V.25ter 若成功发起语音呼叫： OK 5 秒，取决于网络状态（AT+COLP=0） / 上海移远通信技术股份有限公司 86 / 189 LTE Standard(A)系列 AT 命令手册 参数 拨号位字符串和 V.25ter 中可选的拨号修饰符。 拨号位：0-9，*，#，+，A，B，C 以下 V.25ter 拨号修饰符可忽略： ,（逗号），T，P，!，W，@ 字符串类型。GSM 修饰符。 I 激活 CLIR（主叫用户不允许在被叫用户话机上显示自己的电话号码） i 禁止 CLIR（主叫用户允许在被叫用户话机上显示自己的电话号码） G 仅为本次呼叫激活闭合用户组请求 g 仅为本次呼叫去激活闭合用户组请求 仅在建立语音呼叫时可用，呼叫结束后返回至命令状态。 备注 1. 若在执行 ATD 过程中收到 ATH 或某一字符，该命令可能被终止执行。但是在建立连接的某些状态（如： 握手状态），该命令不会被中止执行。 2. =I/i 仅适用于拨号字符中无'*'或'#'的情况。 3. 关于结果码的设置和呼叫监控参数的详细介绍，详情参考 ATX； 4. 使用 ATD 拨号后响应： 对于语音呼叫，可设置两种不同的响应模式： ⚫ 拨号完成后或者在呼叫建立成功后，TA 立即返回 OK。此设置由 AT+COLP 控制。 ⚫ 出厂默认设置为 AT+COLP=0，即拨号完成后，TA 立即返回 OK。否则 TA 返回 OK、BUSY、 NO DIAL TONE 或 NO CARRIER。 5. 在一个已激活的语音呼叫中，使用 ATD： ⚫ 当已有一个已激活的语音呼叫，用户发起第二个语音呼叫时，第一个语音呼叫将自动设置为呼 叫保持状态。 ⚫ 所有呼叫的当前状态均可随时使用 AT+CLCC 进行查询。 举例 ATD10086; OK //拨号 7.3. AT+COLP 被叫线路识别显示 建立主叫后，该命令启用或禁用主叫方获取被叫方身份，详情可参考 GSM/UMTS 补充业务 COLP（被 叫线路识别提示）。MT 启用或禁用在 TE 显示 COL（被叫线路），对网络中补充业务 COLR 的执行没有影 响。 在任何+CR 或 V.25ter 响应之前，TA 向 TE 返回中间结果码 OK。 上海移远通信技术股份有限公司 87 / 189 LTE Standard(A)系列 AT 命令手册 AT+COLP 被叫线路识别显示 测试命令 AT+COLP=? 查询命令 AT+COLP? 设置命令 AT+COLP=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 +COLP: (支持的列表) OK 响应 +COLP: , OK 响应 OK 15 秒，取决于网络状态 该命令立即生效； 参数配置不保存。 参数 整型。禁用/启用在 TA 中显示结果码。 0 禁用 1 启用 整型。是否在网络中提供用户 COLP 业务。 0 不提供 COLP 业务 1 提供 COLP 业务 2 未知（如：无网络等） 字符串类型。电话号码，格式由指定。 整型。八位字节地址类型（参考 3GPP TS 24.008 第 10.5.4.7 章节）。 128 未知类型（号码长度为 0） 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 字符串类型。子地址，格式由指定。 整型。八位字节的子地址类型。（参考 3GPP TS 24.008 第 10.5.4.8 章节） 字符串类型。可选参数，以字母数字表示，对应在电话号码簿中的位置。 备注 中间结果码： 使能结果码（=1）且被叫方允许后，响应+CR 和 V.25ter 之前，将返回如下中间结果码： +COLP: ,,[],[],[] 上海移远通信技术股份有限公司 88 / 189 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK LTE Standard(A)系列 AT 命令手册 7.4. ATH 挂断现有连接 该命令用于断开当前数据通话或语音通话，即本地 TE 从命令行断开并终止通话。也可使用 AT+CHUP 挂断语音通话。 ATH 挂断现有连接 执行命令 ATH[n] 最大响应时间 特性说明 参考 V.25ter 响应 OK 90 秒，取决于网络状态 / 参数 整型。 0 从命令行断开现有所有通话并终止通话。 7.5. AT+CHUP 挂断语音通话 该命令用于取消所有活跃、等待、保持状态的语音通话。若需断开数据通话，需使用 ATH。 AT+CHUP 挂断语音通话 测试命令 响应 AT+CHUP=? 执行命令 OK 响应 AT+CHUP OK 上海移远通信技术股份有限公司 89 / 189 最大响应时间 特性说明 参考 3GPP 27.007 举例 RING AT+CHUP OK LTE Standard(A)系列 AT 命令手册 或者 ERROR 90 秒，取决于网络状态 / //来电 //挂断通话 7.6. +++ 从数据模式切换至命令模式 该命令仅在 TA 处于数据模式时可用。+++字符使 TA 取消 AT 接口上的数据流并切换到命令模式。这样 可以在保持与远程服务器的数据连接或 GPRS 连接的同时输入 AT 命令。 +++ 从数据模式切换至命令模式 执行命令 +++ 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 / 备注 1. 为防止+++转义序列被误解为数据，应遵循以下规则： 1) 输入+++前 1 秒内请勿输入任何字符。 2) 1 秒钟内输入+++，在此时间内不能输入其他字符。 3) 输入+++后 1 秒钟内请勿输入任何字符。 4) 成功切换到命令模式；否则，返回步骤 1)。 2. 如需从命令模式切换至数据模式，请输入 ATO。 3. 切换为命令模式的另一种方法是通过更改 DTR 电平，有关详细信息，参见 AT&D。 上海移远通信技术股份有限公司 90 / 189 LTE Standard(A)系列 AT 命令手册 7.7. ATO 从命令模式切换至数据模式 该命令用于恢复连接，并从命令模式切换回数据模式。 ATO 从命令模式切换至数据模式 执行命令 ATO[n] 响应 恢复连接失败： NO CARRIER 最大响应时间 特性说明 参考 V.25ter 恢复连接成功，TA 从命令模式返回至数据模式： CONNECT 300 毫秒 / 参数 整型。 0 从命令模式切换回数据模式 备注 当 TA 成功从命令模式切换至数据模式时，将返回 CONNECT 。请注意，仅当 ATX的参 数值大于 0 时，才输出。 7.8. ATS0 设置自动应答前振铃次数 该命令用于设置来电的自动应答前振铃次数。 ATS0 设置自动应答前振铃次数 查询命令 响应 ATS0? 设置命令 ATS0= 最大响应时间 OK 响应 OK 300 毫秒 上海移远通信技术股份有限公司 91 / 189 LTE Standard(A)系列 AT 命令手册 特性说明 参考 V.25ter 该命令立即生效。 需执行 AT&W 保存参数配置。 参数 整型。设置来电的自动应答前的振铃次数 0 禁用自动应答 1~255 达到指定的振铃次数后，启用自动应答 备注 1. 若值设置过高，呼叫方可能在呼叫被自动应答前停止呼叫。 2. VoLTE 通话中，仅支持=0。 举例 ATS0=3 OK RING RING RING //设置三次振铃后自动接听 //呼叫进入 //振铃 3 次后自动应答呼叫 7.9. AT+CLCC 查询当前 ME 呼叫 该命令用于查询所有当前呼叫。若命令成功但无呼叫，将不会有信息发送到 TE，只返回 OK。 AT+CLCC 查询当前 ME 呼叫 测试命令 AT+CLCC=? 执行命令 AT+CLCC 响应 OK 响应 [+CLCC: ,,,,[,, [,]] [+CLCC: ,,,,[,, [,]] [...] 上海移远通信技术股份有限公司 92 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。呼叫识别号（请参考 3GPP TS 22.030 subclause 4.5.5.1）。 整型。 0 主叫（MO） 1 被叫（MT） 整型。呼叫状态。 0 激活状态 1 呼叫保持状态 2 主叫，拨号状态 3 主叫，回铃音状态 4 被叫，来电状态 5 被叫，呼叫等待状态 整型。承载/呼叫服务。 0 语音呼叫 1 数据呼叫 2 传真 整型。 0 不在多方通话中 1 在多方通话中 字符串类型。由规定电话号码格式。 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。通常有如下 取值： 129 未知类型 145 国际号码（以'+'开头） 161 国家号码 字母数字格式的，与电话簿中的条目相对应。 错误码。参考第 12.5 章。 举例 ATD10086; OK AT+CLCC +CLCC: 1,0,0,1,0,'',128 //发起通话 //LTE 模式下的 PS 通话 上海移远通信技术股份有限公司 93 / 189 +CLCC: 2,0,0,0,0,'10086',129 OK LTE Standard(A)系列 AT 命令手册 //发起通话且通话已被接听 7.10. AT^DSCI 指示呼叫状态 该命令用于配置是否使用 URC DSCI 指示呼叫状态。 AT^DSCI 指示呼叫状态 测试命令 AT^DSCI=? 响应 ^DSCI: (支持的列表) 查询命令 AT^DSCI? OK 响应 ^DSCI: 设置命令 AT^DSCI= 最大响应时间 特性说明 OK 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。配置是否通过 URC DSCI 上报呼叫状态。 0 禁用 1 启用 整型。呼叫 ID。 整型。呼叫方向。 0 主叫（MO） 1 被叫（MT） 整型。呼叫状态。 1 CALL_LOCAL_HOLD 呼叫本地保持 2 CALL_ORIGINAL 呼叫发起 3 CALL_CONNECT 呼叫连接 4 CALL_INCOMING 呼叫接入 5 CALL_WAITING 呼叫等待 6 CALL_END 呼叫结束 7 CALL_ALERTING 呼叫提醒 整型。呼叫类型。 上海移远通信技术股份有限公司 94 / 189 LTE Standard(A)系列 AT 命令手册 0 语音呼叫 1 PS 呼叫 字符串类型。手机号码。 手机号码类型。 备注 若启用通过 URC DSCI 上报呼叫状态（=1），将上报 URC ^DSCI: ,,,,,。 举例 //拨号 AT^DSCI=1 OK ATD10086; OK ^DSCI: 1,0,2,0,10086,129 ^DSCI: 1,0,7,0,10086,129 ^DSCI: 1,0,3,0,10086,129 ATH OK ^DSCI: 1,0,6,0,10086,129 //来电 RING ^DSCI: 1,1,4,0,13022100000,129 RING ^DSCI: 1,1,6,0,13022100000,129 NO CARRIER //启用 URC DSCI 上报呼叫状态。 //拨打 10086。 //发起语音呼叫。 //呼叫提醒。 //呼叫连接成功。 //呼叫结束。 //新呼叫接入。 //呼叫结束。 上海移远通信技术股份有限公司 95 / 189 LTE Standard(A)系列 AT 命令手册 8 电话本相关命令 8.1. AT+CNUM 查询本机号码 该命令用于读取(U)SIM 卡中所有本机号码记录。 AT+CNUM 查询本机号码 测试命令 AT+CNUM=? 执行命令 AT+CNUM 响应 OK 响应 [+CNUM: [],,] [+CNUM: [],,] OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。与相关联，使用的字符集应为 AT+CSCS 设置的字符集。 字符串类型。电话号码。格式由决定。 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。通常有如下 取值： 129 未知类型（ISDN 格式） 145 国际号码（ISDN 格式） 161 国家号码 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 96 / 189 LTE Standard(A)系列 AT 命令手册 8.2. AT+CPBF 搜索电话本 该命令用于搜索由 AT+CPBS 设置的当前电话本储存器中与匹配的条目，返回的所有条目以 字母数字顺序排列。 AT+CPBF 搜索电话本 测试命令 AT+CPBF=? 响应 +CPBF: , 设置命令 AT+CPBF= OK 响应 [+CPBF: ,,,] […] OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 ME 功能相关： +CME ERROR: 取决于电话本条目数量。 / 参数 整型。的最大长度。 整型。的最大长度。 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 整型。电话号码在存储器中的位置。 字符串类型。电话号码格式，由决定。 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。通常有如下 取值： 129 未知类型（ISDN 格式） 145 国际号码（ISDN 格式） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 97 / 189 LTE Standard(A)系列 AT 命令手册 8.3. AT+CPBR 读取电话本条目 该命令用于读取由 AT+CPBS 设置的当前电话本存储器中位于与之间的电话本条 目。如果只输入，则只返回在位置的电话本条目。 AT+CPBR 读取电话本条目 测试命令 AT+CPBR=? 响应 +CPBR: (支持的列表),, 设置命令 AT+CPBR=[,] OK 响应 +CPBR: ,,, [+CPBR: ,,, […]] 最大响应时间 特性说明 参考 3GPP 27.007 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 取决于电话本条目数量。 / 参数 整型。电话本存储器位置索引号。 字符串类型。电话号码格式，由决定。 整型。的最大长度。 整型。的最大长度。 整型。需读取的电话号码在存储器中的起始位置。 整型。需读取的电话号码在存储器中的终止位置。 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。通常有如下 取值： 129 未知类型（ISDN 格式） 145 国际号码（ISDN 格式） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 98 / 189 LTE Standard(A)系列 AT 命令手册 8.4. AT+CPBS 设置电话本存储器 该命令用于设置电话本存储器，使用其他电话本相关命令时也会使用该存储器。查询命令返回当前选 择的存储器类型、当前已使用存储位置数量和存储器位置总数。测试命令返回命令支持的参数范围。 AT+CPBS 设置电话本存储器 测试命令 AT+CPBS=? 响应 +CPBS: (支持的列表) OK 或者 ERROR 查询命令 AT+CPBS? 若错误与 ME 功能相关： +CME ERROR: 响应 +CPBS: ,, OK 或者 ERROR 设置命令 AT+CPBS= 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 参数 3GPP 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。电话本存储器。 'SM' (U)SIM 电话本 'DC' 已拨号码（可能不适用于 AT+CPBW） 上海移远通信技术股份有限公司 99 / 189 LTE Standard(A)系列 AT 命令手册 'FD' (U)SIM 卡固定拨号电话本（AT+CPBW 操作需要 PIN2 码） 'LD' (U)SIM 卡最后拨号电话本（可能不适用于 AT+CPBW） 'EN' (U)SIM 卡或 ME 紧急呼叫号码（可能不适用于 AT+CPBW） 'ON' (U)SIM 卡本机号码列表（MSISDN） 'AP' 设置的应用电话簿。若已存在 USIM 应用程序的 UICC，则选择 ADFUSIM 下的 应用程序电话簿 DFPHONEBOOK。 'SDN' 服务拨号 整型。当前存储器中已用的存储单元。 整型。当前存储器中总计的存储单元。 错误码。参考第 12.5 章。 8.5. AT+CPBW 写入电话本 该命令用于在由 AT+CPBS 设置的当前存储器指定位置中添加或删除电话条目。 AT+CPBW 写入电话本 测试命令 AT+CPBW=? 响应 +CPBW: (支持的范围),,(支持的列 表), OK 或者 ERROR 设置命令 AT+CPBW=[][,[,[,]]] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 100 / 189 LTE Standard(A)系列 AT 命令手册 参数 整型。电话本存储器位置索引号。若未指定该参数，将使用第一个电话本条目。若仅指定 了该参数，由该参数指定的电话本条目将被删除。 整型。的最大长度。 整型。的最大长度。 字符串类型。电话号码格式，由决定。 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。通常有如下 取值： 129 未知类型（ISDN 格式） 145 国际号码（ISDN 格式） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。参考第 12.5 章。 举例 AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK AT+CPBR=10 +CPBR: 10,'15021012496',129,'QUECTEL' //在位置 10 添加一条电话条目。 //读取电话本条目。 OK AT+CPBW=10 OK //删除位置 10 的电话条目。 上海移远通信技术股份有限公司 101 / 189 LTE Standard(A)系列 AT 命令手册 9 短消息相关命令 9.1. AT+CSMS 选择短消息服务类型 该命令用于选择短消息服务类型并返回 ME 支持的短消息类型。 AT+CSMS 选择短消息服务类型 测试命令 AT+CSMS=? 响应 +CSMS: (支持的列表) 查询命令 AT+CSMS? OK 响应 +CSMS: ,,, 设置命令 AT+CSMS= OK 响应 +CSMS: ,, OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。短消息服务类型。 0 详情参考 3GPP TS 23.040 和 3GPP TS 23.041（SMS 的 AT 命令语法与 3GPP TS 27.005 Phase 2 4.7.0 版本兼容；支持不需要新命令语法的 Phase 2+功能（例如： 使用 Phase 2+新编码方案修正消息路由））。 1 详情参考 3GPP TS 23.040 和 3GPP TS 23.041（SMS 的 AT 命令语法与 3GPP TS 27.005 Phase 2+版本兼容；设置为 1 时的要求已在对应命令描述中说明。） 上海移远通信技术股份有限公司 102 / 189 LTE Standard(A)系列 AT 命令手册 整型。被叫短消息。 0 不支持 1 支持 整型。主叫短消息。 0 不支持 1 支持 整型。广播类型短消息。 0 不支持 1 支持 错误码。参考第 12.6 章。 举例 AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //列出支持的短消息服务类型。 //设置短消息服务类型为 1。 //查询当前短消息服务类型。 9.2. AT+CMGF 配置短消息模式 该命令用于指定短消息采用的格式。表示 TA-TE 之间，读/写短消息时，采用的是文本模式还 是 PDU 模式。消息格式可设置为 PDU 模式（使用整个 TP 数据单元）或者文本模式（消息头和消息体分 别以不同的参数形式展示）。文本模式通过 AT+CSCS 指定的来告知 TA-TE 交互中消息体使用的字 符集。 AT+CMGF 配置短消息模式 测试命令 AT+CMGF=? 响应 +CMGF: (支持的列表) 查询命令 AT+CMGF? OK 响应 +CMGF: OK 上海移远通信技术股份有限公司 103 / 189 设置命令 AT+CMGF[=] 最大响应时间 特性说明 参考 3GPP TS 27.005 参数 整型。短消息模式。 0 PDU 模式 1 文本模式 响应 OK 300 毫秒 / LTE Standard(A)系列 AT 命令手册 9.3. AT+CSCA 设置短消息服务中心地址 该设置命令用于当主动发送短消息后，更新 SMSC（短消息服务中心）地址。在文本模式下，可使用 设置命令进行设置。在 PDU 模式下，仅当 SMSC 地址的长度编码为=0 时，方可使用设置命令进行 设置。 AT+CSCA 设置短消息服务中心地址 测试命令 响应 AT+CSCA=? 查询命令 OK 响应 AT+CSCA? +CSCA: , 设置命令 AT+CSCA=[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 104 / 189 LTE Standard(A)系列 AT 命令手册 参数 字符串类型。短消息服务中心地址。详情参考 3GPP TS 24.011 RP SC 地址 Address-Value 字段；BCD 码（或 GSM 7 位默认字母字符）转换为当前选择的 TE 字符集的字符（参考 3GPP TS 27.007 中 AT+CSCS）。地址类型由定义。 整型。短消息服务中心地址类型。详情参考 3GPP TS 24.011 RP SC 地址中八位字节的 Type-of-Address（参考）。 错误码。参考第 12.6 章。 举例 AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //设置短消息服务中心地址。 //查询短消息服务中心地址。 9.4. AT+CPMS 配置短消息首选存储位置 该命令用于选择查询或配置短消息的存储位置，包括、和。 AT+CPMS 配置短消息首选存储位置 测试命令 响应 AT+CPMS=? +CPMS: (支持的列表),(支持的列表),(支持 的列表) 查询命令 AT+CPMS? OK 响应 +CPMS: ,,,,,,,, 设置命令 AT+CPMS=[,[,]] OK 响应 +CPMS: ,,,,, OK 若错误与 ME 功能相关： +CMS ERROR: 上海移远通信技术股份有限公司 105 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 300 毫秒 / 参数 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 字符串类型。若没有建立到 TE 的路由（参考 AT+CNMI），则接收的短消息存储在该存储器 内。 'SM' (U)SIM 卡 'ME' 移动设备 整型。中当前短消息的数量。 整型。中可存储的短消息的总数量。 错误码。参考第 12.6 章。 举例 AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //将短消息存储器更改为'SM'。 OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //查询当前短消息存储器。 OK 9.5. AT+CMGD 删除短消息 该命令用于从首选存储器中删除位于的短消息。若指定且不为 0，ME 应省 略并遵守参数规则。 上海移远通信技术股份有限公司 106 / 189 LTE Standard(A)系列 AT 命令手册 AT+CMGD 删除短消息 测试命令 AT+CMGD=? 设置命令 AT+CMGD=[,] 最大响应时间 特性说明 参考 3GPP TS 27.005 响应 +CMGD: (支持的范围),(支持的范围) OK 响应 OK 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 取决于已删除短消息的存储器 / 参数 整型。相关存储器支持的位置编号。 整型。 0 删除指定的短消息 1 删除存储器中所有的已读短消息 2 删除存储器所有的已读短消息和已发送的短消息 3 删除存储器所有的已读短消息、已发送和未发送的短消息 4 删除存储器所有短消息 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 错误码。参考第 12.6 章。 举例 AT+CMGD=1 OK AT+CMGD=1,4 OK //删除存储器中=1 的短消息。 //删除存储器中所有短消息。 上海移远通信技术股份有限公司 107 / 189 LTE Standard(A)系列 AT 命令手册 9.6. AT+CMGL 按状态读取短消息 该命令用于列举出中的短消息及其状态。若短消息状态为 'REC UNREAD'，则存储器中短消 息的状态将变更为'REC READ'。若执行 AT+CMGL 不设置，模块将上报状态为'REC UNREAD'的 短消息列表。 AT+CMGL 按状态读取短消息 测试命令 AT+CMGL=? 响应 +CMGL: (支持的列表) 设置命令 AT+CMGL[=] OK 响应 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-SUBMIT 和/或 SMS-DELIVER： +CMGL: ,,,[],[][,,][ +CMGL: ,,,[],[][,,][...]] 对于 SMS-STATUS-REPORT： +CMGL: ,,,,[],[],,, [ +CMGL: ,,,,[],[],,, [...]] 对于 SMS-COMMAND： +CMGL: ,,,[ +CMGL: ,,,[...]] 对于 CBM 存储： +CMGL:,,,,, [ +CMGL: ,,,,,[...]] OK 2）PDU 模式（AT+CMGF=0）且该命令执行成功： +CMGL:,,[],[ +CMGL: ,,[], [...]] 上海移远通信技术股份有限公司 108 / 189 LTE Standard(A)系列 AT 命令手册 执行命令 AT+CMGL 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 若错误与 ME 功能相关： +CMS ERROR: 响应 列举短消息存储器的所有已接收但未读的短消息，然后存储 器中短消息的状态变更为'REC READ' 300 毫秒 取决于列举出的短消息所在的存储器 / 参数 1）文本模式，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式，整型。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 整型。相关存储器支持的位置编号。 字 符 串类 型 。目 标地 址 。详 情参 考 3GPP TS 23.040 中 的 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 字符串类型。发送方地址。详情参考 3GPP TS 23.040 中的 TP-Originating-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 字符串类型。字母数字格式的或，对应 MT 电话簿中的条目。该功能的实现按照 出厂设定，所使用的字符集应与 AT+CSCS 选择的字符集相同（详情参考 3GPP TS 27.007 中对该命令的定义）。 字 符 串 类 型 。 短 消 息 服 务 中 心 时 间 戳 。 详 情 参 考 3GPP TS 23.040 TP-Service-Center-Time-Stamp 中的时间字符。（参见） 整型。接收方地址类型。详情参考 3GPP TS 24.011 TP-Recipient-Address 中的八字节 Type-of-Address。 整型。发送方地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address 中的八字节 Type-of-Address。（默认值参考） 上海移远通信技术股份有限公司 109 / 189 LTE Standard(A)系列 AT 命令手册 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示消息体的长度； PDU 模式（AT+CMGF=0）下，以八位字节为单位的实际 TP 数据单元的长度（即 RP 层 的短消息服务中心地址中的八位字符将不计算在该长度内）。 若为短消息，格式参考 3GPP TS 23.040 TP-User-Data： 1. 若为，表示使用 3GPP TS 23.038 GSM 7 位默认字母，表示未设置 3GPP TS 23.040 TP-User-Data-Header-Indication。 2. 若设置 TE 字符集为非 HEX 格式（参见 3GPP TS 27.007 中 AT+CSCS），ME/TA 根 据 3GPP TS 27.007 中附录 A 的规则，将 GSM 字母表转换为当前的 TE 字符集。 3. 若设置 TE 字符集为 HEX 格式，ME/TA 将 GSM 7 位默认字母的每个 7 位字符转换为 两个 IRA 字符的十六进制数字（例如，字符（GSM 7 位默认字母 23）表示 17（IRA 49 和 55））。 4. 若表示使用 8 位或 UCS2 数据编码方案，或者表示已设置 3GPP TS 23.040 TP-User-Data-Header-Indication，ME/TA 将每个八位字节转换为两个 IRA 字符的十六 进制数（例如，将整数值为 42 的八位字节转换为两个字符 2A（IRA 50 和 65）给 TE）。 若为 CBS，3GPP TS 23.041 CBM 文本模式响应中的消息内容；格式： 1. 若为，表示使用 3GPP TS 23.038 GSM 7 位默认字母。 2. 若设置 TE 字符集为非 HEX 格式（参见 3GPP TS 27.007 中 AT+CSCS），ME/TA 根 据 3GPP TS 27.007 中附录 A 的规则，将 GSM 字母表转换为当前的 TE 字符集。 3. 若设置 TE 字符集为 HEX 格式，ME/TA 将 GSM 7 位默认字母的每个 7 位字符转换为 两个 IRA 字符长的十六进制数字。 4. 若表示使用 8 位或 UCS2 数据编码方案：ME/TA 将每个八位字节转换为两个 IRA 字符长的十六进制数。 整型。取决于命令或结果码：3GPP TS 23.040 SMS-DELIVER、SMS-SUBMIT（默认值： 17）、SMS-STATUS-REPORT 或 SMS-COMMAND（默认值：2）的第一个八位字节。 整型。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。详情参考 3GPP TS 23.040 TP-Recipient-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。详情参考 3GPP TS 24.011 TP-Recipient-Address 中的八位字节 Type-of-Address （默认参考）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Service-Centre-Time-Stamp（参见）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Discharge-Time。格式为：'yy/MM/dd, hh:mm:ss+zz'，格式中的字符依次代表年（后两位）、月、日、时、分、秒、时区。例如： 1994 年 5 月 6 日 22:10:00, GMT+2 小时用'94/05/06, 22:10:00+08'表示。 整型。详情参考 3GPP TS 23.040 TP-Status。 整型。详情参考 3GPP TS 23.040 TP-Command-Type（默认为 0）。 整型。详情参考 3GPP TS 23.041 CBM 序号。 整型。详情参考 3GPP TS 23.041 CBM 短消息标识符。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 4~7。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 0~3。 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制 格式；ME/TA 把 TP 数据单元中每八位字节转换为包含 2 个 IRA 字符的十六进制数字（如： 上海移远通信技术股份有限公司 110 / 189 LTE Standard(A)系列 AT 命令手册 整数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 错误码。参考第 12.6 章。 举例 AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, OK //设置短消息为文本模式。 //列举短消息存储器中的所有短消息。 9.7. AT+CMGR 按照索引读取短消息 该命令用于从存储器中读取指定的短消息。若该短消息处于'REC UNREAD'，则存 储器中短消息的状态将变更为'REC READ'。 AT+CMGR 按照索引读取短消息 测试命令 AT+CMGR=? 设置命令 AT+CMGR= 响应 OK 响应 非 CDMA 模式下： 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-DELIVER： +CMGR: ,,[],[,,,,,,,] OK 对于 SMS-SUBMIT： +CMGR: ,,[][,,,,,[],,,] OK 对于 SMS-STATUS-REPORT： 上海移远通信技术股份有限公司 111 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 +CMGR: ,,,[],[],,, OK 对于 SMS-COMMAND： +CMGR: ,,[,,[],[],[], ] OK 对于 CBM 存储： +CMGR: ,,,,, OK 2）PDU 模式（AT+CMGF=0）且该命令执行成功： +CMGR: ,[], OK 若错误与 ME 功能相关： +CMS ERROR: 取决于短消息内容的长度。 / 参数 整型。存储器的位置编号。 1）文本模式，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式，整型。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 上海移远通信技术股份有限公司 112 / 189 LTE Standard(A)系列 AT 命令手册 4 所有短消息 字符串类型。字母数字格式的或，对应 MT 电话簿中的条目。该功能的实现按照 出厂设定，所使用的字符集应与 AT+CSCS 选择的字符集相同（详情参考 3GPP TS 27.007 中对该命令的定义）。 字 符 串 类 型 。 目 标 地 址 。 详 情 参 考 3GPP TS 23.040 中 的 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字符串类型。发送方地址。详情参考 3GPP TS 23.040 中的 TP-Originating-Address Address-Value 字段；BCD 码（GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符 集中的字符（详情参考 TS 27.007 中的 AT+CSCS）。地址类型由指定。 字 符 串 类 型 。 短 消 息 服 务 中 心 时 间 戳 。 详 情 参 考 3GPP TS 23.040 TP-Service-Center-Time-Stamp（参见）。 整型。第一个八位字节。取决于命令或结果码。详情参考 3GPP TS 23.040 SMS-DELIVER、 SMS-SUBMIT（默认为 17）、SMS-STATUS-REPORT 或 SMS-COMMAND 的第一个八位字 节。只要输入过一个有效参数值，则该参数后续可省略。 整型。协议标识符。详情参考 3GPP TS 23.040 TP-Protocol-Identifier。默认值：0。 整型。数据编码方案。取决于命令或结果码。详情参考 3GPP TS 23.038 短消息数据编码方 案（默认值为 0）或小区广播数据编码方案。 整型或时间字符串类型。有效期。取决于 SMS-SUBMIT 的设置。详情参考 3GPP TS 23.040 TP-Validity-Period（参见）。 整型。短消息编号。详情参考 3GPP TS 23.040 TP-Message-Number。 整型。短消息参考。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。详情参考 3GPP TS 23.040 TP-Recipient-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 AT+CSCS）。 地址类型由指定。 整型。详情参考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address（参见）。 整型。接收方地址类型。详情参考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address。 整型。发送方地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address Type-of-Address （默认值参考）。 字符串类型。短消息服务中心地址。详情参考 3GPP TS 24.011 RP SC 地址 Address-Value； BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。短消息服务中心地址类型。详情参考 3GPP TS 24.011 RP SC 地址 Type-of-Address （默认值参考）。 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示消息体（或）的长度； PDU 模式（AT+CMGF=0）下，以八位字节为单位的实际 TP 数据单元的长度（即 RP 层的 短消息服务中心地址中的八位字节将不计算在该长度内）。 短消息的文本内容。详情参见第 12.8 章。 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制格 式：ME/TA 把 TP 数据单元中每八位字节转换为包含 2 个 IRA 字符的十六进制数字（如：整 数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Discharge-Time。格式为：'yy/MM/dd, 上海移远通信技术股份有限公司 113 / 189 LTE Standard(A)系列 AT 命令手册 hh:mm:ss+zz'，格式中的字符依次代表年（后两位）、月、日、时、分、秒、时区。例如： 1994 年 5 月 6 日 22:10:00，GMT+2 小时用'94/05/06, 22:10:00+08'表示。 整型。详情参考 3GPP TS 23.040 TP-Status。 整型。详情参考 3GPP TS 23.040 TP-Command-Type（默认为 0）。 详情参考 3GPP TS 23.040 TP-Command-Data 文本模式响应。ME/TA 把 TP 数据单元中每 八位字节转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值为 42 的八位字节作为两 个字符（2A，即 IRA 50 和 65）发送给 TE）。 整型。序号。 整型。消息标识符。 整型。页面。 整型。总参数位 0~3。 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 错误码。参考第 12.6 章。 举例 +CMTI: 'SM',3 //已收到新短消息，存储在(U)SIM 卡为 3 的位置。 AT+CSDH=1 OK AT+CMGR=3 //读取短消息。 +CMGR: 'REC UNREAD','+8615021012496',,'18/12/15,15:06:37+32',145,4,0,0,'+8613800210500', 145,27 OK 9.8. AT+CMGS 发送短消息 该命令用于将短消息（SMS-SUBMIT）从 TE 发送到网络层。调用设置命令后，返回>后输入待发数据， 然后按 Ctrl+Z 表示 PDU 结束并发送短消息。可按 ESC 取消发送，取消成功也会返回 OK 表示停止发送。 发送成功后，将返回短消息参考值到 TE。可用于根据未经请求的状态结果码识别消息。 AT+CMGS 发送短消息 测试命令 AT+CMGS=? 设置命令 1）文本模式（AT+CMGF=1）： AT+CMGS=[,] 输入文本 响应 OK 响应 1）文本模式（AT+CMGF=1）且发送成功： +CMGS: 上海移远通信技术股份有限公司 114 / 189 LTE Standard(A)系列 AT 命令手册 Ctrl+Z 发送/ ESC 取消发送 2）PDU 模式（AT+CMGF=0）： AT+CMGS= 指定 PDU Ctrl+Z 发送/ ESC 取消发送 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 2）PDU 模式（AT+CMGF=0）且发送成功： +CMGS: OK 若错误与 ME 功能相关： +CMS ERROR: 120 秒，取决于网络状态 / 参数 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address Type-of-Address。 整型。消息体长度。 文本模式（AT+CMGF=1）下，表示（或）的字符长度； PDU 模式（AT+CMGF=0）下，表示八位字节格式的实际 TP 数据单元长度（即 RP 层的短 消息服务中心地址中的八位字节将不计算在该长度内）。 整型。消息参考值。详情参考 3GPP TS 23.040 TP-Message-Reference。 错误码。参考第 12.6 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > +CMGS: 247 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息内容，Ctrl+Z 发送，ESC 取消发送。 上海移远通信技术股份有限公司 115 / 189 LTE Standard(A)系列 AT 命令手册 9.9. AT+CMMS 发送多条短消息 该命令用于控制短消息中断协议链路的连续性。若启用该功能（且当前使用的网络支持），链路保持打 开，此情况下可快速发送多条短消息。 AT+CMMS 发送多条短消息 测试命令 AT+CMMS=? 响应 +CMMS: (支持的范围) 查询命令 AT+CMMS? OK 响应 +CMMS: 设置命令 AT+CMMS= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 120 秒，取决于网络状态 该命令立即生效 参数 整型。是否启用短消息中断协议链路功能。 0 禁用此功能 1 保持该功能启用状态直至要发送的最新命令（AT+CMGS、AT+CMSS 等）的响应与 下一条要发送的命令之间的时间间隔超过 1~5 秒（具体值取决于 ME）。随后 ME 关闭 链路，TA 自动切换为 0。 2 启用该功能。若要发送的最新命令的响应与下一条要发送的命令之间的时间间隔超过 1~5 秒（具体值取决于 ME），ME 关闭链路，但 TA 不会自动切换为 0。 错误码。参考第 12.6 章。 备注 执行查询命令后，请等待 5~10 秒后再执行设置命令，否则，可能会返回错误码+CMS ERROR: 500。 上海移远通信技术股份有限公司 116 / 189 LTE Standard(A)系列 AT 命令手册 9.10. AT+CMGW 存储短消息 该命令用于写入一条短消息（SMS-DELIVER 或 SMS-SUBMIT）并存储至，并返回已存储短 消息的存储位置。通过，可将短消息设置为指定的状态。默认情况下短消息状态设置为 'STO UNSENT'。输入数据语句同 AT+CMGS 的设置命令相同。 AT+CMGW 存储短消息 测试命令 AT+CMGW=? 设置命令 1）文本模式（AT+CMGF=1）： AT+CMGW=[,[,]] >输入文本 Ctrl+Z 发送/ESC 取消发送 2）PDU 模式（AT+CMGF=0）： AT+CMGW=[,] 指定 PDU Ctrl+Z 发送/ESC 取消发送 最大响应时间 响应 OK 响应 若消息写入成功： +CMGW: OK 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 特性说明 / 参考 3GPP TS 27.005 参数 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字 符 串 类 型 。 发 送 方 地 址 。 详 情 参 考 3GPP TS 23.040 TP-Originating-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整 型 。 发 送 方 地 址 类 型 。 详 情 参 考 3GPP TS 24.011 TP-Originating-Address Type-of-Address（默认值参考）。 1）文本模式，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式，整型。 上海移远通信技术股份有限公司 117 / 189 LTE Standard(A)系列 AT 命令手册 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 整型。接收方地址类型。详情参考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address 字段。 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示（或）消息体的字符长度； PDU 模式（AT+CMGF=0）下，表示八位实际 TP 数据单元的长度（即 RP 层的 SMSC 地 址中的八位字符将不计算在该长度内）。 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制 格式；ME/TA 将 TP 数据单元中每八位字符转换为包含 2 个 IRA 字符的十六进制数字（如： 整数取值为 42 的八位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE）。 整型。存储器的短消息序号。 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 错误码。参考第 12.6 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 > //输入短消息文本内容，按 Ctrl+Z 写入短消息，按 ESC 取消发送。 +CMGW: 4 OK AT+CMGF=0 OK AT+CMGW=18 > 0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 //设置短消息模式为 PDU 模式。 OK 上海移远通信技术股份有限公司 118 / 189 LTE Standard(A)系列 AT 命令手册 9.11. AT+CMSS 从存储器发送短消息 该 命 令 用 于 从 存 储 器 中 发 送 指 定 的 短 消 息 （ SMS-SUBMIT ） 。 若 指 定 了 SMS-SUBMIT 短消息接收方地址，则在发送短消息时使用新地址替换存储器中短消息包含的目的地 址。发送成功后，参考值将返回给 TE。非请求发送状态报告结果码的参数值可进行短消息识别。 AT+CMSS 从存储器发送短消息 测试命令 AT+CMSS=? 设置命令 AT+CMSS=[,[,]] 响应 OK 响应 1）文本模式（AT+CMGF=1）且执行成功： +CMSS: [,] OK 2）PDU 模式（AT+CMGF=0）且执行成功： +CMSS: [,] 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 或者 ERROR 若错误与 ME 功能相关： +CMS ERROR: 120 秒，由网络状态决定 / 参数 整型。存储器位置编号。 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）；地址类型由指定。 整 型 。 接 收 方 地 址 类 型 。 详 情 参 考 3GPP TS 24.011 TP-Destination-Address Type-of-Address。 整型。短消息参考。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。服务中心时间戳。详情参考 3GPP TS 23.040 TP-Service-Centre-TimeStamp。（参考） 字符串类型。格式与短消息中的的格式相同，但无 3GPP TS 24.011 SC 中的地址字 上海移远通信技术股份有限公司 119 / 189 LTE Standard(A)系列 AT 命令手册 段。 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 错误码。参考第 12.6 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK AT+CMSS=4 +CMSS: 54 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 // 输入短消息内容，Ctrl+Z 发送短消息，ESC 取消发送。 //从存储器中发送为 4 的短消息。 9.12. AT+CNMA 新短消息确认 该命令用于确认直接发送至 TE 的新消息（SMS-DELIVER 或 SMS-STATUS-REPORT）是否已经成功 发送。若 UE 未在需求时间（网络超时）内收到确认，会发送 RP-ERROR 至网络。UE 可通过设置 AT+CNMI 的参数和为 0 自动禁止发送至 TE。 AT+CNMA 新短消息确认 测试命令 AT+CNMA=? 响应 +CNMA: (支持的范围) 执行命令 AT+CNMA OK 响应 OK 或者 ERROR 设置命令 若错误与 ME 功能相关： +CMS ERROR: 响应 上海移远通信技术股份有限公司 120 / 189 LTE Standard(A)系列 AT 命令手册 AT+CNMA= 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 或者 ERROR 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。PDU 模式所需参数。 0 命令操作类似文本模式 1 发送肯定应答（RP-ACK）至网络，仅 PDU 模式下接受 2 发送否定应答（RP-ERROR）至网络，仅 PDU 模式下接受 错误码。参考第 12.6 章。 备注 仅当 AT+CSMS 中为 1（phase 2+）且模块下发了如下对应 URC 时，方可使用该执行命令和 设置命令： +CMT: =2，新消息类别为 0、1、3 和无 +CMT: =3，新消息类别为 0 和 3 +CDS: =1 举例 AT+CSMS=1 +CSMS: 1,1,1 OK AT+CNMI=1,2,0,0,0 OK +CMT: '+8615021012496',,'18/12/15,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //收到新短消息，直接输出短消息内容。 AT+CNMA //向网络发送确认消息。 OK AT+CNMA +CMS ERROR: 340 //第二次返回错误，仅需确认一次。 上海移远通信技术股份有限公司 121 / 189 LTE Standard(A)系列 AT 命令手册 9.13. AT+CNMI 设置短消息上报方式 该命令用于配置模块收到新短消息时的上报方式。该设置命令选择在 TE 处于活动状态时（DTR 处于 低电平（ON）），从网络接收到的新消息指示给 TE 的方式。如果 TE 处于非活动状态（DTR 处于高电平 （OFF）），则应按照 3GPP TS 23.038 中的规定进行消息接收。 AT+CNMI 设置短消息上报方式 测试命令 AT+CNMI=? 响应 +CNMI: ( 支持的 范围),( 支持的范围),(支持的 列表),(支持的范围),(支持的列表) 查询命令 AT+CNMI? OK 响应 +CNMI: ,,,, 设置命令 AT+CNMI[=[,[,[,[,]]]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。 0 缓冲 TA 中的非请求结果码。若 TA 结果码缓冲区已满，结果码指示可以存储在其他缓 冲区或者丢弃最早的结果码指示，替换为新接收到的指示。 1 若 TA-TE 间的链路被保留（即处于在线数据模式），丢弃指示并拒绝新接收的短消息结 果码指示，否则，直接转发给 TE。 2 若 TA-TE 间的链路被保留（比如：处于在线数据模式），缓冲 TA 中的非请求结果码并 将结果码发送给 TE，否则，直接转发给 TE。 整型。新短消息上报方式。存储接收到的短消息规则取决于其数据编码方案（参考 3GPP TS 23.038）和首选存储器（AT+CPMS）的设置，其值为： 0 不将 SMS-DELIVER 指示发送给 TE。 1 若 SMS-DELIVER 存储至 ME/TA，新短消息提示通过 URC +CMTI: , 上海移远通信技术股份有限公司 122 / 189 LTE Standard(A)系列 AT 命令手册 方式发送给 TE。 2 新短消息 SMS-DELIVER（第 2 类除外）通过 URC +CMT: [], （PDU 模式）或者+CMT: ,[],[,,,,< dcs>,,,]（文本模式），相关参数解释见 AT+ CSDH 命令）或^HCMT: ,,,,,,,, （CDMA 短消息文本模式）方式发送给 TE。第 2 类消息结果 指示如=1 所定义。 3 在收到第 3 类短消息 SMS-DELIVER 时，新短消息通过=2 时定义的 URC 发送给 TE。非第 3 类短消息，新短消息通过=1 时定义的 URC 发送给 TE。 整型。存储接收的 CBM 规则取决于其数据编码方案（详情参考 3GPP TS 23.038）和选择小 区广播消息类型（AT+CSCB）的设置。 0 无 CBM 指示发送到 TE 2 收到的 CBM 使用如下 URC 直接发送到 TE： +CBM: （PDU 模式） 或 +CBM: ,,,,（文本模式） 整型。短消息状态报告的上报方式。 0 不将状态报告 SMS-STATUS-REPORT 发送给 TE 1 状态报告 SMS-STATUS-REPORT 通过如下 URC 上报 TE： +CDS: （PDU 模式） 或者 +CDS: ,,[],[],,,（文本模式） 2 若 SMS-STATUS-REPORT 被存储在 ME/TA，消息状态通过如下 URC 上报 TE： +CDSI: , 整型。 0 当为 1 或 2 时，将 TA 缓冲区的非请求结果码发送至 TE（发送错误码前将返 回 OK）。 1 当为 1 或 2 时，清空 TA 缓冲区的非请求结果码。 错误码。参考第 12.6 章。 备注 URC 说明： +CMTI: , +CMT: [], +CBM: 表示接收到新消息 表示直接输出短消息 表示直接输出小区广播消息 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 上海移远通信技术股份有限公司 123 / 189 LTE Standard(A)系列 AT 命令手册 AT+CNMI=1,2,0,1,0 OK ///设置 SMS-DELIVER 消息直接发送至 TE。 +CMT: '+8615021012496',,'18/12/15,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //收到新短消息，直接输出短消息内容。 9.14. AT+CSCB 选择小区广播消息类型 该命令用于选择 ME 接收到的 CBM 类型。 AT+CSCB 选择小区广播消息类型 测试命令 AT+CSCB=? 响应 +CSCB: (支持的列表) 查询命令 AT+CSCB? OK 响应 +CSCB: ,, 设置命令 AT+CSCB=,[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。表示是否接收由和指定的消息类型。 0 接收 1 不接收 字符串类型。所有可能的 CBM 消息标识的组合（参见）。如'0,1,5,320-478,922'。 字符串类型。所有可能的数据编码方案的组合。如'0-3,5'（参见）。默认值为 空字符串。 错误码。参考第 12.6 章。 上海移远通信技术股份有限公司 124 / 189 LTE Standard(A)系列 AT 命令手册 9.15. AT+CSDH 设置文本模式下参数显示 该命令用于控制是否在文本模式下的结果码中显示详细的报头信息。 AT+CSDH 设置文本模式下参数显示 测试命令 AT+CSDH=? 响应 +CSDH: (支持的列表) 查询命令 AT+CSDH? OK 响应 +CSDH: 设置命令 AT+CSDH= 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。 0 在结果码中不显示下述头信息： 对于文本模式下的 SMS-DELIVER 和 SMS-SUBMIT 类型短消息，+CSCA 和+CSMP 的结果码不包含、、、、和；+CMT、+CMGL 和+CMGR 的结果码中不包含、或。 1 在结果码中显示头信息 举例 AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT' ,'', OK AT+CSDH=1 上海移远通信技术股份有限公司 125 / 189 LTE Standard(A)系列 AT 命令手册 OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 OK 9.16. AT+CSMP 设置短消息文本模式参数 在文本模式下（AT+CMGF=1），当向网络侧发送短消息或将短消息存放在存储器中时，该命令用于设 置需要附加的参数取值。除此之外，还可以用于设置从 SMSC 接收到该短消息时算起的有效期（的取 值范围：0~255）或定义有效期终止的绝对时间（为字符串时）。 AT+CSMP 设置短消息文本模式参数 测试命令 响应 AT+CSMP=? 查询命令 OK 响应 AT+CSMP? +CSMP: ,,, 设置命令 AT+CSMP=[,[,[,]] ]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 ME 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。第一个八位字节。由命令或结果码决定。详情参考 3GPP TS 23.040 SMS-DELIVER、 SMS-SUBMIT（默认为 17）、SMS-STATUS-REPORT 或 SMS-COMMAND 的第一个八位字 节。只要输入过一个有效参数值，则该参数后续可省略。 整型或者字符串类型。有效期。取决于 SMS-SUBMIT 的的设置，详细参考 3GPP TS 23.040 TP-Validity-Period（参考）。默认值：167。 整型。协议标识符。详情参考 3GPP TS 23.040 TP-Protocol-Identifier。默认值：0。 上海移远通信技术股份有限公司 126 / 189 LTE Standard(A)系列 AT 命令手册 整型。数据编码方案。取决于该命令或结果码：3GPP TS 23.038 SMS 数据编码方案（默认 值：0）或小区广播数据编码方案。 错误码。参考第 12.6 章。 9.17. AT+QCMGS 发送级联短消息 该命令用于发送级联短消息。与 AT+CMGS 不同，通过该命令发送一个级联短消息时，每段级联短消 息都必须由附加参数（、和）标识。分段发送所有短消息时，必须多次（由 设置）执行该命令。该命令仅用于文本模式下（AT+CMGF=1）。 AT+QCMGS 发送级联短消息 测试命令 响应 AT+QCMGS=? 设置命令 文本模式（AT+CMGF=1）： AT+QCMGS=[,][,,,] >输入文本 Ctrl+Z 发送/ESC 取消发送 OK 响应 若处于文本模式下（AT+CMGF=1）且命令执行成功： +QCMGS: OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CMS ERROR: 120 秒，由网络决定。 该命令立即生效； 参数配置不保存。 参数 整型。用户数据标头（UDH）中的消息标识。范围：0~255。该参数由用户定义和 输入。同一条级联消息的所有分段必须使用相同的。不同的级联消息应使用 不同的。 整型。级联消息序号。范围：0~7。 =0：忽略该值并将其视为非级联消息。 整型。一条级联消息的分段总数量。范围：0~7。 =0 或 1：忽略该值并将其视为非级联消息。 参见 AT+CMGS。 参见 AT+CMGS。 参见 AT+CMGS。 错误码。参考第 12.6 章。 上海移远通信技术股份有限公司 127 / 189 LTE Standard(A)系列 AT 命令手册 备注 1. 对于级联短消息来说，最大长度将被减少至用户数据报(UDH)的长度。3GPP TS 23.040 定义了两种 UDH 长度：6 字节和 7 字节。因此，两种为 8 位（6 字节）和 16 位（7 字节）。AT+QCMGS 使用 8 位。 ⚫ GSM 7 位默认字母数据编码方案情况下，每个分段级联消息的最大长度为（140 个八位字节 - 6） × 8 / 7 = 153 个字符。 ⚫ 16 位 UCS2 数据编码方案情况下，每个分段级联消息的最大长度为(140 - 6) / 2 = 67 个字符。 ⚫ 8 位数据编码方案情况下，每个分段级联消息的最大长度为 140 – 6 = 134 个字符。 2. 整型，位于 Message-Reference 字段，MS 发送给 SC 的 SMS-SUBMIT 或 SMS-COMMAND 的参考号，用于确认是否已从 SC 副本接收到 SMS-DELIVER。 UDH 字段，级联短消息标识。与不同，每个分段的级联短消息拥有同一个， 但是必须递增。 3. AT+QCMGS 不支持以 PDU 模式(AT+CMGF=0)发送消息。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+QCMGS='15056913384',120,1,2 >ABCD +QCMGS: 190 OK AT+QCMGS='15056913384',120,2,2 >EFGH +QCMGS: 191 OK //设置 SMS 模式为文本模式。 //将字符集设置为 TE 使用的 GSM。 //设置为 120，并发送第一段级联 SMS。 //输入文本。Ctrl+Z 发送，ESC 取消发送。 //发送第二段级联 SMS。 //输入文本。Ctrl+Z 发送，ESC 取消发送。 9.18. AT+QCMGR 读取级联短消息 该命令的功能与 AT+CMGR 相似，但该命令读取的是一个分段级联消息。命令执行完成后，将额外返 回参数：、和。根据这三个参数，可以将几个分段消息级联到同一条消息 中。该命令仅用于文本模式。（AT+CMGF=1） AT+QCMGR 读取级联短消息 测试命令 响应 AT+QCMGR=? 设置命令 OK 响应 上海移远通信技术股份有限公司 128 / 189 LTE Standard(A)系列 AT 命令手册 AT+QCMGR= 最大响应时间 特性说明 若处于文本模式下（AT+CMGF=1）且命令执行成功： 对于 SMS-DELIVER： +QCMGR: ,,[],[,,,,,,,][,,,] OK 对于 SMS-SUBMIT： +QCMGR: ,,[][,,,,,[],,,][,,,< msg_total>] OK 对于 SMS-STATUS-REPORT： +QCMGR: ,,,[],[],,,< st> OK 对于 SMS-COMMAND： +QCMGR: ,,[,,[],[],[],] OK 若错误与 ME 功能相关： +CMS ERROR: 取决于消息内容长度 该命令立即生效； 参数配置自动保存。 参数 整型。用户数据报头（UDH）中的消息标识。范围：0~255。同一条级联消息的所有分 段必须使用相同的。不同的级联消息应使用不同的。 整型。级联消息序号。范围：1~7。 整型。一条级联消息的分段数量。范围：2~7。 其他参数详情，参见 AT+CMGR。 错误码。参考第 12.6 章。 上海移远通信技术股份有限公司 129 / 189 LTE Standard(A)系列 AT 命令手册 备注 1. AT+QCMGR 的与 AT+QCMGS 中的不同。UE 可能会收到 8 位或 16 位的级联消 息。 因此，它的最大值有两种情况：8 位为 255，而 16 位为 65535。 2. 若读取的消息不是级联消息，响应结果中将不显示、和。 举例 +CMTI: 'SM',3 //收到第一条分段级联消息。 +CMTI: 'SM',4 //收到第二条分段级联消息。 AT+QCMGR= 3 //读取第一条分段级联消息。 +QCMGR: 'REC UNREAD','+8615056913384',,'18/12/20,14:44:37+32',120,1,2 ABCD OK AT+QCMGR= 4 //读取第二条分段级联消息。 +QCMGR: 'REC UNREAD','+8615056913384',,'18/12/20,14:44:37+32',120,2,2 EFGH OK 上海移远通信技术股份有限公司 130 / 189 LTE Standard(A)系列 AT 命令手册 10 分组域命令 10.1. AT+CGATT PS 域附着或去附着 该设置命令用于将 MT 附着于 PS 域，或者将 MT 从 PS 域分离。命令完成后，MT 保持在 V.250 命令 状态。如果 MT 已经处于请求状态，则将忽略该命令，并且仍响应 OK。如果 MT 无法实现请求状态，将响 应 ERROR 或+CME ERROR。 AT+CGATT PS 域附着或去附着 测试命令 AT+CGATT=? 响应 +CGATT: (支持的列表) 查询命令 AT+CGATT? OK 响应 +CGATT: 设置命令 AT+CGATT= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 140 秒，取决于网络状态 该命令立即生效； 参数配置不保存。 参数 整型。PS 附着状态。 0 分离状态 1 附着状态 上海移远通信技术股份有限公司 131 / 189 LTE Standard(A)系列 AT 命令手册 设其他值为保留值，设置后将返回 ERROR。 错误码。参考第 12.5 章。 举例 AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //附着到 PS 域。 //从 PS 域分离。 //查询当前 PS 域状态。 10.2. AT+CGDCONT 定义 PDP 上下文 该命令为上下文标识指定 PDP 上下文参数。设置命令的一种特殊形式 AT+CGDCONT=表 示删除对应的 PDP 上下文参数，使其变成未定义。不允许更改已激活上下文的定义。该查询命令返 回每个已定义 PDP 上下文的当前配置。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT: (支持的范围),,,,(支持的范围),(支持的范围),(支持的列表),(支持的范围),(支持的范围),(支持的列表) 查询命令 AT+CGDCONT? OK 响应 +CGDCONT: ,,,,,[…] 设置命令 OK 响应 AT+CGDCONT=[,[,< APN>[,[,[,[,[,[,[,]]]]]]]]] OK 或者 ERROR 最大响应时间 3秒 上海移远通信技术股份有限公司 132 / 189 LTE Standard(A)系列 AT 命令手册 特性说明 参考 3GPP TS 27.007 该命令立即生效； 参数配置自动保存。 参数 整型。PDP 上下文标识，用于指定特定 PDP 上下文的定义。范围：1~15。该参数是 TE-MT 接口的本地参数，在其他与 PDP 上下文相关的命令中使用。允许值的范围由测 试命令返回（最小值为 1）。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 引入虚拟 处理双 IP 堆栈 UE 功能 字符串类型。接入点名称，用于选择 GGSN 或外部分组数据网络的逻辑名称。若该值为 空或省略时，将使用订阅值。 字符串类型。用于标识适用于 PDP 的地址空间中的 MT。如果该值为空或被省略，则 TE 在 PDP 启 动 过 程 中 提 供 该 值 ， 否 则 ， 将 请 求 动 态 地 址 。 可 以 使 用 AT+CGPADDR 读取分配的地址。 整型。控制 PDP 数据是否需要压缩。（仅适用于 SNDCP）（详细说明，请参考 3GPP TS 44.065） 0 关闭（若省略则为默认值） 1 打开（制造商指定） 2 V.42bis 3 V.44（当前不支持） 整型。控制 PDP 头部数据压缩。（详细说明，请参考 3GPP TS 44.065 和 3GPP TS 25.323） 0 关闭（若省略则为默认值） 1 打开 2 RFC1144 3 RFC2507 4 RFC3095 整型。控制 MT/TA 请求获取 IPv4 地址信息的方式 0 通过 NAS 信令获取 IPv4 地址 1 通过 DHCP 获取 IPv4 地址 整型。PDP 上下文的上下文激活请求类型。参见 3GPP TS 24.301 （subclause 6.5.1.2）和 3GPP TS 24.008（subclause 10.5.6.17）。如果支持初始 PDP 上下 文（subclause 10.1.0），则不允许为紧急承载服务分配 =0。根据 3GPP TS 24.008（subclause 4.2.4.2.2 和 4.2.5.1.4）和 3GPP TS 24.301（subclause 5.2.2.3.3 和 5.2.3.2.2），必须为紧急承载服务建立单独的 PDP 上下文。 整型。控制 MT/TA 获取 P-CSCF 地址的方式，详情请参考 3GPP TS 24.229 annex B 和 annex L。 上海移远通信技术股份有限公司 133 / 189 LTE Standard(A)系列 AT 命令手册 0 不受 AT+CGDCONT 影响 1 优先通过 NAS 信令获取 2 优先通过 DHCP 获取 整型。向网络指示 PDP 上下文是否仅用于 IM CN 子系统相关的信令。 0 UE 指示 PDP 上下文不仅用于 IM CN 子系统相关的信令。 1 UE 指示 PDP 上下文仅用于 IM CN 子系统相关的信令。 10.3. AT+CGQREQ 服务质量参数（请求的） 在 MT 激活 PDP 上下文时，该命令允许 MT 指定服务质量配置文件。 该设置命令指定上下文的配置文件。设置命令的一种特殊形式 AT+CGQREQ=会使上下文 标识符请求的参数处于未定义状态。查询命令返回每一个已定义的上下文的当前配置。详细信息请 参考 3GPP TS 23.107。 AT+CGQREQ 服务质量参数（请求的） 测试命令 AT+CGQREQ=? 响应 +CGQREQ: ,(支持的范围),(支持 的范围),(支持的范围),(支持的范 围),(支持的列表) 查询命令 AT+CGQREQ? OK 响应 [+CGQREQ: ,,,,,] [+CGQREQ: ,,,,,] […] 设置命令 AT+CGQREQ=[,[, [,[,[,]]]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 134 / 189 LTE Standard(A)系列 AT 命令手册 参考 3GPP TS 27.007 参数 整型。特定 PDP 上下文的定义。（详情请参考 AT+CGDCONT） 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 引入虚拟 处理双 IP 堆栈 UE 功能 整型。优先等级。 0 网络订阅值 1 优先级高。服务优先级在 2 级和 3 级优先级之前 2 正常优先级。服务优先级在 3 级优先级之前 3 优先级低。继续保持服务 整型。延迟类别。该参数定义通过网络传输 SDU 时发生的端到端传输延迟。详情请参 考表 5。 0 网络订阅值 整型。依赖等级。 0 网络订阅值 1 无法解决数据丢失的非实时流量和对错误敏感的应用程序 2 能够解决非频繁数据丢失的非实时流量和对错误敏感的应用程序 3 能够解决数据丢失、GMM/SM 和 SMS 的非实时流量和对错误敏感的应用程序 4 能够解决数据丢失的实时流量和对错误敏感的应用程序 5 能够解决数据丢失的实时流量和对错误无感的应用程序 整型。峰值吞吐量等级，以每秒八位字节为单位。 0 网络订阅值 1 高达 1 000（8 kbit/s） 2 高达 2 000（16 kbit/s） 3 高达 4 000（32 kbit/s） 4 高达 8 000（64 kbit/s） 5 高达 16 000（128 kbit/s） 6 高达 32 000（256 kbit/s） 7 高达 64 000（512 kbit/s） 8 高达 128 000（1024 kbit/s） 9 高达 256 000（2048 kbit/s） 整型。平均吞吐量等级。以每小时八位字节为单位。 0 网络订阅值 1 100（约 0.22 bit/s） 2 200（约 0.44 bit/s） 3 500（约 1.11 bit/s） 4 1 000（约 2.2 bit/s） 上海移远通信技术股份有限公司 135 / 189 5 2 000（约 4.4 bit/s） 6 5 000（约 11.1 bit/s） 7 10 000（约 22 bit/s） 8 20 000（约 44 bit/s） 9 50 000（约 111 bit/s） 10 100 000（约 0.22 kbit/s） 11 200 000（约 0.44 kbit/s） 12 500 000（约 1.11 kbit/s） 13 1000 000（约 2.2 kbit/s） 14 2 000 000（约 4.4 kbit/s） 15 5 000 000（约 11.1 kbit/s） 16 10 000 000（约 22 kbit/s） 17 20 000 000（约 44 kbit/s） 18 50 000 000（约 111 kbit/s） 31 Best effort 错误码。参考第 12.5 章。 LTE Standard(A)系列 AT 命令手册 表 5：延迟类别 SDU 大小 128 个八位字节 1024 个八位字节 延迟类别 1（预测） 2（预测） 3（预测） 4（Best effort） 1（预测） 2（预测） 3（预测） 4（Best effort） 平均传输延迟 < 0.5 < 5 < 50 未指定 < 0.5 < 5 < 50 未指定 95% < 1.5 < 25 < 250 < 1.5 < 25 < 250 - 10.4. AT+CGQMIN 服务质量参数（最低可接受的） 该命令允许 TE 指定最低可接受的配置文件参数，当激活 PDP 上下文时，由 MT 根据协商的参数检查 该最低可接受的配置文件。设置命令指定上下文标识符标识的上下文的参数。 上海移远通信技术股份有限公司 136 / 189 LTE Standard(A)系列 AT 命令手册 设置命令的一种特殊形式 AT+CGQMIN=会使上下文标识符的最低可接受的配置文件处于 未定义状态，此时将不会对协商的配置文件进行检查。查询命令返回每个已定义 PDP 上下文的当前配置。 详情请参考 3GPP TS 23.107。 AT+CGQMIN 服务质量参数（最低可接受的） 测试命令 AT+CGQMIN=? 响应 +CGQMIN: ,(支持的范围),(支持 的列表),(支持的范围),(支持的范 围),(支持的列表) 查询命令 AT+CGQMIN? OK 响应 [+CGQMIN: ,,,,,] [+CGQMIN: ,,,,,] […] 设置命令 AT+CGQMIN=[,[,< delay>[,[,[, ]]]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。特定 PDP 上下文的定义。（详情请参考 AT+CGDCONT） 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 引入虚拟 处理双 IP 堆栈 UE 功能 整型。优先等级。 0 网络订阅值 上海移远通信技术股份有限公司 137 / 189 LTE Standard(A)系列 AT 命令手册 1 优先级高。服务优先级在 2 级和 3 级优先级之前 2 正常优先级。服务优先级在 3 级优先级之前 3 优先级低。继续保持服务 整型。延迟类别。该参数定义通过网络传输 SDU 时发生的端到端传输延迟。详情请参 考表 5。范围：0~4。单位：秒。 0 网络订阅值 整型。依赖等级。 0 网络订阅值 1 无法解决数据丢失的非实时流量和对错误敏感的应用程序 2 能够解决非频繁数据丢失的非实时流量和对错误敏感的应用程序 3 能够解决数据丢失、GMM/SM 和 SMS 的非实时流量和对错误敏感的应用程序 4 能够解决数据丢失的实时流量和对错误敏感的应用程序 5 能够解决数据丢失的实时流量和对错误无感的应用程序 整型。峰值吞吐量等级，以每秒八位字节为单位。 0 网络订阅值 1 高达 1 000（8 kbit/s） 2 高达 2 000（16 kbit/s） 3 高达 4 000（32 kbit/s） 4 高达 8 000（64 kbit/s） 5 高达 16 000（128 kbit/s） 6 高达 32 000（256 kbit/s） 7 高达 64 000（512 kbit/s） 8 高达 128 000（1024 kbit/s） 9 高达 256 000（2048 kbit/s） 整型。平均吞吐量等级。以每小时八位字节为单位。 0 网络订阅值 1 100（约 0.22 bit/s） 2 200（约 0.44 bit/s） 3 500（约 1.11 bit/s） 4 1 000（约 2.2 bit/s） 5 2 000（约 4.4 bit/s） 6 5 000（约 11.1 bit/s） 7 10 000（约 22 bit/s） 8 20 000（约 44 bit/s） 9 50 000（约 111 bit/s） 10 100 000（约 0.22 kbit/s） 11 200 000（约 0.44 kbit/s） 12 500 000（约 1.11 kbit/s） 13 1000 000（约 2.2 kbit/s） 14 2 000 000（约 4.4 kbit/s） 15 5 000 000（约 11.1 kbit/s） 16 10 000 000（约 22 kbit/s） 17 20 000 000（约 44 kbit/s） 18 50 000 000（约 111 kbit/s） 上海移远通信技术股份有限公司 138 / 189 31 Best effort 错误码。参考第 12.5 章。 LTE Standard(A)系列 AT 命令手册 10.5. AT+CGEQREQ 3G 服务质量参数（请求的） 该命令允许 TE 指定一个 UMTS 服务质量配置文件，该文件用于 MT 激活一个 PDP 上下文。详情可以 参考 3GPP TS 23.107。 AT+CGEQREQ 3G 服务质量参数（请求的） 测试命令 AT+CGEQREQ=? 响应 +CGEQREQ: ,(支持的范围),支 持的列表),(支持的列表),(支持的列表),(支持的 列表),(支持的范 围),(支持的列表),(支持的列表),(支持的列表),(支持的 范 围 ),( 支 持 的 列表),(支持的范围),(支持 的范围),(支持的列表) 查询命令 AT+CGEQREQ? OK 响应 [+CGEQREQ: ,,,, ,< Guaranteed bitrate DL>,,,,, ,,,,] [...] 设置命令 AT+CGEQREQ=[,[,[,[,[,[,[,[, [,[,[,[,<Traffic han OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 139 / 189 LTE Standard(A)系列 AT 命令手册 dling priority>[,[,]]]]]]]]]]]]]]] 最大响应时间 300 毫秒 特性说明 参考 该命令立即生效； 参数配置不保存。 3GPP TS 27.007 参数 整型。PDP 上下文标识符，定义一个特定的 PDP 上下文。该参数是 TE-MT 接口的本地参数，在其他与 PDP 上下文相关的命令中使用。 允许值的范围由测试命令返回（最小值为 1）。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本（IETF STD 5 [103]） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 引入虚拟 处理双 IP 堆栈 UE 功能 以下参数释义可参见 3GPP TS 23.107。 整 型 。 UMTS 承 载 服 务 优 化 的 应 用 类 型 （ 参 见 3GPP TS 24.008 subclause 10.5.6.5）。若指定该参数为会话类业务或流媒体 业务，则应指定、、和。 0 会话类业务 1 流媒体业务 2 交互类业务 3 背景类业务 4 订阅值 整型。一次 SAP 中，上行最大比特率（单位 kbits/s）。 32kbit/s 的比特率为 32（如 AT+CGEQREQ=…,32,…）。 范围：0~256000。 0 订阅值 0~64 64~568 （值必须是 8 的倍数） 568~8640 （值必须是 64 的倍数） 8640~16000 （值必须是 100 的倍数） 16000~128000 （值必须是 1000 的倍数） 128000~256000 （值必须是 2000 的倍数） 整型。一次 SAP 中，下行最大比特率（单位 kbits/s）。 32kbit/s 的比特率为 32（如 AT+CGEQREQ=…,32,…）。 范围： 0~256000。 0 订阅值 上海移远通信技术股份有限公司 140 / 189 LTE Standard(A)系列 AT 命令手册 0~64 64~568 （值必须是 8 的倍数） 568~8640 （值必须是 64 的倍数） 8640~16000 （值必须是 100 的倍数） 16000~128000 （值必须是 1000 的倍数） 128000~256000 （值必须是 2000 的倍数） 整型。一次 SAP 中（只要有数据传输），上行可保证比特率（单 位：kbits/s）。例如，32kbit/s 的比特率为 32（如 AT+CGEQREQ=…,32,…）。范围：0~256000。 0 订阅值 0~64 64~568 （值必须是 8 的倍数） 568~8640 （值必须是 64 的倍数） 8640~16000 （值必须是 100 的倍数） 16000~128000 （值必须是 1000 的倍数） 128000~256000 （值必须是 2000的倍数） 整型。一次 SAP 中（只要有数据传输），下行可保证比特率（单 位：kbits/s）。例如，32kbit/s 的比特率为 32（如 AT+CGEQREQ=…,32,…）。范围：0~256000。 0 订阅值 0~64 64~568 （值必须是 8 的倍数） 568~8640 （值必须是 64 的倍数） 8640~16000 （值必须是 100 的倍数） 16000~128000 （值必须是 1000 的倍数） 128000~256000 （值必须是2000的倍数） 整型。表示UMTS承载是否按照顺序发送SDU （参见3GPP TS 24.008 subclause 10.5.6.5） 0 无顺序性 1 有顺序性 2 订阅值 整型。（1、2、3、…）。八位字节格式下允许的最大SDU长度。0 表示请求订阅值。（参见3GPP TS 24.008 subclause 10.5.6.5）。 0 订阅值 10~520 （该值需为10的倍数） 1520 字符串类型。表示丢失或检测到的 SDU 误码率目标值。SDU 误码率 仅针对符合的流量定义。该值指定为'mEe'。 例如，若目标 SDU 错误率为 5 × 10-3，则可以将其设置为'5E3'（例如， AT+CGEQREQ=…,'5E3',…）。 '0E0' 订阅值 '1E1' '1E2' '7E3' 上海移远通信技术股份有限公司 141 / 189 LTE Standard(A)系列 AT 命令手册 '1E3' '1E4' '1E5' '1E6' 字符串类型。表示传输的 SDU 中未检测到的误码率目标值。如果 没有请求错误检测，残余误码率表示传输的 SDU 中的误码率。 该值指定为'mEe'。例如，若目标残余误码率为 5 × 10-3，则 将其设置为'5E3'（例如，AT+CGEQREQ=…,'5E3',…） '0E0' 订阅值 '5E2' '1E2' '5E3' '4E3' '1E3' '1E4' '1E5' '1E6' '6E8' 整型。表示是否发送检测到的错误的 SDU。（参见 3GPP TS 24.008 subclause 10.5.6.5）。 0 不发送 1 发送 2 未检测 3 订阅值 整型。（0、1、2、…）。表示将一个SAP的SDU请求传输至另一个 SAP的目标时间。单位：毫秒。若参数设为0，则将请求订阅值（参 见3GPP TS 24.008 subclause 10.5.6.5）。 0 订阅值 100~150 （该值需为10的倍数） 200~950 （该值需为50的倍数） 1000~4000 （该值需为100的倍数） 整型。（1、2、3、…）。与其他承载的SDU相比，处理属于UMTS 承载的所有SDU的优先级。若参数设为0，则将请求订阅值（参见 3GPP TS 24.008 subclause 10.5.6.5）。 0 订阅值 1 2 3 整型。指定PDP上下文提交的SDU的特性。 0 未知的SDU特性 1 基于源语的SDU特性 整型。指定PDP上下文提交的SDU的信令内容。 0 PDP上下文未针对信令进行优化 1 PDP上下文针对信令进行了优化 上海移远通信技术股份有限公司 142 / 189 错误码。参考第12.5章。 LTE Standard(A)系列 AT 命令手册 10.6. AT+CGEQMIN 3G 服务质量参数（最低可接受） 该命令允许 TE 指定最低可接受的参数，由 MT 根据建立和修改 PDP 上下文过程中返回的协商参数进 行检查。详情请参考 3GPP TS 23.107。 AT+CGEQMIN 3G 服务质量参数（最低可接受） 测试命令 AT+CGEQMIN=? 响应 +CGEQMIN: ,(支持的范围),(支 持的范围),(支持的范围),(支持的范围),(支持的 范围),(支持的范 围),(支持的列表),(支持的列表),(支持的列表),(支持的 范 围 ),( 支 持 的 列表),(支持的范围),(支持 的列表),(支持的列表) 查询命令 AT+CGEQMIN? OK 响应 [+CGEQMIN: ,,,,,,,,,,< Delivery of erroneous SDUs>,,,,] […] 设置命令 AT+CGEQMIN=[, [,[,[,[,[,[,[,< SDU error ratio>[,[,[,[,<Traffic hand OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 143 / 189 LTE Standard(A)系列 AT 命令手册 ling priority>[,[,]]]]]]]]]]]]]]] 最大响应时间 300 毫秒 特性说明 参考 该命令立即生效； 参数配置不保存。 3GPP TS 27.007 Parameter 整型。PDP 上下文标识符，定义一个特定的 PDP 上下文。该参数是 TE-MT 接口的本地参数，在其他与 PDP 上下文相关的命令中使用。 允许值的范围由测试命令返回（最小值为 1）。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本（IETF STD 5 [103]） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 引入虚拟 处理双 IP 堆栈 UE 功能 以下参数释义可参见 3GPP TS 23.107。 整 型 。 UMTS 承 载 服 务 优 化 的 应 用 类 型 （ 参 见 3GPP TS 24.008 subclause 10.5.6.5）。若指定该参数为会话类业务或流媒体 业务，则应指定、、和。 0 会话类业务 1 流媒体业务 2 交互类业务 3 背景类业务 4 订阅值 整型。一次 SAP 中，上行最大比特率（单位 kbits/s）。 32kbit/s 的比特率为 32（如 AT+CGEQREQ=…,32,…）。 范围：0~256000。 0 订阅值 0~64 64~568 （值必须是 8 的倍数） 568~8640 （值必须是 64 的倍数） 8640~16000 （值必须是 100 的倍数） 16000~128000 （值必须是 1000 的倍数） 128000~256000 （值必须是 2000 的倍数） 整型。一次 SAP 中，下行最大比特率（单位 kbits/s）。 32kbit/s 的比特率为 32（如 AT+CGEQREQ=…,32,…）。 范围： 0~256000。 0 订阅值 上海移远通信技术股份有限公司 144 / 189 LTE Standard(A)系列 AT 命令手册 0~64 64~568 （值必须是 8 的倍数） 568~8640 （值必须是 64 的倍数） 8640~16000 （值必须是 100 的倍数） 16000~128000 （值必须是 1000 的倍数） 128000~256000 （值必须是 2000 的倍数） 整型。一次 SAP 中（只要有数据传输），上行可保证比特率（单 位：kbits/s）。例如，32kbit/s 的比特率为 32（如 AT+CGEQREQ=…,32,…）。范围：0~256000。 0 订阅值 0~64 64~568 （值必须是 8 的倍数） 568~8640 （值必须是 64 的倍数） 8640~16000 （值必须是 100 的倍数） 16000~128000 （值必须是 1000 的倍数） 128000~256000 （值必须是 2000的倍数） 整型。一次 SAP 中（只要有数据传输），下行可保证比特率（单 位：kbits/s）。例如，32kbit/s 的比特率为 32（如 AT+CGEQREQ=…,32,…）。范围：0~256000。 0 订阅值 0~64 64~568 （值必须是 8 的倍数） 568~8640 （值必须是 64 的倍数） 8640~16000 （值必须是 100 的倍数） 16000~128000 （值必须是 1000 的倍数） 128000~256000 （值必须是2000的倍数） 整型。表示UMTS承载是否按照顺序发送SDU （参见3GPP TS 24.008 subclause 10.5.6.5） 0 无顺序性 1 有顺序性 2 订阅值 整型。（1、2、3、…）。八位字节格式下允许的最大SDU长度。0 表示请求订阅值。（参见3GPP TS 24.008 subclause 10.5.6.5）。 0 订阅值 10~520 （该值需为10的倍数） 1520 字符串类型。表示丢失或检测到的 SDU 误码率目标值。SDU 误码率 仅针对符合的流量定义。该值指定为'mEe'。 例如，若目标 SDU 错误率为 5 × 10-3，则可以将其设置为'5E3'（例如， AT+CGEQREQ=…,'5E3',…）。 '0E0' 订阅值 '1E2' '7E3' '1E3' 上海移远通信技术股份有限公司 145 / 189 LTE Standard(A)系列 AT 命令手册 '1E4' '1E5' '1E6' '1E1' 字符串类型。表示传输的 SDU 中未检测到的误码率目标值。如果 没有请求错误检测，残余误码率表示传输的 SDU 中的误码率。 该值指定为'mEe'。例如，若目标残余误码率为 5 × 10-3，则 将其设置为'5E3'（例如，AT+CGEQREQ=…,'5E3',…） '0E0' 订阅值 '5E2' '1E2' '5E3' '4E3' '1E3' '1E4' '1E5' '1E6' '6E8' 整型。表示是否发送检测到的错误的 SDU。（参见 3GPP TS 24.008 subclause 10.5.6.5）。 0 不发送 1 发送 2 未检测 3 订阅值 整型。（0、1、2、…）。表示将一个SAP的SDU请求传输至另一个 SAP的目标时间。单位：毫秒。若参数设为0，则将请求订阅值（参 见3GPP TS 24.008 subclause 10.5.6.5）。 0 订阅值 100~150 （该值需为10的倍数） 200~950 （该值需为50的倍数） 1000~4000 （该值需为100的倍数） 整型。（1、2、3、…）。与其他承载的SDU相比，处理属于UMTS 承载的所有SDU的优先级。若参数设为0，则将请求订阅值（参见 3GPP TS 24.008 subclause 10.5.6.5）。 0 订阅值 1 2 3 整型。指定PDP上下文提交的SDU的特性。 0 未知的SDU特性 1 基于源语的SDU特性 整型。指定PDP上下文提交的SDU的信令内容。 0 PDP上下文未针对信令进行优化 1 PDP上下文针对信令进行了优化 上海移远通信技术股份有限公司 146 / 189 错误码。参考第12.5章。 LTE Standard(A)系列 AT 命令手册 10.7. AT+CGACT PDP 上下文激活/去激活 该设置命令用于激活或去激活指定的 PDP 上下文。命令设置完成后，MT 保持 V.250 命令状态。若任 意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；在执行激活命令时，如果 MT 没有附着 PS，则 MT 会先进行 PS 附着，然后尝试激活指定的上下文。如果无指定激活或去激活命令时，将会 激活或去激活所有定义的上下文。 AT+CGACT 测试命令 AT+CGACT=? PDP 上下文激活/去激活 响应 +CGACT: (支持的列表) 查询命令 AT+CGACT? OK 响应 +CGACT: ,[ +CGACT: ,…] 设置命令 AT+CGACT=, OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现与 ME 功能相关的错误： +CME ERROR: 150 秒，取决于网络状态 该命令立即生效； 参数配置不保存。 参数 整型。PDP 上下文激活状态。 0 去激活 1 激活 设置命令中其它值为预留值，设置后将返回 ERROR。 整型。指定 PDP 上下文的定义。（详情请参考 AT+CGDCONT）。 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 147 / 189 举例 AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGACT=0,1 OK LTE Standard(A)系列 AT 命令手册 //定义 PDP 上下文。 //激活 PDP。 //去激活 PDP。 10.8. AT+CGDATA 进入数据传输状态 执行设置命令后，MT 将使用一种或多种分组域 PDP 类型进行操作，使 TE 与网络之间建立通信，可 能也会包括进行 PS 附着及一个或多个 PDP 上下文激活操作。MT 不会处理 AT 命令行中 AT+CGDATA 之 后的命令。 若 MT 无法接收的值，将返回 ERROR 或+CME ERROR。若可以接收，MT 将返回中间结果代 码 CONNECT 并进入 V.250 在线数传状态。数据传输完成且第二层协议终止流程已成功完成后，将重新进 入命令状态，MT 将返回最终结果代码 OK。 AT+CGDATA 进入数据传输状态 测试命令 AT+CGDATA=? 响应 +CGDATA: (支持的列表) 设置命令 AT+CGDATA=[,[,[,… ]]] OK 响应 CONNECT 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现与 ME 功能相关的错误： +CME ERROR: 300 毫秒 / 参数 字符串类型。TE 和 MT 间使用的第二层协议。 PPP PDP 的点对点协议（例如 IP）。 不支持其他值，若配置为其他值，将返回 ERROR。 上海移远通信技术股份有限公司 148 / 189 LTE Standard(A)系列 AT 命令手册 整型。特定 PDP 上下文的定义。（详情请参考 AT+CGDCONT）。 错误码。参考第 12.5 章。 10.9. AT+CGPADDR 显示 PDP 地址 该设置命令返回指定上下文标识符的 PDP 地址列表。若未指定，则返回所有已定义上下文的地 址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (支持的已定义的列表) 设置命令 AT+CGPADDR[=[,[,…]]] OK 响应 +CGPADDR: , [+CGPADDR: ,[…]] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 或者 ERROR 300 毫秒 / 参数 整型。特定 PDP 上下文的定义。（详情请参考 AT+CGDCONT）。 字符串类型。PDP 地址，用于在适用于 PDP 的地址空间中识别 TE。 地址可以为静态或动态： 静态地址在定义上下文时由 AT+CGDCONT 设置。 动态地址在上一次 PDP 上下文激活（使用了指定的上下文定义）期间分配。若 无可用的地址，则省略。 举例 AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK //定义 PDP 上下文。 //激活 PDP。 上海移远通信技术股份有限公司 149 / 189 AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' OK //显示 PDP 地址。 LTE Standard(A)系列 AT 命令手册 10.10. AT+CGCLASS GPRS 移动站点等级 该命令使 MT 按照指定的操作模式进行操作。详情请参考 3GPP TS 23.060。 AT+CGCLASS GPRS 移动站点等级 测试命令 AT+CGCLASS=? 响应 +CGCLASS: (支持的列表) 查询命令 AT+CGCLASS? OK 响应 +CGCLASS: 设置命令 AT+CGCLASS= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。GPRS 移动等级（功能按降序排列） 'A' Class-A 操作模式（A/Gb 模式）或 CS/PS 操作模式（Iu 模式）（最高级操作模式） 错误码。参考第 12.5 章。 上海移远通信技术股份有限公司 150 / 189 LTE Standard(A)系列 AT 命令手册 10.11. AT+CGREG PS 域网络注册状态 该命令用于查询 PS 域网络注册状态并控制非请求结果码上报： ⚫ =1 时，控制 URC +CGREG: 的上报，该 URC 表示 PS 域网络注册状态的变化。 ⚫ =2 时，控制 URC +CGREG: [,,[,]]的上报，该 URC 表示 PS 域的网络 小区的变化。 AT+CGREG PS 域网络注册状态 测试命令 AT+CGREG=? 响应 +CGREG: (支持的范围) 查询命令 AT+CGREG? OK 响应 +CGREG: ,[,,[,]] 设置命令 AT+CGREG[=] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。控制指定 URC 的上报 0 禁止上报网络注册 URC 1 允许上报网络注册 URC +CGREG: 2 允许上报网络注册和位置信息 URC：+CGREG: [,,[,]] 整型。网络注册状态。 0 未注册。MT 当前未搜索待注册的运营商。UE 处于 GMM 状态 GMM-NULL 或 GMM-DEREGISTERED-INITIATED。网络服务被禁用，但允许用户请求附着网络。 1 已注册，归属地网络。UE 处于归属地 PLMN 的 GMM 状态 GMM-REGISTERED 或 GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED。 2 未 注 册， 但 MT 当 前正 尝试 附 着或 搜索 网 络以进 行 注册 。UE 处于 GMM 状态 GMM-DEREGISTERED 或 GMM-REGISTERED-INITIATED。网络服务已使能，但允 许的 PLMN 当前不可用。UE 将会在允许的 PLMN 可用时开始附着网络。 3 注册被拒绝。UE 处于 GMM 状态 GMM-NULL。网络服务为禁用状态且不允许用户请求 上海移远通信技术股份有限公司 151 / 189 LTE Standard(A)系列 AT 命令手册 附着网络。 4 未知 5 已注册，漫游状态 字符串类型。十六进制格式的两字节位置区号（例如：'00C3'等价于十进制的 195） 字符串类型。十六进制格式的 16 位（GSM）或 28 位（UMTS/LTE）小区 ID。 整型。已选网络制式。 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA 和 HSUPA 7 E-UTRAN 举例 AT+CGREG=2 OK AT+CGATT=0 OK +CGREG: 2 AT+CGATT=1 OK +CGREG: 1,'D504','80428B5',7 10.12. AT+CGEREP 分组域事件上报 在某些事件发生在分组域 MT 或网络中的情况下，该设置命令启用/禁用从 MT 发送非请求结果码 +CGEV: XXX 至 TE。控制该命令指定的非请求结果码的流程。当=1 或 2 时，控制 缓存的主动上报行为策略。 AT+CGEREP 分组域事件上报 测试命令 AT+CGEREP=? 响应 +CGEREP: (支持的列表),(支持的列表) 查询命令 AT+CGEREP? OK 响应 +CGEREP: , 上海移远通信技术股份有限公司 152 / 189 LTE Standard(A)系列 AT 命令手册 设置命令 AT+CGEREP=[,] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。控制该命令中指定的非请求结果码的处理。 0 缓存 MT 中的非请求结果码；若 MT 结果码缓存已满，最早的非请求结果码将被丢弃。 结果码将不会转发至 TE。 1 当 MT-TE 间的链路被占用（例如：在线数据模式下），丢弃非请求结果码。否则，直 接转发给 TE。 2 当 MT-TE 间的链路被占用（例如：在线数据模式下），缓存 MT 中的非请求结果码，并 当链路可用时发送所有缓存的非请求结果码至 TE。否则，直接转发至 TE。 整型。控制缓存代码。 0 当为 1 或 2 时，清除了此命令定义的非请求结果码的 MT 缓存。 1 当为 1 或 2 时，在此命令中定义的非请求结果码的 MT 缓存被发送至 TE（返回 OK 后发送）。 备注 非请求结果码及其对应的事件定义如下： 1. +CGEV: REJECT ,：当MT无法通过非请求结果码+CRING将PDP上下文 激活事件上报TE且MT被自动拒绝时将向网络请求激活PDP上下文。 备注：该事件不适用于EPS。 2. +CGEV: NW REACT ,,[]：网络已经请求上下文重新激活。若MT 已知悉，则会提供用于重新激活上下文的。 备注：该事件不适用于EPS。 3. +CGEV: NW DEACT ,,[]：网络强制去激活上下文。若MT知悉 ，则会提供用于激活上下文的。 4. +CGEV: ME DEACT ,,[]：移动终端已强制去激活了上下文。若MT 已知悉，则会提供用于激活上下文的。 5. +CGEV: NW DETACH：网络已强制去附着分组域，表示已经去激活所有的已激活的上下文。去激 活的上下文不会分开上报。 6. +CGEV: ME DETACH：移动终端已强制去附着分组域，表示已经去激活所有的已激活的上下文。 去激活的上下文不会分开上报。 上海移远通信技术股份有限公司 153 / 189 LTE Standard(A)系列 AT 命令手册 7. +CGEV: NW CLASS ：网络已强制更换MS等级，且上报最高可用级别。（详情请参考 AT+CGCLASS）。 8. +CGEV: ME CLASS ：移动终端已强制更换MS等级，且上报最高可用级别。（详情请参考 AT+CGCLASS）。 9. +CGEV: PDN ACT ：已激活上下文。该上下文表示LTE的PDN连接或GSM/UMTS的第一个 PDP上下文。 10. +CGEV: PDN DEACT ：去激活上下文。该上下文表示LTE的PDN连接或GSM/UMTS的第一 个PDP上下文。 举例 AT+CGEREP=? +CGEREP: (0-2),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK 10.13. AT+CGSMS 选择 MO 短消息服务 该命令用于指定 MT 用于发送 MO（移动终端）短消息的服务或优选服务。 AT+CGSMS 选择 MO 短消息服务 测试命令 AT+CGSMS=? 响应 +CGSMS: (当前可用的列表) 查询命令 AT+CGSMS? OK 响应 +CGSMS: 设置命令 AT+CGSMS=[] OK 响应 OK 最大响应时间 特性说明 若错误与 ME 相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 154 / 189 LTE Standard(A)系列 AT 命令手册 参考 3GPP TS 27.007 参数 整型。使用的服务或优选服务。 0 GPRS 1 电路交互数据格式 2 优选 GPRS（GPRS 不可用时使用电路交互数据格式） 3 优选电路交互数据格式（电路交互数据格式不可用时使用分组域） 错误码。参考第 12.5 章。 10.14. AT+CEREG EPS 网络注册状态 该命令用于查询网络注册状态并控制网络注册状态的非请求结果码的上报。 ⚫ =1 时，控制 URC +CEREG: 的上报，该 URC 表示 E-UTRAN 中 MT 的 EPS 网络注册 状态的变化。 ⚫ =2 时，控制 URC +CEREG: [,,[,]]的上报，该 URC 表示 E-UTRAN 中的网络小区的变化。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 响应 +CEREG: (支持的列表) 查询命令 AT+CEREG? OK 响应 +CEREG: ,[,,[,]] 设置命令 AT+CEREG[=] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 上海移远通信技术股份有限公司 155 / 189 LTE Standard(A)系列 AT 命令手册 参数 整型。控制非请求结果码的显示。 0 禁止上报网络注册 URC 1 允许上报网络注册 URC +CEREG: 2 允许上报网络注册和位置信息 URC +CEREG: [,,[,]] 整型。EPS 注册状态。 0 未注册。MT 当前未搜索到待注册的运营商。 1 已注册，归属地网络。 2 未注册，但 MT 当前正尝试附着或搜索网络以进行注册。 3 注册被拒绝。 4 未知。 5 已注册，漫游状态。 字符串类型。十六进制格式的两字节位置区号。 字符串类型。十六进制格式的 28 字节（E-UTRAN）小区 ID。 整型。注册网络的接入技术。 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 10.15. AT+QGDCNT 流量统计 该命令用于查询模块发送或接收的字节数。 AT+QGDCNT 流量统计 测试命令 AT+QGDCNT=? 响应 +QGDCNT: (支持的列表) 查询命令 AT+QGDCNT? OK 响应 +QGDCNT: , 设置命令 AT+QGDCNT= OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 156 / 189 LTE Standard(A)系列 AT 命令手册 最大响应时间 特性说明 若错误与 ME 相关： +CME ERROR: 300 毫秒 / 参数 整型。数据操作类型。 0 重置数据 1 保存数据结果到 NV，若需要自动保存结果，请参考 AT+QAUGDCNT。 整型。发送流量大小。 整型。接收流量大小。 错误码。参考第 12.5 章。 备注 模块开机后从 NV 中的数据计数器结果中加载和。NV 中的默认结果为 0。 举例 AT+QGDCNT=? +QGDCNT: (0,1) //测试命令 OK AT+QGDCNT? //查询发送或接收的字节数 +QGDCNT: 3832,4618 OK AT+QGDCNT=1 OK AT+QGDCNT=0 OK //保存结果至 NV //重启数据计数器 上海移远通信技术股份有限公司 157 / 189 LTE Standard(A)系列 AT 命令手册 10.16. AT+QAUGDCNT 自动保存流量统计 该命令允许 AT+QGDCNT 自动将流量统计结果保存至 NV。 AT+QAUGDCNT 自动保存流量统计 测试命令 AT+QAUGDCNT=? 响应 +QAUGDCNT: (支持的列表) 查询命令 AT+QAUGDCNT? OK 响应 +QAUGDCNT: 设置命令 AT+QAUGDCNT= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。AT+QGDCNT 自动将结果保存至 NV 的时间间隔。范围：0、30~65535； 默认值：0；单位：秒。若设置为 0，则禁用自动保存功能。 错误码。参考第 12.5 章。 举例 AT+QAUGDCNT=? //测试命令 +QAUGDCNT: (0,30-65535) OK AT+QAUGDCNT=35 OK AT+QAUGDCNT? +QAUGDCNT: 35 //设置 AT+QGDCNT 自动保存流量统计结果的时间间隔为 35 秒 //查询自动保存的时间间隔 上海移远通信技术股份有限公司 158 / 189 LTE Standard(A)系列 AT 命令手册 OK 10.17. AT+QNETDEVCTL 连接 USB 网卡 该命令用于连接 USB 网卡进行网卡拨号。 AT+QNETDEVCTL 连接 USB 网卡 测试命令 AT+QNETDEVCTL=? 响应 +QNETDEVCTL: (支持的列表),(支持的范围),(支持的 范围) 查询命令 AT+QNETDEVCTL? OK 响应 +QNETDEVCTL: ,,, 设置命令 OK 响应 AT+QNETDEVCTL=, OK [,] 或者 ERROR 最大响应时间 特性说明 若错误与 ME 相关： +CME ERROR: 2秒 该命令立即生效。 当=3 时，参数配置自动保存。 参数 整型。操作类型。 0 断开网卡连接 1 仅连接网卡一次 3 自动连接网卡 整型。PDP 的上下文。范围：1~15。该参数指定一个目标 PDP 上下文，用于其他 和 PDP 上下文相关的命令中。 整型。是否开启 URC +QNETDEVSTATUS: 上报。 0 关闭 1 开启 整型。网卡连接状态。 0 网卡与网络断开连接 上海移远通信技术股份有限公司 159 / 189 LTE Standard(A)系列 AT 命令手册 1 网卡与网络连接成功 整型。网络连接状态 0 未连接 1 已连接 错误码。参考第 12.5 章。 举例 AT+QNETDEVCTL? +QNETDEVCTL: (0,1,3) ,(1–15),(0,1) OK AT+QNETDEVCTL=1,1,1 OK AT+QNETDEVCTL? +QNETDEVCTL: 1,1,1,1 //设置网卡拨号方式为手动连接，使用第一路 PDP，开启 URC 上报 //查询 USB 网卡状态 OK 上海移远通信技术股份有限公司 160 / 189 LTE Standard(A)系列 AT 命令手册 11 硬件相关命令 11.1. AT+QPOWD 关闭模块 该命令用于关闭模块。命令执行成功后立即返回 OK，随后 UE 注销网络。注销完成后 UE 输出 POWERED DOWN 并进入关机状态。注销网络最大时长为 60 秒。为避免数据丢失，在输出 POWERED DOWN 或拉低模块 STATUS 引脚之前，不能断开 UE 电源。 AT+QPOWD 关闭模块 测试命令 AT+QPOWD=? 响应 +QPOWD: (支持的列表) 设置命令 AT+QPOWD[=] OK 响应 OK 最大响应时间 特性说明 POWERED DOWN 300 毫秒 / 参数 整型。模块关机。 0 立即关机 1 正常关机 11.2. AT+CCLK 实时时钟 该命令用于设置和查询模块实时时钟（RTC）。 AT+CCLK 实时时钟 测试命令 响应 上海移远通信技术股份有限公司 161 / 189 LTE Standard(A)系列 AT 命令手册 AT+CCLK=? 查询命令 AT+CCLK? 设置命令 AT+CCLK= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 +CCLK: OK 响应 OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。格式：'yy/MM/dd,hh:mm:ss±zz'，分别表示年（最后两位）、月、日、小时、分 钟、秒和时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异；范围：-48 ~ +56）。例如， 1994 年 5 月 6 日 22:10:00 GMT + 2 小时等于'94/05/06,22:10:00+08'。 错误码。参考第 12.5 章。 举例 AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //查询本地时间。 11.3. AT+QSCLK 禁用/启用睡眠模式 该命令用于控制模块是否进入睡眠模式。若设置=1，DTR 和 WAKEUP_IN 引脚均被拉高时，模块 将直接进入睡眠模式。若 DTR 和 WAKEUP_IN 引脚均被拉低，模块无法进入睡眠模式，仅当 DTR 和 WAKEUP_IN 引脚均被拉高时，模块方可进入睡眠模式。 AT+QSCLK 禁用/启用睡眠模式 测试命令 AT+QSCLK=? 响应 +QSCLK: (支持的列表) 上海移远通信技术股份有限公司 162 / 189 查询命令 AT+QSCLK? 设置命令 AT+QSCLK= 最大响应时间 特性说明 参考 Quectel OK 响应 +QSCLK: OK 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。禁用/启用睡眠模式。 0 禁用 1 启用。由 DTR 和 WAKEUP_IN 控制。 LTE Standard(A)系列 AT 命令手册 上海移远通信技术股份有限公司 163 / 189 LTE Standard(A)系列 AT 命令手册 12 附录 12.1. 术语缩写 表 6：术语缩写 缩写 英文全称 中文全称 3GPP 3rd Generation Partnership Project 第三代合作伙伴计划 ACK Acknowledgement 确认消息 AMR Adaptive Multi-Rate 自适应多速率 APN Access Point Name 接入点名称 ASCII American Standard Code for Information Interchange 美国信息交换标准码 BAIC Bar All Incoming Calls 禁止所有来电 BAOC Bar All Outgoing Calls 禁止所有呼出 BCD Binary-Coded Decimal 二进制编码的十进数 BIC Roam Bar Incoming Calls when Roaming outside the home 在归属地以外漫游时禁止所有来 country 电 BOIC Bar Outgoing International Calls 禁止所有国际呼出 BOIC-exHC Bar Outgoing International Calls except to Home 禁止除归属地国家外的国际呼出 Country CBM Cell Broadcast Message 小区广播消息 CBS Cell Broadcast Service 小区广播服务 COL Connected Line 被叫线路 CS Circuit Switched/Circuit Switching 电路交换 CSD Circuit Switched Data 电路交换数据 上海移远通信技术股份有限公司 164 / 189 LTE Standard(A)系列 AT 命令手册 CUG DCD DCE DCS DHCP DTE DTR ECT EDGE EGPRS EPS ESM E-UTRAN FDD GGSN GMM GMT GPIO GPRS GSM HLR HSDPA HSPA+ HSUPA ICCID Closed User Group Data Carrier Detection Data Circuit-terminating Equipment Data Coding Scheme Dynamic Host Configuration Protocol Data Terminal Equipment Data Terminal Ready Explicit Call Transfer Enhanced Data Rates for GSM Evolution Enhanced General Packet Radio Service Evolved Packet System EPS Session Management Evolved Universal Terrestrial Radio Access Network Frequency Division Duplex Gateway GPRS Support Node GPRS Mobility Management Greenwich Mean Time General-Purpose Input/Output General Packet Radio Service Global System for Mobile Communications Home Location Register High Speed Downlink Packet Access High Speed Packet Access High Speed Uplink Packet Access Integrated Circuit Card Identifier 闭合用户群 数据载波检测 数据电路终端设备 数据编码方案 动态主机设置协议 数据终端设备 数据终端就绪 呼叫转接 增强型数据速率 GSM 演进技术 增强型数据速率 GSM 演进技术 演进型分组系统 EPS 会话管理 演进型通用陆地无线接入网 频分双工 网关 GPRS 支持节点 GPRS 移动性管理 格林威治时间 通用型输入/输出 通用分组无线业务 全球移动通信系统 归属位置寄存器 高速下行分组接入 增强高速分组接入 高速上行分组接入 集成电路卡识别码 上海移远通信技术股份有限公司 165 / 189 LTE Standard(A)系列 AT 命令手册 IMEI IMSI IP IPv4 IPv6 IRA LLC LTE ME MO MS MSISDN MT NAS NIC NITZ NSAPI NV P-CSCF PDN PDP PDU PIN PLMN PPP International Mobile Equipment Identity 国际移动设备识别码 International Mobile Subscriber Identity 国际移动用户识别码 Internet Protocol 互联网协议 Internet Protocol version 4 第 4 版互联网协议 Internet Protocol version 6 第 6 版互联网协议 International Reference Alphabet (7-bit coded 7-bit 国际参考字母编码字符集 character set) Logical Link Control 逻辑链路控制 Long-Term Evolution 长期演进 Mobile Equipment 移动设备 Mobile Original 移动主叫 Mobile Station 移动台 Mobile Subscriber International Integrated Service 移动台国际用户识别码 Digital Network number Mobile Terminal 移动终端 Non-Access Stratum 非接入层 Network Interface Controller 网络接口控制器 Network Identity and Time Zone / Network Informed 网络标识和时区 Time Zone Network Service Access Point Identifier 网络服务接入点标识符 Non-Volatile Random Access Memory 非易失性存储器 Proxy-Call Session Control Function 代理呼叫会话控制功能 Public Data Network 公用数据网络 Packet Data Protocol 分组数据协议 Protocol Data Unit 协议数据单元 Personal Identification Number 个人识别号 Public Land Mobile Network 公共陆地移动网络 Point-to-Point Protocol 点到点协议 上海移远通信技术股份有限公司 166 / 189 LTE Standard(A)系列 AT 命令手册 PS PSC PUK RDI RF RI RRC RSCP RTC RTS/CTS RxQual SAP SDU SMS SMSC SNDCP TA TCP TDD TE TFT UART UCS2 UDH UDP Packet Switch Primary Synchronization Code PIN Unlock Key Remote Defect Indication Radio Frequency Ring Indicator Radio Resource Control Received Signal Code Power Real-Time Clock Request To Send/Clear To Send Receive Quality Service Access Point Service Data Unit Short Messag Service Short Message Service Center SubNetwork Dependence Convergence Protocol Terminal Adapter Transmission Control Protocol Time Division Duplex Terminal Equipment Traffic Flow Template Universal Asynchronous Receiver/Transmitter Universal Character Set (UCS-2) Format User Data Header User Datagram Protocol 分组交换 基本同步码 个人识别密码解锁码 远端缺陷指示 射频 振铃指示 无线资源控制 接收信号码功率 实时时钟 请求/清除发送 接收质量 服务访问点 服务数据单元 短消息业务 短消息服务中心 子网相关汇聚协议 终端适配器 传输控制协议 时分双工 终端设备 业务流模板 通用异步收发传输器 通用字符集格式 用户数据头 用户数据报协议 上海移远通信技术股份有限公司 167 / 189 UE UICC UIM UMTS URC USB (U)SIM UTRAN VBAT VLR WCDMA User Equipment Universal Integrated Circuit Card User Identity Module Universal Mobile Telecommunications System Unsolicited Result Code Universal Serial Bus (Universal) Subscriber Identity Module Universal Terrestrial Radio Access Network Voltage at Battery (Pin) Visitor Location Register Wideband Code Division Multiple Access LTE Standard(A)系列 AT 命令手册 用户设备 通用集成电路卡 用户识别模块 通用移动通信系统 非请求结果码 通用串行总线 （全球）用户识别模块 通用陆地无线接入网 电池电压（引脚） 拜访位置寄存器 宽带码分多址 12.2. AT&F 影响到的 AT 命令及参数 表 7：AT&F 影响到的 AT 命令及参数 AT 命令 ATE ATQ ATS0 ATS3 ATS4 ATS5 ATV ATX AT&C 参数名称 上海移远通信技术股份有限公司 默认值 1 0 0 13 10 8 1 4 1 168 / 189 AT&D AT+IFC AT+CREG AT+CGREG AT+CMEE AT+CSCS AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+COLP AT+CTZR AT+CPBS AT+CGEREP AT+CEREG , ,,, ,, ,,,, , LTE Standard(A)系列 AT 命令手册 2 0,0 0 0 1 'GSM' 0 0 17,167,0,0 0 0 'ME','ME','ME' 2,1,0,0,0 0 0 0 SM 0,0 0 12.3. AT&W 影响到的 AT 命令及参数 表 8：AT&W 影响到的 AT 命令及参数 AT 命令 参数名称 ATE 上海移远通信技术股份有限公司 是否通过 AT&V 显示 是 169 / 189 ATQ ATS0 ATV ATX AT&C AT&D AT+IFC AT+IPR AT+CREG AT+CGREG AT+CEREG , LTE Standard(A)系列 AT 命令手册 是 是 是 是 是 是 否 否 否 否 否 12.4. ATZ 影响到的 AT 命令及参数 表 9：ATZ 影响到的 AT 命令及参数 AT 命令 ATE ATQ ATS0 ATV ATX AT&C AT&D AT+IFC 参数名称 , 默认值 1 0 0 1 4 1 2 0,0 上海移远通信技术股份有限公司 170 / 189 AT+CREG AT+CGREG AT+CEREG LTE Standard(A)系列 AT 命令手册 0 0 0 12.5. CME ERROR 错误码汇总 最终结果码+CME ERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果码。 如果同一命令行中任一命令上报+CME ERROR: ，则该命令行中上报+CME ERROR: 的命令 之后的命令将不会被执行，而该命令之前已被执行的命令则不会返回 ERROR 或 OK 结果码。上报的 可以为数值型也可以为字符型，具体的上报形式可以通过 AT+CMEE 来设置。 值常用于普通消息命令。下表列举了部分通用或 GPRS 相关 ERROR 码，此表不包含 GSM 规范 中描述的 GSM 协议错误相关错误码。 表 10：+CME ERROR: 错误码描述 数值型 0 1 2 3 4 5 6 7 10 11 12 13 14 字符型 phone failure no connection to phone phone-adaptor link reserved operation not allowed operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy 中文含义 拨打电话失败 电话未连接 保留电话适配器连接 操作不允许 操作不支持 需要 PH-SIM 卡 PIN 码 需要 PH-FSIM 卡 PIN 码 需要 PH-FSIM 卡 PUK 码 未插入 SIM 卡 需要 SIM 卡 PIN 码 需要 SIM 卡 PUK 码 SIM 卡失败 SIM 卡忙 上海移远通信技术股份有限公司 171 / 189 LTE Standard(A)系列 AT 命令手册 15 SIM wrong SIM 卡错误 16 incorrect password 密码不正确 17 SIM PIN2 required 需要 SIM 卡 PIN2 码 18 SIM PUK2 required 需要 SIM 卡 PUK2 码 20 memory full 内存已满 21 invalid index 无效索引 22 not found 未发现 23 memory failure 内存不足 24 text string too long 文本字符过长 25 invalid characters in text string 无效文本字符 26 dial string too long 拨号字符过长 27 invalid characters in dial string 无效拨号字符 30 no network service 无网络服务 31 network timeout 网络超时 32 network not allowed - emergency calls only 网络不允许-仅支持紧急通话 40 network personalization PIN required 需要网络个性化 PIN 码 41 network personalization PUK required 需要网络个性化 PUK 码 42 network subset personalization PIN required 需要网络子集个性化 PIN 码 43 network subset personalization PUK required 需要网络子集个性化 PUK 码 44 service provider personalization PIN required 需要网络服务商个性化 PIN 码 45 service provider personalization PUK required 需要网络服务商个性化 PUK 码 46 corporate personalization PIN required 需要企业个性化 PIN 码 47 corporate personalization PUK required 需要企业个性化 PUK 码 901 audio unknown error 音频未知错误 902 audio invalid parameters 音频无效参数 903 audio operation not supported 音频操作不支持 904 audio device busy 音频设备忙 上海移远通信技术股份有限公司 172 / 189 LTE Standard(A)系列 AT 命令手册 12.6. CMS ERROR 错误码汇总 最终结果码+CMS ERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果码， 同一命令行中未执行任一命令，则不会返回 ERROR 或 OK 结果码。值常用于普通消息命令。 值常用于普通消息命令。 表 11：+CMS ERROR: 错误码描述 数值型 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 字符型 ME failure SMS ME reserved operation not allowed operation not supported invalid PDU mode invalid text mode (U)SIM not inserted (U)SIM PIN required PH-(U)SIM PIN required (U)SIM failure (U)SIM busy (U)SIM wrong (U)SIM PUK required (U)SIM PIN2 required (U)SIM PUK2 required memory failure invalid memory index memory full SMSC address unknown 中文含义 ME 失败 保留 SMS ME 操作不允许 操作不支持 无效 PDU 模式 无效文本模式 未插入(U)SIM 卡 需要(U)SIM 卡 PIN 码 需要 PH-(U)SIM 卡 PIN 码 (U)SIM 卡失败 (U)SIM 卡忙 (U)SIM 卡错误 需要(U)SIM PUK 码 需要(U)SIM PIN2 码 需要(U)SIM PUK2 码 内存不足 无效内存索引 内存已满 未知 SMSC 地址 上海移远通信技术股份有限公司 173 / 189 LTE Standard(A)系列 AT 命令手册 331 no network service 无网络服务 332 network timeout 网络超时 500 unknown 未知原因 512 (U)SIM not ready (U)SIM 卡未就绪 513 message length exceeds 短消息长度过长 514 invalid request parameters 无效请求参数 515 ME storage failure ME 内存不足 517 invalid service mode 无效服务模式 528 more message to send state error 更多短消息发送状态错误 529 MO SMS is not allowed MO 短消息服务不允许 530 GPRS is suspended GPRS 停用 531 ME storage full ME 内存已满 12.7. URC 汇总 表 12：URC 汇总 序号 URC 含义 条件 1 +CREG: 指示 ME 注册状态 AT+CREG=1 +CREG: [,,[,< 邻区更改后，指示当前网络是否已指示 2 Act>]] ME 状态，同时上报位置区号 AT+CREG=2 3 +CGREG: 指示 ME 的网络注册状态 AT+CGREG=1 4 +CGREG: [,,[, 指示 ME 的网络注册状态和位置信息 ]] AT+CGREG=2 5 +CEREG: 指示 EPS 网络注册状态 AT+CEREG=1 6 +CEREG: [,,[, 指示 E-UTRAN 网络小区变化 ]] AT+CEREG=2 7 +CTZV: 时区上报 AT+CTZR=1 8 +CTZE: ,, 扩展时区上报 AT+CTZR=2 上海移远通信技术股份有限公司 174 / 189 LTE Standard(A)系列 AT 命令手册 9 +CMTI: , 收到新短消息并保存至内存 AT+CNMI +CMT: [], 式） AT+CNMI +CMT: ,[], [,,,,,,,] ^HCMT: ,,,< 12 fmt>,,,,, 13 +CBM: +CBM: ,,,, 15 +CDS: 16 +CDS: ,,[],[],,, AT+CNMI 17 +CDSI: , 收到新消息状态报告，并保存到内存 AT+CNMI 18 +COLP: ,,[],[],[] 19 NO CARRIER PPP 链路挂断 ATV1 20 +CRING 通过非请求结果码而非正常 RING 向 TE 指示来电 N/A 21 RING 来电铃音 N/A 22 +CFUN: 1 MT 的所有功能均可用 N/A 23 +CPIN: (U)SIM 卡 PIN 状态 N/A 24 +QIND: SMS DONE SMS 初始化完成 N/A 25 +QIND: PB DONE 电话簿初始化完成 26 +QIND: airplanestatus, 27 +QIND: 'csq',, 信号强度和信道误码率变化 28 +QIND: 'datastatus',, 29 ^MODE:, N/A AT+QCFG='airplan econtrol',1 AT+QINDCFG='csq ',1 AT+QINDCFG='dat astatus',1 AT+QINDCFG='mo de',1 上海移远通信技术股份有限公司 175 / 189 LTE Standard(A)系列 AT 命令手册 30 +QIND: 'smsfull', SMS 存储已满 AT+QINDCFG='sm sfull',1 31 +QIND: 'act', 网络接入技术改变 AT+QINDCFG='act ',1 +QIND: 'SQI',,= ACM max Requested facility not implemented Only RDI bearer is available Service/option not implemented Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state 上海移远通信技术股份有限公司 LTE Standard(A)系列 AT 命令手册 交换设备拥塞 接入信息被丢弃 请求的电路/信道不可用 资源不可用，未指定 服务质量不可用 请求设备未预定 CUG 内的来电阻断 承载容量未批准 承载容量当前不可用 服务/选择不可用 承载服务未实施 ACM 等同或大于 ACM max 请求设备未实施 仅 RDI 承载可用 服务/选择未实施 无效交易标识符 用户非 CUG 成员 不兼容的目的地 无效转接网选择 语义错误消息 无效强制信息 消息不存在或未实施 消息类型与协议状态不兼容 信息元素不存在或未实施 条件 IE 错误 消息与协议状态不兼容 185 / 189 Recovery on timer expiry Protocol error, unspecified Interworking, unspecified CS 域网络拒绝 IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME GPRS services not allowed GPRS and non GPRS services not allowed MS identity cannot be derived Implicitly detached PLMN not allowed Location area not allowed Roaming not allowed GPRS services not allowed in PLMN No suitable cells in location area MSC temporary not reachable Network failure MAC failure Synch failure Congestion GSM authentication unacceptable Service option not supported Requested service option not subscribed LTE Standard(A)系列 AT 命令手册 计时器到时恢复 协议错误，未指定 互通，未指定 中文含义 HLR 未定义该 IMSI 非法 MS VLR 未定义该 IMSI 不可接受的 IMEI 非法 ME 不允许的 GPRS 服务 不允许的 GPRS 及非 GPRS 服务 无法获取用户身份 用户隐式分离 不允许的 PLMN 不允许的位置区域 不允许漫游 当前的 PLMN 不允许 GPRS 服务 本位置区不存在匹配的小区 MSC 暂时不可达 网络错误 MAC 错误 同步失败 拥塞 GSM 鉴权失败 不支持的服务选择 为预定请求的服务选择 上海移远通信技术股份有限公司 186 / 189 Service option temporary out of order Call cannot be identified No PDP context activated Semantically incorrect message Invalid mandatory information Message type non-existent Message type not compatible with state Information element non-existent Message not compatible with state RR release indication RR random access failure RRC release indication RRC close session indication RRC open session failure Low level failure Low level failure no redial allowed Invalid SIM No service Timer T3230 expired No cell available Wrong state Access class blocked Abort message received Other causes Timer T303 expired No resources 上海移远通信技术股份有限公司 LTE Standard(A)系列 AT 命令手册 服务选择暂时故障 呼叫无法识别 无激活的 PDP 上下文 语义错误消息 无效强制信息 消息类型不存在 消息类型与协议状态不兼容 信息元素不存在 消息与协议状态不兼容 RR 释放指示 RR 随机接入失败 RRC 释放指示 RRC 关闭会话指示 RRC 打开会话失败 底层错误 底层错误，不允许重拨 无效 SIM 卡 无服务 定时器 T303 过期 无小区可用 错误状态 接入类型受阻 接收到中止消息 其他原因 定时器 T303 过期 无资源 187 / 189 Release pending Invalid user data PS 域内部原因 Invalid connection identifier Invalid NSAPI Invalid primary NSAPI PDP establish timeout Invalid field SNDCP failure RAB setup failure No GPRS context PDP activate timeout PDP modify timeout PDP inactive max timeout PDP lower layer error PDP duplicate Access technology change PDP unknown reason PS 域网络原因 LLC or SNDCP failure Insufficient resources Missing or unknown APN Unknown PDP address or PDP type User authentication failed Activation rejected by GGSN Activation rejected, unspecified 上海移远通信技术股份有限公司 LTE Standard(A)系列 AT 命令手册 待释放 无效用户数据 中文含义 无效连接标识符 无效 NSAPI 无效首选 NSAPI PDP 创建超时 无效字段 SNDCP 失败 RAB 设置失败 无 GPRS 上下文 PDP 激活超时 PDP 修改超时 PDP 不活跃最大时间超时 PDP 底层错误 PDP 重复 接入技术改变 PDP 未知原因 中文含义 LLC 或 SDNCP 错误 资源不足 丢失或未知 APN 未知 PDP 地址或 PDP 类型 用户鉴权失败 激活请求被 GGSN 拒绝 激活请求被拒绝，未指定 188 / 189 Service option not supported Requested service option not subscribed Service option temporary out of order NSAPI already used (not sent) Regular deactivation QoS not accepted Network failure Reactivation required Feature not supported Semantic error in the TFT operation Syntactical error in the TFT operation Unknown PDP context PDP context without TFT already activated Semantic errors in packet filter Syntactical errors in packet filter Invalid transaction identifier Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Protocol error, unspecified LTE Standard(A)系列 AT 命令手册 不支持的服务选择 未预定请求的服务选择 服务选择暂时故障 NSAPI 已被占用（未发送） 常规去激活 不接受的服务质量 网络错误 需重新激活 功能不支持 TFT 操作语义错误 TFT 操作语法错误 未知 PDP 上下文 无 TFT 的 PDP 上下文已被激活 分组过滤器语义错误 分组过滤器语法错误 无效交易标识符 语义错误信息 无效强制信息 消息不存在或未实施 消息类型与协议状态不兼容 信息元素不存在或未实施 条件 IE 错误 消息与协议状态不兼容 协议错误，未指定 上海移远通信技术股份有限公司 189 / 189

FC41D AT 命令手册 Wi-Fi&Bluetooth 模块系列 版本：1.0 日期：2022-09-27 状态：受控文件 FC41D AT 命令手册 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 106 FC41D AT 命令手册 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 106 文档历史 修订记录 版本 - 1.0 日期 2021-06-11 2022-09-27 作者 Brave LIU/ Lidong ZHOU Brave LIU/ Lidong ZHOU/ Vic CHENG/ Lei WANG 变更表述 文档创建 受控版本 FC41D AT 命令手册 上海移远通信技术股份有限公司 3 / 106 FC41D AT 命令手册 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 8 图片索引 ....................................................................................................................................................... 9 1 引言 ..................................................................................................................................................... 10 1.1. 定义 .......................................................................................................................................... 10 1.2. AT 命令语句 ............................................................................................................................. 10 1.3. AT 命令响应 ............................................................................................................................. 11 1.4. AT 示例声明 ............................................................................................................................. 12 2 AT 命令描述 ........................................................................................................................................ 13 2.1. Wi-Fi 相关 AT 命令详解............................................................................................................ 13 2.1.1. AT+QRST 重启模块 ................................................................................................... 13 2.1.2. AT+QVERSION 获取固件版本 ................................................................................... 13 2.1.3. AT+QECHO 启用/禁用回显 ........................................................................................ 14 2.1.4. AT+QURCCFG 启用或禁用 URC 上报....................................................................... 14 2.1.5. AT+QPING Ping 外部 IP............................................................................................. 15 2.1.6. AT+QGETIP 获取模块 IP 相关信息 ............................................................................ 15 2.1.7. AT+QSETBAND 设置串口波特率............................................................................... 16 2.1.8. AT+QWLANOTA 开始 OTA 升级 ............................................................................... 16 2.1.9. AT+QLOWPOWER 设置低功耗模式.......................................................................... 17 2.1.10. AT+QDEEPSLEEP 设置深休眠模式 .......................................................................... 17 2.1.11. AT+QWLMAC 获取 MAC 地址 ................................................................................... 17 2.1.12. AT+QAIRKISS 启用/禁用 AirKiss 功能....................................................................... 18 2.1.13. AT+QSTAST 查询 STA 模式开启状态........................................................................ 18 2.1.14. AT+QSTADHCP 启用/禁用 STA 模式下 DHCP 服务进程.......................................... 19 2.1.15. AT+QSTADHCPDEF 启用/禁用 STA 模式下 DHCP 服务进程并保存配置 ................ 19 2.1.16. AT+QSTASTATIC 设置 STA 模式静态 IP .................................................................. 20 2.1.17. AT+QSTASTOP 禁用 STA 模式................................................................................. 20 2.1.18. AT+QSOFTAP 启用 AP 模式 ..................................................................................... 20 2.1.19. AT+QAPSTATE 查询 AP 模式开启状态..................................................................... 21 2.1.20. AT+QAPSTATIC 设置 AP 模式静态 IP....................................................................... 21 2.1.21. AT+QSOFTAPSTOP 禁用 AP 模式............................................................................ 22 2.1.22. AT+QSTAAPINFO 连接 AP 热点 ............................................................................... 22 2.1.23. AT+QSTAAPINFODEF 连接热点并保存热点信息 ..................................................... 23 2.1.24. AT+QGETWIFISTATE 查询已连接热点信息.............................................................. 23 2.1.25. AT+QWSCAN 查询扫描到的热点信息 ....................................................................... 24 2.1.26. AT+QWEBCFG 启用/禁用 Web 配网 ......................................................................... 24 2.2. BLE 相关 AT 命令详解 ............................................................................................................. 25 2.2.1. AT+QBLEINIT 初始化 BLE......................................................................................... 25 2.2.2. AT+QBLEADDR 查询 BLE 设备地址.......................................................................... 26 2.2.3. AT+QBLENAME 设置 BLE 名称................................................................................. 26 上海移远通信技术股份有限公司 4 / 106 FC41D AT 命令手册 2.2.4. AT+QBLEADVPARAM 设置 BLE 广播参数 ............................................................... 27 2.2.5. AT+QBLEADVDATA 设置 BLE 广播数据................................................................... 28 2.2.6. AT+QBLEGATTSSRV 创建 BLE 服务 ....................................................................... 29 2.2.7. AT+QBLEGATTSCHAR 创建 BLE 特征值 ................................................................. 29 2.2.8. AT+QBLEADVSTART 开启 BLE 广播........................................................................ 30 2.2.9. AT+QBLEADVSTOP 禁用 BLE 广播.......................................................................... 30 2.2.10. AT+QBLEGATTSNTFY 发送 GATT 数据................................................................... 30 2.2.11. AT+QBLESCAN 打开/关闭 BLE 扫描......................................................................... 31 2.2.12. AT+QBLESCANPARAM 设置 BLE 扫描参数............................................................. 32 2.2.13. AT+QBLECONN 连接外围设备.................................................................................. 32 2.2.14. AT+QBLECONNPARAM 设置连接参数 ..................................................................... 33 2.2.15. AT+QBLECFGMTU 设置 BLE 最大传输单元 ............................................................. 33 2.2.16. AT+QBLEGATTCNTFCFG 启用/禁用通知 ................................................................ 34 2.2.17. AT+QBLEGATTCWR 发送数据 ................................................................................. 35 2.2.18. AT+QBLEGATTCRD 读取数据 .................................................................................. 35 2.2.19. AT+QBLEDISCONN 断开 BLE 连接 .......................................................................... 36 2.2.20. AT+QBLESTAT 查询 BLE 设备状态........................................................................... 36 2.3. TCP/UDP 相关 AT 命令详解 .................................................................................................... 37 2.3.1. AT+QICFG 配置 TCP/UDP Socket 服务相关参数 ..................................................... 37 2.3.2. AT+QIOPEN 打开 TCP/UDP Socket 服务 ................................................................. 39 2.3.3. AT+QISTATE 查询 TCP/UDP Socket 服务状态......................................................... 40 2.3.4. AT+QISEND 通过 TCP/UDP Socket 服务发送数据 ................................................... 41 2.3.5. AT+QIRD 读取 TCP/UDP Socket 服务收到的数据 .................................................... 42 2.3.6. AT+QIACCEPT 接受/拒绝 TCP/UDP Socket 服务远端接入请求............................... 43 2.3.7. AT+QISWTMD 切换数据访问模式 ............................................................................. 44 2.3.8. AT+QICLOSE 关闭 TCP/UDP Socket 服务 ............................................................... 45 2.3.9. AT+QIGETERROR 查询 TCP/UDP Socket 服务相关的结果码 ................................. 45 2.3.10. ATO 进入透传模式...................................................................................................... 46 2.3.11. +++ 退出透传模式....................................................................................................... 46 2.4. SSL 相关 AT 命令详解 ............................................................................................................. 47 2.4.1. AT+QSSLCFG 配置 SSL 上下文参数......................................................................... 47 2.4.2. AT+QSSLCERT 上传/下载/删除 SSL 证书................................................................. 49 2.4.3. AT+QSSLOPEN 打开 SSL 客户端 ............................................................................. 50 2.4.4. AT+QSSLSEND 通过 SSL 客户端发送数据............................................................... 51 2.4.5. AT+QSSLRECV 读取 SSL 客户端收到的数据 ........................................................... 52 2.4.6. AT+QSSLSTATE 查询 SSL 客户端状态 .................................................................... 53 2.4.7. AT+QSSLCLOSE 关闭 SSL 客户端 ........................................................................... 54 2.5. MQTT 相关 AT 命令详解 .......................................................................................................... 54 2.5.1. AT+QMTCFG 配置 MQTT 客户端可选参数 ............................................................... 54 2.5.2. AT+QMTOPEN 建立 MQTT 客户端与服务器之间的会话连接 ................................... 58 2.5.3. AT+QMTCLOSE 关闭 MQTT 客户端与服务器之间的会话连接 ................................. 59 2.5.4. AT+QMTCONN 在 MQTT 客户端与服务器之间建立 MQTT 连接 .............................. 60 2.5.5. AT+QMTDISC 断开 MQTT 客户端与服务器之间的连接 ............................................ 61 2.5.6. AT+QMTSUB 订阅主题 .............................................................................................. 62 上海移远通信技术股份有限公司 5 / 106 FC41D AT 命令手册 2.5.7. AT+QMTUNS 取消订阅主题 ...................................................................................... 63 2.5.8. AT+QMTPUB 通过 MQTT 服务器发布消息................................................................ 64 2.5.9. AT+QMTRECV 读取 MQTT 服务器发布的消息 ......................................................... 65 2.6. HTTP(S)相关 AT 命令详解....................................................................................................... 66 2.6.1. AT+QHTTPCFG 配置 HTTP(S)客户端参数 ............................................................... 66 2.6.2. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器................................................... 69 2.6.3. AT+QHTTPPOST 发送 POST 请求到 HTTP(S)服务器.............................................. 69 2.6.4. AT+QHTTPPUT 发送 PUT 请求到 HTTP(S)服务器 ................................................... 71 2.6.5. AT+QHTTPREAD 读取 HTTP(S)请求的响应信息...................................................... 72 3 相关 URC 描述 .................................................................................................................................... 73 3.1. Wi-Fi 相关 URC 详解................................................................................................................ 73 3.1.1. +QSTASTAT STA 状态变化提示................................................................................ 73 3.2. BLE 相关 URC 详解 ................................................................................................................. 73 3.2.1. +QBLESTAT BLE 状态变化提示 ................................................................................ 73 3.2.2. +QBLEMTU BLE MTU 数值变化提示......................................................................... 74 3.2.3. +QBLEINFO BLE 为中心设备连接成功时句柄和特征值结果提示.............................. 74 3.3. TCP/UDP 相关 URC 详解 ........................................................................................................ 74 3.3.1. +QIOPEN TCP/UDP Socket 服务打开结果提示 ........................................................ 74 3.3.2. +QIURC: 'recv' TCP/UDP Socket 接收数据提示....................................................... 75 3.3.3. +QIURC: 'accept' TCP/UDP Socket 连接请求接入提示 ........................................... 75 3.3.4. +QIURC: 'closed' TCP/UDP Socket 被关闭提示....................................................... 75 3.3.5. +QIURC: 'incoming' TCP/UDP Socket 连接请求提示 ............................................... 76 3.3.6. +QIURC: 'incoming full' TCP/UDP Socket 连接已满提示 ......................................... 76 3.3.7. NO CARRIER 透传连接异常断开提示...................................................................... 76 3.4. SSL 相关 URC 详解 ................................................................................................................. 77 3.4.1. +QSSLOPEN SSL 客户端打开结果提示 .................................................................... 77 3.4.2. +QSSLURC: 'recv' SSL 客户端接收数据提示 ........................................................... 77 3.4.3. +QSSLURC: 'closed' SSL 客户端被关闭提示 ........................................................... 77 3.5. MQTT 相关 URC 详解 .............................................................................................................. 78 3.5.1. +QMTRECV MQTT 客户端收到新消息提示............................................................... 78 3.5.2. +QMTSTAT MQTT 客户端异常断开提示 ................................................................... 78 3.6. HTTP(S)相关 URC 详解........................................................................................................... 79 3.6.1. +QHTTPGET HTTP(S) GET 请求发送结果提示 ........................................................ 79 3.6.2. +QHTTPPOST HTTP(S) POST 请求发送结果提示 ................................................... 79 3.6.3. +QHTTPPUT HTTP(S) PUT 请求发送结果提示 ........................................................ 80 3.6.4. +QHTTPREAD HTTP(S)读取响应数据的结果提示 .................................................... 80 3.6.5. +QHTTPURC: 'recv' HTTP(S)收到响应数据的提示 .................................................. 80 4 举例 ..................................................................................................................................................... 81 4.1. Wi-Fi 功能................................................................................................................................. 81 4.2. BLE 功能 .................................................................................................................................. 81 4.2.1. 外围设备角色................................................................................................................. 81 4.2.1.1. 配置模块为外围设备........................................................................................... 81 4.2.1.2. nRF Connect 连接 .............................................................................................. 82 上海移远通信技术股份有限公司 6 / 106 FC41D AT 命令手册 4.2.1.3. nRF Connect 给模块发送数据............................................................................ 84 4.2.1.4. 模块给 nRF Connect 发送数据........................................................................... 86 4.2.2. 中心设备角色................................................................................................................. 86 4.2.2.1. 配置模块为中心设备........................................................................................... 87 4.2.2.2. nRF Connect 配置 .............................................................................................. 87 4.2.2.2.1. 服务配置 .................................................................................................. 87 4.2.2.2.2. 广播配置 .................................................................................................. 88 4.2.2.3. nRF Connect 给模块发送数据............................................................................ 91 4.2.2.4. 模块给 nRF Connect 发送数据........................................................................... 92 4.2.3. 蓝牙配网 ........................................................................................................................ 93 4.2.3.1. 蓝牙配网准备工作 .............................................................................................. 93 4.2.3.1.1. 配置模块 A 为外围设备配网模式 ............................................................. 93 4.2.3.1.2. 配置模块 B 为中心设备............................................................................ 94 4.2.3.2. 蓝牙配网 ............................................................................................................. 94 4.3. TCP/UDP 功能 ......................................................................................................................... 95 4.3.1. 透传模式 ........................................................................................................................ 95 4.3.2. 非透传模式 .................................................................................................................... 95 4.4. SSL 功能 .................................................................................................................................. 97 4.5. MQTT 功能 ............................................................................................................................... 99 4.6. HTTP(S)功能 .......................................................................................................................... 100 5 结果码 ............................................................................................................................................... 103 6 附录 术语缩写................................................................................................................................... 105 上海移远通信技术股份有限公司 7 / 106 FC41D AT 命令手册 表格索引 表 1：AT 命令类型 ..................................................................................................................................... 11 表 2：TCP/UDP/SSL 结果码.................................................................................................................... 103 表 3：HTTP(S)结果码 .............................................................................................................................. 103 表 4：术语缩写 ......................................................................................................................................... 105 上海移远通信技术股份有限公司 8 / 106 FC41D AT 命令手册 图片索引 图 1：BLE 广播数据报文格式..................................................................................................................... 28 图 2：扫描结果 ........................................................................................................................................... 82 图 3：连接成功 ........................................................................................................................................... 83 图 4：编辑特征值 ....................................................................................................................................... 84 图 5：发送数据 ........................................................................................................................................... 85 图 6：0xFFF3 显示的接收数据................................................................................................................... 86 图 7：服务配置 ........................................................................................................................................... 87 图 8：配置相关 UUID 值............................................................................................................................. 88 图 9：添加广播 ........................................................................................................................................... 88 图 10：广播配置 ......................................................................................................................................... 89 图 11：手动设置播放时长 .......................................................................................................................... 90 图 12：编辑特征值 ..................................................................................................................................... 91 图 13：发送数据 ......................................................................................................................................... 92 图 14：0xFFF2 显示的接收数据 ................................................................................................................ 93 上海移远通信技术股份有限公司 9 / 106 FC41D AT 命令手册 1 引言 本文档主要介绍移远通信 FC41D 模块 Wi-Fi、BLE、TCP/UDP、SSL、MQTT 和 HTTP(S)相关的 AT 命令。 1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 FC41D 实现的 AT 命令可以在语法上分为两类：基础类和扩展类，如下所列。 ⚫ 基础类 基础类 AT 命令的格式为 AT或 AT&，其中是命令，是该命令的参数。以 ATE为例，DCE 会根据的取值确定是否将接收到的字符回显给 DTE。若为可选参数， 则其被省略时将使用其默认值。 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 上海移远通信技术股份有限公司 10 / 106 FC41D AT 命令手册 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 可以用分号（;）将多个命令放在同一行。此时只有第一个命令带有 AT 前缀。命令可以是大写或小写。 输入 AT 命令时，可以忽略空格。但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内； ⚫ 在 AT 命令名称中的 =、? 或 =? 内。 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.3. AT 命令响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或+CME ERROR: ，表示已经准备 好接收新命令。在返回最终的 OK，ERROR 或+CME ERROR: 之前，会发送请求的响应消息。 以下是响应消息的格式： +CMD1: OK 或者 OK 上海移远通信技术股份有限公司 11 / 106 FC41D AT 命令手册 1.4. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 12 / 106 FC41D AT 命令手册 2 AT 命令描述 2.1. Wi-Fi 相关 AT 命令详解 2.1.1. AT+QRST 重启模块 该命令用于重启模块。 AT+QRST 执行命令 AT+QRST 重启模块 最大响应时间 特性说明 响应 OK 或 ERROR 300 毫秒 / 2.1.2. AT+QVERSION 获取固件版本 该命令用于获取固件版本。 AT+QVERSION 获取固件版本 执行命令 AT+QVERSION 响应 +QVERSION: 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 字符串类型（无双引号）。模块固件版本号。 上海移远通信技术股份有限公司 13 / 106 2.1.3. AT+QECHO 启用/禁用回显 该命令用于启用或禁用回显。 AT+QECHO 启用/禁用回显 设置命令 AT+QECHO= 最大响应时间 特性说明 响应 OK 或 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用回显。 0 禁用 1 启用 2.1.4. AT+QURCCFG 启用或禁用 URC 上报 该命令用于启用或禁用 URC 上报。 AT+QURCCFG 启用/禁用 URC 上报 设置命令 响应 AT+QURCCFG= OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用 URC 上报。 0 禁用 1 启用 FC41D AT 命令手册 上海移远通信技术股份有限公司 14 / 106 2.1.5. AT+QPING Ping 外部 IP 该命令用于 ping 外部 IP。 AT+QPING Ping 外部 IP 设置命令 AT+QPING= 最大响应时间 特性说明 响应 OK 或 ERROR 300 毫秒 / 参数 字符串类型。外部 IP 地址。 FC41D AT 命令手册 2.1.6. AT+QGETIP 获取模块 IP 相关信息 该命令用于获取模块 IP 相关信息。 AT+QGETIP 获取模块 IP 相关信息 设置命令 响应 AT+QGETIP= +QGETIP: ,,, 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 字符串类型（无双引号）。Wi-Fi 工作模式。 station 模块工作模式为 STA ap 模块工作模式为 AP 字符串类型（无双引号）。模块的 IP 地址。 字符串类型（无双引号）。模块的网关地址。 字符串类型（无双引号）。模块的子网掩码。 字符串类型（无双引号）。模块的 DNS 地址。 上海移远通信技术股份有限公司 15 / 106 FC41D AT 命令手册 2.1.7. AT+QSETBAND 设置串口波特率 该命令用于设置串口波特率。 AT+QSETBAND 设置串口波特率 设置命令 响应 AT+QSETBAND=[,] OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效。 参数 整型。串口波特率。 整型。省略该参数则保存波特率。 0 不保存波特率 1 保存波特率 2.1.8. AT+QWLANOTA 开始 OTA 升级 该命令用于对固件进行 OTA 升级。 AT+QWLANOTA 开始 OTA 升级 设置命令 AT+QWLANOTA= 最大响应时间 响应 OK 或 ERROR 300 毫秒 特性说明 / 参数 字符串类型（无双引号）。固件包存储在服务器上的地址。 上海移远通信技术股份有限公司 16 / 106 2.1.9. AT+QLOWPOWER 设置低功耗模式 该命令用于配置模块进入低功耗模式。 AT+QLOWPOWER 设置低功耗模式 执行命令 响应 AT+QLOWPOWER OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / 2.1.10. AT+QDEEPSLEEP 设置深休眠模式 该命令用于配置模块进入深休眠模式。 AT+QDEEPSLEEP 设置深休眠模式 执行命令 响应 AT+QDEEPSLEEP OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / 2.1.11. AT+QWLMAC 获取 MAC 地址 该命令用于获取模块的 MAC 地址。 AT+QWLMAC 获取 MAC 地址 执行命令 AT+QWLMAC 响应 +QWLMAC: 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 上海移远通信技术股份有限公司 FC41D AT 命令手册 17 / 106 参数 FC41D AT 命令手册 模块的 MAC 地址。格式为冒号分隔的十六进制。默认值：c8:47:8c:42:00:48。 2.1.12. AT+QAIRKISS 启用/禁用 AirKiss 功能 该命令用于启用或禁用 AirKiss 功能。 AT+QAIRKISS 启用/禁用 AirKiss 功能 设置命令 响应 AT+QAIRKISS= OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / 参数 整型。启用/禁用 AirKiss 功能。 0 禁用 1 启用 2.1.13. AT+QSTAST 查询 STA 模式开启状态 该命令用于查询 STA 模式开启状态。 AT+QSTAST 执行命令 AT+QSTAST 查询 STA 模式开启状态 响应 +QSTAST: 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 字符串类型（无双引号）。STA 模式开启状态。 STATION_DOWN 关闭 上海移远通信技术股份有限公司 18 / 106 STATION_UP 开启 FC41D AT 命令手册 2.1.14. AT+QSTADHCP 启用/禁用 STA 模式下 DHCP 服务进程 该命令用于启用或禁用 STA 模式下 DHCP 服务进程。 AT+QSTADHCP 启用/禁用 STA 模式下 DHCP 服务进程 设置命令 响应 AT+QSTADHCP= OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用 STA 模式下 DHCP 服务进程。 0 禁用 1 启用 2.1.15. AT+QSTADHCPDEF 启用/禁用 STA 模式下 DHCP 服务进程并保存配置 该命令用于启用或禁用 STA 模式下 DHCP 服务进程并保存配置。 AT+QSTADHCPDEF 启用/禁用 STA 模式下 DHCP 服务进程并保存配置 设置命令 AT+QSTADHCPDEF= 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用 STA 模式下 DHCP 服务进程。 0 禁用 1 启用 上海移远通信技术股份有限公司 19 / 106 2.1.16. AT+QSTASTATIC 设置 STA 模式静态 IP 该命令用于设置 STA 模式静态 IP。 AT+QSTASTATIC 设置 STA 模式静态 IP 设置命令 响应 AT+QSTASTATIC=,,, OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型（无双引号）。STA 模式静态 IP 地址。 字符串类型（无双引号）。模块的子网掩码。 字符串类型（无双引号）。模块的网关地址。 字符串类型（无双引号）。模块的 DNS 地址。 2.1.17. AT+QSTASTOP 禁用 STA 模式 该命令用于禁用 STA 模式。 AT+QSTASTOP 执行命令 AT+QSTASTOP 禁用 STA 模式 最大响应时间 响应 OK 或 ERROR 300 毫秒 特性说明 / 2.1.18. AT+QSOFTAP 启用 AP 模式 该命令用于启用 AP 模式。 AT+QSOFTAP 启用 AP 模式 设置命令 响应 AT+QSOFTAP=[,] OK 或 上海移远通信技术股份有限公司 FC41D AT 命令手册 20 / 106 最大响应时间 特性说明 参数 FC41D AT 命令手册 ERROR 3300 毫秒（开启加密热点）/300 毫秒（开启无密码热点） 该命令立即生效； 参数配置不保存。 字符串类型（无双引号）。AP 名称。范围：1~32；单位：字节。 字符串类型（无双引号）。AP 密钥。范围：8~63；单位：字节。省略该参数开启 无密码热点。 2.1.19. AT+QAPSTATE 查询 AP 模式开启状态 该命令用于查询 AP 模式开启状态。 AT+QAPSTATE 执行命令 AT+QAPSTATE 查询 AP 模式开启状态 响应 +QAPSTATE: 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 字符串类型（无双引号）。AP 模式开启状态。 SOFTAP_DOWN 关闭 SOFTAP_UP 开启 2.1.20. AT+QAPSTATIC 设置 AP 模式静态 IP 该命令用于设置 AP 模式静态 IP。 AT+QAPSTATIC 设置 AP 模式静态 IP 设置命令 响应 AT+QAPSTATIC=,,, OK 或 ERROR 上海移远通信技术股份有限公司 21 / 106 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符型类型（无双引号）。AP 模式静态 IP 地址。 字符串类型（无双引号）。模块的子网掩码。 字符串类型（无双引号）。模块的网关地址。 字符串类型（无双引号）。模块的 DNS 地址。 2.1.21. AT+QSOFTAPSTOP 禁用 AP 模式 该命令用于禁用 AP 模式。 AT+QSOFTAPSTOP 禁用 AP 模式 执行命令 AT+QSOFTAPSTOP 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / FC41D AT 命令手册 2.1.22. AT+QSTAAPINFO 连接 AP 热点 该命令用于连接 AP 热点进入 STA 模式。 AT+QSTAAPINFO 连接 AP 热点 设置命令 AT+QSTAAPINFO=[,] 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型（无双引号）。待连接 AP 热点名称。范围：1~32；单位：字节。 上海移远通信技术股份有限公司 22 / 106 FC41D AT 命令手册 字符串类型（无双引号）。待连接 AP 热点密钥。范围：8~63；单位：字节。省略该参数连接无 密码热点。 2.1.23. AT+QSTAAPINFODEF 连接热点并保存热点信息 该命令用于连接热点进入 STA 模式，并保存热点信息。 AT+QSTAAPINFODEF 连接热点并保存热点信息 设置命令 响应 AT+QSTAAPINFODEF=[,] OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置自动保存。 参数 字符串类型（无双引号）。待连接 AP 热点名称。范围：1~32；单位：字节。 字符串类型（无双引号）。待连接 AP 热点密钥。范围：8~63；单位：字节。省略 该参数连接无密码热点。 2.1.24. AT+QGETWIFISTATE 查询已连接热点信息 该命令用于当模块启用 STA 模式时，查询已连接热点信息。 AT+QGETWIFISTATE 执行命令 AT+QGETWIFISTATE 查询已连接热点信息 响应 +QGETWIFISTATE: ssid=,bssid=,rssi=< RSSI>,channel=,cipher_type= 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 字符串类型。Wi-Fi 热点名称。 字符串类型（无双引号）。Wi-Fi 网卡 MAC 地址。 上海移远通信技术股份有限公司 23 / 106 FC41D AT 命令手册 整型。Wi-Fi 信号强度。 整型。STA 模式下，模块与热点连接、通信的信道。 字符串类型（无双引号）。加密类型。 2.1.25. AT+QWSCAN 查询扫描到的热点信息 该命令用于查询扫描到的热点信息。 AT+QWSCAN 执行命令 AT+QWSCAN 查询扫描到的热点信息 响应 +QWSCAN: ,,,, […] 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 字符串类型。Wi-Fi 热点名称。 字符串类型（无双引号）。加密类型。 整型。Wi-Fi 信号强度。 字符串类型（无双引号）。Wi-Fi 网卡 MAC 地址。 整型。STA 模式下，模块与热点连接、通信的信道。 2.1.26. AT+QWEBCFG 启用/禁用 Web 配网 该命令用于启用或禁用 Web 配网功能。 AT+QWEBCFG 启用/禁用 Web 配网 设置命令 响应 AT+QWEBCFG= OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 24 / 106 参数 整型。启用/禁用 Web 配网功能。 0 禁用 1 启用 2.2. BLE 相关 AT 命令详解 2.2.1. AT+QBLEINIT 初始化 BLE 该命令用于初始化 BLE。 AT+QBLEINIT 初始化 BLE 设置命令 AT+QBLEINIT= 查询命令 AT+QBLEINIT? 响应 OK 或 ERROR 响应 +QBLEINIT: 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 整型。初始化 BLE。 1 模块为中心设备进行 BLE 初始化 2 模块为外围设备进行 BLE 初始化 3 模块为外围设备进行蓝牙配网 FC41D AT 命令手册 上海移远通信技术股份有限公司 25 / 106 FC41D AT 命令手册 2.2.2. AT+QBLEADDR 查询 BLE 设备地址 该命令用于查询 BLE 设备地址。 AT+QBLEADDR 查询命令 AT+QBLEADDR? 查询 BLE 设备地址 响应 +QBLEADDR: 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 字符串类型（无双引号）。BLE 设备地址。48 位地址以十六进制数串表示，如 58:D3:91:01:02:03。 2.2.3. AT+QBLENAME 设置 BLE 名称 该命令用于设置 BLE 名称。 AT+QBLENAME 查询命令 AT+QBLENAME? 设置 BLE 名称 响应 +QBLENAME: 设置命令 AT+QBLENAME= 最大响应时间 特性说明 OK 或 ERROR 响应 OK 或 ERROR 300 毫秒 / 上海移远通信技术股份有限公司 26 / 106 参数 FC41D AT 命令手册 字符串类型（无双引号）。BLE 名称。最大长度：25 字节。 2.2.4. AT+QBLEADVPARAM 设置 BLE 广播参数 该命令用于模块作为外围设备时设置 BLE 广播参数。 AT+QBLEADVPARAM 设置 BLE 广播参数 设置命令 AT+QBLEADVPARAM=, 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。非定向广播及低占空比定向广播的最小广播间隔。 范围：0x0020~0x4000（对应的时间范围：20 毫秒~10.24 秒）；默认值：0x0800 （1.28 秒）；单位：timeslot（1 timeslot = 0.625 毫秒）。 整型。非定向广播及低占空比定向广播的最大广播间隔。 范围：0x0020~0x4000（对应的时间范围：20 毫秒~10.24 秒）；默认值：0x0800 （1.28 秒）；单位：timeslot（1 timeslot = 0.625 毫秒）。 备注 如需使用 AT+QBLEADVPARAM 配置广播参数，则必须在使用 AT+QBLEADVSTART 开始广播之前进 行设置。 上海移远通信技术股份有限公司 27 / 106 2.2.5. AT+QBLEADVDATA 设置 BLE 广播数据 该命令用于模块作为外围设备时设置 BLE 广播数据。 FC41D AT 命令手册 图 1：BLE 广播数据报文格式 AT+QBLEADVDATA 设置 BLE 广播数据 设置命令 AT+QBLEADVDATA= 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型（无双引号）。广播数据。由以下三个字段组成（即多个 AD Structure 组成），组成方式符合上图的报文格式，内容必须是十六进制的数串。 Length AD Structure 的长度，包括 AD Type 和 AD Data 的长度，不包含 Length 本身的 1 字节。最大 0x1e，即数据域最大长度为 30 字节。 AD Type 该广播数据所属的类型，如功耗级别 Tx Power Level（0x0A）、 设备名称 Local Name（0x09）、角色 Le Role（0x1C）、服务标 识 Service UUIDs（0x16）等。对端扫描到广播后，可以根据 AD Type 判断出广播数据的意义。 AD Data 广播数据内容，以大端方式组织。 上海移远通信技术股份有限公司 28 / 106 FC41D AT 命令手册 备注 关 于 AD Type 的 类 型 和 含 义 取 值 ， 请 参 考 BLE 官 方 文 档 Core Specification 5.2 （https://www.bluetooth.com/specifications/specs/core-specification/）。 2.2.6. AT+QBLEGATTSSRV 创建 BLE 服务 该命令用于模块作为外围设备时创建 BLE 服务。 AT+QBLEGATTSSRV 创建 BLE 服务 设置命令 AT+QBLEGATTSSRV= 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型（无双引号）。蓝牙服务 UUID。长度：2 字节或 16 字节。 备注 该命令仅支持一次创建一个 BLE 服务。 2.2.7. AT+QBLEGATTSCHAR 创建 BLE 特征值 该命令用于模块作为外围设备时创建 BLE 特征值。 AT+QBLEGATTSCHAR 创建 BLE 特征值 设置命令 AT+QBLEGATTSCHAR= 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 29 / 106 参数 FC41D AT 命令手册 字符串类型（无双引号）。特征值 UUID。长度：2 字节或 16 字节。 2.2.8. AT+QBLEADVSTART 开启 BLE 广播 该命令用于模块作为外围设备时开启 BLE 广播。 AT+QBLEADVSTART 开启 BLE 广播 执行命令 AT+QBLEADVSTART 响应 OK 或 ERROR 最大响应时间 1000 毫秒 特性说明 / 2.2.9. AT+QBLEADVSTOP 禁用 BLE 广播 该命令用于模块作为外围设备时禁用 BLE 广播。 AT+QBLEADVSTOP 禁用 BLE 广播 执行命令 AT+QBLEADVSTOP 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / 2.2.10. AT+QBLEGATTSNTFY 发送 GATT 数据 该命令用于模块作为外围设备时发送 GATT 数据。 AT+QBLEGATTSNTFY 发送 GATT 数据 设置命令 AT+QBLEGATTSNTFY=[,], 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / 上海移远通信技术股份有限公司 30 / 106 参数 FC41D AT 命令手册 字符串类型（无双引号）。特征值的 UUID。长度：2 字节或者 16 字节。 整型。十六进制数据长度。使用该参数时，模块会将转换为十六进制再进行 发送。例如，若为 123456，模块会将该数据转换为 0x123456 进行发送。 字符串类型（无双引号）。GATT 数据。 2.2.11. AT+QBLESCAN 打开/关闭 BLE 扫描 该命令用于模块作为中心设备时打开或关闭 BLE 扫描。 AT+QBLESCAN 打开/关闭 BLE 扫描 设置命令 响应 AT+QBLESCAN=[,] 如果为 0： OK 或 ERROR 如果为 1： OK +QBLESCAN:,, 或 ERROR 如果为 2： OK 最大响应时间 特性说明 +QBLESCAN:,,, 或 ERROR 1000 毫秒 / 参数 整型。打开或关闭 BLE 扫描。 0 关闭 1 打开，不输出广播数据及扫描应答数据。 2 打开，输出广播数据及扫描应答数据。该模式下无需手动关闭 BLE 扫描。 整型。扫描持续时间。范围：500~10000；单位：毫秒。当为 2 时，必 上海移远通信技术股份有限公司 31 / 106 FC41D AT 命令手册 须设置该参数。 字符串类型（无双引号）。BLE 设备名称。 整型。BLE 设备地址类型。 0 公共地址 1 随机地址 字符串类型（无双引号）。BLE 设备地址。长度：12 字节。 字符串类型（无双引号）。扫描到的 BLE 数据及扫描应答数据。 2.2.12. AT+QBLESCANPARAM 设置 BLE 扫描参数 该命令用于模块作为中心设备时设置 BLE 扫描参数。 AT+QBLESCANPARAM 设置 BLE 扫描参数 设置命令 AT+QBLESCANPARAM=, 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。LE 扫描间隔。范围：0x0012~0x1000（对应的时间范围：11.25 毫秒~2.56 秒）；默认值：0x0064；单位：timeslot（1 timeslot = 0.625 毫秒）。 整型。LE 扫描持续的时间。要小于或等于。范 围：0x0011~0x1000（对应的时间范围：10.625 毫秒~2.56 秒）；默认值：0x001E； 单位：timeslot（1 timeslot = 0.625 毫秒）。 2.2.13. AT+QBLECONN 连接外围设备 该命令用于模块作为中心设备时连接外围设备。 AT+QBLECONN 连接外围设备 设置命令 AT+QBLECONN=, 最大响应时间 特性说明 响应 OK 或 ERROR 3000 毫秒 该命令立即生效； 参数配置不保存； 上海移远通信技术股份有限公司 32 / 106 连接超时时间为 18 秒。 FC41D AT 命令手册 参数 整型。外围设备地址类型。 0 公用地址 1 随机地址 字符串类型（无双引号）。外围设备地址。 2.2.14. AT+QBLECONNPARAM 设置连接参数 该命令用于模块作为中心设备时设置连接参数。 AT+QBLECONNPARAM 设置连接参数 设置命令 响应 AT+QBLECONNPARAM=,, 或 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。连接时间间隔值。范围：0x0006~0x0C80（对应的时间范围：7.5 毫秒~4 秒）； 默认值：30；单位：1.25 毫秒。 整型。LE 链路的监督超时。范围：0x000A~0x0C80（对应的时间范围：100 毫秒~32 秒）；默认值：500；单位：10 毫秒。 整型。从设备延迟一定数量的连接事件。范围：0~499（0x0000~0x01F3）。默认值： 0。 2.2.15. AT+QBLECFGMTU 设置 BLE 最大传输单元 该命令用于模块作为中心设备时设置 BLE 最大传输单元。 AT+QBLECFGMTU 设置 BLE 最大传输单元 查询命令 响应 AT+QBLECFGMTU? +QBLECFGMTU: OK 上海移远通信技术股份有限公司 33 / 106 FC41D AT 命令手册 设置命令 AT+QBLECFGMTU= 最大响应时间 特性说明 或 ERROR 响应 OK +QBLEMTU: 或 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。最大传输单元值。范围：23~512；单位：字节。 2.2.16. AT+QBLEGATTCNTFCFG 启用/禁用通知 该命令用于模块作为中心设备时启用/禁用通知。 AT+QBLEGATTCNTFCFG 启用/禁用通知 设置命令 响应 AT+QBLEGATTCNTFCFG=,< enable> OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 / 参数 字符串类型（无双引号）。特征值的 UUID。长度：2 字节或 16 字节。 整型。启用/禁用通知。 0 禁用 1 启用 上海移远通信技术股份有限公司 34 / 106 FC41D AT 命令手册 2.2.17. AT+QBLEGATTCWR 发送数据 该命令用于模块作为中心设备时发送 GATT 数据。 AT+QBLEGATTCWR 发送数据 设置命令 响应 AT+QBLEGATTCWR=[,], 或 ERROR 最大响应时间 300 毫秒 特性说明 / 参数 字符串类型（无双引号）。特征值的 UUID。长度：2 字节或者 16 字节。 整型。十六进制数据长度。使用该参数时，模块会将转换为十六进制再进行 发送，例如，若为 123456，模块会将该数据转换成 0x123456 进行发送。 字符串类型（无双引号）。GATT 数据。 2.2.18. AT+QBLEGATTCRD 读取数据 该命令用于模块作为中心设备时读取 GATT 数据。 AT+QBLEGATTCRD 读取数据 设置命令 AT+QBLEGATTCRD= 最大响应时间 特性说明 响应 OK 或 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型（无双引号）。特征值的 UUID。长度：2 字节或 16 字节。 字符串类型（无双引号）。读取到的 GATT 数据。 上海移远通信技术股份有限公司 35 / 106 2.2.19. AT+QBLEDISCONN 断开 BLE 连接 该命令用于断开 BLE 连接。 AT+QBLEDISCONN 断开 BLE 连接 执行命令 AT+QBLEDISCONN 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / 2.2.20. AT+QBLESTAT 查询 BLE 设备状态 该命令用于查询 BLE 设备状态。 AT+QBLESTAT 执行命令 AT+QBLESTAT 查询 BLE 设备状态 响应 +QBLESTAT: 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 字符串类型（无双引号）。BLE 设备当前状态。 NOINIT 未初始化状态 INIT 初始化状态 ADVERTISING 广播状态 NOADVERTISING 无广播状态 CONNECTED 连接状态 DISCONNECTED 断开连接状态 FC41D AT 命令手册 上海移远通信技术股份有限公司 36 / 106 FC41D AT 命令手册 2.3. TCP/UDP 相关 AT 命令详解 2.3.1. AT+QICFG 配置 TCP/UDP Socket 服务相关参数 AT+QICFG 配置 TCP/UDP Socket 服务相关参数 测试命令 AT+QICFG=? 响应 +QICFG: 'transpktsize',(支持的范围) +QICFG: 'transwaittm',(支持的范围) +QICFG: 'accept/mode',(支持的列表) +QICFG: 'tcp/tw_cycle',(支持的列表) +QICFG: 'datatype',(支持的列表) 设置命令 配置透传模式下数据发送的分包长度 AT+QICFG='transpktsize'[,] OK 响应 若省略可选参数，则查询当前配置： +QICFG: 'transpktsize', OK 设置命令 配置透传模式下串口接收用户数据的等 待时间 AT+QICFG='transwaittm'[,] 若指定可选参数，则设置透传模式下数据发送的分包长度： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'transwaittm', OK 设置命令 配置'TCP Incoming'连接的接入方式 AT+QICFG='accept/mode'[,] 若指定可选参数，则设置透传模式下串口接收用户数据的等待 时间： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'accept/mode', OK 若指定可选参数，则配置'TCP Incoming'连接的接入方式： OK 上海移远通信技术股份有限公司 37 / 106 FC41D AT 命令手册 设置命令 配置'TCP'连接占用端口的释放方式 AT+QICFG='tcp/tw_cycle'[,] 或 ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/tw_cycle', OK 设置命令 配置发送数据格式 AT+QICFG='datatype'[,] 若指定可选参数，则配置'TCP'连接占用端口的释放方式： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'datatype', OK 最大响应时间 特性说明 若指定可选参数，则配置发送数据格式： OK 或 ERROR 300 毫秒 / 参数 整型。待发数据的分包长度。范围：1~1460；默认值：1024；单位：字节。 整型。透传模式下，串口已接收的数据小于时，继续等待串口数据 的时长。当=0 时，表示收到数据立即发送。范围：0~20；默认值： 2；单位：100 毫秒。 整型。TCP Incoming 连接请求的接入方式。 0 自动接入 1 手动接入，通过 AT+QIACCEPT 接受 整型。TCP 连接释放占用端口的方式。 0 立即释放 1 延时释放 整型。发送的数据格式。 0 非十六进制字符串 1 十六进制字符串 上海移远通信技术股份有限公司 38 / 106 FC41D AT 命令手册 2.3.2. AT+QIOPEN 打开 TCP/UDP Socket 服务 该命令用于打开 TCP/UDP Socket 服务。TCP 客户端建立的最大响应时间由 TCP 三次握手的最大超 时时间决定。FC41D 模块支持 TCP 三次握手的最大超时时间为 120 秒；当为'UDP'、'TCP LISTENER'或'UDP SERVICE'时，建立 Socket 服务的最大响应时间约为 300 毫秒。 AT+QIOPEN 打开 TCP/UDP Socket 服务 测试命令 AT+QIOPEN=? 响应 +QIOPEN: (支持的范围),(支持的 列 表 ),'ip/dns',( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) 设置命令 AT+QIOPEN=,,,,, OK 响应 若等于 2： CONNECT 或 ERROR 若不等于 2： OK 最大响应时间 特性说明 +QIOPEN: , 或 ERROR / / 参数 整型。Socket ID。范围：0~11。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'UDP SERVICE' 建立 UDP 服务 字符串类型。远端服务器的地址。仅当是'TCP'/'UDP'时才有效。 字符串类型。远端服务器的域名。仅当是'TCP'/'UDP'时才有效。 整型。远程服务器端口。仅当是'TCP'/'UDP'时才有效。范围： 1~65535。 整型。本地端口。当为'TCP LISTENER'/'UDP SERVICE'时，该 参数必须指定。范围：1~65535。 上海移远通信技术股份有限公司 39 / 106 FC41D AT 命令手册 整型。串口数据模式。 0 缓存模式。Socket 通过 AT 命令收发数据 1 直吐模式。Socket 通过 AT 命令发送数据，收到数据通过 URC 方式上报 2 透传模式。通过串口接收的数据会直接发送到网络端，从网络接收到的数据会 从串口直接输出 整型。结果码。详见第 5 章。 备注 当='TCP LISTENER'/'UDP SERVICE'时，不能设置为 2。 2.3.3. AT+QISTATE 查询 TCP/UDP Socket 服务状态 AT+QISTATE 查询 TCP/UDP Socket 服务状态 设置命令 AT+QISTATE= 响应 +QISTATE: ,,,< remote_port>,, 查询命令 AT+QISTATE? OK 响应 返回现存所有连接状态： [+QISTATE: ,,,< remote_port>,,] […] 执行命令 AT+QISTATE OK 响应 返回现存所有连接状态： [+QISTATE: ,,,< remote_port>,,] […] 最大响应时间 特性说明 OK 300 毫秒 / 上海移远通信技术股份有限公司 40 / 106 参数 FC41D AT 命令手册 整型。Socket ID。范围：0~11。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'UDP SERVICE' 建立 UDP 服务 'TCP INCOMING' 建立 TCP 服务器接受的 TCP 连接 字 符 串 类 型。 远 端服 务 器的 地 址 ， 仅当 为 'TCP'/'UDP'/'TCP INCOMING'时有效。 整 型 ， 远 端 服 务 器 的 端 口 号 ， 仅 当 为 'TCP'/'UDP'/'TCP INCOMING'时有效。 整型。本地端口号。 整型。Socket 服务状态。 0 'Initial' 尚未建立连接 1 'Opening' 客户端正在连接或者服务器正尝试监听 2 'Connected' 客户端连接已建立 3 'Listening' 服务器正在监听 4 'Closing' 连接断开 2.3.4. AT+QISEND 通过 TCP/UDP Socket 服务发送数据 AT+QISEND 通过 TCP/UDP Socket 服务发送数据 测试命令 响应 AT+QISEND=? +QISEND: (支持的范围),(支持的范 围),'data'[,'remote_ip',(支持的范围)] 设置命令 当为 0，可查询发送数据大小 AT+QISEND=,0 OK 响应 +QISEND: ,, OK 或 设置命令 若为'UDP SERVICE' AT+QISEND=,, ERROR 响应 +QISEND: ,, OK 或 ERROR 上海移远通信技术股份有限公司 41 / 106 设置命令 若为'TCP'/'UDP'/'TCP INCOMING' AT+QISEND=,, 响应 +QISEND: OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / FC41D AT 命令手册 参数 整型。Socket ID。范围：0~11。 整型。待发送数据字节长度。范围：0~1460；单位：字节。 字符串类型。待发送的数据。默认为十六进制字符串。 字符串类型。待发送数据的目标地址。仅当为'UDP SERVICE' 才有效。 整型。待发送数据的目标端口。仅当为'UDP SERVICE'才有效。 范围：1~65535。 整型。实际写入 Socket 中的数据长度。单位：字节。 整型。写入 Socket 中的总数据长度。单位：字节。 整型。已经被应答的数据长度。单位：字节。 整型。未被应答的数据长度。单位：字节。 2.3.5. AT+QIRD 读取 TCP/UDP Socket 服务收到的数据 AT+QIRD 读取 TCP/UDP Socket 服务收到的数据 测试命令 AT+QIRD=? 响应 +QIRD: (支持的范围),(支持的范围) 设置命令 当为 0，可查询接收数据大小 AT+QIRD=,0 OK 响应 +QISEND: ,, OK 或 设置命令 当为'UDP SERVICE' AT+QIRD=, ERROR 响应 +QIRD: ,, 上海移远通信技术股份有限公司 42 / 106 设置命令 当为'TCP'/'UDP'/'TCP INCOMING' AT+QIRD=, OK 或 ERROR 响应 +QIRD: OK 或 ERROR 最大响应时间 300 毫秒 特性说明 / FC41D AT 命令手册 参数 整型。Socket ID。范围：0~11。 整型。待读取的数据长度。范围：0~1500；单位：字节。 字符串类型。接收数据的源地址。仅当为'UDP SERVICE'才有效。 整型。接收数据的源端口。仅当为'UDP SERVICE'才有效。 整型。实际读取的数据长度。单位：字节。 整型。Socket 收到的总数据长度。单位：字节。 整型。已经被读取的数据长度。单位：字节。 整型。未被读取的数据长度。单位：字节。 字符串类型（无双引号）。实际读取的数据。单位：字节。 2.3.6. AT+QIACCEPT 接受/拒绝 TCP/UDP Socket 服务远端接入请求 AT+QIACCEPT 接受/拒绝 TCP/UDP Socket 服务远端接入请求 测试命令 AT+QIACCEPT=? 响应 +QIACCEPT: (支持的范围),(支持的列表),(支持的范围) 设置命令 接受/拒绝连接请求 AT+QIACCEPT=, [,] OK 响应 [+QIACCEPT: ,,] OK 或 ERROR 上海移远通信技术股份有限公司 43 / 106 FC41D AT 命令手册 最大响应时间 特性说明 300 毫秒 / 参数 整型。TCP Server 的 Socket 连接号。范围：0~11。 整型。拒绝或接受 TCP/UDP Socket 服务远端接入请求。 0 拒绝 1 接受 整型。接入连接的 Socket 连接号。仅当=1 时有效。范围：0~11。 字符串类型。接入连接的源地址。 整型。接入连接的源端口。 2.3.7. AT+QISWTMD 切换数据访问模式 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应 +QISWTMD: ( 支 持 的 范 围 ),( 支 持 的 范围) 设置命令 AT+QISWTMD=, 最大响应时间 OK 响应 OK 或 CONNECT 或 ERROR 300 毫秒 特性说明 / 参数 整型。Socket ID。范围：0~11。 整型。串口数据模式。 0 缓存模式。Socket 通过 AT 命令收发数据 1 直吐模式。Socket 通过 AT 命令发送数据，收到数据通过 URC 方式上报 2 透传模式。通过串口接收的数据会直接发送到网络端，从网络接收到的数 据会从串口直接输出 上海移远通信技术股份有限公司 44 / 106 FC41D AT 命令手册 2.3.8. AT+QICLOSE 关闭 TCP/UDP Socket 服务 AT+QICLOSE 关闭 TCP/UDP Socket 服务 测试命令 AT+QICLOSE=? 响应 +QICLOSE: ( 支 持 的 范 围 ),( 支 持 的 范围) 设置命令 AT+QICLOSE=[,] 最大响应时间 OK 响应 OK +QIURC: 'closed', 或 ERROR / 特性说明 / 参数 整型。Socket ID。范围：0~11。 整型。Socket 服务关闭的超时时长。范围：1~60；默认值：2；单位：秒。 2.3.9. AT+QIGETERROR 查询 TCP/UDP Socket 服务相关的结果码 AT+QIGETERROR 执行命令 AT+QIGETERROR 查询 TCP/UDP Socket 服务相关的结果码 响应 +QIGETERROR: , 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。结果码。请参考第 5 章。 字符串类型。结果码描述。 上海移远通信技术股份有限公司 45 / 106 2.3.10. ATO 进入透传模式 ATO 进入透传模式 执行命令 ATO 最大响应时间 特性说明 响应 CONNECT 或 NO CARRIER 300 毫秒 / 备注 如果之前没有建立 Socket 连接，ATO 返回 NO CARRIER。 FC41D AT 命令手册 2.3.11. +++ 退出透传模式 +++ 退出透传模式 执行命令 +++ 最大响应时间 特性说明 响应 OK 300 毫秒 / 备注 +++退出透传模式后，如果 Socket 连接没有断开，可以通过 ATO 再次进入透传模式。 上海移远通信技术股份有限公司 46 / 106 FC41D AT 命令手册 2.4. SSL 相关 AT 命令详解 2.4.1. AT+QSSLCFG 配置 SSL 上下文参数 AT+QSSLCFG 配置 SSL 上下文参数 测试命令 AT+QSSLCFG=? 响应 +QSSLCFG: 'version',(支持的范围),(支持的 范围) +QSSLCFG: 'verify',( 支 持 的 范 围 ),( 支 持 的 范围) +QSSLCFG: 'ciphersuite',( 支 持 的 范 围), +QSSLCFG: 'negotiatetimeout',( 支 持 的 范 围),(支持的范围) +QSSLCFG: 'sni',( 支 持 的 范 围 ),( 支 持 的 范围) 设置命令 配置 SSL 版本号 AT+QSSLCFG='version',[,] OK 响应 若省略可选参数，则查询当前配置： +QSSLCFG: 'version',, OK 设置命令 配置 SSL 校验等级 AT+QSSLCFG='verify', [,] 若指定可选参数，则配置 SSL 版本号： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QSSLCFG: 'verify',, OK 设置命令 配置加密套件 AT+QSSLCFG='ciphersuite',[,[[,[,…]]] 若指定可选参数，则配置 SSL 校验等级： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QSSLCFG: 'ciphersuite',[,[,[,…]]] 上海移远通信技术股份有限公司 47 / 106 FC41D AT 命令手册 OK 设置命令 配置 SSL 握手的超时时间 AT+QSSLCFG='negotiatetimeout',< SSL_ctxID>[,] 若指定可选参数，则配置加密套件： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QSSLCFG: 'negotiatetimeout',, OK 设置命令 启用或禁用 TLS 服务器名称显示功能 AT+QSSLCFG='sni',[,< SNI_value>] 若指定可选参数，则配置 SSL 握手的超时时间： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QSSLCFG: 'sni',, OK 最大响应时间 特性说明 若指定可选参数，则启用或禁用 TLS 服务器名称显示功能： OK 或 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。SSL 上下文 ID。范围：0~5。 整型。SSL 版本号。 0 SSL3.0 1 TLS1.0 2 TLS1.1 3 TLS1.2 4 以上都支持 整型。SSL 的校验等级。 上海移远通信技术股份有限公司 48 / 106 FC41D AT 命令手册 0 无认证方式 1 单向认证（客户端验证服务器的合法性） 2 双向认证（客户端与服务器相互验证对方的合法性） 十六进制的整型，以 0x 开头。0xFFFF 表示支持全部加密套件。 0x0004 TLS_RSA_WITH_RC4_128_MD5 0x0005 TLS_RSA_WITH_RC4_128_SHA 0x002F TLS_RSA_WITH_AES_128_CBC_SHA 0x0035 TLS_RSA_WITH_AES_256_CBC_SHA 0x003C TLS_RSA_WITH_AES_128_CBC_SHA256 0x003D TLS_RSA_WITH_AES_256_CBC_SHA256 0xc027 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xc02F TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 整型。SSL 握手的超时时间。范围：60~300；默认值：120；单位：秒。 整型。启用或禁用 TLS 服务器名称显示功能。 0 禁用 1 启用 2.4.2. AT+QSSLCERT 上传/下载/删除 SSL 证书 AT+QSSLCERT 上传/下载/删除 SSL 证书 测试命令 AT+QSSLCERT=? 响应 +QSSLCERT: (支持的列表),(支持的范围) 查询命令 AT+QSSLCERT? OK 响应 [+QSSLCERT: ,] […] OK 设置命令 上传证书 AT+QSSLCERT=,, 响应 CONNECT //返回 CONNECT 后输入文件内容，输入内容将自动写入 flash 中。输入内容长度达到指定长度后模块退出数据模式。 OK 或 ERROR 设置命令 下载证书 AT+QSSLCERT=, 响应 +QSSLCERT: , //输出文件内容 OK 或 上海移远通信技术股份有限公司 49 / 106 FC41D AT 命令手册 ERROR 设置命令 删除证书 AT+QSSLCERT=, 响应 OK 或 ERROR 最大响应时间 取决于用户输入数据的速度 特性说明 该命令立即生效； 参数配置自动保存。 参数 字符串类型。证书类型。 'CA' CA 证书。 'User Cert' 客户端证书。 'User Key' 客户端 Key 文件。 整型。操作模式。 0 删除证书 1 下载证书 2 上传证书 整型。证书内容的长度。 整型。证书是否存在。 0 不存在 1 存在 2.4.3. AT+QSSLOPEN 打开 SSL 客户端 该命令用于打开 SSL 客户端，创建 SSL 连接。SSL 连接的建立包含 TCP 三次握手和 SSL 握手两个过 程，因此该命令的最大超时时间是 TCP 三次握手的超时时间（120 秒）与的总和。 AT+QSSLOPEN 打开 SSL 客户端 测试命令 AT+QSSLOPEN=? 响应 +QSSLOPEN: ( 支 持 的 范 围 ),( 支 持 的 范 围 ),'ip/dns',( 支 持 的 范 围 ),( 支 持的范围),(支持的范围) 设置命令 AT+QSSLOPEN=,,,[,,] OK 响应 如果等于 2： CONNECT 或 ERROR 上海移远通信技术股份有限公司 50 / 106 FC41D AT 命令手册 最大响应时间 特性说明 如果不等于 2： OK +QSSLOPEN: , 或 ERROR / / 参数 整型。SSL 上下文 ID。范围：0~5。 整型。Socket ID。范围：0~11。 字符串类型。远端服务器的地址。 字符串类型。远端服务器的域名。 整型。远程服务器端口。仅当是'TCP'/'UDP'时才有效。范围： 1~65535。 整型。本地端口。范围：1~65535。 整型。串口数据模式。 0 缓存模式。Socket 通过 AT 命令收发数据 1 直吐模式。Socket 通过 AT 命令发送数据，收到数据通过 URC 方式上报 2 透传模式。通过串口接收的数据会直接发送到网络端，从网络接收到的数 据会从串口直接输出 整型。结果码。请参考第 5 章。 2.4.4. AT+QSSLSEND 通过 SSL 客户端发送数据 AT+QSSLSEND 通过 SSL 客户端发送数据 测试命令 响应 AT+QSSLSEND=? +QSSLSEND: (支持的范围),(支持的 范围) 设置命令 AT+QSSLSEND=,, OK 响应 +QSSLSEND: OK 或 ERROR 上海移远通信技术股份有限公司 51 / 106 FC41D AT 命令手册 最大响应时间 特性说明 300 毫秒 / 参数 整型。Socket ID。范围：0~11。 整型。待发送数据的长度。范围：1~1460；单位：字节。 字符串类型。待发送的数据。 整型。实际写入的数据长度。单位：字节。 2.4.5. AT+QSSLRECV 读取 SSL 客户端收到的数据 AT+QSSLRECV 读取 SSL 客户端收到的数据 测试命令 响应 AT+QSSLRECV=? +QSSLRECV: ( 支 持 的 范 围 ),( 支 持 的 范围) 设置命令 AT+QSSLRECV=, OK 响应 +QSSLRECV: 最大响应时间 特性说明 OK 或 ERROR 300 毫秒 / 参数 整型。Socket ID。范围：0~11。 整型。读取的数据长度。单位：字节。 整型。实际读取的数据长度。单位：字节。 字符串类型（无双引号）。实际读取的数据。 上海移远通信技术股份有限公司 52 / 106 FC41D AT 命令手册 2.4.6. AT+QSSLSTATE 查询 SSL 客户端状态 AT+QSSLSTATE 查询 SSL 客户端状态 设置命令 AT+QSSLSTATE= 响应 +QSSLSTATE: ,'SSL CLIENT',,,, 查询命令 AT+QSSLSTATE? OK 或 ERROR 响应 返回现存所有连接状态： [+QSSLSTATE: ,'SSL CLIENT',,,,] […] 执行命令 AT+QSSLSTATE OK 响应 返回现存所有连接状态： [+QSSLSTATE: ,'SSL CLIENT',,,,] […] 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。Socket ID。范围：0~11。 字符串类型。远端服务器的地址。 整型。远端服务器的端口号。 整型。本地端口号。 整型。Socket 服务状态。 0 'Initial' 尚未建立连接 1 'Opening' 客户端正在连接或者服务器正尝试监听 2 'Connected' 客户端连接已建立 3 'Listening' 服务器正在监听 4 'Closing' 连接断开 上海移远通信技术股份有限公司 53 / 106 FC41D AT 命令手册 2.4.7. AT+QSSLCLOSE 关闭 SSL 客户端 AT+QSSLCLOSE 关闭 SSL 客户端 测试命令 AT+QSSLCLOSE=? 响应 +QSSLCLOSE: ( 支 持 的 范 围 ),( 支 持 的 范围) 设置命令 AT+QSSLCLOSE=[,] 最大响应时间 特性说明 OK 响应 OK +QSSLURC: 'closed', 或 ERROR / / 参数 整型。Socket ID。范围：0~11。 整型。关闭 SSL 客户端的超时时间。范围：1~60；默认值：10；单位：秒。 2.5. MQTT 相关 AT 命令详解 2.5.1. AT+QMTCFG 配置 MQTT 客户端可选参数 该命令用于配置 MQTT 客户端可选参数。 AT+QMTCFG 配置 MQTT 客户端可选参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'version',( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'datatype',( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'ssl',( 支 持 的 范 围 ),( 支 持 的 列表),(支持的范围) +QMTCFG: 'keepalive',( 支 持 的 范 围 ),( 支 持 的 范围) +QMTCFG: 'session',( 支 持 的 范 围 ),( 支 持 的 上海移远通信技术股份有限公司 54 / 106 FC41D AT 命令手册 列表) +QMTCFG: 'timeout',( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'will',( 支 持 的 范 围 ),( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 列表),'willtopic','willmessage' +QMTCFG: 'recv/mode',( 支 持 的 范 围 ),( 支 持 的 列表) 设置命令 设置 MQTT 协议版本号 AT+QMTCFG='version',[,< vsn>] OK 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'version',, OK 设置命令 设置发送数据格式 AT+QMTCFG='datatype',[, ] 若指定可选参数，则设置 MQTT 协议版本号： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'datatype',, OK 若指定可选参数，则设置 MQTT 客户端发送数据格式： OK 或 设置命令 ERROR 响应 启 用 或 禁 用 SSL 连 接 若省略可选参数，则查询当前配置： AT+QMTCFG='ssl',[,<SSL +QMTCFG: 'ssl',,[,] _enable>[,]] OK 设置命令 设置 MQTT 协议保活时间 AT+QMTCFG='keepalive',[ 若指定任意可选参数，启用或禁用 SSL 连接： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'keepalive',, 上海移远通信技术股份有限公司 55 / 106 FC41D AT 命令手册 ,] OK 设置命令 设置 MQTT 协议会话类型 AT+QMTCFG='session',[, ] 若指定可选参数，则设置 MQTT 协议保活时间： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'session',, OK 设置命令 设置 MQTT 客户端等待响应的超时时间 AT+QMTCFG='timeout',[,< delivery_tm>,,] 若指定可选参数，则设置 MQTT 协议会话类型： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'timeout',,,, OK 设置命令 设置 MQTT 协议 Will 参数 AT+QMTCFG='will',[,,,,,] 若指定可选参数，则设置 MQTT 客户端等待响应的超时时间： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'will',,,,,, OK 设置命令 设置 MQTT 客户端接收信息的读取方式 AT+QMTCFG='recv/mode',[,] 若指定可选参数，则设置 MQTT 协议 Will 参数： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'recv/mode',, OK 上海移远通信技术股份有限公司 56 / 106 FC41D AT 命令手册 最大响应时间 特性说明 若指定可选参数，则设置 MQTT 客户端接收信息的读取方式： OK 或 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。MQTT 协议的版本号。 3 MQTT 协议 V3 4 MQTT 协议 V4 整型。发送数据格式。 0 非十六进制字符串 1 十六进制字符串 整型。启用/禁用 SSL 连接。 0 禁用。普通 TCP 连接 1 启用 SSL 连接 整型。SSL 上下文 ID。范围：0~5。 整型。保活时间。允许 MQTT 客户端和服务器之间没有数据交互的最大空闲时间。 MQTT 客户端与服务器之间，通过 pingReq、pingResp 消息来保活。 范围：1~3600；默认值：120；单位：秒。 整型。对应 MQTT CONNECT 消息中的会话类型的字段值。 0 该连接则被认为是持久连接。当该客户端断开后，任何订阅的主题和 QoS 被 设置为 1 或 2 的信息都会保存，直到该客户端再次连接上服务器。 1 当该客户端断开后，所有的订阅主题都会被移除。 整型。MQTT 客户端发送完 MQTT 消息后，等待服务器回复消息的最大时长。 范围：1~60；默认值：5；单位：秒。 整型。MQTT 客户端重传 MQTT 消息的最大次数。范围：1~10；默认值：3。 整型。当 MQTT 消息发生重传时，是否以 URC 的形式上报。 0 不上报 1 上报（详情可参考 AT+QMTSUB，AT+QMTPUB 和 AT+QMTUNS。） 整型。MQTT CONNECT 消息中的字段值。 0 忽略，，和的配置 1 将，，和通过 MQTT CONNECT 消息发送到服务器 整型。对应的 QoS 级别。 0 至多发送一次 1 至少发送一次 2 只发送一次 上海移远通信技术股份有限公司 57 / 106 FC41D AT 命令手册 整型。MQTT 客户端意外断开后，服务器是否永久保存已发布的。 0 清除，不永久保存 1 永久保存 字符串类型。Will 主题名称。 字符串类型。客户端意外断开后发布到 Will 主题的消息内容。 整型。MQTT 消息接收方式。 0 直吐方式 1 缓存方式（需要通过 AT+QMTRECV 读取） 备注 在 MQTT 客户端与服务器之间建立 MQTT 连接前，需配置 MQTT 客户端可选参数。 2.5.2. AT+QMTOPEN 建立 MQTT 客户端与服务器之间的会话连接 该命令用于为 MQTT 建立客户端与服务器之间的会话连接。 AT+QMTOPEN 建立 MQTT 客户端与服务器之间的会话连接 测试命令 响应 AT+QMTOPEN=? +QMTOPEN: (支持的范围),'hostname',(支持的 范围) 查询命令 AT+QMTOPEN? OK 响应 返回现存所有连接服务器信息： [+QMTOPEN: ,,] […] 设置命令 AT+QMTOPEN=,, OK 响应 OK 最大响应时间 +QMTOPEN: , 或 ERROR 300 毫秒 特性说明 / 上海移远通信技术股份有限公司 58 / 106 参数 整型。MQTT 客户端标识符。范围：0~5。 字符串类型。MQTT 服务器的地址。 整型。MQTT 服务器的端口号。范围：1~65535。 整型。命令执行结果。 -1 Socket 连接失败 0 MQTT 会话连接建立成功 1 参数错误 2 MQTT 标识符被占用 3 内存不足 4 域名解析失败 5 Socket 被异常关闭 FC41D AT 命令手册 2.5.3. AT+QMTCLOSE 关闭 MQTT 客户端与服务器之间的会话连接 该命令用于为 MQTT 关闭客户端与服务器之间的会话连接。 AT+QMTCLOSE 关闭 MQTT 客户端与服务器之间的会话连接 测试命令 AT+QMTCLOSE=? 响应 +QMTCLOSE: (支持的范围) 设置命令 AT+QMTCLOSE= OK 响应 OK 最大响应时间 特性说明 +QMTCLOSE: , 或 ERROR 300 毫秒 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。命令执行结果。 -1 执行失败 0 执行成功 上海移远通信技术股份有限公司 59 / 106 FC41D AT 命令手册 2.5.4. AT+QMTCONN 在 MQTT 客户端与服务器之间建立 MQTT 连接 该命令用于在 MQTT 客户端与服务器之间建立 MQTT 连接。 AT+QMTCONN 在 MQTT 客户端与服务器之间建立 MQTT 连接 测试命令 AT+QMTCONN=? 响应 +QMTCONN: (支持的范围),'client_identity','us ername','password' 查询命令 AT+QMTCONN? OK 响应 返回现存所有连接状态： [+QMTCONN: ,] […] 设置命令 AT+QMTCONN=,,, 最大响应时间 OK 响应 OK +QMTCONN: ,[,] 或者 ERROR 300 毫秒 特性说明 / 参数 整型。MQTT 客户端标识符。范围：0~5。 字符串类型。客户端标识符。 字符串类型。客户端对应的用户名。 字符串类型。客户端对应的密码。 整型。MQTT 连接的状态。 1 初始化 2 正在连接 3 已连接 4 正在断开连接 整型。命令执行结果。 0 发送 CONNECT 消息成功，并且收到 CONNECTACK 消息 1 发送 CONNECT 消息成功，但在规定的响应时间内，没有收到 CONNECTACK 消息 2 发送 CONNECT 消息失败 整型。连接状态返回码。 上海移远通信技术股份有限公司 60 / 106 0 接受连接 1 拒绝连接：不接受的协议版本 2 拒绝连接：标识符被拒绝 3 拒绝连接：服务器不可用 4 拒绝连接：用户名或密码错误 5 拒绝连接：未授权 FC41D AT 命令手册 2.5.5. AT+QMTDISC 断开 MQTT 客户端与服务器之间的连接 该命令用于断开 MQTT 客户端与服务器之间的连接。 AT+QMTDISC 断开 MQTT 客户端与服务器之间的连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的范围) 设置命令 AT+QMTDISC= OK 响应 OK 最大响应时间 特性说明 +QMTDISC: , 或 ERROR 300 毫秒 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。命令执行结果。 -1 执行失败 0 执行成功 上海移远通信技术股份有限公司 61 / 106 FC41D AT 命令手册 2.5.6. AT+QMTSUB 订阅主题 该命令用于订阅 MQTT 服务器发布的主题消息。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: ( 支 持 的 范 围 ),( 支 持 的 范 围),list of['topic',] 设置命令 AT+QMTSUB=,,,[,,[,..]] 最大响应时间 OK 响应 OK +QMTSUB: ,,[,] 或 ERROR 300 毫秒 特性说明 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。SUBSCRIBE 消息的标识。范围：1~65535。 整型。的 QoS 级别。 0 至多发送一次 1 至少发送一次 2 只发送一次 字符串类型。订阅的主题。 整型。命令执行结果。 0 发送 SUBSCRIBE 消息成功，并且收到 SUBACK 消息 1 发送 SUBSCRIBE 消息成功，但在规定的响应时间内，没有收到 SUBACK 消息， 执行 SUBSCRIBE 消息重传机制 2 发送 SUBSCRIBE 消息失败 整型。 当为 0 时，表示 SUBACK 消息回复的 QoS。 当为 1 时，表示 SUBSCRIBE 消息的重传次数。 当为 2 时，这个参数没有意义，此字段为空。 备注 当前支持一次最多订阅 5 个主题。 上海移远通信技术股份有限公司 62 / 106 FC41D AT 命令手册 2.5.7. AT+QMTUNS 取消订阅主题 该命令用于取消订阅 MQTT 服务器发布的主题消息。客户端可以向服务器发送 UNSUBSCRIBE 消息 来取消已订阅的主题。 AT+QMTUNS 取消订阅主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: (支持的范围),(支持的范 围),list of['topic'] 设置命令 AT+QMTUNS=,,[,[,..]] 最大响应时间 OK 响应 OK +QMTUNS: ,, 或 ERROR 300 毫秒 特性说明 / 参数 整型。MQTT 客户端标识符。范围：0~5。. 整型。UNSUBSCRIBE 消息的标识。范围：1~65535。 字符串类型。取消订阅的主题。 整型。命令执行结果。 0 发送 UNSUBSCRIBE 消息成功，并且收到 UNSUBACK 消息 1 发送 UNSUBSCRIBE 消息成功，但在规定的响应时间内，没有收 UNSUBACK 消 息，执行 UNSUBSCRIBE 消息重传机制 2 发送 UNSUBSCRIBE 消息失败 备注 当前支持一次最多取消订阅 5 个主题。 上海移远通信技术股份有限公司 63 / 106 FC41D AT 命令手册 2.5.8. AT+QMTPUB 通过 MQTT 服务器发布消息 该命令用于通过 MQTT 服务器发布消息。 AT+QMTPUB 通过 MQTT 服务器发布消息 测试命令 响应 AT+QMTPUB=? +QMTPUB: ( 支 持 的 范 围 ),( 支 持 的 范 围),(支持的范围),(支持的列表),'topic',(支持 的范围),'payload' 设置命令 AT+QMTPUB=,,< QoS>,,,, 最大响应时间 OK 响应 OK +QMTPUB: ,[,] 或 ERROR 300 毫秒 特性说明 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。PUBLISH 消息的标识。范围：0~65535。 当 QoS 等于 0 时，必须等于 0； 当 QoS 大于 0 时，必须大于 0。 整型。发布消息的 QoS 级别。 0 至多发送一次 1 至少发送一次 2 只发送一次 整型。MQTT 客户端意外断开后，服务器是否永久保存已发布的消息。 0 清除，不永久保存 1 永久保存 字符串类型。待发布的主题消息。 整型。待发布消息的长度。范围：1~1500；单位：字节。 字符串类型。待发布的消息。 整型。命令执行结果。 0 发送 PUBLISH 消息成功，并且收到 ACK 消息 1 发送 PUBLISH 消息成功，但在规定的响应时间内，没有收到 ACK 消息，执行 PUBLISH 消息重传机制 2 发送 PUBLISH 消息失败 整型。 上海移远通信技术股份有限公司 64 / 106 当为 1 时，表示 PUBLISH 消息的重传次数 当为 0 或 2 时，这个参数没有意义，此字段为空 FC41D AT 命令手册 2.5.9. AT+QMTRECV 读取 MQTT 服务器发布的消息 该命令用于从存储缓存中读取消息，服务器上报消息是都会存储到此缓存中。 AT+QMTRECV 读取 MQTT 服务器发布的消息 测试命令 响应 AT+QMTRECV=? 查询命令 AT+QMTRECV? OK 响应 [+QMTRECV: ,,,,,] […] 设置命令 AT+QMTRECV=[,] OK 响应 若省略可选参数，则读取指定客户端的所有缓存的消息： [+QMTRECV: ,,,,] […] OK 若指定可选参数，则读取指定客户端指定的消息： +QMTRECV: ,,,, 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。消息缓存的 ID。范围：0~4。 整型。对应 storeID4 有没有缓存消息。 0 没有缓存消息 1 有缓存消息 整型。对应 storeID3 有没有缓存消息。 0 没有缓存消息 1 有缓存消息 上海移远通信技术股份有限公司 65 / 106 整型。对应 storeID2 有没有缓存消息。 0 没有缓存消息 1 有缓存消息 整型。对应 storeID1 有没有缓存消息。 0 没有缓存消息 1 有缓存消息 整型。对应 storeID0 有没有缓存消息。 0 没有缓存消息 1 有缓存消息 整型。PUBLISH 消息的标识。范围：0~65535。 当 QoS 等于 0 时，必须等于 0； 当 QoS 大于 0 时，必须大于 0。 字符串类型。服务器发布的主题。 整型。接收到的消息长度。 字符串类型。接收到的消息。 FC41D AT 命令手册 2.6. HTTP(S)相关 AT 命令详解 HTTP(S)请求包含 HTTP(S)会话的建立和 HTTP(S)报文的交互，因此 HTTP(S)请求的最大响应时间由 HTTP(S)会话建立的时间和 HTTP(S)报文交互的时间来决定。FC41D 模块支持 TCP 三次握手的最大超时 为 120 秒。SSL 握手的超时由决定（默认值为 120 秒）。HTTP(S)请求发送后，等待响 应的时间为（默认为 60 秒）。 2.6.1. AT+QHTTPCFG 配置 HTTP(S)客户端参数 AT+QHTTPCFG 配置 HTTP(S)客户端参数 测试命令 AT+QHTTPCFG=? 响应 +QHTTPCFG: 'url', +QHTTPCFG: 'header',, +QHTTPCFG: 'auth',, +QHTTPCFG: 'response/output',(支持的 列表) +QHTTPCFG: 'response/header',( 支 持 的 列表) +QHTTPCFG: 'sslctxid',(支持的范围) 设置命令 配置待访问的 URL AT+QHTTPCFG='url'[,] OK 响应 若省略可选参数，则查询当前访问的 URL： +QHTTPCFG: 'url', 上海移远通信技术股份有限公司 66 / 106 FC41D AT 命令手册 OK 设置命令 配置/删除自定义头信息 AT+QHTTPCFG='header'[, [,]] 若指定可选参数，则配置待访问的 URL： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： [+QHTTPCFG: 'header',,] […] OK 若指定可选参数，省略可选参数，则删除对 应的头信息： OK 或 ERROR 设置命令 配置基本认证参数 AT+QHTTPCFG='auth'[,,] 若指定所有可选参数，则配置自定义头信息： OK 或 ERROR 响应 若省略可选参数，则查询当前设置： +QHTTPCFG: 'auth',, OK 设置命令 配置响应数据的输出方式 AT+QHTTPCFG='response/output'[, ] 若指定可选参数，则配置基本认证参数： OK 或 ERROR 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'response/output', OK 若指定可选参数，则配置响应数据的输出方式： OK 或 上海移远通信技术股份有限公司 67 / 106 FC41D AT 命令手册 ERROR 设置命令 配置是否保留响应头信息 AT+QHTTPCFG='response/header'[ ,] 响应 若省略可选参数，则查询当前设置： +QHTTPCFG: 'response/header', OK 若指定可选参数，则配置保留或不保留响应头信息： OK 或者 ERROR 设置命令 配置 HTTP(S)会话使用的 SSL 上下文 ID AT+QHTTPCFG='sslctxid'[,<SSL_ct 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'sslctxid', xID>] OK 最大响应时间 特性说明 若指定可选参数，则配置 HTTP(S)会话使用的 SSL 上下文 ID： OK 或 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。待访问的 URL。未配置时，该参数显示为空字符串。 字符串类型。HTTP(S) 头信息的名称。未配置时，该参数显示为空字符串。 字符串类型。HTTP(S) 头信息的值。未配置时，该参数显示为空字符串。 字符串类型。HTTP(S) 基本认证的用户名。未配置时，该参数显示为空字符串。 字符串类型。HTTP(S) 基本认证的密码。未配置时，该参数显示为空字符串。 整型。响应数据的输出方式。 0 响应数据通过 AT+QHTTPREAD 读取 1 响应数据以 URC 形式直接上报（详情可参考第 3.6.5 章。） 整型。是否保留响应头信息。 0 不保留 1 保留 整型。SSL 上下文 ID。范围：0~5。 上海移远通信技术股份有限公司 68 / 106 FC41D AT 命令手册 2.6.2. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器 该命令用于向 HTTP(S)服务器发送 GET 请求。如果 HTTP(S) GET 请求发送成功，GET 的结果以 +QHTTPGET: [,[,]]方式上报至 MCU。 AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器 测试命令 AT+QHTTPGET=? 响应 +QHTTPGET: (支持的范围) 执行命令 AT+QHTTPGET=[] 最大响应时间 OK 响应 OK +QHTTPGET: [,[,]] 或 ERROR / 特性说明 / 参数 整型。发送 GET 请求后，等待服务器响应的时间。范围：60~65535；默认值： 60；单位：秒。 整型。GET 请求发送结果。 0 成功 其他 失败 整型。HTTP(S)状态码。详见第 5 章。 整型。GET 请求消息体的长度。 2.6.3. AT+QHTTPPOST 发送 POST 请求到 HTTP(S)服务器 该命令用于向 HTTP(S)服务器发送 POST 请求。如果 HTTP(S) POST 请求发送成功，POST 的结果以 +QHTTPPOST: [,[,]]方式上报至 MCU。 AT+QHTTPPOST 发送 POST 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPOST=? 响应 +QHTTPPOST: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的 范围)[,[,[,]]] 上海移远通信技术股份有限公司 69 / 106 FC41D AT 命令手册 OK 设置命令 非 Form-data 形式文件 AT+QHTTPPOST=[,<b 响应 CONNECT //输入消息主体，达到的长度后退出数据模式 ody_wait_interval>[,]] OK +QHTTPPOST: [,[,]] 或 ERROR 设置命令 Form-data 形式文件 AT+QHTTPPOST=,,<wait_response_ 响应 CONNECT //输入消息主体，达到的长度后退出数据模式 OK time>,[,[,]] +QHTTPPOST: [,[,]] 或 ERROR 最大响应时间 / 特性说明 / 参数 整型。POST 数据的长度。范围：1~102400；单位：字节。 整 型 。 消 息 主 体 输 入 的最 大 等 待 时 间 。 范 围 ：1~65535 ； 默认 值 ： 60； 单位：秒。 整型。模块内部发送 POST 请求后，等待服务器响应的时间。范围：60~65535； 默认值：60；单位：秒。 字符串类型。Form-data 名称。 字符串类型。数据上传至 HTTP(S)服务器后存储的文件名。 字符串类型。信息媒体类型。 整型。POST 请求发送结果。 0 成功 其他 失败 整型。HTTP(S)状态码。详见第 5 章。 整型。POST 请求体的长度。 上海移远通信技术股份有限公司 70 / 106 FC41D AT 命令手册 2.6.4. AT+QHTTPPUT 发送 PUT 请求到 HTTP(S)服务器 该命令用于向 HTTP(S)服务器发送 PUT 请求。如果 HTTP(S) PUT 请求发送成功，PUT 的结果以 +QHTTPPUT: [,[,]]方式上报至 MCU。 AT+QHTTPPUT 发送 PUT 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPUT=? 响应 +QHTTPPUT: (支持的范围),(支持的范围),(支持的范围) 设置命令 AT+QHTTPPUT=[,[,]] OK 响应 CONNECT //输入消息主体，达到的长度后退出数据模式 OK 最大响应时间 特性说明 +QHTTPPUT: [,[,]] 或 ERROR / / 参数 整型。PUT 数据的长度。范围：1~102400；单位：字节。 整 型 。 消 息 主 体 输 入 的最 大 等 待 时 间 。 范 围 ：1~65535 ； 默认 值 ： 60； 单位：秒。 整型。模块内部发送 PUT 请求后，等待服务器响应的时间。范围：60~65535； 默认值：60；单位：秒。 整型。PUT 请求发送结果。 0 成功 其他 失败 整型。HTTP(S)状态码。详见第 5 章。 整型。PUT 请求体的长度。 上海移远通信技术股份有限公司 71 / 106 FC41D AT 命令手册 2.6.5. AT+QHTTPREAD 读取 HTTP(S)请求的响应信息 该 命 令 用 于 读 取 HTTP(S) 请 求 的 响 应 信 息 。 若 HTTP(S) 请 求 响 应 成 功 ， 且 AT+QHTTPCFG='response/output',0 设置响应数据的输出方式为通过 AT 命令读取，可通过该命令读取 响应数据。 AT+QHTTPREAD 读取 HTTP(S)请求的响应信息 测试命令 AT+QHTTPREAD=? 响应 +QHTTPREAD: (支持的范围) 设置命令 AT+QHTTPREAD=] OK 响应 CONNECT OK 最大响应时间 特性说明 +QHTTPREAD: 或 ERROR / / 参数 整型。模块串口等待响应信息的最大时间。范围：60~65535；默认值： 60；单位：秒。 整型。响应信息的读取结果。 0 成功 其他 失败 字符串类型（无双引号）。读取到的数据。 上海移远通信技术股份有限公司 72 / 106 FC41D AT 命令手册 3 相关 URC 描述 3.1. Wi-Fi 相关 URC 详解 3.1.1. +QSTASTAT STA 状态变化提示 +QSTASTAT STA 状态变化提示 +QSTASTAT: 当 STA 状态发生变化时上报该 URC。 参数 字符串类型（无双引号）。STA 状态发生变化时上报的事件。 WLAN DISCONNECTED STA 断开连接 WLAN_CONNECTED STA 建立连接 GOT_IP STA 获取到 IP SCAN_NO_AP STA 没有扫描到 AP 3.2. BLE 相关 URC 详解 3.2.1. +QBLESTAT BLE 状态变化提示 +QBLESTAT BLE 状态变化提示 +QBLESTAT: 当 BLE 状态发生变化时上报该 URC。 参数 字符串类型（无双引号）。BLE 状态发生变化时上报的事件。 NOINIT 未初始化事件 INIT 初始化事件 ADVERTISING 广播事件 NOADVERTISING 无广播事件 上海移远通信技术股份有限公司 73 / 106 CONNECTED DISCONNECTED 连接事件 断开连接事件 FC41D AT 命令手册 3.2.2. +QBLEMTU BLE MTU 数值变化提示 +QBLEMTU BLE MTU 数值变化提示 +QBLEMTU: 当 BLE MTU 数值变化时上报该 URC。 参数 整型。最大传输单元值。范围：23~512；单位：字节。 3.2.3. +QBLEINFO BLE 为中心设备连接成功时句柄和特征值结果提示 当 BLE 作为中心设备连接其他设备成功时，上报 URC 已连接 BLE 设备的句柄和特征 UUID。 +QBLEINFO BLE 为中心设备连接成功时句柄和特征值结果提示 +QBLEINFO: 当 BLE 为中心设备连接成功时上报该 URC。 参数 整型。已连接 BLE 设备的句柄。范围：0~255。 整型。已连接 BLE 设备的特征值 UUID。长度：2 字节或 16 字节。 3.3. TCP/UDP 相关 URC 详解 3.3.1. +QIOPEN TCP/UDP Socket 服务打开结果提示 执行 AT+QIOPEN 打开 Socket 服务，通过该 URC 上报打开结果。 +QIOPEN TCP/UDP Socket 服务打开结果提示 +QIOPEN: , Socket 服务打开结果。 参数 整型。Socket ID。范围：0~11。 整型。结果码。请参考第 5 章。 上海移远通信技术股份有限公司 74 / 106 FC41D AT 命令手册 3.3.2. +QIURC: 'recv' TCP/UDP Socket 接收数据提示 Socket 服务接收数据后上报该 URC 指示数据。 +QIURC: 'recv' TCP/UDP Socket 接收数据提示 +QIURC: 'recv', 缓存模式下，接收数据的提示。 +QIURC: 'recv',, +QIURC: 'recv',,,, 直吐模式下，当不等于'UDP SERVICE'时， 接收数据的提示。 直吐模式下，当等于'UDP SERVICE'时，接 收数据的提示。 参数 整型。Socket ID。范围：0~11。 整型。数据长度。范围：1~1500。单位：字节。 字符串类型。数据的源地址。 整型。数据的源端口。 字符串类型（无双引号）。接收到的数据。 3.3.3. +QIURC: 'accept' TCP/UDP Socket 连接请求接入提示 当模块通过 AT+QICFG='accept/mode'设置手动接入时，接收连接请求时上报该 URC。 +QIURC: 'accept' TCP/UDP Socket 连接请求接入提示 +QIURC: 'accept', 手动接入方式下 Socket 服务连接请求提示。 参数 整型。Socket ID。范围：0~11。 3.3.4. +QIURC: 'closed' TCP/UDP Socket 被关闭提示 TCP/UDP Socket 连接被关闭时上报该 URC，并且 socket 服务状态显示关闭。 +QIURC: 'closed' TCP/UDP Socket 被关闭提示 +QIURC: 'closed', Socket 服务连接被断开的提示。 上海移远通信技术股份有限公司 75 / 106 参数 整型。Socket ID。范围：0~11。 FC41D AT 命令手册 3.3.5. +QIURC: 'incoming' TCP/UDP Socket 连接请求提示 当模块通过 AT+QICFG='accept/mode'设置自动接入时，接收连接请求时上报该 URC。 +QIURC: 'incoming' TCP/UDP Socket 连接请求提示 +QIURC: 'incoming',,, 参数 整型。接入连接的 socket 连接号。范围：0~11。 整型。监听 Socket 连接号。范围：0~11。 字符串类型。接入连接的源地址。 整型。接入连接的源端口。 3.3.6. +QIURC: 'incoming full' TCP/UDP Socket 连接已满提示 在设置自动接受连接请求方式下，Socket 服务连接已满时接收到新的连接请求，上报该 URC 并自动 拒绝该连接请求。 +QIURC: 'incoming full' TCP/UDP Socket 连接已满提示 +QIURC: 'incoming full' 客户端连接请求已满。 3.3.7. NO CARRIER 透传连接异常断开提示 NO CARRIER 透传连接异常断开提示 NO CARRIER 透传连接异常断开。 上海移远通信技术股份有限公司 76 / 106 FC41D AT 命令手册 3.4. SSL 相关 URC 详解 3.4.1. +QSSLOPEN SSL 客户端打开结果提示 执行 AT+QSSLOPEN 打开 SSL 客户端，通过该 URC 上报打开结果。 +QSSLOPEN SSL 客户端打开结果提示 +QSSLOPEN: , SSL 客户端打开结果。 参数 整型。Socket ID。范围：0~11。 整型。结果码。请参考第 5 章。 3.4.2. +QSSLURC: 'recv' SSL 客户端接收数据提示 SSL 客户端接收数据后上报该 URC 指示数据。 +QSSLURC: 'recv' SSL 客户端接收数据提示 +QSSLURC: 'recv', 缓存模式下接收数据时上报的 URC。 +QSSLURC: 'recv',, 参数 整型。Socket ID。范围：0~11。 整型。接收到的数据长度。范围：1~1500；单位：字节。 字符串类型（无双引号）。接收的数据。 3.4.3. +QSSLURC: 'closed' SSL 客户端被关闭提示 SSL 客户端连接被关闭时上报该 URC，并且 SSL 客户端状态显示关闭。 +QSSLURC: 'closed' SSL 客户端被关闭提示 +QSSLURC: 'closed', Socket 服务连接被断开。 参数 整型。Socket ID。范围：0~11。 上海移远通信技术股份有限公司 77 / 106 FC41D AT 命令手册 3.5. MQTT 相关 URC 详解 3.5.1. +QMTRECV MQTT 客户端收到新消息提示 MQTT 客户端收到新消息后上报该 URC。 +QMTRECV MQTT 客户端收到新消息提示 +QMTRECV: , 缓存方式下(=1)，收到新消息的提示。 +QMTRECV: ,,<topi 直吐方式下(=0)，收到新消息的提示。 c>,, 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。消息缓存的 ID。范围：0~4。 整型。PUBLISH 消息的标识。范围：0~65535。 字符串类型。从 MQTT 服务器接收的主题。 整型。MQTT 接收到的消息长度。 字符串类型。MQTT 接收到的消息。 3.5.2. +QMTSTAT MQTT 客户端异常断开提示 MQTT 客户端异常断开后上报该 URC。 +QMTSTAT MQTT 客户端异常断开提示 +QMTSTAT: , 客户端异常断开。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。MQTT 会话连接异常断开的原因。 1 MQTT 会话连接被动关闭 2 由于 PingReq 消息超时，造成 MQTT 客户端关闭会话连接 3 由于 Connect 消息超时，造成 MQTT 客户端关闭会话连接 4 由于 ConnACK 中提示 Connect 不成功，造成 MQTT 客户端关闭会话连接 上海移远通信技术股份有限公司 78 / 106 FC41D AT 命令手册 3.6. HTTP(S)相关 URC 详解 3.6.1. +QHTTPGET HTTP(S) GET 请求发送结果提示 通过 AT+QHTTPGET 发送 HTTP(S) GET 请求后，上报该 URC 提示 GET 请求发送结果。 +QHTTPGET HTTP(S) GET 请求发送结果提示 +QHTTPGET: [,[,]] 参数 整型。GET 请求发送结果。 0 成功 其他 失败 整型。HTTP(S)状态码。详见第 5 章。 整型。GET 请求消息体的长度。 3.6.2. +QHTTPPOST HTTP(S) POST 请求发送结果提示 通过 AT+QHTTPPOST 发送 HTTP(S) POST 请求后，上报该 URC 提示 POST 请求发送结果。 +QHTTPPOST HTTP(S) POST 请求发送结果提示 +QHTTPPOST: [,[,]] 参数 整型。POST 请求发送结果。 0 成功 其他 失败 整型。HTTP(S)状态码。详见第 5 章。 整型。POST 请求体的长度。 上海移远通信技术股份有限公司 79 / 106 FC41D AT 命令手册 3.6.3. +QHTTPPUT HTTP(S) PUT 请求发送结果提示 通过 AT+QHTTPPUT 发送 HTTP(S) PUT 请求后，上报该 URC 提示 PUT 请求发送结果。 +QHTTPPUT HTTP(S) PUT 请求发送结果提示 +QHTTPPUT: [,[,]] 参数 整型。PUT 请求发送结果。 0 成功 其他 失败 整型。HTTP(S)状态码。详见第 5 章。 整型。PUT 请求体的长度。 3.6.4. +QHTTPREAD HTTP(S)读取响应数据的结果提示 通过 AT+QHTTPREAD 读取响应数据，上报该 URC 提示读取的结果。 +QHTTPREAD HTTP(S) 读取响应数据的结果提示 +QHTTPREAD: 响应数据的读取结果。 参数 整型。响应信息的读取结果。 0 成功 其他 失败 3.6.5. +QHTTPURC: 'recv' HTTP(S)收到响应数据的提示 当选择使用 URC 方式输出响应数据时，HTTP(S)客户端收到响应数据时，上报该 URC。 +QHTTPURC: 'recv' HTTP(S)收到响应数据的提示 +QHTTPURC: 'recv',< URC 方式输出响应数据。 LF> 参数 整型。接收到的数据长度。 字符串类型（无双引号）。响应的数据。 上海移远通信技术股份有限公司 80 / 106 FC41D AT 命令手册 4 举例 4.1. Wi-Fi 功能 AT+QSTAAPINFO=testssid,123456789 OK AT+QSOFTAP=testap,12345678 OK //设置模块为 STA 模式并连接 AP 热点。 //设置模块为 AP 模式。 4.2. BLE 功能 4.2.1. 外围设备角色 建立连接过程中接受建立一个活跃的物理连接请求的 LE 设备定义为外围设备角色，外围设备角色在连 接状态下的链路层中是从机角色。 4.2.1.1. 配置模块为外围设备 AT+QBLEINIT=2 OK AT+QBLENAME=QuecFC41D OK AT+QBLEADDR? +QBLEADDR:c8:47:8c:42:00:49 OK AT+QBLEGATTSSRV=fff1 OK AT+QBLEGATTSCHAR=fff2 OK AT+QBLEGATTSCHAR=fff3 OK AT+QBLEADVPARAM=150,150 //模块为外围设备进行 BLE 初始化。 //设置 BLE 名称。 //查询并获取 BLE 设备地址。 //创建 BLE 服务并设置服务 UUID 为 fff1。 //设置 GATT 特征值 UUID 为 fff2。 //设置 GATT 特征值 UUID 为 fff3。 //设置 BLE 广播参数。 上海移远通信技术股份有限公司 81 / 106 OK AT+QBLEADVSTART OK //开启 BLE 广播。 FC41D AT 命令手册 4.2.1.2. nRF Connect 连接 1. 点击'SCAN'扫描外围设备，在扫描结果中选择'QuecFC41D'设备并点击'CONNECT'进 行连接，如下图所示： 图 2：扫描结果 上海移远通信技术股份有限公司 82 / 106 FC41D AT 命令手册 2. 连接成功后显示'CONNECTED'，在'CLIENT'会显示已添加的 UUID。如下图所示： 图 3：连接成功 上海移远通信技术股份有限公司 83 / 106 4.2.1.3. nRF Connect 给模块发送数据 1. 选择一个可以编辑的特征值，并点击向上的箭头，如下图所示： FC41D AT 命令手册 图 4：编辑特征值 上海移远通信技术股份有限公司 84 / 106 FC41D AT 命令手册 2. 在对话框中选择数据格式 TEXT，输入需要发送的数据，然后点击'SEND'进行发送，如下图所 示： 图 5：发送数据 3. 发送成功后，在 QCOM 串口工具中收到设备发送的数据。 from phone 上海移远通信技术股份有限公司 85 / 106 4.2.1.4. 模块给 nRF Connect 发送数据 1. 打开 UUID 0xFFF3 的通知功能，使用 QCOM 串口工具发送数据： AT+QBLEGATTSNTFY=fff3,from fc41d OK 2. nRF Connect UUID 0xFFF3 显示接收的数据，如下图所示： FC41D AT 命令手册 图 6：0xFFF3 显示的接收数据 4.2.2. 中心设备角色 建立连接过程中发起建立活跃物理连接请求的 LE 设备定义为中心设备角色，中心设备角色在连接状态 下的链路层中是主机角色。 上海移远通信技术股份有限公司 86 / 106 4.2.2.1. 配置模块为中心设备 AT+QBLEINIT=1 OK AT+QBLESCAN=1 OK +QBLESCAN: HTV33,1,90d4c4c51a65 AT+QBLESCAN=0 OK AT+QBLECONN=1,90d4c4c51a65 OK +QBLESTAT: CONNECTED +QBLEINFO: 3 2a05 +QBLEINFO: 22 2a00 +QBLEINFO: 24 2a01 +QBLEINFO: 26 2aa6 +QBLEINFO: 42 fff2 FC41D AT 命令手册 //模块为中心设备进行 BLE 初始化。 //打开 BLE 扫描。 //关闭 BLE 扫描。 //连接外围设备。 4.2.2.2. nRF Connect 配置 4.2.2.2.1. 服务配置 1. 打开 nRF Connect，点击'Configure GATT server'，如下图所示： 上海移远通信技术股份有限公司 图 7：服务配置 87 / 106 FC41D AT 命令手册 2. 添加一个名为'FC41D'的配置，设置 Service UUID 为 0xFFF1，设置 Characteristic UUID 为 0xFFF2，如下图所示： 图 8：配置相关 UUID 值 4.2.2.2.2. 广播配置 1. 选择'ADVERTISER'，点击右下角加号，如下图所示： 上海移远通信技术股份有限公司 图 9：添加广播 88 / 106 FC41D AT 命令手册 2. 在'Display name'中输入'FC41D'，在'Options'选项中勾选'Connectable'，然后点 击'OK'，如下图所示： 图 10：广播配置 上海移远通信技术股份有限公司 89 / 106 FC41D AT 命令手册 3. 广播配置完成，开始广播。此外，用户可以手动设置播放时长，如下图所示： 图 11：手动设置播放时长 上海移远通信技术股份有限公司 90 / 106 4.2.2.3. nRF Connect 给模块发送数据 1. 选择一个可以编辑的特征值，并点击向上的箭头，如下图所示： FC41D AT 命令手册 图 12：编辑特征值 上海移远通信技术股份有限公司 91 / 106 FC41D AT 命令手册 2. 在对话框中选择数据格式 TEXT，输入需要发送的数据，然后点击'SEND'进行发送，如下图所 示： 图 13：发送数据 3. 发送成功后，在 QCOM 串口工具中收到设备发送的数据： from phone 4.2.2.4. 模块给 nRF Connect 发送数据 1. 打开 UUID 0xFFF2 的通知功能，使用 QCOM 串口工具发送数据： AT+QBLEGATTCWR=fff2,from fc41dr OK 上海移远通信技术股份有限公司 92 / 106 2. nRF Connect UUID 0xFFF2 显示接收的数据，如下图所示： FC41D AT 命令手册 图 14：0xFFF2 显示的接收数据 4.2.3. 蓝牙配网 4.2.3.1. 蓝牙配网准备工作 准备两个模块，分别为模块 A 和模块 B。将模块 A 配置为外围设备，模块 B 配置为中心设备，然后将 模块 A 连接至模块 B。 4.2.3.1.1. 配置模块 A 为外围设备配网模式 AT+QBLENAME=Quec_FC41D OK AT+QBLEINIT=3 OK //设置模块名称。 //模块为外围设备进行蓝牙配网。 上海移远通信技术股份有限公司 93 / 106 FC41D AT 命令手册 4.2.3.1.2. 配置模块 B 为中心设备 打开 QCOM 工具，选择'COM Port'，点击'Open Port'，然后重置 FC41D 模块。 AT+QBLEINIT=1 OK AT+QBLESCAN=1 OK //模块为中心设备进行 BLE 初始化。 //打开 BLE 扫描。 +QBLESCAN: Quec_FC41D,0,bcd10cf0fb80 OK AT+QBLESCAN=0 OK AT+QBLECONN=0,bcd10cf0fb80 //关闭 BLE 扫描。 //连接外围设备。 4.2.3.2. 蓝牙配网 模块 B 通过 AT+QBLEGATTCWR=,配置 Wi-Fi。配置为 Wi-Fi 相关 AT 命令，若配 置 的 AT 命 令 中 有 多 个 参 数 ， 需 在 ' , ' 前 加 上 ' ' 。 例 如 ： AT+QBLEGATTCWR=,AT+QSTAAPINFO=,。 AT+QBLECFGMTU=512 //更新 MTU。 OK +QBLEMTU: AT+QBLEGATTCWR=ff01,AT+QWSCAN //通过 BLE 发送 AT+QWSCAN。 OK +QWSCAN:'Quectel-Customer-2.4G',WPA2_MIXED_PSK,32,f0:9b:b8:32:94:b0 ,9 +QWSCAN:'Quectel-HF-2.4G',UNKNOWN,32,f0:9b:b8:32:94:b2 ,9 +QWSCAN:'Quectel-HF',UNKNOWN,32,f0:9b:b8:32:94:b3 ,9 +QWSCAN:'ST_ShortRange',WPA2_AES_PSK,29,e0:d4:62:13:93:30 ,6 +QWSCAN:'hellowr',WPA2_AES_PSK,26,90:bd:e6:e3:66:9e ,6 +QWSCAN:'Quectel-HF',UNKNOWN,21,f0:9b:b8:33:18:b3 ,13 +QWSCAN:'Quectel-HF-2.4G',UNKNOWN,23,f0:9b:b8:33:21:f2 ,1 OK AT+QBLEGATTCWR=ff01,AT+QSTAAPINFO=Quectel-SH,******* //通过 BLE 连接 AP 热点。 OK AT+QSTAAPINFO=Quectel-SH,*******OK +QSTASTAT:WLAN_CONNECTED +QSTASTAT:GOT_IP 上海移远通信技术股份有限公司 94 / 106 FC41D AT 命令手册 4.3. TCP/UDP 功能 4.3.1. 透传模式 以下为打开/关闭透传模式下 TCP/UDP 客户端相关示例。 AT+QIOPEN=0,'TCP','220.180.239.201',8252,2020,2 CONNECT //输入数据 +++ OK ATO CONNECT //输入数据 +++ OK AT+QICLOSE=0 OK //打开 TCP 客户端。 //退出透传模式。 //再次进入透传模式。 //退出透传模式。 //关闭 TCP 客户端。 +QIURC: 'closed',0 以下为透传模式下 TCP/UDP 客户端异常断开时的相关示例。 AT+QIOPEN=0,'TCP','220.180.239.201',8252,2020,2 CONNECT //输入数据 NO CARRIER //打开 TCP 客户端。 //连接被异常被断开。 4.3.2. 非透传模式 下面的例子，展示了如何通过命令方式读取 TCP/UDP 数据。 AT+QIOPEN=0,'TCP','220.180.239.201',8252,2020,0 OK //打开 TCP 客户端，收到数据以命令 方式读取。 +QIOPEN: 0,0 AT+QISEND=0,10,'1234567890' +QISEND: 10 OK +QIURC: 'recv',0 AT+QIRD=0,10 +QIRD:10 //收到新数据的提示。 //读取新数据。 上海移远通信技术股份有限公司 95 / 106 FC41D AT 命令手册 0123456789 OK AT+QICLOSE=0 OK //关闭 TCP 客户端。 +QIURC: 'closed',0 AT+QIOPEN=1,'UDP SERVICE','220.180.239.201',8252,2020,0 //建立 UDP 服务，收到数据以命令方 OK 式读取。 +QIOPEN: 1,0 AT+QISEND=1,10,'1234567890','220.180.239.201',8252 +QISEND: 10 OK +QIURC: 'recv',1 AT+QIRD=1,10 +QIRD:10,'220.180.239.201',8252 //收到新数据的提示。 //读取新数据。 0123456789 OK AT+QICLOSE=1 OK //关闭 UDP 服务。 +QIURC: 'closed',1 以下为通过 URC 方式上报 TCP/UDP 收到新数据的相关示例。 AT+QIOPEN=0,'TCP','220.180.239.201',8252,2020,1 OK //打开 TCP 客户端，收到新数据以 URC 方式上报。 +QIOPEN: 0,0 AT+QISEND=0,10,'1234567890' +QISEND: 10 OK +QIURC: 'recv',0,10 //收到新数据的提示。 0123456789 AT+QICLOSE=0 OK //关闭 TCP 客户端。 上海移远通信技术股份有限公司 96 / 106 FC41D AT 命令手册 +QIURC: 'closed',0 AT+QIOPEN=1,'UDP SERVICE','220.180.239.201',8252,2020,1 //建立 UDP 服务，收到新数据以 OK URC 方式上报。 +QIOPEN: 1,0 AT+QISEND=1,10,'1234567890','220.180.239.201',8252 +QISEND: 10 OK +QIURC: 'recv',1,10, '220.180.239.201',8252 //收到新数据的提示。 0123456789 AT+QICLOSE=1 OK //关闭 UDP 服务。 +QIURC: 'closed',1 4.4. SSL 功能 以下为 SSL 单向认证时，通过 URC 上报进行数据的收发的示例。 AT+QSSLCFG='verify',1,1 OK //设置为单向认证。 AT+QSSLCFG='verify',1 +QSSLCFG: 'verify',1,1 OK //查询设置是否成功。 AT+QSSLCERT='CA',2,1657 CONNECT //上传 CA 证书。 -----BEGIN CERTIFICATE----MIIE5TCCA02gAwIBAgIJAP5uWtPRe+IxMA0GCSqGSIb3DQEBCwUAMIGHMQswCQYD VQQGEwJDTjELMAkGA1UECAwCQUgxCzAJBgNVBAcMAkhGMRwwGgYDVQQKDBNEZWZh dWx0IENvbXBhbnkgTHRkMRgwFgYDVQQDDA8yMjAuMTgwLjIzOS4yMTIxJjAkBgkq hkiG9w0BCQEWF2VkZGllLnpoYW5nQHF1ZWN0ZWwuY29tMCAXDTIxMDEyNzAzMzk0 M1oYDzIxMjEwMTAzMDMzOTQzWjCBhzELMAkGA1UEBhMCQ04xCzAJBgNVBAgMAkFI MQswCQYDVQQHDAJIRjEcMBoGA1UECgwTRGVmYXVsdCBDb21wYW55IEx0ZDEYMBYG A1UEAwwPMjIwLjE4MC4yMzkuMjEyMSYwJAYJKoZIhvcNAQkBFhdlZGRpZS56aGFu Z0BxdWVjdGVsLmNvbTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBANf3 w0ep+Sv4qDjhafwc3wiaGdzwAXOsRgfGgBEGYL5MuPbpzjERo21yHae6Tx19DIUt g6hgW5N/bvDqXLbEMChy9b8aNl62+Y6O35Tya2hoz4XXQkrPkRXvlP2eonjPMfQB 上海移远通信技术股份有限公司 97 / 106 FC41D AT 命令手册 Yu4wtAfNKPa10MJF8qjFI7WWBpcQMpoQvt/SekoD6IyxgRu8ApjtmJicvvWu3BqW W93MZqLhSFf57pKLQEhgskpl/gb+rLiUwObMTRM948J04NoYBx1jwMZLNEFs6os6 91J8B5oHlgQAsgcXjoXORxncgt2d/fZyr9NjVevc/GIkcbfVAAWohFCQmjpgLESW iTPaRlLyeLLjTb+WrSOKosinVH+1R8ozfBnkzO+tf9lpBzdP9QCDYzNQeU4Xp0wJ 8Neo5tA4tioDEZjkbsHL+bVvssqOwfupR9b03Z2ZLfgEzs3TwYbPB7ULJQrdqe9x QtpaFSsDeyKJ6CR8yEHz5d0lypPeRLCjZGb49Yo3FKhMdzP+ZMT+Ku001cr4GwID AQABo1AwTjAdBgNVHQ4EFgQU4FfBsWrgpoGtvuF+3XN9kbUx0yUwHwYDVR0jBBgw FoAU4FfBsWrgpoGtvuF+3XN9kbUx0yUwDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0B AQsFAAOCAYEAqfVX0LhhxYZ/KsC9jhWYHgmYggVcsTa7AtZsNKW79TLmz98iWdfM wpi44rwbn1Xek5pDH/rimaJuwxcX8Q4cFHqeQJStRkcuU6CgyurVBpjGWRv5qt3W nJc/z92x3TPzW1VJv5rXj4pzX9N4hlAHGGzFBm+VMAexS006/dksGa9uEKE/2A0+ 9W/V9YbcjhejdENiRAvJB4J0QsOrNUjsH5bPEa3CxdXbKOQzGjJtS7f0BH38Fmyi C+Cui8U0c+BwRGY3HXL7ANhCe0vdUbUGCG2L6byRvf1TIkuGpi0RxtQfEF3sTDH5 jAot50rJhbckQyLH0xkIOQ9qmU/gbt/wgoZ9AzUVIyh0RsyWo19BGz2DpsuYNBXD 4jqL4NMqsyGRq5YUTrJlIi9PVUp176Ec79xSffvUbitiq9fMmxuhsRbkP4piM1TE D5oXKPme86RvR1/foRqAdbJg5RPYdah3LdOlAE2HePVy6b0xQ5dcCHaqHmR2SVlY m7TQs6tfvfhy -----END CERTIFICATE----- OK //上传完成。 AT+QSSLOPEN=1,1,'220.180.239.212 ',12000 OK +QSSLOPEN: 1,0 //建立 SSL 连接。 AT+QSSLSTATE //查看连接状态。 +QSSLSTATE: 1,'SSL CLIENT','220.180.239.212',12000,6601,2 OK AT+QISWTMD=1,1 OK //切换数据访问模式为直吐模式。 AT+QSSLSEND=1,6,'123456' +QSSLSEND: 6 OK //发送数据。 +QSSLURC: 'recv',1,6 123456 //URC 上报接收到的服务器数据。 AT+QSSLCERT='CA',0 OK //删除证书。 AT+QSSLCLOSE=1,1 OK //关闭 SSL 连接。 上海移远通信技术股份有限公司 98 / 106 +QSSLURC: 'closed',1 FC41D AT 命令手册 4.5. MQTT 功能 AT+QMTCFG='version',1,4 OK AT+QMTOPEN=1,'220.180.239.212',8306 OK +QMTOPEN: 1,0 AT+QMTCONN=1,'client1','test','test' OK +QMTCONN: 1,0,0 AT+QMTSUB=1,1,'quectel',1 OK +QMTSUB: 1,1,0,1 //直吐方式 AT+QMTPUB=1,1,1,0,'quectel',3,'123' OK +QMTRECV: 1,1,'quectel',3,'345' //缓存方式 AT+QMTCFG='recv/mode',0,1 OK AT+QMTPUB=1,1,1,0,'quectel',2,'3132' OK +QMTPUB: 1,1,0 +QMTRECV: 0,0 AT+QMTRECV=0,0 +QMTRECV: 1,1,'quectel',2,'12' OK AT+QMTUNS=1,1,'quectel' OK +QMTUNS: 1,1,0 AT+QMTDISC=1 OK 上海移远通信技术股份有限公司 //配置 MQTT 协议版本为 V4。 //与 MQTT 服务器建立会话连接。 //建立 MQTT 连接。 //订阅'quectel'主题的消息。 //发布主题为'quectel'的消息。 //接收到主题为'quectel'的消息。 //发布主题为'quectel'的消息。 //取消订阅'quectel'主题的消息。 //断开 MQTT 连接。 99 / 106 FC41D AT 命令手册 +QMTDISC: 1,0 4.6. HTTP(S)功能 //发送 HTTP(S) GET 请求的示例 //第一步：设置 URL AT+QHTTPCFG='url','http://www.baidu.com' OK //第二步：发送 GET 请求 AT+QHTTPGET=120 //打开百度网页。 OK +QHTTPGET: 0,200 //第三步：读取响应数据 AT+QHTTPREAD=60 //读取响应数据。 CONNECT ...................... OK +QHTTPREAD: 0 //发送 HTTP(S) POST 请求的示例。 //第一步：设置 URL AT+QHTTPCFG='url','http://220.180.239.212:8252/study_log/' OK //第二步：发送 POST 请求 AT+QHTTPPOST=1024,120,120,'file','test.txt','text/plain' CONNECT //输入文件内容，达到后退出数据模式。 OK //POST 方式上传 Form-data 形 式文件。 +QHTTPPOST: 0,200,1538 上海移远通信技术股份有限公司 100 / 106 FC41D AT 命令手册 //第三步：读取响应数据 AT+QHTTPREAD=60 CONNECT ...................... OK //读取响应数据。 +QHTTPREAD: 0 //HTTP(S) PUT 的例子 //第一步：设置 URL AT+QHTTPCFG='url','http://220.180.239.212:8252/uploads/test.txt' OK //第二步：发送 PUT 请求 AT+QHTTPPUT=1024,120,120 CONNECT //输入文件内容，达到后退出数据模式 OK //PUT 方式上传文件。 +QHTTPPUT: 0,200,1538 //第三步：读取响应数据 AT+QHTTPREAD=60 CONNECT ...................... OK //读取响应数据。 +QHTTPREAD: 0 //自定义 Header 的例子 //通过自定义 Header: Range: bytes=x-x，实现 HTTP 断点下载的功能 AT+QHTTPCFG='header','Range','bytes=0-511' OK AT+QHTTPCFG='url','http://116.247.104.27:6023/1M.txt' OK AT+QHTTPGET=60 OK +QHTTPGET: 0,200,512 AT+QHTTPREAD=60 CONNECT //数据 //读取响应数据。 上海移远通信技术股份有限公司 101 / 106 OK +QHTTPREAD: 0 FC41D AT 命令手册 上海移远通信技术股份有限公司 102 / 106 FC41D AT 命令手册 5 结果码 表 2：TCP/UDP/SSL 结果码 结果码 0 550 551 552 553 554 555 556 557 英文描述 Operation success Invalid parameter Unknown error Memory not enough Socket ID has been used Socket ID not exist Socket allocate failed Operation not allowed Operation not supported 表 3：HTTP(S)结果码 结果码 0 1 2 3 4 5 英文描述 Operation success Invalid parameter Unknown error Memory not enough Socket failure Operation not supported 上海移远通信技术股份有限公司 中文描述 操作成功 参数无效 未知错误 内存不足 Socket ID 被占用 Socket ID 不存在 Socket 分配失败 操作不允许 操作不支持 中文描述 操作成功 参数无效 未知错误 内存不足 Socket 异常 操作不支持 103 / 106 FC41D AT 命令手册 6 Operation not allowed 操作不允许 7 No network 没有联网 8 Lack of SSL Cert 缺少 SSL 证书 9 Response timeout 等待响应超时 10 Body wait timeout 等待输入 HTTP(S)消息主体超时 上海移远通信技术股份有限公司 104 / 106 FC41D AT 命令手册 6 附录 术语缩写 表 4：术语缩写 缩写 ACK AP BLE BSSID DHCP DNS GATT MAC MQTT MTU HTTP HTTPS ID IP OTA PSK QoS SNI STA 英文全称 Acknowledgement Access Point Bluetooth Low Energy Basic Service Set Identifier Dynamic Host Configuration Protocol Domain Name Server Generic Attribute Profile Medium Access Control Message Queuing Telemetry Transport Maximum Transmission Unit Hyper Text Transfer Protocol Hypertext Transfer Protocol Secure Mostly refers to Identifier in terms of software Internet Protocol Over-the-Air Techology Pre-Shared Key Quality of Service Server Name Indication Station 中文全称 确认消息 接入点 蓝牙低功耗 基本服务集标识符 动态主机设置协议 域名系统（服务）协议 通用属性协议 媒体访问控制 消息队列遥测传输 最大传输单元 超文本传输协议 超文本传输安全协议 软件中多数指'标识符' 网际互连协议 空中下载技术 预共享密钥 服务质量 服务器名称显示 站点 上海移远通信技术股份有限公司 105 / 106 SSID SSL TA TCP TLS UDP URC UUID Service Set Identifier Secure Sockets Layer Terminal Adapter Transmission Control Protocol Transport Layer Security User Datagram Protocol Unsolicited Result Code Universally Unique Identifier FC41D AT 命令手册 服务集标识符 安全套接层 终端适配器 传输控制协议 传输层安全（协议） 用户数据报协议 非请求结果码 通用唯一识别码 上海移远通信技术股份有限公司 106 / 106

BG95&BG77&BG600L Series QNWCFG AT Commands Manual LPWA Module Series Version: 1.0 Date: 2021-12-08 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available'' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 1 / 29 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 2 / 29 LPWA Module Series About the Document Revision History Version 1.0 Date 2021-10-28 2021-12-08 Author Description Forest WANG Creation of the document Forest WANG First official release BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 3 / 29 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 2 AT Command Introduction ................................................................................................................ 7 2.1. Definitions .................................................................................................................................. 7 2.2. AT Command Syntax ................................................................................................................. 7 2.3. AT Command Responses.......................................................................................................... 8 2.4. Declaration of AT Command Examples .................................................................................... 9 3 Description of AT+QNWCFG Commands ...................................................................................... 10 3.1. AT+QNWCFG Extended Configuration Settings .................................................................. 10 3.1.1. AT+QNWCFG='acqdb' Get All Historic Frequency Information Under NB-IoT or eMTC ....................................................................................................................................... 11 3.1.2. AT+QNWCFG='backoff' Query Back-off Timer Value of FPLMN Searching ........... 11 3.1.3. AT+QNWCFG='clearbackoff' Delete Back-off Timer Value of FPLMN Searching... 12 3.1.4. AT+QNWCFG='activetimer' Enable the Module to Enter PSM Conditionally .......... 12 3.1.5. AT+QNWCFG='hplmnsearch_ctrl' Disable HPLMN Searching in Roaming State... 14 3.1.6. AT+QNWCFG='ta' Query Timing Advance Value Under Current RAT .................... 15 3.1.7. AT+QNWCFG='cqi' Query Channel Quality Indication Under eMTC ....................... 15 3.1.8. AT+QNWCFG='cfun_init_mode' Configure Booting Mode ....................................... 16 3.1.9. AT+QNWCFG='3gpp_rel_control' Configure 3GPP Release Version Under NB-IoT or eMTC ....................................................................................................................................... 17 3.1.10. AT+QNWCFG='nb_feature_ctrl' Configure Capability Features Under NB-IoT....... 18 3.1.11. AT+QNWCFG='catm_feature_ctrl' Configure Capability Features Under eMTC..... 20 3.1.12. AT+QNWCFG='pci_lock' Lock Physical Cell ID and Frequency Under NB-IoT or eMTC ....................................................................................................................................... 21 3.1.13. AT+QNWCFG='edrx_urc' Enable URC Report When Reselecting a Cell That Does Not Support eDRX ....................................................................................................................... 22 3.1.14. AT+QNWCFG='esmcause' Get ESM Cause Value.................................................. 23 3.1.15. AT+QNWCFG='smsoverip' Configure SMS Type .................................................... 24 4 Summary of CME Error Codes ........................................................................................................ 26 5 Appendix References ....................................................................................................................... 28 BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 4 / 29 LPWA Module Series Table Index Table 1: Applicable Modules ........................................................................................................................ 6 Table 2: Types of AT Commands ................................................................................................................ 7 Table 3: Different Coding Schemes of +CME ERROR: ................................................................... 26 Table 4: Related Documents...................................................................................................................... 28 Table 5: Terms and Abbreviations ............................................................................................................. 28 BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 5 / 29 LPWA Module Series 1 Introduction This document describes the subcommands of AT+QNWCFG and is applicable to the following modules. Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 6 / 29 LPWA Module Series 2 AT Command Introduction 2.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. AT+QNWCFG commands implemented by BG95 series, BG77 and BG600L-M3 modules are categorized as 'Extended' syntax, as illustrated below. ⚫ Extended Command These commands can be operated in several modes, as shown in the following table: Table 2: Types of AT Commands Command Type Syntax Test Command AT+=? Read Command AT+? Description Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 7 / 29 LPWA Module Series Write Command Execution Command AT+=[,[,[...]] ] AT+ Set user-definable parameter value. Return a specific information parameter or perform a specific action. Multiple commands can be placed on a single line using a semi-colon (;) between commands. In such cases, only the first command should have AT prefix. Commands can be in upper or lower case. Spaces should be ignored when you enter AT commands, except in the following cases: ⚫ Within quoted strings, where spaces are preserved; ⚫ Within an unquoted string or numeric parameter; ⚫ Within an IP address; ⚫ Within the AT command name up to and including a =, ? or =?. 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, ERROR will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. 2.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 information responses are sent before the final OK, ERROR or +CME ERROR: . Responses will be in the format of: +CMD1: OK Or OK BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 8 / 29 LPWA Module Series 2.4. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about how to use the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 9 / 29 LPWA Module Series 3 Description of AT+QNWCFG Commands 3.1. AT+QNWCFG Extended Configuration Settings This command queries and configures various settings of UE. AT+QNWCFG Extended Configuration Settings Test Command AT+QNWCFG=? Response +QNWCFG: 'acqdb' +QNWCFG: 'backoff' +QNWCFG: 'clearbackoff' +QNWCFG: 'activetimer',(range of supported s),(range of supported s) +QNWCFG: 'hplmnsearch_ctrl',(list of supported s) +QNWCFG: 'ta' +QNWCFG: 'cqi',(range of supported s) +QNWCFG: 'cfun_init_mode',(list of supported s) +QNWCFG: '3gpp_rel_control',(list of supported s),(list of supported s),(list of supported s) +QNWCFG: 'nb_feature_ctrl',(list of supported s),(range of supported s) +QNWCFG: 'catm_feature_ctrl',(list of supported s),(range of supported s) +QNWCFG: 'pci_lock',(list of supported s),(list of supported s),(range of supported s),(range of supported s) +QNWCFG: 'edrx_urc',(list of supported s) +QNWCFG: 'esmcause',(list of supported s) +QNWCFG: 'smsoverip',(list of supported s) OK Maximum Response Time 300 ms Characteristics / BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 10 / 29 LPWA Module Series 3.1.1. AT+QNWCFG='acqdb' Get All Historic Frequency Information Under NB-IoT or eMTC This command gets all historic frequency information under NB-IoT or eMTC. AT+QNWCFG='acqdb' eMTC Write Command AT+QNWCFG='acqdb' Get All Historic Frequency Information Under NB-IoT or Response +QNWCFG: 'acqdb',,,,, […] OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter String type. Radio access technology. 'eMTC' eMTC 'NBIoT' NB-IoT Integer type. PLMN. Integer type. Band. Integer type. The frequency that has been locked. Range: 0–4294967295. Integer type. The physical cell ID that has been locked. Range: 0–503. Error code. Please refer to Chapter 4. 3.1.2. AT+QNWCFG='backoff' Query Back-off Timer Value of FPLMN Searching This command queries the back-off timer value of FPLMN searching. AT+QNWCFG='backoff' Query Back-off Timer Value of FPLMN Searching Write Command AT+QNWCFG='backoff' Response +QNWCFG: 'backoff', OK BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 11 / 29 LPWA Module Series Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms / Parameter Integer type. Back-off timer value of FPLMN searching. Unit: second. Error code. Please refer to Chapter 4. 3.1.3. AT+QNWCFG='clearbackoff' Delete Back-off Timer Value of FPLMN Searching This command deletes the back-off timer value of FPLMN searching. AT+QNWCFG='clearbackoff' Delete Back-off Timer Value of FPLMN Searching Write Command AT+QNWCFG='clearbackoff' Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Error code. Please refer to Chapter 4. 3.1.4. AT+QNWCFG='activetimer' Enable the Module to Enter PSM Conditionally This command enables or disables the module to enter PSM conditionally if no data interaction occurs within . This command is valid under the premise of enabling PSM. If AT command interaction BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 12 / 29 LPWA Module Series occurs during , the module does not enter PSM even if the T3324 timer expires and recounts after the AT command is executed. AT+QNWCFG='activetimer' Enable the Module to Enter PSM Conditionally Write Command AT+QNWCFG='activetimer'[,,] Response If the optional parameters are omitted, query the current setting: +QNWCFG: 'activetimer',, OK If the optional parameters are specified, enable or disable the module to enter PSM conditionally: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Enable or disable the module to enter PSM when no AT command interaction occurs within the time specified by . 0 Disable. 1 Enable. The module enters PSM after is reached and T3324 timer expires. 2 Enable. The module enters PSM after is reached without considering whether T3324 time expires. Integer type. The timeout value for the module to enter PSM. The timeout timer starts once there is no AT command interaction and restarts once an AT command is entered. Range: 1–4294967295. Unit: millisecond. Error code. Please refer to Chapter 4. Example AT+QNWCFG='activetimer',1,6000 //Enable the module to enter PSM after 6000 ms and T3324 timer expires. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 13 / 29 OK AT+QNWCFG='activetimer' +QNWCFG: 'activetimer',1,6000 OK LPWA Module Series NOTE 1. It is suggested to configure to a value over 5000, otherwise the module cannot respond in time. 2. Please make sure to enable PSM through AT+CPSMS=1. See document [1] for details. 3.1.5. AT+QNWCFG='hplmnsearch_ctrl' Disable HPLMN Searching in Roaming State This command disables HPLMN searching when the (U)SIM card is in roaming state. AT+QNWCFG='hplmnsearch_ctrl' Disable HPLMN Searching in Roaming State Write Command Response AT+QNWCFG='hplmnsearch_ctr If the optional parameter is omitted, query the current setting: l'[,] +QNWCFG: 'hplmnsearch_ctrl', OK If the optional parameter is specified, enable or disable HPLMN searching in roaming state: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after the module reboots. The configurations are saved automatically. Parameter Integer type. Enable or disable HPLMN searching when the (U)SIM card is in roaming state. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 14 / 29 0 Disable 1 Enable Error code. Please refer to Chapter 4. LPWA Module Series 3.1.6. AT+QNWCFG='ta' Query Timing Advance Value Under Current RAT This command queries the timing advance value under current RAT. AT+QNWCFG='ta' Query Timing Advance Value Under Current RAT Write Command AT+QNWCFG='ta' Response +QNWCFG: 'ta',, OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter String type. Current radio access technology. 'GSM' GSM 'eMTC' eMTC 'NBIoT' NB-IoT Integer type. Timing advance. Error code. Please refer to Chapter 4. NOTE Only BG95-M3, BG95-M5 and BG600L-M3 modules support GSM. 3.1.7. AT+QNWCFG='cqi' Query Channel Quality Indication Under eMTC This command queries the channel quality indication under eMTC. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 15 / 29 LPWA Module Series AT+QNWCFG='cqi' Query Channel Quality Indication Under eMTC Write Command AT+QNWCFG='cqi' Response +QNWCFG: 'cqi', OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Integer type. Channel quality indication value. Range: 0–15. Error code. Please refer to Chapter 4. NOTE 1. Please make sure to enable the log output first through AT+QCFG='dbgctl',0. See document [2] for details. 2. This command is valid only when module registers to eMTC RAT. 3.1.8. AT+QNWCFG='cfun_init_mode' Configure Booting Mode This command configures the booting mode of the module. AT+QNWCFG='cfun_init_mode' Configure Booting Mode Write Command AT+QNWCFG='cfun_init_mode' [,] Response If the optional parameter is omitted, query the current setting: +QNWCFG: 'cfun_init_mode', OK If the optional parameter is specified, configure the booting mode: OK If there is an error related to ME functionality: +CME ERROR: BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 16 / 29 LPWA Module Series Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after the module reboots. The configurations are saved automatically. Parameter Integer type. The booting mode for the module. 0 Minimum functionality 1 Full functionality Error code. Please refer to Chapter 4. Example AT+QNWCFG='cfun_init_mode',0 OK AT+QNWCFG='cfun_init_mode' +QNWCFG: 'cfun_init_mode',0 //Set the module booting mode to minimum functionality. //Query the current setting. OK 3.1.9. AT+QNWCFG='3gpp_rel_control' Configure 3GPP Release Version Under NB-IoT or eMTC This command configures 3GPP release version under NB-IoT or eMTC. AT+QNWCFG='3gpp_rel_control' Configure 3GPP Release Version Under NB-IoT or eMTC Write Command Response AT+QNWCFG='3gpp_rel_control' If and are omitted, [,[,[,]]] +QNWCFG: '3gpp_rel_control',,[,] […] OK If any of and is specified, delete or configure 3GPP release version under NB-IoT or eMTC: BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 17 / 29 LPWA Module Series Maximum Response Time Characteristics OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect after the module reboots. The configurations are saved automatically. Parameter String type. RAT to be controlled. 'eMTC' eMTC 'NBIoT' NB-IoT Integer type. 0 Delete the configuration 1 Configure release version A hexadecimal value that specifies 3GPP release version. This parameter is omitted when is 0. In the Write Command, '0x' is allowed to be omitted. 0xA0 Rel-13 version 0xB0 Rel-14 version Error code. Please refer to Chapter 4.. Example AT+QNWCFG='3gpp_rel_control','eMTC',1,B0 OK AT+QNWCFG='3gpp_rel_control' +QNWCFG: '3gpp_rel_control','eMTC',1,0xb0 +QNWCFG: '3gpp_rel_control','NBIoT',0 //Set 3GPP release version under eMTC //Query the current configuration OK AT+QNWCFG='3gpp_rel_control','eMTC',0 OK //Delete the configuration under eMTC 3.1.10. AT+QNWCFG='nb_feature_ctrl' Configure Capability Features Under NB-IoT This command configures the capability features under NB-IoT. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 18 / 29 LPWA Module Series AT+QNWCFG='nb_feature_ctrl' Configure Capability Features Under NB-IoT Write Command AT+QNWCFG='nb_feature_ctrl'[,< operation>[,]] Response If the optional parameters are omitted, query the current setting: +QNWCFG: 'nb_feature_ctrl',[,] OK If any of the optional parameters is specified, delete or configure the capability features under NB-IoT: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after the module reboots. The configurations are saved automatically. Parameter Integer type. 0 Delete the capability features 1 Enable the capability features A hexadecimal value that specifies the NB-loT capability features. This parameter is omitted when is 0. Range: 0–0xFFE. In the Write Command, '0x' is allowed to be omitted. 0x2 NB1_RRC_CAP_FEATURE_MULTI_TONE_BM 0x4 NB1_RRC_CAP_FEATURE_MULTI_CARRIER_BM 0x8 NB1_RRC_CAP_FEATURE_MULTI_NS_PMAX_BM 0x10 NB1_RRC_CAP_FEATURE_MULTI_TONE_MSG3_BM 0x20 NB1_RRC_CAP_FEATURE_TWO_HARQ_BM 0x40 NB1_RRC_CAP_FEATURE_INTERFERENCE_RANDOM_BM 0x80 NB1_RRC_CAP_FEATURE_R14_RAI_BM 0x100 NB1_RRC_CAP_FEATURE_R14_DATA_INAC_TIMER_BM 0x200 NB1_RRC_CAP_FEATURE_MULTI_CARRIER_PRACH_BM 0x400 NB1_RRC_CAP_FEATURE_CFRA_CONFIG_ENABLED_BM 0x800 NB1_RRC_CAP_FEATURE_MULTI_CARRIER_PAGING_BM Error code. Please refer to Chapter 4. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 19 / 29 LPWA Module Series NOTE This command is not valid on BG95-M1 module. 3.1.11. AT+QNWCFG='catm_feature_ctrl' Configure Capability Features Under eMTC The command configures the capability features under eMTC. AT+QNWCFG='catm_feature_ctrl' Configure Capability Features Under eMTC Write Command AT+QNWCFG='catm_feature_ctrl'[, [,]] Response If the optional parameters are omitted, query the current setting: +QNWCFG: 'catm_feature_ctrl',[,] OK If any of the optional parameters is specified, delete or configure the capability features under eMTC: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after the module reboots. The configurations are saved automatically. Parameter Integer type. 0 Delete the capability features 1 Enable the capability features A hexadecimal value that specifies the eMTC capability features. This parameter is omitted when is 0. Range: 0–0x1FFE. In the Write Command, '0x' is allowed to be omitted. 0x2 LTE_RRC_CAP_INTRE_FREQ_GAPLESS_MEAS_SUPPORT_FDD BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 20 / 29 LPWA Module Series 0x4 LTE_RRC_CAP_DISABLE_CE_PUSCH_NB_MAX_TBS_R14 0x8 LTE_RRC_CAP_DISABLE_INTRA_FREQ_CE_MODE_A_HO 0x10 LTE_RRC_CAP_DISABLE_INTRA_FREQ_CE_MODE_A_MEAS 0x20 LTE_RRC_CAP_DISABLE_EXTENDED_POLL_BYTE_R14 0x40 LTE_RRC_CAP_DISABLE_R14_RAI 0x80 LTE_RRC_CAP_DISABLE_POWER_CLASS_PER_BAND 0x100 LTE_RRC_CAP_DISABLE_R14_DATA_INAC_TMR 0x200 LTE_RRC_CAP_DISABLE_CE_PDSCH_PUSCH_ENH_R14 0x400 LTE_RRC_CAP_DISABLE_IE_CE_MEAS_R14 0x800 LTE_RRC_CAP_DISABLE_CE_PDSCH_TEN_PROCESSES_R14 0x1000 LTE_RRC_CAP_DISABLE_CE_RETUNING_SYMBOLS_R14 Error code. Please refer to Chapter 4. Example AT+QNWCFG='catm_feature_ctrl',1,40 OK AT+QNWCFG='catm_feature_ctrl' +QNWCFG: 'catm_feature_ctrl',1,0x40 OK AT+QNWCFG='catm_feature_ctrl',0 OK //Set to LTE_RRC_CAP_DISABLE_R14_RAI. //Query the current configuration. //Delete the configuration. 3.1.12. AT+QNWCFG='pci_lock' Lock Physical Cell ID and Frequency Under NB-IoT or eMTC This command locks physical cell ID and frequency under NB-IoT or eMTC. AT+QNWCFG='pci_lock' Lock Physical Cell ID and Frequency Under NB-IoT or eMTC Write Command Response AT+QNWCFG='pci_lock'[,<R If , , and are omitted, query the AT>[,[,, current setting: ]]] +QNWCFG: 'pci_lock',,[,,] […] OK If any of , , and is specified, delete the NV file or lock the physical cell ID and frequency under NB-IoT or eMTC: OK BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 21 / 29 LPWA Module Series Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect after the module reboots. The configurations are saved automatically. Parameter String type. The type of radio access technology. 'eMTC' eMTC 'NBIoT' NB-IoT Integer type. 0 Delete the NV file. and are omitted. 1 and must be configured. Integer type. The frequency to be locked. This parameter is omitted when is 0. Range: 0–4294967295. Integer type. Physical cell ID to be locked. This parameter is omitted when is 0. Range: 0–503. Error code. Please refer to Chapter 4. Example AT+QNWCFG='pci_lock','eMTC',1,6300,102 OK AT+QNWCFG='pci_lock' +QNWCFG: 'pci_lock','eMTC',1,6300,102 +QNWCFG: 'pci_lock','NBIoT',0 OK //Lock specific frequency and physical cell ID. //Query the current configuration. 3.1.13. AT+QNWCFG='edrx_urc' Enable URC Report When Reselecting a Cell That Does Not Support eDRX When the eDRX function and eDRX URC are both enabled through AT+CEDRXS (see document [1] for details), this command controls whether the module reports URC +CEDRXP: 0 when reselecting from a cell that supports eDRX to another cell that does not support eDRX. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 22 / 29 LPWA Module Series AT+QNWCFG='edrx_urc' Enable URC Report When Reselecting a Cell That Does Not Support eDRX Write Command Response AT+QNWCFG='edrx_urc'[,] +QNWCFG: 'edrx_urc', OK If the optional parameter is specified, enable or disable the eDRX URC report: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after the module reboots. The configurations are saved automatically. Parameter Integer type. Enable or disable URC report when the modem reselects a cell that does not support eDRX. 0 Disable 1 Enable Error code. Please refer to Chapter 4. 3.1.14. AT+QNWCFG='esmcause' Get ESM Cause Value This command queries the ESM cause value in session management. AT+QNWCFG='esmcause' Get ESM Cause Value Write Command AT+QNWCFG='esmcause'[,] Response +QNWCFG: 'esmcause', OK If there is an error related to ME functionality: +CME ERROR: BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 23 / 29 Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / LPWA Module Series Parameter Integer type. The format of ESM reject cause. 0 Numeric value 1 Verbose value ESM reject cause. Error code. Please refer to Chapter 4. NOTE Please make sure to enable the log output first through AT+QCFG='dbgctl',0. See document [2] for details. 3.1.15. AT+QNWCFG='smsoverip' Configure SMS Type This command configures SMS type when module registers to IMS. AT+QNWCFG='smsoverip' Configure SMS Type Write Command AT+QNWCFG='smsoverip'[,] Response If the optional parameter is omitted, query the current setting: +QNWCFG: 'smsoverip', OK Maximum Response Time Characteristics If the optional parameter is specified, enable or disable IMS SMS: OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 24 / 29 LPWA Module Series Parameter Integer type. Disable/enable IMS SMS. 0 Disable IMS SMS. SMS type is NAS SMS 1 Enable IMS SMS. SMS type is IMS SMS Example AT+QNWCFG='smsoverip',1 OK AT+QNWCFG='smsoverip' +QNWCFG: 'smsoverip',1 OK //Enable IMS SMS //Query the current configuration NOTE 1. This command is valid only when module registers to eMTC RAT. 2. This command is valid only on the firmware version supporting VoLTE. BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 25 / 29 LPWA Module Series 4 Summary of CME Error Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation of +CME ERROR: final result code is similar to the regular ERROR result code: if +CME ERROR: is the result code for any of the commands in a command line, none of the following commands in the same command line is executed (neither ERROR nor OK result code shall be returned as a result of a completed command line execution). The format of can be either numeric or verbose. This is set with AT+CMEE. For more details, see document [1]. values are mostly used by common message commands. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. Table 3: Different Coding Schemes of +CME ERROR: Numeric Value 0 1 2 3 4 5 6 7 10 11 12 13 Verbose Value phone failure no connection to phone phone-adaptor link reserved operation not allowed operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 26 / 29 LPWA Module Series 14 SIM busy 15 SIM wrong 16 incorrect password 17 SIM PIN2 required 18 SIM PUK2 required 20 memory full 21 invalid index 22 not found 23 memory failure 24 text string too long 25 invalid characters in text string 26 dial string too long 27 invalid characters in dial string 30 no network service 31 network timeout 32 network not allowed - emergency calls only 40 network personalization PIN required 41 network personalization PUK required 42 network subset personalization PIN required 43 network subset personalization PUK required 44 service provider personalization PIN required 45 service provider personalization PUK required 46 corporate personalization PIN required 47 corporate personalization PUK required BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 27 / 29 LPWA Module Series 5 Appendix References Table 4: Related Documents Document Name [1] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual [2] Quectel_BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual Table 5: Terms and Abbreviations Abbreviation 3GPP eDRX EGPRS eMTC EPS ESM FPLMN GSM HPLMN IMS ID ME NAS NB-IoT Description 3rd Generation Partnership Project extended Discontinuous Reception Enhanced General Packet Radio Service enhanced Machine-Type Communication Evolved Packet System EPS Session Management Forbidden Public Land Mobile Network Global System for Mobile Communications Home Public Land Mobile Network IP Multimedia Subsystem Identifier Mobile Equipment Non-Access Stratum Narrowband Internet of Things BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 28 / 29 PIN PLMN PUK PSM RAT SMS TA (U)SIM UE URC Wi-Fi Personal Identification Number Public Land Mobile Network PIN Unlock Key Power Saving Mode Radio Access Technology Short Message Service Terminal Adapter (Universal) Subscriber Identity Module User Equipment Unsolicited Result Code Wireless Fidelity LPWA Module Series BG95&BG77&BG600L_Series_QNWCFG_AT_Commands_Manual 29 / 29

EG512R&EM1x0R Series AT Commands Manual LTE-A Module Series Version: 1.0 Date: 2020-09-12 Status: Released www.quectel.com LTE-A Module Series EG512R&EM1x0R Series 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. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. DISCLAIMER WHILE QUECTEL HAS MADE EFFORTS TO ENSURE THAT THE FUNCTIONS AND FEATURES UNDER DEVELOPMENT ARE FREE FROM ERRORS, IT IS POSSIBLE THAT THESE FUNCTIONS AND FEATURES COULD CONTAIN ERRORS, INACCURACIES AND OMISSIONS. UNLESS OTHERWISE PROVIDED BY VALID AGREEMENT, QUECTEL MAKES NO WARRANTIES OF ANY KIND, IMPLIED OR EXPRESS, WITH RESPECT TO THE USE OF FEATURES AND FUNCTIONS UNDER DEVELOPMENT. TO THE MAXIMUM EXTENT PERMITTED BY LAW, QUECTEL EXCLUDES ALL LIABILITY FOR ANY LOSS OR DAMAGE SUFFERED IN CONNECTION WITH THE USE OF THE FUNCTIONS AND FEATURES UNDER DEVELOPMENT, REGARDLESS OF WHETHER SUCH LOSS OR DAMAGE MAY HAVE BEEN FORESEEABLE. 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 WITHOUT PERMISSION ARE FORBIDDEN. 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. 2020. All rights reserved. EG512R&EM1x0R_Series_AT_Commands_Manual 1 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual About the Document Revision History Version 1.0 Date 2020-09-12 Author Amos ZHANG/ Amelia LI Description Initial EG512R&EM1x0R_Series_AT_Commands_Manual 2 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Contents About the Document .................................................................................................................................. 2 Contents ...................................................................................................................................................... 3 Table Index.................................................................................................................................................. 8 1 Introduction ......................................................................................................................................... 9 1.1. Scope of the Document ............................................................................................................. 9 1.2. AT Command Syntax ................................................................................................................. 9 1.2.1. Definitions........................................................................................................................ 9 1.2.2. AT Command Syntax ...................................................................................................... 9 1.3. Supported Character Sets ........................................................................................................11 1.4. AT Command Port.....................................................................................................................11 1.5. Unsolicited Result Code............................................................................................................11 1.6. Module Turn-off Procedure ...................................................................................................... 12 2 General Commands .......................................................................................................................... 13 2.1. ATI Display MT Identification Information.............................................................................. 13 2.2. AT+GMI Request Manufacturer Identification ....................................................................... 14 2.3. AT+CGMI Request Manufacturer Identification .................................................................... 14 2.4. AT+GMM Request Model Identification ................................................................................ 15 2.5. AT+CGMM Request MT Model Identification........................................................................ 15 2.6. AT+GMR Request MT Firmware Revision Identification ...................................................... 16 2.7. AT+CGMR Request MT Firmware Revision Identification.................................................... 17 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) ....................................... 17 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) .................................... 18 2.10. AT&F Set All Current Parameters to Factory Setting ............................................................ 19 2.11. AT&V Display Current Configuration ..................................................................................... 19 2.12. AT&W Store Current Parameters to User-defined Profile..................................................... 20 2.13. ATZ Restore All AT Command Settings from User-defined Profile ....................................... 21 2.14. ATQ Set Result Code Presentation Mode............................................................................. 21 2.15. ATV MT Response Format .................................................................................................... 22 2.16. ATE Set Command Echo Mode ............................................................................................ 23 2.17. ATS3 Set Command Line Termination Character ................................................................. 24 2.18. ATS4 Set Response Formatting Character........................................................................... 25 2.19. ATS5 Set Command Line Editing Character......................................................................... 25 2.20. ATX Set CONNECT Result Code Format and Monitor Call Progress.................................. 26 2.21. AT+CFUN Set UE Functionality ............................................................................................ 27 2.22. AT+CMEE Error Message Format ........................................................................................ 28 2.23. AT+CSCS Select TE Character Set ...................................................................................... 29 2.24. AT+QURCCFG Configure URC Indication Option ................................................................ 30 3 Status Control Commands .............................................................................................................. 32 3.1. AT+CPAS Mobile Equipment Activity Status ......................................................................... 32 3.2. AT+CEER Extended Error Report......................................................................................... 33 EG512R&EM1x0R_Series_AT_Commands_Manual 3 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 3.3. AT+QCFG Extended Configuration Settings......................................................................... 34 3.3.1. AT+QCFG='hsdpacat' HSDPA Category Configuration ............................................ 34 3.3.2. AT+QCFG='hsupacat' HSUPA Category Configuration ............................................ 35 3.3.3. AT+QCFG='rrc' RRC Release Version Configuration............................................... 36 3.3.4. AT+QCFG='pdp/duplicatechk' Establish Multi PDNs with the Same APN ............... 37 3.3.5. AT+QCFG='data_interface' Set Network Port/Diagnostic Port Communication Through PCIe/USB Interface ....................................................................................................... 38 3.4. AT+QINDCFG URC Indication Configuration ....................................................................... 39 4 (U)SIM Related Commands .............................................................................................................. 42 4.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) ....................................... 42 4.2. AT+CLCK Facility Lock.......................................................................................................... 43 4.3. AT+CPWD Change Password .............................................................................................. 45 4.4. AT+CPIN Enter PIN ............................................................................................................... 46 4.5. AT+CSIM Generic (U)SIM Access ........................................................................................ 49 4.6. AT+CRSM Restricted (U)SIM Access ................................................................................... 50 4.7. AT+QPINC Display PIN Remainder Counter ........................................................................ 51 4.8. AT+QINISTAT Query Initialization Status of (U)SIM Card..................................................... 52 4.9. AT+QSIMDET (U)SIM Card Detection .................................................................................. 53 4.10. AT+QSIMSTAT (U)SIM Card Insertion Status Report........................................................... 54 4.11. AT+QUIMSLOT Switch (U)SIM Slot...................................................................................... 56 5 Network Service Commands ........................................................................................................... 57 5.1. AT+COPS Operator Selection............................................................................................... 57 5.2. AT+CREG Network Registration Status ................................................................................ 59 5.3. AT+CSQ Signal Quality Report ............................................................................................. 60 5.4. AT+CPOL Preferred Operator List ........................................................................................ 62 5.5. AT+COPN Read Operator Names ........................................................................................ 63 5.6. AT+CTZU Automatic Time Zone Update .............................................................................. 64 5.7. AT+CTZR Time Zone Reporting............................................................................................ 65 5.8. AT+QLTS Obtain the Latest Time Synchronized through Network....................................... 67 5.9. AT+QNWINFO Query Network Information .......................................................................... 69 5.10. AT+QSPN Query the Service Provider Name ...................................................................... 70 5.11. AT+QENG Query Primary Serving Cell and Neighbour Cell Information ............................. 71 5.12. AT+QCAINFO Query Carrier Aggregation Parameters ........................................................ 75 5.13. AT+QNWPREFCFG Configure Network Searching Preferences......................................... 76 5.13.1. AT+QNWPREFCFG='gw_band' WCDMA Band Configuration ................................ 77 5.13.2. AT+QNWPREFCFG='lte_band' LTE Band Configuration......................................... 78 5.13.3. AT+QNWPREFCFG='mode_pref' Network Search Mode Configuration ................. 79 5.13.4. AT+QNWPREFCFG='srv_domain' Service Domain Configuration .......................... 80 5.13.5. AT+QNWPREFCFG='voice_domain' Voice Domain Configuration.......................... 81 5.13.6. AT+QNWPREFCFG='roam_pref' Roaming Preference Configuration..................... 82 5.13.7. AT+QNWPREFCFG='ue_usage_setting' UE Usage Setting Configuration............. 83 5.13.8. AT+QNWPREFCFG='policy_band' Policyman Band................................................ 83 5.13.9. AT+QNWPREFCFG='ue_capability_band' UE Capability Band .............................. 85 EG512R&EM1x0R_Series_AT_Commands_Manual 4 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 5.13.10. AT+QNWPREFCFG='rat_acq_order ' UE RAT Priority ............................................ 86 6 Call Related Commands................................................................................................................... 87 6.1. ATA Answer an Incoming Call ............................................................................................... 87 6.2. ATD Originate a Call.............................................................................................................. 88 6.3. ATH Disconnect Existing Connection.................................................................................... 89 6.4. AT+CVHU Voice Hang up Control......................................................................................... 90 6.5. AT+CHUP Hang up Calls ...................................................................................................... 91 6.6. ATS0 Set Number of Rings before Automatic Answering ..................................................... 91 6.7. ATS6 Set Pause Before Blind Dialing ................................................................................... 93 6.8. ATS7 Set Time to Wait for Connection Completion .............................................................. 93 6.9. ATS8 Set the Time to Wait for Comma Dial Modifier ............................................................ 94 6.10. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier .................... 95 6.11. AT+CSTA Select Type of Address ......................................................................................... 95 6.12. AT+CLCC List Current Calls ................................................................................................. 96 6.13. AT+CR Service Reporting Control ........................................................................................ 98 6.14. AT+CRC Set Cellular Result Codes for Incoming Call Indication......................................... 99 6.15. AT+CRLP Select Radio Link Protocol Parameter ............................................................... 100 6.16. AT+QECCNUM* Configure Emergency Call Numbers....................................................... 101 6.17. AT^DSCI Call Status Indication ........................................................................................... 103 7 Phonebook Commands.................................................................................................................. 106 7.1. AT+CNUM Subscriber Number ........................................................................................... 106 7.2. AT+CPBF Find Phonebook Entries..................................................................................... 107 7.3. AT+CPBR Read Phonebook Entries................................................................................... 108 7.4. AT+CPBS Select Phonebook Memory Storage .................................................................. 109 7.5. AT+CPBW Write Phonebook Entry ......................................................................................110 8 Short Message Service Commands.............................................................................................. 112 8.1. AT+CSMS Select Message Service.....................................................................................112 8.2. AT+CMGF Message Format ................................................................................................113 8.3. AT+CSCA Service Center Address ......................................................................................114 8.4. AT+CPMS Preferred Message Storage ...............................................................................115 8.5. AT+CMGD Delete Messages ...............................................................................................117 8.6. AT+CMGL List Messages.....................................................................................................118 8.7. AT+CMGR Read Messages ................................................................................................ 121 8.8. AT+CMGS Send Messages ................................................................................................ 125 8.9. AT+CMMS Send More Messages....................................................................................... 126 8.10. AT+CMGW Write Messages to Memory ............................................................................. 127 8.11. AT+CMSS Send Messages from Storage........................................................................... 129 8.12. AT+CNMA New Message Acknowledgement to ME/TA ..................................................... 131 8.13. AT+CNMI New Message Indications to TE ......................................................................... 133 8.14. AT+CSCB Select Cell Broadcast Message Types .............................................................. 135 8.15. AT+CSDH Show Text Mode Parameters ............................................................................ 136 8.16. AT+CSMP Set Text Mode Parameters................................................................................ 137 EG512R&EM1x0R_Series_AT_Commands_Manual 5 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 9 Packet Domain Commands ........................................................................................................... 139 9.1. AT+CGATT PS Attach or Detach......................................................................................... 139 9.2. AT+CGDCONT Define PDP Contexts................................................................................. 140 9.3. AT+CGQREQ Quality of Service Profile (Requested) ........................................................ 142 9.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) ......................................... 145 9.5. AT+CGACT Activate or Deactivate PDP Contexts ............................................................. 147 9.6. AT+CGDATA Enter Data State ............................................................................................ 148 9.7. AT+CGPADDR Show PDP Addresses................................................................................ 149 9.8. AT+CGREG GPRS Network Registration Status................................................................ 150 9.9. AT+CGEREP Packet Domain Event Reporting .................................................................. 152 9.10. AT+CGSMS Select Service for MO SMS Messages .......................................................... 155 9.11. AT+CEREG EPS Network Registration Status ................................................................... 156 9.12. AT+QGDCNT Packet Data Counter.................................................................................... 157 9.13. AT+QAUGDCNT Auto Save Packet Data Counter ............................................................. 158 10 Supplementary Service Commands ............................................................................................. 160 10.1. AT+CCFC Call Forwarding Number and Conditions Control.............................................. 160 10.2. AT+CCWA Call Waiting Control .......................................................................................... 162 10.3. AT+CHLD Call Related Supplementary Services ............................................................... 165 10.4. AT+CLIP Calling Line Identification Presentation ............................................................... 167 10.5. AT+CLIR Calling Line Identification Restriction .................................................................. 169 10.6. AT+COLP Connected Line Identification Presentation ....................................................... 170 10.7. AT+CSSN Supplementary Service Notifications................................................................. 171 10.8. AT+CUSD Unstructured Supplementary Service Data ....................................................... 173 11 Audio Commands ........................................................................................................................... 175 11.1. AT+CLVL Loudspeaker Volume Level Selection................................................................. 175 11.2. AT+CMUT Mute Control ...................................................................................................... 176 11.3. AT+QAUDLOOP Enable/Disable Audio Loop Test ............................................................. 177 11.4. AT+VTS DTMF and Tone Generation ................................................................................. 177 11.5. AT+VTD Set Tone Duration ................................................................................................. 179 11.6. AT+QAUDMOD* Set Audio Mode ....................................................................................... 180 11.7. AT+QDAI Digital Audio Interface Configuration .................................................................. 181 11.8. AT+QSIDET Set Side Tone Gain in Current Mode ............................................................. 183 11.9. AT+QMIC Set Uplink Gains of Microphone......................................................................... 184 11.10. AT+QIIC IIC Read and Write ............................................................................................... 184 12 Hardware Related Commands ....................................................................................................... 186 12.1. AT+QPOWD Power off ........................................................................................................ 186 12.2. AT+CCLK Clock................................................................................................................... 187 12.3. AT+QADC Read ADC Value................................................................................................ 188 12.4. AT+QSCLK Sleep Mode Setting ......................................................................................... 188 12.5. AT+QTEMP Get the Temperature of MT............................................................................. 189 12.6. AT+QAGPIO Set the AP Or PMU GPIO Output Value ....................................................... 190 12.7. AT+QSAR Enable/Disable the SAR Power Backoff ........................................................... 192 12.8. AT+QETH RGMII Extended Configuration.......................................................................... 193 EG512R&EM1x0R_Series_AT_Commands_Manual 6 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 12.8.1. 12.8.2. 12.8.3. 12.8.4. 12.8.5. 12.8.6. 12.8.7. 12.8.8. AT+QETH=? AT+QETH Test Command .................................................................. 193 AT+QETH='rgmii' Query/Enable/Disable RGMII..................................................... 193 AT+QETH='ipptmac' Set IPPassthrough-RGMII MAC Address ............................. 196 AT+QETH='routing' Set Routing Rules for Multiple Data Call ................................ 197 AT+QETH='mac_address' Query RGMII Interface MAC Address.......................... 199 AT+QETH='speed' Set the Speed for RGMII .......................................................... 199 AT+QETH='an' Enable or Disable Auto-negotiation for RGMII............................... 200 AT+QETH='dm' Set the Duplex Mode for RGMII.................................................... 201 13 Appendix A References.................................................................................................................. 203 13.1. References ............................................................................................................................. 203 13.2. Factory Default Settings Restorable with AT&F..................................................................... 206 13.3. AT Command Settings Storable with AT&W .......................................................................... 208 13.4. AT Command Settings Storable with ATZ .............................................................................. 208 13.5. Summary of CME ERROR Codes ......................................................................................... 209 13.6. Summary of CMS ERROR Codes ..........................................................................................211 13.7. Summary of URC ................................................................................................................... 212 13.8. SMS Character Sets Conversions ......................................................................................... 214 13.9. Release Cause Report List of AT+CEER .............................................................................. 220 EG512R&EM1x0R_Series_AT_Commands_Manual 7 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Table Index Table 1: Applicable Modules......................................................................................................................... 9 Table 2: Types of AT Commands and Responses ..................................................................................... 10 Table 3: AT&V Response............................................................................................................................ 19 Table 4: The Numeric Equivalents and Brief Description of ATV0&ATV1 Result Codes........................... 23 Table 5: Delay Class................................................................................................................................. 144 Table 6: Related Documents .................................................................................................................... 203 Table 7: Terms and Abbreviations ............................................................................................................ 203 Table 8: Factory Default Settings Restorable with AT&F ......................................................................... 206 Table 9: AT Command Settings Storable with AT&W ............................................................................... 208 Table 10: AT Command Settings Storable with ATZ ................................................................................ 208 Table 11: Different Coding Schemes of +CME ERROR: ................................................................ 209 Table 12: Different Coding Schemes of +CMS ERROR: ............................................................... 211 Table 13: Summary of URC ..................................................................................................................... 212 Table 14: The Way of SMS Text Input or Output...................................................................................... 214 Table 15: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') ................................ 215 Table 16: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM').............................. 215 Table 17: GSM Extended Characters (GSM Encode) ............................................................................. 216 Table 18: The Input Conversions Table (DCS = GSM 7-bit and AT+CSCS='IRA')................................. 217 Table 19: IRA Extended Characters......................................................................................................... 218 Table 20: The Output Conversions Table (DCS = GSM 7-bit and AT+CSCS='IRA').............................. 218 Table 21: GSM Extended Characters (ISO-8859-1/Unicode).................................................................. 219 Table 22: Release Cause Report List of AT+CEER ................................................................................. 220 EG512R&EM1x0R_Series_AT_Commands_Manual 8 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 1 Introduction 1.1. Scope of the Document This document presents the AT command set supported by Quectel LTE-A modules EM160R-GL, EM120R-GL, and EG512R-EA. Table 1: Applicable Modules Module Series EG512R-EA EM160R-GL EM120R-GL Model EG512R-EA EM160R-GL EM120R-GL 1.2. AT Command Syntax 1.2.1. Definitions ⚫ ⚫ ⚫ ⚫ [...] ⚫ Underline Carriage return character. Line feed character. Parameter name. Angle brackets do not appear on command line. Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on command line. When an optional parameter is omitted, the new value equals its previous value or its default setting, unless otherwise specified. Default setting of a parameter. 1.2.2. AT Command Syntax The AT or at prefix must be added at the beginning of each command line. Entering will terminate a command line. Commands are usually followed by a response that includes . Throughout this document, only the response will be presented, are omitted intentionally. EG512R&EM1x0R_Series_AT_Commands_Manual 9 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual The AT command set supported by EM160R-GL, EM120R-GL and EG512R-EA is a combination of international standards, such as 3GPP TS 27.007, 3GPP TS 27.005 and ITU-T recommendation V.25ter as well as the AT commands developed by Quectel. AT commands implemented by the modules can be split into three categories syntactically: 'Basic', 'S Parameter' and 'Extended', as listed below: ⚫ Basic Syntax These AT commands have the format of AT, or AT&, where is the command, and is/are the argument(s) for that command. An example of this is ATE, which tells the DCE (Data Circuit-terminating Equipment) whether received characters should be echoed back to the DTE (Data Terminal Equipment) according to the value of . is optional and a default will be used if it is omitted. ⚫ S Parameter Syntax These AT commands are in the format of ATS=, in which is the index of the S register to set, and is the value to assign to it. ⚫ Extended Syntax These commands can be operated in several modes, as listed in the following table: Table 2: Types of AT Commands and Responses Test Command Read Command Write Command Execution Command The command returns the list of parameters and value AT+=? ranges set by the corresponding Write Command or internal processes. AT+? The command returns the currently set value of the parameter or parameters. AT+=[,< The command sets the user-definable parameter values. p2>[,[...]]] AT+ The command reads non-variable parameters affected by internal processes in the UE. 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 the following cases: ⚫ Within quoted strings, where they are preserved; EG512R&EM1x0R_Series_AT_Commands_Manual 10 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual ⚫ Within an unquoted string or numeric parameter; ⚫ Within an IP address; ⚫ Within the AT command name up to and including a =, ? or =?. 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 specified after the AT token, OK will be returned. If an invalid command is specified, ERROR will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. 1.3. Supported Character Sets The AT command interface of EM160R-GL, EM120R-GL and EG512R-EA uses the GSM character set by default and supports the following character sets: ⚫ GSM ⚫ UCS2 ⚫ IRA These character sets can be configured and interrogated with AT+CSCS command (3GPP TS 27.007) and it is defined in 3GPP TS 27.005. The character set affects transmission and reception of SMS and SMS Cell Broadcast Messages, as well as the entry and display of phonebook entries text field. 1.4. AT Command Port The main UART port, PCIe Modem port and two USB ports (USB modem port and USB AT port) support AT command communication and data transfer. 1.5. Unsolicited Result Code Unsolicited Result Code (URC) is not issued as a part of the response related to an executed AT command, but as a report message issued by the modules without being requested by the TE. It is issued automatically when a certain event occurs. Typical events leading to URCs are incoming calls (RING), received short messages, high/low voltage alarm, high/low temperature alarm, etc. EG512R&EM1x0R_Series_AT_Commands_Manual 11 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 1.6. Module Turn-off Procedure It is recommended to execute AT+QPOWD command to power off the module, since it is the safest and best method through which the powering off is realized by letting the module log off from the network and allowing the software to enter a secure and safe data state before disconnecting the power supply. After sending AT+QPOWD, please do not enter any other AT commands. When the command is executed successfully, the module will output message POWERED DOWN and then enter the power down mode. In order to avoid data loss, it is suggested to wait for 1s to disconnect the power supply after the URC POWERED DOWN is outputted. If POWERED DOWN cannot be received within 65s, the power supply shall be disconnected compulsorily. EG512R&EM1x0R_Series_AT_Commands_Manual 12 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2 General Commands 2.1. ATI Display MT Identification Information This Execution Command delivers the MT identification information text. ATI Display MT Identification Information Execution Command ATI Response Quectel Revision: Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identifier of device type. String type. Identification text of the firmware version of the module. Example ATI Quectel EG512 Revision: EG512REAAAR01A02M4G OK EG512R&EM1x0R_Series_AT_Commands_Manual 13 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2.2. AT+GMI Request Manufacturer Identification This Execution Command returns the manufacturer identification text. It is identical with AT+CGMI command in Chapter 2.3. AT+GMI Request Manufacturer Identification Test Command AT+GMI=? Execution Command AT+GMI Response OK Response Quectel Maximum Response Time Characteristics Reference V.25ter OK 300 ms / 2.3. AT+CGMI Request Manufacturer Identification This command returns the manufacturer identification text. It is identical with the above AT+GMI command. AT+CGMI Request Manufacturer Identification Test Command AT+CGMI=? Execution Command AT+CGMI Response OK Response Quectel Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / EG512R&EM1x0R_Series_AT_Commands_Manual 14 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2.4. AT+GMM Request Model Identification This command returns the MT model identification text. It is identical with AT+CGMM command in Chapter 2.5. AT+GMM Request MT Model Identification Test Command AT+GMM=? Execution Command AT+GMM Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identifier of device type. 2.5. AT+CGMM Request MT Model Identification This command returns the model information of the product. It is identical with the above AT+GMM command. AT+CGMM Request MT Model Identification Test Command AT+CGMM=? Execution Command AT+CGMM Response OK Response Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / EG512R&EM1x0R_Series_AT_Commands_Manual 15 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. Identifier of device type. 2.6. AT+GMR Request MT Firmware Revision Identification This Execution Command returns the identification text of MT firmware version. It is identical with AT+CGMR command in Chapter 2.7. AT+GMR Request Firmware Revision Identification Test Command AT+GMR=? Execution Command AT+GMR Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identification text of MT firmware version. Example AT+GMR EG512REAAAR01A02M4G OK EG512R&EM1x0R_Series_AT_Commands_Manual 16 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2.7. AT+CGMR Request MT Firmware Revision Identification This Execution Command delivers the identification text of MT firmware version. It is identical with the above AT+GMR command. AT+CGMR Request Firmware Revision Identification Test Command AT+CGMR=? Execution Command AT+CGMR Response OK Response Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter String type. Identification text of MT firmware version. 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) This Execution Command requests the International Mobile Equipment Identity (IMEI) number of the ME which permits the user to identify individual ME device. It is identical with the AT+CGSN command in Chapter 2.9. AT+GSN Request International Mobile Equipment Identity (IMEI) Test Command AT+GSN=? Execution Command AT+GSN Response OK Response Maximum Response Time Characteristics Reference OK 300 ms / EG512R&EM1x0R_Series_AT_Commands_Manual 17 / 227 V.25ter LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. IMEI number of the ME. NOTE The IMEI can be used to identify an ME since it is unique to each ME. 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) This Execution Command requests International Mobile Equipment Identity (IMEI) number of the ME. It is identical with the above AT+GSN command. AT+CGSN Request International Mobile Equipment Identity (IMEI) Test Command AT+CGSN=? Execution Command AT+CGSN Response OK Response Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter String type. IMEI number of the ME. NOTE The IMEI can be used to identify an ME since it is unique to each ME. EG512R&EM1x0R_Series_AT_Commands_Manual 18 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2.10. AT&F Reset AT Command Settings to Factory Settings This command resets AT command settings to the default values specified by the manufacturer (See Table 8). AT&F Reset AT Command Settings to Factory Settings Execution Command AT&F[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Reset all AT command settings to factory setting. 2.11. AT&V Display Current Configuration This command displays the current settings of some AT command parameters (See Table 3), even including the single-letter AT command parameters which are not readable. AT&V Display Current Configuration Execution Command AT&V Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Table 3: AT&V Response AT&V &C: 1 &D: 2 &F: 0 EG512R&EM1x0R_Series_AT_Commands_Manual 19 / 227 &W: 0 E: 1 Q: 0 V: 1 X: 4 Z: 0 S0: 0 S3: 13 S4: 10 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 OK LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2.12. AT&W Store Current Settings to User-defined Profile This command stores the current AT command settings to a user-defined profile in non-volatile memory (See Table 9). The AT command settings will be automatically restored from the user-defined profile during power-up or if ATZ is executed. AT&W Store Current Settings to User-defined Profile Execution Command AT&W[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Profile number to store current AT command settings. EG512R&EM1x0R_Series_AT_Commands_Manual 20 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2.13. ATZ Restore All AT Command Settings from User-defined Profile This command first resets the AT command settings to their manufacturer defaults, which is similar to AT&F. Afterwards, the AT command settings are restored from the user-defined profile in the non-volatile memory, if they have been stored with AT&W before (See Table 10). Any additional AT command on the same command line may be ignored. ATZ Restore AT Command Settings from a User-defined Profile Execution Command ATZ[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Reset to profile number 0. 2.14. ATQ Set Result Code Presentation Mode This command controls whether the result code is transmitted to the TE. Other information text transmitted as response is not affected. ATQ Set Result Code Presentation Mode Execution Command ATQ Response If = 0: OK Maximum Response Time Characteristics Reference V.25ter If = 1: (none) 300 ms / EG512R&EM1x0R_Series_AT_Commands_Manual 21 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter Integer type. 0 Result codes are transmitted 1 Result codes are suppressed and not transmitted 2.15. ATV MT Response Format This command determines the contents of header and trailer transmitted with AT command result codes and information responses. The numeric equivalents and brief descriptions of results code are listed in the following Table 4. ATV MT Response Format Execution Command ATV Response When = 0 0 Maximum Response Time Characteristics Reference V.25ter When = 1 OK 300 ms / Parameter Integer type. 0 Information response: Short result code format: 1 Information response: Long result code format: Example ATV1 OK AT+CSQ +CSQ: 30,99 //Set = 1 EG512R&EM1x0R_Series_AT_Commands_Manual 22 / 227 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //When = 1, the result code is OK. //Set = 0 //When = 0, the result code is 0. Table 4: The Numeric Equivalents and Brief Description of ATV0&ATV1 Result Codes ATV1 OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY NO ANSWER ATV0 0 1 2 3 4 6 7 8 Description Acknowledges execution of a command. A connection has been established. The DCE is switching from command mode to data mode. The DCE has detected an incoming call signal from network. The connection has been terminated or the attempt to establish a connection failed. Command not recognized, caused by command line maximum length exceeded, parameter value invalid, or other problem with processing the command line. No dial tone detected. Engaged (busy) signal detected. @ (Wait for Quiet Answer) dialing modifier was used, but remote ringing followed by five seconds of silence was not detected before expiration of the connection timer (S7). 2.16. ATE Set Command Echo Mode This command controls whether TA echoes characters received from TE or not during AT command mode. ATE Set Command Echo Mode Execution Command ATE Maximum Response Time Response OK 300 ms Characteristics / EG512R&EM1x0R_Series_AT_Commands_Manual 23 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Reference V.25ter Parameter Integer type. Whether to echo the characters received from TE. 0 OFF 1 ON 2.17. ATS3 Set Command Line Termination Character This command determines the character recognized by TA to terminate an incoming command line. It is also generated for result codes and information text, along with character value set via ATS4. ATS3 Set Command Line Termination Character Read Command ATS3? Response Write Command ATS3= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms / Parameter Integer type. Command line termination character. Range: 0–127. Default: 13. EG512R&EM1x0R_Series_AT_Commands_Manual 24 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2.18. ATS4 Set Response Formatting Character This command determines the character generated by TA for result code and information text, along with the command line termination character set via ATS3. ATS4 Set Response Formatting Character Read Command ATS4? Response Write Command ATS4= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms / Parameter Integer type. Response formatting character. Range: 0–127. Default: 10. 2.19. ATS5 Set Command Line Editing Character This command determines the value of editing character used by TA to delete the immediately preceding character from the AT command line (i.e. equates to backspace key). ATS5 Set Command Line Editing Character Read Command ATS5? Response Write Command ATS5= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms / EG512R&EM1x0R_Series_AT_Commands_Manual 25 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter Integer type. Response editing character. Range: 0–127. Default: 8. 2.20. ATX Set CONNECT Result Code Format and Monitor Call Progress This command determines whether TA transmits particular result codes to TE or not. It also controls whether TA detects the presence of a dial tone when it begins dialing and the engaged tone (busy signal) or not. ATX Set CONNECT Result Code Format and Monitor Call Progress Execution Command ATX Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Only CONNECT result code returned, dial tone and busy detection are both disabled. 1 Only CONNECT result code returned, dial tone and busy detection are both disabled. 2 CONNECT result code returned, dial tone detection is enabled, and busy detection is disabled. 3 CONNECT result code returned, dial tone detection is disabled, and busy detection is enabled. 4 CONNECT result code returned, and dial tone and busy detection are both enabled. EG512R&EM1x0R_Series_AT_Commands_Manual 26 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2.21. AT+CFUN Set UE Functionality This command controls the functionality level. It can also be used to reset the UE. AT+CFUN Set UE Functionality Test Command AT+CFUN=? Response +CFUN: (list of supported s),(list of supported s) Read Command AT+CFUN? OK Response +CFUN: Write Command AT+CFUN=[,] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: ERROR Or +CME ERROR: 15 s, determined by the network. / Parameter Integer type. 0 Minimum functionality 1 Full functionality 4 Disable both transmitting and receiving RF signals Integer type. 0 Do not reset the UE before setting it to power level 1 Reset the UE before setting it to power level. This value is available only for = 1. The device is fully functional after the reset. Error codes. For more details, please refer to Table 11. Example AT+CFUN=0 OK //Switch the UE to minimum functionality. EG512R&EM1x0R_Series_AT_Commands_Manual 27 / 227 AT+COPS? +COPS: 0 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN=1234 OK +CPIN: READY +QUSIM: 1 +QIND: SMS DONE +QIND: PB DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE CMCC',7 OK LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //No operator is registered. //(U)SIM failure //Switch the UE to full functionality. //Operator is registered. 2.22. AT+CMEE Error Message Format This command disables or enables the use of final result code +CME ERROR: as the indication of an error. When enabled, errors cause +CME ERROR: final result code instead of ERROR. AT+CMEE Error Message Format Test Command AT+CMEE=? Response +CMEE: (range of supported s) Read Command AT+CMEE? OK Response +CMEE: EG512R&EM1x0R_Series_AT_Commands_Manual 28 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Write Command AT+CMEE=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms / Parameter Integer type. Whether to enable result code. 0 Disable result code and use ERROR instead. 1 Enable result code and use numeric values. 2 Enable result code and use verbose values. Error codes. For more details, please refer to Table 11. Example AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted //Disable result code. //Only ERROR will be displayed. //Enable error result code with numeric values. //Enable error result code with verbose (string) values. 2.23. AT+CSCS Select TE Character Set This Write Command informs the MT which character set is used by the TE. TA is then able to convert character strings correctly between TE and MT character sets. AT+CSCS Select TE Character Set Test Command AT+CSCS=? Response +CSCS: (list of supported s) EG512R&EM1x0R_Series_AT_Commands_Manual 29 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Read Command AT+CSCS? Write Command AT+CSCS= Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response +CSCS: OK Response OK 300 ms / Parameter String type. 'GSM' 'IRA' 'UCS2' GSM default alphabet International reference alphabet UCS2 alphabet Example AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //Query the current character set. //The character set is GSM //Set the character set to UCS2. //The character set is UCS2 after the configuration 2.24. AT+QURCCFG Configure URC Indication Option This command configures the output port of URC. AT+QURCCFG Configure URC Indication Option Test Command AT+QURCCFG=? Response +QURCCFG: 'urcport',(list of supported s) EG512R&EM1x0R_Series_AT_Commands_Manual 30 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Write Command AT+QURCCFG='urcport'[,] OK Response If the optional parameter is omitted, query the current configuration: +QURCCFG: 'urcport', OK Maximum Response Time Characteristics If the optional parameter is specified, configure the output port of URC: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter String type. URC output port. 'usbat' USB AT port 'usbmodem' USB modem port 'uart1' Main UART Example AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' //Query the current configuration of URC output port OK AT+QURCCFG='urcport','usbmodem' OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' //Configure the URC output port to USB modem port OK EG512R&EM1x0R_Series_AT_Commands_Manual 31 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 3 Status Control Commands 3.1. AT+CPAS Mobile Equipment Activity Status This command queries the activity status of the ME. AT+CPAS Mobile Equipment Activity Status Test Command AT+CPAS=? Response +CPAS: (list of supported s) Execution Command AT+CPAS OK Response TA returns the activity status of MT: +CPAS: OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. MT activity status. 0 Ready 3 Ringing 4 Call in progress or call hold Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 32 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Example AT+CPAS +CPAS: 0 OK RING ##0 AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129 OK AT+CPAS +CPAS: 4 OK //MT is ready. //MT is ringing. //Call in progress. 3.2. AT+CEER Extended Error Report This command queries an extended error and report the cause of the last failed operation, such as: ⚫ The failure to release a call ⚫ The failure to set up a call (both mobile originated or terminated) ⚫ The failure to modify a call by using supplementary services ⚫ The failure to activate, register, query, deactivate or deregister a supplementary service The release cause is a text to describe the cause information given by the network. AT+CEER Extended Error Report Test Command AT+CEER=? Execution Command AT+CEER Response OK Response +CEER: OK EG512R&EM1x0R_Series_AT_Commands_Manual 33 / 227 Maximum Response Time Characteristics LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Or ERROR If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Release cause report. Reason for the last failed operation (listed in Chapter 13.9). Both CS and PS domain call types are reported. Cause data is captured from Call Manager events and cached locally to later use by this command. Error codes. For more details, please refer to Table 11. 3.3. AT+QCFG Extended Configuration Settings This command queries and configures various settings of UE. AT+QCFG Extended Configuration Settings Test Command AT+QCFG=? Response +QCFG: 'hsdpacat',(list of supported s) +QCFG: 'hsupacat',(list of supported s) +QCFG: 'rrc',(range of supported s) +QCFG: 'pdp/duplicatechk',(list of supported s) +QCFG: 'data_interface',(list of supported s),(list of supported s) … Maximum Response Time OK 300 ms 3.3.1. AT+QCFG='hsdpacat' HSDPA Category Configuration This command specifies the HSDPA category. AT+QCFG='hsdpacat' HSDPA Category Configuration Write Command AT+QCFG='hsdpacat'[,] Response If the optional parameter is omitted, return the current configuration: EG512R&EM1x0R_Series_AT_Commands_Manual 34 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics +QCFG: 'hsdpacat', OK If the optional parameter is specified, set the HSDPA category: OK Or ERROR If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. HSDPA category. 6 Category 6 8 Category 8 10 Category 10 12 Category 12 14 Category 14 18 Category 18 20 Category 20 24 Category 24 Error codes. For more details, please refer to Table 11. 3.3.2. AT+QCFG='hsupacat' HSUPA Category Configuration This command specifies the HSUPA category. AT+QCFG='hsupacat' HSUPA Category Configuration Write Command AT+QCFG='hsupacat'[,] Response If the optional parameter is omitted, return the current configuration: +QCFG: 'hsupacat', OK If the optional parameter is specified, set the HSUPA category: EG512R&EM1x0R_Series_AT_Commands_Manual 35 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics OK Or ERROR If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. HSUPA category. 5 Category 5 6 Category 6 7 Category 7 8 Category 8 Error codes. For more details, please refer to Table 11. 3.3.3. AT+QCFG='rrc' RRC Release Version Configuration This command specifies the RRC release version. AT+QCFG='rrc' RRC Release Version Configuration Write Command AT+QCFG='rrc'[,] Response If the optional parameter is omitted, return the current configuration: +QCFG: 'rrc', OK If the optional parameter is specified, set the RRC release version: OK Or ERROR Maximum Response Time Characteristics If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configuration will be saved automatically. EG512R&EM1x0R_Series_AT_Commands_Manual 36 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter Integer type. RRC release version. 0 R99 1 R5 2 R6 3 R7 4 R8 5 R9 Error codes. For more details, please refer to Table 11. 3.3.4. AT+QCFG='pdp/duplicatechk' Establish Multi PDNs with the Same APN This command allows/refuses establishing multi PDNs with the same APN profile. AT+QCFG='PDP/duplicatechk' Establish Multi PDNs with the Same APN Write Command AT+QCFG='pdp/duplicatechk'[,] Response If the optional parameter is omitted, return the current configuration: +QCFG: 'pdp/duplicatechk', OK If the optional parameter is specified, allow/refuse establishing multiple PDNs with the same APN profile: OK Or ERROR Maximum Response Time Characteristics If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. 0 Refuse to establish multi PDNs with the same APN profile 1 Allow to establish multi PDNs with the same APN profile Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 37 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 3.3.5. AT+QCFG='data_interface' Set Network Port/Diagnostic Port Communication Through PCIe/USB Interface This command sets the network port/diagnostic port communication through USB/PCIe interface. AT+QCFG='data_interface' Set Network Port/Diagnostic Port Communication Through PCIe/USB Interface Write Command AT+QCFG='data_interface'[, ,] Response If the optional parameters are omitted, query the current configuration: +QCFG: 'data_interface',, OK Maximum Response Time Characteristics If the optional parameters are specified, set the network port/diagnostic port communication through USB/PCIe interface: OK Or ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. 0 Set network port communication through USB interface. 1 Set network port communication through PCIe interface. Integer type. 0 Set diagnostic port communication through USB interface. 1 Set diagnostic port communication through PCIe interface. NOTES 1. If the network port and diagnostic port communication is switched to PCIe through eFuse, this command will be invalid, and the communication cannot be switched back to USB any longer. 2. If the network port was set to communicate through the USB interface, the PCIe interface will be disabled. Therefore, if the network port is set to communicate through the USB interface, no AT port or diagnostic port will communicate through the PCIe interface. EG512R&EM1x0R_Series_AT_Commands_Manual 38 / 227 Example AT+QCFG='data_interface' +QCFG: 'data_interface',0,0 OK AT+QCFG='data_interface',1,0 OK AT+QCFG='data_interface',1,1 OK LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //Query the current configuration. //Set network port communication through PCIe interface, and diagnostic port through USB interface. //Set network port communication through PCIe interface, and diagnostic port through PCIe interface. 3.4. AT+QINDCFG URC Indication Configuration This command enables/disables URC indications. AT+QINDCFG URC Indication Configuration Test Command AT+QINDCFG=? Response +QINDCFG: 'all',(list of supported s),(list of supported s) +QINDCFG: 'csq',(list of supported s),(list of supported s) +QINDCFG: 'smsfull',(list of supported s),(list of supported s) +QINDCFG: 'ring',(list of supported s),(list of supported s) +QINDCFG: 'smsincoming',(list of supported s), (list of supported s) +QINDCFG: 'act',(list of supported s),(list of supported s) Write Command AT+QINDCFG=[,[,< savetonvram>]] OK Response If both of the optional parameters are omitted, query the current configuration: +QINDCFG: , OK If any of the optional parameters is specified, set the URC indication configurations: OK EG512R&EM1x0R_Series_AT_Commands_Manual 39 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Or ERROR If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect immediately. Whether to save configuration depends on . Parameter String type. URC type. 'all' Master switch of all URCs. Default: ON. 'csq' Indication of signal strength and channel bit error rate change (similar to AT+CSQ). Default: OFF. If this configuration is ON, +QIND: 'csq',, is present. 'smsfull' SMS storage full indication. Default: OFF. If this configuration is ON, +QIND: 'smsfull', is present. 'ring' RING indication. Default: ON. 'smsincoming' Incoming message indication. Default: ON. Related URCs list: +CMTI, +CMT, +CDS 'act' Indication of network access technology change. Default: OFF. If this configuration is ON, +QIND: 'act', is present. is string type. The values are as below: 'WCDMA' 'HSDPA' 'HSUPA' 'HSDPA&HSUPA' 'LTE' 'UNKNOWN' The examples of URC are as below: +QIND: 'act','HSDPA&HSUPA' +QIND: 'act','UNKNOWN' The description of 'act' is as below: 1. If MT does not register on network, the would be 'UNKNOWN'. 2. If this configuration is ON, the URC of 'act' will be reported immediately. Only when the network access technology changes, a new URC will be reported. Integer type. URC indication is enabled or disabled. 0 Disable 1 Enable Integer type. Whether to save configuration into NVM. EG512R&EM1x0R_Series_AT_Commands_Manual 40 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 0 Not save 1 Save Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 41 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 4 (U)SIM Related Commands 4.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) This command requests the International Mobile Subscriber Identity (IMSI) which is intended to permit the TE to identify the individual SIM card or active application in the UICC (GSM or USIM) that is attached to MT. AT+CIMI Request International Mobile Subscriber Identity (IMSI) Test Command AT+CIMI=? Execution Command AT+CIMI Response OK Response TA returns for identifying the individual (U)SIM which is attached to MT. OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter International mobile subscriber identity (string without double quotes). Error codes. For more details, please refer to Table 11. Example AT+CIMI 460023210226023 //Query IMSI number of (U)SIM which is attached to MT. //The IMSI returned by MT OK EG512R&EM1x0R_Series_AT_Commands_Manual 42 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 4.2. AT+CLCK Facility Lock This command locks/unlocks or interrogates an MT or a network facility . Password is normally needed to do such actions. When querying the status of network service (=2) the response line for ‘not active’ case (=0) should be returned only if service is not active for any . AT+CLCK Facility Lock Test Command AT+CLCK=? Response +CLCK: (list of supported s) OK Write Command Response AT+CLCK=,[,<passwor If is not 2 and the command is set successfully: d>[,]] OK If =2 and the command is set successfully: +CLCK: [,] [+CLCK: [,]] […] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 5 s The command takes effect immediately. The configuration will be saved automatically. Parameter String type. Facility. 'SC' (U)SIM (lock SIM/UICC card inserted in the currently selected card slot) (SIM/UICC asks password in MT power-up and when this lock command is issued). 'AO' BAOC (Bar All Outgoing Calls) (see 3GPP TS 22.088 [6] clause 1). 'OI' BOIC (Bar Outgoing International Calls) (see 3GPP TS 22.088 [6] clause 1). 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country) (see 3GPP TS 22.088 [6] clause 1). 'AI' BAIC (Bar All Incoming Calls) (see 3GPP TS 22.088 [6] clause 2). 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (see 3GPP TS 22.088 [6] clause 2). 'AB' All Barring services (see 3GPP TS 22.030 [19]) (applicable only for =0). 'AG' All outGoing barring services (see 3GPP TS 22.030 [19]) (applicable only for EG512R&EM1x0R_Series_AT_Commands_Manual 43 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 'AC' 'FD' 'PF' 'PN' 'PU' 'PP' 'PC' =0). All inComing barring services (see 3GPP TS 22.030 [19]) (applicable only for =0). (U)SIM card or active application in the UICC (GSM or (U)SIM) fixed dialing memory feature (if PIN2 authentication has not been done during the current session, PIN2 is required as ). Lock Phone to the very First inserted SIM/UICC card (also referred in the present document as PH-FSIM) (MT asks password when other SIM/UICC cards are inserted). Network Personalization (see 3GPP TS 22.022 [33]) Network sUbset Personalization (see 3GPP TS 22.022 [33]) Service Provider Personalization (see 3GPP TS 22.022 [33]) Corporate Personalization (see 3GPP TS 22.022 [33]) Integer type. Operation. 0 Unlock 1 Lock 2 Query status String type. Password. Integer type. A sum of integers each representing a class of information. 1 Voice 2 Data 4 FAX 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization Integer type. Lock status. 0 OFF 1 ON Example AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK //Query the status of (U)SIM card. //The (U)SIM card is unlocked (OFF). //Lock (U)SIM card, and the password is 1234. //Query the status of (U)SIM card. //The (U)SIM card is locked (ON). //Unlock (U)SIM card. EG512R&EM1x0R_Series_AT_Commands_Manual 44 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 4.3. AT+CPWD Change Password This command sets a new password for the facility lock function defined by AT+CLCK. AT+CPWD Change Password Test Command AT+CPWD=? Response MT returns a list of pairs which present the available facilities and the maximum length of their password. +CPWD: (list of supported s), Write Command AT+CPWD=,, OK Response MT sets a new password for the facility lock function. OK Maximum Response Time 5 s Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configuration will be saved automatically. Parameter String type. 'SC' (U)SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command is issued) 'AO' BAOC (Bar All Outgoing Calls, see 3GPP TS 22.088) 'OI' BOIC (Bar Outgoing International Calls, see 3GPP TS 22.088) 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country, see 3GPP TS 22.088) 'AI' BAIC (Bar All Incoming Calls, see 3GPP TS 22.088) 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country, see 3GPP TS 22.088) 'AB' All barring services (see 3GPP TS 22.030, applicable only for =0) 'AG' All outgoing barring services (see 3GPP TS 22.030, applicable only for =0) 'AC All incoming barring services (see 3GPP TS 22.030, applicable only for =0) 'FD' (U)SIM card or active application in the UICC (GSM or (U)SIM) fixed dialing memory feature (if PIN2 authentication has not been done during the current session, PIN2 is required as ). 'PF' Lock Phone to the very First inserted SIM/UICC card (also referred in the EG512R&EM1x0R_Series_AT_Commands_Manual 45 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual present document as PH-FSIM) (MT asks password when other SIM/UICC cards are inserted). 'PN' Network Personalization (see 3GPP TS 22.022 [33]) 'PU' Network sUbset Personalization (see 3GPP TS 22.022 [33]) 'PP' Service Provider Personalization (see 3GPP TS 22.022 [33]) 'PC' Corporate Personalization (see 3GPP TS 22.022 [33]) Integer type. Maximum length of password. String type. Password specified for the facility from the user interface or with command. String type. New password. Example AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' OK //Restart MT or re-activate the (U)SIM card AT+CPIN? +CPIN: SIM PIN //Change (U)SIM card password to '4321'. //Waiting (U)SIM PIN to be given. OK AT+CPIN='4321' OK //PIN must be entered to define a new password '4321'. +CPIN: READY 4.4. AT+CPIN Enter PIN This command sends to the MT a password which is necessary before it can be operated, or queries whether MT requires a password or not before it can be operated. The password may be (U)SIM PIN, (U)SIM PUK, PH-SIM PIN, etc. AT+CPIN Enter PIN Test Command AT+CPIN=? Read Command AT+CPIN? Response OK Response MT returns an alphanumeric string indicating whether or not a password is required. +CPIN: EG512R&EM1x0R_Series_AT_Commands_Manual 46 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Write Command AT+CPIN=[,] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK If there is any error related to MT functionality: +CME ERROR: Response MT stores a password, such as (U)SIM PIN, (U)SIM PUK, which is necessary before it can be operated. If the PIN is to be entered twice, the MT shall automatically repeat the PIN. If no PIN request is pending, no action will be taken and an error message +CME ERROR is returned to TE. If the PIN required is (U)SIM PUK or (U)SIM PUK2, the second parameter is required. This second PIN replaces the old pin in the (U)SIM. OK 5 s The command takes effect immediately. The configuration will be saved automatically. Parameter String without double quotes. READY MT is not pending for any password SIM PIN MT is waiting for (U)SIM PIN to be given SIM PUK MT is waiting for (U)SIM PUK to be given SIM PIN2 MT is waiting for (U)SIM PIN2 to be given SIM PUK2 MT is waiting for (U)SIM PUK2 to be given PH-NET PIN MT is waiting for network personalization password to be given PH-NET PUK MT is waiting for network personalization unlocking password to be given PH-NETSUB PIN MT is waiting for network subset personalization password to be given PH-NETSUB PUK MT is waiting for network subset personalization unlocking password to be given PH-SP PIN MT is waiting for service provider personalization password to be given PH-SP PUK MT is waiting for service provider personalization unlocking password to be given PH-CORP PIN MT is waiting for corporate personalization password to be given PH-CORP PUK MT is waiting for corporate personalization unlocking password to be EG512R&EM1x0R_Series_AT_Commands_Manual 47 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual given String type. Password. If the requested password was a PUK, such as (U)SIM PUK1, PH-FSIM PUK or another password, then must be followed by . String type. New password required if the requested code was a PUK. Error codes. For more details, please refer to Table 11. Example //Enter PIN AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Enter PUK and PIN AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Waiting (U)SIM PIN to be given. //Enter PIN. //PIN has already been entered. //Waiting (U)SIM PIN to be given. //Enter PUK and the new password. //PUK has already been entered. EG512R&EM1x0R_Series_AT_Commands_Manual 48 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 4.5. AT+CSIM Generic (U)SIM Access This command allows a direct control of the (U)SIM that is inserted in the currently selected card slot by a distant application on TE. TE should then keep the processing of (U)SIM information within the frame specified by GSM/UMTS. AT+CSIM Generic (U)SIM Access Test Command AT+CSIM=? Write Command AT+CSIM=, Response OK Response +CSIM: , OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. String length of or . String type in hexadecimal format. Command transferred by the MT to the (U)SIM in the format as described in 3GPP TS 51.011 [28]. Response to the command transferred by the (U)SIM to the MT in the format as described in 3GPP TS 51.011 [28]. Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 49 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 4.6. AT+CRSM Restricted (U)SIM Access This command offers easy and limited access to the (U)SIM database. It transmits the (U)SIM command and its required parameters to MT. AT+CRSM Restricted (U)SIM Access Test Command AT+CRSM=? Write Command AT+CRSM=[,[,,,[,][,]]] Response OK Response +CRSM: ,[,] OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter , , Integer type. (U)SIM command number. 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS 203 RETRIEVE DATA 219 SET DATA Integer type. Identifier for an elementary data file on (U)SIM, if used by . Parameters transferred by the MT to the (U)SIM. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in 3GPP TS 51.011 [28]. Information which should be written to the (U)SIM (hexadecimal character format; refer to AT+CSCS). The directory path of an elementary file on a SIM/UICC in hexadecimal EG512R&EM1x0R_Series_AT_Commands_Manual 50 / 227 , LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual format. Integer type. Information from the (U)SIM about the execution of the actual command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command. Response of a successful completion of the command previously issued (hexadecimal character format; refer to AT+CSCS). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. The information includes the type of file and its size (see 3GPP TS 51.011 [28]). After READ BINARY, READ RECORD or RETRIEVE DATA command, the requested data will be returned. is not returned after a successful UPDATE BINARY, UPDATE RECORD or SET DATA command. Error codes. For more details, please refer to Table 11. 4.7. AT+QPINC Display PIN Remainder Counter This command queries the number of attempts left to enter the password of (U)SIM PIN/PUK. AT+QPINC Display PIN Remainder Counter Test Command AT+QPINC=? Response +QPINC: (list of supported s) Read Command AT+QPINC? OK Response +QPINC: 'SC',, +QPINC: 'P2',, Write Command AT+QPINC= OK Response +QPINC: ,, OK Or ERROR Maximum Response Time Characteristics If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. EG512R&EM1x0R_Series_AT_Commands_Manual 51 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. 'SC' (U)SIM PIN 'P2' (U)SIM PIN2 Integer type. Number of attempts left to enter the password of PIN. Integer type. Number of attempts left to enter the password of PUK. Error codes. For more details, please refer to Table 11. Example AT+QPINC? +QPINC: 'SC',3,10 +QPINC: 'P2',3,10 OK AT+QPINC='SC' +QPINC: 'SC',3,10 OK 4.8. AT+QINISTAT Query Initialization Status of (U)SIM Card This command queries the initialization status of (U)SIM card. AT+QINISTAT Query Initialization Status of (U)SIM Card Test Command AT+QINISTAT=? Response +QINISTAT: (range of supported s) Execution Command AT+QINISTAT OK Response +QINISTAT: Maximum Response Time Characteristics OK 300 ms / Parameter Integer type. Initialization status of (U)SIM card. Actual value is the sum of several of the EG512R&EM1x0R_Series_AT_Commands_Manual 52 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual following four kinds (e.g. 7 = 1 + 2 + 4 means CPIN READY + SMS DONE + PB DONE). 0 Initial state 1 CPIN READY. Operation like locking/unlocking PIN is allowed. 2 SMS DONE. SMS initialization completed 4 PB DONE. Phonebook initialization completed Example AT+QINISTAT +QINISTAT: 7 OK //Status is CPIN READY, SMS DONE and PB DONE 4.9. AT+QSIMDET (U)SIM Card Detection This command enables (U)SIM card hot-swap function. (U)SIM card is detected by GPIO interrupt. The level of (U)SIM card detection pin should also be set when the (U)SIM card is inserted. AT+QSIMDET (U)SIM Card Detection Test Command AT+QSIMDET=? Response +QSIMDET: (list of supported s),(list of supported s) Read Command AT+QSIMDET? OK Response +QSIMDET: , Write Command AT+QSIMDET=, OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Enable or disable (U)SIM card detection. 0 Disable 1 Enable EG512R&EM1x0R_Series_AT_Commands_Manual 53 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Integer type. The level of (U)SIM detection pin when a (U)SIM card is inserted. 0 Low level 1 High level NOTES 1. For EM120R-GL and EM160R-GL modules, the default of is 1; for EG512R-EA module, the default of is 0. 2. Hot-swap function is invalid if the configured value of is inconsistent with hardware design. Example AT+QSIMDET=1,1 OK //Remove (U)SIM card +CPIN: NOT READY +CPIN: READY //Set (U)SIM card detection pin level to high when (U)SIM card is inserted. 4.10. AT+QSIMSTAT (U)SIM Card Insertion Status Report This command queries (U)SIM card insertion status or determines whether (U)SIM card insertion status report is enabled. AT+QSIMSTAT (U)SIM Card Insertion Status Report Test Command AT+QSIMSTAT=? Response +QSIMSTAT: (list of supported s) Read Command AT+QSIMSTAT? OK Response +QSIMSTAT: , Write Command AT+QSIMSTAT= Maximum Response Time OK Response OK Or ERROR 300 ms EG512R&EM1x0R_Series_AT_Commands_Manual 54 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Characteristics The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Enable or disable (U)SIM inserted status report. If it is enabled, the URC +QSIMSTAT: , will be reported when (U)SIM card is inserted or removed. 0 Disable 1 Enable Integer type. Inserted or removed status of the (U)SIM card. This parameter is not allowed to be set. 0 Removed 1 Inserted 2 Unknown (before (U)SIM initialization) Example AT+QSIMSTAT? +QSIMSTAT: 0,1 //Query (U)SIM card insertion status. OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 //Enable reporting of (U)SIM card insertion status. OK +QSIMSTAT : 1,0 //Report of (U)SIM card insertion status: removed. +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK +QSIMSTAT : 1,1 //Report of (U)SIM card insertion status: inserted. +CPIN: READY EG512R&EM1x0R_Series_AT_Commands_Manual 55 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 4.11. AT+QUIMSLOT Switch (U)SIM Slot This command queries the slot currently used by the (U)SIM and configure which to use. AT+QUIMSLOT Switch (U)SIM Slot Test Command AT+QUIMSLOT=? Response +QUIMSLOT: (list of supported s) Read Command AT+QUIMSLOT? OK Response +QUIMSLOT: Write Command AT+QUIMSLOT= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Physical (U)SIM slot. 1 (U)SIM slot 1 2 (U)SIM slot 2 Example AT+QUIMSLOT? +QUSIMSLOT: 1 OK AT+QUIMSLOT=2 OK //Query the (U)SIM slot currently used. //Switch to (U)SIM slot 2. EG512R&EM1x0R_Series_AT_Commands_Manual 56 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 5 Network Service Commands 5.1. AT+COPS PLMN Selection This command returns the current operators and their status, and allows automatic or manual network selection. The Test Command returns a set of five parameters, each representing an operator presenting in the network. The set consists of an integer indicating the availability of the operator , long and short alphanumeric format of the name of the operator, numeric format representation of the operator and access technology. Any of the formats may be unavailable and should then be an empty field. The list of operators shall be in the order of: home network, networks referenced in (U)SIM and other networks. The Read Command returns the current mode and the currently selected operator. If no operator is selected, , and are omitted. The Write Command forces an attempt to select and register the GSM/UMTS/LTE network operator. If the selected operator is not available, no other operator shall be selected (except =4). The format of selected operator name shall apply to further Read Commands (AT+COPS?). AT+COPS PLMN Selection Test Command AT+COPS=? Response +COPS: [list of supported (,long alphanumeric ,short alphanumeric ,numeric [,])s][,,(range of supported s),(range of supported s)] OK Read Command AT+COPS? If there is any error related to MT functionality: +CME ERROR: Response +COPS: [,[,][,]] OK If there is any error related to MT functionality: +CME ERROR: EG512R&EM1x0R_Series_AT_Commands_Manual 57 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Write Command AT+COPS=[,[,[,]]] Response OK If there is any error related to MT functionality: +CME ERROR: Maximum Response Time 180 s, determined by the network. Characteristics / Reference 3GPP TS 27.007 Parameter Integer type. Availability of operators. 0 Unknown 1 Operator available 2 Current operator 3 Operator forbidden String type. Operator in format as per . Integer type. 0 Automatic operator selection ( field is ignored). 1 Manual operator selection ( field shall be present and optionally) 2 Deregister from network 3 Set only (for the read command AT+COPS?), and do not attempt registration/deregistration ( and fields are ignored). This value is not applicable in the read command response. 4 Manual/automatic selection ( field shall be presented). If manual selection fails, automatic mode (=0) will be entered Integer type. 0 Long format alphanumeric which can be up to 16 characters long 1 Short format alphanumeric 2 Numeric . GSM location area identification number Integer type. Access technology selected. Values 4, 5, 6 occur only in the response of Read Command while MS is in data service state and is not intended for the AT+COPS Write Command. 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 58 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Example AT+COPS=? //List all current network operators. +COPS: (1,'CHN-UNICOM','UNICOM','46001',2),(2,'CHN-UNICOM','UNICOM','46001',7),(3,'460 11','46011','46011',7),(3,'CHINA MOBILE','CMCC','46000',7),,(0-4),(0-2) OK AT+COPS? +COPS: 0,0,'CHN-UNICOM',7 //Query the currently selected network operator. OK 5.2. AT+CREG Network Registration Status The Read Command returns the network registration status and returns the status of result code presentation and an integer which shows whether the network has currently indicated the registration of MT. Location information parameters and are returned only when =2 and MT is registered on the network. The Write Command sets whether to present URC or not and controls the presentation of an unsolicited result code +CREG: when =1 and there is a change in the MT network registration status. AT+CREG Network Registration Status Test Command AT+CREG=? Response +CREG: (range of supported s) Read Command AT+CREG? OK Response +CREG: ,[,,[,]] OK Write Command AT+CREG=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: Response OK 300 ms The command takes effect immediately. The configuration will be saved by executing AT&W after this command is issued. EG512R&EM1x0R_Series_AT_Commands_Manual 59 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter Integer type. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code: +CREG: 2 Enable network registration unsolicited result code with location information: +CREG: [,,[,]] Integer type. Circuit mode registration status. 0 Not registered. MT is not currently searching a new operator to register to 1 Registered, home network 2 Not registered, but MT is currently searching a new operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two-byte location area code (when indicates value 2 to 6), or tracking area code (when indicates value 7) in hexadecimal format. String type. Four-byte GERAN/UTRAN/E-UTRAN cell ID in hexadecimal format. Integer type. Access technology of the serving cell. 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN Error codes. For more details, please refer to Table 11. Example AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'D509','80D413D',7 //URC reports that MT has registered on network. //Activate extended URC mode. //URC reports that operator has found location area code and cell ID. 5.3. AT+CSQ Signal Quality Report This command indicates the received signal strength and the channel bit error rate . The Test Command returns values supported by MT. EG512R&EM1x0R_Series_AT_Commands_Manual 60 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual The Execution Command returns received signal strength indication and channel bit error rate from MT. AT+CSQ Signal Quality Report Test Command AT+CSQ=? Response +CSQ: (list of supported s),(list of supported s) Execution Command AT+CSQ OK Response +CSQ: , OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. Received signal strength indication. 0 -113 dBm or less 1 -111 dBm 2–30 -109 dBm to -53 dBm 31 -51 dBm or greater 99 Not known or not detectable Integer type. Channel bit error rate (in percent). 0–7 As RxQual values in the table in 3GPP TS 45.008 subclause 8.2.4 99 Not known or not detectable Error codes. For more details, please refer to Table 11. Example AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,99 //The current signal strength indication is -57 dBm and channel bit error rate is not known or not detectable. EG512R&EM1x0R_Series_AT_Commands_Manual 61 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK NOTE After using network related commands such as AT+CCWA and AT+CCFC, it is recommended to wait for 3s before entering AT+CSQ so as to ensure that any network access required for the preceding command has been finished. 5.4. AT+CPOL Preferred Operator List This command edits and queries the list of preferred operators. AT+CPOL Preferred Operator List Test Command AT+CPOL=? Response +CPOL: (list of supported s),(range of supported s) Read Command AT+CPOL? OK Response Query the list of preferred operators: +CPOL: ,,[,,,,] [+CPOL: ,,[,,,,] […]] Write Command AT+CPOL=[,[,[,,,]]] OK Response Edit the list of preferred operators: OK Or ERROR If there is any error related to MT functionality: +CME ERROR: Maximum Response Time Characteristics If the is given but the is omitted, the entry will be deleted. 300 ms / EG512R&EM1x0R_Series_AT_Commands_Manual 62 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Reference 3GPP TS 27.007 Parameter Integer type. The order number of operators in the (U)SIM preferred operator list. Integer type. 0 Long format alphanumeric 1 Short format alphanumeric 2 Numeric String type. indicates the format is alphanumeric or numeric (see AT+COPS) Integer type. GSM access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. GSM compact access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. UTRAN access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. E-UTRAN access technology. 0 Access technology is not selected 1 Access technology is selected Error codes. For more details, please refer to Table 11. NOTE The access technology selection parameters , , and are required for (U)SIM cards or UICC’s containing PLMN selector with access technology. 5.5. AT+COPN Read Operator Names This command returns the list of the supported operator names from MT. Each operator code that has an alphanumeric equivalent in the MT memory is returned. AT+COPN Read Operator Names Test Command AT+COPN=? Response OK EG512R&EM1x0R_Series_AT_Commands_Manual 63 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Execution Command AT+COPN Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response +COPN: , [+COPN: , […]] OK If there is error related to MT functionality: +CME ERROR: Depends on the number of operator names. / Parameter String type. Operator names in numeric format (see AT+COPS). String type. Operator names in long alphanumeric format (see AT+COPS). Error codes. For more details, please refer to Table 11. 5.6. AT+CTZU Automatic Time Zone Update This command enables/disables automatic time zone update via NITZ. AT+CTZU Automatic Time Zone Update Test Command AT+CTZU=? Response +CTZU: (list of supported s) Write Command AT+CTZU= Read Command AT+CTZU? OK Response OK Or ERROR Response +CTZU: Maximum Response Time Characteristics OK 300 ms The command takes effect immediately. EG512R&EM1x0R_Series_AT_Commands_Manual 64 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Reference 3GPP TS 27.007 The configurations will be saved automatically. Parameter Integer type, indicating the mode of automatic time zone update. 0 Disable automatic time zone update via NITZ 1 Enable automatic time zone update via NITZ Example AT+CTZU? +CTZU: 0 OK AT+CTZU=? +CTZU: (0,1) OK AT+CTZU=1 OK AT+CTZU? +CTZU: 1 OK //Read command //Test command //Enable automatic time zone update 5.7. AT+CTZR Time Zone Reporting This command controls the reporting of time zone change event. If reporting is enabled, the MT returns the unsolicited result code +CTZV: or +CTZE: ,, whenever the time zone is changed. AT+CTZR Time Zone Reporting Test Command AT+CTZR=? Response +CTZR: (range of supported s) Write Command AT+CTZR= OK Response OK Or EG512R&EM1x0R_Series_AT_Commands_Manual 65 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Read Command AT+CTZR? Maximum Response Time Characteristics Reference 3GPP TS 27.007 ERROR Response +CTZR: OK 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type, indicating the mode of time zone reporting. 0 Disable time zone change event reporting 1 Enable time zone change event reporting by unsolicited result code: +CTZV: 2 Enable extended time zone and local time reporting by unsolicited result code: +CTZE: ,, String type, representing the sum of the local time zone (difference between the local time and GMT is expressed in quarters of an hour) plus daylight saving time. The format is '±zz', expressed as a fixed width, two-digit integer with the range -48 to +56. To maintain a fixed width, numbers in the range -9 to +9 are expressed with a leading zero, e.g. '-09', '+00' and '+09'. Integer type, indicating whether includes daylight savings adjustment. 0 includes no adjustment for Daylight Saving Time 1 includes +1 hour (equals 4 quarters in ) adjustment for daylight saving time 2 includes +2 hours (equals 8 quarters in ) adjustment for daylight saving time String type, representing the local time. The format is 'YYYY/MM/DD,hh:mm:ss', expressed as integers representing year (YYYY), month (MM), date (DD), hour (hh), minute (mm) and second (ss). The local time can be derived by the MT from information provided by the network when delivering time zone information and will be presented in the unsolicited result code of extended time zone and local time reporting if the universal time is provided by the network. Example AT+CTZR=2 OK AT+CTZR? +CTZR: 2 EG512R&EM1x0R_Series_AT_Commands_Manual 66 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK +CTZE: '+32',0,'2018/03/23,06:51:13' //Extended time zone and local time reporting by URC 5.8. AT+QLTS Obtain the Latest Time Synchronized through Network The Execution Command returns the latest time that has been synchronized through network. AT+QLTS Obtain the Latest Time Synchronized through Network Test Command AT+QLTS=? Response +QLTS: (range of supported s) Execution Command AT+QLTS OK Response +QLTS: , Write Command AT+QLTS= OK Response +QLTS: , OK Or ERROR Maximum Response Time Characteristics If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. Query network time mode. 0 Query the latest time that has been synchronized through network 1 Query the current GMT time calculated from the latest time that has been synchronized through network 2 Query the current LOCAL time calculated from the latest time that has been synchronized through network Format is 'yy/MM/dd,hh:mm:ss±zz', in which characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range: -48 to +48). E.g. 6th of May EG512R&EM1x0R_Series_AT_Commands_Manual 67 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2004, 22:10:00 GMT+2 hours equals '04/05/06,22:10:00+08'. Integer type. Daylight saving time. 0 No adjustment 1 Plus one hour 2 Plus two hours Error codes. For more details, please refer to Table 11. NOTE If the time has not been synchronized through network, the command will return a null time string: +QLTS: ''. Example AT+QLTS=? +QLTS: (0-2) //Query supported network time modes. OK AT+QLTS //Query the latest time synchronized through network. +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=0 //Query the latest time synchronized through network. It offers the same function as Execution Command AT+QLTS. +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=1 //Query the current GMT time calculated from the latest time that has been synchronized through network. +QLTS: '2017/01/13,03:41:22+32,0' OK AT+QLTS=2 //Query the current LOCAL time calculated from the latest time that has been synchronized through network. +QLTS: '2017/01/13,11:41:23+32,0' OK EG512R&EM1x0R_Series_AT_Commands_Manual 68 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 5.9. AT+QNWINFO Query Network Information This command queries network information such as the selected access technology, operator and band. AT+QNWINFO Query Network Information Test Command AT+QNWINFO=? Execution Command AT+QNWINFO Response OK Response +QNWINFO: ,,, Maximum Response Time Characteristics OK 300 ms / Parameter String type. Selected access technology. 'NONE' 'WCDMA' 'HSDPA' 'HSUPA' 'HSPA+' 'TDD LTE' 'FDD LTE' Operator names in numeric format. String type. Selected band. 'WCDMA 2100' 'WCDMA 1900' 'WCDMA 1800' 'WCDMA 1700 US' 'WCDMA 850' 'WCDMA 800' 'WCDMA 2600' 'WCDMA 900' 'WCDMA 1700 JAPAN' 'WCDMA 1500' 'WCDMA 850 JAPAN' 'LTE BAND 1'–'LTE BAND 66' Channel ID. EG512R&EM1x0R_Series_AT_Commands_Manual 69 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual NOTE If the devices have not been registered on a network, the command will return +QNWINFO: No Service. Example AT+QNWINFO=? OK AT+QNWINFO +QNWINFO: 'FDD LTE',46001,'LTE BAND 3',1650 OK 5.10. AT+QSPN Query the Service Provider Name This command queries the service provider name. AT+QSPN Query the Service Provider Name Test Command AT+QSPN=? Execution Command AT+QSPN Response OK Response +QSPN: ,,,, OK Characteristics / Parameter String type. Full name of the network. String type. Shortened name of the network. String type. Service provider name. Integer type. Alphabet of full and shortened network name. 0 GSM 7-bit default alphabet 1 UCS2 String type. Registered PLMN. NOTES 1. If is 0, and will be shown in GSM 7-bit default alphabet string. 2. If is 1, and will be shown in UCS2 hexadecimal string. EG512R&EM1x0R_Series_AT_Commands_Manual 70 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Example AT+QSPN //Query the service provider name. +QSPN: 'CHN-UNICOM','UNICOM','',0,'46001' OK 5.11. AT+QENG Query Primary Serving Cell and Neighbour Cell Information This command obtains the network information, such as serving cell and neighbour cells. AT+QENG Query Primary Serving Cell and Neighbour Cell Information Test Command AT+QENG=? Response +QENG: (list of supported s) Write Command Query the serving cell information AT+QENG='servingcell' OK Response In LTE mode: +QENG: 'servingcell',,'LTE',,,< MNC>,,,,,,,,,,,,,, In WCDMA mode: +QENG: 'servingcell',,'WCDMA',,,,,,,,,,,,,, Write Command Query the information of neighbour cells AT+QENG='neighbourcell' OK Response In LTE mode: [+QENG: 'neighbourcell intra','LTE',,,< RSRQ>,,,,,,,, …] [+QENG: 'neighbourcell inter','LTE',,,< RSRQ>,,,,,,, …] EG512R&EM1x0R_Series_AT_Commands_Manual 71 / 227 Maximum Response Time Characteristics LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual [+QENG:'neighbourcell','WCDMA',,,,,,, …] In WCDMA mode: [+QENG:'neighbourcell','WCDMA',,, ,,,,, …] [+QENG: 'neighbourcell','LTE',,,,, …] OK 300 ms / Parameter String type. The information of different cells. 'servingcell' The information of 3G/4G serving cells 'neighbourcell' The information of 3G/4G neighbor cells String type. UE state. 'SEARCH' UE is searching but could not (yet) find a suitable 3G/4G cell. 'LIMSRV' UE is camping on a cell but has not registered on the network. 'NOCONN' UE is camping on a cell and has registered on the network, and it is in idle mode. 'CONNECT' UE is camping on a cell and has registered on the network, and a call is in progress. String type. The LTE network mode. 'TDD' 'FDD' Integer type. Mobile Country Code (first part of the PLMN code) - Invalid Number format. Mobile Network Code (second part of the PLMN code) - Invalid Integer type. Location Area Code. The parameter determines the two bytes location area code in hexadecimal format (e.g. 00C1 equals 193 in decimal) of the cell that was scanned. Range: 0–65535. - Cannot get the invalid value Integer type. Cell ID. The parameter determines the 16-bit (GSM) or 28-bit (UMTS) cell ID. Range: 0–0xFFFFFFF. - Invalid EG512R&EM1x0R_Series_AT_Commands_Manual 72 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Integer type. Physical cell ID. Integer type. The parameter determines the UTRA-ARFCN of the cell that was scanned. Integer type. The parameter determines the E-UTRA-ARFCN of the cell that was scanned. E-UTRA frequency band (see 3GPP 36.101) Integer type. UL bandwidth. 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz Integer type. DL bandwidth. 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz Tracking Area Code (see 3GPP 23.003 Section 19.4.2.3) The parameter indicates the primary scrambling code of the cell that was scanned Integer type. Routing Area Code. Range: 0–255. Integer type. The parameter indicates the Received Signal Code Power level of the cell that was scanned. Carrier to noise ratio in dB = measured Ec/Io value in dB. Integer type. Indicates the signal of LTE Reference Signal Received Power (see 3GPP 36.214). Range: -140 to -44. Unit: dBm. The closer to -44, the better the signal is. The closer to -140, the worse the signal is. Integer type. Indicates the signal of current LTE Reference Signal Received Quality (see 3GPP 36.214). Range: -20 to -3. Unit: dB. The closer to -3, the better the signal is. The closer to -20, the worse the signal is. Integer type. LTE Received Signal Strength Indication. Integer type. LTE Signal-to-Interface plus Noise Ratio. The conversion formula for actual SINR is Y = (1/5) × X × 10 - 20 (X is the value queried by AT+QENG and Y is the actual value of LTE SINR after calculating with the formula). Range: -20 to 30. Unit: dB. Integer type. Channel Quality Indication. Range: 1–30. TX power value in 1/10 dBm. It is the maximum of all UL channel TX power. The value is only meaningful when the device is in traffic. Integer type. Physical channel. 0 DPCH 1 FDPCH EG512R&EM1x0R_Series_AT_Commands_Manual 73 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Integer type. Spreading factor. 0 SF_4 1 SF_8 2 SF_16 3 SF_32 4 SF_64 5 SF_128 6 SF_256 7 SF_512 8 UNKNOWN Integer type. 0–16: slot format for DPCH. 0–9: slot format for FDPCH. Integer type. Destination number on which call is to be deflected. Integer type. Number format. Compress mode. 0 Not support compress mode 1 Support compress mode Integer type. Receiver automatic gain control on the camped frequency. Integer type. Carrier to noise ratio in dB = measured Ec/Io value in dB. Integer type. 3G neighbor cell set. 1 Active set 2 Synchronous neighbor set 3 Asynchronous neighbor set Integer type. Rank of this cell as neighbor for inter-RAT cell reselection. Integer type. Suitable receive level for inter frequency cell. Integer type. To be considered for re-selection. The suitable receive level value of an evaluated lower priority cell must be greater than this value. Integer type. To be considered for re-selection. The suitable receive level value of an evaluated higher priority cell must be greater than this value. Integer type. Reselection threshold for high priority layers. Integer type. Reselection threshold for low priority layers. Integer type. Absolute power level of the common pilot channel as received by the UE in dBm × 10. Integer type. Ratio of the received energy per PN chip for the common pilot channel to the total received power spectral density at the UE antenna connector in dB × 10. Integer type. Select receive level value for base station in dB (see 3GPP 25.304). Integer type. Cell reselection priority. Range: 0–7. Integer type. Threshold to control non-intra frequency searches. Integer type. Specifies the suitable receive level threshold (in dB) used by the UE on the serving cell when reselecting towards a lower priority RAT/frequency. Integer type. Cell selection parameter for the intra frequency cell. EG512R&EM1x0R_Series_AT_Commands_Manual 74 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Example AT +QENG='servingcell' +QENG: 'servingcell','NOCONN','LTE','FDD',460,00,81EF7D0,78,1300,3,5,5,1806,-68,-8,-38,15 OK AT +QENG='neighbourcell' +QENG: 'neighbourcell intra','LTE',38950,276,-3,-88,-65,0,37,7,16,6,44 +QENG: 'neighbourcell inter','LTE',39148,-,-,-,-,-,37,0,30,7,-,-,-,+QENG: 'neighbourcell inter','LTE',37900,-,-,-,-,-,0,0,30,6,-,-,-,- OK NOTE '-' or - indicates the parameter is invalid under current condition. 5.12. AT+QCAINFO Query Carrier Aggregation Parameters This command queries carrier aggregation parameters. PCC and SCC respectively indicate Primary Carrier Component and Secondary Carrier Component. AT+QCAINFO Query Carrier Aggregation Parameters Test Command AT+QCAINFO=? Execution Command AT+QCAINFO Response OK Response +QCAINFO: 'PCC',,,,,,,,, +QCAINFO: 'SCC',,,,,,,,, [+QCAINFO: 'SCC',,,,,,,,, […]] OK Maximum Response Time If no secondary cell was active: OK 300 ms EG512R&EM1x0R_Series_AT_Commands_Manual 75 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Characteristics / Parameter EARFCN. Integer type. Bandwidth. 6 1.4 MHz 15 3 MHz 25 5 MHz 50 10 MHz 75 15 MHz 100 20 MHz String type. DL Band information. 'LTE BAND 1' 'LTE BAND 2' 'LTE BAND 3' … 'LTE BAND 66' Integer type. Primary cell state. 0 No serving 1 Registered Integer type. Secondary cell state. 0 Deconfigured 1 Configuration deactivated 2 Configuration activated Integer type. Physical Cell ID. Integer type. Reference Signal Received Power (see 3GPP 36.214) Integer type. Reference Signal Received Quality (see 3GPP 36.214) Integer type. Received Signal Strength Indication. Integer type. Logarithmic value of SINR. Values are in 1/5th of a dB. Range: 0–250 (-20 to +30 dB). 5.13. AT+QNWPREFCFG Configure Network Searching Preferences This command configures the network searching preferences. AT+QNWPREFCFG Configure Network Searching Preferences Test Command AT+QNWPREFCFG=? Response +QNWPREFCFG: 'gw_band',(list of supported s) +QNWPREFCFG: 'lte_band',(list of supported s) +QNWPREFCFG: 'mode_pref',(list of supported s) +QNWPREFCFG: 'srv_domain',(range of supported s) +QNWPREFCFG: 'voice_domain',(range of supported s) +QNWPREFCFG: 'roam_pref',(list of supported s) +QNWPREFCFG: 'ue_usage_setting',(list of supported s) +QNWPREFCFG: 'policy_band' +QNWPREFCFG: 'ue_capability_band' +QNWPREFCFG: 'rat_acq_order',(list of supported s) OK 300 ms / 5.13.1. AT+QNWPREFCFG='gw_band' WCDMA Band Configuration This command specifies the preferred WCDMA bands to be searched by UE. AT+QNWPREFCFG='gw_band' WCDMA Band Configuration Write Command AT+QNWPREFCFG='gw_band'[,] Response If the optional parameter is omitted, return current configuration: +QNWPREFCFG: 'gw_band', Maximum Response Time Characteristics OK If the optional parameter is specified, configure the preferred WCDMA bands to be searched: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. EG512R&EM1x0R_Series_AT_Commands_Manual 77 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. Use the colon as a separator to list the WCDMA Bands to be configured. The parameter format is B1:B2:…:BN. The module supports the following WCDMA Bands： B1 WCDMA 2100 band B2 WCDMA 1900 band B3 WCDMA 1800 band B4 WCDMA 1700 band B5 WCDMA 850 band B6 WCDMA 800 band B7 WCDMA 2600 band B8 WCDMA 900 band B9 WCDMA Japan 1700 band B11 WCDMA 1500 band B19 WCDMA Japan 850 band Example AT+QNWPREFCFG='gw_band' //Query the currently configured WCDMA bands of the UE. +QNWPREFCFG: 'gw_band',1:2:3:4:5:6:7:8:9:19 OK AT+QNWPREFCFG='gw_band',1:2 OK //Set WCDMA B1 and WCDMA B2. 5.13.2. AT+QNWPREFCFG='lte_band' LTE Band Configuration This command specifies the preferred LTE bands to be searched by UE. AT+QNWPREFCFG='lte_band' LTE Band Configuration Write Command AT+QNWPREFCFG='lte_band'[,] Response If the optional parameter is omitted, return current configuration: +QNWPREFCFG: 'lte_band', Maximum Response Time Characteristics OK If the optional parameter is specified, configure the preferred LTE bands to be searched: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. EG512R&EM1x0R_Series_AT_Commands_Manual 78 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. Use the colon as a separator to list the LTE Bands to be configured. The parameter format is B1:B2:…:BN. NOTE The LTE Band range supported by the module is: N1–N14, N17–N21, N23–N43, N46–N49, N66–N68, N71, N125–N127, N250, N252, N255. Example AT+QNWPREFCFG='lte_band' //Query the currently configured LTE bands of the UE. +QNWPREFCFG: 'lte_band',1:2:3:4:5:7:8:12:13:14:17:18:19:20:25:26:28:29:30:32:34:38:39:40:41: 42:66:71 OK AT+QNWPREFCFG='lte_band',1:2 OK //Set LTE N1 and LTE N2. 5.13.3. AT+QNWPREFCFG='mode_pref' Network Search Mode Configuration This command specifies the network search mode. AT+QNWPREFCFG='mdoe_pref' Network Search Mode Configuration Write Command AT+QNWPREFCFG='mode_pref'[,] Response If the optional parameter is omitted, return the current configuration: +QNWPREFCFG: 'mode_pref', Maximum Response Time Characteristics OK If the optional parameter is specified, configure the network search mode: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter String type. Use the colon as a separator to list the RATs to be configured. The EG512R&EM1x0R_Series_AT_Commands_Manual 79 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual parameter format is: RAT1:RAT2:…RATN. The RATs supported by the module are as follows: AUTO WCDMA & LTE WCDMA WCDMA only LTE LTE only Example AT+QNWPREFCFG='mode_pref' +QNWPREFCFG: 'mode_pref',AUTO OK AT+QNWPREFCFG='mode_pref',LTE OK //Query the current configuration. //Set RAT to LTE only. 5.13.4. AT+QNWPREFCFG='srv_domain' Service Domain Configuration This command specifies the registered service domain. AT+QNWPREFCFG='srv_domain' Service Domain Configuration Write Command AT+QNWPREFCFG='srv_domain'[,] Response If the optional parameter is omitted, return current configuration: +QNWPREFCFG: 'srv_domain', Maximum Response Time Characteristics OK If the optional parameter is specified, configure the service domain of UE: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Service domain of UE. 0 CS only 1 PS only 2 CS & PS EG512R&EM1x0R_Series_AT_Commands_Manual 80 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Example AT+QNWPREFCFG='srv_domain' +QNWPREFCFG: 'srv_domain',2 OK AT+QNWPREFCFG='srv_domain',1 OK //Query the current configuration. //Set PS only. 5.13.5. AT+QNWPREFCFG='voice_domain' Voice Domain Configuration This command specifies the voice domain of UE. AT+QNWPREFCFG='voice_domain' Voice Domain Configuration Write Command AT+QNWPREFCFG='voice_domain'[, ] Response If the optional parameter is omitted, return current configuration: +QNWPREFCFG: 'voice_domain', Maximum Response Time Characteristics OK If the optional parameter is specified, configure the voice domain of UE: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Service domain of UE. 0 CS voice only 1 IMS PS voice only 2 CS voice preferred 3 IMS voice preferred Example AT+QNWPREFCFG='voice_domain' +QNWPREFCFG: 'voice_domain',2 OK AT+QNWPREFCFG='voice_domain',3 //Query the current configuration. //Set IMS voice preferred. EG512R&EM1x0R_Series_AT_Commands_Manual 81 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK 5.13.6. AT+QNWPREFCFG='roam_pref' Roaming Preference Configuration This command specifies the roaming preference of UE. AT+QNWPREFCFG='roam_pref' Roaming Preference Configuration Write Command AT+QNWPREFCFG='roam_pref'[,] Response If the optional parameter is omitted, return current configuration: +QNWPREFCFG: 'roam_pref', OK Maximum Response Time Characteristics If the optional parameter is specified, configure the roaming preference of UE: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Roaming preference of UE. 1 Roam only on home networks 3 Roam on affiliate networks 255 Roam on any network Example AT+QNWPREFCFG='roam_pref' +QNWPREFCFG: 'roam_pref',255 OK AT+QNWPREFCFG= 'roam_pref',1 OK //Query the current configuration. //Set Roam Pref Home. EG512R&EM1x0R_Series_AT_Commands_Manual 82 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 5.13.7. AT+QNWPREFCFG='ue_usage_setting' UE Usage Setting Configuration This command specifies the usage setting of UE. AT+QNWPREFCFG='ue_usage_setting' UE Usage Setting Configuration Write Command AT+QNWPREFCFG='ue_usage_settin g'[,] Response If the optional parameter is omitted, return current configuration: +QNWPREFCFG: 'ue_usage_setting', OK Maximum Response Time Characteristics If the optional parameter is specified, configure the usage setting of UE: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Roaming preference of UE. 0 Voice centric 1 Data centric Example AT+QNWPREFCFG='ue_usage_setting' +QNWPREFCFG: 'ue_usage_setting',1 OK AT+QNWPREFCFG='ue_usage_setting',0 OK //Query the current configuration. //Set voice centric. 5.13.8. AT+QNWPREFCFG='policy_band' Policyman Band This command is used to query the band configured in the carrier policy. AT+QNWPREFCFG='policy_band' Policyman Band Write Command AT+QNWPREFCFG='policy_band' Response +QNWPREFCFG: 'gw_band', EG512R&EM1x0R_Series_AT_Commands_Manual 83 / 227 Maximum Response Time Characteristics LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual +QNWPREFCFG: 'lte_band', OK 300 ms / Parameter String type. Colons used as separators to list the WCDMA bands to be configured. The parameter format is B1:B2:…:BN. String type. Colons used as separators to list the LTE bands to be configured. The parameter format is B1:B2:…:BN. NOTE The module supports the following WCDMA bands： B1 WCDMA 2100 band B2 WCDMA 1900 band B3 WCDMA 1800 band B4 WCDMA 1700 band B5 WCDMA 850 band B6 WCDMA 800 band B7 WCDMA 2600 band B8 WCDMA 900 band B9 WCDMA Japan 1700 band B11 WCDMA 1500 band B19 WCDMA Japan 850 band The LTE band range supported by the module is: N1–N14, N17–N21, N23–N43, N46–N49, N66–N68, N71, N125–N127, N250, N252, N255. Example AT+QNWPREFCFG='policy_band' +QNWPREFCFG: 'gw_band',1:8 +QNWPREFCFG: 'lte_band',1:3:8 OK EG512R&EM1x0R_Series_AT_Commands_Manual 84 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 5.13.9. AT+QNWPREFCFG='ue_capability_band' UE Capability Band This command is used to query the band configured in the UE capability information. AT+QNWPREFCFG='ue_capability_band' UE Capability Band Write Command AT+QNWPREFCFG='ue_capability_ba nd' Response +QNWPREFCFG: 'gw_band', +QNWPREFCFG: 'lte_band', Maximum Response Time Characteristics OK 300 ms / Parameter String type. Colons used as separators to list the WCDMA bands to be configured. The parameter format is B1:B2:…:BN. String type. Colons as separators to list the LTE bands to be configured. The parameter format is B1:B2:…:BN. NOTE The module supports the following WCDMA bands: B1 WCDMA 2100 band B2 WCDMA 1900 band B3 WCDMA 1800 band B4 WCDMA 1700 band B5 WCDMA 850 band B6 WCDMA 800 band B7 WCDMA 2600 band B8 WCDMA 900 band B9 WCDMA Japan 1700 band B11 WCDMA 1500 band B19 WCDMA Japan 850 band The LTE band range supported by the module is: N1–N14, N17–N21, N23–N43, N46–N49, N66–N68, N71, N125–N127, N250, N252, N255. Example AT+QNWPREFCFG='ue_capability_band' +QNWPREFCFG: 'gw_band',1:8 +QNWPREFCFG: 'lte_band',1:3:8 EG512R&EM1x0R_Series_AT_Commands_Manual 85 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK 5.13.10. AT+QNWPREFCFG='rat_acq_order ' UE RAT Priority This command is used to set network rat priority in the UE capability information. AT+QNWPREFCFG='rat_acq_order' UE RAT Priority Write Command AT+QNWPREFCFG='rat_acq_order'[, ] Response If the parameter is omitted, query the current configuration: +QNWPREFCFG: 'rat_acq_order', Maximum Response Time Characteristics OK If the parameter is specified, configure the network search mode: OK Or ERROR 300 ms / Parameter String type. Colons are used as separators to list the RATs to be configured. The parameter format is: RAT1:RAT2:…RATN. Example AT+QNWPREFCFG= 'rat_acq_order' +QNWPREFCFG: 'rat_acq_order', LTE:WCDMA OK AT+QNWPREFCFG= ' rat_acq_order ',LTE:WCDMA OK AT+CFUN=1,1 AT+QNWPREFCFG= ' rat_acq_order ' +QNWPREFCFG: 'rat_acq_order', LTE: WCDMA OK //Query the current rat order. //Set RAT order priority. //Reset //Query the current RAT order. EG512R&EM1x0R_Series_AT_Commands_Manual 86 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 6 Call Related Commands 6.1. ATA Answer an Incoming Call This command connects the MT to an incoming voice or data call indicated by a RING URC. ATA Answer an Incoming Call Execution Command ATA Response MT sends off-hook to the remote station. In case of data call, if successfully connected: CONNECT And MT switches to data mode. outputs only when is greater than 0 in ATX parameter setting. When MT returns to command mode after call release: OK Response in case of voice call, if successfully connected: OK Maximum Response Time Characteristics Reference V.25ter Response if there is no connection: NO CARRIER 90 s, determined by the network. / NOTES 1. Any additional commands on the same command line are ignored. 2. This command may be aborted generally when the module receives a character during command execution. However, the command will not be aborted during some connection establishments such as handshaking. EG512R&EM1x0R_Series_AT_Commands_Manual 87 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Example RING ##0 AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,1,4,0,0,'02154450290',129 OK ATA OK //A voice call is ringing. //PS call in LTE mode. //Incoming call. //Accept the voice call with ATA. 6.2. ATD Originate a Call This command sets up outgoing voice and data calls. Supplementary services can also be controlled with this command. ATD Originate a Call Execution Command ATD[][;] Response If no dial tone and ATX2 or ATX4 is set: NO DIALTONE If busy and ATX3 or ATX4 is set: BUSYBUSY If a connection cannot be established: NO CARRIER If connection is successful and there is a non-voice call: CONNECT And MT switches to data mode. Note: outputs only when is greater than 0 in ATX parameter setting. When MT returns to command mode after the call release: OK Maximum Response Time Characteristics Reference V.25ter If connection is successful and there is a voice call: OK 5 s, determined by the network. / EG512R&EM1x0R_Series_AT_Commands_Manual 88 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String of dialing digits and optionally V.25ter modifiers. Dialing digits: 0-9, *, #, +, A, B, C Following V.25ter modifiers are ignored: ,(comma), T, P, !, W, @ String of GSM modifiers: I Activate CLIR (Disable presentation of own number to the called party) i Deactivate CLIR (Enable presentation of own number to the called party) G Activate closed user group invocation for this call only g Deactivate closed user group invocation for this call only It is required when setting up voice call, and will return to command state after call. NOTES 1. When being executed, this command may be aborted generally by the module’s receiving of an ATH command or a character. However, the command will not be aborted during some connection establishments such as handshaking. 2. Parameter 'I' and 'i' are only valid when no '*' or '#' code is within the dial string. 3. See ATX command for setting result code and call monitoring parameters. 4. Responses returned after dialing with ATD: For voice call, two different response modes can be determined. MT returns OK immediately either after dialing was completed or after the call was established. The setting is controlled by AT+COLP, of which default is AT+COLP=0 which causes the MT to return OK immediately after the dialing was completed. Otherwise MT will return OK, BUSY, NO DIAL TONE, or NO CARRIER. 5. Using ATD during an active voice call: ⚫ When a user originates a second voice call while there is already an active voice call, the first call will be automatically put on hold. ⚫ The current states of all calls can be easily checked at any time with AT+CLCC. Example ATD10086; OK //Dialing out the party’s number. 6.3. ATH Disconnect Existing Connection This command disconnects data calls or voice calls. AT+CHUP is also used to disconnect the voice call. ATH Disconnect Existing Connection Execution Command ATH[] Response Disconnect existing call by local TE from command line and EG512R&EM1x0R_Series_AT_Commands_Manual 89 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference V.25ter terminate the call. OK 90 s, determined by the network. / Parameter Integer type. 0 Disconnect existing call from command line and terminate the call 6.4. AT+CVHU Voice Hang up Control This command controls whether ATH can be used to disconnect the voice call. AT+CVHU Voice Hang up Control Test Command AT+CVHU=? Response +CVHU: (list of supported s) Read Command AT+CVHU? OK Response +CVHU: Write Command AT+CVHU= Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK Or ERROR 300 ms / Parameter Integer type. 0 ATH can be used to disconnect the voice call EG512R&EM1x0R_Series_AT_Commands_Manual 90 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 1 ATH is ignored with the response OK returned only 6.5. AT+CHUP Hang up Calls This command cancels all voice calls in the state of Active, Waiting and Held. For data disconnections, use ATH. AT+CHUP Hang up Calls Test Command AT+CHUP=? Execution Command AT+CHUP Maximum Response Time Characteristics Reference 3GPP 27.007 Response OK Response OK Or ERROR 90 s, determined by the network. / Example RING ##0 AT+CHUP OK //Incoming call. //Hang up the call. 6.6. ATS0 Set Number of Rings Before Automatic Answering This command controls automatic answering mode for the incoming calls. ATS0 Set Number of Rings Before Automatic Answering Read Command ATS0? Response Write Command ATS0= OK Response This parameter setting determines the number of rings before automatic answering. EG512R&EM1x0R_Series_AT_Commands_Manual 91 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference V.25ter OK If there is any error: ERROR 300 ms / Parameter Integer type. 0 Automatic answering is disabled 1–255 Enable automatic answering on the ring number specified NOTE If is set too high, the calling party may hang up before the call is answered automatically. Example ATS0=3 OK RING ##0 RING ##0 RING ##0 //Set three rings before automatically answering a call. //A call is coming. //Automatically answering the call after three rings. EG512R&EM1x0R_Series_AT_Commands_Manual 92 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 6.7. ATS6 Set Pause Before Blind Dialing This command is implemented for compatibility reasons only, and has no effect. ATS6 Set Pause Before Blind Dialing Read Command ATS6? Response Write Command ATS6= OK Response OK Maximum Response Time Characteristics Reference V.25ter If there is any error: ERROR 300 ms / Parameter Integer type. Number of seconds to wait before blind dialing. Default: 2; Range: 2–10. 6.8. ATS7 Set Time to Wait for Connection Completion This command specifies the duration (unit: second) to wait for the connection completion in case of answering or originating a call. If no connection is established during the time, MT will be disconnected from the line. ATS7 Set Time to Wait for Connection Completion Read Command ATS7? Response Write Command ATS7= OK Response OK If there is any error: EG512R&EM1x0R_Series_AT_Commands_Manual 93 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference V.25ter ERROR 300 ms / Parameter Integer type. The amount of time to wait for the connection completion in case of answering originating a call. Unit: second. 0 Disabled 1–255 The seconds to wait for connection completion 6.9. ATS8 Set the Time to Wait for Comma Dial Modifier This command is implemented for compatibility reasons only, and has no effect. ATS8 Set the Time to Wait for Comma Dial Modifier Read Command ATS8? Response Write Command ATS8= OK Response OK Maximum Response Time Characteristics Reference V.25ter If there is any error: ERROR 300 ms / Parameter Integer type. 0 No pause when comma encountered in dial string 1–2–255 Number of seconds to wait for comma dial modifier EG512R&EM1x0R_Series_AT_Commands_Manual 94 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 6.10. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier This command determines the duration (unit: tenths of a second) during which the UE remains connected in absence of a data carrier. This parameter setting determines the amount of time (unit: tenths of a second) during which the MT will remain connected in absence of a data carrier. If the data carrier is once more detected before disconnection, the MT remains connected. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier Read Command ATS10? Response Write Command ATS10= OK Response OK Maximum Response Time Characteristics Reference V.25ter If there is any error: ERROR 300 ms / Parameter Integer type. 1–15–254 Duration of tenths of seconds to wait before disconnecting after UE has indicated the absence of received line signal 6.11. AT+CSTA Select Type of Address This command selects the type of number for further dialing commands ATD according to 3GPP TS 24.008 [8]. Read Command returns the current value of . AT+CSTA Select Type of Address Test Command AT+CSTA=? Response +CSTA: (list of supported s) EG512R&EM1x0R_Series_AT_Commands_Manual 95 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Read Command AT+CSTA? Write Command AT+CSTA=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response +CSTA: OK Response OK 300 ms / Parameter Integer type. Current address type setting. 129 Unknown type 145 International type (contains the character '+') 6.12. AT+CLCC List Current Calls This command returns the list of all current calls of MT. If the command is executed successfully but no calls existed, no information will be responded but OK will be sent to TE. AT+CLCC List Current Calls Test Command AT+CLCC=? Execution Command AT+CLCC Response OK Response [+CLCC: ,,,,[,,[,]] [+CLCC: ,,,,[,,[,]] [...]] ... OK Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300 ms EG512R&EM1x0R_Series_AT_Commands_Manual 96 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Characteristics / Parameter Integer type. The call identification number, as described in 3GPP TS 22.030 [19] subclause 6.5.5.1. This number can be used in AT+CHLD command operations. Integer type. 0 Mobile originated (MO) call 1 Mobile terminated (MT) call Integer type. State of the call. 0 Active 1 Held 2 Dialing (MO call) 3 Alerting (MO call) 4 Incoming (MT call) 5 Waiting (MT call) Integer type. Bearer/teleservice. 0 Voice 1 Data 2 FAX Integer type. 0 Call is not one of multiparty (conference) call parties 1 Call is one of multiparty (conference) call parties String type. Phone number in format specified by . Type of address octet in integer format (See 3GPP TS 24.008, subclause 10.5.4.7 for details). Usually, it is one of the following three values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type. Alphanumeric representation for corresponding to the entry found in phonebook.. Error codes. For more details, please refer to Table 11. Example ATD10086; OK AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,0,0,0,0,'10086',129 OK //Establish a call. //PS call in LTE mode. //The call is established and active, and the call has been answered. EG512R&EM1x0R_Series_AT_Commands_Manual 97 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 6.13. AT+CR Service Reporting Control The Write command controls whether the MT transmits an intermediate result code +CR: via TA to the TE or not when a call is set up. If it is enabled, the intermediate result code is transmitted at the point during connect negotiation at which the TA has determined which speed and quality of service will be used, before any error control or data compression reports are transmitted, and before the result code CONNECT is transmitted. AT+CR Service Reporting Control Test Command AT+CR=? Response +CR: (list of supported s) Read Command AT+CR? OK Response +CR: Write Command AT+CR=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms / Parameter Integer type. Disable or enable the reporting of intermediate result code +CR: . 0 Disable reporting 1 Enable reporting String type. ASYNC Asynchronous transparent SYNC Synchronous transparent REL ASYNC Asynchronous non-transparent REL SYNC Synchronous non-transparent EG512R&EM1x0R_Series_AT_Commands_Manual 98 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 6.14. AT+CRC Set Cellular Result Codes for Incoming Call Indication The Writer Command controls whether to use the extended format of incoming call indication or not. When enabled, an incoming call is indicated to the TE with unsolicited result code +CRING: instead of the normal RING. AT+CRC Set Cellular Result Codes for Incoming Call Indication Test Command AT+CRC=? Response +CRC: (list of supported s) Read Command AT+CRC? OK Response +CRC: Write Command AT+CRC=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms / Parameter Integer type. Disable or enable the extended format of incoming call URC +CRING: 0 Disable extended format 1 Enable extended format String type. ASYNC Asynchronous transparent SYNC Synchronous transparent REL ASYNC Asynchronous non-transparent REL SYNC Synchronous non-transparent FAX Facsimile VOICE Voice Example AT+CRC=1 OK +CRING: VOICE //Enable extended format. //Indicate incoming call of VOICE type to TE. EG512R&EM1x0R_Series_AT_Commands_Manual 99 / 227 ATH OK AT+CRC=0 OK RING ##0 ATH OK LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //Disable extended format. //Indicate incoming call to TE. 6.15. AT+CRLP Select Radio Link Protocol Parameter The Writer Command selects radio link protocol (RLP) parameters used when non-transparent data calls are originated. AT+CRLP Select Radio Link Protocol Parameter Test Command AT+CRLP=? Response MT returns values supported. RLP (Radio Link Protocol) versions 0 and 1 share the same parameter set. MT returns only one line for this set (during which is not presented). +CRLP: (range of supported s),(range of supported s),(range of supported s),(range of supported s), +CRLP: (range of supported s),(range of supported s),(range of supported s),(range of supported s), +CRLP: (range of supported s),(range of supported s),(range of supported s),(range of supported s), Read Command AT+CRLP? OK Response MT returns current settings for RLP version. RLP versions 0 and 1 share the same parameter set. TA returns only one line for this set (during which is not presented). +CRLP: ,,,, ... OK Write Command Response AT+CRLP=[[,[,[,< TA sets RLP parameters used when non-transparent data calls N2>[,]]]]] are set up. EG512R&EM1x0R_Series_AT_Commands_Manual 100 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS27.007 OK 300 ms / Parameter Integer type. Interworking Window Size (IWF to MS window size). 0–61 Interworking window size 0–240–488 For =2 Integer type. Mobile Window Size (MS to IWF window size). 0–61 Mobile window size 0–240–488 For =2 Integer type. 38–48–255 Acknowledgment timer T1 in a unit of 10 ms 42–52–255 For =2 Integer type. 1–6–255 Retransmission attempts N2 Integer type. RLP version number. 0–2 RLP version 6.16. AT+QECCNUM* Configure Emergency Call Numbers This command queries, adds and deletes ECC (Emergency Call Codes) numbers. There are two kinds of ECC numbers: ECC numbers without (U)SIM and that with (U)SIM. The default ECC numbers without (U)SIM are 911, 112, 00, 08, 110, 999, 118 and 119. The default ECC number with (U)SIM is 911 and 112. 911 and 112 and will always be supported as ECC numbers, and cannot be deleted. ECC numbers can be saved into NVM automatically. If the (U)SIM card contains ECC file, the numbers in ECC file can also be regarded as ECC numbers. The maximal supported ECC numbers of either type is 20. AT+QECCNUM* Configure Emergency Call Numbers Test Command AT+QECCNUM=? Response +QECCNUM: (range of supported s) Write Command OK Response EG512R&EM1x0R_Series_AT_Commands_Manual 101 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual AT+QECCNUM=,[,<ec If is 0, query the ECC numbers. In this case, cnum1>[,,…[,<eccnum should be omitted: N>]]] +QECCNUM: ,,[…] OK Read Command AT+QECCNUM? If is not 0, add (=1) or delete (=2) ECC numbers, at least one ECC number should be specified: OK Or ERROR Response [+QECCNUM: 0,,[…]] [+QECCNUM: 1,,[…]] … Maximum Response Time Characteristics OK 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. ECC number operations. 0 Query ECC numbers 1 Add ECC numbers 2 Delete ECC numbers Integer type. ECC number type. 0 ECC numbers without (U)SIM 1 ECC numbers with (U)SIM String type. ECC numbers (e.g.'110', '119') Example AT+QECCNUM=? +QECCNUM: (0-2) //Query the supported ECC number operation mode. OK AT+QECCNUM? //Query the ECC numbers with or without (U)SIM. +QECCNUM: 0,'911','112','00','08','110','999','118','119' +QECCNUM: 1,'911','112' EG512R&EM1x0R_Series_AT_Commands_Manual 102 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK AT+QECCNUM=0,1 +QECCNUM: 1,'911','112' //Query the ECC numbers of the type with (U)SIM. OK AT+QECCNUM=1,1,'110', '234' //Add '110' and '234' as ECC numbers of the type with (U)SIM. OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1, '911','112','110','234' OK AT+QECCNUM=2,1,'110' //Delete '110' from ECC numbers of the type with (U)SIM. OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1, '911','112','234' OK 6.17. AT^DSCI Call Status Indication This command indicates the call status. AT^DSCI Call Status Indication Test Command AT^DSCI=? Response ^DSCI: (list of supported s) Read Command AT^DSCI? OK Response ^DSCI: Write Command AT^DSCI=[] Characteristics Reference OK Response OK / Parameter Integer type. Presentation of the DSCI at TE. 0 DSCI not supported EG512R&EM1x0R_Series_AT_Commands_Manual 103 / 227 1 DSCI supported LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual NOTE When the presentation of the DSCI at the TE is enabled, an unsolicited result code is returned after the action. The URC is presented as follows: ^DSCI: ,,,,, Parameters Integer type. Call ID Integer type. Call direction 0 Mobile originated call 1 Mobile terminated call Integer type. Call state 1 CALL_LOCAL_HOLD 2 CALL_ORIGINAL 3 CALL_CONNECT 4 CALL_INCOMING 5 CALL_WAITING 6 CALL_END 7 CALL_ALERTING 8 CALL_REMOTE_HOLD 9 CALL_BOTH_HOLD Integer type. Call type 0 Voice call 1 PS call 9 Emergency call String type. Phone number Integer type. Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type Example //Dial a call AT^DSCI=1 OK ATD10086; OK ^DSCI: 1,0,2,0,10086,129 ^DSCI: 1,0,7,0,10086,129 //Enable DSCI. //Dial 10086. //A call is originated. //The call is alerting. EG512R&EM1x0R_Series_AT_Commands_Manual 104 / 227 ^DSCI: 1,0,3,0,10086,129 ATH OK ^DSCI: 1,0,6,0,10086,129 //Incoming call RING ##0 ^DSCI: 1,1,4,0,13022100000,129 RING ##0 ^DSCI: 1,1,6,0,13022100000,129 NO CARRIER LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //The call is connected. //The call is ended. //A call is coming. //The call is ended. EG512R&EM1x0R_Series_AT_Commands_Manual 105 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 7 Phonebook Commands 7.1. AT+CNUM Subscriber Number This command gets the subscribers’ own number(s) from the (U)SIM. AT+CNUM Subscriber Number Test Command AT+CNUM=? Execution Command AT+CNUM Response OK Response [+CNUM: [],,] [+CNUM: [],,] […] OK Or ERROR Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Optional alphanumeric string associated with . The used character set is the one selected with AT+CSCS. String type. Phone number of format specified by . Type of address octet in integer format (See 3GPP TS 24.008 [8] subclause 10.5.4.7). Usually, it is one of the following three values: 129 Unknown type 145 International type (contains the character '+') 161 National type EG512R&EM1x0R_Series_AT_Commands_Manual 106 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Error codes. For more details, please refer to Table 11. 7.2. AT+CPBF Find Phonebook Entries This command searches the phonebook entries starting with the given string from the current phonebook memory storage selected with AT+CPBS, and return all found entries sorted in alphanumeric order. AT+CPBF Find Phonebook Entries Test Command AT+CPBF=? Response +CPBF: , Write Command AT+CPBF= OK Response [+CPBF: ,,,] [+CPBF: ,,, […]] OK Or ERROR Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error related to MT functionality: +CME ERROR: Depend on the storage of phonebook entries. / Parameter Integer type. The maximum length of field . Integer type. The maximum length of field . String type. The field of maximum length in current TE character set specified by AT+CSCS. Integer type. In the range of location numbers of phonebook memory. String type. Phone number of format specified by . Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it is one of the following three values: 129 Unknown type EG512R&EM1x0R_Series_AT_Commands_Manual 107 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 145 International type (contains the character '+') 161 National type Integer type. The field of maximum length in current TE character set specified by AT+CSCS. Error codes. For more details, please refer to Table 11. 7.3. AT+CPBR Read Phonebook Entries This command reads phonebook entries in location number range ... from the current phonebook memory storage selected with AT+CPBS. If is omitted, only location will be returned. AT+CPBR Read Phonebook Entries Test Command AT+CPBR=? Response +CPBR: (list of supported s),, Write Command AT+CPBR=[,] OK Response [+CPBF: ,,,] [[...] [+CPBF: ,,,]] OK Or ERROR Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error related to MT functionality: +CME ERROR: Depends on the storage of phonebook entries. / Parameter Integer type. Location numbers of phonebook memory. Integer type. The maximum length of field . Integer type. The maximum length of field . Integer type. The first phonebook record to be read. Integer type. The last phonebook record to be read. EG512R&EM1x0R_Series_AT_Commands_Manual 108 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Type of address octet in integer format (See 3GPP TS 24.008 [8] subclause 10.5.4.7). Usually, it is one of the following three values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type. The field of maximum length in current TE character set specified by AT+CSCS. Error codes. For more details, please refer to Table 11. 7.4. AT+CPBS Select Phonebook Memory Storage The Write Command selects phonebook memory storage , which is used by other phonebook related commands. The Read Command returns currently selected memory, and, when supported by manufacturer, the number of used locations and the total number of locations in the memory. AT+CPBS Select Phonebook Memory Storage Test Command AT+CPBS=? Response +CPBS: (list of supported s) OK Or ERROR Read Command AT+CPBS? If there is any error related to MT functionality: +CME ERROR: Response +CPBS: [,,] OK Or ERROR Write Command AT+CPBS= If there is any error related to MT functionality: +CME ERROR: Response OK Or ERROR If there is any error related to MT functionality: +CME ERROR: EG512R&EM1x0R_Series_AT_Commands_Manual 109 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP 27.007 300 ms / Parameter String type. Values reserved by the present document. 'DC' MT dialed calls list 'EN' (U)SIM (or MT) emergency number 'FD' (U)SIM fixdialing-phonebook (AT+CPBW operation needs the authority of PIN2) 'LD' (U)SIM last-dialing-phonebook 'MC' MT missed (unanswered) calls list 'ME' MT phonebook 'ON' (U)SIM own numbers (MSISDNs) list 'RC' MT received calls list 'SM' (U)SIM phonebook Integer type. The total number of used locations in selected memory. Integer type. The total number of locations in selected memory. Error codes. For more details, please refer to Table 11. 7.5. AT+CPBW Write Phonebook Entry The Write Command writes phonebook entry in location number in the current phonebook memory storage selected with AT+CPBS. It can also delete a phonebook entry in location number . AT+CPBW Write Phonebook Entry Test Command AT+CPBW=? Response +CPBW: (range of supported s),,(list of supported s), OK Or ERROR Write Command AT+CPBW=[][,[,<ty If there is any error related to MT functionality: +CME ERROR: Response OK EG512R&EM1x0R_Series_AT_Commands_Manual 110 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual pe>[,]]] Maximum Response Time Characteristics Reference 3GPP 27.007 Or ERROR If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. In the range of location numbers of phonebook memory. Integer type. The maximum length of field . Integer type. The maximum length of field . String type. Phone number of format specified by . Type of address octet in integer format (See 3GPP TS 24.008 [8] subclause 10.5.4.7). Usually, it is one of the following three values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type field of maximum length in current TE character set specified by AT+CSCS. Error codes. For more details, please refer to Table 11. Example AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK //Make a new phonebook entry at location 10. AT+CPBW=10 //Delete entry at location 10. OK EG512R&EM1x0R_Series_AT_Commands_Manual 111 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 8 Short Message Service Commands 8.1. AT+CSMS Select Message Service This command selects message service and queries the types of messages supported by MT. AT+CSMS Select Message Service Test Command AT+CSMS=? Response +CSMS: (list of supported s) Read Command AT+CSMS? OK Response +CSMS: ,,, Write Command AT+CSMS= OK Response +CSMS: ,, OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300 ms / Parameter Integer type. Type of message service. 0 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2 version 4.7.0; Phase 2+ features which do not require new command syntax can be supported, e.g. correct routing of messages with new Phase 2+ data coding schemes). 1 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is EG512R&EM1x0R_Series_AT_Commands_Manual 112 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual compatible with 3GPP TS 27.005 Phase 2+ version; the requirement of setting 1 is mentioned under corresponding command descriptions). Integer type. Mobile terminated messages. 0 Type not supported 1 Type supported Integer type. Mobile originated messages. 0 Type not supported 1 Type supported Integer type. Broadcast type messages. 0 Type not supported 1 Type supported Error codes. For more details, please refer to Table 12. Example AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //Test command //Set type of message service to 1. //Read command 8.2. AT+CMGF Message Format This command specifies the input and output format of the short messages. indicates the format of messages used with send, list, read and write message commands and unsolicited result codes resulting from received messages. The format of messages can be either PDU mode (entire TP data units used) or text mode (headers and body of the messages given as separate parameters). Text mode uses the value of parameter specified by command AT+CSCS to inform the character set to be used in the message body in the TA-TE interface. AT+CMGF Message Format Test Command AT+CMGF=? Response +CMGF: (list of supported s) EG512R&EM1x0R_Series_AT_Commands_Manual 113 / 227 Read Command AT+CMGF? Write Command AT+CMGF[=] Maximum Response Time Characteristics Reference 3GPP TS 27.005 Parameter Integer type. 0 PDU mode 1 Text mode LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK Response +CMGF: OK Response OK 300 ms / 8.3. AT+CSCA Service Center Address The Write Command updates the SMSC address when mobile originated SMS are transmitted. In text mode, the setting is used by Write Command. In PDU mode, setting is used by the same command, but only when the length of the SMSC address is coded into the parameter which equals zero. AT+CSCA Service Center Address Test Command AT+CSCA=? Read Command AT+CSCA? Response OK Response +CSCA: , Write Command AT+CSCA=[,] Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. EG512R&EM1x0R_Series_AT_Commands_Manual 114 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Reference 3GPP TS 27.005 Parameter Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (refer to by default). Example AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //Set SMSC address. //Query SMSC address. 8.4. AT+CPMS Preferred Message Storage This command selects memory storages , and to be used for reading, writing, etc. AT+CPMS Preferred Message Storage Test Command AT+CPMS=? Response +CPMS: (list of supported s),(list of supported s),(list of supported s) Read Command AT+CPMS? OK Response +CPMS: ,,,,,,,, Write Command AT+CPMS=[,[,]] OK Response +CPMS: ,,,,, EG512R&EM1x0R_Series_AT_Commands_Manual 115 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK If there is any error related to MT functionality: +CMS ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter String type. Messages to be read and deleted from this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location String type. Messages will be written and sent to this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location String type. Received messages will be placed in this memory storage if routing to PC is not set (AT+CNMI). 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Integer type. The number of current messages in . Integer type. The total number of messages which can be stored in . Error codes. For more details, please refer to Table 12. Example AT+CPMS? //Query the current SMS message storage. +CPMS: 'ME',0,127,'ME',0,127,'ME',0,127 OK AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //Set SMS message storage as 'SM'. OK AT+CPMS? //Query the current SMS message storage. EG512R&EM1x0R_Series_AT_Commands_Manual 116 / 227 +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 OK LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 8.5. AT+CMGD Delete Messages This command deletes short messages from the preferred message storage location . If is presented and not set to 0, the ME should ignore and follow the rules of shown as below. AT+CMGD Delete Messages Test Command AT+CMGD=? Response +CMGD: (range of supported s),(range of supported s) Write Command AT+CMGD=[,] OK Response MT deletes message from preferred message storage location . OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300 ms / Parameter Integer type value in the range of location numbers supported by the associated memory. Integer type. Delete flag. 0 Delete the message specified in 1 Delete all read messages from storage 2 Delete all read messages from storage and sent mobile originated messages 3 Delete all read messages from storage, sent and unsent mobile originated messages 4 Delete all messages from storage Error codes. For more details, please refer to Table 12. EG512R&EM1x0R_Series_AT_Commands_Manual 117 / 227 Example AT+CMGD=1 OK AT+CMGD=1,4 OK LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //Delete the message specified in =1. //Delete all messages from storage. 8.6. AT+CMGL List Messages This command returns messages with status value from preferred message storage to the TE. If the status of the message is 'REC UNREAD', the status in the storage changes to 'REC READ'. When executing command AT+CMGL without status value , it will report the list of SMS with 'REC UNREAD' status. AT+CMGL List Messages Test Command AT+CMGL=? Response +CMGL: (list of supported s) Write Command AT+CMGL[=] OK Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-SUBMITs and/or SMS-DELIVERs: +CMGL: ,,,[],[][,,][] [...] For SMS-STATUS-REPORTs: +CMGL: ,,,,[],[],,,[] [...] For SMS-COMMANDs: +CMGL: ,,,[] […] For CBM storage: +CMGL: ,,,,,[] [...] OK EG512R&EM1x0R_Series_AT_Commands_Manual 118 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 If in PDU mode (AT+CMGF=0) and the command is executed successfully: +CMGL: ,,[],[] [...] OK If there is any error related to MT functionality: +CMS ERROR: 300 ms. Note: Operation of depends on the storage of listed messages. / Parameter Integer type in PDU mode, or string type in text mode. The status of message in memory; Defined values: PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Integer type. In the range of location numbers supported by the associated memory Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in TS 27.007); type of address is given by . String type alphanumeric representation of or corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer-specified; the used character set should be the one selected with command Select TE Character Set AT+CSCS (see definition of this command in 3GPP TS 27.007). Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). EG512R&EM1x0R_Series_AT_Commands_Manual 119 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (refer to by default). Integer type. Message length. The length of the message body in text mode (AT+CMGF=1); or the length of the actual TP data unit in octets in PDU mode (AT+CMGF=0) (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7-bit default alphabet is used and indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set. - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules in 3GPP TS 27.007 Annex A. - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7 bit default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7 bit default alphabet 23) is presented as 17 (IRA 49 and 55)). - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7-bit default alphabet is used: - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7-bit default alphabet into two IRA character long hexadecimal number. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) 3GPP TS 27.007 Depends on the command or result code: first octet of 3GPP TS 23.040 [3] SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND (default 2) in integer format. 3GPP TS 23.040 [3] TP-Message-Reference in integer format 3GPP TS 23.040 [3] TP-Recipient-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer command +CSCS in 3GPP TS 27.007 [9]); type of address given by 3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format (refer to by default) 3GPP TS 23.040 [3] TP-Service-Centre-Time-Stamp in time-string format (refer to EG512R&EM1x0R_Series_AT_Commands_Manual 120 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual ) 3GPP TS 23.040 [3] TP-Discharge-Time in time-string format: 'yy/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals '94/05/06,22:10:00+08'. 3GPP TS 23.040 [3] TP-Status in integer format. 3GPP TS 23.040 [3] TP-Command-Type in integer format (default 0) 3GPP TS 23.041 [4] CBM Serial Number in integer format. 3GPP TS 23.041 [4] CBM Message Identifier in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 4–7 in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 0–3 in integer format. Error codes. For more details, please refer to Table 12. Example AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, OK //Set SMS message format as text mode. //List all messages from message storage. 8.7. AT+CMGR Read Messages The command returns SMS message with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage will change to 'REC READ'. AT+CMGR Read Messages Test Command AT+CMGR=? Write Command AT+CMGR= Response OK Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-DELIVER: +CMGR: ,,[],[,,,,,,,] OK EG512R&EM1x0R_Series_AT_Commands_Manual 121 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 For SMS-SUBMIT: +CMGR: ,,[][,,,,,[],,,] OK For SMS-STATUS-REPORTs: +CMGR: ,,,[],[],,, OK For SMS-COMMANDs: +CMGR: ,,[,,[],[],[], ] OK For CBM storage: +CMGR: ,,,,, OK If in PDU mode (AT+CMGF=0) and command is executed successfully: +CMGR: ,[], OK If there is any error related to MT functionality: +CMS ERROR: Depends on the length of message content. / Parameter Integer type. In the range of location numbers supported by the associated memory. Integer type in PDU mode, or string type in text mode. The status of message in EG512R&EM1x0R_Series_AT_Commands_Manual 122 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual memory; Defined values: PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND in integer format. If a valid value has been entered once, the parameter can be omitted. Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ). Message number. 3GPP TS 23.040 TP-Message-Number in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Recipient address. 3GPP TS 23.040 TP-Recipient-Address Address-Value field in string format. BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (refer to by default). Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (refer to by default). EG512R&EM1x0R_Series_AT_Commands_Manual 123 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (refer to by default). Integer type. Message length. In text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0) the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). The text of short message. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). 3GPP TS 23.040 [3] TP-Discharge-Time in time-string format: 'yy/MM/dd,hh:mm:ss±zz', during which characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals '94/05/06,22:10:00+08'. 3GPP TS 23.040 [3] TP-Status in integer format. 3GPP TS 23.040 [3] TP-Command-Type in integer format (default 0) 3GPP TS 23.041 [4] CBM Serial Number in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 4–7 in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 0–3 in integer format. 3GPP TS 23.040 [3] TP-Command-Data in text mode responses; ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) Error codes. For more details, please refer to Table 12. Example +CMTI: 'SM',3 //Indicate that new message has been received and saved to = 3 of 'SM'. AT+CSDH=1 OK AT+CMGR=3 //Read message +CMGR: 'REC UNREAD','+8615021012496',,'13/12/13,15:06:37+32',145,4,0,0,'+861380021050 0',145,27 OK EG512R&EM1x0R_Series_AT_Commands_Manual 124 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 8.8. AT+CMGS Send Messages This command sends a short message from TE to the network (SMS-SUBMIT). After executing the Write Command, wait for the prompt > and then start to write the message. After that, press CTRL + Z to indicate the ending of PDU and begin to send the message. Sending can be cancelled by pressing ESC. Abortion is acknowledged with OK, though the message will not be sent. The message reference is returned to the TE on successful message delivery. The value can be used to identify message upon unsolicited delivery status report result code. AT+CMGS Send Messages Test Command AT+CMGS=? Write Command 1) If in text mode (AT+CMGF=1): AT+CMGS=[,] text is entered (Ctrl + Z/ ESC) Response OK Response +CMGS: OK 2) If in PDU mode (AT+CMGF=0): AT+CMGS= PDU is given (Ctrl + Z/ ESC) Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 120 s, determined by the network. / Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Integer type. Message length. In the text mode (AT+CMGF=1), the length of the message body in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Error codes. For more details, please refer to Table 12. EG512R&EM1x0R_Series_AT_Commands_Manual 125 / 227 Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > +CMGS: 247 OK LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //Set SMS message format to text mode. //Set character set to GSM which is used by the TE. //Enter in text (CTRL+Z to send message, ESC to quit without sending). 8.9. AT+CMMS Send More Messages The Writer Command controls the continuity of SMS relay protocol link. When feature is enabled (and supported by network) multiple messages can be sent much faster as link is kept open. AT+CMMS Send More Messages Test Command AT+CMMS=? Response +CMMS: (range of supported s) Read Command AT+CMMS? OK Response +CMMS: Write Command AT+CMMS[=] OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 120 s, determined by network. / EG512R&EM1x0R_Series_AT_Commands_Manual 126 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter Integer type. 0 Feature disabled. 1 Keep enabled until the time between the response of the latest message sending command (AT+CMGS, AT+CMSS, etc.) and the next sending command exceeds 1–5 seconds (the exact value is up to ME implementation); then ME shall close the link and TA switches back to 0 automatically. 2 Feature enabled. If the time between the response of the latest message sending command and the next sending command exceeds 1–5 seconds (the exact value is up to ME implementation), ME shall close the link but MT will not switch back to 0 automatically. Error codes. For more details, please refer to Table 12. NOTE After the execution of the Read Command, a delay of 5–10 seconds is required before issuing the Write Command. Otherwise +CMS ERROR: 500 may appear. 8.10. AT+CMGW Write Messages to Memory This command stores short messages (either SMS-DELIVER or SMS-SUBMIT) to memory storage , and then the memory location of the stored message is returned. Message status will be set to 'stored unsent' by default; but parameter also allows other status values to be given. The entering of text is done similarly as specified in AT+CMGS Write Command. AT+CMGW Write Messages to Memory Test Command AT+CMGW=? Write Command 1) If in text mode (AT+CMGF=1): AT+CMGW=[,[,]] text is specified (Ctrl + Z/ ESC) 2) If in PDU mode (AT+CMGF=0): AT+CMGW=[,] PDU is given (Ctrl + Z/ ESC) Response OK Response +CMGW: OK If there is any error related to MT functionality: +CMS ERROR: Maximum Response Time 300 ms EG512R&EM1x0R_Series_AT_Commands_Manual 127 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Characteristics / Reference 3GPP TS 27.005 Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address given by . Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (refer to by default). Integer type in PDU mode, or string type in text mode. The status of message in memory; Defined values: PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Integer type. Message length. In the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.04 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Integer type. Index of message in selected storage . String type. Messages will be written and sent to this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Error codes. For more details, please refer to Table 12. EG512R&EM1x0R_Series_AT_Commands_Manual 128 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > +CMGW: 4 //Set SMS message format to text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use CTRL + Z to write message or ESC to quit without sending. OK AT+CMGF=0 //Set SMS message format to PDU mode. OK AT+CMGW=18 > 0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK 8.11. AT+CMSS Send Messages from Storage This command sends messages with location value from preferred message storage to the network (SMS-SUBMIT or SMS-COMMAND). If a new recipient address is given for SMS-SUBMIT, it should be used instead of the one stored with the message. Reference value is returned to the TE on successful message delivery. AT+CMSS Send Messages from Storage Test Command AT+CMSS=? Write Command AT+CMSS=[,[,]] Response OK Response If in text mode (AT+CMGF=1) and the message is sent successfully: +CMSS: [,] OK If in PDU mode (AT+CMGF=0) and the message is sent successfully: +CMSS: [,] EG512R&EM1x0R_Series_AT_Commands_Manual 129 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK If there is any error related to MT functionality: +CMS ERROR: 120 s, determined by network. / Parameter Integer type in the range of location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Type of destination address. 3GPP TS 24.011 TP-Detination-Address Type-of-Address octet in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). Format is same for in case of SMS, but without 3GPP TS 24.011 SC address field and parameter shall be bounded by double quote characters like a normal string type parameter. String type. Messages will be written and sent to this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Error codes. For more details, please refer to Table 12. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK //Set SMS message format to text mode. //Set character set to GSM which is used by the TE. //Enter in text. Use CTRL+Z to send message or ESC to quit without sending. EG512R&EM1x0R_Series_AT_Commands_Manual 130 / 227 AT+CMSS=4 +CMSS: 54 OK LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //Send the message of index 4 from memory storage. 8.12. AT+CNMA New Message Acknowledgement to ME/TA This command confirms successful receipt of a new message (SMS-DELIVER or SMS-STATUS-REPORT) routed directly to the TE. If the UE does not receive acknowledgement within required time (network timeout), it will send an RP-ERROR message to the network. The UE will automatically disable routing to the TE by setting both and values of AT+CNMI to 0. AT+CNMA New Message Acknowledgement to UE/TE Test Command AT+CNMA=? Response If in text mode (AT+CMGF=1): OK If in PDU mode (AT+CMGF=0): +CNMA: (list of supported s) Execution Command If in text mode (AT+CMGF=1): AT+CNMA OK Response OK Or ERROR Write Command If in PDU mode (AT+CMGF=0): AT+CNMA=[,[ PDU is given]] If there is any error related to MT functionality: +CMS ERROR: Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300 ms / EG512R&EM1x0R_Series_AT_Commands_Manual 131 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. Parameter required only for PDU mode 0 Command operates similarly as in text mode 1 Send positive (RP-ACK) acknowledgement to the network. Accepted only in PDU mode. 2 Send negative (RP-ERROR) acknowledgement to the network. Accepted only in PDU mode. Integer type. Message length. The length of the message body (or ) in characters in the text mode (AT+CMGF=1), or the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) in PDU mode (AT+CMGF=0). Error codes. For more details, please refer to Table 12. NOTE The Execution and Write Commands shall only be used when AT+CSMS parameter equals 1 (phase 2+) and an appropriate URC has been issued by the MT, i.e.: +CMT for = 2 incoming message classes 0, 1, 3 and none; +CMT for = 3 incoming message classes 0 and 3; +CDS for = 1. Example AT+CSMS=1 OK AT+CNMI=1,2,0,0,0 OK AT+CMGF=1 OK AT+CSDH=1 OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when SMS is incoming. AT+CNMA //Send ACK to the network. OK AT+CNMA +CMS ERROR: 340 //The second time return error; it needs ACK only once. EG512R&EM1x0R_Series_AT_Commands_Manual 132 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 8.13. AT+CNMI New Message Indications to TE This command selects the procedure on how receiving of new messages from the network is indicated to the TE when TE is active, e.g. DTR is at low level (ON). If TE is inactive (e.g. DTR is at high level (OFF)), message receiving should be done as specified in 3GPP TS 23.038 [2]. AT+CNMI SMS Event Reporting Configuration Test Command AT+CNMI=? Response +CNMI: (range of supported s),(range of supported s),(list of supported s),(range of supported s),(list of supported s) Read Command AT+CNMI? OK Response +CNMI: ,,,, Write Command AT+CNMI=[[,[,[,[,]]]]] OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. 0 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications. 1 Discard indication and reject new received message unsolicited result codes when TA-TE link is reserved (e.g. in data mode). Otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in data mode) and flush them to the TE after reservation. Otherwise forward them directly to the TE. EG512R&EM1x0R_Series_AT_Commands_Manual 133 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Integer type. The rules for storing received SMs depend on its data coding scheme (refer to 3GPPTS 23.038 [2]), preferred memory storage (AT+CPMS) setting and the value is: 0 No SMS-DELIVER indications are routed to TE. 1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE by using unsolicited result code: +CMTI: , 2 SMS-DELIVERs (except class 2) are routed directly to the TE using unsolicited result code: +CMT: [], (PDU mode enabled) or +CMT: ,[],[,,,,,,,] (text mode enabled; about the parameters in italics, please refer to AT+CSDH). Class 2 messages result in indication as defined in =1. 3 Class 3 SMS-DELIVERs are routed directly to TE by using unsolicited result codes defined in =2. Messages of other classes result in indication as defined in =1. Integer type. The rules for storing received CBMs depend on its data coding scheme (refer to 3GPP TS 23.038 [2]), the setting of Select CBM Types (AT+CSCB); and the value is: 0 No CBM indications are routed to the TE. 2 New CBMs are routed directly to the TE using unsolicited result code: +CBM: (PDU mode enabled); or +CBM: ,,, , (text mode enabled). Integer type. 0 No SMS-STATUS-REPORTs are routed to the TE. 1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +CDS: (PDU mode) or +CDS: ,,[],[],,, (text mode) 2 If SMS-STATUS-REPORT is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CDSI: , Integer type. 0 TA buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is specified (OK response shall be given before flushing the codes). 1 TA buffer of unsolicited result codes defined within this command is cleared when 1 or 2 is specified. Error codes. For more details, please refer to Table 12. NOTE Unsolicited result codes: +CMTI: , +CMT: [], +CBM: Indicate that new message has been received Short message is outputted directly Cell broadcast message is outputted directly Example AT+CMGF=1 //Set SMS message format as text mode. EG512R&EM1x0R_Series_AT_Commands_Manual 134 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK AT+CSCS='GSM' //Set character set as GSM which is used by the TE. OK AT+CNMI=1,2,0,1,0 //Set SMS-DELIVERs are routed directly to the TE. OK AT+CSDH=1 //Show text mode parameters OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when an SMS is incoming. 8.14. AT+CSCB Select Cell Broadcast Message Types This command selects which types of CBMs are to be received by the ME. AT+CSCB Select Cell Broadcast Message Types Test Command AT+CSCB=? Response +CSCB: (list of supported s) Read Command AT+CSCB? OK Response +CSCB: ,, Write Command AT+CSCB=[,mids>[,]] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300 ms / Parameter Integer type. 0 Message types specified in and are accepted 1 Message types specified in and are not accepted String type. All different possible combinations of CBM message identifiers (refer to ) (default is empty string), e.g. '0,1,5,320–478,922'. EG512R&EM1x0R_Series_AT_Commands_Manual 135 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual String type. All different possible combinations of CBM data coding schemes (refer to ) (default is empty string), e.g. '0–3,5'. Error codes. For more details, please refer to Table 12. 8.15. AT+CSDH Show Text Mode Parameters This command controls whether detailed header information is shown in text mode result codes. AT+CSDH Show Text Mode Parameters Test Command AT+CSDH=? Response +CSDH: (list of supported s) Read Command AT+CSDH? OK Response +CSDH: Write Command AT+CSDH=[] Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK Response OK Or ERROR 300 ms / Parameter Integer type. 0 Do not show header values defined in commands AT+CSCA and AT+CSMP (, , , , and ) nor , or in +CMT, +CMGL, +CMGR result codes for SMS-DELIVERs and SMS-SUBMITs in text mode; for SMS-COMMANDs, in +CMGR result code, do not show , , , , or . 1 Show the values in result codes Example AT+CSDH=0 OK //Set to disable the presenting of text mode parameters EG512R&EM1x0R_Series_AT_Commands_Manual 136 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual AT+CMGR=2 +CMGR: 'STO UNSENT' ,'', OK AT+CSDH=1 //Set to enable the presenting of text mode parameters OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 OK 8.16. AT+CSMP Set Text Mode Parameters This command sets values for additional parameters needed when a short message is sent to the network or placed in a storage in text mode. AT+CSMP Set Text Mode Parameters Test Command AT+CSMP=? Read Command AT+CSMP? Response OK Response +CSMP: ,,, Write Command AT+CSMP=[,[,[,] ]] Maximum Response Time OK Response MT selects values for additional parameters needed when SM is sent to the network or placed in a storage when text mode is selected (AT+CMGF=1). It is possible to set the validity period starting from when the SMS is received by the SMSC ( ranges from 0 to 255) or define the absolute time of the validity period termination ( is a string). OK 300 ms Characteristics / Reference 3GPP TS 27.005 EG512R&EM1x0R_Series_AT_Commands_Manual 137 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter First octet. Depending on the command or result code: first octet of 3GPP TS 23.040 [3] SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, SMS-COMMAND in integer format. If a valid value has been entered once, parameter can be omitted. Validity period. Depend on SMS-SUBMIT setting: 3GPP TS 23.040 [3] TP-Validity-Period either in integer format or in time-string format (refer to ). Default: 167. Protocol identifier. 3GPP TS 23.040 [3] TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 [2] SMS Data Coding Scheme (default: 0), or Cell Broadcast Data Coding Scheme in integer format. EG512R&EM1x0R_Series_AT_Commands_Manual 138 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 9 Packet Domain Commands 9.1. AT+CGATT PS Attach or Detach The Write Command attaches the MT to, or detaches the MT from, the Packet Domain service. After the command has completed, the MT remains in V.250 command state. If MT is already in the requested state, the command will be ignored and the OK response will be returned. If the requested state cannot be achieved, an ERROR or +CME ERROR response will be returned. AT+CGATT PS Attach or Detach Test Command AT+CGATT=? Response +CGATT: (list of supported s) Read Command AT+CGATT? OK Response +CGATT: Write Command AT+CGATT= OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 140 s, determined by the network. / Parameter Integer type. The state of PS attachment. 0 Detached 1 Attached EG512R&EM1x0R_Series_AT_Commands_Manual 139 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Other values are reserved and will result in an ERROR response to the Write Command Error codes. For more details, please refer to Table 11. Example AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //Attach to PS service. //Detach from PS service. //Query the current PS service state. 9.2. AT+CGDCONT Define PDP Contexts The Write Command specifies PDP context parameters for a specific context . A special form of the Write Command (AT+CGDCONT=) causes the values for context to become undefined. It is not allowed to change the definition of an already activated context. This Read Command returns the current settings for each defined PDP context. AT+CGDCONT Define PDP Contexts Test Command AT+CGDCONT=? Response +CGDCONT: (range of supported s),,< APN>,,(range of supported s),(ran ge of supported s),(list of supported s),(list of supported s) Read Command AT+CGDCONT? OK Response +CGDCONT: ,,,,,,, […] Write Command AT+CGDCONT=[,[,< APN>[,[,[,[,[,]]]]]]] OK Response OK Or ERROR EG512R&EM1x0R_Series_AT_Commands_Manual 140 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. PDP context identifier. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value = 1) is returned by the test form of the command. Range: 1–42. String type. Packet data protocol type, a string parameter which specifies the type of packet data protocol. 'IP' Internet protocol (IETF STD 5 [103]) 'PPP' Point to Point Protocol (IETF STD 51 [104]) 'IPV6' Internet Protocol, version 6 (see RFC 2460 [106]) 'IPV4V6' Virtual introduced to handle dual IP stack UE capability. (See 3GPP TS 24.301 [83]) String type. Access point name, a logical name used to select the GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested. String type. Identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The allocated address may be read using the AT+CGPADDR. Integer type. Controls PDP data compression (applicable for SNDCP only) (refer to 3GPP TS 44.065 [61]). 0 Off 1 On (manufacturer preferred compression) 2 V.42bis 3 V.44 (Not supported currently) Integer type. Controls PDP header compression (see 3GPP TS 44.065 [61] and 3GPP TS 25.323 [62]). 0 Off 1 On (manufacturer preferred compression) 2 RFC1144 [105] (applicable for SNDCP only) 3 RFC2507 [107] 4 RFC3095 [108] (applicable for PDCP only) Integer type. Controls how the MT/TA requests to get the IPv4 address information. 0 IPv4 address allocation through NAS signaling 1 IPv4 address allocated through DHCP EG512R&EM1x0R_Series_AT_Commands_Manual 141 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Integer type. Indicates the type of PDP context activation request for the PDP context. 0 PDP context is for new PDP context establishment or for handover from a non-3GPP access network (how the MT decides whether the PDP context is for new PDP context establishment or for handover is implementation specific). 1 PDP context is for emergency bearer services. 9.3. AT+CGQREQ Quality of Service Profile (Requested) This command allows the TE to specify the quality of service profile that is used when the MT activates a PDP context. The Write Command specifies a profile for the context . A special form of the Write Command, AT+CGQREQ=, causes the requested profile for context number to become undefined. The Read Command returns the current settings for each defined context. Details can be found in 3GPP TS 23.107. AT+CGQREQ Quality of Service Profile (Requested) Test Command AT+CGQREQ=? Response +CGQREQ: ,(range of supported s),(range of supported s),(range of supported s),(range of supported s),(list of supported s) Read Command AT+CGQREQ? OK Response [+CGQREQ: ,,,,,] [+CGQREQ: ,,,,, […]] Write Command AT+CGQREQ=[, [,[,[,[,]]]]] OK Response OK If there is any error related to MT functionality: +CME ERROR: Maximum Response Time 300 ms Characteristics The command takes effect immediately. EG512R&EM1x0R_Series_AT_Commands_Manual 142 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Reference 3GPP TS 27.007 The configurations will be saved automatically. Parameter Integer type. Specify a particular PDP context definition (see AT+CGDCONT). String type. Packet Data Protocol type. 'IP' Internet protocol (IETF STD 5 [103]) 'PPP' Point to Point Protocol (IETF STD 51 [104]) 'IPV6' Internet Protocol, version 6 (see RFC 2460 [106]) 'IPV4V6' Virtual introduced to handle dual IP stack UE capability. (See 3GPP TS 24.301 [83]) Integer type. Specify the precedence class. 0 Network subscribed value 1 High Priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments should be maintained ahead of precedence class 3 3 Low priority. Service commitments should be maintained Integer type. Specify the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the details, please refer to Table 5. 0 Network subscribed value 1–4 Please refer to Table 5. Integer type. Specify the reliability class. 0 Network subscribed value 1 Non real-time traffic and error-sensitive application that cannot cope with data loss 2 Non real-time traffic and error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic and error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic and error-sensitive application that can cope with data loss 5 Real-time traffic and error non-sensitive application that can cope with data loss Integer type. Specify the peak throughput class, in octets per second. 0 Network subscribed value 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) EG512R&EM1x0R_Series_AT_Commands_Manual 143 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 8 Up to 128 000 (1024 kbit/s) 9 Up to 256 000 (2048 kbit/s) Integer type. Specify the mean throughput class, in octets per hour. 0 Network subscribed value 1 100 (about 0.22 bit/s) 2 200 (about 0.44 bit/s) 3 500 (about 1.11 bit/s) 4 1 000 (about 2.2 bit/s) 5 2 000 (about 4.4 bit/s) 6 5 000 (about 11.1 bit/s) 7 10 000 (about 22 bit/s) 8 20 000 (about 44 bit/s) 9 50 000 (about 111 bit/s) 10 100 000 (about 0.22 kbit/s) 11 200 000 (about 0.44 kbit/s) 12 500 000 (about 1.11 kbit/s) 13 1000 000 (about 2.2 kbit/s) 14 2 000 000 (about 4.4 kbit/s) 15 5 000 000 (about 11.1 kbit/s) 16 10 000 000 (about 22 kbit/s) 17 20 000 000 (about 44 kbit/s) 18 50 000 000 (about 111 kbit/s) 31 Best effort Error codes. For more details, please refer to Table 11. Table 5: Delay Class SDU Size 128 octets 1024 octets Delay Class 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) Mean Transfer Delay < 0.5 < 5 < 50 Unspecified < 0.5 < 5 < 50 Unspecified 95 Percentile < 1.5 < 25 < 250 < 1.5 < 25 < 250 EG512R&EM1x0R_Series_AT_Commands_Manual 144 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 9.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) This command allows TE to specify a minimum acceptable profile which is checked by MT against the negotiated profile when the PDP context is activated. The Write Command specifies a profile for the context identified by the context identification parameter . A special form of the Write Command, AT+CGQMIN= causes the minimum acceptable profile for context number to become undefined. In this case no check is made against the negotiated profile. The Read Command returns the current settings for each defined context. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) Test Command AT+CGQMIN=? Response +CGQMIN: ,(range of supported s),(list of supported s),(range of supported s),(range of supported s),(range of supported s) […] Read Command AT+CGQMIN? OK Response [+CGQMIN: ,,,,,] […] Write Command AT+CGQMIN=[, [,[,[,[,]]]]] OK Response OK If there is any error related to MT functionality: +CME ERROR: Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Specify a particular PDP context definition (see AT+CGDCONT). String type. Packet data protocol type. 'IP' Internet protocol (IETF STD 5 [103]) EG512R&EM1x0R_Series_AT_Commands_Manual 145 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 'PPP' Point to Point Protocol (IETF STD 51 [104]) 'IPV6' Internet Protocol, version 6 (see RFC 2460 [106]) 'IPV4V6' Virtual introduced to handle dual IP stack UE capability. (See 3GPP TS 24.301 [83]) Integer type. Specify the precedence class. 0 Network subscribed value 1 High Priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments should be maintained ahead of precedence class 3 3 Low priority. Service commitments should be maintained Integer type. Specify the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the detail please refer to Table 5. 0 Network subscribed value Integer type. Specify the reliability class. 0 Network subscribed value 1 Non real-time traffic and error-sensitive application that cannot cope with data loss 2 Non real-time traffic and error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic and error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic and error-sensitive application that can cope with data loss 5 Real-time traffic and error non-sensitive application that can cope with data loss Integer type. Specify the peak throughput class, in octets per second. 0 Network subscribed value 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) 8 Up to 128 000 (1024 kbit/s) 9 Up to 256 000 (2048 kbit/s) Integer type. Specify the mean throughput class, in octets per second. 0 Network subscribed value 1 100 (about 0.22 bit/s) 2 200 (about 0.44 bit/s) 3 500 (about 1.11 bit/s) 4 1 000 (about 2.2 bit/s) 5 2 000 (about 4.4 bit/s) EG512R&EM1x0R_Series_AT_Commands_Manual 146 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 6 5 000 (about 11.1 bit/s) 7 10 000 (about 22 bit/s) 8 20 000 (about 44 bit/s) 9 50 000 (about 111 bit/s) 10 100 000 (about 0.22 kbit/s) 11 200 000 (about 0.44 kbit/s) 12 500 000 (about 1.11 kbit/s) 13 1000 000 (about 2.2 kbit/s) 14 2 000 000 (about 4.4 kbit/s) 15 5 000 000 (about 11.1 kbit/s) 16 10 000 000 (about 22 kbit/s) 17 20 000 000 (about 44 kbit/s) 18 50 000 000 (about 111 kbit/s) 31 Best effort Error codes. For more details, please refer to Table 11. 9.5. AT+CGACT Activate or Deactivate PDP Contexts This command activates or deactivates the specified PDP context(s). After the command has completed, the MT will remain in V.250 command state. If any PDP context is already in the requested state, the state for that context will remain unchanged. If MT is not PS attached when the activation form of the command is executed, MT will first perform a PS attach and then attempt to activate the specified contexts. If there is no specifying a particular context, it will activate or deactivate all defined contexts. AT+CGACT Activate or Deactivate PDP Contexts Test Command AT+CGACT=? Response +CGACT: (list of supported s) Read Command AT+CGACT? OK Response +CGACT: , […] Write Command AT+CGACT=, OK Response OK Or NO CARRIER If there is any error related to MT functionality: +CME ERROR: EG512R&EM1x0R_Series_AT_Commands_Manual 147 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 150 s, determined by network. / Parameter Integer type. Indicates the state of PDP context activation. 0 Deactivated 1 Activated Integer type. Specify a particular PDP context definition (see AT+CGDCONT) Error codes. For more details, please refer to Table 11. Example AT+CGDCONT=4,'IP','UNINET' OK AT+CGACT=1,4 OK AT+CGACT? +CGACT: 1,1 +CGACT: 2,0 +CGACT: 3,0 +CGACT: 4,1 … OK AT+CGACT=0,4 OK //Define a PDP context. //Activated the PDP. //Query the current PDP context state. //Deactivated the PDP. 9.6. AT+CGDATA Enter Data State The Write Command causes the MT to perform whatever actions that are necessary to establish communication between the TE and the network using one or more packet domain PDP types. This may include performing a PS attach and one or more PDP context activations. Any commands following the AT+CGDATA in the AT command line shall not be processed by MT. If the value is unacceptable to MT, MT shall return an ERROR or +CME ERROR. Otherwise, the MT issues the intermediate result code CONNECT and enters V.250 online data state. After data transfer is completed, and the layer 2 protocol termination procedure has been completed successfully, the V.250 EG512R&EM1x0R_Series_AT_Commands_Manual 148 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual command state is re-entered and the MT returns the final result code OK. AT+CGDATA Enter Data State Test Command AT+CGDATA=? Response +CGDATA: (list of supported s) Write Command AT+CGDATA=, OK Response CONNECT Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter String type. Indicates the layer 2 protocol to be used between TE and MT: 'PPP' Point to Point protocol for a PDP such as IP Integer type. Specify a particular PDP context definition (see AT+CGDCONT). Error codes. For more details, please refer to Table 11. 9.7. AT+CGPADDR Show PDP Addresses The Execution/Write Command returns a list of PDP addresses for the specified context identifiers. If no is specified, the addresses for all defined contexts are returned. AT+CGPADDR Show PDP Address Test Command AT+CGPADDR=? Response +CGPADDR: (list of defined s) Execution/Write Command AT+CGPADDR=[[,[,…]]] OK Response +CGPADDR: , […] EG512R&EM1x0R_Series_AT_Commands_Manual 149 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Or ERROR 300 ms / Parameter Integer type. Specify a particular PDP context definition (see AT+CGDCONT). String type. Identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by the AT+CGDCONT command when the context was defined. For a dynamic address it will be the one assigned during the last PDP context activation that used the context definition referred to by . is omitted if no address is available. Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' OK //Define a PDP context. //Activated the PDP. //Show the PDP address. 9.8. AT+CGREG GPRS Network Registration Status This command queries the network registration status and controls the presentation of an unsolicited result code +CGREG: when =1 and there is a change in the MT’s GPRS network registration status in GERAN/UTRAN, or unsolicited result code +CGREG: [,[],[],[]] when =2 and there is a change of the network cell in GERAN/UTRAN. AT+CGREG Network Registration Status Test Command AT+CGREG=? Response +CGREG: (range of supported s) OK EG512R&EM1x0R_Series_AT_Commands_Manual 150 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Read Command AT+CGREG? Write Command AT+CGREG=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response +CGREG: ,[,[],[],[]] OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved by executing AT&W after this command is issued. Parameter Integer type. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CGREG: 2 Enable network registration and location information unsolicited result code: +CGREG: [,,[,]] Integer type. Indicate the GPRS registration status. 0 Not registered, MT is not currently searching an operator to register to. The UE is in GMM state GMM-NULL or GMM-DEREGISTERED-INITIATED. The GPRS service is disabled; the UE is allowed to attach for GPRS if requested by the user. 1 Registered, home network. The UE is in GMM state GMM-REGISTERED or GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED on the home PLMN. 2 Not registered, but MT is currently trying to attach or searching an operator to register to. The UE is in GMM state GMM-DEREGISTERED or GMM-REGISTERED-INITIATED. The GPRS service is enabled, but an allowable PLMN is currently not available. The UE will start a GPRS attach as soon as an allowable PLMN is available. 3 Registration denied. The UE is in GMM state GMM-NULL. The GPRS service is disabled; and the UE is not allowed to attach for GPRS if requested by the user. 4 Unknown (e.g. out of GERAN/UTRAN coverage) 5 Registered, roaming String type. Two bytes location area code in hexadecimal format (e.g. '00C3' equals 195 in decimal) String type. Four byte (UMTS/LTE) cell ID in hexadecimal format. Integer type. Access technology selected. 2 UTRAN 4 UTRAN W/HSDPA EG512R&EM1x0R_Series_AT_Commands_Manual 151 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA Example AT+CGREG=2 OK AT+CGATT=0 OK +CGREG: 2 AT+CGATT=1 OK +CGREG: 2,1,'D5D5','8054BBF',6 9.9. AT+CGEREP Packet Domain Event Reporting This command enables/disables sending of unsolicited result codes +CGEV: XXX from MT to TE in the case of certain events occurring in the Packet Domain MT or the network. controls the processing of unsolicited result codes specified within this command. controls the effect on buffered codes when 1 or 2 is specified. AT+CGEREP Packet Domain Event Reporting Test Command AT+CGEREP=? Response +CGEREP: (range of supported s),(list of supported s) Read Command AT+CGEREP? OK Response +CGEREP: , Write Command AT+CGEREP=[[,]] Execution Command AT+CGEREP OK Or ERROR Response OK Or ERROR Response OK EG512R&EM1x0R_Series_AT_Commands_Manual 152 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 300 ms / Parameter Integer type. 0 Buffer unsolicited result codes in the MT; if MT result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE. 1 Discard unsolicited result codes when MT-TE link is reserved (e.g. in on-line data mode); otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the MT when MT-TE link is reserved (e.g. in on-line data mode) and flush them to the TE when MT-TE link becomes available; otherwise forward them directly to the TE. Integer type. 0 MT buffer of unsolicited result codes defined within this command is cleaned when 1 or 2 is specified. 1 MT buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is specified (OK response shall be given before flushing the codes). NOTES The unsolicited result codes and the corresponding events are defined as follows: 1. +CGEV: REJECT ,: A network request for PDP context activation occurred when the MT was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. Note: This event is not applicable for EPS and 5GS. 2. +CGEV: NW REACT ,,[]: The network has requested a context reactivation. The used to reactivate the context is provided if known to the MT. Note: This event is not applicable for EPS. 3. +CGEV: NW DEACT ,,[]: The network has forced a context deactivation. The used to activate the context is provided if known to the MT. 4. +CGEV: ME DEACT ,,[]: The mobile equipment has forced a context deactivation. The used to activate the context is provided if known to the MT. 5. +CGEV: NW DETACH: The network has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 6. +CGEV: ME DETACH: The mobile equipment has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 7. +CGEV: NW CLASS : The network has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). EG512R&EM1x0R_Series_AT_Commands_Manual 153 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 8. +CGEV: ME CLASS : The mobile equipment has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 9. +CGEV: PDN ACT : Activated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. 10. +CGEV: PDN DEACT : Deactivated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. Parameters are described as follows: Srting type. Packet data protocol type. A string parameter which specifies the type of packet data protocol. 'IP' IPv4 'PPP' PPP 'IPV6' IPv6 'IPV4V6' IPv4v6 String type. Identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP. Integer type. PDP context identifier. Specify a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of AT+CGDCONT. String type. Indicate the GPRS mobile class. A Class A (highest) B Class B C Class C in GPRS and circuit switched alternate mode CG Class C in GPRS only mode CC Class C in circuit switched only mode (lowest) Example AT+CGEREP=? +CGEREP: (0-2),(0,1) //Test command OK AT+CGEREP? +CGEREP: 0,0 OK AT+CGEREP=2,1 OK AT+CGACT=1,2 OK //Activated a context. +CGEV: PDN ACT2 AT+CGACT=0,2 //Deactivated a context. EG512R&EM1x0R_Series_AT_Commands_Manual 154 / 227 OK +CGEV: PDN DEACT2 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 9.10. AT+CGSMS Select Service for MO SMS Messages This command specifies the service or service preference that the MT will use to send MO (mobile originated) SMS messages. AT+CGSMS Select Service for MO SMS Messages Test Command AT+CGSMS=? Response +CGSMS: (range of currently available s) Read Command AT+CGSMS? OK Response +CGSMS: Write Command AT+CGSMS= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. Indicates the service or service preference to be used. 0 Packet domain 1 Circuit switched 2 Packet domain preferred (use circuit switched if GPRS not available) 3 Circuit switch preferred (use Packet Domain if circuit switched not available) Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 155 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 9.11. AT+CEREG EPS Network Registration Status This command queries the network registration status and controls the presentation of an unsolicited result code +CEREG: when =1 and there is a change in the MT’s EPS network registration status in E-UTRAN, or unsolicited result code +CEREG: [,[],[],[]] when =2 and there is a change of the network cell in E-UTRAN. AT+CEREG EPS Network Registration Status Test Command AT+CEREG=? Response +CEREG: (range of supported s) Read Command AT+CEREG? OK Response +CEREG: ,[,,[,]] Write Command AT+CEREG=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved by executing AT&W after this command is issued. Parameter Integer type. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CEREG: 2 Enable network registration and location information unsolicited result code: +CEREG: [,,[,]] Integer type. Indicate the EPS registration status. 0 Not registered, MT is not currently searching an operator to register to 1 Registered, home network 2 Not registered, but MT is currently trying to attach or searching an operator to register to 3 Registration denied 4 Unknown (e.g. out of E-UTRAN coverage) 5 Registered, roaming EG512R&EM1x0R_Series_AT_Commands_Manual 156 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual String type. Two-byte tracking area code in hexadecimal format. String type. Four-byte (E-UTRAN) cell ID in hexadecimal format. Access technology selected. 7 E-UTRAN 9.12. AT+QGDCNT Packet Data Counter This command allows the application to check how much bytes are sent to or received by the MT. AT+QGDCNT Packet Data Counter Test Command AT+QGDCNT=? Response +QGDCNT: (list of supported s) Read Command AT+QGDCNT? OK Response +QGDCNT: , Write Command AT+QGDCNT= OK Response OK Or ERROR Maximum Response Time Characteristics Reference If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. The operation on the data counter. 0 Reset the data counter 1 Save results of the data counter to NVM. If results need to be automatically saved, please refer to AT+QAUGDCNT Integer type. The amount of sent bytes. Integer type. The amount of received bytes. Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 157 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual NOTE When the MT is powered on, and will be loaded from results of the data counter in NVM. The default result in NVM is 0. Example AT+QGDCNT=? +QGDCNT: (0,1) //Test command. OK AT+QGDCNT? //Query the current bytes sent and received. +QGDCNT: 3832,4618 OK AT+QGDCNT=1 OK AT+QGDCNT=0 OK //Save the results to NVM. //Reset counter. 9.13. AT+QAUGDCNT Auto Save Packet Data Counter This command allows AT+QGDCNT to save results to NVM automatically. AT+QAUGDCNT Auto Save Packet Data Counter Test Command AT+QAUGDCNT=? Response +QAUGDCNT: (list of supported s) Read Command AT+QAUGDCNT? OK Response +QAUGDCNT: Write Command AT+QAUGDCNT= OK Response OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300 ms EG512R&EM1x0R_Series_AT_Commands_Manual 158 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Characteristics / Reference Parameter Integer type. The parameter is the time-interval for AT+QGDCNT to save results to NVM automatically. If it is set to 0, auto-save feature would be disabled. Range: 0, 30–65535; Default: 0; Unit: second. Error codes. For more details, please refer to Table 11. Example AT+QAUGDCNT=? //Test command. +QAUGDCNT: (0,30-65535) OK AT+QAUGDCNT=35 OK AT+QAUGDCNT? +QAUGDCNT: 35 //Set to 35. //Query the interval of auto-save. OK EG512R&EM1x0R_Series_AT_Commands_Manual 159 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 10 Supplementary Service Commands 10.1. AT+CCFC Call Forwarding Number and Conditions Control This command allows control of the call forwarding supplementary service according to 3GPP TS 22.082 [4]. Registration, erasure, activation, deactivation and status query are supported. AT+CCFC Call Forwarding Number and Conditions Control Test Command AT+CCFC=? Response +CCFC: (range of supported s) Write Command AT+CCFC=,[,[,[,[,[,[,]]]]]] OK Response If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully (only in connection with =0–3): For registered call forwarding numbers: +CCFC: ,[,,[,,[,]]] [+CCFC: ,[,,[,,[,]]] [...]] OK If no call forwarding number is registered (and therefore all classes are inactive): +CCFC: , OK EG512R&EM1x0R_Series_AT_Commands_Manual 160 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. 0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All call forwarding (see 3GPP TS 22.030 [19]) 5 All conditional call forwarding (see 3GPP TS 22.030 [19]) Integer type. 0 Disable 1 Enable 2 Query status 3 Registration 4 Erasure String type. Phone number of forwarding address in format specified by . Integer type. Type of address (refer 3GPP TS 24.008 [8] subclause 10.5.4.7). Default: 145 when dialing string includes international access code character '+'; otherwise 129. String type. Sub-address in the format specified by . Integer type. Type of sub-address octet (refer to 3GPP TS 24.008 [8] subclause 10.5.4.8). Default: 128. Integer type. Each represents a class of information. 1 Voice (telephony) 2 Data (refers to all bearer services; and this may only refer to some bearer services if TA does not support values 16, 32, 64 and 128 with =2) 4 Fax (facsimile services) 7 Voice, data and fax 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization 64 Dedicated packet access 128 Dedicated PAD access Integer type. When 'no reply', 'all call forwarding' or 'all conditional call forwarding' is enabled or queried, this gives the time to wait before call is forwarded. Range: 1–30. Default 20. Unit: second. EG512R&EM1x0R_Series_AT_Commands_Manual 161 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Integer type. 0 Not active 1 Active Error codes. For more details, please refer to Table 11. Example AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,255 OK //Register the destination number for unconditional call forwarding (CFU). //Query the status of CFU without specifying . //Erase the registered CFU destination number. //Query the status and there is no destination number. 10.2. AT+CCWA Call Waiting Control This command allows control of the call waiting supplementary service according to 3GPP TS 22.083 [5]. Activation, deactivation and status query are supported. AT+CCWA Call Waiting Control Test Command AT+CCWA=? Response +CCWA: (list of supported s) Read Command AT+CCWA? OK Response +CCWA: Write Command AT+CCWA=[[,[,]]] OK Response If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully: +CCWA: , [+CCWA: , EG512R&EM1x0R_Series_AT_Commands_Manual 162 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 [...]] OK If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. 0 Disable presentation of an unsolicited result code 1 Enable presentation of an unsolicited result code Integer type. When is omitted, network is not interrogated. 0 Disable 1 Enable 2 Query status Integer type. Each integer represents a class of information. 1 Voice (telephony) 2 Data (refers to all bearer services; and this may only refer to some bearer services if TA does not support values 16, 32, 64 and 128 with =2) 4 Fax (facsimile services) 7 Voice, data and fax 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization 64 Dedicated packet access 128 Dedicated PAD access Integer type. 0 Not active 1 Active String type. Phone number of calling address in format specified by . Type of address octet in integer format. 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Optional string type alphanumeric representation of corresponding to the entry found in phonebook. Used character set should be the one selected with command select TE character set AT+CSCS. Integer type. Provide details why does not contain a calling party BCD number (see 3GPP TS 24.008 [8] subclause 10.5.4.30). EG512R&EM1x0R_Series_AT_Commands_Manual 163 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 0 CLI valid 1 CLI has been withheld by the originator (see 3GPP TS 24.008 [8] table 10.5.135a/3GPP TS 24.008 code 'Reject by user') 2 CLI is not available due to interworking problems or limitations of originating network (see 3GPP TS 24.008 [8] table 10.5.135a/3GPP TS 24.008 code 'Interaction with other service') 3 CLI is not available due to calling party being of type payphone (see 3GPP TS 24.008 [8] table 10.5.135a/3GPP TS 24.008 code 'Coin line/payphone') 4 CLI is not available due to other reasons (see 3GPP TS 24.008 [8] table 10.5.135a/3GPP TS 24.008 code 'Unavailable') When CLI is not available ( equals to 2, 3 or 4), shall be an empty string ('') and value will not be significant. Nevertheless, TA may return the recommended value 128 for (TON/NPI unknown in accordance with 3GPP TS 24.008 [8] subclause 10.5.4.7). When CLI has been withheld by the originator, (=1) and the CLIP is provisioned with the 'override category' option (see 3GPP TS 22.081 [3] and 3GPP TS 23.081 [40]), and is provided. Otherwise, TA shall return the same setting for and as if the CLI was not available. String type. Subaddress of format specified by . Integer type. Subaddress octet (see 3GPP TS 24.008 [8] subclause 10.5.4.8). Optional digit type parameter indicating that the eMLPP priority level of the incoming call. The priority level values are as defined in eMLPP specification 3GPP TS 22.067 [54]. Error codes. For more details, please refer to Table 11. NOTES 1. =0 should be returned only if the service is not active for any i.e. +CCWA: 0,7 will be returned in this case. 2. When =2, all active call waiting classes will be reported. In this mode the command is aborted by pressing any key. 3. Unsolicited result code: When the presentation call waiting at the MT is enabled (and call waiting is enabled) and a terminating call set up during an established call, an unsolicited result code is returned: +CCWA: ,,[,][,[,,[,]]] Example AT+CCWA=1,1 OK ATD10086; OK //Enable presentation of an unsolicited result code. //Establish a call. EG512R&EM1x0R_Series_AT_Commands_Manual 164 / 227 +CCWA: '02154450293',129,1 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual //Indication of a call that has been waiting. 10.3. AT+CHLD Call Related Supplementary Services This command allows the control of the following call related services: ⚫ A call can be temporarily disconnected from the MT but the connection is retained by the network; ⚫ Multiparty conversation (conference calls); ⚫ The served subscriber who has two calls (one held and the other either active or alerting) can connect the other parties and release the served subscriber’s own connection. Calls can be put on hold, recovered, released and added to a conversation, and transferred similarly as defined in 3GPP TS 22.030 [19]. This is based on the GSM/UMTS supplementary services HOLD (Call Hold; see 3GPP TS 22.083 [5] clause 2 and 3GPP TS 24.610 [135]), MPTY (MultiParty; see 3GPP TS 22.084 [22]) and ECT (Explicit Call Transfer; see 3GPP TS 22.091 [30] and 3GPP TS 24.629 [139]). The interaction of this command with other commands based on other GSM/UMTS supplementary services is described in the GSM/UMTS standards. Call Hold, MultiParty and Explicit Call Transfer are only applicable to teleservice 11. AT+CHLD Call Related Supplementary Services Test Command AT+CHLD=? Response +CHLD: (list of supported s) Write Command AT+CHLD=[] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. If it is ignored in Write Command, value 2 will be used. 0 Terminate all held calls or UDUB (User Determined User Busy) for a waiting call. If a EG512R&EM1x0R_Series_AT_Commands_Manual 165 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual call is waiting, terminate the waiting call. Otherwise, terminate all held calls (if any) 1 Terminate all active calls (if any) and accept the other call (waiting call or held call). 1X Terminate the specific call number X (X = 1–7) 2 Place all active calls on hold (if any) and accept the other call (waiting call or held call) as the active call. 2X Place all active calls except call X (X = 1–7) on hold 3 Add the held call to the active calls 4 Connect the two calls and disconnects the subscriber from both calls (ECT) Error codes. For more details, please refer to Table 11. Example ATD10086; OK +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129 +CLCC: 2,1,0,0,0,'02154450293',129 OK AT+CHLD=21 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 +CLCC: 2,1,1,0,1,'02154450293',129 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129 +CLCC: 2,1,0,0,1,'02154450293',129 OK //Establish a call. //Indication of a call that has been waiting. //Place the active call on hold and accept the waiting call as the active call. //The first call is on hold. //The second call is active. //Place the active call except call X = 1 on hold. //The first call is active. //The second call is on hold. //Add a held call to the active calls in order to set up a conference (multiparty) call. EG512R&EM1x0R_Series_AT_Commands_Manual 166 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 10.4. AT+CLIP Calling Line Identification Presentation This command refers to the GSM/UMTS supplementary service CLIP (Calling Line Identification Presentation) that enables a called subscriber to get the calling line identity (CLI) of the calling party when receiving a mobile terminated call. The Write Command enables or disables the presentation of the CLI at the TE. It has no effect on the execution of the supplementary service CLIP in the network: When =1, the presentation of the calling line identity at the TE is enabled and when the calling subscriber allows, the unsolicited result code +CLIP: ,[,,[,[][,]]] is returned after every RING (or +CRING: ; refer to AT+CRC) result code sent from TA to TE. It is manufacturer specific if this response is used when normal voice call is answered. The unsolicited result code +CLIP does not support numbers of the SIP URI format; When =0, the presentation of the calling line identity at the TE with unsolicited result code +CLIP is disabled. AT+CLIP Calling Line Identification Presentation Test Command AT+CLIP=? Response +CLIP: (list of supported s) Read Command AT+CLIP? OK Response +CLIP: , Write Command AT+CLIP=[] OK Response MT enables or disables the presentation of the calling line identity (CLI) at the TE. It has no effect on the execution of the supplementary service CLIP in the network. OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 15 s, determined by network. / Parameter Integer type. Configures/shows the result code presentation status to the TE. 0 Disable unsolicited result codes EG512R&EM1x0R_Series_AT_Commands_Manual 167 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 1 Enable unsolicited result codes Integer type. The subscriber CLIP service status in the network. 0 CLIP not provisioned 1 CLIP provisioned 2 Unknown (e.g. no network, etc.) String type. Phone number calling address in format specified by . String type. Sub-address of format specified by . Type of sub-address octet in integer format (see 3GPP TS 24.008 [8] subclause 10.5.4.8) Type of address octet in integer format. 129 Unknown type (IDSN format) 145 International number type (ISDN format) 161 National number Optional string type alphanumeric representation of corresponding to the entry found in phonebook. Used character set should be the one selected with command select TE character set AT+CSCS. Integer type. Provide details why does not contain a calling party BCD number (see 3GPP TS 24.008 [8] subclause 10.5.4.30). 0 CLI valid 1 CLI has been withheld by the originator (see 3GPP TS 24.008 [8] table 10.5.135a/3GPP TS 24.008 code 'Reject by user') 2 CLI is not available due to interworking problems or limitations of originating network (see 3GPP TS 24.008 [8] table 10.5.135a/3GPP TS 24.008 code 'Interaction with other service') 3 CLI is not available due to calling party being of type payphone (see 3GPP TS 24.008 [8] table 10.5.135a/3GPP TS 24.008 code 'Coin line/payphone') 4 CLI is not available due to other reasons (see 3GPP TS 24.008 [8] table 10.5.135a/3GPP TS 24.008 code 'Unavailable') When CLI is not available ( equals to 2, 3 or 4), shall be an empty string ('') and value will not be significant. Nevertheless, TA may return the recommended value 128 for (TON/NPI unknown in accordance with 3GPP TS 24.008 [8] subclause 10.5.4.7). When CLI has been withheld by the originator, (=1) and the CLIP is provisioned with the 'override category' option (see 3GPP TS 22.081 [3] and 3GPP TS 23.081 [40]), and is provided. Otherwise, TA shall return the same setting for and as if the CLI was not available. Error codes. For more details, please refer to Table 11. Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK EG512R&EM1x0R_Series_AT_Commands_Manual 168 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual RING ##0 +CLIP: '02151082965',129,,,'QUECTEL',0 10.5. AT+CLIR Calling Line Identification Restriction This command refers to the CLIR supplementary service (Calling Line Identification Restriction) according to 3GPP TS 22.081 [3] and the OIR supplementary service (Originating Identification Restriction) according to 3GPP TS 24.607 [119] that allows a calling subscriber to enable or disable the presentation of the calling line identity (CLI) to the called party when originating a call. The Write Command overrides the CLIR subscription (default is restricted or allowed) when temporary mode is provisioned as a default adjustment for all following outgoing calls. This adjustment can be revoked by using the opposite command. AT+CLIR Calling Line Identification Restriction Test Command AT+CLIR=? Response +CLIR: (range of supported s) Read Command AT+CLIR? OK Response +CLIR: , Write Command AT+CLIR= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 15 s, determined by network. / Parameter Integer type. Sets the adjustment for outgoing calls. 0 Presentation indicator is used according to the subscription of the CLIR service EG512R&EM1x0R_Series_AT_Commands_Manual 169 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 1 CLIR invocation 2 CLIR suppression Integer type. Shows the subscriber CLIR service status in the network. 0 CLIR not provisioned 1 CLIR provisioned in permanent mode 2 Unknown (e.g. no network, etc.) 3 CLIR temporary mode presentation restricted 4 CLIR temporary mode presentation allowed Error codes. For more details, please refer to Table 11. 10.6. AT+COLP Connected Line Identification Presentation This command enables/disables a calling subscriber to get the connected line identity (COL) of the called party after setting up a mobile originated call, referring to the GSM/UMTS supplementary service COLP (Connected Line Identification Presentation). The Write Command enables or disables the presentation of the COL (Connected Line) at the TE for a mobile originating a call. It has no effect on the execution of the supplementary service COLR in the network. When =1, the presentation of the connected line identity at the TE enabled and when the called subscriber allows the intermediate result code, +COLP: ,[,, [,]] is returned from TA to TE before any AT+CR or V.25ter responses. It is manufacturer specific if this response is used when normal voice call is established. The intermediate result code +COLP does not support numbers of the SIP URI format AT+COLP Connected Line Identification Presentation Test Command AT+COLP=? Response +COLP: (list of supported s) Read Command AT+COLP? OK Response +COLP: , Write Command AT+COLP=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 15 s, determined by network. / EG512R&EM1x0R_Series_AT_Commands_Manual 170 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter Integer type. Sets/presents the result code presentation status in the MT. 0 Disable 1 Enable Integer type. Parameter presents the subscriber COLP service status in the network. 0 COLP not provisioned 1 COLP provisioned 2 Unknown (e.g. no network, etc.) String type. Phone number calling address in format specified by . Integer type. Type of address octet in integer format. 129 Unknown type (IDSN format number) 145 International number type (ISDN format) String type. Sub-address of format specified by . Type of sub-address octet in integer format (see 3GPP TS 24.008 [8] subclause 10.5.4.8). Optional string type alphanumeric representation of corresponding to the entry found in phonebook. Used character set should be the one selected with command select TE character set AT+CSCS. Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK 10.7. AT+CSSN Supplementary Service Notifications The Write Command enables/disables the presentation of notification result codes from TA to TE. When =1 and a supplementary service notification is received after a mobile originated call setup, the intermediate result code +CSSI: [,[][,]] is sent to TE before any other MO call setup result codes. When =1 and a supplementary service notification is received during a mobile terminated call setup or during a call, or when a forward check supplementary service notification is received, unsolicited result code +CSSU: [,[,[],[][,[],[]][,]]] is EG512R&EM1x0R_Series_AT_Commands_Manual 171 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual sent to TE. AT+CSSN Supplementary Service Notifications Test Command AT+CSSN=? Response +CSSN: (list of supported s),(list of supported s) Read Command AT+CSSN? OK Response +CSSN: , Write Command AT+CSSN=[,] OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. Sets/shows the +CSSI intermediate result code presentation status to the TE. 0 Disable 1 Enable Integer type. Sets/shows the +CSSU unsolicited result code presentation status to the TE. 0 Disable 1 Enable Integer type. It is manufacturer specified and supports the following codes: 0 Unconditional call forwarding is active 1 Some of the conditional call forwarding are active 2 Call has been forwarded 3 Call is waiting 5 Outgoing calls are barred Integer type. It is manufacturer specific and supports the following codes: 0 This is a forwarded call (MT call setup) 2 Call has been put on hold (during a voice call) 3 Call has been retrieved (during a voice call) 5 Call on hold has been released (during a voice call) EG512R&EM1x0R_Series_AT_Commands_Manual 172 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 10 Additional incoming call forwarded Error codes. For more details, please refer to Table 11. 10.8. AT+CUSD Unstructured Supplementary Service Data This command allows control of the Unstructured Supplementary Service Data (USSD) according to 3GPP TS 22.090 [23], 3GPP TS 24.090 [148] and 3GPP TS 24.390 [131]. Both network and mobile initiated operations are supported. disables/enables the presentation of an unsolicited result code. The value =2 cancels an ongoing USSD session. For a USSD response from the network, or a network initiated operation, the format is: +CUSD: [,,[]]. When is given, a mobile initiated USSD string or a response USSD string to a network initiated operation is sent to the network. The response USSD string from the network is returned in a subsequent +CUSD URC. AT+CUSD Unstructured Supplementary Service Data Test Command AT+CUSD=? Response +CUSD: (range of supported s) Read Command AT+CUSD? OK Response +CUSD: Write Command AT+CUSD=[[,[,]]] OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 120 s, determined by the network. The command takes effect after rebooting. The configurations will be saved automatically. EG512R&EM1x0R_Series_AT_Commands_Manual 173 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter Integer type. Sets/presents the result code presentation status to the TE. 0 Disable the result code presentation to the TE 1 Enable the result code presentation to the TE 2 Cancel session (not applicable to Read Command response) String type. Unstructured Supplementary Service Data (USSD) to be sent to the network. If this parameter is omitted, network is not interrogated. String type. Unstructured Supplementary Service Data (USSD) received from the network Integer type. Indicates Cell Broadcast Data Coding Scheme (see 3GPP TS 23.038 [25]). Default: 15. Integer type. USSD response from the network or the network initiated operation. 0 No further user action required (network initiated USSD Notify, or no further information needed after mobile initiated operation) 1 Further user action required (network initiated USSD Request, or further information needed after mobile initiated operation) 2 USSD terminated by network 3 Another local client has responded 4 Operation not supported 5 Network time out Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 174 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 11 Audio Commands NOTE Audio related commands are supported by EG512R-EA only. 11.1. AT+CLVL Loudspeaker Volume Level Selection This command selects the volume level of the internal loudspeaker of the MT. AT+CLVL Loudspeaker Volume Level Selection Test Command AT+CLVL=? Response +CLVL: (list of supported s) Read Command AT+CLVL? OK Response +CLVL: Write Command AT+CLVL= OK Or ERROR Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. EG512R&EM1x0R_Series_AT_Commands_Manual 175 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter Integer type. Volume level with manufacturer specific range (Smallest value represents the lowest sound level). Range: 0–5. Default: 3. Error codes. For more details, please refer to Table 11. 11.2. AT+CMUT Mute Control This command enables/disables the uplink voice muting during a voice call. AT+CMUT Mute Control Test Command AT+CMUT=? Response +CMUT: (list of supported s) Read Command AT+CMUT? OK Response +CMUT: Write Command AT+CMUT= OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. 0 Mute off 1 Mute on Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 176 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 11.3. AT+QAUDLOOP Enable/Disable Audio Loop Test This command enables/disables audio loop test. AT+QAUDLOOP Enable/Disable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (list of supported s) Read Command AT+QAUDLOOP? OK Response +QAUDLOOP: Write Command AT+QAUDLOOP= Maximum Response Time Characteristics OK Response OK Or ERROR 300ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Enable or disable audio loop test. 0 Disable audio loop test 1 Enable audio loop test 11.4. AT+VTS DTMF and Tone Generation This command sends ASCII characters which cause MSC to transmit DTMF tones to a remote subscriber. This command can only be operated in a voice call. AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (list of supported s),(range of supported s) OK EG512R&EM1x0R_Series_AT_Commands_Manual 177 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Write Command AT+VTS=[,] Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: Depends on the length of and . / Parameter String type. ASCII characters in the set 0–9, #, *, A, B, C, D. The string should be enclosed in quotation marks ('...'). When sending multiple tones at a time, the time interval of two tones can be specified by AT+VTD. The maximal length of the string is 31 bytes. Integer type. The duration of each tone in 10 ms with tolerance. Range: 0–255. If the duration is less than the minimum time specified by the network, the actual duration will be the network specified time. If this parameter is omitted, is specified by AT+VTD. Error codes. For more details, please refer to Table 11. Example ATD12345678900; OK //Call connected AT+VTS='1' OK AT+VTS='1234567890A' OK //Dial. //The remote caller can hear the DTMF tone. //Send multiple tones at a time. EG512R&EM1x0R_Series_AT_Commands_Manual 178 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 11.5. AT+VTD Set Tone Duration This command sets the duration of DTMF tones. It can also set time interval of two tones when sending multiple tones at a time. AT+VTD Set Tone Duration Test Command AT+VTD=? Response +VTD: (range of supported s),(range of supported s) Read Command AT+VTD? OK Response +VTD: , Write Command AT+VTD=[,] OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms The command takes effect immediately. The parameters will not be saved. Parameter Integer type. The duration tone in 1/10 seconds with tolerance. Range: 0–255. Default: 3. If the duration is less than the minimum time specified by the network, the actual duration will be network specified time. Integer type. The time interval of two tones when sending multiple tones at a time by AT+VTS. Range: 0–255. Default: 0. Unit: 0.1 second. Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 179 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 11.6. AT+QAUDMOD* Set Audio Mode This command sets the audio mode required for the connected device. AT+QAUDMOD* Set Audio Mode Test Command AT+QAUDMOD=? Response +QAUDMOD: (range of supported s) Read command AT+QAUDMOD? OK Response +QAUDMOD: Write Command AT+QAUDMOD= OK Response OK Or ERROR Maximum Response Time Characteristics Reference Quectel If there is any error related to MT functionality: +CME ERROR: 300ms The command takes effect immediately. The parameters will not be saved. Parameter Integer type. The current audio mode. 0 Echo canceller, noise suppressor, digital gain and calibration parameter for handset 1 Echo canceller, noise suppressor, digital gain and calibration parameter for headset 2 Echo canceller, noise suppressor, digital gain and calibration parameter for speaker 3 Turn off all audio processing functions Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 180 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 11.7. AT+QDAI Digital Audio Interface Configuration This command configures the digital audio interface. When there is no codec on board, please define the PCM formats. In the following conditions, the MT can be used directly with default settings (master mode, short-synchronization, 2048 kHz clock frequency, 16-bit liner data format, 8 kHz sampling rate). AT+QDAI Digital Audio Interface Configuration Test Command AT+QDAI=? Response +QDAI: (list of supported s),(list of supported s),(list of supported s),(range of supported s),(list of supported s),(list of supported s),(range of supported s),(range of supported s),(range of supported s) Read Command AT+QDAI? OK Response +QDAI: [,,,,,,,[,]] Write Command AT+QDAI=[,,,[,[,[,,[,]]]]] OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics Reference Quectel The command takes effect after rebooting. The configurations will be saved automatically. Parameter x Unused (1–6 can be set) Integer type. 0 Master mode 1 Slave mode Integer type. 0 Primary mode (short-synchronization) 1 Auxiliary mode (long-synchronization) Integer type. Clock frequency. EG512R&EM1x0R_Series_AT_Commands_Manual 181 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 0 128 kHz 1 256 kHz 2 512 kHz 3 1024 kHz 4 2048 kHz 5 4096 kHz Integer type. Data format. 0 16-bit linear Integer type. 0 8 kHz 1 16 kHz Integer type. 1 Number of slot 2 Number of slot (Set to 2 when use ) Integer type. Slot mapping value. Range: 1–16. Integer type. Slot mapping value. Range: 2–16. NOTES 1. 4096 kHz clock frequency is only applicable for 16 kHz sampling rate. 2. 128 kHz clock frequency is not supported. 3. Bit per frame = /. For example, if is 2048 kHz and is 8 kHz, bit per frame will be 256. Bit per frame should be greater than 16. 4. When slave mode is selected, master and synchronization clock should be provided for the MT. 5. When a recommended codec is selected and 16 kHz sampling rate is desired, please input . Currently the MT only supports 16 kHz (AT+QDAI=x,0,0,5,0,1). Example AT+QDAI=? //Query the range. +QDAI: x,(0,1),(0,1),(0-5),(0),(0,1),(1-2),(1-16),(2-16) OK AT+QDAI? +QDAI: x,0,0,4,0,0,1,1 //Query the current interface configuration. OK AT+QDAI=x,1,0,4,0,0,1,1 OK AT+QDAI=x,0,0,4,0,1,1,1 //Set AUX PCM interface to slave, short-sync, 8 kHz sample, 2048kHz BCLK. //Configure one slot. OK AT+QDAI=x,0,0,4,0,1,2,1,3 //Configure two slots. EG512R&EM1x0R_Series_AT_Commands_Manual 182 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK 11.8. AT+QSIDET Set Side Tone Gain in Current Mode This command sets the side tone gain value in current mode. AT+QSIDET Set Side Tone Gain in Current Mode Test Command AT+QSIDET=? Response +QSIDET: (range of supported s) Read Command AT+QSIDET? OK Response +QSIDET: Write Command AT+QSIDET= Maximum Response Time Characteristics Reference Quectel OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Side tone gain in current mode. Range: 0–65535. Default value may be different in different audio modes. NOTE This command will be valid only after audio loop test is enabled by AT+QAUDLOOP=1. EG512R&EM1x0R_Series_AT_Commands_Manual 183 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 11.9. AT+QMIC Set Uplink Gains of Microphone This command sets the uplink gains of microphone. AT+QMIC Set Uplink Gains of Microphone Test Command AT+QMIC=? Response +QMIC: (range of supported s),(range of supported s) Read Command AT+QMIC? OK Response +QMIC: , Write Command AT+QMIC=[,] Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms It will take effect on next call. The parameters will not be saved. Parameter Integer type. Uplink codec gain. Range: 0–65535. The default value may be different in different audio modes. Integer type. Uplink digital gain. Range: 0–65535. The default value may be different in different audio modes. 11.10. AT+QIIC IIC Read and Write This command configures the codec via IIC interface. AT+QIIC IIC Read and Write Test Command AT+QIIC=? Response +QIIC: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) EG512R&EM1x0R_Series_AT_Commands_Manual 184 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual OK Write Command Response AT+QIIC=,,,[,] OK If all configuration parameters are omitted: +QIIC: Maximum Response Time Characteristics OK 300ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. 0 Write command 1 Read command Hex integer type. 0–0xFF 7-bit device address Hex Integer type. 0–0xFF Register address Integer type. 1 Read bytes 2 Write bytes Hex integer type. 0–0xFFFF Data value Example AT+QIIC=1,0x18,15,1,38 +QIIC: 0x0026 //Read 2-byte register content of the register’s location: slave address: 0x18, register address: 15. OK AT+QIIC=0,0x18,15,2,38 //Write 2-byte register content of the register’s location: slave address: 0x18, register address: 15. OK EG512R&EM1x0R_Series_AT_Commands_Manual 185 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 12 Hardware Related Commands 12.1. AT+QPOWD Power off This command powers off the MT. The UE will return OK immediately when the command is executed. Then the UE will deactivate the network. After it is completed, the UE outputs POWERED DOWN message and enters into power-off state. The maximum time for unregistering network is 60 seconds. To avoid data loss, the power supply for the module cannot be disconnected before the URC POWERED DOWN is outputted. AT+QPOWD Power off Test Command AT+QPOWD=? Response +QPOWD: (list of supported s) Write Command AT+QPOWD=[] OK Response OK Maximum Response Time Characteristics Reference POWERED DOWN 300 ms / Parameter Integer type. 0 Power off immediately 1 Power off normally EG512R&EM1x0R_Series_AT_Commands_Manual 186 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 12.2. AT+CCLK Clock This command sets or queries the real time clock (RTC) of the MT. The current setting is retained until the MT is totally disconnected from the power supply. AT+CCLK Clock Test Command AT+CCLK=? Read Command AT+CCLK? Response OK Response +CCLK: Write Command AT+CCLK= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300 ms / Parameter String type. The format is 'yy/MM/dd,hh:mm:ss±zz', indicating year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range: -48...+56). E.g. May 6th, 1994, 22:10:00 GMT+2 hours equals '94/05/06,22:10:00+08'. Error codes. For more details, please refer to Table 11. Example AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //Query the local time. EG512R&EM1x0R_Series_AT_Commands_Manual 187 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 12.3. AT+QADC Read ADC Value This command reads the voltage value of ADC channel. AT+QADC Read ADC Value Test Command AT+QADC=? Response +QADC: (range of supported s) Read Command AT+QADC= OK Response +QADC: , Maximum Response Time Characteristics OK 300 ms / Parameter Integer type. Channel number of the ADC. 0 ADC channel 0 1 ADC channel 1 2 ADC channel 2 Integer type. Indication to whether the ADC value read is successful. 0 Failed 1 Successful Integer type. The voltage of specified ADC channel. Unit: mV. 12.4. AT+QSCLK Sleep Mode Setting This command controls whether MT enters sleep mode. When entering into sleep mode is enabled, the MT can directly enter sleep mode. AT+QSCLK Sleep Mode Setting Test Command AT+QSCLK=? Response +QSCLK: (list of supported s) Read Command AT+QSCLK? OK Response +QSCLK: , EG512R&EM1x0R_Series_AT_Commands_Manual 188 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Write Command AT+QSCLK=[,] Maximum Response Time Characteristics Reference Quectel OK Response OK 300 ms / Parameter Integer type. Slow clock mode. 0 Disable sleep mode 1 Enable sleep mode. It is controlled by DTR. Integer type. Whether to save the configuration into NVM. 0 Not save 1 Save 12.5. AT+QTEMP Get the Temperature of MT This command gets the temperature of MT. AT+QTEMP Get the Temperature of MT Test Command AT+QTEMP=? Execution Command AT+QTEMP Response OK Response [+QTEMP: ,] […] OK Characteristics / Reference Quectel Parameter String type. Sensor type. 'aoss0-usr' Type of the first detection points on modem 'mdm-q6-usr' Type of the second detection points on modem EG512R&EM1x0R_Series_AT_Commands_Manual 189 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 'ipa-usr' Type of the third detection points on modem 'cpu0-a7-usr' Type of the forty detection points on modem 'mdm-core-usr' Type of the fifth detection points on modem 'xo-therm-usr' Type of XO crystal 'pa-therm2-usr' Type of PA chip 'sdx-case-therm-usr' Type of BB chip 'ambient-therm-usr' Type of NTC Integer type. Temperature value. Unit: °C. Example AT+QTEMP +QTEMP: 'aoss-usr','32' +QTEMP: 'mdm-q6-usr','33' +QTEMP: 'ddrss-usr','33' +QTEMP: 'cpu-usr','33' +QTEMP: 'mdm-core-usr','33' +QTEMP: 'xo-therm-adc','30' +QTEMP: 'pa-therm1-adc','24' +QTEMP: 'mdm-case-therm-adc','31' OK 12.6. AT+QAGPIO Set the AP Or PMU GPIO Output Value This command sets the AP or PMU GPIO output value. AT+QAGPIO Set The AP Or PMU GPIO Output Value Test Command AT+QAGPIO=? Response +QAGPIO: (list of supported s),,(list of supported s) OK EG512R&EM1x0R_Series_AT_Commands_Manual 190 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Write Command Response AT+QAGPIO=,, OK Maximum Response Time Characteristics 300 ms The command takes effect immediately; The configurations will be saved automatically. Parameter Integer type. Set up the AP or PMU. 0 AP 1 PMU Integer type. The GPIO number. Integer type. GPIO output value. 0 Set the GPIO output low 1 Set the GPIO output high NOTE PMU GPIO range is 1–11. Example AT+QAGPIO=? +QAGPIO: (0,1),,(0,1) OK AT+QAGPIO=0,105,1 OK AT+QAGPIO=1,8,0 OK //Test command. //Set the AP gpio_105 output high. //Set the PMU gpio_8 output low. EG512R&EM1x0R_Series_AT_Commands_Manual 191 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 12.7. AT+QSAR Enable/Disable the SAR Power Backoff This command enables or disables the SAR power backoff. AT+QSAR* Enable/Disable the SAR Power Backoff Test Command AT+QSAR=? Response +QSAR: (rang of supported s),(list of supported s) Read Command AT+QSAR? OK Response +QSAR: Write Command AT+QSAR=[,] OK Response OK Or ERROR Maximum Response Time Characteristics Reference If there is an error related to ME functionality: +CME ERROR: / / / Parameter Integer type. 0 Disable SAR power backoff. 1–8 SAR power backoff level. The value of the power backoff is determined by AT+QCFG='sarcfg'. Integer type. Whether to save the configuration into NVM. 0 Not save 1 Save Error codes. For more details, please refer to Table 11. EG512R&EM1x0R_Series_AT_Commands_Manual 192 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 12.8. AT+QETH RGMII Extended Configuration 12.8.1. AT+QETH=? AT+QETH Test Command AT+QETH RGMII Extended Configuration Test command AT+QETH=? Response List the settings supported currently: +QETH: 'rgmii',(list of supported s),(list of supported s),(range of supported s),(range of supported s) +QETH: 'ipptmac', +QETH: 'routing',(list of supported s),(list of supported s),,(range of supported s) +QETH: 'mac_address', +QETH: 'speed',(list of supported s) +QETH: 'an',(list of supported s) +QETH: 'dm',(list of supported s) OK ⚫NOTE Only EG512R-EA supports AT+QETH related commands. 12.8.2. AT+QETH='rgmii' Query/Enable/Disable RGMII This command queries/enables/disables RGMII. AT+QETH='rgmii' Query/Enable/Disable RGMII Write Command AT+QETH='rgmii'[,,[,[,]]] Response: 1. If , , or are omitted, query the current configuration: 1) If RGMII is disabled: +QETH: 'RGMII','disable',0,-1 +QETH: 'RGMII',0,1 +QETH: 'RGMII',0,2 +QETH: 'RGMII',0,3 +QETH: 'RGMII',0,4 OK 2) If RGMII is enabled, but there is no any data call: +QETH: 'RGMII','enable',0,-1 +QETH: 'RGMII',0,1 EG512R&EM1x0R_Series_AT_Commands_Manual 193 / 227 Maximum Response Time Characteristics LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual +QETH: 'RGMII',0,2 +QETH: 'RGMII',0,3 +QETH: 'RGMII',0,4 OK 3) If data call (COMMON mode) is performed with the first APN: +QETH: 'RGMII','enable',0,0 +QETH: 'RGMII',1,1 +QETH: 'RGMII',0,2 +QETH: 'RGMII',0,3 +QETH: 'RGMII',0,4 OK 4) If data call (IPPassthrough mode) is performed with the first APN: +QETH: 'RGMII','enable',0,1 +QETH: 'RGMII',1,1 +QETH: 'RGMII',0,2 +QETH: 'RGMII',0,3 +QETH: 'RGMII',0,4 OK 2. If and are omitted, enable or disable RGMII, without data call: OK 3. If is omitted, enable RGMII, with specified mode and default profile or disable all RGMII data call in the current mode: OK 4. If all parameters are specified, enable or disable RGMII, with specified mode and specified profile: OK 5. If there is any error: ERROR 20 s This command takes effect immediately; For information about whether the configuration will be saved automatically, refer to the notes below. EG512R&EM1x0R_Series_AT_Commands_Manual 194 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. RGMII status. 'enable' Enable RGMII function 'disable' Disable RGMII function Integer type. RGMII voltage mode. 0 Indicate that the TX Strength of RGMII is 1.8V. 1 Indicate that the TX Strength of RGMII is 2.5V Integer type. RGMII mode. -1 Empty mode (no any data call) 0 Call RGMII with COMMON-RGMII mode 1 Call RGMII with IPPassthrough-RGMII mode Integer type. Profile ID of RGMII data call. 1–8 The APN number used in RGMII data call. It is used in combination with AT+CGDCONT. ⚫NOTES 1. The two modes COMMON and IPPassthrough are mutually exclusive and cannot be enabled at the same time. If you need to enable the other, please disable the current one first. 2. When data call is performed with the second, third and fourth channels, the configuration for enabling/disabling RGMII will not be saved (that is, RGMII configuration will not work after the module is rebooted), but APN setting will be saved automatically; when data call is performed with the first channel, the configuration will be saved automatically, that is, the configuration will still work after the module is rebooted. 3. Before enabling IPPassthrough mode, you need to configure the MAC address through AT+QETH='ipptmac',. 4. Calling the command to perform data call for the first time will enable the corresponding RGMII mode and APN's first data call. Calling this command to perform data call for the second and third times will cause that the second and third data calls are performed. If you call this command for multiple times to perform data call without specifying the APN, the default APN of 1, 2, 3 and 4 will be used (up to 4 channels are supported at the same time). 6. Details of the read command are as follows: +QETH: 'RGMII',,, +QETH: 'RGMII',, +QETH: 'RGMII',, +QETH: 'RGMII',, +QETH: 'RGMII',, OK Example AT+QETH='rgmii' +QETH: 'RGMII','disable',0,-1 //Query the status of RGMII. EG512R&EM1x0R_Series_AT_Commands_Manual 195 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual +QETH: 'RGMII',0,1 +QETH: 'RGMII',0,2 +QETH: 'RGMII',0,3 +QETH: 'RGMII',0,4 OK AT+QETH='rgmii','enable',1 OK AT+QETH='rgmii','enable',1,0 OK AT+QETH='rgmii','enable',1,0,1 OK AT+QETH='rgmii','enable',1,1 OK AT+QETH='rgmii','enable',1,1,1 OK //Enable RGMII without data call. //Enable RGMII data call of COMMON mode and perform data call with the default APN. //Enable RGMII data call of COMMON mode and perform data call with the first APN. //Enable RGMII data call of IPPassthrough mode and perform data call with the default APN. //Enable RGMII data call of IPPassthrough mode and perform data call with the first APN. 12.8.3. AT+QETH='ipptmac' Set IPPassthrough-RGMII MAC Address This command sets IPPassthrough-RGMII MAC address. AT+QETH='ipptmac' Set IPPassthrough-RGMII MAC Address Write Command Response AT+QETH='ipptmac'[,<host_mac_ad If is omitted, query the current dr>] configuration: +QETH: 'ipptmac', OK Maximum Response Time If no any omitted, configure the mac address for RGMII: OK If any error, return: ERROR 100 ms EG512R&EM1x0R_Series_AT_Commands_Manual 196 / 227 Characteristics Parameter LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual This command takes effect at enabling RGMII data call of IPPassthrough mode next time; The configuration will be saved automatically. String type. Mac address of the device connected to the module. Example AT+QETH='ipptmac', a1:b2:c3:d4:e5:f6 //Set the current MAC address of IPPassthrough mode. OK AT+QETH='ipptmac' +QETH: ' ipptmac ', a1:b2:c3:d4:e5:f6 //Query the current MAC address of IPPassthrough mode. OK 12.8.4. AT+QETH='routing' Set Routing Rules for Multiple Data Call This command is used to set the routing rules of the multiple data call. AT+QETH='routing' Set Routing Rules for Multiple Data Call Write Command AT+QETH='routing'[,,,,] Response: If , , and is omitted, query the current route: +QETH: route IPv4: …… +QETH: route IPv6: …… OK If all parameters are specified, set the current route: OK Maximum Response Time Characteristics If there is any error: ERROR 200 ms The command takes effect immediately; The configuration will not be saved. EG512R&EM1x0R_Series_AT_Commands_Manual 197 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. Option type. add add route del del route Integer type. IP version. 4 IPv4 6 IPv6 String type. Destination IP address. 8.8.8.8 IPv4 example 240C::6666 IPv6 example Integer type. RGMII data call profileID. 1–8 The APN sequence number used by the data call connection specified by the current route rule. Example AT+QETH='routing' //Query the current route list. +QETH: route IPv4: Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface default 10.151.9.244 0.0.0.0 UG 0 0 0 rmnet_data0 10.151.9.240 * 255.255.255.248 U 0 0 0 rmnet_data0 61.132.163.68 * 255.255.255.255 UH 10 0 0 rmnet_data0 192.168.225.0 * 255.255.255.0 U 0 0 0 bridge0 202.102.213.68 * 255.255.255.255 UH 10 0 0 rmnet_data0 +QETH: route IPv6: Kernel IPv6 routing table Destination Next Hop Flags Metric Ref Use Iface ::1/128 :: U 256 1 0 lo 240e:46:4088::4088/128 :: U 10 1 0 rmnet_data0 240e:46:4888::4888/128 :: U 10 1 0 rmnet_data0 240e:9a:114:20dc::/64 :: U 1024 1 0 bridge0 fe80::/64 :: U 256 1 0 bridge0 fe80::/64 :: U 256 1 0 rmnet_data0 ::/0 :: U 256 1 0 rmnet_data0 ::/0 :: !n -1 1 1 lo ::1/128 :: Un 0 2 0 lo 240e:9a:114:20dc::/128 :: Un 0 2 0 rmnet_data0 240e:9a:114:20dc:6c57:8d2d:6bcd:7dca/128 :: Un 0 2 0 rmnet_data0 fe80::/128 :: Un 0 2 0 bridge0 fe80::/128 :: Un 0 2 0 rmnet_data0 fe80::1a20:8c46:9e00:c3ea/128 :: Un 0 3 1 rmnet_data0 fe80::cc53:9ff:fe13:1b87/128 :: Un 0 2 0 bridge0 EG512R&EM1x0R_Series_AT_Commands_Manual 198 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual ff00::/8 :: U 256 2 ff00::/8 :: U 256 2 ::/0 :: !n -1 1 1 37 bridge0 7 rmnet_data0 lo OK AT+QETH='routing',add,4,8.8.8.8,3 OK //Add a route to route list. 12.8.5. AT+QETH='mac_address' Query RGMII Interface MAC Address This command is used to query RGMII interface MAC address. AT+QETH='mac_address' Query RGMII Interface MAC Address Query Command AT+QETH='mac_address' Response +QETH: 'mac_address', Maximum Response Time Characteristics OK 200 ms / Parameter String type. MAC address of RGMII interface of the module. Example AT+QETH='mac_address' //Query the MAC address of RGMII interface. +QETH: 'mac_address',06:EA:9F:31:49:28 OK 12.8.6. AT+QETH='speed' Set the Speed for RGMII This command configures the speed for RGMII. AT+QETH='speed' Set the Speed for RGMII Write Command AT+QETH='speed'[,] Response If is omitted, query the current configuration: +QETH: 'speed', OK EG512R&EM1x0R_Series_AT_Commands_Manual 199 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics If is specified, configure the speed for RGMII: OK If there is any error: ERROR 100 ms This command takes effect after RGMII function is restarted; The configuration will be saved automatically. Parameter String type. RGMII speed. '0M' Auto negotiation speed (will be set to 1000M automatically) '10M' 10 Mbps Ethernet '100M' 100 Mbps Ethernet '1000M' 1000 Mbps Ethernet Example AT+QETH='speed' +QETH: 'speed','0M' OK AT+QETH='speed','100M' OK //Query the current configuration. //Set RGMII speed to 100M. 12.8.7. AT+QETH='an' Enable or Disable Auto-negotiation for RGMII This command enables or disables the auto-negotiation status for RGMII. AT+QETH='an' Enable or Disable Auto-negotiation for RGMII Write Command AT+QETH='an'[,] Response If is omitted, query the current configuration: +QETH: 'an', OK If is specified, enable or disable RGMII auto-negotiation: OK EG512R&EM1x0R_Series_AT_Commands_Manual 200 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Maximum Response Time Characteristics If there is any error: ERROR 100 ms This command takes effect after RGMII function is restarted; The configuration will be saved automatically. Parameter String type. RGMII auto-negotiation status. 'on' Indicate that the RGMII is working at auto-negotiation mode. 'off' Indicate that the RGMII is working at non-auto-negotiation mode. Example AT+QETH='an' +QETH: 'an','on' OK AT+QETH='an','off' OK //Query the current configuration. //Disable RGMII auto negotiation. 12.8.8. AT+QETH='dm' Set the Duplex Mode for RGMII This command sets the duplex mode for RGMII. AT+QETH='dm' Set the Duplex Mode for RGMII Write Command AT+QETH='dm'[,] Response If is omitted, query the current configuration: +QETH: 'dm', OK If is specified, set the duplex mode for RGMII: OK Maximum Response Time Characteristics If there is any error: ERROR 100 ms This command takes effect after RGMII function is restarted; The configuration will be saved automatically. EG512R&EM1x0R_Series_AT_Commands_Manual 201 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Parameter String type. RGMII duplex mode. 'full' Indicate that the RGMII is working at full duplex mode. 'half' Indicate that the RGMII is working at half duplex mode. Example AT+QETH='dm' +QETH: 'dm','full' OK AT+QETH='dm','half' OK //Query the current configuration. //Set half duplex mode for RGMII. EG512R&EM1x0R_Series_AT_Commands_Manual 202 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 13 Appendix A References 13.1. References Table 6: Related Documents SN Document Name Remark [1] V.25ter Serial asynchronous automatic dialing and control Digital cellular telecommunications (Phase 2+); Universal Mobile [2] 3GPP TS 27.007 Telecommunications System (UMTS); LTE; AT command set for User Equipment (UE) Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; Use of Data Terminal [3] 3GPP TS 27.005 Equipment–Data Circuit terminating Equipment (DTE-DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Table 7: Terms and Abbreviations Abbreviation AMR APN ADC AMF BAOC BER BOIC BS Description Adaptive Multi-Rate Access Point Name Analog To Digital Converter Access and Mobility Management Function Bar All Outgoing Calls Bit Error Rate Bar Outgoing International Calls Base Station EG512R&EM1x0R_Series_AT_Commands_Manual 203 / 227 CBM CCIP CSD DCD DCE DTE DTMF DTR DRB ECC ECT EN-DC E-RAB eMBB GGSN GPRS IRA IWF ME mmWave MS MSC mMTC MT NVM LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Cell Broadcast Message Calling Line Identification Presentation Circuit Switch Data Dynamic Content Delivery Data Communication Equipment Data Terminal Equipment Dual Tone Multi Frequency Data Terminal Ready Data Radio Bearer Emergency Call Codes Explicit Call Transfer supplementary service E-UTRA NR Dual Connectivity E-UTRAN Radio Access Bearer Enhanced mobile broadband Gateway GPRS Support Node General Packet Radio Service International Reference Alphabet InterWorking Function Mobile Equipment Millimeter Wave Mobile Station Mobile Switching Center Massive connections Mobile Terminal Non-Volatile Memory EG512R&EM1x0R_Series_AT_Commands_Manual 204 / 227 NSSAI PDN PDP PDU PSC QoS RAN RGMII RLP RP RRC RTS/CTS SAR SGSN SM SMS SMSC SA TA TCP TE UCS UDP UE URC URLLC LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Network Slice Selection Assistance Information Public Data Network Packet Data Protocol Protocol Data Unit Primary Synchronization Code Quality of Service Radio Access Network Reduced Gigabit Media Independent Interface Radio Link Protocol Relay Protocol Radio Resource Control Request To Send/Clear To Send Specific Absorption Rate Serving GPRS Support Node Short Message Short Message Service Short Message Service Center Standalone Terminal Adapter Transmission Control Protocol Terminal Equipment Universal Coded Character Set User Datagram Protocol User Equipment Unsolicited Result Code Low latency and high reliability EG512R&EM1x0R_Series_AT_Commands_Manual 205 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 13.2. Factory Default Settings Restorable with AT&F Table 8: Factory Default Settings Restorable with AT&F AT Command ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT+CREG AT+CGREG AT+CBST AT+CMEE AT+CSCS AT+CSTA AT+CR AT+CRC AT+CSMS Parameters ,, ,,, Factory Defaults 1 0 0 13 10 8 2 0 2 15 1 4 0 0 0,0,1 1 'GSM' 129 0 0 0,1,1,1 EG512R&EM1x0R_Series_AT_Commands_Manual 206 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+CVHU AT+CLIP AT+COLP AT+CLIR AT+CSSN AT+CTZR AT+CPBS AT+CGEREP AT+CEREG AT+CCWA AT+CUSD AT+CLVL AT+QAUDMOD AT+QAUDLOOP ,,, ,, ,, ,,,, , 0 17,167,0,0 0 0,'','' 'ME','ME','ME' 2,1,0,0,0 0 0 0 0 0 0,0 0 SM 0,0 0 0 0 3 0 0 EG512R&EM1x0R_Series_AT_Commands_Manual 207 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 13.3. AT Command Settings Storable with AT&W Table 9: AT Command Settings Storable with AT&W AT Command ATE ATQ ATS0 ATS7 ATS10 ATV ATX AT+CREG AT+CGREG AT+CEREG AT+QSIMSTAT Parameters Display with AT&V Yes Yes Yes Yes Yes Yes Yes No No No No 13.4. AT Command Settings Storable with ATZ Table 10: AT Command Settings Storable with ATZ AT Command ATE ATQ ATS0 ATS7 Parameters Factory Defaults 1 0 0 0 EG512R&EM1x0R_Series_AT_Commands_Manual 208 / 227 ATS10 ATV ATX AT+CREG AT+CGREG AT+CEREG LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 15 1 4 0 0 0 13.5. Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation of +CME ERROR: final result code is similar to the regular ERROR result code: if +CME ERROR: is the result code for any of the commands in a command line, none of the following commands in the same command line is executed (neither ERROR nor OK result code shall be returned as a result of a completed command line execution). The following table lists most of general and GRPS related error codes. For some GSM protocol failure cause described in GSM specifications, the corresponding error codes are not included. Table 11: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 10 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted EG512R&EM1x0R_Series_AT_Commands_Manual 209 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 11 (U)SIM PIN required 12 (U)SIM PUK required 13 (U)SIM failure 14 (U)SIM busy 15 (U)SIM wrong 16 Incorrect password 17 (U)SIM PIN2 required 18 (U)SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required EG512R&EM1x0R_Series_AT_Commands_Manual 210 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 13.6. Summary of CMS ERROR Codes Final result code +CMS ERROR: indicates an error related to message service failure. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code should be returned. values are mostly used by common message commands: Table 12: Different Coding Schemes of +CMS ERROR: Code of 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 Meaning ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode (U)SIM not inserted (U)SIM pin necessary PH (U)SIM pin necessary (U)SIM failure (U)SIM busy (U)SIM wrong (U)SIM PUK required (U)SIM PIN2 required (U)SIM PUK2 required Memory failure Invalid memory index Memory full SMSC address unknown EG512R&EM1x0R_Series_AT_Commands_Manual 211 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 331 No network 332 Network timeout 500 Unknown 512 (U)SIM not ready 513 Message length exceeds 514 Invalid request parameters 515 ME storage failure 517 Invalid service mode 528 More message to send state error 529 MO SMS is not allowed 531 ME storage full 13.7. Summary of URC Table 13: Summary of URC Index URC Display Meaning Condition 1 +CREG: Indicate registration status of the MT AT+CREG=1 After cell neighborhood changing +CREG: [,,[,< shows whether the network has 2 AT+CREG=2 AcT>]] currently indicated the registration of the MT, with location area code 3 +CGREG: Indicate network registration status of AT+CGREG=1 the MT +CGREG: [,[],[],[],[]] location information of the MT 5 +CTZV: Time zone reporting AT+CTZR=1 6 +CTZE: ,, Extended time zone reporting AT+CTZR=2 7 +CMTI: , New message is received, and saved See AT+CNMI to memory 8 +CMT: [], output directly to TE (PDU mode) +CMT: ,[],[,,,,, New short message is received and 9 See AT+CNMI ,,] +CBM: < New CBM is received and output 10 See AT+CNMI pdu> directly (PDU mode) +CBM: ,,,, +CDS: directly (PDU mode) +CDS: ,,[],[],,, directly to TE (Text mode) 14 +CDSI: , New message status report is See AT+CNMI received, and saved to memory +COLP: ,,[< The presentation of the COL 15 subaddr>],[],[] mobile originated call +CLIP: ,,[su 16 baddr],[satype],[], An incoming call is indicated to the 17 +CRING: TE with unsolicited result code AT+CRC=1 instead of the normal RING +CCWA: ,,< 18 Call waiting indication class>[,] AT+CCWA=1,1 19 +CSSI: Shows the +CSSI intermediate result AT+CSSN=1 code presentation status to the TE 20 +CSSU: Shows the +CSSU unsolicited result AT+CSSN=,1 code presentation status to the TE 21 RDY MT initialization is successful N/A 22 +CFUN: 1 All function of the MT is available N/A 23 +CPIN: (U)SIM card pin state N/A 24 +QIND: SMS DONE SMS initialization finished N/A 25 +QIND: PB DONE Phonebook initialization finished N/A 26 POWERED DOWN Module power down AT+QPOWD +CGEV: REJECT , and was automatically rejected. EG512R&EM1x0R_Series_AT_Commands_Manual 213 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual +CGEV: NW REACT ,,[] reactivation AT+CGEREP=2,1 +CGEV: NW DEACT ,,[] deactivation +CGEV: ME DEACT ,,[] deactivation. AT+CGEREP=2,1 31 +CGEV: NW DETACH The network has forced a Packet AT+CGEREP=2,1 Domain detach. 32 +CGEV: ME DETACH The mobile equipment has forced a AT+CGEREP=2,1 Packet Domain detach. +CGEV: NW CLASS MS class. The mobile equipment has forced a 34 +CGEV: ME CLASS AT+CGEREP=2,1 change of MS class. 35 +QTEMP: , Temperature information See AT+QTEMP 13.8. SMS Character Sets Conversions In 3GPP TS 23.038 DCS (Data Coding Scheme) defined three kinds of alphabets in SMS, GSM 7-bit default alphabet, 8-bit data and UCS2 (16-bit). AT+CSMP can set the DCS in text mode (AT+CMGF=1). In text mode, DCS (Data Coding Scheme) and AT+CSCS determine the way of SMS text input or output. Table 14: The Way of SMS Text Input or Output DCS GSM 7-bit GSM 7-bit GSM 7-bit UCS2 8-bit AT+CSCS GSM IRA UCS2 - The Way of SMS Text Input or Output Input or output GSM character sets. Input or output IRA character sets. Input: UE will convert IRA characters to GSM characters. Output: UE will convert GSM characters to IRA characters. Input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Input: UE will convert the UCS2 hex string to GSM characters. Output: UE will convert the GSM characters to UCS2 hex string. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. EG512R&EM1x0R_Series_AT_Commands_Manual 214 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual When DCS = GSM 7-bit, the input or output needs conversion. The detailed conversion tables are shown as below. Table 15: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') No. 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0A Submit 2A 3A 4A 5A 6A 7A B 0B Cancel 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 16: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') No. 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 EG512R&EM1x0R_Series_AT_Commands_Manual 215 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B 0B 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 17: GSM Extended Characters (GSM Encode) No. 0 1 2 3 4 5 6 7 0 1B40 1 2 3 4 1B14 5 6 7 8 1B28 EG512R&EM1x0R_Series_AT_Commands_Manual 216 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 9 1B29 A B C 1B3C D 1B3D E 1B3E F 1B2F Table 18: The Input Conversions Table (DCS = GSM 7-bit and AT+CSCS='IRA') No. 0 1 2 3 4 5 6 0 20 20 30 00 50 20 1 20 20 21 31 41 51 61 2 20 20 22 32 42 52 62 3 20 20 23 33 43 53 63 4 20 20 02 34 44 54 64 5 20 20 25 35 45 55 65 6 20 20 26 36 46 56 66 7 20 20 27 37 47 57 67 8 backspace 20 28 38 48 58 68 9 20 20 29 39 49 59 69 A 0A Submit 2A 3A 4A 5A 6A B 20 Cancel 2B 3B 4B 1B3C 6B C 20 20 2C 3C 4C 1B2F 6C D 0D 20 2D 3D 4D 1B3E 6D E 20 20 2E 3E 4E 1B14 6E F 20 20 2F 3F 4F 11 6F 7 70 71 72 73 74 75 76 77 78 79 7A 1B28 1B40 1B29 1B3D 20 EG512R&EM1x0R_Series_AT_Commands_Manual 217 / 227 Table 19: IRA Extended Characters No. A B 0 20 20 1 40 20 2 20 20 3 01 20 4 24 20 5 03 20 6 20 20 7 5F 20 8 20 20 9 20 20 A 20 20 B 20 20 C 20 20 D 20 20 E 20 20 F 20 60 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual C D E F 20 20 7F 20 20 5D 20 7D 20 20 20 08 20 20 20 20 5B 20 7B 20 0E 20 0F 20 1C 5C 1D 7C 09 20 20 20 20 0B 04 0C 1F 20 05 06 20 20 20 20 20 20 20 20 20 5E 07 7E 20 20 20 20 20 20 20 20 20 1E 20 20 Table 20: The Output Conversions Table (DCS = GSM 7-bit and AT+CSCS='IRA') No. 0 1 2 3 4 5 6 7 0 40 20 20 30 A1 50 BF 70 1 A3 5F 21 31 41 51 61 71 2 24 20 22 32 42 52 62 72 3 A5 20 23 33 43 53 63 73 4 E8 20 A4 34 44 54 64 74 5 E9 20 25 35 45 55 65 75 EG512R&EM1x0R_Series_AT_Commands_Manual 218 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual 6 F9 20 26 36 46 56 66 76 7 EC 20 27 37 47 57 67 77 8 F2 20 28 38 48 58 68 78 9 C7 20 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B D8 2B 3B 4B C4 6B E4 C F8 C6 2C 3C 4C D6 6C F6 D 0D E6 2D 3D 4D D1 6D F1 E C5 DF 2E 3E 4E DC 6E FC F E5 C9 2F 3F 4F A7 6F E0 Table 21: GSM Extended Characters (ISO-8859-1/Unicode) No. 0 1 2 3 4 5 6 7 0 7C 1 2 3 4 5E 5 6 7 8 7B 9 7D A B EG512R&EM1x0R_Series_AT_Commands_Manual 219 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual C 5B D 7E E 5D F 5C Because the low 8-bit of UCS2 character is the same as the IRA character: ⚫ The conversion table of DCS = GSM 7-bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. ⚫ The conversion table of fmt = GSM 7-bit and AT+CSCS='GSM' is similar to AT+CSCS='GSM'. ⚫ The conversion table of fmt = GSM 7-bit and AT+CSCS='IRA' is similar to AT+CSCS='IRA'. ⚫ The conversion table of fmt = GSM 7-bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. The difference is the way of SMS text input or output. Please refer to Table 14 for more details. 13.9. Release Cause Report List of AT+CEER Table 22: Release Cause Report List of AT+CEER CS Internal Cause No cause information available (default) Phone is offline No service available Network release, no reason given Received incoming call Client ended call UIM not present Access attempt already in progress Access failure, unknown source Concur service not supported by network EG512R&EM1x0R_Series_AT_Commands_Manual 220 / 227 No response received from network GPS call ended for user call SMS call ended for user call Data call ended for emergency call Rejected during redirect or handoff Lower-layer ended call Call origination request failed Client rejected incoming call Client rejected setup indication Network ended call No funds available No service available Full service not available Maximum packet calls exceeded Video connection lost Video protocol closed after setup Video protocol setup failure Internal error CS Network Cause Unassigned/unallocated number No route to destination Channel unacceptable Operator determined barring Normal call clearing User busy LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual EG512R&EM1x0R_Series_AT_Commands_Manual 221 / 227 No user responding User alerting, no answer Call rejected Number changed Non selected user clearing Destination out of order Invalid/incomplete number Facility rejected Response to status enquiry Normal, unspecified No circuit/channel available Network out of order Temporary failure Switching equipment congestion Access information discarded Requested circuit/channel not available Resources unavailable, unspecified Quality of service unavailable Requested facility not subscribed Incoming calls barred within the CUG Bearer capability not authorized Bearer capability not available Service/option not available Bearer service not implemented ACM >= ACM max LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual EG512R&EM1x0R_Series_AT_Commands_Manual 222 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Requested facility not implemented Only RDI bearer is available Service/option not implemented Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Recovery on timer expiry Protocol error, unspecified Interworking, unspecified CS Network Reject IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME GPRS services not allowed GPRS and non GPRS services not allowed EG512R&EM1x0R_Series_AT_Commands_Manual 223 / 227 MS identity cannot be derived Implicitly detached PLMN not allowed Location area not allowed Roaming not allowed GPRS services not allowed in PLMN No suitable cells in location area MSC temporary not reachable Network failure MAC failure Synch failure Congestion GSM authentication unacceptable Service option not supported Requested service option not subscribed Service option temporary out of order Call cannot be identified No PDP context activated Semantically incorrect message Invalid mandatory information Message type non-existent Message type not compatible with state Information element non-existent Message not compatible with state RR release indication LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual EG512R&EM1x0R_Series_AT_Commands_Manual 224 / 227 RR random access failure RRC release indication RRC close session indication RRC open session failure Low level failure Low level failure no redial allowed Invalid SIM No service Timer T3230 expired No cell available Wrong state Access class blocked Abort message received Other cause Timer T303 expired No resources Release pending Invalid user data PS Internal Cause Invalid connection identifier Invalid NSAPI Invalid primary NSAPI PDP establish timeout Invalid field SNDCP failure LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual EG512R&EM1x0R_Series_AT_Commands_Manual 225 / 227 RAB setup failure No GPRS context PDP activate timeout PDP modify timeout PDP inactive max timeout PDP lower layer error PDP duplicate Access technology change PDP unknown reason CS PS Network Cause LLC or SNDCP failure Insufficient resources Missing or unknown APN Unknown PDP address or PDP type User authentication failed Activation rejected by GGSN Activation rejected, unspecified Service option not supported Requested service option not subscribed Service option temporary out of order NSAPI already used (not sent) Regular deactivation QoS not accepted Network failure Reactivation required LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual EG512R&EM1x0R_Series_AT_Commands_Manual 226 / 227 LTE-A Module Series EG512R&EM1x0R Series AT Commands Manual Feature not supported Semantic error in the TFT operation Syntactical error in the TFT operation Unknown PDP context PDP context without TFT already activated Semantic errors in packet filter Syntactical errors in packet filter Invalid transaction identifier Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Protocol error, unspecified EG512R&EM1x0R_Series_AT_Commands_Manual 227 / 227

RG200U&Rx500U 系列 AT 命令手册 5G 模块系列 版本：1.1 日期：2024-02-02 状态：受控文件 上海移远通信技术股份有限公司 1 / 273 RGx00U&RM500U 系列 AT 命令手册 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 273 RGx00U&RM500U 系列 AT 命令手册 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 273 RGx00U&RM500U 系列 AT 命令手册 文档历史 修订记录 版本 1.0 1.1 日期 2020-09-18 2022-06-30 2024-02-02 作者 变更表述 Larson ZHANG Neil SHI/ Gale GAO/ Rami ZHANG/ Wayen XU/ Romeo SONG Rami ZHANG/ Gale GAO/ Wayen XU/ Romeo SONG/ John ZHAI/ Xudong MAO/ Craig GAN/ Jeffery JIANG 文档创建 受控版本 1. 更新如下 AT 命令的返回值： AT+QCFG（第 3.3 章） AT+QCFG='usbcfg'（第 3.3.3 章） AT+QSIMLOCK（第 4.14 章） AT+QENG（第 5.9 章） AT+QLTS（第 5.13 章） AT+QNWLOCK（第 5.14 章） AT+QSLIC（第 12.4 章） 2. 更新 AT+QCFG='uartat'的特性说明（第 3.3.7 章） 3. 新增 AT+CLCK、AT+CPIN 的特性说明（第 4.2 和 4.3 章）。 4. 更新 AT+QCFG='usbmode'的特性说明和参数解 释（第 3.3.17 章）。 5. 新 增 AT+QCFG='usbnet'的 参数 （ 第 3.3.1 章 节）。 6. 更新 AT+CTZR 中的参数默认值（第 5.7 章）。 7. 更新 AT+QENG 中的参数范围（第 5.9 章）。 8. 更 新 AT+C5GQOS 和 AT+C5GQOSRDP 中 的参数解释（第 9.12 章和第 9.13 章）。 9. 更新 AT+QTTS 的参数解释（第 11.12 章）。 上海移远通信技术股份有限公司 3 / 273 RGx00U&RM500U 系列 AT 命令手册 10. 新增如下 AT 命令： AT+QCFG='lanip_ex'（第 3.3.13 章） AT+QCFG='netmask'（第 3.3.19 章） AT+QCFG='tts'（第 3.3.20 章） AT+QCFG='pm/powersave'（第 3.3.21 章） AT+ QNWLOCKFREQ（第 5.15 章） AT+QNTP（第 5.17 章） AT+QDMZ（第 5.18 章） AT+QNWCFG（第 5.20 章） AT+QAUDRD（第 11.9 章） AT+QAUDPLAY（第 11.10 章） AT+QAUDSTOP（第 11.11 章） AT+QTTS（第 11.12 章） AT+QTTSETUP（第 11.13 章） AT+QAUDCFG（第 11.14 章） AT+QFUPL（第 12.8 章） AT+QFDEL（第 12.9 章） 上海移远通信技术股份有限公司 4 / 273 RGx00U&RM500U 系列 AT 命令手册 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 5 表格索引 ..................................................................................................................................................... 11 1 引言 ..................................................................................................................................................... 12 1.1. 本章概要 ................................................................................................................................... 12 1.2. AT 命令语句.............................................................................................................................. 12 1.2.1. 定义 ............................................................................................................................... 12 1.2.2. AT 命令语句................................................................................................................... 12 1.2.3. AT 命令响应................................................................................................................... 13 1.2.4. AT 示例声明................................................................................................................... 14 1.3. 支持的字符集............................................................................................................................ 14 1.4. AT 命令端口.............................................................................................................................. 14 1.5. 未经请求的结果码 .................................................................................................................... 14 1.6. 关闭程序 ................................................................................................................................... 15 2 通用命令 .............................................................................................................................................. 16 2.1. ATI 查询产品型号 ID 和固件版本信息 ..................................................................................... 16 2.2. AT+GMI 查询制造商 ID ........................................................................................................... 17 2.3. AT+GMM 查询产品型号 ID...................................................................................................... 17 2.4. AT+GMR 查询产品固件版本号................................................................................................ 18 2.5. AT+CGMI 查询制造商 ID......................................................................................................... 18 2.6. AT+CGMM 查询产品型号 ID ................................................................................................... 19 2.7. AT+CGMR 查询产品固件版本号 ............................................................................................. 19 2.8. AT+GSN 查询国际移动设备识别码（IMEI 号）...................................................................... 20 2.9. AT+CGSN 查询国际移动设备识别码（IMEI 号） ................................................................... 21 2.10. AT&F 重置 AT 命令设置为出厂设置 ........................................................................................ 21 2.11. AT&W 存储当前设置到用户自定义配置文件 ........................................................................... 22 2.12. ATZ 从用户自定义配置文件中还原设备通信参数.................................................................... 22 2.13. ATV 设置 MT 响应格式............................................................................................................ 23 2.14. ATE 设置命令回显模式............................................................................................................ 24 2.15. A/ 重复上一个命令行 ............................................................................................................... 25 2.16. ATS3 设置命令行终止符 ......................................................................................................... 25 2.17. ATS4 设置响应格式字符 ......................................................................................................... 26 2.18. ATS5 设置命令行编辑字符 ...................................................................................................... 26 2.19. AT+CFUN 设置功能模式 ......................................................................................................... 27 2.20. AT+CMEE 设置错误讯息格式 ................................................................................................. 29 2.21. AT+CSCS 选择 TE 字符集 ...................................................................................................... 30 2.22. AT+QURCCFG 配置 URC 输出端口 ....................................................................................... 31 3 状态控制命令....................................................................................................................................... 33 3.1. AT+CPAS 查询 ME 活动状态 .................................................................................................. 33 3.2. AT+CEER 查询扩展错误报告.................................................................................................. 34 上海移远通信技术股份有限公司 5 / 273 RGx00U&RM500U 系列 AT 命令手册 3.3. AT+QCFG 扩展配置 ................................................................................................................ 35 3.3.1. AT+QCFG='usbnet' 配置 USB 网卡驱动类型 ............................................................. 36 3.3.2. AT+QCFG='nat' 配置网卡拨号模式............................................................................. 37 3.3.3. AT+QCFG='usbcfg' 查询/设置 USB 设备信息............................................................. 38 3.3.4. AT+QCFG='ims' 启用/禁用 IMS .................................................................................. 39 3.3.5. AT+QCFG='pcie/mode' 配置 PCIe RC/EP 模式 ......................................................... 40 3.3.6. AT+QCFG='ethernet' 禁用/启用 Ethernet 网卡 ........................................................... 41 3.3.7. AT+QCFG='uartat' 配置主串口 AT 功能 ...................................................................... 42 3.3.8. AT+QCFG='usbid' 配置 USB 设备的供应商 ID 和产品 ID........................................... 43 3.3.9. AT+QCFG='multiusbnet' 配置 NCM 网卡多路拨号 ..................................................... 43 3.3.10. AT+QCFG='usbmac' 查询 NCM 网卡多路拨号通道的 MAC 地址 ....................... 45 3.3.11. AT+QCFG='staticarp' 配置静态 ARP .......................................................................... 46 3.3.12. AT+QCFG='lanip' 配置网关地址和子网掩码及租期............................................. 47 3.3.13. AT+QCFG='lanip_ex' 拓展配置网关地址和子网掩码及租期................................ 48 3.3.14. AT+QCFG='loopback' 启用/禁用回环 .................................................................. 50 3.3.15. AT+QCFG='5glan' 启用/禁用 5G LAN 功能 ......................................................... 50 3.3.16. AT+QCFG='autoapn' 启用/禁用 APN 自适应功能 ............................................... 51 3.3.17. AT+QCFG='usbmode' 配置 USB 主从模式 ......................................................... 52 3.3.18. AT+QCFG='rp_filter' 配置反向路由检查功能 ....................................................... 53 3.3.19. AT+QCFG='netmask' 启用/禁用动态子网掩码 .................................................... 54 3.3.20. AT+QCFG='tts' 启用/禁用 TTS 功能 .................................................................... 55 3.3.21. AT+QCFG='pm/powersave' 设置模块业务态下的功耗模式 ................................ 55 3.4. AT+QINDCFG 控制 URC 上报 ................................................................................................ 56 4 (U)SIM 卡相关命令.............................................................................................................................. 59 4.1. AT+CIMI 查询 IMSI.................................................................................................................. 59 4.2. AT+CLCK 功能锁定................................................................................................................. 60 4.3. AT+CPIN PIN 管理 .................................................................................................................. 62 4.4. AT+CPWD 修改密码 ............................................................................................................... 64 4.5. AT+CSIM 通用(U)SIM 卡访问 ................................................................................................. 65 4.6. AT+CRSM 受限(U)SIM 卡访问................................................................................................ 66 4.7. AT+CCID 查询(U)SIM 卡 EF-ICCID 信息 ................................................................................ 67 4.8. AT+QCCID 查询(U)SIM 卡 EF-ICCID 信息 ............................................................................. 68 4.9. AT+QPINC 获取 PIN 剩余重试次数 ........................................................................................ 69 4.10. AT+QINISTAT 查询(U)SIM 卡初始化状态 ............................................................................... 70 4.11. AT+QSIMDET 控制(U)SIM 卡检测.......................................................................................... 71 4.12. AT+QUIMSLOT 切换物理(U)SIM 卡槽.................................................................................... 72 4.13. AT+QSIMSTAT (U)SIM 卡插拔状态上报 ................................................................................. 73 4.14. AT+QSIMLOCK 配置功能锁 ................................................................................................... 75 5 网络服务命令....................................................................................................................................... 77 5.1. AT+COPS 选择运营商 ............................................................................................................ 77 5.2. AT+CREG CS 域注册状态 ...................................................................................................... 79 5.3. AT+CSQ 查询信号强度和信道误码率 ..................................................................................... 81 5.4. AT+CPOL 配置首选运营商列表 .............................................................................................. 82 上海移远通信技术股份有限公司 6 / 273 RGx00U&RM500U 系列 AT 命令手册 5.5. AT+COPN 查询运营商名称 ..................................................................................................... 84 5.6. AT+CTZU 自动更新时区 ......................................................................................................... 84 5.7. AT+CTZR 上报时区变化 ......................................................................................................... 86 5.8. AT+QNWINFO 查询网络信息 ................................................................................................. 87 5.9. AT+QENG 查询服务小区和邻区信息 ...................................................................................... 89 5.10. AT+QNWPREFCFG 配置网络搜索偏好 ................................................................................. 94 5.10.1. AT+QNWPREFCFG='gw_band' 配置 WCDMA 频段 .......................................... 95 5.10.2. AT+QNWPREFCFG='lte_band' 配置 LTE 频段 ................................................... 96 5.10.3. AT+QNWPREFCFG='nr5g_band' 配置 5G NR 频段........................................... 97 5.10.4. AT+QNWPREFCFG='all_band_reset' 重置所有制式频段设置 ........................... 98 5.10.5. AT+QNWPREFCFG='mode_pref' 配置网络搜索模式 ......................................... 98 5.10.6. AT+QNWPREFCFG='srv_domain' 配置服务域................................................... 99 5.10.7. AT+QNWPREFCFG='voice_domain' 配置语音域 ............................................. 100 5.10.8. AT+QNWPREFCFG='ue_usage_setting' 配置 UE 使用模式 ............................ 101 5.10.9. AT+QNWPREFCFG='roam_pref' 配置漫游偏好 ............................................... 102 5.11. AT+QREJINFO 查询网络拒绝原因 ....................................................................................... 103 5.12. AT+QSPN 查询运营商名称 ................................................................................................... 105 5.13. AT+QLTS 获取通过网络同步的最新时间 .............................................................................. 106 5.14. AT+QNWLOCK 锁定/解锁 LTE/5G 频点和小区 .................................................................... 107 5.15. AT+QNWLOCKFREQ 锁定或解锁 LTE/5G 频点 .................................................................. 109 5.16. AT+QCAINFO 查询载波聚合参数 ..........................................................................................111 5.17. AT+QENDC 查询 EN-DC 状态 .............................................................................................. 112 5.18. AT+QNTP 通过 NTP 服务器同步时间 ................................................................................... 113 5.19. AT+QDMZ 设置 DMZ 配置 .................................................................................................... 115 5.20. AT+QNWCFG 查询网络参数 ................................................................................................ 117 5.20.1. AT+QNWCFG='lte_ulMCS' 查询 LTE 上行 MCS 和调制类型............................ 117 2. 该命令暂不支持查询，查询结果用'-'代替。 ................................................. 118 5.20.2. AT+QNWCFG='lte_dlMCS' 查询 LTE 下行 MCS 和调制类型............................ 119 5.20.3. AT+QNWCFG='lte_csi' 查询 LTE CSI 信息 ....................................................... 120 5.20.4. AT+QNWCFG='nr5g_ulMCS' 查询 NR5G 上行 MCS 和调制类型..................... 121 5.20.5. AT+QNWCFG='nr5g_dlMCS' 查询 NR5G 下行 MCS 和调制类型..................... 122 5.20.6. AT+QNWCFG='nr5g_csi' 查询 NR5G CSI 信息 ................................................ 123 6 呼叫相关命令..................................................................................................................................... 125 6.1. ATA 呼叫应答......................................................................................................................... 125 6.2. ATD 发起呼叫 ........................................................................................................................ 126 6.3. ATH 挂断现有连接................................................................................................................. 127 6.4. AT+CHUP 挂断通话 .............................................................................................................. 128 6.5. ATS0 设置自动应答前振铃次数............................................................................................. 128 6.6. ATS7 设置呼叫建立完成的等待时间 ..................................................................................... 129 6.7. AT+CSTA 选择号码地址类型................................................................................................. 130 6.8. AT+CLCC 查询当前呼叫 ....................................................................................................... 131 6.9. AT+CRC 设置来电指示扩展格式........................................................................................... 132 6.10. AT+QECCNUM 配置紧急呼叫号码 ....................................................................................... 134 6.11. AT^DSCI 设置主动上报呼叫状态 .......................................................................................... 135 上海移远通信技术股份有限公司 7 / 273 RGx00U&RM500U 系列 AT 命令手册 7 电话本相关命令 ................................................................................................................................. 138 7.1. AT+CNUM 查询本机号码 ...................................................................................................... 138 7.2. AT+CPBR 读取电话本........................................................................................................... 139 7.3. AT+CPBS 设置电话本存储器 ................................................................................................ 140 7.4. AT+CPBW 写入电话本.......................................................................................................... 141 8 短消息相关命令 ................................................................................................................................. 143 8.1. AT+CSMS 选择短消息服务类型............................................................................................ 143 8.2. AT+CMGF 配置短消息模式................................................................................................... 144 8.3. AT+CSCA 设置短消息服务中心地址 ..................................................................................... 145 8.4. AT+CPMS 配置短消息存储器 ............................................................................................... 146 8.5. AT+CMGD 删除短消息.......................................................................................................... 148 8.6. AT+CMGL 按照状态读取短消息............................................................................................ 149 8.7. AT+CMGR 按照索引读取短消息 ........................................................................................... 152 8.8. AT+CMGS 发送短消息.......................................................................................................... 155 8.9. AT+CMMS 发送多条短消息 .................................................................................................. 157 8.10. AT+CMGW 存储短消息......................................................................................................... 158 8.11. AT+CMSS 从存储器发送短消息............................................................................................ 160 8.12. AT+CNMA 新短消息确认....................................................................................................... 161 8.13. AT+CNMI 设置新短消息上报方式 ......................................................................................... 163 8.14. AT+CSCB 选择小区广播消息类型 ........................................................................................ 165 8.15. AT+CSDH 设置文本模式下参数显示..................................................................................... 166 8.16. AT+CSMP 设置短消息文本模式参数 .................................................................................... 167 9 分组域命令 ........................................................................................................................................ 169 9.1. AT+CGATT PS 域附着/去附着 .............................................................................................. 169 9.2. AT+CGDCONT 定义 PDP 上下文 ......................................................................................... 170 9.3. AT+CGQREQ 服务质量参数（请求的）............................................................................... 173 9.4. AT+CGACT PDP 上下文激活/去激活.................................................................................... 176 9.5. AT+CGDATA 进入数传状态................................................................................................... 177 9.6. AT+CGPADDR 显示 PDP 地址 ............................................................................................. 178 9.7. AT+CGREG GPRS 网络注册状态......................................................................................... 179 9.8. AT+CGEREP 分组域事件上报 .............................................................................................. 181 9.9. AT+CGSMS 选择 MO 短消息服务 ........................................................................................ 184 9.10. AT+CEREG EPS 网络注册状态 ............................................................................................ 184 9.11. AT+C5GREG 5GS 网络注册状态.......................................................................................... 186 9.12. AT+C5GQOS 设置 5GS 服务质量 ........................................................................................ 188 9.13. AT+C5GQOSRDP 查询 5GS 动态 QoS 参数........................................................................ 189 9.14. AT+C5GNSSAI 设置 5GS 默认 NSSAI ................................................................................. 191 9.15. AT+C5GPNSSAI 设置 5GS 优选 NSSAI............................................................................... 192 9.16. AT+QNETDEVCTL 执行/断开网卡拨号 ................................................................................ 194 9.17. AT+QNETDEVSTATUS 查询网卡状态.................................................................................. 195 9.18. AT+QICSGP 配置 PDP 上下文参数 ...................................................................................... 196 9.19. AT+QGDCNT 流量统计......................................................................................................... 198 9.20. AT+QAUGDCNT 设置自动保存流量信息的时间间隔 ........................................................... 199 上海移远通信技术股份有限公司 8 / 273 RGx00U&RM500U 系列 AT 命令手册 10 补充业务命令..................................................................................................................................... 200 10.1. AT+CCFC 呼叫转移 .............................................................................................................. 200 10.2. AT+CCWA 呼叫等待控制 ...................................................................................................... 202 10.3. AT+CHLD 呼叫相关补充业务 ................................................................................................ 205 10.4. AT+CLIP 主动上报来电号码.................................................................................................. 206 10.5. AT+CLIR 主叫号码限制......................................................................................................... 208 10.6. AT+COLP 被接线识别显示.................................................................................................... 209 10.7. AT+CSSN 补充业务通知 ....................................................................................................... 210 10.8. AT+CUSD 非结构化补充数据业务 ........................................................................................ 212 10.9. AT+CGU 扩展会议电话 ......................................................................................................... 213 11 音频命令 ............................................................................................................................................ 215 11.1. AT+CMUT 控制静音 .............................................................................................................. 215 11.2. AT+QAUDLOOP 启用/禁用音频循环测试 ............................................................................. 216 11.3. AT+VTS 生成 DTMF 音 ......................................................................................................... 217 11.4. AT+VTD 设置 DTMF 音持续时间 .......................................................................................... 218 11.5. AT+QAUDMOD 设置音频模式 .............................................................................................. 219 11.6. AT+QMIC 设置麦克风的上行增益 ......................................................................................... 220 11.7. AT+CLVL 设置扬声器的音量等级.......................................................................................... 221 11.8. AT+QIIC 读写 IIC................................................................................................................... 222 11.9. AT+QAUDRD 录制音频文件 ................................................................................................. 223 11.10. AT+QAUDPLAY 播放本地音频文件 ...................................................................................... 225 11.11. AT+QAUDSTOP 停止播放音频文件 ..................................................................................... 226 11.12. AT+QTTS 播放文本............................................................................................................... 227 11.13. AT+QTTSETUP 设置播放速度或调节播放音量 .................................................................... 229 11.14. AT+QAUDCFG 查询和配置音频流程 .................................................................................... 230 11.14.1. AT+QAUDCFG='slic/LF_Ring' 设置/查询 SLIC 芯片的线路状态寄存器............ 231 11.14.2. AT+QAUDCFG='slic_IndRep' 启用/禁用 SLIC 模拟话机的事件上报功能 ......... 232 12 硬件相关命令..................................................................................................................................... 234 12.1. AT+QPOWD 关闭模块 .......................................................................................................... 234 12.2. AT+CCLK 实时时钟............................................................................................................... 235 12.3. AT+QADC 查询 ADC 值 ........................................................................................................ 236 12.4. AT+QSLIC 启用/禁用 SLIC ................................................................................................... 236 12.5. AT+QDOWNLOAD 进入下载模式......................................................................................... 238 12.6. AT+QPRTPARA 还原用户配置信息 ...................................................................................... 239 12.7. AT+IPR 设置串口波特率 ....................................................................................................... 240 12.8. AT+QFUPL 上传文件到存储媒介 .......................................................................................... 241 12.9. AT+QFDEL 删除存储媒介中的文件 ...................................................................................... 243 13 附录 ................................................................................................................................................... 245 13.1. 参考文档 ................................................................................................................................. 245 13.2. 术语缩写 ................................................................................................................................. 245 13.3. CME ERROR 错误码汇总 ...................................................................................................... 252 13.4. CMS ERROR 错误码汇总 ...................................................................................................... 254 13.5. AT&F 影响到的 AT 命令及参数............................................................................................... 255 上海移远通信技术股份有限公司 9 / 273 RGx00U&RM500U 系列 AT 命令手册 13.6. AT&W 影响到的 AT 命令及参数.............................................................................................. 257 13.7. ATZ 影响到的 AT 命令及参数 ................................................................................................. 257 13.8. URC 汇总................................................................................................................................ 258 13.9. SMS 字符集转换..................................................................................................................... 260 13.10. AT+CEER 扩展错误报告 ........................................................................................................ 266 上海移远通信技术股份有限公司 10 / 273 RGx00U&RM500U 系列 AT 命令手册 表格索引 表 1：AT 命令及响应类型........................................................................................................................... 13 表 2：ATV0&ATV1 结果代码数值等效项和简要说明.................................................................................. 24 表 3：参考文档 ......................................................................................................................................... 245 表 4：术语缩写 ......................................................................................................................................... 245 表 5：+CME ERROR: 错误码描述 .................................................................................................. 252 表 6：+CMS ERROR: 错误码描述 .................................................................................................. 254 表 7：AT&F 影响到的 AT 命令及参数....................................................................................................... 255 表 8：AT&W 影响到的 AT 命令及参数...................................................................................................... 257 表 9：ATZ 影响到的 AT 命令及参数 ......................................................................................................... 257 表 10：URC 汇总...................................................................................................................................... 258 表 11：SMS 文本输入和输出方式 ............................................................................................................ 260 表 12：输入转换表（DCS 等于 GSM 7 bit 且 AT+CSCS='GSM'） ........................................................ 261 表 13：输出转换表（DCS 等于 GSM 7 bit 且 AT+CSCS='GSM'） ........................................................ 262 表 14：GSM 扩展字符.............................................................................................................................. 262 表 15：输入转换表（DCS 等于 GSM 7 bit 且 AT+CSCS='IRA'） .......................................................... 263 表 16：IRA 扩展字符 ................................................................................................................................ 264 表 17：输出转换表（DCS 等于 GSM 7 bit 且 AT+CSCS='IRA'） .......................................................... 265 表 18：GSM 扩展字符(ISO-8859-1/Unicode) .......................................................................................... 265 表 19：AT+CEER 扩展错误报告 .............................................................................................................. 266 上海移远通信技术股份有限公司 11 / 273 RGx00U&RM500U 系列 AT 命令手册 1 引言 1.1. 本章概要 本文档主要介绍移远通信 5G 模块 RG200U 系列、RG500U 系列和 RM500U 系列支持的 AT 命令集。 1.2. AT 命令语句 1.2.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 RG200U 系列、RG500U 系列和 RM500U 系列模块实现的 AT 命令可以在语法上分为三类：基础类、 S 参数类和扩展类，如下所列。 ⚫ 基础类 基础类 AT 命令的格式为 AT或 AT&，其中是命令，是该命令的参数。以 ATE为例，DCE 会根据的取值确定是否将接收到的字符回显给 DTE。若为可选参数， 则其被省略时将使用其默认值。 ⚫ S 参数类 此类 AT 命令格式有 ATS=，其中是将要设置的 S 寄存器的索引，是赋予的参数 上海移远通信技术股份有限公司 12 / 273 RGx00U&RM500U 系列 AT 命令手册 值。 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 表 1：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 可以用分号（;）将多个命令放在同一行。此时只有第一个命令带有 AT 前缀。命令可以是大写或小写。 输入 AT 命令时，可以忽略空格。但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内； ⚫ 在 AT 命令名称中的=、?或=?内。 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.2.3. AT 命令响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或 +CME ERROR: ，表示已经准备好接 收新命令。在返回最终的 OK，ERROR 或 +CME ERROR: 之前，会发送请求的响应消息。 以下是响应消息的格式： +CMD1: OK 上海移远通信技术股份有限公司 13 / 273 或者 OK RGx00U&RM500U 系列 AT 命令手册 1.2.4. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系 或连续性。 1.3. 支持的字符集 RG200U 系列、RG500U 系列和 RM500U 系列模块的 AT 命令接口默认使用 GSM 字符集，其支持的 字符集如下： ⚫ GSM ⚫ UCS2 ⚫ IRA 可以使用 AT+CSCS（3GPP TS 27.007）配置和查询字符集，并在 3GPP TS 27.005 中对其进行定义。 字符集会影响 SMS 和 SMS 广播消息的发送和接收，以及电话簿条目文本字段的输入和显示。 1.4. AT 命令端口 主串口和两个 USB 端口（USB MODEM 端口和 USB AT 端口）支持 AT 命令通信和数据传输。 1.5. 未经请求的结果码 作为未经请求的结果码和上报消息，URC 不会作为与已执行的 AT 命令相关的响应的一部分发出。 URC 为 RG200U 系列、RG500U 系列和 RM500U 系列模块发出的报告消息，无需 TE 请求，并且在发生 特定事件时自动发布，如发生来电（RING）、收到短消息、高/低压警报、高/低温警报等。 上海移远通信技术股份有限公司 14 / 273 RGx00U&RM500U 系列 AT 命令手册 1.6. 关闭程序 建议执行 AT+QPOWD 关闭模块，因为这是最安全、最好的方法，通过让模块从网络注销并允许软件 在断开电源连接之前进入安全的数据状态来实现此过程。 发送 AT+QPOWD 后，请勿执行任何其他 AT 命令。成功执行 AT+QPOWD 后，模块输出消息 POWERED DOWN，随后进入关机状态。为了避免数据丢失，建议在 POWERED DOWN 输出后等待 1 秒 后断开电源。若 65 秒后仍未收到 POWER DOWN，则必须强制断开电源。 上海移远通信技术股份有限公司 15 / 273 RGx00U&RM500U 系列 AT 命令手册 2 通用命令 2.1. ATI 查询产品型号 ID 和固件版本信息 该命令用于查询产品信息文本。 ATI 查询产品型号 ID 和固件版本信息 执行命令 ATI 响应 Quectel Revision: 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 - 参数 字符串类型。产品类型的标识符。 字符串类型。产品固件版本的标识文本。 举例 ATI Quectel RG500U-CN Revision: RG500UCNAAR01A01M2G OK 上海移远通信技术股份有限公司 16 / 273 2.2. AT+GMI 查询制造商 ID 该命令用于查询制造商 ID 信息，与 AT+CGMI 相同。 AT+GMI 查询制造商 ID 测试命令 AT+GMI=? 执行命令 AT+GMI 响应 OK 响应 Quectel 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 - RGx00U&RM500U 系列 AT 命令手册 2.3. AT+GMM 查询产品型号 ID 该命令用于查询产品型号 ID，与 AT+CGMM 相同。 AT+GMM 查询产品型号 ID 测试命令 AT+GMM=? 执行命令 AT+GMM 响应 OK 响应 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 - 参数 字符串类型。产品类型的标识符。 上海移远通信技术股份有限公司 17 / 273 RGx00U&RM500U 系列 AT 命令手册 2.4. AT+GMR 查询产品固件版本号 该命令用于查询产品固件版本号。 AT+GMR 查询产品固件版本号 测试命令 AT+GMR=? 执行命令 AT+GMR 响应 OK 响应 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 - 参数 字符串类型。产品固件版本号，包括行终止符，在信息文本中不得超过 2048 个字符。 举例 AT+GMR RG500UCNAAR01A01M2G_01.001.01.001 OK 2.5. AT+CGMI 查询制造商 ID 该命令用于查询制造商 ID 信息。 AT+CGMI 查询制造商 ID 测试命令 AT+CGMI=? 执行命令 AT+CGMI 响应 OK 响应 Quectel OK 上海移远通信技术股份有限公司 18 / 273 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 - RGx00U&RM500U 系列 AT 命令手册 2.6. AT+CGMM 查询产品型号 ID 该命令用于查询产品型号 ID 信息，与 AT+GMM 相同。 AT+CGMM 查询产品型号 ID 测试命令 AT+CGMM=? 执行命令 AT+CGMM 响应 OK 响应 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 - 参数 字符串类型。产品类型的标识符。 2.7. AT+CGMR 查询产品固件版本号 该命令用于查询产品固件版本号。 AT+CGMR 查询产品固件版本号 测试命令 AT+CGMR=? 执行命令 AT+CGMR 响应 OK 响应 OK 上海移远通信技术股份有限公司 19 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 - 参数 字符串类型。产品固件版本号，包括行终止符，在信息文本中不得超过 2048 个字符。 2.8. AT+GSN 查询国际移动设备识别码（IMEI 号） 该命令用于查询移动设备的国际移动设备识别码（IMEI 号）。 AT+GSN 查询国际移动设备识别码（IMEI 号） 测试命令 响应 AT+GSN=? 执行命令 OK 响应 AT+GSN 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 - 参数 字符串类型。移动设备的 IMEI 号。 备注 每台移动设备的序列号（IMEI 号）不同，因此可以用来识别移动设备。 上海移远通信技术股份有限公司 20 / 273 RGx00U&RM500U 系列 AT 命令手册 2.9. AT+CGSN 查询国际移动设备识别码（IMEI 号） 该命令用于查询移动设备的国际移动设备识别码（IMEI 号），与 AT+GSN 相同。 AT+CGSN 查询国际移动设备识别码（IMEI 号） 测试命令 响应 AT+CGSN=? 执行命令 OK 响应 AT+CGSN 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 - 参数 字符串类型。移动设备的 IMEI 号。 备注 每台移动设备的序列号（IMEI 号）不同，因此可以用来识别移动设备。 2.10. AT&F 重置 AT 命令设置为出厂设置 该命令用于将所有 AT 命令设置重置为出厂设置（详情参考第 13.5 章）。 AT&F 重置 AT 命令设置为出厂设置 执行命令 响应 AT&F[] OK 最大响应时间 300 毫秒 特性说明 - 参考 V.25ter 上海移远通信技术股份有限公司 21 / 273 参数 RGx00U&RM500U 系列 AT 命令手册 整型。 0 将所有 AT 命令设置重置为出厂设置。 2.11. AT&W 存储当前设置到用户自定义配置文件 该命令用于将当前的 AT 命令设置存储到 NVM 中的用户自定义配置文件中（详情参考第 13.6 章）。 在上电或执行 ATZ 时，将从用户自定义的配置文件中自动恢复 AT 命令设置。 AT&W 存储当前设置到用户自定义配置文件 执行命令 响应 AT&W OK 最大响应时间 300 毫秒 特性说明 - 参考 V.25ter 2.12. ATZ 从用户自定义配置文件中还原设备通信参数 与 AT&F 命令类似，该命令用于从用户自定义配置文件中还原设备通信参数。若之前已通过 AT&W 将 配置文件存储在 NVM 中，则从 NVM 中的用户自定义配置文件中还原设备通信参数（详情参考第 13.7 章）。 同一命令行的任何其他 AT 命令都可以忽略。 ATZ 从用户自定义配置文件中还原所有 AT 命令设置 执行命令 响应 ATZ[] OK 最大响应时间 300 毫秒 特性说明 - 参考 V.25ter 参数 整型。 0 重置配置文件编号 上海移远通信技术股份有限公司 22 / 273 RGx00U&RM500U 系列 AT 命令手册 2.13. ATV 设置 MT 响应格式 该命令用于设置与 AT 命令结果码和信息响应一起发送的首尾内容。结果码如表 2 所示，包括数值等 效项以及每种用法的简要说明。 ATV 设置 MT 响应格式 执行命令 ATV[] 响应 若=0： 0 最大响应时间 特性说明 参考 V.25ter 若=1 或省略可选参数： OK 300 毫秒 - 参数 整型。响应格式。详情请参考表 2。 0 信息返回： 短结果码格式： 1 信息返回： 短结果码格式： 举例 ATV1 OK AT+CSQ +CSQ: 30,99 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //设置=1。 //当=1 时，结果码是 OK。 //设置=0。 //当=0 时，结果码是 0。 上海移远通信技术股份有限公司 23 / 273 RGx00U&RM500U 系列 AT 命令手册 表 2：ATV0&ATV1 结果代码数值等效项和简要说明 ATV1 OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY NO ANSWER ATV0 0 1 2 3 4 6 7 8 描述 确认执行命令 已建立连接；DCE 从命令模式转换为数据模式 DCE 已检测到来自网络的来电信号 连接已终止或尝试建立连接失败 无法识别命令，超过命令行最大长度，参数值无效或其他 处理命令行的问题 未检测到拨号音 检测到占线（忙音）信号 使 用 了@（ 等 待 静 默 应 答 ） 拨 号 修 饰 符 ， 连 接 计 时 器 （S7）计时结束前，未检测到远程振铃后的五秒静音。 2.14. ATE 设置命令回显模式 该命令用于控制模块在 AT 命令模式下是否回显从 TE 接收的字符。 ATE 设置命令回显模式 执行命令 ATE[] 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 - 参数 整型。是否回显从 TE 收到的字符。 0 关闭 1 开启 上海移远通信技术股份有限公司 24 / 273 RGx00U&RM500U 系列 AT 命令手册 2.15. A/ 重复上一个命令行 该命令用于重复上一个 AT 命令行，'/'表示行终止符。 A/ 重复上一个命令行 执行命令 A/ 特性说明 参考 V.25ter 响应 重复上一个命令 - 举例 ATI Quectel RG500U-CN Revision: RG500UCNAAR01A01M2G OK A/ Quectel RG500U-CN Revision: RG500UCNAAR01A01M2G OK //重复上一个命令。 2.16. ATS3 设置命令行终止符 该命令用于设置命令行终止符。同时生成结果代码、信息文本以及通过 ATS4 设置的字符值。 ATS3 设置命令行终止符 查询命令 响应 ATS3? 设置命令 ATS3= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 - 上海移远通信技术股份有限公司 25 / 273 参数 RGx00U&RM500U 系列 AT 命令手册 整型。命令行终止符。范围：0~127；默认值：13。 2.17. ATS4 设置响应格式字符 该命令用于确定模块为结果码和信息文本生成的字符，以及通过 ATS3 设置的命令行终止字符。 ATS4 设置响应格式字符 查询命令 响应 ATS4? 设置命令 ATS4= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 - 参数 整型。响应格式字符。范围：0~127；默认值：10。 2.18. ATS5 设置命令行编辑字符 该命令用于确定从 AT 命令行删除紧接前一个字符的编辑字符值（等同于退格键）。 ATS5 设置命令行编辑字符 查询命令 响应 ATS5? 设置命令 ATS5= 最大响应时间 OK 响应 OK 300 毫秒 上海移远通信技术股份有限公司 26 / 273 RGx00U&RM500U 系列 AT 命令手册 特性说明 - 参考 V.25ter 参数 整型。响应编辑字符。范围：0~127；默认值：8。 2.19. AT+CFUN 设置功能模式 该命令用于设置功能模式，同时还可以用于重置 UE。 AT+CFUN 设置功能模式 测试命令 AT+CFUN=? 响应 +CFUN: (支持的列表),(支持的列表) 查询命令 AT+CFUN? OK 响应 +CFUN: 设置命令 AT+CFUN=[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现任何与 ME 功能相关的错误： +CME ERROR: 15 秒，取决于网络状态 - 参数 整型。功能模式。 0 最小功能模式 1 全功能模式 4 禁用 UE 发送和接收 RF 信号功能 整型。是否复位。 上海移远通信技术股份有限公司 27 / 273 RGx00U&RM500U 系列 AT 命令手册 0 将 UE 设置为功能模式前，不触发复位。 1 触发复位。复位后，该设备可以正常使用。仅当=1 时可用。 错误码。详情请参考第 13.3 章。 举例 AT+CFUN=0 OK AT+COPS? +COPS: 0 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN='1234' OK +CPIN: READY +QUIMSLOT: 1 +QIND: PB DONE +QIND: SMS DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE',7 OK //将 UE 设置为最小功能模式。 //无网络。 //(U)SIM 卡读取失败。 //将 UE 设置为全功能模式。 //已注册网络。 上海移远通信技术股份有限公司 28 / 273 RGx00U&RM500U 系列 AT 命令手册 2.20. AT+CMEE 设置错误讯息格式 该命令用于禁用/启用将最终结果码+CME ERROR: 作为错误的指示。启用后，出现错误则返回 +CME ERROR: 的最终结果代码，而不是 ERROR。 AT+CMEE 设置错误讯息格式 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) 查询命令 AT+CMEE? OK 响应 +CMEE: 设置命令 AT+CMEE= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 - 参数 整型。禁用/启用将最终结果码。 0 禁用结果码+CME ERROR: ，使用 ERROR。 1 启用结果码+CME ERROR: ，使用数值型取值。 2 启用结果码+CME ERROR: ，使用字符串说明取值。 错误码。详情请参考第 13.3 章。 举例 AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? //禁用结果码。 //仅显示 ERROR。 //启用结果码，使用数值型取值。 //启用具有字符串说明的结果码。 上海移远通信技术股份有限公司 29 / 273 +CME ERROR: SIM not inserted RGx00U&RM500U 系列 AT 命令手册 2.21. AT+CSCS 选择 TE 字符集 该命令用于设置 TE 使用的字符集，使用户终端能够在 TE 和 MT 的字符集之间正确转换字符串。 AT+CSCS 选择 TE 字符集 测试命令 AT+CSCS=? 响应 +CSCS: (支持的列表) 查询命令 AT+CSCS? OK 响应 +CSCS: 设置命令 AT+CSCS= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 - 参数 字符串类型。字符集。 'GSM' GSM 默认字符集 'IRA' 国际参考字符集 'UCS2' UCS2 字符集 举例 AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' //查询当前字符集。 //设置字符集为 UCS2 编码。 上海移远通信技术股份有限公司 30 / 273 RGx00U&RM500U 系列 AT 命令手册 OK 2.22. AT+QURCCFG 配置 URC 输出端口 该命令用于配置 URC 输出端口。 AT+QURCCFG 配置 URC 输出端口 测试命令 AT+QURCCFG=? 响应 +QURCCFG: 'urcport',(支持的列表) 设置命令 AT+QURCCFG='urcport'[,] OK 响应 若省略可选参数，则查询当前配置： +QURCCFG: 'urcport', OK 若指定可选参数，则配置 URC 的输出端口： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。URC 的输出端口。 'usbat' USB AT 端口 'usbmodem' USB Modem 端口 'uart1' 主串口 'all' 所有端口 上海移远通信技术股份有限公司 31 / 273 RGx00U&RM500U 系列 AT 命令手册 举例 AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1','all') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' //查询当前URC输出端口。 OK AT+QURCCFG='urcport','usbmodem' OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' //设置URC输出端口为USB Modem端口。 //查询当前URC输出端口。 OK 上海移远通信技术股份有限公司 32 / 273 RGx00U&RM500U 系列 AT 命令手册 3 状态控制命令 3.1. AT+CPAS 查询 ME 活动状态 该命令用于查询 ME 的活动状态。 AT+CPAS 查询 ME 活动状态 测试命令 AT+CPAS=? 响应 +CPAS: (支持的列表) 执行命令 AT+CPAS OK 响应 +CPAS: OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 参数 整型。ME 活动状态。 0 就绪 3 响铃 4 呼叫进行中 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 33 / 273 举例 AT+CPAS +CPAS: 0 OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129 OK AT+CPAS +CPAS: 4 OK RGx00U&RM500U 系列 AT 命令手册 //ME 处于就绪状态。 //ME 正在响铃。 //呼叫进行中。 3.2. AT+CEER 查询扩展错误报告 该命令用于查询错误原因扩展报告，错误原因如下： ⚫ 上一次呼叫释放失败 ⚫ 上一次通话建立失败（包括主叫和被叫） ⚫ 上一次通过补充业务修改呼叫失败 ⚫ 上一次补充业务激活、注册、查询、去激活、注销失败 错误原因为信息文本，描述网络给出的原因信息。 上海移远通信技术股份有限公司 34 / 273 RGx00U&RM500U 系列 AT 命令手册 AT+CEER 查询扩展错误报告 测试命令 AT+CEER=? 执行命令 AT+CEER 最大响应时间 特性说明 响应 OK 响应 +CEER: OK 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 参数 字符串类型。网络下发失败原因信息。上次拨打电话或通话失败的原因（参考 第 13.10 章）。上报 CS 和 PS 域呼叫类型。错误原因数据通过呼叫管理器事件抓取并缓存至本地，供 后续通过该命令查询。 错误码。详情请参考第 13.3 章。 3.3. AT+QCFG 扩展配置 该命令用于配置及查询扩展配置。 AT+QCFG 扩展配置 测试命令 AT+QCFG=? 响应 +QCFG: 'usbnet',(支持的列表) +QCFG: 'nat',(支持的范围) +QCFG: 'usbcfg',(支持的范 围),(支持 的范围),(支 持的 列 表),(支 持 的列 表),(支 持 的列 表),(列 表),(支 持 的列 表),(支 持 的列 表),(支 持 的 列表) +QCFG: 'ims',(支持的列表) +QCFG: 'pcie/mode',(支持的列表) +QCFG: 'ethernet',(支持的列表) +QCFG: 'uartat',(支持的列表) +QCFG: 'usbid',(支持的范围),(支持的范围) 上海移远通信技术股份有限公司 35 / 273 最大响应时间 特性说明 RGx00U&RM500U 系列 AT 命令手册 +QCFG: 'multiusbnet',(支持的范围),(支持的范围) +QCFG: 'usbmac',(支持的列表) +QCFG: 'staticarp',(支持的列表), +QCFG: 'lanip',,, +QCFG: 'lanip_ex',,,,, +QCFG: 'loopback',(支持的范围) +QCFG: '5glan',(支持的范围),(支持的列表) +QCFG: 'autoapn',(支持的列表) +QCFG: 'usbmode',(支持的列表) +QCFG: 'rp_filter',(支持的范围) +QCFG: 'netmask',(支持的列表) +QCFG: 'tts',(支持的列表) +QCFG: 'pm/powersave',(支持的列表) OK 300 毫秒 - 3.3.1.AT+QCFG='usbnet' 配置 USB 网卡驱动类型 该命令用于在 USB 接口网卡下，配置 USB 网卡驱动类型。 AT+QCFG='usbnet' 配置 USB 网卡驱动类型 设置命令 AT+QCFG='usbnet'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'usbnet', OK 若指定可选参数，则配置 USB 网卡驱动类型： OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存； 通过 USB 固件升级后将还原参数配置为默认值。 上海移远通信技术股份有限公司 36 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。USB 接口网卡下，USB 网卡驱动类型。 1 ECM 2 MBIM 3 RNDIS 5 NCM 错误码。详情请参考第 13.3 章。 备注 模块的 USB 网卡驱动类型配置为 MBIM 时，模块仅支持主控使用 MBIM 协议和模块进行通信，不支持主 控通过 AT 命令和模块进行通信。 举例 AT+QCFG='usbnet',3 OK //配置 USB 网卡驱动类型为 RNDIS。 3.3.2. AT+QCFG='nat' 配置网卡拨号模式 该命令用于在 USB 接口网卡下，配置网卡拨号模式。 AT+QCFG='nat' 配置网卡拨号模式 设置命令 AT+QCFG='nat'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'nat', OK 若指定可选参数，则设置网卡拨号模式： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存； 通过 USB 固件升级后将还原参数配置为默认值。 上海移远通信技术股份有限公司 37 / 273 参数 整型。网卡拨号模式。 0 网卡模式 1 路由模式 2 网桥模式 举例 AT+QCFG='nat',1 OK //配置拨号模式为路由模式。 RGx00U&RM500U 系列 AT 命令手册 3.3.3. AT+QCFG='usbcfg' 查询/设置 USB 设备信息 该命令用于查询/设置 USB 设备的厂家 ID、产品 ID 和接口状态。 AT+QCFG='usbcfg' 查询/设置 USB 设备信息 设置命令 AT+QCFG='usbcfg'[,,,, ,,,,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'usbcfg',,,,,,,,, OK 若指定可选参数，则设置 USB 设备信息： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 十六进制整型。USB 设备的厂家 ID。最大值：0×FFFF。 十六进制整型。USB 设备的产品 ID。最大值：0×FFFF。 整型。USB 设备诊断接口状态。 0 禁用所有诊断接口 1 启用 DM（Diagnostic Monitor）接口 整型。USB 设备 log 接口状态。 0 禁用 上海移远通信技术股份有限公司 38 / 273 RGx00U&RM500U 系列 AT 命令手册 1 启用 整型。USB 设备 AT 接口状态。 0 禁用 1 启用 整型。USB 设备 Modem 接口状态。 0 禁用 1 启用 整型。USB 设备 NMEA 接口状态。 0 禁用 1 启用 整型。USB 设备 ADB 接口状态。 0 禁用 1 启用 整型。USB 设备 UAC 接口状态。 0 禁用 1 启用 举例 AT+QCFG='usbcfg' +QCFG: 'usbcfg',0x2C7C,0x0800,1,1,1,1,1,0,0 //查询当前 USB 设备信息。 OK AT+QCFG='usbcfg',0x2C7C,0x0800,1,1,1,1,1,1,0 //打开 ADB OK 3.3.4. AT+QCFG='ims' 启用/禁用 IMS 该命令用于启用/禁用 IMS。 AT+QCFG='ims' 启用/禁用 IMS 设置命令 AT+QCFG='ims'[,] 响应 若省略可选参数，查询当前配置： +QCFG: 'ims', OK 若指定可选参数，启用/禁用 IMS： OK 最大响应时间 若有任何错误： ERROR 300 毫秒 上海移远通信技术股份有限公司 39 / 273 RGx00U&RM500U 系列 AT 命令手册 特性说明 该命令立即生效； 参数配置自动保存； 通过 USB 固件升级后将还原参数配置为默认值。 参数 整型。启用/禁用 IMS。 0 禁用 1 启用 举例 AT+QCFG='ims',1 OK //启用 IMS。 3.3.5. AT+QCFG='pcie/mode' 配置 PCIe RC/EP 模式 该命令用于配置 PCIe RC/EP 模式。 AT+QCFG='pcie/mode' 配置 PCIe RC/EP 模式 设置命令 AT+QCFG='pcie/mode'[,] 响应 若省略可选参数，查询当前配置： +QCFG: 'pcie/mode', OK 若指定可选参数，配置 PCIe RC/EP 模式： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。PCIe RC 或 EP 模式。 0 PCIe EP 模式。 1 PCIe RC 模式。 上海移远通信技术股份有限公司 40 / 273 举例 AT+QCFG='pcie/mode',1 OK RGx00U&RM500U 系列 AT 命令手册 //配置 PCIe RC 模式。 3.3.6. AT+QCFG='ethernet' 禁用/启用 Ethernet 网卡 该命令用于禁用/启用 Ethernet 网卡。 AT+QCFG='ethernet' 禁用/启用 Ethernet 网卡 设置命令 AT+QCFG='ethernet'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'ethernet', OK 若指定可选参数，则禁用/启用 Ethernet 网卡： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存； 通过 USB 固件升级后将还原参数配置为默认值。 参数 整型。禁用或启用 Ethernet 网卡。 0 禁用 Ethernet 1 启用自适应功能；如果硬件设计有以太网口，会优先使用以太网口，否则使用 USB 网卡 举例 AT+QCFG='ethernet',0 OK //关闭 Ethernet 网卡自适应功能。 上海移远通信技术股份有限公司 41 / 273 RGx00U&RM500U 系列 AT 命令手册 3.3.7. AT+QCFG='uartat' 配置主串口 AT 功能 该命令用于开启/关闭主串口的 AT 功能。 AT+QCFG='uartat' 配置主串口 AT 功能 设置命令 AT+QCFG='uartat'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'uartat', OK 若指定可选参数，则开启/关闭主串口 AT 功能： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存； 通过 USB 固件升级后将还原参数配置为默认值。 参数 整型。开启或关闭主串口的 AT 功能。 0 关闭 1 开启 举例 AT+QCFG='uartat',0 OK //关闭主串口的 AT 功能。 上海移远通信技术股份有限公司 42 / 273 RGx00U&RM500U 系列 AT 命令手册 3.3.8. AT+QCFG='usbid' 配置 USB 设备的供应商 ID 和产品 ID 该命令用于配置 USB 设备供应商 ID 和产品 ID。 AT+QCFG='usbid' 配置 USB 设备的供应商 ID 和产品 ID 设置命令 AT+QCFG='usbid'[,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'usbcfg',, OK 若指定可选参数，配置 USB 设备的供应商 ID 和产品 ID： OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存； 通过 USB 固件升级后将还原参数配置为默认值。 参数 整型。USB 设备供应商 ID。范围：1~65535。 整型。USB 设备产品 ID。范围：1~65535。 错误码。详情请参考第 13.3 章。 举例 AT+QCFG='usbid',11388,2304 OK //配置 USB 设备的供应商 ID 和产品 ID。 3.3.9. AT+QCFG='multiusbnet' 配置 NCM 网卡多路拨号 该 命 令 用 于 配 置 NCM 网 卡 拨 号 方 式 下 的 多 路 拨 号 参 数 。 仅 当 拨 号 模 式 为 网 卡 模 式 （AT+QCFG='nat',0）时，该命令可用。 AT+QCFG='multiusbnet' 配置 NCM 网卡多路拨号 设置命令 AT+QCFG='multiusbnet'[,[,]] 响应 若省略可选参数，查询当前配置： +QCFG: 'multiusbnet',, 上海移远通信技术股份有限公司 43 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 OK 若指定任意可选参数，配置多路拨号的通道数（和位置偏移）： OK 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。NCM 网卡多路拨号的通道数。范围：1~4；默认值：1。 整型。每一路拨号通道的位置偏移。仅当取值大于 1 时，该参数有效。范围： 0~4；默认值：0，表示不偏移。 备注 1. 仅当网卡驱动类型为 NCM 时此 AT 才有效且上位机系统需要支持 NCM 驱动，如 Linux。 2. 仅网卡模式（AT+QCFG='nat',0）下支持 NCM 网卡多路拨号，即 Llinux 上位机获取的 IP 地址为 核心网分配的 IP 地址。 举例 AT+QCFG='multiusbnet' +QCFG: 'multiusbnet',1,0 OK AT+QCFG='multiusbnet',1 OK AT+QCFG='multiusbnet',1,0 OK 上海移远通信技术股份有限公司 44 / 273 RGx00U&RM500U 系列 AT 命令手册 3.3.10. AT+QCFG='usbmac' 查询 NCM 网卡多路拨号通道的 MAC 地址 该命令用于查询 NCM 网卡多路拨号通道的 USB 虚拟网卡 MAC 地址。仅当拨号模式为网卡模式 （AT+QCFG='nat',0）时，该命令可用。 AT+QCFG='usbmac' 查询 NCM 网卡多路拨号通道的 MAC 地址 设置命令 AT+QCFG='usbmac'[,] 响应 若省略可选参数，查询当前所有 USB 虚拟网卡的 MAC 地 址： [+QCFG: 'usbmac',, [+QCFG: 'usbmac',, […]]] OK 若指定可选参数，查询指定 USB 虚拟网卡的 MAC 地址： +QCFG: 'usbmac',, OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 - 参数 字符串类型。USB 虚拟网卡名称。范围由 AT+QCFG='multiusbnet'决定。 usb0 usb1 usb2 usb3 字符串类型。USB 虚拟网卡的 MAC 地址。 备注 1. 仅当 AT+QCFG='multiusbnet'配置了多路拨号的通道数后该命令有效。 2. AT+QCFG='multiusbnet'配置了几路通道数，即可查询几路 MAC 地址。若配置 4 路，则可查询 4 个 USB 虚拟网卡的 MAC 地址。 上海移远通信技术股份有限公司 45 / 273 RGx00U&RM500U 系列 AT 命令手册 举例 AT+QCFG='usbmac' //查询 USB 虚拟网卡的 MAC 地址。 +QCFG: 'usbmac',usb0,3a:32:1b:47:18:83 OK 3.3.11. AT+QCFG='staticarp' 配置静态 ARP 该命令用于配置静态 ARP。仅当拨号模式为网卡模式（AT+QCFG='nat',0）时，该命令可用。 AT+QCFG='staticarp' 配置静态 ARP 设置指令 AT+QCFG='staticarp',[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'staticarp',, [+QCFG: 'staticarp',, […]] OK 若指定可选参数，配置指定 USB 网卡的静态 ARP： OK 最大响应时间 特性说明 若有任何问题： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。USB 虚拟网卡名称。范围由 AT+QCFG='multiusbnet'决定。 0 关闭静态 ARP 配置功能 usb0 usb1 usb2 usb3 字符串类型。上位机端 USB 虚拟网卡的 MAC 地址。 上海移远通信技术股份有限公司 46 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 1. 需要在执行 AT+QNETDEVCTL 进行拨号前通过该命令配置静态 ARP。 2. AT+QCFG='multiusbnet'配置了几路通道数，即可查询几路 MAC 地址。若配置 4 路，则可查询 4 个 USB 虚拟网卡的 MAC 地址。 举例 AT+QCFG='staticarp',usb0,'12:22:33:44:55:66' OK AT+QCFG='staticarp',usb0 +QCFG: 'staticarp',usb0,12:22:33:44:55:66 OK 3.3.12. AT+QCFG='lanip' 配置网关地址和子网掩码及租期 该命令用于在路由或网桥模式下配置网关地址和子网掩码以及租期。 AT+QCFG='lanip' 配置网关地址和子网掩码及租期 设置命令 AT+QCFG='lanip'[,,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'lanip',,, OK 若指定可选参数，则配置网关地址和子网掩码以及租期： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存； 通过 USB 固件升级后将还原参数配置为默认值。 参数 字符串类型。网关地址的网段。 字符串类型。子网掩码。 整型。租期。范围：3600~86400；默认值：86400；单位：秒。 若设置为 0，表示对应租期为十年。 上海移远通信技术股份有限公司 47 / 273 举例 AT+QCFG='lanip' //查询当前配置。 +QCFG: 'lanip','192.168.42.0','255.255.255.0',86400 OK RGx00U&RM500U 系列 AT 命令手册 3.3.13. AT+QCFG='lanip_ex' 拓展配置网关地址和子网掩码及租期 在路由模式和网桥模式下，可通过 AT+QCFG='lanip_ex'[,[,[,[,[,]]]]]来查询或设置网关地址、子网掩码、DHCP 地址池的起始和终止 IP 地址以及租期， 该命令立即生效。在网卡模式下，仅支持通过 AT+QCFG='lanip_ex'[,]来查询或设置 DHC P 地址池的租期，该命令在模块重启后生效。 AT+QCFG='lanip_ex' 拓展配置网关地址和子网掩码及租期 设置命令 路由模式或网桥模式： AT+QCFG='lanip_ex'[,[,< netmask>[,[,[,]]]]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'lanip_ex',,,,, OK 若指定可选参数，设置网关地址、子网掩码、DHCP 地址池的 起始和终止 IP 地址以及租期： OK 设置命令 网卡模式： AT+QCFG='lanip_ex'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QCFG: 'lanip_ex', OK 若指定可选参数，设置 DHCP 地址池的租期： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 参数配置自动保存； 通过 USB 固件升级后将还原参数配置为默认值。 上海移远通信技术股份有限公司 48 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 字符串类型。网关地址。 字符串类型。子网掩码。 字符串类型。DHCP 地址池起始 IP 地址。 字符串类型。DHCP 地址池终止 IP 地址。 整型。租期。范围：0~86400；默认值：86400；单位：秒。 若设置为 0，表示对应租期为十年。 备注 AT+QCFG='lanip_ex'[,[,[,[,[,]]]]]为 AT+QCF G='lanip'[,,,]的拓展命令；这两条 AT 命令的配置相互隔离，请 不要同时使用。 二者的区别如下： 1. 的 含 义 不 同 ， 在 AT+QCFG='lanip_ex' 中 该 参 数 表 示 直 接 指 定 网 关 地 址 ， 而 在 AT+QCFG='lanip'中表示指定网关地址的网段。 2. AT+QCFG='lanip_ex'中新增和两个参数，用于指定 DHCP 地址池。 举例 AT+QCFG='nat',1 //配置拨号模式为路由模式。 OK AT+QCFG='nat',2 //配置拨号模式为网桥模式。 OK //在路由和网桥模式下，设置网关地址为 192.168.42.1、子网掩码为 255.255.255.0、DHCP 地址池的起始 IP 地址为 192.168.42.2、终止地址为 192.168.42.254、租期为 86400 秒。 AT+QCFG='lanip_ex','192.168.42.1','255.255.255.0','192.168.42.2','192.168.42.254',86400 OK AT+QCFG='lanip_ex' //查询当前配置。 +QCFG: 'lanip_ex','192.168.42.1','255.255.255.0','192.168.42.2','192.168.42.254',86400 OK AT+QCFG='nat',0 //配置拨号模式为网卡模式。 //在网卡模式下，设置 DHCP 地址池的租期为 86400 秒。 AT+QCFG='lanip_ex',86400 OK AT+QCFG='lanip_ex' //查询当前配置。 +QCFG: 'lanip_ex',86400 OK 上海移远通信技术股份有限公司 49 / 273 RGx00U&RM500U 系列 AT 命令手册 3.3.14. AT+QCFG='loopback' 启用/禁用回环 该命令用于启用/禁用回环。 AT+QCFG='loopback' 启用/禁用回环 设置命令 AT+QCFG='loopback'[,] 响应 若省略可选参数，查询当前配置： +QCFG: 'loopback', OK 若指定可选参数，启用/禁用回环： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用/禁用回环。 0 禁用 1~15 启用，回环包个数 举例 AT+QCFG='loopback',10 OK //启用回环，上位机发 1 个包，模块回 10 个包。 3.3.15. AT+QCFG='5glan' 启用/禁用 5G LAN 功能 该命令用于启用/禁用 5G LAN 功能。 AT+QCFG='5glan' 启用/禁用 5G LAN 功能 设置命令 AT+QCFG='5glan'[,,] 响应 若省略可选参数，查询当前配置： +QCFG: '5glan',, OK 上海移远通信技术股份有限公司 50 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 若指定可选参数，启用/禁用指定 PDP 上下文的 5G LAN 功 能： OK 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用 5G LAN 功能。 0 禁用 1 启用 整型。PDP 上下文 ID。范围：1~8。 3.3.16. AT+QCFG='autoapn' 启用/禁用 APN 自适应功能 该命令用于启用/禁用 APN 自适应功能。 AT+QCFG='autoapn' 启用/禁用 APN 自适应功能 设置命令 AT+QCFG='autoapn'[,] 响应 若省略可选参数，查询当前配置： +QCFG: 'autoapn', OK 若指定可选参数，启用/禁用 APN 自适应功能： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 51 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。启用/禁用 APN 自适应功能。 0 禁用 1 启用 备注 如需关闭 APN 自适应功能以使用固定 APN，请先使用 AT+CGDCONT 或者 AT+QICSGP 设置 APN，否 则该路 APN 为空。 举例 AT+QCFG='autoapn',1 OK //启用 APN 自适应功能。 3.3.17. AT+QCFG='usbmode' 配置 USB 主从模式 该命令用于配置 USB 的主从模式。 AT+QCFG='usbmode' 配置 USB 主从模式 设置命令 AT+QCFG='usbmode'[,] 响应 若省略可选参数，查询当前配置： +QCFG: 'usbmode', OK 若指定可选参数，配置 USB 的主从模式： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 不带双引号的字符串类型。USB 的主从模式。 device 强制从模式 host 强制主模式 auto 自适应模式,依据 USBID 硬件设计 上海移远通信技术股份有限公司 52 / 273 举例 AT+QCFG='usbmode' +QCFG: 'usbmode',auto OK AT+QCFG='usbmode',host OK //重启模块 AT+QCFG='usbmode' +QCFG: 'usbmode',host OK RGx00U&RM500U 系列 AT 命令手册 //查询当前配置。 //强制 USB 为主模式。 //查询当前配置。 3.3.18. AT+QCFG='rp_filter' 配置反向路由检查功能 该命令用于启用/禁用反向路由检查功能。 AT+QCFG='rp_filter' 配置反向路由检查功能 设置命令 AT+QCFG='rp_filter'[,] 响应 若省略可选参数，查询当前配置： +QCFG: 'rp_filter', OK 若指定可选参数，启用/禁用反向路由检查功能： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用反向路由检查功能。 0 禁用 1 启用严格反向路由检查，校验反向路径是否为最佳路径 2 启用松散反向路由检查，校验其源地址是否可达，即反向路径是否能通 上海移远通信技术股份有限公司 53 / 273 RGx00U&RM500U 系列 AT 命令手册 3.3.19. AT+QCFG='netmask' 启用/禁用动态子网掩码 该命令用于启用/禁用动态子网掩码功能。 AT+QCFG='netmask' 启用/禁用动态子网掩码功能 设置命令 AT+QCFG='netmask'[,] 响应 若省略可选参数，查询当前配置： +QCFG: 'netmask', OK 若指定可选参数，启用或禁用动态子网掩码功能： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重新连接网卡后生效； 参数配置自动保存。 参数 整型。启用或禁用动态子网掩码功能。 0 禁用 1 启用 备注 动态子网掩码的规则为：在防止主机位变成全 0 或全 1 的前提下，掩码尽可能长。 举例 AT+QCFG='netmask',1 OK //启用动态子网掩码功能，重新连接网卡后生效。 上海移远通信技术股份有限公司 54 / 273 RGx00U&RM500U 系列 AT 命令手册 3.3.20. AT+QCFG='tts' 启用/禁用 TTS 功能 该命令用于启用/禁用 TTS 功能。 AT+QCFG='tts' 启用/禁用 TTS 功能 设置命令 AT+QCFG='tts'[,] 响应 若省略可选参数，查询当前配置： +QCFG: 'tts', OK 若指定可选参数，则启用/禁用 TTS 功能： OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存。 参数 整型。启用/禁用 TTS 功能。 0 禁用。 1 启用。 错误码。详情请参考第 13.3 章。 举例 AT+QCFG='tts',1 OK //启用 TTS 功能，模块重启后配置生效。 3.3.21. AT+QCFG='pm/powersave' 设置模块业务态下的功耗模式 该命令用于设置模块业务态下的功耗模式。 AT+QCFG='pm/powersave' 设置模块业务态下的功耗模式 设置命令 AT+QCFG='pm/powersave'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'pm/powersave', OK 上海移远通信技术股份有限公司 55 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 若指定可选参数，设置模块业务态下的功耗模式： OK 若有任何错误： +CME ERROR: 300 毫秒 该命令重启生效； 参数配置自动保存。 参数 整型。模块业务态下的功耗模式。 0 性能模式 1 节能模式 错误码。详情请参考第 13.3 章。 举例 AT+QCFG='pm/powersave',0 //设置模块业务态下的功耗模式为性能模式。 OK AT+QCFG='pm/powersave',1 //设置模块业务态下的功耗模式为节能模式。 OK AT+QCFG='pm/powersave' //查询当前模块业务态下的功耗模式。 +QCFG: 'pm/powersave',1 OK 3.4. AT+QINDCFG 控制 URC 上报 该命令用于控制指定 URC 的上报。 AT+QINDCFG 控制 URC 上报 测试命令 AT+QINDCFG=? 响应 +QINDCFG: 'all',(支 持 的列 表),(支 持 的 列表) +QINDCFG: 'csq',(支 持 的列 表),(支 持 的 列表) +QINDCFG: 'smsfull',(支 持 的列 表),(支 持 的 列表) 上海移远通信技术股份有限公司 56 / 273 RGx00U&RM500U 系列 AT 命令手册 +QINDCFG: 'ring',(支 持 的列 表),(支 持 的 列表) +QINDCFG: 'smsincoming',(支 持 的列 表),(支 持的列表) +QINDCFG: 'act',(支 持 的列 表),(支 持 的 列表) +QINDCFG: 'rejinfo',(支 持 的列 表),(支 持 的 列表) 设置命令 AT+QINDCFG=[,[, ]] OK 响应 若省略可选参数，则查询当前配置： +QINDCFG: , OK 若指定任意可选参数，则配置指定 URC 的上报： OK 最大响应时间 特性说明 若有任何错误： ERROR 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置是否保存取决于。 参数 字符串类型。URC 类型。 'all' 所有类型的 URC。默认打开。 'csq' 信号强度和信道误码率变化指示（类似 AT+CSQ）。默认关 闭。若配置为打开，将上报 URC： +QIND:'csq',,。 'smsfull' 短信存储已满指示。默认关闭。若配置为打开，将上报 URC： +QIND: 'smsfull',。 'ring' 来电 RING 指示。默认打开。 'smsincoming' 新消息指示。默认打开。相关 URC：+CMTI、+CMT、+CDS。 'act' 网络访问技术更新指示。默认关闭。若配置为打开，则将上报 URC：+QIND: 'act',。 字符串类型。取值为：'WCDMA'、 'HSDPA'、'HSUPA'、'HSDPA&HSUPA'、'LTE'、'NR5G- NSA'、'NR5G-SA'、'UNKNOWN' 上海移远通信技术股份有限公司 57 / 273 RGx00U&RM500U 系列 AT 命令手册 例如：+QIND: 'act','HSDPA&HSUPA'或 +QIND: 'act','UNKNOWN'。 若 MT 未注册网络，则为'UNKNOWN'。配置为打开 时，立即上报'act'的 URC。仅当网络访问技术发生变化时，才 会上报新的 URC。 'rejinfo' 注册、业务请求、网络去附着过程中网络下发的拒绝原因值或 (U)SIM 鉴权失败的原因值。默认关闭。 +QREJINFO: ,,,,,,,,[,] URC 中参数解释参考 AT+QREJINFO。 整型。打开/关闭指定 URC 的上报。 0 关闭 1 打开 整型。是否将参数配置保存至 NVRAM。 0 不保存 1 保存 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 58 / 273 RGx00U&RM500U 系列 AT 命令手册 4 (U)SIM 卡相关命令 4.1. AT+CIMI 查询 IMSI 该命令用于查询(U)SIM 卡的国际移动用户识别码，IMSI 允许 TE 识别连接到 MT 的个人(U)SIM 卡或 UICC（或者 USIM）中的活动应用。 AT+CIMI 查询 IMSI 测试命令 AT+CIMI=? 执行命令 AT+CIMI 响应 OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： +CME ERROR: 300 毫秒 - 参数 不带无双引号的字符串类型。国际移动用户识别码。 错误码。详情请参考第 13.3 章。 举例 AT+CIMI 460023210226023 OK //查询(U)SIM 卡的 IMSI 号。 上海移远通信技术股份有限公司 59 / 273 RGx00U&RM500U 系列 AT 命令手册 4.2. AT+CLCK 功能锁定 该命令用于锁定、解锁 MT 或者网络功能，以及查询锁定状态。该命令一般需要一个密码。当查询网 络服务状态（为 2）时，若所有类型的服务状态未激活，则命令响应行就返回未激活的情 况。 AT+CLCK 功能锁定 测试命令 AT+CLCK=? 响应 +CLCK: (支持的列表) 设置命令 AT+CLCK=,[,[ ,]] OK 响应 当不等于 2 且命令执行成功： OK 当等于 2 且命令执行成功： +CLCK: [,] [+CLCK: [,] […]] OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： +CME ERROR: 5秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。 'PS' 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' (U)SIM (U)SIM（锁定当前所选卡槽中插入的(U)SIM/UICC 卡。在 MT 启动以及执行功能 锁定命令时，(U)SIM/UICC 会要求输入密码） BAOC（禁止所有呼出，请参考 3GPP TS 22.088 clause 1） BOIC（禁止所有国际呼出，请参考 3GPP TS 22.088 clause 1） BOIC-exHC（禁止除归属国以外所有国际呼出，请参考 3GPP TS 22.088 clause 1） BAIC（禁止所有呼入，请参考 3GPP TS 22.088 clause 2） BIC-Roam （归属地以外漫游时禁止所有呼入，请参考 3GPP TS 22.088 clause 上海移远通信技术股份有限公司 60 / 273 RGx00U&RM500U 系列 AT 命令手册 'AB' 'AG' 'AC' 'FD' 'PN' 'PU' 'PP' 'PC' 2） 禁止所有业务（请参考 3GPP TS 22.030），仅当=0 时有效 禁止呼出业务（请参考 3GPP TS 22.030），仅当=0 时有效 禁止呼入业务（请参考 3GPP TS 22.030），仅当=0 时有效 (U)SIM 卡固定拨号限制，当 ME 操作锁'FD'时，只有 FD 电话薄内的号码可以呼 叫（若当前会话中 PIN2 认证未完成，则需在中输入 PIN2） 网络个性化（请参考 3GPP TS 22.022） 网络子集个性化（请参考 3GPP TS 22.022） 服务提供商个性化（SP）（请参考 3GPP TS 22.022） 企业个性化（PH-CORP） 整型。操作模式。 0 解锁 1 锁定 2 查询状态 字符串类型。密码。 整型。数据类别。取值为以下业务类别的组合，默认值：7 = 1 + 2 + 4，表示除短消息以 外所有电话通讯。 1 语音 2 数据 4 传真 8 短消息 16 数据线路同步 32 数据线路异步 整型。设备状态。 0 未锁定 1 已锁定 错误码。详情参考第 13.3 章。 举例 AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK //查询(U)SIM 卡状态。 //(U)SIM 卡未被锁定。 //锁定(U)SIM 卡，且密码为'1234'。 //查询(U)SIM 卡状态。 //(U)SIM 卡被锁定。 //解锁(U)SIM 卡。 上海移远通信技术股份有限公司 61 / 273 RGx00U&RM500U 系列 AT 命令手册 4.3. AT+CPIN PIN 管理 该命令用于向 ME 发送操作需要的密码或查询模块是否需要在操作前输入密码，密码可为(U)SIM PIN、 (U)SIM PUK、PH-NET PIN 等。 查询命令返回字母数字字符串，指示是否需要密码。 进行操作之前，TA 必须已存储密码，如(U)SIM PIN、(U)SIM PUK 等。若为验证，输入，无需 输入；如果没有待处理的 PIN 请求，则不会实施任何操作，并且会返回错误+CME ERROR: ；如果所需密码为(U)SIM PUK、(U)SIM PUK2 等 PUK 类型密码，则需输入，用于替换 (U)SIM 中的旧 PIN。 AT+CPIN PIN 管理 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 +CPIN: OK 设置命令 AT+CPIN=[,] 若有任何错误： +CME ERROR: 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： +CME ERROR: 5秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。表示需要的密码类型。 READY MT 无密码输入请求 SIM PIN (U)SIM PIN 密码请求 SIM PUK (U)SIM PUK 密码请求 SIM PIN2 (U)SIM PIN2 密码请求 SIM PUK2 (U)SIM PUK2 密码请求 PH-NET PIN 网络个性化 PIN 密码请求 上海移远通信技术股份有限公司 62 / 273 RGx00U&RM500U 系列 AT 命令手册 PH-NET PUK 网络个性化 PUK 密码请求 PH-NETSUB PIN 网络子集个性化 PIN 密码请求 PH-NETSUB PUK 网络子集个性化 PUK 密码请求 PH-SP PIN 服务提供商 PIN 密码请求 PH-SP PUK 服务提供商 PUK 密码请求 PH-CORP PIN 企业个性化 PIN 密码请求 PH-CORP PUK 企业个性化 PUK 密码请求 字符串类型。PIN 码。 字符串类型。新 PIN 码。若请求的密码类型为 PUK，例如(U)SIM PUK、(U)SIM PUK2 等，则必须输入。 错误码。详情请参考第 13.3 章。 举例 //输入 PIN。 AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //输入 PUK 和新 PIN 码。 AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //查询有 PIN 码锁定，需要输入 PIN 码。 //输入 PIN 码。 //已输入 PIN 码。 //查询有 PUK 码锁定，需要输入 PUK 码。 //输入(U)SIM PUK 码和新 PIN 码。 //已输入(U)SIM PUK 码。 上海移远通信技术股份有限公司 63 / 273 RGx00U&RM500U 系列 AT 命令手册 4.4. AT+CPWD 修改密码 该命令用于修改 AT+CLCK 定义的功能锁定密码。 测试命令返回当前可用功能及对应密码最大长度的组合列表。 AT+CPWD 修改密码 测试命令 AT+CPWD=? 响应 +CPWD: 支持的(,)列表 设置命令 AT+CPWD=,, OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： +CME ERROR: 5秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。 'PS' (U)SIM 'P2' 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' 'AB' 'AG' 'AC' 'FD' 'PN' (U)SIM PIN2 (U)SIM（锁定当前所选卡槽中插入的(U)SIM/UICC 卡。在 MT 启动以及执行 功能锁定命令时，(U)SIM/UICC 会要求输入密码） BAOC（禁止所有呼出，请参考 3GPP TS 22.088 clause 1） BOIC（禁止所有国际呼出，请参考 3GPP TS 22.088 clause 1） BOIC-exHC（禁止除归属国以外所有国际呼出，请参考 3GPP TS 22.088 clause 1） BAIC（禁止所有呼入，请参考 3GPP TS 22.088 clause 2） BIC-Roam（归属国以外漫游时禁止所有呼入，请参考 3GPP TS 22.088 clause2） 禁止所有业务（请参考 3GPP TS 22.030），仅当=0 时有效 禁止所有呼出业务（请参考 3GPP TS 22.030），仅当=0 时有效 禁止所有呼入业务（请参考 3GPP TS 22.030），仅当=0 时有效 (U)SIM 卡固定拨号限制，当 ME 操作锁'FD'时，只有 FD 电话薄内的号码可 以呼叫（若当前会话中 PIN2 认证未完成，则需在中输入 PIN2） 网络个性化（请参考 3GPP TS 22.022） 上海移远通信技术股份有限公司 64 / 273 RGx00U&RM500U 系列 AT 命令手册 'PU' 'PP' 网络子集个性化（请参考 3GPP TS 22.022） 服务提供商个性化（SP）（请参考 3GPP TS 22.022） 'PC' 企业个性化（PH-CORP） 整型。密码最大长度。 当='AO' /'OI' /'OX' /'AI' /'IR' /'AB' /'AG' /'AC'时，密码最大长度为 4 字节； 当='PS' /'SC' /'P2' /'FD' / 'PN' /'PU' /'PP' /'PC'时，密码最大长度为 8 字节。 字符串类型。在用户界面或使用该命令指定的密码。 字符串类型。新设定的密码。 错误码。详情请参考第 13.3 章。 举例 AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' OK //重启模块或重激活(U)SIM 卡。 AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='4321' OK +CPIN: READY //修改(U)SIM 卡密码为'4321'。 //正在等待输入(U)SIM PIN 码。 //必须输入 PIN 码以定义新密码'4321'。 4.5. AT+CSIM 通用(U)SIM 卡访问 该命令允许通过 TE 上的远程应用直接控制安装在当前所选卡槽中的(U)SIM 卡。 AT+CSIM 通用(U)SIM 卡访问 测试命令 AT+CSIM=? 设置命令 AT+CSIM=, 响应 OK 响应 +CSIM: , OK 若有任何错误： 上海移远通信技术股份有限公司 65 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。或字符串实际长度。 字符串类型。MT 发送至(U)SIM 卡的命令，格式详情请参考 3GPP TS 51.011（十六 进制字符格式，详见 AT+CSCS）。 字符串类型。(U)SIM 卡向 MT 发送的响应，格式详情请参考 3GPP TS 51.011（十六 进制字符格式，详见 AT+CSCS）。 错误码。详情请参考第 13.3 章。 4.6. AT+CRSM 受限(U)SIM 卡访问 该命令用于提供对(U)SIM 数据库的简单而有限的访问，用于向 MT 传输(U)SIM 命令（） 及其所需的参数。 AT+CRSM 受限(U)SIM 卡访问 测试命令 AT+CRSM=? 设置命令 AT+CRSM=[,[,,,[,][,]]] 响应 OK 响应 +CRSM: ,[,] OK 最大响应时间 特性说明 参考 GSM 07.07 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 66 / 273 参数 RGx00U&RM500U 系列 AT 命令手册 整型。MT 发送至(U)SIM 的(U)SIM 命令。 176 READ BINARY（读取二进制文件） 178 READ RECORD（读取记录内容） 192 GET RESPONSE（获取响应） 214 UPDATE BINARY（更新二进制文件） 220 UPDATE RECORD（更新记录内容） 242 STATUS（状态查询） 203 RETRIEVE DATA（获取数据） 219 SET DATA（写入数据） 整型。(U)SIM 上 EF 文件标识符。除 GET RESPONSE 和 STATUS 外，其他命令均 需包含此参数。 MT 传到(U)SIM 卡的参数，除 GET RESPONSE 和 STATUS 外，其他命令均需包含 此参数。参数值请参考 3GPP TS 51.011。 十六进制字符串格式。待写入到(U)SIM 卡上的信息。详情请参考 AT+CSCS。 十六进制字符串格式。(U)SIM/UICC 中 EF 文件路径。 整型。(U)SIM 关于实际命令执行的信息。在命令执行成功或失败时，这些参数都会 传递给 TE。 十 六 进 制 字 符 串 格 式 。 命 令 发 送 成 功 后 的 响 应 。 详 情 参 考 AT+CSCS。 执 行 STATUS 和 GET RESPONSE 命令会返回数据，提供有关当前基本数据字段的信 息，包括文件类型及其大小（参考 3GPP TS 51.011）。在 READ BINARY，READ RECORD 或 RETRIEVE DATA 命令之后，将返回所请求的数据。成功执行 UPDATE BINARY、UPDATE RECORD 或 SET DATA 命令后，不会返回。 错误码。详情参考第 13.3 章。 4.7. AT+CCID 查询(U)SIM 卡 EF-ICCID 信息 该命令用于查询(U)SIM 卡的 EF-ICCID 信息。 AT+CCID 查询(U)SIM 卡 EF-ICCID 信息 测试命令 响应 AT+CCID=? 执行命令 OK 响应 AT+CCID +CCID: OK 最大响应时间 若有任何错误： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 67 / 273 RGx00U&RM500U 系列 AT 命令手册 特性说明 - 参考 3GPP TS 27.007 参数 字符串类型。(U)SIM 卡 ICCID。 错误码。详情请参考第 13.3 章。 举例 AT+CCID +CCID: 89860119801594358947 OK //查询(U)SIM 的 ICCID。 4.8. AT+QCCID 查询(U)SIM 卡 EF-ICCID 信息 该命令用于查询(U)SIM 卡的 EF-ICCID 信息，与 AT+CCID 相同。 AT+QCCID 查询(U)SIM 卡 EF-ICCID 信息 测试命令 响应 AT+QCCID=? 执行命令 OK 响应 AT+QCCID +QCCID: OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： +CME ERROR: 300 毫秒 - 参数 字符串类型。(U)SIM 卡 ICCID。 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 68 / 273 举例 AT+QCCID //查询(U)SIM 的 ICCID。 +QCCID: 89860119801594358947 OK RGx00U&RM500U 系列 AT 命令手册 4.9. AT+QPINC 获取 PIN 剩余重试次数 该命令用于查询剩余输入(U)SIM PIN/PUK 密码的次数。 AT+QPINC 获取 PIN 剩余重试次数 测试命令 AT+QPINC=? 响应 +QPINC: (支持的列表) 查询命令 AT+QPINC? OK 响应 +QPINC: 'SC',, +QPINC: 'P2',, 设置命令 AT+QPINC= OK 响应 +QPINC: ,, 最大响应时间 特性说明 OK 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。 'SC' (U)SIM PIN 'P2' (U)SIM PIN2 整型。剩余输入 PIN 密码的次数。 整型。剩余输入 PUK 密码的次数。 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 69 / 273 举例 AT+QPINC? +QPINC: 'SC',3,10 +QPINC: 'P2',3,10 OK RGx00U&RM500U 系列 AT 命令手册 4.10. AT+QINISTAT 查询(U)SIM 卡初始化状态 该命令用于查询(U)SIM 卡初始化状态。 AT+QINISTAT 查询(U)SIM 卡初始化状态 测试命令 AT+QINISTAT=? 响应 +QINISTAT: (支持的列表) 执行命令 AT+QINISTAT OK 响应 +QINISTAT: 最大响应时间 特性说明 OK 300 毫秒 - 参数 整型。(U)SIM 卡初始化状态。实际值为以下四种任意几种的数字和（例如：7 = 1 + 2 + 4 表示 CPIN 已就绪、SMS 初始化完成且电话簿初始化完成）。 0 未初始化状态 1 CPIN 已就绪，可执行锁定/解锁 PIN 操作 2 SMS 初始化完成 4 电话簿初始化完成 举例 AT+QINISTAT=? +QINISTAT: (0-5,7) OK AT+QINISTAT +QINISTAT: 0 //查询当前(U)SIM 卡初始化状态。 上海移远通信技术股份有限公司 70 / 273 RGx00U&RM500U 系列 AT 命令手册 OK 4.11. AT+QSIMDET 控制(U)SIM 卡检测 该命令用于查询/启用/禁用(U)SIM 卡的卡检测。GPIO 中断用于检测(U)SIM 卡，插入(U)SIM 卡时需设 置检测引脚的电平。 AT+QSIMDET 控制(U)SIM 卡检测 测试命令 AT+QSIMDET=? 响应 +QSIMDET: (支持的列表),(支持的 列表) 查询命令 AT+QSIMDET? OK 响应 +QSIMDET: , 设置命令 AT+QSIMDET=, OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 3秒 该命令重启后生效； 参数配置后自动保存。 参数 整型。启用/禁用(U)SIM 卡检测功能。 0 禁用 1 启用 整型。插入(U)SIM 卡时检测引脚的电平状态。 0 低电平 1 高电平 上海移远通信技术股份有限公司 71 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 1. 仅当配置的值与检测引脚的硬件设计一致时，热插拔功能才有效。 2. 只有当模块未检测到(U)SIM 卡或处于最小功能模式（AT+CFUN=0）时，才能通过该命令控制 (U)SIM 卡检测功能。 举例 AT+QSIMDET=1,0 OK //拔出(U)SIM 卡。 +CPIN: NOT READY //插入(U)SIM 卡。 +CPIN: READY //设置(U)SIM 卡插入时(U)SIM 检测引脚为低电平。 //(U)SIM 卡的 PIN1 未锁定的情况下会返回该 URC。 4.12. AT+QUIMSLOT 切换物理(U)SIM 卡槽 该命令用于查询和设置物理(U)SIM 卡槽。 AT+QUIMSLOT 切换物理(U)SIM 卡槽 测试命令 AT+QUIMSLOT=? 响应 +QUIMSLOT: (支持的列表) 查询命令 AT+QUIMSLOT? OK 响应 +QUIMSLOT: 设置命令 AT+QUIMSLOT= 最大响应时间 特性说明 OK 响应 OK 若有任何错误： ERROR 5秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 72 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。物理(U)SIM 卡槽。 1 (U)SIM 卡槽 1 2 (U)SIM 卡槽 2 举例 AT+QUIMSLOT? +QUSIMSLOT: 1 OK AT+QUIMSLOT=2 OK //查询当前使用的(U)SIM 卡槽。 //设置为(U)SIM 卡槽 2。 4.13. AT+QSIMSTAT (U)SIM 卡插拔状态上报 该命令用于查询/启用/禁用(U)SIM 卡的插拔状态上报功能。 AT+QSIMSTAT (U)SIM 卡插拔状态上报 测试命令 AT+QSIMSTAT=? 响应 +QSIMSTAT: (支持的列表) 查询命令 AT+QSIMSTAT? OK 响应 +QSIMSTAT: , 设置命令 AT+QSIMSTAT= OK 响应 OK 最大响应时间 特性说明 若有任何问题： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 73 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。启用/禁用(U)SIM 卡插拔状态上报功能。启用时，当(U)SIM 卡拔出或插入 时，将上报 URC +QSIMSTAT: ,。 0 禁用 1 启用 整型。(U)SIM 卡插入或拔出状态。 0 拔出 1 插入 举例 AT+QSIMSTAT? +QSIMSTAT: 0,1 OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 OK //拔出(U)SIM 卡。 +QSIMSTAT: 1,0 +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK //插入(U)SIM 卡。 +QSIMSTAT: 1,1 +CPIN: READY //查询(U)SIM 卡插拔状态。 //启用(U)SIM 卡插拔状态上报功能。 //(U)SIM 卡插拔状态上报：拔出。 //(U)SIM 卡插拔状态上报：插入。 上海移远通信技术股份有限公司 74 / 273 RGx00U&RM500U 系列 AT 命令手册 4.14. AT+QSIMLOCK 配置功能锁 该命令用于设置或查询功能锁。 AT+QSIMLOCK 配置功能锁 测试命令 AT+QSIMLOCK=? 响应 +QSIMLOCK: (支持的列表) 设置命令 AT+QSIMLOCK=[,[,,]] OK 响应 若省略可选参数，则查询当前配置： 若='PN'， +PN: [,,,[,,,[,…]]] OK 若='PU'， +PU: [,,,,,[,,,,,[,…]]] OK 若='PP'， +PP: [,,,,[,,,,[,…]]] OK 若='PC'， +PC: [,,,,,[,,,,,[,…]]] OK 若指定可选参数，配置功能锁： OK 若有任何错误： ERROR 上海移远通信技术股份有限公司 75 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 取决于长度 该命令在模块重启或通过 AT+CFUN 切换后生效； 参数配置自动保存。 参数 字符串类型。 'PN' 网络个性化（请参考 3GPP TS 22.022） 'PU' 网络子集个性化（请参考 3GPP TS 22.022） 'PP' 服务提供商个性化（SP）（请参考 3GPP TS 22.022） 'PC' 企业个性化（PH-CORP）（请参考 3GPP TS 22.022） 字符串类型。密码。长度固定为 8。单位：字节。 整型。移动设备网络代码的长度。可以是 2 位或 3 位数字。单位：字节。 字符串类型。需要锁定的列表。 若='PN'，格式为：''，例如：'46001'； 若='PU'，格式为：''，例如： '4600145'； 若='PP'，格式为：''，例如：'460017'； 若='PC'，格式为：''，例如：'4600178'。 一次最多设置 20 项，每一项用逗号隔开，也可通过连接符表示一个范围，例如： '46001-46005,46006'。 整型。被锁定的的个数。 16 位无符号整型。移动设备国家代码（PLMN 码的第一部分）。 16 位无符号整型。移动设备网络代码（PLMN 码的第二部分）。 整型。IMSI 号第 6 位。 整型。IMSI 号第 7 位。 整型。GID 等级 1 的第 1 位。 整型。GID 等级 2 的第 1 位。 举例 AT+QSIMLOCK=? +QSIMLOCK: ('PN','PU','PP','PC') //查询支持的个性化设备锁。 OK AT+QSIMLOCK='PN','12345678',2,'12345,46001' //锁定 PLMN 12345 和 46001。 OK AT+QSIMLOCK='PN' //查询 PN 锁状态。 +PN: 2,123,45,2,460,1,2 OK AT+QSIMLOCK='PN','12345678' OK //解锁 PN 锁。 上海移远通信技术股份有限公司 76 / 273 RGx00U&RM500U 系列 AT 命令手册 5 网络服务命令 5.1. AT+COPS 选择运营商 该命令用于查询、配置当前模块的找网模式，并查询模块的注网状态。同时还可用于配置注册的运营 商以及网络制式。 测试命令返回运营商列表，显示顺序为：归属地网络，(U)SIM 卡推荐网络和其他网络。 查询命令返回当前找网模式和当前所选运营商。如果未选择任何运营商，则不会返回、 和。 设置命令用于强制选择并注册网络运营商，即使所选的网络运营商不可用，也不可选择其他任何运营 商（=4 除外）。所选运营商名称的格式也应适用于查询命令 AT+COPS?。 AT+COPS 选择运营商 测试命令 AT+COPS=? 响应 +COPS: [支持的(,全称,简称,数 字代号[,])列表][...][,,(支持的范围),(支持的范围)] OK 查询命令 AT+COPS? 若错误与 MT 功能相关： +CME ERROR: 响应 +COPS: [,,[,]] OK 设置命令 AT+COPS=[,[,[,]]] 若错误与 MT 功能相关： +CME ERROR: 响应 OK 若错误与 MT 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 77 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 180 秒，取决于网络状态 - 参数 整型。网络状态标识。 0 未知 1 可用 2 已注册 3 禁止选择的运营商 字符串类型。运营商名称。 整型。网络选择模式。 0 自动搜网，省略和 1 手动搜网，不可省略且可选 2 手动注销网络 3 仅设置（用于查询命令 AT+COPS?）；并不尝试进行注册或注销（省略 和）；该取值不适用于查询命令的返回结果 4 手动/自动的联合，字段不可省略；如果手动选择失败，将进入自动选择模 式（=0） 整型。的格式。 0 长字符串格式，最多 16 个字符 1 短字符串格式 2 数字格式 整型。网络制式。取值 4、5 和 6 仅适用于当 MS 处于数据服务状态时查询命令的返回 结果。 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 10 连接到 5GCN 的 E-UTRAN 11 连接到 5GCN 的 NR 12 NG-RAN 13 E-UTRAN-NR 双重连接 15 HSPA+ 16 LTE(CA) 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 78 / 273 RGx00U&RM500U 系列 AT 命令手册 举例 AT+COPS=? //列举当前网络运营商。 +COPS: (1,'CHN-UNICOM','UNICOM','46001',2),(2,'CHN-UNICOM','UNICOM','46001',7),(3,'CH N-CT','CT','46011',7),(3,'CHINA MOBILE','CMCC','46000',7),,(0-4),(0-2) OK AT+COPS? +COPS: 0,0,'CHINA-UNICOM',7 //查询当前模块的找网模式和运营商。 OK AT+COPS=3,0;+COPS? +COPS: 0,0,'CHINA TELECOM',12 //设置查询的运营商名称格式为长字符串格式。 OK AT+COPS=3,1;+COPS? +COPS: 0,1,'CTCC',12 //设置查询的运营商名称格式为短字符串格式。 OK AT+COPS=3,2;+COPS? +COPS: 0,2,'46011',12 //设置查询的运营商名称格式为数字格式。 OK 5.2. AT+CREG CS 域注册状态 查询命令返回 CS 域网络注册状态以及设置状态上报方式。设置命令设置是否上报 URC 并控制 URC 显示格式。 AT+CREG CS 域注册状态 测试命令 AT+CREG=? 响应 +CREG: (支持的范围) 查询命令 AT+CREG? OK 响应 +CREG: ,[,,[,]] OK 设置命令 若错误与 MT 功能相关： +CME ERROR: 响应 上海移远通信技术股份有限公司 79 / 273 RGx00U&RM500U 系列 AT 命令手册 AT+CREG= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。是否启用网络注册相关 URC。 0 禁用网络注册 URC 1 启用网络注册 URC +CREG: 2 启用网络注册和位置信息 URC +CREG: [,,[,]] 整型。注册状态。 0 未注册，MT 当前未处于搜索和注册新的营运商状态 1 已注册归属地网络 2 未注册，MT 正在搜索并注册新的营运商 3 注册被拒绝 4 未知状态 5 已注册漫游网络 8 紧急服务 字符串类型。位置区编号。两个字节（16 进制格式）。仅当=2 且注册到网络时， 查询命令才会返回此参数信息。 字符串类型。小区 ID。UMTS/LTE 网络制式下 28 位（16 进制格式）。仅当=2 且 注册到网络时，查询命令才会返回此参数信息。 整型。网络制式。 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 10 连接到 5GCN 的 E-UTRAN 11 连接到 5GCN 的 NR 12 NG-RAN 13 E-UTRAN-NR 双重连接 15 HSPA+ 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 80 / 273 举例 AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'D509','80D413D',7 RGx00U&RM500U 系列 AT 命令手册 //启用网络注册 URC。 //URC 上报 MT 已经注册到网络。 //启用网络注册和位置信息 URC。 //URC 上报带小区 ID 和位置区编号的运营商。 5.3. AT+CSQ 查询信号强度和信道误码率 该命令用于查询当前服务小区接收信号强度和信道误码率。 AT+CSQ 查询信号强度和信道误码率 测试命令 AT+CSQ=? 响应 +CSQ: (支持的列表),(支持的列表) 执行命令 AT+CSQ OK 响应 +CSQ: , OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 - 参数 整型。接收信号强度指示。 0 小于等于-113 dBm 1 -111 dBm 2~30 -109 ~ -53 dBm 31 大于或等于-51 dBm 99 未知或不可测 整型。信道误码率。百分比格式。 上海移远通信技术股份有限公司 81 / 273 RGx00U&RM500U 系列 AT 命令手册 0~7 3GPP TS 45.008 subclause 8.2.4 表格中的 RxQual 值 99 未知或不可测 错误码。详情请参考第 13.3 章。 备注 执行网络相关命令（如 AT+CCWA 和 AT+CCFC）后，建议等待 3 秒后再执行 AT+CSQ 以确保之前执行 的命令所需的网络访问已经完成。 举例 AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,99 //查询当前信号强度指示为 28，误码率未知或不可测。 OK 5.4. AT+CPOL 配置首选运营商列表 该命令用于配置或者查询首选运营商列表。 AT+CPOL 配置首选运营商列表 测试命令 AT+CPOL=? 响应 +CPOL: (支持的列表),(支持的范围) 查询命令 AT+CPOL? OK 响应 +CPOL: ,,[,,,,,] […] 设置命令 AT+CPOL=[,[,[,, ,,]]] OK 响应 若省略可选参数，则删除当前索引号为的 PLMN： OK 若指定任意可选参数，则配置首选运营商： OK 上海移远通信技术股份有限公司 82 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。(U)SIM 卡 PLMN 的序号。 整型。的显示格式。 0 长字符串格式 1 短字符串格式 2 数字格式 字 符 串 类 型 。 运 营 商 名 称 。表 示 该 参 数 采 用 的 格 式 （ 参 考 AT+COPS）。 整型。GSM 访问技术。 0 未选中 1 已选中 整型。GSM compact 访问技术。 0 未选中 1 已选中 整型。UTRAN 访问技术。 0 未选中 1 已选中 整型。E-UTRAN 访问技术。 0 未选中 1 已选中 整型。NG-RAN 访问技术。 0 未选中 1 已选中 错误码。详情请参考第 13.3 章。 备注 访 问 技 术 选 择 参 数、、、和， 取 决 于 (U)SIM 卡或 UICC 卡中所具有访问技术的 PLMN 选择器。 上海移远通信技术股份有限公司 83 / 273 RGx00U&RM500U 系列 AT 命令手册 5.5. AT+COPN 查询运营商名称 该命令用于从 MT 查询运营商名称信息。 AT+COPN 查询运营商名称 测试命令 AT+COPN=? 执行命令 AT+COPN 响应 OK 响应 +COPN: , [+COPN: , […]] OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 取决于运营商个数 - 参数 字符串类型。数字格式的运营商名称（请参考 AT+COPS）。 字符串类型。长字符串格式的运营商名称（请参考 AT+COPS）。 错误码。详情请参考第 13.3 章。 5.6. AT+CTZU 自动更新时区 该命令用于启用/禁用通过 NITZ 自动更新时区功能。 AT+CTZU 自动更新时区 测试命令 AT+CTZU=? 响应 +CTZU: (支持的列表) 设置命令 AT+CTZU= OK 响应 OK 上海移远通信技术股份有限公司 84 / 273 RGx00U&RM500U 系列 AT 命令手册 查询命令 AT+CTZU? 最大响应时间 特性说明 参考 3GPP TS 27.007 如有任何错误： ERROR 响应 +CTZU: OK 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。自动更新时区模式。 0 禁用通过 NITZ 自动更新时区 1 启用通过 NITZ 自动更新时区 举例 AT+CTZU? +CTZU: 0 OK AT+CTZU=? +CTZU: (0,1) OK AT+CTZU=1 OK AT+CTZU? +CTZU: 1 OK //启用通过 NITZ 自动更新时区功能。 上海移远通信技术股份有限公司 85 / 273 RGx00U&RM500U 系列 AT 命令手册 5.7. AT+CTZR 上报时区变化 该命令用于启用/禁用时区变化事件的上报。 AT+CTZR 上报时区变化 测试命令 AT+CTZR=? 响应 +CTZR: (支持的范围) 查询命令 AT+CTZR? OK 响应 +CTZR: 设置命令 AT+CTZR= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。是否上报时区变化。 0 不上报 1 通过 URC +CTZV: 上报时区变化 2 通过扩展 URC +CTZE: ,,上报时区信息和本地时间 3 通过扩展 URC +CTZEU: ,,上报时区信息和世界时间 字符串类型。本地时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异）与夏 令时之和；格式为'±zz'，为两个整型数字的固定宽度。范围：-48 ~ +56。 为保证固定宽度，-9 ~ +9 之间的数字前加 0，例如：'-09'，'+00'，'+09'。 整型。中是否包括夏令时调整。 0 不包括夏时令调整 1 包括+1 小时（相当于的一个小时）的夏令时调整 2 包括+2 小时（相当于的两个小时）的夏令时调整 字 符 串 类 型 。 本 地 时 间 。 格 式 ：'YYYY/MM/DD,hh:mm:ss'， 用 于 表 示 年 （YYYY），月（MM），日（DD），时（hh），分（mm）和秒（ss）。传送时区 上海移远通信技术股份有限公司 86 / 273 RGx00U&RM500U 系列 AT 命令手册 信息时由网络提供该参数值，并在扩展 URC 中显示。 字 符 串 类 型 。 世 界 时 间 。 格 式 ：'YYYY/MM/DD,hh:mm:ss'， 用 于 表 示 年 （YYYY），月（MM），日（DD），时（hh），分（mm）和秒（ss）。传送时区 信息时由网络提供该参数值，并在扩展 URC 中显示。 举例 AT+CTZR=2 OK AT+CTZR? +CTZR: 2 //配置通过扩展 URC +CTZE: ,,上报时区信息和本地时间。 OK +CTZE: '+32',0,'2018/03/23,06:51:13' 5.8. AT+QNWINFO 查询网络信息 该命令用于查询网络信息，例如选中的访问技术、运营商以及选中的频段。 AT+QNWINFO 查询网络信息 测试命令 AT+QNWINFO=? 执行命令 AT+QNWINFO 响应 OK 响应 +QNWINFO: ,,, 最大响应时间 特性说明 OK 300 毫秒 - 参数 字符串类型。选中的访问技术。 'NONE' 'WCDMA' 'HSDPA' 'HSUPA' 'HSPA+' 'TDD LTE' 'FDD LTE' 上海移远通信技术股份有限公司 87 / 273 RGx00U&RM500U 系列 AT 命令手册 'NR5G-NSA' 'NR5G-SA' 字符串类型。数字格式的运营商名称。 字符串类型。选中的频段。 'WCDMA 2100' 'WCDMA 1900' 'WCDMA 850' 'WCDMA 900' 'LTE BAND 1' 'LTE BAND 2' 'LTE BAND 3' 'LTE BAND 4' 'LTE BAND 5' 'LTE BAND 7' 'LTE BAND 8' 'LTE BAND 20' 'LTE BAND 28' 'LTE BAND 38' 'LTE BAND 39' 'LTE BAND 40' 'LTE BAND 41' 'LTE BAND 66' 'NR N1' 'NR N3' 'NR N7' 'NR N8' 'NR N20' 'NR N28' 'NR N38' 'NR N40' 'NR N41' 'NR N77' 'NR N78' 'NR N79' 整型。信道 ID。 举例 AT+QNWINFO //查询当前网络信息。 +QNWINFO: 'FDD LTE',46001,'LTE BAND 3',1650 OK 上海移远通信技术股份有限公司 88 / 273 RGx00U&RM500U 系列 AT 命令手册 5.9. AT+QENG 查询服务小区和邻区信息 该命令用于查询服务小区和邻区信息。 AT+QENG 查询主小区和邻区信息 测试命令 AT+QENG=? 响应 +QENG: (支持的列表) 设置命令 查询服务小区信息 AT+QENG='servingcell' OK 响应 NR 模式： +QENG: 'servingcell',,'NR5G-SA',,,,,,,,,,,,,,, OK EN-DC 模式： +QENG: 'servingcell', +QENG: 'LTE',,,,,,,,,,,,,,,,, +QENG: 'NR5G-NSA',,,,,,,,,,, OK LTE 模式： +QENG: 'servingcell',,'LTE',,, ,,,,, ,,,,,,,,, OK WCDMA 模式： +QENG: 'servingcell',,'WCDMA',,,,,,,,,,, 上海移远通信技术股份有限公司 89 / 273 设置命令 查询邻区信息 AT+QENG='neighbourcell' 上海移远通信技术股份有限公司 RGx00U&RM500U 系列 AT 命令手册 OK 响应 NR/EN-DC 模式： [+QENG: 'neighbourcell','NR',,,,,,, …] [+QENG: 'neighbourcell','LTE',,,< RSRP>,,,, …] OK LTE 模式： [+QENG: 'neighbourcell intra','LTE',,,,,,,,,, +QENG: 'neighbourcell inter','LTE',,,,,,,,,, …] [+QENG: 'neighbourcell','WCDMA',,,,,,,,,, …] [+QENG: 'neighbourcell','NR',,,,,, …] OK WCDMA 模式： [+QENG: 'neighbourcell','WCDMA',,,,,,,,,,, …] [+QENG: 'neighbourcell','LTE',,,,,,,,,, …] 90 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 OK 300 毫秒 - 参数 字符串类型。不同小区的信息。 'servingcell' 3G/4G/5G 服务小区的信息 'neighbourcell' 3G/4G/5G 邻区信息 字符串类型。UE 状态。 'SEARCH' UE 正在搜索但未找到合适的 3G/4G/5G 小区 'LIMSRV' 'NOCONN' UE 正在驻留一个小区但未注册到网络 UE 正在驻留一个小区且已注册到网络，且处于 RRC idle 'CONNECT' UE 正 在 驻 留 一 个 小 区 且 已 注 册 到 网 络 ， 且 处 于 RRC Connected 字符串类型。5G NR SA 网络模式。 'FDD' 'TDD' 16 位无符号整型。移动设备国家代码（PLMN 码的第一部分）。 16 位无符号整型。移动设备网络代码（PLMN 码的第二部分）。 十六进制格式的小区 ID。28 位（UMTS 和 LTE）或者 36 位（5G NR）。 范围：0~0xFFFFFFF。 整型。物理小区 ID。 整型。当前小区的物理 ID。 整型。跟踪区编码（请参考 3GPP 23.003 19.4.2.3）。 整型。32 位。5G NR/SA 网络模式的频段。 整型。下行带宽。 5 5 MHz 10 10 MHz 15 15 MHz 20 20 MHz 25 25 MHz 30 30 MHz 40 40 MHz 50 50 MHz 60 60 MHz 80 80 MHz 90 90 MHz 100 100 MHz 200 200 MHz 上海移远通信技术股份有限公司 91 / 273 RGx00U&RM500U 系列 AT 命令手册 400 400 MHz 整型。选择基站的接收电平值（请参考 3GPP 25.304）。单位：dB。 整型。子载波间隔。 0 15 KHz 1 30 KHz 2 60 KHz 3 120 KHz 4 240 KHz 字符串类型。LTE 网络模式。 'TDD' 'FDD' 整型。被扫描小区的 SA-ARFCN。 被扫描小区的 E-UTRA 绝对射频信道号码。 被扫描小区的 UTRA 绝对射频信道号码。 E-UTRA 频段（请参考 3GPP 36.101）。 整型。上行带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 255 无效值 整型。下行带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 255 无效值 整型。位置区域码。以十六进制格式表示被扫描小区的 2 字节位置区域码。 - 表示未获取到相应值 整型。路由区域码。范围：0~255。 被扫描小区的主扰码。 被扫描小区的接收信号码功率电平。 整型。 5G NR 模式： 5G NR 参考信号接收功率的信号。范围： -156 ~ -31；单位：dBm。该参数 值越接近-31，信号越强，越接近-156，信号越弱。 LTE 模式： 表示当前 LTE 参考信号接收功率的信号。范围：-140 ~ -44；单位：dBm。该 参数值越接近-44，信号越强，越接近-140，信号越弱。 上海移远通信技术股份有限公司 92 / 273 RGx00U&RM500U 系列 AT 命令手册 整型。 5G NR 模式： 表示当前 5G NR 参考信号接收质量的信号。范围：-43~20；单位：dB。该参 数值越接近 20，信号越强，越接近-43，信号越弱。 LTE 模式： 表示当前 LTE 参考信号接收质量的信号。范围：-19.5 ~ -3；单位：dB。该参 数值越接近-3，信号越强，越接近-19.5，信号越弱。 接收信号强度指示。 整型。 5G NR 模式： 5G NR 信噪比。范围：-23~40；单位：dB。 LTE 模式： LTE 信噪比。范围：-23~40；单位：dB。 整型。信道质量指示。范围：0~15。 TX 功率值，为所有上行信道 TX 功率最大值。单位：dBm。 整型。码片能量与功率谱密度的比值，等于以 dB 为单位测量的 Ec/Io 值。 单位：dB。 整型。物理信道。 0 DPCH 1 FDPCH 整型。扩频因子。 0 SF_4 1 SF_8 2 SF_16 3 SF_32 4 SF_64 5 SF_128 6 SF_256 7 SF_512 8 未知 整型。 0~16：DPCH 的插槽格式。 0~9：FDPCH 的插槽格式。 接收机对预占频率的自动增益控制。 整型。3G 邻区集。 1 活跃的小区集 2 同步的邻区集 3 异步的邻区集 跨系统小区重选邻区的等级。 整型。小区重选优先级。范围：0~7。 要考虑重选。评估的低优先级小区的合适接收电平值必须大于该值。 要考虑重选。评估的高优先级小区的合适接收电平值必须大于该值。 高优先级小区的重选阈值。 上海移远通信技术股份有限公司 93 / 273 低优先级小区的重选阈值。 整型。RAT 类型。 1 3G 16 4G 32 5G 13 EN-DC 备注 '-'或者-表示该参数在当前条件下无效。 RGx00U&RM500U 系列 AT 命令手册 举例 AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','NR5G-SA','TDD',460,00,314054003,377,161806,504990,41,25, 101,-5,9,0,18,1 OK AT+QENG='neighbourcell' +QENG: 'neighbourcell','NR',504990,375,-107,-11,1,-,32 +QENG: 'neighbourcell','NR',504990,357,-105,-9,0,-,32 +QENG: 'neighbourcell','NR',504990,376,-109,-13,-4,-,32 OK 5.10. AT+QNWPREFCFG 配置网络搜索偏好 该命令用于配置网络搜索偏好。 AT+QNWPREFCFG 配置网络搜索偏好 测试命令 AT+QNWPREFCFG=? 响应 +QNWPREFCFG: 'gw_band',(支持的列表) +QNWPREFCFG: 'lte_band',(支持的列表) +QNWPREFCFG: 'nr5g_band',(支持的列表) +QNWPREFCFG: 'all_band_reset' +QNWPREFCFG: 'mode_pref',(支持的列表) +QNWPREFCFG: 'srv_domain',(支持的范围) +QNWPREFCFG: 'voice_domain',(支持的范围) +QNWPREFCFG: 'ue_usage_setting',(支持的列表) +QNWPREFCFG: 'roam_pref',(支持的范围) 上海移远通信技术股份有限公司 94 / 273 最大响应时间 特性说明 OK 300 毫秒 - RGx00U&RM500U 系列 AT 命令手册 5.10.1. AT+QNWPREFCFG='gw_band' 配置 WCDMA 频段 该命令用于指定 UE 待搜索的 WCDMA 频段。 AT+QNWPREFCFG='gw_band' 配置 WCDMA 频段 设置命令 AT+QNWPREFCFG='gw_band'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'gw_band', OK 若指定可选参数，配置待搜索的 WCDMA 频段： OK 最大响应时间 特性说明 若有任何错误： ERROR 3秒 该命令立即生效； 参数配置自动保存。 参数 字 符 串 类 型 。 待 搜 索 的 WCDMA 频 段 列 表 ， 以 冒 号 隔 开 。 格 式 ：1:2:…:n。 =0 表示将 WCDMA 的频段恢复到初始状态，即所有支持的 WCDMA 频段。 有关支持频段的详细信息，请参考文档 [1]、文档 [2]和文档 [3]。 举例 AT+QNWPREFCFG='gw_band',1 OK AT+QNWPREFCFG='gw_band' +QNWPREFCFG: 'gw_band',1 OK //设置搜索 WCDMA B1。 //查询当前为 UE 配置的 WCDMA 频段。 上海移远通信技术股份有限公司 95 / 273 RGx00U&RM500U 系列 AT 命令手册 5.10.2. AT+QNWPREFCFG='lte_band' 配置 LTE 频段 该命令用于指定 UE 待搜索的 LTE 频段。 AT+QNWPREFCFG='lte_band' 配置 LTE 频段 设置命令 AT+QNWPREFCFG='lte_band'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'lte_band', OK 若指定可选参数，配置待搜索的 LTE 频段： OK 最大响应时间 特性说明 若有任何错误： ERROR 3秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。待搜索的 LTE 频段列表，以冒号隔开。格式：1:2:…:n。=0 表示将 LTE 的频段恢复到初始状态，即所有支持的 LTE 频段。有关支持频段的详细信 息，请参考文档 [1]、文档 [2]和文档 [3]。 举例 AT+QNWPREFCFG='lte_band',1:2:3 OK AT+QNWPREFCFG='lte_band' +QNWPREFCFG: 'lte_band',1:2:3 OK //设置 LTE B1、LTE B2 和 LTE B3。 //查询当前为 UE 配置的 LTE 频段。 上海移远通信技术股份有限公司 96 / 273 RGx00U&RM500U 系列 AT 命令手册 5.10.3. AT+QNWPREFCFG='nr5g_band' 配置 5G NR 频段 该命令用于指定 UE 待搜索的 5G NR 频段。 AT+QNWPREFCFG='nr5g_band' 配置 5G NR 频段 设置命令 AT+QNWPREFCFG='nr5g_band'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'nr5g_band', OK 若指定可选参数，配置待搜索的 5G NR 频段： OK 最大响应时间 特性说明 若有任何错误： ERROR 3秒 该命令立即生效； 参数配置自动保存。 参数 字 符 串 类 型 。 待 搜 索 的 5G NR 频 段 列 表 ， 以 冒 号 隔 开 。 格 式 ：1:28:…:n。 =0 表示将 5G NR 的频段恢复到初始状态，即所有支持的 5G NR 频段。 有关支持频段的详细信息，请参考文档 [1]、文档 [2]和文档 [3]。 举例 AT+QNWPREFCFG= 'nr5g_band',1:79 OK AT+QNWPREFCFG='nr5g_band' +QNWPREFCFG: 'nr5g_band',1:79 OK //设置 5G NR 频段：n1 和 n79。 //查询当前为 UE 配置的 5G NR 频段。 上海移远通信技术股份有限公司 97 / 273 RGx00U&RM500U 系列 AT 命令手册 5.10.4. AT+QNWPREFCFG='all_band_reset' 重置所有制式频段设置 该命令用于重置所有制式频段设置。 AT+QNWPREFCFG='all_band_reset' 重置所有制式频段设置 设置命令 响应 AT+QNWPREFCFG='all_band_reset' OK 最大响应时间 特性说明 若有任何错误： ERROR 3秒 该命令立即生效； 参数配置自动保存。 举例 AT+QNWPREFCFG='all_band_reset' //将所有制式的频段恢复到初始状态。 OK 5.10.5. AT+QNWPREFCFG='mode_pref' 配置网络搜索模式 该命令用于指定网络搜索模式。 AT+QNWPREFCFG='mode_pref' 配置网络搜索模式 设置命令 AT+QNWPREFCFG='mode_pref'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'mode_pref', OK 若指定可选参数，配置网络搜索模式： OK 最大响应时间 特性说明 若有任何错误： ERROR 3秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 98 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 字符串类型。待配置的 RAT 列表，以冒号隔开。格式：RAT1:RAT2:…RATn。模块支 持如下 RAT： AUTO WCDMA 5G NR & LTE & WCDMA 仅 WCDMA LTE 仅 LTE NR5G 5G NR NR5G-SA 仅 5G NR SA NR5G-NSA 仅 5G NR NSA 举例 AT+QNWPREFCFG='mode_pref' +QNWPREFCFG: 'mode_pref',AUTO //查询当前网络搜索模式。 OK AT+QNWPREFCFG='mode_pref',LTE //设置 RAT 为仅 LTE。 OK AT+QNWPREFCFG='mode_pref',NR5G-SA //设置 RAT 为仅 NR5G SA。 OK AT+QNWPREFCFG='mode_pref',NR5G-NSA //设置 RAT 为仅 NR5G NSA。 OK AT+QNWPREFCFG='mode_pref',NR5G:LTE //设置 RAT 为仅 NR5G 和 LTE 组合。 OK 5.10.6. AT+QNWPREFCFG='srv_domain' 配置服务域 该命令用于配置服务域。 AT+QNWPREFCFG='srv_domain' 配置服务域 设置命令 AT+QNWPREFCFG='srv_domain'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'srv_domain', OK 若指定可选参数，配置 UE 的服务域： OK 最大响应时间 若有任何错误： ERROR 300 毫秒 上海移远通信技术股份有限公司 99 / 273 特性说明 RGx00U&RM500U 系列 AT 命令手册 该命令立即生效； 参数配置自动保存。 参数 整型。UE 的服务域。 0 仅 CS 1 仅 PS 2 CS & PS 举例 AT+QNWPREFCFG='srv_domain' +QNWPREFCFG: 'srv_domain',2 //查询当前配置。 OK AT+QNWPREFCFG='srv_domain',1 OK //设置为仅 PS。 5.10.7. AT+QNWPREFCFG='voice_domain' 配置语音域 该命令用于配置 UE 的语音域。 AT+QNWPREFCFG='voice_domain' 配置语音域 设置命令 AT+QNWPREFCFG='voice_domain'[, ] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'voice_domain', OK 若指定可选参数，配置 UE 的语音域： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 100 / 273 参数 整型。UE 的语音域。 0 仅 CS 语音 1 仅 IMS PS 语音 2 首选 CS 语音 3 首选 IMS 语音 举例 AT+QNWPREFCFG='voice_domain' +QNWPREFCFG: 'voice_domain',2 OK AT+QNWPREFCFG='voice_domain',3 OK RGx00U&RM500U 系列 AT 命令手册 //查询当前配置。 //设置 IMS 语音为首选。 5.10.8. AT+QNWPREFCFG='ue_usage_setting' 配置 UE 使用模式 该命令用于指定 UE 使用模式。 AT+QNWPREFCFG='ue_usage_setting' 配置 UE 使用模式 设置命令 AT+QNWPREFCFG='ue_usage_settin g'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'ue_usage_setting', OK 若指定可选参数，配置 UE 使用模式： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。UE 使用模式。 0 语音优先 1 数据优先 上海移远通信技术股份有限公司 101 / 273 RGx00U&RM500U 系列 AT 命令手册 举例 AT+QNWPREFCFG='ue_usage_setting' +QNWPREFCFG: 'ue_usage_setting',1 //查询当前配置。 OK AT+QNWPREFCFG='ue_usage_setting',0 OK //设置语音优先。 5.10.9. AT+QNWPREFCFG='roam_pref' 配置漫游偏好 该命令用于配置 UE 漫游偏好。 AT+QNWPREFCFG='roam_pref' 配置漫游偏好 设置命令 AT+QNWPREFCFG='roam_pref'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'roam_pref', OK 若指定可选参数，配置 UE 漫游偏好： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。UE 漫游偏好。 0 开启国内国际漫游 1 开启国内漫游，关闭国际漫游 2 关闭国内漫游，开启国际漫游 3 关闭国内国际漫游 举例 AT+QNWPREFCFG='roam_pref' +QNWPREFCFG: 'roam_pref',0 OK //查询当前配置。 上海移远通信技术股份有限公司 102 / 273 AT+QNWPREFCFG= 'roam_pref',1 OK RGx00U&RM500U 系列 AT 命令手册 //开启国内漫游，关闭国际漫游。 5.11. AT+QREJINFO 查询网络拒绝原因 该命令用于查询在进行注册、业务请求、网络去附着过程中网络下发的拒绝原因值或(U)SIM 鉴权失败 的原因值。仅支持查询协议中明确规定的拒绝原因值、内部扩展的鉴权失败（#256）、联合注册中 CS 失 败的其他原因值（#258，除#2、#16、#17、#22 的其他原因值）、CS/PS 注册网络无响应（#301）及 CS/PS 注册建链异常（#302、#303）。 该命令支持查询的(U)SIM 鉴权失败原因值从#65537 开始，包括#65537、#65538、#65539、#65540、 #65541。重新接入成功后，会清除网络拒绝原因值。 AT+QREJINFO 查询网络拒绝原因 测试命令 响应 AT+QREJINFO=? OK 查询命令 AT+QREJINFO? 如有任何错误： ERROR 响应 +QREJINFO: ,,,,,,,,[,] 最大响应时间 特性说明 OK 300 毫秒 - 参数 网络 ID。 整型。上报拒绝原因值的服务域。 0 仅 CS 1 仅 PS 2 CS + PS 整型。网络拒绝原因。 整型。被拒的网络类型。 0 GERAN 1 UTRAN 2 E-UTRAN 上海移远通信技术股份有限公司 103 / 273 RGx00U&RM500U 系列 AT 命令手册 3 1X 4 HRPD 5 NR-5GC 6 其他 整型。网络被拒类型。 0 LAU 被拒 1 鉴权失败 2 业务请求被拒 3 网络去附着被拒 4 网络附着被拒 5 路由区更新被拒 6 TAU（小区切换）被拒 网络拒绝的原始原因。如果没有网络拒绝原因，该参数固定为 0。 字符串类型。位置码信息。 在 3G、4G 下： 十六进制格式，2 个字节。例如：'00C3'表示十进制的 195。 在 5G 下： 十六进制格式，3 个字节。例如：'0000C3'表示十进制的 195。 十六进制格式。路由区域码。 字符串类型。十六进制格式，8 个字节。小区信息。使用半字节码编码， 例 如 ：'000000000A444202'， 表 示 高 4 字 节 是 0， 低 4 字 节 是 '0A444202'。 整型。当 NAS 注册被拒绝（#19）时会携带此参数。 备注 通过 AT+QINDCFG='rejinfo'控制是否主动上报网络拒绝原因。 举例 //注册网络被拒绝。 AT+QREJINFO? +QREJINFO: 46000,1,111,5,4,111,'161806','FF','000000031405D001' OK 上海移远通信技术股份有限公司 104 / 273 RGx00U&RM500U 系列 AT 命令手册 5.12. AT+QSPN 查询运营商名称 该命令用于查询运营商名称。 AT+QSPN 查询运营商名称 测试命令 AT+QSPN=? 执行命令 AT+QSPN 最大响应时间 特性说明 响应 OK 响应 +QSPN: ,,,, OK 300 毫秒 - 参数 字符串类型。网络全称。 字符串类型。网络简称。 字符串类型。运营商名称。(U)SIM 卡中无此值时仅返回''。 整型。网络全称和简称使用的字母表。 0 GSM 7 位默认字母表 1 UCS2 字符串类型。已注册的 PLMN。 备注 1. 若=0，和格式为 GSM 7 位默认字母表的字符串。 2. 若=1，和格式为 UCS2 十六进制字符串。 举例 AT+QSPN //查询运营商名称。 +QSPN: 'CHN-UNICOM','UNICOM','',0,'46001' OK 上海移远通信技术股份有限公司 105 / 273 RGx00U&RM500U 系列 AT 命令手册 5.13. AT+QLTS 获取通过网络同步的最新时间 该命令用于获取通过网络同步的最新时间。 AT+QLTS 获取通过网络同步的最新时间 测试命令 AT+QLTS=? 响应 +QLTS: (支持的范围) 设置命令 AT+QLTS= OK 响应 +QLTS: OK 执行命令 AT+QLTS 若有任何错误： ERROR 或者 +CME ERROR: 响应 +QLTS: 最大响应时间 特性说明 OK 300 毫秒 - 参数 整型。查询网络时间模式。 0 查询通过网络同步的最新时间 1 查询通过网络同步的最新时间计算出的当前 GMT 时间 2 查询通过网络同步的最新时间计算出的当前本地时间 字符串类型。通过网络同步的最新时间。格式为：','。 不带双引号的字符串类型。时间。格式：yyyy/MM/dd,hh:mm:ss±zz， 用于表示年（yyyy）、月（MM）、日（dd）、时（hh）、分（mm）、秒（ss）、 时 区 （zz， 该 字 段 以 15 分 钟 为 单 位 显 示 本 地 时 间 和 GMT 时 间 的 差 异 ； 范 围 ：-48 ~ +48） ， 例 如 ：2004 年 5 月 6 日 22:10:00 GMT+2 应 表 示 为 2004/05/06,22:10:00+08。 整型。是否包括夏令时调整。 0 不包括夏令时调整 1 包括+1 小时的夏令时调整 2 包括+2 小时的夏令时调整 上海移远通信技术股份有限公司 106 / 273 RGx00U&RM500U 系列 AT 命令手册 错误码。详情请参考第 13.3 章。 备注 1. 若时间未通过网络同步，执行该命令后返回不带时间的字符串+QLTS: ''。 2. 设置命令 AT+QLTS=0 等同于执行命令 AT+QLTS。 举例 AT+QLTS=? +QLTS: (0-2) //查询支持的网络时间模式。 OK AT+QLTS //查询通过网络同步的最新时间。 +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=0 //查询通过网络同步的最新时间，功能同执行命令 AT+QLTS 一致。 +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=1 //查询通过网络同步的最新时间计算出的当前 GMT 时间。 +QLTS: '2017/01/13,03:41:22+32,0' OK AT+QLTS=2 //查询通过网络同步的最新时间计算出的当前本地时间。 +QLTS: '2017/01/13,11:41:22+32,0' OK 5.14. AT+QNWLOCK 锁定/解锁 LTE/5G 频点和小区 该命令用于锁定和解锁 LTE/5G 的频点和小区。 AT+QNWLOCK 锁定/解锁 LTE/5G 频点和小区 测试命令 AT+QNWLOCK=? 响应 +QNWLOCK: (支持的列表),(支持的范围),(支持的,列表) 设置命令 AT+QNWLOCK=[,[,,[,…[,,<p +QNWLOCK: ,, ci6>]]]] … +QNWLOCK: ,, OK 若指定任意可选参数，锁定指定的频点和小区或解锁所有频 点和小区： OK 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 10 秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。 'common/lte' 锁定/解锁 LTE 频点 'common/5g' 锁定/解锁 5G 频点 整型。范围：0~6。 0 解锁（此时若不指定和，则解锁所有频点和小区） 1~6 锁定目标小区数 整型。LTE/5G 的频点。 整型。小区 ID。 错误码。详情请参考第 13.3 章。 举例 AT+QNWLOCK=? +QNWLOCK: ('common/lte','common/5g'),(0-6),(,,,,,,,,,,,) OK AT+QNWLOCK='common/5g' +QNWLOCK: 'common/5g',633984,747 +QNWLOCK: 'common/5g',633985,748 +QNWLOCK: 'common/5g',633986,749 +QNWLOCK: 'common/5g',633987,750 +QNWLOCK: 'common/5g',633988,751 +QNWLOCK: 'common/5g',633989,751 //查询当前锁定的 5G 频点和小区。 上海移远通信技术股份有限公司 108 / 273 RGx00U&RM500U 系列 AT 命令手册 OK AT+QNWLOCK='common/5g',6,633984,747,633985,748,633986,749,633987,750,633988,751,63398 9,751 //锁定 6 个 5G 频点和小区。 OK AT+QNWLOCK='common/5g',0 //解锁 5G 所有频点和小区。 OK 5.15. AT+QNWLOCKFREQ 锁定或解锁 LTE/5G 频点 该命令用于锁定或解锁 LTE/5G 频点。 AT+QNWLOCKFREQ 锁定或解锁 LTE/5G 频点 测试命令 AT+QNWLOCKFREQ=? 响应 +QNWLOCKFREQ: (支 持 的列 表),(支 持 的 列表),(支持的列表) 设置命令 AT+QNWLOCKFREQ=[,[,[...-]]] OK 响应 若省略可选参数，查询当前锁定的频点： +QNWLOCKFREQ: [,] … OK 若指定任意可选参数，锁定指定频点或解锁全部频点： OK 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 10 秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 109 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 字符串类型。 'common/lte' 锁定/解锁 LTE 频点 'common/5g' 锁定/解锁 NR5G 频点 整型。 0 解锁（只支持解锁全部频点，无需指定） 1 锁定（锁定频点时必须指定） 整型。锁定的 LTE/5G 频点的列表，若锁定多个频点，以中划线'-'隔开。 错误码。详情请参考第 13.3 章。 备注 1. 每个网络制式单次最多能锁定 6 个频点。 2. 当前命令仅支持同时解锁所有频点。 举例 AT+QNWLOCKFREQ=? +QNWLOCKFREQ: ('common/lte','common/5g'),(0,1),(,,,,,< freq6>) OK AT+QNWLOCKFREQ='common/5g',1,633984 OK AT+QNWLOCKFREQ='common/5g',1,633983-633985 OK AT+QNWLOCKFREQ='common/5g' +QNWLOCKFREQ: 'common/5g',633984 +QNWLOCKFREQ: 'common/5g',633983 +QNWLOCKFREQ: 'common/5g',633985 //锁定单个NR5G频点 //锁定两个NR5G频点 //查询当前锁定的NR5G频点 OK AT+QNWLOCKFREQ='common/5g',1,633983-633985-633984-633986-633987-633988 //锁定六个 NR5G频点 OK AT+QNWLOCKFREQ='common/5g' +QNWLOCKFREQ: 'common/5g',633983 +QNWLOCKFREQ: 'common/5g',633985 +QNWLOCKFREQ: 'common/5g',633984 +QNWLOCKFREQ: 'common/5g',633986 +QNWLOCKFREQ: 'common/5g',633987 +QNWLOCKFREQ: 'common/5g',633988 //查询当前锁定的NR5G频点 上海移远通信技术股份有限公司 110 / 273 RGx00U&RM500U 系列 AT 命令手册 OK AT+QNWLOCKFREQ='common/5g',0 OK //解锁所有NR5G频点 5.16. AT+QCAINFO 查询载波聚合参数 该命令用于查询载波聚合参数。 AT+QCAINFO 查询载波聚合参数 测试命令 AT+QCAINFO=? 执行命令 AT+QCAINFO 响应 OK 响应 +QCAINFO: 'PCC',,,,,,,,, +QCAINFO: 'SCC',,,,,,,,, [+QCAINFO: 'SCC',,,,,,,,, […]] OK 最大响应时间 特性说明 若无活跃的辅小区： OK 300 毫秒 - 参数 字符串类型。E-UTRA 绝对射频信道号。 整型。带宽。 6 1.4 MHz 15 3 MHz 25 5 MHz 50 10 MHz 75 15 MHz 100 20 MHz 字符串类型。下行频段。 'LTE BAND 1' 上海移远通信技术股份有限公司 111 / 273 RGx00U&RM500U 系列 AT 命令手册 'LTE BAND 2' 'LTE BAND 3' 'LTE BAND 4' 'LTE BAND 5' 'LTE BAND 7' 'LTE BAND 8' 'LTE BAND 20' 'LTE BAND 28' 'LTE BAND 34' 'LTE BAND 38' 'LTE BAND 39' 'LTE BAND 40' 'LTE BAND 41' 'LTE BAND 66' 整型。主小区状态。 0 无服务 1 已注册 整型。辅小区状态。 0 配置解除 1 配置去激活 2 配置已激活 整型。物理小区 ID。 整型。参考信号接收功率（请参考 3GPP 36.214）。 整型。参考信号接收质量（请参考 3GPP 36.214）。 整型。接收信号强度指示。单位：dBm。 整型。SINR 对数值。范围：0~250；单位：1/5 dB。SINR 取值范围为-20 ~ +30 dB。 5.17. AT+QENDC 查询 EN-DC 状态 该命令用于查询 EN-DC 状态。 AT+QENDC 查询 EN-DC 状态 测试命令 响应 AT+QENDC=? 执行命令 OK 响应 AT+QENDC +QENDC: ,,, 最大响应时间 OK 300 毫秒 上海移远通信技术股份有限公司 112 / 273 RGx00U&RM500U 系列 AT 命令手册 特性说明 - 参数 整型。当前小区是否支持 EN-DC 模式。 0 不支持 1 支持 整型。当前注册的 PLMN 是否支持 EN-DC 模式。 0 不支持 1 支持 整型。网络提供的 EN-DC 功能是否受限。 0 受限 1 不受限 整型。是否成功支持 5G 图标信息。 0 不支持 1 支持 5.18. AT+QNTP 通过 NTP 服务器同步时间 该命令用于通过 NTP 服务器同步时间。AT+QNTP=仅用于配置 NTP 服务器的 IP 地址 或域名，且参数配置自动保存；AT+QNTP=,,用于配置 NTP 服务器的 IP 地址或域名同时通过默认端口号 123 来同步时间，且参数配置不保存。 AT+QNTP 通过 NTP 服务器同步时间 设置命令 AT+QNTP[=] 响应 若省略可选参数，则直接通过已配置的 NTP 服务器同步时 间： OK 若指定可选参数，则配置 NTP 服务器的 IP 地址或域名： OK 设置命令 AT+QNTP=,[,] 若有任何错误： +CME ERROR: 响应 OK 若有任何错误： +CME ERROR: 最大响应时间 5秒 上海移远通信技术股份有限公司 113 / 273 RGx00U&RM500U 系列 AT 命令手册 特性说明 上述命令立即生效。 参数 整型。PDP 上下文 ID。取值固定为 1。 字符串类型。NTP 服务器的 IP 地址或域名。默认值：'ntp.aliyun.com'。 整型。端口号。范围：0~65535。默认值：123。 若省略参数，则通过默认端口号 123 来同步时间； 若指定参数，则通过配置端口号来同步时间。 错误码。详情请参考第 13.3 章。 举例 此 AT 有三种用法： 方法一： AT+QNTP OK //通过默认 NTP 服务器同步时间，模组默认 NTP 服务器 为'ntp.aliyun.com'端口 123。 方法二： AT+QNTP='ntp.xxx.com' OK AT+QNTP //配置指定 NTP 服务器的域名为'ntp.xxx.com'，并保存配置（专网或 特殊网络下请用户指定自己的 NTP 服务器） //使用用户指定服务器同步 NTP 时间 方法三： AT+QNTP=1,'ntp.aliyun.com',123 OK //使用指定的 NTP 服务器'ntp.aliyun.com'端口号 123 来同步时间， 且不保存配置。 上海移远通信技术股份有限公司 114 / 273 RGx00U&RM500U 系列 AT 命令手册 5.19. AT+QDMZ 设置 DMZ 配置 该命令用于设置 DMZ（非军事化区，也称为隔离区）配置。 AT+QDMZ 设置 DMZ 配置 测试命令 AT+QDMZ=? 响应 +QDMZ: (支 持 的列 表),(支 持 的列 表),[] 查询命令 AT+QDMZ? OK 响应 +QDMZ: ,4[,] +QDMZ: ,6[,] 设置命令 AT+QDMZ=[,[,< IP_address>]] 执行命令 AT+QDMZ OK 响应 OK 若有任何错误： ERROR 响应 +QDMZ: ,4[,] +QDMZ: ,6[,] 最大响应时间 特性说明 OK 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用 DMZ。 0 禁用 1 启用 整型。IP 版本。 4 IPv4 6 IPv6 字符串类型。设置或获取的 DMZ IP 地址。IPv4 默认地址：127.0.0.1； IPv6 默认地 址：::1。 上海移远通信技术股份有限公司 115 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 3. 当为 0 时，省略可选参数，表示禁用 DMZ。 4. 该命令仅在路由模式或网桥模式下使用。 举例 AT+QDMZ=? +QDMZ: (0,1),(4,6), OK AT+QDMZ? +QDMZ: 0,4 +QDMZ: 0,6 //查询 DMZ 配置。 OK AT+QDMZ=1,4,192.168.42.2 OK AT+QDMZ? +QDMZ: 1,4,192.168.42.2 +QDMZ: 0,6 //设置 DMZ IPv4 地址为 192.168.42.2。 //查询 DMZ 配置。 OK AT+QDMZ=0,4 OK AT+QDMZ? +QDMZ: 0,4 +QDMZ: 0,6 //禁用 IPv4 DMZ。 //查询 DMZ 配置。 OK 上海移远通信技术股份有限公司 116 / 273 RGx00U&RM500U 系列 AT 命令手册 5.20. AT+QNWCFG 查询网络参数 该命令用于查询网络参数。 AT+QNWCFG 查询网络参数 测试命令 AT+QNWCFG=? 最大响应时间 特性说明 响应 +QNWCFG: 'lte_ulMCS',(支持的列表) +QNWCFG: 'lte_dlMCS',(支持的列表) +QNWCFG: 'lte_csi' +QNWCFG: 'nr5g_ulMCS',(支持的列表) +QNWCFG: 'nr5g_dlMCS',(支持的列表) +QNWCFG: 'nr5g_csi' OK 300 毫秒 - 举例 AT+QNWCFG=? +QNWCFG: 'lte_ulMCS',(0,1) +QNWCFG: 'lte_dlMCS',(0,1) +QNWCFG: 'lte_csi' +QNWCFG: 'nr5g_ulMCS',(0,1) +QNWCFG: 'nr5g_dlMCS',(0,1) +QNWCFG: 'nr5g_csi' OK 5.20.1. AT+QNWCFG='lte_ulMCS' 查询 LTE 上行 MCS 和调制类型 该命令用于查询 LTE 上行 MCS 和调制类型。 AT+QNWCFG='lte_ulMCS' 查询 LTE 上行 MCS 和调制类型 设置命令 AT+QNWCFG='lte_ulMCS'[, ] 响应 若省略可选参数，则查询 LTE 上行 MCS 和调制类型： +QNWCFG: 'lte_ulMCS',[,,] OK 若指定可选参数，则启用或禁用查询 LTE 上行 MCS 和调制类 上海移远通信技术股份有限公司 117 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 38.214 型： +QNWCFG: 'lte_ulMCS',[,,] OK 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用查询 LTE 上行 MCS 和调制类型。 0 禁用 1 启用 整型。MCS 值。范围：0~31。 整型。调制类型。 1 BPSK 2 QPSK 4 16_QAM 6 64_QAM 8 256_QAM 错误码。详情请参考第 13.3 章。 备注 1. 当模块进行上行数据业务时，该命令方可生效。 2. 该命令暂不支持查询，查询结果用'-'代替。 举例 AT+QNWCFG='lte_ulMCS' +QNWCFG: 'lte_ulMCS',1,3,- OK 上海移远通信技术股份有限公司 118 / 273 RGx00U&RM500U 系列 AT 命令手册 5.20.2. AT+QNWCFG='lte_dlMCS' 查询 LTE 下行 MCS 和调制类型 该命令用于查询 LTE 下行 MCS 和调制类型。 AT+QNWCFG='lte_dlMCS' 查询 LTE 下行 MCS 和调制类型 设置命令 AT+QNWCFG='lte_dlMCS'[, ] 响应 若省略可选参数，则查询 LTE 下行 MCS 和调制类型： +QNWCFG: 'lte_dlMCS',[,,] OK 若指定可选参数，则启用或禁用查询 LTE 下行 MCS 和调制类 型： +QNWCFG: 'lte_dlMCS',[,,] OK 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用查询 LTE 下行 MCS 和调制类型。 0 禁用 1 启用 整型。MCS 值。范围 0~31。 整型。调制类型。 1 BPSK 2 QPSK 4 16_QAM 6 64_QAM 8 256_QAM 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 119 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 1. 当模块进行下行数据业务时，该命令方可生效。 2. 该命令暂不支持查询，查询结果用'-'代替。 举例 AT+QNWCFG='lte_dlMCS' +QNWCFG: 'lte_dlMCS',1,3,- OK 5.20.3. AT+QNWCFG='lte_csi' 查询 LTE CSI 信息 该命令用于查询 LTE CSI 信息，包括 MCS、CQI、RI 和 PMI。 AT+QNWCFG='lte_csi' 查询 LTE CSI 信息 设置命令 响应 AT+QNWCFG='lte_csi' +QNWCFG: 'lte_csi',,,, OK 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 参数 整型。PDSCH 的调制与编码方案。范围：0~31。 整型。PDSCH 的有效数据层数。 整型。下行信道的质量。 整型。预编码矩阵指示集合索引。 错误码。详情请参考第 13.3 章。 备注 当模块进行下行数据业务时，该命令方可生效。 上海移远通信技术股份有限公司 120 / 273 举例 AT+QNWCFG='lte_csi' +QNWCFG: 'lte_csi'0,1,15,0 OK RGx00U&RM500U 系列 AT 命令手册 5.20.4. AT+QNWCFG='nr5g_ulMCS' 查询 NR5G 上行 MCS 和调制类型 该命令用于查询 NR5G 上行 MCS 和调制类型。 AT+QNWCFG='nr5g_ulMCS' 查询 NR5G 上行 MCS 和调制类型 设置命令 AT+QNWCFG='nr5g_ulMCS'[,] 响应 若省略可选参数，则查询 NR5G 上行 MCS 和调制类型： +QNWCFG: 'nr5g_ulMCS',[,,] OK 若指定可选参数，则启用或禁用查询 NR5G 上行 MCS 和调制 类型： +QNWCFG: 'nr5g_ulMCS',[,,] OK 最大响应时间 特性说明 参考 3GPP TS 38.214 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用查询 NR5G 上行 MCS 和调制类型。 0 禁用 1 启用 整型。MCS 值。范围：0~31。 整型。调制类型。 上海移远通信技术股份有限公司 121 / 273 1 BPSK 2 QPSK 4 16_QAM 6 64_QAM 8 256_QAM 错误码。详情请参考第 13.3 章。 备注 当模块进行上行数据业务时，该命令方可生效。 RGx00U&RM500U 系列 AT 命令手册 举例 AT+QNWCFG='nr5g_ulMCS' +QNWCFG: 'nr5g_ulMCS',1,20,4 OK 5.20.5. AT+QNWCFG='nr5g_dlMCS' 查询 NR5G 下行 MCS 和调制类型 该命令用于查询 NR5G 下行 MCS 和调制类型。 AT+QNWCFG='nr5g_dlMCS' 查询 NR5G 下行 MCS 和调制类型 设置命令 AT+QNWCFG='nr5g_dlMCS'[,] 响应 若省略可选参数，则查询 NR5G 下行 MCS 和调制类型： +QNWCFG: 'nr5g_dlMCS',[,,] OK 若指定可选参数，则启用或禁用查询 NR5G 下行 MCS 和调制 类型： +QNWCFG: 'nr5g_dlMCS',[,,] OK 最大响应时间 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 122 / 273 RGx00U&RM500U 系列 AT 命令手册 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用查询 NR5G 下行 MCS 和调制类型。 0 禁用 1 启用 整型。MCS 值。范围 0~31。 整型。调制类型。 1 BPSK 2 QPSK 4 16_QAM 6 64_QAM 8 256_QAM 错误码。详情请参考第 13.3 章。 备注 当模块进行下行数据业务时，该命令方可生效。 举例 AT+QNWCFG='nr5g_dlMCS' +QNWCFG: 'nr5g_dlMCS',1,1,4 OK 5.20.6. AT+QNWCFG='nr5g_csi' 查询 NR5G CSI 信息 该命令用于查询 NR5G CSI 信息，包括 MCS、CQI、RI 和 PMI。 AT+QNWCFG='nr5g_csi' 查询 NR5G CSI 信息 设置命令 响应 AT+QNWCFG='nr5g_csi' +QNWCFG: 'nr5g_csi',,,, OK 若有任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 123 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 - 参数 整型。PDSCH 的调制与编码方案。范围：0~31。 整型。PDSCH 的有效数据层数。 整型。下行信道的质量。 整型。预编码矩阵指示集合索引。 错误码。详情请参考第 13.3 章。 备注 当模块进行上行数据业务时，该命令方可生效。 举例 AT+QNWCFG='nr5g_csi' +QNWCFG: 'nr5g_csi'0,1,15,0 OK 上海移远通信技术股份有限公司 124 / 273 RGx00U&RM500U 系列 AT 命令手册 6 呼叫相关命令 6.1. ATA 呼叫应答 该命令用于连接 MT 以应答语音来电或者数据来电，来电由 RING 指示。执行该命令后，MT 发送摘机 信号到远程站。 ATA 呼叫应答 执行命令 ATA 响应 若语音拨号并成功建立连接： OK 最大响应时间 特性说明 参考 V.25ter 若不能建立连接： NO CARRIER 90 秒，取决于网络状态 - 备注 ATA 操作忽略同一命令行中其他命令。 举例 RING AT+CLCC +CLCC: 2,1,4,0,0,'02154450290',129 OK ATA OK //语音来电。 //来电。 //使用 ATA 应答此语音呼叫。 上海移远通信技术股份有限公司 125 / 273 RGx00U&RM500U 系列 AT 命令手册 6.2. ATD 发起呼叫 该命令用于建立语音或数据主叫，还可以用于控制补充业务。 ATD 发起呼叫 执行命令 ATD[][;] 响应 若遇忙占线： BUSY 若连接无法建立成功： NO CARRIER 最大响应时间 特性说明 参考 V.25ter 若发起语音呼叫成功： OK 5 秒，取决于网络状态 - 参数 ; 拨号位字符串和 V.25ter 中可选的拨号修饰符。 拨号位：0~9、*、#、+、A、B、C 以下 V.25ter 拨号修饰符可忽略： ,（逗号）、T、P、!、W、@ 字符串类型。GSM 拨号修饰符。 I 激活 CLIR（主叫用户不允许在被叫用户话机上显示自己的电话号码） i 禁止 CLIR（主叫用户允许在被叫用户话机上显示自己的电话号码） G 仅在本次呼叫中激活闭合用户群调用 g 仅在本次呼叫中去激活闭合用户群调用 仅在建立语音呼叫时可用，呼叫结束后返回至命令状态。 备注 1. 若在执行 ATD 过程中收到 ATH 命令，该命令可能被终止执行。但是在建立连接的某些状态下（如： 握手状态），该命令不会被终止执行。 2. =I/i 仅适用于拨号字符中无'*'或'#'的情况。 3. 使用 ATD 拨号后响应： 对于语音呼叫，可设置两种不同的响应模式： 拨号完成后或者在呼叫建立成功后，MT 立即返回 OK。此设置由 AT+COLP 控制。默认设置为 AT+COLP=0，即拨号完成后，MT 立即返回 OK。否则 MT 返回 OK、BUSY、NO DIAL TONE 或 上海移远通信技术股份有限公司 126 / 273 RGx00U&RM500U 系列 AT 命令手册 NO CARRIER。 4. 在一个已激活的语音呼叫中，使用 ATD： ⚫ 当已有一个已激活的语音呼叫，用户发起第二个语音呼叫时，第一个语音呼叫将自动设置为呼 叫保持状态。 ⚫ 所有呼叫的当前状态均可随时使用 AT+CLCC 进行查询。 举例 ATD10086; OK //拨号。 6.3. ATH 挂断现有连接 该命令用于断开当前数据通话或语音通话，即本地 TE 从命令行断开并终止通话。也可使用 AT+CHUP 挂断语音通话。 ATH 挂断现有连接 执行命令 ATH[n] 最大响应时间 特性说明 参考 V.25ter 响应 OK 90 秒，取决于网络状态 - 参数 整型。 0 从命令行断开现有所有通话并终止通话。 上海移远通信技术股份有限公司 127 / 273 RGx00U&RM500U 系列 AT 命令手册 6.4. AT+CHUP 挂断通话 该命令用于取消所有活跃、等待、保持状态的语音通话。若需断开数据通话，需使用 ATH。 AT+CHUP 挂断通话 测试命令 响应 AT+CHUP=? 执行命令 OK 响应 AT+CHUP OK 最大响应时间 特性说明 参考 3GPP 27.007 若有任何错误： ERROR 90 秒，取决于网络状态 - 举例 RING AT+CHUP OK //来电。 //挂断通话。 6.5. ATS0 设置自动应答前振铃次数 该命令用于设置来电的自动应答前振铃次数。若设置为非零取值，呼叫指示（RING）达到设置次 数后，ME 自动应答。 ATS0 设置自动应答前振铃次数 查询命令 响应 ATS0? 设置命令 ATS0= OK 响应 OK 最大响应时间 若有任何错误： ERROR 300 毫秒 上海移远通信技术股份有限公司 128 / 273 RGx00U&RM500U 系列 AT 命令手册 特性说明 - 参考 V.25ter 参数 整型。 0 禁用自动应答 1~255 达到指定的振铃次数后，启用自动应答 备注 若值设置过高，呼叫方可能在呼叫被自动应答前停止呼叫。 举例 ATS0=3 OK RING RING RING //设置三次振铃后自动接听。 //来电。 //振铃 3 次后自动应答呼叫。 6.6. ATS7 设置呼叫建立完成的等待时间 该命令用于设置在应答或发起通话时，等待呼叫建立完成的时间。若指定等待时间内无连接创建完成， MT 将断开。 ATS7 设置呼叫建立完成的等待时间 查询命令 响应 ATS7? S7: 设置命令 ATS7= 最大响应时间 特性说明 OK 响应 OK 300 毫秒 - 上海移远通信技术股份有限公司 129 / 273 参考 V.25ter 参数 整型。默认值：45。 0 禁用 1~255 等待连接创建完成的秒数 RGx00U&RM500U 系列 AT 命令手册 6.7. AT+CSTA 选择号码地址类型 该命令用于根据 3GPP 规范选择 ATD 发起呼叫时被叫号码的号码类型。 AT+CSTA 选择号码地址类型 测试命令 AT+CSTA=? 响应 +CSTA: (支持的列表) 查询命令 AT+CSTA? OK 响应 +CSTA: 设置命令 AT+CSTA=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 - 参数 整型。号码地址类型。 128 未知的编号计划，未知类型 129 ISDN /电话号码计划，未知号码 145 国际号码（以'+'开头） 161 国内号码 上海移远通信技术股份有限公司 130 / 273 RGx00U&RM500U 系列 AT 命令手册 6.8. AT+CLCC 查询当前呼叫 该命令用于查询所有当前呼叫。若命令成功但无呼叫，将不会有信息发送到 TE，只返回 OK。 AT+CLCC 查询当前呼叫 测试命令 AT+CLCC=? 执行命令 AT+CLCC 响应 OK 响应 [+CLCC: ,,,,[,, [,[,[,]]]] [+CLCC: ,,,,[,, [,[,[,]]]] [...]]] OK 最大响应时间 特性说明 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 - 参数 整型。呼叫标识（请参考 3GPP TS 22.030）；该参数可用于 AT+CHLD。 整型。呼叫方向。 0 主叫（MO） 1 被叫（MT） 整型。呼叫状态。 0 激活状态 1 呼叫保持状态 2 主叫，拨号状态 3 主叫，回铃音状态 4 被叫，来电状态 5 被叫，呼叫等待状态 整型。呼叫模式。 0 语音 1 数据 2 传真 整型。 0 呼叫不在多方通话中（如：会议） 1 呼叫在多方通话中（如：会议） 字符串类型。电话号码。由规定电话号码地址类型。 上海移远通信技术股份有限公司 131 / 273 RGx00U&RM500U 系列 AT 命令手册 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。 129 未知类型 145 国际号码（以'+'开头） 161 国内号码 字母数字格式的，与电话簿中的条目相对应。 整型。呼叫的 eMLPP 优先级（请参考 3GPP TS 22.067）。 整 型 。中 不 包 含 主 叫 BCD 号 的 原 因 （ 请 参 考 3GPP TS 24.008 subclause 10.5.4.30）。=0 时，该参数不显示。 0 CLI 有效 1 CLI 已被发起者拒绝（请参考 3GPP TS 24.008 table 10.5.135a/3GPP TS 24.008 code 'Reject by user'） 2 由于互通问题或原始网络限制，CLI 不可用（请参考 3GPP TS 24.008 table 10.5.135a/3GPP TS 24.008 code 'Interaction with other service'） 3 由于主叫是付费电话类型，CLI 不可用（请参考 3GPP TS 24.008 table 10.5.135a/3GPP TS 24.008 code 'Coin line/payphone'） 4 由于其他原因，CLI 不可用（请参考 3GPP TS 24.008 table 10.5.135a/3GPP TS 24.008 code 'Unavailable'） 错误码。详情请参考第 13.3 章。 举例 ATD10086; OK AT+CLCC +CLCC: 2,0,0,0,0,'10086',129 OK //发起通话。 //发起通话且通话已被接听。 6.9. AT+CRC 设置来电指示扩展格式 该命令用于控制来电指示是否使用扩展格式。若启用扩展格式，来电时将通过上报 URC +CRING: 的方式向 TE 提示，而不是使用 RING。 AT+CRC 设置来电指示扩展格式 测试命令 AT+CRC=? 响应 +CRC: (支持的列表) 查询命令 AT+CRC? OK 响应 +CRC: 上海移远通信技术股份有限公司 132 / 273 RGx00U&RM500U 系列 AT 命令手册 设置命令 AT+CRC=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。是否启用通过 URC +CRING: 上报来电。 0 禁用 1 启用 字符串类型。 ASYNC 异步透明 SYNC 同步透明 REL ASYNC 异步非透明 REL SYNC 同步非透明 FAX 传真 VOICE 语音 举例 AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK RING ATH OK //启用扩展格式。 //语音来电提示。 //禁用扩展格式。 //语音来电提示。 上海移远通信技术股份有限公司 133 / 273 RGx00U&RM500U 系列 AT 命令手册 6.10. AT+QECCNUM 配置紧急呼叫号码 该命令用于查询、增加和删除 ECC 号码（紧急呼叫号码）。ECC 号码分两种：一种是未插(U)SIM 卡 时的 ECC 号码，默认是 911、112、00、08、110、999、118 和 119；另一种是插(U)SIM 卡时的 ECC 号 码，默认是 911 和 112。911 和 112 始终属于 ECC 号码，且不可删除。若(U)SIM 卡中含 ECC 文件，则 ECC 文件中的号码也被作为 ECC 号码。 每种 ECC 号码最多支持 20 个号码。 AT+QECCNUM 配置紧急呼叫号码 测试命令 AT+QECCNUM=? 响应 +QECCNUM: (支持的范围) 查询命令 查询含(U)SIM 和不含(U)SIM 的 ECC 号 码 AT+QECCNUM? 设置命令 AT+QECCNUM=,[,[,,…[,]]] OK 响应 +QECCNUM: ,,[,…] … OK 响应 若为 0，查询 ECC 号码，省略可选参数： +QECCNUM: ,,[,…] OK 若不为 0（为 1 时增加 ECC 号码；为 2 时删除 ECC 号码），至少需要输入 1 个 ECC 号码： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。ECC 号码操作模式。 0 查询 ECC 号码 1 增加 ECC 号码 2 删除 ECC 号码 整型。ECC 号码类型。 上海移远通信技术股份有限公司 134 / 273 RGx00U&RM500U 系列 AT 命令手册 0 未插(U)SIM 卡时的 ECC 号码 1 插(U)SIM 卡时的 ECC 号码 字符串类型。ECC 号码，例如：'110'、'119'。 举例 AT+QECCNUM=? +QECCNUM: (0-2) //查询支持的 ECC 号码操作模式。 OK AT+QECCNUM? //查询插(U)SIM 卡和不插(U)SIM 卡时的 ECC 号码。 +QECCNUM: 0,'911','112','00','08','110','999','118','119' +QECCNUM: 1,'911','112' OK AT+QECCNUM=0,1 +QECCNUM: 1,'911','112' //查询插(U)SIM 卡时的 ECC 号码。 OK AT+QECCNUM=1,1,'110','234' //增加'110'和'234'作为插(U)SIM 卡时的 ECC 号码。 OK AT+QECCNUM=0,1 //查询插(U)SIM 卡时的 ECC 号码。 +QECCNUM: 1,'911','112','110','234' OK AT+QECCNUM=2,1,'110' //从插(U)SIM 卡时的 ECC 号码中删除'110'。 OK AT+QECCNUM=0,1 //查询插(U)SIM 卡时的 ECC 号码。 +QECCNUM: 1,'911','112','234' OK 6.11. AT^DSCI 设置主动上报呼叫状态 该命令用于配置是否主动上报呼叫状态。 上海移远通信技术股份有限公司 135 / 273 RGx00U&RM500U 系列 AT 命令手册 AT^DSCI 设置主动上报呼叫状态 测试命令 AT^DSCI=? 响应 ^DSCI: (支持的列表) 查询命令 AT^DSCI? OK 响应 ^DSCI: 设置命令 AT^DSCI=[] 最大响应时间 特性说明 OK 响应 OK 300 毫秒 - 参数 整型。配置是否通过 URC ^DSCI: ,,,,,,上报呼叫状态。 0 禁用主动上报呼叫状态 1 启用主动上报呼叫状态 整型。呼叫 ID。 整型。呼叫方向。 0 主叫（MO） 1 被叫（MT） 整型。呼叫状态。 1 CALL_LOCAL_HOLD 呼叫本地保持 2 CALL_ORIGINAL 呼叫发起 3 CALL_CONNECT 呼叫连接 4 CALL_INCOMING 呼叫接入 5 CALL_WAITING 呼叫等待 6 CALL_END 呼叫结束 7 CALL_ALERTING 呼叫提醒 8 CALL_REMOTE_HOLD 呼叫远程保持 9 CALL_BOTH_HOLD 呼叫双方保持 整型。呼叫类型。 0 语音呼叫 1 PS 呼叫 整型。当前呼叫是否处于电话会议。 0 非电话会议 1 电话会议 字符串类型。电话号码。 上海移远通信技术股份有限公司 136 / 273 RGx00U&RM500U 系列 AT 命令手册 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。 129 未知类型 145 国际号码（以'+'开头） 161 国内号码 举例 //拨号 AT^DSCI=1 OK ATD10086; OK ^DSCI: 1,0,2,0,0,10086,129 ^DSCI: 1,0,7,0,0,10086,129 ^DSCI: 1,0,3,0,0,10086,129 ATH OK ^DSCI: 1,0,6,0,0,10086,129 //来电 RING ^DSCI: 1,1,4,0,0,13022100000,129 RING ^DSCI: 1,1,6,0,0,13022100000,129 NO CARRIER //启用主动上报呼叫状态。 //拨号 10086。 //发起语音呼叫。 //呼叫提醒。 //呼叫连接成功。 //呼叫结束。 //新呼叫接入。 //呼叫结束。 上海移远通信技术股份有限公司 137 / 273 RGx00U&RM500U 系列 AT 命令手册 7 电话本相关命令 7.1. AT+CNUM 查询本机号码 该命令用于查询(U)SIM 卡中所有本机号码记录。 AT+CNUM 查询本机号码 测试命令 AT+CNUM=? 执行命令 AT+CNUM 响应 OK 响应 [+CNUM: [],,] [+CNUM: [],,<type2] [...]] OK 最大响应时间 特性说明 参考 3GPP 27.007 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 参数 字符串类型。与相关联，使用的字符集应为 AT+CSCS 设置的字符集。 字符串类型。电话号码。格式由决定。 整型。八位字节的地址类型（请参考 3GPP TS 24.008 subclause 10.5.4.7）。 129 未知类型 145 国际号码（以'+'开头） 161 国内号码 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 138 / 273 RGx00U&RM500U 系列 AT 命令手册 7.2. AT+CPBR 读取电话本 该命令用于读取存储器中位置在与之间（闭区间）的电话本记录。如果只输入 ，则只返回在位置的电话本记录。 AT+CPBR 读取电话本 测试命令 AT+CPBR=? 响应 +CPBR: (支持的列表),, 设置命令 AT+CPBR=[,] OK 响应 [+CPBR: ,,, [[+CPBR: ,,,] […]]] OK 最大响应时间 特性说明 参考 3GPP 27.007 若有任何错误： ERROR 或者 +CME ERROR: 取决于电话本记录数量 - 参数 整型。电话本存储器位置索引号。 整型。的最大长度，通常为 20 字节，最小为 1 个字节。 整型。的最大长度，通常为 16 字节，最小为 1 个字节。 整型。需读取的电话号码在存储器中的起始位置。 整型。需读取的电话号码在存储器中的终止位置。 字符串类型。电话号码。格式由决定。 整型。号码地址类型。 129 未知类型 145 国际号码（以'+'开头） 161 国内号码 字符串类型。电话号码对应的字符串内容。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 139 / 273 RGx00U&RM500U 系列 AT 命令手册 7.3. AT+CPBS 设置电话本存储器 该命令用于设置电话本存储器。 AT+CPBS 设置电话本存储器 测试命令 AT+CPBS=? 查询命令 AT+CPBS? 设置命令 AT+CPBS= 最大响应时间 特性说明 参数 3GPP 27.007 响应 +CPBS: (支持的列表) OK 若有任何错误： ERROR 或者 +CME ERROR: 响应 +CPBS: [,,] OK 若有任何错误： ERROR 或者 +CME ERROR: 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 参数 字符串类型。电话本存储器。 'FD' (U)SIM 卡固定拨号电话本（不适用于 AT+CPBW） 'LD' (U)SIM 卡上次拨号电话本（不适用于 AT+CPBW） 'SN' (U)SIM 卡系统拨号电话本（不适用于 AT+CPBW） 上海移远通信技术股份有限公司 140 / 273 RGx00U&RM500U 系列 AT 命令手册 'EN' (U)SIM 卡或 MT 紧急呼叫电话本（不适用于 AT+CPBW） 'ON' (U)SIM 卡本机号码列表（MSISDN） 整型。当前储存器中已存储的记录数。 整型。当前储存器支持的最大记录数。 错误码。详情请参考第 13.3 章。 7.4. AT+CPBW 写入电话本 该命令用于在当前存储器指定位置中添加、删除电话记录。 AT+CPBW 写入电话本 测试命令 AT+CPBW=? 响应 +CPBW: (支持的范围),,(支持的列 表), OK 设置命令 AT+CPBW=[,[,[,]]] 若有任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则删除指定的电话记录： OK 若指定可选参数，则向指定添加一个电话记录： OK 最大响应时间 特性说明 参考 3GPP 27.007 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 上海移远通信技术股份有限公司 141 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。电话本存储器位置索引号。 整型。的最大长度。 整型。的最大长度。 字符串类型。电话号码。格式由决定。 整型。号码地址类型。 129 未知类型 145 国际号码（以'+'开头） 161 国内号码 字符串类型。电话号码对应的字符串内容。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。详情请参考第 13.3 章。 举例 AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK AT+CPBW=10 OK //添加一条电话记录。 //删除一条电话记录。 上海移远通信技术股份有限公司 142 / 273 RGx00U&RM500U 系列 AT 命令手册 8 短消息相关命令 8.1. AT+CSMS 选择短消息服务类型 该命令用于选择短消息服务类型并返回 MT 支持的短消息类型。 AT+CSMS 选择短消息服务类型 测试命令 AT+CSMS=? 响应 +CSMS: (支持的列表) 查询命令 AT+CSMS? OK 响应 +CSMS: ,,, 设置命令 AT+CSMS= OK 响应 +CSMS: ,, OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 - 参数 整型。短消息服务类型。 0 SMS 的 AT 命令语法与 3GPP TS 27.005 Phase 2 版本 4.7.0 兼容；支持不需要新命 令语法的 Phase 2+功能（例如：使用 Phase 2+新编码方案修正消息路由）。详情 参考 3GPP TS 23.040 和 3GPP TS 23.041 1 SMS 的 AT 命令语法与 3GPP TS 27.005 Phase 2+版本兼容；设置为 1 时的需求已 在对应命令描述中说明。详情参考 3GPP TS 23.040 和 3GPP TS 23.041 上海移远通信技术股份有限公司 143 / 273 RGx00U&RM500U 系列 AT 命令手册 整型。移动终端是否支持接收短消息。 0 不支持 1 支持 整型。移动终端是否支持发送短消息。 0 不支持 1 支持 整型。移动终端是否支持广播类型短消息。 0 不支持 1 支持 错误码。详情请参考第 13.4 章。 举例 AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //设置短消息服务类型为 1。 8.2. AT+CMGF 配置短消息模式 该命令用于指定短消息采用的格式。表示 TA-TE 之间，读写短消息时，采用的是文本模式还 是 PDU 模式。消息格式可设置为 PDU 模式（使用整个 TP 数据单元）或者文本模式（消息报头和正文分 别以不同的参数形式展示）。文本模式通过 AT+CSCS 指定的告知 TA-TE 交互中消息正文使用的 字符集。 AT+CMGF 配置短消息模式 测试命令 AT+CMGF=? 响应 +CMGF: (支持的列表) 查询命令 AT+CMGF? OK 响应 +CMGF: OK 上海移远通信技术股份有限公司 144 / 273 设置命令 AT+CMGF= 最大响应时间 特性说明 参考 3GPP TS 27.005 参数 整型。短消息模式。 0 PDU 模式 1 文本模式 RGx00U&RM500U 系列 AT 命令手册 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 8.3. AT+CSCA 设置短消息服务中心地址 该命令用于当移动起始短消息发送后，更新 SMSC（短消息服务中心）地址。在文本模式下，可使用 设置命令进行设置。在 PDU 模式下，仅当 SMSC 地址的长度被编码为=0 时，方可使用设置命令进 行设置。 AT+CSCA 设置短消息服务中心地址 测试命令 响应 AT+CSCA=? 查询命令 OK 响应 AT+CSCA? +CSCA: , 设置命令 AT+CSCA=[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 145 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 字符串类型。短消息服务中心地址。详情参考 3GPP TS 24.011 RP SC 地址 AddressValue 字段；BCD 码（或 GSM 7 位默认字母字符）被转换为当前选择的 TE 字符集的字符 （参考 3GPP TS 27.007 中 AT+CSCS）。地址类型由定义。 整型。短消息服务中心地址类型。详情参考 3GPP TS 24.011 RP SC 地址中的八位字节 Type-of-Address（参考）。 短消息情况下：3GPP TS 24.011 服务中心地址和 3GPP TS 23.040 TPDU，十六进制格 式；ME/TA 将 TP 数据单元中每个八位字节转换为包含 2 个 IRA 字符的十六进制数字（如： 整数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 举例 AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //设置短消息服务中心地址。 //查询短消息服务中心地址。 8.4. AT+CPMS 配置短消息存储器 该命令用于选择查询或配置短信的存储位置，包括、和。 AT+CPMS 配置短消息存储器 测试命令 AT+CPMS=? 响应 +CPMS: (支持的列表),(支持的列表),(支持 的列表) 查询命令 AT+CPMS? OK 响应 +CPMS: ,,,,,,,, 设置命令 AT+CPMS=[,[,]] OK 响应 +CPMS: ,,,,, OK 若有任何错误： 上海移远通信技术股份有限公司 146 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 ERROR 或者 +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 字符串类型。若未建立到 TE 的路由（请参考 AT+CNMI），则将接收的短消息存储在 该存储器内。 'SM' (U)SIM 卡 'ME' 移动设备 整型。中当前短消息的数量。 整型。中可存储的短消息的总数量。 错误码。详情请参考第 13.4 章。 举例 AT+CPMS? //查询当前短消息存储器配置。 +CPMS: 'ME',0,20,'ME',0,20,'ME',0,20 OK AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //将短消息存储器更改为'SM'。 OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //查询当前短消息存储器配置。 OK 上海移远通信技术股份有限公司 147 / 273 RGx00U&RM500U 系列 AT 命令手册 8.5. AT+CMGD 删除短消息 该命令用于删除存储器中指定的短消息。若指定且不为 0，ME 应省略 并遵守参数规则。 AT+CMGD 删除短消息 测试命令 AT+CMGD=? 响应 +CMGD: (支持的范围),(支持的范围) 设置命令 AT+CMGD=[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 - 参数 整型。存储器支持的位置编号。范围：0~255。 整型。 0 删除指定的短消息 1 删除存储器中所有的已读短消息 2 删除存储器中所有的已读短消息和已发送的终端发起短消息 3 删除存储器中所有的已读短消息、已发送和未发送的终端发起短消息 4 删除存储器中所有短消息 字符串类型。用于读取和删除短消息的存储器。请参考 AT+CPMS。 'SM' (U)SIM 卡 'ME' 移动设备 错误码。详情请参考第 13.4 章。 举例 AT+CMGD=1 OK AT+CMGD=1,4 OK //删除存储器中=1 的短消息。 //删除存储器中全部短消息。 上海移远通信技术股份有限公司 148 / 273 RGx00U&RM500U 系列 AT 命令手册 8.6. AT+CMGL 按照状态读取短消息 该命令用于读取中的短消息及其状态。若短消息状态为'REC UNREAD'，执行该命令读取短 消息后，短消息状态变更为'REC READ'。 AT+CMGL 按照状态读取短消息 测试命令 AT+CMGL=? 响应 +CMGL: (支持的列表) 设置命令 AT+CMGL[=] OK 响应 若省略可选参数（即执行 AT+CMGL），查询所有已接收但未读的 短消息。 若指定可选参数： 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-SUBMIT 和/或 SMS-DELIVER 格式的短消息： +CMGL: ,,,[],[][,,] [+CMGL: ,,,[],[][,,] …] 对于 SMS-STATUS-REPORT 格式的短消息： +CMGL: ,,,,[],[],,, [+CMGL: ,,,,[],[],,, …] 对于 SMS-COMMAND 格式的短消息： +CMGL: ,,, [+CMGL: ,,, ...] 对于 CBM 存储： +CMGL: ,,,,, [+CMGL: ,,,,, …] OK 上海移远通信技术股份有限公司 149 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 2）PDU 模式（AT+CMGF=0）且该命令执行成功： +CMGL: ,,[], [+CMGL: ,,[alpha], …] OK 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 的操作取决于存储的短消息数目。 - 参数 字符串类型，文本模式。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 整型，PDU 模式。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 整型。存储器支持的位置编号。范围：0~255。 字 符 串 类 型 。 目 标 地 址 。 详 情 参 考 3GPP TS 23.040 中 的 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符（参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字 符 串 类 型 。 始 发 地 址 。 详 情 参 考 3GPP TS 23.040 中 的 TP-Originating-Address Address-Value 字段；BCD 码（GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字 符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 字符串类型。字母数字格式的或，对应 MT 电话簿中的条目。该功能的实现按 照出厂设定，所使用的字符集应与 AT+CSCS 选择的字符集相同（详情参考 3GPP TS 27.007 中对该命令的定义）。 字符串类型。短消息服务中心时间戳。详情参考 3GPP TS 23.040 TP-Service-Center- Time-Stamp 中的时间字符（参考）。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP- Destination-Address 中的八位字节 Type-of-Address。 上海移远通信技术股份有限公司 150 / 273 RGx00U&RM500U 系列 AT 命令手册 整型。始发地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address 中的八位字节 Type-of-Address（默认值参考）。 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示消息正文的长度； PDU 模式（AT+CMGF=0）下，表示以八位字节为单位的实际 TP 数据单元的长度（即 RP 层 的 短 消 息 服 务 中 心 地 址 中 的 八 位 字 符 将 不 计 算 在 该 长 度 内 ） 。 最 大 长 度 ：140； 单位：字节。 十六进制字符串。短消息命令内容。输出格式参考 3GPP TS 23.040 TP-User-Data。 短消息情况下：3GPP TS 24.011 服务中心地址和 3GPP TS 23.040 TPDU，十六进制格 式；ME/TA 将 TP 数据单元中每个八位字节转换为包含 2 个 IRA 字符的十六进制数字 （如：整数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 字符串类型。用于读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 整型。取决于命令或结果码：3GPP TS 23.040 SMS-DELIVER、SMS-SUBMIT（默认 值：17）、SMS-STATUS-REPORT 或 SMS-COMMAND（默认值：2）的第一个八位字 节。 整型。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。详情参考 3GPP TS 23.040 TP-Recipient-Address Address-Value 字段； BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。详情参考八位字节 3GPP TS 24.011 TP-Recipient-Address Type-of-Address（参见 ）。 时 间 字 符 串 类 型 。 详 情 参 考 3GPP TS 23.040 TP-Discharge-Time， 格 式 为 ： 'yy/MM/dd,hh:mm:ss zz'，格式中的字符依次代表年（后两位）、月、日、时、分、 秒、时区。例如：1994 年 5 月 6 日 22:10:00 GMT+2 小时用'94/05/06,22:10:00+08'表 示。 整型。详情参考 3GPP TS 23.040 TP-Status。 整型。详情参考 3GPP TS 23.040 TP-Command-Type（默认为 0）。 整型。详情参考 3GPP TS 23.041 CBM 序号。 整型。详情参考 3GPP TS 23.041 CBM 短消息标识符。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 4~7。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 0~3。 错误码。详情请参考第 13.4 章。 举例 AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, //设置短消息为文本模式。 //列举短消息存储器中的所有短消息。 上海移远通信技术股份有限公司 151 / 273 OK RGx00U&RM500U 系列 AT 命令手册 8.7. AT+CMGR 按照索引读取短消息 该命令用于从存储器中读取指定的短消息。若该短消息状态为'REC UNREAD'，执 行该命令读取短消息后，其状态变为'REC READ'。 AT+CMGR 按照索引读取短消息 测试命令 AT+CMGR=? 响应 +CMGR: (支持的范围) 设置命令 AT+CMGR= OK 响应 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-DELIVER 格式的短消息： +CMGR: ,,[],[,,,,,,,] OK 对于 SMS-SUBMIT 格式的短消息： +CMGR: ,,[][,,,,,[],,,] OK 对于 SMS-STATUS-REPORT 格式的短消息： +CMGR: ,,,[],[],,, OK 对于 SMS-COMMAND 格式的短消息： +CMGR: ,,[,,[],[],[], ] OK 对于 CBM 存储： +CMGR: ,,,,, 上海移远通信技术股份有限公司 152 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 2）PDU 模式（AT+CMGF=0）且该命令执行成功： +CMGR: ,[], OK 若错误与 MT 功能相关： +CMS ERROR: 取决于短消息内容的长度 - 参数 整型。存储器支持的位置编号。范围：0~255（不同的运营商对应支持的编号范围略有不 同，具体就实际情况而定）。 1）字符串类型，文本模式。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）整型，PDU 模式。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 字符串类型。字母数字格式的或，对应 MT 电话簿中的条目。该功能的实现按照 出厂设定，所使用的字符集应与 AT+CSCS 选择的字符集相同（详情参考 3GPP TS 27.007 中对该命令的定义）。 字符串类型。目标地址。详情参考 3GPP TS 23.040 中的 TP-Destination-Address Address- Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中 的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字符串类型。始发地址。详情参考 3GPP TS 23.040 中的 TP-Originating-Address Address- Value 字段；BCD 码（GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字 符（详情参考 TS 27.007 中的 AT+CSCS）。地址类型由指定。 字符串类型。短消息服务中心时间戳。详情参考 3GPP TS 23.040 TP-Service-Center-Time- 上海移远通信技术股份有限公司 153 / 273 RGx00U&RM500U 系列 AT 命令手册 Stamp（参见）。 整型。取决于命令或结果码：3GPP TS 23.040 SMS-DELIVER、SMS-SUBMIT（默认值： 17）、SMS-STATUS-REPORT 或 SMS-COMMAND（默认值：2）的第一个八位字节。 整型。协议标识符。详情参考 3GPP TS 23.040 TP-Protocol-Identifier。默认值：0。 整型。数据编码方案。取决于命令或结果码。详情参考 3GPP TS 23.038 短消息数据编码方 案（默认值为 0）或者小区广播数据编码方案。 整型或时间字符串类型。有效期。取决于 SMS-SUBMIT 的设置。详情参考 3GPP TS 23.040 TP-Validity-Period（参见）。 整型。短消息编号。详情参考 3GPP TS 23.040 TP-Message-Number。 整型。短消息参考。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。详情参考 3GPP TS 23.040 TP-Recipient-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（请参考 AT+CSCS）； 地址类型由指定。 整 型 。 详 情 参 考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address（ 参 见 ）。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address 中的八位字节 Type-of-Address。 整型。始发地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address 中的八位字节 Type-of-Address（默认参考）。 字符串类型。短消息服务中心地址。详情参考 3GPP TS 24.011 RP SC 地址 AddressValue；BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。短消息服务中心地址类型。详情参考 3GPP TS 24.011 RP SC 地址 Type-of-Address （默认参考）。 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示消息正文的长度； PDU 模式（AT+CMGF=0）下，表示以八位字节为单位的实际 TP 数据单元的长度（即 RP 层的短消息服务中心地址中的八位字节将不计算在该长度内）。最大长度 140 个字节。 短消息的文本内容。 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制 格式：ME/TA 把 TP 数据单元中每八位字节转换为包含 2 个 IRA 字符的十六进制数字（如： 整数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 时 间 字 符 串 类 型 。 详 情 参 考 3GPP TS 23.040 TP-Discharge-Time， 格 式 为 ： 'yy/MM/dd,hh:mm:ss zz'，格式中的字符依次代表年（后两位）、月、日、时、分、秒、 时区。例如：1994 年 5 月 6 日 22:10:00 GMT+2 小时用'94/05/06,22:10:00+08'表示。 整型。详情参考 3GPP TS 23.040 TP-Status。 整型。详情参考 3GPP TS 23.040 TP-Command-Type（默认为 0）。 整型。详情参考 3GPP TS 23.041 CBM 序号。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 4~7。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 0~3。 详情参考 3GPP TS 23.040 TP-Command-Data 文本模式响应。ME/TA 把 TP 数据单元中每 八位字节转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值为 42 的八位字节作为两 个字符（2A，即 IRA 50 和 65）发送给 TE）。 上海移远通信技术股份有限公司 154 / 273 RGx00U&RM500U 系列 AT 命令手册 错误码。详情请参考第 13.4 章。 举例 +CMTI: 'SM',3 //已收到新短消息，存储在(U)SIM 卡为 3 的位置。 AT+CSDH=1 OK AT+CMGR=3 //读取短消息。 +CMGR: 'REC UNREAD','+8615021012496',,'13/12/13,15:06:37+32',145,4,0,0,'+8613800210500', 145,27 OK 8.8. AT+CMGS 发送短消息 该命令用于将短消息（SMS-SUBMIT）从 TE 发送到网络侧。调用设置命令后，返回>后输入待发数 据，然后按 Ctrl+Z 表示 PDU 结束并发送短消息。可按 ESC 取消发送，取消成功也会返回 OK 表示终止确 认。发送成功后，将返回短消息参考值到 TE。 AT+CMGS 发送短消息 测试命令 AT+CMGS=? 设置命令 文本模式（AT+CMGF=1） AT+CMGS=[,] 响应 OK 响应 > 响应>后，输入文本格式数据，按 Ctrl+Z 发送数据，按 ESC 取消发送。 若发送成功： +CMGS: OK 设置命令 PDU 模式（AT+CMGF=0） AT+CMGS= 若错误与 MT 功能相关： +CMS ERROR: 响应 > 响应>后，输入 PDU 格式数据，按 Ctrl+Z 发送数据，按 ESC 取消发送。 若发送成功： +CMGS: 上海移远通信技术股份有限公司 155 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 若错误与 MT 功能相关： +CMS ERROR: 120 秒，取决于网络状态 - 参数 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address AddressValue 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中 的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address 中的八位字节 Type-of-Address。 短消息正文长度。PDU 模式（AT+CMGF=0）下，表示八位字节格式的实际 TP 数据单元长 度（即 RP 层的短消息服务中心地址中的八位字节将不计算在该长度内）。最大长度： 140；单位：字节。 整型。短消息参考值。详情参考 GSM 03.40 TP-Message-Reference。 错误码。详情请参考第 13.4 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' >This is a test from Quectel +CMGS: 247 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息内容，Ctrl+Z 发送，ESC 取消发送。 上海移远通信技术股份有限公司 156 / 273 RGx00U&RM500U 系列 AT 命令手册 8.9. AT+CMMS 发送多条短消息 该命令用于控制短消息中断协议链路的连续性。若启用该功能（且当前使用的网络支持），链路保持 打开，此情况下可快速发送多条短消息。 AT+CMMS 发送多条短消息 测试命令 AT+CMMS=? 响应 +CMMS: (支持的范围) 查询命令 AT+CMMS? OK 响应 +CMMS: 设置命令 AT+CMMS[=] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若有任何错误： ERROR 或者 +CMS ERROR: 120 秒，取决于网络状态 - 参数 整型。是否启用短消息中断协议链路功能。 0 禁用此功能 1 保持该功能启用状态，直到要发送的最新命令（AT+CMGS、AT+CMSS 等）的响应与下 一条要发送的命令之间的时间间隔超过 1~5 秒（具体值取决于 ME）。随后 ME 关闭链 路，MT 自动切换为 0。 2 启用该功能。若发送最新命令（AT+CMGS、AT+CMSS 等）的响应与下一条要发送命令 之间的时间间隔超过 1~5 秒（具体值取决于 ME），则 ME 会关闭链路，但 MT 不 会 自 动 切换为 0。 错误码。详情请参考第 13.4 章。 上海移远通信技术股份有限公司 157 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 执行查询命令后，隔 5~10 秒后再执行设置命令，否则可能会返回错误码+CMS ERROR: 500。 8.10. AT+CMGW 存储短消息 该 命 令 用 于 写 入 一 条 短 消 息 并 存 储 至， 并 返 回 已 存 储 短 消 息 的 存 储 位 置。 通 过 ，可将短消息设置为指定的状态。默认情况下，短消息状态设置为'STO UNSENT'。文本输入的语 法同 AT+CMGS 的设置命令相同。 AT+CMGW 存储短消息 测试命令 AT+CMGW=? 设置命令 文本模式（AT+CMGF=1） AT+CMGW=[,/[, ]] 响应 OK 响应 > 响应>后，输入文本格式数据，按 Ctrl+Z 发送数据，按 ESC 取消发送。 若存储成功： +CMGW: OK 设置命令 PDU 模式（AT+CMGF=0） AT+CMGW=[,] 若错误与 MT 功能相关： +CMS ERROR: 响应 > 响应>后，输入 PDU 格式数据，按 Ctrl+Z 发送数据，按 ESC 取消发送。 若存储成功： +CMGW: OK 最大响应时间 特性说明 参考 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 - 上海移远通信技术股份有限公司 158 / 273 GSM 07.05 RGx00U&RM500U 系列 AT 命令手册 参数 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address- Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中 的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字符串类型。始发地址。详情参考 3GPP TS 23.040 TP-Originating-Address Address- Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中 的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。始发地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address 中的八位字节 Type-of-Address（默认参考）。 字符串类型，文本模式。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 整型，PDU 模式。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address 中的八位字节 Type-of-Address。 整型。短消息长度。PDU 模式下（AT+CMGF=0），表示以八位字节为单位的实际 TP 数 据单元的长度（即 RP 层 SMSC 地址字节不计入长度）。范围：7~164；单位：字节。 整型。存储器的短消息序列。 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 错误码。详情请参考第 13.4 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' >This is a test from Quectel +CMGW: 4 //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息文本内容，按 Ctrl+Z 写入短消息，按 ESC 退出发送。 上海移远通信技术股份有限公司 159 / 273 RGx00U&RM500U 系列 AT 命令手册 OK AT+CMGF=0 //设置短消息模式为 PDU 模式。 OK AT+CMGW=18 >0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK 8.11. AT+CMSS 从存储器发送短消息 该 命 令 用 于 从 存 储 器中 发 送 指 定的 短 消 息 （SMS-SUBMIT） 。 若 指 定 SMSSUBMIT 格式短消息目的地址，则在短消息发送时使用新地址替换存储器中短消息包含的目的地址。 发送成功后，将返回参考值到 TE，其参数值可用于识别发送状态报告 URC 中的短消息。 AT+CMSS 从存储器发送短消息 测试命令 AT+CMSS=? 设置命令 AT+CMSS=[,[,]] 响应 OK 响应 1）文本模式（AT+CMGF=1）且执行成功： +CMSS: [,] OK 2）PDU 模式（AT+CMGF=0）且执行成功： +CMSS: [,] OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 120 秒，取决于网络状态 - 上海移远通信技术股份有限公司 160 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。存储器支持的位置编号。 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address AddressValue 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中 的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）；地址类型由指定。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address 中的八位字节 Type-of-Address。 整型。短消息参考。详情参考 3GPP TS 23.040 TP-Message-Reference 字段。 字符串类型。短消息服务中心时间戳。详情参考 3GPP TS 23.040 TP-Service-CentreTime-Stamp 中的时间字符（参考）。 字符串类型。格式与短消息中的的格式相同，但无 3GPP TS 24.011 SC 中的地址 字段。 字符串类型。用于写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 错误码。详情请参考第 13.4 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK AT+CMSS=4 +CMSS: 54 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息内容，按 Ctrl+Z 发送短消息，按 ESC 退出发送。 //从存储器中发送为 4 的短消息。 8.12. AT+CNMA 新短消息确认 该命令用于确认直接发送至 TE 的新消息（SMS-DELIVER 或 SMS-STATUS-REPORT）是否已经成 功发送。若 UE 未在需求时间内收到确认（网络超时），会发送 RP-ERROR 至网络。UE 可通过设置 AT+CNMI 的参数和为 0 自动禁止发送至 TE。 上海移远通信技术股份有限公司 161 / 273 RGx00U&RM500U 系列 AT 命令手册 AT+CNMA 新短消息确认 测试命令 AT+CNMA=? 执行命令 文本模式（AT+CMGF=1） AT+CNMA 设置命令 PDU 模式（AT+CMGF=0） AT+CNMA=[,[ 指定 PDU 按 Ctrl+Z 发送/ESC 退出发送]] 最大响应时间 特性说明 参考 3GPP TS 27.005 响应 若为文本模式（AT+CMGF=1）： OK 若为 PDU 模式（AT+CMGF=0）： +CNMA: (支持的范围) OK 响应 OK 若有任何错误： ERROR 或者 +CMS ERROR: 响应 OK 若有任何错误： ERROR 或者 +CMS ERROR: 300 毫秒 - 参数 整型。PDU 模式所需参数。 0 命令操作类似文本模式 1 发送肯定应答（RP-ACK）至网络，仅 PDU 模式下接受 2 发送否定应答（RP-ERROR）至网络，仅 PDU 模式下接受 整型。短消息长度。 PDU 模式下（AT+CMGF=0），表示以八位字节为单位的实际 TP 数据单元的长度（即 RP 层 SMSC 地址字节不计入长度）。 错误码。详情请参考第 13.4 章。 上海移远通信技术股份有限公司 162 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 仅当 AT+CSMS 中为 1（phase 2+）且模块上报如下对应 URC 时方可使用执行命令和设置命 令： +CMT: =2，新消息类别为 CLASS 0、1、3 和无 +CMT: =3，新消息类别为 CLASS 0 和 3 +CDS: =1 举例 AT+CSMS=1 OK AT+CNMI=1,2,0,0,0 OK AT+CMGF=1 OK AT+CSDH=1 OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. AT+CNMA //收到新短消息，直接输出短消息内容。 //向网络发送确认消息。 OK AT+CNMA +CMS ERROR: 340 //第二次返回错误，仅需确认信息一次。 8.13. AT+CNMI 设置新短消息上报方式 该命令用于设置新短消息的上报方式。 AT+CNMI 设置新短消息上报方式 测试命令 AT+CNMI=? 响应 +CNMI: (支 持 的范 围),(支 持 的范 围),(支 持 的 列表),(支持的范围),(支持的列表) 查询命令 AT+CNMI? OK 响应 +CNMI: ,,,, 设置命令 AT+CNMI=[,[,[,[,]]]]] OK 响应 OK 上海移远通信技术股份有限公司 163 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 若有任何错误： ERROR 或者 +CMS ERROR: 300 毫秒 该命令立即生效； 自动保存参数配置。 参数 整型。 0 缓冲 TA 中的非请求结果码。若 TA 结果码缓冲区已满，结果码指示可以存储在其他缓 冲区或者丢弃最早的结果码指示，替换为新接收到的指示。 1 若 TA-TE 间的链路被保留（即处于在线数据模式），丢弃指示并拒绝新接收的短消息 结果码指示，否则，直接转发给 TE。 2 若 TA-TE 间的链路被保留（比如：处于在线数据模式），缓冲 TA 中的非请求结果码并 将结果码发送给 TE，否则，直接转发给 TE。 整型。新短消息上报方式。 0 不将新短消息发送给 TE 1 新短消息通过 URC +CMTI: ,方式发送给 TE 2 新短消息通过 URC +CMT: [],（PDU 模式）或者+ CMT: ,[],[,,,,,,,] （文本模式）方式发送给 TE 3 在收到 Class 3 短消息时，新短消息通过 URC +CMT: [], （PDU 模式）或者+CMT: ,[],[,,,,, ,,]（文本模式）方式发送给 TE。收到非 Class 3 短消息，新短消息通过 URC +CMTI: ,方式发送给 TE。 整型。存储接收的 CBM 规则取决于其数据编码方案（详情参考 3GPP TS 23.038）和选择 小区广播消息类型命令 AT+CSCB 的设置。 0 无 CBM 指示发送到 TE 2 收到的 CBM 使用如下 URC 直接发送到 TE： +CBM: （PDU 模式）或者 +CBM: ,,,,（文本模式） 整型。短消息状态报告的上报方式。 0 不将状态报告发给 TE 1 状态报告通过如下 URC 上报 TE： +CDS: （PDU 模式）或者 +CDS: ,,[],[],,,（文本模式） 2 状态报告通过+CDSI: ,方式发给 TE 整型。 0 当为 1 或 2 时，将 TA 缓冲区的非请求结果码发送至 TE（返回 OK 后发送） 上海移远通信技术股份有限公司 164 / 273 RGx00U&RM500U 系列 AT 命令手册 1 当为 1 或 2 时，清空 TA 缓冲区的非请求结果码 错误码。详情请参考第 13.4 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CNMI=1,2,0,1,0 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //设置 SMS-DELIVER 消息直接发送至 TE。 +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel //收到新短消息，直接输出短消息内容。 8.14. AT+CSCB 选择小区广播消息类型 该命令用于选择 ME 接收到的 CBM 类型。 AT+CSCB 选择小区广播消息类型 测试命令 AT+CSCB=? 响应 +CSCB: (支持的列表) 查询命令 AT+CSCB? OK 响应 +CSCB: ,, 设置命令 AT+CSCB=[,mids>[,]] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 - 上海移远通信技术股份有限公司 165 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。是否接收由和指定的消息类型。 0 接收 1 不接收 字符串类型。所有可能的 CBM 消息标识的组合（请参考 AT+CBM 的）；如 '0,1,5,320-478,922'。默认值为空字符串。 字符串类型。所有可能的数据编码方案的组合（请参考 AT+CBM 的）；如'0-3,5'。 默认值为空字符串。 错误码。详情请参考第 13.4 章。 8.15. AT+CSDH 设置文本模式下参数显示 该命令用于控制是否在文本模式下的结果码中显示详细的报头信息。 AT+CSDH 设置文本模式下参数显示 测试命令 AT+CSDH=? 响应 +CSDH: (支持的列表) 查询命令 AT+CSDH? OK 响应 +CSDH: 设置命令 AT+CSDH[=] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若有任何错误： ERROR 300 毫秒 - 参数 整型。 0 在短消息命令+CMT、+CMGL 和+CMGR 结果码中不显示下述头信息： 对于文本模式下的 SMS-DELIVER 和 SMS-SUBMIT 类型短消息，在+CSCA 和 +CSMP 的结果 码中不包 含、、、、和； 在 上海移远通信技术股份有限公司 166 / 273 RGx00U&RM500U 系列 AT 命令手册 +CMT、+CMGL、+CMGR 结果码中不显示、或者。 1 在结果码中显示头信息 举例 AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT','', This is a test from Quectel OK AT+CSDH=1 OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 This is a test from Quectel OK 8.16. AT+CSMP 设置短消息文本模式参数 该命令用于在文本模式下（AT+CMGF=1）向网络侧发送短消息或将短消息存放在存储器中时设置需 要附加的参数取值。除此之外，还可以用于设置从 SMSC 接收到该短消息时算起的有效期（的取值 范围：0~255）或定义有效期终止的绝对时间（为字符串时）。 AT+CSMP 设置短消息文本模式参数 测试命令 响应 AT+CSMP=? 查询命令 OK 响应 AT+CSMP? +CSMP: ,,, 设置命令 AT+CSMP=[,[,[,] ]] 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 167 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。TPDU 的第一个字节。对于不同的消息类型的详细说明，请参考 3GPP TS 23.040。 整型或者字符串类型。有效期。取决于 SMS-SUBMIT 的的设置：3GPP TS 23.040 TP-Validity-Period（参考）。默认值：143。 整型。协议标识符。详情参考 3GPP TS 23.040 TP-Protocol-Identifier。默认值：0。 整型。数据编码方案。取决于该命令或结果码：3GPP TS 23.038 SMS 数据编码方案（默认 值：0），或者小区广播数据编码方案。 上海移远通信技术股份有限公司 168 / 273 RGx00U&RM500U 系列 AT 命令手册 9 分组域命令 9.1. AT+CGATT PS 域附着/去附着 设置命令用于将 MT 附着于 PS 域，或者将 MT 从 PS 域分离。命令完成后，MT 保持在 V.250 命令状 态。如果 MT 已经处于请求状态，则将忽略该命令，并且仍响应 OK。如果 MT 无法实现请求状态，将响应 ERROR 或+CME ERROR。 AT+CGATT PS 域附着/去附着 测试命令 AT+CGATT=? 响应 +CGATT: (支持的列表) 查询命令 AT+CGATT? OK 响应 +CGATT: 设置命令 AT+CGATT= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： ERROR 或者 +CME ERROR: 140 秒，取决于网络状态 - 参数 整型。PS 服务状态。 0 分离状态 1 附着状态 其他值为预留值，设置后将返回 ERROR。 上海移远通信技术股份有限公司 169 / 273 RGx00U&RM500U 系列 AT 命令手册 错误码。详情请参考第 13.3 章。 举例 AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //附着于 PS 域。 //从 PS 域分离。 //查询当前 PS 域状态。 9.2. AT+CGDCONT 定义 PDP 上下文 该 命 令 用 于 为 指 定所 标 识 的 PDP 上 下 文 配 置 参 数 。 设 置 命 令 的 一 种 特 殊 形 式 AT+CGDCONT=，表示删除对应的 PDP 上下文参数，使其变成未定义。查询命令返回每个已 定义 PDP 上下文的当前配置。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT： (支持的列表),,,,(支持的范围),(支持的范围),(支持 的列 表),(支 持 的列 表),(支 持 的范 围),(支持 的列表),(支持的列表),,,,,,(支持的 列表),,(支持的列表),(支持的< RQoS_ind>列表),(支持的列表),(支持的列表) [...] 查询命令 AT+CGDCONT? OK 响应 +CGDCONT: ,,,,,[,[,[,[,[, [,[,[,[,[,[,[,[,[,< RQoS_ind>[,[,]]]]]]]]]]]]]]]] […] OK 上海移远通信技术股份有限公司 170 / 273 RGx00U&RM500U 系列 AT 命令手册 设置命令 AT+CGDCONT=[[, [,[,[,[, [,[,[,[,[,[,[,[,[,[,[,[,[,[,[,[,]]]]]]]]]]]]]]]]]]]]]] 响应 OK 如有任何错误： ERROR 最大响应时间 300 毫秒 特性说明 参考 3GPP TS 27.007 该命令立即生效； 自动保存参数配置。 参数 整型。PDP 上下文 ID。该参数是 TE-MT 接口的本地参数，在其他与 PDP 上下文相关的命令中使用。范围：1~11（9 和 10 暂不支持）。 字符串类型。指定分组数据协议类型。EPS 服务仅支持 IP、IPv6 和 IPv4v6。 'IP' 'IPV6' 互联网协议版本 4 互联网协议版本 6 'IPV4V6' 配置双栈 UE 功能，支持互联网协议版本 4 与版本 6 'Ethernet' 以太网协议 字符串类型。接入点名称，用于选择 GGSN 或外部分组数据网络的逻 辑名称。可配置的最大 APN 长度为 99 字节。如果省略或为空，将请 求默认值。 字符串类型。用于标识适用于 PDP 的地址空间中的 MT。如果该值为 空或被省略，则 TE 在 PDP 启动过程中提供该值；否则，将请求动态 地址。可以使用 AT+CGPADDR 读取分配的地址。 整型。控制 PDP 数据是否需要压缩（仅适用于 SNDCP，详情参考 3GPP TS 44.065）。 0 关闭 1 打开（制造商首选压缩） 2 V.42bis 3 V.44（暂不支持） 整型。控制 PDP 头部数据压缩（详情参考 3GPP TS 44.065 和 3GPP TS 25.323）。 0 关闭 1 打开 2 RFC 1144 上海移远通信技术股份有限公司 171 / 273 RGx00U&RM500U 系列 AT 命令手册 3 RFC 2507 4 RFC 3095（仅适用于 PDCP） 整型。控制 MT/TA 请求获取 IPv4 地址信息的方式。 0 通过 NAS 信令获取 IPv4 地址 1 通过 DHCP 获取 IPv4 地址 整型。PDP 上下文的上下文激活请求类型。 0 PDP 上下文用于新的 PDP 上下文建立或从非 3GPP 接入网切换 （MT 确定PDP 上下文是用于新的 PDP 上下文建立还是用于切换 的方式可以实现的） 1 PDP 上下文用于紧急承载服务 整型。控制 MT/TA 获取 P-CSCF 地址的方式。 0 不受 AT+CGDCONT 影响 1 优先通过 NAS 信令获取 2 优先通过 DHCP 获取 整型。指示此 PDP 是否仅用于 IM CN。 0 此 PDP 不仅用于 IM CN 1 此 PDP 仅用于 IM CN 整型。指示 PDP 上下文请求的 NAS 信令优先级。 0 PDP 上下文在激活时，其低优先级参数由 MT 设置 1 PDP 上下文在激活时，其低优先级参数需设置为'MS 未被配置 NAS 信令低优先级' 整型。数据业务的会话和服务连续性（SSC）模式。 0 SSC 模式一 1 SSC 模式二 2 SSC 模式三 字符串类型。5GS 的分片信息。详细信息请参考 3GPP TS 23.501 和 3GPP TS 24.501。格式和编码的详细信息请参考 3GPP TS 23.003。 sst 仅 SST 切片/服务类型（SST）存在 sst;mapped_sst SST 和映射配置的 SST 都存在 sst.sd SST 和切片微分器（SD）存在 sst.sd;mapped_sst SST、SD 和映射配置的 SST 都存在 sst.sd;mapped_sst.mapped_sd SST、SD、映射配置的 SST 和映射 配置的 SD 均存在 整型。5GS 系统中的优先接入类型。 0 3GPP 接入 1 非 3GPP 接入 整型。PDU 会话是否反射 QoS。 0 不支持 1 支持 整型。UE 建立 PDU 会话时是否支持 IPv6 多宿主功能。 0 不支持 1 支持 整型。是否为永久在线 PDU 会话。 上海移远通信技术股份有限公司 172 / 273 RGx00U&RM500U 系列 AT 命令手册 0 否 1 是 举例 //不支持 5GS 时 AT+CGDCONT=1,'IP','UNINET','200.1.1.80',1,1,0,0,0,0,0 OK //支持 5GS 时 AT+CGDCONT=1,'IP','UNINET','200.1.1.80',1,1,0,0,0,0,0,,,,,,1,'',0,1,0,0 OK //不支持 5GS 时 AT+CGDCONT? +CGDCONT: 1,'IP','UNINET','200.1.1.80',1,1,0,0,,,,,,0,,,0,,0,0,0,0 +CGDCONT: 11,'IPV4V6','IMS','0.0.0.0',0,0,0,0,,,,,,0,,,0,,0,0,0,0 OK //支持 5GS 时 AT+CGDCONT? +CGDCONT: 1,'IP','UNINET','200.1.1.80',1,1,0,0,,,,,,0,,,1,,0,1,0,0 +CGDCONT: 2,'IP','UNINET','200.1.1.80',1,1,0,0,,,,,,0,,,1,,0,1,0,0 +CGDCONT: 11,'IPV4V6','IMS','0.0.0.0',0,0,0,0,,,,,,0,,,0,,0,0,0,0 OK //不支持 5GS 时 AT+CGDCONT=? +CGDCONT: (1-11),'IP',,,(0,3),(0,4),(0,1),(0,4),(0-2),,,,(0,1),,,,(0,2),(),(0,1),(0,1),(0,1),(0,1) OK //支持 5GS 时 AT+CGDCONT=? +CGDCONT: (1-11),'IP',,,(0,3),(0,4),(0,1),(0,4),(0-2),,,,(0,1),,,,(0,2),(),(0,1),(0,1),(0,1),(0,1) OK 9.3. AT+CGQREQ 服务质量参数（请求的） 在 MT 激活 PDP 上下文时，该命令允许 TE 指定服务质量参数。 该设置命令指定 PDP 上下文。设置命令的一种特殊形式 AT+CGQREQ=会使上下文标识 符请求的参数处于未定义状态。查询命令返回每个已定义的上下文的当前配置。详细信息请参考 3GPP TS 23.107。 上海移远通信技术股份有限公司 173 / 273 RGx00U&RM500U 系列 AT 命令手册 AT+CGQREQ 服务质量参数（请求的） 测试命令 AT+CGQREQ=? 响应 +CGQREQ: ,(支 持 的范 围),(支持的范围),(支持的范围),(支持 的范围),(支持的列表) 查询命令 AT+CGQREQ? OK 响应 [+CGQREQ:,,,,,] […] 设置命令 AT+CGQREQ=[,[,[,[,[,]]]]] OK 响应 OK 若错误与 MT 功能相关： +CME ERROR: 最大响应时间 300 毫秒 特性说明 参考 3GPP TS 27.007 该命令立即生效； 参数配置自动保存。 参数 整型。PDP 上下文 ID（请参考 AT+CGDCONT）。 字符串类型。指定分组数据协议类型。EPS 服务仅支持 IP、IPv6 和 IPv4v6。 'IP' 互联网协议版本 4（IPv4） 'IPV6' 互联网协议版本 6 'IPV4V6' 配置双栈 UE 功能，支持互联网协议版本 4 与版本 6 'Ethernet' 点对点协议（IETF STD 51 [104]） 整型。优先等级。 0 网络订阅值 1 优先级高。服务优先级在 2 级和 3 级优先级之前 2 优先级中。服务优先级在 3 级优先级之前 3 优先级低。继续保持服务 整型。延迟等级。详情请参考 3GPP TS 23.107。默认值：0。 整型。依赖等级。 0 网络订阅值 上海移远通信技术股份有限公司 174 / 273 RGx00U&RM500U 系列 AT 命令手册 1 不能有效处理数据丢失、非实时传输的误码敏感应用 2 不能有效处理偶尔数据丢失、非实时传输的误码敏感应用 3 能有效处理数据丢失，GMM/SM 和 SMS 非实时性传输的误码敏感应用 4 能有效处理数据丢失、实时传输的误码敏感应用 5 能有效处理数据丢失、实时传输的误码不敏感应用 整型。峰值吞吐量等级。以每秒八位字节为单位。 0 网络订阅值 1 高达 1 000（8 kbit/秒） 2 高达 2 000（16 kbit/秒） 3 高达 4 000（32 kbit/秒） 4 高达 8 000（64 kbit/秒） 5 高达 16 000（128 kbit/秒） 6 高达 32 000（256 kbit/秒） 7 高达 64 000（512 kbit/秒） 8 高达 128 000（1024 kbit/秒） 9 高达 256 000（2048 kbit/秒） 整型。平均吞吐量等级。单位：每小时八位字节。 0 网络订阅值 1 100（约 0.22 bit/秒） 2 200（约 0.44 bit/秒） 3 500（约 1.11 bit/秒） 4 1 000（约 2.2 bit/秒） 5 2 000（约 4.4 bit/秒） 6 5 000（约 11.1 bit/秒） 7 10 000（约 22 bit/秒） 8 20 000（约 44 bit/秒） 9 50 000（约 111 bit/秒） 10 100 000（约 0.22 kbit/秒） 11 200 000（约 0.44 kbit/秒） 12 500 000（约 1.11 kbit/秒） 13 1000 000（约 2.2 kbit/秒） 14 2 000 000（约 4.4 kbit/秒） 15 5 000 000（约 11.1 kbit/秒） 16 10 000 000（约 22 kbit/秒） 17 20 000 000（约 44 kbit/秒） 18 50 000 000（约 111 kbit/秒） 31 最大能力 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 175 / 273 RGx00U&RM500U 系列 AT 命令手册 9.4. AT+CGACT PDP 上下文激活/去激活 该命令用于激活/去激活指定的 PDP 上下文。命令设置完成后，MT 保持 V.250 命令状态。若任意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；在执行激活命令时，如果 MT 没有附着 PS，则 MT 会先进行 PS 附着，然后尝试激活指定的上下文。若未指定，将会激活或去激活所有定义的上下 文。 AT+CGACT PDP 上下文激活/去激活 测试命令 AT+CGACT=? 响应 +CGACT: (支持的列表) 查询命令 AT+CGACT? OK 响应 +CGACT: , [+CGACT: , …] 设置命令 AT+CGACT=, OK 响应 OK 或者 NO CARRIER 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现任何 MT 错误： +CME ERROR: 150 秒，取决于网络 - 参数 整型。PDP 上下文激活状态。 0 去激活 1 激活 设置命令中保留其它值，但是设置后将返回 ERROR。 整型。PDP 上下文 ID（请参考 AT+CGDCONT）。 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 176 / 273 举例 AT+CGDCONT=4,'IP','UNINET' OK AT+CGACT=1,4 OK AT+CGACT? +CGACT: 1,1 +CGACT: 2,0 +CGACT: 3,0 +CGACT: 4,1 OK AT+CGACT=0,4 OK RGx00U&RM500U 系列 AT 命令手册 //定义 PDP 上下文。 //激活 PDP 上下文。 //查询当前 PDP 上下文状态。 //去激活 PDP 上下文。 9.5. AT+CGDATA 进入数传状态 执行设置命令后，MT 将使用一种或多种分组域 PDP 类型进行操作，使 TE 与网络之间建立通信，可 能也会包括进行 PS 附着及一个或多个 PDP 上下文激活操作。MT 不会处理 AT 命令行中 AT+CGDATA 之 后的命令。 若 MT 无法接收的值，将返回 ERROR 或+CME ERROR；若 MT 可以接收，MT 将返回中间结 果码 CONNECT 并输入 V.250 在线数传状态。数据传输完成且第二层协议终止流程已成功完成后，将重新 进入命令状态，MT 将返回最终结果码 OK。 AT+CGDATA 进入数传状态 测试命令 AT+CGDATA=? 响应 +CGDATA: (支持的列表) 设置命令 AT+CGDATA=, OK 响应 CONNECT 最大响应时间 特性说明 参考 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 上海移远通信技术股份有限公司 177 / 273 3GPP TS 27.007 RGx00U&RM500U 系列 AT 命令手册 参数 字符串类型。TE 和 MT 间使用的第二层协议。 'PPP' PDP 的点对点协议，例如 IP 'M-IP' 制造商指定 IP 协议 'M-ETHER' 制造商指定以太网协议 不支持其他值，若配置为其他值，将返回 ERROR。 整型。PDP 上下文 ID（请参考 AT+CGDCONT）。 错误码。详情请参考第 13.3 章。 9.6. AT+CGPADDR 显示 PDP 地址 该命令返回指定上下文标识符的 PDP 地址列表。若未指定，则返回所有已定义上下文的地址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (支持的已定义的列表) 设置命令/执行命令 AT+CGPADDR[=[,[,...]]] OK 响应 +CGPADDR: , [+CGPADDR: ,] […] OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何问题： ERROR 300 毫秒 - 参数 整型。已定义的 PDP 上下文 ID（请参考 AT+CGDCONT）。 字符串类型。PDP 地址，用于标识适用于 PDP 的地址空间中的 TE。 上海移远通信技术股份有限公司 178 / 273 RGx00U&RM500U 系列 AT 命令手册 地址可为静态或动态： 静态地址在定义上下文时由 AT+CGDCONT 设置。 动态地址在上一次 PDP 上下文激活（使用了指定的上下文定义）期间分配。 若无可用的地址，该参数将被省略。 举例 AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' OK //定义 PDP 上下文。 //激活 PDP。 //显示 PDP 地址。 9.7. AT+CGREG GPRS 网络注册状态 该命令用于查询网络注册状态并控制非请求结果码上报： ⚫ =1 时，控制 URC +CGREG: 的显示，该 URC 指示 GERAN/UTRAN 中 MT 的 GPRS 网络注册状态的变化。 ⚫ =2 时，控制 URC +CGREG: [,,[,],[]]的显示，该 URC 指示 GERAN/UTRAN 中的网络小区的变化。 AT+CGREG 网络注册状态 测试命令 AT+CGREG=? 响应 +CGREG: (支持的范围) 查询命令 AT+CGREG? OK 响应 +CGREG: ,[,,[,],[][,,]] 设置命令 AT+CGREG[=] OK 响应 OK 最大响应时间 若有任何错误： ERROR 300 毫秒 上海移远通信技术股份有限公司 179 / 273 RGx00U&RM500U 系列 AT 命令手册 特性说明 参考 3GPP TS 27.007 该命令立即生效； 执行 AT&W 后将保存参数配置。 参数 整型。控制指定 URC 的上报。 0 禁止上报网络注册 URC 1 允许上报网络注册 URC +CGREG: 2 允许上报网络注册和位置信息 URC +CGREG: [,,[,],[]] 整型。GPRS 注册状态。 0 未注册。MT 当前未搜索注册业务的运营商。UE 处于 GMM 状态 GMM-NULL 或 GMM-DEREGISTERED-INITIATED。GPRS 服务被禁用，但用户请求后允许 UE 附着于 GPRS。 1 已注册，归属地网络。UE 处于归属地 PLMN 的 GMM 状态 GMM-REGISTERED 或 GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED。 2 未注册，但 MT 当前正尝试附着或搜索网络以进行注册。UE 处于 GMM 状态 GMM-DEREGISTERED 或 GMM-REGISTERED-INITIATED。GPRS 服务处于 使能状态，但允许的 PLMN 当前不可用。UE 将会在允许的 PLMN 可用时开始附 着 GPRS。 3 注册被拒绝。UE 处于 GMM 状态 GMM-NULL。GPRS 服务为禁用状态且用户请 求时 UE 无法附着 GPRS。 4 未知 5 已注册，漫游状态 字 符 串 类 型 。 十 六 进 制 格 式 的 两 字 节 位 置 区 号 （ 例 如 ：'00C3'等 价 于十 进 制 的 195）。 字符串类型。十六进制格式的四字节（UMTS/LTE）小区 ID。 十六进制格式的一字节路由区域码。 整型。拒绝理由的类型，即的类型。 0 为 GMM 原因值（详情参考 3GPP TS 24.008 Annex G） 1 为制造商的原因 整型。注册失败的原因。类型由定义。 整型。注册网络的接入技术。 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 上海移远通信技术股份有限公司 180 / 273 举例 AT+CGREG=2 OK AT+CGATT=0 OK +CGREG: 2 AT+CGATT=1 OK +CGREG: 1,'D5D5','8054BBF',6,'0' RGx00U&RM500U 系列 AT 命令手册 //设置允许上报网络注册和位置信息 URC： +CGREG: [,,[,],[]]。 9.8. AT+CGEREP 分组域事件上报 该命令用于在某些事件发生在分组域 MT 或网络中的情况下，启用/禁用从 MT 发送非请求结果码 +CGEV 至 TE。控制该命令指定的非请求结果码的处理。当指定为 1 或 2 时，控制 缓存的非请求结果码的上报策略。 AT+CGEREP 分组域事件上报 测试命令 AT+CGEREP=? 响应 +CGEREP: (支持的范围),(支持的列表) 查询命令 AT+CGEREP? OK 响应 +CGEREP: , OK 设置命令 AT+CGEREP=[,] 若有任何错误： ERROR 响应 OK 最大响应时间 特性说明 参考 若有任何错误： ERROR 300 毫秒 - 上海移远通信技术股份有限公司 181 / 273 3GPP TS 27.007 RGx00U&RM500U 系列 AT 命令手册 参数 整型。 0 缓冲 MT 中的非请求结果码；若 TA 结果码缓冲器已满，最早的非请求结果码将被丢 弃。结果码将不会转发至 TE。 1 当 MT-TE 间的链路被占用（比如：在线数据模式下），丢弃指定非请求结果码。否 则，直接转发给 TE。 2 当 MT-TE 间的链路被占用（比如：在线数据模式下），缓存 MT 中的非请求结果码； 当链路可用后，把结果码发送给 TE。否则，直接转发给 TE。 整型。 0 当为 1 或 2 时，清除 MT 中缓存的指定的非请求结果码 1 当为 1 或 2 时，MT 中缓存的指定的非请求结果码刷新到 TE（返回 OK 后刷 新） 备注 非请求结果码及其对应的事件定义如下： 1. +CGEV: REJECT ,：当MT无法通过+CRING非请求结果码将PDP上下文 激活事件上报TE且MT被自动拒绝时将向网络请求激活PDP上下文。 备注：该事件不适用于EPS和5GS。 2. +CGEV: NW REACT ,,[]：网络已经请求上下文重新激活。若MT知 悉，则会提供用于重新激活上下文的。 备注：该事件不适用于EPS。 3. +CGEV: NW DEACT ,,[]：网 络强制去 激活 上下文。 若MT知悉 ，则会提供用于激活上下文的。 4. +CGEV: ME DEACT ,,[]：ME已强制去激活了上下文。若MT知悉 ，则会提供用于激活上下文的。 5. +CGEV: NW DETACH：网络已强制去附着分组域，表示已经去激活所有的已激活的上下文。去激 活的上下文不会分开上报。 6. +CGEV: ME DETACH：ME已强制去附着分组域，表示已经去激活所有的已激活的上下文。去激活 的上下文不会分开上报。 7. +CGEV: NW CLASS ：网络已强制更换MS等级，且上报最高可用级别（详情请参考 AT+CGCLASS）。 8. +CGEV: ME CLASS ：ME已 强 制 更 换MS等 级 ， 且 上 报 最 高 可 用 级 别 （ 详 情 请 参 考 AT+CGCLASS）。 9. +CGEV: PDN ACT ：激活的上下文。该上下文表示LTE的PDN连接或GSM/UMTS的第一个 PDP上下文。 10. +CGEV: PDN DEACT ：去激活的上下文。该上下文表示LTE的PDN连接或GSM/UMTS的第 一个PDP上下文。 上海移远通信技术股份有限公司 182 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4 'IPV6' 互联网协议版本 6 'IPV4V6' 配置双栈 UE 功能，支持互联网协议版本 4 与版本 6 'Ethernet' 以太网协议 字符串类型。用于标识适用于 PDP 的地址空间中的 MT。如果该值为空或被省略， 则 TE 在 PDP 启 动 过 程 中 提 供 该 值 ； 否 则 ， 将 请 求 动 态 地 址 。 可 以 使 用 AT+CGPADDR 读取分配的地址。 整型。PDP上下文ID。该参数是TE-MT接口的本地参数，在其他与PDP上下文相 关的命令中使用。范围：1~8，11。 字符串类型。表示GPRS移动等级。 A 等级A（最高） B 等级B C GPRS和电路交换备用模式的等级C CG 仅GPRS模式的等级C CC 仅电路交换备用模式的等级C（最低） 举例 AT+CGEREP=? +CGEREP: (0-2),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK AT+CGEREP=2,1 OK AT+CGACT=1,2 OK //激活一个上下文。 +CGEV: PDN ACT 2 AT+CGACT=0,2 //去激活一个上下文。 OK +CGEV: PDN DEACT 2 上海移远通信技术股份有限公司 183 / 273 RGx00U&RM500U 系列 AT 命令手册 9.9. AT+CGSMS 选择 MO 短消息服务 该命令用于指定 MT 用于发送 MO（移动终端发起）短消息的服务或优选服务。 AT+CGSMS 选择 MO 短消息服务 测试命令 AT+CGSMS=? 响应 +CGSMS: (支持的范围) 查询命令 AT+CGSMS? OK 响应 +CGSMS: 设置命令 AT+CGSMS= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 相关： +CME ERROR: 300 毫秒 - 参数 整型。使用的服务或优选服务。 0 PS 域 1 CS 域 2 优选 PS 域（PS 域不可用时使用 CS 域） 3 优选 CS 域（CS 域不可用时使用 PS 域） 错误码。详情请参考第 13.3 章。 9.10. AT+CEREG EPS 网络注册状态 设置命令用于查询网络状态并控制 EPS 网络注册状态的非请求结果码的上报。 ⚫ =1 时，控制 URC +CEREG: 的显示，该 URC 指示 E-UTRAN 中 MT 的 EPS 网络注册 状态的变化。 ⚫ =2 时，控制 URC +CEREG：[,,[,]]的显示，该 URC 指示 E-UTRAN 上海移远通信技术股份有限公司 184 / 273 RGx00U&RM500U 系列 AT 命令手册 中的网络小区的变化。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 查询命令 AT+CEREG? 设置命令 AT+CEREG= 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 +CEREG: (支持的范围) OK 响应 +CEREG: ,[,,[,][,, ]] OK 响应 OK 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置执行 AT&W 后保存。 参数 整型。 0 禁止上报网络注册 URC 1 允许上报网络注册 URC +CEREG: 2 允许上报网络注册和位置信息 URC +CEREG: [,,[,]] 整型。EPS 网络注册状态。 0 未注册。MT 当前未搜索到注册业务的运营商 1 已注册，归属地网络 2 未注册，但 MT 当前正尝试附着或搜索网络以进行注册 3 注册被拒绝 4 未知 5 已注册，漫游状态 8 紧急服务 字符串类型。十六进制格式的两字节位置区号。 字符串类型。十六进制格式的四字节（E-UTRAN）小区 ID。 整型。拒绝理由的类型，即的类型。 0 为 GMM 原因值（详情参考 3GPP TS 24.008 Annex G） 1 为制造商的原因 整型。注册失败的原因。类型由定义。 上海移远通信技术股份有限公司 185 / 273 整型。注册网络的接入技术。 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 10 连接到 5GCN 的 E-UTRAN 11 连接到 5GCN 的 NR 12 NG-RAN 13 E-UTRAN-NR 双重连接 15 HSPA+ RGx00U&RM500U 系列 AT 命令手册 9.11. AT+C5GREG 5GS 网络注册状态 设置命令用于查询网络状态并控制如下非请求结果码的上报： ⚫ =1 时，控制 URC +C5GREG: 的上报，该 URC 指示 5GS 中 MT 网络注册状态的变 化。 ⚫ =2 或当网络提供允许的 NSSAI 时，控制 URC +C5GREG: [,[],[],[],[< Allowed_NSSAI_length>],[]]的上报，该 URC 指示 5GS 中的网络小区的变 化 。、、、和仅在 可用时提供 。 AT+C5GREG 5GS 网络注册状态 测试命令 AT+C5GREG=? 响应 +C5GREG: (支持的范围) 查询命令 AT+C5GREG? OK 响应 +C5GREG: ,[,[],[],[[,,][,,]] OK 设置命令 AT+C5GREG= 若有任何错误： ERROR 或者 +CME ERROR: 响应 OK 若有任何错误： ERROR 上海移远通信技术股份有限公司 186 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007(R15) 或者 +CME ERROR: 300 毫秒 - 参数 整型。 0 禁用网络状态 URC 1 启用网络状态 URC +C5GREG: 2 启用网络状态 URC： +C5GREG: [,[],[],[],[],[]] 整型。5G NR 注册状态。 0 未注册。MT 当前未搜索到注册业务的运营商 1 已注册，归属地网络 2 未注册，但 MT 当前正尝试附着或搜索网络以进行注册 3 注册被拒绝 4 未知 5 已注册，漫游状态 字符串类型。十六进制格式的三字节追踪区号。 字符串类型。十六进制格式的五字节 NR 小区 ID。 整型。选择的网络接入技术。 10 EUTRAN-5GC 11 NR-5GC 整型。取值以八位字节为单位的长度。 十六进制格式的字符串类型。网络接收的允许的 S-NSSAI 列表。参数值 可使用冒号隔开。 整型。拒绝理由的类型，即的类型。 0 为 GMM 原因值（参考 3GPP TS 24.008 Annex G） 1 为制造商的原因。 整型。注册失败的原因。类型由定义。 错误码。详情请参考第 13.3 章。 备注 该命令仅支持 5G NR 服务。 上海移远通信技术股份有限公司 187 / 273 举例 AT+C5GREG=1 OK AT+C5GREG? +C5GREG: 1,1 OK RGx00U&RM500U 系列 AT 命令手册 9.12. AT+C5GQOS 设置 5GS 服务质量 该命令用于设置或删除特定 PDP 上下文 ID 的 5G 服务质量参数。详情请参考 3GPP TS 23.501 和 3GPP TS 24.501。有关错误码详情，请参考 3GPP TS 24.501 subclause 9.2。 AT+C5GQOS 设置 5GS 服务质量 测试命令 AT+C5GQOS=? 响应 +C5GQOS: (支持的范围),(支持的范围),(支持的 范 围),(支 持 的范 围),(支 持 的 范围),(支持的范围) 查询命令 AT+C5GQOS? OK 响应 [+C5GQOS:,[,,[,,]] [+C5GQOS:,[,,[,,]] […]] 设置命令 AT+C5GQOS=[[,[,,[,,]]]] 最大响应时间 OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 特性说明 - 参考 3GPP TS 27.007(R15) 上海移远通信技术股份有限公司 188 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。特定 PDP 上下文 ID。范围：1~31。 整型。5GS QoS 的等级。范围：0~254。 0 网络选择 5QI 1~4, 71~76 保证比特率 QoS 流的取值范围 65~67 保证比特率 QoS 流的值 5~9 非保证比特率 QoS 流的取值范围 69/70/79/80 非保证比特率 QoS 流的值 82~85 低时延保证比特率 QoS 流的取值范围 128~254 运营商定制 5QI 的取值范围 整型。GBR 5QI 下的下行 GFBR。范围：0~4294967295；单位：kbit/s。非 GBR 5QI 下省略该参数。 整型。GBR 5QI 下的上行 GFBR。范围：0~4294967295；单位：kbit/s。非 GBR 5QI 下省略该参数。 整型。GBR 5QI 下的下行 MFBR。范围：0~4294967295；单位：kbit/s。非 GBR 5QI 下省略该参数。 整型。GBR 5QI 下的上行 MFBR。范围：0~4294967295；单位：kbit/s。非 GBR 5QI 下省略该参数。 错误码。详情请参考第 13.3 章。 举例 AT+C5GQOS=1,1,1000,2000,3000,4000 OK AT+C5GQOS? +C5GQOS: 1,1,1000,2000,3000,4000 +C5GQOS: 2,65,1000,1000,1000,1000 OK AT+C5GQOS=? +C5GQOS: (1-31),(0-254),(0-4294967295),(0-4294967295),(0-4294967295),(0-4294967295) OK 9.13. AT+C5GQOSRDP 查询 5GS 动态 QoS 参数 该命令用于查询指定 PDP 上下文或者全部已激活的上下文的网络侧分配的 5G QoS 参数。 上海移远通信技术股份有限公司 189 / 273 RGx00U&RM500U 系列 AT 命令手册 AT+C5GQOSRDP 查询 5GS 动态 QoS 参数 测试命令 AT+C5GQOSRDP=? 响应 +C5GQOSRDP: (支持的与 QoS 流关联的列表) 设置命令 AT+C5GQOSRDP[=] OK 响应 [+C5GQOSRDP: ,[,,[, ,[,, [,]]]] […] OK 最大响应时间 特性说明 参考 3GPP TS 27.007(R15) 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 参数 整型。PDP 上下文 ID。范围：1~8，11。 整型。5GS QoS 的等级。范围：0~254。 0 网络选择 5QI 1~4, 71~76 保证比特率 QoS 流的取值范围 65/66/67 保证比特率 QoS 流的值 5~9 非保证比特率 QoS 流的取值范围 69/70/79/80 非保证比特率 QoS 流的值 82~85 低时延保证比特率 QoS 流的取值范围 128~254 运营商定制 5QI 的取值范围 整型。GBR 5QI 下的下行 GFBR。范围：0~4294967295；单位：kbit/s。非 GBR 5QI 下省略该参数。 整型。GBR 5QI 下的上行 GFBR。范围：0~4294967295；单位：kbit/s。非 GBR 5QI 下省略该参数。 整型。GBR 5QI 下的下行 MFBR。范围：0~4294967295；单位：kbit/s。非 GBR 5QI 下省略该参数。 整型。GBR 5QI 下的上行 MFBR。范围：0~4294967295；单位：kbit/s。非 GBR 5QI 下省略该参数。 上海移远通信技术股份有限公司 190 / 273 RGx00U&RM500U 系列 AT 命令手册 整型。上行会话 AMBR（请参考 3GPP TS 24.501）。单位：kbit/s。 整型。下行会话 AMBR（请参考 3GPP TS 24.501）。单位：kbit/s。 整型。平均窗口大小（请参考 3GPP TS 24.501）。单位：毫秒。 错误码。详情请参考第 13.3 章。 举例 AT+C5GQOSRDP=1 //查询=1 的网络侧分配的 5G QoS 参数。 +C5GQOSRDP: 1,1,1000,2000,3000,4000,10000,10000,2000 OK AT+C5GQOSRDP=? +C5GQOSRDP: 1 OK 9.14. AT+C5GNSSAI 设置 5GS 默认 NSSAI 该命令用于启用更新存储在 MT 上的默认配置的 NSSAI。若的 值为 0 且由空字符串组成，则任何 MT 上存储的默认已配置 NSSAI 将被 MT 删除。如果 MT 先前已通过 NAS 信令从网络接收了默认配置的 NSSAI，则不会更新 MT 上存储的默认配置 的 NSSAI。 AT+C5GNSSAI 设置 5GS 默认 NSSAI 测试命令 AT+C5GNSSAI=? 响应 +C5GNSSAI: (支 持 的 范围),(支持的列表) 查询命令 AT+C5GNSSAI? OK 响应 +C5GNSSAI: [,] 设置命令 AT+C5GNSSAI=, OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 191 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007(R15) 300 毫秒 - 参数 整型。存储在 MT 的默认配置的 NSSAI 的长度；以八位字节为 单位。若取值为 0，则 MT 不会存储默认配置的 NSSAI。 十六进制的字符串类型。存储在 MT 的默认配置的 NSSAI。若 该值为空字符（''），则 MT 不会存储默认配置的 NSSAI。 错误码。详情请参考第 13.3 章。 举例 AT+C5GNSSAI=15,'1:2:3:4:5:6:7:8' OK AT+C5GNSSAI? +C5GNSSAI: 15,'1:2:3:4:5:6:7:8' OK //设置 5GS 默认 NSSAI。 9.15. AT+C5GPNSSAI 设置 5GS 优选 NSSAI 该命令将优选 NSSAI 指定为与 TE 的优选项匹配的 S-NSSAI 的列表。优选的 NSSAI 被编码为 SNSSAI 的 HPLMN 值的列表。其内容独立于所选或所注册的 PLMN。MT 在选择请求的 NSSAI 时会考虑优 选的 NSSAI。 AT+C5GPNSSAI 设置 5GS 优选 NSSAI 测试命令 AT+C5GPNSSAI=? 响应 +C5GPNSSAI: (支持的 范围),(支持的范围) 查询命令 AT+C5GPNSSAI? OK 响应 +C5GPNSSAI: [,[]],[,[]] OK 上海移远通信技术股份有限公司 192 / 273 RGx00U&RM500U 系列 AT 命令手册 设置命令 AT+C5GPNSSAI=[,[]],[,[]] 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 - 参考 3GPP TS 27.007(R15) 参数 整 型 。的 长 度 ； 以 八 位 字 节 为 单 位。若参数为 0，则 MT 不会存储 3GPP 接入的优选 NSSAI。 十六进制的字符串类型。存储在 MT 的 3GPP 接入的优选 NSSAI。该参数被编码为由冒号分隔的 S-NSSAI 列表。若该 值 为 空 字 符 （''） ， 则 MT 不 会 存 储 3GPP 接 入 的 优 选 NSSAI。 整型。的长度，以八位字节为 单位。若参数为 0，则 MT 不会存储非 3GPP 接入的优选 NSSAI。 十六进制的字符串类型。存储在 MT 的非 3GPP 接入的优选 NSSAI。该参数被编码为由冒号分隔的 S-NSSAI 列表。若该 值为空字符（''），则 MT 不会存储非 3GPP 接入的优选 NSSAI。 错误码。详情请参考第 13.3 章。 举例 AT+C5GPNSSAI=15,'1:2:3:4:5:6:7:8' OK AT+C5GPNSSAI? +C5GPNSSAI: 15,'1:2:3:4:5:6:7:8' OK 上海移远通信技术股份有限公司 193 / 273 RGx00U&RM500U 系列 AT 命令手册 9.16. AT+QNETDEVCTL 执行/断开网卡拨号 该命令用于执行/断开网卡拨号。 AT+QNETDEVCTL 执行/断开网卡拨号 测试命令 AT+QNETDEVCTL=? 响应 +QNETDEVCTL: ( 支 持 的 范 围 ),( 支 持 的 列 表),(支持的列表) 查询命令 查询当前所有的上下文配置 AT+QNETDEVCTL? OK 响应 [+QNETDEVCTL: ,,] […] 设置命令 通过指定 PDP 进行拨号上网 AT+QNETDEVCTL=[,,] OK 响应 若省略可选参数，则查询当前配置： +QNETDEVCTL: ,, OK 若指定可选参数，通过指定 PDP 进行拨号上网： OK 最大响应时间 特性说明 如有任何错误： ERROR 300 毫秒 - 参数 整型。PDP 上下文标识。范围：1~8，11。 整型。设置拨号操作。 0 断开拨号，不保存配置 1 进行拨号，不保存配置 2 断开拨号，保存配置 3 进行拨号，保存配置 整型。是否开启自动连接，仅在=1 或 3 时有效，即进行拨号后是否开启自动重 连。 0 不开启自动连接，返回值同步响应；需要等待拨号结果才能有返回值，当断开 上海移远通信技术股份有限公司 194 / 273 RGx00U&RM500U 系列 AT 命令手册 连接后不会自动重新连接，需要手动配置 1 开启自动重连，返回值立即响应；当 PDP 断开后，会立刻触发重拨机制，每隔 8 秒、16 秒、32 秒….倍数时间进行重试，最大重试间隔时间 512 秒 备注 执行或断开拨号后，模块将上报 URC +QNETDEVSTATUS: ,,,。 整型。PDP 上下文标识。范围：1~8，11。 整型。当前网卡连接状态。 0 连接断开 1 已连接 字符串类型。IP 版本。 'IPV4' 互联网协议版本 4 'IPV6' 互联网协议版本 6 'IPV4V6' 配置双栈 UE 功能，支持互联网协议版本 4 与版本 6 整型。操作结果码。 0 成功 3331 超时 其他 遵循 3GPP SM Cause 原因码 举例 //通过 AT+QICSGP 配置协议类型为 IPv4。 AT+QNETDEVCTL=1,1,1 //设置为 1，进行 IPv4 拨号连接，并开启自动重连。 OK +QNETDEVSTATUS: 1,1,'IPV4',0 //拨号成功后，主动上报 URC。 9.17. AT+QNETDEVSTATUS 查询网卡状态 该命令用于查询网卡状态信息。 AT+QNETDEVSTATUS 查询网卡状态 测试命令 AT+QNETDEVSTATUS=? 响应 +QNETDEVSTATUS: (支持的范围) 设置命令 AT+QNETDEVSTATUS= OK 响应 +QNETDEVSTATUS: ,,,,,,,,,,, 上海移远通信技术股份有限公司 195 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 OK 若有任何错误： +CME ERROR: 300 毫秒 - 参数 整型。PDP 上下文标识。范围：1~8，11。 主机 IPv4 地址。范围：0x0000_0000~0xFFFF_FFFF。 IPv4 子网掩码。范围：0x0000_0000~0xFFFF_FFFF。 IPv4 默认网关。范围：0x0000_0000~0xFFFF_FFFF。 IPv4 DHCP 服务器的地址。范围：0x0000_0000~0xFFFF_FFFF。 首选 IPv4 DNS 的地址。范围：0x0000_0000~0xFFFF_FFFF。 备用 IPv4 DNS 的地址。范围：0x0000_0000~0xFFFF_FFFF。 主机 IPv6 地址。范围：0x::~0xFFFF_FFFF_FFFF_FFFF。 IPv6 子网掩码。范围：0x::~0xFFFF_FFFF_FFFF_FFFF。 IPv6 默认网关。范围：0x::~0xFFFF_FFFF_FFFF_FFFF。 IPv6 DHCP 服务器的地址。范围：0x::~0xFFFF_FFFF_FFFF_FFFF。 首选 IPv6 DNS 的地址。范围：0x::~0xFFFF_FFFF_FFFF_FFFF。 备用 IPv6 DNS 的地址。范围：0x::~0xFFFF_FFFF_FFFF_FFFF。 错误码。详情请参考第 13.3 章。 备注 1. 查询对应 PDP 上下文的网卡状态，若返回 ERROR，则表明处于断开连接状态；若返回对应 的 IP 地址网关等信息，则表明当前处于拨号连接状态。 2. 所述的 IP 地址以点分十进制表示，如：192.168.0.1。 9.18. AT+QICSGP 配置 PDP 上下文参数 该命令用于配置、、以及其他 PDP 上下文参数。 上海移远通信技术股份有限公司 196 / 273 RGx00U&RM500U 系列 AT 命令手册 AT+QICSGP 配置 PDP 上下文相关参数 测试命令 AT+QICSGP=? 响应 +QICSGP: (支 持 的范 围),(支 持 的范围),,,,(支持的范围) 设置命令 查询指定上下文配置 AT+QICSGP= OK 响应 +QICSGP: ,,,, 查询命令 查询当前所有的上下文配置 AT+QICSGP? OK 响应 [+QICSGP: ,,,,, …] 设置命令 配置指定上下文 AT+QICSGP=[,,[,,)[,]]] OK 响应 OK 若有任何错误： ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置自动保存。 参数 整型。PDP 上下文 ID。范围：1~8。 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 4 Ethernet 字符串类型。接入点名称。 字符串类型。用户名。 字符串类型。密码。 整型。鉴权方式。 0 None 上海移远通信技术股份有限公司 197 / 273 1 PAP 2 CHAP 3 PAP 或 CHAP RGx00U&RM500U 系列 AT 命令手册 9.19. AT+QGDCNT 流量统计 该命令用于查询 MT 发送或接收的字节数。 AT+QGDCNT 流量统计 测试命令 AT+QGDCNT=? 响应 +QGDCNT: (支持的列表) 设置命令 AT+QGDCNT= OK 响应 OK 查询命令 查询统计的流量信息 AT+QGDCNT? 最大响应时间 特性说明 若错误与MT功能相关： +CME ERROR: 响应 +QGDCNT: , OK 300 毫秒 - 参数 整型。操作类型。 0 重置统计的流量信息 1 保存当前统计的流量信息 如需自动保存当前统计的流量信息，请参考第 9.20 章。 超长整型。发送的字节数。 超长整型。接收的字节数。 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 198 / 273 RGx00U&RM500U 系列 AT 命令手册 9.20. AT+QAUGDCNT 设置自动保存流量信息的时间间隔 该命令用于设置自动保存 MT 发送或接收的字节数的时间间隔。 AT+QAUGDCNT 设置自动保存流量信息的时间间隔 测试命令 AT+QAUGDCNT=? 响应 +QAUGDCNT: (支持的列表) 查询命令 AT+QAUGDCNT? OK 响应 +QAUGDCNT: OK 设置命令 AT+QAUGDCNT= 响应 OK 最大响应时间 特性说明 若错误与MT功能相关： +CME ERROR: 300 毫秒 - 参数 整型。自动保存流量信息的时间间隔。单位：秒。 0 禁用自动保存 30~65535 时间间隔 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 199 / 273 RGx00U&RM500U 系列 AT 命令手册 10 补充业务命令 10.1. AT+CCFC 呼叫转移 该命令根据 3GPP TS 22.082，用于控制呼叫转移补充服务。 AT+CCFC 呼叫转移 测试命令 AT+CCFC=? 响应 +CCFC: (支持的范围) 设置命令 AT+CCFC=,[,[,[,[,[,[,]]]]]] OK 响应 若不为2且命令执行成功： OK 若为2且 命 令 执 行 成 功 （ 仅 与=(0~3)有 关）： 若注册了呼叫转移号码： +CCFC: ,[,,[,,[,]]] [+CCFC: ,[,,[,,[,]]] [...]] OK 若未注册呼叫转移号码（即所有类别均未激活）： +CCFC: , OK 最大响应时间 特性说明 参考 若错误与MT功能相关： +CME ERROR: 300 毫秒 - 上海移远通信技术股份有限公司 200 / 273 3GPP TS 27.007 RGx00U&RM500U 系列 AT 命令手册 参数 整型。呼叫转移条件。 0 无条件转移 1 遇忙转移 2 无应答转移 3 不可达转移 4 所有呼叫转移（参见3GPP TS 22.030） 5 所有条件呼叫转移（参见3GPP TS 22.030） 整型。操作类型。 0 禁用 1 启用 2 查询状态 3 注册 4 删除 整型。呼叫转移地址的电话号码。指定电话号码地址类型。 整型。地址类型。当拨号字符串中包含国际接入代码字符'+'时，默认值为145；若不 包含，则默认值为129。 字符串类型。子地址。指定子地址类型。 整型。子地址类型。 整型。业务类别。取值为以下业务类别的组合（异或运算格式）。默认值：7 = 1 + 2 + 4 （语音、数据和传真）。 1 语音（电话） 2 数据（指所有承载服务；如果TA在=2的情况下不支持16、32、64和128， 则仅指某些承载服务） 4 传真（传真服务） 8 短消息服务 16 数据电路同步 32 数据电路异步 64 专用数据包访问 128 专用PAD访问 整型。当启用或查询'无应答转移'，'所有呼叫转移'或'所有条件呼叫转移'时， 此参数表示在呼叫转移前等待的时长。范围：0~30；默认值：20；单位：秒。 整型。呼叫转移服务状态。 0 未激活 1 激活 错误码。详情请参考第13.3章。 上海移远通信技术股份有限公司 201 / 273 备注 使用该命令之前需确保当前 PDP 上下文为已激活状态。 RGx00U&RM500U 系列 AT 命令手册 举例 AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,255 OK //注册用于无条件呼叫转移的目的地号码。 //未指定的情况下，查询无条件呼叫转移状态。 //删除注册的无条件呼叫转移目的地号码。 //查询状态，显示没有目的地号码。 10.2. AT+CCWA 呼叫等待控制 该命令根据 3GPP TS 22.083，用于控制呼叫等待服务，包括激活、去激活和状态查询。 AT+CCWA 呼叫等待控制 测试命令 AT+CCWA=? 响应 +CCWA: (支持的列表) 查询命令 AT+CCWA? OK 响应 +CCWA: 设置命令 AT+CCWA=[[,[,]]] OK 响应 TA 控制呼叫等待服务，进行激活、去激活或状态查询。 若不为 2 且命令执行成功： OK 若为 2 且命令执行成功： +CCWA: , [+CCWA: , [...]] 上海移远通信技术股份有限公司 202 / 273 RGx00U&RM500U 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 - 参数 整型。启用或者禁用呼叫等待指示 URC 上报。当启用 MT 显示呼叫等待（即启用呼叫 等 待 ） 且 呼 叫 等 待 期 间 终 止 本 次 呼 叫 业 务 时 ， 将 上 报 如 下 URC：+CCWA: ,,[,][,[,,[,]]]。 0 禁用 1 启用 整型。当省略时，网络将忽略此命令。 0 禁用呼叫等待控制 1 启用呼叫等待控制 2 查询呼叫等待控制状态 整型。业务类别。取值为以下业务类别的组合（异或运算格式）。 1 语音（电话业务） 2 数 据 （ 指 所 有 承 载 服 务 ； 如 果TA在=2的 情 况 下 不 支 持16、32、64和 128，则仅指某些承载服务） 4 传真（传真服务） 8 短消息服务 16 数据电路同步 32 数据电路异步 64 专用数据包访问 128 专用 PAD 访问 整型。是否启用呼叫等待控制服务。 0 禁用 1 启用 整型。呼叫地址的电话号码。指定电话号码地址类型。 整型。电话号码地址类型。 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 可选字符串类型。以字母数字形式表示，对应在电话簿中 的位置。 整型。中不包含主叫方 BCD 号码的原因（参考 3GPP TS 上海移远通信技术股份有限公司 203 / 273 RGx00U&RM500U 系列 AT 命令手册 24.008 subclause 10.5.4.30）。 0 CLI 有效 1 主叫方挂起 CLI（参见 3GPP TS 24.008 中表 10.5.135a/3GPP TS 24.008'Reject by user'相关代码） 2 由于网络问题或主叫方网络限制，CLI 不可用（参考 3GPP TS 24.008 中表 10.5.135a/3GPP TS 24.008 'Interaction with other service'相关代码）。 3 由于主叫方为付费电话类型，CLI 不可用（参考 3GPP TS 24.008 中表 10.5.135a/3GPP TS 24.008 'Coin line/payphone' 相关代码）。 4 由于其他原因导致的 CLI 不可用。（参考 3GPP TS 24.008 中表 10.5.135a/3GPP TS 24.008 'Unavailable'相关代码） CLI 不可用时（即当=2/3/4），应为空字 符串('')且值无意义。此时 TA 可能返回的值为 129 （3GPP TS 24.008 subclause 10.5.4.7 中未知的 TON/NPI）。 当主叫方拒绝 CLI 时，（即=1）且 CLIP 提供了 'override category'选项（参考 3GPP TS 22.081 和 3GPP TS 23.081），则需指定和；否则，TA 将返回和 CLI 不可用时相同的和。 字符串类型。子地址。格式由指定。 整型。八位字节的子地址（参考 3GPP TS 24.008 subclause 10.5.4.8）。 可选数字类型。来电 eMLPP 优先级。3GPP TS 22.067 eMLPP 定义 该值。 错误码。详情请参考第 13.3 章。 备注 1. 若包 含 的 所 有 业 务 的处 于 未 激 活 状 态 ， 此 时 返 回 的为 0。 例 如 ， +CCWA: 0,7。 2. =2 时，将上报所有呼叫等待类别。此时，按任意键均可中止该命令。 举例 AT+CCWA=1,1 OK ATD10086; OK +CCWA: '02154450293',129,1 //启用 URC 上报。 //建立呼叫。 //通话中来电，来电处于呼叫等待状态中。 上海移远通信技术股份有限公司 204 / 273 RGx00U&RM500U 系列 AT 命令手册 10.3. AT+CHLD 呼叫相关补充业务 该命令用于控制以下补充业务： ⚫ 暂时与 MT 断开连接但与网络保持连接的呼叫 ⚫ 多方通话（电话会议）； ⚫ 主叫方将保持的呼叫和正在通话或者当前来电建立通话连接，同时结束主叫方的通话。 根据 3GPP TS 22.030 中的定义，可以将呼叫保持、恢复、释放并添加到会话中，并进行转移。 该命令基于 GSM/UMTS 补充业务 HOLD（呼叫保持；详情参考 3GPP TS 22.083 clause 2），MPTY （ 多 方 通 话 ； 详 情 参 考 3GPP TS 22.084 ） 和 ECT （ 呼 叫 转 接 ； 详 情 参 考 3GPP TS 22.091 ） 。 GSM/UMTS 标准中描述了该命令与基于其他 GSM/UMTS 补充业务命令交互的过程。呼叫保持、多方通话 和呼叫转接仅适用于电话业务（即用户终端业务 11）。 设置命令用于控制呼叫保持、多方通话和呼叫转接，支持呼叫保持、呼叫恢复、呼叫释放、添加至对 话以及呼叫转移功能。 AT+CHLD 呼叫相关补充业务 测试命令 AT+CHLD=? 响应 +CHLD: (支持的列表) 设置命令 AT+CHLD=[] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 - 参数 整型。 0 挂断所有被保持的呼叫或等待的呼叫 UDUB（用户决定用户忙）。如果有呼叫处于 等待状态，则挂断等待中的呼叫；否则，挂断所有进行的呼叫（若当前存在呼叫） 1 挂断所有正在通话的呼叫，并接听等待的呼叫或恢复被保持的呼叫 1X 挂断某一特定的接听呼叫 X (X = 1~7) 2 保持所有正在通话的呼叫，并接听等待的呼叫或恢复被保持的呼叫 2X 保持除呼叫 X（X = 1~7）外的所有其他呼叫 上海移远通信技术股份有限公司 205 / 273 RGx00U&RM500U 系列 AT 命令手册 3 建立多方通话 4 将保持的呼叫和当前的来电建立通话，主叫方结束呼叫；或将正在通话的呼叫和等 待的呼叫建立通话，主叫方结束呼叫（ECT） 5 激活或接听网络发起的呼叫（CCBS） 7X 挂断某一特定的会议电话 X (X = 1~7) 错误码。详情请参考第 13.3 章。 举例 ATD10086; OK //建立呼叫。 +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129 //通话中来电，来电处于呼叫等待状态中。 //保持第一路通话，并接入第二路呼叫等待的通话。 //保持第一路呼叫。 +CLCC: 2,1,0,0,0,'02154450293',129 //接入第二路呼叫等待的通话。 OK AT+CHLD=21 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 //保持除第一路呼叫外其他所有呼叫。 //接入第一路通话。 +CLCC: 2,1,1,0,1,'02154450293',129 //保持第二路通话。 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129 +CLCC: 2,1,0,0,1,'02154450293',129 //将保持的呼叫添加到进行中的通话中建立多方电话会议。 //查询当前 MT 呼叫。 OK 10.4. AT+CLIP 主动上报来电号码 该命令为 GSM/UMTS 补充业务 CLIP（主叫号码显示），用于来电时，被叫方获取主叫号码身份信息。 设置命令用于使能或禁用 TE 端来电号码上报。 上海移远通信技术股份有限公司 206 / 273 RGx00U&RM500U 系列 AT 命令手册 AT+CLIP 主动上报来电号码 测试命令 AT+CLIP=? 响应 +CLIP: (支持的列表) 查询命令 AT+CLIP? OK 响应 +CLIP: , 设置命令 AT+CLIP=[] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 15 秒，取决于网络 - 参数 整型。启用或禁用被叫指示 URC 上报。当启用在 TE 显示 CLIP（且主叫方允许）时， 被叫通话里返回 RING（或者+CRING: ）后，将上报如下 URC： +CLIP: ,,[subaddr],[satype],[],。 0 禁用 URC 上报 1 启用 URC 上报 整型。 0 未提供 CLIP 业务 1 提供 CLIP 业务 2 未知 字符串类型。呼叫地址的电话号码，格式由指定。 字符串类型。子地址，格式由定义。 整型。八位字节子地址类型（详情参考 3GPP TS 24.008 subclause 10.5.4.8）。 整型。八位字节的地址类型。 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 161 国际号码 可选字符串类型。以字母数字形式表示对应在电话簿中的 位置。 整型。 0 CLI 有效 上海移远通信技术股份有限公司 207 / 273 RGx00U&RM500U 系列 AT 命令手册 1 主叫方拒绝 CLI 2 由于网络问题或主叫方网络限制造成 CLI 不可用 错误码。详情请参考第 13.3 章。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,,,'QUECTEL',0 10.5. AT+CLIR 主叫号码限制 该命令是基于 3GPP TS 22.081 的 CLIR（主叫线路识别限制）补充业务和 3GPP TS 24.607 的 OIR （主叫识别限制）补充业务。该命令在主叫方发起呼叫时，用于启用或禁用主叫电话号码限制。 当临时模式（临时限制或临时允许）作为后续所有主叫的默认值时，该设置命令可以修改 CLIR 的订 阅信息（默认是限制或者允许）。 AT+CLIR 主叫号码限制 测试命令 AT+CLIR=? 响应 +CLIR: (支持的范围) 查询命令 AT+CLIR? OK 响应 +CLIR: , 设置命令 AT+CLIR= OK 响应 OK 最大响应时间 特性说明 参考 若错误与 MT 功能相关： +CME ERROR: 15 秒，取决于网络 - 上海移远通信技术股份有限公司 208 / 273 3GPP TS 27.007 参数 整型。调整呼出电话状态。 0 根据签约 CLIR 的服务来显示 1 启用 CLIR 2 限制 CLIR 整型。显示网络中的 CLIR 业务状态。 0 CLIR 业务未提供 1 CLIR 业务以永久模式提供 2 未知（如网络原因） 3 CLIR 业务临时限制 4 CLIR 业务临时允许 错误码。详情请参考第 13.3 章。 RGx00U&RM500U 系列 AT 命令手册 10.6. AT+COLP 被接线识别显示 该命令用于在建立呼叫后允许/禁止主叫方获取被叫方身份，详情可参考 GSM/UMTS 补充业务 COLP （被叫识别显示）。MT 启用或禁用在 TE 显示 COL（被叫识别），不影响网络中补充业务 COLR 的执行。 AT+COLP 被接线识别显示 测试命令 AT+COLP=? 响应 +COLP: (支持的列表) 查询命令 AT+COLP? OK 响应 +COLP: , 设置命令 AT+COLP=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 响应+CR 或 V.25ter 之前，TA 返回中间结果码至 TE。 OK 15 秒，取决于网络状态 - 上海移远通信技术股份有限公司 209 / 273 参数 RGx00U&RM500U 系列 AT 命令手册 整型。禁用/启用在 MT 中显示结果码。 0 禁用 1 启用；使能结果码（且被叫方允许）后，将返回如下中间结果码： +COLP: ,,[],[],[] 整型。是否在网络中提供用户 COLP 业务。 0 COLP 业务未提供 1 COLP 业务已提供 2 未知（如网络原因） 字符串类型。电话号码。指定电话号码地址类型。 整型。电话号码地址类型。 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 字符串类型。子地址。指定子地址类型。 整型。子地址类型（参考 3GPP TS 24.008 10.5.4.8）。 可选字符串类型。以字母数字表示对应在电话号码簿中的位 置。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK 10.7. AT+CSSN 补充业务通知 该命令指与补充服务有关的网络发起的通知，该设置命令启用或禁用 TA 将通知结果码上报 TE。 AT+CSSN 补充业务通知 测试命令 AT+CSSN=? 响应 +CSSN: (支持的列表),(支持的列表) 查询命令 AT+CSSN? OK 响应 +CSSN: , 上海移远通信技术股份有限公司 210 / 273 RGx00U&RM500U 系列 AT 命令手册 设置命令 AT+CSSN=[,] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 - 参数 整型。启用/禁用 TA 上报中间结果码至 TE。当=1 且主叫建立后收到补充业务通知，将 在响应其他主叫建立结果码前响应+CSSI: 至 TE。 0 禁用 1 启用 整型。启用/禁用 TA 上报未经请求结果码至 TE。当=1 且被叫建立后、或在通话期间收 到补充业务通知、或收到转发检查补充业务通知时，将响应 URC +CSSU: 至 TE。 0 禁用 1 启用 整型。由厂商指定，支持的参数取值如下： 0 无条件呼叫转移处于激活状态 1 部分条件呼叫转移处于激活状态 2 呼叫已经转移 3 暂停呼叫转移 5 禁止呼出 整型。由厂商指定，支持的参数取值如下： 0 来电为转接电话 2 通话保持中（语音通话中） 3 通话已恢复（语音通话中） 5 保持中的通话被另一方挂断 10 转接另一来电 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 211 / 273 RGx00U&RM500U 系列 AT 命令手册 10.8. AT+CUSD 非结构化补充数据业务 该命令根据 3GPP TS 22.090，用于对非结构化补充数据业务（USSD）进行控制。支持网络与 TE 发 起操作。用于启用或禁用非请求结果码。=2 取消正在进行的 USSD 会话。针对网络端或 TE 发起操作的 USSD 响应，格式为+CUSD: [,,[]。 设置命令指定时，TE 发起的 USSD 字符串或网络响应的 USSD 字符串将发送给网络。网络 响应的 USSD 字符串在后续 URC +CUSD 中返回。 AT+CUSD 非结构化补充数据业务 测试命令 AT+CUSD=? 响应 +CUSD: (支持的范围) 查询命令 AT+CUSD? OK 响应 +CUSD: 设置命令 AT+CUSD=[[,[, ]]] 最大响应时间 OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 120 秒，取决于网络 特性说明 - 参考 3GPP TS 27.007 参数 整型。是否向 TE 上报结果码。 0 禁用结果码上报 1 启用结果码上报 2 取消会话（不适用于查询命令的返回结果） 字符串类型。发送至网络的 USSD。若参数省略，则无法访问网络。 字符串类型。从网络接收的 USSD。 整型。3GPP TS 23.038 小区广播数据编码方案。默认值：15。 整型。网络响应或发起的 USSD。 0 无需进一步用户操作（网络发起的 USSD 通知，或移动发起的操作后无需进一步的信 上海移远通信技术股份有限公司 212 / 273 RGx00U&RM500U 系列 AT 命令手册 息） 1 需要进一步用户操作（网络发起的 USSD 请求或移动发起操作后需要进一步信息） 2 网络终止 USSD 3 另一本地客户端已响应 4 不支持该操作 5 网络超时 错误码。详情请参考第 13.3 章。 10.9. AT+CGU 扩展会议电话 该命令用于控制扩展会议电话呼叫。 AT+CGU 扩展会议电话 设置命令 AT+CGU=,[,…] 最大响应时间 特性说明 响应 OK 若错误： +CMS ERROR: 300 毫秒 - 参数 整型。操作类型。 1 开始多方电话会议 2 连接网络会议中心 4 添加一个电话会议成员 字符串类型。电话号码；最多支持六方通话。仅当=1时支持一次设置多个 电话号码。格式：'tel:'。 错误码。详情请参考第13.4章。 备注 1. 可通过 AT+CHLD=3 创建三方通话后，再使用 AT+CGU 添加新会话。 2. 通过 AT+CGU 添加的电话号码，可通过 AT+CLCC 查询对应的，即为 AT+CHLD=7X 与 AT+CHLD=2X 中的 X。 上海移远通信技术股份有限公司 213 / 273 RGx00U&RM500U 系列 AT 命令手册 举例 AT+CGU=1,'tel:15021012496','tel:15399691447' //创建电话会议。 OK AT+CGU=4,'tel:15813636380' //添加新的会话到电话会议。 OK 上海移远通信技术股份有限公司 214 / 273 RGx00U&RM500U 系列 AT 命令手册 11 音频命令 11.1. AT+CMUT 控制静音 此命令用于在语音通话中开启/关闭上行语音静音。 AT+CMUT 控制静音 测试命令 AT+CMUT=? 响应 +CMUT: (支持的列表) 查询命令 AT+CMUT? OK 响应 +CMUT: 设置命令 AT+CMUT= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。开启/关闭上行语音静音。 0 关闭 1 开启 错误码。详情请参考第 13.3 章。 上海移远通信技术股份有限公司 215 / 273 RGx00U&RM500U 系列 AT 命令手册 11.2. AT+QAUDLOOP 启用/禁用音频循环测试 该命令用于启用/禁用音频循环测试。 AT+QAUDLOOP 启用/禁用音频循环测试 测试命令 AT+QAUDLOOP=? 响应 +QAUDLOOP: (支持的列表) 查询命令 AT+QAUDLOOP? OK 响应 +QAUDLOOP: 设置命令 AT+QAUDLOOP= OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或者禁用音频循环测试。 0 禁用 1 启用 举例 AT+QAUDLOOP=1 OK //启用音频循环测试。 上海移远通信技术股份有限公司 216 / 273 RGx00U&RM500U 系列 AT 命令手册 11.3. AT+VTS 生成 DTMF 音 该命令用于发送 ASCII 字符，使 MSC 将 DTMF 音发送到对端。该命令只能在语音呼叫中使用。 AT+VTS 生成 DTMF 音 测试命令 AT+VTS=? 响应 +VTS: (支 持 的列 表),(支 持 的范 围) OK 设置命令 响应 AT+VTS=[,] OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： ERROR 或者 +CME ERROR: 取决于和的长度 - 参数 字符串类型。ASCII 字符集 0~9、#、*、A、B、C、D。当一次发送多个 DTMF 音时 需要用引号，AT+VTD 可指定两个 DTMF 音的时间间隔。 整型。每个 DTMF 音的持续时间的公差。范围：0~255；单位：0.1 秒。 如果持续时间小于网络指定的最短时间，则实际持续时间为网络指定的时间。若省略 此参数，则 AT+VTD 指定该参数的值。当一次发送多个 DTMF 音时，不可使用此参 数。 错误码。详情请参考第 13.3 章。 举例 ATD12345678900; OK //通话已连接。 AT+VTS=1 OK AT+VTS=1,50 OK //拨号。 //对端能够听到 DTMF 音。 //对端能够听到 DTMF 音。 上海移远通信技术股份有限公司 217 / 273 AT+VTS='1,2,3,4,5,6,7,8,9,0,A' OK RGx00U&RM500U 系列 AT 命令手册 //一次发送多个 DTMF 音。 11.4. AT+VTD 设置 DTMF 音持续时间 该命令用于设置 DTMF 音的持续时间。 AT+VTD 设置 DTMF 音持续时间 测试命令 AT+VTD=? 响应 +VTD: (支持的范围) 查询命令 AT+VTD? OK 响应 +VTD: 设置命令 AT+VTD= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。DTMF 音的持续时长。范围：0~255；默认值：1；单位：0.1 秒。 错误码。详情请参考第 13.3 章。 举例 AT+VTD=10 OK //设置 DTMF 音持续时长为 1 秒。 上海移远通信技术股份有限公司 218 / 273 RGx00U&RM500U 系列 AT 命令手册 11.5. AT+QAUDMOD 设置音频模式 该命令用于设置连接设备所需的音频模式。 AT+QAUDMOD 设置音频模式 测试命令 AT+QAUDMOD=? 响应 +QAUDMOD: (支持的范围) 查询命令 AT+QAUDMOD? OK 响应 +QAUDMOD: 设置命令 AT+QAUDMOD= OK 响应 OK 最大响应时间 特性说明 参考 Quectel 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。音频模式。 0 手机的回声消除、噪声抑制、数字增益和校准参数 1 耳机的回声消除、噪声抑制、数字增益和校准参数 2 扬声器的回声消除、噪声抑制、数字增益和校准参数 错误码。详情请参考第 13.3 章。 举例 AT+QAUDMOD=2 OK //设置音频模式为扬声器回声消除、噪声抑制、数字增益和校准参数。 上海移远通信技术股份有限公司 219 / 273 RGx00U&RM500U 系列 AT 命令手册 11.6. AT+QMIC 设置麦克风的上行增益 该命令用于设置麦克风的上行增益。 AT+QMIC 设置麦克风的上行增益 测试命令 AT+QMIC=? 响应 +QMIC: (支持的范围),(支持的范围) 查询命令 AT+QMIC? OK 响应 +QMIC: , 设置命令 AT+QMIC=[,] OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。上行 Codec 增益。范围：0~7；单位：dB。不同音频模式下默认值可能不同。 整型。上行数字增益。范围：0~7；单位：dB。不同音频模式下默认值可能不同。 错误码。详情请参考第 13.3 章。 举例 AT+QMIC=1,2 OK //设置上行 Codec 增益为 1 dB，上行数字增益为 2 dB。 上海移远通信技术股份有限公司 220 / 273 RGx00U&RM500U 系列 AT 命令手册 11.7. AT+CLVL 设置扬声器的音量等级 该命令用于设置扬声器的音量等级。 AT+CLVL 设置扬声器的音量等级 测试命令 AT+CLVL=? 响应 +CLVL: (支持的范围) 查询命令 AT+CLVL? OK 响应 +CLVL: 设置命令 AT+CLVL= OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令在通话时设置才生效； 参数配置不保存。 参数 整型。扬声器的音量等级。范围：0~7；默认值：4。 错误码。详情请参考第 13.3 章。 举例 AT+CLVL=? +CLVL: (0-7) OK AT+CLVL? +CLVL: 4 OK AT+CLVL=7 OK //查询支持的音量等级。 //查询当前配置。 //设置扬声器的音量等级为 7。 上海移远通信技术股份有限公司 221 / 273 RGx00U&RM500U 系列 AT 命令手册 11.8. AT+QIIC 读写 IIC 该命令用于通过 IIC 接口配置 Codec。 AT+QIIC 读写 IIC 测试命令 AT+QIIC=? 响应 +QIIC: (支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表) 设置命令 AT+QIIC=,,,[,] OK 响应 若省略可选参数，则查询当前配置： +QIIC: OK 最大响应时间 特性说明 若指定可选参数，读写 IIC： OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。操作类型。 0 设置 1 查询 整型。十六进制格式。7 位设备地址。范围：0~0xFF。 整型。十六进制格式。寄存器地址。范围：0~0xFF。 整型。 1 读/写一个字节 2 读/写两个字节 整型。十六进制格式。读取或写入的数据。范围：0~0xFFFF。 举例 AT+QIIC=1,0x18,0x0c,1 +QIIC: 0x50 //读取寄存器位置的 1 字节寄存器内容：从机地址：0x18；寄存器地址： 12。 OK AT+QIIC=0,0x18,0x0c,1,0x5f //写入寄存器位置的 1 字节寄存器内容：从机地址：0x18；寄存器地址： 上海移远通信技术股份有限公司 222 / 273 RGx00U&RM500U 系列 AT 命令手册 12；写入值：0x5f。 OK 11.9. AT+QAUDRD 录制音频文件 该命令用于录制空闲状态下本地麦克风的音频并将其保存成文件。设置命令中，当为 0 时， 可选参数可省略。 AT+QAUDRD 录制音频文件 测试命令 AT+QAUDRD=? 响应 +QAUDRD: ( 支 持 的列 表 ),,( 支 持 的 列表),(支持的范围) 查询命令 AT+QAUDRD? OK 响应 +QAUDRD: 设置命令 AT+QAUDRD=[, [,[,]]] OK 响应 OK 录制完成时，上报 URC ： +QAUDRIND: 0 录制失败时，上报 URC： +QAUDRIND: 0, 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。开启/关闭本地音频的录制。 0 停止录音。 1 开始录音 上海移远通信技术股份有限公司 223 / 273 RGx00U&RM500U 系列 AT 命令手册 字符串类型。音频文件名称，包括文件名称和文件名后缀。默认路径为/data/UFS。 整型。文件格式。 13 WAV_PCM16 格式 整型。 0 上行链路录音 1 预留值 2 预留值 整型。本地音频文件录制状态。 0 未在录制本地音频文件 1 正在录制本地音频文件 整型。录制失败原因。 1 未知错误 3 录制空间不足 整型。错误码。 901 未知音频错误 902 音频参数无效 903 不支持该音频操作 904 音频设备繁忙 4 不支持该操作 备注 1. 模块仅支持录制WAV_PCM16格式且后缀为.wav的音频文件。音频文件为16 kHz采样率、单通道、 16位宽的.wav音频文件。 2. 模块支持录制上行链路音频，暂不支持录制下行链路录音。 举例 AT+QAUDRD=? +QAUDRD: (0,1),,(13),(0-2) OK AT+QAUDRD=1,'123.wav',13,0 OK AT+QAUDRD? +QAUDRD: 1 OK AT+QAUDRD=0 OK +QAUDRIND: 0 AT+QAUDRD? //测试命令 //录制上行链路音频并将其保存为 123.wav 文件 //查询当前录制状态 //停止录音 //录制完成 //查询当前录制状态 上海移远通信技术股份有限公司 224 / 273 +QAUDRD: 0 OK RGx00U&RM500U 系列 AT 命令手册 11.10. AT+QAUDPLAY 播放本地音频文件 该命令用于播放本地音频文件。 AT+QAUDPLAY 播放本地音频文件 测试命令 AT+QAUDPLAY=? 响应 +QAUDPLAY: ,(支持的列表) 查询命令 AT+QAUDPLAY? OK 响应 +QAUDPLAY: 设置命令 AT+QAUDPLAY=, OK 响应 OK 播放完成时，上报 URC： +QAUDPLAY: 0 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。音频文件播放次数。 0 只播放一次 1 重复播放 字符串类型。本地音频文件名称，包括文件名称和文件名后缀。默认文件路径为 /data/UFS。 整型。音频文件播放状态。 0 未在播放音频文件 上海移远通信技术股份有限公司 225 / 273 RGx00U&RM500U 系列 AT 命令手册 1 正在播放音频文件 整型。错误码。 901 未知音频错误 902 音频参数无效 903 不支持该音频操作 904 音频设备繁忙 4 不支持操作 备注 1. 模块仅支持播放采样率为16 kHz、单通道且位宽为16的.wav音频文件。 2. 若发生音频文件打开失败、设备打开失败、命令重复或者未知错误，将上报URC +QAUDPIND: 0,1。 举例 AT+QAUDPLAY=? //测试命令 +QAUDPLAY: ,(0,1) OK AT+QAUDPLAY='123.wav',0 OK //播放 1 次本地音频文件 123.wav。 +QAUDPLAY: 0 //播放完成 11.11. AT+QAUDSTOP 停止播放音频文件 该命令用于停止播放音频文件。 AT+QAUDSTOP 停止播放音频文件 测试命令 AT+QAUDSTOP=? 执行命令 AT+QAUDSTOP 响应 OK 响应 OK 最大响应时间 300 毫秒 特性说明 - 上海移远通信技术股份有限公司 226 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 若执行 AT+QAUDSTOP 时未在播放音频，则上报 URC +QAUDPIND: 0,1。 举例 AT+QAUDSTOP=? OK AT+QAUDPLAY='123.wav',0 OK AT+QAUDSTOP OK +QAUDPLAY:0 //测试命令 //播放 1 次本地音频文件 123.wav。 //停止播放音频文件。 11.12. AT+QTTS 播放文本 该命令用于播放文本。 AT+QTTS 播放文本 测试命令 AT+QTTS=? 响应 +QTTS: (支持的范围),,(支持的列 表) 查询命令 AT+QTTS? OK 响应 +QTTS: 设置命令 AT+QTTS=[,[,]] OK 响应 OK 如有任何错误： +CME ERROR: 最大响应时间 特性说明 文本播放完成时： +QTTS: 0 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 227 / 273 RGx00U&RM500U 系列 AT 命令手册 参数 整型。开始或停止语音播放文本，并定义文本输入格式。 0 停止语音播放，可省略 1 开始语音播放中文，为使用 UCS2 编码后的字符串 2 开始语音播放英文，为以[m20]开头的 ACSII 字符串 字符串类型。待播放文本。文本格式取决于。 整型。选择的播放方式。当省略时，表示默认使用 codec 播放文本音 频。 0 使用 codec 播放文本音频 1 使用 UAC 设备播放文本音频 2 使用语音播放文本音频（通话过程中使用） 整型。TTS 播放器状态。 0 空闲 1 繁忙 错误码。详情请参考第 13.3 章。 备注 1. 若要使用 TTS 功能，首先需要通过 AT+QCFG='tts',1 启用 TTS 功能，并且重启模块。 2. 配置英文播放文本时必须加上'[m20]'控制字。 3. 当播放外设为 UAC 时，在下发 AT+QTTS=1,'6b228fce4f7f752879fb8fdc6a215757',1 播放文本之 前或同时，主控端应监听声卡中的音频数据，及时从声卡中读取音频数据，否则 TTS 会阻塞，导致 后续执行 AT+QTTS 时命令不生效。 举例 AT+QTTS=? +QTTS: (0-2),,(0-2) //测试命令 OK AT+QTTS=1,'6b228fce4f7f752879fb8fdc6a215757' OK //使用 codec 播放 UCS2 字符串文本 +QTTS: 0 AT+QTTS=1,'6b228fce4f7f752879fb8fdc6a215757',0 OK //使用 codec 播放 UCS2 字符串文本 +QTTS: 0 AT+QTTS=1,'6b228fce4f7f752879fb8fdc6a215757',1 OK //使用 UAC 播放 UCS2 字符串文本 +QTTS: 0 AT+QTTS=2,'[m20]hello world' //使用 codec 播放 ASCII 字符串文本。 上海移远通信技术股份有限公司 228 / 273 OK +QTTS: 0 RGx00U&RM500U 系列 AT 命令手册 11.13. AT+QTTSETUP 设置播放速度或调节播放音量 该命令用于设置/查询播放速度或调节播放音量。 AT+QTTSETUP 设置播放速度或调节播放音量 测试命令 AT+QTTSETUP=? 响应 +QTTSETUP: (支持的列表),(支持的列表),(支持 的范围) 查询命令 AT+QTTSETUP? 设置命令 AT+QTTSETUP=,[,] OK 响应 OK 响应 若省略可选参数，则查询当前配置： +QTTSETUP: ,, OK 若指定可选参数，则设置播放速度或调节播放音量： OK 最大响应时间 特性说明 如有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。设置或查询参数值。 1 设置 2 查询 整型。 1 速度 2 音量 整型。速度或音量值。若=2，则设置命令中省略。 上海移远通信技术股份有限公司 229 / 273 RGx00U&RM500U 系列 AT 命令手册 速度 范围：-32768~32767；正常速度：0；默认值：0。 音量 范围：-32768~32767；默认值：0。音量设为最小值时为静音状态。 错误码。详情请参考第 13.3 章。 举例 AT+QTTSETUP=? +QTTSETUP: (1,2),(1,2),(-32768-32767) OK AT+QTTSETUP=1,2,32767 OK AT+QTTSETUP=1,1,0 OK AT+QTTSETUP=2,2 +QTTSETUP: 2,2,32767 OK AT+QTTSETUP=2,1 +QTTSETUP: 2,1,0 OK //测试命令 //设置音量为最大 //设置播放速度为 0 //查询当前播放音量 //查询当前播放速度 11.14. AT+QAUDCFG 查询和配置音频流程 AT+QAUDCFG 查询和配置音频流程 测试命令 AT+QAUDCFG=? 响应 +QAUDCFG: 'slic/LF_Ring',(支持的列表) +QAUDCFG: 'slic_IndRep',(支持的列表) 最大响应时间 OK 300 毫秒 举例 AT+QAUDCFG=? //测试命令 +QAUDCFG: 'slic/LF_Ring',(0,1) +QAUDCFG: 'slic_IndRep',(0,1) OK 上海移远通信技术股份有限公司 230 / 273 RGx00U&RM500U 系列 AT 命令手册 11.14.1. AT+QAUDCFG='slic/LF_Ring' 设置/查询 SLIC 芯片的线路状态寄存器 该命令用于设置/查询 SLIC 芯片的线路状态寄存器状态。 AT+QAUDCFG='slic/LF_Ring' 设置 SLIC 芯片的线路状态寄存器 设置命令 AT+QAUDCFG='slic/LF_Ring'[,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic/LF_Ring', OK 若指定可选参数，则设置 SLIC 芯片的线路状态寄存器： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 配置参数不保存。 参数 整型。SLIC 芯片的线路状态寄存器状态。 0 FORWARD ACTIVE 状态。该状态下使能摘挂机检测功能。挂机时，音频数据流被 禁用；摘机后，音频数据流自动使能。 1 RINGING 状态。该状态表示模拟话机检测到正负极电话线，当处于 RINGING 状态 时，会产生电话铃音，提示用户当前有电话接入。 备注 1. 使用该命令前必须先执行 AT+QSLIC=,[,]启用 SLIC。 2. 当前仅支持 FORWARD ACTIVE 和 RINGING 两种状态。模拟话机处于挂机状态且没有来电时，对 应 FORWARD ACTIVE 状态；模拟话机处于挂机且有来电时，对应 RINGING 状态。 3. 该命令仅在 SLIC 模拟话机工作时生效。 举例 AT+QAUDCFG='slic/LF_Ring',1 OK AT+QAUDCFG='slic/LF_Ring' +QAUDCFG: 'slic/LF_Ring',1 //设置 SLIC 芯片的线路状态寄存器为 RINGING 状态。 //查询 SLIC 芯片的线路状态寄存器状态。 上海移远通信技术股份有限公司 231 / 273 RGx00U&RM500U 系列 AT 命令手册 OK 11.14.2. AT+QAUDCFG='slic_IndRep' 启用/禁用 SLIC 模拟话机的事件上报功能 该命令用于启用/禁用 SLIC 模拟话机的事件上报功能。目前支持上报 DTMF、挂机、摘机和闪断四种 事件。上述事件通过 URC 上报至 AT 口。用户无需通过 Debug 口查看应用程序日志即可确认话机的操作 是否符合预期。 AT+QAUDCFG='slic_IndRep' 启用/禁用 SLIC 模拟话机的事件上报功能 设置命令 AT+QAUDCFG='slic_IndRep'[,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic_IndRep', OK 若指定可选参数，则启用或禁用 SLIC 模拟话机的事件上报功 能： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用 SLIC 模拟话机的事件上报功能。 0 禁用 1 启用 备注 1. 目前支持的 DTMF 事件包含 0~9、*、#。 2. 该命令仅在 SLIC 模拟话机工作时生效。 上海移远通信技术股份有限公司 232 / 273 举例 AT+QAUDCFG='slic_IndRep',1 OK AT+QAUDCFG? +QAUDCFG: 'slic_IndRep',1 OK +QIND: 'SLIC Hook off' +QIND: 'SLIC DTMF',1 +QIND: 'SLIC Flash Key' +QIND: 'SLIC Hook on' RGx00U&RM500U 系列 AT 命令手册 //启用 SLIC 模拟话机的事件上报 //查询当前配置 //拿起话柄，收到摘机的 URC 上报。 //按下数字键 1，收到 DTMF 1 的 URC 上报。 //按下闪断键，收到通话闪断的 URC 上报。 //放下话柄，收到挂机的 URC 上报。 上海移远通信技术股份有限公司 233 / 273 RGx00U&RM500U 系列 AT 命令手册 12 硬件相关命令 12.1. AT+QPOWD 关闭模块 该命令用于关闭模块，命令执行成功后将返回 OK。之后，UE 去激活网络并输出 POWERED DOWN 进入关机状态。去激活网络最大时长为 60 秒。为避免数据丢失，在输出 POWERED DOWN 之前不能断 开模块电源。 AT+QPOWD 关闭模块 测试命令 AT+QPOWD=? 响应 +QPOWD: (支持的列表) 设置命令 AT+QPOWD[=] OK 响应 OK 最大响应时间 特性说明 POWERED DOWN 300 毫秒 - 参数 整型。 0 立即关机 1 正常关机 举例 AT+QPOWD=1 OK POWERED DOWN //正常关机。 上海移远通信技术股份有限公司 234 / 273 RGx00U&RM500U 系列 AT 命令手册 12.2. AT+CCLK 实时时钟 该命令用于设置和查询模块实时时钟（RTC）。 AT+CCLK 实时时钟 测试命令 AT+CCLK=? 查询命令 AT+CCLK? 响应 OK 响应 +CCLK: 设置命令 AT+CCLK= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。格式：'yy/MM/dd,hh:mm:ss±zz'，分别表示年（最后两位）、月、日、小时、 分钟、秒和时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异；范围：-48 ~ +56）。 例如，1994 年 5 月 6 日 22:10:00 GMT + 2 小时等于'94/05/06,22:10:00+08'。 错误码。详情请参考第 13.3 章。 举例 AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //查询本地时间。 上海移远通信技术股份有限公司 235 / 273 RGx00U&RM500U 系列 AT 命令手册 12.3. AT+QADC 查询 ADC 值 该命令用于读取 ADC 通道的电压值。 AT+QADC 查询 ADC 值 测试命令 AT+QADC=? 响应 +QADC: (支持的列表) 查询命令 AT+QADC= OK 响应 +QADC: , 最大响应时间 特性说明 OK 300 毫秒 - 参数 整型。ADC 通道号。 0 ADC 通道 0 整型。ADC 值是否读取成功。 0 读取失败 1 读取成功 整型。ADC 通道的电压。单位：mV。 举例 AT+QADC=0 +QADC: 1,1791 //读取 ADC 通道 0 的电压值为 1791 mV。 OK 12.4. AT+QSLIC 启用/禁用 SLIC 该命令用于启用或禁用 SLIC。 上海移远通信技术股份有限公司 236 / 273 RGx00U&RM500U 系列 AT 命令手册 AT+QSLIC 启用/禁用 SLIC 测试命令 AT+QSLIC=? 响应 +QSLIC: ( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的范围) 查询命令 AT+QSLIC? OK 响应 +QSLIC: [,[,]] 设置命令 AT+QSLIC=,[,< DCDC_type>] OK 响应 OK 若有任何错误： ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用 SLIC。 0 禁用 1 启用 整型。SLIC 芯片型号。 0 无 1 预留值 2 SI32185 3 LE9643 4 LE9641 5 DXS101（与搭配使用) 6 DXS102（与搭配使用） 7 N681390 整 型 。DCDC 电 路 类 型 。 仅 在为 5 和 6 时 需 配 置 该 参 数 。 当 配置为 5 或 6 时，必须指定对应的 DCDC 电路类型，否则该 SLIC 芯片 大概率会被烧坏。 0 DCDC_TYPE_IBB12 1 DCDC_TYPE_CIBB12 2 DCDC_TYPE_IB12 3 DCDC_TYPE_CBB48 4 DCDC_TYPE_BB48 5 DCDC_TYPE_NONE 上海移远通信技术股份有限公司 237 / 273 RGx00U&RM500U 系列 AT 命令手册 6 DCDC_TYPE_IFB12 7 DCDC_TYPE_CIFB12 举例 AT+QSLIC=? +QSLIC: (0,1),(0-7),(0-7) OK AT+QSLIC=1,2 OK AT+QSLIC? +QSLIC: 1,2 OK AT+QSLIC=0,2 OK AT+QSLIC=1,5,0 OK AT+QSLIC? +QSLIC: 1,5,0 OK AT+QSLIC=0,5 OK //测试命令。 //启用 Si32185。 //查询当前配置。 //禁用 Si32185。 //启用 DCDC 电路类型为 IBB12 的 DXS101。 //查询当前配置。 //禁用 DXS101。 12.5. AT+QDOWNLOAD 进入下载模式 该命令用于配置模块进入下载模式。 AT+QDOWNLOAD 进入下载模式 测试命令 AT+QDOWNLOAD=? 响应 +QDOWNLOAD: (支持的列表) 查询命令 AT+QDOWNLOAD? OK 响应 +QDOWNLOAD: 执行命令 AT+QDOWNLOAD= OK 响应 OK 上海移远通信技术股份有限公司 238 / 273 最大响应时间 特性说明 300 毫秒 - 参数 整型。 0 非下载模式 1 下载模式 举例 AT+QDOWNLOAD=1 OK //配置模块进入下载模式。 RGx00U&RM500U 系列 AT 命令手册 12.6. AT+QPRTPARA 还原用户配置信息 该命令用于还原用户配置信息。 AT+QPRTPARA 还原用户配置信息 执行命令 响应 AT+QPRTPARA= OK 最大响应时间 300 毫秒 特性说明 该命令重启后生效。 参数 整型。 3 还原用户配置信息 4 获取支持的分区被还原的次数 举例 AT+QPRTPARA=3 OK //还原用户配置信息。 上海移远通信技术股份有限公司 239 / 273 RGx00U&RM500U 系列 AT 命令手册 12.7. AT+IPR 设置串口波特率 该命令用于设置串口波特率。 AT+IPR 设置串口波特率 测试命令 AT+IPR=? 查询命令 AT+IPR? 设置命令 AT+IPR= 最大响应时间 特性说明 响应 +IPR: (支持的列表) OK 响应 +IPR: OK 响应 OK 300 毫秒 该命令立即生效； 参数配置执行 AT&W 后保存。 参数 整型。串口波特率。单位：bps。 0 开启波特率自适应 4800 设置串口波特率为 4800 9600 设置串口波特率为 9600 19200 设置串口波特率为 19200 38400 设置串口波特率为 38400 57600 设置串口波特率为 57600 115200 设置串口波特率为 115200 230400 设置串口波特率为 230400 460800 设置串口波特率为 460800 921600 设置串口波特率为 921600 举例 AT+IPR=0 OK AT+IPR=115200 OK //开启波特率自适应。 //设置串口波特率为 115200。 上海移远通信技术股份有限公司 240 / 273 RGx00U&RM500U 系列 AT 命令手册 12.8. AT+QFUPL 上传文件到存储媒介 该命令用于上传文件到存储媒介，若上传的文件与存储媒介中的文件同名，则会上报错误。 AT+QFUPL 上传文件到存储媒介 测试命令 AT+QFUPL=? 响应 +QFUPL: ':',,(支 持 的 范围),(支持的列表) 设置命令 AT+QFUPL='[:]',,, OK 响应 CONNECT TA 切换为数据模式（即透传模式），此时请输入二进制文 件数据。当输入数据的总大小达到时，或达到 时间内无数据输入时，TA 将切换回命令模式： +QFUPL: OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。文件上传的目录。可选参数。当前支持上传文件至 update 目录（路径 为 mnt/data/update）和 UFS 目录下（路径为 data/UFS）。若省略该参数，则普通 文件默认上传至 data/UFS 路径下，update.zip 文件默认上传至 mnt/data/update 路径 下。 字符串类型。上传的文件名称。 整型。期望上传的文件大小。单位：字节。 整型。输入数据的等待时间。范围：1~65535；默认值：5；单位：秒。 整型。是否使用 ACK 模式。 0 关闭 ACK 模式 1 开启 ACK 模式 整型。实际上传的文件大小。单位：字节。 上海移远通信技术股份有限公司 241 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 1. 执行命令后，必须在返回 CONNECT 后输入数据。 2. 在硬件流控制不起作用时，ACK 模式可避免在上传大文件时数据丢失。ACK 模式的工作原理如 下： 1）执行 AT+QFUPL='[:]',,,1 启用 ACK 模式。 2）模块输出 CONNECT。 3）MCU 发送 1 KB 字节数据，模块响应 A。 4）MCU 接收 A，然后发送下一个 1 KB 字节数据。 5）重复第 3）和 4）步骤，直到传输完成。 举例 AT+QFUPL='update.zip',26844205,5,0 CONNECT +QFUPL: 26844205 //非 ACK 模式下上传 26844205 字节的升级包文件 update.zip 至模块 mnt/data/update 路径下。 OK AT+QFUPL='update:update.zip',26844205,5,0 CONNECT +QFUPL: 26844205 //非 ACK 模式下上传 26844205 字节的升级包文件 update.zip 至模块 mnt/data/update 路径下。 OK AT+QFUPL='quectel.xml',516213,10,0 CONNECT +QFUPL: 516213 //非 ACK 模式下上传 516213 字节的 quectel.xml 文 件至模块 data/UFS 路径下。 OK AT+QFUPL='UFS:quectel.xml',516213,10,0 CONNECT +QFUPL: 516213 //非 ACK 模式下上传 516213 字节的 quectel.xml 文 件至模块 data/UFS 路径下。 OK AT+QFUPL='update.zip',26844205,5,1 //ACK 模式下上传 26844205 字节的升级包文件 update.zip 至模块 mnt/data/update 路径下。 上海移远通信技术股份有限公司 242 / 273 CONNECT A A A ... +QFUPL: 26844205 OK RGx00U&RM500U 系列 AT 命令手册 12.9. AT+QFDEL 删除存储媒介中的文件 该命令用于删除存储媒介中的文件。 AT+QFDEL 删除存储媒介中的文件 测试命令 AT+QFDEL=? 响应 +QFDEL: ':' 设置命令 AT+QFDEL='[:]' OK 响应 OK 最大响应时间 特性说明 如有任何问题： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字 符 串 类型 。 删 除文 件的 目 录 。可 选 参 数。 当前 支 持从 update 目 录（ 路 径 为 mnt/data/update）和 UFS 目录（路径为 data/UFS）下删除文件。若省略该参数，则 默认删除 data/UFS 路径下的同名普通文件，以及 mnt/data/update 路径下的同名 update.zip 文件。若在相应路径下未找到需删除的相应文件，则会报错。 字符串类型。删除的文件名称。 上海移远通信技术股份有限公司 243 / 273 RGx00U&RM500U 系列 AT 命令手册 备注 若需删除对应路径下的所有文件，可将配置为*，即 AT+QFDEL=':*'；也可省略 ，即 AT+QFDEL='*'，默认删除 data/UFS 路径下的所有文件。 举例 AT+QFDEL='update:update.zip' OK AT+QFDEL='update.zip' OK AT+QFDEL='UFS:update.zip' OK AT+QFDEL='UFS:*' OK AT+QFDEL='*' OK AT+QFDEL='quectel.xml' OK //删除升级包文件 mnt/data/update/update.zip。 //删除升级包文件 mnt/data/update/update.zip。 //删除升级包文件 data/UFS/update.zip。 //删除 data/UFS 路径下的所有文件。 //删除 data/UFS 路径下的所有文件。 //删除 data/UFS/quectel.xml 文件。 上海移远通信技术股份有限公司 244 / 273 RGx00U&RM500U 系列 AT 命令手册 13 附录 13.1. 参考文档 表 3：参考文档 文档名称 [1] Quectel_RG200U 系列_5G_模块产品规格书 [2] Quectel_RG500U 系列_5G_模块产品规格书 [3] Quectel_RM500U 系列_5G_模块产品规格书 13.2. 术语缩写 表 4：术语缩写 缩写 3GPP 5GC 5QI ACK AMR APN AGNSS A-GPS 英文全称 3rd Generation Partnership Project 5G Core Network 5G QoS Identifier Acknowledgement Adaptive Multi-Rate Access Point Name Assisted Global Navigation Satellite System Assisted Global Positioning Systems 上海移远通信技术股份有限公司 中文全称 第三代合作伙伴计划 5G 核心网络 5G QoS 标识符 确认消息 自适应多速率 接入点名称 辅助全球导航卫星系统 辅助全球定位系统 245 / 273 RGx00U&RM500U 系列 AT 命令手册 ADC AMBR AMF APN ARFCN ASCII BER BS BCD CBM CCBS CFU CHAP CLI CLIP CLIR CPU CSD CS DCD DCE DFOTA DHCP DL DMZ Analog To Digital Converter Aggregated Maximum Bit Rate Access and Mobility Management Function Access Point Name Absolute Radio-Frequency Channel Number American Standard Code for Information Interchange Bit Error Rate Base Station Binary-Coded Decimal Cell Broadcast Message Completion of Calls to Busy Subscriber Call Forwarding Unconditional Challenge-Handshake Authentication Protocol Calling Line Identity Calling Line Identification Presentation Calling Line Identification Restriction Central Processing Unit Circuit Switch Data Circuit Switched Dynamic Content Delivery Data Communication Equipment Delta Firmware Upgrade Over-The-Air Dynamic Host Configuration Protocol Downlink Demilitarized Zone 模数转换器 聚合最大比特速率 接入及移动性管理功能 接入点名称 绝对射频信道号 美国信息交换标准码 比特出错率 基站 二进制编码的十进数 小区广播消息 遇忙用户呼叫完成补充业务 无条件呼叫转移 挑战握手认证协议 呼叫线路身份 呼叫线路识别显示 呼叫线路识别限制 中央处理器 电路切换数据 电路切换 动态内容交付 数据通讯设备 固件空中差分升级 动态主机配置协议 下行 非军事化区，也称为隔离区 上海移远通信技术股份有限公司 246 / 273 RGx00U&RM500U 系列 AT 命令手册 DNS DPCH DTE DTMF DTR DRB EARFCN ECC ECM ECT EPS EN-DC E-RAB E-UTRAN eMBB eMLPP FDD F-DPCH FTP GBR GERAN GFBR GGSN GID GMM Domain Name Server 域名系统（服务）协议 Dedicated Physical Channel 专用物理信道 Data Terminal Equipment 数据终端设备 Dual-Tone Multifrequency 双音多频 Data Terminal Ready 数据终端就绪 Data Radio Bearer 数据无线承载 E-UTRA Absolute Radio Frequency Channel Number E-UTRA 绝对射频信道号 Emergency Communications Center 紧急通讯中心 Ethernet Networking Control Model 以太网控制模型 Explicit Call Transfer 显式呼叫转移 Evolved Packet System 演进的分组系统 E-UTRA NR Dual Connectivity E-UTRA NR 双重连接 E-UTRAN Radio Access Bearer E-UTRAN 无线接入承载 Evolved Universal Terrestrial Radio Access Network 演进型通用陆地无线接入网 Enhanced mobile broadband 增强移动宽带 Enhanced Multi-Level Precedence and Pre-emption 增强型多优先级和抢占业务 Service Frequency Division Duplex 频分双工 Fractional Dedicated Physical Channel 部分专用物理信道 File Transfer Protocol 文件传输协议 Guaranteed Bit Rate 保证比特速率 GSM EDGE Radio Access Network GSM EDGE 无线接入网络 Guaranteed Flow Bit Rate 保证流比特率 Gateway GPRS Support Node 网关 GPRS 支持节点 Group Identifier 组标识符 GPRS Mobility Management GPRS 移动管理 上海移远通信技术股份有限公司 247 / 273 GMT GPIO GPRS GPS GSM HCS HPLMN HSDPA HSPA+ HSUPA HTTP HTTPS ICCID ID IDSN IIC IMEI IMS IMSI IP IPv4 IPv6 IRA LTE MBIM Greenwich Mean Time General-Purpose Input/Output General Packet Radio Service Global Positioning System Global System for Mobile communications Hierarchical Cell Structure Home Public Land Mobile Network High Speed Downlink Packet Access High Speed Packet Access High Speed Uplink Packet Access Hypertext Transfer Protocol Hypertext Transfer Protocol Secure Integrated Circuit Card Identifier Identifier Integrated Services Digital Network Inter-Integrated Circuit International Mobile Equipment Identity IP Multimedia Subsystem Internation Mobile Subscriber Identity Internet Protocol Internet Protocol version 4 Internet Protocol version 6 International Reference Alphabet Long-Term Evolution Mobile Broadband Interface Model RGx00U&RM500U 系列 AT 命令手册 格林威治时间 通用型输入/输出 通用分组无线业务 全球定位系统 全球移动通信系统 层次蜂窝结构 归属 PLMN 高速下行分组接入 增强高速分组接入 高速上行分组接入 超文本传输协议 超文本传输安全协议 集成电路卡识别码 标识符 综合服务数字网络 集成电路总线 国际移动设备识别码 IP 多媒体子系统 国际移动用户识别码 网际互连协议 第 4 版互联网协议 第 6 版互联网协议 7-bit 国际参考字母编码字符集 长期演进 移动宽带接口模型 上海移远通信技术股份有限公司 248 / 273 RGx00U&RM500U 系列 AT 命令手册 MCU ME MFBR mmWave mMTC MS MSC MSISDN MT MO NAS NCM NITZ NMEA NRPPa NR NSSAI NSA NVRAM PAP PCIe PCIe EP PCIe RC PCM PDN Microprogrammed Control Unit 微程序控制器 Mobile Equipment 移动设备 Maximum Flow Bit Rate 最大流比特率 Millimeter Wave 毫米波 Massive connections 大规模连接 Mobile Station 移动站 Mobile Switching Center 移动交换中心 Mobile Subscriber International Integrated Service 移动台国际用户识别码 Digital Network number Mobile Terminal 移动终端 Mobile Originating / Originated 主叫 Non-Access Stratum 非接入层 Network Control Model 网络控制模型 Network Identity and Time Zone 网络标识和时区 (National Marine Electronics Association) 0183 （ 美 国 国 家 海 洋 电 子 协 会 ） Interface Standard 0183 接口标准 NR Positioning Protocol Annex NR 定位协议附件 New Radio 新无线 Network Slice Selection Assistance Information 网络切片选择协助信息 Non Standalone 非独立组网 Non-Volatile Random Access Memory 非易失性随机存取存储器 Password Authentication Protocol 口令验证协议 Peripheral Component Interconnect Express 快捷外围部件互连标准 PCI Express Endpoint Device PCIe 端点 PCI Express Root Complex PCIe 根复合体 Pulse Code Modulation 脉冲编码调制 Public Data Network 公共数据网 上海移远通信技术股份有限公司 249 / 273 RGx00U&RM500U 系列 AT 命令手册 PDP PDU PDCP PIN PLMN PPP PS PSC PUK QoS RAN RAT RLP RNDIS RP RTC RTS/CTS RRC RF TPDU SA SAR SD SGSN SINR Packet Data Protocol Protocol Data Unit Packet Data Convergence Protocol Personal Identification Number Public Land Mobile Network Point-to-Point Protocol Packet Switch Primary Synchronization Code PIN Unlocking Key Quality of Service Radio Access Network Radio Access Technology Radio Link Protocol Remote Network Driver Interface Specification Relay Protocol Real-Time Clock Request To Send/Clear To Send Radio Resource Control Radio Frequency Transfer Protocol Data Unit Standalone Specific Absorption Rate Slice Differentiator Serving GPRS Support Node Signal to Interference plus Noise Ratio 分组数据协议 协议数据单元 分组数据汇聚协议 个人识别号 公共陆地移动网络 点对点协议 分组交换 主同步码 PIN 码解锁码 服务质量 无线接入网 无线接入技术 无线链路协议 远程网络驱动接口规范 中继协议 实时时钟 请求发送/清除发送 无线资源控制 射频 传输协议数据单元 独立组网 比吸收率 切片微分器 服务 GPRS 支持节点 信号与干扰加噪声比 上海移远通信技术股份有限公司 250 / 273 RGx00U&RM500U 系列 AT 命令手册 SLIC SMS SMSC SNDCP S-NSSAI SSC SST TA TCP TDD TE UART UCS2 UDP UDUB UE UL UMTS UICC URC URL URLLC USB (U)SIM USSD Subscriber Line Interface Circuit 用户线接口电路 Short Messaging Service 短消息服务 Short Message Service Center 短消息服务中心 SubNetwork Dependent Convergence Protocol 子网相关汇聚协议 Single Network Slice Selection Assistance Information 网络分片 Session and Service Continuity 会话和服务连续性 Slice/Service Type 切片/服务类型 Terminal Adapter 终端适配器 Transmission Control Protocol 传输控制协议 Time Division Duplex 时分双工 Terminal Equipment 终端设备 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Universal Character Set (UCS-2) Format 通用字符集格式 User Datagram Protocol 用户数据报协议 User Determined User Busy 用户决定的用户忙 User Equipment 用户设备 Uplink 上行 Universal Mobile Telecommunications System 通用移动通信系统 Universal Integrated Circuit Card 通用集成电路卡 Unsolicited Result Code 未经请求的结果码 Uniform Resource Locator 统一资源定位符 Low Latency and High Reliability 低延迟和高可靠性 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module （通用）用户身份识别模块 Unstructured Supplementary Service Data 非结构化补充数据业务 上海移远通信技术股份有限公司 251 / 273 UTRAN WCDMA Universal Terrestrial Radio Access Network Wideband Code Division Multiple Access RGx00U&RM500U 系列 AT 命令手册 通用陆地无线接入网 宽带码分多址 13.3. CME ERROR 错误码汇总 最终结果码+CME ERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果码， 同一命令行中未执行任一命令，则不会返回 ERROR 或 OK 结果码。 值常用于普通消息命令。下表列举了部分通用或 GPRS 相关 ERROR 码，此表不包含 GSM 规范 中描述的 GSM 协议错误相关错误码。 表 5：+CME ERROR: 错误码描述 错误码 0 1 2 3 4 5 6 7 10 11 12 13 14 15 英文含义 Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy SIM wrong 中文含义 拨打电话失败 电话未连接 保留电话适配器连接 操作不允许 操作不支持 需要 PH SIM 卡 PIN 码 需要 PH FSIM 卡 PIN 码 需要 PH FSIM 卡 PUK 码 未插入(U)SIM 卡 需要(U)SIM 卡 PIN 码 需要(U)SIM 卡 PUK 码 (U)SIM 卡读取失败 (U)SIM 卡忙 (U)SIM 卡错误 上海移远通信技术股份有限公司 252 / 273 RGx00U&RM500U 系列 AT 命令手册 16 Incorrect password 密码不正确 17 SIM PIN2 required 需要(U)SIM 卡 PIN2 码 18 SIM PUK2 required 需要(U)SIM 卡 PUK2 码 20 Memory full 内存已满 21 Invalid index 无效索引 22 Not found 未发现 23 Memory failure 内存不足 24 Text string too long 文本字符过长 25 Invalid characters in text string 无效文本字符 26 Dial string too long 拨号字符过长 27 Invalid characters in dial string 无效拨号字符 30 No network service 无网络服务 31 Network timeout 网络超时 32 Network not allowed - emergency calls only 网络不允许-仅支持紧急通话 40 Network personalization PIN required 需要网络个性化 PIN 41 Network personalization PUK required 需要网络个性化 PUK 42 Network subset personalization PIN required 需要网络子集个性化 PIN 43 Network subset personalization PUK required 需要网络子集个性化 PUK 44 Service provider personalization PIN required 需要网络服务商个性化 PIN 45 Service provider personalization PUK required 需要网络服务商个性化 PUK 46 Corporate personalization PIN required 需要企业个性化 PIN 47 Corporate personalization PUK required 需要企业个性化 PUK 上海移远通信技术股份有限公司 253 / 273 RGx00U&RM500U 系列 AT 命令手册 13.4. CMS ERROR 错误码汇总 最终结果码+CMSERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果码， 同一命令行中未执行任一命令，则不会返回 ERROR 或 OK 结果码。值常用于普通消息命令。 表 6：+CMS ERROR: 错误码描述 错误码 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 英文含义 ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode SIM not inserted (U)SIM pin necessary PH (U)SIM pin necessary (U)SIM failure (U)SIM busy (U)SIM wrong (U)SIM PUK required (U)SIM PIN2 required (U)SIM PUK2 required Memory failure Invalid memory index Memory full SMSC address unknown 中文含义 ME 失败 保留 SMS ME 操作不允许 操作不支持 无效 PDU 模式 无效文本模式 未插入(U)SIM 卡 需要(U)SIM 卡 PIN 码 需要 PH (U)SIM 卡 PIN 码 (U)SIM 卡失败 (U)SIM 卡忙 (U)SIM 卡错误 需要(U)SIM PUK 需要(U)SIM PIN2 需要(U)SIM PUK2 内存不足 无效内存索引 内存已满 未知 SMSC 地址 上海移远通信技术股份有限公司 254 / 273 331 No network 332 Network timeout 500 Unknown 512 (U)SIM not ready 513 Message length exceeds 514 Invalid request parameters 515 ME storage failure 517 Invalid service mode 528 More message to send state error 529 MO SMS is not allowed 531 ME storage full 13.5. AT&F 影响到的 AT 命令及参数 表 7：AT&F 影响到的 AT 命令及参数 AT 命令 ATE ATS0 ATS3 ATS4 ATS5 ATS7 ATV AT+CREG AT+CGREG 参数名称 上海移远通信技术股份有限公司 RGx00U&RM500U 系列 AT 命令手册 无网络 网络超时 未知原因 (U)SIM 卡未就绪 消息长度超出范围 请求的参数无效 ME 内存失败 无效服务模式 消息发送状态错误 不允许主动发送 SMS ME 内存满 默认值 1 0 13 10 8 0 1 0 0 255 / 273 AT+CMEE AT+CSCS AT+CSTA AT+CRC AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+CLIP AT+COLP AT+CLIR AT+CSSN AT+CTZR AT+CPBS AT+CGEREP AT+CEREG AT+CCWA AT+CUSD AT+CLVL AT+QAUDMOD AT+QAUDLOOP ,,, ,,, ,, ,, ,,,, , RGx00U&RM500U 系列 AT 命令手册 1 'GSM' 129 0 0,1,1,1 0 17,167,0,0 0 0,'','' 'ME','ME','ME' 2,1,0,0,0 0 0 0 0 0,0 0 'SM' 0,0 0 0 0 3 0 0 上海移远通信技术股份有限公司 256 / 273 13.6. AT&W 影响到的 AT 命令及参数 表 8：AT&W 影响到的 AT 命令及参数 AT 命令 ATE AT+CREG AT+CGREG AT+CEREG AT+IPR 参数名称 13.7. ATZ 影响到的 AT 命令及参数 表 9：ATZ 影响到的 AT 命令及参数 AT 命令 ATE ATS0 ATS7 ATV AT+CREG AT+CGREG AT+CEREG 参数名称 RGx00U&RM500U 系列 AT 命令手册 默认值 1 0 0 1 0 0 0 上海移远通信技术股份有限公司 257 / 273 13.8. URC 汇总 RGx00U&RM500U 系列 AT 命令手册 表 10：URC 汇总 序号 URC 含义 条件 1 +CREG: 指示 MT 注册状态 AT+CREG=1 邻区更改后，指示当前网络是否已 2 +CREG: [,,[,]] 使用位置区号指示了 MT 的注册状态 AT+CREG=2 3 +CGREG: 指示 MT 网络注册状态 AT+CGREG=1 4 +CGREG: [,,[,],[]] 5 +CTZV: 时区上报 AT+CTZR=1 6 +CTZE: ,, 扩展时区上报 AT+CTZR=2 7 +CTZEU: ,, 扩展时区上报 AT+CTZR=3 8 +CMTI: , 收到新的短消息并保存至内存 See AT+CNMI +CMT: [], 收到新的短消息并直接输出到 TE 9 （PDU 模式） See AT+CNMI +CMT: ,[],[,,,,,,, （文本模式） See AT+CNMI ] 11 +CBM: 收到新 CBM 并直接输出（ PDU 模 式） See AT+CNMI +CBM: ,,,,< 收到新 CBM 并直接输出（文本模 12 pages> 式） See AT+CNMI 13 +CDS: 收到新 CDS 并直接输出（ PDU 模 式） See AT+CNMI +CDS: ,,[],[],,, 式） See AT+CNMI 15 +CDSI: , 收到新的消息状态报告，并保存到 内存 See AT+CNMI 16 +COLP: ,,[],[],[] 17 +CLIP: ,,[subaddr], 被叫指示 [satype],[], AT+CLIP=1 18 +CRING: 通过非请求结果码而非正常 RING 向 TE 指示来电 AT+CRC=1 上海移远通信技术股份有限公司 258 / 273 RGx00U&RM500U 系列 AT 命令手册 +CCWA: ,,[, 19 ][,[,, 呼叫等待指示 AT+CCWA=1,1 [,]]] 20 +CSSI: 向 TE 指示+CSSI 中间结果码显示 状态 AT+CSSN=1 21 +CSSU: 向 TE 指示+CSSU 非请求结果码显 示状态 AT+CSSN=,1 22 +CFUN: MT 的所有功能均可用 N/A 23 +CPIN: (U)SIM 卡引脚状态 N/A 24 RING 来电指示 AT+QINDCFG='ri ng',1 25 +QIND: 'csq',, 信号强度和信道误码率发生变化 AT+QINDCFG='c sq',1 26 +QIND: 'smsfull', 短消息存储已满 AT+QINDCFG='s msfull',1 27 +QIND: 'act', 网络访问技术发生变化 AT+QINDCFG='a ct',1 +QREJINFO: ,,,,,,[,] 29 +QIND: SMS DONE SMS 初始化完成 N/A 30 +QIND: PB DONE 电话簿初始化完成 N/A 31 +CGEV: REJECT , 32 +CGEV: NW REACT ,< 向网络请求 PDP 重新激活 PDP_addr>,[] AT+CGEREP=2,1 33 +CGEV: NW DEACT ,< 网络强制去激活上下文 PDP_addr>,[] AT+CGEREP=2,1 34 +CGEV: ME DEACT ,< ME 强制去激活上下文 PDP_addr>,[] AT+CGEREP=2,1 35 +CGEV: NW DETACH 网络强制去附着分组域 AT+CGEREP=2,1 36 +CGEV: ME DETACH ME 强制去附着分组域 AT+CGEREP=2,1 37 +CGEV: NW CLASS 网络强制更改 MS 类别 AT+CGEREP=2,1 38 +CGEV: ME CLASS ME 强制更改 MS 类别 AT+CGEREP=2,1 39 POWERED DOWN 模块掉电 AT+QPOWD 上海移远通信技术股份有限公司 259 / 273 RGx00U&RM500U 系列 AT 命令手册 针对网络端或移动发起操作的 40 +CUSD: [,,[] USSD 响应 N/A 41 +QSIMSTAT: , AT+QSIMSTAT=1 42 +C5GREG: 5GS 中 MT 网络注册状态变化 AT+C5GREG=1 +C5GREG: [,[],[],[],[],[]] 44 ^DSCI: ,,,,,, AT^DSCI=1 +CGREG: [,,[,],[]] GERAN/UTRAN 中的网络小区的变 化 AT+CGREG=2 46 +CEREG: E-UTRAN 中 MT 的 EPS 网络注册状 态的变化 AT+CEREG=1 +CEREG: [,,[,]] E-UTRAN 中的网络小区的变化 48 +QNETDEVSTATUS: ,, 网卡拨号连接状态 , AT+CEREG=2 N/A 49 +QUIMSLOT: SIM 卡状态 N/A 50 +QAUDPLAY: Audio 播放状态 AT+QAUDPLAY= , 13.9. SMS 字符集转换 3GPP TS 23.038 DCS（数据编码方案）中定义了三种 SMS 字母：GSM 7 bit 默认字母，8 bit 数据和 UCS2（16 bit） 。AT+CSMP 用 于 文 本 模 式 （AT+CMGF=1） 下 设 置 DCS。 文 本 模 式 下 ，DCS 和 AT+CSCS 决定 SMS 文本输入和输出的方式。 表 11：SMS 文本输入和输出方式 DCS GSM 7-bit GSM 7-bit GSM 7-bit AT+CSCS GSM IRA UCS2 SMS 文本输入和输出方式 输入或输出 GSM 字符集 输入或输出 IRA 字符集。 输入：UE 将 IRA 字符转换为 GSM 字符。 输出：UE 将 GSM 字符转换为 IRA 字符。 输入或输出类似于 PDU 模式的十六进制字符串。 因此，仅支持字符 0– 9 和 A–F。 上海移远通信技术股份有限公司 260 / 273 RGx00U&RM500U 系列 AT 命令手册 UCS2 - 8-bit - 输入：UE 将 UCS2 十六进制字符串转换为 GSM 字符。 输出：UE 将 GSM 字符转换为 UCS2 十六进制字符串。 忽略 AT+CSCS 值，输入或输出类似于 PDU 模式的十六进制字符串。 仅支持字符 0–9 和 A–F。 忽略 AT+CSCS 值，输入或输出类似于 PDU 模式的十六进制字符串。 仅支持字符 0–9 和 A–F。 当 DCS 等于 GSM 7 bit 时，需要进行输入或输出转换，详情参考下表。 表 12：输入转换表（DCS 等于 GSM 7 bit 且 AT+CSCS='GSM'） 序号 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0A Submit 2A 3A 4A 5A 6A 7A B 0B Cancel 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F 上海移远通信技术股份有限公司 261 / 273 RGx00U&RM500U 系列 AT 命令手册 表 13：输出转换表（DCS 等于 GSM 7 bit 且 AT+CSCS='GSM'） 序号 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B 0B 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F 表 14：GSM 扩展字符 序号 0 1 2 3 4 5 6 7 0 1B40 1 2 3 上海移远通信技术股份有限公司 262 / 273 RGx00U&RM500U 系列 AT 命令手册 4 1B14 5 6 7 8 1B28 9 1B29 A B C 1B3C D 1B3D E 1B3E F 1B2F 表 15：输入转换表（DCS 等于 GSM 7 bit 且 AT+CSCS='IRA'） 序号 0 1 2 3 4 5 6 7 0 20 20 30 00 50 20 70 1 20 20 21 31 41 51 61 71 2 20 20 22 32 42 52 62 72 3 20 20 23 33 43 53 63 73 4 20 20 02 34 44 54 64 74 5 20 20 25 35 45 55 65 75 6 20 20 26 36 46 56 66 76 7 20 20 27 37 47 57 67 77 8 backspace 20 28 38 48 58 68 78 9 20 20 29 39 49 59 69 79 上海移远通信技术股份有限公司 263 / 273 A 0A B 20 C 20 D 0D E 20 F 20 RGx00U&RM500U 系列 AT 命令手册 Submit 2A 3A 4A 5A 6A 7A Cancel 2B 3B 4B 1B3C 6B 1B28 20 2C 3C 4C 1B2F 6C 1B40 20 2D 3D 4D 1B3E 6D 1B29 20 2E 3E 4E 1B14 6E 1B3D 20 2F 3F 4F 11 6F 20 表 16：IRA 扩展字符 No. A B C D E F 0 20 20 20 20 7F 20 1 40 20 20 5D 20 7D 2 20 20 20 20 20 08 3 01 20 20 20 20 20 4 24 20 5B 20 7B 20 5 03 20 0E 20 0F 20 6 20 20 1C 5C 1D 7C 7 5F 20 09 20 20 20 8 20 20 20 0B 04 0C 9 20 20 1F 20 05 06 A 20 20 20 20 20 20 B 20 20 20 20 20 20 C 20 20 20 5E 07 7E D 20 20 20 20 20 20 E 20 20 20 20 20 20 F 20 60 20 1E 20 20 上海移远通信技术股份有限公司 264 / 273 RGx00U&RM500U 系列 AT 命令手册 表 17：输出转换表（DCS 等于 GSM 7 bit 且 AT+CSCS='IRA'） 序号 0 1 2 3 4 5 6 7 0 40 20 20 30 A1 50 BF 70 1 A3 5F 21 31 41 51 61 71 2 24 20 22 32 42 52 62 72 3 A5 20 23 33 43 53 63 73 4 E8 20 A4 34 44 54 64 74 5 E9 20 25 35 45 55 65 75 6 F9 20 26 36 46 56 66 76 7 EC 20 27 37 47 57 67 77 8 F2 20 28 38 48 58 68 78 9 C7 20 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B D8 2B 3B 4B C4 6B E4 C F8 C6 2C 3C 4C D6 6C F6 D 0D E6 2D 3D 4D D1 6D F1 E C5 DF 2E 3E 4E DC 6E FC F E5 C9 2F 3F 4F A7 6F E0 表 18：GSM 扩展字符(ISO-8859-1/Unicode) No. 0 1 2 3 4 5 6 7 0 7C 1 2 3 上海移远通信技术股份有限公司 265 / 273 RGx00U&RM500U 系列 AT 命令手册 4 5E 5 6 7 8 7B 9 7D A B C 5B D 7E E 5D F 5C 由于 UCS2 字符的低 8 位与 IRA 字符相同，所以： ⚫ DCS 等于 GSM 7 bit 且 AT+CSCS='UCS2'转换表与 AT+CSCS='IRA'相似。 ⚫ fmt 等于 GSM 7 bit 且 AT+CSCS='GSM'转换表与 AT+CSCS='GSM'相似。 ⚫ fmt 等于 GSM 7 bit 且 AT+CSCS='IRA'转换表与 AT+CSCS='IRA'相似。 ⚫ fmt 等于 GSM 7 bit 且 AT+CSCS='UCS2'转换表与 AT+CSCS='IRA'相似。 SMS 文本输入或输出的方式差异详情，参考表 11。 13.10. AT+CEER 扩展错误报告 表 19：AT+CEER 扩展错误报告 CS Internal Cause No cause information available (default) Phone is offline CS 内部原因 无可用原因信息（默认） 手机离线 上海移远通信技术股份有限公司 266 / 273 No service available Network release, no reason given Received incoming call Client ended call UIM not present Access attempt already in progress Access failure, unknown source Concur service not supported by network No response received from network GPS call ended for user call SMS call ended for user call Data call ended for emergency call Rejected during redirect or handoff Lower-layer ended call Call origination request failed Client rejected incoming call Client rejected setup indication Network ended call No funds available No service available Full service not available Maximum packet calls exceeded Video connection lost Video protocol closed after setup Video protocol setup failure RGx00U&RM500U 系列 AT 命令手册 无可用服务 网络下发，无原因 收到来电 客户端挂断电话 未显示 UIM 正在尝试访问 访问失败，来源未知 网络不支持并发服务 没有收到网络回应 GPS 通话已结束，无法进行用户通话 短消息通话已结束，无法进行用户通话 紧急通话结束 在重定向或切换期间被拒绝 下层结束通话 呼叫发起请求失败 客户端拒绝来电 客户端拒绝设置指示 网络结束通话 无可用资金 无可用服务 全部服务不可用 超过最大分组呼叫 视频连线中断 设置后视频协议关闭 视频协议设置失败 上海移远通信技术股份有限公司 267 / 273 Internal error CS Network Cause Unassigned/unallocated number No route to destination Channel unacceptable Operator determined barring Normal call clearing User busy No user responding User alerting, no answer Call rejected Number changed Non selected user clearing Destination out of order Invalid/incomplete number Facility rejected Response to status enquiry Normal, unspecified No circuit/channel available Network out of order Temporary failure Switching equipment congestion Access information discarded Requested circuit/channel not available Resources unavailable, unspecified RGx00U&RM500U 系列 AT 命令手册 内部错误 CS 网络原因 未分配的号码 无法到达目的地 不接受该通道 运营商限制 清除正常通话 用户忙碌 无用户响应 用户响铃，但无人接听 通话被拒 号码已更改 清除未选择的用户 无序目的地 号码无效/不完整 设施被拒绝 状态查询响应 正常，未指定 无可用电路/通道 网络故障 临时故障 交换设备拥塞 访问信息被丢弃 请求的电路/通道不可用 资源不可用，未指定 上海移远通信技术股份有限公司 268 / 273 Quality of service unavailable Requested facility not subscribed Incoming calls barred within the CUG Bearer capability not authorized Bearer capability not available Service/option not available Bearer service not implemented ACM >= ACM max Requested facility not implemented Only RDI bearer is available Service/option not implemented Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Recovery on timer expiry Protocol error, unspecified Interworking, unspecified RGx00U&RM500U 系列 AT 命令手册 服务质量不可用 请求的设施未订阅 CUG 中禁止来电 承载能力未经授权 承载能力不可用 服务/选项不可用 承载服务未实现 ACM 大于或等于最大 ACM 请求的设施未实现 仅 RDI 承载可用 服务/选项未实现 无效交易识别码值 用户不是 CUG 成员 不兼容的目的地 无效中转网络选择 消息语义不正确 无效强制性信息 消息不存在/未实现 消息类型与状态不兼容 IE 不存在/未实现 有条件的 IE 错误 消息与状态不兼容 计时器到期后恢复 协议错误，未指定 互通，未指定 上海移远通信技术股份有限公司 269 / 273 RGx00U&RM500U 系列 AT 命令手册 CS Network Reject IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME GPRS services not allowed GPRS and non GPRS services not allowed MS identity cannot be derived Implicitly detached PLMN not allowed Location area not allowed Roaming not allowed GPRS services not allowed in PLMN No suitable cells in location area MSC temporary not reachable Network failure MAC failure Synch failure Congestion GSM authentication unacceptable Service option not supported Requested service option not subscribed Service option temporary out of order Call cannot be identified CS 网络拒绝 HLR 中未知 IMSI 非法 MS VLR 中未知 IMSI 不接受 IMEI 非法 ME 不允许使用 GPRS 服务 不允许使用 GPRS 和非 GPRS 服务 无法识别 MS 身份 隐性去附着 不允许的 PLMN 位置区域不允许 不允许漫游 PLMN 中不允许 GPRS 服务 位置区域内没有合适的小区 MSC 暂时无法到达 网络故障 MAC 失败 同步失败 拥塞 不接受 GSM 身份验证 服务选项不支持 请求的服务选项未订阅 服务选项暂时失灵 无法识别通话 上海移远通信技术股份有限公司 270 / 273 No PDP context activated Semantically incorrect message Invalid mandatory information Message type non-existent Message type not compatible with state Information element non-existent Message not compatible with state RR release indication RR random access failure RRC release indication RRC close session indication RRC open session failure Low level failure Low level failure no redial allowed Invalid SIM No service Timer T3230 expired No cell available Wrong state Access class blocked Abort message received Other cause Timer T303 expired No resources Release pending RGx00U&RM500U 系列 AT 命令手册 没有激活 PDP 上下文 消息语义不正确 无效的强制性信息 消息类型不存在 消息类型与状态不兼容 消息元素不存在 消息与状态不兼容 RR 释放指示 RR 随机访问失败 RRC 释放指示 RRC 关闭会话指示 RRC 打开会话失败 低水平故障 低水平故障，不允许重拨 SIM 卡无效 无服务 定时器 T3230 过期 无可用小区 状态错误 访问类别已封锁 中止接收消息 其他原因 定时器 T303 过期 无资源 待发布 上海移远通信技术股份有限公司 271 / 273 Invalid user data PS Internal Cause Invalid connection identifier Invalid NSAPI Invalid primary NSAPI PDP establish timeout Invalid field SNDCP failure RAB setup failure No GPRS context PDP activate timeout PDP modify timeout PDP inactive max timeout PDP lower layer error PDP duplicate Access technology change PDP unknown reason CS PS Network Cause LLC or SNDCP failure Insufficient resources Missing or unknown APN Unknown PDP address or PDP type User authentication failed Activation rejected by GGSN Activation rejected, unspecified 上海移远通信技术股份有限公司 RGx00U&RM500U 系列 AT 命令手册 无效的用户数据 PS 内部原因 无效的连接标识符 无效的 NSAPI 无效的主 NSAPI PDP 建立超时 无效字段 SNDCP 失败 RAB 设置失败 没有 GPRS 上下文 PDP 激活超时 PDP 修改超时 PDP 未激活最大超时时间 PDP 下层错误 PDP 重复 接入技术变更 PDP 未知原因 CS PS 网络原因 LLC 或 SNDCP 故障 资源不足 缺少 APN 或 APN 未知 未知的 PDP 地址或 PDP 类型 用户身份验证失败 GGSN 拒绝激活 激活被拒绝，未指定 272 / 273 RGx00U&RM500U 系列 AT 命令手册 Service option not supported Requested service option not subscribed Service option temporary out of order NSAPI already used (not sent) Regular deactivation QoS not accepted Network failure Reactivation required Feature not supported Semantic error in the TFT operation Syntactical error in the TFT operation Unknown PDP context PDP context without TFT already activated Semantic errors in packet filter Syntactical errors in packet filter Invalid transaction identifier Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Protocol error, unspecified 不支持服务选项 请求的服务选项未订阅 服务选项暂时失灵 NSAPI 已使用（未发送） 定期去激活 不接受 QoS 网络故障 需要重新激活 不支持该功能 TFT 操作语义错误 TFT 操作语法错误 未知 PDP 上下文 没有激活 TFT 的 PDP 上下文 数据包过滤器语义错误 数据包过滤器语法错误 无效的交易识别码 消息语义上不正确 无效的强制性信息 消息不存在/未实现 消息类型与状态不兼容 IE 不存在/未实现 有条件的 IE 错误 消息与状态不兼容 协议错误，未指定 上海移远通信技术股份有限公司 273 / 273

EC2x&EG2x&EG9x&EM05 Series QCFG AT Commands Manual LTE Standard Module Series Version: 1.1 Date: 2023-06-27 Status: Released LTE Standard Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 1 / 136 LTE Standard Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 2 / 136 LTE Standard Module Series About the Document Revision History Version 1.0 1.1 Date 2021-04-15 2022-05-30 2023-06-27 Author Wythe WANG/ Alessa TANG/ Colin CUI Wythe WANG/ Alessa TANG/ Colin CUI Clauz LU/ Colin CUI Description Creation of the document First official release 1. Added the applicable modules: EG21-GL and EG25-GL. 2. Updated the response to AT+QCFG=? (Chapter 2.1). 3. Added the example for AT+QCFG='band' (Chapter 5.4). EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 3 / 136 LTE Standard Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 8 1 Introduction ......................................................................................................................................... 9 1.1. Applicable Modules .................................................................................................................... 9 1.2. Definitions ................................................................................................................................ 10 1.3. AT Command Syntax ............................................................................................................... 10 1.4. AT Command Responses........................................................................................................ 11 1.5. Declaration of AT Command Examples .................................................................................. 11 2 Test Command .................................................................................................................................. 12 2.1. AT+QCFG Extended Configuration Settings ........................................................................ 12 3 General Commands .......................................................................................................................... 17 3.1. AT+QCFG='apready' Set AP_Ready Behavior ................................................................... 17 3.2. AT+QCFG='sleepind/level' Configure the Output Level of the SLEEP_IND Pin................. 18 3.3. AT+QCFG='wakeupin/level' Configure Whether to Wake up the Module Through WAKEUP_IN Pin................................................................................................................................. 19 3.4. AT+QCFG='urc/ri/ring' Set RI Behavior When RING URC is Presented ............................ 20 3.5. AT+QCFG='urc/ri/smsincoming' Set RI Behavior When Incoming SMS URCs are Presented .................................................................................................................................................. 22 3.6. AT+QCFG='urc/ri/other' Set RI Behavior When Other URCs are Presented...................... 23 3.7. AT+QCFG='risignaltype' RI Signal Output Carrier .............................................................. 24 3.8. AT+QCFG='urc/delay' Delay URC Indication Output .......................................................... 25 3.9. AT+QCFG='urc/cache' Enable/Disable URC Cache ........................................................... 26 3.10. AT+QCFG='urc/poweron' Set Output URC of Power-on..................................................... 27 3.11. AT+QCFG='divctl' Configure Primary and Rx-diversity under LTE/WCDMA...................... 29 3.12. AT+QCFG='bootup' Enable/Disable Services in Linux........................................................ 30 3.13. AT+QCFG='ppp/sleep_ri' Enable/Disable Waking up the Module through the RI Pin Indication after PPP Establishment .................................................................................................... 31 3.14. AT+QCFG='thermal/txpwrlmt' Configure Temperature Protection Strategy ....................... 32 3.15. AT+QCFG='thermal/modem' Configure Thermal Threshold ............................................... 33 3.16. AT+QCFG='urc/ri/pin' Configure UART Pins Corresponding to RI ..................................... 34 3.17. AT+QCFG='icf' Configure Main UART................................................................................. 34 3.18. AT+QCFG='thermal/limit_rates' Enable/Disable the Rate Limit .......................................... 36 3.19. AT+QCFG='urcdelay' Configure URC Delay ....................................................................... 37 3.20. AT+QCFG='sarcfg' Set SAR Transmission Power for LTE/WCDMA/GSM ........................ 38 3.21. AT+QCFG='fast/poweroff' Enable/Disable Fast Power-Off ................................................. 41 3.22. AT+QCFG='sleep/datactrl' Configure Data Cache Mode .................................................... 42 3.23. AT+QCFG='rf/tuner_cfg' Set the Mapping between RF Tuner and RF Bands ................... 43 3.24. AT+QCFG='mms_rec_control' Save/Discard the MMS....................................................... 45 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 4 / 136 LTE Standard Module Series 4 Audio Commands ............................................................................................................................. 46 4.1. AT+QCFG='tone/incoming' Enable Ring Tone .................................................................... 46 4.2. AT+QCFG='pcmclk' Configure PCM_CLK .......................................................................... 47 4.3. AT+QCFG='codec/powsave' Set PSM for ALC5616 Codec ............................................... 48 5 Network Commands ......................................................................................................................... 50 5.1. AT+QCFG='gprsattach' Configure GPRS Attach Mode ...................................................... 50 5.2. AT+QCFG='nwscanmode' Configure Network Search Mode ............................................. 51 5.3. AT+QCFG='servicedomain' Configure Service Domain ...................................................... 52 5.4. AT+QCFG='band' Configure Band ...................................................................................... 53 5.5. AT+QCFG='rrc' Configure RRC Release Version ............................................................... 55 5.6. AT+QCFG='msc' Configure MSC Release Version ............................................................ 56 5.7. AT+QCFG='sgsn' Configure UE SGSN Release Version ................................................... 57 5.8. AT+QCFG='hsdpacat' Configure HSDPA Category ............................................................ 57 5.9. AT+QCFG='hsupacat' Configure HSUPA Category ............................................................ 58 5.10. AT+QCFG='PDP/duplicatechk' Establish Multi-PDN with Same APN ................................ 59 5.11. AT+QCFG='disable_backoff_lte' Disable Backoff LTE........................................................ 60 5.12. AT+QCFG='airplanecontrol' Enter/Exit Airplane Mode via W_DISABLE# Pin.................... 61 5.13. AT+QCFG='epcflag' Set EPC Capability Value in Attach Request ..................................... 63 5.14. AT+QCFG='lte/bandprior' Set Searching Priority of LTE Band ........................................... 63 5.15. AT+QCFG='plmn/addinfbdn' Add Current PLMN to FPLMN............................................... 65 5.16. AT+QCFG='cops_no_mode_change' Enable/Disable the Switch under AT+COPS=1 ...... 66 5.17. AT+QCFG='hplmn/search_timer' Configure HPLMN Search Interval................................. 66 5.18. AT+QCFG='tdd/config' Get the LTE-TDD Configuration ..................................................... 67 5.19. AT+QCFG='urc_cause_support' Report Rejection Cause .................................................. 68 5.20. AT+QCFG='dhcppktfltr' Filter DHCP Package .................................................................... 68 5.21. AT+QCFG='oostimer' Set Mode for OOS Network Searching ............................................ 69 5.22. AT+QCFG='apn/blocked' Configure APN Block Mode........................................................ 70 5.23. AT+QCFG='redir/3gtolte' Configure Redirection Mode ....................................................... 71 5.24. AT+QCFG='rssi' Configure Delta Threshold of RSSI Change ............................................ 72 5.25. AT+QCFG='roamservice' Configure Roaming Service ....................................................... 73 5.26. AT+QCFG='fast_dormancy' Dynamically Control the RRC Connection ............................. 74 5.27. AT+QCFG='airplane' Configure Airplane Mode................................................................... 75 5.28. AT+QCFG='rrc/control' Configure the Feature of RRC Connection Control ....................... 76 5.29. AT+QCFG='nwscanmodeex' Configure Network Searching Mode..................................... 77 5.30. AT+QCFG='assign_plmn_in_limit_search' Specify Operator for Camping on a Cell with Limited Service ................................................................................................................................... 78 5.31. AT+QCFG='iprulectl' Configure the Gateway Address Generation Rule ............................ 79 5.32. AT+QCFG='disrplmn' Configure RPLMN and RPLMNACT for Network Searching ........... 80 5.33. AT+QCFG='lte/preferfre' Set Preferred Frequency ............................................................. 81 5.34. AT+QCFG='cops_control' Enable/Disable Configurations of AT+COPS ............................ 82 5.35. AT+QCFG='map_rej_cause7_to_cause14' Enable/Disable Network Rejection Cause Mapping .............................................................................................................................................. 83 5.36. AT+QCFG='netmaskset' Enable/Disable Customized Netmask ......................................... 84 5.37. AT+QCFG='pingdiscard' Configure Whether to Discard Ping Packet................................. 85 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 5 / 136 LTE Standard Module Series 5.38. AT+QCFG='urc/ri/restart' Configure RI Pulse Timer ........................................................... 86 5.39. AT+QCFG='ping/ri' Configure Ping Detection Function ...................................................... 87 5.40. AT+QCFG='defaultdns' Configure Default DNS for PDP Context....................................... 88 5.41. AT+QCFG='lpm/dataind' Configure Wake-up Mechanism .................................................. 90 5.42. AT+QCFG='roamserviceex' Control Relevant Functions in Roaming State ....................... 91 6 PS Commands................................................................................................................................... 93 6.1. AT+QCFG='ntp' Specify the Maximum Re-transmission Counts and the Interval for NTP 93 6.2. AT+QCFG='TCP/SendMode' Configure TCP Sending Mode ............................................. 94 6.3. AT+QCFG='tcp/windowsize' Configure TCP Window Available Size ................................. 95 7 CS Commands................................................................................................................................... 96 7.1. AT+QCFG='amrcodec' Configure AMR Codec ................................................................... 96 7.2. AT+QCFG='frhrcodec' Configure GSM EFR/HR/FR Codec................................................ 97 7.3. AT+QCFG='bip/auth' Configure PDP Authentication Type in BIP Process ........................ 98 7.4. AT+QCFG='SMS/ListMsgMap' List Message Map.............................................................. 99 7.5. AT+QCFG='ims/ut' Enable/Disable IMS/UT Function ....................................................... 100 7.6. AT+QCFG='ims' Configure IMS Function .......................................................................... 102 7.7. AT+QCFG='ltesms/format' Set SMS Format in LTE Mode ............................................... 103 7.8. AT+QCFG='volte_disable' Enable/Disable VoLTE ............................................................ 104 7.9. AT+QCFG='sms/omadm' Set OMADM Message Parsing Mode ...................................... 105 7.10. AT+QCFG='imsreg/iptype' Configure the IP Type for IMS Registration ........................... 106 7.11. AT+QCFG='sim/recovery' Configure (U)SIM Card Hot-plug ............................................. 107 7.12. AT+QCFG='siminvalirecovery' Enable/Disable Re-attach Request .................................. 108 7.13. AT+QCFG='roaming/voicecall' Enable/Disable Voice Call in Roaming Mode .................. 109 7.14. AT+QCFG='voice_busytone' Control Busy Tone Playback .............................................. 110 7.15. AT+QCFG=''call_control'' Enable/Disable Module Voice Call Feature............................... 111 8 PPP Command ................................................................................................................................ 113 8.1. AT+QCFG='ppp/termframe' Enable/Disable the PPP TERM Frame Sending ............... 113 9 USB Commands .............................................................................................................................. 115 9.1. AT+QCFG='usbnet' Configure the Network Card Type Interface ..................................... 115 9.2. AT+QCFG='usbcfg' Configure VID, PID and Porting Settings .......................................... 116 9.3. AT+QCFG='usbee' Control the USB Device Loading ....................................................... 117 9.4. AT+QCFG='usbmode' Get USB Mode .............................................................................. 118 9.5. AT+QCFG='spi/set' Configure SPI or UART Driver........................................................... 119 9.6. AT+QCFG='usbenum/seoctl' Enable Optimization of USB Enumeration Failure ............. 120 10 CDMA Commands........................................................................................................................... 122 10.1. AT+QCFG='cdma/pppauth' Enable/Disable PPP Authentication Optimization under CDMA122 10.2. AT+QCFG='ehrpd' Configure CDMA Mode ....................................................................... 123 10.3. AT+QCFG='cdmasms/cmtformat' Set CMT Format of CDMA SMS PDU......................... 124 11 SMS Commands.............................................................................................................................. 126 11.1. AT+QCFG='urcport/sms' Set URC Output Port of Short Message...................................... 126 11.2. AT+QCFG=''sms_retry'' Configure SMS Retry Period and Interval.................................... 127 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 6 / 136 LTE Standard Module Series 11.3. AT+QCFG='sms_control' Enable/Disable Delivering or Submitting SMS ......................... 129 12 Appendix A References.................................................................................................................. 131 13 Appendix B Summary of ...................................................................................................... 134 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 7 / 136 LTE Standard Module Series Table Index Table 1: Applicable Modules ........................................................................................................................ 9 Table 2: Types of AT Commands .............................................................................................................. 10 Table 3: Related Document ..................................................................................................................... 131 Table 4: Terms and Abbreviations ........................................................................................................... 131 Table 5: Different Coding Schemes of +CME ERROR: ................................................................. 134 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 8 / 136 LTE Standard Module Series 1 Introduction This document introduces Quectel QCFG commands applicable for EC2x family, EG2x family, EG9x family and EM05 series modules to query and configure UE settings. 1.1. Applicable Modules Table 1: Applicable Modules Module Family EC2x EG9x EG2x - Module EC20-CE EC21 series EC25 series EG91 series EG95 series EG21-G EG25-G EG21-GL EG25-GL EM05 series NOTE The actual support of the specific AT+QCFG is subject to the result of executing AT+QCFG=? by using the corresponding firmware version. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 9 / 136 LTE Standard Module Series 1.2. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 1.3. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. AT+QCFG implemented by EC2x family, EG2x family, EG9x family and EM05 series modules is in 'Extended' syntax, as illustrated below. ⚫ Extended Extended commands can be executed in several types, as shown in the following table: Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 10 / 136 LTE Standard Module Series Multiple commands can be placed on a single line using a semi-colon (;) between commands. In such cases, only the first command should have AT prefix. Commands can be in upper or lower case. Spaces should be ignored when you enter AT commands, except in the following cases: ⚫ Within quoted strings, where spaces are preserved; ⚫ Within an unquoted string or numeric parameter; ⚫ Within an IP address; ⚫ Within the AT command name up to and including a =, ? or =?. 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, ERROR will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. 1.4. 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 information responses are sent before the final OK, ERROR or +CME ERROR: . Responses will be in the format of: +CMD1: OK 1.5. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 11 / 136 LTE Standard Module Series 2 Test Command 2.1. AT+QCFG Extended Configuration Settings AT+QCFG Extended Configuration Settings Test Command AT+QCFG=? Response … +QCFG: 'apready',(list of supported s),(list of supported s),(range of supported s) +QCFG: 'sleepind/level',(list of supported s) +QCFG: 'wakeupin/level',(list of supported s),(lis t of supported s) +QCFG: 'urc/ri/ring',(list of supported s),(range of supported s),(range of supported s), (range of supported s),(list of supported s),(range of supported s) +QCFG: 'urc/ri/smsincoming',(list of supported s),(list of supported s),(range of supported s) +QCFG: 'urc/ri/other',(list of supported s),(range of supported s),(range of supported s) +QCFG: 'risignaltype',(list of supported s) +QCFG: 'urc/delay',(list of supported s) +QCFG: 'urc/cache',(list of supported s) +QCFG: 'urc/poweron',(list of supported s) +QCFG: 'divctl',(list of supported s),(range of supported s) +QCFG: 'bootup',,(list of supported s) +QCFG: 'ppp/sleep_ri',(list of supported s),(range of supported s) +QCFG: 'thermal/txpwrlmt'[,,,,,,] EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 12 / 136 LTE Standard Module Series +QCFG: 'thermal/modem'[,,,] +QCFG: 'urc/ri/pin',(list of supported s) +QCFG: 'icf',(range of supported s),(range of supported s),(range of supported s) +QCFG: 'thermal/limit_rates'[,] +QCFG: 'urcdelay',(list of supported s),(range of supported s) +QCFG: 'sarcfg',(list of supported s),max_powe r,row_grads,column_grads +QCFG: 'fast/poweroff',(list of supported s) +QCFG: 'sleep/datactrl',(range of supported s),(range of supported s),(list of supported s) +QCFG: 'rf/tuner_cfg',,,[,] +QCFG: 'mms_rec_control',(list of supported s) +QCFG: 'tone/incoming',(range of supported s) +QCFG: 'pcmclk',(list of supported s) +QCFG: 'codec/powsave',(list of supported s) +QCFG: 'gprsattach',(list of supported s) +QCFG: 'nwscanmode',(range of supported s),(list of supported s) +QCFG: 'servicedomain',(list of supported s),(list of supported s) +QCFG: 'band',(range of supported s),(range of supported s),(range of supported s),(list of supported s) +QCFG: 'rrc',(range of supported s) +QCFG: 'msc',(range of supported s) +QCFG: 'sgsn',(range of supported s) +QCFG: 'hsdpacat',(list of supported s) +QCFG: 'hsupacat',(list of supported s) +QCFG: 'pdp/duplicatechk',(list of supported s) +QCFG: 'disable_backoff_lte',(list of supported s) +QCFG: 'airplanecontrol',(range of supported s) +QCFG: 'epcflag',(list of supported s) +QCFG: 'lte/bandprior',(range of supported s),(range of supported s),(range of supported s) +QCFG: 'plmn/addinfbdn',(list of supported s) +QCFG: 'cops_no_mode_change',(list of supported s) +QCFG: 'hplmn/search_timer',(range of supported s) +QCFG: 'tdd/config',(range of supported s),(range of supported s) +QCFG: 'urc_cause_support',(range of supported s) +QCFG: 'dhcppktfltr',(list of supported s) +QCFG: 'oostimer',,, +QCFG: 'apn/blocked',(list of supported s),(list of supported s) +QCFG: 'redir/3gtolte',(list of supported s),(list of supported s),list of supported s) +QCFG: 'rssi',(range of supported s) +QCFG: 'roamservice',(list of supported s),(list of supported s) +QCFG: 'fast_dormancy',(range of supported s),(range of supported s) +QCFG: 'airplane',(range of supported s) +QCFG: 'rrc/control',(list of supported s),(range of supported s),(range of supported s),(range of supported s),(list of supported s),(range of supported s) +QCFG: 'nwscanmodeex',(range of supported s) +QCFG: 'assign_plmn_in_limit_search',(list of supported s), +QCFG: 'iprulectl',(list of supported s) +QCFG: 'disrplmn',(list of supported s),(list of supported s) +QCFG: 'lte/preferfre',op,index,band,bandwith,earfcn,m cc,mnc +QCFG: 'cops_control',(list of supported s) +QCFG: 'map_rej_cause7_to_cause14',(list of supported s) +QCFG: 'netmaskset',(list of supported s)[,] +QCFG: 'pingdiscard',(list of supported s) +QCFG: 'urc/ri/restart',(list of supported s) +QCFG: 'ping/ri',(list of supported s),(list of supported s) +QCFG: 'defaultdns'[, list of supported s)[,[,]]] EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 14 / 136 LTE Standard Module Series +QCFG: 'lpm/dataind',(list of supported s), (ran ge of supported s) +QCFG: 'roamserviceex',(range of supported s) +QCFG: 'ntp',(range of supported s),(range of supported s) +QCFG: 'TCP/SendMode',(range of supported s) +QCFG: 'tcp/windowsize',(list of supported s),(range of supported s) +QCFG: 'amrcodec',(range of supported s) +QCFG: 'frhrcodec',(range of supported s) +QCFG: 'bip/auth',(range of supported s) +QCFG: 'SMS/ListMsgMap',(list of supported s) +QCFG: 'ims/ut',(list of supported s) +QCFG: 'ims',(range of supported s) +QCFG: 'ltesms/format',(list of supported s) +QCFG: 'volte_disable',(list of supported s) +QCFG: 'sms/omadm',(list of supported s) +QCFG: 'imsreg/iptype',(list of supported s) +QCFG: 'sim/recovery',(range of supported s),(list of supported s),(list of supported s) +QCFG: 'siminvalirecovery',(list of supported s),(range of supported s),(range of supported s) +QCFG: 'roaming/voicecall',(list of supported s) +QCFG: 'voice_busytone',(list of supported s) +QCFG: 'call_control',(list of supported s), (list of supported s) +QCFG: 'ppp/termframe',(list of supported s) +QCFG: 'usbnet',(range of supported s) +QCFG: 'usbcfg',,,,, ,,, +QCFG: 'usbee', +QCFG: 'usbmode',(list of supported s) +QCFG: 'spi/set',(range of supported s) +QCFG: 'usbenum/seoctl',(list of supported s) +QCFG: 'cdma/pppauth',(list of supported s) +QCFG: 'ehrpd',(list of supported s) +QCFG: 'cdmasms/cmtformat'[,(list of supported s)] +QCFG: 'urcport/sms',(list of supported s) +QCFG: 'sms_retry',(range of supported EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 15 / 136 Maximum Response Time Characteristics LTE Standard Module Series s),(range of supported s) +QCFG: 'sms_control',(list of supported s),(list of supporteds) … OK 300 ms / NOTE The above only shows an example for the command response. The response of the command varies according to the module used. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 16 / 136 LTE Standard Module Series 3 General Commands 3.1. AT+QCFG='apready' Set AP_Ready Behavior The command queries and configures the behavior of AP_READY pin. An external MCU can change the AP_READY pin level as needed. When there is a URC to be reported, if the AP_READY pin level is invalid, the URC is buffered first, and the AP_READY pin level will be detected periodically with the configured detection period. The URC will be output when the AP_READY pin level becomes valid. The pulse signal generated on the MAIN_RI pin can still be output according to the configured mode, and the pulse signal will not be buffered. AT+QCFG='apready' Set AP_Ready Behavior Write Command AT+QCFG='apready'[,, [,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'apready',,, OK Maximum Response Time Characteristics If the optional parameters are specified, set the AP_Ready behavior: OK Or ERROR 300 ms This command takes effect immediately. The configurations are not saved. Parameter Integer type. Enable/disable AP_Ready behavior. 0 Disable 1 Enable Integer type. Valid level of Indicator pin. This parameter only takes effect when the EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 17 / 136 LTE Standard Module Series AP_READY detection function is enabled, and determines the default level of AP_READY. 0 Low level 1 High level Integer type. Detection period. Unit: ms. Range:100–3000. Default value: 500. This parameter only takes effect when AP_READY detection function is enabled. When AP_READY level is invalid and a URC is reported, this parameter is used as detection interval to check whether the indicator pin level is valid. NOTE 1. Maximally 15 URCs can be buffered. When the number of URC exceeds 15, the oldest one in the buffer will be cleared to store the new URC. 2. The RING URC is buffered only once for each call process. Example AT+QCFG='apready',1,0,800 OK AT+QCFG='apready' +QCFG: 'apready',1,0,800 OK 3.2. AT+QCFG='sleepind/level' Configure the Output Level of the SLEEP_IND Pin This command configures the output level of the SLEEP_IND pin when the module is in sleep mode. AT+QCFG ='sleepind/level' Configure the Output Level of the SLEEP_IND Pin Write Command AT+QCFG='sleepind/level'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'sleepind/level', OK If the optional parameter is specified, set the output level of the SLEEP_IND pin: OK Or ERROR EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 18 / 136 LTE Standard Module Series Maximum Response Time Characteristics 300 ms This command takes effect immediately. The configuration is saved automatically. Parameter Integer type. It indicates the output level after the module enters sleep mode. 0 When the module enters sleep mode, SLEEP_IND pin outputs high level 1 When the module enters sleep mode, SLEEP_IND pin outputs low level Example AT+QCFG='sleepind/level',0 OK AT+QCFG='sleepind/level' +QCFG: 'sleepind/level',0 //SLEEP_IND pin outputs high level. //Query the current setting. OK 3.3. AT+QCFG='wakeupin/level' Configure Whether to Wake up the Module Through WAKEUP_IN Pin This command configures whether to wake up the module through WAKEUP_IN pin. AT+QCFG ='wakeupin/level' Configure Whether to Wake up the Module Through WAKEUP_IN Pin Write Command Response AT+QCFG='wakeupin/level'[, If the optional parameters are omitted, query the current [,]] setting: +QCFG: 'wakeupin/level',, OK Maximum Response Time If the optional parameters are specified, configure whether to wake up the module through WAKEUP_IN pin: OK Or ERROR 300 ms EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 19 / 136 LTE Standard Module Series Characteristics This command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Set WAKEUP_IN pin to low or high level to wake up the module. 0 Set WAKEUP_IN pin to low level 1 Set WAKEUP_IN pin to high level Integer type. Enable or disable whether to wake up the module through WAKEUP_IN pin. 0 Disable 1 Enable Example AT+QCFG='wakeupin/level',0 OK AT+QCFG='wakeupin/level' +QCFG: 'wakeupin/level',0,0 //Set WAKEUP_IN pin to low level to wake up the module. //Query the current setting. OK 3.4. AT+QCFG='urc/ri/ring' Set RI Behavior When RING URC is Presented AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming'(Chapter 3.5) and AT+QCFG='urc/ri/other' (Chapter 3.6) control the RI (ring indicator) behavior when a URC is reported. These configurations will be stored into NV automatically. The ring indicator is active low. AT+QCFG='urc/ri/ring' specifies the RI behavior when URC RING is presented to indicate an incoming call. The sum of and determines the interval time of RING indications when a call is coming. AT+QCFG='urc/ri/ring' Set RI Behavior When RING URC is Presented Write Command AT+QCFG='urc/ri/ring'[,[,[,[,[, [,]]]]]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'urc/ri/ring',,,,,,< EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 20 / 136 LTE Standard Module Series Maximum Response Time Characteristics pulse_count> OK If the optional parameters are specified, set the RI behavior when RING URC is presented: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms This command takes effect immediately. The configurations are saved automatically. Parameter String type. RI behavior when URCs are presented. 'off' No change. Ring indicator keeps inactive 'pulse' Pulse. Pulse width is determined by 'always' Change to active. RI behavior can be restored to inactive by AT+QRIR. See document [1] for details about the command 'auto' When 'RING' is presented to indicate an incoming call, the ring indicator changes to and keeps active. When ring of the incoming call ends, either answering or hanging up the incoming call, the ring indicator will change to inactive 'wave' When RING is presented to indicate an incoming call. The ring indicator outputs a square wave. Both and are used to set parameters of the square wave. When the ring of incoming call ends, either answering or hanging up the incoming call, the ring indicator will change to inactive Integer type. Set the pulse width. Range: 1–2000. Default value: 120. Unit: ms. This parameter is only valid when is 'pulse'. If this parameter is not needed, it can be set as null. Integer type. The active duration of the square wave. Range: 1–10000. Default value: 1000. Unit: ms. This parameter is only valid when is 'wave'. Integer type. Set the inactive duration of the square wave. Range: 1–10000. Default value: 5000. Unit: ms. This parameter is only valid when is 'wave'. String type. Set whether the ring indicator behavior could be disturbed. This EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 21 / 136 LTE Standard Module Series parameter is only valid when is configured to 'auto' or 'wave'. For example, when is 'wave', if the square wave does not need to be disturbed by other URCs (including SMS related URCs), then should be set to 'on'. 'off' RI behavior can be disturbed by other URCs when the behavior is caused by an incoming call ringing 'on' RI behavior cannot be disturbed by other URCs when the behavior is caused by an incoming call ringing Integer type. The count of pulse. This parameter is only valid when is 'pulse'. Range: 1–5. Default value: 1. The interval time between two pulses is equal to . Error code. See Chapter 13. 3.5. AT+QCFG='urc/ri/smsincoming' Set RI Behavior When Incoming SMS URCs are Presented This command specifies the RI (ring indicator) behavior when related incoming message URCs are presented. Related incoming message URCs list: +CMTI, +CMT, +CDS and +CBM. AT+QCFG='urc/ri/smsincoming' Set RI Behavior When Incoming SMS URCs are Presented Write Command Response AT+QCFG='urc/ri/smsincoming'[,[,[,]]] +QCFG: 'urc/ri/smsincoming',,, OK If the optional parameters are specified, set the RI behavior when incoming SMS URCs are presented: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms This command takes effect immediately. The configurations are saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 22 / 136 Parameter LTE Standard Module Series String type. RI behavior when URCs are presented. 'off' No change. Ring indicator keeps inactive 'pulse' Pulse. Pulse width is determined by 'always' Change to active. RI behavior can be restored to inactive by AT+QRIR Integer type. Set the width of pulse. Range: 1–2000. Default value: 120. Unit: ms. This parameter is only valid when is 'pulse'. Integer type. The count of pulse. This parameter is only valid when is 'pulse'. Range: 1–5. Default value: 1. The interval time between two pulses is equal to . Error code. See Chapter 13. 3.6. AT+QCFG='urc/ri/other' Set RI Behavior When Other URCs are Presented This command specifies the RI (ring indicator) behavior when other URCs are presented. AT+QCFG='urc/ri/other' Set RI Behavior When Other URCs are Presented Write Command AT+QCFG='urc/ri/other'[,[,[,]]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'urc/ri/other',,, OK If the optional parameters are specified, set the RI behavior when other URCs are presented: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms This command takes effect immediately. The configurations are saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 23 / 136 LTE Standard Module Series Parameter String type. RI behavior when URCs are presented. 'off' No change. Ring indicator keeps inactive 'pulse' Pulse. Pulse width is determined by Integer type. Set the width of pulse. Range: 1–2000. Default value: 120. Unit: ms. This parameter is effect only when is 'pulse'. Integer type. The count of pulse. This parameter is only valid when is 'pulse'. Range: 1–5. Default value: 1. The interval time between two pulses is equal to . Error code. See Chapter 13. 3.7. AT+QCFG='risignaltype' RI Signal Output Carrier This command specifies the RI (ring indicator) signal output carrier. AT+QCFG='risignaltype' RI Signal Output Carrier Write Command AT+QCFG='risignaltype'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'risignaltype', OK If the optional parameter is specified, set the RI signal output carrier: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms This command takes effect immediately. The configuration is saved automatically. Parameter String type. RI signal output carrier. 'respective' The ring indicator behaves on the port where URC is presented, and the port can be obtained by AT+QURCCFG='urcport'. See EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 24 / 136 LTE Standard Module Series document [1] for details about the command If URC is presented on UART port, it is physical ring line. If URC is presented on USB modem port, it is virtual ring line. If URC is presented on USB AT port, no ring line for USB AT port which does not support ring line. 'physical' No matter which port URC is presented on, the RI pin will have a ring jump Error code. See Chapter 13. Example AT+QCFG='risignaltype' +QCFG: 'risignaltype','respective' OK AT+QCFG='risignaltype','physical' OK AT+QCFG='risignaltype' +QCFG: 'risignaltype','physical' OK 3.8. AT+QCFG='urc/delay' Delay URC Indication Output This command delays the output of URC indication until ring indicator pulse ends. AT+QCFG='urc/delay' Delay URC Indication Output Write Command AT+QCFG='urc/delay'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'urc/delay', OK If the optional parameter is specified, set when the URC indication is outputted: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 25 / 136 LTE Standard Module Series Maximum Response Time Characteristics 300 ms This command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 URC indication will be outputted when ring indicator pulse starts 1 URC indication will be outputted when ring indicator pulse ends (only effective when the type of ring indicator is 'pulse'. See AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' or AT+QCFG='urc/ri/other' for details) Error code. See Chapter 13. 3.9. AT+QCFG='urc/cache' Enable/Disable URC Cache AT+QCFG='urc/cache' Enable/Disable URC Cache Write Command AT+QCFG='urc/cache'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'urc/cache', OK If the optional parameter is specified, enable/disable URC cache: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms This command takes effect immediately. The configuration is not saved. Parameter Integer type. Enable/disable URC cache. 0 Disable 1 Enable EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 26 / 136 Error code. See Chapter 13. Example AT+QCFG='urc/cache' +QCFG: 'urc/cache',0 //Disable URC cache. OK AT+QCFG='urc/cache',1 OK AT+QCFG='urc/cache' +QCFG: 'urc/cache',1 //Enable URC cache. OK //Make a call and send two messages to the module. AT+QCFG='urc/cache',0 //Disable URC cache. OK LTE Standard Module Series 3.10. AT+QCFG='urc/poweron' Set Output URC of Power-on AT+QCFG='urc/poweron' Set Output URC of Power-on Write Command AT+QCFG='urc/poweron'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'urc/poweron', OK Maximum Response Time Characteristics If the optional parameter is specified, set output URC of power-on: OK Or ERROR 300 ms This command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Enable/disable URC output of power-on. 0 Enable EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 27 / 136 LTE Standard Module Series 1 Disable Example AT+QCFG='urc/poweron' +QCFG: 'urc/poweron',0 OK AT+CFUN=0 OK AT+CFUN=1 OK +CPIN: READY +QUSIM: 1 +QIND: SMS DONE +QIND: PB DONE AT+QCFG='urc/poweron',1 OK AT+CFUN=0 OK AT+CFUN=1 OK //No URC output. AT+QCFG='urc/poweron' +QCFG: 'urc/poweron',1 OK //Query the current configuration of URC output. //Disable URC output. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 28 / 136 LTE Standard Module Series 3.11. AT+QCFG='divctl' Configure Primary and Rx-diversity under LTE/WCDMA AT+QCFG='divctl' Configure Primary and Diversity under LTE/WCDMA Write Command AT+QCFG='divctl',[,] Response If the optional parameter is omitted, query the current setting: +QCFG:'divctl',, OK Maximum Response Time If the optional parameter is specified, configure primary and Rx-diversity under LTE/WCDMA: OK Or ERROR 300 ms Characteristics / Parameter String type. Network mode. 'lte' LTE 'wcdma' WCDMA Integer type. Rx-diversity chain information. 0 Enable Rx-diversity chains 0 and 1 (PRX and DRX respectively) 1 Signal information is available on Rx-diversity chain 0 (PRX) 2 Signal information is available on Rx-diversity chain 1 (DRX) Example AT+QCFG='divctl','lte' +QCFG: 'divctl','lte',0 OK AT+QCFG='divctl','lte',1 OK //Query the current configuration under LTE. //Open LTE PRX, and close DRX. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 29 / 136 LTE Standard Module Series 3.12. AT+QCFG='bootup' Enable/Disable Services in Linux This command enables/disables the services in Linux, such as the web services. AT+QCFG='bootup' Enable/Disable Services in Linux Write Command AT+QCFG='bootup'[,,] Response If the optional parameter is omitted, list the range supported by : +QCFG: 'bootup', OK Maximum Response Time Characteristics If the optional parameter is specified, enable/disable services in Linux: OK Or ERROR 300 ms This command takes effect after rebooting. The configuration is saved automatically. Parameter String type. Service name. sfe Shortcut forward engine web-services WEB service wlan-services WLAN service Integer type. Set/query the services status. 0 Disable the services status 1 Enable the services status 2 Query the services status Example AT+QCFG='bootup' +QCFG: 'bootup', OK AT+QCFG='bootup',web-services,0 OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 30 / 136 LTE Standard Module Series 3.13. AT+QCFG='ppp/sleep_ri' Enable/Disable Waking up the Module through the RI Pin Indication after PPP Establishment AT+QCFG='ppp/sleep_ri' Enable/Ddisable Waking up the Module through the RI Pin Indication after PPP Establishment Write Command Response AT+QCFG='ppp/sleep_ri'[,,< If the optional parameters are omitted, query the current RI_interval>] setting: +QCFG: 'ppp/sleep_ri',, OK Maximum Response Time Characteristics If the optional parameters are specified, enable or disable waking up the module through the RI pin after PPP establishment: OK Or ERROR 300 ms This command takes effect immediately. The configurations are not saved. Parameter Integer type. Enable/Disable waking up the module through the RI pin when receiving data after PPP establishment. 0 Disable 1 Enable Integer type. RI level jump interval. Unit: ms. Range: 500–50000. Default value: 1000. NOTE Under PPP, when the module is awakened from the sleep, the RI pin always changes from high level to low level. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 31 / 136 LTE Standard Module Series 3.14. AT+QCFG='thermal/txpwrlmt' Configure Temperature Protection Strategy This command configures temperature protection strategy to restrict the maximum transmission power of the module. AT+QCFG='thermal/txpwrlmt' Configure Temperature Protection Strategy Write command AT+QCFG='thermal/txpwrlmt'[,,,,,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'thermal/txpwrlmt',,,,,, OK Maximum Response Time Characteristics If the optional parameters are temperature protection strategy: OK Or ERROR specified, configure 300 ms This command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Enable/disable the restriction for the maximum transmission power when a specified sensor reaches the temperature threshold. 1 Disable 0 Enable Integer type. Sensor ID. Range: 0–7. 2 Modem temperature sensor 5 PA temperature senso 7 XO temperature sensors Integer type. Temperature threshold. Range: -150~150. Unit: ºC. Default value: 105. Integer type. Detect period. Range: 1000–360000. Unit: ms. Default value: 1000. Integer type. Trigger counter. Range: 1–10000. Default value: 3. Integer type. Clear counter. Range: 1–10000. Default value: 10. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 32 / 136 LTE Standard Module Series 3.15. AT+QCFG='thermal/modem' Configure Thermal Threshold This command configures the thermal threshold to trigger the UL/DL rate descending. AT+QCFG='thermal/modem' Configure Thermal Threshold Write Command AT+QCFG='thermal/modem'[, ,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'thermal/modem',1,, +QCFG: 'thermal/modem',2,, +QCFG: 'thermal/modem',3,, OK Maximum Response Time Characteristics If the optional parameters are specified, set the thermal threshold to trigger the UL/DL rate descending. OK Or ERROR 300 ms This command takes effect after rebooting. The configurations are saved automatically. Parameter Integer type. Working condition of module under thermal threshold. 1 Descending UL rate 2 Descending DL and UL rate 3 Service state limitation Integer type. Triggering threshold. Integer type. Clearing threshold. NOTE ⚫ When =1, =100000 and =95000 by default. If the trigger threshold is higher than 100 degrees, the module enters Level1 to lower UL rate; If the clearing threshold is lower than 95 degrees, the module exits from Level 1. ⚫ When =2, =105000 and =100000 by default. If the trigger threshold is higher than 105 degrees, the module enters level 2 to lower UL and DL rate; If the clearing threshold is lower than 100 degrees, the module exits from level 2. ⚫ When =3, =115000 and =105000 by default. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 33 / 136 LTE Standard Module Series If the trigger threshold is higher than 115 degrees, the module enters limitation service state; If the clearing threshold is lower than 100 degrees, the module exits from level 3. 3.16. AT+QCFG='urc/ri/pin' Configure UART Pins Corresponding to RI AT+QCFG='urc/ri/pin' Configure UART Pins Corresponding to RI Write Command AT+QCFG='urc/ri/pin'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'urc/ri/pin', OK Maximum Response Time Characteristics If the optional parameter is specified, configure UART pins corresponding to RI: OK Or ERROR 300 ms This command takes effect immediately. The configuration is saved automatically. Parameter String type. UART pin name. 'uart_ri' 'uart_dcd' 3.17. AT+QCFG='icf' Configure Main UART This command configures the data bit, stop bit, parity bit of main UART. AT+QCFG='icf' Configure Main UART Write Command AT+QCFG='icf'[,,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'icf',,, EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 34 / 136 LTE Standard Module Series Maximum Response Time Characteristics OK If the optional parameters are specified, set the Main UART: OK Or ERROR 300 ms This command takes effect after rebooting. The configurations are saved automatically. Parameter Integer type. The supported data bit per char. 0 5 data bits per char 1 6 data bits per char 2 7 data bits per char 3 8 data bits per char Integer type. The supported stop bit. 0 0.5 stop bit 1 1 stop bit 2 1.5 stop bits 3 2 stop bits Integer type. The supported parity mode. 0 NO_PARITY 1 ODD_PARITY 2 EVEN_PARITY 3 SPACE_PARITY Example AT+QCFG='icf' +QCFG: 'icf',3,1,0 //Default UART configuration: 8 data bits per char, 1 stop bits, NO_PARITY. OK AT+QCFG='icf',2,1,1 OK //Configure main UART: 7 data bits per char, 1 stop bits, ODD_PARITY. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 35 / 136 LTE Standard Module Series 3.18. AT+QCFG='thermal/limit_rates' Enable/Disable the Rate Limit This command enables/disables the rate limit under high temperature. AT+QCFG='thermal/limit_rates' Enable/Disable the Rate Limit Write Command AT+QCFG='thermal/limit_rates'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'thermal/limit_rates', OK Maximum Response Time Characteristics If the optional parameter is specified, enable/disable the rate limit: OK Or ERROR 300 ms This command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Enable/Disable the rate limit. 0 Disable 1 Enable Example AT+QCFG='thermal/limit_rates' +QCFG: 'thermal/limit_rates',0 OK AT+QCFG='thermal/limit_rates',1 OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 36 / 136 LTE Standard Module Series 3.19. AT+QCFG='urcdelay' Configure URC Delay This command enables/disables URC delay report and URC delay time. When this feature is enabled, URC will be reported after the delay time. AT+QCFG='urcdelay' Configure URC Delay Write Command AT+QCFG='urcdelay'[,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'urcdelay',, OK If the optional parameters are specified, configure URC delay: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms This command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Disable/enable URC delay feature. 0 Disable 1 Enable Integer type. URC delay time. Range: 0–10000. Unit: ms. Default value: 100. Example AT+QCFG='urcdelay' +QCFG: 'urcdelay',0,0 //URC delay is disabled by default. OK AT+QCFG='urcdelay',1,3000 //Enable URC delay feature and delay URC for 3 s. OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 37 / 136 LTE Standard Module Series 3.20. AT+QCFG='sarcfg' LTE/WCDMA/GSM Set SAR Transmission Power for This command sets the specific transmission power corresponding to the SAR power level for LTE/WCDMA/GSM. AT+QCFG='sarcfg' Set SAR Transmission Power for LTE/WCDMA/GSM Write Command AT+QCFG='sarcfg'[,[,,,[,]]] Response If , , , and are omitted, query the current configuration: +QCFG: 'sarcfg',,< max_power>,,[,band] OK If , , and are omitted, return the power for the network mode specified by : +QCFG: 'sarcfg',,< max_power>,, OK If , and are omitted, return the power for the band under the network mode specified by : +QCFG: 'sarcfg',,< max_power>,,[,band] OK Maximum Response Time Characteristics If all the optional parameters are specified, set SAR transmission power for LTE/WCDMA/GSM: OK Or ERROR 300 ms / EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 38 / 136 LTE Standard Module Series Parameter String type. Network mode. 'lte_wcdma' LTE&WCDMA 'gsm' GSM only 'lte' LTE only 'wcdma' WCDMA only Integer type. The transmission power corresponding to the maximum SAR level. When is 'gsm', the range is 600–3000. Unit: 0.01 db. When is not 'gsm', the range is 600–3000. Unit: 0.01 db. Integer type. Transmission power difference between adjacent SAR levels. The value is less than configured in this command. Unit: 0.01 db. Integer type. The transmission power difference between adjacent slot levels. Range: 600–3000. Unit: 0.01db. The value is less than configured in this command. This parameter is only valid when is 'gsm'. When is not 'gsm', must be set to 0. When is 'lte' or 'wcdma', a single band can be specified with . If is omitted, configure all the bands under LTE or WCDMA. LTE: 0 LTE B1 1 LTE B2 2 LTE B3 3 LTE B4 4 LTE B5 5 LTE B6 6 LTE B7 7 LTE B8 8 LTE B9 9 LTE B10 10 LTE B11 11 LTE B12 12 LTE B13 13 LTE B14 14 LTE B17 15 LTE B18 16 LTE B19 17 LTE B20 18 LTE B21 19 LTE B23 20 LTE B24 21 LTE B25 22 LTE B26 23 LTE B27 24 LTE B28 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 39 / 136 25 LTE B30 26 LTE B31 27 LTE B33 28 LTE B34 29 LTE B38 30 LTE B39 31 LTE B40 32 LTE B41 33 LTE B42 43 LTE B43 45 LTE B45 66 LTE B66 71 LTE B71 WCDMA: 35 WCDMA B1 36 WCDMA B2 37 WCDMA B4 38 WCDMA B5 39 WCDMA B8 40 WCDMA B9 41 WCDMA B11 WCDMA2100 WCDMA1900 WCDMA1700 WCDMA850 WCDMA900 WCDMA1700 WCDMA1500 LTE Standard Module Series NOTE 1. When - × SARlevel(n) < 0, transmission power of the SARlevel(n) equals that of SARlevel(n-1). 2. In LTE and WCDMA, by default, the transmission power of SARlevel(1) to SARlevel(8) corresponds to 23 dBm to 16 dBm respectively. = 230 (23 dBm), = 10 (1 dBm). 3. In GSM, each SAR level is subdivided into 5 slots, and the power difference between each slot is determined by . For example, when = 100, it means that the power difference of the slot is 100/100 = 1 dBm. The power difference between each SAR level is determined by . For example, when =100, it means that the power difference of the SAR level is 100/100=1 dBm, that is, the transmission power of SARlevel(1) to SARlevel(8) corresponds to 28 dBm to 12 dBm respectively. The default values are: = 2800 (28 dBm), = 100 (1 dBm). = 100 (1 dBm). Example AT+QCFG='sarcfg' //Query the current setting. +QCFG: 'sarcfg',('lte_wcdma','gsm','lte','wcdma'),max_power,row_grads,column_grads[,ban d] OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 40 / 136 AT+QCFG='sarcfg','lte_wcdma' +QCFG: 'sarcfg','lte_wcdma',230,10,0 OK AT+QCFG='sarcfg','lte',5 +QCFG: 'sarcfg','lte',230,10,0 OK AT+QCFG='sarcfg','lte_wcdma',230,10,0 OK AT+QCFG='sarcfg','lte',230,10,0,5 OK LTE Standard Module Series 3.21. AT+QCFG='fast/poweroff' Enable/Disable Fast Power-Off AT+QCFG='fast/poweroff' Enable/Disable Fast Power-Off Write Command AT+QCFG='fast/poweroff'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'fast/poweroff', OK Maximum Response Time Characteristics If the optional parameter is specified, enable/disable fast power-off: OK Or ERROR 300 ms This command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Enable/disable fast power-off. 0 Disable 1 Enable Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 41 / 136 Example AT+QCFG='fast/poweroff' +QCFG: 'fast/poweroff',0 OK AT+QCFG='fast/poweroff',1 OK AT+QCFG='fast/poweroff' +QCFG: 'fast/poweroff',1 OK //Query the current setting. //Enable fast power-off. //Fast power-off is enabled. LTE Standard Module Series 3.22. AT+QCFG='sleep/datactrl' Configure Data Cache Mode This command configures data cache mode when the module is in sleep mode. AT+QCFG='sleep/datactrl' Configure Data Cache Mode Write Command AT+QCFG='sleep/datactrl'[,[,[,]]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'sleep/datactrl',,, OK Maximum Response Time Characteristics If the optional parameters are specified, set the data cache mode when the module is in sleep mode: OK Or ERROR 300 ms This command takes effect immediately. The configurations are not saved. Parameter Integer type. The type of the device to be cached. (e.g. 5 = 1 + 4, indicates caching the data that from UART1 and USB AT port when the module is in sleep mode.) 0 No device. Disable data cache 1 UART1 2 USB modem port (Not supported currently) EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 42 / 136 LTE Standard Module Series 4 USB AT port (Not supported currently) Integer type. The maximum time to cache the data that from the specified output port. If time reaches the set time, the data will be output. Default value: 300. Unit: ms. Integer type. The flag of automatic sending data when USB status changes (not supported currently). 0 When the USB changes to the normal state, the data sending will not be triggered 1 When USB changes from DISCONNECT or SUSPEND to CONFIGURED, the module will send the cached data immediately Error code. See Chapter 13. NOTE When all the following conditions are met, the module judges that the host is in the sleep m⚫odDeT. R condition: DTR sleep control is enabled with high level. If DTR sleep control is disabled, this condition can be ignored. ⚫ USB condition: the status of USB is DISCONNECT or SUSPEND. ⚫ AT+QSCLK is configured to 1. Example AT+QCFG='sleep/datactrl',1,800,0 //Enable data caching when the module is in sleep mode. The caching port is UART1. Timeout is 800 ms. OK AT+QCFG='sleep/datactrl' +QCFG: 'sleep/datactrl',0,300,1 //Query the current setting, which is disabled. OK 3.23. AT+QCFG='rf/tuner_cfg' Set the Mapping between RF Tuner and RF Bands AT+QCFG='rf/tuner_cfg' Set the Mapping between RF Tuner and RF Bands Write Command AT+QCFG='rf/tuner_cfg'[,,,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'rf/tuner_cfg',,,, OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 43 / 136 LTE Standard Module Series Maximum Response Time Characteristics If the optional parameters are specified, set the mapping between RF tuner and RF bands: OK Or ERROR 300 ms This command takes effect after rebooting. The configurations are saved automatically. Parameter Integer type. Pin level status. Range: 0–3. 0 Pin 144 at low level, pin 143 at low level 1 Pin 144 at low level, pin 143 at high level 2 Pin 144 at high level, pin 143 at low level 3 Pin 144 at high level, pin 143 at high level String type. LTE bands, and the separator is comma. E.g., '1,3,5', etc. String type. WCDMA bands, and the separator is comma. E.g., '1,3,5', etc. String type. GSM bands, and the separator is comma. E.g., '1,3,5', etc. Example AT+QCFG='rf/tuner_cfg' //Query the current setting. +QCFG: 'rf/tuner_cfg',0,'1,2,3,4,8,25,39','1,2,4,8','8,3,2' 'rf/tuner_cfg',1,'5,18,19,20,26','5,6,19','5' 'rf/tuner_cfg',2,'12,13,28' 'rf/tuner_cfg',3,'7,38,40,41' OK //Set the LTE bands, i.e., pin 144 at high level and pin 143 at low level. AT+QCFG='rf/tuner_cfg',2,'2,12,13, 25,28','5, 8' OK AT+QCFG='rf/tuner_cfg' //Query the current setting. +QCFG: 'rf/tuner_cfg', 0,'1, 3, 4, 8, 39','1, 2','8, 3, 2' 'rf/tuner_cfg',1,'5,18,19,20,26','5,6,19','5' 'rf/tuner_cfg',2,'2,12,13, 25,28','5,8' 'rf/tuner_cfg',3,'7,38,40,41' OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 44 / 136 LTE Standard Module Series 3.24. AT+QCFG='mms_rec_control' Save/Discard the MMS AT+QCFG='mms_rec_control' Save/Discard the MMS Write Command AT+QCFG='mms_rec_control'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'mms_rec_control', OK Maximum Response Time Characteristics If the optional parameter is specified, set whether to discard the MMS: OK Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Whether to discard the MMS. 0 Save the MMS 1 Discard the received MMS Example AT+QCFG='mms_rec_control',1 OK AT+QCFG='mms_rec_control' +QCFG: 'mms_rec_control',1 OK //Discard the received MMS. //Query the current setting. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 45 / 136 LTE Standard Module Series 4 Audio Commands 4.1. AT+QCFG='tone/incoming' Enable Ring Tone AT+QCFG='tone/incoming' Enable Ring Tone Write Command AT+QCFG='tone/incoming'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'tone/incoming', OK If the optional parameter is specified, enable ring tone: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Enable/disable the ring tone. 0 Disable ring tone 1 Enable Nokia ring tone 2 Enable ring tone Error code. See Chapter 13. Example AT+QCFG='tone/incoming' +QCFG: 'tone/incoming',0 //Ring tone is disabled. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 46 / 136 OK AT+QCFG='tone/incoming',1 OK AT+QCFG='tone/incoming' +QCFG: 'tone/incoming',1 OK //Enable the ring tone. //Ring tone is enabled. LTE Standard Module Series 4.2. AT+QCFG='pcmclk' Configure PCM_CLK This command enables or disables PCM_CLK. AT+QCFG='pcmclk' Configure PCM_CLK Write Command AT+QCFG='pcmclk'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'pcmclk', OK If the optional parameter is specified, configure PCM_CLK: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Enable/disable PCM_CLK. 0 Disable PCM_CLK. In decimal, the value is 0; In hexadecimal, the value is 0x0 1 Enable PCM_CLK. In decimal, the value is 1; In hexadecimal, the value is 0x1 Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 47 / 136 LTE Standard Module Series NOTE The output frequency depends on of AT+QDAI. If enabled, PCM_CLK will be able to output square wave, and the frequency is 2048 KHz; the PCM_SYNC will be able to output pulse shape, and the frequency is 8 KHz. See document [1] for the details of the command. 4.3. AT+QCFG='codec/powsave' Set PSM for ALC5616 Codec The command enables/disables the PSM (power saving mode) for ALC5616 Codec. AT+QCFG='codec/powsave' Set PSM for ALC5616 Codec Write Command Response AT+QCFG='codec/powsave'[,] +QCFG: 'codec/powsave', OK If the optional parameter is specified, enable/disable PSM for ALC5616 Codec: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Enable/disable the PSM. 0 Disable 1 Enable Error code. See Chapter 13. NOTE The configuration will take effect during the next calling. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 48 / 136 Example AT+QCFG='codec/powsave',1 OK AT+QCFG='codec/powsave' +QCFG: 'codec/powsave',1 OK LTE Standard Module Series //Enable the PSM for ALC5616 Codec. //Query the current power saving mode. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 49 / 136 LTE Standard Module Series 5 Network Commands 5.1. AT+QCFG='gprsattach' Configure GPRS Attach Mode This command specifies the mode to attach GPRS when UE is powered on. This configuration is valid only after the module is restarted. AT+QCFG='gprsattach' Configure GPRS Attach Mode Write Command AT+QCFG='gprsattach'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'gprsattach', OK If the optional parameter is specified, set the GPRS attach mode: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. The mode to attach GRPS when UE is powered on. 0 Attach manually 1 Attach automatically Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 50 / 136 LTE Standard Module Series 5.2. AT+QCFG='nwscanmode' Configure Network Search Mode This command specifies the network mode to be searched. AT+QCFG='nwscanmode' Configure Network Search Mode Write Command AT+QCFG='nwscanmode'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'nwscanmode', OK If the optional parameters are specified, set the network mode to be searched: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms determines when the command takes effect. The configuration is be saved automatically. Parameter Integer type. RAT. 0 AUTO 1 GSM only 2 WCDMA only 3 LTE only 4 TD-SCDMA only 5 UMTS only 6 CDMA only 7 HDR only 8 CDMA and HDR only Integer type. When the command to take effect. 0 Take effect after UE is rebooted 1 Take effect immediately Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 51 / 136 LTE Standard Module Series 5.3. AT+QCFG='servicedomain' Configure Service Domain This command queries and configures the registered service domain. AT+QCFG='servicedomain' Configure Service Domain Write Command AT+QCFG='servicedomain'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'servicedomain', OK If the optional parameters are specified, set the service domain of UE: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms determines when the command takes effect. The configuration is saved automatically. Parameter Integer type. Service domain of UE. 0 CS only 1 PS only 2 CS & PS Integer type. When to take effect. 0 Take effect after UE is rebooted 1 Take effect immediately Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 52 / 136 LTE Standard Module Series 5.4. AT+QCFG='band' Configure Band This command specifies the preferred frequency bands to be searched of UE. AT+QCFG='band' Configure Band Write Command AT+QCFG='band'[,,,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'band',,, OK If the optional parameters are specified, set the band: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms determines when the command takes effect. The configurations are saved automatically. Parameter A hexadecimal value that specifies the GSM and WCDMA frequency bands. e.g. 00000013 = 00000001 (GSM 900) + 00000002 (GSM 1800) + 00000010 (WCDMA 2100) 00000000 No change 00000001 GSM 900 MHz 00000002 GSM 1800 MHz 00000004 GSM 850 MHz 00000008 GSM 1900 MHz 00000010 WCDMA 2100 MHz 00000020 WCDMA 1900 MHz 00000040 WCDMA 850 MHz 00000080 WCDMA 900 MHz 00000100 WCDMA 800 MHz 00000200 WCDMA 1700 MHz 0000FFFF Any frequency band A hexadecimal value that specifies the LTE frequency band. If it is set to 0 or 0x40000000, it means not to change LTE frequency band. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 53 / 136 LTE Standard Module Series (e.g.: 0x15 = 0x1 (LTE B1) + 0x4 (LTE B3) + 0x10 (LTE B5) 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x40 (CM_BAND_PREF_LTE_EUTRAN_BAND7) LTE B7 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 0x80000(CM_BAND_PREF_LTE_EUTRAN_BAND20) LTE B20 0x7FFFFFFFFFFFFFFF(CM_BAND_PREF_ANY) Any frequency band A hexadecimal value that specifies the TD-SCDMA frequency band. If it is set to 0 or 0x40000000, it means not to change TD-SCDMA frequency band. e.g.: 0x21 = 0x1 (TDS BCA) + 0x20 (TDS BCF) 0x1 (CM_BAND_PREF_TDS_BANDA) TDS BCA 0x2 (CM_BAND_PREF_TDS_BANDB) TDS BCB 0x4 (CM_BAND_PREF_TDS_BANDC) TDS BCC 0x8 (CM_BAND_PREF_TDS_BANDD) TDS BCD 0x10 (CM_BAND_PREF_TDS_BANDE) TDS BCE 0x20 (CM_BAND_PREF_TDS_BANDF) TDS BCF Integer type. When to take effect. 0 Take effect after UE is rebooted 1 Take effect immediately Error code. See Chapter 13. Example AT+QCFG='band' //Read the factory band settings and save it on host side. +QCFG: 'band',0xbff,0x1e00b0e18df,0x0 OK AT+QCFG='band',0,1,0 //Fix module to LTE band 1, GSM/WCDMA band is not changed. OK AT+QCFG='band' +QCFG: 'band',0xbff,0x1,0x0 OK AT+QCFG='band',bff,00b0e18df,0 OK //Restore the band back in terms of factory band settings saved at beginning. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 54 / 136 LTE Standard Module Series 5.5. AT+QCFG='rrc' Configure RRC Release Version This command specifies the RRC release version. AT+QCFG='rrc' Configure RRC Release Version Write Command AT+QCFG='rrc'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'rrc', OK If the optional parameter is specified, set the RRC release version: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. RRC release version. 0 R99 1 R5 2 R6 3 R7 4 R8 5 R9 Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 55 / 136 LTE Standard Module Series 5.6. AT+QCFG='msc' Configure MSC Release Version This command specifies the UE MSC release version. AT+QCFG='msc' Configure MSC Release Version Write Command AT+QCFG='msc'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'msc', OK If the optional parameter is specified, set the MSC release version: OK Or ERROR Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. MSC release version. 0 Forces the UE to always behave as an R97/R98 mobile 1 Forces the UE to always behave as an R99 mobile 2 Causes the UE’s behavior to be dynamic Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 56 / 136 LTE Standard Module Series 5.7. AT+QCFG='sgsn' Configure UE SGSN Release Version This command specifies the UE SGSN release version. This configuration is valid only after the module is restarted. AT+QCFG='sgsn' Configure UE SGSN Release Version Write Command AT+QCFG='sgsn'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'sgsn', OK If the optional parameter is not omitted, set the SGSN release version: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. SGSN release version. 0 Forces the UE to always behave as an R97/R98 mobile 1 Forces the UE to always behave as an R99 mobile 2 Causes the UE’s behavior to be dynamic Error code. See Chapter 13. 5.8. AT+QCFG='hsdpacat' Configure HSDPA Category This command specifies the HSDPA category. AT+QCFG='hsdpacat' Configure HSDPA Category Write Command Response AT+QCFG='hsdpacat'[,] If the optional parameter is omitted, query the current EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 57 / 136 LTE Standard Module Series Maximum Response Time Characteristics setting: +QCFG: 'hsdpacat', OK If the optional parameter is not omitted, set the HSDPA category: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. HSDPA category. 6 Category 6 8 Category 8 10 Category 10 12 Category 12 14 Category 14 18 Category 18 20 Category 20 24 Category 24 Error code. See Chapter 13. 5.9. AT+QCFG='hsupacat' Configure HSUPA Category This command specifies the HSUPA category. This configuration is valid only after the module is restarted. AT+QCFG='hsupacat' Configure HSUPA Category Write Command AT+QCFG='hsupacat'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'hsupacat', EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 58 / 136 LTE Standard Module Series Maximum Response Time Characteristics OK If the optional parameter is not omitted, set the HSUPA category: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. HSUPA category. 5 Category 5 6 Category 6 Error code. See Chapter 13. 5.10. AT+QCFG='pdp/duplicatechk' Establish Multi-PDN with Same APN This command allows/refuses establishing multi-PDN with the same APN profile. AT+QCFG='pdp/duplicatechk' Establish Multi-PDN with Same APN Write Command AT+QCFG='pdp/duplicatechk'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'pdp/duplicatechk', OK If the optional parameter is not omitted, allow/refuse establishing multi-PDN with the same APN profile: OK Or ERROR EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 59 / 136 LTE Standard Module Series Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Refuse to establish multi-PDN with the same APN profile 1 Allowed to establish multi-PDN with the same APN profile Error code. See Chapter 13. 5.11. AT+QCFG='disable_backoff_lte' Disable Backoff LTE This command configures whether to disable backoff LTE when Voice/SMS is not available because of the unavailable SRLTE. AT+QCFG='disable_backoff_lte' Disable Backoff LTE Write Command AT+QCFG='disable_backoff_lte'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'disable_backoff_lte', OK Maximum Response Time Characteristics If the optional parameter is specified, disable backoff LTE: OK Or ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. Enable/disable backoff LTE. 1 Enable 0 Disable EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 60 / 136 LTE Standard Module Series 5.12. AT+QCFG='airplanecontrol' W_DISABLE# Pin Enter/Exit Airplane Mode via This command enters or exits airplane mode via the W_DISABLE# pin and queries the current setting. If the airplane mode is enabled, the module enters the airplane mode when the pin is pulled down and enters normal mode when the pin is pulled up. Also, URC +QIND: airplanestatus, is outputted before module entering or exiting the airplane mode. AT+QCFG='airplanecontrol' Enter/Exit Airplane Mode via W_DISABLE# Pin Write Command AT+QCFG='airplanecontrol'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'airplanecontrol',, OK Maximum Response Time Characteristics If the optional parameter is specified, module enters/exits airplane mode via W_DISABLE# pin: OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Whether to enable airplane mode. 0 Disable airplane mode 1 Enable airplane mode. Enter airplane mode when W_DISABLE# pin changes to active and exits airplane mode when W_DISABLE# pin changes to inactive URC +QIND: airplanestatus, is reported when W_DISABLE# pin status changes. It is not allowed to exit airplane mode by AT+CFUN=1 when W_DISABLE# pin is active. 2 Enable airplane mode. Enter airplane mode when W_DISABLE# pin changes to active and exit airplane mode when W_DISABLE# pin changes to inactive URC +QIND: airplanestatus, is reported when W_DISABLE# pin status changes. It is not allowed to exit airplane mode by AT+CFUN=1 or QMI when W_DISABLE# pin is active. Integer type. Enter/exit airplane mode. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 61 / 136 0 Exit 1 Enter LTE Standard Module Series NOTE See the corresponding hardware design of each module for more information about W_DISABLE# pin. Example AT+QCFG='airplanecontrol' +QCFG: 'airplanecontrol',0,0 //Query the current setting. OK //Pull down W_DISABLE# pin. AT+QCFG='airplanecontrol',1 OK //Enable airplane mode. +QIND: airplanestatus,1 //Enter airplane mode because W_DISABLE# pin is pulled down. AT+CFUN? +CFUN: 4 //In airplane mode. OK //Pull up W_DISABLE# pin. +QIND: airplanestatus,0 //Exit airplane mode. AT+CFUN? +CFUN: 1 //In normal mode. OK //Reboot the modem. AT+QCFG='airplanecontrol' +QCFG: 'ariplanecontrol',1,0 //Query the current setting. This setting still takes effect after reboot. OK //Pull down W_DISABLE# pin. +QIND: airplanestatus,1 //Enter airplane mode. AT+CFUN? +CFUN: 4 //In airplane mode. OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 62 / 136 LTE Standard Module Series 5.13. AT+QCFG='epcflag' Set EPC Capability Value in Attach Request AT+QCFG='epcflag' Set EPC Capability Value in Attach Request Write Command AT+QCFG='epcflag'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'epcflag', OK Maximum Response Time Characteristics If the optional parameter specified, set EPC capability value in attach request: OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Value of EPC capability. 0 In LTE mode, set value of EPC capability in attach request information to 0 1 In LTE mode, set value of EPC capability in attach request information to 1 Example AT+QCFG='epcflag' +QCFG: 'epcflag',1 OK AT+QCFG='epcflag',0 OK AT+QCFG='epcflag' +QCFG: 'epcflag',0 OK //Query the value of EPC capability. //Set value of EPC capability to 0. //Query the value of EPC capability. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 63 / 136 LTE Standard Module Series 5.14. AT+QCFG='lte/bandprior' Set Searching Priority of LTE Band AT+QCFG='lte/bandprior' Set Searching Priority of LTE Band Write Command AT+QCFG='lte/bandprior'[,][ ,][,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'lte/bandprior',[,][,] OK If the optional parameters are specified, set the searching priority of LTE band: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configurations are saved automatically. Parameter Integer type. Band ID of the first preferred LTE band. Range: 1–43. Integer type. Band ID of the second preferred LTE band. Range: 1–43. Integer type. Band ID of the third preferred LTE band. Range: 1–43. Error code. See Chapter 13. Example AT+QCFG='lte/bandprior',7,5,41 OK //Reboot the module. AT+QCFG='lte/bandprior' +QCFG: 'lte/bandprior',07,05,41 OK //Set searching order priority of LTE band. //Read searching priority of LTE band. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 64 / 136 LTE Standard Module Series 5.15. AT+QCFG='plmn/addinfbdn' Add Current PLMN to FPLMN AT+QCFG =AT+QCFG='plmn/addinfbdn' Add Current PLMN to FPLMN Write Command AT+QCFG='plmn/addinfbdn'[, ] Response If the optional parameter is omitted, query the current setting: +QCFG: 'plmn/addinfbdn', OK Maximum Response Time Characteristics If the optional parameter is specified, add the current PLMN to FPLMN: OK Or ERROR 300 ms The command takes effect immediately. The configurations is not saved. Parameter Integer type. Configure whether to add the current PLMN into FPLMN event if it is in the EHPLMN. 0 Do not add 1 Add Example AT+QCFG='plmn/addinfbdn' +QCFG: 'plmn/addinfbdn',0 //Query the current value. OK AT+QCFG='plmn/addinfbdn',1 OK AT+QCFG='plmn/addinfbdn' +QCFG: 'plmn/addinfbdn',1 //Add the current PLMN to FPLMN event. //Query the current value. OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 65 / 136 LTE Standard Module Series 5.16. AT+QCFG='cops_no_mode_change' Enable/Disable the Switch under AT+COPS=1 AT+QCFG='cops_no_mode_change' Enable/Disable the Switch under AT+COPS=1 Write Command AT+QCFG='cops_no_mode_change' [,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'cops_no_mode_change', OK Maximum Response Time Characteristics If the optional parameter is specified, enable/disable the switch under AT+COPS=1: OK Or ERROR 300 ms The command takes effect immediately. The configurations is saved automatically. Parameter Integer type. Enable/disable the switch under automatic mode in AT+COPS=1 (See document [1] for details about the command). 1 Disable 0 Enable 5.17. AT+QCFG='hplmn/search_timer' Interval Configure HPLMN Search AT+QCFG='hplmn/search_timer' Configure HPLMN Search Interval Write Command AT+QCFG='hplmn/search_timer'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'hplmn/search_timer', OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 66 / 136 LTE Standard Module Series Maximum Response Time Characteristics If the optional parameter is specified, set HPLMN search interval: OK Or ERROR 300 ms The command takes effect immediately. The configurations is not saved. Parameter Integer type. HLPMN search interval. Range: 1–71582. Unit: minute. NOTE The HPLMN search timer is started if the PLMN registered by the UE is different from HPLMN and EHPLMN. 5.18. AT+QCFG='tdd/config' Get the LTE-TDD Configuration This command gets the LTE-TDD configuration. AT+QCFG='tdd/config' Get the LTE-TDD Configuration Write Command AT+QCFG='tdd/config' Response +QCFG: 'tdd/config',, Maximum Response Time Characteristics OK 300 ms / Parameter Integer type. LTE-TDD subframe assignment. Range: 0–6. Integer type. LTE-TDD special subframe pattern. Range: 0–8. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 67 / 136 LTE Standard Module Series 5.19. AT+QCFG='urc_cause_support' Report Rejection Cause This command controls whether to report the URC of the cause (ESM/EMM/CP) when the network rejects the module. AT+QCFG='urc_cause_support' Report Rejection Cause Write Command AT+QCFG='urc_cause_support'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'urc_cause_support', OK Maximum Response Time Characteristics If the optional parameter is specified, report the rejection code: OK Or ERROR 300 ms / Parameter Hex format. Indicate the value of the setting. Range: 0–31. 0 Do not report network rejection code Bit 0: 0x01 namely value 1. Support ESM cause report. Bit 1: 0x02 namely value 2. Support EMM cause report. Bit 2: 0x04 namely value 4. Support CP cause report. Bit 3: 0x08 namely value 8. Support GMM cause report. Bit 4: 0x10 namely value 16. Support MM cause report. Certain reports above-mentioned can be freely combined. 5.20. AT+QCFG='dhcppktfltr' Filter DHCP Package This command configures whether DHCP package is filtered. AT+QCFG='dhcppktfltr' Filter DHCP Package Write Command AT+QCFG='dhcppktfltr'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'dhcppktfltr', EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 68 / 136 LTE Standard Module Series Maximum Response Time Characteristics OK If the optional parameter is specified, filter DHCP package: OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. 0 The UDP DHCP package is parsed by local stack after the module gets IP address 1 The UDP DHCP package is shipped to the external network after the module gets IP address Example AT+QCFG='dhcppktfltr' +QCFG: 'dhcppktfltr',0 OK AT+QCFG='dhcppktfltr',1 OK AT+QCFG='dhcppktfltr' +QCFG: 'dhcppktfltr',1 OK //Query the current value. //Ship the UDP DHCP package to the external network after the module gets IP address. //Current value is changed to 1. 5.21. AT+QCFG='oostimer' Set Mode for OOS Network Searching AT+QCFG='oostimer' Set Mode for OOS Network Searching Write Command AT+QCFG='oostimer'[,,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'oostimer',,, EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 69 / 136 LTE Standard Module Series Maximum Response Time Characteristics OK If the optional parameters are specified, set the mode for OOS network searching: OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. In OOS state, search the network 10 times with as a cycle first. Default value: 30. Unit: second. Integer type. If the network cannot be found within , search the network 10 times with as a cycle. Default value: 45. Unit: second. Integer type. If the network cannot be found within , keep searching the network with as a cycle. Default value: 60. Unit: second. Example AT+QCFG='oostimer',5,5,5 OK 5.22. AT+QCFG='apn/blocked' Configure APN Block Mode AT+QCFG='apn/blocked' Configure APN Block Mode Write Command AT+QCFG='apn/blocked'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG:'apn/blocked',, OK If the optional parameters are specified, configure APN block mode: OK Or EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 70 / 136 LTE Standard Module Series Maximum Response Time Characteristics ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Configure whether all the APNs blocked by the network is allowed to be written to NV. 0 Allowed 1 Not allowed Integer type. 0 Query all APNs that are blocked 1 Delete all APNs that are blocked Example AT+QCFG='apn/blocked' +QCFG: 'apn/blocked',0,0 //Query the current setting. OK AT+QCFG='apn/blocked',0,1 OK //All the APNs blocked by the network are allowed to be written to NV, and delete them. 5.23. AT+QCFG='redir/3gtolte' Configure Redirection Mode AT+QCFG='redir/3gtolte' Configure Redirection Mode Write Command AT+QCFG='redir/3gtolte'[,[,,]] Response If the optional parameter is omitted, query the current setting: +QCFG:'redir/3gtolte',,, OK If the optional parameter is specified, set redirection mode: OK Or EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 71 / 136 LTE Standard Module Series Maximum Response Time Characteristics ERROR 300 ms The command takes effect after the module is rebooted. The configurations are saved automatically. Parameter Integer type. Configure the redirection mode. 0 Do not allow the module to redirect LTE from 3G once it is rejected by the network when try to register LTE 1 Allow the module to redirect LTE from 3G if it is rejected by the network when it tries to register to LTE Integer type. EPS storage supported flag. 0 Not get EPS storage supported value from NV 1 Get EPS storage supported value from NV Integer type. Indicate whether to support EPS storage. 0 Not support 1 Support Example AT+QCFG='redir/3gtolte' +QCFG: 'redir/3gtolte',0,0,0 OK AT+QCFG='redir/3gtolte',1 OK //Query the current setting. //Allow the module to redirect LTE from 3G. 5.24. AT+QCFG='rssi' Configure Delta Threshold of RSSI Change AT+QCFG='rssi' Configure Delta Threshold of RSSI Change Write Command AT+QCFG='rssi'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'rssi', OK If the optional parameter is specified, configure delta EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 72 / 136 LTE Standard Module Series Maximum Response Time Characteristics threshold of RSSI change: OK Or ERROR 300 ms The command takes effect immediately. The configurations is not saved. Parameter Integer type. The delta threshold of RSSI change. Range: 0–20. Default value: 5. Unit: dBm. 5.25. AT+QCFG='roamservice' Configure Roaming Service This command enables or disables the roaming service. AT+QCFG='roamservice' Configure Roaming Service Write Command AT+QCFG='roamservice'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'roamservice', OK If the optional parameters are specified, set the roaming service: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms determines when the command takes effect. The configuration is saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 73 / 136 Parameter LTE Standard Module Series Integer type. The roaming service mode. 1 Disable roaming service 2 Enable roaming service 255 Auto mode Integer type. When the command take effect. 0 Take effect after UE reboots 1 Take effect immediately Error code. See Chapter 13. 5.26. AT+QCFG='fast_dormancy' Connection Dynamically Control the RRC This command dynamically controls the RRC connection under WCDMA network. AT+QCFG='fast_dormancy' Dynamically Control the RRC Connection Write Command AT+QCFG='fast_dormancy'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'fast_dormancy',[,] OK Maximum Response Time Characteristics If the optional parameters are specified, dynamically control the RRC connection: OK Or ERROR 300 ms The command takes effect immediately. Whether to save the parameter configuration is determined by . Parameter Integer type. 0 Disable the feature of fast dormancy 1 Query whether there is data in the period of ; If not, disconnect RRC automatically 2 Disconnect RRC immediately EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 74 / 136 LTE Standard Module Series 3 If the network support T323 timer, query if there is data in the period of T323 timer; If not, disconnect RRC automatically Integer type. Only valid when is 1. Range: 1–65535. Default value: 5. Unit: second. 5.27. AT+QCFG='airplane' Configure Airplane Mode AT+QCFG='airplane' Configure Airplane Mode Write Command AT+QCFG='airplane', Response If the optional parameter is omitted, query the current setting: +QCFG: 'ariplane', OK Maximum Response Time Characteristics If the optional parameter is specified, set the airplane mode: OK Or ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. Airplane mode. 0 Use default setting at EFS file 1 Force to enter airplane mode 2 Force to exit airplane mode Example AT+QCFG='airplane' +QCFG: 'airplane',0 OK AT+QCFG='airplane',1 OK //Reboot the modem. AT+QCFG='airplane' +QCFG: 'ariplane',1 //Query the current setting. //Force to enter airplane mode. //It is forced to enter airplane mode. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 75 / 136 LTE Standard Module Series OK 5.28. AT+QCFG='rrc/control' Configure the Feature of RRC Connection Control AT+QCFG='rrc/control' Configure the Feature of RRC Connection Control Write Command AT+QCFG='rrc/control'[,,,,,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'rrc/control',,,,,, OK Maximum Response Time Characteristics If the optional parameters are specified, set the feature of RRC connection control: OK Or ERROR 300 ms The command takes effect after the module is rebooted. The configurations are saved automatically. Parameter Integer type. Enable/disable RRC connection control. 0 Disable 1 Enable Integer type. Counter to track number of RRC connection failures. Range: 0–60. Default value: 0. Integer type. Amount of time the serving cell is barred after occurs. Range: 0–60. Default value: 0. Integer type. The waiting time to add the cell blacklist after RRC failure. Range: 0–300. Default value: 0. Integer type. Enable/disable barring optimization. 0 Disable 1 Enable Integer type. The delay time to start a new RRC connection establishment procedure. Range: 0-60. Default value: 0. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 76 / 136 LTE Standard Module Series NOTE The cause of the random-access failure reported by the RRC to the NAS layer is fixed into LTE RRC CONN_EST_FAILURE_CONN_REJECT when the barring optimization is enabled with the remaining time. Remaining time = - elapsed time from the first RRC connection failure, unless it is configured with by the OEM. 5.29. AT+QCFG='nwscanmodeex' Configure Network Searching Mode AT+QCFG='nwscanmodeex' Configure Network Searching Mode Write Command AT+QCFG='nwscanmodeex'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'nwscanmodeex', OK Maximum Response Time Characteristics If the optional parameter is specified, set the network searching mode: OK Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Network searching mode. Range: 0–63. Default value: 63. NOTE When Bit 0 to Bit 5 are all set to 1, it corresponds to =0 in AT+QCFG='nwscanmode'. Bit 0: CDMA2000 1X Bit 1: CDMA2000 HRPD (1xEVDO) Bit 2: GSM Bit 3: WCDMA Bit 4: LTE Bit 5: TD-SCDMA For example, to configure network searching mode to LTE only, it indicates to set to 16, EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 77 / 136 corresponding to 0001 0000 in hex. LTE Standard Module Series Example AT+QCFG='nwscanmodeex',28 //In hex, 28 is 0001 1100. Configure network searching mode to GSM, WCDMA, LTE. OK AT+QCFG='nwscanmodeex' //Query the current setting. +QCFG: 'nwscanmode',28 OK 5.30. AT+QCFG='assign_plmn_in_limit_search' Specify Operator for Camping on a Cell with Limited Service The command specifies an operator for the module to camp on a cell with limited service when no (U)SIM card is inserted. AT+QCFG='assign_plmn_in_limit_search' Specify Operator for Camping on a Cell with Limited Service Write Command Response AT+QCFG='assign_plmn_in_limit_se If the optional parameters are omitted, query the current arch'[,[,]] setting: +QCFG: 'assign_plmn_in_limit_search',, OK Maximum Response Time Characteristic If the optional parameters are specified, enable/disable specifying an operator for the module to camp on a cell with limit service when no (U)SIM card is inserted: OK Or ERROR 300 ms The command takes effect after the module is rebooted or AT+CFUN=0/1. The configurations are saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 78 / 136 LTE Standard Module Series Parameter Integer type. Enable/disable the feature of specifying an operator for the module to camp on a cell with limit service when no (U)SIM card is inserted. 0 Disable 1 Enable String type. Operator code. For example, '46000' indicates China Mobile. Example AT+QCFG='assign_plmn_in_limit_search',1,'46000' //Specify China Mobile. OK AT+QCFG='assign_plmn_in_limit_search' //Query current setting. +QCFG: 'assign_plmn_in_limit_search',1,46000 OK AT+QCFG='assign_plmn_in_limit_search',0 OK //Disable the feature of specifying an operator for the module to camp on a cell with limit service when no (U)SIM card is inserted. 5.31. AT+QCFG='iprulectl' Configure the Gateway Address Generation Rule The command configures the gateway address generation rule when the module is used as a network card. AT+QCFG='iprulectl' Configure the Gateway Address Generation Rule Write Command AT+QCFG='iprulectl'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'iprulectl', OK Maximum Response Time If the optional parameter is specified, set the gateway address generation rule: OK Or ERROR 300 ms EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 79 / 136 LTE Standard Module Series Characteristic The command takes effect immediately (The client needs re-connecting). The configurations is saved automatically. Parameter Integer type. Gateway address generation rule. 0 If the IP address is an odd integer, the gateway address is IP address plus 1. If the IP address is an even integer, the gateway address is IP address minus 1 1 The gateway address is equal to IP address minus 1 Example AT+QCFG='iprulectl' +QCFG: 'iprulectl',0 OK AT+QCFG='iprulectl',1 OK 5.32. AT+QCFG='disrplmn' Configure RPLMN and RPLMNACT for Network Searching This command configures whether to use RPLMN and RPLMNACT when searching network. If RPLMN is used when searching network, RPLMNACT must be used too. AT+QCFG='disrplmn' Configure RPLMN and RPLMNACT for Network Searching Write Command AT+QCFG='disrplmn'[,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'disrplmn',, OK If the optional parameters are specified, set whether to use RPLMN and RPLMNACT when searching network: OK Or ERROR EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 80 / 136 LTE Standard Module Series Maximum Response Time Characteristic If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configurations are saved automatically. Parameter Integer type. Whether to use RPLMN when searching network. 0 Do not use 1 Use Integer type. Whether to use RPLMNACT when searching network. 0 Do not use 1 Use Error code. See Chapter 13. NOTE 1. can be set only if =0. 2. The combination of =0 and =0 is invalid. 5.33. AT+QCFG='lte/preferfre' Set Preferred Frequency This command sets preferred frequency for searching network. AT+QCFG='lte/preferfre' Set Preferred Frequency Write Command AT+QCFG='lte/preferfre'[,,,,,,,] Response If the optional parameters are omitted, query the current setting: [+QCFG: 'lte/preferfre',,,,,,] OK Maximum Response Time Characteristic If the optional parameters are specified, set preferred frequency for searching network: OK Or ERROR 250 ms The command takes effect after the module is rebooted. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 81 / 136 LTE Standard Module Series The configurations are saved automatically. Parameter Integer type. Operation type. 0 Add a preferred frequency 1 Delete a preferred frequency Integer type. Preferred frequency index. Range: 1–10. Integer type. Band index. Range: 0–41, 60–62. 0 Band 1 1 Band 2 2 Band 3 … 41 Band 42 60 Band 125 61 Band 126 62 Band 127 Integer type. Reserved. Always be 101. Integer type. Frequency point. Integer type. Mobile country code. Integer type. Mobile network code. Example AT+QCFG='lte/preferfre',1,1,6,101,2452,460,03 //Delete the preferred frequency with index 1. OK AT+QCFG='lte/preferfre' OK 5.34. AT+QCFG='cops_control' AT+COPS Enable/Disable Configurations of This command enables or disables the configurations of AT+COPS. AT+QCFG='cops_control' Enable/Disable Configurations of AT+COPS Write Command AT+QCFG='cops_control'[, ] Response If the optional parameter is omitted, query the current setting: +QCFG: 'cops_control', EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 82 / 136 LTE Standard Module Series Maximum Response Time Characteristic OK If the optional parameter is specified, enable/disable the configurations of AT+COPS: OK Or ERROR 300 ms This command takes effect immediately. The configuration is not saved into NVRAM. Parameter Integer type. Enable/disable the configurations of AT+COPS. 0 Disable 1 Enable Examples AT+QCFG='cops_control',1 OK AT+QCFG='cops_control' +QCFG: 'cops_control',1 //Enable the configurations of AT+COPS. OK 5.35. AT+QCFG='map_rej_cause7_to_cause14' Enable/Disable Network Rejection Cause Mapping This command enables or disables network rejection cause mapping. When using roaming card, GPRS NOT ALLOWED is returned under the roaming network. After receiving the rejection code, the module marks the roaming card as PS INVALID, and stops searching PLMN. This command controls whether to modify REJECT CAUSE 7 to REJECT CAUSE 14 to make the module search PLMN continuously after receiving the rejection code. AT+QCFG='map_rej_cause7_to_cause14' Enable/Disable Network Rejection Cause Mapping Read command AT+QCFG='map_rej_cause7_to_cau se14'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'map_rej_cause7_to_cause14', EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 83 / 136 LTE Standard Module Series Maximum Response Time Characteristic OK If the optional parameter is specified, enable/disable network rejection cause mapping: OK Or ERROR 250 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. Enable/Disable network rejection cause mapping. 0 Disable 1 Enable Example AT+QCFG='map_rej_cause7_to_cause14' +QCFG: 'map_rej_cause7_to_cause14',0 //Query the current setting. OK AT+QCFG='map_rej_cause7_to_cause14',1 OK //Enable network rejection cause mapping. 5.36. AT+QCFG='netmaskset' Enable/Disable Customized Netmask This command enables or disables customer to set the netmask. AT+QCFG='netmaskset' Enable/Disable Customized Netmask Write Command AT+QCFG='netmaskset'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'netmaskset', OK If any of the optional parameters is specified, enable or disable customized netmask: OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 84 / 136 LTE Standard Module Series Maximum Response Time Characteristic Or ERROR 300 ms This command takes effect after reconnecting the network card. The configuration is saved automatically. Parameter Integer type. Enable/ disable customized netmask. 0 Disable. Netmask is set by the rule inside the module 1 Enable. Netmask is set by String type. Customized netmask. Only valid when =1. For example: '255.255.255.0'. Example AT+QCFG='netmaskset' +QCFG: 'netmaskset',0 //Query whether customized netmask is enabled. //Customized netmask is disabled. OK AT+QCFG='netmaskset',1, '255.255.255.0' OK AT+QCFG='netmaskset' +QCFG: 'netmaskset',1 //Enable customized netmask and set netmask. OK AT+QCFG='netmaskset',0 OK //Disable customized netmask and set netmask. 5.37. AT+QCFG='pingdiscard' Configure Whether to Discard Ping Packet This command configures whether to discard the Ping packet. AT+QCFG='pingdiscard' Configure Whether to Discard Ping Packet Write Command AT+QCFG='pingdiscard'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'pingdiscard', EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 85 / 136 LTE Standard Module Series Maximum Response Time Characteristic OK If the optional parameter is specified, configure whether to discard the Ping packet: OK Or ERROR 300 ms This command takes effect immediately. The configurations is not saved. Parameter Integer type. Whether to discard Ping packet. 0 Do not discard 1 Discard Ping echo request packet sent from network 5.38. AT+QCFG='urc/ri/restart' Configure RI Pulse Timer This command enables or disables restarting RI pulse timer when a new URC is reported but the last URC RI pulse is finished. AT+QCFG='urc/ri/restart' Configure RI Pulse Timer Write Command AT+QCFG='urc/ri/restart'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'urc/ri/restart', OK Maximum Response Time Characteristic If the optional parameter is specified, configure RI pulse timer: OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 86 / 136 LTE Standard Module Series Parameter Integer type. Enable/disable restarting RI pulse timer when a new URC is reported but the last URC RI pulse is finished. 0 Disable 1 Enable Example AT+QCFG='urc/ri/restart' +QCFG: 'urc/ri/restart',1 OK AT+QCFG='urc/ri/restart',1 OK //Query the current setting. //Enable restarting RI pulse timer when a new URC is reported but the last URC RI pulse is finished. 5.39. AT+QCFG='ping/ri' Configure Ping Detection Function This command configures Ping detection function. AT+QCFG='ping/ri' Configure Ping Detection Function Writer Command AT+QCFG='ping/ri'[,[, ] Response If the optional parameters are omitted, query the current setting: +QCFG: 'ping/ri',, OK Maximum Response Time Characteristic If the optional parameters are specified, configure Ping detection function: OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 87 / 136 LTE Standard Module Series Parameter Integer type. Enable/disable Ping detection function. The value occupies one byte. 0 Disable 1 Enable Integer type. Reporting mode if Ping packet is detected. The value occupies one byte. 0 Report URC ping/ri 1 Pull RI pin without reporting URC Example AT+QCFG='ping/ri' +QCFG: 'ping/ri',0,0 //Query the current setting. OK AT+QCFG='ping/ri',1,0 //Enable Ping detection and set reporting URC if Ping packet is detected. OK AT+QCFG='ping/ri' +QCFG: 'ping/ri',1,0 OK 5.40. AT+QCFG='defaultdns' Configure Default DNS for PDP Context This command configures the default DNS for PDP context. AT+QCFG='defaultdns' Configure Default DNS for PDP Context Write Command AT+QCFG='defaultdns'[,[,< dns1>[,]]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'defaultdns',,, OK If is specified to 0, disable configuring default DNS for PDP context: OK If is specified to 1 and other optional parameters are omitted, set primary DNS to '8.8.8.8' and ignore secondary DNS: OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 88 / 136 LTE Standard Module Series Maximum Response Time Characteristic If only and are specified, configure primary DNS, and set the secondary DNS to '8.8.8.8': OK If the optional parameters are specified, set default DNS for PDP context: OK Or ERROR 300 ms The command takes effect immediately. The configurations are not saved. Parameter Integer type. Enable/disable configuring default DNS for PDP context. 0 Disable 1 Enable String type. Customized primary DNS. For example: '8.8.8.8'. String type. Customized secondary DNS. For example: '114.114.114.114'. Example AT+QCFG='defaultdns' +QCFG: 'defaultdns',0,'0.0.0.0','0.0.0.0' OK AT+QCFG='defaultdns',1 OK AT+QCFG='defaultdns' +QCFG: 'defaultdns',1,'8.8.8.8','0.0.0.0' OK AT+QCFG='defaultdns',1, '114.114.114.114' OK AT+QCFG='defaultdns' +QCFG: 'defaultdns',1,'114.114.114.114','8.8.8.8' OK AT+QCFG='defaultdns',1,'8.8.4.4','114.114.114.114' OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 89 / 136 AT+QCFG='defaultdns' +QCFG: 'defaultdns',1,'8.8.4.4','114.114.114.114' OK AT+QCFG='defaultdns',0 OK LTE Standard Module Series 5.41. AT+QCFG='lpm/dataind' Configure Wake-up Mechanism This command configures wake-up mechanism. AT+QCFG='lpm/dataind' Configure Wake-up Mechanism Write Command AT+QCFG='lpm/dataind'[,,< mask>] Response If the optional parameters are enabled, query the current setting: +QCFG: 'lpm/dataind',, OK Maximum Response Time Characteristic If the optional parameters are specified, configure wake-up mechanism: OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Enable/disable the wake-up mechanism. The value occupies one byte. 0 Disable 1 Enable Integer type. Wake-up trigger mask. The value occupies one byte. If the corresponding bit is set to 1, the module is woken up when SCLK/DTR/USB receives data. Bit0 1 indicates detecting SLCK. If it is TRUE, wakes up the module 0 indicates ignoring SLCK Bit1 1 indicates detecting DTR. If it is TRUE, wakes up the module 0 indicates ignoring DTR Bit2 1 indicates detecting USB. If it is TRUE, wakes up the module 0 indicates ignoring USB EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 90 / 136 Bit3–Bit7 Reserved. Always be 0 Example AT+QCFG='lpm/dataind' +QCFG: 'lpm/dataind',0,0 OK AT+QCFG='lpm/dataind',1,0 OK AT+QCFG='lpm/dataind' +QCFG: 'lpm/dataind',1,0 OK LTE Standard Module Series 5.42. AT+QCFG='roamserviceex' Roaming State Control Relevant Functions in AT+QCFG='roamserviceex' Control Relevant Functions in Roaming State Write Command AT+QCFG='roamserviceex'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'roamserviceex', OK Maximum Response Time Characteristic If the optional parameter is specified, control the relevant functions in roaming state: OK Or ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 91 / 136 LTE Standard Module Series Parameter Integer type. Each bit corresponds to a feature. Set the bit to 1 indicates disabling the corresponding function. Range: 0–3. Default value: 0. Bit 1 Disable dial-up internet access function when UE is in roaming state Bit 2 Disable voice call function when UE is in roaming state Example AT+QCFG='roamserviceex',1 OK AT+QCFG='roamserviceex' +QCFG: 'roamserviceex',1 //Disable dial-up internet access when UE is in roaming mode. OK AT+QCFG='roamserviceex',2 OK AT+QCFG='roamserviceex' +QCFG: 'roamserviceex',2 //Disable voice call when UE is in roaming mode. OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 92 / 136 LTE Standard Module Series 6 PS Commands 6.1. AT+QCFG='ntp' Specify the Maximum Re-transmission Counts and the Interval for NTP The command specifies the maximum re-transmission times and the interval of NTP. AT+QCFG='ntp' Specify the Maximum Re-transmission Counts and the Interval for NTP Write Command AT+QCFG='ntp'[,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'ntp',, OK Maximum Response Time Characteristic If the optional parameters are not omitted, specify the maximum re-transmission counts and the interval for NTP: OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. NTP re-transmission counts. Range: 1–10. Default value: 3. Integer type. NTP re-transmissions interval. Range: 5–60. Default value: 15. Example AT+QCFG='ntp' +QCFG: 'ntp',3,15 //Query the current setting. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 93 / 136 LTE Standard Module Series OK AT+QCFG='ntp',5,20 OK AT+QCFG='ntp' +QCFG: 'ntp',5,20 //Set NTP re-transmission counts and interval. //Query the current setting. OK 6.2. AT+QCFG='TCP/SendMode' Configure TCP Sending Mode This command configures TCP sending mode. AT+QCFG='TCP/SendMode' Configure TCP Sending Mode Write Command AT+QCFG='TCP/SendMode'[,] Response If optional parameter is omitted, query the current setting: +QCFG: 'TCP/SendMode', OK If the optional parameter is specified, configure TCP sending mode: OK Or ERROR Maximum Response Time Characteristic If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Determine when to send SEND OK. 0 SEND OK is sent immediately after TCP socket sends data from serial port 1 SEND OK is sent after receiving an ACK from the remote TCP socket 2 ,SEND OK is sent after receiving an ACK from the remote TCP socket Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 94 / 136 Example AT+QCFG='TCP/SendMode' +QCFG: 'TCP/SendMode',0 OK AT+QCFG='TCP/SendMode',1 OK LTE Standard Module Series 6.3. AT+QCFG='tcp/windowsize' Configure TCP Window Available Size This command configures the available size of TCP window when sending/receiving data. AT+QCFG='tcp/windowsize' Configure TCP Window Available Size Write Command AT+QCFG='tcp/windowsize',[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'tcp/windowsize',, OK Maximum Response Time Characteristic If the optional parameter is specified, configure TCP window available size: OK Or ERROR 300 ms The command takes effect immediately. The configurations are not saved. Parameter Integer type. Set the receiving and sending buffer sizes. 0 Receiving buffer size 1 Sending buffer size Integer type. TCP window available size. Range: 16–100. Default value: 16. Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 95 / 136 LTE Standard Module Series 7 CS Commands 7.1. AT+QCFG='amrcodec' Configure AMR Codec This command configures the bandwidth, rate, and byte alignment of the voice codec AMR in different network states. Parameter can be multi-selected (calculate incoming parameters with &). AT+QCFG='amrcodec' Configure AMR Codec Write Command AT+QCFG='amrcodec'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'amrcodec', OK Maximum Response Time Characteristic If the optional parameter is specified, configure AMR codec: OK Or ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. Configure AMR codec in ORed. e.g. 7 = 1 + 2 + 4 means GSM AMR NB & GSM AMR WB & GSM HR AMR. 0 No AMR configuration 1 GSM AMR NB 2 GSM AMR WB 4 GSM HR AMR 8 WCDMA AMR WB 16 IMS AMR WB (Mode Set) 32 IMS AMR WB (Octet aligned mode) 63 All above six AMR configurations 64 Reserved 128 Reserved EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 96 / 136 Example AT+QCFG='AMRCODEC' +QCFG: 'amrcodec',5 OK AT+QCFG='amrcodec',63 OK AT+QCFG='amrcodec' +QCFG: 'amrcodec',63 OK LTE Standard Module Series NOTE The default value of varies between different modules. 7.2. AT+QCFG='frhrcodec' Configure GSM EFR/HR/FR Codec This command configures GSM EFR/HR/FR codec. AT+QCFG='frhrcodec' Configure GSM EFR/HR/FR Codec Write Command AT+QCFG='frhrcodec'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'frhrcodec', OK Maximum Response Time Characteristic If the optional parameter is specified, configure GSM EFR/HR/FR codec: OK Or ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 97 / 136 LTE Standard Module Series Parameter Integer type. Configure GSM EFR/HR/FR codec in ORed. e.g. 7 = 1 + 2 + 4, means GSM EFR/HR/FR are selected. Default value: 7. 0 No codec configuration 1 GSM FR 2 GSM HR 4 GSM EFR Example AT+QCFG='frhrcodec' +QCFG: 'frhrcodec',7 OK AT+QCFG='frhrcodec',3 OK AT+QCFG='frhrcodec' +QCFG: 'frhrcodec',3 OK 7.3. AT+QCFG='bip/auth' Configure PDP Authentication Type in BIP Process This command configures PDP authentication type in BIP data transmission process. AT+QCFG= bip/auth' Configure PDP Authentication Type in BIP Process Write Command AT+QCFG='bip/auth'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'bip/auth', OK Maximum Response Time If the optional parameter is specified, set the type of PDP authentication in the BIP process: OK Or ERROR 300 ms EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 98 / 136 LTE Standard Module Series Characteristic This command takes effect immediately. The configuration is saved automatically. Parameter Integer type. PDP authentication type. 0 No PDP authentication 1 PAP 2 CHAP NOTE 1. PDP in BIP process generally does not require authentication. 2. Currently this command is only supported for IDEMIA operator. Example AT+QCFG='bip/auth' +QCFG: 'bip/auth',0 OK AT+QCFG='bip/auth',1 OK AT+QCFG='bip/auth' +QCFG: 'bip/auth',1 //Set PDP authentication type as PAP in the BIP process. OK 7.4. AT+QCFG='SMS/ListMsgMap' List Message Map This command lists the message map with in the storage specified by AT+CPMS. See document [1] for details about the command. AT+QCFG='SMS/ListMsgMap' List Message Map Write Command AT+QCFG='SMS/ListMsgMap', Response +QCFG: 'SMS/ListMsgMap',, OK Or ERROR If error is related to ME functionality: EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 99 / 136 Maximum Response Time Characteristic LTE Standard Module Series +CME ERROR: 300 ms / Parameter String type. Message type. 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages String type. Bit map of total messages in the storage specified by of AT+CPMS. If the bit is 1, it means the message is on the type specified by . If the bit is 0, it means the message is not on the type specified by ; The position of the bit in bit map specified by indicates the message index in the storage specified by of AT+CPMS. Error code. See Chapter 13. Example AT+CPMS? +CPMS: 24,40,24,40,24,40 OK AT+QCFG='sms/listmsgmap','REC UNREAD' //List the received unread message map. +QCFG: 'sms/listmsgmap','REC UNREAD','000F5B0000' OK 7.5. AT+QCFG='ims/ut' Enable/Disable IMS/UT Function This command configures IMS/UT function. AT+QCFG='ims/ut' Enable/Disable IMS/UT Function Write Command AT+QCFG='ims/ut'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'ims/ut',,, OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 100 / 136 LTE Standard Module Series Maximum Response Time Characteristic If the optional parameter is specified, enable/disable the IMS/UT Function: OK or ERROR If error is related to ME functionality: +CME ERROR: 300 ms This command takes effect after the module is rebooted. The configurations are saved automatically. Parameter Integer type. Enable/disable IMS/UT function. 0 Disable 1 Enable Integer type. Supplementary service over LTE state is available or not. 0 Unavailable 1 Available Integer type. USSD over LTE state is available or not. 0 Unavailable 1 Available Error code. See Chapter 13. NOTE 1. UT is a sub function of IMS function. UT is running over IMS, and IMS is running over LTE. 2. If IMS/UT function is disabled, MUST be 0 and supplementary service (eg: CCFC/CCWA) over LTE is unavailable and use CSFB instead. Example AT+QCFG='ims/ut' +QCFG: 'ims/ut',1,1,0 OK AT+QCFG='ims/ut',0 OK AT+QCFG='ims/ut' +QCFG: 'ims/ut',0,0,0 //UT is enabled, Supplementary service over LTE is available, and USSD over LTE is unavailable. //Disable IMS/UT function and supplementary service uses CSFB. OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 101 / 136 LTE Standard Module Series 7.6. AT+QCFG='ims' Configure IMS Function This command configures IMS function. AT+QCFG='ims' Configure IMS Function Write Command AT+QCFG='ims'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'ims',, OK If the optional parameter is specified, configure IMS function: OK Or ERROR Maximum Response Time Characteristic If error is related to ME functionality: +CME ERROR: 300 ms This command takes effect after the module is rebooted. The configurations are saved automatically. Parameter Integer type. Configure IMS function. 0 Do not configure IMS. The default setting at MBN file is used 1 Forcedly enable IMS function 2 Forcedly disable IMS function Integer type. Enabled/disable VoLTE. 0 Disable 1 Enable Example AT+QCFG='ims' +QCFG: 'ims',0,0 OK AT+QCFG='ims',1 OK AT+QCFG='ims' +QCFG: 'ims',1,1 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 102 / 136 LTE Standard Module Series OK 7.7. AT+QCFG='ltesms/format' Set SMS Format in LTE Mode This command sets the SMS format in LTE mode. AT+QCFG='ltesms/format' Set SMS Format in LTE Mode Write Command AT+QCFG='ltesms/format'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'ltesms/format', OK If the optional parameter is specified, set SMS format in LTE mode: OK Or ERROR Maximum Response Time Characteristic If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. SMS format in LTE mode. For EC21-V and EC25-V modules, the default value is 0; for other modules, the default value is 1. 0 CDMA format 1 GSM format Error code. See Chapter 13. Example AT+CMGF=1 OK AT+QCFG='ltesms/format',0 OK AT+CMGS='15021012496' > This is a test from Quectel //Set CDMA format for SMS in LTE mode. //Send CDMA format SMS in LTE mode. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 103 / 136 +CMGS: 24 OK AT+QCFG='ltesms/format',1 OK AT+CMGS='15021012496' > This is a test from Quectel +CMGS: 25 OK LTE Standard Module Series //Set GSM format for SMS in LTE mode. //Send GSM format SMS in LTE mode. 7.8. AT+QCFG='volte_disable' Enable/Disable VoLTE This command enables or disables VoLTE. AT+QCFG='volte_disable' Enable/Disable VoLTE Write Command AT+QCFG='volte_disable'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'volte_disable', OK Maximum Response Time Characteristic If the optional parameter is specified, enable/disable VoLTE function: OK Or ERROR 300 ms This command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. Enable/disable VoLTE. 0 Enable 1 Disable Example AT+QCFG='volte_disable' +QCFG: 'volte_disable',0 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 104 / 136 OK AT+QCFG='volte_disable',1 OK //VoLTE is disabled. LTE Standard Module Series 7.9. AT+QCFG='sms/omadm' Set OMADM Message Parsing Mode This command sets OMADM message parsing mode. AT+QCFG='sms/omadm' Set OMADM Message Parsing Mode Write Command AT+QCFG='sms/omadm'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'sms/omadm', OK Maximum Response Time Characteristic If the optional parameter is specified, set the OMADM massage parsing mode: OK Or ERROR 300 ms This command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. OMADM message parsing mode. 0 OMADM short message is parsed 1 OMADM short message is not parsed Example AT+QCFG='sms/omadm' +QCFG: 'sms/omadm',0 OK AT+QCFG='sms/omadm',1 OK AT+QCFG='sms/omadm' +QCFG: 'sms/omadm',0 //Query the current setting. //Set the value of OMADM SMS to 1. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 105 / 136 LTE Standard Module Series OK 7.10. AT+QCFG='imsreg/iptype' Registration Configure the IP Type for IMS This command configures the IP type for IMS registration. AT+QCFG='imsreg/iptype' Configure the IP Type for IMS Registration Write Command AT+QCFG='imsreg/iptype'[,] Response If the optional parameters are omitted, query the current configuration: +QCFG: 'imsreg/iptype', OK Maximum Response Time Characteristics If the optional parameters are specified, set the IP type for IMS registration: OK Or ERROR 300 ms The command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Configure IP type for IMS registration. 0 IPv4 1 IPv6 Example AT+QCFG='imsreg/iptype' +QCFG: 'imsreg/iptype',0 //The current configuration is IPv4. OK AT+QCFG='imsreg/iptype',1 OK AT+QCFG='imsreg/iptype' //Configure the IP type when IMS registering to IPv6. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 106 / 136 +QCFG: 'imsreg/iptype',1 OK LTE Standard Module Series 7.11. AT+QCFG='sim/recovery' Configure (U)SIM Card Hot-plug This command configures (U)SIM card hot-plug. AT+QCFG='sim/recovery' Configure (U)SIM Card Hot-plug Write Command AT+QCFG='sim/recovery'[,,,] Response If the optional parameters are omitted, query the current configuration: +QCFG: 'sim/recovery',,, OK If the optional parameters are specified, configure (U)SIM card hot-plug: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configurations are saved automatically. Parameter Integer type. The number of times to resend an APDU immediately after sending an APDU to receive an error response. Integer type. Automatic detection cycle. Unit: second. Integer type. The number of times of automatic detection. Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 107 / 136 LTE Standard Module Series NOTE This command is a software hot-plug implementation, which corresponds to the hardware hot-plug implementation through AT+QSIMDET. Example AT+QCFG='sim/recovery' +QCFG: 'sim/recovery',3,0,0 OK //The feature of software hot-plug is disabled. 7.12. AT+QCFG='siminvalirecovery' Enable/Disable Re-attach Request This command enables/disables re-attach request after (U)SIM card attachment failure. AT+QCFG='siminvalirecovery' Enable/Disable Re-attach Request Write Command AT+QCFG='siminvalirecovery'[,,,] Response If the optional parameters are omitted, query the current configuration: +QCFG: 'siminvalirecovery',,, OK Maximum Response Time Characteristics If the optional parameters are specified, enable/disable re-attach request after (U)SIM card attachment failure: OK Or ERROR 300 ms The command takes effect after rebooting. The configurations are saved automatically. Parameter Integer type. Enable/disable re-attach request. 1 Enable 0 Disable Integer type. Time interval between two attach requests. Unit: s. Range: 1–60. Default EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 108 / 136 LTE Standard Module Series value: 5. This parameter is only valid when =1. Integer type. The maximum number of attaching request. Range: 1–255. Default value: 5. When the value is 255, it indicates unlimited number of attaching requests. NOTE An invalid (U)SIM card is required when testing this command. Example AT+QCFG='siminvalirecovery' +QCFG: 'siminvalirecovery',208,0,72 OK 7.13. AT+QCFG='roaming/voicecall' Roaming Mode Enable/Disable Voice Call in This command enables/disables the feature of voice call in roaming mode. AT+QCFG='roaming/voicecall' Enable/Disable Voice Call in Roaming Mode Write Command AT+QCFG='roaming/voicecall'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'roaming/voicecall', OK Maximum Response Time Characteristics If the optional parameter is specified, enable/disable the feature of voice call in roaming mode: OK Or ERROR 300 ms The command takes effect after rebooting. The configuration is saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 109 / 136 LTE Standard Module Series Parameter Integer type. Enable/disable the feature of Voice Call when UE is in the roaming mode. 0 Enable 1 Disable 7.14. AT+QCFG='voice_busytone' Control Busy Tone Playback When the module registers on the MCC/MNC (311/480) network, and initiates a call to peer, but the peer hangs up the call caused by on call, busy tone will appear. This command controls busy tone playback. AT+QCFG='voice_busytone' Control Busy Tone Playback Write Command AT+QCFG='voice_busytone'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'voice_busytone', OK Or ERROR Maximum Response Time Characteristics If the optional parameter is specified, control busy tone playback: OK Or ERROR 250 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Enable/disable busy tone playback. 0 Disable 1 Enable EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 110 / 136 LTE Standard Module Series NOTE 1. Busy tone control is enabled by default if the module registers on the MCC/MNC (311/480) network. Disable this function through AT+QCFG='voice_busytone',0. 2. If this function has not been configured by the module through Write Command before, ERROR will be returned by Read Command. Example AT+QCFG=? … +QCFG: 'voice_busytone',(0,1) … OK AT+QCFG='voice_busytone' +QCFG: 'voice_busytone',0 OK AT+QCFG='voice_busytone',1 OK //Return the supported parameter range. //Query the current setting. //Enable busy tone playback. 7.15. AT+QCFG=''call_control'' Feature Enable/Disable Module Voice Call This command enables/disables MO and MT voice call feature of the module. AT+QCFG='call_control' Enable/Disable Module Voice Call Feature Write Command AT+QCFG=''call_control'[,,] Response If the optional parameters are omitted, query the current configuration: +QCFG: ''call_control'',, OK If the optional parameter is specified, enable/disable MO and MT voice call feature of the module: OK Or ERROR EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 111 / 136 LTE Standard Module Series Maximum Response Time Characteristics 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Indicate whether to disable MO voice call feature. 0 Do not disable 1 Disable Integer type. Indicate whether to disable MT voice call feature. 0 Do not disable 1 Disable Example AT+QCFG=? … +QCFG: ''call_control'',(0,1),(0,1) … OK AT+QCFG='call_control' +QCFG: ''call_control'',0,0 OK ATD10086; OK //Make a MO voice call. ATH OK AT+QCFG='call_control',1,0 OK ATD10086; ERROR //Failed to make a MO voice call. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 112 / 136 LTE Standard Module Series 8 PPP Command 8.1. AT+QCFG='ppp/termframe' Enable/Disable the PPP TERM Frame Sending This command enables/disables the PPP TERM frame sending when PPP is hung up by module itself. AT+QCFG='ppp/termframe' Enable/Disable the PPP TERM Frame Sending Write Command AT+QCFG='ppp/termframe'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'ppp/termframe', OK If the configuration parameter is specified, enable/disable the PPP TERM frame sending: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Enable/disable TERM frame sending when hang up PPP by module itself. 0 Disable 1 Enable Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 113 / 136 LTE Standard Module Series NOTE If AT+QPPPDROP hangs up PPP with TERM frame, module will send TERM frame to MCU no matter whether is 0 or 1. Example AT+QCFG='ppp/termframe',1 OK AT+QCFG='ppp/termframe' +QCFG: 'ppp/termframe',1 OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 114 / 136 LTE Standard Module Series 9 USB Commands 9.1. AT+QCFG='usbnet' Configure the Network Card Type Interface This command configures the network card type interface. AT+QCFG ='usbnet' Configure the Network Card Type Interface Write Command AT+QCFG='usbnet'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'usbnet', OK If the configuration parameter is specified, set the network card type interface: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Network card type interface. 0 RmNet interface 1 ECM interface 2 MBIM interface 3 RNIDS interface Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 115 / 136 LTE Standard Module Series 9.2. AT+QCFG='usbcfg' Configure VID, PID and Porting Settings The command configures VID, PID and porting settings for the module. AT+QCFG='usbcfg' Configure VID, PID and Porting Settings Write Command AT+QCFG='usbcfg'[,,,,,,,,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'usbcfg',,,,,, ,,, OK Maximum Response Time Characteristics If the optional parameters are specified, configure VID, PID and porting settings: OK Or ERROR 300 ms The command takes effect after rebooting. The configurations are saved automatically. Parameter Integer type. Vendor ID of USB device. The maximum value is 65535. Integer type. Product ID of USB device. The maximum value is 65535. Integer type. Status of USB DIAG port. 0 Disable 1 Enable Integer type. Status of USB NMEA port. 0 Disable 1 Enable Integer type. Status of USB AT port. 0 Disable 1 Enable Integer type. Status of USB Modem port. 0 Disable 1 Enable Integer type. Status of USB net device. 0 Disable 1 Enable Integer type. Status of USB ADB device. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 116 / 136 0 Disable 1 Enable Integer type. UAC status. 0 Disable 1 Enable Example AT+QCFG='usbcfg',0x2C7C,0x0125,1,1,1,1,1,0,0 OK AT+QCFG='usbcfg' +QCFG: 'usbcfg',0x2C7C,0x125,1,1,1,1,1,0,0 OK LTE Standard Module Series 9.3. AT+QCFG='usbee' Control the USB Device Loading The command controls whether USB device loading needs to wait for modem to start. AT+QCFG='usbee' Control the USB Device Loading Write Command AT+QCFG= 'usbee'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'usbee', OK Maximum Response Time Characteristics If the optional parameter is specified, control whether USB device loading needs to wait for modem to start: OK Or ERROR 300 ms The command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. 0 The USB device loading not need to wait for Modem to start 1 The USB device loading need to wait for Modem to start EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 117 / 136 LTE Standard Module Series 9.4. AT+QCFG='usbmode' Get USB Mode This command queries USB mode or enables/disables the module to automatically report URCs about bus mode change. AT+QCFG=usbmode' Get USB Mode Write Command AT+QCFG='usbmode'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'usbmode',, OK Maximum Response Time Characteristics If the optional parameter is specified, query USB mode: OK Or ERROR 300 ms The command takes effect after rebooting. The configurations are saved automatically. Parameter Integer type. Enable/disable to automatically report URCs about USB mode change. 0 Disable 1 Enable String type. Indicate the USB mode. 'SUSPEND' 'CONFIGURED' 'DISCONNECTED' 'CONNECTED' 'UNKNOWN' NOTE 1. When =1, URCs can be reported to UART1. 2. Only when ='CONFIGURED', data can be transferred via USB. 3. Only when VBUS of USB PHY is connected (such as charger), can be switched to 'CONNECTED'. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 118 / 136 LTE Standard Module Series Example AT+QCFG='usbmode' +QCFG: 'usbmode',0,'SUSPEND' OK AT+QCFG='usbmode',1 //Set to 1 for report URCs about bus mode change. OK +QCFG: 'usbmode',1,'CONFIGURED' //The URC about USB mode 'CONFIGURED'. 9.5. AT+QCFG='spi/set' Configure SPI or UART Driver AT+QCFG='spi/set' Configure SPI or UART Driver Read command AT+QCFG='spi/set'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'spi/set', OK Maximum Response Time Characteristics If the optional parameter is specified, set SPI or UART driver: OK Or ERROR 250 ms This command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Configure pin feature. 0 Configure pin as general GPIO 1 Initialize pin as uart6 2 initialize pin as spi6 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 119 / 136 Example AT+QCFG=? …. +QCFG: 'spi/set',(0-2) OK AT+QCFG='spi/set',1 OK AT+QCFG='spi/set' +QCFG: 'spi/set',1 OK LTE Standard Module Series //Query the range of this command. //Initialized pins as uart6. //Query the current setting. 9.6. AT+QCFG='usbenum/seoctl' Enumeration Failure Enable Optimization of USB AT+QCFG='usbenum/seoctl' Enable Optimization of USB Enumeration Failure Write Command AT+QCFG='usbenum/seoctl'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'usbenum/seoctl', OK Maximum Response Time Characteristics If the optional parameter is specified, enable optimization of USB enumeration failure: OK Or ERROR 300 ms This command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Indicate whether to enable optimizing USB enumeration failure. 0 Disable 1 Enable EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 120 / 136 LTE Standard Module Series Example AT+QCFG=? … +QCFG: 'usbenum/seoctl',(0,1) … OK AT+QCFG='usbenum/seoctl',1 OK AT+QCFG='usbenum/seoctl' +QCFG: 'usbenum/seoctl',1 OK //Test command. //Enable optimizing USB enumeration failure. //Query the current setting. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 121 / 136 LTE Standard Module Series 10 CDMA Commands 10.1. AT+QCFG='cdma/pppauth' Enable/Disable PPP Authentication Optimization under CDMA This command enables/disables the PPP authentication optimization under CDMA. AT+QCFG='cdma/pppauth' Enable/Disable PPP Authentication Optimization under CDMA Write Command Response AT+QCFG='cdma/pppauth'[,] If the optional parameter is omitted, query the current setting: +QCFG: 'cdma/pppauth', OK If the optional parameter is specified, enable/disable the PPP authentication optimization under CDMA: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Whether to enable the PPP authentication optimization under CDMA. 0 Disable 1 Enable Error code. See Chapter 13. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 122 / 136 LTE Standard Module Series Example AT+QCFG='cdma/pppauth' +QCFG: 'cdma/pppauth',0 //The PPP authentication optimization is disabled by default. OK AT+QCFG='cdma/pppauth',1 OK AT+QCFG='cdma/pppauth' +QCFG: 'cdma/pppauth',1 //Enable the PPP authentication optimization under CDMA. OK 10.2. AT+QCFG='ehrpd' Configure CDMA Mode This command configures the CDMA network mode which the module expects to use. AT+QCFG='ehrpd' Configure CDMA Mode Write Command AT+QCFG='ehrpd'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'ehrpd', OK Maximum Response Time Characteristics If the optional parameter is specified, set the CDMA mode: OK Or ERROR 300 ms The command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Configure the network mode. 0 HDRSCP_REV0_PROTOCOLS_ONLY 1 HDRSCP_REVA_PROTOCOLS_WITH_MFPA 2 HDRSCP_REVA_PROTOCOLS_WITH_MFPA_AND_EMPA 3 HDRSCP_REVB_PROTOCOLS_WITH_MMPA 4 HDRSCP_REVA_PROTOCOLS_WITH_EHRPD 5 HDRSCP_REVB_PROTOCOLS_WITH_EHRPD EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 123 / 136 LTE Standard Module Series 6 HDRSCP_REVA_PROTOCOLS_WITH_EHRPD_AND_IRAT 7 HDRSCP_REVB_PROTOCOLS_WITH_EHRPD_AND_IRAT NOTE If this NV is not set, the module will use HDRSCP_REVA_PROTOCOLS_WITH_MFPA by default. Example AT+QCFG='ehrpd' +QCFG: 'ehrpd',2 OK AT+QCFG='ehrpd',2 OK //Query the current network mode. //Configure the network mode. 10.3. AT+QCFG='cdmasms/cmtformat' Set CMT Format of CDMA SMS PDU This command sets CMT format of CDMA SMS PDU. AT+QCFG ='cdmasms/cmtformat' Set CMT Format of CDMA SMS PDU Write Command AT+QCFG='cdmasms/cmtformat'[,< n>] Response If the optional parameter is omitted, query the current setting: +QCFG: 'cdmasms/cmtformat', OK If the optional parameter is specified, set CMT format of CDMA SMS PDU: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configuration is saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 124 / 136 LTE Standard Module Series Parameter Integer type. CMT format of CDMA SMS PDU. 0 CDMA 1 GSM Error code. See Chapter 13. Example AT+CMGF=0 OK AT+CNMI=2,2 OK AT+QCFG='cdmasms/cmtformat',0 OK //Show CDMA SMS content directly and not store it. //Set CDMA format. //Receive a new CDMA SMS ^HCMT: ,46 0000021002020702C6155968C69C0601FC081B00031D2B8001061022E831258003061610102128230 801000A0100 AT+QCFG='cdmasms/cmtformat',1 //Set GSM format. OK //Receive a new CDMA SMS. +CMT: ,24 00000B818155563001F700006101011282320004AE207109 EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 125 / 136 LTE Standard Module Series 11 SMS Commands 11.1. AT+QCFG='urcport/sms' Set URC Output Port of Short Message This command sets URC output port of short message. AT+QCFG='urcport/sms' Set URC Output Port of Short Message Write Command AT+QCFG='urcport/sms'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'urcport/sms'' OK Maximum Response Time Characteristics If the optional parameter is specified, set URC output port of short message: OK Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. URC output port of short message. 0 Using default URC output port 1 Set URC output port of short message as 'uart2' NOTE Use AT+QDIAGPORT=1 to configure debug UART port as AT port and restart module. See document [1] for details about the command. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 126 / 136 LTE Standard Module Series Example AT+QDIAGPORT=1 OK //Configure debug UART port as AT port. //Restart module AT+QURCCFG='urcport','uart1' //Configuration of URC output port is 'uart1'. OK AT+QCFG='urcport/sms' +QCFG: 'urcport/sms',0 //Query URC output port of short message. OK AT+QCFG='urcport/sms',1 OK AT+QCFG='urcport/sms' +QCFG: 'urcport/sms',1 //Set URC output port of short message as 'uart2'. //Query URC output port of short message as 'uart2'. OK 11.2. AT+QCFG=''sms_retry'' Configure SMS Retry Period and Interval This command configures SMS retry period and interval. AT+QCFG=''sms_retry'' Configure SMS Retry Period and Interval Write Command AT+QCFG=''sms_retry''[,[,< period>]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'sms_retry',, OK Maximum Response Time Characteristics If any of the optional parameters is specified, configure SMS retry period and interval: OK Or ERROR 300 ms The command takes effect after rebooting. The configuration are saved automatically. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 127 / 136 Parameter LTE Standard Module Series Integer type. SMS retry interval. Range: 0–255. Unit: second. Integer type. SMS retry period. Range: 0–255. Unit: second. NOTE If is set to 0, SMS will not retry when an error occurs. Example AT+QCFG=? … +QCFG: 'sms_retry',(0-255),(0-255) … OK AT+QCFG=''sms_retry'' +QCFG: 'sms_retry',45,180 OK AT+QCFG=''sms_retry'',5 OK AT+QCFG=''sms_retry'' +QCFG: 'sms_retry',5,180 OK AT+QCFG=''sms_retry'',5,30 OK AT+QCFG=''sms_retry'' +QCFG: 'sms_retry',5,30 OK EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 128 / 136 LTE Standard Module Series 11.3. AT+QCFG='sms_control' Enable/Disable Delivering or Submitting SMS This command enables/disables delivering or submitting SMS. AT+QCFG='sms_control' Enable/Disable Delivering or Submitting SMS Write Command AT+QCFG='sms_control'[, ,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'sms_control',, OK Maximum Response Time Characteristics If the optional parameters are specified, enable/disable delivering or submitting SMS: OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer Type. Enable/disable submitting SMS. 0 Disable 1 Enable Integer Type. Enable/disable delivering SMS. 0 Disable 1 Enable NOTE 1. After disabling sending SMS, AT+CMGS/AT+CMSS will return an error. See document [1] for details about the two commands. 2. This command takes effect in both 3GPP and 3GPP2 messages. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 129 / 136 Example AT+QCFG='sms_control' +QCFG: 'sms_control',1,1 OK AT+QCFG='sms_control',0,1 OK AT+CMGS='17301836745' +CMS ERROR: 302 AT+QCFG='sms_control',0,0 OK LTE Standard Module Series //Query SMS control configuration. //Disable submitting SMS. //The operation is not allowed. //Disable sending and receiving SMS. EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 130 / 136 LTE Standard Module Series 12 Appendix A References Table 3: Related Document Document Name [1] Quectel_EC2x&EG9x&EG2x&EM05_Series_AT_Commands_Manual Table 4: Terms and Abbreviations Abbreviation 3GPP AP AMR APDU APN BIP CDMA CHAP CS CSFB CP DHCP EFR EPC Description 3rd Generation Partnership Project Application Processor Adaptive Multi-Rate Application Protocol Data Unit Access Point Name Bearer Independent Protocol Code Division Multiple Access Challenge-Handshake Authentication Protocol Circuit Switching Circuit Switched Fallback Control Plane Dynamic Host Configuration Protocol Enhanced Full Rate Speed Encoding Evoloved Packet Core EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 131 / 136 ETWS ESM EFS FPLMN GPRS GSM HSDPA HSUPA HPLMN LTE MCC/MNC ME MNC MS MSC MO MT NTP NVRAM OEM OMADM PAP PS PDN PDP LTE Standard Module Series Earthquake and Tsunami Warning System EPS Session Management Embedded File System Forbidden Public Land Mobile Network General Packet Radio Service Global System for Mobile Communications High Speed Downlink Packet Access High Speed Uplink Packet Access Home Public Land Mobile Network Long-Term Evolution Mobile Country Code Mobile Equipment Mobile Network Code Mobile Station Microsoft Snap-In Control Mobile Originated Mobile Terminated Network Time Protocol Non-Volatile Random Access Memory Original Equipment Manufacturer Open Mobile Alliance Device Management Password Authentication Protocol Packet Switching Packet Data Network Packet Data Protocol EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 132 / 136 PLMN PPP RRC PCM PDU QMI RX SAR SGSN SMS SRLTE TA TDD TCP UE UMTS URC UDP USB (U)SIM VoLTE VID WCDMA LTE Standard Module Series Public Land Mobile Network Point to Point Protocol Radio Resource Control Pulse Code Modulation Packet Data Unit Qualcomm Message Interface Receive Specific Absorption Rate Serving GPRS Support Node Short Message Service Single Radio LTE Terminal Adapter Time Division Duplex Transmission Control Protocol User Equipment Universal Mobile Telecommunications System Unsolicited Result Code User Datagram Protocol Universal Serial Bus (Universal) Subscriber Identity Module Voice (voice calls) over LTE Vendor ID Wideband Code Division Multiple Access EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 133 / 136 LTE Standard Module Series 13 Appendix B Summary of Code Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. Table 5: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 10 11 12 13 14 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 134 / 136 LTE Standard Module Series 15 SIM wrong 16 Incorrect password 17 SIM PIN2 required 18 SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 901 Audio unknown error 902 Audio invalid parameters EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 135 / 136 LTE Standard Module Series 903 Audio operation not supported 904 Audio device busy EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 136 / 136

M35 AT 命令手册 GSM/GPRS 系列 版本：M35_AT 命令手册_V3.2 日期：2015-11-02 www.quectel.com M35 AT 命令手册 移远公司始终以为客户提供最及时、最全面的服务为宗旨，如需任何帮助，请随时联系我司上海总部，联 系方式如下： 上海移远通信技术有限公司 上海市徐汇区田州路 99 号 13 幢 501 室电话:+86 21 51086236 邮箱: info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/support/salesupport.aspx 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/support/techsupport.aspx Or Email: Support@quectel.com l 前言 te 移远公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规范，参数来设计其产品。 c l 由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未声明前，移远公司有权对 该文档规范进行更新。 ue tia 版权申明 本文档手册版权属于移远公司，任何人未经我公司复制转载该文档将承担法律责任。 Q en 版权所有 ©上海移远通信技术有限公司 2015，保留一切权利。 Confid Copyright © Quectel Wireless Solutions Co., Ltd. 2015 上海移远通信技术有限公司 1 / 250 M35 AT 命令手册 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 1.4 日期 2011-12-22 ctel l 2012-03-27 Que entia 2012-04-08 fid 2012-07-20 Con 2013-04-17 作者 胡志琴 王靓 王靓 王靓 王靓 变更表述 初始版本 1. 更新流控简介的内容 2. 为指令 AT+QBAND 新增参数 3. 新增指令： AT+QNITZ/AT+QLTS/AT+CTZU/AT+CTZR/ AT+QLDTMF/AT+QLTONE/AT+QSPCH/AT+Q MUXC 4. 删除 FAX 相关指令 5. 删除指令： AT+QECHO/AT+QSIMDET/AT+QECHOEX/AT +QSIMSTAT/AT+QTEMP/AT+QLOCKF/AT+CR SM/AT+QDISP 为指令 AT+QLTS 新增参数日光节约时间 1. 更新指令 AT+CNUM 中的参数描述 2. 更新指令 AT+IFC 的默认值为无流控状态 1. 新增指令： AT+CRSM/AT+CSIM/AT+QCSPWD/AT+QSP N/AT+QTRPIN/AT+QENG/AT+QSCANF/AT+ QLOCKF/AT+QTONEP/AT+QTDMOD/AT+QT ONEDET/AT+QWDTMF/AT+QALARM/AT+QL EDMODE/A/ 2. 更新指令： AT+QSMSCODE/AT+QISTATE/AT+QSCLK/ AT+QRIMODE/ 1. 更新指令： AT+QMOSTAT/AT+CLCK/AT+QSPN/AT+QIP 1.5 2013-07-16 王靓 ROMPT/AT+QISERVER/AT+QISRVC/ AT+CLIP 2. 新增指令： 上海移远通信技术有限公司 2 / 250 M35 AT 命令手册 AT+QSIMDET/AT+QSIMSTAT/AT+QAUDOOP 1.6 2013-11-26 戴龙 所有指令的描述中增加最大响应时间 1. 更新 AT+CNMI 的命令描述 3.0 2014-06-30 耿晶晶 2. 更改 AT+CGSMS 的默认值 3. 更改 AT+QLOCKF 的参数范围 4. 删除 CSD 相关指令 1. 删除指令： AT+QSIMDET/AT+QSIMSTAT/AT+CSIM/AT+C ACM/AT+CAMM/AT+CAOC/AT+CPUC/AT+CC 3.1 2014-09-16 耿晶晶 WE 2. 增加 AT+QCOLP/AT+QCLIP 命令描述 3.2 CQouneficdteenl tial 2015-11-02 张后燕 3. 更新 AT+QSCLK 命令描述 4. 增加 AT+QDSIM/AT+QGSN 命令 1. 增加指令： AT+QREFUSECS/AT+QCGTIND/AT+QSIMDE T/AT+QSIMSTAT/AT+CSIM/AT+CCID 2. 更新指令：  更 新 ATH/+++/AT+CPBW/AT+COPS/AT+ CBC 命令备注说明  增加 AT+QTDMOD/AT+QSCLK/AT+QINDI 参数  更新 AT+CSCS/ AT+ICF/ AT+IFC/AT+CGQ REQ/AT+QINDI/ AT+CLIP/ AT+COLP/AT+ VTS/AT+CMUT/AT+QSIDET/AT+QLTONE/ AT+QSCLK 描述 3. 删除指令： AT+DR/AT+DS 上海移远通信技术有限公司 3 / 250 M35 AT 命令手册 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 4 表格索引 ...................................................................................................................................................... 10 1 引言 ...................................................................................................................................................... 11 1.1. 本章概要 ................................................................................................................................ 11 1.2. AT 命令术语缩写和惯例......................................................................................................... 11 1.3. AT 命令语法 ........................................................................................................................... 11 1.3.1. AT 命令类型.................................................................................................................... 12 1.3.2. AT 命令连写.................................................................................................................... 12 2 1.4. 支持的字符集 ......................................................................................................................... 13 1.5. 流控简介 ................................................................................................................................ 13 1.5.1. 软件流控 ......................................................................................................................... 13 1.5.2. 硬件流控 ......................................................................................................................... 14 l AT 命令详解 ......................................................................................................................................... 15 te 2.1. AT 命令格式 .......................................................................................................................... 15 2.2. ATI 显示产品 ID 信息 ............................................................................................................ 15 c l 2.3. AT+GMI 请求制造商 ID 信息................................................................................................. 16 ue tia 2.4. AT+GMM 请求 TA 制造商和型号信息...................................................................................16 2.5. AT+GMR 请求 TA 软件版本信息........................................................................................... 17 2.6. AT+GOI 请求全球目标识别 ID .............................................................................................. 17 Q n 2.7. AT+CGMI 请求制造商 ID 信息 .............................................................................................. 18 2.8. AT+CGMM 请求 TA 制造商和型号信息 ................................................................................ 18 e 2.9. AT+CGMR 请求 TA 软件版本信息 ........................................................................................ 19 2.10. AT+GSN 请求 TA 序列号（IMEI） ....................................................................................... 19 fid 2.11. AT+CGSN 请求 TA 序列号（IMEI）..................................................................................... 20 2.12. AT+QGSN 请求 TA 序列号（IMEI）..................................................................................... 21 2.13. AT&F 设置所有 TA 参数为出厂配置...................................................................................... 22 n 2.14. AT&V 显示当前配置 .............................................................................................................. 22 o 2.15. AT&W 保存用户配置参数...................................................................................................... 23 2.16. ATQ 设置结果码显示模式 ..................................................................................................... 24 C 2.17. ATV 设置 TA 响应返回内容格式............................................................................................ 24 2.18. ATX 设置 CONNECT 结果码格式和检测呼叫进程 ............................................................... 25 2.19. ATZ 复位为缺省配置 ............................................................................................................. 26 2.20. AT+CFUN 设置模块功能....................................................................................................... 27 2.21. AT+QPOWD 关机 ................................................................................................................. 29 2.22. AT+CMEE 上报移动设备错误 ............................................................................................... 29 2.23. AT+CSCS 选择 TE 字符集.................................................................................................... 31 2.24. AT+GCAP 请求 TA 功能列表 ................................................................................................ 32 3 串行接口控制命令 ................................................................................................................................ 33 3.1. AT&C 设置 DCD 功能模式 .................................................................................................... 33 上海移远通信技术有限公司 4 / 250 M35 AT 命令手册 3.2. AT&D 设置 DTR 功能模式 .................................................................................................... 33 3.3. AT+ICF 设置 TE-TA 帧格式 .................................................................................................. 34 3.4. AT+IFC 设置 TE-TA 流控 ...................................................................................................... 35 3.5. AT+ILRR 设置本地速率报告 ................................................................................................. 36 3.6. AT+IPR 设置 TE-TA 波特率 .................................................................................................. 37 3.6.1. 自适应波特率.................................................................................................................. 38 3.6.1.1. 自适应波特率操作限制 ...................................................................................... 39 3.6.1.2. 自适应波特率和 MUX ........................................................................................ 39 3.6.1.3. 自适应波特率和 windows 调制解调器 ............................................................... 39 3.7. AT+CMUX 多路复用 ............................................................................................................. 39 4 状态控制命令........................................................................................................................................ 42 4.1. AT+CEER 上报移动设备错误 ............................................................................................... 42 5 4.2. 4.3. 4.4. 4.5. l 4.6. te 4.7. 4.8. c l 4.9. 4.10. ue tia 4.11. 4.12. 4.13. Q n 4.14. 4.15. e 4.16. AT+CPAS 模块活动状态 ....................................................................................................... 43 AT+QINDRI 开启关闭 RI 引脚提示 ....................................................................................... 44 AT+QMOSTAT 开启或关闭去电呼叫状态报告...................................................................... 45 AT+QREFUSECS 开启或关闭来短信和来电拒接功能 .......................................................... 46 AT+QIURC 初始化完成提示上报 .......................................................................................... 47 AT+QEXTUNSOL 开启关闭专有 URC 上报 ......................................................................... 47 AT+QINISTAT 初始化状态查询............................................................................................. 49 AT+QNSTATUS 查询 GSM 网络状态 ................................................................................... 49 AT+QNITZ 同步网络时间...................................................................................................... 50 AT+QLTS 获取最近一次的网络同步时间 .............................................................................. 51 AT+CTZU 网络时间同步以及更新 RTC 时间......................................................................... 52 AT+CTZR 网络时间同步上报................................................................................................ 53 AT+QSIMDET 开启或关闭 SIM 卡检测功能 .......................................................................... 53 AT+QSIMSTAT SIM 卡插拔状态报告 .................................................................................... 55 AT+QCGTIND 语音/数据呼叫结束提示 ................................................................................ 56 fid SIM 卡相关命令.................................................................................................................................... 58 5.1. AT+CIMI 请求国际移动台设备标识（IMSI） ........................................................................ 58 5.2. AT+CLCK 设备锁定 .............................................................................................................. 58 n 5.3. AT+CPIN 输入 PIN................................................................................................................ 60 5.4. AT+CPWD 设备锁定............................................................................................................. 62 o 5.5. AT+CRSM SIM 卡接入限制 ................................................................................................ 63 C 5.6. AT+CSIM 通用 SIM 操作 ....................................................................................................... 65 5.7. AT+QCSPWD 更改 PS 超级密码.......................................................................................... 65 5.8. AT+CCID 显示 CCID............................................................................................................. 66 5.9. AT+QCCID 显示 CCID.......................................................................................................... 67 5.10. AT+QGID 获取 SIM 卡 GID................................................................................................... 67 5.11. AT+QSIMVOL 固定 SIM 卡工作电压 .................................................................................... 68 5.12. AT+QSPN 读取 SIM 卡服务运营商名称 ............................................................................... 69 5.13. AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数....................................................................... 69 5.14. AT+QDSIM 双卡单待命令切换 ............................................................................................. 70 6 网络服务命令........................................................................................................................................ 72 上海移远通信技术有限公司 5 / 250 M35 AT 命令手册 6.1. AT+COPS 选择营运商 .......................................................................................................... 72 6.2. AT+CREG 网络注册信息 ....................................................................................................... 73 6.3. AT+CSQ 信号质量 ................................................................................................................ 75 6.4. AT+CPOL 优选运营商列表 ................................................................................................... 76 6.5. AT+COPN 查询运营商列表 .................................................................................................. 77 6.6. AT+QBAND 查询运营商列表 ................................................................................................ 77 6.7. AT+QENG 开启或关闭工程模式 ........................................................................................... 78 6.8. AT+QSCANF GSM 频率功率扫描 ...................................................................................... 81 6.9. AT+QLOCKF 锁 GSM 频率 .................................................................................................. 82 7 呼叫控制命令........................................................................................................................................ 84 7.1. ATA 呼叫应答 ........................................................................................................................ 84 7.2. ATD 移动台呼叫某一号码 ..................................................................................................... 85 8 7.3. 7.4. 7.5. 7.6. l 7.7. te 7.8. 7.9. c l 7.10. 7.11. ue tia 7.12. 7.13. 7.14. Q n 7.15. 7.16. e 7.17. fid 7.18. 7.19. 7.20. ATH 挂机控制 ....................................................................................................................... 86 +++ 数据模式切换至命令模式............................................................................................... 87 ATO 命令模式切换至数据模式.............................................................................................. 87 ATP 选择脉冲拨号 ................................................................................................................ 88 ATS0 自动应答前振铃次数 ................................................................................................... 89 ATS6 盲拨号前暂停控制 ....................................................................................................... 90 ATS7 等待呼叫建立完成时间................................................................................................ 90 ATS8 暂停拨号时间 .............................................................................................................. 91 ATS10 挂机延时.................................................................................................................... 92 ATT 音频拨号 ........................................................................................................................ 92 AT+CSTA 选择地址类型 ....................................................................................................... 93 AT+CLCC 查询当前呼叫....................................................................................................... 94 AT+CR 业务上报控制 ........................................................................................................... 95 AT+CRC 蜂窝结果码 ............................................................................................................ 96 AT+CSNS 单一编码方案....................................................................................................... 97 AT+QSFR 配置语音编码模式 ............................................................................................... 98 AT+QSPCH 语音信道类型上报 ............................................................................................ 99 AT+QDISH ATH 使能控制................................................................................................. 100 n 短消息相关命令 .................................................................................................................................. 101 8.1. AT+CSMS 选择短消息业务 ................................................................................................ 101 o 8.2. AT+CMGF 配置短消息模式 ................................................................................................ 102 C 8.3. AT+CSCA 短消息服务中心地址.......................................................................................... 102 8.4. AT+CPMS 选择短消息存储器 ............................................................................................. 104 8.5. AT+CMGD 删除短消息 ....................................................................................................... 105 8.6. AT+CMGL 列出优选短消息存储器中的短消息 ................................................................... 106 8.7. AT+CMGR 读取短消息 ....................................................................................................... 109 8.8. AT+CMGS 发送短消息 ....................................................................................................... 112 8.9. AT+CMGW 写短消息 .......................................................................................................... 114 8.10. AT+CMSS 从存储器发送短消息 ......................................................................................... 115 8.11. AT+CMGC 发送短消息命令 ................................................................................................ 116 8.12. AT+CNMI 新短消息指示 ..................................................................................................... 118 上海移远通信技术有限公司 6 / 250 M35 AT 命令手册 8.13. 8.14. 8.15. 8.16. 8.17. 8.18. 8.19. 8.20. AT+CRES 恢复 SMS 设置 .................................................................................................. 120 AT+CSAS 保存 SMS 设置 .................................................................................................. 120 AT+CSCB 选择小区广播消息类型 ...................................................................................... 121 AT+CSDH 显示文本格式参数 ............................................................................................. 122 AT+CSMP 设置文本格式参数 ............................................................................................. 123 AT+QCLASS0 接收 Class0 短信存储到当前存储器 ........................................................... 124 AT+QMGDA 删除指定类型的所有短信 ............................................................................... 125 AT+QSMSCODE 配置短消息字符集 .................................................................................. 126 9 电话本相关命令 .................................................................................................................................. 128 9.1. AT+CPBS 选择电话簿存储单元.......................................................................................... 128 9.2. AT+CPBW 写删电话簿记录 ................................................................................................ 129 9.3. AT+CPBR 查询电话簿记录 ................................................................................................. 130 10 11 9.4. AT+CPBF 查找电话簿记录 ................................................................................................. 132 9.5. AT+CNUM 用户号码 ........................................................................................................... 133 GPRS 相关命令.................................................................................................................................. 134 l 10.1. AT+CGATT GPRS 附着和分离 ......................................................................................... 134 10.2. AT+CGDCONT 定义 PDP 上下文....................................................................................... 135 te 10.3. AT+CGQREQ 请求的服务质量........................................................................................... 136 10.4. AT+CGQMIN 可接受的最小服务质量 ................................................................................. 137 c l 10.5. AT+CGACT PDP 上下文激活和去激活 ............................................................................... 138 ue tia 10.6. AT+CGDATA 进入数据模式 ................................................................................................139 10.7. AT+CGPADDR 显示 PDP 地址........................................................................................... 140 10.8. AT+CGCLASS GPRS 移动台类别.................................................................................... 141 10.9. AT+CGEREP 非请求 GPRS 事件上报控制 ........................................................................ 142 Q n 10.10. AT+CGREG GPRS 网络注册状态 .................................................................................... 143 e 10.11. AT+CGSMS 为 MO SMS 选择业务 .................................................................................... 144 10.12. AT+QGPCLASS 配置 GPRS 多时隙级别........................................................................... 145 fid TCPIP 相关命令 ................................................................................................................................. 146 11.1. AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 ............................................................... 146 11.2. AT+QISEND 发送 TCP 或 UDP 数据.................................................................................. 147 n 11.3. AT+QICLOSE 关闭 TCP 或 UDP 连接 ............................................................................... 148 o 11.4. AT+QIDEACT 关闭 GPRS/CSD PDP 场景 ........................................................................ 150 11.5. AT+QILPORT 配置本地端口号 ........................................................................................... 150 C 11.6. AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码 ........................................... 151 11.7. AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） .............................................. 152 11.8. AT+QILOCIP 获取本地 IP 地址........................................................................................... 153 11.9. AT+QISTAT 查询当前连接状态........................................................................................... 153 11.10. AT+QISTATE 查询当前接入的连接状态 ............................................................................. 155 11.11. AT+QISSTAT 查询当前 Server 状态 ................................................................................... 156 11.12. AT+QIDNSCFG 配置域名服务器 DNS ............................................................................... 157 11.13. AT+QIDNSGIP 域名解析 .................................................................................................... 158 11.14. AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 ............................................................. 159 11.15. AT+QIHEAD 配置接收数据时是否显示 IP 头...................................................................... 159 上海移远通信技术有限公司 7 / 250 M35 AT 命令手册 11.16. AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 .............................................................. 160 11.17. AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' .............................................. 161 11.18. AT+QISERVER 配置为服务器 ............................................................................................ 161 11.19. AT+QICSGP 设置 CSD 或 GPRS 连接模式 ....................................................................... 162 11.20. AT+QISRVC 选择当前可操作连接...................................................................................... 164 11.21. AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号............................... 164 11.22. AT+QISCON 保存 TCPIP 应用场景配置 ............................................................................ 165 11.23. AT+QIMODE 配置 TCPIP 应用模式 ................................................................................... 167 11.24. AT+QITCFG 配置透明传输模式.......................................................................................... 167 11.25. AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议..................................................... 168 11.26. AT+QIMUX 控制是否启用多路连接 .................................................................................... 169 11.27. AT+QISHOWLA 控制是否显示本地 IP 地址 ....................................................................... 170 12 13 11.28. 11.29. 11.30. 11.31. l 11.32. 11.33. te 11.34. AT+QIFGCNT 配置前置场景 .............................................................................................. 170 AT+QISACK 查询发送数据信息.......................................................................................... 171 AT+QINDI 配置是否缓存接收到的数据............................................................................... 172 AT+QIRD 读取缓存的数据 .................................................................................................. 173 AT+QISDE 控制 AT+QISEND 是否允许数据回显 .............................................................. 174 AT+QPING PING 远程服务器........................................................................................... 175 AT+QNTP 通过网络时间服务器同步本地时间.................................................................... 176 c l 补充业务命令...................................................................................................................................... 178 12.1. AT+CCFC 设置呼叫转移..................................................................................................... 178 ue tia 12.2. AT+CCUG 封闭用户组........................................................................................................180 12.3. AT+CCWA 呼叫等待 ........................................................................................................... 180 12.4. AT+CHLD 呼叫保持和多方通话.......................................................................................... 182 Q n 12.5. AT+CLIP 来电号码显示设置 ............................................................................................... 184 12.6. AT+QCLIP 配置来电是否显示主叫号码名称....................................................................... 185 e 12.7. AT+CLIR 主叫识别限制 ...................................................................................................... 186 fid 12.8. AT+COLP 显示被叫识别..................................................................................................... 187 12.9. AT+QCOLP 配置去电是否显示主叫号码名称语法 .............................................................. 189 12.10. AT+CUSD 非结构化附加业务 ............................................................................................. 190 12.11. AT+CSSN 附加业务通知..................................................................................................... 191 n 音频控制命令...................................................................................................................................... 193 o 13.1. ATL 设置监听扬声器音量 .................................................................................................... 193 C 13.2. ATM 设置监听扬声器模式................................................................................................... 193 13.3. AT+VTD 配置 DTMF 音播放时长........................................................................................ 194 13.4. AT+VTS DTMF 音调发送 .................................................................................................. 195 13.5. AT+CALM 来电警报模式..................................................................................................... 196 13.6. AT+CRSL 来电音量等级 ..................................................................................................... 197 13.7. AT+CLVL 扬声器音量等级 .................................................................................................. 197 13.8. AT+CMUT 上行静音控制 .................................................................................................... 198 13.9. AT+QSIDET 配置侧音增益等级 .......................................................................................... 199 13.10. AT+QMIC 配置麦克风增益等级 .......................................................................................... 200 13.11. AT+QLDTMF 产生本地 DTMF 音 ........................................................................................ 200 上海移远通信技术有限公司 8 / 250 M35 AT 命令手册 13.12. 13.13. 13.14. 13.15. 13.16. 13.17. 13.18. AT+QAUDCH 切换音频通道 ............................................................................................... 201 AT+QAUDLOOP 音频通道回环测试................................................................................... 202 AT+QLTONE 产生本地定制单音......................................................................................... 202 AT+QTONEP 配置 DTMF/TONE 输出路径 ......................................................................... 203 AT+QTDMOD 设置 DTMF 检测模式................................................................................... 204 AT+QTONEDET DTMF 检测 ............................................................................................... 205 AT+QWDTMF 通话中播放 DTMF 音 .................................................................................. 207 14 硬件相关命令...................................................................................................................................... 210 14.1. AT+CCLK 实时时钟 ............................................................................................................ 210 14.2. AT+QALARM 闹铃设置....................................................................................................... 211 14.3. AT+CBC 查询电池电量和充电状态..................................................................................... 212 14.4. AT+QSCLK 慢时钟配置 ...................................................................................................... 212 15 16 14.5. AT+QLEDMODE 网络指示灯配置 ...................................................................................... 213 其他命令 ............................................................................................................................................. 215 15.1. A/ 重复上一条 AT 指令........................................................................................................ 215 l 15.2. ATE 命令回显模式 .............................................................................................................. 215 15.3. ATS3 配置命令行终止符 ..................................................................................................... 216 te 15.4. ATS4 设置响应格式字符 ..................................................................................................... 216 15.5. ATS5 配置命令行编辑字符 ................................................................................................. 217 c l 15.6. AT+QRIMODE 设置 RI 时长 ............................................................................................... 218 ue tia 附录 ....................................................................................................................................................219 16.1. 参考文档 .............................................................................................................................. 219 16.2. 术语缩写 .............................................................................................................................. 219 Q n 16.3. AT&F 影响到的 AT 命令及参数............................................................................................ 220 16.4. AT&W 影响到 AT 命令参数列表........................................................................................... 222 e 16.5. ATZ 影响到的 AT 命令参数列表........................................................................................... 224 fid 16.6. AT&V 显示当前配置信息...................................................................................................... 226 16.7. AT&V 内容格式对照表 ......................................................................................................... 228 16.8. URCs 说明列表.................................................................................................................... 228 16.9. +CME ERROR 错误报告列表.............................................................................................. 231 n 16.10. +CMS ERROR 错误代码列表.............................................................................................. 234 o 16.11. 错误扩展列表 ....................................................................................................................... 236 16.11.1. Location ID 扩展错误报告列表.............................................................................. 236 C 16.11.2. 协议栈层（PS）错误列表 ..................................................................................... 237 16.11.3. MM 层内部错误列表.............................................................................................. 249 16.11.4. PPP/IP 栈错误列表 ............................................................................................... 250 上海移远通信技术有限公司 9 / 250 M35 AT 命令手册 表格索引 表 1：参考文档 ................................................................................................................................................ 219 表 2：术语缩写 ................................................................................................................................................ 219 表 3：AT&F 影响到的 AT 命令及参数 .............................................................................................................. 220 表 4：AT&W 影响到的 AT 命令参数列表 ......................................................................................................... 222 表 5：ATZ 影响到的 AT 命令参数列表 ............................................................................................................. 224 表 6：AT&V 显示当前配置信息........................................................................................................................ 226 表 7：ATV 内容格式对照表.............................................................................................................................. 228 表 8：URCS 说明列表 ..................................................................................................................................... 228 表 9：+CME ERROR 错误代码列表 ................................................................................................................ 231 表 10：+CMS ERROR 错误代码列表 .............................................................................................................. 234 表 11：LOCATION ID 扩展错误报告列表 ....................................................................................................... 236 表 12：协议栈层（PS）错误列表.................................................................................................................... 237 表 13：MM 层内部错误列表 ............................................................................................................................ 249 CQouneficdteenl tial 表 14：PPP/IP 栈错误列表.............................................................................................................................. 250 上海移远通信技术有限公司 10 / 250 M35 AT 命令手册 1 引言 1.1. 本章概要 该文档主要描述 M35 模块软件 AT 指令集及参数详解。 1.2. AT 命令术语缩写和惯例 l 文档内提及的 GSM 模块包括移动设备 ME（Mobile Equipment）、移动台 MS（Mobile Station）、终端 te 适配器 TA（Terminal Adapter）、数据通信设备 DCE（Data Communication Equipment）和传真 FAX（包 c l 括传真 Modem 和传真板）。 ue tia 通过串口发送 AT 命令，即可使用 GSM 模块。串行线终端的应用设备包括终端设备 TE（Terminal Equipment）、数据终端设备 DTE（Data Terminal Equipment）或其他应用设备。这些终端或应用设备可能 运行在嵌入式系统内。 Q n 文档内涉及到的相关名词术语缩写都是基于 GSM 规范书写。 fide 1.3. AT命令语法 n 文档内所有 AT 命令行必须以'AT'或'at'作为开头，以回车（）作为结尾。 Co 返回响应通常紧随命令之后，它的样式是''（）。AT 命令介绍过程中，只有被详细介绍，过程中被有意省 略了。 上海移远通信技术有限公司 11 / 250 M35 AT 命令手册 1.3.1. AT 命令类型 文档内所有 AT 命令类型有如下三种： 基础类命令：此类 AT 命令格式有'AT'或者'AT&'，其中''是命令自带，''是指该 命令支持一个或多个参数。例如：'ATE'，该命令用于关闭或使能回显功能，即 DCE 会依据''值决 定是否把接收的字符回显给 DTE。''是可选配参数，若没有被赋值，将使用默认值。 参数类命令：此类 AT 命令格式有'ATS=[]'，其中''是 S 寄存器的索引，''是赋予的参 数值。在该 AT 命令中，''是可选配参数，若没有被赋值，将使用默认值。 扩展类命令：通常来讲，扩展类命令根据操作格式及应用功能可分为几种类型，详见 2.1. AT 命令格式。 AT 命令语法说明：  方括号（[]）中的值为可缺省值； l  选配参数和必配参数必须在操作的参数范围内进行设置并按规定的顺序排列，各参数间必须使用 逗号隔开； te  举例：AT+CPWD=,,，该命令用于为设备锁定 AT+CLCK 命令锁定义的 c l 设备锁定功能设置新的密码； ue tia  如果参数是字符串（例如：），则该字符串必须放在双引号中；  举例：'12345'，'CMNET'等，双引号中的各项符号可看作是字符串；  命令的可选子参数或 TA 返回结果的可选部分位于方括号中； Q n  不使用双引号时，字符串中各字符间的空格可忽略不计； e  实际操作中，,[]不必输入； fid  所有 AT 命令本身不区分大小写，但其参数对大小写敏感。 n 1.3.2. AT 命令连写 o 在需要连续执行多个 AT 命令时，必须等到上一条 AT 命令作了最终响应（例如：返回 OK，ERROR， C CME ERROR，CMS ERROR 等），才能继续操作下一条 AT 命令。该动作强烈建议执行。 上海移远通信技术有限公司 12 / 250 M35 AT 命令手册 1.4. 支持的字符集 GSM 模块 AT 命令接口默认使用 GSM 字符集，字符集可以通过'AT+CSCS'命令（GSM 07.07）进行 查询和配置。其支持的字符集如下：  GSM  UCS2  HEX  IRA  PCCP437  8859_1 字符集会影响短消息，广播消息的读取，编辑，发送和接收，电话簿、SIM 卡工具箱等字符串的输入 和显示。 tel 1.5. 流控简介 uec tial 要保障 GSM 模块与 DTE 之间可靠通信，流控很重要。假若一次数据或传真呼叫过程中，发送端的数 据发送速度大于接收端的数据接收速度，若接收缓存接近满时，接收端应该有方法将发送端暂停发送，直 到它的数据传输速度重新赶上发送端数据发送速度或有缓存可使用，这就是流控。 Q n 通常来讲，有两种方法来实现流控。它们是软件流控和硬件流控。M35 模块两种流控功能都支持。在 e 客户应用中，尤其多路复用（AT+CMUX）过程中，建议选择硬件流控。 fid M35 默认流控关闭。 n 1.5.1. 软件流控 Co 软件流控发送不同的字符去暂停（XOFF，十进制 19）和恢复（XON，十进制 17）数据流。它适用于 仅仅有三根线的串口通信。 M35 默认的流控关闭。软件流控需要通过下面的 AT 命令进行配置： AT+IFC=1,1 由于该配置不自动保存，若希望重启后仍保持有效，需通过 AT&W 保存到用户配置表中。同时，确保 所使用的串口通讯工具（例如：超级终端）是否支持软件流控。 上海移远通信技术有限公司 13 / 250 M35 AT 命令手册 备注 当有二进制数据发送或接收时，软件流控不应该被采用。因为 DTE 可能把二进制数据当做软件流控字符。 1.5.2. 硬件流控 M35 默认流控关闭，如果要使用硬件（RTS/CTS）流控，需要通过下面的 AT 命令进行配置： AT+IFC=2,2 该配置不支持自动保存，若希望重启后有效，则需要设置 AT+IFC=2, 2 后执行 AT&W 进行保存。 硬件流控通过 RTS/CTS 信号来实现。当接收缓存快满的时候，模块把 CTS 信号设置为无效，数据传 CQouneficdteenl tial 输被暂停。当模块的接收缓存可以接收更多数据时，CTS信号被重新设置为有效。 上海移远通信技术有限公司 14 / 250 M35 AT 命令手册 2 AT 命令详解 2.1. AT 命令格式 测试命令 AT+=? 该命令用于查询设置命令或内部程序设置的参数及其参数值范围 查询命令 设置命令 执行命令 AT+? 该命令用于查询参数的当前值 AT+= 该命令用于设置用户自定义的参数值 AT+ 该命令用于读出 GSM 模块内部程序所控制的不可变参数 ctel l 2.2. ATI 显示产品 ID 信息 ue tia 该命令用于显示产品 ID 信息，TA 上报一行或多行制造商信息及软件版本信息。 Q n 语法 e ATI 显示产品 ID 信息 执行命令 fid ATI 响应 Quectel_Ltd Quectel_M35 Revision: M35FAR01A01 Con 最大响应时间 OK 300ms 参考 V.25ter 上海移远通信技术有限公司 15 / 250 M35 AT 命令手册 2.3. AT+GMI 请求制造商 ID 信息 该命令用于请求制造商 ID 信息，TA 上报一行或多行让用户识别 TA 制造商的文本信息。 语法 AT+GMI 请求制造商 ID 信息 测试命令 响应 AT+GMI=? OK 执行命令 响应 AT+GMI Quectel_Ltd l 最大响应时间 te 参考 V.25ter Quectel_M35 Revision: MTK 0828 OK 300ms uec tial 2.4. AT+GMM 请求 TA 制造商和型号信息 Q n 该命令用于请求 TA 制造商和型号信息，TA 上报一行或多行设备制造商和型号的信息。 e 语法 fid AT+GMM 请求 TA 制造商和型号信息 测试命令 响应 n AT+GMM=? OK o 执行命令 响应 C AT+GMM Quectel_M35 最大响应时间 参考 V.25ter OK 300ms 上海移远通信技术有限公司 16 / 250 M35 AT 命令手册 2.5. AT+GMR 请求 TA 软件版本信息 该命令用于请求 TA 软件版本信息，TA 上报一行或多行软件版本信息。 语法 AT+GMR 请求 TA 软件版本信息 测试命令 响应 AT+GMR=? OK 执行命令 响应 AT+GMR Revision: M35FAR01A01 最大响应时间 参考 l V.25ter OK 300ms cte l 2.6. AT+GOI 请求全球目标识别 ID ue tia 该命令用于请求全球目标识别 ID，TA 上报一行或多行设备标识信息（该设备基于 ISO 系统注册的唯 Q n 一设备标识）。 e 语法 fid AT+GOI 请求全球目标识别 ID 测试命令 响应 AT+GOI=? OK n 执行命令 响应 o AT+GOI M35 C OK 最大响应时间 300ms 参考 V.25ter 上海移远通信技术有限公司 17 / 250 M35 AT 命令手册 2.7. AT+CGMI 请求制造商 ID 信息 该命令用于请求制造商 ID 信息，TA 上报一行或多行让用户识别 TA 制造商的文本信息。 语法 AT+CGMI 请求制造商 ID 信息 测试命令 响应 AT+CGMI=? OK 执行命令 响应 AT+CGMI Quectel_Ltd l 最大响应时间 te 参考 GSM07.07 uec tial 备注 功能同 AT+GMI。 Quectel_M35 Revision: MTK 0828 OK 300ms Q fiden 2.8. AT+CGMM 请求 TA 制造商和型号信息 该命令用于请求 TA 制造商和型号信息，TA 上报一行或多行设备制造商和型号的信息。 on 语法 C AT+CGMM 请求 TA 制造商和型号信息 测试命令 响应 AT+CGMM=? OK 执行命令 响应 AT+CGMM Quectel_M35 最大响应时间 OK 300ms 上海移远通信技术有限公司 18 / 250 参考 GSM07.07 备注 功能同 AT+GMM。 M35 AT 命令手册 2.9. AT+CGMR 请求 TA 软件版本信息 该命令用于请求 TA 软件版本信息，TA 上报一行或多行软件版本信息。 语法 l AT+CGMR 请求 TA 软件版本信息 测试命令 te AT+CGMR=? c l 执行命令 AT+CGMR 响应 OK 响应 Revision: M35FAR01A01 ue tia 最大响应时间 Q n 参考 e GSM07.07 OK 300ms fid 备注 Con 功能同 AT+GMR。 2.10. AT+GSN 请求 TA 序列号（IMEI） 该命令用于请求 TA 序列号，TA 上报 ME 设备的 IMEI 号（国际移动台设备识别码）。 上海移远通信技术有限公司 19 / 250 M35 AT 命令手册 语法 AT+GSN 请求 TA 序列号（IMEI） 测试命令 AT+GSN=? 执行命令 AT+GSN 响应 OK 响应 OK 最大响应时间 300ms 参考 GSM07.07 参数 l IMEI 号（国际移动台设备识别码） cte l 备注 ue tia 每台ME设备的序列号（IMEI）不同。 Q en 2.11. AT+CGSN 请求 TA 序列号（IMEI） fid 该命令用于请求 TA 序列号，TA 上报 ME 设备的 IMEI 号（国际移动台设备识别码）。 n 语法 o AT+CGSN 请求 TA 序列号（IMEI） C 测试命令 响应 AT+CGSN=? OK 执行命令 响应 AT+CGSN 最大响应时间 参考 GSM07.07 OK 300ms 上海移远通信技术有限公司 20 / 250 参数 IMEI 号（国际移动台设备识别码） 备注 1. 每台 ME 设备的序列号（IMEI）不同； 2. 功能同 AT+GSN。 M35 AT 命令手册 2.12. AT+QGSN 请求 TA 序列号（IMEI） 该命令用于请求 TA 序列号，TA 上报 ME 设备的 IMEI 号（国际移动台设备识别码）。 l 语法 te AT+QGSN 请求 TA 序列号（IMEI） c l 测试命令 响应 AT+QGSN=? OK ue tia 执行命令 响应 AT+QGSN +QGSN: Q en 最大响应时间 参考 fid Quectel OK 300ms n 参数 Co IMEI 号（国际移动台设备识别码） 备注 1. 每台 ME 设备的序列号（IMEI）不同； 2. 功能同 AT+GSN 和 AT+CGSN。 上海移远通信技术有限公司 21 / 250 M35 AT 命令手册 2.13. AT&F 设置所有 TA 参数为出厂配置 该命令可把 TA 部分配置当前参数设置为制造商的默认配置。所有 GPRS 相关应用参数配置不被 AT&F 影响。 语法 AT&F 设置所有 TA 参数为出厂配置 执行命令 响应 AT&F[] OK 最大响应时间 300ms 参考 V.25ter l 参数 cte l 数字参数 0 返回当前配置参数及参数值 ue tia 备注 1. 所有相关参数恢复制造商默认配置，可见表 3: AT&F 影响到的 AT 命令及参数； Q n 2. AT&F 操作影响的部分参数可以通过 AT&W 进行保存，ATZ 恢复为缺省配置； 3. 可通过 AT&W 保存 AT&F 恢复出厂默认配置，见表 4: AT&W 影响到的 AT 命令及参数； e 4. 可通过 ATZ 恢复 AT&F 部分对应参数所保存的配置，见表 5: ATZ 影响到的 AT 命令及参数； fid 5. 必须在模块处于空闲状态方可进行 AT&F 操作。 n 2.14. AT&V 显示当前配置 Co 语法 AT&V 显示当前配置 执行命令 AT&V[] 响应 ACTIVE PROFILE …（参考表 6：AT&V 显示当前配置信息） 最大响应时间 OK 300ms 上海移远通信技术有限公司 22 / 250 参考 V.25ter 参数 数字参数 0 返回当前配置参数及参数值 详情请见附录表 6。 M35 AT 命令手册 2.15. AT&W 保存用户配置参数 该命令将用户设置的一些命令参数保存到非易失性存储器内。 l 语法 te AT&W 保存用户配置参数 c l 执行命令 ue tia AT&W[] 最大响应时间 参考 Q n V.25ter 响应 OK 300ms fide 参数 0 保存到用户当前配置表内 Con 备注 1. AT&W 将用户配置在重启 TA 之后保持有效； 2. 通过 AT&F 恢复 AT&W 部分对应参数的出厂默认配置； 3. 可通过 ATZ 恢复 AT&W 部分对应参数所保存的配置； 4. 必须在模块处于空闲状态方可进行 AT&W 操作； 5. AT&W 章节列举的 AT 命令，若希望模块重启后其参数保持不变，都需要通过 AT&W 保存，而 V.25， 07.05，07.07 和 GPRS 中其他大多数 AT 命令会自动保存参数，即配置后重启参数不变。 上海移远通信技术有限公司 23 / 250 M35 AT 命令手册 2.16. ATQ 设置结果码显示模式 该命令用于设置 TA 是否向 TE 发送结果码。 语法 ATQ 设置结果码显示模式 执行命令 响应 ATQ[] 当=0，返回： OK 当=1，返回： (none) 最大响应时间 参考 V.25ter 300ms tel 参数 c l 数字参数 ue tia 0 向TE发送结果码 1 结果码被抑制，不发送结果码至 TE Q n 备注 e 1. 该设置不会影响响应内的内容； fid 2. ATQ 不带参数设置时参数默认值为 0。 n 2.17. ATV 设置 TA 响应返回内容格式 Co 该命令用于设置结果码和返回结果的传送格式（数字格式或字符格式），并设置头部和尾部的内容，这 些内容是与结果码和返回结果信息一起发送。 语法 ATV 设置 TA 响应返回内容格式 执行命令 ATV[] 响应 当=0，返回： 0 当=1，返回： 上海移远通信技术有限公司 24 / 250 M35 AT 命令手册 最大响应时间 参考 V.25ter OK 300ms 参数 0 信息返回结果： 短字符型结果码： 1 信息返回结果： 短字符型结果码： 备注 l 设置 ATV0 后，返回信息（如举例中的+CSQ: 30,0）前没有回车换行，返回的结果码 OK 变成了数字 0。 cte l 举例 ue tia ATV1 OK AT+CSQ Q n +CSQ: 30, 0 e OK fid ATV0 0 AT+CSQ +CSQ: 30, 0 on 0 C 详情请见附录表 7。 2.18. ATX 设置 CONNECT 结果码格式和检测呼叫进程 使用该命令，可设置 TA 是否向 TE 发送某一个特定的结果码。 上海移远通信技术有限公司 25 / 250 语法 ATX 设置 CONNECT 结果码格式和检测呼叫进程 执行命令 响应 ATX[] OK 最大响应时间 参考 V.25ter 300ms M35 AT 命令手册 参数 l 0 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均禁用 1 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均禁用 2 进入在线数据状态时即给定连接结果码。遇忙检测禁用，可启用拨号音 3 进入在线数据状态时即给定连接结果码。拨号音检测禁用，但可启用遇忙检测 4 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均可启用（AT&F） te 备注 c l 1. ATX 不带参数设置时参数默认值为 0； ue tia 2. AT&F 恢复出厂设置参数值为 4。 Q en 2.19. ATZ 复位为缺省配置 fid 语法 ATZ 复位为缺省配置 n 执行命令 ATZ[] Co 最大响应时间 响应 OK 300ms 参考 V.25ter 参数 0 返回当前配置参数及参数值 上海移远通信技术有限公司 26 / 250 M35 AT 命令手册 备注 1. 所有相关参数恢复制造商默认配置； 2. AT&F 操作影响的部分参数可以通过 AT&W 进行保存，ATZ 恢复为缺省配置； 3. 必须在模块处于空闲状态方可进行 ATZ 操作。 2.20. AT+CFUN 设置模块功能 该命令是用来切换模块各功能模式。可用来重启 ME 或将模块在全功能，最小功能，关闭射频电路的 接收和发送等模式切换。 语法 AT+CFUN 设置模块功能 l 测试命令 AT+CFUN=? cte l 查询命令 ue tia AT+CFUN? Q n 配置命令 AT+CFUN=[,] fide 最大响应时间 参考 n GSM07.07 Co 参数 响应 +CFUN: (取值列表), (取值列表) OK 响应 +CFUN: OK 响应 OK ERROR +CME ERROR: 15s，受网络状态影响. 0 1 4 0 1 最小功能模式 全功能模式（默认） 关闭射频电路的接收和发送功能模式 在设置功能等级后，不复位立即有效 在设置功能等级后，模块复位有效 上海移远通信技术有限公司 27 / 250 M35 AT 命令手册 备注 1. 为 1 是模块会进行复位动作，此时 GSM，GPRS 网络会注销启动后重新注册； 2. 该命令操作只能在模块处于空闲状态下操作，不然会导致其他功能操作异常。 举例 举例一：设置模块最小功能模式。该命令首先注销网络，之后取消激活 SIM 卡 AT+CFUN=0 +CPIN: NOT READY OK AT+COPS? +COPS: 0 //无网络 OK l AT+CPIN? +CME ERROR: 13 //SIM 卡读取失败 te 举例二：设置模块全功能模式。该命令首先激活 SIM 卡，之后注册网络 c l AT+CFUN=1 OK ue tia +CPIN:SIMPIN AT+CPIN=1234 Q n +CPIN: READY e OK fid AT+CPIN? +CPIN: READY n OK AT+COPS? Co +COPS: 0,0,'CHINA MOBILE' //注册上网络 OK 上海移远通信技术有限公司 28 / 250 M35 AT 命令手册 2.21. AT+QPOWD 关机 语法 AT+QPOWD 关机 配置命令 当=1 时，返回： AT+QPOWD= NORMAL POWER DOWN 当=0 时，返回： OK 最大响应时间 300ms 参考 Quectel 参数 tel 0 立即关机 1 正常关机 c l 备注 ue tia 该命令操作只能在模块处于空闲状态下操作，不然会导致其他功能操作异常。 Q en 举例 AT+QPOWD=1 fid NORMAL POWER DOWN AT+QPOWD=0 Con OK //模块正常关机提示 NORMAL POWER DOWN //模块立即关机 2.22. AT+CMEE 上报移动设备错误 该命令用于启用或禁用+CME ERROR: 或+CMS ERROR: 结果码。用于指示与 ME 功能相关的错误。 语法 AT+CMEE 上报移动设备错误 测试命令 响应 上海移远通信技术有限公司 29 / 250 M35 AT 命令手册 AT+CMEE=? +CMEE: (取值列表) 查询命令 AT+CMEE? OK 响应 +CMEE: 配置命令 OK 响应 AT+CMEE= OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM07.07 l 参数 cte l 0 禁用结果码+CME ERROR: ，使能 ERROR 1 启用结果码+CME ERROR: ，使用数值型的取值（AT&F） 2 启用结果码+CME ERROR: ，使用详细描述的取值 ue tia 备注 Q n 详细结果码对照请参照表 9:+CME ERROR 错误代码列表和表 10:+CMS ERROR 错误代码列表。 fide 举例 AT+CMEE=0 OK n AT+CPIN=1234 o ERROR AT+CMEE=1 C OK //禁用结果码+CME ERROR: ，使能 ERROR //启用结果码+CME ERROR: ，使用数值型的取值 AT+CPIN? +CME ERROR: 10 AT+CMEE=2 //启用结果码+CME ERROR: ，使用详细描述的取值 OK AT+CPIN? +CME ERROR: SIM not inserted 上海移远通信技术有限公司 30 / 250 M35 AT 命令手册 2.23. AT+CSCS 选择 TE 字符集 该命令设置模块使用的字符集,以使用户终端能够在 TE 和 ME 的字符集之间正确转换字符串。 语法 AT+CSCS 选择 TE 字符集 测试命令 AT+CSCS=? 响应 +CSCS: (取值列表) OK 查询命令 响应 AT+CSCS l 配置命令 AT+CSCS= cte l 最大响应时间 ue tia 参考 GSM07.07 +CSCS: OK 响应 OK ERROR +CME ERROR: 300ms Q n 参数 nfide 'GSM' 'HEX' 'IRA' 'PCCP437' 'UCS2' '8859-1' GSM 默认字符集 十六进制，取值范围：00~FF 国际参考字符集 PC 字符集编码 16 位通用多字节编码字符集，字符串从 0000~FFFF ISO8859 拉丁 1 字符集 Co 备注 该命令操作只能在模块处于空闲状态下操作，不然会导致其他功能操作异常。 举例 AT+CSCS? +CSCS: 'GSM' //查询当前字符集 上海移远通信技术有限公司 31 / 250 OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //设置字符集为'UCS2'编码 M35 AT 命令手册 2.24. AT+GCAP 请求 TA 功能列表 语法 AT+GCAP 请求 TA 功能列表 测试命令 l AT+GCAP=? 执行命令 te AT+GCAP uec tial 最大响应时间 参考 V.25TER 响应 OK 响应 +GCAP: OK 300ms Q en 参数 Confid +CGSM 支持 GSM 功能 +FCLASS 支持 FAX 功能 上海移远通信技术有限公司 32 / 250 M35 AT 命令手册 3 串行接口控制命令 3.1. AT&C 设置 DCD 功能模式 该命令可设置 109（DCD）电路状态与远端接收线上信号检测之间的联系。 语法 AT&C 设置 DCD 功能模式 l 执行命令 AT&C[] te 最大响应时间 c l 参考 ue tia V.25ter 响应 OK 300ms 参数 Q en 0 1 DCD 线路打开 DCD 线路只在数据载波存在时打开 nfid 3.2. AT&D 设置 DTR 功能模式 Co 该命令用于在数据模式下，当 circuit108/2(DTR)从 ON 变为 OFF 状态时，TA 的响应状态。 语法 AT&D 设置 DTR 功能模式 执行命令 响应 AT&D[] OK 最大响应时间 参考 V.25ter 300ms 上海移远通信技术有限公司 33 / 250 参数 0 1 2 M35 AT 命令手册 TA 忽略 DTR 状态 DTR 由 ON 至 OFF：TA 在保持当前数据通话的同时，切换至命令模式 DTR 由 ON 至 OFF：TA 释放数据通话，切换至命令模式。当 DTR=OFF 时，为自 动应答关闭状态 3.3. AT+ICF 设置 TE-TA 帧格式 语法 AT+ICF 设置 TE-TA 帧格式 测试命令 AT+ICF=? tel 查询命令 AT+ICF? uec tial 配置命令 AT+ICF=[,parity] Q en 最大响应时间 fid 参考 V.25ter 响应 +ICF: (取值列表), (取值列表) OK 响应 +ICF: , OK 响应 OK ERROR +CME ERROR: 300ms n 参数 Co 1 8 数据位 0 奇偶校验位 2 停止位 2 8 数据位 1 奇偶校验位 1 停止位 3 8 数据位 0 奇偶校验位 1 停止位 4 7 数据位 0 奇偶校验位 2 停止位 5 7 数据位 1 奇偶校验位 1 停止位 6 7 数据位 0 奇偶校验位 1 停止位 0 奇数位 1 偶数位 3 空格 上海移远通信技术有限公司 34 / 250 备注 1. 该命令适用于命令模式； 2. 在参数中，'0 奇偶校验位'表示无奇偶校验位； 3. 若设置为无奇偶校验位，则配置被忽略。 M35 AT 命令手册 3.4. AT+IFC 设置 TE-TA 流控 在使用 V.42 差错控制的情况下，AT+IFC 可控制 DTE 和 DCE 在数据状态下的本地流控操作。 语法 AT+IFC 设置 TE-TA 流控 测试命令 l AT+IFC=? 响应 +IFC: (取值列表), (取值列表) te 查询命令 c l AT+IFC? OK 响应 +IFC: , ue tia 配置命令 Q n AT+IFC=, e 最大响应时间 fid 参考 V.25ter OK 响应 OK ERROR +CME ERROR: 300ms on 参数 C 指定 TE 接收来自 TA 数据时采用的流控方法 0 无流控（默认） 1 软件流控，不向远程 DCE 传送 DC1/DC3 字符 2 硬件流控 指定 TA 接收来自 TE 数据时采用的流控方法 0 无流控（默认） 1 软件流控 2 硬件流控 上海移远通信技术有限公司 35 / 250 备注 流量控制适用于数据模式。 M35 AT 命令手册 举例 AT+IFC=2,2 OK AT+IFC? +IFC: 2,2 //设置硬件流控 OK 3.5. AT+ILRR 设置本地速率报告 tel AT+ILRR 可设置是否从 DCE 发送中间结果码+ILRR: 到 DTE。 c l 若启用该功能，可在调制、差错控制、数据抑制报告发送之后，或最终结果码（如：CONNECT）发 送之前，发送该中间结果码。 ue tia 语法 Q n AT+ILRR 设置本地速率报告 测试命令 e AT+ILRR=? 响应 +ILRR: 取值列表 fid 查询命令 n AT+ILRR? OK 响应 +ILRR: Co 配置命令 OK 响应 AT+ILRR= OK ERROR +CME ERROR: 最大响应时间 300ms 参考 V.25ter 上海移远通信技术有限公司 36 / 250 M35 AT 命令手册 参数 0 1 禁用本地端口速率报告 启用本地端口速率报告 备注 1. 当=1 时，以下结果码会通过串口发送出来： +ILRR: 2. 为串口通讯波特率 300/1200/2400/4800/9600/14400/19200/28800/38400/57600/115200。 3.6. AT+IPR 设置 TE-TA 波特率 该命令用于设置 DTE-DCE 的波特率。在接收到其结果码后，该配置命令才生效。 tel 语法 c l AT+IPR 设置 TE-TA 波特率 测试命令 ue tia AT+IPR=? 响应 +IPR: (自适应波特率下支持的速率取值列表), ( 固定波特率下支持的速率取值列表) Q n 查询命令 e AT+IPR? OK 响应 +IPR: fid 配置命令 n AT+IPR= Co 最大响应时间 OK 响应 OK ERROR +CME ERROR: 300ms 参考 V.25ter 参数 0（自适应波特率） 75 150 上海移远通信技术有限公司 37 / 250 M35 AT 命令手册 300 600 1200 2400 4800 9600 14400 19200 28800 38400 57600 115200 备注 1. AT+IPR 默认配置为 0（自适应波特率）； l 2. 若自适应波特率功能打开，TA 会自动同步上 TE 的波特率； 3. 若设置为固定波特率，需保证 TE 和 TA 所配置的波特率相同； te 4. AT+IPR 的值不受 AT&F，ATZ 影响。但是可以通过 AT&W 保存当前配置，AT&V 显示当前配 c l 置； 5. 在多路复用模式下，不可以通过 AT+IPR 配置当前串口通讯波特率，使用 AT&W 保存操作亦无效； ue tia 6. 可以通过输入'AT'字符串确认是否返回 OK 来判断配置的波特率是否有效。 举例 Q n AT+IPR=115200 e OK fid AT&W OK AT+IPR? n +IPR: 115200 Co OK //设置固定波特率为 115200 //保存配置的固定波特率，即此时模块重启后串口通讯速率为 115200 3.6.1. 自适应波特率 DTE 与 DCE 之间的同步是为了确保 DTE 与 DCE 成功同步并使 DCE（=ME）检测到 DTE 使用的波 特率。当开启模块，串口波特率设置为自适应波特率，此时输入'用的波字符串是必要的，它允许 DCE 同 步上 DTE 波特率。在发送第一个 AT 字符前最好等待 3 至 5 秒，否则将可能返回一些不确定字符。 如果需要同时使用自适应波特率和自动应答功能，可以先在激活自适应波特率时进行 DTE-DCE 同步， 然后配置自动应答模式。 上海移远通信技术有限公司 38 / 250 M35 AT 命令手册 3.6.1.1. 自适应波特率操作限制  串行接口必须工作在 8 位数据位，无奇偶校验位和 1 位停止位的出厂默认设置；  不能使用命令'A/' ；  在自适应波特率状态下，可以通过使用字符串'AT'或者'At'（而非'aT'或'at'）同步波特率；  若希望 AT+IPR=0 设置在模块重启后仍然有效，需通过 AT&W 保存波特率配置；  当自适应波特率启用时，在波特率被同步以前，所有上报的 URC，如 RDY 等都不会被输出。 3.6.1.2.自适应波特率和 MUX 如果自适应波特率被启用，不建议切换到 MUX 模式。 l 3.6.1.3.自适应波特率和 windows 调制解调器 te 在建立 GPRS/CSD 拨号连接时，windows 调制解调器使用的波特率会被侦测到。但是一些 windows c l 调制解调器驱动程序在 GPRS 拨号结束后会将 TE 的波特率切换回默认值，这会导致 windows 调制解调器 接收不到响应。为了避免这种情况发生，不建议在启用自适应波特率的情况下去建立 GPRS/CSD 拨号。 ue tia 基于同样的原因，也不建议在启用自适应波特率的情况下使用 PC 端 FAX 应用程序去建立 FAX 连接， 如 WinFax。 Q en 备注 fid 为了确保 DCE 和 DTE 之间通讯的可靠性和避免由于波特率不确定导致的问题，强烈建议在开机后配置 为固定波特率并将设置保存，即如操作 AT+IPR=115200&W。 Con 3.7. AT+CMUX 多路复用 该命令用于设置 DTE-DCE 的波特率。在接收到其结果码后，该配置命令才生效。 语法 AT+CMUX 多路复用 测试命令 AT+CMUX=? 响应 +CMUX: ( 取 值 列 表 ),( 取 值 列 表),(取值列表),(取值列表),(取值列 表),(取值列表),(取值列表),(取值列表),(取 上海移远通信技术有限公司 39 / 250 M35 AT 命令手册 值列表) 查询命令 AT+CMUX? OK 响应 +CMUX:,0,5,127,10,3,30,10,2 配置命令 OK 响应 AT+CMUX=[[,[,[,[,[,[,[,[,]]]]]]]]] +CME ERROR: 最大响应时间 300ms 参考 GSM07.07 l 参数 te c l ue tia Q n e fid on C 复用透传机制 0 基本选择 控制通道的复用器的建立方式 0 仅适用 UIH 包文 传输速率 5 115200bit/s 最大报文大小 127 接收确认定时器，以 10ms 为单元 10 重传的最大次数 3 复用控制通道的响应定时器，以 10ms 为单元 30 唤醒响应定时器，以秒为单位 10 窗口大小，适用于有错误恢复选项的高级配置 2 备注 1. 不支持错误恢复选项的高级配置； 2. 依据当前的串口波特率，强烈建议在波特率为 115200bit/s 使用多路复用； 3. 复用传输速率复用器控制通道如下所示： 通道数 类型 DLCI 上海移远通信技术有限公司 40 / 250 None 1 2 3 4 Multiplexer Control 0 07.07 and 07.05 1 07.07 and 07.05 2 07.07 and 07.05 3 07 07 an 07.05 4 M35 AT 命令手册 CQouneficdteenl tial 上海移远通信技术有限公司 41 / 250 M35 AT 命令手册 4 状态控制命令 4.1. AT+CEER 上报移动设备错误 语法 AT+CEER 上报移动设备错误 测试命令 AT+CEER=? l 查询命令 te AT+CEER c l 最大响应时间 ue tia 参考 GSM07.07 响应 OK 响应 +CEER: , OK 300ms Q en 参数 fid 错误类型 ID 号 最后一次呼叫连接释放原因 n 备注 o 1. 及报告值参考表 11: Location ID 扩展错误报告列表； C 2. 表 11: Location ID 扩展错误报告列表提供了下列原因的扩展报告： 1) 最近一次呼叫建立失败（发起或应答）或呼叫内修改 2) 最近一次呼叫释放 举例 AT+CEER +CEER: 0,0 OK //正常状态下，查询错误报告，返回 No error (default) 上海移远通信技术有限公司 42 / 250 M35 AT 命令手册 ATD10086; OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK NO CARRIER AT+CEER +CEER: 1,16 //通话建立，对方挂断通话，查询报告错误号提示：1：Cause for protocol stack(PS) layer，16：Normal call clearing OK 4.2. AT+CPAS 模块活动状态 l 语法 te AT+CPAS 模块活动状态 c l 测试命令 ue tia AT+CPAS=? Q n 查询命令 AT+CPAS fide 最大响应时间 参考 n GSM07.07 响应 +CPAS:(取值列表) OK 响应 +CPAS: OK 300ms Co 参数 0 2 3 4 准备（ME 允许来自 TA/TE 的命令） 未知（ME 未授权响应指令） 振铃（ME 准备好接收来自 TA/TE 的命令，但正在振铃） 呼叫进行中（ME 准备好来自 TA/TE 的命令，但当前有一个呼叫正在进行） 举例 AT+CPAS +CPAS: 0 上海移远通信技术有限公司 43 / 250 M35 AT 命令手册 OK //模块处于空闲状态，=0 ATD10086; OK AT+CLCC +CLCC: 1,0,3,0,0,'10086',129,'' OK AT+CPAS +CPAS: 3 OK //模块处于呼叫振铃状态，=3 AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK l AT+CPAS +CPAS: 4 te OK //模块处于呼叫建立状态，=4 uec tial 4.3. AT+QINDRI 开启关闭 RI 引脚提示 Q n 语法 e AT+QINDRI 开启关闭 RI 引脚提示 fid 查询命令 响应 AT+QINDRI? +QINDRI: n 配置命令 Co AT+QINDRI= OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 44 / 250 参数 0 关闭 1 开启 M35 AT 命令手册 4.4. AT+QMOSTAT 开启或关闭去电呼叫状态报告 语法 AT+QMOSTAT 开启或关闭去电呼叫状态报告 测试命令 AT+QMOSTAT=? l 查询命令 AT+QMOSTAT? cte l 配置命令 ue tia AT+QMOSTAT= Q n 最大响应时间 e 参考 Quectel 响应 +QMOSTAT: (取值列表) OK 响应 +QMOSTAT: OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 Con 配置是否开启去电呼叫状态报告 0 关闭，不显示去电通话状态 1 开启，显示去电的通话状态。拨号后，呼叫响铃后显示'MO RING'，呼叫连接建立 成功后显示'MO CONNECTED' 举例 AT+QMOSTAT=1 OK ATD10086; OK 上海移远通信技术有限公司 45 / 250 MO RING MO CONNECTED //呼叫振铃，显示 MO RING //呼叫连接建立成功，显示 MO CONNECTED M35 AT 命令手册 4.5. AT+QREFUSECS 开启或关闭来短信和来电拒接功能 语法 AT+QREFUSECS 开启或关闭来短信和来电拒接功能 测试命令 响应 AT+QREFUSECS=? +QREFUSECS: (取值列表)[,(取 值列表)] l 查询命令 AT+QREFUSECS? OK 响应 +QREFUSECS: , cte l 配置命令 ue tia AT+QREFUSECS=[,] Q n 最大响应时间 参考 e Quectel OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 n 0 o 1 0 C1 不启用短信拒绝 启用短信拒绝 不启用来电拒绝 启用来电拒绝 上海移远通信技术有限公司 46 / 250 M35 AT 命令手册 4.6. AT+QIURC 初始化完成提示上报 语法 AT+QIURC 初始化完成提示上报 测试命令 AT+QIURC=? 响应 +QIURC: (取值列表) 查询命令 AT+QIURC? OK 响应 +QIURC: 配置命令 AT+QIURC= tel 最大响应时间 c l 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms ue tia 参数 Q n 0 e 1 关闭显示 开启显示 fid 备注 Con 当=1 时，模块开机初始化完成后，终端会上报 'Call Ready' 提示。 4.7. AT+QEXTUNSOL 开启关闭专有 URC 上报 语法 AT+QEXTUNSOL 开启关闭专有 URC 上报 测试命令 响应 AT+QEXTUNSOL=? +QEXTUNSOL: (取值列表) OK 上海移远通信技术有限公司 47 / 250 M35 AT 命令手册 查询命令 AT+QEXTUNSOL=, 最大响应时间 参考 Quectel 响应 OK ERROR +CME ERROR: 300ms 参数 字符串参数（字符串需要加双引号）。当前专有 URC 提示参数值 'SQ' 'FN' l 'MW' CQouneficdteential 'UR' 信号质量报告。显示信号强度和误码率（类似于 AT+CSQ），当信号值或误码率 值有变化时上报+CSQN:,提示 可用网络被禁止时有效。当返回到非注册状态时，该提示表明所有可用的 PLMN 已被禁止 SMS 等待指示。当接收到一条 SMS 时，该 SMS 会被解码并检查是否还有一条 或多条消息在等待的指示（例如，语音邮件，电子邮件，传真等）。如果有等待 指示，会上报+QMWT: ,,,,,提 示。其中表示消息存储器类型，表示消息存储的位置索引, ,,,表示相应类型的等待消息的数量（„0‟表示清 除指示，其他非„0‟值表示等待消息的数量，空白表示没有对应类型的等待消息） URC 码。根据通话状态的转换上报 URC 提示+QGURC: 。同一次状态 的转换可能上报多个 URC，其中表示当前通话状态。 : 0 当前通话被终止，至少还存在一个被保持的通话 1 开始主动拨打电话 2 主动拨打电话失败 3 主动拨打电话，对方正在振铃 4 通话被转入呼叫等待状态 5 主动拨打的电话被接通 6 通话被终止 7 通话被挂起 8 在紧急拨号模式下拨打非紧急号码 9 主动拨打的电话没有应答 10 主动拨打电话，对方忙 'BC' 电池充电报告。显示电池连接状态和充电进度（类似于 AT+CBC）报告。 显示格式为+CBCN: , 'BM' 显示频段。按+QBAND: 格式报告频段变化情况（与 AT+QBAND 类似） 'SM' 额外的 SMS 信息提示。以+TSMSINFO: 格式的 URC 显示额 外的 SMS 事件。其中是标准的 CMS 错误提示（与 AT+CMEE 命令显示的一样） 'CC' 通话信息。当有通话断开时，以+CCINFO: , 格式上报断开的通话 ID 和仍然进行的通话 ID 上海移远通信技术有限公司 48 / 250 0 关闭 1 开启 2 查询 M35 AT 命令手册 4.8. AT+QINISTAT 初始化状态查询 语法 AT+QINISTAT 初始化状态查询 测试命令 响应 AT+QINISTAT=? 执行命令 AT+QINISTAT tel 最大响应时间 参考 c l Quectel OK 响应 +QINISTAT: OK 300ms ue tia 参数 Q fiden 0 ME 初始化操作开始 1 ME 可接收执行 AT 命令 2 电话本初始化完成 3 短消息初始化完成 n 备注 Co 当=3 时，表示 SIM 卡相关可操作功能初始化完成。 4.9. AT+QNSTATUS 查询 GSM 网络状态 语法 AT+QNSTATUS 查询 GSM 网络状态 测试命令 响应 AT+QNSTATUS=? OK 上海移远通信技术有限公司 49 / 250 M35 AT 命令手册 执行命令 AT+QNSTATUS 最大响应时间 参考 Quectel 响应 +QNSTATUS: OK 300ms 参数 255 未准备好检测网络状态 0 网络状态正常 1 无可用小区 2 限制服务状态(可拨打紧急电话) tel 4.10. AT+QNITZ 同步网络时间 c l 语法 ue tia AT+QNITZ 同步网络时间 测试命令 Q n AT+QNITZ=? e 查询命令 AT+QNITZ? fid 配置命令 n AT+QNITZ= Co 最大响应时间 响应 OK 响应 +QNITZ: OK 响应 OK ERROR +CME ERROR: 300ms 参考 Quectel 参数 0 禁用同步网络时间 1 启用同步网络时间, 开启同步网络时间功能，会直接上报'+QNITZ:,' 上海移远通信技术有限公司 50 / 250 备注 该功能应用需要当地的 GSM 网络支持网络时间同步。 M35 AT 命令手册 4.11. AT+QLTS 获取最近一次的网络同步时间 语法 AT+QLTS 获取最次一次的网络同步时间 测试命令 响应 AT+QLTS=? 执行命令 AT+QLTS tel 最大响应时间 c l 参考 ue tia Quectel OK 响应 +QLTS: , OK +CME ERROR: 300ms Q n 参数 e fid 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年，月，日，小时，分钟，秒和时区（用 当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围-48~+48） Daylight Savinng Time，零时区时，格式为'04/05/06,22:10:00+08,0' n 备注 o 1. 该功能应用需要当地的 GSM 网络支持网络时间同步； C 2. 该功能必须要设置 AT+QNITZ=1 时有效。 上海移远通信技术有限公司 51 / 250 M35 AT 命令手册 4.12. AT+CTZU 网络时间同步以及更新 RTC 时间 语法 AT+CTZR 网络时间同步以及更新 RTC 时间 测试命令 响应 AT+CTZU=? +CTZU: (取值列表) 查询命令 AT+CTZU? OK 响应 +CTZU: 配置命令 AT+CTZU= l 最大响应时间 te 参考 c l Quectel OK 响应 OK +CME ERROR: 300ms ue tia 参数 Q n 0 1 e 2 3 fid 4 NITZ 时不自动更新 RTC 时间 NITZ 时自动更新 RTC 时间 NITZ 时自动更新 GMT 时间至 RTC，时区保存在 NVROM，DST 无效 NITZ 时自动更新本地时间至 RTC，时区保存在 NVROM 同=2 模式 n 备注 o 1. 该功能应用需要当地的 GSM 网络支持网络时间同步； C 2. AT+CTZU 的参数无需保存，可以自动写入 Flash。 上海移远通信技术有限公司 52 / 250 M35 AT 命令手册 4.13. AT+CTZR 网络时间同步上报 语法 AT+CTZR 网络时间同步上报 测试命令 AT+CTZR=? 响应 +CTZR: (取值列表) 查询命令 AT+CTZR? OK 响应 +CTZR: 配置命令 AT+CTZR= l 最大响应时间 te 参考 c l Quectel OK 响应 OK +CME ERROR: 300ms ue tia 参数 Q n 0 1 e 2 网络时间同步时不上报时区信息的改变 网络时间同步时上报时区信息的改变，以+CTZV: 格式上报 网络时间同步时上报时区信息的改变，以+CTZE: ,,[]格式上报 fid 4.14. AT+QSIMDET 开启或关闭 SIM 卡检测功能 on 语法 C AT+QSIMDET 开启或关闭 SIM 卡检测功能 测试命令 响应 AT+QSIMDET=? +QSIMDET: ( 取 值 列 表 ),( 取 值 列 表),(取值列表) 查询命令 AT+QSIMDET? OK 响应 +QSIMDET: ,, OK 上海移远通信技术有限公司 53 / 250 M35 AT 命令手册 配置命令 AT+QSIMDET=[,[,]] 最大响应时间 参考 Quectel 响应 OK +CME ERROR: 300ms 参数 配置是否开启 SIM 卡检测功能 0 关闭 tel 1 开启 配置 SIM 卡插入时的检测引脚电平 0 低电平 1 高电平 配置 SIM 卡检测引脚 0 配置 SIM_PRESENCE 引脚作为 SIM 卡的检测引脚 1 配置 DTR 引脚作为 SIM 卡的检测引脚 c l 备注 ue tia 1. 此命令可使用AT&W保存； 2. M35 中 SIM_PRESENCE 和 DTR 引脚是复用的，所以 M35 只支持 DTR 引脚作为 SIM 卡的检测引 Q n 脚，所以开启 SIM 卡检测功能应设置为 1。 e 举例 fid AT+QSIMDET=1,0,1 OK //配置 DTR 引脚作为 SIM 卡的检测引脚，SIM 卡插入时为 DTR 低电平 n Co +CPIN: NOT READY //SIM 卡已掉卡 +CPIN: READY //SIM 卡已插入 上海移远通信技术有限公司 54 / 250 M35 AT 命令手册 4.15. AT+QSIMSTAT SIM 卡插拔状态报告 语法 AT+QSIMSTAT SIM 卡插拔状态报告 测试命令 响应 AT+QSIMSTAT=? +QSIMSTAT: (取值列表) 查询命令 AT+QSIMSTAT? OK 响应 +QSIMDET: , 配置命令 AT+QSIMSTAT= l 最大响应时间 te 参考 c l Quectel OK 响应 OK +CME ERROR: 300ms ue tia 参数 Q n 配置是否开启 SIM 卡插拔状态上报 0 关闭 e 1 开启 SIM 卡插入状态，此参数不允许设置 fid 0 拔出 1 插入 n 备注 o 1. 当 SIM 卡插入或拔出，URC 提示：+QSIMSTAT: ,; C 2. 此命令可用 AT&W 保存。 举例 AT+QSIMSTAT? +QSIMSTAT: 0,1 //查询 SIM 卡插入状态 OK AT+QSIMDET=1,0,1 OK 上海移远通信技术有限公司 55 / 250 M35 AT 命令手册 AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 //开启 SIM 卡插拔状态上报 OK +CPIN: NOT READY +QSIMSTAT: 1,0 //SIM 卡插拔状态上报，拔出 AT+QSIMSTAT? +QSIMSTAT: 1,0 OK l te +QSIMSTAT: 1,1 //SIM 卡插拔状态上报，插入 uec tial +CPIN:READY //SIM 卡已插入 Q n 4.16. AT+QCGTIND 语音/数据呼叫结束提示 e 语法 fid AT+QCGTIND 语音/数据呼叫结束提示 测试命令 响应 n AT+QCGTIND=? +QCGTIND: (取值列表) Co 查询命令 OK 响应 AT+QCGTIND? +QCGTIND: 配置命令 AT+QCGTIND= 最大响应时间 OK 响应 OK ERROR +CME ERROR: 300ms 上海移远通信技术有限公司 56 / 250 M35 AT 命令手册 参考 Quectel 参数 配置是否开启提示语音/数据呼叫结束的 URC 到终端 0 关闭 1 开启 呼叫建立的连接类型 0 语音 1 数据 2 PPP 连接 备注 l 语音/数据呼叫结束，URC 提示：+QCGTIND:。 cte l 举例 ue tia ATD10086; OK +QCGTIND:0 //语音通话连接挂断时上报提示，=0 CQonfiden NO CARRIER 上海移远通信技术有限公司 57 / 250 M35 AT 命令手册 5 SIM 卡相关命令 5.1. AT+CIMI 请求国际移动台设备标识（IMSI） 语法 AT+CIMI 请求国际移动台设备标识（IMSI） 测试命令 响应 AT+CIMI=? OK l 执行命令 响应 AT+CIMI cte l 最大响应时间 ue tia 参考 GSM 07.07 OK 300ms Q n 参数 fide 国际移动设备标识 n 举例 AT+CIMI Co 460023210226023 //查询返回 ME 内，当前 SIM 卡的 IMSI 号 OK 5.2. AT+CLCK 设备锁定 该命令用于锁定、解锁、查询 ME 或网络设备。一般需要输入密码。当查询网络业务（=2） 状态时，只有当该业务对任何参数都是非激活状态，才返回'非激活'状态（=0）的返回结 果。当设定或查询网络设备时，该命令将被终止执行。 上海移远通信技术有限公司 58 / 250 M35 AT 命令手册 语法 AT+CLCK 设备锁定 测试命令 AT+CLCK=? 响应 +CLCK: (取值列表) OK 配置命令 响应 AT+CLCK=,[,[ 当不等于 2 且操作执行成功，返回： ,]] OK 当等于 2 且操作执行成功，返回： +CLCK: [,[ +CLCK: , class2....]] OK 最大响应时间 5s l 参考 GSM07.07 cte l 参数 CQounefidentia 'PS' PH-SIM（将 ME 锁定于 SIM 卡上)（当其他 SIM 卡插入该被锁 ME 内，ME 提示输入密 码；可以设置 ME，使之能够识别使用过的几个 SIM 卡，这样在插入这些卡后，ME 不 会提示输入密码） 'SC' SIM (SIM 卡锁) (当 ME 重新启动时 SIM 请求输入 PIN 码) 'AO' BAOC (禁止所有呼出呼叫) (请参考 GSM02.88[6] clause 1) 'OI' BOIC (禁止所有国际呼出呼叫) (请参考 GSM02.88[6] clause 1) 'OX' BOIC-exHC (禁止所有国际呼出呼叫，归属国除外) (请参考 GSM02.88[6] clause 1) 'AI' BAIC (禁止所有呼入呼叫) (请参考 GSM02.88[6] clause 2) 'IR' BIC-Roam (归属国以外漫游时，禁止所有呼入呼叫) (请参考 GSM02.88 [6] clause 2) 'AB' 禁止所有服务，仅当=0 有效(请参考 GSM02.30[19]) 'AG' 禁止所有呼出服务，仅当=0 有效(请参考 GSM02.30[19]) 'AC' 禁止所有呼入服务，仅当=0 有效(请参考 GSM02.30[19]) 'FD' SIM 卡固定拨号特点，当 ME 操作锁'FD'，此时只有'FD'内的号码可以呼叫 'PF' 将 ME 锁定到插入的第一张 SIM 卡上（当插入其他 SIM 卡，ME 提示输入密码） 'PN' 网络个性化(请参考 GSM 02.22) 'PU' 网络子集个性化(请参考 GSM 02.22) 'PP' 服务供应商个性化(请参考 GSM 02.22) 'PC' 公司个性化(请参考 GSM 02.22) 0 解锁 1 锁定 2 查询状态 密码 上海移远通信技术有限公司 59 / 250 M35 AT 命令手册 1 2 4 7 8 16 32 0 1 语音 数据 传真 短消息(默认)以外所有类别 短消息 同步数据电路 异步数据电路 未激活 激活 备注 如果 ME 内未插入 SIM 卡或 PIN 码未解，操作 AT+CLCK 锁，会返回+CME ERROR: 相关报错。 举例 l AT+CLCK='SC', 2 te +CLCK: 0 c l OK ue tia AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 Q n +CLCK: 1 //查询当前 SC 锁状态，未锁 //设置 SC 锁，密码为：1234 e OK AT+CLCK='SC',0,'1234' fid OK //查询当前 SC 锁状态，已锁 //解除 SC 锁，密码为：1234 Con 5.3. AT+CPIN 输入 PIN 使用该配置命令，可向 ME 发送操作需要的密码（SIM PIN，SIM PUK，PH-SIM PIN 等）。如果操作 返回的是 SIM PUK 或者 SIM PUK2，则为 PUK1 码或 PUK2 码，且需要写入第二个参数， 该用来取代 SIM 卡中的原有 PIN 码。 查询命令返回的字符串采用字母数字混编方式，指示是否需要密码。 上海移远通信技术有限公司 60 / 250 M35 AT 命令手册 语法 AT+CPIN 输入 PIN 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 +CPIN: OK 配置命令 响应 AT+CPIN=[,] OK ERROR 最大响应时间 参考 GSM 07.07 +CME ERROR: 5s tel 参数 c l Quefidentia READY ME 不再需要提供密码 SIM PIN ME 等待提供 SIM 卡的 PIN 码 SIM PUK ME 等待提供 SIM 卡的 PUK 码 PH_SIM PIN ME 等待提供从终端到最初 SIM 卡的密码（防盗） PH_SIM PUK ME 等待提供从终端到最初 SIM 卡的 PUK 密码 SIM PIN2 ME 等待提供 SIM 卡 PIN2（例如：当编辑 FDN 号码薄，可能返回 +CME ERROR: 17） SIM PUK2 ME 等待提供 SIM 卡的 PUK2（在执行该命令过程中可能返回+CME ERROR: 18） 原密码（字符型）（SIM 卡的 PIN 码或 PUK 密码，如：SIM PUK 或者 PH-SIM PUK） 新密码（字符型） Con 举例 AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 +CPIN: READY //查询有 PIN 码锁定 OK AT+CPIN? +CPIN: READY //输入 PIN 码 上海移远通信技术有限公司 61 / 250 M35 AT 命令手册 OK AT+CPIN? +CPIN: SIM PUK //PIN 码锁被解除 OK //查询有 PUK 码锁定 AT+CPIN='26601934','1234' +CPIN: READY OK AT+CPIN? +CPIN: READY //输入 PUK 码和新 PIN 码 OK //PUK 锁被解除 l 5.4. AT+CPWD 设备锁定 te 该命令可以修改设备锁定命令 AT+CLCK 定义的设备锁定密码。 uec tial 语法 AT+CPWD 设备锁定 Q n 测试命令 AT+CPWD=? 响应 +CPWD: (取值列表),(取值列表) fide 配置命令 AT+CPWD=,, on 最大响应时间 C 参考 OK 响应 OK ERROR +CME ERROR: 5s GSM 07.07 参数 'PS' 'SC' 'AO' PH-SIM（将 ME 锁定于 SIM 卡上)（当其他 SIM 卡插入该被锁 ME 内，ME 提示输 入密码；可以设置 ME，使之能够识别使用过的几个 SIM 卡，这样在插入这些卡后， ME 不会提示输入密码） SIM (SIM 卡锁) (当 ME 重新启动时 SIM 请求输入 PIN 码) BAOC (禁止所有呼出呼叫) (请参考 GSM02.88[6] clause 1) 上海移远通信技术有限公司 62 / 250 M35 AT 命令手册 'OI' BOIC (禁止所有国际呼出呼叫) (请参考 GSM02.88[6] clause 1) 'OX' BOIC-exHC (禁止所有国际呼出呼叫，归属国除外) (请参考 GSM02.88[6] clause1) 'AI' BAIC (禁止所有呼入呼叫) (请参考 GSM02.88[6] clause 2) 'IR' BIC-Roam (归属国以外漫游时，禁止所有呼入呼叫) (请参考 GSM02.88 [6] clause2) 'AB' 禁止所有服务，仅当=0 有效(请参考 GSM02.30[19]) 'AG' 禁止所有呼出服务，仅当=0 有效(请参考 GSM02.30[19]) 'AC' 禁止所有呼入服务，仅当=0 有效(请参考 GSM02.30[19]) 'FD' SIM 卡固定拨号特点，当 ME 操作锁'FD'，此时只有'FD'内的号码可以呼叫 'P2' SIM PIN2 字符型；与 ME 用户接口使用的设备锁密码、修改密码命令设置的密码相同 字符型；新设定的密码 整数型；表示密码最大长度 举例 AT+CPIN? l +CPIN: READY te OK AT+CPWD='SC','1234','4321' c l OK ue tia AT+CPIN? Q n +CPIN: SIM PIN e OK AT+CPIN='4321' fid +CPIN: READY OK //设置新 PIN 码为 4321 //重启模块 //重启模块或重激活 SIM 卡，会提示输入新 PIN 码解 PIN 锁 Con 5.5. AT+CRSM SIM 卡接入限制 语法 AT+CRSM SIM 卡接入限制 测试命令 AT+CRSM=? 配置命令 AT+CRSM=[,[,,,[,]]] 响应 OK 响应 +CRSM: , [,] 上海移远通信技术有限公司 63 / 250 M35 AT 命令手册 最大响应时间 参考 GSM 07.07 OK ERROR +CME ERROR: 300ms 参数 176 二进制读出 178 记录读出 l te c l ue tia , Q n 192 获得返回结果 214 二进制更新 220 记录更新 242 状态 其他参数值保留；请参考 GSM11.11 整数型；用于标识 SIM 卡中的基础数据文件 整数型；范围 0-255，ME 传送到 SIM 的参数，请参考 GSM11.11[28] 参考 参考 将写入到 SIM 卡上的信息（十六进制；请参考 AT+CSCS） 整数型；返回 0-255 SIM 卡中与该命令实际运行相关的信息，命令可能执行成功，也可 能执行失败，两种情况下这些参数都被发送给 TE，请参考 GSM11.11 前一个命令执行成功完成后返回的结果（十六进制；请参考 AT+CSCS） e 举例 fid AT+CRSM=242 +CRSM: 145, 211, '000000007F100200000000000A13000C0400838A808A' n OK //242 为 SIM 卡状态查询的指令码（参考 11.11），145 为 SW1，211 为 SW2， o '000000007F100200000000000A13000C0400838A808A'为 SIM 卡返回的 内容，可以根 C据 GSM11.11 中的相关规定来解析具体的参数 上海移远通信技术有限公司 64 / 250 M35 AT 命令手册 5.6. AT+CSIM 通用 SIM 操作 语法 AT+CSIM 通用 SIM 操作 测试命令 AT+CSIM=? 配置命令 AT+CSIM=, 响应 OK 响应 +CSIM: , OK 最大响应时间 参考 l GSM 07.07 ERROR +CME ERROR: 300ms cte l 参数 ue tia Q en 整数类型；发往 TE 的或者的字符长度（例如：原始字节数的 两倍） 字符串类型（字符串应该包含在引号内）：16 进制格式,GSM 11.11 SIM 命令从 ME 到 SIM 字符串类型（字符串应该包含在引号内）：16 进制格式,GSM 11.11 响应从 SIM 卡到命 令 fid 5.7. AT+QCSPWD 更改 PS 超级密码 on 语法 C AT+QCSPWD 更改 PS 超级密码 配置命令 响应 AT+QCSPWD=, OK ERROR 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 65 / 250 M35 AT 命令手册 参数 字符串类型；长度必须为 8 位的旧密码 字符串类型；长度必须为 8 位的新密码 备注 1. 旧密码的缺省值是'12345678'； 2. 如果模块被锁，AT+CLCK 开启后密码丢失或者状态是 PH-SIM PUK，都可以使用超级密码来解锁。 5.8. AT+CCID 显示 CCID 语法 l AT+CCID 显示 CCID te 测试命令 AT+CCID=? c l 执行命令 ue tia AT+CCID Q n 最大响应时间 参考 e Quectel 响应 OK 响应 +CCID: OK 300ms fid 参数 n 当前 SIM 卡的 CCID 号 Co 举例 AT+CCID //查询当前 SIM 卡的 CCID 号为 898600220909A0206023 +CCID: '898600220909A0206023' OK 上海移远通信技术有限公司 66 / 250 M35 AT 命令手册 5.9. AT+QCCID 显示 CCID 语法 AT+QCCID 显示 CCID 测试命令 AT+QCCID=? 执行命令 AT+QCCID 响应 OK 响应 ccid data OK 最大响应时间 参考 Quectel l 举例 te AT+QCCID c l 898600220909A0206023 ue tia OK 300ms //查询当前 SIM 卡的 ICCID 号为 898600220909A0206023 Q en 5.10. AT+QGID 获取 SIM 卡 GID fid 语法 AT+QGID 获取 SIM 卡 GID n 执行命令 Co AT+QGID 响应 +QGID: OK ERROR 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 67 / 250 参数 GID1 GID2 备注 如果 SIM 卡支持 GID，那么 GID 值将返回，否则返回 0xFF。 M35 AT 命令手册 5.11. AT+QSIMVOL 固定 SIM 卡工作电压 语法 l AT+QSIMVOL 固定 SIM 卡工作电压 te 测试命令 AT+QSIMVOL=? 响应 +QSIMVOL:(取值列表) uec tial 查询命令 AT+QSIMVOL? OK 响应 +QSIMVOL: Q n 配置命令 e AT+QSIMVOL= fid 最大响应时间 n 参考 Co Quectel OK 响应 OK ERROR +CME ERROR: 300ms 参数 0 自动选择 1.8 V 和 3.0V SIM 卡工作电压 1 固定 SIM 卡工作电压为 1.8V 2 固定 SIM 卡工作电压为 3V 上海移远通信技术有限公司 68 / 250 备注 该命令设置成功后会自动保存，模块重启后该命令才能生效。 M35 AT 命令手册 5.12. AT+QSPN 读取 SIM 卡服务运营商名称 语法 AT+QSPN 读取 SIM 卡服务运营商名称 查询命令 响应 AT+QSPN? l 最大响应时间 te 参考 Quectel +QSPN: , OK +CME ERROR: 300ms uec tial 参数 字符串类型；SIM 卡注册的服务运营商名称 Q n 0 不显示 PLMN，已经注册上 PLMN e 1 显示 PLMN fid 备注 Con 如果模块未插卡，执行则上报相关 CME ERROR。 5.13. AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数 语法 AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数 执行命令 响应 AT+QTRPIN +QTRPIN: ,,, OK 上海移远通信技术有限公司 69 / 250 M35 AT 命令手册 最大响应时间 参考 Quectel 300ms 参数 输入 PIN 码的剩余次数 输入 PIN2 码的剩余次数 输入 PUK 码的剩余次数 输入 PUK2 码的剩余次数 5.14. AT+QDSIM 双卡单待命令切换 l 语法 te AT+QDSIM 双卡单待命令切换 c l 测试命令 AT+QDSIM=? ue tia 查询命令 Q n AT+QDSIM? fide 执行命令 AT+QDSIM=[,] n 最大响应时间 参考 Co Quectel 响应 +QDSIM: (取值列表),(取值列表) OK 响应 +QDSIM: , OK 响应 OK ERROR 300ms 参数 0 选择 SIM 卡卡槽 1 1 选择 SIM 卡卡槽 2 0 DCD 引脚功能有效 1 DCD 引脚功能无效 上海移远通信技术有限公司 70 / 250 M35 AT 命令手册 备注 1. 参数设置会自动保存到 NVRAM 2. 单卡的时候建议使用 SIM 卡 1 3. 模块出厂设置的 SIM2_RST 引脚为 DCD 功能，默认的 GPIO 是高电平，VSIM2 输出电压为 2.8V, 当 使用 SIM 卡 2 的时候，DCD 引脚被占用，DCD 功能会失效 4. 切换卡有两种方式，一种是重启方式，另一种是 CFUN=0->1 切换方式 举例 1 //重启方式 AT+QDSIM? //查询 SIM 卡状态 +QDSIM: 0,0 OK AT+QDSIM=1,1 l OK //重启模块 //默认 SIM 卡 1，DCD 功能有效 //切换至 SIM2 和不允许使用 DCD 功能，VSIM2 输出电压关闭 cte l 举例2 //不重启方式 ue tia AT+QDSIM? +QDSIM: 0,1 AT+CFUN=0 Q n +CPIN: NOT READY //查询当前 SIM 卡状态 //当前 SIM 卡为 SIM 卡 1，DCD 功能失效 //切换模块至最小功能模式 e OK fid AT+QDSIM=1,1 OK AT+CFUN=1 n OK //切换模块至卡槽 2，不使用 DCD 功能 //切换模块至全功能模式 Co +CPIN: READY Call Ready //成功切换到 SIM 卡 2 上海移远通信技术有限公司 71 / 250 M35 AT 命令手册 6 网络服务命令 6.1. AT+COPS 选择营运商 语法 AT+COPS 选择营运商 测试命令 l AT+COPS=? 响应 +COPS: (取值列表, 长字母数字格式, 短字母数 字 格 式 , 数 字 格 式 ) [,,( 取 值 列 表),( 取值列表)] cte l 查询命令 ue tia AT+COPS? OK 响应 +COPS: [,[,]] Q n 配置命令 AT+COPS=[,[,]] fid 最大响应时间 参考 n GSM 07.07 OK 响应 OK ERROR +CME ERROR: 75s，受网络状态影响 Co 参数 0 未知 1 可用运营商 2 当前运运商 3 禁用运运商 字符型 表示该字符串采用字母数字型还是数字型；数字型表示 GSM 未知区标号） （请参考 GSM04.08[8]底 10.5.1.3 小节），该号码包括一个 3 位 BCD 国家代码（符 合 ITU-TE.212 Annex A[10]标准）和一个 2 位 BCD 网络代码，后者与管理有关 0 自动，字段可忽略 上海移远通信技术有限公司 72 / 250 M35 AT 命令手册 1 2 3 4 0 1 2 手动，字段不可忽略 从注册网络注销 仅设置（用于查询命令 AT+COPS?）；不尝试进行注册或注销（ 字段可忽略）；该取值不适用于查询命令的返回结果 手动/自动，字段不可忽略；如果手动选择失败，将进入自动选择模式 （=0） 长字符型（采用字母数字格式），最多 16 个字符 短字符型（采用字母数字格式），最多 8 个字符 数字型 备注 1. 配置命令选择并注册 GSM 网络营运商。设置 ME 是自动选择营运商，还是使用该命 令强制选择营运商。  当=0 时，ME 将自动尝试选择可使用的运营商。  当=1 时，ME 将强制注册选择的运营商，若该运营商无效则当前 ME 不会搜索 l 其他可用运营商，直到=0 时 ME 才会重新注册网络。如果 ME 重启后仍然在=1 下且没有 RPLMN 的话，ME 会保持在不注册网络的状态直到使用命令改变成自动注册模式。 te  当=4 时，若手动选择运营商不可用，ME 会自动选择当前网络中可用运营商继续尝试注 c l 册。 2. 该命令设置成功后会自动保存。 ue tia 举例 Q n AT+COPS=? +COPS: (2,'CHINA MOBILE','CMCC','46000'),(3,'CHINA UNICOM GSM','CU-GSM','46001') e ,,(0-4),(0-2) fid OK //列举当前所有网络营运商 AT+COPS? n +COPS: 0,0,'CHINA MOBILE' Co OK //查询用长字符型表示当前已注册的网络营运商 6.2. AT+CREG 网络注册信息 语法 AT+CREG 网络注册信息 测试命令 AT+CREG=? 响应 +CREG: (取值列表) 上海移远通信技术有限公司 73 / 250 M35 AT 命令手册 查询命令 AT+CREG? OK 响应 用 户 终端 返回 结果 码显 示状 态 ，返 回一 个整 数 ， 表 示 ME 是否已经注册。仅当=2 并且 ME 已经在网络中注册时， 返回未知信息和. +CREG: ,[,,] 配置命令 OK +CME ERROR: 响应 AT+CREG= OK 最大响应时间 参考 GSM 07.07 300ms l 参数 te uec tial Q fiden 0 禁用网络注册非请求结果码 1 启用网络注册非请求结果码+CREG: 2 启用网络注册和位置信息非请求结果码+CREG: [,,] 0 未注册；ME 当前没有搜索到要注册业务的新营运商 1 已注册，本地网 2 未注册，但 ME 正在搜索要注册业务的新营运商 3 注册被拒绝 4 未知 5 已注册，漫游 字符型：二个字节（16 进制格式）位置区编号 字符型：二个字节（16 进制格式）小区 ID n 备注 o URC 上报： C 1. 当=1 时，MT 的网络注册状态有变化，上报：+CREG: 2. 当=2 时，MT 的网络注册状态有变化或者网络 CELL 有变化上报：+CREG: [,,] 举例 AT+CREG=1 OK +CREG: 1 AT+CREG=2 //已注册 上海移远通信技术有限公司 74 / 250 OK +CREG: 1,'1878','0873' //带小区 ID 和位置区号 M35 AT 命令手册 6.3. AT+CSQ 信号质量 语法 AT+CSQ 信号质量 测试命令 响应 AT+CSQ=? 执行命令 l AT+CSQ cte l 最大响应时间 ue tia 参考 GSM 07.07 +CSQ: (取值列表),(取值列表) OK 响应 +CSQ: , OK +CME ERROR: 300ms Q n 参数 fide Con 0 小于等于-113 dB 1 -111 dBm 2...30 -109... -53 dBm 31 大于等于-51 dBm 99 未知或不可测 （百分比格式）： 0...7 RXQUA 值，参考 GSM05.08[20]章节 7.2.4 99 未知或不可测 举例 AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,0 上海移远通信技术有限公司 75 / 250 OK //查询当前 CSQ 信号值为 28，误码率为 0 M35 AT 命令手册 6.4. AT+CPOL 优选运营商列表 语法 AT+CPOL 优选运营商列表 测试命令 AT+CPOL=? 响应 +CPOL: (取值列表),(取值列表) 查询命令 l AT+CPOL? OK 响应 +CPOL: ,, [+CPOL: ,, […]] uecte tial 配置命令 AT+CPOL=[,[,]] Q n 最大响应时间 e 参考 fid GSM 07.07 OK +CME ERROR: 响应 OK ERROR +CME ERROR: 300ms 参数 on C 整数型；SIM 卡优选运营商列表中运营商的序号 0 长字符串型（采用字母数字格式）的 1 短字符串型（采用字母数字格式）的 2 数字型的 字符型；指明该格式采用字母数字混编方式还是数字方式（参考 AT+COPS） 备注 有些 SIM 卡不支持写入新的运营商列表。 上海移远通信技术有限公司 76 / 250 M35 AT 命令手册 6.5. AT+COPN 查询运营商列表 语法 AT+COPN 查询运营商列表 测试命令 AT+COPN=? 执行命令 AT+COPN 响应 OK 响应 +COPN:,[+COPN: , […]] 最大响应时间 l 参考 GSM 07.07 OK +CME ERROR: 300ms cte l 参数 ue tia 字符型；数字格式的运营商（请参考 AT+COPS） 字符型；长字符串格式（采用字母数字格式）的运营商（请参考 AT+COPS） Q n 备注 e 1. AT+COPN 命令运行结束后，返回营运商列表并输出 OK ； fid 2. AT+COPN 命令运行时，返回 OK 前不可再次运行该命令或其他命令，否则会出现异常。 Con 6.6. AT+QBAND 查询运营商列表 语法 AT+QBAND 查询运营商列表 测试命令 AT+QBAND=? 响应 +QBAND: (取值列表) 查询命令 AT+QBAND? OK 响应 +QBAND: 上海移远通信技术有限公司 77 / 250 M35 AT 命令手册 配置命令 AT+QBAND= 最大响应时间 参考 Quectel OK 响应 OK ERROR +CME ERROR: 30s，受网络状态影响 参数 ctel l 字符串参数，以下是支持的频段列表 'EGSM_MODE' 'DCS_MODE' 'PCS_MODE' 'GSM850_MODE' 'EGSM_DCS_MODE' 'GSM850_PCS_MODE' 'GSM850_EGSM_DCS_PCS_MODE' ue tia 备注 Q n 频段设置信息存放在用户不可擦写的存储区域。 fide 6.7. AT+QENG 开启或关闭工程模式 n 该命令可用于获取当前服务小区及邻近的 1~6 个小区信息。 Co 语法 AT+QENG 开启或关闭工程模式 测试命令 AT+QENG=? 响应 +QENG: (取值列表),(取值列表) 查询命令 AT+QENG? OK 响应 小区信息提示类型由参数控制： +QENG: , 上海移远通信技术有限公司 78 / 250 M35 AT 命令手册 当前服务小区信息提示： +QENG: 0,,,,,,,,,,,,,,,,, 邻近 1~6 小区信息提示： [+QENG:1,list of (,,,,, ,, ,,)相邻小区列表] OK ctel l 配置命令 ue tia AT+QENG =[,] Q n 最大响应时间 参考 e Quectel 获取载波列表： [+QENG: 2,list of ()…] BA 内的测量频点列表： [+QENG: 4,record number of the list, list of (,,)] OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 n Co 0 关闭工程模式，字段被忽略 1 开启工程模式 2 开启工程模式，并激活自动上报网络信息 0 只提示当前服务小区信息 1 显示当前服务小区信息及邻近 1~6 个小区信息 2 显示当前服务小区信息及载波列表 3 显示当前服务小区信息，邻近 1~6 个小区信息以及载波列表 4 显示当前服务小区信息，邻近 1~6 个小区信息，载波列表以及 BA 测量结果列表 移动国家码 移动网络码 位置区号码，十六进制数据 小区号，十六进制数据 BCCH 信道的绝对无线频道编号 上海移远通信技术有限公司 79 / 250 M35 AT 命令手册 基站识别码 以 dBm 为单位的接收信号等级 C1 值 C2 值 访问一个 CCH 信道时的最大发射功率等级 允许访问系统的最小接收信号等级 TCH 信道的绝对无线频道编号，'h'道的表示跳频。 时序号 MAIO 值 HSN 值 时间提前量，范围 0~63 接收质量(sub), 范围是 0~7 接收质量(full), 范围是 0~7 相邻 6 个小区的序号 1~6 频点号 备注 l 1. 当=2 时，每 5 秒自动上报 URC 提示； te 2. 参数和为十六进制数据；其他数据为十进制数据； 3. 如果未检测到区域数据，参数将被„x‟字符代替； c l 4. 如果不是检测专有模式，参数,,,,,,不显示参数 ue tia 值，以字符„x‟代替； 5. 在一个连接中，如果网络支持跳频，那么 TCH 信道是不稳定的。在这种模式下使用‟h‟进行表 示； Q n 6. 在专有模式下，当前服务小区的和不能更新，用„-1‟表示非法值进行显示。同时，和 在一定的条件下也不能更新，仍然保持在空闲模式下的值。这是因为在这种模式下，ME 不能 e 更新小区选择和重选的参数。当连接结束时，移动设备回到空闲模式，将给出正确的值； 7. 如果 TA 报告临近小区的信息，临近 6 个小区的信息将上报。如果有的小区信息无法测量，„x‟将填写 fid 在这些小区的参数中； 8. 在专有模式中,临近小区的和参数可能被测量到，并上报一个无意义的值。临近小区的 , , 和参数无法被测量，'x'将填写在所有 6 个小区的这些参数中； n 9. 命令不报告接收信号等级和接收质量，AT+CSQ 可用于获取这两个参数； 10. AT+QSPCH 可以用于在通话过程中重新获取语音信道类型(FR, HR, EFR, AMR_FR, AMR_HR)； o 11. BA 测量结果列表最多支持 32 个，若有 BCCH 值无法获取基站信息，则以'x'代替。该值仅包括 BA C 列表中的所有已测量的 BCCH 值，非整个 BA 列表。 举例 空闲模式： AT+QENG=2 OK +QENG: 0,460,00,1806,2602,64,46,-72,119,119,5,8,x,x,x,x,x,x,x 上海移远通信技术有限公司 80 / 250 M35 AT 命令手册 专有检测模式： AT+QENG=2,3 OK +QENG: 0,460,00,1806,2031,17,41,-73,-1,-1,5,8,h,7,0,24,1,0,1 +QENG: 1,1,17,-74,41,111,95,460,00,1806,2031,2,2,-74,45,110,94,460,00,1878,151,3,22,-77,40,100,84,460,00,1 806,2012,4,24,-77,45,97,81,460,00,1806,2013,5,25,-81,40,83,67,460,00,1806,2032,6,532,-92,48,-1,-1,x ,x,x,x //注：该功能模式需特殊版本支持 6.8. AT+QSCANF GSM 频率功率扫描 l 语法 te AT+QSCANF GSM 频率功率扫描 测试命令 c l AT+QSCANF=? 响应 +QSCANF: (取值列表),(取值列表) ue tia 配置命令 Q nfiden AT+QSCANF=, OK 响应 当=9999，且执行成功返回： +QSCANF: 1, CH113, -63.5 2, CH80, -64.2 4, CH22, -64.5 ….. 20, CH116, -74.2 OK o 当为指定参数值，且执行成功返回： C +QSCANF:CH, 最大响应时间 参考 Quectel 如果执行失败，返回： +CME ERROR: 300ms 上海移远通信技术有限公司 81 / 250 M35 AT 命令手册 参数 0 BAND 900 1 BAND 1800 2 BAND 1900 3 BAND 850 9999 扫描所有频段频率 0-1023 扫描指定频段频率 频率信号强度，单位 dbm 备注 进行频率功率扫描操作，需确保 ME 的 RF 功能已关闭，即 AT+CFUN=0 或 4。关于如何使用 AT+CFUN 切换功能模式状态，请参考 AT+CFUN 命令。 l 6.9. AT+QLOCKF 锁 GSM 频率 cte l 语法 ue tia AT+QLOCKF 锁GSM频率 测试命令 Q n AT+QLOCKF=? 响应 +QLOCKF: ( 取 值 列 表 ),( 取 值 列 表) ,(取值列表) fide 查询命令 AT+QLOCKF? OK 响应 +QLOCKF: n 配置命令 o AT+QLOCKF=,, OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 82 / 250 M35 AT 命令手册 参数 0 1 2 0 1 2 0-1024 0 1 关闭频锁功能 开启频锁功能 开启锁频功能并开机自动切换到上次锁定的频点 非 1900 频段小区 1900 频段小区 自动选择是否 1900 频段小区 频率信息 ME 未指定锁于一个指定频率 ME 指定锁于一个指定频率 CQouneficdteenl tial 上海移远通信技术有限公司 83 / 250 M35 AT 命令手册 7 呼叫控制命令 7.1. ATA 呼叫应答 语法 ATA 呼叫应答 执行命令 ATA uectel tial 最大响应时间 Q n 参考 e V.25ter 响应 语音呼叫并成功建立连接，响应为： OK 若不能建立连接，响应为： NO CARRIER 若无呼叫进入时操作，响应为： +CME ERROR: 1s，受网络状态影响 fid 备注 1. ATA 操作忽略同一行命令中 A 后面的附加命令； n 2. 在执行 ATA 操作过程中收到某一字符，该命令可能被中止执行。但是在建立连接的某些状态中（如： 握手状态），该命令不会被中断； Co 3. 该命令无需以终止符作为结尾。 举例 RING AT+CLCC +CLCC: 1,1,4,0,0,'02154450290',129,'' OK //语音呼叫呼入 ATA //接听语音呼叫 OK 上海移远通信技术有限公司 84 / 250 M35 AT 命令手册 7.2. ATD 移动台呼叫某一号码 该命令用于建立语音、数据或传真的主叫，还可以用于控制补充业务。 语法 ATD 移动台呼叫某一号码 执行命令 ATD[][;] 响应 若没有拨号音且（参数设置 ATX2 或者 ATX4），返回： NO DIALTONE 若遇忙占线（参数设置 ATX3 或者 ATX4），返回： uectel tial 最大响应时间 Q n 参考 V.25ter BUSY 若连接无法建立成功或对方无应答，返回： NO CARRIER 若连接成功且为语音呼叫，返回： OK 其他功能操作错误，响应为： +CME ERROR: 1s，受网络状态影响 fide 参数 Con 紧急呼叫： 拨号位字符串和可选配 V.25ter 修改量： 拨号位：0-9，*，#，+，A，B，C 以下 V.25ter 拨号修改量可忽略： ,（逗号），T，P，!，W，@ 标准的紧急呼叫号码 112（不需要 SIM 卡） GSM 修改量字符串： I 激活 CLIR（主叫用户不允许在被叫用户话机上显示自己的电话号码） i 禁止 CLIR（主叫用户允许在被叫用户话机上显示自己的电话号码） G 仅为本次呼叫激活闭合用户组请求 g 仅为本次呼叫不激活闭合用户组请求 仅用来建立语音呼叫，TA 保持命令模式不变 上海移远通信技术有限公司 85 / 250 M35 AT 命令手册 备注 1. 若在执行 ATD 过程中收到 ATH 命令，该命令可能被终止执行。但是在建立连接的某些状态（如：握 手状态），该命令不会被中止执行； 2. 参数'I'和'i'仅适用于拨号字符中无'*#'码的情况； 3. 默认为最后的号码，此号码可以使用 ATDL 来拨号； 4. 带有'*#'码的 ATD 命令将被作为语音呼叫处理，因此，该命令必须以分号';'结尾； 5. 关于结果码的设置和呼叫监控参数的详细介绍，请参考 ATX 命令； 6. ATD 命令的响应： 对于语音呼叫，可设置两种不同的响应模式：  在 TA 拨号完成后或者在呼叫建立成功后，立即返回 OK。 此设置由 AT+COLP 命令控制。出厂默认设置为 AT+COLP=0，这将使得 TA 在拨号完成后， 立即返回 OK。除此之外，TA 将返回'BUSY'，'NODIALTONE'，'NO CARRIER'。  在一个已激活的语音呼叫中，使用 ATD： 在已存在一个已激活的语音呼叫时，用户发起了第二个语音呼叫，此时第一个语音呼叫将被自 动的设置为呼叫保持状态，所有呼叫的当前状态，可以随时使用 AT+CLCC 进行查询。 l 举例 te ATD10086; c l OK //ATD 建立语音呼叫 ue tia 7.3. ATH 挂机控制 Q en 该命令可以终止当前所有的通话。 fid 语法 ATH 挂机控制 n 执行命令 ATH[0] Co 最大响应时间 响应 OK 90s，受网络状态影响 参考 V.25ter 备注 在 Circuit109（DCD）关闭后，返回 OK； 上海移远通信技术有限公司 86 / 250 M35 AT 命令手册 7.4. +++ 数据模式切换至命令模式 该命令可以将 ME 从数据模式切换至 AT 命令模式。 语法 +++ 数据模式切换至命令模式 执行命令 响应 +++ OK ERROR +CME ERROR: 最大响应时间 参考 V.25ter 300ms l 备注 te 1. 为避免'+++'被错误的识别为数据，需遵循以下注意事项： c l  '+++'输入前 T1 时间（0.5 秒）内无字符  连续输入'+++'，中间不能有其他字符；每个+间隔时间不能超过 1 秒，TCP 透传应用下每个+ ue tia 间隔不能超过20ms.  '+++'输入后 T1 时间（0.5 秒）内无字符输入 2. 切换至命令模式，否则重新进入步骤 1； Q n 3. 可通过 AT 命令 ATO，从命令模式返回数据模式。 fide 7.5. ATO 命令模式切换至数据模式 n 该命令可以将 ME 从 AT 命令模式切换至数据模式。 Co 语法 ATO 命令模式切换至数据模式 执行命令 ATO[n] 响应 TA 保持数据传输连接，从命令模式切换回数据模式： CONNECT /CONNECT 若无法恢复至数据模式： NO CARRIER 其他功能操作错误，响应为： 上海移远通信技术有限公司 87 / 250 M35 AT 命令手册 +CME ERROR: 最大响应时间 参考 V.25ter 300ms 参数 0 从 AT 命令模式切换至数据模式 备注 1. TA 从命令模式返回至数据模式 CONNECT，只有当 ATX中设置大于 0 时， 才输出； l 2. 可以是速率、差错控制等。 cte l 7.6. ATP 选择脉冲拨号 ue tia 操作ATP设置为脉冲拨号。 Q n 语法 e ATP 选择脉冲拨号 fid 执行命令 ATP 最大响应时间 n 参考 Co V.25ter 响应 OK 300ms 备注 GSM 无效。 上海移远通信技术有限公司 88 / 250 M35 AT 命令手册 7.7. ATS0 自动应答前振铃次数 该命令用于设置自动应答前的振铃次数。若设置为非零取值，呼叫指示（RING）达到设置次数后， ME 自动应答。 语法 ATS0 自动应答前振铃次数 查询命令 响应 ATS0? OK 配置命令 ATS0= 最大响应时间 l 参考 te V.25ter 响应 OK 300ms c l 参数 ue tia 0 禁用自动应答（默认） 1~255 达到指定的振铃次数后，启用自动应答 Q en 备注 fid 若值设置过高，呼叫方可能在呼叫被自动应答前停止呼叫。 n 举例 o ATS0=3 C OK //设置三次振铃后自动接听 RING RING RING //呼叫进入 //三次 RING 提示后，自动接听来电 上海移远通信技术有限公司 89 / 250 M35 AT 命令手册 7.8. ATS6 盲拨号前暂停控制 该命令用于盲拨号前暂停控制。当拨号音检测功能关闭，表示指定 DCE 在连线与拨号操作间需要 等待的秒数。 语法 ATS6 盲拨号前暂停控制 查询命令 响应 ATS6? OK 配置命令 ATS6= 最大响应时间 l 参考 te V.25ter 响应 OK 300ms c l 参数 ue tia 0-2-10 盲拨号前需要等待的秒数（默认为 2） Q en 备注 fid GSM无效。 Con 7.9. ATS7 等待呼叫建立完成时间 该命令可设置 TA 在应答或发起数据通话时，等待呼叫建立的秒数。 语法 ATS7 等待呼叫建立完成时间 查询命令 响应 ATS7? OK 上海移远通信技术有限公司 90 / 250 配置命令 ATS7= 最大响应时间 参考 V.25ter 响应 OK 300ms M35 AT 命令手册 参数 1-60-255 建立连接或释放呼叫所用的秒数 备注 1. 若 ATS0=设置的值太高，呼叫建立可能失败； 2. 确保 ATS7 与 ATS0 的正确设置，如：ATS7=20 和 ATS0=30，则呼叫建立失败； l 3. ATS7 仅用于数据连接。 cte l 7.10. ATS8 暂停拨号时间 ue tia 在拨号字符串中出现逗号拨号修改量时，使用该命令，可设置在建立到拨号网络的呼叫寻址信息信令 Q n 时，TA 暂停的秒数。 e 语法 fid ATS8 暂停拨号时间 查询命令 响应 ATS8? on 配置命令 C ATS8= OK 响应 OK 最大响应时间 300ms 参考 V.25ter 参数 0 1-2-255 拨号字符串中出现逗号时，禁止 DCE 中断 暂停的秒数 上海移远通信技术有限公司 91 / 250 备注 GSM 无效。 M35 AT 命令手册 7.11. ATS10 挂机延时 该命令可设置在 DCE 指示接收线路信号不存在后，DCE 连接到该线路的剩余时间。 语法 ATS10 挂机延时 查询命令 ATS10? tel 配置命令 ATS10= c l 最大响应时间 ue tia 参考 V.25ter Q n 参数 fide 1-15-254 响应 OK 响应 OK 300ms 以 100 毫秒为单位的时延 n 7.12. ATT 音频拨号 Co 该命令用于设置为 DTMF 音频拨号。 语法 ATT 音频拨号 执行命令 ATT 最大响应时间 响应 OK 300ms 上海移远通信技术有限公司 92 / 250 参考 V.25ter 备注 GSM 无效。 M35 AT 命令手册 7.13. AT+CSTA 选择地址类型 根据 GSM 规范，该命令可选择拨号命令（ATD）的号码类型。 语法 l AT+CSTA 选择地址类型 测试命令 te AT+CSTA=? 响应 +CSTA: (取值列表) uec tial 查询命令 AT+CSTA? OK 响应 +CSTA: Q en 最大响应时间 参考 fid GSM 07.07 OK 300ms n 参数 o 129 未知类型，默认值（IDSN 格式号码） C145 拨号字符串包含国际接入代码字符'+'（ISDN 格式号码） 161 国家号码类型（IDSN 格式号码） 其他 参考 GSM04.08[8]第 10.5.4.7 小节 上海移远通信技术有限公司 93 / 250 M35 AT 命令手册 7.14. AT+CLCC 查询当前呼叫 该命令用于查询当前 ME 对 TE 的呼叫。 语法 AT+CLCC 查询当前呼叫 测试命令 响应 AT+CLCC=? OK 执行命令 响应 AT+CLCC 如果命令成功但是没有呼叫，将不会有信息发送到 TE，只返 uectel tial 最大响应时间 Q n 参考 GSM 07.07 回 OK [+CLCC: ,,,,[, ,[,'']] [+CLCC: ,,,,[, ,[,'']] [...]]] OK 功能错误则返回： +CME ERROR: 300ms fide 参数 n Co 整数型，呼叫识别号（参考 GSM 02.30 第 4.5.5.1 小节）；该参数可被使用在 AT+CHLD 0 移动发起的呼叫 1 移动终止的呼叫 呼叫状态 0 激活中 1 保持中 2 拨号中（MO 呼叫） 3 振铃中（MO 呼叫） 4 入局呼叫（MT 呼叫） 5 等待中（MT 呼叫） 承载/电信业务 0 语音 1 数据 2 传真 上海移远通信技术有限公司 94 / 250 M35 AT 命令手册 9 未知 0 呼叫不参加多方通话（如：会议） 1 呼叫参加多方通话（如：会议） 字符型；由规定的电话号码格式 指定的字符型电话号码 129 未知类型（IDSN 格式） 145 国际号码（IDSN 格式） 举例 AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK //ME 当前存在已建立连接的主叫语音通话 l 7.15. AT+CR 业务上报控制 cte l 该命令用于控制是否将中间结果码+CR: 从 TA 返回给 TE。若返回，则该中间结果码将在连接 传输过程中的某一点上进行传输。与此同时，在传输差错控制或数据压缩报告之前，以及传输中间结果码 ue tia CONNECT 之前，TA 已经在连接传输过程中决定了所用业务的速率和质量。 语法 Q n AT+CR 业务上报控制 e 测试命令 AT+CR=? 响应 +CR: (取值列表) fid 查询命令 n AT+CR? OK 响应 +CR: Co 配置命令 OK 响应 AT+CR=[] OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 URC 提示： +CR: 上海移远通信技术有限公司 95 / 250 参数 0 禁用上报 1 启用上报 ASYNC 异步透传 SYNC 同步透传 REL ASYNC 异步非透传 REL SYNC 同步非透传 M35 AT 命令手册 7.16. AT+CRC 蜂窝结果码 该命令用于控制呼入指示或用于 PDP 上下文激活的 GPRS 网络请求是否使用扩展格式。若使用该格式， 则将使用非请求结果码+CRING: 把来电提示给 TE，而不是使用一般的铃音。 l 语法 te AT+CRC 蜂窝结果码 测试命令 c l AT+CRC=? 响应 +CRC: (取值列表) ue tia 查询命令 Q n AT+CRC? OK 响应 +CRC: e 配置命令 fid AT+CRC=[] n 最大响应时间 o 参考 C GSM 07.07 OK 响应 OK ERROR +CME ERROR: 300ms URC 提示： +CRING: 参数 0 1 禁用扩展格式 启用扩展格式 上海移远通信技术有限公司 96 / 250 M35 AT 命令手册 举例 AT+CRC=1 OK //启用扩展格式 +CRING: VOICE ATH OK AT+CRC=0 OK //语音来电提示 //禁用扩展格式 RING //语音来电提示 ATH OK l 7.17. AT+CSNS 单一编码方案 te 移动台作为被叫，建立单一编码方案的呼叫时，该命令可以设置承载或电信业务。 c l 语法 ue tia AT+CSNS 单一编码方案 测试命令 Q n AT+CSNS=? 响应 +CSNS: (取值列表) e 查询命令 fid AT+CSNS? OK 响应 +CSNS: n 配置命令 Co AT+CSNS=[] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 参数 0 1 语音 语音/传真交替模式，语音优先 上海移远通信技术有限公司 97 / 250 2 传真 3 语音/数据交替模式，语音优先 4 数据 5 语音/传真交替模式，传真优先 6 语音/数据交替模式，数据优先 7 数据跟随语音模式 M35 AT 命令手册 7.18. AT+QSFR 配置语音编码模式 语法 AT+QSFR 配置语音编码模式 测试命令 AT+QSFR=? tel 查询命令 c l AT+QSFR? ue tia 配置命令 AT+QSFR= Q en 最大响应时间 fid 参考 Quectel n 参数 Co 0 自动 响应 +QSFR: (取值列表) OK 响应 +QSFR: OK 响应 OK ERROR +CME ERROR: 300ms 1 FR 2 HR 3 EFR 4 AMR_FR 5 AMR_HR 6 FR 和 EFR，FR 优先 7 EFR 和 FR，EFR 优先 8 EFR 和 HR，EFR 优先 9 EFR 和 AMR_FR，EFR 优先 上海移远通信技术有限公司 98 / 250 10 AMR_FR 和 FR，AMR_FR 优先 11 AMR_FR 和 HR，AMR_FR 优先 12 AMR_FR 和 EFR，AMR_FR 优先 13 AMR_HR 和 FR，AMR_HR 优先 14 AMR_HR 和 HR，AMR_HR 优先 15 AMR_HR 和 EFR，AMR_HR 优先 备注 该命令配置自动保存，重启有效。 M35 AT 命令手册 7.19. AT+QSPCH 语音信道类型上报 l 语法 te AT+QSPCH 语音信道类型上报 c l 测试命令 AT+QSPCH=? ue tia 查询命令 Q n AT+QSPCH? e 配置命令 fid AT+QSPCH= n 最大响应时间 o 参考 C Quectel 响应 +QSPCH: (取值列表) OK 响应 +QSPCH:, OK 响应 OK ERROR +CME ERROR: 300ms 当语音信道类型发生变化时，URC 上报： +QSPCH: , 参数 0 关闭上报 1 开启上报 语音通道类型 0 NO SPEECH TCH 1 FR 上海移远通信技术有限公司 99 / 250 2 HR 3 EFR 4 AMR_FR 5 AMR_HR M35 AT 命令手册 7.20. AT+QDISH ATH 使能控制 语法 AT+QDISH ATH 使能控制 测试命令 AT+QDISH=? l 查询命令 AT+QDISH? cte l 配置命令 ue tia AT+QDISH= Q n 最大响应时间 e 参考 Quectel 响应 +QDISH: (取值列表) OK 响应 +QDISH: OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 Con 0 ATH 命令有效 1 ATH 命令无效 上海移远通信技术有限公司 100 / 250 M35 AT 命令手册 8 短消息相关命令 8.1. AT+CSMS 选择短消息业务 语法 AT+CSMS 选择短消息业务 测试命令 AT+CSMS=? tel 查询命令 c l AT+CSMS? ue tia 配置命令 AT+CSMS= Q fiden 最大响应时间 参考 n GSM 07.05 Co 参数 响应 +CSMS: (取值列表) OK 响应 +CSMS: ,,, OK 响应 +CSMS: ,, OK ERROR +CMS ERROR: 300ms 0 GSM 03.40 和 03.41（SMS 的 AT 命令语法与 GSM07.05 Phase 2 中的 4.7.0 版本兼 容；支持不需要新命令语法的 Phase 2+特性（比如：使用 Phase 2+新编码方案的消息 路由）） 128 PDU 模式- TPDU 仅用于发送/接收短消息 移动终止的消息 0 类型不支持 1 类型支持 移动发起的消息 上海移远通信技术有限公司 101 / 250 0 类型不支持 1 类型支持 广播类型的消息 0 类型不支持 1 类型支持 M35 AT 命令手册 8.2. AT+CMGF 配置短消息模式 该命令用于指定短消息的输入和发送的模式。 语法 AT+CMGF 配置短消息模式 测试命令 l AT+CMGF=? te 查询命令 c l AT+CMGF? ue tia 配置命令 Q n AT+CMGF=[] fide 最大响应时间 参考 GSM 07.05 Con 参数 响应 +CMGF:(取值列表) OK 响应 +CMGF: OK 响应 OK ERROR +CMS ERROR: 300ms 0 PDU 模式 1 文本模式 8.3. AT+CSCA 短消息服务中心地址 该命令用于设置 SMSC（Short Message Service Center，短消息服务中心）地址。通过该地址，可以 发送 SMS。文本模式下，发送和配置命令都可以使用该项设置。 上海移远通信技术有限公司 102 / 250 M35 AT 命令手册 PDU 模式下，发送和配置命令也可以使用该项设置，但条件是编码后的 SMSC 地址长度等于 0，编码 后的 SMSC 地址用参数表示。 语法 AT+CSCA 短消息服务中心地址 测试命令 AT+CSCA=? 查询命令 AT+CSCA? 响应 OK 响应 +CSCA: , OK 配置命令 AT+CSCA=[,] l 最大响应时间 te 参考 GSM 07.05 响应 OK ERROR +CMS ERROR: 300ms uec tial 参数 Q n GSM 04.11 RP SC 使用字符型的地址取值字段； BCD 数字（或 GSM 缺省字母字符）需转换为字符；指定的地址类型 服务中心地址格式；GSM 04.11 RP SC 使用整数型的 8 位地址类型（缺省值请参考） fide 备注 1. 输入 SMS 服务中心地址时应该使用服务供应商规定的格式； n 2. 该命令配置可通过 AT+CSAS 保存至 SIM 卡内； 3. 强烈建议使用过程中不要改写 SIM 卡的 SMS 服务中心地址。 Co 举例 AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 //配置短消息服务中心号码 OK //查询短消息服务中心号码 上海移远通信技术有限公司 103 / 250 M35 AT 命令手册 8.4. AT+CPMS 选择短消息存储器 该命令用于选择读取、存储等操作的存储器，包括，和。 语法 AT+CPMS 选择短消息存储器 测试命令 AT+CPMS=? 响应 +CPMS:( 取 值 列 表 ),( 取 值 列 表 ),( 取值列表) OK 查询命令 l AT+CPMS? 响应 +CPMS: ,,,,,,< mem3>,, te 配置命令 c l AT+CPMS=[,[,]] ue tia 最大响应时间 Q n 参考 GSM 07.05 OK 响应 OK ERROR +CMS ERROR: 300ms fide 参数 Con 读取和删除 SMS 时使用的存储器 'SM' SIM 卡 SMS 存储器 'ME' ME SMS 存储器 'MT' SIM 卡和 MESMS 存储器 存储和发送 SMS 时使用的存储器 'SM' SIM 卡 SMS 存储器 'ME' ME SMS 存储器 'MT' SIM 卡和 MESMS 存储器 若没有建立到 TE 的路由，则将接收的 SMS 存储在该存储器内（AT+CNMI） 'SM' SIM 卡 SMS 存储器 'ME' ME SMS 存储器 'MT' SIM 卡和 ME SMS 存储器 整数型；中当前 SMS 的数量 整数型；中可存储的 SMS 的数量 上海移远通信技术有限公司 104 / 250 M35 AT 命令手册 备注 SIM 卡和 ME 总共最多支持 60 条短消息，其中 SIM 卡优先分配存储空间。SIM 卡最多支持 50 条（各 SIM 的支持条数不一致），ME 最多支持 10 条。 举例 AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 OK //将短消息存储器更改为 SM AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 OK //查询当前短消息存储器配置 tel 8.5. AT+CMGD 删除短消息 c l 该命令可删除优选短消息存储器中，位置号码参数为的消息。 ue tia 语法 AT+CMGD 删除短消息 Q n 测试命令 e AT+CMGD=? 响应 +CMGD: (取值列表),() fid 配置命令 AT+CMGD=[,] Con 最大响应时间 OK 响应 OK ERROR +CMS ERROR: 取决于待删除短消息的数目 参考 GSM 07.05 参数 整数型；关联存储器支持的地址编号范围内的取值 0 删除指定的短信 1 全部删除存储器中的已读短信 2 全部删除存储器中的已读和已发送短信 上海移远通信技术有限公司 105 / 250 M35 AT 命令手册 3 全部删除存储器中的已读、已发送和未发送短信 4 全部删除存储器中的已读、未读、已发送和未发送短信 备注 如果当前存储器中没有短信，操作 AT+CMGD 删除动作，仍返回 OK。 举例 AT+CMGD=1 OK //删除当前存储器中第一条短信 AT+CMGD=1,4 OK //删除当前存储器中全部短信 l 8.6. AT+CMGL 列出优选短消息存储器中的短消息 cte l 该命令可查询优选短消息存储器中，状态值为的消息显示在 TE 中。当=0 或 缺省时，若该短消息处于'已接收未读'状态，则将其状态变为'已接收已读'。当=1 时，若该短消息 ue tia 处于'已接收未读'状态，读取之后消息状态不发生改变。 语法 Q n AT+CMGL 列出优选短消息存储器中的短消息 e 测试命令 响应 AT+CMGL=? +CMGL: (取值列表) fid 配置命令 Con AT+CMGL=[,] OK 响应 1）文本模式（AT+CMGF=1）且该命令执行成功 对于 SMS-SUBMIT 和/或 SMS-DELIVER： +CMGL: ,,,[],[][,, ][ +CMGL: ,,,[],[][,, ][...]] 对于 SMS-STATUS-REPORT： +CMGL: ,,,,[],[],,,[ 上海移远通信技术有限公司 106 / 250 M35 AT 命令手册 +CMGL: ,,,,[],[],,,[...]] 对于 SMS-COMMAND： +CMGL: ,,,[ +CMGL: , , , [...]] 最大响应时间 参考 GSM 07.05 参数 对于 CBM 存储: +CMGL:,,,,,[ +CMGL: ,,,,,< data>[...]] OK l 2）PDU 模式（AT+CMGF=0）且该命令执行成功 +CMGL:,,[], +CMGL: c l ,,[alpha], [...]] ue tia OK 3）功能相关错误： +CMS ERROR: Q n 取决于待列举短消息的数目 onfide 1）文本模式 'REC UNREAD' 已接收但未读的短消息 C'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 上海移远通信技术有限公司 107 / 250 M35 AT 命令手册 0 正常（缺省） 1 不改变指定短消息记录状态 字符型；在字母数字混编模式下，MT 电话簿记录对应的或的显示；该特征的 应用与制造商有关；所使用的字符集应与使用'选择 TE 字符集'命令 AT+CSCS 选择的 字符集相同（请参考 TS 07.07 中对该命令的定义） 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 短消息情况下：GSM 03.40 TP-User-Data 在文本模式下返回，格式定义如下： − 若指定用 GSM 03.38 缺省字母格式字符，且指定 GSM 03.40，则没有 设置 TPUser-Data-Header-Indication − 若 TE 字符集不为十六进制数据（参考 TS 07.07 中的 AT+CSCS 命令选择的 TE 字 符集）；则根据 Annex A 规则，ME/TA 将 GSM 字母格式字符转换为当前 TE 的 字符集 − 若 TE 字符集为十六进制数据，则 ME/TA 将 GSM 字母格式字符的每个 7 位字符转 换为两个 IRA 字符表示的十六进制书（如字符 P（GSM 32）作为 17（IRA 49 和 l 55）） − 若 指 定 用 8 位 或 UCS2 编 码 方 案 ， 或 指 定 GSM03.40 ； 则 设 置 te TPUser-Data-Header-Indication：ME/TA 将 GSM 字母格式字符的每个 8 位字符 转换为用两个 IRA 表示的十六进制数（如：8 位字符代表的整数 42 传给 TE 时用 c l 两个字符来表示 2A（IRA 50 和 65）） ue tia 小区广播情况下：GSM 03.41 CBM 消息内容，在文本模式下返回，格式定义如下： − 若指定用 GSM 03.38 缺省字母格式字符，则 ME/TA 将 GSM 转换成当前 TE 支持的字符 Q n − 若 TE 字符集不为十六进制数（参考 TS 07.07 中的 AT+CSCS 命令选择的 TE 字 e 符集）；则根据 Annex A 规则，ME/TA 将 GSM 字母格式字符转换为当前 TE 的 字符集 fid − 若 TE 字符集为十六进制数，则 ME/TA 将 GSM 字母格式字符的每个 7 位总字符自 己转换为两个 IRA 字符表示的十六进制数 − 若指定用 8 位或 UCS2 编码方案，或指定 GSM 03.40；则设置 n TPUser-Data-Header-Indication：ME/TA 将 GSM 字母格式字符的每个 8 位 字符 转换为用两个 IRA 表示的 16 进制数 o整数类型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文 C的长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） 整数类型；在相应存储器支持的短消息容量内的值 字符型的 GSM 03.40 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（参考 TA 07.07 中的 AT+CSCS 命令）；给定的地址类型 ISDMS 情况下：GSM 03.40 TPDU。十六进制，遵循 GSM 04.11SC 地址；ME/TA 把 TP 数据单元中每个 8 位字符转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值 为 42 的 8 位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） 广播消息情况下：使用十六进制的 GSM 03.41 TPDU 上海移远通信技术有限公司 108 / 250 M35 AT 命令手册 使用'时间—字符串'格式的 GSM 03.40 TP-Service-Center-Time-Stamp（参考） 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 整数型的 GSM 04.11 TP-Originating-Address 中的 8 位'类型—地址'字段（参考 ） 备注 若直接执行 AT+CMGL，则默认为列举当前存储单元内的全部未读短消息。 举例 AT+CMGF=1 OK //设置短信为文本模式 AT+CMGL='ALL' l +CMGL: 1,'STO UNSENT','','', This is a test from Quectel te +CMGL: 2,'STO UNSENT','','', c l This is a test from Quectel,once again. ue tia OK //列举当前存储单元中的所有短信 Q en 8.7. AT+CMGR 读取短消息 fid 该命令可将短消息存储器中，索引号为的短消息返回到 TE。当=0 或缺省时， 若该短消息处于'已接收未读'状态，则将其状态变为'已接收已读'。当=1 时，若该短消息处于'已接 收未读'状态，读取之后短消息状态不发生改变。 on 语法 C AT+CMGR 读取短消息 测试命令 响应 AT+CMGR=? OK 执行命令 AT+CMGR=[,] 响应 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-DELIVER： +CMGR: ,,[],[,,,,,< sca>,,] 上海移远通信技术有限公司 109 / 250 M35 AT 命令手册 对于 SMS-SUBMIT： +CMGR: ,,[][,,,,,[],< sca>,,] 对于 SMS-STATUS-REPORTs： +CMGR: ,,,[],[],,, 最大响应时间 参考 GSM 07.05 参数 对于 SMS-COMMANDs： +CMGR: ,,[,,[],[],[], ] 对于 CBM storage： +CMGR: l ,,,,, te 2）PDU 模式（AT+CMGF=0）且该命令执行成功： c l +CMGR: ,[], ue tia OK 3）功能相关报错： Q n +CMS ERROR: e 取决于待读取短消息的内容长度 onfid 整数类型；关联存储器支持的地址编号范围内取值 C0 正常（缺省） 1 不改变指定短消息记录状态 字符型；在字母数字混编模式下，MT 电话簿记录对应的或的显示；该特征的 应用与制造商有关；所使用的字符集应与使用'选择 TE 字符集'命令 AT+CSCS 选择的 字符集相同（请参考 TS 07.07 中对该命令的定义） 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 短消息情况下：GSM 03.40 TP-User-Data 在文本模式下返回，格式定义如下： − 若指定用 GSM 03.38 缺省字母格式字符，且指定 GSM 03.40，则 上海移远通信技术有限公司 110 / 250 M35 AT 命令手册 没有设置 TPUser-Data-Header-Indication − 若 TE 字符集不为十六进制数据（参考 TS 07.07 中的 AT+CSCS 命令选择的 TE 字 符集）；则根据 Annex A 规则，ME/TA 将 GSM 字母格式字符转换为当前 TE 的 字符集 − 若 TE 字符集为十六进制数据，则 ME/TA 将 GSM 字母格式字符的每个 7 位字符转 换为两个 IRA 字符表示的十六进制书（如字符 P（GSM 32）作为 17（IRA 49 和 55）） − 若 指 定 用 8 位 或 UCS2 编 码 方 案 ， 或 指 定 GSM03.40 ； 则 设 置 TPUser-Data-Header-Indication：ME/TA 将 GSM 字母格式字符的每个 8 位 字符 转换为用两个 IRA 表示的十六进制数（如：8 位字符代表的整数 42 传给 TE 时用 两个字符来表示 2A（IRA 50 和 65）） − 小区广播情况下：GSM 03.41 CBM 消息内容，在文本模式下返回，格式定义如下： 若指定用 GSM 03.38 缺省字母格式字符，则 ME/TA 将 GSM 转换成当前 TE 支持的字符 − 若 TE 字符集不为十六进制数（参考 TS 07.07 中的 AT+CSCS 命令选择的 TE 字符 l 集）；则根据 Annex A 规则，ME/TA 将 GSM 字母格式字符转换为当前 TE 的字 符集 te − 若 TE 字符集为十六进制数，则 ME/TA 将 GSM 字母格式字符的每个 7 位总字符自 己转换为两个 IRA 字符表示的十六进制数 c l − 若指定用 8 位或 UCS2 编码方案，或指定 GSM 03.40；则设置 ue tia TPUser-Data-Header-Indication：ME/TA 将 GSM 字母格式字符的每个 8 位字符 转换为用两个 IRA 表示的 16 进制数 取决于该命令或该命令结果码 GSM 03.38 中的 SMS 数据编码方案。（缺省值 0）或者 小区广播数据编码方案 Q n 取决于该命令结果码 GSM 03.40 SMS-DELIVER，SMS-SUBMIT（缺省值 17）， e SMS-STATUS-REPORT 或采用整数型 SMS-COMMAND（缺省值 2） 整数型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文的 fid 长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） 整数型的 GSM 03.41 CBM 消息标识 n 字符型的 GSM 03.40 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（参考 TA 07.07 o中的 AT+CSCS 命令）；给定的地址类型 CISDMS 情况下：GSM 03.40 TPDU。十六进制，遵循 GSM 04.11SC 地址；ME/TA 把 TP 数据单元中每个 8 位字符转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值 为 42 的 8 位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） 广播消息情况下：使用十六进制的 GSM 03.41 TPDU 参考 GSM03.40；TP-协议-标识（缺省值 0） GSM 04.11 中的 RP SC 地址是字符串型参数；将 BCD 数值（或缺省 GSM 默认字母 的字符）转换成 TE 当前选择字符集中的字符（参考 TS 07.07 中的 AT+CSCS 命令）； 用来指定地址类型 使用'时间—字符串'格式的 GSM03.40 TP-Service-Center-Time-Stamp（参考） PDU 模式 文本模式 说明 上海移远通信技术有限公司 111 / 250 M35 AT 命令手册 0 'REC UNREAD' 已收到但未读的短消息 1 'REC READ' 已收到且已读的短消息 2 'STO UNSENT' 已存储但未发送的短消息 3 'STO SENT' 已存储且已发送的短消息 4 'ALL' 所有短消息 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 整数型的 GSM 04.11 TP-Originating-Address 中的 8 位'类型—地址'字段（参考 ） 服务中心地址格式；GSM 04.11 RP SC 使用整数型的 8 位地址类型（缺省值请参考 ） 取决于 SMS-SUBMIT 的的设置；采用整数型（缺省值 167），或时间—字符型（参 考）的 GSM 03.40 TP-有效期 备注 l 如果当前存储器中没有短信，操作 AT+CMGR 读取短消息动作，仍返回 OK。 cte l 举例 ue tia +CMTI:'SM',3 //新短消息达到，存储在 SIM 卡位置 3 内 AT+CMGR=3 +CMGR: 'REC UNREAD','+8615021012496','','2010/09/25 15:06:37+32',145,4,0,241,'+8 Q n 613800210500',145,27 This is a test from Quectel e OK //读取当前存储器 SIM 卡中第 3 条短信 nfid 8.8. AT+CMGS 发送短消息 o 该命令可将 SMS（SMS-SUBMIT）从 TE 发送到网络层。发送成功后，短消息参考值将返回给 C TE。在接收到非请求发送状态报告结果码时，使用该取值可进行短消息识别。 语法 AT+CMGS 发送短消息 测试命令 AT+CMGS=? 配置命令 1) 文本模式（AT+CMGF=1）： AT+CMGS=[,] 响应 OK 响应 1）文本模式(AT+CMGF=1) 且发送成功： +CMGS: 上海移远通信技术有限公司 112 / 250 M35 AT 命令手册 text is entered ESC 退出发送 2）PDU 模式（AT+CMGF=0）： +CMGS= PDU is given 最大响应时间 参考 GSM 07.05 OK 2）PDU 模式(AT+CMGF=0)且发送成功： +CMGS: OK 3）功能相关报错： +CMS ERROR: 120s，受网络状态影响 参数 tel c l ue tia 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 整数型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文的 长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） 整数型的 GSM 03.40 TP-Message-Reference Q n 备注 fide 发送短消息详细操作请参考 GSM 模块短信应用指导文档。 n 举例 o 发送文本短消息，GSM 格式： AT+CMGF=1 C OK //设置文本短信模式 AT+CSCS='GSM' //设置 TE 输入字符集格式为'GSM'格式 OK AT+CMGS='15021012496' > This is a test from Quectel //输入短信内容，发送，退出 +CMGS: 247 OK 上海移远通信技术有限公司 113 / 250 M35 AT 命令手册 8.9. AT+CMGW 写短消息 该命令可将 SMS（SMS-DELIVER 或 SMS-SUBMIT）从 TE 发送到存储器，并返回已存储短 消息的存储位置参数。除非指定其他参数，否则该短消息的状态将被设置为'存储未发送'。 语法 AT+CMGW 写短消息 测试命令 响应 AT+CMGW=? OK 配置命令 响应 1）文本模式（AT+CMGF=1）： AT+CMGW=[,[,]] 文本输入 l 退出发送 1）写短消息成功，返回： +CMGW: OK 2）功能相关报错： +CMS ERROR: te 2）PDU 模式（AT+CMGF=0）： c l AT+CMGW=[,] ue tia PDU is given 最大响应时间 参考 Q n GSM 07.05 300ms fide 参数 Con 字符型的 GSM 03.40 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（参考 TA 07.07 中的 AT+CSCS 命令）；给定的地址类型 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 整数型的 GSM 04.11 TP-Originating-Address 中的 8 位'类型—地址'字段（参考 ） 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 129 未知类型（IDSN 格式号码） 145 国际号码类型（IDSN 格式号码） 整数型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文的 长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） 上海移远通信技术有限公司 114 / 250 M35 AT 命令手册 ISDMS 情况下：GSM 03.40 TPDU。十六进制，遵循 GSM 04.11SC 地址；ME/TA 把 TP 数据单元中每个 8 位字符转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值 为 42 的 8 位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） 广播消息情况下：使用十六进制的 GSM 03.41 TPDU 整数类型；关联存储器支持的地址编号范围内取值 PDU 模式 文本模式 说明 0 'REC UNREAD' 已收到但未读的短消息 1 'REC READ' 已收到且已读的短消息 2 'STO UNSENT' 已存储但未发送的短消息 3 'STO SENT' 已存储且已发送的短消息 4 'ALL' 所有短消息 备注 写短消息详细操作请参考 GSM 模块短信应用指导文档。 tel 举例 写文本短消息，GSM 格式： c l AT+CMGF=1 ue tia OK AT+CSCS='GSM' OK Q n AT+CMGW='15021012496' > This is a test from Quectel e +CMGW: 4 fid OK //设置文本短消息模式 //设置 TE 输入字符集格式为'GSM'格式 //输入短消息内容，写入，退出 n 8.10. AT+CMSS 从存储器发送短消息 Co 该命令可将短消息存储器中，位置取值参数为的消息发送到网络侧（SMS-SUBMIT 或 SMS-COMMAND）。若给定 SMS-SUBMIT 短消息的新接收地址参数，应使用该参数，而不能使用 已存储短消息的参数。发送成功后，参考值将返回给 TE。在接收到非请求发送状态报告结果码时， 可使用该命令的取值进行短消息识别。 语法 AT+CMSS 从存储器发送短消息 测试命令 响应 AT+CMSS=? OK 上海移远通信技术有限公司 115 / 250 M35 AT 命令手册 配置命令 AT+CMSS=[,[,]] 响应 1）文本模式（AT+CMGF=1）且执行成功： +CMSS: [,] OK 2）PDU 模式（ AT +CMGF=0）且执行成功： +CMSS: [,] OK 3）功能相关报错 +CMS ERROR: 最大响应时间 120s，受网络状态影响 参考 GSM 07.05 l 参数 te c l ue tia Q en fid 整数类型；关联存储器支持的地址编号范围内取值 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 129 未知类型（IDSN 格式号码） 145 国际号码类型（IDSN 格式号码） 整数型的 GSM 03.40 TP-Message-Reference '时间—字符串'格式的 GSM 03.40 TP-Service-Center-Time-Stamp（请参考） RP-ACK PDU 中的 GSM 03.40 RP-User-Data 元素；SMS 情况下，与的格式相 同，但没有 GSM 04.11 SC 地址字段；该参数应放在双引号中，与像普通的字符型参 数一样 Con 8.11. AT+CMGC 发送短消息命令 语法 AT+CMGC 发送短消息命令 测试命令 AT+CMGC=? 配置命令 1）文本模式（+CMGF=1）： 响应 OK 响应 1）文本模式（AT+CMGF=1）且执行成功： 上海移远通信技术有限公司 116 / 250 M35 AT 命令手册 AT+CMGC=[,,,,] text is entered 退出不发送 2）PDU 模式（+CMGF=0）： AT+CMGC= PDU is given +CMGC: [,] OK 2）PDU 模式（AT+CMGF=0）且执行成功： +CMGC: [,] OK 3）功能相关报错 +CMS ERROR: 最大响应时间 300ms 参考 GSM 07.05 参数 l 取决于该命令或结果码；GSM 03.40 SMS-DELIVER 的前 8 位；SMS-SUBIT（缺省值： 17）；SMS-STATUS-REPORT；或采用整数型的 SMS-COMMAND（缺省值：2） te 整数型的 GSM 03.40 TP-Command-Type（缺省值：0） c l 整数型的 GSM 03.40 TP-Protocol-Identifier（缺省值：0） 整数型的 GSM 03.40 TP-Message-Number ue tia 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 Q n 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） e 129 未知类型（IDSN 格式号码） 145 国际号码类型（IDSN 格式号码） fid 整数型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文的 长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） n ISDMS 情况下：GSM 03.40 TPDU。十六进制，遵循 GSM 04.11SC 地址；ME/TA 把 oTP 数据单元中每个 8 位字符转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值 为 42 的 8 位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） C广播消息情况下：使用十六进制的 GSM 03.41 TPDU 整数类型；关联存储器支持的地址编号范围内取值 整数型的 GSM 03.40 TP-Message-Reference '时间—字符串'格式的 GSM 03.40 TP-Service-Center-Time-Stamp（请参考） RP-ACK PDU 中的 GSM 03.40 RP-User-Data 元素；SMS 情况下，与的格式相 同，但没有 GSM 04.11 SC 地址字段；该参数应放在双引号中，与像普通的字符型参 数一样 上海移远通信技术有限公司 117 / 250 M35 AT 命令手册 8.12. AT+CNMI 新短消息指示 当 TE 处于在使用状态时（如：DTR 信号处于'ON'状态），使用配置命令，可设置新到达的短消息如何 从网络侧发送到 TE。若 TE 处于待用状态（如：DTR 信号处于'OFF'状态），短消息接收流程应该按照 GSM 03.38 的规定。 若 DTR 信号不可用或者信号状态被忽略（V.25ter 命令：AT&D0），可使用 AT+CNMI 确认流程确保短 消息的可靠传输。 '选择短消息服务'命令 AT+CSMS 应该用来检测 ME 是否支持接收 SMS 和 CBM，并决定直接发送到 TE 的短消息是否需要确认（请参考 AT+CNMI 命令）。 语法 AT+CNMI 新短消息指示 测试命令 tel AT+CNMI=? 响应 +CNMI: (取值列表),(取值列表),(取值列 表),( 取值列表),(取值列表) c l 查询命令 ue tia AT+CNMI? OK 响应 +CNMI: ,,,, Q n 配置命令 e AT+CNMI=[[,[,[,[,]]]]] OK 响应 OK ERROR +CMS ERROR: 最大响应时间 300ms 参考 n GSM 07.05 Co 参数 控制指定的非请求结果码的处理情况 0 缓冲 TA 中的非请求结果码；若 TA 结果码缓冲器已满，结果码指示可以缓冲存储在其 他存储空间或者把最久的非请求结果码指示丢弃，替换为新接收到的指示 1 当 TA-TE 间的链路被占用（比如：在线数据模式下），丢弃结果码指示，并拒绝新接 收短消息的非请求结果码。否则，直接转发给 TE 2 当 TA-TE 间的链路被占用（比如：在线数据模式下），缓冲 TA 中的非请求结果码； 当链路释放后，把所有结果码发送给 TE。否则，直接转发给 TE 3 在 TA 处于数据模式的情况下，使用特定的 TA-TE 连接技术将结果码和数据同时传给 上海移远通信技术有限公司 118 / 250 M35 AT 命令手册 TE 存储接收短消息的规则取决于数据编码方案（请参考 GSM 03.38[2]）；优选短消息存 储器命令（AT+CPMS）的设置和本取值 0 没有 SMS-DELIVER 的指示发给 TE 1 若 SMS-DELIVER 存储在 ME/TA，存储位置靠非请求结果码+CMTI: , 来提示给 TE 2 SMS-DELIVERs（除 Class2 短消息）直接发送给 TE,使用如下非请求结果码:+CMT: [],（启用 PDU 模式）或者+CMT: , [],[,,,,,,,] （启用文本模式）；以上斜体部分参数定义参见命令 AT+CSDH.Class2 短消息 指示方式同=1 3 通过使用=2 定义的非请求结果码，Class 3 的 SMS-DELIVER 短消息可直接发送 uectel tial Q en 到 TE。其他数据编码方案下的短消息显示结果均遵循=1 定义 存储接收 CBM 规则取决于数据编码方案（请参考 GSM 03.38[2]）；选择小区广播消 息类型命令 AT+CSCB 的设置和本取值 0 无 CBM 指示发送到 TE 2 收到的 CBM 使用如下格式直接发送到 TE： +CBM: （启用 PDU 模式）或者 +CBM:,,,,（启用文本模式） 3 通过使用=2 定义的非请求结果码，Class 3 的 CBM 短消息可直接发送到 TE。其 他数据编码方案下的短消息显示结果均遵循=1 定义 0 无 SMS-STATUS-REPORT 发送到 TE 1 SMS-STATUS-REPORT 短消息使用如下格式直接发送到 TE： +CDS:（启用 PDU 模式）或者 +CDS: ,,[],[],,,（启用文本模式） 0 当为 1...3 时，该命令中定义的 TA 缓存中的非请求结果码发送给 TE（在发送 之前，OK 应该被接收到） 1 当为 1…3 时，将清除该命令中定义的 TA 对非请求结果码的缓冲 fid 举例 n AT+CMGF=1 OK o AT+CSCS='GSM' C OK //设置文本短信模式 //设置 TE 输入字符集格式为'GSM'格式 AT+CNMI=2,1 //设置将短信存储到 ME 或 SIM 卡后，再给出新短信指示 OK +CMTI: 'SM',5 //新短信指示 AT+CNMI=2,2 OK //设置收到新短信，直接打印短信内容 +CMT: '+8615021012496',' ','2010/09/25 17:25:01+32',145,4,0,241,'+8613800210500',145,27 上海移远通信技术有限公司 119 / 250 This is a test from Quectel //收到新短信，直接打印短信内容 M35 AT 命令手册 8.13. AT+CRES 恢复 SMS 设置 AT+CRES 可把短消息服务设置从永久存储器恢复到当前存储器。一个 TA 可以包括几个配置号的设置。 可恢复以下命令规定的设置：  服务中心地址：AT+CSCA  设置文本格式的参数：AT+CSMP  选择小区广播消息类型：AT+CSCB（若执行） 语法 AT+CRES 恢复 SMS 设置 l 查询命令 AT+CRES=? cte l 配置命令 ue tia AT+CRES[=] Q n 最大响应时间 参考 e GSM 07.05 响应 +CRES: (取值列表) OK 响应 OK ERROR +CMS ERROR: 300ms fid 参数 Con 0-3 与制造商有关的配置号；用于存储各项设置 8.14. AT+CSAS 保存 SMS 设置 AT+CSAS 可将当前的短消息服务设置保存到永久存储器。一个 TA 可以包括几个配置号的设置。可保 存以下命令规定的设置：  服务中心地址：AT+CSCA  设置文本格式的参数：AT+CSMP  选择小区广播消息类型：AT+CSCB（若执行） 上海移远通信技术有限公司 120 / 250 M35 AT 命令手册 语法 AT+CSAS 保存 SMS 设置 查询命令 AT+CSAS=? 响应 +CSAS: (取值列表) 配置命令 OK 响应 AT+CSAS[=] OK ERROR +CMS ERROR: 最大响应时间 300ms 参考 GSM 07.05 l 参数 te 0-3 与制造商有关的配置号；用于存储各项设置 uec tial 8.15. AT+CSCB 选择小区广播消息类型 Q n AT+CSCB 可选择 ME 接收到的 CBM 类型。 e 语法 fid AT+CSCB 选择小区广播消息类型 测试命令 n AT+CSCB=? 响应 +CSCB: (取值列表) Co 查询命令 OK 响应 AT+CSCB? +CSCB: ,, 配置命令 AT+CSCB=[,mids>[,]] 最大响应时间 OK 响应 OK ERROR +CMS ERROR: 300ms 上海移远通信技术有限公司 121 / 250 参考 GSM 07.05 M35 AT 命令手册 参数 0 接收由和指定的消息类型 1 不接收由和指定的消息类型 字符型（如'0,1,5,320-478,922'）；所有可能的 CBM 消息标识的组合（请参考） 字符型（如''0-3,5'）；所有可能的数据编码方案的组合（请参考）（缺省值为空字符 串） 8.16. AT+CSDH 显示文本格式参数 l 该命令可用于控制是否在文本模式下的结果码中显示详细的头信息。 te 语法 c l AT+CSDH 显示文本格式参数 ue tia 测试命令 AT+CSDH=? 响应 +CSDH: (取值列表) Q n 查询命令 e AT+CSDH? OK 响应 +CSDH: fid 配置命令 AT+CSDH=[] Con 最大响应时间 OK 响应 OK ERROR +CMS ERROR: 300ms 参考 GSM 07.05 参数 0 不在+CMT，+CMGL，+CMGR 命令中显示、、、、和 （+CSCA 和+CSMP 命令中设置的取值），也不显示用于 SMS-DELIVER 和 SMS-SUBMIT 消息的结果码中的、或；对于+CMGR 命令结 果码中的 SMS-COMMAND，不显示、、、、以及 上海移远通信技术有限公司 122 / 250 M35 AT 命令手册 1 在结果码中显示这些取值 举例 AT+CSDH=0 OK AT+CMGR=3 +CMGR: 'REC READ','+8615021012496','','2010/09/25 15:06:37+32' This is a test from Quectel OK AT+CSDH=1 OK AT+CMGR=3 +CMGR: 'REC READ','+8615021012496', ,'2010/09/25 15:06:37+32',145,4,0,241,'+861 l 3800210500',145,27 This is a test from Quectel te OK uec tial 8.17. AT+CSMP 设置文本格式参数 Q n 文本模式下，当向网络侧发送短消息或将短消息存放在存储器中时，使用配置命令可选择需要附加参 e 数取值。除此之外，还可以用于设置从 SMSC 接收到该短消息时算起的有效期（的取值范围：0~255） fid 或定义有效期终止的绝对时间（为字符串时）。的格式由指定。若 TA 支持增强型有效期格 式（（$(EVPF)$，请参考 GSM 03.40），应该把 16 进制的编码字符串放于双引号中（请参考）。 语法 n AT+CSMP 设置文本格式参数 o 测试命令 C AT+CSMP=? 响应 +CSMP: (取值列表),(取值列表),(取值列 表),(取值列表) 查询命令 AT+CSMP? OK 响应 +CSMP: ,,, 配置命令 AT+CSMP=[[,[,[, OK 响应 OK 上海移远通信技术有限公司 123 / 250 M35 AT 命令手册 ]]]] 最大响应时间 参考 GSM 07.05 ERROR +CMS ERROR: 300ms 参数 取决于该命令或结果码；GSM 03.40 SMS-DELIVER，SMS-SUBMIT （缺省值：17）， SMS-STATUS-REPORT 的前 8 位；或采用整数型 SMS-COMMAND （缺省值：2）；在文 本模式下若值设为 49，则支持消息状态报告 取决于 SMS-SUBMIT 的的设置；采用整数型（缺省值：167），或时间字符型（参考） 的 GSM 03.40 TP-有效期 整数型；参考 GSM 03.40 TP-协议-标识（缺省值：0） 整数型；取决于该命令或该命令结果码 GSM 03.38 中的 SMS 数据编码方案 ctel l 8.18. AT+QCLASS0 接收 Class0 短信存储到当前存储器 ue tia 语法 AT+QCLASS0 接收 Class0 短信存储到当前存储器 Q n 测试命令 响应 e AT+QCLASS0=? +QCLASS0: (取值列表) fid 查询命令 AT+QCLASS0? OK 响应 +QCLASS0: on 配置命令 C AT+QCLASS0= OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 124 / 250 M35 AT 命令手册 参数 0 接收到 Class0 短信时，不存储到当前短消息存储器内 1 接收到 Class0 短信时，存储到当前短消息存储器内 举例 以文本消息为例： AT+CPMS? +CPMS: 'SM',6,50,'SM',6,50,'SM',6,50 OK AT+QCLASS0=0 OK //设置接收到 Class0 短信时，不存储到当前短消息存储器内 +CMT: '+8615021012496',,'2010/09/26 09:55:37+32' l TEST1 from Quectel //接收到 Class0 短信，MT 直接提示短消息 te AT+QCLASS0=1 OK //设置接收到 Class0 短信时，存储到当前短消息存储器内 uec tial +CMTI:'SM',7 //接收到 Class0 短信，将短消息存储在当前存储器内（参考 AT+CPMS） AT+CMGR=7 +CMGR: 'REC UNREAD','+8615021012496','','2010/09/26 09:56:17+32' Q n TEST2 from Quectel e OK fid 8.19. AT+QMGDA 删除指定类型的所有短信 on 语法 C AT+QMGDA 删除指定类型的所有短信 测试命令 响应 AT+QMGDA=? +QMGDA: (取值列表) 配置命令 AT+QMGDA= OK 响应 OK ERROR +CME ERROR: 上海移远通信技术有限公司 125 / 250 M35 AT 命令手册 最大响应时间 参考 Quectel 取决于待删除短消息的数目 参数 PDU 模式 1 删除所有已读的短消息 2 删除所有未读的短消息 3 删除所有已发送的短消息 4 删除所有未发送的短消息 5 删除所有接收到的短消息 6 删除所有短消息 文本模式 'DEL READ' 删除所有已读的短消息 l 'DEL UNREAD' 删除所有未读的短消息 'DEL SENT' 删除所有已发送的短消息 te 'DEL UNSENT' 删除所有未发送的短消息 c l 'DEL INBOX' 删除所有接收到的短消息 'DEL ALL' 删除所有短消息 Que ntia 8.20. AT+QSMSCODE 配置短消息字符集 e 语法 fid AT+QSMSCODE 配置短消息字符集 测试命令 响应 AT+QSMSCODE=? +QSMSCODE: (取值列表) Con 查询命令 OK 响应 AT+QSMSCODE? +QSMSCODE: 配置命令 AT+QSMSCODE= 最大响应时间 OK 响应 OK ERROR +CME ERROR: 300ms 上海移远通信技术有限公司 126 / 250 参考 Quectel 参数 0 NOKIA 字符集 1 SIEMENS 字符集（默认值） 2 NOKIA 字符集，将 0x11 转译成'_'，0x02 转译成'$' M35 AT 命令手册 CQouneficdteenl tial 上海移远通信技术有限公司 127 / 250 M35 AT 命令手册 9 电话本相关命令 9.1. AT+CPBS 选择电话簿存储单元 AT+CPBS 配置命令可选择电话簿存储单元，可用于其它电话簿命令。查询命令 用于返回当前选择的存储单元。 语法 l AT+CPBS 选择电话簿存储单元 测试命令 te AT+CPBS=? uec tial 查询命令 AT+CPBS? Q n 配置命令 e AT+CPBS= fid 最大响应时间 n 参考 Co GSM 07.07 响应 +CPBS: (取值列表) OK 响应 +CPBS:[,,] OK 响应 OK ERROR +CME ERROR: 300ms 参数 'MC' 'RC' 'DC' 'LA' 'BN' 'SD' 'VM' ME 最近未接号码电话簿 ME 最近接听号码电话簿 ME 最近拨号号码电话簿 最近通话号码所有列表（LND/LNM/LNR） SIM 禁拨号码电话簿 SIM 服务号码电话簿 SIM 语音信箱号码电话簿 上海移远通信技术有限公司 128 / 250 M35 AT 命令手册 'FD' SIM 固定拨号号码电话簿（此功能开启及存储容量取决于 SIM 卡） 'LD' SIM 最近拨打的号码电话簿 'ON' SIM 卡（或 ME）中的号码（MSISDN）清单（也可以使用 AT+CNUM 命令读 出该存储器中的信息） 'SM' SIM 电话簿 整数型；表示所选存储器中使用过的位置号码个数 整数型；表示所选存储器中位置号码总数 备注 SIM 最多支持 250 条电话簿记录，ME 最多支持 100 条电话簿记录。 9.2. AT+CPBW 写删电话簿记录 tel 该命令可在当前电话簿存储器的位置号码中写入电话簿记录。通过 AT+CPBS，可选择当前电 话簿存储器。写入的记录字段是与号码有关的电话号码（使用格式）和文本。若 c l 省略这些字段，则将删除电话簿记录。若为空，但给定，则记录将被写入电话簿中第一 个空闲位置。 ue tia 语法 Q n AT+CPBW 写删电话簿记录 测试命令 e AT+CPBW=? 响应 +CPBW: (取值列表),,(取值列 表), fid 配置命令 n AT+CPBW=[,,[, []]] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 参数 电话簿存储器中位置号码范围内的整数型取值 字符型；格式的电话号码 上海移远通信技术有限公司 129 / 250 M35 AT 命令手册 整数型的八位字节地址类型（请参考 GSM 04.08[8]第 10.5.4.7 小节）；当拨号字符串包括国 际接入代码字符'+'时，缺省值为 145；其他情况下，缺省值为 129 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 字符型；最大长度的字符型字段；与'选择 TE 字符集'命令 AT+CSCS 规定的字符 集相同 表示字段最大长度的整数型取值 表示字段最大长度的整数型取值 备注 1. 若当前存储单元是'MC'，'RC'，'DC'，'LA'或'LD'，,和参数必须省略， AT+CPBW 命令只支持设置删除当前电话簿的号码记录； 2. 不允许为空； 3. 形式的下面的字符必须通过退出序列进入 l GSM 字符 Seq. Seq.(hex) 注释 5C 5C 35 43 (反斜杠) te ' 22 5C 32 32 (字符串分界符) BSP 8 5C 30 38 (退格键) c l NULL 0 5C 30 30 (GSM 空) 注：„0‟（GSM 空），对于应用层软件，当它们读字符串长度的时候可能引起问题。 Que ntia 举例 AT+CSCS='GSM' e OK fid AT+CPBW=10,'15021012496',129,'QUECTEL' OK //向当前电话簿位置 10 写入新号码 AT+CPBW=10 n OK //删当前电话簿位置 10 的电话簿 Co 9.3. AT+CPBR 查询电话簿记录 该命令操作可返回位置号码范围为 ~ 的电话簿记录，该位置号码范围通过使用 AT+CPBS 从当前电话簿存储中选择。若为空，则只返回指定的电话簿。 语法 AT+CPBR 查询电话簿记录 测试命令 响应 上海移远通信技术有限公司 130 / 250 M35 AT 命令手册 AT+CPBR=? +CPBR: (取值列表), , 配置命令 AT+CPBR= [,] OK 响应 +CPBR:,,,[+C PBR: .....+CPBR: , , , ] OK ERROR +CME ERROR: 最大响应时间 取决于待读取的电话本数目 参考 GSM 07.07 参数 l te c l ue tia Q n 电话簿存储器中位置号码范围内的整数型取值 电话簿存储器中位置号码范围内的整数型取值 字符型；格式的电话号码 整数型的八位字节地址类型（请参考 GSM 04.08[8]第 10.5.4.7 小节） 字符型；最大长度的字符型字段；与'选择 TE 字符集'命令 AT+CSCS 规定的字符 集相同 表示字段最大长度的整数型取值 表示字段最大长度的整数型取值 e 备注 fid 应小于数值。 n 举例 Co AT+CSCS='GSM' OK AT+CPBR=10 +CPBR: 10,'15021012496',129,'QUECTEL' OK //查询当前电话簿位置 10 的电话簿 上海移远通信技术有限公司 131 / 250 M35 AT 命令手册 9.4. AT+CPBF 查找电话簿记录 该命令可从当前电话簿存储器中查找电话簿记录。通过 AT+CPBS，可选择当前电话簿存储器。 该字母数字混编方式的字段以字符串开始。 语法 AT+CPBF 查找电话簿记录 测试命令 AT+CPBF=? 响应 +CPBF: , 配置命令 AT+CPBF=[] uectel tial 最大响应时间 参考 Q n GSM 07.07 OK 响应 [+CPBF: , ,, [[...] +CBPF: ,,,] OK ERROR +CME ERROR: 取决于电话本的存储空间大小 e 参数 fid n o C 最大长度的字符型字段；与 '选择 TE 字符集' 命令 AT+CSCS 规定的字符集相同 电话簿存储器中位置号码范围内的整数型取值 电话簿存储器中位置号码范围内的整数型取值 字符型；格式的电话号码 整数型的八位字节地址类型（请参考 GSM 04.08[8]第 10.5.4.7 小节） 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 字符型；最大长度的字符型字段；与'选择 TE 字符集'命令 AT+CSCS 规定的字符 集相同 表示字段最大长度的整数型取值 表示字段最大长度的整数型取值 上海移远通信技术有限公司 132 / 250 备注 缺省时，返回当前电话簿存储器中所有电话簿。 M35 AT 命令手册 9.5. AT+CNUM 用户号码 AT+CNUM 返回与用户相关的 MSISDN（Mobile Station International ISDN Number），该信息可以存 储在 SIM 卡中，也可以存储在 ME 中。若用户有能满足不同业务需求的多个 MSISDN，则每个 MSISDN 将 占用单独一行返回。 语法 AT+CNUM 用户号码 测试命令 l AT+CNUM=? te 执行命令 AT+CNUM Quec ential 最大响应时间 fid 参考 GSM 07.07 响应 OK 响应 +CNUM: [],, [+CNUM: [],, [...]] OK ERROR +CME ERROR: 300ms n 参数 o 与有关，可选项，字母数字混编字符串。所用的字符集与'选择 TE 字符集'命令 CAT+CSCS 规定的相同 指定的字符型电话号码 整数型的八位字节地址类型（请参考 GSM 04.08[8]第 10.5.4.7 小节） 上海移远通信技术有限公司 133 / 250 M35 AT 命令手册 10 GPRS 相关命令 10.1. AT+CGATT GPRS 附着和分离 该命令用于将 MT 附着 GPRS 业务，或将 MT 从 GPRS 业务分离。该命令执行成功后，MT 保持 V.25ter 命令状态。若 MT 已处于请求状态，则忽略执行命令操作，且返回 OK。 当附着状态转为分离状态时，将自动去激活所有 PDP 上下文。 l 语法 te AT+CGATT GPRS 附着和分离 c l 测试命令 AT+CGATT=? 响应 +CGATT: (取值列表) ue tia 查询命令 Q n AT+CGATT? OK 响应 +CGATT: fide 配置命令 AT+CGATT= n 最大响应时间 o 参考 C GSM 07.07 OK 响应 OK ERROR +CME ERROR: 75s，受网络状态影响 参数 GPRS 附着状态 0 分离 1 附着 上海移远通信技术有限公司 134 / 250 举例 AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //GPRS 附着 //GPRS 分离 //查询 GPRS 附着状态 M35 AT 命令手册 10.2. AT+CGDCONT 定义 PDP 上下文 该命令可为 PDP 上下文定义参数，该 PDP 上下文是由本地上下文标识参数标识的。该配置命令 的特殊形式 AT+CGDCONT=将使上下文号码的取值成为未定义取值。 tel 语法 c l AT+CGDCONT 定义 PDP 上下文 测试命令 ue tia AT+CGDCONT=? 响应 +CGDCONT: ( 取 值 列 表 ),,, ,(取值列表),(取值 列表) Q en 查询命令 nfid AT+CGDCONT? OK 响应 +CGDCONT:,,,,,+CGDCONT:,,,,, … Co OK 配置命令 响应 AT+CGDCONT=[,,[ OK APN>[,[,[,]]]]] +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 135 / 250 M35 AT 命令手册 参数 1~3 数值型参数；用于指定 PDP 上下文标识。该参数对 TE-MT 接口而言是本地参数， 并且可用于其他 PDP 上下文相关命令。 'IP' （分组数据协议类型）字符型参数；用于指定分组数据协议的类型。仅支持'IP'， 互联网协议 IP（Internet Protocol）（IETF STD5）。 接入点名称；表示一个字符串参数，用于选择 GGSN 或外部分组数据网络的逻辑名称。若 该参数取值为空或省略，则需要请求签约值。 字符型参数；用于表示对于特定 PDP 上下文，MT 分配的地址空间。若该参数取值为空或 省略，则 TE 在 PDP 启动过程中提供其他取值；若不能提供其他取值，则需要请求动态地 址。即便在 PDP 启动过程中已分配地址，该命令的读出形式仍继续返回为空。使用 AT+CGPADDR 命令，可读出该分配地址。 关闭（若取值省略，则该参数为缺省值）；数值型参数；用于控制 PDP 数据压缩。 关闭（若取值省略，则该参数为缺省值）；数值型参数；用于控制 PDP 头。 举例 l AT+CGDCONT=1,'IP','CMNET' te OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' uec tial 10.3. AT+CGQREQ 请求的服务质量 Q n AT+CGQREQ 允许 MT 向网络发送 'PDP 上下文激活需求' 消息时，TE 指定一个服务质量。 e 使用配置命令，可为上下文指定一个由（本地）上下文标识参数标识的配置项。该命令的特殊形 式，即 AT+CGQREQ=，取消定义过的服务质量。 fid 语法 n AT+CGQREQ 请求的服务质量 o 测试命令 C AT+CGQREQ=? 响应 +CGQREQ:,( 取 值 列 表),(取值列表),(取值列表),(取值 列表),(取值列表) 查询命令 AT+CGQREQ? OK 响应 +CGQREQ: , , ,>reliability>, , +CGQREQ: ,,,,, … 上海移远通信技术有限公司 136 / 250 M35 AT 命令手册 配置命令 AT+CGQREQ=[,[, [,[,[,]]]]] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 参数 l te 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 整数型参数；用于指定优先级别 整数型参数；用于指定延时级别 数值型参数；用于指定处理不常见数据丢失的可靠性级别 整数型参数；用于指定峰值吞吐量级别 整数型参数；用于定义平均吞吐量级别 uec tial 10.4. AT+CGQMIN 可接受的最小服务质量 Q n AT+CGQMIN 允许 TE 指定一个可接受的最小服务质量。该配置项由 MT 检验，用于与 'PDP 上下文 激活' 消息所返回的协商配置进行比较。 fide 使用配置命令，可为上下文指定一个由（本地）上下文标识参数标识的配置项。该命令的特殊形 式，即 AT+CGQMIN=，取消定义过的可接受最小服务质量。 n 语法 o AT+CGQMIN 可接受的最小服务质量 测试命令 响应 C AT+CGQMIN=? +CGQMIN:,(取值列表),( 取 值 列 表 ),( 取 值 列 表 ),( 取 值 列 表),(取值列表) 查询命令 AT+CGQMIN? OK 响应 +CGQMIN: ,,,,,+CGQMIN: ,,,,, … 配置命令 AT+CGQMIN=[,[,< delay>[,[,[, ]]]]] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 参数 l te c l 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 整数型参数；用于指定优先级别 整数型参数；用于指定延时级别 数值型参数；用于指定处理不常见数据丢失的可靠性级别 整数型参数；用于指定峰值吞吐量级别 整数型参数；用于定义平均吞吐量级别 Que ntia 10.5. AT+CGACT PDP 上下文激活和去激活 e 该命令可激活或去激活指定的 PDP 上下文。该命令执行成功后，MT 保持 V.25ter 命令状态。若 PDP fid 上下文已处于请求状态，则该状态保持不变。当执行该命令的激活形式时，若 MT 没有附着 GPRS，MT 首 先进行 GPRS 附着，然后尝试激活指定的上下文。 n 语法 o AT+CGACT PDP 上下文激活和去激活 C 测试命令 响应 AT+CGACT=? +CGACT: (取值列表) 查询命令 AT+CGACT? OK 响应 +CGACT: ,[+CGACT:…] OK 上海移远通信技术有限公司 138 / 250 配置命令 AT+CGACT=[,] 最大响应时间 参考 GSM 07.07 响应 OK NO CARRIER +CME ERROR : 150s，受网络状态影响 M35 AT 命令手册 参数 PDP 上下文激活和去激活 0 去激活 1 激活 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT。缺省值为 1。 l 举例 te AT+CGDCONT=1,'IP','CMNET' c l OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' AT+CGACT=1,1 //PDP 激活 ue tia OK AT+CGACT=0,1 //PDP 去激活 NO CARRIER Q en 10.6. AT+CGDATA 进入数据模式 fid 该命令设置 MT 使用一个或多个 GPRS PDP 类型，执行相应的操作，在 TE 和网络间建立通信。 n MT 不处理 AT 命令中 AT+CGDATA 之后的命令。 Co 语法 AT+CGDATA 进入数据模式 测试命令 AT+CGDATA=? 响应 +CGDATA: (取值列表) 配置命令 AT+CGDATA=[,[,[,… ]]] OK 响应 OK NO CARRIER +CME ERROR : 上海移远通信技术有限公司 139 / 250 M35 AT 命令手册 最大响应时间 参考 GSM 07.07 300ms 参数 字符型参数；用于表示 TE 和 MT 之间网络建立通信时 PDP 上下文使用的 2 层协议： 'PPP' 点到点协议，为一个分组数据协议，例如 IP 服务 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 10.7. AT+CGPADDR 显示 PDP 地址 该命令可返回指定上下文标识的 PDP 地址列表。 l 语法 te AT+CGPADDR 显示 PDP 地址 c l 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (取值列表) ue tia 查询命令 Q n AT+CGPADDR= OK 响应 +CGPADDR: [, ] fide 最大响应时间 参考 n GSM 07.07 OK ERROR 300ms Co 参数 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 字符型参数；用于标识特定 PDP 上下文 MT 所获取的地址。该地址可以是静态的，也可以 是动态的。对于静止地址来说，当上下文定义后通过 AT+CGDCONT 命令设置的地址；对 于动态地址来说，在最后一次 PDP 上下文激活过程中，使用被参考的上下文定义时 所指配的地址。当地址不可用时，则省 上海移远通信技术有限公司 140 / 250 M35 AT 命令手册 举例 AT+CGDCONT=1,'IP','CMNET' OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' AT+CGACT=1,1 //激活 PDP 场景=1 OK AT+CGPADDR=1 //查询场景=1 的 PDP 地址 +CGPADDR: 1,'10.76.51.180' OK 10.8. AT+CGCLASS GPRS 移动台类别 该命令可根据指定的 GPRS 移动台类别设置 MT，使之能够进行操作。 l 语法 te AT+CGCLASS GPRS 移动台类别 c l 测试命令 响应 AT+CGCLASS=? +CGCLASS: (取值列表) ue tia 查询命令 Q n AT+CGCLASS? OK 响应 +CGCLASS: fide 配置命令 AT+CGCLASS= n 最大响应时间 o 参考 C GSM 07.07 OK 响应 OK NO CARRIER +CME ERROR : 30s，受网络状态影响 参数 字符型参数；表示 GPRS 移动台的类别（按功能的降序排列） 'B' 类别 B 'CG' 仅在 GPRS 模式下为类别 C 'CC' 仅在电路交换模式下为类别 C（最低级别） 上海移远通信技术有限公司 141 / 250 M35 AT 命令手册 10.9. AT+CGEREP 非请求 GPRS 事件上报控制 该命令可根据指定的 GPRS 移动台类别设置 MT，使之能够进行操作。 语法 AT+CGEREP 非请求 GPRS 事件上报控制 测试命令 响应 AT+CGEREP=? +CGEREP: (取值列表) OK 查询命令 响应 AT+CGEREP? l 配置命令 AT+CGEREP= cte l 最大响应时间 ue tia 参考 GSM 07.07 +CGEREP: OK 响应 OK ERROR +CME ERROR: 300ms Q n 参数 e 0 缓冲 MT 中的非请求结果码；若 MT 结果码缓冲器已满，则丢弃最旧的结果码。不转发 fid 结果 码给TE 1 当保留 MT-TE 链路时（比如：在线数据模式下），丢弃非请求结果码；否则，直接转发 给 TE n 请参考 AT+CGDCONT o 请参考 AT+CGDCONT 请参考 AT+CGDCONT C 请参考 AT+CGCLASS 备注 相关 URC 上报： +CGEV: NW DEACT , [,] +CGEV: ME DEACT , [,] +CGEV: NW DETACH +CGEV: ME CLASS 上海移远通信技术有限公司 142 / 250 M35 AT 命令手册 10.10. AT+CGREG GPRS 网络注册状态 该命令可控制关于 GPRS 注册状态一些中间结果码的显示。  当=1 并且 GPRS 注册状态发生改变，会有+CGREG : 的提示；  当=2，GPRS 注册状态发生改变且注册小区发生改变，会有+CGREG : [,,]的 提示。 语法 AT+CGREGGPRS 网络注册状态 测试命令 响应 AT+CGREG=? 查询命令 l AT+CGREG? cte l 配置命令 AT+CGREG=[] Que ntia 最大响应时间 参考 e GSM 07.07 +CGREG: (取值列表) OK 响应 +CGREG: ,[,,] OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 n Co 0 禁用网络注册非请求结果码+CGREG: 1 启用网络注册非请求结果码+CGREG: 2 启用网络注册非请求结果码+CGREG: [,,] 0 未注册；ME 当前没有搜索注册业务的新营运商 1 已注册，本地网 2 未注册，但 ME 正在搜索注册业务的新营运商 3 注册被拒绝 4 未知 5 已注册，漫游 字符型；2 位十六进制位置区代码（比如：00C3 相当于十六进制中的 195） 字符型；2 位十六进制小区编号 上海移远通信技术有限公司 143 / 250 举例 AT+CGATT=0 NO CARRIER +CGREG: 0,'1878','0873' AT+CGATT=1 OK +CGREG: 2,'1878','0873' +CGREG: 1,'1878','0873' M35 AT 命令手册 10.11. AT+CGSMS 为 MO SMS 选择业务 该命令用于在 MT 发送 MO SMS 消息时，指定业务或业务优先级别。 tel 语法 c l AT+CGSMS 为 MO SMS 选择业务 测试命令 ue tia AT+CGSMS=? 响应 +CGSMS: (取值列表) Q n 查询命令 AT+CGSMS? OK 响应 +CGSMS: fide 配置命令 AT+CGSMS=[] on 最大响应时间 C 参考 OK 响应 OK ERROR +CME ERROR: 300ms GSM 07.07 参数 使用的业务或业务优先级别 0 GPRS 1 电路交换 2 GPRS 优先（若 GPRS 不可用，则使用电路交换） 上海移远通信技术有限公司 144 / 250 3 电路交换优先（若电路交换不可用，则使用 GPRS） M35 AT 命令手册 10.12. AT+QGPCLASS 配置 GPRS 多时隙级别 语法 AT+QGPCLASS 配置 GPRS 多时隙级别 测试命令 响应 AT+QGPCLASS=? MULTISLOT CLASS: (取值列表) 查询命令 AT+QGPCLASS? tel 配置命令 AT+QGPCLASS= uec tial 最大响应时间 参考 Q n Quectel e 参数 Confid GPRS多时隙级别 OK 响应 MULTISLOT CLASS: OK 响应 OK ERROR +CME ERROR: 300ms 上海移远通信技术有限公司 145 / 250 M35 AT 命令手册 11 TCPIP 相关命令 11.1. AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 语法 AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 测试命令 响应 AT+QIOPEN=? +QIOPEN: (取值列表),(IP address range),(port l range) +QIOPEN:(取值列表),(domain name),(port range) cte l 配置命令 ue tia AT+QIOPEN=[,],/, OK 响应 如果格式正确，返回： OK 否则，返回： ERROR e 如果连接已经存在，返回 fid ALREAY CONNECT 返回 OK 后，如果连接成功，返回： [,] CONNECT OK on返回 OK 后，如果连接失败，返回： [,] CONNECT FAIL C OK、ERROR 或 ALREADY CONNECT 的超时时间为 300ms， 最大响应时间 [,] CONNECT OK 或[,] CONNECT FAIL 的 超时时间为 75s，受网络状态影响 参考 Quectel 上海移远通信技术有限公司 146 / 250 M35 AT 命令手册 参数 0~5 表明连接序号（M35F 支持 6 个 SOCKET 同时存在。当且仅 AT+QIMUX=1 时， 该参数有效。当 AT+QIMUX=0 时，该参数必须缺省（请参考 AT+QIMUX） 字符串类型；表明连接类型 'TCP' 建立 TCP 连接 'UDP' 建立 UDP 连接 字符串类型；表明远端服务器 IP 地址 远端服务器端口号 字符串类型；表明远端服务器域名地址 备注 1. 当 ME 状态（可以通过 AT+QISTAT 查询）为 IP INITIAL 或者 IP STATUS 或者 IP CLOSE 时才建 立连接。若非以上状态，需要通过操作 AT+QIDEACT 或 AT+QICLOSE 使 ME 处于以上状态才能正 常建立连接； l 2. 当 AT+QIMUX=0 时，当前已存在连接或 AT+QIMUX=1 时，指定序号也存在连接，那么再次操作 AT+QIOPEN 会返回 ALREADY CONNECT。 uecte tial 11.2. AT+QISEND 发送TCP或 UDP数据 语法 Q n AT+QISEND 发送 TCP 或者 UDP 数据 e 测试命令 响应 fid AT+QISEND=? +QISEND: n 执行命令 AT+QISEND o 响应'>'，输入数据，执行 CTRL+Z 来发 C 送，执行 ESC 来终止操作 OK 响应 如果连接存在，发送成功返回： SEND OK 注：该操作当且仅当 AT+QIMUX=0 时可 如果连接存在，发送失败返回： 执行 SEND FAIL 配置命令 1）单路连接时（+QIMUX=0） AT+QISEND= 响应'>'，输入数据，直到数据长度达到 如果 TCP 或 UDP 连接未建立，返回： ERROR 响应 如果连接存在，发送成功返回： SEND OK 上海移远通信技术有限公司 147 / 250 M35 AT 命令手册 字长发送 如果连接存在，发送失败返回： SEND FAIL 2）多路连接时（+QIMUX=1） AT+QISEND=[,] 如果 TCP 或 UDP 连接未建立，返回： 若缺省，响应'>'，输入数据， ERROR 执行 CTRL+Z 来发送，执行 ESC 来终止 操作； 若不缺省，响应'>'，输入数据， 直到数据长度达到字长发送 最大响应时间 300ms 参考 Quectel 参数 l te 数字参数；表明连接序号；该参数仅适用于 AT+QIMUX=1，若 AT+QIMUX=0，该参数必须 缺省 数字参数，表明发送数据长度。该数值最大支持 1460 c l 备注 ue tia 1. 执行命令 AT+QISEND 操作，仅在 AT+QIMUX=0 可操作； 2. AT+QISEND 不可发送空字符，返回 SEND FAIL； Q n 3. 只有在 TCP 或 UDP 连接建立时发送数据； 4. SEND OK 提示只表明数据已经传输至窗口进行发送，并不表示该数据已经收到确认报文。为确保数 e 据确认发送至对方，可以通过执行 AT+QISACK 命令进行查询。 nfid 11.3. AT+QICLOSE 关闭 TCP 或 UDP 连接 Co 语法 AT+QICLOSE 关闭 TCP 或 UDP 连接 测试命令 响应 AT+QICLOSE=? OK 执行命令 AT+QICLOSE 响应 如果关闭连接成功返回： CLOSE OK 如果关闭连接失败，返回： ERROR 上海移远通信技术有限公司 148 / 250 配置命令 AT+QICLOSE= 最大响应时间 参考 Quectel 响应 如果关闭连接成功返回： , CLOSE OK 如果关闭连接失败，返回： ERROR 300ms M35 AT 命令手册 参数 数字参数；表明连接序号； 该参数仅适用于 AT+QIMUX=1，若 AT+QIMUX=0，该参数必须缺省 l 备注 cte l 1. 对于 AT+QICLOSE操作：  当 AT+QISRVC=1 且 AT+QIMUX=0 时，返回 CLOSE OK，关闭 ME 作为 Client 连接远程 Server ue tia 的连接；  当 AT+QISRVC=1 且 AT+QIMUX=1 时，返回 ERROR；  当 AT+QISRVC=2 且 AT+QIMUX=0 时，返回 CLOSE OK，关闭 ME 作为 Server，远程 Client Q n 连接 ME 建立的连接；  当 AT+QISRVC=2 且 AT+QIMUX=0 时，此时若无其他 Client 处于监听状态，该操作将使 ME e 退出监听状态；  当 AT+QISRVC=2 且 AT+QIMUX=1 时，ME 作为 Server，该操作将关闭 ME 作为 Server，远 fid 程 Client 连接 ME 建立的所有连接并且退出监听状态。 2. 对于 AT+QICLOSE=操作：  该命令操作只在 AT+QIMUX=1 时有效； n  当 AT+QISRVC=1 且 AT+QIMUX=1 时，该操作将会关闭 ME 作为第的 Client 连接远 o 程 Server 的连接并保留 ME 作为 Server 接入的 Client 连接；  当 AT+QISRVC=2 且 AT+QIMUX=1 时，该操作将会关闭 ME 作为 Server 接入的第的 C远程 Client 连接； 3. 当 AT+QISRVC=1 且 AT+QIMUX=0 时，AT+QICLOSE 只在 AT+QISTAT 为 CONNECTING 或 CONNECT OK 状态时操作成功，其他状态返回 ERROR。关闭连接成功后，状态变化为 IP CLOSE。 上海移远通信技术有限公司 149 / 250 M35 AT 命令手册 11.4. AT+QIDEACT 关闭 GPRS/CSD PDP 场景 语法 AT+QIDEACT 关闭 GPRS/CSD PDP 场景 测试命令 响应 AT+QIDEACT=? OK 配置命令 AT+QIDEACT 响应 如果关闭成功返回： DEACT OK 最大响应时间 参考 l Quectel 如果关闭失败，返回： ERROR 40s，受网络状态影响 CSD 相关配置暂不支持 cte l 备注 ue tia 1. AT+QIDEACT 可关闭除 IP INITIAL 状态的任何 GPRS/CSD PDP 场景。关闭成功后，状态恢复至 IP INITIAL； 2. AT+QIMUX=0 时，AT+QIDEACT 可关闭当前连接和场景； Q n 3. AT+QIMUX=1 时，AT+QIDEACT 使所有连接和场景关闭。 fide 11.5. AT+QILPORT 配置本地端口号 n 语法 o AT+QILPORT 配置本地端口号 测试命令 C AT+QILPORT=? 响应 +QILPORT: (取值列表) 查询命令 AT+QILPORT? OK 响应 : : OK 上海移远通信技术有限公司 150 / 250 M35 AT 命令手册 配置命令 AT+QILPORT=, 最大响应时间 参考 Quectel 响应 OK ERROR 300ms CSD 相关配置暂不支持 参数 字符串参数；表明连接类型 'TCP' TCP 本地端口号 'UDP' 0~65535 UDP 本地端口号 数字参数，表明本地端口号 l 11.6. AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码 cte l 语法 ue tia AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码 测试命令 响应 AT+QIREGAPP=? +QIREGAPP: 'APN','USER','PWD' Q en 查询命令 fid AT+QIREGAPP? OK 响应 +QIREGAPP: ,, n 执行命令 AT+QIREGAPP Co 配置命令 OK 响应 OK ERROR 响应 AT+QIREGAPP=,,< OK password>[,] ERROR 最大响应时间 300ms 参考 Quectel CSD 相关配置暂不支持 上海移远通信技术有限公司 151 / 250 M35 AT 命令手册 参数 字符串参数；表明 GPRS/CSD 接入点名称 字符串参数；表明 GPRS/CSD 接入点用户名 字符串参数；表明 GPRS/CSD 接入点用户密码 表明 CSD 数据传输速率 备注 1. 当且仅当 ME 处于 IP INITIAL 状态时，执行命令和配置命令操作有效，操作成功后 ME 状态将变化 为 IP START； 2. AT+QICSGP 控制该执行命令参数的缺省值。 11.7. AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） tel 语法 c l AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） 测试命令 响应 ue tia AT+QIACT=? OK 执行命令 Q n AT+QIACT 响应 OK ERROR e 最大响应时间 150s，受网络状态影响 fid 参考 Quectel CSD 相关配置暂不支持 n 备注 o 1. AT+QIACT 只有在 IP START 状态下才能操作并激活移动场景，执行后状态变化为 IPCONFIG； C 2. 在 ME 接收激活场景操作后，如果移动场景激活成功，状态变化为 IP GPRSACT，返回 OK，否则 返回 ERROR。 上海移远通信技术有限公司 152 / 250 M35 AT 命令手册 11.8. AT+QILOCIP 获取本地 IP 地址 语法 AT+QILOCIP 获取本地 IP 地址 测试命令 AT+QILOCIP=? 执行命令 AT+QILOCIP 响应 OK 响应 若执行成功，返回： 最大响应时间 参考 l Quectel 否则，返回： ERROR 300ms CSD 相关配置暂不支持 cte l 参数 ue tia 字符串参数；表明 GPRS/CSD 方式下获取的 IP 地址 Q n 备注 e 只有在移动场景已激活状态：IP GPRSACT、TCP/UDP CONNECTING、CONNECT OK、IP CLOSE fid 下才可以通过 AT+QILOCIP 查询到本地 IP 地址，否则返回 ERROR。 n 11.9. AT+QISTAT 查询当前连接状态 Co 语法 AT+QISTAT 查询当前连接状态 测试命令 AT+QISTAT=? 执行命令 AT+QISTAT 响应 OK 响应 当 AT+QIMUX=0 是，返回： OK STATE: 上海移远通信技术有限公司 153 / 250 M35 AT 命令手册 最大响应时间 参考 Quectel 当 AT+QIMUX=1 是，返回： (+QISTAT: , , , ) 列表 OK 300ms CSD 相关配置暂不支持 参数 字符串参数；表明连接状态 'IP INITIAL' 初始化 'IP START' 启动任务 'IP CONFIG' 配置场景 l 'IP IND' 激活 GPRS/CSD 场景中 'IP GPRSACT' 接收场景配置 te 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） c l 'TCP CONNECTING' TCP 连接中 'UDP CONNECTING' UDP 连接中 ue tia 'IPCLOSE' TCP/UDP 连接关闭 'CONNECT OK' TCP/UDP 连接成功 'PDP DEACT' GPRS/CSD 场景异常关闭 Q n 在 ATV0 配置下，数字和字符串对应含义如下： e 0 'IP INITIAL' 1 'IP START' fid 2 'IP CONFIG' 3 'IP IND' 4 'IP GPRSACT' n 5 'IP STATUS' o 6 'TCP CONNECTING' or 'UDP CONNECTING' 7 'IP CLOSE' C8 'CONNECT OK' 9 'PDP DEACT' 连接序号，范围为 0-5 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 上海移远通信技术有限公司 154 / 250 M35 AT 命令手册 11.10. AT+QISTATE 查询当前接入的连接状态 语法 AT+QISTATE 查询当前连接状态 测试命令 AT+QISTATE=? 响应 OK 执行命令 AT+QISTATE 响应 当 AT+QIMUX=0 是，返回： OK STATE: 最大响应时间 参考 Quectel 参数 当 AT+QIMUX=1 是，返回： OK STATE: l +QISTATE: ,,,, te OK c l 否则，返回： ue tia ERROR 300ms Q n CSD 相关配置暂不支持 fide 字符串参数；表明连接状态，当 AT+QIMUX=0 时： 'IP INITIAL' 初始化 n 'IP START' 启动任务 o 'IP CONFIG' 配置场景 'IP IND' 激活 GPRS/CSD 场景中 C'IP GPRSACT' 接收场景配置 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） 'TCP CONNECTING' TCP 连接中 'UDP CONNECTING' UDP 连接中 'IP CLOSE' TCP/UDP 连接关闭 'CONNECT OK' TCP/UDP 连接成功 'PDP DEACT' GPRS/CSD 场景异常关闭 当 AT+QIMUX=1 时： 'IP INITIAL' 初始化 上海移远通信技术有限公司 155 / 250 M35 AT 命令手册 'IP START' 启动任务 'IP CONFIG' 配置场景 'IP IND' 激活 GPRS/CSD 场景中 'IP GPRSACT' 接收场景配置 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） 'IP PROCESSING' 数据阶段 'PDP DEACT' GPRS/CSD 场景异常关闭 连接序号，范围为 0-5 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 字符串参数；表明接入连接状态，有 INITIAL，CONNECTED l 11.11. AT+QISSTAT 查询当前 Server 状态 cte l 语法 ue tia AT+QISSTAT 查询当前 Server 状态 测试命令 响应 AT+QISSTAT=? OK Q n 执行命令 fide AT+QISSTAT 响应 当 AT+QIMUX=0 是，返回： OK S: 当 AT+QIMUX=1 是，返回： nOK S: Co C: ,,, 否则，返回： ERROR 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 156 / 250 M35 AT 命令手册 参数 字符串参数；表明连接状态 'INITIAL' 初始化 'OPENNING' 启动任务 'LISTENING' 监听状态 'CLOSING' 关闭过程中 连接序号，范围为 0-4（注：当模块做 Server 工作时，最多能接入 5 路连接） 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 l 11.12. AT+QIDNSCFG 配置域名服务器 DNS te 语法 c l AT+QIDNSCFG 配置域名服务器 DNS ue tia 测试命令 响应 AT+QIDNSCFG=? OK 查询命令 响应 Q n AT+QIDNSCFG? PrimaryDns: SecondaryDns: fide 配置命令 OK 响应 AT+QIDNSCFG=[,] ERROR 最大响应时间 300ms o 参考 C Quectel 参数 字符串参数；表明主域名服务器的 IP 地址 字符串参数；表明二级域名服务器的 IP 地址 上海移远通信技术有限公司 157 / 250 M35 AT 命令手册 备注 当激活 GPRS/CSD 场景时，TA 会主动向 GPRS/CSD 网络获取 DNS 服务器。因此强烈建议在状态为 IP GPRSACT，IP STATUS，CONNECT OK 和 IP CLOSE 时，配置 DNS 服务器。 11.13. AT+QIDNSGIP 域名解析 语法 AT+QIDNSGIP 域名解析 测试命令 AT+QIDNSGIP=? 配置命令 AT+QIDNSGIP= Quectenl tial 最大响应时间 e 参考 Quectel 响应 OK 响应 OK ERROR 返回 OK 后，若解析成功： 返回 OK 后，若解析失败： ERROR: STATE: 14s，受网络状态影响 fid 参数 n o C 字符串参数；表明 Internet 上注册的域名 字符串参数；表明 IP 地址对应的域名 数字参数；表明错误代码号 1 DNS 未授权错误 2 参数配置错误 3 网络错误 4 未找到服务器 5 超时 6 未配置 7 无内存 8 未知错误 参考 AT+QISTAT 上海移远通信技术有限公司 158 / 250 M35 AT 命令手册 11.14. AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 语法 AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 测试命令 响应 AT+QIDNSIP=? +QIDNSIP: (取值列表) 查询命令 AT+QIDNSIP? OK 响应 +QIDNSIP: 配置命令 AT+QIDNSIP= l 最大响应时间 te 参考 c l Quectel OK 响应 OK ERROR 300ms ue tia 参数 Q en 数字参数；表明连接使用 IP 地址连接还是使用域名连接 0 使用 IP 地址连接 1 使用域名方式连接 fid 11.15. AT+QIHEAD 配置接收数据时是否显示 IP 头 on 语法 C AT+QIHEAD 配置接收数据时是否显示 IP 头 测试命令 响应 AT+QIHEAD=? +QIHEAD: (取值列表) 查询命令 AT+QIHEAD? OK 响应 +QIHEAD: OK 上海移远通信技术有限公司 159 / 250 M35 AT 命令手册 配置命令 AT+QIHEAD= 最大响应时间 参考 Quectel 响应 OK ERROR 300ms 参数 数字参数；表明接收数据时是否显示 IP 头 0 不显示 IP 头 1 显示 IP 头，格式为 'IPD(data length) :' l 11.16. AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 te 语法 c l AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 ue tia 测试命令 响应 AT+QIAUTOS=? +QIAUTOS: (取值列表), (取值列表) Q n 查询命令 e AT+QIAUTOS? OK 响应 +QIAUTOS: , fid 配置命令 AT+QIAUTOS=[,] on 最大响应时间 C 参考 OK 响应 OK ERROR 300ms Quectel 参数 数字参数；表明发送 TCP/UDP 数据时是否设置自动发送功能 0 未设置自动发送数据（缺省值） 1 设置自动发送数据 数字参数；表明自动发送数据时间。操作 AT+QISEND，输入数据耗时后，数据自动 发送 上海移远通信技术有限公司 160 / 250 M35 AT 命令手册 11.17. AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' 语法 AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' 测试命令 AT+QIPROMPT=? 查询命令 响应 +QIPROMPT: (取值列表) OK 响应 AT+QIPROMPT? +QIPROMPT: OK 配置命令 响应 AT+QIPROMPT= 最大响应时间 l 参考 te Quectel OK ERROR 300ms c l 参数 ue tia 数字参数；表明 AT+QISEND 操作后，是否显示'>'和'SEND OK' 0 发送成功时不显示'>'，返回'SEND OK' Q n 1 发送成功时显示'>'，返回'SEND OK' 2 发送成功时不显示'>'，不返回'SEND OK' e 3 发送成功时显示'>'，返回', SEND OK' fid 11.18. AT+QISERVER 配置为服务器 on 语法 C AT+QISERVER 配置为服务器 测试命令 AT+QISERVER=? 查询命令 AT+QISERVER? 响应 OK 响应 +QISERVER: , 执行命令 AT+QISERVER OK 响应 OK 上海移远通信技术有限公司 161 / 250 M35 AT 命令手册 ERROR 成功配置为服务器，返回： SERVER OK 配置为服务器失败，返回： 配置命令 CONNECT FAIL 响应 AT+QISERVER=[,] OK ERROR 最大响应时间 150s，受网络状态影响 参考 Quectel 参数 l cte l ue tia 数字参数；是否配置成服务器 0 不配置成服务器 1 配置成服务器 当前已连入的客户端的数量，范围为 1-5 数字参数；表明配置的服务器类型 0 TCP 服务器 1 UDP 服务器 服务器最大可接入连接数，默认为 1，范围为 1-5 Q en 备注 fid 当 AT+QIMUX=0 时，参数被缺省。 Con 11.19. AT+QICSGP 设置 CSD 或 GPRS 连接模式 语法 AT+QICSGP 设置 CSD 或 GPRS 连接模式 测试命令 AT+QICSGP=? 响应 +QICSGP: 0-CSD,DIAL NUMBER,USER NAME,PASSWORD,RATE(0-3) +QICSGP: 1-GPRS,APN,USER NAME,PASSWORD OK 上海移远通信技术有限公司 162 / 250 M35 AT 命令手册 查询命令 AT+QICSGP? 响应 +QICSGP: 配置命令 AT+QICSGP=,[(,,)/ (,,,)] OK 响应 OK ERROR 最大响应时间 300ms 参考 CSD 相关配置暂不支持 Quectel 参数 tel 数字参数；表明无线连接模式 0 CSD 连接 1 GPRS 连接 c l GPRS 连接配置的参数说明： ue tia 字符串参数；表明接入点名称 字符串参数；表明用户名 字符串参数；表明用户密码 Q n CSD 连接配置的参数说明： e 字符串参数；表明 CSD 号码 字符串参数；表明 CSD 连接用户名 fid 字符串参数；表明 CSD 连接用户密码 数字参数；表明 CSD 连接速率 0 2400 n 1 4800 o 2 9600（缺省值） C3 14400 上海移远通信技术有限公司 163 / 250 M35 AT 命令手册 11.20. AT+QISRVC 选择当前可操作连接 语法 AT+QISRVC 选择当前可操作连接 测试命令 AT+QISRVC=? 响应 +QISRVC: (取值列表) 查询命令 AT+QISRVC? OK 响应 +QISRVC: 配置命令 AT+QISRVC= l 最大响应时间 te 参考 c l Quectel OK 响应 OK ERROR 300ms CSD 相关配置暂不支持 ue tia 参数 Q en 数字参数；用于选择当前可操作连接 1 选择 ME 作为 Client 的连接 2 选择 ME 作为 Server 的连接 fid 备注 该操作用于以下情况，当前存在两路或多路连接，一路连接是 ME 作为 Client 连接远程 Server，一路连 Con 接时 ME 作为 Server 接入远程 Client，通过该命令可区分和选择当前操作的连接。 11.21. AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号 语法 AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号 测试命令 AT+QISHOWRA=? 响应 +QISHOWRA: (取值列表) 上海移远通信技术有限公司 164 / 250 M35 AT 命令手册 查询命令 AT+QISHOWRA? OK 响应 +QISHOWRA: (取值列表) 配置命令 AT+QISHOWRA= OK 响应 OKERROR ERROR 最大响应时间 300ms 参考 Quectel 参数 tel 数字参数；表明接收数据时是否显示发送方的 IP 地址和端口号 0 不显示（默认值） 1 显示，格式为：RECV FROM :< IP ADDRESS> :< PORT> uec tial 11.22. AT+QISCON 保存 TCPIP 应用场景配置 Q n 语法 e AT+QISCON 保存 TCPIP 应用场景配置 fid 测试命令 AT+QISCON=? 查询命令 Con AT+QISCON? 响应 OK 响应 显示 TCPIP 上下文： SHOW APPTCPIP CONTEXT +QIDNSIP: +QIPROMPT:< sendprompt> +QIHEAD: +QISHOWRA: +QICSGP: Gprs Config APN: Gprs Config UserId: Gprs Config Password: Gprs Config inactivityTimeout: CSD Dial Number: CSD Config UserId: CSD Config Password: 上海移远通信技术有限公司 165 / 250 M35 AT 命令手册 CSD Config rate: App Tcpip Mode: In Transparent Transfer Mode Number of Retry: Wait Time: Send Size: esc: 执行命令 OK 响应 AT+QISCON OK 最大响应时间 300ms 参考 Quectel l 参数 te c l ue tia Q n e fid 请参考 AT+QIDNSIP 请参考 AT+QIPROMPT 请参考 AT+QIHEAD 请参考 AT+QISHOWRA 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP on 以下配置仅属于透明传输模式： 请参考 AT+QITCFG C 请参考 AT+QITCFG 请参考 AT+QITCFG 请参考 AT+QITCFG 备注 1. 执行命令保存以下 AT 命令配置：AT+QIDNSIP，AT+QIPROMPT，AT+QIHEAD，AT+QISHOWRA， AT+QICSGP，AT+QITCFG； 2. 执行命令操作只影响当前前置场景各参数配置（请参考 AT+QIFGCNT）。 上海移远通信技术有限公司 166 / 250 M35 AT 命令手册 11.23. AT+QIMODE 配置 TCPIP 应用模式 语法 AT+QIMODE 配置 TCPIP 应用模式 测试命令 响应 AT+QIMODE=? +QIMODE:(取值列表) 查询命令 AT+QIMODE? OK 响应 +QIMODE: 配置命令 AT+QIMODE= l 最大响应时间 te 参考 c l Quectel OK 响应 OK ERROR 300ms ue tia 参数 Q en 0 非透传模式 1 透传模式（在该模式下，建立连接成功后，UART 将会进入数据模式。接收到的数据将 直接输出至串口，可通过'+++'退出数据模式，ATO 操作返回数据模式） fid 11.24. AT+QITCFG 配置透明传输模式 on 语法 C AT+QITCFG 配置透明传输模式 测试命令 响应 AT+QITCFG=? +QITCFG: (取值列表, 取值列表, 取值 列表, 取值列表) 查询命令 AT+QITCFG? OK 响应 +QITCFG: ,,, 上海移远通信技术有限公司 167 / 250 M35 AT 命令手册 配置命令 AT+QITCFG=,,< SendSz>, 最大响应时间 参考 Quectel OK 响应 OK ERROR 300ms 参数 一个 IP 包的重传次数 间隔发送时间，单位为 100ms 每次发送数据字节数 是否开启转义序列，缺省值是 TRUE tel 备注 c l 1. 最大值为 1460； 2. 和都可以指示发送数据操作。当发送的数据长度大于或等于时，将 ue tia 优先发送长度的数据给远程连接；当发送的数据长度小于时，将会等待 时长，时间到后将串口已输入的数据发送出去； 3. 该命令只在 AT+QIMUX=0 状态下有效。 Q fiden 11.25. AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议 语法 n AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议 o 测试命令 C AT+QISHOWPT=? 响应 +QISHOWPT: (取值列表) 查询命令 AT+QISHOWPT? OK 响应 +QISHOWPT: 配置命令 AT+QISHOWPT= OK 响应 OK ERROR 上海移远通信技术有限公司 168 / 250 M35 AT 命令手册 最大响应时间 参考 Quectel 300ms 参数 数字参数；配置在接收到 TCP 或 UDP 数据时，接收数据 IP 头内是否显示传输协议 0 不显示 1 显示，格式为：IPD (data length) (TCP/UDP): 备注 该=1 只在 AT+QIHEAD=1 时有效。 tel 11.26. AT+QIMUX 控制是否启用多路连接 c l 语法 ue tia AT+QIMUX 控制是否启用多路连接 测试命令 AT+QIMUX=? 响应 +QIMUX: (取值列表) Q en 查询命令 fid AT+QIMUX? OK 响应 +QIMUX: n 配置命令 AT+QIMUX= Co 最大响应时间 OK 响应 OK ERROR 300ms 参考 Quectel 参数 数字参数；控制当前场景下连接模式 0 不启用多路连接 1 启用多路连接 上海移远通信技术有限公司 169 / 250 M35 AT 命令手册 11.27. AT+QISHOWLA 控制是否显示本地 IP 地址 语法 AT+QISHOWLA 控制是否显示本地 IP 地址 测试命令 响应 AT+QISHOWLA=? +QISHOWLA: (取值列表) 查询命令 AT+QISHOWLA? OK 响应 +QISHOWLA: 配置命令 AT+QISHOWLA= l 最大响应时间 te 参考 Quectel OK 响应 OK ERROR 300ms uec tial 参数 Q en 数字参数；表明在接收到数据前是否显示数据发送的目的 IP 地址 0 不显示 1 显示，格式为：TO: fid 11.28. AT+QIFGCNT 配置前置场景 n 语法 o AT+QIFGCNT 配置前置场景 C 测试命令 响应 AT+QIFGCNT=? +QIFGCNT: (取值列表) 查询命令 AT+QIFGCNT? OK 响应 +QIFGCNT: , OK 上海移远通信技术有限公司 170 / 250 M35 AT 命令手册 配置命令 AT+QIFGCNT= 最大响应时间 参考 Quectel 响应 OK ERROR 300ms 参数 数字参数；表明当前前置场景序号，范围为 0-1 数字参数；表明当前场景受控于哪一个通道 0 VIRTUAL_UART_1 1 VIRTUAL_UART_2 2 VIRTUAL_UART_3 3 VIRTUAL_UART_4 l 255 当前场景未受控于任何通道 te 备注 c l 当 AT+CMUX=1 打开多路复用功能后，若当前通道操作指定的场景状态不是 IPINITIAL 且该 ue tia 场景被其他通道控制，操作将失败，返回 ERROR。 Q en 11.29. AT+QISACK 查询发送数据信息 fid 语法 AT+QISACK 查询发送数据信息 测试命令 n AT+QISACK=? o 查询命令 C AT+QISACK 响应 OK 响应 +QISACK: , , 配置命令 AT+QISACK= OK 响应 +QISACK: , , 最大响应时间 参考 Quectel OK 300ms 上海移远通信技术有限公司 171 / 250 参数 查询的连接序号 数字参数；表明已发送数据大小 数字参数；表明已发送并得到远程接收方确认的数据大小 数字参数；表明已发送但未得到远程接收方确认的数据大小 M35 AT 命令手册 备注 1. 执行命令仅在 AT+QIMUX=0 时有效； 2. 配置命令仅在 AT+QIMUX=1 时有效； 3. 该命令操作受控于 AT+QISRVC 配置。当 AT+QISRVC=1 时，查询的是 ME 作为 Client 向远程 Server 发送数据信息；当 AT+QISRVC=2 时，查询的是 ME 作为 Server 向远程 Client 发送的数据信息。 l 11.30. AT+QINDI 配置是否缓存接收到的数据 te 语法 c l AT+QINDI 配置是否缓存接收到的数据 ue tia 测试命令 响应 AT+QINDI=? +QINDI: (取值列表) Q n 查询命令 e AT+QINDI? OK 响应 +QINDI: fid 配置命令 AT+QINDI= on 最大响应时间 C 参考 OK 响应 OK ERROR 300ms Quectel 参数 数字参数；表明是否缓存接收到的数据 0 不缓存；接收到数据直接输出至串口 1 缓存模式 1；接收到数据将会向串口上报提示，格式为：+QIRDI: ,,（此 时可以通过 AT+QIRD 读取缓存的数据） 2 缓存模式 2；接收到数据将会向串口上报提示，格式为： 上海移远通信技术有限公司 172 / 250 M35 AT 命令手册 +QIRDI: ,,,,,。每个 Socket 将建立一个缓存，接收 的数据将被保存在缓存中，直到通过 AT+QIRD 读取缓存的数据，缓存数据不应超过 400KB 数字参数；表明哪个场景接收到了新数据并缓存到缓存器内（可参考 AT+QIFGCNT）， 范围是 0-1 数字参数；表明 ME 是作为 Server 还是作为 Client 建立的连接接收到数据 1 ME 作为 Client 连接 2 ME 作为 Server 连接 数字参数；表明 ME 是哪一路连接接收到数据，范围是 0-5（当 AT+QIMUX=0 时，=0） 11.31. AT+QIRD 读取缓存的数据 语法 AT+QIRD 读取缓存的数据 l 测试命令 te AT+QIRD=? 响应 +QIRD: (取 值 列 表 , 取 值 列 表 , 取 值 列 表 , 取值列表) uec tial 配置命令 AT+QIRD=,,, OK 响应 [+QIRD::,, Q n ] e OK fid 最大响应时间 参考 n Quectel ERROR 300ms Co 参数 数字参数；表明哪个场景接收到了新数据并缓存到缓存器内（可参考 AT+QIFGCNT），范围 是 0-1 数字参数；表明 ME 是作为 Server 还是作为 Client 建立的连接接收到数据 1 ME 作为 Client 连接 2 ME 作为 Server 连接 数字参数；表明 ME 是哪一路连接接收到数据，范围是 0-5（当 AT+QIMUX=0 时，=0） 读取数据长度，范围为 1-1500 发送数据方的 IP 地址 上海移远通信技术有限公司 173 / 250 发送数据方的端口号 字符串类型；表明传输协议类型 TCP TCP 协议 UDP UDP 协议 读取到的真实数据长度 读取到的数据内容 M35 AT 命令手册 11.32. AT+QISDE 控制 AT+QISEND 是否允许数据回显 语法 AT+QISDE 控制 AT+QISEND 是否允许数据回显 测试命令 响应 AT+QISDE=? +QISDE: (取值列表) tel 查询命令 AT+QISDE? OK 响应 +QISDE: uec tial 配置命令 AT+QISDE= Q n 最大响应时间 e 参考 fid Quectel OK 响应 OK ERROR 300ms 参数 Con 数字参数；表明在操作 AT+QISEND 发送数据时，是否允许数据回显 0 不回显 1 回显 上海移远通信技术有限公司 174 / 250 M35 AT 命令手册 11.33. AT+QPING PING 远程服务器 语法 AT+QPING PING 远程服务器 测试命令 AT+QPING=? 响应 +QPING: 'HOST',(取值列表),(取值列 表) OK 配置命令 响应 AT+QPING=''[,[][,]] uectel tial 最大响应时间 参考 Quectel [+QPING: [,,,,] …] +QPING:[,,,,,, ] ERROR 取决于 Q en 参数 fid 字符串参数；远程服务器地址，可以是 IP 地址格式亦可以是域名格式 数字参数；每一次 PING 请求响应最大超时时间；单位：秒，范围：1-255，默认 1s n 数字参数；PING 请求次数；范围：1-10，默认：4 PING 请求结果： o 0 收到远程服务器响应，提示：, , , C1 PING 请求超时 远程服务器 IP 地址 每一次 PING 发送的数据长度 PING 请求耗时，单位：毫秒 PING 请求返回的当前时间 结束结果码 2 正常结束；成功激活 GPRS 连接上远程服务器，提示： ,,,,, 3 TCP/IP 协议栈忙 4 未找到远程服务器 上海移远通信技术有限公司 175 / 250 5 激活 PDP 场景失败 发送 PING 请求总次数 发送 PING 请求并收到响应总次数 PING 请求超时次数 最小响应时间，单位：毫秒 最大响应时间，单位：毫秒 平均响应时间，单位：毫秒 M35 AT 命令手册 11.34. AT+QNTP 通过网络时间服务器同步本地时间 语法 AT+QNTP 通过网络时间服务器同步本地时间 测试命令 响应 AT+QNTP=? +QNTP: 'SERVER',(取值列表) tel 查询命令 c l AT+QNTP? OK 响应 +QNTP: '', ue tia 执行命令 Q n AT+QNTP OK 响应 OK +QNTP: fide 配置命令 AT+QNTP=''[,] ERROR 响应 OK +QNTP: on 最大响应时间 C 参考 ERROR 120s，受网络状态影响 Quectel 参数 字符串参数；时间服务器的 IP 地址或域名 时间服务器的端口号 时间同步结果 0 本地时间同步成功 上海移远通信技术有限公司 176 / 250 1 本地时间同步失败，未知错误 2 时间服务器无响应 3 TCP/IP 协议栈忙 4 未找到时间服务器 5 激活 PDP 场景失败 备注 中国默认国际时间服务器地址为'210.72.145.44' ，端口号是 123。 M35 AT 命令手册 CQouneficdteenl tial 上海移远通信技术有限公司 177 / 250 M35 AT 命令手册 12 补充业务命令 12.1. AT+CCFC 设置呼叫转移 AT+CCFC 根据 GSM 02.82[4]，对呼叫转移业务进行控制，同时支持注册、删除、激活、去激活和状 态查询。 语法 l AT+CCFC 设置呼叫转移 测试命令 te AT+CCFC=? 响应 +CCFC: (取值列表) uec tial 设置命令 AT+CCFC=, [,,[,[,[,[,time]]]]]] OK 响应 若不等于2且操作成功： OK 若等于2且操作成功（当且仅当=0~3）： +CCFC: , [, , [,,[,]]] [+CCFC: ....] OK Con 最大响应时间 功能相关报错： +CME ERROR: 300ms 参考 GSM 07.07 参数 0 无条件 1 移动遇忙 2 无应答 上海移远通信技术有限公司 178 / 250 M35 AT 命令手册 3 不可及 4 所有呼叫转移(0-3)（请参考GSM 02.30[19]） 5 所有条件呼叫转移(1-3)（请参考GSM 02.30[19]） 0 禁用 1 启用 2 状态查询 3 注册 4 删除 字符型；呼叫转移地址的电话号码，其格式符合所规定的 整数型的八位字节地址类型（请参考GSM 04.08[8]第10.5.4.7小节）；当拨号字符串包括国际 接入代码字符'+'时，缺省值为145；其他情况下，缺省值为129 字符型；由规定的字符型子地址的格式 ctel l ue tia 整数型的八位字节子地址类型（请参考GSM 04.08[8]第10.5.4.8小节） 1 语音 2 数据 4 传真 7 语音，数据和传真 8 短消息 16 同步数据电路 32 异步数据电路 1…30 如果启用或禁止'无应答'，该参数使得再改呼叫转移前有秒数的等待时间，默认值 为20 0 非激活 1 激活 Q n 举例 e AT+CCFC=0, 2,'15021012496' fid OK //设置无条件转移至 15021012496 AT+CCFC=0,2 //查询无条件转移设置，转移成功 +CCFC: 1, 1,'+8615021012496',145 n OK o AT+CCFC=0,4 C OK //删除无条件转移 AT+CCFC=0,2 //查询无条件转移设置，设置删除 +CCFC: 0, 15 OK 上海移远通信技术有限公司 179 / 250 M35 AT 命令手册 12.2. AT+CCUG 封闭用户组 该命令可控制 CUG（Closed User Group）附加业务（详情请参考 GSM 02.85[21]）。用户可选择 CUG 索引、抑制 OA（Outgoing Access）、抑制优先 CUG。 语法 AT+CCUG 封闭用户组 测试命令 AT+CCUG=? 响应 +CCUG: ,, OK 设置命令 AT+CCUG=[][,[,]] l 最大响应时间 参考 te GSM 07.07 响应 OK +CME ERROR: 300ms uec tial 参数 0 Q n 1 0...9 e 10 0 fid 1 2 4 禁用暂时模式下提供的 CUG 业务 启用暂时模式下提供的 CUG 业务 CUG 索引 无索引（优先 CUG 取自用户数据） 无信息 抑制 OA 抑制优先 CUG 抑制 OA 和优先 CUG Con 12.3. AT+CCWA 呼叫等待 该命令根据 GSM02.83[5]，对呼叫等待业务进行禁用，启用及查询控制。 语法 AT+CCWA 呼叫等待 测试命令 AT+CCWA=? 响应 +CCWA: (取值列表) 上海移远通信技术有限公司 180 / 250 M35 AT 命令手册 查询命令 AT+CCWA? OK 响应 +CCWA: 配置命令 AT+CCWA=[],[,]] OK 响应 当不等于2且操作成功： OK 当等于2且操作成功： +CCWA:,[+CCWA:,< 最大响应时间 l 参考 te GSM 07.07 class2>[...]] OK +CME ERROR: 300ms 相关 URC 上报： +CCWA: ,,[,] c l 参数 ue tia Q n Confide 在 TA 设置或显示结果码的显示状态 0 禁用 1 启用 若没有给定该参数，则不能询问网络 0 禁用 1 启用 2 查询状态 代表每一种信息类别的整数的总和 1 语音（电话业务） 2 数据 4 传真 16 同步数据电路 32 异步数据电路 0 非激活 1 激活 字符串类型。电话号码的地址类型必须符合的要求 整型格式的地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 可选字符类型，字母数字的表示对应电话号码簿中的位置 上海移远通信技术有限公司 181 / 250 M35 AT 命令手册 备注 1. 如果对于任何，例如+CCWA: 0,7，服务都没有被激活，这种情况下，=0 将会返 回； 2. 当=2，所有的激活的呼叫转移号码将被上报，在这种模式下，按任何键，命令都可以被终 止。 举例 AT+CCWA=1,1 //启用在 TA 设置或显示结果码的显示状态 OK ATD10086; //建立通话 OK +CCWA: '02154450293',129,1 //通话中来电，来电处于呼叫等待状态中 tel 12.4. AT+CHLD 呼叫保持和多方通话 c l 使用该命令，可将当前通话暂时从 ME 释放，但是网络和多方通话仍然保持该连接。具有两个通话（一 ue tia 个通话保持，另一个通话在用或提示）的用户可以连接到其他各方的通话，并释放自己的连接。 语法 Q n AT+CHLD 呼叫保持和多方通话 e 测试命令 AT+CHLD=? 响应 +CHLD: (取值列表) fid 配置命令 n AT+CHLD=[] Co 最大响应时间 OK 响应 OK +CME ERROR: 300ms 参考 GSM 07.07 参数 0 释放所有保持的呼叫或者等待中的呼叫（UDUB 用户决定忙）。如果有电话处于等待状 态，终止等待的电话，否则，终止所有保持的电话 1 如果存在当前呼叫，释放所有当前呼叫并将接听另外一个已保持或等待中的呼叫。当只 有一路通话时，该操作不能结束已激活的通话 上海移远通信技术有限公司 182 / 250 M35 AT 命令手册 1X 释放当前某一特定的呼叫 X（X=1~7） 2 如果存在当前呼叫，保持所有当前呼叫并接听另外一个已保持或等待中的呼叫 2X 保持除通讯必须支持的呼叫 X（X=1~7）外的所有当前呼叫 3 为会话增加一个已保持通话 备注 该业务仅适用于电信服务 11（报告：电话）。 举例 AT+CCWA=1,1 OK ATD10086; OK //启用在 TA 设置或显示结果码的显示状态 //建立通话 l +CCWA: '02154450293',129,1 te AT+CHLD=2 OK c l AT+CLCC ue tia +CLCC: 1,0,1,0,0,'10086',129,'' //通话中来电，来电处于呼叫等待状态中 //保持第一路通话，并接入第二路呼叫等待的通话 //第一路通话被保持 +CLCC: 2,1,0,0,0,'02154450293',129,'' //第二路通话被接入 Q n OK e AT+CHLD=21 OK fid AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' //激活第一路通话，保持第二路通话 //第一路通话被接入 n +CLCC: 2,1,1,0,1,'02154450293',129,'' //第二路通话被保持 o OK C AT+CHLD=3 //激活所有通话，实现 3 方通话 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129,'' +CLCC: 2,1,0,0,1,'02154450293',129,'' OK 上海移远通信技术有限公司 183 / 250 M35 AT 命令手册 12.5. AT+CLIP 来电号码显示设置 语法 AT+CLIP 来电号码显示设置 测试命令 AT+CLIP=? 响应 +CLIP: (取值列表),(取值列表) 查询命令 AT+CLIP? OK 响应 +CLIP: 配置命令 AT+CLIP=[] l 最大响应时间 cte l 参考 ue tia GSM07.07 OK 响应 OK +CME ERROR: 15s，受网络状态影响 URC 上报： 当可在 TE 显示 CLI 且主叫方允许的情况下，当所有 RING 或 +CRING: 的返回结果从 TA 发送到 TE 后，将返回： +CLIP: ,,'',,, 参数 Q en fid n Co 0 不显示结果码 1 显示结果码 0 未提供 CLIP 业务 1 提供 CLIP 业务 2 未知 字符型；由规定的电话号码格式 整数型的八位字节地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 字符串类型；电话本中条目对应的字符表示（该参数由 AT+QCLIP 控制 是否显示字符串内容） 0 CLI 有效 1 CLI 由发起端保留 2 CLI 由于网络问题或者由于发起端网络的限制而不可行 上海移远通信技术有限公司 184 / 250 M35 AT 命令手册 备注 1. 配置命令可启用或禁用 CLI 显示在 TE 上。但对附加业务 CLIP 在网络中的执行没有影响； 2. 查询命令给定的状态，并根据 GSM02.81[3]触发对 CLIP 业务的配置状态的查询。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,'',,'',0 tel 12.6. AT+QCLIP 配置来电是否显示主叫号码名称 c l 语法 ue tia AT+QCLIP 配置来电是否显示主叫号码名称 测试命令 响应 Q n AT+QCLIP=? +QCLIP: (取值列表) e 查询命令 fid AT+QCLIP? OK 响应 +QCLIP: n 配置命令 AT+QCLIP= Co 最大响应时间 OK 响应 OK +CME ERROR: 300ms 参考 Quectel 参数 来电是否显示主叫号码名称 0 不显示 1 显示 上海移远通信技术有限公司 185 / 250 备注 该命令仅在 AT+CLIP=1 下有效。 M35 AT 命令手册 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+QCLIP=1 OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,'',,'QUECTEL',0 ctel l 12.7. AT+CLIR 主叫识别限制 ue tia 当主叫方发起呼叫时，使用该命令可启用或禁止在被叫方显示 CLI。对于所有的接下来的去电，已经设 置了一个默认值作为临时模式，那么这个命令将会覆盖 CLIR 设置（默认是限制或者允许）。通过使用相反 的命令，这个设置被撤销。 Q en 语法 fid AT+CLIR 主叫识别限制 测试命令 AT+CLIR=? 响应 +CLIR: (取值列表) on 查询命令 C AT+CLIR? OK 响应 +CLIR: , 配置命令 AT+CLIR=[] 最大响应时间 OK 功能相关报错： +CME ERROR: 响应 OK +CME ERROR: 15s，受网络状态影响 上海移远通信技术有限公司 186 / 250 M35 AT 命令手册 参考 GSM 07.07 参数 设置出局呼叫的调整状态 0 依据 CLIR 业务的开通状态使用提示指示语 1 CLIR 调用 2 CLIR 抑制 显示主叫在网络中的 CLIR 业务状态 0 未提供 CLIR 业务 1 永久方式下提供的 CLIR 业务 2 未知（如：无网络等） 3 暂时模式下提供的 CLIR 业务受限 4 暂时模式下提供的 CLIR 业务不受限 l 备注 cte l 使用该命令功能，需要注意对应 SIM 卡是否支持号码隐藏业务。 ue tia 12.8. AT+COLP 显示被叫识别 Q en 当主叫方在发起呼叫时，使用该命令可启用或禁止显示呼叫识别。在任何的+CR 或者 V.25ter 响应之 前，中间结果码直接从 TA 返回给 TE。 fid 语法 n AT+COLP 显示被叫识别 测试命令 Co AT+COLP=? 响应 +COLP: (取值列表) 查询命令 OK 响应 AT+COLP? +COLP: , 配置命令 AT+COLP=[] 最大响应时间 OK 响应 OK +CME ERROR: 15s，受网络状态影响 上海移远通信技术有限公司 187 / 250 M35 AT 命令手册 参考 GSM 07.07 URC 上报： 当使能（并且被叫用户容许），在任何+CR 和 V.25ter 响应之 前，一个中间结果码返回： +COLP:,[,,[, ]] 参数 0 不显示结果码 1 显示结果码 0 未提供 COLP 业务 1 提供 COLP 业务 tel c l 2 未知 字符型；由规定的电话号码格式 整数型的八位字节地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 字符串类型，子地址格式符合 整型格式的子地址类型（参考 GSM04.08[8]章节 10.5.4.8） 字符串类型；电话本中条目对应的字符表示（该参数由 AT+QCOLP 控制是 否显示字符串内容） ue tia 备注 Q n 查询命令给定的状态，并根据 GSM02.81[3]，可触发对 COLP 业务的配置状态的查询（中给定）。 fide 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' n OK AT+COLP=1 o OK C ATD02151082965; +COLP: '02151082965',129,'',0,'' OK 上海移远通信技术有限公司 188 / 250 M35 AT 命令手册 12.9. AT+QCOLP 配置去电是否显示主叫号码名称语法 AT+QCOLP 配置去电是否显示主叫号码名称语法 测试命令 响应 AT+QCOLP=? +QCOLP: (取值列表) 查询命令 AT+QCOLP? OK 响应 +QCOLP: OK 配置命令 响应 AT+QCOLP= 最大响应时间 l 参考 te Quectel OK +CME ERROR: 300ms c l 参数 Que ntia 是否显示+COLP 字符串名称 0 不显示 1 显示 e 备注 fid 该命令仅在 AT+COLP=1 下有效。 n 举例 o AT+CPBW=1,'02151082965',129,'QUECTEL' C OK AT+QCOLP=1 OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,'',0,'QUECTEL' OK 上海移远通信技术有限公司 189 / 250 M35 AT 命令手册 12.10. AT+CUSD 非结构化附加业务 该命令根据 GSM02.90[23]，用于对 USSD（Unstuctured Supplementary Service Data）进行控制。 该命令支持网络和移动发起的操作。用于启用或禁用非请求结果码（网络返回的 USSD 返回结果 或网络发起操作）+CUSD : [,,]显示在 TE 上的。 指定时，移动发起的 USSD 字符串或网络发起操作的返回结果 USSD 字符串将发送给网络。通 过非请求结果码+CUSD，返回网络侧的返回结果 USSD 字符串。 语法 AT+CUSD 非结构化附加业务 测试命令 AT+CUSD=? tel 查询命令 AT+CUSD? uec tial 配置命令 AT+CUSD=[[,[,]] Q n 最大响应时间 e 参考 fid GSM 07.07 响应 +CUSD: (取值列表) OK 响应 +CUSD: OK 响应 OK +CME ERROR: 120s，受网络状态影响 参数 on 用于指示非结构化附加业务数据控制的数字参数 0 禁用结果码显示在 TA 上 C1 启用结果码显示在 TA 上 2 取消会话（不适用于查询命令的返回结果） 字符串类型，USSD 字符串（如果表示使用 GSM03.38[25]中的缺省符号值，ME/TA 将根 据 GSM07.05[24]Annex A，将 GSM 中的符号集转换为当前 TE 的字符集） GSM03.38[25]中采用整数型的小区广播数据编码方案（默认值为 0） 举例 AT+CSCS='UCS2' OK 上海移远通信技术有限公司 190 / 250 M35 AT 命令手册 AT+CUSD=1,'002A0031003000300023' +CUSD: 1,'0031002E59296C14000A0032002E65B095FB000A0033002E8BC15238000A0034002E5F6979680 00A0035002E751F6D3B000A0036002E5A314E50000A0037002E5E385DDE98CE91C7000A002A002 E900051FA000A', 72 OK 12.11. AT+CSSN 附加业务通知 该命令表示与附加业务有关的由网络发起的通知。使用该配置命令，可启用或禁用 TA 的通知结果码显 示在 TE 上。 当 =1 ， 并 且 在 移 动 终 端 发 起 呼 叫 的 过 程 中 收 到 附 加 业 务 通 知 时 ， 中 间 结 果 码 +CSSI : l [,]将被发送给 TE。 te 当=1，并且在移动终端终止呼叫过程中收到附加业务通知时，或在收到前转校验附加业务通知时， 非请求结果码+CSSU:将被发送给 TE。 uec tial 语法 AT+CSSN 附加业务通知 Q n 测试命令 AT+CSSN=? 响应 +CSSN: (取值列表), (取值列表) fide 查询命令 AT+CSSN? OK 响应 +CSSN: , n 配置命令 Co AT+CSSN=[[,]] OK 响应 OK +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 参数 在发起呼叫建立后，用以表示是否显示+CSSI: [,]结果码状态的数字参数 0 禁用 上海移远通信技术有限公司 191 / 250 M35 AT 命令手册 1 启用 当接收到呼叫转移补充业务通知，一个终端呼叫建立或者在呼叫进行中的时候，用以表示是 否显示+CSSU: 结果码状态的数字参数 0 禁用 1 启用 0 激活无条件呼叫转移 1 激活有条件呼叫转移 2 呼叫已经被转移 3 呼叫等待中 4 是CUG呼叫（也会出现） 5 禁止出局呼叫 6 禁止入局呼叫 7 CLIR抑制关闭 关闭的用户组索引号 CQouneficdteenl tial 0指示这是一个呼叫转移的呼叫 上海移远通信技术有限公司 192 / 250 M35 AT 命令手册 13 音频控制命令 13.1. ATL 设置监听扬声器音量 语法 ATL 设置监听扬声器音量 执行命令 ATL l 最大响应时间 te 参考 V.25ter uec tial 参数 0 低扬声器音量 Q n 1 中低扬声器音量 e 2 中扬声器音量 3 高扬声器音量 fid 备注 Con GSM无效。 响应 OK 300ms 13.2. ATM 设置监听扬声器模式 语法 ATM 设置监听扬声器模式 执行命令 响应 ATM OK 上海移远通信技术有限公司 193 / 250 M35 AT 命令手册 最大响应时间 参考 V.25ter 300ms 参数 0 扬声器关闭 1 扬声器被打开，当有载波被检测到 2 扬声器打开 备注 ATL 以及 ATM 命令仅在 V.25ter 生效，对 GSM 无效。 tel 13.3. AT+VTD 配置 DTMF 音播放时长 c l 语法 ue tia AT+VTD 配置 DTMF音播放时长 测试命令 Q n AT+VTD=? 响应 +VTD: ( 取 值 列 表 )[,( 取 值 列 表)] fide 查询命令 AT+VTD? OK 响应 +VTD: , nOK o 配置命令 响应 C AT+VTD=[,] +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 194 / 250 M35 AT 命令手册 参数 1-255 0 1-100000 以 100ms 为单位，设置播放 DTMF 的间隔时长 以 1/1000 秒为单位的 DTMF 音调播放时长，缺省默认为 0 单个 DTMF 音播放的时长，单位为 ms 备注 该命令控制 AT+VTS 产生的 DTMF 音播放时长。 13.4. AT+VTS DTMF 音调发送 该命令可发送一个或多个 ASCII 字符，这些字符的作用是使 MSC（Mobile Switching Center）为远程 l 用户发射双音多频 DTMF（Dual Tone Multi Frequency）音调。 te 语法 c l AT+VTS DTMF 音调发送 ue tia 测试命令 AT+VTS=? 响应 +VTS: (取值列表),,( 取值列表) Q n 配置命令 e AT+VTS= fid 最大响应时间 参考 n GSM 07.07 OK 响应 OK +CME ERROR: 取决于的长度 Co 参数 最大值为 20 个字符。必须放在双引号间。它由下面的字符串构成，间隔以','隔开。但 是单个字符不需要引号  单个 ASCII 字符，范围：0-9, #,*, A-D。它作为一个 DTMF 音调的序列被解 析，持续时间通过 AT+VTD 命令来控制  {, }作为一个 DTMF 音调被解析，持续时间由控制 1-255 以 1/10 秒为单位的 DTMF 音调播放时长 上海移远通信技术有限公司 195 / 250 M35 AT 命令手册 备注 1. 该配置命令仅适用于当前语音呼叫； 2. 允许用户在一段时间内发送一个序列的 DTMF 音调； 3. 允许用户发送单一的 DTMF 音调。在这种情况下，时间段可以在呼叫过程中单独决定。 举例 ATD10086; OK AT+VTS=1 OK //建立呼叫 //根据语音提示输入 1 的 DTMF 音 13.5. AT+CALM 来电警报模式 l 语法 te AT+CALM 来电警报模式 c l 测试命令 ue tia AT+CALM=? 查询命令 Q n AT+CALM? fide 配置命令 AT+CALM= n 最大响应时间 o 参考 C GSM 07.07 响应 +CALM: (取值列表) OK 响应 +CALM: OK 响应 OK +CME ERROR: 300ms 参数 0 1 正常模式 静音模式（禁止播放来自 ME 的所有声音） 上海移远通信技术有限公司 196 / 250 备注 该配置命令仅适用于来电铃音控制。 M35 AT 命令手册 13.6. AT+CRSL 来电音量等级 语法 AT+CRSL 来电音量等级 测试命令 响应 AT+CRSL=? 查询命令 l AT+CRSL? cte l 配置命令 AT+CRSL= ue tia 最大响应时间 Q n 参考 GSM 07.07 +CRSL: (取值列表) OK 响应 +CRSL: OK 响应 OK +CME ERROR: 300ms fide 参数 Con 整数型，制造商自定义范围：0-100。最小值为最低音量等级。 13.7. AT+CLVL 扬声器音量等级 语法 AT+CLVL 扬声器音量等级 测试命令 AT+CLVL=? 响应 +CLVL: (取值列表) OK 上海移远通信技术有限公司 197 / 250 M35 AT 命令手册 查询命令 AT+CLVL? 配置命令 AT+CLVL= 最大响应时间 参考 GSM 07.07 响应 +CLVL: OK 响应 OK +CME ERROR: 300ms 参数 整数型，制造商自定义范围：0-100。最小值为最低音量等级。 tel 13.8. AT+CMUT 上行静音控制 uec tial 语法 AT+CMUT 上行静音控制 Q n 测试命令 AT+CMUT=? fide 查询命令 AT+CMUT? on 配置命令 C AT+CMUT= 响应 +CMUT: (取值列表) OK 响应 +CMUT: OK 响应 OK +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 198 / 250 参数 0 关闭静音 1 打开静音(MIC 被静音) 备注 仅在呼叫过程中，该命令操作有效。 M35 AT 命令手册 13.9. AT+QSIDET 配置侧音增益等级 语法 l AT+QSIDET 配置侧音增益等级 测试命令 te AT+QSIDET= ? uec tial 查询命令 AT+QSIDET? Q fiden 配置命令 AT+QSIDET= n 最大响应时间 o 参考 C Quectel 响应 +QSIDET: (取值列表) OK 响应 +QSIDET(NORMAL_AUDIO): OK +QSIDET(HEADSET_AUDIO): OK 响应 OK +CME ERROR: 300ms 参数 增益等级范围：0-255 上海移远通信技术有限公司 199 / 250 M35 AT 命令手册 13.10. AT+QMIC 配置麦克风增益等级 语法 AT+QMIC 配置麦克风增益等级 测试命令 AT+QMIC=? 响应 +QMIC: (取值列表), (取值列表) OK 查询命令 响应 AT+QMIC? +QMIC: ,,<gai l 配置命令 AT+QMIC=, te 最大响应时间 c l 参考 ue tia Quectel nlevel(Loudspeaker_Mic)> OK 响应 OK +CME ERROR: 300ms Q n 参数 e fid 0 主通道 1 耳机通道 2 主免提通道 侧音增益等级范围：0-15 Con 13.11. AT+QLDTMF 产生本地 DTMF 音 语法 AT+QLDTMF 产生本地 DTMF 音 测试命令 AT+QLDTMF=? 响应 +QLDTMF: (取值列表), (取值列 表) OK 上海移远通信技术有限公司 200 / 250 M35 AT 命令手册 配置命令 AT+QLDTMF=[,] 执行命令 AT+QLDTMF 最大响应时间 参考 Quectel 响应 OK +CME ERROR: 响应 OK 取决于的长度 参数 数字参数1~1000，表明所有DTMF音的持续时间，以1/10秒为单位 字符串参数，最大输入20个DTMF音，用逗号隔开，DTMF音为ASCII字符，含0-9，#， *，A-D l 备注 te AT+QLDTMF 执行命令操作用于终止当前所有正在生成的 DTMF 音和任何 DTMF 音序列。 uec tial 13.12.AT+QAUDCH 切换音频通道 Q en 语法 fid AT+QAUDCH 切换音频通道 测试命令 AT+QAUDCH=? on 查询命令 C AT+QAUDCH? 响应 +QAUDCH: (取值列表) OK 响应 +QAUDCH: 配置命令 AT+QAUDCH=[] 最大响应时间 参考 Quectel OK 响应 OK +CME ERROR: 300ms 上海移远通信技术有限公司 201 / 250 参数 0 主通道(默认) 1 耳机通道 2 主免提通道 M35 AT 命令手册 13.13. AT+QAUDLOOP 音频通道回环测试 语法 AT+QAUDLOOP 音频通道回环测试 测试命令 响应 AT+QAUDLOOP=? +QAUDLOOP: (取值列表), (取值列表) l 配置命令 te AT+QAUDLOOP=[,] c l 最大响应时间 ue tia 参考 Quectel OK 响应 OK +CME ERROR: 300ms Q n 参数 fide Con 0 停止测试 1 开始测试 0 主通道（默认值） 1 辅助耳机通道 2 主免提通道 13.14. AT+QLTONE 产生本地定制单音 语法 AT+QLTONE 产生本地定制单音 测试命令 AT+QLTONE=? 响应 +QLTONE: ( 取 值 列 表 ),( 取 值 列 表 ),( 取 值 列 表 ),( 取 值 列 表 ) , 上海移远通信技术有限公司 202 / 250 M35 AT 命令手册 (取值列表) 配置命令 AT+QLTONE=,,< periodOn>,, 最大响应时间 OK 响应 OK +CME ERROR: 取决于要播放的定制单音长度 参考 Quectel 参数 l te 0 停止播放 1 开始播放 播放单音频率 一个周期内播放单音的时长 一个周期内静音的时长 单音播放总时长，单位为毫秒 uec tial 备注 当开始播放指定频率单音时，模块会持续播放该单音时长，然后再停止播放单音 时长，依次循环。直至总时长结束。 Q fiden 13.15. AT+QTONEP 配置 DTMF/TONE 输出路径 语法 n AT+QTONEP 配置 DTMF/TONE 输出路径 o 测试命令 C AT+QTONEP=? 响应 +QTONEP: (取值列表) 查询命令 AT+QTONEP OK 响应 +QTONEP: 配置命令 AT+QTONEP= OK 响应 OK ERROR 上海移远通信技术有限公司 203 / 250 M35 AT 命令手册 最大响应时间 参考 Quectel +CME ERROR: 300ms 参数 0 从正常通道输出 DTMF 音 1 从辅助通道输出 DTMF 音 2 从主通道输出 DTMF 音 3 自动 备注 l 当 AT+QTONEP=3 时，DTMF 音输出由当前 AT+QAUDCH 所配置的值控制。 uecte tial 13.16.AT+QTDMOD 设置 DTMF检测模式 语法 Q n AT+QTDMOD 设置 DTMF 检测模式 e 测试命令 响应 fid AT+QTDMOD=? +QTDMOD:(取值列表), (取值列表) n 查询命令 o AT+QTDMOD? OK 响应 +QTDMOD: , C OK 配置命令 响应 AT+QTDMOD=, ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 204 / 250 M35 AT 命令手册 参数 1 设置DTMF检测范围 2 设置检测模式 0 当=1时，检测所有的DTMF音。包含1400和2300的交接信号 当=2时，一般算法去侦测音 1 当=1时，仅支持检测1400和2300的交接信号 当=2时，加强抖动算法去侦测音 2 当=1时，不检测1400和2300的交接信号 备注 1. 当 AT+QTDMOD =1,0 时，侦测所有的音，包括 DTMF、1400Hz 和 2300Hz； 2. 当 AT+QTDMOD =1,1 时，优化侦测并且仅仅侦测 1400Hz 和 2300Hz； 3. 当 AT+QTDMOD =1,2 时，检测 DTMF 音但不包含 1400Hz 和 2300Hz 的交接信号； 4. 当 AT+QTDMOD =2,0 时，一般算法去侦测音（包括 DTMF、1400Hz 和 2300Hz）； l 5. 当 AT+QTDMOD =2,1 时，加强抖动算法去侦测音； 6. 请参考 AT+QTONEDET。 uecte tial 13.17.AT+QTONEDET DTMF检测 语法 Q n AT+QTONEDET DTMF 检测 e 测试命令 fid AT+QTONEDET=? n 查询命令 Co AT+QTONEDET? 响应 +QTONEDET: (取值列表) OK 响应 +QTONEDET: OK 配置命令 响应 AT+QTONEDET=[,][ OK ,][,][,] +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 205 / 250 M35 AT 命令手册 参数 < mode> 0 关闭DTMF检测 1 开启DTMF检测 2 检测1400Hz和2300Hz，100ms的DTMF 3 检测1400Hz和2300Hz，400ms的DTMF 4 配置DTMF检测入点 5 开启调试模式 当=2，配置如下： 0 查询1400Hz和2300Hz两个频率点100ms侦测阀值 1 设置1400Hz和2300Hz两个频率点100ms侦测阀值. 有效音前 空闲值个数, 有效音最低阀值,有效音最高 阀值 当=3,配置如下： 0 查询1400Hz和2300Hz两个频率点400ms侦测阀值 l 1 设置1400Hz和2300Hz两个频率点400ms侦测阀值. 有效音前 空闲值个数, 有效音最低阀值, 有效音最高 te 阀值 uec tial Q fiden Con 当=4,配置如下： 0 查询DTMF侦测阀值 1 设置DTMF侦测阀值. 有效音前空闲值个数 有效音最低阀值, 有消音最高阀值 当=5，配置如下： 0 正常工作状态, 报告+QTONEDET: x,x 1 调试状态，报告+QTONEDTD:x,x,… 2 混合状态，报告+QTONEDTD:x,x,…和+QTONEDET: x,x, 有效音前空闲值个数 有效音最低阀值 有效音最高阀值 DTMF代码 48 DTMF 0 49 DTMF 1 50 DTMF 2 51 DTMF 3 52 DTMF 4 53 DTMF 5 54 DTMF 6 55 DTMF 7 56 DTMF 8 57 DTMF 9 65 DTMF A 66 DTMF B 上海移远通信技术有限公司 206 / 250 M35 AT 命令手册 67 68 42 35 69 70 100 400 DTMF C DTMF D DTMF * DTMF # 1400Hz 频率 2300Hz 频率 被侦测到100ms的1400Hz and 2300 Hz 被侦测到400ms的1400Hz and 2300 Hz 备注 1. 仅在通话中有效； 2. 若 DTMF 音的播放时长在阀值范围内，则该指令设置生效，单位为 20ms； 3. 在调试状态下，上报+QTONEDTD: ,,,, ,,； 4. 上报时： l a) +QTONEDET: 50 检测到 DTMF 2 b) +QTONEDET: 69,100 检测到 100ms 的 1400Hz 单音 te c) +QTONEDET: 70,100 检测到 100ms 的 2300Hz 单音 c l d) +QTONEDET: 69,400 检测到 400ms 的 1400Hz 单音 e) +QTONEDET: 70,400 检测到 400ms 的 2300Hz 单音 ue tia 5. 请参考AT+QTDMOD。 Q n 13.18. AT+QWDTMF 通话中播放 DTMF 音 fide 语法 AT+QWDTMF 通话中播放 DTMF 音 n 测试命令 响应 Co AT+QWDTMF=? +QWDTMF: (取值列表), (取值列 表), (',,'), (取值列表), (取值列表) 配置命令 AT+QWDTMF=, ,(',,')[,][ ,] OK 响应 执行成功： +QWDTMF: 5 OK 执行失败： +QWDTMF: 上海移远通信技术有限公司 207 / 250 M35 AT 命令手册 最大响应时间 参考 Quectel OK +CME ERROR: 取决于要播放的 DTMF 音的长度 参数 控制对方听到的音量 0 静音，7 最大音量值 本地Speack输出音量 0 静音，7 最大音量值，推荐设置为0 播放的TONE串 '0' DTMF 0 l '1' DTMF 1 '2' DTMF 2 te '3' DTMF 3 c l '4' DTMF 4 '5' DTMF 5 ue tia '6' DTMF6 '7' DTMF 7 '8' DTMF 8 Q n '9' DTMF 9 'A' DTMF A e 'B' DTMF B 'C' DTMF C fid 'D' DTMF D '*' DTMF * '#' DTMF # n 'E' 1400Hz频率 o'F' 2300Hz频率 'G' 1KHz频率 C 播放每个TONE时间长度，单位ms 播放TONE串时每个TONE间隔静音时间长度，单位ms 播放成功或失败提示 值为5表示播放成功，其它表示失败 播放通道，仅非通话时起作用。通话时与语音同一个通道, 即由 AT+QAUDCH 控 制。此参数缺省时，播放通道也是由 AT+QAUDCH 控制。 0 主通道(默认) 1 耳机通道 2 主免提通道 DTMF 音合成算法。缺省为 0。 上海移远通信技术有限公司 208 / 250 M35 AT 命令手册 0 算法 1 1 算法 2 备注 1. AT+QWDTMF=7,0,'0A5,50,50,1,55,50,23,100,50' 发送 DTMF „0‟ 音 50ms，静音 50ms；发送 DTMF „A‟ 音 50ms，静音 50ms；发送 DTMF „5‟ 音 50ms， 静音 50ms；发送 DTMF „1‟ 音 55ms，静音 50ms；发送 DTMF „2‟ 音 100ms，静音 50ms；发送 DTMF „3‟ 音 100ms，静音 50ms； 2. 非通话中有效。 CQouneficdteenl tial 上海移远通信技术有限公司 209 / 250 M35 AT 命令手册 14 硬件相关命令 14.1. AT+CCLK 实时时钟 语法 AT+CCLK 实时时钟 测试命令 AT+CCLK=? l 查询命令 te AT+CCLK? c l 配置命令 ue tia AT+CCLK= Q n 最大响应时间 e 参考 GSM 07.07 响应 OK 响应 +CCLK: OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 Con 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年，月，日，小时，分钟，秒和时 区（用当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围 -47~+48） 举例 AT+CCLK? //查询当前 ME 时间 +CCLK: '08/01/04, 00:19:43+00' OK 上海移远通信技术有限公司 210 / 250 M35 AT 命令手册 14.2. AT+QALARM 闹铃设置 语法 AT+QALARM 闹铃设置 测试命令 AT+QALARM=? 响应 +QALARM: ( 取 值 列 表 ),,( 取 值 列 表),(取值列表) OK 配置命令 响应 AT+QALARM=,,, 最大响应时间 l 参考 te Quectel ERROR +CME ERROR: 300ms c l 参数 ue tia Q n e Confid 整数型；闹铃状态指示 0 删除闹铃 1 设置闹铃 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年、月、日、小时、分钟、秒和时区（用 当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围-47~+48） 整数型；指示闹铃重复模式 0 一次性闹铃 1 日重复闹铃 2 周重复闹铃 3 月重复闹铃 整数型；指示闹铃时间到，ME 开关机操作 0 无任何操作，只上报'ALARM RING' 提示 1 关机闹铃，上报'ALARM RING'提示且 5S 后关机 2 开机闹铃，上报'ALARM MODE'提示，模块开机并进入闹铃模式 备注 闹铃模式下，协议栈和 SIM 卡协议关闭。只支持一些 AT 命令。若未按电源开关或未切换至全功能模式 （AT+CFUN=1），ME 将在 90S 内关机。如果按下电源开关，ME 将会进入关机状态。 上海移远通信技术有限公司 211 / 250 M35 AT 命令手册 14.3. AT+CBC 查询电池电量和充电状态 语法 AT+CBC 查询电池电量和充电状态 测试命令 AT+CBC=? 响应 +CBC: (取值列表),(取值列表),(voltage) OK 执行命令 响应 AT+CBC +CBC: , , OK 最大响应时间 l 参考 te GSM 07.07 +CME ERROR: 300ms c l 参数 ue tia Q n e 充电状态 0 不在充电 电池电量级别 0...100 电池相对于其原始电量的百分比 电池电压（单位：mV） fid 备注 Con 由于 M35 不支持充电功能，和不适用；仍然有效反映 VBATT 的电压值。 14.4. AT+QSCLK 慢时钟配置 语法 AT+QSCLK 慢时钟配置 测试命令 AT+QSCLK=? 响应 +QSCLK: (取值列表) OK 上海移远通信技术有限公司 212 / 250 M35 AT 命令手册 查询命令 AT+QSCLK? 响应 +QSCLK: 配置命令 AT+QSCLK= 最大响应时间 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms 参数 l 0 禁用慢时钟 1 启用慢时钟，拉高 DTR 生效，拉低 DTR 唤醒 2 启用慢时钟，5 秒内串口无数据交互即进入睡眠模式；有数据时唤醒 cte l 备注 ue tia 模式 2 下，第一次串口数据会被丢弃，仅仅起唤醒作用。建议此模式下先发一个 AT 来唤醒模块再继续其 他业务。 Q en 14.5. AT+QLEDMODE 网络指示灯配置 fid 语法 n AT+QLEDMODE 网络指示灯配置 测试命令 Co AT+QLEDMODE=? 响应 +QLEDMODE: (取值列表) OK 查询命令 响应 AT+QLEDMODE? +QLEDMODE: 配置命令 AT+QLEDMODE= OK 响应 OK ERROR +CME ERROR: 上海移远通信技术有限公司 213 / 250 M35 AT 命令手册 最大响应时间 参考 Quectel 300ms 参数 0 1 2 来电振铃时网络指示灯快速闪烁 来电振铃对网络指示灯无影响 来电振铃对网络指示灯无影响，但此时有 URC 上报，串口 RI 引脚不会变化，直到振铃 结束 CQouneficdteenl tial 上海移远通信技术有限公司 214 / 250 M35 AT 命令手册 15 其他命令 15.1. A/ 重复上一条 AT 指令 语法 A/ 重复上一条 AT 指令 执行命令 A/ l 最大响应时间 te 参考 V.25ter 响应 上一条 AT 指令执行的返回 取决于上一个 AT 命令 uec tial 举例 AT Q n OK A/ e OK //重复上一次执行的 AT 操作 fid 15.2. ATE 命令回显模式 Con 使用该命令，可设置 TA 在命令状态下是否回显从 TE 接收到的字符。 语法 ATE 命令回显模式 执行命令 响应 ATE[] OK 最大响应时间 参考 V.25ter 300ms 上海移远通信技术有限公司 215 / 250 参数 0 关闭回显 1 启用回显 M35 AT 命令手册 15.3. ATS3 配置命令行终止符 使用该命令，可设置用于 AT 命令行终止符，该字符能被 TA 识别。 语法 ATS3 配置命令行终止符 查询命令 ATS3? tel 配置命令 ATS3= c l 最大响应时间 ue tia 参考 V.25ter 响应 OK 响应 OK 300ms Q en 参数 fid 0-13-127 命令行终止符（默认为 13=） Con 15.4. ATS4 设置响应格式字符 使用该命令，可设置用于获取结果码和信息文本的字符，该字符是由 TA 产生的。 语法 ATS4 设置响应格式字符 查询命令 响应 ATS4? OK 上海移远通信技术有限公司 216 / 250 配置命令 ATS4= 最大响应时间 参考 V.25ter 响应 OK 300ms 参数 0-10-127 响应格式字符（默认为 10=） M35 AT 命令手册 15.5. ATS5 配置命令行编辑字符 l 使用该命令，可设置用于删除命令行中的字符，该字符由 TA 产生。 te 语法 c l ATS5 设置响应格式字符 ue tia 查询命令 响应 ATS5? Q n 配置命令 e ATS5= fid 最大响应时间 参考 V.25ter OK 响应 OK 300ms Con 参数 0-8-127 命令行编辑字符（默认为 8=） 上海移远通信技术有限公司 217 / 250 M35 AT 命令手册 15.6. AT+QRIMODE 设置 RI 时长 语法 AT+QRIMODE 设置 RI 时长 查询命令 AT+QRIMODE=? 响应 +QRIMODE: (取值列表) 查询命令 AT+QRIMODE? OK 响应 +QRIMODE: 配置命令 AT+QRIMODE= tel 最大响应时间 c l 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms ue tia 参数 CQonfiden 0 收到短消息时 RI 拉低 120ms，收到其他 URC 提示时 RI 拉低 120ms 1 收到短消息时 RI 拉低 120ms，收到其他 URC 提示时 RI 拉低 50ms 2 接收到新短信时，RI 拉低 120ms，其他 URC 对 RI 引脚无影响 上海移远通信技术有限公司 218 / 250 M35 AT 命令手册 16 附录 16.1. 参考文档 表 1：参考文档 序号 [1] l [2] te [3] c l [4] ue tia [5] [6] 文档名 Quectel_GSM 模块 AT 命令应用指导 Quectel_GSM_TCPIP_Application_Notes Quectel_GPRS_Startup_User_Guide Quectel_GSM_MUX_Application_Notes Quectel_SMS_Application_Notes Quectel_M35_Hardware_Design 备注 GSM 模块 AT 命令应用指导 TCPIP 应用指导 GPRS 配置应用指导 MUX 应用指导 短消息应用指导 M35 硬件设计手册 Q fiden 16.2.术语缩写 n 表 2：术语缩写 o 缩写 C ADC 描述 Analog-to-Digital Converter AMR Adaptive Multi-Rate ARP Antenna Reference Point ME Mobile Equipment TA Terminal Adapter MS Mobile Station 上海移远通信技术有限公司 219 / 250 M35 AT 命令手册 DCE Data Communication Equipment TE Terminal Equipment DTE Data Terminal Equipment RTS/CTS Request To Send/Clear To Send GPRS General Packet Radio Service DCD Dynamic Content Delivery DTR Data Terminal Ready CSD PSC l PDP te TCP c l UDP Circuit Switch Data Primary Synchronization Code Packet Data Protocol Transmission Control Protocol User Datagram Protocol ue tia 16.3. AT&F 影响到的 AT 命令及参数 Q en 表 3：AT&F 影响到的 AT 命令及参数 fid AT命令 ATE n ATQ Co ATS0 参数名称 默认值 1 0 0 ATS3 13 ATS4 10 ATS5 8 ATS6 2 ATS7 60 上海移远通信技术有限公司 220 / 250 M35 AT 命令手册 ATS8 ATS10 ATV ATX AT&C AT&D AT+ILRR AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR AT+CMEE AT+COLP AT+QDISH AT+CRSL AT+CLVL AT+CUSD AT+CSSN AT+CSNS AT+CMGF AT+CNMI 2 15 1 4 1 0 0 ,, l te c l ue tia Q n e fid Con 0 0,0,0 0 'GSM' 129 0 0 1 0 0 55 当 AT+QAUDCH=0 时，默认值为：60 当 AT+QAUDCH=1 时，默认值为：40 当 AT+QAUDCH=2 时，默认值为：36 0 , 0,0 0 0 ,,,, 2,1,0,0,0 上海移远通信技术有限公司 221 / 250 M35 AT 命令手册 AT+CSDH 0 AT+CSMS AT+QSIDET AT+QMIC AT+QSCLK 0,1,1,1 ,, 当 AT+QAUDCH=0 时，默认值为：80 当 AT+QAUDCH=1 时，默认值为：144 4,9,8 0 AT+QCLIP 0 AT+QCOLP AT+QIURC l AT+QEXTUNSOL te AT+QRIMODE uec tial 16.4. AT&W 影响到 AT 命令参数列表 Q n 表 4：AT&W 影响到的 AT 命令参数列表 e AT 指令 fid ATE ATQ n ATS0 Co ATS3 参数名称 0 1 0 0 是否通过 AT&V 显示 是 是 是 是 ATS4 是 ATS5 是 ATS6 是 ATS7 是 ATS8 是 上海移远通信技术有限公司 222 / 250 M35 AT 命令手册 ATS10 ATV ATX AT&C AT&D AT+ICF AT+IFC AT+ILRR AT+IPR AT+QMUXC AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CMEE AT+COLP AT+CR AT+QDISH AT+CRSL AT+CLVL AT+CUSD AT+CSNS AT+CMGF AT+CNMI 是 是 否 是 是 , 是 , 是 是 是 否 tel 是 ,, 是 uec tial 是 是 Q n 是 e 是 fid 是 是 n 是 Co 否 否 否 是 是 是 ,,,, 是 上海移远通信技术有限公司 223 / 250 M35 AT 命令手册 AT+CSDH 是 AT+QSIDET AT+QMIC AT+QSCLK 是 ,, 否 AT+QCLIP 是 AT+QCOLP 是 AT+QIURC AT+QEXTUNSOL AT+QRIMODE l AT+QSIMDET te AT+QSIMSTAT 否 否 否 ,, 是 是 uec tial 16.5. ATZ 影响到的 AT 命令参数列表 Q n 表 5：ATZ 影响到的 AT 命令参数列表 fide AT指令 ATE n ATQ Co ATS0 参数名称 默认值 1 0 0 ATS3 13 ATS4 10 ATS5 8 ATS6 2 ATS7 60 上海移远通信技术有限公司 224 / 250 M35 AT 命令手册 ATS8 ATS10 ATV ATX AT&C AT&D AT+ILRR AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR AT+CMEE AT+COLP AT+CR AT+QDISH AT+CRLP AT+CRSL AT+CLVL AT+CUSD AT+CSSN AT+CSNS AT+CMGF 2 15 1 4 1 0 0 0 ,, 0,0,0 0 tel 'GSM' 129 uec tial 0 0 Q n 1 e 0 fid 0 0 n ,,,,, 61,61,128,6,0,3 Co 55 当 AT+QAUDCH=0 时，默认值为：60 当 AT+QAUDCH=1 时，默认值为：40 当 AT+QAUDCH=2 时，默认值为：35 0 , 0,0 0 0 上海移远通信技术有限公司 225 / 250 M35 AT 命令手册 AT+CNMI ,,,, 2,1,0,0,0 AT+CSDH 0 AT+CSMS AT+QSIDET AT+QMIC AT+QSCLK 0 ,, 当 AT+QAUDCH=0 时，默认值为：80 当 AT+QAUDCH=1 时，默认值为：144 4,9,8 0 AT+QCLIP AT+QCOLP AT+QIURC tel AT+QEXTUNSOL AT+QRIMODE uec tial AT+QSIMDET AT+QSIMSTAT ,, 0 0 1 0 0 0,0,0 0 Q en 16.6. AT&V 显示当前配置信息 fid 表 6：AT&V 显示当前配置信息 n AT&V or AT&V0 o AT&V C ACTIVE PROFILE E: 1 Q: 0 V: 1 X: 4 S0: 0 S2: 43 S3: 13 S4: 10 上海移远通信技术有限公司 226 / 250 M35 AT 命令手册 S5: 8 S6: 2 S7: 60 S8: 2 S10: 15 +CR: 0 +FCLASS: 0 +CMGF: 0 +CSDH: 0 +ILRR: 0 +CMEE: 1 +CBST: 7,0,1 +IFC: 0,0 +ICF: 3,3 +CNMI: 2,1,0,0,0 +CSCS: 'GSM' l +IPR: 0 &C: 1 te &D: 0 +CSTA: 129 c l +CRLP: 61,61,128,6,0,3 ue tia +CCWE:0 +QSIMSTAT: 0 +CMUX: -1 +CCUG: 0,0,0 Q n +CLIP:0 e +COLP: 0 +CCWA: 0 fid +CAOC: 1 +CLIR: 0 +CUSD: 0 n +CREG: 0 +QSIMDET: 0,0 o +QMIC: 4,9,8 C +QECHO(NORMAL_AUDIO): 253,96,16388,57351,0 +QECHO(Earphone_AUDIO): 253,0,10756,57351,1 +QECHO(LoudSpk_AUDIO): 224,96,5256,57351,2 +QSIDET(NORMAL_AUDIO): 80 +QSIDET(HEADSET_AUDIO): 144 +QCLIP: 0 +QCOLP: 0 +CSNS: 0 OK 上海移远通信技术有限公司 227 / 250 M35 AT 命令手册 16.7. AT&V 内容格式对照表 表 7：ATV 内容格式对照表 ATV1 ATV0 描述 OK 0 执行命令的正确确认 CONNECT 1 连接已经建立，DCE 从命令状态切换为数据状态 RING 2 DCE 已经检测到一个来自网络的呼叫 NO CARRIER ERROR NO DIALTONE tel BUSY c l NOANSWER ue tia PROCEEDING Q n CONNECT 3 4 6 7 8 9 制造商特殊需求 连接中断或尝试建立连接失败 命令不能被识别，超出命令行的最大长度，参数值无效 或命令进程中的其他问题 无法检测到拨号音 检测到忙音信号（占线） 若'@'拨号修改量被使用，则紧跟 5 秒静默时间的远程振 铃没有在定时器（S7）超时前检测到，即无应答。 一条 AT 命令正在被处理 与 CONNECT 相同，但包含制造商特殊需求定义的文本， 该文本可以是指定的 DTE 速率，行速度，错误控制，数 据压缩或其他状态 fide 16.8. URCs 说明列表 n 表 8：URCs 说明列表 Co 序号 URC 显示 含义 条件 1 +CMTI:, 新短消息到达并存储在存储器内 AT+CNMI=2,1 +CMT:[], 模式） AT+CNMI=2,2 +CMT:,[],[,,,,,,,] 4 +CBM: 新小区广播消息到达并直接输出至 TE（PDU 模式） AT+CNMI=2,2 上海移远通信技术有限公司 228 / 250 M35 AT 命令手册 +CBM:,,, 新小区广播消息到达并直接输出至 5 ,,, TE（TEXT 模式） AT+CNMI=2,2 短 消 息 状 态 报 告 并 直 接 输 出 至 TE 6 +CDS: （PDU 模式） AT+CNMI=2,2 +CDS:,,[],[],< 短 消 息 状 态 报 告 并 直 接 输 出 至 TE 7 scts>,, （TEXT 模式） AT+CNMI=2,2 +CGEV:NW 8 DEACT, 网络去 GPRS 附着 AT+CGEREP=1 [,] +CGEV:ME 9 DEACT, ME 去 GPRS 附着 AT+CGEREP=1 [,] 10 11 12 13 14 15 16 17 18 19 20 21 +CGEV:NW DETACH +CGEV:ME DETACH l +CGREG:1 te +CGREG:0 c l +CGREG:1, ue tia +CGREG:0, +CSQN:, 网络去 GPRS 附着 ME 去 GPRS 附着 网络去注册 网络未注册 网络注册及本地小区信息 网络未注册及本地小区信息 信号质量改变 Q en 禁止可用网络 fid +CMWT:,,, 短消息等待 ,, +QGURC: 通话状态相关结果码 n +CBCN:, 显示电池充电状态及电量等级 Co +QBAND: 显示频率模式 AT+CGEREP=1 AT+CGEREP=1 AT+CGREG=1 AT+CGREG=1 AT+CGREG=2 AT+CGREG=2 AT+QEXTUNSOL ='SQ',1 AT+QEXTUNSOL ='FN',1 AT+QEXTUNSOL ='MW',1 AT+QEXTUNSOL ='UR',1 AT+QEXTUNSOL ='BC',1 AT+QEXTUNSOL ='BM',1 22 +TSMSINFO: 附加短消息信息 AT+QEXTUNSOL ='SM',1 +CCINFO:, 的呼叫序号且保留剩余的通话数目 ='CC',1 24 RING 来电指示 N/A 25 Call Ready 设置准备好建立或接受呼叫 N/A 上海移远通信技术有限公司 229 / 250 M35 AT 命令手册 26 UNDER_VOLTAGE POWER 低电压关机指示 N/A DOWN 27 UNDER_VOLTAGE WARNING 低电压报警 N/A OVER_VOLTAGE POWER 28 高电压关机指示 N/A DOWN 29 OVER_VOLTAGE WARNING 高电压报警 N/A 30 UNDER_VOLTAGE POWER 正常关机 N/A DOWN +COLP:,[,,[CLI validity]], 相关信息 AT+COLP=1 32 33 34 35 36 37 38 39 40 41 42 43 +CLIP:,'',,, +CRING: 显示主叫识别相关信息 来电指示 AT+CLIP=1 AT+CRC=1 l +CREG: ME GSM 网络注册状态指示 AT+CREG=1 te +CREG:[,,] c l +CCWA:,,[,] ME GSM 网络注册状态及小区信息指 示，当网络注册状态及小区信息更改 AT+CREG=2 时上报 呼叫等待指示 AT+CCWA=1,1 RDY ME 初始化完毕 N/A Q n +CFUN:1 ME 全功能模式 N/A e +CPIN: SIM 卡 PIN 状态 N/A fid MO RING 去电呼叫振铃 AT+QMOSTAT=1 MO CONNECTED on ALARM RING CALARM MODE 去电呼叫建立成功 闹铃时间到 ME 闹铃开机 AT+QMOSTAT=1 AT+QALARM=1,,,0/1 AT+QALARM=1,,,2 上海移远通信技术有限公司 230 / 250 M35 AT 命令手册 16.9. +CME ERROR 错误报告列表 非请求结果码+CME ERROR: 表示移动设备或网络报错，类似于 ERROR 错误结果码。一旦命 令被执行，不管正确与否，都要返回 OK 或者 ERROR 结果。 表 9：+CME ERROR 错误代码列表 含义 0 Phone failure 1 No connection to phone 2 3 4 5 6 7 10 11 12 13 14 15 Phone-adaptor link reserved Operation not allowed l Operation not supported te PH-SIM PIN required c l PH-FSIM PIN required ue tia PH-FSIMPUK required SIM not inserted Q en SIM PIN required fid SIM PUK required SIM failure nSIM busy CoSIM wrong 16 Incorrect password 17 SIM PIN2 required 18 SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 上海移远通信技术有限公司 231 / 250 M35 AT 命令手册 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 40 41 42 43 44 45 46 47 103 106 107 111 Network not allowed - emergency calls only Network personalization PIN required l Network personalization PUK required te Network subset personalization PIN required c l Network subset personalization PUK required ue tia Service provider personalization PIN required Service provider personalization PUK required Q n Corporate personalization PIN required e Corporate personalization PUK required fid Illegal MS Illegal ME nGPRS services not allowed CoPLMN not allowed 112 Location area not allowed 113 Roaming not allowed in this location area 132 Service option not supported 133 Requested service option not subscribed 134 Service option temporarily out of order 上海移远通信技术有限公司 232 / 250 M35 AT 命令手册 148 Unspecified GPRS error 149 PDP authentication failure 150 Invalid mobile class 151 Link NS SP person PIN required 152 Link NS SP person PUK required 153 Link SIM C person PIN required 154 Link SIM C person PUK required 302 601 602 603 604 605 606 607 608 609 610 3513 3515 Command conflict Unrecognized command l Return error te Syntax error c l Unspecified ue tia Data transfer already Action already Q n Not AT command e Multi command too long fid Abort COPS No call disconnect nUnread records on SIM CoPS busy 3516 Couldn't read SMS parameters from SIM 3517 SM not ready 3518 Invalid parameter 3738 CSCS mode not found 3742 CPOL operation format wrong 上海移远通信技术有限公司 233 / 250 M35 AT 命令手册 3765 Invalid input value 3769 Unable to get control 3771 Call setup in progress 3772 SIM powered down 3773 Invalid CFUN state 3774 Invalid ARFCN 3775 The pin is not in GPIO mode 16.10. +CMS ERROR 错误代码列表 tel 非请求结果码+CMS ERROR: 表示移动设备或网络报错，类似于 ERROR 错误结果码。一旦命 令被执行，不管正确与否，都要返回 OK 或者 ERROR 结果。 c l 表 10：+CMS ERROR 错误代码列表 ue tia Q n 300 e 301 fid 302 303 n 304 Co 305 含义 ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode 310 SIM not inserted 311 SIM pin necessary 312 PH SIM pin necessary 313 SIM failure 314 SIM busy 上海移远通信技术有限公司 234 / 250 M35 AT 命令手册 315 SIM wrong 316 SIM PUK required 317 SIM PIN2 required 318 SIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 331 332 500 512 513 514 515 517 528 529 530 531 SMSC address unknown No network l Network timeout te Unknown c l SIM not ready ue tia Message length exceeds Invalid request parameters Q n ME storage failure e Invalid service mode fid More message to send state error MO SMS is not allow nGPRS is suspended CoME storage full 3513 Unread records on SIM 3515 PS busy 3516 Couldn't read SMS parameters from SIM 3517 SM not ready 3518 Invalid parameter 上海移远通信技术有限公司 235 / 250 M35 AT 命令手册 3742 Incorrect format 3765 Invalid input value 3769 Unable to get control of required module 3771 Call setup in progress 3772 SIM powered down 3773 Unable to operate in this cfun state 3774 Invalid arfcn in this band 3775 The pin is not in GPIO mode l 16.11. 错误扩展列表 te 16.11.1. Location ID 扩展错误报告列表 uec tial 表11：LocationID 扩展错误报告列表 ID 描述 Q n 0 No error (default) e 1 Cause for protocol stack(PS) layer fid 2 Internal cause for Mobility Management(MM) layer Con 3 Cause for PPP/IP-Stack 上海移远通信技术有限公司 236 / 250 M35 AT 命令手册 16.11.2. 协议栈层（PS）错误列表 表 12：协议栈层（PS）错误列表 原因 CM Cause 0 1 3 6 8 10 11 16 17 18 19 21 22 25 26 27 28 29 30 31 描述 Radio link fail Unassigned number No route to destination Channel unacceptable Operator determined barring l Call barred te Reserved c l Normal call clearing ue tia Userbusy Q n No user responding e User alerting, no answer fid Call rejected Number changed nPre-emption CoNon-selected user clearing Destination out of order Invalid number format (incomplete number) Facility rejected Response to STATUS ENQUIRY Normal, unspecified 上海移远通信技术有限公司 237 / 250 M35 AT 命令手册 34 No circuit/channel available 38 Network out of order 41 Temporary failure 42 Switching equipment congestion 43 Access information discarded 44 Requested circuit/channel not available 47 Resource unavailable, unspecified 49 50 55 57 58 63 65 68 69 70 79 81 87 Quality of service unavailable Requested facility not subscribed l Incoming calls barred within the CUG te Bearer capability not authorized c l Bearer capability not presently available ue tia Service or option not available, unspecified Bearer service not implemented Q n ACM equal or greater than ACM maximum e Requested facility not implemented fid Only restricted digital information bearer capability is available Service or option not implemented, unspecified nInvalid transaction identifier value CoUser not member of CUG 88 Incompatible destination 91 Invalid transit network selection 95 Semantically incorrect message 96 Invalid mandatory information 97 Message type non-existent or not implemented 上海移远通信技术有限公司 238 / 250 M35 AT 命令手册 98 Message type not compatible with protocol state 99 Information element non-existent or not implemented 100 Conditional information element error 101 Message not compatible with protocol 102 Recovery on timer expiry 111 Protocol error, unspecified 127 Interworking, unspecified 128 129 130 143 144 145 159 160 161 175 176 192 193 Telematic interworking not supported Short message Type 0 not supported l Cannot replace short message te Unspecified TP-PID error c l Data coding scheme (alphabet) not supported ue tia Message class not supported Unspecified TP-DCS error Q n Command cannot be acted e Command unsupported fid Unspecified TP-Command error TPDU not supported nSC busy CoNo SC subscription 194 SC system failure 195 Invalid SME address 196 Destination SME barred 197 SM Rejected-Duplicate SM 198 TP-VPF not supported 上海移远通信技术有限公司 239 / 250 M35 AT 命令手册 199 TP-VP not supported 208 SIM SMS storage full 209 No SMS storage capability in SIM 210 Error in MS 211 Memory Capacity Exceeded 212 SIM Application Toolkit Busy 213 SIM data download error 224 225 226 255 304 305 313 320 321 322 330 340 500 CP retry exceed RP trim timeout l SMS connection broken te Unspecified error cause c l Invalid PDU mode parameter ue tia Invalid TEXT mode parameter SIM failure Q n Memory failure e Invalid memory index fid Memory full SMSC address unknown nNo+CNMA acknowledgement expected CoUnknown error 512 SMS no error 513 Message length exceeds maximum length 514 Invalid request parameters 515 ME storage failure 516 Invalid bearer service 上海移远通信技术有限公司 240 / 250 M35 AT 命令手册 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 CC Cause 768 769 770 771 772 773 774 775 Invalid service mode Invalid storage type Invalid message format Too many MO concatenated messages SMSAL not ready SMSAL no more service Not support TP-Status-Report&TP-Command in storage Reserved MTI No free entity in RL layer l The port number is already registered te There is no free entity for port number c l More message to send state error ue tia MOSMSisnotallow GPRS is suspended Q n ME storage full e Doing SIM refresh fid Command not allowed nIllegal card ID CoCall allocation fail BC fill fail Call REEST Illegal DTMF tone Illegal BC Modify actual mode 上海移远通信技术有限公司 241 / 250 M35 AT 命令手册 776 777 778 896 897 898 SS Cause 1024 1025 1033 1034 1035 1036 1037 1040 1041 1042 1043 1044 1045 1051 1053 1054 1058 1059 Data action fail No response from network Call accept not allowed General cause CSD call is aborted by user during call establishment or MT call abort MO call/USSD CSD call is disconnected due to lower layer failure Cause none Unknown subscriber l Illegal subscriber te Bearer service not provisioned c l Tele service not provisioned ue tia Illegalequipment Call barred Q n Illegal SS operation e SS error status fid SS not available nSS subscription violation oSS incompatibility C Facility not supported Absent subscriber Short term denial Long term denial System failure Data missing 上海移远通信技术有限公司 242 / 250 M35 AT 命令手册 1060 Unexpected data value 1061 PW registration failure 1062 Negative PW check 1067 Number of PW attempts violation 1078 Position method failure 1095 Unknown alphabet 1096 USSD busy 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 Rejected by user Rejected by network l Deflection to served subscriber te Special service code c l Invalid deflection to number ue tia Max number of MPTY participants exceeded Resources not available Q n General problem, unrecognized component e General problem, mistyped component fid General problem, badly structured component Invoke problem, duplicate invoked nInvoke problem, unrecognized operation CoInvoke problem, mistyped parameter 1158 Invoke problem, resource limitation 1159 Invoke problem, initiating release 1160 Invoke problem, unrecognized linked ID 1161 Invoke problem, linked resource unexpected 1162 Invoke problem, unexpected linked operation 上海移远通信技术有限公司 243 / 250 M35 AT 命令手册 1163 1164 1165 1166 1167 1168 1169 1170 MM Cause 2048 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 Return result problem, RR unrecognized invoked Return result problem, RR, return result unexpected Return result problem, RR mistyped parameter Return error problem, RE, unrecognized invoked Return error problem, RE return error unexpected Return error problem, RE unrecognized error Return error problem, RE unexpected error Return error problem, RE mistyped parameter l Cause none te IMSI unknown in HLR c l Illegal MS ue tia IMSIunknowninVLR IMEI not accepted Q n Illegal ME e GPRS not allowed fid None GPRS not allowed MS ID not derived by network nImplicit detach CoPLMN not allowed Location area not allowed Roaming area not allowed GPRS not allowed in PLMN No suitable cells in LA MSC temp not reachable 上海移远通信技术有限公司 244 / 250 M35 AT 命令手册 2065 Network failure 2068 MAC failure 2069 Sync failure 2070 Congestion 2080 Serve option not supported 2081 Request serve option not subscribed 2082 Serve option temp out of order 2086 2088 2096 2111 2143 2144 2145 2146 2147 2148 2149 2159 2160 Call cannot be identified No PDP context activated l Retry upon entry into a new cell te Retry upon entry into a new cell c l Semantically incorrect message ue tia InvalidMMinfo Message type non existent Q n Message type incompatible with protocol state e IE not implemented fid Conditional MM IE error Message not compatible with protocol state nProtocol error unspecified CoAccess barred 2161 Assignment reject 2162 Random access failure 2163 RR no service 2164 PLMN search reject emergency 2165 RR connection release 上海移远通信技术有限公司 245 / 250 M35 AT 命令手册 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 SIM Cause 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 SM Cause Authentication failure IMSI detach Abort by network Connection timeout Enqueue fail Not updated State not allowed Emergency not allowed No service l Access class barred cte l Command success ue tia Commandfail Fatal error Q n No inserted e CHV not init fid CHV verify error CHV block nAccess not allow CoSAT command busy DL error Memory problem Technical problem PUK unlock 上海移远通信技术有限公司 246 / 250 M35 AT 命令手册 3080 Operator determined barring 3097 LLC SND failure 3098 Insufficient resource 3099 Unknown APN 3100 Unknown PDP address or type 3101 Authentication failure 3102 Activation reject GGSN 3103 3104 3105 3106 3108 3109 3110 3111 3112 3113 3114 3115 3116 Activation reject Unsupported service option l Unsubscribed service option te Out of order service option c l Regular deactivation ue tia QOSnotaccepted Network fail Q n Reactivation required e Unsupported network context activation fid Semantic error in TFT operation Syntactical error in TFT operation nUnknown PDP context CoSemantic error in packet filter 3117 Syntax error in packet filter 3118 PDP context WO TFT already act 3153 Invalid TI 3167 Incorrect message 3168 Invalid MAND info 上海移远通信技术有限公司 247 / 250 M35 AT 命令手册 3169 Unimplemented message type 3170 Incompatible message type protocol state 3171 Unimplemented IE 3172 Conditional IE error 3173 Incompatible message protocol state 3183 Unspecified 3184 ABM Cause 3273 3274 3275 3276 3277 3278 3279 3280 3283 3284 3285 3286 TCM Cause Startup failure Success l Invalid network account ID te GPRS reactivate c l GPRS protocol rejection ue tia CSDreactivate CSD PPP negotiated failed Q n CSD action failed e CSD call setup failed fid Rejected Slot limited nAbort CoNone auto deactivation 3372 Invalid parameter 3373 NSAPI not in use 3374 ACL action not allowed 3375 ACL SIM file full 上海移远通信技术有限公司 248 / 250 3376 3377 3378 3379 3380 ACL add entry failed ACL del entry failed ACL set entry failed ACL SIM read failed ACL SIM write failed M35 AT 命令手册 16.11.3. MM 层内部错误列表 表 13：MM 层内部错误列表 原因 l 112 te 113 c l 114 ue tia 115 116 Q n 117 fide 118 119 n 120 Co 121 描述 Forbidden PLMN Access class barred No coverage GPRS service not allowed Timer expiry SIM inserted SIM removed SIM absent SIM invalid for PS SIM invalid for CS 122 SIM invalid for PS and CS 123 Low layer fail 124 Connection in progress 125 Not updated 126 Connection establish failure 127 Connection abort 上海移远通信技术有限公司 249 / 250 M35 AT 命令手册 128 Connection failure 129 Emergency not allowed 130 No GPRS coverage 131 Abnormal LU 132 Abnormal LU less then 4 times 133 Same LAI IMSI attaching 16.11.4. PPP/IP 栈错误列表 表 14：PPP/IP 栈错误列表 l 原因 te 0 c l 1 ue tia 2 3 Q n 4 fide 5 6 n 7 Co 8 描述 No error LCP fail Authentication fail IPCP fail ESC detect Plug out detect PPP GPRS dialup already activated PPP not activated by external modem yet PPP already activated by external modem 9 PPP not activated by WAP over CSD yet 10 PPP already activated by WAP over CSD 11 PPP wrong CSD mode ID 12 PPP detect AT command during dialup 13 PPP detect escape during dialup 上海移远通信技术有限公司 250 / 250

BC260Y-CN AT 命令手册 NB-IoT 模块系列 版本：BC260Y-CN_AT_命令手册_V1.0 日期：2020-07-11 状态：受控文件 www.quectel.com BC260Y-CN AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 88 BC260Y-CN AT 命令手册 文档历史 修订记录 版本 日期 1.0 2020-07-11 作者 饶晨 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 88 BC260Y-CN AT 命令手册 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 定义 ............................................................................................................................................ 6 1.2. AT 命令语法 ............................................................................................................................... 6 1.3. AT 命令响应 .............................................................................................................................. 7 2 产品信息查询命令 ................................................................................................................................. 8 2.1. ATI 显示产品标识信息 ............................................................................................................. 8 2.2. AT+CGMI 查询制造商信息 ...................................................................................................... 9 2.3. AT+CGMM 查询模块型号........................................................................................................ 9 2.4. AT+CGMR 查询制造商版本号............................................................................................... 10 2.5. AT+CGSN 查询产品序列号 ................................................................................................... 11 3 UART 功能命令................................................................................................................................... 13 3.1. ATE 设置命令回显模式.......................................................................................................... 13 3.2. AT+IPR 设置 TE-TA 的波特率............................................................................................... 14 4 网络状态查询命令 ............................................................................................................................... 16 4.1. AT+CSQ 上报信号质量 ......................................................................................................... 16 4.2. AT+CESQ 扩展信号质量 ....................................................................................................... 17 4.3. AT+CEREG EPS 网络注册状态 ............................................................................................ 19 4.4. AT+CGATT PS 域附着或去附着 ........................................................................................... 22 4.5. AT+CGPADDR 显示 PDP 地址 ............................................................................................. 23 4.6. AT+CREG 网络注册状态....................................................................................................... 25 4.7. AT+CSCON RRC 连接状态................................................................................................... 26 4.8. AT+QENG 查询工程模式 ...................................................................................................... 28 5 PDN 和 APN 相关命令 ........................................................................................................................ 32 5.1. AT+CGACT PDP 上下文激活/去激活.................................................................................... 32 5.2. AT+CGDCONT 定义 PDP 上下文 ......................................................................................... 33 5.3. AT+CGAPNRC APN 速率控制.............................................................................................. 37 5.4. AT+QCGDEFCONT 配置默认的 APN/PDN 连接.................................................................. 38 6 其他网络命令....................................................................................................................................... 40 6.1. AT+QPLMNS 触发 PLMN 搜索 ............................................................................................. 40 6.2. AT+COPS PLMN 选择 .......................................................................................................... 41 6.3. AT+CCIOTOPT CloT 优化配置 ............................................................................................. 43 6.4. AT+QBAND 查询/设置工作频段 ............................................................................................ 44 6.5. AT+QLOCKF 锁定 NB-IoT 频点及 PCI.................................................................................. 46 6.6. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表 ........................................................ 47 7 (U)SIM 相关命令 ................................................................................................................................. 48 上海移远通信技术股份有限公司 3 / 88 BC260Y-CN AT 命令手册 7.1. AT+CCHO 打开一个逻辑通道 ............................................................................................... 48 7.2. AT+CCHC 关闭一个逻辑通道 ............................................................................................... 49 7.3. AT+CGLA 通用 UICC 逻辑通道接入 ..................................................................................... 50 7.4. AT+CIMI 查询(U)SIM 卡 IMSI................................................................................................ 51 7.5. AT+CPIN 输入 PIN ................................................................................................................ 51 7.6. AT+CPINR 查询输入 PIN 剩余重试次数 ............................................................................... 53 7.7. AT+CSIM 通用(U)SIM 卡访问 ............................................................................................... 54 7.8. AT+CRSM 有限(U)SIM 卡访问.............................................................................................. 54 7.9. AT+QCCID (U)SIM 卡识别 .................................................................................................... 56 8 功耗相关命令....................................................................................................................................... 57 8.1. AT+CFUN 设置 UE 功能等级 ................................................................................................ 57 8.2. AT+CPSMS PSM（省电模式）设置 ..................................................................................... 58 8.3. AT+CEDRXS eDRX 设置 ...................................................................................................... 60 8.4. AT+CEDRXRDP 读取 eDRX 动态参数 ................................................................................. 63 8.5. AT+QEDRXCFG eDRX 参数配置 ......................................................................................... 65 8.6. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 .......................................................... 68 8.7. AT+QSCLK 配置休眠模式 ..................................................................................................... 69 9 平台相关命令....................................................................................................................................... 71 9.1. AT+CBC 查询模块供电电压 .................................................................................................. 71 9.2. AT+QADC 查询 ADC 通道输入电压值 .................................................................................. 72 9.3. AT+CMEE 启用/禁用移动终端错误上报................................................................................ 73 9.4. AT+QRST 重启模块 .............................................................................................................. 74 9.5. AT+QCFG 系统配置 .............................................................................................................. 74 10 时间相关命令....................................................................................................................................... 77 10.1. AT+CCLK 设置/获取当前日期和时间 .................................................................................... 77 10.2. AT+CTZR 时区上报............................................................................................................... 78 11 错误代码汇总....................................................................................................................................... 80 12 附录 A 术语缩写 .................................................................................................................................. 85 上海移远通信技术股份有限公司 4 / 88 BC260Y-CN AT 命令手册 表格索引 表 1：AT 命令及响应类型 ............................................................................................................................ 7 表 2：常见错误代码列表（27.007）.......................................................................................................... 80 表 3：术语缩写 ........................................................................................................................................... 85 上海移远通信技术股份有限公司 5 / 88 BC260Y-CN AT 命令手册 1 引言 本文档详细介绍了移远通信 NB-IoT BC260Y-CN 模块支持的 AT 命令集。 1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 BC260Y-CN 模块实现的 AT 命令可以在语法上分为两类：基础类和扩展类，如下所列。 ⚫ 基础类 基础类 AT 命令的格式为 AT 或 AT&，其中 是命令， 是该命令的参数。 以 ATE 为例，DCE 会根据 的取值确定是否将接收到的字符回显给 DTE。若 为可 选参数，则其被省略时将使用其默认值。 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 上海移远通信技术股份有限公司 6 / 88 BC260Y-CN AT 命令手册 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 备注 每次仅支持执行一个 AT 命令。只有当上一个命令执行完成后，方可执行下一个命令。 1.3. AT 命令响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或 +CME ERROR: ，表示已经准备 好接收新命令。在返回最终结果 OK，ERROR 或 +CME ERROR: 之前，会返回命令请求的响应消 息。 以下是响应消息的格式： +CMD1: OK 或者 OK 上海移远通信技术股份有限公司 7 / 88 BC260Y-CN AT 命令手册 2 产品信息查询命令 2.1. ATI 显示产品标识信息 该命令返回产品标识信息，即设备型号和固件版本号。 ATI 显示产品标识信息 执行命令 ATI 响应 Quectel_Ltd Revision: OK 最大响应时间 5秒 特性说明 / 参数 字符串类型。设备型号标识符。 字符串类型。固件版本号。 举例 ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A01 OK 上海移远通信技术股份有限公司 8 / 88 2.2. AT+CGMI 查询制造商信息 该命令用于查询制造商信息。 AT+CGMI 查询制造商信息 测试命令 AT+CGMI=? 执行命令 AT+CGMI 最大响应时间 特性说明 响应 OK 响应 Quectel_Ltd Revision: EC616 OK 5秒 / 参数 字符串类型。设备型号标识符。 举例 AT+CGMI Quectel_Ltd Quectel_BC260Y-CN Revision: EC616 OK 2.3. AT+CGMM 查询模块型号 该命令用于查询模块型号。 AT+CGMM 查询模块型号 测试命令 AT+CGMM=? 执行命令 AT+CGMM 响应 OK 响应 上海移远通信技术股份有限公司 BC260Y-CN AT 命令手册 9 / 88 OK 最大响应时间 5秒 特性说明 / 参数 字符串类型。设备型号标识符。 举例 AT+CGMM Quectel_BC260Y-CN OK 2.4. AT+CGMR 查询制造商版本号 该命令返回制造商版本号，默认为固件版本号。 AT+CGMR 查询制造商版本号 测试命令 AT+CGMR=? 执行命令 AT+CGMR 响应 OK 响应 Revision: OK 最大响应时间 5秒 特性说明 / 参数 字符串类型。固件版本号。 BC260Y-CN AT 命令手册 上海移远通信技术股份有限公司 10 / 88 举例 AT+CGMR Revision: BC260YCNAAR01A01 OK BC260Y-CN AT 命令手册 2.5. AT+CGSN 查询产品序列号 该命令返回产品的 IMEI 号及 SN 号相关信息。对于不支持的 TA，仅返回 OK。 AT+CGSN 查询产品序列号 测试命令 AT+CGSN=? 响应 TE 支持且命令执行成功时： +CGSN: (支持的范围) 查询命令 AT+CGSN= OK 响应 当=0 时： OK 当=1 时 +CGSN: OK 当=2 时 +CGSN: OK 当=3 时 +CGSN: OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 11 / 88 执行命令 AT+CGSN 最大响应时间 特性说明 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / BC260Y-CN AT 命令手册 参数 整型。表示被请求的序列号类型。 0 返回 128 位的 UUID 1 返回 IMEI 2 返回 IMEISV 3 返回 SVN 字符串类型。表示 UE 的 128 位 UUID。信息文本中（包括行终止符在内）的字符总数 不超过 2048 个字符，且不包含 0 或 OK。 十进制格式的字符串类型。表示 IMEI。 十进制格式的字符串类型。表示 IMEISV。 十进制格式的字符串类型。表示 SVN 号，属于 IMEISV 的一部分。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CGSN=1 +CGSN: 490154203237511 OK //查询 IMEI 号 上海移远通信技术股份有限公司 12 / 88 BC260Y-CN AT 命令手册 3 UART 功能命令 3.1. ATE 设置命令回显模式 该命令用于设置 UE 是否回显从外部接收的命令。 ATE 设置命令回显模式 执行命令 ATE 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；不保存至 NVRAM。 参数 整型。表示是否回显命令。 0 不回显命令 1 回显命令 举例 ATE0 OK ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A01 OK ATE1 上海移远通信技术股份有限公司 13 / 88 OK ATI ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A01 OK BC260Y-CN AT 命令手册 3.2. AT+IPR 设置 TE-TA 的波特率 该命令用于设置 TE-TA 的波特率。 AT+IPR 设置 TE-TA 的波特率 测试命令 AT+IPR=? 响应 +IPR: (支持的自适应列表),(支持的固定列表) 查询命令 AT+IPR? OK 响应 +IPR: 设置命令 AT+IPR= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。每秒波特率。 0 （自适应波特率） 2400 4800 9600 上海移远通信技术股份有限公司 14 / 88 BC260Y-CN AT 命令手册 19200 38400 57600 115200 230400 460800 整型。错误码。详细信息，请参考第 11 章。 备注 自适应模式支持以下波特率：2400 bps、4800 bps、9600 bps、19200 bps、38400 bps、57600 bps、 115200 bps 和 230400 bps。 举例 AT+IPR=115200 OK AT+IPR? +IPR: 115200 OK //将波特率固定设置为 115200 bps。 上海移远通信技术股份有限公司 15 / 88 BC260Y-CN AT 命令手册 4 网络状态查询命令 4.1. AT+CSQ 上报信号质量 该命令可返回接收信号强度指示和信道误码率。 AT+CSQ 上报信号质量 测试命令 AT+CSQ=? 响应 +CSQ: (支持的范围),(支持的列表) 执行命令 AT+CSQ OK 响应 +CSQ: , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。接收信号强度指示。 0 -113 dBm 或以下 1 -111 dBm 2~30 -109 dBm 至-53 dBm 31 -51 dBm 或以上 99 未知 整型。信道误码率（百分比）。 0~7 RxQual 值（RxQual_0 至 RxQual_7 的定义，请参阅 3GPP TS 45.008） 99 未知 上海移远通信技术股份有限公司 16 / 88 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CSQ +CSQ: 22,0 OK BC260Y-CN AT 命令手册 4.2. AT+CESQ 扩展信号质量 执行命令返回接收信号质量参数。 终端将提供 0 到 99 的信号强度指示，通常数值越大强度越高。 AT+CESQ 扩展信号质量 测试命令 AT+CESQ=? 响应 +CESQ: (支持的列表),(支持的列表),(支持的 列表),(支持的列表),(支持的列表),(支 持的列表) 执行命令 AT+CESQ OK 响应 +CESQ: ,,,,, OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。接收信号强度等级。 0 < -110 dBm 1 -110 dBm ≤ < -109 dBm 上海移远通信技术股份有限公司 17 / 88 BC260Y-CN AT 命令手册 2 -109 dBm ≤ < -108 dBm … 61 -50 dBm ≤ < -49 dBm 62 -49 dBm ≤ < -48 dBm 63 -48 dBm ≤ 99 未知 整型。信道误码率（百分比）。 0-7 RxQual 值（RxQual_0 至 RxQual_7 的定义，请参阅 3GPP TS 45.008） 99 未知 整型。接收信号码功率（参见 3GPP 25.133 和 3GPP 25.123）。 0 -120 dBm 或以下 1 -120 dBm ≤ < -119 dBm 2 -119 dBm ≤ < -118 dBm … 94 -27 dBm ≤ < -26 dBm 95 -26 dBm ≤ < -25 dBm 96 -25 dBm ≤ 255 未知 整型。Ec/No（参见 3GPP 25.133）。 0 -24 dBm 或以下 1 -24 dBm ≤ < -23.5 dBm 2 -23.5 dBm ≤ < -23 dBm … 47 -1 dBm ≤ < -0.5 dBm 48 -0.5 dBm ≤ < 0 dBm 49 0 dBm ≤ 255 未知 整型。参考信号接收质量 （参见 3GPP 25.133）。需要发送数据时，建议 RSRQ 大于-10dB。 0 -19.5 dB 或以下 1 -19.5 dB ≤ < -19 dB 2 -19 dB ≤ < -18.5 dB … 32 -4 dB ≤ < -3.5 dB 33 -3.5 dB ≤ < -3 dB 34 -3 dB ≤ 255 未知 整型。参考信号接收功率（参见 3GPP 25.133）。需要发送数据时，建议 RSRP 大于-115 dBm。 0 -140 dBm 或以下 1 -140 dBm ≤ < -139 dBm 2 -139 dBm ≤ < -138 dBm … 95 -46 dBm ≤ < -45 dBm 96 -45 dBm ≤ < -44 dBm 上海移远通信技术股份有限公司 18 / 88 97 -44 dBm ≤ 255 未知 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CESQ +CESQ: 99,99,255,255,26,56 OK 备注 1. 和不适用于 NB-IoT 网络，应设置为未知（99）。 2. 和不适用于 NB-IoT 网络，应设置为未知（255）。 BC260Y-CN AT 命令手册 4.3. AT+CEREG EPS 网络注册状态 该命令用于查询当前 EPS 网络注册状态，并用于当 EPS 网络注册状态改变时，设置上报的 URC 的显 示格式。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 响应 +CEREG: (支持的范围) 查询命令 AT+CEREG? OK 响应 当=0/1/2/3 且命令成功执行时： +CEREG: ,[,[],[],[[,,]]] 当=4/5 并且命令成功执行时： +CEREG: ,[,[],[],[][,[],[][,[],[]]]] OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 19 / 88 BC260Y-CN AT 命令手册 设置命令 AT+CEREG= 最大响应时间 特性说明 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 参数配置自动保存至 NVRAM；深休眠唤醒后仍有效。 参数 整型。 0 禁用上报网络注册状态 URC 1 启用上报网络注册状态 URC +CEREG: 2 启用上报网络注册状态和位置信息 URC： +CEREG: [,[],[],[]] 3 允许上报网络注册状态、位置信息和 EMM 原因值 URC： +CEREG: [,[],[],[][,,]] 4 对于请求 PSM 的 UE，允许上报网络注册状态、位置信息和网络定时器配置 URC： +CEREG: [,[],[],[][,,[,[],[]]]] 5 对于请求 PSM 的 UE，允许上报网络注册状态、位置信息、EMM 原因值和网络定时器 配置 URC： +CEREG: [,[],[],[][,[],[][,[,[]]]] 整型。EPS 注册状态。 0 未注册，MT 当前未搜索网络 1 已注册，归属网络 2 未注册，但 MT 当前正在尝试附着或搜索网络以进行注册 3 注册被拒绝 4 未知（例如：超出 E-UTRAN 覆盖范围） 5 注册，漫游状态 字符串类型。跟踪区域代码，两个字节，十六进制格式（例如，'00C3'等于十进制的 195）。 字符串类型。位置区域代码，两个字节，十六进制格式（例如，'00C3'等于十进制的 195）。 字符串类型。E-UTRAN 小区 ID，四个字节，十六进制格式。 整型。注册网络的接入技术。 7 E-UTRAN 9 E-UTRAN （NB-S1 模式） 整型。的类型 0 表示包含一个 EMM 原因值（请参见 3GPP TS 24.008 [8] AnnexG） 上海移远通信技术股份有限公司 20 / 88 BC260Y-CN AT 命令手册 1 表示包含特定制造商的原因值 整型。包含注册失败的原因。该值的类型由定义。请参见 3GPP TS 24.301 字符串类型。E-UTRAN 中分配给 UE 的激活时间值（T3324），8 位格式的 1 个字节 参数。激活时间值被编码为 GPRS Timer 2 信息元素的一个字节（octet 3），所述信息 元素编码为位格式（例如'00100100' 等于 4 分钟）。有关编码和取值范围，请参阅 3GPP TS 24.008 Table 10.5.163/3GPP TS 24.008、3GPP TS 23.682 以及 3GPP TS 23.401 中的 GPRS Timer 2 信息元素。 第 5 位至第 1 位表示二进制编码的定时器值。 第 6 位至第 8 位定义 GPRS 定时器步长，如下所示： 位 8 7 6 0 0 0 步长为 2 秒 0 0 1 步长为 1 分钟 0 1 0 步长为 6 分钟 1 1 1 表示去使能该定时器 字符串类型。E-UTRAN 中分配给 UE 的扩展的周期性 TAU 值（T3412），8 位格式的 1 个字节参数。扩展的周期性 TAU 值被编码为 GPRS Timer 3 信息元素的一个字节 （octet 3），所述信息元素编码为位格式（例如'01000111' 等于 70 小时）。有关编 码和取值范围，请参阅 3GPP TS 24.008 Table 10.5.163a/3GPP TS 24.008, 3GPP TS 23.682 以及 3GPP TS 23.401 中的 GPRS Timer 3 信息元素。 第 5 位至第 1 位表示二进制编码的定时器值 第 8 位至第 6 位定义定时器步长，如下所示： 位 8 7 6 0 0 0 步长为 10 分钟 0 0 1 步长为 1 小时 0 1 0 步长为 10 小时 0 1 1 步长为 2 秒 1 0 0 步长为 30 秒 1 0 1 步长为 1 分钟 1 1 0 步长为 320 小时 1 1 1 表示去使能该定时器 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CEREG=1 OK AT+CEREG? +CEREG: 1,1 OK AT+CEREG=? +CEREG: (0-5) 上海移远通信技术股份有限公司 21 / 88 BC260Y-CN AT 命令手册 OK 4.4. AT+CGATT PS 域附着或去附着 设置命令用于将 MT 附着于 PS 域，或者将 MT 从 PS 域去附着。命令完成后，MT 保持在 V.250 命令 状态。如果 MT 已经处于请求状态，则将忽略该命令，并且仍将响应 OK。如果 MT 无法实现请求状态，将 响应 ERROR 或+CME ERROR。 当附着状态更改为去附着状态时，将自动去激活所有已激活的 PDP 上下文。 查询命令返回当前 PS 域服务状态。 测试命令返回支持的 PS 域服务状态。 AT+CGATT PS 域附着或去附着 测试命令 AT+CGATT=? 响应 +CGATT: (支持的列表) 查询命令 AT+CGATT? OK 响应 +CGATT: 设置命令 AT+CGATT= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 70 秒 / 参数 整型。PDP 上下文激活状态。 0 去附着 1 附着 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 22 / 88 举例 AT+CGATT? +CGATT: 0 OK AT+CGATT=1 OK AT+CGATT=? +CGATT: (0,1) OK BC260Y-CN AT 命令手册 4.5. AT+CGPADDR 显示 PDP 地址 查询命令返回所有关联上下文标识符（）的 PDP 地址列表。 执行命令返回指定上下文标识符的 PDP 地址列表。如果未指定，则返回所有已定义上下文的地 址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 [+CGPADDR: (已定义的列表)] 查询命令 AT+CGPADDR? OK 响应 +CGPADDR: [,[,]] [+CGPADDR: [,[,]]] [...] 设置命令 AT+CGPADDR=[,[,...]] OK 响应 [+CGPADDR: [,[,]]] [+CGPADDR: [,[,]]] [...] 执行命令 AT+CGPADDR OK 响应 [+CGPADDR: [,[,]]] [+CGPADDR: [,[,]]] [...] 上海移远通信技术股份有限公司 23 / 88 BC260Y-CN AT 命令手册 OK 最大响应时间 5秒 特性说明 / 参数 / 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义（请 参阅 AT+CGDCONT 命令）。如果未指定，则返回所有已 定义上下文的地址。支持的范围 0~11。 字符串类型。PDP 地址，用于在适用于 PDP 的地址空间中识别 MT；地址可以为静态 或动态。 静态地址：在定义上下文时由 AT+CGDCONT 命令设置。 动态地址：在上一次 PDP 上下文激活（使用了指定的上下 文 定 义 ） 期 间 分 配 。 如 果 没 有 可 用 的 或 ，该参数将被省略。 当同时分配了 IPv4 和 IPv6 地址时，将同时包含 和，其中对应 IPv4 地址，而 对应 IPv6 地址。 该字符串以点分隔的数值（0~255）参数形式给出： IPv4 地址形式： a1.a2.a3.a4 IPv6 地址形式： a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a1 3.a13.a14.a15.a16 备注 1. 在双栈终端（='IPV4V6'）中， 对应 IPv6 的地址；对 IPv6 单栈终端 （='IPV6'）或具有向后兼容性的终端，IPv6 地址也可包含在参数 中。 2. =0 对 应 的 为 默 认 的 PDP 上 下 文 ， 无 法 通 过 AT+CGDCONT 进 行 配 置 ， 但 可 以 通 过 AT+QCGDEFCONT 进行配置。 举例 AT+CGPADDR=0 +CGPADDR: 0,101.43.5.1 OK 上海移远通信技术股份有限公司 24 / 88 BC260Y-CN AT 命令手册 4.6. AT+CREG 网络注册状态 设置命令用于设置网络注册状态 URC 的显示： ⚫ =1 设置显示 URC +CREG: 的显示，该 URC 指示 GERAN/UTRAN/E-UTRAN 中 MT 的网络注册状态变化。 ⚫ =2 设置 URC +CREG: [,[],[],[]] 的显示，该 URC 指示 GERAN/ UTRAN/E-UTRAN 中的网络小区变化；参数、和仅在可用时才会上报。 ⚫ =3 进 一 步 设 置 当 的 值 改 变 时 在 URC 中 显 示 更 多 参 数 [,,]（若可用）。 查询命令返回 URC 显示的状态，同时返回整型参数以指示 MT 是否已经注册到当前网络。位置 信 息 参 数 、 和 如 果 可 用 ， 仅 在 =2 且 MT 已 注 册 到 网 络 时 上 报 。 参 数 ,如果可用，仅在=3 时上报。 AT+CREG 网络注册状态 测试命令 AT+CREG=? 响应 +CREG: (支持的列表) 查询命令 AT+CREG? OK 响应 +CREG: ,[,[],[],[][,,]] OK 设置命令 AT+CREG= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 参数配置自动保存至 NVRAM；深休眠唤醒后仍有效。 上海移远通信技术股份有限公司 25 / 88 BC260Y-CN AT 命令手册 参数 整型。 0 禁用网络注册 URC 1 启用 URC 网络注册 URC + CREG: 2 启用网络注册和位置信息 URC +CREG: [,[],[],[]] 3 启用网络注册、位置信息和 EMM 原因值信息 URC +CREG: [,[],[],[][,,]] 整型，注册状态。 0 未注册，MT 当前未搜索网络 1 已注册的归属网络 2 未注册，但 MT 当前正在尝试附着或搜索网络进行注册 3 注册被拒绝 4 未知（例如：超出 E-UTRAN 覆盖范围） 5 注册，漫游状态 6 归属网络注册，仅支持短信 7 漫游注册，仅支持短信 字符串类型。位置区码，两个字节，十六进制格式（例如，'00C3'等于十进制的 195）。 字符串类型。E-UTRAN 小区 ID。四个字节，十六进制格式。 整型。注册网络的接入技术。 9 E-UTRAN （NB-S1 模式） 整型。的类型。 0 表示包含 EMM 原因值（请参见 3GPP TS 24.008 [8] Annex G） 1 表示包含特定制造商的原因值 整型。包含注册失败的原因。该值的类型由定义。参考 3GPP TS 24.301。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CREG? +CREG: 3,0 OK 4.7. AT+CSCON RRC 连接状态 该命令可提供 TA 感知的无线连接状态（即和基站的连接状态）信息，并可返回当前状态的指示。该状 态仅在无线事件（例如发送和接收）发生时更新。因此，当前返回的状态可能已经过时。即使在返回状态 =1（已连接状态）的情况下，因为连接质量的变化，模块仍可能无法连接到基站。 设置命令用于控制 URC +CSCON: 的显示。 上海移远通信技术股份有限公司 26 / 88 BC260Y-CN AT 命令手册 值指示 MT 在 E-UTRAN 中时的状态：MT 在没有信令连接时为空闲状态，有信令连接时为已 连接状态。 查询命令返回 URC 显示的状态和整型参数以指示 MT 当前为空闲状态或已连接状态。 AT+CSCON RRC 连接状态 测试命令 AT+CSCON=? 响应 +CSCON: (支持的列表) 查询命令 AT+CSCON? OK 响应 +CSCON: , OK 设置命令 AT+CSCON= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 参数配置自动保存至 NVRAM；深休眠唤醒后仍有效。 参数 整型。启用/禁用 URC。 0 禁用 URC 1 启用 URC +CSCON: 整型。信令连接状态。 0 空闲状态 1 已连接状态 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 27 / 88 举例 AT+CSCON=0 OK AT+CSCON? +CSCON: 0,1 OK AT+CSCON=? +CSCON: (0,1) OK AT+CSCON=1 OK AT+CSCON? +CSCON: 1,1 OK BC260Y-CN AT 命令手册 4.8. AT+QENG 查询工程模式 该命令用于查询模块当前的网络服务信息。当模块处于 PSM 状态或无服务时，设置命令不支持 =0。 AT+QENG 查询工程模式 测试命令 AT+QENG=? 响应 +QENG: (支持的范围) 设置命令 AT+QENG= OK 响应 当=0 时： +QENG: 0,,,,,[],[],[], [],,,[],[], [+QENG: 1,,,, OK 当=3 时： +QENG: 4,,,,< 上海移远通信技术股份有限公司 28 / 88 最大响应时间 特性说明 BC260Y-CN AT 命令手册 PLMN_type>, OK 若出现任何错误： ERROR 或者 +CME ERROR: 15 秒 / 参数 整型。请求的模块工程信息。 0 显示服务小区和邻区（若有）信息 3 显示 PLMN 的状态 整型。服务小区的 EARFCN。范围：0~262143。 整型。服务小区的 EARFCN 偏移量 0 偏移量 invail 1 偏移量 -10 2 偏移量 -9 3 偏移量 -8 4 偏移量 -7 5 偏移量 -6 6 偏移量 -5 7 偏移量 -4 8 偏移量 -3 9 偏移量 -2 10 偏移量 -1 11 偏移量 -0.5 12 偏移量 0 13 偏移量 1 14 偏移量 2 15 偏移量 3 16 偏移量 4 17 偏移量 5 18 偏移量 6 19 偏移量 7 20 偏移量 8 21 偏移量 9 整型。服务小区物理小区识别码。范围：0~503。 字符串类型。服务小区的小区 ID，十六进制格式。 上海移远通信技术股份有限公司 29 / 88 BC260Y-CN AT 命令手册 有符号整型。服务小区的 RSRP 值。单位：dBm。可为负数。 有符号整型。服务小区的 RSRQ 值。单位：dB。可为负数。 有符号整型。服务小区的 RSSI 值。单位：dBm。可为负数。当前固定为 99。 有符号整型。服务小区的最新 SNR 值，单位：dB。可为负数。 整型。当前服务小区频段。 字符串类型。双字节跟踪区域码（TAC）。十六进制格式（例如，'00C3' 等 于十进制的 195）。 整型。服务小区的最新增强覆盖等级（ECL）值。范围：0~2。仅在 RRC 连接状态下可用。 有符号整数。UE 的当前发射功率。单位：cBm（0 cBm=1 mW）。范围-128、 -45~23，其中-128 表示无效值。 整型。服务小区的部署模式： 0 LTE 带内部署相同 PCI 1 LTE 带内部署不同 PCI 2 LTE 保护带部署 3 独立部署 整型。相邻小区的 EARFCN。范围：0~262143。 整型。邻区的物理小区 ID。范围：0~503。 有符号整型。相邻小区的 RSRP 值。单位：dBm。可为负数。 有符号整型。相邻小区的 RSRQ 值。单位：dB。可为负数。 字符串类型。EMM 状态。 'NULL' 空 'DEREG' 去注册状态 'REG INIT' 注册已发起 'REG' 已注册 'DEREG INIT' 去注册已发起 'TAU INIT' TAU 已发起 'SR INIT' 服务请求已发起 'UNKNOWN' 未知 字符串型。EMM 模式。 'IDLE' 空闲态 'PSM' PSM 模式 'CONNECTED' 连接态 'UNKNOWN 未知 字符串类型。PLMN 状态。 'NO PLMN' 无 PLMN，且未搜索 PLMN 'SEARCHING' 正在搜索 PLMN 'SELECTED' 已选定 PLMN 'UNKNOWN' 未知 字符串型。PLMN 类型。 'HPLMN' 归属 PLMN 'EHPLMN' 与 HPLMN 等效的 PLMN 'VPLMN' 访问 PLMN（处于漫游状态） 'UPLMN' 用户控制的 PLMN 上海移远通信技术股份有限公司 30 / 88 BC260Y-CN AT 命令手册 'OPLMN' 运营商控制的 PLMN 'UNKNOWN' 未知 字符串类型。当前选择的 PLMN。 整型。错误码。详细信息，请参考第 11 章。 备注 为方便客户了解网络环境，可根据以下通用规则评估网络质量： ⚫ 强：RSRP ≥ -100 dBm，且 SNR ≥ 3 dB ⚫ 中：-100 dBm ≥ RSRP ≥ -110 dBm 且 3 db > SNR > -3 db ⚫ 弱：RSRP < -115 dBm 或 SNR < -3 dB 上海移远通信技术股份有限公司 31 / 88 BC260Y-CN AT 命令手册 5 PDN 和 APN 相关命令 5.1. AT+CGACT PDP 上下文激活/去激活 设置命令用于激活或去激活指定的 PDP 上下文。命令设置完成后，MT 保持 V.250 命令状态。若任意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；如果不能实现任意上下文的请求状态，将返 回 ERROR 或 +CME ERROR。AT+CMEE 命令可用于使能扩展错误响应。 在执行激活命令时，如果 UE 没有附着 PS，则 UE 会先执行 PS 附着，然后尝试激活指定的上下文。 如果附着失败，则 MT 会响应错误。 对于 EPS 而言，如果尝试断开上一条 PDN 连接，UE 将响应 ERROR；若使能了扩展错误响应，则响 应 +CME ERROR。 EPS 承载资源激活请求由网络通过 EPS 专用承载激活请求或者 EPS 承载修改请求来响应。必须在 UE 接受此请求之后 PDP 上下文方可设置为建立状态。 查询命令返回所有定义的 PDP 上下文的当前激活状态。 AT+CGACT PDP 上下文激活/去激活 测试命令 AT+CGACT=? 响应 +CGACT: (支持的列表) 查询命令 AT+CGACT? OK 响应 +CGACT: , +CGACT: , […] 设置命令 AT+CGACT=, OK 响应： OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 32 / 88 最大响应时间 特性说明 +CME ERROR: 70 秒 / BC260Y-CN AT 命令手册 参数 整型。PDP 上下文激活状态。 0 去激活 1 激活 整型。指定 PDP 上下文标识符（请参见 AT+CGDCONT 命令）。 整型。错误码。详细信息，请参考第 11 章。 备注 1. 如果支持初始 PDP 上下文，则模块在启动时会自动定义=0 的上下文。 2. 设置命令中必须且只能指定一个。 举例 AT+CGACT=0,1 OK AT+CGACT? +CGACT: 1,0 OK AT+CGACT=? +CGACT: (0,1) OK 5.2. AT+CGDCONT 定义 PDP 上下文 设置命令用来指定上下文指示参数对应的 PDP 上下文和本地上下文的 PDP 上下文参数。因为 PCO 可包括需要加密的信息，所以该命令也允许 TE 指定是否请求 ESM 信息的安全保护传输。UE 可能由 于其他原因而需要使用安全保护的 ESM 信息传输，例如，当 UE 需要传输 APN 时。处于已定义状态的 PDP 上下文的数量，由该测试命令返回的取值范围给出。 对 EPS 而言，设置该命令后会建立 PDN 连接并建立相关的默认承载，参数应该省略。 上海移远通信技术股份有限公司 33 / 88 BC260Y-CN AT 命令手册 此设置命令的一种特殊形式 AT+CGDCONT=，会直接删除对应的 PDP 上下文参数，使其 变成未定义。 查询命令返回每个已定义上下文的当前配置。 如果 UE 支持几种 PDP 类型，则每个的参数值范围将以单行返回。 根据 AT+CIPCA 命令的设置，在 E-UTRAN 网络中，MT 成功注册到网络后会自动激活初始 PDP 上下 文。如果所有活动上下文都被去激活，则可以重新建立初始 PDP 上下文。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT：(支持的范围),(支持的列表), (支持的列表),(支持的范围),(支持的列表),(支持的范围),(支持 的范围),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列 表) 查询命令 AT+CGDCONT? OK 响应 [+CGDCONT: ,,,,< d_comp>,[,[,[,[, [,[,[,[,[,]]]]]]]]]] [+CGDCONT: ,,,,< d_comp>,[,[,[,[, [,[,[,[,[,]]]]]]]]]] [...] 设置命令 AT+CGDCONT=[,[,< APN>[,[,[,[,[,[,[,[,[,[,[,[,] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 34 / 88 BC260Y-CN AT 命令手册 ]]]]]]]]]]]]] 最大响应时间 特性说明 5秒 参数配置立即生效。 参数配置不保存到 NVRAM；且深休眠唤醒后无效。 参数 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义。该参数是 UE-TE 接口的 本地参数，用于其他与 PDP 上下文相关的命令。范围：1~11。 字符串类型。分组数据协议类型。 'IP' 互联网协议（IETF STD 5 [103]） 'IPV6' 互联网协议版本 6 'IPV4V6' 引入虚拟来处理双 IP 栈 UE 功能 'PPP' 点对点协议（IETF STD 51 [104]）。EPS 服务不支持 PPP，仅支持 IP、 IPv6 和 IPv4v6 'NON-IP' 非 IP 类型 字符串类型。用于选择 GGSN 或外部数据包网络的逻辑名称。可配置的最大 APN 长度 为 99 字节。 字符串类型。用于标识适用于 PDP 的地址空间中的 UE。如果该值为空或被省略，则 TE 在 PDP 启动过程中提供该值，否则，将请求动态地址。即使在 PDP 启动过程中已 经分配了地址，查询命令中此值的返回值仍将是空字符串。可以使用 AT+CGPADDR 命令读取分配的地址。 整型。控制 PDP 数据是否需要压缩。 0 关闭 1 打开 2 V.42bis 3 V.44bis 整型。控制 PDP 头部数据是否需要压缩。 0 关闭 1 打开 2 RFC 1144 （仅适用于 SNDCP） 3 RFC 2507 4 RFC 3095[ROHC] （仅适用于 PDCP） 整型。控制 MT/TA 请求获取 IPv4 地址信息的方式。 0 通过 NAS 信令分配 IPv4 地址 1 通过 DHCP 分配的 IPv4 地址 整型。 PDP 上下文激活请求的类型。请参考 3GPP TS 24.301（subclause 6.5.1.2） 和 3GPP TS 24.008（subclause 10.5.6.17）。如果支持初始 PDP 上下文，则不允 许为紧急承载服务分配=0。根据 3GPP TS 24.008（subclause 4.2.4.2.2 和 subclause 4.2.5.1.4）和 3GPP TS 24.301（subclause 5.2.2.3.3 and subclause 5.2.3.2.2），必须为紧急承载服务建立单独的 PDP 上下文。 如果紧急承载服务的 PDP 上下文是唯一激活的上下文，则只允许紧急呼叫（请参 上海移远通信技术股份有限公司 35 / 88 BC260Y-CN AT 命令手册 阅 3GPP TS 23.401 subclause 4.3.12.9）。 0 PDP 上下文用于建立新的 PDP 上下文或从非 3GPP 接入网进行切换（是哪种 情况，由 MT 根据实际执行情况决定） 1 PDP 上下文用于紧急承载服务 2 PDP 上下文用于建立新的 PDP 上下文 3 PDP 上下文用于从非 3GPP 接入网进行切换 整型。MT/TA 如何请求获取 P-CSCF 地址（请参阅 3GPP TS 24.229 [89]附件 B 和附件 L） 0 不受 AT+CGDCONT 影响的 P-CSCF 地址发现。 1 通过 NAS 信令选择 P-CSCF 地址。 2 通过 DHCP 选择 P-CSCF 地址 整型。向网络指示 PDP 上下文是否仅用于 IM CN 子系统相关的信令。 0 UE 指示 PDP 上下文不仅用于 IM CN 子系统相关的信令。 1 UE 指示 PDP 上下文仅用于 IM CN 子系统相关的信令。 整型。为此 PDP 上下文请求的 NAS 信令优先级。 0 指示将使用 MT 中配置的低优先级指示符的值激活该 PDP 上下 文 1 表示将使用低优先级指示符'未为 NAS 信令低优先级配置 MS' 的值激活此 PDP 上下文 MT 使用 3GPP TS 24.301 [83]和 3GPP TS 24.008 中指定提供 的 NSLPI 信息。 整型。指定是否请求 PCO 的安全保护传输（仅适用于 EPS）。 0 不请求 PCO 的安全保护传输 1 请求对 PCO 进行安全保护传输 整型。影响 MT/TA 如何请求获取 IPv4 MTU 大小，请参阅 3GPP TS 24.008 subclause 10.5.6.3。 0 不受 AT+CGDCONT 命令影响的 IPv4 MTU 大小发现 1 通过 NAS 信令发现 IPv4 MTU 大小 整型。指示终端是否支持传输流模板的本地 IP 地址 0 表示不支持传输流模板的本地 IP 地址 1 表示支持传输流模板的本地 IP 地址 整型。影响 MT/TA 如何请求获取 Non-IP MTU 大小（请参考 3GPP TS 24.008 subclause 10.5.6.3）。 0 不受 AT+CGDCONT 影响的 Non-IP MTU 大小发现 1 通过 NAS 信令进行 Non-IP MTU 大小 整型。错误码。详细信息，请参考第 11 章。 备注 1. =0 对 应 的 为 默 认 的 PDP 上 下 文 ， 无 法 通 过 AT+CGDCONT 进 行 配 置 ， 但 可 以 通 过 AT+QCGDEFCONT 进行配置。 2. 对于 EPS，可省略字段。 3. Modem 协议不支持以下参数： ⚫ 上海移远通信技术股份有限公司 36 / 88 BC260Y-CN AT 命令手册 ⚫ ⚫ ⚫ ⚫ ⚫ ⚫ 4. 参数当前不支持 PPP 协议类型。 举例 AT+CGDCONT=? +CGDCONT: (1-11),'IP',,,(0),(0),(0),(0,2),(0),(0),(0,1),(0),(0,1),(0),(0),(0) +CGDCONT: (1-11),'IPV6',,,(0),(0),(0),(0,2),(0),(0),(0,1),(0),(0),(0),(0),(0) +CGDCONT: (1-11),'IPV4V6',,,(0),(0),(0),(0,2),(0),(0),(0,1),(0),(0,1),(0),(0),(0) +CGDCONT: (1-11),'Non-IP',,,(0),(0),(0),(0,2),(0),(0),(0,1),(0),(0),(0),(0,1),(0) OK 5.3. AT+CGAPNRC APN 速率控制 设置命令返回与指定的上下文标识符参数对应的 APN 速率控制参数（请参阅 3GPP TS 24.008 [8]）。 执行命令返回所有激活的 PDP 上下文的 APN 速率控制参数。 测试命令返回与已激活的辅助和非辅助 PDP 上下文的列表。 AT+CGAPNRC APN 速率控制 测试命令 AT+CGAPNRC=? 响应 +CGAPNRC: (已激活 PDP 上下文列表) 设置命令 AT+CGAPNRC= OK 响应 +CGAPNRC: [,[,< Uplink_time_unit>[,]]] [+CGAPNRC: [,[, [,]]]] [...] OK 上海移远通信技术股份有限公司 37 / 88 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / BC260Y-CN AT 命令手册 参数 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义（详 见 AT+CGDCONT 命令）。 整型。表示当达到最大上行速率时是否允许发送额外异常报告。即 3GPP TS 24.008[8] subclause 10.5.6.3.2 中规定的 APN 速率控制 参数 IE 的第 1 组八位组中的第 4 位。 0 不允许以最大速率发送其他异常上报。 1 允许以最大速率发送其他异常上报。 整型。最大上行速率使用的时间单位。即 3GPP TS 24.008[8] subclause 10.5.6.3.2 中规定的 APN 速率控制参数 IE 的第 1 组八位 组中的第 1 位至第 3 位。 0 不受限 1 分钟 2 小时 3 天 4 周 整型。每个上行链路时间单位限制 UE 发送的最大消息数。即 3GPP TS 24.008[8] subclause 10.5.6.3.2 款中规定的 APN 速率控制参数 的第 1 组八位组中的第 2 位至第 4 位。 整型。错误码。详细信息，请参考第 11 章。 5.4. AT+QCGDEFCONT 配置默认的 APN/PDN 连接 设置命令用于配置开机时 PDN 连接的 PSD 连接设置。 AT+QCGDEFCONT 配置默认的 APN/PDN 连接 测试命令 AT+QCGDEFCONT=? 响应 +QCGDEFCONT: (支持的列表) 查询命令 OK 响应 上海移远通信技术股份有限公司 38 / 88 BC260Y-CN AT 命令手册 AT+QCGDEFCONT? +QCGDEFCONT: [,[,,< password>]] 设置命令 AT+QCGDEFCONT=[,[,,]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 字符串类型。指定分组数据协议的类型。 'IP' 互联网协议（IETF STD 5） 'IPV6' 互联网协议版本 6（IETF RFC 2460） 'IPV4V6' 双 IP 堆栈（见 3GPP TS 24.301） 'Non-IP' 将非 IP 数据传输到外部分组网络（请参阅 3GPP TS 24.301） 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名。可配置的 APN 最大长度 为 99 个字节。如果该值为空或省略，则将请求订阅值。 字符串类型。接入 IP 网络的用户名。 字符串类型。接入 IP 网络的密码。 整型。错误码。详细信息，请参考第 11 章。 备注 该命令用于设置默认的 PDN 连接参数，当前 UE 开机会默认自动建立=0 的 PDN 连接。 上海移远通信技术股份有限公司 39 / 88 BC260Y-CN AT 命令手册 6 其他网络命令 6.1. AT+QPLMNS 触发 PLMN 搜索 设置命令用于当 UE 处于无服务状态时触发 PLMN 搜索，若 UE 处于服务状态，将返回+CME ERROR: 。 查询命令返回当前 PLMN 搜索状态，及 PLMN 搜索定时器的重置时间。 AT+QPLMNS 触发 PLMN 搜索 测试命令 AT+QPLMNS=? 响应 OK 查询命令 AT+QPLMNS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QPLMNS: [,] OK 执行命令 AT+QPLMNS 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 40 / 88 BC260Y-CN AT 命令手册 参数 整型。NAS 层 PLMN 的状态。 0 未激活，未进行 PLMN 搜索 1 搜索中，正在进行 PLMN 搜索 2 已选定，已搜索到 PLMN 3 处于 OOS 状态，UE 处于无服务状态并启动 PLMN 搜索定时器 整型。OOS PLMN 定时器剩余时间。单位：秒。仅当=3 时有效。 整型。错误码。详细信息，请参考第 11 章。 6.2. AT+COPS PLMN 选择 此命令参数用于选择是自动入网还是手动选择指定的 PLMN 入网。如果所选的接入技 术不可用，则应再次选择同一运营商的其他接入技术。该查询命令（AT+COPS?）还可用于查询所选的运 营商名称格式。使用手动模式，如果所选的 PLMN 不可用，则不会选择其他任何运营商（=4 除外）。 查询命令返回当前模式、当前选择的运营商和当前接入技术。如果未选择任何运营商，则省略 、和。 测试命令会返回五个表示出现的运营商网络的参数。这五个参数包括：指示当前运营商是否可用的整 型参数、长字母格式、短字母格式和数字格式的运营商名称和数字格式的接入技术。 以上参数可能不可用，不可用时为空字段。运营商列表的顺序应为：EH/HPLMN、UPLMN、OPLMN 和其 他 PLMN。 接入技术选择的参数应仅在能够注册多个接入技术的终端中使用。的选择不会限制小区 的重选功能，即使尝试选择一种接入技术，终端仍可能在另一种接入技术中重选小区。 AT+COPS PLMN 选择 测试命令 AT+COPS=? 响应 +COPS: [支持的运营商的(,长字符,短字符,数字[,])列表][,,(支持的范围),(支持 的范围)] OK 查询命令 AT+COPS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS: [,,][,] 上海移远通信技术股份有限公司 41 / 88 BC260Y-CN AT 命令手册 OK 设置命令 AT+COPS=[,[,[,]]] 如出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 如出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 305 秒 特性说明 该命令立即生效。 为 0、1 或 4 时自动保存至 NVRAM；深休眠唤醒后仍 有效。 参数 整型。运营商选择模式。 0 自动模式（省略、和字段） 1 手动搜网模式（包含和以及可选的字段） 2 手动去注册 3 仅设置 （不在查询命令 AT+COPS? 的响应中返回） 4 手动/自动选择。如果手动选择失败，则进入自动搜网模式（=0） 整型。设置命令中 的格式。 2 以数值指示 字符串类型。指示格式是否为数字。数字格式是 NB-IoT 网络位置区域标识号，它 由三个 BCD 码 ITU-T 国家/地区代码，加上两个或三个 BCD 数字网络代码（用于特定管理） 组成。当=0 时，参数省略。仅在测试命令的响应中将包含长字母格式、短 字母格式和数字格式的，例如 'CHINA MOBILE','CMCC','46000'。 整型。指示运营商网络状态。 0 未知 1 运营商网络可用 2 当前选择的网络 3 禁止选择的网络 整型。接入技术。 9 E-UTRAN （NB-S1 模式） 上海移远通信技术股份有限公司 42 / 88 BC260Y-CN AT 命令手册 备注 1. 仅当模块处于空闲状态或已插入(U)SIM 卡的注销状态时才能执行设置命令，否则将返回错误。 2. 手动模式只有在注册成功时，才会返回 OK。 3. 当为 1 或 4 时，只能为 2。 举例 AT+COPS=0 OK AT+COPS? +COPS: 0,2,'46000',9 OK 6.3. AT+CCIOTOPT CloT 优化配置 设置命令设置 UE 在 ATTACH REQUEST 和 TRACKING AREA UPDATE REQUEST 消息中指示所支 持和优先选择的 CIoT EPS 优化配置。该命令还可用来上报网络支持的 CIoT EPS 优化配置。支持 CIoT 功 能的 UE 可以支持控制面（control plane）或用户面（user plane）的 CIoT EPS 优化，或两者都可支持（请 参阅 3GPP TS 24.301, sub-clause 9.9.3.34）。基于应用特性，UE 可能优先选择注册用于控制面的 CIoT EPS 优化配置或用于用户面的 CIoT EPS 优化配置（请参阅 3GPP TS 24.301，sub-clause 9.9.3.0B）。 设置命令还用于控制 URC +CCIOTOPTI 的显示。URC +CCIOTOPTI: 用 于指示网络所支持的 CIoT EPS 优化配置。 查询命令返回当前支持和首选的 CIoT EPS 优化配置，以及 URC +CCIOTOPTI 的当前状态。 AT+CCIOTOPT CloT 优化配置 测试命令 AT+CCIOTOPT=? 响应 +CCIOTOPT: (支持的范围),(支持的范围),(支持的范围) 查询命令 AT+CCIOTOPT? OK 响应 +CCIOTOPT: ,, 设置命令 AT+CCIOTOPT=[,[,]] OK 响应 OK 上海移远通信技术股份有限公司 43 / 88 BC260Y-CN AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 参数配置自动保存至 NVRAM；深休眠唤醒后仍有效。 参数 整型。启用/禁用 URC +CCIOTOPTI 的上报。 0 禁用 1 启用 3 禁用上报并将 CIoT EPS 优化参数重置为默认值 整型。表示 UE 支持的 CIoT EPS 优化方案。 1 支持控制面 CIoT EPS 优化 3 支持控制面和用户面 CIoT EPS 优化 整型。指示 UE 优先选择的 CIoT EPS 优化配置。 0 无优先级 1 控制面 CIoT EPS 优化优先级 2 用户面 CIoT EPS 优化优先级 整型。表示网络所支持的 CIoT EPS 优化方案。 0 不支持 1 支持控制面 CIoT EPS 优化方案 2 支持用户面 CIoT EPS 优化方案 3 同时支持控制面和用户面 CIoT EPS 优化方案 整型。错误码。详细信息，请参考第 11 章。 6.4. AT+QBAND 查询/设置工作频段 该命令用于查询当前注册的频段或设置要锁定的频段。 AT+QBAND 查询/设置工作频段 测试命令 AT+QBAND=? 响应 +QBAND: (支持的范围)[,(支持的列表)] 查询命令 AT+QBAND? OK 响应 +QBAND: 上海移远通信技术股份有限公司 44 / 88 BC260Y-CN AT 命令手册 OK 若出现任何错误： ERROR 或者 设置命令 +CME ERROR: 响应 AT+QBAND=[, OK [,[,…]]] 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 25 秒 特性说明 该命令立即生效。 参数配置自动保存至 NVRAM；深休眠唤醒后仍有效。 参数 整型。优先搜索的频段数量。 0 所有频段 1~3 要锁定的频段数。 整型。NB-IoT 频段及顺序。有效值：3、5、8。 整型。锁定的频段。有效值：3、5、8。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+QBAND=? +QBAND: (0-3),(3,5,8) OK AT+QBAND=1,5 OK AT+QBAND? +QBAND: 5 OK //查询 BC260Y-CN 支持的频段列表 //设置要使用的频段 //查询之前设置的频段 上海移远通信技术股份有限公司 45 / 88 备注 该命令执行后会触发模块断开网络，重新注册网络。 BC260Y-CN AT 命令手册 6.5. AT+QLOCKF 锁定 NB-IoT 频点及 PCI AT+QLOCKF 锁定 NB-IoT 频点及 PCI 测试命令 AT+QLOCKF=? 响应 +QLOCKF: (支持的范围) 查询命令 AT+QLOCKF? OK 响应 +QLOCKF: 1,, +QLOCKF: 2,,,… 设置命令 当=0: AT+QLOCKF= 当=1: AT+QLOCKF=,[,] 当=2: AT+QLOCKF=[,[,…]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 只 能 在 AT+CFUN=0 的 模 式 下 配 置 ， 切 换 为 AT+CFUN=1 后生效。自动保存至 NVRAM。 参数 整型。锁定/解除锁定 0 解除锁定 1 锁定频点及小区 2 设置优选频点 整型。要请求锁定的频点。范围：0~262143。 0 表示移除所有锁定的频点、小区 整型。物理小区识别码。范围：0~503。 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 46 / 88 举例 AT+QLOCKF=1,3738,281 OK AT+QLOCKF=2,3738,3734 OK AT+QLOCKF? +QLOCKF: 1,3738,281 +QLOCKF: 2,3738,3734 OK BC260Y-CN AT 命令手册 6.6. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表 该命令用于清除 UE 的已存储 EARFCN 列表。 AT+QCSEARFCN 清除 NB-loT 存储的 EARFCN 列表 执行命令 AT+QCSEARFCN 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 只能在 AT+CFUN=0 的模式下配置，切换为 AT+CFUN=1 后 生效。自动保存至 NVRAM。 参数 整型。错误码。详细信息，请参考第 11 章。 举例 AT+QCSEARFCN OK 上海移远通信技术股份有限公司 47 / 88 BC260Y-CN AT 命令手册 7 (U)SIM 相关命令 7.1. AT+CCHO 打开一个逻辑通道 执行该命令后，MT 将返回，用于识别由当前选定 UICC（已连接到 ME）分配的通道。 当前选定的 UICC 会打开一个新的逻辑通道；同时选择一个应用程序（该应用程序由该命令返回的 指定）并返回会话 ID。ME 必须将 TE 和 UICC 之间的通信限制在该逻辑通道。 发送通用 UICC 逻辑通道访问命令 AT+CGLA 时将使用。 AT+CCHO 打开一个逻辑通道 测试命令 AT+CCHO=? 设置命令 AT+CCHO= 响应 OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 字符串类型。DF 名称。UICC 中所有可选应用程序，由 DF 名称引用。范围：1~16。单 位：字节。 整型。会话 ID，用于使用逻辑通道机制在智能卡（例如，(U)SIM）上选择特定应用程 序。 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 48 / 88 举例 AT+CCHO='A00000004374506173732E496F54' 1 OK BC260Y-CN AT 命令手册 7.2. AT+CCHC 关闭一个逻辑通道 该命令强制 ME 关闭 UICC 激活的通信会话。ME 关闭之前打开的逻辑通道后，TE 将无法再在该逻辑 通道上发送命令。 AT+CCHC 关闭一个逻辑通道 测试命令 AT+CCHC=? 设置命令 AT+CCHC= 响应 OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。会话 ID，用于使用逻辑通道机制在智能卡（例如，(U)SIM）上选择特定应用程 序。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CCHC=1 OK 上海移远通信技术股份有限公司 49 / 88 BC260Y-CN AT 命令手册 7.3. AT+CGLA 通用 UICC 逻辑通道接入 设置命令用于发送给 MT，然后将其发送给选定的 UICC。同时，MT 将返回 UICC 至 TA。 该命令允许 TE 上的远端应用程序直接控制当前选定的 UICC。之后，TE 将在 GSM/UMTS 指定的帧内 处理 UICC 信息。 虽然 TE 可使用 AT+CGLA 命令控制 UICC-MT 接口，但理论上来说，UICC-MT 接口的某些功能无需 从 TA/MT 外部接入。 AT+CGLA 通用 UICC 逻辑通道接入 测试命令 AT+CGLA=? 设置命令 AT+CGLA=,, 响应 OK 响应 +CGLA: , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。发送 APDU 至 UICC 时使用的会话标识。当使用默认通道（通道'0'）以外的 逻辑通道来定位智能卡上的应用程序时，必须向 UICC 发送命令。 整型。或的字符长度。（值为命令或响应实际长度的两倍） 十六进制的字符串类型。MT 传递给 UICC 的命令。详细信息，请参考 3GPP TS 31.101。 十六进制的字符串类型。UICC 返回给 MT 的响应。详细信息，请参考 3GPP TS 31.101。 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 50 / 88 BC260Y-CN AT 命令手册 7.4. AT+CIMI 查询(U)SIM 卡 IMSI 执行命令使 TA 返回，旨在允许 TE 识别连接到 MT 的(U)SIM。 AT+CIMI 查询(U)SIM 卡 IMSI 测试命令 AT+CIMI=? 执行命令 AT+CIMI 响应 OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 国际移动用户识别码 IMSI（不带双引号的字符串）。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CIMI 460001357924680 OK 7.5. AT+CPIN 输入 PIN 设置命令用于发送一个密码至 MT，操作 MT 之前需要密码（SIM PIN、SIM PUK 和 PH-SIM PIN 等）。 如需输入两次 PIN，TA 将自动重复输入 PIN；若无需输入 PIN，则不会对 MT 进行操作，并返回+CME ERROR 给 TE。如需输入 SIM PUK，则需要第二个 PIN。第二个 PIN 为，用于代替 SIM 卡中的旧 PIN。 上海移远通信技术股份有限公司 51 / 88 BC260Y-CN AT 命令手册 AT+CPIN 输入 PIN 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 设置命令 AT+CPIN=[,] 最大响应时间 特性说明 响应 OK 响应 +CPIN: OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 保存机制与 SIM 卡有关；不保存至 NVRAM。 参数 / 不带引号的字符串类型 READY 无需进一步输入 SIM PIN MT 正在等待(U)SIM PIN SIM PUK MT 正在等待(U)SIM PUK 字符串类型。(U)SIM 卡的个人识别密码。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CPIN? +CPIN: READY OK 备注 1. 如果 PIN 码连续 3 次输入错误，则需要输入 PUK 码，如果 PUK 码连续 10 次输入错误，SIM 卡会自 动彻底锁死，永远无法使用。 2. 当前模块不支持 PIN2 和 PUK2 的相关操作。 上海移远通信技术股份有限公司 52 / 88 BC260Y-CN AT 命令手册 7.6. AT+CPINR 查询输入 PIN 剩余重试次数 该命令用于返回 SIM 卡 PIN 的剩余尝试次数。 AT+CPINR 查询输入 PIN 剩余重试次数 测试命令 AT+CPINR=? 执行命令 AT+CPINR 响应 OK 响应 +CPIN: 设置命令 AT+CPINR= OK 响应 +CPINR:,, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 参数 字符串类型。 'SIM PIN' MT 正在等待(U)SIM PIN 'SIM PUK' MT 正在等待(U)SIM PUK 整型。剩余尝试输入 PIN/PUK 码的次数。 整型。输入 PIN/PUK 码的总次数。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CPINR +CPINR: 'SIM PIN',3,3 +CPINR: 'SIM PUK',10,10 OK 上海移远通信技术股份有限公司 53 / 88 BC260Y-CN AT 命令手册 7.7. AT+CSIM 通用(U)SIM 卡访问 设置命令将传递给 MT，然后将其直接发送给(U)SIM 卡，同时，MT 将返回 给 TA。 该命令允许 TE 上的远端应用程序直接控制当前所选卡槽中的(U)SIM 卡。之后，TE 将在 GSM/UMTS 指定的帧内处理(U)SIM 卡信息。 AT+CSIM 通用(U)SIM 卡访问 设置命令 AT+CSIM=, 响应 +CSIM: , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 保存机制与(U)SIM 卡有关；不保存至 NVRAM。 参数 整型。或的字符长度。（值为命令或响应实际长度的两倍） 十六进制的字符串类型。MT 传递给(U)SIM 卡的命令。具体请参考 3GPP TS 51.011 [28]。 十六进制的字符串类型。响应之前成功完成执行的指令。状态和获得响应返回数据，提 供关于当前的信息基本字段。信息包括文件的类型和大小（参见 3GPP TS 51.011/ 102.221/31.102）。读取二进制文件后，读取记录或检索数据命令，所请求的数据将被 返回。将不会在更新成功后返回，更新记录或设置数据命令。 整型。错误码。详细信息，请参考第 11 章。 7.8. AT+CRSM 有限(U)SIM 卡访问 该命令提供了对(U)SIM 数据库的简单而有限的访问。它传输(U)SIM 命令 number（）及 其所需的 MT 参数。若当前所选卡槽安装了(U)SIM 卡，MT 将内部处理所有(U)SIM-MT 接口锁定和文件选 择例程。MT 将发送实际(U)SIM 卡信息参数和数据作为响应。当命令无法传输至(U)SIM 卡时，可能会返回 错误码+CME ERROR，命令执行失败将在和中上报。(U)SIM 卡发出的命令请求和 MT 内 GSM/UMTS 应用程序发出的命令请求是单独实现的。然而，TE 将优先处理 GSM/UMTS 应用程序命令。 上海移远通信技术股份有限公司 54 / 88 BC260Y-CN AT 命令手册 AT+CRSM 有限(U)SIM 卡访问 测试命令 AT+CRSM=? 响应 OK 若出现任何错误： ERROR 或者 设置命令 +CME ERROR: 响应 AT+CRSM=[,[,,,< +CRSM: ,[,] P3>[,][,]]] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 保存机制与(U)SIM 有关；不保存至 NVRAM。 参数 ,, , 字符串类型。(U)SIM 指令序号。 '176' 读取二进制 '178' 读取记录 '192' 获得响应 '214' 更新二进制 '220' 更新记录 '242' 状态 整型。(U)SIM 卡文件标识。除了状态指令外，必须包含此参数。 整型。由 MT 传送给(U)SIM 的参数，除获得响应及状态指令外，其他指令需要包含 此参数。（请参见 3GPP TS 51.011 [28]）。 字符串类型。写入(U)SIM 卡的信息，使用十六进制表示。 字符串类型。相关文件在 UICC 的路径，使用十六进制表示。 整型。来自(U)SIM 的关于执行信息的指示。无论成功或者失败都会返回。 十六进制的字符串类型。响应之前成功完成执行的指令。状态和获得响应返回数据， 提供关于当前的信息基本字段。信息包括文件的类型和大小（参见 3GPP TS 51.011/ 102.221/31.102）。读取二进制文件后，读取记录或检索数据命令，所请求的数据 将被返回。将不会在更新成功后返回，更新记录或设置数据命令。 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 55 / 88 BC260Y-CN AT 命令手册 7.9. AT+QCCID (U)SIM 卡识别 执行命令用于读取 U(SIM)卡的 ICCID。如果没有 U(SIM)卡或者 U(SIM)卡不可读时，则返回错误。 AT+QCCID (U)SIM 卡识别 执行命令 AT+QCCID 响应 +QCCID: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 不带引号的字符串类型。集成电路卡识别码。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+QCCID +QCCID: 89860317482035195410 OK 上海移远通信技术股份有限公司 56 / 88 BC260Y-CN AT 命令手册 8 功耗相关命令 8.1. AT+CFUN 设置 UE 功能等级 设置命令可选择功能等级。'全功能'表示打开全部的功能，同时功耗也最高，'最小功能'只使用 最基本的一些功能，关闭大多数功能，相应的功耗也最低。 查询命令返回当前设置情况。 AT+CFUN 设置 UE 功能等级 测试命令 AT+CFUN=? 响应 +CFUN: (支持的列表),(支持的范围) 查询命令 AT+CFUN? OK 响应 +CFUN: 设置命令 AT+CFUN=[,] OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 25 秒。 见参数说明。 参数 整型。UE 功能等级。 0 最小功能 1 全功能 4 关闭 RF 上海移远通信技术股份有限公司 57 / 88 整型。UE 重启模式设置。 0 立即生效 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CFUN=? +CFUN: (0,1,4),(0) OK AT+CFUN=1 OK AT+CFUN? +CFUN: 1 OK BC260Y-CN AT 命令手册 8.2. AT+CPSMS PSM（省电模式）设置 设置命令用于控制 UE 省电模式（PSM）参数设置，即配置 UE 是否使用 PSM 以及 E-UTRAN 中请求 的扩展周期 TAU 值和活动时间值。通过 AT+CEREG 返回的 URC 查看活动时间值和 E-UTRAN 中网络分 配给 UE 的扩展周期 TAU 值。 AT+CPSMS=2 是该命令的一种特殊形式，表示禁用 PSM 且 AT+CPSMS 的已配置的参数都会被移除， 且恢复成默认值配置。 查询命令返回当前设置情况。 测试命令返回支持的范围、请求的扩展周期 TAU 值以及激活定时器的范围。 AT+CPSMS PSM（省电模式）设置 测试命令 AT+CPSMS=? 响应 +CPSMS: (支持的范围),,,(支持的范围),(支持的范围) 查询命令 AT+CPSMS? OK 响应 +CPSMS: [,,,[],[]] OK 上海移远通信技术股份有限公司 58 / 88 BC260Y-CN AT 命令手册 设置命令 AT+CPSMS=[,,,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。禁用或启用 UE 省电模式。 0 禁用 PSM 1 启用 PSM 2 禁用 PSM 且恢复 PSM 设置为默认值。 整型。 8 位格式的 1 字节参数。E-UTRAN 中分配给 UE 的请求扩展周 期 TAU 值（T3412）。（例如，'01000111'等于 70 小时）。 位 5 至位 1 代表二进制编码的计时器值 位 6 至位 8 定义计时器值步长，单位如下： 位 8 7 6 0 0 0 步长为 10 分钟 0 0 1 步长为 1 小时 0 1 0 步长为 10 小时 0 1 1 步长为 2 秒 1 0 0 步长为 30 秒 1 0 1 步长为 1 分钟 1 1 0 步长为 320 小时 1 1 1 表示去激活计时器 字符串类型。8 位格式的 1 个字节参数。分配给 UE 的请求活动时间值 （T3324）。（例如，'00100100'等于 4 分钟）。 位 5 至位 1 代表二进制编码的计时器值 位 6 至位 8 定义 GPRS 计时器值，计时器值单位如下所示： 位 8 7 6 0 0 0 步长为 2 秒 上海移远通信技术股份有限公司 59 / 88 BC260Y-CN AT 命令手册 0 0 1 步长为 1 分钟 0 1 0 步长为 6 分钟 1 1 1 表示去激活定时器 整型。错误码。详细信息，请参考第 11 章。 备注 TAU 周期步长 320 小时，仅适用于 T3412 扩展值。若在经过完整保护的信息中接收到该值，则该值应为 320 小时的倍数。否则，为 1 小时的倍数。 举例 AT+CPSMS=1,,,'01000011','01000011' OK AT+CPSMS? +CPSMS: 1,,,'01000011','01000011' OK AT+CPSMS=? +CPSMS: (0-2),,,( '00000000'-'11111111'), ('00000000'-'11111111') OK 8.3. AT+CEDRXS eDRX 设置 设置命令用于配置 UE eDRX 参数，即 UE 是否使用 eDRX 以及指定接入技术请求的 eDRX 值。 当 =2 且 网 络 提 供 的 eDRX 参 数 发 生 变 化 时 ， 该 设 置 命 令 用 于 控 制 URC +CEDRXP: [,[,[,]]] 的上报。 该命令的特殊形式为 AT+CEDRXS=3。此形式下，禁用 eDRX 且 AT+CEDRXS 中所配置的参数都将 被移除，且恢复为默认值配置。 查询命令返回的当前配置。 测试命令返回支持的范围、接入技术范围以及请求的 eDRX 值范围。 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的范围),(支持的列表), 上海移远通信技术股份有限公司 60 / 88 BC260Y-CN AT 命令手册 (支持的范围) 查询命令 AT+CEDRXS? OK 响应 +CEDRXS: , [+CEDRXS: ,] [...] 设置命令 AT+CEDRXS=[,[,< Requested_eDRX_value>]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。禁用和启用 UE eDRX 设置。此参数适用于所有指定接入技术， 即的最新设置将对所有指定的值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 和 URC +CEDRXP: [,[,[,]]]上报 3 禁用 eDRX 且恢复 eDRX 设置为默认值。 整型。接入技术类型。 5 E-UTRAN（NB-S1 模式） 字符串类型。请求的 eDRX 周期。4 位格式的半字节参数。NB-S1 模 式。 位 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 上海移远通信技术股份有限公司 61 / 88 BC260Y-CN AT 命令手册 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的 eDRX 周期。4 位格式的半字节参数。 NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗。4 位格式的半字节参数。 NB-S1 模式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? 上海移远通信技术股份有限公司 62 / 88 +CEDRXS: 5,'0101' OK AT+CEDRXS=? +CEDRXS: (0-3),(5),('0000'-'1111') OK BC260Y-CN AT 命令手册 8.4. AT+CEDRXRDP 读取 eDRX 动态参数 该命令用于读取 eDRX 动态参数。若 eDRX 用于 MS 当前注册到的小区，执行命令将返回、 、和。 若 MS 当前注册到的小区未使用 eDRX，将仅返回=0。 AT+CEDRXRDP 读取 eDRX 动态参数 测试命令 AT+CEDRXRDP=? 执行命令 AT+CEDRXRDP 响应 OK 响应 +CEDRXRDP: [,[,< NW_provided_eDRX_value>[,]]] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。接入技术类型。 5 E-UTRAN（NB-S1 模式） 0 未知或未开启 eDRX 字符串类型。请求的 eDRX 周期。4 位格式的半字节参数 位 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 上海移远通信技术股份有限公司 63 / 88 BC260Y-CN AT 命令手册 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的 eDRX 周期。4 位格式的半字节参数。 位 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗。4 位格式的半字节参数。 位 4 3 2 1 寻呼时间窗口长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 64 / 88 举例 AT+CEDRXRDP +CEDRXRDP: 5,'0010','1110','0101' OK AT+CEDRXRDP=? OK BC260Y-CN AT 命令手册 8.5. AT+QEDRXCFG eDRX 参数配置 设置命令用于控制 UE eDRX 参数，包括 UE 是否使用 eDRX、请求的 eDRX 值以及指定接入技术的寻 呼时间窗值。 AT+QEDRXCFG eDRX 参数配置 测试命令 AT+QEDRXCFG=? 响应 +QEDRXCFG: (支持的范围),(支持的列 表),(支持的范围),(支持的范围) 查询命令 AT+QEDRXCFG? OK 响应 +QEDRXCFG: ,[,] 设置命令 AT+QEDRXCFG=[,[,[,]]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。禁用或启用 UE eDRX。此参数适用于所有指定接入技术，即 的最新设置将对所有指定的值生效。 上海移远通信技术股份有限公司 65 / 88 BC260Y-CN AT 命令手册 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 和 URC +CEDRXP: [,[,[,]]]上报 3 恢复默认参数 整型。接入技术类型。 0 未使用 eDRX 的接入技术，该参数值仅用于 URC 中。 5 E-UTRAN（NB-S1 模式） 字符串类型。请求的 eDRX 周期。4 位格式的半字节参数。NB-S1 模 式。 位 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。请求的寻呼时间窗。4 位格式的半字节参 数。NB-S1 模式。 位 4 3 2 1 寻呼时间窗口长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 字符串类型。网络下发的 eDRX 周期。4 位格式的半字 上海移远通信技术股份有限公司 66 / 88 举例 AT+QEDRXCFG=1,5,'0101' OK AT+QEDRXCFG? +QEDRXCFG: 5,'0101' OK AT+QEDRXCFG=? 上海移远通信技术股份有限公司 BC260Y-CN AT 命令手册 节参数。NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗。4 位格式的半字 节参数。NB-S1 模式。 位 4 3 2 1 寻呼时间窗口长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详细信息，请参考第 11 章。 67 / 88 +QEDRXCFG: (0-3),(5),('0000'-'1111'),('0000'-'1111') OK BC260Y-CN AT 命令手册 8.6. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 该命令用于启用或禁用 NB-IoT 相关事件上报。 AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 测试命令 AT+QNBIOTEVENT=? 查询命令 AT+QNBIOTEVENT? 响应 OK 响应 +QNBIOTEVENT: , 设置命令 AT+QNBIOTEVENT=, OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。启用/禁用具体事件上报。 0 禁用具体事件上报 1 启用具体事件上报 URC +QNBIOTEVENT: 整型。表示上报事件的类型。 1 PSM 状态 字符串类型。当前事件类型仅可为 PSM 状态，有如下值： ENTER PSM 进入 PSM EXIT PSM 退出 PSM 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 68 / 88 BC260Y-CN AT 命令手册 8.7. AT+QSCLK 配置休眠模式 该命令用于配置 UE 休眠模式。 AT+QSCLK 配置休眠模式 测试命令 AT+QSCLK=? 查询命令 AT+QSCLK? 设置命令 AT+QSCLK= 最大响应时间 特性说明 响应 +QSCLK: (支持的范围) OK 响应 +QSCLK: OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。 0 禁用休眠模式 1 允许模块休眠等级最深可进入 Deep Sleep 模式 2 允许模块休眠等级最深可进入 Light Sleep 模式 整型。错误码。详细信息，请参考第 11 章。 备注 1. 当模块处于 Deep Sleep 时，MCU 向模块发送 AT 命令（此 AT 命令会丢失），可将模块从 Deep Sleep 唤醒。可以通过 AT+QCFG 命令启用和关闭串口唤醒功能。 2. 当模块处于 Deep Sleep 时，PSM_EINT 引脚下降沿，可以将模块从 Deep Sleep 唤醒。 3. 当模块处于 Light Sleep 时，MCU 向模块发送 AT 命令，可将模块直接从 Light Sleep 唤醒。 上海移远通信技术股份有限公司 69 / 88 举例 AT+QSCLK=1 OK BC260Y-CN AT 命令手册 上海移远通信技术股份有限公司 70 / 88 BC260Y-CN AT 命令手册 9 平台相关命令 9.1. AT+CBC 查询模块供电电压 该命令用于查询模块的供电电压值。 AT+CBC 查询模块供电电压 测试命令 AT+CBC=? 执行命令 AT+CBC 响应 OK 响应 +CBC: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。电池电压。单位：mV。 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CBC +CBC: 3368 OK 上海移远通信技术股份有限公司 71 / 88 BC260Y-CN AT 命令手册 9.2. AT+QADC 查询 ADC 通道输入电压值 该命令用于查询 ADC 通道的输入电压值。 AT+QADC 查询 ADC 通道输入电压值 测试命令 AT+QADC=? 响应 +QADC: (支持的列表) 执行命令 AT+QADC OK 响应 +QADC: 0, 设置命令 AT+QADC= OK 响应 +QADC: , OK 最大响应时间 5秒 特性说明 / 参数 整型。ADC 通道。 0 ADC0 整型。采样电压值。单位：mV。范围：0~1200。 备注 AT+QADC 查询的是 ADC0 通道的输入电压值。 举例 AT+QADC +QADC: 0,796 OK 上海移远通信技术股份有限公司 72 / 88 BC260Y-CN AT 命令手册 9.3. AT+CMEE 启用/禁用移动终端错误上报 设置命令启用或禁用最终结果码+CME ERROR: ，用于表示 MT 功能相关的错误。启用后，发生 错误时，模块会上报+CME ERROR: ，而非仅仅响应 ERROR。当发生语法、无效参数或 TA 功能相 关错误时，仅仅会响应 ERROR AT+CMEE 使能/禁用移动终端错误上报 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) 查询命令 AT+CMEE? OK 响应 +CMEE: 设置命令 AT+CMEE= 最大响应时间 特性说明 OK 响应 OK 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。启用或禁用最终结果码 +CME ERROR: 。 0 禁用 1 启用，并采用数字形式的最终结果码 2 启用，并采用详细字符串形式的最终结果码 整型。错误码。详细信息，请参考第 11 章。 举例 AT+CMEE? +CMEE: 0 OK AT+CMEE=? +CMEE: (0-2) OK 上海移远通信技术股份有限公司 73 / 88 BC260Y-CN AT 命令手册 9.4. AT+QRST 重启模块 该命令用于立即重启模块。 AT+QRST 重启模块 测试命令 AT+QRST=? 设置命令 AT+QRST= 最大响应时间 特性说明 响应 +QRST: (支持的列表) OK 响应 OK 自动立即重启 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。 1 无需去附着网络，自动立即重启。 整型。错误码。详细信息，请参考第 11 章。 9.5. AT+QCFG 系统配置 该命令用于配置系统的功能参数。 AT+QCFG 系统配置 测试命令 AT+QCFG=? 响应 +QCFG: (支持的列表),(支持的列表) 设置命令 AT+QCFG=[,] OK 响应 若省略参数，则查询当前配置： 上海移远通信技术股份有限公司 74 / 88 查询命令 AT+QCFG? 最大响应时间 特性说明 参数 BC260Y-CN AT 命令手册 +QCFG: , OK 若不省略参数，则配置对应功能： OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QCFG: (支持的列表),(当前的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 仅当取值为'statisr'时，设置后即刻生效，参数不保 存 NVRAM。 字符串类型。可配置的功能列表。 'epco' 配置扩展协议配置项 'autoapn' 配置 APN 自动激活选项 'rohc' 配置是否支持 ROHC 'DataInactTimer' 设置 UE 侧去激活定时器的值 'logbaudrate' 配置抓取 log 的波特率 'slplocktimes' 配置 Sleep Lock 持续时间 'OOSScheme' 配置 OOS 状态下的搜网间隔 'dsevent' 配置 Deep Sleep 事件 URC 上报 'statisr' 配置注网信息的 URC 上报时间间隔 'wakeupRXD' 配置是否支持串口唤醒 整型。 描述 'epco' 0 表示去使能 EPCO，即使用 PCO。 上海移远通信技术股份有限公司 75 / 88 BC260Y-CN AT 命令手册 1 表示使能 EPCO。 'autoapn' 0 表 示 关 闭 APN 自 动 激 活 ， 使 用 AT+QCGDEFCONT 配置的 APN 自 动激活参数。 1 表示打开 APN 自动激活，该设置会 根据(U)SIM 卡进行匹配 APN。 'rohc' 0 表示不支持 ROHC。 1 表示支持 ROHC。 'DataInactTimer' 0 表示去激活定时器无效。 40~254 UE 侧去激活定时器可以设置的值。 'logbaudrate' 921600~6000000 配置抓取 log 的波特率。 'slplocktimes' 0~30 配置 Sleep Lock 持续时间，默认值为 10。单位：s。 'OOSScheme' 0 OOS 状态 PLMN 搜索间隔 30 s、 1 min 和 2 min。 'OOSScheme' 1 OOS 状态 PLMN 搜索间隔 5 min、 10 min 和 15 min。 'OOSScheme' 2 OOS 状态 PLMN 搜索间隔 10 min、 30 min 和 60 min。 'OOSScheme' 3 在 30 s 后进行一次搜网，之后停止搜 网。直到 AT+QPLMNS 命令触发搜 网。 'dsevent' 0 关闭 Deep Sleep 事件 URC 上报。 'dsevent' 1 打开 Deep Sleep 事件 URC 上报。 'statisr' 0 关闭注网信息 URC 上报。 'statisr' 5~600 设置注网信息 URC 上报时间间隔。 单位：秒。 'wakeupRXD' 0 关闭串口唤醒。 'wakeupRXD' 1 打开串口唤醒。 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 76 / 88 BC260Y-CN AT 命令手册 10 时间相关命令 10.1. AT+CCLK 设置/获取当前日期和时间 该命令用于设置/获取当前日期和时间。用户设备接收到 EMM INFORMATION 或 SIB16 消息之后会自 动同步 RTC 时钟。 AT+CCLK 设置/获取当前日期和时间 测试命令 AT+CCLK=? 查询命令 AT+CCLK? 响应 OK 响应 +CCLK: 设置命令 AT+CCLK= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效，深休眠唤醒后有效。 参数配置自动保存至 NVRAM。 参数 字符串类型。格式为 yyyy/mm/dd,hh:mm:ss±zz，分别指代年份、月份、日期、小时、 分钟、秒和时区（以 1/4 小时为单位显示本地时间和 GMT 之间的时区区别。范围： -47 ~ +48），例如，2019/05/06,22:10:00+8 表示 2019 年 5 月 6 号，22:10:00 GMT+2 小时。 整型。错误码。详细信息，请参考第 11 章。 上海移远通信技术股份有限公司 77 / 88 备注 设置的时间必须在 2000 年之后，否则可能导致模块异常。 举例 AT+CCLK? +CCLK: 2020/05/06,22:10:00+32 OK BC260Y-CN AT 命令手册 10.2. AT+CTZR 时区上报 该命令用于使能/禁止时区变化事件上报。若开启时区变化上报，时区变化时移动终端会返回 URC： +CTZV: 、+CTZE: ,[,] 或 +CTZEU: ,[,]。 AT+CTZR 时区上报 测试命令 AT+CTZR=? 响应 +CTZR: (支持的范围) 查询命令 AT+CTZR? OK 响应 +CTZR: OK 设置命令 AT+CTZR= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效，深休眠唤醒后有效。 参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 78 / 88 BC260Y-CN AT 命令手册 参数 整型。使能/去使能时区变化事件上报。 0 禁用上报时区变化事件 1 使能通过 URC +CTZV: 上报时区变化事件 2 使能通过 URC +CTZE: ,[,] 3 使能通过 URC +CTZEU: ,[,] 上报时区信息和本地时间 字符串类型。表示本地时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异）与 夏令时之和。格式为'±zz'，宽度固定为两个整型数字。范围：-48 ~ +56。为保证固定宽 度，-9 ~ +9 之间的数字前加 0，例如：'-09'，'+00' 和 '+09'。 整型。参数中是否包括夏时令调整。 0 不包括夏时令调整 1 包括+1 小时（相当于的 4）的夏时令调整 2 包括+2 小时（相当于的 8）的夏时令调整 字符串类型。当前本地日期和时间。格式为 YYYY/MM/DD,hh:mm:ss ，分别指代年份、 月份、日期、小时、分钟、秒。MT 可以在传递时区信息时从网络提供的信息中获取本地 时间，并且如果网络提供了通用时间，则本地时间将显示在上报时区信息和本地时间 URC 中。 字符串类型。通用时间。格式为 YYYY/MM/DD,hh:mm:ss，分别指代年份、月份、日期、 小时、分钟、秒。 网络可以在传递时区信息时提供通用时间，并且如果网络提供了通用 时间，则通用时间将显示在上报时区信息和本地时间 URC 中。 整型。错误码。详细信息，请参考第 11 章。 备注 1. 进行搜网前，需先设置该命令。 2. 当前不支持=2。 举例 AT+CTZR=? +CTZR: (0,1,3) OK AT+CTZR=3 OK AT+CTZR? +CTZR: 3 OK 上海移远通信技术股份有限公司 79 / 88 BC260Y-CN AT 命令手册 11 错误代码汇总 本章主要介绍与 BC260Y-CN 模块相关的错误码。 下表列出的错误代码符合 3GPP 规范。用户可以参考 3GPP TS 27.007 V13.5.0，sub-clause 9.2 了解 错误码详情。 表 2：常见错误代码列表（27.007） 1 2 3 4 5 6 7 10 11 12 13 14 15 16 17 18 错误代码 MT not connection MT link reserved operation not allowed operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy SIM wrong incorrect password SIM PIN2 required SIM PUK2 required 中文解释 MT 未连接 MT 链接保留 不允许操作 不支持操作 需要 PH-SIM PIN 需要 PH-FSIM PIN 需要 PH-FSIM PUK 未插入 SIM 卡 需要 SIMPIN 需要 SIM PUK SIM 卡失败 SIM 卡忙碌 SIM 卡错误 密码不正确 需要 SIM PIN2 需要 SIM PUK2 上海移远通信技术股份有限公司 80 / 88 BC260Y-CN AT 命令手册 20 memory full 内存已满 21 invalid index 无效索引 22 not found 未发现 23 memory failure 内存不足 24 text string too long 文本字符串过长 25 invalid characters in text string 无效文本字符串 26 dial string too long 拨号字符串过长 27 invalid characters in dial string 无效拨号字符串 30 no network service 无网络服务 31 network timeout 网络超时 32 network not allowed - emergency call only 网络不允许-仅紧急呼叫 40 network personalization PIN required 需要网络个性化 PIN 41 network personalization PUK required 需要网络个性化 PUK 42 network subset personalization PIN 需要网络子集个性化 PIN required 43 network subset personalization PUK 需要网络子集个性化 PUK required 44 service provider personalization PIN 需要服务提供商个性化 PIN required 45 service provider personalization PUK 需要服务提供商个性化 PUK required 46 corporate personalization PIN required 需要企业个性化 PIN 47 corporate personalization PUK required 需要企业个性化 PUK 48 hidden key required 需要隐藏密钥 49 EAP method not support EAP 方法不支持 50 incorrect Parameters 无效参数 51 command implemented but currently 命令已实现，但当前已禁用 disabled 52 command aborted by user 命令被用户终止 上海移远通信技术股份有限公司 81 / 88 BC260Y-CN AT 命令手册 53 not attached to network due to MT 由于 MT 功能受限，未注册到网络 functionality restrictions 54 modem not allowed-MT restricted to Modem 不允许- MT 仅限于紧急呼叫 emergency calls only 55 operation not allowed because of MT 由于 MT 功能受限，操作不允许 functionality restrictions 56 fixed dial number only allowed - called 仅允许固定拨号-已拨号码非固话 number is not a fixed 57 temporarily out of service due to other MT 由于其他 MT 使用，暂时停用 usage 58 language/alphabet not supported 不支持的语言/字母 59 unexpected data value 数据值超出范围 60 system failure 系统发生问题 61 data missing 数据丢失 62 call barred 禁止通话 63 message waiting indication subscription 消息等待指示订阅失败 failure 100 unknown 未知 103 illegal MS 非法 MS 106 illegal ME 非法 ME 107 GPRS services not allowed 不允许的 GPRS 服务 108 GPRS services and non GPRS services 不允许的 GPRS 服务和非 GPRS 服务 not allowed 111 PLMN not allowed 不允许 PLMN 112 location area not allowed 不允许的位置区域 113 roaming not allowed in this location area 在此位置区域内不允许漫游 114 GPRS services not allowed in this PLMN 此 PLMN 不允许使用 GPRS 服务 115 No suitable cells in location area 位置区域内没有合适的小区 122 Congestion 拥塞 126 Insufficient resources 资源不足 127 Mission or unknown APN 任务或未知 APN 上海移远通信技术股份有限公司 82 / 88 BC260Y-CN AT 命令手册 128 Unknown PDP address or PDP type 未知 PDP 地址或 PDP 类型 129 User authentication failed 用户鉴权失败 130 Active reject by GGSN services GW or 被 GGSN 服务 GW 或 PDN GW 主动拒绝 PDN GW 131 Active reject unspecified 未指定主动拒绝 132 service option not supported 服务选项不支持 133 requested service option not subscribed 未订阅请求服务选项 134 service option temporarily out of order 服务选项暂时失灵 140 Feature not supported 不支持该功能 141 Semantic errors in the TFT operation TFT 操作语义错误 142 Syntactical errors in the TFT operation TFT 操作中的句法错误 143 Unknown PDP context 未知 PDP 上下文 144 Semantic errors in packet filters 数据包过滤器中的语义错误 145 Syntactical errors in packet filters 数据包过滤器中的句法错误 146 PDP context without TFT already 没有激活 TFT 的 PDP 上下文 activated 148 unspecified GPRS error 未指定的 GPRS 错误 149 PDP authentication failure PDP 认证失败 150 invalid mobile class 无效移动类 171 Last PDN disconnection not allowed 不允许最后一个 PDN 断开连接 172 Semantically incorrect message 消息语义不正确 173 Mandatory information element error 强制性信息元素错误 174 Information element not existent or not 信息元素不存在或未实现 implemented 175 Conditional IE error 有条件 IE 错误 176 Protocol error unspecified 未指定的协议错误 177 Operator determined barring 运营商决定的限制 178 Max number of PDP contexts reached 达到 PDP 上下文的最大数量 上海移远通信技术股份有限公司 83 / 88 BC260Y-CN AT 命令手册 Requested APN not supported in current 当前的 RAT 和 PLMN 组合不支持请求的 179 RAT and PLMN combination APN 180 Request rejected bearer control mode 请求拒绝承载控制模式冲突 violation 181 Unsupported OCI value 不支持的 OCI 值 182 User data transmission via control plane is 通过控制平面的用户数据传输拥塞 congested 301 Internal error base 内部错误基础 302 UE busy UE 繁忙 303 Not power on 未开机 304 PDN not active 未激活 PDN 305 PDN not valid 无效 PDN 306 PDN invalid type 无效 PDN 类型 307 PDN no parameter PDN 无参数 308 UE fail UE 失败 309 PDN type and APN duplicate used 重复的 PDN 和 APN 上海移远通信技术股份有限公司 84 / 88 BC260Y-CN AT 命令手册 12 附录 A 术语缩写 表 3：术语缩写 术语 3GPP ACK AM APDU APN ARQ BCCH BCD CMDMP CN DCE DF DHCP DL DL-SCH DTE EARFCN ECL EMM 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 Acknowledgement 确认 Acknowledgement Mode 确认模式 Application Protocol Data Unit 应用协议数据单元 Access Point Name 接入点名称 Automatic Repeat Request 自动重传请求 Broadcast Control Channel 广播控制信道 Binary-Coded Decimal 二进制编码的十进制 China Mobile Device Management Platform 中国移动设备管理平台 Core Network Data Communications Equipment (typically the module) Dedicated File 核心网络 数据通信设备（特指模块） 专用文件 Dynamic Host Configuration Protocol 动态主机配置协议 Downlink (Forward Link) 下行（前向链路） Downlink-Shared Channel 下行共享信道 Data Terminal Equipment (typically the MCU/external processor) 数据终端设备（特指 MCU/外部处理器） E-UTRA Absolute Radio Frequency Channel E-UTRA 绝对射频信道号（频点） Number Enhanced Coverage Level 增强覆盖等级 EPS Mobility Management EPS 移动性管理 上海移远通信技术股份有限公司 85 / 88 BC260Y-CN AT 命令手册 E-UTRAN eDRX EGPRS ePCO EPS ESM GERAN GGSN GMT GPRS GSM HARQ HPLMN HSDPA HSUPA ICCID ICMP IE IM IMEI IMEISV IMSI MQTT MS MT MTU Evolved Universal Terrestrial Radio Access 演进的通用陆基无线接入网 Network extended Discontinuous Reception 扩展非连续接收 Enhanced General Packet Radio Service 增强型数据速率 GSM 演进技术 Extended Protocol Configuration Options 扩展协议配置选项 Evolved Packet System 演进型分组系统 EPS Session Management EPS 会话管理 GSM/EDGE Radio Access Network GSM/EDGE 无线接入网 Gateway GPRS Support Node GPRS 网关支持节点 Greenwich Mean Time 格林尼治标准时间 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Hybrid Automatic Repeat Request 混合式自动重送请求 Home Public Land Mobile Network 本地公用陆地移动网 High-Speed Downlink Packet Access 高速下行分组接入 High-Speed Uplink Packet Access 高速上行分组接入 Integrated Circuit Card Identity 集成电路卡识别码 Internet Control Messages Protocol 网间控制报文协议 Information Element 信息单元 Intermodulation/IP Multimedia 互调/IP 多媒体 International Mobile Equipment Identity 国际移动设备识别码 International Mobile Equipment Identity and 国际移动用户识别码及软件版本 Software Version International Mobile Subscriber Identity 国际移动用户识别码 Message Queuing Telemetry Transport 消息队列遥测传输协议 Mobile Station 移动台 Mobile Termination (typically the module) 移动终端（特指模块） Maximum Transfer Unit 最大传输单元 上海移远通信技术股份有限公司 86 / 88 BC260Y-CN AT 命令手册 NB-IoT NSLPI NVRAM PAD PCI PCO P-CSCF PDCP PDN PDP PIN PSM PSD PSK PUK QoS RAM RFC RLC RRC RSCP RSRP RSRQ RSSI RTC SNDCP Narrowband Internet of Things 窄带物联网 NAS (Non-access Stratum) Signaling Low 非接入层信令低优先级指示 Priority Indication Non-Volatile Random Access Memory 非易失性随机访问存储器 Packet Assember/Disassemble 分组组装拆卸器 Physical Cell Identification 物理小区标识 Protocol Configuration Options 协议配置选项 Proxy Call Session Control Function 代理呼叫会话控制 Packet Data Convergence Protocol 分组数据汇聚协议 Public Data Network 公用数据网 Packet Data Protocol 分组数据协议 Personal Identification Number 个人识别码 Power Saving Mode 省电模式 Packet Switch Domain 分组域 Pre-Shared key 预共享密钥 PIN Unlock Key PIN 解锁码 Quality of Service 服务质量 Random Access Memory 随机存取存储器 Request for Comments 请求注解 Radio Link Control 无线链路控制 Radio Resource Control 无线资源控制 Received Signal Code Power 接收信号码功率 Received Signal Received Power 参考信号接收功率 Reference Signal Received Quality 参考信号接收质量 Received Signal Strength Indicator 接收的信号强度指示 Real Time Clock Sub-Network Dependent Convergence Protocol 实时时钟 子网相关融合协议 上海移远通信技术股份有限公司 87 / 88 SNR SVN TA TCP TE TTL UDP UE UICC UL UL-SCH URC UTC UUID Signal-to-Noise Ratio Software Version Number Terminal Adapter (typically the module) Transmission Control Protocol Terminal Equipment (typically the MCU/external processor) Time to Live User Datagram Protocol User Equipment (typically the module) Universal Integrated Circuit Card Uplink (Reverse Link) Uplink Shared Channel Unsolicited Result Code Universal Time Coordinated Universally Unique Identifier BC260Y-CN AT 命令手册 信噪比 软件版本 终端适配器（特指模块） 传输控制协议 终端设备（特指 MCU/外部处理器） 存活时间 用户数据报协议 用户设备（特指模块） 通用集成电路卡 上行（反向链路） 上行共享信道 非请求结果码 协调世界时 通用唯一识别码 上海移远通信技术股份有限公司 88 / 88

BC28-F&BC95-GF AT 命令手册 NB-IoT 模块系列 版本：2.0 日期：2021-05-22 状态：受控文件 BC28-F&BC95-GF AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 169 BC28-F&BC95-GF AT 命令手册 文档历史 修订记录 版本 1.0 1.1 2.0 日期 2020-10-19 2020-12-19 2021-01-30 2021-05-22 作者 Jacobi RAO Jacobi RAO Jacobi RAO Jacobi RAO 变更表述 文档创建 受控版本 新增适用模块 BC28-F 信息。 1. 新增以下命令：AT+NSOSR、AT+NSOST、 AT+NSOSTF、AT+NQSOS、AT+NSORF、AT+NSOCO、 AT+NSOSD、AT+NSOCL、AT+NSONMI、 AT+NSOSTATUS、AT+NSOCLI、AT+NSOSTFEX、 AT+NSOSDEX、AT+QLEDMODE 和 AT+QIPERF。 2. 第 4.16 章：更新命令 AT+QCFG 的部分参数及备注。 3. 第 4.17 章：更新 AT+CTZR 命令部分参数默认值。 4. 第 4.23 章：更新 AT+NATSPEED 命令部分参数默认值。 上海移远通信技术股份有限公司 2 / 169 BC28-F&BC95-GF AT 命令手册 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................3 表格索引 ..................................................................................................................................................... 6 1 引言.....................................................................................................................................................7 1.1. 定义 ..........................................................................................................................................7 1.2. AT 命令语法..............................................................................................................................7 1.3. AT 命令响应..............................................................................................................................8 1.4. 3GPP........................................................................................................................................9 1.5. AT 示例声明..............................................................................................................................9 2 3GPP 命令（27.007） ......................................................................................................................10 2.1. ATI 显示产品标识信息..........................................................................................................10 2.2. ATE 设置命令的回显模式.....................................................................................................11 2.3. AT+CGMI 查询制造商标识...................................................................................................12 2.4. AT+CGMM 查询制造商型号.................................................................................................13 2.5. AT+CGMR 查询制造商版本号..............................................................................................14 2.6. AT+CGSN 查询产品序列号..................................................................................................15 2.7. AT+CEREG 设置 EPS 网络注册状态...................................................................................16 2.8. AT+CSCON 信令连接状态...................................................................................................19 2.9. AT+CSQ 获取信号强度指示.................................................................................................21 2.10. AT+CGPADDR 显示 PDP 地址............................................................................................22 2.11. AT+COPS PLMN 选择 .........................................................................................................24 2.12. AT+CGATT PS 附着与去附着 ..............................................................................................26 2.13. AT+CGACT 激活或去激活 PDP 上下文 ...............................................................................28 2.14. AT+CIMI 请求国际移动用户识别码 ......................................................................................30 2.15. AT+CGDCONT 定义 PDP 上下文 ........................................................................................31 2.16. AT+CFUN 设置 UE 功能 ......................................................................................................34 2.17. AT+CMEE 上报 MT 错误......................................................................................................35 2.18. AT+CCLK 设置或获取前日期和时间 ....................................................................................36 2.19. AT+CPSMS 设置省电模式 ...................................................................................................38 2.20. AT+CEDRXS 设置 eDRX.....................................................................................................40 2.21. AT+CEDRXRDP 读取动态 eDRX 参数 ................................................................................43 2.22. AT+CEER 扩展错误报告......................................................................................................45 2.23. AT+CIPCA 初始 PDP 上下文激活 ........................................................................................46 2.24. AT+CGAPNRC APN 速率控制.............................................................................................47 2.25. AT+CGCONTRDP 查询 PDP 上下文的动态参数 .................................................................49 2.26. AT+CGAUTH 定义 PDP 上下文鉴权参数.............................................................................51 2.27. AT+CNMPSD 指示无更多 PS 数据 ......................................................................................52 2.28. AT+CPIN 输入 PIN 码 ..........................................................................................................53 2.29. AT+CPINR 查询剩余 PIN 的重试次数 ..................................................................................55 2.30. AT+CCHO 打开逻辑信道 .....................................................................................................56 上海移远通信技术股份有限公司 3 / 169 BC28-F&BC95-GF AT 命令手册 2.31. AT+CCHC 关闭逻辑信道 .....................................................................................................57 2.32. AT+CGLA 通用 UICC 逻辑信道访问 ....................................................................................58 2.33. AT+CRSM 受限 SIM 卡访问.................................................................................................59 2.34. AT+CSIM 通用 SIM 卡访问 ..................................................................................................61 2.35. AT+CCIOTOPT CIoT 优化配置............................................................................................62 3 SMS 相关命令（27.005） .................................................................................................................65 3.1. AT+CSMS 选择短信服务 .....................................................................................................65 3.2. AT+CSCA 设置短信服务中心地址 .......................................................................................66 3.3. AT+CMGS 发送短消息 ..........................................................................................................68 4 一般命令............................................................................................................................................70 4.1. AT+NRB 重启 UE.................................................................................................................70 4.2. AT+NUESTATS 查询 UE 统计信息......................................................................................70 4.3. AT+NEARFCN 指定搜索频点 ..............................................................................................77 4.4. AT+NBAND 设置支持的频段................................................................................................78 4.5. AT+NCONFIG 配置 UE 行为................................................................................................79 4.6. AT+NCCID 识别 USIM 卡 ....................................................................................................82 4.7. AT+NPOWERCLASS 设置频段和功率等级的映射 ..............................................................84 4.8. AT+NPSMR 省电模式状态上报............................................................................................85 4.9. AT+NPTWEDRXS 设置 PTW 和 eDRX ...............................................................................86 4.10. AT+NPIN PIN 管理...............................................................................................................89 4.11. AT+NCSEARFCN 清除存储的频点......................................................................................90 4.12. AT+NITZ 设置时间更新模式.................................................................................................91 4.13. AT+NLOGLEVEL 设置日志级别 .............................................................................................93 4.14. AT+QPLMNS 触发 PLMN 搜索 ............................................................................................94 4.15. AT+QNBIOTRAI 设置 NB-IoT 释放辅助指示........................................................................95 4.16. AT+QCFG 配置系统功能参数 ..............................................................................................96 4.17. AT+CTZR 设置时区上报 ....................................................................................................101 4.18. AT+NIPINFO 上报 IP 地址信息 .........................................................................................103 4.19. AT+QCHIPINFO 读取系统信息..........................................................................................104 4.20. AT+QIDNSCFG 配置 DNS 服务器地址 ..............................................................................105 4.21. AT+QDNS 触发 DNS 域名解析 ..........................................................................................107 4.22. AT+NPING 测试到远程主机的 IP 网络连接........................................................................108 4.23. AT+NATSPEED 配置 UART 端口波特率 ...........................................................................109 4.24. AT+NUICC 设置 UICC 功耗模式 ..........................................................................................111 4.25. AT+NSOCR 创建 Socket ...................................................................................................112 4.26. AT+NSOST 发送消息（仅限 UDP）..................................................................................113 4.27. AT+NSOSTEX 发送消息（仅限 UDP） .............................................................................114 4.28. AT+NSOSTF 发送带标志的消息（仅限 UDP） .................................................................116 4.29. AT+NSOSTFEX 发送带标志位的消息（仅限 UDP） .........................................................117 4.30. AT+NQSOS 查询待处理的 Socket 消息清单......................................................................120 4.31. AT+NSORF 读取消息 ........................................................................................................121 4.32. AT+NSOCO 连接命令（仅限 TCP） .................................................................................122 4.33. AT+NSOSD 发送消息（仅限 TCP）..................................................................................123 上海移远通信技术股份有限公司 4 / 169 BC28-F&BC95-GF AT 命令手册 4.34. AT+NSOSDEX 发送消息（仅限 TCP） .............................................................................124 4.35. AT+NSOCL 关闭 Socket....................................................................................................126 4.36. AT+NSONMI 指示已到达 Socket 的消息............................................................................127 4.37. +NSOCLI 关闭 Socket 指示（仅用于响应） ......................................................................128 4.38. AT+NSOSTATUS 获取 Socket 状态 ..................................................................................129 4.39. AT+QLEDMODE 设置 NETLIGHT 功能模式......................................................................130 4.40. AT+QIPERF IPERF 性能测试 ............................................................................................132 5 LwM2M 物联网平台命令 .................................................................................................................135 5.1. AT+QCFG='LWM2M/Lifetime' 配置 IoT 平台注册生命周期...............................................135 5.2. AT+NCDP 配置和查询 CDP 服务器设置 ............................................................................136 5.3. AT+QLWSREGIND 注册控制 ............................................................................................137 5.4. AT+QLWULDATA 发送数据...............................................................................................138 5.5. AT+QLWULDATAEX 发送 CON/NON 消息 .......................................................................138 5.6. AT+QLWULDATASTATUS 查询 CON 消息发送状态 ........................................................139 5.7. AT+QREGSWT 设置注册模式 ...........................................................................................140 5.8. AT+NMGS 发送消息 ..........................................................................................................142 5.9. AT+NMGR 接收消息..........................................................................................................142 5.10. AT+NNMI 设置新消息指示 .................................................................................................143 5.11. AT+NSMI 发送消息指示.....................................................................................................145 5.12. AT+NQMGR 查询已接收消息状态 .....................................................................................146 5.13. AT+NQMGS 查询发送的消息状态 .....................................................................................147 5.14. AT+NMSTATUS 消息注册状态 ..........................................................................................148 5.15. AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP ............................................149 6 错误码 .............................................................................................................................................151 7 重启原因..........................................................................................................................................157 8 举例.................................................................................................................................................158 8.1. 附着网络 ...............................................................................................................................158 8.1.1. 自动附着网络 .............................................................................................................158 8.1.2. 手动附着网络 .............................................................................................................159 8.2. 发送/接收/读取 UDP 信息 .....................................................................................................160 8.3. 发送/接收/读取 TCP 信息......................................................................................................160 8.4. 中国电信 IoT 平台相关举例...................................................................................................161 8.4.1. 注册中国电信 IoT 平台 ...............................................................................................161 8.4.1.1. 自动注册模式 ..................................................................................................161 8.4.1.2. 手动注册模式 ..................................................................................................162 8.4.2. 从中国电信 IoT 平台发送/接收数据 ............................................................................162 8.5. 释放辅助指示（RAI）...........................................................................................................163 8.5.1. RAI 功能操作举例（R13）.........................................................................................163 8.5.1.1. 发送 LwM2M CON/NON 数据 .........................................................................163 8.5.2. RAI 功能操作举例（R14）.........................................................................................164 8.5.2.1. 发送 LwM2M CON/NON 数据 .........................................................................164 9 附录 A 术语缩写 ..............................................................................................................................165 上海移远通信技术股份有限公司 5 / 169 BC28-F&BC95-GF AT 命令手册 表格索引 表 1：AT 命令类型 .................................................................................................................................... 8 表 2：通用错误码 .................................................................................................................................. 151 表 3：重启原因显示............................................................................................................................... 157 表 4：术语缩写...................................................................................................................................... 165 上海移远通信技术股份有限公司 6 / 169 BC28-F&BC95-GF AT 命令手册 1 引言 本文档详细介绍了移远通信 NB-IoT 模块系列 BC28-F 和 BC95-GF 模块支持的 AT 命令集。 模块开启后，将输出字符串REBOOT_CAUSE_APPLICATION_POWER_ON_RESETOK。收到此字符串后，AT 命令处理器将开始准备接收 AT 命令。 如果模块由于异常导致的重新开机，将输出一条消息，以表明重新启动的原因，详细信息请参考第 7 章。 1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 模块实现的 AT 命令可以在语法上分为两类：基础类和扩展类，如下所列。 ⚫ 基础类 基础类 AT 命令的格式为 AT 或 AT&，其中 是命令， 是该命令的参数。 以 ATE 为例，DCE 会根据 的取值确定是否将接收到的字符回显给 DTE。若 为可 选参数，则其被省略时将使用其默认值。 上海移远通信技术股份有限公司 7 / 169 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： BC28-F&BC95-GF AT 命令手册 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 可以用分号（;）将多个命令放在同一行。此时只有第一个命令带有 AT 前缀。命令可以是大写或小写。 输入 AT 命令时，可以忽略空格。但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内； ⚫ 在 AT 命令名称中的 =、? 或 =? 内。 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.3. AT 命令响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或 +CME ERROR: ，表示已经准 备好接收新命令。在返回最终的 OK，ERROR 或 +CME ERROR: 之前，会发送请求的响应消息。 以下是响应消息的格式： +CMD1: OK 上海移远通信技术股份有限公司 8 / 169 或者 OK BC28-F&BC95-GF AT 命令手册 1.4. 3GPP 本文档命令遵从 3GPP TS 27.007、TS 27.005 (2017-03)。 1.5. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 9 / 169 BC28-F&BC95-GF AT 命令手册 2 3GPP 命令（27.007） 2.1. ATI 显示产品标识信息 该命令用于返回产品标识信息。 ATI 显示产品标识信息 执行命令 ATI 最大响应时间 特性说明 响应 Quectel Revision: OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 字符串型。设备型号。 字符串型。软件版本号。 错误码。参考第 6 章。 举例 ATI Quectel BC95-GF Revision:BC95GFFAR01A01 OK 上海移远通信技术股份有限公司 10 / 169 BC28-F&BC95-GF AT 命令手册 2.2. ATE 设置命令的回显模式 该命令用于设置是否从外接 MCU 接收 UE 回显字符。 ATE 设置命令的回显模式 执行命令 ATE 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。是否回显从 UE 收到的字符。 0 关闭回显模式 1 开启回显模式 错误码。参考第 6 章。 举例 ATE0 OK ATI Quectel BC95-GF Revision:BC95GFFAR01A01 OK ATE1 OK ATI ATI Quectel BC95-GF Revision:BC95GFFAR01A01 OK 上海移远通信技术股份有限公司 11 / 169 BC28-F&BC95-GF AT 命令手册 2.3. AT+CGMI 查询制造商标识 该命令用于查询制造商信息，默认返回 Quectel。 AT+CGMI 查询制造商标识 执行命令 AT+CGMI 响应 OK 测试命令 AT+CGMI=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 / 参数 字符串型。制造商信息。信息文本（包括行终止符在内）的字符总数不超过 2048， 且不包含 0或 OK。 错误码。参考第 6 章。 举例 AT+CGMI Quectel OK 上海移远通信技术股份有限公司 12 / 169 BC28-F&BC95-GF AT 命令手册 2.4. AT+CGMM 查询制造商型号 该命令用于查询制造商型号信息。 AT+CGMM 查询制造商型号 执行命令 AT+CGMM 响应 OK 测试命令 AT+CGMM=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 / 参数 字符串型。制造商型号信息。信息文本（包括行终止符在内）的字符总数不应超过 2048， 且不包含 0或 OK。 错误码。参考第 6 章。 举例 AT+CGMM BC95-GF OK 上海移远通信技术股份有限公司 13 / 169 BC28-F&BC95-GF AT 命令手册 2.5. AT+CGMR 查询制造商版本号 该命令用于查询制造商版本号。该命令默认返回发布和编译的固件版本（包括核及对应的版本号）。 该执行命令返回一行或多行。 AT+CGMR 查询制造商版本号 执行命令 AT+CGMR 响应 OK 测试命令 AT+CGMR=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 / 参数 字符串型。制造商版本号。信息文本（包括行终止符在内）的字符总数不应超过 2048， 且不包含 0或 OK。此参数的格式可能会改变。 错误码。参考第 6 章。 举例 AT+CGMR Revision:BC95GFFAR01A01 OK AT+CGMR=? OK 上海移远通信技术股份有限公司 14 / 169 BC28-F&BC95-GF AT 命令手册 2.6. AT+CGSN 查询产品序列号 该命令用于查询国际移动设备识别码（IMEI 号）及相关信息。对于不支持的 UE，仅返回 OK。 AT+CGSN 查询产品序列号 执行命令 AT+CGSN[=] 响应 =0（或者省略）且命令执行成功时： =1 且命令执行成功时： +CGSN: =2 且命令执行成功时： +CGSN: =3 且命令执行成功时： +CGSN: OK 测试命令 AT+CGSN=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 UE 支持且命令执行成功时： +CGSN:(支持的列表) OK UE 不支持时： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 15 / 169 BC28-F&BC95-GF AT 命令手册 参数 整型。被请求的序列号类型。 0 返回 1 返回 IMEI 号 2 返回 IMEISV 号 3 返回 SVN 字符串型。UE 的 128 位 UUID。信息文本（包括行终止符在内）的字符总数不应超 过 2048，且不包含 0或 OK。 十进制格式的字符串型。IMEI 号。 十进制格式的字符串型。IMEISV 号。 十进制格式的字符串型。当前 SVN（SVN 是 IMEISV 的一部分）。 错误码。参考第 6 章。 举例 AT+CGSN=1 +CGSN:861875050000754 OK //查询 IMEI 号 2.7. AT+CEREG 设置 EPS 网络注册状态 设置命令用于设置 EPS 网络注册状态 URC 的显示：=1 设置在 E-UTRAN 中 UE 的 EPS 网络注册 状态发生改变时的 URC +CEREG: 的显示；=2 设置在 E-UTRAN 中的网络小区发生改变时的 URC +CEREG: [,[],[],[]]的显示。参数、和只有在可用时才会上 报 。 在 =2 的 基 础 上 ， =3 设 置 当 的 值 改 变 时 ， 在 URC 显 示 参 数 和 （若和可用）。 如果 UE 需要请求 PSM 减少其功率消耗，=4 设置 URC +CEREG: [,[],[],[] [,[],[][,[],[]]]] 的显示。此时，如果 E-UTR AN 的小区发生改变，URC 将向 UE 提供附加的 active-time 值及扩展周期性 TAU 值信息。当=5 时， 如果 的值发生改变，URC 将会比=4 时多上报和参数。 参数、、、、、与 只有在可用时才会上报。 查询命令会返回结果码的显示状态和整数型参数，显示 UE 是否已经注册当前网络。如果可用， 位 置 信 息 参 数 、 与 ， 仅 在 =2 且 UE 已 注 册 网 络 时 上 报 。 如 果 参 数 [,,]可用，当=3 时返回。 上海移远通信技术股份有限公司 16 / 169 BC28-F&BC95-GF AT 命令手册 AT+CEREG 设置 EPS 网络注册状态 设置命令 AT+CEREG= 响应 OK 查询命令 AT+CEREG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 =0、1、2 或 3 且命令执行成功时： +CEREG:,[,[],[],[[,, ]]] =4 或 5 且命令执行成功时： +CEREG:,[,[],[],[][,[],[][,[],[]]]] OK 测试命令 AT+CEREG=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEREG:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后仍有效；参数配置不保存至 NVRAM。 参数 整型。 0 禁用网络注册 URC 1 使能网络注册 URC +CEREG: 上海移远通信技术股份有限公司 17 / 169 BC28-F&BC95-GF AT 命令手册 2 使能网络注册与位置信息 URC +CEREG:[,[],[],[]] 3 使能网络注册、位置信息和 EMM 原因值 URC： +CEREG:[,[],[],[][,,]] 4 对于需要请求 PSM 的 UE，使能网络注册和位置信息 URC： +CEREG:[,[],[],[][,,[,[],[]]]] 5 对于需要请求 PSM 的 UE，使能网络注册、位置信息和 EMM 原因值 URC： +CEREG:[,[],[],[][,[],[][,[< Active-Time>],[]]]] 整型。EPS 注册状态。 0 未注册，UE 目前未搜索运营商进行注册 1 已注册，本地网络 2 未注册，但 UE 目前正在连接或搜索运营商进行注册 3 注册被拒绝 4 未知（例如不在 E-UTRAN 范围内） 5 已注册，漫游网络 字符串型。十六进制 2 字节跟踪区域代码（例如'00C3'等于十进制的 195）。 字符串型。十六进制 4 字节的 E-UTRAN 小区 ID。 整型。服务小区的接入技术。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 整型。类型。 0 表示包含一个 EMM 原因值 1 表示包含一个特定制造商的原因值 整型。包含注册失败的原因。该参数的类型由定义。 字符串型。8 位格式的 1 字节参数。表示在 E-UTRAN 中分配给 UE 的 Active-time 值 （激活时间，T3324）。Active-time 值编码为 GPRS Timer 2 信息元素的一个字节（octet 3），编码为位格式（例如'00100100'等于 4 分钟）。 关于编码和值范围，请参考 3GPP TS 24.008、3GPP TS 23.682 和 3GPP TS 23.401。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器值的单位，定义如下： 位数 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 该值表示定时器被停用 在此版本的 3GPP 协议中，其他值应以 1 分钟的倍数递增。 字符串型。8 位格式的 1 字节参数。表示在 E-UTRAN 中分配给 UE 的扩展周期性 TAU 值（T3412）。扩展的周期 TAU 值，编码为 GPRS Timer 3 信息元素的一个字节（octet 3），编码为位格式（例如'01000111'等于 70 小时）。 对于编码和值范围，请参考 3GPP TS 24.008、3GPP TS 23.682 和 3GPP TS 23.401。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器值的单位，定义如下： 上海移远通信技术股份有限公司 18 / 169 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增 1 1 1 该值表示定时器被停用 错误码。参考第 6 章。 BC28-F&BC95-GF AT 命令手册 备注 如果 AT+NCONFIG 中的配置项 T3324_T3412_EXT_CHANGE_REPORT 为 TRUE，当 或定时器改变时，显示 AT+CEREG=5 的 URC。。 举例 AT+CEREG=1 OK AT+CEREG? +CEREG:1,1 OK AT+CEREG=? +CEREG:(0,1,2,3,4,5) OK //使能网络注册 URC。 2.8. AT+CSCON 信令连接状态 该命令用于返回 UE 感知到的无线连接状态（即和基站的连接）的详细信息，并返回当前状态的指示。 该状态仅在无线事件发生时更新，例如发送和接收数据。因此，当前返回的状态可能已经过时。即使在返 回状态=1（已连接）的情况下，因为连接质量的变化，模块仍可能无法使用基站。 该设置命令用于控制 URC 的显示。 UE 处于 E-UTRAN 网络时，当没有 PS 信令连接时，UE 为空闲模式；当 UE 与网络间的 PS 信令连接 建立时，UE 为连接模式。 上海移远通信技术股份有限公司 19 / 169 BC28-F&BC95-GF AT 命令手册 UE 处于 E-UTRAN 网络时，的值表示 UE 的状态。 查询命令返回结果码的显示状态和整型参数。指示 UE 当前为空闲模式或者连接模式。 AT+CSCON 信令连接状态 设置命令 AT+CSCON= 响应 OK 查询命令 AT+CSCON? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCON:, OK 测试命令 AT+CSCON=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCON:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后仍有效；参数配置不保存至 NVRAM。 参数 整型。表示使能/禁用 URC。 0 禁用 URC 1 使能 URC +CSCON: 整型。表示信令连接状态。 0 空闲 1 已连接 上海移远通信技术股份有限公司 20 / 169 2~255 保留待用 错误码。参考第 6 章。 举例 AT+CSCON=0 OK AT+CSCON? +CSCON:0,1 OK AT+CSCON=? +CSCON:(0,1) OK AT+CSCON=1 OK AT+CSCON? +CSCON:1,1 OK BC28-F&BC95-GF AT 命令手册 2.9. AT+CSQ 获取信号强度指示 该执行命令用于获取从 UE 接收到的信号强度指示和信道误码率。 该测试命令用于返回所支持参数的范围。 AT+CSQ 获取信号强度指示 执行命令 AT+CSQ 响应 +CSQ:, OK 测试命令 AT+CSQ=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSQ:(支持的列表),(支持的列表) 上海移远通信技术股份有限公司 21 / 169 BC28-F&BC95-GF AT 命令手册 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。表示接收到的信号强度。单位：dBm。 0 等于或小于-113 dBm 1 -111 dBm 2~30 -109 ~ -53 dBm 31 大于或等于-51 dBm 99 未知或无法检测 整型。表示信道误码率（BER）（百分比）。 0~7 作为 RxQual 值（请参考 3GPP TS 45.008） 99 未知或无法检测 错误码。参考第 6 章。 举例 AT+CSQ +CSQ:31,0 OK 2.10. AT+CGPADDR 显示 PDP 地址 该命令用于返回设备的 IP 地址。 设置命令返回指定的 PDP 地址列表。如果没有指定，则返回所有已定义上下文的地址。 测试命令返回定义的列表。这些已被激活，可能有也可能没有与之关联的 IP 地址。 上海移远通信技术股份有限公司 22 / 169 BC28-F&BC95-GF AT 命令手册 AT+CGPADDR 显示 PDP 地址 执行/设置命令 AT+CGPADDR[=[,[,...]]] 响应 +CGPADDR:[,[,]] [+CGPADDR:,[[,]]] [...]]] OK 测试命令 AT+CGPADDR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGPADDR:(已定义的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 5秒 / 参数 和 整型。指示某个 PDP 上下文的标识符（参考 AT+CGDCONT）。 范围：0~10。 字符串型。在适用于 PDP 的地址空间识别 MT，地址可为静态或 动态。静态地址由命令 AT+CGDCONT 设定。动态地址在上一 次 PDP 上下文激活期间分配，使用引用的上下文定义。如 果和的地址均不可用，则省略； 当 分 配 IPv4 及 IPv6 的 地 址 时 ， 和 均被指定，对应 IPv4 的地址， 对应 IPv6 的地址。 错误码。参考第 6 章。 备注 1. 在双栈终端（=IPV4V6），对应 IPv6 的地址。对于 IPv6 单栈终端 （=IPv6）或者因为向后兼容性，IPv6 地址也可包含在参数中。 上海移远通信技术股份有限公司 23 / 169 BC28-F&BC95-GF AT 命令手册 2. 当使能 AUTOCONNECT（参考 AT+NCONFIG）时，IP 地址获取之后才会列出=0。 举例 AT+CGPADDR=0 +CGPADDR:0,101.43.5.1 OK AT+CGPADDR=? +CGPADDR:(0) OK 2.11. AT+COPS PLMN 选择 设置命令强制尝试使用安装在当前所选卡槽中的 USIM 卡来选择和注册 EPS 网络运营商。用 于设置找网动作是由 MT 自动完成，还是通过该命令以特定的接入方式强加于运营商（由 指定）。如果选择的运营商不可用，则不会选择其他运营商。如果选择的接入技术不可用，则会 在其他接入技术中选择相同的运营商。选定运 营商名称的格式同样适用于查询命令 AT+COPS? 。 =2 强制尝试注销网络。所选模式会影响后续所有网络注册（例如，当设置=2 后，只有在 设置=0 或 1 时 UE 才会注册网络）。尝试注册或注销时，此命令应该是可中止的。 查询命令返回当前模式、当前所选运营商以及当前接入技术。如果没有选择运营商，则不会返回 、和。 测试命令返回五个参数，表示网络中出现的运营商。指示当前运营商是否可用的整型参数、运 营商的数字编码、接入技术的数字编码、注册模式及运营商名称的格式。 以上参数可能不可用，不可用时为空字段。PLMN 选择应该按照此顺序排列：归属网络、USIM 中选用的网 络或 UICC（USIM）中的活动应用程序引用的网络（顺序：HPLMN 选择器、用户控制的 PLMN 选择器、 运营商控制的 PLMN 选择器、USIM 中的 PLMN 选择器）以及其他网络。 选择接入技术的参数仅应用于能够注册多种接入技术的终端。的选择不会限制小区重选 的能力，即使已经尝试选择一种接入技术，UE 也可以在其他接入技术中重选小区。 AT+COPS PLMN 选择 设置命令 AT+COPS=[,[,[,]]] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 24 / 169 BC28-F&BC95-GF AT 命令手册 查询命令 AT+COPS? 测试命令 AT+COPS=? 最大响应时间 特性说明 响应 +COPS:[,,][,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS: [(运营商,,,长字符,短字符,数字 )],[(运营商,,,长字符,短字符,数字 )],[...],[,,(支持的列表),(支持的列表)] OK 若出现任何错误： ERROR 或者 +CME ERROR: 305 秒 该命令立即生效。 深休眠唤醒后仍有效，不保存至 NVRAM。=1 时， Re-attach 后将变成 0。 参数 整型。 0 自动搜网模式（省略、和字段） 1 手动搜网模式（包含和字段，可选） 2 注销网络 =1 时，UE 重启后，将不会保留 PLMN 设置。=1 仅供研发使用；生产 环境请使用=0，此时 AUTOCONNECT 设置为 True。 整型。运营商的格式。 2 数字格式 字符串型。指示此参数格式是否为数字格式；数字格式是 NB-IoT 网络位置区 域标识号（参考 3GPP TS 24.008 subclause 10.5.1.3），由三位 BCD 数字国家代 码 （ 编 码 参 考 ITU-T Recommendation E.212 Annex A ） ， 加 上 两 位 或 三 位 BCD 数字网络代码。=0 时，参数省略。 整型。运营商状态。 0 未知 1 可用 2 当前 上海移远通信技术股份有限公司 25 / 169 BC28-F&BC95-GF AT 命令手册 3 禁用 整型。接入技术设置。模块查询命令 AT+COPS?不会返回。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 错误码。参考第 6 章。 举例 AT+COPS=0 OK AT+COPS? +COPS:0,2,'46000' OK AT+COPS=? +COPS: (2,,,'31112'),(0,,,'46011'),(0,,,'46000'),,(0-2),(2) OK 备注 暂时只支持数字格式的（=2）。 2.12. AT+CGATT PS 附着与去附着 该命令用于将 MT 附着于 PS 域或将 MT 从 PS 域去附着。命令执行后，MT 保持在 V.250 命令状态。 如果正在执行 AT+CGATT，在附着或去附着注册步骤完成之前，再次执行此命令会返回错误。如果未达到 请求状态，则会响应 ERROR 或+CME ERROR: 。 当附着状态改为去附着状态时，任何活动的 PDP 上下文将自动变为未激活。 查询命令返回当前 PS 域服务状态。 测试命令用于请求支持的 PS 域状态的信息。 AT+CGATT PS 附着与去附着 设置命令 AT+CGATT= 响应 OK 若出现任何错误： 上海移远通信技术股份有限公司 26 / 169 查询命令 AT+CGATT? 测试命令 AT+CGATT=? 最大响应时间 特性说明 BC28-F&BC95-GF AT 命令手册 ERROR 或者 +CME ERROR: 响应 +CGATT: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGATT:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 70 秒 / 参数 整型。表示 PDP 上下文激活的状态。 0 去附着 1 附着 错误码。参考第 6 章。 备注 如果使能初始 PDP 上下文，启动时将自动定义=0 的上下文。 举例 AT+CGATT? +CGATT:0 OK 上海移远通信技术股份有限公司 27 / 169 AT+CGATT=1 OK AT+CGATT=? +CGATT:(0,1) OK BC28-F&BC95-GF AT 命令手册 2.13. AT+CGACT 激活或去激活 PDP 上下文 该命令用于激活或去激活指定的 PDP 上下文。该命令设置完成后，UE 保持在 V.250 命令状态。若任 意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；如果不能实现任意上下文的请求状态，将 返回 ERROR 或+CME ERROR。执行该命令的激活形式时，如果 UE 没有附着 PS，UE 首先会附着 PS， 然后尝试激活指定的上下文。如果附着失败，UE 则响应错误；或者，如果使能扩展错误响应，UE 响应相 应的附着失败错误消息。对 EPS 而言，如果尝试断开上一个 PDN 连接，MT 响应 ERROR，或者如果使能 扩展错误响应，则响应+CME ERROR。 EPS 承载资源的激活请求由网络通过 EPS 专用承载激活请求或 EPS 承载修改请求来响应。MT 必须 接受此请求，PDP 上下文才可设置为建立状态。 查询命令返回所有定义的 PDP 上下文的当前激活状态。测试命令用于请求支持的 PDP 上下文激活状 态的信息。 AT+CGACT 激活或去激活 PDP 上下文 设置命令 AT+CGACT=, 响应 OK 查询命令 AT+CGACT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGACT:, [+CGACT:,] [...] OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 28 / 169 测试命令 AT+CGACT=? 最大响应时间 特性说明 BC28-F&BC95-GF AT 命令手册 或者 +CME ERROR: 响应 +CGACT:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 70 秒 / 参数 整型。表示 PDP 上下文的激活状态。 0 去激活 1 激活 整型。指示某个 PDP 上下文的标识符（参考 AT+CGDCONT）。一次只能激活或去激 活 1 个。 错误码。参考第 6 章。 备注 1. 如果使能初始 PDP 上下文，启动时将自动定义=0 的上下文。 2. PLMN 搜索、附着和去附着时，不可执行该命令。 3. 当 UE 与核心网络都支持无 PDN 连接时，该命令可以断开最后一路 PDN 连接。 举例 AT+CGACT=0,1 OK AT+CGACT? +CGACT:1,0 OK AT+CGACT=? +CGACT:(0,1) OK 上海移远通信技术股份有限公司 29 / 169 BC28-F&BC95-GF AT 命令手册 2.14. AT+CIMI 请求国际移动用户识别码 该命令返回国际移动用户识别码（无双引号的字符串）。 该执行命令使 TA 返回，目的是允许 TE 识别附着到 MT 的 USIM 卡或 UICC 中的活动应用。 AT+CIMI 请求国际移动用户识别码 执行命令 AT+CIMI 响应 OK 测试命令 AT+CIMI=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 / 参数 字符串型。国际移动用户识别码（无双引号）。 错误码。参考第 6 章。 备注 开机后立即查询 IMSI 会失败，建议客户使用 AT+CPIN?命令返回+CPIN: READY 后再去查询 IMSI。 举例 AT+CIMI 460001357924680 OK 上海移远通信技术股份有限公司 30 / 169 BC28-F&BC95-GF AT 命令手册 2.15. AT+CGDCONT 定义 PDP 上下文 设置命令用来指定（本地）上下文指示参数对应的 PDP 上下文参数。因为 PCO 可包含需要加密 的信息，所以该命令也允许 TE 指定是否请求 ESM 信息的安全保护传输。UE 可能有其他原因使用 ESM 信 息的安全保护传输，例如需要转换 APN。测试命令的响应给出了可以同时处于定义状态的 PDP 上下文数量 范围。 对 EPS 而言，设置该命令后会建立 PDN 连接并建立相关的默认承载。 AT+CGDCONT=是设置命令的一种特殊形式，会使的值变成未定义。 如果使能初始 PDP 上下文，则在启动时自动定义=0 的上下文，可以使用 AT+CGDCONT 修改 =0 的参数。 查询命令返回每个已定义上下文的当前设置。 测试命令返回支持的参数的范围。如果 UE 支持多种 PDP 类型，每个的参数值范围会在 单独行返回。 AT+CGDCONT 定义 PDP 上下文 设置命令 响应 AT+CGDCONT=[,[, [,[,[,[,[,[,[,[,[,< 或者 securePCO>]]]]]]]]]]] +CME ERROR: 查询命令 响应 AT+CGDCONT? +CGDCONT:[,[,[,[,< d_comp>[,[,[,[ ,[,[,< NSLPI>[,]]]]]]]]]]] [...] OK 测试命令 若出现任何错误： ERROR 或者 +CME ERROR: 响应 上海移远通信技术股份有限公司 31 / 169 BC28-F&BC95-GF AT 命令手册 AT+CGDCONT=? 最大响应时间 特性说明 +CGDCONT:(支持的范围),(支持的列表),,, (支持的列表),(支持的列表),,,,,(支持的< NSLPI>列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 =0 的 PDP 上下文，深休眠唤醒后有效。其他 PDP 上下 文已激活后，深休眠唤醒有效；未激活时深休眠唤醒无效。 重启后只保存第 0 路的配置。 参数 整型。指示某个 PDP 上下文的标识符。这是 TE-UE 接口的本地参数，可以用在其 他 PDP 上下文相关的命令中。测试命令返回参数值的范围。 网络发起的 PDP 上下文的一些值会超出 AT+CGDCONT=?测试命令所列的 值的范围。 支持的值为 0~10。 当 AUTOCONNECT 设置为 TRUE 时，默认使用=0。 使能 BIP 时，不可将的值设置为 7。 字符串型。分组数据协议类型。 IP 网络协议（IETF STD 5） IPV6 网络协议，IPv6 IPV4V6 引入虚拟处理双 IP 堆栈 UE 功能 NONIP 无 IP 字符串型。用于选择 GGSN 或外部 PDN 的逻辑名称。值为空或省略时，将请求订 阅值。字符串的最大长度为 63 个字符。 字符串型。标识 MT 的 IP 地址（设置命令中该参数将被忽略）。 整型。控制 PDP 数据压缩。 0 关闭 1 打开 （制造商首选压缩） 2 V.42bis 3 V.44 整型。控制 PDP 头压缩。 0 关闭 1 打开（制造商首选压缩） 2 RFC 1144 [105]（仅适用于 SNDCP） 3 RFC 2507 [107] 上海移远通信技术股份有限公司 32 / 169 BC28-F&BC95-GF AT 命令手册 4 RFC 3095 [108]（仅只适用于 PDCP） 整型。为该 PDP 上下文请求的 NAS 信令优先级。 0 根据 UE 中配置的低优先级指示符的值激活此 PDP 上下文。 1 根据低优先级指示符设置为'NAS 信令低优先级 MS 未配置'，激活此 PDP 上 下文。UE 使用 3GPP TS 24.301 和 3GPP TS 24.008 中提供的 NSLPI 信息。 整型。指定是否请求 PCO 的安全保护传输（适用于仅 EPS）。 0 不请求 PCO 的安全保护传输。 1 请求 PCO 的安全保护传输。 整型。控制 MT/TA 如何请求获取 IPv4 地址信息。 0 NAS 信令分配的 IPv4 地址 1 DHCP 分配的 IPv4 地址 整型。PDP 上下文激活请求类型，参见 3GPP TS 24.301（subclause 6.5.1.2）和 3GPP TS 24.008（subclause 10.5.6.17）。如果使能初始 PDP 上下文，则不允许 为紧急承载服务分配=0。根据 3GPP TS 24.008（subclause 4.2.4.2.2）和 subclause 4.2.5.1.4）和 3GPP TS 24.301（subclause 5.2.2.3.3 和 subclause 5.2.3.2.2）规定，须为紧急承载服务建立单独的 PDP 上下文。若紧急承载服务为激 活的上下文，则仅允许进行紧急呼叫，详情参见 3GPP TS 24.401（subclause 4.3.12.9）。 0 PDP 上下文用于新的 PDP 上下文的建立或从非 3GPP 接入网切换（MT 通过该 值决定 PDP 上下文用于新的 PDP 上下文的建立还是非 3GPP 接入网的切换） 1 PDP 上下文用于紧急承载服务 2 PDP 上下文用于新的 PDP 上下文建立 3 PDP 上下文用于非 3GPP 接入网的切换 整型。MT/TA 如何请求获取 P-CSCF 地址（请参阅 3GPP TS 24.229 附录 B 和附录 L）。 0 不受 AT+CGDCONT 影响的 P-CSCF 地址发现。 1 通过 NAS 信令选择 P-CSCF 地址 2 通过 DHCP 选择 P-CSCF 地址 整型。向网络指示 PDP 上下文是否仅用于 IM CN 子系统相关的信令。 0 UE 指示 PDP 上下文不仅用于 IM CN 子系统相关的信令 1 UE 指示 PDP 上下文仅用于 IM CN 子系统相关的信令 整型。为此 PDP 上下文请求的 NAS 信令。 0 指示将使用 MT 中配置的低优先级指示符的值激活该 PDP 上下文。 1 表示将使用低优先级指示符的值设置为'未为 NAS 信令低优先级 配置 MS'来激活此 PDP 上下文。 MT 使用 3GPP TS 24.301 和 3GPP TS 24.008 中指定提供的 NSLPI 信息。 错误码。参考第 6 章。 备注 1. 此 命 令 仅 支 持 参 数 、 、 、 、 、 和 。 2. 的值仅支持 0。的值仅支持 0 和 1。 上海移远通信技术股份有限公司 33 / 169 BC28-F&BC95-GF AT 命令手册 举例 AT+CGDCONT=? +CGDCONT:(0-10),('IP','NONIP','IPV6','IPV4V6'),,,(0),(0,1),,,,,(0,1),(0,1) OK 2.16. AT+CFUN 设置 UE 功能 该命令选择 UE 的功能等级。'全部功能'等级对应高级别的功率。'最小功能'对应低级别的功率。 查询命令返回的当前设置。 AT+CFUN 设置 UE 功能 设置命令 AT+CFUN=[,] 响应 OK 查询命令 AT+CFUN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CFUN: OK 测试命令 AT+CFUN=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CFUN:(支持的列表),(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 25 秒 上海移远通信技术股份有限公司 34 / 169 BC28-F&BC95-GF AT 命令手册 特性说明 见参数说明。 参数 整型。UE 功能等级。 0 最小功能 1 全部功能 整型。UE 重启。 0 在设置功率级别之前不重启 UE。该参数缺省时为默认值。 1 在设置功率级别之前重启 UE（暂不支持且被忽略）。 错误码。参考第 6 章。 举例 AT+CFUN=? +CFUN:(0,1),(0,1) OK AT+CFUN=1 OK AT+CFUN? +CFUN:1 OK 2.17. AT+CMEE 上报 MT 错误 该设置命令可以禁用或使能+CME ERROR:结果码，用于表示 MT 功能相关的错误。启用后，发 生 MT 相关错误时会返回+CME ERROR:最终结果码，而不仅是 ERROR。禁用后，当语法错误、无 效参数或 MT 功能相关错误时，会正常返回 ERROR。 查询命令返回参数的当前设置。 AT+CMEE 上报 UE 错误 设置命令 AT+CMEE= 响应 OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 35 / 169 BC28-F&BC95-GF AT 命令手册 查询命令 AT+CMEE? 测试命令 AT+CMEE=? 最大响应时间 特性说明 +CME ERROR: 响应 +CMEE: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMEE:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存至 NVRAM。 参数 整型。表示错误模式。 0 禁用+CME ERROR: 结果码，使用 ERROR。 1 使能+CME ERROR: 结果码，使用数字格式错误码。 错误码。参考第 6 章。 2.18. AT+CCLK 设置或获取前日期和时间 一旦 UE 连接到网络，将自动设置时钟。执行设置命令前请执行命令 AT+NITZ=0。 查询命令返回时钟的当前设置。 上海移远通信技术股份有限公司 36 / 169 BC28-F&BC95-GF AT 命令手册 AT+CCLK 设置或获取当前日期和时间 设置命令 AT+CCLK= 响应 OK 查询命令 AT+CCLK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCLK: OK 测试命令 AT+CCLK=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存至 NVRAM。 参数 字符串型。格式为 'yy/MM/dd,hh:mm:ss±zz'，各字符分别表示年（最后两位数字）、月、 日、时、分、秒及时区（表示当地时间与 GMT 的时差，以 15 分钟为单位，范围为-96 ~ +96）。 例如，1994 年 5 月 6 日，22:10:00 GMT+8 相当于 '94/05/06,22:10:00+32'。 错误码。参考第 6 章。 备注 核心网络发送 EMM INFORMATION 前不会返回任何值。 举例 AT+CCLK='18/11/09,05:36:42+32' OK AT+CCLK? +CCLK:18/11/09,05:36:42+32 上海移远通信技术股份有限公司 37 / 169 BC28-F&BC95-GF AT 命令手册 OK AT+CCLK=? OK 2.19. AT+CPSMS 设置省电模式 该命令控制 UE 省电模式（PSM）参数的设置，可以用来控制 UE 是否应用 PSM。请参考 AT+CEREG 返回的 URC 查看激活时间值以及 E-UTRAN 分配给 UE 的扩展周期 TAU 值。 AT+CPSMS=2 是该命令的一种特殊形式，在这种形式下，将禁用 PSM，并删除已通过 AT+CPSMS 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 查询命令返回当前参数值。 AT+CPSMS 设置省电模式 设置命令 AT+CPSMS=[,,,[,]] 查询命令 AT+CPSMS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPSMS:[,,,],[] OK 测试命令 AT+CPSMS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPSMS:(支持的列表),,,(支持的范围),(支持的范围) OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 38 / 169 BC28-F&BC95-GF AT 命令手册 最大响应时间 特性说明 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 字符串型。禁用或使能 UE 的 PSM。 0 禁用 PSM 1 启用 PSM 2 禁用 PSM 并删除 PSM 的所有参数，如果有默认参数，则重置为默认。 字符串型。8 位格式的 1 字节参数。表示请求的将在 E-UTRAN 分配给 UE 的扩展周期性 TAU 值（T3412），且被编码为 GPRS Timer 3 信息的一个 字节（octet 3），编码为位格式（例如，'01000111'等于 70 小时）。 第 5 位到第 1 位代表二进制编码定时器值。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了定时器值的单位，定义如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增（备注） 1 1 1 该值表示定时器被停用 默认值为 10 小时。 字符串型。8 位格式的 1 字节参数。表示将分配给 UE 的请求激活时间值 （T3324），且被编码为 GPRS Timer 2 信息元素的一个字节（octet 3） ，编码为位格式（例如，'00100100'等于 4 分钟）。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了 GPRS 定时器值的有效时间值的单位，定义如下： 位数 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 表示定时器被停用的值 默认值为 10 秒。 错误码。参考第 6 章。 上海移远通信技术股份有限公司 39 / 169 BC28-F&BC95-GF AT 命令手册 备注 1. 该定时器值的单位仅适用于 T3412 扩展值 IE。如果以完整性保护消息的形式接收，那么将以 320 小 时的倍数解读接收到的值，否则，将以 1 小时的倍数解读。 2. AT+CPSMS?查询命令目前只能获取模式值 0 和 1。 举例 AT+CPSMS=1,,,01000011,01000011 OK AT+CPSMS? +CPSMS:1,,,01000011,01000011 OK AT+CPSMS=? +CPSMS:(0,1,2),,,(00000000-11111111),(00000000-11111111) OK 2.20. AT+CEDRXS 设置 eDRX 设置命令控制 UE 的 eDRX 参数的设置，用于控制是否要应用 eDRX，以及每种指定接入技术类型的 请求 eDRX 值。 当=2，设置命令设置当网络提供的 eDRX 参数改变时 URC +CEDRXP:[,[,[,]]] 的上报。 AT+CEDRXS=3 为该命令的一种特殊形式。此形式的命令将禁用 eDRX，并删除已通过 AT+CEDRXS 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 查询命令返回的每个定义值的当前设置。 AT+CEDRXS 设置 eDRX 设置命令 响应 AT+CEDRXS=[,[, OK ]] 若出现任何错误： ERROR 或者 +CME ERROR: 查询命令 响应 AT+CEDRXS? +CEDRXS:, 上海移远通信技术股份有限公司 40 / 169 BC28-F&BC95-GF AT 命令手册 测试命令 AT+CEDRXS=? 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXS:(支持的列表),(支持的列表), (支持的范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。启用或禁用 eDRX。该参数适用于所有指定的接入技术类型，即的最 新设置将对的所有指定值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并启用 URC： +CEDRXP:[,[,[,]]] 3 禁用 eDRX 并删除 eDRX 的所有参数 整型。接入技术类型。 0 接入技术未使用 eDRX，该参数值仅在 URC 中使用 5 E-UTRAN（NB-S1 模式） 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 上海移远通信技术股份有限公司 41 / 169 BC28-F&BC95-GF AT 命令手册 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗口时长 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 错误码。参考第 6 章。 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? 上海移远通信技术股份有限公司 42 / 169 +CEDRXS:5,'0101' OK AT+CEDRXS=? +CEDRXS:(0,1,2,3),(5),('0000'-'1111') OK AT+CEDRXS=0,5 OK BC28-F&BC95-GF AT 命令手册 2.21. AT+CEDRXRDP 读取动态 eDRX 参数 当 eDRX 用于 UE 当前注册的小区时，该执行命令返回、、 和。 如果 UE 当前注册的小区未使用 eDRX，则返回=0。 AT+CEDRXRDP 读取动态 eDRX 参数 执行命令 AT+CEDRXRDP 响应 +CEDRXRDP:[,[,[,]]] OK 测试命令 AT+CEDRXRDP=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 / 参数 整型。接入技术类型。AT+CEDRXS 用于指定接入技术类型与请求的 eDRX 值之间的关系。 0 接入技术未使用 eDRX。该参数值仅在 URC 中使用。 5 E-UTRAN（NB-S1 模式） 上海移远通信技术股份有限公司 43 / 169 BC28-F&BC95-GF AT 命令手册 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗口长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.3 6 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 上海移远通信技术股份有限公司 44 / 169 1 1 1 1 40.96 秒 错误码。参考第 6 章。 举例 AT+CEDRXRDP +CEDRXRDP:5,'0010','1110','0101' OK AT+CEDRXRDP=? OK BC28-F&BC95-GF AT 命令手册 2.22. AT+CEER 扩展错误报告 该执行命令让 UE 返回一行或多行由 UE 制造商确定的信息文本，为 UE 用户提供一份错误原 因的扩展报告，错误类型如下： ⚫ 上一次呼叫释放失败 ⚫ 上一次 PDP 上下文激活失败 ⚫ PDP 上下文去激活失败 通常，文本将由单行组成，包含网络给出文本格式原因信息。 AT+CEER 扩展错误报告 设置命令 AT+CEER 响应 +CEER: OK 测试命令 AT+CEER=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 该命令立即生效。 上海移远通信技术股份有限公司 45 / 169 BC28-F&BC95-GF AT 命令手册 参数 扩展错误报告。信息文本（包括行终止符在内）的字符总数不超过 2041。文本不包含 0或 OK。 错误码。参考第 6 章。 举例 AT+CEER +CEER:EMM_CAUSE_EPS_AND_NON_EPS_SERVICES_NOT_ALLOWED OK AT+CEER=? OK 2.23. AT+CIPCA 初始 PDP 上下文激活 设置命令用于控制 UE 在是否有 PDN 连接的情况下连接到 E-UTRAN。当=3 时适用于 E-UTRAN RATs。改变的值不会引起 PDP 上下文去激活。 当=1 时，表示在没有 PDN 连接的情况下进行 EPS 附着。 查询命令会返回命令的当前设置情况。 AT+CIPCA 初始 PDP 上下文激活 设置命令 AT+CIPCA=[,] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 查询命令 AT+CIPCA? 响应 +CIPCA:[,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 46 / 169 BC28-F&BC95-GF AT 命令手册 测试命令 AT+CIPCA=? 最大响应时间 特性说明 响应 +CIPCA:(支持的列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。附着时激活 PDP 上下文。 3 不改变当前设置 整型。表示 EPS 附着是否有 PDN 连接。缺省值为 0。 0 表示 EPS 附着时有 PDN 连接 1 表示 EPS 附着时没有 PDN 连接 错误码。参考第 6 章。 举例 AT+CIPCA=3 OK AT+CIPCA=? +CIPCA:(3),(0,1) OK 2.24. AT+CGAPNRC APN 速率控制 命令用于查询与对应上下文标识符关联的 APN 速率控制参数（参考 3GPP TS 24.008）。如果 参数省略，则返回所有已激活 PDP 上下文的 APN 速率控制参数。 AT+CGAPNRC APN 速率控制 执行/设置命令 AT+CGAPNRC[=] 响应 [+CGAPNRC:[,[,[,]]]] 上海移远通信技术股份有限公司 47 / 169 测试命令 AT+CGAPNRC=? 最大响应时间 特性说明 BC28-F&BC95-GF AT 命令手册 [+CGAPNRC:[,[,[,]]]] [...]]]] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAPNRC:(与已激活上下文关联的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。指示某个 PDP 上下文的标识符（参考 AT+CGDCONT）。 整型。表示当达到最大上行速率时是否允许发送附加异常报告。 0 不允许以最大速率发送（Additional exception reports） 1 允许以最大速率发送（Additional exception reports） 整型。用来指定最大上行速率的时间单位。 0 不受限 1 分钟 2 小时 3 天数 4 周 整型。指定每个上行时间单位限制 UE 发送的最大消息数。时间 单位以上行时间单位表示，如果上行时间单位设为'不受限'（即 0），那么 UE 可以发送的最大上行数据数量将不受限制。 错误码。参考第 6 章。 举例 AT+CGAPNRC 上海移远通信技术股份有限公司 48 / 169 +CGAPNRC:0,0,0 OK AT+CGAPNRC=? +CGAPNRC:(0) OK BC28-F&BC95-GF AT 命令手册 2.25. AT+CGCONTRDP 查询 PDP 上下文的动态参数 执行命令返回带有上下文标识符的活跃非辅助 PDP 上下文相关信息：、、 、 、 、 和 。 ⚫ 如果 UE 指示 2 个以上 P-CSCF 服务器的 IP 地址或 2 个以上 DNS 服务器的 IP 地址，则每个 将返回多行信息。 ⚫ 如果 UE 具有双栈功能，则每个至少返回两行信息：一行带有 IPv4 参数，紧接在后的一行 带有 IPv6 参数。如果具有双栈功能的 UE 指示两个以上 P-CSCF 或 DNS 服务器的 IP 地址，则将 返回多对这样的信息行。 ⚫ 如果省略参数，将会返回所有活跃的非辅助 PDP 上下文的相关信息。 测试命令会响应与活跃的非辅助上下文相关的列表。 AT+CGCONTRDP 查询 PDP 上下文的动态参数 执行/设置命令 AT+CGCONTRDP[=] 响应 +CGCONTRDP:[,[,[,[,[,[,]]]]]] OK 测试命令 AT+CGCONTRDP=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGCONTRDP:(与已激活上下文关联的列表) OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 49 / 169 最大响应时间 特性说明 或者 +CME ERROR: 5秒 / BC28-F&BC95-GF AT 命令手册 参数 整型。用于指定某个非辅助 PDP 上下文。此参数是 TE-MT 接口的本地参数，用于 与 PDP 上下文相关的其他命令（参考 AT+CGDCONT 命令）。 整型。承载的标识，例如 EPS 中的 EPS 承载。 字符串型。用于选择 GGSN 或外部 PDN 的逻辑名称。 字符串型。表示 MT 的 IP 地址和子网掩码。 该字符串为点分隔数字（0~255）参数的形式，如下所示： IPv4 的形式为'a1.a2.a3.a4.m1.m2.m3.m4'或 IPv6 的形式为'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a 15.a16.m1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14. m15.m16'。 字符串型。表示 MT 的网关地址。该字符串为点分隔数字（0~255）参数的形式。 字符串型。表示主 DNS 服务器的 IP 地址。 字符串型。表示备用 DNS 服务器的 IP 地址。 整型。错误码。参考第 6 章。 备注 只 有 当 =IP 或 =IPV6 时 （ 请 参 考 AT+CGDCONT 命 令 ） ， 才 能 显 示 和。 举例 AT+CGCONTRDP +CGCONTRDP:0,,'CMCC.MNC004.MCC460.GPRS',,,211.136.20.203,211.136.17.107 OK AT+CGCONTRDP=? +CGCONTRDP:(0) OK 上海移远通信技术股份有限公司 50 / 169 BC28-F&BC95-GF AT 命令手册 2.26. AT+CGAUTH 定义 PDP 上下文鉴权参数 该设置命令允许 TE 为 PDP 上下文指定鉴权参数，该 PDP 上下文由 PDP 上下文激活和修改过程中使 用的（本地）上下文识别参数标识。由于参数与 AT+CGDCONT 命令中使用的参数相同，因此 AT+CGAUTH 命令实际上是 AT+CGDCONT 命令的扩展。 查询命令会返回每个已定义上下文的当前设置。 AT+CGAUTH 定义 PDP 上下文鉴权参数 设置命令 响应 AT+CGAUTH=[,[,[,]]] 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+CGAUTH? [+CGAUTH:,,,] [+CGAUTH:,,,] [...] OK 测试命令 AT+CGAUTH=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAUTH:(支持的范围),(支持的列表),(支 持的长度范围),(支持的长度范围) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 51 / 169 BC28-F&BC95-GF AT 命令手册 参数 整型。指示某个 PDP 上下文的标识符（见 AT+CGDCONT 命令）。 整型。表示 PDP 上下文使用的鉴权协议。 0 无，用于指示此 PDP 上下文不使用任何鉴权协议，如果之前已指定，则删除用户名 和密码 1 PAP 2 CHAP 字符串型。表示访问 IP 网络的用户名。参数为 1 或 2 时，需要参数。 最大长度为 20 字节。 字符串型。表示访问 IP 网络的密码。字符串最大长度为 20 个字节。 错误码。参考第 6 章。 备注 当前不支持 CHAP 鉴权协议。 举例 AT+CGAUTH? +CGAUTH:0,1,'1234','1234' OK AT+CGAUTH=? +CGAUTH:(0-10),(0,1),(0-20),(0-20) OK 2.27. AT+CNMPSD 指示无更多 PS 数据 执行命令指示没有应用程序期望进行数据交换。该命令可用于普通和 Modem 兼容模式。 AT+CNMPSD 指示无更多 PS 数据 执行命令 AT+CNMPSD 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 52 / 169 测试命令 AT+CNMPSD=? 最大响应时间 特性说明 响应 OK 5秒 / 参数 错误码。参考第 6 章。 举例 AT+CNMPSD OK AT+CNMPSD=? OK BC28-F&BC95-GF AT 命令手册 2.28. AT+CPIN 输入 PIN 码 此设置命令在 UE 可以操作之前，向 UE 发送必要的密码（如 USIM PIN 码和 USIM PUK 码等）。如 果需要输入两次 PIN 码，TA 将自动重复 PIN 码。如果没有待处理的 PIN 请求，此命令不会对 UE 实施任 何操作并且会响应错误+CME ERROR: 。 如果需要的 PIN 码是 SIM PUK，则需要第二个 PIN 参数。第二个 PIN 用于替换 SIM 中的旧 PIN。 查询命令会返回字母数字字符串，表示是否需要某些密码。 AT+CPIN 输入 PIN 码 设置命令 AT+CPIN=[,] 响应 OK 查询命令 AT+CPIN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPIN: OK 上海移远通信技术股份有限公司 53 / 169 BC28-F&BC95-GF AT 命令手册 测试命令 AT+CPIN=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 该命令立即生效。 保存机制与(U)SIM 卡有关；参数配置不保存至 NVRAM。 参数 字符串型。表示密码。 字符串型。表示请求的代码是 PUK 时所需的新密码。 READY SIM PIN 表示 UE 无密码输入请求 表示 USIM PIN 密码请求 SIM PUK 表示 SIM PUK 密码请求 SIM PUK BLOCKED 如果在输入错误的 PUK 10 次后 SIM 卡被锁定，则在开 机时主动上报 错误码。参考第 6 章。 备注 当前不支持 PIN2 和 PUK2。 举例 AT+CPIN=1234 OK AT+CPIN? +CPIN: READY OK AT+CPIN=? OK 上海移远通信技术股份有限公司 54 / 169 BC28-F&BC95-GF AT 命令手册 2.29. AT+CPINR 查询剩余 PIN 的重试次数 设置命令和执行命令会使 UE 返回其密码的剩余 PIN 重试次数。 AT+CPINR 查询剩余 PIN 重试次数 设置命令 AT+CPINR= 响应 [+CPINR: ,[,]] OK 执行命令 AT+CPINR 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+CPINR: ,[,]] [+CPINR: ,[,]] OK 测试命令 AT+CPINR=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 / 参数 整型。每个 PIN 的剩余重试次数。 整型。每个 PIN 的默认/初始重试次数。 PIN 的类型，除了 READY 之外，所有在 AT+CPIN 命令参数列出的值。 错误码。参考第 6 章。 备注 1.只有当 AT+CFUN=1 时，才能执行 AT+CPINR 的设置命令和执行命令。 2.当前不支持 PIN2 和 PUK2。 上海移远通信技术股份有限公司 55 / 169 举例 AT+CPINR='SIM PUK' +CPINR: SIM PUK,10,10 OK AT+CPINR +CPINR: SIM PIN,3,3 +CPINR: SIM PUK,10,10 OK BC28-F&BC95-GF AT 命令手册 2.30. AT+CCHO 打开逻辑信道 命令 AT+CCHO=使 MT 返回，TE 端通过此参数识别当前选定的 UICC 分配的 信道，此信道依附于 ME。当前选定的 UICC 会打开一个新的逻辑信道；选择由命令收到的标识 的应用，并返回一个会话 ID。ME 应将 TE 和 UICC 之间的通信限制在该逻辑信道上。 在执行命令 AT+CRLA 或 AT+CGLA 时，也将使用此。 AT+CCHO 打开逻辑信道 设置命令 AT+CCHO= 响应 OK 测试命令 AT+CCHO=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 56 / 169 BC28-F&BC95-GF AT 命令手册 参数 字符串型。十六进制格式。UICC 中所有可选应用都用 DF Name 编码。 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM 和 ISIM） 上一个特定应用。 错误码。参考第 6 章。 备注 APDU 命令中 CLASS 字节包含逻辑信道号，故发送到 UICC 的所有 APDU 命令都会包含逻辑信道号。因 此需由 MT 端负责管理 ADPU CLASS 字节中的逻辑信道部分，并确保选择的逻辑信道和执行命令返回的 相关联。 举例 AT+CCHO=? OK 2.31. AT+CCHC 关闭逻辑信道 该命令用来关闭 ME 与当前 UICC 之间的通信会话，ME 需关闭之前打开的逻辑信道，关闭后 TE 端无 法再次通过此逻辑信道发送命令。接收该命令后，UICC 会关闭逻辑信道。 AT+CCHC 关闭逻辑信道 设置命令 AT+CCHC= 响应 OK 测试命令 AT+CCHC=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 57 / 169 BC28-F&BC95-GF AT 命令手册 参数 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM、ISIM） 上一个特定应用。 错误码。参考第 6 章。 举例 AT+CCHC=1 OK AT+CCHC=? OK 2.32. AT+CGLA 通用 UICC 逻辑信道访问 设置命令发送到 MT 端，然后由 MT 端发送到所选择的 UICC。同样，UICC 会通过 MT 端返回到 TA。 该命令允许通过 TE 上的远程应用程序直接控制当前选择的 UICC。然后，TE 应在 GSM/UMTS 指定的 框架内处理 UICC 信息。 虽然通用 UICC 逻辑信道访问命令 AT+CGLA 允许 TE 控制 UICC-MT 接口，但是逻辑上不需要从 TA/MT 外部访问 UICC-MT 接口的一些功能。此外，出于安全原因，不应在 TA/MT 之外处理 GSM 网络鉴权。因 此，无论 AT+CGLA 是锁定的还是解锁的，都不能在 TE 中使用 AT+CGLA 在 GSM 上下文中运行 GSM 算 法命令或鉴权命令。这不应禁止 TE 在其他安全上下文中发送身份鉴权命令。 例如，当参数 P2 为 0（GSM 安全上下文）时，TA/MT 应禁止将鉴权命令发送到 USIM 应用程序。USIM 鉴权命令详细信息，请参考 3GPP TS 31.102。 AT+CGLA 通用 UICC 逻辑信道访问 设置命令 AT+CGLA=,, 响应 +CGLA: , OK 测试命令 AT+CGLA=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 58 / 169 BC28-F&BC95-GF AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM、ISIM） 上一个特定应用。 整型。在或中发送给 TE 的字符长度（是命令或响应实际长 度的两倍） MT 端以 3GPP TS 31.101 所述的格式发送至 UICC 的命令（十六进制字符格式，参考 3GPP TS 27.007 中的 +CSCS）。 UICC 发送到 MT 端针对的响应，格式与 3GPP TS 31.101 中描述一致（十 六进制字符格式，参考 3GPP TS 27.007 中的 +CSCS）。 错误码。参考第 6 章。 备注 与访问受限 UICC 命令 AT+CRLA 相比，AT+CGLA 的定义允许 TE 对 UICC-MT 接口进行更多控制。接 口的锁定和解锁可以通过特殊的值完成，也可以由 TA/MT 自动完成（通过解析 参数）。如果 TE 应用程序未在某个超时值中使用解锁命令（或者不发送使自动解锁的）， 则 MT 可以释放锁定。 举例 AT+CGLA=? OK 2.33. AT+CRSM 受限 SIM 卡访问 通过使用该命令访问 SIM 数据库，相对于使用通用 SIM 访问 AT+CSIM 而言，该命令更简便也更受限 制。 执行命令向 MT 发送 SIM及其所需参数。如果 SIM 卡安装在当前选定的卡槽中，则 MT 在内部处理所有 SIM-MT 接口锁定和文件选择例程。作为对命令的响应，MT 发送实际 SIM 信息参数和响 上海移远通信技术股份有限公司 59 / 169 BC28-F&BC95-GF AT 命令手册 应数据。当命令无法传递给 SIM 时，可能会返回 MT 错误结果代码+CME ERROR，若 SIM 中执行命令失 败，会在参数和中上报。 对于 SIM 发出的命令请求和 MT 内部 GSM/UMTS 应用程序发出的命令请求之间的协调取决于实现。 但是 TE 应注意 GSM/UMTS 应用程序命令对 TE 命令的优先级。 AT+CRSM 受限 SIM 卡访问 设置命令 响应 AT+CRSM=[,[,<P +CRSM: ,[,] 1>,,[,[,]]]] OK 测试命令 AT+CRSM=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 保存机制与(U)SIM 有关；参数配置不保存至 NVRAM。 参数 、、 MT 传递给 SIM 的命令。参考 3GPP TS 51.011。 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS 整型。SIM 上基本数据文件的标识符。除=242（STATUS）之外， 对于每个命令来说该参数为必要参数。 整型。MT 传递给 SIM 的参数。除 GET RESPONSE 和 STATUS 之外，对于其 他命令必须指定这些参数。请参考 3GPP TS 51.011。 十六进制格式。应写入 SIM 的信息。参考 3GPP TS 27.007 中的 +CSCS。 字符串型。十六进制格式。包含 SIM/UICC 基础文件路径（例如 SIM 和 UICC 情况下的'7F205F70'），仅用于'从 MF 选取路径'模式。 上海移远通信技术股份有限公司 60 / 169 BC28-F&BC95-GF AT 命令手册 、 整型。来自 SIM 关于实际命令执行的信息。在命令执行成功或失败时，这些参 数都会传递给 TE。 字符串型。十六进制格式。成功完成上一次发出命令的响应（请参考 3GPP TS 27.007 中的 +CSCS）。STATUS 和 GET RESPONSE 返回数据。该数据提供 有关当前基本数据字段的信息。该信息包括文件类型及其大小（参考 3GPP TS 51.011）。在 READ BINARY，READ RECORD 或 RETRIEVE DATA 命令之后， 将返回所请求的数据。成功执行 UPDATE BINARY，UPDATE RECORD 或 SET DATA 命令后，不会返回。 错误码。参考第 6 章。 备注 1. 在执行实际命令之前，MT 在内部执行选择目标文件所需的所有命令。 2. 有效文件标识符的范围取决于实际 SIM，可查看 3GPP TS 51.011 中定义。可选文件可能不显示。 3. 由于有效的基本文件标识符在所有有效的专用文件标识符上可能不是唯一的，所以表示在模 糊文件标识符的情况下的目标 UICC/SIM 目录路径。对于该规范的早期版本，或者省略了， 则根据具体实现情况选择。 举例 AT+CRSM=242 +CRSM: 144,0 OK AT+CRSM=? OK 2.34. AT+CSIM 通用 SIM 卡访问 设置命令向 MT 发送，然后 MT 发送至 SIM 卡。同样，MT 发送 SIM 卡至 TA。 该命令允许通过 TE 上的远程应用直接控制安装在当前所选卡槽中的 SIM 卡。然后，TE 应在 GSM/UMTS 指定的框架内处理 UICC 信息。 AT+CSIM 通用 SIM 卡访问 设置命令 AT+CSIM=, 响应 +CSIM: , OK 上海移远通信技术股份有限公司 61 / 169 BC28-F&BC95-GF AT 命令手册 测试命令 AT+CSIM=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 保存机制与(U)SIM 卡有关；参数配置不保存至 NVRAM。 参数 整型。在或中发送给 TE 的字符长度（命令或响应的实际 长度的两倍）。 由 MT 以 3GPP TS 51.011 中描述的格式传送给 SIM 卡的命令（十六进制字符 格式；参考 3GPP TS 27.007 中的 +CSCS）。 响应 SIM 卡以 3GPP TS 51.011（十六进制字符格式；参考 3GPP TS 27.007 中的 +CSCS）描述的格式传递给 MT 的命令。 错误码。参考第 6 章。 举例 AT+CSIM=10,'00B2010426' +CSIM: 4,6981 OK AT+CSIM=? OK 2.35. AT+CCIOTOPT CIoT 优化配置 设置命令控制 UE 在 ATTACH REQUEST 和 TRACKING AREA UPDATE REQUEST 消息中指示支持 和优先选择的 CIOT EPS 优化配置。该命令还可用来上报网络支持的 CIoT EPS 优化配置。支持 CIoT 功能 的 UE 可以支持控制面（control plane）或用户面（user plane）的 CIoT EPS 优化配置，或两者都可支持 （请参考 3GPP TS 24.301, subclause 9.9.3.34）。基于应用特性，UE 可能优先选择注册用于控制面的 CIoT EPS 优化配置或用于用户面的 CIoT EPS 优化配置（请参考 3GPP TS 24.301, sub-clause 9.9.3.0B）。 上海移远通信技术股份有限公司 62 / 169 BC28-F&BC95-GF AT 命令手册 此外，网络可支持控制面 CIoT EPS 优化配置或用户面 CIoT EPS 优化配置或两者都可支持（参考 3GPP TS 24.301, subclause 9.9.3.12A）。 设置命令还用于设置开启或关闭 URC +CCIOTOPTI: ，该 URC 用于表示 网络所支持的 CIoT EPS 优化配置。 AT+CCIOTOPT CIoT 优化配置 设置命令 响应 AT+CCIOTOPT=[,[[,]]] 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+CCIOTOPT? +CCIOTOPT:,, OK 测试命令 AT+CCIOTOPT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCIOTOPT:(支持的列表),(支持的列表),(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后仍有效；参数配置自动保存至 NVRAM。 参数 整型。启用或禁用 URC +CCIOTOPTI 的上报。 0 禁用 URC 1 启用 URC 上海移远通信技术股份有限公司 63 / 169 BC28-F&BC95-GF AT 命令手册 3 禁用上报并将 CIoT EPS 优化配置的参数重置为默认值 整型。表示 UE 对 CIoT EPS 优化配置的支持情况。 0 不支持 1 支持控制面 CIoT EPS 优化 3 支持控制面和用户面 CIoT EPS 优化 整型。表示 UE 对 CIoT EPS 优化的偏好。 0 没有偏好 1 偏好控制面 CIoT EPS 优化 2 偏好用户面 CIoT EPS 优化 整型。表示网络支持的 CIoT EPS 优化。 0 不支持 1 支持控制面 CIoT EPS 优化 2 支持用户面 CIoT EPS 优化 3 支持控制面 CIoT EPS 优化和用户面 CIoT EPS 优化 错误码。参考第 6 章。 备注 1. 仅支持 1 和 3。 2. 仅支持 1 和 2。 3. 仅当为 3 时，才能将设置为 2。 举例 AT+CCIOTOPT=1,3,2 OK AT+CCIOTOPT? +CCIOTOPT:1,3,2 OK AT+CCIOTOPT=? +CCIOTOPT:(0,1,3),(1,3),(1,2) OK 上海移远通信技术股份有限公司 64 / 169 BC28-F&BC95-GF AT 命令手册 3 SMS 相关命令（27.005） 3.1. AT+CSMS 选择短信服务 设置命令用来选择短信服务，它会返回 UE 支持的短信类型：表示被叫消息，表示主叫消 息，表示广播类型消息。如果 ME 不支持所选的服务，将会返回最终结果码+CME ERROR:。 查询命令会返回当前服务设置中支持的消息类型。 AT+CSMS 选择短信服务 设置命令 AT+CSMS= 响应 +CSMS:,, OK 查询命令 AT+CSMS? 若出现任何错误： ERROR 或者 +CMS ERROR: 响应 +CSMS:,,, OK 测试命令 AT+CSMS=? 若出现任何错误： ERROR 或者 +CMS ERROR: 响应 +CSMS:(支持的列表) OK 若出现任何错误： ERROR 或者 +CMS ERROR: 上海移远通信技术股份有限公司 65 / 169 BC28-F&BC95-GF AT 命令手册 最大响应时间 特性说明 5秒 该命令立即生效。 深休眠唤醒后无效；不保存到 NVRAM。 参数 整型。表示消息服务。 0 表示 3GPP TS 23.040 和 3GPP TS 23.041 1 表示 3GPP TS 23.040 和 3GPP TS 23.041，相应的命令描述中提到了参数 设置为 1 的要求 整型。被叫消息。 0 不支持 1 支持 整型。主叫消息。 0 不支持 1 支持 整型。广播类型消息。 0 不支持 1 支持 错误码。参考第 6 章。 举例 AT+CSMS=1 +CSMS:1,1,0 OK AT+CSMS? +CSMS:1,1,1,0 OK AT+CSMS=? +CSMS:(0,1) OK 3.2. AT+CSCA 设置短信服务中心地址 设置命令用于更新 SMSC 地址，通过该地址发送主叫短信。在文本模式下，可以使用设置命令进行设 置。在 PDU 模式下，仅当 SMSC 地址的长度编码为 =0 时，可使用同一命令进行设置。 上海移远通信技术股份有限公司 66 / 169 BC28-F&BC95-GF AT 命令手册 AT+CSCA 设置短信服务中心地址 设置命令 AT+CSCA=[,] 响应 OK 查询命令 AT+CSCA? 若出现任何错误： ERROR 或者 +CMS ERROR: 响应 +CSCA:[,] OK 测试命令 AT+CSCA=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CMS ERROR: 响应 OK 5秒 该命令立即生效。 深休眠唤醒后无效；不保存到 NVRAM（会保存到 SIM 卡）。 参数 表示 3GPP TS 24.011RP SC 地址字符串格式的地址-值字段。BCD 数字（或 GSM 7 位 默认字母字符）被转换为当前选择的 TE 字符集的字符（参考 3GPP TS 27.007 中的 +CSCS）；地址类型由给出。 表示 3GPP TS 24.011RP SC 地址整数格式的八位字节地址类型。当（参考 3GPP TS 27.005）的第一个字符为'+(IRA 43)'时，此参数默认值为 145，否则默认值为 129。 错误码。参考第 6 章。 举例 AT+CSCA=358501234567,145 OK AT+CSCA? +CSCA:'358501234567',145 OK AT+CSCA=? OK 上海移远通信技术股份有限公司 67 / 169 BC28-F&BC95-GF AT 命令手册 3.3. AT+CMGS 发送短消息 该命令可以从 TE 向网络发送消息（SMS-SUBMIT）。发送成功后，短消息参考值将被返回给 TE。在接收到非请求发送状态报告结果码时，使用该取值可进行短消息识别。 AT+CMGS 发送短消息 测试命令 AT+CMGS=? 设置命令 文本模式（AT+CMGF=1 1)）： AT+CMGS=[,] 响应 OK 响应 > 返回 > 后输入文本，按'Ctrl'+'Z'发送短消息，按'Esc' 退出发送 +CMGS: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CMS ERROR: 120 秒，受网络状态影响 该命令立即生效。 深休眠唤醒后无效；不保存到 NVRAM。 参数 字符串型。3GPP 23.040 中的 TP-Destination-Address 地址——取值字段；将 BCD 数 值（或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 3GPP TS 27.007 中的 +CSCS）；给定的地址类型 整型。3GPP 24.011 中的 TP-Destination-Address 中的'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 整型。表示 3GPP TS 23.040 中的 TP-Message-Reference（消息参考）。 错误码。参考第 6 章。 举例 AT+CMGS='15021012496' > This is a test from Quectel +CMGS: 247 OK //输入文本短消息内容，按'Ctrl'+'Z'发送短消息；按'Esc'退 出发送 上海移远通信技术股份有限公司 68 / 169 BC28-F&BC95-GF AT 命令手册 备注 1) AT+CMGF 用于在文本和 PDU 模式之间切换 SMS 格式，BC28-F 和 BC95-GF 模块短信功能目前只支 持文本模式，不支持 PDU 模式，不支持 AT+CMGF 命令。 上海移远通信技术股份有限公司 69 / 169 BC28-F&BC95-GF AT 命令手册 4 一般命令 4.1. AT+NRB 重启 UE 该命令用来重启 UE。执行此命令之后，会有短暂的延迟，UE 才会重启。在执行该命令期间不再处理 其他 AT 命令。 须注意，由于 AT 命令的处理终止于该命令，因此最后不会返回 OK 表示命令行已处理完成。重启之前 不会发出确认消息。 AT+NRB 重启 UE 执行命令 AT+NRB 最大响应时间 特性说明 响应 REBOOTING 5秒 / 举例 AT+NRB REBOOTING 4.2. AT+NUESTATS 查询 UE 统计信息 该命令用来获取最新的操作统计信息。该命令可以采用一个可选参数来显示不同的统计数据集。 =RADIO 和执行命令 AT+NUESTATS 一样会提供默认值集，=ALL 将打印所有数据。 AT+NUESTATS 查询 UE 统计信息 设置命令 AT+NUESTATS= 响应 NUESTATS:,,[,<value[,[...]]] [...NUESTATS:,,[,<value[,[...]]]] 上海移远通信技术股份有限公司 70 / 169 执行命令 AT+NUESTATS 设置命令 查询具体无线信息 AT+NUESTATS=RADIO 上海移远通信技术股份有限公司 BC28-F&BC95-GF AT 命令手册 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 Signal power: Total power: TX power: TX time: RX time: Cell ID: ECL: SNR: EARFCN: PCI: RSRQ: OPERATOR MODE: CURRENT BAND: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:RADIO,Signal power: NUESTATS:RADIO,Total power: NUESTATS:RADIO,TX power: NUESTATS:RADIO,TX time: NUESTATS:RADIO,RX time: NUESTATS:RADIO,Cell ID: 71 / 169 设置命令 查询前八个小区信息 AT+NUESTATS=CELL 设置命令 查询吞吐量 AT+NUESTATS=THP BC28-F&BC95-GF AT 命令手册 NUESTATS:RADIO,ECL: NUESTATS:RADIO,SNR: NUESTATS:RADIO,EARFCN: NUESTATS:RADIO,PCI: NUESTATS:RADIO,RSRQ: NUESTATS:RADIO,OPERATOR MODE: NUESTATS:RADIO,CURRENT BAND: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:CELL,,,,,,, [...NUESTATS:CELL,,,,,,,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:THP,RLC UL, NUESTATS:THP,RLC DL, NUESTATS:THP,MAC UL, NUESTATS:THP,MAC DL, 上海移远通信技术股份有限公司 72 / 169 设置命令 查询误块率信息 AT+NUESTATS=BLER 设置命令 查询动态存取使用情况 AT+NUESTATS=APPSMEM 上海移远通信技术股份有限公司 BC28-F&BC95-GF AT 命令手册 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:BLER,RLC UL BLER, NUESTATS:BLER,RLC DL BLER, NUESTATS:BLER,MAC UL BLER, NUESTATS:BLER,MAC DL BLER, NUESTATS:BLER,Total TX bytes, NUESTATS:BLER,Total RX bytes, NUESTATS:BLER,Total TX blocks, NUESTATS:BLER,Total RX blocks, NUESTATS:BLER,Total RTX blocks, NUESTATS:BLER,Total ACK/NACK RX, OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:APPSMEM,Current Allocated: NUESTATS:APPSMEM,Total Free: NUESTATS:APPSMEM,Max Free: 73 / 169 BC28-F&BC95-GF AT 命令手册 测试命令 AT+NUESTATS=? 最大响应时间 特性说明 NUESTATS:APPSMEM,Num Allocs: NUESTATS:APPSMEM,Num Frees: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 20 秒 / 参数 不带引号的字符串型。表示要显示的数据类型。支持的值有： RADIO 具体无线信息 CELL 前 8 个小区信息 BLER 误块率信息 THP 吞吐量 APPSMEM 动态内存使用情况 ALL 所有信息。输出每种数据类型的正确值。 如果=RADIO，将返回默认值集： 信号功率。 总功率。 当前强发功率等级。 自上次重启以来总的 TX 时间。单位：毫秒。 自上次重启以来总的 RX 时间。单位：毫秒。 上一个 SIB1 的小区 ID。 上一个 ECL 的值。 上一个 SNR 的值。 上一个 EARFCN 的值。 上海移远通信技术股份有限公司 74 / 169 BC28-F&BC95-GF AT 命令手册 上一个 PCI 的值。 参考信号接收质量。 部署模式。 0 未知模式 1 带内不同的 PCI 模式 2 带内相同的 PCI 模式 3 保护带模式 4 独立模式 服务小区的频段。 如果 =CELL 表示前 8 个小区信息，返回参数形式为：,,,,,, 绝对射频频道号。 物理小区 ID。 1 表示当前服务小区。 参考信号接收功率。 参考信号接收质量。 接收信号强度指示。 信噪比。 如果 =BLER，返回的参数类型如下： RLC 层误块率（上行），整数百分比。 RLC 层误块率（下行），整数百分比。 MAC 层误块率（上行），整数百分比。 MAC 层误块率（下行），整数百分比。 传输的总字节数。 接收的总字节数。 发送的传输块。 接收的传输块。 重新传输的传输块。 收到 ACK/NACK 消息的总数。 如果=THP，返回的参数类型如下： 整数。RLC 层吞吐量（上行）。单位：bps。 整数。RLC 层吞吐量（下行）。单位：bps。 整数。MAC 吞吐量（上行）。单位：bps。 整数。MAC 吞吐量（下行）。单位：bps。 如果=APPSMEM，表示动态内存使用情况，返回的参数类型如下： 当前已分配的内存大小。 总的剩余内存大小。 最大的剩余内存大小。 分配内存的次数。 剩余内存的次数。 错误码。参考第 6 章。 上海移远通信技术股份有限公司 75 / 169 BC28-F&BC95-GF AT 命令手册 备注 1. 执行命令 AT+NUESTATS 的响应结果与设置命令 AT+NUESTATS=RADIO 的响应结果相同，但没 有命令和变量前缀（即'NUESTATS：RADIO'）。 2. TX time 和 RX time 在三种情况下会清零，分别是 UE 开机、RRC 去激活、OOS 脱网。 举例 AT+NUESTATS Signal power:-842 Total power:-780 TX power:100 TX time:859 RX time:26543 Cell ID:137262770 ECL:0 SNR:226 EARFCN:3734 PCI:105 RSRQ:-108 OPERATOR MODE:4 CURRENT BAND:8 OK AT+NUESTATS=CELL NUESTATS:CELL,3734,105,1,-842,-108,-780,226 OK AT+NUESTATS=THP NUESTATS:THP,RLC UL,100 NUESTATS:THP,RLC DL,98 NUESTATS:THP,MAC UL,103 NUESTATS:THP,MAC DL,100 OK AT+NUESTATS=BLER NUESTATS:BLER,RLC UL BLER,10 NUESTATS:BLER,RLC DL BLER,5 NUESTATS:BLER,MAC UL BLER,8 上海移远通信技术股份有限公司 76 / 169 NUESTATS:BLER,MAC DL BLER,3 NUESTATS:BLER,Total TX bytes,1080 NUESTATS:BLER,Total RX bytes,900 NUESTATS:BLER,Total TX blocks,80 NUESTATS:BLER,Total RX blocks,80 NUESTATS:BLER,Total RTX blocks,100 NUESTATS:BLER,Total ACK/NACK RX,100 OK BC28-F&BC95-GF AT 命令手册 4.3. AT+NEARFCN 指定搜索频点 该设置命令提供锁定特定 E-UTRAN 绝对射频信道号（EARFCN）机制，若需要，还可锁定物理小区 ID。解除锁定或者 UE 重启之前，所有操作都将锁定到此载波上。若指定 EARFCN 或 PCI 不存在，则 UE 将进入停止服务模式。 AT+NEARFCN 指定搜索频点 设置命令 响应 AT+NEARFCN=,[,] 若出现任何错误： ERROR 或者 测试命令 +CME ERROR: 响应 AT+NEARFCN=? OK 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；参数配置不保存至 NVRAM。 参数 整型。指定搜索类型并定义提供的参数。 0 锁定到指定的 EARFCN 整型。待搜索的 EARFCN。范围：0~65535。 上海移远通信技术股份有限公司 77 / 169 BC28-F&BC95-GF AT 命令手册 整型。E-UTRAN 物理小区 ID。十六进制格式。范围：0~1F7。 错误码。参考第 6 章。 举例 AT+NEARFCN=0,2506,AB OK 4.4. AT+NBAND 设置支持的频段 该命令用于设置待使用的频段。测试命令返回硬件支持的所有频段。 AT+NBAND 设置支持的频段 设置命令 响应 AT+NBAND=[,[,[…]]] OK 查询命令 AT+NBAND? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NBAND:[,[,[…]]] OK 测试命令 AT+NBAND=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NBAND:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 25 秒 该命令立即生效。 深休眠唤醒后仍有效；参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 78 / 169 BC28-F&BC95-GF AT 命令手册 参数 整型。十进制格式。频段。当前仅支持 B3、B5 和 B8。 错误码。参考第 6 章。 备注 AT+NBAND=必须在 AT+CFUN=0 时执行。 举例 AT+NBAND=? +NBAND:(3,5,8) OK AT+NBAND? +NBAND:5,8,3 OK 4.5. AT+NCONFIG 配置 UE 行为 该命令用于配置某些方面的 UE 行为。它的参数包含一个功能和一个控制该功能操作的值。 AT+NCONFIG 配置 UE 行为 设置命令 响应 AT+NCONFIG=, OK 查询命令 AT+NCONFIG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCONFIG:, [+NCONFIG:,] […] OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 79 / 169 BC28-F&BC95-GF AT 命令手册 测试命令 AT+NCONFIG=? 最大响应时间 特性说明 +CME ERROR: 响应 +NCONFIG:(,(支持的列表)) [+NCONFIG:(,(支持的范围))] […] OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效，参数配置自动保存 NVRAM。 参数 字符串型。待配置的 UE 功能。 AUTOCONNECT CELL_RESELECTION ENABLE_BIP MULTITONE CELL_RESELECTION NAS_SIM_POWER_SAVING_ENABLE RELEASE_VERSION IPV6_GET_PREFIX_TIME NB_CATEGORY RAI HEAD_COMPRESS CONNECTION_REESTABLISHMENT TWO_HARQ PCO_IE_TYPE T3324_T3412_EXT_CHANGE_REPORT UE 开机或重启后是否自动尝试连接网络。若 启用自动连接功能，将设置 AT+CFUN=1 并 从 USIM 中读取 PLMN，并使用网提供的 APN。 是否重选小区。 启用/禁用 BIP。 多子载波 小区重选 USIM 卡省电模式。 发布版本。仅支持版本 R13 和 R14。当 UE 使 用 功 率 等 级 6 时 应 不 能 设 置 为 13 。 设置获取 IPv6 前缀的最长时间。范围： 0~65535。单位：秒。0 表示立即获取 IPv6 前缀，65535 表示不获取 IPv6 前缀。 配置 NB-IoT 类别。目前只支持 1 和 2。 启用/禁用 RAI。 头压缩。 重建连接。 双 HARQ PCO 类型。请求 PCO 和 EPCO。 启用/禁用当和/或 的 NAS 计时器更改时， AT+CEREG=5 的 URC 显示。 上海移远通信技术股份有限公司 80 / 169 BC28-F&BC95-GF AT 命令手册 NON_IP_NO_SMS_ENABLE 'True'表示 为 Non-IP 时，不 支持 SMS。 SUPPORT_SMS 启用/禁用 SMS。 HPPLMN_SEARCH_ENABLE 启用/禁用 HPPLMN 搜索。 配置指定 UE 功能。与 对应的值如下： AUTOCONNECT True 上电开机后自动触发注册 False 上电开机后需要执行 AT+CGA TT=1 触发触发 CELL_RESELECTION True 使能小区重选 False 禁止小区重选 ENABLE_BIP True 使能 BIP False 禁用 BIP MULTITONE True 使能多 Tone 功能 NAS_SIM_POWER_SAVING_ENABLE False True 禁用能多 Tone 功能 使能 SIM 节能 False 禁用 SIM 节能，SIM 卡不会休 眠 RELEASE_VERSION 13 版本 13 14 版本 14，此时支持会 R14 的一 些特性，并使能 Cat NB2 IPV6_GET_PREFIX_TIME 0~65534 65535 指定获取 IPv6 前缀的时延 不获取 IPv6 前缀。 整型。范围：0~65535；单位 秒；默认值：15。 NB_CATEGORY 1 NB-Catgory 1 2 NB-Catgory 2，仅在 R14 下支 持 RAI True 支持 R14 RAI,需要 CNMPSD False 不支持 R14 RAI HEAD_COMPRESS True 使能头压缩 False 禁用头压缩 CONNECTION_REESTABLISHMENT True 使能 RRC 重建 False 禁用 RRC 重建 TWO_HARQ True 使能 2-HARQ,该特性在 R14 环 境下会提升峰值速率 False 禁用 2-HARQ，如果使能该特 性，在 R14 环境下会提升峰值 速率 PCO_IE_TYPE PCO 使用 PCO 模式 EPCO 使用 EPCO 模式 T3324_T3412_EXT_CHANGE_REPORT True 使能相关时间改变报告 NON_IP_NO_SMS_ENABLE False True 禁用相关时间改变报告 为 Non-IP 时， 上海移远通信技术股份有限公司 81 / 169 BC28-F&BC95-GF AT 命令手册 SUPPORT_SMS HPPLMN_SEARCH_ENABLE 错误码。参考第 6 章。 True False True False 不支持 SMS。 支持短信功能 不支持短信功能 使能 HPPLMN 搜索 去使能 HPPLMN 搜索 备注 只 有 AT+CFUN=0 时 ， 才 能 设 置 MULTITONE 、 NAS_SIM_POWER_SAVING_ENABLE 、 RELEASE_VERSION 、 SYNC_TIME_PERIOD 、 NB_CATEGORY 、 RAI 、 HEAD_COMPRESS 、 TWO_HARQ、PCO_IE_TYPE、HPPLMN_SEARCH_ENABLE 和 SUPPORT_SMS。 举例 AT+NCONFIG=? +NCONFIG:(AUTOCONNECT,(FALSE,TRUE)) +NCONFIG:(CELL_RESELECTION,(FALSE,TRUE)) +NCONFIG:(ENABLE_BIP,(FALSE,TRUE)) +NCONFIG:(MULTITONE,(FALSE,TRUE)) +NCONFIG:(NAS_SIM_POWER_SAVING_ENABLE,(FALSE,TRUE)) +NCONFIG:(RELEASE_VERSION,(13,14)) +NCONFIG:(IPV6_GET_PREFIX_TIME,(0-65535)) +NCONFIG:(NB_CATEGORY,(1,2)) +NCONFIG:(RAI,(FALSE,TRUE)) +NCONFIG:(HEAD_COMPRESS,(FALSE,TRUE)) +NCONFIG:(CONNECTION_REESTABLISHMENT,(FALSE,TRUE)) +NCONFIG:(TWO_HARQ,(FALSE,TRUE)) +NCONFIG:(PCO_IE_TYPE,(PCO,EPCO)) +NCONFIG:(T3324_T3412_EXT_CHANGE_REPORT,(FALSE,TRUE)) +NCONFIG:(NON_IP_NO_SMS_ENABLE,(FALSE,TRUE)) +NCONFIG:(SUPPORT_SMS,(FALSE,TRUE)) +NCONFIG:(HPPLMN_SEARCH_ENABLE,(FALSE,TRUE)) OK 4.6. AT+NCCID 识别 USIM 卡 该执行和查询命令均可从 USIM 卡中读取 ICCID。若无 USIM 卡或者 USIM 卡不可读，则执行该命令 后会报错且不会返回任何 USIM 卡数据。 上海移远通信技术股份有限公司 82 / 169 BC28-F&BC95-GF AT 命令手册 AT+NCCID 识别 USIM 卡 执行命令 AT+NCCID 查询命令 AT+NCCID? 测试命令 AT+NCCID=? 最大响应时间 特性说明 响应 +NCCID: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCCID: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 / 参数 字符串型。USIM 卡识别码。 错误码。参考第 6 章。 举例 AT+NCCID +NCCID:44123456789012345678 OK AT+NCCID? +NCCID:44123456789012345678 OK 上海移远通信技术股份有限公司 83 / 169 BC28-F&BC95-GF AT 命令手册 4.7. AT+NPOWERCLASS 设置频段和功率等级的映射 该命令用于设置频段和功率等级的映射。该查询命令返回频段和功率等级的所有映射。 AT+NPOWERCLASS 设置频段和功率等级的映射 设置命令 响应 AT+NPOWERCLASS=, OK 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+NPOWERCLASS? +NPOWERCLASS:, […] OK 测试命令 AT+NPOWERCLASS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPOWERCLASS:(支持的列表),(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；参数配置自动保存到 NVRAM。 参数 整型。频段，作为映射的关键。 整型。频段的功率等级。当前仅支持级别 3、5 和 6；单位：dBm。只有当无线处于 非活动状态时（AT+CFUN=0 将强制模块进入非活动状态）才能设置该参数。 功率等级 3 5 6 上海移远通信技术股份有限公司 84 / 169 BC28-F&BC95-GF AT 命令手册 最大发射功率 23 20 14 错误码。参考第 6 章。 备注 1. 仅当 AT+NCONFIG 中=RELEASE_VERSION，且设置为 14 时，方可被设 置为 6。 2. 不允许 Power Class 6 与 Power Class 3 或 Power Class 5 混合设置。 4.8. AT+NPSMR 省电模式状态上报 设 置 命 令 用 于 控 制 URC +NPSMR 的 显 示 。 若 =1 ， 功 率 模 式 发 生 改 变 时 ， 则 上 报 URC +NPSMR:。 查询命令返回当前配置。若=0，返回+NPSMR:；若=1，返回+NPSMR:,。 AT+NPSMR 省电模式状态上报 设置命令 响应 AT+NPSMR= OK 查询命令 AT+NPSMR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPSMR:[,] OK 测试命令 AT+NPSMR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPSMR:(支持的列表) OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 85 / 169 BC28-F&BC95-GF AT 命令手册 最大响应时间 特性说明 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存至 NVRAM。 参数 整型。启用/禁用 URC。 0 禁用 URC 1 启用 URC +NPSMR: 整型。UE 的功率模式。 0 正常模式 1 省电模式 错误码。参考第 6 章。 4.9. AT+NPTWEDRXS 设置 PTW 和 eDRX 设置命令用于控制 UE 是否应用 PTW 和 eDRX，以及各指定接入技术类型请求的 PTW 和 eDRX 值。 当=2 并且网络提供的 PTW 和 eDRX 参数发生变化时，设置命令还用于控制相关 URC 的显示。 AT+NPTWEDRXS=3 为该命令的特殊形式。在此特殊形式中，将禁用 PTW 和 eDRX，并且命令中所 有参数的数据将被删除。 查询命令返回的当前设置。 测试命令以复合值的形式返回支持的和访问技术的取值范围以及请求的 PTW 和请求的 eDRX 值。 AT+NPTWEDRXS 设置 PTW 和 eDRX 设置命令 响应 AT+NPTWEDRXS=,[,[,]] OK 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+NPTWEDRXS? +NPTWEDRXS:,,[,[,]] OK 若出现任何错误： ERROR 或者 +CME ERROR: +NPTWEDRXS:(支持的列表),(支持的列 表),(支持的范围),(支 持的范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。启用或禁用 UE 中请求的 PTW 和 eDRX。该参数适用于所有指定类型的接入技术， 即 的最新设置将对所有指定的 值生效。当设置为 0 并 且没有或时，则会 将省略值设置为无效值，如 0x00。 0 禁用请求的 PTW 和 eDRX 1 启用请求的 PTW 和 eDRX 2 启用请求的 PTW 和 eDRX，并且启用 URC： +NPTWEDRXP:[,[,[,[,]]]] 3 禁用 eDRX 并移除 eDRX 的所有参数。 整型。接入技术的类型。该参数用于指定接入技术类型与请求的 eDRX 值之间的关系。 5 E-UTRAN（NB-S1 模式） 字符串型。请求的 PTW 周期值。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 PTW 长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 上海移远通信技术股份有限公司 87 / 169 BC28-F&BC95-GF AT 命令手册 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 字符串型。请求的 eDRX 周期值。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN DRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 PTW 长度 上海移远通信技术股份有限公司 88 / 169 BC28-F&BC95-GF AT 命令手册 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 错误码。参考第 6 章。 4.10. AT+NPIN PIN 管理 该设置命令用于验证、更改、启用、禁用或解锁 PIN。执行完 PIN 命令后，将收到 URC。 USIM PIN 和 USIM PUK 是指 UICC 上所选应用程序的 PIN。例如，在 E-UTRAN 上下文中，当前选定 UICC 上的所选应用程序应为 USIM，而 USIM PIN 则表示所选 USIM 的 PIN。有关 UICC 应用选择的更多 详细信息，请参考 3GPP TS 31.101。 AT+NPIN PIN 管理 设置命令 响应 AT+NPIN=, OK [,] +NPIN: 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 保存机制与(U)SIM 有关；参数配置不保存至 NVRAM。 上海移远通信技术股份有限公司 89 / 169 BC28-F&BC95-GF AT 命令手册 参数 ,, 整型。PIN 操作模式。 PIN 操作模式 0 验证 PIN 码 1 更改 PIN 码 2 启用 PIN 码 3 禁用 PIN 码 4 解锁 PIN 码 参数随 的设置而变化。 当为 0、2 和 3 时，该参数为 。 当为 1 时，该参数为 。 当为 4 时，该参数为 。 参数随的设置而变化。 当为 0、2 和 3 时，参数被省略。 当为 1 时，该参数为。 当为 4 时，该参数为。 字符串型。十进制格式。应与来自 MT 用户接口设备指定密码或 者 AT+NPIN=1,,相同。为设备指定的密码 相同。是新密码。最小长度：4；最大长度：8；单位：字节。 字符串型。十进制格式。字符串长度：8；单位：字节。 字符串型。结果。 OK ERROR PIN disabled ERROR PIN blocked ERROR wrong PIN ERROR wrong format ERROR 整型。十进制格式。剩余的 PIN 重试次数。如果无剩余重试次数，则 PIN 被锁定。再次使用 PIN 之前，需要输入 AT+NPIN=4,,。 错误码。参考第 6 章。 举例 AT+NPIN=0,29102394 OK +NPIN:OK 4.11. AT+NCSEARFCN 清除存储的频点 该命令用于清除存储的频点。 上海移远通信技术股份有限公司 90 / 169 BC28-F&BC95-GF AT 命令手册 AT+NCSEARFCN 执行命令 AT+NCSEARFCN 清除存储的频点 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 AT+CFUN=0 的模式下配置，切换为 AT+CFUN=1 后生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 错误码。参考第 6 章。 备注 该命令必须在 AT+CFUN=0 的模式下配置，切换为 AT+CFUN=1 后生效。 举例 AT+NCSEARFCN OK 4.12. AT+NITZ 设置时间更新模式 该命令用于设置时间更新模式。查询命令会返回 UE 中的当前时间更新模式。如果由于 UE 发生错误而 导致设置失败，则返回+CME ERROR:。 AT+NITZ 设置时间更新模式 设置命令 响应 AT+NITZ= OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 91 / 169 查询命令 AT+NITZ? 测试命令 AT+NITZ=? 最大响应时间 特性说明 参数 举例 AT+NITZ=1 OK AT+NITZ? +NITZ:1 OK AT+NITZ=? +NITZ:(0,1) OK BC28-F&BC95-GF AT 命令手册 响应 +NITZ: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NITZ:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存至 NVRAM。 整型。时间更新模式。 0 通过本地时间更新时间 1 通过 NITZ 更新时间 错误码。参考第 6 章。 上海移远通信技术股份有限公司 92 / 169 BC28-F&BC95-GF AT 命令手册 4.13. AT+NLOGLEVEL 设置日志级别 该命令用于设置日志级别。 AT+NLOGLEVEL 设置日志级别 设置命令 AT+NLOGLEVEL=, 查询命令 AT+NLOGLEVEL? 测试命令 AT+NLOGLEVEL=? 最大响应时间 特性说明 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NLOGLEVEL:, OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NLOGLEVEL:(支持的列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；参数配置保存至 NVRAM。 参数 字符串型。请求的核。 APPLICATION 字符串型。需要的日志级别。 VERBOSE NORMAL WARNING 上海移远通信技术股份有限公司 93 / 169 BC28-F&BC95-GF AT 命令手册 ERROR NONE 错误码。参考第 6 章。 举例 AT+NLOGLEVEL=? +NLOGLEVEL:(APPLICATION),(VERBOSE,NORMAL,WARNING,ERROR,NONE) OK AT+NLOGLEVEL? +NLOGLEVEL:APPLICATION,VERBOSE OK 4.14. AT+QPLMNS 触发 PLMN 搜索 设置命令用于当 UE 处于无服务状态时触发 PLMN 搜索；若 UE 处于服务状态，执行该命令后返回 +CME ERROR: 。 查询命令返回当前 PLMN 搜索状态，及 PLMN 搜索定时器的重置时间。 AT+QPLMNS 触发 PLMN 搜索 测试命令 响应 AT+QPLMNS=? OK 查询命令 AT+QPLMNS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QPLMNS:[,] OK 执行命令 AT+QPLMNS 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： 上海移远通信技术股份有限公司 94 / 169 最大响应时间 特性说明 BC28-F&BC95-GF AT 命令手册 ERROR 或者 +CME ERROR: 5秒 / 参数 整型。NAS 层 PLMN 的状态。 0 未激活，未进行 PLMN 搜索 1 搜索中，正在进行 PLMN 搜索 2 已选定，已搜索到 PLMN 3 处于 OOS 状态，UE 处于无服务状态并启动 PLMN 搜索定时器 整型。OOS PLMN 定时器剩余时间。单位：秒。仅当=3 时有效。 错误码。参考第 6 章。 4.15. AT+QNBIOTRAI 设置 NB-IoT 释放辅助指示 该命令用于设置 NB-IoT 释放辅助指示。若=1，UE 将发送 RAI 标识并携带 1 字节的数据 至网络。 AT+QNBIOTRAI 设置 NB-IoT 释放辅助指示 测试命令 AT+QNBIOTRAI=? 响应 +QNBIOTRAI:(支持的列表) 设置命令 AT+QNBIOTRAI= OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 95 / 169 参数 BC28-F&BC95-GF AT 命令手册 整型。释放辅助指示信息。 0 无可用信息（或不采用其他选项） 1 TE 将仅发送 1 个上行数据包，无下行数据包 错误码。参考第 6 章。 4.16. AT+QCFG 配置系统功能参数 该命令用于配置系统的功能参数。 AT+QCFG 配置系统功能参数 测试命令 AT+QCFG=? 响应 +QCFG: 'epco',(支持的列表) +QCFG: 'NcellMeas',(支持的列表) +QCFG: 'rohc',(支持的列表) +QCFG: 'DataInactTimer',(支持的列表) +QCFG: 'OOSScheme',(支持的范围) +QCFG: 'logbaudrate',(支持的范围) +QCFG: 'slplocktimes',(支持的范围) +QCFG: 'faultaction',(支持的列表) +QCFG: 'Sib14Acc',(支持的列表) OK 查询命令 AT+QCFG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QCFG: 'epco', +QCFG: 'NcellMeas', +QCFG: 'rohc', +QCFG: 'DataInactTimer', +QCFG: 'OOSScheme', +QCFG: 'logbaudrate', +QCFG: 'slplocktimes', +QCFG: 'faultaction', +QCFG: 'Sib14Acc ', OK 上海移远通信技术股份有限公司 96 / 169 BC28-F&BC95-GF AT 命令手册 设置命令 配置/查询是否启用 EPCO AT+QCFG='epco'[,] 设置命令 配置/查询是否开启 APN 自动激活 AT+QCFG='NcellMeas'[,] 设置命令 配置/查询是否支持 ROHC AT+QCFG='rohc'[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: 'epco', OK 若指定可选参数，则配置是否启用 EPCO： OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: 'NcellMeas', OK 若指定可选参数，则配置是否开启邻区测量： OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: 'rohc', OK 若指定可选参数，则配置是否支持 ROHC： OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 97 / 169 BC28-F&BC95-GF AT 命令手册 +CME ERROR: 设置命令 配置/查询 UE 侧去激活定时器的值 AT+QCFG='DataInactTimer'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'DataInactTimer', OK 若指定可选参数，则配置 UE 侧去激活定时器的值： OK 设置命令 配置/查询 OOS 状态下的搜网间隔 AT+QCFG='OOSScheme'[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: 'OOSScheme', OK 若指定可选参数，则配置 OOS 状态下的搜网间隔： OK 设置命令 配置/查询抓取日志的波特率 AT+QCFG='logbaudrate'[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: 'logbaudrate', OK 若指定可选参数，则配置抓取日志的波特率： OK 设置命令 配置/查询锁休眠持续时间 AT+QCFG='slplocktimes'[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: 'slplocktimes', 上海移远通信技术股份有限公司 98 / 169 BC28-F&BC95-GF AT 命令手册 设置命令 配置/查询配置 faultaction 行为模式 AT+QCFG='faultaction'[,] 设置命令 配置/查询配置 Sib14Acc 行为模式 AT+QCFG=' Sib14Acc '[,] 最大响应时间 特性说明 OK 若指定可选参数，则配置锁休眠持续时间： OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: ' faultaction ', OK 若指定可选参数，则配置 faultaction 行为： OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: ' Sib14Acc ', OK 若指定可选参数，则配置 Sib14Acc 行为： OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 AT+QCFG='faultaction'立即生效，其余重启生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 99 / 169 参数 BC28-F&BC95-GF AT 命令手册 字符串型。可配置的功能项。 'epco' 配置扩展协议配置项 'NcellMeas' 配置是否开启邻区测量 'rohc' 配置是否支持 ROHC 'DataInactTimer' 设置 UE 侧去激活定时器的值，单位：秒 'OOSScheme' 配置 OOS 状态下的搜网间隔 'logbaudrate' 配置抓取日志的波特率 'slplocktimes' 配置锁休眠持续时间 'faultaction' 配置 hardfault 行为模式 'Sib14Acc' 配置被 SIB14 禁止接入后是否仍允许立即接入 整型。功能的配置值 描述 'epco' 0 禁用 EPCO，即使用 PCO 1 使能 EPCO 'NcellMeas' 0 关闭邻区测量 1 打开邻区测量 'rohc' 0 不支持 ROHC 1 支持 ROHC 'DataInactTimer' 0 去激活定时器无效。范围：15~255，默认值：60； 单位：秒 'OOSScheme' 0 OOS 状态下 PLMN 搜索间隔为 30 秒、1 分钟和 2 分钟 1 OOS 状态下 PLMN 搜索间隔为 5 分钟、10 分钟和 15 分钟 2 OOS 状态下 PLMN 搜索间隔为 10 分钟、30 分钟 和 60 分钟 3 在 30 秒后进行一次搜网，之后停止搜网。直到 AT+QPLMNS 重新触发搜网 'logbaudrate' 921600~6000000 抓取日志的波特率 'slplocktimes' 0~30 锁休眠持续时间。默认值：0；单位：秒 'faultaction' 0 将完整的异常信息转储到 Flash 和 EPAT 工具中， 然后陷入无限循环 1 打印必要的异常信息然后重置模块 2 转储完整的异常信息到 Flash 然后重置模块 3 将完整的异常信息转储到 Flash 和 EPAT 工具中， 然后重置模块 4 直接重置模块。建议在批量生产阶段将此值设置为 该值 'Sib14Acc' 0 被 SIB14 禁止接入后不允许立即接入 1 被 SIB14 禁止接入后允许立即接入 错误码。参考第 6 章。 上海移远通信技术股份有限公司 100 / 169 BC28-F&BC95-GF AT 命令手册 备注 1. ='DataInactTimer'只能在 AT+CFUN=0 时设置。 2. 该命令部分参数在不同的模块软件版本中默认值可能有所不同，使用该命令时，需要检查下当前设置 值。 4.17. AT+CTZR 设置时区上报 该设置命令控制时区变化事件上报。启用上报后，一旦时区发生改变，UE 将返回 URC +CTZV:、 +CTZE:,,[]或+CTZEU:,,[]。如果网络提供时区，则 UE 会在网络注册 时提供时区。若因 UE 错误导致设置失败，则返回+CME ERROR:。 查询命令返回 UE 当前已设置的报告设置。 AT+CTZR 设置时区上报 测试命令 AT+CTZR=? 响应 +CZTR:(支持的范围) OK 设置命令 AT+CTZR= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 查询命令 AT+CTZR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CTZR: OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 101 / 169 BC28-F&BC95-GF AT 命令手册 最大响应时间 特性说明 参数 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存至 NVRAM。 整型。是否启用 URC 上报以及可启用上报的 URC 类型。 0 禁用时区变化事件 URC 上报 1 启用时区变化通过 URC +CTZV:上报 2 启用扩展时区和本地时间通过 URC +CTZE:,,[]上报 3 启用扩展时区和世界时通过 URC +CTZEU:,,[]上报 字符串型。本地时区（当地时间与 GMT 的时差以 15 分钟为单位）加上夏令时的总 和。格式为'±zz'，长度固定，即两位整数，范围：-48 ~ +56。为保持两位，范 围在-9 ~ +9 之间的数字均以 0 开头，例如'-09'、'+00'和'+09'。 整型。是否包含夏令时调整。 0 不包含夏令时调整 1 包括增加 1 小时（相当于中的 4 个 15 分钟）的夏令时调整 2 包括增加 2 小时（相当于中的 8 个 15 分钟）的夏令时调整 字符串型。当地时间。格式为'YYYY/MM/DD,hh:mm:ss'，以整数形式分别表示年 （YYYY）、月（MM）、日（DD）、时（hh）、分（mm）和秒（ss）。如果核 心网提供世界时间，UE 可从网络传输时区信息时提供的信息中得出本地时间，并 以 URC 上报扩展时区和本地时间。 字符串型。世界时间。格式为 YYYY/MM/DD,hh:mm:ss，以整数形式分别表示年 （YYYY）、月（MM）、日（DD）、时（hh）、分（mm）和秒（ss）。如果核 心网提供世界时间，在网络传输时区信息时可得到世界时间，并以 URC 上报扩展 时区和世界时间。 错误码。参考第 6 章。 举例 AT+CTZR=0 OK AT+CTZR? +CTZR:0 OK AT+CTZR=? +CTZR:(0,1,2,3) OK 上海移远通信技术股份有限公司 102 / 169 BC28-F&BC95-GF AT 命令手册 4.18. AT+NIPINFO 上报 IP 地址信息 该命令用于设置是否启用 URC 上报 IP 地址信息。 如果成功获取 IP 地址，将不会上报，URC 以+NIPINFO:,, 的格式上报。 如果获取 IP 地址失败，将不会上报，URC 以+NIPINFO:,, 的格式上报。 查询命令返回当前设置。 AT+NIPINFO 上报 IP 地址信息 测试命令 AT+NIPINFO=? 响应 +NIPINFO:(支持的列表) OK 设置命令 AT+NIPINFO= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 查询命令 AT+NIPINFO? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NIPINFO: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存至 NVRAM。 上海移远通信技术股份有限公司 103 / 169 BC28-F&BC95-GF AT 命令手册 参数 < failure_cause> 整型。是否启用 URC 以上报 IP 地址信息。 0 禁用 URC 1 启用 URC +NIPINFO:,[,][,] 整型。指定 PDP 上下文（请参考 AT+CGDCONT）。 整型。指定 IP 地址的类型。 IP 互联网协议（IETF STD 5 [103]） IPV6 互联网协议，版本 6 IPV4V6 引入虚拟参数以处理双 IP 栈 UE 容量。 字符串型。IP 地址。IPv4 地址为点分十进制，例如：100.1.0.26。IPv6 地址以十六 进制数和冒号表示，例如：108F: 0: 0: 0: 8: 800: 200C: 417A。当地址获取失败时， 该参数不显示。 整型。获取 IP 地址失败的原因。 1 仅允许 PDN 类型 IPv4 2 仅允许 PDN 类型 IPv6 3 仅允许单地址承载 4 IPv6 RA 超时 5 未指定 错误码。参考第 6 章。 4.19. AT+QCHIPINFO 读取系统信息 该命令用于返回系统信息，包括温度和电池电压。 AT+QCHIPINFO 读取系统信息 测试命令 AT+QCHIPINFO=? 响应 +QCHIPINFO:(支持的列表) OK 设置命令 AT+QCHIPINFO= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QCHIPINFO:, [+QCHIPINFO:,] OK 上海移远通信技术股份有限公司 104 / 169 BC28-F&BC95-GF AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 字符串型。待读取的系统信息。 ALL 返回所有数据 TEMP 温度 VBAT 电池电压。单位：mV 整型。对应的值。 错误码。参考第 6 章。 举例 AT+QCHIPINFO=ALL +QCHIPINFO:TEMP,34.6 +QCHIPINFO:VBAT,3604 OK AT+QCHIPINFO=? +QCHIPINFO:(ALL,TEMP,VBAT) OK 4.20. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置和查询 DNS 服务器地址。查询命令返回当前使用的 DNS 服务器地址。 AT+QIDNSCFG 配置 DNS 服务器地址 设置命令 响应 AT+QIDNSCFG=[,] OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 105 / 169 BC28-F&BC95-GF AT 命令手册 查询命令 AT+QIDNSCFG? 测试命令 AT+QIDNSCFG=? 最大响应时间 特性说明 或者 +CME ERROR: 响应 PrimaryDns: SecondaryDns: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 5秒 该命令立即生效。 深休眠唤醒后无效；参数配置不保存到 NVRAM。 参数 字符串型。首选域名服务器地址。 字符串型。备用域名服务器地址。若未设置，则查询命令返回 0.0.0.0。 错误码。参考第 6 章。 备注 1. 在执行 AT+QDNS 过程中，不允许配置 DNS 服务器地址。 2. 如果未配置 DNS 服务器地址，则默认将使用网络提供的 DNS 服务器地址或模块预置 DNS 服务器地 址。 举例 AT+QIDNSCFG=? OK AT+QIDNSCFG? PrimaryDns: 114.114.114.114 SecondaryDns: 8.8.8.8 OK AT+QIDNSCFG=8.8.8.8,8.8.4.4 OK 上海移远通信技术股份有限公司 106 / 169 AT+QIDNSCFG? PrimaryDns: 8.8.8.8 SecondaryDns: 8.8.4.4 OK BC28-F&BC95-GF AT 命令手册 4.21. AT+QDNS 触发 DNS 域名解析 该命令用于触发 DNS 域名解析。当域名解析完成后，UE 将显示域名解析的结果：+QDNS:。 如果未返回域名解析结果，再执行该设置命令，则会上报 ERROR。 AT+QDNS 触发 DNS 域名解析 设置命令 响应 AT+QDNS=[,] OK +QDNS: 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 参数 整型。 0 DNS 域名解析，主机名不能为空。 1 如果主机名不为空，则清除内存中的主机名解析数据。如果主机名为空，则将清除 所有解析数据。 2 DNS 域名解析，主机名不能为空。模块不缓存解析结果。 域名。 字符串型。域名解析的结果。域名对应的 IP 地址。若解析失败，返回 FAIL。 错误码。参考第 6 章。 举例 AT+QDNS=0,www.baidu.com OK +QDNS:111.13.100.91 上海移远通信技术股份有限公司 107 / 169 BC28-F&BC95-GF AT 命令手册 4.22. AT+NPING 测试到远程主机的 IP 网络连接 该命令将 ICMP 数据包发送到指定的主机地址。 尝试 PING 操作最多不超过 1 次。如果在设置的超时期限内没有任何数据包收到响应，则将会发生错 误。 如果收到响应，将上报+NPING 消息。如果没有收到响应，将返回带有错误值的 +NPINGERR 主动响 应消息。 AT+NPING 测试到远程主机的 IP 网络连接 设置命令 响应 AT+NPING=[,[,]] +NPING:,, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +NPINGERR: 5秒 / 参数 发送消息的对端地址。点分十进制 IPv4 地址。IP 地址可以用十进制、八进制 或十六进制表示法指定。仅支持 IPv4。 整型。回显数据包有效负载的字节大小。范围：12~1500；默认值：12。 整型。等待回显回复响应的最大时间。范围：10~600000；单位：毫秒；默认 值为 10000。 整型。响应包中收到的 TTL。 整型。从发送包到收到的响应所经过的时间。单位：毫秒。 整型。提供有关 PING 请求失败原因的相关信息。 1 在超时期间远端主机没有响应 2 发送 PING 请求失败 上海移远通信技术股份有限公司 108 / 169 BC28-F&BC95-GF AT 命令手册 4.23. AT+NATSPEED 配置 UART 端口波特率 该命令用于配置 UART 端口波特率。 AT+NATSPEED 配置 UART 端口波特率 测试命令 AT+NATSPEED=? 响应 +NATSPEED:(支持的列表),(支持的 范围),(支持的列表),(支持的范围),(支持 的列表),(支持的范围),(支持的 列表) OK 查询命令 AT+NATSPEED? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NATSPEED:,,,[,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 设置命令 响应 AT+NATSPEED=,,,[,[,[,]]] 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 特性说明 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存到 NVRAM。 上海移远通信技术股份有限公司 109 / 169 参数 BC28-F&BC95-GF AT 命令手册 整型。请求的 UART 端口的波特率。值大于低功耗 UART 所支持的最 快速度时，将禁用深度睡眠的低功耗操作，将返回： +NATSPEED:DISABLE_DEEP_SLEEP。 整型。表示在切换回原来速度之前等待通信的时间。单位：秒。默认值：3。最大值： 30。0 表示使用默认值。 整型。表示是否将和存储到 NVRAM。 0 不存储到 NVRAM，重启后需要重新配置 1 存储到 NVRAM，超时前有交互。 整型。LP UART 同步到它检测到的每个起始位，并使用它为数据中的每个后续位配 置其最佳采样点。如果需要，'同步模式'字段允许修改此采样点。当 为 2400 bps、4800 bps 和 57600 bps 时，不支持 3。 该参数可能在以后的版本中删除。 0 正常采样 1 稍后采样 2 提前采样 3 更早采样 整型。LP UART 停止位。 1 1 个停止位 2 2 个停止位 整型。AT UART 奇偶校验。 0 未启用奇偶校验 1 奇校验 2 偶校验 AT UART 软件（XON/XOFF）流控 0 禁用软件流控 1 启用软件流控 错误码。参考第 6 章。 举例 AT+NATSPEED=9600,3,1,2,1 OK AT+NATSPEED? +NATSPEED:9600,2,1,0,0 OK AT+NATSPEED=? +NATSPEED:(2400,4800,9600,57600,115200,230400,460800),(0-30),(0,1),(0-3),(1-2),(0-2),(0,1) OK 上海移远通信技术股份有限公司 110 / 169 BC28-F&BC95-GF AT 命令手册 备注 、、、当前不生效。 4.24. AT+NUICC 设置 UICC 功耗模式 该命令用于打开/关闭 UICC。仅当 AT+NCONFIG 的配置项 NAS_SIM_POWER_SAVING_ENABLE 为真时才可使用，使用 AT+CSIM 和 AT+CRSM 时会用到该功能。使用该命令可能会影响开机时的功耗。 如果设置失败，则返回+CME ERROR: 。 AT+NUICC 设置 UICC 功耗模式 测试命令 AT+NUICC=? 响应 +NUICC:(支持的列表) OK 设置命令 AT+NUICC= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。UICC 功耗模式。 0 下电 1 上电 错误码。参考第 6 章。 上海移远通信技术股份有限公司 111 / 169 举例 AT+NUICC=1 OK BC28-F&BC95-GF AT 命令手册 4.25. AT+NSOCR 创建 Socket 该命令用于在 UE 上创建一个 Socket，该命令与指定的协议相关。如果端口已设置，使能接收功能， 则对于在该端口上接收的任何消息，将上报 URC +NSONMI。 如果已经为协议或端口的组合创建了 Socket，那么第二次请求 AT+NSOCR 将会失败。 AT+NSOCR 创建 Socket 设置命令 AT+NSOCR=,,[,[,[,]]] 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 字符串型。Socket 类型。 DGRAM UDP STREAM TCP 整型。标准互联网协议。例如，UDP 为 17，TCP 为 6。 整型。范围：0~65535。表示一个包含在发送的消息中的本地端口，并会通过此本 地端口接收消息。如果为 0（在创建 TCP Socket 时），则模块将为此 Socket 分配 一个随机的 。 整型。已创建 Socket 的 ID。范围：0~6。最多支持 7 个 Socket，但其他服务可能 会占用 Socket。 整型。接收控制。 0 忽略传入消息 1 接收传输消息 字符串类型。地址族类型。 上海移远通信技术股份有限公司 112 / 169 BC28-F&BC95-GF AT 命令手册 AF_INET IPv4 AF_INET6 IPv6 IP 地址。网络分配给 UE 的 IP 地址。 错误码。详情参见第 6 章。 备注 1. 最大支持 7 个 Socket，但是其他服务，例如 MQTT、CoAP 等，也许会减少 Socket 的最大数量。 2. 参数 中，端口 56830、42950 和 43950 为预留端口，不建议使用。 3. 目前仅支持一条 TCP 链路进入省电模式，多条 TCP 链路同时存在时，模块将无法进入省电模式。 举例 AT+NSOCR=DGRAM,17,4587,1,AF_INET 1 OK 4.26. AT+NSOST 发送消息（仅限 UDP） 该命令用于将包含长度字节数据的 UDP 数据报发送到 上的 ，并返 回发送的 Socket 以及发送的数据字节数。如果数据量大于允许发送的最大数据长度，仅指示成功发送的数 据长度。 AT+NSOST 发送消息（仅限 UDP） 设置命令 响应 AT+NSOST=,<remote_add , r>,,,[,< sequence>] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 上海移远通信技术股份有限公司 113 / 169 BC28-F&BC95-GF AT 命令手册 字符串型。点分十进制 IPv4 地址。支持十进制、八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：1~65535。 整型。要发送消息数据的长度。单位：字节。最大长度为 1358 字节，实际取决于 网络下发的 MTU 值。 字符串型。要发送的数据。十六进制格式。 整型。数据的序列。范围：1~255。若省略，则不会上报数据发送状态。若指定， 当数据成功发送到 NB-IoT 栈或被丢弃时，将上报以下 URC： +NSOSTR:,, 整型。数据报状态。 0 错误 1 已发送 整型。错误码。详情参见第 6 章。 备注 在数据成功发送到 NB-IoT 栈或被丢弃之前，不能使用相同的 ，否则将返回 ERROR。 举例 AT+NSOST=1,192.158.5.1,1024,2,AB30,1 1,2 OK 4.27. AT+NSOSTEX 发送消息（仅限 UDP） 该命令用于将包含数据长度字节的 UDP 数据报发送到指定的 上的 ， 并返回发送的 Socket 以及发送的数据字节数。如果数据量大于允许发送的最大数据长度，仅指示成功发送 的数据长度。 AT+NSOSTEX 发送消息（仅限 UDP） 设置命令 命令模式下发送数据： AT+NSOSTEX=,,,,, 响应 , OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 114 / 169 BC28-F&BC95-GF AT 命令手册 设置命令 数据模式下发送不定长数据： AT+NSOSTEX=,,, 响应 > 响应 > 之后，输入需要发送的数据，按'Ctrl'+'Z' 发送数据；按'Esc'取消发送操作。 , OK 设置命令 数据模式下发送定长数据 AT+NSOSTEX=,,,, 若出现任何错误： ERROR 或者 +CME ERROR: 响应 > 响应 > 之后，输入需要发送的数据，当长度达到指定 的时，自动发送。 , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 字符串型。点分十进制 IPv4 地址。支持十进制、八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：1~65535。 整型。要发送数据的长度。单位：字节。最大长度为 1358 字节，实际取决于网络 下发的 MTU 值。 字符串型。要发送的数据。十六进制格式。 整型。数据的序列。范围：0~255。如果为 0，则不会上报数据发送状态。如果为 非 0 值，当数据成功发送到 NB-IoT 栈或被丢弃时，将上报以下 URC： +NSOSTR:,, 整型。数据报状态。 0 错误 1 已发送 错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 115 / 169 BC28-F&BC95-GF AT 命令手册 备注 1. 在数据成功发送到 NB-IoT 栈或被丢弃之前，不能使用相同的 ，否则将返回 ERROR。 2. 在数据模式下，为的字符长度。 举例 AT+NSOSTEX=1,192.158.5.1,1024,1,2,AB30 1,2 OK AT+NSOSTEX=1,192.158.5.1,1024,1,4 >AB30 1,4 OK AT+NSOSTEX=1,192.158.5.1,1024,1 >AB30 1,4 OK 4.28. AT+NSOSTF 发送带标志的消息（仅限 UDP） 该命令用于将包含长度字节数据的 UDP 数据报发送到 上的 ，允许 设置元数据标志，并将返回发送的 Socket 以及发送的数据字节数。 AT+NSOSTF 发送带标志的消息（仅限 UDP） 设置命令 AT+NSOSTF=,,,,,[,] 响应 , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 116 / 169 BC28-F&BC95-GF AT 命令手册 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 字符串型。点分十进制 IPv4 地址。支持十进制，八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：1~65535。 整型。消息传输类型。此参数的值为十六进制格式，并通过对以下标志中的零个或 多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：表示收到该消息的回复后释放 若不需设置 ，应将值设置为 0。 整型。要发送数据的长度。单位：字节。最大长度为 1358 字节，实际取决于网络 下发的 MTU 值。 字符串型。要发送的数据。十六进制格式。 整型。数据的序列。范围：1~255。若省略，则不会上报数据发送状态。若设置， 当数据成功发送到 NB-IoT 栈或被丢弃时，将上报以下 URC： +NSOSTR:,, 数据报状态。 0 错误 1 已发送 错误码。详情参见第 6 章。 备注 在数据成功发送到 NB-IoT 栈或被丢弃之前，不能使用相同的 ，否则将返回 ERROR。 举例 AT+NSOSTF=1,192.158.5.1,1024,0x100,2,AB30,1 1,2 OK 4.29. AT+NSOSTFEX 发送带标志位的消息（仅限 UDP） 该命令用于将 UDP 数据报发送到指定的 host:port 并允许设置标志位。 它将与发送时所在的 socket 以及发送的数据字节数一起返回。 如果数据量大于可以发送的最大数据包，则 AT+NSOSTFEX 返回值将 指示成功发送了多少数据。 上海移远通信技术股份有限公司 117 / 169 BC28-F&BC95-GF AT 命令手册 AT+NSOSTFEX 发送带标志位的消息（仅限 UDP) 设置命令 命令模式下发送数据： AT+NSOSTEX=,,,,,, 设置命令 数据模式下发送不定长数据： AT+NSOSTFEX=,,,, 响应 , OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 > 响应 > 之后，输入需要发送的数据，按'Ctrl'+'Z' 发送数据；按'Esc'取消发送操作。 , OK 设置命令 数据模式下发送定长数据： AT+NSOSTFEX=,,,,, 若出现任何错误： ERROR 或者 +CME ERROR: 响应 > 响应 > 之后，输入需要发送的数据，当长度达到指定 的时，自动发送。 , OK 最大响应时间 特性说明 若出现任何错误： ERROR Or +CME ERROR: 5秒 / 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 字符串型。点分十进制 IPv4 地址。支持十进制、八进制或十六进制格式。 上海移远通信技术股份有限公司 118 / 169 BC28-F&BC95-GF AT 命令手册 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：1~65535。 整型。指定消息传输类型。此参数的值为十六进制格式，并通过对以下标志中的零 个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：表示收到该消息的回复后释放 若不需设置 ，应将值设置为 0。 整型。数据的序列。范围：0~255。如果为 0，则不会上报数据发送状态。如果为 非 0 值，当数据成功发送到 NB-IoT 栈或被丢弃时，将上报以下 URC： +NSOSTR:,, 整型。要发送数据的长度。单位：字节。最大长度为 1358 字节，实际取决于网络 下发的 MTU 值。 字符串型。要发送的数据。十六进制格式。 整型。数据报状态。 0 错误 1 已发送 错误码。详情参见第 6 章。 备注 1. 在数据成功发送到 NB-IoT 栈或被丢弃之前，不能使用相同的 ，否则将返回 ERROR。 2. 在数据模式下，为的字符长度。 举例 AT+NSOSTFEX=1,192.158.5.1,1024,0x100,1,2,AB30 1,2 OK AT+NSOSTFEX=1,192.158.5.1,1024,0x100,1,4 >AB30 1,4 OK AT+NSOSTFEX=1,192.158.5.1,1024,0x100,1 >AB30 1,4 OK 上海移远通信技术股份有限公司 119 / 169 BC28-F&BC95-GF AT 命令手册 4.30. AT+NQSOS 查询待处理的 Socket 消息清单 UE 可以使用该命令查询待处理上行消息清单。 AT+NQSOS 查询待处理的 Socket 消息清单 设置命令 查询指定 ID 的 Socket 消息清单 AT+NQSOS=[,[,[…]]] 响应 [+NQSOS:,] [+NQSOS:,] […] OK 查询命令 查询已创建的所有 Socket 的消息清单 AT+NQSOS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+NQSOS:,] [+NQSOS:,] […] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 整型。待处理的上行消息序列。范围：1~255。 错误码。详情参见第 6 章。 举例 AT+NQSOS=1,2 +NQSOS:1,2 +NQSOS:2,3 上海移远通信技术股份有限公司 120 / 169 OK AT+NQSOS? +NQSOS:1,2 +NQSOS:2,3 OK BC28-F&BC95-GF AT 命令手册 4.31. AT+NSORF 读取消息 该命令用于接收 Socket（）上的数据，响应中的 是返回的实际字符数。 当数据到达时，模块上报 URC +NSONMI 响应以指示收到消息的 Socket 以及接收数据的实际长度等 信息；AT+NSORF 命令的为请求的数据长度。如果请求的数据长度大于返回数据的实际长 度，则仅提供返回数据的长度，并且剩余长度将返回为 0。如果请求的数据长度小于返回数据的实际长度， 则仅返回请求长度的数据，并指示剩余的字节数。消息完全被读取后，如果有另一条消息需要处理，将发 送新的 +NSONMI 通知。 如果消息的到达速度快于读取的速度，并且内部消息缓冲区已满，则最新消息将被丢弃。 AT+NSORF 读取消息 设置命令 AT+NSORF=, 响应 ,,,,, OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。由+NSONMI URC 返回的 Socket ID。范围：0~6。 返回的最大数据长度。十进制格式。最大请求数据长度为 1358 字节。 发送消息的系统地址。 点分十进制 IPv4 地址，点分十进制。IP 地址可以以十进制，八进制或十六进制表 示。仅支持 IPv4。 上海移远通信技术股份有限公司 121 / 169 BC28-F&BC95-GF AT 命令手册 发送消息的远端端口。范围：0~65535。 返回的数据长度。十进制格式。 未读取的消息剩余数据长度。十进制字格式。 接收的数据，十六进制字符串格式。最大的接收数据长度是 1358 字节。 错误码。详情参见第 6 章。 举例 AT+NSORF=1,10 1,192.168.5.1,1024,2,ABAB,0 OK 4.32. AT+NSOCO 连接命令（仅限 TCP） 该命令将 TCP 服务器连接到指定的主机端口。 AT+NSOCO 连接命令（仅限 TCP） 设置命令 响应 AT+NSOCO=,, 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 / 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 发送消息的系统地址。支持十进制，八进制或十六进制表示。 整型。连接的远端端口。范围：1~65535。支持十进制和十六进制格式。 错误码。详情参见第 6 章。 举例 AT+NSOCO=1,192.158.5.1,1024 OK 上海移远通信技术股份有限公司 122 / 169 BC28-F&BC95-GF AT 命令手册 4.33. AT+NSOSD 发送消息（仅限 TCP） 该命令可以发送 TCP 数据报到 TCP 服务器，会返回发送 Socket 和数据字节数量。AT+NSOSD 的返 回值将返回成功发送的数据长度。 AT+NSOSD 发送数据（仅限 TCP） 设置命令 响应 AT+NSOSD=,,<dat , a>[,[,]] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 整型。发送的数据长度。十进制格式。默认最大长度为 1358 字节，实际取决于网 络下发的 MTU 值。 十六进制字符串格式。要传输的数据。 整型。指定消息传输的类型。此参数的值为十六进制格式，并通过对以下标志中的 零个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：指示收到该条消息的回复后释放 如果不设置 ，则应将值设置为 0。 整型。数据的序列。范围 1~255。若省略，则不会上报数据发送状态；若指定，当 服务器应答数据帧或 UE 丢弃数据帧时，将上报以下结果： +NSOSTR:,, 数据报的状态。 0 错误 1 已发送 错误码。详情参见第 6 章。 举例 AT+NSOSD=1,2,AB30 上海移远通信技术股份有限公司 123 / 169 1,2 OK AT+NSOSD=1,2,AB30,0x100 1,2 OK AT+NSOSD=1,2,AB30,0x100,255 1,2 OK BC28-F&BC95-GF AT 命令手册 4.34. AT+NSOSDEX 发送消息（仅限 TCP） 该命令用于将 TCP 数据报发送到 TCP 服务器。它将返回发送时所用的 socket 以及发送的数据字节数。 如果数据量大于可以发送的最大数据报，则 AT+NSOSDEX 返回值将指示成功发送了多少数据。 如果指定 ，则当服务器请求数据报或 UE 丢弃数据报时，将报告结果。 AT+NSOSDEX 发送消息（仅限 TCP） 设置命令 响应 AT+NSOSDEX=,,,, , OK 设置命令 AT+NSOSDEX=,, 若出现任何错误： ERROR 或者 +CME ERROR: 响应 > 响应 > 之后，输入需要发送的数据，按'Ctrl'+'Z' 发送数据；按'Esc'取消发送操作。 , OK 若出现任何错误 ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 124 / 169 BC28-F&BC95-GF AT 命令手册 设置命令 AT+NSOSDEX=,,, 响应 > 响 应 > 之 后 ， 输 入 需 要 发 送 的 数 据 ， 当 长 度 达 到 自动发送。 , OK 最大响应时间 特性说明 若出现任何错误 ERROR 或者 +CME ERROR: 5秒 / 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 整型。指定消息传输的类型。此参数的值为十六进制格式，并通过对以下标志中的 零个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：指示收到该条消息的回复后释放 如果未设置 ，则应将值设置为 0。 整型。数据的序列。范围：0~255。如果为 0，则不会上报数据发送状态。如果为 非 0 值，当数据成功发送到 NB-IoT 栈或被丢弃时，将上报以下结果： +NSOSTR:,, 整型。表示发送的数据长度。十进制格式。默认最大长度为 1358 字节，实际取决 于网络下发的 MTU 值。 要传输的数据。十六进制字符串格式。 数据报状态。 0 错误 1 已发送 错误码。详情参见第 6 章。 举例 AT+NSOSDEX=1,0x100,1,2,AB30 1,2 OK AT+NSOSDEX=1,0x100,1 上海移远通信技术股份有限公司 125 / 169 >AB30 1,4 OK AT+NSOSDEX=1,0x100,1,4 >AB30 1,4 OK BC28-F&BC95-GF AT 命令手册 4.35. AT+NSOCL 关闭 Socket 该命令用于关闭指定的 Socket。如果有待读取的未处理消息，则会将它们删除。不再打印 +NSONMI 通知。如果已经关闭，或者从未被创建 Socket，该命令会返回错误。 AT+NSOCL 关闭 Socket 设置命令 响应 AT+NSOCL= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 举例 AT+NSOCL=1 OK 整型。AT+NSOCR 返回的 Socket ID。范围：0~6。 错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 126 / 169 BC28-F&BC95-GF AT 命令手册 4.36. AT+NSONMI 指示已到达 Socket 的消息 该命令用于设置 URC +NSONMI 指示已到达 Socket 的消息： 查询命令返回命令的当前设置。 AT+NSONMI 指示已到达的 Socket 消息 设置命令 AT+NSONMI= 响应 OK 查询命令 AT+NSONMI? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSONMI: OK 测试命令 AT+NSONMI=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSONMI:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。配置下行数据 URC 指示。 0 禁用 URC 指示消息。 1 启用 URC，仅指示消息数据长度： +NSONMI:,。 上海移远通信技术股份有限公司 127 / 169 BC28-F&BC95-GF AT 命令手册 2 启用 URC 指示发送消息的系统地址及远程端口、消息长度及数据内容 +NSONMI:,, ,,。 3 启用 URC 指示消息长度及数据内容 +NSONMI:,,. 整型。接收数据的 Socket。十进制格式。范围：0~6。 整型。缓存为空时接收到的第一条消息数据长度。单位：字节。 发送消息的系统地址。 整型。远程端口。范围：0~65535。 十六进制字符串格式。接收到的数据。最大长度为 1358 字节。 错误码。详情参见第 6 章。 举例 AT+NSONMI=1 OK AT+NSONMI? +NSONMI:1 OK AT+NSONMI=? +NSONMI:(0-3) OK 备注 仅在缓存为空时，模块响应一次 URC +NSONMI 以指示接收到新消息；缓存中存在消息时，模块不响应 URC +NSONMI。使用 AT+NSORF 读取所有缓存数据后，将继续返回 URC +NSONMI。 4.37. +NSOCLI 关闭 Socket 指示（仅用于响应） 这是一条 URC，指示所指 Socket 已经被 LwIP 内部关闭。 +NSOCLI 关闭 Socket 指示（仅用于响应） URC 格式： +NSOCLI: 参数 整型。已关闭的 Socket ID。十进制格式。范围：0~6。 上海移远通信技术股份有限公司 128 / 169 备注 此 URC 仅在 TCP 模式下上报。 BC28-F&BC95-GF AT 命令手册 4.38. AT+NSOSTATUS 获取 Socket 状态 设置命令返回指定的 Socket 状态信息，执行命令返回所有 Socket 的状态信息。 AT+NSOSTATUS 获取 Socket 状态 设置命令 响应 AT+NSOSTATUS= +NSOSTATUS:,[] OK 执行命令 AT+NSOSTATUS 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+NSOSTATUS:,[,] [+NSOSTATUS:,[,] [...] OK 测试命令 AT+NSOSTATUS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSOSTATUS:(支持的范围) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 129 / 169 BC28-F&BC95-GF AT 命令手册 参数 整型。由 AT+NSOCR 返回的 Socket ID。范围：0~6。 整型。Socket 状态 0 可用 1 不存在（如果 Socket 未绑定到分配的正确 IP 地址 NW，也会返回此状态） 2 流量控制 3 退避 整型。退避定时器/T3396 定时器剩余时间。仅在退避状态时显示。单位：秒。 整型。错误码。详情参见第 6 章。 备注 如果打开运营商自注册（参考《Quectel_BC28-F&BC95-GF_运营商自注册使用说明》）或中国电信物联网 平台自注册（AT+QREGSWT=1），启动时相关任务将自动创建并占用靠前的空闲 Socket。 举例 AT+NSOSTATUS=1 +NSOSTATUS:1,0 OK AT+NSOSTATUS +NSOSTATUS:0,0 +NSOSTATUS:1,0 +NSOSTATUS:2,1 +NSOSTATUS:3,1 +NSOSTATUS:4,1 +NSOSTATUS:5,1 +NSOSTATUS:6,1 OK AT+NSOSTATUS=? +NSOSTATUS:(0-6) OK 4.39. AT+QLEDMODE 设置 NETLIGHT 功能模式 该命令用于设置 NETLIGHT LED 指示灯的功能模式。 上海移远通信技术股份有限公司 130 / 169 BC28-F&BC95-GF AT 命令手册 AT+QLEDMODE 设置 NETLIGHT 功能模式 设置命令 响应 AT+QLEDMODE= OK 查询命令 AT+QLEDMODE? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLEDMODE: OK 测试命令 AT+QLEDMODE=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLEDMODE:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。NETLIGHT LED 指示灯的功能模式。 0 禁用 NETLIGHT LED 功能，NETLIGHT 引脚输出低电平。 1 启用 NETLIGHT LED 功能，NETLIGHT 引脚输出 PWM 信号。 不同的高电平和低电平持续时间表示不同的网络状态，如下： 搜网状态：高电平 64 ms（灯亮）/ 低电平 800 ms（灯灭）； 连接状态：高电平 64 ms（灯亮）/ 低电平 2000 ms（灯灭） 错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 131 / 169 举例 AT+QLEDMODE=1 OK AT+QLEDMODE? +QLEDMODE:1 OK AT+QLEDMODE=? +QLEDMODE:(0,1) OK BC28-F&BC95-GF AT 命令手册 4.40. AT+QIPERF IPERF 性能测试 该命令用于测试 TCP/IP 的上行和下行性能。 AT+QIPERF 测试命令 AT+QIPERF=? IPERF 性能测试 响应 +QIPERF: ( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围),(支持的 范围),(支持的范围),(支持 的范围) 设置命令 AT+QIPERF=[,[,[,[,[,[,[,[,]]]]]]]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 / 参数 整型。 IPERF 命令 0 终止所有 IPERF 服务 上海移远通信技术股份有限公司 132 / 169 BC28-F&BC95-GF AT 命令手册 1 启动 IPERF Client（客户端） 2 停止 IPERF Client（客户端） 3 启动 IPERF Server（服务器） 4 启动 IPERF UDP NAT Server（服务器） IPERF UDP NAT Server 是一种 IPERF UDP 服务器，在这种模式下，UE 将 发送一个 UDP 数据包到远程服务器以设置 UDP 连接，之后 UE 等待接收下行 UDP 数据包，然后启动下行 UDP IPERF 服务器。 5 停止 IPERF Server（服务器） 整型。协议类型。 0 UDP 1 TCP 整型。UDP/TCP 端口号。默认值：5001。 如果是 1 或 4，则此是目标服务器端口号。 如果为 3，则此是本地 IPERF 服务器端口号。 字符串型。IP 地址。为 1、3 和 4 时不可省略。 如果是 1 或 4，指示目标服务器地址。 如果为 3，并且测试域为 IPv6 域，则必须是 UE 本地 IPv6 地址。 整型。吞吐量（Throughput）。默认值：20000；范围：1~1200000；单位：bps。 整型。上行 UDP/TCP IPERF 数据包的有效负载大小。仅在为 1 时配置。 范围：36~1472，默认值 1350。 整型。客户端模式时，UE 发送的数据包号。范围：0~65000。默认值 0，表示一直 发送数据包。 整型。 IPERF 服务持续时间。单位：秒。如果未指定，则 IPERF 不会在遇到错误 或收到终止命令之前停止。 整型。报告 IPERF 的 URC 的时间间隔。默认值：10；单位：秒。 如果为 1，则 UE 发送 URC +QIPERF:Client SUCC, pkg sent bytes： , UL through put: bps； 如果是 3 或 4，则 UE 发送 URC +QIPERF:Server SUCC, pkg sent bytes：, UL through put: bps 整型。错误码。详细信息，请参考第 6 章。 备注 1. IPERF 客户端服务完成（终止/超时）后，UE 发送 URC： +QIPERF:Client END, pkg sent total bytes: , average UL through put: bps 2. 当 IPERF 服务器服务完成（终止/超时）时，UE 发送 URC： +QIPERF:Server END, pkg recv total bytes: , average DL through put: bps 3. 如果发生导致 IPERF 服务无法继续的错误，则 UE 发送 URC： +QIPERF:Client FAIL, ; or +QIPERF: Server FAIL, 举例 AT+QIPERF=1,0,5001,'180.101.147.115',10000 OK 上海移远通信技术股份有限公司 133 / 169 BC28-F&BC95-GF AT 命令手册 +QIPERF:Client SUCC, pkg sent bytes: 15158, UL through put: 12126 bps +QIPERF:Client SUCC, pkg sent bytes: 12402, UL through put: 9921 bps +QIPERF:Client SUCC, pkg sent bytes: 12402, UL through put: 9921 bps +QIPERF:Client SUCC, pkg sent bytes: 13780, UL through put: 11024 bps +QIPERF:Client SUCC, pkg sent bytes: 12402, UL through put: 9921 bps AT+QIPERF=0 OK +QIPERF:Client END, pkg sent total bytes: 74412, average UL through put: 10263 bps 上海移远通信技术股份有限公司 134 / 169 BC28-F&BC95-GF AT 命令手册 5 LwM2M 物联网平台命令 本章节描述了模块针对 LwM2M 物联网平台的 AT 命令。使用本章 AT 命令可用于对接中国电信 AEP 平台和中国电信 IoT 平台。 5.1. AT+QCFG='LWM2M/Lifetime' 配置 IoT 平台注册生命周期 该命令用于配置 IoT 平台的生命周期值。UE 的更新注册时间约为生命周期的 0.9 倍。 AT+QCFG='LWM2M/Lifetime' 配置 IoT 平台注册生命周期 设置命令 AT+QCFG='LWM2M/Lifetime'[,] 响应 若省略可选参数，则查询平台的生命周期值： +QCFG: 'LWM2M/Lifetime', OK 若指定可选参数，则配置平台的生命周期值： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。LwM2M 协议的生命周期。范围：0~(30×2592000)；默认值：0；单位：秒。 0 禁用生命周期功能。UE 将不会定期向 loT 平台发送更新注册包。 1~(30×2592000) 启用生命周期功能。但即使 UE 将生命周期值设置为 1~899 秒， 的最小有效值仍为 900 秒。 错误码。参考第 6 章。 上海移远通信技术股份有限公司 135 / 169 举例 AT+QCFG='LWM2M/Lifetime' +QCFG: 'LWM2M/Lifetime',0 OK AT+QCFG='LWM2M/Lifetime',864000 OK BC28-F&BC95-GF AT 命令手册 5.2. AT+NCDP 配置和查询 CDP 服务器设置 该命令用于设置和查询 CDP 服务器的 IP 地址和端口号。当网络服务器应用程序网关是 CDP 服务器或 者中国电信 IoT 平台时，可使用该命令。 AT+NCDP 配置和查询 CDP 服务器设置 设置命令 AT+NCDP=[,] 响应 从提供的参数中更新 CDP 服务器配置： OK 查询命令 AT+NCDP? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 返回当前 CDP 服务器 IP 地址和端口号： +NCDP:, OK 最大响应时间 特性说明 若未设置 CDP 服务器： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 字符串型。IoT 平台 IP 地址。支持 IPv4、IPv6 和域名。最大长度：256 字节。 整型。无符号整型。范围：0~65535；默认值：5683。若配置端口为 0，则使用默认端 上海移远通信技术股份有限公司 136 / 169 BC28-F&BC95-GF AT 命令手册 口；若没有指定端口，则使用之前设置的端口；若没有指定端口且之前未设置，则使用 默认端口。 错误码。参考第 6 章。 举例 AT+NCDP=192.168.5.1,5683 OK AT+NCDP? +NCDP:192.168.5.1,5683 OK 5.3. AT+QLWSREGIND 注册控制 该命令用于向 IoT 平台发起注册和注销。若消息未能发送，则返回错误码和描述作为中间消息。 AT+QLWSREGIND 注册控制 设置命令 响应 AT+QLWSREGIND= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。动作类型。 0 触发注册操作 1 触发注销操作 错误码。参考第 6 章。 举例 AT+QLWSREGIND=0 OK 上海移远通信技术股份有限公司 137 / 169 BC28-F&BC95-GF AT 命令手册 5.4. AT+QLWULDATA 发送数据 该命令用于使用 LwM2M 协议向 IoT 平台发送数据。若消息未能发送，则返回错误码及描述作为 中间消息。在模块注册到 IoT 平台之前，执行该命令则会触发注册操作并丢弃数据。 AT+QLWULDATA 发送数据 设置命令 响应 AT+QLWULDATA=,[, OK ] 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 / 参数 整型。表示发送数据的长度。最大值：1024。 字符串型。十六进制格式。单位：字节。 数据序列号。范围：0~255。如果使用非 0 的来发送 CoAP 数据，且 当前有携带相同的 NON 或者 CON 类型 CoAP 数据未发送完成，那么 会将数据丢弃并返回错误。如果参数值为 0，则被忽略。 错误码。参考第 6 章。 举例 AT+QLWULDATA=3,AA34BB OK 5.5. AT+QLWULDATAEX 发送 CON/NON 消息 该命令用于根据 LwM2M 协议使用 RAI 标识符向物联网平台发送需要确认的消息（CON）或者不需要 确认的消息（NON）。发送 CON 数据后，发送结果会自动反馈给 TE，TE 也可以使用 AT+QLWULDATA STATUS?查询已发送 CON 数据的状态。如果发送 CON 数据，它必须在发送下一个 CON 或者 NON 数据 之前获取发送 CON 数据的状态（失败/超时/成功/获得重置消息）。如果模块尚未注册到 NB-IoT 平台，则 该命令将使模块仅启动注册，模块将丢弃发送的数据。 上海移远通信技术股份有限公司 138 / 169 BC28-F&BC95-GF AT 命令手册 AT+QLWULDATAEX 发送 CON/NON 消息 设置命令 响应 AT+QLWULDATAEX=,,[,] 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 / 参数 整型。发送数据的长度。最大值：1024。 字符串型。十六进制格式。单位：字节。 消息发送模式。 0x0000 发送 NON 消息。 0x0001 发送带有 RELEASE 释放辅助提示的 NON 消息。 0x0010 发送带有 RELEASE_AFTER_REPLY 释放辅助提示的 NON 消息。 0x0100 发送 CON 消息。 0x0101 发送带有 RELEASE_AFTER_REPLY 释放辅助提示的 CON 消息。 整型。数据序列号。范围：0~255。如果使用非 0 的发送 CoAP 数据， 且当前有携带相同的 NON 或者 CON 类型 CoAP 数据未发送完成，那么会 将数据丢弃并返回错误。如果参数值为 0，则被忽略。 错误码。参考第 6 章。 举例 AT+QLWULDATAEX=3,AA34BB,0x0001 OK 5.6. AT+QLWULDATASTATUS 查询 CON 消息发送状态 该命令用于查询向 NB-IoT 平台发送 CON 数据的状态。此命令仅查询已发送的 CON 数据的状态。 当发送 CON 类型 CoAP 数据时携带了非 0 的，该命令的响应为：+QLWULDATASTAT US:,；当发送 CON 类型 CoAP 数据时没有携带或者携带的 为 0，该命令的响应为：+QLWULDATASTATUS:。 上海移远通信技术股份有限公司 139 / 169 BC28-F&BC95-GF AT 命令手册 AT+QLWULDATASTATUS 查询命令 AT+QLWULDATASTATUS? 查询 CON 消息发送状态 响应 +QLWULDATASTATUS:[,] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。表示 CON 数据发送状态。 0 未发送 1 已发送，等待 IoT 平台响应 2 发送失败 3 超时 4 成功 5 收到 RESET 消息 数据序列。范围：0~255。若当发送 CON 类型 CoAP 数据时没有携带或 为 0，则被省略。 错误码。参考第 6 章。 举例 AT+QLWULDATASTATUS? +QLWULDATASTATUS:4 OK 5.7. AT+QREGSWT 设置注册模式 该命令用于在重启模块后设置注册模式： ⚫ 若设置为 0，模块在重启并连接到网络后会发送 REGISTERNOTIFY 消息到设备，然后通 过执行命令 AT+QLWSREGIND 触发注册。 上海移远通信技术股份有限公司 140 / 169 BC28-F&BC95-GF AT 命令手册 ⚫ 若设置为 1，模块在重启并连接到网络后会触发自动注册。 ⚫ 若设置为 2，模块在重启并连接到网络后不会触发注册。 AT+QREGSWT 设置注册模式 设置命令 响应 AT+QREGSWT= OK 查询命令 AT+QREGSWT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QREGSWT: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。表示注册模式。 0 手动注册模式 1 自动注册模式 2 禁用注册 错误码。参考第 6 章。 备注 如果不需要使用物联网平台，必须使用命令 AT+QREGSWT=2 禁用注册功能。该命令仅在使用 AT+NRB 重启 UE 后才生效。 举例 AT+QREGSWT=1 OK AT+QREGSWT? 上海移远通信技术股份有限公司 141 / 169 +QREGSWT:1 OK BC28-F&BC95-GF AT 命令手册 5.8. AT+NMGS 发送消息 该命令用于发送数据到 IoT 平台。若消息未能发送，会返回错误码及描述作为中间消息。如果模 块尚未注册到物联网平台，执行该命令将会促使模块发起注册，并丢弃数据。 AT+NMGS 发送消息 设置命令 响应 AT+NMGS=,[,] 如出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 / 参数 消息的长度。十进制。最大值：1024。单位：字节。 待传输的数据。十六进制字符串格式。最大长度为 1024 字节。 数据序列号。范围：0~255。如果使用非 0 的发送 CoAP 数据，且当前有 携带相同的 NON 类型 CoAP 数据未发送完成，那么会将数据丢弃并返回 错误。若为 0 则被忽略。 整型。错误码。参考第 6 章。 举例 AT+NMGS=3,AA11BB OK 5.9. AT+NMGR 接收消息 该命令用于通过 LwM2M 协议从 IoT 平台接收消息。 上海移远通信技术股份有限公司 142 / 169 BC28-F&BC95-GF AT 命令手册 该命令返回最先缓存的消息并将消息从缓存中删除，如果没有缓存的消息，则该命令无响应；如果使 能新消息指示（AT+NNMI），执行该命令将无法获取收到的消息。 AT+NMGR 接收消息 执行命令 AT+NMGR 响应 , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 消息长度。十进制。最大为 1024。单位：字节。 十六进制字符串格式。接收的数据。最大长度为 1024 字节。 整型。错误码。参考第 6 章。 举例 AT+NMGR 5,48656C6C6F OK 5.10. AT+NNMI 设置新消息指示 该命令用来设置或者获取已发送的新消息指示。UE 从 IoT 平台接收到一个下行消息后会发送新消息指 示。 AT+NNMI=1 使能新消息指示和数据，会返回当前所有缓存的消息，格式为+NNMI:,。 例如，+NNMI:5,48656C6C6F。 AT+NNMI=2 仅使能新消息指示，每次收到新的消息都会触发指示 URC，响应结果格式为：+NNMI。 可以通过命令 AT+NMGR 接收缓存消息。 上海移远通信技术股份有限公司 143 / 169 BC28-F&BC95-GF AT 命令手册 默认值为 1，模块重启后会还原到默认值。 AT+NNMI 设置新消息指示 查询命令 AT+NNMI? 响应 +NNMI: OK 设置命令 AT+NNMI= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存到 NVRAM。 参数 整型。新消息指示状态。 0 无指示 1 指示和消息 2 仅指示 整型。消息长度。 十六进制字符串格式。待接收的数据。 错误码。参考第 6 章。 举例 AT+NNMI=1 OK AT+NNMI? +NNMI:1 OK 上海移远通信技术股份有限公司 144 / 169 BC28-F&BC95-GF AT 命令手册 5.11. AT+NSMI 发送消息指示 当发送一条上行消息至 IoT 平台时，使用该命令设置或者获取已发送消息的指示。 如果开启了发送消息指示，当有新消息发送到 NB-IoT 栈时，会返回如下 URC： +NSMI:[,]（例如：+NSMI:SENT）。 只有当发送数据的 AT 命令中包含非 0 参数，模块发送到 MCU 的通知消息中才会包含 ，且该参数值与发送数据的 AT 命令中的一致。 当发送 CoAP 数据的 AT 命令中包含非 0 参数，且 CoAP 数据成功发送到 NB-IoT 平台， 模块发送到 MCU 的通知消息中值为 SENT_TO_AIR_INTERFACE；如果上述的命令中没有 或者值为 0 且 CoAP 数据成功发送到 NB-IoT 平台，模块发送到 MCU 的通知消息 中值为 SENT。 对于 CON 数据来说，SENT 和 SENT_TO_AIR_INTERFACE 说明发送数据到 NB-IoT 平台的结果；对 于 NON 数据来说，SENT 和 SENT_TO_AIR_INTERFACE 说明数据发送到 NB-IoT 栈。 AT+NSMI 发送消息指示 设置命令 响应 AT+NSMI= OK 查询命令 AT+NSMI? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSMI: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存到 NVRAM。 上海移远通信技术股份有限公司 145 / 169 参数 举例 AT+NSMI=1 OK AT+NSMI? +NSMI:1 OK BC28-F&BC95-GF AT 命令手册 整型。是否发送消息指示。 0 不发送指示 1 发送指示 字符串型。数据发送的状态。 SENT 数据发送到 C 核 SENT_TO_AIR_INTERFACE 数据发送到空口 DISCARDED 数据丢弃 整型。数据序列。范围：1~255。表示 AT 命令中携带的非 0 的向 loT 平台发送数据。 错误码。参考第 6 章。 5.12. AT+NQMGR 查询已接收消息状态 该命令用于查询从 IoT 平台已接收下行消息的状态。 AT+NQMGR 查询已接收消息状态 执行命令 响应 AT+NQMGR BUFFERED=,RECEIVED=,DROPPE D= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 146 / 169 参数 整型。下行缓存中等待读取的消息条数。 整型。UE 启动后收到的消息总数。 整型。UE 启动后丢弃的消息条数。 错误码。参考第 6 章。 举例 AT+NQMGR BUFFERED=0,RECEIVED=34,DROPPED=2 OK BC28-F&BC95-GF AT 命令手册 5.13. AT+NQMGS 查询发送的消息状态 该命令用于查询向 IoT 平台发送的上行消息的状态。 AT+NQMGS 执行命令 AT+NQMGS 查询发送的消息状态 响应 PENDING=,SENT=,ERROR= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。上行缓存中等待发送的消息条数。 整型。UE 启动后，发送到 NB-IoT 平台的上行消息总数。 整型。UE 启动后，因错误被丢弃的消息条数。 错误码。参考第 6 章。 上海移远通信技术股份有限公司 147 / 169 BC28-F&BC95-GF AT 命令手册 备注 1. 对于 CON 类型 CoAP 数据，只有当 timeout、RST、sent_fail 或者 sent_success 之后，相应统计值 才会改变； 2. 对于 NON 类型 CoAP 数据，当数据发送到 NB-IoT 栈后，相应统计值才会改变。 举例 AT+NQMGS PENDING=1,SENT=34,ERROR=0 OK 5.14. AT+NMSTATUS 消息注册状态 当模块连接到 CDP 服务器时，该命令用于上报当前注册状态。当 LwM2M 处于 MO_DATA_ENABLED 状态，则 UE 可以发送数据。 AT+NMSTATUS 消息注册状态 查询命令 AT+NMSTATUS? 响应 +NMSTATUS: OK 测试命令 AT+NMSTATUS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 (支持的列表) 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 148 / 169 BC28-F&BC95-GF AT 命令手册 参数 字符串型。当前注册状态。 UNINITIALISED MISSING_CONFIG INIITIALISING INIITIALISED INIT_FAILED REGISTERING REGISTERED DEREGISTERED MO_DATA_ENABLED NO_UE_IP REJECTED_BY_SERVER TIMEOUT_AND_RETRYING REG_FAILED DEREG_FAILED 错误码。参考第 6 章。 未初始化 配置丢失 初始化中 初始化完成 初始化失败 注册中 已注册 已注销 使能数据发送 无UE IP 服务器拒绝 超时并重试 注册失败 注销失败 5.15. AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP 该命令用于设置和删除 Bootstrap 和 IoT 服务器 IP 地址。AT+QLWSERVERIP 和 AT+NCDP 两个命 令适用同一个 NVRAM 项： ⚫ 当 IP 地址和端口与 NVRAM 匹配时，执行 AT+QLWSERVERIP=DEL,,将会删 除 IP 信息； ⚫ 当 IP 地址与 NVRAM 匹配时，执行 AT+QLWSERVERIP=DEL,将会删除 IP 信息。 AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP 设置命令 响应 AT+QLWSERVERIP=,[,] 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+QLWSERVERIP? +QLWSERVERIP:,, […] OK 上海移远通信技术股份有限公司 149 / 169 BC28-F&BC95-GF AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 Bootstrap/LwM2M 服务器 IP 类型。 LWM2M IoT 服务器 IP BS Bootstrap 服务器 IP DEL 删除 IP 信息 字符串型。域名或者 IP 地址。IP 地址格式为点分十进制格式的 IPv4 地址，如： 180.101.147.115。 整型。端口号。范围：0~65535。 错误码。参考第 6 章。 举例 AT+QLWSERVERIP=BS,180.101.147.115,5683 OK AT+QLWSERVERIP=LWM2M,180.101.147.115,5683 OK AT+QLWSERVERIP? +QLWSERVERIP:BS,180.101.147.115,5683 +QLWSERVERIP:LWM2M,180.101.147.115,5683 OK AT+QLWSERVERIP=DEL,180.101.147.115,5683 OK 上海移远通信技术股份有限公司 150 / 169 BC28-F&BC95-GF AT 命令手册 6 错误码 本章介绍与 BC28-F 和 BC95-GF 模块相关的错误码。 下表中列出的错误代码符合 3GPP 规范。客户可以参考 3GPP TS 27.007 V13.5.0, sub-clause 9.2 了 解所有可能的错误码。 表 2：通用错误码 1 2 3 4 5 6 7 10 11 12 13 14 15 16 17 18 错误代码 MT not connection MT link reserved operation not allowed operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy SIM wrong incorrect password SIM PIN2 required SIM PUK2 required 中文解释 MT 未连接 MT 链接保留 不允许操作 不支持操作 需要 PH-SIM PIN 需要 PH-FSIM PIN 需要 PH-FSIM PUK 未插入 SIM 卡 需要 SIM PIN 需要 SIM PUK SIM 卡失败 SIM 卡忙碌 SIM 卡错误 密码不正确 需要 SIM PIN2 需要 SIM PUK2 上海移远通信技术股份有限公司 151 / 169 BC28-F&BC95-GF AT 命令手册 20 memory full 内存已满 21 invalid index 无效索引 22 not found 未发现 23 memory failure 内存不足 24 text string too long 文本字符串过长 25 invalid characters in text string 无效文本字符串 26 dial string too long 拨号字符串过长 27 invalid characters in dial string 无效拨号字符串 30 no network service 无网络服务 31 network timeout 网络超时 32 network not allowed - emergency call only 网络不允许-仅紧急呼叫 40 network personalization PIN required 需要网络个性化 PIN 41 network personalization PUK required 需要网络个性化 PUK 42 network subset personalization PIN 需要网络子集个性化 PIN required 43 network subset personalization PUK 需要网络子集个性化 PUK required 44 service provider personalization PIN 需要服务提供商个性化 PIN required 45 service provider personalization PUK 需要服务提供商个性化 PUK required 46 corporate personalization PIN required 需要企业个性化 PIN 47 corporate personalization PUK required 需要企业个性化 PUK 48 hidden key required 需要隐藏密钥 49 EAP method not support EAP 方法不支持 50 incorrect Parameters 无效参数 51 command implemented but currently 命令已实现，但当前已禁用 disabled 52 command aborted by user 命令被用户终止 上海移远通信技术股份有限公司 152 / 169 BC28-F&BC95-GF AT 命令手册 53 not attached to network due to MT 由于 MT 功能受限，未注册到网络 functionality restrictions 54 modem not allowed-MT restricted to Modem 不允许- MT 仅限于紧急呼叫 emergency calls only 55 operation not allowed because of MT 由于 MT 功能受限，操作不允许 functionality restrictions 56 fixed dial number only allowed - called 仅允许固定拨号-已拨号码非固话 number is not a fixed 57 temporarily out of service due to other MT 由于其他 MT 使用，暂时停用 usage 58 language/alphabet not supported 不支持的语言/字母 59 unexpected data value 数据值超出范围 60 system failure 系统发生问题 61 data missing 数据丢失 62 call barred 禁止通话 63 message waiting indication subscription 消息等待指示订阅失败 failure 100 unknown 未知 103 illegal MS 非法 MS 106 illegal ME 非法 ME 107 GPRS services not allowed 不允许的 GPRS 服务 108 GPRS services and non GPRS services 不允许的 GPRS 服务和非 GPRS 服务 not allowed 111 PLMN not allowed 不允许 PLMN 112 location area not allowed 不允许的位置区域 113 roaming not allowed in this location area 在此位置区域内不允许漫游 114 GPRS services not allowed in this PLMN 此 PLMN 不允许使用 GPRS 服务 115 No suitable cells in location area 位置区域内没有合适的小区 122 Congestion 拥塞 126 Insufficient resources 资源不足 127 Mission or unknown APN 任务或未知 APN 上海移远通信技术股份有限公司 153 / 169 BC28-F&BC95-GF AT 命令手册 128 Unknown PDP address or PDP type 未知 PDP 地址或 PDP 类型 129 User authentication failed 用户鉴权失败 130 Active reject by GGSN services GW or 被 GGSN 服务 GW 或 PDN GW 主动拒绝 PDN GW 131 Active reject unspecified 未指定主动拒绝 132 service option not supported 服务选项不支持 133 requested service option not subscribed 未订阅请求服务选项 134 service option temporarily out of order 服务选项暂时失灵 140 Feature not supported 不支持该功能 141 Semantic errors in the TFT operation TFT 操作语义错误 142 Syntactical errors in the TFT operation TFT 操作中的句法错误 143 Unknown PDP context 未知 PDP 上下文 144 Semantic errors in packet filters 数据包过滤器中的语义错误 145 Syntactical errors in packet filters 数据包过滤器中的句法错误 146 PDP context without TFT already 没有激活 TFT 的 PDP 上下文 activated 148 unspecified GPRS error 未指定的 GPRS 错误 149 PDP authentication failure PDP 认证失败 150 invalid mobile class 无效移动类 171 Last PDN disconnection not allowed 不允许最后一个 PDN 断开连接 172 Semantically incorrect message 消息语义不正确 173 Mandatory information element error 强制性信息元素错误 174 Information element not existent or not 信息元素不存在或未实现 implemented 175 Conditional IE error 有条件 IE 错误 176 Protocol error unspecified 未指定的协议错误 177 Operator determined barring 运营商决定的限制 178 Max number of PDP contexts reached 达到 PDP 上下文的最大数量 上海移远通信技术股份有限公司 154 / 169 BC28-F&BC95-GF AT 命令手册 Requested APN not supported in current 当前的 RAT 和 PLMN 组合不支持请求的 179 RAT and PLMN combination APN 180 Request rejected bearer control mode 请求拒绝承载控制模式冲突 violation 181 Unsupported OCI value 不支持的 OCI 值 182 User data transmission via control plane is 通过控制平面的用户数据传输拥塞 congested 301 Internal error base 内部错误基础 302 UE busy UE 繁忙 303 Not power on 未开机 304 PDN not active 未激活 PDN 305 PDN not valid 无需 PDN 306 PDN invalid type 无需 PDN 类型 307 PDN no parameter PDN 无参数 308 UE fail UE 失败 309 PDN type and APN duplicate used 重复的 PDN 和 APN 310 PAP and EITF not matched PAP 和 EITF 不匹配 311 SIM PIN disabled SIM 卡 PIN 码已禁用 312 SIM PIN already enabled SIM 卡 PIN 码已启用 313 SIM PIN wrong format SIM PIN 格式错误 512 Required parameter not configured 未配置必需的参数 514 AT internal error AT 内部错误 515 CID is active CID 已激活 516 Incorrect state for command 命令状态错误 517 CID is invalid CID 无效 518 CID is not active CID 未激活 520 Deactivate the last active CID 停用最后一个已激活的 CID 521 CID is not defined CID 未定义 上海移远通信技术股份有限公司 155 / 169 BC28-F&BC95-GF AT 命令手册 522 UART parity error UART 奇偶校验错误 523 UART frame error UART 帧错误 524 UE is in minimal function mode UE 处于最小功能模式 525 AT command aborted: in processing AT 命令中止：处理中 526 AT command aborted: error AT 命令中止：出错 527 Command interrupted 命令中断 528 Configuration conflicts 配置冲突 529 During FOTA updating 在 FOTA 更新期间 530 Not the AT allocated socket 非 AT 分配的 Socket 531 USIM PIN is blocked USIM PIN 被阻止 532 USIM PUK is blocked USIM PUK 被阻止 533 Not mipi module 非 mipi 模块 534 File not found 文件未找到 535 Conditions of use not satisfied 使用条件不满足 536 AT UART buffer error AT UART 缓冲区错误 537 Back off timer is running 退避计时器正在运行 上海移远通信技术股份有限公司 156 / 169 BC28-F&BC95-GF AT 命令手册 7 重启原因 除了重新上电或外部复位，如果模块因其他任何原因重新启动，将输出一条消息，以表明重新启动的 原因。该打印的重启原因仅供参考，不能作为判断模块重启的唯一原因。 表 3：重启原因显示 序号 1 2 3 4 5 6 重启消息显示 REBOOT_CAUSE_APPLICATION_UNKNOWN REBOOT_CAUSE_APPLICATION_WATCHDOG REBOOT_CAUSE_APPLICATION_ASSERT REBOOT_CAUSE_APPLICATION_HARDFAULT REBOOT_CAUSE_APPLICATION_AT REBOOT_CAUSE_APPLICATION_POWER_ON_RESET 上海移远通信技术股份有限公司 157 / 169 BC28-F&BC95-GF AT 命令手册 8 举例 8.1. 附着网络 执行命令 AT+NCONFIG=AUTOCONNECT,TRUE 模块自动附着网络。 如果需要手动注网，请通过执行命令 AT+NCONFIG=AUTOCONNECT,FALSE 禁用自动附着网络功 能。该设置将保存至 NVRAM，并在执行命令 AT+NRB 重启模块后生效。 8.1.1. 自动附着网络 以下是附着网络的简单示例。客户可以通过以下命令查询模块是否已附着到网络： REBOOT_CAUSE_APPLICATION_POWER_ON_RESET OK //模块上电开机 AT+CFUN? +CFUN:1 OK AT+CIMI 460111174590523 //查询 IMSI 号 OK AT+CEREG? +CEREG:0,1 //查询网络注册状态 //=0 表示已禁用网络注册 URC，=1 表示已注册 OK AT+CGATT? +CGATT:1 //查询网络附着状态 //网络附着成功，通常需要等待 30 秒 OK AT+CGPADDR //查询模块的 IP 地址 +CGPADDR:0,10.169.241.248 OK 上海移远通信技术股份有限公司 158 / 169 BC28-F&BC95-GF AT 命令手册 8.1.2. 手动附着网络 全频段搜网可能会花费较长的时间，因此建议手动注网时，只搜索指定的频段。 AT+NCONFIG=AUTOCONNECT,FALSE OK AT+NRB REBOOTING //禁用自动连接网络 //重启模块 REBOOT_CAUSE_APPLICATION_AT OK AT+NBAND=5 OK AT+CFUN=1 OK AT+CIMI 460111174590523 //重启原因 //指定要搜索的频段 B5 //将模块设置为全功能模式 //查询 IMSI 号 OK AT+CGATT=1 OK AT+NUESTATS Signal power:-870 Total power:-710 TX power:-128 TX time:995 RX time:16146 Cell ID:139024564 ECL:0 SNR:-6 EARFCN:3686 PCI:473 RSRQ:-160 OPERATOR MODE:4 CURRENT BAND:8 //触发网络连接 //查询模块状态 OK AT+CEREG? +CEREG:0,1 //查询网络注册状态 //=0 表示已禁用网络注册 URC，=1 表示已注册 OK AT+CGATT? +CGATT:1 //查询网络附着状态 //网络附着成功，通常需要等待 30 秒 上海移远通信技术股份有限公司 159 / 169 OK AT+CGPADDR +CGPADDR:0,10.3.42.109 OK BC28-F&BC95-GF AT 命令手册 //查询模块的 IP 地址 8.2. 发送/接收/读取 UDP 信息 以下是发送/接收/读取 UDP 信息的简单示例。Socket 关闭后，将不会收到任何响应。当不使用 IoT 平 台时，需要在模块连接到网络之前禁用 IoT 平台的注册功能。 AT+QREGSWT=2 OK … //禁用 IoT 平台的注册功能 //连接网络 AT+CGPADDR +CGPADDR:0,10.3.42.109 OK AT+NSOCR=DGRAM,17,0,1 1 //查询模块的 IP 地址 //创建一个 Socket OK AT+NSOST=1,220.180.239.212,8012,5,1245783132,100 //发送信息 1,5 OK +NSOSTR:1,100,1 //数据成功发送到 NB-IoT 栈的报文 +NSONMI:1,5 AT+NSORF=1,5 1,220.180.239.212,8012,5,1245783132,0 //接收信息 //读取信息 OK AT+NSOCL=1 OK //关闭 Socket 8.3. 发送/接收/读取 TCP 信息 以下是发送/接收/读取 TCP 信息的简单示例。关闭 Socket 后，将不会收到任何响应。当不适用 IoT 平 台时，需要在模块连接到网络之前禁用 IoT 平台的注册功能。 上海移远通信技术股份有限公司 160 / 169 BC28-F&BC95-GF AT 命令手册 AT+QREGSWT=2 OK … AT+CGPADDR +CGPADDR:0,10.3.42.79 OK AT+NSOCR=STREAM,6,0,1 1 OK AT+NSOCO=1,220.180.239.212,8009 OK AT+NSOSD=1,4,01020304,0x100,101 1,4 OK +NSOSTR:1,101,1 +NSONMI:1,4 AT+NSORF=1,4 1,220.180.239.212,8009,4,01020304,0 OK AT+NSOCL=1 OK //禁用 IoT 平台的注册功能 //连接网络 //查询模块的 IP 地址 //创建一个 Socket //连接服务器 //发送数据 //确认数据报文已由服务器接收 //接收信息 //读取信息 //关闭 Socket 8.4. 中国电信 IoT 平台相关举例 8.4.1. 注册中国电信 IoT 平台 8.4.1.1. 自动注册模式 AT+QREGSWT? +QREGSWT:1 OK AT+NCDP=180.101.147.115,5683 OK AT+NRB REBOOTING //自动注册模式（默认模式） //设置 IoT 平台 IP 地址及端口 //重启模块 上海移远通信技术股份有限公司 161 / 169 BC28-F&BC95-GF AT 命令手册 REBOOT_CAUSE_APPLICATION_AT OK AT+CGPADDR +CGPADDR:0,10.3.42.109 OK +QLWEVTIND:0 +QLWEVTIND:3 //重启原因 //查询模块的 IP 地址 //表明成功注册 //IoT 平台已订阅实例 19/0。当模块报告此消息时，MCU 可以发送数据到 IoT 平台。 8.4.1.2. 手动注册模式 AT+CGPADDR +CGPADDR:0,11.202.63.115 OK AT+NCDP=180.101.147.115,5683 OK AT+QREGSWT? +QREGSWT:0 OK AT+QLWSREGIND=0 OK +QLWEVTIND:0 +QLWEVTIND:3 AT+QLWSREGIND=1 OK +QLWEVTIND:1 //查询模块的 IP 地址 //设置 IoT 平台 IP 地址及端口 //查询注册模式 //手动注册模式 //开始注册 IoT 平台 //表明成功注册 //IoT 平台已订阅实例 19/0。当模块报告此消息时，MCU 可以发送数据到 IoT 平台。 //从 IoT 平台注销 //表明注销成功 8.4.2. 从中国电信 IoT 平台发送/接收数据 +QLWEVTIND:0 //表明成功注册 +QLWEVTIND:3 AT+QLWULDATA=3,313233 OK //IoT 平台已订阅实例 19/0。当模块报告此消息时，MCU 可以发送数据到 IoT 平台。 //发送 NON 数据，不需要 IoT 平台应答 ACK 消息。 上海移远通信技术股份有限公司 162 / 169 BC28-F&BC95-GF AT 命令手册 +NNMI:4,AAAA0000 AT+QLWULDATAEX=3,313233,0X0100 OK +QLWULDATASTATUS:4 +NNMI:4,AAAA0000 AT+QLWULDATASTATUS? +QLWULDATASTATUS:4 OK //模块已从物联网平台接收数据 //发送 CON 消息， IoT 平台需要应答 ACK 消息 //数据发送成功 //模块已从物联网平台接收数据 //查询数据发送状态 //数据发送成功 8.5. 释放辅助指示（RAI） 当 UE 没有更多数据要发送时，它将等待网络释放连接以进入空闲模式。为了使网络快速将 UE 释放到 空闲模式以节省功耗，释放辅助指示（RAI）在 R13 中引入，用于控制面 CIoT EPS 优化，其中 UE 可以 在非接入层（NAS）信令中包含 RAI，以指示在上行数据之后没有进一步的上行或下行数据传输，从而帮 助网络确定是否可以释放连接。 R14 引入了用于控制面和用户面 CIoT EPS 优化的接入层（AS）的 RAI。 当配置 AS RAI 时，UE 可以触发具有零字节大小的缓冲区状态报告（BSR），向 eNB 指示预计不会 再有 UL 或 DL 数据，可以释放连接。 8.5.1. RAI 功能操作举例（R13） 8.5.1.1. 发送 LwM2M CON/NON 数据 执行 AT+CSCON 使能 URC 上报功能，通过 URC 的上报状态，可判断 RAI 功能是否生效。 AT+CSCON=1 OK +CSCON:0 AT+NCDP? +NCDP:180.101.147.115,5683 //使能 URC 上报功能 //IoT 平台服务器地址 OK AT+QLWULDATAEX=3,AA34BB,0x0001 //使用 0x0001 标志位发送 NON 数据 OK +CSCON:1 //建立 RRC 连接，并开始发送数据 上海移远通信技术股份有限公司 163 / 169 BC28-F&BC95-GF AT 命令手册 +CSCON:0 //数据发送完毕后，立即释放 RRC 连接 AT+QLWULDATAEX=3,AA34BB,0x0101 //使用 0x0101 标志位发送 CON 数据 OK +CSCON:1 //建立 RRC 连接，并开始发送数据 +QLWULDATASTATUS:4 //CON 数据被平台确认收到 +CSCON:0 //数据发送完毕后，立即释放 RRC 连接 8.5.2. RAI 功能操作举例（R14） 以下示例中，R14 版本 RAI 功能均已经开启并生效。 //查询 R14 版本 RAI 功能是否开启 AT+NCONFIG? …… +NCONFIG:RAI,TRUE …… //R14 版本 RAI 功能已开启 OK 8.5.2.1. 发送 LwM2M CON/NON 数据 执行 AT+CSCON 使能 URC 上报功能，通过 URC 的上报状态，可判断 RAI 功能是否生效。 //模块已经连接至 IoT 平台 AT+CSCON=1 //使能 URC 上报功能 OK AT+QLWULDATAEX=5,1122334455,0x0000,2 //使用 0x0000 标志位发送 NON 数据 OK +CSCON:1 AT+CNMPSD //建立 RRC 连接，并开始发送数据 //通知网络没有数据业务 OK +CSCON:0 //RRC 连接立即释放 AT+QLWULDATAEX=5,1122334455,0x0100 //使用 0x0100 标志位发送 CON 数据 OK +CSCON:1 //建立 RRC 连接，并开始发送数据 +QLWULDATASTATUS:4 AT+CNMPSD //通知网络没有数据业务 OK +CSCON:0 //RRC 连接立即释放 上海移远通信技术股份有限公司 164 / 169 BC28-F&BC95-GF AT 命令手册 9 附录 A 术语缩写 表 4：术语缩写 缩写 3GPP APDU APN AS BCD BER BIP BSR CDP CHAP CID CIOT CoAP CON DF DNS EAP EARFCN 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 Application Protocol Data Unit 应用协议数据单元 Access Point Name 接入点名称 Access Stratum 接入层 Binary-Coded Decimal 二进制编码的十进数 Bit Error Rate 误码率 Bearer Independent Protocol 承载独立协议 Buffer Status Report 缓冲区状态报告 Connected Device Platform Challenge-Handshake Authentication Protocol Context Identity 连接设备平台 挑战握手认证协议 上下文 ID Cellular Internet of Things 蜂窝物联网 Constrained Application Protocol 受限的应用层协议 Confirmable 需要对端返回应答的信息类型 Dedicated File 专用文件 Domain Name Server 域名系统（服务）协议 Extensible Authentication Protocol 可扩展认证协议 E-UTRA Absolute Radio Frequency Channel E-UTRA 绝对无线频道编号 Number 上海移远通信技术股份有限公司 165 / 169 BC28-F&BC95-GF AT 命令手册 ECL eDRX EITF EMM eNB EPAT EPCO EPS ESM E-UTRA(N) FOTA GGSN GMT GPRS GSM GW HARQ HPLMN HPPLMN ID IE IMEI IMEISV IMSI IoT Enhanced Coverage Level 增强覆盖等级（多出现于 NB-IoT） Extended Discontinuous Reception 扩展非连续性接收 ESM Information Transfer Flag ESM 消息传输标志 EPS Mobility Management EPS 移动管理 Evolved Node B 演进型 Node B Eigen Comm Platform Analysis Tools EigenComm 平台分析工具 Extended Protocol Configuration Options 扩展协议配置选项 Evolved Packet System 演进型分组系统 EPS Session Management EPS 会话管理 Evolved Universal Terrestrial Radio Access 演进型通用地面无线接入（网络） (Network) Firmware Upgrade Over-The-Air 固件空中升级 Gateway GPRS Support Node 网关 GPRS 支持节点 Greenwich Mean Time 格林尼治标准时间 General Packet Radio Service 通用分组无线服务技术 Global System for Mobile Communications 全球移动通信系统 Gateway 网关 Hybrid Automatic Repeat Request 混合式自动重传请求 Home Public Land Mobile Network 本地公用陆地移动网络 Higher Priority PLMN 高优先级 PLMN 搜索周期 Identifier 标识符 Information Element 信息元素 International Mobile Equipment Identity 国际移动设备识别码 International Mobile Equipment Identity and 国际移动用户识别码及软件版本 Software Version International Mobile Subscriber Identity 国际移动用户识别码 Internet of Things 物联网 上海移远通信技术股份有限公司 166 / 169 IP IPv4 IPv6 IRA ISIM ITU-T LwM2M MCU MF MS MT NAS NB-IoT NITZ NON NSLPI NVRAM OCI OOS PAP PCI PCO P-CSCF PDCP PDN BC28-F&BC95-GF AT 命令手册 Internet Protocol Internet Protocol version 4 Internet Protocol version 6 International Reference Alphabet IM (IP Multimedia) Service Identity Module International Telecommunication Union Lightweight M2M Microcontroller Unit Master File Mobile Station Mobile Terminated Non-Access Stratum. Narrow Band Internet of Thing Network Identity and Time Zone / Network Informed Time Zone. Nonconfirmable NAS Signaling Low Priority Indication Non-Volatile Random Access Memory Outgoing Call Information Out of Service Password Authentication Protocol Physical Cell Identity Protocol Configuration Options Proxy Call Session Control Function Packet Data Convergence Protocol Packet Data Network 互联网协议 第 4 版互联网协议 第 6 版互联网协议 国际参考字母编码 IM（IP 多媒体）业务识别模块 国际电信联盟(标准化工作组) 轻量化 M2M（协议） 微型控制单元/微程序控制器 主要文件 移动台 终止于移动端的 非接入层 窄带物联网 网络标识和时区 不需要对端返回应答的信息类型 非接入层信令低优先级指示 非易失性随机访问存储器 呼出电话信息 无服务 口令验证协议 物理小区识别码 协议配置选项 代理呼叫会话控制 分组数据集中协议 分组数据网络 上海移远通信技术股份有限公司 167 / 169 PDP PIN PLMN PS PSM PUK PTW RAI RAT RN ROHC RRC RX RxQual SIB SMS SNDCP SNR SVN TA TAU TCP TE TFT TX BC28-F&BC95-GF AT 命令手册 Packet Data Protocol 分组数据协议 Personal Identification Number 个人识别号 Public Land Mobile Network 公共陆地移动网络 Packet Switch 分组交换 Power Saving Mode 省电模式 PIN Unblocking Key PIN 码解锁密码 Paging Time Window 寻呼时间窗口 Release Assistant Indication 释放辅助指示 Radio Access Technology 无线接入技术 Release Note 发布说明 Robust Header Compression 健壮性头压缩 Radio Resource Control 无线资源控制 Receive 接收 Receive Quality 接收质量 System Information Block 系统信息块 Short Message Service Sub-Network Dependent Protocol Signal-to-Noise Ratio 短消息业务 Convergence 子网相关会聚协议 信噪比 Software Version Number 软件版本 Terminal Adapter 终端适配器 Tracking Area Update. 跟踪区更新 Transmission Control Protocol 传输控制协议 Terminal Equipment 终端设备 Traffic Flow Template 业务流模板 Transmit/Transmission 发送/传输 上海移远通信技术股份有限公司 168 / 169 UART UDP UE UICC UMTS URC USIM UUID WIM Universal Asynchronous Receiver/ Transmitter User Datagram Protocol User Equipment Universal Integrated Circuit Card Universal Mobile Telecommunications System (UMTS) Unsolicited Result Code Universal Subscriber Identity Module Universally Unique Identifier Wireless Identity Module BC28-F&BC95-GF AT 命令手册 通用异步收发传输器 用户数据报协议 用户设备 通用集成电路卡 通用移动通信系统 非请求结果码 通用用户识别卡 通用唯一识别码 无线识别模块 上海移远通信技术股份有限公司 169 / 169

EG060V-EA&EG060W-EA AT Commands Manual LTE-A Module Series Version: 2.0 Date: 2023-12-28 Status: Released LTE-A Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. EG060V-EA&EG060W-EA_AT_Commands_Manual 1 / 167 LTE-A Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. EG060V-EA&EG060W-EA_AT_Commands_Manual 2 / 167 LTE-A Module Series About the Document Revision History Version Date Author Description Paddy LI/Igni LI/ - 2021-01-28 Creation of the document Ethan BI/Martin WANG Paddy LI/Igni LI/ 1.0 2021-03-08 First official release Ethan BI/Martin WANG 1. Added the applicable module: EG060W-EA. 2. Added the following commands: ⚫ AT+QCFG='nat' (Chapter 3.3.7) ⚫ AT+QCFG='roamservice' (Chapter 3.3.9) ⚫ AT+QCFG='nwscanseq' (Chapter 3.3.10) ⚫ AT+CNMI (Chapter 8.11) ⚫ AT+QAUDCFG='slic_IndRep' (Chapter 10.1) 3. Deleted commands AT+ZGDCONT, AT+ZGACT and AT+ZGPADDR. 4. Added the description that LE9643 is not Jayden LI/ Felix HE/ supported currently in AT+QSLIC (Chapter 10.7). Younge CHEN/ 5. Added default values of following parameters: Benjamin ZHANG/ 2.0 2023-12-28 Delessio WEI/ ⚫ in AT+QCFG='usbnet' (Chapter 3.3.1) Lucas SHI/ Shine JIE/ ⚫ in AT+QCFG='devmode' (Chapter Asa WANG 3.3.2) ⚫ in AT+QCFG='IMS' (Chapter 3.3.3) ⚫ in AT+QCFG='nwscanmode' (Chapter 3.3.4) ⚫ in AT+QCFG='servicedomain' (Chapter 3.3.6) ⚫ in AT+QCFG='tone/incoming' (Chapter 3.3.8) ⚫ and in AT+QSIMDET (Chapter 4.8) EG060V-EA&EG060W-EA_AT_Commands_Manual 3 / 167 LTE-A Module Series 6. Updated the value description of in AT+QCFG='devmode' (Chapter 3.3.2) 7. Updated the characteristics of AT+AUTOAPN (Chapter 9.12) 8. Updated the response format and example of AT+QNETDEVSTATUS (Chapter 9.15) 9. Updated the default value of in AT+CGEREP (Chapter 9.7), in AT+CGSMS (Chapter 9.8) and in AT+AUTOAPN (Chapter 9.12) 10. Added the following URCs (Chapter 12.4): ⚫ +CMTI: , ⚫ +CMT: [], ⚫ +CMT: ,[],[,,, ,,,,] ⚫ +CBM: ⚫ +CBM: ,,,, ⚫ +CDS: ⚫ +CDS: ,,[],[],,, ⚫ +CDSI: , EG060V-EA&EG060W-EA_AT_Commands_Manual 4 / 167 LTE-A Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 9 1 Introduction ....................................................................................................................................... 10 1.1. AT Command Syntax ........................................................................................................... 10 1.1.1. Definitions...................................................................................................................... 10 1.1.2. AT Command Syntax .................................................................................................... 10 1.2. AT Command Responses .................................................................................................... 12 1.3. Supported Character Sets.................................................................................................... 12 1.4. AT Command Interface ........................................................................................................ 12 1.5. Unsolicited Result Code ....................................................................................................... 13 1.6. Declaration of AT Command Examples ............................................................................... 13 2 General Commands .......................................................................................................................... 14 2.1. ATI Display Product Identification Information .................................................................. 14 2.2. AT+GMI Request Manufacturer Identification ................................................................... 15 2.3. AT+GMM Request Model Identification............................................................................. 15 2.4. AT+GMR Request Revision Identification of Software Release ....................................... 16 2.5. AT+CGMI Request Manufacturer Identification ................................................................ 16 2.6. AT+CGMM Request Model Identification .......................................................................... 17 2.7. AT+CGMR Request Revision Identification of Software Release .................................... 17 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) ................................... 18 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) ................................ 19 2.10. ATQ Set Result Code Presentation Mode......................................................................... 19 2.11. ATV TA Response Format................................................................................................. 20 2.12. ATE Set Command Echo Mode ........................................................................................ 21 2.13. AT+CFUN Set UE Functionality ........................................................................................ 22 2.14. AT+CMEE Configure Error Message Format.................................................................... 23 2.15. AT+CSCS Select TE Character Set .................................................................................. 24 2.16. AT+QURCCFG Configure URC Output Port..................................................................... 25 3 Status Control Commands .............................................................................................................. 27 3.1. AT+CPAS Mobile Equipment Activity Status .................................................................... 27 3.2. AT+CEER Report Extended Error ..................................................................................... 28 3.3. AT+QCFG Extended Configuration Settings..................................................................... 29 3.3.1. AT+QCFG='usbnet' USB Network Card Configuration ............................................ 30 3.3.2. AT+QCFG='devmode' Device Mode Configuration .................................................. 30 3.3.3. AT+QCFG='IMS' IMS Service Configuration ............................................................ 31 3.3.4. AT+QCFG='nwscanmode' Configure Network Search Mode................................... 32 3.3.5. AT+QCFG='band' Band Configuration...................................................................... 33 3.3.6. AT+QCFG='servicedomain' Configure Service Domain ........................................... 34 3.3.7. AT+QCFG='nat' Configure Dial-up Mode ................................................................. 35 EG060V-EA&EG060W-EA_AT_Commands_Manual 5 / 167 LTE-A Module Series 3.3.8. AT+QCFG='tone/incoming' Enable/Disable Ringing Tone ....................................... 36 3.3.9. AT+QCFG='roamservice' Roam Service Configuration ........................................... 37 3.3.10. AT+QCFG='nwscanseq' Configure Network Search Sequence ....................... 38 4 (U)SIM Related Commands .............................................................................................................. 40 4.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) ................................... 40 4.2. AT+CLCK Facility Lock...................................................................................................... 41 4.3. AT+CPIN Enter PIN ........................................................................................................... 43 4.4. AT+CPWD Change Password........................................................................................... 45 4.5. AT+CSIM Generic (U)SIM Access .................................................................................... 46 4.6. AT+CRSM Restricted (U)SIM Access ............................................................................... 47 4.7. AT+QCCID Show ICCID.................................................................................................... 48 4.8. AT+QSIMDET (U)SIM Card Detection .............................................................................. 49 4.9. AT+QSIMSTAT (U)SIM Insertion Status Report ............................................................... 50 5 Network Service Commands ........................................................................................................... 52 5.1. AT+COPS Operator Selection........................................................................................... 52 5.2. AT+CREG Network Registration Status............................................................................ 54 5.3. AT+CSQ Signal Quality Report ......................................................................................... 56 5.4. AT+CPOL Preferred Operator List .................................................................................... 57 5.5. AT+COPN Read Operator Names .................................................................................... 58 5.6. AT+CTZU Automatic Time Zone Update .......................................................................... 59 5.7. AT+CTZR Time Zone Reporting........................................................................................ 60 5.8. AT+QSPN Query the Service Provider Name................................................................... 61 5.9. AT+QNWINFO Query Network Information ...................................................................... 62 5.10. AT+QNWLOCK='common/lte' Network Locking Configuration ....................................... 63 5.11. AT+QENG Query Primary Serving Cell and Neighbor Cell Information ........................... 64 5.12. AT+QCAINFO Query Carrier Aggregation Parameters .................................................... 69 6 Call Related Commands................................................................................................................... 71 6.1. AT+QECCNUM Configure Emergency Call Numbers ...................................................... 71 7 Phonebook Commands.................................................................................................................... 73 7.1. AT+CNUM Subscriber Number ......................................................................................... 73 7.2. AT+CPBS Select Phonebook Memory Storage ................................................................ 74 7.3. AT+CPBF Find Phonebook Entries ................................................................................... 75 7.4. AT+CPBR Read Phonebook Entries ................................................................................. 76 7.5. AT+CPBW Write Phonebook Entry ................................................................................... 77 8 Short Message Service Commands................................................................................................ 79 8.1. AT+CSMS Select Message Service .................................................................................. 79 8.2. AT+CMGF Message Format ............................................................................................. 80 8.3. AT+CSCA Service Center Address ................................................................................... 81 8.4. AT+CPMS Preferred Message Storage ............................................................................ 82 8.5. AT+CMGD Delete Message .............................................................................................. 84 8.6. AT+CMGL List Messages.................................................................................................. 85 8.7. AT+CMGR Read Message ................................................................................................ 89 EG060V-EA&EG060W-EA_AT_Commands_Manual 6 / 167 LTE-A Module Series 8.8. 8.9. 8.10. 8.11. 8.12. 8.13. 8.14. 8.15. AT+CMGS Send Message ................................................................................................ 93 AT+CMMS Send More Messages ..................................................................................... 94 AT+CMGW Write Message to Memory ............................................................................. 95 AT+CNMI New Message Indications to TE ....................................................................... 97 AT+CMSS Send Message from Storage......................................................................... 100 AT+CSCB Select Cell Broadcast Message Types.......................................................... 102 AT+CSDH Show SMS Text Mode Parameters ............................................................... 103 AT+CSMP Set SMS Text Mode Parameters .................................................................. 104 9 Packet Domain Commands ........................................................................................................... 106 9.1. AT+CGATT Attachment or Detachment of PS................................................................ 106 9.2. AT+CGDCONT Define PDP Context .............................................................................. 107 9.3. AT+CGACT Activate or Deactivate PDP Context ........................................................... 109 9.4. AT+CGPADDR Show PDP Address ............................................................................... 110 9.5. AT+CGCLASS GPRS Mobile Station Class ................................................................... 112 9.6. AT+CGREG GPRS Network Registration Status............................................................ 113 9.7. AT+CGEREP Packet Domain Event Reporting .............................................................. 114 9.8. AT+CGSMS Select Service for MO SMS Messages ...................................................... 116 9.9. AT+CEREG EPS Network Registration Status ............................................................... 117 9.10. AT+QGDCNT Packet Data Counter................................................................................ 118 9.11. AT+QAUGDCNT Auto Save Packet Data Counter ......................................................... 120 9.12. AT+AUTOAPN Auto-Configure APN ............................................................................... 121 9.13. AT+QICSGP Define PDP Context................................................................................... 122 9.14. AT+QNETDEVCTL Activate or Deactivate PDP Context ............................................... 124 9.15. AT+QNETDEVSTATUS Show PDP Relevant Information ............................................. 125 10 Audio Commands ........................................................................................................................... 127 10.1. AT+QAUDCFG Query and Configure Audio Tuning Process......................................... 127 10.1.1. AT+QAUDCFG='slic_IndRep' Enable/Disable the Reporting of SLIC Analog Phone Events ............................................................................................................................ 127 10.2. AT+CLVL Loudspeaker Volume Level Selection ............................................................ 129 10.3. AT+QLDTMF Play Local DTMF....................................................................................... 129 10.4. AT+QAUDLOOP Enable/Disable Audio Loop Test......................................................... 131 10.5. AT+QDAI Digital Audio Interface Configuration .............................................................. 131 10.6. AT+QSIDET Set Side Tone Gain in Current Mode ......................................................... 133 10.7. AT+QSLIC Enable/Disable SLIC ..................................................................................... 134 10.8. AT+QAUDMOD Set Audio Mode .................................................................................... 135 10.9. AT+QMIC Set Uplink Gains of Microphone..................................................................... 135 10.10. AT+QRXGAIN Set Downlink Gains of RX....................................................................... 136 10.11. AT+VTS DTMF and Tone Generation............................................................................. 137 11 Hardware Related Commands ....................................................................................................... 139 11.1. AT+CCLK Clock............................................................................................................... 139 11.2. AT+QSCLK Enable/Disable Low Power Mode ............................................................... 140 11.3. AT+QPOWD Power off .................................................................................................... 141 11.4. AT+QADC Read ADC Value ........................................................................................... 141 EG060V-EA&EG060W-EA_AT_Commands_Manual 7 / 167 LTE-A Module Series 12 Appendix References ..................................................................................................................... 143 12.1. References ......................................................................................................................... 143 12.2. Summary of CME ERROR Codes ..................................................................................... 148 12.3. Summary of CMS ERROR Codes ..................................................................................... 150 12.4. Summary of URC ............................................................................................................... 152 12.5. SMS Character Sets Conversions ..................................................................................... 154 12.6. Release Cause Text List of AT+CEER .............................................................................. 160 EG060V-EA&EG060W-EA_AT_Commands_Manual 8 / 167 LTE-A Module Series Table Index Table 1: Types of AT Commands......................................................................................................................... 11 Table 2: ATV0&ATV1 Result Codes Equivalence and Brief Description ....................................................... 21 Table 3: Related Documents............................................................................................................................... 143 Table 4: Terms and Abbreviations ..................................................................................................................... 143 Table 5: Different Coding Schemes of +CME ERROR: ....................................................................... 149 Table 6: Different Coding Schemes of +CMS ERROR: ....................................................................... 151 Table 7: Summary of URC .................................................................................................................................. 152 Table 8: The Way of SMS Text Input or Output ............................................................................................... 154 Table 9: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM')..................................... 154 Table 10: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') ............................... 155 Table 11: GSM Extended Characters................................................................................................................ 156 Table 12: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='IRA') ..................................... 156 Table 13: IRA Extended Characters .................................................................................................................. 157 Table 14: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='IRA').................................. 158 Table 15: GSM Extended Characters................................................................................................................ 159 Table 16: Release Cause Text List of AT+CEER ............................................................................................ 160 EG060V-EA&EG060W-EA_AT_Commands_Manual 9 / 167 LTE-A Module Series 1 Introduction This document presents the AT Command Set applicable to the Quectel LTE-A module EG060V-EA and EG060W-EA. 1.1. AT Command Syntax 1.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter 1.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. The AT Command Set applicable to the module consists of AT commands defined in 3GPP TS 27.007, 3GPP TS 27.005 and ITU-T recommendation V.25ter and the AT Commands developed by Quectel. These AT commands fall into three categories syntactically: basic, S parameter, and extended. ⚫ Basic Syntax Basic command format is AT, or AT&, where is the command, and is/are the argument(s) of the command. For example, ATE tells the DCE (Data Circuit-terminating Equipment) whether received characters should be echoed back to the DTE (Data Terminal Equipment) according to the value of . is optional and a default will be used if it is omitted. EG060V-EA&EG060W-EA_AT_Commands_Manual 10 / 167 LTE-A Module Series ⚫ S Parameter Syntax S Parameter command format is ATS=, where is the index of the S register to be set, and is the value to be assigned to it. ⚫ Extended Syntax These AT commands have four types as explained in the following table: Table 1: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. Multiple AT commands can be placed in a single line using a semi-colon (;) between commands. In such cases, only the first command should have the AT prefix. Commands can be in upper or lower cases. Spaces should be ignored when you enter AT commands, except in the following cases: ⚫ Within quoted strings, where spaces are preserved; ⚫ Within an unquoted string or numeric parameter; ⚫ Within an IP address; ⚫ Within the AT command name up to and including a =, ? or =?. 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, ERROR will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. NOTE Input each AT command separately. Execute a new AT command only after the former one is completed. EG060V-EA&EG060W-EA_AT_Commands_Manual 11 / 167 LTE-A Module Series 1.2. AT Command Responses When the AT command processor has finished processing a line, it will output OK, ERROR or +CME/+CMS ERROR: to indicate that it is ready to accept a new command. Solicited information responses are sent before the final OK, ERROR or +CME/+CMS ERROR: . Responses will be in the format of: +CMD1: OK Or OK 1.3. Supported Character Sets AT command interface defaults to the GSM character set. The module supports the following character sets: ⚫ GSM format ⚫ UCS2 ⚫ IRA The character set can be configured and interrogated by using the AT+CSCS (3GPP TS 27.007) and it is defined in 3GPP TS 27.005. The character set affects transmission and reception of SMS and SMS Cell Broadcast Messages, as well as the entry and display of phone book entries text field. 1.4. AT Command Interface The AT command interface includes two USB ports (USB MODEM port and USB AT port) and one main UART port, all of which support AT command communication and data transfer. EG060V-EA&EG060W-EA_AT_Commands_Manual 12 / 167 LTE-A Module Series 1.5. Unsolicited Result Code As an Unsolicited Result Code and a report message, the URC is not issued as part of the response related to an executed AT command. A URC is issued by the module without being requested by the TE and it is issued automatically when a certain event occurs. Typical events leading to URCs are incoming calls (RING), received short messages, high/low voltage alarm, high/low temperature alarm, etc. 1.6. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. EG060V-EA&EG060W-EA_AT_Commands_Manual 13 / 167 LTE-A Module Series 2 General Commands 2.1. ATI Display Product Identification Information This Execution Command returns product identification information including the identifier of device type and the firmware version of the product. ATI Display Product Identification Information Execution Command ATI Response Quectel Revision: Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identifier of device type. String type. Product firmware version. Example ATI Quectel EG060V-EAAA Revision: EG060VEAAAR01A02M1G OK EG060V-EA&EG060W-EA_AT_Commands_Manual 14 / 167 LTE-A Module Series 2.2. AT+GMI Request Manufacturer Identification This command returns the manufacturer identification text. It is identical with AT+CGMI. AT+GMI Request Manufacturer Identification Test Command AT+GMI=? Execution Command AT+GMI Response OK Response Quectel Maximum Response Time Characteristics Reference V.25ter OK 300 ms / 2.3. AT+GMM Request Model Identification This command returns the product model identification text. It is identical with AT+CGMM. AT+GMM Request Model Identification Test Command AT+GMM=? Execution Command AT+GMM Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identifier of device type. EG060V-EA&EG060W-EA_AT_Commands_Manual 15 / 167 LTE-A Module Series 2.4. AT+GMR Request Revision Identification of Software Release This command returns the product firmware version identification text. It is identical with AT+CGMR. AT+GMR Request Revision Identification of Software Release Test Command AT+GMR=? Execution Command AT+GMR Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identification text of product software version. Example AT+GMR EG060VEAAAR01A06M1G OK 2.5. AT+CGMI Request Manufacturer Identification This command returns the manufacturer identification text. It is identical with AT+GMI. AT+CGMI Request Manufacturer Identification Test Command AT+CGMI=? Execution Command AT+CGMI Response OK Response Quectel OK EG060V-EA&EG060W-EA_AT_Commands_Manual 16 / 167 Maximum Response Time Characteristics Reference 3GPP TS 27.007 300 ms / LTE-A Module Series 2.6. AT+CGMM Request Model Identification This command returns a product model identification text. It is identical with AT+GMM. AT+CGMM Request Model Identification Test Command AT+CGMM=? Execution Command AT+CGMM Response OK Response Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter String type. Identifier of device type. 2.7. AT+CGMR Request Revision Identification of Software Release This command returns identification text of the product firmware revision. It is identical with AT+GMR. AT+CGMR Request Revision Identification of Software Release Test Command AT+CGMR=? Execution Command AT+CGMR Response OK Response EG060V-EA&EG060W-EA_AT_Commands_Manual 17 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter String type. Identification text of product firmware revision. 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) This command requests the International Mobile Equipment Identity (IMEI) number of ME. With this command, you are able to identify an individual ME device. It is identical with AT+CGSN. AT+GSN Request International Mobile Equipment Identity (IMEI) Test Command AT+GSN=? Execution Command AT+GSN Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. IMEI number of the ME. NOTE The serial number (IMEI) varies with the individual ME device. EG060V-EA&EG060W-EA_AT_Commands_Manual 18 / 167 LTE-A Module Series 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) This command requests the International Mobile Equipment Identity (IMEI) number of ME. It is identical with AT+GSN. AT+CGSN Request International Mobile Equipment Identity (IMEI) Test Command AT+CGSN=? Execution Command AT+CGSN Response OK Response Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter String type. IMEI number of the ME. NOTE The serial number (IMEI) varies with the individual ME device. 2.10. ATQ Set Result Code Presentation Mode This command controls whether the result code is transmitted to the TE. Other information text transmitted as response is not affected. ATQ Set Result Code Presentation Mode Execution Command ATQ Response If =0: OK If =1: (none) EG060V-EA&EG060W-EA_AT_Commands_Manual 19 / 167 Maximum Response Time Characteristics Reference V.25ter 300 ms / Parameter Integer type. 0 TA transmits result code 1 Result codes are suppressed and not transmitted LTE-A Module Series 2.11. ATV TA Response Format This command determines the contents of header and trailer transmitted with AT command result codes and information responses. ATV TA Response Format Execution Command ATV Response When =0 0 Maximum Response Time Characteristics Reference V.25ter When =1 OK 300 ms / Parameter Integer type. 0 Information response: Short result code format: 1 Information response: Long result code format: EG060V-EA&EG060W-EA_AT_Commands_Manual 20 / 167 LTE-A Module Series Example ATV1 OK AT+CSQ +CSQ: 30,99 //Set =1. //Query the current signal strength. OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //When =1, the result code is OK. //Set =0. //When =0, the result code is 0. The equivalence between ATV0 and ATV1 result codes as well as the brief description of such codes are listed in the following table. Table 2: ATV0&ATV1 Result Codes Equivalence and Brief Description ATV1 OK ERROR ATV0 0 4 Description Acknowledges execution of a command Command not recognized, command line maximum length exceeded, parameter value invalid, or other problem with processing the command line 2.12. ATE Set Command Echo Mode This command controls whether or not the module echoes characters received from TE in AT command mode. ATE Set Command Echo Mode Execution Command ATE Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter EG060V-EA&EG060W-EA_AT_Commands_Manual 21 / 167 Parameter Integer type. 0 Echo mode OFF 1 Echo mode ON LTE-A Module Series 2.13. AT+CFUN Set UE Functionality This command controls the functionality level. It can also be used to reset the UE. AT+CFUN Set UE Functionality Test Command AT+CFUN=? Response +CFUN: (list of supported s),(list of supported s) Read Command AT+CFUN? OK Response +CFUN: Write Command AT+CFUN=[,] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: +CME ERROR: Or ERROR 15 s, determined by network. / Parameter Integer type. 0 Minimum functionality 1 Full functionality 3 Disable the UE from receiving RF signals 4 Disable the UE from both transmitting and receiving RF signals 5 Disable (U)SIM EG060V-EA&EG060W-EA_AT_Commands_Manual 22 / 167 LTE-A Module Series 6 Second RX off Integer type. 0 Do not reset the UE before setting it to a functionality level. 1 Reset the UE. The device is fully functional after the reset. This value is applicable only when =1. Error codes. For more details, refer to Chapter 12.2. Example AT+CFUN=0 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,2,'46000',7 OK //Switch UE to minimum functionality. //(U)SIM failure. //Switch UE to full functionality. //Operator is registered. 2.14. AT+CMEE Configure Error Message Format This command configures whether to display the error result code +CME ERROR: , and in which format the code is displayed, numeric value or verbose message. AT+CMEE Configure Error Message Format Test Command AT+CMEE=? Response +CMEE: (range of supported s) Read Command AT+CMEE? OK Response +CMEE: Write Command AT+CMEE= OK Response TA disables or enables the use of the result code +CME ERROR: as an indication of an error related to the functionality of the ME. EG060V-EA&EG060W-EA_AT_Commands_Manual 23 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter Integer or String type. 0 Disable result code, and use ERROR instead 1 Enable result code and display in numeric format 2 Enable result code and display in verbose format Error codes. For more details, refer to Chapter 12.2. Example AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted //Disable result code. //Only ERROR is displayed. //Enable error result code in numeric format. //Enable error result code in verbose format. 2.15. AT+CSCS Select TE Character Set This Write Command informs the module which character set is used by the TE. This enables the UE to convert character strings correctly between TE and UE character sets. AT+CSCS Select TE Character Set Test Command AT+CSCS=? Response +CSCS: (list of supported s) OK EG060V-EA&EG060W-EA_AT_Commands_Manual 24 / 167 LTE-A Module Series Read Command AT+CSCS? Write Command AT+CSCS= Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response +CSCS: OK Response OK 300 ms / Parameter String type. 'GSM' GSM default alphabet 'IRA' International reference alphabet 'UCS2' UCS2 alphabet Example AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //Query the current character set of the module. //Set the character set to 'UCS2'. 2.16. AT+QURCCFG Configure URC Output Port This command configures the output port of URC. AT+QURCCFG Configure URC Output Port Test Command AT+QURCCFG=? Response +QURCCFG: 'urcport',(list of supported s) EG060V-EA&EG060W-EA_AT_Commands_Manual 25 / 167 LTE-A Module Series OK Write Command AT+QURCCFG='urcport'[,] Response If the optional parameter is omitted, query the current configuration: +QURCCFG: 'urcport', OK If the optional parameter is specified, configure the output port of URC: OK Or ERROR Maximum Response Time Characteristics 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter String type. Set URC output port. 'usbat' USB AT port 'usbmodem' USB modem port 'uart1' Main UART Example AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' OK AT+QURCCFG='urcport','usbmodem' OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' OK EG060V-EA&EG060W-EA_AT_Commands_Manual 26 / 167 LTE-A Module Series 3 Status Control Commands 3.1. AT+CPAS Mobile Equipment Activity Status This command queries the activity status of the module. AT+CPAS Mobile Equipment Activity Status Test Command AT+CPAS=? Response +CPAS: (list of supported s) Execution Command AT+CPAS OK Response TA returns the activity status of ME: +CPAS: OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: +CME ERROR: Or ERROR 300 ms / Parameter Integer type. ME activity status. 0 Ready 1 Unavailable 2 Unknown 3 Ringing 4 Call in progress or call on hold 5 Asleep 6 Call active EG060V-EA&EG060W-EA_AT_Commands_Manual 27 / 167 LTE-A Module Series Error codes. For more details, refer to Chapter 12.2. Example AT+CPAS +CPAS: 0 OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',129,'',,0 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129,'',,0 OK AT+CPAS +CPAS: 6 OK //The module is ready. //The module is having an incoming call. //The module is ringing. //The module is making an outgoing call. //Call active. 3.2. AT+CEER Report Extended Error This command queries an extended error and report the cause of the last operation that failed, such as: ⚫ The failure to release a call ⚫ The failure to set up a call (both mobile originated or terminated) ⚫ The failure to modify a call by using supplementary services ⚫ The failure to activate, register, query, deactivate or deregister a supplementary service ⚫ The failure to attach to a GPRS network or the failure to activate a PDP context ⚫ The failure to detach from a GPRS network or the failure to deactivate a PDP context AT+CEER Report Extended Error Test Command AT+CEER=? Execution Command AT+CEER Response OK Response +CEER: EG060V-EA&EG060W-EA_AT_Commands_Manual 28 / 167 LTE-A Module Series Maximum Response Time Characteristics OK If there is any error: +CME ERROR: Or ERROR 300 ms / Parameter String type. Cause of the last failure in setting up or releasing a CS or PS domain call. Possible causes are listed in Chapter 12.6. Cause data is captured from Call Manager events and cached locally for later use by this command. Error codes. For more details, refer to Chapter 12.2. 3.3. AT+QCFG Extended Configuration Settings This command queries and configures various UE settings. AT+QCFG Extended Configuration Settings Test Command AT+QCFG=? Response +QCFG: 'usbnet',(list of supported s) +QCFG: 'devmode',(list of supported s) +QCFG: 'IMS',(list of supported s) +QCFG: 'nwscanmode',(range of supported s) +QCFG: 'band',(list of supported s),(list of supported s) +QCFG: 'servicedomain',(range of supported s) +QCFG: 'nat',(list of supported s) +QCFG: 'tone/incoming',(list of supported s) +QCFG: 'roamservice',(list of supported s) +QCFG: 'nwscanseq',(range of supported s) Maximum Response Time OK 300 ms EG060V-EA&EG060W-EA_AT_Commands_Manual 29 / 167 LTE-A Module Series 3.3.1. AT+QCFG='usbnet' USB Network Card Configuration This command specifies a protocol for the USB network card. AT+QCFG='usbnet' USB Network Card configuration Write Command AT+QCFG='usbnet'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'usbnet', OK If the optional parameter is specified, configure the network card mode: OK Maximum Response Time Characteristics If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. Protocol type specified for the USB network card. 1 ECM 3 RNDIS 4 NCM Error codes. For more details, refer to Chapter 12.2. 3.3.2. AT+QCFG='devmode' Device Mode Configuration This command configures the device mode. The configuration will take effect after module resets. AT+QCFG='devmode' Device Mode Configuration Write Command AT+QCFG='devmode'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'devmode', EG060V-EA&EG060W-EA_AT_Commands_Manual 30 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK If the optional parameter is specified, configure the device mode of UE: OK If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. The mode of device. 0 Router mode 1 NIC mode Error codes. For more details, refer to Chapter 12.2. 3.3.3. AT+QCFG='IMS' IMS Service Configuration This command specifies IMS service configuration. AT+QCFG='IMS' IMS Service Configuration Write Command AT+QCFG='IMS'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'IMS', OK If the optional parameter is specified, enable/disable VoLTE function: OK If there is any error: +CME ERROR: Or EG060V-EA&EG060W-EA_AT_Commands_Manual 31 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. 0 Disable IMS service 1 Enable IMS service Error codes. For more details, refer to Chapter 12.2. 3.3.4. AT+QCFG='nwscanmode' Configure Network Search Mode This command specifies the network search mode. AT+QCFG='nwscanmode' Configure Network Search Mode Write Command AT+QCFG='nwscanmode'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'nwscanmode', OK If the optional parameter is specified, configure a network mode to search for: OK Maximum Response Time Characteristics If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. EG060V-EA&EG060W-EA_AT_Commands_Manual 32 / 167 LTE-A Module Series Parameter Integer type. Network search mode. 0 AUTO 1 GSM only (not supported by EG060W-EA) 2 WCDMA only 3 LTE only Error codes. For more details, refer to Chapter 12.2. Example AT+QCFG='nwscanmode',0 OK AT+QCFG='nwscanmode' +QCFG: 'nwscanmode',0 OK //Configure to AUTO mode. //Query the current network search mode. 3.3.5. AT+QCFG='band' Band Configuration This command specifies the preferred frequency bands to search for. AT+QCFG='band' Band Configuration Write Command AT+QCFG='band'[,,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'band',, OK If the optional parameter is specified, configure the preferred frequency bands to search for: OK Maximum Response Time Characteristics If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. EG060V-EA&EG060W-EA_AT_Commands_Manual 33 / 167 LTE-A Module Series Parameter String type. A hexadecimal value that specifies the preferred GSM and WCDMA frequency bands. Here is an example: 00000013=00000001(GSM900)+00000002(GSM1800)+00000010(WCDMA2100). If it is set to 0, it means there is no change to the preferred GSM and WCDMA frequency bands specified previously. 00000000 No change 00000001 GSM 900 B8 00000002 GSM 1800 B3 00000004 GSM 850 B5 00000010 WCDMA 2100 B1 00000040 WCDMA 850 B5 00000080 WCDMA 900 B8 0000FFFF Any frequency band String type. A hexadecimal value that specifies the preferred LTE frequency bands. If it is set to 0 or 0x40000000, it means there is no change to the preferred LTE frequency bands specified previously, e.g., 0x15 = 0x1(LTE B1) + 0x4(LTE B3) + 0x10(LTE B5). 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x40 (CM_BAND_PREF_LTE_EUTRAN_BAND7) LTE B7 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 0x80000 (CM_BAND_PREF_LTE_EUTRAN_BAND20) LTE B20 0x8000000 (CM_BAND_PREF_LTE_EUTRAN_BAND28) LTE B28 0x2000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND38) LTE B38 0x8000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND40) LTE B40 0x10000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND41) LTE B41 0x7FFFFFFFFFFFFFFF(CM_BAND_PREF_ANY) Any frequency band Error codes. For more details, refer to Chapter 12.2. 3.3.6. AT+QCFG='servicedomain' Configure Service Domain This command configures the service domain of UE. AT+QCFG='servicedomain' Configure Service Domain Write Command AT+QCFG='servicedomain'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'servicedomain', OK EG060V-EA&EG060W-EA_AT_Commands_Manual 34 / 167 LTE-A Module Series Maximum Response Time Characteristics If the optional parameter is specified, configure the service domain of UE: OK If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Service domain of UE. 0 CS only 1 PS only 2 CS&PS Error codes. For more details, refer to Chapter 12.2. Example AT+QCFG='servicedomain',2 OK AT+ QCFG='servicedomain' +QCFG: 'servicedomain',2 OK //Configure service domain as CS&PS. //Query service domain. 3.3.7. AT+QCFG='nat' Configure Dial-up Mode This command queries or configures the dial-up mode of USBnet. AT+QCFG='nat' Configure Dial-up Mode Write Command AT+QCFG='nat'[,] Response If the optional parameter is omitted, query the current setting. +QCFG: 'nat', OK If the optional parameter is specified, configure the dial-up mode. EG060V-EA&EG060W-EA_AT_Commands_Manual 35 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. Dial-up mode. 0 Router mode 1 NIC mode Error codes. For more details, refer to Chapter 12.2. Example AT+QCFG='nat',1 OK //Configure the dial-up mode as NIC mode. 3.3.8. AT+QCFG='tone/incoming' Enable/Disable Ringing Tone This command enables or disables the ringing tone function. And the configuration will take effect immediately. AT+ QCFG='tone/incoming' Enable/Disable Ringing Tone Write Command AT+QCFG='tone/incoming'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'tone/incoming', OK If the optional parameter is specified, enable/disable the ringing tone function: OK If there is any error: EG060V-EA&EG060W-EA_AT_Commands_Manual 36 / 167 LTE-A Module Series Maximum Response Time Characteristics +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Disable ring tone 1 Enable ring tone Error codes. For more details, refer to Chapter 12.2. 3.3.9. AT+QCFG='roamservice' Roam Service Configuration The command enables or disables the roam service. AT+QCFG='roamservice' Roam Service Configuration Write Command AT+QCFG='roamservice'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'roamservice', OK If the optional parameter is specified, enable/disable the roam service: OK Maximum Response Time Characteristics If there is any error: ERROR Or +CME ERROR: 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Enable/Disable the roam service. EG060V-EA&EG060W-EA_AT_Commands_Manual 37 / 167 LTE-A Module Series 1 Disable 2 Enable Error codes. For more details, refer to Chapter 12.2. Example AT+QCFG='roamservice' +QCFG: 'roamservice',2 OK AT+QCFG='roamservice',1 OK 3.3.10. AT+QCFG='nwscanseq' Configure Network Search Sequence This command configures the network search sequence. AT+QCFG='nwscanseq' Configure Network Search Sequence Write Command AT+QCFG='nwscanseq'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'nwscanseq', OK If the optional parameter is specified, configure a network sequence to search for: OK Maximum Response Time Characteristics If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Network search mode. 0 AUTO 1 GSM only EG060V-EA&EG060W-EA_AT_Commands_Manual 38 / 167 LTE-A Module Series 2 WCDMA only 3 LTE only 4 GSM & WCDMA & LTE (GSM preferred) 5 GSM & WCDMA & LTE (WCDMA preferred) 6 WCDMA & LTE (LTE preferred) 7 GSM & LTE (LTE preferred) 8 WCDMA & LTE (WCDMA preferred) 9 GSM & WCDMA (WCDMA preferred) 10 GSM & LTE (GSM preferred) 11 GSM & WCDMA (GSM preferred) 12 GSM & WCDMA & LTE (LTE preferred) Error codes. For more details, refer to Chapter 12.2. Example AT+QCFG='nwscanseq',0 OK AT+QCFG='nwscanseq' +QCFG: 'nwscanseq',0 //Configure to AUTO mode. //Query the current network search sequence. OK EG060V-EA&EG060W-EA_AT_Commands_Manual 39 / 167 LTE-A Module Series 4 (U)SIM Related Commands 4.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) This command requests the International Mobile Subscriber Identity (IMSI) which is intended to permit the TE to identify the individual SIM card or the active application that is attached to MT. AT+CIMI Request International Mobile Subscriber Identity (IMSI) Test Command AT+CIMI=? Response OK Execution Command AT+CIMI Response TA returns for identifying the (U)SIM attached to ME. OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: +CME ERROR: Or ERROR 300 ms / Parameter International Mobile Subscriber Identity (string without double quotes). Error codes. For more details, refer to Chapter 12.2. Example AT+CIMI 460023210226023 OK //Query IMSI number of the (U)SIM attached to ME. EG060V-EA&EG060W-EA_AT_Commands_Manual 40 / 167 LTE-A Module Series 4.2. AT+CLCK Facility Lock This command locks, unlocks or queries an MT or a network facility . It can be aborted when network facilities are being set or queried. Password is normally needed to do such operations. The factory default password of PF, PN, PU, PP and PC lock is '12341234'. When querying the status of a network service (=2), the response line for ‘not active’ case (=0) should be returned only if the service is not active for any . AT+CLCK Facility Lock Test Command AT+CLCK=? Response +CLCK: (list of supported s) Write Command AT+CLCK=,[,[ ,]] OK Response If is 0 or 1 and the command is set successfully: OK If =2 and command is set successfully: +CLCK: [,] […] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 5 s The command takes effect immediately. The configuration is saved automatically. Parameter String type. 'SC' (U)SIM (lock SIM/UICC card installed in the currently selected card slot) (SIM/UICC asks password in MT power-up and when this command is issued). 'CS' CNTRL (lock CoNTRoL surface (e.g. phone keyboard)) 'PS' PH-SIM (lock PHone to SIM card) (ME asks password when other than current SIM card inserted; ME may remember certain amount of previously used cards thus not requiring password when they are inserted) 'PF' Lock Phone to the very First inserted SIM card (also referred as PH-FSIM) (ME asks for password when a SIM card other than the first inserted one is inserted) 'AO' BAOC (Bar All Outgoing Calls) (refer to 3GPP TS 22.088 clause 1) 'OI' BOIC (Bar Outgoing International Calls) (refer to 3GPP TS 22.088 clause 1) 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country) (refer to EG060V-EA&EG060W-EA_AT_Commands_Manual 41 / 167 LTE-A Module Series 3GPP TS 22.088 clause 1) 'AI' BAIC (Bar All Incoming Calls) (refer to 3GPP TS 22.088 clause 2) 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (refer to 3GPP TS 22.088 clause 2) 'NT' Bar incoming calls from numbers Not stored to TA memory 'NM' Bar incoming calls from numbers Not stored to ME memory 'NS' Bar incoming calls from numbers Not stored to SIM memory 'NA' Bar incoming calls from numbers Not stored in Any memory 'AB' All Barring services (refer to 3GPP TS 22.030) (applicable only for =0) 'AG' All outgoing barring services (refer to 3GPP TS 22.030) (applicable only for =0) 'AC' All incoming barring services (refer to 3GPP TS 22.030) (applicable only for =0) 'FD' SIM card or active application in the UICC (GSM or USIM) fixed dialing memory feature (if PIN2 authentication has not been done during the current session, PIN2 is required as ) 'PN' Network Personalization (refer to 3GPP TS 22.022) 'PU' Network Subset Personalization (refer to 3GPP TS 22.022) 'PP' Service Provider Personalization (refer to 3GPP TS 22.022) 'PC' Corporate Personalization (refer to 3GPP TS 22.022) Integer type. 0 Unlock 1 Lock 2 Query status String type. Password. Integer type. 1 Voice 2 Data 4 FAX 7 All telephony except SMS (Default) 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization Integer type. Facility status. 0 Off 1 On Example AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' //Query the status of (U)SIM card. //The (U)SIM card is unlocked (OFF). //Lock (U)SIM card, and the password is 1234. EG060V-EA&EG060W-EA_AT_Commands_Manual 42 / 167 OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK LTE-A Module Series //Query the status of (U)SIM card. //The (U)SIM card is locked (ON). //Unlock (U)SIM card. 4.3. AT+CPIN Enter PIN This command enters a password or queries whether or not the module requires a password so that it can be operated. The password may be (U)SIM PIN, (U)SIM PUK, PH-SIM PIN, etc. This Read Command returns an alphanumeric string indicating whether or not some password is required. TA stores a password, such as (U)SIM PIN, (U)SIM PUK, etc., which is necessary for it to be operated. TA shall automatically repeat a PIN that is entered for a second time. If no PIN request is pending, no action is taken and an error message +CME ERROR is returned to TE. If the PIN required is (U)SIM PUK or (U)SIM PUK2, the second pin is required. This second pin is used to replace the old pin in the (U)SIM. AT+CPIN Enter PIN Test Command AT+CPIN=? Read Command AT+CPIN? Response OK Response +CPIN: Write Command AT+CPIN=[,] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 5 s The command takes effect immediately. The configuration is saved automatically. EG060V-EA&EG060W-EA_AT_Commands_Manual 43 / 167 LTE-A Module Series Parameter String without double quotes. Type of the password MT requires. READY MT is not pending for any password SIM PIN MT is waiting for (U)SIM PIN to be given SIM PUK MT is waiting for (U)SIM PUK to be given SIM PIN2 MT is waiting for (U)SIM PIN2 to be given SIM PUK2 MT is waiting for SIM PUK2 to be given PH-NET PIN MT is waiting for network personalization password to be given PH-NET PUK MT is waiting for network personalization unblocking password to be given PH-NETSUB PIN MT is waiting for network subset personalization password to be given PH-NETSUB PUK MT is waiting for network subset personalization unblocking password to be given PH-SP PIN MT is waiting for service provider personalization password to be given PH-SP PUK MT is waiting for service provider personalization unblocking password to be given PH-CORP PIN MT is waiting for corporate personalization password to be given PH-CORP PUK MT is waiting for corporate personalization unblocking password to be given String type. Password. If the requested password is a PUK, such as (U)SIM PUK, then must be followed by . String type. New password required when the requested code is a PUK. Example //Enter PIN. AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Enter PUK and PIN. AT+CPIN? //A PIN code is required. //Enter PIN. //PIN has already been entered. EG060V-EA&EG060W-EA_AT_Commands_Manual 44 / 167 +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //A PUK code is required. LTE-A Module Series //Enter PUK and a new PIN password. //PUK has already been entered. 4.4. AT+CPWD Change Password This command sets a new password for the facility lock function defined by AT+CLCK. This Test Command returns a list of pairs which present the available facilities and the maximum length of their password. AT+CPWD Change Password Test Command AT+CPWD=? Response +CPWD: (list of supported s),(s) Write Command AT+CPWD=,, Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 5 s The command takes effect immediately. The configuration is saved automatically. Parameter String type. Facility values. 'SC' (U)SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command is issued) 'AO' BAOC (Bar All Outgoing Calls, refer to 3GPP TS 22.088 clause 1) 'OI' BOIC (Bar Outgoing International Calls, refer to 3GPP TS 22.088 clause 1) 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country, refer to EG060V-EA&EG060W-EA_AT_Commands_Manual 45 / 167 LTE-A Module Series 3GPP TS 22.088 clause 1) 'AI' BAIC (Bar All Incoming Calls, refer to 3GPP TS 22.088 clause 2) 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country, refer to 3GPP TS 22.088 clause 2) 'AB' All barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AG' All outgoing barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AC' All incoming barring services (refer to 3GPP TS 22.030, applicable only for =0) 'P2' (U)SIM PIN2 Integer type. Maximum length of password. String type. Old password specified for the facility from the user interface or with command. String type. New password. Example AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' //Change (U)SIM card password from '1234' to '4321'. OK //Reboot the module or re-activate the SIM card. AT+CPIN? //Query the type of PIN code required. +CPIN: SIM PIN OK AT+CPIN='4321' OK //Enter the new PIN to re-activate the SIM card. +CPIN: READY 4.5. AT+CSIM Generic (U)SIM Access This command allows a direct control of the (U)SIM that is installed in the currently selected card slot by a distant application on the TE. The TE shall then keep the processing of (U)SIM information within the frame specified by GSM/UMTS. AT+CSIM Generic (U)SIM Access Test Command AT+CSIM=? Response OK EG060V-EA&EG060W-EA_AT_Commands_Manual 46 / 167 LTE-A Module Series Write Command AT+CSIM=, Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response +CSIM: , OK If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Length of or string. Command transferred by MT to (U)SIM in the format described in 3GPP TS 51.011. Response to the command transferred by the (U)SIM to the MT in the format as described in 3GPP TS 51.011. 4.6. AT+CRSM Restricted (U)SIM Access This command offers easy but limited access to the (U)SIM database. It transmits the (U)SIM command number and its required parameters to the MT. AT+CRSM Restricted (U)SIM Access Test Command AT+CRSM=? Write Command AT+CRSM=[,[,,,[,][,]]] Response OK Response +CRSM: ,[,] OK Maximum Response Time If there is any error: +CME ERROR: Or ERROR 300 ms EG060V-EA&EG060W-EA_AT_Commands_Manual 47 / 167 LTE-A Module Series Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configuration is saved automatically. Parameter , , , (U)SIM command number. 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS Integer type. Identifier for an elementary data file on (U)SIM, if used by . Integer type. Parameters transferred by the MT to the (U)SIM. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in 3GPP TS 51.011. Information which shall be written to the (U)SIM (hexadecimal character format; refer to AT+CSCS). The directory path of an elementary file on a UICC in hexadecimal format. Integer type. Information from the (U)SIM about the execution of the actual command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command. Response of a successful completion of the command previously issued (hexadecimal character format; refer to AT+CSCS). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. The information includes the type of file and its size (refer to 3GPP TS 51.011). After READ BINARY, READ RECORD or RETRIEVE DATA command, the requested data will be returned. is not returned after a successful UPDATE BINARY, UPDATE RECORD or SET DATA command. Error codes. For more details, refer to Chapter 12.2. 4.7. AT+QCCID Show ICCID This command returns the ICCID (Integrated Circuit Card Identifier) number of (U)SIM card. AT+QCCID Show ICCID Test Command AT+QCCID=? Response OK EG060V-EA&EG060W-EA_AT_Commands_Manual 48 / 167 Execution Command AT+QCCID Maximum Response Time Characteristics Response +QCCID: OK Or ERROR 300 ms / LTE-A Module Series Parameter String without double quotes. ICCID (Integrated Circuit Card Identifier) number of the (U)SIM card. Example AT+QCCID //Query ICCID of the (U)SIM card. +QCCID: 89860025128306012474 OK 4.8. AT+QSIMDET (U)SIM Card Detection This command enables (U)SIM card hot-swap function. (U)SIM card is detected by GPIO interrupt. The level of (U)SIM card detection pin when the (U)SIM card is inserted should also be set. AT+ QSIMDET (U)SIM Card Detection Test Command AT+QSIMDET=? Response +QSIMDET: (list of supported s),(list of supported s) Read Command AT+QSIMDET? OK Response +QSIMDET: , Write Command AT+QSIMDET=, OK Response OK Or ERROR EG060V-EA&EG060W-EA_AT_Commands_Manual 49 / 167 LTE-A Module Series Maximum Response Time Characteristics 300 ms The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. Integer type. Enable or disable (U)SIM card detection. 0 Disable 1 Enable Integer type. The level of (U)SIM detection pin when a (U)SIM card is inserted. 0 Low level 1 High level ⚫NOTE Hot-swap function is invalid if the value of is inconsistent with your hardware design. 4.9. AT+QSIMSTAT (U)SIM Insertion Status Report This command queries (U)SIM card insertion status or determines whether to report (U)SIM card insertion status. AT+QSIMSTAT (U)SIM Insertion Status Report Test Command AT+QSIMSTAT=? Response +QSIMSTAT: (list of supported s) Read Command AT+QSIMSTAT? OK Response +QSIMSTAT: , Write Command AT+QSIMSTAT= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms / EG060V-EA&EG060W-EA_AT_Commands_Manual 50 / 167 LTE-A Module Series Parameter Integer type. Enable or disable (U)SIM inserted status report. If it is enabled, when (U)SIM card is removed or inserted, the URC below will be reported: +QSIMSTAT: ,. 0 Disable 1 Enable Integer type. (U)SIM card status. This argument is not allowed to be set. 0 Removed 1 Inserted 2 Unknown, before (U)SIM initialization Example AT+QSIMSTAT? +QSIMSTAT: 0,1 OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 OK //Remove the (U)SIM card. +QSIMSTAT: 1,0 +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK //Insert a (U)SIM card. +QSIMSTAT: 1,1 +CPIN: READY //Query (U)SIM card insertion status. //Enable (U)SIM card insertion status report. //Report (U)SIM card insertion status: removed. //Report (U)SIM card insertion status: inserted. EG060V-EA&EG060W-EA_AT_Commands_Manual 51 / 167 LTE-A Module Series 5 Network Service Commands 5.1. AT+COPS Operator Selection This command returns the current operators and their status, and allows setting automatic or manual network selection. This Test Command returns a set of five parameters, each representing an operator presenting in the network. Any of the formats may be unavailable and should then be an empty field. The list of operators shall be in the order of: home network, networks referenced in (U)SIM and other networks. This Read Command returns the current mode and the currently selected operator. If no operator is selected, , and are omitted. This Write Command forces an attempt to select and register the GSM/UMTS network operator. If the selected operator is not available, no other operator shall be selected (except =4). The format of selected operator name shall apply to further Read Command (AT+COPS?). AT+COPS Operator Selection Test Command AT+COPS=? Response +COPS: [(list of supported ,long alphanumeric ,short alphanumeric ,numeric s[,])s][,,(range of supported s),(range of support ed s)] OK Read Command AT+COPS? If there is any error: +CME ERROR: Or ERROR Response +COPS: [,[,][,]] OK If there is any error: EG060V-EA&EG060W-EA_AT_Commands_Manual 52 / 167 LTE-A Module Series Write Command AT+COPS=[,[,[ ,]]] +CME ERROR: Or ERROR Response OK If there is any error: +CME ERROR: Or ERROR Maximum Response Time 180 s, determined by network. Characteristics / Reference 3GPP TS 27.007 Parameter Integer type. Operator status. 0 Unknown 1 Operator available 2 Current operator 3 Operator forbidden Strig type. Operator in format as per . Integer type. 0 Automatic mode. field is ignored 1 Manual operator selection. field shall be present and optionally 2 Manually deregister from network 3 Set only (for AT+COPS? Read Command), and do not attempt registration/deregistration ( and fields are ignored). This value is invalid in the response of Read Command 4 Manual/automatic selection. field shall be presented. If manual selection fails, automatic mode (=0) is entered Integer type. 0 Long format alphanumeric which can be up to 16 characters long 1 Short format alphanumeric 2 Numeric . GSM location area identification number Integer type. Access technology selected. Values 3, 4, 5 and 6 occur only in the response of Read Command while MS is in data service state and are not intended for the AT+COPS Write Command. 0 GSM 2 UTRAN 3 GSM W/EGPRS EG060V-EA&EG060W-EA_AT_Commands_Manual 53 / 167 LTE-A Module Series 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 8 UTRAN HSPA+ Error codes. For more details, refer to Chapter 12.2. Example AT+COPS=? //List all the current network operators. +COPS: (1,'CHN-UNICOM','UNICOM','46001',2),(1,'CHN-UNICOM','UNICOM','46001',0),(2,'CHN-UNICO M','UNICOM','46001',7),(1, 'CHN-CT', 'CT','46011',7),(3,'CHINA MOBILE','CMCC','46000',0),,(0-4),(0-2) OK AT+COPS? +COPS: 0,0,'46000',7 //Query the currently selected network operator. OK 5.2. AT+CREG Network Registration Status The Read Command returns the status of result code presentation and an integer which shows whether the network has currently indicated the registration of the ME. Location information elements and are returned only when =2 and ME is registered on the network. The Write Command controls the presentation of an unsolicited result code +CREG: when =1 and there is a change in the ME network registration status. AT+CREG Network Registration Status Test Command AT+CREG=? Response +CREG: (list of supported s) Read Command AT+CREG? OK Response +CREG: ,[,,[,]] OK If there is any error related to ME functionality: +CME ERROR: EG060V-EA&EG060W-EA_AT_Commands_Manual 54 / 167 LTE-A Module Series Write Command AT+CREG=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 Or ERROR Response OK 300 ms / Parameter Integer type. Whether to enable network registration URC. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code: +CREG: 2 Enable network registration unsolicited result code with location information: +CREG: [,,[,]] Integer type. Registration status. 0 Not registered. ME is not currently searching a new operator to register to 1 Registered, home network 2 Not registered, but ME is currently searching a new operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two bytes location area code in hexadecimal format. String type. 16-bit (GSM) or 28-bit (UMTS/LTE) cell ID in hexadecimal format. Integer type. Access technology selected. 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 8 UTRAN HSPA+ Error codes. For more details, refer to Chapter 12.2. Example AT+CREG=2 OK AT+CREG? +CREG: 2,1,'550c','5a29c0b',7 //Activate extended URC mode. //URC reporting MT has registered on an E-UTRAN network. EG060V-EA&EG060W-EA_AT_Commands_Manual 55 / 167 LTE-A Module Series OK 5.3. AT+CSQ Signal Quality Report This command indicates the received signal strength and the channel bit error rate . This Test Command returns values supported by the TA. This Execution Command returns received signal strength indication and channel bit error rate from the ME. AT+CSQ Signal Quality Report Test Command AT+CSQ=? Response +CSQ: (list of supported s),(list of supported s) Execution Command AT+CSQ OK Response +CSQ: , OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: +CME ERROR: Or ERROR 300 ms / Parameter Integer type. Received signal strength indicator. 0 -113dBm or less 1 -111dBm 2...30 -109dBm... -53dBm 31 -51dBm or greater 99 Not known or not detectable Integer type. Channel bit error rate (in percent). 0...7 As RXQUAL values in the table in 3GPP TS 45.008 subclause 8.2.4 99 Not known or not detectable Error codes. For more details, refer to Chapter 12.2. EG060V-EA&EG060W-EA_AT_Commands_Manual 56 / 167 LTE-A Module Series Example AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,99 //The received signal strength indicator is 28 and the channel bit error rate is 99. OK 5.4. AT+CPOL Preferred Operator List This command edits and queries the list of preferred operators. AT+CPOL Preferred Operator List Test Command AT+CPOL=? Response +CPOL: (list of supported s),(list of supported s) Read Command AT+CPOL? OK Response Query the list of preferred operators: +CPOL: ,,[,,,,] ,,[,,,,] […] Write Command AT+CPOL=[,[,[,, ,]]] OK Response Edit the list of preferred operators: OK If there is any error: +CME ERROR: Or ERROR Maximum Response Time Characteristics If is given but is left out, the entry is deleted. 300 ms / EG060V-EA&EG060W-EA_AT_Commands_Manual 57 / 167 LTE-A Module Series Reference 3GPP TS 27.007 Parameter Integer type. The order number of operators in (U)SIM preferred operator list. 0 Long format alphanumeric 1 Short format alphanumeric 2 Numeric String type. indicates the format is alphanumeric or numeric (see AT+COPS). Integer type. GSM access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. GSM compact access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. UTRAN access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. E-UTRAN access technology. 0 Access technology is not selected 1 Access technology is selected Error codes. For more details, refer to Chapter 12.2. NOTE The access technology selection parameters , , and are required when UE selects the PLMN selector and access technology for its (U)SIM card. 5.5. AT+COPN Read Operator Names This command returns the list of operator names from the ME. Each operator code that has an alphanumeric equivalent in the ME memory is returned. AT+COPN Read Operator Names Test Command AT+COPN=? Execution Command AT+COPN Response OK Response +COPN: , EG060V-EA&EG060W-EA_AT_Commands_Manual 58 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 [+COPN: ,] […] OK If there is error related to MT functionality: +CME ERROR: Depends on the number of operator names. / Parameter String type. Operator in numeric format (see AT+COPS). String type. Operator in long alphanumeric format (see AT+COPS). Error codes. For more details, refer to Chapter 12.2. 5.6. AT+CTZU Automatic Time Zone Update This Write Command enables and disables automatic time zone update via NITZ. AT+CTZU Automatic Time Zone Update Test Command AT+CTZU=? Response +CTZU: (list of supported s) Write Command AT+CTZU= Read Command AT+CTZU? OK Response OK Or ERROR Response +CTZU: Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / EG060V-EA&EG060W-EA_AT_Commands_Manual 59 / 167 LTE-A Module Series Parameter Integer type. The mode of automatic time zone update. 0 Disable automatic time zone update via NITZ 1 Enable automatic time zone update via NITZ and update GMT time to URC Example AT+CTZU? +CTZU: 1 OK AT+CTZU=? +CTZU: (0,1) OK AT+CTZU=0 OK AT+CTZU? +CTZU: 0 OK 5.7. AT+CTZR Time Zone Reporting This command controls the time zone reporting when event changes. If reporting is enabled, the MT returns the unsolicited result code +CTZV: or +CTZE: ,, whenever the time zone is changed. The configuration is stored to flash automatically. AT+CTZR Time Zone Reporting Test Command AT+CTZR=? Response +CTZR: (list of supported s) Write Command AT+CTZR= Read Command AT+CTZR? OK Response OK Or ERROR Response +CTZR: OK EG060V-EA&EG060W-EA_AT_Commands_Manual 60 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 300ms / Parameter Integer type. The mode of time zone reporting. 0 Disable time zone reporting of changed event 1 Enable time zone reporting of changed event by unsolicited result code: +CTZV: 2 Enable extended time zone reporting by unsolicited result code: +CTZE: ,, String type. Sum of the local time zone (difference between the local time and GMT is expressed in quarters of an hour) plus daylight saving time. The format is '±zz', expressed as a fixed-width, two-digit integer from -48 to +56. To maintain a fixed width, numbers from -9 to +9 are expressed with a leading zero, e.g. '-09', '+00' and '+09'. Integer type. Indicates whether includes daylight savings adjustment. 0 includes no adjustment for daylight saving time 1 includes +1 hour (i.e. 4 quarters in ) adjustment for daylight saving time 2 includes +2 hours (i.e. 8 quarters in ) adjustment for daylight saving time String type. The local time. The format is 'YYYY/MM/DD,hh:mm:ss', expressed as integers representing year (YYYY), month (MM), date (DD), hour (hh), minute (mm) and second (ss). This parameter can be provided by the network when delivering time zone information and be presented in the URC of extended time zone reporting. 5.8. AT+QSPN Query the Service Provider Name This command queries the service provider name. AT+QSPN Query the Service Provider Name Test Command AT+QSPN=? Execution Command AT+QSPN Response OK Response +QSPN: ,,,, Maximum Response Time OK 300 ms EG060V-EA&EG060W-EA_AT_Commands_Manual 61 / 167 LTE-A Module Series Characteristics / Parameter String type. Full name of network. String type. Shortened name of network. String type. Service provider name. Integer type. Alphabet of full and shortened network name. 0 GSM 7-bit default alphabet 1 UCS2 String type. Registered PLMN. NOTE 1. If is 0, and will be shown in GSM 7-bit default alphabet string. 2. If is 1, and will be shown in UCS2 hexadecimal string. Example AT+QSPN //Query the service provider name. +QSPN: 'CHN-UNICOM','UNICOM','',0,'46001' OK 5.9. AT+QNWINFO Query Network Information This command indicates network information such as the access technology, the operator and the band selected. AT+QNWINFO Query Network Information Test Command AT+QNWINFO=? Response OK Execution Command AT+QNWINFO Response +QNWINFO: ,,, Maximum Response Time Characteristics OK 300 ms / EG060V-EA&EG060W-EA_AT_Commands_Manual 62 / 167 Parameter LTE-A Module Series String type. The access technology selected. 'NONE' 'HDR' 'HDR-EHRPD' 'GSM' 'GPRS' 'EDGE' 'WCDMA' 'HSDPA' 'HSUPA' 'HSPA+' 'TDD LTE' 'FDD LTE' String type. The operator in numeric format. String type. The band selected. 'GSM 850' 'GSM 900' 'GSM 1800' 'WCDMA 2100' 'WCDMA 850' 'WCDMA 900' 'LTE BAND 1' – 'LTE BAND 41' Integer type. Channel ID. 5.10. AT+QNWLOCK='common/lte' Network Locking Configuration This command locks the module to a specified frequency or cell. AT+QNWLOCK='common/lte' Network Locking Configuration Test Command AT+QNWLOCK=? Response +QNWLOCK: 'common/lte',(range of supported s),< EARFCN>,,(list of supported s) Write Command AT+QNWLOCK='common/lte'[,< action>[,,]] OK Response If the optional parameters are omitted, query the current setting: +QNWLOCK: 'common/lte',,,, OK EG060V-EA&EG060W-EA_AT_Commands_Manual 63 / 167 LTE-A Module Series Maximum Response Time Characteristics If the optional parameters are specified, lock the module to a specified frequency or cell: OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. 0 Unlock the cell 1 Lock LTE cell through appointed EARFCN 2 Lock LTE cell through appointed EARFCN and PSC Integer type. Default value: 0. The appointed EARFCN of the cell to be locked. Integer type. Default value: 0. The appointed PCI of the cell to be locked. Integer type. Default value: 0. 0 Cell locking or unlocking finished 1 Cell locking or unlocking failed NOTE 1. The module can be unlocked from a cell after you set to 0 and reboot it. 2. The module needs to be fixed to LTE-only with AT+QCFG='NWSCANMODE',3 before it can be locked to an LTE cell with AT+QNWLOCK . 5.11. AT+QENG Query Primary Serving Cell and Neighbor Cell Information This command obtains the primary serving cell and neighbor cell information. AT+QENG Query Primary Serving Cell and Neighbor Cell Information Test Command AT+QENG=? Response +QENG: (list of supported s) Query the information of serving cell AT+QENG='servingcell' OK Response In GSM mode: EG060V-EA&EG060W-EA_AT_Commands_Manual 64 / 167 LTE-A Module Series +QENG: 'servingcell',,'GSM',,,,,,,,,,, ,,,,,,,,, ,,,, In LTE mode: +QENG: 'servingcell',,'LTE',,,< MNC>,,,,,,,,,,,, In WCDMA mode: +QENG: 'servingcell',,'WCDMA',,,,,,,,,,,,,, Query the information of neighbor cells AT+QENG='neighbourcell' OK Response In GSM mode: [+QENG: 'neighbourcell','GSM',,,, ,,,,,,, …] In LTE mode: [+QENG: 'neighbourcell intra','LTE',,,< RSRQ>,,,,,,,, …] [+QENG: 'neighbourcell inter','LTE',,,< RSRQ>,,,,,,, …] [+QENG: 'neighbourcell','WCDMA',,,,,,, …] In WCDMA mode: [+QENG: 'neighbourcell','WCDMA',,, ,,,,, …] [+QENG: 'neighbourcell','LTE',,,,, …] OK 300 ms / Parameter String format. The information of different cells. 'servingcell' The information of 3G/4G serving cells 'neighbourcell' The information of 3G/4G neighbour cells String format. UE state. 'SEARCH' UE is searching but has not found a suitable 3G/4G cell. 'LIMSRV' UE is camping on a cell but has not registered on the network. 'NOCONN' UE has camped on a cell and registered on the network, and it is in idle mode. 'CONNECT' UE has camped on a cell and registered on the network, and a call is in progress. LTE TDD or FDD mode. Integer type. Mobile Country Code (first part of the PLMN code). '-' Invalid Integer type. Mobile Network Code (second part of the PLMN code). '-' Invalid Hexadecimal format. Location Area Code. The parameter determines the two bytes location area code in hexadecimal format (e.g. 00C1 equals 193 in decimal) of the cell that was scanned. Range: 0-65535. Hexadecimal format. Cell ID. The parameter determines the 16-bit (GSM) or 28-bit (UMTS) cell ID. Range: 0–0xFFFFFFF. '-' Invalid Integer type. Base Station Identification Code. Range: 0-63. Integer type. The parameter determines the ARFCN of the cell that was scanned. Range: 0–1023. Physical cell ID. Integer type. Indicate the current band is PCS1900 or DCS1800. 0 DCS_1800 1 PCS_1900 '-' Other band Integer type. Routing Area Code. Range 0–255. Primary frequency. Integer type. RX level value for base station selection in dB (see 3GPP 25.304). RX level range: 0–63, subtract 111 to dBm value. EG060V-EA&EG060W-EA_AT_Commands_Manual 66 / 167 LTE-A Module Series Integer type. MS maximum TX power in CCH. Integer type. Minimum access RX level. Integer type. Discontinuous reception cycle length. Integer type. Cell selection criterion. Integer type. Cell reselection criterion. Integer type. The parameter determines the UTRA-ARFCN of the cell that was scanned. Integer type. Whether current cell supports GPRS or not. 0 Not support GPRS 1 Support GPRS Integer type. In hopping, displays „h‟, otherwise displays the current ARFCN in voice call. Integer type. Timeslot number. Integer type. Timing advance for the base station. Range: 0–63. Integer type. Mobile Allocation Index Offset. Integer type. Hopping Sequence Number. Integer type. RX quality (sub), range: 0–7. Integer type. RX quality (full), range: 0–7. Integer type. RX level (sub), range: 0–63. Integer type. RX level (full), range: 0–63. String type. Channel mode during voice call. 'HR' Half rate 'FR' Full rate 'EFR' Enhanced full rate 'AMR' Adaptive Multi-Rate 'AMRHR' AMR half rate 'AMRFR' AMR full rate 'AMRWB' AMR wide band '-' Invalid Integer type. The parameter determines the E-UTRA-ARFCN of the cell that was scanned. E-UTRA frequency band (see 3GPP 36.101). Integer type. UL bandwidth. 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz 4 15MHz 5 20MHz Integer type. DL bandwidth. 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz EG060V-EA&EG060W-EA_AT_Commands_Manual 67 / 167 LTE-A Module Series 4 15MHz 5 20MHz Tracking Area Code (see 3GPP 23.003 Section 19.4.2.3). Integer type. The parameter determines the primary scrambling code of the cell that was scanned. Integer type. Routing Area Code. Range 0–255. Integer type. The parameter determines the Received Signal Code Power level of the cell that was scanned. Integer type. Carrier to noise ratio in dB=measured Ec/Io value in dB. Reference Signal Received Power (see 3GPP 36.214 Section 5.1.1). Reference Signal Received Quality (see 3GPP 36.214 Section 5.1.2). Integer type. The parameter shows the Received Signal Strength Indication. Integer type. Logarithmic value of SINR, Values are in 1/5th of a dB. Range:0-250 which translates to -20dB - +30dB. Physical channel 0 DPCH 1 FDPCH Integer type. Spreading factor. 0 SF_4 1 SF_8 2 SF_16 3 SF_32 4 SF_64 5 SF_128 6 SF_256 7 SF_512 8 UNKNOWN Integer type. (0–16): slot format for DPCH. (0–9): slot format for FDPCH. Destination number on which call is to be deflected. Integer type. Compress mode. 0 Not support compress mode 1 Support compress mode Integer type. GPRS cell selection criterion. Integer type. GPRS cell reselection criterion. Receiver automatic gain control on the camped frequency. Integer type. Carrier to noise ratio in dB = measured Ec/Io value in dB. Integer type. 3G neighbour cell set. 1 Active set 2 Synchronous neighbour set 3 Asynchronous neighbour set Rank of this cell as neighbour for inter-RAT cell reselection. To be considered for reselection. The suitable receive level value of an evaluated lower priority cell must be greater than this value. EG060V-EA&EG060W-EA_AT_Commands_Manual 68 / 167 LTE-A Module Series To be considered for reselection. The suitable receive level value of an evaluated higher priority cell must be greater than this value. Reselection threshold for high priority layers. Reselection threshold for low priority layers. Integer type. Select receive level value for base station in dB (see 3GPP 25.304). Cell reselection priority. Range: 0–7. Threshold to control non-intra frequency searches. Specifies the suitable receive level threshold (in dB) used by the UE on the serving cell when reselecting towards a lower priority RAT/frequency. Cell selection parameter for the intra frequency cell. 5.12. AT+QCAINFO Query Carrier Aggregation Parameters This command queries carrier aggregation parameters. AT+QCAINFO Query Carrier Aggregation Parameters Test Command AT+QCAINFO=? Execution Command AT+QCAINFO Response OK Response +QCAINFO: 'pss',,,,,,,,, 'sss',,,,,, ,,, OK Maximum Response Time Characteristics If no secondary cell was active: OK 300 ms / Parameter Primary server cell. Secondary server cell. EARFCN. Integer type. Bandwidth. 6 1.4 MHZ 15 3 MHZ EG060V-EA&EG060W-EA_AT_Commands_Manual 69 / 167 LTE-A Module Series 25 5 MHZ 50 10 MHZ 75 15 MHZ 100 20 MHZ String type. Band information. Integer type. Primary Carrier Component State. 0 No serving 1 Registered Integer type. Secondary Carrier Component State. 0 Deconfigured 1 Configured deactivated 2 Configured activated Integer type. Physical Cell ID. Integer type. Reference Signal Received Power (see 3GPP 36.214 Section 5.1.1). Integer type. Reference Signal Received Quality (see 3GPP 36.214 Section 5.1.2). Integer type. Integer type. The parameter shows the Received Signal Strength Indication. Integer type. Integer type. Logarithmic value of SINR. Values are in 1/5th of a dB. Range: 0-250, which translates to -20 dB to +30 dB. EG060V-EA&EG060W-EA_AT_Commands_Manual 70 / 167 LTE-A Module Series 6 Call Related Commands 6.1. AT+QECCNUM Configure Emergency Call Numbers This command queries, adds and deletes ECC (emergency call) numbers. There are two kinds of ECC numbers: ECC numbers without (U)SIM and ECC numbers with (U)SIM. The default ECC numbers without (U)SIM is 911, 112, 00, 08, 110, 999, 118 and 119. The default ECC number with (U)SIM is 911 and 112. 911 and 112 will always be supported as ECC numbers, and cannot be deleted. ECC numbers can be saved into flash. If the (U)SIM card contains a ECC file, the numbers in the ECC file can also be regarded as ECC numbers. AT+QECCNUM Configure Emergency Call Numbers Test Command AT+QECCNUM=? Response +QECCNUM: (range of supported s) Read Command AT+QECCNUM? OK Response +QECCNUM: 0,[,…] +QECCNUM: 1,[,[…] Write Command AT+QECCNUM=,[,[,,…[,]] ] OK Response If is equal to 0, query the ECC numbers. In this case, should be omitted, and the response is: +QECCNUM: [,,…] OK Maximum Response Time If is not equal to 0: =1 is used to add the ECC number; =2 is used to delete the ECC number. In this case, at least one ECC number should be inputted, and the response is: OK Or ERROR 300 ms EG060V-EA&EG060W-EA_AT_Commands_Manual 71 / 167 LTE-A Module Series Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. ECC number operation mode. 0 Query ECC numbers 1 Add ECC numbers 2 Delete ECC numbers Integer type. ECC number type. 0 ECC numbers without (U)SIM 1 ECC numbers with (U)SIM String type; ECC numbers (e.g.110, 119). Example AT+QECCNUM=? +QECCNUM: (0-2) //Query the supported operation mode for ECC number. OK AT+QECCNUM? //Query the ECC numbers with or without (U)SIM. +QECCNUM: 0,'911','112','00','08','110','999','118','119','000' +QECCNUM: 1,'911','112','000' OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1,'911','112','000' OK AT+QECCNUM=1,1,'110','234' //Add '110' and '234' into the type of ECC numbers with (U)SIM. OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1,'911','112','000','110','234' OK AT+QECCNUM=2,1,'110' //Delete '110' from the type of ECC numbers with (U)SIM. OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1,'911','112','000','234' OK EG060V-EA&EG060W-EA_AT_Commands_Manual 72 / 167 LTE-A Module Series 7 Phonebook Commands 7.1. AT+CNUM Subscriber Number This command gets the subscribers' own number(s) from the (U)SIM. AT+CNUM Subscriber Number Test Command AT+CNUM=? Execution Command AT+CNUM Response OK Response [+CNUM: [],,] [+CNUM: [],,] OK Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error: +CME ERROR: Or ERROR 300 ms / Parameter Optional alphanumeric string associated with . The used character set should be the one selected with AT+CSCS command. String type phone number in the format specified by . Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type Error codes. For more details, refer to Chapter 12.2. EG060V-EA&EG060W-EA_AT_Commands_Manual 73 / 167 LTE-A Module Series 7.2. AT+CPBS Select Phonebook Memory Storage This command selects phonebook memory storage, which is used by other phonebook commands. The Read Command returns the current selected memory, the number of used locations and the total number of locations in the memory supported by manufacturer. The Test Command returns supported storages as compound values. AT+CPBS Select Phonebook Memory Storage Test Command AT+CPBS=? Response +CPBS: (list of supported s) OK Read Command AT+CPBS? If there is any error: +CME ERROR: Or ERROR Response +CPBS: ,, OK Write Command AT+CPBS= If there is any error: +CME ERROR: Or ERROR Response OK Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error: +CME ERROR: Or ERROR 300 ms / EG060V-EA&EG060W-EA_AT_Commands_Manual 74 / 167 LTE-A Module Series Parameter String type. 'SM' (U)SIM phonebook 'FD' (U)SIM fixed dialing phonebook (AT+CPBW operation needs the authority of PIN2) 'ON' (U)SIM’s own numbers (MSISDNs) list 'AP' Selected application phonebook. If a UICC with an active USIM application is present, the application phonebook, DFPHONEBOOK under ADFUSIM, is selected. 'SDN' Service Dialing Number Integer type. Indicate the total number of used locations in the selected memory. Integer type. Indicate the total number of locations in the selected memory. Error codes. For more details, refer to Chapter 12.2. 7.3. AT+CPBF Find Phonebook Entries This command searches the phonebook entries starting with the given string from the current phonebook memory storage selected with AT+CPBS, and return all found entries sorted in alphanumeric order. AT+CPBF Find Phonebook Entries Test Command AT+CPBF=? Response +CPBF: , Write Command AT+CPBF= OK Response [+CPBF: ,,,] […] OK Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error: +CME ERROR: Or ERROR Depends on the storage of phonebook entries. / EG060V-EA&EG060W-EA_AT_Commands_Manual 75 / 167 LTE-A Module Series Parameter Integer type. Indicate the maximum length of field . Integer type. Indicate the maximum length of field . String type. The field of maximum length in current TE character set specified by AT+CSCS. Integer type. In the range of location numbers of phone book memory. Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type field of maximum length in current TE character set specified by AT+CSCS. Error codes. For more details, refer to Chapter 12.2. 7.4. AT+CPBR Read Phonebook Entries This command reads phonebook entries in location number range ... from the current phonebook memory storage selected with AT+CPBS. If is left out, only location will be returned. AT+CPBR Read Phonebook Entries Test Command AT+CPBR=? Response +CPBR: (list of supported s),, Write Command AT+CPBR=[,] OK Response +CPBR: ,,, […] OK Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error: +CME ERROR: Or ERROR Depends on the storage of phonebook entries. / EG060V-EA&EG060W-EA_AT_Commands_Manual 76 / 167 LTE-A Module Series Parameter Integer type. Location numbers of phone book memory. Integer type. Indicate the maximum length of the field . Integer type. Indicate the maximum length of the field . Integer type. The first phone book record to read. Integer type. The last phonebook record to read. Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type. The field of maximum length in current TE character set specified by AT+CSCS. Error codes. For more details, refer to Chapter 12.2. 7.5. AT+CPBW Write Phonebook Entry This command writes phonebook entry of the location number in the current phonebook memory storage selected with AT+CPBS. It can also delete a phonebook entry of the location number . AT+CPBW Write Phonebook Entry Test Command AT+CPBW=? Response +CPBW: (range of supported s),,(list of supported s), OK Write Command AT+CPBW=[][,[,[,]]] Maximum Response Time If there is any error: +CME ERROR: Or ERROR Response OK If there is any error: +CME ERROR: Or ERROR 300 ms Characteristics / EG060V-EA&EG060W-EA_AT_Commands_Manual 77 / 167 LTE-A Module Series Reference 3GPP 27.007 Parameter Integer type. The range of location numbers of phonebook entry. If is not given, the first free entry will be used. If is given as the only parameter, the phonebook entry specified by is deleted. Integer type. Indicate the maximum length of field . Integer type. Indicate the maximum length of field . Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has two kinds of values: 129 Unknown type 145 International type (contains the character '+') String type field of maximum length in current TE character set specified by AT+CSCS. Error codes. For more details, refer to Chapter 12.2. Example AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK AT+CPBW=10 OK //Make a new phonebook entry at location 10. //Delete the entry at location 10. EG060V-EA&EG060W-EA_AT_Commands_Manual 78 / 167 LTE-A Module Series 8 Short Message Service Commands 8.1. AT+CSMS Select Message Service This command selects messaging service and returns the types of messages supported by the ME. AT+CSMS Select Message Service Test Command AT+CSMS=? Response +CSMS: (list of supported s) Read Command AT+CSMS? OK Response +CSMS: ,,, Write Command AT+CSMS= OK Response +CSMS: ,, OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error: +CMS ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Type of message service. 0 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2 version 4.7.0; Phase 2+ features which EG060V-EA&EG060W-EA_AT_Commands_Manual 79 / 167 LTE-A Module Series do not require new command syntax may be supported, e.g., correct routing of messages with new Phase 2+ data coding schemes). 1 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2+ version; the requirement of setting 1 is mentioned under corresponding command descriptions). Integer type. Mobile terminated messages. 0 Type not supported 1 Type supported Integer type. Mobile originated messages. 0 Type not supported 1 Type supported Integer type. Broadcast type messages. 0 Type not supported 1 Type supported Error codes. For more details, refer to Chapter 12.3. Example AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //Query the supported service types. //Set the type of message service to 1. //Read the current setting. 8.2. AT+CMGF Message Format This command specifies the input and output format of the short messages. indicates the format of messages used with Test, Read, Write and Execution Commands and unsolicited result codes resulting from received messages. The format of messages can be either PDU mode (entire TP data units used) or text mode (headers and body of the messages given as separate parameters). Text mode uses the value of parameter specified by AT+CSCS command to inform the character set to be used in the message body in the TA-TE interface. EG060V-EA&EG060W-EA_AT_Commands_Manual 80 / 167 LTE-A Module Series AT+CMGF Message Format Test Command AT+CMGF=? Read Command AT+CMGF? Write Command AT+CMGF= Maximum Response Time Characteristics Reference 3GPP TS 27.005 Parameter Integer type. 0 PDU mode 1 Text mode Response +CMGF: (list of supported s) OK Response +CMGF: OK Response This command tells TA which input and output format of messages to use. OK 300 ms The command takes effect immediately. The configuration is not saved automatically. 8.3. AT+CSCA Service Center Address This Write Command updates the SMSC address when mobile originated SMS are transmitted. In text mode, setting is used by Write Command. In PDU mode, setting is used by same command, but only when the length of the SMSC address coded into parameter equals zero. AT+CSCA Service Center Address Test Command AT+CSCA=? Read Command AT+CSCA? Response OK Response +CSCA: , Write Command OK Response EG060V-EA&EG060W-EA_AT_Commands_Manual 81 / 167 LTE-A Module Series AT+CSCA=[,] Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (see ). Error codes. For more details, refer to Chapter 12.2. Example AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //Set SMS service center address. //Query SMS service center address. 8.4. AT+CPMS Preferred Message Storage This command selects the memory storages , and to be used for reading, writing, etc. AT+CPMS Preferred Message Storage Test Command AT+CPMS=? Response +CPMS: (list of supported s),(list of supported s),(list of supported s) EG060V-EA&EG060W-EA_AT_Commands_Manual 82 / 167 LTE-A Module Series Read Command AT+CPMS? OK Response +CPMS: ,,,,,,,, Write Command AT+CPMS=[,[,]] OK Response +CPMS: ,,,,, OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error: +CMS ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Messages will be read and deleted from this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage Messages will be written and sent to this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage The received messages will be placed in this memory storage if routing to PC is not set. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage Integer type. Number of current messages in . Integer type. Total number of messages which can be stored in . Error codes. For more details, refer to Chapter 12.3. Example AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //Set SMS message storage as 'SM'. EG060V-EA&EG060W-EA_AT_Commands_Manual 83 / 167 LTE-A Module Series OK AT+CPMS? //Query the current SMS message storage. +CPMS: 'SM',18,50,'SM',18,50,'SM',18,50 OK 8.5. AT+CMGD Delete Message This command deletes short messages from the preferred message storage location . If is presented and not set to 0, then the ME shall ignore and follow the rules of shown as below. AT+CMGD Delete Message Test Command AT+CMGD=? Response +CMGD: (range of supported s),(list of supported s) Write Command AT+CMGD=[,] OK Response TA deletes message from preferred message storage location . OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error: +CMS ERROR: Or ERROR 300 ms. Note: Operation of depends on the storage of deleted messages. The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type value in the range of location numbers supported by the associated memory. 0 Delete the message specified in 1 Delete all read messages from storage EG060V-EA&EG060W-EA_AT_Commands_Manual 84 / 167 LTE-A Module Series 2 Delete all read messages from storage and sent mobile originated messages 3 Delete all read messages, sent and unsent mobile originated messages from storage 4 Delete all messages from storage Messages to be read and deleted from this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage Error codes. For more details, refer to Chapter 12.3. Example AT+CMGD=1 OK AT+CMGD=1,4 OK //Delete the message specified with =1. //Delete all messages from storage. 8.6. AT+CMGL List Messages This Read Command returns messages with status value from preferred message storage to the TE. If the status of the message is 'REC UNREAD', the status in the storage changes to 'REC READ'. When executing command AT+CMGL without status value , it will report the list of SMS with 'REC UNREAD' status. AT+CMGL List Messages Test Command AT+CMGL=? Response +CMGL: (list of supported s) Write Command AT+CMGL[=] OK Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-SUBMITs and/or SMS-DELIVERs: +CMGL: ,,,[],[][,,] [...] OK For SMS-STATUS-REPORTs: +CMGL: ,,,,[],[],,, [...] OK For SMS-COMMANDs: +CMGL: ,,, [...] OK For CBM storage: +CMGL: ,,,,, [...] OK If in PDU mode (AT+CMGF=0) and the command is executed successfully: +CMGL: ,,[], [...] OK If there is any error: +CMS ERROR: Or ERROR Response List all messages with 'REC UNREAD' status from message storage , and then the status in the storage changes to 'REC READ'. 300ms. Note: Operation of depends on the storage of listed messages. The command takes effect immediately. The configuration is not saved automatically. EG060V-EA&EG060W-EA_AT_Commands_Manual 86 / 167 LTE-A Module Series Parameter In text mode: 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages 'ALL' All messages In PDU mode: 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages 4 All messages Integer type. In the range of location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in TS 27.007). The type of address is given by . String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (see ). Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (see by default). Message length. Integer type. Indicate the length of the message body (or ) in characters in the text mode (AT+CMGF=1), or the length of the actual TP data unit in octets in PDU mode (AT+CMGF=0) (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7-bit default alphabet is used and indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set. - If TE character set is other than 'HEX' (refer to AT+CSCS command in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7-bit EG060V-EA&EG060W-EA_AT_Commands_Manual 87 / 167 LTE-A Module Series default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7-bit default alphabet 23) is presented as 17 (IRA 49 and 55)). - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7-bit default alphabet is used. - If TE character set is other than 'HEX' (see AT+CSCS in 3GPP TS27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7-bit default alphabet into two IRA character long hexadecimal number. - If , indicates that 8-bit or UCS2 data coding scheme is used: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) 3GPP TS 27.007. Depends on the command or result code: first octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND (default 2) in integer format. 3GPP TS 23.040 TP-Message-Reference in integer format 3GPP TS 23.040 TP-Recipient-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see +CSCS in 3GPP TS 27.007); type of address given by . 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (see by default). 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (see ). 3GPP TS 23.040 TP-Discharge-Time in time-string format: 'yy/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. 3GPP TS 23.040 TP-Status in integer format. 3GPP TS 23.040 TP-Command-Type in integer format (default 0). 3GPP TS 23.041 CBM Serial Number in integer format. 3GPP TS 23.041 CBM Message Identifier in integer format. 3GPP TS 23.041 CBM Page Parameter bits 4-7 in integer format. 3GPP TS 23.041 CBM Page Parameter bits 0-3 in integer format. Messages to be read and deleted from this memory storage. EG060V-EA&EG060W-EA_AT_Commands_Manual 88 / 167 LTE-A Module Series 'SM' (U)SIM message storage 'ME' Mobile equipment message storage Error codes. For more details, refer to Chapter 12.3. Example AT+CMGF=1 //Set SMS message format as text mode. OK AT+CMGL='ALL' //List all messages from message storage. +CMGL: 1,'STO UNSENT','13156569236' +CMGL: 2,'STO UNSENT','13156569236' OK 8.7. AT+CMGR Read Message This Read Command returns SMS message with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage changes to 'REC READ'. AT+CMGR Read Message Test Command AT+CMGR=? Write Command AT+CMGR= Response OK Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-DELIVER: +CMGR: ,,[],[,,,,,,,] OK For SMS-SUBMIT: +CMGR: ,,[][,,,,,[],,,] OK For SMS-STATUS-REPORTs: +CMGR: ,,,[],[],,, EG060V-EA&EG060W-EA_AT_Commands_Manual 89 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK For SMS-COMMANDs: +CMGR: ,,[,,[],[],[], ] OK For CBM storage: +CMGR: ,,,,, OK If in PDU mode (AT+CMGF=0) and command is executed successfully: +CMGR: ,[], OK If there is any error: +CMS ERROR: Or ERROR Depends on the length of message content. The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. The location numbers supported by the associated memory. In text mode 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages 'ALL' All messages In PDU mode 0 Received unread messages 1 Received read messages EG060V-EA&EG060W-EA_AT_Commands_Manual 90 / 167 LTE-A Module Series 2 Stored unsent messages 3 Stored sent messages 4 All messages String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (see ). First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND in integer format. If a valid value has been entered once, the parameter can be omitted. Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format. Default: 0. Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (see ). Message number. 3GPP TS 23.040 TP-Message-Number in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Recipient address. 3GPP TS 23.040 TP-Recipient-Address Address-Value field in string format. BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (see by default). Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Type of originating address.3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (see by default). Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS in 3GPP TS 27.007). The type of address is given by . EG060V-EA&EG060W-EA_AT_Commands_Manual 91 / 167 LTE-A Module Series Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (see by default). Message length. Integer type. Indicate in the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0) the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). The text of short message. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). 3GPP TS 23.040 TP-Discharge-Time in time-string format: 'yy/MM/dd,hh:mm:ss±zz', during which characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. 3GPP TS 23.040 TP-Status in integer format. 3GPP TS 23.040 TP-Command-Type in integer format (default 0). 3GPP TS 23.041 CBM Serial Number in integer format. 3GPP TS 23.041 CBM Page Parameter bits 4-7 in integer format. 3GPP TS 23.041 CBM Page Parameter bits 0-3 in integer format. Messages to be read and deleted from this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage Error codes. For more details, please refer to Chapter 12.3. Example +CMTI: 'SM',3 AT+CSDH=1 OK AT+CMGR=3 +CMGR: 'REC 0',145,27 //Indicates that new message has been received and saved to =3 of 'SM'. //Show SMS text mode parameters. //Read message. UNREAD','+8615021012496',,'18/12/15,15:06:37+32',145,4,0,0,'+861380021050 OK EG060V-EA&EG060W-EA_AT_Commands_Manual 92 / 167 LTE-A Module Series 8.8. AT+CMGS Send Message This Write Command sends a short message from TE to network (SMS-SUBMIT). After invoking the Write Command, wait for the prompt > and then start to write the message. After that, enter to indicate the ending of PDU and begin to send the message. Sending can be cancelled by giving character. Abortion is acknowledged with OK, though the message will not be sent. The message reference is returned to the TE on successful message delivery. Optionally (when AT+CSMS value is 1 and network supports) is returned. The value can be used to identify message upon unsolicited delivery status report result code. AT+CMGS Send Message Test Command AT+CMGS=? Write Command 1) If text mode (AT+CMGF=1): AT+CMGS=[,] text is entered means quits without sending 2) If PDU mode (AT+CMGF=0): AT+CMGS= PDU is given Response OK Response If in text mode (AT+CMGF=1) and sent successfully: +CMGS: OK If in PDU mode (AT+CMGF=0) and sent successfully: +CMGS: OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error: +CMS ERROR: Or ERROR 120 s, determined by network. The command takes effect immediately. The configuration is not saved automatically. Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Integer type. Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. EG060V-EA&EG060W-EA_AT_Commands_Manual 93 / 167 LTE-A Module Series Message length. Integer type. Indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Error codes. For more details, refer to Chapter 12.3. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > +CMGS: 247 OK //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use to send message, or to quit without sending. 8.9. AT+CMMS Send More Messages This command controls the continuity of the SMS relay protocol link. If the feature is enabled (and supported by the currently used network) multiple messages can be sent faster as the link is kept open. AT+CMMS Send More Messages Test Command AT+CMMS=? Response +CMMS: (range of supported s) Read Command AT+CMMS? OK Response +CMMS: Write Command AT+CMMS= OK Response OK If there is any error: +CMS ERROR: Or ERROR EG060V-EA&EG060W-EA_AT_Commands_Manual 94 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.005 120 s, determined by network. The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Feature disabled 1 Keep enabled until the time between the response of the latest message send command (AT+CMGS, AT+CMSS, etc.) and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation), and then ME shall close the link and TA switches back to 0 automatically. 2 Feature enabled (If the time between the response of the latest message send command and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation), ME shall close the link but TA will not switch back to 0 automatically). Error codes. For more details, refer to Chapter 12.3. NOTE After the execution of Read Command, it is required to wait for 5–10 seconds before issuing the Write Command. Otherwise +CMS ERROR: 500 may appear. 8.10. AT+CMGW Write Message to Memory This Write and Execution Commands store short messages (either SMS-DELIVER or SMS-SUBMIT) from TE to memory storage , and then the memory location of the stored message is returned. Message status will be set to 'stored unsent' by default, but parameter also allows other status values to be given. The syntax of input text is the same as the one specified in AT+CMGS Write Command. AT+CMGW Write Message to Memory Test Command AT+CMGW=? Write Command 1) If text mode (AT+CMGF=1): AT+CMGW=[,[,<s Response OK Response If message writing is successful: +CMGW: EG060V-EA&EG060W-EA_AT_Commands_Manual 95 / 167 LTE-A Module Series tat>]] text is entered quits without sending 2) If PDU mode (AT+CMGF=0): AT+CMGW=[,] PDU is given Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK If there is any error: +CMS ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address given by . Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (see by default). PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Message length. Indicate the length of the message body (or ) in characters in the text mode (AT+CMGF=1), or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.04 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Index of message in selected storage . EG060V-EA&EG060W-EA_AT_Commands_Manual 96 / 167 LTE-A Module Series Messages will be written and sent to this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage Error codes. For more details, refer to Chapter 12.3. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > +CMGW: 4 //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use to write message or to quit without sending. OK AT+CMGF=0 //Set SMS message format as PDU mode. OK AT+CMGW=18 > 0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK 8.11. AT+CNMI New Message Indications to TE This command selects the procedure on how the received new messages from the network are indicated to the TE. AT+CNMI New Message Indications to TE Test Command AT+CNMI=? Response +CNMI: (range of supported s),(range of supported s),(list of supported s),(list/range of supported s),(list of supported s) Read Command AT+CNMI=? OK Response +CNMI: ,,,, OK EG060V-EA&EG060W-EA_AT_Commands_Manual 97 / 167 LTE-A Module Series Write Command AT+CNMI=[,[,[,[,]]]] Maximum Response Time Characteristics Reference 3GPP TS 27.005 Response OK If there is any error: ERROR Or +CMS ERROR: 300 ms The command takes effect immediately; The configuration is not saved automatically. Parameter Integer type. 0 Buffer unsolicited result codes in the MT. If MT result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications. 1 Discard indication and reject new received message unsolicited result codes when MT-TE link is reserved (e.g. in data mode). Otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the MT when MT-TE link is reserved (e.g. in data mode) and flush them to the TE after reservation. Otherwise forward them directly to the TE. 3 Forward unsolicited result codes directly to the TE. In data mode, embedded result codes and data are transmitted directly between MTTE links. Integer type. The rules for storing received SMS depend on its data coding scheme (refer to 3GPPTS 23.038) and preferred memory storage setting. 0 No SMS-DELIVER indications are routed to TE 1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE by using unsolicited result code: +CMTI: , 2 SMS-DELIVERs are routed directly to the TE using unsolicited result code: +CMT: [], (PDU mode enabled) or +CMT:,[], [,,,, ,,,] (text mode enabled; about the parameters in italics, see AT+CSDH) 3 Class 3 SMS-DELIVERs are routed directly to TE by using unsolicited result codes defined in =2. Messages of other classes result in indication as defined in =1. Integer type. The rules for storing received CBMs depend on its data coding EG060V-EA&EG060W-EA_AT_Commands_Manual 98 / 167 LTE-A Module Series scheme (refer to 3GPP TS 23.038) and the setting of Select CBM Types (AT+CSCB). 0 No CBM indications are routed to the TE 2 New CBMs are routed directly to the TE using unsolicited result code: +CBM: (PDU mode); or +CBM: ,,,, (text mode) (not supported by EG060V-EA) 3 CLASS3 CBMs are routed directly to the TE using unsolicited result code: +CBM: (PDU mode enabled) (not supported by EG060W-EA) Integer type. SMS-STATUS-REPORT indications to TE. 0 No SMS-STATUS-REPORTs are routed to the TE 1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +CDS: (PDU mode) or +CDS: ,,[],[],,, (text mode) (not supported by EG060V-EA) 2 If SMS-STATUS-REPORT is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CDSI: , Integer type. 0 TA buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is entered (OK response shall be given before flushing the codes) this command to TE (Send it when returning OK). 1 TA buffer of unsolicited result codes defined within this command is cleared when 1 or 2 is entered. Error codes. For more details, refer to Chapter 12.3. Example Here takes EG060V-EA as an example. AT+CNMI=? //Test Command. +CNMI: (0-3),(0-3),(0,3),(0,2),(0,1) OK AT+CNMI? +CNMI: 2,1,0,0,0 //Query the default setting. OK AT+CNMI=1,1,0,0,0 OK AT+CMGS='12345678898' >QUECTEL +CMGS: 169 //Set SMS-DELIVERs are routed directly to the TE. //Test new message indications to the TE in AT+CNMI=1,1,0,0,0. EG060V-EA&EG060W-EA_AT_Commands_Manual 99 / 167 OK +CMTI: 'SM',15 LTE-A Module Series 8.12. AT+CMSS Send Message from Storage This Write Command sends messages with location value from message storage to the network (SMS-SUBMIT). If a new recipient address is given for SMS-SUBMIT, it shall be used instead of the one stored with the message. Reference value is returned to the TE on successful message delivery. Values can be used to identify message upon unsolicited delivery status report result code. AT+CMSS Send Message from Storage Test Command AT+CMSS=? Write Command AT+CMSS=[,[,]] Response OK Response If in text mode (AT+CMGF=1) and sent successfully: +CMSS: [,] OK If in PDU mode (AT+CMGF=0) and sent successfully: +CMSS: [,] OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error: +CMS ERROR: Or ERROR 120 s, determined by network. The command takes effect immediately. The configuration is not saved automatically. EG060V-EA&EG060W-EA_AT_Commands_Manual 100 / 167 LTE-A Module Series Parameter Integer type value in the range of location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (see ). The format is the same as in case of SMS, but without 3GPP TS 24.011 SC address field and the parameter shall be bounded by double quote characters like a normal string type parameter. The memory to which message writing and sending operations are made. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage Error codes. For more details, refer to Chapter 12.3. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK AT+CMSS=4,'18158848480' +CMSS: 54 OK //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use to send message or to quit without sending. //Send the message of index 4 from memory storage. EG060V-EA&EG060W-EA_AT_Commands_Manual 101 / 167 LTE-A Module Series 8.13. AT+CSCB Select Cell Broadcast Message Types This Write Command selects which types of CBMs are to be received by the ME. AT+CSCB Select Cell Broadcast Message Types Test Command AT+CSCB=? Response +CSCB: (list of supported s) Read Command AT+CSCB? OK Response +CSCB: ,, Write Command AT+CSCB=,[,] OK Response TA selects which types of CBMs are to be received by the ME. OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error: +CMS ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Message types specified in and are accepted 1 Message types specified in and are not accepted String type. All different possible combinations of CBM message identifiers (refer to ), e.g. '0,1,5,320-478,922'. String type. All different possible combinations of CBM data coding schemes (refer to ) (default is empty string), e.g. '0-3,5'. Error codes. For more details, refer to Chapter 12.3. EG060V-EA&EG060W-EA_AT_Commands_Manual 102 / 167 LTE-A Module Series 8.14. AT+CSDH Show SMS Text Mode Parameters This Write Command controls whether detailed header information is shown in text mode result codes. AT+CSDH Show SMS Text Mode Parameters Test Command AT+CSDH=? Response +CSDH: (list of supported s) Read Command AT+CSDH? OK Response +CSDH: Write Command AT+CSDH=[] Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. 0 Do not show header values defined in commands +CSCA, +CSMP (, , , , , ) and , or in +CMT, +CMGL, +CMGR result codes for SMS-DELIVERs and SMS-SUBMITs in text mode 1 Show the values in result codes Example AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT','13156569236' OK AT+CSDH=1 EG060V-EA&EG060W-EA_AT_Commands_Manual 103 / 167 LTE-A Module Series OK AT+CMGR=2 +CMGR: 'STO UNSENT','13156569236',,128,17,0,0,143,'+8613800551500',145,18 OK 8.15. AT+CSMP Set SMS Text Mode Parameters This command sets values for additional parameters needed when a short message is sent to the network or placed in a storage in text mode (AT+CMGF=1). It is possible to set the validity period starting from when the SM is received by the SMSC ( ranges from 0 to 255) or define the absolute time of the validity period termination ( is a string). AT+CSMP Set SMS Text Mode Parameters Test Command AT+CSMP=? Read Command AT+CSMP? Response OK Response +CSMP: ,,, Write Command AT+CSMP=[,[,[,] ]] OK Response OK Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.005 The command takes effect immediately. The configurations are not saved. Parameter First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, SMS-COMMAND in integer format. If a valid value has been entered once, this parameter can be omitted. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (see ). Integer type. Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format. Default value: 167. EG060V-EA&EG060W-EA_AT_Commands_Manual 104 / 167 LTE-A Module Series Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. EG060V-EA&EG060W-EA_AT_Commands_Manual 105 / 167 LTE-A Module Series 9 Packet Domain Commands 9.1. AT+CGATT Attachment or Detachment of PS The command attaches MT to, or detaches MT from, the Packet Domain service. After the command has been completed, the MT remains in V.25ter command state. If MT is already in the requested state, the command will be ignored and the OK response will be returned. If the requested state cannot be achieved, an ERROR or +CME ERROR response will be returned. AT+CGATT Attachment or Detachment of PS Test Command AT+CGATT=? Response +CGATT: (list of supported s) Read Command AT+CGATT? OK Response +CGATT: Write Command AT+CGATT= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: +CME ERROR: Or ERROR 140 s, determined by network. Whether the command takes effect is determined by network. The configuration is not saved automatically. Parameter Integer type. Indicates the state of PS attachment. 0 Detached 1 Attached EG060V-EA&EG060W-EA_AT_Commands_Manual 106 / 167 LTE-A Module Series Other values are reserved and will result in an ERROR response to the Write Command. Error codes. For more details, refer to Chapter 12.2. Example AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //Attach to PS service. //Detach from PS service. //Query the current PS service state. 9.2. AT+CGDCONT Define PDP Context This command specifies PDP context parameters for a specific context . A special form of the Write Command (AT+CGDCONT=) causes the values for context to become undefined. It is not allowed to change the definition of an already activated context. This Read Command returns the current settings for each defined PDP context. AT+CGDCONT Define PDP Context Test Command AT+CGDCONT=? Response +CGDCONT: (range of supported s),,,,(range of supported s),(ra nge of supported s),(list of supported s),(list of supported s),(range o f supported s),(list of supported s) Read Command AT+CGDCONT? OK Response +CGDCONT: ,,,,,,,,, […] Write Command AT+CGDCONT=[,[, [,[,[, OK Response OK Or EG060V-EA&EG060W-EA_AT_Commands_Manual 107 / 167 LTE-A Module Series [,[,[,[, ]]]]]]]]] ERROR Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. PDP context identifier. A numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of the command. Range: 0–15. String type. Packet data protocol type, a string parameter which specifies the type of packet data protocol. Only 'IP', 'IPv6' and 'IPv4v6' are supported for EPS services. 'IP' Internet Protocol (IETF STD 5) 'PPP' Point to Point Protocol (IETF STD 51) 'IPV6' Internet Protocol, version 6 'IPV4V6' Virtual introduced to handle dual IP stack UE capability String type. Access point name, a string parameter that is a logical name used to select the GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested. String type. Identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The allocated address may be read using the AT+CGPADDR command. Integer type. Controls PDP data compression (applicable for SNDCP only) (see 3GPP TS 44.065). 0 Off (Default if value is omitted) 1 On (Manufacturer preferred compression) 2 V.42bis 3 V.44 (Not supported currently) Integer type. Controls PDP header compression (see 3GPP TS 44.065 and 3GPP TS 25.323). 0 Off 1 On 2 RFC1144 3 RFC2507 4 RFC3095 Integer type. Controls how the MT/TA requests to get the IPv4 address information. 0 IPv4 address allocated through NAS signalling EG060V-EA&EG060W-EA_AT_Commands_Manual 108 / 167 LTE-A Module Series 1 IPv4 address allocated through DHCP Integer type. Indicates the type of PDP context activation request for the PDP context. Please refer to 3GPP TS 24.301 (subclause 6.5.1.2) and 3GPP TS 24.008 (subclause 10.5.6.17). If the initial PDP context is supported (subclause 10.1.0), it is not allowed to assign =0 for emergency bearer services. According to 3GPP TS 24.008 (subclause 4.2.4.2.2 and 4.2.5.1.4) and 3GPP TS 24.301 (subclause 5.2.2.3.3 and 5.2.3.2.2), a separate PDP context must be established for emergency bearer services. Integer type. Influences how the MT/TA requests to get the P-CSCF address, (see 3GPP TS 24.229 annex B and L). 0 Preference of P-CSCF address discovery not influenced by AT+CGDCONT 1 Preference of P-CSCF address discovery through NAS signaling 2 Preference of P-CSCF address discovery through DHCP Integer type. Indicates to the network whether the PDP context is for IM CN subsystem-related signaling only or not. 0 UE indicates that the PDP context is not for IM CN subsystem-related signaling only 1 UE indicates that the PDP context is for IM CN subsystem-related signaling only 9.3. AT+CGACT Activate or Deactivate PDP Context This Write Command activates or deactivates the specified PDP context(s) defined by CGDCONT. After the command has completed, the MT remains in V.250 command state. If any PDP context is already in the requested state, the state for that context remains unchanged. If the MT is not PS attached when the activation form of the command is executed, the MT first performs a PS attach and then attempts to activate the specified contexts. If no s specify the activation/deactivation form of the command, it will activate or deactivate all defined contexts. AT+CGACT Activate or Deactivate PDP Context Test Command AT+CGACT=? Response +CGACT: (list of supported s) Read Command AT+CGACT? OK Response +CGACT: , […] Write Command AT+CGACT=, OK Response OK EG060V-EA&EG060W-EA_AT_Commands_Manual 109 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 Or NO CARRIER If there is any error: +CME ERROR: Or ERROR 150 s, determined by network. Whether the command takes effect is determined by network. The configuration is not saved automatically. Parameter Integer type. Indicates the state of PDP context activation. 0 Deactivated 1 Activated Other values are reserved and will result in an ERROR response to the Write Command. Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). Error codes. For more details, refer to Chapter 12.2. Example AT+CGDCONT=2,'IP','UNINET' OK AT+CGACT=1,2 OK AT+CGACT? +CGACT: 1,1 +CGACT: 2,1 OK AT+CGACT=0,2 OK //Define PDP context. //Activate PDP. //Query the current PDP context state. //Deactivate the PDP. 9.4. AT+CGPADDR Show PDP Address This Write Command returns a list of PDP addresses for the specified context identifiers. If no is specified, the addresses for all defined contexts are returned. EG060V-EA&EG060W-EA_AT_Commands_Manual 110 / 167 LTE-A Module Series AT+CGPADDR Show PDP Address Test Command AT+CGPADDR=? Response +CGPADDR: (list of defined s) Execution/Write Command AT+CGPADDR[=[,[,…]]] OK Response +CGPADDR: , […] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Or ERROR 300 ms Whether the command takes effect is determined by network. The configuration is not saved automatically. Parameter Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). String type. Identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by AT+CGDCONT when the context is defined. For a dynamic address it will be the one assigned during the last PDP context activation that used the context definition referred to by . is omitted if none is available. Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' OK //Define PDP context. //Activate PDP. //Show PDP address. EG060V-EA&EG060W-EA_AT_Commands_Manual 111 / 167 LTE-A Module Series 9.5. AT+CGCLASS GPRS Mobile Station Class This command sets the MT to operate according to the specified mode of operation. For details, see 3GPP TS 23.060. AT+CGCLASS GPRS Mobile Station Class Test Command AT+CGCLASS=? Response +CGCLASS: (list of supported s) Read Command AT+CGCLASS? OK Response +CGCLASS: Write Command AT+CGCLASS= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter String type. Indicates the GPRS mobile class (Functionality in descending order). A Class-A mode of operation (A/Gb mode), or CS/PS mode of operation (highest mode of operation) B Class-B mode of operation (A/Gb mode), or CS/PS mode of operation CG Class-C mode of operation in PS only mode (A/Gb mode), or PS mode of operation CC Class-C mode of operation in CS only mode (A/Gb mode), or CS (lowest mode of operation) Error codes. For more details, refer to Chapter 12.2. EG060V-EA&EG060W-EA_AT_Commands_Manual 112 / 167 LTE-A Module Series 9.6. AT+CGREG GPRS Network Registration Status This command queries the network registration status and controls the presentation of an unsolicited result code +CGREG: when =1 and there is a change in the MT’s GPRS network registration status in GERAN/UTRAN, or unsolicited result code +CGREG: [,[],[],[],[]] when =2 and there is a change of the network cell in GERAN/UTRAN. AT+CGREG GPRS Network Registration Status Test Command AT+CGREG=? Response +CGREG: (range of supported s) Read Command AT+CGREG? OK Response +CGREG: ,[,,[,]] Write Command AT+CGREG= Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CGREG: 2 Enable network registration and location information unsolicited result code +CGREG: [,,[,]] Integer type. Indicates the GPRS registration status. 0 Not registered. MT is not currently searching an operator to register to. The UE is in GMM state GMM-NULL or GMM-DEREGISTERED-INITIATED. The GPRS service is disabled, but the UE is allowed to attach for GPRS if requested by the user. 1 Registered, home network. The UE is in GMM state GMM-REGISTERED or GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED on the home PLMN. 2 Not registered, but MT is trying to attach or searching an operator to register to. UE is in GMM state GMM-DEREGISTERED or GMM-REGISTERED-INITIATED. EG060V-EA&EG060W-EA_AT_Commands_Manual 113 / 167 LTE-A Module Series The GPRS service is enabled, but an allowable PLMN is currently not available. The UE will start a GPRS attach as soon as an allowable PLMN is available. 3 Registration denied. The UE is in GMM state GMM-NULL. The GPRS service is disabled, and the UE is not allowed to attach for GPRS if requested by the user. 4 Unknown 5 Registered, roaming String type. Two-byte location area code in hexadecimal format (e.g. '00C3' equals 195 in decimal). String type. 16-bit (GSM) or 28-bit (UMTS/LTE) cell ID in hexadecimal format. Access technology selected. 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 8 UTRAN HSPA+ String type. Routing Area Code. 9.7. AT+CGEREP Packet Domain Event Reporting This Write Command enables or disables the sending of unsolicited result codes +CGEV: XXX from MT to TE in the case of certain events occurring in the Packet Domain MT or the network. controls the processing of unsolicited result codes specified within this command. controls the effect on buffered codes when 1 or 2 is specified. AT+CGEREP Packet Domain Event Reporting Test Command AT+CGEREP=? Response +CGEREP: (range of supported s),(list of supported s) Read Command AT+CGEREP? OK Response +CGEREP: , Write Command AT+CGEREP[=mode[,]] OK Response OK Or ERROR EG060V-EA&EG060W-EA_AT_Commands_Manual 114 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Buffer unsolicited result codes in the MT; If MT result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE. 1 Discard unsolicited result codes when MT-TE link is reserved (e.g. in on-line data mode), otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the MT when MT-TE link is reserved (e.g. in on-line data mode) and flush them to the TE when MT-TE link becomes available. Otherwise forward them directly to the TE. Integer type. 0 MT buffer of unsolicited result codes defined within this command is cleared when 1 or 2 is specified. 1 MT buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is specified (OK response shall be given before flushing the codes). NOTE The unsolicited result codes and the corresponding events are defined as follows: 1. +CGEV: REJECT ,: A network request for PDP context activation occurred when the MT was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. Note: This event is not applicable for EPS. 2. +CGEV: NW REACT ,,[]: The network has requested a context reactivation. The used to reactivate the context is provided if known to the MT. Note: This event is not applicable for EPS. 3. +CGEV: NW DEACT ,,[]: The network has forced a context deactivation. The used to activate the context is provided if known to the MT. 4. +CGEV: ME DEACT ,,[]: The mobile equipment has forced a context deactivation. The used to activate the context is provided if known to the MT. 5. +CGEV: NW DETACH: The network has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 6. +CGEV: ME DETACH: The mobile equipment has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 7. +CGEV: NW CLASS : The network has forced a change of MS class. The highest available EG060V-EA&EG060W-EA_AT_Commands_Manual 115 / 167 LTE-A Module Series class is reported (see AT+CGCLASS). 8. +CGEV: ME CLASS : The mobile equipment has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 9. +CGEV: PDN ACT : Activated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. 10. +CGEV: PDN DEACT : Deactivated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. Parameter Srting type. Packet data protocol type. A string parameter which specifies the type of packet data protocol. 'IP' IPv4 'PPP' PPP 'IPV6' IPv6 'IPV4V6' IPv4v6 String type. Identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP. Integer type. PDP context identifier. A numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of AT+CGDCONT. String type. Indicates the GPRS mobile class. A Class A (highest) 9.8. AT+CGSMS Select Service for MO SMS Messages This command specifies the service or service preference that the MT will use to send MO (mobile originated) SMS messages. AT+CGSMS Select Service for MO SMS Messages Test Command AT+CGSMS=? Response +CGSMS: (range of currently available s) Read Command AT+CGSMS? OK Response +CGSMS: Write Command AT+CGSMS= OK Response OK EG060V-EA&EG060W-EA_AT_Commands_Manual 116 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Indicates the service or service preference to be used. 0 GPRS 1 Circuit switch 2 Packet domain preferred (use circuit switched if GPRS not available) 3 Circuit switch preferred (use GPRS if circuit switched not available) Error codes. For more details, refer to Chapter 12.2. 9.9. AT+CEREG EPS Network Registration Status This command queries the network registration status and controls the presentation of an unsolicited result code +CEREG: when =1 and there is a change in the MT’s EPS network registration status in E-UTRAN, or unsolicited result code +CEREG: [,[],[],[]] when =2 and there is a change of the network cell in E-UTRAN. AT+CEREG EPS Network Registration Status Test Command AT+CEREG=? Response +CEREG: (range of supported s) Read Command AT+CEREG? OK Response +CEREG: ,[,,[,]] Write Command AT+CEREG= OK Response OK Or ERROR EG060V-EA&EG060W-EA_AT_Commands_Manual 117 / 167 LTE-A Module Series Maximum Response Time Characteristics Reference 3GPP TS 27.007 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CEREG: 2 Enable network registration and location information unsolicited result code +CEREG: [,,[,]] Integer type. Indicate the EPS registration status. 0 Not registered. ME is not currently searching an operator to register to 1 Registered, home network 2 Not registered, but ME is currently searching a new operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two-byte tracking area code in hexadecimal format (e.g. '00C3' equals 195 in decimal). String type. 28-bit E-UTRAN cell ID in hexadecimal format. Integer type. Access technology selected. 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 8 UTRAN HSPA+ 9.10. AT+QGDCNT Packet Data Counter This command allows the application to check how much bytes are sent by or received by MT. AT+QGDCNT Packet Data Counter Test Command AT+QGDCNT=? Response +QGDCNT: (list of supported s) EG060V-EA&EG060W-EA_AT_Commands_Manual 118 / 167 LTE-A Module Series Read Command AT+QGDCNT? Write Command AT+QGDCNT= Maximum Response Time Characteristics Reference Quectel OK Response +QGDCNT: , OK Response OK If there is any error: +CME ERROR: Or ERROR 300 ms Whether the command takes effect is determined by network. The configuration is not saved automatically. Parameter Integer type. The operation about data counter. 0 Reset the data counter 1 Save the results of data counter to NVM Integer type. The amount of sent bytes. String type. Two-byte tracking area code in hexadecimal format. The amount of received bytes. Error codes. For more details, refer to Chapter 12.2. NOTE When MT is powered on, and are loaded from results of data counter in NVM. The default result in NVM is 0. Example AT+QGDCNT=? +QGDCNT: (0,1) OK AT+QGDCNT? +QGDCNT: 3832,4618 //Test command. //Query the current bytes sent and received. EG060V-EA&EG060W-EA_AT_Commands_Manual 119 / 167 OK AT+QGDCNT=1 OK AT+QGDCNT=0 OK //Save the results to NVM. //Reset the data counter. LTE-A Module Series 9.11. AT+QAUGDCNT Auto Save Packet Data Counter This command allows AT+QGDCNT to save results to NVM automatically. AT+QGDCNT Auto Save Packet Data Counter Test Command AT+QAUGDCNT=? Response +QAUGDCNT: (list of supported s) Read Command AT+QAUGDCNT? OK Response +QAUGDCNT: Write Command AT+QAUGDCNT= OK Response OK Maximum Response Time Characteristics If there is any error: +CME ERROR: Or ERROR 300 ms Whether the command takes effect is determined by network. The configuration is not saved automatically. Parameter Integer type. The parameter is the time-interval for AT+QGDCNT to save results to NVM automatically. If it is set to 0, auto-save feature is disabled. Range: 0, 30–65535. Default: 0. Unit: second. Error codes. For more details, refer to Chapter 12.2. EG060V-EA&EG060W-EA_AT_Commands_Manual 120 / 167 Example AT+QAUGDCNT=? +QAUGDCNT: (0,30-65535) OK AT+QAUGDCNT=35 OK AT+QAUGDCNT? +QAUGDCNT: 35 OK LTE-A Module Series //Test command. //Set to 35. //Query the interval of auto-save. 9.12. AT+AUTOAPN Auto-Configure APN This command configures the APN used when the module starts. AT+AUTOAPN Auto-configure APN Test Command AT+AUTOAPN=? Response +AUTOAPN: (list of supported s),(list of supported s),,(range of supported s),< username>, Read Command AT+AUTOAPN? OK Response +AUTOAPN: Write Command AT+AUTOAPN=[,,[,[,,]]] OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Specifies the APN. 0 Non-automatic APN. You need to manually configure APN-related parameters and save to system. After reboot, you can dial up to internet with EG060V-EA&EG060W-EA_AT_Commands_Manual 121 / 167 LTE-A Module Series the APN. 1 Automatic APN. The module dials up to internet with internal automatic APN configuration String type. Packet data protocol type. 'IP' Get IPv4 address from Internet 'IPV6' Get IPv6 address from Internet 'IPV4V6' Get IPv4 and IPv6 address from Internet The following parameters are only valid when is 0: String type. Access point name. Authentication way. 0 None 1 PAP 2 CHAP String type. Username used to dial up the Internet. String type. Password to dial up the Internet. Example AT+AUTOAPN? +AUTOAPN: 1 //Query the mode of APN configuration. OK AT+AUTOAPN=1,'IP' //Get IPv4 address from Internet. OK AT+AUTOAPN=? //Test command. +AUTOAPN: (0,1),('IP','IPV6','IPV4V6'),,(0-2),, OK 9.13. AT+QICSGP Define PDP Context This command specifies PDP context parameters for a specific context . A special form of the Write Command (AT+QICSGP=) causes the values for context to become undefined. AT+QICSGP Test Command AT+QICSGP=? Define PDP Context Response +QICSGP: (range of supported s),(range of suppor ted s),,,, (range of supported s) OK EG060V-EA&EG060W-EA_AT_Commands_Manual 122 / 167 LTE-A Module Series Read Command AT+QICSGP? Response +QICSGP: ,,,,< username>, Write Command AT+QICSGP=,[,< APN>[,,,[]]] OK Response If the optional parameters are omitted, query the configuration of a specified context: +QICSGP: ,,,, OK Characteristics If the optional parameters are specified, configure the parameters of the specified PDP context: OK Or ERROR The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. The context ID. Range: 1–15. Integer type. The protocol type. 1 IPv4 2 IPv6 3 IPv4v6 String type. The access point name. String type. The username. The maximum length is 50 bytes. String type. The password. The maximum length is 50 bytes. Integer type. The authentication methods. 0 None 1 PAP 2 CHAP Example AT+QICSGP=1 +QICSGP: 1,'','','',0 OK AT+QICSGP=1,1,'UNINET',,,1 //Query the configurations of context 1. //Configure context 1. APN 'UNINET' stands for China Unicom. EG060V-EA&EG060W-EA_AT_Commands_Manual 123 / 167 LTE-A Module Series OK 9.14. AT+QNETDEVCTL Activate or Deactivate PDP Context This Write Command activates or deactivates the specified PDP context(s) defined by AT+QICSGP, and, if TA is disconnected from the network, indicate TA to reconnect to the network and automatically start the data call. After the command has completed, the MT remains in V.250 command state. If the PDP context specified is already in the requested state, its state remains unchanged after the execution of this command. If the MT is not PS-attached when the activation form of the command is executed, the MT first performs a PS attach and then attempts to activate the specified context(s). AT+QNETDEVCTL Test Command AT+QNETDEVCTL=? Activate or Deactivate PDP Context Response +QNETDEVCTL: (range of supported s),(range of supported s),(list of supported s) Read Command AT+QNETDEVCTL? OK Response +QNETDEVCTL: ,,, Write Command AT+QNETDEVCTL=,[,] Maximum Response Time Characteristics OK Response OK If there is any error: +CME ERROR: Or ERROR 150 s, determined by network. The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Whether to activate the specified PDP context. 0 Deactivate the specified PDP context 1 Activate the specified PDP context only once. It will not reconnect the network once disconnecting from the network. 2 Activate the specified PDP context. It will reconnect the network after disconnecting from the network. 3 Activate PDP Context and automatically start the data call after rebooting the EG060V-EA&EG060W-EA_AT_Commands_Manual 124 / 167 LTE-A Module Series module. It will reconnect the network after disconnecting from the network. Integer type. PDP context ID. Range: 1–15. Integer type. Whether to enable URC report function. 0 Disable 1 Enable Integer type. Activation state. 0 Deactivated 1 Activated Error codes. For more details, refer to Chapter 12.2. Example AT+QNETDEVCTL=1,2,1 OK AT+QNETDEVCTL? +QNETDEVCTL: 1,2,1,1 OK AT+QNETDEVCTL=0,2 OK //Activate the PDP. //Query the current PDP context state. //Deactivate the PDP. 9.15. AT+QNETDEVSTATUS Show PDP Relevant Information This Write Command returns the relevant information , , , , and of an active non-secondary PDP context with the context identifier . If the MT has dual stack capabilities, two lines of information are returned per . The first line presents IPv4 parameters while the second line IPv6 parameters. If is omitted, the relevant information for all active non-secondary PDP contexts is returned. AT+ QNETDEVSTATUS Show PDP Relevant Information Test Command AT+QNETDEVSTATUS=? Response +QNETDEVSTATUS: (list of s of active contexts) Execution/Write Command AT+QNETDEVSTATUS[=] OK Response +QNETDEVSTATUS: ,,,,,, […] OK Or ERROR EG060V-EA&EG060W-EA_AT_Commands_Manual 125 / 167 LTE-A Module Series Maximum Response Time Characteristics 300 ms / Parameter Integer type. Specifies a particular PDP context (see AT+QICSGP for the definition of this context). Range: 1–15. String type. Shows the IP address of the MT. String type. Shows the subnet mask of the MT. String type. Shows the gateway address of the MT. String type. Shows the DHCP address. String type. Shows the IP address of the primary DNS server. String type. Shows the IP address of the secondary DNS server. Example AT+QICSGP? +QICSGP: 1,1,'cmnet','','',0 OK AT+QNETDEVSTATUS=? +QNETDEVSTATUS: (1) OK AT+QNETDEVSTATUS +QNETDEVSTATUS: 1,'10.253.107.97','','','','218.104.78.2','220.206.143.2' OK AT+QNETDEVSTATUS=1 +QNETDEVSTATUS: 1,'10.253.107.97','','','','218.104.78.2','220.206.143.2' OK EG060V-EA&EG060W-EA_AT_Commands_Manual 126 / 167 LTE-A Module Series 10 Audio Commands 10.1. AT+QAUDCFG Query and Configure Audio Tuning Process AT+QAUDCFG Query and Configure Audio Tuning Process Test Command AT+QAUDCFG=? Response +QAUDCFG: 'slic_IndRep',(list of supported s) Maximum Response Time OK 300 ms Example AT+QAUDCFG=? //Test Command +QAUDCFG: 'slic_IndRep',(0,1) OK 10.1.1. AT+QAUDCFG='slic_IndRep' Enable/Disable the Reporting of SLIC Analog Phone Events This command enables or disables the reporting of SLIC analog phone events. Currently, only the event of DTMF, on-hook, off-hook and incoming number are reported. These events are reported to the AT port through URC. You do not need to view application logs through the Debug port to check whether the operations on the phone meet expectations. AT+QAUDCFG='slic_IndRep' Enable/Disable the Reporting of SLIC Analog Phone Events Write Command Response AT+QAUDCFG='slic_IndRep'[,] If the operational parameter is omitted, query the current settings: +QAUDCFG: 'slic_IndRep', OK EG060V-EA&EG060W-EA_AT_Commands_Manual 127 / 167 LTE-A Module Series Maximum Response Time Characteristics If the operational parameter is specified, enable or disable the reporting of SLIC analog phone events: OK If there is any error: ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Enable or disable the reporting of SLIC analog phone events. 0 Disable 1 Enable ⚫NOTE 1. Currently the supported DTMF events include 0–9, * and #. 2. The command takes effect only when SLIC analog phone is working. Example AT+QAUDCFG='slic_IndRep',1 OK AT+QAUDCFG? +QAUDCFG: 'slic_IndRep',1 //Enable the reporting of SLIC analog phone events. //Query the current setting. OK +QIND: 'SLIC Hook off' //Pick up the phone and receive the off-hook URC. +QIND: 'SLIC DTMF',1 //Press number key 1 and receive the DTMF 1 URC. +QIND: 'Caller Number:xxxxxxxxxxx' //A call is incoming, and receive the incoming number URC. +QIND: 'SLIC Hook on' //Put down the phone and receive the on-hook URC. EG060V-EA&EG060W-EA_AT_Commands_Manual 128 / 167 LTE-A Module Series 10.2. AT+CLVL Loudspeaker Volume Level Selection This command selects the volume of the internal loudspeaker of MT. AT+CLVL Loudspeaker Volume Level Selection Test Command AT+CLVL=? Response +CLVL: (list of supporteds) Read Command AT+CLVL? OK Response +CLVL: Write Command AT+CLVL= Maximum Response Time Characteristics Reference Reference 3GPP TS 27.007 OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Volume level with manufacturer specific range (Smallest value represents the lowest sound level). Range: 0–5; Default: 3. Error codes. For more details, refer to Chapter 12.2. 10.3. AT+QLDTMF Play Local DTMF This command plays a local DTMF string. It can be used to stop playing the DTMF string. AT+QLDTMF Play Local DTMF Test Command AT+QLDTMF=? Response +QLDTMF: (range of supported s),(list of supported s) OK EG060V-EA&EG060W-EA_AT_Commands_Manual 129 / 167 LTE-A Module Series Write Command AT+QLDTMF=, [,] Response OK If there is any error: ERROR Or +CME ERROR: Execution Command AT+QLDTMF Maximum Response Time Characteristics Reference Quectel After the DTMF string is completely played: +QLDTMF: 5 Response OK 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Indicates every DTMF’s play time and mute time. Range: 1–1000. The unit is 1/100 second when is set to 1, or 1/10 second when is not set. String type. Maximum length: 20 characters, separated by comma. DTMF format: 0–9, *, #, A–D. Error codes. For more details, refer to Chapter 12.2. Example AT+QLDTMF=? +QLDTMF: (1-1000),(0-9,*,#,A-D) OK AT+QLDTMF=50,'1,2,A,B,#' OK AT+QLDTMF OK //Query the range. //Play '1,2,A,B,#' play time & mute time is 5 second. //Stop playing. EG060V-EA&EG060W-EA_AT_Commands_Manual 130 / 167 LTE-A Module Series 10.4. AT+QAUDLOOP Enable/Disable Audio Loop Test This command enables/disables audio loop test. AT+QAUDLOOP Enable/Disable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (list of supported s) Read Command AT+QAUDLOOP? OK Response +QAUDLOOP: Write Command AT+QAUDLOOP= Maximum Response Time Characteristics Reference Quectel OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Enables or disables audio loop test. 0 Disable audio loop test 1 Enable audio loop test 10.5. AT+QDAI Digital Audio Interface Configuration This command configures the digital audio interface. When there is no codec on board, you can define the PCM formats by themselves. In the following conditions, the MT can be used directly with default settings (master mode, short-synchronization, 2048 kHz clock frequency, 16-bit liner data format, 8 kHz sampling rate). AT+QDAI Digital Audio Interface Configuration Test Command AT+QDAI=? Response +QDAI: (list of supported s),(list of supported EG060V-EA&EG060W-EA_AT_Commands_Manual 131 / 167 LTE-A Module Series s),(list of supported s),(range of supported s),(list of supported s),(list of supported s),(list of supported s),(range of supported s) Read Command AT+QDAI? OK Response +QDAI: [,,,,,,,] Write Command AT+QDAI=[,,,[,[,[,,]]]] OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics Reference Quectel The command takes effect after the module is rebooted. The configuration is saved automatically. Parameter x Unused (1-3,5 can be set automatically). Integer type. Enable master or slave mode. 0 Master mode 1 Slave mode Integer type. Enable primary or auxiliary mode. 0 Primary mode (short-synchronization) 1 Auxiliary mode (long-synchronization) Integer type. Clock frequency. 0 128 kHz 1 256 kHz 2 512 kHz 3 1024 kHz 4 2048 kHz 5 4096 kHz Integer type. Data format. 0 16-bit linear Integer type. Choose a sampling rate. 0 8 kHz 1 16 kHz Integer type. EG060V-EA&EG060W-EA_AT_Commands_Manual 132 / 167 1 Number of slot Integer type. Slot mapping value. Range: 1–16. LTE-A Module Series NOTE 2. 4096 kHz clock frequency is only applicable for 16 kHz sampling rate. 3. 128 kHz clock frequency is not supported. 4. Bit per frame = /. For example, if is 2048 kHz and is 8 kHz, then bit per frame is 256. Bit per frame should be greater than 16. 5. When slave mode is selected, master and synchronization clock should be provided for the MT. When a recommended codec is selected and 16 kHz sampling rate is required, input . Currently only ALC5616 supports 16 kHz (AT+QDAI=3,0,0,4,0,0,1,1). 6. This command is currently applicable to EG060V-EA only. 10.6. AT+QSIDET Set Side Tone Gain in Current Mode This command sets the side tone gain value in current mode. It will take effect at next sound activity. AT+QSIDET Set Side Tone Gain in Current Mode Test Command AT+QSIDET=? Response +QSIDET: (list of supported s) Read Command AT+QSIDET? OK Response +QSIDET: Write Command AT+QSIDET= Maximum Response Time Characteristics Reference Quectel OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Indicates the configured side tone gain in current mode. Range: 0–65535. EG060V-EA&EG060W-EA_AT_Commands_Manual 133 / 167 Default value might be different in different audio modes. LTE-A Module Series NOTE This command will be valid only after audio loop test is enabled by AT+QAUDLOOP=1. 10.7. AT+QSLIC Enable/Disable SLIC This command enables/disables the SLIC. AT+QSLIC Enable/Disable SLIC Test Command AT+QSLIC=? Response +QSLIC: (list of supported s),(list of supported s) Read Command AT+QSLIC? OK Response +QSLIC: , Write Command AT+QSLIC=, Maximum Response Time Characteristics Reference Quectel OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Enables or disables SLIC. 0 Disable 1 Enable Integer type. Type of SLIC. 1 LE9643 (not supported currently) 2 SI32185 EG060V-EA&EG060W-EA_AT_Commands_Manual 134 / 167 LTE-A Module Series 10.8. AT+QAUDMOD Set Audio Mode This command sets the audio mode required for the connected device. It will take effect at next sound activity. AT+QAUDMOD Set Audio Mode Test Command AT+QAUDMOD=? Response +QAUDMOD: (range of supported s) Read Command AT+QAUDMOD? OK Response +QAUDMOD: Write Command AT+QAUDMOD= Maximum Response Time Characteristics Reference Quectel OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Indicates the current configured audio mode. 0 Echo canceller, noise suppressor, digital gain and calibration parameter for handset 1 Echo canceller, noise suppressor, digital gain and calibration parameter for headset 2 Echo canceller, noise suppressor, digital gain and calibration parameter for speaker 10.9. AT+QMIC Set Uplink Gains of Microphone This command sets the uplink gains of microphone. AT+QMIC Set Uplink Gains of Microphone Test Command AT+QMIC=? Response +QMIC: (range of supported s) EG060V-EA&EG060W-EA_AT_Commands_Manual 135 / 167 LTE-A Module Series Read Command AT+QMIC? Write Command AT+QMIC= Maximum Response Time Characteristics Reference Quectel OK Response +QMIC: OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Uplink digital gain. Range: 0–65535. The default value may be different in different audio modes. 10.10. AT+QRXGAIN Set Downlink Gains of RX This command sets RX digital gains to change the downlink volume. AT+QRXAGIN Set Downlink Gains of RX Test Command AT+QRXGAIN=? Response +QRXGAIN: (range of supported s) Read Command AT+QRXGAIN? OK Response +QRXGAIN: Write Command AT+QRXGAIN = Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. EG060V-EA&EG060W-EA_AT_Commands_Manual 136 / 167 LTE-A Module Series Reference Quectel The configuration is not saved automatically. Parameter Integer type. Downlink digital gains. Range: 0–65535. The default value might be different in different audio modes. 10.11. AT+VTS DTMF and Tone Generation This command sends ASCII characters which cause MSC to transmit DTMF tones to a remote subscriber. This command can only be operated in a voice call. AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (list of supported s),(range of supported s) Write Command AT+VTS=[,] Maximum Response Time Characteristics Reference Quectel OK Response OK Or ERROR Depends on the length of and . The command takes effect immediately. The configuration is not saved automatically. Parameter String type. ASCII characters in the set 0...9,#,*, A, B, C, D. The string should be enclosed in quotation marks ('...'). When sending multiple tones at a time, the time interval of two tones can be specified by AT+VTD. The maximal length of the string is 31 bytes. The duration of each tone in 10 ms with tolerance. Range: 300–600. Default: 300. If the duration is less than the minimum time specified by the network, the actual duration will be the network specified time. If this parameter is omitted, can be specified by AT+VTS. EG060V-EA&EG060W-EA_AT_Commands_Manual 137 / 167 Example ATD12345678900; OK //Call connected. AT+VTS='1' OK AT+VTS='1234567890A' OK LTE-A Module Series //Dial. //The remote caller can hear the DTMF tone. //Send multiple tones at a time. EG060V-EA&EG060W-EA_AT_Commands_Manual 138 / 167 LTE-A Module Series 11 Hardware Related Commands 11.1. AT+CCLK Clock This command sets and queries the real time clock (RTC) of the module. The current setting is retained until the module is totally disconnected from power. AT+CCLK Clock Test Command AT+CCLK=? Read Command AT+CCLK? Response OK Response +CCLK: Write Command AT+CCLK= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: +CME ERROR: Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter String type. The format is 'yy/MM/dd,hh:mm:ss±zz', indicating year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range: -48 to +56). E.g., May 6th, 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. EG060V-EA&EG060W-EA_AT_Commands_Manual 139 / 167 Example AT+CCLK? +CCLK: '20/09/29,15:39:31+32' OK //Query the local time. LTE-A Module Series 11.2. AT+QSCLK Enable/Disable Low Power Mode This command controls whether to enable low power mode. When the low power mode is enabled, the module can directly enter low power mode. AT+QSCLK Enable/Disable Low Power Mode Test Command AT+QSCLK=? Response +QSCLK: (list of support s) Read Command AT+QSCLK? OK Response +QSCLK: Write Command AT+QSCLK= OK Response OK Maximum Response Time Characteristics Reference Quectel 300 ms The command takes effect immediately. The configuration is not saved automatically. Parameter Integer type. Low power mode. 0 Disable 1 Enable. It is controlled by DTR EG060V-EA&EG060W-EA_AT_Commands_Manual 140 / 167 LTE-A Module Series 11.3. AT+QPOWD Power off This command shuts down the module. The UE returns OK immediately when the command is executed. Then the UE deactivates the network. After the deactivation is completed, the UE outputs POWERED DOWN and enters the shutdown state. The maximum time for unregistering network is 60 seconds. The UE is not allowed to turn off the power before the module STATUS pin is driven low or the URC POWERED DOWN is output to avoid data loss. AT+QPOWD Power off Test Command AT+QPOWD=? Response +QPOWD: (list of supported s) Execution Command AT+QPOWD[=] OK Response OK Maximum Response Time Characteristics 300 ms / Parameter Integer type. Power-off mode. 0 Immediate power down 1 Normal power down 11.4. AT+QADC Read ADC Value This command reads the voltage value of ADC channel. AT+QADC Read ADC Value Test Command AT+QADC=? Response +QADC: (list of supported s) Read Command AT+QADC= OK Response +QADC: , OK EG060V-EA&EG060W-EA_AT_Commands_Manual 141 / 167 LTE-A Module Series Maximum Response Time Characteristics 300 ms / Parameter Integer type. Channel number of the ADC. 0 ADC Channel 0 1 ADC Channel 1 Integer type. Whether the ADC value is read successfully. 0 Fail 1 Success Integer type. The voltage of specified ADC channel. Unit: mV. EG060V-EA&EG060W-EA_AT_Commands_Manual 142 / 167 LTE-A Module Series 12 Appendix References 12.1. References Table 3: Related Documents SN Document Name [1] V.25ter [2] 3GPP TS 27.007 [3] 3GPP TS 27.005 Remark Serial asynchronous automatic dialing and control Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; AT command set for User Equipment (UE) Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; Use of Data Terminal Equipment – Data Circuit terminating Equipment (DTE-DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Table 4: Terms and Abbreviations Abbreviation 3GPP ADC AMR APN ARFCN ASCII BAIC BAOC Description 3rd Generation Partnership Project Analog-to-Digital Converter Adaptive Multi-Rate Access Point Name Absolute Radio-Frequency Channel Number American Standard Code for Information Interchange Bar All Incoming Calls Bar All Outgoing Calls EG060V-EA&EG060W-EA_AT_Commands_Manual 143 / 167 BCD BOIC BOIC-exHC CBM CCH CHAP CS CSD CUG DCD DCE DCS DHCP DPCH DTE DTMF DTR EARFCN ECC ECM ECT EDGE EGPRS eHRPD EPS LTE-A Module Series Binary-Coded Decimal Bar Outgoing International Calls Bar Outgoing International Calls except to Home Country Cell Broadcast Message Control Channel Challenge-Handshake Authentication Protocol Circuit Switching Circuit Switch Data Closed User Group Data Carrier Detection Data Communication Equipment Data Coding Scheme Dynamic Host Configuration Protocol Dedicated Physical Channel Data Terminal Equipment Dual-Tone Multifrequency Data Terminal Ready E-UTRA Absolute Radio Frequency Channel Number Emergency Call Ethernet Networking Control Model Explicit Call Transfer supplementary service Enhanced Data Rates for GSM Evolution Enhanced General Packet Radio Service evolved High Rate Packet Data Evolved Packet System EG060V-EA&EG060W-EA_AT_Commands_Manual 144 / 167 E-UTRAN FDD FDPCH GGSN GMM GMT GPIO GPRS GSM HDR HLR HSDPA HSPA+ HSUPA ICCID IE IIC IMEI IMS IMSI IPv4 IPv6 IRA LLC LTE-A LTE-A Module Series Evolved Universal Terrestrial Radio Access Network Frequency Division Duplex Fraction-Dedicated Physical Channel Gateway GPRS Support Node GPRS Mobility Management Greenwich Mean Time General-Purpose Input/Output General Packet Radio Service Global System for Mobile Communications High Data Rate Home Location Register High Speed Downlink Packet Access High Speed Packet Access High Speed Uplink Packet Access Integrated Circuit Card Identifier Information Element Inter-Integrated Circuit International Mobile Equipment Identity IP Multimedia Subsystem IMS International Mobile Subscriber Identity Internet Protocol version 4 Internet Protocol version 6 International Reference Alphabet Logical Link Control Long Term Evolution Advanced EG060V-EA&EG060W-EA_AT_Commands_Manual 145 / 167 MAC ME MiFi MO MS MSC MSISDN MT NAS NCM NIC NITZ NSAPI NVM PAP PCI PCM P-CSCF PDP PDU PIN PLMN PPP PS PSC LTE-A Module Series Medium Access Control Mobile Equipment Mobile Wi-Fi Mobile Originated Mobile Station Mobile Switching Center Mobile Subscriber International ISDN/PSTN number Mobile Terminal Non-Access Stratum Network Control Model Network Interface Card Network Identity and Time Zone/Network Informed Time Zone Network Service Access Point Identifier Non-volatile-Memory Password Authentication Protocol Physical Cell Identity Pulse Code Modulation Proxy-Call Session Control Function Packet Data Protocol Packet Data Unit Personal Identification Number Public Land Mobile Network Point-to-Point Protocol Packet Switching Primary Synchronization Code EG060V-EA&EG060W-EA_AT_Commands_Manual 146 / 167 PUK QoS RAB RAT RDI RF RNDIS RP RP SC RR RRC RTC RTS/CTS RX RxQual SAP SDU SINR SM SMS SMSC SNDCP TA TCP TDD LTE-A Module Series PIN Unlock Key Quality of Service Radio Access Bearer Radio Access Technology Remote Defect Indication Radio Frequency Remote Network Driver Interface Specification Relay Protocol Relay Protocol Service Center Radio Resource Radio Resource Control Real-Time Clock Request To Send/Clear To Send Receive Receive Quality Service Access Point Service Data Unit Signal-to-interference-plus-noise Ratio Session Management Short Message Service Short Message Service Center SubNetwork Dependent Convergence Protocol Terminal Adapter Transmission Control Protocol Time Division Duplex EG060V-EA&EG060W-EA_AT_Commands_Manual 147 / 167 TE TFT TPDU UART UDP UE UICC UIM UMTS URC USB USC-2 (U)SIM U-TRA VLR WCDMA LTE-A Module Series Terminal Equipment Traffic Flow Template Transport Protocol Data Unit Universal Asynchronous Receiver/Transmitter User Datagram Protocol User Equipment Universal Integrated Circuit Card User Identity Model Universal Mobile Telecommunications System Unsolicited Result Code Universal Serial Bus Universal Character Set (UCS-2) Format (Universal) Subscriber Identity Module Universal Terrestrial Radio Access Network Visiting Location Register Wideband Code Division Multiple Access 12.2. Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. values are mostly used by common message commands. The following table lists most of the general and GRPS related ERROR codes. For some GSM protocol failure causes described in GSM specifications, the corresponding ERROR codes are not included here. EG060V-EA&EG060W-EA_AT_Commands_Manual 148 / 167 Table 5: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 10 11 12 13 14 15 16 17 18 20 21 22 23 24 25 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy SIM wrong Incorrect password SIM PIN2 required SIM PUK2 required Memory full Invalid index Not found Memory failure Text string too long Invalid characters in text string EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 149 / 167 LTE-A Module Series 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 901 Audio unknown error 902 Audio invalid parameters 903 Audio operation not supported 904 Audio device busy 12.3. Summary of CMS ERROR Codes Final result code +CMS ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. values are mostly used by common message commands. EG060V-EA&EG060W-EA_AT_Commands_Manual 150 / 167 Table 6: Different Coding Schemes of +CMS ERROR: Code of 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 331 332 500 512 Meaning ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode SIM not inserted SIM pin necessary PH SIM pin necessary SIM failure SIM busy SIM wrong SIM PUK required SIM PIN2 required SIM PUK2 required Memory failure Invalid memory index Memory full SMSC address unknown No network Network timeout Unknown SIM not ready EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 151 / 167 LTE-A Module Series 513 Message length exceeds 514 Invalid request parameters 515 ME storage failure 517 Invalid service mode 528 More message to send state error 529 MO SMS is not allowed 530 GPRS is suspended 531 ME storage full 12.4. Summary of URC Table 7: Summary of URC Index URC Display Meaning Condition 1 +CREG: Indicate registration status of the ME AT+CREG=1 After cell neighborhood changing +CREG: [,,[, shows whether the network has 2 AT+CREG=2 ]] currently indicated the registration of the ME, with location area code 3 +CGREG: Indicate network registration status of AT+CGREG=1 the ME +CGREG: [,, Indicate network registration and 4 AT+CGREG=2 [,]] location information of the ME 5 +CTZV: Time zone reporting AT+CTZR=1 6 +CTZE: ,, Extended time zone reporting AT+CTZR=2 +COLP: ,,[< The presentation of the COL 17 subaddr>],[],[] mobile originated call 24 RDY ME initialization is successful N/A 25 +CFUN: 1 All function of the ME is available N/A EG060V-EA&EG060W-EA_AT_Commands_Manual 152 / 167 LTE-A Module Series 26 +CPIN: SIM card pin state N/A 27 +QIND: SMS DONE SMS initialization finished N/A 28 +QIND: PB DONE Phonebook initialization finished N/A 29 POWERED DOWN Module power down AT+QPOWD +CGEV: REJECT , and was automatically rejected. +CGEV: NW REACT ,,[] reactivation AT+CGEREP=2,1 +CGEV: NW DEACT ,,[] deactivation +CGEV: ME DEACT ,,[] deactivation. AT+CGEREP=2,1 34 +CGEV: NW DETACH The network has forced a Packet AT+CGEREP=2,1 Domain detach. 35 +CGEV: ME DETACH The mobile equipment has forced a AT+CGEREP=2,1 Packet Domain detach. +CGEV: NW CLASS MS class. The mobile equipment has forced a 37 +CGEV: ME CLASS AT+CGEREP=2,1 change of MS class. 38 +CMTI: , New message is received, and saved AT+CNMI to memory +CMT: [], output directly to TE (PDU mode) +CMT: ,[],[,,,,, New short message is received and 40 AT+CNMI ,,] +CBM: < New CBM is received and output 41 AT+CNMI pdu> directly (PDU mode) +CBM: ,,,< New CBM is received and output 42 page>, +CDS: < New CDS is received and output 43 AT+CNMI pdu> directly (PDU mode) +CDS: ,,[],[],,, directly to TE (Text mode) 45 +CDSI: , New message status report is AT+CNMI received, and saved to memory EG060V-EA&EG060W-EA_AT_Commands_Manual 153 / 167 LTE-A Module Series 12.5. SMS Character Sets Conversions In 3GPP TS 23.038 DCS (Data Coding Scheme) defined three kinds of alphabets in SMS, GSM 7-bit default alphabet, 8-bit data and UCS2 (16-bit). AT+CSMP can set the DCS in text mode (AT+CMGF=1). In text mode, DCS (Data Coding Scheme) and AT+CSCS determine the way of SMS text input or output. Table 8: The Way of SMS Text Input or Output DCS GSM 7-bit GSM 7-bit GSM 7-bit UCS2 8-bit AT+CSCS GSM IRA UCS2 - The Way of SMS Text Input or Output Input or output GSM character sets. Input or output IRA character sets. Input: UE will convert IRA characters to GSM characters. Output: UE will convert GSM characters to IRA characters. Input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Input: UE will convert the UCS2 hex string to GSM characters. Output: UE will convert the GSM characters to UCS2 hex string. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. When DCS=GSM 7-bit, the input or output needs conversion. The detailed conversion tables are shown below. Table 9: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') 0 1 2 3 0 00 10 20 30 1 01 11 21 31 2 02 12 22 32 3 03 13 23 33 4 04 14 24 34 5 05 15 25 35 4 5 6 7 40 50 60 70 41 51 61 71 42 52 62 72 43 53 63 73 44 54 64 74 45 55 65 75 EG060V-EA&EG060W-EA_AT_Commands_Manual 154 / 167 LTE-A Module Series 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0A Submit 2A 3A 4A 5A 6A 7A B 0B Cancel 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 10: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B 0B 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C EG060V-EA&EG060W-EA_AT_Commands_Manual 155 / 167 LTE-A Module Series D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 11: GSM Extended Characters 0 1 2 3 4 5 6 7 0 1B40 1 2 3 4 1B14 5 6 7 8 1B28 9 1B29 A B C 1B3C D 1B3D E 1B3E F 1B2F Table 12: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='IRA') 0 0 1 2 3 4 20 20 30 00 5 6 7 50 20 70 EG060V-EA&EG060W-EA_AT_Commands_Manual 156 / 167 1 20 20 21 31 41 2 20 20 22 32 42 3 20 20 23 33 43 4 20 20 02 34 44 5 20 20 25 35 45 6 20 20 26 36 46 7 20 20 27 37 47 8 Backspace 20 28 38 48 9 20 20 29 39 49 A 0A Submit 2A 3A 4A B 20 Cancel 2B 3B 4B C 20 20 2C 3C 4C D 0D 20 2D 3D 4D E 20 20 2E 3E 4E F 20 20 2F 3F 4F LTE-A Module Series 51 61 52 62 53 63 54 64 55 65 56 66 57 67 58 68 59 69 5A 6A 1B3C 6B 1B2F 6C 1B3E 6D 1B14 6E 11 6F 71 72 73 74 75 76 77 78 79 7A 1B28 1B40 1B29 1B3D 20 Table 13: IRA Extended Characters A B C D E F 0 20 20 20 20 7F 20 1 40 20 20 5D 20 7D 2 20 20 20 20 20 08 3 01 20 20 20 20 20 4 24 20 5B 20 7B 20 5 03 20 0E 20 0F 20 6 20 20 1C 5C 1D 7C 7 5F 20 09 20 20 20 EG060V-EA&EG060W-EA_AT_Commands_Manual 157 / 167 LTE-A Module Series 8 20 20 20 0B 04 0C 9 20 20 1F 20 05 06 A 20 20 20 20 20 20 B 20 20 20 20 20 20 C 20 20 20 5E 07 7E D 20 20 20 20 20 20 E 20 20 20 20 20 20 F 20 60 20 1E 20 20 Table 14: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='IRA') 0 1 2 3 4 5 6 7 0 40 20 20 30 A1 50 BF 70 1 A3 5F 21 31 41 51 61 71 2 24 20 22 32 42 52 62 72 3 A5 20 23 33 43 53 63 73 4 E8 20 A4 34 44 54 64 74 5 E9 20 25 35 45 55 65 75 6 F9 20 26 36 46 56 66 76 7 EC 20 27 37 47 57 67 77 8 F2 20 28 38 48 58 68 78 9 C7 20 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B D8 2B 3B 4B C4 6B E4 C F8 C6 2C 3C 4C D6 6C F6 D 0D E6 2D 3D 4D D1 6D F1 E C5 DF 2E 3E 4E DC 6E FC EG060V-EA&EG060W-EA_AT_Commands_Manual 158 / 167 LTE-A Module Series F E5 C9 2F 3F 4F A7 6F E0 Table 15: GSM Extended Characters 0 1 2 3 4 5 6 7 0 7C 1 2 3 4 5E 5 6 7 8 7B 9 7D A B C 5B D 7E E 5D F 5C Because the low 8 bits of UCS2 character is the same as the IRA character: The conversion table of DCS=GSM 7-bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. The conversion table of fmt=GSM 7-bit and AT+CSCS='GSM' is similar to AT+CSCS='GSM'. The conversion table of fmt= GSM 7-bit and AT+CSCS='IRA' is similar to AT+CSCS='IRA'. The conversion table of fmt=GSM 7-bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. The difference is the way of SMS text input or output. See Table 8 for more details. EG060V-EA&EG060W-EA_AT_Commands_Manual 159 / 167 12.6. Release Cause Text List of AT+CEER Table 16: Release Cause Text List of AT+CEER CS Internal Cause No cause information available (default) Phone is offline No service available Network release, no reason given Received incoming call Client ended call UIM not present Access attempt already in progress Access failure, unknown source Concur service not supported by network No response received from network GPS call ended for user call SMS call ended for user call Data call ended for emergency call Rejected during redirect or handoff Lower-layer ended call Call origination request failed Client rejected incoming call Client rejected setup indication Network ended call No funds available EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 160 / 167 No service available Full service not available Maximum packet calls exceeded Video connection lost Video protocol closed after setup Video protocol setup failure Internal error CS Network Cause Unassigned/unallocated number No route to destination Channel unacceptable Operator determined barring Normal call clearing User busy No user responding User alerting, no answer Call rejected Number changed Non selected user clearing Destination out of order Invalid/incomplete number Facility rejected Response to status enquiry Normal, unspecified No circuit/channel available EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 161 / 167 Network out of order Temporary failure Switching equipment congestion Access information discarded Requested circuit/channel not available Resources unavailable, unspecified Quality of service unavailable Requested facility not subscribed Incoming calls barred within the CUG Bearer capability not authorized Bearer capability not available Service/option not available Bearer service not implemented ACM >= ACM max Requested facility not implemented Only RDI bearer is available Service/option not implemented Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 162 / 167 IE non-existent/not implemented Conditional IE error Message not compatible with state Recovery on timer expiry Protocol error, unspecified Interworking, unspecified CS Network Reject IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME GPRS services not allowed GPRS and non GPRS services not allowed MS identity cannot be derived Implicitly detached PLMN not allowed Location area not allowed Roaming not allowed GPRS services not allowed in PLMN No suitable cells in location area MSC temporary not reachable Network failure MAC failure Synch failure EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 163 / 167 Congestion GSM authentication unacceptable Service option not supported Requested service option not subscribed Service option temporary out of order Call cannot be identified No PDP context activated Semantically incorrect message Invalid mandatory information Message type non-existent Message type not compatible with state Information element non-existent Message not compatible with state RR release indication RR random access failure RRC release indication RRC close session indication RRC open session failure Low level failure Low level failure no redial allowed Invalid SIM No service Timer T3230 expired No cell available Wrong state EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 164 / 167 Access class blocked Abort message received Other causes Timer T303 expired No resources Release pending Invalid user data PS Internal Cause Invalid connection identifier Invalid NSAPI Invalid primary NSAPI PDP establish timeout Invalid field SNDCP failure RAB setup failure No GPRS context PDP activate timeout PDP modify timeout PDP inactive max timeout PDP lower layer error PDP duplicate Access technology change PDP unknown reason CS PS Network Cause LLC or SNDCP failure EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 165 / 167 Insufficient resources Missing or unknown APN Unknown PDP address or PDP type User authentication failed Activation rejected by GGSN Activation rejected, unspecified Service option not supported Requested service option not subscribed Service option temporary out of order NSAPI already used (not sent) Regular deactivation QoS not accepted Network failure Reactivation required Feature not supported Semantic error in the TFT operation Syntactical error in the TFT operation Unknown PDP context PDP context without TFT already activated Semantic errors in packet filter Syntactical errors in packet filter Invalid transaction identifier Semantically incorrect message Invalid mandatory information Message non-existent/not implemented EG060V-EA&EG060W-EA_AT_Commands_Manual LTE-A Module Series 166 / 167 Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Protocol error, unspecified LTE-A Module Series EG060V-EA&EG060W-EA_AT_Commands_Manual 167 / 167

RG50xQ&RM5xxQ 系列 AT 命令手册 5G 模块系列 版本：1.0 日期：2021-08-09 状态：受控文件 RG50xQ&RM5xxQ 系列 AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 文档历史 修订记录 版本 日期 - 2020-12-08 1.0 2021-08-09 作者 变更表述 Amos ZHANG/ Yosef ZHANG/ Harden XU/ Gibson PAN/ Tako ZHANG/ Amos ZHANG/ Yosef ZHANG/ Harden XU/ Tako ZHANG/ Evan JIN/ Ozzy ANG/ Shaun DUAN/ Joseph WANG/ Pacifier WANG/ Bill ZHANG 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 9 1 引言 ...................................................................................................................................................... 10 1.1. 本章概要 .................................................................................................................................... 10 1.2. 定义 ........................................................................................................................................... 10 1.3. AT 命令语句.............................................................................................................................. 11 1.4. AT 命令响应.............................................................................................................................. 12 1.5. AT 示例声明............................................................................................................................... 12 1.6. 支持的字符集............................................................................................................................. 12 1.7. AT 命令端口............................................................................................................................... 13 1.8. 未经请求的结果码 ..................................................................................................................... 13 1.9. 关闭程序 .................................................................................................................................... 13 2 通用命令 ............................................................................................................................................... 14 2.1. ATI 显示 MT 的 ID 信息........................................................................................................... 14 2.2. AT+GMI 请求制造商信息 ........................................................................................................ 15 2.3. AT+GMM 请求 MT 型号 ID ..................................................................................................... 15 2.4. AT+GMR 请求 MT 固件版本 ID .............................................................................................. 16 2.5. AT+CGMI 请求制造商信息 ..................................................................................................... 16 2.6. AT+CGMM 请求 MT 型号 ID................................................................................................... 17 2.7. AT+CGMR 请求 MT 固件版本 ID............................................................................................ 17 2.8. AT+GSN 请求国际移动设备识别码（IMEI 号） ..................................................................... 18 2.9. AT+CGSN 请求国际移动设备识别码（IMEI 号） .................................................................. 19 2.10. AT&F 重置 AT 命令设置为出厂设置 ....................................................................................... 19 2.11. AT&V 显示当前配置................................................................................................................ 20 2.12. AT&W 存储当前设置到用户自定义配置文件 .......................................................................... 21 2.13. ATZ 从用户定义配置文件还原所有 AT 命令设置 .................................................................... 21 2.14. ATQ 设置结果码回显模式 ....................................................................................................... 22 2.15. ATV MT 响应格式 ................................................................................................................... 22 2.16. ATE 设置命令回显模式 ........................................................................................................... 24 2.17. A/ 重复上一个命令行 .............................................................................................................. 24 2.18. ATS3 设置命令行终止符 ......................................................................................................... 25 2.19. ATS4 设置响应格式字符 ......................................................................................................... 25 2.20. ATS5 设置命令行编辑字符 ..................................................................................................... 26 2.21. ATX 设置 CONNECT 结果码格式和检测呼叫进程 ................................................................. 26 2.22. AT+CFUN 设置功能模式 ........................................................................................................ 27 2.23. AT+CMEE 设置错误讯息格式................................................................................................. 29 2.24. AT+CSCS 选择 TE 字符集 ..................................................................................................... 30 2.25. AT+QURCCFG 配置 URC 指示选项 ...................................................................................... 31 2.26. AT+QMBNCFG 设置 MBN 文件配置 ...................................................................................... 32 上海移远通信技术股份有限公司 3 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 2.26.1. 2.26.2. 2.26.3. 2.26.4. 2.26.5. 2.26.6. AT+QMBNCFG='List' 查询 MBN 文件列表................................................................. 32 AT+QMBNCFG='Select' 选择导入的 MBN 文件 ........................................................ 33 AT+QMBNCFG='Deactivate' 去激活 MBN 文件......................................................... 34 AT+QMBNCFG='AutoSel' 自动选择是否激活 MBN 文件 ........................................... 34 AT+QMBNCFG='Delete' 删除 MBN 文件 ................................................................... 35 AT+QMBNCFG='Add' 添加 MBN 文件 ....................................................................... 35 3 状态控制命令........................................................................................................................................ 37 3.1. AT+CPAS 查询 MT 活动状态.................................................................................................. 37 3.2. AT+CEER 拓展错误上报 ........................................................................................................ 38 3.3. AT+QCFG 拓展配置 ............................................................................................................... 39 3.3.1. AT+QCFG='hsdpacat' 配置 HSDPA 类别................................................................... 40 3.3.2. AT+QCFG='hsupacat' 配置 HSUPA 类别................................................................... 40 3.3.3. AT+QCFG='rrc' 配置 RRC 版本.................................................................................. 41 3.3.4. AT+QCFG='pdp/duplicatechk' 使用相同 APN 建立多个 PDN.................................... 42 3.3.5. AT+QCFG='risignaltype' 设置 RI 信号输出载波 ......................................................... 43 3.3.6. AT+QCFG='data_interface' 通过 PCIe/USB 接口设置网络端口/诊断端口通信 ......... 44 3.3.7. AT+QCFG='pcie/mode' 设置 PCIe RC/EP 模式......................................................... 45 3.3.8. AT+QCFG='usbspeed' 设置 USB 速率模式 ............................................................... 46 3.4. AT+QINDCFG 控制 URC 上报 ............................................................................................... 47 4 (U)SIM 卡相关命令............................................................................................................................... 49 4.1. AT+CIMI 查询 IMSI ................................................................................................................. 49 4.2. AT+CLCK 功能锁定 ................................................................................................................ 50 4.3. AT+CPIN PIN 管理 ................................................................................................................. 51 4.4. AT+CPWD 修改密码............................................................................................................... 53 4.5. AT+CSIM (U)SIM 卡访问........................................................................................................ 55 4.6. AT+CRSM (U)SIM 卡受限访问............................................................................................... 56 4.7. AT+CCHO 打开逻辑信道........................................................................................................ 57 4.8. AT+CCHC 关闭逻辑信道 ........................................................................................................ 58 4.9. AT+CGLA 通用 UICC 逻辑信道访问....................................................................................... 59 4.10. AT+QPINC 获取 PIN 剩余重试次数........................................................................................ 60 4.11. AT+QINISTAT 查询(U)SIM 卡初始化状态............................................................................... 61 4.12. AT+QSIMDET (U)SIM 卡检测 ................................................................................................ 62 4.13. AT+QSIMSTAT (U)SIM 卡插拔状态上报 ................................................................................ 63 4.14. AT+QUIMSLOT 设置(U)SIM 卡槽 .......................................................................................... 65 5 网络服务命令........................................................................................................................................ 66 5.1. AT+COPS 选择运营商............................................................................................................ 66 5.2. AT+CREG CS 域注册状态...................................................................................................... 68 5.3. AT+CGREG GPRS 网络注册状态.......................................................................................... 69 5.4. AT+CEREG EPS 网络注册状态 ............................................................................................. 71 5.5. AT+C5GREG 5GS 网络注册状态........................................................................................... 73 5.6. AT+CGDCONT 定义 PDP 上下文 .......................................................................................... 74 5.7. AT+C5GNSSAI 设置 5GS NSSAI .......................................................................................... 78 5.8. AT+C5GNSSAIRDP 读取 5GS NSSAI 动态参数值................................................................ 79 上海移远通信技术股份有限公司 4 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.9. AT+CSQ 查询信号强度........................................................................................................... 81 5.10. AT+QRSRP 查询 RSRP 值..................................................................................................... 82 5.11. AT+QRSRQ 查询 RSRQ 值.................................................................................................... 83 5.12. AT+QSINR 查询 SINR 值 ....................................................................................................... 84 5.13. AT+CPOL 配置首选运营商列表.............................................................................................. 85 5.14. AT+COPN 查询运营商名称列表 ............................................................................................. 87 5.15. AT+CTZU 自动更新时区......................................................................................................... 87 5.16. AT+CTZR 上报时区变化......................................................................................................... 88 5.17. AT+QLTS 获取通过网络同步的最新时间................................................................................ 90 5.18. AT+QNWINFO 查询网络信息 ................................................................................................. 92 5.19. AT+QSPN 查询运营商名称 .................................................................................................... 94 5.20. AT+QENG 查询主小区和邻区信息 ......................................................................................... 95 5.21. AT+QCAINFO 查询载波聚合参数......................................................................................... 100 5.22. AT+QENDC 查询 EN-DC 状态 ............................................................................................. 101 5.23. AT+QSCAN 搜索邻近小区 ................................................................................................... 102 5.24. AT+QNWCFG 配置和查询网络参数 ..................................................................................... 103 5.24.1. AT+QNWCFG='csi_ctrl' 控制 LTE 和 5G NR CSI 获取 ............................................ 104 5.24.2. AT+QNWCFG='lte_csi' 查询 LTE CSI 信息.............................................................. 105 5.24.3. AT+QNWCFG='nr5g_csi' 查询 5G NR CSI 信息...................................................... 106 5.24.4. AT+QNWCFG='lte_cell_id' 查询 LTE 小区标识........................................................ 106 5.24.5. AT+QNWCFG='nr5g_cell_id' 查询 5G NR SA 小区标识.......................................... 107 5.24.6. AT+QNWCFG='WCDMA_cqi' 查询 WCDMA CQI 信息 ........................................... 108 5.24.7. AT+QNWCFG='up/down' 获取增量时间内平均上下行速率 ..................................... 109 5.24.8. AT+QNWCFG='data_path' 查询 NSA 网络下用户层下行数据路径.......................... 110 5.24.9. AT+QNWCFG='dss_enable' 启用/禁用 DSS 功能 ....................................................111 5.24.10. AT QNWCFG='lapi' 设置 UE 低优先级..................................................................... 112 5.25. AT+QNWPREFCFG 配置网络搜索偏好 ............................................................................... 113 5.25.1. AT+QNWPREFCFG='gw_band' 配置 WCDMA 频段 ............................................... 113 5.25.2. AT+QNWPREFCFG='lte_band' 配置 LTE 频段........................................................ 114 5.25.3. AT+QNWPREFCFG='nsa_nr5g_band' 配置 5G NR NSA 频段 ............................... 115 5.25.4. AT+QNWPREFCFG='nr5g_band' 配置 5G NR SA 频段.......................................... 116 5.25.5. AT+QNWPREFCFG='mode_pref' 配置网络搜索模式.............................................. 117 5.25.6. AT+QNWPREFCFG='srv_domain' 配置服务域 ....................................................... 118 5.25.7. AT+QNWPREFCFG='voice_domain' 配置语音域.................................................... 119 5.25.8. AT+QNWPREFCFG='roam_pref' 配置漫游偏好 ...................................................... 120 5.25.9. AT+QNWPREFCFG='ue_usage_setting' 配置 UE 使用模式................................... 121 5.25.10. AT+QNWPREFCFG='policy_band' 查询运营商策略频段 ........................................ 121 5.25.11. AT+QNWPREFCFG='ue_capability_band' 查询 UE 频段能力 ................................ 123 5.25.12. AT+QNWPREFCFG='rat_acq_order' 配置 RAT 优先级........................................... 124 5.25.13. AT+QNWPREFCFG='nr5g_disable_mode' 禁用 5G NR 配置................................. 125 6 呼叫相关命令...................................................................................................................................... 127 6.1. ATA 呼叫应答 ........................................................................................................................ 127 6.2. ATD 发起呼叫 ....................................................................................................................... 128 6.3. ATH 挂断现有连接 ................................................................................................................ 130 上海移远通信技术股份有限公司 5 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 6.4. AT+CVHU 控制语音通话挂断 ............................................................................................... 130 6.5. AT+CHUP 挂断通话.............................................................................................................. 131 6.6. ATS0 设置自动应答前振铃次数 ............................................................................................ 131 6.7. ATS6 设置盲拨前的等待时间................................................................................................ 132 6.8. ATS7 设置呼叫建立完成的等待时间..................................................................................... 133 6.9. ATS8 设置逗号修饰符等待时间 ............................................................................................ 134 6.10. ATS10 设置断开连接延迟时间.............................................................................................. 134 6.11. AT+CSTA 选择地址类型 ....................................................................................................... 135 6.12. AT+CLCC 查询当前 MT 呼叫 ............................................................................................... 136 6.13. AT+CR 控制服务上报 ........................................................................................................... 137 6.14. AT+CRC 设置来电指示扩展格式 .......................................................................................... 138 6.15. AT+CRLP 设置无线链路协议................................................................................................ 139 6.16. AT+QECCNUM 配置紧急电话号码 ...................................................................................... 140 6.17. AT^DSCI 指示呼叫状态 ........................................................................................................ 144 7 电话本相关命令 .................................................................................................................................. 147 7.1. AT+CNUM 查询本机号码...................................................................................................... 147 7.2. AT+CPBF 搜索电话本记录 ..................................................................................................... 148 7.3. AT+CPBR 读取电话本记录................................................................................................... 149 7.4. AT+CPBS 设置电话本存储器 ............................................................................................... 150 7.5. AT+CPBW 写入电话本记录 .................................................................................................. 151 8 短消息相关命令 .................................................................................................................................. 153 8.1. AT+CSMS 选择短消息服务类型 ........................................................................................... 153 8.2. AT+CMGF 配置短消息模式 .................................................................................................. 154 8.3. AT+CSCA 设置短消息服务中心地址 .................................................................................... 155 8.4. AT+CPMS 配置短消息首选存储位置.................................................................................... 156 8.5. AT+CMGD 删除短消息 ......................................................................................................... 158 8.6. AT+CMGL 按照状态读取短消息 ........................................................................................... 159 8.7. AT+CMGR 按照索引读取短消息 .......................................................................................... 161 8.8. AT+CMGS 发送短消息 ......................................................................................................... 165 8.9. AT+CMMS 发送多条短消息.................................................................................................. 166 8.10. AT+CMGW 存储短消息 ........................................................................................................ 167 8.11. AT+CMSS 从存储器发送短消息 ........................................................................................... 169 8.12. AT+CNMA 新短消息确认........................................................................................................ 171 8.13. AT+CNMI 设置新短消息上报方式......................................................................................... 172 8.14. AT+CSCB 选择小区广播消息类型........................................................................................ 174 8.15. AT+CSDH 设置文本模式下参数显示 .................................................................................... 175 8.16. AT+CSMP 设置短消息文本模式参数.................................................................................... 176 9 分组域命令 ......................................................................................................................................... 178 9.1. AT+CGATT PS 域附着或去附着 ........................................................................................... 178 9.2. AT+CGQREQ 服务质量参数（请求的） .............................................................................. 179 9.3. AT+CGQMIN 服务质量参数（最低可接受的） .................................................................... 182 9.4. AT+CGACT PDP 上下文激活/去激活 ................................................................................... 184 9.5. AT+CGDATA 进入数传状态 .................................................................................................. 185 上海移远通信技术股份有限公司 6 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 9.6. AT+CGPADDR 显示 PDP 地址............................................................................................. 186 9.7. AT+CGEREP 分组域事件上报 ............................................................................................. 187 9.8. AT+CGSMS 选择 MO 短消息服务........................................................................................ 190 9.9. AT+QGDCNT 流量统计 ........................................................................................................ 190 9.10. AT+QGDNRCNT 5G NR 流量统计....................................................................................... 192 9.11. AT+QAUGDCNT 自动保存流量统计 .................................................................................... 193 9.12. AT+QNETDEVSTATUS 查询 RmNet 设备状态.................................................................... 194 10 补充业务命令...................................................................................................................................... 197 10.1. AT+CCFC 呼叫转移.............................................................................................................. 197 10.2. AT+CCWA 呼叫等待控制...................................................................................................... 199 10.3. AT+CHLD 呼叫相关补充业务 ............................................................................................... 201 10.4. AT+CLIP 主动上报来电号码 ................................................................................................. 203 10.5. AT+CLIR 主叫号码限制 ........................................................................................................ 205 10.6. AT+COLP 被叫线路识别显示 ............................................................................................... 206 10.7. AT+CSSN 补充业务通知 ...................................................................................................... 207 10.8. AT+CUSD 非结构化补充数据业务........................................................................................ 208 11 音频命令 ............................................................................................................................................. 210 11.1. AT+CLVL 扬声器音量等级选择............................................................................................. 210 11.2. AT+CRSL 设置铃声音量 ....................................................................................................... 211 11.3. AT+CMUT 控制静音 ............................................................................................................. 211 11.4. AT+QAUDLOOP 控制音频循环测试..................................................................................... 212 11.5. AT+VTS 生成 DTMF 音 ........................................................................................................ 213 11.6. AT+VTD 设置 DTMF 音时长................................................................................................. 214 11.7. AT+QAUDMOD 设置音频模式 ............................................................................................. 215 11.8. AT+QDAI 配置数字音频接口 ................................................................................................ 216 11.9. AT+QSIDET 设置当前模式的侧音增益................................................................................. 218 11.10. AT+QMIC 设置麦克风的上行增益 ........................................................................................ 219 11.11. AT+QIIC 读写 IIC .................................................................................................................. 220 11.12. AT+QPCMV 启用/禁用 UAC 功能......................................................................................... 221 11.13. AT+QLDTMF 控制本地 DTMF 音的播放 .............................................................................. 222 11.14. AT+QAUDCFG 查询和配置音频调音流程 ............................................................................ 223 11.14.1. AT+QAUDCFG='slic/AudLoop' 开启/关闭模拟话机的回环音测试功能和拨号音...... 223 11.14.2. AT+QAUDCFG='slic/LF_Ring' 设置状态寄存器 ....................................................... 224 11.14.3. AT+QAUDCFG='slic_IndRep' 配置 SLIC 模拟话机的事件上报功能 ........................ 225 11.14.4. AT+QAUDCFG='slic_cid' 测试 SLIC 的来电显示功能.............................................. 226 11.14.5. AT+QAUDCFG='aif' 切换音频接口和传输协议......................................................... 227 11.14.6. AT+QAUDCFG='i2s/cfg' 配置 I2S ............................................................................ 228 11.15. AT+QSLIC 启用/禁用 SLIC................................................................................................... 229 12 硬件相关命令...................................................................................................................................... 232 12.1. AT+QPOWD 关闭模块.......................................................................................................... 232 12.2. AT+CCLK 实时时钟 .............................................................................................................. 232 12.3. AT+QADC 查询 ADC 值 ....................................................................................................... 233 12.4. AT+QSCLK 配置休眠模式 .................................................................................................... 234 上海移远通信技术股份有限公司 7 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 12.5. AT+QTEMP 查询 MT 温度值 ................................................................................................ 235 12.6. AT+QAGPIO 设置 AP 或 PMU 的 GPIO 输出电平 ............................................................... 236 12.7. AT+QETH RGMII 扩展配置 .................................................................................................. 237 12.7.1. AT+QETH='rgmii' 启用/禁用 RGMII.......................................................................... 238 12.7.2. AT+QETH='ipptmac' 设置 IP Passthrough-RGMII 模式的 MAC 地址 ...................... 240 12.7.3. AT+QETH='routing' 设置多路拨号的路由规则 ......................................................... 240 12.7.4. AT+QETH='mac_address' 查询 RGMII 接口的 MAC 地址....................................... 242 12.7.5. AT+QETH='speed' 设置 RGMII 速率........................................................................ 243 12.7.6. AT+QETH='an' 启用/禁用 RGMII 自动协商 .............................................................. 244 12.7.7. AT+QETH='dm' 设置 RGMII 双工模式 ..................................................................... 245 12.7.8. AT+QETH='eth_driver' 选择待加载以太网驱动 ........................................................ 245 12.7.9. AT+QETH='eth_at' 使能/禁止通过以太网口收发 AT 命令 ........................................ 246 12.8. AT+QGETCAPABILITY 获取 UE 支持的频段和 LTE 传输速率等级 ..................................... 247 13 附录 .................................................................................................................................................... 249 13.1. 术语缩写 .................................................................................................................................. 249 13.2. AT&F 影响到的 AT 命令及参数................................................................................................ 256 13.3. AT&W 影响到的 AT 命令及参数 .............................................................................................. 258 13.4. ATZ 影响到的 AT 命令及参数 .................................................................................................. 258 13.5. CME ERROR 错误码汇总 ....................................................................................................... 259 13.6. CMS ERROR 错误码汇总 ....................................................................................................... 261 13.7. URC 汇总 ................................................................................................................................ 262 13.8. SMS 字符集转换 ..................................................................................................................... 265 13.9. AT+CEER 扩展错误报告列表.................................................................................................. 271 上海移远通信技术股份有限公司 8 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 表格索引 表 1：适用模块 ........................................................................................................................................... 10 表 4：AT 命令类型.......................................................................................................................................11 表 3：AT&V 响应 ........................................................................................................................................ 20 表 4：ATV0&ATV1 结果代码数值等效项和简要说明 ................................................................................. 23 表 5：延迟类别 ......................................................................................................................................... 181 表 6：术语缩写 ......................................................................................................................................... 249 表 7：AT&F 影响到的 AT 命令及参数....................................................................................................... 256 表 8：AT&W 影响到的 AT 命令及参数 ..................................................................................................... 258 表 9：ATZ 影响到的 AT 命令及参数 ......................................................................................................... 258 表 10：+CME ERROR: 错误码描述 ................................................................................................ 259 表 11：+CMS ERROR: 错误码描述 ................................................................................................ 261 表 12：URC 汇总 ..................................................................................................................................... 262 表 13：SMS 文本输入和输出方式............................................................................................................ 265 表 14：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） ........................................................... 265 表 15：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） ........................................................... 266 表 16：GSM 扩展字符（GSM 编码）...................................................................................................... 267 表 17：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'） ............................................................. 267 表 18：IRA 扩展字符 ................................................................................................................................ 268 表 19：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'） ............................................................. 269 表 20：GSM 扩展字符（ISO-8859-1/Unicode） ..................................................................................... 270 表 21：AT+CEER 扩展错误报告列表....................................................................................................... 271 上海移远通信技术股份有限公司 9 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 1 引言 1.1. 本章概要 本文档介绍移远通信 5G 模块 RG50xQ 和 RM5xxQ 系列模块支持的 AT 命令集。 表 1：适用模块 模块系列 RG50xQ RM5xxQ 模块 RG500Q-EA RG500Q-CN RG501Q-EU RG502Q-EA RM500Q 系列 RM502Q 系列 RM510Q-GL RM505Q-AE 1.2. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 上海移远通信技术股份有限公司 10 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 1.3. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 RG50xQ 和 RM5xxQ 系列模块实现的 AT 命令可以在语法上分为两类：基础类、S 参数类和扩展类， 如下所列。 ⚫ 基础类 基础类 AT 命令的格式为 AT 或 AT&，其中 是命令， 是该命令的参数。 以 ATE 为例，DCE 会根据 的取值确定是否将接收到的字符回显给 DTE。若 为可 选参数，则其被省略时将使用其默认值。 ⚫ S 参数类 此类 AT 命令格式有 ATS=，其中是 S 寄存器的索引，是赋予的参数值。 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 可以用分号（;）将多个命令放在同一行。此时只有第一个命令带有 AT 前缀。命令可以是大写或小写。 输入 AT 命令时，可以忽略空格。但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内； ⚫ 在 AT 命令名称中的 =、? 或 =? 内。 上海移远通信技术股份有限公司 11 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.4. AT 命令响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或 +CME ERROR: ，表示已经准备 好接收新命令。在返回最终的 OK，ERROR 或 +CME ERROR: 之前，会发送请求的响应消息。 以下是响应消息的格式： +CMD1: OK 或者 OK 1.5. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 1.6. 支持的字符集 RG50xQ 和 RM5xxQ 系列模块的 AT 命令接口默认使用 GSM 字符集，其支持的字符集如下： ⚫ GSM format ⚫ UCS2 ⚫ IRA 可以使用 AT+CSCS（3GPP TS 27.007）来配置和查询字符集，并在 3GPP TS 27.005 中对其进行定 义。字符集会影响 SMS 和 SMS 广播消息的发送和接收，以及电话簿条目文本字段的输入和显示。 上海移远通信技术股份有限公司 12 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 1.7. AT 命令端口 主串口端口和两个 USB 端口（USB MODEM 端口和 USB AT 端口）支持 AT 命令通信和数据传输。 1.8. 未经请求的结果码 作为未经请求的结果码和上报消息，URC 不会作为与已执行的 AT 命令相关的响应的一部分发出。 URC 由 RG50xQ 和 RM5xxQ 系列模块发出的报告消息，无需 TE 请求，并且在发生特定事件时自动发布。 若发生来电（RING），收到的短消息等，高/低压警报，高/低温警报等。 1.9. 关闭程序 建议执行 AT+QPOWD 关闭模块，因为这是最安全，最好的方法。通过让模块从网络注销并允许软件 在断开电源连接之前进入安全的数据状态来实现此过程。 发送 AT+QPOWD 后，请勿执行任何其他 AT 命令。成功执行命令后，模块将输出消息 POWERED DOWN，然后进入关机状态。为了避免数据丢失，建议在输出 URC POWERED DOWN 后等待 1 秒以断开 电源。若 65 秒后仍未收到 POWER DOWN，则必须强制断开电源。 上海移远通信技术股份有限公司 13 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 2 通用命令 2.1. ATI 显示 MT 的 ID 信息 该命令用于提供 MT 的 ID 信息。 ATI 显示 MT 的 ID 信息 执行命令 ATI 最大响应时间 特性说明 参考 V.25ter 响应 Quectel Revision: OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 字符串类型。MT 固件版本的 ID 信息。 举例 ATI Quectel RG500QEA Revision: RG500QEAAAR01A01M4G OK 上海移远通信技术股份有限公司 14 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 2.2. AT+GMI 请求制造商信息 该命令与第 2.5 章的 AT+CGMI 相同，用于返回制造商 ID 信息。 AT+GMI 请求制造商信息 测试命令 AT+GMI=? 执行命令 AT+GMI 响应 OK 响应 Quectel 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 2.3. AT+GMM 请求 MT 型号 ID 该命令与第 2.6 章的 AT+CGMM 相同，用于返回 MT 型号 ID 信息。 AT+GMM 请求 MT 型号 ID 测试命令 AT+GMM=? 执行命令 AT+GMM 响应 OK 响应 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 上海移远通信技术股份有限公司 15 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 2.4. AT+GMR 请求 MT 固件版本 ID 该命令与与第 2.7 章的 AT+CGMR 相同，用于提供 MT 固件版本的 ID 信息。 AT+GMR 请求 MT 固件版本 ID 测试命令 AT+GMR=? 执行命令 AT+GMR 响应 OK 响应 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 参数 字符串类型。MT 固件版本的 ID 信息，包括行终止符，在信息文本中不得超过 2048 个 字符。 举例 AT+GMR RG500QEAAAR01A01M4G OK 2.5. AT+CGMI 请求制造商信息 该命令与第 2.1 章的 AT+GMI 相同，用于返回制造商信息。 AT+CGMI 请求制造商信息 测试命令 AT+CGMI=? 执行命令 AT+CGMI 响应 OK 响应 Quectel OK 上海移远通信技术股份有限公司 16 / 277 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 / RG50xQ&RM5xxQ 系列 AT 命令手册 2.6. AT+CGMM 请求 MT 型号 ID 该命令与第 2.3 章的 AT+GMM 相同，用于返回 MT 型号 ID 信息。 AT+CGMM 请求 MT 型号 ID 测试命令 AT+CGMM=? 执行命令 AT+CGMM 响应 OK 响应 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 / 参数 字符串类型。设备类型的标识符。 2.7. AT+CGMR 请求 MT 固件版本 ID 该命令与第 2.4 章的 AT+GMR 相同，用于提供 MT 固件版本 ID 信息。 AT+CGMR 请求 MT 固件版本 ID 测试命令 AT+CGMR=? 执行命令 AT+CGMR 响应 OK 响应 OK 上海移远通信技术股份有限公司 17 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 / 参数 字符串类型。产品固件版本的 ID 信息，包括行终止符，在信息文本中不得超过 2048 个 字符。 2.8. AT+GSN 请求国际移动设备识别码（IMEI 号） 该命令与第 2.9 章的 AT+CGSN 相同，用于返回 ME 的国际移动设备识别码（IMEI 号），该号码允许 用户识别不同的 ME 设备。 AT+GSN 请求国际移动设备识别码（IMEI 号） 测试命令 响应 AT+GSN=? 执行命令 OK 响应 AT+GSN 最大响应时间 特性说明 参考 V.25ter OK 300 毫秒 / 参数 字符串类型。ME 的 IMEI 号。 备注 每台 ME 设备的序列号（IMEI 号）不同，因此可以用来识别 ME。 上海移远通信技术股份有限公司 18 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 2.9. AT+CGSN 请求国际移动设备识别码（IMEI 号） 该命令与第 2.8 章的 AT+GSN 相同，用于返回 ME 的国际移动设备识别码（IMEI 号）。 AT+CGSN 请求国际移动设备识别码（IMEI 号） 测试命令 响应 AT+CGSN=? 执行命令 OK 响应 AT+CGSN 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 / 参数 字符串类型。ME 的 IMEI 号。 备注 每台 ME 设备的序列号（IMEI 号）不同，因此可以用来识别 ME。 2.10. AT&F 重置 AT 命令设置为出厂设置 该命令用于将 AT 命令设置重置为制造商指定的默认值（详情参考表 7）。 AT&F 重置 AT 命令设置为出厂设置 执行命令 响应 AT&F[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 上海移远通信技术股份有限公司 19 / 277 参数 RG50xQ&RM5xxQ 系列 AT 命令手册 整型。 0 将所有 AT 命令设置重置为出厂设置。. 2.11. AT&V 显示当前配置 该命令用于显示一些 AT 命令参数的当前配置（详情参考表 3），包括不可读的单字母 AT 命令参数。 AT&V 显示当前配置 执行命令 AT&V 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 / 表 3：AT&V 响应 AT&V &C: 1 &D: 2 &F: 0 &W: 0 E: 1 Q: 0 V: 1 X: 4 Z: 0 S0: 0 S3: 13 S4: 10 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 OK 上海移远通信技术股份有限公司 20 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 2.12. AT&W 存储当前设置到用户自定义配置文件 该命令用于将当前的 AT 命令设置存储到 NVM 中的用户自定义配置文件中（详情参考表 9）。在上电或 执行 ATZ 时，将从用户自定义的配置文件中自动恢复 AT 命令设置。 AT&W 存储当前设置到用户定义配置文件 执行命令 响应 AT&W[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 参数 整型。 0 配置文件编号。用于存储当前的 AT 命令设置。 2.13. ATZ 从用户定义配置文件还原所有 AT 命令设置 该命令用于首先将 AT 命令设置重置为制造商的默认设置，与 AT&F 类似。若之前已将 AT 命令设置存 储在 AT&W 中，则从 NVM 中的用户定义配置文件中还原 AT 命令设置（详情参考表 9）。 同一命令行的任何其他 AT 命令都可以忽略。 ATZ 从用户定义配置文件还原所有 AT 命令设置 执行命令 响应 ATZ[] OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 参数 整型。 0 重置配置文件编号为 0。 上海移远通信技术股份有限公司 21 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 2.14. ATQ 设置结果码回显模式 该命令用于控制是否将结果码发送到 TE，作为响应发送的其他信息不受影响。 ATQ 设置结果码回显模式 执行命令 ATQ 响应 若=0： OK 最大响应时间 特性说明 参考 V.25ter 若=1： （无） 300 毫秒 / 参数 整型。 0 发送结果码。 1 结果码被禁止而不发送。 2.15. ATV MT 响应格式 该命令用于确定与 AT 命令结果码和信息响应一起发送的首尾的内容。 表 4 列出了结果码，其数值等效项以及每种用法的简要说明。 ATV MT 响应格式 执行命令 ATV 响应 若=0： 0 最大响应时间 特性说明 参考 若=1： OK 300 毫秒 / 上海移远通信技术股份有限公司 22 / 277 V.25ter RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。 0 信息返回： 短结果码格式： 1 信息返回： 长结果码格式： 举例 ATV1 OK AT+CSQ +CSQ: 30,99 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //设置=1。 //当=1 时，结果码是 OK。 //设置=0。 //当=0 时，结果码是 0。 表 4：ATV0&ATV1 结果代码数值等效项和简要说明 ATV1 OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY NO ANSWER ATV0 0 1 2 3 4 6 7 8 描述 确认执行命令 已建立连接；DCE 正从命令模式转换为数据模式 DCE 已检测到来自网络的来电信号 连接已终止或尝试建立连接失败 无法识别命令，超过命令行最大字符长度，参数值无效或其 他处理命令行的问题 未检测到拨号音 检测到占线（忙音）信号 使用了 @（等待静默应答）拨号修饰符，连接计时器（S7） 计时结束前，未检测到远程振铃后的五秒静音。 上海移远通信技术股份有限公司 23 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 2.16. ATE 设置命令回显模式 该命令用于控制 TA 是否在 AT 命令模式下回显从 TE 接收的字符。 ATE 设置命令回显模式 执行命令 ATE 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 / 参数 整型。是否回显从 TE 收到的字符。 0 关闭 1 开启 2.17. A/ 重复上一个命令行 该命令用于重复上一个 AT 命令行，'/'表示行终止符。 A/ 重复上一个命令行 执行命令 A/ 特性说明 参考 V.25ter 响应 重复上一个命令 / 举例 ATI Quectel RG500QEA Revision: RG500QEAAAR01A01M4G OK A/ Quectel //重复上一个命令。 上海移远通信技术股份有限公司 24 / 277 RG500QEA Revision: RG500QEAAAR01A01M4G OK RG50xQ&RM5xxQ 系列 AT 命令手册 2.18. ATS3 设置命令行终止符 该命令用于确定 TA 识别的字符以终止输入的命令行。同时生成结果代码和信息文本以及通过 ATS4 设 置的字符值。 ATS3 设置命令行终止符 查询命令 响应 ATS3? 设置命令 ATS3= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 / 参数 整型。命令行终止符。范围：0~127；默认值：13。 2.19. ATS4 设置响应格式字符 该命令用于确定 TA 为结果代码和信息文本生成的字符，以及通过 ATS3 设置的命令行终止字符。 ATS4 设置响应格式字符 查询命令 响应 ATS4? 设置命令 ATS4= OK 响应 OK 上海移远通信技术股份有限公司 25 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 参考 V.25ter 300 毫秒 / 参数 整型。响应格式字符。范围：0~127；默认值：10。 2.20. ATS5 设置命令行编辑字符 该命令用于确定 TA 用来从 AT 命令行删除紧接前一个字符的编辑字符值（等同于退格键）。 ATS5 设置命令行编辑字符 查询命令 响应 ATS5? 设置命令 ATS5= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 / 参数 整型。响应编辑字符。范围：0~127；默认值：8。 2.21. ATX 设置 CONNECT 结果码格式和检测呼叫进程 该命令用于确定 TA 是否将特定的结果代码发送到 TE。它还控制 TA 在开始拨号时是否检测到拨号音 和占线（忙音）信号。 上海移远通信技术股份有限公司 26 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 ATX 设置 CONNECT 结果码格式和检测呼叫进程 执行命令 响应 ATX OK 最大响应时间 300 毫秒 特性说明 / 参考 V.25ter 参数 整型。 0 仅返回 CONNECT 结果码，拨号音和忙音检测均禁用。 1 仅返回 CONNECT 结果码，拨号音和忙音检测均禁用。 2 返回 CONNECT 结果码，忙音检测禁用，可启用拨号音。 3 返回 CONNECT 结果码，拨号音检测禁用，但可启用忙音检测。 4 返回 CONNECT 结果码，拨号音和忙音检测均可启用。 2.22. AT+CFUN 设置功能模式 此命令用于控制功能模式，同时还可以用于重置 UE。 AT+CFUN 设置功能模式 测试命令 AT+CFUN=? 响应 +CFUN: (支持的列表),(支持的列表) 查询命令 AT+CFUN? OK 响应 +CFUN: 设置命令 AT+CFUN=[,] OK 响应 OK 最大响应时间 若出现任何错误与 MT 相关： +CME ERROR: 或 ERROR 15 秒，取决于网络状态 上海移远通信技术股份有限公司 27 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 特性说明 / 参考 3GPP TS 27.007 参数 整型。功能模式。 0 最小功能模式 1 全功能模式 4 禁用 UE 发送和接收 RF 信号功能 整型。是否复位。 0 将 UE 设置为功能模式前，不触发复位。 1 触发复位。复位后，该设备可以正常使用。该值仅适用于=1。 错误码。详请参考第 13.5 章。 举例 AT+CFUN=0 OK AT+COPS? +COPS: 0 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN=1234 OK +CPIN: READY +QUSIM: 1 +QIND: SMS DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE',7 //设置 UE 为最小功能模式。 //无网络。 //(U)SIM 卡读取失败。 //设置 UE 为全功能模式。 //注册上网络。 上海移远通信技术股份有限公司 28 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK 2.23. AT+CMEE 设置错误讯息格式 该命令用于禁用或启用将最终结果码+CME ERROR: 作为错误的指示。启用后，出现错误则返回 +CME ERROR: 的最终结果代码，而不是 ERROR。 AT+CMEE 设置错误讯息格式 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) 查询命令 AT+CMEE? OK 响应 +CMEE: 设置命令 AT+CMEE= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 / 参数 整型。 0 禁用结果码并改用 ERROR。 1 启用结果码，使用数值型取值。 2 启用结果码，使用详细值取值。 错误码。详情参考第 13.5 章。 举例 AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK //禁用结果码。 //仅显示 ERROR。 //启用数值型结果错误码。 上海移远通信技术股份有限公司 29 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted //启用具有详细（字符串）值的错误结果码。 2.24. AT+CSCS 选择 TE 字符集 该设置命令用于把 TE 使用的字符集报给 MT，以使 MT 能够在 TE 和 MT 的字符集之间正确转换字符 串。 AT+CSCS 选择 TE 字符集 测试命令 AT+CSCS=? 响应 +CSCS: (支持的列表) 查询命令 AT+CSCS? OK 响应 +CSCS: 设置命令 AT+CSCS= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 / 参数 整型。 'GSM' 'IRA' 'UCS2' GSM 默认字符集 国际参考字符集 UCS2 字符集 举例 AT+CSCS? +CSCS: 'GSM' //查询当前字符集。 //字符集为 GSM。 上海移远通信技术股份有限公司 30 / 277 OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK RG50xQ&RM5xxQ 系列 AT 命令手册 //设置字符集为 UCS2。 //配置后，查询字符集为 UCS2。 2.25. AT+QURCCFG 配置 URC 指示选项 该命令用于配置 URC 的输出端口。 AT+ QURCCFG 测试命令 AT+QURCCFG=? 配置 URC 指示选项 响应 +QURCCFG: 'urcport',(支持的列表) 设置命令 AT+QURCCFG='urcport'[,] OK 响应 若省略可选参数，则查询当前配置： +QURCCFG: 'urcport', OK 最大响应时间 特性说明 若指定可选参数，则配置 URC 的输出端口： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。设置 URC 的输出端口。 'usbat' USB AT 端口 'usbmodem' USB 调制解调器端口 'uart1' 主串口 'all' 所有端口 上海移远通信技术股份有限公司 31 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 举例 AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1','all') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' //查询URC输出端口的当前配置。 OK AT+QURCCFG='urcport','usbmodem' //将URC输出端口配置为USB调制解调器端口。 OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' OK 2.26. AT+QMBNCFG 设置 MBN 文件配置 AT+ QMBNCFG 测试命令 AT+QMBNCFG=? 设置 MBN 文件配置 响应 +QMBNCFG: 'List' +QMBNCFG: 'Select', +QMBNCFG: 'Deactivate' +QMBNCFG: 'AutoSel',(0,1) +QMBNCFG: 'Delete','' +QMBNCFG: 'Add','' OK 2.26.1. AT+QMBNCFG='List' 查询 MBN 文件列表 该命令用于查询导入的 MBN 文件列表。 AT+QMBNCFG='List' 查询 MBN 文件列表 设置命令 响应 AT+QMBNCFG='List' +QMBNCFG:'List',,,,,, … OK 上海移远通信技术股份有限公司 32 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。MBN 索引表示当前列出的已导入的 MBN 文件。 整型。表示是否选择了MBN文件。 0 未选择 1 已选择 整数类型。表示是否已激活 MBN 文件。 0 未激活 1 已激活 字符串类型。导入的 MBN 文件的名称。 字符串类型。导入的 MBN 文件的版本。 字符串类型。导入的 MBN 文件的发布日期。 举例 AT+QMBNCFG='list' +QMBNCFG: 'List',0,0,1,'ROW_Generic_3GPP',0x06010821,201706061 +QMBNCFG: 'List',1,0,0,'Volte_OpenMkt-Commercial-CMCC',0x06012064,201706061 +QMBNCFG: 'List',2,0,0,'OpenMkt-Commercial-CU',0x06011510,201706062 +QMBNCFG: 'List',3,0,0,'Telstra-Commercial_VoLTE',0x0680010F,201710261 +QMBNCFG: 'List',4,1,0,'hVoLTE-Verizon',0x060101A0,201801081 OK 2.26.2. AT+QMBNCFG='Select' 选择导入的 MBN 文件 该命令用于选择已加载的 MBN 文件。模块重启时，将激活所选的 MBN 文件。 AT+QMBNCFG='Select' 选择导入的 MBN 文件 设置命令 AT+QMBNCFG='Select'[,] 响应 若省略可选参数，则查询当前配置： +QMBNCFG: 'Select', OK 若指定可选参数，选择导入的 MBN 文件： OK 或者 ERROR 上海移远通信技术股份有限公司 33 / 277 最大响应时间 特性说明 参数 300 毫秒 该命令重启生效。 RG50xQ&RM5xxQ 系列 AT 命令手册 字符串类型。选择的 MBN 文件名称。 2.26.3. AT+QMBNCFG='Deactivate' 去激活 MBN 文件 去激活 MBN 文件后，当前激活的 MBN 文件变为非激活状态。 AT+QMBNCFG='Deactivate' 去激活 MBN 文件 设置命令 响应 AT+QMBNCFG='Deactivate' OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效。 举例 AT+QMBNCFG='LIST' +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 OK AT+QMBNCFG='Deactivate' OK AT+QMBNCFG='List' +QMBNCFG: 'List',0,0,0,'ROW_Commercial',0x05010800,201801051 OK 2.26.4. AT+QMBNCFG='AutoSel' 自动选择是否激活 MBN 文件 该命令用于自动选择是否通过(U)SIM 卡激活 MBN 文件。 AT+QMBNCFG='AutoSel' 自动选择是否激活 MBN 文件 设置命令 AT+QMBNCFG='AutoSel'[,] 响应 若省略可选参数，则查询当前配置： +QMBNCFG: 'AutoSel', OK 上海移远通信技术股份有限公司 34 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 或者 ERROR 若指定可选参数，自动选择是否通过(U)SIM 卡激活 MBN 文件： OK 或者 ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。启用/禁用自动激活 MBN 文件。 0 禁用 1 启用 2.26.5. AT+QMBNCFG='Delete' 删除 MBN 文件 该命令用于从 EFS 删除 MBN 文件。 AT+QMBNCFG='Delete' 删除 MBN 文件 设置命令 响应 AT+QMBNCFG='Delete', OK 或者 ERROR 特性说明 该命令重启后生效。 参数 字符串类型。删除的 MBN 文件名称。 2.26.6. AT+QMBNCFG='Add' 添加 MBN 文件 该命令用于添加 MBN 文件。 AT+QMBNCFG='Add' 添加 MBN 文件 设置命令 响应 AT+QMBNCFG='Add', OK 或者 上海移远通信技术股份有限公司 35 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。添加的 MBN 文件名称。 备注 MBN 文件需要提前上传到 UFS 空间。 举例 AT+QFUPL='test.mbn',9436 //上传 MBN 文件，详情请参考《RG50xQ&RM5xxQ 系列 _FILE_应用指导》。 CONNECT +QFUPL: 9436,657c OK AT+QMBNCFG='Add','test.mbn' OK //添加 MBN 文件。 上海移远通信技术股份有限公司 36 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 3 状态控制命令 3.1. AT+CPAS 查询 MT 活动状态 该命令用于查询 MT 的活动状态。 AT+CPAS 查询 MT 活动状态 测试命令 AT+CPAS=? 执行命令 AT+CPAS 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 +CPAS: (支持的列表) OK 响应 TA 返回 MT 的活动状态： +CPAS: OK 或者 ERROR 若出现任何错误与 MT 相关： +CME ERROR: 300 毫秒 / 参数 整型。MT 活动状态。 0 就绪 3 响铃 4 呼叫进行中 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 37 / 277 举例 AT+CPAS +CPAS: 0 OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129 OK AT+CPAS +CPAS: 4 OK RG50xQ&RM5xxQ 系列 AT 命令手册 //MT 处于就绪状态。 //MT 正在响铃。 //呼叫进行中。 3.2. AT+CEER 拓展错误上报 该命令用于查询拓展的错误并上报上次操作失败的原因，例如： ⚫ 拨打电话失败 ⚫ 通话失败（无论手机作为主叫或被叫） ⚫ 无法通过补充业务修改呼叫 ⚫ 无法激活，注册，查询，停用或注销补充业务 AT+CEER 拓展错误上报 测试命令 AT+CEER=? 执行命令 AT+CEER 响应 OK 响应 +CEER: OK 或者 ERROR 上海移远通信技术股份有限公司 38 / 277 最大响应时间 特性说明 RG50xQ&RM5xxQ 系列 AT 命令手册 若出现任何错误与 MT 相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。网络下发失败原因信息。上次拨打电话或通话失败的原因（详情参考第 13.9 章）。上报 CS 和 PS 域呼叫类型。原因数据是从呼叫管理事件中获取的，并在本 地缓存以供此命令以后使用。 错误码。详情参考第 13.5 章。 3.3. AT+QCFG 拓展配置 该命令用于查询 UE 的设置以及配置 UE。 AT+QCFG 拓展配置 测试命令 AT+QCFG=? 响应 +QCFG: 'hsdpacat',(支持的列表) +QCFG: 'hsupacat',(支持的列表) +QCFG: 'rrc',(支持的范围) +QCFG: 'pdp/duplicatechk',(支持的列表) +QCFG: 'risignaltype',(支持的列表) +QCFG: 'sarcfg',(支持的列表),(支持的范围), , +QCFG: 'data_interface',(支持的列表),(支持的 列表) +QCFG: 'pcie/mode',(支持的列表) +QCFG: 'usbspeed',(支持的列表) … 最大响应时间 OK 300 毫秒 上海移远通信技术股份有限公司 39 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 3.3.1. AT+QCFG='hsdpacat' 配置 HSDPA 类别 该命令用于指定 HSDPA 类别。 AT+QCFG='hsdpacat' 配置 HSDPA 类别 设置命令 AT+QCFG='hsdpacat'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'hsdpacat', OK 若指定可选参数，则设置 HSDPA 类别： OK 或者 ERROR 最大响应时间 特性说明 若出现任何错误与 MT 相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。HSDPA 类别。 6 类别 6 8 类别 8 10 类别 10 12 类别 12 14 类别 14 18 类别 18 20 类别 20 24 类别 24 错误码。详情参考第 13.5 章。 3.3.2. AT+QCFG='hsupacat' 配置 HSUPA 类别 该命令用于指定 HSUPA 类别。 AT+QCFG='hsupacat' 配置 HSUPA 类别 设置命令 AT+QCFG='hsupacat'[,] 响应 若省略可选参数，则查询当前配置： 上海移远通信技术股份有限公司 40 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 +QCFG: 'hsupacat', OK 若指定可选参数，则设置 HSUPA 类别： OK 或者 ERROR 若出现任何错误与 MT 相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。HSUPA 类别。 5 类别 5 6 类别 6 7 类别 7 8 类别 8 错误码。详情参考第 13.5 章。 3.3.3. AT+QCFG='rrc' 配置 RRC 版本 该命令用于指定 RRC 版本配置。 AT+QCFG='rrc' 配置 RRC 版本 设置命令 AT+QCFG='rrc'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'rrc', OK 若指定可选参数，则设置 RRC 版本： OK 或者 ERROR 若出现任何错误与 MT 相关： +CME ERROR: 上海移远通信技术股份有限公司 41 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。RRC 版本。 0 R99 1 R5 2 R6 3 R7 4 R8 5 R9 错误码。详情参考第 13.5 章。 3.3.4. AT+QCFG='pdp/duplicatechk' 使用相同 APN 建立多个 PDN 该命令用于允许/拒绝使用相同的 APN 配置文件建立多个 PDN。 AT+QCFG='pdp/duplicatechk' 使用相同 APN 建立多个 PDN 设置命令 AT+QCFG='pdp/duplicatechk'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'pdp/duplicatechk', OK 若指定可选参数，则允许/拒绝建立多个具有相同 APN 配置文 件的 PDN： OK 或者 ERROR 最大响应时间 特性说明 若出现任何错误与 MT 相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 42 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。 0 拒绝使用相同的 APN 配置文件建立多个 PDN 1 允许使用相同的 APN 配置文件建立多个 PDN 错误码。详情参考第 13.5 章。 3.3.5. AT+QCFG='risignaltype' 设置 RI 信号输出载波 该命令用于指定 RI（振铃指示器）信号输出载波。 AT+QCFG='risignaltype' 设置 RI 信号输出载波 设置命令 AT+QCFG='risignaltype'[, ] 响应 若省略可选参数，则查询当前配置： +QCFG: 'risignaltype', OK 若指定任意可选参数，则设置 RI 信号输出载波： OK 或者 ERROR 最大响应时间 特性说明 若出现任何错误与 MT 相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。RI 信号输出载波。 'respective' 振铃指示输出端口。 例如，若当前使用 UART 口，RI 引脚会同时产生振铃跳变。若 使用其他 USB 端口，RI 引脚不会有实际电平变化。若 URC 在 不支持振铃指示的 USB AT 端口输出，则没有振铃指示。 AT+QURCCFG='urcport'可以获取显示 URC 的输出端口。 'physical' 无论在哪个端口上报 URC，RI 引脚都会发生振铃跳变。 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 43 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 3.3.6. AT+QCFG='data_interface' 通过 PCIe/USB 接口设置网络端口/诊断端口通信 该命令用于通过 USB/PCIe 接口设置网络端口/诊断端口通信。 AT+QCFG='data_interface' 通过 PCIe/USB 接口设置网络端口/诊断端口通信 设置命令 响应 AT+QCFG='data_interface'[,,] +QCFG: 'data_interface',, OK 最大响应时间 特性说明 若指定任意可选参数，则通过 USB/PCIe 接口设置网络端口/ 诊断端口通信： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。 0 通过 USB 接口设置网络端口通信。 1 通过 PCIe 接口设置网络端口通信。 整型。 0 通过 USB 接口设置诊断端口通信。 备注 1. 如果通过 eFuse 将网络端口和诊断端口通信切换为 PCle 接口，该命令将无效，并且通信将无法再切 换回 USB。 2. 如果将网络端口设置为通过 USB 接口进行通信，则将禁用 PCIe 接口。因此，如果将网络端口设置为 通过 USB 接口通信，则 AT 端口或诊断端口不通过 PCle 接口通信。 3. 由 AT+QCFG='data_interface'切换的 PCle 接口仅适用于主机安装了 ARM 系统，并且模块的 USB 接口必须连接到主机。 4. 通过 eFuse 切换的 PCle 接口能连接主机来进行固件升级，而通过 AT+QCFG='data_interface'切换 的 PCle 接口不能连接主机进行固件升级。升级固件需通过 USB 接口进行。 5. 需重启模块时（例如：通过 DFOTA 升级固件后 5 秒，通过连接主机进行升级等），请确保主机和模块 同步重启，并确保开机时序与第一次初始化相同。 6. 不建议执行 AT+CFUN=1,1 通过 PCIe 接口重启模块，这样可能会导致 PCle 接口初始化时序错误， 进而导致 PCIe 接口初始化失败；建议通过硬件复位来重启模块。 上海移远通信技术股份有限公司 44 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 7. 如果模块或主机重启，请确保 PCIe 接口的初始化时序正确。 举例 AT+QCFG='data_interface' +QCFG: 'data_interface',0,0 OK AT+QCFG='data_interface',1,0 OK //查询当前配置。 //通过 PCIe 接口设置网络端口通信，并通过 USB 接口设置诊断端口通 信。AT 命令可以通过 USB 接口和 PCIe 接口进行通信。 3.3.7. AT+QCFG='pcie/mode' 设置 PCIe RC/EP 模式 该命令用于设置 PCIe RC/EP 模式。 AT+QCFG='pcie/mode' 设置 PCIe RC/EP 模式 设置命令 AT+QCFG='pcie/mode'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'pcie/mode', OK 最大响应时间 特性说明 若指定可选参数，则设置 PCIe RC/EP 模式： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。设置 PCIe RC 或 EP 模式。 0 PCIe EP 模式。. 1 PCIe RC 模式。 上海移远通信技术股份有限公司 45 / 277 举例 AT+QCFG='pcie/mode' +QCFG: 'pcie/mode',0 OK AT+QCFG='pcie/mode',1 OK //查询当前配置. RG50xQ&RM5xxQ 系列 AT 命令手册 3.3.8. AT+QCFG='usbspeed' 设置 USB 速率模式 当设备插入 USB 3.0 端口时，该命令用于设置 USB 速率模式。 AT+QCFG='usbspeed' 设置 USB 速度模式 设置命令 AT+QCFG='usbspeed'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'usbspeed', OK 最大响应时间 特性说明 若指定可选参数，则设置设置 USB 速率模式： OK 或者 ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 字符串类型。 ''20'' USB 2.0 高速 ''30'' USB 3.0 超高速 举例 AT+QCFG='usbspeed' //查询当前配置 +QCFG: 'usbspeed','30' OK AT+QCFG='usbspeed','20' OK 上海移远通信技术股份有限公司 46 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 3.4. AT+QINDCFG 控制 URC 上报 该命令用于控制 URC 的上报。 AT+QINDCFG 控制 URC 上报 测试命令 AT+QINDCFG=? 响应 +QINDCFG: 'all',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'csq',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'smsfull',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'ring',( 支 持 的 列 表 ),( 支 持 的 列表) +QINDCFG: 'smsincoming',(支持的列表),(支持 的列表) +QINDCFG: 'act',( 支 持 的 列 表 ),( 支 持 的 列表) 设置命令 AT+QINDCFG=[,[ ,]] OK 响应 若省略可选参数，则查询当前配置： +QINDCFG: <>, OK 最大响应时间 特性说明 若指定任意可选参数，则配置 URC 的上报： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置是否保存取决于。 上海移远通信技术股份有限公司 47 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 字符串类型。URC 类型。 'all' 是否上报所有类型的 URC。默认打开。 'csq' 信号强度和信道误码率变化指示（类似 AT+CSQ）。默认关闭。 若配置为打开，将上报 URC：+QIND: 'csq',, 'smsfull' 短消息存储已满指示。默认关闭。若配置为打开，将上报 URC： +QIND: 'smsfull', 'ring' RING 指示。默认打开。 'smsincoming' 新消息指示。默认打开。相关 URC 为：+CMTI、+CMT、+CDS 'act' 网络访问技术的变化。默认关闭。如果配置为打开，则将上报 URC： +QIND: 'act',。 是字符串类型。取值如下：: 'WCDMA' 'HSDPA' 'HSUPA' 'HSDPA&HSUPA' 'LTE' 'UNKNOWN' URC 的示例如下： +QIND: 'act','HSDPA&HSUPA' +QIND: 'act','UNKNOWN' 'act'的描述如下： 1. 若 MT 未注册网络，则为'UNKNOWN'。 2. 如果配置为打开，则将立即上报'act'的 URC。仅当网络访 问技术发生变化时，才会上报新的 URC。 整型。打开/关闭指定 URC 的上报。 0 关闭 1 打开 整型。是否将参数配置保存至 NVM。 0 不保存 1 保存 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 48 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 4 (U)SIM 卡相关命令 4.1. AT+CIMI 查询 IMSI 该命令用于查询(U)SIM 卡的国际移动用户识别码（IMSI），IMSI 允许 TE 识别 MT 中的(U)SIM 卡或 UICC （GSM 或者(U)SIM）中的活动应用程序。 AT+CIMI 查询 IMSI 测试命令 AT+CIMI=? 执行命令 AT+CIMI 响应 OK 响应 TA 返回，识别 MT 中的(U)SIM 卡。 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。国际移动用户识别码（无双引号的字符串）。 错误码。详情参考第 13.5 章。 举例 AT+CIMI 460023210226023 OK //查询 MT 中的(U)SIM 卡的 IMSI。 上海移远通信技术股份有限公司 49 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 4.2. AT+CLCK 功能锁定 该命令用于锁定、解锁 MT 或者网络功能，以及查询锁定状态。该命令一般需要一个密码。当查询网 络服务状态（为 2）时，若所有类型的服务状态未激活，则命令响应行就返回未激活的情 况。 AT+CLCK 功能锁定 测试命令 AT+CLCK=? 响应 +CLCK: (支持的列表) 设置命令 AT+CLCK=,[,[,]] OK 响应 当不等于 2 且命令执行成功： OK 当等于 2 且命令执行成功： +CLCK: [,] [+CLCK: [,]] […] OK 最大响应时间 5秒 特性说明 / 参考 3GPP TS 27.007 参数 字符串类型。 'SC' (U)SIM（锁定卡槽中当前所选的(U)SIM/UICC 卡）。(U)SIM/UICC 在 MT 开机且执 行锁定命令时需要一个密码。 'AO' BAOC（禁止所有呼出，详情参考 3GPP TS 22.088） 'OI' BOIC（禁止所有国际呼出，详情参考 3GPP TS 22.088） 'OX' BOIC-exHC（禁止所有国际呼出，归属国除外，详情参考 3GPP TS 22.088） 'AI' BAIC（禁止所有呼入，详情参考 3GPP TS 22.088） 'IR' BIC-Roam（归属地以外漫游时，禁止所有呼入，详情参考 3GPP TS 22.088） 'AB' 禁止所有业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 'AG' 禁止呼出业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 'AC' 禁止呼入业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 'FD' UICC（GSM 或(U)SIM）固定拨号存储器功能中的(U)SIM 卡或活动应用程序（若 当前会话中 PIN2 未完成身份验证，则需在中输入 PIN2）。 上海移远通信技术股份有限公司 50 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 'PF' 将电话锁定到最先插入的(U)SIM/UICC 卡（在本文档中也称为 PH-FSIM）（当插入 其他(U)SIM/UICC 卡时，MT 需要一个密码）。 'PN' 网络个性化（详情参考 3GPP TS 22.022） 'PU' 网络子集个性化（详情参考 3GPP TS 22.022） 'PP' 服务供应商个性化（详情参考 3GPP TS 22.022） 'PC' 企业个性化（详情参考 3GPP TS 22.022） 整型。操作模式。 0 解锁 1 锁定 2 查询状态 字符串类型。密码。 整型。数据类别。 1 语音 2 数据 4 传真 7 短消息以外所有电话通讯 8 短消息 16 数据线路同步 32 数据线路异步 整型。设备状态。 0 未锁定 1 已锁定 举例 AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK //查询 U(SIM)卡状态。 //U(SIM)卡未被锁定。 //锁定 U(SIM)卡，且密码为'1234'。 //查询 U(SIM)卡状态。 //U(SIM)卡被锁定。 //解锁 U(SIM)卡。 4.3. AT+CPIN PIN 管理 该命令用于向 MT 发送操作需要的密码或查询 MT 在操作前是否需要输入密码，密码可为(U)SIM PIN、 (U)SIM PUK、PH-SIM PIN 等。 上海移远通信技术股份有限公司 51 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 查询命令返回字母数字格式，指示是否需要密码。 MT 存储了操作前所需的密码，例如(U)SIM PIN 或(U)SIM PUK。如果要输入两次 PIN，MT 将自动重 复输入 PIN。如果没有 PIN 请求待处理，则不会采取任何措施，并且将返回+CME ERROR 给 TE。当 MT PIN 的类型为 SIM PIN/SIM PUK/PH-NET PIN 等时，MT 处于限制功能模式，需要通过设置命令发送密码给模 块来解锁，解锁成功后返回 OK，MT 解除限制模式。当 MT 不在限制模式时，设置命令发送密码则会报错。 如果 MT PIN 的类型为 SIM PUK 或 SIM PUK2，则需要输入第二个参数，用于替换(U)SIM 中的旧 PIN 码。 AT+CPIN PIN 管理 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 +CPIN: OK 设置命令 AT+CPIN=[,] 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 响应 OK 或者 +CME ERROR: 5秒 该命令立即生效； 参数配置自动保存。 参数 无引号的字符串类型。表示需要的密码类型。 READY 无密码等待输入 MT SIM PIN MT 正在等待(U)SIM PIN SIM PUK MT 正在等待(U)SIM PUK SIM PIN2 MT 正在等待(U)SIM PIN2 SIM PUK2 MT 正在等待(U)SIM PUK2 PH-NET PIN MT 正在等待网络个性化密码 PH-NET PUK MT 正在等待网络个性化解锁密码 PH-NETSUB PIN MT 正在等待网络子集个性化密码 PH-NETSUB PUK MT 正在等待网络子集个性化解锁密码 PH-SP PIN MT 正在等待服务提供商的个性化密码 上海移远通信技术股份有限公司 52 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 PH-SP PUK MT 正在等待服务提供商的个性化解锁密码 PH-CORP PIN MT 正在等待企业个性化密码 PH-CORP PUK MT 正在等待企业个性化解锁密码 字符串类型。密码。请求的密码类型为 PUK，例如(U)SIM PUK1、PH-FSIM PUK 或者其 他密码，则必须输入。 字符串类型。新密码。若请求的密码类型为 PUK，则需要重新输入新密码。 错误码。详情参考第 13.5 章。 举例 //输入 PIN AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //输入 PUK 和 PIN AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //查询有 PIN 码锁定。 //输入 PIN。 //已输入 PIN 码。 //正在等待输入(U)SIM PUK 码。 //输入 PUK 码和新密码。 //已输入 PUK 码。 4.4. AT+CPWD 修改密码 该命令用于修改 AT+CLCK 定义的功能锁定密码。测试命令返回两个参数，分别列出可用的功能及其 密码的最大长度。 上海移远通信技术股份有限公司 53 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 AT+CPWD 修改密码 测试命令 AT+CPWD=? 响应 +CPWD: (支持的列表), 设置命令 AT+CPWD=,, OK 响应 OK 最大响应时间 5秒 特性说明 参考 3GPP TS 27.007 该命令立即生效； 参数配置自动保存。 参数 字符串类型。 'SC' (U)SIM（锁定卡槽中当前所选的(U)SIM/UICC 卡）。(U)SIM/UICC 在 MT 开机且 执行锁定命令时需要一个密码。 'AO' BAOC（禁止所有呼出，详情参考 3GPP TS 22.088） 'OI' BOIC（禁止所有国际呼出，详情参考 3GPP TS 22.088） 'OX' BOIC-exHC（禁止所有国际呼出，归属国除外，详情参考 3GPP TS 22.088） 'AI' BAIC（禁止所有呼入，详情参考 3GPP TS 22.088） 'IR' BIC-Roam（归属地以外漫游时，禁止所有呼入，详情参考 3GPP TS 22.088） 'AB' 禁止所有业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 'AG' 禁止呼出业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 'AC' 禁止呼入业务（详情参考 3GPP TS 22.030），仅当=0 时有效。 'P2' (U)SIM PIN2 整型。密码最大长度。 字符串类型。从用户界面或使用该命令指定的密码。 字符串类型。新密码。 举例 AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' OK //重启模块或重新激活 SIM 卡。 AT+CPIN? //修改(U)SIM 卡密码为'4321'。 上海移远通信技术股份有限公司 54 / 277 +CPIN: SIM PIN OK AT+CPIN='4321' OK +CPIN: READY RG50xQ&RM5xxQ 系列 AT 命令手册 //正在等待输入(U)SIM PIN 码。 //必须输入 PIN 码以定义新密码'4321'。 4.5. AT+CSIM (U)SIM 卡访问 该命令允许通过 TE 上的远程应用直接控制安装在当前所选卡槽中的 SIM 卡。而且 TE 应在 GSM/UMTS 指定的帧内处理(U)SIM 信息。 AT+CSIM (U)SIM 卡访问 测试命令 AT+CSIM=? 设置命令 AT+CSIM=, 响应 OK 响应 +CSIM: , OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。或字符串的长度。 十六进制字符串类型。MT 发送至(U)SIM 卡的命令，格式参考 3GPP TS 51.011. 字符串类型。(U)SIM 卡向 MT 发送的响应，格式参考 3GPP TS 51.011. 错误码。详情参考第 13.5 章。. 上海移远通信技术股份有限公司 55 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 举例 AT+CSIM=10,'80F2010112' +CSIM: 40,'8410A0000000871002FF86FF0389FFFFFFFF9000' OK 4.6. AT+CRSM (U)SIM 卡受限访问 该命令可以对(U)SIM 数据库的进行简单而有限的访问，用于向 MT 传输(U)SIM 命令（） 及其所需的参数。 AT+CRSM (U)SIM 卡受限访问 测试命令 响应 AT+CRSM=? 设置命令 OK 响应 AT+CRSM=[,[,,,[,][,]]] +CRSM: ,[,] OK 或者 ERROR 最大响应时间 特性说明 参考 GSM 07.07 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。(U)SIM 命令。 176 READ BINARY（读取二进制文件） 178 READ RECORD（读取记录内容） 192 GET RESPONSE（获取响应） 214 UPDATE BINARY（更新二进制文件） 220 UPDATE RECORD（更新记录内容） 242 STATUS（状态查询） 203 RETRIEVE DATA（获取数据） 219 SET DATA（写入数据） 上海移远通信技术股份有限公司 56 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 , , , 整型。对于来说，它是(U)SIM 上基本数据文件的标识符。 MT 传送到(U)SIM 卡的参数。除 GET RESPONSE 和 STATUS 外，其他命令均需 包含此参数。参数值参考 3GPP TS 51.011。 十六进制字符格式。待写入到(U)SIM 卡上的信息。详情参考 AT+CSCS。 十六进制字符格式。(U)SIM/UICC 中基本文件路径。 整型。(U)SIM 关于实际命令执行的信息。在命令执行成功或失败时，这些参数都 会传递给 TE。 十六进制字符串格式。命令发送成功后的响应。详情参考 AT+CSCS。STATUS 和 GET RESPONSE 返回有关当前基本数据字段信息，该信息包括文件类型及其大小 参考 3GPP TS 51.011。在 READ BINARY、READ RECORD 或 RETRIEVE DATA 命令之后，将返回所请求的数据。成功执行 UPDATE BINARY、UPDATE RECORD 或 SET DATA 命令后，不会返回。 错误码。详情参考第 13.5 章。 举例 AT+CRSM=214,28539,0,0,12,'FFFFFFFFFFFFFFFFFFFFFFFF' +CRSM: 144,0,'' OK 4.7. AT+CCHO 打开逻辑信道 该命令用于打开一个逻辑通道。使用受限 UICC 逻辑通道访问命令（AT+CRLA）和通用 UICC 逻辑通 道访问命令（AT+CGLA）时需要输入。 AT+CCHO 打开逻辑信道 测试命令 AT+CCHO=? 执行命令 AT+CCHO= 响应 OK 响应 +CCHO: 最大响应时间 特性说明 参考 3GPP TS 31.101 OK 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 57 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。智能卡上的目标应用程序使用逻辑信道的会话 ID。 UICC 中的所有可选应用程序，以 1 到 16 字节方式编码的 DF 名称来引用。 错误码。详情参考第 13.5 章。. 举例 AT+CCHO=? OK AT+CCHO= 'A0000000871002FF86FFFF89FFFFFFFF' +CCHO: 1 OK //打开逻辑信道。 4.8. AT+CCHC 关闭逻辑信道 该命令用于请求 ME 关闭一个活跃的 UICC 会话。ME 必须关闭之前打开的逻辑信道。TE 将不会再在 此信道发送命令。收到该命令时，UICC 将关闭逻辑信道。 AT+CCHC 关闭逻辑信道 测试命令 AT+CCHC=? 执行命令 AT+CCHC= 最大响应时间 特性说明 参考 3GPP TS 31.101 响应 OK 响应 OK 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。智能卡上的目标应用程序使用逻辑信道的会话 ID。 错误码。详情参考第 13.5 章。. 举例 AT+CCHC=? 上海移远通信技术股份有限公司 58 / 277 OK AT+CCHC=1 OK RG50xQ&RM5xxQ 系列 AT 命令手册 //关闭逻辑信道。 4.9. AT+CGLA 通用 UICC 逻辑信道访问 该命令允许 TE 上的远程应用程序直接控制当前选择的 UICC。TE 必须在 GSM/UMTS 指定的帧内处 理 UICC 信息。 AT+CGLA 通用 UICC 逻辑信道访问 测试命令 响应 AT+CGLA=? 设置命令 OK 响应 AT+CGLA=,, +CGLA: , OK 最大响应时间 特性说明 参考 3GPP TS 31.101 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。用于将 APDU 命令发送到 UICC 的会话的标识符。智能卡上的目标应用程序使 用逻辑信道而非默认信道（信道 0）时，必须输入该参数向 UICC 发送命令。 整型。发往 TE 的或者的字符长度（例如：原始字节数的两倍）。 MT 传递给 UICC 的命令，十六进制字符串格式，在 3GPP TS 31.101 定义。参见 AT+CSCS。 UICC 给 MT 传递的命令的响应，十六进制字符串格式，在 3GPP TS 31.101 定义。 参见 AT +CSCS。 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 59 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 备注 使用该命令前需先通过 AT+CCHO=开启逻辑通道。 举例 AT+CGLA=? OK AT+CGLA= 1,10,'80F2010112' +CGLA: 40,'8410A0000000871002FF86FFFF89FFFFFFFF9000' OK 4.10. AT+QPINC 获取 PIN 剩余重试次数 该命令用于查询剩余输入(U)SIM PIN/PUK 密码的次数。 AT+QPINC 获取 PIN 剩余重试次数 测试命令 AT+QPINC=? 响应 +QPINC: (支持的列表) 查询命令 AT+QPINC? OK 响应 +QPINC: 'SC',, +QPINC: 'P2',, 设置命令 AT+QPINC= OK 响应 +QPINC: ,, 最大响应时间 特性说明 OK 或者 ERROR 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 60 / 277 参数 字符串类型。 'SC' (U)SIM PIN 'P2' (U)SIM PIN2 整型。剩余输入 PIN 密码的次数。 整型。剩余输入 PUK 密码的次数。 错误码。详情参考第 13.5 章。. 举例 AT+QPINC? +QPINC: 'SC',3,10 +QPINC: 'P2',3,10 OK RG50xQ&RM5xxQ 系列 AT 命令手册 4.11. AT+QINISTAT 查询(U)SIM 卡初始化状态 该命令用于查询(U)SIM 卡初始化状态。 AT+QINISTAT 查询(U)SIM 卡初始化状态 测试命令 AT+QINISTAT=? 响应 +QINISTAT: (支持的范围) 执行命令 AT+QINISTAT OK 响应 +QINISTAT: 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。(U)SIM 卡初始化状态。实际值是以下四个数字中任意几个数字之和（例如：7 = 1 + 2 + 4 表示 CPIN READY + SMS DONE + PB DONE，即 CPIN 已就绪，SMS 初始化完成且电 话簿初始化完成)。 0 初始化状态 1 CPIN READY。CPIN 已就绪，可执行锁定/解锁 PIN 操作。 上海移远通信技术股份有限公司 61 / 277 2 SMS DONE。SMS 初始化完成。 4 PB DONE。电话簿初始化完成。 举例 AT+QINISTAT +QINISTAT: 7 OK RG50xQ&RM5xxQ 系列 AT 命令手册 4.12. AT+QSIMDET (U)SIM 卡检测 该命令用于查询/启用/禁用(U)SIM 卡的热插拔功能。GPIO 中断用于检测(U)SIM 卡，插入(U)SIM 卡时 需设置(U)SIM 卡检测引脚的电平。 AT+QSIMDET (U)SIM 卡检测 测试命令 AT+QSIMDET=? 响应 +QSIMDET: (支持的列表),(支持的列 表) 查询命令 AT+QSIMDET? OK 响应 +QSIMDET: , 设置命令 OK 响应 AT+QSIMDET=, OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 该命令重启后生效； 参数配置后自动保存。 参数 整型。启用/禁用(U)SIM 卡检测功能。 0 禁用 1 启用 整型。插入(U)SIM 卡时，引脚检测的电平。 0 低电平 1 高电平 上海移远通信技术股份有限公司 62 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 备注 若配置的值与硬件设计不一致，热插拔功能无效。 举例 AT+QSIMDET=1,0 OK +CPIN: NOT READY +CPIN: READY //(U)SIM 卡插入时，(U)SIM 检测引脚电平设为低电平。 4.13. AT+QSIMSTAT (U)SIM 卡插拔状态上报 该命令用于查询/启用/禁用(U)SIM 卡的插拔状态上报功能。 AT+QSIMSTAT (U)SIM 卡插拔状态上报 测试命令 AT+QSIMSTAT=? 响应 +QSIMSTAT: (支持的列表) 查询命令 AT+QSIMSTAT? OK 响应 +QSIMSTAT: , 设置命令 AT+QSIMSTAT= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 63 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。启用/禁用(U)SIM 卡插拔状态上报功能。当开启时，将上报 URC +QSIMSTAT: ,指示(U)SIM 卡的插拔状态。 0 禁用 1 启用 整型。(U)SIM 卡的插拔状态。该参数不允许配置。 0 拔出 1 插入 2 未知状态。该状态出现在(U)SIM 卡初始化之前。 举例 AT+QSIMSTAT? +QSIMSTAT: 0,1 //查询(U)SIM 卡的插拔状态。 OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 //使能(U)SIM 卡的插拔状态上报功能。 OK +QSIMSTAT: 1,0 //上报(U)SIM 卡的插拔状态：拔出。 +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK +QSIMSTAT: 1,1 //上报(U)SIM 卡的插拔状态：插入。 +CPIN: READY 上海移远通信技术股份有限公司 64 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 4.14. AT+QUIMSLOT 设置(U)SIM 卡槽 该命令用于查询当前使用的(U)SIM 卡槽，并设置需要使用的(U)SIM 卡槽。 AT+QUIMSLOT 设置(U)SIM 卡槽 测试命令 AT+QUIMSLOT=? 响应 +QUIMSLOT: (支持的列表) 查询命令 AT+QUIMSLOT? OK 响应 +QUIMSLOT: 设置命令 AT+QUIMSLOT= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。物理(U)SIM 卡槽。 1 (U)SIM 卡槽 1 2 (U)SIM 卡槽 2 举例 AT+QUIMSLOT? +QUIMSLOT: 1 OK AT+QUIMSLOT=2 OK //查询当前使用的(U)SIM 卡槽。 //将(U)SIM 卡槽设置为 (U)SIM 卡槽 2。 上海移远通信技术股份有限公司 65 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5 网络服务命令 5.1. AT+COPS 选择运营商 该命令用于查询、配置当前模块的找网模式，并查询模块的注网状态。同时还可用于配置注册的运营 商以及网络制式。 测试命令返回五个参数，分别代表网络中出现的运营商。返回运营商列表显示顺序为：归属地网络， (U)SIM 卡推荐网络和其他网络。 查询命令返回当前找网模式和当前所选运营商。如果未选择任何运营商，则不会返回、 和。 设置命令用于强制选择并注册网络运营商，即使所选的网络运营商不可用，也不可选择其他任何运营 商（=4 除外）。所选运营商名称的格式也应适用于查询命令 AT+COPS?。 AT+COPS 选择运营商 测试命令 AT+COPS=? 响应 +COPS: [ 支 持 的 运 营 商 列 表 (, 长 字 符 , 短 字 符 , 数 字 [,])][,,( 支 持 的 范 围 ),( 支 持 的 范围)] OK 查询命令 AT+COPS? 若错误与 MT 功能相关： +CME ERROR: 响应 +COPS: [,[,][,]] OK 设置命令 AT+COPS=[,[,[,]]] 若错误与 MT 功能相关： +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 66 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 180 秒，取决于网络状态 / 参数 整型。运营商状态。 0 未知 1 可用运营商 2 当前选择的运营商 3 禁止选择的运营商 字符串类型。运营商。表示该字符串采用的格式。 整型。 0 自动搜网，省略 1 手动搜网，不可省略且可选 2 手动注销网络 3 仅设置（用于查询命令 AT+COPS?）；不进行注册或注销（省略 和）；该取值不适用于查询命令的返回结果。 4 手动和自动搜网的组合模式，字段不可省略。如果手动选择失败，将进入自 动选择模式（=0）。 整型。的格式。 0 长字符串格式，最多 16 个字符 1 短字符串格式 2 数字格式。 整型。接入网络。取值 4、5 和 6 仅适用于当 MS 处于数据服务状态时查询命令的返回结果， 且不可用于设置命令。 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 10 连接到 5GCN 的 E-UTRAN 11 连接到 5GCN 的 NR 12 NG-RAN 13 E-UTRAN-NR 双重连接 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 67 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 举例 AT+COPS=? //列举当前所有的网络运营商。 +COPS: (1,'CHN-UNICOM','UNICOM','46001',2),(2,'CHN-UNICOM','UNICOM','46001',7),(3,'46011','460 11','46011',7),(3,'CHINA MOBILE','CMCC','46000',7),,(0-4),(0-2) OK AT+COPS? +COPS: 0,0,'CHINA MOBILE',13 //查询当前模块的找网模式和运营商。 OK 5.2. AT+CREG CS 域注册状态 查询命令返回网络注册状态和结果码显示状态。表示 MT 的网络注册状态。仅当 MT 注册到网络 和=2 时，才会返回位置信息和。 设置命令设置是否显示 URC，以及在=1 且 MT 网络注册状态发生变化时，控制是否显示 URC +CREG: 。 AT+CREG CS 域注册状态 测试命令 AT+CREG=? 响应 +CREG: (支持的范围) 查询命令 AT+CREG? OK 响应 +CREG: ,[,,[,]] OK 设置命令 AT+CREG=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 响应 OK 300 毫秒 / 上海移远通信技术股份有限公司 68 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。是否启用网络注册相关 URC。 0 禁用网络注册 URC 1 启用网络注册 URC +CREG: 2 启用带有位置信息的网络注册 URC +CREG: [,,[,]] 整型。注册状态。 0 未注册，MT 当前未搜索要注册的运营商 1 已注册，归属地网络 2 未注册，MT 正在搜索要注册的运营商 3 注册被拒绝 4 未知状态 5 已注册，漫游网络 字符串类型。位置区编号。2 个字节（16 进制格式）。 字符串类型。小区 ID。28 位 （UMTS/LTE）（16 进制格式）。 整型。接入网络。 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 10 连接到 5GCN 的 E-UTRAN 11 连接到 5GCN 的 NR 12 NG-RAN 13 E-UTRAN-NR 双重连接 错误码。详情参考第 13.5 章。 举例 AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'D509','80D413D',7 //URC 上报 MT 已经注册到归属地网络。 //启用带有位置信息的网络注册 URC。 //URC 上报带小区 ID 和位置区号的运营商。 5.3. AT+CGREG GPRS 网络注册状态 该命令用于查询网络注册状态并控制非请求结果码上报： 上海移远通信技术股份有限公司 69 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 ⚫ =1 时，控制 URC +CGREG: 的上报，该 URC 表示 GERAN/UTRAN 中 MT 的 GPRS 网络注册状态的变化。 ⚫ =2 时，控制 URC +CGREG: [,[],[],[],[]]的上报，该 URC 表示 GERAN/UTRAN 中的网络小区的变化。 AT+CGREG GPRS 网络注册状态 测试命令 AT+CGREG=? 响应 +CGREG: (支持的范围) 查询命令 AT+CGREG? OK 响应 +CGREG: ,[,[],[],[],[]] 设置命令 AT+CGREG=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 或者 ERROR 300 毫秒 / 参数 整型。控制指定 URC 的上报。 0 禁止上报网络注册 URC 1 允许上报网络注册 URC +CGREG: 2 允许上报网络注册和位置信息 URC+CGREG: [,[],[],[],[]] 整型。GPRS 注册状态。 0 未注册。MT 当前未搜索注册业务的运营商。UE 处于 GMM 状态 GMM-NULL 或 GMM-DEREGISTERED-INITIATED。GPRS 服务被禁用，但用户请求后允许 UE 附着 于 GPRS。 1 已注册，归属地网络。UE 处于归属地 PLMN 的 GMM 状态 GMM-REGISTERED 或 GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED。 2 未 注 册 ， 但 MT 当 前 正 尝 试 附 着 或 搜 索 网 络 以 进 行 注 册 。 UE 处 于 GMM 状 态 GMM-DEREGISTERED 或 GMM-REGISTERED-INITIATED。GPRS 服务处于使能状 态，但允许的 PLMN 当前不可用。UE 将会在允许的 PLMN 可用时开始附着 GPRS。 3 注册被拒绝。UE 处于 GMM 状态 GMM-NULL。GPRS 服务为禁用状态且用户请求时 UE 无法附着 GPRS。 4 未知 5 已注册，漫游状态 上海移远通信技术股份有限公司 70 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 字符串类型。十六进制格式的两字节位置区号（例如：'00C3'相当于十进制的 195）。 字符串类型。十六进制格式的四字节（UMTS/LTE）小区 ID。 整型。注册网络的接入技术。 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 十六进制格式的一字节路由区域码。 举例 AT+CGREG=? +CGREG: (0-2) OK AT+CGREG=2 OK AT+CGREG? +CGREG: 2,1,'D5D5','8054BBF',2,'0' OK +CGREG: 1,'D5D5','8054BBF',2,'0' 5.4. AT+CEREG EPS 网络注册状态 设置命令用于查询网络状态并控制 EPS 网络注册状态的非请求结果码的上报。 ⚫ =1 时，控制 URC +CEREG: 的上报，该 URC 表示 E-UTRAN 中 MT 的 EPS 网络注册 状态的变化。 ⚫ =2 时，控制 URC +CEREG：[,,[,]]的上报，该 URC 表示 E-UTRAN 中的网络小区的变化。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 响应 +CEREG: (支持的范围) 查询命令 AT+CEREG? OK 响应 +CEREG: ,[,,[,]] OK 上海移远通信技术股份有限公司 71 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 设置命令 AT+CEREG=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 OK 或者 ERROR 300 毫秒 / 参数 整型。 0 禁止上报网络注册 URC 1 允许上报网络注册 URC +CEREG: 2 允许上报网络注册和位置信息 URC +CEREG: [,,[,]] 整型。EPS 网络注册状态。 0 未注册。MT 当前未搜索到注册业务的运营商。 1 已注册，归属地网络。 2 未注册，但 MT 当前正尝试附着或搜索网络以进行注册。 3 注册被拒绝。 4 未知 5 已注册，漫游状态 字符串类型。十六进制格式的两字节位置区号。 字符串类型。十六进制格式的四字节（E-UTRAN）小区 ID。 整型。注册网络的接入技术。 7 E-UTRAN 13 E-UTRAN-NR 双连接 举例 AT+CEREG=? +CEREG: (0-2) OK AT+CEREG=2 OK AT+CEREG? +CEREG: 2,1,'DE10','5A29C0B',7 OK +CEREG: 1,'DE10','5A29C0B',7 上海移远通信技术股份有限公司 72 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.5. AT+C5GREG 5GS 网络注册状态 设置命令用于查询网络状态并控制如下非请求结果码的上报： ⚫ =1 时，控制 URC +C5GREG: 的上报，该 URC 表示 5GS 中 MT 的网络注册状态的变 化。 ⚫ =2 或当网络提供 Allowed-NSSAI 时，控制 URC +C5GREG: [,[],[],[], [],[]]的上报，该 URC 表示 5GS 中的网络小区的 变化。、、、和仅在可用时提供。 AT+C5GREG 5GS 网络注册状态 测试命令 AT+C5GREG=? 响应 +C5GREG: (支持的范围) 查询命令 AT+C5GREG? OK 响应 +C5GREG: ,[,[],[],[],[],[]] 设置命令 AT+C5GREG=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 或者 ERROR 300 毫秒 / 参数 整型。 0 禁用网络状态 URC 1 启用网络状态 URC +C5GREG: 2 启用网络状态 URC： +C5GREG: [,[],[],[],[],[]] 整型。NR 注册状态。 0 未注册。MT 当前未搜索到注册业务的运营商。 1 已注册，归属地网络。 2 未注册，但 MT 当前正尝试附着或搜索网络以进行注册。 上海移远通信技术股份有限公司 73 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 3 注册被拒绝。 4 未知 5 已注册，漫游状态 8 仅可注册紧急服务 字符串类型。十六进制格式的三字节追踪区号。 字符串类型。十六进制格式的五字节 NR 小区 ID。 整型。当前网络的接入技术。 10 EUTRAN-5GCN 11 NR-5GC 整型。参数值以八位字节为单位的长度。 十六进制格式的字符串类型。根据形式，字符串可以由点、分号和冒号分 隔。该参数表示从网络接收的获许的 S-NSSAI 列表。该参数被编码为由 冒号分隔的的列表。详情参考 3GPP 27.007 第 10.1.1 章节中 的。根据 AT+CSCS，该参数不得进行常规字符转换。 举例 AT+C5GREG=? +C5GREG: (0-2) OK AT+C5GREG=2 OK AT+C5GREG? +C5GREG: 2,1,'690E0F','9013B004',11,4,'01.000000' OK +C5GREG: 1,'690E0F','9013B004',11,4,'01.000000' 5.6. AT+CGDCONT 定义 PDP 上下文 该 命 令 用 于 指 定 上 下 文 标 识 所 标 识 的 PDP 上 下 文 参 数 。 设 置 命 令 的 一 种 特 殊 形 式 AT+CGDCONT=表示删除对应的 PDP 上下文参数，使其变成未定义。不允许更改已激活上下 文的定义。该查询命令返回每个已定义 PDP 上下文的当前配置。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT： (支持的范围),,,,(支持的范围),(支持的范 围)[,(支持的列表)[,(支持的 列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)[,(支 持的列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)[,(支持的列表)]]]]]]]]]]]]]]]] 查询命令 AT+CGDCONT? OK 响应 +CGDCONT: ,,,,,[,[,[,[,[,< NSLPI>[,[,[,[,[,[,[,[,[,< RQos_ind>[,[,]]]]]]]]]]]]]]]] 设置命令 +CGDCONT=[[,[,< APN>[,[,[,[,[,[,[,[,[,[,[,[,[,[,[,[, [,[, [,]]]]]]] ]]]]]]]]]]]]]]] OK 响应 OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 参考 3GPP TS 27.007 该命令立即生效； 自动保存参数配置。 上海移远通信技术股份有限公司 75 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。PDP 上下文标识，用于指定特定 PDP 上下文的定义。该参数是 TE-MT 接 口的本地参数，在其他与 PDP 上下文相关的命令中使用。范围：1~42。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 点对点协议（IETF STD 51） 'IPV6' 互联网协议版本 6 'IPV4V6' 配置双栈 UE 功能，支持 IPv4 与 IPv6（RFC 2460） 字符串类型。接入点名称，用于选择 GGSN 或外部分组数据网络的逻辑名称。若 该值为空或省略时，将使用订阅值。 字符串类型。用于标识适用于 PDP 的地址空间中的 MT。如果该值为空或被省略， 则 TE 在 PDP 启动过程中提供该值。否则，将请求动态地址。可使用 AT+CGPADDR 读取分配的地址。 整型。控制 PDP 数据是否要压缩（。仅适用于 SNDCP（）详情参考 3GPP TS 44.065） 0 关闭 1 打开（制造商指定） 2 V.42bis 3 V.44（暂不支持） 整型。控制 PDP 头部数据压缩。（详情参考 3GPP TS 44.065 和 3GPP TS 25.323） 0 关闭 1 打开 2 RFC1144 3 RFC2507 4 RFC3095 整型。控制 MT/TA 请求获取 IPv4 地址信息的方式。 0 通过 NAS 信令获取 IPv4 地址 1 通过 DHCP 获取 IPv4 地址 整型。PDP 上下文的上下文激活请求类型。 0 PDP 上下文用于新的 PDP 上下文建立或从非 3GPP 接入网切换（MT 确定 PDP 上下文是用于新的 PDP 上下文建立还是用于切换的方式视情况而定） 1 PDP 上下文用于紧急承载服务 整型。控制 MT/TA 获取 P-CSCF 地址的方式，详情请参考 3GPP TS 24.229 附录 B 和附录 L。 0 不受 AT+CGDCONT 影响 1 优先通过 NAS 信令获取 2 优先通过 DHCP 获取 整型。向网络指示 PDP 上下文是否仅用于 IM CN 子系统相关的信令。 0 UE 指示 PDP 上下文不仅用于 IM CN 子系统相关的信令。 1 UE 指示 PDP 上下文仅用于 IM CN 子系统相关的信令。 整型。指示此 PDP 上下文请求的 NAS 信令优先级。 0 指示将使用 MT 中配置的低优先级指示符的值激活该 PDP 上下文 1 表示将使用低优先级指示符'未为 NAS 信令低优先级配置 MS'的值激活此 PDP 上下文 MT 使用 3GPP TS 24.301 和 3GPP TS 24.008 中指定提供的 上海移远通信技术股份有限公司 76 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 NSLPI 信息。 整型。指定是否请求 PCO 的安全保护传输（仅适用于 EPS，详情请参考 3GPP TS 23.401 条款 6.5.1.2）。 0 不请求 PCO 的安全保护传输 1 请求对 PCO 进行安全保护传输 整型。控制 MT/TA 如何请求获取 IPv4 MTU 大小，请参考 3GPP TS 24.008 条款 10.5.6.3。 0 不受 AT+CGDCONT 影响 1 优先通过 NAS 信令获取 整型。向网络指示 MS 是否支持 TFT 中的本地 IP 地址（详情请参考 3GPP TS 24.301 和 3GPP TS 24.008 条款 10.5.6.3）。 0 不支持 TFT 中的本地 IP 地址 1 支持 TFT 中的本地 IP 地址 整型。控制 MT/TA 如何请求获取 Non-IP MTU 大小（请参考 3GPP TS 24.008 条款 10.5.6.3）。 0 不受 AT+CGDCONT 影响 1 优先通过 NAS 信令获取 整型。指示 UE 是否将可靠数据服务用于 PDN 连接，详情请参考 3GPP TS 24.301 和 3GPP TS 24.008 条款 10.5.6.3。 0 可靠数据服务用于 PDN 连接 1 可靠数据服务未用于 PDN 连接 整型。指示 5GS 中 PDU 会话的会话和服务连续（SSC）模式，详情请参考 3GPP TS 23.501。 0 PDU 会话与 SSC 模式 1 关联 1 PDU 会话 SSC 模式 2 关联 2 PDU 会话 SSC 模式 3 关联 十六进制字符串类型。根据形式的不同，可以用点和分号分隔。该参数与 PDU 会话相关联，以标识 5GS 中的网络切片，详情请参考 3GPP TS 23.501 和 3GPP TS 24.501。有关该参数的格式和编码，请参考 3GPP TS 23.003。该参数不 得按照 AT+CSCS 进行常规字符转换。该参数具有以下形式之一： sst 仅切片/服务类型（SST） sst;mapped_sst SST 和映射配置 SST sst.sd SST 和切片差分器（SD） sst.sd;mapped_sst SST、SD 和映射配置 SST sst.sd;mapped_sst.mapped_sd SST、SD、映射配置 SST 和映射配置 SD 整型。指示 5GS 中 PDU 会话的首选访问类型，详情请参考 3GPP TS 23.501 和 3GPP TS 24.501。 0 首选访问类型为 3GPP 1 首选访问类型为非 3GPP 整型。指示 UE 是否支持 PDU 会话的反射 QoS，详情请参考 3GPP TS 23.501 和 3GPP TS 24.501。 0 不支持 PDU 会话的反射 QoS 1 支持 PDU 会话的反射 QoS 上海移远通信技术股份有限公司 77 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 整型。指示 UE 是否支持 PDU 会话的 IPv6 多宿主，详情请参考 3GPP TS 23.501 和 3GPP TS 24.501。 0 不支持 PDU 会话的 IPv6 多宿主 1 支持 PDU 会话的 IPv6 多宿主 整型。指示 UE 是否请求将 PDU 会话建立为始终在线的 PDU 会话，详情请参 考 3GPP TS 24.501。 0 不请求建立为始终在线的 PDU 会话 1 请求建立为始终在线的 PDU 会话 5.7. AT+C5GNSSAI 设置 5GS NSSAI 该命令用于启用更新存储在 MT 上默认配置的 NSSAI。 AT+C5GNSSAI 设置 5GS NSSAI 测试命令 AT+C5GNSSAI=? 查询命令 响应 +C5GNSSAI: (支持的 范围),(支持的列表) 响应 AT+C5GNSSAI? +C5GNSSAI: [,] 设置命令 AT+C5GNSSAI=, OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。存储在 MT 上默认 NSSAI 的字节长度。 十六进制字符串类型。形式上，可用点、分号和冒号分隔。该参数指存储在 MT 上 默认 NSSAI 中包含的 S-NSSAI 列表。会编码为冒号隔开的 列表，详情请参考条款 10.1.1 中的。该参数不得按照 AT+CSCS 进行常规字符转换。 上海移远通信技术股份有限公司 78 / 277 错误码。详情参考第 13.5 章。 RG50xQ&RM5xxQ 系列 AT 命令手册 备注 若参数为空字符串（''），表示 MT 中无默认的 NSSAI 配置。 5.8. AT+C5GNSSAIRDP 读取 5GS NSSAI 动态参数值 该命令用于返回 MT 上存储的默认 NSSAI、3GPP 和非 3GPP 访问的拒绝 NSSAI。 AT+C5GNSSAIRDP 读取 5GS NSSAI 动态参数值 测试命令 AT+C5GNSSAIRDP=? 响应 +C5GNSSAIRDP: ( 支 持 的 范 围 ),( 支 持 的 列表) 设置命令 AT+C5GNSSAIRDP=, OK 响应 [+C5GNSSAIRDP: [,< default_configured_nssai>[,,[,,]]] [+C5GNSSAIRDP: [,,[,,< allowed_nssai_3gpp>,,]] [+C5GNSSAIRDP: [,,[,,< allowed_nssai_3gpp>,,]] [...]]]] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 / 上海移远通信技术股份有限公司 79 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。返回的 NSSAI 类型。 0 仅返回存储的默认 NSSAI 1 返回存储的默认 NSSAI 和拒绝 NSSAI 2 返回存储的默认 NSSAI、拒绝 NSSAI 和配置 NSSAI 3 返回存储的默认 NSSAI、拒绝 NSSAI、配置 NSSAI 和允许 NSSAI 字符串类型。NSSAI 信息适用的 PLMN 中的 MCC 和 MNC。对于 MCC 和 MNC 的格 式和编码，详情请参考 3GPP TS 23.003。该参数不得按照 AT+CSCS 进行常规字符转 换。 整型。存储在 MT 上的默认 NSSAI 的字节长度。 十六进制字符串类型。形式上，可用点、分号和冒号分隔。该参 数表示默认 NSSAI 中针对指定 PLMN 的 S-NSSAI 列表。 会编码为冒号隔开的 列表，详情请参考条款 10.1.1 中的。该参数不得按 照 AT+CSCS 进行常规字符转换。 整型。服务 PLMN 与 3GPP 接入相关联的拒绝 NSSAI 的字节长 度。 十六进制字符串类型。形式上，可用点、分号和哈希分隔。该参 数指服务 PLMN 与 3GPP 接入相关联的拒绝 S-NSSAI 列表。 会编码为冒号隔开的拒绝 S-NSSAI 列 表。的格式和编码详情请参考 3GPP TS 23.003。该 参数不得按照 AT+CSCS 进行常规字符转换。该参数具有以下形 式之一： sst#cause 仅有 STT 和拒绝原因 sst.sd#cause SST、SD 以及拒绝原因 其中拒绝原因可参考 3GPP TS 24.501 表 9.11.3.46.1 的原因值。 整型。服务 PLMN 与非 3GPP 接入相关联的拒绝 NSSAI 的字节 长度。 十六进制字符串类型。根据形式的不同，可以用点、分号和哈希 分隔。该参数指服务 PLMN 与非 3GPP 接入相关联的拒绝 S-NSSAI 列表。会编码为冒号隔开 的拒绝 S-NSSAI 列表。的格式和编码详情请参考 3GPP TS 23.003。该参数不得按照 AT+CSCS 进行常规字符转 换。该参数具有以下形式之一： sst#cause 仅有 STT 和拒绝原因 sst.sd#cause SST、SD 以及拒绝原因 其中拒绝原因可参考 3GPP TS 24.501 表 9.11.3.46.1 的原因值。 整型。由标识的 PLMN 与 3GPP 接入相关联的配置 NSSAI 的字节长度。 十六进制字符串类型。根据形式的不同，可以用点、分号和冒号 分隔。该参数指由标识 PLMN 与 3GPP 接入相关联 的配置 S-NSSAI 列表。会编码为冒号隔开 的列表，详情请参考条款 10.1.1 中的。 上海移远通信技术股份有限公司 80 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 该参数不得按照 AT+CSCS 进行常规字符转换。 整型。由标识的 PLMN 与 3GPP 接入相关联的允许 NSSAI 的字节长度。 十六进制字符串类型。根据形式的不同，可以用点、分号和冒号 分隔。该参数指由标识 PLMN 与 3GPP 接入相关联 的允许 S-NSSAI 列表。会编码为冒号 隔 开 的 列 表 ， 详 情 请 参 考 条 款 10.1.1 中 的 。该参数不得按照 AT+CSCS 进行常规字符转换。 整型。由标识的 PLMN 与非 3GPP 接入相关联的允 许 NSSAI 的字节长度。 十六进制字符串类型。根据形式的不同，可以用点、分号和冒号 分隔。该参数指由标识 PLMN 与非 3GPP 接入相关 联的允许 S-NSSAI 列表。会编码 为冒号隔开的列表，详情请参考条款 10.1.1 中的 。该参数不得按照 AT+CSCS 进行常规字符转换。 5.9. AT+CSQ 查询信号强度 该命令用于查询当前服务小区接收信号强度和信道误码率。 AT+CSQ 查询信号强度 测试命令 AT+CSQ=? 响应 +CSQ: (支持的列表),(支持的列表) 执行命令 AT+CSQ OK 响应 +CSQ: , OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 81 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。接收信号强度指示。 0 小于等于-113 dBm 1 -111 dBm 2~30 -109 ~ -53 dBm 31 大于等于-51 dBm 99 未知或不可测 整型。信道误码率。百分比格式。 0~7 3GPP TS 45.008 8.2.4 章节表格中的 RxQual 值。 99 未知或不可测 错误码。详情参考第 13.5 章。 举例 AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,99 //查询当前接收信号强度为 28，误码率未知或不可测。 OK 备注 执行网络相关命令（如 AT+CCWA 和 AT+CCFC）后，建议等待 3 秒在执行 AT+CSQ 以确保之前执行 的命令所需的网络访问已经完成。 5.10. AT+QRSRP 查询 RSRP 值 该命令用于查询当前服务网络的 RSRP 值。 AT+QRSRP 查询 RSRP 值 测试命令 AT+QRSRP=? 查询命令 AT+QRSRP 响应 OK 响应 +QRSRP: ,,,, 最大响应时间 OK 300 毫秒 上海移远通信技术股份有限公司 82 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 特性说明 / 参数 整型。PRX 路径的 RSRP 值。范围：-140~-44 dBm。 整型。DRX 路径的 RSRP 值。范围：-140~-44 dBm。 整型。RX2 路径的 RSRP 值。范围：-140~-44 dBm。 整型。RX3 路径的 RSRP 值。范围：-140~-44 dBm。 字符串类型。服务网络模式。 LTE LTE 模式 NR5G 5G NR 模式 举例 AT+QRSRP //查询 RSRP 值。 +QRSRP: -101,-105,-105,-99,LTE OK 备注 该命令仅适用于 LTE 和 5G NR。 5.11. AT+QRSRQ 查询 RSRQ 值 该命令用于查询当前服务网络的 RSRQ 值。 AT+QRSRQ 查询 RSRQ 值 测试命令 AT+QRSRQ=? 查询命令 AT+QRSRQ 响应 OK 响应 +QRSRQ: ,,,, 最大响应时间 特性说明 OK 300 毫秒 / 上海移远通信技术股份有限公司 83 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。PRX 路径的 RSRQ 值。范围：-20~-3 dB。 整型。DRX 路径的 RSRQ 值。范围：-20~-3 dB。 整型。RX2 路径的 RSRQ 值。范围：-20~-3 dB。 整型。RX3 路径的 RSRQ 值。范围：-20~-3 dB。 字符串类型。服务网络模式。 LTE LTE 模式 NR5G 5G NR 模式 举例 AT+QRSRQ //查询 RSRQ 值。 +QRSRQ: -16,-19,-19,-15,LTE OK 备注 该命令仅适用于 LTE 和 5G NR。 5.12. AT+QSINR 查询 SINR 值 该命令用于查询当前服务网络的 SINR 值。 AT+QSINR 查询 SINR 值 测试命令 AT+QSINR=? 查询命令 AT+QSINR? 响应 OK 响应 +QRSRQ: ,,,, 执行命令 AT+QSINR OK 响应 +QRSRQ: ,,,, 最大响应时间 特性说明 OK 300 毫秒 / 上海移远通信技术股份有限公司 84 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。PRX 路径的 SINR 值。范围：-20~30 dB（LTE 模式）；-23~40 dB（5G NR 模式）。 整型。DRX 路径的 SINR 值。范围：-20~30 dB（LTE 模式）；-23~40 dB（5G NR 模式）。 整型。RX2 路径的 SINR 值。范围：-20~30 dB（LTE 模式）；-23~40 dB（5G NR 模式）。 整型。RX3 路径的 SINR 值。范围：-20~30 dB（LTE 模式）；-23~40 dB（5G NR 模式）。 字符串类型。服务网络模式。 LTE LTE 模式 NR5G 5G NR 模式 举例 AT+QSINR +QSINR: -3,-7,-1,-2,LTE OK //查询 SINR 值。 备注 该命令仅适用于 LTE 和 5G NR 网络。 5.13. AT+CPOL 配置首选运营商列表 该命令用于配置或者查询首选运营商列表。 AT+CPOL 配置优先网络列表 测试命令 AT+CPOL=? 响应 +CPOL: (支持的列表),(支持的范围) 查询命令 AT+CPOL? OK 响应 查询首选运营商的列表： +CPOL: ,,[,,,,,] […] 设置命令 AT+CPOL=[,[,[,,,,]]] OK 响应 配置首选运营商列表： OK 或者 上海移远通信技术股份有限公司 85 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 ERROR 若错误与 MT 功能相关： +CME ERROR: 若指定但省略，后面的参数都将被省略。 300 毫秒 / 参数 整型。(U)SIM 卡 PLMN 的顺序。 整型。的显示格式。 0 长字符串格式 1 短字符串格式 2 数字格式 字符串类型。表示该参数格式采用字符串格式还是数字格式（参考 AT+COPS）。 整型。是否选择 GSM 访问技术。 0 未选 1 选定 整型。是否选择 GSM compact 访问技术。 0 未选 1 选定 整型。是否选择 UTRAN 访问技术。 0 未选 1 选定 整型。是否选择 E-UTRAN 访问技术。 0 未选 1 选定 整型。是否选择 NG-RAN 访问技术。 0 未选 1 选定 错误码。详情参考第 13.5 章。 备注 访问技术选择参数、、、和对于具有访问 技术的 PLMN 选择器的(U)SIM 卡或 UICC 卡来说是必须的。 上海移远通信技术股份有限公司 86 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.14. AT+COPN 查询运营商名称列表 该命令用于从 MT 查询运营商名称列表，命令返回 MT 存储器中字符串格式（）和数字格式 （）的运营商名称。 AT+COPN 查询运营商名称列表 测试命令 AT+COPN=? 执行命令 AT+COPN 响应 OK 响应 +COPN: , [+COPN: , […]] OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 取决于运营商个数 / 参数 字符串类型。数字格式的运营商名称（详情参考 AT+COPS）。 字符串类型。字符串格式的运营商名称（详情参考 AT+COPS）。 错误码。详情参考第 13.5 章。 5.15. AT+CTZU 自动更新时区 该命令用于启用或者禁用通过 NITZ 自动更新时区功能。 AT+CTZU 自动更新时区 测试命令 AT+CTZU=? 响应 +CTZU: (支持的列表) 设置命令 AT+CTZU= OK 响应 OK 上海移远通信技术股份有限公司 87 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 查询命令 AT+CTZU? 最大响应时间 特性说明 参考 3GPP TS 27.007 或者 ERROR 响应 +CTZU: OK 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。自动更新时区模式。 0 禁用通过 NITZ 自动更新时区 1 启用通过 NITZ 自动更新时区 举例 AT+CTZU? +CTZU: 0 OK AT+CTZU=? +CTZU: (0,1) OK AT+CTZU=1 OK AT+CTZU? +CTZU: 1 OK //查询自动更新时区模式的状态。 //获取自动更新时区模式的所有状态。 //启用通过 NITZ 自动更新时区功能。 5.16. AT+CTZR 上报时区变化 该命令用于启用/禁用时区变化事件的上报。若启用上报，则时区变化时 MT 会返回 URC +CTZV: 或者+CTZE: ,,。 上海移远通信技术股份有限公司 88 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 AT+CTZR 上报时区变化 测试命令 AT+CTZR=? 设置命令 AT+CTZR= 查询命令 AT+CTZR? 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 +CTZR: (支持的范围) OK 响应 OK 或者 ERROR 响应 +CTZR: OK 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。是否上报时区变化。 0 不上报 1 通过 URC +CTZV: 上报时区变化 2 通过 URC +CTZE: ,,上报扩展时区信息和本地时间 字符串类型。表示本地时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异）与夏 令时之和。格式为'±zz'，为两个整型数字的固定宽度。范围：-48 ~ +56。为保证固定 宽度，-9 ~ +9 之间的数字前加 0，例如：'-09'，'+00'，'+09'。 整型。表示中是否包括夏令时调整。 0 不包括夏令时调整 1 包括+1 小时（相当于中的一个小时）的夏令时调整 2 包括+2 小时（相当于中的两个小时）的夏令时调整 字符串类型。本地时间。格式：'YYYY/MM/DD,hh:mm:ss'，用于表示年（YYYY），月 （MM），日（DD），时（hh），分（mm）和秒（ss）。传送时区信息时由网络提供 该参数值，并 URC 扩展时区报告中显示。 举例 AT+CTZR=2 OK AT+CTZR? +CTZR: 2 上海移远通信技术股份有限公司 89 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK +CTZE: '+32',0,'2018/03/23,06:51:13' //通过URC上报扩展时区和本地时间。 5.17. AT+QLTS 获取通过网络同步的最新时间 该命令用于获取通过网络同步的最新时间。. AT+QLTS 获取通过网络同步的最新时间 测试命令 AT+QLTS=? 响应 +QLTS: (支持的列表) 执行命令 AT+QLTS OK 响应 +QLTS: , 设置命令 AT+QLTS= OK 响应 +QLTS: , OK 或者 ERROR 最大响应时间 特性说明 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。查询网络时间模式。 0 查询通过网络同步的最新时间 1 查询通过网络同步的最新时间计算出的当前 GMT 时间 2 查询通过网络同步的最新时间计算出的当前本地时间 字符串类型。格式为'yyyy/MM/dd,hh:mm:ss±zz'， 用于表示年（yyyy），月（MM），日（dd）， 时（hh），分（mm），秒（ss），时区（zz，该字段以 15 分钟为单位显示本地时间和 GMT 时间的差异；范围：-48 ~ +48）。例如：2004 年 5 月 6 日 22:10:00，GMT 时间加 2 小时等 于'04/05/06, 22:10:00+08'。 上海移远通信技术股份有限公司 90 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 整型。是否包括夏令时调整。 0 不包括夏令时调整 1 包括+1 小时（相当于中的一个小时）的夏令时调整 2 包括+2 小时（相当于中的两个小时）的夏令时调整 错误码。详情参考第 13.5 章。 备注 若时间未通过网络同步，执行该命令后返回不带时间的字符串+QLTS: ''。 举例 AT+QLTS=? +QLTS: (0-2) //查询支持的网络时间模式。 OK AT+QLTS //查询通过网络同步的最新时间。 +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=0 //查询通过网络同步的最新时间，功能同执行命令 AT+QLTS 一致。 +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=1 //查询通过网络同步的最新时间计算出的当前 GMT 时间。 +QLTS: '2017/01/13,03:41:22+32,0' OK AT+QLTS=2 //查询通过网络同步的最新时间计算出的当前本地时间。 +QLTS: '2017/01/13,11:41:23+32,0' OK 上海移远通信技术股份有限公司 91 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.18. AT+QNWINFO 查询网络信息 该命令用于查询网络信息，例如选择的访问技术、运营商以及选择的频段。 AT+QNWINFO 查询网络信息 测试命令 AT+QNWINFO=? 执行命令 AT+QNWINFO 响应 OK 响应 +QNWINFO: ,,, 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。选择的访问技术。 'NONE' 'WCDMA' 'TDD LTE' 'FDD LTE' 'TDD NR5G' 'FDD NR5G' 字符串类型。数字格式运营商名称。 字符串类型。选择的频段。 'WCDMA_I_2100' 'WCDMA_II_1900' 'WCDMA_III_1800' 'WCDMA_IV_1700_US' 'WCDMA_V_850' 'WCDMA_VI_800' 'WCDMA_VII_2600' 'WCDMA_VIII_900' 'WCDMA_IX_1700_JAPAN' 'WCDMA_XI_1500' 'WCDMA_XIX_850_JAPAN' 'LTE BAND 1'–'LTE BAND 43' 'LTE BAND 46'–'LTE BAND49' 'LTE BAND 66'–'LTE BAND 68' 'LTE BAND 71' 'LTE BAND 125'–'LTE BAND 127' 上海移远通信技术股份有限公司 92 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 'LTE BAND 250' 'LTE BAND 252' 'LTE BAND 255' 'NR5G BAND 1'–'NR5G BAND 3' 'NR5G BAND 5' 'NR5G BAND 7'–'NR5G BAND 8' 'NR5G BAND 12' 'NR5G BAND 14' 'NR5G BAND 20' 'NR5G BAND 25' 'NR5G BAND 28' 'NR5G BAND 34' 'NR5G BAND 38'–'NR5G BAND 41' 'NR5G BAND 48' 'NR5G BAND 50'–'NR5G BAND 51' 'NR5G BAND 65'–'NR5G BAND 66' 'NR5G BAND 70'–'NR5G BAND 71' 'NR5G BAND 74'–'NR5G BAND 86' 'NR5G BAND 257'–'NR5G BAND 261' 整型。信道 ID。 备注 若设备未注册到网络，该命令将返回+QNWINFO: No Service。5G NR NSA 下，将返回 LTE 和 5G NR 网络信息。 举例 AT+QNWINFO=? OK AT+QNWINFO +QNWINFO: 'FDD LTE',46001,'LTE BAND 3',1650 OK 上海移远通信技术股份有限公司 93 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.19. AT+QSPN 查询运营商名称 该命令用于查询运营商名称。 AT+QSPN 查询运营商名称 测试命令 AT+QSPN=? 执行命令 AT+QSPN 特性说明 响应 OK 响应 +QSPN: ,,,, OK / 参数 字符串类型。网络全称。 字符串类型。网络简称。 字符串类型。运营商名称。 整型。网络名全称或简称使用的字母表。 0 GSM 7 位默认字母表 1 UCS2 字符串类型。已注册的 PLMN。 备注 1. 若=0，和格式为 GSM 7 位默认字母表的字符串。 2. 若=1，和格式为 UCS2 十六进制字符串。 举例 AT+QSPN //查询运营商名称。 +QSPN: 'CHN-UNICOM','UNICOM','',0,'46001' OK 上海移远通信技术股份有限公司 94 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.20. AT+QENG 查询主小区和邻区信息 该命令用于获取网络信息，例如主小区和邻区。 AT+QENG 查询主小区和邻区信息 测试命令 AT+QENG=? 响应 +QENG: (支持的列表) 设置命令 查询服务小区信息 AT+QENG='servingcell' OK 响应 SA 模式： +QENG: 'servingcell',,'NR5G-SA',,,,,,,,,,,,,, EN-DC 模式： +QENG: 'servingcell', +QENG: 'LTE',,,,,,,,,,,,,,,, , +QENG: 'NR5G-NSA',,,,,< SINR>,,,,, LTE 模式： +QENG: 'servingcell',,'LTE',,,< MNC>,,,,,,,,,,,,,, WCDMA 模式： +QENG: 'servingcell',,'WCDMA',,,,,,,,,,,,,, 设置命令 查询邻区信息 AT+QENG='neighbourcell' OK 响应 LTE 模式： [+QENG: 'neighbourcell intra','LTE',,,< RSRQ>,,,,,,,, …] [+QENG: 'neighbourcell inter','LTE',,,< RSRQ>,,,,,,, …] [+QENG:'neighbourcell','WCDMA',,,,,,, …] WCDMA 模式： [+QENG:'neighbourcell','WCDMA',,, ,,,,, …] [+QENG: 'neighbourcell','LTE',,,,, …] OK 300 毫秒 / 参数 字符串类型。不同小区的信息。 'servingcell' 3G/4G/5G 服务小区的信息 'neighbourcell' 3G/4G 邻区信息 字符串类型。UE 状态。 'SEARCH' UE 正在搜索但未找到合适的 3G/4G/5G 小区 'LIMSRV' UE 正在驻留一个小区但未注册到网络 'NOCONN' UE 正在驻留一个小区且已注册到网络，处于空闲模式。 'CONNECT' UE 正在驻留一个小区且已注册到网络，通话正在进行中。 字符串类型。5G NR SA 网络模式。 'TDD' 'FDD' 字符串类型。LTE 网络模式。 'TDD' 'FDD' 16 位无符号整型。移动设备国家码（PLMN 码的第一部分）。 16 位无符号整型。移动设备网络码（PLMN 码的第二部分）。 表示被扫描小区的 SA-ARFCN。 32 位无符号整型。5G NR SA 网络模式下的频段。 上海移远通信技术股份有限公司 96 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 整数类型。下行带宽。该值仅在 RRC 连接态下有效。 0 5 MHz 1 10 MHz 2 15 MHz 3 20 MHz 4 25 MHz 5 30 MHz 6 40 MHz 7 50 MHz 8 60 MHz 9 70 MHZ 10 80 MHz 11 90 MHz 12 100 MHz 13 200 MHz 14 400 MHz 整型。位置区域码。该参数决定所扫描十六进制格式的两个字节小区的位置 区码（例如 00C1 等于十进制的 193）。范围：0~65535。 整型。小区 ID。28 位（UMTS 和 LTE）或者 36 位（5G NR）。范围： 0~0xFFFFFFF。 数字格式。物理小区 ID。 表示被扫描小区的 UTRA 绝对射频信道号码。 表示被扫描小区的 E-UTRA 绝对射频信道号码。 整型。E-UTRA 频段（详情参考 3GPP 36.101）。 整型。上行带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 整型。下行带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 跟踪区编码（详情参考 3GPP 23.003 19.4.2.3 章节）。 表示被扫描小区的主扰码。 整型。路由区域码。范围：0~255。 表示被扫描小区的接收信号码功率电平。 载波噪声比，等于以 dB 为单位的测量的 Ec/Io 值。单位：dB。 16-bit 有符号整型。 上海移远通信技术股份有限公司 97 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 LTE 模式： 表示 LTE 参考信号接收功率的信号（详情参考 3GPP 36.214）。范围：-140 ~ -44 dBm。该参数值越接近-44，信号越强；越接近-140，信号越弱。 5G NR 模式： 表示 5G NR 参考信号接收功率的信号。范围：-140 ~ -44 dBm。该参数值越 接近-44，信号越强；越接近-140，信号越弱。 LTE 模式： 表示当前 LTE 参考信号接收质量的信号（详情参考 3GPP 36.214）。范围： -20 ~ -3 dB。该参数值越接近-3，信号越强；越接近-20，信号越弱。 5G NR 模式： 表示当前 5G NR 参考信号接收质量的信号。范围：-20 ~ -3 dB。该参数值越 接近-3，信号越强；越接近-20，信号越弱。 LTE 接收信号强度指示。 LTE 模式： 表示 LTE 信噪比。实际 SINR 值转换公式为：Y = (1/5) ×X ×10 – 20（其中， X 是通过 AT+QENG 查询的值，Y 是转换后的实际 LTE SINR 值）。 范围：-20~30；单位：dB。 5G NR 模式： 表示 5G NR 信噪比。范围：-20~30；单位：dB。 整型。信道质量指示。范围：1~30。 TX 功率值，为所有 UL 信道 TX 功率最大值。单位：1/10 dBm。该值仅在设 备阻塞时有意义。 整型。物理信道。 0 DPCH 1 FDPCH 整型。扩频因子。 0 SF_4 1 SF_8 2 SF_16 3 SF_32 4 SF_64 5 SF_128 6 SF_256 7 SF_512 8 UNKNOWN 整型。 0–16 DPCH 的插槽格式. 0–9 FDPCH 的插槽格式 转接呼叫的目的地号码。 整型。数字格式。压缩模式。 0 不支持压缩模式 上海移远通信技术股份有限公司 98 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 1 支持压缩模式 接收机对预占频率的自动增益控制。 整型。码片能量与功率谱密度的比值，等于以 dB 为单位的测量的 Ec/Io 值。 单位：dB。 整型。3G 邻区集。 1 活跃邻区集 2 同步邻区集 3 异步邻区集 inter-RAT 小区重选邻区的等级。 适用的异频小区的接收电平。 重选所需。评估的低优先级小区的接收电平值必须大于该值。 重选所需。评估的高优先级小区的接收电平值必须大于该值。 高优先级小区的重选阈值。 低优先级小区的重选阈值。 选择的基站接收电平值（详情参考 3GPP 25.304）。单位：dB。 整型。小区重选优先级。范围：0~7。 用于控制非同频搜索的阈值。 低优先级无线接入技术及频率重选时，UE 在服务小区上使用的适用的接收电 平阈值。单位：dB。 同频小区的小区选择参数。 整型。NR 子载波间隔。 0 15 kHz 1 30 kHz 2 60 kHz 3 120 kHz 4 240 kHz 备注 如果命令返回值为'-'或-，则表明该参数在当前条件下无效。 举例 AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','LTE','FDD',460,01,5F1EA15,12,1650,3,5,5,DE10,-100,-12,-68,1 1,0,-32768,27 AT+QENG='servingcell' +QENG: 'servingcell','NOCONN' +QENG: 'LTE','FDD',460,01,5F1EA15,12,1650,3,5,5,DE10,-99,-12,-67,11,9,230,+QENG:'NR5G-NSA',460,01,747,-71,13,-11,627264,78,12,1 AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','NR5G-SA','TDD', 460,01,9013B004,299,690E0F,633984,78,12, -107,-13,2,1,- 上海移远通信技术股份有限公司 99 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK AT+QENG='neighbourcell' +QENG: 'neighbourcell intra','LTE',38950,276,-3,-88,-65,0,37,7,16,6,44 +QENG: 'neighbourcell inter','LTE',39148,-,-,-,-,-,37,0,30,7,-,-,-,+QENG: 'neighbourcell inter','LTE',37900,-,-,-,-,-,0,0,30,6,-,-,-,- OK 5.21. AT+QCAINFO 查询载波聚合参数 该命令用于查询载波聚合参数。 AT+QCAINFO 查询载波聚合参数 测试命令 响应 AT+QCAINFO=? 执行命令 OK 响应 AT+QCAINFO +QCAINFO: 'PCC',,,,,,,,, +QCAINFO: 'SCC',,,,,,,,, [+QCAINFO: 'SCC',,,,,,,,, […]] OK 最大响应时间 特性说明 若无活跃的辅小区： OK 300 毫秒 / 参数 主载波分量。 辅载波分量。 EARFCN。 整型。带宽。 6 1.4 MHz 15 3 MHz 上海移远通信技术股份有限公司 100 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 25 5 MHz 50 10 MHz 75 15 MHz 100 20 MHz 字符串类型。下行频带信息。 'LTE BAND 1' 'LTE BAND 2' 'LTE BAND 3' … 'LTE BAND 66' 整型。主小区状态。 0 无服务 1 已注册 整型。辅小区状态。 0 配置解除 1 配置已去激活 2 配置已激活 整型。物理小区 ID。 整型。参考信号接收功率（详情参考 3GPP 36.214）。 整型。参考信号接收质量（详情参考 3GPP 36.214）。 整型。接收信号强度指示。 整型。RSSNR 对数值。范围：-10~30 dB。 5.22. AT+QENDC 查询 EN-DC 状态 该命令用于查询 EN-DC 状态。 AT+QENDC 查询 EN-DC 状态 测试命令 AT+QENDC=? 执行命令 AT+QENDC 响应 OK 响应 +QENDC: ,,, OK 特性说明 / 上海移远通信技术股份有限公司 101 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。表示当前小区是否支持 EN-DC 模式。 0 不支持 1 支持 整型。表示当前注册的 PLMN 是否支持 EN-DC 模式。 0 不支持 1 支持 整型。网络提供的 EN-DC 功能。 0 受限 1 不受限 整型。表示是否成功支持 5G 图标信息。 0 不支持 1 支持 5.23. AT+QSCAN 搜索邻近小区 该命令用于搜索邻近的 LTE 和 5G NR 小区。 AT+QENDC 搜索邻近小区 测试命令 AT+QSCAN=? 响应 +QSCAN: (支持的范围) 设置命令 AT+QSCAN=[,] OK 响应 [+QSCAN: 'LTE',,,,,,< RSRQ>,,[,,] …] [+QSCAN: 'NR5G',,,,,,,, …] 最大响应时间 特性说明 OK 180 秒，取决于网络状态 / 上海移远通信技术股份有限公司 102 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。小区搜索模式。 1 仅搜索 LTE 小区 2 仅搜索 5G NR 小区 3 同时搜索 LTE 小区和 5G NR 小区 整型。显示或隐藏扩展参数、、和。 0 隐藏扩展参数 1 显示扩展参数 整型。移动设备国家代码（PLMN 码的第一部分）。 整型。移动设备网络代码（PLMN 码的第二部分）。 整型。小区频率。 整型。物理小区 ID。 整型。参考信号接收功率信号（详情参考 3GPP 36.214）。范围：-140 至-44；单位：dBm。 整型。当前参考信号接收质量信号（详情参考 3GPP 36.214）。范围：-20 至-3；单位： dB。 整型。小区选择接收电平值。单位：dB。 整型。小区选择质量。单位：dB。 整型。子载波间隔。 0 15 kHz 1 30 kHz 2 60 kHz 3 120 kHz 字符串类型。十六进制字符串类型的小区标识。 字符串类型。十六进制字符串中类型的跟踪区编码。 整型。带宽。 整型。频段。 备注 1. 如果小区的信息获取不全时，参数值可能会返回'-'。 2. 该命令不适用于 5G NSA 小区。 3. 建议在无 SIM 卡的情况下使用该命令。 5.24. AT+QNWCFG 配置和查询网络参数 该命令用于配置和查询网络参数。 AT+QNWCFG 配置和查询网络参数 测试命令 AT+QNWCFG=? 响应 +QNWCFG: 'csi_ctrl',(支持的列表),(支持的 列表) 上海移远通信技术股份有限公司 103 / 277 最大响应时间 特性说明 RG50xQ&RM5xxQ 系列 AT 命令手册 +QNWCFG: 'lte_csi',( 支 持 的 范 围),,, +QNWCFG: 'nr5g_csi',( 支 持 的 范 围),,, +QNWCFG: 'lte_cell_id',,, +QNWCFG: 'nr5g_cell_id',,, +QNWCFG: 'WCDMA_cqi',(支持的列表) +QNWCFG: 'up/down',,,( 支 持 的 范围) +QNWCFG: 'data_path',(支持的列表) +QNWCFG: 'dss_enable',(支持的列表) +QNWCFG: 'lapi',(支持的列表) OK 300 毫秒 / 5.24.1. AT+QNWCFG='csi_ctrl' 控制 LTE 和 5G NR CSI 获取 该命令用于控制 LTE 或 5G NR CSI 获取。 AT+QNWCFG='csi_ctrl' 控制 LTE 或 5G NR CSI 获取 设置命令 AT+QNWCFG='csi_ctrl'[,,] 响应 若省略可选参数，查询当前配置： +QNWCFG: 'csi_ctrl',, OK 最大响应时间 特性说明 若指定可选参数，启用或禁用 LTE 或 5G NR CSI 获取： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 104 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。启用/禁用 LTE CSI 获取。 0 禁用 1 启用 整型。启用/禁用 5G NR CSI 获取。 0 禁用 1 启用 举例 AT+QNWCFG='csi_ctrl' +QNWCFG: 'csi_ctrl',1,1 OK AT+QNWCFG='csi_ctrl',0,0 OK //查询当前 LTE 或 5G NR CSI 获取功能状态。 //禁用 LTE 或 5G NR CSI 获取。 5.24.2. AT+QNWCFG='lte_csi' 查询 LTE CSI 信息 该命令用于查询 LTE CSI 信息，包括 MCS、CQI、RI 和 PMI。 AT+QNWCFG='lte_csi' 查询 LTE CSI 信息 设置命令 AT+QNWCFG='lte_csi' 响应 +QNWCFG: 'lte_csi',,,, 最大响应时间 OK 或者 ERROR 300 毫秒 特性说明 / 参数 整型。表示 PDSCH 的调制和编码方案。范围：0~31。 整型。表示 PDSCH 的有效数据层数。 整型。表示下行信道质量。 整型。表示码本集的索引。 上海移远通信技术股份有限公司 105 / 277 举例 AT+QNWCFG='lte_csi' +QNWCFG: 'lte_csi',0,1,15,0 OK RG50xQ&RM5xxQ 系列 AT 命令手册 //查询 LTE CSI 信息。 5.24.3. AT+QNWCFG='nr5g_csi' 查询 5G NR CSI 信息 该命令用于查询 5G NR CSI 信息，包括 MCS、CQI、RI 和 PMI。 AT+QNWCFG='nr5g_csi' 查询 5G NR CSI 信息 设置命令 AT+QNWCFG='nr5g_csi' 响应 +QNWCFG: 'nr5g_csi',,,, 最大响应时间 特性说明 OK 或者 ERROR 300 毫秒 / 参数 整型。表示 PDSCH 的调制和编码方案。范围：0~31。 整型。表示 PDSCH 的有效数据层数。 整型。表示下行信道质量。 整型。表示码本集的索引。 举例 AT+QNWCFG='nr5g_csi' +QNWCFG: 'nr5g_csi',0,1,15,0 OK //查询 5G NR CSI 信息。 5.24.4. AT+QNWCFG='lte_cell_id' 查询 LTE 小区标识 该命令用于查询 LTE 下的的小区信息，包括 ECGI、ECI 和 eNodeB ID 信息。 AT+QNWCFG='lte_cell_id' 查询 LTE 小区标识 设置命令 响应 上海移远通信技术股份有限公司 106 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 查询 LTE 小区标识 AT+QNWCFG='lte_cell_id' 最大响应时间 特性说明 +QNWCFG: 'lte_cell_id',,, OK 300 毫秒 / 参数 整型。E-UTRAN 小区全球识别码（即 MCC+MNC+ECI）。 整型。E-UTRAN 小区识别码（eNodeB ID + cell ID)。 整型。LTE 基站标识。 举例 AT+QNWCFG='lte_cell_id' //查询 LTE 小区标识。 +QNWCFG: 'lte_cell_id',64F0000D6B5C0,0D6B5C0,0D6B5 OK AT+QNWCFG='lte_cell_id' OK //查询非 LTE 下的小区标识。 5.24.5. AT+QNWCFG='nr5g_cell_id' 查询 5G NR SA 小区标识 该命令用于查询 5G NR SA 下的小区信息，包括 NCGI、NCI 和 gNodeB ID 信息。 AT+QNWCFG='nr5g_cell_id' 查询 5G NR SA 小区标识 设置命令 AT+QNWCFG='nr5g_cell_id' 响应 +QNWCFG: 'nr5g_cell_id',,, 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。5G NR 小区全球识别码（即 MCC+MNC+NCI）。 整型。5G NR 小区识别码（gNodeB ID + cell ID）。 整型。5G NR 基站 ID。 上海移远通信技术股份有限公司 107 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 举例 AT+QNWCFG='nr5g_cell_id' //查询 5G NR SA 小区标识。 +QNWCFG: 'nr5g_cell_id',64F000170C23000,170C23000,170C23 OK AT+QNWCFG='nr5g_cell_id' OK //查询非 NR 5G SA 下小区标识。. 5.24.6. AT+QNWCFG='WCDMA_cqi' 查询 WCDMA CQI 信息 该命令用于查询 WCDMA CQI 信息。 AT+QNWCFG='WCDMA_cqi' 查询 WCDMA CQI 信息 设置命令 查询 WCDMA CQI 信息 AT+QNWCFG='WCDMA_cqi' 响应 +QNWCFG: 'WCDMA_cqi', OK 最大响应时间 300 毫秒 特性说明 / 参数 整型。CQI 值。范围：0~30 和 255。若返回值为 255，表示 WCDMA CQI 无效。 备注 创建 HSDPA 信道之后才可获取 CQI 值，可通过数据流量的测试建立 HSDPA 信道。 举例 AT+QNWCFG='WCDMA_cqi' +QNWCFG: 'WCDMA_cqi',27 OK 上海移远通信技术股份有限公司 108 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.24.7. AT+QNWCFG='up/down' 获取增量时间内平均上下行速率 AT+QNWCFG='up/down' 获取增量时间内平均上下行速率 设置命令 AT+QNWCFG='up/down'[,] 响应 若省略可选参数，查询当前配置： +QNWCFG: 'up/down',,, OK 最大响应时间 特性说明 若指定可选参数，获取增量时间内平均上下行速率： OK 或者 ERROR 300 毫秒 / 参数 整型。增量时间内的平均上行速率。单位：字节每秒。 整型。增量时间内的平均下行速率。单位：字节每秒。 整型。自动计算平均速率的时间。范围：1–60；默认值：2；单位：秒。 举例 AT+QNWCFG=? … +QNWCFG: 'up/down',,,(1-60) … OK AT+QNWCFG='up/down' +QNWCFG: 'up/down',2056,384,5 OK AT+QNWCFG='up/down',5 OK 上海移远通信技术股份有限公司 109 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.24.8. AT+QNWCFG='data_path' 查询 NSA 网络下用户层下行数据路径 该命令用于查询 NSA 网络下用户层下行数据路径。 AT+QNWCFG='data_path' 查询 NSA 网络下的用户层下行数据路径 设置命令 AT+QNWCFG='data_path',[] 响应 若省略可选参数，查询当前配置： +QNWCFG: 'data_path',[,] OK 最大响应时间 特性说明 若指定可选参数，启用/禁用查询 NSA 网络下的用户层下行数据路径： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用查询 NSA 网络下的用户层下行数据路径。 0 禁用 1 启用 字符串类型。NSA 网络下用户层下行数据路径。 'LTE' LTE 上的下行数据 'NR' 5G NR 的下行数据 举例 AT+QNWCFG ='data_path' //查询当前 NSA 网络下用户层下行数据路径。 +QNWCFG: 'data_path',1,'NR' OK 上海移远通信技术股份有限公司 110 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.24.9. AT+QNWCFG='dss_enable' 启用/禁用 DSS 功能 该命令用于启用/禁用 DSS 功能。 AT+QNWCFG='dss_enable' 启用/禁用 DSS 功能 设置命令 AT+QNWCFG='dss_enable'[, ] 响应 若省略可选参数，查询当前配置： +QNWCFG: 'dss_enable', OK 最大响应时间 特性说明 若指定可选参数，启用/禁用 DSS 功能： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用 DSS 功能。 0 禁用 1 启用 举例 AT+QNWCFG='dss_enable',1 OK AT+QNWCFG='dss_enable' +QNWCFG: 'dss_enable',1 OK //启用 DSS 功能。 //查询 DSS 功能是否使能。 上海移远通信技术股份有限公司 111 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.24.10. AT QNWCFG='lapi' 设置 UE 低优先级 该命令用于设置 UE 低优先级。 AT+QNWCFG='lapi' 设置 UE 低优先级 设置命令 AT+QNWCFG='lapi'[,] 响应 若省略可选参数，查询当前配置： +QNWCFG: 'lapi', OK 最大响应时间 特性说明 若指定可选参数，设置 UE 低优先级： OK 或者 ERROR 300 毫秒 该命令重启生效。 参数配置自动保存。 参数 整型。启用/禁用 UE 低优先级。 0 禁用 1 启用 备注 该命令仅在 LTE 模式下支持。 举例 AT+QNWCFG='lapi' +QNWCFG: 'lapi',0 OK AT+QNWCFG='lapi',1 OK 上海移远通信技术股份有限公司 112 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.25. AT+QNWPREFCFG 配置网络搜索偏好 该命令用于配置网络搜索偏好。 AT+QNWPREFCFG 配置网络搜索偏好 测试命令 AT+QNWPREFCFG=? 响应 +QNWPREFCFG: 'gw_band',(支持的列表) +QNWPREFCFG: 'lte_band',(支持的列表) +QNWPREFCFG: 'nsa_nr5g_band',(支持 NSA_NR5G_ba nd>列表) +QNWPREFCFG: 'nr5g_band',(支持的列 表) +QNWPREFCFG: 'mode_pref',(支持的列表) +QNWPREFCFG: 'srv_domain',(支持的范 围) +QNWPREFCFG: 'voice_domain',(支持的范围) +QNWPREFCFG: 'roam_pref',(支持的列表) +QNWPREFCFG: 'ue_usage_setting',(支持的 列表) +QNWPREFCFG: 'policy_band' +QNWPREFCFG: 'ue_capability_band' +QNWPREFCFG: 'rat_acq_order',(支持的列 表) +QNWPREFCFG: 'nr5g_disable_mode',(支持的列表) 最大响应时间 特性说明 OK 300 毫秒 / 5.25.1. AT+QNWPREFCFG='gw_band' 配置 WCDMA 频段 该命令用于配置 UE 优先搜索的 WCDMA 频段。 AT+QNWPREFCFG='gw_band' 配置 WCDMA 频段 设置命令 AT+QNWPREFCFG='gw_band'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'gw_band', OK 上海移远通信技术股份有限公司 113 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 若指定可选参数，配置优先搜索的 WCDMA 频段： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。待配置的 WCDMA 频段列表，以冒号隔开。格式：B1:B2:…:BN。 备注 RG50xQ 和 RM5xxQ 系列模块支持如下 WCDMA 频段： B1 WCDMA 2100 频段 B2 WCDMA 1900 频段 B3 WCDMA 1800 频段 B4 WCDMA 1700 频段 B5 WCDMA 850 频段 B6 WCDMA 800 频段 B8 WCDMA 900 频段 B19 WCDMA Japan 850 频段 举例 AT+QNWPREFCFG='gw_band' //查询 UE 当前配置的 WCDMA 频段。 +QNWPREFCFG: 'gw_band',1:2:3:4:5:6:7:8:9:19 OK AT+QNWPREFCFG='gw_band',1:2 OK //设置 WCDMA 频段为 B1 和 B2。 5.25.2. AT+QNWPREFCFG='lte_band' 配置 LTE 频段 该命令用于配置 UE 优先搜索的 LTE 频段。 AT+QNWPREFCFG='lte_band' 配置 LTE 频段 设置命令 响应 AT+QNWPREFCFG='lte_band'[,] 最大响应时间 特性说明 +QNWPREFCFG: 'lte_band', OK 若指定可选参数，配置优先搜索的 LTE 频段： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。待配置的 LTE 频段列表，以冒号隔开。格式：B1:B2:…:BN。 备注 RG50xQ 和 RM5xxQ 系列模块支持如下 LTE 频段： B1, B2, B3, B4, B5, B7, B8, B12, B13, B14, B17, B18, B19, B20, B25, B26, B28, B29, B30, B32, B34, B38, 39, B40, B41, B42, B43, B48, B66 and B71。 举例 AT+QNWPREFCFG='lte_band' //查询 UE 当前配置的 LTE 频段。 +QNWPREFCFG: 'lte_band',1:2:3:4:5:7:8:12:13:14:17:18:19:20:25:26:28:29:30:32:34:38:39:40:41: 42:66:71 OK AT+QNWPREFCFG='lte_band',1:2 OK //设置 LTE B1 和 LTE B2。 5.25.3. AT+QNWPREFCFG='nsa_nr5g_band' 配置 5G NR NSA 频段 该命令用于配置 UE 优先搜索的 5G NR NSA 频段。 AT+QNWPREFCFG='nsa_nr5g_band' 配置 5G NR NSA 频段 设置命令 AT+QNWPREFCFG='nsa_nr5g_band' [,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'nsa_nr5g_band', 上海移远通信技术股份有限公司 115 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 OK 若指定可选参数，配置优先搜索的 5G NR NSA 频段： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。待配置的 5G NR NSA 频段列表，以冒号隔开。格式：n1:n2:…:nx。 备注 RG50xQ 系列和 RM5xxQ 系列模块支持如下 5G NR NSA 频段： n1, n2, n3, n5, n7, n8, n12, n20, n25, n28, n38, n40, n41, n48, n66, n71, n77, n78, n79, n257, n258, n260 和 n261。 举例 AT+QNWPREFCFG='nsa_nr5g_band' //查询 UE 当前配置的 5G NR NSA 频段。 +QNWPREFCFG: 'nsa_nr5g_band',1:3:7:20:28:40:41:71:77:78:79 OK AT+QNWPREFCFG='nsa_nr5g_band',1:2 //设置 5G NR NSA n1 和 5G NR NSA n2。 OK 5.25.4. AT+QNWPREFCFG='nr5g_band' 配置 5G NR SA 频段 该命令用于配置 UE 优先搜索的 5G NR SA 频段。 AT+QNWPREFCFG='nr5g_band' 设置命令 AT+QNWPREFCFG='nr5g_band'[,] 配置 5G NR SA 频段 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'nr5g_band', OK 上海移远通信技术股份有限公司 116 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 若指定可选参数，配置优先搜索的 5G NR SA 频段： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。待配置的 5G NR SA 频段列表，以冒号隔开。格式：n1:n2:…:nx。 备注 RG50xQ 系列和 RM5xxQ 系列模块支持如下 5G NR SA 频段： n1, n2, n3, n5, n7, n8, n12, n20, n25, n28, n38, n40, n41, n48, n66, n71, n77, n78, n79。 举例 AT+QNWPREFCFG= 'nr5g_band' //查询 UE 当前配置的 5G NR SA 频段。 +QNWPREFCFG: 'nr5g_band',1:3:7:20:28:40:41:71:77:78:79 OK AT+QNWPREFCFG= 'nr5g_band',1:2 OK //设置 5G NR SA n1 和 5G NR SA n2。 5.25.5. AT+QNWPREFCFG='mode_pref' 配置网络搜索模式 该命令用于配置网络搜索模式。 AT+QNWPREFCFG='mode_pref' 配置网络搜索模式 设置命令 AT+QNWPREFCFG='mode_pref'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'mode_pref', OK 若指定可选参数，配置网络搜索模式： OK 或者 ERROR 上海移远通信技术股份有限公司 117 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。RAT 列表，以冒号隔开，格式： RAT1:RAT2:…RATN。模块支持的无线接 入技术如下： AUTO WCDMA LTE NR5G WCDMA & LTE & 5G NR 仅 WCDMA 仅 LTE 仅 5G NR 举例 AT+QNWPREFCFG= 'mode_pref' +QNWPREFCFG: 'mode_pref',AUTO //查询当前网络搜索模式。 OK AT+QNWPREFCFG= 'mode_pref',LTE //设置 RAT 为仅 LTE。 OK AT+QNWPREFCFG= 'mode_pref',LTE:NR5G //设置 RAT 为 LTE & 5G NR。 OK 5.25.6. AT+QNWPREFCFG='srv_domain' 配置服务域 该命令用于配置服务域。 AT+QNWPREFCFG='srv_domain' 配置服务域 设置命令 AT+QNWPREFCFG='srv_domain'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'srv_domain', OK 最大响应时间 特性说明 若指定可选参数，配置 UE 的服务域： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 118 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。UE 的服务域。 0 仅 CS 1 仅 PS 2 CS & PS 举例 AT+QNWPREFCFG='srv_domain' +QNWPREFCFG: 'srv_domain',2 OK AT+QNWPREFCFG='srv_domain',1 OK //查询当前服务域。 //设置服务域为仅 PS。 5.25.7. AT+QNWPREFCFG='voice_domain' 配置语音域 该命令用于配置 UE 的语音域。 AT+QNWPREFCFG='voice_domain' 配置语音域 设置命令 AT+QNWPREFCFG='voice_domain'[, ] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'voice_domain', OK 最大响应时间 特性说明 若指定可选参数，配置 UE 的语音域： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。UE 的语音域。 0 仅 CS 语音 1 仅 IMS PS 语音 2 首选 CS 语音 3 首选 IMS 语音 上海移远通信技术股份有限公司 119 / 277 举例 AT+QNWPREFCFG='voice_domain' +QNWPREFCFG: 'voice_domain',2 OK AT+QNWPREFCFG='voice_domain',3 OK RG50xQ&RM5xxQ 系列 AT 命令手册 //查询当前语音域配置。 //设置 IMS 语音为首选。 5.25.8. AT+QNWPREFCFG='roam_pref' 配置漫游偏好 该命令用于配置 UE 的漫游偏好。 AT+QNWPREFCFG='roam_pref' 配置漫游偏好 设置命令 AT+QNWPREFCFG='roam_pref'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'roam_pref', OK 最大响应时间 特性说明 若指定可选参数，配置漫游偏好： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。UE 漫游偏好。 1 仅在归属地网络漫游 3 在附属网络漫游 255 在任意网络漫游 举例 AT+QNWPREFCFG='roam_pref' +QNWPREFCFG: 'roam_pref',255 OK AT+QNWPREFCFG='roam_pref',1 OK //查询当前漫游配置。 //仅在归属地网络漫游。 上海移远通信技术股份有限公司 120 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 5.25.9. AT+QNWPREFCFG='ue_usage_setting' 配置 UE 使用模式 该命令用于配置 UE 使用模式。 AT+QNWPREFCFG='ue_usage_setting' 配置 UE 使用模式 设置命令 AT+QNWPREFCFG='ue_usage_settin g'[,] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'ue_usage_setting', OK 最大响应时间 特性说明 若指定可选参数，配置 UE 使用模式： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。UE 使用设置。 0 语音优先 1 数据优先 举例 AT+QNWPREFCFG='ue_usage_setting' +QNWPREFCFG: 'ue_usage_setting',1 OK AT+QNWPREFCFG='ue_usage_setting',0 OK //查询当前 UE 使用模式。 //设置语音优先。 5.25.10. AT+QNWPREFCFG='policy_band' 查询运营商策略频段 该命令用于查询运营商策略频段。 AT+QNWPREFCFG='policy_band' 查询运营商策略频段 设置命令 查询运营商策略频段 AT+QNWPREFCFG='policy_band' 响应 +QNWPREFCFG: 'gw_band', +QNWPREFCFG: 'lte_band', 上海移远通信技术股份有限公司 121 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 +QNWPREFCFG: 'nsa_nr5g_band', +QNWPREFCFG: 'nr5g_band', OK 300 毫秒 / 参数 字符串类型。待配置的 WCDMA 频段，以冒号隔开。格式：B1:B2:…:BN。 字符串类型。待配置的 LTE 频段，以冒号隔开。格式：B1:B2:…:BN。 字符串类型。待配置的 5G NR NSA 频段，以冒号隔开。格式：n1:n2:…:nx。 字符串类型。待配置的 5G NR SA 频段，以冒号隔开。格式：n1:n2:…:nx。 备注 1. RG50xQ 系列和 RM5xxQ 系列模块支持的 WCDMA 频段如下： B1 WCDMA 2100 band B2 WCDMA 1900 band B3 WCDMA 1800 band B4 WCDMA 1700 band B5 WCDMA 850 band B6 WCDMA 800 band B8 WCDMA 900 band B19 WCDMA Japan 850 band 2. RG50xQ 系列和 RM5xxQ 系列模块支持的 LTE 频段如下： B1, B2, B3, B4, B5, B7, B8, B12, B13, B14, B17, B18, B19, B20, B25, B26, B28, B29, B30, B32, B34, B38, 39, B40, B41, B42, B43, B48, B66, B71。 3. RG50xQ 系列和 RM5xxQ 系列模块支持的 5G NR NSA 频段如下： n1, n2, n3, n5, n7, n8, n12, n20, n25, n28, n38, n40, n41, n48, n66, n71, n77, n78, n79, n257, n258, n260, n261。 4. RG50xQ 系列和 RM5xxQ 系列模块支持的 5G NR SA 频段如下： n1, n2, n3, n5, n7, n8, n12, n20, n25, n28, n38, n40, n41, n48, n66, n71, n77, n78, n79。 举例 AT+QNWPREFCFG='policy_band' +QNWPREFCFG: 'gw_band',1:8 +QNWPREFCFG: 'lte_band',1:3:8 +QNWPREFCFG: 'nsa_nr5g_band',78 +QNWPREFCFG: 'nr5g_band',78 上海移远通信技术股份有限公司 122 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK 5.25.11. AT+QNWPREFCFG='ue_capability_band' 查询 UE 频段能力 该命令用于查询 UE 频段能力。 AT+QNWPREFCFG='ue_capability_band' 查询 UE 频段能力 设置命令 响应 AT+QNWPREFCFG='ue_capability_ba +QNWPREFCFG: 'gw_band', nd' +QNWPREFCFG: 'lte_band', +QNWPREFCFG: 'nsa_nr5g_band', +QNWPREFCFG: 'nr5g_band', 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。待配置的 WCDMA 频段，以冒号隔开。格式：B1:B2:…:BN。 字符串类型。待配置的 LTE 频段，以冒号隔开。格式：B1:B2:…:BN。 字符串类型。待配置的 5G NR NSA 频段，以冒号隔开。格式：n1:n2:…:nx。 字符串类型。待配置的 5G NR SA 频段，以冒号隔开。格式：n1:n2:…:nx。 备注 1. RG50xQ 系列和 RM5xxQ 系列模块支持的 WCDMA 频段如下： B1 WCDMA 2100 频段 B2 WCDMA 1900 频段 B3 WCDMA 1800 频段 B4 WCDMA 1700 频段 B5 WCDMA 850 频段 B6 WCDMA 800 频段 B8 WCDMA 900 频段 B19 WCDMA Japan 850 频段 2. RG50xQ 系列和 RM5xxQ 系列模块支持的 LTE 频段如下： B1, B2, B3, B4, B5, B7, B8, B12, B13, B14, B17, B18, B19, B20, B25, B26, B28, B29, B30, B32, B34, B38, 39, B40, B41, B42, B43, B48, B66 和 B71。 3. RG50xQ 系列和 RM5xxQ 系列模块支持的 5G NR NSA 频段如下： n1, n2, n3, n5, n7, n8, n12, n20, n25, n28, n38, n40, n41, n48, n66, n71, n77, n78, n79, n257, n258, 上海移远通信技术股份有限公司 123 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 n260 和 n261。 4. RG50xQ 系列和 RM5xxQ 系列模块支持的 5G NR SA 频段如下： n1, n2, n3, n5, n7, n8, n12, n20, n25, n28, n38, n40, n41, n48, n66, n71, n77, n78, n79。 举例 AT+QNWPREFCFG='ue_capability_band' +QNWPREFCFG: 'gw_band',1:8 +QNWPREFCFG: 'lte_band',1:3:8 +QNWPREFCFG: 'nsa_nr5g_band',78 +QNWPREFCFG: 'nr5g_band',78 OK 5.25.12. AT+QNWPREFCFG='rat_acq_order' 配置 RAT 优先级 该命令用于配置 RAT 获取顺序。 AT+QNWPREFCFG='rat_acq_order' 配置 RAT 优先级 设置命令 AT+QNWPREFCFG='rat_acq_order'[, ] 响应 若省略可选参数，查询当前配置： +QNWPREFCFG: 'rat_acq_order', OK 最大响应时间 特性说明 若指定可选参数，配置 RAT 获取顺序： OK 或者 ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 字符串类型。指定 RAT 优先级，以冒号隔开。格式：RAT1:RAT2:…RATN。模块支 持的 RAT 如下： WCDMA WCDMA LTE LTE NR5G 5G NR 上海移远通信技术股份有限公司 124 / 277 举例 AT+QNWPREFCFG='rat_acq_order' +QNWPREFCFG: 'rat_acq_order',NR5G:LTE:WCDMA OK AT+QNWPREFCFG='rat_acq_order',LTE:NR5G:WCDMA OK AT+CFUN=1,1 OK AT+QNWPREFCFG='rat_acq_order' +QNWPREFCFG: 'rat_acq_order', LTE:NR5G:WCDMA OK RG50xQ&RM5xxQ 系列 AT 命令手册 //查询当前 RAT 顺序。 //设置 RAT 优先级。 //重置模块 //查询当前 RAT 顺序。 5.25.13. AT+QNWPREFCFG='nr5g_disable_mode' 禁用 5G NR 配置 该命令用于禁用 5G NR 配置。 AT+QNWPREFCFG='nr5g_disable_mode' 禁用 5G NR 配置 设置命令 AT+QNWPREFCFG='nr5g_disable_ mode'[,] 响应 若指定可选参数，查询当前配置： +QNWPREFCFG: 'nr5g_disable_mode', OK 最大响应时间 特性说明 若省略可选参数，禁用 5G NR 配置： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。禁用 5G NR NA/NSA。 0 不禁用 NA 和 NSA 1 禁用 SA 2 禁用 NSA 上海移远通信技术股份有限公司 125 / 277 举例 AT+QNWPREFCFG='nr5g_disable_mode' +QNWPREFCFG: 'nr5g_disable_mode',0 OK AT+QNWPREFCFG='nr5g_disable_mode',1 OK RG50xQ&RM5xxQ 系列 AT 命令手册 //查询当前 5G NR 配置。 //禁用 5G NR SA。 上海移远通信技术股份有限公司 126 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 6 呼叫相关命令 6.1. ATA 呼叫应答 该命令用于连接 MT 以应答由 URC RING 指示的语音来电或者数据来电。执行该命令后，MT 发送摘 机信号到远程站。 ATA 呼叫应答 执行命令 ATA 响应 若数据拨号并成功建立连接： CONNECT 此时 MT 切换到数据模式 仅 当 ATX 设 置 的 大 于 0 时 ， 返 回 CONNECT。 MT 切换到命令模式并呼叫释放： OK 若语音拨号并成功建立连接： OK 最大响应时间 特性说明 参考 V.25ter 若不能建立连接： NO CARRIER 90 秒，取决于网络状态 / 备注 1. ATA 操作忽略同一命令行中其他命令。 2. 若在执行 ATA 过程中模块收到字符，该命令可能被终止执行。但是在建立连接的某些状态（如：握 手状态），该命令不会被中止执行。 上海移远通信技术股份有限公司 127 / 277 举例 RING AT+CLCC +CLCC: 1,0,0,1,0,'',129 +CLCC: 2,1,4,0,0,'02154450290',129 OK ATA OK RG50xQ&RM5xxQ 系列 AT 命令手册 //来电。 //LTE 模式下 PS 呼叫。 //来电。 //使用 ATA 应答此语音呼叫。 6.2. ATD 发起呼叫 该命令用于建立语音或数据主叫，还可以用于控制补充业务。 ATD 发起呼叫 执行命令 ATD[][;] 响应 若无拨号音且设置 ATX2 或者 ATX4： NO DIAL TONE 若遇忙占线且设置 ATX3 或者 ATX4： BUSY 若连接未成功建立： NO CARRIER 若成功发起非语音呼叫： CONNECT MT 切换为数据模式。 仅当 ATX 设置的大于 0 时，返回 呼叫释放后 MT 返回命令模式： OK 最大响应时间 特性说明 参考 V.25ter 若成功发起语音呼叫： OK 5 秒，取决于网络状态 / 上海移远通信技术股份有限公司 128 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 拨号位字符串和 V.25ter 中可选的拨号修饰符。 拨号位：0~9，*，#，+，A，B，C 以下 V.25ter 拨号修饰符可忽略： ,（逗号），T，P，!，W，@ 字符串类型。GSM 拨号修饰符。 I 激活 CLIR（主叫用户不允许在被叫用户话机上显示自己的电话号码） i 禁止 CLIR（主叫用户允许在被叫用户话机上显示自己的电话号码） G 仅在本次呼叫中激活闭合用户群调用 g 仅在本次呼叫中去激活闭合用户群调用 仅在建立语音呼叫时可用，呼叫结束后返回至命令状态。 备注 1. 若在执行 ATD 过程中收到 ATH 或某一字符，该命令可能被终止执行。但是在建立连接的某些状态（如： 握手状态），该命令不会被中止执行。 2. =I/i 仅适用于拨号字符中无'*'或'#'的情况。 3. 关于结果码的设置和呼叫监控参数的详细介绍，详情参考 ATX； 4. 使用 ATD 拨号后响应： 对于语音呼叫，可设置两种不同的响应模式： 拨号完成后或者在呼叫建立成功后，MT 立即返回 OK。此设置由 AT+COLP 控制。默认设置为 AT+COLP=0，即拨号完成后，MT 立即返回 OK。否则 MT 返回 OK、BUSY、NO DIAL TONE 或 NO CARRIER。 5. 在一个已激活的语音呼叫中，使用 ATD： ⚫ 当已有一个已激活的语音呼叫，用户发起第二个语音呼叫时，第一个语音呼叫将自动设置为呼 叫保持状态。 ⚫ 所有呼叫的当前状态均可随时使用 AT+CLCC 进行查询。 举例 ATD10086; OK //拨号。 上海移远通信技术股份有限公司 129 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 6.3. ATH 挂断现有连接 该命令用于断开当前数据通话或语音通话，即本地 TE 从命令行断开并终止通话。也可使用 AT+CHUP 挂断语音通话。 ATH 挂断现有连接 执行命令 ATH[n] 最大响应时间 特性说明 参考 V.25ter 响应 OK 90 秒，取决于网络状态 / 参数 整型。 0 从命令行断开现有所有通话并终止通话。 6.4. AT+CVHU 控制语音通话挂断 该命令用于控制 ATH 是否可用于断开语音通话。 AT+CVHU 控制语音通话挂断 测试命令 AT+CVHU=? 响应 +CVHU: (支持的列表) 查询命令 AT+CVHU? OK 响应 +CVHU: 设置命令 AT+CVHU= 最大响应时间 特性说明 参考 OK 响应 OK 或者 ERROR 300 毫秒 / 上海移远通信技术股份有限公司 130 / 277 3GPP TS 27.007 参数 整型。 0 ATH 可用于断开语音通话 1 ATH 不可用于断开语音通话，仅返回 OK RG50xQ&RM5xxQ 系列 AT 命令手册 6.5. AT+CHUP 挂断通话 该命令用于取消所有活跃、等待、保持状态的语音通话。若需断开数据通话，需使用 ATH。 AT+CHUP 挂断通话 测试命令 AT+CHUP=? 执行命令 AT+CHUP 最大响应时间 特性说明 参考 3GPP 27.007 响应 OK 响应 OK 或者 ERROR 90 秒，取决于网络状态 / 举例 RING AT+CHUP OK //来电。 //挂断通话。 6.6. ATS0 设置自动应答前振铃次数 该命令用于设置来电的自动应答前振铃次数。若设置为非零取值，呼叫指示（RING）达到设置次 数后，ME 自动应答。 ATS0 设置自动应答前振铃次数 查询命令 响应 上海移远通信技术股份有限公司 131 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 ATS0? 设置命令 ATS0= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 或者 ERROR 300 毫秒 / 参数 整型。 0 禁用自动应答 1~255 达到指定的振铃次数后，启用自动应答 备注 若值设置过高，呼叫方可能在呼叫被自动应答前停止呼叫。 举例 ATS0=3 OK RING ##0 RING ##0 RING ##0 //设置三次振铃后自动接听。 //来电。 //振铃 3 次后自动应答。 6.7. ATS6 设置盲拨前的等待时间 该命令的设置只是为了实现兼容，没有其他效用。 上海移远通信技术股份有限公司 132 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 ATS6 设置盲拨前的等待时间 查询命令 ATS6? 设置命令 ATS6= 最大响应时间 特性说明 参考 V.25ter 响应 OK 响应 OK 或者 ERROR 300 毫秒 / 参数 整型。盲拨前的等待时间。范围：0~10；默认值：2；单位：秒。 6.8. ATS7 设置呼叫建立完成的等待时间 该命令用于指定应答或发起通话时呼叫建立完成的等待时间。若在指定等待时间内连接未完成，MT 将 断开连接。 ATS7 设置呼叫建立完成的等待时间 查询命令 响应 ATS7? 设置命令 ATS7= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 / 上海移远通信技术股份有限公司 133 / 277 参数 整型。 0 禁用 1~255 连接创建完成的等待时间。单位：秒。 RG50xQ&RM5xxQ 系列 AT 命令手册 6.9. ATS8 设置逗号修饰符等待时间 该命令的设置只是为了实现兼容，没有其他效用。 ATS8 设置逗号修饰符等待时间 查询命令 响应 ATS8? 设置命令 ATS8= 最大响应时间 特性说明 参考 V.25ter OK 响应 OK 300 毫秒 / 参数 整型。 0 拨号字符串中遇到逗号时不暂停 1–2–255 拨号字符串中遇到逗号时等待的秒数 6.10. ATS10 设置断开连接延迟时间 该命令用于设置当无数据载波时，断开连接的延迟时间，此时 MT 仍保持连接。若断开连接前再次监 测到数据载波，则 MT 保持连接。 ATS10 设置断开连接延迟时间 查询命令 响应 ATS10? OK 上海移远通信技术股份有限公司 134 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 设置命令 ATS10= 最大响应时间 特性说明 参考 V.25ter 响应 OK 300 毫秒 / 参数 整型。 当 UE 显示无数据载波时，断开连接前等待的时间。范围：1~254；默认值：15；单位：十分之 一秒。 6.11. AT+CSTA 选择地址类型 该命令用于根据 3GPP 规范选择进一步拨号命令 ATD 的号码类型。 AT+CSTA 选择地址类型 测试命令 AT+CSTA=? 响应 +CSTA: (支持的列表) 查询命令 AT+CSTA? OK 响应 +CSTA: 设置命令 AT+CSTA=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 / 参数 整型。当前地址类型设置。 129 未知类型 145 国际类型（包含字符'+'） 上海移远通信技术股份有限公司 135 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 6.12. AT+CLCC 查询当前 MT 呼叫 该命令用于查询当前 MT 所有呼叫。若命令执行成功但无呼叫，将不会有信息发送到 TE，只返回 OK。 AT+CLCC 查询当前 MT 呼叫 测试命令 AT+CLCC=? 执行命令 AT+CLCC 响应 OK 响应 [+CLCC: ,,,,[,, [,]] [...] OK 最大响应时间 特性说明 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。呼叫识别号（详情参考 3GPP TS 22.030）。该参数可用于 AT+CHLD。 整型。 0 主叫（MO） 1 被叫（MT） 整型。呼叫状态。 0 激活状态 1 呼叫保持状态 2 主叫，拨号状态 3 主叫，回铃音状态 4 被叫，来电状态 5 被叫，呼叫等待状态 整型。呼叫模式。 0 语音呼叫 1 数据呼叫 2 传真 整型。 0 不在多方通话中 1 在多方通话中 字符串类型。由规定电话号码格式。 整型。八位位组的地址类型（详情参考 3GPP TS 24.008 第 10.5.4.7 节）。通常有 3 上海移远通信技术股份有限公司 136 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 种类型： 129 未知类型 145 国际号码（以'+'开头） 161 国家号码 字母数字格式的，与电话簿中的记录相对应。 错误码。详情参考第 13.5 章。 举例 ATD10086; OK AT+CLCC +CLCC: 1,0,0,1,0,'',129 +CLCC: 2,0,0,0,0,'10086',129 OK //发起通话。 //LTE 模式下 PS 通话。 //发起通话且通话已被接听。 6.13. AT+CR 控制服务上报 该命令用于控制当通话建立时，MT 是否向 TE 上报+CR: 。 AT+CR 控制服务上报 测试命令 AT+CR=? 响应 +CR: (支持的列表) 执行命令 AT+CR? OK 响应 +CR: 执行命令 AT+CR=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 / 上海移远通信技术股份有限公司 137 / 277 参数 整型。 0 1 字符串类型。 ASYNC SYNC REL ASYNC REL SYNC 禁用 启用 异步透传 同步透传 异步非透传 同步非透传 RG50xQ&RM5xxQ 系列 AT 命令手册 6.14. AT+CRC 设置来电指示扩展格式 该命令用于控制来电指示是否使用扩展格式。若使用扩展格式，来电时将使用非请求结果码+CRING: 向 TE 提示，而不是使用 RING。 AT+CRC 设置来电指示扩展格式 测试命令 AT+CRC=? 响应 +CRC: (支持的列表) 查询命令 AT+CRC? OK 响应 +CRC: 设置命令 AT+CRC=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 138 / 277 参数 整型。 0 禁用扩展格式 1 启用扩展格式 字符串类型。 ASYNC 异步透传 SYNC 同步透传 REL ASYNC 异步非透传 REL SYNC 同步非透传 FAX 传真 VOICE 语音 举例 AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK RING ATH OK //启用扩展格式。 //语音来电提示。 //禁用扩展格式。 //来电提示。 RG50xQ&RM5xxQ 系列 AT 命令手册 6.15. AT+CRLP 设置无线链路协议 该命令用于当发起非透传数据通话时，设置无线链路协议。 AT+CRLP 设置无线链路协议 测试命令 AT+CRLP=? 响应 +CRLP: (支持的范围),(支持的 范围),(支持的范围),(支持的范围), +CRLP: (支持的范围),(支持的范围),(支持的范围),(支持的范围), +CRLP: (支持的范围),(支持的范围),(支持的范围),(支持的范围), OK 上海移远通信技术股份有限公司 139 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 查询命令 AT+CRLP? 响应 +CRLP: ,,,, ... 设置命令 OK 响应 AT+CRLP=[[,[,[,< OK N2>[,]]]]] 最大响应时间 300 毫秒 特性说明 / 参考 3GPP TS27.007 参数 整型。互通窗口大小。 当=0/1，互通窗口大小。范围：0~61；默认值：61。 当=2，范围：0~488；默认值：240。 整型。移动窗口大小。 当=0/1，移动窗口大小。范围：0~61；默认值：61。 当=2，范围：0~488；默认值：240。 整型。 当 =0/1 ， 应 答 定 时 器 T1 ， 以 10 毫 秒 为 单 位 。 范 围 ： 38~255 ； 默 认 值 ： 48。 当=2，范围：42~255；默认值：52。 整型。重传尝试次数。范围：1~55；默认值：6。 整型。RLP 版本号。范围：0~2。 6.16. AT+QECCNUM 配置紧急电话号码 该命令可以用于查询、添加、删除紧急电话号码。 AT+QECCNUM 配置紧急电话号码 测试命令 AT+QECCNUM=? 响应 +QECCNUM: (支持的列表) 设置命令 AT+QECCNUM=[,[,[,[,…[,]]]]] OK 响应 若=0，指定，缺省，则查询当前 紧急电话号码类型配置的电话号码： +QECCNUM: ,,[,…] 上海移远通信技术股份有限公司 140 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK 若 =1 ， =0 或 1 ， 且 至 少 输 入 一 个 ，则添加有卡或无卡紧急电话号码： OK 或者 ERROR 若 =2 ， =0 或 1 ， 且 至 少 输 入 一 个 ，则删除有卡或无卡紧急电话号码： OK 或者 ERROR 设置命令 AT+QECCNUM=[,,,] 若=3，和同时缺省，则重置紧急 电话号码且下次开机时生效： OK 或者 ERROR 响应 若=4，指定、和， 则添加一个指定属性的紧急电话号码： OK 或者 ERROR 若=5，、和同时缺 省，则查询所有的紧急电话号码及其属性值： +QECCNUM: 0,,[,…] +QECCNUM: 1,,[,…] +QECCNUM: 2,,[,…] +QECCNUM: 3,,[,…] 查询命令 AT+QECCNUM? OK 响应 +QECCNUM: 0,,[,…] +QECCNUM: 1,,[,…] 最大响应时间 特性说明 OK 300 毫秒 / 上海移远通信技术股份有限公司 141 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。ECC 号码操作模式。 0 查询 ECC 号码 1 添加默认属性的 ECC 号码 2 删除 ECC 号码 3 重置 ECC 号码 4 添加一个指定属性的 ECC 号码 5 查询所有 ECC 号码和及其属性 整型。ECC 号码类型。 0 未插(U)SIM 卡时模块中存储的 ECC 号码 1 插(U)SIM 卡时模块中存储的 ECC 号码 2 网络下发的 ECC 号码 3 (U)SIM 卡存储的 ECC 号码 整型。紧急电话号码属性。 0 默认（Default） 1 匪警电话（Police） 2 急救点电话（Ambulance） 4 火警电话（Fire Brigade） 8 海军陆战队（Marine Guard） 16 山地救援（Mountain Rescue） 32 手动启动的紧急电话（Manually Initiated eCall） 64 自动启动的紧急电话（Automatically Initiated eCall） 字符串类型。ECC 号码。例如：'110'、'119'。 备注 1. 仅存储在模块中的 ECC 号码可以进行修改，网络下发的及(U)SIM 卡中存储的 ECC 号码不可修改。 2. 添加有(U)SIM 卡 ECC 号码时，若该号码已存在，则添加失败。 3. ECC 号码查表顺序：网络下发的 ECC 号码 > (U)SIM 卡存储的 ECC 号码 > 有/无(U)SIM 卡时存储 在模块的 ECC 号码。 举例 AT+QECCNUM=? +QECCNUM: (0-5) //查询支持的 ECC 号码操作模式。 OK AT+QECCNUM? //查询有卡和无卡时的 ECC 号码。 +QECCNUM: 0,'911','112','00','08','110','999','118','119' +QECCNUM: 1,'911','112' OK AT+QECCNUM=0,1 //查询有卡的 ECC 号码。 上海移远通信技术股份有限公司 142 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 +QECCNUM: 1,'911','112' OK AT+QECCNUM=1,1,'110', '234' //添加有卡时的 ECC 号码'110'和'234'。 OK AT+QECCNUM=0,1 //查询有卡时的 ECC 号码。 +QECCNUM: 1, '911','112','110','234' OK AT+QECCNUM=2,1,'110' //删除有卡时的 ECC 号码'110'。 OK AT+QECCNUM=0,1 //查询有卡时的 ECC 号码。 +QECCNUM: 1, '911','112','234' OK AT+QECCNUM=5 //查询所有的紧急电话号码和紧急号码的属性。 +QECCNUM: 0,'911',0,'112',0,'00',0,'08',0,'110',0,'999',0,'118',0,'119',0 +QECCNUM: 1,'911',0,'112',0,'234',0 +QECCNUM: 2,'110',1,'120',2,'119',4,'122',8,'999',16 +QECCNUM: 3,'112',0,'000',0,'08',0,'118',0,'122',0,'911',0,'999',0,'119',0,'120',0,'110',0 OK AT+QECCNUM=4,1,'123',1 //添加有卡时警匪 ECC 号码'123'。 OK AT+QECCNUM=5 //查询所有的紧急电话号码和紧急号码的属性。 +QECCNUM: 0,'911',0,'112',0,'00',0,'08',0,'110',0,'999',0,'118',0,'119',0 +QECCNUM: 1,'911',0,'112',0,'234',0,'123',1 +QECCNUM: 2,'110',1,'120',2,'119',4,'122',8,'999',16 +QECCNUM: 3,'112',0,'000',0,'08',0,'118',0,'122',0,'911',0,'999',0,'119',0,'120',0,'110',0 OK AT+QECCNUM=3 OK //重置 ECC 号码，模块重启后生效。 上海移远通信技术股份有限公司 143 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 6.17. AT^DSCI 指示呼叫状态 该命令用于配置是否使用 URC DSCI 指示呼叫状态。 AT^DSCI 指示呼叫状态 测试命令 AT^DSCI=? 响应 ^DSCI: (支持的列表) 查询命令 AT^DSCI? OK 响应 ^DSCI: 设置命令 AT^DSCI=[] 特性说明 OK 响应 OK / 参数 整型。配置是否通过 URC DSCI 上报呼叫状态。 0 禁用 1 启用 整型。呼叫 ID。 整型。呼叫方向。 0 主叫（MO） 1 被叫（MT） 整型。呼叫状态。 1 CALL_LOCAL_HOLD 2 CALL_ORIGINAL 呼叫本地保持 呼叫发起 3 CALL_CONNECT 呼叫连接 4 CALL_INCOMING 5 CALL_WAITING 呼叫接入 呼叫等待 6 CALL_END 呼叫结束 7 CALL_ALERTING 呼叫提醒 8 CALL_REMOTE_HOLD 呼叫远程保持 9 CALL_BOTH_HOLD 呼叫双方保持 整型。呼叫类型。 0 语音呼叫 1 PS 呼叫 字符串类型。手机号码。 整型。八位位组的地址类型（详情参考 3GPP TS 24.008 第 10.5.4.7 节）。通常有 3 种 类型： 上海移远通信技术股份有限公司 144 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 129 未知类型 145 国际类型（包含字符'+'） 161 国家类型 备注 若=1，将上报 URC ^DSCI: ,,,,,。 参数说明 整型。呼叫 ID。 整型。呼叫方向。 0 移动发起的呼叫（MO） 1 移动终止的呼叫（MT） 整型。呼叫状态。 1 CALL_LOCAL_HOLD 呼叫本地保持 2 CALL_ORIGINAL 呼叫发起 3 CALL_CONNECT 呼叫连接 4 CALL_INCOMING 呼叫接入 5 CALL_WAITING 呼叫等待 6 CALL_END 呼叫结束 7 CALL_ALERTING 呼叫提醒 8 CALL_REMOTE_HOLD 呼叫远程保持 9 CALL_BOTH_HOLD 呼叫双方保持 整型。呼叫类型。 0 语音呼叫 1 PS 呼叫 字符串类型。手机号码。 整型。八位位组的地址类型（详情参考 3GPP TS 24.008 第 10.5.4.7 节）。通常有 3 种类型： 129 未知类型 145 国际类型（包含字符'+'） 161 国家类型 举例 //拨号 AT^DSCI=1 OK ATD10086; OK ^DSCI: 1,0,2,0,10086,129 ^DSCI: 1,0,7,0,10086,129 ^DSCI: 1,0,3,0,10086,129 //启用 URC DSCI 上报呼叫状态。 //拨号 10086。 //发起语音呼叫。 //呼叫提醒。 //呼叫连接成功。 上海移远通信技术股份有限公司 145 / 277 ATH OK ^DSCI: 1,0,6,0,10086,129 //来电 RING ^DSCI: 1,1,4,0,13022100000,129 RING ^DSCI: 1,1,6,0,13022100000,129 NO CARRIER RG50xQ&RM5xxQ 系列 AT 命令手册 //呼叫结束。 //新呼叫接入。 //呼叫结束。 上海移远通信技术股份有限公司 146 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 7 电话本相关命令 7.1. AT+CNUM 查询本机号码 该命令用于读取(U)SIM 卡中所有本机号码记录。 AT+CNUM 查询本机号码 测试命令 AT+CNUM=? 执行命令 AT+CNUM 响应 OK 响应 [+CNUM: [],,] […] OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。与相关联，使用的字符集应为 AT+CSCS 设置的字符集。 字符串类型。电话号码。格式由决定。 整型。号码地址类型。 129 未知类型 145 国际号码（以'+'开头） 161 国家号码 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 147 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 7.2. AT+CPBF 搜索电话本记录 该命令用于搜索当前电话本存储器中以给定的字符串开头的电话本记录，返回的所有记录以 字母数字顺序排列。 AT+CPBF 搜索电话本记录 测试命令 AT+CPBF=? 响应 +CPBF: , 设置命令 AT+CPBF= OK 响应 [+CPBF: ,,,] … OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 MT 功能相关： +CME ERROR: 取决于电话本记录数量。 / 参数 整型。的最大长度。 整型。的最大长度。 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 整型。电话号码在存储器中的位置。 字符串类型。电话号码。格式由决定。 整型。号码地址类型。 129 未知类型 145 国际号码（以'+'开头） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 148 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 7.3. AT+CPBR 读取电话本记录 该命令用于读取电话本存储器中位置在与之间（闭区间）的电话本记录。如果只输 入，则只返回在位置的电话本记录。 AT+CPBR 读取电话本记录 测试命令 AT+CPBR=? 响应 +CPBR: (支持的列表),, 设置命令 AT+CPBR=[,] OK 响应 +CPBR: ,,, … OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP 27.007 若错误与 MT 功能相关： +CME ERROR: 取决于电话本记录数量。 / 参数 整型。电话号码在存储器中的位置。 整型。的最大长度。 整型。的最大长度。 整型。需读取的电话号码在存储器中的起始位置。 整型。需读取的电话号码在存储器中的终止位置。 整型。号码地址类型。 129 未知类型 145 国际号码（以'+'开头） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 149 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 7.4. AT+CPBS 设置电话本存储器 该命令用于设置电话本存储器。 AT+CPBS 设置电话本存储器 测试命令 AT+CPBS=? 查询命令 AT+CPBS? 设置命令 AT+CPBS= 最大响应时间 特性说明 参数 3GPP 27.007 响应 +CPBS: (list of supported s) OK 或者 ERROR 若错误与 MT 功能相关： +CME ERROR: 响应 +CPBS: [,,] OK 或者 ERROR 若错误与 MT 功能相关： +CME ERROR: 响应 OK 或者 ERROR 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 150 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。 'SM' (U)SIM 电话本 'DC' 已拨号码 (不适用于 AT+CPBW) 'FD' (U)SIM 卡上的 FDN 文件 （对于 AT+CPBW，需验证 PIN2） 'LD' (U)SIM 卡上次拨打号码（不适用于 AT+CPBW） 'MC' MT 未接听号码（不适用于 AT+CPBW） 'ME' MT 电话本 'RC' MT 已接号码（不适用于 AT+CPBW） 'EN' (U)SIM 卡或 MT 紧急呼叫号码（不适用于 AT+CPBW） 'ON' 本机号码 MSISDN 整型。当前存储器中已用的存储单元。 整型。当前存储器中总计的存储单元。 错误码。详情参考第 13.5 章。 7.5. AT+CPBW 写入电话本记录 该命令用于在当前存储器指定位置中添加、删除电话本记录。若设置命令仅包含，则 相应位置的电话本记录将被删除。 AT+CPBW 写入电话本记录 测试命令 AT+CPBW=? 响应 +CPBW: (支持的范围),,(支持的列 表), OK 或者 ERROR 设置命令 AT+CPBW=[][,[,[,]]] 若错误与 MT 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 151 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 特性说明 / 参考 3GPP 27.007 参数 整型。电话号码在存储器中的位置。 整型。的最大长度。 整型。的最大长度。 字符串类型。电话号码，格式由决定。 整型。号码地址类型。 129 未知类型 145 国际号码（以'+'开头） 161 国家号码 字符串类型。该字段以为最大长度，字符集由 AT+CSCS 设置。 错误码。详情参考第 13.5 章。 举例 AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' //添加一条电话本记录。 OK AT+CPBW=10 //删除一条电话本记录。 OK 上海移远通信技术股份有限公司 152 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 8 短消息相关命令 8.1. AT+CSMS 选择短消息服务类型 该命令用于选择短消息服务类型并返回 MT 支持的短消息类型。 AT+CSMS 选择短消息服务类型 测试命令 AT+CSMS=? 响应 +CSMS: (支持的列表) 查询命令 AT+CSMS? OK 响应 +CSMS: ,,, 设置命令 AT+CSMS= OK 响应 +CSMS: ,, OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。短消息服务类型。 0 详情参考 3GPP TS 23.040 和 3GPP TS 23.041（SMS 的 AT 命令语法与3GPP TS 27.005 Phase 2 4.7.0 版本兼容；支持不需要新命令语法的 Phase 2+功能（例如：使用 Phase 2+新编码方案修正消息路由））。 1 详情参考 3GPP TS 23.040 和 3GPP TS 23.041（SMS 的 AT 命令语法与3GPP TS 27.005 Phase 2+版本兼容；设置为 1 时的要求已在对应命令描述中说明。） 上海移远通信技术股份有限公司 153 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 整型。移动终端短消息。 0 不支持 1 支持 整型。移动起始短消息。 0 不支持 1 支持 整型。广播类型短消息。 0 不支持 1 支持 错误码。详情参考第 13.6 章。 举例 AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //列出支持的短消息服务类型。 //设置短消息服务类型为 1。 //查询当前短消息服务类型。 8.2. AT+CMGF 配置短消息模式 该命令用于指定短消息采用的格式。表示 TA-TE 之间，读/写短消息时，采用的是文本模式还 是 PDU 模式。消息格式可设置为 PDU 模式（使用整个 TP 数据单元）或者文本模式（消息报头和正文分 别以不同的参数形式展示）。文本模式通过 AT+CSCS 指定的来告知 TA-TE 交互中消息正文使用的 字符集。 AT+CMGF 配置短消息模式 测试命令 AT+CMGF=? 响应 +CMGF: (支持的列表) 查询命令 AT+CMGF? OK 响应 +CMGF: OK 上海移远通信技术股份有限公司 154 / 277 设置命令 AT+CMGF[=] 最大响应时间 特性说明 参考 3GPP TS 27.005 参数 整型。短消息模式。 0 PDU 模式 1 文本模式 响应 OK 300 毫秒 / RG50xQ&RM5xxQ 系列 AT 命令手册 8.3. AT+CSCA 设置短消息服务中心地址 该设置命令用于当移动起始短消息发送后，更新 SMSC（短消息服务中心）地址。在文本模式下，可 使用设置命令进行设置。在 PDU 模式下，仅当 SMSC 地址的长度被编码到参数值为 0 的时，方可 使用设置命令进行设置。 AT+CSCA 设置短消息服务中心地址 测试命令 响应 AT+CSCA=? 查询命令 OK 响应 AT+CSCA? +CSCA: , 设置命令 AT+CSCA=[,] 最大响应时间 特性说明 参考 3GPP TS 27.005 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 155 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 字符串类型。短消息中心地址。详情参考 3GPP TS 24.011 RP SC 地址 Address-Value 字段；BCD 码（或 GSM 7 位默认字母字符）转换为当前选择的 TE 字符集的字符（参考 3GPP TS 27.007 中 AT+CSCS）。地址类型由定义。 整型。八位位组地址类型。详情参考 3GPP TS 24.011 RP SC 地址 Type-of-Address（默 认参考）。 举例 AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //设置短消息服务中心号码。 //查询短消息服务中心号码。 8.4. AT+CPMS 配置短消息首选存储位置 该命令用于选择查询或配置短消息的存储位置，包括、和。 AT+CPMS 配置短消息首选存储位置 测试命令 AT+CPMS=? 响应 +CPMS: (支持的列表),(支持的列表),(支持 的列表) 查询命令 AT+CPMS? OK 响应 +CPMS: ,,,,,,,, 设置命令 AT+CPMS=[,[,]] OK 响应 +CPMS: ,,,,, OK 最大响应时间 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 上海移远通信技术股份有限公司 156 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 特性说明 参考 3GPP TS 27.005 该命令立即生效； 参数配置不自动保存。 参数 字符串类型。待读取和删除短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 'SR' 短消息状态报告存储位置 字符串类型。待写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 'SR' 短消息状态报告存储位置 字符串类型。若没有建立到 TE 的路由（参考 AT+CNMI），则接收的短消息存储在该存储器 内。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 'SR' 短消息状态报告存储位置 整型。中当前短消息的数量。 整型。中可存储的短消息的总数量。 错误码。详情参考第 13.6 章。 举例 AT+CPMS? //查询当前短消息存储器。 +CPMS: 'ME',0,20,'ME',0,20,'ME',0,20 OK AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //将短消息存储器更改为'SM'。 OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //查询当前短消息存储器。 OK 上海移远通信技术股份有限公司 157 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 8.5. AT+CMGD 删除短消息 该命令用于删除短消息首选存储器中位于的短消息。若指定且不为 0，ME 应省略并遵守参数规则。 AT+CMGD 删除短消息 测试命令 AT+CMGD=? 响应 +CMGD: (支持的范围),(支持的范围) 设置命令 AT+CMGD=[,] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。相关存储器支持的位置编号。 整型。 0 删除指定的短消息 1 删除存储器中所有的已读短消息 2 删除存储器所有的已读短消息和已发送移动起始短消息 3 删除存储器所有的已读短消息、已发送和未发送移动起始短消息 4 删除存储器所有短消息 错误码。详情参考第 13.6 章。 举例 AT+CMGD=1 OK AT+CMGD=1,4 OK //删除存储器中=1 的短消息。 //删除存储器中所有短消息。 上海移远通信技术股份有限公司 158 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 8.6. AT+CMGL 按照状态读取短消息 该命令用于列举出中的短消息及其状态。若短消息状态为'REC UNREAD'，则短消息的状态 变更为'REC READ'。若执行不带的 AT+CMGL，模块将上报状态为'REC UNREAD'的短消息列表。 AT+CMGL 按照状态读取短消息 测试命令 响应 AT+CMGL=? +CMGL: (支持的列表) 设置命令 AT+CMGL[=] OK 响应 若缺省可选参数（即执行命令 AT+CMGL），查询所有已接收但未读 的短消息。 若指定可选参数： 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-SUBMIT 和/或 SMS-DELIVER： +CMGL: ,,,[],[][,,][] [...] 对于 SMS-STATUS-REPORT： +CMGL: ,,,,[],[],,, [] [...] 对于 SMS-COMMAND： +CMGL: ,,,[] […] 对于 CBM 存储： +CMGL: ,,,,,[] [...] OK 2）PDU 模式（AT+CMGF=0）且该命令执行成功： +CMGL: ,,[],[< CR>] [...] OK 上海移远通信技术股份有限公司 159 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 响应时间取决于存储的短消息数目，最大响应时间为 300 毫秒 / 参数 1）文本模式，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式，整型。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 整型。相关存储器支持的位置编号。 字 符 串 类 型 。 目 标 地 址 。 详 情 参 考 3GPP TS 23.040 中 的 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 字 符 串 类 型 。 源 地 址 。 详 情 参 考 3GPP TS 23.040 中 的 TP-Originating-Address Address-Value 字段；BCD 码（GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字 符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 字符串类型。字母数字格式的或，对应 MT 电话簿中的记录。该功能的实现按照 出厂设定，所使用的字符集应与 AT+CSCS 选择的字符集相同（详情参考 3GPP TS 27.007 中对该命令的定义）。 字 符 串 类 型 。 短 消 息 服 务 中 心 时 间 戳 。 详 情 参 考 3GPP TS 23.040 TP-Service-Center-Time-Stamp 中的时间字符。（参见） 八 字 节 整 型 。 收 件 人 地 址 类 型 。 详 情 参 考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address。 整 型 。 发 件 人 地 址 类 型 。 详 情 参 考 3GPP TS 24.011 TP-Originating-Address Type-of-Address。（默认参考） 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示消息正文的长度； PDU 模式（AT+CMGF=0）下，以八位字节为单位的实际 TP 数据单元的长度（即 RP 层 的短消息服务中心地址中的八位字符将不计算在该长度内）。 上海移远通信技术股份有限公司 160 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 十六进制数字符串。短消息命令内容。格式参考 3GPP TS 23.040 TP-User-Data。 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制 格式；ME/TA 把 TP 数据单元中每八位字节转换为包含 2 个 IRA 字符的十六进制数字（如： 整数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 整型。取决于命令或结果码。详情参考 3GPP TS 23.040 SMS-DELIVER 的第一个八位字 节，SMS-SUBMIT（默认为 17），SMS-STATUS-REPORT 或者 SMS-COMMAND（默认 为 2）。 整型。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。详情参考 3GPP TS 23.040 TP-Recipient-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 八位字节整型。详情参考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address（默认 参考）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Service-Centre-Time-Stamp（参见）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Discharge-Time。格式为：'yy/MM/dd, hh:mm:ss+zz'，格式中的字符依次代表年（后两位）、月、日、时、分、秒、时区。例如： 1994 年 5 月 6 日 22:10:00, GMT+2 小时用'94/05/06, 22:10:00+08'表示。 整型。详情参考 3GPP TS 23.040 TP-Status。 整型。详情参考 3GPP TS 23.040 TP-Command-Type（默认为 0）。 整型。详情参考 3GPP TS 23.041 CBM 序号。 整型。详情参考 3GPP TS 23.041 CBM 短消息标识符。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 4~7。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 0~3。 错误码。详情参考第 13.6 章。 举例 AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, OK //设置短消息为文本模式。 //列举短消息存储器中的所有短消息。 8.7. AT+CMGR 按照索引读取短消息 该命令用于从存储器中读取指定的短消息。若该短消息处于'REC UNREAD'，则其 状态将会变为'REC READ'。 上海移远通信技术股份有限公司 161 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 AT+CMGR 按照索引读取短消息 测试命令 AT+CMGR=? 设置命令 AT+CMGR= 响应 OK 响应 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-DELIVER： +CMGR: ,,[],[,,,,,,,] OK 对于 SMS-SUBMIT： +CMGR: ,,[][,,,,,[],,,] OK 对于 SMS-STATUS-REPORT： +CMGR: ,,,[],[],,, OK 对于 SMS-COMMAND： +CMGR: ,,[,,[],[],[], ] OK 对于 CBM 存储： +CMGR: ,,,,, OK 2）PDU 模式（AT+CMGF=0）且该命令执行成功： +CMGR: ,[], OK 最大响应时间 若错误与 MT 功能相关： +CMS ERROR: 取决于短消息内容的长度。 上海移远通信技术股份有限公司 162 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 特性说明 / 参考 3GPP TS 27.005 参数 整型。相关存储器支持的位置编号。 1）文本模式，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式，整型。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 字符串类型。号码在电话本中对应的姓名。 字 符 串 类 型 。 目 标 地 址 。 详 情 参 考 3GPP TS 23.040 中 的 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字 符 串 类 型 。 源 地 址 。 详 情 参 考 3GPP TS 23.040 中 的 TP-Originating-Address Address-Value 字段；BCD 码（GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符 集中的字符（详情参考 TS 27.007 中的 AT+CSCS）。地址类型由指定。 字 符 串 类 型 。 短 消 息 服 务 中 心 时 间 戳 。 详 情 参 考 3GPP TS 23.040 TP-Service-Center-Time-Stamp（参见）。 整型。第一个八位字节。取决于命令或结果码。详情参考 3GPP TS 23.040 SMS-DELIVER 的 第 一 个 八 位 字 节 ， SMS-SUBMIT （ 默 认 为 17 ）， SMS-STATUS-REPORT 或 者 SMS-COMMAND。只要输入过一个有效参数值，则该参数后续可省略。 整型。协议标识符。详情参考 3GPP TS 23.040 TP-Protocol-Identifier。默认值：0。 整型。数据编码方案。取决于命令或结果码。详情参考 3GPP TS 23.038 短消息数据编码方 案（默认值为 0）或者小区广播数据编码方案。 整型或时间字符串类型。有效期。取决于 SMS-SUBMIT 的设置。详情参考 3GPP TS 23.040 TP-Validity-Period（参见）。 整型。短消息编号。详情参考 3GPP TS 23.040 TP-Message-Number。 整型。短消息参考。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。详情参考 3GPP TS 23.040 TP-Recipient-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 AT+CSCS）。 地址类型由指定。 整型。详情参考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address（参见）。 整型。收件人地址类型。详情参考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address。 上海移远通信技术股份有限公司 163 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 整型。发件人地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address Type-of-Address （默认参考）。 字符串类型。短消息服务中心地址。详情参考 3GPP TS 24.011 RP SC 地址 Address-Value； BCD 码（或 GSM 7 位默认字母格式）转换为当前选择的 TE 字符集字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。短消息服务中心地址类型。详情参考 3GPP TS 24.011 RP SC 地址 Type-of-Address （默认参考）。 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示消息正文的长度； PDU 模式（AT+CMGF=0）下，以八位字节为单位的实际 TP 数据单元的长度（即 RP 层的 短消息服务中心地址中的八位字节将不计算在该长度内）。 短消息的文本内容。 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制格 式：ME/TA 把 TP 数据单元中每八位字节转换为包含 2 个 IRA 字符的十六进制数字（如：整 数取值为 42 的八位字节作为两个字符（2A，即 IRA 50 和 65）发送给 TE）。 时间字符串类型。详情参考 3GPP TS 23.040 TP-Discharge-Time。格式为：'yy/MM/dd, hh:mm:ss+zz'，格式中的字符依次代表年（后两位）、月、日、时、分、秒、时区。例如： 1994 年 5 月 6 日 22:10:00，GMT+2 小时用'94/05/06, 22:10:00+08'表示。 整型。详情参考 3GPP TS 23.040 TP-Status。 整型。详情参考 3GPP TS 23.040 TP-Command-Type（默认为 0）。 整型。详情参考 3GPP TS 23.041 CBM 序号。 整型。详情参考 3GPP TS 23.041 CBM 短消息标识符。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 4~7。 整型。详情参考 3GPP TS 23.041 CBM 页面参数位 0~3。 详情参考 3GPP TS 23.040 TP-Command-Data 文本模式响应。ME/TA 把 TP 数据单元中每 八位字节转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值为 42 的八位字节作为两 个字符（2A，即 IRA 50 和 65）发送给 TE）。 错误码。详情参考第 13.6 章。 举例 +CMTI: 'SM',3 //已收到新短消息，存储在(U)SIM 卡为 3 的位置。 AT+CSDH=1 OK AT+CMGR=3 //读取短消息。 +CMGR: 'REC UNREAD','+8615021012496',,'13/12/13,15:06:37+32',145,4,0,0,'+8613800210500', 145,27 OK 上海移远通信技术股份有限公司 164 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 8.8. AT+CMGS 发送短消息 该命令用于将短消息（SMS-SUBMIT）从 TE 发送到网络层。调用设置命令后，返回>后输入待发数据， 然后按 Ctrl+Z 表示 PDU 结束并发送短消息。可按 ESC 取消发送，取消成功也会返回 OK 表示终止确认。 发送成功后，将返回短消息参考值到 TE。 AT+CMGS 发送短消息 测试命令 AT+CMGS=? 设置命令 1）文本模式（AT+CMGF=1）： AT+CMGS=[,] >输入文本 Ctrl+Z 发送/ESC 取消发送 2）PDU 模式（AT+CMGF=0）： AT+CMGS= >指定 PDU Ctrl+Z 发送/ESC 取消发送 响应 OK 响应 1）文本模式（AT+CMGF=1）且发送成功： +CMGS: OK 2）PDU 模式（AT+CMGF=0）且发送成功： +CMGS: OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 120 秒，取决于网络状态 / 参数 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由定义。 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Destination-Address Type-of-Address。 消息正文长度。文本模式（AT+CMGF=1）下，表示（或）的字符长度；PDU 模式（AT+CMGF=0）下，表示八位字节格式的实际 TP 数据单元长度（即 RP 层的短消息 服务中心地址中的八位字节将不计算在该长度内）。 整型。消息参考值。详情参考 3GPP TS 23.040 TP-Message-Reference。 错误码。详情参考第 13.6 章。 上海移远通信技术股份有限公司 165 / 277 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' >This is a test from Quectel +CMGS: 247 OK RG50xQ&RM5xxQ 系列 AT 命令手册 //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息内容，Ctrl+Z 发送，ESC 取消发送。 8.9. AT+CMMS 发送多条短消息 该命令用于控制短消息中断协议链路的连续性。若启用该功能（且当前使用的网络支持），链路保持打 开，此情况下可快速发送多条短消息。 AT+CMMS 发送多条短消息 测试命令 AT+CMMS=? 响应 +CMMS: (支持的范围) 查询命令 AT+CMMS? OK 响应 +CMMS: 设置命令 AT+CMMS[=] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 120 秒，取决于网络状态 / 上海移远通信技术股份有限公司 166 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。是否启用短消息中断协议链路功能。 0 禁用此功能 1 保持该功能启用状态，直到要发送的最新命令（AT+CMGS、AT+CMSS 等）的响应与 下 一条要发送的命令之间的时间间隔超过 1~5 秒（具体值取决于 ME）。随后 ME 关闭链路， MT 自动切换为 0。 2 启用该功能。若要发送的最新命令（AT+CMGS、AT+CMSS 等）的响应与下一条要发送 的命令之间的时间间隔超过 1~5 秒（具体值取决于 ME），ME 关闭链路，但 MT 不会自动 切换为 0。 错误码。详情参考第 13.6 章。 备注 执行查询命令后，延迟 5~10 秒后再执行设置命令，否则可能会返回错误码+CMS ERROR: 500。 8.10. AT+CMGW 存储短消息 该命令用于写入一条短消息并存储至，并返回已存储短消息的存储位置。若指定 ，则短消息设置为指定的状态，默认情况下短消息状态设置为'STO UNSENT'。输入数据语法同 AT+CMGS 的设置命令相同。 AT+CMGW 存储短消息 测试命令 AT+CMGW=? 设置命令 1）文本模式（AT+CMGF=1）： AT+CMGW=[,[,]] >输入文本 Ctrl+Z 发送/ESC 取消发送 2）PDU 模式（AT+CMGF=0）： AT+CMGW=[,] >指定 PDU Ctrl+Z 发送/ESC 取消发送 最大响应时间 响应 OK 响应 +CMGW: OK 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 特性说明 / 参考 GSM 07.05 上海移远通信技术股份有限公司 167 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 字 符 串 类 型 。 短 消 息 源 地 址 。 详 情 参 考 3GPP TS 23.040 TP-Originating-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符（详情参考 3GPP TS 27.007 中的 AT+CSCS）。地址类型由指定。 整型。源地址类型。详情参考 3GPP TS 24.011 TP-Originating-Address Type-of-Address （默认参考）。 1）文本模式，字符串类型。 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 'ALL' 已存储且已发送的短消息 所有短消息 2）PDU 模式，整型。 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 3 已存储且已发送的短消息 4 所有短消息 整型。目标地址类型。详情参考 3GPP TS 24.011 TP-Recipient-Address Type-of-Address 字段。 整型。短消息长度。 文本模式（AT+CMGF=1）下，表示（或）消息正文的字符长度； PDU 模式（AT+CMGF=0）下，表示八位实际 TP 数据单元的长度（即 RP 层的 SMSC 地 址中的八位字符将不计算在该长度内） 短消息情况下：3GPP TS 24.011 服务中心地址，遵循 3GPP TS 23.040 TPDU，十六进制 格式；ME/TA 将 TP 数据单元中每八位字符转换为包含 2 个 IRA 字符的十六进制数字（如： 整数取值为 42 的八位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） 整型。存储器的短消息序列。 字符串类型。待写入和发送短消息的存储器。 'SM' 'ME' (U)SIM 卡短消息存储器 移动设备短消息存储器 'MT' 'SR' 移动设备，同'ME' 短消息状态报告存储位置 错误码。详情参考第 13.6 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 上海移远通信技术股份有限公司 168 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK AT+CMGW='15021012496' >This is a test from Quectel +CMGW: 4 //输入短消息文本内容，按 Ctrl+Z 写入短消息，按 ESC 取消发送 OK AT+CMGF=0 //设置短消息模式为 PDU 模式。 OK AT+CMGW=18 >0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK 8.11. AT+CMSS 从存储器发送短消息 该命令用于从存储器中发送指定的短消息（SMS-SUBMIT）。若指定 SMS-SUBMIT 短消息目的地址，则在短消息发送时使用新地址替换存储器中短消息包含的目的地址。发送成功后， 参考值将返回给 TE。非请求发送状态报告结果码的参数值可进行短消息识别。 AT+CMSS 从存储器发送短消息 测试命令 AT+CMSS=? 设置命令 AT+CMSS=[,[,]] 响应 OK 响应 1）文本模式（AT+CMGF=1）且执行成功： +CMSS: [,] OK 2）PDU 模式（AT+CMGF=0）且执行成功： +CMSS: [,] OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 120 秒，取决于网络状态 / 上海移远通信技术股份有限公司 169 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。相关存储器支持的位置编号。 字符串类型。目标地址。详情参考 3GPP TS 23.040 TP-Destination-Address Address-Value 字段；BCD 码（或 GSM 7 位默认字母格式的字符）转换为当前选择的 TE 字符集中的字符 （详情参考 3GPP TS 27.007 中的 AT+CSCS）；地址类型由指定。 整 型 。 目 标 地 址 类 型 。 详 情 参 考 3GPP TS 24.011 TP-Destination-Address Type-of-Address。 整型。短消息参考。详情参考 3GPP TS 23.040 TP-Message-Reference。 字符串类型。服务中心时间戳。详情参考 3GPP TS 23.040 TP-Service-Centre-TimeStamp。（参考） 字符串类型。格式与短消息情况下的的格式相同，但无 3GPP TS 24.011 SC 中的地 址字段。 字符串类型。待写入和发送短消息的存储器。 'SM' (U)SIM 卡 'ME' 移动设备 'MT' 移动设备，同'ME' 'SR' 短消息状态报告存储位置 错误码。详情参考第 13.6 章。 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK AT+CMSS=4 +CMSS: 54 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //输入短消息内容，Ctrl+Z 发送短消息，ESC 取消发送。 //从存储器中发送为 4 的短消息。 上海移远通信技术股份有限公司 170 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 8.12. AT+CNMA 新短消息确认 该命令用于确认直接发送至 TE 的新消息（SMS-DELIVER 或 SMS-STATUS-REPORT）已经成功发送。 若 UE 未在需求时间（网络超时）内收到确认，会发送 RP-ERROR 至网络。UE 可通过设置 AT+CNMI 的 和为 0 自动禁止发送至 TE。 AT+CNMA 新短消息确认 测试命令 AT+CNMA=? 响应 若为文本模式（AT+CMGF=1）： OK 若为 PDU 模式（AT+CMGF=0）： +CNMA: (支持的范围) 执行命令 若为文本模式（AT+CMGF=1） AT+CNMA OK 响应 OK 或者 ERROR 设置命令 若为 PDU 模式（AT+CMGF=0） AT+CNMA=[,[ 指定 PDU Ctrl+Z 发送/ESC 取消发送]] 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 响应 OK 或者 ERROR 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。PDU 模式所需参数。 0 命令操作类似文本模式 1 发送肯定应答（RP-ACK）至网络，仅 PDU 模式下接受 2 发送否定应答（RP-ERROR）至网络，仅 PDU 模式下接受 整型。短消息长度。 文本模式下（AT+CMGF=1），表示短消息正文（或）的长度； 上海移远通信技术股份有限公司 171 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 PDU 模式下（AT+CMGF=0），表示以八位字节为单位的实际 TP 数据单元的长度（即 RP 层 SMSC 地址字节不计入长度）。 错误码。详情参考第 13.6 章。 备注 仅当 AT+CSMS 中为 1（phase 2+）且 MT 下发了如下对应 URC 时方可使用该执行命令和设 置命令： +CMT: =2，新消息类别为 0、1、3 和无 +CMT: =3，新消息类别为 0 和 3 +CDS: =1 举例 AT+CSMS=1 OK AT+CNMI=1,2,0,0,0 OK AT+CMGF=1 OK AT+CSDH=1 OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. AT+CNMA //收到新短消息，直接输出短消息内容。 //向网络发送确认消息。 OK AT+CNMA +CMS ERROR: 340 //第二次返回错误，仅需确认一次。 8.13. AT+CNMI 设置新短消息上报方式 该命令用于配置模块收到新短消息时的上报方式。 AT+CNMI 设置新短消息上报方式 测试命令 AT+CNMI=? 响应 +CNMI: (支持的范围),(支持的范围),(支持的 列表),(支持的范围),(支持的列表) 查询命令 AT+CNMI? OK 响应 +CNMI: ,,,, 上海移远通信技术股份有限公司 172 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 设置命令 AT+CNMI=[,[,[,[,]]]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 该命令立即生效； 参数配置不自动保存。 参数 整型。 0 缓存 MT 中的非请求结果码。若 MT 结果码缓存已满，结果码指示可以缓冲存储在其 他存储空间或者丢弃最早的非请求结果码指示，替换为新接收到的指示。 1 当 MT-TE 间的链路被占用（比如：在线数据模式），丢弃指示并拒绝新接收的短消息非 请求结果码。否则，直接转发给 TE。 2 当 MT-TE 间的链路被占用（比如：在线数据模式），缓存 MT 中的非请求结果码；当链 路释放后，把所有结果码发送给 TE。否则，直接转发给 TE。 整型。新短消息上报方式。 0 不将新短消息发送给 TE。 1 新短消息通过 URC +CMTI: ,方式发送给 TE。 2 新短消息通过 URC +CMT: [],（PDU 模式）或者+ CMT: ,[],[,,,,,,,] （文本模式）方式发送给 TE。 3 在收到 CLASS3 短消息时，新短消息通过 URC +CMT: [], （PDU 模式）或者+CMT: ,[],[,,,,, ,,]（文本模式）方式发送给 TE。非 CLASS 3 短消息，新短消息通过 URC +CMTI: ,方式发送给 TE。 整型。存储接收的 CBM 规则取决于其数据编码方案（详情参考 3GPP TS 23.038）和选择 小区广播消息类型命令 AT+CSCB 的设置。 0 无 CBM 指示发送到 TE 2 收到的 CBM 使用如下 URC 直接发送到 TE： +CBM: （PDU 模式） 或者 +CBM: ,,,,（文本模式） 整型。短消息状态报告的上报方式。 0 不将状态报告发给 TE 上海移远通信技术股份有限公司 173 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 1 状态报告通过如下 URC 上报 TE： +CDS: （PDU 模式） 或者 +CDS: ,,[],[],,,（文本模式） 2 状态报告通过+CDSI: ,方式发给 TE 整型。 0 当为 1 或 2 时，将 TA 非请求结果码缓冲区刷新到 TE（返回 OK 后刷新）。 1 当为 1 或 2 时，清空非请求结果码的缓冲区。 错误码。详情参考第 13.6 章。 备注 URC 说明： +CMTI: , +CMT: [], +CBM: 表示接收到新消息 表示直接输出短消息 表示直接输出小区广播消息 举例 AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CNMI=1,2,0,1,0 OK //设置短消息模式为文本模式。 //设置 TE 输入字符集格式为 GSM 格式。 //设置 SMS-DELIVER 消息直接发送至 TE。 +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel //收到新短消息，直接输出短消息内容。 8.14. AT+CSCB 选择小区广播消息类型 该命令用于选择 ME 接收到的 CBM 类型。 AT+CSCB 选择小区广播消息类型 测试命令 AT+CSCB=? 响应 +CSCB: (支持的列表) 查询命令 AT+CSCB? OK 响应 +CSCB: ,, 上海移远通信技术股份有限公司 174 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK 设置命令 响应 AT+CSCB=[,mids>[,]] OK 最大响应时间 特性说明 参考 3GPP TS 27.005 若错误与 MT 功能相关： +CMS ERROR: 300 毫秒 / 参数 整型。表示是否接收由和指定的消息类型。 0 接收 1 不接收 字符串类型。所有可能的 CBM 消息标识的组合（参见）。如'0,1,5,320-478,922'。 默认值为空字符串。 字符串类型。所有可能的数据编码方案的组合。如'0-3,5'（参见）。默认值为 空字符串。 错误码。详情参考第 13.6 章。 8.15. AT+CSDH 设置文本模式下参数显示 该命令用于控制是否在文本模式下的结果码中显示详细的报头信息。 AT+CSDH 设置文本模式下参数显示 测试命令 AT+CSDH=? 响应 +CSDH: (支持的列表) 查询命令 AT+CSDH? OK 响应 +CSDH: 设置命令 AT+CSDH=[] OK 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 175 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.005 300 毫秒 / 参数 整型。 0 在结果码中不显示头信息： 对于文本模式下的 SMS-DELIVER 和 SMS-SUBMIT 类型短消息，+CSCA 和+CSMP 的结果码不包含、、、、和；+CMT、+CMGL 和+CMGR 的结果码中不包含、或。 1 在结果码中显示头信息 举例 AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT','', OK AT+CSDH=1 OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 OK 8.16. AT+CSMP 设置短消息文本模式参数 在文本模式下（AT+CMGF=1），当向网络侧发送短消息或将短消息存放在存储器中时，该命令用于设 置需要附加的参数取值。除此之外，还可以用于设置从 SMSC 接收到该短消息时算起的有效期（的取 值范围：0~255）或定义有效期终止的绝对时间（为字符串时）。 AT+CSMP 设置短消息文本模式参数 测试命令 响应 AT+CSMP=? 查询命令 OK 响应 AT+CSMP? +CSMP: ,,, 上海移远通信技术股份有限公司 176 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 设置命令 AT+CSMP=[,[,[,] ]]] 最大响应时间 OK 响应 OK 300 毫秒 特性说明 / 参考 3GPP TS 27.005 参数 整型。TPDU 的第一个字节。对于不同的消息类型的详情参考 3GPP TS 23.040。 整型或者字符串类型。有效期。取决于 SMS-SUBMIT 的的设置，详细参考 3GPP TS 23.040 TP-Validity-Period（参考）。默认值：167。 整型。协议标识符。详情参考 3GPP TS 23.040 TP-Protocol-Identifier。默认值：0。 整型。数据编码方案。取决于该命令或结果码：3GPP TS 23.038 SMS 数据编码方案（默认 值：0），或者小区广播数据编码方案。 上海移远通信技术股份有限公司 177 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 9 分组域命令 9.1. AT+CGATT PS 域附着或去附着 设置命令用于将 MT 附着于 PS 域，或者将 MT 从 PS 域分离。命令完成后，MT 保持在 V.250 命令状 态。如果 MT 已经处于请求状态，则将忽略该命令，并且仍响应 OK。如果 MT 无法实现请求状态，将响应 ERROR 或+CME ERROR。 AT+CGATT PS 域附着或去附着 测试命令 AT+CGATT=? 响应 +CGATT: (支持的列表) 查询命令 AT+CGATT? OK 响应 +CGATT: 设置命令 AT+CGATT= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 140 秒，取决于网络状态 / 参数 整型。PS 服务状态。 0 分离状态 1 附着状态 设其他值为保留值，设置后将返回 ERROR。 上海移远通信技术股份有限公司 178 / 277 错误码。详情参考第 13.5 章。 RG50xQ&RM5xxQ 系列 AT 命令手册 举例 AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //附着于 PS 域。 //从 PS 域分离。 //查询当前 PS 域状态。 9.2. AT+CGQREQ 服务质量参数（请求的） 在 TE 激活 PDP 上下文时，该命令允许 TE 指定服务质量参数。 该设置命令指定上下文的参数。设置命令的一种特殊形式 AT+CGQREQ=会使上下文标识 符请求的参数处于未定义状态。查询命令返回每一个已定义的上下文的当前配置。详细信息详情参考 3GPP TS 23.107。 AT+CGQREQ 服务质量参数（请求的） 测试命令 AT+CGQREQ=? 响应 +CGQREQ: ,(支持的范围),(支持的 范围),(支持的范围),(支持的范围), (支持的列表) 查询命令 AT+CGQREQ? OK 响应 [+CGQREQ: ,,,>reliability>,,] […] 设置命令 AT+CGQREQ=[,[,[,[,[ ,]]]]] OK 响应 OK 若错误与 MT 功能相关： +CME ERROR: 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 179 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 特性说明 参考 3GPP TS 27.007 该命令立即生效； 自动保存参数配置。 参数 整型。特定 PDP 上下文的定义（详情参考 AT+CGDCONT）。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 'IPV6' 互联网协议版本 6 'IPV4V6' 互联网协议版本 4 与版本 6 整型。优先等级。 0 网络订阅值 1 优先级高。服务优先级在 2 级和 3 级优先级之前。 2 优先级中。服务优先级在 3 级优先级之前。 3 优先级低。继续保持服务。 整型。延迟类别。该参数定义通过网络传输 SDU 时发生的端到端传输延迟。详情参考 表 5。 0 网络订阅值 1~4 详情参考表 5。 整型。依赖等级。 0 网络订阅值 1 无法解决数据丢失的非实时流量和对错误敏感的应用程序 2 能够解决少数数据丢失的非实时流量和对错误敏感的应用程序 3 能够解决数据丢失、GMM/SM 和 SMS 的非实时流量和对错误敏感的应用程 序 4 能够解决数据丢失的实时流量和对错误敏感的应用程序 5 能够解决数据丢失的实时流量和对错误无感的应用程序 整型。峰值吞吐量等级，以每秒八位字节为单位。 0 网络订阅值 1 高达 1 000（8 kbit/秒） 2 高达 2 000（16 kbit/秒） 3 高达 4 000（32 kbit/秒） 4 高达 8 000（64 kbit/秒） 5 高达 16 000（128 kbit/秒） 6 高达 32 000（256 kbit/秒） 7 高达 64 000（512 kbit/秒） 8 高达 128 000（1024 kbit/秒） 9 高达 256 000（2048 kbit/秒） 整型。平均吞吐量等级。以每小时八位字节为单位。 0 网络订阅值 上海移远通信技术股份有限公司 180 / 277 1 100（约 0.22 bit/秒） 2 200（约 0.44 bit/秒） 3 500（约 1.11 bit/秒） 4 1 000（约 2.2 bit/秒） 5 2 000（约 4.4 bit/秒） 6 5 000（约 11.1 bit/秒） 7 10 000（约 22 bit/秒） 8 20 000（约 44 bit/秒） 9 50 000（约 111 bit/秒） 10 100 000（约 0.22 kbit/秒） 11 200 000（约 0.44 kbit/秒） 12 500 000（约 1.11 kbit/秒） 13 1000 000（约 2.2 kbit/秒） 14 2 000 000（约 4.4 kbit/秒） 15 5 000 000（约 11.1 kbit/秒） 16 10 000 000（约 22 kbit/秒） 1 20 000 000（约 44 kbit/秒） 18 50 000 000（约 111 kbit/秒） 31 Best effort 错误码。详情参考第 13.5 章。 RG50xQ&RM5xxQ 系列 AT 命令手册 表 5：延迟类别 SDU 大小 128 个八位字节 1024 个八位字节 延迟类别 1（预测） 2（预测） 3（预测） 4（Best effort） 1（预测） 2（预测） 3（预测） 4（Best effort） 平均传输延迟 < 0.5 < 5 < 50 未指定 < 0.5 < 5 < 50 未指定 95% < 1.5 < 25 < 250 / < 1.5 < 25 < 250 / 上海移远通信技术股份有限公司 181 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 9.3. AT+CGQMIN 服务质量参数（最低可接受的） 该命令允许 TE 指定简化版的参数，当激活 PDP 上下文时，由 MT 根据协商的参数检查简化版的配置 文件。设置命令指定上下文标识符标识的上下文的参数。 设置命令的一种特殊形式 AT+CGQMIN=会使上下文标识符的简化版配置文件处于未定义 状态，此时将不会对协商的配置文件进行检查。查询命令返回每个已定义 PDP 上下文的当前配置。详情参 考 3GPP TS 23.107。 AT+ CGEQMIN 测试命令 AT+CGQMIN=? 服务质量参数（最低可接受的） 响应 +CGQMIN: ,(支持的范围),(支持 的列表),(支持的范围),(支持的范 围),(支持的范围) […] 查询命令 AT+CGQMIN? OK 响应 [+CGQMIN: ,,,,,] […] 设置命令 AT+CGQMIN=[,[,< delay>[,[,[, ]]]]] OK 响应 OK 若出现 MT 相关错误： +CME ERROR: 最大响应时间 300 毫秒 特性说明 参考 3GPP TS 27.007 该命令立即生效； 自动保存参数配置。 参数 整型。特定 PDP 上下文的定义。（详情参考 AT+CGDCONT） 字符串类型。指定分组数据协议类型。 'IP' 互联网协议版本 4（IETF STD 5） 'PPP' 'IPV6' 互联网协议版本 6 'IPV4V6' 互联网协议版本 4 与版本 6 上海移远通信技术股份有限公司 182 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 整型。优先等级。 0 网络订阅值 1 优先级高。服务优先级在 2 级和 3 级优先级之前 2 优先级中。服务优先级在 3 级优先级之前 3 优先级低。继续保持服务 整型。延迟类别。该参数定义通过网络传输 SDU 时发生的端到端传输延迟。详情参考 3GPP TS 23.107。 0 网络订阅值 整型。依赖等级。 0 网络订阅值 1 无法解决数据丢失的非实时流量和对错误敏感的应用程序 2 能够解决少数数据丢失的非实时流量和对错误敏感的应用程序 3 能够解决数据丢失、GMM/SM 和 SMS 的非实时流量和对错误敏感的应用程 序 4 能够解决数据丢失的实时流量和对错误敏感的应用程序 5 能够解决数据丢失的实时流量和对错误无感的应用程序 整型。峰值吞吐量等级，以每秒八位字节为单位。 0 网络订阅值 1 高达 1 000（8 kbit/秒） 2 高达 2 000（16 kbit/秒） 3 高达 4 000（32 kbit/秒） 4 高达 8 000（64 kbit/秒） 5 高达 16 000（128 kbit/秒） 6 高达 32 000（256 kbit/秒） 7 高达 64 000（512 kbit/秒） 8 高达 128 000（1024 kbit/秒） 9 高达 256 000（2048 kbit/秒） 整型。平均吞吐量等级。以每小时八位字节为单位。 0 网络订阅值 1 100（约 0.22 bit/秒） 2 200（约 0.44 bit/秒） 3 500（约 1.11 bit/秒） 4 1 000（约 2.2 bit/秒） 5 2 000（约 4.4 bit/秒） 6 5 000（约 11.1 bit/秒） 7 10 000（约 22 bit/秒） 8 20 000（约 44 bit/秒） 9 50 000（约 111 bit/秒） 10 100 000（约 0.22 kbit/秒） 11 200 000（约 0.44 kbit/秒） 12 500 000（约 1.11 kbit/秒） 13 1000 000（约 2.2 kbit/秒） 14 2 000 000（约 4.4 kbit/秒） 15 5 000 000（约 11.1 kbit/秒） 上海移远通信技术股份有限公司 183 / 277 16 10 000 000（约 22 kbit/秒） 1 20 000 000（约 44 kbit/秒） 18 50 000 000（约 111 kbit/秒） 31 Best effort 错误码。详情参考第 13.5 章。 RG50xQ&RM5xxQ 系列 AT 命令手册 9.4. AT+CGACT PDP 上下文激活/去激活 该命令用于激活或去激活指定的 PDP 上下文。命令设置完成后，MT 保持 V.250 命令状态。若任意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；在执行激活命令时，如果 MT 没有附着 PS，则 MT 会先进行 PS 附着，然后尝试激活指定的上下文。如果无指定激活或去激活命令时，将会激活或 去激活所有定义的上下文。 AT+CGACT PDP 上下文激活/去激活 测试命令 AT+CGACT=? 响应 +CGACT: (支持的列表) 查询命令 AT+CGACT? OK 响应 +CGACT: , […] 设置命令 AT+CGACT=, OK 响应： OK 或者 NO CARRIER 最大响应时间 特性说明 参考 3GPP TS 27.007 若出现任何 MT 错误： +CME ERROR: 150 秒，取决于网络状态 / 上海移远通信技术股份有限公司 184 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。PDP 上下文激活状态。 0 去激活 1 激活 设置命令中保留其它值，但是设置后将返回 ERROR。 整型。指定 PDP 上下文的定义。（详情参考 AT+CGDCONT）。 错误码。详情参考第 13.5 章。 举例 AT+CGDCONT=4,'IP','UNINET' OK AT+CGACT=1,4 OK AT+CGACT? +CGACT: 1,1 +CGACT: 2,0 +CGACT: 3,0 +CGACT: 4,1 OK AT+CGACT=0,4 OK //定义 PDP 上下文。 //激活 PDP。 //查询当前 PDP 上下文状态。 //去激活 PDP。 9.5. AT+CGDATA 进入数传状态 设置命令设置后，MT 将使用一种或多种分组域 PDP 类型进行操作，使 TE 与网络之间建立通信，可 能也会包括进行 PS 附着及一个或多个 PDP 上下文激活操作。MT 不会处理 AT 命令行中 AT+CGDATA 之 后的命令。 若 MT 无法接收的值，将返回 ERROR 或+CME ERROR。若可以接收，MT 将返回中间结果代 码 CONNECT 并输入 V.250 在线数传状态。数据传输完成且第二层协议终止流程已成功完成后，将重新进 入命令状态，MT 将返回最终结果代码 OK。 AT+CGDATA 进入数传状态 测试命令 AT+CGDATA=? 响应 +CGDATA: (支持的列表) 执行命令 AT+CGDATA=, OK 响应 CONNECT 上海移远通信技术股份有限公司 185 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 或者 ERROR 若出现任何 MT 错误： +CME ERROR: 300 毫秒 / 参数 字符串类型。TE 和 MT 间使用的第二层协议。 'NULL' 无第二层协议。 不支持其他值，若配置为其他值，将返回 ERROR。 整型。特定 PDP 上下文的定义。（详情参考 AT+CGDCONT）。 错误码。详情参考第 13.5 章。 9.6. AT+CGPADDR 显示 PDP 地址 该命令返回指定上下文标识符的 PDP 地址列表。若未指定，则返回所有已定义上下文的地址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (支持的已定义的列表) 设置命令 AT+CGPADDR=[,[,...]] OK 响应 +CGPADDR: , […] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 或者 ERROR 300 毫秒 / 上海移远通信技术股份有限公司 186 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。特定 PDP 上下文的定义（详情参考 AT+CGDCONT）。 字符串类型。PDP 地址，用于在适用于 PDP 的地址空间中识别 TE。地址可以为静态或 动态。静态地址在定义上下文时由 AT+CGDCONT 设置。动态地址在上一次 PDP 上下 文激活（使用了指定的上下文定义）期间分配。若无可用的地址，将省略该参数。 举例 AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' OK //定义 PDP 上下文。 //激活 PDP。 //显示 PDP 地址。 9.7. AT+CGEREP 分组域事件上报 在某些事件发生在分组域 MT 或网络中的情况下，该命令启用/禁用从 MT 发送非请求结果码+CGEV 至 TE。控制该命令指定的非请求结果码的处理。当指定为 1 或 2 时，控制缓存的主动 上报行为策略。 AT+CGEREP 分组域事件上报 测试命令 AT+CGEREP=? 响应 +CGEREP: (支持的范围),(支持的列表) 查询命令 AT+CGEREP? OK 响应 +CGEREP: , 设置命令 AT+CGEREP[=[,]] 最大响应时间 特性说明 OK 或者 ERROR 响应 OK 或者 ERROR 300 毫秒 / 上海移远通信技术股份有限公司 187 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参考 3GPP TS 27.007 参数 整型。 0 缓存 MT 中的非请求结果码；若 MT 结果码缓存已满，最早的非请求结果码将被丢弃。 结果码将不会转发至 TE。 1 当 MT-TE 间的链路被占用（比如：在线数据模式下），丢弃非请求结果码。否则，直 接转发给 TE。 2 当 MT-TE 间的链路被占用（比如：在线数据模式下），缓存 MT 中的非请求结果码； 当链路释放后，把结果码发送给 TE。否则，直接转发给 TE。 整型。 0 当为 1 或 2 时，清除了此命令定义的非请求结果码的 MT 缓存 1 当为 1 或 2 时，在此命令中定义的非请求结果码的 MT 缓存被发送至 TE（返 回 OK 后发送） 备注 非请求结果码及其对应的事件定义如下： 1. +CGEV: REJECT ,：当MT无法通过+CRING非请求结果码将PDP上下文 激活事件上报TE且MT被自动拒绝时将向网络请求激活PDP上下文。 备注：该事件不适用于EPS和5GS。 2. +CGEV: NW REACT ,,[]：网络已经请求上下文重新激活。若MT 已知悉，则会提供用于重新激活上下文的。 备注：该事件不适用于EPS。 3. +CGEV: NW DEACT ,,[]：网络强制去激活上下文。若MT知悉 ，则会提供用于激活上下文的。 4. +CGEV: ME DEACT ,,[]：ME已强制去激活了上下文。若MT已知 悉，则会提供用于激活上下文的。 5. +CGEV: NW DETACH：网络已强制去附着分组域，表示已经去激活所有的已激活的上下文。去激 活的上下文不会分开上报。 6. +CGEV: ME DETACH：ME已强制去附着分组域，表示已经去激活所有的已激活的上下文。去激活 的上下文不会分开上报。 7. +CGEV: NW CLASS ： 网 络 已 强 制 更 换 MS 等 级 ， 且 上 报 最 高 可 用 级 别 （ 详 情 参 考 AT+CGCLASS）。 8. +CGEV: ME CLASS ： ME 已 强 制 更 换 MS 等 级 ， 且 上 报 最 高 可 用 级 别 （ 详 情 参 考 AT+CGCLASS）。 9. +CGEV: PDN ACT：已激活上下文。该上下文表示LTE的PDN连接或GSM/UMTS的第一个 PDP上下文。 10. +CGEV: PDN DEACT：去激活上下文。该上下文表示LTE的PDN连接或GSM/UMTS的第一个 PDP上下文。 上海移远通信技术股份有限公司 188 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 字符串类型。指定分组数据协议类型。 'IP' IPv4 'PPP' PPP 'IPV6' IPv6 'IPV4V6' IPv4v6 字符串类型。用于标识适用于 PDP 的地址空间中的 MT。若该值为空或被省略，则 TE 可能会在 PDP 过程中提供该值。 整型。PDP上下文标识符。该参数为TE-MT接口的本地参数且用于其它PDP上下文 相关的命令中。AT+CGDCONT=?将返回的范围（最小值：1）。 字符串类型。表示GPRS移动等级。 A 等级A（最高） B 等级B C GPRS和电路交换备用模式的等级C CG 仅GPRS模式的等级C CC 仅电路交换备用模式的等级C（最低） 举例 AT+CGEREP=? +CGEREP: (0-2),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK AT+CGEREP=2,1 OK AT+CGACT=1,2 OK +CGEV: PDN ACT2 AT+CGACT=0,2 OK +CGEV: PDN DEACT2 //测试命令。 //查询当前配置。 //上报分组域事件。 //激活一个上下文。 //去激活一个上下文。 上海移远通信技术股份有限公司 189 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 9.8. AT+CGSMS 选择 MO 短消息服务 该命令用于指定 MT 用于发送 MO（移动终端发起）短消息的服务或优选服务。 AT+CGSMS 选择 MO 短消息服务 测试命令 AT+CGSMS=? 响应 +CGSMS: (当前支持的可用列表) 查询命令 AT+CGSMS? OK 响应 +CGSMS: 设置命令 AT+CGSMS= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 相关： +CME ERROR: 300 毫秒 / 参数 整型。使用的服务或优选服务。 0 分组域 1 电路域 2 优选分组域（GPRS 不可用时使用电路域） 3 优选电路开关（电路域不可用时使用分组域） 错误码。详情参考第 13.5 章。 9.9. AT+QGDCNT 流量统计 该命令用于查询 MT 发送或接收的数据流量。 AT+QGDCNT 流量统计 测试命令 AT+QGDCNT=? 响应 +QGDCNT: (支持的列表) 上海移远通信技术股份有限公司 190 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 查询命令 AT+QGDCNT? 设置命令 AT+QGDCNT= 最大响应时间 特性说明 参考 OK 响应 +QGDCNT: , OK 响应 OK 300 毫秒 / 参数 整型。流量统计操作。 0 重置 1 将流量统计结果保存至 NVM 整型。发送的流量大小。 整型。接收的流量大小。 错误码。详情参考第 13.5 章。 备注 1. MT 开机时，和会从 NVM 中的流量统计结果中加载出来。在 NVM 中 默认的流量结果为 0。 2. AT+QGDCNT=1 可写入数据流量至 NVM，不宜频繁执行，否则会极大缩短模块 Flash 寿命。如需 写入 NVM，建议时间间隔大于 60 秒。 举例 AT+QGDCNT=? +QGDCNT: (0,1) //测试命令。 OK AT+QGDCNT? //查询当前发送和接收的数据。 +QGDCNT: 3832,4618 OK AT+QGDCNT=1 OK //将结果保存至 NVM。 上海移远通信技术股份有限公司 191 / 277 AT+QGDCNT=0 OK //重置流量统计。 RG50xQ&RM5xxQ 系列 AT 命令手册 9.10. AT+QGDNRCNT 5G NR 流量统计 该命令用于查询 MT 发送或接收的 5G NR 下的数据流量。 AT+QGDNRCNT 5G NR 流量统计 测试命令 AT+QGDNRCNT=? 响应 +QGDNRCNT: (支持的列表) 查询命令 AT+QGDNRCNT? OK 响应 +QGDNRCNT: , 设置命令 AT+QGDNRCNT= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 相关： +CME ERROR: 300 毫秒 / 参数 整型。流量统计操作。 0 重置 1 将流量统计结果保存至 NVM 整型。发送的流量大小。 整型。接收的流量大小。 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 192 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 备注 1. MT 开机时，和会从 NVM 中的流量统计结果中加载出来。在 NVM 中 默认的流量结果为 0。 2. AT+QGDNRCNT=1 可写入数据流量至 NVM，不宜频繁执行，否则会极大缩短模块 Flash 寿命。如 需写入 NVM，建议时间间隔大于 60 秒。 举例 AT+QGDNRCNT=? +QGDCNT: (0,1) //测试命令。 OK AT+QGDNRCNT? +QGDCNT: 3832,4618 //查询当前发送和接收的数据。 OK AT+QGDNRCNT=1 OK AT+QGDNRCNT=0 OK //将结果保存至 NVM。 //重置流量统计。 9.11. AT+QAUGDCNT 自动保存流量统计 该命令用于使 AT+QGDCNT/AT+QGDNRCNT 查询出来的流量统计结果自动保存至 NVM。 AT+QAUGDCNT 自动保存流量统计 测试命令 AT+QAUGDCNT=? 响应 +QAUGDCNT: (支持的列表) 查询命令 AT+QAUGDCNT? OK 响应 +QAUGDCNT: 设置命令 AT+QAUGDCNT= OK 响应 OK 或者 ERROR 若错误与 MT 相关： +CME ERROR: 上海移远通信技术股份有限公司 193 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 参考 3GPP TS 27.007 300 毫秒 / 参数 整型。该参数为 AT+QGDCNT/AT+QGDNRCNT 自动将结果保存到 NVM 的时间间隔。 如果设置为 0，则禁用自动保存功能。范围：0、30~65535；默认值：0；单位：秒。 错误码。详情参考第 13.5 章。 举例 AT+QAUGDCNT=? //测试命令。 +QAUGDCNT: (0,30-65535) OK AT+QAUGDCNT=35 OK AT+QAUGDCNT? +QAUGDCNT: 35 //将设置为 35。 //查询自动保存的时间间隔。 OK 备注 使能该命令后，模块会按设置的时间间隔写 Flash，会一定程度缩短 Flash 寿命。 9.12. AT+QNETDEVSTATUS 查询 RmNet 设备状态 AT+QNETDEVSTATUS 查询 RmNet 设备状态 测试命令 AT+QNETDEVSTATUS=? 响应 +QNETDEVSTATUS: (支持的列表) OK 或者 ERROR 上海移远通信技术股份有限公司 194 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 查询命令 AT+QNETDEVSTATUS? 设置命令 AT+QNETDEVSTATUS= 最大响应时间 特性说明 响应 若 存 在 RmNet 通 话 ， 会 返 回 、 和 ： +QNETDEVSTATUS: [,,,] [...] OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用/禁用 URC 上报 RmNet 设备状态。 0 禁用 1 启用 整型。RmNet 通话状态。 0 RmNet 通话已断开连接 1 RmNet 通话已连接 整型。IP 类型。 4 IPv4 6 IPv6 整型。配置文件号。范围：1~42。 举例 AT+QNETDEVSTATUS=? +QNETDEVSTATUS:(0,1) OK AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1 OK AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1,1,4,1 +QNETDEVSTATUS: 1,1,6,1 上海移远通信技术股份有限公司 195 / 277 OK +QNETDEVSTATUS: 1,0,4,1 +QNETDEVSTATUS: 1,0,6,1 RG50xQ&RM5xxQ 系列 AT 命令手册 上海移远通信技术股份有限公司 196 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 10 补充业务命令 10.1. AT+CCFC 呼叫转移 该命令用于控制呼叫转移补充服务，包括注册、删除、激活、去激活和状态查询。详情参考 3GPP TS 22.082。 AT+CCFC 呼叫转移 测试命令 AT+CCFC=? 响应 +CCFC: (支持的范围) 设置命令 AT+CCFC=,[,[,[,[,[,[,]]]]]] OK 响应 若不为2且命令执行成功： OK 若为2且命令执行成功（仅与=(0~3)有关）： 若注册了呼叫转移号码： +CCFC: ,[,,[,,[,]]] [...] OK 若未注册呼叫转移号码（即所有类别均未激活）： +CCFC: , OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与MT功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 197 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。 0 无条件转移 1 遇忙转移 2 无应答转移 3 不可达转移 4 所有呼叫转移（详情参考3GPP TS 22.030） 5 所有条件呼叫转移（详情参考3GPP TS 22.030） 整型。 0 禁用 1 启用 2 查询状态 3 注册 4 删除 整型。呼叫转移地址的电话号码，格式由指定。 整型。地址类型。当拨号字符串中包含国际接入代码字符'+'时，默认值：145；否则默认 值：129。 字符串类型。子地址，格式由指定。 整型。子地址类型。 整型。每个值代表一类信息。 1 语音（电话） 2 数据（指所有承载服务；如果TA在=2的情况下不支持值16、32、64和128， 则仅指某些承载服务） 4 传真（传真服务） 7 语音、数据和传真 8 短消息服务 16 数据电路同步 32 数据电路异步 64 专用数据包访问 128 专用 PAD 访问 整型。当启用或查询'无应答转移'，'所有呼叫转移'或'所有条件呼叫转移'时，此参数 表示在呼叫转移前等待的时长。范围：0~30；默认值：20；单位：秒。 整型。 0 未激活 1 激活 错误码。详情参考第 13.5 章。 举例 AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, //注册用于无条件呼叫转移（CFU）的目的地号码。 //未指定的情况下，查询 CFU 状态。 上海移远通信技术股份有限公司 198 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,255 OK //删除注册的 CFU 目的地号码。 //查询状态，显示没有目的地号码。 10.2. AT+CCWA 呼叫等待控制 该命令根据 3GPP TS 22.083 控制呼叫等待服务，包括激活、去激活和状态查询。 AT+CCWA 呼叫等待控制 测试命令 AT+CCWA=? 响应 +CCWA: (支持的列表) 查询命令 AT+CCWA? OK 响应 +CCWA: 设置命令 AT+CCWA=[[,[,]]] OK 响应 TA 控制呼叫等待服务，进行激活、去激活或状态查询。 若不为 2 且命令执行成功： OK 若为 2 且命令执行成功： +CCWA: , [+CCWA: , [...]] OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 199 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。 0 禁用 URC 上报 1 启用 URC 上报 整型。当省略时，当省略时，网络将忽略此命令。 0 禁用 1 启用 2 查询状态 整型。每个值代表一类信息。 1 语音（电话业务） 2 数据（指所有承载服务；如果TA在=2的情况下不支持值16、32、64 和128，则仅指某些承载服务） 4 传真（传真服务） 7 语音、数据和传真 8 短消息服务 16 数据电路同步 32 数据电路异步 64 专用数据包访问 128 专用 PAD 访问 整型。指示当前命令的状态是启用还是禁用。 0 禁用 1 启用 字符串类型。呼叫地址的电话号码，格式由指定。 整型。八字节地址类型。 128 类型由网络指定 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 可选字符串类型。以字母数字形式表示，对应在电话簿中的条目。 整型。中不包含主叫方 BCD 码的原因（详情参考 3GPP TS 24.008 第 10. 5.4.30 章节）。 0 CLI 有效 1 主叫方挂起 CLI（详情参考 3GPP TS 24.008 中表 10.5.135a/3GPP TS 24.008 'Reject by user'相关代码）。 2 由于网络问题或主叫方网络限制，CLI 不可用（详情参考 3GPP TS 24.008 中 表 10.5.135a/3GPP TS 24.008 'Interaction with other service'相关代码）。 3 由于主叫方为付费电话类型，CLI 不可用（详情参考 3GPP TS 24.008 中表 10.5.135a/3GPP TS 24.008 'Coin line/payphone'相关代码）。 4 由于其他原因导致的 CLI 不可用（详情参考 3GPP TS 24.008 中表 10.5.135 a/3GPP TS 24.008 'Unavailable'相关代码）。 CLI 不可用时（即当=2/3/4）时，应为空字符串('')且 值无意义。TA 可能返回的值为 128（3GPP TS 24.008 第 10.5.4.7 节中未知 的 TON/NPI）。 当主叫方挂起 CLI 时，（即=1）且 CLIP 提供了'override category'选项 上海移远通信技术股份有限公司 200 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 （详情参考 3GPP TS 22.081 and 3GPP TS 23.081），则需指定和； 否则，TA 将返回和 CLI 不可用时相同的和。 字符串类型。子地址。格式由指定。 整型。8 位字节的子地址。（详情参考 3GPP TS 24.008 第 10.5.4.8 章节） 可选数字类型。表示来电 eMLPP 优先级。该值的定义详情参考 3GPP TS 22.067 eMLPP。 错误码。详情参考第 13.5 章。 备注 1. 若处于未激活状态，此时返回的应为 0。例如，+CCWA: 0,7。 2. =2 时，将上报所有呼叫等待类别。此时，按任意键均可中止该命令。 3. 当启用 MT 显示呼叫等待（即启用呼叫等待）且在建立呼叫期间建立终止呼叫时，将上报如下 URC： +CCWA: ,,[,][,[,,[,]]] 举例 AT+CCWA=1,1 OK ATD10086; OK +CCWA: '02154450293',129,1 //启用 URC 上报。 //建立呼叫。 //通话中来电，来电处于呼叫等待状态中。 10.3. AT+CHLD 呼叫相关补充业务 此命令用于控制以下补充业务： ⚫ 暂时与 MT 断开连接但与网络保持连接的呼叫； ⚫ 多方通话（电话会议）； ⚫ 同时保持两方呼叫的服务用户（一方呼叫保持，另一方处于激活或警报状态）可以连接另一方呼 叫且释放自己的连接。 根据 3GPP TS 22.030 中的定义，可以将呼叫保持、恢复、释放并添加到会话中，并进行转移。 该命令基于 GSM/UMTS 补充业务 HOLD（呼叫保持；详情参考 3GPP TS 22.083 clause 2），MPTY （多方通话；详情参考 3GPP TS 22.084）和 ECT（呼叫转接；详情参考 3GPP TS 22.091）。GSM/UMTS 标准中描述了该命令与基于其他 GSM/UMTS 补充业务命令交互的过程。呼叫保持、多方通话和呼叫转接仅 适用于远程服务。 上海移远通信技术股份有限公司 201 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 设置命令用于控制呼叫保持、多方通话和呼叫转接，支持呼叫保持、呼叫恢复、呼叫释放、添加至对 话以及呼叫转移功能。 AT+CHLD 呼叫相关补充业务 测试命令 AT+CHLD=? 响应 +CHLD: (支持的列表) 设置命令 AT+CHLD=[] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。 0 挂断所有保持的呼叫或呼叫等待的 UDUB（用户决定用户忙）。如果有呼叫处于等 待状态，则挂断等待中的呼叫；否则，挂断所有进行的呼叫（若当前存在呼叫）。 1 挂断正在通话的呼叫并接听另一呼叫（等待呼叫或保持呼叫） 1X 挂断第 X 个呼叫（X=1~7） 2 保持正在通话呼叫并接听另一呼叫（等待呼叫或保持呼叫） 2X 保持除第 X 个呼叫（X=1~7）外的所有其他呼叫 3 建立多方通话 4 将保持的呼叫和当前来电建立通话，主叫方结束呼叫，或将正在通话的呼叫和等待 的呼叫建立通话，主叫方结束呼叫。 错误码。详情参考第 13.5 章。 举例 ATD10086; OK +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129 //建立呼叫。 //通话中来电，来电处于呼叫等待状态中。 //保持第一路通话，并接入第二路呼叫等待的通话。 //保持第一路呼叫。 上海移远通信技术股份有限公司 202 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 +CLCC: 2,1,0,0,0,'02154450293',129 OK AT+CHLD=21 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 +CLCC: 2,1,1,0,1,'02154450293',129 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129 +CLCC: 2,1,0,0,1,'02154450293',129 OK //接入第二路呼叫等待的通话。 //除 X = 1 外，保持正在通话的呼叫通话。 //接入第一路通话。 //保持第二路通话。 //将保持的呼叫添加到进行中的通话中建立多方电话会议。 10.4. AT+CLIP 主动上报来电号码 该命令为 GSM/UMTS 补充业务 CLIP（主叫号码显示），用于来电时，被叫方获取主叫号码身份信息。 设置命令用于使能或禁用 TE 端来电号码上报。 AT+CLIP 主动上报来电号码 测试命令 AT+CLIP=? 响应 +CLIP: (支持的列表) 查询命令 AT+CLIP? OK 响应 +CLIP: , 设置命令 AT+CLIP=[] OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 15 秒，受网络状态影响 / 上海移远通信技术股份有限公司 203 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。 0 禁用 URC 上报 1 启用 URC 上报 整型。 0 未提供 CLIP 业务 1 提供 CLIP 业务 2 未知 字符串类型。电话号码，格式由指定。 字符串类型。子地址，格式由定义。 整型。八位字节子地址类型。（详情参考 3GPP TS 24.008 第 10.5.4.8 章节） 整型。八位字节的地址类型。 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 161 国际号码 可选字符串字母数字类型。表示对应在电话号码簿中的条目。 整型。中不包含主叫方 BCD 号码的原因。 0 CLI 有效 1 主动上报来电号码 2 由于发起网络的限制或网络问题造成 CLI 不可用。 错误码。详情参考第 13.5 章。 备注 当启用在 TE 显示 CLIP（且主叫方允许）时，被叫通话里返回 RING（或者+CRING: ）后，将上 报如下 URC： +CLIP: ,,[subaddr],[satype],[], 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,,,'QUECTEL',0 上海移远通信技术股份有限公司 204 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 10.5. AT+CLIR 主叫号码限制 该命令是基于 3GPP TS 22.081 的 CLIR（主叫线路识别限制）补充业务和 3GPP TS 24.607 的 OIR（主 叫识别限制）补充业务。该命令在主叫方发起呼叫时，用于启用或禁用主叫电话号码限制。 当临时模式（临时限制或临时允许）作为后续所有主叫的默认值时，该设置命令可以修改 CLIR 的订阅 信息（默认是限制或者允许）。 AT+CLIR 主叫号码限制 测试命令 AT+CLIR=? 响应 +CLIR: (支持的范围) 查询命令 AT+CLIR? OK 响应 +CLIR: , 设置命令 AT+CLIR= OK 响应 OK 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 15 秒，受网络状态影响 / 参数 整型。调整呼出电话状态。 0 根据签约 CLIR 的服务来显示 1 启用 CLIR 2 禁用 CLIR 整型。显示网络中的 CLIR 业务状态。 0 CLIR 业务未提供 1 CLIR 业务以永久模式提供 2 未知（如网络原因） 3 CLIR 业务临时限制 4 CLIR 业务临时允许 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 205 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 10.6. AT+COLP 被叫线路识别显示 建立主叫后，该命令启用或禁用主叫方获取被叫方身份，详情可参考 GSM/UMTS 补充业务 COLP（被 叫线路识别提示）。MT 启用或禁用在 TE 显示 COL（被叫线路），对网络中补充业务 COLR 的执行没有影 响。 AT+COLP 被叫线路识别显示 测试命令 AT+COLP=? 响应 +COLP: (支持的列表) 查询命令 AT+COLP? OK 响应 +COLP: , 设置命令 AT+COLP=[] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 响应+CR 或 V.25ter 之前，TA 返回中间结果码至 TE。 OK 15 秒，取决于网络状态 / 参数 整型。禁用/启用在 MT 中显示结果码。 0 禁用 1 启用 整型。是否在网络中提供用户 COLP 业务。 0 不提供 COLP 业务 1 提供 COLP 业务 2 未知（如：无网络等） 字符串类型。电话号码，格式由指定。 整型。八位字节地址类型。 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 字符串类型。子地址，格式由指定。 整型。子地址类型（详情参考 3GPP TS 24.008 第 10.5.4.8 章节）。 可选字符串类型，以字母数字表示，对应电话簿条目。 上海移远通信技术股份有限公司 206 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 备注 使能结果码（且被叫方允许）后，响应+CR 和 V.25ter 之前，将返回如下中间结果码： +COLP: ,,[],[],[] 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK 10.7. AT+CSSN 补充业务通知 该设置命令启用或禁用 TA 将通知结果码上报 TE。 AT+CSSN 补充业务通知 测试命令 AT+CSSN=? 响应 +CSSN: (支持的列表),(支持的列表) 查询命令 AT+CSSN? OK 响应 +CSSN: , 设置命令 AT+CSSN=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 207 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。启用/禁用 TA 上报中间结果码+CSSI 至 TE。 0 禁用 1 启用 整型。启用/禁用 TA 上报未经请求结果码+CSSU 至 TE。 0 禁用 1 启用。 整型。由厂商指定，支持的参数取值如下： 0 无条件呼叫转移处于激活状态 1 部分条件呼叫转移处于激活状态 2 呼叫已经转移 3 呼叫等待中 5 禁止呼出 整型。由厂商指定，支持的参数取值如下： 0 来电为转接电话 2 通话保持中（语音通话中） 3 通话已恢复（语音通话中） 5 保持中的通话被另一方挂断 10 转接另一来电 错误码。详情参考第 13.5 章。 备注 ⚫ 当=1 且主叫建立后收到补充业务通知，将在响应其他主叫建立结果码前响应+CSSI: 至 TE。 ⚫ 当=1 且被叫建立后或在通话期间收到补充业务通知，将响应非请求结果码+CSSU:至 TE。 10.8. AT+CUSD 非结构化补充数据业务 该命令根据 3GPP TS 22.090，控制非结构化补充数据业务（USSD）。该命令支持网络与 TE 发起的操 作。 禁用/启用非请求结果码的上报。=2 取消正在进行的 USSD 会话。针对网络端或网络 发起操作的 USSD 响应，格式为：+CUSD: [,,[]]。 该设置命令指定时，TE 发起的 USSD 字符串或网络响应的 USSD 字符串将发送给网络。网 络响应的 USSD 字符串在后续 URC +CUSD 中返回。 上海移远通信技术股份有限公司 208 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 AT+CUSD 非结构化补充数据业务 测试命令 AT+CUSD=? 响应 +CUSD: (支持的范围) 查询命令 AT+CUSD? OK 响应 +CUSD: 设置命令 AT+CUSD=[[,[, ]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 120 秒，取决于网络状态 / 参数 整型。是否向 TE 上报结果码。 0 禁用结果码上报 1 启用结果码上报。 2 取消会话（不适用于查询命令的返回结果） 字符串类型。发送至网络的 USSD。若参数缺省，则无法访问网络。 字符串类型。从网络接收的 USSD。 整型。详情参考 3GPP TS 23.038 小区广播数据编码方案。默认值：15。 整型。网络响应或发起的 USSD。 0 无需进一步的用户操作（网络发起的 USSD 通知或 TE 发起操作后无需进一步的信息） 1 需要进一步的用户操作（网络发起的 USSD 请求或 TE 发起操作后需要进一步信息） 2 网络终止 USSD 3 另一本地客户端已响应 4 不支持该操作 5 网络超时 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 209 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 11 音频命令 11.1. AT+CLVL 扬声器音量等级选择 该命令用于选择 MT 内部扬声器的音量等级。 AT+CLVL 扬声器音量等级选择 测试命令 AT+CLVL=? 响应 +CLVL: (支持的列表) 查询命令 AT+CLVL? OK 响应 +CLVL: 设置命令 AT+CLVL= OK 或者 ERROR 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与MT功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 自动保存参数配置。 参数 整型。厂商指定范围的音量级别（最小值代表最低的声音级别）。范围：0~5；默认值：3。 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 210 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 11.2. AT+CRSL 设置铃声音量 该命令用于设置铃声音量。 AT+CRSL 设置铃声音量 测试命令 AT+CRSL=? 查询命令 AT+CRSL? 设置命令 AT+CRSL= 最大响应时间 特性说明 响应 +CRSL: (支持的列表) OK 响应 +CRSL: OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 自动保存参数配置。 参数 整型。表示铃声音量。范围：0~7；默认值：3。 11.3. AT+CMUT 控制静音 此命令用于在语音通话中启用/禁用上行语音。 AT+CMUT 控制静音 测试命令 AT+CMUT=? 响应 +CMUT: (支持的列表) 查询命令 AT+CMUT? 设置命令 OK 响应 OK 或者 ERROR 响应 上海移远通信技术股份有限公司 211 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 AT+CMUT= 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 或者 ERROR 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 自动保存参数配置。 参数 整型。 0 关闭静音 1 开启静音 错误码。详情参考第 13.5 章。 11.4. AT+QAUDLOOP 控制音频循环测试 该命令用于启用或者禁用音频循环测试。 AT+QAUDLOOP 控制音频循环测试 测试命令 AT+QAUDLOOP=? 响应 +QAUDLOOP: (支持的列表) 查询命令 AT+QAUDLOOP? OK 响应 +QAUDLOOP: 设置命令 AT+QAUDLOOP= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 不保存参数配置。 上海移远通信技术股份有限公司 212 / 277 参数 整型。是否启用音频循环测试。 0 禁用 1 启用 RG50xQ&RM5xxQ 系列 AT 命令手册 11.5. AT+VTS 生成 DTMF 音 该命令发送 ASCII 字符，使 MSC 将 DTMF 音发送到对端。该命令只能在语音呼叫中使用。 AT+VTS 生成 DTMF 音 测试命令 AT+VTS=? 响应 +VTS: (支持的列表),(支持的范 围) 设置命令 AT+VTS=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 取决于和的长度 / 参数 字符串类型。ASCII 字符集 0-9、#、*、A、B、C、D 需加上引号（'...'）。 当一次发送多个 DTMF 音时，AT+VTD 可指定两 DTMF 音的时间间隔。 整型。每个 DTMF 音的持续时间（以 10 毫秒为单位）的公差。范围：0~225。 如果持续时间小于网络指定的最短时间，则实际持续时间为网络指定的时间。若省 略此参数，则 AT+VTD 指定该参数的值。 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 213 / 277 举例 ATD12345678900; OK //通话已连接 AT+VTS='1' OK AT+VTS='1234567890A' OK RG50xQ&RM5xxQ 系列 AT 命令手册 //拨号。 //对端能够听到 DTMF 音。 //一次发送多个 DTMF 音。 11.6. AT+VTD 设置 DTMF 音时长 该命令用于 DTMF 音的持续时间。一次发送多个 DTMF 音时，可以设置两个音调的时间间隔。 AT+VTD 设置 DTMF 音时长 测试命令 AT+VTD=? 响应 +VTD: (支持的范围),( 支持的范围) 查询命令 AT+VTD? OK 响应 +VTD: , 设置命令 AT+VTD=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 不保存参数配置。 上海移远通信技术股份有限公司 214 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。DTMF 音的持续时间。范围：0~255；默认值：3；单位：0.1 秒且有一定偏差。 如果持续时间小于网络指定的最短时间，则实际持续时间为网络指定的时间。 整型。表示通过 AT+VTS 一次发送多个 DTMF 音时，两个 DTMF 音的时间间隔。范围： 0~255；默认值：0；单位：0.1 秒。 错误码。详情参考第 13.5 章。 11.7. AT+QAUDMOD 设置音频模式 该设置命令用于设置连接设备所需的音频模式。 AT+QAUDMOD 设置音频模式 测试命令 AT+QAUDMOD=? 响应 +QAUDMOD: (支持的范围) 查询命令 AT+QAUDMOD? OK 响应 +QAUDMOD: 设置命令 AT+QAUDMOD= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 Quectel 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 不保存参数配置。 上海移远通信技术股份有限公司 215 / 277 参数 RG50xQ&RM5xxQ 系列 AT 命令手册 整型。表示当前配置的回声消除、噪声抑制、数字增益和校准参数设备的音频模式。 0 手机 1 耳机 2 扬声器 3 VCO 4 蓝牙 5 Voice over USB 6 Full TTY 7 HCO 8 传真 错误码。详情参考第 13.5 章。 11.8. AT+QDAI 配置数字音频接口 该命令配置数字音频接口。若模块无 Codec 时，需定义 PCM 格式。在默认设置（主模式、短同步、 2048 kHz 时钟频率、16 位线性数据格式、8 kHz 采样率）下使用 MT。 AT+QDAI 配置数字音频接口 测试命令 AT+QDAI=? 响应 +QDAI: ( 支 持 的 范 围 ),( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 列 表),(支持的列表),(支持的列表),(支持 的范围),(支持的范围) 查询命令 AT+QDAI? OK 响应 +QDAI: [,,,,,,,[,]] 设置命令 AT+QDAI=[,,,[,[,[,,[,]]]]] OK 响应 OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 参考 该命令立即生效； 自动保存参数配置。 Quectel 上海移远通信技术股份有限公司 216 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 Codec 型号。取值为 x、1~6（暂不支持） 整型。 0 主模式 1 从模式 整型。 0 主模式（短帧同步） 1 辅模式（长帧同步） 整型。时钟频率。 0 128 kHz（暂不支持） 1 256 kHz 2 512 kHz 3 1024 kHz 4 2048 kHz 5 4096 kHz 整型。数据格式。 0 16 位线性 整型。采样率。 0 8 kHz 1 16 kHz 整型。 1 使用的时隙的总数 2 使用的时隙的总数（使用时设置为 2） 整型。使用第几个时隙。范围：1~16。 整型。使用第几个时隙。范围：2~16。 备注 1. 4096 kHz 时钟频率仅适用于 16 kHz 采样率。 2. 每帧位数 = /。例如，若为 2048 kHz 且为 8 kHz，每帧位数为 256。每帧位数应大于 16。 3. 若选择从模式，应向 MT 提供主模式和同步时钟。 4. 若选择推荐的 Codec 且需要使用 16 kHz 采样率，需输入。当前 MT 仅支持 16 kHz （AT+QDAI=x,0,0,5,0,1）。 举例 AT+QDAI=? //查询参数范围。 +QDAI: x,(0,1),(0,1),(0-5),(0-2),(0,1),(1-2),(1-16),(2-16) OK AT+QDAI? +QDAI: x,0,0,4,0,0,1,1 //查询当前接口配置。 上海移远通信技术股份有限公司 217 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK AT+QDAI=x,1,0,4,0,0,1,1 OK AT+QDAI=x,0,0,4,0,1,1,1 //将辅助音频接口 PCM 设置为从模式、短帧同步、8 kHz 采样率、2048 kHz。 //配置一个时隙。 OK AT+QDAI=x,0,0,4,0,1,2,1,3 //配置两个时隙。 OK 11.9. AT+QSIDET 设置当前模式的侧音增益 该命令用于设置当前模式的侧音增益。 AT+QSIDET 设置当前模式的侧音增益 测试命令 AT+QSIDET=? 响应 +QSIDET: (支持的范围) 查询命令 AT+QSIDET? OK 响应 +QSIDET: 设置命令 AT+QSIDET= 最大响应时间 特性说明 参考 Quectel OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。表示当前模式的侧音增益。范围：0~65535。不同音频模式下默认值可能不同。 上海移远通信技术股份有限公司 218 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 备注 该命令仅在通过 AT+QAUDLOOP=1 启用了音频循环测试后有效。 11.10. AT+QMIC 设置麦克风的上行增益 该命令用于设置麦克风的上行增益。 AT+QMIC 设置麦克风的上行增益 测试命令 AT+QMIC=? 响应 +QMIC: (支持的范围),(支持的范围) 查询命令 AT+QMIC? OK 响应 +QMIC: , 设置命令 AT+QMIC=[,] 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令在下次通话时生效； 不保存参数配置。 参数 整型。上行 Codec 增益。范围：0~65535。不同音频模式下默认值可能不同。 整型。上行数字增益。范围：0~65535。不同音频模式下默认值可能不同。 上海移远通信技术股份有限公司 219 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 11.11. AT+QIIC 读写 IIC 此命令可以通过 IIC 接口配置 Codec。 AT+QIIC 读写 IIC 测试命令 AT+QIIC=? 响应 +QIIC: (支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表) 设置命令 AT+QIIC=,,,[,] OK 响应 若省略可选参数，则查询当前配置： +QIIC: OK 最大响应时间 特性说明 若指定可选参数，读取或写入 IIC： OK 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。 0 设置命令 1 查询命令 十六进制整型。 0~0xFF 7 位字节从机设备地址 十六进制整型。 0~0xFF 寄存器地址 整型。 1 读取字节 2 写入字节 十六进制整型。 0~0xFFFF 数据值 上海移远通信技术股份有限公司 220 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 举例 AT+QIIC=1,0x18,0x0c,1 +QIIC: 0x50 //读取寄存器位置的 1 字节寄存器内容：从机地址：0x18；寄存器地址：12。 OK AT+QIIC=0,0x18,0x0c,1,0x5f //写入寄存器位置的 1 字节寄存器内容：从机地址：0x18；寄存器地址：12； 写入值：0x5f。 OK 11.12. AT+QPCMV 启用/禁用 UAC 功能 该命令用于启用/禁用 UAC 功能。启用该功能后，拨打电话时，来自对方的语音数据将被模块解码为 PCM 数据，然后通过已设置的 USB 端口输出到设备。同时，设备将 PCM 数据写入端口，数据将通过网络 传输到呼叫设备的另一端。 AT+QPCMV 启用/禁用 UAC 功能 测试命令 AT+QPCMV=? 响应 +QPCMV: (支持的列表),(支持的列表) 查询命令 AT+QPCMV? OK 响应 +QPCMV: [,] 设置命令 AT+QPCMV=[,] 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。启用/禁用 UAC 功能。 1 启用 0 禁用 整型。配置 PCM 数据传输的端口或者声卡。 2 UAC 模式，将模块作为 USB 声卡使用。 上海移远通信技术股份有限公司 221 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 备注 在非 UAC 模式下，必须通过执行 AT+QCFG='usbcfg',0x2C7C,0x0800,x,x,x,x,x,x,1 和 AT+QPCMV=1,2 命令启用 USB 音频设备。 11.13. AT+QLDTMF 控制本地 DTMF 音的播放 该命令用于播放本地 DTMF 音，也可用于停止播放 DTMF 音。 AT+QLDTMF 控制本地 DTMF 音的播放 测试命令 AT+QLDTMF=? 响应 +QLDTMF: (支持的列表),(支持的列表) 设置命令 AT+QLDTMF=,[,< y>] OK 响应 OK 若错误与MT功能相关： +CME ERROR: 执行命令 停止播放DTMF音 AT+QLDTMF 最大响应时间 特性说明 播放完成后上报： +QLDTMF: 5 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。每段 DTMF 的播放时间以及静音时间。范围：1~1000；为 1 时单位为 1/100 秒，未设置时单位为 1/10 秒。 字符串类型。最大长度：20 个字符；DTMF 字符串包含：0-9, *, #, A-D。 整型。若未指定，则表示的单位为 1/10 秒。 错误码。详情参考第 13.5 章。 上海移远通信技术股份有限公司 222 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 举例 AT+QLDTMF=? //查询范围。 +QLDTMF: (1-1000),(0-9,*,#,A-D) OK AT+QLDTMF=2,'AB12#' OK AT+QLDTMF OK //播放 DTMF 音（A,B,1,2,#），播放时间以及静音时间为 200 毫秒。 //停止播放。 11.14. AT+QAUDCFG 查询和配置音频调音流程 AT+QAUDCFG 查询和配置音频调音流程 测试命令 AT+QAUDCFG=? 响应 +QAUDCFG: 'slic/AudLoop',(支持的列表) +QAUDCFG: 'slic/LF_Ring',(支持的列表) +QAUDCFG: 'slic_IndRep',(支持的列表) +QAUDCFG: 'slic_cid',(支持的范围) +QAUDCFG: 'aif',(支 持的 列表 ),(支 持的 列表) +QAUDCFG: 'i2s/cfg',( 支 持 的 列 表 ),( 支 持 的 列表) 最大响应时间 300 毫秒 11.14.1. AT+QAUDCFG='slic/AudLoop' 开启/关闭模拟话机的回环音测试功能和拨号音 该命令用于配置模拟话机的回环音测试功能。区别于 Codec 场景，该命令测试回环音的同时，自动开 启或关闭拨号音。 AT+QAUDCFG='slic/AudLoop' 开启/关闭模拟话机的回环音测试功能和拨号音 设置命令 AT+QAUDCFG='slic/AudLoop'[,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic/AudLoop', OK 若指定可选参数，则设置模拟话机的回环音测试功能和拨号 音： OK 上海移远通信技术股份有限公司 223 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 或者 ERROR 300 毫秒 该命令立即生效； 配置参数不保存。 参数 整型。是否开启模拟话机回环音测试功能并自动开启或关闭拨号音。 0 关闭模拟话机回环音测试功能并自动开启拨号音。 1 开启模拟话机回环音测试功能并自动关闭拨号音。 备注 1. 目前仅支持 SI32185 SLIC 芯片。 2. 拨号音是指模拟话机摘机后、拨号前的提示音，用于提示用户可以进行拨号。 3. 回环音用于测试音频播放和录音功能是否正常。 举例 AT+QAUDCFG='slic/AudLoop',1 OK AT+QAUDCFG='slic/AudLoop' +QAUDCFG: 'slic/AudLoop',1 OK //开启模拟话机回环音测试功能并自动关闭拨号音。 //查询当前回环音功能启动状态。 11.14.2. AT+QAUDCFG='slic/LF_Ring' 设置状态寄存器 该命令用于设置 SLIC 芯片的线路状态寄存器。 AT+QAUDCFG='slic/LF_Ring' 设置状态寄存器 设置命令 AT+QAUDCFG='slic/LF_Ring'[,] 响应 若省略可选参数，则查询当前配置： AT+QAUDCFG='slic/LF_Ring', OK 若指定可选参数，则设置状态寄存器： OK 或者 ERROR 上海移远通信技术股份有限公司 224 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令立即生效； 配置参数不保存。 参数 整型。设置 SLIC 芯片的线路状态寄存器。 0 FORWARD ACTIVE 状态。该状态下使能摘挂机检测功能。挂机时，音频数据流被 禁用；摘机后，音频数据流自动使能。 1 RINGING 状态。表示模拟话机检测到正负极电话线，当处于 RINGING 状态时，会 产生电话铃音，提示用户当前有电话接入。 备注 1. 目前仅支持 SI32185 SLIC 芯片。 2. 目前仅支持 FORWARD ACTIVE 和 RINGING 两种状态。模拟话机处于挂机状态，而且没有来电 时，对应 FORWARD ACTIVE 状态；模拟话机处于挂机，而且有来电时，对应 RINGING 状态。 3. 该命令仅在 SLIC 模拟话机工作时生效。 举例 AT+QAUDCFG='slic/LF_Ring',1 OK AT+QAUDCFG='slic/LF_Ring' AT+QAUDCFG='slic/LF_Ring',1 OK //设置线路状态为 RINGING 状态。 //查询当前的线路状态。 11.14.3. AT+QAUDCFG='slic_IndRep' 配置 SLIC 模拟话机的事件上报功能 该命令用于开启或关闭 SLIC 模拟话机的事件上报功能。目前支持上报 DTMF、挂机、摘机、闪断四种 事件。 AT+QAUDCFG='slic_IndRep' 配置 SLIC 模拟话机的事件上报功能 设置命令 AT+QAUDCFG='slic_IndRep'[,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic/AudLoop', OK 若指定可选参数，则配置 SLIC 模拟话机的事件上报功能： 上海移远通信技术股份有限公司 225 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 OK 或者 ERROR 300 毫秒 该命令立即生效； 配置参数不保存。 参数 整型。开启或关闭 SLIC 模拟话机的事件上报功能。 0 关闭事件上报功能 1 开启事件上报功能 备注 1. 目前仅支持 SI32185 SLIC 芯片。 2. 目前支持的 DTMF 事件包含 0~9、*、#。 3. 该命令仅在 SLIC 模拟话机工作时生效。 举例 AT+QAUDCFG='slic_IndRep',1 OK +QIND: 'SLIC Hook off' +QIND: 'SLIC DTMF',1 +QIND: 'SLIC Flash Key' //开启 SLIC 模拟话机的事件上报功能。 //拿起话柄，收到摘机的 URC 上报。 //按下数字键 1，收到 DTMF 1 的 URC 上报。 //按下闪断键，收到通话闪断的 URC 上报。 11.14.4. AT+QAUDCFG='slic_cid' 测试 SLIC 的来电显示功能 此命令用于测试 SLIC 的来电显示功能。 AT+QAUDCFG='slic_cid' 测试 SLIC 的来电显示功能 设置命令 AT+QAUDCFG='slic_cid', 响应 OK 或者 ERROR 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 226 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 特性说明 该命令立即生效； 配置参数不保存。 参数 字符串类型。来电显示的电话号码。最大长度：15 字节。 备注 1. 目前仅支持 SI32185 SLIC 芯片。 2. 在测试过程中以及在来电显示之前，SLIC 将强制响铃一次。。 3. 该命令仅在 SLIC 模拟话机工作时生效。 举例 AT+QAUDCFG='slic_cid','012345678901234' OK 11.14.5. AT+QAUDCFG='aif' 切换音频接口和传输协议 该命令用于切换音频接口和传输协议。 AT+QAUDCFG='aif' 切换音频接口和传输协议 设置命令 AT+QAUDCFG='aif'[,,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'aif',, OK 最大响应时间 特性说明 若指定可选参数，则切换音频接口和传输协议： OK 或者 ERROR 300 毫秒 该命令重启后生效； 配置参数自动保存。 上海移远通信技术股份有限公司 227 / 277 参数 整型。音频接口。 0 PCM 协议 1 I2S 协议 整型。音频接口通道。 1 开启第一路音频接口 2 开启第二路音频接口 举例 AT+QAUDCFG='aif',1,1 OK AT+QAUDCFG='aif' +QAUDCFG: 'aif',1,1 OK //启用第一路 I2S 协议。 //查询当前配置。 RG50xQ&RM5xxQ 系列 AT 命令手册 11.14.6. AT+QAUDCFG='i2s/cfg' 配置 I2S 该命令用于配置主从模式和采样率。 AT+QAUDCFG='i2s/cfg' 配置 I2S 设置命令 AT+QAUDCFG='i2s/cfg',[,< sample_rate>] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'i2s/cfg',, OK 最大响应时间 特性说明 若指定可选参数，配置 I2S： OK 或者 ERROR 1秒 该命令重启后生效； 配置参数自动保存。 上海移远通信技术股份有限公司 228 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 整型。 0 主模式 1 从模式 整型。采样率。 0 8000 Hz 1 16000 Hz 2 48000 Hz 备注 仅当音频接口为 I2S 协议时方可配置该命令（通过将 AT+QAUDCFG='aif'中的配置 为 1）。 举例 AT+QAUDCFG='i2s/cfg',1,1 OK AT+QAUDCFG ='i2s/cfg' +QAUDCFG: 'i2s/cfg',1,1 OK //设置 I2S 为从模式和 16000 Hz 采样率。 //查询当前设置。 11.15. AT+QSLIC 启用/禁用 SLIC 该命令用于启用或禁用 SLIC。 AT+QSLIC 启用/禁用 SLIC 测试命令 AT+QSLIC=? 查询命令 AT+QSLIC? 响应 +QSLIC: ( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的列表) OK 响应 +QSLIC: [,][,] OK 上海移远通信技术股份有限公司 229 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 设置命令 AT+QSLIC=,[,< region>] 响应 OK 或 ERROR 最大响应时间 300 毫秒 特性说明 参考 Quectel 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用 SLIC。 0 禁用 1 启用 整型。设置 SLIC 平台类型。仅当=1 时有效。 0 保留 1 LE9641（暂不支持） 2 SI32185 3 LE9643 整型。配置 SI32185 的区域。仅当为 2 时有效。 0 中国 1 法国 备注 查询 SI32185 状态时，若为 0，则不返回当前区域配置；若配置为 1，查询时则返回 当前区域配置。 举例 AT+QSLIC=? //测试命令。 +QSLIC: (0,1),(0-3),(0,1) OK AT+QSLIC=0,2 OK AT+QSLIC=1,2 OK //禁用 SLIC。 //启用 SLIC 并设置 SLIC 平台类型为 SI32185。 AT+QSLIC=1,2,1 //启用 SLIC，设置 SLIC 平台类型为 SI32185，配置区域为法国。 上海移远通信技术股份有限公司 230 / 277 OK AT+QSLIC? +QSLIC: 1,2,1 OK AT+QSLIC=? +QSLIC: (0,1),(0-2) OK //查询当前配置。 RG50xQ&RM5xxQ 系列 AT 命令手册 上海移远通信技术股份有限公司 231 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 12 硬件相关命令 12.1. AT+QPOWD 关闭模块 该命令用于关闭模块。命令执行成功后立即返回 OK，随后 UE 注销网络。注销完成后 UE 输出 URC POWERED DOWN 并进入关机状态。注销网络最大时长为 60 秒。为避免数据丢失，在输出 URC POWERED DOWN 之前不能断开模块电源。 AT+QPOWD 关闭模块 测试命令 AT+QPOWD=? 响应 +QPOWD: (支持的列表) 设置命令 AT+QPOWD=[] OK 响应 OK 最大响应时间 特性说明 POWERED DOWN 300 毫秒 / 参数 整型。 0 立即关机 1 正常关机 12.2. AT+CCLK 实时时钟 该命令用于设置和查询模块实时时钟（RTC）。 AT+CCLK 实时时钟 测试命令 响应 AT+CCLK=? OK 上海移远通信技术股份有限公司 232 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 查询命令 AT+CCLK? 设置命令 AT+CCLK= 最大响应时间 特性说明 参考 3GPP TS 27.007 响应 +CCLK: OK 响应 OK 若错误与 MT 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。格式：'yy/MM/dd,hh:mm:ss±zz'，分别表示年（最后两位）、月、日、小时、 分钟、秒和时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异；范围：-48 ~ +56）。 例如，1994 年 5 月 6 日 22:10:00 GMT + 2 小时等于'94/05/06,22:10:00+08'。 错误码。详情参考第 13.5 章。 举例 AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //查询本地时间。 12.3. AT+QADC 查询 ADC 值 该命令用于读取 ADC 通道的电压值。 AT+QADC 查询 ADC 值 测试命令 AT+QADC=? 响应 +QADC: (支持的列表) 查询命令 AT+QADC= OK 响应 +QADC: , 上海移远通信技术股份有限公司 233 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。ADC 通道号。 0 ADC 通道 0 1 ADC 通道 1 整型。ADC 值是否读取成功。 0 读取失败 1 读取成功 整型。指定 ADC 通道的电压。单位：mV。 12.4. AT+QSCLK 配置休眠模式 该命令用于控制 MT 进入休眠模式。启用休眠模式后，MT 将直接进入休眠模式。 AT+QSCLK 配置休眠模式 测试命令 AT+QSCLK=? 响应 +QSCLK: (支持的列表),(支持的列表) 查询命令 AT+QSCLK? OK 响应 +QSCLK: , 设置命令 AT+QSCLK=[,] 最大响应时间 特性说明 参考 Quectel OK 响应 OK 300 毫秒 / 上海移远通信技术股份有限公司 234 / 277 参数 整型。禁用/启用休眠模式。 0 禁用 1 启用，由 DTR 控制且 DTR 默认拉高。 整型。是否保存配置至 NVM。 0 不保存 1 保存 RG50xQ&RM5xxQ 系列 AT 命令手册 12.5. AT+QTEMP 查询 MT 温度值 该命令用于获取 MT 的温度值。 AT+QTEMP 查询 MT 温度值 测试命令 AT+QTEMP=? 执行命令 AT+QTEMP 最大响应时间 特性说明 参考 Quectel 响应 OK 响应 [+QTEMP: ,] […] OK 300 毫秒 / 参数 字符串类型。传感器类型。 'aoss0-usr' Modem 上第一个检测点 'mdm-q6-usr' Modem 上第二个检测点 'ipa-usr' Modem 上第三个检测点 'cpu0-a7-usr' Modem 上第四个检测点 'mdm-core-usr' Modem 上第五个检测点 'xo-therm-usr' XO 晶体 'pa-therm2-usr' PA 芯片 'sdx-case-therm-usr' BB 芯片 'ambient-therm-usr' NTC 整型。温度值。单位：°C。 上海移远通信技术股份有限公司 235 / 277 举例 AT+QTEMP +QTEMP:'aoss0-usr','26' //查询 MT 温度值。 +QTEMP:'mdm-q6-usr','27' +QTEMP:'ipa-usr','27' +QTEMP:'cpu0-a7-usr','27' +QTEMP:'mdm-core-usr','28' +QTEMP:'xo-therm-usr','24' +QTEMP:'pa-therm2-usr','24' +QTEMP:'sdx-case-therm-usr','24' +QTEMP:'ambient-therm-usr','24' OK RG50xQ&RM5xxQ 系列 AT 命令手册 12.6. AT+QAGPIO 设置 AP 或 PMU 的 GPIO 输出电平 该命令用于设置 AP 或 PMU 的 GPIO 输出电平。 AT+QAGPIO 设置 AP 或 PMU 的 GPIO 输出电平 测试命令 AT+QAGPIO=? 响应 +QAGPIO: ,,(支持的列表) 设置命令 AT+QAGPIO=,, 最大响应时间 特性说明 OK 响应 OK 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 236 / 277 参数 整型。设置 AP 或 PMU。 0 AP 1 PMU 整型。GPIO 号。范围：1~11。 整型。GPIO 输出电平。 0 低电平 1 高电平 备注 PMU GPIO 的范围为1~11。 RG50xQ&RM5xxQ 系列 AT 命令手册 举例 AT+QAGPIO=? +QAGPIO: ,,(0,1) OK AT+QAGPIO=0,105,1 OK AT+QAGPIO=1,8,0 OK //设置 AP 的 gpio_105 输出电平为高电平。 //设置 PMU 的 gpio_8 输出电平为低电平。 12.7. AT+QETH RGMII 扩展配置 AT+QETH RGMII 扩展配置 测试命令 AT+QETH=? 响应 +QETH: 'rgmii',( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 范围),(支持的范围) +QETH: 'ipptmac', +QETH: 'routing',( 支 持 的 列 表 ),( 支 持 的 列 表),,(支持的范围) +QETH: 'mac_address', +QETH: 'speed',(支持的列表) +QETH: 'an',支持的列表) +QETH: 'dm',(支持的列表) +QETH: 'eth_driver',,(支持的列表) 上海移远通信技术股份有限公司 237 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 +QETH: 'eth_at',(支持的列表) OK 12.7.1. AT+QETH='rgmii' 启用/禁用 RGMII 该命令用于启用/禁用 RGMII 并查询当前配置。 AT+QETH='rgmii' 启用/禁用 RGMII 设置命令 AT+QETH='rgmii'[,,[,[,]]] 响应 若省略所有可选参数，则查询当前配置： +QETH: 'RGMII',,, +QETH: 'RGMII',, +QETH: 'RGMII',, +QETH: 'RGMII',, +QETH: 'RGMII',, OK 若省略可选参数和，启用或者禁用 RGMII （无数据拨号）： OK 若省略可选参数，启用指定模式且使用默认配置文 件的 RGMII，或禁用当前模式下所有 RGMII 数据拨号： OK 若指定可选参数，启用或者禁用指定模式和配置文件的 RGMII： OK 最大响应时间 特性说明 若有任何错误： ERROR 20 秒 该命令立即生效； 参数保存详情参考备注。 参数 字符串类型。启用或者禁用 RGMII。 'ENABLE' 启用 RGMII 'DISABLE' 禁用 RGMII 整型。RGMII 电压域。 上海移远通信技术股份有限公司 238 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 0 1.8 V 1 2.5 V 整型。RGMII 模式。 -1 空模式（无任何数据拨号） 0 使用 COMMON-RGMII 模式进行 RGMII 拨号 1 使用 IP Passthrough-RGMII 模式进行 RGMII 拨号 整型。相应拨号是否已被设置。 0 未设置 1 已设置 整型。RGMII 数据拨号的配置文件 ID。范围：1~8。 应和 AT+CGDCONT 联合使用。 备注 1. COMMON-RGMII 和 IP Passthrough-RGMII 模式互斥，无法同时启用。 2. 当使用第二、第三和第四信道进行数据拨号时，不保存是否启用 RGMII 拨号的配置（即模块重启后 RGMII 的拨号配置无效），但是 APN 配置自动保存；当使用第一路数据拨号时，配置自动保存（即模 块重启后 RGMII 拨号配置仍有效）。 3. 启用 IP Passthrough-RGMII 模式前，需使用 AT+QETH='ipptmac',配置 MAC 地 址。 4. 第一次执行该命令进行数据拨号时，会使用相应 RGMII 模式以及 APN 进行第一路数据拨号。第二次 和第三次执行该命令进行数据拨号时，则相应开始第二路和第三路数据拨号。若多次执行该命令进行 数据拨号且未指定 APN，则使用第一路、第二路、第三路和第四路的默认 APN（最多同时支持 4 路）。 举例 AT+QETH='rgmii' +QETH: 'RGMII','DISABLE',1,-1 +QETH: 'RGMII',0,1 +QETH: 'RGMII',0,2 +QETH: 'RGMII',0,3 +QETH: 'RGMII',0,4 //查询 RGMII 当前配置。 OK AT+QETH='rgmii','ENABLE',1 OK AT+QETH='rgmii','ENABLE',1,0 OK AT+QETH='rgmii','ENABLE',1,0,1 OK AT+QETH='rgmii','ENABLE',1,1 //启用 RGMII（无数据拨号）。 //启用 COMMON-RGMII 模式的 RGMII 数据拨号并使用默认 APN 进行数据拨号。 //启用 COMMON-RGMII 模式的 RGMII 数据拨号并使用第一路 APN 进行数据拨号。 //启用 IP Passthrough-RGMII 模式的 RGMII 数据拨号并使用默认 APN 进行数据拨号。 上海移远通信技术股份有限公司 239 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 OK AT+QETH='rgmii','ENABLE',1,1,1 OK //启用 IP Passthrough-RGMII 模式的 RGMII 数据拨号并使用第一 路 APN 进行数据拨号。 12.7.2. AT+QETH='ipptmac' 设置 IP Passthrough-RGMII 模式的 MAC 地址 该命令用于设置 IP Passthrough-RGMII 模式的 MAC 地址。 AT+QETH='ipptmac' 设置 IP Passthrough-RGMII 模式的 MAC 地址 设置命令 AT+QETH='ipptmac'[,] 响应 若省略可选参数，则查询当前配置： +QETH: 'ipptmac', OK 若指定可选参数，配置 RGMII 的 MAC 地址： OK 最大响应时间 特性说明 若有任何错误： ERROR 100 毫秒 该命令在下次执行 IP Passthrough 模式的数据拨号时生效； 参数配置自动保存。 参数 字符串类型。连接至模块的设备的 MAC 地址。 举例 AT+QETH='ipptmac',a1:b2:c3:d4:e5:f6 OK AT+QETH='ipptmac' +QETH: 'ipptmac',a1:b2:c3:d4:e5:f6 //设置 IP Passthrough-RGMII 模式的 MAC 地址。 //查询 IP Passthrough-RGMII 模式的 MAC 地址。 OK 12.7.3. AT+QETH='routing' 设置多路拨号的路由规则 该命令用于设置多路拨号的路由规则。 上海移远通信技术股份有限公司 240 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 AT+QETH='routing' 设置多路拨号的路由规则 设置命令 AT+QETH='routing'[,,,,] 响应 若省略可选参数，则查询当前配置： +QETH: route IPv4: …… +QETH: route IPv6: …… OK 若指定可选参数，设置多路拨号的路由规则： OK 最大响应时间 特性说明 若有任何错误： ERROR 200 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。操作类型。 add 添加路由规则 del 删除路由规则 整型。IP 版本。 4 IPv4 6 IPv6 字符串类型。目标 IP 地址。 8.8.8.8 240C::6666 IPv4 示例 IPv6 示例 整型。RGMII 数据拨号配置文件 ID。 1–8 当前路由规则指定数据拨号连接使用的 APN 号。 举例 AT+QETH='routing' +QETH: route IPv4: Kernel IP routing table Destination Gateway default 10.151.9.244 10.151.9.240 * //查询当前路由列表。 Genmask Flags Metric Ref 0.0.0.0 UG 0 0 255.255.255.248 U 0 0 Use Iface 0 rmnet_data0 0 rmnet_data0 上海移远通信技术股份有限公司 241 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 61.132.163.68 * 255.255.255.255 UH 10 0 0 rmnet_data0 192.168.225.0 * 255.255.255.0 U 0 0 0 bridge0 202.102.213.68 * 255.255.255.255 UH 10 0 0 rmnet_data0 +QETH: route IPv6: Kernel IPv6 routing table Destination Next Hop Flags Metric Ref Use Iface ::1/128 :: U 256 1 0 lo 240e:46:4088::4088/128 :: U 10 1 0 rmnet_data0 240e:46:4888::4888/128 :: U 10 1 0 rmnet_data0 240e:9a:114:20dc::/64 :: U 1024 1 0 bridge0 fe80::/64 :: U 256 1 0 bridge0 fe80::/64 :: U 256 1 0 rmnet_data0 ::/0 :: U 256 1 0 rmnet_data0 ::/0 :: !n -1 1 1 lo ::1/128 :: Un 0 2 0 lo 240e:9a:114:20dc::/128 :: Un 0 2 0 rmnet_data0 240e:9a:114:20dc:6c57:8d2d:6bcd:7dca/128 :: Un 0 2 0 rmnet_data0 fe80::/128 :: Un 0 2 0 bridge0 fe80::/128 :: Un 0 2 0 rmnet_data0 fe80::1a20:8c46:9e00:c3ea/128 :: Un 0 3 1 rmnet_data0 fe80::cc53:9ff:fe13:1b87/128 :: Un 0 2 0 bridge0 ff00::/8 :: U 256 2 37 bridge0 ff00::/8 :: U 256 2 7 rmnet_data0 ::/0 :: !n -1 1 1 lo OK AT+QETH='routing',add,4,8.8.8.8,3 OK //添加路由列表。 12.7.4. AT+QETH='mac_address' 查询 RGMII 接口的 MAC 地址 该命令用于查询 RGMII 接口的 MAC 地址。 AT+QETH='mac_address' 查询 RGMII 接口的 MAC 地址 设置命令 AT+QETH='mac_address' 响应 +QETH: 'mac_address', 最大响应时间 特性说明 OK 200 毫秒 / 上海移远通信技术股份有限公司 242 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 字符串类型。RGMII 接口的 MAC 地址。 举例 AT+QETH='mac_address' //查询 RGMII 接口的 MAC 地址。 +QETH: 'mac_address',06:EA:9F:31:49:28 OK 12.7.5. AT+QETH='speed' 设置 RGMII 速率 该命令用于设置 RGMII 速率。 AT+QETH='speed' 设置 RGMII 速率 设置命令 AT+QETH='speed'[,] 响应 若省略可选参数，则查询当前配置： +QETH: 'speed', OK 若指定可选参数，配置 RGMII 速率： OK 最大响应时间 特性说明 若有任何错误： ERROR 100 毫秒 该命令在 RGMII 功能使能后生效； 参数配置自动保存。 参数 字符串类型。RGMII 速率。 '0M' 自动协商速率 '10M' 10 兆以太网 '100M' 100 兆以太网 '1000M' 1000 兆以太网 上海移远通信技术股份有限公司 243 / 277 举例 AT+QETH='speed' +QETH: 'speed','0M' //查询当前 RGMII 速率。 OK AT+QETH='speed','100M' OK //设置 RGMII 速率为 100 兆。 RG50xQ&RM5xxQ 系列 AT 命令手册 12.7.6. AT+QETH='an' 启用/禁用 RGMII 自动协商 该命令用于启用或禁用 RGMII 自动协商。 AT+QETH='an' 启用/禁用 RGMII 自动协商 设置命令 AT+QETH='an'[,] 响应 若省略可选参数，则查询当前配置： +QETH: 'an', OK 若指定可选参数，启用或禁用 RGMII 自动协商： OK 最大响应时间 特性说明 若有任何错误： ERROR 100 毫秒 该命令在 RGMII 功能使能后生效； 参数配置自动保存。 参数 字符串类型。启用或禁用 RGMII 自动协商。 'on' 启用 'off' 禁用 举例 AT+QETH='an' +QETH: 'an','on' OK AT+QETH='an','off' OK //查询当前配置。 //禁用 RGMII 自动协商。 上海移远通信技术股份有限公司 244 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 12.7.7. AT+QETH='dm' 设置 RGMII 双工模式 该命令用于设置 RGMII 双工模式。 AT+QETH='dm' 设置 RGMII 双工模式 设置命令 AT+QETH='dm'[,] 响应 若省略可选参数，则查询当前配置： +QETH: 'dm', OK 若指定可选参数，设置 RGMII 双工模式： OK 最大响应时间 特性说明 若有任何错误： ERROR 100 毫秒 该命令在 RGMII 功能使能后生效； 参数配置自动保存。 参数 字符串类型。RGMII 双工模式。 'full' 全双工模式 'half' 半双工模式 举例 AT+QETH='dm' +QETH: 'dm','full' OK AT+QETH='dm','half' OK //查询当前配置。 //设置 RGMII 双工模式为半双工模式。 12.7.8. AT+QETH='eth_driver' 选择待加载以太网驱动 该命令用于选择模块启动时加载的以太网驱动。 AT+QETH='eth_driver' 选择待加载以太网驱动 设置命令 响应 AT+QETH='eth_driver'[,,] 最大响应时间 特性说明 +QETH: 'eth_driver',, OK 若指定可选参数，则选择模块启动时加载的以太网驱动： +QETH: 'eth_driver',, OK 100 毫秒 该命令在 RGMII 功能使能后生效； 参数配置自动保存。 参数 字符串类型。以太网驱动名称。 整型。模块启动时是否加载指定的以太网驱动。 0 不加载 1 加载 举例 AT+QETH='eth_driver' +QETH: 'eth_driver','r8125',0 +QETH: 'eth_driver','r8168',1 //查询当前配置。 OK AT+QETH='eth_driver','r8168',0 OK //设置模块启动时不加载 r8168。 12.7.9. AT+QETH='eth_at' 使能/禁止通过以太网口收发 AT 命令 该命令用于使能或禁止通过以太网口收发 AT 命令。 AT+QETH='eth_at' 使能/禁止通过以太网口收发 AT 命令 设置命令 AT+QETH='eth_at'[,] 响应 若省略可选参数，则查询当前配置： +QETH: 'eth_at', OK 若指定可选参数，则使能或禁止通过以太网口收发 AT 命令： 上海移远通信技术股份有限公司 246 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 最大响应时间 特性说明 +QETH: 'eth_at', OK 100 毫秒 该命令在 RGMII 功能使能后生效； 参数配置自动保存。 参数 字符串类型。使能或禁用通过以太网口收发 AT 命令。 'enable' 使能 'disable' 禁用 举例 AT+QETH='eth_at' +QETH: 'eth_at','enable' OK AT+QETH='eth_at','disable' OK //查询当前配置。 //禁止通过以太网口收发 AT 命令。 12.8. AT+QGETCAPABILITY 获取 UE 支持的频段和 LTE 传输速率等级 该命令用于获取 UE 支持的频段和 LTE 传输速率等级，同时查询 UE 是否支持 CA。 AT+QGETCAPABILITY 获取 UE 支持的频段和 LTE 传输速率等级 查询命令 AT+ QGETCAPABILITY? 响应 +QGETCAPABILITY: NR:,,……, +QGETCAPABILITY: LTE-FDD:,,……, +QGETCAPABILITY: LTE-TDD:,,……, +QGETCAPABILITY: WCDMA:,,……, +QGETCAPABILITY: LTE-CATEGORY: +QGETCAPABILITY: LTE-CA: 最大响应时间 特性说明 OK 300 毫秒 / 上海移远通信技术股份有限公司 247 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 参数 字符串类型。支持的频段。 5G NR 中： n1 n2 … nn LTE/WCDMA 中： B1 Band 1 B2 Band 2 … Bn Band N 字符串类型。支持的 LTE 传输速率等级。 CAT1 Category 1 CAT2 Category 2 … CATn Category N 整型。UE 是否支持 LTE CA。 0 不支持 1 支持 举例 AT+QGETCAPABILITY? +QGETCAPABILITY: NR:n41,n79 +QGETCAPABILITY: LTE-FDD:B1,B2,B3,B4,B5,B7,B8,B28 +QGETCAPABILITY: LTE-TDD:B40 +QGETCAPABILITY: WCDMA:B1,B2,B5,B8 +QGETCAPABILITY: LTE-CATEGORY:CAT4 +QGETCAPABILITY: LTE-CA:0 //支持的 5G NR 频段。 //支持的 LTE-FDD 频段。 //支持的 LTE-TDD 频段。 //支持的 WCDMA 频段。 //支持 LTE Category 4。 //不支持 LTE CA。 OK 上海移远通信技术股份有限公司 248 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 13 附录 13.1. 术语缩写 表 6：术语缩写 缩写 3GPP 5GCN 5GS ADC AP APDU APN ARFCN ARM ASCII BB BCD BER BT CA 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 5G Core Network 5G 核心网 5G System 5G 系统 Analog To Digital Converter 模数转换器 Application Processor 应用处理器 Application Protocol Data Unit 应用协议数据单元 Access Point Name 接入点名称 Absolute Radio-Frequency Channel Number 绝对射频信道号 Advanced RISC (Reduced Instruction Set RISC（精简指令集）微处理器 Computing) Machine American Standard Code for Information 美国信息交换标准码 Interchange Baseband 基带 Binary-Coded Decimal 二进制编码的十进数 Bit Error Rate 误比特率 Bluetooth 蓝牙 Carrier Aggregation 载波聚合 上海移远通信技术股份有限公司 249 / 277 CBM CDRX CFU CLI CLIP CLIR COL COLP COLR CQI CS CSD CSI DCE DCS DFOTA DF DL DPCH DPR DSS DTE DTMF DTR EARFCN RG50xQ&RM5xxQ 系列 AT 命令手册 Cell Broadcast Message 小区广播消息 Connected Discontinuous Reception 连接态下非连续接收 Call Forwarding Unconditional 无条件呼转 Calling Line Identification 主叫线路识别 Calling Line Identification Presentation 主叫线路识别提示 Calling Line Identification Restriction 主叫线路识别限制 Connected Line 被叫线路 Connected Line Identification Presentation 被叫线路识别提示 Connected Line Identification Restriction 被叫线路识别限制 Channel Quality Indicator 信道质量指示 Circuit Switched/Circuit Switching 电路交换 Circuit Switched Data 电路交换数据 Channel State Information 信道状态信息 Data Communications Equipment 数据通信设备 Data Coding Scheme 数据编码方案 Delta Firmware Upgrade Over-The-Air 固件空中差分升级 Dedicated File 专用文件 Downlink 下行 Dedicated Physical Channel 专用物理信道 Dynamic Power Reduction 动态功率削减 Decision Support System 决策支持系统 Data Terminal Equipment 数据终端设备 Dual-Tone Multifrequency 双音多频 Data Terminal Ready 数据终端就绪 E-UTRA Absolute Radio Frequency Channel E-UTRA 绝对射频信道号 Number 上海移远通信技术股份有限公司 250 / 277 ECC ECT EFS eMLPP EN-DC EPS eUTRAN FDD FDN FDPCH FOTA GERAN GGSN GMT GPIO GPRS GPS GSM HCO HLR HSDPA HSUPA I2S IIC IMEI RG50xQ&RM5xxQ 系列 AT 命令手册 Emergency Communications Center 紧急通讯中心 Explicit Call Transfer 呼叫转接 Encrypting File System 加密文件系统 Enhanced Multi-Level Precedence Pre-emption Service E-UTRA NR Dual Connectivity and 增强型多级优先和抢占服务 以 4G 为主节点，5G 为辅节点的双 连接架构 Evolved Packet System 演进型分组系统 Evolved Universal Terrestrial Radio Access 演进型通用陆地无线接入网 Network Frequency Division Duplex 频分双工 Fixed Dialing Number 固定拨号 Fraction-Dedicated Physical Channel 部分专用物理信道 Firmware Upgrade Over-The-Air 固件空中升级 GSM/EDGE Radio Access Network GSM/EDGE 无线通讯网络 Gateway GPRS Support Node 网关 GPRS 支持节点 Greenwich Mean Time 格林威治时间 General-Purpose Input/Output 通用型输入/输出 General Packet Radio Service 通用分组无线业务 Global Positioning System 全球定位系统 Global System for Mobile Communications 全球移动通信系统 Hearing Carry-Over 只听不说 Home Location Register 归属位置寄存器 High Speed Downlink Packet Access 高速下行分组接入 High Speed Uplink Packet Access 高速上行分组接入 Inter-IC Sound 集成电路内置音频总线 Inter-Integrated Circuit 集成电路总线 International Mobile Equipment Identity 国际移动设备识别码 上海移远通信技术股份有限公司 251 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 IMS IMSI IPv4 IPv6 IRA ISDN ISIM IWF LLC LTE LTE CA LTE CAT MBN MCS ME MO MPTY MS MSC MSISDN MT MTU NAS NG-RAN NITZ IP Multimedia Subsystem IP 多媒体系统 International Mobile Subscriber Identity 国际移动用户识别码 Internet Protocol version 4 第 4 版互联网协议 Internet Protocol version 6 第 6 版互联网协议 International Reference Alphabet (7-bit coded 7-bit 国际参考字母编码字符集 character set) Integrated Services Digital Network 综合业务数字网 IP Multimedia Service Identity Module IP 多媒体服务身份模块 Interworking Function 互通功能 Logical Link Control 逻辑链路控制 Long-Term Evolution 长期演进 LTE Carrier Aggregation LTE 载波聚合 LTE Category LTE 传输速率等级 Modem Software Configuration Binary 调制解调器软件配置 Modulation and Coding Scheme 调制和编码方案 Mobile Equipment 移动设备 Mobile Original 移动主叫 MultiParty 多方通话 Mobile Station 移动台 Mobile Switching Center 移动交换中心 Mobile Subscriber International Integrated 移动台国际用户识别码 Service Digital Network number Mobile Terminal 移动终端 Maximum Transmission Unit 最大传输单元 Non-Access Stratum 非接入层 Next-Generation Radio Access Network 5G 无线网 Network Identity and Time Zone / Network 网络标识和时区 Informed Time Zone 上海移远通信技术股份有限公司 252 / 277 NR NSA NSAPI NSSAI NTC NVM OIR PA PCIe PCIe EP PCIe RC PCM PCO PDN PDP PDSCH PDU PIN PLMN PMI PMU PPP PS PSC PUK RG50xQ&RM5xxQ 系列 AT 命令手册 New Radio 新空口 Non-Standalone 非独立组网 Network Service Access Point Identifier 网络服务接入点标识符 Network Slice Information Selection Assistance 网络切片选择辅助信息 Negative Temperature Coefficient 负温度系数 Non-Volatile Memory 非易失性存储器 Originating Identification Restriction 主叫识别限制 Power Amplifier 功率放大器 Peripheral Component Interconnect Express 快捷外围部件互连标准 PCI Express Endpoint Device PCIe 端点设备 PCI Express Root Complex PCIe 根控制器 Pulse Code Modulation 脉冲编码调制 Protocol Configuration Options 协议配置选项 Public Data Network 公用数据网络 Packet Data Protocol 分组数据协议 Physical Downlink Shared CHannel 物理下行共享信道 Protocol Data Unit 协议数据单元 Personal Identification Number 个人识别号 Public Land Mobile Network 公共陆地移动网络 Precoding Matrix Indicator 预编码矩阵指示符 Power Management Unit 电源管理单元 Point-to-Point Protocol 点到点协议 Packet Switch 分组交换 Primary Scrambling Code 主扰码 PIN Unlock Key 个人识别密码解锁码 上海移远通信技术股份有限公司 253 / 277 QoS RAN RAT RGMII RI RLP RP RRC RSRP RSRQ RSSI RTC SA SAR SCC SINR SLIC SMS SMSC SNDCP S-NSSAI SSC SST TA TCP RG50xQ&RM5xxQ 系列 AT 命令手册 Quality of Service 服务质量 Radio Access Network 无线电接入网 Radio Access Technology 无线接入技术 Reduced Gigabit Media Independent Interface 吉比特介质独立接口 Ring Indicator 振铃指示 Radio Link Protocol 无线链路协议 Relay Protocol 中继协议 Radio Resource Control 无线资源控制 Reference Signal Received Power 参考信号接收功率 Reference Signal Received Quality 参考信号接收质量 Received Signal Strength Indicator 接收信号强度指示 Real-Time Clock 实时时钟 Standalone 独立组网 Specific Absorption Rate 比吸收率 Secondary Component Carrier 辅载波 Signal to Interference plus Noise Ratio 信号与干扰加噪声比 Subscriber Line Interface Circuit 用户线接口电路 Short Messaging Service 短消息业务 Short Message Service Center 短消息服务中心 Sub Network Dependence Convergence 子网相关汇聚协议 Protocol Single Network Slice Selection Assistance 单网络切片选择辅助信息 Information Session and Service Continuity 会话和服务连续模式 Slice/Service Type 切片/服务类型 Terminal Adapter 终端适配器 Transmission Control Protocol 传输控制协议 上海移远通信技术股份有限公司 254 / 277 TDD TE TFT TTY UAC UART UCS2 UDP UDUB UE UFS UICC UIM UL UMTS URC USB USSD (U)SIM UTRA UTRAN VCO VLR WCDMA WIM RG50xQ&RM5xxQ 系列 AT 命令手册 Time Division Duplex 时分双工 Terminal Equipment 终端设备 Traffic Flow Template 业务流模板 Teletype Terminals 虚拟终端 USB Audio Class USB 音频类 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Universal Character Set (UCS-2) Format 通用字符集格式 User Datagram Protocol 用户数据报协议 User Determined User Busy 用户决定用户忙 User Equipment 用户设备 Universal Flash Storage 通用闪存存储 Universal Integrated Circuit Card 通用集成电路卡 User Identity Module 用户识别模块 Uplink 上行链路 Universal Mobile Telecommunications System 通用移动通信系统 Unsolicited Result Code 非请求结果码 Universal Serial Bus 通用串行总线 Unstructured Supplementary Service Data 非结构化补充数据业务 (Universal) Subscriber Identity Module 全球用户识别模块 UMTS Terrestrial Radio Access UMTS 地面无线接入 Universal Terrestrial Radio Access Network 通用陆地无线接入网 Voice Carry-Over 只说不听 Visitor Location Register 拜访位置寄存器 Wideband Code Division Multiple Access 宽带码分多址 Wireless Identity Module 无线识别模块 上海移远通信技术股份有限公司 255 / 277 XO Crystal Oscillator 13.2. AT&F 影响到的 AT 命令及参数 表 7：AT&F 影响到的 AT 命令及参数 AT 命令 ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT+CREG AT+CGREG AT+CMEE AT+CSCS AT+CSTA AT+CR 参数名称 上海移远通信技术股份有限公司 RG50xQ&RM5xxQ 系列 AT 命令手册 晶体震荡器 默认值 1 0 0 13 10 8 2 0 2 15 1 4 0 0 1 'GSM' 129 0 256 / 277 AT+CRC AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+CVHU AT+CLIP AT+COLP AT+CLIR AT+CSSN AT+CTZR AT+CPBS AT+CGEREP AT+CEREG AT+CCWA AT+CUSD AT+CLVL AT+QAUDMOD AT+QAUDLOOP ,,, ,,, ,, ,, ,,,, , RG50xQ&RM5xxQ 系列 AT 命令手册 0 0,1,1,1 0 17,167,0,0 0 0,'','' 'ME','ME','ME' 2,1,0,0,0 0 0 0 0 0 0,0 0 'SM' 0,0 0 0 0 3 0 0 上海移远通信技术股份有限公司 257 / 277 13.3. AT&W 影响到的 AT 命令及参数 表 8：AT&W 影响到的 AT 命令及参数 AT 命令 参数名称 ATE ATQ ATS0 ATS7 ATS10 ATV ATX AT+CREG AT+CGREG AT+CEREG 13.4. ATZ 影响到的 AT 命令及参数 表 9：ATZ 影响到的 AT 命令及参数 AT 命令 ATE ATQ ATS0 ATS7 ATS10 参数名称 上海移远通信技术股份有限公司 RG50xQ&RM5xxQ 系列 AT 命令手册 是否通过 AT&V 显示 是 是 是 是 是 是 是 否 否 否 默认值 1 0 0 0 15 258 / 277 ATV ATX AT+CREG AT+CGREG AT+CEREG RG50xQ&RM5xxQ 系列 AT 命令手册 1 4 0 0 0 13.5. CME ERROR 错误码汇总 最终结果码+CME ERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果 码，同一命令行中未执行任一命令，则不会返回 ERROR 或 OK 结果码。 值常用于普通消息命令。下表列举了部分通用或 GPRS 相关 ERROR 码，此表不包含 GSM 规范 中描述的 GSM 协议错误相关错误码。 表 10：+CME ERROR: 错误码描述 错误码 0 1 2 3 4 5 6 7 10 11 12 13 英文含义 Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required (U)SIM failure 中文含义 拨打电话失败 电话未连接 保留电话适配器连接 操作不允许 操作不支持 需要 PH SIM 卡 PIN 码 需要 PH FSIM 卡 PIN 码 需要 PH FSIM 卡 PUK 码 未插入(U)SIM 卡 需要(U)SIM 卡 PIN 码 需要(U)SIM 卡 PUK 码 (U)SIM 卡失败 上海移远通信技术股份有限公司 259 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 14 (U)SIM busy (U)SIM 卡忙 15 (U)SIM wrong (U)SIM 卡错误 16 Incorrect password 密码不正确 17 (U)SIM PIN2 required 需要(U)SIM 卡 PIN2 码 18 (U)SIM PUK2 required 需要(U)SIM 卡 PUK2 码 20 Memory full 内存已满 21 Invalid index 无效索引 22 Not found 未发现 23 Memory failure 内存不足 24 Text string too long 文本字符过长 25 Invalid characters in text string 无效文本字符 26 Dial string too long 拨号字符过长 27 Invalid characters in dial string 无效拨号字符 30 No network service 无网络服务 31 Network timeout 网络超时 32 Network not allowed - emergency calls only 网络不允许-仅支持紧急通话 40 Network personalization PIN required 需要网络个性化 PIN 41 Network personalization PUK required 需要网络个性化 PUK 42 Network subset personalization PIN required 需要网络子集个性化 PIN 43 Network subset personalization PUK required 需要网络子集个性化 PUK 44 Service provider personalization PIN required 需要网络服务商个性化 PIN 45 Service provider personalization PUK required 需要网络服务商个性化 PUK 46 Corporate personalization PIN required 需要企业个性化 PIN 47 Corporate personalization PUK required 需要企业个性化 PUK 901 Audio unknown error 音频未知错误 902 Audio invalid parameters 音频参数错误 903 Audio operation is not supported 音频操作不支持 904 Audio device is busy 音频设备繁忙 上海移远通信技术股份有限公司 260 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 13.6. CMS ERROR 错误码汇总 最终结果码+CMS ERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果码， 同一命令行中未执行任一命令，则不会返回 ERROR 或 OK 结果码。值常用于普通消息命令。 表 11：+CMS ERROR: 错误码描述 错误码 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 331 332 英文含义 ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode (U)SIM not inserted (U)SIM pin necessary PH (U)SIM pin necessary (U)SIM failure (U)SIM busy (U)SIM wrong (U)SIM PUK required (U)SIM PIN2 required (U)SIM PUK2 required Memory failure Invalid memory index Memory full SMSC address unknown No network Network timeout 中文含义 ME 失败 保留 SMS ME 操作不允许 操作不支持 无效 PDU 模式 无效文本模式 未插入(U)SIM 卡 需要(U)SIM 卡 PIN 码 需要 PH (U)SIM 卡 PIN 码 (U)SIM 卡失败 (U)SIM 卡忙 (U)SIM 卡错误 需要(U)SIM PUK 需要(U)SIM PIN2 需要(U)SIM PUK2 内存不足 无效内存索引 内存已满 未知 SMSC 地址 无网络 网络超时 上海移远通信技术股份有限公司 261 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 340 Not expected 发生了未预期的错误 500 Unknown 未知原因 512 (U)SIM not ready (U)SIM 卡未就绪 513 Message length exceeds 消息长度超出范围 514 Invalid request parameters 请求的参数无效 515 ME storage failure ME 内存失败 517 Invalid service mode 无效服务模式 528 More message to send state error 消息发送状态错误 529 MO SMS is not allowed 不允许主动发送 SMS 531 ME storage full ME 内存满 13.7. URC 汇总 表 12：URC 汇总 序号 1 2 3 4 5 6 7 8 9 10 URC 含义 条件 +QUSIM: 1 指示(U)SIM 卡初始化状态 NA +QSIMSTAT: , 指示(U)SIM 卡的插拔状态 AT+QSIMSTAT=1 +CREG: 指示 MT 注册状态 AT+CREG=1 +CREG: [,,[,< 邻区更改后，指示当前网络是否已使用 AcT>]] 位置区号指示了 MT 的注册状态 AT+CREG=2 +CGREG: 指示 MT 网络注册状态 AT+CGREG=1 +CGREG: [,[],[],[],[]] 指示 MT 网络注册状态和位置信息 AT+CGREG=2 +CEREG: 指示 EPS 网络注册状态的变化 AT+CEREG=1 +CEREG: [,,[, 指示 E-UTRAN 中的网络小区的变化 AT+CEREG=2 ]] +C5GREG: 指示 5GS 中的网络注册状态的变化 AT+C5GREG=1 +C5GREG: [,[],[],[],[],[]] 11 +CTZV: 时区上报 AT+CTZR=1 12 +CTZE: ,, 扩展时区上报 AT+CTZR=2 13 +CMTI: , 收到新的短消息并保存至内存 See AT+CNMI +CMT: [], （PDU 模式） See AT+CNMI +CMT: ,[], [,,,,,,,] 16 +CBM: +CBM: ,,,, 18 +CDS: 19 +CDS: ,,[],[],,, 20 +CDSI: , 收到新的消息状态报告，并保存到内存 See AT+CNMI 21 +COLP: ,,[],[],[] +CLIP: ,,[sub 22 addr],[satype],[], 23 +CRING: 通过非请求结果码而非正常 RING 向 TE 指示来电 AT+CRC=1 +CCWA: ,,[,][, 呼叫等待指示 [,,[,]]] 25 +CSSI: 向 TE 指示+CSSI 中间结果码显示状态 AT+CSSN=1 26 +CSSU: 向 TE 指示+CSSU 非请求结果码显示 状态 AT+CSSN=,1 27 RDY MT 初始化成功 N/A 28 +CFUN: 1 MT 的所有功能均可用 N/A 29 +CPIN: (U) SIM 卡引脚状态 N/A 上海移远通信技术股份有限公司 263 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 30 +QIND: SMS DONE SMS 初始化完成 N/A 31 +QIND: PB DONE 电话簿初始化完成 N/A 32 +CPIN: NOT READY (U)SIM 卡未就绪 N/A 33 POWERED DOWN 模块掉电 AT+QPOWD 34 +CGEV: REJECT , 35 +CGEV: NW REACT ,,[] AT+CGEREP=2,1 36 +CGEV: NW DEACT ,,[] AT+CGEREP=2,1 37 +CGEV: ME DEACT ,,[] AT+CGEREP=2,1 38 +CGEV: NW DETACH 网络强制去附着分组域 AT+CGEREP=2,1 39 +CGEV: ME DETACH ME 强制去附着分组域 AT+CGEREP=2,1 40 +CGEV: NW CLASS 网络强制更改 MS 类别 AT+CGEREP=2,1 41 +CGEV: ME CLASS ME 强制更改 MS 类别 AT+CGEREP=2,1 42 +QIND: 'csq',, 信号强度和信道误码率改变 AT+QINDCFG='csq' ,1 43 +QIND: 'smsfull', SMS 存储已满 AT+QINDCFG='smsf ull',1 44 RING 来电提醒 AT+QINDCFG='ring' ,1 45 +QIND: 'act', 网络接入技术改变 AT+QINDCFG='act', 1 46 ^DSCI: ,,,,, AT^DSCI=1 +CLIP: ,,[sub 47 addr],[satype],[], 48 +CUSD: [,,[< 网络下发 USSD 响应或网络发起操作 AT+CUSD=1 dcs>]] 49 +QIND: 'SLIC Hook off' 摘机事件 AT+QAUDCFG='slic _IndRep',1 50 +QIND: 'SLIC DTMF', 按键事件 AT+QAUDCFG='slic _IndRep',1 51 +QIND: 'SLIC Flash Key' 闪断事件 AT+QAUDCFG='slic _IndRep',1 上海移远通信技术股份有限公司 264 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 13.8. SMS 字符集转换 3GPP TS 23.038 DCS（数据编码方案）中针对 SMS 定义了三种字母表：GSM 7-bit 默认字母，8-bit 数据和 UCS2（16-bit）。AT+CSMP 用于文本模式（AT+CMGF=1）下设置 DCS。文本模式下，DCS 和 AT+CSCS 决定 SMS 文本输入和输出的方式。 表 13：SMS 文本输入和输出方式 DCS GSM 7-bit GSM 7-bit GSM 7-bit UCS2 8-bit AT+CSCS GSM IRA UCS2 - SMS 文本输入和输出方式 输入或输出 GSM 字符集 输入或输出 IRA 字符集。 输入：UE 将 IRA 字符转换为 GSM 字符。 输出：UE 将 GSM 字符转换为 IRA 字符。 输入或输出类似于 PDU 模式的十六进制字符串。因此，仅支持字符 0–9 和 A–F。 输入：UE 将 UCS2 十六进制字符串转换为 GSM 字符。 输出：UE 将 GSM 字符转换为 UCS2 十六进制字符串。 忽略 AT+CSCS 值，输入或输出类似于 PDU 模式的十六进制字符串。 仅支持字符 0–9 和 A–F。 忽略 AT+CSCS 值，输入或输出类似于 PDU 模式的十六进制字符串。 仅支持字符 0–9 和 A–F。 当 DCS 为 GSM 7-bit 时，需要进行输入或输出转换。详情参考下表。 表 14：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） 序号 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 上海移远通信技术股份有限公司 265 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0A Submit 2A 3A 4A 5A 6A 7A B 0B Cancel 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F 表 15：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='GSM'） 序号 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B 0B 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C 上海移远通信技术股份有限公司 266 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F 表 16：GSM 扩展字符（GSM 编码） 序号 0 1 2 3 4 5 6 7 0 1B40 1 2 3 4 1B14 5 6 7 8 1B28 9 1B29 A B C 1B3C D 1B3D E 1B3E F 1B2F 表 17：输入转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'） 序号 0 0 1 2 3 4 5 6 7 20 20 30 00 50 20 70 上海移远通信技术股份有限公司 267 / 277 1 20 20 21 31 2 20 20 22 32 3 20 20 23 33 4 20 20 02 34 5 20 20 25 35 6 20 20 26 36 7 20 20 27 37 8 backspace 20 28 38 9 20 20 29 39 A 0A Submit 2A 3A B 20 Cancel 2B 3B C 20 20 2C 3C D 0D 20 2D 3D E 20 20 2E 3E F 20 20 2F 3F 表 18：IRA 扩展字符 序号 A B C 0 20 20 20 1 40 20 20 2 20 20 20 3 01 20 20 4 24 20 5B 5 03 20 0E 6 20 20 1C 7 5F 20 09 8 20 20 20 RG50xQ&RM5xxQ 系列 AT 命令手册 41 51 61 71 42 52 62 72 43 53 63 73 44 54 64 74 45 55 65 75 46 56 66 76 47 57 67 77 48 58 68 78 49 59 69 79 4A 5A 6A 7A 4B 1B3C 6B 1B28 4C 1B2F 6C 1B40 4D 1B3E 6D 1B29 4E 1B14 6E 1B3D 4F 11 6F 20 D E F 20 7F 20 5D 20 7D 20 20 08 20 20 20 20 7B 20 20 0F 20 5C 1D 7C 20 20 20 0B 04 0C 上海移远通信技术股份有限公司 268 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 9 20 20 1F 20 05 06 A 20 20 20 20 20 20 B 20 20 20 20 20 20 C 20 20 20 5E 07 7E D 20 20 20 20 20 20 E 20 20 20 20 20 20 F 20 60 20 1E 20 20 表 19：输出转换表（DCS 为 GSM 7-bit 且 AT+CSCS='IRA'） 序号 0 1 2 3 4 5 6 7 0 40 20 20 30 A1 50 BF 70 1 A3 5F 21 31 41 51 61 71 2 24 20 22 32 42 52 62 72 3 A5 20 23 33 43 53 63 73 4 E8 20 A4 34 44 54 64 74 5 E9 20 25 35 45 55 65 75 6 F9 20 26 36 46 56 66 76 7 EC 20 27 37 47 57 67 77 8 F2 20 28 38 48 58 68 78 9 C7 20 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B D8 2B 3B 4B C4 6B E4 C F8 C6 2C 3C 4C D6 6C F6 D 0D E6 2D 3D 4D D1 6D F1 E C5 DF 2E 3E 4E DC 6E FC F E5 C9 2F 3F 4F A7 6F E0 上海移远通信技术股份有限公司 269 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 表 20：GSM 扩展字符（ISO-8859-1/Unicode） 序号 0 1 2 3 4 5 6 7 0 7C 1 2 3 4 5E 5 6 7 8 7B 9 7D A B C 5B D 7E E 5D F 5C 由于 UCS2 字符集的低 8 位与 IRA 字符相同，所以： ⚫ DCS 等于 GSM 7-bit 且 AT+CSCS='UCS2'转换表与 AT+CSCS='IRA'相似。 ⚫ fmt 等于 GSM 7-bit 且 AT+CSCS='GSM'转换表与 AT+CSCS='GSM'相似。 ⚫ fmt 等于 GSM 7-bit 且 AT+CSCS='IRA'转换表与 AT+CSCS='IRA'相似。 ⚫ fmt 等于 GSM 7-bit 且 AT+CSCS='UCS2'转换表与 AT+CSCS='IRA'相似。 SMS 文本输入或输出的方式差异详情参考表 13。 上海移远通信技术股份有限公司 270 / 277 13.9. AT+CEER 扩展错误报告列表 RG50xQ&RM5xxQ 系列 AT 命令手册 表 21：AT+CEER 扩展错误报告列表 CS Internal Cause No cause information available (default) Phone is offline No service available Network release, no reason given Received incoming call Client ended call UIM not present Access attempt already in progress Access failure, unknown source Concur service not supported by network No response received from network GPS call ended for user call SMS call ended for user call Data call ended for emergency call Rejected during redirect or handoff Lower-layer ended call Call origination request failed Client rejected incoming call Client rejected setup indication Network ended call No funds available CS 域内部原因 无原因信息 电话脱机 无服务 网络释放，未指明原因 接听来电 客户端结束通话 UIM 不存在 接入尝试已存在 接入失败，未知源 网络不支持 Concur 服务 未接收到网络响应 终止 GPS 呼叫以支持用户呼叫 终止短消息呼叫以支持用户呼叫 终止数据呼叫以支持紧急呼叫 转接或切换时被拒绝 底层结束通话 主叫请求失败 客户端拒绝来电 客户端拒绝设置指示 网络结束通话 无可用资金 上海移远通信技术股份有限公司 271 / 277 No service available Full service not available Maximum packet calls exceeded Video connection lost Video protocol closed after setup Video protocol setup failure Internal error CS Network Cause Unassigned/unallocated number No route to destination Channel unacceptable Operator determined barring Normal call clearing User busy No user responding User alerting, no answer Call rejected Number changed Non selected user clearing Destination out of order Invalid/incomplete number Facility rejected Response to status enquiry Normal, unspecified No circuit/channel available 上海移远通信技术股份有限公司 RG50xQ&RM5xxQ 系列 AT 命令手册 无服务 全服务不可用 超过最大分组通话数 视频连接断开 视频协议设置后被关闭 视频协议设置失败 内部错误 CS 域网络原因 未分配的号码（空号） 无至目的地的路由 不可接受的信道 运营者决定的闭锁业务 正常呼叫清除 用户忙 无用户响应 用户振铃，无应答 呼叫被拒绝 号码改变 非选定用户清除 终点故障 无效/不完全的号码 设施被拒绝 对状态询问的响应 正常，未指定 无电路/信道可用 272 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 Network out of order Temporary failure Switching equipment congestion Access information discarded Requested circuit/channel not available Resources unavailable, unspecified Quality of service unavailable Requested facility not subscribed Incoming calls barred within the CUG Bearer capability not authorized Bearer capability not available Service/option not available Bearer service not implemented ACM >= ACM max Requested facility not implemented Only RDI bearer is available Service/option not implemented Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state 网络故障 临时故障 交换设备拥塞 接入信息被丢弃 请求的电路/信道不可用 资源不可用，未指定 服务质量不可用 请求设备未预定 CUG 内的来电阻断 承载容量未批准 承载容量当前不可用 服务/选择不可用 承载服务未实施 ACM 等同或大于 ACM max 请求设备未实施 仅 RDI 承载可用 服务/选择未实施 无效交易标识符 用户非 CUG 成员 不兼容的目的地 无效转接网选择 语义错误消息 无效强制信息 消息不存在或未实施 消息类型与协议状态不兼容 上海移远通信技术股份有限公司 273 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 IE non-existent/not implemented Conditional IE error Message not compatible with state Recovery on timer expiry Protocol error, unspecified Interworking, unspecified CS Network Reject 信息元素不存在或未实施 条件 IE 错误 消息与协议状态不兼容 计时器到时恢复 协议错误，未指定 互通，未指定 CS 域网络拒绝 IMSI unknown in HLR HLR 未定义该 IMSI Illegal MS 非法 MS IMSI unknown in VLR VLR 未定义该 IMSI IMEI not accepted 不可接受的 IMEI Illegal ME 非法 ME GPRS services not allowed 不允许的 GPRS 服务 GPRS and non GPRS services not allowed 不允许的 GPRS 及非 GPRS 服务 MS identity cannot be derived 无法获取用户身份 Implicitly detached 用户隐式分离 PLMN not allowed 不允许的 PLMN Location area not allowed 不允许的位置区域 Roaming not allowed 不允许漫游 GPRS services not allowed in PLMN 当前的 PLMN 不允许 GPRS 服务 No suitable cells in location area 本位置区不存在匹配的小区 MSC temporary not reachable MSC 暂时不可达 Network failure 网络错误 MAC failure MAC 错误 Synch failure 同步失败 上海移远通信技术股份有限公司 274 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 Congestion GSM authentication unacceptable Service option not supported Requested service option not subscribed Service option temporary out of order Call cannot be identified No PDP context activated Semantically incorrect message Invalid mandatory information Message type non-existent Message type not compatible with state Information element non-existent Message not compatible with state RR release indication RR random access failure RRC release indication RRC close session indication RRC open session failure Low level failure Low level failure no redial allowed Invalid SIM No service Timer T3230 expired No cell available Wrong state 拥塞 GSM 鉴权失败 不支持的服务选择 为预定请求的服务选择 服务选择暂时故障 呼叫无法识别 无激活的 PDP 上下文 语义错误消息 无效强制信息 消息类型不存在 消息类型与协议状态不兼容 信息元素不存在 消息与协议状态不兼容 RR 释放指示 RR 随机接入失败 RRC 释放指示 RRC 关闭会话指示 RRC 打开会话失败 底层错误 底层错误，不允许重拨 无效 SIM 卡 无服务 定时器 T303 过期 无小区可用 错误状态 上海移远通信技术股份有限公司 275 / 277 Access class blocked Abort message received Other cause Timer T303 expired No resources Release pending Invalid user data PS Internal Cause Invalid connection identifier Invalid NSAPI Invalid primary NSAPI PDP establish timeout Invalid field SNDCP failure RAB setup failure No GPRS context PDP activate timeout PDP modify timeout PDP inactive max timeout PDP lower layer error PDP duplicate Access technology change PDP unknown reason CS PS Network Cause LLC or SNDCP failure 上海移远通信技术股份有限公司 RG50xQ&RM5xxQ 系列 AT 命令手册 接入类型受阻 接收到中止消息 其他原因 定时器 T303 过期 无资源 待释放 无效用户数据 PS 域内部原因 无效连接标识符 无效 NSAPI 无效首选 NSAPI PDP 创建超时 无效字段 SNDCP 失败 RAB 设置失败 无 GPRS 上下文 PDP 激活超时 PDP 修改超时 PDP 不活跃最大时间超时 PDP 底层错误 PDP 重复 接入技术改变 PDP 未知原因 CS/PS 域网络原因 LLC 或 SDNCP 错误 276 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 Insufficient resources 资源不足 Missing or unknown APN 丢失或未知 APN Unknown PDP address or PDP type 未知 PDP 地址或 PDP 类型 User authentication failed 用户鉴权失败 Activation rejected by GGSN 激活请求被 GGSN 拒绝 Activation rejected, unspecified 激活请求被拒绝，未指定 Service option not supported 不支持的服务选择 Requested service option not subscribed 未预定请求的服务选择 Service option temporary out of order 服务选择暂时故障 NSAPI already used (not sent) NSAPI 已被占用（未发送） Regular deactivation 常规去激活 QoS not accepted 不接受的服务质量 Network failure 网络错误 Reactivation required 需重新激活 Feature not supported 功能不支持 Semantic error in the TFT operation TFT 操作语义错误 Syntactical error in the TFT operation TFT 操作语法错误 Unknown PDP context 未知 PDP 上下文 PDP context without TFT already activated 无 TFT 的 PDP 上下文已被激活 Semantic errors in packet filter 分组过滤器语义错误 Syntactical errors in packet filter 分组过滤器语法错误 Invalid transaction identifier 无效交易标识符 Semantically incorrect message 语义错误信息 Invalid mandatory information 无效强制信息 Message non-existent/not implemented 消息不存在或未实施 上海移远通信技术股份有限公司 277 / 277 RG50xQ&RM5xxQ 系列 AT 命令手册 Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Protocol error, unspecified 消息类型与协议状态不兼容 信息元素不存在或未实施 条件 IE 错误 消息与协议状态不兼容 协议错误，未指定 上海移远通信技术股份有限公司 278 / 277

WCDMA UGxx AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_AT_Commands_Manual_V1.7 Date: 2016-05-05 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 1 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual About the Document History Revision 1.0 1.1 1.2 1.3 1.4 1.5 Date 2014-08-28 ctel l 2014-12-10 Quefidentia 2015-03-01 Con 2015-04-01 Author Laguna XU/ Wythe WANG Roddick SUN/ Yolanda YAO/ Jessica GENG Bonnie ZHAO/ Jesse ZHANG Jesse ZHANG Description Initial 1. Added AT Commands: ATS4/ATS3/+GOI/+QRIR/+QCFG/+QCCID/ +QSIMSTAT/+QSIMDET/+CTZR/+CTZU/ +QLTS/+QECCNUM/+QSCLK/+CALM/+CRSL/ +QAUDLOOP/+QDAC/+QLTONE/+QLDTMF/ +QWDTMF 2. Modified AT Commands: +VTS/+VTD/+CGDCONT/+CPBR 3. Updated the description of URC 1. Changed the document name from 'UG95' to 'UGxx' 2. Added AT Commands: +QCMGS/+QCMGR/+QCFG='nwscanmode'/ +QCFG='fota/cid'/+QCFG='ussd/textescape'/ +QCFG='sms/textescape' Updated applicable modules 1. Updated the description of +QSCLK 2. Added description in +CPBF and 2015-05-21 Jesse ZHANG +CPBW 3. Added AT Commands: +QCFG='vbatt'/+QCFG='temp'/ +QCFG='remoteip' 1. Added AT Commands: 2015-08-18 Roddick SUN/ Sophie ZHU/ +QGPCLASS/+QGDCNT/+QAUGDCNT/ +CIND/+QCFG='stateurc/enable'/+QMIC/ +QAUDMOD/+QAUDCFG/+QSIDET/ +QAUDGAIN/+QCLKOUT/+QPCMON/+QIIC WCDMA_UGxx_AT_Commands_Manual Confidential / Released 2 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2. Removed +CLVL/+CMUT from Table 7 1. Added AT Commands: +QGAUTH/+QALARM/+QTEMP 1.6 2016-01-27 Roddick SUN 2. Added the note for auto save commands 3. Modified the description of +QAUDCFG/ +QDAC/+QECCNUM/+QCFG 1. Added AT Commands: +QCFG='ppp/firstreqintr'/+QCFG='sms/listmsg 1.7 2016-05-05 Sophie ZHU map' 2. Added mode 3 to CTZU CQouneficdteenl tial WCDMA_UGxx_AT_Commands_Manual Confidential / Released 3 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 9 1 Introduction ........................................................................................................................................ 10 1.1. Scope of the Document......................................................................................................... 10 1.2. AT Command Syntax............................................................................................................. 10 1.3. Supported Character Sets..................................................................................................... 11 1.4. AT Command Interface.......................................................................................................... 11 1.5. Unsolicited Result Code ........................................................................................................ 12 2 1.6. Turn off Procedure................................................................................................................. 12 General Commands ........................................................................................................................... 13 2.1. ATI Display Product Identification Information.................................................................... 13 l 2.2. AT+GMI Request Manufacturer Identification .................................................................... 14 2.3. AT+GMM Request TA Model Identification......................................................................... 14 te 2.4. AT+GMR Request TA Revision Identification of Software Release ................................... 14 2.5. AT+GOI Request Global Object Identification .................................................................... 15 c l 2.6. AT+CGMI Request Manufacturer Identification.................................................................. 16 ue tia 2.7. AT+CGMM Request Model Identification ...........................................................................16 2.8. AT+CGMR Request TA Revision Identification of Software Release................................. 17 2.9. AT+GSN Request International Mobile Equipment Identity (IMEI) .................................... 17 Q n 2.10. AT+CGSN Request Product Serial Number Identification ................................................. 18 2.11. AT&F Set All Current Parameters to Manufacturer Defaults .............................................. 18 e 2.12. AT&V Display Current Configuration .................................................................................. 19 2.13. AT&W Store Current Parameters to User Defined Profile.................................................. 20 fid 2.14. ATZ Set all Current Parameters to User Defined Profile.................................................... 20 2.15. ATQ Set Result Code Presentation Mode .......................................................................... 21 2.16. ATV TA Response Format .................................................................................................. 22 n 2.17. ATE Set Command Echo Mode.......................................................................................... 23 2.18. A/ Repeat Previous Command Line ................................................................................... 24 o 2.19. ATS3 Set Command Line Termination Character .............................................................. 24 C 2.20. ATS4 Set Response Formatting Character ........................................................................ 25 2.21. ATS5 Set Command Line Editing Character ...................................................................... 25 2.22. ATX Set CONNECT Result Code Format and Monitor Call Progress ............................... 26 2.23. AT+CFUN Set Phone Functionality .................................................................................... 27 2.24. AT+CMEE Error Message Format...................................................................................... 28 2.25. AT+CSCS Select TE Character Set ................................................................................... 30 3 Serial Interface Control Commands ................................................................................................ 31 3.1. AT&C Set DCD Function Mode .......................................................................................... 31 3.2. AT&D Set DTR Function Mode........................................................................................... 31 3.3. AT+IFC Set TE-TA Local Data Flow Control....................................................................... 32 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 4 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 3.4. AT+IPR Set TE-TA Fixed Local Rate.................................................................................. 33 3.5. AT+QRIR Restore Ring Line to Inactive ............................................................................. 34 4 Status Control Commands ............................................................................................................... 36 4.1. AT+CPAS Mobile Equipment Activity Status ...................................................................... 36 4.2. AT+CEER Extended Error Report ...................................................................................... 37 4.3. AT+QCFG Extended Configuration Settings ...................................................................... 38 4.3.1. AT+QCFG='urc/port' List All Port(s) or Disable URC of a Specified Port .................. 40 4.3.2. AT+QCFG='uart/power' Turn on/off the UART Port................................................... 40 4.3.3. AT+QCFG='urc/ri/ring' Ring Line Behavior of RING.................................................. 41 4.3.4. AT+QCFG='urc/ri/smsincoming' Ring Line Behavior of Incoming SMS .................... 43 4.3.5. AT+QCFG='urc/ri/other' Ring Line Behavior of Other URCs..................................... 44 4.3.6. AT+QCFG='urc/delay' Delay URC Indication ............................................................ 45 5 4.3.7. AT+QCFG='tone/incoming' Enable/Disable Ring Tone ............................................. 45 4.3.8. AT+QCFG='nwscanmode' Network Search Mode Configuration.............................. 46 4.3.9. AT+QCFG='vbatt' Voltage Detection ......................................................................... 47 4.3.10. AT+QCFG='temp' Temperature Detection ................................................................. 49 l 4.3.11. AT+QCFG='fota/cid' DFOTA Context ID Configuration ............................................. 51 4.3.12. AT+QCFG='ussd/textescape' Character Escape of USSD Text ............................... 52 te 4.3.13. AT+QCFG='sms/textescape' Character Escape of SMS Text................................... 53 c l 4.3.14. AT+QCFG='remoteip' Enable/Disable Remote IP Function...................................... 54 4.3.15. AT+QCFG= 'ppp/firstreqintr' Extension Configuration............................................... 55 ue tia 4.3.16. AT+QCFG='stateurc/enable' Enable/Disable State URC Indication..........................56 4.3.17. AT+QCFG='sms/listmsgmap' List the Message Map ................................................ 57 4.4. AT+QINISTAT Query Initialization State ............................................................................. 59 Q n 4.5. AT+CIND Command of Control Instructions....................................................................... 60 4.6. AT+QTEMP Temperature Detection ................................................................................... 61 e SIM Related Commands .................................................................................................................... 62 fid 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) .................................... 62 5.2. AT+CLCK Facility Lock ....................................................................................................... 63 5.3. AT+CPIN Enter PIN ............................................................................................................ 65 n 5.4. AT+CPWD Change Password............................................................................................ 67 5.5. AT+CSIM Generic SIM Access ........................................................................................... 68 o 5.6. AT+CRSM Restricted SIM Access...................................................................................... 69 C 5.7. AT+QCCID Show ICCID ..................................................................................................... 70 5.8. AT+QSIMDET SIM Card Detection .................................................................................... 71 5.9. AT+QSIMSTAT SIM Inserted Status Report ....................................................................... 72 6 Network Service Commands ............................................................................................................ 74 6.1. AT+COPS Operator Selection ............................................................................................ 74 6.2. AT+CREG Network Registration ........................................................................................ 76 6.3. AT+CSQ Signal Quality Report .......................................................................................... 77 6.4. AT+CPOL Preferred Operator List...................................................................................... 79 6.5. AT+COPN Read Operator Names...................................................................................... 80 6.6. AT+CTZU Automatic Time Zone Update............................................................................ 81 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 5 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 6.7. AT+CTZR Time Zone Reporting ......................................................................................... 82 6.8. AT+QLTS Obtain the Latest Network Time Synchronization.............................................. 84 6.9. AT+QGPCLASS Change GPRS Multi-slot Class............................................................... 85 7 Call Related Commands.................................................................................................................... 87 7.1. ATA Answer an Incoming Call............................................................................................. 87 7.2. ATD Mobile Originated Call to Dial a Number .................................................................... 88 7.3. ATH Disconnect Existing Connection ................................................................................. 90 7.4. AT+CVHU Voice Hang up Control ...................................................................................... 90 7.5. AT+CHUP Hang up Call ..................................................................................................... 91 7.6. +++ Switch from Data Mode to Command Mode ............................................................... 91 7.7. ATO Switch from Command Mode to Data Mode .............................................................. 92 7.8. ATS0 Set Number of Rings before Automatically Answering Call...................................... 93 8 9 7.9. 7.10. 7.11. 7.12. l 7.13. 7.14. te 7.15. c l 7.16. 7.17. ue tia 7.18. 7.19. 7.20. ATS6 Set Pause before Blind Dialing ................................................................................. 94 ATS7 Set Number of Seconds to Wait for Connection Completion ................................... 94 ATS8 Set the Number of Seconds to Wait for Comma Dial Modifier ................................. 95 ATS10 Set Disconnect Delay after Indicating the Absence of Data Carrier....................... 96 AT+CBST Select Bearer Service Type ............................................................................... 96 AT+CSTA Select Type of Address ...................................................................................... 98 AT+CLCC List Current Calls of ME .................................................................................... 99 AT+CR Service Reporting Control.................................................................................... 100 AT+CRC Set Cellular Result Codes for Incoming Call Indication .................................... 101 AT+CRLP Select Radio Link Protocol Parameter ............................................................ 102 AT+QHUP Hang up Call with a Specific Release Cause ................................................. 103 AT+QECCNUM Configure Emergency Call Numbers...................................................... 104 Q n Phonebook Commands................................................................................................................... 107 e 8.1. AT+CNUM Subscriber Number ........................................................................................ 107 8.2. AT+CPBF Find Phonebook Entries .................................................................................. 108 fid 8.3. AT+CPBR Read Phonebook Entries ................................................................................ 109 8.4. AT+CPBS Select Phonebook Memory Storage ............................................................... 110 8.5. AT+CPBW Write Phonebook Entry ...................................................................................111 n Short Message Service Commands............................................................................................... 113 o 9.1. AT+CSMS Select Message Service ................................................................................. 113 C 9.2. AT+CMGF Message Format............................................................................................. 114 9.3. AT+CSCA Service Center Address................................................................................... 115 9.4. AT+CPMS Preferred Message Storage............................................................................ 116 9.5. AT+CMGD Delete Message ............................................................................................. 118 9.6. AT+CMGL List Messages ................................................................................................. 119 9.7. AT+CMGR Read Message ............................................................................................... 122 9.8. AT+CMGS Send Message ............................................................................................... 126 9.9. AT+CMMS More Messages to Send ................................................................................ 127 9.10. AT+CMGW Write Message to Memory ............................................................................ 128 9.11. AT+CNMA New Message Acknowledgement to UE/TE................................................... 130 9.12. AT+CNMI SMS Event Reporting Configuration................................................................ 132 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 6 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 9.13. 9.14. 9.15. 9.16. 9.17. AT+CSCB Select Cell Broadcast Message Types ........................................................... 134 AT+CSDH Show SMS Text Mode Parameters................................................................. 135 AT+CSMP Set SMS Text Mode Parameters .................................................................... 136 AT+QCMGS Send Concatenated Messages ................................................................... 137 AT+QCMGR Read Concatenated Messages................................................................... 139 10 Packet Domain Commands ............................................................................................................ 141 10.1. AT+CGATT Attachment or Detachment of PS.................................................................. 141 10.2. AT+CGDCONT Define PDP Context ................................................................................ 142 10.3. AT+CGQREQ Quality of Service Profile (Requested)...................................................... 144 10.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable)....................................... 146 10.5. AT+CGEQREQ 3G Quality of Service Profile (Requested) ............................................. 149 10.6. AT+CGEQMIN 3G Quality of Service Profile (Minimum Acceptable) .............................. 153 11 12 10.7. 10.8. 10.9. 10.10. l 10.11. 10.12. te 10.13. c l 10.14. 10.15. ue tia 10.16. AT+CGACT Activate or Deactivate PDP Context............................................................. 157 AT+CGDATA Enter Data State.......................................................................................... 158 AT+CGPADDR Show PDP Address ................................................................................. 159 AT+CGCLASS GPRS Mobile Station Class ..................................................................... 160 AT+CGREG Network Registration Status ........................................................................ 161 AT+CGEREP Packet Domain Event Reporting................................................................ 162 AT+CGSMS Select Service for MO SMS Messages ....................................................... 164 AT+QGDCNT GPRS Data Counter .................................................................................. 165 AT+QAUGDCNT Configure to Auto Save GPRS Data Counter ...................................... 166 AT+QAUGTH Set Auth Type............................................................................................. 167 Supplementary Service Commands .............................................................................................. 169 11.1. AT+CCFC Call Forwarding Number and Conditions Control ........................................... 169 Q n 11.2. AT+CCWA Call Waiting Control........................................................................................ 171 e 11.3. AT+CHLD Call Related Supplementary Services ............................................................ 173 11.4. AT+CLIP Calling Line Identification Presentation............................................................. 175 fid 11.5. AT+CLIR Calling Line Identification Restriction................................................................ 176 11.6. AT+COLP Connected Line Identification Presentation .................................................... 177 11.7. AT+CSSN Supplementary Service Notifications .............................................................. 179 n 11.8. AT+CUSD Unstructured Supplementary Service Data .................................................... 180 o Audio Commands ............................................................................................................................ 182 C 12.1. AT+CLVL Loud Speaker Volume Level............................................................................. 182 12.2. AT+CMUT Mute Control ................................................................................................... 183 12.3. AT+CALM Mute the Ring Tone ......................................................................................... 183 12.4. AT+CRSL Set Ring Tone Volume ..................................................................................... 184 12.5. AT+QAUDLOOP Enable Audio Loop Test ........................................................................ 185 12.6. AT+VTS DTMF and Tone Generation............................................................................... 186 12.7. AT+VTD Set Tone Duration .............................................................................................. 187 12.8. AT+QDAC Digital Audio Configure ................................................................................... 188 12.9. AT+QLTONE Play a Local Customized Tone ................................................................... 189 12.10. AT+QLDTMF Play Local DTMF ........................................................................................ 190 12.11. AT+QWDTMF Play/Send DTMF Tone(s) ......................................................................... 191 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 7 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12.12. AT+QMIC Set Uplink(MIC) Volume .................................................................................. 193 12.13. AT+QAUDMOD Set Audio Mode ...................................................................................... 194 12.14. AT+QAUDCFG Audio Tuning Process ............................................................................. 195 12.15. AT+QAUDCFG Extension Configuration .......................................................................... 196 12.15.1. AT+QAUDCFG='handset/eec' Set Echo Cancellation for Handset......................... 196 12.15.2. AT+QAUDCFG='headset/eec' Set Echo Cancellation for Headset......................... 198 12.15.3. AT+QAUDCFG='handfree/eec' Set Echo Cancellation for Handfree...................... 199 12.15.4. AT+QAUDCFG='handset/nr/ul' Set Uplink Noise Reduction for Handset ............... 200 12.15.5. AT+QAUDCFG='handset/nr/dl' Set Down Link Noise Reduction for Handset ........ 201 12.15.6. AT+QAUDCFG='headset/nr/dl' Set Down Link Noise Reduction for Headset ........ 202 12.15.7. AT+QAUDCFG='headset/nr/ul' Set Uplink Noise Reduction for Headset ............... 203 12.15.8. AT+QAUDCFG='handfree/nr/dl' Set Down Link Noise Reduction for Handfree ..... 204 13 14 12.15.9. AT+QAUDCFG='handfree/nr/ul' Set Uplink Noise Reduction for Handfree ............ 205 12.15.10. AT+QAUDCFG='nau8814/dlgain' Set Down Link Gain Level for Codec nau8814206 12.15.11.AT+QAUDCFG='nau8814/ulgain' Set Uplink Gain Level for Codec nau8814 ........ 207 12.15.12. AT+QAUDCFG='alc5616/dlgain' Set Down Link Gain Level for Codec alc5616.. 208 l 12.15.13. AT+QAUDCFG='alc5616/ulgain' Set Uplink Gain Level for Codec alc5616 ........ 209 12.15.14. AT+QAUDCFG='max9860/dlgain' Set Down Link Gain Level for Codec max9860210 te 12.15.15. AT+QAUDCFG='max9860/ulgain' Set Uplink Gain Level for Codec max9860 .... 211 12.16. AT+QSIDET Set the Side Tone Gain in Current Mode..................................................... 212 c l 12.17. AT+QAUDGAIN Set Gain Offset ...................................................................................... 213 ue tia 12.18. AT+QCLKOUT Output Clock Source................................................................................214 12.19. AT+QPCMON Enable PCM Sync & BCLK....................................................................... 215 12.20. AT+QIIC IIC Read & Write ................................................................................................ 216 Q n Hardware Related Commands........................................................................................................ 217 13.1. AT+QPOWD Power Off .................................................................................................... 217 e 13.2. AT+CCLK Clock ................................................................................................................ 217 fid 13.3. AT+QALARM Set Alarm.................................................................................................... 218 13.4. AT+CBC Battery Charge................................................................................................... 221 13.5. AT+QSCLK Configure Whether or not to Enter into Sleep Mode .................................... 221 n Appendix ........................................................................................................................................... 223 14.1. Reference ............................................................................................................................ 223 o 14.2. Factory Default Settings Restorable with AT&F .................................................................. 224 C 14.3. AT Command Setting Storable with AT&W ......................................................................... 226 14.4. AT Command Settings Storable with ATZ ........................................................................... 226 14.5. Summary of CME ERROR Codes ...................................................................................... 227 14.6. Summary of CMS ERROR Codes ...................................................................................... 230 14.7. Summary of URC ................................................................................................................ 238 14.8. Parameter List of AT+CEER................................................................................................ 240 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 8 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Table Index TABLE 1: TYPES OF AT COMMANDS AND RESPONSES ......................................................................11 TABLE 2: AT&V RESPONSE ..................................................................................................................... 19 TABLE 3: ATV0&ATV1 RESULT CODES NUMERIC EQUIVALENTS AND BRIEF DESCRIPTION ........ 23 TABLE 4: DELAY CLASS ......................................................................................................................... 146 TABLE 5: RELATED DOCUMENTS ........................................................................................................ 223 TABLE 6: TERMS AND ABBREVIATIONS .............................................................................................. 223 TABLE 7: FACTORY DEFAULT SETTINGS RESTORABLE WITH AT&F .............................................. 224 TABLE 8: AT COMMAND SETTINGS STORABLE WITH AT&W ............................................................ 226 TABLE 9: AT COMMAND SETTINGS STORABLE WITH ATZ................................................................ 226 TABLE 10: DIFFERENT CODING SCHEMES OF +CME ERROR: ........................................... 227 TABLE 11: DIFFERENT CODING SCHEMES OF +CMS ERROR: ........................................... 230 TABLE 12: SUMMARY OF URC .............................................................................................................. 238 CQouneficdteenl tial TABLE 13: CAUSE AND DESCRIPTION LIST OF AT+CEER ................................................................ 240 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 9 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 1 Introduction 1.1. Scope of the Document This document presents the AT Commands Set for Quectel cellular engine UGxx series. 1.2. AT Command Syntax tel The 'AT' or 'at' prefix must be set at the beginning of each command line. To terminate a command line enter . Commands are usually followed by a response that includes c l ''. Throughout this document, only the responses are presented, '' are omitted intentionally. ue tia The AT Commands Set implemented by UGxx is a combination of 3GPP TS 27.007, 3GPP TS 27.005 and ITU-T recommendation V.25ter and the AT Commands developed by Quectel. Q en All these AT commands can be split into three categories syntactically: 'basic', 'S parameter', and 'extended'. They are listed as follows: fid  Basic syntax These AT commands have the format of 'AT', or 'AT&', where '' is the command, and n '' is/are the argument(s) for that command. An example of this is 'ATE', which tells the DCE whether received characters should be echoed back to the DTE according to the value of ''. '' is Co optional and a default will be used if it is missing.  S parameter syntax These AT commands have the format of 'ATS=', where '' is the index of the S register to set, and '' is the value to assign to it.  Extended syntax These commands can be operated in several modes, as following table: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 10 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Table 1: Types of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? AT+? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the UE. 1.3. Supported Character Sets The AT command interface defaults to the GSM character set and supports the following character sets: l  GSM te  UCS2  IRA c l  HEX ue tia The character set can be configured and interrogated by AT+CSCS command (3GPP TS 27.007). The character set is defined in 3GPP TS 27.005. The character set affects transmission and reception of SMS and SMS Cell Broadcast Messages, the entry and display of phone book entries text field. Q fiden 1.4. AT Command Interface The AT command interface includes three USB ports (USB MODEM port, USB AT port1 and USB AT n port2) and one main UART port. Co UART Port Feature: The baud rates of 0, 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 921600, 3000000, and 6000000 are supported at present. The default baud rate of main UART port is 0, which means the main UART port would be working on auto baud rate by default. The main UART port supports hardware flow control lines RTS and CTS. But it is off by default. AT command AT+IFC=2,2 is used to enable hardware flow control. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 11 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 1.5. Unsolicited Result Code As a report message, URC (Unsolicited Result Code) is not issued as part of the response related to an executed AT command. URC is issued by the module without being requested by the TE and it is issued automatically when a certain event occurs. Typical events leading to URCs are incoming calls ('RING'), received short messages, etc. The AT command AT+QCFG='urc/port' could list all available port(s) and the current port. This command also can disable URC indication of a specified port. 1.6. Turn off Procedure It is recommended to execute AT+QPOWD command to turn off the module, as it is the safest and best way. This procedure is realized by letting the module log off from the network and allowing the software to enter into a secure and safe data state before disconnecting the power supply. l After sending AT+QPOWD, do not enter any other AT commands. The module outputs message te 'POWERED DOWN' and sets the STATE pin as low to enter into the shutdown state. In order to avoid data loss, it is suggested to wait for 1s to switch off the VBAT after the STATE pin is set as low and the c l URC 'POWERED DOWN' is outputted. If 'POWERED DOWN' has not been received after 65s, the CQounefidentia VBAT shall be switched off compulsorily. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 12 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2 General Commands 2.1. ATI Display Product Identification Information The ATI command delivers a product information text. ATI Display Product Identification Information Execution Command ATI Response TA issues product information text. l Quectel te UGxx c l Revision: ue tia Maximum ResponseTime Q n Reference V.25ter OK 300ms fide Parameter Revision of software release Con Example ATI Quectel UGxx Revision: UGxxENAR01A01E1G OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 13 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2.2. AT+GMI Request Manufacturer Identification AT+GMI returns a manufacturer identification text. The command is identical with AT+CGMI. AT+GMI Request Manufacturer Identification Test Command AT+GMI=? Execution Command AT+GMI Response OK Response TA reports one or more lines of information text which permit the user to identify the manufacturer. Quectel OK Reference V.25ter tel 2.3. AT+GMM Request TA Model Identification uec tial AT+GMM returns a product model identification text. The command is identical with AT+CGMM. AT+GMM Request TA Model Identification Q n Test Command AT+GMM=? e Execution Command fid AT+GMM Response OK Response TA returns a product model identification text. UGxx nOK Reference Co V.25ter 2.4. AT+GMR Request TA Revision Identification of Software Release AT+GMR delivers a product firmware version identification. The command is identical with AT+CGMR. AT+GMR Request TA Revision Identification of Software Release Test Command AT+GMR=? Response OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 14 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Execution Command AT+GMR Reference V.25ter Response TA reports one or more lines of information text which permit the user to identify the revision of software release. OK Parameter Revision of software release l 2.5. AT+GOI Request Global Object Identification te AT+GOI Request Global Object Identification c l Test Command AT+GOI=? ue tia ExecutionCommand Q en AT+GOI Response OK Response TA reports one or more lines of information text which permit the user to identify the device, based on the ISO system for registering unique object identifiers. fid OK Reference V.25ter Con Parameter Identifier of device type Example AT+GOI UGxx OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 15 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2.6. AT+CGMI Request Manufacturer Identification AT+CGMI returns a manufacturer identification text. AT+CGMI Request Manufacturer Identification Test Command AT+CGMI=? Execution Command AT+CGMI Response OK Response TA returns the manufacturer identification text. Quectel Maximum Response Time Reference l 3GPP TS 27.007 OK 300ms cte l 2.7. AT+CGMM Request Model Identification ue tia AT+CGMM returns a product model identification text. AT+CGMM Request Model Identification Q n Test Command e AT+CGMM=? Execution Command fid AT+CGMM Response OK Response TA returns the product model identification text. UGxx on Maximum Response Time C Reference OK 300ms 3GPP TS 27.007 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 16 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2.8. AT+CGMR Request TA Revision Identification of Software Release AT+CGMR delivers a product firmware version identification. AT+CGMR Request TA Revision Identification of Software Release Test Command AT+CGMR=? Execution Command AT+CGMR Response OK Response TA returns the identification text of product software version. Maximum Response Time Reference l 3GPP TS 27.007 OK 300ms te Parameter c l Identification text of product software version Que ntia 2.9. AT+GSN Request International Mobile Equipment Identity (IMEI) fide AT+GSN returns the International Mobile Equipment Identity (IMEI). The command is identical with AT+CGSN. AT+GSN Request International Mobile Equipment Identity (IMEI) n Test Command o AT+GSN=? C Execution Command Response OK Response AT+GSN TA reports the IMEI (International Mobile Equipment Identity) number in information text which permits the user to identify the individual ME device. Maximum Response Time Reference V.25ter OK 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 17 / 247 Parameter IMEI of the telephone UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual NOTE The serial number (IMEI) varies with the individual ME device. 2.10. AT+CGSN Request Product Serial Number Identification AT+CGSN returns International Mobile Equipment Identity (IMEI). The command is identical with AT+GSN. l AT+CGSN Request Product Serial Number Identification te Test Command AT+CGSN=? c l Execution Command ue tia AT+CGSN Response OK Response Q n Maximum Response Time e Reference 3GPP TS 27.007 OK 300ms nfid 2.11. AT&F Set All Current Parameters to Manufacturer Defaults o AT&F resets AT command settings to their factory default values. However, the command does not C change the current baud rate of UART. AT&F Set All Current Parameters to Manufacturer Defaults Execution Command AT&F[] Response TA sets all current parameters to the manufacturer defined profile. See Table 7: Factory Default Settings Restorable with AT&F. OK Maximum Response Time 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 18 / 247 Reference V.25ter Parameter 0 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Set all TA parameters to manufacturer defaults 2.12. AT&V Display Current Configuration AT&V displays three profiles of several AT command parameters, including the single-letter AT command parameters which are not readable otherwise. AT&V Display Current Configuration l Execution Command cte l AT&V Response TA returns the current parameter setting. See Table 2: AT&V Response. OK ue tia Maximum ResponseTime 300ms Reference V.25ter Q en Table 2: AT&V Response fid AT&V &C: 1 n &D: 1 Co &F: 0 &W: 0 E: 1 Q: 0 V: 1 X: 4 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 19 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Z: 0 S0: 0 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 OK tel 2.13. AT&W Store Current Parameters to User Defined Profile c l AT&W stores the current AT command settings to a user defined profile in non-volatile memory. ue tia AT&W Store Current Parameters to User Defined Profile Execution Command Q fiden AT&W[] Response TA stores the current parameter settings in the user defined profile. See Table 8: AT Command Settings Storable with AT&W. OK Maximum Response Time 300ms Reference n V.25ter Co Parameter 0 Profile 0 to store current parameters 2.14. ATZ Set all Current Parameters to User Defined Profile ATZ restores the current AT command settings to a user defined profile in non-volatile memory, if one was storable with AT&W before. Any additional AT command on the same command line may be ignored. ATZ WCDMA_UGxx_AT_Commands_Manual Confidential / Released 20 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual does not change the current baud rate of UART. ATZ Set all Current Parameters to User Defined Profile Execution Command ATZ[] Response TA sets all current parameters to the user defined profile. See Table 9: AT Command Settings Storable with ATZ. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 Reset to profile number 0 tel 2.15. ATQ Set Result Code Presentation Mode c l ATQ controls whether the result code is transmitted to the TE. Other information text transmitted as ue tia response is not affected. ATQ Set Result Code Presentation Mode Q n Execution Command nfide ATQ Response This parameter setting determines whether or not the TA transmits any result code to the TE. Information text transmitted in response is not affected by this setting. If =0: OK If =1: (none) Co Maximum Response Time 300ms Reference V.25ter Parameter 0 1 TA transmits result code Result codes are suppressed and not transmitted WCDMA_UGxx_AT_Commands_Manual Confidential / Released 21 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2.16. ATV TA Response Format This command determines the contents of header and trailer transmitted with AT command result codes and information responses. The result codes, their numeric equivalents and brief descriptions are listed in the following table. ATV TA Response Format Execution Command Response ATV This parameter setting determines the contents of the header and trailer transmitted with result codes and information l Maximum Response Time te Reference c l V.25ter responses. When =0 0 When =1 OK 300ms ue tia Parameter Q n 0 fide 1 Information response: Short result code format: Information response: Long result code format: Example n ATV1 o OK C AT+CSQ //Set =1 +CSQ: 30,0 OK ATV0 0 AT+CSQ +CSQ: 30,0 0 //When =1 result code is OK //Set =0 //When =0 result code is 0 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 22 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Table 3: ATV0&ATV1 Result Codes Numeric Equivalents and Brief Description ATV1 ATV0 Description OK 0 Acknowledges execution of a command A connection has been established; the DCE is moving from CONNECT 1 command state to online data state RING 2 The DCE has detected an incoming call signal from network NO CARRIER 3 The connection has been terminated or the attempt to establish a connection failed Command not recognized, command line maximum length ERROR 4 NO DIALTONE 6 l BUSY 7 cte l NOANSWER 8 exceeded, parameter value invalid, or other problem with processing the command line No dial tone detected Engaged (busy) signal detected '@' (Wait for Quiet Answer) dial modifier was used, but remote ringing followed by five seconds of silence was not detected before expiration of the connection timer (S7) ue tia 2.17. ATE Set Command Echo Mode Q en ATE controls whether the module echoes characters received from TE during AT command state. fid ATE Set Command Echo Mode Execution Command on ATE Response This setting determines whether or not the TA echoes characters received from TE during command state. OK C Maximum Response Time 300ms Reference V.25ter Parameter 0 1 Echo mode off Echo mode on WCDMA_UGxx_AT_Commands_Manual Confidential / Released 23 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2.18. A/ Repeat Previous Command Line A/ repeats previous AT command line, and '/' acts as the line terminating character. A/ Repeat Previous Command Line Execution Command A/ Reference V.25ter Response Repeat Previous Command Example ATI Quectel UGxx l Revision: UGxxENAR01A01E1G te OK A/ c l Quectel ue tia UGxx Revision: UGxxENAR01A01E1G Q n OK //Repeat previous command fide 2.19. ATS3 Set Command Line Termination Character ATS3 determines the character recognized by the module to terminate an incoming command line. It is n also generated for result codes and information text, along with character value set via ATS4. Co ATS3 Set Command Line Termination Character Read Command Response ATS3? Write Command ATS3= OK Response This parameter setting determines the character recognized by TA to terminate an incoming command line. The TA also returns this character in output. OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 24 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference V.25ter 300ms Parameter 0-13-127 Command line termination character (Default 13=) 2.20. ATS4 Set Response Formatting Character ATS4 determines the character generated by the module for result code and information text, along with the command line termination character set via ATS3. l ATS4 Set Response Formatting Character te Read Command ATS4? Response uec tial WriteCommand ATS4= Q en Maximum Response Time fid Reference V.25ter OK Response This parameter setting determines the character generated by the TA for result code and information text. OK 300ms n Parameter Co 0-10-127 Response formatting character (Default 10=) 2.21. ATS5 Set Command Line Editing Character ATS5 determines the character value used by the module to delete the immediately preceding character from the AT command line (i.e. equates to backspace key). WCDMA_UGxx_AT_Commands_Manual Confidential / Released 25 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual ATS5 Set Command Line Editing Character Read Command ATS5? Response Write Command ATS5= OK Response This parameter setting determines the character recognized by TA as a request to delete the immediately preceding character from the command line. OK Maximum Response Time 300ms Reference V.25ter l Parameter te 0-8-127 Response editing character (Default 008=) uec tial 2.22. ATX Set CONNECT Result Code Format and Monitor Call Q n Progress fide ATX determines whether or not the module transmits particular result codes to the TE. It also controls whether or not the module verifies the presence of a dial tone when it begins dialing, and whether or not engaged tone (busy signal) detection is enabled. n ATX Set CONNECT Result Code Format and Monitor Call Progress o Execution Command C ATX Response This parameter setting determines whether or not the TA detected the presence of dial tone and busy signal and whether or not TA transmits particular result codes. OK Maximum Response Time 300ms Reference V.25ter WCDMA_UGxx_AT_Commands_Manual Confidential / Released 26 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter 0 CONNECT result code only returned; dial tone and busy detection are both disabled 1 CONNECT result code only returned; dial tone and busy detection are both disabled 2 CONNECT result code returned; dial tone detection is enabled; busy detection is disabled 3 CONNECT result code returned; dial tone detection is disabled; busy detection is enabled 4 CONNECT result code returned; dial tone and busy detection are both enabled 2.23. AT+CFUN Set Phone Functionality tel AT+CFUN controls the functionality level. It can also be used to reset the UE. c l AT+CFUN Set Phone Functionality Test Command ue tia AT+CFUN=? Response +CFUN: (list of supported s),(list of supported s) Q n Read Command e AT+CFUN? OK Response +CFUN: fid Write Command AT+CFUN=[,] OK Response OK onIf error is related to ME functionality: C +CME ERROR: Maximum Response Time 15s, determined by network. Reference 3GPP TS 27.007 Parameter 0 1 Minimum functionality Full functionality (Default) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 27 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 4 Disable phone from both transmitting and receiving RF signals 0 Do not reset the ME before setting it to power level This is default when is not given 1 Reset the ME. The device is fully functional after the reset. Example AT+CFUN=0 OK AT+COPS? +COPS: 0 //Switch phone to minimum functionality //No operator is registered OK AT+CPIN? +CME ERROR: 10 AT+CFUN=1 l OK te +QUSIM: 0 c l +CPIN: SIM PIN ue tia AT+CPIN=1234 OK Q n +CPIN: READY e +QIND: SMS DONE fid +QIND: PB DONE AT+CPIN? +CPIN: READY n OK o AT+COPS? C +COPS: 0,0,'CHN-UNICOM',2 //SIM is not inserted //Switch phone to full functionality //Operator is registered OK 2.24. AT+CMEE Error Message Format AT+CMEE controls the format of error result codes: 'ERROR', error numbers or verbose messages as '+CME ERROR: ' and '+CMS ERROR: '. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 28 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+CMEE Error Message Format Test Command AT+CMEE=? Response +CMEE: (list of supported s) Read Command AT+CMEE? OK Response +CMEE: OK Write Command Response AT+CMEE= l Maximum Response Time te Reference 3GPP TS 27.007 TA disables or enables the use of result code +CME ERROR: as an indication of an error related to the functionality of the ME. OK 300ms uec tial Parameter 0 Q n 1 e 2 Disable result code Enable result code and use numeric values Enable result code and use verbose values fid Example AT+CMEE=0 n OK AT+CPIN=1234 o ERROR C AT+CMEE=1 //Disable result code //Only 'ERROR' will be displayed //Enable error result code with numeric values OK AT+CPIN=1234 +CME ERROR: 10 AT+CMEE=2 //Enable error result code with verbose (string) values OK AT+CPIN=1234 +CME ERROR: SIM not inserted WCDMA_UGxx_AT_Commands_Manual Confidential / Released 29 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2.25. AT+CSCS Select TE Character Set AT+CSCS write command informs the module which character set is used by the TE. It enables the UE to convert character strings correctly between TE and UE character sets. AT+CSCS Select TE Character Set Test Command AT+CSCS=? Response +CSCS: (list of supported s) OK Read Command Response AT+CSCS? Write Command l AT+CSCS= cte l Maximum Response Time ue tia Reference 3GPP TS 27.007 +CSCS: OK Response Set character set which is used by the TE. The TA can then convert character strings correctly between the TE and ME character sets. OK 300ms Q n Parameter nfide 'UCS2' 'IRA' 'HEX' 'GSM' UCS2 alphabet International reference alphabet UCS2 alphabet GSM default alphabet Co Example AT+CSCS? //Query the current character set +CSCS: 'GSM' OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 30 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 3 Serial Interface Control Commands 3.1. AT&C Set DCD Function Mode AT&C controls the behavior of the UE's DCD line. AT&C Set DCD Function Mode Execution Command AT&C[] ctel l Maximum Response Time ue tia Reference V.25ter Response This parameter determines how the state of circuit 109 (DCD) relates to the detection of received line signal from the distant end. OK 300ms Q n Parameter e 0 fid 1 DCD line is always ON DCD line is ON only in the presence of data carrier n 3.2. AT&D Set DTR Function Mode Co AT&D determines how the UE responds if DTR line is changed from ON to OFF condition during online data mode. AT&D Set DTR Function Mode Execution Command AT&D[] Response This parameter determines how the TA responds when circuit 108/2 (DTR) is changed from ON to OFF condition during data mode. OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 31 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference V.25ter 300ms Parameter 0 1 2 TA ignores status on DTR ONOFF on DTR: Change to command mode while remaining the connected call ONOFF on DTR: Disconnect data call, and change to command mode. During state DTR=OFF, auto-answer function is disabled 3.3. AT+IFC Set TE-TA Local Data Flow Control l AT+IFC determines the flow control behavior of the serial port. te AT+IFC Set TE-TA Local Data Flow Control c l Test Command ue tia AT+IFC=? Response +IFC: (list of supported s),(list of supported s) Q n Read Command e AT+IFC? OK Response +IFC: , fid Write Command n AT+IFC=, OK Response This parameter setting determines the data flow control on the serial interface for data mode. OK Co Maximum Response Time 300ms Reference V.25ter Parameter Specifies the method that will be used by TE when receiving data from TA 0 None 2 RTS flow control Specifies the method that will be used by TA when receiving data from TE WCDMA_UGxx_AT_Commands_Manual Confidential / Released 32 / 247 0 None 2 CTS flow control UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual NOTE The flow control is applied for data mode. Example AT+IFC=2,2 //Open the hardware flow control OK AT+IFC? +IFC: 2,2 OK tel 3.4. AT+IPR Set TE-TA Fixed Local Rate uec tial AT+IPR is used to query and set the baud rate of the UART. The default baud rate value () is 0bps. setting will not be restorable with AT&F. Q n AT+IPR Set TE-TA Fixed Local Rate Test Command fide AT+IPR=? Response +IPR: (list of supported auto detectable s),(list of supported fixed-onlys) Read Command n AT+IPR? OK Response +IPR: Co OK Write Command Response AT+IPR= This parameter setting determines the data rate of the TA on the serial interface. After the delivery of any result code associated with the current command line, the rate of command takes effect. OK Maximum Response Time 300ms Reference V.25ter WCDMA_UGxx_AT_Commands_Manual Confidential / Released 33 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Baud rate of per second 0 300 1200 2400 4800 9600 19200 38400 57600 115200 230400 460800 921600 l 3000000 6000000 cte l NOTES ue tia 1. If a fixed baud rate is set, make sure that both TE (DTE, usually external processor) and TA (DCE, Quectel module) are configured to the same rate. 2. If IPR is set to 0, it will change module to auto baudrate. Q n 3. The value of AT+IPR cannot be restored with AT&F or ATZ. 4. A selected baud rate takes effect after the write commands are executed and acknowledged by e 'OK'. fid Example AT+IPR=115200 n OK o AT+IPR? C +IPR: 115200 //Set fixed baud rate to 115200 OK 3.5. AT+QRIR Restore Ring Line to Inactive If the behavior of ring line is 'always', you should restore ring line to inactive by AT+QRIR. The behavior of ring line is controlled by AT+QCFG. Please refer to AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/other' and AT+QCFG='urc/ri/smsincoming'. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 34 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+QRIR Restore Ring Line to Inactive Test Command AT+QRIR=? Execution Command AT+QRIR Response OK Response OK ERROR Maximum Response Time 300ms CQouneficdteenl tial WCDMA_UGxx_AT_Commands_Manual Confidential / Released 35 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 4 Status Control Commands 4.1. AT+CPAS Mobile Equipment Activity Status AT+CPAS execute command queries the module‟s activity status. AT+CPAS Mobile Equipment Activity Status Test Command AT+CPAS=? Response +CPAS: (list of supported s) tel Execution Command c l AT+CPAS OK Response TA returns the activity status of ME. +CPAS: ue tia OK ERROR Q fiden MaximumResponseTime Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms Con Parameter 0 Ready 2 Unknown 3 Ringing 4 Call in progress or call hold Example AT+CPAS +CPAS: 0 //Module is idle WCDMA_UGxx_AT_Commands_Manual Confidential / Released 36 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK ATD10086; OK AT+CLCC +CLCC: 1,0,3,0,0,'10086',129 OK AT+CPAS +CPAS: 3 //Module is ringing OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 OK l AT+CPAS +CPAS: 4 te OK //Call in progress uec tial 4.2. AT+CEER Extended Error Report Q n AT+CEER provides an extended report of 1 line about categorized error causes, such as: e  +CEER: 'No report available' fid  +CEER: 'CC setup error',1,'Unassigned (unallocated) number'  +CEER: 'SM detach',0,'No cause information available' n AT+CEER Extended Error Report o Test command AT+CEER=? C Execution command Response OK Response AT+CEER In case of CC and SM categories: +CEER: [,,] In case of SS category network error cause: +CEER: ,[,] OK ERROR WCDMA_UGxx_AT_Commands_Manual Confidential / Released 37 / 247 Maximum Response Time UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual If error is related to ME functionality: +CME ERROR: 300ms Parameter 'No report available' 'CC setup error' 'CC modification error' 'CC release' 'SM attach error' tel c l ue tia 'SM detach' 'SM activation error' 'SM deactivation' 'SS network error cause' 'SS network reject cause' 'SS network GSM cause' Contains a digit representing the error cause sent by network or internally. Refer to Table 13: Cause and Description List of AT+CEER. A verbose string containing the textual representation. Refer to Table 13: Cause and Description List of AT+CEER. SS error tag in 3GPP TS 24.008 Q en 4.3. AT+QCFG Extended Configuration Settings fid AT+QCFG is used to query and configure various settings of module. AT+QCFG Extended Configuration Settings n Test Command Co AT+QCFG=? Response +QCFG: 'urc/port', (list of supported s), (list of supported s), (list of supported s), +QCFG: 'uart/power', (list of supported s), (list of supported s), +QCFG: 'urc/ri/ring', (list of supported s), (list of supported s), (list of supported s), (list of supported s), WCDMA_UGxx_AT_Commands_Manual Confidential / Released 38 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual (list of supported s), (list of supported s), +QCFG: 'urc/ri/smsincoming', (list of supported s), (list of supported s), (list of supported s), +QCFG: 'urc/ri/other', (list of supported s), (list of supported s), (list of supported s), +QCFG: 'urc/delay', (list of supported s), +QCFG: 'tone/incoming', (list of supported s), +QCFG: 'vbatt', ((list of supported s), l (list of supported s), (list of supported s)), te +QCFG: 'nwscanmode', (list of supported s), c l (list of supported s), ue tia +QCFG: 'fota/cid', (list of supported s), +QCFG: 'ussd/textescape', (list of supported s) Q n +QCFG: 'sms/textescape', e (list of supported s), +QCFG: 'remoteip', fid (list of supported s), +QCFG: 'ppp/firstreqintr',(1000-10000), (list of supported s), n+QCFG: 'stateurc/enable', (list of supported < enable_val >s), o +QCFG:'sms/listmsgmap',('rec unread','rec read','sto C unsend','sto sent') (list of supported < message type >s), Maximum Response Time Reference OK 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 39 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 4.3.1. AT+QCFG='urc/port' List All Port(s) or Disable URC of a Specified Port AT+QCFG='urc/port' lists all available port(s) and current port. It can also disable URC indication of a specified port. AT+QCFG='urc/port' Display All Port (s) and Disable URC of a Specified Port Write Command AT+QCFG='urc/port'[,[,]] Response If configuration parameters are omitted: +QCFG: 'urc/port',, +QCFG: 'urc/port',, [……] ctel l Reference OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: ue tia Parameter Q n e fid 0 Disable URC indication of the port 1 Enable URC indication of the port A string to describe port name 0 Current port 1 All available ports Con NOTE The configuration will be saved to NV automatically. 4.3.2. AT+QCFG='uart/power' Turn on/off the UART Port AT+QCFG='uart/power' Turn on/off the UART Port Write Command AT+QCFG='uart/power'[,] Response If is omitted: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 40 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +QCFG: 'uart/power',, OK If is not omitted: OK ERROR Reference If error is related to ME functionality: +CME ERROR: Parameter tel 0 UART 1 1 UART 3 0 Auto turn on/off the UART port 1 Turn on the UART port 2 Turn off the UART port uec tial 4.3.3. AT+QCFG='urc/ri/ring' Ring Line Behavior of RING AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other' control the Q n behavior of ring line when URC is reported. These configurations will be stored into NV automatically. The e ring line is active low. AT+QCFG='urc/ri/ring' specifies the behavior of ring line when RING is presented to indicate an incoming call. fid The sum of parameter and determines the interval time of 'RING' indications when a call is coming. n AT+QCFG='urc/ri/ring' Ring Line Behavior of RING o Write Command Response C AT+QCFG='urc/ri/ring'[,[,[,[,[,[,]]]]]] 'urc/ri/ring',,,,,, OK If configuration parameters are entered: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 41 / 247 Maximum Response Time UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK ERROR If error is related to ME functionality: +CME ERROR: 300ms Parameter The behavior of the ring line when URCs are presented 'off' No change. Ring line keeps inactive Quectenl tial e fid Con 'pulse' Pulse. Pulse width determined by 'always' Change to active. You may restore to inactive by +QRIR 'auto' When 'RING' is presented to indicate an incoming call, ring line changes to and keeps active. When ring of the incoming call ends, either answering or hanging up the incoming call, ring line will change to inactive. 'wave' When 'RING' is presented to indicate an incoming call. The ring line outputs a square wave. Both and are used to set parameters of the square wave. When the ring of incoming call ends, either answering or hanging up the incoming call, ring line will change to inactive. Set the width of pulse. Value ranges from 1 to 2000ms and default is 120ms This parameter is only meaningful when is 'pulse'. If this parameter is not needed, you can set it as null. Set the active duration of the square wave, value ranges from 1 to 10000ms, and the default is 1000ms.This parameter is only meaningful when is 'wave'. Set the inactive duration of the square wave, value ranges from 1 to 10000ms, and the default is 3000ms. This parameter is only meaningful when is 'wave'. Set whether the ring line behavior could be disturbed. This parameter is only meaningful when is configured to 'auto' or 'wave'. For example, when is configured to 'wave', if you need the square wave not to be disturbed by other URCs (including SMS related URCs), you should set to 'on'. 'off' It can be disturbed by other URCs which the behavior of ring line is caused by an incoming call ringing. 'on' It cannot be disturbed by other URCs which the behavior of ring line is caused by an incoming call ringing. The count of pulse. This parameter is only meaningful when is 'pulse'. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 42 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Value ranges from 1 to 5 and default is 1. The interval time between two pulses is equal to . NOTE The configuration will be saved to NV automatically. 4.3.4. AT+QCFG='urc/ri/smsincoming' Ring Line Behavior of Incoming SMS AT+QCFG='urc/ri/smsincoming' specifies the behavior of ring line when related incoming message URCs are presented. Related incoming message URCs list: +CMTI,+CMT,+CDS,+CBM. AT+QCFG='urc/ri/smsincoming' Ring Line Behavior of Incoming SMS Write Command l AT+QCFG='urc/ri/smsincoming'[,[,[,]]] Response If configuration parameters are omitted (+QCFG='urc/ri/smsincoming'), return current configuration: +QCFG: 'urc/ri/smsincoming',,, OK Q n If configuration parameters are entered: e OK ERROR nfid Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms Co Parameter The behavior of the ring line when URC are presented 'off' No change. Ring line keeps inactive 'pulse' Pulse. Pulse width determined by 'always' Change to active. You should restore to inactive by +QRIR Set the width of pulse. Value ranges from 1 to 2000ms and the default is 120ms. This parameter is only valid when is 'pulse'. The count of pulse. This parameter is only meaningful when is 'pulse'. Value ranges from 1 to 5 and default is 1. The interval time between two pulses WCDMA_UGxx_AT_Commands_Manual Confidential / Released 43 / 247 is equal to NOTE The configuration will be saved to NV automatically. UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 4.3.5. AT+QCFG='urc/ri/other' Ring Line Behavior of Other URCs AT+QCFG='urc/ri/other' specifies the behavior of ring line when other URCs are presented. AT+QCFG='urc/ri/other' Ring Line Behavior of Other URCs Write Command AT+QCFG='urc/ri/other'[,[,[,]]] Response If configuration parameters are omitted (+QCFG='urc/ri/other'), return current configuration: +QCFG: 'urc/ri/other',,, te OK uec tial If configuration parameters are entered: OK ERROR Q en Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms fid Parameter Con The behavior of the ring line when URCs are presented 'off' No change. Ring line keeps inactive 'pulse' Pulse. Pulse width determined by Set the width of pulse. Value ranges from 1 to 2000ms and the default is 120ms. This parameter is effect only when is 'pulse'. The count of pulse. This parameter is only meaningful when is 'pulse'. Value ranges from 1 to 5 and default is 1. The interval time between two pulses is equal to . NOTE WCDMA_UGxx_AT_Commands_Manual Confidential / Released 44 / 247 The configuration will be saved to NV automatically. UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 4.3.6. AT+QCFG='urc/delay' Delay URC Indication AT+QCFG='urc/delay' can delay the output of URC indication until ring line pulse ends. AT+QCFG='urc/delay' Delay URC Indication Write Command Response AT+QCFG='urc/delay'[,] If configuration parameter is omitted: Reference Parameter NOTE +QCFG: 'urc/delay', OK l If configuration parameter is entered: OK te ERROR c l If error is related to ME functionality: +CME ERROR: Que entia 0 URC indication will be output when ring line pulse starts fid 1 URC indication will be output when ring line pulse ends (only the type of ring line is 'pulse', refer to AT+QCFG='urc/ri/ring', Con AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other') The configuration will be saved to NV automatically. 4.3.7. AT+QCFG='tone/incoming' Enable/Disable Ring Tone AT+QCFG='tone/incoming' is used to enable or disable ring tone. AT+QCFG='tone/incoming' Enable/Disable Ring Tone WCDMA_UGxx_AT_Commands_Manual Confidential / Released 45 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command Response AT+QCFG='tone/incoming'[,] If configuration parameters are omitted: +QCFG: 'tone/incoming', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: Reference Parameter tel A numeric parameter which indicates ring tone is open or not. The default value is 1. 0 Disable ring tone 1 Enable ring tone uec tial NOTE The configuration will be saved to NV automatically. Q en 4.3.8. AT+QCFG='nwscanmode' Network Search Mode Configuration fid AT+QCFG='nwscanmode' specifies the mode of searching network. If is omitted, the configuration will take effect immediately. n AT+QCFG='nwscanmode' Network Search Mode Configuration o Write Command Response C AT+QCFG='nwscanmode'[,[,]] (+QCFG='nwscanmode'), return current configuration: +QCFG: 'nwscanmode', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 46 / 247 Reference UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +CME ERROR: Parameter Number format, network search mode 0 AUTO 1 GSM Only 2 UMTS Only Number format, when to take effect 0 Take effect after UE reboots 1 Take effect immediately NOTE tel The configuration will be saved to NV automatically. uec tial 4.3.9. AT+QCFG='vbatt' Voltage Detection AT+QCFG='vbatt' can enable voltage detection and set corresponding parameters. Q n About Voltage Detection: e When the voltage is lower than the lowest voltage limit, the module will output: fid +QIND: 'vbatt',-2 If it does not come back to a degree greater than the lowest voltage limit within 2 seconds, the module will n be turned off automatically. o When the voltage is greater than the lowest voltage limit, but lower than low voltage warning limit, the C module will output: +QIND: 'vbatt',-1 When the voltage is greater than the highest voltage limit, the module will output: +QIND: 'vbatt',2 If it does not come back to a degree lower than highest voltage limit within 2 seconds, the module will be turned off automatically. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 47 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual When the voltage is lower than the highest voltage limit, but greater than high voltage warning limit, the module will output: +QIND: 'vbatt',1 When the voltage comes back to normal voltage range, the module will output: +QIND: 'vbatt',0 Voltage detection is disabled by default. It is suggested to enable voltage detection in order to avoid module breakdown due to excessively high or low voltage. The configuration will be stored to NV automatically. AT+QCFG='vbatt' Voltage Detection l Write Command AT+QCFG='vbatt'[,[,,]] Response If configuration parameters are omitted (+QCFG='vbatt'), return current configuration: +QCFG: 'vbatt', (,,), (,,), OK Q n If configuration parameters are entered: e +QCFG: 'vbatt', (,,) fid OK Else, response: nERROR o If error is related to ME functionality: C +CME ERROR: Maximum Response Time 300ms Parameter Voltage type -2 Indicate the lowest voltage -1 Indicate the low voltage warning 1 Indicate the high voltage warning WCDMA_UGxx_AT_Commands_Manual Confidential / Released 48 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2 Indicate the highest voltage Voltage threshold value (mv) (3250~3290~3420) The lowest voltage limit(If below this limit, module will shut down) (3480~3500~3520) Low voltage warning limit (4190~4210~4230) High voltage warning limit (4280~4310~4400) The highest voltage limit (If above this limit, module will shut down) Enable/disable voltage detection function 0 Disable 1 Enable Example //Enable low voltage warning report, the limit is 3500mv. AT+QCFG='VBATT',-1,3500,1 OK l +QIND: 'vbatt', -1 //Report result when voltage is lower than low voltage warning limit. te +QIND: 'vbatt', 0 //Report result when voltage is back to normal voltage. c l AT+QCFG='VBATT',-1 //Query low warning limit. ue tia +QCFG: 'VBATT',(-1,3500,1) OK Q n //Disable low voltage warning report, the limit is 3500mv. e AT+QCFG='VBATT',-1,3500,0 OK fid NOTE Con The configuration will be saved to NV automatically. 4.3.10. AT+QCFG='temp' Temperature Detection AT+QCFG='temp' can enable temperature detection and set corresponding parameters. About Temperature Detection: When the temperature is lower than the lowest temperature limit, the module will output: +QIND: 'temp',-2 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 49 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual If the temperature did not rise to a degree greater than the lowest temperature within 5 seconds, the module will be turned off automatically. When the temperature is greater than the lowest temperature limit, but lower than the low temperature warning limit, the module will output: +QIND: 'temp',-1 When temperature is greater than the highest temperature limit, the module will output: +QIND: 'temp',2 If the temperature did not drop to a degree lower than the highest temperature limit within 5 seconds, the module will be turned off automatically. When the temperature is lower than the highest temperature limit, but greater than the high temperature warning limit, the module will output: l +QIND: 'temp',1 te When the temperature comes back from the low temperature warning limit or the high temperature c l warning limit to normal temperature range, the module will output: ue tia +QIND:'temp',0 The configuration will be stored to NV automatically. Q en AT+QCFG='temp' Temperature Detection Write Command fid AT+QCFG='temp'[,[,[,]] Response If configuration parameters are omitted (+QCFG='temp'), return current configuration: +QCFG: 'temp', (,,), (,,), … OK If configuration parameters are entered: OK ERROR Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 50 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Temperature type -2 Indicate the lowest temperature -1 Indicate low temperature warning 1 Indicate high temperature warning 2 Indicate the highest temperature Temperature threshold value (degrees Celsius) (-40~-35) The lowest temperature limit (If below this limit, the module will be shut down). Default value is -38 (-35~-30) Low temperature warning limit. Default value is -32 (70~80) High temperature warning limit. Default value is 75 l (80~90) The highest temperature limit (If above this limit, the module will be shut down). Default value is 85 Enable/disable temperature detection function 0 Disable 1 Enable te Example c l AT+QCFG='temp',-1 ue tia +QCFG: 'temp',(-1,-35,0) //Query the low temperature warning limit and setting OK AT+QCFG='temp',-1,-35,1 Q n OK //Set the low temperature warning limit e +QIND: 'temp',-1 //Report result when temperature is lower than warning temperature n Co +QIND: 'temp',0 //Report result when temperature is back to normal temperature 4.3.11. AT+QCFG='fota/cid' DFOTA Context ID Configuration When you upgrade firmware by DFOTA on a FTP server or HTTP server, you need to activate a PDP context ID for FTP connection or HTTP connection. The default PDP context ID is 1, and it can be configured by AT+QCFG='fota/cid',. AT+QCFG='fota/cid' DFOTA Context ID Configuration Write Command AT+QCFG='fota/cid'[,] Response If configuration parameters are omitted WCDMA_UGxx_AT_Commands_Manual Confidential / Released 51 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual (AT+QCFG='fota/cid ), return current configuration: +QCFG: 'fota/cid', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: Reference Parameter l Integer type, context ID, range is 1-20, the default value is 1. cte l 4.3.12. AT+QCFG='ussd/textescape' Character Escape of USSD Text ue tia When AT+CSCS='GSM' or AT+CSCS='IRA', and USSD outputting text contains character , , quotation mark or others, user may make a parse error with USSD URC. AT+QCFG='ussd/textescape' can enable character escape function of USSD text to avoid this error. The configuration is saved into NV Q n automatically. e AT+QCFG='ussd/textescape' Character Escape of USSD Text fid Write Command AT+QCFG='ussd/textescape'[,] Response If configuration parameters are omitted (+QCFG='ussd/textescape'), return current configuration: +QCFG: 'ussd/textescape', Co OK If configuration parameters are entered: OK ERROR Reference If error is related to ME functionality: +CME ERROR: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 52 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter 0 Character escape function of USSD text is disabled 1 Character escape function of USSD text is enabled When AT+CSCS='GSM' or AT+CSCS='IRA', in USSD text outputting: 0x5C (show in hex, character Ö in GSM, character in ASCII) will be escaped into 0x5C3543 ('5C'). 0x0D (show in hex, character in GSM and IRA) will be escaped into 0x5C3044 ('D'). 0x0A (show in hex, character in GSM and IRA) will be escaped into 0x5C3041 ('A'). 0x22 (show in hex, character ' in GSM and IRA) will be escaped into 0x5C3232 ('22'). 0x00 (show in hex, character @ in GSM) will be escaped into 0x5C3030 ('0'). l NOTE te UG95 module does not support this function. uec tial 4.3.13. AT+QCFG='sms/textescape' Character Escape of SMS Text This command is similar to AT+QCFG='ussd/textescape'. The only difference is this command affects Q n SMS text. e AT+QCFG='sms/textescape' Character Escape of SMS Text fid Write Command AT+QCFG='sms/textescape'[,] Response If configuration parameters are omitted (+QCFG='sms/textescape'), return current configuration: +QCFG: 'sms/textescape', Co OK If configuration parameters are entered: OK ERROR Reference If error is related to ME functionality: +CME ERROR: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 53 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter 0 Character escape function of SMS text is disabled 1 Character escape function of SMS text is enabled When AT+CSCS='GSM' or AT+CSCS='IRA', in SMS text outputting: 0x5C (show in hex, character Ö in GSM, character in ASCII) will be escaped into 0x5C3543 ('5C'). 0x0D (show in hex, character in GSM and IRA) will be escaped into 0x5C3044 ('D'). 0x0A (show in hex, character in GSM and IRA) will be escaped into 0x5C3041 ('A'). 0x22 (show in hex, character ' in GSM and IRA) will be escaped into 0x5C3232 ('22'). 0x00 (show in hex, character @ in GSM) will be escaped into 0x5C3030 ('0'). l NOTE te UG95 module does not support this function. uec tial 4.3.14. AT+QCFG='remoteip' Enable/Disable Remote IP Function AT+QCFG='remoteip' is used to set the function whether or not 'remoteip' negotiation will be injected Q n during the PPP dialing period. This parameter will not be saved and it will be effective immediately after e setting. fid AT+QCFG='remoteip' Enable/Disable Remote IP Function Write Command AT+QCFG='remoteip'[,] Response If is absence which means read. +QCFG: 'remoteip', CoOK If none is absence which means setting parameters. OK ERROR Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 54 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Disable/enable the function of 'remoteip' negotiation 0 Default value, no 'remoteip' negotiation 1 Active 'remoteip' negotiation NOTE This default value is '0' for no 'remoteip' negotiation function. New settings are saved in NV. This function becomes effective immediately. Example AT+QCFG='remoteip' +QCFG: 'remoteip',0 l OK AT+QCFG='remoteip',1 te OK AT+QCFG='remoteip' c l +QCFG: 'remoteip',1 ue tia OK AT+QCFG='remoteip',0 OK Q n AT+QCFG='remoteip' e +QCFG: 'remoteip',0 fid OK //Check current status //Setting the 'remoteip' negotiation active //Check current status //Setting the 'remoteip' negotiation inactive //Check current status n 4.3.15. AT+QCFG= 'ppp/firstreqintr' Extension Configuration o AT+QCFG='ppp/firstreqintr' is used to set the interval between CONNECT and first CONFIG_REQ frame C of PPP. AT+QCFG Extension Configuration Test Command AT+QCFG=? Response …… +QCFG: 'ppp/firstreqintr',(1000-10000) …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 55 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+ QCFG='ppp/firstreqintr'[,] Response If configuration parameter is omitted +QCFG: 'ppp/firstreqintr', OK If configuration parameter is entered OK ERROR Parameter A numeric parameter. Default value is 1000. Unit: millisecond l NOTES te 1. The configuration will not be saved into NV. 2. UG95 module does not support this function. uec tial Example AT+QCFG='ppp/firstreqintr',3000 Q n OK AT+QCFG='ppp/firstreqintr' e +QCFG: 'ppp/firstreqinrt',3000 fid OK n 4.3.16. AT+QCFG='stateurc/enable' Enable/Disable State URC Indication o AT+QCFG='urc/port' can configure whether to allow reporting stateurc, this configuration will be saved in C the NV. It is still valid after restarting the module. The State URC refers to those who contain the keyword '+CPIN:', '+CFUN:', '+QUSIM:' or ' QIND:'. AT+QCFG='stateurc/enable' Enable/Disable State URC Indication Read Command AT+QCFG='stateurc/enable' Response +QCFG: 'stateurc/enable', OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 56 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QCFG='stateurc/enable', Response OK ERROR Parameter Integer type, enable/disable State URC indication 0 Disable 1 Enable Example AT+QCFG='stateurc/enable',1 OK AT+QCFG='stateurc/enable' +QCFG: 'stateurc/enable',1 tel OK AT+QCFG='stateurc/enable',0 c l OK AT+QCFG='stateurc/enable' ue tia +QCFG: 'stateurc/enable',0 OK Q en NOTE fid UG95 module does not support this function. n 4.3.17. AT+QCFG='sms/listmsgmap' List the Message Map Co AT+QCFG='sms/listmsgmap' List the Message Map Test Command AT+QCFG=? Response +QCFG: 'sms/listmsgmap',('rec unsend','sto sent') unread','rec read','sto Read Command AT+QCFG? OK Response OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 57 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command List message map AT+QCFG='sms/listmsgmap',< msgmap> Response +QCFG: 'sms/listmsgmap',, OK Reference If error is related to ME functionality: +CME ERROR: Parameter Message type 'rec unread' Received unread messages 'rec read' Received read messages 'sto unsent' 'sto sent' Stored unsent messages Stored sent messages l NOTES te 1. List message map This subcommand lists messages with the type specified by in the storage specified by c l of AT+CPMS; ue tia shows the bit map of total messages in the storage specified by of AT+CPMS. If the bit is 1, it means the message is on the type specified by . If the bit is 0, it means the message is not on the type specified by ; The position of the bit in bit map specified by indicates the message index in the storage Q n specified by of AT+CPMS. The most significant bit represents the less message index in the e storage specified by of AT+CPMS; fid Example AT+QCFG=? //Query supported system configurations n +QCFG: 'sms/listmsgmap',('rec unread','rec read','sto unsend','sto sent') Co OK AT+QCFG? //Query current values of system configurations OK AT+QCFG='wrongsubcommand' //Executed wrong sub command. ERROR AT+CPMS? WCDMA_UGxx_AT_Commands_Manual Confidential / Released 58 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +CPMS: 'SM',45,50,'SM',45,50,'SM',45,50 OK AT+QCFG='sms/listmsgmap','rec unread' //List received read message map +QCFG: 'sms/listmsgmap','rec unread', '77FFFFFFFFC800' OK AT+QCFG? //Query current values of system configurations OK 4.4. AT+QINISTAT Query Initialization State l AT+QINISTAT Query Initialization State te Test Command AT+QINISTAT=? c l Execution Command ue tia AT+QINISTAT Response OK Response +QINISTAT: OK Q n Reference fide Parameter 0 1 n 2 Co 3 No initialization Ready to execute AT command SMS has finished initialization Phonebook has finished initialization NOTE When is 3, it also means initialization of SIM card related functions has been finished. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 59 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 4.5. AT+CIND Command of Control Instructions AT+CIND Command of Control Instructions Test Command AT+CIND=? Response +CIND: (,(list of supported s))[,(,(list of supported s))[,...]] Read Command AT+CIND? OK Response +CIND: [,[,...]] OK If error is related to ME functionality: l +CME ERROR: te Parameter c l ue tia String type, instructions state, values refer to the following notes Integer types, instructs event, related to the value of the Q n NOTES 1. UG95 module does not support this function. e 2. The value of and : fid 'call': call status indication 0: no call 1: call n 'roam': roaming indicator 0: Registered with the ownership or unregistered network 1: Registered to the roaming network o 'signal': signal strength indication 0-5: According to the from weak to strong, divided into five levels C 'service': network service status 0: Not registered on the network indicator 1: Registered to the known network 'GPRS coverage': PS domain registration instructions 0: Unregistered on PS domain 1: Registered on PS domain Example AT+CIND=? +CIND: ('call',(0,1)),('roam',(0,1)),('signal',(0-5)),('service',(0,1)),('GPRS coverage',(0,1)) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 60 / 247 OK AT+CIND? +CIND: 0,0,4,1,1 OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 4.6. AT+QTEMP Temperature Detection AT+QTEMP Temperature Detection Write Command Response AT+QTEMP l Maximum Response Time +QTEMP: OK 300ms cte l Parameter ue tia Integer type. Temperature value (degrees Celsius) Q n Example e AT+QTEMP +QTEMP: 27 Confid OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 61 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 5 SIM Related Commands 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) AT+CIMI requests the International Mobile Subscriber Identity (IMSI) which is intended to permit the TE to identify the individual SIM card or active application in the UICC (GSM or USIM) which is attached to MT. AT+CIMI Request International Mobile Subscriber Identity (IMSI) Test Command l AT+CIMI=? Response OK te Execution Command c l AT+CIMI Response TA returns for identifying the individual SIM which is attached to ME. ue tia OK Q en Maximum Response Time fid Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms Con Parameter International Mobile Subscriber Identity (string without double quotes) Example AT+CIMI 460023210226023 OK //Query IMSI number of SIM which is attached to ME WCDMA_UGxx_AT_Commands_Manual Confidential / Released 62 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 5.2. AT+CLCK Facility Lock AT+CLCK is used to lock, unlock or interrogate a MT or a network facility . The command can be aborted when network facilities are set or interrogated. AT+CLCK Facility Lock Test Command AT+CLCK=? Response +CLCK: (list of supported s) OK Write Command Response AT+CLCK=,[,[ l ,]] This command is used to lock, unlock or interrogate ME or network facility . Password is normally needed to do such actions. When querying the status of a network service (=2) the response line for „not active‟ case (=0) should be returned only if service is not active for any . cte l If is not equal 2 and command is successful: OK ue tia If =2 and command is successful: +CLCK: [,] Q n [+CLCK: [,]] […] e OK fid Maximum Response Time 5s Reference n 3GPP TS 27.007 Co Parameter 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' SIM (lock SIM/UICC card installed in the currently selected card slot) (SIM/UICC asks password in MT power-up when this lock command is issued) BAOC (Bar All Outgoing Calls) (refer to 3GPP TS 22.088 clause 1) BOIC (Bar Outgoing International Calls) (refer to 3GPP TS 22.088 clause 1) BOIC-exHC (Bar Outgoing International Calls except to Home Country) (refer to 3GPP TS 22.088 clause 1) BAIC (Bar All Incoming Calls) (refer to 3GPP TS 22.088 clause 2) BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (refer WCDMA_UGxx_AT_Commands_Manual Confidential / Released 63 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual to 3GPP TS 22.088 clause 2) 'AB' 'AG' All Barring services (refer to 3GPP TS 22.030) (applicable only for =0) All outgoing barring services (refer to 3GPP TS 22.030) (applicable only for =0) 'AC' All incoming barring services (refer to 3GPP TS 22.030) (applicable only for =0) 'FD' SIM card or active application in the UICC (GSM or USIM) fixed dialing memory feature (if PIN2 authentication has not been done during the current session, 'PS' PIN2 is required as ) PH SIM (lock Phone to SIM/UICC card) (MT asks password when other current SIM/UICC card is inserted; MT may remember certain amount of previously used cards thus not requiring Example password when they are inserted) 'PN' Network Personalization (refer to 3GPP TS 22.022) 'PU' Network Subset Personalization (refer to 3GPP TS 22.022) 'PP' Service Provider Personalization (refer to 3GPP TS 22.022) l 'PC' Corporate Personalization (refer to 3GPP TS 22.022) 0 Unlock te 1 Lock 2 Query status c l Password ue tia 1 Voice 2 Data 4 FAX 7 All telephony except SMS (Default) Q n 8 Short message service e 16 Data circuit sync 32 Data circuit async fid 64 Dedicated packet access 128 Dedicated PAD access 0 Off Con 1 On AT+CLCK='SC', 2 +CLCK: 0 //Query the status of SIM card lock, 0-unlock OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 //Lock SIM card, the password is 1234 //Query the status of SIM card lock, 1-lock WCDMA_UGxx_AT_Commands_Manual Confidential / Released 64 / 247 OK AT+CLCK='SC',0,'1234' OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //Unlock SIM card 5.3. AT+CPIN Enter PIN AT+CPIN is used to enter a password or query whether or not the module requires a password which is necessary before it can be operated (SIM PIN, SIM PUK, PH-SIM PIN, etc.). AT+CPIN Enter PIN Test Command AT+CPIN=? Read Command AT+CPIN? ctel l Write Command ue tia AT+CPIN=[,] Q nfiden MaximumResponseTime o Reference C 3GPP TS 27.007 Response OK Response TA returns an alphanumeric string indicating whether or not some password is required. +CPIN: OK Response TA stores a password which is necessary before it can be operated (SIM PIN, SIM PUK, etc.). If the PIN is to be entered twice, the TA shall automatically repeat the PIN. If no PIN request is pending, no action is taken and an error message, +CME ERROR, is returned to TE. If the PIN required is SIM PUK or SIM PUK2, the second pin is required. This second pin, , is used to replace the old pin in the SIM. OK 5s Parameter READY SIM PIN SIM PUK SIM PIN2 SIM PUK2 MT is not pending for any password MT is waiting for SIM PIN to be given MT is waiting for SIM PUK to be given MT is waiting for SIM PIN2 to be given MT is waiting for SIM PUK2 to be given WCDMA_UGxx_AT_Commands_Manual Confidential / Released 65 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual PH-NET PIN MT is waiting for network personalization password to be given PH-NET PUK MT is waiting for network personalization unblocking password to be given PH-NETSUB PIN MT is waiting for network subset personalization password to be given PH-NETSUB PUK MT is waiting for network subset personalization unblocking password to be given PH-SP PIN MT is waiting for service provider personalization password to be given PH-SP PUK MT is waiting for service provider personalization unblocking password to be given PH-CORP PIN MT is waiting for corporate personalization password to be l given PH-CORP PUK MT is waiting for corporate personalization unblocking password to be given Password (string type). If the requested password was a PUK, such as SIM PUK1, PH-FSIM PUK or another password, then must be followed by New password (string type) if the requested code was a PUK. cte l Example ue tia //EnterPIN AT+CPIN? +CPIN: SIM PIN Q n OK e AT+CPIN=1234 fid OK +CPIN: READY n AT+CPIN? Co +CPIN: READY //Query PIN code is locked //Enter PIN //PIN has already been entered OK //Enter PUK and PIN AT+CPIN? +CPIN: SIM PUK //Query PUK code is locked OK AT+CPIN='26601934','1234' OK //Enter PUK and new PIN password WCDMA_UGxx_AT_Commands_Manual Confidential / Released 66 / 247 +CPIN: READY AT+CPIN? +CPIN: READY OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //PUK has already been entered 5.4. AT+CPWD Change Password AT+CPWD sets a new password for the facility lock function defined by command Facility Lock +CLCK. AT+CPWD Change Password Test Command l AT+CPWD=? Response TA returns a list of pairs which present the available facilities and the maximum length of their password. +CPWD: (list of supported s),(s) cte l WriteCommand ue tia AT+CPWD=,, OK Response TA sets a new password for the facility lock function. OK Q n Maximum Response Time 5s e Reference 3GPP TS 27.007 fid Parameter Con 'SC' 'AO' SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command is issued) BAOC (Bar All Outgoing Calls, refer to 3GPP TS 22.088 clause 1) 'OI' BOIC (Bar Outgoing International Calls, refer to 3GPP TS 22.088 clause 1) 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country, refer to 3GPP TS 22.088 clause 1) 'AI' BAIC (Bar All Incoming Calls, refer to 3GPP TS 22.088 clause 2) 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country, refer to 3GPP TS 22.088 clause 2) 'AB' All barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AG' All outgoing barring services (refer to 3GPP TS 22.030, applicable only for =0) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 67 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 'AC All incoming barring services (refer to 3GPP TS 22.030, applicable only for =0) 'PS' PH SIM (lock Phone to SIM/UICC card)(MT asks password when other current SIM/UICC card inserted; MT may remember certain amount of previously used cards thus not requiring password when they are inserted) 'P2' SIM PIN2 'PN' Network Personalization (refer to 3GPP TS 22.022) 'PU' Network Subset Personalization (refer to 3GPP TS 22.022) 'PP' Service Provider Personalization (refer to 3GPP TS 22.022) 'PC' Corporate Personalization (refer to 3GPP TS 22.022) Integer type, max length of password Password specified for the facility from the user interface or with command New password Example l AT+CPIN? te +CPIN: READY c l OK ue tia AT+CPWD='SC','1234','4321' OK //Change SIM card password to '4321' //Restart module or re-activate the SIM card Q n AT+CPIN e +CPIN: SIM PIN //Query PIN code is locked fid OK AT+CPIN=4321 OK //PIN must be entered to define a new password '4321' Con +CPIN: READY 5.5. AT+CSIM Generic SIM Access AT+CSIM allows a direct control of the SIM that is installed in the currently selected card slot by a distant application on the TE. The TE shall then keep the processing of SIM information within the frame specified by GSM/UMTS. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 68 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+CSIM Generic SIM Access Test Command AT+CSIM=? Write Command AT+CSIM= , Response OK Response +CSIM: , OK ERROR If error is related to ME functionality: +CME ERROR: Maximum Response Time Reference 3GPP TS 27.007 300ms l Parameter cte l ue tia Integer type. Length of or string Command transferred by the MT to the SIM in the format as described in 3GPP TS 51.011 Response to the command transferred by the SIM to the MT in the format as described in 3GPP TS 51.011 Q en 5.6. AT+CRSM Restricted SIM Access fid AT+CRSM offers easy and limited access to the SIM database. It transmits the SIM and n required parameters to the MT. o AT+CRSM Restricted SIM Access C Test Command Response AT+CRSM=? OK Write Command Response AT+CRSM=[,[,<P1 +CRSM: ,[,] >,,[,][,]]] OK ERROR If error is related to ME functionality: +CME ERROR: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 69 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 300ms Parameter USIM command number 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY l , , cte l ue tia , CQonfiden 220 UPDATE RECORD 242 STATUS Integer type; identifier for an elementary data file on USIM, if used by Integer type; parameters transferred by the MT to the SIM. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in 3GPP TS 51.011 Information which shall be written to the SIM (hexadecimal character format; refer to +CSCS) Contains the directory path of an elementary file on a UICC in hexadecimal format Integer type; information from the SIM about the execution of the actual command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command Response of a successful completion of the command previously issued (hexadecimal character format; refer to +CSCS). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. The information includes the type of file and its size (refer to 3GPP TS 51.011). After READ BINARY, READ RECORD or RETRIEVE DATA command the requested data will be returned. is not returned after a successful UPDATE BINARY, UPDATE RECORD or SET DATA command 5.7. AT+QCCID Show ICCID AT+QCCID returns the ICCID (Integrated Circuit Card Identifier) number of the SIM card. AT+QCCID Show ICCID Test Command Response WCDMA_UGxx_AT_Commands_Manual Confidential / Released 70 / 247 AT+QCCID=? Execution Command AT+QCCID Maximum Response Time UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK Response +QCCID: OK ERROR 300ms Example AT+QCCID //Query ICCID of the SIM card +QCCID: 898600220909A0206023 OK tel 5.8. AT+QSIMDET SIM Card Detection c l AT+QSIMDET enables SIM/USIM card hotswap function. SIM/USIM card is detected by GPIO interrupt. ue tia You should also set the level of SIM/USIM detecting pin when the SIM card is inserted. This command can be saved by AT&W. Q n AT+QSIMDET SIM Card Detection Test Command e AT+QSIMDET=? Response +QSIMDET: (0,1),(0,1) fid Read Command n AT+QSIMDET? OK Response +QSIMDET: , Co Write Command OK Response AT+QSIMDET=, ERROR Maximum Response Time 300ms Parameter Switch on or off detecting SIM/USIM card 0 Off WCDMA_UGxx_AT_Commands_Manual Confidential / Released 71 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 1 On The level of SIM detection pin when a SIM card is inserted 0 Low level 1 High level NOTE 1. Hotswap function is invalid if the configured value of is inconsistent with hardware design. 2. The configuration will be saved to NV automatically. Example AT+QSIMDET=1,0 OK l +CPIN: NOT READY te c l +CPIN: READY //If SIM/USIM detection pin level is low when SIM/USIM card inserted //If PIN1 of the SIM/USIM card is unlocked Que ntia 5.9. AT+QSIMSTAT SIM Inserted Status Report e AT+QSIMSTAT can query SIM/USIM inserted status or enable SIM/USIM inserted status report. The fid configuration of this command can be saved by AT&W. AT+QSIMSTAT SIM Inserted Status Report n Test Command AT+QSIMSTAT=? Response +QSIMSTAT: (0,1) Co OK Read Command Response AT+QSIMSTAT? +QSIMSTAT: , Write Command AT+QSIMSTAT= Maximum Response Time OK Response OK ERROR 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 72 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Enable or disable SIM/USIM inserted status report. If it is enabled, when SIM/USIM card is removed or inserted, the URC: +QSIMSTAT: , will be reported. 0 Disable 1 Enable SIM/USIM is inserted or removed. This argument is not allowed to be set. 0 Removed 1 Inserted 2 Unknown, before SIM initialization NOTE The configuration will be saved to NV automatically. tel Example AT+QSIMSTAT? c l +QSIMSTAT: 0,1 ue tia OK AT+QSIMDET=1,0 OK Q n AT+QSIMSTAT=1 e OK AT+QSIMSTAT? fid +QSIMSTAT: 1,1 OK n Co +QSIMSTAT : 1,0 //Query SIM/USIM inserted status //Enable SIM/USIM inserted status report //Report of SIM/USIM inserted status, removed +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK +QSIMSTAT : 1,1 //Report of SIM/USIM inserted status, inserted +CPIN: READY WCDMA_UGxx_AT_Commands_Manual Confidential / Released 73 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 6 Network Service Commands 6.1. AT+COPS Operator Selection AT+COPS returns the current operators and their status and allows to set automatic or manual network selection. AT+COPS Operator Selection Test Command ctel l AT+COPS=? Response TA returns a set of five parameters, each representing an operator presenting in the network. Any of the formats may be unavailable and should then be an empty field. The list of operators shall be in the order of: home network, networks referenced in SIM and other networks. ue tia +COPS: (list of supported , long alphanumeric , short alphanumeric , numeric s)[,< Act>])s][,< Q n Plmn_flag>])s] [,,(list of supported s),(list of supported s )] fide OK n Read Command Co AT+COPS? If error is related to ME functionality: +CME ERROR: Response TA returns the current mode and the currently selected operator. If no operator is selected, , and are omitted. +COPS: [,[,][,]] OK Write Command AT+COPS= If error is related to ME functionality: +CME ERROR: Response TA forces an attempt to select and register the GSM/UMTS WCDMA_UGxx_AT_Commands_Manual Confidential / Released 74 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual [,[,]] network operator. If the selected operator is not available, no other operator shall be selected (except =4). The format of selected operator name shall apply to further read commands (+COPS?). OK If error is related to ME functionality: +CME ERROR: Maximum Response Time 180s, determined by network. Reference 3GPP TS 27.007 Parameter l cte l ue tia Q fiden Con 0 Unknown 1 Operator available 2 Current operator 3 Operator forbidden Operator in format as per 0 Automatic mode; field is ignored 1 Manual operator selection; field shall be present and optionally 2 Manual deregister from network 3 Set only (for read command +COPS?), do not attempt registration/deregistration ( and fields are ignored); this value is not applicable in read command response 4 Manual/automatic selected, field shall be presented; if manual selection fails, automatic mode (=0) is entered 0 Long format alphanumeric ; can be up to 16 characters long 1 Short format alphanumeric 2 Numeric ; GSM location area identification number Access technology selected 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 0 Available PLMN is present on EHPLMN List 1 Available PLMN is present on User controlled List 2 Available PLMN is present on Operator controlled List WCDMA_UGxx_AT_Commands_Manual Confidential / Released 75 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Example AT+COPS=? //List all current network operators +COPS: (2,'CHN-UNICOM','UNICOM','46001',2),(1,'CHN-UNICOM','UNICOM','46001',0,0),(3,'CHINA MOBILE','CMCC','46000',0),,(0-4),(0-2) OK AT+COPS? +COPS: 0,0,'CHN-UNICOM',2 //Query the currently selected network operator OK 6.2. AT+CREG Network Registration l AT+CREG returns the network registration status. The write command sets whether or not to present te URC. c l AT+CREG Network Registration Test Command ue tia AT+CREG=? Response +CREG: (list of supported s) Q n Read Command nfide AT+CREG? OK Response TA returns the status of result code presentation and an integer which shows whether the network has currently indicated the registration of the ME. Location information elements and are returned only when =2 and ME is registered in the network. +CREG: ,[,,[,]] Co OK If error is related to ME functionality: +CME ERROR: Write Command Response AT+CREG= TA controls the presentation of an unsolicited result code +CREG: when =1 and there is a change in the ME network registration status. OK Maximum Response Time 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 76 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Reference 3GPP TS 27.007 Parameter 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CREG: 2 Enable network registration unsolicited result code with location information +CREG: [,,[,]] 0 Not registered, ME is not currently searching a new operator to register to 1 Registered, home network 2 Not registered, but ME is currently searching a new operator to register to l cte l 3 Registration denied 4 Unknown 5 Registered, roaming String type, two bytes location area code in hexadecimal format String type, 16 bit (GSM) or 28 bit (UMTS) cell ID in hexadecimal format Access technology selected 0 GSM 2 UTRAN ue tia Example AT+CREG=1 Q n OK e +CREG: 1 fid AT+CREG=2 OK Con +CREG: 1,'D504','08043799',2 //URC reports that ME has registered //Activates extended URC mode //URC reports that operator has found location area code and cell ID 6.3. AT+CSQ Signal Quality Report AT+CSQ indicates the received signal strength and the channel bit error rate . AT+CSQ Signal Quality Report Test Command AT+CSQ=? Response +CSQ: (list of supported s),(list of supported s) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 77 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Execution Command AT+CSQ OK Response +CSQ: , OK +CME ERROR: Execution Command returns received signal strength indication and channel bit error rate from the ME. Test Command returns values supported by the TA. Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter l Quneficdteential 0 -113dBm or less 1 -111dBm 2...30 -109... -53dBm 31 -51dBm or greater 99 Not known or not detectable According to 3GPP TS 27.007 [47], the value is not applicable to 3G networks. Yet, with a view to employing +CSQ for all networks has been designed to show a value derived from the 3G specific RSCP parameter is shown by AT+QENG. Nevertheless, please note that connection quality in 3G networks is depending on further factors. For example, despite good or RSCP values for signal quality, data throughput may vary depending on the number of subscribers sharing the same cell. Channel bit error rate (in percent) 0...7 As RXQUAL values in the table in 3GPP TS 45.008 subclause 8.2.4 99 Not known or not detectable Co Example AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,0 OK //Returns that the current signal strength indication is 28 and channel bit error rate is 0 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 78 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual NOTES After using network related commands such as +CCWA, +CCFC, users are advised to wait for 3s before entering AT+CSQ. This is recommended to ensure that any network access required for the preceding command has been finished. 6.4. AT+CPOL Preferred Operator List AT+CPOL edits and queries the list of preferred operators. AT+CPOL Preferred Operator List Test Command AT+CPOL=? Response +CPOL: (list of supported s),(list of supported s) tel Read Command Quec ntial AT+CPOL? OK Response Query the list of preferred operators: +CPOL: ,, [,,<GSM_compact,] [+CPOL: ,, [,,<GSM_compact,] […]] fide Write Command AT+CPOL=[,[, [,,]] n ] OK Response Edit the list of preferred operators. OK ERROR o If the is given but the is left out, the C entry is deleted. Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter Integer type; the order number of operator in the SIM/USIM preferred operator list 0 Long format alphanumeric WCDMA_UGxx_AT_Commands_Manual Confidential / Released 79 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 1 Short format alphanumeric 2 Numeric String type; indicates the format is alphanumeric or numeric (see +COPS) GSM access technology 0 Access technology is not selected 1 Access technology is selected GSM compact access technology 0 Access technology is not selected 1 Access technology is selected UTRAN access technology 0 Access technology is not selected 1 Access technology is selected NOTE The configuration will be saved to NV automatically. ctel l 6.5. AT+COPN Read Operator Names ue tia The AT+COPN command returns the list of operator names from the ME. Each operator code that has an alphanumeric equivalent in the ME memory is returned. Q n AT+COPN Read Operator Names e Test Command fid AT+COPN=? Execution Command n AT+COPN Response OK Response +COPN: , [+COPN: , […]] Co OK Maximum Response Time Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: Depends on the number of operator names WCDMA_UGxx_AT_Commands_Manual Confidential / Released 80 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter String type; operator in numeric format (see +COPS) String type; operator in long alphanumeric format (see +COPS) 6.6. AT+CTZU Automatic Time Zone Update Set command enables and disables automatic time zone update via NITZ. The configuration is stored to NV automatically. AT+CTZU Automatic Time Zone Update Test Command AT+CTZU=? Response +CTZU: (0,1,3) tel Write Command AT+CTZU= c l Read Command ue tia AT+CTZU? OK Response OK ERROR Response +CTZU: Q n Maximum Response Time e Reference 3GPP TS 27.007 OK 300ms fid Parameter Con Integer type, indicates the mode of automatic time zone update 0 Disable automatic time zone update via NITZ 1 Update GMT time to RTC, time zone to NVRAM 3 Update Local time to RTC, time zone to NVRAM Example AT+CTZU? +CTZU: 0 OK AT+CTZU=? +CTZU: (0,1,3) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 81 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK AT+CTZU=1 OK AT+CTZU? +CTZU: 1 OK AT+CTZU=3 OK AT+CTZU? +CTZU: 3 OK l NOTE te The configuration will be saved to NV automatically. uec tial 6.7. AT+CTZR Time Zone Reporting Q n This command controls the time zone reporting of changed event. If reporting is enabled the MT returns e the unsolicited result code +CTZV: or +CTZE: ,, whenever the time zone is fid changed. The configuration is stored to NV automatically. AT+CTZR Time Zone Reporting n Test Command AT+CTZR=? Response +CTZR: (0-2) Co OK Write Command Response AT+CTZR= OK ERROR Read Command Response AT+CTZR? +CTZR: Maximum Response Time OK 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 82 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Reference 3GPP TS 27.007 Parameter Example AT+CTZR=2 OK AT+CTZR? +CTZR: 2 Integer type, indicates the mode of time zone reporting 0 Disable time zone reporting of changed event 1 Enable time zone reporting of changed event by unsolicited result code +CTZV: 2 Enable extended time zone reporting by unsolicited result code +CTZE: ,, String type, represents the sum of the local time zone (difference between the local time and GMT is expressed in quarters of an hour) plus daylight saving time. The format is '±zz', expressed as a fixed width, two digit integer with the range -48 ... +56. To maintain a fixed width, numbers in the range -9 ... +9 are expressed with a leading zero, e.g. '-09', '+00' and '+09'. l Integer type, indicates whether includes daylight savings adjustment te 0 includes no adjustment for Daylight Saving Time 1 includes +1 hour (equals 4 quarters in ) adjustment for daylight saving c l time 2 includes +2 hours (equals 8 quarters in ) adjustment for daylight saving ue tia time String type, represents the local time. The format is 'YYYY/MM/DD,hh:mm:ss', expressed as integers representing year (YYYY), month (MM), date (DD), hour (hh), Q n minute (mm) and second (ss). This parameter can be provided by the network when delivering time zone information and will be presented in the unsolicited result code of Confide extended time zone reporting if provided by the network. OK +CTZE: '+32',0,'2013/08/23,06:51:13' // is 2 NOTE The configuration will be saved to NV automatically. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 83 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 6.8. AT+QLTS Obtain the Latest Network Time Synchronization AT+QLTS is used to obtain the latest network time synchronization. AT+QLTS Obtain the Latest Network Time Synchronization Test Command Response AT+QLTS=? OK Execution Command AT+QLTS tel Write Command AT+QLTS= Quec ential MaximumResponseTime Response Execution Command returns latest time for Network synchronization: +QLTS: , OK Response +QLTS: , OK ERROR If error is related to ME functionality +CME ERROR: 300ms fid Parameter Con Query network time mode 0 Query latest time that network synchronized 1 Query current GMT time calculated from the latest time that network synchronized 2 Query current LOCAL time calculated from the latest time network synchronized String type. Format is 'YYYY/MM/DD,hh:mm:ss±zz', indicates year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range -48...+56). E.g. 6th of May 2004, 22:10:00 GMT+2 hours. Daylight saving time. It is zero equals to '04/05/06,22:10:00+08,0' NOTES WCDMA_UGxx_AT_Commands_Manual Confidential / Released 84 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual If network has not synchronized the time, AT+QLTS command will only return OK Example AT+QLTS=? +QLTS: (0-2) //Query supported QLTS mode OK AT+QLTS //Query latest time that network synchronized +QLTS: '14/04/29,06:30:15+32,0' OK AT+QLTS=0 //Query latest time that network synchronized. It‟s same as 'AT+QLTS' +QLTS: '14/04/29,06:30:15+32,0' l OK AT+QLTS=1 //Query current GMT time calculated from the latest time that network synchronized te +QLTS: '14/04/29,06:40:43+32,0' c l OK ue tia AT+QLTS=2 //Query current LOCAL time calculated from the latest time network synchronized +QLTS: '14/04/29,14:41:33+32,0' Q n OK fide 6.9. AT+QGPCLASS Change GPRS Multi-slot Class n This command is used to change GPRS multi-slot class o AT+QGPCLASS Change GPRS Multi-slot Class C Test Command Response AT+QGPCLASS=? For UG95 +QGPCLASS: (1-12) OK For UG96 +QGPCLASS: (1-12,30-33,35-38) OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 85 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Read Command AT+QGPCLASS? Response +QGPCLASS: Write Command AT+QGPCLASS= OK Response OK ERROR Reference If error is related to ME functionality: +CME ERROR: Parameter Multi-slot class of GPRS mode tel NOTES c l 1. For UG95 module, the GPRS multi-slot class is in range of 1-12. The default value is 12. ue tia 2. For UG96 module, the GPRS multi-slot class may be 1-12, 30-33 or 35-38. The default value is 33. Example Q n AT+QGPCLASS=12 e OK fid AT+QGPCLASS? +QGPCLASS: 12 OK n AT+QGPCLASS=8 Co OK //Change GPRS multi-slot class to 12 //Query current multi-slot class of GPRS //Change GPRS multi-slot class to 8 NOTE The configuration will be saved to NV automatically. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 86 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 7 Call Related Commands 7.1. ATA Answer an Incoming Call ATA connects the module to an incoming voice or data call indicated by a 'RING' URC. ATA Answer an Incoming Call Execution Command tel ATA Response TA sends off-hook to the remote station. Response in case of data call, if successfully connected CONNECT TA switches to data mode. c l Note: output only if ATX parameter setting with the >0. ue tia When TA returns to command mode after call release: OK Q n Response in case of voice call, if successfully connected: e OK nfid Maximum Response Time o Reference C V.25ter Response if no connection: NO CARRIER 90s, determined by network. NOTES 1. Any additional commands on the same command line are ignored. 2. This command may be aborted generally by receiving a character during execution. The aborting is not possible during some states of connection establishment such as handshaking. 3. See also ATX. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 87 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Example RING AT+CLCC +CLCC: 1,1,4,0,0,'02154450290',129 OK ATA OK //A voice call is ringing //Accept the voice call with ATA 7.2. ATD Mobile Originated Call to Dial a Number ATD can be used to set up outgoing voice and data calls. Supplementary Services can also be controlled with ATD. l ATD Mobile Originated Call to Dial a Number te Execution Command c l ATD[][;] Response This command can be used to set up outgoing voice, data or FAX calls. It also serves to control supplementary services. ue tia If no dial tone and (parameter setting ATX2 or ATX4): NO DIALTONE Q n If busy and (parameter setting ATX3 or ATX4): e BUSY fid If a connection cannot be established: NO CARRIER nIf connection is successful and non-voice call. CONNECT TA switches to data mode. Co outputs only if ATX parameter setting with the >0 When TA returns to command mode after call release: OK Maximum Response Time If connection is successful and voice call: OK 5s, determined by network (AT+COLP=0). WCDMA_UGxx_AT_Commands_Manual Confidential / Released 88 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Reference V.25ter Parameter String of dialing digits and optionally V.25ter modifiers Dialing digits: 0-9, * , #, +, A, B, C Following V.25ter modifiers are ignored: ,(comma), T, P, !, W, @ String of GSM modifiers: I Actives CLIR (Disable presentation of own number to called party) i Deactivates CLIR (Enable presentation of own number to called party) G Activates closed user group invocation for this call only g Deactivates closed user group invocation for this call only Only required to set up voice call, return to command state l NOTES te 1. This command may be aborted generally by receiving an ATH command or a character during execution. The aborting is not possible during some states of connection establishment such as c l handshaking. 2. Parameter 'I' and 'i' only if no *# code is within the dial string. ue tia 3. See ATX command for setting result code and call monitoring parameters. 4. is default value for last number that can be dialed by ATDL. 5. Responses returned after dialing with ATD. Q n For voice call two different responses mode can be determined. TA returns 'OK' immediately either e after dialing was completed or after the call was established. The setting is controlled by AT+COLP. Factory default is AT+COLP=0, which causes the TA to return 'OK' immediately after dialing was fid completed, otherwise TA will return 'OK', 'BUSY', 'NO DIAL TONE', or 'NO CARRIER'. 6. Using ATD during an active voice call:  When a user originates a second voice call while there is already an active voice call, the first n call will be automatically put on hold.  The current states of all calls can be easily checked at any time by using the AT+CLCC Co command. Example ATD10086; OK //Dialing out the party‟s number WCDMA_UGxx_AT_Commands_Manual Confidential / Released 89 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 7.3. ATH Disconnect Existing Connection ATH disconnects circuit switched data calls or voice calls. AT+CHUP is also used to disconnect the voice call. ATH Disconnect Existing Connection Execution Command ATH[n] Response Disconnect existing call by local TE from command line and terminate the call. OK Maximum Response Time 90s, determined by network. Reference V.25ter l Parameter te 0 Disconnect from line and terminate call uec tial 7.4. AT+CVHU Voice Hang up Control Q n AT+CVHU controls whether ATH can be used to disconnect the voice call. e AT+CVHU Voice Hang up Control fid Test Command AT+CVHU=? Response +CVHU: (list of supporteds) on Read Command C AT+CVHU? OK Response +CVHU: Write Command AT+CVHU= OK Response OK ERROR Maximum Response Time 300ms Reference 3GPP TS 27.007 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 90 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter 0 ATH is disconnected 1 ATH is ignored but 'OK' response is returned 7.5. AT+CHUP Hang up Call AT+CHUP cancels all voice calls in the state of Active, Waiting and Held. For data connections, use ATH. AT+CHUP Hang up Call Test Command AT+CHUP=? Execution Command AT+CHUP tel Maximum Response Time Reference c l 3GPP 27.007 ue tia Example Q n RING e AT+CHUP OK Response OK Response OK ERROR 90s, determined by network. //Incoming call //Hang up call nfid 7.6. +++ Switch from Data Mode to Command Mode Co The +++ character sequence causes the module to switch from data mode to AT command mode. It allows inputting AT commands while maintaining the data connection with the remote device. +++ Switch from Data Mode to Command Mode Execution Command +++ Response This command is only available when TA is in data mode. The'+++' character sequence causes the TA to cancel the data flow over the AT interface and switch to command mode. This allows you to enter AT command while maintaining the data connection with the remote server or, accordingly, the packet domain connection. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 91 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference V.25ter OK 300ms NOTES 1. To prevent the '+++' escape sequence from being misinterpreted as data, it should comply to following sequence:  Do not input any character within T1 time (1000ms) before inputting '+++'.  Input '+++' within 1000ms, and no other characters can be inputted during the time.  Do not input any character within T1 time (1000ms) after '+++' has been inputted.  Switch to command mode, otherwise return to step 1. 2. To return from command mode back to data mode: Enter ATO l  Another way to change to command mode is through DTR, refer to AT&D command for details. cte l 7.7. ATO Switch from Command Mode to Data Mode ue tia ATO resumes the connection and switches back from command mode to data mode. Q n ATO Switch from Command Mode to Data Mode Execution Command fide ATO[n] Response TA resumes the connection and switches back from command mode to data mode. If connection is not successfully resumed: nNO CARRIER Else o TA returns to data mode from command mode CONNECT C Maximum Response Time 300ms Reference V.25ter Parameter 0 Switch from command mode to data mode WCDMA_UGxx_AT_Commands_Manual Confidential / Released 92 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual NOTE TA returns to data mode from command mode CONNECT , only if ATX parameter is set as value>0. 7.8. ATS0 Set Number of Rings before Automatically Answering Call ATS0 controls automatic answering mode for the incoming calls. ATS0 Set Number of Rings before Automatically Answering Call Read Command ATS0? l Write Command te ATS0= uec tial MaximumResponseTime Reference V.25ter Response OK Response This parameter setting determines the number of rings before auto-answer. OK 300ms Q en Parameter fid 0 1-255 Automatic answering is disabled Enable automatic answering on the ring number specified n NOTE Co If is set too high, the calling party may hang up before the call is answered automatically. Example ATS0=3 OK //Set three rings before automatically answering a call RING //Call coming RING WCDMA_UGxx_AT_Commands_Manual Confidential / Released 93 / 247 RING UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //Automatically answering the call after three rings 7.9. ATS6 Set Pause before Blind Dialing ATS6 is implemented for compatibility reasons only, and has no effect. ATS6 Set Pause before Blind Dialing Read Command Response ATS6? Write Command ATS6= l Maximum Response Time te Reference V.25ter OK Response OK 300ms uec tial Parameter 0-2-10 Number of seconds to wait before blind dialing Q fiden 7.10. ATS7 Set Number of Seconds to Wait for Connection Completion n ATS7 specifies the amount of time to wait for the connection completion in case of answering or originating a call. If no connection is established during the time, the module disconnects from the line. Co ATS7 Set Number of Seconds to Wait for Connection Completion Read Command Response ATS7? Write Command ATS7= OK Response This parameter setting determines the amount of time to wait for the connection completion in case of answering or originating a call. OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 94 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference V.25ter 300ms Parameter 0 1-255 Disabled Number of seconds to wait for connection completion 7.11. ATS8 Set the Number of Seconds to Wait for Comma Dial Modifier ATS8 is implemented for compatibility reasons only, and has no effect. l ATS8 Set the Number of Seconds to Wait for Comma Dial Modifier te Read Command ATS8? Response uec tial WriteCommand ATS8= Q n Maximum Response Time Reference e V.25ter OK Response OK 300ms fid Parameter n 0 Co 1-2-255 No pause when comma encountered in dial string Number of seconds to wait WCDMA_UGxx_AT_Commands_Manual Confidential / Released 95 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 7.12. ATS10 Set Disconnect Delay after Indicating the Absence of Data Carrier ATS10 determines the amount of time, during which the UE remains connected in absence of a data carrier. ATS10 Set Disconnect Delay after Indicating the Absence of Data Carrier Read Command ATS10? Response Write Command ATS10= ctel l Maximum Response Time Reference ue tia V.25ter OK Response This parameter setting determines the amount of time that the TA will remain connected in absence of data carrier. If the data carrier is once more detected before disconnection, the TA remains connected. OK 300ms Q n Parameter e 1-15-254 Number of tenths of seconds to wait before disconnecting after UE has indicated fid the absence of received line signal n 7.13. AT+CBST Select Bearer Service Type Co AT+CBST write command selects the bearer service , the data rate and the connection element to be used when data calls are originated. AT+CBST Select Bearer Service Type Test Command AT+CBST=? Response +CBST: (list of supported s) ,(list of supported s) ,(list of supported s) Read Command OK Response WCDMA_UGxx_AT_Commands_Manual Confidential / Released 96 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+CBST? +CBST: ,, Write Command AT+CBST=[[,[,]]] OK Response TA selects the bearer service with data rate , and the connection element to be used when data calls are originated. OK Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter 0 l 4 te 5 c l 6 7 ue tia 12 14 15 Q n 16 17 e 39 fid 43 47 48 49 n 50 o 51 C68 Automatic selection of the speed; this setting is possible in case of 3.1kHz modem and non-transparent service 2400 bps (V.22bis) 2400 bps (V.26ter) 4800 bps (V.32) 9600 bps (V.32) 9600 bps (V.34) 14400 bps (V.34) 19200 bps (V.34) 28800 bps (V.34) 32000 bps (V.34) 9600 bps (V.120) 14400 bps (V.120) 19200 bps (V.120) 28800 bps (V.120) 38400 bps (V.120) 48000 bps (V.120) 56000 bps (V.120) 2400 bps (V.110 or X.31 flag stuffing) 70 4800 bps (V.110 or X.31 flag stuffing) 71 9600 bps (V.110) 75 14400 bps (V.110) 79 19200 bps (V.110 or X.31 flag stuffing) 80 28800 bps (V.110 or X.31 flag stuffing) 81 38400 bps (V.110 or X.31 flag stuffing) 82 48000 bps (V.110 or X.31 flag stuffing) 83 56000 bps (V.110 or X.31 flag stuffing; this setting can be used in conjunction with asynchronous non-transparent UDI or RDI service in order to get FTM84 64000 bps (X.31 flag stuffing; this setting can be used in conjunction with asyn-chronous WCDMA_UGxx_AT_Commands_Manual Confidential / Released 97 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual non-transparent UDI service in order to get FTM) 84 64000 bps (X.31 flag stuffing; this setting can be used in conjunction with asynchronous non-transparent UDI service in order to get FTM) 115 56000 bps (bit transparent) 116 64000 bps (bit transparent) 120 32000 bps (PIAFS32k) 121 64000 bps (PIAFS64k) 130 28800 bps (multimedia) 131 32000 bps (multimedia) 132 33600 bps (multimedia) 133 56000 bps (multimedia) 134 64000 bps (multimedia) 0 1 4 5 l 0 1 te 2 3 Asynchronous Modem Synchronous Modem Asynchronous Modem (RDI) Synchronous Modem (RDI) Transparent Non-transparent Both, transparent preferred Both, non-transparent preferred uec tial NOTE 3GPP TS 22.002 lists the allowed combinations of the sub-parameters. Q fiden 7.14. AT+CSTA Select Type of Address AT+CSTA write command selects the type of number for further dialing commands ATD according to n 3GPP Technical Specifications. Test command returns values supported a compound value. Co AT+CSTA Select Type of Address Test Command Response AT+CSTA=? +CSTA: (list of supported s) Read Command AT+CSTA? OK Response +CSTA: Write Command OK Response WCDMA_UGxx_AT_Commands_Manual Confidential / Released 98 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+CSTA= Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter 128-129-255 Current address type settings, e.g: 129 Unknown type 145 International type (contains the character '+') 7.15. AT+CLCC List Current Calls of ME l The execution command returns the list of all current calls. If the command is executed successfully, but te no calls are existed, no information but OK response is sent to the TE. c l AT+CLCC List Current Calls of ME ue tia TestCommand AT+CLCC=? Execution Command CQonfiden AT+CLCC Response OK Response TA returns a list of current calls of ME. If command execute successfully but no calls are existed, no information but OK response is sent to TE. [+CLCC: ,,,,[,,[,< alpha>]] [+CLCC: ,,,,[,,[,< alpha>]] [...] OK Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 99 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Integer type; call identification number as described in 3GPP TS 22.030 sub clause 4.5.5.1; this number can be used in AT+CHLD command operations 0 Mobile originated (MO) call 1 Mobile terminated (MT) call State of the call 0 Active 1 Held 2 Dialing (MO call) ctel l ue tia Q fiden 3 Alerting (MO call) 4 Incoming (MT call) 5 Waiting (MT call) Bearer/tele service 0 Voice 1 Data 2 FAX 0 Call is not one of multiparty (conference) call parties 1 Call is one of multiparty (conference) call parties Phone number in string type in format specified by Type of address of octet in integer format(Refer to 3GPP TS 24.008 , sub clause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type(contains the character '+') 161 National type Alphanumeric representation of corresponding to the entry found in phonebook n 7.16. AT+CR Service Reporting Control Co AT+CR controls the module whether or not to transmit an intermediate result code +CR: to the TE when a call is being set up. If it is enabled, an intermediate result code is transmitted at the point during connect negotiation at which the TA has determined which speed and quality of service will be used, before any error control or data compression reports are transmitted, and before any final result code (e.g. CONNECT) is transmitted. AT+CR Service Reporting Control Test Command AT+CR=? Response +CR: (list of supported s) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 100 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Read Command AT+CR? OK Response +CR: Write Command AT+CR=[] OK Response TA controls whether or not intermediate result code +CR: is returned from the TA to the TE when a call set up. OK Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter tel uec tial 0 1 ASYNC SYNC REL ASYNC REL SYNC GPRS Disable Enable Asynchronous transparent Synchronous transparent Asynchronous non-transparent Synchronous non-transparent GPRS Q fiden 7.17. AT+CRC Set Cellular Result Codes for Incoming Call Indication AT+CRC controls whether or not to use the extended format of incoming call indication. n When it is enabled, an incoming call is indicated to the TE with unsolicited result code +CRING: Co instead of the normal RING. AT+CRC Set Cellular Result Codes for Incoming Call Indication Test Command AT+CRC=? Response +CRC: (list of supported s) Read Command AT+CRC? OK Response +CRC: OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 101 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+CRC=[] Maximum Response Time Reference 3GPP TS 27.007 Response TA controls whether or not the extended format of incoming call indication is used. OK 300ms Parameter 0 Disable extended format l 1 ASYNC SYNC REL ASYNC REL SYNC VOICE Enable extended format Asynchronous transparent Synchronous transparent Asynchronous non-transparent Synchronous non-transparent Voice cte l Example ue tia AT+CRC=1 OK Q n +CRING: VOICE ATH e OK fid AT+CRC=0 OK RING n ATH Co OK //Enable extended format //Indicate incoming call to the TE //Disable extended format //Indicate incoming call to the TE 7.18. AT+CRLP Select Radio Link Protocol Parameter AT+CRLP write command sets radio link protocol (RLP) parameters used when non-transparent data calls are originated. AT+CRLP Select Radio Link Protocol Parameter Test Command Response WCDMA_UGxx_AT_Commands_Manual Confidential / Released 102 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+CRLP=? +CRLP: (list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CRLP? OK Response +CRLP: ,,, OK Write Command Response AT+CRLP=[[,[,[,]]]] non-transparent data calls are set up. Maximum Response Time Reference l 3GPP TS27.007 OK 300ms te Parameter c l ue tia 0-61 0-61 39-48-255 1-6-255 Interworking window size (IWF to MS) Mobile window size (MS to IWF) Acknowledgment timer T1 in a unit of 10ms Retransmission attempts Q fiden 7.19. AT+QHUP Hang up Call with a Specific Release Cause AT+QHUP can terminate call(s) with a specific 3GPP TS 24.008 release cause specified by host n (Including voice and data calls). o AT+QHUP Hang up Call with a Specific Release Cause C Test Command Response AT+QHUP=? OK Write Command Response AT+QHUP=[,] OK ERROR If error is related to ME functionality: +CME ERROR: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 103 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Release cause, 3GPP TS 24.008 release cause to be indicated to the network. 1 Release cause 'unassigned (unallocated) number' 16 Release cause 'normal call clearing' 17 Release cause 'user busy' 18 Release cause 'no user responding' 21 Release cause 'call rejected' 27 Release cause 'destination out of order' 31 Release cause 'normal, unspecified' ctel l 88 Release cause 'incompatible destination' Call identification number is an optional index in the list of current calls indicated by +CLCC. +QHUP will terminate the call identified by the given call number. The default call number 0 is not assigned to any call, but signifies all calls. 0 Terminate all known calls. However, if circuit switches data calls and voice calls at the same time, this command only terminates the CSD calls. 1…7 Terminate the specific call with identification number. ue tia 7.20. AT+QECCNUM Configure Emergency Call Numbers Q en AT+QECCNUM can be used to query, add, delete and replace ECC numbers (emergency call numbers). There are two kinds of ECC numbers, always valid ECC numbers and ECC numbers valid only without fid SIM. The default always valid ECC numbers are 911 and 112. The default ECC numbers without SIM are 00, 08, 110, 999, 118 and 119. The always valid ECC number 911 and 112 cannot be deleted. ECC numbers can be saved into NV automatically. If the SIM card contains ECC File, the numbers in ECC File n can also be regarded as ECC numbers. Co The maximal supported ECC numbers of each type is 20. AT+QECCNUM Configure Emergency Call Numbers Test Command AT+QECCNUM=? Response +QECCNUM: (0-3) Write Command AT+QECCNUM=,[,[,,…[,]] ] OK Response If is equal to 0, query the ECC numbers, should be omitted, return: +QECCNUM: ,,[…] WCDMA_UGxx_AT_Commands_Manual Confidential / Released 104 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK If is not equal to 0: =1 is used to add the ECC number; =2 is used to delete the ECC number. In this case, at least one ECC number should be inputted, returns: OK ERROR If =3 is used to replace the specified ECC number chosen by . In this case, at least one ECC number Read Command l AT+QECCNUM? cte l Maximum Response Time should be inputted, returns: OK ERROR Response +QECCNUM: 0,,[…] +QECCNUM: 1,,[…] OK 300ms ue tia Parameter Q n fide Con ECC number operation mode 0 Query ECC numbers 1 Add ECC numbers 2 Delete ECC numbers 3 Replace specified numbers ECC number type 0 Valid ECC numbers only without SIM 1 Always valid ECC numbers String type; ECC numbers (e.g.110,119), the maximum length is 7 Example AT+QECCNUM=? +QECCNUM: (0-3) //Query the supported ECC number operation mode OK AT+QECCNUM? //Query the ECC numbers always valid or without SIM +QECCNUM: 0,'00','08','110','999','118','119' +QECCNUM: 1,'112','911' WCDMA_UGxx_AT_Commands_Manual Confidential / Released 105 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK AT+QECCNUM=1,0,'110','234' //Add '110' and '234' into the type of ECC numbers without SIM OK AT+QECCNUM=0,0 //Query the ECC numbers without SIM +QECCNUM: 1, '00','08','110','999','118','119','234' OK AT+QECCNUM=2,0,'110' //Delete '110' from the type of ECC numbers without SIM OK AT+QECCNUM=0,0 //Query the ECC numbers without SIM +QECCNUM: 1, '00','08','999','118','119','234' OK AT+QECCNUM=3,0,'115' OK l AT+QECCNUM=0,0 +QECCNUM: 1,'115' //Replace ECC numbers without SIM with '115' //Query the ECC numbers without SIM te OK c l AT+QECCNUM=0,1 ue tia +QECCNUM: 0,'112','911' //Query the ECC numbers always valid OK AT+QECCNUM=1,1,'110','234' //Add '110' and '234' into always valid ECC numbers Q en OK AT+QECCNUM=0,1 //Query the ECC numbers always valid fid +QECCNUM: 0,'112','911',″110″,'234' OK n AT+QECCNUM=3,1,'115' //Replace the always valid ECC numbers with '115' OK o AT+QECCNUM=0,1 //Query the ECC numbers always valid C +QECCNUM: 0,'112','911','115' OK NOTE The configuration will be saved to NV automatically. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 106 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 8 Phonebook Commands 8.1. AT+CNUM Subscriber Number AT+CNUM can get the subscribers own number (s) from the SIM. AT+CNUM Subscriber Number Test Command AT+CNUM=? l Execution Command uecte tial AT+CNUM Response OK Response +CNUM: [],,[,,[,]] [ +CNUM: [],,[,, [,]] [...]] Q en OK ERROR nfid Maximum Response Time o Reference C 3GPP 27.007 If error is related to ME functionality: +CME ERROR: 300ms Parameter Optional alphanumeric string associated with ; the used character set should be the one selected with command Select TE Character Set +CSCS String type phone number of format specified by Type of address of octet in integer format (Refer to 3GPP TS 24.008, subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type WCDMA_UGxx_AT_Commands_Manual Confidential / Released 107 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 145 International type (contains the character '+') 161 National type As defined by the +CBST command Service related to the phone number: 0 Asynchronous modem 1 Synchronous modem 2 PAD Access (asynchronous) 3 Packet Access (synchronous) 4 Voice 5 FAX Information transfer capability: 0 3.1 kHz 1 UDI l 8.2. AT+CPBF Find Phonebook Entries te AT+CPBF can search the phonebook entries starting with the given string from the current c l phonebook memory storage selected with +CPBS, and return all found entries sorted in alphanumeric order. ue tia AT+CPBF Find Phonebook Entries Test Command Q n AT+CPBF=? Response +CPBF: , fide Write Command AT+CPBF= OK Response [+CPBF: ,,,] […] nOK Co ERROR If error is related to ME functionality: +CME ERROR: Maximum Response Time Depends on the storage of phonebook entries. Reference 3GPP 27.007 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 108 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Integer type, indicates the maximum length of field Integer type, indicates the maximum length of field String type, field of maximum length in current TE character set specified by +CSCS Phone number Integer type, in the range of location numbers of phone book memory Type of address of octet in integer format (Refer to 3GPP TS 24.008, subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type(contains the character '+') 161 National type String type, field of maximum length in current TE character set specified by +CSCS tel 8.3. AT+CPBR Read Phonebook Entries c l AT+CPBF can return phonebook entries in location number range ... from the current ue tia phonebook memory storage selected with +CPBS. If is left out, only location is returned. Q n AT+CPBR Read Phonebook Entries Test Command e AT+CPBR=? Response +CPBR: (list of supported s),, fid Write Command on AT+CPBR=[,] OK Response +CPBR: ,,, [+CPBR: ,,, […]] C OK Maximum Response Time Reference 3GPP 27.007 If error is related to ME functionality: +CME ERROR: Depends on the storage of phonebook entries. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 109 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Integer type, in the range of location numbers of phone book memory Integer type, indicates the maximum length of field Integer type, indicates the maximum length of field Phone number The first phone book record to read The last phonebook record to read Type of address of octet in integer format (Refer to 3GPP TS 24.008, subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type(contains the character '+') 161 National type String type, field of maximum length in current TE character set specified by +CSCS tel 8.4. AT+CPBS Select Phonebook Memory Storage c l AT+CPBS selects phonebook memory storage, which is used by other phonebook commands. Read ue tia command returns currently selected memory, the number of used locations and the total number of locations in the memory when supported by manufacturer. Test command returns supported storages as compound value. Q n AT+CPBS Select Phonebook Memory Storage e Test Command AT+CPBS=? Response +CPBS: (list of supported s) fid OK ERROR Con Read Command If error is related to ME functionality: +CME ERROR: Response AT+CPBS? +CPBS: [,,] OK ERROR Write Command AT+CPBS= If error is related to ME functionality: +CME ERROR: Response OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 110 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference 3GPP 27.007 ERROR If error is related to ME functionality: +CME ERROR: 300ms Parameter 'SM' SIM phonebook tel c l 'FD' SIM fix dialing-phone book (+CPBW operation need the authority of PIN2) 'LD' SIM last-dialing-phone book (read only) 'BL' Black list in SIM 'ON' SIM own numbers (MSISDNs) list 'EC' SIM emergency-call-codes phonebook (read only) 'SN' Service dial number (read only) Integer type, indicates the total number of used locations in selected memory Integer type, indicates the total number of locations in selected memory ue tia 8.5. AT+CPBW Write Phonebook Entry Q n AT+CPBW writes phonebook entry in location number in the current phonebook memory storage e selected with +CPBS. It can also delete a phonebook entry in location number . fid AT+CPBW Write Phonebook Entry Test Command n AT+CPBW=? Response +CPBW: (The range of supported s), , (list of supported s), Co OK ERROR Write Command AT+CPBW=[][,[,[,]]] If error is related to ME functionality: +CME ERROR: Response OK ERROR If error is related to ME functionality: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 111 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference 3GPP 27.007 +CME ERROR: 300ms Parameter Integer type, in the range of location numbers of phone book memory. If is not given, the first free entry will be used. If is given as the only parameter, the phonebook entry specified by is deleted Integer type, indicates the maximum length of field ctel l Integer type, indicates the maximum length of field Phone number Type of address of octet in integer format (Refer to 3GPP TS 24.008, subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type field of maximum length in current TE character set specified by +CSCS ue tia Example Q n AT+CSCS='GSM' e OK AT+CPBW=10,'15021012496',129,'QUECTEL' fid OK //Make a new phonebook entry at location 10 AT+CPBW=10 //Delete entry at location 10 Con OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 112 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 9 Short Message Service Commands 9.1. AT+CSMS Select Message Service AT+CSMS selects message service and returns the types of messages supported by the ME. AT+CSMS Select Message Service Test Command AT+CSMS=? Response +CSMS: (list of supported s) tel Read Command c l AT+CSMS? OK Response +CSMS: ,,, ue tia WriteCommand AT+CSMS= OK Response +CSMS: ,, Q n OK fide Maximum Response Time n Reference Co 3GPP TS 27.005 If error is related to ME functionality: +CMS ERROR: 300ms Parameter Type of message service 0 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2 version 4.7.0; Phase 2+ features which do not require new command syntax may be supported, e.g. correct routing of messages with new Phase 2+ data coding schemes) 1 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2+ version; the requirement of WCDMA_UGxx_AT_Commands_Manual Confidential / Released 113 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual setting 1 is mentioned under corresponding command description-s) Mobile terminated messages 0 Type not supported 1 Type supported Mobile originated messages 0 Type not supported 1 Type supported Broadcast type messages 0 Type not supported 1 Type supported Example AT+CSMS=? +CSMS: (0,1) l OK te AT+CSMS=1 +CSMS: 1,1,1 uec tial OK AT+CSMS? +CSMS: 1,1,1,1 Q n OK //Test command //Set type of message service as 1 //Read command fide 9.2. AT+CMGF Message Format n AT+CMGF specifies the input and output format of the short messages. indicates the format of o messages used with send, list, read and write commands and unsolicited result codes resulting from C received messages. Mode can be either PDU mode (entire TP data units used) or text mode (headers and body of the messages given as separate parameters). Text mode uses the value of parameter specified by command +CSCS to inform the character set to be used in the message body in the TA-TE interface. AT+CMGF Message Format Test Command AT+CMGF=? Response +CMGF: (list of supported s) OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 114 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Read Command AT+CMGF? Response +CMGF: Write Command AT+CMGF= OK Response TA sets parameter to denote which kind of I/O format of messages is used. OK Maximum Response Time 300ms Reference 3GPP TS 27.005 Parameter 0 l 1 PDU mode Text mode cte l 9.3. AT+CSCA Service Center Address ue tia AT+CSCA write command updates the SMSC address when mobile originated SMS are transmitted. In text mode, the setting is used by write commands. In PDU mode, setting is used by the same commands, Q n but only when the length of the SMSC address is coded into the parameter which equals to zero. e AT+CSCA Service Center Address fid Test Command AT+CSCA=? Read Command n AT+CSCA? Response OK Response +CSCA: , Co Write Command OK Response AT+CSCA=[,] OK Maximum Response Time Reference 3GPP TS 27.005 If error is related to ME functionality: +CME ERROR: 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 115 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command +CSCS in 3GPP TS 27.007 ); type of address is given by Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ) Example AT+CSCA='+8613800210500',145 //Set SMS service center address OK AT+CSCA? +CSCA: '+8613800210500',145 l OK //Query SMS service center address te NOTE c l The configuration will be saved to NV automatically. Que ntia 9.4. AT+CPMS Preferred Message Storage fide AT+CPMS selects memory storages , and for reading, writing, etc.. AT+CPMS Preferred Message Storage n Test Command Co AT+CPMS=? Response +CPMS: (list of supported s),(list of supported s),(list of supported s) OK Read Command Response AT+CPMS? +CPMS: ,,,,,,,, Write Command AT+CPMS=[,[,<mem OK Response TA selects memory storages , and WCDMA_UGxx_AT_Commands_Manual Confidential / Released 116 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 3>]] to be used for reading, writing, etc. +CPMS: ,,,,, OK Maximum Response Time Reference 3GPP TS 27.005 If error is related to ME functionality: +CMS ERROR: 300ms Parameter Example Messages to be read and deleted from this memory storage l 'BM' Broadcast message storage 'SM' SIM message storage te 'SR' Status report storage c l Messages will be written and sent to this memory storage 'SM' SIM message storage ue tia Storage to which received SMs are preferred to be stored (unless forwarded directly to TE. Refer command New Message Indications +CNMI). Refer to for defined values. Received CBMs are always stored in 'BM' (or some manufacturer specific Q n storage) unless directly forwarded to TE. Received status reports are always stored in 'SR' (or some manufacturer specific storage) unless directly forwarded to TE. e 'BM' Broadcast message storage fid 'SM' SIM message storage 'SR' Status report storage Integer type, number of current messages in Con Integer type, total number of messages which can be stored in AT+CPMS='SM','SM','SM' //Set SMS message storage as 'SM' +CPMS: 0,50,0,50,0,50 OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //Query the current SMS message storage OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 117 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 9.5. AT+CMGD Delete Message AT+CMGD deletes a short message from the preferred message storage location . If is presented and not set to 0, then the ME shall ignore and follow the rules of shown as below. AT+CMGD Delete Message Test Command AT+CMGD=? Response +CMGD: (list of supported s),(list of supported s) Write Command AT+CMGD=[,] uectel tial MaximumResponseTime Reference Q n 3GPP TS 27.005 OK Response TA deletes message from preferred message storage location . OK If error is related to ME functionality: +CMS ERROR: 300ms. Note: Operation of depends on the storage of deleted messages. e Parameter fid Con Integer type, in the range of location numbers supported by the associated memory 0 Delete the message specified in 1 Delete all read messages from storage, leaving unread messages and stored mobile originated messages (whether sent or not) untouched 2 Delete all read messages from storage and sent mobile originated messages, leaving unread messages and unsent mobile originated messages untouched 3 Delete all read messages from storage, sent and unsent mobile originated messages, leaving unread messages untouched 4 Delete all messages from storage Example AT+CMGD=1 OK //Delete the message specified in =1 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 118 / 247 AT+CMGD=1,4 OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //Delete all messages from storage 9.6. AT+CMGL List Messages AT+CMGL write command returns messages with status value from preferred message storage to the TE. If the status of the message is 'REC UNREAD', the status in the storage changes to 'REC READ'. When executing command AT+CMGL without status value , it will report the list of SMS with 'REC UNREAD' status. AT+CMGL List Messages Test Command AT+CMGL=? tel Write Command CQouneficdential AT+CMGL= Response +CMGL: (list of supported s) OK Response If text mode (+CMGF=1) and command successful: For SMS-SUBMITs and/or SMS-DELIVERs: +CMGL: ,,,[],[][,,< length>][ +CMGL: ,,,[],[][,,< length>][...]] For SMS-STATUS-REPORTs: +CMGL: ,,,,[],[],,,[ +CMGL: ,,,,[],[],,,[...]] For SMS-COMMANDs: +CMGL: ,,,[ +CMGL: ,,,[...]] For CBM storage: +CMGL: ,,,,,[ +CMGL: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 119 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual ,,,,,[...]] OK Else if PDU mode (+CMGF=0) and Command successful: +CMGL: ,,[], +CMGL: ,,[alpha],[...]] OK Execution Command l AT+CMGL cte l Maximum Response Time ue tia Reference 3GPP TS 27.005 Else if error is related to ME functionality: +CMS ERROR: Response List all messages with 'REC UNREAD' status from message storage , then status in the storage changes to 'REC READ'. 300ms. Note: Operation of depends on the storage of listed messages. Q en Parameter Confid In text mode: 'REC UNREAD' 'REC READ' 'STO UNSENT' 'STO SENT' 'ALL' In PDU mode: Received unread messages Received read messages Stored unsent messages Stored sent messages All messages 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages 4 All messages Integer type, in the range of location numbers supported by the associated memory Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command WCDMA_UGxx_AT_Commands_Manual Confidential / Released 120 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +CSCS in 3GPP TS 27.007 ); type of address is given by Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command +CSCS in TS 27.007); type of address is given by String type alphanumeric representation of or corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer specified; the used character set should be the one selected with command Select TE Character Set +CSCS (see definition of this command in 3GPP TS 27.007) Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ) Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ) Message length, integer type, indicating in the text mode (+CMGF=1) the length l of the message body (or ) in characters; or in PDU mode (+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets te are not counted in the length) In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: c l - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used and ue tia indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set - If TE character set other than 'HEX' (refer to command Select TE Character Set +CSCS in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A Q n - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7 bit e default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7 bit default alphabet 23) is presented as 17 (IRA 49 and 55)) fid - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. n octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) o In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode Cresponses; format: - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used: - If TE character set other than 'HEX' (refer to command +CSCS in 3GPP TS27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7 bit default alphabet into two IRA character long hexadecimal number - If , indicates that 8-bit or UCS2 data coding scheme is used: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU WCDMA_UGxx_AT_Commands_Manual Confidential / Released 121 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65))3GPP TS 27.007 Example AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, //Set SMS message format as text mode //List all messages from message storage +CMGL: 2,'STO UNSENT','',, OK tel 9.7. AT+CMGR Read Message uec tial AT+CMGR write command returns SMS message with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage changes to 'REC READ'. Q n AT+CMGR Read Message e Test Command fid AT+CMGR=? Write Command Con AT+CMGR= Response OK Response TA returns SMS message with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage changes to 'REC READ'. 1) If text mode (+CMGF=1) and command is executed successfully: For SMS-DELIVER: +CMGR: ,,[],[,,,,,< sca>,,] OK For SMS-SUBMIT: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 122 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +CMGR: ,,[][,,,,,[],< sca>,,] OK For SMS-STATUS-REPORTs: +CMGR: ,,,[],[],,, OK CQouneficdteenl tial MaximumResponseTime For SMS-COMMANDs: +CMGR: ,,[,,[],[],[],< CR>] OK For CBM storage: +CMGR: ,,,,, OK 2) If PDU mode (+CMGF=0) and command successful: +CMGR: ,[], OK 3) If error is related to ME functionality: +CMS ERROR: Depends on the length of message content. Reference 3GPP TS 27.005 Parameter Integer type, in the range of location numbers supported by the associated memory PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages WCDMA_UGxx_AT_Commands_Manual Confidential / Released 123 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages String type alphanumeric representation of or corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer specified; the used character set should be the one selected with command Select TE Character Set +CSCS (see definition of this command in 3GPP TS 27.007 ) Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command +CSCS in 3GPP TS 27.007 ); type of address is given by Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command +CSCS in TS 27.007); type of address is given by Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in l time-string format (refer to ) First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 te SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND in integer format. If a valid value has been entered once, parameter c l can be omitted ue tia Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0) Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 Q n SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format e Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ) fid Message number. 3GPP TS 23.040 TP-Message-Number in integer format Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format Recipient address. 3GPP TS 23.040 TP-Recipient-Address Address-Value field in n string format; BCD numbers (or GSM default alphabet characters) are converted to o characters of the currently selected TE character set (refer to command AT+CSCS); type of address given by CType of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (default refer to ) Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ) Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command +CSCS in 3GPP TS 27.007 ); type of address is given by WCDMA_UGxx_AT_Commands_Manual Confidential / Released 124 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Example Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ) Message length, integer type, indicating in the text mode (+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used and indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set: - If TE character set other than 'HEX' (refer to command Select TE Character Set +CSCS in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7 bit default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7 bit default alphabet 23) is presented as 17 (IRA 49 and 55)) - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates l that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer te value 42 is presented to TE as two characters 2A (IRA 50 and 65) In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode c l responses; format: ue tia - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used: - If TE character set other than 'HEX' (refer to command +CSCS in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according rules of Annex A Q n - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7 bit e default alphabet into two IRA character long hexadecimal number - If , indicates that 8-bit or UCS2 data coding scheme is used: ME/TA converts fid each 8-bit octet into two IRA character long hexadecimal number In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA n character long hexadecimal number (e.g. octet with integer value 42 is presented to TE Co as two characters 2A (IRA 50 and 65)) 3GPP TS 27.007 +CMTI: 'SM',3 //Indicates that new message has been received and saved to =3 of 'SM' AT+CSDH=1 OK AT+CMGR=3 //Read message +CMGR: 'REC UNREAD','+8615021012496',,'2014/02/13 15:06:37+32',145,4,0,0,'+8 613800210500',145,27 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 125 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK 9.8. AT+CMGS Send Message AT+CMGS write command sends a short message from TE to network (SMS-SUBMIT). After invoking the write command, wait for the prompt '>' and then start to write the message. After that, enter to indicate the ending of PDU and begin to send the message. Sending can be cancelled by giving character. Abortion is acknowledged with 'OK', though the message will not be sent. The message reference is returned to the TE on successful message delivery. The value can be used to identify message upon unsolicited delivery status report result code. AT+CMGS Send Message Test Command l AT+CMGS=? Write Command te 1) If text mode (+CMGF=1): c l AT+CMGS=[,] text is entered ue tia ESC quits without sending Q n 2) If PDU mode (+CMGF=0): AT+CMGS= e PDU is given Response OK Response TA sends message from TE to the network (SMS-SUBMIT). Message reference value is returned to the TE on successful message delivery. Optionally (when +CSMS value is 1 and network supports) is returned. Values can be used to identify message upon unsolicited delivery status report result code. If text mode (+CMGF=1) and sent successfully: +CMGS: OK fid If PDU mode (+CMGF=0) and sent successfully: +CMGS: onOK C If error is related to ME functionality: +CMS ERROR: Maximum Response Time 120s, determined by network. Reference 3GPP TS 27.005 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 126 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command +CSCS in 3GPP TS 27.007 ); type of address is given by Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format Message length. Integer type, indicating in the text mode (+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format Example l AT+CMGF=1 OK te AT+CSCS='GSM' OK c l AT+CMGS='15021012496' ue tia > +CMGS: 247 Q n OK AT+CMGF=1 e OK AT+CSCS='GSM' fid OK AT+CMGS='15021012496' > Con OK //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text, send message //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text, quits without sending 9.9. AT+CMMS More Messages to Send AT+CMMS controls the continuity of the SMS relay protocol link. If the feature is enabled (and supported by the currently used network) multiple messages can be sent faster as the link is kept open. AT+CMMS More Messages to Send Test Command AT+CMMS=? Response +CMMS: (list of supporteds) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 127 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Read Command AT+CMMS? OK Response +CMMS: Write Command AT+CMMS= OK Response OK ERROR If error is related to ME functionality: +CMS ERROR: Maximum Response Time Reference 3GPP TS 27.005 120s, determined by network. l Parameter te 0 c l 1 Que entia 2 Feature disabled Keep enabled until the time between the response of the latest message send command (+CMGS, +CMSS, etc.) and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation), then ME shall close the link and TA switches back to 0 automatically Enable (if the time between the response of the latest message send command and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation), ME shall close the link but TA will not switch back to 0 automatically) fid 9.10. AT+CMGW Write Message to Memory on AT+CMGW write and execution commands store a short message from TE to memory storage . C Memory location of the stored message is returned. Message status will be set to 'stored unsent' by default, but parameter also allows other status values to be given. The syntax of input text is same as the one specified in the write command +CMGS. AT+CMGW Write Message to Memory Test Command AT+CMGW=? Write Command 1) If text mode (+CMGF=1): AT+CMGW=[,[,<st Response OK Response TA transmits SMS message (either SMS-DELIVER or SMS-SUBMIT) from TE to memory storage . WCDMA_UGxx_AT_Commands_Manual Confidential / Released 128 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual at>]] text is entered quits without sending 2) If PDU mode (+CMGF=0): AT+CMGW=[,] PDU is given Memory location of the stored message is returned. By default message status will be set to 'stored unsent', but parameter also allows 'stored sent' status to be given. If writing is successful: +CMGW: OK If error is related to ME functionality: +CMS ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.005 l Parameter te uec tial Q en fid Con Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command +CSCS in 3GPP TS 27.007 ); type of address is given by Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command +CSCS in TS 27.007); type of address given by Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ) PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format Message length. Integer type, indicating in the text mode (+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.04TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 129 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Index of message in selected storage Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > +CMGW: 4 //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text, write message OK AT+CMGF=0 //Set SMS message format as PDU mode OK AT+CMGW=18 l > 0051FF00000008000A0500030002016D4B8BD5 te +CMGW: 5 c l OK AT+CMGF=1 ue tia OK AT+CSCS='GSM' OK Q n AT+CMGW='15021012496' e > +CMGW: 6 //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text, quits without sending fid OK Con 9.11. AT+CNMA New Message Acknowledgement to UE/TE AT+CNMA write and execute command confirms successful receipt of a new message (SMS-DELIVER or SMS-STATUS-REPORT) routed directly to the TE. If the UE does not receive acknowledgement within the required time (net-work timeout), then it will send a 'RP-ERROR' message to the network. The UE will automatically disable rout to the TE by setting both and values of AT+CNMI to 0. AT+CNMA New Message Acknowledgement to UE/TE Test Command AT+CNMA=? Response +CNMA: (list of supported s) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 130 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Execution Command AT+CNMA OK Response OK ERROR Write Command AT+CNMA= If error is related to ME functionality: +CMS ERROR: Response OK ERROR If error is related to ME functionality: Maximum Response Time Reference l 3GPP TS 27.005 +CMS ERROR: 300ms te Parameter c l Parameter required only for PDU mode ue tia 0 Command operates similarly as in text mode 1 Send positive (RP-ACK) acknowledgement to the network. Accepted only in PDU mode 2 Send negative (RP-ERROR) acknowledgement to the network. Accepted only in PDU Q n mode fide NOTE Execute and write command shall only be used when AT+CSMS parameter equals to 1 (phase 2+) and an appropriate URC has been issued by the module, i.e.: n +CMT for =2 incoming message classes 0,1,3 and none +CMT for =3 incoming message classes 0 and 3 Co +CDS for =1. Example AT+CSMS=1 OK AT+CNMI=1,2,0,0,0 OK +CMT: '+8615021012496',,'13/12/03,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when SMS is incoming WCDMA_UGxx_AT_Commands_Manual Confidential / Released 131 / 247 AT+CNMA OK AT+CNMA +CMS ERROR：340 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //Send ACK to the network //The second time returns error, it needs ACK only once 9.12. AT+CNMI SMS Event Reporting Configuration AT+CNMI write command selects the procedure, on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR signal is ON. If TE is inactive (e.g. DTR signal is OFF), message receiving should be done as specified in 3GPP TS 23.038. AT+CNMI SMS Event Reporting Configuration Test Command l AT+CNMI=? Response +CNMI: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) cte l ReadCommand ue tia AT+CNMI? OK Response +CNMI: ,,,, Q n Write Command AT+CNMI=[,[,[,[,]]]] OK Response TA selects the procedure on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR signal is ON. If TE is inactive (e.g. DTR signal is OFF), message receiving should be done as specified in 3GPP TS 23.038. nOK o ERROR C If error is related to ME functionality: +CMS ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.005 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 132 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter 0 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications 1 Discard indication and reject new received message unsolicited result codes when TA-TE link is reserved (e.g. in on-line data mode). Otherwise forward them directly to the TE 2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in on-line data mode) and flush them to the TE after reservation. Otherwise forward them directly to the TE The rules for storing received SMs depend on its data coding scheme (refer to 3G PPTS 23.038), and preferred memory storage (+CPMS) setting; and the value is: 0 No SMS-DELIVER indications are routed to the TE 1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE by using unsolicited result code: +CMTI: , l 2 SMS-DELIVERs (except class 2) are routed directly to the TE using unsolicited result code: +CMT: [], (PDU mode enabled) te or +CMT:,[],[,,,,,,, ] (Text mode enabled; about parameters in italics, c l refer to Command Show Text Mode Parameters +CSDH). Class 2 messages ue tia result in indication as defined in =1 3 Class 3 SMS-DELIVERs are routed directly to TE by using unsolicited result codes defined in =2. Messages of other classes result in indication as defined in =1 Q n The rules for storing received CBMs depend on its data coding scheme (refer to 3 e GPP TS 23.038), and the setting of Select CBM Types (+CSCB); and the value is: 0 No CBM indications are routed to the TE fid 1 If CBM is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CBMI: , n 2 New CBMs are routed directly to the TE using unsolicited result code: +CBM: (PDU mode) o+CBM: ,,,, (text mode) C3 Class 3 CBMs are routed directly to TE using unsolicited result codes defined in =2. If CBM storage is supported, messages of other classes result in indication as defined in =1. 0 No SMS-STATUS-REPORTs are routed to the TE 1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +CDS: (PDU mode) +CDS: ,,[],[],,, (text mode) 2 If SMS-STATUS-REPORT is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CDSI:, WCDMA_UGxx_AT_Commands_Manual Confidential / Released 133 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 0 TA buffer of unsolicited result codes defined within this command is flushed to the TE when 1...2 is entered ('OK' response shall be given before flushing the codes) 1 TA buffer of unsolicited result codes defined within this command is cleared when 1...2 is entered NOTE Unsolicited result code: +CMTI: , Indicates that new message has been received +CMT: [], Short message is outputted directly +CBM: Cell broadcast message is outputted directly +CBMI: , Cell broadcast message is stored and routed to the TE Example l AT+CMGF=1 OK te AT+CSCS='GSM' c l OK AT+CNMI=1,2,0,1,0 ue tia OK //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Set SMS-DELIVERs are routed directly to the TE +CMT: '+8615021012496',,'2014/03/18 17:07:21+32' Q n This is a test from Quectel. //Short message is outputted directly when SMS is incoming. fide 9.13. AT+CSCB Select Cell Broadcast Message Types n AT+CSCB write command selects which types of CBMs are to be received by the ME. The command writes the parameters in non-volatile memory. Co AT+CSCB Select Cell Broadcast Message Types Test Command Response AT+CSCB=? It returns supported modes as a compound value. +CSCB: (list of supported s) Read Command AT+CSCB? OK Response +CSCB: ,, OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 134 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+CSCB=[,mids>[,]] Response TA selects which types of CBMs are to be received by the ME. OK Maximum Response Time Reference 3GPP TS 27.005 If error is related to ME functionality: +CMS ERROR: 300ms Parameter tel 0 Message types specified in and are accepted 1 Message types specified in and are not accepted String type, all different possible combinations of CBM message identifiers (refer to ) (default is empty string), e.g. '0,1,5,320-478,922' String type, all different possible combinations of CBM data coding schemes (refer to ) (default is empty string), e.g. '0-3,5' uec tial 9.14. AT+CSDH Show SMS Text Mode Parameters Q n AT+CSDH write command controls whether or not detailed header information is shown in text mode e result codes. fid AT+CSDH Show SMS Text Mode Parameters Test Command AT+CSDH=? Response +CSDH: (list of supported s) on Read Command C AT+CSDH? OK Response +CSDH: Write Command AT+CSDH= Maximum Response Time Reference 3GPP TS 27.005 OK Response OK ERROR 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 135 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter 0 1 Do not show header values defined in commands +CSCA and +CSMP (, , , , and ) nor , or in +CMT, +CMGL, +CMGR result codes for SMS-DELIVERs and SMS-SUBMITs in text mode Show the values in result codes Example AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT','', l OK AT+CSDH=1 te OK AT+CMGR=2 c l +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 ue tia OK Q en 9.15. AT+CSMP Set SMS Text Mode Parameters fid AT+CSMP is used to set values for additional parameters needed when a short message is sent to the network or placed in a storage in text mode. on AT+CSMP Set SMS Text Mode Parameters C Test Command Response AT+CSMP=? OK Read Command Response AT+CSMP? +CSMP: ,,, Write Command AT+CSMP=[[,[,[,] ]]] OK Response TA selects values for additional parameters needed when SM is sent to the network or placed in a storage when text mode is selected (+CMGF=1). It is possible to set the validity period WCDMA_UGxx_AT_Commands_Manual Confidential / Released 136 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference 3GPP TS 27.005 starting from when the SM is received by the SMSC ( is in range 0... 255) or define the absolute time of the validity period termination ( is a string). OK 300ms Parameter First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 l cte l SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT SMS-COMMAND in integer format. If a valid value has been entered once, parameter can be omitted Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ) Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format ue tia 9.16. AT+QCMGS Send Concatenated Messages Q en AT+QCMGS is used to send concatenated massages. When sending a concatenated message, which is different from AT+CMGS, each segment of the concatenated message must be identified by the fid additional parameters: , and . When sending all segments of the message one by one, AT+QCMGS must be executed multiple times (equal to ) for each segment. This command is only used in text mode (AT+CMGF=1). n AT+QCMGS Send Concatenated Messages o Test Command C AT+QCMGS=? Response OK Write Command Response If text mode (+CMGF=1): If text mode (+CMGF=1) and sent successfully: AT+QCMGS=[,][,,<m +QCMGS: sg_seg>,] text is entered OK ERROR If error is related to ME functionality: +CMS ERROR: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 137 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time 120s, determined by network. Parameter Message identification in the user data header (UDH). Range from 0 to 255. This parameter is defined and inputted by the user. All segments of a same concatenated message must have the same . Different concatenated messages should have different . Sequence number of a concatenated message. Range from 0 to 7. =0 means: ignore the value and regarded it as a non-concatenated message. ,, The total number of the segments of one concatenated message. Range from 0 to 7. =0 or 1 means: ignore the value and regard it as a non-concatenated message. Please refer to AT+CMGS tel NOTES c l 1. For concatenated messages, the maximum length will be reduced by the length of the user data header (UDH). 3GPP TS 23.040 defines two kinds of UDH length: 6 bytes and 7 bytes, so the two ue tia kinds of are 8 bit (6 bytes) and 16 bit (7 bytes). AT+QCMGS uses 8 bit .  In the case of GSM 7 bit default alphabet data coding scheme, the maximum length of each segment of a concatenated message is (140 octets - 6 )*8/7=153 characters. Q n  In the case of 16 bit UCS2 data coding scheme, the maximum length of each segment is (140-6)/2=67 characters. e  In the case of 8-bit data coding scheme, the maximum length of each segment is 140-6=134. fid 2. , Message-Reference field gives an integer representation of a reference number of the SMS-SUBMIT or SMS-COMMAND submitted to the SC by the MS, and it is used to confirm the SMS-DELIVER received from SC duplicate or not. , the field of UDH, is message identification of the concatenated SMS, which is different from . Each segment in a concatenated message n should have the same , but must be incremented for each segment of a concatenated o message. C 3. AT+QCMGS does not support to send message in PDU mode (AT+CMGF=0). Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+QCMGS='15056913384',120,1,2 >ABCD WCDMA_UGxx_AT_Commands_Manual //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Input 120 for , send the first segment of the concatenated SMS Confidential / Released 138 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +QCMGS: 190 OK AT+QCMGS= '15056913384',120,2,2 >EFGH +QCMGS: 191 //Send the second segment of the concatenated SMS. OK 9.17. AT+QCMGR Read Concatenated Messages The function of AT+QCMGR is similar to AT+CMGR, except that the message to be read is a segment of concatenated messages, parameters: , and would be shown in the result. You should concatenate several segments to a whole concatenated message according to these three l parameters. Similar to AT+QCMGS, and AT+QCMGR is only used in text mode (AT+CMGF=1). te AT+QCMGR Read Concatenated Messages c l Test Command AT+QCMGR=? ue tia WriteCommand Q fiden AT+QCMGR= Response OK Response If text mode (+CMGF=1) and command is executed successfully: For SMS-DELIVER: +QCMGR: ,,[],[,,,,,< sca>,,][,,,] OK nFor SMS-SUBMIT: o +QCMGR: ,,[][,,,,,[],< C sca>,,][,,,] OK For SMS-STATUS-REPORTs: +QCMGR: ,,,[],[],,, OK For SMS-COMMANDs: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 139 / 247 Maximum Response Time UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +QCMGR: ,,[,,[],[],[],< CR>] OK Else, if error is related to ME functionality: +CMS ERROR: Depends on the length of message content. Parameter l te Message identification in the user data header (UDH). Range from 0 to 65535 (see NOTES). All segments of a same concatenated message have same . Different concatenated messages should have different . Sequence number of a concatenated message. Range from 1 to 7. The total number of the segments of one concatenated message. Range is from 2 to 7. Other parameters please refer to AT+CMGR uec tial NOTES 1. The in AT+QCMGR is different from the in AT+QCMGS. It is possible that UE receives concatenated messages with 8 bits or 16 bits . So its maximal value is 255 with 8 bits and Q n 65535 with 16 bits. 2. If the message to be read is not a concatenated message, , and e would not be showed in the result. fid Example n +CMTI: 'SM',3 Co +CMTI: 'SM',4 //The first message of a concatenated message comes //The second message of a concatenated message comes AT+QCMGR= 3 //Read the first segment of the concatenated message +QCMGR: 'REC UNREAD','+8615056913384',,'13/07/30,14:44:37+32',120,1,2 ABCD OK AT+QCMGR= 4 //Read the second segment of the concatenated message +QCMGR: 'REC UNREAD','+8615056913384',,'13/07/30,14:44:37+32',120,2,2 EFGH OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 140 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 10 Packet Domain Commands 10.1. AT+CGATT Attachment or Detachment of PS The AT+CGATT write command is used to attach the MT to, or detach the MT from the packet domain service. After the command has been completed, the MT remains in V.25ter command state. If the MT is already in the requested state, the command is ignored and the OK response will be returned. If the requested state cannot be achieved, an ERROR or +CME ERROR response is returned. l AT+CGATT Attachment or Detachment of PS te Test Command AT+CGATT=? Response +CGATT: (list of supported s) uec tial ReadCommand AT+CGATT? OK Response +CGATT: Q n Write Command e AT+CGATT= OK Response OK nfid Maximum Response Time o Reference C 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 75s, determined by network. Parameter Indicates the state of PS attachment 0 Detached 1 Attached Other values are reserved and will result in an ERROR response to the Write Command WCDMA_UGxx_AT_Commands_Manual Confidential / Released 141 / 247 Example AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //Attach to PS service //Detach from PS service //Query the current PS service state NOTE The configuration will be saved to NV automatically. tel 10.2. AT+CGDCONT Define PDP Context c l AT+CGDCONT specifies PDP context parameters for a specific context . A special form of the write ue tia command (AT+CGDCONT=) causes the values for context to become undefined. It is not allowed to change the definition of an already activated context. The AT+CGDCONT read command returns the current settings for each defined PDP context. Q en AT+CGDCONT Define PDP Context Test Command fid AT+CGDCONT=? Response +CGDCONT: (range of supported s), , , , (list of supported s), (list of supported s) on Read Command C AT+CGDCONT? OK Response [+CGDCONT: ,,,,,] […] Write Command AT+CGDCONT=[,[,< APN>[,[,[,< head_comp>]]]]] OK Response OK ERROR If error is related to ME functionality: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 142 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 +CME ERROR: 300ms Parameter PDP context identifier, a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of the command Packet data protocol type, a string parameter which specifies the type of packet data protocol 'IP' IPV4 l 'IPV6' 'IPV4V6' te Access point name, a string parameter that is a logical name used to select the GGSN or the external packet data network. If the value is null or omitted, then the c l subscription value will be requested A string parameter identifies the MT in the address space applicable to the PDP. If the ue tia value is null of omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The allocated address may be read using the +CGPADDR command Q n A numeric parameter that controls PDP data compression (applicable for SNDCP only) e (refer to 3GPP TS 44.065) 0 Off (default if value is omitted) fid 1 On (manufacturer preferred compression) 2 V.42bis A numeric parameter that controls PDP header compression (refer to 3GPP TS 44.065 n and 3GPP TS 25.323) 0 Off o 1 On C2 RFC1144 3 RFC2507 4 RFC3095 NOTE The configuration will be saved to NV automatically. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 143 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 10.3. AT+CGQREQ Quality of Service Profile (Requested) AT+CGQREQ allows the TE to specify the quality of service profile that is used when the MT activates a PDP context. The write command specifies a profile for the context which is a special form of the write command. AT+CGQREQ= causes the requested profile for context number to become undefined. The read command returns the current settings for each defined context. Details can be found in 3GPP TS 23.107 and all parameters are saved in NV automatically. AT+CGQREQ Quality of Service Profile (Requested) Test Command tel AT+CGQREQ=? Response +CGQREQ: , (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s) uec tial ReadCommand Q fiden AT+CGQREQ? OK Response [+CGQREQ: ,,,,,] [+CGQREQ: ,,,,,] […] n Write Command o AT+CGQREQ=[,[, [,[,[,]]]]] OK Response OK If error is related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.007 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 144 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter A numeric parameter which specifies a particular PDP context definition (see +CGDCONT command) A numeric parameter which specifies the precedence class 0 Network subscribed value 1 High priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments shall be maintained ahead of precedence class 3 3 Low priority. Service commitments shall be maintained A numeric parameter which specifies the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the detail please refer to Table 4: Delay Class 0 Network subscribed value A numeric parameter which specifies the reliability class l 0 Network subscribed value 1 Non real-time traffic, error-sensitive application that cannot cope with data loss te 2 Non real-time traffic, error-sensitive application that can cope with infrequent data loss c l 3 Non real-time traffic, error-sensitive application that can cope with data loss, ue tia GMM/SM,andSMS 4 Real-time traffic, error-sensitive application that can cope with data loss 5 Real-time traffic, error non-sensitive application that can cope with data loss A numeric parameter which specifies the peak throughput class, in octets per second. Q n 0 Network subscribed value e 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) fid 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) n 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) o8 Up to 128 000 (1024 kbit/s) C9 Up to 256 000 (2048 kbit/s) A numeric parameter which specifies the mean throughput class, in octets per hour 0 Network subscribed value 1 100 (~0.22 bit/s) 2 200 (~0.44 bit/s) 3 500 (~1.11 bit/s) 4 1 000 (~2.2 bit/s) 5 2 000 (~4.4 bit/s) 6 5 000 (~11.1 bit/s) 7 10 000 (~22 bit/s) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 145 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 8 20 000 (~44 bit/s) 9 50 000 (~111 bit/s) 10 100 000 (~0.22 kbit/s) 11 200 000 (~0.44 kbit/s) 12 500 000 (~1.11 kbit/s) 13 1000 000 (~2.2 kbit/s) 14 2 000 000 (~4.4 kbit/s) 15 5 000 000 (~11.1 kbit/s) 16 10 000 000 (~22 kbit/s) 17 20 000 000 (~44 kbit/s) 18 50 000 000 (~111 kbit/s) 31 Best effort Table 4: Delay Class l SDU Size cte l 128Octets CQounefidentia 1024 Octets Delay Class 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) Mean Transfer Delay <0.5 <5 <50 Unspecified <0.5 <5 <50 Unspecified 95 Percentile <1.5 <25 <250 <1.5 <25 <250 - 10.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) AT+CGQMIN allows the TE to specify a minimum acceptable profile which is checked by the MT against the negotiated profile when the PDP context is activated. The write command specifies a profile for the context identified by the context identification parameter . A special form of the write command, AT+CGQMIN= causes the minimum acceptable profile for context number to become undefined. In this case no check is made against the negotiated profile. The read command returns the current settings for each defined context. Details can be found in 3GPP WCDMA_UGxx_AT_Commands_Manual Confidential / Released 146 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual TS 23.107 and all parameters are saved in NV automatically. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) Test Command AT+CGQMIN=? Response +CGQMIN: , (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s) OK Read Command tel AT+CGQMIN? Response [+CGQMIN: ,,,,,] [+CGQMIN: ,,,,,] […] uec tial WriteCommand AT+CGQMIN=[,[,< Q n delay>[,[,[, e ]]]]] OK Response OK If error is related to ME functionality: +CME ERROR: fid Maximum Response Time 300ms Reference 3GPP TS 27.007 Con Parameter A numeric parameter which specifies a particular PDP context definition (see +CGDCONT command) A numeric parameter which specifies the precedence class 0 Network subscribed value 1 High priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments shall be maintained ahead of precedence class 3 3 Low priority. Service commitments shall be maintained A numeric parameter which specifies the delay class. This parameter defines the WCDMA_UGxx_AT_Commands_Manual Confidential / Released 147 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual end-to-end transfer delay incurred in the transmission of SDUs through the network For the detail please refer to Table 4: Delay Class 0 Network subscribed value A numeric parameter which specifies the reliability class 0 Network subscribed value 1 Non real-time traffic, error-sensitive application that cannot cope with data loss 2 Non real-time traffic, error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic, error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic, error-sensitive application that can cope with data loss 5 Real-time traffic, error non-sensitive application that can cope with data loss A numeric parameter which specifies the peak throughput class, in octets per l second 0 Network subscribed value te 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) c l 3 Up to 4 000 (32 kbit/s) ue tia 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) Q n 8 Up to 128 000 (1024 kbit/s) e 9 Up to 256 000 (2048 kbit/s) A numeric parameter which specifies the mean throughput class, in octets per fid hour 0 Network subscribed value 1 100 (~0.22 bit/s) n 2 200 (~0.44 bit/s) 3 500 (~1.11 bit/s) o4 1 000 (~2.2 bit/s) C5 2 000 (~4.4 bit/s) 6 5 000 (~11.1 bit/s) 7 10 000 (~22 bit/s) 8 20 000 (~44 bit/s) 9 50 000 (~111 bit/s) 10 100 000 (~0.22 kbit/s) 11 200 000 (~0.44 kbit/s) 12 500 000 (~1.11 kbit/s) 13 1000 000 (~2.2 kbit/s) 14 2 000 000 (~4.4 kbit/s) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 148 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 15 5 000 000 (~11.1 kbit/s) 16 10 000 000 (~22 kbit/s) 17 20 000 000 (~44 kbit/s) 18 50 000 000 (~111 kbit/s) 31 Best effort 10.5. AT+CGEQREQ 3G Quality of Service Profile (Requested) AT+CGEQREQ allows the TE to specify a UMTS Quality of Service Profile that is used when the MT activates a PDP context. Details can be found in 3GPP TS 23.107 and all parameters are saved in NV automatically. AT+CGEQREQ 3G Quality of Service Profile (Requested) Test Command Queficdteenl tial AT+CGEQREQ=? Response +CGEQREQ: , (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s) Con Read Command OK Response AT+CGEQREQ? [+CGEQREQ: , , , , , , , , , , WCDMA_UGxx_AT_Commands_Manual Confidential / Released 149 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual , , , , ] [...] OK Write Command Response AT+CGEQREQ=[[,[, ERROR [, [, [, [, [, l [, [, te [, [, c l [, ue tia [, [,]]]]]]]]]]]]]]] Maximum Response Time Q n Reference e 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms fid Parameter Con PDP context identifier, a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of the command Integer type, indicates the type of application for which the UMTS bearer service is optimized (refer to 3GPP TS 24.008 subclause 10.5.6.5). If the traffic class is specified as conversational or streaming, then the Guaranteed and Maximum bitrate parameters should also be provided 0 Conversational 1 Streaming 2 Interactive 3 Background 4 Subscribed value Integer type, indicates the maximum number of kbits/s delivered to UMTS WCDMA_UGxx_AT_Commands_Manual Confidential / Released 150 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual (up-link traffic) at a SAP. As an example a bit rate of 32kbit/s would be specified as '32' (e.g. AT+CGEQREQ=…,32, …) 0 Subscribed value 1~8640 Integer type, indicates the maximum number of kbits/s delivered by UMTS (down-link traffic) at a SAP. As an example a bitrate of 32kbit/s would be specified as '32' (e.g. AT+CGEQREQ=…,32, …) 0 Subscribed value 1~16000 Integer type, indicates the guaranteed number of kbits/s delivered to UMTS (up-link traffic) at a SAP (provided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as '32' (e.g. T+CGEQREQ=…,32, …) 0 Subscribed value 1~8640 Integer type, indicates the guaranteed number of kbits/s delivered by UMTS l (down-link traffic) at a SAP (provided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as '32' (e.g. te AT+CGEQREQ=…,32, …) 0 Subscribed value c l 1~16000 ue tia Integer type, indicates whether the UMTS bearer shall provide in-sequence SDU delivery or not (refer to 3GPP TS 24.008 subclause 10.5.6.5) 0 No 1 Yes Q n 2 Subscribed value e Integer type, (1,2,3,…) indicates the maximum allowed SDU size in octets. If the parameter is set to '0' the subscribed value will be requested (refer to fid 3GPP TS 24.008 subclause 10.5.6.5) 0 Subscribed value 10~1500 (value needs to be divisible by 10 without remainder) n 1502 1510 o1520 C String type, indicates the target value for the fraction of SDUs lost or detected as erroneous. SDU error ratio is defined only for conforming traffic. The value is specified as 'mEe'. As an example a target SDU error ratio of 5*10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…) '0E0' Subscribed value '1E2' '7E3' '1E3' '1E4' '1E5' WCDMA_UGxx_AT_Commands_Manual Confidential / Released 151 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual '1E6' '1E1' String type, indicates the target value for the undetected bit error ratio in the delivered SDUs. If no error detection is requested, Residual bit error ratio indicates the bit error ratio in the delivered SDUs. The value is specified as 'mEe'. As an example a target residual bit error ratio of 5•10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…) '0E0' Subscribed value '5E2' '1E2' '5E3' '4E3' '1E3' '1E4' '1E5' '1E6' l '6E8' Integer type, indicates whether SDUs detected as erroneous shall be te delivered or not (refer to 3GPP TS 24.008 [8] subclause 10.5.6.5) 0 No c l 1 Yes ue tia 2 No detect 3 Subscribed value Integer type, (0,1,2,…) indicates the targeted time between request to transfer an SDU at one SAP to its delivery at the other SAP, in Q n milliseconds. If the parameter is set to '0' the subscribed value will be e requested (refer to 3GPP TS 24.008 subclause 10.5.6.5) 0 Subscribed value fid 10~150 (value needs to be divisible by 10 without remainder) 200~950 (value needs to be divisible by 50 without remainder) 1000~4000 (value needs to be divisible by 100 without remainder) n Integer type, (1,2,3,…) specifies the relative importance for handling of all SDUs belonging to the UMTS bearer compared to the SDUs of oother bearers. If the parameter is set to '0' the subscribed value will be C requested (refer to 3GPP TS 24.008 [8] subclause 10.5.6.5) 0 Subscribed 1 2 3 Integer type, specifies characteristics of the source of the submitted SDUs for a PDP context 0 Characteristics of SDUs are unknown 1 Characteristics of SDUs corresponds to a speech source Integer type, indicates signaling content of submitted SDUs for a PDP WCDMA_UGxx_AT_Commands_Manual Confidential / Released 152 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual context 0 1 PDP context is not optimized for signaling PDP context is optimized for signaling 10.6. AT+CGEQMIN 3G Quality of Service Profile (Minimum Acceptable) AT+CGEQMIN allows the TE to specify a minimum acceptable profile, which is checked by the MT against the negotiated profile returned in the PDP context establishment and PDP context modification procedures. Details can be found in 3GPP TS 23.107 and all of parameters are saved in NV automatically. AT+CEGQMIN 3G Quality of Service Profile (Minimum Acceptable) l Test Command Quneficdteential AT+CGEQMIN=? Response +CGEQMIN: , (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s), (list of supported s) Co OK Read Command Response AT+CGEQMIN? [+CGEQMIN: , , , , , , , , , WCDMA_UGxx_AT_Commands_Manual Confidential / Released 153 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual , , , , , ] […] OK Write Command Response AT+CGEQMIN=[[, OK [, [, [, [, l [, [, te [, [, c l [, ue tia [, [, [, Q n [,]]]]]]]]]]]]]]] Maximum Response Time e Reference fid 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms Parameter Con PDP context identifier, a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of the command Integer type, indicates the type of application for which the UMTS bearer service is optimized (refer to 3GPP TS 24.008 subclause 10.5.6.5). If the Traffic class is specified as conversational or streaming, then the Guaranteed and Maximum bitrate parameters should also be provided 0 Conversational 1 Streaming 2 Interactive 3 Background WCDMA_UGxx_AT_Commands_Manual Confidential / Released 154 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 4 Subscribed value Integer type, indicates the maximum number of kbits/s delivered to UMTS (up-link traffic) at a SAP. As an example a bitrate of 32kbit/s would be specified as '32' (e.g. AT+CGEQREQ=…,32, …) 0 Subscribed value 1~8640 Integer type, indicates the maximum number of kbits/s delivered by UMTS (down-link traffic) at a SAP. As an example a bitrate of 32kbit/s would be specified as '32' (e.g. AT+CGEQREQ=…,32, …) 0 Subscribed value 1~16000 Integer type, indicates the guaranteed number of kbits/s delivered to UMTS (up-link traffic) at a SAP (provided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as '32' (e.g. AT+CGEQREQ=…,32, …) 0 Subscribed value l 1~8640 Integer type, indicates the guaranteed number of kbits/s delivered by UMTS te (down-link traffic) at a SAP (provided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as '32' (e.g. c l AT+CGEQREQ=…,32, …) ue tia 0 Subscribed value 1~16000 Integer type, indicates whether the UMTS bearer shall provide in-sequence SDU delivery or not (refer 3GPP TS 24.008 subclause 10.5.6.5) Q n 0 No e 1 Yes 2 Subscribed value fid Integer type, (1,2,3,…) indicates the maximum allowed SDU size in octets. If the parameter is set to '0' the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5) n 0 Subscribed value 10~1500 (value needs to be divisible by 10 without remainder) o1502 C1510 1520 String type, indicates the target value for the fraction of SDUs lost or detected as erroneous. SDU error ratio is defined only for conforming traffic. The value is specified as 'mEe'. As an example a target SDU error ratio of 5*10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…) '0E0' Subscribed value '1E2' '7E3' '1E3' WCDMA_UGxx_AT_Commands_Manual Confidential / Released 155 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual '1E4' '1E5' '1E6' '1E1' String type, indicates the target value for the undetected bit error ratio in the delivered SDUs. If no error detection is requested, Residual bit error ratio indicates the bit error ratio in the delivered SDUs. The value is specified as 'mEe'. As an example a target residual bit error ratio of 5•10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…) '0E0' Subscribed value '5E2' '1E2' '5E3' '4E3' '1E3' '1E4' l '1E5' '1E6' te '6E8' Integer type, indicates whether SDUs detected as erroneous shall be c l delivered or not (refer to 3GPP TS 24.008 [8] subclause 10.5.6.5) ue tia 0 No 1 Yes 2 No detect 3 Subscribed value Q n Integer type, (0,1,2,…) indicates the targeted time between request to e transfer an SDU at one SAP to its delivery at the other SAP, in milliseconds. If the parameter is set to '0' the subscribed value will be fid requested (refer to 3GPP TS 24.008 subclause 10.5.6.5) 0 Subscribed value 10~150 (value needs to be divisible by 10 without remainder) n200~950 (value needs to be divisible by 50 without remainder) 1000~4000 (value needs to be divisible by 100 without remainder) o Integer type, (1,2,3,…) specifies the relative importance for handling of C all SDUs belonging to the UMTS bearer compared to the SDUs of other bearers. If the parameter is set to '0' the subscribed value will be requested (refer to 3GPP TS 24.008 [8] subclause 10.5.6.5) 0 Subscribed 1 2 3 Integer type, specifies characteristics of the source of the submitted SDUs for a PDP context 0 Characteristics of SDUs is unknown WCDMA_UGxx_AT_Commands_Manual Confidential / Released 156 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 1 Characteristics of SDUs corresponds to a speech source Integer type, indicates signaling content of submitted SDUs for a PDP context. 0 PDP context is not optimized for signaling 1 PDP context is optimized for signaling 10.7. AT+CGACT Activate or Deactivate PDP Context The AT+CGACT write command is used to activate or deactivate the specified PDP context(s). After the command has been completed, the MT remains in V.250 command state. If any PDP context is already in the requested state, the state for that context remains unchanged. If the MT is not PS attached when the activation form of the command is executed, the MT first performs a PS attach and then attempts to activate the specified contexts. If no specifies the activation/deactivation form of the command, it will activate or deactivate all defined contexts. l AT+CGACT Activate or Deactivate PDP Context te Test Command c l AT+CGACT=? Response +CGACT: (list of supported s) ue tia ReadCommand Q n AT+CGACT? OK Response [+CGACT:,[ +CGACT: […]]] fide Write Command AT+CGACT=, OK Response OK NO CARRIER Con Maximum Response Time If error is related to ME functionality: +CME ERROR: 150s, determined by network. Reference 3GPP TS 27.007 Parameter Indicates the state of PDP context activation 0 Deactivated 1 Activated WCDMA_UGxx_AT_Commands_Manual Confidential / Released 157 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Other values are reserved and will result in an ERROR response to the Write Command A numeric parameter which specifies a particular PDP context definition (see +CGDCONT command) Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGACT=0,1 OK //Define PDP context //Activated PDP //Deactivated PDP 10.8. AT+CGDATA Enter Data State l The AT+CGDATA write command causes the MT to perform whatever actions that are necessary to te establish communication between the TE and the network using one or more packet domain PDP types. c l This may include per-forming a PS attach and one or more PDP context activations. Commands following the AT+CGDATA command in the AT command line will not be processed by the MT. ue tia If the parameter value is unacceptable to the MT, the MT shall return an ERROR or +CME ERROR response. Otherwise, the MT issues the intermediate result code CONNECT and enters V.250 online data Q n state. After data transfer is completed, and the layer 2 protocol termination procedure has been completed successfully, the command state is reentered and the MT returns the final result code OK. e AT+CGDATA Enter Data State fid Test Command AT+CGDATA=? Response +CGDATA: (list of supported s) on Write Command C AT+CGDATA=[,[,[,… OK Response CONNECT ]]] ERROR Maximum Response Time Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 158 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter A string parameter that indicates the layer 2 protocol to be used between the TE and MT: PPP Point to Point protocol for a PDP such as IP PAD Character stream for X.25 character (triple X PAD) mode (Obsolete) X25 X.25 L2 (LAPB) for X.25 packet mode (Obsolete) M-OPT-PPP MS supports manufacturing specific protocol M-HEX MS supports manufacturing specific protocol M-RAW_IP MS supports manufacturing specific protocol Other values are not supported and will result in an ERROR response to the execution command A numeric parameter which specifies a particular PDP context definition (see +CGDCONT command) l 10.9. AT+CGPADDR Show PDP Address te The AT+CGPADDR write command returns a list of PDP addresses for the specified context identifiers. If c l no is specified, the addresses for all defined contexts are returned. ue tia AT+CGPADDR Show PDP Address Test Command AT+CGPADDR=? Response +CGPADDR:[ (list of defined s)] Q en Write Command fid AT+CGPADDR=[,[,…]] OK Response +CGPADDR: , [+CGPADDR: ,[…]] OK nERROR Co If error is related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter A numeric parameter which specifies a particular PDP context definition (see WCDMA_UGxx_AT_Commands_Manual Confidential / Released 159 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +CGDCONT command) A string that identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by the +CGDCONT command when the context was defined. For a dynamic address it will be the one assigned during the last PDP context activation that used the context definition referred to . is omitted if none is available Example AT+CGDCONT=1,'IP','UNINET' //Define PDP context OK AT+CGACT=1,1 //Activated PDP OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' l OK //Show PDP address cte l 10.10. AT+CGCLASS GPRS Mobile Station Class ue tia AT+CGCLASS is used to set the MT to operate according to the specified mode of operation, see 3GPP TS 23.060. Q n AT+CGCLASS GPRS Mobile Station Class e Test Command fid AT+CGCLASS=? Response +CGCLASS: (list of supported s) n Read Command AT+CGCLASS? OK Response +CGCLASS: Co OK Write Command Response AT+CGCLASS= OK ERROR Maximum Response Time Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 160 / 247 Parameter UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual A string parameter which indicates the GPRS mobile class (Functionality in descending order) 'A' Class A 'B' Class B 'CG' Class C in GPRS only mode 'CC' Class C in circuit switched only mode 10.11. AT+CGREG Network Registration Status The AT+CGREG command queries the network registration status and controls the presentation of an unsolicited result code +CGREG: when =1 and there is a change in the MT's packet domain network registration status in GERAN/UTRAN, or unsolicited result code +CGREG: l [,[],[],[]] when =2 and there is a change of the network cell in GERAN/UTRAN. te AT+CGREG Network Registration Status c l Test Command ue tia AT+CGREG=? Response +CGREG: (list of supported s) Q n Read Command AT+CGREG? OK Response +CGREG: ,[,,[,]] fide Write Command n AT+CGREG=[] OK Response OK ERROR o If error is related to ME functionality: C +CME ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter 0 1 Disable network registration unsolicited result code Enable network registration unsolicited result code +CGREG: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 161 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 2 Enable network registration and location information unsolicited result code +CGREG: [,,[,]] 0 Not registered, MT is not currently searching an operator to register to. The UE is in GMM state GMM-NULL or GMM-DEREGISTERED-INITIATED. The packet domain service is disabled, the UE is allowed to attach for packet domain if requested by the user. 1 Registered, home network. The UE is in GMM state GMM-REGISTERED or GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED on the home PLMN. 2 Not registered, but MT is currently trying to attach or searching an operator to register to. The UE is in GMM state GMM-DEREGISTERED or GMM-REGISTERED-INITIATED. The packet domain service is enabled, but an allowable PLMN is currently not available. The UE will start a packet domain tel c l ue tia attach as soon as an allowable PLMN is available. 3 Registration denied. The UE is in GMM state GMM-NULL. The packet domain service is disabled, the UE is not allowed to attach for packet domain if requested by the user. 4 Unknown 5 Registered, roaming String type, two bytes location area code in hexadecimal format (e.g. '00C3' equals to 195 in decimal) String type, 16 bit (GSM) or 28 bit (UMTS) cell ID in hexadecimal format Access technology selected 0 GSM 2 UTRAN Q en 10.12. AT+CGEREP Packet Domain Event Reporting fid Set command enables or disables sending of unsolicited result codes +CGEV: XXX from MT to TE in the case of certain events occurring in the Packet Domain MT or the network. controls the n processing of unsolicited result codes specified within this command. controls the effect on buffered o codes when 1 or 2 is entered. C AT+CGEREP Packet Domain Event Reporting Test Command AT+CGEREP=? Response +CGEREP: (list of supported s),(list of supported s) Read Command AT+CGEREP? OK Response +CGEREP: , OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 162 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+CGEREP=mode[,] Response OK ERROR Execution Command AT+CGEREP Maximum Response Time Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: Response OK 300ms Parameter 0 l 1 cte l 2 ue tia 0 Q en 1 Buffer unsolicited result codes in the MT; if MT result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE. Discard unsolicited result codes when MT-TE link is reserved (e.g. in on-line data mode); otherwise forward them directly to the TE. Buffer unsolicited result codes in the MT when MT-TE link is reserved (e.g. in on-line data mode) and flush them to the TE when MT-TE link becomes available; otherwise forward them directly to the TE. MT buffer of unsolicited result codes defined within this command is cleared when 1 or 2 is entered. MT buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is entered (OK response shall be given before flushing the codes). fid NOTES n The unsolicited result codes and the corresponding events are defined as follows: 1. +CGEV: NW DEACT ,,[]: The network has requested a context o reactivation. The used to reactivate the context is provided if known to the MT. C 2. +CGEV: ME DEACT ,,[]: The mobile equipment has forced a context deactivation. The used to activate the context is provided if known to the MT. 3. +CGEV: NW DETACH: The network has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 4. +CGEV: ME DETACH: The mobile equipment has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 5. +CGEV: NW CLASS : The network has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 6. +CGEV: ME CLASS : The mobile equipment has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). WCDMA_UGxx_AT_Commands_Manual Confidential / Released 163 / 247 Example AT+CGEREP=? +CGEREP: (0-2),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 10.13. AT+CGSMS Select Service for MO SMS Messages AT+CGSMS specifies the service or service preference that the MT will use to send MO (mobile originated) SMS messages. tel AT+CGSMS Select Service for MO SMS Messages Test Command c l AT+CGSMS=? Response +CGSMS: (list of currently available s) ue tia ReadCommand AT+CGSMS? OK Response +CGSMS: Q en Write Command fid AT+CGSMS=[] OK Response OK on Maximum Response Time C Reference If error is related to ME functionality: +CME ERROR: 300ms 3GPP TS 27.007 Parameter A numeric parameter which indicates the service or service preference to be used 0 Packet domain 1 Circuit switch 2 Packet domain preferred (use circuit switched if packet domain service not available) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 164 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 3 Circuit switch preferred (use packet domain if circuit switched not available) 10.14. AT+QGDCNT GPRS Data Counter This command allows the application to check how much data in bytes are sent or received. AT+QGDCNT GPRS Data Counter Test Command AT+QGDCNT=? Response +QGDCNT: (0,1) Read Command AT+QGDCNT? tel Write Command AT+QGDCNT= Quec ntial Reference OK Response +QGDCNT: , OK Response OK ERROR If error is related to ME functionality: +CME ERROR: e Parameter fid on C A numeric parameter. The operation about data counter 0 Reset the data counter 1 Save the results of data counter to NV. If you want to auto save results, please refer to command AT+QAUGDCNT A numeric parameter. The amount of sent data in bytes A numeric parameter. The amount of received data in bytes NOTE When module is powered on, and will be loaded from results of data counter in NV. The default result in NV is 0. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 165 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Example AT+QGDCNT=? +QGDCNT: (0,1) //Test command OK AT+QGDCNT? +QGDCNT: 3832,4618 //Query the current and OK AT+QGDCNT=1 //Save the results to NV OK AT+QGDCNT=0 //Reset counter OK l 10.15. AT+QAUGDCNT Configure to Auto Save GPRS Data Counter te This command allows command (AT+QGDCNT) to save results to NV automatically. c l AT+QAUGDCNT Configure to Auto Save GPRS Data Counter ue tia TestCommand AT+QAUGDCNT=? Response +QAUGDCNT: (0,30-65535) Q en Read Command AT+QAUGDCNT? OK Response +QAUGDCNT: fid Write Command n AT+QAUGDCNT= Co OK OK Response OK ERROR If error is related to ME functionality: +CME ERROR: Reference Parameter A numeric parameter. Default value is 0. is the time-interval for command (AT+QGDCNT) to save results to NV automatically. If is set to 0, auto-save feature would be disabled. Unit is second. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 166 / 247 NOTE The configuration would not be saved into NV. UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 10.16. AT+QAUGTH Set Auth Type This command only sets auth type in first LCP REQ frame from module. The final auth type is negotiated by MCU and module. AT+QGAUTH Set Auth Type Test Command AT+QGAUTH=? Response +QGAUTH: (1-20),auth_type tel Read Command AT+QGAUTH= OK Response +QGAUTH: uec tial SetCommand Q n AT+QGAUTH=, OK Response OK ERROR e Parameter fid Con Context profile ID 1-20 Auth type 1 PAP 2 CHAP Example AT+QGAUTH=? +QGAUTH: (1-20),(1,2) OK AT+QGAUTH=1 +QGAUTH: 1 OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 167 / 247 AT+QGAUTH=1,2 OK AT+QGAUTH=1 +QGAUTH: 2 OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual CQouneficdteenl tial WCDMA_UGxx_AT_Commands_Manual Confidential / Released 168 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 11 Supplementary Service Commands 11.1. AT+CCFC Call Forwarding Number and Conditions Control AT+CCFC allows control of the call forwarding supplementary service according to 3GPP TS 22.082. Registration, erasure, activation, deactivation and status query are supported. AT+CCFC Call Forwarding Number and Conditions Control Test Command l AT+CCFC=? Response +CCFC: (list of supported s) cte l WriteCommand AT+CCFC=,[,[,[,[,[,[,time]]]]]] OK Response TA controls the call forwarding supplementary service. Registration, erasure, activation, deactivation, and status query are supported. Only and should be entered with mode (0-2,4) If 2 and command successful OK fid If =2 and command successful (only in connection with 0-3) nFor registered call forwarding numbers: o +CCFC: , [, , C [,,[,]]] [+CCFC: ....] OK If no call forwarding numbers are registered (and therefore all classes are inactive): +CCFC: , OK where =0 and =15 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 169 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms Parameter 0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All call forwarding (0-3) 5 All conditional call forwarding (1-3) 0 Disable l 1 Enable 2 Query status te 3 Registration c l 4 Erasure Phone number in string type of forwarding address in format specified by ue tia Type of address in integer format; default value is 145 when dialing string includes international access code character '+', otherwise 129 String type sub-address of format specified by Q n Type of sub-address in integer 1 Voice e 2 Data fid 4 FAX 7 All telephony except SMS 8 Short message service 16 Data circuit sync n 32 Data circuit async o 1…30 When 'no reply' (=no reply) is enabled or queried, this gives the time in seconds to wait before call is forwarded, default value is 20 C 0 Not active 1 Active Example AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, //Register the destination number for unconditional call forwarding (CFU) //Query the status of CFU without specifying WCDMA_UGxx_AT_Commands_Manual Confidential / Released 170 / 247 OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,255 OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //Erase the registered CFU destination number //Query the status, no destination number 11.2. AT+CCWA Call Waiting Control The AT+CCWA command allows control of the call waiting supplementary service according to 3GPP TS 22.083. Activation, deactivation and status query are supported. l AT+CCWA Call Waiting Control Test Command te AT+CCWA=? Response +CCWA: (list of supported s) uec tial ReadCommand AT+CCWA? OK Response +CCWA: Q n Write Command fide AT+CCWA=[[,[,]]] OK Response TA controls the call waiting supplementary service. Activation, deactivation and status query are supported. If 2 and command successful: OK nIf =2 and command successful: o +CCWA: ,[+CCWA: C ,[...]] OK Maximum Response Time Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 171 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter 0 Disable presentation of an unsolicited result code 1 Enable presentation of an unsolicited result code When parameter is not given, network is not interrogated 0 Disable 1 Enable 2 Query status A sum of integers, each integer represents a class of information 1 Voice (telephony) 2 Data (bearer service) 4 FAX (facsimile) 16 Data circuit sync 32 Data circuit async 0 Disable 1 Enable l Phone number in string type of calling address in format specified by Type of address octet in integer format te 129 Unknown type (IDSN format number) 145 International number type (ISDN format ) c l Optional string type alphanumeric representation of corresponding to the ue tia entry found in phone book Integer type 0 CLI valid 1 CLI has been withheld by the originator Q n 2 CLI is not available due to interworking problems or limitations of originating network fide NOTES 1. =0 should be returned only if service is not active for any i.e. +CCWA: 0, 7 will be returned in this case. n 2. When =2, all active call waiting classes will be reported. In this mode the command is o aborted by pressing any key. 3. Unsolicited result code: C When the presentation call waiting at the TA is enabled (and call waiting is enabled) and a terminating call set up during an established call, an unsolicited result code is returned: +CCWA: ,,,[], Example AT+CCWA=1,1 OK ATD10086; OK //Enable presentation of an unsolicited result code //Establish a call WCDMA_UGxx_AT_Commands_Manual Confidential / Released 172 / 247 +CCWA: '02154450293',129,1,,0 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //Indication of a call that has been waiting 11.3. AT+CHLD Call Related Supplementary Services The AT+CHLD command allows the control of the following call related services:  A call can be temporarily disconnected from the MT but the connection is retained by the network;  Multiparty conversation (conference calls);  The served subscriber who has two calls (one held and the other either active or alerting) can connect the other parties and release the served subscriber's own connection. Calls can be put on hold, recovered, released and added to a conversation, and transferred similarly as defined in 3GPP TS 22.030. l This is based on the GSM/UMTS supplementary services HOLD (Call Hold; refer to 3GPP TS 22.083 te clause 2), MPTY (Multi Party; refer to 3GPP TS 22.084) and ECT (Explicit Call Transfer; refer to 3GPP TS 22.091). The interaction of this command with other commands based on other GSM/UMTS c l supplementary services is described in the GSM/UMTS standards. Call Hold, Multi Party and Explicit Call ue tia Transfer are only applicable to teleservice 11. AT+CHLD Call Related Supplementary Services Q n Test Command AT+CHLD=? Response +CHLD: (list of supported s) fide Write Command on AT+CHLD[=] OK Response TA controls the supplementary services call hold, multiparty and explicit call transfer. Calls can be put on hold, recovered, released, added to conversation and transferred. OK C If error is related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.007 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 173 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter 0 Terminate all held calls or UDUB (User Determined User Busy) for a waiting call. If a call is waiting, terminate the waiting call. Otherwise, terminate all held calls (if any) 1 Terminate all active calls (if any) and accept the other call (waiting call or held call). It can terminate active call if there is only one call 1X Terminate the specific call number X 2 Place all active calls on hold (if any) and accept the other call (waiting call or held call) as the active call 2X Place all active calls except call X on hold 3 Add the held call to the active calls 4 Connects the two calls and disconnects the subscriber from both calls (ECT) Example l ATD10086; OK te +CCWA: '02154450293',129,1 c l AT+CHLD=2 ue tia OK AT+CLCC Q n +CLCC: 1,0,1,0,0,'10086',129 e +CLCC: 2,1,0,0,0,'02154450293',129 fid OK AT+CHLD=21 OK n AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 Co +CLCC: 2,1,1,0,1,'02154450293',129 //Establish a call //Indication of a call that has been waiting //Place the active call on hold and accept the waiting call as the active call //The first call on hold //The second call be active //Place the active call except call X=1 on hold //The first call be active //The second call on hold OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129 //Add a held call to the active calls in order to set up a conference (multiparty) call +CLCC: 2,1,0,0,1,'02154450293',129 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 174 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK 11.4. AT+CLIP Calling Line Identification Presentation AT+CLIP refers to the GSM/UMTS supplementary service CLIP (Calling Line Identification Presentation) that enables a called subscriber to get the calling line identity (CLI) of the calling party when receiving a mobile terminated call. AT+CLIP Calling Line Identification Presentation Test Command AT+CLIP=? l Read Command AT+CLIP? cte l WriteCommand ue tia AT+CLIP= Q fiden MaximumResponseTime Reference n 3GPP TS 27.007 Co Parameter Response +CLIP: (list of supported s) OK Response +CLIP: , OK Response TA enables or disables the presentation of the calling line identity (CLI) at the TE. It has no effect on the execution of the supplementary service CLIP in the network. OK If error is related to ME functionality: +CME ERROR: 15s, determined by network. 0 Suppress unsolicited result codes 1 Display unsolicited result codes 0 CLIP not provisioned 1 CLIP provisioned 2 Unknown Phone number in string type of calling address in format specified by String type subaddress of format specified by Type of subaddress octet in integer format (refer to 3GPP TS 24.008 [8] subclause WCDMA_UGxx_AT_Commands_Manual Confidential / Released 175 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 10.5.4.8) Type of address octet in integer format; 129 Unknown type (IDSN format number) 145 International number type (ISDN format ) String type alphanumeric representation of corresponding to the entry found in phone book 0 CLI valid 1 CLI has been withheld by the originator 2 CLI is not available due to interworking problems or limitations of originating network NOTE Unsolicited result code: When the presentation of the CLIP at the TE is enabled (and calling subscriber allows), an unsolicited result code is returned after every RING (or +CRING: ) at a mobile terminating call: l +CLIP: ,,[subaddr],[satype],[], te Example c l AT+CLIP=1 ue tia OK RING Q n +CLIP: '02151082965',129,,,,0 fide 11.5. AT+CLIR Calling Line Identification Restriction n AT+CLIR refers to the CLIR supplementary service (Calling Line Identification Restriction) according to o 3GPP TS 22.081 and the OIR supplementary service (Originating Identification Restriction) according to C 3GPP TS 24.607 that allows a calling subscriber to enable or disable the presentation of the calling line identity (CLI) to the called party when originating a call. AT+CLIR Calling Line Identification Restriction Test Command AT+CLIR=? Response +CLIR: (list of supported s) Read Command AT+CLIR? OK Response +CLIR: , WCDMA_UGxx_AT_Commands_Manual Confidential / Released 176 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+CLIR= OK Response TA restricts or enables the presentation of the calling line identity (CLI) to the called party when originating a call. The command overrides the CLIR subscription (default is restricted or allowed) when temporary mode is provisioned as a default adjustment for all following outgoing calls. This adjustment can be revoked by using the opposite Command. OK If error is related to ME functionality: Maximum Response Time Reference l 3GPP TS 27.007 +CME ERROR: 15s, determined by network. te Parameter c l Quefidentia Parameter sets the adjustment for outgoing calls 0 Presentation indicator is used according to the subscription of the CLIR service 1 CLIR invocation 2 CLIR suppression Parameter shows the subscriber CLIR service status in the network 0 CLIR not provisioned 1 CLIR provisioned in permanent mode 2 Unknown (e.g. no network, etc.) 3 CLIR temporary mode presentation restricted 4 CLIR temporary mode presentation allowed Con 11.6. AT+COLP Connected Line Identification Presentation AT+COLP refers to the GSM/UMTS supplementary service COLP (Connected Line Identification Presentation) that enables a calling subscriber to get the connected line identity (COL) of the called party after setting up a mobile originated call. The command enables or disables the presentation of the COL at the TE. It has no effect on the execution of the supplementary service COLR in the network. AT+COLP Connected Line Identification Presentation Test Command AT+COLP=? Response +COLP: (list of supported s) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 177 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Read Command AT+COLP? OK Response +COLP: , Write Command AT+COLP= OK Response TA enables or disables the presentation of the COL (Connected Line) at the TE for a mobile originating a call. It has no effect on the execution of the supplementary service COLR in the network. Maximum Response Time l Reference te 3GPP TS 27.007 Intermediate result code is returned from TA to TE before any +CR or V.25ter responses. OK 15s, determined by network. c l Parameter ue tia Q n fide n Co Parameter sets/shows the result code presentation status in the TA 0 Disable 1 Enable Parameter shows the subscriber COLP service status in the network 0 COLP not provisioned 1 COLP provisioned 2 Unknown (e.g. no network, etc.) Phone number in string type, format specified by Type of address octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format ) String type sub-address of format specified by Type of sub-address octet in integer format (refer to 3GPP TS 24.008 sub clause 10.5.4.8 ) Optional string type alphanumeric representation of corresponding to the entry found in phone book WCDMA_UGxx_AT_Commands_Manual Confidential / Released 178 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual NOTE Intermediate result code: When enabled (and called subscriber allows), an intermediate result code is returned before any +CR or V.25ter responses: +COLP: ,,[],[] ,[] Example AT+COLP=1 OK ATD02151082965; OK +COLP: '02151082965',129,,, tel 11.7. AT+CSSN Supplementary Service Notifications c l AT+CSSN refers to supplementary service related network initiated notifications. The write command ue tia enables/disables the presentation of notification result codes from TA to TE. AT+CSSN Supplementary Service Notifications Q n Test Command AT+CSSN=? Response +CSSN: (list of supported s),(list of supported s) fide Read Command AT+CSSN? OK Response +CSSN: , on Write Command C AT+CSSN=[,] OK Response OK ERROR Maximum Response Time Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 179 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Integer type, parameter sets/shows the +CSSI intermediate result code presentation status to the TE 0 Disable 1 Enable Integer type (parameter sets/shows the +CSSU unsolicited result code presentation status to the TE) 0 Disable 1 Enable Integer type, it is manufacturer specific, which of these codes are supported 0 Unconditional call forwarding is active uectel tial 1 Some of the conditional call forwardings are active 2 Call has been forwarded 3 Waiting call is pending 5 Outgoing call is barred Integer type, it is manufacturer specific, which of these codes are supported 0 The incoming call is a forwarded call 2 Call has been put on hold (during a voice call) 3 Call has been retrieved (during a voice call) 5 Held call was terminated by another party 10 Additional incoming call forwarded NOTES Q n 1. When =1 and a supplementary service notification is received after a mobile originated call setup, e the +CSSI intermediate result code is sent to TE before any other MO call setup result codes: +CSSI: fid 2. When =1 and a supplementary service notification is received during a mobile terminated call setup or during a call, the +CSSU unsolicited result code is sent to TE: +CSSU: Con 11.8. AT+CUSD Unstructured Supplementary Service Data AT+CUSD allows control of the Unstructured Supplementary Service Data (USSD) according to 3GPP TS 22.090. Both network and mobile initiated operations are supported. Parameter is used to disable/enable the presentation of an unsolicited result code. The value =2 is used to cancel an ongoing USSD session. For an USSD response from the network, or a network initiated operation, the format is: +CUSD: [,,[]]. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 180 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual When is given, a mobile initiated USSD string or a response USSD string to a network initiated operation is sent to the network. The response USSD string from the network is returned in a subsequent +CUSD URC. AT+CUSD Unstructured Supplementary Service Data Test Command AT+CUSD=? Response +CUSD: (list of supported s) Read Command AT+CUSD? OK Response +CUSD: Write Command AT+CUSD=[,[,] ] OK Response OK ERROR ctel l Maximum Response Time Reference ue tia 3GPPTS27.007 If error is related to ME functionality: +CME ERROR: 120s, determined by network. Q n Parameter e fid on C Integer type, sets/shows the result code presentation status to the TE 0 Disable the result code presentation to the TE 1 Enable the result code presentation to the TE 2 Cancel session (not applicable to read command response) Unstructured Supplementary Service Data (USSD) to be sent to the network. If this parameter is not given, network is not interrogated. Unstructured Supplementary Service Data (USSD) received from the network. Integer type, 3GPP TS 23.038 Cell Broadcast Data Coding Scheme (default 15) USSD response from the network or the network initiated operation 0 No further user action required (network initiated USSD Notify, or no further information needed after mobile initiated operation) 1 Further user action required (network initiated USSD Request, or further information needed after mobile initiated operation) 2 USSD terminated by network 3 Another local client has responded 4 Operation not supported 5 Network time out WCDMA_UGxx_AT_Commands_Manual Confidential / Released 181 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12 Audio Commands 12.1. AT+CLVL Loud Speaker Volume Level AT+CLVL is used to select the volume of the internal loudspeaker of the MT. AT+CLVL Loud Speaker Volume Level Test Command AT+CLVL=? Response +CLVL: (list of supporteds) tel Read Command c l AT+CLVL? OK Response +CLVL: ue tia WriteCommand AT+CLVL= OK Response OK Q fiden MaximumResponseTime Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms Con Parameter Integer type, value (0-100) with manufacturer specific range (Smallest value represents the lowest sound level), the default value of mode 0 is 80, the default value of mode 1 is 70, the default value of mode 2 is 50. NOTE This parameter will not be saved. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 182 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12.2. AT+CMUT Mute Control AT+CMUT is used to enable and disable the uplink voice muting during a voice call. AT+CMUT Mute Control Test Command AT+CMUT=? Response +CMUT: (list of supporteds) OK Read Command Response AT+CMUT? +CMUT: Write Command AT+CMUT= ctel l Maximum Response Time Reference ue tia 3GPPTS27.007 Q n Parameter e 0 fid 1 Mute off Mute on NOTE Con This parameter will not be saved. OK Response OK If error is related to ME functionality: +CME ERROR: 300ms 12.3. AT+CALM Mute the Ring Tone AT+CALM is used to mute the ring tone. There is no ring tone when a call is coming. AT+CALM Mute the Ring Tone Test Command AT+CALM=? Response +CALM: (list of supported s) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 183 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Read Command AT+CALM? Write Command AT+CALM= Maximum Response Time OK Response +CALM: OK Response OK ERROR 300ms Parameter Numeric type l 0 Ring tone is normal 1 Ring tone is mute cte l NOTE ue tia This parameter will not be saved. Q en 12.4. AT+CRSL Set Ring Tone Volume fid AT+CRSL can be used to set the volume of ring tone. AT+CRSL Set Ring Tone Volume n Test Command Co AT+CRSL=? Response +CRSL: (list of supported s) OK Read Command AT+CRSL? Response +CRSL: Write Command AT+CRSL= OK Response OK ERROR WCDMA_UGxx_AT_Commands_Manual Confidential / Released 184 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Maximum Response Time 300ms Parameter Numeric type, indicates the configured volume of ring tone. Range: 0-100, the default value of mode 0 is 80, the default value of mode 1 is 50, the default value of mode 2 is 80. NOTE This parameter will not be saved. l 12.5. AT+QAUDLOOP Enable Audio Loop Test te This command is used to enable audio loop test. c l AT+QAUDLOOP Enable Audio Loop Test ue tia TestCommand AT+QAUDLOOP=? Response +QAUDLOOP: (0,1),(0-2) Q en Read Command AT+QAUDLOOP? OK Response +QAUDLOOP: , fid Set Command Con AT+QAUDLOOP=[,] OK Response OK ERROR Maximum Response Time 300ms Parameter Numeric type; to enable or disable audio loop test 0 Disable audio loop test 1 Enable audio loop test Compatible argument, no effect WCDMA_UGxx_AT_Commands_Manual Confidential / Released 185 / 247 NOTE These parameters will not be saved. UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12.6. AT+VTS DTMF and Tone Generation The AT+VTS command is used to send ASCII characters which causes MSC to transmit DTMF tones to a remote subscriber. This command can only be operated in voice call. AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (0-9,A-D,*,#),(0-255) tel Write Command c l AT+VTS=[,] OK Response OK ERROR ue tia Maximum ResponseTime Q n Reference e 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: Depends on the length of and . fid Parameter Con ASCII characters in the set 0...9,#,*, A, B, C, D. The string should enclose in quotation marks ('...') When sending multiple tones at a time, the time interval of two tones specified by +VTD. The maximal length of the string is 31 The duration of each tone in 1/10 seconds with tolerance Value ranges from 0 to 255 and default is 0 If the duration is less than the minimum value depend on the network, the actual duration is depend on the network If this parameter is omitted, is specified by +VTD Example ATD12345678900; OK //Dial WCDMA_UGxx_AT_Commands_Manual Confidential / Released 186 / 247 AT+VTS='1' OK AT+VTS='1234567890A' OK UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual //The remote can listen to DTMF tone //Send multiple tones at a time 12.7. AT+VTD Set Tone Duration AT+VTD sets the duration of DTMF tones. This command can also set time interval of two tones when sending multiple tones at a time. AT+VTD Set Tone Duration Test Command AT+VTD=? tel Read Command c l AT+VTD? ue tia WriteCommand AT+VTD=[,] Q fiden MaximumResponseTime n Reference 3GPP TS 27.007 Co Parameter Response +VTD: (0-255),(0-255) OK Response +VTD: , OK Response OK ERROR If error is related to ME functionality: +CME ERROR: 300ms The duration tone in 1/10 seconds with tolerance. Value ranges from 0 to 255 and default is 1. If the duration is less than the minimum time specified by the network, the actual duration will be network specified time. The time interval of two tones when sending multiple tones at a time by +VTS. Value ranges from 0 to 255 and default is 0. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 187 / 247 NOTE This parameter will not be saved. UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12.8. AT+QDAC Digital Audio Configure AT+QDAC is used to configure the digital audio interface. While =1, you can define the PCM interface by themselves; while =2, and the external codec chip linked with PCM interface is the NAU8814model through the I2C, the module can be used directly and set by the default configurations. while =3, and the external codec chip linked with PCM interface is the ALC5616 model through the I2C,the module can be used directly and set by the default configurations. while =4, and the external codec chip linked with PCM interface is the MAX9860 model through the I2C,the module can be used directly and set by the default configurations. l AT+QDAC Digital Audio Configure te Test Command c l AT+QDAC=? Response +QDAC: (1-4),(0,1),(0-8),(0,2),(0,1),(0,1) ue tia ReadCommand Q en AT+QDAC? OK Response +QDAC: [,,,,,] fid OK Write Command AT+QDAC=[,,,,,< data_format>] Response OK ERROR Co Maximum Response Time 300ms Parameter 1 Digital PCM output (Customer defined) 2 Analog output (For our default audio codec NAU8814) 3 Analog output (For our default audio codec ALC5616) 4 Analog output (for our default audio codec max9860) 0 Master mode 1 Slave mode WCDMA_UGxx_AT_Commands_Manual Confidential / Released 188 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 0 8K 1 11K 2 12K 3 16k 4 22K 5 24K 6 32K 7 44K 8 48K 0 16-bit 2 32-bit 0 Mono 1 0 1 Stereo PCM I2S l NOTES te 1. Configuration of will be saved to NV automatically. c l 2. The module provides clock, and the clock depends on and . 3. When you select ALC5616, NAU8814 or MAX9860, please do not input other parameters, the PCM ue tia interface is set by the default configurations. Q n 12.9. AT+QLTONE Play a Local Customized Tone fide AT+QLTONE is used to play a customized tone, use to indicate play time, to indicate mute time, and to indicate total time. n AT+QLTONE Play a Local Customized Tone Test Command Co AT+QLTONE=? Response +QLTONE: (0,1),(100-3900),(0-1000),(0-1000),(0-15300000) OK Write Command AT+QLTONE=[,, ,, ] Response OK +CME ERROR: After playing completed, report: +QLTONE: 0 Maximum Response Time 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 189 / 247 Parameter UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 0 Stop play 1 Start play Tone‟s frequency, unit: Hz, range: 100-3900 Tone‟s on time, unit: ms, range: 0-1000 Tone‟s mute time, unit: ms, range: 0-1000 Tone‟s total time, unit: ms, range: 0-15300000 NOTE This parameter will not be saved. Example l AT+QLTONE=? //Query the range. +QLTONE: (0,1),(100-3900),(0-1000),(0-1000),(0-15300000) te OK c l AT+QLTONE=1,1000,200,300,3000 ue tia OK //Play a 1000Hz tone, on time is 200ms, mute time is 300ms, total time is 3000ms. Q n +QLTONE:0 AT+QLTONE=0 e OK //Stop playing. fid 12.10. AT+QLDTMF Play Local DTMF on AT+QLDTMF is used to play a DTMF string, maximum length is 20 characters. You can use AT+QLDTMF C to stop it. AT+QLDTMF Play Local DTMF Test Command AT+QLDTMF=? Response +QLDTMF: (1-1000),(0-9,A-G,*,#) OK Write Command AT+QLDTMF=,[,] Response OK +CME ERROR: WCDMA_UGxx_AT_Commands_Manual Confidential / Released 190 / 247 Execute Command AT+QLDTMF Maximum Response Time UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual After playing completed, report: +QLDTMF: 5 Response OK 300ms Parameter Numeric type, indicates every DTMF‟s on time and mute time. Ranges: 1-1000, the unit is 1/100 second when is set to 1; or 1/10 second when is not set. String type, max 20 DTMFs, separated by comma. DTMFs: 0-9, A-G, #, * NOTE l This parameter will not be saved. cte l Example ue tia AT+QLDTMF=? //Query the range. +QLDTMF: (1-1000),(0-9,A-G,*,#) OK Q n AT+QLDTMF=2,'1,2,#' e OK //Play 1, 2, # on time & mute time is 200ms. fid +QLDTMF: 5 AT+QLDTMF OK //Stop playing. Con 12.11. AT+QWDTMF Play/Send DTMF Tone(s) This command is used to play or send DTMF tone(s). AT+QWDTMF Play/Send DTMF Tone(s) Test Command AT+QWDTMF=? Response +QWDTMF: (0,1),(0,1),(',,[,...]') WCDMA_UGxx_AT_Commands_Manual Confidential / Released 191 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual OK Set Command AT+QWDTMF=,, ('DTMF_code>,,< mute_time>[,...]') Response OK +CME ERROR: After playing completed, report: +QWDTMF: 5 Maximum Response Time 300ms Parameter l CQouneficdteential Numeric type, mute uplink or not 0 Mute 1 Not mute Numeric type, mute downlink or not 0 Mute 1 Not mute String type, max 20 DTMFs 0 DTMF 0 1 DTMF 1 2 DTMF 2 3 DTMF 3 4 DTMF 4 5 DTMF 5 6 DTMF 6 7 DTMF 7 8 DTMF 8 9 DTMF 9 A DTMF A B DTMF B C DTMF C D DTMF D E DTMF E F DTMF F G DTMF G * DTMF * # DTMF # Numeric type, indicates duration of each DTMF tone. Unit: ms, range: 0-10000. Numeric type, indicates mute time. Unit: ms, range: 0-10000. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 192 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual NOTE This parameter will not be saved. Example AT+QWDTMF=? //Query the range. +QWDTMF: (0,1),(0,1),(',,[,...]') OK AT+QWDTMF=1,1,'1,1000,10,2,1000,2' //Play 1, 2 both uplink and downlink OK +QWDTMF: 5 AT+QWDTMF=0,1,'1,1000,10' l OK te +QWDTMF: 5 //Only Play 1 on downlink uec tial 12.12. AT+QMIC Set Uplink(MIC) Volume Q n This command is used to set MIC gains to change uplink volume. e AT+QMIC Set Uplink(MIC) Volume fid Test Command AT+QMIC=? Response +QMIC: (0-2),(0-15) n Read Command Co AT+QMIC? OK Response +QMIC: ,, Set Command AT+QMIC=, OK Response OK ERROR Maximum Response Time 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 193 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Numeric type, audio mode 0 Handset 1 Headset 2 Handfree Numeric type, indicates uplink volume. Range: 0-15, the default value of mode 0 is 12, the default value of headset mode is 14, the default value of handfree mode is 13. NOTE These parameters will not be saved. l 12.13. AT+QAUDMOD Set Audio Mode te AT+QAUDMOD sets the audio mode required for the connected device. c l AT+QAUDMOD Set Audio Mode ue tia TestCommand AT+QAUDMOD=? Response +QAUDMOD: (0-2) Q n Read command e AT+QAUDMOD? OK Response +QAUDMOD: fid Write Command n AT+QAUDMOD= OK Response OK o If error is related to ME functionality: C +CME ERROR: Maximum Response Time 300ms Parameter Numeric type, indicates the current configured audio mode 0 Echo canceller, noise suppressor, digital gain and calibration parameter for Handset 1 Echo canceller, noise suppressor, digital gain and calibration parameter for Headset 2 Echo canceller, noise suppressor, digital gain and calibration parameter for Speaker WCDMA_UGxx_AT_Commands_Manual Confidential / Released 194 / 247 NOTE These parameters will not be saved. UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12.14. AT+QAUDCFG Audio Tuning Process AT+QAUDCFG is used to query and configure various audio settings of UE. AT+QAUDCFG Audio Tuning Process Test Command CQouneficdteenl tial AT+QAUDCFG=? Response +QAUDCFG: 'handset/eec', (list of supported s) +QAUDCFG: 'headset/eec', (list of supported s) +QAUDCFG: 'handfree/eec', (list of supported s) +QAUDCFG: 'handset /nr/ul', (list of supported s) +QAUDCFG: 'headset /nr/ul', (list of supported s) +QAUDCFG: 'handfree/nr/ul', (list of supported s) +QAUDCFG: 'handset /nr/dl', (list of supported s) +QAUDCFG: 'headset /nr/dl', (list of supported s) +QAUDCFG: 'handfree/nr/dl', (list of supported s) +QAUDCFG: 'max9860/dlgain', +QAUDCFG: 'max9860/ulgain', +QAUDCFG: 'alc5616/dlgain', +QAUDCFG: 'alc5616/ulgain', +QAUDCFG: 'nau8814/dlgain', +QAUDCFG: 'nau8814/ulgain', Maximum Response Time OK 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 195 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12.15. AT+QAUDCFG Extension Configuration 12.15.1. AT+QAUDCFG='handset/eec' Set Echo Cancellation for Handset AT+QAUDCFG='handset/eec' is used to set echo cancellation for handset. AT+QAUDCFG='handset/eec' Set Echo Cancellation for Handset Test Command Response AT+QAUDCFG=? …… +QAUDCFG: 'handset/eec', …… OK Write Command uectel tial AT+QAUDCFG='handset/eec'[,] Response If configuration parameters are omitted: +QAUDCFG: 'handset/eec', OK If configuration parameters are entered: OK ERROR Parameter CQonfiden List of integers, separated by dot (.) Par0 Echocancollationcontrol word, 1: enable, 0: disable, default value might be different in different audio modes Par1 AEC (Acoustic Echo Canceller) control word, 1: enable, 0: disable, default value might be different in different audio modes Par2 EC_NrCoeffs_Real, Number of taps in real subband, range: 1-528. Default value might be different in different audio modes Par3 EC_NrCoeffs_Complex_1, Number of taps in complex subband 1, range: 1-528. Default value might be different in different audio modes Par4 EC_NrCoeffs_Complex_2, Number of taps in complex subband2, range: 1-528. Default value might be different in different audio modes Par5 EC_NrCoeffs_Complex_3, Number of taps in complex subband3, range: 1-528. Default value might be different in different audio modes Par6 EC_NrCoeffs_Complex_4, Number of taps in complex subband4, range: 1-528. Default value might be different in different audio modes Par7 EC_NrCoeffs_Complex_5, Number of taps in complex subband5, range: 1-528. Default value might be different in different audio modes Par8 EC_Blen, NLMS update block length range: (1,2,4,5,8). Default value might be different in different audio modes WCDMA_UGxx_AT_Commands_Manual Confidential / Released 196 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Par9 SER (Spectral Echo Reduction) control word, 1: enable, 0: disable, default value might be different in different audio modes Par10 SER_Beta, Smoothing factor of the echo reduction applied by the SER, range: 0-32767. Default value might be different in different audio modes Par11 SER_Overest, Overestimation factor of the echo estimation, range: 0-32767. Default value might be different in different audio modes Par12 SER_NoiseLevel, Overestimation factor of the noise estimation, range: 0-32767. Default value might be different in different audio modes Par13 SER_MultCtrl, Allowed amplitude of short-term variations of noise estimation, range: 0-32767. Default value might be different in different audio modes Par14 AGC (Automatic Gain Control) control word, 1: enable, 0: disable, default value might be different in different audio modes Par15 Par16 l Par17 te Par18 c l Par19 ue tia Par20 Q en Par21 fid Par22 Con Par23 RE_LdAddGain, Additionalgain, range: -16384~16384. Default value might be different in different audio modes RE_LdGainLoLim, Total gain lower limit, range: 0-16384. Default value might be different in different audio modes RE_LdGainUpLim, Total gain upper limit, range: 0-16384. Default value might be different in different audio modes RE_NrShliFilt, Shifts for gain smoothing, range: -36~36. Default value might be different in different audio modes RE_TriggerOffset, AGC trigger offset for the decision logic to allow more double-talk, range: -16384~16384. Default value might be different in different audio modes RE_FarPowerCenter, Threshold on far-end power (below which overestimation is Par22, above which estimationisPar23), range: 0-16384. Default value might be different in different audio modes RE_FarPowerDistorted, Threshold on far-end overestimated power (above which overestimated by Par24, to compensate residual echo when strong LS distortion), range: 0-16384. Default value might be different in different audio modes RE_FarOverEstR0, Far-end power overestimation ratio if loudspeaker power is below Par20, range: 0-14666. Default value might be different in different audio modes RE_FarOverEstR1, Far-end power overestimation ratio if loudspeaker power is abovePar20, range: 0-14666. Default value might be different in different audio modes Par24 RE_FarOverEstR2, Far-end power overestimation ratio if loudspeaker power is above Par21, range: 0-16384. Default value might be different in different audio modes Par25 EDL (Echo Delay Lines) control word, 1: enable, 0: disable, default value might be different in different audio modes Par26 Delay in milliseconds in the echo reference path, range: 0-60. Default value might be different in different audio modes WCDMA_UGxx_AT_Commands_Manual Confidential / Released 197 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual NOTES 1. Auto save the configuration to NV. The setting is still valid after module restart. 2. If you set Par1 & Par9 & Par14 & Par25 to 0, please set Par0 to 0, otherwise it will return error. When you set Par0 to 0, Par1 & Par9 & Par14 & Par25 will be set to 0 by default. 3. Par2+2*(Par3 Par4+Par5+Par6+Par7) < 2200. Example AT+QAUDCFG='handset/eec','1.1.100.100.100.1.1.1.2.1.32113.16384.2560.4096.1.0.0.5000.0.0.512 0.12288.256.282.307.1.0' //Set configuration to default OK AT+QCFG='handset/eec' //Query +QAUDCFG: l 'handset/eec','1.1.100.100.100.1.1.1.2.1.32113.16384.2560.4096.1.0.0.5000.0.0.5120.12288.256.282. 307.1.0' te OK uec tial 12.15.2. AT+QAUDCFG='headset/eec' Set Echo Cancellation for Headset AT+QAUDCFG='headset/eec' is used to set echo cancellation for headset. Q n AT+QAUDCFG='headset/eec' Set Echo Cancellation for Headset e Test Command nfid AT+QAUDCFG=? Response …… +QAUDCFG: 'headset/eec', …… OK Write Command Co AT+QAUDCFG='headset/eec'[,] Response If configuration parameters are omitted' +QAUDCFG: 'headset/eec', OK If configuration parameters are entered' OK ERROR WCDMA_UGxx_AT_Commands_Manual Confidential / Released 198 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter List of integers, separated by dot (.), for details, please refer to of AT+QAUDCFG='handset/eec' Example AT+QAUDCFG='headset/eec','1.1.100.100.100.1.1.1.2.1.32113.16384.2560.4096.1.0.0.5000.0.0.512 0.12288.256.282.307.1.0' //Set configuration to default OK AT+QCFG='headset/eec' //Query +QAUDCFG: 'headset/eec','1.1.100.100.100.1.1.1.2.1.32113.16384.2560.4096.1.0.0.5000.0.0.5120.12288.256.282. 307.1.0' OK tel NOTE c l The configuration will be saved to NV automatically. ue tia 12.15.3. AT+QAUDCFG='handfree/eec' Set Echo Cancellation for Handfree Q n AT+QAUDCFG='handfree/eec' is used to set echo cancellation for handfree. e AT+QAUDCFG='handfree/eec' Set Echo Cancellation for Headfree fid Test Command n AT+QAUDCFG=? Response …… +QAUDCFG: 'handfree/eec', …… OK o Write Command C AT+QAUDCFG='handfree/eec'[,] Response If configuration parameters are omitted: +QAUDCFG='handfree/eec', OK If configuration parameters are entered: OK ERROR WCDMA_UGxx_AT_Commands_Manual Confidential / Released 199 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter List of integers, separated by dot (.), for more details, please refer to of AT+QAUDCFG='handset/eec'. Example AT+QAUDCFG='handfree/eec','1.1.150.150.150.1.1.1.2.1.32113.16384.10240.16384.1.1800.80.8192 .0.0.6144.12288.256.282.307.1.0' //Set configuration to default OK AT+QCFG='handfree/eec' //Query +QAUDCFG: 'handfree/eec','1.1.150.150.150.1.1.1.2.1.32113.16384.10240.16384.1.1800.80.8192.0.0.6144.12288. 256.282.307.1.0' OK tel NOTE c l The configuration will be saved to NV automatically. ue tia 12.15.4. AT+QAUDCFG='handset/nr/ul' Set Uplink Noise Reduction for Handset Q n AT+QAUDCFG='handset/nr/ul' is used to set uplink noise reduction for handset. e AT+QCFG='handset/nr/ul' Set Uplink Noise Reduction for Handset fid Test Command on AT+QAUDCFG=? Response …… +QAUDCFG: 'handset/nr/ul', …… OK C Write Command Response AT+QAUDCFG='handset/nr/ul'[,] If configuration parameters are omitted: +QAUDCFG: 'handset/nr/ul', OK If configuration parameters are entered: OK ERROR WCDMA_UGxx_AT_Commands_Manual Confidential / Released 200 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter List of integers, separated by dot (.) Par0 Noise Reduction control word, 1: enable, 0: disable, Default value might be different in different audio modes Par1 NR_AttenFactorMinVal, Minimum value of Noise Reduction gain, range: 0-32767. Default value might be different in different audio modes Par2 NR_OvEstFacBandZero, Overestimation factor for Noise Reduction in band 0, range: 0-32767. Default value might be different in different audio modes Par3 NR_OvEstFacBandNoZero, Overestimation factor for Noise Reduction in band 1 to 7, range: 0-32767. Default value might be different in different audio modes Par4 NR_GainFactor, Defines how aggressive the NR is, range: 0-32767. Default value Par5 might be different in different audio modes NR_GainLimit, Maximum gain allow, range: 0-32767. Default value might be different in different audio modes l NOTE te Auto save the configuration to NV. The setting is still valid after module restart. uec tial Example AT+QAUDCFG='handset/nr/ul', '1.6000.9000.10000.1800.19660' //Set configuration to default Q n OK e AT+QAUDCFG='handset/nr/ul' //Query fid +QAUDCFG: 'handset/nr/ul', '1.6000.9000.10000.1800.19660' OK Con 12.15.5. AT+QAUDCFG='handset/nr/dl' Set Down Link Noise Reduction for Handset AT+QAUDCFG='handset/nr/dl' is used to set down link noise reduction for handset. AT+QCFG='handset/nr/dl' Set Down Link Noise Reduction for Handset Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'handset/nr/dl', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 201 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='handset/nr/dl'[,] Response If configuration parameters are omitted: +QAUDCFG:'handset/nr/dl', OK If configuration parameters are entered: OK ERROR Parameter List of integers, separated by dot (.). For more details, please refer to of AT+ QAUDCFG='handset/nr/ul' l NOTE te Auto save the configuration to NV. The setting is still valid after module restart. uec tial Example AT+QAUDCFG='handset/nr/dl','1.12000.10000.10000.1000.19660' //Set configuration to default Q n OK AT+QAUDCFG='handset/nr/dl' //Query fide +QAUDCFG: 'handset/nr/dl','1.12000.10000.10000.1000.19660' OK on 12.15.6. AT+QAUDCFG='headset/nr/dl' Set Down Link Noise Reduction for Headset C AT+QAUDCFG='headset/nr/dl' is used to set down link noise reduction for headset. AT+QCFG='headset/nr/dl' Set Down Link Noise Reduction for Headset Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'headset/nr/dl', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 202 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='headset/nr/dl'[,] Response If configuration parameters are omitted: +QAUDCFG: 'headset/nr/dl', OK If configuration parameters are entered: OK ERROR Parameter List of integers, separated by dot (.). For details, please refer to of AT+ QAUDCFG='handset/nr/ul' l NOTE te Auto save the configuration to NV. The setting is still valid after module restart. uec tial Example AT+QAUDCFG='headset/nr/dl','1.12000.10000.10000.1000.19660' //Set configuration to default Q n OK AT+QAUDCFG='headset/nr/dl' //Query fide +QAUDCFG: 'headset/nr/dl', '1.12000.10000.10000.1000.19660' OK on 12.15.7. AT+QAUDCFG='headset/nr/ul' Set Uplink Noise Reduction for Headset C AT+QAUDCFG='headset/nr/ul' is used to set uplink noise reduction for headset. AT+QCFG='headset/nr/ul' Set Uplink Noise Reduction for Headset Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'headset/nr/ul', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 203 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='headset/nr/ul'[,] Response If configuration parameters are omitted: +QAUDCFG: 'headset/nr/ul', OK If configuration parameters are entered: OK ERROR Parameter List of integers, separated by dot (.). For details, please refer to of AT+ QAUDCFG='handset/nr/ul' l NOTE te Auto save the configuration to NV. The setting is still valid after module restart. uec tial Example AT+QAUDCFG='headset/nr/ul','1.6000.9000.10000.1800.19660' Q n OK AT+QAUDCFG='headset/nr/ul' fide +QAUDCFG: 'headset/nr/ul','1.6000.9000.10000.1800.19660' OK //Set configuration to default //Query on 12.15.8. AT+QAUDCFG='handfree/nr/dl' Set Down Link Noise Reduction for CHandfree AT+QAUDCFG='handfree/nr/dl' is used to set down link noise reduction for handfree. AT+QCFG='handfree/nr/dl' Set Down Link Noise Reduction for Handfree Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'handfree/nr/dl', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 204 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='handfree/nr/dl'[,] Response If configuration parameters are omitted: +QAUDCFG: 'handfree/nr/dl', OK If configuration parameters are entered: OK ERROR Parameter List of integers, separated by dot (.). For details, please refer to of AT+ QAUDCFG='handset/nr/ul' l NOTE te Auto save the configuration to NV. The setting is still valid after module restart. uec tial Example AT+QAUDCFG='handfree/nr/dl','1.12000.10000.10000.1000.19660' //Set configuration to default Q n OK AT+QAUDCFG='handfree/nr/dl' //Query fide +QAUDCFG: 'handfree/nr/dl','1.12000.10000.10000.1000.19660' OK on 12.15.9. AT+QAUDCFG='handfree/nr/ul' Set Uplink Noise Reduction for Handfree C AT+QAUDCFG='handfree/nr/ul' is used to set uplink reduction for handfree. AT+QCFG='handfree/nr/ul' Set Uplink Noise Reduction for Handfree Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'handfree/nr/ul', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 205 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='handfree/nr/ul'[,] Response If configuration parameters are omitted: +QAUDCFG: 'handfree/nr/ul', OK If configuration parameters are entered: OK ERROR Parameter List of integers, separated by dot (.). For details, please refer to of AT+ QAUDCFG='handset/nr/ul' l NOTE te Auto save the configuration to NV. The setting is still valid after module restart. uec tial Example AT+QAUDCFG='handfree/nr/ul','1.6000.9000.10000.1800.19660' //Set configuration to default Q n OK AT+QAUDCFG='handfree/nr/ul' //Query fide +QAUDCFG: 'handfree/nr/ul','1.6000.9000.10000.1800.19660' OK on 12.15.10. AT+QAUDCFG='nau8814/dlgain' Set Down Link Gain Level for Codec Cnau8814 AT+QAUDCFG='nau8814/dlgain' is used to set down link gain level for codec nau8814. AT+QAUDCFG='nau8814/dlgain' Set Down Link Gain Level for Codec nau8814 Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'nau8814/dlgain', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 206 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='nau8814/dlgain'[,] Response If configuration parameters are omitted: (+QAUDCFG='nau8814/dlgain'), Return current configuration: +QAUDCFG: 'nau8814/dlgain', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: Parameter tel Numeric type, indicates the downlink gain of nau8814, range: 0-100, default: 100 uec tial NOTE This parameter will not be saved. Q en Example AT+QAUDCFG='nau8814/dlgain',85 fid OK //Set downlink gain to 85 n 12.15.11. AT+QAUDCFG='nau8814/ulgain' Set Uplink Gain Level for Codec Co nau8814 AT+QAUDCFG='nau8814/ulgain' is used to set uplink gain level for codec nau8814. AT+QAUDCFG='nau8814/ulgain' Set Uplink Gain Level for Codec nau8814 Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'nau8814/ulgain', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 207 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='nau8814/ulgain'[,] Response If configuration parameters are omitted: (+QAUDCFG='nau8814/ulgain'), Return current configuration: +QAUDCFG: 'nau8814/ulgain', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: Parameter tel Numeric type, indicates the uplink gain of nau8814, range: 0-100, default: 84 uec tial NOTES This parameter will not be saved. Q en Example AT+QAUDCFG='nau8814/ulgain',90 fid OK //Set uplink gain to 90 n 12.15.12. AT+QAUDCFG='alc5616/dlgain' Set Down Link Gain Level for Codec Co alc5616 AT+QAUDCFG='alc5616/dlgain' is used to set down link gain level for codec alc5616. AT+QAUDCFG='alc5616/dlgain' Set Down Link Gain Level for Codec alc5616 Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'alc5616/ dlgain', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 208 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='alc5616/dlgain'[,] Response If configuration parameters are omitted: (+QAUDCFG='alc5616/dlgain'), Return current configuration: +QAUDCFG: 'alc5616/dlgain', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: Parameter tel Numeric type, indicates the downlink gain of alc5616, range: 0-100, default: 100 uec tial NOTE This parameter will not be saved. Q en Example AT+QAUDCFG='alc5616/dlgain',85 fid OK //Set downlink gain to 85 n 12.15.13. AT+QAUDCFG='alc5616/ulgain' Set Uplink Gain Level for Codec alc5616 Co AT+QAUDCFG='alc5616/ulgain' is used to set uplink gain level for codec alc5616. AT+QAUDCFG='alc5616/ulgain' Set Uplink Gain Level for Codec alc5616 Test Command AT+QAUDCFG=? Write Command Response …… +QAUDCFG: 'alc5616/ ulgain', …… OK Response WCDMA_UGxx_AT_Commands_Manual Confidential / Released 209 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+QAUDCFG='alc5616/ulgain'[,] If configuration parameters are omitted: (+QAUDCFG='alc5616/ulgain'), Return current configuration: +QAUDCFG: 'alc5616/ulgain', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: Parameter l Numeric type, indicates the uplink gain of alc5616, range: 0-100, default: 74 cte l NOTES ue tia This parameter will not be saved. Q n Example e AT+QAUDCFG='alc5616/ulgain',85 fid OK //Set uplink gain to 85 n 12.15.14. AT+QAUDCFG='max9860/dlgain' Set Down Link Gain Level for Codec Co max9860 AT+QAUDCFG='max9860/dlgain' is used to set down link gain level for codec max9860. AT+QAUDCFG='max9860/dlgain' Set Down Link Gain Level for Codec max9860 Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'max9860/dlgain', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 210 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='max9860/dlgain'[,] Response If configuration parameters are omitted: (+QAUDCFG='max9860/dlgain'), Return current configuration: +QAUDCFG: 'max9860/dlgain', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: Parameter tel Numeric type, indicates the down link gain of max9860, range: 0-100, default: 87 uec tial NOTES This parameter will not be saved. Q en Example AT+QAUDCFG='max9860/dlgain',85 //Set downlink gain to 85 fid OK n 12.15.15. AT+QAUDCFG='max9860/ulgain' Set Uplink Gain Level for Codec Co max9860 AT+QAUDCFG='max9860/ulgain' is used to set uplink gain level for codec max9860. AT+QAUDCFG='max9860/ulgain' Set Uplink Gain Level for Codec max9860 Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'max9860/ulgain', …… OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 211 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Write Command AT+QAUDCFG='max9860/ulgain'[,] Response If configuration parameters are omitted: (+QAUDCFG='max9860/ulgain'), Return current configuration: +QAUDCFG: 'max9860/ulgain', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: Parameter tel Numeric type, indicates the uplink gain of max9860, range: 0-100, default: 80 uec tial NOTES This parameter will not be saved. Q en Example AT+QAUDCFG='max9860/ulgain',85 //Set uplink gain to 85 fid OK Con 12.16. AT+QSIDET Set the Side Tone Gain in Current Mode AT+QSIDET is used to set the side tone gain value of the current mode. AT+QSIDET Set the Side Tone Gain in Current Mode Test Command AT+QSIDET=? Response +QSIDET: (-450~200) OK WCDMA_UGxx_AT_Commands_Manual Confidential / Released 212 / 247 Read Command AT+QSIDET? Write Command AT+QSIDET= Maximum Response Time UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Response +QSIDET: OK Response OK ERROR 300ms Parameter Numeric type, indicates the configured side tone gain in current mode. Range: -450~200. The default value of mode 0 is -100, the default value of mode 1 is -100 , the default value of mode 2 is -450. tel NOTE c l The configuration will be saved to NV automatically. ue tia 12.17. AT+QAUDGAIN Set Gain Offset Q en This command is used to set gain offset to change uplink and downlink volume. fid AT+QAUDGAIN Set Gain Offset Test Command AT+QAUDGAIN=? Response +QAUDGAIN: (0-2),(-600~300),(-600~300) Con Set Command OK Response AT+QAUDGAIN=[,,] +QAUDGAIN:,, OK Maximum Response Time If configuration parameters are entered: OK ERROR 300ms WCDMA_UGxx_AT_Commands_Manual Confidential / Released 213 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Parameter Numeric type, audio mode 0 Handset 1 Headset 2 Handfree Numeric type, value: -600~300, indicates uplink gain offset. Default value of mode 0 is -1, the default value of mode 1 is 60, the default value of mode 2 is 100. Numeric type, value: -600~300, indicates downlink gain offset. Default value of mode 0 is 50, the default value of mode 1 is -1, the default value of mode 2 is 60. NOTE The configuration will be saved to NV automatically tel 12.18. AT+QCLKOUT Output Clock Source c l AT+QCLKOUT is used to output clock source from pin25. ue tia AT+QCLKOUT Output Clock Source Test Command Q n AT+QCLKOUT=? Response +QCLKOUT: (0,1),(1-4) fide Read Command AT+QCLKOUT? OK Response +QCLKOUT: , on Write Command C AT+QCLKOUT=[,] OK +CME ERROR: Response OK ERROR Maximum Response Time 300ms Parameter 0 Disable to output clock source 1 Enable to output clock source 1 26MHz WCDMA_UGxx_AT_Commands_Manual Confidential / Released 214 / 247 2 13MHz 3 6.5MHz 4 32KHz NOTES 1. Parameters will not be saved to NV. 2. When Pin25 is busy, it will return CME error. UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12.19. AT+QPCMON Enable PCM Sync & BCLK AT+QPCMON is used to enable PCM sync & BCLK. AT+QPCMON Enable PCM Sync & BCLK l Test Command te AT+QPCMON=? Response +QPCMON: (list of supported s) uec tial ReadCommand AT+QPCMON? OK Response +QPCMON: Q n Write Command e AT+QPCMON= fid Maximum Response Time OK Response OK ERROR 300ms n Parameter Co Numeric type 0 Close PCM sync & BCLK 1 Enable PCM sync & BCLK NOTE This parameter will not be saved. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 215 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 12.20. AT+QIIC IIC Read & Write AT+QIIC IIC Read & Write Test Command AT+QIIC=? Response +QIIC: (0-1),(0-FF),,,() Write Command AT+QIIC=,,,[,] OK If configuration parameters are entered: Response OK tel Maximum Response Time If configuration parameters are omitted: Response +QIIC: OK 300ms c l Parameter ue tia Q n e fid 0 Write command 1 Read command 0-0xFF, device address 0-0xFF, register address 1-2, read/write bytes 0-0xFFFF NOTE Con This parameter will not be saved. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 216 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 13 Hardware Related Commands 13.1. AT+QPOWD Power Off The command AT+QPOWD is used to shut down the module. The UE will return OK immediately when the command is executed. Then the UE deactivates the network. After it is completed, the UE outputs the message 'POWERED DOWN' and sets the STATE pin as low to enter into the shutdown state. The maximum time for network log-off is 60 seconds. In order to avoid data loss, it is only allowed to turn off the UE power after the module‟s STATE pin is set as low and the URC 'POWERED DOWN' is outputted. l If 'POWERED DOWN' has not been received after 65s, you should force to switch off the VBAT. te AT+QPOWD Power Off c l Test Command AT+QPOWD=? Response +QPOWD: (0,1) ue tia ExecuteCommand Q n AT+QPOWD[=] OK Response OK fide Maximum Response Time POWERED DOWN 300ms n Parameter o 0 C1 Immediately power down Normal power down 13.2. AT+CCLK Clock AT+CCLK sets and queries the real time clock (RTC) of the module. The current setting is retained until the module is totally disconnected from power. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 217 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+CCLK Clock Test Command AT+CCLK=? Read Command AT+CCLK? Response OK Response +CCLK: Write Command AT+CCLK= OK Response OK If error is related to ME functionality: Maximum Response Time Reference l 3GPP TS 27.007 +CME ERROR: 300ms te Parameter uec tial String type value, format is 'yy/MM/dd,hh:mm:ss±zz', indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range -48...+56). E.g. May 6th, 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08' Q en Example fid AT+CCLK? +CCLK: '08/01/04, 00:19:43+00' Con OK //Query the local time 13.3. AT+QALARM Set Alarm This command is used to set alarm based on RTC clock. When RTC clock ran to the alarm time preset, the URC 'ALARM RING' or 'ALARM MODE' would be reported. When ME is always powered on, 'ALARM RING' indicates an alarm is raised. When ME is powered off and kept the power supply, ME will be powered on by raised alarm and 'ALARM MODE' would be reported. WCDMA_UGxx_AT_Commands_Manual Confidential / Released 218 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual AT+QALARM Set Alarm Test Command AT+QALARM=? Response +QALARM: (0,1),'DATE,TIME',(0-3),(0,1) Read Command AT+QALARM? OK Response +QALARM: ,,,, OK Write Command AT+QALARM=,,, tel OK Response OK or ERROR If error is related to ME functionality: +CME ERROR: c l Reference ue tia Parameter Q n e Confid Indicate an alarm is presented or not 0 No alarm is presented 1 An alarm is presented A string parameter indicates the time an alarm raises. The format is 'yy/mm/dd,hh:mm:ss+/-zz' where characters indicate the last two digits of year, month, day, hour, minute, second and time zone. The time zone should be input. An integer parameter which indicates the repeat mode 0 None 1 Daily 2 Weekly 3 Monthly An integer parameter which indicates the method of controlling power when alarm raises 0 None. Only send 'ALARM RING' or 'ALARM MODE' to port 1 Alarm power off. ME sends 'ALARM RING' or 'ALARM MODE' to port and will be powered off in 5 seconds An integer parameter which indicates whether UE is powered on by alarm or not 0 UE is powered on but not by alarm 1 UE is powered on by alarm Set or cancel alarm WCDMA_UGxx_AT_Commands_Manual Confidential / Released 219 / 247 0 Cancel alarm 1 Set alarm NOTE The configuration will be saved to NV automatically UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Example AT+QALARM? +QALARM: 0,'',0,0,0 //Query the alarm status and no alarm is set OK AT+CCLK? +CCLK: '15/06/15,03:38:20+32' //Query the current time l OK te AT+QALARM=1,'15/06/15,03:39:53+32',1,0 //Set the alarm at 03:39:53 daily OK uec tial AT+QALARM? +QALARM: 1,'15/06/16,03:39:53',1,0,0 //Query the alarm status and a daily alarm is set Q n OK e ALARM RING fid AT+QALARM=0 OK AT+QALARM=1,'15/06/15,04:18:13+32',0,1 n OK o AT+QALARM? C +QALARM: 1,'15/06/15,04:18:13',0,1,0 //When the time is 03:39:53, the ALARM RING URC is reported //Cancel the alarm preset //Set the alarm to power off the module at 04:18:13. //Query the alarm status and a power off alarm is set OK ALARM RING //When the time is 04:18:13, the ALARM RING URC is reported and the module is powered off automatically. POWERED DOWN //You need to power on the module manually by PWRKEY WCDMA_UGxx_AT_Commands_Manual Confidential / Released 220 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 13.4. AT+CBC Battery Charge AT+CBC returns battery connection status and battery charge level of the MT. AT+CBC Battery Charge Test Command AT+CBC=? Response +CBC: (list of supported s),(list of supported s),(voltage) OK Execution Command Response AT+CBC tel Maximum Response Time c l Reference ue tia 3GPPTS27.007 +CBC: ,, OK If error is related to ME functionality: +CME ERROR: 300ms Parameter Q n nfide Co Charge status 0 ME is not charging 1 ME is charging 2 Charging has finished 3 Recognized power fault, calls inhibited Battery connection level 0...100 Battery has 0-100 percent of capacity remaining vent Battery voltage (mV) 13.5. AT+QSCLK Configure Whether or not to Enter into Sleep Mode AT command AT+QSCLK is used to control the module whether or not to enter into sleep mode. AT+QSCLK Configure Whether or not to Enter into Sleep Mode Test Command AT+QSCLK=? Response +QSCLK: (list of supported s) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 221 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual Read Command AT+QSCLK? Write Command AT+QSCLK= Maximum Response Time OK Response +QSCLK: OK Response OK 300ms Parameter 0 Disable slow clock CQouneficdteenl tial 1 Enable slow clock, it is controlled by DTR WCDMA_UGxx_AT_Commands_Manual Confidential / Released 222 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 14 Appendix 14.1. Reference Table 5: Related Documents SN Document Name [1] V.25ter l [2] 3GPP TS 27.007 Quectential [3] 3GPP TS 27.005 Remark Serial asynchronous automatic dialing and control Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; AT command set for User Equipment (UE) Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; Use of Data Terminal Equipment - Data Circuit terminating Equipment (DTE- DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) fide Table 6: Terms and Abbreviations Abbreviation n AMR Co ME Description Adaptive Multi-Rate Mobile Equipment TA Terminal Adapter MS Mobile Station DCE Data Communication Equipment TE Terminal Equipment DTE Data Terminal Equipment WCDMA_UGxx_AT_Commands_Manual Confidential / Released 223 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual RTS/CTS Request To Send/Clear To Send GPRS General Packet Radio Service DCD Dynamic Content Delivery DTR Data Terminal Ready CSD Circuit Switch Data PSC Primary Synchronization Code PDP Packet Data Protocol TCP UDP l ECT Transmission Control Protocol User Datagram Protocol Explicit Call Transfer supplementary service cte l 14.2. Factory Default Settings Restorable with AT&F ue tia Table 7: Factory Default Settings Restorable with AT&F Q n AT Command e ATE fid ATQ ATS0 n ATS3 Co ATS4 Parameters Factory Defaults 1 0 0 13 10 ATS5 8 ATS6 2 ATS7 0 ATS10 15 ATV 1 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 224 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual ATX 4 AT&C 1 AT&D 1 AT+IFC , 0,0 AT+CREG 0 AT+CGREG 0 AT+CBST AT+CMEE AT+CSCS AT+CSTA AT+CR AT+CRC AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+CVHU ,, 0,0,1 1 'GSM' l 129 te 0 c l 0 ue tia 0 0 Q n ,,, 17,167,0,0 e 0 fid 0 ,, 'SM','SM','SM' n,,,, 2,1,0,0,0 Co 0 0 AT+CLIP 0 AT+COLP 0 AT+CLIR 0 AT+CSSN 0,0 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 225 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 14.3. AT Command Setting Storable with AT&W Table 8: AT Command Settings Storable with AT&W AT Command Parameters Display with AT&V ATE Yes ATQ Yes ATS0 Yes ATS7 ATS10 ATV tel ATX AT&C uec tial AT&D AT+IFC Q n AT+IPR e AT+CREG fid AT+CGREG Yes Yes Yes Yes Yes Yes , No No No No Con 14.4. AT Command Settings Storable with ATZ Table 9: AT Command Settings Storable with ATZ AT Command ATE ATQ ATS0 Parameters Factory Defaults 1 0 000 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 226 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual ATS7 000 ATS10 015 ATV 1 ATX 4 AT&C 1 AT&D 1 AT+IFC , 0,0 AT+CREG 0 AT+CGREG 0 tel 14.5. Summary of CME ERROR Codes uec tial Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. Q n values are mostly used by common message commands. The following table lists most of general e and GRPS related ERROR Codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. fid Table 10: Different Coding Schemes of +CME ERROR: on Code of C 0 Meaning Phone failure 1 No connection to phone 2 Phone-adaptor link reserved 3 Operation not allowed 4 Operation not supported 5 PH-SIM PIN required WCDMA_UGxx_AT_Commands_Manual Confidential / Released 227 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 6 PH-FSIM PIN required 7 PH-FSIM PUK required 10 SIM not inserted 11 SIM PIN required 12 SIM PUK required 13 SIM failure 14 SIM busy 15 16 17 18 20 21 22 23 24 25 26 27 30 SIM wrong Incorrect password l SIM PIN2 required te SIM PUK2 required c l Memory full ue tia Invalidindex Not found Q n Memory failure e Text string too long fid Invalid characters in text string Dial string too long nInvalid characters in dial string CoNo network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required WCDMA_UGxx_AT_Commands_Manual Confidential / Released 228 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 48 Hidden key required 49 EAP method not supported 50 100 103 106 107 111 112 113 132 133 134 148 149 Incorrect parameters Unknown l Illegal MS te Illegal ME c l GPRS service not allowed ue tia PLMNnotallowed Location area not allowed Q n Roaming not allowed in this location area e Service not supported fid Service not subscribed Service option temporarily out of order nUnspecified GPRS error CoPDP authentication error 150 Invalid mobile class 201 Alternate SIM conflict 500 CTS Handover on Progress 501 Cellular Protocol Stack Out of service state 502 CTS Unspecified Error WCDMA_UGxx_AT_Commands_Manual Confidential / Released 229 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 800 SIM Security unspecified error 14.6. Summary of CMS ERROR Codes Final result code +CMS ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands: Table 11: Different Coding Schemes of +CMS ERROR: l Code of te 1 c l 8 ue tia 10 17 Q n 21 e 22 fid 27 28 n 29 Co 30 Meaning Unassigned (unallocated) number Operator determined barring Call barred Network failure Short message transfer rejected Memory capacity exceeded Destination out of order (service) Unidentified subscriber Facility rejected Unknown subscriber 38 Network out of order (service) 41 Temporary failure 42 Congestion 47 Resource unavailable unspecified 50 Requested facility not subscribed WCDMA_UGxx_AT_Commands_Manual Confidential / Released 230 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 69 Requested facility not implemented 81 Invalid short message transfer reference value 95 Semantically incorrect message 96 Invalid Mandatory Information 97 Message-type non-existent or not implemented 98 Message not compatible with short message protocol state 99 Information element non-existent or not implemented 111 127 128 129 130 143 144 145 159 160 161 175 176 Protocol error unspecified Interworking unspecified l Telematic interworking not supported (MO) te Short message type 0 not supported (MO/MT) c l Cannot replace short message (MO/MT) ue tia Unspecified TP-PID error (MO/MT) Data coding scheme (alphabet) not supported (MO) Q n Message class not supported (MT) e Unspecified TP-DCS error (MO/MT) fid Command cannot be actioned (MO) Command unsupported (MO) nUnspecified TP-Command error (MO) CoTPDU not supported (MO/MT) 192 Service centre (SC) busy (MO) 193 No SC subscription (MO) 194 SC system failure (MO) 195 Invalid short message entity (SME) address (MO) 196 Destination SME barred (MO) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 231 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 197 SM rejected duplicated SM (MO) 198 TP-VPF (validity period format) not supported (MO) 199 TP-VP (validity period) not supported (MO) 208 (U)SIM SMS storage full (MT) 209 No SMS storage capability in (U)SIM (MT) 210 Error in MS (MT) 211 Memory capacity exceeded (MT) 212 213 255 287 290 300 301 302 303 304 305 310 311 (U)SIM application toolkit busy (MT) (U)SIM data download error (MT) l Unspecified error cause (MO/MT) te Network failure unspecified c l Network no resource ue tia MEfailure SMS ME reserved Q n Operation not allowed e Operation not supported fid Invalid PDU mode Invalid text mode nSIM not inserted CoSIM pin necessary 312 PH SIM pin necessary 313 SIM failure 314 SIM busy 315 SIM wrong 320 Memory failure WCDMA_UGxx_AT_Commands_Manual Confidential / Released 232 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network 332 Network timeout 340 NO CNMA acknowledgement expected 500 Unknown 512 513 514 515 516 517 518 519 520 521 522 523 524 This and the following codes are manufacturer specific. Relay path Acknowledgement SMS timer expired l SMS forwarding availability failed te SMS forwarding availability aborted c l Invalid TP-MESSAGE-Type indicator ue tia No TP-Status report in phase 1 No TP-Reject-Duplicate in phase 1 Q n No TP-Reply-Path in phase 1 e No TP-User-Data-Header in phase 1 fid Missing TP-Validity-Period nInvalid TP-Service-Centre-Time-Stamp oMissing TP-Destination-Address C Invalid TP-Destination-Address 525 Missing Service-Centre-Address 526 Invalid Service-Centre-Address 527 Invalid alphabet 528 Invalid TP-User-Data-Length 529 Missing TP-User-Data WCDMA_UGxx_AT_Commands_Manual Confidential / Released 233 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 530 TP-User-Data too long (large) 531 No command request in phase 1 532 Command request invalid TP-Destination address 533 Command request invalid TP-User-Data length 534 Command request invalid TP-User-Data 535 Command request invalid TP-Command-Type 536 MN MNR creation failed 538 539 540 541 542 543 544 545 546 547 548 549 555 MS Network connection lost Pending MO SM transfer l MO SMS rejected by SIM MO SMS control te RP ERROR OK c l RP ERROR OK no icon display ue tia FDNcheckfailed Service centre address (SCA) FDN failed Q n Destination address (DA) FDN failed e BDN check failed fid Unspecified SMS PP error No route to destination nChannel unacceptable CoNo circuit/channel available 556 Access information discarded 557 Requested circuit/channel not available by other side 558 Quality of service unavailable 560 Bearer capability not authorized 561 Bearer capability not presently available WCDMA_UGxx_AT_Commands_Manual Confidential / Released 234 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 562 Service or option not available, unspecified 563 Bearer service not implemented 564 ACM equal to or greater than ACM max 565 Only restricted digital information bearer capability is available 566 Service or option not implemented, unspecified 567 User not member of CUG 568 Incompatible by destination 569 571 572 576 577 579 580 581 583 584 585 586 587 Invalid transit network selection Message not compatible with protocol state l Recovery on timer expiry te Data call active c l Speech call active ue tia MOC setup rejected due to missing ACM info Temporary forbidden call attempt Q n Called party is blacklisted e Temporary forbidden call attempt no service fid Temporary forbidden call attempt limited service Client temporary barred nDual service call active CoAtc Fclass not speech 590 Client not registered 591 Active client gone 595 Rejected by call control 601 Invalid ALS line 604 MM no service (out of coverage) WCDMA_UGxx_AT_Commands_Manual Confidential / Released 235 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual MM access class barred (RR_REL_IND During RR 605 Conn. Establishment 606 ME busy -CM service request already pending 608 Rejected due to SUP timer expiry 609 Rejected due to USSD busy 610 Rejected due to SS busy SIM toolkit request is rejected, because another SIM toolkit request 612 is pending Rejected because SIM toolkit request Is not yet answered by the 614 615 616 618 619 620 621 622 623 624 625 626 627 user MN setup SS error Call controller blocked (Other Call Command Pending l Environment parameter not set correctly (Fclass/Cmod) te Other blocking call present c l Lower Layer Failure ue tia The authentication procedure failed Q n The packet-switched registration procedure failed e CM service reject from the network fid The ABORT message was received from the network Timer expiry nIMSI detach was initiated CoNormal RR connection release (2G) 628 Registration failed 630 Failure due to handover 631 Link establishment failure 632 Random access failure 633 Radio link aborted WCDMA_UGxx_AT_Commands_Manual Confidential / Released 236 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 634 Lower layer failure in layer 1 635 Immediate assignment reject 636 Failure due to paging 637 Abnormal release unspecified 638 Abnormal release channel unacceptable 639 Abnormal release timer expired 640 Abnormal release no act on radio path 641 642 643 644 647 649 650 653 654 656 657 658 659 Preemptive release UTRAN configuration unknown l Handover impossible te Channel mode unacceptable c l Lower layer failure from NW ue tia Conditional IE error No cell allocation available Q n Re-establishment reject e Directed Sigconn Re-establishment fid Release of RRC connection without network activity (3G) lower layer failure downlink nLower layer failure uplink oCell barred due to authentication failure C Signaling connection release 660 CS connection release triggered by MM 661 RRC connection establishment failure 662 RRC connection establishment reject with redirection 663 Resource conflict 664 Layer failure in layer 2 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 237 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 665 L2 cause T200 expiry N200 plus 1 Times 669 RR connection release due to BAND change (2G) Release of the RRC connection due to out of service 670 in Cell_Fach (3G) Release of the RRC connection due to not matching 671 PLMN in shared networks (3G) 672 Error Happens while call Is already disconnected/late error 674 SIM toolkit cannot initiate a call, because MMI is not registered 675 SIM toolkit call setup request is rejected due user did not accept 676 Proactive SIM appl terminated by user 677 SIM toolkit originated SIM reset (Refresh Request) l 680 Dial string/number incorrect uecte tial 14.7. SummaryofURC Table 12: Summary of URC Q n Index URC Display fide 1 RDY 2 +CFUN: 1 n 3 +CPIN: Co 4 +QUSIM: 0 Meaning ME initialization is successful All function of the ME is available SIM card pin state Use SIM card Condition N/A N/A N/A N/A 5 +QUSIM: 1 Use USIM card N/A 6 +QIND: SMS DONE SMS initialization finished N/A 7 +QIND: PB DONE Phonebook initialization finished N/A 8 POWERED DOWN Module power down AT+QPOWD 10 +CREG: Indicate registration status of the ME AT+CREG=1 WCDMA_UGxx_AT_Commands_Manual Confidential / Released 238 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual +CREG: 11 [,,[,]] 12 +CGREG: +CGREG: 13 [,,[,]] After cell neighborhood changing shows whether the network has currently indicated the registration of the ME, with location area code AT+CREG=2 Indicate network registration status of the ME AT+CGREG=1 After cell neighborhood changing shows whether the network has currently indicated network registration status of the ME, with location area code AT+CGREG=2 14 +CTZV: Time zone reporting AT+CTZR=1 15 16 17 18 19 20 21 22 23 +CTZE: ,, Extended time zone reporting AT+CTZR=2 +CMTI: , New message is received, and saved to See AT+CNMI memory l +CMT: New short message is received and [], c l +CMT: ,[],[,,< New short message is received and See AT+CNMI ue tia fo>,,,,, output directly to TE (Text mode) ] Q n +CBM: New CBM is received and output directly See AT+CNMI (PDU mode) +CBM: e New CBM is received and output directly ,,,,,, +CDS: (PDU mode) n +CDS:,,[],[], New CDS is received and output directly See AT+CNMI ,, to TE (Text mode) o +COLP: The presentation of the COL(connected C ,,[],[ line) at the TE for a mobile originated AT+COLP=1 ],[] call +CLIP: 24 ,,[subaddr],[sat Mobile terminating call indication AT+CLIP=1 ype],[], 25 +CRING: An incoming call is indicated to the TE with unsolicited result code instead of AT+CRC=1 the normal RING +CCWA: 26 Call waiting indication ,,[,] 27 +CSSI: Shows the +CSSI intermediate result AT+CSSN=1 code presentation status to the TE 28 +CSSU: Shows the +CSSU unsolicited result AT+CSSN=,1 code presentation status to the TE +CUSD: 29 [,,[]] USSD response from the network, or a AT+CUSD=1 network initiated operation +QSIMSTAT: 30 1, Indicate SIM card inserted or removed AT+QSIMSTAT=1 +CGEV: NW DEACT The network has forced a context 31 , , AT+CGEREP=2,1 deactivation [] +CGEV: ME DEACT 32 , , [] The ME has forced a context AT+CGEREP=2,1 deactivation. tel 33 +CGEV: NW DETACH The network has forced a Packet AT+CGEREP=2,1 Domain detach c l 34 +CGEV: ME DETACH The mobile equipment has forced a AT+CGEREP=2,1 Packet Domain detach The network has forced a change of MS ue tia 35 +CGEV: NW CLASS AT+CGEREP=2,1 class The mobile equipment has forced a 36 +CGEV: ME CLASS change of MS class AT+CGEREP=2,1 Q fiden 14.8. Parameter List of AT+CEER Table 13: Cause and Description List of AT+CEER on Cause C 0 Description No cause information available 1 Unassigned (unallocated) number 3 No route destination 6 Channel unacceptable 8 Operator determined barring 16 Normal call clearing WCDMA_UGxx_AT_Commands_Manual Confidential / Released 240 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 17 User busy 18 No user responding 19 User alerting, no answer 21 Call rejected 22 Number changed 26 Non selected user clearing 27 Destination out of order 28 29 30 31 34 38 41 42 43 44 47 49 50 55 Invalid number format (incomplete number) Facility rejected Response to STATUS ENQUIIRY l Normal, unspecified te No circuit /channel available c l Network out of order ue tia Temporaryfailure Switching equipment congestion Q n Access information discarded e Requested circuit/channel not available fid Resources unavailable, unspecified nQuality of service unavailable oRequested facility not subscribed C Incoming calls barred within the CUG 57 Bearer capability not authorized 58 Bearer capability not presently available 63 Service or option not available, unspecified 65 Bearer service not implemented 68 ACM equal to or greater than ACM max WCDMA_UGxx_AT_Commands_Manual Confidential / Released 241 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 69 Requested facility not implemented 70 Only restricted digital information bearer capability is available 79 Service or option not implemented, unspecified 81 Invalid transaction identifier value 87 user not member of CUG 88 Incompatible destination 91 Invalid transit network selection 95 96 97 98 99 100 101 102 103 106 107 111 112 113 Semantically incorrect message Invalid mandatory information Message type non-existent or not implemented l Message type not compatible with protocol state te Information element non-existent or not implemented c l Conditional IE error ue tia Message not compatible with protocol state Recovery on timer expiry Q n Illegal MS e Illegal ME fid GPRS service not allowed nprotocol error, unspecified oLocation area not allowed C Roaming not allowed in this location area 124 MBMS bearer capabilities insufficient for the service 125 LLC or SNDCP failure 126 Insufficient resources 127 Missing or unknown APN 128 Unknown PDP address or PDP type WCDMA_UGxx_AT_Commands_Manual Confidential / Released 242 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 129 User authentication failed 130 Activation rejected by GGSN 131 Activation reject, unspecified 132 Service not supported 133 Requested service option not subscribed 134 Service option temporarily out of order 135 NSAPI already used 136 137 138 139 140 141 142 143 144 145 146 148 149 212 Regular PDP context deactivation QoS not accepted Network failure l Reactivation requested te Feature not supported c l Semantic error in the TFT operation ue tia Syntactical error in the TFT operation Unknown PDP context Q n Semantic errors in packet filter(s) e Syntactical errors in packet filter(s) fid PDP context without TFT already activated nUnspecified GPRS error oPDP authentication error C APN restriction 256 Internal unspecified 257 Out of memory 258 Invalid parameters 259 Data call active 260 Speech call active WCDMA_UGxx_AT_Commands_Manual Confidential / Released 243 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 262 Missing ACM information 263 Temporary forbidden 264 Called party is blacklisted 265 Blacklist is full 266 No Service 267 Limited service 268 Client conflict 269 271 274 277 278 279 280 283 284 285 287 288 289 290 Dual Service call active Unknown SIM error Active Client is Gone l SIM status failure te Rejected by call control c l FDN failed ue tia BDNfailed CCBS possible Q n Invalid alternate service line e LND overview fid MM network failure unspecified nMM no service oMM access class barred C MM RR no resource 291 MM ME busy 292 MM unspecified 301 MMI not registered 303 Rejected by user 304 Rejected due to time out WCDMA_UGxx_AT_Commands_Manual Confidential / Released 244 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 306 Disconnected due to SIM TK call setup 307 Pending SIM TK call setup 310 SIM reset 340 MM sapi3 release 341 MM lower layer failure 342 MM authentication failure 343 MM PS reject 344 345 346 347 348 349 350 351 352 353 354 355 356 357 MM service rejected MM abort by network MM timeout l MM detach te MM RR connection release c l MM not registered ue tia MM reestablishment failure Failure due to handover Q n Link establishment failure e Random access failure fid Radio link aborted nLower layer failure in Layer 1 oImmediate Assignment Reject C Failure due to paging 358 Abnormal release unspecified 359 Abnormal release channel unacceptable 360 Abnormal release timer expired 361 Abnormal release no act on radio path 362 Preemptive release WCDMA_UGxx_AT_Commands_Manual Confidential / Released 245 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 363 UTRAN configuration unknown 364 Handover impossible 365 Channel mode unacceptable 366 Frequency not implemented 367 Originator leaving call group area 368 Lower layer failure from network 369 Call already cleared 370 371 372 373 374 375 376 377 378 379 380 381 382 383 Semantically incorrect message Invalid mandatory info Message type non existing l Message type incompatible in state te Conditional information element error c l No cell allocation available ue tia Protocol error unspecified Normal event Q n Unspecified e Preemptive release fid Congestion nRE establishment reject oDirected sig conn establishment C User inactivity 384 Lower layer failure downlink 385 Lower layer failure uplink 386 Cell barred due to authentication failure 387 Signaling connection release 388 CS connection release triggered by MM WCDMA_UGxx_AT_Commands_Manual Confidential / Released 246 / 247 UMTS/HSPA Module Series WCDMA UGxx AT Commands Manual 389 RRC connection establishment failure 390 RRC connection establishment reject with redirection 391 Resource conflict 392 Layer 2 sequence error 393 Layer 2 T200 exp N200 plus 1 times 394 Layer 2 unsolicited DM resp MFES 395 Layer 2 contention resolution 396 397 400 500 510 511 512 Layer 2 normal cause RR connection release due to BAND change (2G) MM RR connection error while release l 16 Normal call clearing cause te extension: user disconnected 16 Normal call clearing cause c l Extension: Remote user/NW disconnected for call status is rather than CALL PROCEEDING ue tia 16 Normal call clearing cause Extension: Remote user/NW disconnected for call status is CALL PROCEEDING CQonfiden Request rejected, BCM violation WCDMA_UGxx_AT_Commands_Manual Confidential / Released 247 / 247

BC25 系列 AT 命令手册 NB-IoT 模块系列 版本：1.1 日期：2022-01-04 状态：受控文件 BC25 系列 AT 命令手册 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 105 BC25 系列 AT 命令手册 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 105 BC25 系列 AT 命令手册 文档历史 修订记录 版本 1.0 1.1 日期 作者 变更表述 2019-11-08 2022-01-04 Fonda FANG/ Luois GU/ Claire ZHANG Albert ZHANG/ Theo QIN 初始版本 1. 更新部分命令特性说明。 2. 新增以下命令： ⚫ AT+QICSGP 命令（第 5.9 章）； ⚫ AT+CSODCP 命令（第 5.25 章）； ⚫ AT+QCCLK 命令（第 6.6 章）。 3. AT+QEAUART 命令已支持，删除星号；更新 和参数（第 3.2 章）。 4. AT+QCGDEFCONT 命令新增支持, 和参数（第 5.5 章）。 5. 更新 AT+QENG 命令、、 、和参数说明（第 5.17 章）。 6. 更新 AT+QCFG 命令说明（第 5.20 章）。 7. 更新 AT+CCIOTOPT 命令和 参数值说明（第 5.21 章）。 8. 更新 AT+CFUN 命令最大响应时间（第 6.1 章）。 9. 更新 AT+QPOWD 命令参数说明（第 6.4 章）。 10. 更新 TCP/IP 相关命令列表（第 7 章）。 11. 更新中国电信物联网平台相关命令列表（第 10 章）。 上海移远通信技术股份有限公司 3 / 105 BC25 系列 AT 命令手册 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 1.1. 定义 ............................................................................................................................................ 8 1.2. AT 命令语句............................................................................................................................... 8 1.3. AT 命令响应............................................................................................................................... 9 1.4. AT 示例声明.............................................................................................................................. 10 1.5. 3GPP 命令................................................................................................................................ 10 1.6. 特殊符号 ................................................................................................................................... 10 2 通用命令 .............................................................................................................................................. 11 2.1. ATI 显示产品标识信息 ............................................................................................................11 2.2. ATE 设置命令的回显模式 ...................................................................................................... 12 2.3. AT&W 储存当前参数到用户定义的配置文件 ......................................................................... 13 2.4. AT+CGMI 请求制造商标识 .................................................................................................... 13 2.5. AT+CGMM 请求模块标识 ...................................................................................................... 14 2.6. AT+CGMR 请求制造商版本号 ............................................................................................... 15 2.7. AT+CGSN 请求产品序列号 ................................................................................................... 16 2.8. AT+CMEE 设置错误码上报 ................................................................................................... 18 3 串行接口控制命令 ............................................................................................................................... 20 3.1. AT+IPR 设置 TE-TA 固定的本地波特率................................................................................. 20 3.2. AT+QEAUART 设置双串口功能 ............................................................................................ 21 4 (U)SIM 卡相关命令.............................................................................................................................. 24 4.1. AT+CPIN 输入 PIN 码............................................................................................................ 24 4.2. AT+CIMI 查询国际移动用户识别码........................................................................................ 25 4.3. AT+QCCID USIM 卡识别....................................................................................................... 26 5 网络服务命令....................................................................................................................................... 28 5.1. AT+CSQ 上报信号质量.......................................................................................................... 28 5.2. AT+CESQ 扩展信号质量 ....................................................................................................... 29 5.3. AT+CEREG EPS 网络注册状态 ............................................................................................ 31 5.4. AT+CGATT PS 附着与去附着................................................................................................ 34 5.5. AT+QCGDEFCONT 设置初始 PDP 上下文........................................................................... 36 5.6. AT+CGDCONT 定义 PDP 上下文 ......................................................................................... 38 5.7. AT+CGACT 激活或停用 PDP 上下文 .................................................................................... 40 5.8. AT+CGPADDR 显示 PDP 地址.............................................................................................. 42 5.9. AT+QICSGP 配置 PDP 上下文.............................................................................................. 44 5.10. AT+CSCON 信令连接状态 .................................................................................................... 46 5.11. AT+COPS 运营商选择........................................................................................................... 47 5.12. AT+CPSMS 省电模式设置 .................................................................................................... 50 上海移远通信技术股份有限公司 4 / 105 BC25 系列 AT 命令手册 5.13. AT+CEDRXS eDRX 设置 ...................................................................................................... 52 5.14. AT+CEDRXRDP 查询动态 eDRX 参数.................................................................................. 55 5.15. AT+QBAND 获取和设置工作频段.......................................................................................... 57 5.16. AT+QLOCKF 锁定 NB-IoT EARFCN..................................................................................... 58 5.17. AT+QENG 查询工程模式....................................................................................................... 60 5.18. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 .......................................................... 63 5.19. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表......................................................... 64 5.20. AT+QCFG 扩展配置设置 ....................................................................................................... 65 5.21. AT+CCIOTOPT CloT 优化配置 ............................................................................................. 66 5.22. AT+CTZR 上报时区 ............................................................................................................... 68 5.23. AT+CGAPNRC 查询 APN 速率控制参数............................................................................... 70 5.24. AT+QSPCHSC 设置加扰算法 ............................................................................................... 71 5.25. AT+CSODCP 通过控制面发送始端数据................................................................................ 72 6 硬件相关命令....................................................................................................................................... 75 6.1. AT+CFUN 设置 UE 功能........................................................................................................ 75 6.2. AT+QSCLK 设置睡眠模式 ..................................................................................................... 76 6.3. AT+QRST 重启模块............................................................................................................... 78 6.4. AT+QPOWD 模块关机........................................................................................................... 78 6.5. AT+CCLK 查询和设置当前日期和时间 .................................................................................. 79 6.6. AT+QCCLK 查询和设置 UTC 时间和时区 ............................................................................. 81 6.7. AT+CBC 查询电源电压值 ...................................................................................................... 82 6.8. AT+QATWAKEUP 启用/禁用深睡眠唤醒指示 ....................................................................... 83 6.9. AT+QLEDMODE 配置网络指示灯 ......................................................................................... 84 6.10. AT+QADC 读取 ADC............................................................................................................... 86 7 TCP/IP 相关命令 ................................................................................................................................. 87 8 OneNET 相关命令............................................................................................................................... 88 9 CMDMP 相关命令 ............................................................................................................................... 89 10 中国电信物联网平台相关命令 ............................................................................................................. 90 11 DFOTA 相关命令 ................................................................................................................................ 91 12 MQTT 相关命令................................................................................................................................... 92 13 FILE 相关命令 ..................................................................................................................................... 93 14 举例 ..................................................................................................................................................... 94 14.1. 网络附着 ................................................................................................................................... 94 14.1.1. 手动查询网络附着状态 .................................................................................................. 94 14.1.2. 通过 URC 上报自动附着网络状态 ................................................................................. 95 14.1.3. 通过指定的 PLMN 附着网络.......................................................................................... 96 14.1.4. 通过指定的 EARFCN/PCI 附着网络.............................................................................. 98 14.1.5. 通过指定的频段附着网络 .............................................................................................. 99 15 错误码 ............................................................................................................................................... 100 上海移远通信技术股份有限公司 5 / 105 BC25 系列 AT 命令手册 16 附录 ................................................................................................................................................... 103 上海移远通信技术股份有限公司 6 / 105 BC25 系列 AT 命令手册 表格索引 表 1：AT 命令类型........................................................................................................................................ 9 表 2：特殊符号 ........................................................................................................................................... 10 表 3：TCP/IP 相关命令 .............................................................................................................................. 87 表 4：OneNET 相关命令............................................................................................................................ 88 表 5：CMDMP 相关命令 ............................................................................................................................ 89 表 6：中国电信物联网平台相关命令 .......................................................................................................... 90 表 7：DFOTA 相关命令 .............................................................................................................................. 91 表 8：MQTT 相关命令................................................................................................................................ 92 表 9：FILE 相关命令 .................................................................................................................................. 93 表 10：错误代码列表................................................................................................................................ 100 表 11：指定错误代码列表......................................................................................................................... 101 表 12：参考文档 ....................................................................................................................................... 103 表 13：术语和缩写 ................................................................................................................................... 103 上海移远通信技术股份有限公司 7 / 105 BC25 系列 AT 命令手册 1 引言 本文档详细介绍了移远通信 BC25 系列模块支持的 AT 命令集。 模块默认支持的波特率为 9600 bps。当模块上电后，可以通过 MCU 发送命令 AT+IPR= 配置 通信波特率，该设置将被自动保存至 NVM 中。 1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 BC25 系列模块实现的 AT 命令可以在语法上分为两类：基础类和扩展类，如下所列。 ⚫ 基础类 基础类 AT 命令的格式为 AT 或 AT&，其中 是命令， 是该命令的参数。 以 ATE 为例，DCE 会根据 的取值确定是否将接收到的字符回显给 DTE。若 为可 选参数，则其被省略时将使用其默认值。 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 上海移远通信技术股份有限公司 8 / 105 BC25 系列 AT 命令手册 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 可以用分号（;）将多个命令放在同一行。此时只有第一个命令带有 AT 前缀。命令可以是大写或小写。 输入 AT 命令时，可以忽略空格。但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内； ⚫ 在 AT 命令名称中的 =、? 或 =? 内。 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.3. AT 命令响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或 +CME ERROR: ，表示已经准备 好接收新命令。在返回最终的 OK，ERROR 或 +CME ERROR: 之前，会发送请求的响应消息。 以下是响应消息的格式： +CMD1: OK 或者 OK 上海移远通信技术股份有限公司 9 / 105 BC25 系列 AT 命令手册 1.4. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 1.5. 3GPP 命令 3GPP 命令遵从 3GPP TS 27.007、3GPP TS 27.005 和 ITU V.250。 1.6. 特殊符号 表 2：特殊符号 符号 * 定义 若无特别说明，模块功能、特性、接口、引脚名称、AT 命令或参数后所标记的星号（*）表 示该功能、特性、接口、引脚、AT 命令或参数正在开发中，因此暂不支持；模块子型号后所 标记的星号（*）表示该子型号暂无样品。 上海移远通信技术股份有限公司 10 / 105 BC25 系列 AT 命令手册 2 通用命令 2.1. ATI 显示产品标识信息 该命令用于返回产品标志信息。 ATI 显示产品标识信息 执行命令 ATI 最大响应时间 特性说明 响应 Quectel_Ltd Revision: OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。设备类型标识。 字符串类型。当前软件版本号。 错误码。参见第 15 章。 举例 ATI Quectel_Ltd Quectel_BC25 Revision: BC25PAR01A01 上海移远通信技术股份有限公司 11 / 105 BC25 系列 AT 命令手册 OK 2.2. ATE 设置命令的回显模式 该命令用于设置是否从外接 MCU 接收 UE 回显字符。 ATE 设置命令的回显模式 执行命令 ATE 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒有效； 参数配置保存到 NVRAM（需先执行 AT&W 保存配置） 参数 整型。回显模式设置。 0 关闭回显模式 1 开启回显模式 错误码。参见第 15 章。 举例 ATE0 OK ATI Quectel_Ltd Quectel_BC25 Revision: BC25PAR01A01 OK ATE1 OK ATI ATI 上海移远通信技术股份有限公司 12 / 105 Quectel _Ltd Quectel_BC25 Revision: BC25PAR01A01 OK 2.3. AT&W 储存当前参数到用户定义的配置文件 该命令将当前参数设置存储到 NVM 中的用户定义的配置文件中。 AT&W 储存当前参数到用户定义的配置文件 执行命令 响应 AT&W[] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效 参数 整型。 0 用于储存当前参数的配置文件编号 错误码。参见第 15 章。 2.4. AT+CGMI 请求制造商标识 该命令可返回制造商信息。 AT+CGMI 请求制造商标识 测试命令 AT+CGMI=? 响应 OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 BC25 系列 AT 命令手册 13 / 105 执行命令 AT+CGMI 最大响应时间 特性说明 +CME ERROR: 响应 Quectel_Ltd Revision: RDA_8908A OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。设备类型标识。 错误码。参见第 15 章。 举例 AT+CGMI Quectel_Ltd Quectel_BC25 Revision: RDA_8908A OK 2.5. AT+CGMM 请求模块标识 该命令可返回模块信息。 AT+CGMM 请求模块标识 测试命令 AT+CGMM=? 响应 OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 BC25 系列 AT 命令手册 14 / 105 执行命令 AT+CGMM 最大响应时间 特性说明 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。设备类型标识。 错误码。参见第 15 章。 举例 AT+CGMM Quectel_BC25 OK BC25 系列 AT 命令手册 2.6. AT+CGMR 请求制造商版本号 该命令返回制造商版本号。该文本是可读的，不适用于微控制器解析。默认返回固件版本号。 执行命令返回一行或多行信息文本 。 AT+CGMR 请求制造商版本号 测试命令 AT+CGMR=? 响应 OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 15 / 105 执行命令 AT+CGMR 最大响应时间 特性说明 +CME ERROR: 响应 Revision: OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。当前软件版本号。 错误码。参见第 15 章。 举例 AT+CGMR Revision: BC25PAR01A01 OK BC25 系列 AT 命令手册 2.7. AT+CGSN 请求产品序列号 该命令返回 IMEI 号及相关信息。对于不支持 的 TA，仅返回 OK。 AT+CGSN 请求产品序列号 测试命令 AT+CGSN=? 响应 TE 支持 且命令执行成功时： +CGSN: (支持的列表) OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 16 / 105 设置命令 AT+CGSN= 执行命令 AT+CGSN 最大响应时间 特性说明 +CME ERROR: 响应 当 =0 时： OK 当 =1 时： +CGSN: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / BC25 系列 AT 命令手册 参数 整型。被请求的序列号类型。 0 返回 128 位 UUID 1 返回 IMEI 号 UE 的 128 位 UUID。信息文本（包括行终止符在内）的字符总数不应超过 37 个字符， 且不包含 0 或 OK 序列。 不带双引号的十进制格式的字符串类型。IMEI 号。 错误码。参见第 15 章。 举例 AT+CGSN=1 //请求 IMEI 号 上海移远通信技术股份有限公司 17 / 105 +CGSN: 490154203237511 OK BC25 系列 AT 命令手册 2.8. AT+CMEE 设置错误码上报 设置命令可以关闭或启用最终结果码 +CME ERROR: ，用于表示 MT 功能相关的错误。启用后， 发生错误时，模块会上报 +CME ERROR: ，而不仅仅是响应 ERROR。当发生语法、无效参数或 TA 功能相关错误时，仅仅会响应 ERROR。 查询命令返回参数的当前设置值。 AT+CMEE 设置错误码上报 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) OK 查询命令 AT+CMEE? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMEE: OK 设置命令 AT+CMEE= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 TA 禁用或使能最终结果码 +CME ERROR: ，用于表示 相关的错误。 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 18 / 105 BC25 系列 AT 命令手册 特性说明 该命令立即生效；深睡眠唤醒有效；参数配置自动保存至 NVRAM（需先执行 AT&W 保存配置） 参数 整型。表示错误模式。 0 禁用结果码 1 启用结果码，结果码为数值格式 2 启用结果码，结果码为详细错误信息 错误码。参见第 15 章。 举例 AT+CMEE? +CMEE: 0 OK AT+CMEE=? +CMEE: (0-2) OK 上海移远通信技术股份有限公司 19 / 105 BC25 系列 AT 命令手册 3 串行接口控制命令 3.1. AT+IPR 设置 TE-TA 固定的本地波特率 AT+IPR 设置 TE-TA 固定的本地波特率 测试命令 AT+IPR=? 响应 +IPR: (支持的列表) OK 查询命令 AT+IPR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +IPR: OK 设置命令 AT+IPR= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒后有效； 参数配置自动保存至 NVRAM 上海移远通信技术股份有限公司 20 / 105 参数 每秒波特率。 2400 4800 9600 14400 19200 28800 33600 38400 57600 错误码。参见第 15 章。 备注 该设置将应用于同一个 UART 连接级别路由的所有信道。 举例 AT+IPR=9600 OK AT+IPR? +IPR: 9600 //设置固定的波特率为 9600bps. OK AT+IPR=? +IPR: (2400,4800,9600,14400,19200,28800,33600,38400,57600) OK BC25 系列 AT 命令手册 3.2. AT+QEAUART 设置双串口功能 此命令用于开启或关闭双串口功能。开启双串口功能后，可同时使用主串口和辅助串口。 AT+QEAUART 设置双串口功能 测试命令 AT+QEAUART=? 响应 +QEAUART: (支持的列表),(支持的列 表),(支持的列表),(支持的列表),(支持的 范围) 上海移远通信技术股份有限公司 21 / 105 BC25 系列 AT 命令手册 OK 查询命令 AT+QEAUART? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QEAUART: ,,,, OK 设置命令 AT+QEAUART=[,[ [,[,[,]]]]] 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM（需先执行 AT&W 保存配置） 参数 整型。开启/关闭双串口功能。 0 关闭双串口功能 1 开启双串口功能 整型。波特率。 2400 4800 9600 14400 19200 28800 33600 38400 上海移远通信技术股份有限公司 22 / 105 BC25 系列 AT 命令手册 57600 数据位。 7 8 停止位。 1 2 校验位。 0 None 1 Odd 2 Even 3 Mark 错误码。参见第 15 章。 备注 辅助串口不接收 URC，不能使用各类协议的数据传输和文件上传/下载相关命令，例如 TCP、FTP、HTTP、 SMTP、PPP 和 FILE 等协议。 上海移远通信技术股份有限公司 23 / 105 BC25 系列 AT 命令手册 4 (U)SIM 卡相关命令 4.1. AT+CPIN 输入 PIN 码 AT+CPIN 输入 PIN 码 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 设置命令 AT+CPIN=[,] 最大响应时间 特性说明 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 TA 返回一个字母数字字符串，表示是否需要密码： +CPIN: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效 上海移远通信技术股份有限公司 24 / 105 参数 BC25 系列 AT 命令手册 READY 无需进一步输入 SIM PIN MT 正在等待 USIM PIN 码 SIM PUK MT 正在等待 USIM PUK 码 PH_SP PIN 需要服务提供商个性化密码 SIM PIN2 MT 正在等待提供 USIM PIN 2 码。仅在前条命令返回 +CME ERROR: 17 时有效 SIM PUK2 MT 正 在 等 待 提 供 USIM PUK 2 码 。 仅 在 前 条 命 令 返 回 +CME ERROR: 18 时有效 NO SIM SIM 卡未插入 字符串类型。PIN 码。 字符串类型。指定 SIM PUK 或 SIM PUK2，必须输入 以替换 SIM 中的旧 PIN 。 错误码。参见第 15 章。 举例 AT+CPIN? +CPIN: READY OK 4.2. AT+CIMI 查询国际移动用户识别码 此命令返回国际移动用户识别码（无双引号的字符串）。 该执行命令使 TA 返回 ，目的是允许 TE 识别附着到 MT 的 UICC（USIM）中的单独 USIM 卡 或活动应用。 AT+CIMI 查询国际移动用户识别码 测试命令 响应 AT+CIMI=? OK 执行命令 AT+CIMI 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 25 / 105 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: / 参数 国际移动用户识别码（无双引号的字符串）。 错误码。参见第 15 章。 举例 AT+CIMI 460001357924680 OK BC25 系列 AT 命令手册 4.3. AT+QCCID USIM 卡识别 该命令用于读取 USIM 卡的 ICCID。如果没有 USIM 卡，或者 USIM 卡不可读，则不返回任何数据。 AT+QICCID USIM 卡识别 执行命令 AT+QCCID 响应 +QCCID: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 26 / 105 参数 USIM 卡识别号。 错误码。参见第 15 章。 举例 AT+QCCID +QCCID: 89860317482035195410 OK BC25 系列 AT 命令手册 上海移远通信技术股份有限公司 27 / 105 BC25 系列 AT 命令手册 5 网络服务命令 5.1. AT+CSQ 上报信号质量 执行命令用于从 MT 返回接收信号强度指示 和信道误码率 。 测试命令返回参数支持的值的范围。 AT+CSQ 上报信号质量 测试命令 AT+CSQ=? 响应 +CSQ: (支持的列表),(支持的列表) OK 执行命令 AT+CSQ 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSQ: , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。接收信号强度等级。 0 等于或小于-113dBm 1 -111dBm 上海移远通信技术股份有限公司 28 / 105 BC25 系列 AT 命令手册 * 2…30 -109dBm... -53dBm 31 大于或等于-51dBm 99 未知或无法检测 整型。信道误码率（百分比）。 0...7 用作 RxQual 值（RXQUAL_0…RXQUAL_7 定义请参考 3GPP TS 45.008） 99 未知或无法检测 错误码。参见第 15 章。 举例 AT+CSQ +CSQ: 22,99 OK 5.2. AT+CESQ 扩展信号质量 执行命令返回接收信号质量参数。 终端将提供 0 到 99 的信号强度指示，通常数值越大强度越高。该数值基于单次测量，因此在短期内可 以发生较大变化。 AT+CESQ 扩展信号质量 测试命令 AT+CESQ=? 响应 +CESQ: (支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的 列表) OK 执行命令 AT+CESQ 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CESQ: ,,,,, OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 29 / 105 最大响应时间 特性说明 +CME ERROR: 300 毫秒 / BC25 系列 AT 命令手册 参数 1) 1) 整型。接收到信号强度等级。 0 < -110dBm 1 -110dBm ≤ < -109dBm 2 -109dBm ≤ < -108dBm … 61 -50dBm ≤ < -49dBm 62 -49dBm ≤ < -48dBm 63 -48dBm ≤ 99 未知或者不可检测 整型。信道位误码率（百分比）。 0…7 用作 RxQual 值（RXQUAL_0…RXQUAL_7 定义请参考 3GPP TS 45.008） 99 未知或者不可检测 整型。接收信号码功率（请参考 3GPP 25.133 和 3GPP 25.123）。 0 -120 dBm 或者更低 1 -120 dBm ≤ < -119 dBm 2 -119 dBm ≤ < -118 dBm … 94 -27 dBm ≤ < -26 dBm 95 -26 dBm ≤ < -25 dBm 96 -25 dBm ≤ 255 未知或者不可检测 整型。Ec/No（请参考 3GPP 25.133）。 0 -24 dBm 或者更低 1 -24dBm ≤ < -23.5 dBm 2 -23.5dBm ≤ < -23 dBm … 47 -1dBm ≤ < -0.5 dBm 48 -0.5dBm ≤ < 0 dBm 49 0 dBm ≤ 255 未知或者不可检测 整型。参考信号接收质量（请参考 3GPP 36.133）。 0 -19.5dB 或者更低 1 -19.5dB ≤ < -19dB 2 -19dB ≤ < -18.5dB … 32 -4dB ≤ < -3.5dB 上海移远通信技术股份有限公司 30 / 105 BC25 系列 AT 命令手册 33 -3.5dB ≤ < -3dB 34 -3dB ≤ 255 未知或者不可检测 整型。参考信号接收功率（请参考 3GPP 36.133）。 0 -140 dBm 或者更低 1 -140dBm ≤ < -139 dBm 2 -139dBm ≤ < -138 dBm … 95 -46dBm ≤ < -45 dBm 96 -45dBm ≤ < -44 dBm 97 -44dBm ≤ 255 未知或者不可检测 错误码。参见第 15 章。 举例 AT+CESQ +CESQ: 51,99,255,255,20,65 OK 备注 1) 和 参数目前不适用于 BC25 系列模块，所以两者的值为 255（未知或者不可检测）。 5.3. AT+CEREG EPS 网络注册状态 设置命令用于设置 EPS 网络注册状态 URC 的显示：=1 设置在 E-UTRAN 中 UE 的 EPS 网络注册 状态发生改变时的 URC +CEREG: 的显示；=2 设置在 E-UTRAN 中的网络小区发生改变时的 URC +CEREG: [,[],[],[]] 的显示。参数、和只有在可用时才会上 报。在=2 的基础上，如果可用，=3 设置当的值改变时在 URC 显示更多参数 和。 =4 设置当 UE 请求 PSM 减少其功率消耗时的 URC +CEREG: [,[],[],[][,[< cause_type>],[][,[],[]]]]的显示。 当=4 时，如果 E-UTRAN 的小区发生改变，URC 将向 UE 提供附加的 active-time 值及扩展周期性 TAU 值信息。当=5 时，如果 的值发生改变，URC 将会比=4 时多上报和 参数。 参数、、、、、与 上海移远通信技术股份有限公司 31 / 105 BC25 系列 AT 命令手册 只有在可用时才会上报。 查询命令返回结果代码呈现的状态和整型参数，其指示了 UE 是否已经注册当前网络。如果位置 信息参数、与可用，可在=2、3、4 或 5，且 UE 已注册网络时上报。如果参数 [,,]可用，当=3 或 5 时返回。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 响应 +CEREG: (支持的范围) OK 查询命令 AT+CEREG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当 =0、1、2 或 3 时： +CEREG: ,[,[],[],[[,, ]]] 当 =4 或 5 时： +CEREG: ,[,[],[],[][,[],[][,[],[]]]] OK 设置命令 AT+CEREG= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM（需先执行 AT&W 保存配置） 上海移远通信技术股份有限公司 32 / 105 BC25 系列 AT 命令手册 参数 整型。 0 禁用网络注册 URC 1 使能网络注册 URC +CEREG: 2 使能网络注册与位置信息 URC +CEREG: [,[],[],[]] 3 使能网络注册、位置信息和 EMM 原因值 URC： +CEREG: [,[],[],[][,,]] 4 对于请求 PSM 的 UE，使能网络注册和位置信息 URC： +CEREG: [,[],[],[][,,[,[],[]]]] 5 对于请求 PSM 的 UE，使能网络注册、位置信息和 EMM 原因值 URC： +CEREG: [,[],[],[][,[],[][, [],[]]]] 整型。表示 EPS 注册状态。 0 未注册，UE 目前未搜索运营商进行注册 1 已注册，本地网络 2 未注册，但 UE 目前正在连接或搜索运营商进行注册 3 注册被拒绝 4 未知（例如，不在 E-UTRAN 范围内） 5 已注册，漫游网络 字符串类型。十六进制 2 字节跟踪区域代码（例如'00C3'等于十进制的 195）。 字符串类型。十六进制 4 个字节的 E-UTRAN 小区 ID。 整型。表示服务小区的接入技术。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 整型。类型。 0 包含一个 EMM 原因值（请参考 3GPP TS 24.008 Annex G） 1 包含一个特定制造商的原因值 整型。包含注册失败的原因。该参数的类型由 定义。 字符串类型。8 位格式的 1 字节参数。表示在 E-UTRAN 中分配给 UE 的 Active-time 值 （T3324）。Active-time 值编码为 GPRS Timer 2 信息元素的 1 个字符（octet 3），编码 为位格式（例如'00100100'等于 4 分钟）。 关于编码及取值范围，请参考 3GPP TS 24.008 Table 10.5.163/3Gpp TS 24.008 中的 GPRS Timer 2 IE，也可在协议 3GPP TS 23.682 和 3GPP TS 23.401 中查看。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器的值单位，定义如下： 位数 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 该值表示定时器被停用 字符串类型。8 位格式的 1 字节参数。表示在 E-UTRAN 中分配给 UE 的扩展周期性 TAU 上海移远通信技术股份有限公司 33 / 105 BC25 系列 AT 命令手册 值（T3412）。扩展的周期 TAU 值，编码为 GPRS Timer 3 信息元素的 1 个字节（octet 3），编码为位格式（例如'01000111'等于 70 小时）。 关于编码及取值范围，请参考 3GPP TS 24.008 Table 10.5.163a/3GPP TS 24.008 中的 GPRS Timers 3 IE，也可在协议 3GPP TS 23.682 和 3GPP TS 23.401 中查看。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器的值单位，定义如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增 1 1 1 该值表示定时器被停用 错误码。参见第 15 章。 举例 AT+CEREG=1 OK AT+CEREG? +CEREG: 1,1 OK AT+CEREG=? +CEREG: (0-5) OK //使能网络注册 URC。 5.4. AT+CGATT PS 附着与去附着 该命令用于将 MT 附着于 PS 域或将 MT 从 PS 域去附着。命令执行后，MT 保持在 V.250 命令状态。 如果 MT 已经处于请求状态，则会忽略命令，并响应 OK。如果未实现请求状态，则会返回 ERROR 或+CME ERROR 响应。 当附着状态变为去附着状态时，任何已激活 PDP 上下文将自动停用。 查询命令返回当前 PS 域附着状态。 上海移远通信技术股份有限公司 34 / 105 BC25 系列 AT 命令手册 AT+CGATT PS 附着与去附着 测试命令 AT+CGATT=? 查询命令 AT+CGATT? 设置命令 AT+CGATT= 最大响应时间 特性说明 响应 +CGATT: (支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGATT: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 75 秒，由网络判定。 该命令立即生效 参数 整型。表示 PDP 上下文激活的状态。 0 去附着 1 附着 错误码。参见第 15 章。 备注 1. 如果支持初始 PDP 上下文，则在模块启动时，会自动定义=1 的上下文。 2. 如果在 AT+CGATT 命令处理完成前，执行新的 AT+CGATT 命令，将返回错误。 3. 执行 AT+CGATT=0 去附着后，模块仍然会自动附着网络。 上海移远通信技术股份有限公司 35 / 105 举例 AT+CGATT? +CGATT: 0 OK AT+CGATT=1 OK AT+CGATT=? +CGATT: (0,1) OK BC25 系列 AT 命令手册 5.5. AT+QCGDEFCONT 设置初始 PDP 上下文 该命令用于配置模块初始 PDP 上下文。模块上电并附着 NB-IoT 网络时，会建立一路默认的 PDN 连接。 因此，默认的 PDN 连接设置必须保存在 NVM 中，以便 Modem 可以在附着流程中使用所述 PDN 连接设置。 AT+QCGDEFCONT 设置初始 PDP 上下文 测试命令 AT+QCGDEFCONT=? 响应 +QCGDEFCONT: ( 支 持 的 列 表 )[,][,[,[,( 支 持 的 列表)]]]] OK 查询命令 AT+QCGDEFCONT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QCGDEFCONT: [,[,,,]] OK 设置命令 AT+QCGDEFCONT=[,<A 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 36 / 105 BC25 系列 AT 命令手册 PN>[,,,]] 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令重启后生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。 参数 字符串类型。指定分组数据协议。 IP 互联网协议（IETF STD 5） IPV6 互联网协议版本 6（IETF RFC 2460） IPV4V6 双栈，UE 能力（参见 3GPP TS 24.301） Non-IP 无 IP 数据到外部分组网络的传输（参见 3GPP TS 24.301） 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。如果值为空或省略， 则将请求订阅值。 字符串类型。用户名。最大长度为 36 个字节。 字符串类型。用户密码。最大长度为 36 个字节。 整型。鉴权方式。 0 NONE 1 PAP 2 CHAP 3 CHAP or PAP 错误码。参见第 15 章。 举例 AT+QCGDEFCONT='IPV4V6' OK AT+QCGDEFCONT? +QCGDEFCONT: 'IPV4V6' OK 备注 1. 该命令专用于配置=1 的初始 PDP 上下文。 2. 当设置为 3 时，默认使用 CHAP 加密。CHAP 加密失败时，将使用 PAP 加密（协 议认证失败后网络侧返回的拒绝码值应为 29，否则认证方式不会切换到 PAP）。 上海移远通信技术股份有限公司 37 / 105 BC25 系列 AT 命令手册 5.6. AT+CGDCONT 定义 PDP 上下文 设置命令用来指定上下文指示参数对应的 PDP 上下文和本地上下文的 PDP 上下文参数。因为 PCO 可包含需要加密的信息，所以该命令也允许 TE 指定是否请求 ESM 信息的安全保护传输。可能有其他 原因需要 UE 使用 ESM 信息的安全保护传输，例如，当 UE 需要转换 APN 时。测试命令返回值的范围给 出了可以同时处于定义状态的 PDP 上下文数量。 对 EPS 而言，设置该命令后会建立 PDN 连接并建立相关的默认承载，参数应该省略。 不携带任何可选参数的 AT+CGDCONT=是此设置命令的一种特殊形式，会直接删除对应 的 PDP 上下文，使其变成未定义。 查询命令返回每个已定义上下文的当前设置。 默认情况下，=1 的上下文在启动时定义，不需要使用 AT+CGDCONT 命令设置。初始 PDP 上 下文具有制造商特定的默认设置，与 AT+CGDCONT 命令参数的任何默认值无关无关。模块在 E-UTRAN 网络中成功注册之后，会自动激活初始 PDP 上下文。如果停用所有已激活的上下文，则可以（重新）建立 初始 PDP 上下文。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT: (支持的范围),[(支持的列表) [,,,[(支持的范围)[,(支持的范围)]]]] OK 查询命令 AT+CGDCONT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGDCONT: ,,,,, [+CGDCONT: ,,,,,] [...] OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 38 / 105 BC25 系列 AT 命令手册 设置命令 AT+CGDCONT=,[[,< APN>[,[,[,]]]]] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置不保存至 NVRAM。 参数 整型。指示一个 PDP 上下文的标识符。UE-TE 接口的本地参数，可以用在其他 PDP 上 下文相关的命令中。范围：1~7。 字符串类型。分组数据协议类型。 IP 互联网协议（IETF STD 5） IPV6 互联网协议版本 6 IPV4V6 引入虚拟 处理 IP 双栈 UE 功能 Non-IP 无 IP 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。值为空或值省略时，将 请求订阅值。 字符串类型。用于标识适用于 PDP 的地址空间中的 UE。如果该值为空或被省略，则 TE 在 PDP 启动过程期间时提供该值，否则，将请求动态地址。即使在 PDP 启动过程中已 经分配了地址，查询命令中此值的返回值将仍然是空字符串。可以使用 AT+CGPADDR 命令读取分配的地址。 整型。控制 PDP 数据的压缩。 0 关闭 1 开启 2 V.42bis 3 V.44bis 整型。控制 PDP 头的压缩。 0 关闭 1 开启 2 RFC 1144（仅适用于 SNDCP） 3 RFC 2507 4 RFC 3095[ROHC]（仅适用于 PDCP） 错误码。参见第 15 章。 上海移远通信技术股份有限公司 39 / 105 BC25 系列 AT 命令手册 备注 1. AT+CGDCONT=，用于清除此命令配置的 PDP 上下文。 2. 已被配置激活的无法被清除或配置。 3. =1 对应的为默认的 PDP 上下文，无法通过命令 AT+CGDCONT 进行配置或清除，但可以通过 命令 AT+QCGDEFCONT 进行配置。 举例 AT+CGDCONT=? +CGDCONT: (1-7)[,('IP','IPV6','IPV4V6','Non-IP')[,,,[(0-3)[,(0-4)]]]] OK AT+CGDCONT=2,'IP','CMNBIOT' OK AT+CGDCONT? +CGDCONT: 1,'IP','CMNBIOT','0.0.0.0',0,0 +CGDCONT: 2,'IP','CMNBIOT','0.0.0.0',0,0 OK 5.7. AT+CGACT 激活或停用 PDP 上下文 该命令用于激活或停用指定的 PDP 上下文。该命令设置完成后，MT 保持在 V.250 命令状态。若任意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；如果不能实现任意上下文的请求状态，将返 回 ERROR 或+CME ERROR 响应。 当激活形式的命令执行时，如果 UE 没有附着 PS，首先会附着 PS，然后尝试激活指定的上下文。如 果附着失败，则会响应错误。 请注意以下 3GPP TS 27.007 中的声明。 对于 EPS，如果尝试断开上一条 PDN 连接，UE 将响应 ERROR，或者如果使能了扩展错误响应，则 响应+CME ERROR。 EPS 承载资源激活请求由网络通过 EPS 专用承载激活请求或者 EPS 承载修改请求来响应。必须在 UE 接受此请求之后 PDP 上下文方可设置为建立状态。 如未指定，该命令的激活形式将激活所有定义的 non-emergency 上下文，去激活格式将停用所 有已激活的 PDP 上下文。 查询命令返回所有定义的 PDP 上下文的当前激活状态。 上海移远通信技术股份有限公司 40 / 105 BC25 系列 AT 命令手册 AT+CGACT 激活或停用 PDP 上下文 测试命令 AT+CGACT=? 响应 +CGACT: (支持的列表) OK 查询命令 AT+CGACT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGACT: , [+CGACT: ,] [...] OK 设置命令 AT+CGACT=[,[,[,...] ]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 150 秒，由网络判定。 特性说明 该命令立即生效 参数 整型。PDP 上下文的激活状态。 0 去激活（停用） 1 激活 整型。指示一个 PDP 上下文的标识符（请查看 AT+CGDCONT）。 错误码。参见第 15 章。 上海移远通信技术股份有限公司 41 / 105 BC25 系列 AT 命令手册 备注 1. 模块启动时会自动使用 AT+QCGDEFCONT 命令配置的参数初始化=1 的上下文。 2. 不可停用最后激活的一路 PDP 上下文。 3. 当前，仅允许两路已激活的 PDP 上下文同时存在。 4. 激活 PDP 上下文前，需通过命令 AT+CGATT?查询确保模块已经附着网络。 举例 AT+CGACT=1,1 OK AT+CGACT? +CGACT: 1,1 OK AT+CGACT=? +CGACT: (0,1) OK 5.8. AT+CGPADDR 显示 PDP 地址 该命令返回设备的 IP 地址。 执行命令返回指定上下文标识符的 PDP 地址清单。如果没有指定，则返回所有已定义上下文的 地址。 测试命令返回已定义的列表。这些已被激活，可能有也可能没有与之关联的 IP 地址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (已激活 PDP 上下文) OK 查询命令 AT+CGPADDR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGPADDR: [,[,]] [+CGPADDR: [,[,]]] 上海移远通信技术股份有限公司 42 / 105 设置命令 AT+CGPADDR=[,[,...]] 执行命令 AT+CGPADDR 最大响应时间 特性说明 BC25 系列 AT 命令手册 [...] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+CGPADDR: [,[,]]] [+CGPADDR: [,[,]]] [...] OK 若出现任何错误： ERROR 或 +CME ERROR: 响应 [+CGPADDR: [,[,]]] [+CGPADDR: [,[,]]] [...] OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效 参数 / 整型。指示一个 PDP 上下文的标识符（请查看 AT+CGDCONT）。如 果没有指定，则返回所有已定义上下文的地址。 字符串类型。在适用于 PDP 的地址空间识别 MT 的地址，地址可以 为静态或动态。静态地址由命令 AT+CGDCONT 设定。动态地址在 上一次 PDP 上下文激活期间分配，使用引用的上下文。如果 和的地址均不可用，则省略。 当分配 IPv4 及 IPv6 的地址时，和 上海移远通信技术股份有限公司 43 / 105 BC25 系列 AT 命令手册 均被指定，对应 IPV4 的地址，对 应 IPV6 的地址。 该字符串为点分隔的数字参数（范围 0~255）形式： IPv4 的形式为：a1.a2.a3.a4；IPV6 的形式为 a1a2:a3a4:a5a6:a7a8: a9a10:a11a12:a13a14:a15a16。 错误码。参见第 15 章。 备注 在 双 栈 终端 （ =IPV4V6 ）， 对应 IPv6 的地址 ； 对于 IPv6 单 栈终端 （=IPV6）或者由于向后兼容性的原因，IPv6 地址也可包含在参数 中。 举例 AT+CGPADDR=1 +CGPADDR: 1,'101.43.5.1' OK AT+CGPADDR=? +CGPADDR: (1) OK 5.9. AT+QICSGP 配置 PDP 上下文 该命令用于配置 PDP 上下文，仅在需要配置 APN 用户名和密码时使用该命令。否则，请使用 AT+CGDCONT 来定义 PDP 上下文。 AT+QICSGP 配置 PDP 上下文 测试命令 AT+QICSGP=? 响应 +QICSGP: (支持范围)[,(支持的范围),< APN>[,,[,(支持的 范围)]]] 查询命令 AT+QICSGP= OK 响应 +QICSGP: ,,,, OK 上海移远通信技术股份有限公司 44 / 105 BC25 系列 AT 命令手册 设置命令 AT+QICSGP=[,,< APN>[,,)[,]]] 响应 OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 深睡眠唤醒有效； 参数配置不保存至 NVRAM。 参数 整型。指示一个 PDP 上下文的标识符。UE-TE 接口的本地参数，可以用在其他 PDP 上下文相关的命令中。范围：1~7。 整型。协议类型。 1 IPV4 2 IPV4V6 3 IPV6 字符串类型。接入点名称。用于选择 GGSN 或外部分组数据网络的逻辑名称。如果 值为空或省略，则将请求订阅值。 字符串类型。用户名。最大长度为 36 个字节。 字符串类型。用户密码。最大长度为 36 个字节。 整型。鉴权方式。 0 NONE 1 PAP 2 CHAP 3 CHAP 或 PAP 错误码。参见第 15 章。 举例 AT+QICSGP=2,1,'UNINET',,,1 OK AT+QICSGP=2 +QICSGP: 1,'UNINET',,,1 OK //配置上下文 2。APN 是中国联通的 UNINET。 //查询配置上下文的 ID 为 2。 备注 1. 若未通过 AT+QICSGP 配置 PDP 上下文，则无法使用该命令读取 PDP 上下文。 2. 当设置为 3 时，默认使用 CHAP 加密。CHAP 加密失败时，将使用 PAP 加密（协 上海移远通信技术股份有限公司 45 / 105 BC25 系列 AT 命令手册 议认证失败后网络侧返回的拒绝码值应为 29，否则认证方式不会切换到 PAP）。 3. =1 为初始 PDP 上下文，不可通过 AT+QICSGP 配置和清除。使用 AT+QCGDEFCONT 可以 配置=1。 5.10. AT+CSCON 信令连接状态 该命令返回 TA 感知到的无线连接状态（即和基站的连接）的详细信息，并返回当前状态的指示。该状 态仅在无线事件发生时更新，例如发送和接收数据。因此，当前返回的状态可能已经过时。即使在返回状 态=1（已连接）的情况下，因为连接质量的变化，模块仍可能无法使用基站。 设置命令控制 URC 的显示。 查询命令返回 URC 设置状态和整型参数，指 MT 当前为空闲状态或已连接状态。 AT+CSCON 信令连接状态 测试命令 AT+CSCON=? 响应 +CSCON: (支持的列表) OK 查询命令 AT+CSCON? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCON: , OK 设置命令 AT+CSCON= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 46 / 105 BC25 系列 AT 命令手册 特性说明 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。（需先执行 AT&W 保存配置） 参数 整型。表示使能/禁用 URC。 0 禁用 URC 1 使能 URC +CSCON: 整型。表示信令连接状态。 0 空闲 1 已连接 错误码。参见第 15 章。 举例 AT+CSCON=0 OK AT+CSCON? +CSCON: 0,1 OK AT+CSCON=? +CSCON: (0,1) OK AT+CSCON=1 OK AT+CSCON? +CSCON: 1,1 OK 5.11. AT+COPS 运营商选择 设置命令强制尝试使用安装在当前所选卡槽中的 USIM 卡来选择和注册 EPS 网络运营商。参数 用来设置找网动作，是由 UE 自动完成，还是通过该命令以特定的接入方式，强制选择运营商 （由指定）。如果选择的接入技术不可用，应在其他接入技术中选择相同的运营商。选定运营商名 称的格式同样适用于查询命令 AT+COPS?。=2 强制尝试注销网络。所选模式会影响后续所有网络 注册（例如，当设置=2 后，只有在设置 =0 或 1 时 MT 才会注册网络）。尝试注册或注销 时，此命令应该是可中止的。 上海移远通信技术股份有限公司 47 / 105 BC25 系列 AT 命令手册 查询命令返回当前模式、当前所选运营商以及当前接入技术。如果没有选择运营商，则不会返回 、和。 测试命令返回五个参数，表示网络中出现的运营商。指示当前运营商是否可用的整型参数、运 营商的数字编码、接入技术的数字编码、注册模式及运营商名称的格式。 和根据实际出现的运营商数量可能重复出现。以上参数可能不可用，不可用时为空字段。运 营商清单应按此顺序排列：本地网络、USIM 中选用的网络或 UICC（USIM）中的活动应用程序引用（顺 序：HPLMN 选择器、用户控制的 PLMN 选择器、运营商控制的 PLMN 选择器、USIM 中的 PLMN 选择器） 以及其他网络。 选择接入技术的参数仅应用于能够注册多种接入技术的终端。的选择不会限制小区重选 的能力，即使已经尝试选择一种接入技术，移动设备也可以在其他接入技术中重选小区。 AT+COPS 运营商选择 测试命令 AT+COPS=? 响应 +COPS: [(运营商,长字符,短字符,数字< oper>)],[(运营商,长字符,短字符,数字)],[...],[,,(支持的列表),(支持的列表)] OK 查询命令 AT+COPS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS: [,,][,] OK 设置命令 AT+COPS=[,[,[,]] 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 630 秒 上海移远通信技术股份有限公司 48 / 105 BC25 系列 AT 命令手册 特性说明 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置不保存至 NVRAM。 参数 整型。运营商选择模式。 0 自动模式（省略、和字段） 1 手动模式（包含和字段，可选） 2 手动注销网络 3 仅设置（将不在查询命令 AT+COPS?响应中返回） 4 手动/自动选择。如果手动选择失败，则进入自动模式（=0） 整型。的格式配置。 0 长字符 1 短字符 2 数字 字符串类型。指示此参数格式是否为数字格式；数字格式是 NB-IoT 网络位置 区域标识号，它由三位 BCD 数字 ITU-T 国家代码编码，加上 2 位或 3 位 BCD 数字网络 代码组成。=0 时，参数省略。 整型。运营商状态。 0 未知运营商 1 可用运营商 2 当前运营商 3 禁用的运营商 整型。接入技术设置。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 错误码。参见第 15 章。 备注 该命令的测试命令只能在模块 Modem 状态处于 Idle（空闲）时执行，否则将返回错误。 举例 AT+COPS=0 OK AT+COPS? +COPS: 0,2,'46000',9 OK 上海移远通信技术股份有限公司 49 / 105 BC25 系列 AT 命令手册 5.12. AT+CPSMS 省电模式设置 该命令控制 UE 省电模式（PSM）参数的设置，可以用来控制 UE 是否应用 PSM，以及 E-UTRAN 中 请求的扩展周期 TAU 值的范围和激活时间值。请参考 AT+CEREG 返回的 URC 查看激活时间值以及 E-UTRAN 网络分配给 UE 的扩展周期 TAU 值。 AT+CPSMS=2 是该命令的一种特殊形式，在这种形式下，将禁用 PSM，并删除已通过 AT+CPSMS 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 查询命令返回当前设置的参数值。 AT+CPSMS 省电模式设置 测试命令 AT+CPSMS=? 响应 +CPSMS: (支持的范围),,,(支持的范围),(支持的范围) OK 查询命令 AT+CPSMS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPSMS: [,,,[],[] OK 设置命令 AT+CPSMS=[,,,[,]] 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒后仍有效； 上海移远通信技术股份有限公司 50 / 105 参数配置自动保存至 NVRAM。 BC25 系列 AT 命令手册 参数 整型。表示禁用或使能 UE 的 PSM。 0 禁用 PSM 1 启用 PSM 2 禁用 PSM 并删除 PSM 的所有参数，若有默认值，则重置为默认值。 字符串类型。8 位格式的 1 字节参数。表示将在 E-UTRAN 分配给 UE 的 请求扩展周期性 TAU 值（T3412），且被编码为 GPRS Timer 3 信息的 1 个字符（octet 3）（例如'01000111'等于 70 小时）。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了定时器值的单位，具体如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增（备注） 1 1 1 该值表示定时器被停用 字符串类型，8 位格式的 1 字节参数。表示待分配给 UE 的请求激活时间 值（T3324）（如'00100100'等于 4 分钟）。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了 GPRS 定时器值的有效时间值单位，具体如下： 位数 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 表示定时器被停用的值 错误码。参见第 15 章。 备注 1. 该定时器值的单位仅适用于 T3412 扩展值 IE。如果以完整性保护消息的形式接收，那么将以 320 小 时的倍数解读接收到的值，否则，将以 1 小时的倍数解读。 2. AT+CPSMS?查询命令只会返回模式值 0 和 1。 3. 该命令可以设置模块向核心网络请求的 TAU 和 Active-time 的时间，请求值是否生效最终取决于网络。 上海移远通信技术股份有限公司 51 / 105 BC25 系列 AT 命令手册 举例 AT+CPSMS=1,,,'00111000','00000101' OK AT+CPSMS? +CPSMS: 1,,,'00111000','00000101' //设置请求的 TAU 值为 24 小时，Active-time 为 10 秒。 OK AT+CPSMS=? +CPSMS: (0-2),,,('00000000'-'11111111'),('00000000'-'11111111') OK 5.13. AT+CEDRXS eDRX 设置 设置命令设置 UE 的 eDRX 参数，即设置 UE 是否要应用 eDRX，以及指定接入技术请求的 eDRX 值。 当=2，且网络提供的 eDRX 参数发生变化时，该设置命令将用于控制 URC +CEDRXP: [,[,[,]]] 的上报。 该设置命令包含一种特殊形式：AT+CEDRXS=3。此形式的命令将禁用 eDRX，并删除已通过 AT+CEDRXS 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的范围),(支持的列表), (支持的范围) OK 查询命令 AT+CEDRXS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXS: ,, OK 若出现任何错误： 上海移远通信技术股份有限公司 52 / 105 BC25 系列 AT 命令手册 设置命令 AT+CEDRXS=[,[,< Requested_eDRX_value>]] 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。 参数 整型。表示启用或禁用 eDRX。该参数适用于所有指定的接入技术类 型，即的最新设置将对所有指定取值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并启用 URC +CEDRXP: [,[,[,]]]上报 3 禁用 eDRX 并清除所有的 eDRX 参数配置（若有默认值，则重置 为默认值） 整型。接入技术类型。 0 未使用 eDRX 的接入技术，该参数值仅在 URC 中使用。 5 E-UTRAN（NB-S1 模式） 字符串类型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节参数。NB-S1 模式。 上海移远通信技术股份有限公司 53 / 105 BC25 系列 AT 命令手册 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 错误码。参见第 15 章。 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS: 1,5,'0101' OK AT+CEDRXS=? +CEDRXS: (0-3),(5),('0000'-'1111') 上海移远通信技术股份有限公司 54 / 105 BC25 系列 AT 命令手册 OK 5.14. AT+CEDRXRDP 查询动态 eDRX 参数 如果 eDRX 用于 MS 当前注册的小区时，该执行命令返回、、 和。 如果 MS 当前注册的小区未使用 eDRX，则的返回值为 0。 AT+CEDRXRDP 查询动态 eDRX 参数 测试命令 AT+CEDRXRDP=? 响应 OK 执行命令 AT+CEDRXRDP 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXRDP: [,[,< NW-provided_eDRX_value>[,]]] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。表示接入技术类型。 5 E-UTRAN（NB-S1 模式） 字符串类型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 上海移远通信技术股份有限公司 55 / 105 BC25 系列 AT 命令手册 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 错误码。参见第 15 章。 举例 AT+CEDRXRDP 上海移远通信技术股份有限公司 56 / 105 +CEDRXRDP: 5,'0101','0101','0011' OK AT+CEDRXRDP=? OK BC25 系列 AT 命令手册 5.15. AT+QBAND 获取和设置工作频段 该命令用于获取当前使用的频段或设置要锁定的频段。 AT+QBAND 获取和设置工作频段 测试命令 AT+QBAND=? 响应 +QBAND: (支持的范围),(支持的列表) OK 查询命令 AT+QBAND? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QBAND: OK 设置命令 AT+QBAND=[,[,[,...]]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令重启后生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 57 / 105 BC25 系列 AT 命令手册 参数 整型。表示要设置的频段个数。 0 设置工作频段为模块支持的所有频段，此时无需后续参数指定具体的频段 1-3 要设置的频段个数 整型。NB-IoT 频段。有效值：3、5 和 8。 整型。表示正在使用的频段。有效值：3、5 和 8。 错误码。参见第 15 章。 备注 BC25-B5 和 BC25-B8 是单频段版本，因此仅支持单个频段（BC25-B5 支持 B5，BC25-B8 支持 B8）。 举例 AT+QBAND=? +QBAND: (0-3),(3,5,8) OK AT+QBAND=1,5 OK AT+QBAND? +QBAND: 5 OK //查询支持的频段列表 //设置频段为 BAND 5 //查询当前设定的频段 5.16. AT+QLOCKF 锁定 NB-IoT EARFCN 该命令用于将 UE 锁定到特定 EARFCN（频点），以及可选地，锁定到特定的小区 ID。 AT+QLOCKF 锁定 NB-IoT EARFCN 测试命令 AT+QLOCKF=? 响应 +QLOCKF: (支持的列表)[,,(支持的 范围)[,]] OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 58 / 105 BC25 系列 AT 命令手册 查询命令 AT+QLOCKF? +CME ERROR: 响应 +QLOCKF: [,,[,]] OK 设置命令 AT+QLOCKF=[,,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。 参数 整型。激活/移除锁定。 0 移除锁定 1 激活锁定 整型。要请求锁定的 EARFCN。范围：0~262143。取值为 0 时，表示移除对 EARFCN 和小区的锁定。 整型。请求的 EARFCN 的偏移量。 0 偏移 -20 1 偏移 -19 … 19 偏移 -1 … 37 偏移 17 38 偏移 18 整型。物理小区 ID。范围：0~503。 错误码。参见第 15 章。 上海移远通信技术股份有限公司 59 / 105 BC25 系列 AT 命令手册 5.17. AT+QENG 查询工程模式 该命令用于查询工程模式下，服务小区的当前 Modem 状态信息和网络状态。 AT+QENG 查询工程模式 测试命令 AT+QENG=? 响应 +QENG: (支持的列表) OK 设置命令 AT+QENG= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当 =0 时： +QENG: 0,,,,,[],[],[],[],< sc_band>,,[],[] [+QENG: 1,,,,], [+QENG: 1,,,,], […] OK 当 =1 时： +QENG: 2,,,,,,,,,,,,,, OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 60 / 105 BC25 系列 AT 命令手册 特性说明 / 参数 * * 整型。请求的工程信息。 0 显示服务小区和相邻小区的无线信息 1 仅当 Modem 处于 RRC-CONNECTED 状态时显示数据传输信息 整型。服务小区的 EARFCN。范围：0~262143。 整型。服务小区的 EARFCN 偏移量。 0 偏移 -10 1 偏移 -9.5 … 19 偏移 -0.5 … 37 偏移 8.5 38 偏移 9 整型。服务小区的物理小区 ID，范围：0~503。 字符串类型。4 字节（28 位）服务小区 ID。十六进制格式。. 带符号的小数型。服务小区的 RSRP 值。单位：dBm。（可为负数值）。 有符号整型。服务小区的 RSRQ 值。单位：dB。（可为负数值）。 有符号整型。表示服务小区的 RSSI 值。单位：dBm。（可为负数值）。 有符号整型。表示服务小区的上一个 SNR 值。单位：dB。 整型。当前服务小区频段。 字符串类型。双字节跟踪区域代码（TAC）。十六进制格式（例如，'00C3' 等于十进制格式的 195）。 整型。服务小区的上次增强覆盖级别（ECL）值。范围：0~2。 有符号整型。当前 UE 发射功率。 单位：dBm。 整型。相邻小区的 EARFCN。范围：0~262143。 整型。相邻小区的 EARFCN 偏移量。 0 偏移-20 1 偏移-19 20 偏移 0 37 偏移 17 38 偏移 18 整型。相邻小区的物理小区 ID。范围：0~503。 带符号的小数型。相邻小区的 RSRP 值。单位：dBm。（可为负数值）。 整型。百分比值。（范围：0~100）。RLC 层的 UL 误块率（根据每个 IRQ）。 基于所有建立的 RLC AM 无线电承载计算。从成功建立/恢复 RRC 连接开 始，或从前一个=1 的 AT+QENG 开始计算（以较晚者为准）。仅 在 RRC-CONNECTED 状态下有效。 整型。百分比值。（范围：0~100）。RLC 层的 DL 误块率（根据每个 ARQ）。 基于所有建立的 RLC AM 无线承载计算。从成功建立/恢复 RRC 连接开始， 或从前一个=1 的 AT+QENG 开始计算（以较晚者为准）。仅在 上海移远通信技术股份有限公司 61 / 105 BC25 系列 AT 命令手册 RRC-CONNECTED 状态下有效。 整型。百分比值。（范围：0~100）。UL-SCH 的 MAC 中的 UL 误块率（根 据每个 HARQ）。从成功建立/恢复/重新建立 RRC 连接开始，或从前一个 =1 的 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。 整型。百分比值。（范围：0~100）。DL-SCH 的 MAC 中的 DL 误块率，不 包括 BCCH。从成功建立/恢复/重新建立 RRC 连接开始，或从前一个 =1 的 AT+QENG 开 始 计 算 （ 以 较 晚 者 为 准 ）。 仅 在 RRC-CONNECTED 状态下有效。 整型。在 UL-SCH 上传输（或重传）的传输块字节总数。基于针对 UL-SCH 的所有 HARQ 传输和重传计算。从成功建立/恢复/重新建立 RRC 连接开 始，或从前一个=1 的 AT+QENG 开始计算（以较晚者为准）。仅 在 RRC-CONNECTED 状态下有效。单位：字节。 整型。在 DL-SCH 上传输（或重传）的传输块字节总数，不包括 BCCH。 从成功建立/恢复/重新建立 RRC 连接开始，或从前一个=1 的 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下 有效。单位：字节。 整型。UL-SCH 上传输块的 HARQ 传输（或重传）总次数。从成功建立/ 恢复/重新建立 RRC 连接开始，或从前一个=1 的 AT+QENG 开 始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位： 传输（或重传）次数。 整型。DL-SCH 上传输块的 HARQ 传输（或重传）总次数，不包括 BCCH。 从成功建立/恢复/重新建立 RRC 连接开始，或从前一个=1 的 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下 有效。单位：传输（或重传）次数。 整型。UL-SCH 上传输块的 HARQ 重传总次数。从成功建立/恢复/重新建 立 RRC 连接开始，或从前一个=1 的 AT+QENG 开始计算（以 较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位：重传次数。 整型。DL-SCH 上传输块的 HARQ 重传总次数，不包括 BCCH。从成功建 立/恢复/重新建立 RRC 连接开始，或从前一个=1 的 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位： 重传次数。 整型。RLC 上行吞吐量。基于所有已建立的 RLC AM 无线承载计算。从成 功建立/恢复 RRC 连接开始，或从前一个=1 的 AT+QENG 开始 计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位：kbits/s。 整型。RLC 下行吞吐量。基于所有已建立的 RLC AM 无线承载计算。从成 功建立/恢复 RRC 连接开始，或从前一个=1 的 AT+QENG 开始 计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位：kbits/s。 整型。UL-SCH 上 MAC 中的上行吞吐量。从成功建立/恢复/重新建立 RRC 连接开始，或从前一个=1 的 AT+QENG 开始计算（以较晚者为 准）。仅在 RRC-CONNECTED 状态下有效。单位：kbits/s。 整型。DL-SCH 上 MAC 中的下行吞吐量，不包括 BCCH。从成功建立/恢 复/重新建立 RRC 连接开始，或从前一个=1 的 AT+QENG 开始 计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位：kbits/s。 上海移远通信技术股份有限公司 62 / 105 错误码。参见第 15 章。 BC25 系列 AT 命令手册 5.18. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 该命令用于启用/禁用事件的上报 URC。 AT+QNBIOTEVENT 启用/禁用 NB-loT 相关事件上报 测试命令 AT+QNBIOTEVENT=? 响应 +QNBIOTEVENT: (支持的列表),(支持的 列表) OK 查询命令 AT+QNBIOTEVENT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QNBIOTEVENT: , OK 设置命令 AT+QNBIOTEVENT=, 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。（需先执行 AT&W 保存配置） 上海移远通信技术股份有限公司 63 / 105 BC25 系列 AT 命令手册 参数 整型。 0 禁用事件指示 URC 1 启用事件指示 URC：+QNBIOTEVENT: 整型。表示事件类型。 1 PSM 状态 字符串类型。表示具体事件。 当为 PSM 时，为 ENTER PSM 或 EXIT PSM 错误码。参见第 15 章。 5.19. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表 该命令用于清除 UE 存储的 EARFCN 列表。 AT+QCSEARFCN 清除 NB-loT 存储的 EARFCN 列表 测试命令 AT+QCSEARFCN=? 响应 +QCSEARFCN: (支持的列表) OK 设置命令 AT+QCSEARFCN= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效 参数 整型。表示清除 NB-IoT 存储的 EARFCN 列表 0 清除 NB-IoT 存储的 EARFCN 列表 上海移远通信技术股份有限公司 64 / 105 错误码。参见第 15 章。 举例 AT+QCSEARFCN=0 OK BC25 系列 AT 命令手册 5.20. AT+QCFG 扩展配置设置 该命令用于配置 UE 的各种设置 AT+QCFG 扩展配置设置 测试命令 AT+QCFG=? 设置命令 AT+QCFG=[,] 最大响应时间 特性说明 响应 +QCFG: (支持的列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: OK 若指定可选参数，则配置选项： OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 65 / 105 参数 字符串类型。配置的选项。 'EPCO' 整型。配置的值。 'EPCO' 0 1 错误码。参见第 15 章。 BC25 系列 AT 命令手册 描述 禁用 EPCO 启用 EPCO 举例 AT+QCFG='EPCO' +QCFG: 0 OK AT+QCFG='EPCO',1 OK 备注 当 EPCO 启用时，如果网络不支持 EPCO，模块将在连接后自动禁用 EPCO 并将对应的设为 0。 5.21. AT+CCIOTOPT CloT 优化配置 设置命令设置 UE 在 ATTACH REQUEST 和 TRACKING AREA UPDATE REQUEST 消息中指示所支 持和优先选择的 CIoT EPS 优化配置。该命令还可用来上报网络支持的 CIoT EPS 优化配置。支持 CIoT 功 能的 UE 可以支持控制面（control plane）或用户面（user plane）的 CIoT EPS 优化配置，或两者都可支 持（请参考 3GPP TS 24.301, sub-clause 9.9.3.34）。基于应用特性，UE 可能优先选择注册用于控制面的 CIoT EPS 优化配置或用于用户面的 CIoT EPS 优化配置（请参考 3GPP TS 24.301, sub-clause 9.9.3.0B）。 此外，网络可支持控制面 CIoT EPS 优化配置或用户面 CIoT EPS 优化配置或两者都可支持（请参考 3GPP TS 24.301, sub-clause 9.9.3.12A）。 设置命令还用于设置开启或关闭 URC +CCIOTOPTI: ，该 URC 用于表示 网络所支持的 CIoT EPS 优化配置。 查询命令返回当前支持和首选的 CIoT EPS 优化配置，以及当前 URC +CCIOTOPTI 的状态。 AT+CCIOTOPT CloT 优化配置 测试命令 AT+CCIOTOPT=? 响应 +CCIOTOPT: (支持的范围),(支持的范围),(支持的列表) OK 查询命令 AT+CCIOTOPT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCIOTOPT: ,, OK 设置命令 AT+CCIOTOPT=[,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当 =0 或 =2： OK 当 =1 时： OK +CCIOTOPTI: 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。 参数 整型。启用/禁用 URC +CCIOTOPTI 的上报。 0 禁用 URC 1 启用 URC 2 禁用上报并将 CIoT EPS 优化配置的参数重置为默认值 整型。表示 UE 对 CIoT EPS 优化配置的支持情况。 上海移远通信技术股份有限公司 67 / 105 BC25 系列 AT 命令手册 0 不支持 CP 及 up CIoT 1 支持控制面 CIoT EPS 优化配置 2 支持用户面 CIoT EPS 优化配置 3 支持控制面 CIoT EPS 优化配置和用户面 CIoT EPS 优化配置 整型。表示 UE 优先选择的 CIoT EPS 优化配置。 0 无优先级 1 优先选择控制面 CIoT EPS 优化配置 2 优先选择用户面 CIoT EPS 优化配置 整型。表示网络所支持的 CIoT EPS 优化配置数。范围：0~3。 0 不支持 1 支持控制面 CIoT EPS 优化 2 支持用户面 CIoT EPS 优化 3 同时支持控制面 CIoT EPS 优化和用户面 CIoT EPS 优化 错误码。参见第 15 章。 备注 由于 NB-IoT 必须支持 CP CIoT，故被配置为 0 或 2 时无效。 5.22. AT+CTZR 上报时区 设置命令启用/禁用时区变化事件上报。启用上报后，一旦时区发生改变，MT 将返回 URC +CTZV: 。 AT+CTZR 上报时区 测试命令 AT+CTZR=? 响应 +CTZR: (支持的列表) OK 查询命令 AT+CTZR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CTZR: OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 68 / 105 BC25 系列 AT 命令手册 设置命令 AT+CTZR= 最大响应时间 特性说明 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。（需先执行 AT&W 保存配置） 参数 整型。禁用或开启时区变化事件上报 URC。 0 禁用时区变化事件上报 URC 1 启用时区变化事件上报 URC +CTZV: 字符串类型。本地时区总和（当地时间与 GMT 的时差，以 15 分钟表示）加上夏令时的 总和，格式为'±zz'，长度固定为-48 ~+56 范围内的 2 位整数。为保持固定宽度，范围在 -9 ~+9 之间的数字均以 0 开头，例如'-09'，'+00'，'+09'。 错误码。参见第 15 章。 举例 AT+CTZR=? +CTZR: (0,1) OK AT+CTZR=0 OK AT+CTZR? +CTZR: 0 OK 上海移远通信技术股份有限公司 69 / 105 BC25 系列 AT 命令手册 5.23. AT+CGAPNRC 查询 APN 速率控制参数 设置命令返回指定的上下文标识符 参数对应的 APN 速率控制参数（请参考 3GPP TS 24.008）。 执行命令返回所有的已激活 PDP 上下文的 APN 速率控制参数。 AT+CGAPNRC 查询 APN 速率控制参数 测试命令 AT+CGAPNRC=? 响应 +CGAPNRC: (已激活 PDP 上下文列表) OK 设置命令 AT+CGAPNRC= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAPNRC: [,[,[,]]] OK 执行命令 AT+CGAPNRC 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAPNRC: [,[,[,]]] [+CGAPNRC: [,[,< Uplink_time_unit>[,]]]] [...] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 深睡眠唤醒有效； 上海移远通信技术股份有限公司 70 / 105 参数配置不保存至 NVRAM。 BC25 系列 AT 命令手册 参数 整型。指示一个 PDP 上下文的标识符（请参考 AT+CGDCONT 命令）。 整型。表示当达到最大上行速率时是否允许发送额外异常报告。此参 数为 3GPP TS 24.008 subclause 10.5.6.3.2 中规定的 APN 速率控制 参数 IE 的八位位组 1 的第 4 位。 0 表示不允许以最大速率发送 1 表示允许以最大速率发送 整型。最大上行速率使用的时间单位。为 3GPP TS 24.008 subclause 10.5.6.3.2 中规定的 APN 速率控制参数 IE 的八位位组 1 的第 1 位到 第 3 位。 0 不受限 1 分钟 2 小时 3 天数 4 周 整型。每个上行时间单位限制 UE 发送的最大消息数。为 3GPP TS 24.008 subclause 10.5.6.3.2 中规定的 APN 速率控制参数 IE 的八位 组 1 的第 2 位到第 4 位。 错误码。参见第 15 章。 5.24. AT+QSPCHSC 设置加扰算法 该命令用来选择新旧扰码。由于扰码已经由 3GPP 更新，UE 需要为网络选择正确的扰码。 AT+QSPCHSC 设置加扰算法 测试命令 AT+QSPCHSC=? 响应 +QSPCHSC: (支持的列表) OK 查询命令 AT+QSPCHSC? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QSPCHSC: 上海移远通信技术股份有限公司 71 / 105 BC25 系列 AT 命令手册 设置命令 AT+QSPCHSC= 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启效； 深睡眠唤醒后仍有效 参数配置自动保存至 NVRAM。 参数 整型。算法类别。 0 旧算法 1 新算法 错误码。参见第 15 章。 5.25. AT+CSODCP 通过控制面发送始端数据 TE 使用该设置命令通过 UE 将数据通过控制面传输到网络。上下文标识符用于将数据连接到特 定的上下文。 该命令可以有选择性地指示 UE 的应用程序，是期望通过此上行数据完成数据的交换，还是通过接收到 的下一条下行数据完成数据交换。 该命令也可有选择性地指示将要传输的数据是否为异常数据，可以引发 ESM DATA TRANSPORT 消息 的传输，如 3GPP TS 24.301 中定义。 AT+CSODCP 通过控制面发送始端数据 测试命令 AT+CSODCP=? 响应 +CSODCP: (支持的范围),(支持的最 大发送字节数),'',(支持的范围),(支持的列表) OK 设置命令 AT+CSODCP=,, [,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 / BC25 系列 AT 命令手册 参数 整型。UE-TE 接口的本地参数，指示已通过 AT 命令设置的 PDP 或 EPS 承载 上下文（参考 AT+CGDCONT 命令）。 整型。指示信息元素的八位字节数。 范围：0~1500。当没有数据传 输时，该值应设置为零。 八位字符串。包含用户数据容器内容。当没有数据要传输时，参数 应为空字符串（''）。该参数不应按照 3GPP TS 27.007 中的 AT+CSCS 进行 常规字符转换。用户数据容器的编码格式和参数的最大长度是特定 的。 整型。表示释放辅助指示的值，参考 3GPP TS 24.301 subclause 9.9.4.25。 0 无指示 1 ESM DATA TRANSPORT 消息传输后不期望有进一步上下行数据，核心 网可立即释放 2 接收最后的 ESM DATA TRANSPORT 消息后完成数据交换，核心网在下 发后立即释放 整型。表示传输的用户数据是正常数据还是异常数据。 0 正常数据 1 异常数据 错误码。参见第 15 章。 上海移远通信技术股份有限公司 73 / 105 举例 AT+CSODCP=? +CSODCP:(0-7),(0-1500),'',(0-2),(0-1) OK 备注 当前只支持取值 1~7，不支持取值 0。 BC25 系列 AT 命令手册 上海移远通信技术股份有限公司 74 / 105 BC25 系列 AT 命令手册 6 硬件相关命令 6.1. AT+CFUN 设置 UE 功能 该命令用来选择 UE 的功能等级。'全部功能'等级对应高级别的功率。'最少功能'对应低级别的功率。 查询命令返回的当前设置。 AT+CFUN 设置 UE 功能 测试命令 AT+CFUN=? 响应 +CFUN: (支持的列表),(支持的列表) OK 查询命令 AT+CFUN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CFUN: OK 设置命令 AT+CFUN=[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 90 秒，由网络判定。 上海移远通信技术股份有限公司 75 / 105 特性说明 该命令立即生效 参数 整型。UE 功能等级。 0 最少功能 1 全部功能 整型。表示在设置功能等级后是否重启 UE。 0 不重启 UE 1 重启 UE，自动保存 错误码。参见第 15 章。 举例 AT+CFUN=? +CFUN: (0,1),(0,1) OK AT+CFUN=1 OK AT+CFUN? +CFUN: 1 OK 6.2. AT+QSCLK 设置睡眠模式 该命令用于设置睡眠模式。 AT+QSCLK 设置睡眠模式 测试命令 AT+QSCLK=? 查询命令 响应 +QSCLK: (支持的范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 上海移远通信技术股份有限公司 BC25 系列 AT 命令手册 76 / 105 BC25 系列 AT 命令手册 AT+QSCLK? 设置命令 AT+QSCLK= 最大响应时间 特性说明 +QSCLK: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效（当=1 切换为=2 时，该命令在模块重 启后生效，反之亦然）； 深睡眠唤醒后仍有效 参数配置自动保存至 NVRAM。 参数 整型。睡眠模式。 0 禁用睡眠模式 1 启用轻度睡眠和深睡眠，通过 PSM_EINT（下降沿）唤醒 2 仅启用轻度睡眠，由主 UART 唤醒 错误码。参见第 15 章。 备注 1. 在深睡眠模式下，UART 不会工作。因此，当 AT+QSCLK=1 时，发送 AT 命令之前需确保已经唤醒 UART。 2. 当 AT+QSCLK=0 时，UART 始终处于工作模式。如果需要允许模块进入睡眠模式，请重新发送命令 AT+QSCLK=1 或 AT+QSCLK=2。 举例 AT+QSCLK=1 OK 上海移远通信技术股份有限公司 77 / 105 BC25 系列 AT 命令手册 6.3. AT+QRST 重启模块 该命令用来立即重启模块。 AT+QRST 重启模块 测试命令 AT+QRST=? 设置命令 AT+QRST= 最大响应时间 特性说明 响应 +QRST: (支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效 参数 整型 1 立即自动重启 错误码。参见第 15 章。 6.4. AT+QPOWD 模块关机 该命令用于关闭或重启模块。 AT+QPOWD 模块关机 测试命令 AT+QPOWD=? 响应 +QPOWD: (支持的范围) 上海移远通信技术股份有限公司 78 / 105 设置命令 AT+QPOWD= 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当=0 时： OK 当=1 时： NORMAL POWER DOWN 当=2 时： OK 若出现任何错误： ERROR 或者 +CME ERROR: 1秒 该命令立即生效 BC25 系列 AT 命令手册 参数 整型。 0 紧急关机（无 deattach 动作，不发送 URC NORMAL POWER DOWN） 1 正常关机（执行 deattach 动作，并发送 URC NORMAL POWER DOWN） 2 重启模块（无 deattach 动作） 错误码。参见第 15 章。 举例 AT+QPOWD=0 OK 6.5. AT+CCLK 查询和设置当前日期和时间 一旦 UE 连接到网络，将自动设置时钟。 上海移远通信技术股份有限公司 79 / 105 查询命令返回时钟的当前设置。 AT+CCLK 查询当前日期和时间 测试命令 AT+CCLK=? 响应 OK 查询命令 AT+CCLK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCLK: OK 设置命令 AT+CCLK= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / BC25 系列 AT 命令手册 参数 字符串类型。格式为'yy/MM/dd,hh:mm:ss'，各字符分别表示年（yy，最后两位数字）、 月（MM）、日（dd）、小时（hh）、分钟（mm）和秒（ss）。 错误码。参见第 15 章。 举例 AT+CCLK=? OK AT+CCLK='19/05/06,22:10:00' OK 上海移远通信技术股份有限公司 80 / 105 BC25 系列 AT 命令手册 6.6. AT+QCCLK 查询和设置 UTC 时间和时区 该命令用于查询和设置 UE 的世界标准时间（UTC）。 AT+QCCLK 查询和设置 UTC 时间和时区 测试命令 AT+QCCLK=? 响应 OK 查询命令 AT+QCCLK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QCCLK: OK 设置命令 AT+QCCLK= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。时间格式为'yy/MM/dd,hh:mm:ss+zz'，各字符分别表示年（yy，最后两位 数字）、月（MM）、日（dd）、小时（hh）、分钟（mm）、秒（ss）和时区（zz）。 时区表 示本地时间和 GMT 之间的差异，以一刻钟表示（值范围从 -96 到 +96）。 例如，1994 年 5 月 6 日，22:10:00 GMT+2 小时相当于'94/05/06,22:10:00+08'。 错误码。参见第 15 章。 上海移远通信技术股份有限公司 81 / 105 举例 AT+QCCLK=? OK AT+QCCLK='19/05/06,22:10:00+08' OK BC25 系列 AT 命令手册 6.7. AT+CBC 查询电源电压值 该命令用于查询电源的电压值。 AT+CBC 查询电源电压值 测试命令 AT+CBC=? 执行命令 AT+CBC 最大响应时间 特性说明 响应 +CBC: (支持的范围),(支持的范围),(的 值) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CBC: ,, OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 电池充电状态。 0 ME 不在充电 1 ME 正在充电 2 充电已经完成 上海移远通信技术股份有限公司 82 / 105 BC25 系列 AT 命令手册 3 充电适配器已连接，充电完成 4 充电异常，充电中断 5 充电温度异常，由于温度超出允许范围，充电中断 电池电量。 0...100 电池剩余容量为 0-100% 电池电压（mV）。 错误码。参见第 15 章。 备注 由于 BC25 系列模块不支持电池充电，和无效，而仍然代表正确的电源电压。 举例 AT+CBC +CBC: 0,0, 3856 OK 6.8. AT+QATWAKEUP 启用/禁用深睡眠唤醒指示 该命令用于配置进入或退出深睡眠时是否上报相关 URC。 AT+QATWAKEUP 启用/禁用深睡眠唤醒指示 测试命令 AT+QATWAKEUP=? 响应 +QATWAKEUP: (支持的列表) OK 查询命令 AT+QATWAKEUP? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QATWAKEUP: OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 83 / 105 BC25 系列 AT 命令手册 设置命令 AT+QATWAKEUP= 最大响应时间 特性说明 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。（需先执行 AT&W 保存配置） 参数 整型。 0 禁用当模块进入/退出深睡眠模式时的 URC 1 启用当模块进入/退出深睡眠模式时的 URC 错误码。参见第 15 章。 举例 AT+QATWAKEUP=1 OK //模块进入深睡眠模式。 +QATSLEEP //启用唤醒指示。 //当模块成功进入深睡眠模式时，将上报此 URC。 //模块进入深睡眠模式。 +QATSLEEPFAIL //当模块进入深睡眠模式失败时，将上报此 URC。 //模块从深睡眠模式被唤醒。 +QATWAKEUP //模块已完全被唤醒并准备接收 AT 命令/数据。 6.9. AT+QLEDMODE 配置网络指示灯 该命令用于启用或禁用网络指示灯。 AT+QLEDMODE 测试命令 AT+QLEDMODE=? 配置网络指示灯 响应 +QLEDMODE: (支持的列表) 上海移远通信技术股份有限公司 84 / 105 BC25 系列 AT 命令手册 查询命令 AT+QLEDMODE? 设置命令 AT+QLEDMODE= 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLEDMODE: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效； 深睡眠唤醒后仍有效； 参数配置自动保存至 NVRAM。 参数 整型。网络指示灯状态 0 禁用网络指示灯 1 启用网络指示灯 错误码。参见第 15 章。 举例 AT+QLEDMODE=1 OK 上海移远通信技术股份有限公司 85 / 105 BC25 系列 AT 命令手册 6.10. AT+QADC 读取 ADC 该命令用于读取 ADC。 AT+QADC 读取 ADC 测试命令 AT+QADC=? 查询命令 AT+QADC? 最大响应时间 特性说明 响应 +QADC: (支持的列表),(的值) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QADC: , OK 若出现任何错误： ERROR 或者 +CME ERROR: 2秒 / 参数 整型。读取状态。 0 读取失败 1 读取成功 ADC 值。范围：0~1890。单位：mV。 错误码。参见第 15 章。 上海移远通信技术股份有限公司 86 / 105 BC25 系列 AT 命令手册 7 TCP/IP 相关命令 有关 TCP/IP 功能的详细信息，请参考《Quectel_BC25&BC32 系列_TCP(IP)_应用指导》。 表 3：TCP/IP 相关命令 命令 AT+QIOPEN AT+QICLOSE AT+QISTATE AT+QISEND AT+QIRD AT+QISENDEX AT+QISWTMD AT+QPING AT+QNTP AT+QIDNSGIP AT+QICFG AT+QIGETERROR AT+QIDNSCFG 描述 打开 Socket 关闭 Socket 查询 Socket 状态 发送文本字符串数据 读取收到的 TCP/IP 数据 发送十六进制字符串数据 切换数据访问模式 进行远程服务器 Ping 操作 通过 NTP 服务器同步本地时间 通过域名获取 IP 地址 配置可选参数 查询上一个错误代码 配置 DNS 服务器功能 上海移远通信技术股份有限公司 87 / 105 BC25 系列 AT 命令手册 8 OneNET 相关命令 有关 OneNET 功能的详细信息，请参考《Quectel_BC25&BC32_OneNET_应用指导》。 表 4：OneNET 相关命令 命令 描述 AT+MIPLCONFIG OneNET 接入配置 AT+MIPLCREATE 创建 OneNET 通信套件实例 AT+MIPLDELETE 删除 OneNET 通信套件实例 AT+MIPLVER 查询当前 OneNET SDK 版本 AT+MIPLADDOBJ 添加 LwM2M 对象 AT+MIPLDELOBJ 删除 LwM2M 对象 AT+MIPLOPEN 发送注册请求 AT+MIPLCLOSE 发送注销请求 AT+MIPLDISCOVERRSP 响应发现资源请求 AT+MIPLOBSERVERSP 响应订阅请求 AT+MIPLREADRSP 响应读取请求 AT+MIPLWRITERSP 响应写入请求 AT+MIPLEXECUTERSP 响应执行请求 AT+MIPLPARAMETERRSP 响应写属性请求 AT+MIPLNOTIFY 向 OneNET 平台或应用服务器上报数据 AT+MIPLUPDATE 发送更新请求 上海移远通信技术股份有限公司 88 / 105 BC25 系列 AT 命令手册 9 CMDMP 相关命令 有关 CMDMP 功能的详细信息，请参考《Quectel_BC25&BC32_CMDMP_应用指导》。 表 5：CMDMP 相关命令 命令 AT+QDMPCFG AT+QDMPCFGEX 描述 CMDMP 接入配置 CMDMP 接入扩展配置 上海移远通信技术股份有限公司 89 / 105 BC25 系列 AT 命令手册 10 中国电信物联网平台相关命令 有关中国电信物联网平台功能的详细信息，请参考《Quectel_BC25 系列_中国电信物联网平台应用指 导》。 表 6：中国电信物联网平台相关命令 命令 AT+NCDPOPEN AT+NCDPCLOSE AT+NMGS AT+NMGR AT+NNMI AT+NCFG AT+NMSTATUS AT+QLWULDATASTATUS AT+NQMGR 描述 发起连接 断开连接 发送数据 读取缓存数据 配置数据接收模式 配置命令 查询注册状态 查询 CON 消息发送状态 查询已接收消息状态 上海移远通信技术股份有限公司 90 / 105 BC25 系列 AT 命令手册 11 DFOTA 相关命令 有关 DFOTA 功能的详细信息，请参考《Quectel_BC25&BC32 系列_DFOTA_应用指导》。 表 7：DFOTA 相关命令 命令 AT+QFOTADL 描述 通过 HTTP 服务器进行 DFOTA 升级、串口 DFOTA 升级和文件下载功能 上海移远通信技术股份有限公司 91 / 105 BC25 系列 AT 命令手册 12 MQTT 相关命令 有关 MQTT 功能的详细信息，请参考《Quectel_BC25&BC32_MQTT_应用指导》。 表 8：MQTT 相关命令 命令 AT+QMTCFG AT+QMTOPEN AT+QMTCLOSE AT+QMTCONN AT+QMTDISC AT+QMTSUB AT+QMTUNS AT+QMTPUB 描述 配置 MQTT 参数 打开 MQTT 客户端网络 关闭 MQTT 客户端网络 连接客户端到 MQTT 服务器 客户端断开与 MQTT 服务器的连接 订阅主题 退订主题 发布消息 上海移远通信技术股份有限公司 92 / 105 BC25 系列 AT 命令手册 13 FILE 相关命令 有关 FS 功能的详细信息，请参考《Quectel_BC25&BC32 系列_FILE_应用指导》。 表 9：FILE 相关命令 命令 AT+QFLST AT+QFLDS AT+QFUPL AT+QFDWL AT+QFDEL AT+QFMOV AT+QFOPEN AT+QFREAD AT+QFWRITE AT+QFSEEK AT+QFCLOSE AT+QFPOSITION AT+QFFLUSH AT+QFTUCAT AT+QFRENAME 描述 列出文件 获取文件和存储空间大小 上传文件 下载文件 删除文件 从 RAM 移动文件至 UFS 打开文件 读取文件内容 写文件内容 移动当前文件操作指针 关闭文件 获取当前文件操作指针 将缓存内容写入文件 以当前文件操作指针截取文件 重命名文件 上海移远通信技术股份有限公司 93 / 105 BC25 系列 AT 命令手册 14 举例 14.1. 网络附着 模块开机后会自动进行网络附着。 14.1.1. 手动查询网络附着状态 以下举例说明了如何配置模块自动附着网络。用户仅需通过如下命令来查询模块是否已经附着网络。 //开机 RDY +CFUN: 1 +CPIN: READY AT OK AT+CFUN? +CFUN: 1 //同步成功。 //值为 1（完整功能）。 OK AT+CIMI 460012345678969 //查询 IMSI 号。 OK AT+CESQ //查询信号质量。 +CESQ: 36,99,255,255,12,53 OK AT+QENG=0 //查询模块的当前网络状态。 +QENG: 0,2506,,25,'dda1b53',-74,25,-60,4,5,'69c9',0,1 OK AT+CGATT? +CGATT: 1 //查询是否激活了网络：1 表示成功附着网络，0 表示未附着到网络。 上海移远通信技术股份有限公司 94 / 105 BC25 系列 AT 命令手册 OK AT+CEREG? +CEREG: 0,1 //查询网络注册状态，1 表示已注册到网络，2 表示正在搜索网络。 OK AT+CSCON? +CSCON: 0,1 //查询信号连接状态，1 表示 Connected，0 表示 Idle。 OK AT+CGPADDR? //查询是否获取到 IP 地址 +CGPADDR: 1,'100.105.213.132' OK 14.1.2. 通过 URC 上报自动附着网络状态 以下是一个自动附着网络的简单示例。用户不需要通过命令查询模块是否已经附着网络，通过上报的 URC 即可得知网络附着状态。 //开机 RDY +CFUN: 1 +CPIN: READY //配置初始网络附着的 APN。 //一旦设置，参数将会被保存到 NVRAM。 //重启或重新注册时生效。 AT+QCGDEFCONT='IP','CMNBIOT' OK AT+QRST=1 OK RDY +CFUN: 1 +CPIN: READY AT+CFUN? +CFUN: 1 //值为 1（完整功能）。 OK AT+CIMI 460012345678969 //查询 IMSI 号。 上海移远通信技术股份有限公司 95 / 105 BC25 系列 AT 命令手册 OK AT+CEREG=1 OK AT+CSCON=1 OK +CEREG: 2 //设置自动上报网络注册状态，即当模块注册到网络时，会上报一个 URC。 //设置自动上报信号连接状态，即在 Connected 或 Idle 状态时，会上报一个 URC //当前 MT 尝试附着或搜索一个要注册的运营商时上报 URC。 +CSCON: 1 //连接上 MT 上报 URC。 +CEREG: 1 //注册上 MT 上报 URC。 AT+CESQ //查询信号质量。 +CESQ: 36,99,255,255,12,53 OK AT+QENG=0 //查询模块状态。 +QENG: 0,2506,,25,'dda1b53',-74,25,-60,4,5,'69c9',0,1 OK AT+CGATT? +CGATT: 1 //查询是否激活了网络：1 表示成功附着网络，0 表示未附着到网络。 OK AT+CEREG? +CEREG: 1,1 //查询网络注册状态，1 表示已注册到网络，2 表示正在搜索网络。 OK AT+CSCON? +CSCON: 1,1 //查询信号连接状态，1 表示 Connected，0 表示 Idle。 OK 14.1.3. 通过指定的 PLMN 附着网络 以下举例说明了如何通过指定的 PLMN 自动附着网络。 //开机 RDY +CFUN: 1 +CPIN: READY //配置初始网络附着的 APN。 //一旦设置，参数将会保存到 NVRAM。 上海移远通信技术股份有限公司 96 / 105 BC25 系列 AT 命令手册 //重启或重新注册时生效。 AT+QCGDEFCONT='IP','CMNBIOT' OK AT+QRST=1 OK RDY +CFUN: 1 +CPIN: READY AT+CFUN? +CFUN: 1 //值为 1（完整功能）。 OK AT+CIMI 460012345678969 //查询 IMSI 号。 OK AT+COPS=1,2,'46000' //指定 PLMN。 OK AT+CESQ //查询信号质量。 +CESQ: 36,99,255,255,12,53 OK AT+QENG=0 //查询模块状态。 +QENG: 0,3734,,105,'82e76b2',-71,22,-56,22,8,'4c10',1,-6 OK AT+CGATT? +CGATT: 1 //查询是否激活了网络：1 表示成功附着网络，0 表示未附着到网络。 OK AT+CEREG? +CEREG: 0,1 //查询网络注册状态，1 表示已注册到网络，2 表示正在搜索网络。 OK AT+CSCON? +CSCON: 0,1 //查询信号连接状态，1 表示 Connected，0 表示 Idle。 OK 上海移远通信技术股份有限公司 97 / 105 BC25 系列 AT 命令手册 14.1.4. 通过指定的 EARFCN/PCI 附着网络 //开机 RDY +CFUN: 1 +CPIN: READY //配置初始网络附着的 APN。 //一旦设置，参数将会保存到 NVRAM。 //重启或重新注册时生效。 AT+QCGDEFCONT='IP','CMNBIOT' OK AT+QRST=1 OK RDY +CFUN: 1 +CPIN: READY AT+CFUN? +CFUN: 1 //值为 1（完整功能）。 OK AT+CIMI 460012345678969 //查询 IMSI 号。 OK AT+QLOCKF=1,3734,19,105 OK AT+CESQ +CESQ: 36,99,255,255,12,53 //指定 EARFCN，偏移量和 PCI。 //查询信号质量。 OK AT+QENG=0 //查询模块状态。 +QENG: 0,3734,,105,'82e76b2',-71,22,-56,22,8,'4c10',1,-6 OK AT+CGATT? +CGATT: 1 //查询是否激活了网络：1 表示成功附着网络，0 表示未附着到网络。 OK AT+CEREG? //查询网络注册状态，1 表示已注册到网络，2 表示正在搜索网络。 上海移远通信技术股份有限公司 98 / 105 +CEREG: 0,1 OK AT+CSCON? +CSCON: 0,1 BC25 系列 AT 命令手册 //查询信号连接状态，1 表示 Connected，0 表示 Idle。 OK 14.1.5. 通过指定的频段附着网络 //开机 RDY +CFUN: 1 +CPIN: READY //配置初始网络附着 APN。 //一旦设置，参数将会保存到 NVRAM。 //重启或重新注册时生效。 AT+QCGDEFCONT='IP','CMNBIOT' OK AT+QRST=1 OK RDY +CFUN: 1 +CPIN: READY AT+CFUN? +CFUN: 1 //值为 1（完整功能）。 OK AT+QBAND=? +QBAND: (0-3),(3,5,8) //查询支持的频段列表。 OK AT+QBAND=1,5 OK AT+QBAND? +QBAND: 5 //设置要使用的频段。 //查询正在使用的频段。 OK 上海移远通信技术股份有限公司 99 / 105 BC25 系列 AT 命令手册 15 错误码 本章主要介绍与 BC25 模块相关的错误码。 下表列出的错误码符合 3GPP 规范。请参考 3GPP TS 27.007 V13.5.0, sub-clause 9.2 了解更多 错误码。 表 10：错误代码列表 3 4 10 13 14 22 24 49 50 51 52 53 58 错误代码 Operation not allowed Operation not supported USIM not inserted USIM failure USIM busy not found Text overlong execution not supported Execution failed AT command no memory Option not supported Parameter invalid Invalid command line 上海移远通信技术股份有限公司 100 / 105 以下错误代码为 BC25 模块指定的错误代码。 表 11：指定错误代码列表 111 112 113 132 133 149 160 264 265 301 302 304 305 310 311 312 313 314 315 332 517 错误代码 PLMN not allowed Location area not allowed Roaming not allowed in this location area Service option not supported Requested service option not subscribed PDP authentication failure AT command cannot actioned USIM verification failed USIM unblock failed SMS service reserved Operation not allowed Invalid PDU parameter Invalid TXT parameter USIM not inserted USIM pin required PH USIM pin required USIM failed USIM busy USIM wrong Network timeout Invalid PDU character BC25 系列 AT 命令手册 上海移远通信技术股份有限公司 101 / 105 BC25 系列 AT 命令手册 备注 AT+CMEE= 命令禁用（=0）或使能（=1）使用最终结果代码 +CME ERROR: 。当 =1 时，发生错误时，将返回一组有限的错误代码。 上海移远通信技术股份有限公司 102 / 105 BC25 系列 AT 命令手册 16 附录 表 12：参考文档 文档名称 [1] Quectel_BC25&BC32 系列_TCP(IP)_应用指导 [2] Quectel_BC25&BC32_OneNET_应用指导 [3] Quectel_BC25&BC32_CMDMP_应用指导 [4] Quectel_BC25 系列_中国电信物联网平台应用指导 [5] Quectel_BC25&BC32 系列_DFOTA_应用指导 [6] Quectel_BC25&BC32_MQTT_应用指导 [7] Quectel_BC25&BC32 系列_FILE_应用指导 表 13：术语和缩写 缩写 3GPP APN ARQ BCCH BCD DCE DL-SCH DTE EARFCN 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 Access Point Name 接入点名称 Automatic Repeat reQuest 自动重传请求 Broadcast Control Channel 广播控制信道 Binary Coded Decimal 二进码十进数 Data Circuit-terminating equipment 数据电路终接设备 Downlink Shared Channel 下行共享信道 Data Terminal Equipment 数据终端设备 E-UTRAN Absolute Radio Frequency E-UTRAN 绝对无线频道编号 Channel Number 上海移远通信技术股份有限公司 103 / 105 eDRX EPCO EPS ESM GGSN GMT GPRS HARQ HPLMN ICCID IMEI IMSI IMEISV IRQ MAC MS NB-IoT PCO PDP PLMN PS PSM RLC RLC AM RRC RSRP BC25 系列 AT 命令手册 Extended Discontinuous Reception 扩展非连续性接收 Extended Protocol Configuration Options 扩展协议配置选项 Evolved Packet System 演进的分组系统 EPS Session Management EPS 会话管理 Gateway GPRS Support Node 网关 GPRS 支持节点 Greenwich Mean Time 格林尼治标准时间 General Packet Radio Service 通用分组无线服务技术 Hybrid Automatic Repeat reQuest 混合自动重传请求 Home Public Land Mobile Network 本地公用陆地移动网络 Integrate Circuit Card Identity 集成电路卡识别码 International Mobile Equipment Identity 国际移动设备识别码 International Mobile Subscriber Identity 国际移动用户识别码 International Mobile Equipment Identity and 国际移动用户识别码及软件版本 Software Version Interrupt Request 中断请求 Media Access Control Address 媒体访问控制地址 Mobile Station 移动台 Narrow Band Internet of Thing 窄带物联网 Protocol Configuration Options 协议配置选项 Packet Data Protocol 分组数据协议 Public Land Mobile Network 公共陆地移动网络 Packet Switch 分组交换 Power Saving Mode 省电模式 Radio Link Control 无线链路控制（层） RLC Acknowledge Mode RLC 确认模式 Radio Resource Control 无线资源控制 Reference Signal Receive Power 参考信号接收功率 上海移远通信技术股份有限公司 104 / 105 RSRQ RSSI RxQual SVN TA TE UDP UE UICC UL-SCH URC UUID Reference Signal Receive Quality Received Signal Strength Indication Receive Quality Software Version Number Terminal Adapter Terminal Equipment User Datagram Protocol User Equipment Universal Integrated Circuit Card Uplink Shared Channel Unsolicited Result Code Universally Unique Identifier BC25 系列 AT 命令手册 参考信号接收质量 接收信号强度指示 接收质量 软件版本 终端适配器 终端设备 用户数据报协议 用户设备 通用集成电路卡 上行共享信道 非请求结果码 通用唯一识别码 上海移远通信技术股份有限公司 105 / 105

BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 NB-IoT 模块系列 版本：1.1 日期：2020-11-17 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 文档历史 修订记录 版本 1.0 日期 2019-12-04 1.1 2020-11-17 作者 王成钧/ 刘强 刘强 变更描述 初始版本 1. 添加 AT+CNEC 命令。 2. 添加 AT+QSREGENABLE 命令。 3. 添加 AT+CEREG 命令的备注。 4. 添加 8.5 章节关于 RAI 的举例。 5. 删除 AT+QCHIPINFO 命令。 6. 更新 AT+QLWEVTIND 命令。 7. 更新 AT+NFWUPD 命令参数值 2 的响应结果。 8. 添加 AT+NSOSTEX（第 4.42 章节）、AT+NSOSTFEX （第 4.43 章节）和 AT+NSOSDEX（第 4.44 章节）命 令 上海移远通信技术股份有限公司 2 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 1.1. 定义 ............................................................................................................................................ 9 1.2. AT 命令语法 ............................................................................................................................... 9 1.3. AT 命令响应 ............................................................................................................................. 10 1.4. 3GPP ........................................................................................................................................ 10 2 3GPP 命令（27.007） ........................................................................................................................ 11 2.1. ATI 显示产品标识信息 ........................................................................................................... 11 2.2. ATE 设置命令的回显模式 ...................................................................................................... 12 2.3. AT+CGMI 请求制造商标识 .................................................................................................... 13 2.4. AT+CGMM 请求制造商型号 .................................................................................................. 14 2.5. AT+CGMR 请求制造商版本号............................................................................................... 15 2.6. AT+CGSN 请求产品序列号 ................................................................................................... 16 2.7. AT+CEREG EPS 网络注册状态 ............................................................................................ 17 2.8. AT+CSCON 信令连接状态 .................................................................................................... 21 2.9. AT+CLAC 列出可用命令 ....................................................................................................... 23 2.10. AT+CSQ 获取信号强度指示 .................................................................................................. 24 2.11. AT+CGPADDR 显示 PDP 地址 ............................................................................................. 25 2.12. AT+COPS PLMN 选择 .......................................................................................................... 27 2.13. AT+CGATT PS 附着与去附着 ............................................................................................... 29 2.14. AT+CGACT 激活或去激活 PDP 上下文 ................................................................................ 30 2.15. AT+CIMI 请求国际移动用户识别码 ....................................................................................... 32 2.16. AT+CGDCONT 定义 PDP 上下文 ......................................................................................... 33 2.17. AT+CFUN 设置 UE 功能 ....................................................................................................... 36 2.18. AT+CMEE 上报 UE 错误 ....................................................................................................... 38 2.19. AT+CCLK 返回当前日期和时间............................................................................................. 39 2.20. AT+CPSMS 设置省电模式 .................................................................................................... 40 2.21. AT+CEDRXS 设置 eDRX ...................................................................................................... 42 2.22. AT+CEER 扩展错误报告 ....................................................................................................... 45 2.23. AT+CEDRXRDP 读取动态 eDRX 参数 ................................................................................. 46 2.24. AT+CTZR 设置时区上报 ....................................................................................................... 48 2.25. AT+CIPCA 初始 PDP 上下文激活 ......................................................................................... 50 2.26. AT+CGAPNRC APN 速率控制.............................................................................................. 52 2.27. AT+CSODCP 通过控制面发送始端数据 ............................................................................... 53 2.28. AT+CRTDCP 通过控制面上报终端数据................................................................................ 55 2.29. AT+CGCONTRDP 查询 PDP 上下文的动态参数.................................................................. 56 2.30. AT+CGAUTH 定义 PDP 上下文鉴权参数.............................................................................. 58 2.31. AT+CNMPSD 指示无更多 PS 数据 ....................................................................................... 60 上海移远通信技术股份有限公司 3 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.32. AT+CPIN 输入 PIN 码............................................................................................................ 61 2.33. AT+CPINR 查询剩余 PIN 的重试次数 ................................................................................... 62 2.34. AT+CCHO 打开逻辑信道 ...................................................................................................... 63 2.35. AT+CCHC 关闭逻辑信道....................................................................................................... 65 2.36. AT+CGLA 通用 UICC 逻辑信道访问 ..................................................................................... 66 2.37. AT+CRSM 受限 SIM 卡访问.................................................................................................. 67 2.38. AT+CSIM 通用 SIM 卡访问 ................................................................................................... 69 2.39. AT+CGDATA 进入数传状态 .................................................................................................. 70 2.40. AT+CCIOTOPT CIoT 优化配置............................................................................................. 72 2.41. AT+CGCMOD 修改 PDP 上下文 ........................................................................................... 74 2.42. AT+CGEQOS 定义 EPS Qos................................................................................................ 76 2.43. AT+CGTFT 设置 TFT ............................................................................................................ 78 2.44. AT+CNEC 报告网络错误码 ................................................................................................... 81 3 3GPP 命令 (27.005) ........................................................................................................................... 84 3.1. AT+CSMS 选择短信服务....................................................................................................... 84 3.2. AT+CNMA 发送新消息确认................................................................................................... 86 3.3. AT+CSCA 设置短信服务中心地址 ........................................................................................ 87 3.4. AT+CMGS 发送短信.............................................................................................................. 88 3.5. AT+CMGC 发送短信命令 ...................................................................................................... 90 3.6. AT+CMMS 发送更多信息 ...................................................................................................... 91 4 一般命令 .............................................................................................................................................. 93 4.1. AT+NRB 重启 UE .................................................................................................................. 93 4.2. AT+NUESTATS 查询 UE 统计信息....................................................................................... 93 4.3. AT+NEARFCN 指定搜索频点................................................................................................ 99 4.4. AT+NSOCR 创建 Socket..................................................................................................... 100 4.5. AT+NSOST 发送消息（仅限 UDP）................................................................................... 102 4.6. AT+NSOSTF 发送带标志的消息（仅限 UDP） .................................................................. 103 4.7. AT+NQSOS 查询待处理的 Socket 消息清单 ...................................................................... 104 4.8. AT+NSORF 读取消息.......................................................................................................... 105 4.9. AT+NSOCO 连接命令（仅限 TCP） .................................................................................. 107 4.10. AT+NSOSD 发送消息（仅限 TCP）................................................................................... 107 4.11. AT+NSOCL 关闭 Socket ..................................................................................................... 109 4.12. AT+NSONMI 指示已到达 Socket 的消息 ............................................................................ 109 4.13. +NSOCLI 关闭 Socket 指示（仅用于响应） ....................................................................... 111 4.14. AT+NPING 测试到远程主机的 IP 网络连接......................................................................... 112 4.15. AT+NBAND 设置支持的频段............................................................................................... 113 4.16. AT+NLOGLEVEL 设置调试日志级别 .................................................................................. 114 4.17. AT+NCONFIG 配置 UE 行为............................................................................................... 116 4.18. AT+NATSPEED 配置 UART 端口波特率 ............................................................................ 120 4.19. AT+NCCID 识别 USIM 卡.................................................................................................... 122 4.20. AT+NFWUPD 通过 UART 更新固件 ................................................................................... 123 4.21. AT+NPOWERCLASS 设置 Band 和 Power Class 的映射 .................................................. 124 4.22. AT+NPSMR 省电模式状态上报........................................................................................... 126 上海移远通信技术股份有限公司 4 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.23. AT+NPTWEDRXS 设置 PTW 和 eDRX .............................................................................. 127 4.24. AT+NPIN PIN 操作 .............................................................................................................. 130 4.25. AT+NCSEARFCN 清除存储的频点 ..................................................................................... 131 4.26. AT+NIPINFO 上报 IP 地址信息 ........................................................................................... 132 4.27. AT+NCPCDPR 配置要读取的 PDP 上下文动态参数 .......................................................... 134 4.28. AT+NQPODCP 通过控制面查询待处理的原始数据列表..................................................... 135 4.29. AT+NITZ 设置时间更新模式................................................................................................ 136 4.30. AT+QLEDMODE 设置 NETLIGHT 功能模式....................................................................... 138 4.31. AT+QIDNSCFG 配置 DNS 服务器地址............................................................................... 139 4.32. AT+QDNS 触发 DNS 域名解析 ........................................................................................... 140 4.33. AT+QCFG 扩展配置设置..................................................................................................... 141 4.33.1. AT+QCFG='LWM2M/Lifetime' 配置 OceanConnect IoT 平台注册生命周期........... 142 4.33.2. AT+QCFG='LWM2M/EndpointName' 配置接入 IoT 平台时的端点名称 ................. 143 4.33.3. AT+QCFG='LWM2M/BindingMode' 配置接入 IoT 平台时的绑定模式 .................... 144 4.34. AT+NSNPD 发送 Non-IP 数据............................................................................................. 145 4.35. AT+NRNPDM 设置 Non-IP 数据模式上报........................................................................... 146 4.36. AT+NQPNPD 查询待处理的 Non-IP 数据列表.................................................................... 148 4.37. AT+NSOSTATUS 获取 Socket 状态 ................................................................................... 149 4.38. AT+NCIDSTATUS 获取状态 ...................................................................................... 151 4.39. AT+NGACTR 上报 PDP 上下文激活或去激活结果 ............................................................. 152 4.40. AT+NUICC 设置 UICC 功耗模式 ......................................................................................... 154 4.41. AT+QSREGENABLE 配置电信/联通自注册........................................................................ 155 4.42. AT+NSOSTEX 发送消息（仅限 UDP）.............................................................................. 157 4.43. AT+NSOSTFEX 发送带标志位的消息（仅限 UDP） ......................................................... 158 4.44. AT+NSOSDEX 发送消息（仅限 TCP）.............................................................................. 160 5 LwM2M 物联网平台命令................................................................................................................... 163 5.1. AT+NCDP 配置和查询 CDP 服务器设置............................................................................. 163 5.2. AT+QSECSWT 设置数据加密模式 ..................................................................................... 164 5.3. AT+QSETPSK 设置 PSK ID 和 PSK ................................................................................... 165 5.4. AT+QLWSREGIND 注册控制.............................................................................................. 166 5.5. AT+QLWULDATA 发送数据................................................................................................ 167 5.6. AT+QLWULDATAEX 发送 CON/NON 消息 ........................................................................ 168 5.7. AT+QLWULDATASTATUS 查询 CON 消息发送状态 ......................................................... 169 5.8. AT+QLWFOTAIND 设置 DFOTA 升级模式......................................................................... 170 5.9. AT+QREGSWT 设置注册模式 ............................................................................................ 171 5.10. AT+NMGS 发送消息............................................................................................................ 172 5.11. AT+NMGR 接收消息 ........................................................................................................... 173 5.12. AT+NNMI 设置新消息指示 .................................................................................................. 174 5.13. AT+NSMI 发送消息指示 ...................................................................................................... 175 5.14. AT+NQMGR 查询已接收消息状态 ...................................................................................... 177 5.15. AT+NQMGS 查询发送的消息状态 ...................................................................................... 178 5.16. AT+NMSTATUS 消息注册状态 ........................................................................................... 179 5.17. AT+QLWEVTIND LwM2M 事件上报 ................................................................................... 180 5.18. AT+QRESETDTLS 重置 DTLS 模式 ................................................................................... 181 上海移远通信技术股份有限公司 5 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 5.19. AT+QDTLSSTAT 查询 DTLS 状态...................................................................................... 182 5.20. AT+QBOOTSTRAPHOLDOFF Bootstrap 延时时长 ........................................................... 183 5.21. AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP ............................................ 185 5.22. AT+QCRITICALDATA 查询是否可发送紧急数据................................................................ 186 5.23. AT+QSETBSPSK 配置 PSK ID 和 PSK 到 Bootstrap ......................................................... 187 5.24. AT+QBSSECSWT 设置 Bootstrap 加密模式....................................................................... 188 6 错误码 ............................................................................................................................................... 190 7 重启原因 ............................................................................................................................................ 193 8 举例 ................................................................................................................................................... 195 8.1. 附着网络 ................................................................................................................................. 195 8.1.1. 自动附着网络............................................................................................................... 195 8.1.2. 手动附着网络............................................................................................................... 196 8.2. 发送/接收/读取 UDP 信息....................................................................................................... 197 8.3. 发送/接收/读取 TCP 信息 ....................................................................................................... 197 8.4. OceanConnect IoT 平台相关举例 .......................................................................................... 198 8.4.1. 注册 OceanConnect IoT 平台...................................................................................... 198 8.4.1.1. 自动注册模式.................................................................................................... 198 8.4.1.2. 手动注册模式.................................................................................................... 199 8.4.2. 从 OceanConnect IoT 平台发送/接收数据 .................................................................. 199 8.4.3. 在 OceanConnect IoT 平台上升级固件 ....................................................................... 200 8.4.3.1. 通过 DFOTA 自动升级固件 .............................................................................. 200 8.4.3.2. 通过 DFOTA 手动升级固件 .............................................................................. 201 8.4.4. 使用 DTLS 注册 OceanConnect IoT 平台 ................................................................... 202 8.5. 释放辅助指示 (RAI) ............................................................................................................... 202 8.5.1. RAI 功能操作举例-R13 ............................................................................................... 203 8.5.1.1. 使用 Flag 发送 UDP 数据 ................................................................................. 203 8.5.1.2. 发送 LwM2M CON/NON 数据 ......................................................................... 204 8.5.2. RAI 功能操作举例-R14 ............................................................................................... 204 8.5.2.1. 发送 UDP 数据.................................................................................................. 205 8.5.2.2. 发送 LwM2M CON/NON 数据 ......................................................................... 205 9 附录 A 术语缩写 ................................................................................................................................ 207 上海移远通信技术股份有限公司 6 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 表格索引 表 1：指示模块更新状态的 URC.................................................................................................................. 8 表 2：AT 命令及响应类型 ............................................................................................................................ 9 表 3：通用错误码（27.007）................................................................................................................... 190 表 4：通用错误码（27.005）................................................................................................................... 190 表 5：特定错误码 ..................................................................................................................................... 191 表 6：重启原因显示.................................................................................................................................. 193 表 7：术语缩写 ......................................................................................................................................... 207 上海移远通信技术股份有限公司 7 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 1 引言 本文档详细介绍了移远通信 NB-IoT 模块系列 BC35-G、BC28 和 BC95 R2.0 支持的 AT 命令集。 模块开启后，将输出字符串 NeulOK。收到此字符串后，AT 命令处 理器将开始准备接收 AT 命令。 如果 BC35-G、BC28 或 BC95 R2.0 系列模块由于任何不正常上电顺序导致了重新开机，将在字符串 NeulOK 前输出一条消息，以表明重新启动的原因，详细信息请参考第 7 章。 如果外部 MCU 介入模块 DFOTA 固件更新过程，模块将输出 URC 通知外部 MCU 当前的更新状态。 对于文档中提到的命令重启生效，重启的方式均为执行 AT+NRB 命令重启。 表 1：指示模块更新状态的 URC URC 描述 FIRMWARE DOWNLOADING 指示模块正在下载固件。 FIRMWARE DOWNLOAD FAILED 指示固件下载失败。 FIRMWARE DOWNLOADED 指示固件下载完成。 FIRMWARE UPDATING FIRMWARE UPDATE SUCCESS FIRMWARE UPDATE FAILED FIRMWARE UPDATE OVER 指示模块正在升级固件。 指示固件升级成功，但是升级状态尚未上报 给固件包服务器。 指示固件升级失败。 指示固件升级成功，且升级状态已上报给固 件包服务器（输出该URC后，升级完成）。 备注 在更新过程中，在报告 FIRMWARE UPDATE OVER 之前，请勿对模块进行操作（例如，不可执行 AT+NRB 命令关闭模块），否则将发生错误。 上海移远通信技术股份有限公司 8 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅示出响应，省略 。 AT 命令的语法及响应类型如下表所示： 表 2：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 可以用分号（';'）将多个命令放在同一行。此时只有第一个命令带有'AT'前缀。命令可以是大写 或小写。 输入 AT 命令时，将忽略空格，但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内 ⚫ 在 AT 命令名称中的'='、'?'或'=?'内 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 上海移远通信技术股份有限公司 9 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.3. AT 命令响应 当 AT 命令处理器处理完一条命令后，将响应 OK、ERROR 或 +CME ERROR: ，表示已经准 备接收新命令。在返回最终的 OK，ERROR 或 +CME ERROR: 之前，会发送请求的响应消息。 在使用 AT 命令过程出现错误时，若返回 +CME ERROR: ，请参考第 6 章，查找 错误 码。 AT 命令响应的格式为： +CMD1: OK 或者 OK 1.4. 3GPP 本文档命令遵从 3GPP TS 27.007 v14.3.0 (2017-03)。 上海移远通信技术股份有限公司 10 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2 3GPP 命令（27.007） 2.1. ATI 显示产品标识信息 该命令返回产品标识信息。 ATI 显示产品标识信息 执行命令 ATI 最大响应时间 特性说明 响应 Quectel Revision: OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 设备型号 软件版本号 整型。错误码。详情参见第 6 章。 举例 ATI Quectel BC35-G Revision:BC35GJBR01A01 OK 上海移远通信技术股份有限公司 11 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 备注 本文中所述 R01 固件指固件版本号中含有'R01'的固件版本，例如上例中'BC35GJBR01A01'，对 应 B300SPx 基线版本；R02 固件指固件版本号中含有'R02'的固件版本，例如'BC35GJBR02A03'， 对应 B500SPx 基线版本。 2.2. ATE 设置命令的回显模式 该命令设置是否从外接 MCU 接收 UE 回显字符。 ATE 设置命令的回显模式 执行命令 ATE 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 0 关闭回显模式 1 开启回显模式 整型。错误码。详情参见第 6 章。 举例 ATE0 OK ATI Quectel BC35-G Revision: BC35GJBR01A01 OK ATE1 OK 上海移远通信技术股份有限公司 12 / 210 ATI ATI Quectel BC35-G Revision: BC35GJBR01A01 OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.3. AT+CGMI 请求制造商标识 该命令返回制造商信息，在标准平台下，将默认返回 Quectel。 AT+CGMI 请求制造商标识 执行命令 AT+CGMI 响应 OK 测试命令 AT+CGMI=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 制造商信息。信息文本（包括行终止符在内）的字符总数不超过 2048，且不包含 0 或 OK 序列。 整型。错误码。详情参见第 6 章。 举例 AT+CGMI Quectel OK 上海移远通信技术股份有限公司 13 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.4. AT+CGMM 请求制造商型号 该命令返回制造商型号信息。 AT+CGMM 请求制造商型号 执行命令 AT+CGMM 测试命令 AT+CGMM=? 最大响应时间 特性说明 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 制造商型号信息。信息文本（包括行终止符在内）的字符总数不应超过 2048，且不包 含 0 或 OK 序列。 整型。错误码。详情参见第 6 章。 举例 AT+CGMM BC35GJB-02-STD OK 上海移远通信技术股份有限公司 14 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.5. AT+CGMR 请求制造商版本号 该命令返回制造商版本号。该命令默认返回发布和编译的固件版本（包括核及对应的版本号）。 该执行命令返回一行或多行 。 AT+CGMR 请求制造商版本号 执行命令 AT+CGMR 响应 OK 测试命令 AT+CGMR=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 制造商版本号。信息文本（包括行终止符在内）的字符总数不应超过 2048，且不包含 0 或 OK 序列。此参数的格式可能会改变。 整型。错误码。详情参见第 6 章。 举例 AT+CGMR SSB,V150R100C10B200SP1 SECURITY_A,V150R100C20B300SP2 PROTOCOL_A,V150R100C20B300SP2 APPLICATION_A,V150R100C20B300SP2 SECURITY_B,V150R100C20B300SP2 RADIO,Hi2115_RF1 上海移远通信技术股份有限公司 15 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 OK AT+CGMR=? OK 备注 本 文 中 所 述 B300SPx 基 线 指 基 线 版 本 号 中 含 有 ' B300SPx ' 的 基 线 版 本 ， 例 如 上 例 中 'V150R100C20B300SP2'，对应 R01 固件；B500SPx 基线指基线版本号中含有'B500SPx'的基线 版本，例如'V150R100C20B500SP3'，对应 R02 固件。 2.6. AT+CGSN 请求产品序列号 该命令返回 IMEI 号及相关信息。对于不支持 的 UE，仅返回 OK。 AT+CGSN 请求产品序列号 执行命令 AT+CGSN[=] 响应 =0（或者省略）且命令执行成功时： =1 且命令执行成功时： +CGSN: =2 且命令执行成功时： +CGSN: =3 且命令执行成功时： +CGSN: OK 测试命令 AT+CGSN=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 UE 支持且命令执行成功时： +CGSN:(支持的列表) OK 上海移远通信技术股份有限公司 16 / 210 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 UE 不支持时： OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。被请求的序列号类型。 0 返回 1 返回 IMEI 号 2 返回 IMEISV 号 3 返回 SVN UE 的 128 位 UUID。信息文本（包括行终止符在内）的字符总数不应超过 2048，且不 包含 0 或 OK 序列。 十进制格式的字符串类型。IMEI 号 十进制格式的字符串类型。IMEISV 号 十进制格式的字符串类型。当前 SVN（SVN 是 IMEISV 的一部分） 整型。错误码。详情参见第 6 章。 举例 AT+CGSN=1 +CGSN:490154203237511 OK //请求 IMEI 号 2.7. AT+CEREG EPS 网络注册状态 设置命令用于设置 EPS 网络注册状态 URC 的显示：=1 设置在 E-UTRAN 中 UE 的 EPS 网络注册 状态发生改变时的 URC +CEREG: 的显示；=2 设置在 E-UTRAN 中的网络小区发生改变时的 URC +CEREG: [,[],[],[]] 的显示。参数 、 和 只有在可用时才 会上报。在 =2 的基础上，如果可用，=3 设置当 的值改变时在 URC 显示更多参数 和 。 =4 设置当 UE 请求 PSM 减少其功率消耗时的 URC +CEREG: [,[],[],[][,[< 上海移远通信技术股份有限公司 17 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 cause_type>],[][,[],[]]]] 的显示。 当 =4 时，如果 E-UTRAN 的小区发生改变，URC 将向 UE 提供附加的 active-time 值及扩展周期 性 TAU 值信息。当 =5 时，如果 的值发生改变，URC 将会比 =4 时多上报 和 参数。 参数 、、、、、 与 只有在可用时才会上报。 查询命令会返回结果码的显示状态和整数型参数 ，显示 UE 是否已经注册当前网络。如果可用， 位 置 信 息 参 数 、 与 ， 仅 在 =2 且 UE 已 注 册 网 络 时 上 报 。 如 果 参 数 [,,] 可用，当 =3 时返回。 AT+CEREG EPS 网络注册状态 设置命令 AT+CEREG= 响应 OK 查询命令 AT+CEREG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 =0、1、2 或 3 且命令执行成功时： +CEREG:,[,[],[],[[,, ]]] =4 或 5 且命令执行成功时： +CEREG:,[,[],[],[] [,[],[][,[],[]]]] OK 测试命令 AT+CEREG=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEREG:(支持的列表) OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 18 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。 0 禁用网络注册 URC 1 使能网络注册 URC：+CEREG: 2 使能网络注册与位置信息 URC：+CEREG:[,[],[],[]] 3 使能网络注册、位置信息和 EMM 原因值 URC： +CEREG:[,[],[],[][,,]] 4 对于请求 PSM 的 UE，使能网络注册和位置信息 URC： +CEREG:[,[],[],[][,,[,[],[]]]] 5 对于请求 PSM 的 UE，使能网络注册、位置信息和 EMM 原因值 URC： +CEREG:[,[],[],[][,[],[][,[< Active-Time>],[]]]] 整型。EPS 注册状态。 0 未注册，UE 目前未搜索运营商进行注册 1 已注册，本地网络 2 未注册，但 UE 目前正在连接或搜索运营商进行注册 3 注册被拒绝 4 未知（例如不在 E-UTRAN 范围内） 5 已注册，漫游网络 字符串类型。十六进制 2 字节跟踪区域代码（例如'00C3'等于十进制的 195）。 字符串类型。十六进制 4 字节的 E-UTRAN 小区 ID。 整型。服务小区的接入技术。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 整型。 类型。 0 表示 包含一个 EMM 原因值 1 表示 包含一个特定制造商的原因值 整型。包含注册失败的原因。该参数的类型由 定义。 字符串类型。8 位格式的一个字节。表示在 E-UTRAN 中分配给 UE 的 Active-time 值 （T3324）。Active-time 值编码为 GPRS Timer 2 信息元素的一个字节（octet 3），编 码为位格式（例如'00100100'等于 4 分钟）。 关于编码和值范围，请参考 3GPP TS 24.008、3GPP TS 23.682 和 3GPP TS 23.401。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器的值单位，定义如下： 位数 上海移远通信技术股份有限公司 19 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 该值表示定时器被停用 在此版本的 3GPP 协议中，其他值应以 1 分钟的倍数递增。 字符串类型。8 位格式的一个字节。表示在 E-UTRAN 中分配给 UE 的扩展周期性 TAU 值（T3412）。扩展的周期 TAU 值，编码为 GPRS Timer 3 信息元素的一个字节（octet 3），编码为位格式（例如'01000111'等于 70 小时）。 对于编码和值范围，请参考 3GPP TS 24.008、3GPP TS 23.682 和 3GPP TS 23.401。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器值单位，定义如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增 1 1 1 该值表示定时器被停用 整型。错误码。详情参见第 6 章。 备注 1. 仅当改变时，上报网络注册状态 URC。 2. 如 果 AT+NCONFIG 中 的 配 置 项 T3324_T3412_EXT_CHANGE_REPORT 为 true ， 当 或定时器改变时，显示 AT+CEREG=5 的 URC。 举例 AT+CEREG=1 OK AT+CEREG? +CEREG:1,1 OK AT+CEREG=? +CEREG:(0,1,2,3,4,5) OK //使能网络注册 URC。 上海移远通信技术股份有限公司 20 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.8. AT+CSCON 信令连接状态 该命令返回 UE 感知到的无线连接状态（即和基站的连接）的详细信息，并返回当前状态的指示。该状 态仅在无线事件发生时更新，例如发送和接收数据。因此，当前返回的状态可能已经过时。即使在返回状 态 =1（已连接）的情况下，因为连接质量的变化，模块仍可能无法使用基站。 设置命令控制 URC 的显示。 UE 处于 E-UTRAN 网络时，当没有 PS 信令连接时，UE 为空闲模式；当 UE 与网络间的 PS 信令连接 建立时，UE 为连接模式。 UE 处于 E-UTRAN 网络时， 的值表示 UE 的状态。 查询命令返回结果码的显示状态和整型参数 。 指示 UE 当前为空闲模式或者连接模 式。 AT+CSCON 信令连接状态 设置命令 AT+CSCON= 响应 OK 查询命令 AT+CSCON? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCON:, OK 测试命令 AT+CSCON=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCON:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 21 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。表示使能/禁用 URC。 0 禁用 URC 1 使能 URC：+CSCON: 整型。表示信令连接状态。 0 空闲 1 已连接 2-255 保留待用 整型。错误码。详情参见第 6 章。 举例 AT+CSCON=0 OK AT+CSCON? +CSCON:0,1 OK AT+CSCON=? +CSCON:(0,1) OK AT+CSCON=1 OK AT+CSCON? +CSCON:1,1 OK 上海移远通信技术股份有限公司 22 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.9. AT+CLAC 列出可用命令 该命令用于查询可用命令清单。执行命令会让 UE 返回一行或多行 AT 命令。本命令仅返回用户可用的 AT 命令。 AT+CLAC 列出可用命令 执行命令 AT+CLAC 响应 [] [...] OK 测试命令 AT+CLAC=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 举例 AT+CLAC AT+COPS AT+CGATT ... AT+NSOCR AT+NSOST 表示定义包括前缀 AT 在内的 AT 命令。文本不包含 0 或 OK。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 23 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 … OK 2.10. AT+CSQ 获取信号强度指示 该执行命令返回从 UE 接收到的信号强度指示 和信道误码率 。 测试命令返回所支持参数的范围。 AT+CSQ 获取信号强度指示 执行命令 AT+CSQ 响应 +CSQ:, OK 测试命令 AT+CSQ=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSQ:(支持的列表),(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。表示接收到的信号强度。单位：dBm。 0 等于或小于-113dBm 1 -111dBm 2…30 -109dBm... -53dBm 上海移远通信技术股份有限公司 24 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 * 31 大于或等于-51dBm 99 未知或无法检测 整型。表示信道误码率（百分比）。 0...7 作为 RxQual 值（请参考 3GPP 规范） 99 未知或无法检测 整型。错误码。详情参见第 6 章。 备注 当前不支持 ，因此该值始终为 99。 举例 AT+CSQ +CSQ:31,99 OK 2.11. AT+CGPADDR 显示 PDP 地址 该命令返回设备 IP 地址。 设置命令返回指定 的 PDP 地址列表。如果没有指定 ，则返回所有已定义上下文的地址。 测试命令返回定义的 列表。这些 已被激活，可能有也可能没有与之关联的 IP 地址。 AT+CGPADDR 显示 PDP 地址 执行/设置命令 AT+CGPADDR[=[,[,...]]] 响应 +CGPADDR:[,[,]] [+CGPADDR:,[[,]]] [...]]] OK 测试命令 AT+CGPADDR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGPADDR:(已定义的列表) OK 上海移远通信技术股份有限公司 25 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 / 参数 和 整型。指定某个 PDP 上下文定义（请查看命令 AT+CGDCONT）。 范围：0~10。 字符串类型。在适用于 PDP 的地址空间识别 UE，地址可为静态 或动态。静态地址由命令 AT+CGDCONT 设定。动态地址在上 一次 PDP 上下文激活期间分配，使用 引用的上下文定义。 如果 和 的地址均不可用，则 省略；当分配 IPv4 及 IPv6 的地址时， 和 均被指定， 对应 IPv4 的地址， 对应 IPv6 的地址。 整型。错误码。详情参见第 6 章。 备注 1. 在双栈终端（=IPV4V6）， 对应 IPv6 的地址。对于单个 IPv6 堆栈终 端（=IPV6）或者因为向后兼容性，IPv6 地址也可包含在参数 中。 2. 使能 AUTOCONNECT 后，IP 地址获取之后才会列出 =0。 举例 AT+CGPADDR=0 +CGPADDR:0,101.43.5.1 OK AT+CGPADDR=? +CGPADDR:(0) OK 上海移远通信技术股份有限公司 26 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.12. AT+COPS PLMN 选择 设置命令强制尝试使用安装在当前所选卡槽中的 USIM 卡来选择和注册 EPS 网络运营商。参数 用来设置找网动作，是由 UE 自动完成，还是通过该命令以特定的接入方式 ，强制选择运 营商 （由 指定）。如果选择的运营商不可用，则不会选择其他运营商。如果选择的接 入技术不可用，则会在其他接入技术中选择相同的运营商。选定运营商名称的格式同样适用于查询命令 AT+COPS?。=2 强制尝试注销网络。所选模式会影响后续所有网络注册（例如，当设置 =2 后，只有在设置 =0 或 1 时 UE 才会注册网络）。尝试注册或注销时，此命令应该是可中止的。 查询命令返回当前模式、当前所选运营商以及当前接入技术。如果没有选择运营商，则不会返回 、 和 。 测试命令返回五个参数，表示网络中出现的运营商。指示当前运营商是否可用的整型参数 、运 营商的数字编码 、接入技术的数字编码 、注册模式 及运营商名称的格式 。以上参数可能不可用，不可用时为空字段。运营商清单应按此顺序排列：本地网络、USIM 中 选用的网络或 UICC（USIM）中的活动应用程序引用（顺序：HPLMN 选择器、用户控制的 PLMN 选择器、 运营商控制的 PLMN 选择器、USIM 中的 PLMN 选择器）以及其他网络。 选择接入技术的参数 仅应用于能够注册多种接入技术的终端。 的选择不会限制小区重 选的能力，即使已经尝试选择一种接入技术，UE 也可以在其他接入技术中重选小区。 AT+COPS PLMN 选择 设置命令 AT+COPS=[,[,[,]]] 查询命令 AT+COPS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS:[,,][,] OK 测试命令 AT+COPS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS:[(支持的,列表[,])][,,(支持的范围),(支持的列表)] 上海移远通信技术股份有限公司 27 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 630 秒 该命令立即生效。 不保存到 KV。 参数 整型 0 自动（省略 、 和 字段） 1 手动（包含 和 字段， 可选） 2 注销网络 =1 时，UE 重启后，将不会保留 PLMN 设置。=1 仅供研发使用；生产 环境使用 =0，此时 AUTOCONNECT 设置为 TRUE。 整型 2 为数字格式 字符串类型。 指示此参数格式是否为数字格式；数字格式是 NB-IoT 网络位 置区域标识号，由三位 BCD 数字 ITU-T 国家代码编码，加上两位或三位 BCD 数字网络 代码组成。=0 时， 参数不能出现 整型。运营商状态 0 未知 1 可用 2 当前 3 禁用 整型，接入技术设置。模块查询命令 AT+COPS?不会返回 。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 整型。错误码。详情参见第 6 章。 备注 此命令的测试命令只能在 RRC 断开状态（模块处于 Idle 或 PSM 模式）下执行，否则将返回错误。 举例 AT+COPS=0 OK 上海移远通信技术股份有限公司 28 / 210 AT+COPS? +COPS:0,2,'46000' OK AT+COPS=? +COPS:(2,,,'46000'),,(0-2),(2) OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.13. AT+CGATT PS 附着与去附着 该命令用于将 UE 附着于 PS 域或将 UE 从 PS 域去附着。命令执行后，UE 保持在 V.250 命令状态。 如果 UE 已经处于相同的 设置状态，则会忽略此命令，并返回 OK 响应。如果正在执行 AT+CGATT， 在附着或去附着注册步骤完成之前，再次执行此命令会返回错误。如果未达到请求状态，则会响应 ERROR 或 +CME ERROR: 。 当附着状态改为去附着状态时，活动的 PDP 上下文将自动停用。 查询命令返回当前 PS 域服务状态。 测试命令用于请求支持的 PS 域状态的信息。 AT+CGATT PS 附着与去附着 设置命令 AT+CGATT= 响应 OK 查询命令 AT+CGATT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGATT: OK 测试命令 AT+CGATT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGATT:(支持的列表) 上海移远通信技术股份有限公司 29 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 1 秒，由网络判定。 / 参数 整型，表示 PDP 上下文激活的状态。 0 去附着 1 附着 =1 时，自动设选择 AT+COPS=0。 整型。错误码。详情参见第 6 章。 备注 如果支持初始 PDP 上下文，启动时将自动定义 =0 的上下文。 举例 AT+CGATT? +CGATT:0 OK AT+CGATT=1 OK AT+CGATT=? +CGATT:(0,1) OK 2.14. AT+CGACT 激活或去激活 PDP 上下文 该命令用于激活或去激活指定的 PDP 上下文。该命令设置完成后，UE 保持在 V.250 命令状态。若任 意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；如果不能实现任意上下文的请求状态，将 返回 ERROR 或 +CME ERROR 响应。执行该命令的激活形式时，如果 UE 没有附着 PS，UE 首先会附着 上海移远通信技术股份有限公司 30 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 PS，然后尝试激活指定的上下文。如果附着失败，UE 则响应错误；或者，如果使能扩展错误响应，UE 则 响应相应的附着失败错误消息。对 EPS 而言，如果尝试断开与上一个 PDN 的连接，UE 则响应 ERROR， 或者如果使能扩展错误响应，则响应 +CME ERROR。 EPS 承载资源的激活请求由网络通过 EPS 专用承载激活或 EPS 承载修改请求来响应。UE 必须接受此 请求，PDP 上下文才可设置为建立状态。 查询命令返回所有定义的 PDP 上下文的当前激活状态。测试命令用于请求支持的 PDP 上下文激活状 态的信息。 AT+CGACT 激活或去激活 PDP 上下文 设置命令 AT+CGACT=, 响应 OK 查询命令 AT+CGACT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGACT:, [+CGACT:,] [...] OK 测试命令 AT+CGACT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGACT:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 1 秒，由网络判定。 / 上海移远通信技术股份有限公司 31 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 整型。表示 PDP 上下文的激活状态。 0 去激活 1 激活 整型。此参数指定某个 PDP 上下文定义（请参考 AT+CGDCONT）。一次只能激活或 去激活 1 个 。 整型。错误码。详情参见第 6 章。 备注 1. 如果支持初始 PDP 上下文，启动时将自动定义 =0 的上下文。 2. PLMN 搜索、附着和去附着时，不可执行该命令。 3. 当 UE 与核心网络都支持无 PDN 连接时，该命令可以断开最后一路 PDN 连接。 举例 AT+CGACT=0,1 OK AT+CGACT? +CGACT:1,0 OK AT+CGACT=? +CGACT:(0,1) OK 2.15. AT+CIMI 请求国际移动用户识别码 该命令返回国际移动用户识别码（无双引号的字符串）。 该执行命令使 UE 返回 ，目的是允许 TE 识别附着到 UE 的 USIM 卡或 UICC 中的活动应用。 AT+CIMI 请求国际移动用户识别码 执行命令 AT+CIMI 响应 OK 若出现任何错误： 上海移远通信技术股份有限公司 32 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+CIMI=? 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 国际移动用户识别码（无双引号的字符串）。 整型。错误码。详情参见第 6 章。 备注 开机后几秒之内可能无法显示 IMSI。 举例 AT+CIMI 460001357924680 OK 2.16. AT+CGDCONT 定义 PDP 上下文 此命令的设置命令为 标识的 PDP 上下文和本地上下文指定 PDP 上下文参数。因为 PCO 可包 含需要加密的信息，所以该命令也允许 TE 指定是否请求 ESM 信息的安全保护传输。UE 可能有其他原因 使用 ESM 信息的安全保护传输，例如需要转换 APN。测试命令的响应给出了可以同时处于定义状态的 PDP 上下文数量范围。 对 EPS 而言，设置该命令后会建立 PDN 连接并建立相关的默认承载。 AT+CGDCONT= 是设置命令的一种特殊形式，会使 的值变成未定义。 如果支持初始 PDP 上下文，则在启动时自动定义 =0 的上下文，可以使用 AT+CGDCONT 修改 =0 的参数。 上海移远通信技术股份有限公司 33 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 查询命令返回每个已定义上下文的当前设置。 测试命令返回支持的参数的范围。如果 UE 支持多种 PDP 类型，每个 的参数值范围会 在单独行返回。 AT+CGDCONT 定义 PDP 上下文 设置命令 AT+CGDCONT=[,[, [,[,[,[,[,[,[,[,[,< securePCO>]]]]]]]]]]] 查询命令 AT+CGDCONT? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGDCONT:[,[,[,[,< d_comp>[,[,[,[ ,[,[,[,]]]]]]]]]]] [...] OK 测试命令 AT+CGDCONT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGDCONT:(支持的范围),(支持的列表),,, (支持的列表),(支持的列表),,,,,(支持的< NSLPI>列表),(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效。 重启后只保存第 0 路的配置。 上海移远通信技术股份有限公司 34 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 整型。指定某个 PDP 上下文。这是 TE-UE 接口的本地参数，可以用在其他 PDP 上下文 相关的命令中。测试命令返回参数值的范围（最小值为 1；如果支持初始 PDP 上下文， 最小值为 0）。 网络发起的 PDP 上下文的一些 值会超出 AT+CGDCONT=? 测试命令所列的 值的范围。 支持的 值为 0-10。 当 AUTOCONNECT 设置为 TRUE 时，默认使用=0。 使能 BIP 时，不可将 的值设置为 7。 字符串类型。指定分组数据协议类型。 IP 网络协议（IETF STD 5 [103]） IPV6 网络协议，IPv6 IPV4V6 引入虚拟 处理双 IP 堆栈 UE 功能 NONIP 无 IP 字符串类型。表示逻辑名称，用于选择 GGSN 或外部 PDN。值为空或省略时，将请求 订阅值。 字符串的最大长度为 63 个字符。 整型。控制 PDP 数据压缩。 0 关闭 1 打开 （制造商首选压缩） 2 V.42bis 3 V.44 整型。控制 PDP 头压缩。 0 关闭 1 打开（制造商首选压缩） 2 RFC 1144 [105] （仅适用于 SNDCP） 3 RFC 2507 [107] 4 RFC 3095 [108] （仅只适用于 PDCP） 整型。为该 PDP 上下文请求的 NAS 信令优先级。 0 根据 UE 中配置的低优先级指示符的值激活此 PDP 上下文。 1 根据低优先级指示符设置为'NAS 信令低优先级 MS 未配置'，激活此 PDP 上下文。 UE 使用 3GPP TS 24.301 [83]和 3GPP TS 24.008 中提供的 NSLPI 信息。 整型。指定是否请求 PCO 的安全保护传输（适用于仅 EPS）。 0 不请求 PCO 的安全保护传输。 1 请求 PCO 的安全保护传输。 整型。错误码。详情参见第 6 章。 备注 1. 仅支持 IP、NONIP、IPV6 和 IPV4V6。 2. 此 命 令 仅 支 持 参 数 、 、 、 、 、 和 。 3. 的值仅支持 0。 的值仅支持 0 和 1。 上海移远通信技术股份有限公司 35 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 举例 AT+CGDCONT=? +CGDCONT:(0-10),('IP','NONIP','IPV6','IPV4V6'),,,(0),(0,1),,,,,(0,1),(0,1) OK AT+CGDCONT=1,'IP','HUAWEI.COM' OK AT+CGDCONT? +CGDCONT:0,'IPV4V6',,,0,0,,,,,0,0 +CGDCONT:1,'IP','HUAWEI.COM',,0,0,,,,,0,0 OK 2.17. AT+CFUN 设置 UE 功能 该命令选择 UE 的功能等级。'全部功能'等级对应高级别的功率。'最小功能'对应低级别的功率。 查询命令返回 的当前设置。 AT+ CFUN 设置 UE 功能 设置命令 AT+CFUN=[,] 响应 OK 查询命令 AT+CFUN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CFUN: OK 测试命令 AT+CFUN=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CFUN:(支持的列表),(支持的列表) OK 上海移远通信技术股份有限公司 36 / 210 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 85 秒 见参数说明。 参数 整型。UE 功能等级。 0 最小功能 1 全部功能。使 UE 能够收发所有支持的无线接入技术 RF 电路。对于支持 AT+CSRA 的 UE，这相当于命令 AT+CSRA=?响应的 RATs。目前 AT+CSRA 设置被忽略。当此设置生效时，收发 RF 电路不必处于禁用状态。在 成 功配置为 1 后，可以用 =0 或者其他方式关闭 UE。 整型。UE 重置。 0 在设置 功率级别之前不重置 UE。该参数缺省时为默认值。 1 在设置 功率级别之前重置 UE（暂不支持且被忽略）。 整型。错误码。详情参见第 6 章。 备注 系统不活动时将进入深度睡眠模式，但前提是网络已启用深度睡眠模式。 举例 AT+CFUN=? +CFUN:(0,1),(0,1) OK AT+CFUN=1 OK AT+CFUN? +CFUN:1 OK 上海移远通信技术股份有限公司 37 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.18. AT+CMEE 上报 UE 错误 该设置命令可以禁用或使能 +CME ERROR: 结果码，用于表示 UE 功能相关的错误。启用后， UE 相关错误会返回 +CME ERROR: 最终结果码，而不只是 ERROR。禁用后，当语法错误、无效 参数或 UE 功能相关错误时，会正常返回 ERROR。 查询命令返回参数 的当前设置。 AT+CMEE 上报 UE 错误 设置命令 AT+CMEE= 响应 OK 查询命令 AT+CMEE? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMEE: OK 测试命令 AT+CMEE=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMEE:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型，表示错误模式 0 禁用 +CME ERROR: 结果码，使用 ERROR。 上海移远通信技术股份有限公司 38 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 1 使能 +CME ERROR: 结果码，使用数值 错误码。 整型。错误码。详情参见第 6 章。 2.19. AT+CCLK 返回当前日期和时间 一旦 UE 连接到网络，将自动设置时钟。执行设置命令前请执行命令 AT+NITZ=0。 查询命令返回时钟的当前设置。 AT+CCLK 返回当前日期和时间 设置命令 AT+CCLK= 响应 OK 查询命令 AT+CCLK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCLK: OK 测试命令 AT+CCLK=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 该命令立即生效。 不保存到 KV。 参数 字符串类型。格式为'yy/MM/dd,hh:mm:ss±zz'，各字符分别表示年（最后两位数字）、月、 日、时、分、秒及时区（表示当地时间与 GMT 的时差，以 15 分钟为单位，范围为-96~+96）。 例如，1994 年 5 月 6 日，22:10:00 GMT+2 小时相当于'94/05/06,22:10:00+08'。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 39 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 备注 1. 如果 UE 不支持时区信息，那么命令 AT+CCLK? 将不会返回 的后三位字符'±zz'。 2. 核心网络发送 EMM INFORMATION 前不会返回任何值。 举例 AT+CCLK='18/11/09,05:36:42+32' OK AT+CCLK? +CCLK:18/11/09,05:36:42+32 OK AT+CCLK=? OK 2.20. AT+CPSMS 设置省电模式 该命令控制 UE 省电模式（PSM）参数的设置，可以用来控制 UE 是否应用 PSM。请参考 AT+CEREG 返回的 URC 查看激活时间值以及 E-UTRAN 分配给 UE 的扩展周期 TAU 值。 AT+CPSMS=2 是该命令的一种特殊形式，在这种形式下，将禁用 PSM，并删除已通过 AT+CPSMS 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 查询命令返回当前参数值。 AT+ CPSMS 设置省电模式 设置命令 AT+CPSMS=[,[,[,[,]]]] 查询命令 AT+CPSMS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPSMS:[,,,],[] OK 若出现任何错误： 上海移远通信技术股份有限公司 40 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+CPSMS=? 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 响应 +CPSMS:(支持的列表),,,(支持的范围),(支持的范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 字符串类型。禁用或使能 UE 的 PSM。 0 禁用 PSM 1 启用 PSM 2 禁用 PSM 并删除 PSM 的所有参数，如果有默认参数，则重置为默认。 字符串类型。8 位格式的一个字节。表示请求的将在 E-UTRAN 分配给 UE 的扩展周期性 TAU 值（T3412），且被编码为 GPRS Timer 3 信息的一个 字节（octet 3）（例如，'01000111'等于 70 小时）。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了定时器值的单位，定义如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增（备注） 1 1 1 该值表示定时器被停用 默认值为 10 小时。 字符串类型。8 位格式的一个字节。表示将分配给 UE 的请求激活时间值 （T3324），且被编码为 GPRS Timer 2 信息的一个字节（octet 3）（例 如，'00100100'等于 4 分钟）。 上海移远通信技术股份有限公司 41 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了 GPRS 定时器值的有效时间值单位，定义如下： 位数 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 表示定时器被停用的值 默认值为 10 秒。 整型。错误码。详情参见第 6 章。 备注 1. 该定时器值的单位仅适用于 T3412 扩展值 IE。如果以完整性保护消息的形式接收，那么将以 320 小 时的倍数解读接收到的值，否则，将以 1 小时的倍数解读。 2. AT+CPSMS? 查询命令目前只能获取模式值 0 和 1。 3. 目前不支持 和 参数，输入任何 值都将被忽略，也没有任何值输出。 举例 AT+CPSMS=1,,,01000011,01000011 OK AT+CPSMS? +CPSMS:1,,,01000011,01000011 OK AT+CPSMS=? +CPSMS:(0,1,2),,,( 00000000-11111111), (00000000-11111111) OK 2.21. AT+CEDRXS 设置 eDRX 设置命令控制 UE 的 eDRX 参数的设置，用于控制是否要应用 eDRX，以及每种指定接入技术类型的 请求 eDRX 值。 当 =2，且当网络提供的 eDRX 参数改变时，该命令也可设置是否上报 URC +CEDRXP:[,[,[,]]]。 AT+CEDRXS=3 为该命令的一种特殊形式。此形式的命令将禁用 eDRX，并删除已通过 AT+CEDRXS 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 上海移远通信技术股份有限公司 42 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 查询命令返回 的每个定义值的当前设置。 AT+CEDRXS 设置 eDRX 设置命令 AT+CEDRXS=,[,< Requested_eDRX_value>] 查询命令 AT+CEDRXS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXS:, OK 测试命令 AT+CEDRXS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXS:(支持的列表),(支持的列表), (支持的范围) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。启用或禁用 eDRX。该参数适用于所有指定的接入技术类型，即 的最 新设置将对 的所有指定值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并启用 URC： +CEDRXP:[,[,[,]]] 上海移远通信技术股份有限公司 43 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 3 禁用 eDRX 并删除 eDRX 的所有参数 整型。接入技术类型。 0 接入技术未使用 eDRX，该参数值仅在 URC 中使用 5 E-UTRAN（NB-S1 模式） 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗口时长 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 上海移远通信技术股份有限公司 44 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详情参见第 6 章。 备注 在 B300SP5 或后续版本中，默认使能 UE 的 eDRX。 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS:5,'0101' OK AT+CEDRXS=? +CEDRXS:(0,1,2,3),(5),('0000'-'1111') OK AT+CEDRXS=0,5 OK 2.22. AT+CEER 扩展错误报告 该执行命令让 UE 返回一行或多行由 UE 制造商确定的信息文本 ，这应该为 UE 的用户提供 一份错误原因的扩展报告，错误类型如下： ⚫ 上一次呼叫释放失败 ⚫ 上一次 PDP 上下文激活失败 ⚫ PDP 上下文去激活失败 通常，文本将由单行组成，包含网络给出文本格式原因信息。 AT+CEER 扩展错误报告 执行命令 AT+CEER 响应 +CEER: 上海移远通信技术股份有限公司 45 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+CEER=? 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 该命令立即生效。 不保存到 KV。 参数 扩展错误报告。信息文本（包括行终止符在内）的字符总数不超过 2041。文本不包含 0 或 OK 序列。 整型。错误码。详情参见第 6 章。 举例 AT+CEER +CEER:EMM_CAUSE_EPS_AND_NON_EPS_SERVICES_NOT_ALLOWED OK AT+CEER=? OK 2.23. AT+CEDRXRDP 读取动态 eDRX 参数 当 eDRX 用于 UE 当前注册的小区时，该执行命令返回 、、 和 。 如果 UE 当前注册的小区未使用 eDRX，则返回 =0。 AT+CEDRXRDP 读取动态 eDRX 参数 执行命令 AT+CEDRXRDP 响应 +CEDRXRDP:[,[,[,]]] OK 上海移远通信技术股份有限公司 46 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+CEDRXRDP=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 整型。接入技术类型。AT+CEDRXS? 用于指定接入技术类型与请求的 eDRX 值之 间的关系。 0 接入技术未使用 eDRX。该参数值仅在 URC 中使用。 5 E-UTRAN（NB-S1 模式） 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 上海移远通信技术股份有限公司 47 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗口长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.3 6 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详情参见第 6 章。 举例 AT+CEDRXRDP +CEDRXRDP:5,'0010','1110','0101' OK AT+CEDRXRDP=? OK 2.24. AT+CTZR 设置时区上报 设置命令控制时区变化事件上报。启用上报后，一旦时区发生改变，UE 将返回 URC +CTZV:、 +CTZE:,,[]或+CTZEU:,,[]。如果网络提供时区，则 UE 会在网络注册 时提供时区。如果因 UE 错误导致设置失败，则返回 +CME ERROR: 。 查询命令返回 UE 当前已设置的报告设置。 AT+CTZR 设置时区上报 设置命令 AT+CTZR= 响应 OK 上海移远通信技术股份有限公司 48 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 查询命令 AT+CTZR? 测试命令 AT+CTZR=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CTZR: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CZTR:(支持的 列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。上报状态 0 禁用时区变化事件 URC 上报 1 启用时区变化通过 URC +CTZV:上报 2 启用扩展时区和本地时间通过 URC +CTZE:,,[] 上报 3 启用扩展时区和世界时通过 URC +CTZEU:,,[] 上报 字符串类型。表示本地时区（当地时间与 GMT 的时差以 15 分钟为单位）加上夏令时的 总和，格式为'±zz'。长度固定，即两位整数，范围为-48~+56。为保持两位，范围在 -9~+9 之间的数字均以 0 开头，例如'-09'、'+00'和'+09'。 整型。指示 是否包含夏令时调整。 0 不包含夏令时调整 1 包括增加 1 小时（相当于 中的 4 个 15 分钟）的夏令时调整 2 包括增加 2 小时（相当于 中的 8 个 15 分钟）的夏令时调整 字符串类型。表示当地时间。格式为'YYYY/MM/DD,hh:mm:ss'，以整数形式分别表示年 （YYYY）、月（MM）、日（DD）、时（hh）、分（mm）和秒（ss）。如果核心网提供世 上海移远通信技术股份有限公司 49 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 界时间，UE 可以从网络传输时区信息时提供的信息中得出本地时间，并以 URC 上报扩 展时区和本地时间。 字符串类型。表示世界时间。格式为'YYYY/MM/DD,hh:mm:ss'，以整数形式分别表示年 （YYYY）、月（MM）、日（DD）、时（hh）、分（mm）和秒（ss）。如果核心网提供世 界时间，在网络传输时区信息时可以得到世界时间，并以 URC 上报扩展时区和世界时间。 整型。错误码。详情参见第 6 章。 举例 AT+CTZR=0 OK AT+CTZR? +CTZR:0 OK AT+CTZR=? +CTZR:(0,1,2,3) OK 2.25. AT+CIPCA 初始 PDP 上下文激活 设置命令用于控制 UE 在是否有 PDN 连接的情况下连接到 E-UTRAN。当 =3 时适用于 E-UTRAN RATs。改变参数 的值不会引起 PDP 上下文去激活。 当参数 =1 时，表示在没有 PDN 连接的情况下进行 EPS 附着。 查询命令会返回命令的当前设置情况。 AT+CIPCA 初始 PDP 上下文激活 设置命令 AT+CIPCA=[,] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 查询命令 AT+CIPCA? 响应 +CIPCA:[,] OK 上海移远通信技术股份有限公司 50 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+CIPCA=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CIPCA:(支持的列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。附着时激活 PDP 上下文。 3 不改变当前设置 整型。表示 EPS 附着是否有 PDN 连接。缺省值为 0。 0 表示 EPS 附着时有 PDN 连接 1 表示 EPS 附着时没有 PDN 连接 整型。错误码。详情参见第 6 章。 备注 对于该命令，术语漫游表示注册到了一个不同于 HPLMN 和 EHPLMN 的 VPLMN 网络。 举例 AT+CIPCA=3 OK AT+CIPCA=? +CIPCA:(3),(0,1) OK 上海移远通信技术股份有限公司 51 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.26. AT+CGAPNRC APN 速率控制 执行命令返回与对应上下文标识符 关联的 APN 速率控制参数（参考 3GPP TS 24.008 [8]）。 如果 参数省略，则返回所有活跃 PDP 上下文的 APN 速率控制参数。 AT+CGAPNRC APN 速率控制 执行/设置命令 AT+CGAPNRC[=] 响应 [+CGAPNRC:[,[,[,]]]] [+CGAPNRC:[,[,[,]]]] [...]]]] OK 测试命令 AT+CGAPNRC=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAPNRC:(与激活上下文关联的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。指定某个 PDP 上下文定义（参考 AT+CGDCONT 命令）。 整型。表示当达到最大上行速率时是否允许发送附加异常报告。 0 不允许以最大速率发送（Additional exception reports） 1 允许以最大速率发送（Additional exception reports） 整型。用来指定最大上行速率的时间单位。 0 不受限 1 分钟 2 小时 上海移远通信技术股份有限公司 52 / 210 举例 AT+CGAPNRC +CGAPNRC:0,0,0 OK AT+CGAPNRC=? +CGAPNRC:(0) OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 3 天数 4 周 整型。指定每个上行时间单位限制 UE 发送的最大消息数。时间 单位以上行时间单位表示，如果上行时间单位设为'不受限'（即 0），那么 UE 可以发送的最大上行数据数量将不受限制。 整型。错误码。详情参见第 6 章。 2.27. AT+CSODCP 通过控制面发送始端数据 TE 使用该设置命令通过 UE 将数据通过控制面传输到网络。上下文标识符 用于将数据连接到 特定的上下文。 该命令可以有选择性地指示 UE 的应用程序，是期望通过此上行数据完成数据的交换，还是通过接收到 的下一条下行数据完成数据交换。 该命令也可有选择性地指示将要传输的数据是否为异常数据，可以引发 ESM DATA TRANSPORT 消 息的传输，如 3GPP TS 24.301 [83] 中定义。 AT+CSODCP 通过控制面发送始端数据 设置命令 AT+CSODCP=,, [,[,[,]]] 测试命令 AT+CSODCP=? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSODCP:(支持的范围),(支持的最大 发送字节数),(支持的列表),(支持的列表),(支持的范围) 上海移远通信技术股份有限公司 53 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。一个数字参数，指定某个 PDP 上下文或 EPS 承载上下文定义。 是 TE-UE 接口的本地参数，用来标识已通过 AT 命令设置的 PDP 或 EPS 承载 上下文（参考 AT+CGDCONT 命令）。 整型。表示 参数字节数。当没有数据传输时，该值应设置为零。 八位字符串。包含用户数据容器内容。当没有数据要传输时，参数 应为空字符串（''）。该参数不应按照 3GPP TS 27.007 [9] 中的 AT+CSCS 进行常规字符转换。用户数据容器的编码格式和参数 的最大长度是 特定的。使用 non-IP 时，最大数据长度为 1358 字节，否则为 0。 整型。表示释放辅助指示的值，参考 3GPP TS 24.301 [83] 子条款 9.9.4.25。 0 无指示 1 ESM DATA TRANSPORT 消息传输后不期望有进一步上下行数据，核心 网可立即释放 2 接收最后的 ESM DATA TRANSPORT 消息后完成数据交换，核心网在下 发后立即释放 整型。表示传输的用户数据是正常数据还是异常数据。 0 正常数据 1 异常数据 数据序列。范围：1~255。如果省略，则不会上报数据发送状态。如果不省略， 当数据报由 RF 发送或丢弃时，将会上报以下结果： +CSODCPR:,, 表示数据的状态。 0 错误 1 已发送 整型。错误码。详情参见第 6 章。 备注 每次只缓冲一条消息。 上海移远通信技术股份有限公司 54 / 210 举例 AT+CSODCP=? +CSODCP:(0-10),(0),(0,1,2),(0,1),(1-255) OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.28. AT+CRTDCP 通过控制面上报终端数据 接收到来自 CDP 服务器的消息时，设置命令用来启用和禁用从网络到 UE 的下行数据的上报。如果启 用数据上报，则当从网络接收到下行数据时，将上报 URC +CRTDCP: ,,。 查询命令会返回当前的设置情况。 AT+CRTDCP 通过控制面上报终端数据 设置命令 AT+CRTDCP= 响应 OK 查询命令 AT+CRTDCP? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CRTDCP: OK 测试命令 AT+CRTDCP=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CRTDCP:(支持的范围),(支持的范围),(由 参数指定的用户数据的最大八位字节数) OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 55 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 / 参数 整型。控制移动终端的控制面数据事件的上报。 0 禁用控制面数据的上报。 1 启用控制面数据的上报。 URC：+CRTDCP:,,。 整型。一个数字参数，指定某个 PDP 上下文或 EPS 承载上下文定义。 是 TE-UE 接口的本地参数，用来标识已通过 AT 命令设置的 PDP 或 EPS 承载上下文 （参考 AT+CGDCONT 命令）。 整型。表示 参数字节数。当没有数据传输时，该值应设置为零。 八位字符串。包含用户数据容器内容。当没有数据要传输时，参数 应为 空字符串（''）。该参数不应按照 3GPP TS 27.007 [9] 中的 AT+CSCS 进行常规 字符转换。用户数据容器的编码格式和参数 的最大长度是特定的。使用 non-IP 时，最大数据长度为 1358 字节，否则为 0。 整型。错误码。详情参见第 6 章。 举例 AT+CRTDCP=1 OK AT+CRTDCP? +CRTDCP:1 OK AT+CRTDCP=? +CRTDCP:(0-1),(0-10),(0) OK +CRTDCP:0,2,'ab' //URC 2.29. AT+CGCONTRDP 查询 PDP 上下文的动态参数 执行命令返回带有上下文标识符 的活跃非辅助 PDP 上下文相关信息 和 。 ⚫ 如果 UE 指示 2 个以上 P-CSCF 服务器的 IP 地址或 2 个以上 DNS 服务器的 IP 地址，则每个 上海移远通信技术股份有限公司 56 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 将返回多行信息。 ⚫ 如果 UE 具有双栈功能，则每个 至少返回两行信息：一行带有 IPv4 参数，紧接在后的一 行带有 IPv6 参数。如果具有双栈功能的 UE 指示两个以上 P-CSCF 或 DNS 服务器的 IP 地址，则 将返回多对这样的信息行。 ⚫ 如果省略参数 ，将会返回所有活跃的非辅助 PDP 上下文的相关信息。 测试命令会响应与活跃的非辅助上下文相关的 列表。 AT+CGCONTRDP 查询 PDP 上下文的动态参数 执行/设置命令 AT+CGCONTRDP[=] 响应 +CGCONTRDP:[,[,[,[,[,[,]]]]]] OK 测试命令 AT+CGCONTRDP=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGCONTRDP:(与动态场景相关的参数列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。用来指定某个非辅助 PDP 上下文。此参数是 TE-MT 接口的本地参数，用于 与 PDP 上下文相关的其他命令（参考 AT+CGDCONT 命令）。 整型。承载的标识，例如 EPS 中的 EPS 承载。 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。 字符串类型。表示 MT 的 IP 地址和子网掩码。 该字符串为点分隔数字（0-255）参数的形式，如下所示： IPv4 的形式为'a1.a2.a3.a4.m1.m2.m3.m4'或 IPv6 的形式为'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a 上海移远通信技术股份有限公司 57 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 15.a16.m1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m 15.m16'。 字符串类型。表示 MT 的网关地址。该字符串为点分隔数字（0-255）参数的形式。 字符串类型。表示主 DNS 服务器的 IP 地址。 字符串类型。表示备用 DNS 服务器的 IP 地址。 整型。错误码。详情参见第 6 章。 备注 1. 只有当参数 （请参考 AT+CGDCONT 命令）为 IP 或 IPV6 时，才能显示参数 和 。 2. 可以通过 AT+NCPCDPR 命令配置要查询的 PDP 上下文动态参数。 举例 AT+CGCONTRDP +CGCONTRDP:0,,'cmcc.MNC004.MCC460.GPRS',,,211.136.20.203,211.136.17.107 OK AT+CGCONTRDP=? +CGCONTRDP:(0) OK 2.30. AT+CGAUTH 定义 PDP 上下文鉴权参数 该设置命令允许 TE 为 PDP 上下文指定鉴权参数，该 PDP 上下文由 PDP 上下文激活和修改过程中使 用的（本地）上下文识别参数标识。由于参数 与 AT+CGDCONT 命令中使用的参数相同，因 此 AT+CGAUTH 命令实际上是 AT+CGDCONT 命令的扩展。 查询命令会返回每个已定义上下文的当前设置。 AT+CGAUTH 定义 PDP 上下文鉴权参数 设置命令 响应 AT+CGAUTH=[,[,[,]]] 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 上海移远通信技术股份有限公司 58 / 210 AT+CGAUTH? 测试命令 AT+CGAUTH=? 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 [+CGAUTH:,,,] [+CGAUTH:,,,] [...] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAUTH:(支持的范围),(支持的列表),(支 持的长度范围),(支持的长度范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效。 参数 整型。用来指定某个 PDP 上下文（见 AT+CGDCONT 命令）。 整型。表示 PDP 上下文使用的鉴权协议。 0 无，用于指示此 PDP 上下文不使用任何鉴权协议，如果之前已指定，则删除用户名 和密码 1 PAP 2 CHAP 字符串类型。表示访问 IP 网络的用户名。参数 为 1 或 2 时，需要参数 。参数 的字符串最大长度为 60 个字节。 字符串类型。表示访问 IP 网络的密码。字符串最大长度为 60 个字节。 整型。错误码。详情参见第 6 章。 举例 AT+CGAUTH=1,2,'1234','1234' OK AT+CGAUTH? +CGAUTH:0,1,'1234','1234' 上海移远通信技术股份有限公司 59 / 210 OK AT+CGAUTH=? +CGAUTH:(0-10),(0,1,2),(0-60),(0-60) OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.31. AT+CNMPSD 指示无更多 PS 数据 执行命令指示 UE 中的应用程序不期望进行数据交换。该命令可用于普通和 Modem 兼容模式。 AT+CNMPSD 指示无更多 PS 数据 执行命令 AT+CNMPSD 响应 OK 测试命令 AT+CNMPSD=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 整型。错误码。详情参见第 6 章。 举例 AT+CNMPSD OK AT+CNMPSD=? OK 上海移远通信技术股份有限公司 60 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.32. AT+CPIN 输入 PIN 码 此设置命令在 UE 可以操作之前，向 UE 发送必要的密码（如 USIM PIN 码和 USIM PUK 码等）。如 果需要输入两次 PIN 码，TA 将自动重复 PIN 码。如果没有待处理的 PIN 请求，此命令不会对 UE 实施任 何操作并且会响应错误 +CME ERROR: 。 如果需要的 PIN 码是 SIM PUK 或 SIM PUK2，则需要第二个 PIN 参数 。第二个 PIN 用于 替换 SIM 中的旧 PIN。 查询命令会返回字母数字字符串，表示是否需要某些密码。 AT+CPIN 输入 PIN 码 设置命令 AT+CPIN=[,] 响应 OK 查询命令 AT+CPIN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPIN: OK 测试命令 AT+CPIN=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；自动保存到 KV。 参数 字符串类型。表示密码。 字符串类型。表示请求的代码是 PUK 时所需的新密码。 READY SIM PIN SIM PUK 表示 UE 无密码输入请求 表示 USIM PIN 密码请求 表示 SIM PUK 密码请求 上海移远通信技术股份有限公司 61 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 SIM PUK BLOCKED 如果在输入错误的 PUK 10 次后 sim 卡被锁定，则在开 机时主动上报 整型。错误码。详情参见第 6 章。 备注 1. 只有当 AT+CFUN=1 时，才能执行 AT+CPIN 的设置命令和查询命令。 2. USIM PIN 和 USIM PUK 指的是在 UICC 上所选程序的 PIN 码。例如，在 UTRAN 上下文中，当前 所选择的 UICC 上的应用程序应该是 USIM，所以 USIM PIN 代表的是所选 USIM 的 PIN 码。如需查 看更多有关 UICC 上应用程序选择的详细信息，请参考 3GPP TS 31.101 [65]。 举例 AT+CPIN=1234 OK AT+CPIN? +CPIN: READY OK AT+CPIN=? OK 2.33. AT+CPINR 查询剩余 PIN 的重试次数 设置命令和执行命令会使 UE 返回其密码的剩余 PIN 重试次数。 AT+CPINR 查询剩余 PIN 重试次数 设置命令 响应 AT+CPINR= [+CPINR: ,[,]] OK 执行命令 AT+CPINR 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+CPINR: ,[,]] [+CPINR: ,[,]] OK 上海移远通信技术股份有限公司 62 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+CPINR=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 整型。每个 PIN 的剩余重试次数。 整型。每个 PIN 的默认/初始重试次数。 PIN 的类型，除了 READY 之外，所有在 AT+CPIN 命令 参数列出的值。 整型。错误码。详情参见第 6 章。 举例 AT+CPINR='SIM PUK' +CPINR: SIM PUK,10,10 OK AT+CPINR +CPINR: SIM PIN,3,3 +CPINR: SIM PUK,10,10 OK 备注 只有当 AT+CFUN=1 时，才能执行 AT+CPINR 的设置命令和执行命令。 2.34. AT+CCHO 打开逻辑信道 执行命令 AT+CCHO=，MT 端会返回 ，TE 端通过此参数识别当前选定 UICC 分配的信道，这些操作都依附于 ME 端。当前选定的 UICC 会打开一个新的逻辑信道，选择由命令中参数 标识的应用，并返回一个会话 ID。ME 应将 TE 和 UICC 之间的通信限制在该逻辑信道上。 上海移远通信技术股份有限公司 63 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 在执行命令 AT+CRLA 或 AT+CGLA 时，也将使用此 。 AT+CCHO 打开逻辑信道 设置命令 AT+CCHO= 响应 OK 测试命令 AT+CCHO=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。十六进制格式。UICC 中所有可选应用都用 DF Name 编码。 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM 和 ISIM） 上一个特定应用。 整型。错误码。详情参见第 6 章。 举例 AT+CCHO=? OK 备注 APDU 命令中 CLASS 字节包含逻辑信道号，故发送到 UICC 的所有 APDU 命令都会包含逻辑信道号。因 此需由 MT 端负责管理 ADPU CLASS 字节中的逻辑信道部分，并确保选择的逻辑信道和执行命令返回的 相关联。 上海移远通信技术股份有限公司 64 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.35. AT+CCHC 关闭逻辑信道 该命令用来关闭 ME 与当前 UICC 之间的通信会话，ME 需关闭之前打开的逻辑信道，关闭后 TE 端无 法再次通过此逻辑信道发送命令。接收该命令后，UICC 会关闭逻辑信道。 AT+CCHC 关闭逻辑信道 设置命令 AT+CCHC= 响应 OK 测试命令 AT+CCHC=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM、ISIM） 上一个特定应用。 整型。错误码。详情参见第 6 章。 举例 AT+CCHC=1 OK AT+CCHC=? OK 上海移远通信技术股份有限公司 65 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.36. AT+CGLA 通用 UICC 逻辑信道访问 执行命令发送 到 MT 端，然后由 MT 端发送 到所选择的 UICC。同样， UICC 会通过 MT 端返回 到 TA。 该命令允许通过 TE 上的远程应用程序直接控制当前选择的 UICC。然后，TE 应在 GSM/UMTS 指定的 框架内处理 UICC 信息。 虽然通用 UICC 逻辑信道访问命令 AT+CGLA 允许 TE 控制 UICC-MT 接口，但是逻辑上不需要从 TA/MT 外部访问 UICC-MT 接口的一些功能。此外，出于安全原因，不应在 TA/MT 之外处理 GSM 网络鉴权。因 此，无论 AT+CGLA 是锁定的还是解锁的，都不能在 TE 中使用 AT+CGLA 在 GSM 上下文中运行 GSM 算 法命令或鉴权命令。这不应禁止 TE 在其他安全上下文中（例如 EAP 安全上下文中）发送身份鉴权命令。 例如，当参数 P2 为 0（GSM 安全上下文）时，TA/MT 应禁止将鉴权命令发送到 USIM 应用程序。USIM 鉴权命令详细信息，请参考 3GPP TS 31.102 [59]。 AT+CGLA 通用 UICC 逻辑信道访问 设置命令 AT+CGLA=,, 响应 +CGLA: , OK 测试命令 AT+CGLA=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM、ISIM） 上一个特定应用。 上海移远通信技术股份有限公司 66 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 整型。在 或 中发送给 TE 的字符长度（是命令或响应实 际长度的两倍） MT 端以 3GPP TS 31.101[65] 所述的格式发送至 UICC 的命令（十六进制字符格式， 参考 AT+CSCS）。 UICC 发送到 MT 端针对 的响应，格式与 3GPP TS 31.101[65] 中描述 一致（十六进制字符格式，参考 AT+CSCS）。 整型。错误码。详情参见第 6 章。 备注 与访问受限 UICC 命令 AT+CRLA 相比，AT+CGLA 的定义允许 TE 对 UICC-MT 接口进行更多控制。接 口 的 锁 定 和 解 锁 可 以 通 过 特 殊 的 值 完 成 ， 也 可 以 由 TA/MT 自 动 完 成 （ 通 过 解 析 参数）。如果 TE 应用程序未在某个超时值中使用解锁命令（或者不发送使自动解锁的 ），则 MT 可以释放锁定。 举例 AT+CGLA=? OK 2.37. AT+CRSM 受限 SIM 卡访问 通过使用该命令访问 SIM 数据库，相对于使用通用 SIM 访问命令 AT+CSIM 而言，该命令更简便也更 受限制。 执行命令向 MT 发送 SIM 及其所需参数。 如果 SIM 卡安装在当前选定的卡槽中，则 MT 在内部处理所有 SIM-MT 接口锁定和文件选择例程。作为对命令的响应，MT 发送实际 SIM 信息参数和 响应数据。当命令无法传递给 SIM 时，可能会返回 MT 错误结果代码 +CME ERROR，若 SIM 中执行命令 失败会在参数 和 中上报。 对于 SIM 发出的命令请求和 MT 内部 GSM/UMTS 应用程序发出的命令请求之间的协调取决于实现。 但是 TE 应注意 GSM/UMTS 应用程序命令对 TE 命令的优先级。 AT+CRSM 受限 SIM 卡访问 设置命令 响应 AT+CRSM=[,[,<P +CRSM: ,[,] 1>,,[,[,]]]] OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 67 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+CRSM=? 最大响应时间 特性说明 或者 +CME ERROR: 响应： OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 保存机制与 USIM 有关；参数配置不保存至 KV。 参数 、、 、 MT 传递给 SIM 的命令。参考 3GPP TS 51.011 [28] 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS 203 RETRIEVE DATA 219 SET DATA 所有其他值保留，命令 203 和 219 暂不支持。 整型。SIM 上基本数据文件的标识符。除 =242（STATUS）之外， 对于每个命令来说该参数为必要参数。 整型。MT 传递给 SIM 的参数。除 GET RESPONSE 和 STATUS 之外，对于其 他命令必须指定这些参数。请参考 3GPP TS 51.011 [28]。 十六进制格式。应写入 SIM 的信息。参考 AT+CSCS。 字符串类型。十六进制格式。包含 SIM/UICC 基础文件路径（例如 SIM 和 UICC 情况下的'7F205F70'），仅用于'从 MF 选取路径'模式。 整型。来自 SIM 关于实际命令执行的信息。在命令执行成功或失败时，这些参 数都会传递给 TE。 字符串类型。十六进制格式。成功完成上一次发出命令的响应（请参考 +CSCS）。 STATUS 和 GET RESPONSE 返回数据。该数据提供有关当前基本数据字段的 信息。该信息包括文件类型及其大小（参考 3GPP TS 51.011 [28]）。在 READ BINARY，READ RECORD 或 RETRIEVE DATA 命令之后，将返回所请求的数 据。成功执行 UPDATE BINARY，UPDATE RECORD 或 SET DATA 命令后， 不会返回 。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 68 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 备注 1. 在执行实际命令之前，MT 在内部执行选择目标文件所需的所有命令。 2. 有效文件标识符的范围取决于实际 SIM，可查看 3GPP TS 51.011 [28] 中定义。可选文件可能不显示。 3. 由于有效的基本文件标识符在所有有效的专用文件标识符上可能不是唯一的，所以 表示在 模糊文件标识符的情况下的目标 UICC/SIM 目录路径。对于该规范的早期版本，或者省略了 ，则根据具体实现情况选择。 4. 目前不支持 203 和 219。 举例 AT+CRSM=242 +CRSM: 144,0 OK AT+CRSM=? OK 2.38. AT+CSIM 通用 SIM 卡访问 执行命令向 MT 发送 ，然后 MT 发送至 SIM 卡。同样，MT 发送 SIM 卡 至 TA。 该命令允许通过 TE 上的远程应用直接控制安装在当前所选卡槽中的 SIM 卡。然后，TE 应在 GSM/UMTS 指定的框架内处理 UICC 信息。 AT+CSIM 通用 SIM 卡访问 设置命令 AT+CSIM=, 响应 +CSIM: , OK 测试命令 AT+CSIM=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应： OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 69 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 +CME ERROR: 300 毫秒 / 参数 整型。在 或 中发送给 TE 的字符长度（命令或响应的 实际长度的两倍）。 由 MT 以 3GPP TS 51.011 [28]中描述的格式传送给 SIM 卡的命令（十六进制字符 格式；参考 +CSCS）。 响应 SIM 卡以 3GPP TS 51.011[28]（十六进制字符格式；参考 +CSCS）描述的 格式传递给 MT 的命令。 整型。错误码。详情参见第 6 章。 举例 AT+CSIM=10,'00B2010426' +CSIM: 4,6981 OK AT+CSIM=? OK 备注 与受限 SIM 卡访问命令 AT+CRSM 相比，AT+CSIM 的定义允许 TE 对 SIM-MT 接口进行更多控制。接口 的锁定和解锁可以通过特殊的 值完成，也可以由 TA/MT 自动完成（通过解析 参数）。若 TE 应用程序未在某个超时值中使用解锁命令（或者不发送使自动解锁的 ）， MT 可能会释放锁定。 2.39. AT+CGDATA 进入数传状态 执行命令使 MT 操作在 TE 和网络之间建立通信所需的任何动作，可使用一个或多个 Packet Domain PDP 类型。 包括执行 PS 附着和一个或多个 PDP 上下文激活。如果 MT 不接受 参数值，则 MT 应返回 ERROR 或 +CME ERROR，否则，MT 发出中间结果代码 CONNECT 并进入 V.250 在线数据状态。 MT 命令行中的 AT+CGDATA 命令后面的命令不应由 MT 处理。输入在线数据状态后的详细行为取决 于 PDP 类型。它在 3GPP TS 27.060[34]中有简要描述，在 3GPP TS 29.061[39]和相关 PDPs 的规范中 有更详细的描述。如果尚未使用 AT+CGATT 和 AT+CGACT 命令执行 PS 附着和 PDP 上下文激活过程， 则可以在 PDP 启动之前或期间进行 PS 附着和 PDP 上下文激活过程。如果在 PDP 启动期间发生上下文激 上海移远通信技术股份有限公司 70 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 活，则可以指定一个或多个 以便提供上下文激活请求所需的信息。 在每个 PDP 启动过程中，MT 可以访问以下部分或全部信息： ⚫ MT 可以具有先验信息，例如，它可以仅实现一种 PDP 类型。 ⚫ 该命令可能提供了 参数值。 ⚫ TE 可以在 PDP 启动过程期间向 MT 提供 PDP 类型和/或 PDP 地址。 如果任何此类信息发生冲突，命令将失败。上述信息中存在的任何 PDP 类型和/或 PDP 地址应与命令 中指定的任何上下文定义中的 PDP 类型和/或 PDP 地址进行比较，其出现的顺序为 。要匹配的上下 文定义： ⚫ PDP 类型必须完全匹配。 ⚫ 如果 PDP 地址相同或者未指定其中一个或两个地址，则认为它们匹配。例如，指定 PDP 类型为 IP 且没有 PDP 地址的 PPP NCP 请求将使 MT 在 PDP 类型为 IP 和任何 PDP 地址的情况下搜索 指定的上下文定义。 应使用 PDP 类型的匹配值和静态 PDP 地址（如果可用）以及 PDP 上下文定义中的其他信息激活上下 文。如果静态 PDP 地址不可用，则请求动态地址。 如果没有给出 或者如果没有匹配的上下文定义，则 MT 将尝试使用 MT 可用的任何信息来激活 上下文。其他上下文参数应设置为其默认值。 如果激活成功，则可以继续数据传输。数据传输完成后，第 2 层协议终止过程成功完成，重新进入 V.250 命令状态，MT 返回最终结果代码 OK。 如果错误终止或无法启动，则重新进入 V.250 命令状态，MT 返回最终结果代码 NO CARRIER，或者 如果启用，则返回 +CME ERROR。可能会上报附着、激活和其他错误。 测试命令用于请求有关支持的第 2 层协议的信息。该命令可用于普通和调制解调器兼容模式。 AT+CGDATA 进入数传状态 设置命令 AT+CGDATA[=[,[, [,...]]]] 测试命令 AT+CGDATA=? 响应 CONNECT 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGDATA:(支持的列表) OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 71 / 210 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。表示 TE 和 MT 之间使用的第 2 层协议。 NULL 无，对于 PDP 型 OSP：IHOSS（已废弃） PPP 用于 PDP 的点对点协议，例如 IP PAD X.25 字符（三重 X PAD）模式的字符流（已废弃） X25 X.25 L2（LAPB）用于 X.25 数据包模式（已废弃） M-xxxx 制造商特定协议（xxxx 是字母数字字符串） 如果省略该值，则不指定第 2 层协议。其他值保留，将返回 ERROR。 字符串类型。十六进制格式。最大发送数据长度为 512 字节。 整型。错误码。详情参见第 6 章。 备注 1. 如果支持初始 PDP 上下文，则在启动时自动定义 =0 的上下文。 2. 仅支持 'PPP'。 3. 波特率需要大于或等于 57600bps。 4. 一次只能指定一个 。 2.40. AT+CCIOTOPT CIoT 优化配置 设置命令控制 UE 在 ATTACH REQUEST 和 TRACKING AREA UPDATE REQUEST 消息中指示支持 和优先选择的 CIOT EPS 优化配置。该命令还可用来上报网络支持的 CIoT EPS 优化配置。支持 CIoT 功能 的 UE 可以支持控制面（control plane）或用户面（user plane）的 CIoT EPS 优化配置，或两者都可支持 （请参考 3GPP TS 24.301 [83], subclause 9.9.3.34）。基于应用特性，UE 可能优先选择注册用于控制面 的 CIoT EPS 优化配置或用于用户面的 CIoT EPS 优化配置（请参考 3GPP TS 24.301, sub-clause 9.9.3.0B）。 此外，网络可支持控制面 CIoT EPS 优化配置或用户面 CIoT EPS 优化配置或两者都可支持（参考 3GPP TS 24.301 [83], subclause 9.9.3.12A）。 设置命令还用于设置开启或关闭 URC +CCIOTOPTI: ，该 URC 用于表示 网络所支持的 CIoT EPS 优化配置。 上海移远通信技术股份有限公司 72 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+CCIOTOPT CIoT 优化配置 设置命令 响应 AT+CCIOTOPT=[,[[,]]] 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+CCIOTOPT? +CCIOTOPT:,, OK 测试命令 AT+CCIOTOPT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCIOTOPT:(支持的列表),(支持的列表),(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 重启后不保存。 参数 整型。启用或禁用 URC +CCIOTOPTI 的上报。 0 禁用 URC 1 启用 URC 3 禁用上报并将 CIoT EPS 优化配置的参数重置为默认值 整型。表示 UE 对 CIoT EPS 优化配置的支持情况。 0 不支持 1 支持控制面 CIoT EPS 优化 上海移远通信技术股份有限公司 73 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2 支持用户面 CIoT EPS 优化 3 支持控制面和用户面 CIoT EPS 优化 整型。表示 UE 对 CIoT EPS 优化的偏好。 0 没有偏好 1 偏好控制面 CIoT EPS 优化 2 偏好用户面 CIoT EPS 优化 整型。表示网络支持的 CIoT EPS 优化。 0 不支持 1 支持控制面 CIoT EPS 优化 2 支持用户面 CIoT EPS 优化 3 支持控制面 CIoT EPS 优化和用户面 CIoT EPS 优化 整型。错误码。详情参见第 6 章。 备注 1. 仅支持 1 和 3。 2. 仅支持 1 和 2。 3. 仅当 为 3 时，才能将 设置为 2。 举例 AT+CCIOTOPT=1,3,2 OK AT+CCIOTOPT? +CCIOTOPT:1,3,2 OK AT+CCIOTOPT=? +CCIOTOPT:(0,1,3),(1,3),(1,2) OK 2.41. AT+CGCMOD 修改 PDP 上下文 设置命令用于根据 QoS 配置文件和 TFTs 修改指定的 PDP 上下文。命令完成后，MT 返回到 V.250 在 线数据状态。如果无法实现对任何指定上下文的请求修改，则返回 ERROR 或 +CME ERROR。AT+CMEE 命令可启用扩展错误响应。 对于 EPS，EPS 承载资源的修改请求将由网络通过 EPS 承载修改请求来响应。在有效地更改 PDP 上 下文之前，MT 必须接受该请求。如果未指定 ，则命令的激活形式将修改所有活动上下文。测试命令 返回与活动上下文关联的 列表。 上海移远通信技术股份有限公司 74 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+CGCMOD 修改 PDP 上下文 设置命令 AT+CGCMOD[=[,[,...]]] 响应 OK 测试命令 AT+CGCMOD=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGCMOD:(已激活上下文列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT 命令）。 整型。错误码。详情参见第 6 章。 备注 1. 一次只能修改一个 。 2. 处理此命令时，会阻止其他命令。 举例 AT+CGCMOD=? +CGCOMD:(0) OK 上海移远通信技术股份有限公司 75 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.42. AT+CGEQOS 定义 EPS Qos 设 置 命 令 允 许 TE 为 对 应 的 PDP 上 下 文 或 业 务 流 指 定 EPS 服 务 质 量 参 数 [,,< UL_GBR>[,,]]（请参考 3GPP TS 24.301 [83] 和 3GPP TS 23.203 [85]）。在 UMTS/GPRS 中，MT 将映射功能应用于 UTMS/GPRS 服务质量。 AT+CGEQOS= 是设置命令的一种特殊形式，将使上下文编号 的值变为未定义。查询命 令返回每个定义的 QoS 的当前设置。设置命令将支持的参数范围作为复合值返回。 AT+CGEQOS 定义 EPS Qos 设置命令 AT+CGEQOS=[[,[,,[,,<UL_M BR]]]] 查询命令 AT+CGEQOS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+CGEQOS:,,[,],[,]][+CGEQOS:,,[< DL_GBR>,],[,][...]] OK 测试命令 AT+CGEQOS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGEQOS:(支持的列表),(支持的列表),(支持的< DL_GBR>列表),(支持的列表),(支持的列表),(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 76 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT 命令）。 整型。指定 EPS QoS 等级（参考 3GPP TS 23.203 [85]和 3GPP TS 24.301 [83]）。 0 QCI 由网络选择 [1–4] 保证比特率业务流的值范围 75 保证比特率流量的值 [5–9] 非保证比特率业务流量的值范围 79 非保证比特率流量的值 [128–254] 运营商特定 QCI 的值范围 UE 不可请求 QCI 值 65，66，69 和 70。如果 TE 请求 QCI 参数 65，66，69 或 70， 则 MT 响应结果代码 +CME ERROR: 181（不支持的 QCI 值） 整型。在 GBR QCI 的情况下表示 DL GBR。单位：kbit/s。对于非 GBR QCI，省略该 参数（参考 3GPP TS 24.301 [83]）。 整型。在 GBR QCI 的情况下表示 UL GBR。单位：kbit/s。对于非 GBR QCI，省略该 参数（参考 3GPP TS 24.301 [83]）。 整型。表示 GBR QCI 情况下的 DL MBR。单位：kbit/s。对于非 GBR QCI，省略该参 数（参考 3GPP TS 24.301 [83]）。 整型。表示 GBR QCI 情况下的 UL MBR。单位：kbit/s。对于非 GBR QCI，省略该参 数（参考 3GPP TS 24.301 [83]）。 整型。错误码。详情参见第 6 章。 备注 1. 可以仅设置 ， 仅支持 0、5、6、7、8、9 和 79。 2. 只有在开机和定义 PDP 上下文时才能执行此命令。 举例 AT+CGEQOS=0,0 OK AT+CGEQOS? +CGEQOS: 0,0 OK AT+CGEQOS=? +CGEQOS:(0),(0,5,6,7,8,9,79) OK 上海移远通信技术股份有限公司 77 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 2.43. AT+CGTFT 设置 TFT 该命令允许 TE 指定一个数据包过滤器（用于 PF 的业务流模板）TFT，在 UMTS/GPRS 中的 GGSN 和 EPS 中的 Packet GW，通过将数据包路由到不同的 QoS 流最终发送到 TE。参考 3GPP TS 23.060 [47] 中的描述。 TFT 由 1 个到多达 16 个数据包过滤器组成，每个数据包过滤器由唯一的 标识。数据包过滤器还具有 ，此参数值在与相同 PDP 地址 下所有 PDP 上下文相关联的所有 TFT 中是唯一的。 设置命令指定待添加到存储在 MT 中 TFT 的数据包过滤器，并用于由（本地）上下文标识参数 标识的上下文。指定的 TFT 将仅在激活或 MS 启动的相关上下文修改时存储在 UMTS / GPRS 中的 GGSN 和 EPS 中的 Packet GW 中。因为这与 AT+CGDCONT 命令中使用的参数相同，AT+CGTFT 命令实际上 是这些命令的扩展。数据包过滤器由许多参数组成，每个参数可以设置为一个单独的值。设置命令的一种 特殊形式，AT+CGTFT= 使得 TFT 中的所有数据包过滤器的上下文编号 变得不确定。在任何 时候都可能存在一个 PDP 上下文没有相关联的 TFT。若试图违反规则删除一个 TFT，将返回 ERROR 或 +CME ERROR。AT+CMEE 命令可使能扩展错误响应。 查询命令返回每个已定义上下文的所有数据包筛选器的当前设置。 测试命令返回支持的参数。如果 MT 支持多种 PDP 类型，则每个 PDP 类型的参数值范围将在单独的 行上返回。 TFT 仅用于 PDP 型 IP 和 PPP。对于 PDP 型 PPP，仅当 IP 流量通过 PPP 承载时，TFT 才适 用。如果 PPP 携带报头压缩的 IP 数据包，则不能使用 TFT。 AT+CGTFT 设置 TFT 设置命令 AT+CGTFT=[,[,[,[,[,[,[,[,[,[,[,]]]]]]]]]]] 查询命令 AT+CGTFT? 响应 OK 如出现任何错误： ERROR 或者 +CME ERROR: 响应 [+CGTFT:,,,,,,,,,,,] [+CGTFT: ,,,,,,,,,,,[...]] OK 如出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGTFT:,( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的 列表) [+CGTFT: ,(支持的列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的 列表)[...]] OK 若出现任何错误： ERROR 或者 +CME ERROR: 79 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 / 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT 命令）。 字符串类型。指定数据包数据协议的类型（请参考 AT+CGDCONT 命令）。 整型。报文过滤器 ID。范围：1~16。 整型。优先级。范围：0~255。 字符串类型。远端 IP 地址及子网掩码。该字符串以点分隔 数字（0-255）参数给出： 'a1.a2.a3.a4.m1.m2.m3.m4'， 用于 IPv4 或者 'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a1 6.m1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m 14.m15.m16'，用于 IPv6 当支持 AT+CGPIAF 时（目前不支持），其设置可以影响 AT+CGTFT? 参数返回格式。 整型。IPV4 的协议号。范围：0~255。 字符串类型。本地端口范围。'f.t' 形式的点分隔数字。范围： 0~65535。 字符串类型。远程端口范围。'f.t' 形式的点分隔数字。范围： 0~65535。 十六进制格式的数值。范围：00000000~FFFFFFFF。 字符串类型。't.m'形式的点分隔数字（0-255）。 数字型。十六进制格式。范围：00000-FFFFF。仅对 IPv6 有效。 整型。指定应用数据包过滤器的传输方向。 0 Pre-Release 7 TFT 过滤器（参考 3GPP TS 24.008 [8]，表 10.5.162） 1 上行链路 2 下行链路 3 双向（上行和下行） 字符串类型。本地 IP 地址及子网掩码。点分十进制（0-255）格 式：'a1.a2.a3.a4.m1.m2.m3.m4'，用于 IPv4。 或者 'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16.m 1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15. m16'，用于 IPv6 当支持 AT+CGPIAF 时，此命令配置可能影响 AT+CGTFT? 参 数返回格式。 上海移远通信技术股份有限公司 80 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 整型。错误码。详情参见第 6 章。 备注 1. 只有在开机和定义 PDP 上下文时才能执行此命令。 2. 暂不支持 。 3. 部分参数可以在分组过滤器中共存，而其他属性互相排斥，请参考 3GPP TS 23.060 [47]。 举例 AT+CGTFT=0,2,6,'32.1.11.160.0.0.0.0.0.0.0.0.0.0.0.0.255.255.255.255.0.0.0.0.0.0.0.0.0.0.0.0',17,'600 01.60001','60350.60450',0x123456,168.252,0x12345,1 OK AT+CGTFT? +CGTFT:0,2,6,'2001:BA0::.FFFF:FFFF::',17,'60001.60001','60350.60450',0x123456,'168.252',0x1 2345,1 OK AT+CGTFT=? +CGTFT:'IP',(1,16),(0,255),'(0.0.0.1,255.255.255.255).(0.0.0.1,255.255.255.255)',(0,255),'(0,65535).( 0,65535)','(0,65535).(0,65535)',(0x0,0xFFFFFFFF),'(0,255).(0,255)',,(0,3) +CGTFT:'NONIP',(1,16),(0,255),,(0,255),'(0,65535).(0,65535)','(0,65535).(0,65535)',(0x0,0xFFFFFF FF),'(0,255).(0,255)',,(0,3) +CGTFT:'IPV6',(1,16),(0,255),'(::1,FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF).(::1,FFFF:FFFF: FFFF:FFFF:FFFF:FFFF:FFFF:FFFF)',(0,255),'(0,65535).(0,65535)','(0,65535).(0,65535)',(0x0,0xFFF FFFFF),'(0,255).(0,255)',(0x0,0xFFFFF),(0,3) +CGTFT:'IPV4V6',(1,16),(0,255),'(0.0.0.1,255.255.255.255)(::1,FFFF:FFFF:FFFF:FFFF:FFFF:FFFF: FFFF:FFFF).(0.0.0.1,255.255.255.255)(::1,FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF)',(0,255),' (0,65535).(0,65535)','(0,65535).(0,65535)',(0x0,0xFFFFFFFF),'(0,255).(0,255)',(0x0,0xFFFFF),(0,3) OK 2.44. AT+CNEC 报告网络错误码 设置命令激活或禁用由网络发送的错误代码报告。当激活时，ME 将根据的设置，报告网络发送的 EPS 移动性管理和 EPS 会话管理相关的错误代码。报告包含以下结果代码： +CNEC_EMM:[,] EPS 移动性管理 +CNEC_ESM:[,] EPS 会话管理 上海移远通信技术股份有限公司 81 / 210 查询命令返回的当前设置。 测试命令返回支持的值。 AT+CNEC 报告网络错误码 设置命令 AT+CNEC= 查询命令 AT+CNEC? 测试命令 AT+CNEC=? 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CNEC: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CNEC:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。该参数是一个整数的合集，每个整数代表特定类别的错误代码。 0 禁用错误码报告 8 启用 URC +CNEC_EMM，按照 3GPP TS 24.301 [83]表 9.9.3.9.1 中的规定编码报 告 EPS 移动性管理错误。 16 启用 URC +CNEC_ESM，按照 3GPP TS 24.301 [83]表 9.9.4.4.1 中的规定编码报 告 EPS 会话管理错误。 整型。错误代码参考： 上海移远通信技术股份有限公司 82 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 3GPP TS 24.301 [83]表 9.9.3.9.1 针对 EPS 移动性管理错误代码。 3GPP TS 24.301 [83]表 9.9.4.4.1 针对 EPS 会话管理错误代码。 整型。指定的 PDP 上下文（见 AT+CGDCONT 命令）。 整型。错误码。详情参见第 6 章。 备注 1. 若需 MT 希望接收 EPS 移动管理错误和 EPS 会话管理错误，则必须指定=24（8 + 16），即 AT+CNEC=24。输入 AT+CNEC=8，然后输入 AT+CNEC=16，不会产生与 AT+CNEC=24 相同的结 果，因为 AT+CNEC=16 会覆盖先前的设置。 例如： 如果 MT 仅希望接收 EPS 移动性管理错误，则必须指定=8，即 AT+CNEC=8。 如果 MT 希望接收 EPS 移动管理错误和 EPS 会话管理错误，则必须指定=24，即 AT+CNEC=24 2. 仅支持=0，=8，=16 和=24。 3. 仅 R02 固件（对应 B500SPx 基线版本）及之后固件版本支持该命令。 举例 AT+CNEC=8 OK AT+CNEC? +CNEC:8 OK AT+CNEC=? +CNEC:(0,8,16,24) OK 上海移远通信技术股份有限公司 83 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 3 3GPP 命令 (27.005) 3.1. AT+CSMS 选择短信服务 设置命令用来选择短信服务，它会返回 UE 支持的短信类型： 表示被叫消息， 表示主叫 消息， 表示广播类型消息。如果 ME 不支持所选的服务，将会返回最终结果码 +CME ERROR:。 查询命令会返回当前服务设置中支持的消息类型。 AT+CSMS 选择短信服务 设置命令 AT+CSMS= 响应 +CSMS:,, OK 查询命令 AT+CSMS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSMS:,,, OK 测试命令 AT+CSMS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSMS:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 84 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。表示消息服务。 0 表示 3GPP TS 23.040 [3] 和 3GPP TS 23.041 [4] 1 表示 3GPP TS 23.040 [3] 和 3GPP TS 23.041 [4] 相应的命令描述中提到了参数 设置为 1 的要求 整型。被叫消息。 0 不支持 1 支持 整型。主叫消息。 0 不支持 1 支持 整型。广播类型消息。 0 不支持 1 支持 整型。错误码。详情参见第 6 章。 备注 1. 如果 UE 收到短信，将会上报 URC +CMT:[],（PDU 模式已启 用）。 2. 上述 URC 中的参数 的值始终为 0，如需查看更多 URC 的相关信息，请参考 3GPP TS 27005 中的 AT+CNMI 命令。 举例 AT+CSMS=1 +CSMS:1,1,0 OK AT+CSMS? +CSMS:1,1,1,0 OK AT+CSMS=? +CSMS:(0,1) OK 上海移远通信技术股份有限公司 85 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 3.2. AT+CNMA 发送新消息确认 该执行命令可以对发送到 UE 的新消息（SMS-DELIVER 或 SMS-STATUS-REPORT）进行确认。当 AT+CSMS 的参数 等于 1 时应使用此命令。在 PDU 模式下，可以向网络发送肯定（RPACK） 或否定（RP-ERROR）的确认消息。参数 决定发送哪个消息。可以有选择地（当参数 大 于 0 时）向网络发送确认 TPDU（RPACK 或 RP-ERROR 的 SMS-DELIVER-REPORT）。除了使用 的格式代替 （即不存在 SMSC 地址字段）之外，输入的 PDU 与命令 AT+CMGS 中指定的类似。 PDU 不应以双引号为界，在前一个消息被确认之前，UE 不应发送其他 +CMT 或 +CDS 结果码给 TE。 如果在规定的时间内（网络超时）没有收到确认消息，则 UE 应按照 3GPP TS 24.011 [6]中的规定向 网络发起响应消息。 如果执行该命令却没有收到相应的确认消息，或是发生其他 UE 相关的错误，则返回最终结果码 +CME ERROR: 。如果直传的路由消息必须要缓存在 UE 中，或者 AT 解析在结果码无法发送至 TE 的状态 保持时间过长（例如，用户使用 AT+CMGS 输入消息），则必须在不等待来自 TE 的 AT+CNMA 命令的情 况下，向网络发送确认消息（RP-ACK）。之后，当缓冲的结果码被刷新到 TE 时，TE 必须为每个结果码 发送 +CNMA [=0] 进行确认。通过这种方式，UE 可以决定消息是否应该保存在 KV 中和禁用到 TE 的路 由（未接收到 +CNMA [=0]）。 AT+CNMA 发送新消息确认 设置命令 AT+CNMA=[[,[ PDU is given]]] 测试命令 AT+CNMA=? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CNMA:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 86 / 210 参数 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 整型。 1 发送 RP-ACK（或者正确接收的缓冲结果码）。 2 发送 RP-ERROR（如果没有给出 PDU，ME/TA 应发送 SMS-DELIVER-REPORT， 其中 3GPP TS 23.040 [3] TP-FCS 的值设置为'FF'。（未指明的错误原因）。 整型。 表示在文本模式下，消息体 （或 ）的长度。单位：字符；或者在 PDU 模式下，实际 TP 数据的长度。单位：八位字节（即 RP 层 SMSC 地址八位字节不计入 长度）。范围是 0~232。 整型。错误码。详情参见第 6 章。 备注 1. 如果 UE 收到短信，将会上报 URC +CMT:[],（PDU 模式已启 用）。 2. 上述 URC 中的参数 的值始终为 0，如需查看更多 URC 的相关信息,请参考 3GPP TS 27005 中的 AT+CNMI 命令。 举例 AT+CNMA=? +CNMA:(1,2) OK 3.3. AT+CSCA 设置短信服务中心地址 该设置命令可以更新 SMSC 地址，通过该地址发送主叫短信。在文本模式下，可以使用设置命令进行 设置。在 PDU 模式下，仅当 SMSC 地址的长度编码为 =0 时，可使用同一命令进行设置。 AT+CSCA 设置短信服务中心地址 设置命令 AT+CSCA=[,] 响应 OK 查询命令 AT+CSCA? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCA:[,] 上海移远通信技术股份有限公司 87 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+CSCA=? 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 表示 3GPP TS 24.011 [6] RP SC 地址字符串格式的地址-值字段。BCD 数字（或 GSM 7 位 默认字母字符）被转换为当前选择的 TE 字符集的字符（参考 3GPP TS 27.007 [9]中的 AT+CSCS 命令）；地址类型由 给出。 表示 3GPP TS 24.011 [6] RP SC 地址整数格式的八位字节地址类型。当 （参考 3GPP TS 27.005）的第一个字符为'+(IRA 43)'时，此参数默认值为 145，否则默认值为 129。 整型。错误码。详情参见第 6 章。 举例 AT+CSCA=358501234567,145 OK AT+CSCA? +CSCA:'358501234567',145 OK AT+CSCA=? OK 3.4. AT+CMGS 发送短信 该命令可以从 TE 向网络发送消息（SMS-SUBMIT）。消息传输成功时，消息参考值 会被返回 给 TE。可选择（当 AT+CSMS 的参数 值为 1 且网络支持时）返回参数 。参数值可 在非请求的发送状态上报结果码时被用来标识消息。如果消息在网络中发送失败或 UE 发生错误，则会返回 最终结果码 + CME ERROR：。该命令是可以中止的。 上海移远通信技术股份有限公司 88 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 ⚫ 参数 表示要给出的在 TP 层数据单元中编码的八位字节数（即排除 SMSC 地址八位字 节）。 ⚫ 在命令行以 终止后，UE 应发送一个四字符序列 （IRA 13, 10, 62, 32）；之后，可以从 TE 向 UE 发送 PDU。 ⚫ 在给出 PDU 时，DCD 信号应处于 ON 状态。 ⚫ 从 UE 返回的给定字符的回显由 V.25ter 回显命令 E 控制。 ⚫ PDU 应为十六进制格式（和 指定的类似）并在一行中给出；UE 将该编码转换为 PDU 的 实际八位字节。 ⚫ 当 SMSC 地址的八位字节长度（在 PDU 中给出）等于零时，使用以 AT+CSCA 命令设置的 SMSC 地址；在这种情况下，PDU 中不应存在 SMSC 地址的八位字节，也就是说 TPDU 长度计算在 SMSC 八位字节长度之后开始。 AT+CMGS 发送短信 设置命令 AT+CMGS= 返回 > 后输入 PDU。 响应 +CMGS: [,] OK 测试命令 AT+CMGS=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 整型。表示 3GPP TS 23.040 [3] TP-Message-Reference（消息参考）。 整型。表示在文本模式下消息体 （或 ）的长度。单位：字符；或者在 PDU 模式下，实际八位字节 TP 数据单元的长度（即 RP 层 SMSC 地址的八位字节不计 入长度）。范围：7~164。 表示 3GPP TS 23.040 [3] RP-ACK PDU 的 RP-User-Data 元素（用户数据元素）。格 式与 SMS 中 相同。但不同于 3GPP TS 24.011 [6] SC 地址字段，参数应和普 通字符串类型参数相同，由双引号标记。 整型。错误码。详情参见第 6 章。 备注 1. 目前不返回参数 。 2. 对于 PDU（3GPP TS 24.011）中的地址字段，应在其开头添加国家代码，例如中国的国家代码 86。 上海移远通信技术股份有限公司 89 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 3.5. AT+CMGC 发送短信命令 该命令可以从 TE 向网络发送命令消息（SMS-COMMAND）。文本的输入（3GPP TS 23.040 [3] TP-Command-Data）与 AT+CMGS 命令指定的类似，但格式固定为两个 IRA 字符长十六进制数的序列， UE 会将其转换为八位字节（参考 AT+CMGS）。消息传输成功时，消息参考值 会被返回给 TE。可 选择返回（当 AT+CSMS 的参数 的值为 1 且网络支持时）。参数值可在非请求的发送 状态上报结果码时被用来标识消息。如果在网络中消息发送失败或 UE 发生错误，则会返回最终结果码 +CME ERROR: 。该命令是可以中止的。 AT+CMGC 发送短信命令 设置命令 AT+CMGC= 返回 > 后输入 PDU。 响应 +CMGC: [,] OK 测试命令 AT+CMGC=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 整型。表示 3GPP TS 23.040 [3] TP-Message-Reference（消息参考）。 整型。表示在文本模式下消息体 （或 ）的长度。单位：字符；或者在 PDU 模式下，实际八位字节 TP 数据单元的长度（即 RP 层 SMSC 地址的八位字节不计 入长度）。范围：8~174。 表示 3GPP TS 23.040 [3] RP-ACK PDU 的 RP-User-Data 元素（用户数据元素）。格 式与 SMS 中 相同。但不同于 3GPP TS 24.011 [6] SC 地址字段，参数应和普 通字符串类型参数相同，由双引号标记。 整型。错误码。详情参见第 6 章。 备注 1. 目前不返回参数 。 2. 对于 PDU（3GPP TS 24.011）中的地址字段，应在其开头添加国家代码，例如中国的国家代码 86。 上海移远通信技术股份有限公司 90 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 3.6. AT+CMMS 发送更多信息 该命令用于控制 SMS 中继协议链路的连续性。当启用功能（并由网络支持）时，由于保持链接打开， 可以更快地发送多条消息。 AT+CMMS 发送更多信息 设置命令 响应 AT+CMMS=[] OK 查询命令 AT+CMMS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMMS: OK 测试命令 AT+CMMS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMMS:(支持的列表) 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。 0 禁用。 1 保持启用状态直到最新消息发送命令（AT+CMGS）响应和发送下一个命令之间时间超 过 1~5 秒（确切的值取决于 ME 实现），然后 ME 将关闭链路，TA 自动切换 为 0。 2 启用。如果最新消息发送命令和发送下一条命令的响应之间时间超过 1~5 秒（确切的值 取决于 ME 实现），ME 将关闭链路，TA 不会自动切换 为 0。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 91 / 210 举例 AT+CMMS=0 OK AT+CMMS? +CMMS:0 OK AT+CMMS=? +CMMS:(0,1,2) OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 上海移远通信技术股份有限公司 92 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4 一般命令 4.1. AT+NRB 重启 UE 该命令用来重启 UE。执行此命令之后，会有短暂的延迟，UE 才会重启。在执行该命令期间不再处理 其他 AT 命令。 须注意，由于 AT 命令的处理终止于该命令，因此最后不会返回 OK 表示命令行已处理完成。重启之前 不会发出确认消息。 AT+NRB 重启 UE 执行命令 AT+NRB 最大响应时间 特性说明 响应 REBOOTING 300 毫秒 / 举例 AT+NRB REBOOTING 4.2. AT+NUESTATS 查询 UE 统计信息 该命令用来获取最新的操作统计信息。该命令可以采用一个可选参数来显示不同的统计数据集。参数 =RADIO 和执行命令 AT+NUESTATS 一样会提供默认值集，=ALL 将打印所有数据。 AT+NUESTATS 查询 UE 统计信息 执行命令 AT+NUESTATS 响应 Signal power: Total power: TX power: TX time: 上海移远通信技术股份有限公司 93 / 210 设置命令 AT+NUESTATS=RADIO 查询具体无线信息 上海移远通信技术股份有限公司 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 RX time: Cell ID: ECL: SNR: EARFCN: PCI: RSRQ: OPERATOR MODE: CURRENT BAND: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:RADIO,Signal power: NUESTATS:RADIO,Total power: NUESTATS:RADIO,TX power: NUESTATS:RADIO,TX time: NUESTATS:RADIO,RX time: NUESTATS:RADIO,Cell ID: NUESTATS:RADIO,ECL: NUESTATS:RADIO,SNR: NUESTATS:RADIO,EARFCN: NUESTATS:RADIO,PCI: NUESTATS:RADIO,RSRQ: NUESTATS:RADIO,OPERATOR MODE: 94 / 210 设置命令 AT+NUESTATS=CELL 查询前八个小区信息 设置命令 AT+NUESTATS=THP 查询吞吐量 设置命令 AT+NUESTATS=BLER 查询误块率信息 上海移远通信技术股份有限公司 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 NUESTATS:RADIO,CURRENT BAND: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:CELL,,,,,,, [...NUESTATS:CELL,,,,,,,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:THP,, [...NUESTATS:THP,,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:BLER,, [...NUESTATS:BLER,,] OK 若出现任何错误： ERROR 95 / 210 设置命令 AT+NUESTATS=APPSMEM 查询动态存取使用情况 设置命令 AT+NUESTATS= 测试命令 AT+NUESTATS=? 最大响应时间 特性说明 上海移远通信技术股份有限公司 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 或者 +CME ERROR: 响应 NUESTATS:APPSMEM,Current Allocated: NUESTATS:APPSMEM,Total Free: NUESTATS:APPSMEM,Max Free: NUESTATS:APPSMEM,Num Allocs: NUESTATS:APPSMEM,Num Frees: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:,,[,<value[,[...]]] [...NUESTATS:,,[,<value[,[...]]]] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 96 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 不带引号的字符串类型。表示要显示的数据类型。参数 支持的值有： RADIO 具体无线信息 CELL 前 8 个小区信息 BLER 误块率信息 THP 吞吐量 APPSMEM 动态内存使用情况 ALL 所有信息。输出每种 数据类型的正确值。 如果 =RADIO，将返回默认值集： 信号功率。实际值需要除以十。 总功率。实际值需要除以十。 当前强发功率等级。实际值需要除以十。 自上次重启以来总的 TX 时间。单位：毫秒。 自上次重启以来总的 RX 时间。单位：毫秒。 上一个 SIB1 的小区 ID。 上一个 ECL 的值。 上一个 SNR 的值。 上一个 EARFCN 的值。 上一个 PCI 的值。 参考信号接收质量。实际值需要除以十。 SIB1 的部署模式。 0 未知模式 1 带内不同的 PCI 模式 2 带内相同的 PCI 模式 3 保护带模式 4 独立模式 服务小区的频段。 如果 =CELL 表示前 8 个小区信息，返回参数形式为：,,,,,, 绝对射频频道号。 物理小区 ID。 1 表示当前服务小区。 参考信号接收功率。 参考信号接收质量。 接收信号强度指示。 信噪比。 如果 =BLER，返回的参数类型如下： 误块率类型。 RLC 层误块率（上行），整数百分比。 RLC 层误块率（下行），整数百分比。 物理层误块率（上行），整数百分比。 物理层误块率（下行），整数百分比。 传输的总字节数。 上海移远通信技术股份有限公司 97 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 接收的总字节数。 发送的传输块。 接收的传输块。 重新传输的传输块。 收到 ACK/NACK 消息的总数。 如果 =THP，返回的参数类型如下： 整数。RLC 层吞吐量（上行）。单位：bps。 整数。RLC 层吞吐量（下行）。单位：bps。 整数。物理层吞吐量（上行）。单位：bps。 整数。物理层吞吐量（下行）。单位：bps。 如果 =APPSMEM，表示动态内存使用情况，返回的参数类型如下： 当前已分配的内存大小。 总的剩余内存大小。 最大的剩余内存大小。 分配内存的次数。 剩余内存的次数。 整型。错误码。详情参见第 6 章。 备注 1. 执行命令 AT+NUESTATS 的响应结果与设置命令 AT+NUESTATS=RADIO 的响应结果相同，但没 有命令和变量前缀（即 NUESTATS：RADIO）。 2. Tx time 和 Rx time 在三种情况下会清零，分别是 UE 开机、RRC 去激活、OOS 脱网。 举例 AT+NUESTATS Signal power:-842 Total power:-780 TX power:100 TX time:859 RX time:26543 Cell ID:137262770 ECL:0 SNR:226 EARFCN:3734 PCI:105 RSRQ:-108 OPERATOR MODE:4 CURRENT BAND:8 OK AT+NUESTATS=CELL NUESTATS:CELL,3734,105,1,-842,-108,-780,226 上海移远通信技术股份有限公司 98 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 OK AT+NUESTATS=THP NUESTATS:THP,RLC UL,100 NUESTATS:THP,RLC DL,98 NUESTATS:THP,MAC UL,103 NUESTATS:THP,MAC DL,100 OK AT+NUESTATS=BLER NUESTATS:BLER,RLC UL BLER,10 NUESTATS:BLER,RLC DL BLER,5 NUESTATS:BLER,MAC UL BLER,8 NUESTATS:BLER,MAC DL BLER,3 NUESTATS:BLER,Total TX bytes,1080 NUESTATS:BLER,Total RX bytes,900 NUESTATS:BLER,Total TX blocks,80 NUESTATS:BLER,Total RX blocks,80 NUESTATS:BLER,Total RTX blocks,100 NUESTATS:BLER,Total ACK/NACK RX,100 OK 4.3. AT+NEARFCN 指定搜索频点 该设置命令提供锁定特定 E-UTRAN 绝对射频信道号（EARFCN）的机制，如有需要，还可以锁定物 理小区 ID。在解除锁定或者 UE 重启之前，所有操作都将锁定到此载波上。该操作重启后不会保存，如果 指定的 EARFCN 不存在，则 UE 将进入停止服务模式。如果指定的 PCI 不存在，UE 也会进入停止服务模 式。 上海移远通信技术股份有限公司 99 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+NEARFCN 指定搜索频点 设置命令 AT+NEARFCN=,[,] 测试命令 AT+NEARFCN=? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 300 毫秒 特性说明 / 参数 整型。指定搜索类型并定义提供的参数。 0 锁定到指定的 EARFCN 整型。范围：0~65535。表示要搜索的 EARFCN。 整型。E-UTRAN 物理小区 ID。十六进制格式。有效范围 0~1F7。 整型。错误码。详情参见第 6 章。 举例 AT+NEARFCN=0,2506,AB OK 4.4. AT+NSOCR 创建 Socket 该命令可以在 UE 上创建一个 Socket，该命令与指定的协议相关。如果端口已设置，使能接收功能， 则对于在该端口上接收的任何消息，将上报 URC +NSONMI。 如果已经为协议或端口的组合创建了 Socket，那么第二次请求 AT+NSOCR 将会失败。 AT+NSOCR 创建 Socket 设置命令 AT+NSOCR=,,[,[,[,]]] 响应 OK 上海移远通信技术股份有限公司 100 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 Socket 类型。 DGRAM UDP STREAM TCP 整型。标准互联网协议。例如，UDP 为 17，TCP 为 6。 整型。范围：0~65535。表示一个包含在发送的消息中的本地端口，并会通过此本 地端口接收消息。如果为 0（在创建 TCP Socket 时），则模块将为此 Socket 分配 一个随机的 。 大于等于 0 的整型。表示创建的 Socket 的编号。最多支持 7 个 Socket，但其他服 务可能会占用 Socket。 整型。接收控制。 0 忽略传入消息 1 接收传输消息 字符串类型。地址族类型，IPv4 是 AF_INET，IPv6 是 AF_INET6。默认值为 AF_INET。 IP 地址。网络分配给 UE 的 IP 地址。 整型。错误码。详情参见第 6 章。 备注 1. 启用 BIP（承载独立协议）时，TCP 的 不能设置为 20000。 2. 最大支持 7 个 Socket，但是其他服务，例如 MQTT,CoAP 等，也许会减少 Socket 的最大数量。 3. 参数 中，端口 5683、5684、56830、56831 和 56833 为预留端口，不建议使用。 举例 AT+NSOCR=DGRAM,17,4587,1,AF_INET 1 OK AT+NSOCR=DGRAM,17,1234,0 1 OK 上海移远通信技术股份有限公司 101 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.5. AT+NSOST 发送消息（仅限 UDP） 该命令可以将包含长度字节数据的 UDP 数据报发送到 上的 ，并返 回发送的 Socket 以及发送的数据字节数。 AT+NSOST 发送消息（仅限 UDP） 设置命令 响应 AT+NSOST=,<remote_add , r>,,,[,< sequence>] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 IP 地址。支持十进制、八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：0~65535。 整型。表示要发送数据的十进制长度。默认最大长度为 1358 字节，实际取决于网 络下发的 MTU 值。 要传输的数据。十六进制字符串格式。 数据的序列。范围：1~255。如果省略，则不会上报数据发送状态。如果不省略， 当数据通过 RF 发送或丢弃时，将上报以下结果： +NSOSTR:,, 数据报状态。 0 错误 1 已发送 整型。错误码。详情参见第 6 章。 备注 在通过 RF 发送或丢弃数据之前，不能使用相同的 ，否则 AT 命令将返回 ERROR。 上海移远通信技术股份有限公司 102 / 210 举例 AT+NSOST=1,192.158.5.1,1024,2,AB30,1 1,2 OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.6. AT+NSOSTF 发送带标志的消息（仅限 UDP） 该命令可以将包含长度字节数据的 UDP 数据报发送到 上的 ，允许 设置元数据标志，并将返回发送的 Socket 以及发送的数据字节数。 AT+NSOSTF 发送带标志的消息（仅限 UDP） 设置命令 响应 AT+NSOSTF=,<remote_addr , >,,,,[,] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。表示由 AT+NSOCR 返回的 Socket 编号。 点分十进制 IPv4 地址。支持十进制，八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：0~65535。 整型。指定消息传输类型。此参数的值为十六进制格式，并通过对以下标志中的零 个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：表示收到该消息的回复后释放 若未设置 ，应将值设置为 0。 整型。要发送的数据长度。十进制格式。默认最大长度为 1358 字节，实际取决于 网络下发的 MTU 值。 要传输的数据。十六进制字符串格式。 数据的序列。范围：1~255。 如果省略，则不会上报数据发送状态。如果不省略， 上海移远通信技术股份有限公司 103 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 当数据通过 RF 发送或丢弃时，将上报以下结果： +NSOSTR:,, 数据报状态。 0 错误 1 已发送 整型。错误码。详情参见第 6 章。 备注 在通过 RF 发送或丢弃之前，不能使用相同的 ，否则 AT 命令将返回 ERROR。 举例 AT+NSOSTF=1,192.158.5.1,1024,0x100,2,AB30,1 1,2 OK 4.7. AT+NQSOS 查询待处理的 Socket 消息清单 UE 可以使用该命令查询待处理上行消息清单。 AT+NQSOS 查询待处理的 Socket 消息清单 设置命令 响应 AT+NQSOS=[,[,<so [+NQSOS:,] cket>[…]]] [+NQSOS:,] […] OK 查询命令 AT+NQSOS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+NQSOS:,] [+NQSOS:,] […] OK 上海移远通信技术股份有限公司 104 / 210 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。Socket 编号。 整型。待处理的上行消息序列。范围：1~255。 整型。错误码。详情参见第 6 章。 举例 AT+NQSOS=1,2 +NQSOS:1,2 +NQSOS:2,3 OK AT+NQSOS? +NQSOS:1,2 +NQSOS:2,3 OK 4.8. AT+NSORF 读取消息 该命令用于接收 Socket（）上的数据，响应中的 是返回的实际字符数。当数据到 达时，将上报 URC +NSONMI 响应结果以指示收到消息的 Socket 以及数据量。AT+NSORF 命令有一个长 度 ，此长度是返回的最大数据量。 如果请求的数据长度大于返回数据的实际长度，则仅提供返回数据的长度，并且剩余长度将返回为 0。 如果请求的数据长度小于返回数据的实际长度，则仅返回请求长度的数据，并指示剩余的字节数。消息完 全被读取后，如果有另一条消息需要处理，将发送新的 +NSONMI 通知。 如果消息的到达速度快于读取的速度，并且内部消息缓冲区已满，则最新消息将被丢弃。 上海移远通信技术股份有限公司 105 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+NSORF 读取消息 设置命令 AT+NSORF=, 响应 ,,,,, OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 返回的最大数据长度。十进制格式。最大请求数据长度为 1358 字节。 表示发送消息的系统地址。 点分十进制 IPv4 地址，点分十进制。IP 地址可以以十进制，八进制或十六进制表 示。仅支持 IPv4。 表示发送消息的远端端口。范围：0~65535。 表示返回的数据长度。十进制格式。 未读取的消息剩余数据长度。十进制字格式。剩余长度始终为 0 且剩余数据可读。 表示接收的数据，十六进制字符串格式。最大的接收数据长度是 1358 字节。 整型。错误码。详情参见第 6 章。 举例 AT+NSORF=1,10 1,192.168.5.1,1024,2,ABAB,0 OK 上海移远通信技术股份有限公司 106 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.9. AT+NSOCO 连接命令（仅限 TCP） 该命令将 TCP 服务器连接到指定的主机端口。 AT+NSOCO 连接命令（仅限 TCP） 设置命令 响应 AT+NSOCO=,, 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 / 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 发送消息的系统地址。支持十进制，八进制或十六进制表示。 连接的远端端口。范围：0~65535。支持十进制和十六进制格式。 整型。错误码。详情参见第 6 章。 举例 AT+NSOCO=1,192.158.5.1,1024 OK 4.10. AT+NSOSD 发送消息（仅限 TCP） 该命令可以发送 TCP 数据报到 TCP 服务器，会返回发送 Socket 和数据字节数量。AT+NSOSD 的返 回值将表示成功发送的数据长度。 AT+NSOSD 发送数据（仅限 TCP） 设置命令 响应 AT+NSOSD=,,<dat , a>[,[,]] OK 若出现任何错误： 上海移远通信技术股份有限公司 107 / 210 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 整型。表示发送的数据长度。十进制格式。默认最大长度为 1358 字节，实际取决 于网络下发的 MTU 值。 十六进制字符串格式。要传输的数据。 整型。指定消息传输的类型。此参数的值为十六进制格式，并通过对以下标志中的 零个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：指示收到该条消息的回复后释放 如果未设置 ，则应将值设置为 0。 整型。数据的序列。范围 1~255。如果省略，则不会上报数据发送状态；如果不省 略，当服务器应答数据帧或 UE 丢弃数据帧时，将上报以下结果： +NSOSTR:,, 数据报的状态。 0 错误 1 已发送 整型。错误码。详情参见第 6 章。 备注 参数 目前不生效。 举例 AT+NSOSD=1,2,AB30 1,2 OK AT+NSOSD=1,2,AB30,0x100 1,2 OK 上海移远通信技术股份有限公司 108 / 210 AT+NSOSD=1,2,AB30,0x100,255 1,2 OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.11. AT+NSOCL 关闭 Socket 该命令用于关闭指定的 Socket。如果有待读取的未处理消息，则会将它们删除。不再打印 +NSONMI 通知。如果 Socket 已经关闭，或者从未被创建，该命令会返回错误。 AT+NSOCL 关闭 Socket 设置命令 响应 AT+NSOCL= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 举例 AT+NSOCL=1 OK 整型。AT+NSOCR 返回的 Socket 编号。 整型。错误码。详情参见第 6 章。 4.12. AT+NSONMI 指示已到达 Socket 的消息 该命令用于设置 URC +NSONMI 指示已到达 Socket 的消息： 查询命令返回命令的当前设置。 上海移远通信技术股份有限公司 109 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+NSONMI 指示已到达的 Socket 消息 设置命令 AT+NSONMI= 响应 OK 查询命令 AT+NSONMI? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSONMI: OK 测试命令 AT+NSONMI=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSONMI:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。控制下行数据格式。 0 禁用 URC 指示消息。 1 启用 URC 指示消息： +NSONMI:,。 2 启用指示消息，服务器地址和用户数据 URC +NSONMI:,, ,,。 3 启用指示消息、用户数据 URC +NSONMI:,,. 整型。接收数据的 Socket。十进制数。由 AT+NSOCR 返回。 整型。第一条消息中的数据字节数。 上海移远通信技术股份有限公司 110 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 发送消息的系统地址。 整型。接收消息的远程端口。范围：0~65535。 十六进制字符串格式。接收到的数据。接收数据的最大长度为 1358 字节。 整型。错误码。详情参见第 6 章。 举例 AT+NSONMI=1 OK AT+NSONMI? +NSONMI:1 OK AT+NSONMI=? +NSONMI:(0,1,2,3) OK 备注 如果无缓存消息，则随时会返回 URC +NSONMI:, 以指示已收到新消息。如果有缓存消 息，则在通过 AT+NSORF 命令完全读取已缓存的消息之后，才会上报此 URC。 4.13. +NSOCLI 关闭 Socket 指示（仅用于响应） 这是一条非请求消息，通知 Socket 已经被 LwIP 内部关闭。它会返回 Socket 编号。 +NSOCLI 关闭 Socket 指示（仅用于响应） URC 格式： +NSOCLI: 参数 整型。接收数据的 Socket。十进制格式。由 AT+NSOCR 返回。 备注 此 URC 将仅在 TCP 模式下上报。 上海移远通信技术股份有限公司 111 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.14. AT+NPING 测试到远程主机的 IP 网络连接 该命令将 ICMP 数据包发送到指定的主机地址。 尝试 PING 操作最多不超过 1 次。如果在设置的超时期限内没有任何数据包收到响应，则将会发生错 误。 如果收到响应，将上报 +NPING 消息。如果没有收到响应，将返回带有错误值的 +NPINGERR 主动 响应消息。 AT+NPING 测试到远程主机的 IP 网络连接 设置命令 响应 AT+NPING=[,[,]] +NPING:,, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +NPINGERR: 300 毫秒 / 参数 发送消息的对端地址。点分十进制 IPv4 地址。IP 地址可以用十进制、八进制 或十六进制表示法指定。仅支持 IPv4。 整型。回显数据包有效负载的字节大小。范围：12~1500。默认值是 12。 整型。等待回显回复响应的最大时间。范围：10~600000。单位：毫秒。默认 值为 10000。 整型。响应包中收到的 TTL。 整型。从发送包到收到的响应所经过的时间。单位：毫秒。 整型。提供有关 PING 请求失败原因的相关信息。 1 在超时期间远端主机没有响应 2 发送 PING 请求失败 上海移远通信技术股份有限公司 112 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.15. AT+NBAND 设置支持的频段 该命令可设置要使用的频段。测试命令将返回硬件支持的所有频段。 AT+NBAND 设置支持的频段 设置命令 响应 AT+NBAND=[,[,[…]]] OK 查询命令 AT+NBAND? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NBAND:[,[,[…]]] OK 测试命令 AT+NBAND=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NBAND:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。十进制格式。频段。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 113 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 备注 AT+NBAND= 必须在无线处于不活动状态下执行（AT+CFUN=0 将强制模块进入此状态）。 举例 AT+NBAND=? +NBAND:(1,3,5,8,20,28) OK AT+NBAND? +NBAND:5,8,3,28,20,1 OK 4.16. AT+NLOGLEVEL 设置调试日志级别 该命令用来设置日志级别。该值在重启后保持不变。 AT+NLOGLEVEL 设置调试日志级别 设置命令 AT+NLOGLEVEL=, 响应 OK 查询命令 AT+NLOGLEVEL? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NLOGLEVEL:, […] OK 测试命令 AT+NLOGLEVEL=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NLOGLEVEL:(支持的列表),(支持的列表) 上海移远通信技术股份有限公司 114 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 字符串类型。请求的核。 PROTOCOL APPLICATION SECURITY 字符串类型。需要的日志级别 VERBOSE NORMAL WARNING ERROR NONE 整型。错误码。详情参见第 6 章。 举例 AT+NLOGLEVEL? +NLOGLEVEL: SECURITY,NORMAL +NLOGLEVEL: PROTOCOL,NORMAL +NLOGLEVEL: APPLICATION,NORMAL OK 上海移远通信技术股份有限公司 115 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.17. AT+NCONFIG 配置 UE 行为 该命令允许配置某些方面的 UE 行为。它的参数包含一个功能和一个控制该功能操作的值。 AT+NCONFIG 配置 UE 行为 设置命令 AT+NCONFIG=, 响应 OK 查询命令 AT+NCONFIG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCONFIG:, [+NCONFIG:,] […] OK 测试命令 AT+NCONFIG=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCONFIG:(,(,[, [,…]])) [+NCONFIG:(,(,[, [,…]]))] […] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 上海移远通信技术股份有限公司 116 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 字符串型。要配置的 UE 功能。 AUTOCONNECT 控制 UE 在开机或重启后是否会自动尝试连接 网络。当启用此功能时，它将设置 AT+CFUN=1 并从 USIM 中读取 PLMN。并且将使用网络提 供的 APN。 COMBINE_ATTACH CELL_RESELECTION 联合附着 小区重选 ENABLE_BIP MULTITONE 启用/禁用 BIP 多路 NAS_SIM_POWER_SAVING_ENABLE USIM 卡省电模式。 BARRING_RELEASE_DELAY 从禁止开始延时释放的时间。范围：0~1800。 单位：秒。 RELEASE_VERSION 发布版本。仅支持版本 R13 和 R14。当 UE 不 使用功率等级 6 时应设置为 13。 RPM RPM。如果 USIM 上存在 RPM 文件，USIM 设置将具有优先权。 SYNC_TIME_PERIOD 来自 eNB 的同步时间周期。范围：0~65535。 单位：分钟。0 表示关闭时间同步。 IPV6_GET_PREFIX_TIME 设 置 获 取 IPv6 前 缀 的 最 长 时 间 。 范 围 ： 0~65535。单位：秒。0 表示立即获取 IPv6 前 缀，65535 表示不获取 IPv6 前缀。 NB_CATEGORY 配置 NB-IoT 类别。目前只支持 1 和 2。 RAI 启用/禁用 RAI。 HEAD_COMPRESS 头压缩。 RLF_UPDATE 'FALSE'表示当无线链路失败时，NAS 将立 即 TAU。'TRUE'表示当无线链路失败时， 在 TAU 之前期望会发出 ACK。 CONNECTION_REESTABLISHMENT TWO_HARQ 重建连接。 双 HARQ PCO_IE_TYPE PCO 类型。支持'PCO'和'EPCO'。 T3324_T3412_EXT_CHANGE_REPORT 启用/禁用当和/或 的 NAS 计时器更改时， AT+CEREG=5 的 URC 显示。 NON_IP_NO_SMS_ENABLE 'TRUE'表示 为 Non-IP 时， SUPPORT_SMS 不支持 SMS。 启用/禁用 SMS。 HPPLMN_SEARCH_ENABLE 启用/禁用 HPPLMN 搜索。 配置的 UE 功能值。与 对应的值如下： AUTOCONNECT 布尔型（TRUE 启用，FALSE 禁用） COMBINE_ATTACH 布尔型（TRUE 启用，FALSE 禁用） CELL_RESELECTION 布尔型（TRUE 启用，FALSE 禁用） 上海移远通信技术股份有限公司 117 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 ENABLE_BIP MULTITONE NAS_SIM_POWER_SAVING_ENABLE BARRING_RELEASE_DELAY RELEASE_VERSION RPM SYNC_TIME_PERIOD IPV6_GET_PREFIX_TIME NB_CATEGORY RAI HEAD_COMPRESS RLF_UPDATE CONNECTION_REESTABLISHMENT TWO_HARQ PCO_IE_TYPE T3324_T3412_EXT_CHANGE_REPORT NON_IP_NO_SMS_ENABLE SUPPORT_SMS HPPLMN_SEARCH_ENABLE 整型。错误码。详情参见第 6 章。 布尔型（TRUE 启用，FALSE 禁用） 布尔型（TRUE 启用，FALSE 禁用） 布尔型（TRUE 启用，FALSE 禁用） 整型。范围：0~1800；单位：秒。 整型。当 UE 不使用功率等级 6 时应设置为 13。 布尔型（TRUE 启用，FALSE 禁用） 整型。0 表示关闭时间同步。范围：0~65535； 单位：分钟。 整型。0 表示立即获取 IPv6 前缀，65535 表示 不获取 IPv6 前缀。范围：0~65535；单位：秒。 整型。配置 NB-IoT 类别。目前只支持 1 和 2。 布尔型（TRUE 启用，FALSE 禁用） 布尔型（TRUE 启用，FALSE 禁用） 布尔型（TRUE 表示当无线链路失败时，在 TAU 之前期望会发出 ACK，FALSE 表示当无线链 路失败时，NAS 将立即 TAU） 布尔型（TRUE 启用，FALSE 禁用） 布尔型（TRUE 启用，FALSE 禁用） 字符串型。支持 'PCO' 和 'EPCO'。 布尔型（TRUE 启用，FALSE 禁用） 布尔型。TRUE 表示 为 Non-IP 时，不支持 SMS。 布尔型（TRUE 启用，FALSE 禁用） 布尔型（TRUE 启用，FALSE 禁用） 备注 只有当无线处于非活动状态时（AT+CFUN=0 将强制模块进入此状态），才能设置 MULTITONE、 NAS_SIM_POWER_SAVING_ENABLE 、 RELEASE_VERSION 、 SYNC_TIME_PERIOD 、 NB_ CATEGORY、RAI、HEAD_COMPRESS、TWO_HARQ、PCO_IE_TYPE、HPPLMN_SEARCH_ ENABLE 和 SUPPORT_SMS。 举例 AT+NCONFIG? +NCONFIG:AUTOCONNECT,TRUE +NCONFIG:CR_0354_0338_SCRAMBLING,TRUE +NCONFIG:CR_0859_SI_AVOID,TRUE +NCONFIG:COMBINE_ATTACH,FALSE +NCONFIG:CELL_RESELECTION,TRUE +NCONFIG:ENABLE_BIP,FALSE +NCONFIG:MULTITONE,TRUE +NCONFIG:NAS_SIM_POWER_SAVING_ENABLE,TRUE 上海移远通信技术股份有限公司 118 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 +NCONFIG:BARRING_RELEASE_DELAY,64 +NCONFIG:RELEASE_VERSION,14 +NCONFIG:RPM,FALSE +NCONFIG:SYNC_TIME_PERIOD,0 +NCONFIG:IPV6_GET_PREFIX_TIME,15 +NCONFIG:NB_CATEGORY,2 +NCONFIG:RAI,TRUE +NCONFIG:HEAD_COMPRESS,FALSE +NCONFIG:RLF_UPDATE,TRUE +NCONFIG:CONNECTION_REESTABLISHMENT,TRUE +NCONFIG:TWO_HARQ,TRUE +NCONFIG:PCO_IE_TYPE,EPCO +NCONFIG:T3324_T3412_EXT_CHANGE_REPORT,FALSE +NCONFIG:NON_IP_NO_SMS_ENABLE,FALSE +NCONFIG:SUPPORT_SMS,FALSE +NCONFIG:HPPLMN_SEARCH_ENABLE,TRUE OK AT+NCONFIG=? +NCONFIG:(AUTOCONNECT,(FALSE,TRUE)) +NCONFIG:(CR_0354_0338_SCRAMBLING,(FALSE,TRUE)) +NCONFIG:(CR_0859_SI_AVOID,(FALSE,TRUE)) +NCONFIG:(COMBINE_ATTACH,(FALSE,TRUE)) +NCONFIG:(CELL_RESELECTION,(FALSE,TRUE)) +NCONFIG:(ENABLE_BIP,(FALSE,TRUE)) +NCONFIG:(MULTITONE,(FALSE,TRUE)) +NCONFIG:(NAS_SIM_POWER_SAVING_ENABLE,(FALSE,TRUE)) +NCONFIG:(BARRING_RELEASE_DELAY,(0-1800)) +NCONFIG:(RELEASE_VERSION,(13,14)) +NCONFIG:(RPM,(FALSE,TRUE)) +NCONFIG:(SYNC_TIME_PERIOD,(0-65535)) +NCONFIG:(IPV6_GET_PREFIX_TIME,(0-65535)) +NCONFIG:(NB_CATEGORY,(1,2)) +NCONFIG:(RAI,(FALSE,TRUE)) +NCONFIG:(HEAD_COMPRESS,(FALSE,TRUE)) +NCONFIG:(RLF_UPDATE,(FALSE,TRUE)) +NCONFIG:(CONNECTION_REESTABLISHMENT,(FALSE,TRUE)) +NCONFIG:(TWO_HARQ,(FALSE,TRUE)) +NCONFIG:(PCO_IE_TYPE,(PCO,EPCO)) +NCONFIG:(T3324_T3412_EXT_CHANGE_REPORT,(FALSE,TRUE)) +NCONFIG:(NON_IP_NO_SMS_ENABLE,(FALSE,TRUE)) +NCONFIG:(SUPPORT_SMS,(FALSE,TRUE)) +NCONFIG:(HPPLMN_SEARCH_ENABLE,(FALSE,TRUE)) 上海移远通信技术股份有限公司 119 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 OK 4.18. AT+NATSPEED 配置 UART 端口波特率 该命令用于配置 UART 端口波特率。 AT+NATSPEED 配置 UART 端口波特率 设置命令 响应 AT+NATSPEED=,,,[,[,[,]]] 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+NATSPEED? +NATSPEED:,,,[,] OK 测试命令 AT+NATSPEED=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NATSPEED:(支持的列表),(支持的 范围),(支持的列表),(支持的范围),(支持 的列表),(支持的范围),(支持的 列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。需要在 timeout 时间内进行通信激活。 进入深休眠或 AT+NRB 重启后保存到 KV。 上海移远通信技术股份有限公司 120 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 整型。表示已请求的 UART 端口的波特率。 值大于低功耗 UART 所 支持的最快速度（目前版本为 57600）时，将禁用深度睡眠的低功耗操作，将返回： +NATSPEED:DISABLE_DEEP_SLEEP。 整型。表示在切换回原来速度之前等待通信的时间。单位：秒。默认值：3。最大值： 30。0 表示使用默认值。 整型。表示是否将 和 存储到 KV。 0 不存储到 KV，重启后需要重新配置 1 存储到 KV，超时前有交互。 整型。LP UART 同步到它检测到的每个起始位，并使用它为数据中的每个后续位配 置其最佳采样点。如果需要，'同步模式'字段允许修改此采样点。当 为 2400bps 、4800bps 和 57600bps 时， 不支持 3。 该参数可能在以后的版本中删除。 0 正常采样 1 稍后采样 2 提前采样 3 更早采样 整型。LP UART 停止位。 1 1 个停止位 2 2 个停止位 整型。AT UART 奇偶校验。 0 未启用奇偶校验 1 奇校验 2 偶校验 AT UART 软件（XON/XOFF）流控 0 禁用软件流控 1 启用软件流控 整型。错误码。详情参见第 6 章。 举例 AT+NATSPEED=9600,3,1,2,1 OK AT+NATSPEED? +NATSPEED:9600,2,1,0,0 OK AT+NATSPEED=? +NATSPEED:(2400,4800,9600,57600,115200,230400,460800,921600),(0-30),(0,1),(0-3),(1,2),(0-2),(0,1) OK 上海移远通信技术股份有限公司 121 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 备注 修改 参数时，应在 超时之前使用新的波特率参数与模块进行通信。 4.19. AT+NCCID 识别 USIM 卡 执行和查询命令都可以从 USIM 卡读取 ICCID。如果没有 USIM 卡，或者 USIM 卡不可读，则会报错， 不返回任何 USIM 卡数据。 AT+NCCID 识别 USIM 卡 执行命令 AT+NCCID 响应 +NCCID: OK 查询命令 AT+NCCID? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCCID: OK 测试命令 AT+NCCID=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 USIM 卡识别码。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 122 / 210 举例 AT+NCCID +NCCID:44123456789012345678 OK AT+NCCID? +NCCID:44123456789012345678 OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.20. AT+NFWUPD 通过 UART 更新固件 该命令支持固件更新。它允许固件包擦除、下载、固件包最后验证结果检查、固件包名和版本查询以 及固件升级。 在升级固件之前，需要首先擦除固件包区域并下载固件包。下载完成后，发送固件升级命令。然后系 统将重新启动并验证固件包，如果固件包是合法的，会开始将固件升级到新版本，否则将重新启动而不升 级，然后用户可以使用相应的 AT 命令检查固件包验证错误信息。 AT+NFWUPD 通过 UART 更新固件 设置命令 响应 AT+NFWUPD=[,,,,] 若出现任何错误： ERROR 或者 测试命令 AT+NFWUPD=? +CME ERROR: 响应 +NFWUPD:(支持的范围) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 123 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 整型。固件包处理命令。 0 清除内部闪存中的固件包区域 1 ,,,。下载固件包段。下载 FOTA 包。固件包段是 FOTA 包的 连续段。固件包段的长度应为 32/64/128/256/512，并且必须按顺序提供。 2 获取上次更新的包验证结果： PACKAGE_OK 数据包正常 PACKAGE_CORRUPT 数据包损坏 PACKAGE_NOT_PROCESSED 未处理 PACKAGE_VALIDATION_FAILURE 验证失败 PACKAGE_UNSUPPORTED_OPTIONS 不支持的选项 PACKAGE_VERSION_MISMATCHED 版本不匹配 PACKAGE_ELEMENT_TOO_LONG 元素太长 PACKAGE_REGION_LOST 部分丢失 PACKAGE_SIGNATURE_OR_HASH_LACKED 缺少签名或 HASH PACKAGE_NOT_DOWNLOADED 未下载 PACKAGE_NOT_VALIDATION 未验证 3 获取固件包名称 4 获取固件包版本 5 更新固件 整型。序列号。从 0 开始，每个包段依次递增 1。 整型。数据长度。单位：字节。 要传输数据。十六进制字符串格式。 整型。包段中每个字节的 XOR8。以十六进制形式发送。 整型。错误码。详情参见第 6 章。 备注 R01 或更高版本支持 =3 和 =4。 4.21. AT+NPOWERCLASS 设置 Band 和 Power Class 的映射 该命令用于设置频段和功率等级的映射。该查询命令列出了频段和功率等级的所有映射。 AT+NPOWERCLASS 设置 Band 和 Power Class 的映射 设置命令 响应 AT+NPOWERCLASS=, OK 若出现任何错误： 上海移远通信技术股份有限公司 124 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 查询命令 AT+NPOWERCLASS? 测试命令 AT+NPOWERCLASS=? 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 响应 +NPOWERCLASS:, […] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPOWERCLASS:(支持的列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。频段，作为映射的关键。 整型。频段的功率等级。当前仅支持级别 3、5 和 6；单位：dBm。只有当无线处于 非活动状态时（AT+CFUN=0 将强制模块进入此状态）才能设置该参数。 功率等级 3 5 6 最大发射功率 23 20 14 整型。错误码。详情参见第 6 章。 备注 只有当 AT+NCONFIG 中的 RELEASE_VERSION 为 14 时， 才能被设置为 6。 上海移远通信技术股份有限公司 125 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.22. AT+NPSMR 省电模式状态上报 设 置 命 令 用 于 控 制 URC +NPSMR 的 显 示 。 如 果 =1 ， 在 功 率 模 式 发 生 改 变 时 ， 则 上 报 +NPSMR:。 查询命令在 =0 时返回 +NPSMR:，在 =1 时返回 +NPSMR:,。 AT+NPSMR 省电模式状态上报 设置命令 响应 AT+NPSMR= OK 查询命令 AT+NPSMR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPSMR:[,] OK 测试命令 AT+NPSMR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPSMR:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。启用/禁用 URC。 0 禁用 URC 1 启用 URC +NPSMR: 上海移远通信技术股份有限公司 126 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 整型。UE 的功率模式。 0 正常模式 1 省电模式 整型。错误码。详情参见第 6 章。 4.23. AT+NPTWEDRXS 设置 PTW 和 eDRX 设置命令用于控制 UE PTW 和 eDRX 参数的设置。该命令控制 UE 是否想应用 PTW 和 eDRX，以及 每个指定接入技术类型所请求的 PTW 和 eDRX 值。 当 =2 并且网络提供的 PTW 和 eDRX 参数发生变化时，设置命令还控制相关 URC 的显示。 AT+NPTWEDRXS=3 为该命令的特殊形式。在此特殊形式中，将禁用 PTW 和 eDRX，并且命令中所 有参数的数据将被删除。 查询命令返回 的当前设置。该测试命令以复合值的形式将支持的 和访问技术 的取值范围以及请求的 PTW 和请求的 eDRX 值返回。 AT+NPTWEDRXS 设置 PTW 和 eDRX 设置命令 响应 AT+NPTWEDRXS=,[,[,]] OK 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+NPTWEDRXS? +NPTWEDRXS:,,[,[,]] OK 测试命令 AT+NPTWEDRXS=? 若出现任何错误： ERROR 或者 +CME ERROR: +NPTWEDRXS:(支持的列表),(支持的列 表),(支持的范围),(支 持的范围) 上海移远通信技术股份有限公司 127 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。启用或禁用 UE 中请求的 PTW 和 eDRX。该参数适用于所有指定类型的接入技术， 即 的最新设置将对所有指定的 值生效。当设置 为 0 并且没有 或 时，则会将省略值设置为无效值，如 0x00。 0 禁用请求的 PTW 和 eDRX 1 启用请求的 PTW 和 eDRX 2 启用请求的 PTW 和 eDRX，并且启用 URC： +NPTWEDRXP:[,[,[,[,]]]] 3 禁用 eDRX 并移除 eDRX 的所有参数。 整型。接入技术的类型。该参数用于指定接入技术类型与请求的 eDRX 值之间的关系。 5 E-UTRAN（NB-S1 模式） 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 PTW 长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 上海移远通信技术股份有限公司 128 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN DRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 PTW 长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 上海移远通信技术股份有限公司 129 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 1 1 1 1 40.96 秒 整型。错误码。详情参见第 6 章。 4.24. AT+NPIN PIN 操作 设置命令用于验证、更改、启用、禁用或解锁 PIN。执行完 PIN 命令后，将收到 URC。 USIM PIN 和 USIM PUK 是指 UICC 上所选应用程序的 PIN。例如，在 E-UTRAN 上下文中，当前选定 UICC 上的所选应用程序应为 USIM，而 USIM PIN 则表示所选 USIM 的 PIN。有关 UICC 应用选择的更多 详细信息，请参考 3GPP TS 31.101 [65]。 AT+NPIN PIN 操作 设置命令 响应 AT+NPIN=, OK [,] +NPIN: 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。PIN 操作模式。 0 1 2 3 4 参数随 的设置而变化。 当 为 0、2 和 3 时，它是 。 当 为 1 时，它是 。 当 为 4 时，它是 。 参数随 的设置而变化。 当 为 0、2 和 3 时，参数被省略。 当 为 1 时，它是 。 PIN 操作模式 验证 PIN 码 更改 PIN 码 启用 PIN 码 禁用 PIN 码 解锁 PIN 码 上海移远通信技术股份有限公司 130 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 ,, 当 为 4 时，它是 。 字符串类型。十进制数。 应与来自 MT 用户接口设备指定密码 或者 AT+NPIN=1,, 相同。 为设备指定的 密码相同。 是新密码。最小长度为 4，最大长度为 8。单位： 字节。 字符串类型。十进制格式。字符串大小为 8。单位：字节。 字符串类型。表示结果。 'OK' 'ERROR PIN disabled' 'ERROR PIN blocked' 'ERROR wrong PIN ' 'ERROR wrong format' 'ERROR' 十进制数，剩余的 PIN 重试次数。如果无剩余重试次数，则 PIN 被锁定。 再次使用 PIN 之前，需要输入 AT+NPIN=4,,。 整型。错误码。详情参见第 6 章。 举例 AT+NPIN=0,29102394 OK +NPIN:OK 4.25. AT+NCSEARFCN 清除存储的频点 该命令用于清除存储的频点。 AT+NCSEARFCN 清除存储的频点 执行命令 响应 AT+NCSEARFCN OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 131 / 210 参数 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 整型。错误码。详情参见第 6 章。 备注 该命令必须在无线处于非活动状态时执行（AT+CFUN=0 将强制模块进入此状态）。 举例 AT+NCSEARFCN OK 4.26. AT+NIPINFO 上报 IP 地址信息 该命令用于上报 IP 地址信息。设置命令设置是否显示 URC： ⚫ 如果成功获取 IP 地址，将不会响应 。URC 将以 +NIPINFO:,, 的格式上报。 ⚫ 如果获取 IP 地址失败，将不会响应 。URC 将以 +NIPINFO:,, 的格式上报。 查询命令返回当前设置的 状态。 AT+NIPINFO 上报 IP 地址信息 设置命令 响应 AT+NIPINFO= OK 查询命令 AT+NIPINFO? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NIPINFO: OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 132 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+NIPINFO=? 最大响应时间 特性说明 +CME ERROR: 响应 +NIPINFO:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。 0 禁用 URC 1 启用 URC +NIPINFO:,,[],[] 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT）。范围：0~10。 整型。指定 IP 地址的类型。 IP 互联网协议（IETF STD 5 [103]） IPV6 互联网协议，版本 6 IPV4V6 引入虚拟参数 以处理双 IP 栈 UE 容量。 字符串类型。IP 地址。IPv4 地址为点分十进制，例如 100.1.0.26。IPv6 地址，以 十六进制数和冒号表示，例如 108F: 0: 0: 0: 8: 800: 200C: 417A。当地址获取失败 时，该参数不显示。 整型。获取 IP 地址失败的原因。 1 仅允许 PDN 类型 IPv4 2 仅允许 PDN 类型 IPv6 3 仅允许单地址承载 4 IPv6 RA 超时 5 未指定 整型。错误码。详情参见第 6 章。 举例 AT+NIPINFO=1 OK AT+NIPINFO? +NIPINFO:1 OK 上海移远通信技术股份有限公司 133 / 210 AT+NIPINFO=? +NIPINFO:(0,1) OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.27. AT+NCPCDPR 配置要读取的 PDP 上下文动态参数 该命令用于配置需要读取的 PDP 上下文动态参数。 AT+NCPCDPR 配置要读取的 PDP 上下文动态参数 设置命令 响应 AT+NCPCDPR=, OK 查询命令 AT+NCPCDPR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCPCDPR:, [+NCPCDPR:,] [...] OK 测试命令 AT+NCPCDPR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCPCDPR:(支持的列表),(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 上海移远通信技术股份有限公司 134 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 整型。要读取的动态参数。 0 获取 DNS 服务器 IPv4 地址请求 1 获取 DNS 服务器 IPv6 地址请求 整型。PDP 上下文动态参数读取状态。 0 禁用获取 1 启用获取 整型。错误码。详情参见第 6 章。 备注 该命令必须在无线处于非活动状态时执行（AT+CFUN=0 将强制模块进入此状态）。 举例 AT+NCPCDPR=1,1 OK AT+NCPCDPR? +NCPCDPR:0,1 +NCPCDPR:1,1 OK AT+NCPCDPR=? +NCPCDPR:(0,1),(0,1) OK 4.28. AT+NQPODCP 通过控制面查询待处理的原始数据列表 该命令用于 UE 通过控制平台查询待处理的原始数据列表。 AT+NQPODCP 通过控制面查询待处理的原始数据列表 设置命令 响应 AT+NQPODCP= [+NQPODCP:[[...]]] OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 135 / 210 测试命令 AT+NQPODCP=? 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 +CME ERROR: 响应 +NQPODCP:(支持的范围) OK 300 毫秒 / 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT）。范围：0~10。 整型。待处理的原始消息序列号。范围：1~255。 整型。错误码。详情参见第 6 章。 举例 AT+NQPODCP=1 OK AT+NQPODCP=? +NQPODCP:(0-10) OK 4.29. AT+NITZ 设置时间更新模式 该命令用于设置时间更新模式。查询命令会返回 UE 中的当前时间更新模式。 如果由于 UE 发生错误而导致设置失败，则返回 +CME ERROR:。 AT+NITZ 设置时间更新模式 设置命令 响应 AT+NITZ= OK 查询命令 AT+NITZ? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NITZ: OK 上海移远通信技术股份有限公司 136 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+NITZ=? 最大响应时间 特性说明 参数 举例 AT+NITZ=1 OK AT+NITZ? +NITZ:1 OK AT+NITZ=? +NITZ:(0,1) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NITZ:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 整型。表示时间更新模式。 0 通过本地时间更新时间 1 通过 NITZ 更新时间 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 137 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.30. AT+QLEDMODE 设置 NETLIGHT 功能模式 该命令用于设置 NETLIGHT LED 指示灯的功能模式。 AT+QLEDMODE 设置 NETLIGHT 功能模式 设置命令 响应 AT+QLEDMODE= OK 查询命令 AT+QLEDMODE? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLEDMODE: OK 测试命令 AT+QLEDMODE=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLEDMODE:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。NETLIGHT LED 指示灯的功能模式。 0 禁用 NETLIGHT LED 功能，NETLIGHT 引脚输出低电平。 1 启用 NETLIGHT LED 功能，NETLIGHT 引脚输出 PWM 信号。不同的高电平持续 时间和低电平持续时间表示不同的网络状态。 高电平持续时间 低电平持续时间 网络状态 64 毫秒 800 毫秒 网络搜索 上海移远通信技术股份有限公司 138 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 64 毫秒 2000 毫秒 整型。错误码。详情参见第 6 章。 连接状态 备注 如果启用 NETLIGHT LED 指示灯功能，可能导致模块消耗更多电量。 举例 AT+QLEDMODE=1 OK 4.31. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置和查询 DNS 服务器地址。查询命令返回当前使用的 DNS 服务器地址。 AT+QIDNSCFG 配置 DNS 服务器地址 设置命令 响应 AT+QIDNSCFG=[,] OK 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+QIDNSCFG? PrimaryDns: SecondaryDns: OK 测试命令 AT+QIDNSCFG=? 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 该命令立即生效。 不保存到 KV。 上海移远通信技术股份有限公司 139 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 字符串类型。表示首选域名服务器地址。 字符串类型。表示备用域名服务器地址。若未设置，则查询命令返回 0.0.0.0。 整型。错误码。详情参见第 6 章。 备注 1. 在执行 AT+QDNS 过程中，不允许配置 DNS 服务器地址。 2. 如果未配置 DNS 服务器地址，则默认将使用网络提供的 DNS 服务器地址或模块预置 DNS 服务器地 址。模块预置 DNS 服务器地址仅在网络不下发 DNS 服务器地址时使用，由于预置 DNS 服务器地址 并非移远维护，存在不确定因素，请客户充分知悉后使用，并建议客户优先要求运营商网络正常下发 DNS 服务器地址。 举例 AT+QIDNSCFG=? OK AT+QIDNSCFG? PrimaryDns: 218.4.4.4 SecondaryDns: 208.67.222.222 OK AT+QIDNSCFG=8.8.8.8,8.8.4.4 OK AT+QIDNSCFG? PrimaryDns: 8.8.8.8 SecondaryDns: 8.8.4.4 OK 4.32. AT+QDNS 触发 DNS 域名解析 该命令用于触发 DNS 域名解析。当域名解析完成后，UE 将显示域名解析的结果：+QDNS:。 如果未返回域名解析结果，再执行该设置命令，则会上报 ERROR。 每个 DNS IP 重试三次，每次间隔默认 100 秒。 AT+QDNS 触发 DNS 域名解析 设置命令 响应 AT+QDNS=[,] OK 上海移远通信技术股份有限公司 140 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 +QDNS: 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。 0 DNS 域名解析，不能为空。 1 如果不为空，则清除内存中的主机名解析数据和 KV。如果 为空，则将清除所有解析数据。 2 DNS 域名解析，不能为空。模块不缓存解析结果。 字符串类型。域名。 字符串类型。域名解析的结果。 域名解析成功则为相应的 IP 地址，若失败则为 FAIL。 整型。错误码。详情参见第 6 章。 举例 AT+QDNS=0,www.baidu.com OK +QDNS:111.13.100.91 4.33. AT+QCFG 扩展配置设置 该命令用于查询和配置 UE 的各种设置。 AT+QCFG 扩展配置设置 查询命令 响应 AT+QCFG? OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 141 / 210 测试命令 AT+QCFG=? 最大响应时间 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 4.33.1. AT+QCFG='LWM2M/Lifetime' 配置 OceanConnect IoT 平台注册生命周期 该命令用于配置 OceanConnect IoT 平台的生命周期值。UE 的更新注册时间约为生命周期的 0.9 倍。 AT+QCFG='LWM2M/Lifetime' 配置 OceanConnect IoT 平台注册生命周期 设置命令 AT+QCFG='LWM2M/Lifetime'[,] 响应 若省略可选参数，则查询平台的生命周期值： +QCFG: 'LWM2M/Lifetime', OK 若指定可选参数，则配置平台的生命周期值： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。LwM2M 协议的生命周期。范围：0~(30 x 86400)；默认值：86400；单位：秒。 0 禁用生命周期功能。UE 将不会定期向 OceanConnect loT 平台发送更新注 册包。 1~30x86400 启用生命周期功能。但即使 UE 将生命周期值设置为 1~899 秒， 的最小有效值仍是 900 秒。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 142 / 210 举例 AT+QCFG='LWM2M/lifetime' +QCFG: 'LWM2M/Lifetime',0 OK AT+QCFG='LWM2M/lifetime',900 OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.33.2. AT+QCFG='LWM2M/EndpointName' 配置接入 IoT 平台时的端点名称 该命令用于配置接入 IoT 平台时的端点名称（Endpoint Name），若未配置，则把使用的 IMEI 号作为 默认值。 AT+QCFG='LWM2M/EndpointName' 配置接入 IoT 平台时的端点名称 设置命令 AT+QCFG='LWM2M/EndpointName' [,] 响应 若省略可选参数，则查询接入 IoT 平台的端点名称： +QCFG: 'LWM2M/EndpointName', OK 若指定可选参数，则配置接入 IoT 平台的端点名称： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 字符串格式。LwM2M 客户端标识符（包括 LwM2M Bootstrap-Server）。最大 长度：255 个字符。 整型。错误码。详情参见第 6 章。 举例 AT+QCFG='LWM2M/EndpointName','1234567890' OK AT+QCFG='LWM2M/EndpointName' 上海移远通信技术股份有限公司 143 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 +QCFG: 'LWM2M/EndpointName','1234567890' OK 4.33.3. AT+QCFG='LWM2M/BindingMode' 配置接入 IoT 平台时的绑定模式 该命令用于配置接入 IoT 平台时的绑定模式。 AT+QCFG='LWM2M/BindingMode' 配置接入 IoT 平台时的绑定模式 设置命令 响应 AT+QCFG='LWM2M/BindingMode'[, 若省略可选参数，则查询当前接入 IoT 平台的绑定模式： ] +QCFG: 'LWM2M/BindingMode', OK 若指定可选参数，则配置接入 IoT 平台的绑定模式： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。LwM2M 协议的绑定模式。 1 UDP 模式 2 UDP queue 模式 整型。错误码。详情参见第 6 章。 举例 AT+QCFG='LWM2M/ BindingMode ' +QCFG: 'LWM2M/BindingMode',1 OK AT+QCFG='LWM2M/BindingMode',2 OK AT+QCFG='LWM2M/BindingMode' 上海移远通信技术股份有限公司 144 / 210 +QCFG: 'LWM2M/BindingMode',2 OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.34. AT+NSNPD 发送 Non-IP 数据 TE 使用设置命令通过 MT 将 Non-IP 数据通过控制面或用户面发送到网络。上下文标识符 用于 将数据链接到特定上下文。该命令还可指示要传输的数据是否为异常数据。 该命令可发送 ESM DATA TRANSPORT 消息，如 3GPP TS 24.301 [83] 中所定义的一样。 AT+NSNPD 发送 Non-IP 数据 设置命令 响应 AT+NSNPD=,,[,[,[,]]] OK 若出现任何错误： ERROR 或者 测试命令 AT+NSNPD=? +CME ERROR: 响应 +NSNPD:(支持的范围),(支持的 最大发送字节数),(支持的列表),(支持的列表),(支持的范围) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。指定某个 PDP 上下文或 EPS 承载上下文定义。 是 TE-MT 接 口的本地参数，用于识别通过 AT 命令设置的 PDP 或 EPS 承载上下文（参 考 AT+CGDCONT）。范围：0~10。 整型。指示 信息元素的字节数。当没有数据要传输时，该 值应设置为零。范围：0~1358。 上海移远通信技术股份有限公司 145 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 八位字节的字符串。包含用户数据内容（参考 3GPP TS 24.301 [83]子条款 9.9.4.24）。当没有数据要传输时，应为空字符串（''）。 此 参数不应按照 AT+CSCS 进行常规字符转换。用户数据容器的编码格式和 的最大长度是特定实现的。 整型。释放辅助指示的值，参考 3GPP TS 24.301 [83]子条款 9.9.4.25。 0 无指示 1 指示数据传输后不期望有进一步上下行数据，可立即释放。 2 指示数据传输后期望有下行数据，收到下行数据后可释放。 整型。指示传输的用户数据是常规还是异常。 0 常规数据 1 异常数据 数据序列。范围：1~255。如果省略，将不上报数据发送状态；如果未省 略，则当服务器确认数据包或 UE 丢弃时，将上报 URC： +NSNPDR:,,。 整型。数据报的状态。 0 错误 1 已发送 整型。错误码。详情参见第 6 章。 备注 1. 使用 Non-IP 时，最大数据长度为 1358 字节，否则为 0。 2. 任何时候只能缓冲一条消息。 举例 AT+NSNPD=? +NSNPD:(0-10),(0),(0,1,2),(0,1),(1-255) OK 4.35. AT+NRNPDM 设置 Non-IP 数据模式上报 设置命令用于启用和禁用从网络到 MT 的 Non-IP 数据上报，MT 通过控制面或用户面在下行链路方向 传输。如果启用了上报，则 MT 会在从网络接收数据时返回如下 URC： +NRNPDM:,,。 查询命令返回当前设置。 上海移远通信技术股份有限公司 146 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+NRNPDM 设置 Non-IP 数据模式上报 设置命令 响应 AT+NRNPDM= OK 查询命令 AT+NRNPDM? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NRNPDM: OK 测试命令 AT+NRNPDM=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NRNPDM:(支持的范围),(支持的范围),(由 指示的用户数据的最大八位字节数) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型，控制 MT Non-IP 数据事件报告。 0 禁用 MT Non-IP 数据报告 1 通过 URC +NRNPDM 启用 MT Non-IP 数据报告 整型。数字参数，指定某个 PDP 上下文或 EPS 承载上下文定义。 是 TE-MT 接口的本地参数，用于识别通过 AT 命令设置的 PDP 或 EPS 承载上 下文（参考 AT+CGDCONT）。范围：0~10。 整型。指示 信息元素的字节数。当没有数据要传输时，该值 应设置为零。范围：0~1358。 八位字节字符串。包含用户数据容器内容（参考 3GPP TS 24.301 [83]子条款 上海移远通信技术股份有限公司 147 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 9.9.4.24）。当没有数据要传输时， 应为空字符串（''）。此 参数不应按照 AT+CSCS 进行常规字符转换。用户数据容器的编码格式和 的最大长度是特定实现的。 整型。错误码。详情参见第 6 章。 备注 1. 使用 Non-IP 时，最大数据长度为 1358 字节，否则为 0。 2. 任何时候只能缓冲一条消息。 3. 在启用上报之前下行数据将被丢弃。 举例 AT+NRNPDM=1 OK AT+NRNPDM? +NRNPDM:1 OK AT+NRNPDM=? +NRNPDM:(0-1),(0-10),(0) OK 4.36. AT+NQPNPD 查询待处理的 Non-IP 数据列表 该命令用于由 MT 通过控制面或用户面查询待处理的 Non-IP 数据列表。 AT+NRNPDM 查询待处理的 Non-IP 数据列表 设置命令 响应 AT+NQPNPD= [+NQPNPD:[[…]]] OK 测试命令 AT+NQPNPD=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NQPNDP:(支持的范围) OK 上海移远通信技术股份有限公司 148 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT 命）。范围：0~10。 整型。待发送 Non-IP 数据消息的序列。范围：1~255。 整型。错误码。详情参见第 6 章。 举例 AT+NQPNPD=? +NQPNPD:(0-10) OK 4.37. AT+NSOSTATUS 获取 Socket 状态 设置命令返回指定 对应的 Socket 状态信息，执行命令返回所有的 Socket 状态的清单。 AT+NSOSTATUS 获取 Socket 状态 设置命令 响应 AT+NSOSTATUS= +NSOSTATUS:[,[]] OK 执行命令 AT+NSOSTATUS 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+NSOSTATUS:[,[,]] [+NSOSTATUS:[,[,]] [...] 上海移远通信技术股份有限公司 149 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 测试命令 AT+NSOSTATUS=? 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSOSTATUS:(支持的范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。Socket 编号。范围：0~6。 整型。 0 可用的 1 不存在（如果 Socket 未绑定到分配的正确 IP 地址 NW，也会返回此状态） 2 流量控制 3 退避 整型。退避定时器/T3396 定时器剩余时间。仅在退避状态时显示。单位：秒。 整型。错误码。详情参见第 6 章。 备注 Socket 0 用于 CoAP，如果支持 CoAP，启动时将自动创建 Socket 0。 举例 AT+NSOSTATUS=1 +NSOSTATUS:1,0 OK AT+NSOSTATUS +NSOSTATUS:0,0 上海移远通信技术股份有限公司 150 / 210 +NSOSTATUS:1,0 +NSOSTATUS:2,1 +NSOSTATUS:3,1 +NSOSTATUS:4,1 +NSOSTATUS:5,1 +NSOSTATUS:6,1 OK AT+NSOSTATUS=? +NSOSTATUS:(0-6) OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.38. AT+NCIDSTATUS 获取状态 设置命令返回指定 的 PDP 上下文状态，执行命令返回所有已定义 PDP 上下文的状态。 AT+NCIDSTATUS 获取状态 设置命令 响应 AT+NCIDSTATUS= +NCIDSTATUS:[,[]] OK 执行命令 AT+NCIDSTATUS 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+NCIDSTATUS:[,[]] [...] OK 测试命令 AT+NCIDSTATUS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCIDSTATUS:(支持的范围) OK 上海移远通信技术股份有限公司 151 / 210 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT）。范围：0~10。 整型。 0 可用的 1 不存在（如果 PDP 上下文处于非活动状态，也会返回此状态）。 2 流量控制 3 退避 整型。退避定时器/ T3396 定时器剩余时间，仅在退避状态时显示。单位：秒。 整型。错误码。详情参见第 6 章。 举例 AT+NCIDSTATUS=0 +NCIDSTATUS:0,0 OK AT+NCIDSTATUS +NCIDSTATUS:0,0 OK 4.39. AT+NGACTR 上报 PDP 上下文激活或去激活结果 设置命令控制 URC +NGACTR 的显示。如果 =1，则在 PDP 上下文激活或去激活完成时从 MT 发送 +NGACTR:。 AT+NGACTR 上报 PDP 上下文激活或去激活结果 设置命令 响应 AT+NGACTR= OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 152 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 查询命令 AT+NGACTR? 测试命令 AT+NGACTR=? 最大响应时间 特性说明 或者 +CME ERROR: 响应 +NGACTR: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NGACTR:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。 0 禁用 URC 1 启用 URC +NGACTR:,, 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT）。范围：0~10。 整型。表示 PDP 上下文激活的状态。默认值是制造商特定的。 0 去激活 1 激活 整型。表示 PDP 上下文激活或去激活的结果。 0 成功 1 失败原因：未定义上下文 2 失败原因：上下文已激活 3 失败原因：上下文未激活 4 失败原因：资源错误 5 失败原因：本地拒绝 6 失败原因：APN 错误 7 失败原因：APN 退避运行 8 失败原因：仅 IPv4 上海移远通信技术股份有限公司 153 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 9 失败原因：仅 IPv6 10 失败原因：仅 IP 11 失败原因：仅 Non-IP 12 失败原因：仅单 IP 13 失败原因：服务错误 14 失败原因：达到最大连接数 15 失败原因：请求重新激活 16 失败原因：不允许最后一个 PDN 断开连接 17 失败原因：未知 18 失败原因：不允许 NSLPI 重写 19 失败原因：正在附着 整型。错误码。详情参见第 6 章。 举例 AT+NGACTR=0 OK AT+NGACTR? +NGACTR:0 OK AT+NGACTR=? +NGACTR:(0,1) OK 4.40. AT+NUICC 设置 UICC 功耗模式 该命令用于打开或关闭 UICC。仅当 AT+NCONFIG 的配置项 NAS_SIM_POWER_SAVING_ENABLE 为真时才可使用，使用 AT+CSIM 和 AT+CRSM 时会用到该功能。使用该命令可能会影响开机时的功耗。 如果设置失败，则返回 +CME ERROR: 。 AT+NUICC 设置 UICC 功耗模式 设置命令 响应 AT+NUICC= OK 测试命令 AT+NUICC=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 154 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。UICC 功耗模式。 0 下电 1 上电 整型。错误码。详情参见第 6 章。 举例 AT+NUICC=1 OK AT+NUICC=? OK 4.41. AT+QSREGENABLE 配置电信/联通自注册 该命令用于配置运营商自注册功能，适用于中国电信和中国联通。 备注 1. 模块支持关闭中国电信和中国联通运营商自注册功能，运营商自注册功能是否需要关闭，请与对应的 运营商确认。 2. 中国联通运营商物联网模块的自注册功能仅支持调试，不支持商用，具体情况请参考对应的固件版本 变更说明文档。 3. 中国电信运营商物联网模块数据域自注册功能默认通过域名方式进行自注册，如果需要开启该功能， 请确认网络能够正确解析域名'zzhc.vnet.cn'，否则开启后会造成自注册失败而引发功耗增加。 4. 由于运营商自注册功能不断优化，各个版本的实现可能会不一致，具体修改信息请参考对应的固件版 本变更说明文档。 上海移远通信技术股份有限公司 155 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+QSREGENABLE 配置电信/联通自注册 设置命令 响应 AT+QSREGENABLE= OK 查询命令 AT+QSREGENABLE? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QSREGENABLE: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。启用或禁用运营商自注册功能。 0 禁用中国电信或中国联通自注册功能 1 启用中国电信自注册功能，在不支持=2 的固件版本中会开启联通自注册。 2 启用中国联通自注册功能 整型。错误码。详情参见第 6 章。 举例 AT+QSREGENABLE? +QSREGENABLE: 0 OK AT+QSREGENABLE=1 OK //查询自注册状态 //自注册已禁用 //启用中国电信自注册 上海移远通信技术股份有限公司 156 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 4.42. AT+NSOSTEX 发送消息（仅限 UDP） 该命令将包含数据长度字节的 UDP 数据报发送到指定的 host:port。它将与发送时所在的 socket 以及 发送的数据字节数一起返回。 如果数据量大于可以发送的最大数据报，则 AT+NSOSTEX 的返回值将指示 成功发送了多少数据。 AT+NSOSTEX 发送消息（仅限 UDP） 设置命令 响应 AT+NSOSTEX=,<remote_ad , dr>,,,, OK 设置命令 AT+NSOSTEX=,,, 响应 > 之后，输入需要发送的数据 ，按 'Ctrl'+'Z'发送数据； 按'Esc'取消发送操作。 设置命令 AT+NSOSTEX=,,,, 响应 > 之后，输入需要发送的数据 ，当长度达到 自动发 送。 若出现任何错误： ERROR 或者 +CME ERROR: 响应 , OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 , OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 ms 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 字符串型。IP 地址。支持十进制、八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：0~65535。 整型。要发送数据的十进制长度。默认最大长度为 1358 字节，实际取决于网络下 发的 MTU 值。 上海移远通信技术股份有限公司 157 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 要传输的数据。十六进制字符串格式。 整型。数据的序列。范围：0~255。如果为 0，则不会上报数据发送状态。如果为 非 0 值，当数据通过 RF 发送或丢弃时，将上报以下结果： +NSOSTR:,, 整型。数据报状态。 0 错误 1 已发送 整型。错误码。详情参见第 6 章。 备注 在通过 RF 发送数据或丢弃数据之前，不能使用相同的 ，否则命令将返回 ERROR。 举例 AT+NSOSTEX=1,192.158.5.1,1024,1,2,AB30 1,2 OK AT+NSOSTEX=1,192.158.5.1,1024,1,4 >AB30 1,4 OK AT+NSOSTEX=1,192.158.5.1,1024,1 >AB30 1,4 OK 4.43. AT+NSOSTFEX 发送带标志位的消息（仅限 UDP） 该命令将 UDP 数据报发送到指定的 host:port 并允许设置标志位。它将与发送时所在的 socket 以及发送的 数据字节数一起返回。 如果数据量大于可以发送的最大数据包，则 AT+NSOSTFEX 返回值将指示成功发 送了多少数据。 AT+NSOSTFEX 发送带标志位的消息（仅限 UDP) 设置命令 AT+NSOSTEX=,,,,<sequence 响应 , 上海移远通信技术股份有限公司 158 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 >,, OK 设置命令 AT+NSOSTFEX=,,,, 响应 > 之后，输入需要发送的数据 ，按 'Ctrl'+'Z'发送数据； 按'Esc'取消发送操作。 设置命令 AT+NSOSTFEX=,,,,, 响应 > 之后，输入需要发送的数据 ，当长度达到 自动发 送。 若出现任何错误： ERROR 或者 +CME ERROR: 响应 , OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 , OK 若出现任何错误： ERROR Or +CME ERROR: 最大响应时间 300 ms 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 字符串型。IP 地址。支持十进制、八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：0~65535。 整型。指定消息传输类型。此参数的值为十六进制格式，并通过对以下标志中的零 个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：表示收到该消息的回复后释放 若未设置 ，应将值设置为 0。 整型。数据的序列。范围：0~255。如果为 0，则不会上报数据发送状态。如果为 非 0 值，当数据通过 RF 发送或丢弃时，将上报以下结果： +NSOSTR:,, 整型。要发送数据的十进制长度。默认最大长度为 1358 字节，实际取决于网络下 发的 MTU 值。 上海移远通信技术股份有限公司 159 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 要传输的数据。十六进制字符串格式。 整型。数据报状态。 0 错误 1 已发送 整型。错误码。详情参见第 6 章。 备注 在通过 RF 发送数据或丢弃数据之前，不能使用相同的 ，否则命令将返回 ERROR。 举例 AT+NSOSTFEX=1,192.158.5.1,1024,0x100,1,2,AB30 1,2 OK AT+NSOSTFEX=1,192.158.5.1,1024,0x100,1,4 >AB30 1,4 OK AT+NSOSTFEX=1,192.158.5.1,1024,0x100,1 >AB30 1,4 OK 4.44. AT+NSOSDEX 发送消息（仅限 TCP） 该命令将 TCP 数据报发送到 TCP 服务器。 它将返回发送时所用的 socket 以及发送的数据字节数。 如果 数据量大于可以发送的最大数据报，则 AT+ NSOSDEX 返回值将指示成功发送了多少数据。 如果指定 ，则当服务器请求数据报或 UE 丢弃数据报时，将报告结果。 AT+NSOSDEX 发送消息（仅限 TCP） 设置命令 响应 AT+NSOSDEX=,,,, , OK 上海移远通信技术股份有限公司 160 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 若出现任何错误： ERROR 或者 设置命令 +CME ERROR: 响应 AT+NSOSDEX=,, 响应 > 之后，输入需要发送的数据 ，按 'Ctrl'+'Z'发送数据； 按'Esc'取消发送操作。 , OK 若出现任何错误 ERROR 或者 设置命令 AT+NSOSDEX=,,, 响应 > 之后，输入需要发送的数据 ，当长度达到 自动发 送。 +CME ERROR: 响应 , OK 若出现任何错误 ERROR 或者 +CME ERROR: 最大响应时间 300 ms 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 整型。指定消息传输的类型。此参数的值为十六进制格式，并通过对以下标志中的 零个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：指示收到该条消息的回复后释放 如果未设置 ，则应将值设置为 0。 整型。数据的序列。范围：0~255。如果为 0，则不会上报数据发送状态。如果为 非 0 值，当数据通过 RF 发送或丢弃时，将上报以下结果： +NSOSTR:,, 整型。表示发送的数据长度。十进制格式。默认最大长度为 1358 字节，实际取决 于网络下发的 MTU 值。 要传输的数据。十六进制字符串格式。 数据报状态。 0 错误 1 已发送 上海移远通信技术股份有限公司 161 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 整型。错误码。详情参见第 6 章。 备注 参数 目前不生效。 举例 AT+NSOSDEX=1,0x100,1,2,AB30 1,2 OK AT+NSOSDEX=1,0x100,1 >AB30 1,4 OK AT+NSOSDEX=1,0x100,1,4 >AB30 1,4 OK 上海移远通信技术股份有限公司 162 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 5 LwM2M 物联网平台命令 本章节描述了模块针对 LwM2M 物联网平台的 AT 命令。使用本章 AT 命令可用于对接中国电信物联网 平台和华为 OceanConnect 平台等物联网平台。 5.1. AT+NCDP 配置和查询 CDP 服务器设置 该命令用于配置 LwM2M NB-IoT 平台的 IP 地址/域名和端口。 AT+NCDP 配置和查询 CDP 服务器设置 设置命令 AT+NCDP=[,] 响应 从提供的参数中更新 CDP 服务器配置： OK 查询命令 AT+NCDP? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 返回当前 CDP 服务器 IP 地址和端口号： +NCDP:, OK 最大响应时间 特性说明 若未设置 CDP 服务器： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 字符串类型。IoT 平台 IP 地址。支持 IPv4、IPv6 类型的 IP 地址或域名。最大长度：256 上海移远通信技术股份有限公司 163 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 字节。 整型。无符号整型。范围：0~65535；默认值：5683。若配置端口为 0，则使用默认端 口；若没有指定端口，则使用之前设置的端口；若没有指定端口且之前未设置，则使用 默认端口。 整型。错误码。详情参见第 6 章。 备注 1. 设置 IMEI 号后，此设置命令才可用。 2. 配置 和 之后，需要执行 AT+NRB 重启模块后生效。 举例 AT+NCDP=192.168.5.1,5683 OK AT+NCDP? +NCDP:192.168.5.1,5683 OK 5.2. AT+QSECSWT 设置数据加密模式 该命令用于设置数据加密模式以及标准 DTLS 会话超时重新协商间隔。 AT+QSECSWT 设置数据加密模式 设置命令 响应 AT+QSECSWT=[,] 若出现任何错误： ERROR 或者 +CME ERROR: 查询命令 响应 AT+QSECSWT? +QSECSWT:[,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 164 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。加密模式类型。 0 不加密 1 标准 DTLS 加密模式 2 DTLS+加密模式 整型。NAT 类型，仅在标准 DTLS 加密模式下有效。 0 使能 NAT，重新协商间隔时间为 30 秒 1 禁用 NAT 和重新协商 整型。错误码。详情参见第 6 章。 举例 AT+QSECSWT=0 OK AT+QSECSWT=1,1 OK AT+QSECSWT? +QSECSWT:1,1 OK 5.3. AT+QSETPSK 设置 PSK ID 和 PSK 该命令用于配置 PSK ID 和 PSK。 AT+QSETPSK 设置 PSK ID 和 PSK 设置命令 AT+QSETPSK=, 响应 OK 查询命令 AT+QSETPSK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QSETPSK:, 上海移远通信技术股份有限公司 165 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 2秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 PSK 索引。十进制数字。固定长度为 15 位数。该值必须和设备 IMEI 值相同。另外，该值 也必须和 IoT 平台设置的值保持一致。当 被设置为 0，则 IMEI 被用作 PSKID。 表示 PSK。十六进制数字。固定长度 16 位数。另外，该值必须和 OceanConnect IoT 平 台设置为同样的值。 整型。错误码。详情参见第 6 章。 举例 AT+QSETPSK=867724030000225,E8E19CC16CE1F388E8E19CC16CE1F388 OK AT+QSETPSK? +QSETPSK:867724030000225,*** OK 5.4. AT+QLWSREGIND 注册控制 该命令用于控制模块向 IoT 平台发起注册和注销。若消息未能发送，则返回 错误码和描述作为 中间消息。 AT+QLWSREGIND 注册控制 设置命令 响应 AT+QLWSREGIND= OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 166 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 +CME ERROR: 300 毫秒 / 参数 整型。动作类型。 0 触发注册操作 1 触发注销操作 整型。错误码。详情参见第 6 章。 举例 AT+QLWSREGIND=0 OK 5.5. AT+QLWULDATA 发送数据 该命令用于使用 LwM2M 协议向 IoT 平台发送数据。若消息未能发送，则返回 错误码及描述作 为中间消息。在模块注册到 IoT 平台之前，执行该命令则会触发注册操作并丢弃数据。 AT+QLWULDATA 发送数据 设置命令 响应 AT+QLWULDATA=,[, OK ] 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 / 参数 整型。表示发送数据的长度。最大值：1024。 字符串类型。十六进制格式。单位：字节。 数据序列号。范围：0~255。如果使用非 0 的 来发送 CoAP 数据， 且当前有携带相同 的 NON 或者 CON 类型 CoAP 数据未发送完成， 上海移远通信技术股份有限公司 167 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 那么会将数据丢弃并返回错误。如果参数值为 0，则它被忽略。 整型。错误码。详情参见第 6 章。 举例 AT+QLWULDATA=3,AA34BB OK 5.6. AT+QLWULDATAEX 发送 CON/NON 消息 该命令用于根据 LwM2M 协议使用 RAI 标识符向物联网平台发送需要确认的消息（CON）或者不需要 确认的消息（NON）。发送 CON 数据后，发送结果会自动反馈给 TE，TE 也可以使用 AT+QLWULDATA STATUS? 来查询已发送 CON 数据的状态。如果发送 CON 数据，它必须在发送下一个 CON 或者 NON 数据之前获取发送 CON 数据的状态（失败/超时/成功/获得重置消息）。如果模块尚未注册到 NB-IoT 平台， 则该命令将使模块仅启动注册，模块将丢弃发送的数据。 AT+QLWULDATAEX 发送 CON/NON 消息 设置命令 AT+QLWULDATAEX=,,[,] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 / 参数 整型。表示发送数据的长度。最大值：1024。 十六进制格式字符串类型。单位：字节。 消息发送模式。 0x0000 表示发送 NON 消息。 0x0001 表示发送带有 RELEASE 释放辅助提示的 NON 消息。 0x0010 表示发送带有 RELEASE_AFTER_REPLY 释放辅助提示的 NON 消息。 0x0100 表示发送 CON 消息。 0x0101 表示发送带有 RELEASE_AFTER_REPLY 释放辅助提示的 CON 消息。 数据序列号。范围：0~255。如果使用非 0 的 发送 CoAP 数据，且当前 有携带相同 的 NON 或者 CON 类型 CoAP 数据未发送完成，那么会将数 据丢弃并返回错误。如果参数值为 0，则它被忽略。 上海移远通信技术股份有限公司 168 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 整型。错误码。详情参见第 6 章。 举例 AT+QLWULDATAEX=3,AA34BB,0x0001 OK 5.7. AT+QLWULDATASTATUS 查询 CON 消息发送状态 该命令用于查询向 NB-IoT 平台发送 CON 数据的状态。此命令仅查询已发送的 CON 数据的状态。 当发送 CON 类型 CoAP 数据时携带了非 0 的 ，该命令的响应为：+QLWULDATASTATUS: ,；当发送 CON 类型 CoAP 数据时没有携带 或者携带的 为 0，该命令的响应为：+QLWULDATASTATUS:。 AT+QLWULDATASTATUS 查询 CON 消息发送状态 查询命令 响应 AT+QLWULDATASTATUS? +QLWULDATASTATUS:[,] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。表示 CON 数据发送状态。 0 未发送 1 已发送，等待 IoT 平台响应 2 发送失败 3 超时 4 成功 5 收到 RESET 消息 数据序列。范围：0~255。若 为 0 则被忽略。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 169 / 210 举例 AT+QLWULDATASTATUS? +QLWULDATASTATUS:4 OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 5.8. AT+QLWFOTAIND 设置 DFOTA 升级模式 该命令用于设置 DFOTA 升级模式，可以设置为下面任意一种模式： ⚫ 自动模式：MCU 无需执行命令，可自动完成基于 DFOTA 的下载和升级。 ⚫ 受控模式：MCU 执行该命令去控制是否下载或升级固件。 受 控 模 式 下 ， 收 到 URC +QLWEVTIND: 6 （ 即 收 到 了 ' put package URI' 消 息 ） 或 者 URC +QLWEVTIND: 7（即收到了'update'消息）后，MCU 使用该命令控制是否下载或者升级固件。 AT+QLWFOTAIND 设置 DFOTA 升级模式 设置命令 响应 AT+QLWFOTAIND= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 =0/1 时： 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 =2/3/4/5 时： 该命令立即生效。 不保存到 KV。 参数 整型。表示 DFOTA 升级模式。 0 使用自动 DFOTA 升级模式 1 使用受控 DFOTA 升级模式 2 MCU 通知模块开始下载版本文件 3 MCU 通知模块取消下载版本文件 4 MCU 通知模块开始升级 上海移远通信技术股份有限公司 170 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 5 MCU 通知模块取消升级 整型。错误码。详情参见第 6 章。 备注 1. 当设置为 0 或 1 时，需要重新启动才能生效，并将其保存在 Flash 中。 2. 当设置为 2、3、4 或 5 时，将立即生效并且不会被保存。 举例 AT+QLWFOTAIND=1 OK 5.9. AT+QREGSWT 设置注册模式 该命令用于在重启模块后设置注册模式： ⚫ 若 设置为 0，模块在重启并连接到网络后会发送 REGISTERNOTIFY 消息到设备，然后 通过执行命令 AT+QLWSREGIND 触发注册。 ⚫ 若 设置为 1，模块在重启并连接到网络后会触发自动注册。 ⚫ 若 设置为 2，模块在重启并连接到网络后不会触发注册。 AT+QREGSWT 设置注册模式 设置命令 响应 AT+QREGSWT= OK 查询命令 AT+QREGSWT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QREGSWT: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 171 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 特性说明 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。表示注册模式。 0 手动注册模式 1 自动注册模式 2 禁用注册 整型。错误码。详情参见第 6 章。 备注 1. 如果不需要使用物联网平台，必须使用命令 AT+QREGSWT=2 禁用注册功能。该命令只有在使用 AT+NRB 重启 UE 后才生效，若不禁用注册功能会使 UE 从网络中分离，造成相关服务（例如 TCP/UDP） 失败。 2. 对于 Band 8 单频段的软件 ONT 版本，从 B300SP7 版本开始，默认关闭连接 IoT 平台功能，即 AT+QREGSWT=2，具体请参照对应版本的 RN。 举例 AT+QREGSWT=1 OK AT+QREGSWT? +QREGSWT:1 OK 5.10. AT+NMGS 发送消息 该命令用于发送数据到 IoT 平台。若消息未能发送会返回 错误码及描述作为中间消息。如果模 块尚未注册到物联网平台，执行该命令将会促使模块发起注册，并丢弃数据。 AT+NMGS 发送消息 设置命令 响应 AT+NMGS=,[,] 如出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 172 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 +CME ERROR: 300 毫秒 / 参数 消息的长度。十进制。最大值：1024。单位：字节。 待传输的数据。十六进制字符串格式。 数据序列号。范围：0~255。如果使用非 0 的 发送 CoAP 数据，且当前 有携带相同 的 NON 类型 CoAP 数据未发送完成，那么会将数据丢弃并 返回错误。若 为 0 则被忽略。 整型。错误码。详情参见第 6 章。 举例 AT+NMGS=3,AA11BB OK 5.11. AT+NMGR 接收消息 该命令用于通过 LwM2M 协议从 IoT 平台接收消息。 该命令返回最先缓存的消息并将消息从缓存中删除，如果没有缓存的消息，则该命令无响应；如果使 能新消息指示（AT+NNMI），执行该命令将无法获取收到的消息。 AT+NMGR 执行命令 AT+NMGR 接收消息 响应 , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 173 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 参数 消息长度。十进制。最大为 1024。 十六进制字符串格式。接收的数据。最大长度为 1024 字节。 整型。错误码。详情参见第 6 章。 举例 AT+NMGR 5,48656C6C6F OK 5.12. AT+NNMI 设置新消息指示 该命令用来设置或者获取已发送的新消息指示。UE 从 IoT 平台接收到一个下行消息后会发送新消息指 示。 AT+NNMI=1 使能新消息指示和数据，会返回当前所有缓存的消息，格式为 +NNMI: ,。 例如，+NNMI: 5,48656C6C6F。 AT+NNMI=2 仅使能新消息指示，每次收到新的消息都会触发指示 URC，响应结果格式为：+NNMI。 可以通过命令 AT+NMGR 接收缓存消息。 默认值为 1，模块重启后 会还原到默认值。 AT+NNMI 设置新消息指示 查询命令 AT+NNMI? 响应 +NNMI: OK 设置命令 AT+NNMI= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 174 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。新消息指示状态。 0 无指示 1 指示和消息 2 仅指示 整型。消息长度。 十六进制字符串格式。待接收的数据。 整型。错误码。详情参见第 6 章。 举例 AT+NNMI=1 OK AT+NNMI? +NNMI:1 OK 5.13. AT+NSMI 发送消息指示 当发送一条上行消息至 IoT 平台时，使用该命令设置或者获取已发送消息的指示。 如果开启了发送消息指示，当有新消息发送到 NB-IoT 栈时，会返回 URC +NSMI: [,]（例如：+NSMI: SENT）。 只有当发送数据的 AT 命令中包含非 0 参数 ，模块发送到 MCU 的通知消息中才会包含参 数 ，且该参数值与发送数据的 AT 命令中的 一致。 当发送 CoAP 数据的 AT 命令中包含非 0 参数 ，且 CoAP 数据成功发送到 NB-IoT 平台， 模块发送到 MCU 的通知消息中参数 值为 SENT_TO_AIR_INTERFACE；如果上述的命令中没 有参数 或者参数 值为 0 且 CoAP 数据成功发送到 NB-IoT 平台，模块发送到 MCU 的通知消息中参数 值为 SENT。 对于 CON 数据来说，SENT 和 SENT_TO_AIR_INTERFACE 说明发送数据到 NB-IoT 平台的结果；对 上海移远通信技术股份有限公司 175 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 于 NON 数据来说，SENT 说明数据发送到 C 核；SENT_TO_AIR_INTERFACE 说明数据发送到基站的空 口。 AT+NSMI 发送消息指示 设置命令 响应 AT+NSMI= OK 查询命令 AT+NSMI? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSMI: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 举例 AT+NSMI=1 OK AT+NSMI? +NSMI:1 整型。是否发送消息指示。 0 不发送指示 1 发送指示 字符串类型。数据发送的状态。 SENT 数据发送到 C 核 SENT_TO_AIR_INTERFACE 数据发送到空口 DISCARDED 数据丢弃 整型。数据序列。范围：1~255。表示 AT 命令中携带的非 0 的 向 loT 平台发送数据。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 176 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 OK 5.14. AT+NQMGR 查询已接收消息状态 该命令用来查询从 IoT 平台已接收下行消息的状态。 AT+NQMGR 查询已接收消息状态 执行命令 响应 AT+NQMGR BUFFERED=,RECEIVED=,DROPPE D= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。下行缓存中等待读取的消息条数。 整型。UE 启动后收到的消息总数。 整型。UE 启动后丢弃的消息条数。 整型。错误码。详情参见第 6 章。 举例 AT+NQMGR BUFFERED=0,RECEIVED=34,DROPPED=2 OK 上海移远通信技术股份有限公司 177 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 5.15. AT+NQMGS 查询发送的消息状态 该命令用于查询已发送到 IoT 平台上行消息的状态。 AT+NQMGS 查询发送的消息状态 执行命令 响应 AT+NQMGS PENDING=,SENT=,ERROR= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。上行缓存中等待发送的消息条数。 整型。UE 启动后，发送到 NB-IoT 平台的上行消息总数。 整型。UE 启动后，因错误被丢弃的消息条数。 整型。错误码。详情参见第 6 章。 备注 1. 对于 CON 类型 CoAP 数据，只有当 timeout、RST、sent_fail 或者 sent_success 之后，相应统计值 才会改变； 2. 对于 NON 类型 CoAP 数据，如果发送数据时携带了非 0 的 ，在数据发送到空口时，才 会相应统计值才会改变；如果发送数据时没有携带 或者携带的 为 0，在 数据发送到 C 核时相应统计值就会改变。 举例 AT+NQMGS PENDING=1,SENT=34,ERROR=0 OK 上海移远通信技术股份有限公司 178 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 5.16. AT+NMSTATUS 消息注册状态 当模块连接到 CDP 服务器时，该命令用于上报当前注册状态。当 LwM2M 处于 MO_DATA_ENABLED 状态，则 UE 可以发送数据。 AT+NMSTATUS 消息注册状态 查询命令 AT+NMSTATUS? 响应 +NMSTATUS: OK 测试命令 AT+NMSTATUS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 (支持的列表) 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。当前注册状态 UNINITIALISED MISSING_CONFIG INIITIALISING INIITIALISED INIT_FAILED REGISTERING REGISTERED DEREGISTERED MO_DATA_ENABLED NO_UE_IP REJECTED_BY_SERVER TIMEOUT_AND_RETRYING 未初始化 配置丢失 初始化中 初始化完成 初始化失败 注册中 已注册 已注销 使能数据发送 无UE IP 服务器拒绝 超时并重试 上海移远通信技术股份有限公司 179 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 REG_FAILED 注册失败 DEREG_FAILED 注销失败 整型。错误码。详情参见第 6 章。 5.17. AT+QLWEVTIND LwM2M 事件上报 该命令用于模块向设备上报 LwM2M 事件。若打开 URC 指示开关，将上报 LwM2M 事件 URC： +QLWEVTIND: AT+QLWEVTIND LwM2M 事件上报 设置命令 AT+QLWEVTIND= 响应 OK 查询命令 AT+QLWEVTIND? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLWEVTIND:, OK 测试命令 AT+QLWEVTIND=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLWEVTIND:(支持的列表) OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 180 / 210 参数 整型。指示 URC 开关状态。 0 关闭 1 打开 整型。事件类型。 0 注册完成 1 注销完成 2 注册状态更新 3 订阅对象 19/0/0 完成 4 Bootstrap 完成 5 5/0/3 资源订阅完成 6 通知设备接收更新包 URL 7 通知设备下载完成 9 取消订阅对象 19/0/0 255 未初始化 整型。错误码。详情参见第 6 章。 举例 AT+QLWEVTIND=1 OK AT+QLWEVTIND? +QLWEVTIND:1,255 OK AT+QLWEVTIND=? +QLWEVTIND:(0,1) OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 5.18. AT+QRESETDTLS 重置 DTLS 模式 该命令用来重置 DTLS 模式： ⚫ 若 DTLS 完成握手或者重新协商，可用该命令设置 DTLS 状态为 INIT 状态，在下次发送数据时会 执行握手过程。 ⚫ 若当前 DTLS 的状态是正在握手或者正在进行重新协商，该命令会直接返回 OK，下次发送数据时 不会触发握手过程。 上海移远通信技术股份有限公司 181 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+QRESETDTLS 重置 DTLS 模式 执行命令 响应 AT+QRESETDTLS OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 不保存到 KV。 参数 整型。错误码。详情参见第 6 章。 举例 AT+QRESETDTLS OK 5.19. AT+QDTLSSTAT 查询 DTLS 状态 该命令用于查询 DTLS 当前链路状态。在每 8 秒发送一次上行数据的情况下，若 DTLS 未协商，则 DTLS 状态无法查询。 ⚫ 若 DTLS 协商可以在 8 秒内完成，那么可在协商完成后查询 DTLS 状态； ⚫ 无论是模块通电后自动注册还是通过 AT 命令手动注册，IoT 平台注册过程都由 LwM2M 触发，不 会阻止任何 AT 命令。 DTLS 协商或者握手完成后，模块主动发送消息 +QDTLSSTAT: 0/3 到终端。 AT+QDTLSSTAT 查询 DTLS 状态 查询命令 响应 AT+QDTLSSTAT? +QDTLSSTAT: OK 若出现任何错误： 上海移远通信技术股份有限公司 182 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。DTLS 状态。 0 表示 DTLS 协商或握手完成 1 表示协商或握手未开始 2 表示正在协商或者握手 3 表示协商或者握手失败 整型。错误码。详情参见第 6 章。 举例 AT+QDTLSSTAT? +QDTLSSTAT:0 OK 5.20. AT+QBOOTSTRAPHOLDOFF Bootstrap 延时时长 该命令用于设置和查询客户端延时时间（仅与 Bootstrap 服务器相关）。默认值是 600 秒，建议最长 时间不超过 3000 秒： ⚫ 如果时间设置过长（大于 3000 秒），会延迟终端 Bootstrap Sequence 尝试时间，进而影响终端 接入功耗； ⚫ 如果时间设置过短（小于 600 秒），会导致 Factory Bootstrap（厂家存储相应消息在设备中）和 Server Initiated Bootstrap（服务器发起引导程序）时间过短，进而影响 Factory Bootstrap 和 Server Initiated Bootstrap 的成功率。因此，如果模块入网后需要执行 Server Initiated Bootstrap 过程（未 配置 Bootstrap 服务器和 LwM2M 服务器地址），或已配置了 LwM2M 服务器地址，不建议 ClientHoldOffTimer 值小于 600 秒。 必须在配置了 Bootstrap 服务器地址的情况下，ClientHoldOffTimer 才可以为 0。模块会直接进入 Client Initiated Bootstrap，缩短 Client Initiated Bootstrap 时间： ⚫ 如果没有配置 Bootstrap 服务器地址，执行命令 AT+QBOOTSTRAPHOLDOFF=0 后会返回 ERROR； 上海移远通信技术股份有限公司 183 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 ⚫ 如 果 Bootstrap 服 务 器 不 存 在 ， ClientHoldOffTimer 定 时 器 时 间 不 能 设 置 为 0 ； 如 果 ClientHoldOffTimer 定时器时间为 0，则不能擦除 Bootstrap 服务器 IP。 AT+QBOOTSTRAPHOLDOFF Bootstrap 延时时长 设置命令 响应 AT+QBOOTSTRAPHOLDOFF= 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+QBOOTSTRAPHOLDOFF? +QBOOTSTRAPHOLDOFF: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。单位：秒。表示客户端延时时长。默认值为 600 秒。建议设置值不超过 3000 秒。 整型。错误码。详情参见第 6 章。 举例 AT+QBOOTSTRAPHOLDOFF=600 OK AT+QBOOTSTRAPHOLDOFF? +QBOOTSTRAPHOLDOFF:600 OK 上海移远通信技术股份有限公司 184 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 5.21. AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP 该命令用于设置和删除 Bootstrap 和 IoT 服务器 IP 地址。AT+QLWSERVERIP 和 AT+NCDP 两个命 令适用同一个 KV 项： ⚫ 当 IP 地址和端口与 KV 匹配时，执行 AT+QLWSERVERIP=DEL,, 将会删除 IP 信息； ⚫ 当 IP 地址与 KV 匹配时，执行 AT+QLWSERVERIP=DEL, 将会删除 IP 信息。 AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP 设置命令 响应 AT+QLWSERVERIP=,[,] 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+QLWSERVERIP? +QLWSERVERIP:,, [...] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 Bootstrap/LwM2M 服务器 IP 类型。 LWM2M IoT 服务器 IP BS Bootstrap 服务器 IP DEL 删除 IP 信息 字符串类型。域名或者 IP 地址。IP 地址格式为点分十进制格式的 IPv4 地址，如： 180.101.147.115。每个字节的范围均为 0~255。 整型。端口号。范围：0~65535。 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 185 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 举例 AT+QLWSERVERIP=BS,180.101.147.115,5683 OK AT+QLWSERVERIP=LWM2M,180.101.147.115,5683 OK AT+QLWSERVERIP? +QLWSERVERIP:BS,180.101.147.115,5683 +QLWSERVERIP:LWM2M,180.101.147.115,5683 OK AT+QLWSERVERIP=DEL,180.101.147.115,5683 OK 5.22. AT+QCRITICALDATA 查询是否可发送紧急数据 该命令用于查询是否可以在 DFOTA 升级过程中发送紧急数据，如果可以发送数据，当前 DFOTA 过程 会停止并优先传输数据。平台升级结果取决于超时处理。 在 DFOTA 升级过程中，如果有发送紧急数据请求，可先发送该命令：如果响应 OK，则可发送紧急数 据；如果响应 ERROR，则不能发送紧急数据。 AT+QCRITICALDATA 查询是否可发送紧急数据 设置命令 响应 AT+QCRITICALDATA= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。参数值只能设置为 1。表示查询是否可以发送紧急数据。 整型。错误码。详情参见第 6 章。 举例 AT+QCRITICALDATA=1 上海移远通信技术股份有限公司 186 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 OK 5.23. AT+QSETBSPSK 配置 PSK ID 和 PSK 到 Bootstrap 该命令用于配置 Bootstrap 服务器对接 DTLS 连接的 PSK ID 和 PSK。 AT+QSETBSPSK 配置 PSK ID 和 PSK 到 Bootstrap 设置命令 响应 AT+QSETBSPSK=, OK 查询命令 AT+QSETBSPSK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QSETBSPSK:, OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 2秒 该命令重启后生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 密钥索引。用于索引 PSK，固定长度为 15 位的十进制数字，取值需要和设备的 IMEI 号相同，需要和 IoT 平台保持一致。当该参数值设置为 0 时，IMEI 号被用作 。 预置密钥，固定长度为 16 字节的十六进制数字，需和 IoT 平台保持一致。 整型。错误码。详情参见第 6 章。 举例 AT+QSETBSPSK=201703230000024,0123456789ABCDEF0123456789ABCDEF OK AT+QSETBSPSK? +QSETBSPSK:201703230000024,*** 上海移远通信技术股份有限公司 187 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 OK 5.24. AT+QBSSECSWT 设置 Bootstrap 加密模式 该命令用于配置 Bootstrap 服务器对接的 DTLS 连接的开关，以及标准 DTLS 会话超时重协商时间。在 启动 DTLS 首次协商时启动计时器，每收到一次 Bootstrap 服务器的 DTLS 报文后重启定时器。发送上行报 文时，如果该定时器已经超时，需触发一个重新协商。 AT+QBSSECSWT 设置 Bootstrap 加密模式 设置命令 响应 AT+QBSSECSWT=[,] OK 若出现任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+QBSSECSWT? +QBSSECSWT:[,] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 进入深休眠或 AT+NRB 重启后保存到 KV。 参数 整型。加密模式类型 0 不加密 1 标准 DTLS 加密模式 整型。NAT 类型仅在标准 DTLS 加密模式下有效。 0 使能 NAT，且重新协商时间为 30 秒 1 禁用 NAT 和重新协商 整型。错误码。详情参见第 6 章。 上海移远通信技术股份有限公司 188 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 备注 仅在标准 DTLS 加密模式（=1）时有效。 举例 AT+QBSSECSWT=1,1 OK AT+QBSSECSWT? +QBSSECSWT:1,1 OK 上海移远通信技术股份有限公司 189 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 6 错误码 本章介绍与 BC35-G、BC28 和 BC95 R2.0 系列模块相关的错误码。 以下两个表中列出的错误代码符合 3GPP 规范。客户可以参考 3GPP TS 27.007 V13.5.0, sub-clause 9.2 了解所有可能的 错误码。 表 3：通用错误码（27.007） 错误码 3 4 5 23 30 50 51 52 100 159 181 描述 说明 Operation not allowed 操作不被允许 Operation not supported 不支持该操作 Need to enter PIN 需要输入 PIN Memory failure 内存故障 No network service 无网络服务 Incorrect parameters 参数不正确 Command implemented but currently disabled 命令被已执行但当前被禁用 Command aborted by user 命令被客户终止 Unknown 未知错误 Uplink busy/flow control 上行链路忙/流控 unsupported QCI value 不支持的 QCI 值 表 4：通用错误码（27.005） 错误码 300 301 302 描述 ME failure SMS service of ME reserved Operation not allowed 上海移远通信技术股份有限公司 说明 ME 故障 ME 保留的短信服务 操作不被允许 190 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 303 Operation not supported 不支持该操作 304 Invalid PDU mode parameter 无效的 PDU 模式参数 305 Invalid text mode parameter 无效的 text 模式参数 310 USIM not inserted 未插入 USIM 卡 311 USIM PIN required 需要输入 USIM PIN 312 PH-USIM PIN required 需要输入 PH-USIM PIN 313 USIM failure USIM 故障 314 USIM busy USIM 忙 315 USIM wrong USIM 错误 316 USIM PUK required 需要输入 USIM PUK 317 USIM PIN2 required 需要输入 USIM PIN2 318 USIM PUK2 required 需要输入 USIM PUK2 320 Memory failure 内存故障 321 Invalid memory index 无效的内存索引 322 Memory full 内存已满 330 SMSC address unknown 未知的 SMSC 地址 331 No network service 无网络服务 332 Network timeout 网络超时 340 No +CNMA acknowledgement expected 预计无+CNMA 确认 500 Unknown error 未知错误 以下错误码是 BC35-G 和 BC28 模块的特定错误码。错误码 512 是之前的错误码 256，错误码 513 是 之前的错误码 257。 表 5：特定错误码 错误码 512 513 描述 Required parameter not configured TUP not registered 说明 必要的参数未配置 TUP 未注册 上海移远通信技术股份有限公司 191 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 514 AT internal error AT 内部错误 515 CID is active CID 处于激活状态 516 Incorrect state for command 命令状态错误 517 CID is invalid CID 无效 518 CID is not active CID 处于未激活状态 520 Deactivate the last active CID 去激活上次激活的 CID 521 CID is not defined CID 未被定义 522 UART parity error UART 奇偶校验错误 523 UART frame error UART 帧错误 UE is in minimal function mode UE 处于最小功能模式 524 (AT+CFUN=0) (AT+CFUN=0) 525 AT command aborted: in processing AT 命令中止：处理中 526 AT command aborted: error AT 命令中止：错误 527 Command interrupted 命令被中断 528 Configuration conflicts 配置冲突 529 During FOTA updating FOTA 升级中 530 Not the AT allocated socket 不是 AT 分配的 Socket 531 USIM PIN is blocked USIM PIN 被锁定 532 USIM PUK is blocked USIM PUK 被锁定 533 Not mipi module 非 mipi 模块 534 File not found 未找到文件 535 conditions of use not satisfied 使用的条件不符 536 AT UART buffer error AT UART 口缓冲错误 537 Back off timer is running 退避定时器正在运行 备注 AT+CMEE=命令禁用（=0）或启用（=1）最终结果码 +CME ERROR:。当=1 时， 将返回一组有限的错误码。 上海移远通信技术股份有限公司 192 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 7 重启原因 除了重新上电或外部复位，如果模块因其他任何原因重新启动，将在字符串 NeulOK 前输出一条消息，以表明重新启动的原因。该打印的重启原因仅供参考，不能作为判断 模块重启的唯一原因。 表 6：重启原因显示 序号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 重启消息显示 REBOOT_CAUSE_SECURITY_RESET_UNKNOWN REBOOT_CAUSE_SECURITY_SYSRESETREQ REBOOT_CAUSE_SECURITY_WATCHDOG REBOOT_CAUSE_SECURITY_SELF REBOOT_CAUSE_SECURITY_ALTBOOT REBOOT_CAUSE_SECURITY_REG_0 REBOOT_CAUSE_SECURITY_REG_3 REBOOT_CAUSE_SECURITY_STANDARD_CHIP_WATCHDOG REBOOT_CAUSE_SECURITY_UPDATER_CHIP_WATCHDOG REBOOT_CAUSE_SEUCRITY_SCAN_ENTER_EXIT REBOOT_CAUSE_SECURITY_PMU_POWER_ON_RESET REBOOT_CAUSE_SECURITY_RESET_PIN REBOOT_CAUSE_SECURITY_REGIONS_UPDATED REBOOT_CAUSE_SECURITY_FOTA_UPGRADE REBOOT_CAUSE_PROTOCOL_SYSRESETREQ REBOOT_CAUSE_PROTOCOL_WATCHDOG 上海移远通信技术股份有限公司 193 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 17 REBOOT_CAUSE_PROTOCOL_MONITOR_REBOOT_REQ 18 REBOOT_CAUSE_PROTOCOL_RPC_TIMEOUT 19 REBOOT_CAUSE_APPLICATION_SYSRESETREQ 20 REBOOT_CAUSE_APPLICATION_WATCHDOG 21 REBOOT_CAUSE_APPLICATION_AT 22 REBOOT_CAUSE_APPLICATION_RPC_TIMEOUT 23 REBOOT_CAUSE_PROTOCOL_IMSI_UPDATE 24 REBOOT_CAUSE_UNKNOWN 上海移远通信技术股份有限公司 194 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 8 举例 8.1. 附着网络 执行命令 AT+NCONFIG=AUTOCONNECT,TRUE 模块自动附着网络。 如果需要手动注网，请通过执行命令 AT+NCONFIG=AUTOCONNECT,FALSE 禁用自动附着网络功 能。该设置将保存至 KV，并在执行命令 AT+NRB 重启模块后生效。 8.1.1. 自动附着网络 以下是附着网络的简单示例。客户可以通过以下命令查询模块是否已附着到网络： REBOOT_CAUSE_SECURITY_PMU_POWER_ON_RESET Neul OK //模块上电开机 AT+CFUN? +CFUN:1 OK AT+CIMI 460111174590523 //查询 IMSI 号 OK AT+CEREG? +CEREG:0,1 //查询网络注册状态 //=0 表示已禁用网络注册 URC，=1 表示已注册 OK AT+CGATT? +CGATT:1 //查询网络附着状态 //网络附着成功，通常需要等待 30 秒 OK AT+CGPADDR //查询模块的 IP 地址 +CGPADDR:0,10.169.241.248 OK 上海移远通信技术股份有限公司 195 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 8.1.2. 手动附着网络 全频段搜网可能会花费较长的时间，因此建议手动注网时，只搜索指定的频段。 AT+NCONFIG=AUTOCONNECT,FALSE OK AT+NRB REBOOTING //禁用自动连接网络 //重启模块 REBOOT_CAUSE_APPLICATION_AT Neul OK AT+NBAND=5 OK AT+CFUN=1 OK AT+CIMI 460111174590523 //重启原因 //指定要搜索的频段 B5 //将模块设置为全功能模式 //查询 IMSI 号 OK AT+CGATT=1 OK AT+NUESTATS Signal power:-827 Total power:-684 TX power:230 TX time:2272 RX time:9354 Cell ID:110258001 ECL:1 SNR:-30 EARFCN:2506 PCI:100 RSRQ:-157 OPERATOR MODE:4 //触发网络连接 //查询模块状态 OK AT+CEREG? +CEREG:0,1 //查询网络注册状态 //=0 表示已禁用网络注册 URC，=1 表示已注册 OK AT+CGATT? +CGATT:1 //查询网络附着状态 //网络附着成功，通常需要等待 30 秒 上海移远通信技术股份有限公司 196 / 210 OK AT+CGPADDR +CGPADDR:0,10.3.42.109 OK BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 //查询模块的 IP 地址 8.2. 发送/接收/读取 UDP 信息 以下是发送/接收/读取 UDP 信息的简单示例。Socket 关闭后，将不会收到任何响应。当不使用 IoT 平 台时，需要在模块连接到网络之前禁用 IoT 平台的注册功能。 AT+QREGSWT=2 OK … //禁用 IoT 平台的注册功能 //连接网络 AT+CGPADDR +CGPADDR:0,10.3.42.109 OK AT+NSOCR=DGRAM,17,0,1 1 //查询模块的 IP 地址 //创建一个 UDP 类型的 Socket，并接收传输消息 OK AT+NSOST=1,220.180.239.212,8012,5,1245783132,100 1,5 //发送信息 OK +NSOSTR:1,100,1 //RF 发送的数据报文 +NSONMI:1,5 AT+NSORF=1,5 1,220.180.239.212,8012,5,1245783132,0 //接收信息 //读取编号为 1 的 Socket 中 5 字节的信息 OK AT+NSOCL=1 OK //关闭 Socket 8.3. 发送/接收/读取 TCP 信息 以下是发送/接收/读取 TCP 信息的简单示例。关闭 Socket 后，将不会收到任何响应。当不适用 IoT 平 台时，需要在模块连接到网络之前禁用 IoT 平台的注册功能。 上海移远通信技术股份有限公司 197 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 AT+QREGSWT=2 OK … AT+CGPADDR +CGPADDR:0,10.3.42.79 OK AT+NSOCR=STREAM,6,0,1 1 OK AT+NSOCO=1,220.180.239.212,8009 OK AT+NSOSD=1,4,01020304,0x100,101 1,4 OK +NSOSTR:1,101,1 +NSONMI:1,4 AT+NSORF=1,4 1,220.180.239.212,8009,4,01020304,0 OK AT+NSOCL=1 OK //禁用 IoT 平台的注册功能 //连接网络 //查询模块的 IP 地址 //创建一个 TCP 类型的 Socket //连接服务器 //发送数据 //确认数据报文已由服务器接收 //接收信息 //读取编号为 1 的 Socket 中 4 字节的信息 //关闭 Socket 8.4. OceanConnect IoT 平台相关举例 8.4.1. 注册 OceanConnect IoT 平台 8.4.1.1. 自动注册模式 AT+QREGSWT? +QREGSWT:1 OK AT+NCDP=180.101.147.115,5683 OK AT+NRB REBOOTING //自动注册模式（默认模式） //设置 IoT 平台 IP 地址及端口 //重启模块 上海移远通信技术股份有限公司 198 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 REBOOT_CAUSE_APPLICATION_AT Neul OK AT+CGPADDR +CGPADDR:0,10.3.42.109 OK +QLWEVTIND:0 +QLWEVTIND:3 //重启原因 //查询模块的 IP 地址 //表明成功注册 //IoT 平台已订阅实例 19/0。当模块报告此消息时，MCU 可以发送数据到 IoT 平台。 8.4.1.2. 手动注册模式 AT+CGATT? +CGATT:1 OK AT+NCDP=180.101.147.115,5683 OK AT+QREGSWT? +QREGSWT:0 OK AT+QLWSREGIND=0 OK +QLWEVTIND:0 +QLWEVTIND:3 AT+QLWSREGIND=1 OK +QLWEVTIND:1 //查询 PS 服务连接状态 //已经连接了 PS 服务器 //设置 IoT 平台 IP 地址及端口 //查询注册模式 //手动注册模式 //开始注册 IoT 平台 //表明成功注册 //IoT 平台已订阅实例 19/0。当模块报告此消息时，MCU 可以发送数据到 IoT 平台。 //从 IoT 平台注销 //表明注销成功 8.4.2. 从 OceanConnect IoT 平台发送/接收数据 +QLWEVTIND:0 //表明成功注册 +QLWEVTIND:3 AT+QLWULDATA=3,313233 //IoT 平台已订阅实例 19/0。当模块报告此消息时，MCU 可以发送数据到 IoT 平台。 //发送 NON 数据，不需要 IoT 平台应答 ACK 消息。 上海移远通信技术股份有限公司 199 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 OK +NNMI:4,AAAA0000 AT+QLWULDATAEX=3,313233,0X0100 OK +QLWULDATASTATUS:4 +NNMI:4,AAAA0000 AT+QLWULDATASTATUS? +QLWULDATASTATUS:4 OK //模块已从物联网平台接收数据 //发送 CON 消息， IoT 平台需要应答 ACK 消息 //数据发送成功 //模块已从物联网平台接收数据 //查询数据发送状态 //数据发送成功 8.4.3. 在 OceanConnect IoT 平台上升级固件 8.4.3.1. 通过 DFOTA 自动升级固件 //在 IoT 平台上创建一个固件升级任务 +QLWEVTIND:0 +QLWEVTIND:3 AT+QLWULDATA=3,313233 OK +QLWEVTIND:5 //表明成功注册 //IoT 平台已订阅实例 19/0 //发送任意上行数据包并触发在线固件升级 //IoT 平台已观察到对象 5 FIRMWARE DOWNLOADING FIRMWARE DOWNLOADED FIRMWARE UPDATING //模块正在进行本地升级，这可能导致多次重新启动，因此需要一些时间。 REBOOT_CAUSE_SECURITY_FOTA_UPGRADE //重启模块 Neul OK 上海移远通信技术股份有限公司 200 / 210 FIRMWARE UPDATE SUCCESS +QLWEVTIND:0 +QLWEVTIND:3 FIRMWARE UPDATE OVER BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 //表明成功注册 //IoT 平台已订阅实例 19/0 8.4.3.2. 通过 DFOTA 手动升级固件 //在 IoT 平台上创建一个固件升级任务 AT+QLWFOTAIND? +QLWFOTAIND:1 //查询固件的升级模式 //手动模式 OK AT+QLWSREGIND=0 OK +QLWEVTIND:0 +QLWEVTIND:3 AT+QLWULDATA=3,313233 OK +QLWEVTIND:5 //开始注册 IoT 平台 //表明成功注册 // IoT 平台已订阅实例 19/0 //发送任意上行数据包并触发在线固件升级 //IoT 平台已观察到对象 5 FIRMWARE DOWNLOADING +QLWEVTIND:6 AT+QLWFOTAIND=2 OK //通知设备接收更新包的 URL //设备通知模块开始下载 FIRMWARE DOWNLOADED +QLWEVTIND:7 AT+QLWFOTAIND=4 OK //通知设备下载已经完成 //设备通知模块开始升级 FIRMWARE UPDATING REBOOT_CAUSE_SECURITY_FOTA_UPGRADE //模块重启 Neul 上海移远通信技术股份有限公司 201 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 OK FIRMWARE UPDATE SUCCESS +QLWEVTIND:0 +QLWEVTIND:3 FIRMWARE UPDATE OVER //表明成功注册 //IoT 平台已订阅实例 19/0 8.4.4. 使用 DTLS 注册 OceanConnect IoT 平台 AT+CGATT? +CGATT:1 //查询 PS 服务连接状态 //已经连接了 PS 服务器 OK AT+NCDP= 180.101.147.115,5684 //设置 IoT 平台 IP 地址及端，端口 5684. OK AT+QSECSWT=1 //使用标准 DTLS 加密 OK AT+QSETPSK=201703230000024,0123456789ABCDEF0123456789ABCDEF OK //设置 PSK ID 和 PSK AT+QREGSWT? //查询注册模式 +QREGSWT:0 //手动注册模式 OK +QDTLSSTAT:0 AT+QLWSREGIND=0 OK //DTLS 握手成功 //开始注册 IoT 平台 +QLWEVTIND:0 //表明成功注册 +QLWEVTIND:3 //IoT 平台已订阅实例 19/0 8.5. 释放辅助指示 (RAI) 当 UE 没有更多数据要发送时，它将等待网络释放连接以进入空闲模式。为了使网络快速将 UE 释放到 空闲模式以节省功耗，释放辅助指示（RAI）在 R13 中引入，用于控制面 CIoT EPS 优化，其中 UE 可以 在非接入层（NAS）信令中包含 RAI，以指示在上行数据之后没有进一步的上行或下行数据传输，从而帮 助网络确定是否可以释放连接。 上海移远通信技术股份有限公司 202 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 R14 引入了用于控制面和用户面 CIoT EPS 优化的接入层（AS）的 RAI。 当配置 AS RAI 时，UE 可以触发具有零字节大小的缓冲区状态报告（BSR），向 eNB 指示预计不会 再有 UL 或 DL 数据，可以释放连接。 8.5.1. RAI 功能操作举例-R13 8.5.1.1. 使用 Flag 发送 UDP 数据 执行 AT+CSCON 命令使能 URC 上报功能，通过 URC 的上报状态，可判断标志位是否生效。 [13:38:08:105]AT+CSCON=1 [13:38:08:121]OK [13:38:08:344] [13:38:08:344]+CSCON:0 [13:38:24:470]AT+NSOCR=DGRAM,17,1234,1 [13:38:24:502]0 //使能 URC 上报功能 //创建 UDP socket [13:38:24:518]OK [13:38:28:717]AT+NSOSTF=0,220.180.239.212,8052,0x400,2,AB30 [13:38:28:765]0,2 //使用 0x400 标志位发送数据 [13:38:28:765]OK [13:38:29:340] [13:38:29:340]+CSCON:1 [13:38:29:611] [13:38:29:611]+NSONMI:0,2 [13:38:29:931] [13:38:29:931]+CSCON:0 [13:38:37:244]AT+NSORF=0,512 [13:38:37:276]0,220.180.239.212,8052,2,AB30,0 //收到下行数据 //立即释放 RRC 连接 //读取下行数据 [13:38:37:307]OK [13:38:56:275]AT+NSOSTF=0,220.180.239.212,8052,0x200,2,AB30 [13:38:56:323]0,2 //使用 0x200 标志位发送数据 [13:38:56:339]OK [13:38:58:782] [13:38:58:782]+CSCON:1 [13:38:59:086] [13:38:59:086]+CSCON:0 //建立 RRC 连接，并开始发送数 据 //数据发送完毕后，立即释放 RRC 连接 上海移远通信技术股份有限公司 203 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 8.5.1.2. 发送 LwM2M CON/NON 数据 执行 AT+CSCON 命令使能 URC 上报功能，通过 URC 的上报状态，可判断 RAI 功能是否生效。 [14:17:35:307]AT+CSCON=1 [14:17:35:322]OK [14:17:45:876] [14:17:45:876]+CSCON:0 [14:17:53:301]AT+NCDP? [14:17:53:301]+NCDP:180.101.147.115,5683 //使能 URC 上报功能 //IoT 平台服务器地址 [14:17:53:333]OK [14:18:03:920]AT+QLWULDATAEX=3,AA34BB,0x0001 //使用 0x0001 标志位发送 NON 数据 [14:18:05:404]OK [14:18:05:532] [14:18:05:532]+CSCON:1 //建立 RRC 连接，并开始发送数据 [14:18:05:947] [14:18:05:947]+CSCON:0 //数据发送完毕后，立即释放 RRC 连接 [14:21:06:880]AT+QLWULDATAEX=3,AA34BB,0x0101 //使用 0x0101 标志位发送 CON 数据 [14:21:06:911]OK [14:21:07:933] [14:21:07:933]+CSCON:1 //建立 RRC 连接，并开始发送数据 [14:21:08:221] [14:21:08:221]+QLWULDATASTATUS:4 //CON 数据被平台确认收到 [14:21:09:179] [14:21:09:179]+CSCON:0 //数据发送完毕后，立即释放 RRC 连接 8.5.2. RAI 功能操作举例-R14 以下示例中，R14 版本 RAI 功能均已经开启并生效。 //查询 R14 版本 RAI 功能是否开启 AT+NCONFIG? …… +NCONFIG:RAI,TRUE …… OK //R14 版本 RAI 功能已开启 上海移远通信技术股份有限公司 204 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 8.5.2.1. 发送 UDP 数据 执行 AT+CSCON 命令使能 URC 上报功能，通过 URC 的上报状态，可判断标志位是否生效。 [13:56:40:879]AT+CSCON=1 [13:56:40:893]OK [13:56:49:346]AT+NSOCR=DGRAM,17,5690,1 [13:56:49:359]0 //使能 URC 上报功能 //创建 UDP socket [13:56:49:359]OK [13:56:56:079] [13:56:56:079]+CSCON:0 [13:56:59:217]AT+NSOST=0,220.180.239.212,8426,2,1122 [13:56:59:259]0,2 //RRC 连接释放 //发送数据 [13:56:59:259]OK [13:56:59:644] [13:56:59:644]+CSCON:1 [13:57:01:153]AT+CNMPSD [13:57:01:162]OK [13:57:01:365] [13:57:01:365]+CSCON:0 //建立 RRC 连接，并开始发送数据 //通知网络没有数据业务 //RRC 连接立即释放 8.5.2.2. 发送 LwM2M CON/NON 数据 执行 AT+CSCON 命令使能 URC 上报功能，通过 URC 的上报状态，可判断 RAI 功能是否生效。 //模块已经连接至 IoT 平台 [14:07:36:307]AT+CSCON=1 //使能 URC 上报功能 [14:07:36:322]OK [14:07:36:876] [14:07:41:273]AT+QLWULDATAEX=5,1122334455,0x0000,2 //使用 0x0000 标志位发送 NON 数据 [14:07:41:309]OK [14:07:41:720] [14:07:42:866]+CSCON:1 //建立 RRC 连接，并开始发送数据 [14:07:44:296]AT+CNMPSD //通知网络没有数据业务 [14:07:44:305]OK [14:07:44:516] [14:07:44:516]+CSCON:0 //RRC 连接立即释放 [14:08:41:954]AT+QLWULDATAEX=5,1122334455,0x0100 //使用 0x0100 标志位发送 CON 数据 [14:08:41:979]OK [14:08:42:392] [14:08:43:725]+CSCON:1 //建立 RRC 连接，并开始发送数据 上海移远通信技术股份有限公司 205 / 210 [14:08:43:863] [14:08:43:863]+QLWULDATASTATUS:4 [14:08:49:328]AT+CNMPSD [14:08:49:328]OK [14:08:49:542] [14:08:49:542]+CSCON:0 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 //通知网络没有数据业务 //RRC 连接立即释放 上海移远通信技术股份有限公司 206 / 210 BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 9 附录 A 术语缩写 表 7：术语缩写 缩写 APDU APN BIP BS CDP CS DCE DF DTLS EARFCN eDRX EGPRS EMS eNB EPS E-UTRA(N) EOR GBR 英文全称 中文全称 Application Protocol Data Unit 应用协议数据单元 Access Point Name 接入点名称 Bearer Independent Protocol 承载独立协议 Bootstrap 引导 Connected Device Platform 连接设备平台 Circuit Switched 电路交换 Data Communication Equipment 数据通信设备 Dedicated File 专用文件 Datagram Transport Layer Security 数据包传输层安全性协议 E-UTRA Absolute Radio Frequency Channel E-UTRA 绝对无线频道编号 Number Extended Discontinuous Reception 扩展非连续性接收 Enhanced General Packet Radio Service 增强型数据速率 GSM 演进技术 EPS Session Management EPS 会话管理 Evolved Node B 演进型 Node B Evolved Packet System 演进型分组系统 Evolved Universal Terrestrial Radio Access 演进型通用地面无线接入（网络） (Network) Exclusive Or 异或 Guaranteed Bit Rate 保证的比特率 上海移远通信技术股份有限公司 207 / 210 GERAN GGSN GMT GPRS HPLMN HSDPA HSUPA ICMP IE IMEI IMEISV IP ISIM KV LwIP MBR MS MTU NAS NAT NB-IoT NSLPI PCI PCO PDP BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 GSM/EDGE Radio Access Network GSM/EDGE 无线接入网 Gateway GPRS Support Node 网关 GPRS 支持节点 Greenwich Mean Time 格林尼治标准时间 General Packet Radio Service 通用分组无线服务技术 Home Public Land Mobile Network 本地公用陆地移动网络 High Speed Downlink Packet Access 高速下行分组接入 High-Speed Uplink Packet Access 高速上行分组接入 Internet Control Messages Protocol 网间控制报文协议 Information Element 信息元素 International Mobile Equipment Identity 国际移动设备识别码 International Mobile Equipment Identity and 国际移动用户识别码及软件版本 Software Version Internet Protocol 互联网协议 IM (IP Multimedia) Service Identity Module IM（IP 多媒体）业务识别模块 Key Value 关键字取值 Lightweight IP(Internet Protocol) 轻型 IP 协议 Maximum Bit Rate 最大比特率 Mobile Station 移动台 Maximum Transfer Unit 最大传送单元 Non-access stratum 非接入层 Network Address Translation 网络地址转换 Narrow Band Internet of Thing 窄带物联网 NAS Signalling Low Priority Indication 非接入层信令低优先级指示 Physical Cell Identity 物理小区识别码 Protocol Configuration Options 协议配置选项 Packet Data Protocol 分组数据协议 上海移远通信技术股份有限公司 208 / 210 PF PS PSK PWM QCI QoS RAT RN RP RRC RTC RxQual SC SIB SNR SVN TA TCP TE TFT TP TPDU TTL UDP UE BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 Packet Filter Packet Switch Pre-shared Key Pulse Width Modulation QoS Class Identifier Quality of Service Radio Access Technology Release Note Relay Protocol Radio Resource Control Real Time Clock Receive Quality Service Center System Information Block Signal-to-Noise Ratio Software Version Number Terminal Adapter Transmission Control Protocol Terminal Equipment Traffic Flow Template Transport Transport Protocol Data Unit Time to Live User Datagram Protocol User Equipment 分组过滤器 分组交换 预共享密钥 脉冲宽度调制 QoS 等级标识 服务质量 无线接入技术 发布说明 中继协议 无线资源控制 实时时钟 接收质量 服务中心 系统信息块 信噪比 软件版本号 终端适配器 传输控制协议 终端设备 业务流模板 传输 传送协议数据单元 存活时间 用户数据报协议 用户设备 上海移远通信技术股份有限公司 209 / 210 UICC URC USIM UUID WIM XOFF XON Oos BC35-G&BC28&BC95 R2.0 系列 AT 命令手册 Universal Integrated Circuit Card Unsolicited Result Code Universal Subscriber Idneity Module Universally Unique Identifier Wireless Identity Module Transmit off Transmit on Out of Service 通用集成电路卡 非请求结果码 通用用户识别卡 通用唯一识别码 无线识别模块 停止传输 继续传输 退出服务 上海移远通信技术股份有限公司 210 / 210

EP06&EG06&EM06 AT Commands Manual LTE-A Module Series Rev. EP06&EG06&EM06_AT_Commands_Manual_V1.0 Date: 2018-08-10 Status: Released www.quectel.com LTE-A Module Series EP06&EG06&EM06 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. EP06&EG06&EM06_AT_Commands_Manual 1 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual About the Document History Revision Date 1.0 2018-08-10 Author Gibson PAN/ Anny ZHANG Description Initial EP06&EG06&EM06_AT_Commands_Manual 2 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 8 1 Introduction .......................................................................................................................................... 9 1.1. Scope of the Document ............................................................................................................. 9 1.2. AT Command Syntax ................................................................................................................. 9 1.3. Supported Character Sets ....................................................................................................... 10 1.4. AT Command Interface............................................................................................................ 10 1.5. Unsolicited Result Code .......................................................................................................... 10 1.6. Turn off Procedure ................................................................................................................... 11 2 General Commands ........................................................................................................................... 12 2.1. ATI Display Product Identification Information...................................................................... 12 2.2. AT+GMI Request Manufacturer Identification ...................................................................... 13 2.3. AT+GMM Request TA Model Identification ........................................................................... 13 2.4. AT+GMR Request TA Revision Identification of Software Release ..................................... 14 2.5. AT+CGMI Request Manufacturer Identification .................................................................... 14 2.6. AT+CGMM Request Model Identification ............................................................................. 15 2.7. AT+CGMR Request TA Revision Identification of Software Release ................................... 15 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) ...................................... 16 2.9. AT+CGSN Request Product Serial Number Identification ................................................... 17 2.10. AT&F Set All Current Parameters to Manufacturer Defaults ................................................ 17 2.11. AT&V Display Current Configuration .................................................................................... 18 2.12. AT&W Store Current Parameters to User Defined Profile .................................................... 19 2.13. ATZ Set All Current Parameters to User Defined Profile...................................................... 19 2.14. ATQ Set Result Code Presentation Mode ............................................................................ 20 2.15. ATV TA Response Format .................................................................................................... 20 2.16. ATE Set Command Echo Mode ............................................................................................ 22 2.17. A/ Repeat Previous Command Line ..................................................................................... 22 2.18. ATS3 Set Command Line Termination Character................................................................. 23 2.19. ATS4 Set Response Formatting Character .......................................................................... 24 2.20. ATS5 Set Command Line Editing Character ........................................................................ 24 2.21. ATX Set CONNECT Result Code Format and Monitor Call Progress ................................. 25 2.22. AT+CFUN Set UE Functionality ............................................................................................ 26 2.23. AT+CMEE Error Message Format ........................................................................................ 27 2.24. AT+CSCS Select TE Character Set...................................................................................... 28 2.25. AT+QURCCFG Configure URC Indication Option ............................................................... 29 3 Serial Interface Control Commands ................................................................................................ 31 3.1. AT&C Set DCD Function Mode ............................................................................................ 31 3.2. AT&D Set DTR Function Mode ............................................................................................. 31 3.3. AT+IFC Set TE-TA Local Data Flow Control......................................................................... 32 EP06&EG06&EM06_AT_Commands_Manual 3 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 3.4. AT+ICF Set TE-TA Control Character Framing .................................................................... 33 3.5. AT+IPR Set TE-TA Fixed Local Rate .................................................................................... 34 4 Status Control Commands ............................................................................................................... 36 4.1. AT+CPAS Mobile Equipment Activity Status......................................................................... 36 4.2. AT+CEER Extended Error Report ........................................................................................ 37 4.3. AT+QCFG Extended Configuration Settings ........................................................................ 38 4.3.1. AT+QCFG='gprsattach' GPRS Attach Mode Configuration....................................... 39 4.3.2. AT+QCFG='nwscanmode' Network Search Mode Configuration.............................. 40 4.3.3. AT+QCFG='roamservice' Roam Service Configuration ............................................ 41 4.3.4. AT+QCFG='servicedomain' Service Domain Configuration ...................................... 41 4.3.5. AT+QCFG='band' Band Configuration ...................................................................... 42 4.3.6. AT+QCFG='hsdpacat' HSDPA Category Configuration............................................. 44 4.3.7. AT+QCFG='hsupacat' HSUPA Category Configuration ............................................ 44 4.3.8. AT+QCFG='rrc' RRC Release Version Configuration ............................................... 45 4.3.9. AT+QCFG='sgsn' UE SGSN Release Version Configuration ................................... 46 4.3.10. AT+QCFG='msc' UE MSC Release Version Configuration....................................... 46 4.3.11. AT+QCFG='pdp/duplicatechk' Establish Multi PDNs with the Same APN ................ 47 4.3.12. AT+QCFG='urc/ri/ring' RI Behavior when RING URC is Presented.......................... 48 4.3.13. AT+QCFG='urc/ri/smsincoming' RI Behavior when Incoming SMS URCs are Presented...................................................................................................................................... 50 4.3.14. AT+QCFG='urc/ri/other' RI Behavior when Other URCs are Presented ................... 51 4.3.15. AT+QCFG='risignaltype' RI Signal Output Carrier .................................................... 51 4.3.16. AT+QCFG='urc/delay' Delay URC Indication ............................................................ 52 4.3.17. AT+QCFG='urc/cache' URC Cache Function............................................................ 53 4.3.18. AT+QCFG='tone/incoming' Enable/Disable Ringing Tone ........................................ 54 4.4. AT+QINDCFG URC Indication Configuration ....................................................................... 55 5 (U)SIM Related Commands ............................................................................................................... 58 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI)....................................... 58 5.2. AT+CLCK Facility Lock ......................................................................................................... 59 5.3. AT+CPIN Enter PIN .............................................................................................................. 61 5.4. AT+CPWD Change Password .............................................................................................. 63 5.5. AT+CSIM Generic (U)SIM Access ........................................................................................ 64 5.6. AT+CRSM Restricted (U)SIM Access................................................................................... 65 5.7. AT+QCCID Show ICCID ....................................................................................................... 66 5.8. AT+QPINC Display PIN Remainder Counter........................................................................ 67 5.9. AT+QINISTAT Query Initialization Status of (U)SIM Card .................................................... 68 5.10. AT+QSIMDET (U)SIM Card Detection.................................................................................. 68 5.11. AT+QSIMSTAT (U)SIM Insertion Status Report ................................................................... 69 6 Network Service Commands ............................................................................................................ 72 6.1. AT+COPS Operator Selection .............................................................................................. 72 6.2. AT+CREG Network Registration Status ............................................................................... 74 6.3. AT+CSQ Signal Quality Report............................................................................................. 76 6.4. AT+CPOL Preferred Operator List........................................................................................ 77 EP06&EG06&EM06_AT_Commands_Manual 4 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 6.5. 6.6. 6.7. 6.8. 6.9. 6.10. 6.11. 6.12. AT+COPN Read Operator Names........................................................................................ 78 AT+CTZU Automatic Time Zone Update .............................................................................. 79 AT+CTZR Time Zone Reporting ........................................................................................... 80 AT+QLTS Obtain the Latest Time Synchronized through Network ...................................... 82 AT+QNWINFO Query Network Information.......................................................................... 83 AT+QSPN Query the Service Provider Name ...................................................................... 85 AT+QENG Query Network Information................................................................................. 86 AT+QCAINFO Query Carrier Aggregation Parameters ........................................................ 90 7 Call Related Commands.................................................................................................................... 92 7.1. ATA Answer an Incoming Call............................................................................................... 92 7.2. ATD Mobile Originated Call to Dial a Number ...................................................................... 93 7.3. ATH Disconnect Existing Connection ................................................................................... 95 7.4. AT+CVHU Voice Hang up Control ........................................................................................ 95 7.5. AT+CHUP Hang up Calls ...................................................................................................... 96 7.6. +++ Switch from Data Mode to Command Mode ................................................................. 96 7.7. ATO Switch from Command Mode to Data Mode ................................................................ 97 7.8. ATS0 Set Number of Rings before Automatically Answering Call........................................ 98 7.9. ATS6 Set Pause before Blind Dialing ................................................................................... 99 7.10. ATS7 Set Time to Wait for Connection Completion .............................................................. 99 7.11. ATS8 Set the Time to Wait for Comma Dial Modifier.......................................................... 100 7.12. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier .................. 101 7.13. AT+CSTA Select Type of Address ...................................................................................... 101 7.14. AT+CLCC List Current Calls of ME..................................................................................... 102 7.15. AT+CR Service Reporting Control ...................................................................................... 103 7.16. AT+CRC Set Cellular Result Codes for Incoming Call Indication ...................................... 104 7.17. AT+CRLP Select Radio Link Protocol Parameter .............................................................. 106 7.18. AT+QECCNUM Configure Emergency Call Numbers........................................................ 107 7.19. AT+QHUP Hang up Call with a Specific Release Cause ................................................... 109 7.20. AT^DSCI Call Status Indication........................................................................................... 110 7.21. AT+QCHLDIPMPTY Remove a Participant from the Conference Call .............................. 112 8 Phonebook Commands................................................................................................................... 113 8.1. AT+CNUM Subscriber Number........................................................................................... 113 8.2. AT+CPBF Find Phonebook Entries .................................................................................... 114 8.3. AT+CPBR Read Phonebook Entries .................................................................................. 115 8.4. AT+CPBS Select Phonebook Memory Storage.................................................................. 116 8.5. AT+CPBW Write Phonebook Entry..................................................................................... 117 9 Short Message Service Commands............................................................................................... 119 9.1. AT+CSMS Select Message Service ................................................................................... 119 9.2. AT+CMGF Message Format ............................................................................................... 120 9.3. AT+CSCA Service Center Address..................................................................................... 121 9.4. AT+CPMS Preferred Message Storage.............................................................................. 122 9.5. AT+CMGD Delete Messages.............................................................................................. 124 9.6. AT+CMGL List Messages ................................................................................................... 125 EP06&EG06&EM06_AT_Commands_Manual 5 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 9.7. 9.8. 9.9. 9.10. 9.11. 9.12. 9.13. 9.14. 9.15. 9.16. AT+CMGR Read Messages ............................................................................................... 128 AT+CMGS Send Messages ................................................................................................ 132 AT+CMMS Send More Messages ...................................................................................... 133 AT+CMGW Write Messages to Memory............................................................................. 134 AT+CMSS Send Messages from Storage .......................................................................... 136 AT+CNMA Mew Message Acknowledgement to UE/TE..................................................... 138 AT+CNMI SMS Event Reporting Configuration .................................................................. 139 AT+CSCB Select Cell Broadcast Message Types ............................................................. 142 AT+CSDH Show SMS Text Mode Parameters ................................................................... 143 AT+CSMP Set SMS Text Mode Parameters ...................................................................... 144 10 Packet Domain Commands ............................................................................................................ 145 10.1. AT+CGATT Attachment or Detachment of PS.................................................................... 145 10.2. AT+CGDCONT Define PDP Contexts ................................................................................ 146 10.3. AT+CGQREQ Quality of Service Profile (Requested)........................................................ 148 10.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) ......................................... 150 10.5. AT+CGEQREQ 3G Quality of Service Profile (Requested) ............................................... 153 10.6. AT+CGEQMIN 3G Quality of Service Profile (Minimum Acceptable)................................. 157 10.7. AT+CGACT Activate or Deactivate PDP Contexts ............................................................. 160 10.8. AT+CGDATA Enter Data State............................................................................................ 162 10.9. AT+CGPADDR Show PDP Address ................................................................................... 163 10.10. AT+CGCLASS GPRS Mobile Station Class ....................................................................... 164 10.11. AT+CGREG Network Registration Status........................................................................... 165 10.12. AT+CGEREP Packet Domain Event Reporting.................................................................. 166 10.13. AT+CGSMS Select Service for MO SMS Messages.......................................................... 168 10.14. AT+CEREG EPS Network Registration Status................................................................... 169 10.15. AT+QGDCNT Packet Data Counter ................................................................................... 170 10.16. AT+QAUGDCNT Auto Save Packet Data Counter............................................................. 172 10.17. AT+QMTUINFO Query MTU Value..................................................................................... 173 10.18. AT$QCRMCALL Start or Stop a RmNet Call ...................................................................... 174 10.19. AT+QNETDEVSTATUS Query RmNet Device Status ........................................................ 175 11 Supplementary Service Commands .............................................................................................. 178 11.1. AT+CCFC Call Forwarding Number and Conditions Control ............................................. 178 11.2. AT+CCWA Call Waiting Control .......................................................................................... 180 11.3. AT+CHLD Call Related Supplementary Services............................................................... 182 11.4. AT+CLIP Calling Line Identification Presentation ............................................................... 184 11.5. AT+CLIR Calling Line Identification Restriction .................................................................. 185 11.6. AT+COLP Connected Line Identification Presentation....................................................... 187 11.7. AT+CSSN Supplementary Service Notifications ................................................................ 188 11.8. AT+CUSD Unstructured Supplementary Service Data ...................................................... 190 12 Audio Commands ............................................................................................................................ 192 12.1. AT+CLVL Loudspeaker Volume Level Selection ................................................................ 192 12.2. AT+CMUT Mute Control...................................................................................................... 193 12.3. AT+QAUDLOOP Enable/Disable Audio Loop Test ............................................................. 194 EP06&EG06&EM06_AT_Commands_Manual 6 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.4. AT+VTS DTMF and Tone Generation................................................................................. 194 12.5. AT+VTD Set Tone Duration................................................................................................. 196 12.6. AT+QAUDMOD Set Audio Mode ........................................................................................ 197 12.7. AT+QDAI Digital Audio Interface Configuration .................................................................. 197 12.8. AT+QEEC Set Echo Cancellation Parameters ................................................................... 200 12.9. AT+QSIDET Set the Side Tone Gain in Current Mode ....................................................... 201 12.10. AT+QMIC Set Uplink Gains of Microphone ........................................................................ 202 12.11. AT+QRXGAIN Set Downlink Gains of RX .......................................................................... 203 12.12. AT+QIIC IIC Read & Write .................................................................................................. 204 12.13. AT+QTONEDET Enable/Disable DTMF Detection............................................................. 205 12.14. AT+QLDTMF Play Local DTMF .......................................................................................... 206 12.15. AT+QLTONE Play a Local Customized Tone ..................................................................... 207 12.16. AT+QAUDCFG Configure Audio Related Settings ............................................................. 209 12.16.1. AT+QAUDCFG='voltedtmfcfg' Configure VoLTE DTMF Tone ................................. 209 12.16.2. AT+QAUDCFG='toneswitch' Switch on/off Ring Tone............................................. 210 13 Hardware Related Commands ........................................................................................................ 212 13.1. AT+QPOWD Power off ....................................................................................................... 212 13.2. AT+CCLK Clock .................................................................................................................. 213 13.3. AT+CBC Battery Charge..................................................................................................... 214 13.4. AT+QADC Read ADC Value ............................................................................................... 215 13.5. AT+QSCLK Enable/Disable Entering into Sleep Mode ...................................................... 215 14 Appendix ........................................................................................................................................... 217 14.1. References ............................................................................................................................ 217 14.2. Factory Default Settings Restorable with AT&F .................................................................... 218 14.3. AT Command Settings Storable with AT&W .......................................................................... 220 14.4. AT Command Settings Storable with ATZ ............................................................................. 221 14.5. Summary of CME ERROR Codes......................................................................................... 222 14.6. Summary of CMS ERROR Codes......................................................................................... 223 14.7. Summary of URC................................................................................................................... 225 14.8. SMS Character Sets Conversions......................................................................................... 227 14.9. Release Cause Text List of AT+CEER .................................................................................. 233 EP06&EG06&EM06_AT_Commands_Manual 7 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Table Index TABLE 1: TYPES OF AT COMMANDS AND RESPONSES ..................................................................... 10 TABLE 2: AT&V RESPONSE ..................................................................................................................... 18 TABLE 3: ATV0&ATV1 RESULT CODES NUMERIC EQUIVALENTS AND BRIEF DESCRIPTION ........ 21 TABLE 4: DELAY CLASS ......................................................................................................................... 150 TABLE 5: RELATED DOCUMENTS ........................................................................................................ 217 TABLE 6: TERMS AND ABBREVIATIONS .............................................................................................. 217 TABLE 7: FACTORY DEFAULT SETTINGS RESTORABLE WITH AT&F .............................................. 218 TABLE 8: AT COMMAND SETTINGS STORABLE WITH AT&W ............................................................ 220 TABLE 9: AT COMMAND SETTINGS STORABLE WITH ATZ................................................................ 221 TABLE 10: DIFFERENT CODING SCHEMES OF +CME ERROR: ........................................... 222 TABLE 11: DIFFERENT CODING SCHEMES OF +CMS ERROR: ........................................... 224 TABLE 12: SUMMARY OF URC .............................................................................................................. 225 TABLE 13: THE WAY OF SMS TEXT INPUT OR OUTPUT.................................................................... 227 TABLE 14: THE INPUT CONVERSIONS TABLE (DCS=GSM 7-BIT AND AT+CSCS='GSM').............. 228 TABLE 15: THE OUTPUT CONVERSIONS TABLE (DCS=GSM 7-BIT AND AT+CSCS='GSM').......... 229 TABLE 16: GSM EXTENDED CHARACTERS ........................................................................................ 229 TABLE 17: THE INPUT CONVERSIONS TABLE (DCS=GSM 7-BIT AND AT+CSCS='IR).................... 230 TABLE 18: IRA EXTENDED CHARACTERS........................................................................................... 231 TABLE 19: THE OUTPUT CONVERSIONS TABLE (DCS=GSM 7-BIT AND AT+CSCS='IRA')............ 232 TABLE 20: GSM EXTENDED CHARACTERS ........................................................................................ 232 TABLE 21: RELEASE CAUSE TEXT LIST OF AT+CEER....................................................................... 233 EP06&EG06&EM06_AT_Commands_Manual 8 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 1 Introduction 1.1. Scope of the Document This document presents the AT Commands Set for Quectel cellular engines EP06&EG06&EM06. 1.2. AT Command Syntax The 'AT' or 'at' prefix must be set at the beginning of each command line. To terminate a command line enter . Commands are usually followed by a response that includes ''. Throughout this document, only the responses are presented, '' are omitted intentionally. The AT Commands Set implemented by EP06&EG06&EM06 is a combination of 3GPP TS 27.007, 3GPP TS 27.005 and ITU-T recommendation V.25ter as well as the AT Commands developed by Quectel. All these AT commands can be split into three categories syntactically: 'basic', 'S parameter', and 'extended'. They are listed as follows: ⚫ Basic syntax These AT commands have the format of 'AT', or 'AT&', where '' is the command, and '' is/are the argument(s) for that command. An example of this is 'ATE', which tells the DCE whether received characters should be echoed back to the DTE according to the value of ''. '' is optional and a default will be used if it is missing. ⚫ S parameter syntax These AT commands have the format of 'ATS=', where '' is the index of the S register to set, and '' is the value to assign to it. ⚫ Extended syntax These commands can be operated in several modes, as following table: EP06&EG06&EM06_AT_Commands_Manual 9 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Table 1: Types of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? AT+? The command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. The command returns the currently set value of the parameter or parameters. AT+= The command sets the user-definable parameter values. AT+ The command reads non-variable parameters affected by internal processes in the UE. 1.3. Supported Character Sets EP06&EG06&EM06 AT command interface defaults to the GSM character set. EP06&EG06&EM06 modules support the following character sets: ⚫ GSM format ⚫ UCS2 ⚫ IRA The character set can be configured and interrogated by using the AT+CSCS command (3GPP TS 27.007) and it is defined in 3GPP TS 27.005. The character set affects transmission and reception of SMS and SMS Cell Broadcast Messages, as well as the entry and display of phone book entries text field. 1.4. AT Command Interface EP06&EG06&EM06 AT command interface includes two USB ports (USB MODEM port and USB AT port) and one main UART port. The main UART port and two USB ports support AT command communication and data transfer. 1.5. Unsolicited Result Code As an Unsolicited Result Code and a report message, URC is not issued as part of the response related to an executed AT command. URC is issued by the EP06&EG06&EM06 without being requested by the TE and it is issued automatically when a certain event occurs. Typical events leading to URCs are incoming calls (RING), received short messages, high/low voltage alarm, high/low temperature alarm, etc. EP06&EG06&EM06_AT_Commands_Manual 10 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 1.6. Turn off Procedure It is recommended to execute AT+QPOWD command to turn off the module, as it is the safest and best way. This procedure is realized by letting the module log off from the network and allowing the software to enter into a secure and safe data state before disconnecting the power supply. After sending AT+QPOWD, do not enter any other AT commands. The module outputs message POWERED DOWN and sets the STATUS pin as low to enter into the shutdown state. In order to avoid data loss, it is suggested to wait for 1s to switch off the VBAT after the STATUS pin is set as low and the URC POWERED DOWN is outputted. If POWERED DOWN has not been received after 65s, the VBAT shall be switched off compulsorily. EP06&EG06&EM06_AT_Commands_Manual 11 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2 General Commands 2.1. ATI Display Product Identification Information The command delivers a product information text. ATI Display Product Identification Information Execution Command ATI Response TA issues product information text. Quectel Ex06 Revision: Maximum Response Time Reference V.25ter OK 300ms Parameter Identification text of product software version Example ATI Quectel EP06 Revision: EP06ELAR01A02M4G OK EP06&EG06&EM06_AT_Commands_Manual 12 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2.2. AT+GMI Request Manufacturer Identification The command returns a manufacturer identification text. See also AT+CGMI. AT+GMI Request Manufacturer Identification Test Command AT+GMI=? Execution Command AT+GMI Response OK Response TA reports one or more lines of information text which permit the user to identify the manufacturer. Quectel Maximum Response Time Reference V.25ter OK 300ms 2.3. AT+GMM Request TA Model Identification The command returns a product model identification text. It is identical with AT+CGMM. AT+GMM Request TA Model Identification Test Command AT+GMM=? Execution Command AT+GMM Response OK Response TA returns a product model identification text. Ex06 Maximum Response Time Reference V.25ter OK 300ms EP06&EG06&EM06_AT_Commands_Manual 13 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2.4. AT+GMR Request TA Revision Identification of Software Release The command delivers a product firmware version identification text. It is identical with AT+CGMR. AT+GMR Request TA Revision Identification of Software Release Test Command AT+GMR=? Execution Command AT+GMR Response OK Response TA reports one or more lines of information text which permit the user to identify the revision of software release. Maximum Response Time Reference V.25ter OK 300ms Parameter Identification text of product software version Example AT+GMR EP06ELAR01A02M4G OK 2.5. AT+CGMI Request Manufacturer Identification The command returns a manufacturer identification text. See also AT+GMI. AT+CGMI Request Manufacturer Identification Test Command AT+CGMI=? Execution Command AT+CGMI Response OK Response TA returns manufacturer identification text. Quectel EP06&EG06&EM06_AT_Commands_Manual 14 / 240 Maximum Response Time Reference 3GPP TS 27.007 OK 300ms LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2.6. AT+CGMM Request Model Identification The command returns a product model identification text. It is identical with AT+GMM. AT+CGMM Request Model Identification Test Command AT+CGMM=? Execution Command AT+CGMM Response OK Response TA returns product model identification text. Ex06 Maximum Response Time Reference 3GPP TS 27.007 OK 300ms 2.7. AT+CGMR Request TA Revision Identification of Software Release The command delivers a product firmware version identification text. It is identical with AT+GMR. AT+CGMR Request TA Revision Identification of Software Release Test Command AT+CGMR=? Execution Command AT+CGMR Response OK Response TA returns identification text of product software version. Maximum Response Time Reference 3GPP TS 27.007 OK 300ms EP06&EG06&EM06_AT_Commands_Manual 15 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Identification text of product software version 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) The command returns the International Mobile Equipment Identity (IMEI) number of the ME. It is identical with AT+CGSN. AT+GSN Request International Mobile Equipment Identity (IMEI) Test Command AT+GSN=? Execution Command AT+GSN Response OK Response TA reports the IMEI (International Mobile Equipment Identity) number in information text which permits the user to identify the individual ME device. Maximum Response Time Reference V.25ter OK 300ms Parameter IMEI of the ME NOTE The serial number (IMEI) varies with the individual ME device. EP06&EG06&EM06_AT_Commands_Manual 16 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2.9. AT+CGSN Request Product Serial Number Identification The command returns International Mobile Equipment Identity (IMEI) number of the ME. It is identical with AT+GSN. AT+CGSN Request Product Serial Number Identification Test Command AT+CGSN=? Execution Command AT+CGSN Response OK Response Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter IMEI of the ME NOTE The serial number (IMEI) varies with the individual ME device. 2.10. AT&F Set All Current Parameters to Manufacturer Defaults The command resets AT command settings to the factory default values. AT&F Set All Current Parameters to Manufacturer Defaults Execution Command AT&F[] Response TA sets all current parameters to the manufacturer defined profile. See Table 8. OK Maximum Response Time 300ms Reference V.25ter EP06&EG06&EM06_AT_Commands_Manual 17 / 240 Parameter 0 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Set all TA parameters to manufacturer defaults 2.11. AT&V Display Current Configuration The command displays the current settings of several AT command parameters, including the single-letter AT command parameters which are not readable otherwise. AT&V Display Current Configuration Execution Command AT&V Response TA returns the current parameter settings. See Table 2. OK Maximum Response Time 300ms Reference V.25ter Table 2: AT&V Response AT&V &C: 1 &D: 2 &F: 0 &W: 0 E: 1 Q: 0 V: 1 X: 4 Z: 0 S0: 0 S3: 13 S4: 10 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 OK EP06&EG06&EM06_AT_Commands_Manual 18 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2.12. AT&W Store Current Parameters to User Defined Profile The command stores the current AT command settings to a user defined profile in non-volatile memory. AT&W Store Current Parameters to User Defined Profile Execution Command AT&W[] Response TA stores the current parameter settings in the user defined profile. See Table 9. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 Profile number to store current parameters 2.13. ATZ Set All Current Parameters to User Defined Profile The command restores the current AT command settings to the user defined profile in non-volatile memory, if one was stored with AT&W before. Any additional AT command on the same command line may be ignored. ATZ Set All Current Parameters to User Defined Profile Execution Command ATZ[] Response TA sets all current parameters to the user defined profile. See Table 10. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 Reset to profile number 0 EP06&EG06&EM06_AT_Commands_Manual 19 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2.14. ATQ Set Result Code Presentation Mode The command controls whether the result code is transmitted to the TE. Other information text transmitted as response is not affected. ATQ Set Result Code Presentation Mode Execution Command ATQ Response This parameter setting determines whether or not the TA transmits any result code to the TE. Information text transmitted in response is not affected by this setting. If =0: OK Maximum Response Time Reference V.25ter If =1: (none) 300ms Parameter 0 1 TA transmits result code Result codes are suppressed and not transmitted 2.15. ATV TA Response Format The command determines the contents of header and trailer transmitted with AT command result codes and information responses. The result codes, their numeric equivalents and brief descriptions of the use of each are listed in the following table. ATV TA Response Format Execution Command ATV Response This parameter setting determines the contents of the header and trailer transmitted with result codes and information responses. When =0 0 EP06&EG06&EM06_AT_Commands_Manual 20 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference V.25ter When =1 OK 300ms Parameter 0 1 Information response: Short result code format: Information response: Long result code format: Example ATV1 OK AT+CSQ +CSQ: 30,99 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //Set =1 //When =1 result code is OK //Set =0 //When =0 result code is 0 Table 3: ATV0&ATV1 Result Codes Numeric Equivalents and Brief Description ATV1 OK CONNECT RING NO CARRIER ERROR ATV0 0 1 2 3 4 Description Acknowledges execution of a command A connection has been established; the DCE is moving from command state to data state The DCE has detected an incoming call signal from network The connection has been terminated or the attempt to establish a connection failed Command not recognized, command line maximum length exceeded, parameter value invalid, or other problem with processing the command line EP06&EG06&EM06_AT_Commands_Manual 21 / 240 NO DIALTONE 6 BUSY 7 NO ANSWER 8 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual No dial tone detected Engaged (busy) signal detected '@' (Wait for Quiet Answer) dial modifier was used, but remote ringing followed by five seconds of silence was not detected before expiration of the connection timer (S7) 2.16. ATE Set Command Echo Mode The command controls whether or not the module echoes characters received from TE during AT command mode. ATE Set Command Echo Mode Execution Command ATE Maximum Response Time Reference V.25ter Response This setting determines whether or not the TA echoes characters received from TE during command mode. OK 300ms Parameter 0 1 Echo mode OFF Echo mode ON 2.17. A/ Repeat Previous Command Line The command repeats previous AT command line, and '/' acts as the line terminating character. A/ Repeat Previous Command Line Execution Command A/ Reference V.25ter Response Repeat the previous command EP06&EG06&EM06_AT_Commands_Manual 22 / 240 Example ATI Quectel EP06 Revision: EP06ELAR01A02M4G OK A/ Quectel EP06 Revision: EP06ELAR01A02M4G OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Repeat the previous command 2.18. ATS3 Set Command Line Termination Character The command determines the character recognized by the module to terminate an incoming command line. It is also generated for result codes and information text, along with character value set via ATS4. ATS3 Set Command Line Termination Character Read Command ATS3? Response Write Command ATS3= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the character recognized by TA to terminate an incoming command line. The TA also returns this character in output. OK 300ms Parameter 0-13-127 Command line termination character (Default 13=) EP06&EG06&EM06_AT_Commands_Manual 23 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2.19. ATS4 Set Response Formatting Character The command determines the character generated by the module for result code and information text, along with the command line termination character set via ATS3. ATS4 Set Response Formatting Character Read Command ATS4? Response Write Command ATS4= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the character generated by the TA for result code and information text. OK 300ms Parameter 0-10-127 Response formatting character (Default 10=) 2.20. ATS5 Set Command Line Editing Character The command determines the character value used by the module to delete the immediately preceding character from the AT command line (i.e. equates to backspace key). ATS5 Set Command Line Editing Character Read Command ATS5? Response Write Command ATS5= Maximum Response Time OK Response This parameter setting determines the character recognized by TA as a request to delete the immediately preceding character from the command line. OK 300ms EP06&EG06&EM06_AT_Commands_Manual 24 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Reference V.25ter Parameter 0-8-127 Response editing character (Default 8=) 2.21. ATX Set CONNECT Result Code Format and Monitor Call Progress The command determines whether or not the module transmits particular result codes to the TE. It also controls whether or not the module verifies the presence of a dial tone when it begins dialing, and whether or not engaged tone (busy signal) detection is enabled. ATX Set CONNECT Result Code Format and Monitor Call Progress Execution Command ATX Response This parameter setting determines whether or not the TA detected the presence of dial tone and busy signal and whether or not TA transmits particular result codes. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 1 2 3 4 CONNECT result code only returned, dial tone and busy detection are both disabled CONNECT result code only returned, dial tone and busy detection are both disabled CONNECT result code returned, dial tone detection is enabled, busy detection is disabled CONNECT result code returned, dial tone detection is disabled, busy detection is enabled CONNECT result code returned, dial tone and busy detection are both enabled EP06&EG06&EM06_AT_Commands_Manual 25 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2.22. AT+CFUN Set UE Functionality The command controls the functionality level. It can also be used to reset the UE. AT+CFUN Set UE Functionality Test Command AT+CFUN=? Response +CFUN: (list of supported s),(list of supported s) Read Command AT+CFUN? OK Response +CFUN: Write Command AT+CFUN=[,] OK Response OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 15s, determined by network. Parameter 0 1 4 0 1 Minimum functionality Full functionality Disable the UE from both transmitting and receiving RF signals Do not reset the ME before setting it to power level This is default when is not given Reset the ME. The device is fully functional after the reset. This value is available only for =1 Example AT+CFUN=0 OK AT+COPS? +COPS: 0 OK AT+CPIN? //Switch UE to minimum functionality //No operator is registered EP06&EG06&EM06_AT_Commands_Manual 26 / 240 +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN=1234 OK +CPIN: READY +QUSIM: 1 +QIND: PB DONE +QIND: SMS DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE CMCC',7 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //(U)SIM failure //Switch UE to full functionality //Operator is registered 2.23. AT+CMEE Error Message Format The command controls the format of error result codes: ERROR, error numbers or verbose messages as +CME ERROR: and +CMS ERROR: . AT+CMEE Error Message Format Test Command AT+CMEE=? Response +CMEE: (list of supported s) Read Command AT+CMEE? OK Response +CMEE: Write Command AT+CMEE= OK Response TA disables or enables the use of result code +CME ERROR: as an indication of an error related to the functionality of the ME. EP06&EG06&EM06_AT_Commands_Manual 27 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter 0 Disable result code 1 Enable result code and use numeric values 2 Enable result code and use verbose values Example AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted //Disable result code //Only ERROR will be displayed //Enable error result code with numeric values //Enable error result code with verbose (string) values 2.24. AT+CSCS Select TE Character Set The Write Command informs the module which character set is used by the TE. This enables the UE to convert character strings correctly between TE and UE character sets. AT+CSCS Select TE Character Set Test Command AT+CSCS=? Response +CSCS: (list of supported s) Read Command AT+CSCS? OK Response +CSCS: EP06&EG06&EM06_AT_Commands_Manual 28 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Write Command AT+CSCS= Maximum Response Time Reference 3GPP TS 27.007 OK Response Set character set which is used by the TE. The TA can then convert character strings correctly between the TE and ME character sets. OK 300ms Parameter 'GSM' 'IRA' 'UCS2' GSM default alphabet International reference alphabet UCS2 alphabet Example AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //Query the current character set //Set the character set to 'UCS2' 2.25. AT+QURCCFG Configure URC Indication Option The command is used to configure the output port of URC. AT+QURCCFG Configure URC Indication Option Test Command AT+QURCCFG=? Response +QURCCFG: 'urcport',('usbat','usbmodem','uart1') Write Command AT+QURCCFG='urcport'[,<urcportv OK If the configuration parameter is omitted, return current configuration: EP06&EG06&EM06_AT_Commands_Manual 29 / 240 alue>] Maximum Response Time LTE-A Module Series EP06&EG06&EM06 AT Commands Manual +QURCCFG: 'urcport', OK If the configuration parameter is not omitted, response: OK Or ERROR 300ms Parameter Set URC output port 'usbat' 'usbmodem' 'uart1' USB AT port USB modem port Main UART NOTES 1. Configuration of URC output port will be saved to NV immediately by default. 2. After configuration of URC output port is set successfully, it will take effect immediately. Example AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' OK AT+QURCCFG='urcport','usbmodem' OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' OK EP06&EG06&EM06_AT_Commands_Manual 30 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 3 Serial Interface Control Commands 3.1. AT&C Set DCD Function Mode The command controls the behavior of the UE’s DCD (data carrier detection) line. AT&C Set DCD Function Mode Execution Command AT&C[] Maximum Response Time Reference V.25ter Response This parameter determines how the state of circuit 109 (DCD) relates to the detection of received line signal from the distant end. OK 300ms Parameter 0 1 DCD line is always ON DCD line is ON only in the presence of data carrier 3.2. AT&D Set DTR Function Mode The command determines how the UE responds if DTR line is changed from low to high level during data mode. AT&D Set DTR Function Mode Execution Command AT&D[] Response This parameter determines how the TA responds when circuit 108/2 (DTR) is changed from low to high level during data mode. OK EP06&EG06&EM06_AT_Commands_Manual 31 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference V.25ter 300ms Parameter 0 TA ignores status on DTR 1 Low→High on DTR: Change to command mode while remaining the connected call 2 Low→High on DTR: Disconnect data call, and change to command mode. When DTR is at high level, auto-answer function is disabled. 3.3. AT+IFC Set TE-TA Local Data Flow Control The command determines the flow control behavior of the serial port. AT+IFC Set TE-TA Local Data Flow Control Test Command AT+IFC=? Response +IFC: (list of supported s),(list of supported s) Read Command AT+IFC? OK Response +IFC: , Write Command AT+IFC=, OK Response This parameter setting determines the data flow control on the serial interface for data mode. OK Maximum Response Time 300ms Reference V.25ter Parameter Specifies the method that will be used by TE when receiving data from TA 0 None 2 RTS flow control Specifies the method that will be used by TA when receiving data from TE EP06&EG06&EM06_AT_Commands_Manual 32 / 240 0 None 2 CTS flow control LTE-A Module Series EP06&EG06&EM06 AT Commands Manual NOTE The flow control is only applicable for data mode. Example AT+IFC=2,2 OK AT+IFC? +IFC: 2,2 OK //Open the hardware flow control 3.4. AT+ICF Set TE-TA Control Character Framing The command determines the serial interface character framing format and parity received by TA from TE. AT+ICF Set TE-TA Control Character Framing Test Command AT+ICF=? Response +ICF: (list of supported s),(list of supported s) Read Command AT+ICF? OK Response +ICF: , Write Command AT+ICF=[,[]] Maximum Response Time Reference V.25ter OK Response This parameter setting determines the serial interface character framing format and parity received by TA from TE. OK 300ms EP06&EG06&EM06_AT_Commands_Manual 33 / 240 Parameter 3 0 1 2 3 8 data 0 parity 1 stop Odd Even Mark (1) Space (0) LTE-A Module Series EP06&EG06&EM06 AT Commands Manual NOTES 1. The command is applied for command state. 2. The field is ignored if the field specifies no parity. 3.5. AT+IPR Set TE-TA Fixed Local Rate The command is used to query and set the baud rate of the UART. The default baud rate value () is 115200bps. The setting of will not be restored with AT&F. AT+IPR Set TE-TA Fixed Local Rate Test Command AT+IPR=? Response +IPR: (list of supported auto detectable s),(list of supported fixed-only s) Read Command AT+IPR? OK Response +IPR: Write Command AT+IPR= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the data rate of the TA on the serial interface. After the delivery of any result code associated with the current command line, the rate of command takes effect. OK 300ms EP06&EG06&EM06_AT_Commands_Manual 34 / 240 Parameter 115200 460800 Baud rate per second 9600 19200 38400 57600 230400 921600 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual NOTES 1. If a fixed baud rate is set, make sure that both TE (DTE, usually external processor) and TA (DCE, Quectel module) are configured to the same rate. 2. The value of AT+IPR cannot be restored with AT&F and ATZ; but it is still storable with AT&W. 3. In multiplex mode, the baud rate cannot be changed by the Write Command AT+IPR=; and the setting is invalid and cannot be stored even if AT&W is executed after the Write Command. 4. A selected baud rate takes effect after the Write Command is executed and acknowledged by OK. Example AT+IPR=115200 OK AT&W OK AT+IPR? +IPR: 115200 OK AT+IPR=115200;&W OK //Set fixed baud rate to 115200bps //Store current setting, that is, the serial communication speed is 115200bps after restarting module //Set fixed baud rate to 115200bps and store current setting EP06&EG06&EM06_AT_Commands_Manual 35 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4 Status Control Commands 4.1. AT+CPAS Mobile Equipment Activity Status The Execution Command queries the module’s activity status. AT+CPAS Mobile Equipment Activity Status Test Command AT+CPAS=? Response +CPAS: (list of supported s) Execution Command AT+CPAS OK Response TA returns the activity status of ME: +CPAS: OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 3 4 Ready Ringing Call in progress or call hold EP06&EG06&EM06_AT_Commands_Manual 36 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Example AT+CPAS +CPAS: 0 OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129 OK AT+CPAS +CPAS: 4 OK //The module is idle //The module is ringing //Call in progress 4.2. AT+CEER Extended Error Report The command is used to query an extended error and report the cause of the last failed operation, such as: ⚫ the failure to release a call ⚫ the failure to set up a call (both mobile originated or terminated) ⚫ the failure to modify a call by using supplementary services ⚫ the failure to activate, register, query, deactivate or deregister a supplementary service ⚫ the failure to attach GPRS or the failure to activate PDP context ⚫ the failure to detach GPRS or the failure to deactivate PDP context The release cause is a text to describe the cause information given by the network. EP06&EG06&EM06_AT_Commands_Manual 37 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CEER Extended Error Report Test command AT+CEER=? Execution command AT+CEER Response OK Response +CEER: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Release cause text. Reason for the last call failure to setup or release (listed in Chapter 14.9). Both CS and PS domain call types are reported. Cause data is captured from Call Manager events and cached locally to later use by this command. 4.3. AT+QCFG Extended Configuration Settings The command is used to query and configure various settings of UE. AT+QCFG Extended Configuration Settings Test Command AT+QCFG=? Response +QCFG: 'gprsattach',(list of supported s) +QCFG: 'nwscanmode',(list of supported s),(list of supported s) +QCFG: 'roamservice',(list of supported s), (list of supported s) +QCFG: 'servicedomain',(list of supported s), (list of supported s) +QCFG: 'band',(list of supported s),(list of supported s),(list of supported s) +QCFG: 'hsdpacat',(list of supported s) +QCFG: 'hsupacat',(list of supported s) +QCFG: 'rrc',(list of supported s) +QCFG: 'sgsn',(list of supported s) +QCFG: 'msc',(list of supported s) EP06&EG06&EM06_AT_Commands_Manual 38 / 240 Maximum Response Time Reference LTE-A Module Series EP06&EG06&EM06 AT Commands Manual +QCFG: 'pdp/duplicatechk',(list of supported s) +QCFG: 'tdscsq',(list of supported s) +QCFG: 'urc/ri/ring',(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) +QCFG: 'urc/ri/smsincoming',(list of supported s),(list of supported s) +QCFG: 'urc/ri/other',(list of supported s), (list of supported s) +QCFG: 'risignaltype',(list of supported s) +QCFG: 'urc/cache',(list of supported s) OK 300ms 4.3.1.AT+QCFG='gprsattach' GPRS Attach Mode Configuration The command specifies the mode to attach GPRS when UE is powered on. This configuration is valid only after the module is restarted. AT+QCFG='gprsattach' GPRS Attach Mode Configuration Write Command AT+QCFG='gprsattach'[,] Response If configuration parameters is omitted, return current configuration: +QCFG: 'gprsattach', OK If configuration parameters is not omitted, configure the GPRS attach mode: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms EP06&EG06&EM06_AT_Commands_Manual 39 / 240 Parameter LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Number format, the mode to attach GRPS when UE is powered on 0 Manual attach 1 Auto attach 4.3.2.AT+QCFG='nwscanmode' Network Search Mode Configuration The command specifies the network mode to be searched. If is omitted, the configuration will take effect immediately. AT+QCFG='nwscanmode' Network Search Mode Configuration Write Command AT+QCFG='nwscanmode'[,[,]] Response If and are both omitted, return the current configuration: +QCFG: 'nwscanmode', OK If and are not omitted, set the network mode to be searched: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Number format, network search mode 0 AUTO 2 WCDMA only 3 LTE only Number format, when to take effect 0 Take effect after UE reboots 1 Take effect immediately EP06&EG06&EM06_AT_Commands_Manual 40 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4.3.3.AT+QCFG='roamservice' Roam Service Configuration The command is used to enable or disable the roam service. If is omitted, the configuration will take effect immediately. AT+QCFG='roamservice' Roam Service Configuration Write Command AT+QCFG='roamservice'[,[,]] Response If and are both omitted, return the current configuration: +QCFG: 'roamservice', OK If and are not omitted, configure the mode of roam service: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Number format, the mode of roam service 1 Disable roam service 2 Enable roam service 255 Auto Number format, when to take effect 0 Take effect after UE reboots 1 Take effect immediately 4.3.4.AT+QCFG='servicedomain' Service Domain Configuration The command specifies the registered service domain. If is omitted, the configuration will take effect immediately. EP06&EG06&EM06_AT_Commands_Manual 41 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+QCFG='servicedomain' Service Domain Configuration Write Command AT+QCFG='servicedomain'[,[,]] Response If and are both omitted, return the current configuration: +QCFG: 'servicedomain', OK If and are not omitted, configure the service domain of UE: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Service domain of UE 0 CS only 1 PS only 2 CS & PS Number format, when to take effect 0 Take effect after UE reboots 1 Take effect immediately 4.3.5.AT+QCFG='band' Band Configuration The command specifies the preferred frequency bands to be searched of UE. If is omitted, the configuration will take effect immediately. AT+QCFG='band' Band Configuration Write Command AT+QCFG='band'[,,,[,]] Response If configuration parameters are omitted (that is, only execute AT+QCFG='band'), return current configuration: +QCFG: 'band',,, OK EP06&EG06&EM06_AT_Commands_Manual 42 / 240 Maximum Response Time LTE-A Module Series EP06&EG06&EM06 AT Commands Manual If configuration parameters are all entered, configure the preferred frequency bands to be searched: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A hexadecimal value that specifies the WCDMA frequency band. If set to 0, it means not to change the WCDMA frequency band. 00000000 No change 00000010 WCDMA 2100 00000020 WCDMA 1900 00000040 WCDMA 850 00000080 WCDMA 900 00000100 WCDMA 800 00000200 WCDMA 1700 00000800 WCDMA 1800 00001000 WCDMA Japan 850 0000FFFF Any frequency band A hexadecimal value that specifies the LTE frequency band. If it is set to 0 or 0x40000000, it means not to change LTE frequency band. (eg.: 0x15=0x1(LTE B1)+0x4(LTE B3)+0x10(LTE B5)) 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x40 (CM_BAND_PREF_LTE_EUTRAN_BAND7) LTE B7 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 0x80000(CM_BAND_PREF_LTE_EUTRAN_BAND20) LTE B20 0x7FFFFFFFFFFFFFFF(CM_BAND_PREF_ANY) Any frequency band When to take effect 0 Take effect after UE reboots 1 Take effect immediately EP06&EG06&EM06_AT_Commands_Manual 43 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4.3.6.AT+QCFG='hsdpacat' HSDPA Category Configuration The command specifies the HSDPA category. This configuration is valid only after the module is restarted. AT+QCFG='hsdpacat' HSDPA Category Configuration Write Command AT+QCFG='hsdpacat'[,] Response If is omitted, return the current configuration: +QCFG: 'hsdpacat', OK If is not omitted, configure the HSDPA category: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter HSDPA category 6 Category 6 8 Category 8 10 Category 10 12 Category 12 14 Category 14 18 Category 18 20 Category 20 24 Category 24 4.3.7.AT+QCFG='hsupacat' HSUPA Category Configuration The command specifies the HSUPA category. This configuration is valid only after the module is restarted. AT+QCFG='hsupacat' HSUPA Category Configuration Write Command AT+QCFG='hsupacat'[,] Response If is omitted, return the current configuration: +QCFG: 'hsupacat', OK EP06&EG06&EM06_AT_Commands_Manual 44 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time If is not omitted, configure the HSUPA category: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300ms Parameter HSUPA category 5 Category 5 6 Category 6 4.3.8.AT+QCFG='rrc' RRC Release Version Configuration The command specifies the RRC release version. This configuration is valid only after the module is restarted. AT+QCFG='rrc' RRC Release Version Configuration Write Command AT+QCFG='rrc'[,] Response If is omitted, return the current configuration: +QCFG: 'rrc', OK If is not omitted, configure the RRC release version: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter RRC release version 0 R99 EP06&EG06&EM06_AT_Commands_Manual 45 / 240 1 R5 2 R6 3 R7 4 R8 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4.3.9.AT+QCFG='sgsn' UE SGSN Release Version Configuration The command specifies the UE SGSN release version. This configuration is valid only after the module is restarted. AT+QCFG='sgsn' UE SGSN Release Version Configuration Write Command AT+QCFG='sgsn'[,] Response If is omitted, return the current configuration: +QCFG: 'sgsn', OK If is not omitted, configure the SGSN release version: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter SGSN release version 0 R97 1 R99 2 Dynamic 4.3.10. AT+QCFG='msc' UE MSC Release Version Configuration The command specifies the UE MSC release version. This configuration is valid only after the module is restarted. EP06&EG06&EM06_AT_Commands_Manual 46 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+QCFG='msc' UE MSC Release Version Configuration Write Command AT+QCFG='msc'[,] Response If is omitted, return the current configuration: +QCFG: 'msc', OK If is not omitted, configure the MSC release version: OK Or ERROR Maximum Response Time If there is an error related to ME functionality: +CME ERROR: 300ms Parameter MSC release version 0 R97 1 R99 2 Dynamic 4.3.11. AT+QCFG='pdp/duplicatechk' Establish Multi PDNs with the Same APN The command allows/refuses establishing multi PDNs with the same APN profile. The configuration will take effect immediately. AT+QCFG='PDP/duplicatechk' Establish Multi PDNs with the Same APN Write Command AT+QCFG='pdp/duplicatechk'[,] Response If is omitted, return the current configuration: +QCFG: 'pdp/duplicatechk', OK If is not omitted, allow/refuse establishing multiple PDNs with the same APN profile: OK Or ERROR EP06&EG06&EM06_AT_Commands_Manual 47 / 240 Maximum Response Time LTE-A Module Series EP06&EG06&EM06 AT Commands Manual If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 Refused to establish multi PDNs with the same APN profile Allowed to establish multi PDNs with the same APN profile 4.3.12. AT+QCFG='urc/ri/ring' RI Behavior when RING URC is Presented AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other' control the RI (ring indicator) behavior when a URC is reported. These configurations will be stored into NV automatically. The ring indicator is active low. AT+QCFG='urc/ri/ring' specifies the RI behavior when URC RING is presented to indicate an incoming call. The sum of parameter and determines the interval time of RING indications when a call is coming. AT+QCFG='urc/ri/ring' RI Behavior when RING URC is Presented Write Command AT+QCFG='urc/ri/ring'[,[,[,[,[,]]]]] Response If , , , and are omitted, return the current configuration: +QCFG: 'urc/ri/ring',,,, ,, OK If all configuration parameters are entered, set the RI behavior when RING URC is presented: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms EP06&EG06&EM06_AT_Commands_Manual 48 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter RI behavior when URCs are presented 'off' No change. Ring indicator keeps inactive. 'pulse' Pulse. Pulse width determined by . 'always' Change to active. RI behavior can be restored to inactive by AT+QRIR. 'auto' When RING is presented to indicate an incoming call, the ring indicator changes to and keeps active. When ring of the incoming call ends, either answering or hanging up the incoming call, the ring indicator will change to inactive. 'wave' When RING is presented to indicate an incoming call. The ring indicator outputs a square wave. Both and are used to set parameters of the square wave. When the ring of incoming call ends, either answering or hanging up the incoming call, the ring indicator will change to inactive. Set the width of pulse. Value ranges from 1 to 2000ms and the default is 120ms. This parameter is only meaningful when is 'pulse'. If this parameter is not needed, you can set it as null. Set the active duration of the square wave, value ranges from 1ms to 10000ms, and the default is 1000ms.This parameter is only meaningful when is 'wave'. The inactive duration of the square wave, value ranges from 1ms to 10000ms, and the default is 5000ms. This parameter is only meaningful when is 'wave'. Set whether the ring indicator behavior could be disturbed. This parameter is only meaningful when is configured to 'auto' or 'wave'. For example, when is configured to 'wave', if the square wave need not to be disturbed by other URCs (including SMS related URCs), then should be set to 'on'. 'off' RI behavior can be disturbed by other URCs when the behavior is caused by an incoming call ringing. 'on' RI behavior cannot be disturbed by other URCs when the behavior is caused by an incoming call ringing. The count of pulse. This parameter is only meaningful when is 'pulse'. The value ranges from 1 to 5 and the default is 1. The interval time between two pulses is equal to . EP06&EG06&EM06_AT_Commands_Manual 49 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4.3.13. AT+QCFG='urc/ri/smsincoming' RI Behavior when Incoming SMS URCs are Presented The command specifies the RI (ring indicator) behavior when related incoming message URCs are presented. Related incoming message URCs list: +CMTI, +CMT, +CDS and +CBM. AT+QCFG='urc/ri/smsincoming' Presented Write Command AT+QCFG='urc/ri/smsincoming'[,[,]] RI Behavior when Incoming SMS URCs are Response If and are omitted, return the current configuration: +QCFG: 'urc/ri/smsincoming',,, OK If and are not omitted, set the RI behavior when incoming SMS URCs are presented: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter RI behavior when URCs are presented 'off' No change. Ring indicator keeps inactive. 'pulse' Pulse. Pulse width determined by . 'always' Change to active. RI behavior can be restored to inactive by AT+QRIR. The width of pulse. The value ranges from 1ms to 2000ms and the default is 120ms. This parameter is only valid when is 'pulse'. The count of pulse. This parameter is only meaningful when is 'pulse'. Value ranges from 1 to 5 and the default is 1. The interval time between two pulses is equal to . EP06&EG06&EM06_AT_Commands_Manual 50 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4.3.14. AT+QCFG='urc/ri/other' RI Behavior when Other URCs are Presented The command specifies the RI (ring indicator) behavior when other URCs are presented. AT+QCFG='urc/ri/other' RI Behavior when Other URCs are Presented Write Command AT+QCFG='urc/ri/other'[,[,]] Response If and are omitted, return the current configuration: +QCFG: 'urc/ri/other',,, OK If and are not omitted, set the RI behavior when other URCs are presented: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter RI behavior when URCs are presented 'off' No change. Ring indicator keeps inactive. 'pulse' Pulse. Pulse width determined by . The width of pulse. The value ranges from 1ms to 2000ms and the default is 120ms. This parameter is valid only when is 'pulse'. The count of pulse. This parameter is only meaningful when is 'pulse'. Value ranges from 1 to 5 and the default is 1. The interval time between two pulses is equal to . 4.3.15. AT+QCFG='risignaltype' RI Signal Output Carrier The command specifies the RI (ring indicator) signal output carrier. AT+QCFG='risignaltype' RI Signal Output Carrier Write Command AT+QCFG='risignaltype',[] Response If is omitted, return the current configuration: +QCFG: 'risignaltype', EP06&EG06&EM06_AT_Commands_Manual 51 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time OK If is not omitted, configure the RI signal output carrier: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300ms Parameter RI signal output carrier. 'respective' The ring indicator behaves on the port where URC is presented. For example, if a URC is presented on UART port, it is physical ring indicator. If URC is presented on USB port, it is virtual ring indicator. If URC is presented on USB AT port, and the port does not support ring indicator, then there will be no ring indicator. AT+QURCCFG='urcport' can get the port on which URC is presented. 'physical' No matter which port URC is presented on, URC only causes the behavior of physical ring indicator. 4.3.16. AT+QCFG='urc/delay' Delay URC Indication The command can delay the output of URC indication until ring indicator pulse ends. AT+QCFG='urc/delay' Delay URC Indication Write Command AT+QCFG='urc/delay'[,] Response If is omitted, return the current configuration: +QCFG: 'urc/delay', OK If is not omitted, set when the URC indication will be outputted: OK Or EP06&EG06&EM06_AT_Commands_Manual 52 / 240 Maximum Response Time LTE-A Module Series EP06&EG06&EM06 AT Commands Manual ERROR If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 URC indication will be output when ring indicator pulse starts. URC indication will be output when ring indicator pulse ends (only effective when the type of ring indicator is 'pulse'. Please refer to AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other' for more details). 4.3.17. AT+QCFG='urc/cache' URC Cache Function AT+QCFG='urc/cache' URC Cache Function Write Command AT+QCFG='urc/cache', Response If is omitted, return the current configuration: +QCFG: 'urc/cache', OK If is not omitted, enable/disable URC cache function: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 Disable URC cache 1 Enable URC cache EP06&EG06&EM06_AT_Commands_Manual 53 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual NOTE The settings of the command will take effect immediately and will not be saved after power off. Example AT+QCFG='urc/cache' +QCFG: 'urc/cache',0 //URC cache function is disabled OK AT+QCFG='urc/cache',1 OK AT+QCFG='urc/cache' +QCFG: 'urc/cache',1 //Enable URC cache OK //Make a call and send two messages to the module AT+QCFG='urc/cache',0 OK //Disable URC cache RING //Output cached URC NO CARRIER //Output cached URC +CMTI: 'ME',0 //Output cached URC +CMTI: 'ME',1 AT+QCFG='urc/cache' +QCFG: 'urc/cache',0 //Output cached URC //URC cache function is disabled OK 4.3.18. AT+QCFG='tone/incoming' Enable/Disable Ringing Tone The command enables or disables ringing tone. EP06&EG06&EM06_AT_Commands_Manual 54 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+ QCFG='tone/incoming' Enable/Disable Ringing Tone Write Command AT+QCFG='tone/incoming', Response If is omitted, return the current configuration: +QCFG: 'tone/incoming', OK If is not omitted, enable/disable ring tone function: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: Parameter 0 Disable ring tone 1 Enable local ring tone 2 Enable ring tone 4.4. AT+QINDCFG URC Indication Configuration The command is used to control URC indication. AT+QINDCFG URC Indication Configuration Test Command AT+QINDCFG=? Response +QINDCFG: 'all',(0,1),(0,1) +QINDCFG: 'csq',(0,1),(0,1) +QINDCFG: 'smsfull',(0,1),(0,1) +QINDCFG: 'ring',(0,1),(0,1) +QINDCFG: 'smsincoming',(0,1),(0,1) +QINDCFG: 'act',(0,1),(0,1) Write Command AT+QINDCFG=[,[,< savetonvram>]] OK Response If and are omitted, the current configuration will be returned: +QINDCFG: , EP06&EG06&EM06_AT_Commands_Manual 55 / 240 Maximum Response Time LTE-A Module Series EP06&EG06&EM06 AT Commands Manual OK If and are not omitted, set the URC indication configurations: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300ms Parameter URC type 'all' 'csq' 'smsfull' 'ring' 'smsincoming' 'act' Main switch of all URCs. Default is ON. Indication of signal strength and channel bit error rate change (similar to AT+CSQ). Default is OFF. If this configuration is ON, present: +QIND: 'csq',, SMS storage full indication. Default is OFF. If this configuration is ON, present: +QIND: 'smsfull', RING indication. Default is ON. Incoming message indication, Default is ON. Related URCs list: +CMTI, +CMT, +CDS Indication of network access technology change. Default is OFF. If this configuration is ON, present: +QIND: 'act', is string format. The values are as below: 'WCDMA' 'HSDPA' 'HSUPA' 'HSDPA&HSUPA' 'LTE' 'UNKNOWN' The examples of URC are as below: +QIND: 'act','HSDPA&HSUPA' +QIND: 'act','UNKNOWN' The description of 'act' is as below: 1. If module does not register on network, the would be 'UNKNOWN'. EP06&EG06&EM06_AT_Commands_Manual 56 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2. If this configuration is ON, the URC of 'act' will be reported immediately. Only when the network access technology changes, a new URC will be reported. URC indication is ON or OFF 0 OFF 1 ON Whether to save configuration into NV. Not saved by default. 0 Not save 1 Save EP06&EG06&EM06_AT_Commands_Manual 57 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 5 (U)SIM Related Commands 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) The command requests the International Mobile Subscriber Identity (IMSI) which is intended to permit the TE to identify the individual SIM card or active application in the UICC (GSM or USIM) that is attached to MT. AT+CIMI Request International Mobile Subscriber Identity (IMSI) Test Command AT+CIMI=? Response OK Execution Command AT+CIMI Response TA returns for identifying the individual (U)SIM which is attached to ME. OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter International Mobile Subscriber Identity (string without double quotes) Example AT+CIMI 460023210226023 OK //Query IMSI number of (U)SIM which is attached to ME EP06&EG06&EM06_AT_Commands_Manual 58 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 5.2. AT+CLCK Facility Lock The command is used to lock, unlock or interrogate a MT or a network facility . It can be aborted when network facilities are being set or interrogated. The factory default password of PF, PN, PU, PP and PC lock is '12341234'. AT+CLCK Facility Lock Test Command AT+CLCK=? Response +CLCK: (list of supported s) Write Command AT+CLCK=,[,[ ,]] OK Response This command is used to lock, unlock or interrogate the ME or network facility . Password is normally needed to do such actions. When querying the status of network service (=2) the response line for ‘not active’ case (=0) should be returned only if service is not active for any . If is not equal to 2 and command is set successful: OK If =2 and the command is set successful: +CLCK: [,] […] OK Maximum Response Time 5s Reference 3GPP TS 27.007 Parameter 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' (U)SIM (lock SIM/UICC card installed in the currently selected card slot) (SIM/UICC asks password in MT power-up and when this lock command issued). BAOC (Bar All Outgoing Calls) (refer to 3GPP TS 22.088 clause 1). BOIC (Bar Outgoing International Calls) (refer to 3GPP TS 22.088 clause 1). BOIC-exHC (Bar Outgoing International Calls except to Home Country) (refer to 3GPP TS 22.088 clause 1). BAIC (Bar All Incoming Calls) (refer to 3GPP TS 22.088 clause 2). BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (refer to 3GPP TS 22.088 clause 2). EP06&EG06&EM06_AT_Commands_Manual 59 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 'AB' All Barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'AG' All outgoing barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'AC' All incoming barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'FD' SIM card or active application in the UICC (GSM or USIM) fixed dialing memory feature (if PIN2 authentication has not been done during the current session, PIN2 is required as ). 'PF' Lock Phone to the very first inserted SIM/UICC card (also referred in the present document as PH-FSIM) (MT asks password when other SIM/UICC cards are inserted). 'PN' Network Personalization (refer to 3GPP TS 22.022) 'PU' Network Subset Personalization (refer to 3GPP TS 22.022) 'PP' Service Provider Personalization (refer to 3GPP TS 22.022) 'PC' Corporate Personalization (refer to 3GPP TS 22.022) 0 Unlock 1 Lock 2 Query status Password 1 Voice 2 Data 4 FAX 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization 0 OFF 1 ON Example AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK //Query the status of (U)SIM card //The (U)SIM card is unlocked (OFF) //Lock (U)SIM card, and the password is 1234 //Query the status of (U)SIM card //The (U)SIM card is locked (ON) //Unlock (U)SIM card EP06&EG06&EM06_AT_Commands_Manual 60 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 5.3. AT+CPIN Enter PIN The command is used to enter a password or query whether or not the module requires a password which is necessary before it can be operated. The password may be (U)SIM PIN, (U)SIM PUK, PH-SIM PIN, etc. AT+CPIN Enter PIN Test Command AT+CPIN=? Read Command AT+CPIN? Response OK Response TA returns an alphanumeric string indicating whether or not some password is required. +CPIN: Write Command AT+CPIN=[,] OK Response TA stores a password, such as (U)SIM PIN, (U)SIM PUK, etc., which is necessary before it can be operated. If the PIN is to be entered twice, the TA shall automatically repeat the PIN. If no PIN request is pending, no action is taken and an error message +CME ERROR is returned to TE. Maximum Response Time Reference 3GPP TS 27.007 If the PIN required is (U)SIM PUK or (U)SIM PUK2, the second pin is required. This second pin, , is used to replace the old pin in the (U)SIM. OK 5s Parameter READY SIM PIN SIM PUK SIM PIN2 SIM PUK2 PH-NET PIN PH-NET PUK PH-NETSUB PIN MT is not pending for any password MT is waiting for (U)SIM PIN to be given MT is waiting for (U)SIM PUK to be given MT is waiting for (U)SIM PIN2 to be given MT is waiting for (U)SIM PUK2 to be given MT is waiting for network personalization password to be given MT is waiting for network personalization unblocking password to be given MT is waiting for network subset personalization password to be given EP06&EG06&EM06_AT_Commands_Manual 61 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual PH-NETSUB PUK MT is waiting for network subset personalization unblocking password to be given PH-SP PIN MT is waiting for service provider personalization password to be given PH-SP PUK MT is waiting for service provider personalization unblocking password to be given PH-CORP PIN MT is waiting for corporate personalization password to be given PH-CORP PUK MT is waiting for corporate personalization unblocking password to be given String type. Password. If the requested password was a PUK, such as (U)SIM PUK1, PH-FSIM PUK or another password, then must be followed by . String type. New password required if the requested code was a PUK. Example //Enter PIN AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Enter PUK and PIN AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Query PIN code is locked //Enter PIN //PIN has already been entered //Query PUK code is locked //Enter PUK and new PIN password //PUK has already been entered EP06&EG06&EM06_AT_Commands_Manual 62 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 5.4. AT+CPWD Change Password The command sets a new password for the facility lock function defined by AT+CLCK. AT+CPWD Change Password Test Command AT+CPWD=? Response TA returns a list of pairs which present the available facilities and the maximum length of their password. +CPWD: (list of supported s),(s) Write Command AT+CPWD=,, OK Response TA sets a new password for the facility lock function. OK Maximum Response Time 5s Reference 3GPP TS 27.007 Parameter 'SC' (U)SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command is issued) 'AO' BAOC (Bar All Outgoing Calls, refer to 3GPP TS 22.088 clause 1) 'OI' BOIC (Bar Outgoing International Calls, refer to 3GPP TS 22.088 clause 1) 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country, refer to 3GPP TS 22.088 clause 1) 'AI' BAIC (Bar All Incoming Calls, refer to 3GPP TS 22.088 clause 2) 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country, refer to 3GPP TS 22.088 clause 2) 'AB' All barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AG' All outgoing barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AC All incoming barring services (refer to 3GPP TS 22.030, applicable only for =0) 'P2' (U)SIM PIN2 Integer type. Maximum length of password Password specified for the facility from the user interface or with command. New password EP06&EG06&EM06_AT_Commands_Manual 63 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Example AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' OK //Change (U)SIM card password to '4321' //Restart module or re-activate the (U)SIM card AT+CPIN? +CPIN: SIM PIN //Query PIN code is locked OK AT+CPIN='4321' OK //PIN must be entered to define a new password '4321' +CPIN: READY 5.5. AT+CSIM Generic (U)SIM Access The command allows a direct control of the (U)SIM that is installed in the currently selected card slot by a distant application on the TE. The TE shall then keep the processing of (U)SIM information within the frame specified by GSM/UMTS. AT+CSIM Generic (U)SIM Access Test Command AT+CSIM=? Write Command AT+CSIM=, Response OK Response +CSIM: , OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms EP06&EG06&EM06_AT_Commands_Manual 64 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Integer type. Length of or string. Command transferred by the MT to the (U)SIM in the format as described in 3GPP TS 51.011. Response to the command transferred by the (U)SIM to the MT in the format as described in 3GPP TS 51.011. 5.6. AT+CRSM Restricted (U)SIM Access The command offers easy and limited access to the (U)SIM database. It transmits the (U)SIM command number and its required parameters to the MT. AT+CRSM Restricted (U)SIM Access Test Command AT+CRSM=? Write Command AT+CRSM=[,[,,,[,][,]]] Response OK Response +CRSM: ,[,] OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter (U)SIM command number 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS Integer type; identifier for an elementary data file on (U)SIM, if used by . EP06&EG06&EM06_AT_Commands_Manual 65 / 240 , , , LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Integer type; parameters transferred by the MT to the (U)SIM. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in 3GPP TS 51.011. Information which shall be written to the (U)SIM (hexadecimal character format; refer to AT+CSCS). The directory path of an elementary file on a SIM/UICC in hexadecimal format. Integer type; information from the (U)SIM about the execution of the actual command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command. Response of a successful completion of the command previously issued (hexadecimal character format; refer to AT+CSCS). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. The information includes the type of file and its size (refer to 3GPP TS 51.011). After READ BINARY, READ RECORD or RETRIEVE DATA command, the requested data will be returned. is not returned after a successful UPDATE BINARY, UPDATE RECORD or SET DATA command. 5.7. AT+QCCID Show ICCID The command returns the ICCID (Integrated Circuit Card Identifier) number of the (U)SIM card. AT+QCCID Show ICCID Test Command AT+QCCID=? Execution Command AT+QCCID Response OK Response +QCCID: Maximum Response Time OK Or ERROR 300ms Parameter ICCID (Integrated Circuit Card Identifier) number of the (U)SIM card EP06&EG06&EM06_AT_Commands_Manual 66 / 240 Example AT+QCCID +QCCID: 89860025128306012474 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Query ICCID of the (U)SIM card 5.8. AT+QPINC Display PIN Remainder Counter The command can query the number of attempts left to enter the password of (U)SIM PIN/PUK. AT+ QPINC Display PIN Remainder Counter Test Command AT+QPINC=? Response +QPINC: ('SC','P2') Read Command AT+QPINC? OK Response +QPINC: 'SC', , +QPINC: 'P2', , Write Command AT+QPINC= OK Response +QPINC: ,, OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 'SC' (U)SIM PIN 'P2' (U)SIM PIN2 Number of attempts left to enter the password of PIN Number of attempts left to enter the password of PUK EP06&EG06&EM06_AT_Commands_Manual 67 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 5.9. AT+QINISTAT Query Initialization Status of (U)SIM Card The command is used to query the initialization status of (U)SIM card. AT+QINISTAT Query Initialization Status of (U)SIM Card Test Command AT+QINISTAT=? Response +QINISTAT: (0-7) Execution Command AT+QINISTAT OK Response +QINISTAT: Maximum Response Time OK 300ms Parameter Initialization status of (U)SIM card. Actual value is the sum of several of the following four kinds (e.g. 7=1+2+4 means CPIN READY & SMS DONE & PB DONE). 0 Initial state 1 CPIN READY. Operation like lock/unlock PIN is allowed 2 SMS initialization completed 4 Phonebook initialization completed 5.10. AT+QSIMDET (U)SIM Card Detection The command enables (U)SIM card hot-swap function. (U)SIM card is detected by GPIO interrupt. The level of (U)SIM card detection pin should also be set when the (U)SIM card is inserted. AT+QSIMDET (U)SIM Card Detection Test Command AT+QSIMDET=? Response +QSIMDET: (0,1),(0,1) Read Command AT+QSIMDET? OK Response +QSIMDET: , Write Command OK Response EP06&EG06&EM06_AT_Commands_Manual 68 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+QSIMDET=, OK Or ERROR Maximum Response Time 300ms Parameter Enable or disable (U)SIM card detection 0 Disable 1 Enable The level of (U)SIM detection pin when a (U)SIM card is inserted 0 Low level 1 High level NOTES 1. Hot-swap function is invalid if the configured value of is inconsistent with hardware design. 2. Hot-swap function takes effect after the module is restarted. Example AT+QSIMDET=1,0 OK +CPIN: NOT READY +CPIN: READY //Set (U)SIM card detection pin level as low when (U)SIM card is inserted //If PIN1 of the (U)SIM card is unlocked 5.11. AT+QSIMSTAT (U)SIM Insertion Status Report The command queries (U)SIM card insertion status or determines whether (U)SIM card insertion status report is enabled. The configuration of this command can be saved by AT&W. EP06&EG06&EM06_AT_Commands_Manual 69 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+QSIMSTAT (U)SIM Insertion Status Report Test Command AT+QSIMSTAT=? Response +QSIMSTAT: (0,1) Read Command AT+QSIMSTAT? OK Response +QSIMSTAT: , Write Command AT+QSIMSTAT= Maximum Response Time OK Response OK Or ERROR 300ms Parameter Enable or disable (U)SIM inserted status report. If it is enabled, when (U)SIM card is removed or inserted, the URC +QSIMSTAT: , will be reported. 0 Disable 1 Enable (U)SIM card is inserted or removed. This argument is not allowed to be set. 0 Removed 1 Inserted 2 Unknown, before (U)SIM initialization Example AT+QSIMSTAT? +QSIMSTAT: 0,1 //Query (U)SIM card inserted status OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 //Enable (U)SIM card inserted status report OK EP06&EG06&EM06_AT_Commands_Manual 70 / 240 +QSIMSTAT : 1,0 +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK +QSIMSTAT : 1,1 +CPIN: READY LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Report of (U)SIM card inserted status, removed //Report of (U)SIM card inserted status, inserted EP06&EG06&EM06_AT_Commands_Manual 71 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 6 Network Service Commands 6.1. AT+COPS Operator Selection The command returns the current operators and their status, and allows setting automatic or manual network selection. AT+COPS Operator Selection Test Command AT+COPS=? Response TA returns a set of five parameters, each representing an operator presenting in the network. Any of the formats may be unavailable and should then be an empty field. The list of operators shall be in the order of: home network, networks referenced in (U)SIM and other networks. +COPS: (list of supported,long alphanumeric , short alphanumeric ,numeric s)[,]) s][,,(list of supported s),(list of supported s)] OK Read Command AT+COPS? If there is any error related to ME functionality: +CME ERROR: Response TA returns the current mode and the currently selected operator. If no operator is selected, , and are omitted. +COPS: [,[,][,]] OK Write Command AT+COPS=[,[,[,]]] If there is any error related to ME functionality: +CME ERROR: Response TA forces an attempt to select and register the GSM/UMTS network operator. If the selected operator is not available, no EP06&EG06&EM06_AT_Commands_Manual 72 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 other operator shall be selected (except =4). The format of selected operator name shall apply to further Read Commands (AT+COPS?). OK If there is any error related to ME functionality: +CME ERROR: 180s, determined by network. Parameter 0 Unknown 1 Operator available 2 Current operator 3 Operator forbidden Operator in format as per 0 Automatic mode. field is ignored 1 Manual operator selection. field shall be present and optionally 2 Manually deregister from network 3 Set only (for AT+COPS? Read Command), and do not attempt registration/deregistration ( and fields are ignored). This value is invalid in the response of Read Command. 4 Manual/automatic selection. field shall be presented. If manual selection fails, automatic mode (=0) is entered 0 Long format alphanumeric which can be up to 16 characters long 1 Short format alphanumeric 2 Numeric . GSM location area identification number Access technology selected. Values 3, 4, 5, 6 occur only in the response of Read Command while MS is in data service state and is not intended for the AT+COPS Write Command. 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN EP06&EG06&EM06_AT_Commands_Manual 73 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Example AT+COPS=? //List all current network operators +COPS: (1,'CHN-UNICOM','UNICOM','46001',2),(2,'CHN-UNICOM','UNICOM','46001',7),(3,'46011','460 11','46011',7),(3,'CHINA MOBILE','CMCC','46000',7),,(0-4),(0-2) OK AT+COPS? +COPS: 0,0,'CHN-UNICOM',7 //Query the currently selected network operator OK 6.2. AT+CREG Network Registration Status The Read Command returns the network registration status. The Write Command sets whether or not to present URC. AT+CREG Network Registration Status Test Command AT+CREG=? Response +CREG: (list of supported s) Read Command AT+CREG? OK Response TA returns the status of result code presentation and an integer which shows whether the network has currently indicated the registration of the ME. Location information elements and are returned only when =2 and ME is registered on the network. +CREG: ,[,,[,]] OK Write Command AT+CREG[=] Maximum Response Time If there is any error related to ME functionality: +CME ERROR: Response TA controls the presentation of an unsolicited result code +CREG: when =1 and there is a change in the ME network registration status. OK 300ms EP06&EG06&EM06_AT_Commands_Manual 74 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Reference 3GPP TS 27.007 Parameter 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code: +CREG: 2 Enable network registration unsolicited result code with location information: +CREG: [,,[,]] 0 Not registered. ME is not currently searching a new operator to register to 1 Registered, home network 2 Not registered, but ME is currently searching a new operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two bytes location area code in hexadecimal format String type. 28-bit (UMTS/LTE) cell ID in hexadecimal format Access technology selected 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN Example AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'D509','80D413D',7 //URC reports that ME has registered on network //Activate extended URC mode //URC reports that operator has found location area code and cell ID EP06&EG06&EM06_AT_Commands_Manual 75 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 6.3. AT+CSQ Signal Quality Report The command indicates the received signal strength and the channel bit error rate . AT+CSQ Signal Quality Report Test Command AT+CSQ=? Response The Test Command returns values supported by the TA. +CSQ: (list of supported s),(list of supported s) Execution Command AT+CSQ OK Response The Execution Command returns received signal strength indication and channel bit error rate from the ME. +CSQ: , OK Maximum Response Time Reference 3GPP TS 27.007 If there is error related to ME functionality: +CME ERROR: 300ms Parameter 0 -113dBm or less 1 -111dBm 2...30 -109dBm... -53dBm 31 -51dBm or greater 99 Not known or not detectable Channel bit error rate (in percent) 0...7 As RXQUAL values in the table in 3GPP TS 45.008 subclause 8.2.4 99 Not known or not detectable Example AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ EP06&EG06&EM06_AT_Commands_Manual 76 / 240 +CSQ: 28,99 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //The current signal strength indication is 28 and channel bit error rate is 99 NOTE After using network related commands such as AT+CCWA and AT+CCFC, it is recommended to wait for 3s before entering AT+CSQ so as to ensure that any network access required for the preceding command has been finished. 6.4. AT+CPOL Preferred Operator List The command edits and queries the list of preferred operators. AT+CPOL Preferred Operator List Test Command AT+CPOL=? Response +CPOL: (list of supported s),(list of supported s) Read Command AT+CPOL? OK Response Query the list of preferred operators: +CPOL: ,,[,,<GSM_compact,,] … Write Command AT+CPOL=[,[, [,,, ]]] OK Response Edit the list of preferred operators: OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If the is given but the is left out, the entry is deleted. 300ms EP06&EG06&EM06_AT_Commands_Manual 77 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Integer type; the order number of operator in the (U)SIM preferred operator list 0 Long format alphanumeric 1 Short format alphanumeric 2 Numeric String type; indicates the format is alphanumeric or numeric (see AT+COPS) GSM access technology 0 Access technology is not selected 1 Access technology is selected GSM compact access technology 0 Access technology is not selected 1 Access technology is selected UTRAN access technology 0 Access technology is not selected 1 Access technology is selected E-UTRAN access technology 0 Access technology is not selected 1 Access technology is selected NOTE The access technology selection parameters , , and are required for (U)SIM cards or UICC’s containing PLMN selector with access technology. 6.5. AT+COPN Read Operator Names The command returns the list of operator names from the ME. Each operator code that has an alphanumeric equivalent in the ME memory is returned. AT+COPN Read Operator Names Test Command AT+COPN=? Execution Command AT+COPN Response OK Response +COPN: , […] OK If there is error related to ME functionality: +CME ERROR: EP06&EG06&EM06_AT_Commands_Manual 78 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 Depends on the number of operator names. Parameter String type; operator in numeric format (see AT+COPS) String type; operator in long alphanumeric format (see AT+COPS) 6.6. AT+CTZU Automatic Time Zone Update The Write Command enables and disables automatic time zone update via NITZ. The configuration is stored to NV automatically. AT+CTZU Automatic Time Zone Update Test Command AT+CTZU=? Response +CTZU: (0,1) Write Command AT+CTZU= Read Command AT+CTZU? OK Response OK Or ERROR Response +CTZU: Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter Integer type, indicates the mode of automatic time zone update 0 Disable automatic time zone update via NITZ. 1 Enable automatic time zone update via NITZ EP06&EG06&EM06_AT_Commands_Manual 79 / 240 Example AT+CTZU? +CTZU: 0 OK AT+CTZU=? +CTZU: (0,1) OK AT+CTZU=1 OK AT+CTZU? +CTZU: 1 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 6.7. AT+CTZR Time Zone Reporting The command controls the time zone reporting of changed event. If reporting is enabled, the MT returns the unsolicited result code +CTZV: or +CTZE: ,, whenever the time zone is changed. The configuration is stored to NV automatically. AT+CTZR Time Zone Reporting Test Command AT+CTZR=? Response +CTZR: (0-2) Write Command AT+CTZR= Read Command AT+CTZR? OK Response OK Or ERROR Response +CTZR: Maximum Response Time Reference 3GPP TS 27.007 OK 300ms EP06&EG06&EM06_AT_Commands_Manual 80 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Integer type, indicates the mode of time zone reporting 0 Disable time zone reporting of changed event 1 Enable time zone reporting of changed event by unsolicited result code +CTZV: 2 Enable extended time zone reporting by unsolicited result code +CTZE: ,, String type, represents the sum of the local time zone (difference between the local time and GMT is expressed in quarters of an hour) plus daylight saving time. The format is '±zz', expressed as a fixed width, two-digit integer with the range -48 ... +56. To maintain a fixed width, numbers in the range -9 ... +9 are expressed with a leading zero, e.g. '-09', '+00' and '+09'. Integer type, indicates whether includes daylight savings adjustment 0 includes no adjustment for Daylight Saving Time 1 includes +1 hour (equals 4 quarters in ) adjustment for daylight saving time 2 includes +2 hours (equals 8 quarters in ) adjustment for daylight saving time String type, represents the local time. The format is 'YYYY/MM/DD,hh:mm:ss', expressed as integers representing year (YYYY), month (MM), date (DD), hour (hh), minute (mm) and second (ss). This parameter can be provided by the network when delivering time zone information and will be presented in the unsolicited result code of extended time zone reporting if provided by the network. Example AT+CTZR=2 OK AT+CTZR? +CTZR: 2 OK +CTZE: '+32',0,'2018/03/23,06:51:13' // is 2 EP06&EG06&EM06_AT_Commands_Manual 81 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 6.8. AT+QLTS Obtain the Latest Time Synchronized through Network The command is used to obtain the latest time synchronized through network. AT+QLTS Obtain the Latest Time Synchronized through Network Test Command AT+QLTS=? Execution Command AT+QLTS Response +QLTS: list of supported s OK Response The Execution Command returns the latest time that has been synchronized through network: +QLTS: , Write Command AT+QLTS= OK Response +QLTS: , OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Query network time mode 0 Query the latest time that has been synchronized through network 1 Query the current GMT time calculated from the latest time that has been synchronized through network 2 Query the current LOCAL time calculated from the latest time that has been synchronized through network String type value. Format is 'yy/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range -48...+48). E.g. 6th of May 2004, 22:10:00 GMT+2 hours equals '04/05/06,22:10:00+08' Daylight saving time. EP06&EG06&EM06_AT_Commands_Manual 82 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual NOTE If the time has not been synchronized through network, the command will return a null time string: +QLTS: ''. Example AT+QLTS=? +QLTS: (0-2) //Query supported network time modes OK AT+QLTS //Query the latest time synchronized through network +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=0 //Query the latest time synchronized through network. It offers the same function as Execution Command AT+QLTS. +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=1 //Query the current GMT time calculated from the latest time that has been synchronized through network +QLTS: '2017/01/13,03:41:22+32,0' OK AT+QLTS=2 //Query the current LOCAL time calculated from the latest time that has been synchronized through network +QLTS: '2017/01/13,11:41:23+32,0' OK 6.9. AT+QNWINFO Query Network Information The command indicates network information such as access technology selected, the operator and the band selected. AT+QNWINFO Query Network Information Test Command AT+QNWINFO=? Execution Command AT+QNWINFO Response OK Response +QNWINFO: ,,, EP06&EG06&EM06_AT_Commands_Manual 83 / 240 Maximum Response Time LTE-A Module Series EP06&EG06&EM06 AT Commands Manual OK 300ms Parameter String type; access technology selected 'NONE' 'WCDMA' 'HSDPA' 'HSUPA' 'HSPA+' 'TDD LTE' 'FDD LTE' String type; operator in numeric format String type; band selected 'WCDMA 2100' 'WCDMA 1900' 'WCDMA 1800' 'WCDMA 1700 US' 'WCDMA 850' 'WCDMA 800' 'WCDMA 2600' 'WCDMA 900' 'WCDMA 1700 JAPAN' 'WCDMA 1500' 'WCDMA 850 JAPAN' 'LTE BAND 1' – 'LTE BAND 43' Integer type; channel ID NOTE If the devices have not been registered network, the command will return +QNWINFO: No Service. Example AT+QNWINFO=? OK AT+QNWINFO +QNWINFO: 'FDD LTE',46001,'LTE BAND 3',1650 OK EP06&EG06&EM06_AT_Commands_Manual 84 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 6.10. AT+QSPN Query the Service Provider Name The command is used to query the service provider name. AT+QSPN Query the Service Provider Name Test Command AT+QSPN=? Execution Command AT+QSPN Response OK Response +QSPN: ,,,, OK Reference Parameter Full name of network Shortened name of network Service provider name Alphabet of full and shortened network name 0 GSM 7-bit default alphabet 1 UCS2 Registered PLMN NOTES 1. If is 0, and will be shown in GSM 7-bit default alphabet string. 2. If is 1, and will be shown in UCS2 hexadecimal string. Example AT+QSPN //Query the EONS information of RPLMN +QSPN: 'CHN-UNICOM','UNICOM','',0,'46001' OK EP06&EG06&EM06_AT_Commands_Manual 85 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 6.11. AT+QENG Query Network Information The command is used to obtain the network information. AT+QENG Query Network Information Test Command AT+QENG=? Response +QENG: (list of supported s) Query the information of serving cell AT+QENG='servingcell' OK Response In LTE mode: +QENG: 'servingcell',,'LTE',,,,,,,,,,,,,,, In WCDMA mode: +QENG: 'servingcell',,'WCDMA',,, ,,,,,,,,,,, Query the information of neighbour cells AT+QENG='neighbourcell' OK Response In LTE mode: [+QENG: 'neighbourcell intra','LTE',,,,,,,,, ,,… [+QENG: 'neighbourcell inter','LTE',,,,,,,,, , … [+QENG:'neighbourcell','WCDMA',,,,,,< ecno>, … In WCDMA mode: [+QENG:'neighbourcell','WCDMA',,, ,,,,, … [+QENG: 'neighbourcell','LTE',,,,, … OK Parameter String format. The information of different cells. 'servingcell' The information of 3G/4G serving cells 'neighbourcell' The information of 3G/4G neighbour cells String format. UE state. 'SEARCH' UE is searching but could not (yet) find a suitable 3G/4G cell. 'LIMSRV' UE is camping on a cell but has not registered on the network. 'NOCONN' UE is camping on a cell and has registered on the network, and it is in idle mode. 'CONNECT' UE is camping on a cell and has registered on the network, and a call is in progress. LTE TDD or FDD mode Number format. Mobile Country Code (first part of the PLMN code) '-' Invalid Number format. Mobile Network Code (second part of the PLMN code) '-' Invalid Hexadecimal format. Location Area Code. The parameter determines the two bytes location area code in hexadecimal format (e.g. 00C1 equals 193 in decimal) of the cell that was scanned. Range: 0-65535 '-' Cannot get the invalid value Hexadecimal format. Cell ID. The parameter determines the 16-bit (GSM) or 28-bit (UMTS) cell ID. Range: 0-0xFFFFFFF. '-' Invalid Physical cell ID Number format. The parameter determines the UTRA-ARFCN of the cell that was scanned Number format. The parameter determines the E-UTRA-ARFCN of the cell that was scanned E-UTRA frequency band (see 3GPP 36.101) Number format. UL bandwidth 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz 4 15MHz 5 20MHz EP06&EG06&EM06_AT_Commands_Manual 87 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Number format. DL bandwidth 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz 4 15MHz 5 20MHz Tracking Area Code (see 3GPP 23.003 Section 19.4.2.3) Number format. The parameter determines the primary scrambling code of the cell that was scanned Number format. Routing Area Code. Range 0-255. Number format. The parameter determines the Received Signal Code Power level of the cell that was scanned Number format. Carrier to noise ratio in dB=measured Ec/Io value in dB. Reference Signal Received Power (see 3GPP 36.214 Section 5.1.1) Reference Signal Received Quality (see 3GPP 36.214 Section 5.1.2) Number format. The parameter shows the Received Signal Strength Indication Number format. Logarithmic value of SINR, Values are in 1/5th of a dB. Range: 0-250 which translates to -20dB - +30dB. Physical channel 0 DPCH 1 FDPCH Number format. Spreading factor. 0 SF_4 1 SF_8 2 SF_16 3 SF_32 4 SF_64 5 SF_128 6 SF_256 7 SF_512 8 UNKNOWN Number format. (0-16): slot format for DPCH. (0-9): slot format for FDPCH Destination number on which call is to be deflected Number format. Compress mode 0 Not support compress mode 1 Support compress mode Receiver automatic gain control on the camped frequency. Number format. Carrier to noise ratio in dB = measured Ec/Io value in dB. Number format. 3G neighbour cell set 1 Active set 2 Synchronous neighbour set 3 Asynchronous neighbour set Rank of this cell as neighbour for inter-RAT cell reselection EP06&EG06&EM06_AT_Commands_Manual 88 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Suitable receive level for inter frequency cell To be considered for reselection. The suitable receive level value of an evaluated lower priority cell must be greater than this value. To be considered for reselection. The suitable receive level value of an evaluated higher priority cell must be greater than this value. Reselection threshold for high priority layers. Reselection threshold for low priority layers. Absolute power level of the common pilot channel as received by the UE in dBm x10. Ratio of the received energy per PN chip for the common pilot channel to the total received power spectral density at the UE antenna connector in dB x10. Number format. Select receive level value for base station in dB (see 3GPP 25.304). Cell reselection priority. Range: 0-7. Threshold to control non-intra frequency searches. Specifies the suitable receive level threshold (in dB) used by the UE on the serving cell when reselecting towards a lower priority RAT/frequency. Cell selection parameter for the intra frequency cell. NOTE '-' or - indicates the parameter is invalid under current condition. Example AT +QENG='neighbourcell' +QENG: 'servingcell','LIMSRV','LTE','FDD',460,11,6935932,30,1825,3,4,4,6934,-115,-13,-83,13,0 OK AT +QENG='neighbourcell' +QENG: 'neighbourcell intra','LTE',38950,276,-3,-88,-65,0,37,7,16,6,44 +QENG: 'neighbourcell inter','LTE',39148,-,-,-,-,-,37,0,30,7,-,-,-,+QENG: 'neighbourcell inter','LTE',37900,-,-,-,-,-,0,0,30,6,-,-,-,- OK EP06&EG06&EM06_AT_Commands_Manual 89 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 6.12. AT+QCAINFO Query Carrier Aggregation Parameters The command is used to query carrier aggregation parameters. AT+QCAINFO Query Carrier Aggregation Parameters Test Command AT+QCAINFO=? Execution Command AT+QCAINFO Response OK Response +QCAINFO: 'PCC',,,,,, ,,, 'SCC',,,,,, ,,, OK Reference If no second cell was active: OK Parameter Primary carrier component Secondary carrier component EARFCN Bandwidth 6 1.4MHZ 15 3MHZ 25 5MHZ 50 10MHZ 75 15MHZ 100 20MHZ Band information. Primary cell state 0 No serving 1 Registered Secondary cell state 0 Deconfigured 1 Configured deactivated 2 Configured activated Physical Cell ID Reference Signal Received Power (see 3GPP 36.214 Section 5.1.1.) Reference Signal Received Quality (see 3GPP 36.214 Section 5.1.2.) EP06&EG06&EM06_AT_Commands_Manual 90 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Number format. The parameter shows the Received Signal Strength Indication Number format. Logarithmic value of SINR. Values are in 1/5th of a dB. Range: 0-250, which translates to -20dB -+30dB. EP06&EG06&EM06_AT_Commands_Manual 91 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 7 Call Related Commands 7.1. ATA Answer an Incoming Call The command connects the module to an incoming voice or data call indicated by a RING URC. ATA Answer an Incoming Call Execution Command ATA Response TA sends off-hook to the remote station. Response in case of data call, if successfully connected CONNECT And TA switches to data mode. Note: outputs only when is greater than 0 in ATX parameter setting. When TA returns to command mode after call release: OK Response in case of voice call, if successfully connected: OK Maximum Response Time Reference V.25ter Response if no connection: NO CARRIER 90s, determined by network. NOTES 1. Any additional commands on the same command line are ignored. 2. This command may be aborted generally by receiving a character during execution. The aborting is not possible during some states of connection establishment such as handshaking. 3. See also ATX. EP06&EG06&EM06_AT_Commands_Manual 92 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Example RING AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,1,4,0,0,'02154450290',129 OK ATA OK //A voice call is ringing //PS call in LTE mode //Incoming call //Accept the voice call with ATA 7.2. ATD Mobile Originated Call to Dial a Number The command can be used to set up outgoing voice and data calls. Supplementary services can also be controlled with this command. ATD Mobile Originated Call to Dial a Number Execution Command ATD[][;] Response This command can be used to set up outgoing voice, data or fax calls. It also serves to control supplementary services. If no dial tone and (parameter setting ATX2 or ATX4): NO DIALTONE If busy and (parameter setting ATX3 or ATX4): BUSY If a connection cannot be established: NO CARRIER If connection is successful and there is a non-voice call: CONNECT And TA switches to data mode. Note: outputs only when is greater than 0 in ATX parameter setting. When TA returns to command mode after call release: OK Maximum Response Time If connection is successful and there is a voice call: OK 5s, determined by network (AT+COLP=0). EP06&EG06&EM06_AT_Commands_Manual 93 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Reference V.25ter Parameter String of dialing digits and optionally V.25ter modifiers Dialing digits: 0-9, *, #, +, A, B, C Following V.25ter modifiers are ignored: ,(comma), T, P, !, W, @ String of GSM modifiers: I Actives CLIR (Disable presentation of own number to the called party) i Deactivates CLIR (Enable presentation of own number to the called party) G Activates closed user group invocation for this call only g Deactivates closed user group invocation for this call only Only required to set up voice call, return to command state NOTES 1. This command may be aborted generally by receiving an ATH command or a character during execution. The aborting is not possible during some states of connection establishment such as handshaking. 2. Parameter 'I' and 'i' only if no '*' or '#' code is within the dial string. 3. See ATX command for setting result code and call monitoring parameters. 4. Responses returned after dialing with ATD: For voice call, two different responses mode can be determined. TA returns OK immediately either after dialing was completed or after the call was established. The setting is controlled by AT+COLP. Factory default is AT+COLP=0, which causes the TA to return OK immediately after dialing was completed. Otherwise TA will return OK, BUSY, NO DIAL TONE, or NO CARRIER. 5. Using ATD during an active voice call: ⚫ When a user originates a second voice call while there is already an active voice call, the first call will be automatically put on hold. ⚫ The current states of all calls can be easily checked at any time by using AT+CLCC command. Example ATD10086; OK //Dialing out the party’s number EP06&EG06&EM06_AT_Commands_Manual 94 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 7.3. ATH Disconnect Existing Connection The command disconnects circuit switched data calls or voice calls. AT+CHUP is also used to disconnect the voice call. ATH Disconnect Existing Connection Execution Command ATH[n] Response Disconnect existing call by local TE from command line and terminate the call. OK Maximum Response Time 90s, determined by network. Reference V.25ter Parameter 0 Disconnect existing call from command line and terminate the call 7.4. AT+CVHU Voice Hang up Control The command controls whether ATH can be used to disconnect the voice call. AT+CVHU Voice Hang up Control Test Command AT+CVHU=? Response +CVHU: (list of supported s) Read Command AT+CVHU? OK Response +CVHU: Write Command AT+CVHU= Maximum Response Time Reference 3GPP TS 27.007 OK Response OK Or ERROR 300ms EP06&EG06&EM06_AT_Commands_Manual 95 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter 0 ATH can be used to disconnect the voice call 1 ATH is ignored but OK response is returned 7.5. AT+CHUP Hang up Calls The command cancels all voice calls in the state of Active, Waiting and Held. For data connections, use ATH. AT+CHUP Hang up Calls Test Command AT+CHUP=? Execution Command AT+CHUP Maximum Response Time Reference 3GPP 27.007 Response OK Response OK Or ERROR 90s, determined by network. Example RING AT+CHUP OK //Incoming call //Hang up the call 7.6. +++ Switch from Data Mode to Command Mode The +++ character sequence causes the module to switch from data mode to AT command mode. It allows inputting AT commands while maintaining the data connection with the remote device. +++ Switch from Data Mode to Command Mode Execution Command +++ Response This command is only available when TA is in data mode. The '+++' character sequence causes the TA to cancel the data flow over the AT interface and switch to command mode. This allows entering AT command while maintaining the data EP06&EG06&EM06_AT_Commands_Manual 96 / 240 Maximum Response Time Reference V.25ter LTE-A Module Series EP06&EG06&EM06 AT Commands Manual connection with the remote server or, accordingly, the GPRS connection. OK 300ms NOTES 1. To prevent the +++ escape sequence from being misinterpreted as data, the following sequence should be followed: ⚫ Do not input any character within 1s before inputting +++. ⚫ Input +++ within 1s, and no other characters can be inputted during the time. ⚫ Do not input any character within 1s after +++ has been inputted. ⚫ Switch to command mode successfully; otherwise return to step 1. 2. To return back to data mode from command mode, please enter ATO. 3. Another way to change to command mode is through DTR level change, and please refer to AT&D command for details. 7.7. ATO Switch from Command Mode to Data Mode The command resumes the connection and switches back from command mode to data mode. ATO Switch from Command Mode to Data Mode Execution Command ATO[n] Response TA resumes the connection and switches back to data mode from command mode. If connection is not successfully resumed: NO CARRIER Maximum Response Time Reference V.25ter If connection is successfully resumed, TA returns to data mode from command mode CONNECT 300ms EP06&EG06&EM06_AT_Commands_Manual 97 / 240 Parameter 0 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Switch from command mode to data mode NOTE When TA returns to data mode from command mode successfully, CONNECT is returned. Please note that outputs only when is greater than 0 in ATX parameter setting. 7.8. ATS0 Set Number of Rings before Automatically Answering Call The command controls automatic answering mode for the incoming calls. ATS0 Set Number of Rings before Automatically Answering Call Read Command ATS0? Response Write Command ATS0= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the number of rings before auto-answer. OK 300ms Parameter 0 Automatic answering is disabled 1-255 Enable automatic answering on the ring number specified NOTE If is set too high, the calling party may hang up before the call is answered automatically. EP06&EG06&EM06_AT_Commands_Manual 98 / 240 Example ATS0=3 OK RING RING RING LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Set three rings before automatically answering a call //A call is coming //Automatically answering the call after three rings 7.9. ATS6 Set Pause before Blind Dialing The command is implemented for compatibility reasons only, and has no effect. ATS6 Set Pause before Blind Dialing Read Command ATS6? Response Write Command ATS6= Maximum Response Time Reference V.25ter OK Response OK 300ms Parameter 0-2-10 Number of seconds to wait before blind dialing 7.10. ATS7 Set Time to Wait for Connection Completion The command specifies the amount of time (unit: second) to wait for the connection completion in case of answering or originating a call. If no connection is established during the time, the module disconnects from the line. EP06&EG06&EM06_AT_Commands_Manual 99 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual ATS7 Set Time to Wait for Connection Completion Read Command ATS7? Response Write Command ATS7= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the amount of time (unit: second) to wait for the connection completion in case of answering or originating a call. OK 300ms Parameter 0 Disabled 1-255 Number of seconds to wait for connection completion 7.11. ATS8 Set the Time to Wait for Comma Dial Modifier The command is implemented for compatibility reasons only, and has no effect. ATS8 Set the Time to Wait for Comma Dial Modifier Read Command ATS8? Response Write Command ATS8= Maximum Response Time Reference V.25ter OK Response OK 300ms Parameter 0 1-2-255 No pause when comma encountered in dial string Number of seconds to wait for comma dial modifier EP06&EG06&EM06_AT_Commands_Manual 100 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 7.12. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier The command determines the amount of time (unit: tenths of a second) during which the UE remains connected in absence of a data carrier. ATS10 Set Disconnect Delay after Indicating the Absence of Data Carrier Read Command ATS10? Response Write Command ATS10= OK Response This parameter setting determines the amount of time (unit: tenths of a second) during which the TA will remain connected in absence of a data carrier. If the data carrier is once more detected before disconnection, the TA remains connected. Maximum Response Time Reference V.25ter OK 300ms Parameter 1-15-254 Number of tenths of seconds to wait before disconnecting after UE has indicated the absence of received line signal 7.13. AT+CSTA Select Type of Address The Write Command selects the type of number for further dialing commands ATD according to 3GPP Specifications. The Test Command returns values supported a compound value. AT+CSTA Select Type of Address Test Command AT+CSTA=? Response +CSTA: (list of supported s) Read Command OK Response EP06&EG06&EM06_AT_Commands_Manual 101 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CSTA? Write Command AT+CSTA= Maximum Response Time Reference 3GPP TS 27.007 +CSTA: OK Response OK 300ms Parameter Current address type setting. 129 Unknown type 145 International type (contains the character '+') 7.14. AT+CLCC List Current Calls of ME The execution command returns the list of all current calls. If the command is executed successfully, but no calls existed, then no information response but OK is sent to TE. AT+CLCC List Current Calls of ME Test Command AT+CLCC=? Execution Command AT+CLCC Response OK Response TA returns a list of current calls of ME. If the command is executed successfully, but no calls are existed, then no information but OK response is sent to TE. [+CLCC : ,,,,[,, [,]] ... OK Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms EP06&EG06&EM06_AT_Commands_Manual 102 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Integer type; call identification number as described in 3GPP TS 22.030 subclause 4.5.5.1; this number can be used in AT+CHLD command operations 0 Mobile originated (MO) call 1 Mobile terminated (MT) call State of the call 0 Active 1 Held 2 Dialing (MO call) 3 Alerting (MO call) 4 Incoming (MT call) 5 Waiting (MT call) Bearer/tele service 0 Voice 1 Data 2 FAX 0 Call is not one of multiparty (conference) call parties 1 Call is one of multiparty (conference) call parties Phone number in string type in format specified by Type of address of octet in integer format (Refer to 3GPP TS 24.008, subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type Alphanumeric representation of corresponding to the entry found in phonebook. Example ATD10086; OK AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,0,0,0,0,'10086',129 OK //Establish a call //PS call in LTE mode //Establish a call, and the call has been answered 7.15. AT+CR Service Reporting Control The command controls the module whether or not to transmit an intermediate result code +CR: to the TE when a call is being set up. EP06&EG06&EM06_AT_Commands_Manual 103 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual If it is enabled, an intermediate result code is transmitted at the point during connect negotiation at which the TA has determined which speed and quality of service will be used, before any error control or data compression reports are transmitted, and before any final result code (e.g. CONNECT) is transmitted. AT+CR Service Reporting Control Test Command AT+CR=? Response +CR: (list of supported s) Read Command AT+CR? OK Response +CR: Write Command AT+CR=[] Maximum Response Time Reference 3GPP TS 27.007 OK Response TA controls whether or not intermediate result code +CR: is returned from the TA to the TE when a call set up. OK 300ms Parameter 0 1 ASYNC SYNC REL ASYNC REL SYNC GPRS Disable Enable Asynchronous transparent Synchronous transparent Asynchronous non-transparent Synchronous non-transparent GPRS 7.16. AT+CRC Set Cellular Result Codes for Incoming Call Indication The command controls whether or not to use the extended format of incoming call indication. When it is enabled, an incoming call is indicated to the TE with unsolicited result code +CRING: instead of the normal RING. EP06&EG06&EM06_AT_Commands_Manual 104 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CRC Set Cellular Result Codes for Incoming Call Indication Test Command AT+CRC=? Response +CRC: (list of supported s) Read Command AT+CRC? OK Response +CRC: Write Command AT+CRC=[] Maximum Response Time Reference 3GPP TS 27.007 OK Response TA controls whether or not the extended format of incoming call indication is used. OK 300ms Parameter 0 1 ASYNC SYNC REL ASYNC REL SYNC FAX VOICE Disable extended format Enable extended format Asynchronous transparent Synchronous transparent Asynchronous non-transparent Synchronous non-transparent Facsimile Voice Example AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK RING ATH OK //Enable extended format //Indicate incoming call to the TE //Disable extended format //Indicate incoming call to the TE EP06&EG06&EM06_AT_Commands_Manual 105 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 7.17. AT+CRLP Select Radio Link Protocol Parameter The Write Command sets radio link protocol (RLP) parameters used when non-transparent data calls are originated. AT+CRLP Select Radio Link Protocol Parameter Test Command AT+CRLP=? Response TA returns values supported. RLP (Radio Link Protocol) versions 0 and 1 share the same parameter set. TA returns only one line for this set (where is not presented). +CRLP: (list of supported s),(list of supported s),(list of supported s),(list of supported s), +CRLP: (list of supported s),(list of supported s),(list of supported s),(list of supported s), +CRLP: (list of supported s),(list of supported s),(list of supported s),(list of supported s), Read Command AT+CRLP? OK Response TA returns current settings for RLP version. RLP versions 0 and 1 share the same parameter set. TA returns only one line for this set (where is not presented). +CRLP: ,,,, ... Write Command AT+CRLP=[[,[,[,[,]]]]] OK Response TA sets radio link protocol (RLP) parameters used when non-transparent data calls are set up. OK Maximum Response Time 300ms Reference 3GPP TS27.007 Parameter 0-61 0-240-488 0-61 Interworking window size (IWF to MS) For =2 Mobile window size (MS to IWF) EP06&EG06&EM06_AT_Commands_Manual 106 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 0-240-488 38-48-255 42-52-255 1-6-255 0-2 For =2 Acknowledgment timer T1 in a unit of 10ms For =2 Retransmission attempts N2 RLP version number in integer format 7.18. AT+QECCNUM Configure Emergency Call Numbers The command can be used to query, add and delete ECC numbers (emergency call numbers). There are two kinds of ECC numbers: ECC numbers without (U)SIM and ECC numbers with (U)SIM. The default ECC numbers without (U)SIM is 911, 112, 00, 08, 110, 999, 118 and 119. The default ECC number with (U)SIM is 911 and 112. 911 and 112 will always be supported as ECC numbers, and cannot be deleted. ECC numbers can be saved into NV automatically. If the (U)SIM card contains ECC file, the numbers in ECC file can also be regarded as ECC numbers. The maximal supported ECC numbers of each type is 20. AT+QECCNUM Configure Emergency Call Numbers Test Command AT+QECCNUM=? Response +QECCNUM: (0-2) Write Command AT+QECCNUM=,[,[,,…[,]] ] OK Response If is equal to 0, query the ECC numbers. In this case, should be omitted, and the response is: +QECCNUM: ,,[…] OK Read Command AT+QECCNUM? If is not equal to 0: =1 is used to add the ECC number; =2 is used to delete the ECC number. In this case, at least one ECC number should be inputted, and the response is: OK Or ERROR Response +QECCNUM: 0,,[…] … OK EP06&EG06&EM06_AT_Commands_Manual 107 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time 300ms Parameter ECC number operation mode 0 Query ECC numbers 1 Add ECC numbers 2 Delete ECC numbers ECC number type 0 ECC numbers without (U)SIM 1 ECC numbers with (U)SIM String type; ECC numbers (e.g.110, 119) Example AT+QECCNUM=? +QECCNUM: (0-2) //Query the supported ECC number operation mode OK AT+QECCNUM? //Query the ECC numbers with or without (U)SIM +QECCNUM: 0,'911','112','00','08','110','999','118','119' +QECCNUM: 1,'911','112' OK AT+QECCNUM=0,1 +QECCNUM: 1,'911','112' //Query the ECC numbers with (U)SIM OK AT+QECCNUM=1,1,'110', '234' //Add '110' and '234' into the type of ECC numbers with (U)SIM OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM +QECCNUM: 1, '911','112','110','234' OK AT+QECCNUM=2,1,'110' //Delete '110' from the type of ECC numbers with (U)SIM OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM +QECCNUM: 1, '911','112','234' OK EP06&EG06&EM06_AT_Commands_Manual 108 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 7.19. AT+QHUP Hang up Call with a Specific Release Cause The command can terminate a call or calls (including both voice call and data call) with a specific 3GPP TS 24.008 release cause specified by the host. AT+QHUP Hang up Call with a Specific Release Cause Test Command AT+QHUP=? Write Command AT+QHUP=[,] Response OK Response OK Or ERROR Maximum Response Time Reference If there is any error related to ME functionality: +CME ERROR: 90s, determined by network. Parameter Release cause, 3GPP TS 24.008 release cause to be indicated to the network. 1 Release cause 'unassigned (unallocated) number' 16 Release cause 'normal call clearing' 17 Release cause 'user busy' 18 Release cause 'no user responding' 21 Release cause 'call rejected' 27 Release cause 'destination out of order' 31 Release cause 'normal, unspecified' 88 Release cause 'incompatible destination' Call identification number is an optional index in the list of current calls indicated by AT+CLCC. AT+QHUP will terminate the call identified by the given call number. The default call number 0 is not assigned to any call, but signifies all calls. 0 Terminate all known calls. However, if circuit switches data calls and voice calls at the same time, this command only terminates the CSD calls. 1…7 Terminate the specific call with identification number. EP06&EG06&EM06_AT_Commands_Manual 109 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Example AT+QHUP=? //Test Command OK ATD10010; //Dial 10010 OK ATD10086; //Dial 10086 OK AT+CLCC //Query the status of calls +CLCC: 1,0,1,0,0,'10010',129 +CLCC: 2,0,0,0,0,'10086',129 OK AT+QHUP=17,1 //Terminate the call of which call ID is 1. Disconnect cause is 'user busy' OK AT+CLCC //Query the status of calls +CLCC: 1,0,0,0,0,'10086',129 OK AT+QHUP=16 OK AT+CLCC OK //Terminate all existed calls. Disconnect cause is 'normal call clearing' 7.20. AT^DSCI Call Status Indication The command is used to indicate the call status. AT^DSCI Call Status Indication Test Command AT^DSCI=? Response ^DSCI: (0,1) Read Command AT^DSCI? OK Response ^DSCI: Write Command AT^DSCI= Reference OK Response TA enables or disables the presentation of the DSCI at the TE. OK EP06&EG06&EM06_AT_Commands_Manual 110 / 240 Parameter 0 DSCI not provisioned 1 DSCI provisioned LTE-A Module Series EP06&EG06&EM06 AT Commands Manual NOTE When the presentation of the DSCI at the TE is enabled, an unsolicited result code is returned after the action: ^DSCI: ,,,,, Parameters Call ID Call direction Call state 1 CALL_LOCAL_HOLD 2 CALL_ORIGINAL 3 CALL_CONNECT 4 CALL_INCOMING 5 CALL_WAITING 6 CALL_END 7 CALL_ALERTING Call type 0 Voice call 1 PS call Phone number Type of phone number Example //Dial a call AT^DSCI=1 OK ATD10086; OK ^DSCI: 1,0,2,0,10086,129 ^DSCI: 1,0,7,0,10086,129 ^DSCI: 1,0,3,0,10086,129 ATH OK //Enable DSCI //Dial 10086 //A call is originated //The call is alerting //The call is connected EP06&EG06&EM06_AT_Commands_Manual 111 / 240 ^DSCI: 1,0,6,0,10086,129 //Incoming call. RING ^DSCI: 1,1,4,0,13022100000,129 RING ^DSCI: 1,1,6,0,13022100000,129 NO CARRIER LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //The call is ended. //A call is coming. //The call is ended. 7.21. AT+QCHLDIPMPTY Remove a Participant from the Conference Call The command is used to remove a participant from the conference call. It is only for VoLTE. AT+QCHLDIPMPTY Remove a participant from the Conference Call Test Command AT+QCHLDIPMPTY=? Response +QCHLDIPMPTY: Write Command AT+QCHLDIPMPTY= Maximum Response Time OK Response OK Or ERROR 300ms Parameter String type. A call number. EP06&EG06&EM06_AT_Commands_Manual 112 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 8 Phonebook Commands 8.1. AT+CNUM Subscriber Number The command can get the subscribers own number(s) from the (U)SIM. AT+CNUM Subscriber Number Test Command AT+CNUM=? Execution Command AT+CNUM Response OK Response [+CNUM: [], ,] … OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Optional alphanumeric string associated with ; the used character set should be the one selected with AT+CSCS command String type phone number of format specified by Type of address of octet in integer format (Refer to 3GPP TS 24.008 subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type EP06&EG06&EM06_AT_Commands_Manual 113 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 8.2. AT+CPBF Find Phonebook Entries The command can search the phonebook entries starting with the given string from the current phonebook memory storage selected with AT+CPBS, and return all found entries sorted in alphanumeric order. AT+CPBF Find Phonebook Entries Test Command AT+CPBF=? Response +CPBF: , Write Command AT+CPBF= OK Response [+CPBF: ,,,] … OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: Depends on the storage of phonebook entries. Parameter Integer type, indicates the maximum length of field Integer type, indicates the maximum length of field String type, field of maximum length in current TE character set specified by AT+CSCS. Integer type, in the range of location numbers of phone book memory Type of address of octet in integer format (Refer to 3GPP TS 24.008 subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type, field of maximum length in current TE character set specified by AT+CSCS. EP06&EG06&EM06_AT_Commands_Manual 114 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 8.3. AT+CPBR Read Phonebook Entries The command can return phonebook entries in location number range ... from the current phonebook memory storage selected with AT+CPBS. If is left out, only location is returned. AT+CPBR Read Phonebook Entries Test Command AT+CPBR=? Response +CPBR: (list of supported s),, Write Command AT+CPBR=[,] OK Response +CPBR: ,,, … OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: Depends on the storage of phonebook entries. Parameter Integer type, in the range of location numbers of phone book memory Integer type, indicates the maximum length of field Integer type, indicates the maximum length of field The first phone book record to read The last phonebook record to read Type of address of octet in integer format (Refer to 3GPP TS 24.008 subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type, field of maximum length in current TE character set specified by AT+CSCS. EP06&EG06&EM06_AT_Commands_Manual 115 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 8.4. AT+CPBS Select Phonebook Memory Storage The command selects phonebook memory storage, which is used by other phonebook commands. The Read Command returns currently selected memory, the number of used locations and the total number of locations in the memory when supported by manufacturer. The Test Command returns supported storages as compound value. AT+CPBS Select Phonebook Memory Storage Test Command AT+CPBS=? Response +CPBS: (list of supported s) OK Or ERROR Read Command AT+CPBS? If there is any error related to ME functionality: +CME ERROR: Response +CPBS: ,, OK Or ERROR Write Command AT+CPBS= If there is any error related to ME functionality: +CME ERROR: Response OK ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 'SM' 'DC' 'FD' 'LD' (U)SIM phonebook ME dialed calls list (AT+CPBW may not be applicable to this storage) (U)SIM fix dialing-phone book (AT+CPBW operation need the authority of PIN2) (U)SIM last-dialing-phone book (AT+CPBW may not be applicable to this storage) EP06&EG06&EM06_AT_Commands_Manual 116 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 'MC' ME missed (unanswered) calls list (AT+CPBW may not be applicable to this storage) 'ME' Mobile equipment phonebook 'RC' ME received calls list (AT+CPBW may not be applicable to this storage) 'EN' (U)SIM (or ME) emergency number (AT+CPBW may not be applicable to this storage) 'ON' (U)SIM own numbers (MSISDNs) list Integer type, indicates the total number of used locations in selected memory Integer type, indicates the total number of locations in selected memory 8.5. AT+CPBW Write Phonebook Entry The command writes phonebook entry in location number in the current phonebook memory storage selected with AT+CPBS. It can also delete a phonebook entry in location number . AT+CPBW Write Phonebook Entry Test Command AT+CPBW=? Response +CPBW: (The range of supported s),,(list of supported s), OK Or ERROR Write Command AT+CPBW=[][,[,[,]]] If there is any error related to ME functionality: +CME ERROR: Response OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms EP06&EG06&EM06_AT_Commands_Manual 117 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Integer type, in the range of location numbers of phone book memory. If is not given, the first free entry will be used. If is given as the only parameter, the phonebook entry specified by is deleted. Integer type, indicates the maximum length of field Integer type, indicates the maximum length of field Type of address of octet in integer format (Refer to 3GPP TS 24.008 subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type field of maximum length in current TE character set specified by AT+CSCS. Example AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK //Make a new phonebook entry at location 10 AT+CPBW=10 //Delete entry at location 10 OK EP06&EG06&EM06_AT_Commands_Manual 118 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 9 Short Message Service Commands 9.1. AT+CSMS Select Message Service The command selects messaging service and returns the types of messages supported by the ME. AT+CSMS Select Message Service Test Command AT+CSMS=? Response +CSMS: (list of supported s) Read Command AT+CSMS? OK Response +CSMS: ,,, Write Command AT+CSMS= OK Response +CSMS: ,, OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter Type of message service 0 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2 version 4.7.0; Phase 2+ features which do not require new command syntax may be supported, e.g. correct routing of messages with new Phase 2+ data coding schemes). 1 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is EP06&EG06&EM06_AT_Commands_Manual 119 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual compatible with 3GPP TS 27.005 Phase 2+ version; the requirement of setting 1 is mentioned under corresponding command descriptions). Mobile terminated messages 0 Type not supported 1 Type supported Mobile originated messages 0 Type not supported 1 Type supported Broadcast type messages 0 Type not supported 1 Type supported Example AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //Test command //Set type of message service as 1 //Read command 9.2. AT+CMGF Message Format The command specifies the input and output format of the short messages. indicates the format of messages used with send, list, read and write commands and unsolicited result codes resulting from received messages. The format of messages can be either PDU mode (entire TP data units used) or text mode (headers and body of the messages given as separate parameters). Text mode uses the value of parameter specified by command AT+CSCS to inform the character set to be used in the message body in the TA-TE interface. EP06&EG06&EM06_AT_Commands_Manual 120 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CMGF Message Format Test Command AT+CMGF=? Read Command AT+CMGF? Write Command AT+CMGF[=] Maximum Response Time Reference 3GPP TS 27.005 Parameter 0 1 PDU mode Text mode Response +CMGF: (list of supported s) OK Response +CMGF: OK Response TA sets parameter to denote which kind of I/O format of messages is used. OK 300ms 9.3. AT+CSCA Service Center Address The Write Command updates the SMSC address when mobile originated SMS are transmitted. In text mode, the setting is used by Write Command. In PDU mode, setting is used by the same command, but only when the length of the SMSC address is coded into the parameter which equals to zero. AT+CSCA Service Center Address Test Command AT+CSCA=? Read Command AT+CSCA? Response OK Response +CSCA: , Write Command AT+CSCA=[,] OK Response OK If there is any error related to ME functionality: EP06&EG06&EM06_AT_Commands_Manual 121 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.005 +CME ERROR: 300ms Parameter Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ). Example AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //Set SMS service center address //Query SMS service center address 9.4. AT+CPMS Preferred Message Storage The command selects memory storages , and to be used for reading, writing, etc. AT+CPMS Preferred Message Storage Test Command AT+CPMS=? Response +CPMS: (list of supported s),(list of supported s),(list of supported s) Read Command AT+CPMS? OK Response +CPMS: ,,,,,,,, Write Command OK Response EP06&EG06&EM06_AT_Commands_Manual 122 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CPMS=[,[,]] TA selects memory storages , and to be used for reading, writing, etc. +CPMS: ,,,,, OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter Messages to be read and deleted from this memory storage 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Messages will be written and sent to this memory storage 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Received messages will be placed in this memory storage if routing to PC is not set (AT+CNMI) 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Integer type, number of current messages in Integer type, total number of messages which can be stored in Example AT+CPMS? //Query the current SMS message storage +CPMS: 'ME',0,255,'ME',0,255,'ME',0,255 OK AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //Set SMS message storage as 'SM' EP06&EG06&EM06_AT_Commands_Manual 123 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //Query the current SMS message storage OK 9.5. AT+CMGD Delete Messages The command deletes short messages from the preferred message storage location . If is presented and not set to 0, then the ME shall ignore and follow the rules of shown as below. AT+CMGD Delete Messages Test Command AT+CMGD=? Response +CMGD: (list of supported s),(list of supported s) Write Command AT+CMGD=[,] OK Response TA deletes message from preferred message storage location . OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300ms Note: Operation of depends on the storage of deleted messages. Parameter Integer type value in the range of location numbers supported by the associated memory. 0 Delete the message specified in 1 Delete all read messages from storage 2 Delete all read messages from storage and sent mobile originated messages 3 Delete all read messages from storage, sent and unsent mobile originated messages 4 Delete all messages from storage EP06&EG06&EM06_AT_Commands_Manual 124 / 240 Example AT+CMGD=1 OK AT+CMGD=1,4 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Delete the message specified in =1 //Delete all messages from storage 9.6. AT+CMGL List Messages The Read Command returns messages with status value from preferred message storage to the TE. If the status of the message is 'REC UNREAD', the status in the storage changes to 'REC READ'. When executing command AT+CMGL without status value , it will report the list of SMS with 'REC UNREAD' status. AT+CMGL List Messages Test Command AT+CMGL=? Response +CMGL: (list of supported s) Write Command AT+CMGL[=] OK Response If in text mode (AT+CMGF=1) and the command is exec uted successfully: For SMS-SUBMITs and/or SMS-DELIVERs: +CMGL: ,,,[],[][,,][ ... For SMS-STATUS-REPORTs: +CMGL: ,,,,[],[],,,[ ... For SMS-COMMANDs: +CMGL: ,,,[ … For CBM storage: +CMGL: ,,,,,[ ... OK EP06&EG06&EM06_AT_Commands_Manual 125 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Execution Command AT+CMGL Maximum Response Time Reference 3GPP TS 27.005 If in PDU mode (AT+CMGF=0) and the command is exe cuted successfully: +CMGL: ,,[], ... OK If there is any error related to ME functionality: +CMS ERROR: Response List all messages with 'REC UNREAD' status from message storage , and then the status in the storage changes to 'REC READ'. 300ms. Note: Operation of depends on the storage of listed messages. Parameter In text mode: 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages 'ALL' All messages In PDU mode: 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages 4 All messages Integer type, in the range of location numbers supported by the associated memory Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS EP06&EG06&EM06_AT_Commands_Manual 126 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual in TS 27.007); type of address is given by . String type alphanumeric representation of or corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer specified; the used character set should be the one selected with command Select TE Character Set AT+CSCS (see definition of this command in 3GPP TS 27.007). Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). Message length, integer type, indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (AT+CMGF=0) the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7-bit default alphabet is used and indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set. - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7 bit default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7 bit default alphabet 23) is presented as 17 (IRA 49 and 55)). - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7-bit default alphabet is used: - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7-bit default alphabet into two IRA character long hexadecimal number. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) 3GPP TS 27.007. EP06&EG06&EM06_AT_Commands_Manual 127 / 240 Example AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Set SMS message format as text mode //List all messages from message storage 9.7. AT+CMGR Read Messages The Read Command returns SMS message with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage changes to 'REC READ'. AT+CMGR Read Messages Test Command AT+CMGR=? Write Command AT+CMGR= Response OK Response TA returns SMS message with location value fro m message storage to the TE. If status of the message is 'REC UNREAD', status in the storage chang es to 'REC READ'. If in text mode (AT+CMGF=1) and the command is exec uted successfully: For SMS-DELIVER: +CMGR: ,,[],[,,,,,,,] OK For SMS-SUBMIT: +CMGR: ,,[][,,,,,[],,,] OK For SMS-STATUS-REPORTs: +CMGR: ,,,[],[],,, OK For SMS-COMMANDs: +CMGR: ,,[,,[],[],[], ] OK For CBM storage: +CMGR: ,,,,, OK If in PDU mode (AT+CMGF=0) and command is execute d successfully: +CMGR: ,[], OK If there is any error related to ME functionality: +CMS ERROR: Depends on the length of message content. Parameter Integer type value in the range of location numbers supported by the associated memory In text mode 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages 'ALL' All messages In PDU mode 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages EP06&EG06&EM06_AT_Commands_Manual 129 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4 All messages String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND in integer format. If a valid value has been entered once, the parameter can be omitted. Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ). Message number. 3GPP TS 23.040 TP-Message-Number in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Recipient address. 3GPP TS 23.040 TP-Recipient-Address Address-Value field in string format. BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (default refer ). Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Type of originating address.3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ). EP06&EG06&EM06_AT_Commands_Manual 130 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Message length. Integer type. Indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0) the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). The text of short message. Please refer Chapter 14.8 for details. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Priority 0 Normal 1 Interactive 2 Urgent 3 Emergency Format 0 GSM 7 bit 1 ASCII 6 UNICODE Privacy 0 Normal 1 Restricted 2 Confidential 3 Secret Language 0 Unspecified 1 English 2 French 3 Spanish 4 Japanese 5 Korean 6 Chinese 7 Hebrew 0 Normal 1 CPT 2 Voice Mail 3 SMS Report Example +CMTI: 'SM',3 AT+CSDH=1 OK AT+CMGR=3 //Indicates that new message has been received and saved to =3 of 'SM' //Read message EP06&EG06&EM06_AT_Commands_Manual 131 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual +CMGR: 'REC UNREAD','+8615021012496',,'13/12/13,15:06:37+32',145,4,0,0,'+861380021050 0',145,27 OK 9.8. AT+CMGS Send Messages The Write Command sends a short message from TE to network (SMS-SUBMIT). After invoking the Write Command, wait for the prompt > and then start to write the message. After that, enter to indicate the ending of PDU and begin to send the message. Sending can be cancelled by giving character. Abortion is acknowledged with OK, though the message will not be sent. The message reference is returned to the TE on successful message delivery. The value can be used to identify message upon unsolicited delivery status report result code. AT+CMGS Send Messages Test Command AT+CMGS=? Write Command 1) If in text mode (AT+CMGF=1): AT+CMGS=[,] text is entered means quit without sending 2) If in PDU mode (AT+CMGF=0): AT+CMGS= PDU is given Response OK Response TA sends message from TE to the network (SMS-SUBMIT). Message reference value is returned to the TE on successful message delivery. Optionally (when AT+CSMS value is 1 and the network supports) is returned. Values can be used to identify message upon unsolicited delivery status report result code. If in text mode (AT+CMGF=1) and sent successfully: +CMGS: OK If in PDU mode (AT+CMGF=0) and sent successfully: +CMGS: OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 120s, determined by network. EP06&EG06&EM06_AT_Commands_Manual 132 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Message length. Integer type, indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > +CMGS: 247 OK //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text, send message, quits without sending 9.9. AT+CMMS Send More Messages The command controls the continuity of the SMS relay protocol link. If the feature is enabled (and supported by the currently used network) multiple messages can be sent faster as the link is kept open. AT+CMMS Send More Messages Test Command AT+CMMS=? Response +CMMS: (list of supporteds) Read Command AT+CMMS? OK Response +CMMS: OK EP06&EG06&EM06_AT_Commands_Manual 133 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Write Command AT+CMMS= Maximum Response Time Reference 3GPP TS 27.005 Response OK Or ERROR If there is any error related to ME functionality: +CMS ERROR: 120s, determined by network. Parameter 0 1 2 Feature disabled Keep enabled until the time between the response of the latest message send command (AT+CMGS, AT+CMSS, etc.) and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation); then ME shall close the link and TA switches back to 0 automatically. Feature enabled. If the time between the response of the latest message send command and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation), ME shall close the link but TA will not switch back to 0 automatically. NOTE After the use of read command, a delay of 5-10 seconds is required before issuing the Write Command. Otherwise +CMS ERROR: 500 may appear. 9.10. AT+CMGW Write Messages to Memory The Write and Execution Commands store short messages from TE to memory storage , and then the memory location of the stored message is returned. Message status will be set to 'stored unsent' by default; but parameter also allows other status values to be given. The syntax of input text is the same as the one specified in AT+CMGS Write Command. AT+CMGW Write Messages to Memory Test Command AT+CMGW=? Write Command 1) If in text mode (AT+CMGF=1): Response OK Response TA transmits SMS message (either SMS-DELIVER or EP06&EG06&EM06_AT_Commands_Manual 134 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CMGW=[,[,]] text is entered quits without sending SMS-SUBMIT) from TE to memory storage , and then the memory location of the stored message is returned. By default the message status will be set to ‘stored unsent’, but parameter also allows other status values to be given. 2) If in PDU mode (AT+CMGF=0): AT+CMGW=[,] PDU is given If writing is successful: +CMGW: OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address given by . Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Message length. Integer type, indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.04TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character EP06&EG06&EM06_AT_Commands_Manual 135 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Index of message in selected storage . Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > +CMGW: 4 //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text. Use to write message or to quit without sending OK AT+CMGF=0 //Set SMS message format as PDU mode OK AT+CMGW=18 > 0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK 9.11. AT+CMSS Send Messages from Storage The Write Command sends a message with location value from message storage to the network. If a new recipient address is given for SMS-SUBMIT, it shall be used instead of the one stored with the message. AT+CMSS Send Messages from Storage Test Command AT+CMSS=? Write Command AT+CMSS=[,[,]] Response OK Response TA sends message with location value from message storage to the network (SMS-SUBMIT). If new recipient address is given, it shall be used instead of the one stored with the message. Reference value is returned to the TE on successful message delivery. Values can be used to identify message upon unsolicited delivery EP06&EG06&EM06_AT_Commands_Manual 136 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.005 status report result code. If in text mode (AT+CMGF=1) and sent successfully: +CMSS: [,] OK If in PDU mode (AT+CMGF=0) and sent successfully: +CMSS: [,] OK If there is any error related to ME functionality: +CMS ERROR: 120s, determined by network. Parameter Integer type in the range of location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). Format is same for in case of SMS, but without 3GPP TS 24.011 SC address field and parameter shall be bounded by double quote characters like a normal string type parameter. Example AT+CMGF=1 OK AT+CSCS='GS OK AT+CMGW='15021012496' > Hello +CMGW: 4 //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text. Use to send message or to quit without sending EP06&EG06&EM06_AT_Commands_Manual 137 / 240 OK AT+CMSS=4 +CMSS: 54 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Send the message of index 4 from memory storage. 9.12. AT+CNMA Mew Message Acknowledgement to UE/TE The Write and Execution Commands confirm successful receipt of a new message (SMS-DELIVER or SMS-STATUS-REPORT) routed directly to the TE. If the UE does not receive acknowledgement within required time (network timeout), it sends an RP-ERROR message to the network. The UE will automatically disable routing to the TE by setting both and values of AT+CNMI to 0. AT+CNMA New Message Acknowledgement to UE/TE Test Command AT+CNMA=? Response +CNMA: (list of supported s) Execution Command AT+CNMA OK Response OK Or ERROR Write Command AT+CNMA= If there is any error related to ME functionality: +CMS ERROR: Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300ms EP06&EG06&EM06_AT_Commands_Manual 138 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Parameter required only for PDU mode 0 Command operates similarly as in text mode 1 Send positive (RP-ACK) acknowledgement to the network. Accepted only in PDU mode 2 Send negative (RP-ERROR) acknowledgement to the network. Accepted only in PDU mode. NOTE The Execute and Write commands shall only be used when AT+CSMS parameter equals 1 (phase 2+) and an appropriate URC has been issued by the module, i.e.: +CMT for =2 incoming message classes 0,1,3 and none; +CMT for =3 incoming message classes 0 and 3; +CDS for =1. Example AT+CSMS=1 OK AT+CNMI=1,2,0,0,0 OK AT+CMGF=1 OK AT+CSDH=1 OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when SMS is incoming. AT+CNMA //Send ACK to the network OK AT+CNMA +CMS ERROR: 340 //The second time return error; it needs ACK only once 9.13. AT+CNMI SMS Event Reporting Configuration The Write Command selects the procedure on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR is at low level (ON). If TE is inactive (e.g. DTR is at high level (OFF)), message receiving should be done as specified in 3GPP TS 23.038. EP06&EG06&EM06_AT_Commands_Manual 139 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CNMI SMS Event Reporting Configuration Test Command AT+CNMI=? Response +CNMI: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CNMI? OK Response +CNMI: ,,,, Write Command AT+CNMI[=[,[,[,[,]]]]] OK Response TA selects the procedure on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR is at low level (ON). If TE is inactive (e.g. DTR is at high level (OFF)), message receiving should be done as specified in 3GPP TS 23.038. OK Or ERROR Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter 0 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications. 1 Discard indication and reject new received message unsolicited result codes when TA-TE link is reserved (e.g. in data mode). Otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in data mode) and flush them to the TE after reservation. Otherwise forward them directly to the TE. The rules for storing received SMS depend on its data coding scheme (refer to 3GPPTS 23.038) and preferred memory storage (AT+CPMS) setting, and the value is: 0 No SMS-DELIVER indications are routed to the TE. EP06&EG06&EM06_AT_Commands_Manual 140 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE by using unsolicited result code: +CMTI: , 2 SMS-DELIVERs (except class 2) are routed directly to the TE using unsolicited result code: +CMT: [], (PDU mode enabled) or +CMT: ,[],[,,,,,,, ] (text mode enabled; about the parameters in italics, please refer to AT+CSDH command). Class 2 messages result in indication as defined in =1. 3 Class 3 SMS-DELIVERs are routed directly to TE by using unsolicited result codes defined in =2. Messages of other classes result in indication as defined in =1. The rules for storing received CBMs depend on its data coding scheme (refer to 3GPP TS 23.038) and the setting of Select CBM Types (AT+CSCB); and the value is: 0 No CBM indications are routed to the TE. 2 New CBMs are routed directly to the TE using unsolicited result code: +CBM: (PDU mode); or +CBM: ,,,, (text mode) 0 No SMS-STATUS-REPORTs are routed to the TE. 1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +CDS: (PDU mode) +CDS: ,,[],[],,, (text mode) 2 If SMS-STATUS-REPORT is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CDSI:, 0 TA buffer of unsolicited result codes defined within this command is flushed to the TE when 1...2 is entered (OK response shall be given before flushing the codes). 1 TA buffer of unsolicited result codes defined within this command is cleared when 1...2 is entered. NOTE Unsolicited result code: +CMTI: , +CMT: [], +CBM: Indicates that new message has been received Short message is outputted directly Cell broadcast message is outputted directly Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CNMI=1,2,0,1,0 //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Set SMS-DELIVERs are routed directly to the TE EP06&EG06&EM06_AT_Commands_Manual 141 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual OK AT+CSDH=1 //Show text mode parameters OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when an SMS is incoming. 9.14. AT+CSCB Select Cell Broadcast Message Types The Write Command selects which types of CBMs are to be received by the ME. The command writes the parameters in NON-VOLATILE memory. AT+CSCB Select Cell Broadcast Message Types Test Command AT+CSCB=? Response It returns supported modes as a compound value. +CSCB: (list of supported s) Read Command AT+CSCB? OK Response +CSCB : ,, Write Command AT+CSCB=[,mids>[,]] OK Response TA selects which types of CBMs are to be received by the ME. OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter 0 Message types specified in and are accepted 1 Message types specified in and are not accepted String type. All different possible combinations of CBM message identifiers (refer to ) (default is empty string), e.g. '0,1,5,320-478,922' String type. All different possible combinations of CBM data coding schemes (refer to ) (default is empty string), e.g. '0-3,5' EP06&EG06&EM06_AT_Commands_Manual 142 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 9.15. AT+CSDH Show SMS Text Mode Parameters The Write Command controls whether detailed header information is shown in text mode result codes. AT+CSDH Show SMS Text Mode Parameters Test Command AT+CSDH=? Response +CSDH: (list of supported s) Read Command AT+CSDH? OK Response +CSDH: Write Command AT+CSDH[=] Maximum Response Time Reference 3GPP TS 27.005 OK Response OK Or ERROR 300ms Parameter 0 1 Do not show header values defined in commands +CSCA, +CSMP (, , , , , ) and , or in +CMT, +CMGL, +CMGR result codes for SMS-DELIVERs and SMS-SUBMITs in text mode Show the values in result codes Example AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT' ,'', OK AT+CSDH=1 OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 EP06&EG06&EM06_AT_Commands_Manual 143 / 240 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 9.16. AT+CSMP Set SMS Text Mode Parameters The command is used to set values for additional parameters needed when a short message is sent to the network or placed in a storage in text mode. AT+CSMP Set SMS Text Mode Parameters Test Command AT+CSMP=? Read Command AT+CSMP? Response OK Response +CSMP: ,,, Write Command AT+CSMP=[,[,[,]] ] OK Response TA selects values for additional parameters needed when SM is sent to the network or placed in a storage when text mode is selected (AT+CMGF=1). It is possible to set the validity period starting from when the SM is received by the SMSC ( ranges from 0 to 255) or define the absolute time of the validity period termination ( is a string). OK Maximum Response Time 300ms Reference 3GPP TS 27.005 Parameter First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, SMS-COMMAND in integer format. If a valid value has been entered once, parameter can be omitted. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ). Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. EP06&EG06&EM06_AT_Commands_Manual 144 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 10 Packet Domain Commands 10.1. AT+CGATT Attachment or Detachment of PS The Write Command is used to attach the MT to, or detach the MT from the Packet Domain service. After the command has been completed, the MT remains in V.25ter command state. If the MT is already in the requested state, the command is ignored and the OK response will be returned. If the requested state cannot be achieved, an ERROR or +CME ERROR response is returned. AT+CGATT Attachment or Detachment of PS Test Command AT+CGATT=? Response +CGATT: (list of supported s) Read Command AT+CGATT? OK Response +CGATT: Write Command AT+CGATT= OK Response OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 140s, determined by network. Parameter Indicates the state of PS attachment 0 Detached 1 Attached Other values are reserved and will result in an ERROR response to the Write Command EP06&EG06&EM06_AT_Commands_Manual 145 / 240 Example AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Attach to PS service //Detach from PS service //Query the current PS service state 10.2. AT+CGDCONT Define PDP Contexts The command specifies PDP context parameters for a specific context . A special form of the Write Command (AT+CGDCONT=) causes the values for context to become undefined. It is not allowed to change the definition of an already activated context. The Read Command returns the current settings for each defined PDP context. AT+CGDCONT Define PDP Contexts Test Command AT+CGDCONT=? Response +CGDCONT: (range of supported s),,< APN>,,(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CGDCONT? OK Response +CGDCONT: ,,,,,[…] Write Command AT+CGDCONT=[,[,< APN>[,[,[,< head_comp>]]]]] OK Response OK Or ERROR Maximum Response Time 300ms Reference 3GPP TS 27.007 EP06&EG06&EM06_AT_Commands_Manual 146 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter PDP context identifier, a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of the command. Packet data protocol type, a string parameter which specifies the type of packet data protocol. 'IP' IPV4. Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' Access point name, a string parameter that is a logical name used to select the GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested. A string parameter identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The allocated address may be read using the AT+CGPADDR command. A numeric parameter that controls PDP data compression (applicable for SNDCP only) (refer to 3GPP TS 44.065). 0 Off (Default if value is omitted) 1 On (Manufacturer preferred compression) 2 V.42bis 3 V.44 (Not supported currently) A numeric parameter that controls PDP header compression (refer to 3GPP TS 44.065 and 3GPP TS 25.323). 0 Off 1 On 2 RFC1144 3 RFC2507 4 RFC3095 Integer type, controls how the MT/TA requests to get the IPv4 address information 0 IPv4 address allocation through NAS signaling 1 IPv4 address allocated through DHCP Integer type, indicates the type of PDP context activation request for the PDP context 0 PDP context is for new PDP context establishment or for handover from a non-3GPP access network (how the MT decides whether the PDP context is for new PDP context establishment or for handover is implementation specific) 1 PDP context is for emergency bearer services EP06&EG06&EM06_AT_Commands_Manual 147 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 10.3. AT+CGQREQ Quality of Service Profile (Requested) The command allows the TE to specify the quality of service profile that is used when the MT activates a PDP context. The Write Command specifies a profile for the context . A special form of the Write Command, AT+CGQREQ= causes the requested profile for context number to become undefined. The Read Command returns the current settings for each defined context. Details can be found in 3GPP TS 23.107 and all parameters are saved in NV automatically. AT+CGQREQ Quality of Service Profile (Requested) Test Command AT+CGQREQ=? Response +CGQREQ: ,(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CGQREQ? OK Response [+CGQREQ: ,,,>reliability>,,] … Write Command AT+CGQREQ=[,[, [,[,[,]]]]] OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) Packet Data Protocol type 'IP' IPV4. Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' EP06&EG06&EM06_AT_Commands_Manual 148 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual A numeric parameter which specifies the precedence class 0 Network subscribed value 1 High Priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments shall be maintained ahead of precedence class 3 3 Low priority. Service commitments shall be maintained A numeric parameter which specifies the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the details, please refer to Table 5. 0 Network subscribed value 1~4 Please refer to Table 5. A numeric parameter which specifies the reliability class 0 Network subscribed value 1 Non real-time traffic, error-sensitive application that cannot cope with data loss 2 Non real-time traffic, error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic, error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic, error-sensitive application that can cope with data loss 5 Real-time traffic, error non-sensitive application that can cope with data loss A numeric parameter which specifies the peak throughput class, in octets per second. 0 Network subscribed value 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) 8 Up to 128 000 (1024 kbit/s) 9 Up to 256 000 (2048 kbit/s) A numeric parameter which specifies the mean throughput class, in octets per hour. 0 Network subscribed value 1 100 (~0.22 bit/s) 2 200 (~0.44 bit/s) 3 500 (~1.11 bit/s) 4 1 000 (~2.2 bit/s) 5 2 000 (~4.4 bit/s) 6 5 000 (~11.1 bit/s) 7 10 000 (~22 bit/s) 8 20 000 (~44 bit/s) 9 50 000 (~111 bit/s) EP06&EG06&EM06_AT_Commands_Manual 149 / 240 10 100 000 (~0.22 kbit/s) 11 200 000 (~0.44 kbit/s) 12 500 000(~1.11 kbit/s) 13 1000 000 (~2.2 kbit/s) 14 2 000 000 (~4.4 kbit/s) 15 5 000 000 (~11.1 kbit/s) 16 10 000 000 (~22 kbit/s) 17 20 000 000 (~44 kbit/s) 18 50 000 000 (~111 kbit/s) 31 Best effort LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Table 4: Delay Class SDU Size 128 octets 1024 octets Delay Class 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) Mean Transfer Delay <0.5 <5 <50 Unspecified <0.5 <5 <50 Unspecified 95 Percentile <1.5 <25 <250 <1.5 <25 <250 - 10.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) The command allows the TE to specify a minimum acceptable profile which is checked by the MT against the negotiated profile when the PDP context is activated. The write command specifies a profile for the context identified by the context identification parameter . A special form of the write command, AT+CGQMIN= causes the minimum acceptable profile for context number to become undefined. In this case no check is made against the negotiated profile. The Read Command returns the current settings for each defined context. Details can be found in 3GPP TS 23.107 and all parameters are saved in NV automatically. EP06&EG06&EM06_AT_Commands_Manual 150 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CGQMIN Quality of Service Profile (Minimum Acceptable) Test Command AT+CGQMIN=? Response +CGQMIN: ,(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CGQMIN? OK Response [+CGQMIN: ,,,,,] … Write Command AT+CGQMIN=[,[,< delay>[,[,[, ]]]]] OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) Packet Data Protocol type 'IP' IPV4. Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' A numeric parameter which specifies the precedence class 0 Network subscribed value 1 High Priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments shall be maintained ahead of precedence class 3 3 Low priority. Service commitments shall be maintained A numeric parameter which specifies the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the detail please refer to Table 5. EP06&EG06&EM06_AT_Commands_Manual 151 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 0 Network subscribed value A numeric parameter which specifies the reliability class. 0 Network subscribed value 1 Non real-time traffic, error-sensitive application that cannot cope with data loss 2 Non real-time traffic, error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic, error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic, error-sensitive application that can cope with data loss 5 Real-time traffic, error non-sensitive application that can cope with data loss A numeric parameter which specifies the peak throughput class, in octets per second. 0 Network subscribed value 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) 8 Up to 128 000 (1024 kbit/s) 9 Up to 256 000 (2048 kbit/s) A numeric parameter which specifies the mean throughput class, in octets per hour. 0 Network subscribed value 1 100 (~0.22 bit/s) 2 200 (~0.44 bit/s) 3 500 (~1.11 bit/s) 4 1 000 (~2.2 bit/s) 5 2 000 (~4.4 bit/s) 6 5 000 (~11.1 bit/s) 7 10 000 (~22 bit/s) 8 20 000 (~44 bit/s) 9 50 000 (~111 bit/s) 10 100 000 (~0.22 kbit/s) 11 200 000 (~0.44 kbit/s) 12 500 000(~1.11 kbit/s) 13 1000 000 (~2.2 kbit/s) 14 2 000 000 (~4.4 kbit/s) 15 5 000 000 (~11.1 kbit/s) 16 10 000 000 (~22 kbit/s) 17 20 000 000 (~44 kbit/s) 18 50 000 000 (~111 kbit/s) 31 Best effort EP06&EG06&EM06_AT_Commands_Manual 152 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 10.5. AT+CGEQREQ 3G Quality of Service Profile (Requested) The command allows the TE to specify a UMTS Quality of Service Profile that is used when the MT activates a PDP context. Details can be found in 3GPP TS 23.107 and all parameters are saved in NV automatically. AT+CGEQREQ 3G Quality of Service Profile (Requested) Test Command AT+CGEQREQ=? Response +CGEQREQ: ,(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CGEQREQ? OK Response [+CGEQREQ: ,,,, ,< Guaranteed bitrate DL>,,,,, ,,,,] [...] Write Command AT+CGEQREQ=[[,[,[,[,[,[,[,[, [,[,[,[,[,[,]]]]]]]]]]]]]]] Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter PDP context identifier, a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of the command Packet data protocol type, a string parameter which specifies the type of packet data protocol 'IP' IPV4. Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' The following parameters are defined in 3GPP TS 23.107 Integer type, indicates the type of application for which the UMTS bearer service is optimized (refer to 3GPP TS 24.008 subclause 10.5.6.5). If the parameter is specified as conversational or streaming, then the Guaranteed and Maximum bitrate parameters should also be provided. 0 Conversational 1 Streaming 2 Interactive 3 Background 4 Subscribed value Integer type, indicates the maximum number of kbits/s delivered to UMTS (up-link traffic) at a SAP. As an example a bit rate of 32kbit/s would be specified as ‘32’ (e.g. AT+CGEQREQ=…,32, …). 0 Subscribed value 1~11520 Integer type, indicates the maximum number of kbits/s delivered by UMTS (down-link traffic) at a SAP. As an example a bitrate of 32kbit/s would be specified as ‘32’ (e.g. AT+CGEQREQ=…,32, …). 0 Subscribed value 1~42200 Integer type, indicates the guaranteed number of kbits/s delivered to UMTS (up-link traffic) at a SAP (provided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as ‘32’ (e.g. EP06&EG06&EM06_AT_Commands_Manual 154 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CGEQREQ=…,32, …). 0 Subscribed value 1~11520 Integer type, indicates the guaranteed number of kbits/s delivered by UMTS (down-link traffic) at a SAP (provided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as ‘32’ (e.g. AT+CGEQREQ=…,32, …). 0 Subscribed value 1~42200 Integer type, indicates whether the UMTS bearer shall provide in-sequence SDU delivery or not (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 No 1 Yes 2 Subscribed value Integer type, (1,2,3,…) indicates the maximum allowed SDU size in octets. If the parameter is set to ‘0’ the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed value 10...1520 (Value needs to be divisible by 10 without remainder) 1520 String type, indicates the target value for the fraction of SDUs lost or detected as erroneous. SDU error ratio is defined only for conforming traffic. The value is specified as ‘mEe’. As an example a target SDU error ratio of 5*10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…). '0E0' Subscribed value '1E1' '1E2' '7E3' '1E3' '1E4' '1E5' '1E6' String type, indicates the target value for the undetected bit error ratio in the delivered SDUs. If no error detection is requested, Residual bit error ratio indicates the bit error ratio in the delivered SDUs. The value is specified as 'mEe'. As an example a target residual bit error ratio of 5•10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…). '0E0' Subscribed value '5E2' '1E2' '5E3' EP06&EG06&EM06_AT_Commands_Manual 155 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual '4E3' '1E3' '1E4' '1E5' '1E6' '6E8' Integer type, indicates whether SDUs detected as erroneous shall be delivered or not (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 No 1 Yes 2 No detect 3 Subscribed value Integer type, (0,1,2,…) indicates the targeted time between request to transfer an SDU at one SAP to its delivery at the other SAP, in milliseconds. If the parameter is set to ‘0’ the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed value 10~150 (value needs to be divisible by 10 without remainder) 200~950 (value needs to be divisible by 50 without remainder) 1000~4000 (value needs to be divisible by 100 without remainder) Integer type, (1,2,3,…) specifies the relative importance for handling of all SDUs belonging to the UMTS bearer compared to the SDUs of other bearers. If the parameter is set to ‘0’ the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed 1 Priority level 1 2 Priority level 2 3 Priority level 3 Integer type, specifies characteristics of the source of the submitted SDUs for a PDP context. 0 Characteristics of SDUs is unknown 1 Characteristics of SDUs correspond to a speech source Integer type, indicates signaling content of submitted SDUs for a PDP context. 0 PDP context is not optimized for signaling 1 PDP context is optimized for signaling EP06&EG06&EM06_AT_Commands_Manual 156 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 10.6. AT+CGEQMIN 3G Quality of Service Profile (Minimum Acceptable) The command allows the TE to specify a minimum acceptable profile, which is checked by the MT against the negotiated profile returned in the PDP context establishment and PDP context modification procedures. Details can be found in 3GPP TS 23.107 and all parameters are saved in NV automatically. AT+CEGQMIN 3G Quality of Service Profile (Minimum Acceptable) Test Command AT+CGEQMIN=? Response +CGEQMIN: ,(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supporte d s),(list of supported s),(list of supported s) Read Command AT+CGEQMIN? OK Response [+CGEQMIN: ,,,,,,,,,,< Delivery of erroneous SDUs>,,,,] … Write Command AT+CGEQMIN=[[,[,[,[,[,[,[,[, [,[,[,[,[,<Source statistics d OK Response OK If there is any error related to ME functionality: +CME ERROR: EP06&EG06&EM06_AT_Commands_Manual 157 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual escriptor>[,]]]]]]]]]]]]]]] Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter PDP context identifier, a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of the command Packet data protocol type, a string parameter which specifies the type of packet data protocol. 'IP' IPV4. Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' The following parameters are defined in 3GPP TS 23.107. Integer type, indicates the type of application for which the UMTS bearer service is optimized (refer to 3GPP TS 24.008 subclause 10.5.6.5). If the parameter is specified as conversational or streaming, then the Guaranteed and Maximum bitrate parameters should also be provided. 0 Conversational 1 Streaming 2 Interactive 3 Background 4 Subscribed value Integer type, indicates the maximum number of kbits/s delivered to UMTS (up-link traffic) at a SAP. As an example a bitrate of 32kbit/s would be specified as ‘32’ (e.g. AT+CGEQREQ=…,32, …). 0 Subscribed value 1~11520 Integer type, indicates the maximum number of kbits/s delivered by UMTS (down-link traffic) at a SAP. As an example a bitrate of 32kbit/s would be specified as ‘32’ (e.g. AT+CGEQREQ=…,32, …). 0 Subscribed value 1~42200 Integer type, indicates the guaranteed number of kbits/s delivered to UMTS (up-link traffic) at a SAP (provided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as ‘32’ (e.g. EP06&EG06&EM06_AT_Commands_Manual 158 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CGEQREQ=…,32, …). 0 Subscribed value 1~11520 Integer type, indicates the guaranteed number of kbits/s delivered by UMTS (down-link traffic) at a SAP (provided that there is data to deliver). As an example a bitrate of 32kbit/s would be specified as ‘32’ (e.g. AT+CGEQREQ=…,32, …). 0 Subscribed value 1~42200 Integer type, indicates whether the UMTS bearer shall provide in-sequence SDU delivery or not (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 No 1 Yes 2 Subscribed value Integer type, (1,2,3,…) indicates the maximum allowed SDU size in octets. If the parameter is set to ‘0’ the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed value 10...1520 (value needs to be divisible by 10 without remainder) 1502 String type, indicates the target value for the fraction of SDUs lost or detected as erroneous. SDU error ratio is defined only for conforming traffic. The value is specified as ‘mEe’. As an example a target SDU error ratio of 5*10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…). '0E0' Subscribed value '1E2' '7E3' '1E3' '1E4' '1E5' '1E6' '1E1' String type, indicates the target value for the undetected bit error ratio in the delivered SDUs. If no error detection is requested, Residual bit error ratio indicates the bit error ratio in the delivered SDUs. The value is specified as 'mEe'. As an example a target residual bit error ratio of 5•10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…). '0E0' Subscribed value '5E2' '1E2' '5E3' EP06&EG06&EM06_AT_Commands_Manual 159 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual '4E3' '1E3' '1E4' '1E5' '1E6' '6E8' Integer type, indicates whether SDUs detected as erroneous shall be delivered or not (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 No 1 Yes 2 No detect 3 Subscribed value Integer type, (0,1,2,…) indicates the targeted time between request to transfer an SDU at one SAP to its delivery at the other SAP, in milliseconds. If the parameter is set to ‘0’ the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed value 10~150 (value needs to be divisible by 10 without remainder) 200~950 (value needs to be divisible by 50 without remainder) 1000~4000 (value needs to be divisible by 100 without remainder) Integer type, (1,2,3,…) specifies the relative importance for handling of all SDUs belonging to the UMTS bearer compared to the SDUs of other bearers. If the parameter is set to ‘0’ the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed 1 Priority level 1 2 Priority level 2 3 Priority level 3 Integer type, specifies characteristics of the source of the submitted SDUs for a PDP context. 0 Characteristics of SDUs are unknown 1 Characteristics of SDUs corresponds to a speech source Integer type, indicates signaling content of submitted SDUs for a PDP context. 0 PDP context is not optimized for signaling 1 PDP context is optimized for signaling 10.7. AT+CGACT Activate or Deactivate PDP Contexts The Write Command is used to activate or deactivate the specified PDP context(s). After the command has been completed, the MT remains in V.250 command state. If any PDP context is already in the requested state, the state for that context remains unchanged. If the MT is not PS attached when the EP06&EG06&EM06_AT_Commands_Manual 160 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual activation form of the command is executed, the MT first performs a PS attach and then attempts to activate the specified contexts. If no s specify the activation/deactivation form of the command, it will activate or deactivate all defined contexts. AT+CGACT Activate or Deactivate PDP Contexts Test Command AT+CGACT=? Response +CGACT: (list of supported s) Read Command AT+CGACT? OK Response +CGACT: ,[] … Write Command AT+CGACT=, OK Response OK Or NO CARRIER Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 150s, determined by network. Parameter Indicates the state of PDP context activation 0 Deactivated 1 Activated Other values are reserved and will result in an ERROR response to the Write Command A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) Example AT+CGDCONT=4,'IP','UNINET' OK AT+CGACT=1,4 OK AT+CGACT? +CGACT: 1,1 +CGACT: 2,0 //Define a PDP context //Activated the PDP //Query the current PDP context state EP06&EG06&EM06_AT_Commands_Manual 161 / 240 +CGACT: 3,0 +CGACT: 4,1 OK AT+CGACT=0,4 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Deactivated the PDP 10.8. AT+CGDATA Enter Data State The Write Command causes the MT to perform whatever actions that are necessary to establish communication between the TE and the network using one or more packet domain PDP types. This may include per-forming a PS attach and one or more PDP context activations. Commands following the AT+CGDATA command in the AT command line will not be processed by the MT. If the parameter value is unacceptable to the MT, the MT shall return an ERROR or +CME ERROR response. Otherwise, the MT issues the intermediate result code CONNECT and enters V.250 online data state. After data transfer is completed, and the layer 2 protocol termination procedure has been completed successfully, the command state is reentered and the MT returns the final result code OK. AT+CGDATA Enter Data State Test Command AT+CGDATA=? Response +CGDATA: (list of supported s) Write Command AT+CGDATA=, OK Response CONNECT Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A string parameter that indicates the layer 2 protocol to be used between the TE and MT: PPP (Point to Point protocol) for a PDP such as IP Other values are not supported and will result in an ERROR response to the execution command EP06&EG06&EM06_AT_Commands_Manual 162 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) 10.9. AT+CGPADDR Show PDP Address The Write Command returns a list of PDP addresses for the specified context identifiers. If no is specified, the addresses for all defined contexts are returned. AT+CGPADDR Show PDP Address Test Command AT+CGPADDR=? Response +CGPADDR: (list of defined s) Write Command AT+CGPADDR[=[,[,…]]] OK Response +CGPADDR: , … Maximum Response Time Reference 3GPP TS 27.007 OK Or ERROR 300ms Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) A string that identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by the AT+CGDCONT command when the context was defined. For a dynamic address it will be the one assigned during the last PDP context activation that used the context definition referred to by . is omitted if none is available Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 //Define a PDP context //Activated the PDP //Show the PDP address EP06&EG06&EM06_AT_Commands_Manual 163 / 240 +CGPADDR: 1,'10.76.51.180' OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 10.10. AT+CGCLASS GPRS Mobile Station Class The command is used to set the MT to operate according to the specified mode of operation, see 3GPP TS 23.060. AT+CGCLASS GPRS Mobile Station Class Test Command AT+CGCLASS=? Response +CGCLASS: (list of supported s) Read Command AT+CGCLASS? OK Response +CGCLASS: Write Command AT+CGCLASS= OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A string parameter which indicates the GPRS mobile class (Functionality in descending order) 'A' Class A EP06&EG06&EM06_AT_Commands_Manual 164 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 10.11. AT+CGREG Network Registration Status The command queries the network registration status and controls the presentation of an unsolicited result code +CGREG: when =1 and there is a change in the MT’s GPRS network registration status in GERAN/UTRAN, or unsolicited result code +CGREG: [,[],[],[],[]] when =2 and there is a change of the network cell in GERAN/UTRAN. AT+CGREG Network Registration Status Test Command AT+CGREG=? Response +CGREG: (list of supported s) Read Command AT+CGREG? OK Response +CGREG: ,[,,[,]] Write Command AT+CGREG[=] Maximum Response Time Reference 3GPP TS 27.007 OK Response OK Or ERROR 300ms Parameter 0 1 2 0 1 2 3 Disable network registration unsolicited result code Enable network registration unsolicited result code +CGREG: Enable network registration and location information unsolicited result code +CGREG: [,,[,]] Not registered, MT is not currently searching an operator to register to. The UE is in GMM state GMM-NULL or GMM-DEREGISTERED-INITIATED. The GPRS service is disabled; the UE is allowed to attach for GPRS if requested by the user. Registered, home network. The UE is in GMM state GMM-REGISTERED or GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED on the home PLMN. Not registered, but MT is currently trying to attach or searching an operator to register to. The UE is in GMM state GMM-DEREGISTERED or GMM-REGISTERED-INITIATED. The GPRS service is enabled, but an allowable PLMN is currently not available. The UE will start a GPRS attach as soon as an allowable PLMN is available. Registration denied. The UE is in GMM state GMM-NULL. The GPRS service is disabled; and the UE is not allowed to attach for GPRS if requested by the user. EP06&EG06&EM06_AT_Commands_Manual 165 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4 Unknown 5 Registered, roaming String type, two bytes location area code in hexadecimal format (e.g. '00C3' equals 195 in decimal) String type. 28-bit (UMTS/LTE) cell ID in hexadecimal format Access technology selected 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN Example AT+CGREG=2 OK AT+CGATT=0 OK +CGREG: 2 AT+CGATT=1 OK +CGREG: 1,'D504','80428B5',7 10.12. AT+CGEREP Packet Domain Event Reporting The Write Command enables or disables sending of unsolicited result codes +CGEV: XXX from MT to TE in the case of certain events occurring in the Packet Domain MT or the network. controls the processing of unsolicited result codes specified within this command. controls the effect on buffered codes when 1 or 2 is entered. AT+CGEREP Packet Domain Event Reporting Test Command AT+CGEREP=? Response +CGEREP: (list of supported s),(list of supported s) Read Command AT+CGEREP? OK Response +CGEREP: , OK EP06&EG06&EM06_AT_Commands_Manual 166 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Write Command AT+CGEREP=mode[,] Execution Command AT+CGEREP Maximum Response Time Reference 3GPP TS 27.007 Response OK Or ERROR Response OK 300ms Parameter 0 1 2 0 1 Buffer unsolicited result codes in the MT; if MT result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE. Discard unsolicited result codes when MT-TE link is reserved (e.g. in on-line data mode); otherwise forward them directly to the TE. Buffer unsolicited result codes in the MT when MT-TE link is reserved (e.g. in on-line data mode) and flush them to the TE when MT-TE link becomes available; otherwise forward them directly to the TE. MT buffer of unsolicited result codes defined within this command is cleared when 1 or 2 is entered. MT buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is entered (OK response shall be given before flushing the codes). NOTE The unsolicited result codes and the corresponding events are defined as follows: 1. +CGEV: REJECT , : A network request for PDP context activation occurred when the MT was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. Note: This event is not applicable for EPS. 2. +CGEV: NW REACT , , []: The network has requested a context reactivation. The used to reactivate the context is provided if known to the MT. Note: This event is not applicable for EPS. 3. +CGEV: NW DEACT , , []: The network has forced a context deactivation. The used to activate the context is provided if known to the MT. 4. +CGEV: ME DEACT , , []: The mobile equipment has forced a context deactivation. The used to activate the context is provided if known to the MT. 5. +CGEV: NW DETACH: The network has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 6. +CGEV: ME DETACH: The mobile equipment has forced a Packet Domain detach. This implies that EP06&EG06&EM06_AT_Commands_Manual 167 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual all active contexts have been deactivated. These are not reported separately. 7. +CGEV: NW CLASS : The network has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 8. +CGEV: ME CLASS : The mobile equipment has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 9. +CGEV: PDN ACT : Activated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. 10. +CGEV: PDN DEACT : Deactivated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. Example AT+CGEREP=? //Test command +CGEREP: (0-2),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK AT+CGEREP=2,1 OK AT+CGACT=1,2 OK //Activated a context +CGEV: PDN ACT2 AT+CGACT=0,2 //Deactivated a context. OK +CGEV: PDN DEACT2 10.13. AT+CGSMS Select Service for MO SMS Messages The command specifies the service or service preference that the MT will use to send MO (mobile originated) SMS messages. AT+CGSMS Select Service for MO SMS Messages Test Command AT+CGSMS=? Response +CGSMS: (list of currently available s) OK EP06&EG06&EM06_AT_Commands_Manual 168 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Read Command AT+CGSMS? Write Command AT+CGSMS= Maximum Response Time Reference 3GPP TS 27.007 Response +CGSMS: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A numeric parameter which indicates the service or service preference to be used 0 GPRS 1 Circuit switch 2 GPRS preferred (use circuit switched if GPRS not available) 3 Circuit switch preferred (use GPRS if circuit switched not available) 10.14. AT+CEREG EPS Network Registration Status The command queries the network registration status and controls the presentation of an unsolicited result code +CEREG: when =1 and there is a change in the MT’s EPS network registration status in E-UTRAN, or unsolicited result code +CEREG: [,[],[],[]] when =2 and there is a change of the network cell in E-UTRAN. AT+CEREG EPS Network Registration Status Test Command AT+CEREG=? Response +CEREG: (list of supported s) Read Command AT+CEREG? OK Response +CEREG: ,[,,[,]] Write Command AT+CEREG[=] OK Response OK Or EP06&EG06&EM06_AT_Commands_Manual 169 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 ERROR 300ms Parameter 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CEREG: 2 Enable network registration and location information unsolicited result code +CEREG: [,,[,]] 0 Not registered, MT is not currently searching an operator to register to 1 Registered, home network 2 Not registered, but MT is currently trying to attach or searching an operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type, two-byte tracking area code in hexadecimal format String type, 28-bit(E-UTRAN) cell ID in hexadecimal format. Access technology selected 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 10.15. AT+QGDCNT Packet Data Counter The command allows the application to check how much bytes are sent to or received by the module. AT+QGDCNT Packet Data Counter Test Command AT+QGDCNT=? Response +QGDCNT: (0,1) Read Command AT+QGDCNT? OK Response +QGDCNT: , EP06&EG06&EM06_AT_Commands_Manual 170 / 240 Write Command AT+QGDCNT= Maximum Response Time Reference LTE-A Module Series EP06&EG06&EM06 AT Commands Manual OK Response OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A numeric parameter. The operation about data counter 0 Reset the data counter 1 Save the results of data counter to NV. If results need to be automatically saved, please refer to AT+QAUGDCNT command. A numeric parameter. The amount of sent bytes. A numeric parameter. The amount of received bytes. NOTE When module is powered on, and will be loaded from results of data counter in NV. The default result in NV is 0. Example AT+QGDCNT=? +QGDCNT: (0,1) //Test command OK AT+QGDCNT? //Query the current bytes sent and received +QGDCNT: 3832,4618 OK AT+QGDCNT=1 OK AT+QGDCNT=0 OK //Save the results to NV //Reset counter EP06&EG06&EM06_AT_Commands_Manual 171 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 10.16. AT+QAUGDCNT Auto Save Packet Data Counter The command allows AT+QGDCNT to save results to NV automatically. AT+QAUGDCNT Auto Save Packet Data Counter Test Command AT+QAUGDCNT=? Response +QAUGDCNT: (0,(30-65535)) Read Command AT+ QAUGDCNT? OK Response +QAUGDCNT: Write Command AT+QAUGDCNT= OK Response OK Or ERROR Maximum Response Time Reference If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A numeric parameter. Default value is 0. The parameter is the time-interval for command AT+QGDCNT to save results to NV automatically. If it is set to 0, auto-save feature would be disabled. Unit is second. NOTE The configuration would not be saved into NV. Example AT+QAUGDCNT=? //Test command +QAUGDCNT: (0,30-65535) OK AT+QAUGDCNT=35 //Set EP06&EG06&EM06_AT_Commands_Manual 172 / 240 OK AT+QAUGDCNT? +QAUGDCNT: 35 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Query the interval of auto-save 10.17. AT+QMTUINFO Query MTU Value The command is used to query MTU (Maximum Transmission Unit) value from the network. AT+QMTUINFO Query MTU Value Test Command AT+QMTUINFO=? Read Command AT+QMTUINFO[?] Response OK Response +QMTUINFO:,, OK Reference If no network was active: OK Parameter PDP context identifier, a numeric parameter which specifies a particular PDP context. MTU value of IPv4 iface. MTU value of IPv6 iface. NOTES 1. If only IPV4 iface was activated by the network, the was replaced by '-'. 2. If just IPV6 iface was activated by the network, the was replaced by '-'. Example AT+QMTUINFO=? OK AT+QMTUINFO +QMTUINFO: 1,1460,1460 +QMTUINFO: 2,1460,- EP06&EG06&EM06_AT_Commands_Manual 173 / 240 +QMTUINFO: 3,- ,1460 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 10.18. AT$QCRMCALL Start or Stop a RmNet Call The command triggers an RmNet call based on parameter which is typically a start or stop of an RmNet call. AT$QCRMCALL Start or Stop a RmNet Call Test Command AT$QCRMCALL=? Response $QCRMCALL: (0-1),(1-8),(1-3),(1-2),(1-24,100-179),, Read Command AT$QCRMCALL? OK Response If a RmNet call has been established: $QCRMCALL :, OK Write Command AT$QCRMCALL=,[,[,[,]] If establishment of RmNet call failed: OK Response OK Or ERROR Reference Parameter Start or stop a RmNet call 0 Stop a RmNet call 1 Start a RmNet call Currently this parameter only can be set to 1. IP types 1 Call type is IPv4 2 Call type is IPv6 3 Call type is IPv4v6 Technology type preferred 2 3GPP (WCDMA/LTE) Profile number. Range is 1-24. EP06&EG06&EM06_AT_Commands_Manual 174 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Call types V4 IPv4 call V6 IPv6 call Example AT$QCRMCALL=? //Test command $QCRMCALL: (0-1),( 1,2,3,4,5,6,7,8),(1-3),(1-2),(1-24,100-179),, OK AT$QCRMCALL=1,1,1,2,1 $QCRMCALL: 1,V4 //Start an IPv4 RmNet call OK AT$QCRMCALL? $QCRMCALL: 1,V4 //Query the current RmNet call OK 10.19. AT+QNETDEVSTATUS Query RmNet Device Status The command can query RmNet device status. AT+QNETDEVSTATUS Query RmNet Device Status Test Command AT+QNETDEVSTATUS=? Response +QNETDEVSTATUS:(0,1) Read Command AT+QNETDEVSTATUS? OK Response If a RmNet call exists, , and will be included. +QNETDEVSTATUS: [,[,[,]]] OK Or +QNETDEVSTATUS: Execution Command AT+QNETDEVSTATUS= OK Response OK Or ERROR EP06&EG06&EM06_AT_Commands_Manual 175 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Reference Parameter URC of RmNet device status 0 Disable RmNet device status URC 1 Enable RmNet device status URC RmNet call status 0 A RmNet call is disconnected 1 A RmNet call is ready and MCU can get IP addresses by DHCP or QMI 2 A RmNet call is connected IP type 4 Call type is IPv4 6 Call type is IPv6 RmNet call instance. is always 1 in general. NOTE When the module gets IP addresses from network successfully, will change to 1 and the module will keep IP addresses for 2 minutes to wait for MCU to request IP addresses from the module by DHCP or QMI. Ant the module will disconnect a RmNet call if IP addresses requests are not be received by the module in 2 minutes. Example AT+QNETDEVSTATUS=? +QNETDEVSTATUS:(0,1) OK AT+QNETDEVSTATUS? +QNETDEVSTATUS: 0 OK AT+QNETDEVSTATUS=1 OK AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1 OK AT$QCRMCALL=1,1,1,2,1 $QCRMCALL: 1,V4 OK //Test command //Query command //Enable RmNet device status URC //Query command //Start an IPv4 RmNet call EP06&EG06&EM06_AT_Commands_Manual 176 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual +QNETDEVSTATUS: 1,1,4,1 +QNETDEVSTATUS: 1,2,4,1 AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1,2,4,1 OK AT$QCRMCALL=0,1,1,2,1 OK +QNETDEVSTATUS: 1,0,4,1 AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1 OK //RmNet call is ready //MCU get IP addresses from the module //Query command //Stop an IPv4 RmNet call //The module reports URC of RmNet call disconnection //Query command EP06&EG06&EM06_AT_Commands_Manual 177 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 11 Supplementary Service Commands 11.1. AT+CCFC Call Forwarding Number and Conditions Control The command allows control of the call forwarding supplementary service according to 3GPP TS 22.082. Registration, erasure, activation, deactivation and status query are supported. AT+CCFC Call Forwarding Number and Conditions Control Test Command AT+CCFC=? Response +CCFC: (list of supported s) Write Command AT+CCFC=,[,[,[,[,[,[,time]]]]]] OK Response TA controls the call forwarding supplementary service. Registration, erasure, activation, deactivation, and status query are supported. Only and should be entered with mode (0-2,4) If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully (only in connection with 0-3): For registered call forwarding numbers: +CCFC: ,[,,[,,[,]]] [ ... OK If no call forwarding numbers are registered (and therefore all classes are inactive): +CCFC: , EP06&EG06&EM06_AT_Commands_Manual 178 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 OK where =0 and =15 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All call forwarding (0-3) 5 All conditional call forwarding (1-3) 0 Disable 1 Enable 2 Query status 3 Registration 4 Erasure Phone number in string type of forwarding address in format specified by Type of address in integer format; default value is 145 when dialing string includes international access code character '+'; otherwise 129 String type sub-address of format specified by Type of sub-address in integer 1 Voice 2 Data 4 Fax 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization 1…30 When 'no reply' (=no reply) is enabled or queried, this gives the time in seconds to wait before call is forwarded; default value is 20 0 Not active 1 Active EP06&EG06&EM06_AT_Commands_Manual 179 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Example AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,255 OK //Register the destination number for unconditional call forwarding (CFU) //Query the status of CFU without specifying //Erase the registered CFU destination number //Query the status, no destination number 11.2. AT+CCWA Call Waiting Control The command allows control of the call waiting supplementary service according to 3GPP TS 22.083. Activation, deactivation and status query are supported. AT+CCWA Call Waiting Control Test Command AT+CCWA=? Response +CCWA: (list of supported s) Read Command AT+CCWA? OK Response +CCWA: Write Command AT+CCWA[=][,[,]] OK Response TA controls the call waiting supplementary service. Activation, deactivation and status query are supported. If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully: +CCWA: ,[ ... OK EP06&EG06&EM06_AT_Commands_Manual 180 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 Disable presentation of an unsolicited result code 1 Enable presentation of an unsolicited result code When parameter is not given, network is not interrogated 0 Disable 1 Enable 2 Query status A sum of integers, each integer represents a class of information 1 Voice (telephony) 2 Data (bearer service) 4 FAX (facsimile) 16 Data circuit sync 32 Data circuit async 0 Disable 1 Enable Phone number in string type of calling address in format specified by Type of address octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Optional string type alphanumeric representation of corresponding to the entry found in phone book NOTES 1. =0 should be returned only if service is not active for any i.e. +CCWA: 0, 7 will be returned in this case. 2. When =2, all active call waiting classes will be reported. In this mode the command is aborted by pressing any key. 3. Unsolicited result code: When the presentation call waiting at the TA is enabled (and call waiting is enabled) and a terminating call set up during an established call, an unsolicited result code is returned: +CCWA: ,,[,] EP06&EG06&EM06_AT_Commands_Manual 181 / 240 Example AT+CCWA=1,1 OK ATD10086; OK +CCWA: '02154450293',129,1 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Enable presentation of an unsolicited result code //Establish a call //Indication of a call that has been waiting 11.3. AT+CHLD Call Related Supplementary Services The command allows the control of the following call related services: ⚫ A call can be temporarily disconnected from the MT but the connection is retained by the network; ⚫ Multiparty conversation (conference calls); ⚫ The served subscriber who has two calls (one held and the other either active or alerting) can connect the other parties and release the served subscriber’s own connection. Calls can be put on hold, recovered, released and added to a conversation, and transferred similarly as defined in 3GPP TS 22.030. This is based on the GSM/UMTS supplementary services HOLD (Call Hold; refer to 3GPP TS 22.083 clause 2), MPTY (MultiParty; refer to 3GPP TS 22.084) and ECT (Explicit Call Transfer; refer to 3GPP TS 22.091). The interaction of this command with other commands based on other GSM/UMTS supplementary services is described in the GSM/UMTS standards. Call Hold, MultiParty and Explicit Call Transfer are only applicable to teleservice 11. AT+CHLD Call Related Supplementary Services Test Command AT+CHLD=? Response +CHLD: (list of supported s) Write Command AT+CHLD=[] OK Response TA controls the supplementary services call hold, multiparty and explicit call transfer. Calls can be put on hold, recovered, released, added to conversation and transferred. OK Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms EP06&EG06&EM06_AT_Commands_Manual 182 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Reference 3GPP TS 27.007 Parameter 0 1 1X 2 2X 3 4 Terminate all held calls or UDUB (User Determined User Busy) for a waiting call. If a call is waiting, terminate the waiting call. Otherwise, terminate all held calls (if any) Terminate all active calls (if any) and accept the other call (waiting call or held call). Terminate the specific call number X (X=1-7) Place all active calls on hold (if any) and accept the other call (waiting call or held call) as the active call Place all active calls except call X (X=1-7) on hold Add the held call to the active calls Connects the two calls and disconnects the subscriber from both calls (ECT) Example ATD10086; OK +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129 +CLCC: 2,1,0,0,0,'02154450293',129 OK AT+CHLD=21 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 +CLCC: 2,1,1,0,1,'02154450293',129 OK AT+CHLD=3 OK AT+CLCC //Establish a call //Indication of a call that has been waiting //Place the active call on hold and accept the waiting call as the active call //The first call on hold //The second call be active //Place the active call except call X=1 on hold //The first call be active //The second call on hold //Add a held call to the active calls in order to set up a conference (multiparty) call EP06&EG06&EM06_AT_Commands_Manual 183 / 240 +CLCC: 1,0,0,0,1,'10086',129 +CLCC: 2,1,0,0,1,'02154450293',129 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 11.4. AT+CLIP Calling Line Identification Presentation The command refers to the GSM/UMTS supplementary service CLIP (Calling Line Identification Presentation) that enables a called subscriber to get the calling line identity (CLI) of the calling party when receiving a mobile terminated call. AT+CLIP Calling Line Identification Presentation Test Command AT+CLIP=? Response +CLIP: (list of supported s) Read Command AT+CLIP? OK Response +CLIP: , Write Command AT+CLIP= OK Response TA enables or disables the presentation of the calling line identity (CLI) at the TE. It has no effect on the execution of the supplementary service CLIP in the network. OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 15s, determined by network. Parameter 0 Suppress unsolicited result codes 1 Display unsolicited result codes 0 CLIP not provisioned 1 CLIP provisioned 2 Unknown Phone number in string type of calling address in format specified by EP06&EG06&EM06_AT_Commands_Manual 184 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual String type sub-address of format specified by Type of sub-address octet in integer format (refer to 3GPP TS 24.008 [8] subclause 10.5.4.8) Type of address octet in integer format; 129 Unknown type (IDSN format) 145 International number type (ISDN format) 161 National number String type alphanumeric representation of corresponding to the entry found in phone book 0 CLI valid 1 CLI has been withheld by the originator 2 CLI is not available due to interworking problems or limitations of originating network NOTE When the presentation of the CLIP at the TE is enabled (and calling subscriber allows), an unsolicited result code is returned after every RING (or +CRING: ) at a mobile terminating call: +CLIP: ,,[subaddr],[satype],[], Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,,,'QUECTEL',0 11.5. AT+CLIR Calling Line Identification Restriction The command refers to the CLIR supplementary service (Calling Line Identification Restriction) according to 3GPP TS 22.081 and the OIR supplementary service (Originating Identification Restriction) according to 3GPP TS 24.607 that allows a calling subscriber to enable or disable the presentation of the calling line identity (CLI) to the called party when originating a call. EP06&EG06&EM06_AT_Commands_Manual 185 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+CLIR Calling Line Identification Restriction Test Command AT+CLIR=? Response +CLIR: (list of supported s) Read Command AT+CLIR? OK Response +CLIR: , Write Command AT+CLIR=[] OK Response TA restricts or enables the presentation of the calling line identity (CLI) to the called party when originating a call. The command overrides the CLIR subscription (default is restricted or allowed) when temporary mode is provisioned as a default adjustment for all following outgoing calls. This adjustment can be revoked by using the opposite command. OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 15s, determined by network. Parameter Parameter sets the adjustment for outgoing calls 0 Presentation indicator is used according to the subscription of the CLIR service 1 CLIR invocation 2 CLIR suppression Parameter shows the subscriber CLIR service status in the network 0 CLIR not provisioned 1 CLIR provisioned in permanent mode 2 Unknown (e.g. no network, etc.) 3 CLIR temporary mode presentation restricted 4 CLIR temporary mode presentation allowed EP06&EG06&EM06_AT_Commands_Manual 186 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 11.6. AT+COLP Connected Line Identification Presentation The command refers to the GSM/UMTS supplementary service COLP (Connected Line Identification Presentation) that enables a calling subscriber to get the connected line identity (COL) of the called party after setting up a mobile originated call. The command enables or disables the presentation of the COL at the TE. It has no effect on the execution of the supplementary service COLR in the network. AT+COLP Connected Line Identification Presentation Test Command AT+COLP=? Response +COLP: (list of supported s) Read Command AT+COLP? OK Response +COLP: , Write Command AT+COLP=[] OK Response TA enables or disables the presentation of the COL (Connected Line) at the TE for a mobile originating a call. It has no effect on the execution of the supplementary service COLR in the network. Maximum Response Time Reference 3GPP TS 27.007 Intermediate result code is returned from TA to TE before any +CR or V.25ter responses. OK 15s, determined by network. Parameter Parameter sets/shows the result code presentation status in the TA 0 Disable 1 Enable Parameter shows the subscriber COLP service status in the network 0 COLP not provisioned 1 COLP provisioned 2 Unknown (e.g. no network, etc.) Phone number in string type, format specified by Type of address octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format) EP06&EG06&EM06_AT_Commands_Manual 187 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual String type sub-address of format specified by Type of sub-address octet in integer format (refer to 3GPP TS 24.008 subclause 10.5.4.8) Optional string type alphanumeric representation of corresponding to the entry found in phone book NOTE When enabled (and called subscriber allows), an intermediate result code is returned before any +CR or V.25ter responses: +COLP: ,,[],[],[] Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK 11.7. AT+CSSN Supplementary Service Notifications The command refers to supplementary service related network initiated notifications. The Write Command enables/disables the presentation of notification result codes from TA to TE. AT+CSSN Supplementary Service Notifications Test Command AT+CSSN=? Response +CSSN: (list of supported s),(list of supported s) Read Command AT+CSSN? OK Response +CSSN: , Write Command AT+CSSN=[,] OK Response OK Or ERROR EP06&EG06&EM06_AT_Commands_Manual 188 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Integer type, sets/shows the +CSSI intermediate result code presentation status to the TE 0 Disable 1 Enable Integer type, sets/shows the +CSSU unsolicited result code presentation status to the TE 0 Disable 1 Enable Integer type, it is manufacturer specific and supports the following codes: 0 Unconditional call forwarding is active 1 Some of the conditional call forwardings are active 2 Call has been forwarded 3 Waiting call is pending 5 Outgoing call is barred Integer type, it is manufacturer specific and supports the following codes: 0 The incoming call is a forwarded call 2 Call has been put on hold (during a voice call) 3 Call has been retrieved (during a voice call) 5 Held call was terminated by another party 10 Additional incoming call forwarded NOTES 1. When =1 and a supplementary service notification is received after a mobile originated call setup, the +CSSI intermediate result code is sent to TE before any other MO call setup result codes: +CSSI: 2. When =1 and a supplementary service notification is received during a mobile terminated call setup or during a call, the +CSSU unsolicited result code is sent to TE: +CSSU: EP06&EG06&EM06_AT_Commands_Manual 189 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 11.8. AT+CUSD Unstructured Supplementary Service Data The command allows control of the Unstructured Supplementary Service Data (USSD) according to 3GPP TS 22.090. Both network and mobile initiated operations are supported. Parameter is used to disable/enable the presentation of an unsolicited result code. The value =2 is used to cancel an ongoing USSD session. For an USSD response from the network, or a network initiated operation, the format is: +CUSD: [,,[]]. When is given, a mobile initiated USSD string or a response USSD string to a network initiated operation is sent to the network. The response USSD string from the network is returned in a subsequent +CUSD URC. AT+CUSD Unstructured Supplementary Service Data Test Command AT+CUSD=? Response +CUSD: (list of supported s) Read Command AT+CUSD? OK Response +CUSD: Write Command AT+CUSD=[[,[, ]]] OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 120s, determined by network. Parameter Integer type, sets/shows the result code presentation status to the TE 0 Disable the result code presentation to the TE 1 Enable the result code presentation to the TE 2 Cancel session (not applicable to Read Command response) Unstructured Supplementary Service Data (USSD) to be sent to the network. If this parameter is not given, network is not interrogated. Unstructured Supplementary Service Data (USSD) received from the network EP06&EG06&EM06_AT_Commands_Manual 190 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Integer type, 3GPP TS 23.038 Cell Broadcast Data Coding Scheme (default 15) USSD response from the network or the network initiated operation 0 No further user action required (network initiated USSD Notify, or no further information needed after mobile initiated operation) 1 Further user action required (network initiated USSD Request, or further information needed after mobile initiated operation) 2 USSD terminated by network 3 Another local client has responded 4 Operation not supported 5 Network time out EP06&EG06&EM06_AT_Commands_Manual 191 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12 Audio Commands 12.1. AT+CLVL Loudspeaker Volume Level Selection The command is used to select the volume of the internal loudspeaker of the MT. AT+CLVL Loudspeaker Volume Level Selection Test Command AT+CLVL=? Response +CLVL: (list of supporteds) Read Command AT+CLVL? OK Response +CLVL: Write Command AT+CLVL= OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Integer type, value (0-3-5) with manufacturer specific range (Smallest value represents the lowest sound level) NOTE This parameter will not be saved. EP06&EG06&EM06_AT_Commands_Manual 192 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.2. AT+CMUT Mute Control The command is used to enable/disable the uplink voice muting during a voice call. AT+CMUT Mute Control Test Command AT+CMUT=? Response +CMUT: (list of supporteds) Read Command AT+CMUT? OK Response +CMUT: Write Command AT+CMUT= OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 Mute OFF Mute ON NOTE This parameter will not be saved and must be set during the call. EP06&EG06&EM06_AT_Commands_Manual 193 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.3. AT+QAUDLOOP Enable/Disable Audio Loop Test This command is used to enable/disable audio loop test. AT+QAUDLOOP Enable/Disable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (0,1) Read Command AT+QAUDLOOP? OK Response +QAUDLOOP: Write Command AT+QAUDLOOP=[,] Maximum Response Time OK Response OK Or ERROR 300ms Parameter Numeric type; to enable or disable audio loop test 0 Disable audio loop test 1 Enable audio loop test NOTE This parameter will not be saved. 12.4. AT+VTS DTMF and Tone Generation The command is used to send ASCII characters which cause MSC to transmit DTMF tones to a remote subscriber. This command can only be operated in a voice call. EP06&EG06&EM06_AT_Commands_Manual 194 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (0-9,A-D,*,#),(0-255) Write Command AT+VTS=[,] OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: Depends on the length of and . Parameter ASCII characters in the set 0...9, #, *, A, B, C, D. The string should be enclosed in quotation marks ('...'). When sending multiple tones at a time, the time interval of two tones can be specified by AT+VTD. The maximal length of the string is 31 The duration of each tone in 1/10 seconds with tolerance. The value ranges from 0 to 255. If the duration is less than the minimum time specified by the network, the actual duration will be the network specified time. If this parameter is omitted, is specified by AT+VTD. Example ATD12345678900; OK AT+VTS='1' OK AT+VTS='1234567890A' OK //Dial //The remote caller can hear the DTMF tone //Send multiple tones at a time EP06&EG06&EM06_AT_Commands_Manual 195 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.5. AT+VTD Set Tone Duration The command sets the duration of DTMF tones. It can also set time interval of two tones when sending multiple tones at a time. AT+VTD Set Tone Duration Test Command AT+VTD=? Response +VTD: (0-255),(0-255) Read Command AT+VTD? OK Response +VTD: , Write Command AT+VTD=[,] OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter The duration tone in 1/10 seconds with tolerance. The value ranges from 0 to 255, and the default is 3. If the duration is less than the minimum time specified by the network, the actual duration will be network specified time. The time interval of two tones when sending multiple tones at a time by AT+VTS. The value ranges from 0 to 255, and the default is 0. NOTE These parameters will not be saved. EP06&EG06&EM06_AT_Commands_Manual 196 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.6. AT+QAUDMOD Set Audio Mode The command sets the audio mode required for the connected device. It will take effect at next sound activity. AT+QAUDMOD Set Audio Mode Test Command AT+QAUDMOD=? Response +QAUDMOD: (list of supported s) Read command AT+QAUDMOD? OK Response +QAUDMOD: Write Command AT+QAUDMOD= OK Response OK Or ERROR Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Numeric type, indicates the current configured audio mode 0 Echo canceller, noise suppressor, digital gain and calibration parameter for Handset 1 Echo canceller, noise suppressor, digital gain and calibration parameter for Headset 2 Echo canceller, noise suppressor, digital gain and calibration parameter for Speaker 3 Turn off all audio processing functions 12.7. AT+QDAI Digital Audio Interface Configuration The command is used to configure the digital audio interface. When =1, customers can define the PCM formats by themselves. In the following conditions, the module can be used directly with default settings (master mode, short-synchronization, 2048K clock frequency, 16-bit liner data format, 8K sampling rate). EP06&EG06&EM06_AT_Commands_Manual 197 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual ⚫ When =2, and the external codec chip linked with PCM interface is the NAU8814 model and configurable through the I2C ⚫ when =3, and the external codec chip linked with PCM interface is the ALC5616 model and configurable through the I2C ⚫ when =5 and the external codec chip linked with PCM interface is the TLV320AIC3104 model and configurable through the I2C AT+QDAI Digital Audio Interface Configuration Test Command AT+QDAI=? Response +QDAI: (list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ) Read Command AT+QDAI? OK Response +QDAI: [,,,,,,,,] Write Command AT+QDAI=[,,,[,[,[,,[,]]]]] OK Response OK Or ERROR Maximum Response Time 300ms Reference Quectel Parameter 1 Digital PCM output (customer defined) 2 Analog output (for audio codec NAU8814) 3 Analog output (for audio codec ALC5616) 5 Analog output (for default audio codec TLV320AIC3104) 0 Master mode 1 Slave mode 0 Primary mode (short-synchronization) 1 Auxiliary mode (long-synchronization) Clock frequency 0 128K 1 256K EP06&EG06&EM06_AT_Commands_Manual 198 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 2 512K 3 1024K 4 2048K 5 4096K Data format 0 16-bit linear 0 8K 1 16K 1 Number of slots Slot mapping value. The range is 1-16. Slot mapping value. The range is 2-16. NOTES 1. The parameter settings will be saved to NV immediately by default, and will take effect after the module is reset. 2. 4096K clock frequency is only applicable for 16K sampling rate. 3. 128K clock frequency is not supported. 4. Bit per frame=/. For example, if is 2048K and is 8K, then bit per frame is 256. Bit per frame should be greater than 16. 5. When slave mode is selected, master and synchronization clock should be provided for the module. 6. When a recommended codec is selected and 16K sampling rate is desired, please input . Currently only ALC5616 supports 16K (AT+QDAI=3,0,0,5,0,1,1,1). Example AT+QDAI=? //Query the range. +QDAI: (1-3,5),(0,1),(0,1),(0-5),(0-2),(0,1),(1-2),(1-16),(2-16) OK AT+QDAI? +QDAI: 1,0,0,4,0,0,1,1 //Query the current interface configuration. OK AT+QDAI=1,1,0,4,0,0,1,1 //Set AUX PCM interface to slave, short-synchronization, 8K sample and 2048K BCLK. OK Configure one slot AT+QDAI=1,0,0,4,0,1,1,1 OK Configure two slots EP06&EG06&EM06_AT_Commands_Manual 199 / 240 AT+QDAI=1,0,0,4,0,1,2,1,3 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.8. AT+QEEC Set Echo Cancellation Parameters The command is used to set echo cancellation parameters. AT+QEEC Set Echo Cancellation Parameters Test Command AT+QEEC=? Response +QEEC: (0-49),(0-65535) Read Command AT+QEEC? OK Response +QEEC: , ... Write Command AT+QEEC=, OK Response OK Or ERROR Parameter Numeric type, indicates the parameter’s index. Range: 0-49 Numeric type, indicates the parameter’s value. Range: 0-65535 NOTE These parameters will not be saved. Example AT+QEEC=? //Query the range. +QEEC: (0-49),(0-65535) OK EP06&EG06&EM06_AT_Commands_Manual 200 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+QEEC=6,1234 //Set the value of index 6 to 1234. OK 12.9. AT+QSIDET Set the Side Tone Gain in Current Mode The command is used to set the side tone gain value in current mode. It will take effect at next sound activity. AT+QSIDET Set the Side Tone Gain in Current Mode Test Command AT+QSIDET=? Response +QSIDET: (list of supported s) Read Command AT+QSIDET? OK Response +QSIDET: Write Command AT+QSIDET= Maximum Response Time Reference Quectel OK Response OK Or ERROR 300ms Parameter Numeric type, indicates the configured side tone gain in current mode Range: 0-65535. Default value might be different in different audio modes. NOTE This parameter will not be saved. EP06&EG06&EM06_AT_Commands_Manual 201 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.10. AT+QMIC Set Uplink Gains of Microphone The command is used to set the uplink gains of microphone. AT+QMIC Set Uplink Gains of Microphone Test Command AT+QMIC=? Response +QMIC: (0-65535),(0-65535) Read Command AT+QMIC? OK Response +QMIC: , Write Command AT+QMIC=[,] Maximum Response Time OK Response OK Or ERROR 300ms Parameter Numeric type, indicates uplink codec gain and the range is 0-65535. The default value might be different in different audio modes. Numeric type, indicates uplink digital gain and the range is 0-65535. The default value might be different in different audio modes. NOTE These parameters will not be saved. EP06&EG06&EM06_AT_Commands_Manual 202 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.11. AT+QRXGAIN Set Downlink Gains of RX The command is used to set RX digital gains to change the downlink volume. AT+QRXAGIN Set Downlink Gains of RX Test Command AT+QRXGAIN=? Response +QRXGAIN: (0-65535) Read Command AT+QRXGAIN? OK Response +QRXGAIN: Write Command AT+QRXGAIN= Maximum Response Time Reference OK Response OK Or ERROR 300ms Parameter Numeric type, indicates downlink digital gains. The range is 0-65535. The default value might be different in different audio modes. NOTE This parameter will not be saved. Example AT+QRXGAIN=? +QRXGAIN: (0-65535) OK AT+QRXGAIN? +QRXGAIN: 20577 //Test command. //Query the current value. The default value might be different in different audio modes. EP06&EG06&EM06_AT_Commands_Manual 203 / 240 OK AT+QRXGAIN=8192 OK AT+QRXGAIN? +QRXGAIN: 8192 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Set digital gain to 8192. //Query the current configuration. 12.12. AT+QIIC IIC Read & Write The command is used to configure the codec via IIC interface. AT+QIIC IIC Read & Write Test Command AT+QIIC=? Response +QIIC: (0,1),(0~0xFF),(0~0xFF),(1,2),(0~0xFFFF) Write Command AT+QIIC=,,,[,] OK If all configuration parameters are entered: Response OK If all configuration parameters are omitted: +QIIC: Maximum Response Time OK 300ms Parameter 0 1 0-0xFF 0-0xFF 1-2 0-0xFFFF Write command Read command 7-bit device address Register address Read/write bytes Data value NOTE These parameters will not be saved. EP06&EG06&EM06_AT_Commands_Manual 204 / 240 Example AT+QIIC=1,0x18,15,2,38 +QIIC: 0x0026 OK AT+QIIC=0,0x18,15,2,38 OK LTE-A Module Series EP06&EG06&EM06 AT Commands Manual //Read register value, slave address: 0x18, register address: 15, read two bytes. //Write register value, slave address: 0x18, register address: 15, write two bytes. 12.13. AT+QTONEDET Enable/Disable DTMF Detection The command is used to enable or disable DTMF detection. When this function is enabled, DTMF tones sent by other side will be detected, and it will be reported on the assigned serial port. AT+QTONEDET Enable/Disable DTMF Detection Test Command AT+QTONEDET=? Response +QTONEDET: (list of supported s) Read Command AT+QTONEDET? OK Response +QTONEDET: Write Command AT+QTONEDET= Maximum Response Time Reference Quectel OK Response OK Or ERROR 300ms Parameter Enable/disable DTMF detection 0 Disable 1 Enable EP06&EG06&EM06_AT_Commands_Manual 205 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual NOTES 1. This setting will take effect immediately. And it will revert to the default values after resetting the module. 2. DTMF characters - ASCII: DTMF 0 1 2 3 4 5 6 7 ASCII 48 49 50 51 52 53 54 55 DTMF 8 9 A B C D * # ASCII 56 57 65 66 67 68 42 35 12.14. AT+QLDTMF Play Local DTMF The command is used to play a local DTMF string, and the maximum length is 20 characters. It can be used to stop playing the DTMF string. AT+QLDTMF Play Local DTMF Test Command AT+QLDTMF=? Response +QLDTMF: (1-1000),(0-9,*,#,A-G ) OK Write Command AT+QLDTMF=,[,] Response OK If there is error related to ME functionality: +CME ERROR: Execute Command AT+QLDTMF Maximum Response Time After the DTMF string is completely played: +QLDTMF: 5 Response OK 300ms EP06&EG06&EM06_AT_Commands_Manual 206 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Parameter Numeric type, indicates every DTMF’s play time and mute time. The range is 1 -1000, the unit is 1/100 second when is set to 1, or 1/10 second when is not set. String type, maximum 20 DTMF strings, separated by comma. DTMF format: 0-9,*,#,A-G. The string should be enclosed in quotation marks ('...') 901 Audio unknown error 902 Audio invalid parameters 903 Audio operation not supported 904 Audio device busy NOTE These parameters will not be saved. Example AT+QLDTMF=? //Query the range. +QLDTMF: (1-1000),(0-9,*,#,A-G) OK AT+QLDTMF=2,'A,B,1,2,#' OK AT+QLDTMF OK //Play 'A,B,1,2,#' play time & mute time is 200ms. //Stop playing. 12.15. AT+QLTONE Play a Local Customized Tone The command is used to play a customized tone, use to indicate play time and to indicate mute time, and to indicate total time. AT+QLTONE Play a Local Customized Tone Test Command AT+QLTONE=? Response +QLTONE: (0,1),(100-4000),(0-1000),(0-1000),(0-15300000) OK Write Command Response AT+QLTONE=[,, OK ,, EP06&EG06&EM06_AT_Commands_Manual 207 / 240 ] Maximum Response Time Reference LTE-A Module Series EP06&EG06&EM06 AT Commands Manual If there is error related to ME functionality: +CME ERROR: After the tone is completely played: +QLTONE: 0 300ms Parameter 0 Stop playing 1 Start to play Tone’s frequency. The range is 100-4000, the unit is Hz. Tone’s play time on time. The range is 0-1000, the unit is ms. Tone’s mute time. The range is 0-1000, the unit is ms. Tone’s total time. The ranges is 0-15300000, the unit is ms 901 Audio unknown error 902 Audio invalid parameters 903 Audio operation not supported 904 Audio device busy NOTE These parameters will not be saved. Example AT+QLTONE=? //Query the range. +QLTONE: (0,1),(100-4000),(0-1000),(0-1000),(0-15300000) OK AT+QLTONE=1,1000,200,300,3000 OK //Play a 1000Hz tone, play time is 200ms and mute time is 300ms. Total time is 3000ms. +QLTONE:0 AT+QLTONE=0 OK //Stop playing. EP06&EG06&EM06_AT_Commands_Manual 208 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 12.16. AT+QAUDCFG Configure Audio Related Settings The command is used to query and configure audio related settings. AT+QAUDCFG Configure Audio Related Settings Test Command AT+QAUDCFG=? Response +QAUDCFG: 'voltedtmfcfg', (list of supported s) +QAUDCFG: 'toneswitch', (list of supported s) Maximum Response Time Reference OK 300ms 12.16.1. AT+QAUDCFG='voltedtmfcfg' Configure VoLTE DTMF Tone The command is used to set the duration and the volume of VoLTE DTMF tone for the module. If the duration and the volume have never been set or the duration is set to 0, the duration of VoLTE DTMF tone will be controlled by network. The default duration is 500ms and the default volume is 5000. AT+QAUDCFG='voltedtmfcfg' Configure VoLTE DTMF Tone Write Command AT+QAUDCFG='voltedtmfcfg'[,,] Response If and are omitted, return current configuration: +QAUDCFG: 'voltedtmfcfg',, OK If and are not omitted, set the duration and the volume: OK If there is any error: ERROR Parameter Integer type. Duration of VoLTE DTMF tone in 2.5ms per unit (that is, the value is incremented in multiplies of 2.5ms). If this value is set to 0, the duration will be controlled by the network, not exceeding the default value 200 (ie. 500ms). EP06&EG06&EM06_AT_Commands_Manual 209 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Range: 0-400 Integer type. Volume of VoLTE DTMF tone. If this value is not set before, it will be the default value 5000. Range: 0~9999 NOTES 1. The time interval between two DTMF tones of VoLTE will be a little bit longer than the duration. 2. These parameters will be saved. Example AT+QAUDCFG='voltedtmfcfg',40,5000 OK AT+QAUDCFG='voltedtmfcfg' +QCFG: 'voltedtmfcfg', 40,5000 OK //Set VoLTE DTMF tone duration as 100ms and volume as 5000. //Query the current configuration. 12.16.2. AT+QAUDCFG='toneswitch' Switch on/off Ring Tone The command is used to switch on/off the ring tone. AT+QAUDCFG='toneswitch' Switch on/off Ring Tone Write Command AT+QAUDCFG='toneswitch'[,] Response OK Or ERROR Parameter Switch of ring tone 0 Switch on the ring tone 1 Switch off the ring tone NOTE This parameter will not be saved. EP06&EG06&EM06_AT_Commands_Manual 210 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Example AT+QAUDCFG=? +QAUDCFG: 'tonevolume',(0-1) OK AT+QAUDCFG='tonevolume',1 OK AT+ QAUDCFG='toneswitch' +QAUDCFG: 1 OK //Query the range. //Switch off the ring tone. //Query the current on/ff status of ring tone. EP06&EG06&EM06_AT_Commands_Manual 211 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 13 Hardware Related Commands 13.1. AT+QPOWD Power off The command is used to shut down the module. The UE will return OK immediately when the command is executed. Then the UE deactivates the network. After it is completed, the UE outputs POWERED DOWN message and enters into the shutdown state. The maximum time for unregistering network is 60 seconds. The UE is not allowed to turn off the power before the module STATUS pin is set low or the URC POWERED DOWN is output to avoid data loss. AT+QPOWD Power off Test Command AT+QPOWD=? Response +QPOWD: (0,1) Execution Command AT+QPOWD=[] OK Response OK Maximum Response Time Reference POWERED DOWN 300ms Parameter 0 1 Immediately power down Normal power down EP06&EG06&EM06_AT_Commands_Manual 212 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 13.2. AT+CCLK Clock The command sets and queries the real time clock (RTC) of the module. The current setting is retained until the module is totally disconnected from the power supply. AT+CCLK Clock Test Command AT+CCLK=? Read Command AT+CCLK? Response OK Response +CCLK: Write Command AT+CCLK= OK Response OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter String type value, format is 'yy/MM/dd,hh:mm:ss±zz', indicating year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range -48...+56). E.g. May 6th, 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. Example AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //Query the local time EP06&EG06&EM06_AT_Commands_Manual 213 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 13.3. AT+CBC Battery Charge The command returns battery charge status and battery charge level of the MT. AT+CBC Battery Charge Test Command AT+CBC=? Response +CBC: (list of supported s),(list of supported s), Execution Command AT+CBC OK Response +CBC: ,, OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Battery charge status 0 ME is not charging 1 ME is charging 2 Charging has finished Battery charge level 0-100 Battery has 0-100 percent of capacity remaining vent Battery voltage (mV) EP06&EG06&EM06_AT_Commands_Manual 214 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 13.4. AT+QADC Read ADC Value The command is used to read the voltage value of ADC channel. AT+QADC Read ADC Value Test Command AT+QADC=? Response +QADC: (0,1) Read Command AT+QADC= OK Response +QADC: , Maximum Response Time OK 300ms Parameter Channel number of the ADC. 0 ADC Channel 0 1 ADC Channel 1 Indicate whether the ADC value is read successfully 0 Fail 1 Success The voltage of specified ADC channel. Unit is mV. 13.5. AT+QSCLK Enable/Disable Entering into Sleep Mode The command is used to control whether the module enters into sleep mode. When entering into sleep mode is enabled, DTR is pulled up and WAKEUP_IN is pulled up, the module can directly enter into sleep mode. If entering into sleep mode is enabled, DTR is pulled down and WAKEUP_IN is pulled down, there is a need to pull the DTR pin and the WAKEUP_IN pin up first, and then the module can enter into sleep mode. AT+QSCLK Enable/Disable Entering into Sleep Mode Test Command AT+QSCLK=? Response +QSCLK: (list of supported s) Read Command OK Response EP06&EG06&EM06_AT_Commands_Manual 215 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual AT+QSCLK? Write Command AT+QSCLK= Maximum Response Time Reference Quectel +QSCLK: OK Response OK 300ms Parameter 0 1 Disable slow clock Enable slow clock, it is controlled by DTR EP06&EG06&EM06_AT_Commands_Manual 216 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 14 Appendix 14.1. References Table 5: Related Documents SN Document Name [1] V.25ter [2] 3GPP TS 27.007 [3] 3GPP TS 27.005 Remark Serial asynchronous automatic dialing and control Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; AT command set for User Equipment (UE) Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; Use of Data Terminal Equipment – Data Circuit terminating Equipment (DTE-DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Table 6: Terms and Abbreviations Abbreviation AMR CSD DCD DCE DTE DTR ECT Description Adaptive Multi-Rate Circuit Switch Data Dynamic Content Delivery Data Communication Equipment Data Terminal Equipment Data Terminal Ready Explicit Call Transfer supplementary service EP06&EG06&EM06_AT_Commands_Manual 217 / 240 GPRS ME MS PDP PSC RTS/CTS TA TCP TE UDP UE NV LTE-A Module Series EP06&EG06&EM06 AT Commands Manual General Packet Radio Service Mobile Equipment Mobile Station Packet Data Protocol Primary Synchronization Code Request To Send/Clear To Send Terminal Adapter Transmission Control Protocol Terminal Equipment User Datagram Protocol User Equipment Non-Volatile Random Access Memory 14.2. Factory Default Settings Restorable with AT&F Table 7: Factory Default Settings Restorable with AT&F AT Command ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 Parameters Factory Defaults 1 0 0 13 10 8 2 EP06&EG06&EM06_AT_Commands_Manual 218 / 240 ATS7 ATS8 ATS10 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CBST AT+CMEE AT+CSCS AT+CSTA AT+CR AT+CRC AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+CVHU AT+CLIP LTE-A Module Series EP06&EG06&EM06 AT Commands Manual ,, ,,, ,,, ,, ,, ,,,, 0 2 15 1 4 1 1 0 0 0,0,1 1 'GSM' 129 0 0 0,1,1,1 0 17,167,0,0 0 0,'','' 'ME','ME','ME' 2,1,0,0,0 0 0 0 EP06&EG06&EM06_AT_Commands_Manual 219 / 240 AT+COLP AT+CLIR AT+CSSN AT+CTZR AT+CPBS AT+CGEREP AT+CEREG AT+CCWA AT+CUSD AT+CLVL AT+QAUDMOD AT+QAUDLOOP , LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 0 0 0 0 SM 0,0 0 0 0 3 0 0 14.3. AT Command Settings Storable with AT&W Table 8: AT Command Settings Storable with AT&W AT Command ATE ATQ ATS0 ATS7 ATS10 ATV ATX Parameters Display with AT&V Yes Yes Yes Yes Yes Yes Yes EP06&EG06&EM06_AT_Commands_Manual 220 / 240 AT&C AT&D AT+IPR AT+CREG AT+CGREG AT+CEREG AT+QSIMSTAT LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Yes Yes No No No No No 14.4. AT Command Settings Storable with ATZ Table 9: AT Command Settings Storable with ATZ AT Command ATE ATQ ATS0 ATS7 ATS10 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CEREG Parameters Factory Defaults 1 0 0 0 15 1 4 1 1 0 0 0 EP06&EG06&EM06_AT_Commands_Manual 221 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 14.5. Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. Table 10: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 10 11 12 13 14 15 16 17 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required (U)SIM failure (U)SIM busy (U)SIM wrong Incorrect password (U)SIM PIN2 required EP06&EG06&EM06_AT_Commands_Manual 222 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 18 (U)SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 14.6. Summary of CMS ERROR Codes Final result code +CMS ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. EP06&EG06&EM06_AT_Commands_Manual 223 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual values are mostly used by common message commands: Table 11: Different Coding Schemes of +CMS ERROR: Code of 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 331 332 Meaning ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode (U)SIM not inserted (U)SIM pin necessary PH (U)SIM pin necessary (U)SIM failure (U)SIM busy (U)SIM wrong (U)SIM PUK required (U)SIM PIN2 required (U)SIM PUK2 required Memory failure Invalid memory index Memory full SMSC address unknown No network Network timeout EP06&EG06&EM06_AT_Commands_Manual 224 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 500 Unknown 512 (U)SIM not ready 513 Message length exceeds 514 Invalid request parameters 515 ME storage failure 517 Invalid service mode 528 More message to send state error 529 MO SMS is not allowed 531 ME storage full 14.7. Summary of URC Table 12: Summary of URC Index URC Display Meaning Condition 1 +CREG: Indicate registration status of the ME AT+CREG=1 After cell neighborhood changing +CREG: [,,[,< shows whether the network has 2 AT+CREG=2 Act>]] currently indicated the registration of the ME, with location area code 3 +CGREG: Indicate network registration status of AT+CGREG=1 the ME +CGREG: [,,[, Indicate network registration and 4 AT+CGREG=2 ]] location information of the ME 5 +CTZV: Time zone reporting AT+CTZR=1 6 +CTZE: ,, Extended time zone reporting AT+CTZR=2 7 +CMTI: , New message is received, and saved See AT+CNMI to memory +CMT: [], output directly to TE (PDU mode) EP06&EG06&EM06_AT_Commands_Manual 225 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual +CMT: ,[], [,,,,,,,] +CBM: directly (PDU mode) +CBM: ,,,, +CDS: directly (PDU mode) +CDS: ,,[],[],,, directly to TE (Text mode) 14 +CDSI: , New message status report is See AT+CNMI received, and saved to memory ^HCDS: ,,, ,,,,, The presentation of the COL +COLP: ,,[],[],[] mobile originated call +CLIP: ,,[sub 17 addr],[satype],[], AT+CLIP=1 An incoming call is indicated to the 18 +CRING: TE with unsolicited result code AT+CRC=1 instead of the normal RING +CCWA: ,,[,] AT+CCWA=1,1 20 +CSSI: Shows the +CSSI intermediate result AT+CSSN=1 code presentation status to the TE 21 +CSSU: Shows the +CSSU unsolicited result AT+CSSN=,1 code presentation status to the TE +CUSD: [,,[< USSD response from the network, or 22 AT+CUSD=1 dcs>]] a network initiated operation 23 RDY ME initialization is successful N/A 25 +CFUN: 1 All function of the ME is available N/A 26 +CPIN: (U)SIM card pin state N/A 27 +QIND: SMS DONE SMS initialization finished N/A EP06&EG06&EM06_AT_Commands_Manual 226 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 28 +QIND: PB DONE Phonebook initialization finished N/A 29 POWERED DOWN Module power down AT+QPOWD +CGEV: REJECT , and was automatically rejected. +CGEV: NW REACT ,,[] reactivation AT+CGEREP=2,1 +CGEV: NW DEACT ,,[] deactivation +CGEV: ME DEACT ,,[] deactivation. AT+CGEREP=2,1 34 +CGEV: NW DETACH The network has forced a Packet AT+CGEREP=2,1 Domain detach. 35 +CGEV: ME DETACH The mobile equipment has forced a AT+CGEREP=2,1 Packet Domain detach. The network has forced a change of 36 +CGEV: NW CLASS AT+CGEREP=2,1 MS class. The mobile equipment has forced a 37 +CGEV: ME CLASS AT+CGEREP=2,1 change of MS class. 14.8. SMS Character Sets Conversions In 3GPP TS 23.038 DCS (Data Coding Scheme) defined three kinds of alphabets in SMS, GSM 7-bit default alphabet, 8 bit data and UCS2 (16-bit). AT+CSMP can set the DCS in text mode (AT+CMGF=1). In text mode, DCS (Data Coding Scheme) and AT+CSCS determine the way of SMS text input or output. Table 13: The Way of SMS Text Input or Output DCS GSM 7-bit GSM 7-bit GSM 7-bit AT+CSCS GSM IRA UCS2 The Way of SMS Text Input or Output Input or output GSM character sets. Input or output IRA character sets. Input: UE will convert IRA characters to GSM characters. Output: UE will convert GSM characters to IRA characters. Input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Input: UE will convert the UCS2 hex string to GSM characters. Output: UE will convert the GSM characters to UCS2 hex string. EP06&EG06&EM06_AT_Commands_Manual 227 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual UCS2 - 8-bit - Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. When DCS=GSM 7-bit, the input or output needs conversion. The detailed conversion tables are shown as below. Table 14: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') No. 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0A Submit 2A 3A 4A 5A 6A 7A B 0B Cancel 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F EP06&EG06&EM06_AT_Commands_Manual 228 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Table 15: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') No. 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B 0B 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 16: GSM Extended Characters No. 0 1 2 3 4 5 6 7 0 1B40 1 2 3 EP06&EG06&EM06_AT_Commands_Manual 229 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4 1B14 5 6 7 8 1B28 9 1B29 A B C 1B3C D 1B3D E 1B3E F 1B2F Table 17: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='IR) No. 0 1 2 3 4 5 6 7 0 20 20 30 00 50 20 70 1 20 20 21 31 41 51 61 71 2 20 20 22 32 42 52 62 72 3 20 20 23 33 43 53 63 73 4 20 20 02 34 44 54 64 74 5 20 20 25 35 45 55 65 75 6 20 20 26 36 46 56 66 76 7 20 20 27 37 47 57 67 77 8 backspace 20 28 38 48 58 68 78 9 20 20 29 39 49 59 69 79 EP06&EG06&EM06_AT_Commands_Manual 230 / 240 A 0A B 20 C 20 D 0D E 20 F 20 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Submit 2A 3A 4A 5A 6A 7A Cancel 2B 3B 4B 1B3C 6B 1B28 20 2C 3C 4C 1B2F 6C 1B40 20 2D 3D 4D 1B3E 6D 1B29 20 2E 3E 4E 1B14 6E 1B3D 20 2F 3F 4F 11 6F 20 Table 18: IRA Extended Characters No. A B C D E F 0 20 20 20 20 7F 20 1 40 20 20 5D 20 7D 2 20 20 20 20 20 08 3 01 20 20 20 20 20 4 24 20 5B 20 7B 20 5 03 20 0E 20 0F 20 6 20 20 1C 5C 1D 7C 7 5F 20 09 20 20 20 8 20 20 20 0B 04 0C 9 20 20 1F 20 05 06 A 20 20 20 20 20 20 B 20 20 20 20 20 20 C 20 20 20 5E 07 7E D 20 20 20 20 20 20 E 20 20 20 20 20 20 F 20 60 20 1E 20 20 EP06&EG06&EM06_AT_Commands_Manual 231 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual Table 19: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='IRA') No. 0 1 2 3 4 5 6 7 0 40 20 20 30 A1 50 BF 70 1 A3 5F 21 31 41 51 61 71 2 24 20 22 32 42 52 62 72 3 A5 20 23 33 43 53 63 73 4 E8 20 A4 34 44 54 64 74 5 E9 20 25 35 45 55 65 75 6 F9 20 26 36 46 56 66 76 7 EC 20 27 37 47 57 67 77 8 F2 20 28 38 48 58 68 78 9 C7 20 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B D8 2B 3B 4B C4 6B E4 C F8 C6 2C 3C 4C D6 6C F6 D 0D E6 2D 3D 4D D1 6D F1 E C5 DF 2E 3E 4E DC 6E FC F E5 C9 2F 3F 4F A7 6F E0 Table 20: GSM Extended Characters No. 0 1 2 3 4 5 6 7 0 7C 1 2 3 EP06&EG06&EM06_AT_Commands_Manual 232 / 240 LTE-A Module Series EP06&EG06&EM06 AT Commands Manual 4 5E 5 6 7 8 7B 9 7D A B C 5B D 7E E 5D F 5C Because the low 8-bit of UCS2 character is the same as the IRA character: ⚫ The conversion table of DCS=GSM 7-bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. ⚫ The conversion table of fmt=GSM 7-bit and AT+CSCS='GSM' is similar to AT+CSCS='GSM'. ⚫ The conversion table of fmt= GSM 7-bit and AT+CSCS='IRA' is similar to AT+CSCS='IRA'. ⚫ The conversion table of fmt=GSM 7-bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. The difference is the way of SMS text input or output. Please refer to Table 14 for more details. 14.9. Release Cause Text List of AT+CEER Table 21: Release Cause Text List of AT+CEER CS Internal Cause No cause information available (default) Phone is offline EP06&EG06&EM06_AT_Commands_Manual 233 / 240 No service available Network release, no reason given Received incoming call Client ended call UIM not present Access attempt already in progress Access failure, unknown source Concur service not supported by network No response received from network GPS call ended for user call SMS call ended for user call Data call ended for emergency call Rejected during redirect or handoff Lower-layer ended call Call origination request failed Client rejected incoming call Client rejected setup indication Network ended call No funds available No service available Full service not available Maximum packet calls exceeded Video connection lost Video protocol closed after setup Video protocol setup failure LTE-A Module Series EP06&EG06&EM06 AT Commands Manual EP06&EG06&EM06_AT_Commands_Manual 234 / 240 Internal error CS Network Cause Unassigned/unallocated number No route to destination Channel unacceptable Operator determined barring Normal call clearing User busy No user responding User alerting, no answer Call rejected Number changed Non selected user clearing Destination out of order Invalid/incomplete number Facility rejected Response to status enquiry Normal, unspecified No circuit/channel available Network out of order Temporary failure Switching equipment congestion Access information discarded Requested circuit/channel not available Resources unavailable, unspecified LTE-A Module Series EP06&EG06&EM06 AT Commands Manual EP06&EG06&EM06_AT_Commands_Manual 235 / 240 Quality of service unavailable Requested facility not subscribed Incoming calls barred within the CUG Bearer capability not authorized Bearer capability not available Service/option not available Bearer service not implemented ACM >= ACM max Requested facility not implemented Only RDI bearer is available Service/option not implemented Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Recovery on timer expiry Protocol error, unspecified Interworking, unspecified LTE-A Module Series EP06&EG06&EM06 AT Commands Manual EP06&EG06&EM06_AT_Commands_Manual 236 / 240 CS Network Reject IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME GPRS services not allowed GPRS and non GPRS services not allowed MS identity cannot be derived Implicitly detached PLMN not allowed Location area not allowed Roaming not allowed GPRS services not allowed in PLMN No suitable cells in location area MSC temporary not reachable Network failure MAC failure Synch failure Congestion GSM authentication unacceptable Service option not supported Requested service option not subscribed Service option temporary out of order Call cannot be identified LTE-A Module Series EP06&EG06&EM06 AT Commands Manual EP06&EG06&EM06_AT_Commands_Manual 237 / 240 No PDP context activated Semantically incorrect message Invalid mandatory information Message type non-existent Message type not compatible with state Information element non-existent Message not compatible with state RR release indication RR random access failure RRC release indication RRC close session indication RRC open session failure Low level failure Low level failure no redial allowed Invalid SIM No service Timer T3230 expired No cell available Wrong state Access class blocked Abort message received Other cause Timer T303 expired No resources Release pending LTE-A Module Series EP06&EG06&EM06 AT Commands Manual EP06&EG06&EM06_AT_Commands_Manual 238 / 240 Invalid user data PS Internal Cause Invalid connection identifier Invalid NSAPI Invalid primary NSAPI PDP establish timeout Invalid field SNDCP failure RAB setup failure No GPRS context PDP activate timeout PDP modify timeout PDP inactive max timeout PDP lower layer error PDP duplicate Access technology change PDP unknown reason CS PS Network Cause LLC or SNDCP failure Insufficient resources Missing or unknown APN Unknown PDP address or PDP type User authentication failed Activation rejected by GGSN Activation rejected, unspecified LTE-A Module Series EP06&EG06&EM06 AT Commands Manual EP06&EG06&EM06_AT_Commands_Manual 239 / 240 Service option not supported Requested service option not subscribed Service option temporary out of order NSAPI already used (not sent) Regular deactivation QoS not accepted Network failure Reactivation required Feature not supported Semantic error in the TFT operation Syntactical error in the TFT operation Unknown PDP context PDP context without TFT already activated Semantic errors in packet filter Syntactical errors in packet filter Invalid transaction identifier Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Protocol error, unspecified LTE-A Module Series EP06&EG06&EM06 AT Commands Manual EP06&EG06&EM06_AT_Commands_Manual 240 / 240

EC2x&EC9x&EG2x-G&EM05 Series AT Commands Manual LTE Standard Module Series Version: 2.0 Date: 2021-02-24 Status: Released www.quectel.com LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series 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. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 1 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. Copyright The information contained here is proprietary technical information of Quectel wireless solutions co., ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 2 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual About the Document Revision History Version Date 1.0 2016-05-30 Author James CAI/ Bonnie ZHAO Ivan ZHANG/ 1.1 2017-01-18 Sophie ZHU 1.2 2017-11-14 Jessica GENG Alessa TANG/ 1.3 2018-09-20 Jessica GENG/ Description Initial 1. Added the following AT commands: +QRIR/+QINDCFG/+QINISTAT/+QLTS/+QSPN/ +QHUP/+QEEC/+QSIDET/+QMIC/+QRXGAIN/ +QIIC/+QADC 2. Added AT+QCFG commands shown as below: 'urc/ri/ring'/'urc/ri/smsincoming'/'urc/ri/other'/'risig naltype'/'urc/delay'/'urc/cache' 3. Updated the description for parameter in AT+COPS command: added the value 100 which indicates CDMA network 1. Added commands AT+QTONEDET, AT+QLDTMF, AT+QLTONE and AT+QCFG='tone/incoming' 2. Updated the description of parameter in commands AT+CREG, AT+CGREG and AT+CEREG 3. Deleted command AT+QCFG='tdscsq' and the description of +QURCCFG? in command AT+QURCCFG 4. Updated the description of commands AT+QUCCFG, AT+CTZU, AT+QDAI, AT+QEEC, AT+QIIC and AT+QCFG='band' 5. Updated the examples of commands AT+QIIC and AT+COPS 6. Deleted some related information about CDMA 7. Updated the supported baud rates of command AT+IPR 1. Added Chapters 14~20. 2. Added 'ccinfo' as a supported value of EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 3 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Demi HAN 1.4 2021-02-24 Wythe WANG in AT+QINDCFG. 3. Updated the range of in AT+QEEC. 8. Updated the default value description of in AT+QSIDET. 1. Added applicable EG91 series, EG95 series, EG21-G, EG25-G and EM05 series modules. 2. Deleted AT+QCFG and it will be provided in another specific document. 3. Updated AT+GSN (Chapter 2.8). 4. Updated AT+CGSN (Chapter 2.9). 5. Updated Table 2 of AT&V (Chapter 2.11). 6. Added the values of parameter in AT+QURCCFG (Chapter 2.25). 7. Added general commands: AT+QAPRDYIND (Chapter 2.26) and AT+QDIAGPORT (Chapter 2.27). 8. Added the values of parameter of AT+IPR (Chapter 3.5). 9. Updated the description of value 'ccinfo' of parameter of AT+QINDCFG (Chapter 4.3). 10. Added status control related command: AT+QMBNCFG (Chapter 4.4). 11. Updated the description of parameter of AT+QINISTAT (Chapter 5.9). 12. Added (U)SIM related commands: AT+QSIMVOL, AT+CCHO, AT+CGLA and AT+CCHC (Chapter 5.13–5.16). 13. Modified the default value of parameter of AT+CPOL to 2 (Chapter 6.4). 14. Updated the description of parameter and the example of AT+QNWINFO (Chapter 6.9). 15. Added network services related commands: AT+QNETINFO, AT+QNWLOCK='common/lte', AT+QOPSCFG, AT+QOPS, AT+QFPLMNCFG and AT+QENG (Chapter 6.11–6.17). 16. Modified the range of parameter of ATS10 (Chapter 7.12). 17. Added call related commands: ATS12 (Chapter 7.13) and AT+QCHLDIPMPTY (Chapter 7.22). 18. Added the memory storage type 'SR' of AT+CPMS (Chapter 9.4). 19. Added parameters and of AT+CGDCONT (Chapter 10.2). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 4 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 20. Updated the range of parameter , of AT+CGEQREQ (Chapter 10.5) and AT+CGEQMIN (Chapter 10.6). 21. Added packet domain related commands: AT$QCRMCALL, AT+QNETDEVSTATUS and AT+CGCONTRDP (Chapter 10.17–10.19). 22. Added value 128 of parameter of AT+COLP (Chapter 11.6). 23. Added the values of parameter of AT+QAUDMOD (Chapter 12.6). 24. Updated the description and range of parameter , and the notes of AT+QDAI (Chapter 12.7). 25. Added the description of parameter of AT+QLDTMF (Chapter 12.14). 26. Added audio related commands: AT+QWDTMF (Chapter 12.15), AT+QAUDRD, AT+QPSND, AT+QTTS, AT+QTTSETUP, AT+QWTTS, AT+QAUDCFG, AT+QAUDPLAY, AT+QAUDPLAYGAIN, AT+QAUDRDGAIN, AT+QACDBLOAD, AT+QACDBREAD and AT+QACDBDEL (Chapter 12.17–12.28). 27. Added SSL related AT commands (Chapter 14.8). 28. Updated CMS ERROR codes (Chapter 15.6). 29. Added (U)SIM URCs (Chapter 15.7). 30. Updated release cause text list of AT+CEER (Chapter 15.8). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 5 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 6 Table Index................................................................................................................................................. 12 1 Introduction ........................................................................................................................................ 13 1.1. Applicable Modules ................................................................................................................. 13 1.2. Special Mark ............................................................................................................................ 14 1.3. Definitions ................................................................................................................................ 14 1.4. AT Command Syntax............................................................................................................... 14 1.5. Supported Character Sets ....................................................................................................... 15 1.6. AT Command Port ................................................................................................................... 16 1.7. Unsolicited Result Code .......................................................................................................... 16 1.8. Module Turn-off Procedure...................................................................................................... 16 2 General Commands ........................................................................................................................... 17 2.1. ATI Display MT Identification Information ............................................................................. 17 2.2. AT+GMI Request Manufacturer Identification ...................................................................... 18 2.3. AT+GMM Request Model Identification ................................................................................ 18 2.4. AT+GMR Request TA Firmware Revision Identification ....................................................... 19 2.5. AT+CGMI Request Manufacturer Identification .................................................................... 19 2.6. AT+CGMM Request MT Model Identification ....................................................................... 20 2.7. AT+CGMR Request MT Firmware Revision Identification ................................................... 20 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) and SN ......................... 21 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) .................................... 22 2.10. AT&F Reset AT Command Settings to Factory Defaults ...................................................... 23 2.11. AT&V Display Current Configuration .................................................................................... 24 2.12. AT&W Store Current Settings to User-defined Profile.......................................................... 25 2.13. ATZ Set all Current Parameters to User-defined Profile ...................................................... 25 2.14. ATQ Set Result Code Presentation Mode ............................................................................ 26 2.15. ATV MT Response Format ................................................................................................... 26 2.16. ATE Set Command Echo Mode ............................................................................................ 28 2.17. A/ Repeat Previous Command Line ..................................................................................... 29 2.18. ATS3 Set Command Line Termination Character................................................................. 29 2.19. ATS4 Set Response Formatting Character .......................................................................... 30 2.20. ATS5 Set Command Line Editing Character ........................................................................ 31 2.21. ATX Set CONNECT Result Code Format and Monitor Call Progress ................................. 31 2.22. AT+CFUN Set UE Functionality ............................................................................................ 32 2.23. AT+CMEE Error Message Format ........................................................................................ 34 2.24. AT+CSCS Select TE Character Set...................................................................................... 35 2.25. AT+QURCCFG Configure URC Indication Option ............................................................... 36 2.26. AT+QAPRDYIND Configure to Report Specified URC......................................................... 37 2.27. AT+QDIAGPORT Debug UART Configuration ..................................................................... 40 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 6 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 3 Serial Interface Control Commands ................................................................................................ 41 3.1. AT&C Set DCD Function Mode ............................................................................................ 41 3.2. AT&D Set DTR Function Mode ............................................................................................. 41 3.3. AT+IFC Set TE-TA Local Data Flow Control......................................................................... 42 3.4. AT+ICF Set TE-TA Control Character Framing .................................................................... 43 3.5. AT+IPR Set TE-TA Fixed Local Rate .................................................................................... 44 3.6. AT+QRIR Restore RI Behavior to Inactive ........................................................................... 46 4 Status Control Commands ............................................................................................................... 47 4.1. AT+CPAS Mobile Equipment Activity Status ........................................................................ 47 4.2. AT+CEER Extended Error Report ........................................................................................ 48 4.3. AT+QINDCFG URC Indication Configuration ....................................................................... 49 4.4. AT+QMBNCFG MBN File Configuration Setting .................................................................. 51 4.4.1. AT+QMBNCFG='List' Query Imported MBN File List ................................................ 52 4.4.2. AT+QMBNCFG='Select' Select Imported MBN File .................................................. 53 4.4.3. AT+QMBNCFG='Deactivate' Deactivate MBN File ................................................... 53 4.4.4. AT+QMBNCFG='AutoSel' Auto Select Whether to Activate MBN File...................... 54 4.4.5. AT+QMBNCFG='Add' Add MBN File......................................................................... 54 4.4.6. AT+QMBNCFG='Delete' Delete MBN File................................................................. 55 4.4.7. AT+QMBNCFG='List_all' Query PLMN Contained in All Imported Lists of MBN Files…….. ..................................................................................................................................... 55 5 (U)SIM Related Commands ............................................................................................................... 57 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI)....................................... 57 5.2. AT+CLCK Facility Lock ......................................................................................................... 58 5.3. AT+CPIN Enter PIN .............................................................................................................. 60 5.4. AT+CPWD Change Password .............................................................................................. 62 5.5. AT+CSIM Generic (U)SIM Access ........................................................................................ 63 5.6. AT+CRSM Restricted (U)SIM Access................................................................................... 64 5.7. AT+QCCID Show ICCID ....................................................................................................... 66 5.8. AT+QPINC Display PIN Remainder Counter........................................................................ 66 5.9. AT+QINISTAT Query Initialization Status of (U)SIM Card .................................................... 67 5.10. AT+QSIMDET (U)SIM Card Detection.................................................................................. 68 5.11. AT+QSIMSTAT (U)SIM Card Insertion Status Report .......................................................... 69 5.12. AT+QSIMVOL Fix (U)SIM Card Supply Voltage................................................................... 71 5.13. AT+CCHO Open Logical Channel ........................................................................................ 72 5.14. AT+CGLA UICC Logical Channel Access............................................................................. 73 5.15. AT+CCHC Close Logical Channel ........................................................................................ 74 6 Network Service Commands ............................................................................................................ 75 6.1. AT+COPS Operator Selection .............................................................................................. 75 6.2. AT+CREG Network Registration Status ............................................................................... 77 6.3. AT+CSQ Signal Quality Report............................................................................................. 79 6.4. AT+CPOL Preferred Operator List ........................................................................................ 80 6.5. AT+COPN Read Operator Names........................................................................................ 82 6.6. AT+CTZU Automatic Time Zone Update .............................................................................. 82 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 7 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6.7. 6.8. 6.9. 6.10. 6.11. 6.12. 6.13. 6.14. 6.15. 6.16. 6.17. 6.18. AT+CTZR Time Zone Reporting ........................................................................................... 84 AT+QLTS Obtain the Latest Time Synchronized Through Network ..................................... 85 AT+QNWINFO Query Network Information.......................................................................... 87 AT+QSPN Display the Name of Registered Network ........................................................... 89 AT+QNETINFO Query Network Information of RATs ........................................................... 90 AT+QNWLOCK='common/lte' Network Locking Configuration ........................................... 93 AT+QOPSCFG='scancontrol' Configure Bands to be Scanned in 2G/3G/4G .................... 95 AT+QOPSCFG='displayrssi' Enable/Disable to Display RSSI in LTE................................. 97 AT+QOPS Band Scan........................................................................................................... 97 AT+QFPLMNCFG FPLMN Configuration ........................................................................... 101 AT+QENG Switching on/off Engineering Mode .................................................................. 103 AT+CIND Command of Control Instructions........................................................................111 7 Call Related Commands.................................................................................................................. 113 7.1. ATA Answer an Incoming Call............................................................................................. 113 7.2. ATD Mobile Originated Call to Dial a Number .................................................................... 114 7.3. ATH Disconnect Existing Connection ................................................................................. 116 7.4. AT+CVHU Voice Hang up Control ...................................................................................... 116 7.5. AT+CHUP Hang up Voice Call............................................................................................ 117 7.6. +++ Switch from Data Mode to Command Mode ............................................................... 118 7.7. ATO Switch from Command Mode to Data Mode .............................................................. 118 7.8. ATS0 Set Number of Rings before Automatical Answering................................................ 119 7.9. ATS6 Set Pause before Blind Dialing ................................................................................. 120 7.10. ATS7 Set Time to Wait for Connection Completion ............................................................ 121 7.11. ATS8 Set the Time to Wait for Comma Dial Modifier.......................................................... 121 7.12. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier .................. 122 7.13. ATS12 Set the Interval for Exiting the Transparent Access Mode Using +++ .................... 123 7.14. AT+CBST Select Bearer Service Type ............................................................................... 123 7.15. AT+CSTA Select Type of Address ...................................................................................... 126 7.16. AT+CLCC List Current Calls of ME..................................................................................... 126 7.17. AT+CR Service Reporting Control ...................................................................................... 128 7.18. AT+CRC Set Cellular Result Codes for Incoming Call Indication ...................................... 129 7.19. AT+CRLP Select Radio Link Protocol Parameter .............................................................. 130 7.20. AT+QECCNUM Configure Emergency Call Numbers........................................................ 131 7.21. AT+QHUP Hang up Call with a Specific Release Cause ................................................... 133 7.22. AT+QCHLDIPMPTY Hang Up a Call in the VoLTE Conference ........................................ 135 7.23. AT^DSCI Call Status Indication .......................................................................................... 136 8 Phonebook Commands................................................................................................................... 139 8.1. AT+CNUM Subscriber Number........................................................................................... 139 8.2. AT+CPBF Find Phonebook Entries .................................................................................... 140 8.3. AT+CPBR Read Phonebook Entries .................................................................................. 141 8.4. AT+CPBS Select Phonebook Memory Storage ................................................................. 142 8.5. AT+CPBW Write Phonebook Entry..................................................................................... 143 9 Short Message Service Commands............................................................................................... 145 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 8 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 9.1. 9.2. 9.3. 9.4. 9.5. 9.6. 9.7. 9.8. 9.9. 9.10. 9.11. 9.12. 9.13. 9.14. 9.15. 9.16. 9.17. 9.18. AT+CSMS Select Message Service ................................................................................... 145 AT+CMGF Message Format ............................................................................................... 146 AT+CSCA Service Center Address..................................................................................... 147 AT+CPMS Preferred Message Storage.............................................................................. 148 AT+CMGD Delete Message ............................................................................................... 150 AT+CMGL List Message ..................................................................................................... 151 AT+CMGR Read Message ................................................................................................. 155 AT+CMGS Send Message.................................................................................................. 159 AT+CMMS More Messages to Send .................................................................................. 161 AT+CMGW Write Message to Memory............................................................................... 163 AT+CMSS Send Message from Storage ............................................................................ 165 AT+CNMA New Message Acknowledgement to UE/TE ..................................................... 166 AT+CNMI SMS Event Reporting Configuration .................................................................. 168 AT+CSCB Select Cell Broadcast Message Types ............................................................. 170 AT+CSDH Show SMS Text Mode Parameters ................................................................... 171 AT+CSMP Set SMS Text Mode Parameters ...................................................................... 172 AT+QCMGS Send Concatenated Messages ..................................................................... 173 AT+QCMGR Read Concatenated Messages ..................................................................... 175 10 Packet Domain Commands ............................................................................................................ 178 10.1. AT+CGATT Attachment or Detachment of PS.................................................................... 178 10.2. AT+CGDCONT Define PDP Context .................................................................................. 179 10.3. AT+CGQREQ Quality of Service Profile (Requested)........................................................ 181 10.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) ......................................... 184 10.5. AT+CGEQREQ UMTS Quality of Service Profile (Requested) .......................................... 186 10.6. AT+CGEQMIN UMTS Quality of Service Profile (Minimum Acceptable) ........................... 190 10.7. AT+CGACT Activate or Deactivate PDP Context............................................................... 194 10.8. AT+CGDATA Enter Data State............................................................................................ 195 10.9. AT+CGPADDR Show PDP Address ................................................................................... 196 10.10. AT+CGCLASS GPRS Mobile Station Class ....................................................................... 197 10.11. AT+CGREG Network Registration Status .......................................................................... 198 10.12. AT+CGEREP Packet Domain Event Reporting.................................................................. 200 10.13. AT+CGSMS Select Service for MO SMS Messages.......................................................... 202 10.14. AT+CEREG EPS Network Registration Status .................................................................. 203 10.15. AT+QGDCNT Packet Data Counter ................................................................................... 204 10.16. AT+QAUGDCNT Auto Save Packet Data Counter ............................................................ 205 10.17. AT$QCRMCALL Start or Stop an RmNet Call.................................................................... 206 10.18. AT+QNETDEVSTATUS Query RmNet Device Status........................................................ 208 10.19. AT+CGCONTRDP PDP Context Read Dynamic Parameters............................................ 210 11 Supplementary Service Commands .............................................................................................. 213 11.1. AT+CCFC Call Forwarding Number and Conditions Control ............................................. 213 11.2. AT+CCWA Call Waiting Control .......................................................................................... 215 11.3. AT+CHLD Call Related Supplementary Services............................................................... 217 11.4. AT+CLIP Calling Line Identification Presentation ............................................................... 219 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 9 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 11.5. 11.6. 11.7. 11.8. AT+CLIR Calling Line Identification Restriction.................................................................. 221 AT+COLP Connected Line Identification Presentation....................................................... 222 AT+CSSN Supplementary Service Notifications ................................................................ 223 AT+CUSD Unstructured Supplementary Service Data ...................................................... 225 12 Audio Commands ............................................................................................................................ 227 12.1. AT+CLVL Loudspeaker Volume Level Selection ................................................................ 227 12.2. AT+CMUT Mute Control...................................................................................................... 228 12.3. AT+QAUDLOOP Enable/Disable Audio Loop Test ............................................................. 229 12.4. AT+VTS DTMF and Tone Generation................................................................................. 229 12.5. AT+VTD Set Tone Duration................................................................................................. 231 12.6. AT+QAUDMOD Set Audio Mode ........................................................................................ 232 12.7. AT+QDAI Digital Audio Interface Configuration .................................................................. 233 12.8. AT+QEEC Set Echo Cancellation Parameters ................................................................... 235 12.9. AT+QSIDET Set the Side Tone Gain in Current Mode ....................................................... 236 12.10. AT+QMIC Set Uplink Gains of Microphone ........................................................................ 237 12.11. AT+QRXGAIN Set Downlink Gains of RX .......................................................................... 237 12.12. AT+QIIC Read and Write Codec via IIC ............................................................................. 239 12.13. AT+QTONEDET Enable/Disable DTMF Detection ........................................................... 240 12.14. AT+QLDTMF Play Local DTMF .......................................................................................... 241 12.15. AT+QWDTMF Play or Send DTMF Files to Far End.......................................................... 242 12.16. AT+QLTONE Play a Local Customized Tone ..................................................................... 243 12.17. AT+QAUDRD Record Media File........................................................................................ 245 12.18. AT+QPSND Play WAV File ................................................................................................. 247 12.19. AT+QTTS Play Text ............................................................................................................ 248 12.20. AT+QTTSETUP Set TTS .................................................................................................... 250 12.21. AT+QWTTS Play Text or Send Text To Far End ................................................................. 251 12.22. AT+QAUDCFG Query and Configure Audio Tuning Process............................................. 253 12.22.1. AT+QAUDCFG='alc5616/dlgain' Set the Downlink Gain Level for Codec ALC5616…….............................................................................................................................. 253 12.22.2. AT+QAUDCFG='alc5616/ulgain' Set the Uplink Gain Level for Codec ALC5616... 254 12.22.3. AT+QAUDCFG='tonevolume' Set the Tone Volume................................................ 255 12.22.4. AT+QAUDCFG='alc5616/pwrctr' Enable/Disable the Power Reset ........................ 256 12.22.5. AT+QAUDCFG='nau8814/dlgain' Set the Downlink Gain Level for Codec NAU8814…................................................................................................................................. 257 12.22.6. AT+QAUDCFG='nau8814/aoutput' Set the Analog Output for Codec NAU8814 ... 258 12.22.7. AT+QAUDCFG='encgain' Set Uplink ENC Gains ................................................... 259 12.22.8. AT+QAUDCFG='voltedtmfcfg' Set Duration and Volume of VoLTE DTMF Tone .... 260 12.22.9. AT+QAUDCFG='decgain' Set Downlink DEC Gains ............................................... 261 12.22.10. AT+QAUDCFG='fns' Enable/Disable Noise Suppression ................................ 262 12.22.11.AT+QAUDCFG='nau8810/config' Set Register Value of Codec NAU8810............. 263 12.23. AT+QAUDPLAY Play Media File ........................................................................................ 264 12.24. AT+QAUDPLAYGAIN Set Audio Playing Gain ................................................................... 265 12.25. AT+QAUDRDGAIN Set Audio Recording Gain .................................................................. 266 12.26. AT+QACDBLOAD Write ACDB File .................................................................................... 267 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 10 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.27. AT+QACDBREAD Read ACDB File ................................................................................... 268 12.28. AT+QACDBDEL Delete ACDB File..................................................................................... 269 13 Hardware Related Commands ........................................................................................................ 271 13.1. AT+QPOWD Power off ....................................................................................................... 271 13.2. AT+CCLK Clock .................................................................................................................. 271 13.3. AT+CBC Battery Charge..................................................................................................... 272 13.4. AT+QADC Read ADC Value ............................................................................................... 273 13.5. AT+QSCLK Enable/Disable Low Power Mode ................................................................... 274 14 Other Related Commands............................................................................................................... 276 14.1. GNSS Related AT Commands .............................................................................................. 276 14.2. DFOTA Related AT Command............................................................................................... 277 14.3. FTP(S) Related AT Commands ............................................................................................. 277 14.4. HTTP(S) Related AT Commands .......................................................................................... 278 14.5. MMS Related AT Commands ................................................................................................ 279 14.6. SMTP Related AT Commands............................................................................................... 279 14.7. TCP(IP) Related AT Commands............................................................................................ 280 14.8. SSL Related AT Commands .................................................................................................. 281 15 Appendix References ...................................................................................................................... 282 15.1. Factory Default Settings Restorable with AT&F............................................................... 289 15.2. AT Command Settings Storable with AT&W ..................................................................... 291 15.3. AT Command Settings Storable with ATZ......................................................................... 292 15.4. Summary of CME ERROR Codes....................................................................................... 292 15.5. Summary of CMS ERROR Codes....................................................................................... 294 15.6. Summary of URC ................................................................................................................. 296 15.7. SMS Character Sets Conversions ..................................................................................... 298 15.8. Release Cause Text List of AT+CEER ............................................................................... 304 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 11 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Table Index Table 1: Applicable Modules....................................................................................................................... 13 Table 2: Special Mark ................................................................................................................................. 14 Table 3: Type of AT Commands and Responses ....................................................................................... 15 Table 4: AT&V Response............................................................................................................................ 24 Table 5: The Numeric Equivalents and Brief Description of ATV0&ATV1 Result Codes........................... 27 Table 6: Parameter Configurations Supported by AT+CBST................................................................... 125 Table 7: Delay Class................................................................................................................................. 183 Table 8: The Description of in URC +QAUDRIND: 0,..................................................... 246 Table 9: GNSS Related AT Commands ................................................................................................... 276 Table 10: DFOTA Related AT Command.................................................................................................. 277 Table 11: FTP(S) Related AT Commands ................................................................................................ 277 Table 12: HTTP(S) Related AT Commands ............................................................................................. 278 Table 13: MMS Related Commands ........................................................................................................ 279 Table 14: SMTP Related AT Commands.................................................................................................. 279 Table 15: TCP(IP) Related AT Commands .............................................................................................. 280 Table 16: SSL Related AT Commands ..................................................................................................... 281 Table 17: Related Documents .................................................................................................................. 282 Table 18: Terms and Abbreviations .......................................................................................................... 283 Table 19: Factory Default Settings Restorable with AT&F ....................................................................... 289 Table 20: AT Command Settings Storable with AT&W............................................................................. 291 Table 21: AT Command Settings Storable with ATZ ................................................................................ 292 Table 22: Different Coding Schemes of +CME ERROR: ............................................................... 293 Table 23: Different Coding Schemes of +CMS ERROR: ............................................................... 295 Table 24: Summary of URC ..................................................................................................................... 296 Table 25: The Way of SMS Text Input or Output...................................................................................... 298 Table 26: The Input Conversions Table (DCS = GSM 7 bit and AT+CSCS='GSM')............................... 299 Table 27: The Output Conversions Table (DCS = GSM 7 bit and AT+CSCS='GSM')............................ 300 Table 28: GSM Extended Characters ...................................................................................................... 300 Table 29: The Input Conversions Table (DCS = GSM 7 bit and AT+CSCS='IRA') ................................. 301 Table 30: IRA Extended Characters......................................................................................................... 302 Table 31: The Output Conversions Table (DCS = GSM 7 bit and AT+CSCS='IRA') .............................. 303 Table 32: GSM Extended Characters ...................................................................................................... 303 Table 33: List of Location ID List .............................................................................................................. 304 Table 34: List of Cause............................................................................................................................. 305 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 12 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 1 Introduction This document gives details of the AT Command Set supported by Quectel LTE Standard EC2x series, EG9x series, EG2x-G and EM05 series modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series EC2x series EG9x series EG2x-G EM05 series Module EC25 series EC21 series EC20 R2.1 EG95 series EG91 series EG25-G EG21-G EM05 series EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 13 / 316 1.2. Special Mark LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Table 2: Special Mark Mark * Definition When an asterisk (*) is used after a function, feature, interface, pin name, AT command, or argument, it indicates that the function, feature, interface, pin name, AT command, or argument is under development and currently not supported, unless otherwise specified. 1.3. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 1.4. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . Throughout this document, only the commands and responses are presented, while carriage return and line feed characters are deliberately omitted. AT commands implemented by EC2x series, EG9x series, EG2x-G and EM05 series modules can be separated into two categories syntactically: 'basic command', and 'extended command', as listed below: ⚫ Basic Command These AT commands have the format of AT, or AT&, where is the command, and is/are the argument(s) for that command. An example of this is ATE, which tells the DCE (Data Circuit-terminating Equipment) whether received characters should be echoed back to the DTE (Data Terminal Equipment) according to the value of . is optional and a default will be used if it is omitted. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 14 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual ⚫ Extended Command These commands can be operated in several modes, as following table: Table 3: Type of AT Commands and Responses Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and to give information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. 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 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 =?. 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, ERROR will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. 1.5. Supported Character Sets The AT command interface of LTE standard modules defaults to the GSM character set. LTE standard modules support the following character sets: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 15 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual ⚫ GSM format ⚫ UCS2 ⚫ IRA The character set can be configured and interrogated by using the AT+CSCS command (3GPP TS 27.007) and it is defined in 3GPP TS 27.005. The character set affects transmission and reception of SMS and SMS Cell Broadcast Messages, as well as the entry and display of phone book entries text field. 1.6. AT Command Port The main UART port and two USB ports (USB modem port and USB AT port) support AT command communication and data transfer. 1.7. Unsolicited Result Code Unsolicited Result Code (URC) is not issued as a part of the response related to an executed AT command, but as a report message issued by the modules without being requested by the TE. It is issued automatically when a certain event occurs. Typical events leading to URCs are incoming calls (RING), received short messages, high/low voltage alarm, high/low temperature alarm, etc. 1.8. Module Turn-off Procedure It is recommended to execute AT+QPOWD to turn off the module, since it is the safest and best method through which the powering off is realized by letting the module log off from the network and allowing the software to enter a secure and safe data state before disconnecting the power supply. After sending AT+QPOWD, please do not enter any other AT commands. When the command is executed successfully, the module will output message POWERED DOWN and then enter the power down mode. In order to avoid data loss, it is suggested to wait for 1s to disconnect the power supply after the URC POWERED DOWN is outputted. If POWERED DOWN cannot be received within 65s, the power supply shall be disconnected compulsorily. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 16 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2 General Commands 2.1. ATI Display MT Identification Information This Execution Command delivers the MT information text. ATI Display Product Identification Information Execution Command ATI Response Quectel Revision: Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identifier of device type. String type. Identification text of product software version. Example ATI Quectel EC25 Revision: EC25EFAR02A09M4G OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 17 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2.2. AT+GMI Request Manufacturer Identification This command returns the manufacturer identification text. It is identical with AT+CGMI. AT+GMI Request Manufacturer Identification Test Command AT+GMI=? Execution Command AT+GMI Response OK Response Quectel Maximum Response Time Characteristics Reference V.25ter OK 300 ms / 2.3. AT+GMM Request Model Identification This command returns the MT model identification text. It is identical with AT+CGMM in Chapter 2.6. AT+GMM Request TA Model Identification Test Command AT+GMM=? Execution Command AT+GMM Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identifier of device type. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 18 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2.4. AT+GMR Request TA Firmware Revision Identification This command delivers the product firmware version identification text. It is identical with AT+CGMR. AT+GMR Request TA Firmware Revision Identification Test Command AT+GMR=? Execution Command AT+GMR Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter String type. Identification text of product software version. Example AT+GMR EC25EFAR02A09M4G OK 2.5. AT+CGMI Request Manufacturer Identification This command returns the manufacturer identification text. It is identical with AT+GMI. AT+CGMI Request Manufacturer Identification Test Command AT+CGMI=? Execution Command AT+CGMI Response OK Response Quectel OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 19 / 316 Maximum Response Time Characteristics Reference 3GPP TS 27.007 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 300 ms / 2.6. AT+CGMM Request MT Model Identification This command returns the model information of the product. It is identical with the above AT+GMM. AT+CGMM Request Model Identification Test Command AT+CGMM=? Execution Command AT+CGMM Response OK Response Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter String type. Identifier of device type. 2.7. AT+CGMR Request MT Firmware Revision Identification This Execution command delivers the identification text of MT firmware version. It is identical with the above AT+GMR. AT+CGMR Request MT Firmware Revision Identification Test Command AT+CGMR=? Execution Command AT+CGMR Response OK Response EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 20 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter String type. Identification text of MT firmware version. 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) and SN This command requests the International Mobile Equipment Identity (IMEI) number which permits the user to identify individual ME device and the Serial Number (SN) of the ME. It is identical with the AT+CGSN command in Chapter 2.9. AT+GSN Request International Mobile Equipment Identity (IMEI) and SN Test Command AT+GSN=? Response +GSN: (list of supported s) Write Command AT+GSN= OK Response If =0, query SN of the ME: +GSN: OK If =1, query IMEI of the ME: +GSN: Execution Command AT+GSN OK Response OK Or ERROR EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 21 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CMS ERROR: 300 ms / Parameter Integer type. Control to query SN or IMEI of the ME. 0 Query SN of the ME 1 Query IMEI of the ME String type. SN of the ME. String type. IMEI of the ME. Error codes. For more details, please refer to Chapter 15.5. 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) This Execution command requests the International Mobile Equipment Identity (IMEI) number which permits the user to identify individual ME device and the Serial Number (SN) of the ME. It is identical with the above AT+GSN. AT+CGSN Request International Mobile Equipment Identity (IMEI) Test Command AT+CGSN=? Response +CGSN: (list of supported s) Write Command AT+CGSN= OK Response If =0, query SN of the ME: +CGSN: OK If =1, query IMEI of the ME: +CGSN: Execution Command AT+CGSN OK Response EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 22 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Or ERROR If there is any error related to ME functionality: +CMS ERROR: 300 ms / Parameter Integer type. Control to query SN or IMEI of the ME. 0 Query SN of the ME 1 Query IMEI of the ME String type. SN of the ME. String type. IMEI of the ME. Error codes. For more details, please refer to Chapter 15.5. 2.10. AT&F Reset AT Command Settings to Factory Defaults This command resets AT command settings to the default values specified by the manufacturer. (See Table 17). AT&F Set all Current Parameters to Manufacturer Defaults Execution Command AT&F[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Reset all AT command settings to factory setting EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 23 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2.11. AT&V Display Current Configuration This command displays the current settings of several AT command parameters (See Table 2), even including the single-letter AT command parameters which are not readable. AT&V Display Current Configuration Execution Command AT&V Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Table 4: AT&V Response AT&V &C: 1 &D: 2 &F: 0 &W: 0 E: 1 Q: 0 V: 1 X: 4 Z: 0 S0: 0 S3: 13 S4: 10 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 S12: 50 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 24 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2.12. AT&W Store Current Settings to User-defined Profile This command stores the current AT command settings to a user-defined profile in non-volatile memory. (See Table 18). AT&W Store Current Settings to User-defined Profile Execution Command AT&W[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Profile number to store current AT command settings. 2.13. ATZ Set all Current Parameters to User-defined Profile This command first resets the AT command settings to their manufacturer defaults. Afterwards, the AT command settings are restored from the user-defined profile in the non-volatile memory, if they have been stored with AT&W before (See Table 20). Any additional AT command on the same command line may be ignored. ATZ Set all Current Parameters to User-defined Profile Execution Command ATZ[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 25 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 0 Reset to profile number 0. 2.14. ATQ Set Result Code Presentation Mode This command controls whether the result code is transmitted to the TE. Other information text transmitted as response is not affected. ATQ Set Result Code Presentation Mode Execution Command ATQ Response If =0: OK Maximum Response Time Characteristics Reference V.25ter If =1: (none) 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. 0 TA transmits result code 1 Result codes are suppressed and not transmitted 2.15. ATV MT Response Format This command determines the contents of header and trailer transmitted with AT command result codes and information responses. The numeric equivalents and brief descriptions of results code are listed in the following Table 4. ATV MT Response Format Execution Command ATV Response When =0: 0 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 26 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference V.25ter When =1: OK 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. 0 Information response: Short result code format: 1 Information response: Long result code format: Example ATV1 OK AT+CSQ +CSQ: 30,99 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //Set =1 //When =1, the result code is OK. //Set =0 //When =0, the result code is 0. Table 5: The Numeric Equivalents and Brief Description of ATV0&ATV1 Result Codes ATV1 OK CONNECT RING ATV0 0 1 2 Description Acknowledges execution of a command A connection has been established; the DCE is moving from command mode to data mode The DCE has detected an incoming call signal from network EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 27 / 316 NO CARRIER ERROR NO DIALTONE BUSY NO ANSWER LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual The connection has been terminated or the attempt to establish 3 a connection failed Command not recognized, command line maximum length 4 exceeded, parameter value invalid, or other problem with processing the command line 6 No dial tone detected 7 Engaged (busy) signal detected '@' (Wait for Quiet Answer) dial modifier was used, but remote 8 ringing followed by five seconds of silence was not detected before expiration of the connection timer (S7) 2.16. ATE Set Command Echo Mode This command controls whether TA echoes characters received from TE or not during AT command mode. ATE Set Command Echo Mode Execution Command ATE Maximum Response Time Characteristics Reference V.25ter Response OK 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. 0 Echo mode OFF 1 Echo mode ON EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 28 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2.17. A/ Repeat Previous Command Line This command repeats previous AT command line, and '/' acts as the line terminating character. A/ Repeat Previous Command Line Execution Command A/ Reference V.25ter Response Repeat the previous command Example ATI Quectel EC25 Revision: EC25EFAR02A09M4G OK A/ Quectel EC25 Revision: EC25EFAR02A09M4G OK //Repeat the previous command. 2.18. ATS3 Set Command Line Termination Character This command determines the character recognized by TA to terminate an incoming command line. It is also generated for result codes and information text, along with character value set via ATS4. ATS3 Set Command Line Termination Character Read Command ATS3? Response Write Command ATS3= Maximum Response Time Characteristics OK Response OK 300 ms The command takes effect immediately. The configuration will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 29 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference V.25ter Parameter Integer type. Command line termination character. Range: 0–127. Default: 13. 2.19. ATS4 Set Response Formatting Character This command determines the character generated by TA for result code and information text, along with the command line termination character set via ATS3. ATS4 Set Response Formatting Character Read Command ATS4? Response Write Command ATS4= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Response formatting character. Range: 0–127. Default: 10. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 30 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2.20. ATS5 Set Command Line Editing Character This command determines the character value used by the module to delete the immediately preceding character from the AT command line (i.e. equates to backspace key). ATS5 Set Command Line Editing Character Read Command ATS5? Response Write Command ATS5= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Response editing character. Range: 0–127. Default: 8. 2.21. ATX Set CONNECT Result Code Format and Monitor Call Progress This command determines whether TA transmits particular result codes to the TE or not. It also controls whether TA detects the presence of a dial tone when it begins dialing and the engaged tone (busy signal) or not. ATX Set CONNECT Result Code Format and Monitor Call Progress Execution Command ATX Response OK Maximum Response Time 300 ms Characteristics Reference V.25ter The command takes effect immediately. The configurations can be saved with AT&W. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 31 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. 0 Only CONNECT result code returned, dial tone and busy detection are both disabled. 1 Only CONNECT result code returned, dial tone and busy detection are both disabled. 2 CONNECT result code returned, dial tone detection is enabled, and busy detection is disabled. 3 CONNECT result code returned, dial tone detection is disabled, and busy detection is enabled. 4 CONNECT result code returned, and dial tone and busy detection are both enabled. 2.22. AT+CFUN Set UE Functionality This command controls the functionality level. It can also be used to reset the UE. AT+CFUN Set UE Functionality Test Command AT+CFUN=? Response +CFUN: (list of supported s),(list of supported s) Read Command AT+CFUN? OK Response +CFUN: Write Command AT+CFUN=[,] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 15 s, determined by network. The command takes effect immediately. The configuration will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 32 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. 0 Minimum functionality 1 Full functionality 4 Disable the ME from both transmitting and receiving RF signals Integer type. 0 Do not reset the ME before setting it to functionality level. 1 Reset the ME. The device is fully functional after the reset. This value is available only for =1 Error codes. For more details, please refer to Chapter 15.4. Example AT+CFUN=0 OK AT+COPS? +COPS: 0 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN=1234 OK +CPIN: READY +QUSIM: 1 +QIND: PB DONE +QIND: SMS DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE',7 //Switch UE to minimum functionality. //No operator is registered. //(U)SIM failure. //Switch UE to full functionality. //Operator is registered. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 33 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual OK 2.23. AT+CMEE Error Message Format This command controls the format of error result codes: ERROR, error numbers or verbose messages as +CME ERROR: and +CMS ERROR: . This command disables or enables the use of final result code +CME ERROR: as the indication of an error. AT+CMEE Error Message Format Test Command AT+CMEE=? Response +CMEE: (range of supported s) Read Command AT+CMEE? OK Response +CMEE: Write Command AT+CMEE= Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. 0 Disable result code 1 Enable result code and use numeric values 2 Enable result code and use verbose values Example AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK //Disable result code. //Only ERROR is displayed //Enable error result code with numeric values. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 34 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted //Enable error result code with verbose (string) values. 2.24. AT+CSCS Select TE Character Set This command informs the MT which character set is used by the TE. TA is then able to convert character strings correctly between TE and MT character sets. AT+CSCS Select TE Character Set Test Command AT+CSCS=? Response +CSCS: (list of supported s) Read Command AT+CSCS? OK Response +CSCS: Write Command AT+CSCS= Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms The command takes effect immediately. The configuration will not be saved. Parameter String type. 'GSM' GSM default alphabet 'IRA' International reference alphabet 'UCS2' UCS2 alphabet Example AT+CSCS? +CSCS: 'GSM' //Query the current character set. //The character set is GSM. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 35 / 316 OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //Set the character set to 'UCS2'. //The character set is UCS2 after the configuration. 2.25. AT+QURCCFG Configure URC Indication Option This commands configures the output port of URC. AT+QURCCFG Configure URC Indication Option Test Command AT+QURCCFG=? Response +QURCCFG: 'urcport',(list of supported s) Write Command AT+QURCCFG='urcport'[,] OK Response If the optional parameter is omitted, query the current configuration: +QURCCFG: 'urcport', OK Maximum Response Time Characteristics If the optional parameter is specified, configure the output port of URC: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter String type. Set URC output port. 'usbat' USB AT port 'usbmodem' USB modem port 'uart1' Main UART 'uart2' Debug UART EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 36 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 'all' All ports Example AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1','uart2','all') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' OK AT+QURCCFG='urcport','usbmodem' OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' OK 2.26. AT+QAPRDYIND Configure to Report Specified URC This command configures whether to enable the specified URC or not after the process of AP side were booted successfully. AT+QAPRDYIND Configure to Report Specified URC Read Command AT+QAPRDYIND? Response +QAPRDYIND: (range of supported s) Write Command AT+QAPRDYIND= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect after module is rebooted. The configuration will be saved automatically. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 37 / 316 Parameter 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. Range: 0–15. Default: 0. The value and corresponding URC can be referred to below. The Y in the chart below indicates the URC will be reported and N indicates the URC will not be reported. +APIND: UART DDP READY N Y N Y N Y N Y N Y N Y N Y N Y +APIND: QUEC +APIND: ATFWD DAEMON READY READY N N +APIND: QMI READY N N N N Y N N Y N N N Y N N Y N Y Y N Y Y N N N Y N N Y Y N Y Y N Y N Y Y N Y Y Y Y Y Y Y Y NOTES 1. The URC will be reported via the specified port after power on if the URC is enabled. And the port can be configured via AT+QURCCFG='urcport', the default port is USB AT. 2. The AT function of module UART2 is disabled, if the DDP URC is needed, the enablement of AT function via AT+QDIAGPORT=1 is required. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 38 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+QAPRDYIND? +QAPRDYIND=0 OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' //This command can be used to set port for URC outputting. OK AT+QAPRDYIND=2 OK AT+QAPRDYIND=4 OK //Set port successfully, and URC +APIND: QUEC DAEMON READY will be reported after module is rebooted. //Set port successfully, and URC +APIND: ATFWD READY will be reported after module is rebooted. AT+QAPRDYIND=6 OK //Set port successfully, and URC +APIND: QUEC DAEMON READY and +APIND: ATFWD READY will be reported after rebooting. //If the reporting of URC +APIND: UART DDP READY is needed, it is required to enable AT function of UART2 via AT+QDIAGPORT=1 before configuring. AT+QDIAGPORT=1 OK AT+QAPRDYIND=1 OK AT+QAPRDYIND=3 OK AT+QAPRDYIND=5 OK +APIND: AT+QAPRDYIND=7 OK +APIND: //Set port successfully, and URC +APIND: UART DDP READY will be reported after rebooting. //Set port successfully, and URC +APIND: UART DDP READY, and +APIND: QUEC DAEMON READY will be reported after rebooting. //Set port successfully, and URC +APIND: UART DDP READY and ATFWD READY will be reported after rebooting. //Set port successfully, and URC +APIND: UART DDP READY, QUEC DAEMON READY and +APIND: ATFWD READY will be reported after rebooting. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 39 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2.27. AT+QDIAGPORT Debug UART Configuration This commans configures debug UART as AT port. AT+QDIAGPORT Debug UART Configuration Read Command AT+QDIAGPORT=? Response +QDIAGPORT: (list of supported s) Write Command AT+QDIAGPORT= Maximum Response Time Characteristics OK Response OK Or ERROR 12 s The command takes effect after module is rebooted. The configuration will be saved automatically. Parameter Integer type. 0 Debug UART port 1 AT port NOTES 1. When Debug UART is configured to AT port, the baud rate is fixed to 115200 bps. 2. There is still module booting message output when Debug UART is configured to AT port. 3. It is recommended not to set up data connection on Debug UART due to limited baudrate. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 40 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 3 Serial Interface Control Commands 3.1. AT&C Set DCD Function Mode This command controls the behavior of the UE’s DCD (data carrier detection) line. AT&C Set DCD Function Mode Execution Command AT&C[] Maximum Response Time Characteristics Reference V.25ter Response OK 300 ms The command takes effect immediately. The configurations can be saved with AT&W. Parameter Integer type. It determines how the state of circuit (DCD) relates to the detection of received line signal from the distant end. 0 DCD line is always ON 1 DCD line is ON only in the presence of data carrier 3.2. AT&D Set DTR Function Mode This command determines how the UE responds if DTR line is changed from low to high level during data mode. AT&D Set DTR Function Mode Execution Command AT&D[] Maximum Response Time Characteristics Response OK 300 ms The command takes effect immediately. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 41 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference V.25ter The configurations can be saved with AT&W. Parameter Integer type. 0 TA ignores status on DTR 1 Low→High on DTR: Change to command mode while remaining the connected call. 2 Low→High on DTR: Disconnect data call, and change to command mode. When DTR is at high level, auto-answer function is disabled. 3.3. AT+IFC Set TE-TA Local Data Flow Control This command determines the flow control behavior of the serial port for data mode. AT+IFC Set TE-TA Local Data Flow Control Test Command AT+IFC=? Response +IFC: (list of supported s),(list of supported s) Read Command AT+IFC? OK Response +IFC: , Write Command AT+IFC=, OK Response OK Maximum Response Time 300 ms Characteristics Reference V.25ter The command takes effect immediately. The configurations can be saved with AT&W. Parameter Integer type. Specifies the method that will be used by TE when receiving data from TA. 0 None EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 42 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2 RTS flow control Integer type. Specifies the method that will be used by TA when receiving data from TE. 0 None 2 CTS flow control NOTE Flow control is only applicable for data mode. Example AT+IFC=2,2 OK AT+IFC? +IFC: 2,2 OK //Open the hardware flow control. 3.4. AT+ICF Set TE-TA Control Character Framing This command determines the serial interface character framing format and parity received by TA from TE. AT+ICF Set TE-TA Control Character Framing Test Command AT+ICF=? Response +ICF: (list of supported s),(list of supported s) Read Command AT+ICF? OK Response +ICF: , Write Command AT+ICF=[,[]] Maximum Response Time OK Response OK Or ERROR 300 ms EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 43 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Characteristics Reference V.25ter The command takes effect immediately. The configurations can be saved with AT&W. Parameter Integer type. 3 8 data 0 parity 1 stop Integer type. 0 Odd 1 Even 2 Mark (1) 3 Space (0) NOTES 1. The command is applied for command state. 2. The field is omitted if the field specifies no parity. 3.5. AT+IPR Set TE-TA Fixed Local Rate This command queries and set the baud rate of the UART. AT+IPR Set TE-TA Fixed Local Rate Test Command AT+IPR=? Response +IPR: (list of supported auto detectable s),(list of supported fixed-only s) Read Command AT+IPR? OK Response +IPR: Write Command AT+IPR= Maximum Response Time Characteristics OK Response OK 300 ms The command takes effect immediately. The configurations can be saved with AT&W. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 44 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference V.25ter Parameter String type. Baud rate per second. 4800 9600 19200 38400 57600 115200 230400 460800 921600 2900000 3000000 3200000 3686400 4000000 NOTES 1. If a fixed baud rate is set, make sure that both TE (DTE, usually external processor) and TA (DCE, Quectel module) are configured to the same rate. 2. The value of AT+IPR cannot be restored with AT&F and ATZ; but it is still storable with AT&W. 3. In multiplex mode, the baud rate cannot be changed by the Write Command AT+IPR=; and the setting is invalid and cannot be stored even if AT&W is executed after the Write Command. 4. A selected baud rate takes effect after the Write Commands are executed and acknowledged by OK. Example AT+IPR=115200 OK AT&W OK AT+IPR? +IPR: 115200 OK AT+IPR=115200;&W OK //Set fixed baud rate to 115200bps //Store current setting, that is, the serial communication speed is 115200 bps after restarting module //Set fixed baud rate to 115200bps and store current setting EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 45 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 3.6. AT+QRIR Restore RI Behavior to Inactive This command restores RI behavior to inactive. If the RI (ring indicator) behavior is 'always', it can be restored to inactive by the Execution Command. The RI behavior is controlled by AT+QCFG. Please refer to AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other' for more details. AT+QRIR Restore RI Behavior to Inactive Test Command AT+QRIR=? Execution Command AT+QRIR Response OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configuration will not be saved automatically. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 46 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 4 Status Control Commands 4.1. AT+CPAS Mobile Equipment Activity Status This command queries the module’s activity status. AT+CPAS Mobile Equipment Activity Status Test Command AT+CPAS=? Response +CPAS: (list of supported s) Execution Command AT+CPAS OK Response TA returns the activity status of ME: +CPAS: OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. ME activity status. 0 Ready 3 Ringing 4 Call in progress or call hold Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 47 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+CPAS +CPAS: 0 //The module is idle OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 //The module is ringing OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129 OK AT+CPAS +CPAS: 4 //Call in progress OK 4.2. AT+CEER Extended Error Report This command queries an extended error and report the cause of the last failed operation, such as: ⚫ The failure to release a call ⚫ The failure to set up a call (both mobile originated or terminated) ⚫ The failure to modify a call by using supplementary services ⚫ The failure to activate, register, query, deactivate or deregister a supplementary service ⚫ The failure to attach GPRS or the failure to activate a PDP context ⚫ The failure to detach GPRS or the failure to deactivate a PDP context The release cause is a text to describe the cause information given by the network. AT+CEER Extended Error Report Test command AT+CEER=? Execution command AT+CEER Response OK Response +CEER: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 48 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics OK Or ERROR If error is related to ME functionality: +CME ERROR: 300 ms / Parameter Release cause text. Reason for the last call failure to setup or release (listed in Chapter 15.8). Both CS and PS domain call types are reported. Cause data is captured from Call Manager events and cached locally for later use by this command. Error codes. For more details, please refer to Chapter 15.4. 4.3. AT+QINDCFG URC Indication Configuration This command controls URC indication. AT+QINDCFG URC Indication Configuration Test command AT+QINDCFG=? Response +QINDCFG: 'all',(list of supported s),(list of supported s) +QINDCFG: 'csq',(list of supported s),(list of supported s) +QINDCFG: 'smsfull',(list of supported s),(list of supported s) +QINDCFG: 'ring',(list of supported s),(list of supported s) +QINDCFG: 'smsincoming',(list of supported s),(list of supported s) +QINDCFG: 'act',(list of supported s),(list of supported s) +QINDCFG: 'ccinfo',(list of supported s),(list of supported s) OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 49 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Write command AT+QINDCFG=[,[,< save_to_nvram>]] Response If the optional parameters are omitted, query the current configuration: +QINDCFG: , OK If the optional parameters are specified, set the URC indication configurations: OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300 ms Parameter String type. URC type. 'all' 'csq' 'smsfull' 'ring' 'smsincoming' 'act' Main switch of all URCs. Default: ON. Indication of signal strength and channel bit error rate change (similar to AT+CSQ). Default: OFF. If this configuration is ON, present: +QIND: 'csq',, SMS storage full indication. Default is OFF. If this configuration is ON, present: +QIND: 'smsfull', 'RING' indication. Default: ON. Incoming message indication. Default: ON. Related URCs list: +CMTI, +CMT, +CDS Indication of network access technology change. Default is OFF. If this configuration is ON, present: +QIND: 'act', is string format. The values are as below: 'GSM' 'EGPRS' 'WCDMA' 'HSDPA' 'HSUPA' 'HSDPA&HSUPA' 'LTE' 'TD-SCDMA' EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 50 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 'CDMA' 'HDR' 'EVDO' 'UNKNOWN' The examples of URC are as below: +QIND: 'act','HSDPA&HSUPA' +QIND: 'act','UNKNOWN' The description of 'act' is as below: 1. If module does not register on network, the would be 'UNKNOWN'. 2. If this configuration is ON, the URC of 'act' is reported immediately. Only when the network access technology changes, a new URC is reported. 'ccinfo' Indication of voice call state change. Default: 0. It is disabled by default, set to 1 to enable and +QIND: 'ccinfo',,,,,,,[,] is reported. Integer type. URC indication is ON or OFF. 0 OFF 1 ON Integer type. Whether to save configuration into NVM. 0 Not save 1 Save Integer type. For details of error codes, please refer to Chapter 15.4. 4.4. AT+QMBNCFG MBN File Configuration Setting AT+QMBNCFG Test Command AT+QMBNCFG=? MBN File Configuration Setting Response +QMBNCFG: 'List' +QMBNCFG: 'Select'[,] +QMBNCFG: 'Deactivate' +QMBNCFG: 'AutoSel'[,(0,1)] +QMBNCFG: 'Delete','' +QMBNCFG: 'Add','' +QMBNCFG: 'List_all' OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 51 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 4.4.1. AT+QMBNCFG='List' Query Imported MBN File List This command queries the imported MBN file list. AT+QMBNCFG='List' Query Imported MBN File List Write Command AT+QMBNCFG='List' Response +QMBNCFG:'List',,,,,, … Maximum Response Time Characteristics OK 300 ms The command takes effect immediately. The configuration will not be saved automatically. Parameter Integer type. The MBN index indicates which imported MBN file is currently listed. Integer type. Indicates whether the MBN file is selected. 0 Unselected 1 Selected Integer type. Indicates whether the MBN file is activated. 0 Unactivated 1 Activated String type. The name of the imported MBN file. String type. The version of the imported MBN file. String type. The release date of the imported MBN file. Example AT+QMBNCFG='list' +QMBNCFG: 'List',0,0,1,'ROW_Generic_3GPP',0x06010821,201706061 +QMBNCFG: 'List',1,0,0,'Volte_OpenMkt-Commercial-CMCC',0x06012064,201706061 +QMBNCFG: 'List',2,0,0,'OpenMkt-Commercial-CU',0x06011510,201706062 +QMBNCFG: 'List',3,0,0,'Telstra-Commercial_VoLTE',0x0680010F,201710261 +QMBNCFG: 'List',4,1,0,'hVoLTE-Verizon',0x060101A0,201801081 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 52 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 4.4.2. AT+QMBNCFG='Select' Select Imported MBN File This command selects a certain MBN file that has been loaded, and when the module is restarted, the selected MBN file will be activated. AT+QMBNCFG='Select' Select Imported MBN File Write Command AT+QMBNCFG='Select'[,] Response If the optional parameter is omitted, query the current configuration: +QMBNCFG: 'Select', OK Maximum Response Time Characteristics If the optional parameter is specified, select a certain MBN file: OK Or ERROR 300 ms The command takes effect after reboot. Parameter Integer type. MBN file name to be selected. 4.4.3. AT+QMBNCFG='Deactivate' Deactivate MBN File After the MBN file is deactivated, the currently activated MBN file becomes inactive. AT+QMBNCFG='Deactivate' Deactivate MBN File Write Command AT+QMBNCFG='Deactivate' Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 53 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 4.4.4. AT+QMBNCFG='AutoSel' Auto Select Whether to Activate MBN File This command configures whether MBN file can be automatically selected via (U)SIM card. AT+QMBNCFG='AutoSel' Auto Select Whether to Activate MBN File Write Command AT+QMBNCFG='AutoSel' Response +QMBNCFG: 'AutoSel', Execution Command AT+QMBNCFG='AutoSel'[,] OK or ERROR Response: If the optional parameter is omitted, query the current configuration: +QMBNCFG: 'AutoSel', OK or ERROR Maximum Response Time Characteristics If the optional parameter is specified, configure whether MBN file can be automatically selected via (U)SIM card: OK or ERROR 300 ms The command takes effect after module is rebooted. The configuration will be saved automatically. Parameter Integer type. Enable/disable to auto activate MBN file. 0 Disable 1 Enable 4.4.5. AT+QMBNCFG='Add' Add MBN File This command adds MBN file. AT+ QMBNCFG='Add' Add MBN File Write Command AT+QMBNCFG='Add', Response OK or EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 54 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter String type. The name of the MBN file to be added. 4.4.6. AT+QMBNCFG='Delete' Delete MBN File This command deletes MBN file from EFS. AT+QMBNCFG='Delete' Delete MBN File Write Command: AT+QMBNCFG='Delete', Response OK or ERROR Characteristics The command takes effect after module is rebooted. Parameter String type. The name of the MBN file to be deleted. 4.4.7. AT+QMBNCFG='List_all' Query PLMN Contained in All Imported Lists of MBN Files This command queries PLMN contained in all imported lists of MBN files. AT+QMBNCFG='List_all' Query PLMN Contained in All Imported Lists of MBN Files Write Command AT+ QMBNCFG='List_all' Response +QMBNCFG: 'List_all',,,,'',,, … OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 55 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. The MBN file label indicates which imported MBN file is currently listed. Integer type. Indicates whether the MBN file is selected. 0 Unselected 1 Selected Integer type. Indicates whether the MBN file list is activated. 0 Inactive 1 Activated String type. The name of the imported MBN file. String type. The version of the imported MBN file. String type. The release date of the imported MBN file. String type. List of supported PLMN contained in all imported lists of MBN files. Example AT+QMBNCFG='List_all' //Query PLMN contained in all imported lists of MBN files. +QMBNCFG: 'List_all',0,0,0,'ROW_Generic_3GPP',0x05010814,201704141, '''' +QMBNCFG: 'List_all',1,0,0,'OpenMkt-Commercial-CU',0x05011510,201704141,''460-01 460-09 460-06'' +QMBNCFG: 'List_all',2,1,1,'OpenMkt-Commercial-CT',0x0501131C,201704141,''455-07 460-11 460-03'' +QMBNCFG: 'List_all',3,0,0,'Volte_OpenMkt-Commercial-CMCC',0x05012011,201706021,''460-00 460-02 460-07 460-08 454-12 454-13 460-04'' OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 56 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 5 (U)SIM Related Commands 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) This command requests the International Mobile Subscriber Identity (IMSI) which is intended to permit the TE to identify the individual SIM card or active application in the UICC (GSM or USIM) that is attached to MT. AT+CIMI Request International Mobile Subscriber Identity (IMSI) Test Command AT+CIMI=? Response OK Execution Command AT+CIMI Response TA returns for identifying the individual (U)SIM which is attached to ME. OK Maximum Response Time Characteristic Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter International Mobile Subscriber Identity (string without double quotes) Error codes. For more details, please refer to Chapter 15.4. Example AT+CIMI 460023210226023 //Query IMSI number of (U)SIM which is attached to ME EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 57 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual OK 5.2. AT+CLCK Facility Lock This command locks, unlocks or interrogates a MT or a network facility . It can be aborted when network facilities are being set or interrogated. The factory default password of PF, PN, PU, PP and PC lock is '12341234'. For Write Command, is normally needed to do such actions. When querying the status of network service (=2) the response line for ‘not active’ case (=0) should be returned only if service is not active for any . AT+CLCK Facility Lock Test Command AT+CLCK=? Response +CLCK: (list of supported s) Write Command AT+CLCK=,[,[ ,]] OK Response If is not equal to 2 and the command is set successfully: OK If =2 and command is set successfully: +CLCK: [,] [+CLCK: [,]] […] Maximum Response Time Characteristic Reference 3GPP TS 27.007 OK 5 s The command takes effect immediately. The configuration will be saved automatically. Parameter String type. 'SC' (U)SIM (lock SIM/UICC card installed in the currently selected card slot) (SIM/UICC asks password in MT power-up and when this lock command issued). 'AO' BAOC (Bar All Outgoing Calls) (refer to 3GPP TS 22.088 clause 1). 'OI' BOIC (Bar Outgoing International Calls) (refer to 3GPP TS 22.088 clause 1). 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country) (refer to EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 58 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 3GPP TS 22.088 clause 1). 'AI' BAIC (Bar All Incoming Calls) (refer to 3GPP TS 22.088 clause 2). 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (refer to 3GPP TS 22.088 clause 2). 'AB' All Barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'AG' All outgoing barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'AC' All incoming barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'FD' SIM card or active application in the UICC (GSM or USIM) fixed dialing memory feature (if PIN2 authentication has not been done during the current session, PIN2 is required as ). 'PF' Lock Phone to the very first inserted SIM/UICC card (also referred in the present document as PH-FSIM) (MT asks password when other SIM/UICC cards are inserted). 'PN' Network Personalization (refer to 3GPP TS 22.022) 'PU' Network Subset Personalization (refer to 3GPP TS 22.022) 'PP' Service Provider Personalization (refer to 3GPP TS 22.022) 'PC' Corporate Personalization (refer to 3GPP TS 22.022) Integer type. The status of network service. 0 Unlock 1 Lock 2 Query status String type. Password. Integer type. 1 Voice 2 Data 4 FAX 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization Integer type. 0 Off 1 On Example AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK //Query the status of (U)SIM card. //The (U)SIM card is unlocked (OFF). //Lock (U)SIM card, and the password is 1234. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 59 / 316 AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //Query the status of (U)SIM card. //The (U)SIM card is locked (ON). //Unlock (U)SIM card. 5.3. AT+CPIN Enter PIN This command enters a password or queries whether or not the module requires a password which is necessary before it can be operated. The password may be (U)SIM PIN, (U)SIM PUK, PH-SIM PIN, etc. Read Command returns an alphanumeric string indicating whether or not some password is required. TA stores a password, such as (U)SIM PIN, (U)SIM PUK, etc., which is necessary before it can be operated. If the PIN is to be entered twice, the TA shall automatically repeat the PIN. If no PIN request is pending, no action is taken and an error message +CME ERROR is returned to TE. If the PIN required is (U)SIM PUK or (U)SIM PUK2, the second pin is required. This second pin is used to replace the old pin in the (U)SIM. AT+CPIN Enter PIN Test Command AT+CPIN=? Read Command AT+CPIN? Response OK Response +CPIN: Write Command AT+CPIN=[,] Maximum Response Time Characteristic Reference 3GPP TS 27.007 OK Response OK 5 s The command takes effect immediately. The configuration will be saved automatically. Parameter String without double quotes. The password that the module requires. READY MT is not pending for any password EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 60 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual SIM PIN MT is waiting for SIM PIN to be given SIM PUK MT is waiting for SIM PUK to be given SIM PIN2 MT is waiting for SIM PIN2 to be given SIM PUK2 MT is waiting for SIM PUK2 to be given PH-NET PIN MT is waiting for network personalization password to be given PH-NET PUK MT is waiting for network personalization unblocking password to be given PH-NETSUB PIN MT is waiting for network subset personalization password to be given PH-NETSUB PUK MT is waiting for network subset personalization unblocking password to be given PH-SP PIN MT is waiting for service provider personalization password to be given PH-SP PUK MT is waiting for service provider personalization unblocking password to be given PH-CORP PIN MT is waiting for corporate personalization password to be given PH-CORP PUK MT is waiting for corporate personalization unblocking password to be given String type. Password. If the requested password was a PUK, such as (U)SIM PUK1, PH-FSIM PUK or another passwords, then must be followed by . String type. New password required if the requested code was a PUK. Example //Enter PIN. AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Enter PUK and PIN. AT+CPIN? +CPIN: SIM PUK K AT+CPIN='26601934','1234' //Queried PIN code is locked. //Enter PIN. //PIN has already been entered. //Queried PUK code is locked. //Enter PUK and new PIN password. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 61 / 316 OK CPIN: READY AT+CPIN? +CPIN: READY OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //PUK has already been entered. 5.4. AT+CPWD Change Password This command sets a new password for the facility lock function defined by AT+CLCK. This Test Command returns a list of pairs which present the available facilities and the maximum length of their password. AT+CPWD Change Password Test Command AT+CPWD=? Response +CPWD: ('AB',4),('AC',4),('AG',4),('AI',4),('AO',4),('IR ',4),('OI',4),('OX',4),('SC',8),('P2',8) Write Command AT+CPWD=,, Maximum Response Time Characteristic Reference 3GPP TS 27.007 OK Response OK 5 s The command takes effect immediately. The configuration will be saved automatically. Parameter String type. The facility lock 'SC' (U)SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command is issued) 'AO' BAOC (Bar All Outgoing Calls, refer to 3GPP TS 22.088 clause 1) 'OI' BOIC (Bar Outgoing International Calls, refer to 3GPP TS 22.088 clause 1) 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country, refer to 3GPP TS 22.088 clause 1) 'AI' BAIC (Bar All Incoming Calls, refer to 3GPP TS 22.088 clause 2) 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country, refer EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 62 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual to 3GPP TS 22.088 clause 2) 'AB' All barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AG' All outgoing barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AC All incoming barring services (refer to 3GPP TS 22.030, applicable only for =0) 'P2' (U)SIM PIN2 Integer type. Maximum length of the password. String type. Password specified for the facility from the user interface or with command. String type. New password Example AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' //Change (U)SIM card password to '4321'. OK //Restart the module or re-activate the SIM card. AT+CPIN? //Query PIN code is locked. +CPIN: SIM PIN OK AT+CPIN='4321' OK //PIN must be entered to define a new password '4321'. +CPIN: READY 5.5. AT+CSIM Generic (U)SIM Access This command allows a direct control of the (U)SIM that is installed in the currently selected card slot by a distant application on the TE. The TE shall then keep the processing of (U)SIM information within the frame specified by GSM/UMTS. AT+CSIM Generic (U)SIM Access Test Command AT+CSIM=? Write Command AT+CSIM=, Response OK Response +CSIM: , EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 63 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristic Reference 3GPP TS 27.007 OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Length of or string. Command transferred by the MT to the (U)SIM in the format as described in 3GPP TS 51.011. Response to the command transferred by the (U)SIM to the MT in the format as described in 3GPP TS 51.011. Error codes. For more details, please refer to Chapter 15.4. 5.6. AT+CRSM Restricted (U)SIM Access This command offers easy and limited access to the (U)SIM database. It transmits the (U)SIM command number and its required parameters to the MT. AT+CRSM Restricted (U)SIM Access Test Command AT+CRSM=? Write Command AT+CRSM=[,[,,,[,][,]]] Response OK Response +CRSM: ,[,] OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300 ms EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 64 / 316 Characteristic Reference 3GPP TS 27.007 Parameter , , , LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual The command takes effect immediately. The configuration will be saved automatically. Integer type. (U)SIM command number. 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS Integer type. Identifier for an elementary data file on (U)SIM, if used by . Integer type. Parameters transferred by the MT to the (U)SIM. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in 3GPP TS 51.011. Information which shall be written to the (U)SIM (hexadecimal character format; refer to AT+CSCS). The directory path of an elementary file on a SIM/UICC in hexadecimal format. Integer type. Information from the (U)SIM about the execution of the actual command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command. Response of a successful completion of the command previously issued (hexadecimal character format; refer to AT+CSCS). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. The information includes the type of file and its size (refer to 3GPP TS 51.011). After READ BINARY, READ RECORD or RETRIEVE DATA command, the requested data will be returned. is not returned after a successful UPDATE BINARY, UPDATE RECORD or SET DATA command. Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 65 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 5.7. AT+QCCID Show ICCID This command returns the ICCID (Integrated Circuit Card Identifier) number of (U)SIM card. AT+QCCID Show ICCID Test Command AT+QCCID=? Execution Command AT+QCCID Response OK Response +QCCID: Maximum Response Time Characteristics OK Or ERROR 300 ms / Parameter String without double quotes. ICCID (Integrated Circuit Card Identifier) number of the (U)SIM card. Example AT+QCCID +QCCID: 89860025128306012474 OK //Query ICCID of the (U)SIM card. 5.8. AT+QPINC Display PIN Remainder Counter This command queries the number of attempts left to enter the password of (U)SIM PIN/PUK. AT+ QPINC Display PIN Remainder Counter Test Command AT+QPINC=? Response +QPINC: (list of supported s) Read Command AT+QPINC? OK Response +QPINC: 'SC',, EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 66 / 316 Write Command AT+QPINC= Maximum Response Time Characteristics LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +QPINC: 'P2',, OK Response +QPINC: ,, OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter String type. 'SC' (U)SIM PIN 'P2' (U)SIM PIN2 Integer type. Number of attempts left to enter the password of PIN. Maximum value is 3. Integer type. Number of attempts left to enter the password of PUK. Maximum value is 10. Error codes. For more details, please refer to Chapter 15.4. 5.9. AT+QINISTAT Query Initialization Status of (U)SIM Card This command queries the initialization status of (U)SIM card. AT+QINISTAT Query Initialization Status of (U)SIM Card Test Command AT+QINISTAT=? Response +QINISTAT: (range of supported s) Execution Command AT+QINISTAT OK Response +QINISTAT: Maximum Response Time OK 300 ms EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 67 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Characteristics / Parameter Integer type. Initialization status of (U)SIM card. Actual value is the sum of several of the following four kinds (e.g. 7 = 1 + 2 + 4 means CPIN READY & SMS DONE & PB DONE). Default: 7. 0 Initial state 1 CPIN READY. Operation like lock/unlock PIN is allowed 2 SMS initialization completed 4 Phonebook initialization completed 5.10. AT+QSIMDET (U)SIM Card Detection This command enables (U)SIM card hot-swap function. (U)SIM card is detected by GPIO interrupt. The level of (U)SIM card detection pin should also be set when (U)SIM card is inserted. AT+QSIMDET (U)SIM Card Detection Test Command AT+QSIMDET=? Response +QSIMDET: (list of supported s),(list of supported s) Read Command AT+QSIMDET? OK Response +QSIMDET: , Write Command AT+QSIMDET=, OK Response OK Or ERROR Maximum Response Time 300 ms Characteristic The command takes effect after module is rebooted. The configuration will be saved automatically. Parameter Integer type. Enable or disable (U)SIM card detection. 0 Disable EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 68 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 1 Enable Integer type. The level of (U)SIM detection pin when a (U)SIM card is inserted. 0 Low level 1 High level NOTES 1. Hot-swap function is invalid if the configured value of is inconsistent with that of in hardware design. 2. Hot-swap function takes effect after the module is restarted. Example AT+QSIMDET=1,0 OK +CPIN: NOT READY +CPIN: READY //Set (U)SIM card detection pin level as low when (U)SIM card is inserted. //If PIN1 of (U)SIM card is unlocked. 5.11. AT+QSIMSTAT (U)SIM Card Insertion Status Report This command queries (U)SIM card insertion status or determines whether to report (U)SIM card insertion status. AT+QSIMSTAT (U)SIM Card Insertion Status Report Test Command AT+QSIMSTAT=? Response +QSIMSTAT: (list of supported s) Read Command AT+QSIMSTAT? OK Response +QSIMSTAT: , Write Command AT+QSIMSTAT= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 69 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. Enable or disable (U)SIM card insertion status report. If it is enabled, when (U)SIM card is removed or inserted, the URC +QSIMSTAT: , will be reported. 0 Disable 1 Enable Integer type. (U)SIM card is inserted or removed. This argument is not allowed to be set. 0 Removed 1 Inserted 2 Unknown, before (U)SIM initialization Example AT+QSIMSTAT? +QSIMSTAT: 0,1 K AT+QSIMDET=1,0 K AT+QSIMSTAT=1 K AT+QSIMSTAT? +QSIMSTAT: 1,1 OK +QSIMSTAT : 1,0 CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK +QSIMSTAT: 1,1 +CPIN: READY //Query (U)SIM card insertion status. //Enable (U)SIM card insertion status report. //Report of (U)SIM card insertion status: removed. //Report of (U)SIM card insertion status: inserted. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 70 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 5.12. AT+QSIMVOL Fix (U)SIM Card Supply Voltage This command fixes supply voltage of (U)SIM card. For a common UICC, the supply voltage of (U)SIM card is usually 1.8V or 3.0V. AT+QSIMVOL Fix (U)SIM Card Supply Voltage Test Command AT+QSIMVOL=? Response +QSIMVOL: (range of supported s) Read Command AT+QSIMVOL? OK Response +QSIMVOL: Write Command AT+QSIMVOL= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect after module is rebooted. The configuration will be saved automatically. Parameter Integer type. Mode of supply voltage of (U)SIM card. 0 Not fixed supply voltage of (U)SIM 1 Fixed supply voltage of (U)SIM card of 1.8 V 2 Fixed supply voltage of (U)SIM card is equal of 3.0 V Example AT+QSIMVOL=? +QSIMVOL: (0-2) OK AT+QSIMVOL? +QSIMVOL: 0 OK AT+QSIMVOL=1 OK AT+QSIMVOL? EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 71 / 316 +QSIMVOL: 1 OK AT+QSIMVOL=2 OK AT+QSIMVOL? +QSIMVOL: 2 OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 5.13. AT+CCHO Open Logical Channel This command opens a logical channel of (U)SIM card. AT+CCHO Open Logical Channel Test Command AT+CCHO=? Response OK Write Command AT+CCHO= Response Maximum Response Time Characteristics OK Or ERROR 300 ms The command takes effect immediately. The configuration will not be saved. Parameter String type. All sel applications in the UICC are referenced by a DF name coded on 1 to 16 bytes. Integer type. A session ID to be used to target a specific application on the smart card using logical channels mechanism. NOTE The logical channel number is contained in the CLASS byte of an APDU command, thus implicitly contained in all APDU commands sent to a UICC. In this case it will be up to the MT to manage the logical channel part of the APDU CLASS byte and to ensure that the chosen logical channel is relevant to the indicated in the AT command. See 3GPP TS 31.101 [65] for further information on logical EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 72 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual channels in APDU commands protocol. Example AT+CCHO=? //Test command. OK AT+CCHO='A0000000871002FF86FFFF89FFFFFFFF' // is made up of AID strings. +CCHO: 1 //The session ID is 1. OK 5.14. AT+CGLA UICC Logical Channel Access This command accesses a UICC logical channel. AT+CGLA UICC Logical Channel Access Test Command AT+CGLA=? Response OK Write Command AT+CGLA=,, Response +CGLA: , OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configuration will not be saved. Parameter Integer type. This is the identifier of the session to be used to send the APDU commands to the UICC. It is mandatory to send commands to the UICC when targeting applications on the smart card using a logical channel other than the default channel (channel '0'). Integer type. Length of the characters that are sent to TE in or (Twice the actual length of the command or response). Command passed on by the MT to the UICC in the format as described in 3GPP TS 31.101 [65] (hexadecimal character format; refer +cscs) Response to the command passed on by the UICC to the MT in the format as described in 3GPP TS 31.101 [65] (hexadecimal character format; refer +cscs). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 73 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+CGLA=? OK AT+CGLA=1,14,'00A40804022F00' +CGLA: 4,'6121' //Test command. //The command is 00A40804022F00. //The length is 4, the response is 6121. OK 5.15. AT+CCHC Close Logical Channel This command closes a logical channel of (U)SIM card with the given . AT+CCHC Close Logical Channel Test Command AT+CCHC=? Response OK Write Command AT+CCHC= Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configuration will not be saved. Parameter Inter type. A session ID to be used to target a specific application on the smart card using logical channels mechanism. Example AT+CCHC=? OK AT+CCHC=1 OK //Test command. //Close logical channel: 1. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 74 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6 Network Service Commands 6.1. AT+COPS Operator Selection This command returns the current operators and their status, and allows setting automatic or manual network selection. This Test Command returns a set of five parameters, each representing an operator presenting in the network. Any of the formats may be unavailable and should then be an empty field. The list of operators shall be in the order of: home network, networks referenced in (U)SIM and other networks. This Read Command returns the current mode and the currently selected operator. If no operator is selected, , and are omitted. This Write Command forces an attempt to select and register the GSM/UMTS network operator. If the selected operator is not available, no other operator shall be selected (except =4). The format of selected operator name shall apply to further Read Command (AT+COPS?). AT+COPS Operator Selection Test Command AT+COPS=? Response +COPS: (list of supported ,long alphanumeric ,short alphanumeric ,numeric s)[,]) s][,,(list of supported s),(list of supported s)] OK Read Command AT+COPS? If there is any error related to ME functionality: +CME ERROR: Response +COPS: [,[,][,]] OK If there is any error related to ME functionality: +CME ERROR: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 75 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Write Command AT+COPS=[,[,[,]]] Maximum Response Time Response OK If there is any error related to ME functionality: +CME ERROR: 180 s, determined by network. Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. Parameter Integer type. 0 Unknown 1 Operator available 2 Current operator 3 Operator forbidden Operator in format as per. determines whether is present or not. Integer type. 0 Automatic mode. field is omitted 1 Manual operator selection. field shall be present and optionally 2 Manually deregister from network 3 Set only (for AT+COPS? Read Command), and do not attempt registration/deregistration ( and fields are ignored). This value is invalid in the response of Read Command. 4 Manual/automatic selection. field shall be presented. If manual selection fails, automatic mode (=0) is entered Integer type. Indicates the format of . 0 Long format alphanumeric which can be up to 16 characters long 1 Short format alphanumeric 2 Numeric . GSM location area identification number Integer type. Access technology selected. Values 3, 4, 5 and 6 occur only in the response of Read Command while MS is in data service state and is not intended for the AT+COPS Write Command. 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 100 CDMA EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 76 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Error codes. For more details, please refer to Chapter 15.4. Example AT+COPS=? //List all current network operators. +COPS: (1,'CHN-UNICOM','UNICOM','46001',2),(1,'CHN-UNICOM','UNICOM','46001',0),(2,'CH N-UNICOM','UNICOM','46001',7),(1,'46011','46011','46011',7),(3,'CHINA MOBILE','CMCC','46 000',0),,(0,1,2,3,4),(0,1,2) OK AT+COPS? +COPS: 0,0,'CHN-UNICOM',7 //Query the currently selected network operator. OK 6.2. AT+CREG Network Registration Status This Read Command returns the status of result code presentation and an integer which shows whether the network has currently indicated the registration of the ME. Location information elements and are returned only when =2 and ME is registered on the network. This Write Command controls the presentation of an unsolicited result code +CREG: when =1 and there is a change in the ME network registration status. AT+CREG Network Registration Status Test Command AT+CREG=? Response +CREG: (list of supported s) Read Command AT+CREG? OK Response +CREG: ,[,,[,]] OK Write Command AT+CREG[=] Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: Response OK 300 ms The command takes effect immediately. The configuration will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 77 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference 3GPP TS 27.007 Parameter Integer type. Whether to enable related registration network. 0 Disable network registration URC 1 Enable network registration URC +CREG: 2 Enable network registration URC with location information: +CREG: [,,[,]] Integer type. Registration network status. 0 Not registered. ME is not currently searching a new operator to register to 1 Registered, home network 2 Not registered, but ME is currently searching a new operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two bytes location area code in hexadecimal format. String type. 16-bit (GSM) or 28-bit (UMTS/LTE) cell ID in hexadecimal format. Integer type. Access technology selected. 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN Error codes. For more details, please refer to Chapter 15.4. Example AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'D509','80D413D',7 //URC reports that ME has registered on network. //Activate extended URC mode. //URC reports that operator has found location area code and cell ID. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 78 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6.3. AT+CSQ Signal Quality Report This command indicates the received signal strength and the channel bit error rate . This Test Command returns values supported by MT. This Execution Command returns received signal strength indication and channel bit error rate from MT. AT+CSQ Signal Quality Report Test Command AT+CSQ=? Response +CSQ: (list of supported s),(list of supported s) Execution Command AT+CSQ OK Response +CSQ: , OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is error related to MT functionality: +CME ERROR: 300 ms / Parameter Integer type. Received signal strength indication. 0 -113 dBm or less 1 -111 dBm 2–30 -109 dBm to -53 dBm 31 -51 dBm or greater 99 Not known or not detectable 100 -116 dBm or less 101 -115 dBm 102...190 -114 dBm to -26 dBm 191 -25 dBm or greater 199 Not known or not detectable 100–199 Extended to be used in TD-SCDMA indicating received signal code power (RSCP) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 79 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. Channel bit error rate (in percent). 0–7 As RxQual values in the table in 3GPP TS 45.008 subclause 8.2.4 99 Not known or not detectable Example AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,99 //The current signal strength indication is 28 dBm and channel bit error rate is 99 dBm. OK NOTE After using network related commands such as AT+CCWA and AT+CCFC, it is recommended to wait for 3 seconds before entering AT+CSQ so as to ensure that any network access required for the preceding command has been finished. 6.4. AT+CPOL Preferred Operator List This command edits and queries the list of preferred operators. AT+CPOL Preferred Operator List Test Command AT+CPOL=? Response +CPOL: (list of supported s),(list of supported s) Read Command AT+CPOL? OK Response Query the list of preferred operators: +CPOL: ,,[,,,,] [+CPOL: ,,[,,,, …] Write Command OK Response EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 80 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CPOL=[,[,[,, ,]]] Edit the list of preferred operators: OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If the is given but the is omitted, the entry is deleted. 300 ms The command takes effect immediately. Parameter Integer type. The order number of the operator in the (U)SIM preferred operator list. Integer type. Format of . 0 Long format alphanumeric 1 Short format alphanumeric 2 Numeric String type. indicates the format is alphanumeric or numeric (see AT+COPS). Integer type. GSM access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. GSM compact access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. UTRAN access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. E-UTRAN access technology. 0 Access technology is not selected 1 Access technology is selected NOTE The access technology selection parameters , , and are required for (U)SIM cards or UICC’s containing PLMN selector with access technology. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 81 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6.5. AT+COPN Read Operator Names This command returns the list of the supported operator names from MT. Each operator code that has an alphanumeric equivalent in the MT memory is returned. AT+COPN Read Operator Names Test Command AT+COPN=? Execution Command AT+COPN Response OK Response +COPN: , [+COPN: , …] OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is error related to ME functionality: +CME ERROR: Depends on the number of operator names. / Parameter String type. Operator in numeric format (see AT+COPS). String type. Operator in long alphanumeric format (see AT+COPS). Error codes. For more details, please refer to Chapter 15.4. 6.6. AT+CTZU Automatic Time Zone Update This command enables/disables automatic time zone update via NITZ. AT+CTZU Automatic Time Zone Update Test Command AT+CTZU=? Response +CTZU: (list of supported s) Write Command AT+CTZU= OK Response OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 82 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Read Command AT+CTZU? Maximum Response Time Characteristics Reference 3GPP TS 27.007 Or ERROR Response +CTZU: OK 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. The mode of automatic time zone update. 0 Disable automatic time zone update via NITZ. 1 Enable automatic time zone update via NITZ 3 Enable automatic time zone update via NITZ and update LOCAL time to RTC Example AT+CTZU? +CTZU: 0 //Read command. OK AT+CTZU=? +CTZU: (0,1,3) //Test command. OK AT+CTZU=1 OK AT+CTZU? +CTZU: 1 //Enable automatic time zone update. OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 83 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6.7. AT+CTZR Time Zone Reporting This command controls the time zone reporting of changed event. If reporting is enabled, the MT returns the unsolicited result code +CTZV: or +CTZE: ,, whenever the time zone is changed. AT+CTZR Time Zone Reporting Test Command AT+CTZR=? Response +CTZR: (range of supported s) Write Command AT+CTZR= Read Command AT+CTZR? OK Response OK Or ERROR Response +CTZR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms The command takes effect after module is rebooted. The configuration will be saved automatically. Parameter Integer type. The mode of time zone reporting. 0 Disable time zone reporting of changed event 1 Enable time zone reporting of changed event by URC +CTZV: 2 Enable extended time zone reporting by URC +CTZE: ,, String type. The sum of the local time zone (difference between the local time and GMT is expressed in quarters of an hour) plus daylight saving time. The format is '±zz', expressed as a fixed width, two-digit integer with the range -48 to +56. To maintain a fixed width, numbers in the range -9 to +9 are expressed with a leading zero, e.g. '-09', '+00' and '+09'. Integer type. Indicates whether includes daylight savings adjustment. 0 includes no adjustment for daylight saving time 1 includes +1 hour (equals 4 quarters in ) adjustment for daylight saving time 2 includes +2 hours (equals 8 quarters in ) adjustment for daylight saving time EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 84 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual String type. The local time. The format is 'YYYY/MM/DD,hh:mm:ss', expressed as integers representing year (YYYY), month (MM), date (DD), hour (hh), minute (mm) and second (ss). This parameter can be provided by the network when delivering time zone information and will be presented in the unsolicited result code of extended time zone reporting if provided by the network. Example AT+CTZR=2 OK AT+CTZR? +CTZR: 2 OK +CTZE: '+32',0,'2017/11/04,06:51:13' //Extended time zone and local time reporting by URC. 6.8. AT+QLTS Obtain the Latest Time Synchronized Through Network This command obtains the latest time synchronized through network. This Execution Command returns the latest time that has been synchronized through network. AT+QLTS Obtain the Latest Time Synchronized Through Network Test Command AT+QLTS=? Response +QLTS: (range of supported s) Execution Command AT+QLTS OK Response +QLTS: , Write Command AT+QLTS= OK Response +QLTS: , OK Or ERROR If there is error related to ME functionality: +CME ERROR: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 85 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics 300 ms The command takes effect immediately. Parameter Integer type. Network time obtaining mode. 0 Query the latest time that has been synchronized through network 1 Query the current GMT time calculated from the latest time that has been synchronized through network 2 Query the current LOCAL time calculated from the latest time that has been synchronized through network String type value. Format is 'YYYY/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; Range: -48 to +48). E.g. 6th of May 2004, 22:10:00 GMT+2 hours equals to '04/05/06,22:10:00+08' Integer type. Daylight saving time. Range: 0–2. Error codes. For more details, please refer to Chapter 15.4. NOTE If the time has not been synchronized through network, the command will return a null time string as +QLTS: ''. Example AT+QLTS=? +QLTS: (0-2) //Query the supported network time mode. OK AT+QLTS //Query the latest time synchronized through network. +QLTS: '2017/10/13,03:40:48+32,0' OK AT+QLTS=0 //Query the latest time synchronized through network. It acts the same function as Execution Command AT+QLTS. +QLTS: '2017/10/13,03:40:48+32,0' OK AT+QLTS=1 //Query the current GMT time calculated from the latest time that has been synchronized through network. +QLTS: '2017/10/13,03:41:22+32,0' OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 86 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+QLTS=2 //Query the current LOCAL time calculated from the latest time that has been synchronized through network +QLTS: '2017/01/13,11:41:23+32,0' OK 6.9. AT+QNWINFO Query Network Information This command queries network information such as the selected access technology, operator and band. AT+QNWINFO Query Network Information Test Command AT+QNWINFO=? Execution Command AT+QNWINFO Response OK Response +QNWINFO: ,,, Maximum Response Time Characteristics OK 300 ms / Parameter String type. Selected access technology. 'NONE' 'CDMA1X' 'CDMA1X AND HDR' 'CDMA1X AND EHRPD' 'HDR' 'HDR-EHRPD' 'GSM' 'GPRS' 'EDGE' 'WCDMA' 'HSDPA' 'HSUPA' 'HSPA+' 'TDSCDMA' 'TDD LTE' 'FDD LTE' String type. The operator in numeric format. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 87 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual String type. The selected band. 'CDMA BC0' – 'CDMA BC19' 'GSM 450' 'GSM 480' 'GSM 750' 'GSM 850' 'GSM 900' 'GSM 1800' 'GSM 1900' 'WCDMA 2100' 'WCDMA 1900' 'WCDMA 1800' 'WCDMA 1700 US' 'WCDMA 850' 'WCDMA 800' 'WCDMA 2600' 'WCDMA 900' 'WCDMA 1700 JAPAN' 'WCDMA 1500' 'WCDMA 850 JAPAN' 'LTE BAND 1' to 'LTE BAND 43' 'LTE BAND 66' 'LTE BAND 71' 'TDSCDMA BAND A' 'TDSCDMA BAND B' 'TDSCDMA BAND C' 'TDSCDMA BAND D' 'TDSCDMA BAND E' 'TDSCDMA BAND F' Integer type. Channel ID. Example AT+QNWINFO=? OK AT+QNWINFO +QNWINFO: 'FDD LTE',46011,'LTE BAND 3',1650 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 88 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6.10. AT+QSPN Display the Name of Registered Network AT+QSPN Display the Name of Registered Network Test Command AT+QSPN=? Execution Command AT+QSPN Response OK Response +QSPN: ,,,, Maximum Response Time Characteristics OK 300 ms / Parameter String type. Full network name. String type. Short network name. String type. Service provider name. Integer type. Alphabet of full network name and short network name. 0 GSM 7-bit default alphabet 1 UCS2 String type. Registered PLMN. NOTES 1. If is 0, and will be shown in GSM 7-bit default alphabet string. 2. If is 1, and will be shown in UCS2 hexadecimal string. Example AT+QSPN //Query the EONS information of RPLMN. +QSPN: 'CHN-UNICOM','UNICOM','',0,'46001' OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 89 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6.11. AT+QNETINFO Query Network Information of RATs This command queries the specified parameter of the specified RAT. AT+QNETINFO Query Network Information of RATs Test Comannd AT+QNETINFO=? Response +QNETINFO: , Write Command AT+QNETINFO=, OK Response +QNETINFO: , , …… , Maximum Response Time Characteristics OK Or ERROR 300 ms The command takes effect after module is rebooted. Parameter Integer type. Access technology selected. 0 GSM 1 WCDMA 2 LTE 3 TD-SCDMA 4 UMTS 5 CDMA 6 HDR Digital format (HEX). Function mask. Range: 00xFFFFFFFF, and each bit represents a function. rat Bit Function , 0 drx 'drx',value GSM ... - 31 - WCDMA 0 drx 'drx',value EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 90 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual ... - 31 - 0 rsssnr 'rsssnr',value 1 timing advance 'timingadvance',value LTE 2 drx 'drx',value1,value2,value3 … - 31 - 0 - TD-SCDMA* … - 31 - 0 - UMTS* … - 31 - 0 - CDMA* … - / 31 - / 0 - / HDR* … - / 31 - / In the table, ‘-’ indicates that this bit is not defined yet. When querying the drx of LTE, it returns three parameters value1, value2, and value3 indicating the idle DRX period, the short CDRX period, and the long CDRX period respectively. String type. Access technology selected. 'GSM' 'WCDMA' 'LTE' 'TD-SCDMA' 'UMTS' 'CDMA' 'HDR' EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 91 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Digtal format (DEC). Number of response functions. String type. Function. The format is related to . The value format of different is different. If the return value is null, '-' will be returned. NOTES 1. Each bit of the in each network mode represents a function. For example, the 0th bit of the in LTE indicates quering rsssnr, and the first bit indicates quering timing advance. 2. When the response is returned, if there is an undefined bit in the bit set to the of the AT command, then is smaller than the number of bits set in the of the AT command. Example AT+QNETINFO=2,1 +QNETINFO: 'LTE',1 'rsssnr',10 OK AT+QNETINFO=2,1 +QNETINFO: 'LTE',1 'rsssnr',- OK AT+QNETINFO=2,7 +QNETINFO: 'LTE',1 'rsssnr',10 'timingadvance',39 'drx',320,0,0 OK AT+QNETINFO=0,1 +QNETINFO: 'GSM', 1 'drx',471 OK AT+QNETINFO=1,1 +QNETINFO: 'WCDMA', 1 'drx',1280 //Query rsssnr of LTE network. //Query rsssnr, timingadvance, drx of LTE network. //Query drx of GSM network. //Query drx of WCDMA network. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 92 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual OK 6.12. AT+QNWLOCK='common/lte' Network Locking Configuration This command locks module to a specified FREQ or cell. AT+QNWLOCK='common/lte' Network Locking Configuration Test Command AT+QNWLOCK=? Response … +QNWLOCK: 'common/lte'[,[,,[,]]] Write Command AT+QNWLOCK='common/lte'[,< action>[,,]] OK Response If the optional parameters are omitted, query the current setting: +QNWLOCK: 'common/lte',,,, OK Maximum Response Time Characteristics If the optional parameters are specified, lock the module to a specified FREQ or cell: OK Or ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. 0 Disable lock cell 1 Enable lock LTE cell through appointed EARFCN 2 Enable lock LTE cell through appointed EARFCN and PCI Integer type. The appointed EARFCN of cell to be locked. Default: 0. Integer type. The appointed PCI of cell to be locked. Default: 0. Integer type. Finish/not finish locking or unlocking cell. Default: 0. 0 Finish locking or unlocking cell 1 Not finish locking or unlocking cell EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 93 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual NOTES 1. Modules can unlock cell after setting to 0 and restarting module. 2. Modules need be fixed to LTE-only mode with AT+QCFG='NWSCANMODE',3 before locking LTE cell with this command. For more details, please refer to document [12]. Example AT+QCFG='NWSCANMODE',3 OK AT+QNWLOCK='common/lte' +QNWLOCK: 'common/lte',0,0,0,0 //Query lock cell status. OK AT+QNWLOCK='common/lte',1,38400,0 OK AT+QNWLOCK='common/lte' +QNWLOCK: 'common/lte',1,38400,0,0 //Lock cell on EARFCN 38400. OK AT+QNWLOCK='common/lte',2,38400,87 OK AT+QNWLOCK='common/lte' +QNWLOCK: 'common/lte',2,38400,87,0 //Lock cell on PCI 87 of EARFCN 38400. OK AT+QENG='SERVINGCELL' +QENG: 'servingcell','NOCONN','LTE','TDD',460,00,82E8C80,87,38400,39,5,5,550A,-93,-13,-59,4,46 OK AT+QNWLOCK='common/lte',0 //Disable lock cell feature. OK AT+QNWLOCK='common/lte' +QNWLOCK: 'common/lte',0,38400,87,1 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 94 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6.13. AT+QOPSCFG='scancontrol' Configure Bands to be Scanned in 2G/3G/4G AT+QOPSCFG='scancontrol' Configure Bands to be Scanned in 2G/3G/4G Test Command AT+QOPSCFG=? Response +QOPSCFG: 'scancontrol',(range of supported s),(range of supported s),(range of supported s),(range of supported s) Write Command AT+QOPSCFG='scancontrol'[, [,,,]] OK Response If , , and are omitted, query the current configuration: +QOPSCFG: 'scancontrol',,,, OK If , and are omitted, configure all bands to be scanned in 2G/3G/4G: OK Or ERROR Maximum Response Time Characteristics If , , and are specified, configure bands to be scanned in 2G/3G/4G: OK Or ERROR 300 ms This command takes effect immediately; The configurations will not be saved. Parameter Number format in DEC. Network mode. 0 2G 1 3G 2 4G 3 2G, 3G and 4G A hexadecimal value that specifies the GSM and WCDMA frequency bands. If it is set EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 95 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual to 0, it means not to change GSM and WCDMA frequency bands. Range: 0-FFFF. (e.g.: 00000013 = 00000001 (EGSM900) + 00000002 (DCS1800) + 00000010 (WCDMA2100)). 00000000 No change 00000001 EGSM900 00000002 DCS1800 00000004 GSM850 00000008 PCS1900 00000010 WCDMA2100 00000020 WCDMA1900 00000040 WCDMA850 00000080 WCDMA900 00000100 WCDMA800 00000200 WCDMA1700 0000FFFF Any frequency band A hexadecimal value that specifies the LTE frequency band. If it is set to 0 or 0x40000000, it means not to change LTE frequency band. Range: 0-7FFFFDF3FFF (e.g.: 0x15 = 0x1 (LTE B1) + 0x4 (LTE B3) + 0x10 (LTE B5)). 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x40 (CM_BAND_PREF_LTE_EUTRAN_BAND7) LTE B7 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 0x80000 (CM_BAND_PREF_LTE_EUTRAN_BAND20) LTE B20 0x7FFFFFFFFFFFFFFF (CM_BAND_PREF_ANY) Any frequency band A hexadecimal value that specifies the TD-SCDMA frequency band. If it is set to 0 or 0x40000000, it means not to change TD-SCDMA frequency band. Range: 0-3F (e.g.0x21 = 0x1 (TDS BCA) + 0x20 (TDS BCF). 0x1 (CM_BAND_PREF_TDS_BANDA) TDS BCA 0x2 (CM_BAND_PREF_TDS_BANDB) TDS BCB 0x4 (CM_BAND_PREF_TDS_BANDC) TDS BCC 0x8 (CM_BAND_PREF_TDS_BANDD) TDS BCD 0x10 (CM_BAND_PREF_TDS_BANDE) TDS BCE 0x20 (CM_BAND_PREF_TDS_BANDF) TDS BCF NOTE 1. means all bands in GSM and WCDMA, ranging from 0 to FFFFFFFFBFFFFFFF. When setting as a value in the range of 0-FFFF, it corresponds to the band value in the range of 0-FFFFFFFFBFFFFFFF in GSM/WCDMA. 2. It is recommended to scan full bands in GSM/WCDMA (i.e. when configuring to scan GSM and WCDMA band, set the value of to FFFF) due to a small amount of bands in GSM/WCDMA. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 96 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 6.14. AT+QOPSCFG='displayrssi' Enable/Disable to Display RSSI in LTE AT+QOPSCFG='displayrssi' Enable/Disable to Display RSSI in LTE Write Command AT+QOPSCFG='displayrssi', Response OK Or ERROR Maximum Response Time 300 ms Characteristics This command takes effect immediately; The configuration will not be saved. Parameter Numeric format in DEC. Enable/Disable to display RSSI in LTE 1 Enable 0 Disable NOTE After configuring =1, when scanning bands in LTE or all bands in GSM/WCDMA/LTE via AT+QOPS, RSSI value in LTE will be returned. 6.15. AT+QOPS Band Scan This command triggers band scan. The Execution Command lists the available network information of operators for all neighbor cell. AT+QOPS Band Scan Execution Command AT+QOPS Response For 2G: +QOPS: ,, ,<RAT,,,,,,,, […] EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 97 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual For 3G: +QOPS: ,, ,,,,,,,, […] OK For 4G: +QOPS: ,, ,,,,,,,, […] OK If there is any error: ERROR Parameter Operator name in long string. Operator name in short string. Operator name in integer. Integer type. The item’s ID in results. String type. '2G' 2G network '3G' 3G network '4G' 4G network Numeric format in DEC. The ARFCN or UARFCN of cell. Numeric format in HEX. Location area code. Numeric format in HEX. Cell ID. Numeric format in DEC. Base station identification code. Numeric format in DEC. RX level. Numeric format in DEC. Cell selection criterion. Numeric format in DEC. Cell bar access. 0 Unbarred cell 1 Barred cell Numeric format in DEC. Indicate whether current cell support GPRS or not. 0 Not support GPRS 1 Support GPRS Number format in DEC. Primary scrambling code. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 98 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Number format in DEC. Received signal code power level. Number format in DEC. Indicator of network quality. Number format in DEC. Physical cell ID. Number format in DEC. Tracking area code. Reference Signal Receiving Power. Reference Signal Receiving Quality. NOTES 1. This command conflicts with network selection mode that is fixed to one of network types. Network selection mode must be set to AUTO mode by AT+QCFG='NWSCANMODE',0. 2. Execute this command in idle state. If CS or PS connections have been established, the signaling on the air will interrupt AT+QOPS and then the module will return ERROR. 3. Before scanning band with this command, please configure the network mode and specific band. Example AT+QOPSCFG='scancontrol',0 OK AT+QOPS +QOPS: 'CHINA MOBILE','CMCC','46000' 1,'2G',16,550B,D89,16,35,27,0,1 2,'2G',124,550B,3A40,20,80,1,0,1 ... +QOPS: 'CHN-UNICOM','UNICOM','46001' 1,'2G',234,5504,56E3,27,44,12,0,1 2,'2G',536,6254,7F62,13,70,1,0,1 .... OK AT+QOPSCFG='scancontrol',1 OK AT+QOPS +QOPS: 'CHN-UNICOM','UNICOM','46001' 1,'3G',10688,5,D5D5,8055189,-109,27,0 OK AT+QOPSCFG='scancontrol',2 OK AT+QOPS +QOPS: 'CHINA MOBILE','CMCC','46000' 1,'4G',38950,206,550B,F2D4A42,-72,-11,0 2,'4G',39148,206,550B,F2D4A44,-73,-12,0 //Configure to scan all bands in 2G network. //Scan all bands in 2G network. //Configure to scan all bands in 3G network. //Scan all bands in 3G network. //Configure to scan all bands in 4G network. //Scan all bands in 4G network. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 99 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 3,'4G',1300,121,550B,5C4EF2D,-99,-17,0 4,'4G',38400,121,550B,5C4EF01,-99,-16,0 5,'4G',3683,121,550B,5C4EF29,-99,-11,0 6,'4G',38098,428,550B,F48330E,-112,-20,0 7,'4G',1425,116,550B,80A61AA,-118,-25,0 +QOPS: 'CHN-CT','CT','46011' 1,'4G',100,466,691D,DD8A30B,-75,-11,0 2,'4G',1850,314,691D,690843E,-88,-12,0 3,'4G',2452,9,691D,690271D,-97,-12,0 +QOPS: 'CHN-UNICOM','UNICOM','46001' 1,'4G',1650,465,550C,5A29C0B,-78,-10,0 2,'4G',3770,312,550C,5F1EA65,-98,-13,0 3,'4G',1506,330,550C,5A7980D,-107,-15,0 OK AT+QOPSCFG='scancontrol',3 //Configure to scan all bands in 2G, 3G and 4G network. OK AT+QOPS //Scan all bands in 2G, 3G and 4G network. +QOPS: 'CHINA MOBILE','CMCC','46000' 1,'2G',32,550B,34B8,63,26,18,0,1 2,'2G',16,550B,D89,34,26,18,0,1 3,'4G',39148,206,550B,F2D4A44,-71,-4,0 4,'4G',38950,206,550B,F2D4A42,-80,-4,0 5,'4G',1300,121,550B,5C4EF2D,-100,-4,0 6,'4G',38400,121,550B,5C4EF01,-101,-11,0 7,'4G',3683,471,550B,84958A8,-103,-4,0 8,'4G',38544,168,550B,104FD44,-111,-11,0 9,'4G',36275,169,550B,104FD77,-116,-13,0 10,'4G',40738,428,550B,F48330E,-119,-11,0 +QOPS: 'CHN-UNICOM','UNICOM','46001' 1,'3G',10688,387,D5D6,8066479,-106,23,0 2,'4G',1650,465,550C,5A29C0B,-74,0,0 3,'4G',3770,312,550C,5F1EA65,-96,-4,0 4,'4G',1506,330,550C,5A7980D,-108,-4,0 +QOPS: 'CHN-CT','CT','46011' 1,'4G',100,466,691D,DD8A30B,-71,-4,0 2,'4G',2452,9,691D,690271D,-92,-10,0 3,'4G',1850,314,691D,690843E,-99,-4,0 +QOPS: 'AT&T','AT&T','310410' 1,'4G',2525,3,1,1A2D003,-106,-15,0 OK AT+QOPSCFG='scancontrol',2,0,1,0 OK //Configure to scan LTE Band1 in 4G. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 100 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+QOPS +QOPS: 'CHN-CT','CT','46011' 1,'4G',100,466,691D,DD8A30B,-74,-12,0 OK AT+QOPSCFG='displayrssi',1 OK AT+QOPSCFG='scancontrol',2,0,1,0 OK AT+QOPS +QOPS: 'CHN-CT','CT','46011' 1,'4G',100,466,691D,DD8A30B,-71,-11,-40,0 OK //Scan LTE Band1 in 4G. //Enable to display RSSI. //Configure to scan LTE Band1 in 4G. //Scan LTE Band1 in 4G. //The value of RSSI is -40. 6.16. AT+QFPLMNCFG FPLMN Configuration This command configures FPLMN (Forbidden Public Land Mobile Network), including adding a PLMN to FPLMN, removing a PLMN from FPLMN list. AT+QFPLMNCFG FPLMN Configuration Test Command AT+QFPLMNCFG=? Response +QFPLMNCFG: 'List' +QFPLMNCFG: 'Add', +QFPLMNCFG: 'Delete',(,'all') Write Command AT+QFPLMNCFG=[,][, (,'all')] OK Response If is equal to 'List', return current FPLMN list: +QFPLMNCFG: 'List',, [+QFPLMNCFG: 'List',, […]] OK If is equal to 'Add' or 'Delete': OK Or ERROR If error is related to ME functionality: +CME ERROR: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 101 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter String type. The operation command of FPLMN. 'List' List of Forbidden PLMN 'Add' Add a specified PLMN to FPLMN 'Delete' Delete a specified PLMN or all PLMN form FPLMN Integer type. Index of FPLMN. Integer type. PLMN. Error codes. For more details, please refer to Chapter 15.4. Example AT+QFPLMNCFG=? +QFPLMNCFG: 'List' +QFPLMNCFG: 'Add', +QFPLMNCFG: 'Delete',(,'all') OK AT+QFPLMNCFG='List' +QFPLMNCFG: 'List',1,'46000' +QFPLMNCFG: 'List',2,'46002' +QFPLMNCFG: 'List',3,'46004' +QFPLMNCFG: 'List',4,'46007' +QFPLMNCFG: 'List',5,'46008' +QFPLMNCFG: 'List',6,'46003' +QFPLMNCFG: 'List',7,'46011' +QFPLMNCFG: 'List',8,'46008' OK AT+QFPLMNCFG='Add','46001' OK AT+QFPLMNCFG='List' +QFPLMNCFG: 'List',1,'46000' +QFPLMNCFG: 'List',2,'46002' +QFPLMNCFG: 'List',3,'46004' +QFPLMNCFG: 'List',4,'46007' +QFPLMNCFG: 'List',5,'46008' +QFPLMNCFG: 'List',6,'46003' +QFPLMNCFG: 'List',7,'46011' +QFPLMNCFG: 'List',8,'46008' //Add PLMN '46001' from FPLMN list. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 102 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +QFPLMNCFG: 'List',9,'46001' OK AT+QFPLMNCFG='Delete','46001' OK AT+QFPLMNCFG='List' +QFPLMNCFG: 'List',1,'46000' +QFPLMNCFG: 'List',2,'46002' +QFPLMNCFG: 'List',3,'46004' +QFPLMNCFG: 'List',4,'46007' +QFPLMNCFG: 'List',5,'46008' +QFPLMNCFG: 'List',6,'46003' +QFPLMNCFG: 'List',7,'46011' +QFPLMNCFG: 'List',8,'46008' OK AT+QFPLMNCFG='Delete','all' OK AT+QFPLMNCFG='List' OK //Delete PLMN '46001' from FPLMN list. //Delete all PLMN from FPLMN list. 6.17. AT+QENG Switching on/off Engineering Mode Engineering mode is designed to report the information of serving cells, neighbour cells and packet switch parameters. The command switches on/off the mode. AT+QENG Switching on/off Engineering Mode Test Command AT+QENG=? Response +QENG: (list of supported s) AT+QENG='servingcell' Query the information of serving cells OK Response In the case of GSM mode: +QENG: 'servingscell',,'GSM',,,,,,,,,,,,,,,,,,,,,,,, OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 103 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual In the case of WCDMA mode: +QENG: 'servingcell',,'WCDMA',,, ,,,,,,,,,,, OK In the case of LTE mode: +QENG: 'servingcell',,'LTE',,,,,,,,,,,,,,, OK In the case of TD-SCDMA mode: +QENG: 'servingscell',,'TDSCDMA',,,,,,,, OK In the case of CDMA mode or CDMA+HDR mode: +QENG: 'servingscell',,'CDMA',,,< LAC>,,,,, [+QENG: 'servingscell',,'HDR',,,,,,,,] OK In the case of SRLTE mode: +QENG: 'servingscell',,'CDMA',,,< LAC>,,,,, +QENG: 'servingcell',,'LTE',,,,,,,,,,,,,,, AT+QENG='neighbourcell' Query the information of neighbour cells OK Response In the case of GSM mode: [+QENG: 'neighbourcell','GSM',,,,< cellID>,,,,,,, […]] [+QENG: 'neighbourcell','WCDMA',,,, […]] [+QENG: 'neighbourcell','LTE',,,, […]] OK In the case of WCDMA mode: [+QENG: 'neighbourcell','WCDMA',,,,,,,, […]] [+QENG: 'neighbourcell','GSM',,,, […]] [+QENG: 'neighbourcell','LTE',,,, , […]] OK In the case of LTE mode: [+QENG: 'neighbourcell intra','LTE',,,,,,,,,,, […]] [+QENG: 'neighbourcell inter','LTE',,,,,,,,,, […]] [+QENG: 'neighbourcell','GSM',,,,,,< band>,,, […]] [+QENG: 'neighbourcell','WCDMA',,,,,,, , […]] OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 105 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+QENG='3gcomm' Get 3G cell common information Maximum Response Time Characteristics Response Only in WCDMA mode, get 3G cell common items which include the information about 3G neighbour cells, 2G neighbour cells and 3G serving cells information. For WCDMA serving cells information: [+QENG: '3gcomm',,,,,< mnc>,,,,,,,,, […]] For 3G neighbor cells information of WCDMA serving cell: [+QENG: '3gcomm',,,,,,,,,,,,, […]] For 2G neighbor cells information of WCDMA serving cells: [+QENG: '3gcomm',,,,,< rssi>,, […]] OK If the module works in 2G network, response: OK 300 ms / Parameter String format. The information of different cells. 'servingcell' The information of 2G/3G/4G serving cells 'neighbourcell' The information of 2G/3G/4G neighbour cells String format. UE state. 'SEARCH' UE is searching but could not (yet) find a suitable 2G/3G/4G cell. 'LIMSRV' UE is camping on a cell but has not registered on the network. 'NOCONN' UE is camping on a cell and has registered on the network, and it is in idle mode. 'CONNECT' UE is camping on a cell and has registered on the network, and a call is in progress. String format. Access technology, including: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 106 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 'GSM' 'WCDMA' 'LTE' 'CDMA' 'HDR' 'TDSCDMA' Integer type. Mobile country code (first part of the PLMN code). '-' Invalid Integer type. Mobile network code (second part of the PLMN code). '-' Invalid Hexadecimal format. Location area code. Determines the two-byte location area code in hexadecimal format (e.g. 00C1 equals 193 in decimal) of the cell that was scanned. Range: 0-0xFFFFFFF. '-' Invalid Hexadecimal format. Cell ID. Determines the 16-bit (GSM) or 28-bit (UMTS) cell ID. Range: 0-0xFFFFFFF. '-' Invalid Integer type. Base station identification code. Range: 0–63. Integer type. Determines the ARFCN of the cell that was scanned. Range: 0-1023. Integer type. The current band. 0 DCS_1800 1 PCS_1900 '-' Other bands Integer type. Routing area code. Range: 0–255. Primary frequency. Integer type. RX level value for base station selection in dB (see 3GPP 25.304). Range: 0-63. Subtracting 111 from the RX level value, a dBm value will be got. Integer type. MS maximum TX power in CCH. Integer type. Minimum access RX level. Integer type. Discontinuous reception cycle length. Integer type. Cell selection criterion. Integer type. Cell reselection criterion. Integer type. Whether the current cell supports GPRS or not. 0 Not support GPRS 1 Support GPRS Integer type. In hopping, ‘h’ is displayed, otherwise the current ARFCN in a voice call is displayed. Integer type. Timeslot number. Integer type. Timing advance for the base station. Range: 0–63. Integer type. Mobile allocation index offset. Integer type. Hopping sequence number. Integer type. RX quality (sub). Range: 0–7. Integer type. RX quality (full). Range: 0–7. Integer type. RX level (sub). Range: 0–63. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 107 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. RX level (full). Range: 0–63. String format. Channel mode during a voice call. 'HR' Half rate 'FR' Full rate 'EFR' Enhanced full rate 'AMR' Adaptive Multi-Rate 'AMRHR' AMR half rate 'AMRFR' AMR full rate 'AMRWB' AMR wide band '-' Invalid Integer type. UTRA-ARFCN of the cell that was scanned. Integer type. E-UTRA-ARFCN of the cell that was scanned. Integer type. The parameter determines the primary scrambling code of the cell that was scanned. Integer type. Received signal strength indication. Integer type. Logarithmic value of SINR. Range: -20–+30. Unit: dB. Integer type. The received signal code power level of the cell that was scanned. Integer type. Select RX level value for base station in dB (see 3GPP 25.304). Integer type. Spreading factor. Values are 4, 8, 16, 32, 64, 128, 256, and 512. 0 SF_4 1 SF_8 2 SF_16 3 SF_32 4 SF_64 5 SF_128 6 SF_256 7 SF_512 8 UNKNOWN Integer type. Slot format for DPCH (0–16). Slot format for FDPCH (0–9). Integer type. Whether compress mode is supported. 0 Not support compress mode 1 Support compress mode Integer type. GPRS cell selection criterion. Integer type. GPRS cell reselection criterion. Integer type. 3G neighbour cell set. 1 Active Set 2 Sync Neighbour Set 3 Async Neighbour Set Rank of this cell as neighbour for inter-RAT cell reselection. Integer type. TX power level for the UE. TDD or FDD mode. Physical cell ID E-UTRA frequency band (see 3GPP 36.101). Integer type. UL bandwidth. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 108 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz Integer type. DL bandwidth. 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz Tracking area code (see 3GPP 23.003 Chapter 19.4.2.3). Reference signal received power (see 3GPP 36.214 Chapter 5.1.1). Reference signal received quality (see 3GPP 36.214 Chapter 5.1.2). The threshold of (in dB) used by the UE on the serving cells when reselecting towards a lower priority RAT/frequency. Integer type. Carrier to noise ratio in dB = measured Ec/Io value in dB. 0 DPCH 1 FDPCH Destination number on which the call is to be deflected. Rx power value in 1/10 dBm resolution. Integer type. Carrier to noise ratio in dB = measured Ec/Io value in dB. Receiver automatic gain control on the camped frequency. Inter-frequency cell suitable receive level. Integer type.Cell reselection priority. Range: 0–7. Threshold to control non-intra-frequency searches. Cell selection parameter for the intra-frequency cell. Integer type. LTE serving cell ID. This is the cell ID for the serving cell and can be found in the cell list. Range: 0–503. To be referenced when reselection. The suitable receive level value of an evaluated lower priority cell must be greater than this value. To be referenced when reselection. The suitable receive level value of an evaluated higher priority cell must be greater than this value. Reselection threshold for high priority layers. Reselection threshold for low priority layers. Bitmask that specifies whether a neighbor with a particular network color code is to be reported. Bit n set to 1 means that a neighbor with NCC n is to be included in the report. Base station identity code ID. Reselection threshold for high priority layers. Reselection threshold for low priority layers. Absolute power level of the common pilot channel as received by the UE in EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 109 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual dBm × 10. Ratio of the received energy per PN chip for the common pilot channel to the total received power spectral density at the UE antenna connector in dB×10. EARFCN. Active channel of the current system. NOTES 1. If '-' or - is returned, it indicates the parameter is invalid under current condition. 2. 2G neighbour cells have already been visible in idle mode only. Example AT+QENG='servingcell' +QENG: 'servingcell','SEARCH' OK AT+QENG='servingcell' +QENG:'servingcell','LIMSRV','GSM',460,01,5504,2B55,52,123,0,-67,5,14,64,30,28,0,-,-,-,-,-,-,-,-,-,' -' OK AT+QENG='servingcell' //Get serving cell information in GSM mode in idle state. +QENG:'servingcell','NOCONN','GSM',460,01,5504,2B55,52,123,0,-111,5,14,64,0,0,0,-,-,-,-,-,-,-,-,-, '-' OK AT+QENG='servingcell' //Get serving cell information in GSM mode in connected state. +QENG:'servingcell','CONNECT','GSM',460,00,550A,2BB9,23,94,0,-61,5,14,4,0,0,0,h,1,0,0,33,50, 52,0,0,'EFR' OK AT +QENG='neighbourcell' //Get neighbour cell information in LTE mode. +QENG: 'neighbourcell intra','LTE',38950,276,-3,-88,-65,0,37,7,16,6,44 +QENG: 'neighbourcell inter','LTE',39148,-,-,-,-,-,37,0,30,7,-,-,-,+QENG: 'neighbourcell inter','LTE',37900,-,-,-,-,-,0,0,30,6,-,-,-,+QENG: 'neighbourcell','GSM',0,3,14,50,255,0,0,-1920,0 +QENG: 'neighbourcell','GSM',94,3,14,50,255,0,0,-1920,0 +QENG: 'neighbourcell','GSM',93,3,14,50,255,0,0,-1920,0 +QENG: 'neighbourcell','GSM',91,3,14,50,255,0,0,-1920,0 +QENG: 'neighbourcell','GSM',90,3,14,50,255,0,0,-1920,0 +QENG: 'neighbourcell','GSM',89,3,14,50,255,0,0,-1920,0 +QENG: 'neighbourcell','GSM',87,3,14,50,255,0,0,-1920,0 +QENG: 'neighbourcell','GSM',85,3,14,50,255,0,0,-1920,0 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 110 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual OK AT+QENG='neighbourcell' //Get neighbour cell information in WCDMA mode. +QENG: 'neighbourcell','WCDMA',10713,-723,398,-880,-155,6,-32768,+QENG: 'neighbourcell','WCDMA',10713,-723,331,-870,-155,2,-32768,+QENG: 'neighbourcell','WCDMA',10713,-723,290,-880,-165,2,-32768,+QENG: 'neighbourcell','WCDMA',10713,-723,397,-910,-190,2,-32768,+QENG: 'neighbourcell','WCDMA',10713,-723,114,-910,-195,2,-32768,+QENG: 'neighbourcell','WCDMA',10713,-723,332,-940,-220,2,-32768,+QENG: 'neighbourcell','WCDMA',10713,-723,379,-950,-230,2,-32768,+QENG: 'neighbourcell','WCDMA',10713,-723,115,-1210,-250,6,-32768,- OK AT+QENG='3gcomm' //Get common information in WCDMA mode. +QENG:'3gcomm','servingcell','3G','NOCONN',460,01,D5D6,8062AF1,10713,38,-72,-74,11,25,32 +QENG: '3gcomm','neighbourcell','3G',460,01,D5D6,8062AEF,10713,36,-87,-87,36,0,27 +QENG: '3gcomm','neighbourcell','2G',123,52,-98,12,-5 OK 6.18. AT+CIND Command of Control Instructions AT+CIND Command of Control Instructions Test Command AT+CIND=? Read Command AT+CIND? Response +CIND:(,(list of supported s))[,(,(list of supported s))[,...]] OK Response +CIND: [,[,...]] Maximum Response Time Characteristics OK If error is related to ME functionality: +CME ERROR: 300 ms / Parameter String type. Instructions state. See the following notes for details. Integer types. Instructions event. Related to the value of the . see the following notes for details. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 111 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Error codes. For more details, please refer to Chapter 15.4. NOTE The values of and are descripted as follows: 'battchg' 'signal' 'service' 'call' 'roam' 'smsfull' 'GPRS coverage' 'callsetup' Battery charge level. Range: 0-5. Signal strength indication. 0–5: The signal is divided into five levels. The larger the value, the better the signal. Network service status indicator. 0 Not registered on the network 1 Registered to the known network Call status indication. 0 No call 1 Call Roaming indicator. 0 Registered with the ownership or unregistered network 1 Registered to the roaming network A short message memory storage in the MT has become full (‘0’), or memory locations are available (‘1’). PS domain registration instructions. 0 Unregistered on PS domain 1 Registered on PS domain Call setup call type: 0 None 1 MTRING 2 MOINIT 3 MORING Example AT+CIND=? +CIND: ('battchg',(0-5)),('signal',(0-5)),('service',(0-1)),('call',(0-1)),('roam',(0-1)),('smsfull',(01)),('GPRS coverage',(0-1)),('callsetup',(0-3)) OK AT+CIND? +CIND: 0,3,1,0,0,0,1,0 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 112 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 7 Call Related Commands 7.1. ATA Answer an Incoming Call This command connects the module to an incoming voice or data call indicated by a RING URC. ATA Answer an Incoming Call Execution Command ATA Response TA sends off-hook to the remote station. Response in case of data call, if successfully connected: CONNECT And TA switches to data mode. Note: outputs only when is greater than 0 in ATX parameter setting. When TA returns to command mode after call release: OK Response in case of voice call, if successfully connected: OK Maximum Response Time Characteristics Reference V.25ter Response if no connection: NO CARRIER 90 s, determined by network. / NOTES 1. Any additional commands on the same command line are ignored. 2. This command may be aborted generally by receiving a character during execution. The aborting is not possible during some states of connection establishment such as handshaking. 3. See also ATX in Chapter 2.21. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 113 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example RING AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,1,4,0,0,'02154450290',129 OK ATA OK //A voice call is ringing //PS call in LTE mode //Incoming call //Accept the voice call with ATA 7.2. ATD Mobile Originated Call to Dial a Number This command sets up outgoing voice and data calls. Supplementary services can also be controlled with this command. ATD Mobile Originated Call to Dial a Number Execution Command ATD[][;] Response If no dial tone and parameter setting ATX2 or ATX4: NO DIALTONE If busy and (parameter setting ATX3 or ATX4): BUSY If a connection cannot be established: NO CARRIER If connection is successful and non-voice call. CONNECT And TA switches to data mode. Note: outputs only when is greater than 0 in ATX parameter setting. When TA returns to command mode after call release: OK Maximum Response Time Characteristics Reference V.25ter If connection is successful and voice call: OK 5 s, determined by network (AT+COLP=0). / EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 114 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter String of dialing digits and optionally V.25ter modifiers Dialing digits: 0-9, * , #, +, A, B, C Following V.25ter modifiers are ignored: ,(comma), T, P, !, W, @ String of GSM modifiers: I Actives CLIR (Disable presentation of own number to called party) i Deactivates CLIR (Enable presentation of own number to called party) G Activates closed user group invocation for this call only g Deactivates closed user group invocation for this call only Only required to set up voice call, return to command mode NOTES 1. This command may be aborted generally by receiving an ATH command or a character during execution. The aborting is not possible during some states of connection establishment such as handshaking. 2. Parameter 'I' and 'i' can be omitted only when there is no '*' or '#' code within the dial string. 3. See ATX command for setting result code and call monitoring parameters. 4. Responses returned after dialing with ATD For voice call, two different responses mode can be determined. TA returns OK immediately either after dialing was completed or after the call was established. The setting is controlled by AT+COLP. Factory default is AT+COLP=0, which causes the TA to return OK immediately after dialing was completed. Otherwise TA will return OK, BUSY, NO DIAL TONE, or NO CARRIER. 5. Using ATD during an active voice call: ⚫ When a user originates a second voice call while there is already an active voice call, the first call will be automatically put on hold. ⚫ The current states of all calls can be easily checked at any time by using AT+CLCC command. Example ATD10086; OK //Dialing out the party’s number. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 115 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 7.3. ATH Disconnect Existing Connection This command disconnects circuit switched data calls or voice calls. AT+CHUP is also used to disconnect the voice call. ATH Disconnect Existing Connection Execution Command ATH[n] Response Disconnect existing call by local TE from command line and terminate the call. OK Maximum Response Time 90 s, determined by network. Characteristics / Reference V.25ter Parameter Integer type. 0 Disconnect existing call from command line and terminate the call 7.4. AT+CVHU Voice Hang up Control This command controls whether ATH can be used to disconnect the voice call. AT+CVHU Voice Hang up Control Test Command AT+CVHU=? Response +CVHU: (list of supported s) Read Command AT+CVHU? OK Response +CVHU: Write Command AT+CVHU= Maximum Response Time OK Response OK Or ERROR 300 ms EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 116 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Characteristics / Reference 3GPP TS 27.007 Parameter Integer type. 0 ATH can be used to disconnect the voice call. 1 ATH is ignored but OK response is returned. 7.5. AT+CHUP Hang up Voice Call This command cancels all voice calls in the state of Active, Waiting and Held. For data connections, use ATH. AT+CHUP Hang up Voice Call Test Command AT+CHUP=? Execution Command AT+CHUP Maximum Response Time Characteristics Reference 3GPP 27.007 Response OK Response OK Or ERROR 90 s, determined by network. / Example RING AT+CHUP OK //Incoming call. //Hang up the call. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 117 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 7.6. +++ Switch from Data Mode to Command Mode This command is only available when TA is in data mode. The '+++' character sequence causes the TA to cancel the data flow over the AT interface and switch to command mode. This allows entering AT command while maintaining the data connection with the remote server or, accordingly, the GPRS connection. +++ Switch from Data Mode to Command Mode Execution Command +++ Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter NOTES 1. To prevent the +++ escape sequence from being misinterpreted as data, the following sequence should be followed: ⚫ Do not input any character within 1s before inputting +++. ⚫ Input +++ within 1s, and no other characters can be inputted during the time. ⚫ Do not input any character within 1s after +++ has been inputted. ⚫ Switch to command mode successfully; otherwise return to Step 1. 2. To return back to data mode from command mode, please enter ATO. 3. Another way to change to command mode is through DTR level change, and please refer to AT&D command for details. 7.7. ATO Switch from Command Mode to Data Mode This command resumes the connection and switches back from command mode to data mode. ATO Switch from Command Mode to Data Mode Execution Command ATO[n] Response If connection is not successfully resumed: NO CARRIER If connection is successfully resumed, TA returns to data mode from command mode: CONNECT EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 118 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference V.25ter 300 ms / Parameter Integer type. 0 Switch from command mode to data mode NOTE When TA returns to data mode from command mode successfully, CONNECT is returned. Please note that outputs only when is greater than 0 in ATX parameter setting. 7.8. ATS0 Set Number of Rings before Automatical Answering This command controls automatic answering mode for the incoming calls. ATS0 Set Number of Rings before Automatical Answering Read Command ATS0? Response Write Command ATS0= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. This parameter setting determines the number of rings before auto-answer. 0 Automatic answering is disabled 1–255 Enable automatic answering on the ring number specified EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 119 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual NOTE If is set too high, the calling party may hang up before the call is answered automatically. Example ATS0=3 OK RING RING RING //Set three rings before automatically answering a call. //A call is coming. //Automatically answering the call after three rings. 7.9. ATS6 Set Pause before Blind Dialing This command is implemented for compatibility reasons only, and has no effect. ATS6 Set Pause before Blind Dialing Read Command ATS6? Response Write Command ATS6= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. 0–2–10 Number of seconds to wait before blind dialing EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 120 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 7.10. ATS7 Set Time to Wait for Connection Completion This command specifies the amount of time (unit: second) to wait for the connection completion in case of answering or originating a call. If no connection is established during the time, the module disconnects from the line. ATS7 Set Time to Wait for Connection Completion Read Command ATS7? Response Write Command ATS7= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. 0 Disabled 1–255 Number of seconds to wait for connection completion. Unit: second. 7.11. ATS8 Set the Time to Wait for Comma Dial Modifier This command is implemented for compatibility reasons only, and has no effect. ATS8 Set the Time to Wait for Comma Dial Modifier Read Command ATS8? Response Write Command ATS8= Maximum Response Time Characteristics OK Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 121 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference V.25ter Parameter Integer type. 0 No pause when comma encountered in dial string 1–2–255 Number of seconds to wait for comma dial modifier 7.12. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier This command determines the amount of time (unit: tenths of a second) during which the UE remains connected in absence of a data carrier. If the data carrier is once more detected before disconnection, the TA remains connected. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier Read Command ATS10? Response Write Command ATS10= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms / Parameter Integer type. Number of tenths of seconds to wait before disconnecting after UE has indicated the absence of received line signal. Range: 1–15–255. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 122 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 7.13. ATS12 Set the Interval for Exiting the Transparent Access Mode Using +++ ATS12 Set the Interval for Exiting the Transparent Access Mode Using +++ Read Command ATS12? Response Write Command ATS12= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. The interval for exiting the transparent access mode using +++. Range: 10–250. Default: 50. If set the value to 25, it means that the interval is 0.5 s; if set the value to 50, it means that the interval is 1 s; if set the value to 100, it means that the interval is 2 s, and so on. Example ATS12 050 OK ATS12=25 OK 7.14. AT+CBST Select Bearer Service Type This Write Command selects the bearer service , the data rate and the connection element to be used when data calls are originated. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 123 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CBST Select Bearer Service Type Test Command AT+CBST=? Response +CBST: (list of supported s),(list of supported s),(list of supported s) Read Command AT+CBST? OK Response +CBST: ,, Write Command AT+CBST=[[,[,]] ] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. 0 Automatic speed selection 7 9600 bps (V.32) 12 9600 bps (V.34) 14 14400 bps (V.34) 16 28800 bps (V.34) 17 32000 bps (V.34) 39 9600 bps (V.120) 43 14400 bps (V.120) 48 28800 bps (V.120) 51 56000 bps (V.120) 71 9600 bps (V.110) 75 14400 bps (V.110) 80 28800 bps (V.110 or X.31 flag stuffing) 81 38400 bps (V.110 or X.31 flag stuffing) 83 56000 bps (V.110 or X.31 flag stuffing; this setting can be used in conjunction with asynchronous non-transparent UDI or RDI service in order to get FTM) 84 64000 bps (X.31 flag stuffing; this setting can be used in conjunction with asynchronous non-transparent UDI service in order to get FTM) 116 64000 bps (bit transparent) 134 64000 bps (multimedia) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 124 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. 0 Asynchronous Modem 1 Synchronous Modem 4 Asynchronous Modem (RDI) Integer type. 0 Transparent 1 Non-transparent Table 6: Parameter Configurations Supported by AT+CBST GSM 0 Y WCDMA Y Synchronous Modem Asynchronous Modem N Y Asynchronous Modem (RDI) N Transparent N Non-transparent Y 7 Y N N Y N N Y 12 Y N N Y N N Y 14 Y Y N Y N N Y 16 N Y N Y N N Y 17 N Y N Y N N Y 39 Y N N Y N N Y 43 Y Y N Y N N Y 48 N Y N Y N N Y 51 N Y N Y N N Y 71 Y N N Y N N Y 75 Y Y N Y N N Y 80 Y Y N Y N N Y 81 Y Y N Y N N Y 83 Y Y N Y Y N Y 84 N Y N Y N N Y 116 N Y Y N N Y N 134 N Y Y N N Y N EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 125 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual NOTE 3GPP TS 22.002 lists the allowed combinations of the sub-parameters. 7.15. AT+CSTA Select Type of Address This Write Command selects the type of number for further dialing commands ATD according to 3GPP Specifications. Test command returns values supported a compound value. AT+CSTA Select Type of Address Test Command AT+CSTA=? Response +CSTA: (list of supported s) Read Command AT+CSTA? OK Response +CSTA: Write Command AT+CSTA= Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Current address type setting. 129 Unknown type 145 International type (contains the character '+') 7.16. AT+CLCC List Current Calls of ME This execution command returns the list of all current calls. If the command is executed successfully, but no calls existed, no information response but OK is sent to TE. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 126 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CLCC List Current Calls of ME Test Command AT+CLCC=? Execution Command AT+CLCC Response OK Response [+CLCC : ,,,,[,,[,< alpha>]] [+CLCC: ,,,,[,,[,< alpha>]] [...] OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. Call identification number as described in 3GPP TS 22.030 subclause 4.5.5.1. This number can be used in AT+CHLD command operation. Integer type. 0 Mobile originated (MO) call 1 Mobile terminated (MT) call Integer type. State of the call. 0 Active 1 Held 2 Dialing (MO call) 3 Alerting (MO call) 4 Incoming (MT call) 5 Waiting (MT call) Integer type. Bearer/tele service. 0 Voice 1 Data 2 FAX Integer type. 0 Call is not one of multiparty (conference) call parties 1 Call is one of multiparty (conference) call parties Phone number in string type in format specified by . EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 127 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Type of address of octet in integer format (refer to 3GPP TS 24.008 subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type Alphanumeric representation of corresponding to the entry found in phonebook. Error codes. For more details, please refer to Chapter 15.4. Example ATD10086; OK AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,0,0,0,0,'10086',129 OK //Establish a call. //PS call in LTE mode. //Establish a call, and the call has been answered. 7.17. AT+CR Service Reporting Control This command controls the module whether or not to transmit an intermediate result code +CR: to the TE when a call is being set up. If it is enabled, the intermediate result code is transmitted at the point during connect negotiation at which the TA has determined which speed and quality of service will be used, before any error control or data compression reports are transmitted, and before any final result code (e.g. CONNECT) is transmitted. AT+CR Service Reporting Control Test Command AT+CR=? Response +CR: (list of supported s) Read Command AT+CR? OK Response +CR: Write Command AT+CR=[] OK Response TA controls whether or not intermediate result code +CR: is returned from the TA to the TE when a call is being set up. OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 128 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. 0 1 ASYNC SYNC REL ASYNC REL SYNC GPRS Disable Enable Asynchronous transparent Synchronous transparent Asynchronous non-transparent Synchronous non-transparent GPRS 7.18. AT+CRC Set Cellular Result Codes for Incoming Call Indication This command controls whether or not to use the extended format of incoming call indication. When it is enabled, an incoming call is indicated to the TE with unsolicited result code +CRING: instead of the normal RING. AT+CRC Set Cellular Result Codes for Incoming Call Indication Test Command AT+CRC=? Response +CRC: (list of supported s) Read Command AT+CRC? OK Response +CRC: Write Command AT+CRC=[] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms The command takes effect immediately. The configurations will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 129 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. 0 1 ASYNC SYNC REL ASYNC REL SYNC FAX VOICE Disable extended format Enable extended format Asynchronous transparent Synchronous transparent Asynchronous non-transparent Synchronous non-transparent Facsimile Voice Example AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK RING ATH OK //Enable extended format. //Indicate incoming call to the TE. //Disable extended format. //Indicate incoming call to the TE. 7.19. AT+CRLP Select Radio Link Protocol Parameter This command sets radio link protocol (RLP) parameters used when non-transparent data calls are originated. AT+CRLP Select Radio Link Protocol Parameter Test Command AT+CRLP=? Response +CRLP: (range of supported s),(range of supported s),(range of supported s),(range of supporte d s), +CRLP: (range of supported s),(range of supported s),(range of supported s),(range of supported s), +CRLP: (range of supported s),(range of supported s),(range of supported s),(range of supported EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 130 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual s), Read Command AT+CRLP? OK Response +CRLP: ,,,, +CRLP: ,,,, +CRLP: ,,,, Write Command AT+CRLP=[[,[,[,[,]]]]] OK Response OK Maximum Response Time 300 ms Characteristics Reference 3GPP TS27.007 The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Interworking Window Size (IWF to MS window size). 0–61 Interworking window size 0–240–488 For =2 Integer type. Mobile window size (MS to IWF window size). 0–61 Mobile window size 0–240–488 For =2 Integer type. 38–48–255 Acknowledgment timer T1 in a unit of 10 ms 42–52–255 For =2 Integer type. 1–6 –255 Retransmission attempts N2 Integer type. RLP version number. 0–2 RLP version number 7.20. AT+QECCNUM Configure Emergency Call Numbers This command queries, adds and deletes ECC (Emergency Call Codes) numbers. There are two kinds of ECC numbers: ECC numbers without (U)SIM and ECC numbers with (U)SIM. The default ECC numbers without (U)SIM is 911, 112, 00, 08, 110, 999, 118 and 119. The default ECC number with (U)SIM is 911 and 112. 911 and 112 will always be supported as ECC numbers, and cannot be deleted. ECC numbers can be saved into NVM automatically. If the (U)SIM card contains ECC file, the numbers in ECC file can EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 131 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual also be regarded as ECC numbers. The maximal supported ECC numbers of each type is 20. AT+QECCNUM Configure Emergency Call Numbers Test Command AT+QECCNUM=? Response +QECCNUM: (range of supported s) Write Command AT+QECCNUM=,[,[,,…[, ]]] OK Response If is equal to 0, query the ECC numbers. In this case, should be omitted: +QECCNUM: ,,[…] OK Read Command AT+QECCNUM? If is not equal to 0: =1 is used to add the ECC number; =2 is used to delete the ECC number. In this case, at least one ECC number should be inputted, and the response is: OK Or ERROR Response +QECCNUM: 0,,[…] +QECCNUM: 1,,[…] Maximum Response Time Characteristics OK 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. ECC number operations. 0 Query ECC numbers 1 Add ECC numbers 2 Delete ECC numbers Integer type. ECC number type. 0 ECC numbers without (U)SIM 1 ECC numbers with (U)SIM String type. ECC numbers (e.g. 110, 119). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 132 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+QECCNUM=? +QECCNUM: (0-2) //Query the supported ECC number operation mode. OK AT+QECCNUM? //Query the ECC numbers with or without (U)SIM. +QECCNUM: 0,'911','112','00','08','110','999','118','119' +QECCNUM: 1,'911','112' OK AT+QECCNUM=0,1 +QECCNUM: 1,'911','112' //Query the ECC numbers with (U)SIM. OK AT+QECCNUM=1,1,'110', '234' //Add '110' and '234' into the type of ECC numbers with (U)SIM. OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1, '911','112','110','234' OK AT+QECCNUM=2,1,'110' //Delete '110' from the type of ECC numbers with (U)SIM. OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1, '911','112','234' OK 7.21. AT+QHUP Hang up Call with a Specific Release Cause This command can terminate a call or calls (including both voice call and data call) with a specific 3GPP TS 24.008 release cause specified by the host. AT+QHUP Hang up Call with a Specific Release Cause Test Command AT+QHUP=? Write Command AT+QHUP=[,] Response OK Response OK Or ERROR If there is any error related to ME functionality: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 133 / 316 Maximum Response Time Characteristics LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +CME ERROR: 90 s, determined by network. / Parameter Integer type. Release cause. 3GPP TS 24.008 release cause to be indicated to the network. 1 Release cause 'unassigned (unallocated) number' 16 Release cause 'normal call clearing' 17 Release cause 'user busy' 18 Release cause 'no user responding' 21 Release cause 'call rejected' 27 Release cause 'destination out of order' 31 Release cause 'normal, unspecified' 88 Release cause 'incompatible destination' Integer type. Call identification number is an optional index in the list of current calls indicated by AT+CLCC. AT+QHUP will terminate the call identified by the given call number. The default call number 0 is not assigned to any call, but signifies all calls. 0 Terminate all known calls. However, if circuit switches data calls and voice calls at the same time, this command only terminates the CSD calls. 1…7 Terminate the specific call with identification number. Error codes. For more details, please refer to Chapter 15.4. Example AT+QHUP=? //Test Command. OK ATD10010; //Dial 10010. OK ATD10086; //Dial 10086. OK AT+CLCC //Query the status of calls. +CLCC: 1,0,1,0,0,'10010',129 +CLCC: 2,0,0,0,0,'10086',129 OK AT+QHUP=17,1 //Terminate the call whose ID is 1. Disconnect cause is 'user busy'. OK AT+CLCC //Query the status of calls. +CLCC: 1,0,0,0,0,'10086',129 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 134 / 316 OK AT+QHUP=16 OK AT+CLCC OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //Terminate all existed calls. Disconnect cause is 'normal call clearing'. 7.22. AT+QCHLDIPMPTY Hang Up a Call in the VoLTE Conference This command hangs up a call in the VoLTE conference. AT+QCHLDIPMPTY Hang Up a Call in the VoLTE Conference Test Command AT+QCHLDIPMPTY=? Response +QCHLDIPMPTY: Write Command AT+QCHLDIPMPTY= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms / Parameter String of dialing digits and optionally V.25ter modifiers. Dialing digits: 0-9, *, #, +, A, B, C Example AT+QCHLDIPMPTY=? +QCHLDIPMPTY: OK ATD13866783782; OK AT+CLCC +CLCC: 2,1,0,1,0,'',128 +CLCC: 1,0,0,0,0,'13866783782',129 //Test command. //Establish a call. //The second call be active. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 135 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual OK AT+CHLD=2 //Place the active call on hold and accept the waiting call as the active call. OK AT+CLCC //Query the status of calls. +CLCC: 2,1,0,1,0,'',128 +CLCC: 1,0,1,0,0,'13866783782',129 //The second call on hold. OK ATD15155196746; OK AT+CLCC +CLCC: 2,1,0,1,0,'',128 +CLCC: 1,0,1,0,0,'13866783782',129 +CLCC: 3,1,0,1,0,'',128 +CLCC: 4,0,0,0,0,'15155196746',129 //Establish a call. //The second call on hold. //The fourth call be active. OK AT+CHLD=3 //Add a held call to the active calls in order to set up a conference (multiparty) call. OK AT+CLCC +CLCC: 2,1,0,1,0,'',128 +CLCC: 3,1,0,1,0,'',128 +CLCC: 5,0,0,0,0,'sip:mmtel',128 OK AT+QCHLDIPMPTY='13866783782' OK AT+QCHLDIPMPTY='15155196746' OK //Hang up a call which is activated. //Hang up a call which is activated. 7.23. AT^DSCI Call Status Indication This command configures whether TA enables the presentation of the DSCI at the TE. AT^DSCI Call status indication Test Command AT^DSCI=? Response ^DSCI: (list of supported s) Write Command AT^DSCI? OK Response ^DSCI: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 136 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT^DSCI= Maximum Response Time Characteristics OK OK 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. 0 DSCI not provisioned 1 DSCI provisioned NOTE When the presentation of the DSCI at the TE is enabled, an unsolicited result code is returned after the action: ^DSCI: ,,,,,, Parameters Call ID Call direction Call state 1 CALL_HOLD 2 CALL_ORIGINAL 3 CALL_CONNECT 4 CALL_INCOMING 5 CALL_WAITING 6 CALL_END 7 CALL_ALERTING Call type 0 Voice call 1 PS call Phone number Type of phone number Information of host play tone 0 Host play tone 1 Host not play tone , , , should be value set in AT+CLCC. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 137 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example //Dial a call. AT^DSCI=1 OK ATD10086; OK ^DSCI: 1,0,2,0,10086,129,0 ^DSCI: 1,0,7,0,10086,129,0 ^DSCI: 1,0,3,0,10086,129,0 ATH OK ^DSCI: 1,0,6,0,10086,129,0 //A call is incoming RING ^DSCI: 1,1,4,0,13022100000,129,0 RING ^DSCI: 1,1,6,0,13022100000,129,0 NO CARRIER //Enable DSCI. //Dial 10086. //Call start. //Call alerting. //Call connect. //Call end. //Call incoming. //Call end. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 138 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 8 Phonebook Commands 8.1. AT+CNUM Subscriber Number This command gets the subscribers' own number(s) from the (U)SIM. AT+CNUM Subscriber Number Test Command AT+CNUM=? Execution Command AT+CNUM Response OK Response [+CNUM: [],,] [+CNUM: [],,] OK Or ERROR Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter Optional alphanumeric string associated with . The used character set should be the one selected with AT+CSCS command. String type phone number of format specified by . Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 139 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 8.2. AT+CPBF Find Phonebook Entries This command searches the phonebook entries starting with the given string from the current phonebook memory storage selected with AT+CPBS, and return all found entries sorted in alphanumeric order. AT+CPBF Find Phonebook Entries Test Command AT+CPBF=? Response +CPBF: , Write Command AT+CPBF= OK Response [+CPBF: ,,,] […] OK Or ERROR Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: Depends on the storage of phonebook entries. / Parameter Integer type. Indicate the maximum length of field . Integer type. Indicate the maximum length of field . String type. The field of maximum length in current TE character set specified by AT+CSCS. String type. The phone number of format specified by . Integer type. In the range of location numbers of phone book memory. Type of address of octet in integer format (refer 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type field of maximum length in current TE character set specified by AT+CSCS. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 140 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Error codes. For more details, please refer to Chapter 15.4. 8.3. AT+CPBR Read Phonebook Entries This command reads phonebook entries in location number range ... from the current phonebook memory storage selected with AT+CPBS. If is left out, only location is returned. AT+CPBR Read Phonebook Entries Test Command AT+CPBR=? Response +CPBR: (list of supported s),, Write Command AT+CPBR=[,] OK Response +CPBR: ,,, [+CPBR: ,,, […]] OK Or ERROR Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: Depends on the storage of phonebook entries. / Parameter Integer type. Location numbers of phone book memory. Integer type. Indicate the maximum length of field . Integer type. Indicate the maximum length of field . Integer type. The first phone book record to read. Integer type. The last phonebook record to read. String type. The phone number of format specified by . Type of address of octet in integer format (see 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 141 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 145 International type (contains the character '+') 161 National type String type. The field of maximum length in current TE character set specified by AT+CSCS. Error codes. For more details, please refer to Chapter 15.4. 8.4. AT+CPBS Select Phonebook Memory Storage This command selects phonebook memory storage, which is used by other phonebook commands. The Read Command returns currently selected memory, the number of used locations and the total number of locations in the memory when supported by manufacturer. The Test Command returns supported storages as compound value. AT+CPBS Select Phonebook Memory Storage Test Command AT+CPBS=? Response +CPBS: (list of supported s) OK Or ERROR Read Command AT+CPBS? If there is any error related to ME functionality: +CME ERROR: Response +CPBS: ,, OK Or ERROR Write Command AT+CPBS= If there is any error related to ME functionality: +CME ERROR: Response OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms / EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 142 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference 3GPP 27.007 Parameter String type. Phonebook memory storage. 'SM' (U)SIM phonebook 'DC' ME dialed calls list (AT+CPBW may not be applicable to this storage) 'FD' (U)SIM fix dialing-phone book (AT+CPBW operation need the authority of PIN2) 'LD' (U)SIM last-dialing-phone book (AT+CPBW may not be applicable to this storage) 'MC' ME missed (unanswered) calls list (AT+CPBW may not be applicable to this storage) 'ME' Mobile equipment phonebook 'RC' ME received calls list (AT+CPBW may not be applicable to this storage) 'EN' (U)SIM (or ME) emergency number (AT+CPBW may not be applicable to this storage) 'ON' (U)SIM own numbers (MSISDNs) list Integer type. Indicate the total number of used locations in selected memory. Integer type. Indicate the total number of locations in selected memory. Error codes. For more details, please refer to Chapter 15.4. 8.5. AT+CPBW Write Phonebook Entry This command writes phonebook entry in location number in the current phonebook memory storage selected with AT+CPBS. It can also delete a phonebook entry in location number . AT+CPBW Write Phonebook Entry Test Command AT+CPBW=? Response +CPBW: (range of supported s),,(list of supported s), OK Or ERROR Write Command AT+CPBW=[][,[,[,]]] If there is any error related to ME functionality: +CME ERROR: Response OK Or ERROR EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 143 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. Location numbers of phone book memory. If is not given, the first free entry will be used. If is given as the only parameter, the phonebook entry specified by is deleted. Integer type. Indicate the maximum length of field . Integer type. Indicate the maximum length of field . String type phone number of format specified by Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type field of maximum length in current TE character set specified by AT+CSCS. Error codes. For more details, please refer to Chapter 15.4. Example AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK //Make a new phonebook entry at location 10. AT+CPBW=10 //Delete the entry at location 10. OK AT+CPBR=10 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 144 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 9 Short Message Service Commands 9.1. AT+CSMS Select Message Service This command selects messaging service and returns the types of messages supported by the ME. AT+CSMS Select Message Service Test Command AT+CSMS=? Response +CSMS: (list of supported s) Read Command AT+CSMS? OK Response +CSMS: ,,, Write Command AT+CSMS= OK Response +CSMS: ,, OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Type of message service. 0 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2 version 4.7.0; Phase 2+ features which do not require new command syntax may be supported, e.g. correct routing of messages with new Phase 2+ data coding schemes). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 145 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 1 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2+ version; the requirement of setting 1 is mentioned under corresponding command descriptions). Integer type. Mobile terminated messages. 0 Type not supported 1 Type supported Integer type. Mobile originated messages. 0 Type not supported 1 Type supported Integer type. Broadcast type messages. 0 Type not supported 1 Type supported Error codes. For more details, please refer to Chapter 15.5. Example AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //Test command. //Set type of message service to 1. //Read command. 9.2. AT+CMGF Message Format This command specifies the input and output format of the short messages. indicates the format of messages used with Test, Read, Write and Execution Commands and unsolicited result codes resulting from received messages. The format of messages can be either PDU mode (entire TP data units used) or text mode (headers and body of the messages given as separate parameters). Text mode uses the value of parameter specified by AT+CSCS command to inform the character set to be used in the message body in the TA-TE interface. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 146 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CMGF Message Format Test Command AT+CMGF=? Read Command AT+CMGF? Write Command AT+CMGF[=] Maximum Response Time Characteristics Reference 3GPP TS 27.005 Parameter Integer type. 0 PDU mode 1 Text mode Response +CMGF: (list of supported s) OK Response +CMGF: OK Response TA sets parameter to denote which kind of I/O format of messages is used. OK 300 ms The command takes effect immediately. The configuration will be saved automatically. 9.3. AT+CSCA Service Center Address This Write Command updates the SMSC address when mobile originated SMS are transmitted. In text mode, the setting is used by Write Command. In PDU mode, setting is used by the same command, but only when the length of the SMSC address is coded into the parameter which equals to zero. AT+CSCA Service Center Address Test Command AT+CSCA=? Read Command AT+CSCA? Response OK Response +CSCA: , Write Command OK Response EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 147 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CSCA=[,] Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (see ). Error codes. For more details, please refer to Chapter 15.5. Example AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //Set SMS service center address. //Query SMS service center address. 9.4. AT+CPMS Preferred Message Storage This command selects the memory storages , and to be used for reading, writing, etc. AT+CPMS Preferred Message Storage Test Command AT+CPMS=? Response +CPMS: (list of supported s),(list of supported s),(list of supported s) OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 148 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Read Command AT+CPMS? Response +CPMS: ,,,,,,,, Write Command AT+CPMS=[,[,]] OK Response +CPMS: ,,,,, OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter String type. Messages to be read and deleted from this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location String type. Messages will be written and sent to this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location String type. Received messages will be placed in this memory storage if routing to PC is not set (AT+CNMI). 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Integer type. Number of current messages in . Integer type. Total number of messages which can be stored in . Error codes. For more details, please refer to Chapter 15.5. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 149 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+CPMS? //Query the current SMS message storage. +CPMS: 'ME',0,255,'ME',0,255,'ME',0,255 OK AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //Set SMS message storage as 'SM'. OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //Query the current SMS message storage. OK 9.5. AT+CMGD Delete Message This command deletes short messages from the preferred message storage location . If is presented and not set to 0, then the ME shall ignore and follow the rules of shown as below. AT+CMGD Delete Message Test Command AT+CMGD=? Response +CMGD: (range of supported s),(range of supported s) Write Command AT+CMGD=[,] OK Response TA deletes message from preferred message storage location . OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300 ms. Note: Operation of depends on the storage of deleted messages. The command takes effect immediately. The configurations will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 150 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. Location numbers supported by the associated memory. Integer type. 0 Delete the message specified in 1 Delete all read messages from storage 2 Delete all read messages from storage and sent mobile originated messages 3 Delete all read messages from storage, sent and unsent mobile originated messages 4 Delete all messages from storage String type. Messages to be read and deleted from this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage Error codes. For more details, please refer to Chapter 15.5. Example AT+CMGD=1 OK AT+CMGD=1,4 OK //Delete the message specified in =1. //Delete all messages from storage. 9.6. AT+CMGL List Message The Read Command returns messages with status value from preferred message storage to the TE. If the status of the message is 'REC UNREAD', the status in the storage changes to 'REC READ'. When executing command AT+CMGL without status value , it will report the list of SMS with 'REC UNREAD' status. AT+CMGL List Message Test Command AT+CMGL=? Response +CMGL: (list of supported s) Write Command AT+CMGL[=] OK Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-SUBMITs and/or SMS-DELIVERs: +CMGL: ,,,[],[][,,][ +CMGL: ,,,[],[][,,][...]] For SMS-STATUS-REPORTs: +CMGL: ,,,,[],[],,,[ +CMGL: ,,,,[],[],,,[...]] For SMS-COMMANDs: +CMGL: ,,,[ +CMGL: ,,,[...]] For CBM storage: +CMGL: ,,,,,[ +CMGL: ,,,,,[...]] OK If in PDU mode (AT+CMGF=0) and the command is executed successfully: +CMGL: ,,[], +CMGL: ,,[alpha],[...]] OK If there is any error related to ME functionality: +CMS ERROR: Response List all messages with 'REC UNREAD' status from message storage , and then the status in the storage changes to 'REC READ'. 300 ms. The command takes effect immediately. The configurations will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 152 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter String type. In text mode: 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages 'ALL' All messages Integer type. In PDU mode: 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages 4 All messages Integer type. Location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (see ). Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (see by default). Message length. Integer type. Indicate the length of the message body (or ) in characters in the text mode (AT+CMGF=1), or the length of the actual TP data unit in octets in PDU mode (AT+CMGF=0) (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: - If (see chapter 9.7), indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used and (see Chapter 9.7) indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set. - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 153 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7 bit default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7 bit default alphabet 23) is presented as 17 (IRA 49 and 55)). - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used: - If TE character set other than 'HEX' (see AT+CSCS in 3GPP TS27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7 bit default alphabet into two IRA character long hexadecimal number. - If , indicates that 8-bit or UCS2 data coding scheme is used: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) 3GPP TS 27.007. Depends on the command or result code: first octet of 3GPP TS 23.040 [3] SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND (default 2) in integer format. 3GPP TS 23.040 [3] TP-Message-Reference in integer format. 3GPP TS 23.040 [3] TP-Recipient-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (see +CSCS in 3GPP TS 27.007 [9]); type of address given by . 3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format (see by default). 3GPP TS 23.040 [3] TP-Service-Centre-Time-Stamp in time-string format (see ) 3GPP TS 23.040 [3] TP-Discharge-Time in time-string format: 'yy/MM/dd,hh:mm:ss zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. 3GPP TS 23.040 [3] TP-Status in integer format. 3GPP TS 23.040 [3] TP-Command-Type in integer format (default 0). 3GPP TS 23.041 [4] CBM Serial Number in integer format. 3GPP TS 23.041 [4] CBM Message Identifier in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 4-7 in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 0-3 in integer format. Messages to be read and deleted from this memory storage EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 154 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage Integer type. For details of error codes, please refer to Chapter 15.5. Example AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, OK //Set SMS message format as text mode. //List all messages from message storage. NOTE Operation of depends on the storage of listed messages. 9.7. AT+CMGR Read Message This Read Command returns SMS message with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage changes to 'REC READ'. AT+CMGR Read Message Test Command AT+CMGR=? Write Command AT+CMGR= Response OK Response In Non-CDMA mode: If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-DELIVER: +CMGR: ,,[],[,,,,,,,] OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 155 / 316 Maximum Response Time Characteristics Reference 3GPP TS 27.005 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual For SMS-SUBMIT: +CMGR: ,,[][,,,,,[],,,] OK For SMS-STATUS-REPORTs: +CMGR: ,,,[],[],,, OK For SMS-COMMANDs: +CMGR: ,,[,,[],[],[], ] OK For CBM storage: +CMGR: ,,,,, OK If in PDU mode (AT+CMGF=0) and command is executed successfully: +CMGR: ,[], OK In CDMA Text mode: +CMGR: ,,,,,,,,,, OK If there is any error related to ME functionality: +CMS ERROR: Depends on the length of message content. The command takes effect immediately. The configurations will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 156 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type value in the range of location numbers supported by the associated memory. String type. In text mode. 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages 'ALL' All messages Integer type. In PDU mode. 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages 4 All messages String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND in integer format. If a valid value has been entered once, the parameter can be omitted. Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ). Message number. 3GPP TS 23.040 TP-Message-Number in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Recipient address. 3GPP TS 23.040 TP-Recipient-Address Address-Value field in EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 157 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual string format. BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (default refer ). Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Type of originating address.3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ). Message length. Integer type. Indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0) the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). The text of short message. Please refer Chapter 14.8 for details. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Priority. 0 Normal 1 Interactive 2 Urgent 3 Emergency Format. 0 GSM 7 bit 1 ASCII 6 UNICODE Privacy. 0 Normal 1 Restricted 2 Confidential 3 Secret Language. 0 Unspecified 1 English 2 French 3 Spanish 4 Japanese EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 158 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 5 Korean 6 Chinese 7 Hebrew 0 Normal 1 CPT 2 Voice Mail 3 SMS Report String type. Messages to be read and deleted from this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage Error codes. For more details, please refer to Chapter 15.5. Example +CMTI: 'SM',3 AT+CSDH=1 OK AT+CMGR=3 +CMGR: 'REC 0',145,27 //Indicates that new message has been received and saved to =3 of 'SM'. //Read message. UNREAD','+8615021012496',,'13/12/13,15:06:37+32',145,4,0,0,'+861380021050 OK 9.8. AT+CMGS Send Message This command sends a short message from TE to network (SMS-SUBMIT). After invoking the write command, wait for the prompt > and then start to write the message. After that, enter to indicate the ending of PDU and begin to send the message. Sending can be cancelled by giving character. Abortion is acknowledged with OK, though the message will not be sent. The message reference is returned to the TE on successful message delivery. The value can be used to identify message upon unsolicited delivery status report result code. AT+CMGS Send Message Test Command AT+CMGS=? Write Command 1) If text mode (AT+CMGF=1): AT+CMGS=[,] Response OK Response TA sends message from TE to the network (SMS-SUBMIT). Message reference value is returned to the TE on EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 159 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual text is entered ESC quits without sending 2) If PDU mode (AT+CMGF=0): AT+CMGS= PDU is given Maximum Response Time Characteristics Reference 3GPP TS 27.005 successful message delivery. Optionally (when AT+CSMS value is 1 and network supports) is returned. Values can be used to identify message upon unsolicited delivery status report result code. If in text mode (AT+CMGF=1) and sent successfully: +CMGS: OK If in PDU mode (AT+CMGF=0) and sent successfully: +CMGS: OK If there is any error related to ME functionality: +CMS ERROR: 120 s, determined by network. The command takes effect immediately. The configurations will not be saved. Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Integer type. Integer type. Indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). The maximum length in text mode is 160 bytes. The maximum length in PDU mode is 140 bytes. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Error codes. For more details, please refer to Chapter 15.5. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 160 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual NOTES 1. For concatenated messages, the maximum length will be reduced by the length of the user data header (UDH). 3GPP TS 23.040 defines two kinds of UDH length: 6 bytes and 7 bytes, so the two kinds of are 8-bit (6 bytes) and 16-bit (7 bytes). AT+QCMGS uses 8-bit . ⚫ In the case of GSM 7 bit default alphabet data coding scheme, the maximum length of each segment of a concatenated message is (140 octets - 6 ) × 8/7=153 characters. ⚫ In the case of 16 bit UCS2 data coding scheme, the maximum length of each segment is (140-6)/2=67 characters. ⚫ In the case of 8-bit data coding scheme, the maximum length of each segment is 140-6=134 characters. 2. Message-Reference field gives an integer representation of a reference number of the SMS-SUBMIT or SMS-COMMAND submitted to the SC by the MS, and it is used to confirm whether the SMS-DELIVER has been received from SC duplicate or not. The field of UDH. It is message identification of the concatenated SMS, which is different from . Each segment in a concatenated message should have the same , but must be incremented for each segment of a concatenated message. 3. AT+QCMGS does not support to send message in PDU mode (AT+CMGF=0). Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > +CMGS: 247 OK //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use to send message, or quits without sending. 9.9. AT+CMMS More Messages to Send This command controls the continuity of the SMS relay protocol link. If the feature is enabled (and supported by the currently used network) multiple messages can be sent faster as the link is kept open. AT+CMMS More Messages to Send Test Command AT+CMMS=? Response +CMMS: (range of supported s) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 161 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Read Command AT+CMMS? Write Command AT+CMMS= Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK Response +CMMS: OK Response OK Or ERROR If there is any error related to ME functionality: +CMS ERROR: 120 s, determined by network. The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. 0 Feature disabled 1 Keep enabled until the time between the response of the latest message send command (AT+CMGS, AT+CMSS, etc.) and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation), and then ME shall close the link and TA switches back to 0 automatically 2 Feature enabled (if the time between the response of the latest message send command and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation), ME shall close the link but TA will not switch back to 0 automatically) Error codes. For more details, please refer to Chapter 15.5. NOTE After the execution of Read Command, a delay of 5-10 seconds is required before issuing the Write Command. Otherwise the +CMS ERROR: 500 may appear. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 162 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 9.10. AT+CMGW Write Message to Memory This Write and Execution Commands store short messages from TE to memory storage , and then the memory location of the stored message is returned. Message status will be set to 'stored unsent' by default, but parameter also allows other status values to be given. The syntax of input text is the same as the one specified in AT+CMGS Write Command. AT+CMGW Write Message to Memory Test Command AT+CMGW=? Write Command 1) If text mode (AT+CMGF=1): AT+CMGW=[,[,]] text is entered quits without sending 2) If PDU mode (AT+CMGF=0): AT+CMGW=[,] PDU is given Response OK Response If writing is successful: +CMGW: OK If there is any error related to ME functionality: +CMS ERROR: Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.005 The command takes effect immediately. The configurations will not be saved. Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address given by . Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (see by default). PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 163 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Message length. Integer type, indicating the length of the message body (or ) in characters in the text mode (AT+CMGF=1), or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.04TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Index of message in selected storage . Error codes. For more details, please refer to Chapter 15.5. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > +CMGW: 4 //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use to write message or to quit without sending. OK AT+CMGF=0 //Set SMS message format as PDU mode. OK AT+CMGW=18 > 0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 164 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 9.11. AT+CMSS Send Message from Storage This Write Command sends message with location value from message storage to the network (SMS-SUBMIT). If new recipient address is given, it shall be used instead of the one stored with the message. Reference value is returned to the TE on successful message delivery. Values can be used to identify message upon unsolicited delivery status report result code. AT+CMSS Send Message from Storage Test Command AT+CMSS=? Write Command AT+CMSS=[,[,]] Response OK Response If in text mode (AT+CMGF=1) and sent successfully: +CMSS: [,] OK If in PDU mode (AT+CMGF=0) and sent successfully: +CMSS: [,] OK Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 120 s, determined by network. The command takes effect immediately. The configurations will not be saved. Parameter Integer type value in the range of location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (see AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (see ). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 165 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual The format is the same as in case of SMS, but without 3GPP TS 24.011 SC address field and the parameter shall be bounded by double quote characters like a normal string type parameter. Error codes. For more details, please refer to Chapter 15.5. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK AT+CMSS=4 +CMSS: 54 OK //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use to send message or to quit without sending. //Send the message of index 4 from memory storage. 9.12. AT+CNMA New Message Acknowledgement to UE/TE This Write and Execution Commands confirm successful receipt of a new message (SMS-DELIVER or SMS-STATUS-REPORT) routed directly to the TE. If the UE does not receive acknowledgement within required time (network timeout), it sends an RP-ERROR message to the network. The UE will automatically disable routing to the TE by setting both and values of AT+CNMI to 0. AT+CNMA New Message Acknowledgement to UE/TE Test Command AT+CNMA=? Response +CNMA: (range of supported s) Execution Command AT+CNMA OK Response OK Or ERROR Write Command If there is any error related to ME functionality: +CMS ERROR: Response EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 166 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CNMA= Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK Or ERROR If there is any error related to ME functionality: +CMS ERROR: 300 ms / Parameter Integer type. Parameter required only for PDU mode. 0 Command operates similarly as in text mode 1 Send positive (RP-ACK) acknowledgement to the network. Accepted only in PDU mode 2 Send negative (RP-ERROR) acknowledgement to the network. Accepted only in PDU mode Error codes. For more details, please refer to Chapter 15.5. NOTE The Execution and Write Commands shall only be used when AT+CSMS parameter equals 1 (phase 2+) and an appropriate URC has been issued by the module, i.e.: +CMT for =2 incoming message classes 0,1,3 and none; +CMT for =3 incoming message classes 0 and 3; +CDS for =1. Example AT+CSMS=1 +CSMS: 1,1,1 OK AT+CNMI=1,2,0,0,0 OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when an SMS is incoming. AT+CNMA OK //Send ACK to the network. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 167 / 316 AT+CNMA +CMS ERROR：340 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //The second time to return error. It needs ACK only once. 9.13. AT+CNMI SMS Event Reporting Configuration This Write Command selects the procedure on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR is at low level (ON). If TE is inactive (e.g. DTR is at high level (OFF)), message receiving should be done as specified in 3GPP TS 23.038. AT+CNMI SMS Event Reporting Configuration Test Command AT+CNMI=? Response +CNMI: (range of supported s),(range of supported s),(list of supported s),(range of supported s),(list of supported s) Read Command AT+CNMI? OK Response +CNMI: ,,,, Write Command AT+CNMI[=[,[,[,[,]]]]] OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any error related to ME functionality: +CMS ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. 0 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications. 1 Discard indication and reject new received message unsolicited result codes EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 168 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual when TA-TE link is reserved (e.g. in on-line data mode). Otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in data mode) and flush them to the TE after reservation. Otherwise forward them directly to the TE. Integer type. The rules for storing received SMS depend on its data coding scheme (refer to 3GPPTS 23.038) and preferred memory storage (AT+CPMS) setting, and the value is: 0 No SMS-DELIVER indications are routed to the TE. 1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE by using unsolicited result code: +CMTI: , 2 SMS-DELIVERs (except class 2) are routed directly to the TE using unsolicited result code: +CMT: [], (PDU mode enabled) or +CMT: ,[],[,,,,,,, ] (text mode enabled; about the parameters in italics, see AT+CSDH) or ^HCMT: ,,,,, ,,, (text mode for CDMA SMS). Class 2 messages result in indication as defined in =1. 3 Class 3 SMS-DELIVERs are routed directly to TE by using unsolicited result codes defined in =2. Messages of other classes result in indication as defined in =1. Integer type. The rules for storing received CBMs depend on its data coding scheme (see 3GPP TS 23.038) and the setting of Select CBM Types (AT+CSCB), and the value is: 0 No CBM indications are routed to the TE. 2 New CBMs are routed directly to the TE using unsolicited result code: +CBM: (PDU mode); or +CBM: ,,,, (text mode) Integer type. 0 No SMS-STATUS-REPORTs are routed to the TE. 1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +CDS: (PDU mode) +CDS: ,,[],[],,, (text mode) 2 If SMS-STATUS-REPORT is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CDSI: , Integer type. 0 TA buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is entered (OK response shall be given before flushing the codes). 1 TA buffer of unsolicited result codes defined within this command is cleared when 1 or 2 is entered. Error codes. For more details, please refer to Chapter 15.5. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 169 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual NOTE Unsolicited result code: +CMTI: , +CMT: [], +CBM: Indicates that new message has been received Short message is outputted directly Cell broadcast message is outputted directly Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CNMI=1,2,0,1,0 OK //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Set SMS-DELIVERs are routed directly to the TE. +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when an SMS is incoming. 9.14. AT+CSCB Select Cell Broadcast Message Types This Write Command selects which types of CBMs are to be received by the ME. AT+CSCB Select Cell Broadcast Message Types Test Command AT+CSCB=? Response +CSCB: (list of supported s) Read Command AT+CSCB? OK Response +CSCB: ,, Write Command AT+CSCB=[,mids>[,]] OK Response OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CMS ERROR: 300 ms The command takes effect immediately. The configurations will be saved automatically. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 170 / 316 Reference 3GPP TS 27.005 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual NOTE The configuration is stored to NVM. Parameter Integer type. 0 Message types specified in and are accepted 1 Message types specified in and are not accepted String type. All different possible combinations of CBM message identifiers (refer to ) (default is empty string), e.g. '0,1,5,320-478,922' String type. All different possible combinations of CBM data coding schemes (refer to ) (default is empty string), e.g. '0-3,5' Error codes. For more details, please refer to Chapter 15.5. 9.15. AT+CSDH Show SMS Text Mode Parameters This Write Command controls whether detailed header information is shown in text mode result codes. AT+CSDH Show SMS Text Mode Parameters Test Command AT+CSDH=? Response +CSDH: (list of supported s) Read Command AT+CSDH? OK Response +CSDH: Write Command AT+CSDH[=] Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK Response OK Or ERROR 300 ms / EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 171 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. 0 Do not show header values defined in commands +CSCA, +CSMP (, , , , , ) and , or in +CMT, +CMGL, +CMGR result codes for SMS-DELIVERs and SMS-SUBMITs in text mode 1 Show the values in result codes Example AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT' ,'', OK AT+CSDH=1 OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 OK 9.16. AT+CSMP Set SMS Text Mode Parameters This command sets values for additional parameters needed when a short message is sent to the network or placed in a storage in text mode. AT+CSMP Set SMS Text Mode Parameters Test Command AT+CSMP=? Read Command AT+CSMP? Response OK Response +CSMP: ,,, Write Command AT+CSMP=[,[,[,] ]] OK Response TA selects values for additional parameters needed when SM is sent to the network or placed in a storage when text mode is selected (AT+CMGF=1). It is possible to set the validity period starting from when the SM is received by the SMSC EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 172 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 ( ranges from 0 to 255) or define the absolute time of the validity period termination ( is a string). OK 300 ms / Parameter First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, SMS-COMMAND in integer format. If a valid value has been entered once, parameter can be omitted. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ). Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. 9.17. AT+QCMGS Send Concatenated Messages This command sends concatenated massages. Different from AT+CMGS, when sending a concatenated message via this command, each segment of the concatenated message must be identified by the additional parameters: , and . When sending all segments of the message one by one, AT+QCMGS must be executed multiple times (equal to ) for each segment. This command is only used in text mode (AT+CMGF=1). AT+QCMGS Send Concatenated Messages Test Command AT+QCMGS=? Write Command If text mode (+CMGF=1): AT+QCMGS=[,],,, text is entered Response OK Response If in text mode (AT+CMGF=1) and sent successfully: +QCMGS: OK Or ERROR If there is any error related to ME functionality: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 173 / 316 Maximum Response Time Characteristics LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +CMS ERROR: 120 s, determined by network. / Parameter Integer type. Message identification in the user data header (UDH). Range: 0–255. This parameter is defined and inputted by the user. All segments of a same concatenated message must have the same . Different concatenated messages should have different . Integer type. Sequence number of a concatenated message. Range: 0–7. =0 means: ignore the value and regard it as a non-concatenated message. Integer type. The total number of the segments of one concatenated message. Range: 0–7. =0 or 1 means: ignore the value and regard it as a non-concatenated message. Please refer to AT+CMGS. Please refer to AT+CMGS. Please refer to AT+CMGS. Integer type. For details of error codes, please refer to Chapter 15.5. NOTES 1. For concatenated messages, the maximum length will be reduced by the length of the user data header (UDH). 3GPP TS 23.040 defines two kinds of UDH length: 6 bytes and 7 bytes, so the two kinds of are 8-bit (6 bytes) and 16-bit (7 bytes). AT+QCMGS uses 8-bit . ⚫ In the case of GSM 7 bit default alphabet data coding scheme, the maximum length of each segment of a concatenated message is (140 octets - 6 ) × 8/7=153 characters. ⚫ In the case of 16 bit UCS2 data coding scheme, the maximum length of each segment is (140-6)/2=67 characters. ⚫ In the case of 8-bit data coding scheme, the maximum length of each segment is 140-6=134 characters. 2. Message-Reference field gives an integer representation of a reference number of the SMS-SUBMIT or SMS-COMMAND submitted to the SC by the MS, and it is used to confirm whether the SMS-DELIVER has been received from SC duplicate or not. The field of UDH. It is message identification of the concatenated SMS, which is different from . Each segment in a concatenated message should have the same , but must be incremented for each segment of a concatenated message. 3. AT+QCMGS does not support to send message in PDU mode (AT+CMGF=0). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 174 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+QCMGS='15056913384',120,1,2 >ABCD +QCMGS: 190 //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Input 120 for , and send the first segment of the concatenated SMS. OK AT+QCMGS='15056913384',120,2,2 >EFGH +QCMGS: 191 //Send the second segment of the concatenated SMS. OK 9.18. AT+QCMGR Read Concatenated Messages The function of this command is similar to AT+CMGR, except that the message to be read is a segment of concatenated messages, and parameters , and would be shown in the result. Several segments should be concatenated to a whole concatenated message according to these three parameters. Similar to AT+QCMGS, AT+QCMGR is only used in text mode (AT+CMGF=1). AT+QCMGR Read Concatenated Messages Test Command AT+QCMGR=? Write Command AT+QCMGR= Response OK Response in text mode (AT+CMGF=1) and command is executed successfully: For SMS-DELIVER: +QCMGR: ,,[],[,,,,,< sca>,,][,,,] OK For SMS-SUBMIT: +QCMGR: ,,[][,,,,,[],< sca>,,][,,,] EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 175 / 316 Maximum Response Time Characteristics LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual OK For SMS-STATUS-REPORTs: +QCMGR: ,,,[],[],,, OK For SMS-COMMANDs: +QCMGR: ,,[,,[],[],[], ] OK Else, If there is any error related to ME functionality: +CMS ERROR: Depends on the length of message content. / Parameter Integer type. Message identification in the user data header (UDH). Range: 0–65535 (see NOTES). All segments of a same concatenated message have same . Different concatenated messages should have different . Integer type. Sequence number of a concatenated message. Range: 1–7. Integer type. The total number of the segments of one concatenated message. Range: 2–7. Other parameters please refer to AT+CMGR Integer type. For details of error codes, please refer to Chapter 15.5. NOTES 1. The in AT+QCMGR is different from the in AT+QCMGS. It is possible that UE receives concatenated messages with 8-bit or 16-bit . So its maximal value is 255 with 8-bit and 65535 with 16-bit. 2. If the message to be read is not a concatenated message, , and would not be shown in the result. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 176 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example +CMTI: 'SM',3 //The first message of a concatenated message comes. +CMTI: 'SM',4 //The second message of a concatenated message comes. AT+QCMGR=3 //Read the first segment of the concatenated message. +QCMGR: 'REC UNREAD','+8615056913384',,'13/07/30,14:44:37+32',120,1,2 ABCD OK AT+QCMGR=4 //Read the second segment of the concatenated message. +QCMGR: 'REC UNREAD','+8615056913384',,'13/07/30,14:44:37+32',120,2,2 EFGH OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 177 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 10 Packet Domain Commands 10.1. AT+CGATT Attachment or Detachment of PS This Write Command attaches the MT to, or detaches the MT from the Packet Domain service. After the command has been completed, the MT remains in V.25ter command state. If the MT is already in the requested state, the command will be ignored and the OK response will be returned. If the requested state cannot be achieved, an ERROR or +CME ERROR response is returned. AT+CGATT Attachment or Detachment of PS Test Command AT+CGATT=? Response +CGATT: (list of supported s) Read Command AT+CGATT? OK Response +CGATT: Write Command AT+CGATT= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 140 s, determined by network. Whether the command takes effect determined by network. The configuration will not be saved. Parameter Integer type. Indicates the state of PS attachment. 0 Detached 1 Attached Other values are reserved and will result in an ERROR response to the Write Command. Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 178 / 316 Example AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //Attach to PS service. //Detach from PS service. //Query the current PS service state. 10.2. AT+CGDCONT Define PDP Context This command specifies PDP context parameters for a specific context . A special form of the Write Command (AT+CGDCONT=) causes the values for context to become undefined. It is not allowed to change the definition of an already activated context. This Read Command returns the current settings for each defined PDP context. AT+CGDCONT Define PDP Context Test Command AT+CGDCONT=? Response +CGDCONT: (range of supported s),,< APN>,,(range of supported s), (range of supported s),(list of supported s),(list of supported s) Read Command AT+CGDCONT? OK Response +CGDCONT: ,,,,,,, […] Write Command AT+CGDCONT=[,[,< APN>[,[,[,< head_comp>[,[,]]]]]]] OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 179 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference 3GPP TS 27.007 The configurations will be saved automatically. Parameter Integer type. PDP context identifier. A numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value = 1) is returned by the test form of the command. String type. Packet data protocol type, a string parameter which specifies the type of packet data protocol. 'IP' Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' String type. Access point name, a string parameter that is a logical name used to select the GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested. String type. Identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The allocated address may be read with AT+CGPADDR. Integer type. Controls PDP data compression (applicable for SNDCP only) (refer to 3GPP TS 44.065). 0 Off (Default if value is omitted) 1 On (Manufacturer preferred compression) 2 V.42bis Integer type. Controls PDP header compression (refer to 3GPP TS 44.065 and 3GPP TS 25.323). 0 Off (Default if value is omitted) 1 On 2 RFC1144 3 RFC2507 4 RFC3095 Integer type. Controls how the MT/TA requests to get the IPv4 address information. 0 IPv4 address allocation through NAS signaling 1 IPv4 address allocated through DHCP Integer type. Indicate the type of PDP context activation request for the PDP context. 0 PDP context is for new PDP context establishment or for handover from a non-3GPP access network (how the MT decides whether the PDP EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 180 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual context is for new PDP context establishment or for handover is implementation specific). 1 PDP context is for emergency bearer services 10.3. AT+CGQREQ Quality of Service Profile (Requested) This command allows the TE to specify the quality of service profile that is used when the MT activates a PDP context. The Write Command specifies a profile for the context . A special form of the Write Command, AT+CGQREQ= causes the requested profile for context number to become undefined. This Read Command returns the current settings for each defined context. Details can be found in 3GPP TS 23.107. AT+CGQREQ Quality of Service Profile (Requested) Test Command AT+CGQREQ=? Response +CGQREQ: ,(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s) Read Command AT+CGQREQ? OK Response +CGQREQ:[ ,,,>reliability>,,] [+CGQREQ: ,,,,,] […] Write Command AT+CGQREQ=[,[, [,[,[,]]]]] OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configurations will be saved automatically. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 181 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). String type. Packet Data Protocol type. 'IP' Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' Integer type. Specifies the precedence class. 0 Network subscribed value 1 High Priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments shall be maintained ahead of precedence class 3 3 Low priority. Service commitments shall be maintained Integer type. Specifies the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the details, please refer to Table 6. 0 Network subscribed value Integer type. Specifies the reliability class. 0 Network subscribed value 1 Non real-time traffic, error-sensitive application that cannot cope with data loss 2 Non real-time traffic, error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic, error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic, error-sensitive application that can cope with data loss 5 Real-time traffic, error non-sensitive application that can cope with data loss Integer type. Specifies the peak throughput class, in octets per second. 0 Network subscribed value 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) 8 Up to 128 000 (1024 kbit/s) 9 Up to 256 000 (2048 kbit/s) A numeric parameter which specifies the mean throughput class, in octets per hour. 0 Network subscribed value 1 100 (~0.22 bit/s) 2 200 (~0.44 bit/s) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 182 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 3 500 (~1.11 bit/s) 4 1 000 (~2.2 bit/s) 5 2 000 (~4.4 bit/s) 6 5 000 (~11.1 bit/s) 7 10 000 (~22 bit/s) 8 20 000 (~44 bit/s) 9 50 000 (~111 bit/s) 10 100 000 (~0.22 kbit/s) 11 200 000 (~0.44 kbit/s) 12 500 000(~1.11 kbit/s) 13 1000 000 (~2.2 kbit/s) 14 2 000 000 (~4.4 kbit/s) 15 5 000 000 (~11.1 kbit/s) 16 10 000 000 (~22 kbit/s) 17 20 000 000 (~44 kbit/s) 18 50 000 000 (~111 kbit/s) 31 Best effort Error codes. For more details, please refer to Chapter 15.4. Table 7: Delay Class SDU Size 128 octets 1024 octets Delay Class 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) Mean Transfer Delay < 0.5 < 5 < 50 Unspecified < 0.5 < 5 < 50 Unspecified 95 Percentile < 1.5 < 25 < 250 < 1.5 < 25 < 250 - EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 183 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 10.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) This command allows the TE to specify a minimum acceptable profile which is checked by the MT against the negotiated profile when the PDP context is activated. This Write Command specifies a profile for the context identified by the context identification parameter . A special form of the Write Command, AT+CGQMIN= causes the minimum acceptable profile for context number to become undefined. In this case no check is made against the negotiated profile. This Read Command returns the current settings for each defined context. Details can be found in 3GPP TS 23.107. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) Test Command AT+CGQMIN=? Response +CGQMIN: ,(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s) Read Command AT+CGQMIN? OK Response +CGQMIN:[ ,,,,,] [+CGQMIN: ,,,,,] […] Write Command AT+CGQMIN=[,[,< delay>[,[,[, ]]]]] OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). String type. Packet Data Protocol type. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 184 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 'IP' IPv4. Internet Protocol (IETF STD 5). 'PPP' 'IPV6' 'IPV4V6' Integer type. Specifies the precedence class. 0 Network subscribed value 1 High Priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments shall be maintained ahead of precedence class 3 3 Low priority. Service commitments shall be maintained Integer type. Specifies the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the detail please refer to Table 6. 0 Network subscribed value Integer type. Specifies the reliability class. 0 Network subscribed value 1 Non real-time traffic, error-sensitive application that cannot cope with data loss 2 Non real-time traffic, error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic, error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic, error-sensitive application that can cope with data loss 5 Real-time traffic, error non-sensitive application that can cope with data loss Integer type. Specifies the peak throughput class, in octets per second. 0 Network subscribed value 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) 8 Up to 128 000 (1024 kbit/s) 9 Up to 256 000 (2048 kbit/s) Integer type. Specifies the mean throughput class, in octets per hour. 0 Network subscribed value 1 100 (~0.22 bit/s) 2 200 (~0.44 bit/s) 3 500 (~1.11 bit/s) 4 1 000 (~2.2 bit/s) 5 2 000 (~4.4 bit/s) 6 5 000 (~11.1 bit/s) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 185 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 7 10 000 (~22 bit/s) 8 20 000 (~44 bit/s) 9 50 000 (~111 bit/s) 10 100 000 (~0.22 kbit/s) 11 200 000 (~0.44 kbit/s) 12 500 000(~1.11 kbit/s) 13 1000 000 (~2.2 kbit/s) 14 2 000 000 (~4.4 kbit/s) 15 5 000 000 (~11.1 kbit/s) 16 10 000 000 (~22 kbit/s) 17 20 000 000 (~44 kbit/s) 18 50 000 000 (~111 kbit/s) 31 Best effort Error codes. For more details, please refer to Chapter 15.4. 10.5. AT+CGEQREQ UMTS Quality of Service Profile (Requested) This command allows the TE to specify a UMTS Quality of Service Profile that is used when the MT activates a PDP context. Details can be found in 3GPP TS 23.107. AT+CGEQREQ UMTS Quality of Service Profile (Requested) Test Command AT+CGEQREQ=? Response +CGEQREQ: ,(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(listof supported s),(list of supported s),(list of supported s),(range of supported s),(list of supported s),(range of supported s),(list of supported s),(list of supported s) Read Command AT+CGEQREQ? OK Response +CGEQREQ:[ ,,,,,< Guaranteed bitrate DL>,,,,, ,,,,] [...] Write Command AT+CGEQREQ=[[,[,[,[,[,[,[, [,[,[,[,[,[,[,]]]]]]]]]]]]]]] OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. PDP context identifier, a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of the command. String type. Packet data protocol type, a string parameter which specifies the type of packet data protocol. 'IP' IPv4. Internet protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' The following parameters are defined in 3GPP TS 23.107 Integer type. Indicates the type of application for which the UMTS bearer service is optimized (refer to 3GPP TS 24.008 subclause 10.5.6.5). If the parameter is specified as conversational or streaming, then the Guaranteed and Maximum bitrate parameters should also be provided. 0 Conversational EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 187 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 1 Streaming 2 Interactive 3 Background 4 Subscribed value Integer type. Indicates the maximum number of kbits/s delivered to UMTS (uplink traffic) at an SAP. As an example, a bit rate of 32 kbit/s would be specified as 32 (e.g. AT+CGEQREQ=…,32,…). 0 Subscribed value 1–11520 Integer type. Indicates the maximum number of kbits/s delivered by UMTS (downlink traffic) at an SAP. As an example, a bit rate of 32 kbit/s would be specified as 32 (e.g. AT+CGEQREQ=…,32,…). 0 Subscribed value 1–42200 Integer type. Indicates the guaranteed number of kbits/s delivered to UMTS (uplink traffic) at an SAP (provided that there is data to deliver). As an example, a bitrate of 32 kbit/s would be specified as 32 (e.g. AT+CGEQREQ=…,32,…). 0 Subscribed value 1–11520 Integer type. Indicates the guaranteed number of kbits/s delivered by UMTS (downlink traffic) at an SAP (provided that there is data to deliver). As an example, a bitrate of 32 kbit/s would be specified as 32 (e.g. AT+CGEQREQ=…,32,…). 0 Subscribed value 1–42200 Integer type. Indicates whether the UMTS bearer shall provide in-sequence SDU delivery or not (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 No 1 Yes 2 Subscribed value Integer type. (1,2,3,…) indicates the maximum allowed SDU size in octets. If the parameter is set to 0 the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed value 10–1520 (This value needs to be divisible by 10 without remainder) 1520 String type. Indicates the target value for the fraction of SDUs lost or detected as erroneous. SDU error ratio is defined only for conforming traffic. The value is specified as 'mEe'. As an example, a target SDU error ratio of 5 × 10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…). '0E0' Subscribed value EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 188 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual '1E1' '1E2' '7E3' '1E3' '1E4' '1E5' '1E6' String type. Indicates the target value for the undetected bit error ratio in the delivered SDUs. If no error detection is requested, Residual bit error ratio indicates the bit error ratio in the delivered SDUs. The value is specified as 'mEe'. As an example a target residual bit error ratio of 5 × 10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…). '0E0' Subscribed value '5E2' '1E2' '5E3' '4E3' '1E3' '1E4' '1E5' '1E6' '6E8' Integer type. Indicates whether SDUs detected as erroneous shall be delivered or not (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 No 1 Yes 2 No detect 3 Subscribed value Integer type. (0,1,2,…) indicates the targeted time between request to transfer an SDU at one SAP to its delivery at the other SAP, in milliseconds. If the parameter is set to 0 the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed value 100–150 (This value needs to be divisible by 10 without remainder) 200–950 (This value needs to be divisible by 50 without remainder) 1000–4000 (This value needs to be divisible by 100 without remainder) Integer type. (1,2,3,…) specifies the relative importance for handling of all SDUs belonging to the UMTS bearer compared to the SDUs of other bearers. If the parameter is set to 0 the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 189 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 0 Subscribed 1 2 3 Integer type. Specifies characteristics of the source of the submitted SDUs for a PDP context. 0 Characteristics of SDUs is unknown 1 Characteristics of SDUs correspond to a speech source Integer type. Indicates signaling content of submitted SDUs for a PDP context. 0 PDP context is not optimized for signaling 1 PDP context is optimized for signaling 10.6. AT+CGEQMIN UMTS Quality of Service Profile (Minimum Acceptable) This command allows the TE to specify a minimum acceptable profile, which is checked by the MT against the negotiated profile returned in the PDP context establishment and PDP context modification procedures. Details can be found in 3GPP TS 23.107. AT+CGEQMIN UMTS Quality of Service Profile (Minimum Acceptable) Test Command AT+CGEQMIN=? Response +CGEQMIN: ,(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(list of supported s),(list of supported s),(list of supported s),(range of supported s),(list of supported s),(range of supported s),(list of supported s),(list of supported s) Read Command AT+CGEQMIN? OK Response +CGEQMIN:[ ,,,,,,,,,,< Delivery of erroneous SDUs>,,,,] […] Write Command AT+CGEQMIN=[[,[,[,[,[,[,[, [,[,[,[,[,[,[,]]]]]]]]]]]]]]] OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. PDP context identifier. A numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value = 1) is returned by the test form of the command. String type Packet data protocol type. A string parameter which specifies the type of packet data protocol. 'IP' IPv4 'PPP' 'IPV6' 'IPV4V6' The following parameters are defined in 3GPP TS 23.107. Integer type. Indicates the type of application for which the UMTS bearer service is optimized (refer to 3GPP TS 24.008 subclause 10.5.6.5). If the parameter is specified as conversational or streaming, then the Guaranteed and Maximum bitrate parameters should also be provided. 0 Conversational EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 191 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 1 Streaming 2 Interactive 3 Background 4 Subscribed value Integer type. Indicates the maximum number of kbits/s delivered to UMTS (uplink traffic) at an SAP. As an example, a bitrate of 32 kbit/s would be specified as 32 (e.g. AT+CGEQREQ=…,32,…). 0 Subscribed value 1–11520 Integer type. Indicates the maximum number of kbits/s delivered by UMTS (downlink traffic) at an SAP. As an example, a bitrate of 32 kbit/s would be specified as 32 (e.g. AT+CGEQREQ=…,32,…). 0 Subscribed value 1–42200 Integer type. Indicates the guaranteed number of kbits/s delivered to UMTS (uplink traffic) at an SAP (provided that there is data to deliver). As an example, a bitrate of 32 kbit/s would be specified as 32 (e.g. AT+CGEQREQ=…,32,…). 0 Subscribed value 1–11520 Integer type. Indicates the guaranteed number of kbits/s delivered by UMTS (downlink traffic) at an SAP (provided that there is data to deliver). As an example, a bitrate of 32 kbit/s would be specified as 32 (e.g. AT+CGEQREQ=…,32,…). 0 Subscribed value 1–42200 Integer type. Indicates whether the UMTS bearer shall provide in-sequence SDU delivery or not (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 No 1 Yes 2 Subscribed value Integer type. (1,2,3,…) indicates the maximum allowed SDU size in octets. If the parameter is set to 0 the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed value 10–1520 (This value needs to be divisible by 10 without remainder) 1502 String type. Indicates the target value for the fraction of SDUs lost or detected as erroneous. SDU error ratio is defined only for conforming traffic. The value is specified as mEe. As an example a target SDU error ratio of 5 × 10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…). '0E0' Subscribed value EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 192 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual '1E2' '7E3' '1E3' '1E4' '1E5' '1E6' '1E1' String type. Indicates the target value for the undetected bit error ratio in the delivered SDUs. If no error detection is requested, Residual bit error ratio indicates the bit error ratio in the delivered SDUs. The value is specified as 'mEe'. As an example a target residual bit error ratio of 5 × 10-3 would be specified as '5E3' (e.g. AT+CGEQREQ=…,'5E3',…). '0E0' Subscribed value '5E2' '1E2' '5E3' '4E3' '1E3' '1E4' '1E5' '1E6' '6E8' Integer type. Indicates whether SDUs detected as erroneous shall be delivered or not (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 No 1 Yes 2 No detect 3 Subscribed value Integer type. Indicates the targeted time between request to transfer an SDU at one SAP to its delivery at the other SAP, in milliseconds. If the parameter is set to 0 the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). 0 Subscribed value 100–150 (This value needs to be divisible by 10 without remainder) 200–950 (This value needs to be divisible by 50 without remainder) 1000–4000 (This value needs to be divisible by 100 without remainder) Integer type. Specifies the relative importance for handling of all SDUs belonging to the UMTS bearer compared to the SDUs of other bearers. If the parameter is set to ‘0’ the subscribed value will be requested (refer to 3GPP TS 24.008 subclause 10.5.6.5). EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 193 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Range: 0–3. Default: 0. Integer type. Specifies characteristics of the source of the submitted SDUs for a PDP context. 0 Characteristics of SDUs are unknown 1 Characteristics of SDUs corresponds to a speech source Integer type. Indicates signaling content of submitted SDUs for a PDP context. 0 PDP context is not optimized for signaling 1 PDP context is optimized for signaling Error codes. For more details, please refer to Chapter 15.4. 10.7. AT+CGACT Activate or Deactivate PDP Context This Write Command activates or deactivates the specified PDP context(s). After the command has completed, the MT remains in V.250 command state. If any PDP context is already in the requested state, the state for that context remains unchanged. If the MT is not PS attached when the activation form of the command is executed, the MT first performs a PS attach and then attempts to activate the specified contexts. If no s specify the activation/deactivation form of the command, it will activate or deactivate all defined contexts. AT+CGACT Activate or Deactivate PDP Context Test Command AT+CGACT=? Response +CGACT: (list of supported s) Read Command AT+CGACT? OK Response +CGACT: , [+CGACT: , …] Write Command AT+CGACT=, OK Response OK Or NO CARRIER Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 150 s, determined by network. Whether the command takes effect is determined by network. The configurations will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 194 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference 3GPP TS 27.007 Parameter Integer type. Indicates the state of PDP context activation. 0 Deactivated 1 Activated Other values are reserved and will result in an ERROR response to the Write Command Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). Error codes. For more details, please refer to Chapter 15.4. Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGACT=0,1 OK //Define PDP context. //Activated PDP. //Deactivated the PDP. 10.8. AT+CGDATA Enter Data State This Write Command causes the MT to perform whatever actions that are necessary to establish communication between the TE and the network using one or more packet domain PDP types. This may include performing a PS attach and one or more PDP context activations. Any command following the AT+CGDATA in the AT command line will not be processed by the MT. If the value is unacceptable to the MT, the MT shall return an ERROR or +CME ERROR response. Otherwise, the MT issues the intermediate result code CONNECT and enters V.250 online data state. After data transfer is completed, and the layer 2 protocol termination procedure has been completed successfully, the command state is reentered and the MT returns the final result code OK. AT+CGDATA Enter Data State Test Command AT+CGDATA=? Response +CGDATA: (list of supported s) Write Command AT+CGDATA=[,[,[,… ]]] OK Response CONNECT Or EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 195 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms Whether the command takes effect is determined by network. The configurations will not be saved. Parameter String type. Indicates the layer 2 protocol to be used between the TE and MT: PPP Point to Point protocol for a PDP such as IP Other values are not supported and will result in an ERROR response to the Execution Command Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). Error codes. For more details, please refer to Chapter 15.4. 10.9. AT+CGPADDR Show PDP Address This Write Command returns a list of PDP addresses for the specified context identifiers. If no is specified, the addresses for all defined contexts are returned. AT+CGPADDR Show PDP Address Test Command AT+CGPADDR=? Response +CGPADDR: (list of defined s) Write Command AT+CGPADDR[=[,[,…]]] OK Response +CGPADDR: , [+CGPADDR: , …] Maximum Response Time Characteristics OK Or ERROR 300 ms Whether the command takes effect is determined by network. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 196 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference 3GPP TS 27.007 The configurations will not be saved. Parameter Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). String type. Identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by AT+CGDCONT when the context was defined. For a dynamic address it will be the one assigned during the last PDP context activation that used the context definition referred to by . is omitted if none is available. Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' OK //Define PDP context. //Activated PDP. //Show PDP address. 10.10. AT+CGCLASS GPRS Mobile Station Class This command sets the MT to operate according to the specified mode of operation. See 3GPP TS 23.060. AT+CGCLASS GPRS Mobile Station Class Test Command AT+CGCLASS=? Response +CGCLASS: (list of supported s) Read Command AT+CGCLASS? OK Response +CGCLASS: Write Command AT+CGCLASS= OK Response OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 197 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter String type. Indicates the GPRS mobile class (Functionality in descending order) 'A' Class A Error codes. For more details, please refer to Chapter 15.4. 10.11. AT+CGREG Network Registration Status This command queries the network registration status and controls the presentation of an unsolicited result code +CGREG: when =1 and there is a change in the MT’s GPRS network registration status in GERAN/UTRAN, or unsolicited result code +CGREG: [,[],[],[]] when =2 and there is a change of the network cell in GERAN/UTRAN. AT+CGREG Network Registration Status Test Command AT+CGREG=? Response +CGREG: (list of supported s) Read Command AT+CGREG? OK Response +CGREG: ,[,,[,]] Write Command AT+CGREG[=] Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 198 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Reference 3GPP TS 27.007 The configuration will be saved automatically. Parameter Integer type. Control the presentation of the specified URC. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CGREG: 2 Enable network registration and location information unsolicited result code +CGREG: [,,[,]] Integer type. Network registration status. 0 Not registered. MT is not currently searching an operator to register to. The UE is in GMM state GMM-NULL or GMM-DEREGISTERED-INITIATED. The GPRS service is disabled, but the UE is allowed to attach for GPRS if requested by the user. 1 Registered, home network. The UE is in GMM state GMM-REGISTERED or GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED on the home PLMN. 2 Not registered, but MT is currently trying to attach or searching an operator to register to. UE is in GMM state GMM-DEREGISTERED or GMM-REGISTERED-INITIATED. The GPRS service is enabled, but an allowable PLMN is currently not available. The UE will start a GPRS attach as soon as an allowable PLMN is available. 3 Registration denied. The UE is in GMM state GMM-NULL. The GPRS service is disabled, and the UE is not allowed to attach for GPRS if requested by the user. 4 Unknown 5 Registered, roaming String type. Two-byte location area code in hexadecimal format (e.g. '00C3' equals 195 in decimal). String type. 16 bit (GSM) or 28 bit (UMTS/LTE) cell ID in hexadecimal format. Integer type. Access technology selected. 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN Example AT+CGREG=2 OK AT+CGATT=0 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 199 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +CGREG: 2 AT+CGATT=1 OK +CGREG: 1,'D504','80428B5',7 10.12. AT+CGEREP Packet Domain Event Reporting This Write Command enables or disables sending of unsolicited result codes +CGEV: XXX from MT to TE in the case of certain events occurring in the Packet Domain MT or the network. controls the processing of unsolicited result codes specified within this command. controls the effect on buffered codes when =1 or 2. AT+CGEREP Packet Domain Event Reporting Test Command AT+CGEREP=? Response +CGEREP: (range of supported s),(list of supported s) Read Command AT+CGEREP? OK Response +CGEREP: , Write Command AT+CGEREP=mode[,] Execution Command AT+CGEREP Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK Or ERROR Response OK 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Controls the processing of unsolicited result codes specified within this command. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 200 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 0 Buffer unsolicited result codes in the MT; if MT result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE. 1 Discard unsolicited result codes when MT-TE link is reserved (e.g. in on-line data mode), otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the MT when MT-TE link is reserved (e.g. in on-line data mode) and flush them to the TE when MT-TE link becomes available. Otherwise forward them directly to the TE. Integer type. Controls the effect on buffered codes. 0 MT buffer of unsolicited result codes defined within this command is cleared when 1 or 2 is specified. 1 MT buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is specified (OK response shall be given before flushing the codes). NOTE The unsolicited result codes and the corresponding events are defined as follows: 1. +CGEV: REJECT , : A network request for PDP context activation occurred when the MT was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. Note: This event is not applicable for EPS. 2. +CGEV: NW REACT , ,[]: The network has requested a context reactivation. The used to reactivate the context is provided if known to the MT. Note: This event is not applicable for EPS. 3. +CGEV: NW DEACT , ,[]: The network has forced a context deactivation. The used to activate the context is provided if known to the MT. 4. +CGEV: ME DEACT , ,[]: The mobile equipment has forced a context deactivation. The used to activate the context is provided if known to the MT. 5. +CGEV: NW DETACH: The network has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 6. +CGEV: ME DETACH: The mobile equipment has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 7. +CGEV: NW CLASS : The network has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 8. +CGEV: ME CLASS : The mobile equipment has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 9. +CGEV: PDN ACT : Activated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. 10. +CGEV: PDN DEACT : Deactivated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 201 / 316 Example AT+CGEREP=? +CGEREP: (0-2),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 10.13. AT+CGSMS Select Service for MO SMS Messages This command specifies the service or service preference that the MT will use to send MO (mobile originated) SMS messages. AT+CGSMS Select Service for MO SMS Messages Test Command AT+CGSMS=? Response +CGSMS: (range of supported s) Read Command AT+CGSMS? OK Response +CGSMS: Write Command AT+CGSMS=[] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms Parameter Integer type. indicates the service or service preference to be used. 0 GPRS 1 Circuit switch EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 202 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2 GPRS preferred (use circuit switched if GPRS not available) 3 Circuit switch preferred (use GPRS if circuit switched not available) Error codes. For more details, please refer to Chapter 15.4. 10.14. AT+CEREG EPS Network Registration Status This command queries the network registration status and controls the presentation of an unsolicited result code +CEREG: when =1 and there is a change in the MT’s EPS network registration status in E-UTRAN, or unsolicited result code +CEREG: [,[],[],[]] when =2 and there is a change of the network cell in E-UTRAN. AT+CEREG EPS Network Registration Status Test Command AT+CEREG=? Response +CEREG: (list of supported s) Read Command AT+CEREG? OK Response +CEREG: ,[,,[,]] Write Command AT+CEREG[=] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK Or ERROR 300 ms Parameter Integer type. Controls the presentation of an unsolicited result code +CEREG: . 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CEREG: 2 Enable network registration and location information unsolicited result code +CEREG: [,,[,]] Integer type. 0 Not registered. MT is not currently searching an operator to register to 1 Registered, home network EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 203 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 2 Not registered, but MT is currently trying to attach or searching an operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two-byte tracking area code in hexadecimal format. String type. 28-bit E-UTRAN cell ID in hexadecimal format. Integer type. Access technology selected. 0 GSM 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN 10.15. AT+QGDCNT Packet Data Counter This command allows the application to check how much bytes are sent to or received by the module. AT+QGDCNT Packet Data Counter Test Command AT+QGDCNT=? Response +QGDCNT: (list of supported s) Read Command AT+QGDCNT? OK Response +QGDCNT: , Write Command AT+QGDCNT= OK Response OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms Whether the command takes effect is determined by network. The configuration will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 204 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. The operation about data counter. 0 Reset the data counter 1 Save the results of data counter to NVM If results need to be automatically saved, please refer to AT+QAUGDCNT. Integer type. The amount of sent bytes. Integer type. The amount of received bytes. Error codes. For more details, please refer to Chapter 15.4. NOTE When the MT is powered on, and are loaded from results of data counter in NVM. The default result in NVM is 0. Example AT+QGDCNT=? +QGDCNT: (0,1) //Test command. OK AT+QGDCNT? //Query the current bytes sent and received. +QGDCNT: 3832,4618 OK AT+QGDCNT=1 OK AT+QGDCNT=0 OK //Save the results to NVM. //Reset the data counter. 10.16. AT+QAUGDCNT Auto Save Packet Data Counter This command allows AT+QGDCNT to save results to NVM automatically. AT+QAUGDCNT Auto Save Packet Data Counter Test Command AT+QAUGDCNT=? Response +QAUGDCNT: (list of supported s) Read Command AT+QAUGDCNT? OK Response +QAUGDCNT: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 205 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Write Command AT+QAUGDCNT= Maximum Response Time Characteristics OK Response OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms Whether the command takes effect is determined by network. The configuration will not be saved. Parameter Integer type. This parameter is the time-interval for AT+QGDCNT to save results to NV automatically. Range: 0, 30–65535. Default: 0. Unit: second. If it is set to 0, auto-save feature is disabled. Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUGDCNT=? //Test command. +QAUGDCNT: (0,30-65535) OK AT+QGDCNT=35 OK AT+QAUGDCNT? +QAUGDCNT: 35 //Set to 35. //Query the interval of auto-save. OK 10.17. AT$QCRMCALL Start or Stop an RmNet Call This command triggers an RmNet call based on parameter which is typically a start of an RmNet Call or stop of an RmNet call. AT$QCRMCALL Start or Stop a RmNet Call Test Command AT$QCRMCALL=? Response $QCRMCALL: (list of supported s),(range of EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 206 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual supported s),(range of supported s),(list of supported s),(list of supported s),, Read Command AT$QCRMCALL? OK Response If a RmNet call has been established: $QCRMCALL: , Write Command AT$QCRMCALL=, [,[,[,]] OK Or ERROR Response OK Or ERROR Maximum Response Time Characteristics / Parameter Integer type. 0 Stop a RmNet call 1 Start a RmNet call Integer type. Currently this parameter only can be set to 1. Integer type. 1 Call type is IPV4 2 Call type is IPV6 3 Call type is IPV4V6 Integer type. 1 3GPP2(CMDA/HDR/EHPRD) 2 3GPP(GSM/WCDMA/LTE/TDS-CDMA) Integer type. Range: 1–24, 100–179. String type. V4 IPv4 call V6 IPv6 call Example AT$QCRMCALL=? //Test command. $QCRMCALL: (0,1),(1,2,3,4,5,6,7,8),(1-3),(1-2),(1-24,100-179),, OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 207 / 316 AT$QCRMCALL=1,1,1,2,1 $QCRMCALL: 1,V4 OK AT$QCRMCALL? $QCRMCALL: 1,V4 OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //Start a IPv4 RmNet call. 10.18. AT+QNETDEVSTATUS Query RmNet Device Status This command can query RmNet device status. AT+QNETDEVSTATUS Query RmNet Device Status Test Command AT+QNETDEVSTATUS=? Response +QNETDEVSTATUS: (list of supported s) Read Command AT+QNETDEVSTATUS? OK Response If an RmNet call exists, , and will be included. +QNETDEVSTATUS: [,[,[,]]] Write Command AT+QNETDEVSTATUS= OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics / Parameter Integer type. 0 Disable RmNet device status URC 1 Enable RmNet device status URC Integer type. 0 Enable RmNet device status URC 1 A RmNet call is ready and MCU can get IP addresses by DHCP or QMI 2 A RmNet call is connected EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 208 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. 4 IPv4 call 6 IPv6 call Other value is invalid. Integer type. RmNet call instance. It is always 1. NOTE When the module gets IP addresses from network successfully, will be change to 1 and the module will keep IP addresses for 2 min to wait for MCU to request IP addresses from module by DHCP or QMI. The module will disconnect an RmNet call if IP addresses requests are not be received by the module in 2 min. Example AT+QNETDEVSTATUS=? +QNETDEVSTATUS: (0,1) OK AT+QNETDEVSTATUS? +QNETDEVSTATUS: 0 OK AT+QNETDEVSTATUS=1 OK AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1 OK AT$QCRMCALL=1,1,1,2,1 $QCRMCALL: 1,4 OK +QNETDEVSTATUS: 1,1,4,1 +QNETDEVSTATUS: 1,2,4,1 AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1,2,4,1 OK AT$QCRMCALL=0,1,1,2,1 OK //Test command. //Query command. //Enable RmNet device status URC. //Query command. //Start an IPv4 RmNet call. //RmNet call is ready URC. //MCU get IP addresses from module. //Query the current configuration. //Stop an IPv4 RmNet call. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 209 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +QNETDEVSTATUS: 1,0,4,1 AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1 OK //Module report RmNet call disconnect URC. //Query the current configuration. 10.19. AT+CGCONTRDP PDP Context Read Dynamic Parameters AT+CGCONTRDP PDP Context Read Dynamic Parameters Test Command AT+CGCONTRDP=? Response +CGCONTRDP: (list of supported s) Write Command AT+CGCONTRDP[=] OK Response +CGCONTRDP: ,,[,[,[,[,[,[,[,[,[,[,[,[,[,]]]]]]]]]]]]]] [+CGCONTRDP: ,,[,[,[,[,[,[,[,[,[,[,[,[,[,]]]]]]]]]]]]] [...] Maximum Response Time Characteristics OK Or ERROR 300 ms / EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 210 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. Specifies a particular non secondary PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related command. Integer type. Identifies the bearer, i.e. the EPS bearer in EPS and the NSAPI in UMTS/GPRS. 1 A RmNet call is ready and MCU can get IP addresses by DHCP or QMI 2 A RmNet call is connected String type. A logical name that was used to select the GGSN or the external packet data network. String type. Shows the IP address and subnet mask of the MT. The string is given as dot-separated numeric (0–255) parameters on the form: 'a1.a2.a3.a4.m1.m2.m3.m4' for IPv4 or 'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16.m1.m2.m3. m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15.m16' for IPv6. String type. Shows the Gateway Address of the MT. The string is given as dot-separated numeric (0–255) parameters. String type. Shows the IP address of the primary DNS server. String type. Shows the IP address of the secondary DNS server. String type. Shows the IP address of the primary P-CSCF server. String type. Shows the IP address of the secondary P-CSCF server. Integer type. Shows whether the PDP context is for IM CN subsystem-related signalling only or not. 0 PDP context is not for IM CN subsystem-related signalling only 1 PDP context is for IM CN subsystem-related signalling only Integer type. Indicates that the PDP context provides connectivity using a LIPA PDN connection. This parameter cannot be set by the TE. 0 Indication not received that the PDP context provides connectivity using a LIPA PDN connection 1 Indication received that the PDP context provides connectivity using a LIPA PDN connection Integer type. Shows the IPv4 MTU size in octets. Integer type. Indicates whether traffic can be offloaded using the specified PDN connection via a WLAN or not. This refers to bits 1 and 2 of the WLAN offload acceptability IE as specified in 3GPP TS 24.008 [8] subclause 10.5.6.20. 0 Offloading the traffic of the PDN connection via a WLAN when in S1 mode or when in Iu mode is not acceptable. 1 Offloading the traffic of the PDN connection via a WLAN when in S1 mode is acceptable, but not acceptable in Iu mode. 2 Offloading the traffic of the PDN connection via a WLAN when in Iu mode is acceptable, but not acceptable in S1 mode. 3 Offloading the traffic of the PDN connection via a WLAN when in S1 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 211 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual mode or when in Iu mode is acceptable. Integer type. Indicates whether or not the MS and the network support local IP address in TFTs (see 3GPP TS 24.301 [83] and 3GPP TS 24.008 [8] subclause 10.5.6.3) 0 Indicates that the MS or the network or both do not support local IP address in TFTs 1 Indicates that the MS and the network support local IP address in TFTs Integer type. Shows the Non-IP MTU size in octets. Integer type. Indicates the maximum number of uplink messages the UE is allowed to send in a 6 minute interval. This refers to octet 3 to 4 of the Serving PLMN rate control IE as specified in 3GPP TS 24.301 [8] subclause 9.9.4.28. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 212 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 11 Supplementary Service Commands 11.1. AT+CCFC Call Forwarding Number and Conditions Control This command allows control of the call forwarding supplementary service according to 3GPP TS 22.082. Registration, erasure, activation, deactivation and status query are supported. TA controls the call forwarding supplementary service. Registration, erasure, activation, deactivation, and status query are supported. AT+CCFC Call Forwarding Number and Conditions Control Test Command AT+CCFC=? Response +CCFC: (range of supported s) Write Command AT+CCFC=,[,[,[,[,[,[,time]]]]]] OK Response If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully (only in connection with 0–3): For registered call forwarding numbers: +CCFC: ,[,,[,,[,]]] [+CCFC: ,[,,[,,[,]]]] OK If no call forwarding numbers are registered (and therefore all classes are inactive): +CCFC: , OK where =0 and =15 If there is any error related to ME functionality: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 213 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 +CME ERROR: 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Configure the forwarding conditions. 0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All call forwarding (0–3) 5 All conditional call forwarding (1–3) Integer type. Controls the call forwarding supplementary service. 0 Disable 1 Enable 2 Query status 3 Registration 4 Erasure Phone number in string type of forwarding address in format specified by . Integer type. Type of address. Default value: 145 when dialing string includes international access code character '+', otherwise 129. String type sub-address of format specified by . Type of sub-address in integer. Integer type. Information class. 1 Voice 2 Data 4 FAX 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization Integer type. When 'no reply' (=no reply) is enabled or queried, this gives the time in seconds to wait before call is forwarded. Range: 1–30. Default: 20. Integer type. 0 Not active 1 Active Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 214 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,255 OK //Register the destination number for unconditional call forwarding (CFU). //Query the status of CFU without specifying . //Erase the registered CFU destination number. //Query the status, no destination number. 11.2. AT+CCWA Call Waiting Control This command allows control of the call waiting supplementary service according to 3GPP TS 22.083. Activation, deactivation and status query are supported. TA controls the call waiting supplementary service with the Write Command. Activation, deactivation and status query are supported. AT+CCWA Call Waiting Control Test Command AT+CCWA=? Response +CCWA: (list of supported s) Read Command AT+CCWA? OK Response +CCWA: Write Command AT+CCWA[=][,[,]] OK Response If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully: +CCWA: , [+CCWA:, ...] OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 215 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will not be saved. Parameter . Integer type. Disable or enable the presentation of an unsolicited result code. 0 Disable presentation of an unsolicited result code 1 Enable presentation of an unsolicited result code Integer type. When parameter is not given, network is not interrogated. 0 Disable 1 Enable 2 Query status A sum of integers, each integer represents a class of information. 1 Voice (telephony) 2 Data (bearer service) 4 FAX (facsimile) 16 Data circuit synchronization 32 Data circuit asynchronization Integer type. Disable or enable the call waiting supplementary service. 0 Disable 1 Enable Phone number in string type of calling address in format specified by . Type of address octet in integer format. 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Optional string type alphanumeric representation of corresponding to the entry found in phone book. Error codes. For more details, please refer to Chapter 15.4. NOTES 1. =0 should be returned only if service is not active for any i.e. +CCWA: 0,7 will be returned in this case. 2. When =2, all active call waiting classes will be reported. In this mode the command is aborted by pressing any key. 3. Unsolicited result code: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 216 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual When the presentation call waiting at the TA is enabled (and call waiting is enabled) and a terminating call set up during an established call, an unsolicited result code is returned: +CCWA: ,,[,] Example AT+CCWA=1,1 OK ATD10086; OK +CCWA: '02154450293',129,1 //Enable presentation of an unsolicited result code. //Establish a call. //Indication of a call that has been waiting. 11.3. AT+CHLD Call Related Supplementary Services This command allows the control of the following call related services: ⚫ A call can be temporarily disconnected from the MT but the connection is retained by the network; ⚫ Multiparty conversation (conference calls); ⚫ The served subscriber who has two calls (one held and the other either active or alerting) can connect the other parties and release the served subscriber’s own connection. Calls can be put on hold, recovered, released and added to a conversation, and transferred similarly as defined in 3GPP TS 22.030. This is based on the GSM/UMTS supplementary services HOLD (Call Hold; refer to 3GPP TS 22.083 clause 2), MPTY (MultiParty; refer to 3GPP TS 22.084) and ECT (Explicit Call Transfer; refer to 3GPP TS 22.091). The interaction of this command with other commands based on other GSM/UMTS supplementary services is described in the GSM/UMTS standards. Call Hold, MultiParty and Explicit Call Transfer are only applicable to teleservice 11. TA controls the supplementary services call hold, multiparty and explicit call transfer with the Write Command. Calls can be put on hold, recovered, released, added to conversation and transferred. AT+CHLD Call Related Supplementary Services Test Command AT+CHLD=? Response +CHLD: (list of supported s) Write Command AT+CHLD[=] OK Response OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 217 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter 0 Terminate all held calls or UDUB (User Determined User Busy) for a waiting call. If a call is waiting, terminate the waiting call. Otherwise, terminate all held calls (if any) 1 Terminate all active calls (if any) and accept the other call (waiting call or held call). 1X Terminate the specific call number X (X=1-7) 2 Place all active calls on hold (if any) and accept the other call (waiting call or held call) as the active call 2X Place all active calls except call X (X=1-7) on hold 3 Add the held call to the active calls 4 Connects the two calls and disconnects the subscriber from both calls (ECT) Error codes. For more details, please refer to Chapter 15.4. Example ATD10086; OK +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129 +CLCC: 2,1,0,0,0,'02154450293',129 OK AT+CHLD=21 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 //Establish a call. //Indication of a call that has been waiting. //Place the active call on hold and accept the waiting call as the active call. //The first call is on hold. //The second call is active. //Place the active call except call X=1 on hold. //The first call is active. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 218 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +CLCC: 2,1,1,0,1,'02154450293',129 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129 +CLCC: 2,1,0,0,1,'02154450293',129 OK //The second call is on hold. //Add a held call to the active calls in order to set up a conference (multiparty) call. 11.4. AT+CLIP Calling Line Identification Presentation This command refers to the GSM/UMTS supplementary service CLIP (Calling Line Identification Presentation) that enables a called subscriber to get the calling line identity (CLI) of the calling party when receiving a mobile terminated call. TA enables or disables the presentation of the calling line identity (CLI) at the TE with the Write Command. It has no effect on the execution of the supplementary service CLIP in the network. AT+CLIP Calling Line Identification Presentation Test Command AT+CLIP=? Response +CLIP: (list of supported s) Read Command AT+CLIP? OK Response +CLIP: , Write Command AT+CLIP= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 15 s, determined by network. The command takes effect immediately. The configuration will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 219 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. 0 Suppress unsolicited result codes 1 Display unsolicited result codes Integer type. 0 CLIP not provisioned 1 CLIP provisioned 2 Unknown Phone number in string type of calling address in format specified by String type sub-address of format specified by Type of sub-address octet in integer format (refer to 3GPP TS 24.008 [8] subclause 10.5.4.8) Type of address octet in integer format 129 Unknown type (IDSN format) 145 International number type (ISDN format) 161 National number String type alphanumeric representation of corresponding to the entry found in phone book. Integer type. 0 CLI valid 1 CLI has been withheld by the originator 2 CLI is not available due to interworking problems or limitations of originating network Error codes. For more details, please refer to Chapter 15.4. NOTE Unsolicited result code: When the presentation of the CLIP at the TE is enabled (and calling subscriber allows), an unsolicited result code is returned after every RING (or +CRING: ) at a mobile terminating call: +CLIP: ,,[subaddr],[satype],[], Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,,,'QUECTEL',0 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 220 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 11.5. AT+CLIR Calling Line Identification Restriction This command refers to the CLIR supplementary service (Calling Line Identification Restriction) according to 3GPP TS 22.081 and the OIR supplementary service (Originating Identification Restriction) according to 3GPP TS 24.607 that allows a calling subscriber to enable or disable the presentation of the calling line identity (CLI) to the called party when originating a call. TA restricts or enables the presentation of the calling line identity (CLI) to the called party when originating a call with the write command. The Write Command overrides the CLIR subscription (default is restricted or allowed) when temporary mode is provisioned as a default adjustment for all following outgoing calls. This adjustment can be revoked by using the opposite command. AT+CLIR Calling Line Identification Restriction Test Command AT+CLIR=? Response +CLIR: (range of supported s) Read Command AT+CLIR? OK Response +CLIR: , Write Command AT+CLIR[=] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 15 s, determined by network. The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Parameter sets the adjustment for outgoing calls. 0 Presentation indicator is used according to the subscription of the CLIR service 1 CLIR invocation 2 CLIR suppression Integer type. Parameter shows the subscriber CLIR service status in the network. 0 CLIR not provisioned 1 CLIR provisioned in permanent mode 2 Unknown (e.g. no network, etc.) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 221 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 3 CLIR temporary mode presentation restricted 4 CLIR temporary mode presentation allowed Error codes. For more details, please refer to Chapter 15.4. 11.6. AT+COLP Connected Line Identification Presentation This command refers to the GSM/UMTS supplementary service COLP (Connected Line Identification Presentation) that enables a calling subscriber to get the connected line identity (COL) of the called party after setting up a mobile originated call. The command enables or disables the presentation of the COL at the TE. It has no effect on the execution of the supplementary service COLR in the network. Intermediate result code OK is returned from TA to TE before any +CR or V.25ter responses. AT+COLP Connected Line Identification Presentation Test Command AT+COLP=? Response +COLP: (list of supported s) Read Command AT+COLP? OK Response +COLP: , Write Command AT+COLP[=] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 15 s, determined by network. The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Sets/shows the result code presentation status in the TA. 0 Disable 1 Enable Integer type. Shows the subscriber COLP service status in the network. 0 COLP not provisioned 1 COLP provisioned 2 Unknown (e.g. no network, etc.) String type. Phone number, the format is specified by . EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 222 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. Type of address octet in integer format. 128 Unknown type (Number length is 0) 129 Unknown type (IDSN format number) 145 International number type (ISDN format) String type sub-address of format specified by . Integer type. Type of sub-address octet (refer to 3GPP TS 24.008 subclause 10.5.4.8) Optional string type alphanumeric representation of corresponding to the entry found in phone book. NOTE Intermediate result code: When enabled (and called subscriber allows), an intermediate result code is returned before any +CR or V.25ter responses: +COLP: ,,[],[],[] Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK 11.7. AT+CSSN Supplementary Service Notifications This command refers to supplementary service related network initiated notifications. This Write Command enables/disables the presentation of notification result codes from TA to TE. AT+CSSN Supplementary Service Notifications Test Command AT+CSSN=? Response +CSSN: (list of supported s),(list of supported s) Read Command AT+CSSN? OK Response +CSSN: , OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 223 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Write Command AT+CSSN=[,] Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Sets/shows the +CSSI intermediate result code presentation status to the TE. 0 Disable 1 Enable Integer type. Sets/shows the +CSSU unsolicited result code presentation status to the TE. 0 Disable 1 Enable Integer type. It is manufacturer specific and supports the following codes: 0 Unconditional call forwarding is active 1 Some of the conditional call forwardings are active 2 Call has been forwarded 3 Waiting call is pending 5 Outgoing call is barred Integer type. It is manufacturer specific and supports the following codes: 0 The incoming call is a forwarded call 2 Call has been put on hold (during a voice call) 3 Call has been retrieved (during a voice call) 5 Held call was terminated by another party 10 Additional incoming call forwarded Error codes. For more details, please refer to Chapter 15.4. NOTES 1. When =1 and a supplementary service notification is received after a mobile originated call setup, the +CSSI intermediate result code is sent to TE before any other MO call setup result codes: +CSSI: 2. When =1 and a supplementary service notification is received during a mobile terminated call EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 224 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual setup or during a call, the +CSSU unsolicited result code is sent to TE: +CSSU: 11.8. AT+CUSD Unstructured Supplementary Service Data This command allows control of the Unstructured Supplementary Service Data (USSD) according to 3GPP TS 22.090. Both network and mobile initiated operations are supported. is used to disable/enable the presentation of an unsolicited result code. =2 is used to cancel an ongoing USSD session. For an USSD response from the network, or a network initiated operation, the format is: +CUSD: [,,[]]. When is given, a mobile initiated USSD string or a response USSD string to a network initiated operation is sent to the network. The response USSD string from the network is returned in a subsequent +CUSD URC. AT+CUSD Unstructured Supplementary Service Data Test Command AT+CUSD=? Response +CUSD: (range of supported s) Read Command AT+CUSD? OK Response +CUSD: Write Command AT+CUSD[=[,[, ]]] OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 120 s, determined by network. The command takes effect immediately. The configurations will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 225 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. Sets/shows the result code presentation status to the TE. 0 Disable the result code presentation to the TE 1 Enable the result code presentation to the TE 2 Cancel session (not applicable to Read Command response) Unstructured Supplementary Service Data (USSD) to be sent to the network. If this parameter is not given, network is not interrogated. Unstructured Supplementary Service Data (USSD) received from the network. Integer type. 3GPP TS 23.038 Cell Broadcast Data Coding Scheme, Default: 15. Integer type. USSD response from the network or the network initiated operation. 0 No further user action required (network initiated USSD Notify, or no further information needed after mobile initiated operation) 1 Further user action required (network initiated USSD Request, or further information needed after mobile initiated operation) 2 USSD terminated by network 3 Another local client has responded 4 Operation not supported 5 Network time out Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 226 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12 Audio Commands 12.1. AT+CLVL Loudspeaker Volume Level Selection This command selects the volume of the internal loudspeaker of the MT. AT+CLVL Loudspeaker Volume Level Selection Test Command AT+CLVL=? Response +CLVL: (range of supported s) Read Command AT+CLVL? OK Response +CLVL: Write Command AT+CLVL= OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will be saved. Parameter Integer type. Volume level with manufacturer specific range (Smallest value represents the lowest sound level). Range: 0–5. Default: 3. Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 227 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.2. AT+CMUT Mute Control This command enables/disables the uplink voice muting during a voice call. AT+CMUT Mute Control Test Command AT+CMUT=? Response +CMUT: (list of supported s) Read Command AT+CMUT? OK Response +CMUT: Write Command AT+CMUT= OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will not be saved and must be set during the call. Parameter Integer type. 0 Mute OFF 1 Mute ON Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 228 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.3. AT+QAUDLOOP Enable/Disable Audio Loop Test This command enables/disables audio loop test. AT+QAUDLOOP Enable/Disable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (list of supported s) Read Command AT+QAUDLOOP? OK Response +QAUDLOOP: Write Command AT+QAUDLOOP= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. To enable or disable audio loop test. 0 Disable audio loop test 1 Enable audio loop test Error codes. For more details, please refer to Chapter 15.4. 12.4. AT+VTS DTMF and Tone Generation This command sends ASCII characters which cause MSC to transmit DTMF tones to a remote subscriber. This command can only be operated in voice call. AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (list of supported s),(range of supported of s) OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 229 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Write Command AT+VTS=[,] Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: Depends on the length of and . / Parameter String type. ASCII characters in the set 0...9, #, *, A, B, C, D. The string should be enclosed in quotation marks ('...'). When sending multiple tones at a time, the time interval of two tones can be specified by AT+VTD. The maximal length of the string is 31. The duration of each tone in 1/10 seconds with tolerance. Range: 0–255. If the duration is less than the minimum time specified by the network, the actual duration will be the network specified time. If this parameter is omitted, is specified by AT+VTD. Error codes. For more details, please refer to Chapter 15.4. Example ATD12345678900; OK //Call connect AT+VTS='1' OK AT+VTS='1234567890A' OK //Dial. //The remote caller can hear the DTMF tone. //Send multiple tones at a time. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 230 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.5. AT+VTD Set Tone Duration This command sets the duration of DTMF tones. It can also set time interval of two tones when sending multiple tones at a time. AT+VTD Set Tone Duration Test Command AT+VTD=? Response +VTD: (range of supported s),(range of supported of s) Read Command AT+VTD? OK Response +VTD: , Write Command AT+VTD=[,] OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will not be saved. Parameter The duration tone in 1/10 seconds with tolerance. Range: 0–255. Default value: 3. If the duration is less than the minimum time specified by the network, the actual duration will be network specified time. The time interval of two tones when sending multiple tones at a time by AT+VTS. Range: 0–255. Default: 0. Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 231 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.6. AT+QAUDMOD Set Audio Mode This command sets the audio mode required for the connected device. AT+QAUDMOD Set Audio Mode Test Command AT+QAUDMOD=? Response +QAUDMOD: (range of supported s) Read command AT+QAUDMOD? OK Response +QAUDMOD: Write Command AT+QAUDMOD= OK Response OK Maximum Response Time Characteristics Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Indicates the current configured audio mode. 0 Echo canceller, noise suppressor, digital gain and calibration parameter for handset 1 Echo canceller, noise suppressor, digital gain and calibration parameter for headset 2 Echo canceller, noise suppressor, digital gain and calibration parameter for speaker 3 Turn off all audio processing functions 4 Echo canceller, noise suppressor, digital gain and calibration parameter for Bluetooth 5 Echo canceller, noise suppressor, digital gain and calibration parameter for general audio modes Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 232 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.7. AT+QDAI Digital Audio Interface Configuration This command configures the digital audio interface. ⚫ When =1, you can define the PCM formats. In the following conditions, the module can be used directly with default settings (master mode, short-synchronization, 2048 kHz clock frequency, 16-bit liner data format, 8 kHz sampling rate). ⚫ When =2, and the external codec chip linked with PCM interface is the NAU8814 model and configurable through the I2C. ⚫ When =3, and the external codec chip linked with PCM interface is the ALC5616 model and configurable through the I2C. ⚫ When =5, and the external codec chip linked with PCM interface is the TLV320AIC3104 model and configurable through the I2C. ⚫ When =6, and the external codec chip linked with PCM interface is the NAU8810 model and configurable through the I2C. AT+QDAI Digital Audio Interface Configuration Test Command AT+QDAI=? Response +QDAI: (range of supported s),(list of supported s),(list of supported s),(range of supported s),(range of supported s),(list of supported s),(list of supported s),(range of supported s) Read Command AT+QDAI? OK Response +QDAI: [,,,,,,,] Write Command AT+QDAI=[,,,[,[,[,,]]]] OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics Reference Quectel The command takes effect after module is rebooted. The configurations will be saved automatically. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 233 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. 1 Digital PCM output (customer defined) 2 Analog output (for audio codec NAU8814) 3 Analog output (for our default audio codec ALC5616) 4 Analog output (for audio codec MAX9860) 5 Analog output (for audio codec TLV320AIC3104) 6 Analog output (for audio codec NAU8810) Integer type. 0 Master mode 1 Slave mode Integer type. 0 Primary mode (short-synchronization) 1 Auxiliary mode (long-synchronization) Integer type. Clock frequency. 0 128 kHz 1 256 kHz 2 512 kHz 3 1024 kHz 4 2048 kHz 5 4096 kHz Integer type. Data format. 0 16-bit linear Integer type. Sampling rate. 0 8 kHz 1 16 kHz Integer type. Number of slot. Default: 1. Integer type. Slot mapping value. Range: 1–16. NOTES 1. 4096 kHz clock frequency is only applicable for 16 kHz sampling rate. 2. 128 kHz clock frequency is not supported. 3. 8-bit a-law and 8-bit u-law data formats are not supported. 4. Bit per frame=/. For example, if is 2048 kHz and is 8 kHz, then bit per frame is 256. Bit per frame should be greater than 16. 5. When slave mode is selected, master and synchronization clock should be provided for the module. 6. When a recommended codec is selected and 16 kHz sampling rate is desired, please input . Currently only ALC5616 supports 16 kHz (AT+QDAI=3,0,0,5,0,1,1,1). 7. Project software versions with R07 (e.g. EG91NAXGAR07A03M1G_01.003.01.003) support automatically matching codec drivers, thus you cannot configure the digital audio interface with this command. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 234 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+QDAI=? //Query the range. +QDAI: (1-6),(0,1),(0,1),(0-5),(0-2),(0,1),(1),(1-16) OK AT+QDAI? +QDAI: 3,0,0,4,0,0,1,1 //Query the current interface configuration. OK AT+QDAI=1,1,0,4,0,0,1,1 OK //Set AUX PCM interface to slave, short-synchronization, 8 kHz sample and 2048 kHz BCLK. 12.8. AT+QEEC Set Echo Cancellation Parameters This command sets echo cancellation parameters. AT+QEEC Set Echo Cancellation Parameters Test Command AT+QEEC=? Response +QEEC: (range of supported s),(range of supported s) Read Command AT+QEEC? OK Response +QEEC: , ...... +QEEC: , Write Command AT+QEEC=, Characteristics OK Response OK Or ERROR The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Indicates the parameter’s index. Range: 0–50. Integer type. Indicates the parameter’s value. Range: 0–65535. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 235 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+QEEC=? //Query the range. +QEEC: (0-50),(0-65535) OK AT+QEEC=6,1234 OK //Set the value of index 6 to 1234. 12.9. AT+QSIDET Set the Side Tone Gain in Current Mode This command sets the side tone gain value in current mode. AT+QSIDET Set the Side Tone Gain in Current Mode Test Command AT+QSIDET=? Response +QSIDET: (range of supported s) Read Command AT+QSIDET? OK Response +QSIDET: Write Command AT+QSIDET= Maximum Response Time Characteristics Reference Quectel OK Response OK Or ERROR 300 ms The configuration takes effect at next sound activity. The configuration would not be saved. Parameter Integer type. Indicates the configured side tone gain in current mode. Range: 0–65535. Default: 0. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 236 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.10. AT+QMIC Set Uplink Gains of Microphone This command sets the uplink gains of microphone. AT+QMIC Set Uplink Gains of Microphone Test Command AT+QMIC=? Response +QMIC: (range of supported s),(range of supported s) Read Command AT+QMIC? OK Response +QMIC: , Write Command AT+QMIC=[,] Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. The configurations will be saved. Parameter Integer type. Indicates uplink codec gain. Range: 0–65535. The default value might be different in different audio modes. Integer type. Indicates uplink digital gain. Range: 0–65535. The default value might be different in different audio modes. 12.11. AT+QRXGAIN Set Downlink Gains of RX This command sets RX digital gains to change the downlink volume. AT+QRXAGIN Set Downlink Gains of RX Test Command AT+QRXGAIN=? Response +QRXGAIN: (range of supported s) OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 237 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Read Command AT+QRXGAIN? Write Command AT+QRXGAIN= Maximum Response Time Characteristics Response +QRXGAIN: OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Downlink digital gains. Range: 0–65535. The default value varies depending on audio modes. Example AT+QRXGAIN=? +QRXGAIN: (0-65535) OK AT+QRXGAIN? +QRXGAIN: 20577 OK AT+QRXGAIN=8192 OK AT+QRXGAIN? +QRXGAIN: 8192 OK //Query the current configuration. //Set digital gain to 8192. //Query the current configuration. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 238 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.12. AT+QIIC Read and Write Codec via IIC This command configures the codec via IIC interface. AT+QIIC Read and Write Codec via IIC Test Command AT+QIIC=? Response +QIIC: (list of supported s),(range of supported s),(range of supported s),(list of supported s),(range of supported s) Write Command AT+QIIC=,,,[,] OK Response If =0, all configuration parameters should be specified: OK If =1, should be omitted: +QIIC: Maximum Response Time Characteristics OK 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. 0 Write command 1 Read command Hex integer type. 0-0xFF 7-bit device address Hex integer type. 0-0xFF Register address Integer type. Length of the read or write bytes. Range: 1–2. Hex integer type. 0-0xFFFF Data value Example AT+QIIC=1,0x1B,0x00,2 +QIIC: 0x0021 OK // Read register value, slave address: 0x1B, register address: 0x00, read two bytes. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 239 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+QIIC=0,0x1B,0x00,2,0x0000 OK //Write register value, slave address: 0x1B, register address: 0x00, write two bytes. 12.13. AT+QTONEDET Enable/Disable DTMF Detection This command enables or disables DTMF detection. If this function is enabled, DTMF tones sent by the other side are detected and reported on the assigned serial port. AT+ QTONEDET Enable/Disable DTMF Detection Test Command AT+QTONEDET=? Response +QTONEDET: (list of supported s) Read Command AT+QTONEDET? OK Response +QTONEDET: Write Command AT+QTONEDET= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Enable or disable DTMF detection. 0 Disable 1 Enable NOTE DTMF characters - ASCII: DTMF 0 1 2 3 ASCII 48 49 50 51 DTMF 8 9 A B ASCII 56 57 65 66 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 240 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 4 52 C 67 5 53 D 68 6 54 * 42 7 55 # 35 12.14. AT+QLDTMF Play Local DTMF This command plays a local DTMF string. The maximum length of a local DTMF string is 20 characters. It can also be used to stop playing local DTMF. AT+QLDTMF Play Local DTMF Test Command AT+QLDTMF=? Response +QLDTMF: (range of supported s),(list of supported s) Write Command AT+QLDTMF=,[,< y>] OK Response OK Or ERROR If error is related to ME functionality: +CME ERROR: Execute Command Stop playing the DTMF string AT+QLDTMF Maximum Response Time Characteristics After the DTMF string is completely played: +QLDTMF:5 Response OK 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Indicates every DTMF’s play time and mute time. Range: 1–1000. Unit: 1/100 second when =1, or 1/10 second when is not set. String type. DTMF string. Maximum length: 20 characteristics (separated by comma). DTMF format: 0-9,*, #, A-D. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 241 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. If this parameter is omitted, the unit of is 1/10 second. If this parameter is specified to 1, the unit of is 1/100 second. Error codes. For more details, please refer to Chapter 15.4. Example AT+QLDTMF=? +QLDTMF: (1-1000),(0-9,*,#,A-D) OK AT+QLDTMF=2,'A,B,1,2,#' //Play local DTMF string A,B,1,2,#, and the ON & mute time is 200 ms. OK AT+QLDTMF OK //Stop playing local DTMF. 12.15. AT+QWDTMF Play or Send DTMF Files to Far End This command plays or sends DTMF files to far end during a call. AT+QWDTMF Play or Send DTMF Files to Far End Test Command AT+QWDTMF=? Response +QWDTMF: (list of supported s),(list of supported s),(list of supported s),(range of supported s),(range of supported s) Read Command AT+QWDTMF? OK Response +QWDTMF: Write Command AT+QWDTMF=,,,, OK Response OK After the DTMF playing is completed: +QWDTMF: 6 Or ERROR Maximum Response Time 300 ms Characteristics / EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 242 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. Whether to mute uplink DTMF or not. 0 Mute 1 Not mute Integer type. Whether to mute downlink DTMF or not. 0 Mute 1 Not mute String type. DTMF string. Maximum length: 16 characters (separated by comma). DTMF format: 0–9,*,#,A–D,E(1400 Hz),F(2300 Hz),G(1000 Hz). Integer type. DTMF play time in milliseconds. Range: 55–1000. Integer type. Status of the DTMF player. 0 Idle 1 Busy Integer type. Interval of playing DTMF. Range: 55–1000. Example AT+QWDTMF=? +QWDTMF: (0,1),(0,1),(0-9,*,#,A-G),(1-1000) OK AT+QWDTMF=1,1,'A,B,1,2,#',100 //Play DTMF string A,B,1,2,# and send it to far end during a call. OK +QWDTMF: 6 AT+QWDTMF? +QWDTMF: 0 //DTMF playing is completed. //Query DTMF player status. OK 12.16. AT+QLTONE Play a Local Customized Tone This command plays a local customized tone. indicates play time, indicates mute time, and indicates total time. AT+QLTONE Play a Local Customized Tone Test Command AT+QLTONE=? Response +QLTONE: (list of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 243 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Write Command AT+QLTONE=[,, ,,] OK Response OK Or ERROR If error is related to ME functionality: +CME ERROR: After the tone is completely played: +QLTONE: 0 Execution Command Stop playing the local customized tone. AT+QLTONE Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configurations will not be saved. Parameter Integer type. 0 Stop playing 1 Start playing Integer type. Tone’s frequency. Range: 100–4000. Unit: Hz. Integer type. Tone’s play time. Range: 0–1000. Unit: ms. Integer type. Tone’s mute time. Range: 0–1000. Unit: ms. Integer type. Tone’s total time. Range: 0–15300000. Unit: ms. Error codes. For more details, please refer to Chapter 15.4. Example AT+QLTONE=? +QLTONE: (0,1),(100-4000),(0-1000),(0-1000),(0-15300000) OK AT+QLTONE=1,1000,200,300,3000 OK //Play a 1000 Hz tone, play time is 200 ms and mute time is 300 ms. Total time is 3000 ms. +QLTONE: 0 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 244 / 316 AT+QLTONE=0 OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //Stop playing. 12.17. AT+QAUDRD Record Media File This command records the uplink or downlink speech during a voice call or sound from local microphone in idle state and saves it to files. AT+QAUDRD Record Media File Test Command AT+QAUDRD=? Response +QAUDRD: (list of supported of s),'filename',(list of supported ),(list of supported s) Read Command AT+QAUDRD? OK Response +QAUDRD: Write Command AT+QAUDRD=[, [,[,]]] OK Response OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. 0 Module is not recording media file 1 Module is recording media file Integer type. 0 Stop recording 1 Start recording String type. Name of the recorded media file. Integer type. Format of the file. 3 FORMAT_AMR EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 245 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 13 WAV_PCM16 Integer type. Record the uplink or downlink sound. 0 Record uplink sound 1 Record downlink sound Error codes. For more details, please refer to Chapter 15.4. NOTES 1. is the path used to save the recording file, and the default path is /data/ufs directory. 2. EC2x, EG9x, EG2x-G and EM05 series modules support playing media file in wav or amr format with 8 kHz and 16 kHz sampling frequency, mono, and 16-bit quantization. 3. If the recording file’s name and format are same with that of an existing file or an unknown error occurs, the module reports +QAUDRIND: 0,1. 4. If the current recording is interrupted by other audio task, the module reports +QAUDRIND: 0,6. 5. If there is no space to record, the module reports +QAUDRIND: 0,3. 6. The module supports recording uplink and downlink audio data, but not simultaneous recording. 7. This command returns an error if the file format is inconsistent with the file extension. Table 8: The Description of in URC +QAUDRIND: 0, 0 1 3 6 Meaning Reserved Unknown error No space to record Interrupted by other audio task Example AT+QAUDRD=1,'A.wav',13,0 OK AT+QAUDRD=0 OK AT+QAUDRD=1,'B.wav',13,1 OK AT+QAUDRD=0 OK //Record the uplink sound in wav format, and store it in UFS. //Stop the recording. //Record the downlink sound in wav format, and store it in UFS. //Stop the recording. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 246 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.18. AT+QPSND Play WAV File This command plays local wave file. AT+QPSND Play WAV File Test Command AT+QPSND=? Response +QPSND: (list of supported s),'filename',(list of supported s),(list of supported s),(list of supported s) Read Command AT+QPSND? OK Response +QPSND: Write Command AT+QPSND=,,[,[,]] OK Response OK Or ERROR If error is related to ME functionality: +CME ERROR: Maximum Response Time Characteristics After the playing is finished: +QPSND: 0 300 ms / Parameter Integer type. 0 Module is not playing local Audio file 1 Module is playing local Audio file Integer type. 0 Stop playing local Audio file 1 Start playing local Audio file String type. Name of the file to be played. Integer type. Repeat playing or not. 0 Play only once 1 Repeat playing EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 247 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. Mute uplink or not. 0 Mute 1 Not mute Integer type. Mute downlink or not. 0 Mute 1 Not mute Error codes. For more details, please refer to Chapter 15.4. NOTES 1. includes file path, file name and file suffix. The default playing path is /data/ufs. 2. EC2x, EG9x, EG2x-G and EM05 series modules support playing media file in wav, amr or mp3 format with 8 kHz and 16 kHz sampling frequency, mono, and 16-bit quantization. Example AT+QPSND=1,'A.wav',0 OK +QPSND: 0 AT+QPSND=1,'A.wav',0,1,1 OK +QPSND: 0 //Play a wave file stored in UFS. //Play a wave file to far end when a call is ongoing. 12.19. AT+QTTS Play Text This command plays text. AT+QTTS Play Text Test Command AT+QTTS=? Read Command AT+QTTS? Write Command AT+QTTS=[,] Response +QTTS: (range of supported s), OK Response +QTTS: OK Response OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 248 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Or ERROR If error is related to ME functionality: +CME ERROR: After the playing is finished: +QTTS: 0 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Start/stop playing, and specify format. 0 Stop playing, and can be omitted. 1 Start playing, and is UCS2 encoding. 2 Start playing, and is character(s): ASCII normally, GBK encoding in Chinese. String type. Text to be played. The text format varies depending on . Maximum length: 548 bytes. Integer type. The status of the TTS player. 0 Idle 1 Busy Error codes. For more details, please refer to Chapter 15.4. NOTES 1. The module supports playing TTS with AT+QTTS or AT+QWTTS during a non-call process. 2. The TTS is terminated when calling. 3. The module supports playing TTS and audio, but not simultaneously. Example AT+QTTS=? +QTTS: (0-2), OK AT+QTTS=1,'6B228FCE4F7F752879FB8FDC6A215757'//Play a UCS2 string. OK +QTTS: 0 AT+QTTS=2,'hello world,你好' //Play a ASCII string. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 249 / 316 OK +QTTS: 0 AT+QTTS=0 OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //Stop playing. 12.20. AT+QTTSETUP Set TTS This command sets the TTS speed and adjusts the volume. AT+QTTSETUP Set TTS Test Command AT+QTTSETUP=? Response +QTTSETUP: (list of supported s),(list of supported s),(range of supported s) Read Command AT+QTTSETUP? Write Command AT+QTTSETUP=,[,] OK Response OK Response OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. 1 Write the value of parameters 2 Read the value of parameters Integer type. 1 Set/read the speed 2 Set/read the volume Integer type. Speed or volume value. If =2, please omit the value in the Write Command. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 250 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual TTS speed. Range: -32768–32767. Default: 0. TTS volume. Range: -32768–32767. Default: 0. Error codes. For more details, please refer to Chapter 15.4. Example AT+QTTSETUP=? +QTTSETUP: (1,2),(1,2),(-32768~32767) OK AT+QTTSETUP=1,2,0 OK //Set the volume to 0. 12.21. AT+QWTTS Play Text or Send Text To Far End This command plays text or sends text to far end when telephoning. AT+QWTTS Play Text Or Send Text To Far End Test Command AT+QWTTS=? Response +QWTTS: (list of supported s),(list of supported s),(range of supported s), Read Command AT+QWTTS? OK Response +QWTTS: Write Command AT+QWTTS=,,, OK Response OK Or ERROR If error is related to ME functionality: +CME ERROR: Maximum Response Time Characteristics After the playing is completed: +QWTTS: 0 300 ms The command takes effect immediately. The configurations will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 251 / 316 Example LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Integer type. Whether to mute uplink volume or not. 0 Mute 1 Not mute Integer type. Whether to mute downlink volume or not. 0 Mute 1 Not mute Integer type. Start/stop playing, and specify format. 0 Stop playing, and can be omitted 1 Start playing, and is UCS2 encoding 2 Start playing, and is character(s), ASCII normally, GBK encoding in Chinese String type. Text to be played. The text format varies with . Maximum length: 543 bytes. Integer type. Status of the TTS player. 0 Idle 1 Busy Error codes. For more details, please refer to Chapter 15.4. NOTES 1. Reporting +QWTTS: 4111 means that TTS is interrupted by a call event. 2. In the non-call state, playing TTS reports +CME ERROR: 903. 3. In the call state, after muting the uplink and downlink volume, playing TTS reports +CME ERROR: 903. 4. If and are set to invalid values, the module reports +CME ERROR: 902. 5. The module supports playing txt characters, and the maximum length is 543 bytes. 6. When playing empty characters, the module reports +CME ERROR: 902. Example AT+QWTTS=? +QWTTS:(0,1),(0,1),(0-2), OK AT+QWTTS=1,1,1,'6B228FCE4F7F752879FB8FDC6A215757' OK //Play an UCS2 string and send it to far end during a call. +QWTTS: 0 AT+QWTTS=1,0,2,'hello world,你好' OK //The playing is completed. //Play an ASCII string to far end during a call. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 252 / 316 +QWTTS: 0 AT+QWTTS=1,0,0 OK LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual //The playing is completed. //Stop playing. 12.22. AT+QAUDCFG Query and Configure Audio Tuning Process This command queries and configures various audio tunning process. AT+QAUDCFG Query and Configure Audio Tuning Process Test Command AT+QAUDCFG=? Response +QAUDCFG: 'alc5616/dlgain',(range of supporteds) +QAUDCFG: 'alc5616/ulgain',(range of supporteds) +QAUDCFG: 'tonevolume',(range of supported s) +QAUDCFG: 'alc5616/pwrctr',(list of supporteds) +QAUDCFG: 'nau8814/dlgain',(list of supporteds) +QAUDCFG: 'nau8814/aoutput',(list of supporteds) +QAUDCFG: 'encgain',(list of supporteds),(range of supporteds) +QAUDCFG: 'voltedtmfcfg',(range of supporteds),(range of supporteds) +QAUDCFG: 'decgain',(range of supporteds) +QAUDCFG: 'fns',(list of supported s),(list of supported s) +QAUDCFG: 'nau8810/config',(range of supported s),(range of supported s),... Maximum Response Time OK 300 ms 12.22.1. AT+QAUDCFG='alc5616/dlgain' Set the Downlink Gain Level for Codec ALC5616 This command sets or queries the downlink gain level for codec ALC5616. AT+QAUDCFG='alc5616/dlgain' Set the Downlink Gain Level for Codec ALC5616 Write Command AT+QAUDCFG='alc5616/dlgain' [,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'alc5616/dlgain', EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 253 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics OK If the optional parameter is specified, set the downlink gain level: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Downlink gain of ALC5616. Range: 0–100. Default: 79. Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDCFG='alc5616/dlgain',85 OK AT+QAUDCFG='alc5616/dlgain' +QCFG: 'alc5616/dlgain', 85 OK //Set downlink gain to 85. //Query the current downlink gain. 12.22.2. AT+QAUDCFG='alc5616/ulgain' Set the Uplink Gain Level for Codec ALC5616 This command sets or queries uplink gain level for codec ALC5616. AT+QAUDCFG='alc5616/ulgain' Set the Uplink Gain Level for Codec ALC5616 Write Command AT+QAUDCFG='alc5616/ulgain'[, ] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'alc5616/ulgain', OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 254 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics If the optional parameter is specified, set the uplink gain level: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Uplink gain of ALC5616. Range: 0–100. Default: 73. Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDCFG='alc5616/ulgain',85 OK AT+QAUDCFG='alc5616/ulgain' +QCFG: 'alc5616/ulgain', 85 OK //Set uplink gain to 85. //Query the current uplink gain. 12.22.3. AT+QAUDCFG='tonevolume' Set the Tone Volume This command sets or queries the tone volume. AT+QAUDCFG='tonevolume' Set the Tone Volume Write Command AT+QAUDCFG='tonevolume'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'tonevolume', OK If the optional parameter is specified, set the tone volume: OK or ERROR EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 255 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effects immediately. The configuration will be saved automatically. Parameter Integer type. Tone volume value. Range: 0–100. Default: 10. Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDCFG='tonevolume',10 OK AT+QAUDCFG='tonevolume' +QCFG: 'tonevolume',10 OK //Set the tone of volume to 10. //Query the current volume. 12.22.4. AT+QAUDCFG='alc5616/pwrctr' Enable/Disable the Power Reset This command enables or disables the power reset when the codec power is reset to the MX-66h register. AT+QAUDCFG='alc5616/pwrctr' Enable/Disable the Power Reset Write Command AT+QAUDCFG='alc5616/pwrctr'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'alc5616/pwrctr', OK If the optional parameter is specified, enable/disable the power reset OK Or ERROR Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300 ms EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 256 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Characteristics The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Enable/disable the power reset when the codec power is reset to the MX-66h register. 0 Disable 1 Enable Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDCFG=? +QAUDCFG: 'alc5616/pwrctr',(0-1) OK AT+QAUDCFG='alc5616/pwrctr',1 OK AT+QAUDCFG='alc5616/pwrctr' +QCFG: 'alc5616/pwrctr', 1 OK //Enable the power reset. //Query the current configuration. 12.22.5. AT+QAUDCFG='nau8814/dlgain' Set the Downlink Gain Level for Codec NAU8814 This command sets or queries the downlink gain level for codec NAU8814. AT+QAUDCFG='nau8814/dlgain' Set the Downlink Gain Level for Codec NAU8814 Write Command AT+QAUDCFG='nau8814/dlgain'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'nau8814/dlgain', OK If the optional parameter is specified, set the downlink gain level: OK Or ERROR EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 257 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Downlink gain of NAU8814. Range: 0–100. Default: 79. Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDCFG='nau8814/dlgain',85 OK AT+QAUDCFG='nau8814/dlgain' +QCFG: 'nau8814/dlgain',85 OK //Set downlink gain to 85. //Query the current downlink gain. 12.22.6. AT+QAUDCFG='nau8814/aoutput' Set the Analog Output for Codec NAU8814 This command sets or queries the analog output for codec NAU8814. AT+QAUDCFG='nau8814/aoutput' Set the Analog Output for Codec NAU8814 Write Command AT+QAUDCFG='nau8814/aoutput'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'nau8814/output ', OK If the optional parameter is specified, set the analog output for codec NAU8814: OK Or ERROR If there is any error related to ME functionality: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 258 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics +CME ERROR: 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Output mode. 0 Speaker mixer output 1 Mono mixer output Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDCFG='nau8814/aoutput',1 OK AT+QAUDCFG='nau8814/aoutput' +QCFG: 'nau8814/analog/output',0 OK //Set mono mixer output. //Query the current output configuration. 12.22.7. AT+QAUDCFG='encgain' Set Uplink ENC Gains This command sets or queries the uplink ENC gains. AT+QAUDCFG='encgain' Set Uplink ENC Gains Write Command AT+QAUDCFG='encgain'[,,] Response If the optional parameters are omitted, return the current configuration: +QCFG: 'encgain',, OK If the optional parameters are specified, set the uplink ENC gains: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 259 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Enable/disable ENC. 0 Disable 1 Enable Integer type. ENC gains. Range: 0–65535. Default: 8192. Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDCFG='encgain',1,65535 OK AT+QAUDCFG='encgain' +QCFG: 'encgain',1,65535 OK //Enable ENC and set the ENC gain to 65535. //Query the current uplink gain. 12.22.8. AT+QAUDCFG='voltedtmfcfg' Set Duration and Volume of VoLTE DTMF Tone This command sets or queries the duration and the volume of VoLTE DTMF tone received by the module. If this command has never been set or the duration is set to 0, the duration of VoLTE DTMF tone is controlled by network, and the volume is performed as the default one 200 x 2.5 ms. In this way, the duration set by network cannot be longer than the default 500 ms, otherwise, the module cuts it off to 500 ms. AT+QAUDCFG='voltedtmfcfg' Set Duration and Volume of VoLTE DTMF Tone Write Command AT+QAUDCFG='voltedtmfcfg'[,[,]] Response If the optional parameters are omitted, return the current configuration: +QCFG: 'voltedtmfcfg',, OK If the optional parameters are specified, set the duration and volume of VoLTE DTMF tone: OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 260 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Duration of DTMF tone. Unit: 2.5 ms. Range: 1–1000. Default: 200. Integer type. Volume of DTMF tone. Range: 0–65535. Default: 5000. Error codes. For more details, please refer to Chapter 15.4. NOTES The time interval between two tones of VoLTE DTMF is a little bit longer than the duration. Example AT+QAUDCFG='voltedtmfcfg',40,5000 OK AT+QAUDCFG='voltedtmfcfg' +QCFG: 'voltedtmfcfg',40,5000 OK //Set the VolTE DTMF duration to 100 ms, set the volume to 5000. //Query the current configuration. 12.22.9. AT+QAUDCFG='decgain' Set Downlink DEC Gains This command sets or queries the downlink DEC gains. AT+QAUDCFG='decgain' Set Downlink DEC Gains Write Command AT+ QAUDCFG='decgain'[,] Response If the optional parameter is omitted, query the current configuration: +QCFG: 'decgain', OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 261 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics If the optional parameter is specified, set the downlink DEC gains: OK Or ERROR If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Downllink DEC gains. Range: 0–65535. The default value varies with the configuration of ACDB. Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDCFG='decgain',65535 OK AT+QAUDCFG='decgain' +QAUDCFG: 'decgain', 65535 OK //Set the downlink DEC gain to 65535. //Query the current downlink DEC gain. 12.22.10. AT+QAUDCFG='fns' Enable/Disable Noise Suppression This command enables/disables the feature of noise suppression and queries the current configuration. AT+QAUDCFG='fns' Enable/Disable Noise Suppression Write Command AT+QAUDCFG='fns'[,,] Response If the optional parameters are omitted, query the current configuration: +QCFG: 'fns',, OK If the optional parameters are specified, enables/disables the feature of noise suppression: OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 262 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics Or ERROR 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Configure the feature of noise suppression. Always be 0. Integer type. Enable or disble the feature of noise suppression. 0 Disable 1 Enable 12.22.11. AT+QAUDCFG='nau8810/config' Set Register Value of Codec NAU8810 This command sets and queries register value of codec NAU8810. AT+QAUDCFG='nau8810/config' Set Register Value of Codec NAU8810 Write Command AT+QAUDCFG='nau8810/config'[,< addr>,[,,[,…]] ] Response If the optional parameters are omitted, query the current configuration: +QCFG: 'nau8810/config',,[,,[,..]] OK Maximum Response Time Characteristics If the optional parameters are specified, set the register value: OK Or ERROR 300 ms The command takes effects immediately. The configuration will be saved automatically. Parameter Integer type. Address of NAU8810 register. Range: 0–255. Integer type. Value of NAU8810 register. Range: 0–255. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 263 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 12.23. AT+QAUDPLAY Play Media File This command plays local media file. AT+QAUDPLAY Play Media File Test Command AT+QAUDPLAY=? Response +QAUDPLAY: 'filename',(list of supported s) Read Command AT+QAUDPLAY? OK Response +QAUDPLAY: Write Command AT+QAUDPLAY=, OK Response OK Or ERROR If error is related to ME functionality: +CME ERROR: Maximum Response Time Characteristics After the playing is finished: +QAUDPLAY: 0 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. 0 Module is not playing media file 1 Module is playing media file String type. Name of the file to play, includes file path, file name and file suffix. File path must be UFS. Integer type. Whether to paly the file repeatedly. 0 Play only once 1 Repeat Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 264 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual NOTES 1. If there is an unknown error occurrs, the module reports +QAUDPIND: 0,1. 2. If current playing is interrupted by other audio tasks, the module reports +QAUDPIND: 0,6. 3. EC2x, EG9x, EG2x-G and EM05 series modules support playing media file in wav, amr or mp3 format with 8 kHz and 16 kHz sampling frequency, mono, and 16-bit quantization. 12.24. AT+QAUDPLAYGAIN Set Audio Playing Gain This command sets audio play gain to change audio playing volume. AT+QAUDPLAYGAIN Set Audio Playing Gain Test Command AT+QAUDPLAYGAIN=? Response +QAUDPLAYGAIN: (range of supported s) Read Command AT+QAUDPLAYGAIN? OK Response +QAUDPLAYGAIN: OK Write Command AT+QAUDPLAYGAIN= Response OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effects immediately. The configuration will not be saved. Parameter Integer type. Audio playing gain. Range: 0–65535. The default value varies depending on audio modes. Error codes. For more details, please refer to Chapter 15.4. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 265 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Example AT+QAUDPLAYGAIN=? +QAUDPLAYGAIN: (0-65535) OK AT+QAUDPLAYGAIN? +QAUDPLAYGAIN: 8192 //Query the current configuration. OK AT+QAUDPLAYGAIN=4096 OK AT+QAUDPLAYGAIN? +QAUDPLAYGAIN: 4096 //Set audio playing gain to 4096. //Query the current configuration. OK 12.25. AT+QAUDRDGAIN Set Audio Recording Gain This command sets audio recording gain to change audio recording volume. AT+QAUDRDGAIN Set Audio Recording Gain Test Command AT+QAUDRDGAIN=? Response +QAUDRDGAIN: (range of supported s) Read Command AT+QAUDRDGAIN? OK Response +QAUDRDGAIN: Write Command AT+QAUDRDGAIN= OK Response OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effects immediately. The configuration will not be saved. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 266 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. Audio recording gain. Range: 0–65535. The default value varies with audio modes. Error codes. For more details, please refer to Chapter 15.4. Example AT+QAUDRDGAIN=? +QAUDRDGAIN: (0-65535) OK AT+QAUDRDGAIN? +QAUDRDGAIN: 8192 OK AT+QAUDRDGAIN=4096 OK AT+QAUDRDGAIN? +QAUDRDGAIN: 4096 OK //Query the current configuration. //Set audio record gain to 4096. //Query the current configuration. 12.26. AT+QACDBLOAD Write ACDB File This command writes audio DSP parameter configuration file (ACDB file) to module, and automatically saves one copy on modem side and AP side respectively. After a new ACDB file is imported, the value of is increased by 1. AT+QACDBLOAD Write ACDB File Test Command AT+QACDBLOAD=? Response +QACDBLOAD: 'filename', Write Command AT+QACDBLOAD=, OK Response CONNECT OK +QACDBLOAD: Or EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 267 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Read Command AT+QACDBLOAD? Maximum Response Time Characteristics ERROR Response +QACDBLOAD: 'modem','filename',,, +QACDBLOAD: 'ap','filename',, OK 300 ms The command takes effect after the module is rebooted. The configurations will be saved automatically. Parameter String type. Name of the ACDB file. Integer type. Size of the ACDB file. Integer type. Length of the ACDB file actually written. Integer type. Version of the ACDB file. Example AT+QACDBLOAD='11.acdb',100 CONNECT OK +QACDBLOAD: 100 AT+QACDBLOAD? +QACDBLOAD: 'modem','11.acdb',100,1 +QACDBLOAD: 'AP','11.acdb',100,1 OK 12.27. AT+QACDBREAD Read ACDB File This command reads the audio DSP parameter configuration file (ACDB file) stored in modem side or AP side. AT+QACDBREAD Read ACDB File Test Command AT+QACDBREAD=? Response +QACDBREAD: 'filename',(list of supported s) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 268 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Write Command AT+QACDBREAD='filename', OK Response CONNECT OK Maximum Response Time Characteristics +QACDBREAD: Or ERROR 300 ms / Parameter String type. Name of the ACDB file. Integer type. Length of the ACDB file actually read. Integer type. Position of the ACDB file. 0 Modem side 1 AP side Example AT+QACDBREAD='11.acdb',0 CONNECT OK +QACDBREAD: 100 12.28. AT+QACDBDEL Delete ACDB File This command deletes the audio DSP parameter configuration file (ACDB file) stored in modem side or AP side. AT+QACDBDEL Delete ACDB File Test Command AT+QACDBDEL=? Response +QACDBDEL: 'filename',(list of supported s) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 269 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Write Command AT+QACDBDEL='filename', Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms / Parameter String type. Name of the ACDB file. Integer type. Position of the ACDB file. 0 Modem side 1 AP side Example AT+QACDBDEL='11.acdb',1 OK AT+QACDBLOAD? +QACDBLOAD: 'modem','11.acdb',100,1 OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 270 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 13 Hardware Related Commands 13.1. AT+QPOWD Power off This command shuts down the module. The UE returns OK immediately when the command is executed. Then the UE deactivates the network. After it is completed, the UE outputs POWERED DOWN and enters into the shutdown state. The maximum time for unregistering network is 60 seconds. The UE is not allowed to turn off the power before the module’s STATUS pin is set low or the URC POWERED DOWN is outputted to avoid data loss. AT+QPOWD Power off Test Command AT+QPOWD=? Response +QPOWD: (list of supported s) Execution Command AT+QPOWD[=] OK Response OK Maximum Response Time Characteristics POWERED DOWN 300 ms / Parameter Integer type. Power down the module. 0 Immediately power down 1 Normal power down 13.2. AT+CCLK Clock This command sets and queries the real time clock (RTC) of the module. The current setting is retained until the module is totally disconnected from power. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 271 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CCLK Clock Test Command AT+CCLK=? Read Command AT+CCLK? Write Command AT+CCLK= Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response OK Response +CCLK: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter String type. The format is 'yy/MM/dd,hh:mm:ss±zz', indicating year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range: -48 to +56). E.g. May 6th, 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. Error codes. For more details, please refer to Chapter 15.4. Example AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //Query the local time. 13.3. AT+CBC Battery Charge This command returns battery charge status and battery charge level of the MT. AT+CBC Battery Charge Test Command Response EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 272 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CBC=? Execution Command AT+CBC Maximum Response Time Characteristics Reference 3GPP TS 27.007 +CBC: (range of supported s),(range of supported s), OK Response +CBC: ,, OK If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. Battery charge status. 0 ME is not charging 1 ME is charging 2 Charging has been finished Integer type. Battery charge level. 0–100 Battery has 0–100 percent of capacity remaining vent Battery voltage (Mv). Error codes. For more details, please refer to Chapter 15.4. 13.4. AT+QADC Read ADC Value This command reads the voltage value of ADC channel. AT+QADC Read ADC Value Test Command AT+QADC=? Response +QADC: (list of supported s) Read Command AT+QADC= OK Response +QADC: , OK EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 273 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Maximum Response Time Characteristics 300 ms / Parameter Integer type. Channel number of the ADC. 0 ADC Channel 0 1 ADC Channel 1 Integer type. Whether the ADC value is read successfully. 0 Fail 1 Success The voltage of specified ADC channel. Unit: mV. 13.5. AT+QSCLK Enable/Disable Low Power Mode This command enables or disables low power mode. When low power mode is enabled, and both DTR and WAKEUP_IN are pulled up, the module directly enters into sleep mode. If low power mode is enabled, but both DTR and WAKEUP_IN are pulled down, only after the DTR and the WAKEUP_IN are pulled up, can the module enter into low power mode. AT+QSCLK Enable/Disable Low Power Mode Test Command AT+QSCLK=? Response +QSCLK: (list of supported s) Read Command AT+QSCLK? OK Response +QSCLK: Write Command AT+QSCLK= Maximum Response Time Characteristics Reference Quectel OK Response OK 300 ms The command takes effect immediately The configuration will not be saved EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 274 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Parameter Integer type. Disable or enable low power mode. 0 Disable 1 Enable. It is controlled by DTR pin and WAKEUP_IN pin. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 275 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 14 Other Related Commands 14.1. GNSS Related AT Commands Please refer to Quectel_EC2x&EG9x&EG2x-G&EM05_Series_GNSS_Application_Note for details of GNSS function. Table 9: GNSS Related AT Commands Commands AT+QGPSCFG AT+QGPSDEL AT+QGPS AT+QGPSEND AT+QGPSLOC AT+QGPSGNMEA AT+QGPSXTRA AT+QGPSXTRATIME AT+QGPSXTRADATA Description GNSS configurations Deletes assistance data Turns on GNSS Turns off GNSS Acquires positioning information Acquires NMEA sentences Enables gpsOneXTRA assistance function Injects gpsOneXTRA time Injects gpsOneXTRA data file EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 276 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 14.2. DFOTA Related AT Command See Quectel_EC2x&EG9x&EM05_DFOTA_User_Guide for details of DFOTA function. Table 10: DFOTA Related AT Command Command AT+QFOTADL Description Upgrades firmware via DFOTA 14.3. FTP(S) Related AT Commands See Quectel_EC2x&EG9x&EG2x-G&EM05_Series_FTP(S)_Application_Note for details of FTP(S) function. Table 11: FTP(S) Related AT Commands Commands AT+QFTPCFG AT+QFTPOPEN AT+QFTPCWD AT+QFTPPWD AT+QFTPPUT AT+QFTPGET AT+QFTPSIZE AT+QFTPDEL AT+QFTPMKDIR AT+QFTPRMDIR AT+QFTPLIST AT+QFTPNLIST Description Configures parameters for FTP(S) server Logins to FTP(S) server Configures the current directory on FTP(S) server Gets the current directory on FTP(S) server Uploads a file to FTP(S) server Downloads a file from FTP(S) server Gets the file size on FTP(S) server Deletes a file on FTP(S) server Creates a folder on FTP(S) server Deletes a folder on FTP(S) server Lists content of a directory on FTP(S) server Lists file names of a directory on FTP(S) server EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 277 / 316 AT+QFTPMLSD AT+QFTPMDTM AT+QFTPRENAME AT+QFTPLEN AT+QFTPSTAT AT+QFTPCLOSE LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Lists standardized file and directory information Gets the file modification time on FTP(S) server Renames a file or folder on FTP(S) server Gets the length of transferred data Gets the status of FTP(S) server Logs out from FTP(S) server 14.4. HTTP(S) Related AT Commands Please refer to Quectel_LTE_Standard_HTTP(S)_Application_Note for details of HTTP(S) function. Table 12: HTTP(S) Related AT Commands Commands AT+QHTTPCFG AT+QHTTPURL AT+QHTTPGET AT+QHTTPGETEX AT+QHTTPPOST AT+QHTTPPOSTFILE AT+QHTTPREAD AT+QHTTPREADFILE AT+QHTTPSTOP Description Configures parameters for HTTP(S) server Sets URL of HTTP(S) server Sends GET request to HTTP(S) server Sends range GET request to HTTP(S) server Sends POST request to HTTP(S) server via UART/USB Sends POST request to HTTP(S) server via file Reads response from HTTP(S) server via UART/USB Reads response from HTTP(S) server via file Cancels HTTP(S) request EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 278 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 14.5. MMS Related AT Commands Please refer to Quectel_LTE_Standard_MMS_Application_Note for details of MMS function. Table 13: MMS Related Commands Commands AT+QMMSCFG AT+QMMSEDIT AT+QMMSEND Description Configures parameters of MMS Edits MMS messages Sends MMS messages 14.6. SMTP Related AT Commands Please refer to Quectel_EC2x&EG2x-G&EG9x&EM05_SMTP_Application_Note for details of SMTP function. Table 14: SMTP Related AT Commands Commands AT+QSMTPCFG AT+QSMTPDST AT+QSMTPSUB AT+QSMTPBODY AT+QSMTPATT AT+QSMTPCLR AT+QSMTPPUT Description Configures parameters for SMTP server Adds or deletes recipients Edits the subject of an Email Edits the body of an Email Adds or deletes attachments for an Email Clears the content of an Email Sends an Email EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 279 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 14.7. TCP(IP) Related AT Commands Please refer to Quectel_LTE_Standard_TCP(IP)_Application_Note for details of TCP(IP) function. Table 15: TCP(IP) Related AT Commands Commands AT+QICSGP AT+QIACT AT+QIDEACT AT+QIOPEN AT+QICLOSE AT+QISTATE AT+QISEND AT+QIRD AT+QISENDEX AT+QISWTMD AT+QPING AT+QNTP AT+QIDNSCFG AT+QIDNSGIP AT+QICFG AT+QISDE AT+QIGETERROR Description Configures parameters of a TCP/IP context Activates a PDP context Deactivates a PDP context Opens a socket service Closes a socket service Querys socket service status Sends data Retrieves the received TCP/IP data Sends hex string Switchs data access modes Pings a remote server Synchronizes local time with NTP server Configures address of DNS server Gets IP address by domain name Configures optional parameters Controls whether to echo the data for AT+QISEND Queries the last error code EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 280 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 14.8. SSL Related AT Commands Please refer to EC2x&EG9x&EG2x-G&EM05_SSL_Application_Note for details of SSL function. Table 16: SSL Related AT Commands Commands AT+QSSLCFG AT+QSSLOPEN AT+QSSLSEND AT+QSSLRECV AT+QSSLCLOSE AT+QSSLSTATE Description Configures Parameters of an SSL Context Opens an SSL Socket to Connect a Remote Server Sends Data via SSL Connection Receives Data via SSL Connection Closes an SSL Connection Queries the State of SSL Connection EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 281 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 15 Appendix References Table 17: Related Documents SN Document Name Description [1] V.25ter Serial asynchronous automatic dialing and control [2] 3GPP TS 27.007 Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; AT command set for User Equipment (UE) Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System [3] 3GPP TS 27.005 (UMTS); LTE; Use of Data Terminal Equipment – Data Circuit terminating Equipment (DTE-DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Quectel_EC2x&EG9x&EM05_DFOTA_ DFOTA user guide applicable for [4] User_Guide EC2x&EG9x&EM05 series modules Quectel_EC2x&EG9x&EG2x-G&EM05_ FTP(S) application note applicable for [5] Series_FTP(S)_Application_Note EC2x&EG9x&EG2x-G&EM05 series modules Quectel_LTE_Standard_HTTP(S)_ [6] Application_Note HTTP(S) application note applicable for EC2x&EG9x&EG2x-G&EM05 series modules Quectel_LTE_Standard_MMS_ [7] Application_Note MMS application note applicable for EC2x&EG9x&EG2x-G&EM05 series modules Quectel_EC2x&EG9x&EG2x-G&EM05_ SMTP(S) application note applicable for [8] Series_SMTP_Application_Note EC2x&EG9x&EG2x-G&EM05 series modules Quectel_LTE_Standard_TCP(IP)_ [9] Application_Note TCP/IP application note applicable for EC2x&EG9x&EG2x-G&EM05 series modules Quectel_EC2x&EG9x&EG2x-G&EM05_ GNSS application note applicable for [10] Series_GNSS_Application_Note EC2x&EG9x&EG2x-G&EM05 series modules Quectel_EC2x&EG9x&EG2x-G&EM05_ SSL application note applicable for [11] Series_SSL_Application_Note EC2x&EG9x&EG2x-G&EM05 series modules Quectel_LTE_Standard_QCFG_AT_ [12] Commands_Manual AT+QCFG commands manual applicable for EC2x&EG9x&EG2x-G&EM05 series modules EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 282 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Table 18: Terms and Abbreviations Abbreviation 3GPP ACDB ACK ACL ADC AMR APN ARFCN ASCII BCD CBM CCH CDMA EFS CFU CLI CLIP CLIR COL COLP COLR CPT CS Description 3rd Generation Partnership Project Audio Calibration Database Acknowledge Character Access Control List Analog-to-Digital Converter Adaptive Multi-Rate Access Point Name Absolute Radio-Frequency Channel Number American Standard Code for Information Interchange Binary-Coded Decimal Cell Broadcast Message Control Channel Code Division Multiple Access Embedded File System Call Forwarding Unconditional Calling Line Identity Calling Line Identification Presentation Calling Line Identification Restriction Connected Line Connected Line Identification Presentation Connected Line Identification Restriction Communication Production Technology Circuit Switching EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 283 / 316 CSD DCD DCD DCE DCH DCS DEC DFOTA DNS DPCH DRX DTE DTMF DTR ECC ECT EFS EGPRS EMM ENC EONS EPS ESM E-UTRAN EVDO LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Circuit Switch Data Dynamic Content Delivery Data Carrier Detection Data Circuit-terminating Equipment Data Channel Data Coding Scheme Decode Delta Firmware Over-The-Air Domain Name Server Dedicated Physical Channel Discontinuous Reception Data Terminal Equipment Dual Tone Multi Frequency Data Terminal Ready Emergency Call Explicit Call Transfer supplementary service Embedded File System Enhanced General Packet Radio Service EPS Mobility Management Encode Enhanced Operator Name String Evolved Packet System EPS Session Management Evolved UMTS Terrestrial Radio Access Network Evolution, Data Only EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 284 / 316 FDD FDPCH FPLMN FTM FTP(S) GBK GERAN GGSN GMT GNSS GPIO GPRS GSM HDR HSDPA HSUPA HTTP(S) ICCID IDSN IETF IIC IMEI IMS IMSI Ipv4 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Frequency Division Duplexing Fraction-Dedicated Physical Channel Forbidden PLMN Factory Test Mode File Transfer Protocol over SSL Chinese Internal Code Specification GSM EDGE Radio Access Network Gateway GPRS Support Node Greenwich Mean Time Global Navigation Satellite System General-Purpose Input/Output General Packet Radio Service Global System for Mobile Communications High-Dynamic Range High Speed Downlink Packet Access High Speed Uplink Packet Access HyperText Transfer Protocol over SSL Integrated Circuit Card Identifier Integrated Services Digital Network The Internet Engineering Task Force Inter-Integrated Circuit International Mobile Equipment Identity IP Multimedia Subsystem International Mobile Subscriber Identity Internet Protocol version 4 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 285 / 316 Ipv6 IRA IRAT IWF LIPA LTE MBN MCC MCU ME MMS MNC MO MPTY MS MSC MSISDN MT MTU NMEA NITZ NSAPI NV OIR LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Internet Protocol version 6 International Reference Alphabet Inter-Radio Access Technology Interactive Website Framework Local IP Access Long Term Evolution Modem Software Configuration Mobile Country Code Microprogrammed Control Unit Mobile Equipment Multimedia Messaging Service Mobile Network Code Mobile Originated MultiParty Mobile Station Mobile Services Switching Center Mobile Subscriber International ISDN/PSTN number Mobile Terminal Maximum Transmission Unit National Marine Electronics Association Network Identity and Time Zone / Network Informed Time Zone. It is a mechanism for provisioning local time and date, time zone and DST offset, as well as network provider identity information, to mobile devices via a wireless network. Network Service Access Point Identifier Non-Volatile Random Access Memory Originating Identification Restriction EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 286 / 316 PCM PDN PDP PDU PIN PLMN PPP PSC PUK QCI QMI QoS RAT RDI RI RLP RPLMN RTC RTS/CTS RSCP RxQual SAP SDU SMS SMSC LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Pulse Code Modulation Public Data Network Packet Data Protocol Protocol Data Unit Personal Identification Number Public Land Mobile Network Point to Point Protocol Primary Synchronization Code Personal Identification Number Unlock Key QoS Class Identifier Qualcom Message Interface Quality of Servic Radio Access Technology Remote Defect Indication Ring Indicator Radio Link Protocol Registered PLMN Real Time Clock Request To Send/Clear To Send Received Signal Code Power Received Signal Quality Service Access Point Service Data Unit Short Message Service Short Message Service Center EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 287 / 316 SMTP SN SNDCP SSL TA TCP TDD TDSCDMA TE TFT TTS UARFCN UART UAC UCS2 UDH UDI UDP UDUB UE UFS UMTS UICC URC USB LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Simple Mail Transfer Protocol Serial Number SubNetwork Dependent Convergence Protocol Secure Sockets Layer Terminal Adapter Transmission Control Protocol Time Division Duplexing Time Division-Synchronous Code Division Multiple Access Terminal Equipment Traffic Flow Template Text To Speech UTRA Absolute Radio Frequency Channel Number Universal Asynchronous Receiver/Transmitter USB Audio Class Unicode User Data Header Unique Device Identification User Datagram Protocol User Determined User Busy User Equipment User File System Universal Mobile Telecommunications System Universal Integrated Circuit Card Unsolicited Result Code Universal Serial Bus EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 288 / 316 (U)SIM USSD UTRAN VoLTE WCDMA WLAN LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Universal Subscriber Identity Module Unstructured Supplementary Service Data UMTS Terrestrial Radio Access Network Voice (voice calls) over LTE. A standard high-speed wireless communication for mobile phones and data terminals, including Internet of things devices and wearables. Wideband Code Division Multiple Access Wireless Local Area Network 15.1. Factory Default Settings Restorable with AT&F Table 19: Factory Default Settings Restorable with AT&F AT Command ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATS12 ATV ATX Parameters Factory Defaults 1 0 0 13 10 8 2 0 2 15 50 1 4 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 289 / 316 AT&C AT&D AT+CREG AT+CGREG AT+CBST AT+CMEE AT+CSCS AT+CSTA AT+CR AT+CRC AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+CVHU AT+CLIP AT+COLP AT+CLIR AT+CSSN AT+CTZR AT+CPBS LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual ,, ,,, ,, ,,,, 1 2 0 0 0,0,1 1 'GSM' 129 0 0 0 0 17,167,0,0 0 0 'ME','ME','ME' 2,1,0,0,0 0 0 0 0 0 0 0 'SM' EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 290 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual AT+CGEREP , 0,0 AT+CEREG 0 AT+CCWA 0 AT+CUSD 0 AT+QAUDLOOP 0 15.2. AT Command Settings Storable with AT&W Table 20: AT Command Settings Storable with AT&W AT Command ATE ATQ ATS0 ATS7 ATS10 ATS12 ATV ATX AT&C AT&D AT+IPR AT+CREG AT+CGREG AT+CEREG Parameters Display with AT&V Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No No EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 291 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 15.3. AT Command Settings Storable with ATZ Table 21: AT Command Settings Storable with ATZ AT Command ATE ATQ ATS0 ATS7 ATS10 ATS12 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CEREG Parameters Factory Defaults 1 0 0 0 15 50 1 4 1 2 0 0 0 15.4. Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 292 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Table 22: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 10 11 12 13 14 15 16 17 18 20 21 22 23 24 25 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy SIM wrong Incorrect password SIM PIN2 required SIM PUK2 required Memory full Invalid index Not found Memory failure Text string too long Invalid characters in text string EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 293 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 901 Audio unknown error 902 Audio invalid parameters 903 Audio operation not supported 904 Audio device busy 15.5. Summary of CMS ERROR Codes Final result code +CMS ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands: EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 294 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Table 23: Different Coding Schemes of +CMS ERROR: Code of 107 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 331 332 340 Meaning Other General problems ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode SIM not inserted SIM pin necessary PH SIM pin necessary SIM failure SIM busy SIM wrong SIM PUK required SIM PIN2 required SIM PUK2 required Memory failure Invalid memory index Memory full SMSC address unknown No network Network timeout No +CNMA acknowledgement expected EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 295 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 350 Unknown 500 Unknown 510 Message blocked 15.6. Summary of URC Table 24: Summary of URC Index URC Display Meaning Condition 1 +CREG: Indicate registration status of the ME AT+CREG=1 After cell neighborhood changing +CREG: shows whether the network has 2 AT+CREG=2 [,,[,]] currently indicated the registration of the ME, with location area code 3 +CGREG: Indicate network registration status of AT+CGREG=1 the ME +CGREG: Indicate network registration and 4 AT+CGREG=2 [,,[,]] location information of the ME 5 +CTZV: Time zone reporting AT+CTZR=1 6 +CTZE: ,, Extended time zone reporting AT+CTZR=2 7 +CMTI: , New message is received, and saved See AT+CNMI to memory +CMT: New short message is received and 8 [],< See AT+CNMI output directly to TE (PDU mode) pdu> +CMT: ,[],[, New short message is received and 9 See AT+CNMI ,,,,,,] ^HCMT: ,,, New short message is received and 10 See AT+CNMI ,,,,, +CBM: 11 New CBM is received and output See AT+CNMI directly (PDU mode) EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 296 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +CBM: New CBM is received and output 12 ,,,, +CDS: 13 New CDS is received and output See AT+CNMI directly (PDU mode) +CDS: New CDS is received and output 14 ,,[],[],,, 15 +CDSI: , New message status report is See AT+CNMI received, and saved to memory ^HCDS: ,,, New CDS is received and output 16 ,,,,, See AT+CNMI +COLP: The presentation of the COL 17 ,,[], (connected line) at the TE for a AT+COLP=1 [],[] mobile originated call +CLIP: 18 ,,[subaddr],[s Mobile terminating call indication atype],[], AT+CLIP=1 19 +CRING: An incoming call is indicated to the TE with unsolicited result code AT+CRC=1 instead of the normal RING +CCWA: 20 ,,[,] AT+CCWA=1,1 21 +CSSI: Shows the +CSSI intermediate result AT+CSSN=1 code presentation status to the TE 22 +CSSU: Shows the +CSSU unsolicited result AT+CSSN=,1 code presentation status to the TE +CUSD: USSD response from the network, or 23 AT+CUSD=1 [,,[]] a network initiated operation 24 RDY ME initialization is successful N/A 25 +CFUN: 1 All function of the ME is available N/A 26 +CPIN: SIM card pin state N/A 27 +QIND: SMS DONE SMS initialization finished N/A 28 +QIND: PB DONE Phonebook initialization finished N/A 29 POWERED DOWN Module power down AT+QPOWD EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 297 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual +CGEV: REJECT A network request for PDP activation, 30 AT+CGEREP=2,1 , and was automatically rejected. +CGEV: NW REACT The network request PDP 31 , , reactivation [] AT+CGEREP=2,1 +CGEV: NW DEACT The network has forced a context 32 , , AT+CGEREP=2,1 deactivation [] +CGEV: ME DEACT The ME has forced a context 33 , , deactivation. [] AT+CGEREP=2,1 34 +CGEV: NW DETACH The network has forced a Packet AT+CGEREP=2,1 Domain detach. 35 +CGEV: ME DETACH The mobile equipment has forced a AT+CGEREP=2,1 Packet Domain detach. The network has forced a change of 36 +CGEV: NW CLASS AT+CGEREP=2,1 MS class. The mobile equipment has forced a 37 +CGEV: ME CLASS AT+CGEREP=2,1 change of MS class. 38 +USIM: 0 Use SIM card N/A 39 +USIM: 1 Use USIM card N/A 15.7. SMS Character Sets Conversions In 3GPP TS 23.038 DCS (Data Coding Scheme) defined three kinds of alphabets in SMS, GSM 7 bit default alphabet, 8 bit data and UCS2(16 bit). AT+CSMP can set the DCS in text mode (AT+CMGF=1). In text mode, DCS (Data Coding Scheme) and AT+CSCS determine the way of SMS text input or output. Table 25: The Way of SMS Text Input or Output DCS GSM 7 bit GSM 7 bit GSM 7 bit AT+CSCS GSM IRA UCS2 The Way of SMS Text Input or Output Input or output GSM character sets. Input or output IRA character sets. Input: UE will convert IRA characters to GSM characters. Output: UE will convert GSM characters to IRA characters. Input or output a hex string similar to PDU mode. So only support characters 0–9 and A–F. EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 298 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual UCS2 - 8 bit - Input: UE will convert the UCS2 hex string to GSM characters. Output: UE will convert the GSM characters to UCS2 hex string. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters 0–9 and A–F . Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters 0–9 and A–F. When DCS = GSM 7 bit, the input or output needs conversion. The detailed conversion tables are shown as below. Table 26: The Input Conversions Table (DCS = GSM 7 bit and AT+CSCS='GSM') 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0A Submit 2A 3A 4A 5A 6A 7A B 0B Cancel 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 299 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Table 27: The Output Conversions Table (DCS = GSM 7 bit and AT+CSCS='GSM') 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B 0B 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 28: GSM Extended Characters 0 1 2 3 4 5 6 7 0 1B40 1 2 3 4 1B14 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 300 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 5 6 7 8 1B28 9 1B29 A B C 1B3C D 1B3D E 1B3E F 1B2F Table 29: The Input Conversions Table (DCS = GSM 7 bit and AT+CSCS='IRA') 0 1 2 3 4 0 20 20 30 00 1 20 20 21 31 41 2 20 20 22 32 42 3 20 20 23 33 43 4 20 20 02 34 44 5 20 20 25 35 45 6 20 20 26 36 46 7 20 20 27 37 47 8 backspace 20 28 38 48 9 20 20 29 39 49 A 0A Submit 2A 3A 4A B 20 Cancel 2B 3B 4B 5 6 50 20 51 61 52 62 53 63 54 64 55 65 56 66 57 67 58 68 59 69 5A 6A 1B3C 6B 7 70 71 72 73 74 75 76 77 78 79 7A 1B28 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 301 / 316 C 20 D 0D E 20 F 20 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 20 2C 3C 4C 20 2D 3D 4D 20 2E 3E 4E 20 2F 3F 4F 1B2F 6C 1B3E 6D 1B14 6E 11 6F 1B40 1B29 1B3D 20 Table 30: IRA Extended Characters A B C D E F 0 20 20 20 20 7F 20 1 40 20 20 5D 20 7D 2 20 20 20 20 20 08 3 01 20 20 20 20 20 4 24 20 5B 20 7B 20 5 03 20 0E 20 0F 20 6 20 20 1C 5C 1D 7C 7 5F 20 09 20 20 20 8 20 20 20 0B 04 0C 9 20 20 1F 20 05 06 A 20 20 20 20 20 20 B 20 20 20 20 20 20 C 20 20 20 5E 07 7E D 20 20 20 20 20 20 E 20 20 20 20 20 20 F 20 60 20 1E 20 20 EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 302 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Table 31: The Output Conversions Table (DCS = GSM 7 bit and AT+CSCS='IRA') 0 1 2 3 4 5 6 7 0 40 20 20 30 A1 50 BF 70 1 A3 5F 21 31 41 51 61 71 2 24 20 22 32 42 52 62 72 3 A5 20 23 33 43 53 63 73 4 E8 20 A4 34 44 54 64 74 5 E9 20 25 35 45 55 65 75 6 F9 20 26 36 46 56 66 76 7 EC 20 27 37 47 57 67 77 8 F2 20 28 38 48 58 68 78 9 C7 20 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B D8 2B 3B 4B C4 6B E4 C F8 C6 2C 3C 4C D6 6C F6 D 0D E6 2D 3D 4D D1 6D F1 E C5 DF 2E 3E 4E DC 6E FC F E5 C9 2F 3F 4F A7 6F E0 Table 32: GSM Extended Characters 0 1 2 3 4 5 6 7 0 7C 1 2 3 4 5E EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 303 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 5 6 7 8 7B 9 7D A B C 5B D 7E E 5D F 5C Because the low 8 bit of UCS2 character is the same as the IRA character: The conversion table of DCS = GSM 7 bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. The conversion table of fmt = GSM 7 bit and AT+CSCS='GSM' is similar to AT+CSCS='GSM'. The conversion table of fmt = GSM 7 bit and AT+CSCS='IRA' is similar to AT+CSCS='IRA'. The conversion table of fmt = GSM 7 bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. The difference is the way of SMS text input or output. Please refer to Table 24 for more details. 15.8. Release Cause Text List of AT+CEER Table 33: List of Location ID List Location ID 0 1 2 3 Meaning CS internal cause CS network cause CS network reject PS internal cause EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 304 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 4 PS network cause 5 PS LTE cause 6 PS LTE local cause Table 34: List of Cause CS Internal Cause -1 0 21 25 27 29 34 35 36 38 39 45 46 47 48 100 101 102 103 Meaning No cause information available (default) Phone is offline No service available Network release, no reason given Received incoming call Client ended call UIM not present Access attempt already in progress Access failure, unknown source Concur service not supported by network No response received from network GPS call ended for user call SMS call ended for user call Data call ended for emergency call Rejected during redirect or handoff Lower-layer ended call Call origination request failed Client rejected incoming call Client rejected setup indication EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 305 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 104 105 106 108 109 301 302 303 304 305 CS Network Cause 1 3 6 8 16 17 18 19 21 22 26 27 28 29 Network ended call No funds available No service available Full service not available Maximum packet calls exceeded Video connection lost Video call setup failure Video protocol closed after setup Video protocol setup failure Internal error Meaning Unassigned/unallocated number No route to destination Channel unacceptable Operator determined barring Normal call clearing User busy No user responding User alerting, no answer Call rejected Number changed Non selected user clearing Destination out of order Invalid/incomplete number Facility rejected EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 306 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 30 Response to status enquiry 31 Normal, unspecified 34 No circuit/channel available 38 Network out of order 41 Temporary failure 42 Switching equipment congestion 43 Access information discarded 44 Requested circuit/channel not available 47 Resources unavailable, unspecified 49 Quality of service unavailable 50 Requested facility not subscribed 55 Incoming calls barred within the CUG 57 Bearer capability not authorized 58 Bearer capability not available 63 Service/option not available 65 Bearer service not implemented 68 ACM >= ACM max 69 Requested facility not implemented 70 Only RDI bearer is available 79 Service/option not implemented 81 Invalid transaction identifier value 87 User not member of CUG 88 Incompatible destination 91 Invalid transit network selection 95 Semantically incorrect message EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 307 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 96 97 98 99 100 101 102 111 127 CS Network Reject 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Recovery on timer expiry Protocol error, unspecified Interworking, unspecified Meaning IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME GPRS services not allowed GPRS and non GPRS services not allowed MS identity cannot be derived Implicitly detached PLMN not allowed Location area not allowed Roaming not allowed GPRS services not allowed in PLMN No suitable cells in location area MSC temporary not reachable EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 308 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 17 Network failure 20 MAC failure 21 Synch failure 22 Congestion 23 GSM authentication unacceptable 32 Service option not supported 33 Requested service option not subscribed 34 Service option temporary out of order 38 Call cannot be identified 40 No PDP context activated 95 Semantically incorrect message 96 Invalid mandatory information 97 Message type non-existent 98 Message type not compatible with state 99 Information element non-existent 101 Message not compatible with state 161 RR release indication 162 RR random access failure 163 RRC release indication 164 RRC close session indication 165 RRC open session failure 166 Low level failure 167 Low level failure no redial allowed 168 Invalid SIM 169 No service EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 309 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 170 171 172 173 174 175 176 177 178 179 PS Internet Cause 0 1 2 7 3 4 5 6 8 9 10 11 12 13 Timer T3230 expired No cell available Wrong state Access class blocked Abort message received Other cause Timer T303 expired No resources Release pending Invalid user data Meaning Invalid connection identifier Invalid NSAPI Invalid primary NSAPI PDP establish timeout Invalid field SNDCP failure RAB setup failure No GPRS context PDP activate timeout PDP modify timeout PDP inactive max timeout PDP lower layer error PDP duplicate Access technology change EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 310 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 14 PS Network Cause 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 81 PDP unknown reason Meaning LLC or SNDCP failure Insufficient resources Missing or unknown APN Unknown PDP address or PDP type User authentication failed Activation rejected by GGSN Activation rejected, unspecified Service option not supported Requested service option not subscribed Service option temporary out of order NSAPI already used (not sent) Regular deactivation QoS not accepted Network failure Reactivation required Feature not supported Semantic error in the TFT operation Syntactical error in the TFT operation Unknown PDP context PDP context without TFT already activated Semantic errors in packet filter Syntactical errors in packet filter Invalid transaction identifier EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 311 / 316 95 96 97 98 99 100 101 111 PS LTE Cause 8 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Protocol error, unspecified Meaning Operator determined barring Insufficient Resources Missing or unknown APN Unknown PDP address or PDP type User Aauthentication faile Activation rejected by Servicing GW or PDN GW Activation rejected, unspecified Service option not supported Requested service option not subscribed Service option temporarily out of order PTI already In use Regular deactivation QoS not accepted Network failure Reactivation required Feature not supported EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 312 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 41 Semantic error in the TFT operation 42 Syntactical error in the TFT operation 43 Unknown Bearer context 44 Semantic errors in packet filter 45 Syntactical errors in packet filter 46 Bearer Context without TFT already Active 47 PTI mismatch 49 PDN disconnected, not allowed 50 PDN type IPV4 only Allowed 51 PDN type IPV6 only Allowed 52 Single ADR bearers only Allowed 53 ESM info not recieved 54 PDN connection does not exist 55 Multiple PDN connection for given APN not allowed 56 Collision with network init request 59 Unsupported QCI value 81 Invalid PTI value 95 Symantically invalid message 96 Invalid mandatory information 97 Message non-existent/not implemented 98 Message type not compatible with state 99 Info Elemant non existent 100 Conditional IE error 101 Message type not compatible with state 111 Protocol error, unspecified EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 313 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 112 PS LTE Local Cause 3 6 7 9 10 11 12 13 15 18 25 38 39 43 256 257 258 259 260 261 262 263 264 APN restrict value incompatible with ACT context Meaning Illegal UE Illegal ME EPS services not allowed UE id can't be driven by network Implicitly Detached PLMN not allowed tracking area not allowed Roaming not allowed in this tracking area No Suitable cells in tracking area CS Domain Not available Not Authorized for this CSG CS fallback call EST not allowed CS domain temperarly not allowed Unknown EPS bearer context Released AT RRC Signal Connection Released EMM detached EMM attach failed EMM attach started NAS service request failed ESM activate dedicated bearer reactivater by network Lower layer failure Lower layer failure EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 314 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 265 Network activater dedicated bearer with ID of deffered bearer 266 BAD OTA message 267 DS rejected the call 268 Context transferred due to IRAT 269 DS explicit deactivation 270 ESM MSGR failure 271 Local Cause not Available 272 Rejected due to connected state 273 Nas Service request failed, no throttle 274 ACL failure 275 Nas Service request failed, DS disallow 276 EMM T3417 expired 277 EMM T3417 ext expired 278 Nas LRRC UL data CNF failure TXN 279 Nas LRRC UL data CNF failure HO 280 Nas LRRC UL data CNF failure Conn release 281 Nas LRRC UL data CNF failure RLF 282 Nas LRRC UL data CNF failure control Not CONN 283 NAS LRRC connection EST success 284 NAS LRRC connection EST failure 285 NAS LRRC connection EST failure, aborted 286 NAS LRRC connection EST failure, access barrer 287 NAS LRRC connection EST failure, CELL resel 288 NAS LRRC connection EST failure, config failure 289 NAS LRRC connection EST failure, timer expired EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 315 / 316 LTE Standard Module Series EC2x&EG9x&EG2x-G&EM05 Series AT Commands Manual 290 NAS LRRC connection EST failure, link failure 291 NAS LRRC connection EST failure, not camped 292 NAS LRRC connection EST failure, SI failure 293 NAS LRRC connection EST failure, CONN reject 294 NAS LRRC connection release normal 295 NAS LRRC connection release RLF 296 NAS LRRC connection release CRE failure 297 NAS LRRC connection release QOS during CRE 298 NAS LRRC connection release aborted 299 NAS LRRC connection release SIB read error 300 NAS LRRC connection release aborted IRAT Success 301 Nas Reject LRRC radio link failure 302 Nas service request failure, LTE network reject 303 Nas detach with reattach, LTE network detach 304 NAS detach without reacttach, LTE network detach EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 316 / 316

BC26&BC20 AT 命令手册 NB-IoT 模块系列 版本：1.1 日期：2020-09-27 状态：受控文件 www.quectel.com BC26&BC20 AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 116 BC26&BC20 AT 命令手册 文档历史 修订记录 版本 1.0 日期 作者 2020-03-12 饶晨 1.1 2020-09-27 饶晨 变更表述 受控版本 1. 删除 BC030x 系列模块信息，更新文档名称。 2. 更新 AT 命令：ATE/ AT+CEREG/ AT+CESQ /AT+QENG/ AT+ CCIOTOPT/ AT+QLOCKF/ AT+CEDRXRDP（更新了的取值范围）/ AT+QCFG。 3. 新增 AT 命令：AT+QIPADDR/ AT+QEMMTIMER/ AT+QLEDM ODE/ AT+CPINR。 4. 新增 GNSS 相关 AT 命令章节介绍。 上海移远通信技术股份有限公司 2 / 116 BC26&BC20 AT 命令手册 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 定义 ............................................................................................................................................ 7 1.2. AT 命令语法 ............................................................................................................................... 7 1.3. 数据模式说明.............................................................................................................................. 8 2 产品信息查询命令 ................................................................................................................................. 9 2.1. ATI 显示产品标识信息 ............................................................................................................. 9 2.2. AT+CGMI 查询平台信息........................................................................................................ 10 2.3. AT+CGMM 查询模块型号...................................................................................................... 10 2.4. AT+CGMR 查询制造商版本号............................................................................................... 11 2.5. AT+CGSN 查询产品序列号 ................................................................................................... 12 3 UART 功能命令................................................................................................................................... 14 3.1. ATE 设置命令回显模式.......................................................................................................... 14 3.2. AT+IPR 设置 TE-TA 的波特率............................................................................................... 15 4 网络状态查询命令 ............................................................................................................................... 17 4.1. AT+CEREG EPS 网络注册状态 ............................................................................................ 17 4.2. AT+CESQ 扩展信号质量 ....................................................................................................... 20 4.3. AT+CGATT PS 域附着或去附着 ........................................................................................... 22 4.4. AT+CGPADDR 显示 PDP 地址 ............................................................................................. 24 4.5. AT+CSCON RRC 连接状态................................................................................................... 25 4.6. AT+CSQ 上报信号质量 ......................................................................................................... 27 4.7. AT+QENG 网络服务信息 ...................................................................................................... 28 4.8. AT+QIPADDR 查询 UE 的 IP 地址 ........................................................................................ 32 5 PDN 和 APN 相关命令 ........................................................................................................................ 33 5.1. AT+CGACT PDP 上下文激活/去激活.................................................................................... 33 5.2. AT+CGAPNRC APN 速率控制.............................................................................................. 35 5.3. AT+CGDCONT 定义 PDP 上下文 ......................................................................................... 36 5.4. AT+CIPCA 初始 PDP 上下文激活 ......................................................................................... 40 5.5. AT+QCGDEFCONT 配置默认的 APN/PDN 连接.................................................................. 41 5.6. AT+QGACT 激活/去激活 PDN 上下文 .................................................................................. 42 6 其他网络命令....................................................................................................................................... 45 6.1. AT+CCIOTOPT CloT 优化配置 ............................................................................................. 45 6.2. AT+COPS PLMN 选择 .......................................................................................................... 46 6.3. AT+QBAND 查询/设置工作频段 ............................................................................................ 48 6.4. AT+QBANDSL 设置优先搜索的频段列表.............................................................................. 50 6.5. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表 ........................................................ 51 上海移远通信技术股份有限公司 3 / 116 BC26&BC20 AT 命令手册 6.6. AT+QEMMTIMER 启用/禁用 EMM 定时器 URC 上报........................................................... 51 6.7. AT+QLEDMODE 配置网络状态指示灯 ................................................................................. 53 6.8. AT+QLOCKF 锁定 NB-IoT 频点及 PCI.................................................................................. 54 7 USIM 相关命令.................................................................................................................................... 56 7.1. AT+CIMI 查询 IMSI................................................................................................................ 56 7.2. AT+CLCK 设备锁定............................................................................................................... 57 7.3. AT+CPIN PIN 管理 ................................................................................................................ 59 7.4. AT+CPINR 剩余 PIN 重试次数 .............................................................................................. 60 7.5. AT+CPLS 选择优先 PLMN 列表............................................................................................ 61 7.6. AT+CPOL 配置优先网络列表 ................................................................................................ 62 7.7. AT+CPWD 修改密码 ............................................................................................................. 64 7.8. AT+CRSM USIM 卡受限访问 ................................................................................................ 65 7.9. AT+QCCID USIM 卡识别 ...................................................................................................... 67 8 功耗相关命令....................................................................................................................................... 68 8.1. AT+CEDRXS eDRX 设置 ...................................................................................................... 68 8.2. AT+CEDRXRDP 查询 eDRX 状态 ........................................................................................ 71 8.3. AT+CFUN 设置 UE 功能 ....................................................................................................... 73 8.4. AT+CPSMS 省电模式（PSM）设置 ..................................................................................... 74 8.5. AT+QEDRXCFG eDRX 和 PTW 设置................................................................................... 76 8.6. AT+QNBIOTRAI NB-IoT 释放辅助指示................................................................................. 79 8.7. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 .......................................................... 80 8.8. AT+QRELLOCK 释放 AT 命令休眠锁 ................................................................................... 81 8.9. AT+QSCLK 配置休眠模式 ..................................................................................................... 82 9 平台相关命令....................................................................................................................................... 84 9.1. AT&W 存储当前参数到 NVRAM............................................................................................ 84 9.2. AT+CBC 查询电源电压.......................................................................................................... 84 9.3. AT+CEER 扩展错误报告 ....................................................................................................... 86 9.4. AT+CMEE 启用/禁用移动终端错误上报................................................................................ 86 9.5. AT+QADC 读取 ADC 通道输入电压值 .................................................................................. 88 9.6. AT+QATWAKEUP 启用/禁用深休眠唤醒指示....................................................................... 89 9.7. AT+QCFG 系统配置 .............................................................................................................. 90 9.8. AT+QPOWD 模块关机/重启 .................................................................................................. 92 9.9. AT+QRST 自动重启 .............................................................................................................. 93 9.10. AT+QVBATT 配置电压阈值................................................................................................... 93 10 时间相关命令....................................................................................................................................... 96 10.1. AT+CCLK 设置/查询当前日期和时间 .................................................................................... 96 10.2. AT+CTZR 上报时区变化 ....................................................................................................... 97 10.3. AT+QCCLK 设置/查询当前日期和 UTC ................................................................................ 99 11 其它命令 ............................................................................................................................................ 101 11.1. TCP/IP 相关 AT 命令.............................................................................................................. 101 11.2. MQTT 相关 AT 命令 ............................................................................................................... 102 11.3. SSL 相关 AT 命令................................................................................................................... 102 上海移远通信技术股份有限公司 4 / 116 BC26&BC20 AT 命令手册 11.4. LwM2M 相关 AT 命令............................................................................................................. 103 11.5. 电信 IoT 平台相关 AT 命令..................................................................................................... 104 11.6. OneNET 相关 AT 命令 ........................................................................................................... 104 11.7. CMDMP 相关 AT 命令............................................................................................................ 105 11.8. 中国电信/联通自注册相关 AT 命令......................................................................................... 106 11.9. DFOTA 相关 AT 命令 ............................................................................................................. 106 11.10. GNSS 相关 AT 命令 ............................................................................................................... 106 12 错误代码汇总..................................................................................................................................... 108 12.1. 常见错误代码列表 .................................................................................................................. 108 12.2. 指定错误代码列表 .................................................................................................................. 109 13 附录 A 参考文档及术语缩写............................................................................................................. 111 上海移远通信技术股份有限公司 5 / 116 BC26&BC20 AT 命令手册 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令格式 ....................................................................................................................................... 8 表 3：TCP/IP 相关 AT 命令列表 .............................................................................................................. 101 表 4：MQTT 相关 AT 命令列表 ................................................................................................................ 102 表 5：SSL 相关 AT 命令列表 ................................................................................................................... 102 表 6：LwM2M 相关 AT 命令列表 ............................................................................................................. 103 表 7：电信 IoT 平台相关 AT 命令列表...................................................................................................... 104 表 8：OneNET 相关 AT 命令列表 ............................................................................................................ 104 表 9：CMDMP 相关 AT 命令列表 ............................................................................................................ 105 表 10：中国电信/联通自注册相关 AT 命令列表 ....................................................................................... 106 表 11：DFOTA 相关 AT 命令列表............................................................................................................ 106 表 12：GNSS 相关 AT 命令列表.............................................................................................................. 106 表 13：常见错误代码列表（27.007）...................................................................................................... 108 表 14：指定错误代码列表 ........................................................................................................................ 109 表 15：参考文档 ....................................................................................................................................... 111 表 16：术语缩写 ....................................................................................................................................... 111 上海移远通信技术股份有限公司 6 / 116 BC26&BC20 AT 命令手册 1 引言 本文档详细介绍了如下移远通信 NB-IoT 系列模块支持的 AT 命令集： 表 1：适用模块 模块系列 NB-IoT/GNSS NB-IoT 模块 BC20 BC26 模块默认处于自适应波特率模式。模块上电后，MCU 必须连续发送 AT 命令以便和模块进行波特率同 步，直至返回 OK。同步成功后，MCU 可以发送 AT+IPR= 配置后续通信的波特率。若未指定波特 率，则应在下次重启时重新同步。 1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明，配 置命令中的可选参数被省略时，将使用其保存至 NVRAM 的值或其默认值。 参数的默认设置。 1.2. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应，省略。 上海移远通信技术股份有限公司 7 / 116 BC26&BC20 AT 命令手册 BC20 和 BC26 模块实现的 AT 命令可以在语法上分为两类：基础类和扩展类，如下所列。 ⚫ 基础类 基础类 AT 命令的格式为 AT 或 AT&，其中 是命令， 是该命令的参数。以 ATE 为例，DCE 会根据 的取值确定是否将接收到的字符回显给 DTE。若 为 可选参数，则其被省略时将使用其默认值或已保存至 NVRAM 的设置值。 ⚫ 扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 表 2：AT 命令格式 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令或内部程序可支持的参数取值列表或范 围。 AT+? 返回相应设置命令的当前参数设置值。 AT+=[,[, 设置用户可自定义的参数值。 [...]]] AT+ 主动执行内部程序实现的功能集。 备注 每次仅支持执行一个 AT 命令。仅当上一个命令执行完成后，方可执行下一个命令。 1.3. 数据模式说明 BC20 和 BC26 模块支持两种串口模式：命令模式和数据模式。命令模式下，通过串口输入的数据会被 视为 AT 命令去解析；而数据模式下，通过串口输入的数据则被视为普通数据。 命令模式下，当串口输出 > 后，模块会在 500 毫秒内进入数据模式。之后若通过串口输入 Ctrl+Z 则模 块退出数据模式并处理接收到的数据，若通过串口输入 Esc 则模块退出数据模式并丢弃本次输入的数据。 备注 1. 命令模式下，当串口输出 > 后，建议 MCU 等待 500 毫秒后再发送实际数据。 2. 数据模式下，URC 会被直接丢弃，因此建议不要在数据模式下有等待动作，请尽快完成数据输入并 退出数据模式。 上海移远通信技术股份有限公司 8 / 116 BC26&BC20 AT 命令手册 2 产品信息查询命令 2.1. ATI 显示产品标识信息 该命令返回产品标识信息，如设备型号和固件版本号。 ATI 显示产品标识信息 执行命令 ATI 响应 Quectel_Ltd Revision: 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。设备型号。 字符串类型。固件版本号。 举例 ATI Quectel_Ltd Quectel_BC26 Revision: BC26NCR01A07 OK 上海移远通信技术股份有限公司 9 / 116 2.2. AT+CGMI 查询平台信息 该命令用于查询平台信息。 AT+CGMI 查询平台信息 测试命令 AT+CGMI=? 执行命令 AT+CGMI 最大响应时间 特性说明 响应 OK 响应 Quectel_Ltd Revision: MTK_2625 OK 300 毫秒 / 参数 字符串类型。设备型号。 举例 AT+CGMI Quectel_Ltd Quectel_BC26 Revision: MTK_2625 OK 2.3. AT+CGMM 查询模块型号 该命令用于查询模块型号。 AT+CGMM 查询模块型号 测试命令 AT+CGMM=? 执行命令 AT+CGMM 响应 OK 响应 上海移远通信技术股份有限公司 BC26&BC20 AT 命令手册 10 / 116 BC26&BC20 AT 命令手册 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。设备型号。 举例 AT+CGMM Quectel_BC26 OK 2.4. AT+CGMR 查询制造商版本号 该命令返回制造商版本号。 AT+CGMR 查询制造商版本号 测试命令 AT+CGMR=? 执行命令 AT+CGMR 最大响应时间 特性说明 响应 OK 响应 Revision: OK 300 毫秒 / 参数 字符串类型。制造商版本号，默认为固件版本号。 举例 AT+CGMR 上海移远通信技术股份有限公司 11 / 116 Revision: BC26NCR01A07 OK BC26&BC20 AT 命令手册 2.5. AT+CGSN 查询产品序列号 该命令返回产品的 IMEI 号及相关信息。对于不支持的 TA，仅返回 OK。 AT+CGSN 查询产品序列号 测试命令 AT+CGSN=? 响应 TE 支持且命令执行成功时： +CGSN: (支持的范围) 查询命令 AT+CGSN= OK 响应 当=0 时： OK 当=1 时 +CGSN: OK 当=2 时 +CGSN: OK 当=3 时 +CGSN: OK 执行命令 AT+CGSN 若出现任何错误： ERROR 或者 +CME ERROR: 响应 上海移远通信技术股份有限公司 12 / 116 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / BC26&BC20 AT 命令手册 参数 整型。被请求的序列号类型。 0 128 位 UUID 1 IMEI 2 IMEISV 3 SVN 字符串类型。UE 的 128 位 UUID。信息文本（包括行终止符在内）的字符总数不应 超过 2048 个字符，且不包含 0或 OK序列。 字符串类型。产品的 IMEI。十进制格式。 字符串类型。产品的 IMEISV。十进制格式。 字符串类型。产品的 SVN，属于 IMEISV 的一部分。十进制格式。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CGSN=1 +CGSN: 490154203237511 OK //查询 IMEI 号。 上海移远通信技术股份有限公司 13 / 116 BC26&BC20 AT 命令手册 3 UART 功能命令 3.1. ATE 设置命令回显模式 该命令用于设置 UE 是否回显从外部接收的命令。 ATE 设置命令回显模式 执行命令 ATE 最大响应时间 特性说明 响应 OK 300 毫秒 该命令立即生效。 深休眠唤醒后有效；保存至 NVRAM（需先执行 AT&W）。 参数 整型。UE 是否回显从外部接收的命令。 0 不回显命令 1 回显命令 举例 ATE0 OK ATI Quectel_Ltd Quectel_BC26 Revision: BC26NCR01A07 OK ATE1 OK ATI ATI 上海移远通信技术股份有限公司 14 / 116 Quectel_Ltd Quectel_BC26 Revision: BC26NCR01A07 OK BC26&BC20 AT 命令手册 3.2. AT+IPR 设置 TE-TA 的波特率 该命令用于设置 TE-TA 的波特率。 AT+IPR 设置 TE-TA 的波特率 测试命令 AT+IPR=? 响应 +IPR: (支持的自适应列表),(支持的固定列表) 查询命令 AT+IPR? OK 响应 +IPR: 设置命令 AT+IPR= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。每秒波特率。 0 （自适应波特率） 110 300 1200 2400 4800 9600 19200 上海移远通信技术股份有限公司 15 / 116 38400 57600 115200 230400 460800 921600 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 该设置将应用于同一个 UART 连接级别的路由的所有信道。 2. 该命令不适用于 USB 接口。 3. BC20 和 BC26 模块仅支持同步 115200 bps 及以下的波特率。 举例 AT+IPR=115200 OK AT+IPR? +IPR: 115200 OK //将波特率固定为 115200 bps。 BC26&BC20 AT 命令手册 上海移远通信技术股份有限公司 16 / 116 BC26&BC20 AT 命令手册 4 网络状态查询命令 4.1. AT+CEREG EPS 网络注册状态 设置命令用于设置 EPS 网络注册状态的 URC 上报状态： ⚫ 当=1，E-UTRAN 中 MT 的 EPS 网络注册状态发生变化化时，上报 URC +CEREG: 。 ⚫ 当=2，E-UTRAN 中的网络小区发生变化时，上报 URC +CEREG: [,[],[],[< AcT>]]；参数 、 和 仅在可用时才会上报。 ⚫ 当=3，当 的值改变时，URC 会显示和（若参数可用）。 若 UE 请求 PSM 降低其功耗，则设置命令还可控制上报 URC +CEREG: [,[],[],[][,[],[][,[],[]]]]。 ⚫ 当=4 时，若 E-UTRAN 中的网络小区发生变化，则会向 UE 上报 URC，提供额外信息，如激 活时间值和扩展的周期性 TAU 值。 ⚫ 当 =5 时 ， 若 的 值 发 生 改 变 ， URC 将 会 比 =4 时 多 上 报 和 。、,、、、和 仅在可用时才会上报。 查询命令返回 URC 的状态，同时返回以指示 MT 是否已经注册到当前网络。位置信息、 和如果可用，仅在=2 且 MT 已注册到网络时上报。、如果 可用，仅在=3 时上报。 测试命令返回支持的参数值。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 响应 +CEREG: (支持的范围) 查询命令 AT+CEREG? OK 响应 当=0、1、2 或 3 且命令成功执行时： +CEREG: ,[,[],[],[[,,]]] 当=4 或 5 并且命令成功执行时： 上海移远通信技术股份有限公司 17 / 116 BC26&BC20 AT 命令手册 设置命令 AT+CEREG= 最大响应时间 特性说明 +CEREG: ,[,[],[],[][,[],[][,[],[]]]] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；保存至 NVRAM（需先执行 AT&W）。 参数 整型。禁止或允许上报网络注册状态等信息。 0 禁止上报网络注册状态 URC 1 允许上报网络注册状态 URC +CEREG: 2 允许上报网络注册状态和位置信息 URC +CEREG: [,[],[],[]] 3 允许上报网络注册状态、位置信息和 EMM 原因值 URC +CEREG: [,[], [],[][,,]] 4 对于请求 PSM 的 UE，允许上报网络注册状态和位置信息 URC +CEREG: [,[],[],[][,,[,[],[]]]] 5 对于请求 PSM 的 UE，允许上报网络注册状态、位置信息和 EMM 原因值 URC +CEREG: [,[],[],[][,[],[][,[, []]]] 整型。EPS 注册状态。 0 未注册，MT 当前未搜索网络 1 已注册，归属网络 2 未注册，但 MT 当前正在尝试附着或搜索网络以进行注册 3 注册被拒绝 4 未知（例如：超出 E-UTRAN 覆盖范围） 5 已注册，漫游状态 字符串类型。跟踪区码，两个字节，十六进制格式（例如，'00C3'等于十进制的 195）。 字符串类型。E-UTRAN 小区 ID，四个字节，十六进制格式。 上海移远通信技术股份有限公司 18 / 116 BC26&BC20 AT 命令手册 整型。注册网络的接入技术。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 整型。的类型。 0 包含 EMM 原因值（详见《3GPP TS 24.008》附录 G） 1 包含特定制造商的原因值 整型。包含注册失败的原因。该参数的类型由定义。请参见《3GPP TS 24.301》。 字符串类型。E-UTRAN 中分配给 UE 的激活时间值（T3324），八位为一个字节。激 活时间值被编码为 GPRS Timer 2 信息元素的一个字节（octet 3），所述信息元素编码 为位格式（例如'00100100' 等于 4 分钟）。有关编码和取值范围，请参阅《3GPP TS 24.008》表 10.5.163；《3GPP TS 24.008》，《3GPP TS 23.682》以及《3GPP TS 23.401》中的 GPRS Timer 2 IE。 第 5 位至第 1 位表示二进制编码的定时器值。 第 8 位至第 6 位定义 GPRS 定时器步长，如下所示： 位 8 7 6 0 0 0 步长为 2 秒 0 0 1 步长为 1 分钟 0 1 0 步长为 6 分钟 1 1 1 去激活该定时器 字符串类型。E-UTRAN 中分配给 UE 的扩展的周期性 TAU 值（T3412），八位为一个 字节。扩展的周期性 TAU 值被编码为 GPRS Timer 3 信息元素的一个字节（octet 3）， 所述信息元素编码为位格式（例如'01000111' 等于 70 小时）。有关编码和取值范围， 详见《3GPP TS 24.008 》表 10.5.163a；《3GPP TS 24.008》，《3GPP TS 23.682》 以及《3GPP TS 23.401》中的 GPRS Timer 3 IE。 第 5 位至第 1 位表示二进制编码的定时器值。 第 8 位至第 6 位定义定时器步长，如下所示： 位 8 7 6 0 0 0 步长为 10 分钟 0 0 1 步长为 1 小时 0 1 0 步长为 10 小时 0 1 1 步长为 2 秒 1 0 0 步长为 30 秒 1 0 1 步长为 1 分钟 1 1 0 步长为 320 小时 1 1 1 去激活该定时器 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CEREG=1 OK //允许上报网络注册状态 URC。 上海移远通信技术股份有限公司 19 / 116 BC26&BC20 AT 命令手册 AT+CEREG? +CEREG: 1,1 OK AT+CEREG=? +CEREG: (0-5) OK 4.2. AT+CESQ 扩展信号质量 执行命令返回接收信号质量参数。终端将提供 0 到 99 的信号强度指示。通常，数值越大，强度越高。 测试命令返回支持的参数值。 AT+CESQ 扩展信号质量 测试命令 AT+CESQ=? 响应 +CESQ: (支持的列表),(支持的列表),(支持的 列表),(支持的列表),(支持的列表),(支 持的列表) 执行命令 AT+CESQ OK 响应 +CESQ: ,,,,, OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。接收信号强度等级。 0 < -110 dBm 上海移远通信技术股份有限公司 20 / 116 BC26&BC20 AT 命令手册 1 -110 dBm ≤ < -109 dBm 2 -109 dBm ≤ < -108 dBm … 61 -50 dBm ≤ < -49 dBm 62 -49 dBm ≤ < -48 dBm 63 -48 dBm ≤ 99 未知 整型。信道误码率（百分比）。 0-7 RxQual 值（RxQual_0 至 RxQual_7 的定义，详见《3GPP TS 45.008》） 99 未知 整型。接收信号码功率（RSCP，参见《3GPP 25.133》和《3GPP 25.123》）。 0 < -120 dBm 1 -120 dBm ≤ < -119 dBm 2 -119 dBm ≤ < -118 dBm … 94 -27 dBm ≤ < -26 dBm 95 -26 dBm ≤ < -25 dBm 96 -25 dBm ≤ 255 未知 整型。Ec/No（参见《3GPP 25.133》）。 0 < -24 dBm 1 -24 dBm ≤ < -23.5 dBm 2 -23.5 dBm ≤ < -23 dBm … 47 -1 dBm ≤ < -0.5 dBm 48 -0.5 dBm ≤ < 0 dBm 49 0 dBm ≤ 255 未知 整型。参考信号接收质量（RSRQ，参见《3GPP 25.133》）。需要发送数据时，建议 RSRQ 大于 -10 dB。 0 < -19.5 dB 1 -19.5 dB ≤ < -19 dB 2 -19 dB ≤ < -18.5 dB … 32 -4 dB ≤ < -3.5 dB 33 -3.5 dB ≤ > < -3 dB 34 -3 dB ≤ 255 未知 整型。参考信号接收功率（RSRP，参见《3GPP 25.133》）。需要发送数据时，建议 RSRP 大于 -115 dBm。 0 < -140 dBm 1 -140 dBm ≤ < -139 dBm 2 -139 dBm ≤ < -138 dBm … 上海移远通信技术股份有限公司 21 / 116 BC26&BC20 AT 命令手册 95 96 97 255 整型。 -46 dBm ≤ < -45 dBm -45 dBm ≤ < -44 dBm -44 dBm ≤ 未知 错误码。详细信息，请参阅第 12 章。 备注 1. 有关的详细信息，参见 AT+CSQ 命令介绍。 2. 和不适用于 NB-IoT 网络，应设置为未知（255）。 3. 为便于了解网络环境，可根据以下通用规则评估网络质量： ⚫ 强：RSRP ≥ -100 dBm 且 RSRQ ≥ -7 dB ⚫ 中：-100 dBm ≥ RSRP ≥ -110 dBm 且 RSRQ ≥ -11 dB ⚫ 弱：RSRP < -115 dBm 或 RSRQ < -11 dB 举例 AT+CESQ +CESQ: 15,99,255,255,8,30 OK 4.3. AT+CGATT PS 域附着或去附着 设置命令用于将 MT 附着于 PS 域，或将 MT 从 PS 域去附着。命令完成后，MT 保持在 V.250 命令状 态。如果 MT 已经处于请求状态，则忽略该命令，并且仍将响应 OK。如果 MT 无法实现请求状态，将响应 ERROR 或+CME ERROR。 当附着状态更改为去附着状态时，将自动去激活所有已激活的 PDP 上下文。 查询命令返回当前 PS 域服务状态。 测试命令返回支持的 PS 域服务状态。 AT+CGATT PS 域附着或去附着 测试命令 AT+CGATT=? 响应 +CGATT: (支持的列表) 查询命令 AT+CGATT? OK 响应 +CGATT: 上海移远通信技术股份有限公司 22 / 116 BC26&BC20 AT 命令手册 设置命令 AT+CGATT= 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 85 秒，依赖于网络环境 / 参数 整型。PDP 上下文激活状态。 0 去附着 1 附着 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 如果支持初始 PDP 上下文建立，则在模块注网时会自动定义 =1 的上下文。 2. 如果 AT+CGATT 命令正在执行中，在完成附着或去附着过程之前再次执行该命令将返回错误。 举例 AT+CGATT? +CGATT: 0 OK AT+CGATT=1 OK AT+CGATT=? +CGATT: (0,1) OK 上海移远通信技术股份有限公司 23 / 116 BC26&BC20 AT 命令手册 4.4. AT+CGPADDR 显示 PDP 地址 该命令返回设备的 IP 地址。 执行命令返回指定上下文标识符的 PDP 地址列表。如果未指定，则返回所有已定义上下文的地 址。 测试命令返回已定义的列表。所述已激活，但未必有与之关联的 IP 地址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (支持的已定义的列表) 查询命令 AT+CGPADDR? OK 响应 +CGPADDR: [,[,]] [+CGPADDR: [,[,]]] [...] 设置命令 AT+CGPADDR= OK 响应 +CGPADDR: [,[,]] 执行命令 AT+CGPADDR OK 响应 [+CGPADDR: [,[,]]] [+CGPADDR: [,[,]]] [...] 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义（请参阅 AT+CGDCONT）。 如果未指定，则返回所有已定义上下文的地址。 和 字符串类型。PDP 地址，用于在适用于 PDP 的地址空间中识别 MT；地址可以为静态 或动态。默认使用包含地址。 静态地址，在定义上下文时由 AT+CGDCONT 设置。 上海移远通信技术股份有限公司 24 / 116 BC26&BC20 AT 命令手册 动态地址，在上一次 PDP 上下文激活（使用了指定的上下文定义）期间分配。如 果没有可用的或，该参数将被省略。 当同时分配了 IPv4 和 IPv6 地址时，将同时包含和，其 中包含 IPv4 地址，而包含 IPv6 地址。 该字符串以点分隔的数值（0~255）参数形式给出： IPv4 地址形式：a1.a2.a3.a4 IPv6 地址形式：a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a13.a14.a15.a16 备注 在双栈终端（='IPV4V6'）中，对应 IPv6 的地址；对于 IPv6 单栈终端 （='IPV6'）或具有向后兼容性的终端，IPv6 地址也可包含在参数中。 举例 AT+CGPADDR=1 +CGPADDR: 1,101.43.5.1 OK AT+CGPADDR=? +CGPADDR: (1) OK 4.5. AT+CSCON RRC 连接状态 该命令可提供 TA 感知的无线连接状态（即和基站的连接状态）信息，并可返回当前状态的指示。该状 态仅在无线事件（例如发送和接收）发生时更新。因此，当前返回的状态可能已经过时。即使在返回状态 =1（连接态）的情况下，由于连接质量的变化，模块仍可能无法连接到基站。 设置命令用于控制 URC +CSCON: 的显示。 值指示 MT 在 E-UTRAN 中时的状态：MT 在没有信令连接时为空闲态，有信令连接时为连接 态。 查询命令返回 URC 显示的状态和整型参数以指示 MT 当前为空闲态或连接态。 AT+CSCON RRC 连接状态 测试命令 AT+CSCON=? 响应 +CSCON: (支持的列表) 上海移远通信技术股份有限公司 25 / 116 BC26&BC20 AT 命令手册 查询命令 AT+CSCON? 设置命令 AT+CSCON= 最大响应时间 特性说明 OK 响应 +CSCON: , OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。启用/禁用 URC。 0 禁用 URC 1 启用 URC +CSCON: 整型。信令连接状态。 0 空闲态 1 连接态 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CSCON=0 OK AT+CSCON? +CSCON: 0,1 OK AT+CSCON=? 上海移远通信技术股份有限公司 26 / 116 +CSCON: (0,1) OK AT+CSCON=1 OK AT+CSCON? +CSCON: 1,1 OK BC26&BC20 AT 命令手册 4.6. AT+CSQ 上报信号质量 该命令可返回接收信号强度指示和信道误码率。 测试命令返回支持的参数值。 AT+CSQ 上报信号质量 测试命令 AT+CSQ=? 响应 +CSQ: (支持的列表),(支持的列表) 执行命令 AT+CSQ OK 响应 +CSQ: , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。接收信号强度指示。 0 -113 dBm 或以下 1 -111 dBm 上海移远通信技术股份有限公司 27 / 116 BC26&BC20 AT 命令手册 2~30 -109 至-53 dBm 31 -51 dBm 或以上 99 未知 整型。信道误码率（百分比）。 0~7 RxQual 值（RxQual_0 至 RxQual_7 的定义，请参阅《3GPP TS 45.008》） 99 未知 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CSQ +CSQ: 22,0 OK 4.7. AT+QENG 网络服务信息 该命令用于查询模块当前的网络服务信息。当模块处于 PSM 状态或无服务时，设置命令不支持 =0，并且=1 仅在 RRC 连接状态下可用。 AT+QENG 网络服务信息 测试命令 AT+QENG=? 响应 +QENG: (支持的范围) 设置命令 AT+QENG= OK 响应 当=0 时： +QENG: 0,,,,,[],[],[], [],,,[],[], [+QENG: 1,,,,,[…]] OK 当=1 时： +QENG: 2,,,,,,,,,,,,,, OK 当=2 时： +QENG: 3,,, OK 当=3 时： +QENG: 4,,,,< PLMN_type>, OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。请求的模块信息。 0 显示服务小区和邻区小区（若有）信息 1 仅当 Modem 处于 RRC-CONNECTED 状态时显示数据传输信息 2 显示 Tx/Rx 运行的总时长 整型。服务小区的 EARFCN。范围：0~262143。 整型。服务小区的 EARFCN 偏移量。 0 偏移 -2 1 偏移 -1 2 偏移 -0.5 3 偏移 0 4 偏移 1 整型。服务小区的物理小区识别码。范围：0~503。 字符串类型。4 字节（28 位）服务小区 ID；十六进制格式。 有符号整型。服务小区的 RSRP 值。可为负数；单位：dBm。 有符号整型。服务小区的 RSRQ 值。可为负数；单位：dB。 有符号整型。服务小区的 RSSI 值。可为负数；单位：dBm。 有符号整型。服务小区的最新 SINR 值。可为负数；单位：dB。 整型。当前服务小区频段。 上海移远通信技术股份有限公司 29 / 116 BC26&BC20 AT 命令手册 字符串类型。双字节跟踪区域码（TAC）；十六进制格式（例如，'00C3' 等 于十进制的 195）。 整型。服务小区的最新增强覆盖等级（ECL）值。范围：0~2。仅在 RRC 连接 状态下可用。 有符号整型。UE 的当前发射功率。可为负数；单位：cBm（0 cBm=1 mW）。 整型。服务小区的部署模式。 0 LTE 带内部署相同 PCI 1 LTE 带内部署不同 PCI 2 LTE 保护带部署 3 独立部署 整型。相邻小区的 EARFCN；范围：0~262143。 整型。相邻小区的 EARFCN 偏移量。 0 偏移 -2 1 偏移 -1 2 偏移 -0.5 3 偏移 0 4 偏移 1 整型。相邻小区的物理小区 ID；范围：0~503。 有符号整型。相邻小区的 RSRP 值。可为负数；单位：dBm。 整型。百分比值；范围：0~100。RLC 层的 UL 误块率（基于每次 ARQ）； 基于所有建立的 RLC AM 无线电承载计算；从成功建立/恢复 RRC 连接开始， 或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。百分比值；范围：0~100。RLC 层的 DL 误块率（基于每次 ARQ）； 基于所有建立的 RLC AM 无线电承载计算；从成功建立/恢复的 RRC 连接开始， 或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。百分比值；范围：0~100。UL-SCH 的 MAC 中的 UL 误块率（基于每次 HARQ）；从成功建立/恢复/重新建立 RRC 连接开始，或者自上一次执行 =1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。百分比值；范围：0~100。DL-SCH（不包括 BCCH）的 MAC 中的 DL 误块率（基于每次 HARQ）；从成功建立/恢复/重新建立 RRC 连接开始，或者 自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。在 UL-SCH 上传输/重传的传输块字节总数；基于所有 HARQ 传输和重 传中的 UL-SCH 计算得出；从成功建立/恢复/重新建立 RRC 连接开始，或者 自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单 位：字节。 整型。在 DL-SCH（不包括 BCCH）上传输/重传的传输块字节总数；从成功建 立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单位：字节。 整型。UL-SCH 上传输块的 HARQ 传输/重传总次数；从成功建立/恢复/ 重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。DL-SCH（不包括 BCCH）上传输块的 HARQ 传输/重传总次数； 从成功建立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 上海移远通信技术股份有限公司 30 / 116 BC26&BC20 AT 命令手册 整型。UL-SCH 上传输块的 HARQ 重传次数；从成功建立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计 算（以较晚者为准）。 整型。DL-SCH（不包括 BCCH）上传输块的 HARQ 重传次数；从成功建 立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。RLC 上行链路吞吐量；基于所有已建立的 RLC AM 无线承载进行 计算；从成功建立/恢复的 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单位：千字节/秒。 整型。RLC 下行链路吞吐量；基于所有已建立的 RLC AM 无线承载进行 计算；从成功建立/恢复的 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单位：千字节/秒。 整型。MAC 中针对 UL-SCH 的上行吞吐量。从成功建立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计 算（以较晚者为准）；单位：千字节/秒。 整型。MAC 中针对 DL-SCH（不包括 BCCH）的下行吞吐量；从成功建 立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单位：千字节/秒。 整型。本次启动后的睡眠持续总时间；单位：0.1 秒。 整型。本次启动后的 Rx 总时间；单位：0.1 秒。 整型。本次启动后的 Tx 总时间；单位：0.1 秒。 整型。指示 EMM 状态。 0 EMM 状态为 NULL 1 去注册态 2 已经找到合适的小区并发起注册 3 已经完成注册 4 正在执行去注册但未完成注册 5 已经发起 TAU 但未完成 TAU 6 已经发起服务请求但未完成 7 其它未知状态 整型。指示 Modem 侧的状态。 0 未知状态 1 空闲态 2 PSM 3 已连接 整型。指示 PLMN 的状态。 0 终端无网络且未搜网 1 正在搜网但未完成注册 2 已经注册成功 3 正在执行去注册过程，尚未完成，以及其它未知情况 整型。指示 PLMN 的类型。 0 EHPLMN 1 FPLMN 2 UPLMN 上海移远通信技术股份有限公司 31 / 116 BC26&BC20 AT 命令手册 3 OPLMN 4 其他类型 5 未知类型 字符串类型。以数字型显示当前的 PLMN。 整型。错误码。详细信息，请参阅第 12 章。 4.8. AT+QIPADDR 查询 UE 的 IP 地址 该执行命令返回 UE 的 IP 地址。 AT+QIPADDR 查询 UE 的 IP 地址 执行命令 响应 AT+QIPADDR +QIPADDR: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。UE 的 IP 地址。 举例 AT+QIPADDR +QIPADDR: fe80:0:0:0:3c:ffb8:f4c9:1207 +QIPADDR: 2001:14bb:170:4c91:3c: ffh8:f4c9:1207 +QIPADDR: 178.55.211.180 +QIPADDR: 127.0.0.1 OK 上海移远通信技术股份有限公司 32 / 116 BC26&BC20 AT 命令手册 5 PDN 和 APN 相关命令 5.1. AT+CGACT PDP 上下文激活/去激活 设置命令用于激活或去激活指定的 PDP 上下文。命令执行完成后，MT 保持 V.250 命令状态。若有 PDP 上下文已处于请求状态，那么该上下文状态保持不变；若 PDP 上下文请求失败，将返回 ERROR 或+CME ERROR。 在执行该命令激活 PDP 上下文时，如果 UE 没有附着 PS，则 UE 会先执行 PS 附着，然后尝试激活指 定的上下文。如果附着失败，则 MT 会响应错误；若使能了扩展错误响应（详见 AT+CMEE 命令使能扩展 错误响应），则会响应附着失败的错误消息。 对于 EPS 而言，如果尝试断开最后一条 PDN 连接，UE 将响应 ERROR；若使能了扩展错误响应，则 响应+CME ERROR。 EPS 承载资源激活请求由网络通过 EPS 专用承载激活请求或者 EPS 承载修改请求来响应。必须在 UE 接受此请求之后，方可建立 PDP 上下文。 如果未指定，则该命令将激活所有已定义的非紧急上下文，或去激活所有已激活的上下文。 查询命令返回所有定义的 PDP 上下文的当前激活状态。 测试命令返回所有支持的 PDP 上下文激活状态请求信息。 AT+CGACT PDP 上下文激活/去激活 测试命令 AT+CGACT=? 响应 +CGACT: (支持的列表) 查询命令 AT+CGACT? OK 响应 +CGACT: , +CGACT: , […] OK 上海移远通信技术股份有限公司 33 / 116 设置命令 AT+CGACT=, 最大响应时间 特性说明 响应 如果激活成功： OK 如果去激活成功： NO CARRIER 若出现任何错误： ERROR 或者 +CME ERROR: 150 秒，依赖于网络环境 / BC26&BC20 AT 命令手册 参数 整型。PDP 上下文激活状态。 0 去激活 1 激活 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义（详见 AT+CGDCONT 命令）。 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 对于 BC20、BC26 模块，该命令仅能激活 PDN 连接，但该 PDN 连接不能用于数据业务，如果需要 执行数据业务，请使用 AT+QCACT 激活 PDP 上下文。 2. 模块在启动时自动定义=1 的上下文。 举例 AT+CGACT=0,1 OK AT+CGACT? +CGACT: 1,0 OK AT+CGACT=? +CGACT: (0,1) OK 上海移远通信技术股份有限公司 34 / 116 BC26&BC20 AT 命令手册 5.2. AT+CGAPNRC APN 速率控制 设置命令返回指定上下文标识符的 APN 速率控制参数（请参阅《3GPP TS 24.008》）。 执行命令返回所有激活的 PDP 上下文的 APN 速率控制参数。 测试命令返回与已激活的辅助和非辅助 PDP 上下文相关的列表。 AT+CGAPNRC APN 速率控制 测试命令 AT+CGAPNRC=? 响应 +CGAPNRC: (已激活 PDP 上下文的列表) 设置命令 AT+CGAPNRC= OK 响应 +CGAPNRC: [,[,< uplink_time_unit>[,]]] OK 最大响应时间 特性说明 若出现任何错误：. ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义（详 见 AT+CGDCONT 命令）。 整型。表示当达到最大上行速率时是否允许发送额外异常报告。详 见《3GPP TS 24.008》子章节 10.5.6.3.2。 0 不允许在最大速率时发送其他异常上报 1 允许在最大速率时发送其他异常上报 整型。最大上行速率使用的时间单位。即《3GPP TS 24.008》子章 节 10.5.6.3.2.中规定的 APN 速率控制参数 IE 的第一组八位字节中 的第 1 位至第 3 位。 0 不受限 1 分钟 2 小时 3 天 上海移远通信技术股份有限公司 35 / 116 BC26&BC20 AT 命令手册 4 周 整型。每个上行时间单位内限制 UE 发送的最大消息数。详见《3GPP TS 24.008》子章节 10.5.6.3.2。 整型。错误码。详细信息，请参阅第 12 章。 5.3. AT+CGDCONT 定义 PDP 上下文 设置命令为 PDP 上下文（由（本地）上下文标识参数所标识）指定上下文参数。因为 PCO 可包 括需要加密的信息，所以该命令允许 TE 指定是否请求安全保护传输的 ESM 信息。UE 可能由于其他原因 而需要使用安全保护传输的 ESM 信息，如当 UE 需要传输 APN 时。测试命令返回已定义的 PDP 上下文的 数量。 对 EPS 而言，设置该命令后会建立 PDN 连接并建立相关的默认承载，参数应该省略。 此设置命令的一种特殊形式 AT+CGDCONT=，会直接删除对应的 PDP 上下文参数，使其 变成未定义。 查询命令返回每个已定义上下文的当前配置。 如果 UE 支持几种 PDP 类型，则将单独返回多行的参数值。 默认情况下，=1 的上下文在启动时就已经定义，因此，无需使用 AT+CGDCONT 命令创建。初 始 PDP 上下文具有制造商特定的默认设置，与 AT+CGDCONT 命令的任何默认配置无关。根据 AT+CIPCA 命令的设置，MT 成功注册到网络后会自动激活初始 PDP 上下文。如果所有已激活上下文都进行了去激活， 则可以重新创建初始 PDP 上下文。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT：(支持的范围),(支持的列表), (支持的范围),(支持的范围),(支持的列表),(支持的范围),(支持 的范围),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列 表) +CGDCONT：(支持的范围),(支持的列表), (支持的范围),(支持的范围),(支持的列表),(支持的范围),(支持 的范围),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列 表)[...] 查询命令 AT+CGDCONT? OK 响应 [+CGDCONT: ,,,,< d_comp>,[,[,[,[, [,[,[,[,[,]]]]]]]]]] +CGDCONT: ,,,,,[,[,[,[, [,[,[,[,[,]]]]]]]]]] [...] 设置命令 OK 响应 AT+CGDCONT=[,[,< APN>[,[,[,[,[,[,[,[,[,[,[,[,] ]]]]]]]]]]]]] OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 如果定义的已激活 PDN 连接，则参数配置深休眠唤醒 后有效；如果定义的未激活 PDN 连接，则参数配置深 休眠唤醒后无效。 参数 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义。该参数是 UE-TE 接口的 本地参数，用于其他与 PDP 上下文相关的命令。范围：1~15。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议（《IETF STD 5》） 'IPV6' 互联网协议版本 6 'IPV4V6' 引入虚拟来处理双栈 UE 功能 'NON-IP' 非 IP 类型 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。如果省略或为空，将请 上海移远通信技术股份有限公司 37 / 116 BC26&BC20 AT 命令手册 求默认值。可配置的最大 APN 长度为 99 字节。值为空或值省略时，将请求订阅值。 字符串类型。用于标识适用于 PDP 的地址空间中的 UE。如果该值为空或被省略，则 TE 在 PDP 启动过程中提供该值，否则，将请求动态地址。即使在 PDP 启动过程中已 经分配了地址，查询命令中此值的返回值仍将是空字符串。可以使用 AT+CGPADDR 命令读取分配的地址。 整型。控制 PDP 数据的压缩方式。 0 关闭 1 打开（用户优选的压缩方式） 2 V.42bis 3 V.44 整型。控制 PDP 头部数据的压缩方式。 0 关闭 1 打开 2 RFC 1144 （仅适用于 SNDCP） 3 RFC 2507 4 RFC 3095[ROHC]（仅适用于 PDCP） 整型。控制 MT/TA 请求获取 IPv4 地址信息的方式。 0 通过 NAS 信令分配 IPv4 地址 1 通过 DHCP 分配 IPv4 地址 整型。PDP 上下文激活请求的类型。请参阅《3GPP TS 24.301》子章节 6.5.1.2 和 《3GPP TS 24.008）子章节 10.5.6.17。如果支持初始 PDP 上下文，则不允许为紧 急承载服务分配=0。根据《3GPP TS 24.008》（子章节 4.2.4.2.2 和 4.2.5.1.4） 以及《3GPP TS 24.301》（子章节 5.2.2.3.3 和 5.2.3.2.2），必须为紧急承载服务 建立单独的 PDP 上下文。 如果紧急承载服务的 PDP 上下文是唯一激活的上下文，则只允许紧急呼叫（请参 阅《3GPP TS 23.401》子章节 4.3.12.9）。 0 PDP 上下文用于建立新的 PDP 上下文或从非 3GPP 接入网进行切换（具 体由 MT 根据实际执行情况决定） 1 PDP 上下文用于紧急承载服务 2 PDP 上下文用于建立新的 PDP 上下文 3 PDP 上下文用于从非 3GPP 接入网进行切换 整型。影响 MT/TA 如何请求获取 P-CSCF 地址（详见《3GPP TS 24.229》 附录 B 和附录 L）。 0 不受 AT+CGDCONT 命令影响获取 P-CSCF 地址 1 通过 NAS 信令获取 P-CSCF 地址 2 通过 DHCP 获取 P-CSCF 地址 整型。向网络指示 PDP 上下文是否仅用于与 IM CN 子系统相关的信令。 0 UE 指示 PDP 上下文并非仅用于与 IM CN 子系统相关的信令 1 UE 指示 PDP 上下文仅用于与 IM CN 子系统相关的信令 整型。为 PDP 上下文请求的 NAS 信令的优先级。MT 使用《3GPP TS 24.301》和《3GPP TS 24.008》中指定的 NSLPI 信息。 0 使用 MT 中配置的低优先级指示符的值激活 PDP 上下文 1 使用低优先级指示符'未为 NAS 信令低优先级配置 MS'的值 激活 PDP 上下文。 上海移远通信技术股份有限公司 38 / 116 BC26&BC20 AT 命令手册 整型。指定是否请求 PCO 的安全保护传输（仅适用于 EPS）。 0 不请求对 PCO 进行安全保护传输 1 请求对 PCO 进行安全保护传输 整型。影响 MT/TA 如何请求获取 IPv4 MTU 大小，请参阅《3GPP TS 24.008》子章节 10.5.6.3。 0 不受 AT+CGDCONT 命令影响获取 IPv4 MTU 大小 1 通过 NAS 信令获取 IPv4 MTU 大小 整型。指示终端是否支持传输流模板的本地 IP 地址。 0 不支持 1 支持 整型。影响 MT/TA 如何请求获取 Non-IP MTU 大小，请参考《3GPP TS 24.008》子章节 10.5.6.3。 0 不受 AT+CGDCONT 影响的 Non-IP MTU 大小获取 1 通过 NAS 信令获取 Non-IP MTU 大小 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 最多可同时激活 3 个 PDP 上下文。 2. 对于 EPS 而言，可省略参数。 3. Modem 协议不支持以下参数： ⚫ ⚫ ⚫ ⚫ ⚫ ⚫ ⚫ 举例 AT+CGDCONT=? +CGDCONT: (1-15),'IP',,,(0-2),(0-4),(0),,,,,,(0,1),,(0,1) +CGDCONT: (1-15),'IPV6',,,(0-2),(0-4),(0),,,,,,(0,1),,(0,1) +CGDCONT: (1-15),'IPV4V6',,,(0-2),(0-4),(0),,,,,,(0,1),,(0,1) +CGDCONT: (1-15),'Non-IP',,,(0-2),(0-4),(0),,,,,,(0,1),,(0,1) OK AT+CGDCONT=1,'IP','CMNET' OK AT+CGDCONT? +CGDCONT: 1,'IP','CMNET','',0,0,0,,,,,,0,,0 上海移远通信技术股份有限公司 39 / 116 BC26&BC20 AT 命令手册 OK 5.4. AT+CIPCA 初始 PDP 上下文激活 设置命令控制是否使能不带 PDN 连接的附着。=1 时，EPS 附着过程将不携 带 PDN 连接建立请求。 查询命令返回命令的当前设置。 AT+CIPCA 初始 PDP 上下文激活 测试命令 AT+CIPCA=? 响应 +CIPCA: (支持的列表),(支持的 列表) 查询命令 AT+CIPCA? OK 响应 +CIPCA: [,] OK 设置命令 AT+CIPCA=, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。附着后激活 PDP 上下文。 3 当前设置无变化 上海移远通信技术股份有限公司 40 / 116 BC26&BC20 AT 命令手册 整型。带有或不带 PDN 连接的 EPS 附着。 0 带有 PDN 连接的 EPS 附着 1 不带 PDN 连接的 EPS 附着 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CIPCA=3,1 OK AT+CIPCA? +CIPCA: 3,1 OK AT+CIPCA=? +CIPCA: (3),(0,1) OK 5.5. AT+QCGDEFCONT 配置默认的 APN/PDN 连接 设置命令用于配置开机时 PDN 连接的 PSD 连接设置。当连接到 NB-IoT 网络时，必须执行 PDN 连接 设置。 AT+QCGDEFCONT 配置默认的 APN/PDN 连接 测试命令 AT+QCGDEFCONT=? 响应 +QCGDEFCONT: (支持的列表) 查询命令 AT+QCGDEFCONT? OK 响应 +QCGDEFCONT: ,[[[],],] 设置命令 AT+QCGDEFCONT=[,[,[,password]]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 41 / 116 BC26&BC20 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 字符串类型。指定分组数据协议的类型。 'IP' 互联网协议（《IETF STD 5》） 'IPV6' 互联网协议版本 6（《IETF RFC 2460》） 'IPV4V6' 双栈（请参阅《3GPP TS 24.301》） 'Non-IP' 将非 IP 数据传输到外部分组网络（请参阅《3GPP TS 24.301》） 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。可配置的 APN 最大长 度为 99 个字节。如果该值为空或省略，则将请求订阅值。 字符串类型。接入 IP 网络的用户名。 字符串类型。接入 IP 网络的密码。 整型。错误码。详细信息，请参阅第 12 章。 5.6. AT+QGACT 激活/去激活 PDN 上下文 设置命令用于激活或去激活指定的 PDN 上下文。 PDN 上下文激活和去激活请求均有三种响应结果： ⚫ 如果 PDN 上下文处于激活/去激活状态，则立即响应+QGACT: ,,[,]OK； ⚫ 如果 PDN 上下文未处于激活/去激活状态，则先响应 +QGACT: OK，随后上报 激活/去激活结果 URC +QGACT: ,,[,]； ⚫ 如果发生任何错误，如参数无效，则立即返回 ERROR 或返回 URC+CME ERROR: 。 仅在激活请求的结果 URC 中返回。另外，当被动去激活发生时才上报 URC +QGACT: ,。 对于激活请求，设置命令的格式为 AT+QGACT=,,[,,[, [,]]；而对于去激活请求，设置命令的格式为 AT+QGACT=,。命令的 一般格式为 AT+QGACT: ,[,[,,[,[,]]]]。 上海移远通信技术股份有限公司 42 / 116 BC26&BC20 AT 命令手册 AT+QGACT 激活/去激活 PDN 上下文 设置命令 AT+QGACT=,[,[,,[,<bearer_ty 响应 如果 PDN 上下文已处于激活/未激活状态： +QGACT: ,,[,[,]]]] e>] OK 如果 PDN 上下文未处于激活/去激活状态： +QGACT: OK +QGACT: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。去激活/激活请求。 0 去激活 1 激活 整型。要激活的 PDP 类型。 1 IPv4 2 IPv6 3 IPv4v6 4 Non-IP 整型。PDP 上下文标识符，用于指定特定 PDP 上下文（详见 AT+CGDCONT 命令）。 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。如果省略或 为空，将请求默认值。可配置的最大 APN 长度为 99 字节。值为空或值省略时， 将请求订阅值。激活时必须配置，去激活时应省略。 字符串类型。接入 IP 网络的用户名；激活时必须配置，去激活时应省略。 字符串类型。访问 IP 网络的密码；激活时必须配置，去激活时应省略。 整型。要激活的承载类型；激活时可选配，去激活时应省略。 上海移远通信技术股份有限公司 43 / 116 BC26&BC20 AT 命令手册 1 NB-IoT（目前仅支持 NB-IoT） 整型。要使用的 USIM 卡的 ID；激活时可选配，去激活时应省略。 1 USIM 卡 1（当前仅支持 USIM 卡 1） 整型。 0 去激活的结果/URC 1 激活的结果/URC 2 被动去激活的 URC 整型。激活/去激活的结果。 0 失败 1 成功 整型。实际激活的 PDP 类型。 1 IPv4 2 IPv6 3 IPv4v6 4 Non-IP 整型。错误码。详细信息，请参阅第 12 章。 备注 模块注册到网络后，将自动建立默认的 PDN 连接（=1）。 举例 AT+QGACT=1,1,'apn','','' +QGACT: 1 OK +QGACT: 1,1,1,1 AT+QGACT=0,1 +QGACT: 1 OK +QGACT: 1,0,1 //激活 PDN 上下文。 //如无错误，立即返回 OK。 //通过 URC 通知激活结果。 //去激活 PDN 上下文。 //如无错误，立即返回 OK。 //通过 URC 通知去激活结果。 上海移远通信技术股份有限公司 44 / 116 BC26&BC20 AT 命令手册 6 其他网络命令 6.1. AT+CCIOTOPT CloT 优化配置 设置命令设置 UE 在 ATTACH REQUEST 和 TRACKING AREA UPDATE REQUEST 消息中指示所支 持和优先选择的 CIoT EPS 优化配置。该命令还允许上报网络支持的 CIoT EPS 优化。支持 CIoT 功能的 UE 可以同时支持或单独支持控制面（control plane）或用户面（user plane）的 CIoT EPS 优化（请参阅 《3GPP TS 24.301》子章节 9.9.3.34）。基于应用特性，UE 可能优先选择注册用于控制面的 CIoT EPS 优化配置或用于用户面的 CIoT EPS 优化配置（请参阅《3GPP TS 24.301》子章节 9.9.3.0B）。 设置命令还用于控制 URC +CCIOTOPTI 的显示。URC +CCIOTOPTI: 用 于指示网络所支持的 CIoT EPS 优化配置。 查询命令返回当前支持和优先选择的 CIoT EPS 优化配置，以及 URC +CCIOTOPTI 的当前状态。 AT+CCIOTOPT CloT 优化配置 测试命令 AT+CCIOTOPT=? 响应 +CCIOTOPT: (支持的范围),(支持的范围),(支持的范围) 查询命令 AT+CCIOTOPT? OK 响应 +CCIOTOPT: ,, 设置命令 AT+CCIOTOPT=[,[,]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；保存至 NVRAM（需先执行 AT&W）。 上海移远通信技术股份有限公司 45 / 116 BC26&BC20 AT 命令手册 参数 整型。启用/禁用 URC +CCIOTOPTI 的上报。 0 禁用 1 启用 URC 上报，+CCIOTOPTI: 2 禁用上报并将 CIoT EPS 优化参数重置为默认值 整型。UE 支持的 CIoT EPS 优化方案。 1 支持控制面 CIoT EPS 优化 3 支持控制面和用户面 CIoT EPS 优化 整型。UE 优先选择的 CIoT EPS 优化配置。 0 无优先级 1 优先控制面 CIoT EPS 优化 2 优先用户面 CIoT EPS 优化 整型。网络所支持的 CIoT EPS 优化方案。 0 不支持 1 支持控制面 CIoT EPS 优化 2 支持用户面 CIoT EPS 优化 3 同时支持控制面和用户面 CIoT EPS 优化方案 整型。错误码。详细信息，请参阅第 12 章。 6.2. AT+COPS PLMN 选择 用于选择是自动入网还是手动选择指定的 PLMN 入网。使用手动模式时，如果所选的 PLMN 不可用，则不得选择其他任何运营商（=4 除外）。如果所选的接入技术不可用，则应在其 他接入技术中选择同一运营商。所选运营商名称的格式也应适用于查询命令 AT+COPS?。=2 强制 尝试注销网络。所选模式会影响后续所有网络的注册（例如，设置=2 之后，只有在设置=0 或 1 时 MT 才会注册网络）。 查询命令返回当前模式、当前所选运营商和当前接入技术。如果未选择任何运营商，则不会返回 、和。 测试命令返回五个参数的集合，每个参数表示网络中的一个运营商。所述参数集合包含指示当前运营 商是否可用的整型参数、运营商的数字编码、接入技术的数字编码、注册模式 及运营商名称的格式 。以上参数可能不可用，不可用时为空字段。运营商列表的顺序应为： EH/HPLMN、UPLMN、OPLMN 和其他 PLMN。 选择接入技术的参数仅应用于能够注册多种接入技术的终端。的选择不会限制小区重选 的能力，即使已经尝试选择一种接入技术，移动设备也可以在其他接入技术中重选小区。 AT+COPS PLMN 选择 测试命令 AT+COPS=? 响应 +COPS: [支持的(,全称,简称, 上海移远通信技术股份有限公司 46 / 116 BC26&BC20 AT 命令手册 数字代号[,])列表][,,(支持的范围),(支持的列表)] OK 查询命令 AT+COPS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS: [,,][,] OK 设置命令 AT+COPS=[,[,[ ,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 900 秒 特性说明 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。注册模式。 0 自动模式（忽略字段） 1 手动搜网模式（应出现字段） 2 手动注销网络 3 仅设置，不在查询命令中显示 4 手动/自动选择。如果手动选择失败，则进入自动搜网模式（=0） 整型。运营商名词的格式，由的格式配置。 2 数字格式 字符串类型。运营商的数字编码。指示此参数是否为数字格式。数字格式是 NB-IoT 网络位置区域标识号，它由三个 BCD 码 ITU-T 国家/地区代码，以及两个或三个 BCD 数字 网络代码（用于特定管理）组成。当=0 时，字段不存在。 整型。当前运营商网络是否可用。 上海移远通信技术股份有限公司 47 / 116 BC26&BC20 AT 命令手册 0 未知网络 1 可用网络 2 当前选择的网络 3 禁止选择的网络 整型。接入技术。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 仅在模块处于空闲状态时才能执行测试命令，否则将返回错误（ERROR 或者+CME ERROR: ）。 2. 仅当模块处于空闲状态或已插入 USIM 卡的注销状态时才能执行设置命令，否则将返回错误（ERROR 或者+CME ERROR: ）。 3. 该命令只有在网络注册成功时，才会返回 OK。 举例 AT+COPS=0 OK AT+COPS? +COPS: 0,2,'46000',9 OK 6.3. AT+QBAND 查询/设置工作频段 设置命令用于查询当前注册的频段或设置要锁定的频段。 AT+QBAND 查询/设置工作频段 测试命令 AT+QBAND=? 响应 +QBAND: (支持的范围),[(支持的列表)] 查询命令 AT+QBAND? OK 响应 +QBAND: OK 上海移远通信技术股份有限公司 48 / 116 BC26&BC20 AT 命令手册 设置命令 AT+QBAND=[, [,[,…]]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。频段个数。 0 所有频段 1-16 频段个数 整型。NB-IoT 频段。有效值：1、3、5、8、20 等；见备注。 整型。当前锁定的频段。有效值：1、3、5、8、20 等；见备注。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QBAND=? +QBAND: (0-5),(1,3,5,8,20) OK AT+QBAND=1,5 OK AT+QBAND? +QBAND: 5 OK //查询模块支持的频段列表。 //设置要使用的频段。 //查询设置的频段。 上海移远通信技术股份有限公司 49 / 116 BC26&BC20 AT 命令手册 备注 BC20 和 BC26 模块所支持的具体频段信息，请参阅相应的模块产品规格书。根据采购编码的不同，各模 块可能支持不同的 NB-IoT 频段；请通过 AT+QBAND=?查询当前模块所支持的频段信息。 6.4. AT+QBANDSL 设置优先搜索的频段列表 设置命令用于设置优先搜索的频段列表。列表中频段的搜索顺序依赖于设置的顺序，最多仅支持设置 4 个优先搜索的频段。该命令设置的优先搜索的频段不会影响根据 USIM 卡匹配到的优先频段。 AT+QBANDSL 设置优先搜索的频段列表 设置命令 响应 AT+QBANDSL=[,,[,[,[,]]]] OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。启用/禁用设置优先搜索的频段列表。 0 禁用 1 启用 整型。需要优先搜索的频段数量。有效值：1、2、3、4。 整型。优先搜索的频段。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QBANDSL=1,2,8,3 OK //设置优先搜索的频段为 B8 和 B3。 上海移远通信技术股份有限公司 50 / 116 BC26&BC20 AT 命令手册 6.5. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表 执行命令用于清除 UE 存储的 EARFCN 列表。 AT+QCSEARFCN 清除 NB-loT 存储的 EARFCN 列表 执行命令 响应 AT+QCSEARFCN +QCSEARFCN: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。EARFCN 清除结果。 0 成功 2 失败 3 无记忆频点 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QCSEARFCN +QCSEARFCN: 0 OK 6.6. AT+QEMMTIMER 启用/禁用 EMM 定时器 URC 上报 该命令用于启用/禁用 EMM 层相关定时器（Timer）的 URC 上报。当启用 URC 上报时，模块在对应 的定时器启动、超时或停止时，会上报 URC 以指示当前的定时器状态，并能够在定时器停止时，指示定时 器剩余的时间。URC 上报格式为+QEMMTIMER: ,,,。 关于定时器详细作用与触发事件作用，请参考《3GPP TS 24.301》。 上海移远通信技术股份有限公司 51 / 116 BC26&BC20 AT 命令手册 AT+QEMMTIMER 启用/禁用 EMM 定时器 URC 上报 设置命令 响应 AT+QEMMTIMER= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。启用/禁用 URC。 0 禁用 URC： +QEMMTIMER: ,,, 1 启用 URC： +QEMMTIMER: ,,, 整型。Backoff 定时器标识。 0 BI 1 T3412_EXT 2 T3448 3 T3346 4 T3247 5 T3396 整型。指示对应定时器发生的事件。 0 启动定时器 1 停止定时器 2 定时器超时 3 去使能定时器，仅适用于 T3346 和 T3396。 整型。定时器的时间。单位：毫秒。 整型。定时器停止时剩余的时间。单位：毫秒。 整型。错误码。详细信息，请参阅第 12 章。 上海移远通信技术股份有限公司 52 / 116 BC26&BC20 AT 命令手册 6.7. AT+QLEDMODE 配置网络状态指示灯 该命令用于配置网络状态指示灯（NETLIGHT）。 AT+QLEDMODE 配置网络状态指示灯 测试命令 AT+QLEDMODE=? 响应 +QLEDMODE: (支持的列表) 查询命令 AT+QLEDMODE? OK 响应 +QLEDMODE: 设置命令 AT+QLEDMODE= OK 响应 OK 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: / 参数 整型。启用/禁用网络状态指示灯。 0 禁用 1 启用 整型。错误码。详细信息，请参阅第 12 章。 备注 当禁用网络状态指示灯（NETLIGHT）时，网络灯常灭。当启用网络状态指示灯时，模块网络灯状态如下 所示： ⚫ NETLIGHT 电平状态为持续低电平（灯灭）：模块未运行或处于 Idle/PSM 状态。 ⚫ NETLIGHT 电平状态为高电平 64 ms（灯亮）/低电平 800 ms（灯灭）：模块处于搜网状态。 ⚫ NETLIGHT 电平状态为高电平 64 ms（灯亮）/低电平 2000 ms（灯灭）：模块已连接到网络。 举例 AT+QLEDMODE=1 OK 上海移远通信技术股份有限公司 53 / 116 BC26&BC20 AT 命令手册 AT+QLEDMODE=? +QLEDMODE: (0,1) OK 6.8. AT+QLOCKF 锁定 NB-IoT 频点及 PCI 设置命令用于将 UE 锁定到特定的频点（EARFCN）和小区。当取值大于 503 时将会返回错误， 当取值小于 0 或为非整型值时，则忽略该参数。 AT+QLOCKF 锁定 NB-IoT 频点及 PCI 测试命令 响应 AT+QLOCKF=? 查询命令 OK 响应 AT+QLOCKF? 设置命令 解除 NB-IoT 频点锁定（=0） AT+QLOCKF= OK 响应 OK 若出现任何错误： ERROR 或者 设置命令 锁定 NB-IoT 频点（=1） AT+QLOCKF=,[,][,] +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 设置命令 设置优先频点（=2） AT+QLCOKF=,,,[,EARFCN] … +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 上海移远通信技术股份有限公司 54 / 116 BC26&BC20 AT 命令手册 参数 整型。设置频点。 0 解除锁定 1 锁定 2 设置优先频点 整型。请求锁定的 EARFCN。范围：0~262143，0 表示解除 EARFCN 和 小区的任何锁定。 整型。请求的 EARFCN 偏移量。 0 偏移 -2 1 偏移 -1 2 偏移 -0.5 3 偏移 0 4 偏移 1 整型。物理小区识别码；取值范围：0~503。 字符串类型。PLMN。 整型。要设置的频点的数量。范围：1~8。 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 设置命令需要在 AT+CFUN=0 的状态下执行。 2. 当设置=2 时，当前支持的范围为 0~65535。 3. 由于=2 设置的是下行载波频点，因此，需要注意设置有效的下行频点才能生效。 举例 AT+QLOCKF=2,'46011',1,2508 OK 上海移远通信技术股份有限公司 55 / 116 BC26&BC20 AT 命令手册 7 USIM 相关命令 7.1. AT+CIMI 查询 IMSI 该命令用于查询(U)SIM 卡的国际移动用户识别码（IMSI，无双引号的字符串）。IMSI 允许 TE 识别连 接到 MT 的 USIM。 AT+CIMI 查询 IMSI 测试命令 AT+CIMI=? 执行命令 AT+CIMI 响应 OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。USIM 卡的 IMSI（国际移动用户识别码）。 整型。错误码。详情参见第 12 章。 举例 AT+CIMI 460001357924680 OK 上海移远通信技术股份有限公司 56 / 116 BC26&BC20 AT 命令手册 7.2. AT+CLCK 设备锁定 该命令用于锁定、解锁 MT 或者网络功能，以及查询锁定状态。通常需要密码才能执行此类操作。查 询网络服务的状态（=2）时，仅在所有的服务均未激活时，才会响应未激活（=0）。 设置或查询时，该命令可被中断。 AT+CLCK 设备锁定 测试命令 AT+CLCK=? 响应 +CLCK: (支持的列表) OK 设置命令 AT+CLCK=,[,[, ]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当=0 或 1 且命令执行成功： OK 当=2 且命令执行成功： +CLCK: [,] [+CLCK: ,] [...] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 字符串类型。网络设备。 'PS' PH-SIM（将 UE 锁定到当前所选卡槽中插入的 USIM 卡。当插入当前 USIM 卡以外的其他设备时，MT 将查验密码；插入 MT 已记忆的使用过的卡时，无需 密码） 'SC' USIM 卡（锁定当前所选卡槽中插入的 USIM 卡。USIM 在 MT 启动以及执行 上海移远通信技术股份有限公司 57 / 116 BC26&BC20 AT 命令手册 设备锁定命令时查验密码） 'PN' 网络个性化（请参阅《3GPP TS 22.022》） 'PU' 'PP' 网络子集个性化（请参阅《3GPP TS 22.022》） 服务提供商个性化（请参阅《3GPP TS 22.022》） 'PC' 企业个性化（请参阅《3GPP TS 22.022》） 整型。操作模式。 0 解锁 1 锁定 2 查询状态 字符串类型。密码。应与通过 MT 用户界面为设备指定的密码相同，或与通过 AT+CPWD 设置的密码相同。 整型。数据类别或运算格式。默认值：7。 1 语音（电话） 2 数据（指所有承载服务；如果 TA 不支持值 16、32、64 和 128，则=2 可 能仅指某些承载服务。） 4 传真（传真服务） 7 语音、数据和传真 8 短消息 16 数据电路同步 32 数据电路异步 64 专用数据包访问 128 专用 PAD 访问 整型。设备状态。 0 未锁定 1 已锁定 整型。错误码。详情参见第 12 章。 备注 部分模块版本仅支持='SC'，请联系移远通信技术支持获取详细信息。 举例 AT+CLCK='PN',2 +CLCK: 0 OK 上海移远通信技术股份有限公司 58 / 116 7.3. AT+CPIN PIN 管理 BC26&BC20 AT 命令手册 AT+CPIN PIN 管理 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 TA 返回字母数字字符串，指示是否需要密码： +CPIN: 设置命令 AT+CPIN=[,][,] OK 响应 使用之前，TA 必须已存储密码，如 SIM PIN、SIM PUK、 PH-SIM PIN 等。如果需要输入两次 PIN，则 TA 将自动重 复 PIN。如果没有待处理的 PIN 请求，则不会采取任何措施， 并将返回错误消息+CME ERROR 给 TE。 如果所需的 PIN 为 SIM PUK 或 SIM PUK2，则需输入第二 个，用于替换 USIM 中的旧 PIN。 设置新密码时，也可以指定第三个参数。将第三个参数与新 密码进行对比，检查是否相同，以此作为额外的安全功能。 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 字符串类型。需要的密码类型。 READY MT 无密码输入请求 SIM PIN MT 正在等待 USIM PIN SIM PUK MT 正在等待 USIM PUK PH_SIM PIN MT 正在等待电话到 USIM 卡的密码（防盗） PH_NET PIN 需要网络个性化密码 PH_NETSUB PIN 需要网络子集 PH_SP PIN 需要服务提供商的个性化密码 上海移远通信技术股份有限公司 59 / 116 BC26&BC20 AT 命令手册 PH_CORP PIN 需要企业个性化密码 SIM PIN2 MT 正在等待提供 USIM PIN 2；仅当上个命令返回+CME E R R OR: 17 时才会需要 PIN2 SIM PUK2 MT 正在等待提供 USIM PUK 2；仅当上个命令返回+CME ERR OR: 18 时才会需要 PUK2 字符串类型。密码。 字符串类型。如果所需的 PIN 为 SIM PUK 或 SIM PUK2，则为新密码。 整型。错误码。详情参见第 12 章。 举例 AT+CPIN? +CPIN: READY OK 7.4. AT+CPINR 剩余 PIN 重试次数 该命令用于查询剩余 PIN 重试次数，通过+CPINR: ,[,]返回。 若设置命令中省略，返回所有的信息。 返回值中为可选参数，依而定。 AT+CPINR 剩余 PIN 重试次数 测试命令 AT+CPINR=? 设置/执行命令 AT+CPINR[=] 响应 OK 响应 [+CPINR: ,[,]] [+CPINR: ,[,]] […] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 60 / 116 BC26&BC20 AT 命令手册 参数 字符串类型。所选的 PIN 类型。 整型。每个 PIN 剩余重试次数。 整型。每个 PIN 默认重试次数。 字符串类型。PIN 类型。取值为 AT+CPIN 的中除了'READY'外其他的 有效取值。 整型。错误码。详情参见第 12 章。 举例 AT+CPINR +CPINR: 'SIM PIN',3,3 +CPINR: 'SIM PUK',10,10 +CPINR: 'SIM PIN2',3,3 +CPINR: 'SIM PUK2',10,10 OK 7.5. AT+CPLS 选择优先 PLMN 列表 该命令用于在 USIM 中选择一个包含接入技术的 PLMN 列表，所选择的列表将用于配置优先网络列表 AT+CPOL。 设置命令在 USIM 中选择一个列表。 查询命令返回 USIM 中已选的 PLMN 列表。 测试命令返回 USIM 中支持的 PLMN 列表范围。 AT+CPLS 选择优先 PLMN 列表 测试命令 AT+CPLS=? 响应 +CPLS: (支持的范围) OK 查询命令 若出现任何错误： ERROR 或者 +CME ERROR: 响应 上海移远通信技术股份有限公司 61 / 116 BC26&BC20 AT 命令手册 AT+CPLS? 设置命令 AT+CPLS= 最大响应时间 特性说明 +CPLS: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。选择优先 PLMN 列表。 0 用户优选 PLMN 列表（EFPLMNwAcT）；若未在 USIM 中找到 EFPLMNwAcT， 则为 PLMN 优选列表 EFPLMNsel（此文件仅在 USIM 卡中可用） 1 运营商优选 PLMN 列表（EFOPLMNwAcT） 2 归属地优选 PLMN 列表（EFHPLMNwAcT） 整型。错误码。详情参见第 12 章。 举例 AT+CPLS? +CPLS: 1 OK 7.6. AT+CPOL 配置优先网络列表 该命令用于编辑 USIM 卡中通过 AT+CPLS 选择的网络列表。 设置命令向 USIM 卡的优先 PLMN 列表中写入通过 AT+CPLS 选择的网络列表。如果之前未选择过任 何列表，则默认为用户优选 PLMN 列表（EFPLMNwAcT）。 上海移远通信技术股份有限公司 62 / 116 BC26&BC20 AT 命令手册 查询命令返回 USIM 卡的优先 PLMN 列表中所有使用过的通过 AT+CPLS 选择的网络列表，并显示每 个 PLMN 使用的访问技术。 测试命令返回 USIM 支持的索引范围和网络名称格式。 AT+CPOL 配置优先网络列表 测试命令 AT+CPOL=? 响应 +CPOL: (支持的范围),(支持的列表) OK 查询命令 AT+CPOL? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+CPOL: ,,[,,,,,]] [+CPOL: ,,[,,,,<E-UTRAN_AcT 2,>]] [...]] 设置命令 AT+CPOL= OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 上海移远通信技术股份有限公司 63 / 116 BC26&BC20 AT 命令手册 参数 整型。USIM 卡上 PLMN 的顺序。范围：1~80。 字符串类型。运营商名称。 整型。的格式。 2 数字格式 整型。GSM 访问技术的选择状态。 0 访问技术未选中 1 访问技术已选中 整型。GSM 压缩访问技术的选择状态。 0 访问技术未选中 1 访问技术已选中 整型。UTRAN 访问技术的选择状态。 0 访问技术未选中 1 访问技术已选中 整型。E-UTRAN 访问技术的选择状态。 0 未访问技术未选中 1 访问技术已选中 整型。NG-RAN 访问技术的选择状态。 0 访问技术未选中 1 访问技术已选中 整型。错误码。详情参见第 12 章。 备注 1. MT 也可以在选择新网络时自动使用用户优选 PLMN 列表（EFPLMNwAcT）。 2. 仅 当 向 先 前 已 验 证 的 USIM 中 写 入 接 入 条 件 时 ， 才 可 以 写 入 运 营 商 优 选 PLMN 列 表 （EFOPLMNwAcT）。 3. 目前仅支持=2。 7.7. AT+CPWD 修改密码 该命令用于修改 AT+CLCK 定义的设备锁定密码。 测试命令返回当前可用设备及对应密码最大长度的组合列表。 AT+CPWD 修改密码 测试命令 AT+CPWD=? 响应 +CPWD: 支持的(,)列表 若出现任何错误： 上海移远通信技术股份有限公司 64 / 116 BC26&BC20 AT 命令手册 设置命令 AT+CPWD=,, 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 字符串类型。 'P2' 'PS' USIM PIN2 PH-SIM（将电话锁定到当前所选卡槽中插入的 USIM 卡。当插入 当前 USIM 卡以外的其他设备时，MT 将查验密码；插入 MT 已记忆 的使用过的卡时，无需密码。） 'SC' USIM 卡（锁定当前所选卡槽中插入的 USIM 卡。USIM 在 MT 启 动以及执行设备锁定命令时查验密码。） 'PN' 'PU' 'PP' 'PC' 网络个性化（请参阅《3GPP TS 22.022》） 网络子集个性化（请参阅《3GPP TS 22.022》） 互联网服务供应商个性化（请参阅《3GPP TS 22.022》） 企业个性化（请参阅《3GPP TS 22.022》） 字符串类型。旧密码。必须与从 MT 用户界面为设备指定的密码相 同，或与 AT+CPWD 中设置的密码相同；密码的最大长度通过 确定。 字符串类型。新密码。的最大长度通过确定。 整型。设备密码的最大长度。单位：字节。 整型。错误码。详情参见第 12 章。 7.8. AT+CRSM USIM 卡受限访问 该命令提供对 USIM 数据库的简单而有限的访问，用于向 MT 传输 USIM 命令序号()及其 所需的参数。 AT+CRSM USIM 卡受限访问 上海移远通信技术股份有限公司 65 / 116 BC26&BC20 AT 命令手册 测试命令 AT+CRSM=? 响应 OK 设置命令 AT+CRSM=[,[,,, [,][,]]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CRSM: ,[,] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 参数配置不保存至 NVRAM。 参数 ,, , 字符串类型。USIM 命令。 176 读取二进制文件 178 读取记录内容 192 获取响应 214 更新二进制文件 220 更新记录内容 242 查询状态 整型。USIM 卡上基本数据文件标识符。除'查询状态'命令外，必须包含此参数。 整型。由 MT 传送给 USIM 的参数，除'获取响应'及'查询状态'命令外，其他 命令均需包含此参数（请参阅《3GPP TS 51.011》）。 字符串类型。待写入到 USIM 卡的信息，格式为十六进制。 字符串类型。UICC 中 EF 文件的路径，格式为十六进制。 整型。来自 USIM 关于实际命令执行的信息。无论命令执行成功或失败，均会返回。 字符串类型。成功执行命令的响应，格式为十六进制。'获取响应'及'查询状态' 命令将响应数据信息，提供当前的基本数据字段；该信息包括文件的类型和大小（参 见《3GPP TS 51.011》，《3GPP TS 31.102》）。若成功执行'读取二进制文件' 或'读取记录内容'命令，则响应所请求的数据。执行'更新二进制文件'和'更 新记录内容'命令，不会响应，只返回 OK。 整型。错误码。详情参见第 12 章。 上海移远通信技术股份有限公司 66 / 116 BC26&BC20 AT 命令手册 举例 AT+CRSM=176,28512,0,0,0 +CRSM: 144,0,'FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFF FFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000F FFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF000 0FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0 000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFF F0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFF FFF0000FFFFFF0000FFFFFF0000FFFFFF0000FFFFFF0000FF' OK 7.9. AT+QCCID USIM 卡识别 该命令用于读取 USIM 卡的 ICCID。若无 USIM 卡或者 USIM 卡不可读，则不返回任何数据。 AT+QCCID 执行命令 AT+QCCID USIM 卡识别 响应 +QCCID: 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。USIM 卡识别号（集成电路卡识别码）。 举例 AT+QCCID +QCCID: 89860317482035195410 OK 上海移远通信技术股份有限公司 67 / 116 BC26&BC20 AT 命令手册 8 功耗相关命令 8.1. AT+CEDRXS eDRX 设置 设置命令用于配置 UE 的 eDRX 参数，即 UE 是否使用 eDRX 以及为指定访问技术请求的 eDRX 周期。 当=2 且网络提供的 eDRX 参数发生变化时，设置命令用于控制 URC +CEDRXP: [,[,[,]]]的上报。 AT+CEDRXS=3 为该命令的一种特殊形式，用于禁用 eDRX 并清除 AT+CEDRXS 的所有参数配置（若 参数有默认值，则将其恢复为默认值）。 查询命令返回的当前配置。 测试命令返回支持的列表、接入技术类型列表以及请求的 eDRX 周期列表。 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的范围),(支持的列表), (支持的列表) 查询命令 AT+CEDRXS? OK 响应 +CEDRXS: , [+CEDRXS: ,] [...] 设置命令 AT+CEDRXS=[,[, ]] OK 响应 OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 68 / 116 BC26&BC20 AT 命令手册 最大响应时间 特性说明 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。禁用和启用 eDRX。该参数适用于所有指定访问技术，即 的最新设置将对所有指定的值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 和 URC +CEDRXP: [,[,[,]]]上报 3 禁用 eDRX 并清除所有的 eDRX 参数配置（若有默认值，则重置 为默认值） 整型。访问技术类型。AT+CEDRXS?可查询指定接入技术与请求的 eDRX 周期之间的关系。 0 未使用 eDRX 的接入技术，该取值仅用于 URC 中。 5 E-UTRAN（NB-S1 模式） 字符串类型。UE 请求的 eDRX 周期，半字节（4 位）格式。NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的 eDRX 周期，半字节（4 位）格式。NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 上海移远通信技术股份有限公司 69 / 116 BC26&BC20 AT 命令手册 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗，半字节（4 位）格式。NB-S1 模式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详情参见第 12 章。 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS: 5,'0101' OK AT+CEDRXS=? +CEDRXS: (0-3),(5),('0000'-'1111') OK 上海移远通信技术股份有限公司 70 / 116 BC26&BC20 AT 命令手册 8.2. AT+CEDRXRDP 查询 eDRX 状态 若 eDRX 用于 MS 当前注册的小区，执行命令将返回、、 和。 若 MS 当前注册的小区未使用 eDRX，则仅返回且值为 0。 AT+CEDRXRDP 查询 eDRX 状态 测试命令 响应 AT+CEDRXRDP=? 执行命令 OK 响应 AT+CEDRXRDP +CEDRXRDP: [,[,< NW_provided_eDRX_value>[,]]] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。访问技术类型。AT+CEDRXS?可查询指定接入技术与请求 的 eDRX 周期之间的关系。 0 未使用 eDRX 模式 5 E-UTRAN（NB-S1 模式） 字符串类型。请求的 eDRX 周期，半字节（4 位）格式。NB-S1 模 式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 上海移远通信技术股份有限公司 71 / 116 BC26&BC20 AT 命令手册 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的 eDRX 周期，半字节（4 位）格式。NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗，半字节（4 位）格式。 NB-S1 模式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详情参见第 12 章。 举例 AT+CEDRXRDP +CEDRXRDP: 5,'0010','1110','0101' OK 上海移远通信技术股份有限公司 72 / 116 BC26&BC20 AT 命令手册 AT+CEDRXRDP=? OK 8.3. AT+CFUN 设置 UE 功能 设置命令用于选择 UE 的功能等级。'全功能'模式下所有功能全部打开，功耗最高；'最少功能'模 式下大多数功能关闭，只支持少量基本功能，此时功耗最低。 查询命令返回 UE 的当前功能等级设置。 测试命令返回 MT 所支持参数的范围。 AT+CFUN 设置 UE 功能 测试命令 AT+CFUN=? 响应 +CFUN: (支持的列表),(支持的范围) 查询命令 AT+CFUN? OK 响应 +CFUN: 设置命令 AT+CFUN=[,] OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 85 秒，依赖于网络环境 见参数说明 参数 整型。UE 功能等级。 0 最少功能 1 全功能 4 禁止射频发送和接收 7 仅禁用 USIM。射频发送和接收电路仍有效。 整型。UE 重启设置。 上海移远通信技术股份有限公司 73 / 116 BC26&BC20 AT 命令手册 0 无需重启 UE，该命令立即生效。深休眠唤醒有效，但参数配置不保存至 NVRAM。 1 重启 UE 后命令生效。深休眠唤醒有效，且参数配置保存至 NVRAM。 2 无需重启 UE，命令立即生效。深休眠唤醒有效，且参数配置保存至 NVRAM。 整型。错误码。详情参见第 12 章。 举例 AT+CFUN=? +CFUN: (0,1,4,7),(0-2) OK AT+CFUN=1 OK AT+CFUN? +CFUN: 1 OK 8.4. AT+CPSMS 省电模式（PSM）设置 设置命令用于控制 UE 省电模式（PSM）的参数设置，即配置 UE 是否使用 PSM 以及 E-UTRAN 中请 求的扩展周期 TAU 值和激活时间值。请参考 AT+CEREG 返回的 URC 查看激活时间值以及 E-UTRAN 网 络分配给 UE 的扩展周期 TAU 值。 AT+CPSMS=2 为该命令的一种特殊形式，用于禁用 PSM 并清除 AT+CPSMS 的所有参数配置（若参 数有默认值，则将其恢复为默认值）。 查询命令返回当前的参数设置情况。 测试命令返回支持的列表、请求的扩展周期 TAU 值范围以及请求的激活时间值范围。 AT+CPSMS 省电模式（PSM）设置 测试命令 AT+CPSMS=? 响应 +CPSMS: (支持的范围),,,(支持的列表),(支持的列表) 查询命令 AT+CPSMS? OK 响应 +CPSMS: [,,,[],[] 上海移远通信技术股份有限公司 74 / 116 BC26&BC20 AT 命令手册 OK 设置命令 AT+CPSMS=[,,,[,]] 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。设置 UE 的 PSM 状态。 0 禁用 PSM 1 启用 PSM 2 恢复 PSM 设置为默认值 字符串类型。8 位格式的 1 字节参数。E-UTRAN 分配给 UE 的请求 扩展周期 TAU 值（T3412）。例如，'01000111'等于 70 小时。 第 5 位到第 1 位代表二进制编码的定时器值。 第 8 位到第 6 位定义了定时器步长： 位 8 7 6 0 0 0 0 0 1 0 1 0 0 1 1 1 0 0 1 0 1 1 1 0 1 1 1 步长为 10 分钟 步长为 1 小时 步长为 10 小时 步长为 2 秒 步长为 30 秒 步长为 1 分钟 步长为 320 小时 去激活定时器 字符串类型。8 位格式的 1 字节参数。待分配给 UE 的请求激活时间 值（T3324）。例如，'00100100'等于 4 分钟。 位 5 至位 1 代表二进制编码的定时器值。 位 6 至位 8 定义 GPRS 定时器步长： 8 7 6 上海移远通信技术股份有限公司 75 / 116 BC26&BC20 AT 命令手册 0 0 0 步长为 2 秒 0 0 1 步长为 1 分钟 0 1 0 步长为 6 分钟 1 1 1 去激活定时器 整型。错误码。详情参见第 12 章。 备注 1. 定时器步长仅适用于 T3412 扩展值 IE。若以完整性保护消息的形式接收到该值，则 T3412 扩展值应 为 320 小时的倍数，否则为 1 小时的倍数。 2. 定时器取值不适用于 T3412 扩展至 IE。若接收到该值，则认为 T3412 扩展至 IE 未包含此信息。 举例 AT+CPSMS=1,,,'01000011','01000011' OK AT+CPSMS? +CPSMS: 1,,,'01000011','01000011' OK AT+CPSMS=? +CPSMS: (0-2),,,('00000000'-'11111111'), ('00000000'-'11111111') OK 8.5. AT+QEDRXCFG eDRX 和 PTW 设置 设置命令可设置 UE 的 eDRX/PTW 参数，即控制 UE 是否使用 eDRX、请求的 eDRX 周期值以及指定 访问技术的 PTW（寻呼时间窗）。 AT+QEDRXCFG eDRX 和 PTW 设置 测试命令 AT+QEDRXCFG=? 响应 +QEDRXCFG: (支持的范围),(支持的列 表),(支持的列表),(支持的列表) 查询命令 AT+QEDRXCFG? OK 响应 +QEDRXCFG: ,[,] 设置命令 AT+QEDRXCFG=[,[,[,]]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后仍有效；自动保存至 NVRAM。 参数 整型。禁用或启用 eDRX。此参数适用于所有指定接入技 术，即的最新设置将对所有指定的 值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 和 URC +CEDRXP: [,[, [,]]]上报 3 恢复默认参数 整型。接入技术类型。AT+CEDRXS?可查询指定接入技 术与请求的 eDRX 周期之间的关系。 0 未使用 eDRX 的接入技术，此参数仅用于 URC 中 5 E-UTRAN（NB-S1 模式） 字符串类型。请求的 eDRX 周期，半字节（4 位）格式。 NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 上海移远通信技术股份有限公司 77 / 116 BC26&BC20 AT 命令手册 字符串类型。请求的寻呼时间窗，半字节（4 位）格式。 NB-S1 模式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 字符串类型。网络下发的 eDRX 周期，半字节（4 位）格 式。NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗，半字节（4 位） 格 式。NB-S1 模式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 上海移远通信技术股份有限公司 78 / 116 BC26&BC20 AT 命令手册 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详情参见第 12 章。 举例 AT+QEDRXCFG=1,5,'0101' OK AT+QEDRXCFG? +QEDRXCFG: 5,'0101' OK AT+QEDRXCFG=? +QEDRXCFG: (0-3),(5),('0000'-'1111'),('0000'-'1111') OK 8.6. AT+QNBIOTRAI NB-IoT 释放辅助指示 该命令用于设置是否使用 NB-IoT 辅助释放指示，以便以此决定是否需要立即释放当前的 RRC 连接。 AT+QNBIOTRAI NB-IoT 释放辅助指示 测试命令 AT+QNBIOTRAI=? 响应 +QNBIOTRAI: (支持的范围) 查询命令 AT+QNBIOTRAI? OK 响应 +QNBIOTRAI: 设置命令 AT+QNBIOTRAI= OK 响应 OK 上海移远通信技术股份有限公司 79 / 116 BC26&BC20 AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。信息传输携带的快速释放标记 RAI，该标记用于指示核心网如何释放与模块的 RRC 连接。范围：0~2。 0 无标记，不使用释放辅助指示（或无其他可适用的选项） 1 该包数据上行后不期望有进一步的上行或下行数据，核心网可立即释放 2 发该包数据上行后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。错误码。详情参见第 12 章。 备注 该命令仅对随后的一条数据生效。 8.7. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 该命令用于启用或禁用 NB-IoT 相关事件上报。 AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 测试命令 响应 AT+QNBIOTEVENT=? 查询命令 OK 响应 AT+QNBIOTEVENT? +QNBIOTEVENT: , 设置命令 AT+QNBIOTEVENT=, OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 80 / 116 最大响应时间 特性说明 参数 BC26&BC20 AT 命令手册 300 毫秒 该命令立即生效。 深休眠唤醒后有效；保存至 NVRAM（需先执行 AT&W）。 整型。启用/禁用事件上报 URC。 0 禁用事件上报 URC 1 启用事件上报 URC +QNBIOTEVENT: 整型。上报的事件。 1 PSM 状态 字符串类型。当上报的事件为 PSM 状态时，有如下两个值： ENTER PSM EXIT PSM 整型。错误码。详情参见第 12 章。 8.8. AT+QRELLOCK 释放 AT 命令休眠锁 每次发送完 AT 命令后，模块默认会启动休眠锁定时器（默认为 10 秒）以防止模块进入休眠模式。 该执行命令用于释放所述休眠锁，以便模块在无可用休眠句柄控制系统的休眠状态时可立即进入休眠 状态。 AT+QRELLOCK 释放 AT 命令睡眠锁 执行命令 AT+QRELLOCK 响应 OK 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存至 NVRAM。 举例 AT+QRELLOCK OK 上海移远通信技术股份有限公司 81 / 116 BC26&BC20 AT 命令手册 8.9. AT+QSCLK 配置休眠模式 该命令用于配置 TE 的休眠模式。 AT+QSCLK 配置休眠模式 测试命令 AT+QSCLK=? 查询命令 AT+QSCLK? 设置命令 AT+QSCLK= 最大响应时间 特性说明 响应 +QSCLK: (支持的范围) OK 响应 +QSCLK: OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存至 NVRAM。 参数 整型。 0 禁用休眠模式 1 启用轻休眠（Light Sleep）和深休眠（Deep Sleep），并通过 PSM_EINT（下降沿）唤 醒深休眠 2 仅启用轻休眠，并通过主串口唤醒 整型。错误码。详情参见第 12 章。 备注 1. 轻休眠模式下，模块的串口不工作。因此，当 AT+QSCLK=1 或 AT+QSCLK=2 时，请在发送其他 命令之前先发送 AT 以确保串口被唤醒。 2. 当 AT+QSCLK=0 时，串口始终有效。若要使模块进入休眠模式，请执行 AT+QSCLK=1 或 AT+QSCLK=2。 3. 执行业务前，建议发送 AT+QSCLK=0 禁止模块进入休眠模式，以防止业务交互过程中模块自动进 入休眠而影响正常的业务流程；待业务收发完成后，再执行 AT+QSCLK=1 使能休眠模式。 上海移远通信技术股份有限公司 82 / 116 BC26&BC20 AT 命令手册 4. 轻休眠模式下，模块通过 PSM_EINT 唤醒后会立即再次进入轻休眠，因而会影响业务交互。此时， 建议通过主串口发送 AT 命令唤醒模块，或遵循备注 3 的建议。 举例 AT+QSCLK=1 OK 上海移远通信技术股份有限公司 83 / 116 BC26&BC20 AT 命令手册 9 平台相关命令 9.1. AT&W 存储当前参数到 NVRAM 该命令用于存储当前参数配置到 NVRAM 里用户定义的配置文件中。目前可以通过该命令存储参数配 置的命令为：ATE、AT+CEREG、AT+CTZR、AT+CCIOTOPT、AT+QNBIOTEVENT 和 AT+QATWAKEUP。 AT&W 存储当前参数到 NVRAM 执行命令 AT&W[] 响应 OK 最大响应时间 300 毫秒 特性说明 / 参数 整型。 0 用于存储当前参数配置的配置文件编号 9.2. AT+CBC 查询电源电压 该命令用于查询电源的电压值。 AT+CBC 查询电源电压 测试命令 AT+CBC=? 执行命令 AT+CBC 响应 +CBC: (支持的范围),(支持的范围), OK 响应 +CBC: ,, OK 上海移远通信技术股份有限公司 84 / 116 BC26&BC20 AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。电池充电状态。 0 ME 不在充电中 1 ME 正在充电 2 充电已完成 整型。充电完成情况（百分比）；范围：0~100，表示电池充电已经完成 0~100%。 整型。电池电压；单位：mV。 整型。错误码。详细信息，请参阅第 12 章。 备注 由于 BC20 和 BC26 模块不支持电池充电，故参数和无效，参数值始终为 0。但参数 仍会显示正确的电源电压。 举例 AT+CBC +CBC: 0,0,3368 OK 上海移远通信技术股份有限公司 85 / 116 BC26&BC20 AT 命令手册 9.3. AT+CEER 扩展错误报告 执行命令可使 TA 返回一行或多行信息文本，其中应包含如下错误的原因报告，上报的信息文 本由 MT 制造商决定。 ⚫ 上一次 PDP 上下文激活失败 ⚫ PDP 上下文去激活失败 一般来说，TA 只返回一行文本格式信息，包含网络提供的原因信息。 AT+CEER 扩展错误报告 测试命令 AT+CEER=? 执行命令 AT+CEER 响应 OK 响应 +CEER: 最大响应时间 特性说明 OK 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 字符串类型。扩展错误报告。文本信息（包含终止符）的总字符数应不超过 2041 字符，文 本不包含序列 0或者 OK。 举例 AT+CEER +CEER: EMM_CAUSE_EPS_AND_NON_EPS_SERVICES_NOT_ALLOWED OK AT+CEER=? OK 9.4. AT+CMEE 启用/禁用移动终端错误上报 设置命令启用/禁用指示 MT 功能错误的最终结果码+CME ERROR: 。启用后，若有 ME 相关错 上海移远通信技术股份有限公司 86 / 116 BC26&BC20 AT 命令手册 误，模块会上报+CME ERROR: 作为最终结果码，而不会返回 ERROR。出现命令语法错误、参数无 效或 TA 功能错误时，依然返回 ERROR。 AT+CMEE 启用/禁用移动终端错误上报 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) 查询命令 AT+CMEE? OK 响应 +CMEE: 设置命令 AT+CMEE= 最大响应时间 特性说明 OK 响应 OK 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。启用/禁用结果码+CME ERROR: 。 0 禁用 1 启用，并采用数字形式的结果码 2 启用，并采用详值形式的结果码 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CMEE? +CMEE: 0 OK AT+CMEE=? +CMEE: (0-2) OK 上海移远通信技术股份有限公司 87 / 116 BC26&BC20 AT 命令手册 9.5. AT+QADC 读取 ADC 通道输入电压值 查询命令用于查询 ADC 通道的输入电压值。 设置命令可设置指定 ADC 通道的采样次数和采样间隔时间。 AT+QADC 读取 ADC 通道输入电压值 测试命令 AT+QADC=? 响应 +QADC: (支持的列表),(支持的范围) 查询命令 AT+QADC? OK 响应 +QADC: , 设置命令 AT+QADC=[,[,]] OK 响应 +QADC: , OK 最大响应时间 300 毫秒（有延迟操作的命令除外） 特性说明 / 参数 整型。ADC 转换状态。 0 成功 2 失败 整型。采样电压值或采样电压平均值。范围：0~1400；单位：mV。 整型。ADC 转换通道；范围：0~6，目前仅通道 0（ADC0）有效。 整型。采样次数；范围：1~100；默认值：1。 整型。ADC 采样间隔时间。取值为 10 的整数倍，默认值：0。范围：0~100；单位： 毫秒。 备注 AT+QADC?查询 ADC0 通道的输入电压值。 上海移远通信技术股份有限公司 88 / 116 举例 AT+QADC? +QADC: 2,796 OK BC26&BC20 AT 命令手册 9.6. AT+QATWAKEUP 启用/禁用深休眠唤醒指示 该命令用于当模块从深休眠唤醒时，启用/禁用此信道上的 URC +QATWAKEUP 上报指示。 AT+QATWAKEUP 启用/禁用深休眠唤醒指示 测试命令 AT+QATWAKEUP=? 响应 +QATWAKEUP: (支持的列表) 查询命令 AT+QATWAKEUP? OK 响应 +QATWAKEUP: 设置命令 AT+QATWAKEUP= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；保存至 NVRAM（需先执行 AT&W）。 参数 整型。当模块从深休眠唤醒时，在此信道上启用/禁用通过 URC +QATWAKEUP 上报指示。 0 禁用 1 启用 整型。错误码。详细信息，请参阅第 12 章。 上海移远通信技术股份有限公司 89 / 116 BC26&BC20 AT 命令手册 举例 AT+QATWAKEUP=1 OK //从深休眠模式唤醒模块。 +QATWAKEUP //模块已被完全唤醒并准备接收 AT 命令或者数据。 9.7. AT+QCFG 系统配置 该命令用于配置系统的可配置项。 AT+QCFG 系统配置 测试命令 AT+QCFG=? 响应 +QCFG: (支持的列表),(支持的列表) 查询命令 AT+QCFG? OK 响应+QCFG: (支持的列表),(当前的列表) OK 设置命令 AT+QCFG=[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QCFG: , OK 若指定可选参数，配置系统的可选项： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 上海移远通信技术股份有限公司 90 / 116 BC26&BC20 AT 命令手册 参数 字符串类型。需配置的功能。 'epco' 配置扩展协议配置项（ePCO） 'combinedattach' 配置联合附着 'up' 配置是否使能用户面功能 'upopt' 配置是否使能用户面优化方案 'multidrb' 配置是否使能支持多 DRB 'autopdn' 配置 PDN 自动激活选项 'ripin' 配置 RI 引脚默认输出电平 'initlocktime' 通过 PSM_EINT 从深休眠唤醒模块或重启模块后配置初始休眠 锁的持续时间 'dsevent' 启用/禁用深休眠事件 URC Enter Deep Sleep 'atlocktime' 通过 AT 命令配置休眠锁持续时间 'urc/ri/mask' 配置 URC 上报是否触发 RI 跳变 'vbattimes' 配置 AT+QVBATT 命令中的电压检测周期 整型。 描述 'epco' 0 禁用 ePCO，即使用 PCO 'epco' 1 使能 ePCO 'combinedattach' 0 关闭联合附着 'combinedattach' 1 打开联合附着 'up' 0 关闭用户面功能 'up' 1 打开用户面功能 'upopt' 0 关闭用户面优化 'upopt' 1 打开用户面优化 'multidrb' 0 关闭多 DRB 'multidrb' 1 打开多 DRB 'autopdn' 0 关闭 PDN 自动激活 'autopdn' 1 打开 PDN 自动激活 'ripin' 0 RI 引脚默认输出高电平 'ripin' 1 RI 引脚默认输出低电平 'initlocktime' 1~30 配置初始休眠锁持续时间；单位：秒。 'dsevent' 0 关闭深休眠事件 URC 上报 'dsevent' 1 打开深休眠事件 URC 上报 'atlocktime' 0~10 通过 AT 命令可配置的休眠锁持续时间；单位：秒。 'urc/ri/mask' 0， 解除指定 URC 上报时触发 RI 跳变的禁令 'urc/ri/mask' 1， 禁止 URC 上报时触发 RI 跳变 'urc/ri/mask' 2 所有 URC 上报均触发 RI 跳变 'vbattimes' 1~600 AT+QVBATT 命令中的电压检测周期；单位：秒 整型。错误码。详细信息，请参阅第 12 章。 上海移远通信技术股份有限公司 91 / 116 BC26&BC20 AT 命令手册 9.8. AT+QPOWD 模块关机/重启 该命令用于使模块关机/重启。 AT+QPOWD 模块关机/重启 查询命令 AT+QPOWD=? 设置命令 AT+QPOWD= 最大响应时间 特性说明 响应 +QPOWD: (支持的范围) OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 85 秒 / 参数 整型。 0 模块正常关机 1 模块强制关机 2 模块重启 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QPOWD=0 OK 上海移远通信技术股份有限公司 92 / 116 BC26&BC20 AT 命令手册 9.9. AT+QRST 自动重启 该命令用于立即重启模块。 AT+QRST 自动重启 测试命令 AT+QRST=? 设置命令 AT+QRST= 最大响应时间 特性说明 响应 +QRST: (支持的列表) OK 响应 立即自动重启 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。 1 无需注销网络，立即自动重启。 整型。错误码。详细信息，请参阅第 12 章。 9.10. AT+QVBATT 配置电压阈值 该命令用于配置高低压报警阈值和关机阈值。 AT+QVBATT 配置电压阈值 测试命令 AT+QVBATT=? 查询命令 响应 +QVBATT: 0,(2100-2900),(0,1) +QVBATT: 1,(2000-2800),(0,1) +QVBATT: 2,(3200-3600),(0,1) +QVBATT: 3,(3300-3700),(0,1) OK 响应 上海移远通信技术股份有限公司 93 / 116 BC26&BC20 AT 命令手册 AT+QVBATT? +QVBATT: 0,, +QVBATT: 1,, +QVBATT: 2,, +QVBATT: 3,, OK 设置命令 响应 AT+QVBATT=[,<vo +QVBATT: ,, ltage>,] OK 最大响应时间 300 毫秒（有延迟操作的命令除外） 特性说明 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。配置电压阈值的类型。 0 低压报警 1 低压关机 2 高压报警 3 高压关机 整型。电压阈值；单位：mV。 当=0，的范围为 2100~2900。 当=1，的范围为 2000~2800。 当=2，的范围为 3200~3600。 当=3，的范围为 3300~33700。 整型。对应功能类型的开启或关闭状态。 0 关闭 1 开启 备注 若电池电压达到设定的阈值，则对应上报如下 URC： ⚫ 低压报警：UNDER VOLTAGE WARNING ⚫ 低压关机：UNDER VOLTAGE POWER DOWN ⚫ 高压报警：OVER VOLTAGE WARNING ⚫ 高压关机：OVER VOLTAGE POWER DOWN 举例 AT+QVBATT? +QVBATT: 0,2900,0 上海移远通信技术股份有限公司 94 / 116 +QVBATT: 1,2800,0 +QVBATT: 2,3600,0 +QVBATT: 3,3700,0 OK AT+QVBATT=? +QVBATT: 0,(2100-2900),(0,1) +QVBATT: 1,(2000-2800),(0,1) +QVBATT: 2,(3200-3600),(0,1) +QVBATT: 3,(3300-3700),(0,1) OK BC26&BC20 AT 命令手册 上海移远通信技术股份有限公司 95 / 116 BC26&BC20 AT 命令手册 10 时间相关命令 10.1. AT+CCLK 设置/查询当前日期和时间 用户设备接收到 EMM INFORMATION 信号之后会自动同步 RTC 时钟。执行查询命令后返回当前时钟 设置。 AT+CCLK 设置/查询当前日期和时间 测试命令 AT+CCLK=? 查询命令 AT+CCLK? 响应 OK 响应 +CCLK: 设置命令 AT+CCLK= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 字符串类型。格式为'yyyy/mm/dd,hh:mm:ssGMT±zz'，各字符分别指代年、月、日、时、分、 秒和时区（以 1 小时为单位显示本地时间和 GMT 之间的时区差，范围：-12~+12），例如， '2019/05/06,22:10:00GMT+2'表示 2019 年 5 月 6 日，22:10:00 GMT+2 小时。 整型。错误码。详细信息，请参阅第 12 章。 上海移远通信技术股份有限公司 96 / 116 举例 AT+CCLK? +CCLK: 2019/05/06,22:10:00GMT+2 OK BC26&BC20 AT 命令手册 10.2. AT+CTZR 上报时区变化 该命令用于启用/禁用时区变化事件的上报。若启用上报，则时区变化时移动终端会返回 URC +CTZV: 或者+CTZE: ,,[]。 AT+CTZR 上报时区变化 测试命令 AT+CTZR=? 响应 +CTZR: (支持的范围) 查询命令 AT+CTZR? OK 响应 +CTZR: OK 设置命令 AT+CTZR= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；保存至 NVRAM（需在搜往前设置该命令， 设置后需执行 AT&W 保存） 上海移远通信技术股份有限公司 97 / 116 BC26&BC20 AT 命令手册 参数 整型。是否上报时区变化。 0 不上报 1 通过 URC +CTZV: 上报时区变化 2 通过 URC +CTZE: ,,[]上报时区信息和本地时间 字符串类型。表示本地时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异）与夏令时 之和；格式为'±zz'，为两个整型数字的固定宽度；范围：-47~+48。为保证固定宽度，-9~+9 之间的数字前加 0，例如：'-09'，'+00'，'+09'。 整型。参数中是否包括夏令时调整。 0 不包括夏时令调整 1 包括+1 小时（相当于的一个小时）的夏时令调整 字符串类型。当前本地日期和时间。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CTZR=? +CTZR: (0-2) OK AT+CTZR=0 OK AT+CTZR? +CTZR: 0 OK 备注 需在模块驻网前执行该命令。 上海移远通信技术股份有限公司 98 / 116 BC26&BC20 AT 命令手册 10.3. AT+QCCLK 设置/查询当前日期和 UTC 设置命令用于设置移动终端的实时时钟。若设置失败，移动终端会上报错误码+CME ERROR: 。 查询命令返回时钟的时间和 UTC。 AT+QCCLK 设置/查询当前日期和 UTC 测试命令 AT+QCCLK=? 查询命令 AT+QCCLK? 响应 OK 响应 +QCCLK: 设置命令 AT+QCCLK= 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 字符串类型。格式为'yy/MM/dd,hh:mm:ss±zz'，分别指代年、月、日、时、分、秒和时区（以 15 分 钟 为 单 位 显 示 本 地 时 间 和 GMT 之 间 的 时 间 差 ， 范 围 ： -47~+48 ） ， 如 '19/05/06,22:10:00+08'表示 2019 年 5 月 6 日，22:10:00 GMT+2 小时。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QCCLK=? OK AT+QCCLK='19/05/06,22:10:00+08' OK AT+QCCLK? +QCCLK: 19/05/06,22:10:00+08 上海移远通信技术股份有限公司 99 / 116 BC26&BC20 AT 命令手册 OK 上海移远通信技术股份有限公司 100 / 116 BC26&BC20 AT 命令手册 11 其它命令 11.1. TCP/IP 相关 AT 命令 有关 TCP/IP AT 命令的详细介绍，请参考《Quectel_BC26&BC20_TCP(IP)_应用指导》。 表 3：TCP/IP 相关 AT 命令列表 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] AT 命令 AT+QIOPEN AT+QICLOSE AT+QISTATE AT+QISEND AT+QIRD AT+QISENDEX AT+QISWTMD AT+QPING AT+QNTP AT+QIDNSGIP AT+QIDNSCFG AT+QICFG AT+QIGETERROR 功能描述 打开 Socket 关闭 Socket 查询 Socket 状态 发送十六进制/文本字符串数据 读取 TCP/IP 数据 发送十六进制字符串数据 切换数据访问模式 Ping 远程服务器 通过 NTP 服务器同步本地时间 转换域名为 IP 地址 配置 DNS 服务器地址 配置可选参数 查询上一个错误代码 上海移远通信技术股份有限公司 101 / 116 BC26&BC20 AT 命令手册 11.2. MQTT 相关 AT 命令 有关 MQTT AT 命令的详细介绍，请参考《Quectel_BC26&BC20_MQTT_应用指导》。 表 4：MQTT 相关 AT 命令列表 序号 [1] [2] [3] [4] [5] [6] [7] [8] AT 命令 AT+QMTCFG AT+QMTOPEN AT+QMTCLOSE AT+QMTCONN AT+QMTDISC AT+QMTSUB AT+QMTUNS AT+QMTPUB 功能描述 配置 MQTT 可选参数 打开 MQTT 客户端网络 关闭 MQTT 客户端网络 连接客户端至 MQTT 服务器 从 MQTT 服务器断开客户端连接 订阅主题 退订主题 发布消息 11.3. SSL 相关 AT 命令 有关 SSL AT 命令的详细介绍，请参考《Quectel_ BC26&BC20_SSL_应用指导》。 表 5：SSL 相关 AT 命令列表 序号 [1] [2] [3] [4] AT 命令 AT+QSSLCFG AT+QSSLOPEN AT+QSSLSEND AT+QSSLCLOSE 功能描述 配置 SSL 上下文参数 建立 SSL 连接 发送数据 断开 SSL 连接 上海移远通信技术股份有限公司 102 / 116 BC26&BC20 AT 命令手册 11.4. LwM2M 相关 AT 命令 有关 LwM2M AT 命令的详细介绍，请参考《Quectel_BC26_LwM2M_应用指导》。 表 6：LwM2M 相关 AT 命令列表 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] AT 命令 AT+QLACONFIG AT+QLACFG AT+QLAREG AT+QLAUPDATE AT+QLADEREG AT+QLAADDOBJ AT+QLADELOBJ AT+QLARDRSP AT+QLAWRRSP AT+QLAEXERSP AT+QLAOBSRSP AT+QLANOTIFY AT+QLASENDDATA AT+QLARD AT+QLARECOVER AT+QLASTATUS 功能描述 配置注册参数 配置可选注册参数 发送注册请求 发送更新请求 发送注册请求 添加 LwM2M 对象 删除 LwM2M 对象 响应读请求 响应写请求 响应执行请求 响应订阅求情 上报被订阅资源的数据 直接发送数据 读取缓存数据 手动恢复 LwM2M 会话 查询当前 LwM2M 状态 备注 BC20 模块不支持标准 LwM2M AT 命令。 上海移远通信技术股份有限公司 103 / 116 BC26&BC20 AT 命令手册 11.5. 电信 IoT 平台相关 AT 命令 有关电信 IoT 平台 AT 命令的详细介绍，请参考《Quectel_BC26&BC20_电信 IoT 平台_应用指导》。 表 7：电信 IoT 平台相关 AT 命令列表 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] AT 命令 AT+QLWSERV AT+QLWCONF AT+QLWADDOBJ AT+QLWDELOBJ AT+QLWOPEN AT+QLWUPDATE AT+QLWCLOSE AT+QLWDATASEND AT+QLWDATASTATUS AT+QLWRD AT+QLWCFG AT+QLWDEL 功能描述 配置电信 loT 平台地址和端口 配置电信 IoT 平台参数 添加 LwM2M 对象 删除 LwM2M 对象 向电信 IoT 平台发送注册请求 向电信 IoT 平台发送更新请求 向电信 IoT 平台发送注销请求 发送数据到电信 IoT 平台 查询 CON 消息的发送状态 读取接收数据 配置可选参数 删除 LwM2M 场景 11.6. OneNET 相关 AT 命令 有关 OneNET AT 命令的详细介绍，请参考《Quectel_BC26&BC20_OneNET_应用指导》。 表 8：OneNET 相关 AT 命令列表 序号 AT 命令 [1] AT+MIPLCONFIG 功能描述 OneNET 接入配置 上海移远通信技术股份有限公司 104 / 116 BC26&BC20 AT 命令手册 [2] AT+MIPLCREATE [3] AT+MIPLDELETE [4] AT+MIPLVER [5] AT+MIPLADDOBJ [6] AT+MIPLDELOBJ [7] AT+MIPLRD [8] AT+MIPLOPEN [9] AT+MIPLCLOSE [10] AT+MIPLDISCOVERRSP [11] AT+MIPLOBSERVERSP [12] AT+MIPLREADRSP [13] AT+MIPLWRITERSP [14] AT+MIPLEXECUTERSP [15] AT+MIPLPARAMETERRSP [16] AT+MIPLNOTIFY [17] AT+MIPLUPDATE 创建 OneNET 通信套件实例 删除 OneNET 通信套件实例 查询 OneNET 通信套件版本 添加 LwM2M 对象 删除 LwM2M 对象 读取接收数据 发送注册请求 发送注销请求 响应发现资源请求 响应订阅请求 响应读取请求 响应写入请求 响应执行请求 响应写属性请求 上报数据至 OneNET 平台或应用服务器 发送更新请求 11.7. CMDMP 相关 AT 命令 有关中国移动设备管理平台（CMDMP）接入配置的 AT 命令详细介绍，请参考《Quectel_BC26&BC20_ 运营商自注册使用说明》。 表 9：CMDMP 相关 AT 命令列表 序号 [1] [2] AT 命令 AT+QDMPCFG AT+QDMPCFGEX 功能描述 CMDMP 接入配置 CMDMP 接入扩展配置 上海移远通信技术股份有限公司 105 / 116 BC26&BC20 AT 命令手册 11.8. 中国电信/联通自注册相关 AT 命令 有关中国电信/联通自注册的详细介绍，请参考《Quectel_BC26&BC20_运营商自注册使用说明》。 表 10：中国电信/联通自注册相关 AT 命令列表 序号 [1] AT 命令名称 AT+QSREGENABLE 功能描述 启用/禁用电信/联通自注册 11.9. DFOTA 相关 AT 命令 有关 DFOTA AT 命令的详细介绍，请参考《Quectel_BC26&BC20_DFOTA_应用指导》。 表 11：DFOTA 相关 AT 命令列表 序号 [1] [2] AT 命令名称 AT+QFUPLEX AT+QFOTADL 功能描述 通过串口分包写入差分文件 使能 DFOTA 固件升级 11.10. GNSS 相关 AT 命令 有关 BC20 模块支持的 GNSS AT 命令的详细介绍，请参考《Quectel_BC20_GNSS_应用指导》。 表 12：GNSS 相关 AT 命令列表 序号 [1] [2] [3] [4] AT 命令名称 AT+QGNSSC AT+QGNSSRD AT+QGNSSCMD AT+QGNSSDB 功能描述 打开/关闭 GNSS 获取 GNSS NMEA 语句 发送命令至模块 配置 NEMA 语句输出端口 上海移远通信技术股份有限公司 106 / 116 [5] AT+QGNSSAGPS 启用/禁用 AGPS 功能 备注 BC26 模块不支持 GNSS AT 命令。 BC26&BC20 AT 命令手册 上海移远通信技术股份有限公司 107 / 116 BC26&BC20 AT 命令手册 12 错误代码汇总 本章主要介绍与模块相关的错误码。 下表列出的错误代码符合 3GPP 规范。请参考《3GPP TS 27.007》子章节 9.2 了解错误码。 12.1. 常见错误代码列表 表 13：常见错误代码列表（27.007） 3 4 10 13 14 20 23 24 25 30 31 32 50 100 错误代码 Operation not allowed Operation not supported USIM not inserted USIM failure USIM busy USIM memory full Memory failure Text string too long Invalid characters in text string No network service Network timeout Network not allowed - emergency calls only Incorrect parameters Unknown 中文解释 操作不允许 操作不支持 未插入 USIM USIM 失败 USIM 繁忙 USIM 内存已满 内存故障 文本字符串过长 文本字符串中包含无效字符 网络无服务 网络超时 网络不允许—仅限紧急呼叫 参数错误 未知 上海移远通信技术股份有限公司 108 / 116 BC26&BC20 AT 命令手册 12.2. 指定错误代码列表 以下错误代码为模块指定的错误代码。 表 14：指定错误代码列表 107 111 112 113 132 133 149 584 588 591 592 596 598 606 607 615 630 631 639 675 676 错误代码 中文解释 PSD services not allowed PSD 服务不允许 PLMN not allowed PLMN 不允许 Location area not allowed 位置区域不允许 Roaming not allowed in this location area 不允许在此位置区域漫游 Service option not supported 服务选项不支持 Requested service option not subscribed 请求的服务选项未订阅 PDP authentication failure PDP 鉴权失败 Combined service not allowed 不允许组合服务 Feature not supported 该功能不支持 Implicitly detached 隐式分离 Insufficient resources 资源不足 Invalid value 无效的值 Mode value not in range 模式值不在范围内 Low layer failure 低层故障 Missing or unknown failure 缺失或未知故障 Network failure 网络故障 Profile () not defined Profile（）未定义 Unspecified protocol error 未指定协议错误 Service type not yet available 服务类型尚不可用 PDN type IPv4 only allowed 仅允许 IPv4 PDN 连接 PDN type IPv6 only allowed 仅允许 IPv6 PDN 连接 上海移远通信技术股份有限公司 109 / 116 BC26&BC20 AT 命令手册 692 EPS service not allowed 不允许 EPS 服务 695 EPS tracking area not allowed 不允许 EPS 跟踪区域 696 Roaming not allowed in TA 不允许 TA 漫游 697 Roaming not allowed in PLMN 不允许 PLMN 漫游 698 Not suitable cells in TA TA 中不适合的小区 700 ESM failure ESM 故障 703 Congestion 拥塞 704 UE security capability mismatch UE 安全能力不匹配 705 Security mode rejected 安全模式被拒绝 709 No EPS bearer context activated 无激活的 EPS 承载上下文 765 Invalid input value 输入值无效 766 Unsupported value or mode 不支持的值或模式 767 Operation failed 操作失败 769 Unable to get control of required module 无法控制所需的模块 770 USIM Invalid – network reject USIM 无效—网络拒绝 772 USIM powered down USIM 掉电 840 No service state 无服务状态 841 In cell search state 处于小区搜索状态 842 ERRC is deactivated ERRC 已停用 843 In cell-reselection state 处于小区重选状态 845 In re-establishment state 处于重建状态 846 In PSM state 处于 PSM 状态 847 No data transfer in idle state 空闲状态下无数据传输 备注 AT+CMEE=命令禁用（=0）或启用（=1）最终结果代码+CME ERROR: 。当=1 时，若发生错误，将返回一组有限的错误代码。 上海移远通信技术股份有限公司 110 / 116 BC26&BC20 AT 命令手册 13 附录 A 参考文档及术语缩写 表 15：参考文档 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] 文档名称 备注 3GPP 27.007 AT Command Set for User Equipment 3GPP 27.005 Equipment (DTE - DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Quectel_BC26&BC20_TCP(IP)_AT 命令手册 用户设备的 3GPP 27.007 AT 命令集 用 于 短 消 息 服 务 （ SMS ） 的 3GPP 27.005 设备（DTE-DCE）接口和小区 广播服务（CBS） BC20&BC26 TCP/IP AT 命令手册 Quectel_BC26&BC20_MQTT_应用指导 BC20&BC26 MQTT 应用指导 Quectel_BC26&BC20_SSL_应用指导 BC20&BC26 SSL 应用指导 Quectel_BC26_LwM2M_应用指导 BC26 LwM2M 应用指导 Quectel_BC26&BC20_电信 IoT 平台_应用指导 BC20&BC26 电信 IoT 平台应用指导 Quectel_BC26&BC20_OneNET_应用指导 BC20&BC26 OneNET 平台应用指导 Quectel_BC26&BC20_CMDMP_接入指导 Quectel_BC26&BC20_运营商自注册使用说明 Quectel_BC26&BC20_DFOTA_应用指导 BC20&BC26 CMDMP 接入配置指导 BC20&BC26 中国电信/联通自注册配 置说明 BC20&BC26 DFOTA 应用指导 Quectel_BC20_GNSS_应用指导 BC20 GNSS 应用指导 表 16：术语缩写 术语 3GPP ACK ADC AM 英文全称 3rd Generation Partnership Project Acknowledgement Analog-to-Digital Converter Acknowledged Mode 中文全称 第三代合作伙伴计划 确认 模拟数字转换 确认模式 上海移远通信技术股份有限公司 111 / 116 APN ARQ BCCH BCD CIoT CMDMP CN DCE DHCP DL DL-SCH DRB DTE EARFCN Ec/Io Ec/No ECL eDRX EF EGPRS EHPLMN EMM ePCO EPS BC26&BC20 AT 命令手册 Access Point Name 接入点名称 Automatic Repeat Request 自动重传请求 Broadcast Control Channel 广播控制信道 Binary Coded Decimal 二进制编码的十进制 Cellular Internet of Thing 蜂窝物联网 China Mobile Device Management Platform 中国移动设备管理平台 Core Network 核心网络 Data Communication Equipment (typically 数据通信设备（特指模块） the module) Dynamic Host Configuration Protocol 动态主机配置协议 Downlink (Forward Link) 下行（前向链路） Downlink-Shared Channel 下行共享信道 Data Radio Bearer 数据无线承载 Data Terminal Equipment (typically the MCU/external processor) 数据终端设备（特指 MCU/外部处理 器） E-UTRA Absolute Radio Frequency E-UTRA 绝对射频信道号 Channel Number RSCP/RSSI Ratio of energy per modulating 每个调制比特的能量与噪声功率之比 bit to the noise spectral density Ratio of energy per modulating bit to the 每比特能量比噪声电平 noise spectral density Enhanced Coverage Level 增强覆盖等级 extended Discontinuous Reception 扩展非连续接收 Elementary File (on the UICC) 基本文件 Enhanced General Packet Radio Service 增强型数据速率 GSM 演进技术 Equivalent Home PLMN 与 HPLMN 等效的 PLMN EPS Mobility Management EPS 移动性管理 Extended Protocol Configuration Options 扩展协议配置选项 Evolved Packet System 演进型分组系统 上海移远通信技术股份有限公司 112 / 116 ERRC ESM E-UTRAN FPLMN GERAN GGSN GMT GNSS GPRS GSM HARQ HPLMN HSDPA HSUPA ICCID ICMP IE IM IMEI IMEISV IMSI IPV4 IPV6 ITU-T LED BC26&BC20 AT 命令手册 E-Utran RRC 4G RRC 层 EPS Session Management EPS 会话管理 Evolved Universal Terrestrial Radio Access 演进的通用陆基无线接入网 Network Forbidden PLMN 禁止的 PLMN GSM/EDGE Radio Access Network GSM/EDGE 无线接入网 Gateway GPRS Support Node GPRS 网关支持节点 Greenwich Mean Time 格林尼治标准时间 Global Navigation Satellite System 全球导航卫星系统 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Hybrid Automatic Repeat Request 混合式自动重送请求 Home Public Land Mobile Network 本地公用陆地移动网 High-Speed Downlink Packet Access 高速下行分组接入 High-Speed Uplink Packet Access 高速上行分组接入 Integrated Circuit Card Identity 集成电路卡识别码 Internet Control Messages Protocol 网间控制报文协议 Information Element 信息单元 Intermodulation/IP Multimedia 互调/IP 多媒体 International Mobile Equipment Identity 国际移动设备识别码 International Mobile Equipment Identity and 国际移动用户识别码及软件版本 Software Version International Mobile Subscriber Identity 国际移动用户识别码 Internet Protocol Version 4 互联网通信协议第 4 版 Internet Protocol Version 6 互联网通信协议第 6 版 International Telecommunication Union 国际电信联盟 Light Emitting Diode 发光二极管 上海移远通信技术股份有限公司 113 / 116 LTE LwM2M MAC MCU MQTT MS MT MTU NAS NB-IoT NB-S1 NG-RAN NSLPI NVRAM OPLMN PAD PCI PCO P-CSCF PDCP PDN PDP PH-SIM PIN PSD BC26&BC20 AT 命令手册 Long-Term Evolution 长期演进 Lightweight M2M 轻量级 M2M Medium Access Control 媒体接入控制层 Media Control Unit 多媒体控制单元 Message Queuing Telemetry Transport 消息队列遥测传输协议 Mobile Station 移动台 Mobile Termination (typically the module) 移动终端（特指模块） Maximum Transfer Unit 最大传输单元 Non-Access Stratum 接入层 Narrowband Internet of Things 窄带物联网 S1 interface in NB-IoT mode NB-IoT 中的 S1 接口 Next Generation Radio Access Network 5G 接入网 NAS (Non-access Stratum) Signaling Low 非接入层信令低优先级指示 Priority Indication Non-Volatile Random Access Memory 非易失性随机访问存储器 Operator Controlled PLMN 运营商控制的 PLMN Packet Assember/Disassemble 分组组装拆卸器 Physical Cell Identification 物理小区标识 Protocol Configuration Options 协议配置选项 Proxy Call Session Control Function 代理呼叫会话控制 Packet Data Convergence Protocol 分组数据汇聚协议 Public Data Network 公用数据网 Packet Data Protocol 分组数据协议 lock PHone to SIM/UICC card installed in 将 UE 锁定到当前所选卡槽中插入的 the currently selected card slot USIM 卡 Personal Identification Number 个人识别码 Packet Switch Domin 分组域 上海移远通信技术股份有限公司 114 / 116 PSK PSM PTW PUK QoS RAI RAM RFC RLC RLC RRC RSRP RSRQ RSSI RTC Rx SINR SNDCP SNR SSL SVN TA TAC TAU TCP BC26&BC20 AT 命令手册 Pre-Shared key 预共享密钥 Power Saving Mode 省电模式 Paging Time Window 寻呼时间窗 Personal ldentification NumberUnlock Key PIN 解锁码 Quality of Service 服务质量 Routing Area Identity 辅助释放指示 Random Access Memory 随机存取存储器 Request For Comments 请求注解 Radio Link Control 无线链路控制 Radio Link Control 无线链路层 Radio Resource Control 无线资源控制 Received Signal Received Power 参考信号接收功率 Reference Signal Received Quality 参考信号接收质量 Received Signal Strength Indicator 接收的信号强度指示 Real Time Clock 实时时钟 Receive 接收（器/机） Signal to Interference plus Noise Ratio 信号与干扰加噪声比 Sub-Network Dependent Convergence 子网相关融合协议 Protocol Signal-to-Noise Ratio 信噪比 Security Socket Layer 加密套接字协议层 Software Version Number 软件版本 Terminal Adapter (typically the module) 终端适配器（特指模块） Tracking Area Code 跟踪区码 Tracking Area Updating 跟踪区更新 Transmission Control Protocol 传输控制协议 上海移远通信技术股份有限公司 115 / 116 TE TTL Tx UDP UE UICC UL UL-SCH URC USB USIM UTC UTRAN UUID BC26&BC20 AT 命令手册 Terminal Equipment (typically MCU/external processor) Time to Live the 终端设备（特指 MCU/外部处理器） 存活时间 Transmit 发送（器/机） User Datagram Protocol 用户数据报协议 User Equipment (typically the module) 用户设备（特指模块） Universal Integrated Circuit Card 通用集成电路卡 Uplink (Reverse Link) 上行（反向链路） Uplink Shared Channel 上行共享信道 Unsolicited Result Code 非请求结果码 Universal Serial Bus 通用串行总线 Universal Subscriber Identity Module 3G/4G SIM 卡 Universal Time Coordinated 协调世界时 Universal Terrestrial Radio Access Network 3G 接入网 Universally Unique Identifier 通用唯一识别码 上海移远通信技术股份有限公司 116 / 116

BG95&BG77&BG600L Series QCFG AT Commands Manual LPWA Module Series Version: 2.0 Date: 2021-07-27 Status: Released LPWA Module Series Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 1 / 60 LPWA Module Series Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 2 / 60 LPWA Module Series About the Document Revision History Version Date Author Description 1.0 2020-08-15 Lane HAO Initial 1. Deleted applicable module BG95-N1 2. Added the following AT commands: AT+QCFG='lapiconf' AT+QCFG='emmcause' AT+QCFG='sibinfo' AT+QCFG='emmtimer' AT+QCFG='msclass' AT+QCFG='ims' AT+QCFG='snrscan' AT+QCFG='fgiconfig' Monas KONG/ AT+QCFG='sim/onchip' 2.0 2021-07-27 Matt YE/ AT+QCFG='bandrestore' Egbert XU AT+QCFG='bip/auth' AT+QCFG='timer' AT+QCFG='timeupdate' AT+QCFG='uartcfg' AT+QCFG='dbgctl' AT+QCFG='cmux/flowctrl' AT+QCFG='fast/poweroff' 3. Deleted AT+QCFG='apn/display' 4. Updated AT+QCFG='ledmode' (Chapter 3.1.2.6) 5. Updated supported values in AT+QCFG='gpio' (Chapter 3.1.2.7) BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 3 / 60 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 6 1 Introduction ......................................................................................................................................... 7 1.1. Applicable Modules .................................................................................................................... 7 2 AT Command Introduction ................................................................................................................ 8 2.1. Definitions .................................................................................................................................. 8 2.2. AT Command Syntax ................................................................................................................. 8 2.3. AT Command Responses .......................................................................................................... 9 2.4. Declaration of AT Command Examples ................................................................................... 10 3 Description of AT+QCFG Commands............................................................................................. 11 3.1. AT+QCFG Extended Configuration Settings..........................................................................11 3.1.1. Network Related AT Commands ................................................................................... 13 3.1.1.1. AT+QCFG='nwscanmode' Configure RAT(s) to be Searched for.................. 13 3.1.1.2. AT+QCFG='servicedomain' Configure Service Domain ................................ 14 3.1.1.3. AT+QCFG='nwscanseq' Configure RATs Searching Sequence.................... 14 3.1.1.4. AT+QCFG='band' Configure Frequency Band............................................... 16 3.1.1.5. AT+QCFG='iotopmode' Configure Network Category to be Searched for under LTE RAT ..................................................................................................................... 18 3.1.1.6. AT+QCFG='celevel' Get NB-IoT Coverage Enhancement Level .................. 19 3.1.1.7. AT+QCFG='nccconf' Configure NB-IoT Features .......................................... 20 3.1.1.8. AT+QCFG='psm/enter' Trigger the Module into PSM Immediately ............... 21 3.1.1.9. AT+QCFG='psm/urc' Enable/Disable PSM Entering Indication..................... 22 3.1.1.10. AT+QCFG='simeffect' Control RAT Search Order Stored in (U)SIM Card .... 23 3.1.1.11. AT+QCFG='lapiconf' Configure Low Access Priority Indication Feature ....... 24 3.1.1.12. AT+QCFG='nasconfig' Configure NAS Related Parameters......................... 24 3.1.1.13. AT+QCFG='irat/timer' Configure High-Priority RAT Search Timer................. 26 3.1.1.14. AT+QCFG='nb1/bandprior' Configure Band Scan Priority under NB-IoT...... 27 3.1.1.15. AT+QCFG='emmcause' Get the EMM Cause Value ..................................... 28 3.1.1.16. AT+QCFG='sibinfo' Query SIB Information.................................................... 29 3.1.1.17. AT+QCFG='emmtimer' Query EMM Timer .................................................... 30 3.1.1.18. AT+QCFG='msclass' Configure Multislot Class............................................. 30 3.1.1.19. AT+QCFG='ims' Query IMS Registration State ............................................. 31 3.1.1.20. AT+QCFG='snrscan' Configure Band Scan Level under NB-IoT .................. 32 3.1.1.21. AT+QCFG='fgiconfig' Configure Feature Group Indicators ........................... 33 3.1.1.22. AT+QCFG='sim/onchip' Enable/Disable On-Chip SIM .................................. 33 3.1.1.23. AT+QCFG='bandrestore' Restore Default Band Configuration ..................... 34 3.1.1.24. AT+QCFG='bip/auth' Configure the Auth Type in BIP Process ..................... 35 3.1.1.25. AT+QCFG='timer' Query the T3402 Timer..................................................... 36 3.1.1.26. AT+QCFG='timeupdate' Control Automatic Time Update via NITZ ............... 37 BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 4 / 60 LPWA Module Series 3.1.2. Platform Related AT Commands................................................................................... 37 3.1.2.1. AT+QCFG='urc/ri/ring' Configure MAIN_RI Behavior in Case of RING URC 38 3.1.2.2. AT+QCFG='urc/ri/smsincoming' Configure MAIN_RI Behavior in Case of Incoming SMS URCs ........................................................................................................... 39 3.1.2.3. AT+QCFG='urc/ri/other' Configure MAIN_RI Behavior in Case of Other URCs ............................................................................................................................ 40 3.1.2.4. AT+QCFG='risignaltype' Configure MAIN_RI Signal Output Carrier ............. 41 3.1.2.5. AT+QCFG='urc/delay' Configure When to Output URC ................................ 42 3.1.2.6. AT+QCFG='ledmode' Configure NET_STATUS Output Mode ...................... 43 3.1.2.7. AT+QCFG='gpio' Configure GPIO Status ...................................................... 44 3.1.2.8. AT+QCFG='airplanecontrol' Enable/Disable Airplane Mode Control via W_DISABLE# ....................................................................................................................... 48 3.1.2.9. AT+QCFG='cmux/urcport' Configure Output Port of CMUX URCs ............... 49 3.1.2.10. AT+QCFG='apready' Configure AP_READY Behavior.................................. 50 3.1.2.11. AT+QCFG='uartcfg' Control DCD/RI/DTR/RTS/CTS Function...................... 52 3.1.2.12. AT+QCFG='dbgctl' Configure Log Output Level ............................................ 53 3.1.2.13. AT+QCFG='cmux/flowctrl' Configure Hardware Flow Control for CMUX Mode ............................................................................................................................ 53 3.1.2.14. AT+QCFG='fast/poweroff' Control Fast Shutdown Function ......................... 54 4 Summary of CME ERROR Codes .................................................................................................... 56 5 Appendix References ....................................................................................................................... 58 BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 5 / 60 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 7 Table 2: Types of AT Commands ................................................................................................................. 8 Table 3: Summary of CME ERROR Codes ............................................................................................... 56 Table 4: Related Documents ...................................................................................................................... 58 Table 5: Terms and Abbreviations .............................................................................................................. 58 BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 6 / 60 LPWA Module Series 1 Introduction This document describes the AT+QCFG commands supported on BG95 series, BG77 and BG600L-M3 modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 7 / 60 LPWA Module Series 2 AT Command Introduction 2.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. AT+QCFG commands implemented by BG95 series, BG77 and BG600L-M3 modules are categorized as 'Extended' syntax, as illustrated below. ⚫ Extended Command These commands can be operated in several modes, as shown in the following table: Table 2: Types of AT Commands Command Type Syntax Test Command AT+=? Description Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 8 / 60 LPWA Module Series Read Command AT+? Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. Multiple commands can be placed on a single line using a semi-colon (;) between commands. In such cases, only the first command should have AT prefix. Commands can be in upper or lower case. Spaces should be ignored when you enter AT commands, except in the following cases: Within quoted strings, where spaces are preserved; Within an unquoted string or numeric parameter; Within an IP address; Within the AT command name up to and including a =, ? or =?. 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, ERROR will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. 2.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 information responses are sent before the final OK, ERROR or +CME ERROR: . Responses will be in the format of: +CMD1: OK Or OK BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 9 / 60 LPWA Module Series 2.4. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about how to use the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 10 / 60 LPWA Module Series 3 Description of AT+QCFG Commands 3.1. AT+QCFG Extended Configuration Settings The following Test Command shows the supported extended configuration settings of the module. AT+QCFG Extended Configuration Settings Test Command AT+QCFG=? Response +QCFG: 'nwscanmode',(list of supported s),(list of supported s) +QCFG: 'servicedomain',(list of supported s),(list of supported s) +QCFG: 'nwscanseq',(range of supported s),(list of supported s) +QCFG: 'band',(range of supported s),(range of supported s),(range of supported s),(list of supported s) +QCFG: 'iotopmode',(range of supported s),(list of supported s) +QCFG: 'celevel',(range of supported s) +QCFG: 'urc/ri/ring',(list of supported s),(range of supported s),(range of supported s),(range of supported s),(list of supported s),(range of supported s) +QCFG: 'urc/ri/smsincoming',(list of supported s),(range of supported s),(range of supported s) +QCFG: 'urc/ri/other',(list of supported s),(range of supported s),(range of supported s) +QCFG: 'risignaltype',(list of supported s) +QCFG: 'urc/delay',(list of supported s) +QCFG: 'ledmode',(list of supported s) +QCFG: 'gpio',,[,[,,]/[][,< save>]] +QCFG: 'airplanecontrol',(list of supported s) +QCFG: 'cmux/urcport',(range of supported s) +QCFG: 'apready',(list of supported s),(list of supported s),(range of supported s) +QCFG: 'nccconf',(range of supported s) +QCFG: 'psm/enter',(list of supported s) +QCFG: 'psm/urc',(list of supported s) +QCFG: 'simeffect',(list of supported s) +QCFG: 'lapiconf',(range of supported s),(list of supported s) +QCFG: 'nasconfig',(range of supported s) +QCFG: 'irat/timer',(range of supported s),(range of supported s) +QCFG: 'nb1/bandprior', +QCFG: 'emmcause'[,(list of supported s)] +QCFG: 'sibinfo' +QCFG: 'emmtimer' +QCFG: 'msclass'[,(list of supported s),(range of supported s)] +QCFG: 'ims',(list of supported s) +QCFG: 'snrscan'[,(range of supported s)] +QCFG: 'fgiconfig'[,(range of supported s)] +QCFG: 'sim/onchip'[,(list of supported s)[,(list of supported s)]] +QCFG: 'bip/auth',(range of supported s) +QCFG: 'timer', +QCFG: 'timeupdate',(list of supported s) +QCFG: 'uartcfg',(list of supported s) +QCFG: 'dbgctl',(range of supported s) +QCFG: 'cmux/flowctrl',(list of supported s) +QCFG: 'fast/poweroff', ,(list of supported s) +QCFG: 'bandrestore' OK 300 ms / BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 12 / 60 LPWA Module Series 3.1.1. Network Related AT Commands 3.1.1.1. AT+QCFG='nwscanmode' Configure RAT(s) to be Searched for This Write Command configures the RAT(s) to be searched for or queries the current setting. AT+QCFG='nwscanmode' Configure RAT(s) to be Searched for Write Command AT+QCFG='nwscanmode'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'nwscanmode', OK If any of the optional parameters is specified, configure the RAT(s) to be searched for: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms determines when the command will take effect. The configurations will be saved automatically. Parameter Integer type. RAT(s) to be searched for. 0 Automatic (GSM and LTE) 1 GSM only 3 LTE only Integer type. When to take effect. 0 Take effect after rebooting 1 Take effect immediately Error code. See Chapter 4 for details . NOTE This command is valid only on BG95-M3, BG95-M5 and BG600L-M3 modules. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 13 / 60 LPWA Module Series 3.1.1.2. AT+QCFG='servicedomain' Configure Service Domain This Write Command configures the service domain to be registered or queries the current setting. AT+QCFG='servicedomain' Configure Service Domain Write Command Response AT+QCFG='servicedomain'[,[,]] +QCFG: 'servicedomain', OK If any of the optional parameters is specified, configure the service domain to be registered: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms determines when the command will take effect. The configurations will be saved automatically. Parameter Integer type. Service domain to be registered. 1 PS only 2 CS & PS Integer type. When to take effect. 0 Take effect after rebooting 1 Take effect immediately Error code. See Chapter 4 for details. 3.1.1.3. AT+QCFG='nwscanseq' Configure RATs Searching Sequence This Write Command configures the searching sequence of RATs or queries the current setting. AT+QCFG='nwscanseq' Configure RATs Searching Sequence Write Command Response AT+QCFG='nwscanseq'[,[ If the optional parameters are omitted, query the current BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 14 / 60 LPWA Module Series ,]] Maximum Response Time Characteristics setting: +QCFG: 'nwscanseq', OK If any of the optional parameters is specified, configure the RAT searching sequence: OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms determines when the command will take effect. The configurations will be saved automatically. Parameter Integer type. RATs searching sequence, e.g.: 020301 stands for eMTC → NB-IoT → GSM. 00 Automatic (eMTC → NB-IoT → GSM) 01 GSM 02 eMTC 03 NB-IoT Integer type. When to take effect. 0 Take effect after rebooting 1 Take effect immediately Error code. See Chapter 4 for details. NOTE 1. The command is invalid on BG95-M1 module. 2. GSM RAT is valid only on BG95-M3, BG95-M5 and BG600L-M3 modules. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 15 / 60 LPWA Module Series 3.1.1.4. AT+QCFG='band' Configure Frequency Band This Write Command configures the frequency bands to be searched for or queries the current setting. AT+QCFG='band' Configure Frequency Band Write Command AT+QCFG='band'[,, ,[ ,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'band',,, OK If any of the optional parameters is specified, configure the frequency bands to be searched for: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms determines when the command will take effect. The configurations will be saved automatically. Parameter A hexadecimal value that specifies the GSM frequency band (e.g.: 0xa = 0x2(DCS1800) + 0x8(PCS1900)). If it is set to 0, it means not to change GSM frequency band. 0 No change 0x1 EGSM900 0x2 DCS1800 0x4 GSM850 0x8 PCS1900 0xF All of the supported bands above A hexadecimal value that specifies the eMTC frequency band (e.g.: 0x15 = 0x1(LTE B1) + 0x4(LTE B3) + 0x10(LTE B5)). If it is set to 0, it means not to change the eMTC frequency band. 0 No change 0x1 (BAND_PREF_LTE_BAND1) LTE B1 BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 16 / 60 LPWA Module Series 0x2 (BAND_PREF_LTE_BAND2) LTE B2 0x4 (BAND_PREF_LTE_BAND3) LTE B3 0x8 (BAND_PREF_LTE_BAND4) LTE B4 0x10 (BAND_PREF_LTE_BAND5) LTE B5 0x80 (BAND_PREF_LTE_BAND8) LTE B8 0x800 (BAND_PREF_LTE_BAND12) LTE B12 0x1000 (BAND_PREF_LTE_BAND13) LTE B13 0x20000 (BAND_PREF_LTE_BAND18) LTE B18 0x40000 (BAND_PREF_LTE_BAND19) LTE B19 0x80000 (BAND_PREF_LTE_BAND20) LTE B20 0x1000000 (BAND_PREF_LTE_BAND25) LTE B25 0x2000000 (BAND_PREF_LTE_BAND26) LTE B26 0x4000000 (BAND_PREF_LTE_BAND27) LTE B27 0x8000000 (BAND_PREF_LTE_BAND28) LTE B28 0x40000000 (BAND_PREF_LTE_BAND31) LTE B31 0x20000000000000000 (BAND_PREF_LTE_BAND66) LTE B66 0x800000000000000000 (BAND_PREF_LTE_BAND72 LTE B72 0x1000000000000000000 (BAND_PREF_LTE_BAND73) LTE B73 0x1000000000000000000000 (BAND_PREF_LTE_BAND85) LTE B85 A hexadecimal value that specifies the NB-IoT frequency band (e.g.: 0x15 = 0x1(LTE B1) + 0x4(LTE B3) + 0x10(LTE B5)). If it is set to 0, it means not to change the NB-IoT frequency band. 0 No change 0x1 (BAND_PREF_LTE_BAND1) LTE B1 0x2 (BAND_PREF_LTE_BAND2) LTE B2 0x4 (BAND_PREF_LTE_BAND3) LTE B3 0x8 (BAND_PREF_LTE_BAND4) LTE B4 0x10 (BAND_PREF_LTE_BAND5) LTE B5 0x80 (BAND_PREF_LTE_BAND8) LTE B8 0x800 (BAND_PREF_LTE_BAND12) LTE B12 0x1000 (BAND_PREF_LTE_BAND13) LTE B13 0x20000 (BAND_PREF_LTE_BAND18) LTE B18 0x40000 (BAND_PREF_LTE_BAND19) LTE B19 0x80000 (BAND_PREF_LTE_BAND20) LTE B20 0x1000000 (BAND_PREF_LTE_BAND25) LTE B25 0x8000000 (BAND_PREF_LTE_BAND28) LTE B28 0x40000000 (BAND_PREF_LTE_BAND31) LTE B31 0x20000000000000000 (BAND_PREF_LTE_BAND66) LTE B66 0x400000000000000000 (BAND_PREF_LTE_BAND71) LTE B71 0x800000000000000000 (BAND_PREF_LTE_BAND72) LTE B72 0x1000000000000000000 (BAND_PREF_LTE_BAND73) LTE B73 0x1000000000000000000000 (BAND_PREF_LTE_BAND85) LTE B85 Integer type. When to take effect. 0 Take effect after rebooting BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 17 / 60 1 Take effect immediately Error code. See Chapter 4 for details. LPWA Module Series NOTE 1. For the specific bands supported by each model, see corresponding specifications of the modules. ⚫ is valid only on BG95-M3, BG95-M5 and BG600L-M3 modules. ⚫ is invalid on BG95-M1 module. ⚫ LTE B31/B72/B73 is valid on BG95-M4 module only. 2. The value setting of when all eMTC bands are intended to be searched for: ⚫ 0x100182000000004F0E189F for BG95-M4 ⚫ 0x100002000000000F0E189F for BG77, BG600L-M3 and other BG95 series modules 3. The value setting of when all NB-IoT bands are intended to be searched for: ⚫ 0x10018200000000490E189F for BG95-M4 ⚫ 0x10004200000000090E189F for BG77, BG600L-M3 and other BG95 series modules 3.1.1.5. AT+QCFG='iotopmode' Configure Network Category to be Searched for under LTE RAT This Write Command configures the network category to be searched for under LTE RAT or queries the current setting. AT+QCFG='iotopmode' Configure Network Category to be Searched for under LTE RAT Write Command Response AT+QCFG='iotopmode'[,[,]] setting: +QCFG: 'iotopmode', OK If any of the optional parameters is specified, configure the network category to be searched for under LTE RAT: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms determines when the command will take effect. The configurations will be saved automatically. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 18 / 60 LPWA Module Series Parameter Integer type. Network category to be searched for under LTE RAT. 0 eMTC 1 NB-IoT 2 eMTC and NB-IoT Integer type. When to take effect. 0 Take effect after rebooting 1 Take effect immediately Error code. See Chapter 4 for details. NOTE This command is invalid on BG95-M1 module. 3.1.1.6. AT+QCFG='celevel' Get NB-IoT Coverage Enhancement Level This Write Command queries NB-IoT coverage enhancement level. AT+QCFG='celevel' Get NB-IoT Coverage Enhancement Level Write Command AT+QCFG='celevel' Response +QCFG: 'celevel', OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Integer type. NB-IoT coverage enhancement level. 0 CE level 0 1 CE level 1 2 CE level 2 Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 19 / 60 LPWA Module Series 3.1.1.7. AT+QCFG='nccconf' Configure NB-IoT Features This Write Command configures NB-IoT features or queries the current setting. AT+QCFG='nccconf' Configure NB-IoT Features Write Command AT+QCFG='nccconf'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'nccconf', OK If the optional parameter is specified, configure NB-IoT features: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Hexadecimal value. If any bit is set to 1, it means the corresponding feature is enabled, otherwise it is disabled. The NB-IoT features are as follows: Bit 0 Enable or disable the use of EMM_CP_CIOT Bit 1 Enable or disable the use of EMM_UP_CIOT Bit 2 Enable or disable the use of EMM_S1_U Bit 3 Enable or disable the use of EMM_ER_WITHOUT_PDN Bit 4 Enable or disable the use of EMM_HC_CP_CIOT Bit 5 Enable or disable the use of EMM_SMS_ONLY Bit 6 Enable or disable the use of EMM_PNB_CP_CIOT Bit 7 Enable or disable the use of EMM_PNB_UP_CIOT Bit 8 Enable or disable the use of EMM_EPCO_CIOT Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 20 / 60 LPWA Module Series 3.1.1.8. AT+QCFG='psm/enter' Trigger the Module into PSM Immediately This Write Command configures whether to trigger the module to enter PSM immediately after the RRC connection release is received or queries the current setting. When =1, the module skips active timer (T3324) and enters PSM immediately after the RRC connection release is received. AT+QCFG='psm/enter' Trigger the Module into PSM Immediately Write Command AT+QCFG='psm/enter'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'psm/enter', OK If the optional parameter is specified, configure whether to trigger the module into PSM immediately after the RRC connection release is received: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Whether to trigger the module into PSM immediately. 0 Enter PSM after T3324 expires 1 Enter PSM immediately after RRC connection release is received. Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 21 / 60 LPWA Module Series 3.1.1.9. AT+QCFG='psm/urc' Enable/Disable PSM Entering Indication This Write Command configures whether to enable PSM entering indication URC +QPSMTIMER: , which is used to indicate the TAU timer and the duration the module stays active before entering PSM, or queries the current setting. When PSM function is enabled and RRC connection release is received, the active timer (T3324) will be started, and the indication URC will be reported. AT+QCFG='psm/urc' Enable/Disable PSM Entering Indication Write Command AT+QCFG='psm/urc'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'psm/urc', OK If the optional parameter is specified, configure whether to enable the PSM entering indication: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Enable/disable the output of PSM entering indication URC +QPSMTIMER: ,. If enabled, the URC will be reported when RRC connection release is received. 0 Disable 1 Enable Integer type. The interval for periodic tracking area updating. Integer type. The duration the module stays active before entering PSM. Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 22 / 60 LPWA Module Series NOTE When AT+QCFG='psm/urc',1 and AT+QCFG='psm/enter',1 are executed at the same time, there will be a possibility that the URC +QPSMTIMER: , cannot be outputted because the module enters PSM immediately. 3.1.1.10. AT+QCFG='simeffect' Control RAT Search Order Stored in (U)SIM Card This Write Command enables/disables the RAT search order stored in (U)SIM card or queries the current setting. AT+QCFG='simeffect' Control RAT Search Order Stored in (U)SIM Cards Write Command AT+QCFG='simeffect'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'simeffect', OK If the optional parameter is specified, enable/disable RAT search order stored in (U)SIM cards: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Enable/disable the RAT search order stored in (U)SIM card. 0 Disable 1 Enable Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 23 / 60 LPWA Module Series 3.1.1.11. AT+QCFG='lapiconf' Configure Low Access Priority Indication Feature This Write Command configures the low access priority indication (LAPI) feature or queries the current setting. AT+QCFG='lapiconf' Configure Low Access Priority Indication Feature Write Command AT+QCFG='lapiconf'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'lapiconf',[,] OK If any of the optional parameters is specified, configure the low access priority indication feature: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configurations will be saved automatically. Parameter Integer type. Whether to enable low access priority indication feature. 0 Disable. Forced to disable 1 Enable. Forced to enable 2 Auto. Determined by (U)SIM/EFS Integer type. Whether takes effect. This parameter is valid only when =1 or 2. 0 Do not take effect 1 Take effect Error code. See Chapter 4 for details. 3.1.1.12. AT+QCFG='nasconfig' Configure NAS Related Parameters This Write Command configures NAS related parameters or queries the current setting. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 24 / 60 LPWA Module Series AT+QCFG='nasconfig' Configure NAS Related Parameters Write Command AT+QCFG='nasconfig'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'nasconfig', OK If the optional parameter is specified, configure NAS related parameters: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Hexadecimal value. If any bit is set to 1, it means the corresponding feature is enabled, otherwise it is disabled. The NAS related parameters are as follows: Bit 0 Enable or disable the use of NAS_SIGNALLING_PRIORITY Bit 1 Enable or disable the use of NMO_I_BEHAVIOUR Bit 2 Enable or disable the use of ATTACH_WITH_IMSI Bit 3 Enable or disable the use of MINIMUM_PERIODIC_SEARCH_TIMER Bit 4 Enable or disable the use of EXTENDED_ACCESS_BARRING Bit 5 Enable or disable the use of TIMER_T3245_BEHAVIOUR Bit 6 Enable or disable the use of OVERRIDE_NAS_SIGNALLING_LOW_PRIORITY Bit 7 Enable or disable the use of OVERRIDE_EXTENDED_ACCESS_BARRING Bit 8 Enable or disable the use of FAST_FIRST_HIGHER_PRIORITY_PLMN_SEARCH Bit 9 Enable or disable the use of EUTRA_DISABLING_ALLOWED_FOR_EMM_CAUSE_15 Bit 10 Enable or disable the use of SM_RETRY_WAIT_TIME Bit 11 Enable or disable the use of SM_RETRY_AT_RAT_CHANGE Bit 12 Enable or disable the use of DEFAULT_DCN_ID Bit 13 Enable or disable the use of EXCEPTION_DATA_REPORTING_ALLOWED Bit 14 Enable or disable the use of LIGHT_CONNECTION BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 25 / 60 Error code. See Chapter 4 for details. LPWA Module Series 3.1.1.13. AT+QCFG='irat/timer' Configure High-Priority RAT Search Timer This Write Command configures the high-priority RAT search timer or queries the current setting. If the module is in a low-priority RAT, it periodically attempts to obtain RAT services of higher priority, and the interval is . AT+QCFG='irat/timer' Configure High-Priority RAT Search Timer Write Command AT+QCFG='irat/timer'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'irat/timer',, OK If any of the optional parameters is specified, configure the high-priority RAT search timer: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configurations will be saved automatically. Parameter Integer type. Timeout value for high-priority RAT search timer. Range: 5–300. Default: 60. Unit: minute. Integer type. This parameter specifies the interval before eDRX paging when a scan should begin. Range: 5–20. Default: 20. Unit: minute. Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 26 / 60 LPWA Module Series 3.1.1.14. AT+QCFG='nb1/bandprior' Configure Band Scan Priority under NB-IoT This Write Command configures the band scan priority under NB-IoT or queries the current setting. AT+QCFG='nb1/bandprior' Configure Band Scan Priority under NB-IoT Write Command Response AT+QCFG='nb1/bandprior'[,] +QCFG: 'nb1/bandprior', OK If the optional parameter is specified, configure the band scan priority under NB-IoT: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Hex string. NB-IoT band(s) of scan priority. 01 Band 1 02 Band 2 03 Band 3 04 Band 4 05 Band 5 08 Band 8 0C Band 12 0D Band 13 12 Band 18 13 Band 19 14 Band 20 19 Band 25 1C Band 28 1F Band 31 42 Band 66 BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 27 / 60 47 Band 71 48 Band 72 49 Band 73 55 Band 85 Error code. See Chapter 4 for details. NOTE 1. This command is invalid on BG95-M1 module. 2. Bands 31, 72 and 73 are valid on BG95-M4 module only. LPWA Module Series 3.1.1.15. AT+QCFG='emmcause' Get the EMM Cause Value This Write Command queries the EMM cause value for the rejected attach request. AT+QCFG='emmcause' Get the EMM Cause Value Write Command AT+QCFG='emmcause'[,] Response +QCFG: 'emmcause', OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. The display format of EMM cause value. 0 Numeric value 1 Verbose value EMM reject cause value. See 3GPP 24.301 for details. Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 28 / 60 LPWA Module Series 3.1.1.16. AT+QCFG='sibinfo' Query SIB Information This Write Command queries the SIB information. AT+QCFG='sibinfo' Query SIB Information Write Command AT+QCFG='sibinfo' Response +QCFG: 'sibinfo',,,,,,,,, OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Integer type. EARFCN of the serving cell. Range: 0–65535. Integer type. Physical cell ID. Range: 0–503. Integer type. The minimum required RX level in the cell. Range: 0–140. Unit: dBm. Integer type. The minimum required quality level in the cell. Range: 0–140. Unit: dB. Integer type. Cell selection parameter that specifies the Srxlev threshold (in dB) for intra-frequency measurements. Integer type. Cell reselection priority. Range: 0–7. Value 0 means lowest priority. Integer type. Specifies the suitable reception level threshold used by the UE on the serving cell when reselecting towards a lower-priority RAT/frequency. Unit: dB. Integer type. Threshold to control non-intra-frequency searches. Integer type. Idle DRX cycle length. Unit: ms. Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 29 / 60 LPWA Module Series 3.1.1.17. AT+QCFG='emmtimer' Query EMM Timer This Write Command queries EPS mobility management timer. AT+QCFG='emmtimer' Query EMM Timer Write Command AT+QCFG='emmtimer' Response +QCFG: 'emmtimer',, OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Integer type. T3402 timer value. Default: 720. Unit: s. See 3GPP 24.301. Integer type. T3412 timer value. Unit: s. See 3GPP 24.301. Error code. See Chapter 4 for details. 3.1.1.18. AT+QCFG='msclass' Configure Multislot Class This Write Command queries or configures the multislot class. AT+QCFG='msclass' Configure Multislot Class Write Command AT+QCFG='msclass'[,, ] Response If the optional parameters are omitted, query the current setting: +QCFG: 'msclass',, OK If the optional parameters are specified, configure GPRS and EGPRS multislot class: OK BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 30 / 60 LPWA Module Series Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configurations will be saved automatically. Parameter Integer type. GPRS multislot class. Range: 0–18, 30–34. Default: 12. Integer type. EGPRS multislot class. Range: 0–34. Default: 12. Error code. See Chapter 4 for details. 3.1.1.19. AT+QCFG='ims' Query IMS Registration State This Write Command queries module’s IMS registration state. AT+QCFG='ims' Query IMS Registration State Write Command AT+QCFG='ims' Response +QCFG: 'ims', OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Integer type. VoLTE state. 0 VoLTE is not ready 1 VoLTE is ready Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 31 / 60 NOTE This command is valid only on the firmware version supporting VoLTE. LPWA Module Series 3.1.1.20. AT+QCFG='snrscan' Configure Band Scan Level under NB-IoT This command configures SNR level of band scan process under NB-IoT or queries the current setting. AT+QCFG='snrscan' Configure Band Scan Level under NB-IoT Write Command AT+QCFG='snrsnan'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'snrscan', OK If the optional parameter is specified, configure SNR level of band scan process under NB-IoT: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Signal noise ratio level. 0 SNR level 0 1 SNR level 0 & 1 2 SNR level 0 & 1 & 2 Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 32 / 60 LPWA Module Series 3.1.1.21. AT+QCFG='fgiconfig' Configure Feature Group Indicators This Write Command queries or configures feature group indicators (FGI). AT+QCFG='fgiconfig' Configure Feature Group Indicators Write Command AT+QCFG='fgiconfig'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'fgiconfig', OK If the optional parameter is specified, configure FGI features: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting The configuration will be saved automatically. Parameter Hexadecimal value. Feature group indicators (FGI). Range: 0–0xFFFFFFFF. See 3GPP 36.331. Error code. See Chapter 4 for details. 3.1.1.22. AT+QCFG='sim/onchip' Enable/Disable On-Chip SIM This Write Command queries or configures whether to enable on-chip SIM. AT+QCFG='sim/onchip' Enable/Disable On-Chip SIM Write Command AT+QCFG='sim/onchip'[,[,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'sim/onchip', BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 33 / 60 LPWA Module Series Maximum Response Time Characteristics OK If any of the optional parameters is specified, enable/disable on-chip SIM: OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms determines when the command will take effect. The configurations will be saved automatically. Parameter Integer type. Enable/disable on-chip SIM. 0 Disable 1 Enable Integer type. When to take effect. 0 Take effect after rebooting 1 Take effect immediately Error code. See Chapter 4 for details. 3.1.1.23. AT+QCFG='bandrestore' Restore Default Band Configuration This Write Command restores the default band configuration. AT+QCFG='bandrestore' Restore Default Band Configuration Write Command AT+QCFG='bandrestore' Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 34 / 60 Parameter Error code. See Chapter 4 for details. LPWA Module Series 3.1.1.24. AT+QCFG='bip/auth' Configure the Auth Type in BIP Process This Write Command queries or configures the auth type in BIP process. AT+QCFG='bip/auth' Configure the Auth Type in BIP Process Write Command AT+QCFG='bip/auth'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'bip/auth', OK If the optional parameter is specified, configure the auth type in BIP process: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Auth type. 0 None 1 PAP 2 CHAP 3 PAP or CHAP Error code. See Chapter 4 for details. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 35 / 60 LPWA Module Series 3.1.1.25. AT+QCFG='timer' Query the T3402 Timer This Write Command queries the T3402 timer. AT+QCFG='timer' Query the T3402 Timer Write Command AT+QCFG='timer', Response +QCFG: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Integer type. 3402 T3402 timer. See 3GPP 24.301 for details. Integer type. T3402 timer value. Default: 720. Unit: s. Error code. See Chapter 4 for details. Example AT+QCFG='timer',3402 +QCFG: 720 OK BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 36 / 60 LPWA Module Series 3.1.1.26. AT+QCFG='timeupdate' Control Automatic Time Update via NITZ This Write Command queries or configures whether to enable automatic time update via NITZ. After receiving the NITZ message from network, UE will decode the timestamp and update it to local RTC by default. AT+QCFG='timeupdate' Control Automatic Time Update via NITZ Write Command AT+QCFG='timeupdate'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'timeupdate', OK If the optional parameter is specified, enable/disable automatic time update via NITZ: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Enable/disable automatic time update via NITZ. 0 Disable 1 Enable Error code. See Chapter 4 for details. 3.1.2. Platform Related AT Commands Among the following AT commands, AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other' control the behavior of MAIN_RI pin when a URC is reported. MAIN_RI is active low. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 37 / 60 LPWA Module Series 3.1.2.1. AT+QCFG='urc/ri/ring' Configure MAIN_RI Behavior in Case of RING URC This Write Command queries or configures the behavior of MAIN_RI pin implemented when the URC RING is presented to indicate an incoming call. The sum of and determines the interval time of RING indications when a call is coming. AT+QCFG='urc/ri/ring' Configure MAIN_RI Behavior in Case of RING URC Write Command AT+QCFG='urc/ri/ring'[,[,[,[,[,[,]]]]]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'urc/ri/ring',,,,,, OK If any of the optional parameters is specified, configure the behavior of MAIN_RI pin implemented when the URC RING is presented: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter String type. The behavior of MAIN_RI pin when URC RING is presented. 'off' No change. MAIN_RI keeps inactive (high level). 'pulse' Pulse. Pulse width is determined by . 'always' Change to active. MAIN_RI behavior can be restored to inactive by AT+QRIR (see document [1] for details). 'auto' When RING is presented to indicate an incoming call, MAIN_RI changes to active and keeps active. When the ring of the incoming call ends, either answering or hanging up the incoming BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 38 / 60 LPWA Module Series call changes MAIN_RI to inactive. 'wave' When RING is presented to indicate an incoming call, MAIN_RI outputs a square wave. Both and are used to set the square wave. When the ring of incoming call ends, either answering or hanging up the incoming call changes MAIN_RI to inactive. Integer type. The width of pulse. Range: 1–2000. Default: 120. Unit: ms. This parameter is valid only when ='pulse'. Integer type. The active duration of square wave. Range: 1–10000. Default: 1000. Unit: ms. This parameter is valid only when ='wave'. Integer type. The inactive duration of square wave. Range: 1–10000. Default: 5000. Unit: ms. This parameter is valid only when ='wave'. String type. Set whether the MAIN_RI behavior could be disturbed. This parameter is valid only when ='auto' or 'wave'. For example, when ='wave', if you want the square wave not to be disturbed by other URCs (including SMS related URCs), then should be set to 'on'. 'off' MAIN_RI behavior can be disturbed by other URCs when the behavior is caused by an incoming call ringing. 'on' MAIN_RI behavior cannot be disturbed by other URCs when the behavior is caused by an incoming call ringing. Integer type. The count of pulse. This parameter is valid only when ='pulse'. Range: 1–5. Default: 1. The interval time between two pulses is equal to . Error code. See Chapter 4 for details. 3.1.2.2. AT+QCFG='urc/ri/smsincoming' Configure MAIN_RI Behavior in Case of Incoming SMS URCs This Write Command queries or configures the behavior of MAIN_RI pin implemented when related incoming message URCs are presented. Incoming message URCs include +CMTI, +CMT, +CDS, and +CBM. For more details, please refer to document [1]. AT+QCFG='urc/ri/smsincoming' Configure MAIN_RI Behavior in Case of Incoming SMS URCs Write Command Response AT+QCFG='urc/ri/smsincoming'[,[,[,]]] +QCFG: 'urc/ri/smsincoming',,, OK BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 39 / 60 LPWA Module Series Maximum Response Time Characteristics If any of the optional parameters is specified, configure the MAIN_RI behavior implemented when incoming SMS URCs are presented: OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter String type. MAIN_RI behavior implemented when SMS URCs are presented. 'off' No change. MAIN_RI keeps inactive (high level). 'pulse' Pulse. Pulse width is determined by . 'always' Change to active. MAIN_RI behavior can be restored to inactive by AT+QRIR (see document [1] for details). Integer type. The width of pulse. Range: 1–2000. Default: 120. Unit: ms. This parameter is valid only when ='pulse'. Integer type. The count of pulse. It is valid only when ='pulse'. Range: 1–5. Default: 1. The interval time between two pulses is equal to . Error code. See Chapter 4 for details. 3.1.2.3. AT+QCFG='urc/ri/other' Configure MAIN_RI Behavior in Case of Other URCs This Write Command queries or configures the behavior of MAIN_RI pin when other URCs are presented. AT+QCFG='urc/ri/other' Configure MAIN_RI Behavior in Case of Other URCs Write Command AT+QCFG='urc/ri/other'[,[,[,]]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'urc/ri/other',,, OK If any of the optional parameters is specified, configure the BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 40 / 60 LPWA Module Series Maximum Response Time Characteristics MAIN_RI behavior when other URCs are presented: OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter String type. MAIN_RI behavior when other URCs are presented. 'off' No change. MAIN_RI keeps inactive (high level). 'pulse' Pulse. Pulse width is determined by . Integer type. The width of pulse. Range: 1–2000. Default: 120. Unit: ms. This parameter is valid only when ='pulse'. Integer type. The count of pulse. This parameter is valid only when ='pulse'. Range: 1–5. Default: 1. The interval time between two pulses is equal to . Error code. See Chapter 4 for details. 3.1.2.4. AT+QCFG='risignaltype' Configure MAIN_RI Signal Output Carrier This Write Command queries or configures the MAIN_RI signal output carrier. AT+QCFG='risignaltype' Configure MAIN_RI Signal Output Carrier Write Command AT+QCFG='risignaltype'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'risignaltype', OK If the optional parameter is specified, configure the MAIN_RI signal output carrier: OK If there is an error related to ME functionality: +CME ERROR: BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 41 / 60 LPWA Module Series Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter String type. MAIN_RI signal output carrier. 'respective' MAIN_RI behavior on the port where URC is presented. For example, if URC is presented on UART port, it is a physical ring indication signal. If URC is presented on USB modem port, it is a virtual ring indication signal. AT+QURCCFG='urcport' can get the port on which URC is presented, and see document [1] for details of the AT command. 'physical' No matter on which port the URC is presented, it only causes the behavior of physical ring indication signal. Error code. See Chapter 4 for details. 3.1.2.5. AT+QCFG='urc/delay' Configure When to Output URC This Write Command queries or configures when to output the URC. AT+QCFG='urc/delay' Configure When to Output URC Write Command AT+QCFG='urc/delay'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'urc/delay', OK If the optional parameter is specified, configure when to output the URC: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time If there is any other error: ERROR 300 ms BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 42 / 60 LPWA Module Series Characteristics The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. When to output the URC. 0 Output URC when ring indication pulse starts. 1 Output URC when ring indication pulse ends (effective only when ='pulse'. Refer to AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other' for more details). Error code. See Chapter 4 for details. 3.1.2.6. AT+QCFG='ledmode' Configure NET_STATUS Output Mode This Write Command queries or configures the output mode of NET_STATUS pin. AT+QCFG='ledmode' Configure NET_STATUS Output Mode Write Command AT+QCFG='ledmode'[,[,,]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'ledmode',[,,] OK If any of the optional parameters is specified, configure the output mode of NET_STATUS pin: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Output mode of NET_STATUS pin. 0 Flicker mode. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 43 / 60 LPWA Module Series Network searching: LED is on for 200 ms (high level); LED is off for 1800 ms (low level) Idle: LED is on for 1800 ms (high level); LED is off for 200 ms (low level) Data transfer is ongoing: LED is on for 125 ms (high level); LED is off for 125 ms (low level) Voice calling: always high 1 Output high level when attaching to the network and low level in other conditions. 3 Set NET_STATUS pin as customization mode Integer type. The high-level duration of NET_STATUS pin in customization mode. Range: 0–60000. Default: 500. Unit: ms. Integer type. The low-level duration of NET_STATUS pin in customization mode. Range: 0–60000. Default: 500. Unit: ms. Error code. See Chapter 4 for details. Example AT+QCFG='ledmode',1 OK AT+QCFG='ledmode' +QCFG: 'ledmode',1 OK //Set the NET_STATUS mode //Query the current configuration 3.1.2.7. AT+QCFG='gpio' Configure GPIO Status This Write Command queries or configures the GPIO status. AT+QCFG='gpio' Configure GPIO Status Write Command Query the formats of the command AT+QCFG='gpio' Response +QCFG: 'gpio',,[,[,,]/[][,]] Write Command AT+QCFG='gpio',,[,[,,]/[][,]] OK Response If =2, then all optional parameters should be omitted: +QCFG: 'gpio', OK If =1, then should be omitted: OK If =3, then , and should be BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 44 / 60 LPWA Module Series Maximum Response Time Characteristics omitted: OK If there is an error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. determines whether the configurations will be saved. Parameter Integer type. Command mode. 1 Initialize GPIO status 2 Query GPIO status 3 Configure GPIO status Integer type. The corresponding pin number of the module’s GPIO. BG95 series module supports the following pin numbers: 4 5 6 7 18 19 22 23 25 26 27 28 30 36 37 38 39 40 41 64 65 66 85 86 87 88 BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 45 / 60 BG77 supports the following pin numbers: 1 2 3 4 5 8 9 33 34 35 36 37 38 39 40 41 57 60 61 62 63 76 77 90 BG600L-M3 supports the following pin numbers: 9 10 11 12 22 23 29 30 35 36 37 38 39 53 54 57 58 59 BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual LPWA Module Series 46 / 60 60 61 62 Integer type. GPIO pin direction. 0 Input 1 Output Integer type. GPIO pin pull type. 0 No pull 1 Pull the GPIO down 2 Keep the GPIO as it is 3 Pull the GPIO up Integer type. GPIO pin drive strength. 0 2 mA 1 4 mA 2 6 mA 3 8 mA 4 10 mA 5 12 mA 6 14 mA 7 16 mA Integer type. The value read from or write to a GPIO. 0 Low level 1 High level Integer type. Whether to save the configurations. 0 Not save 1 Save Error code. See Chapter 4 for details. LPWA Module Series NOTE 1. means whether the module will save the current configuration and whether this configuration will be used to set related GPIO at next power-up. 2. is valid only when is 1 or 3. 3. For the value of , see corresponding hardware design for details. 4. Pin numbers 30, 36, 37, 38, 39 supported by BG95 series module and 38, 39, 62, 76, 90 supported by BG77 module and 35, 36, 37, 38, 39, supported by BG600L-M3 module are used for main UART by default; if they are used for GPIO function, please disable DCD/RI/DTR/RTS/CTS function first through AT+QCFG='uartcfg'. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 47 / 60 LPWA Module Series 3.1.2.8. AT+QCFG='airplanecontrol' Enable/Disable Airplane Mode Control via W_DISABLE# This Write Command enables/disables airplane mode control via the W_DISABLE# pin or queries the current setting. If the function is enabled, the module enters the airplane mode when the pin is pulled down and enters normal mode when the pin is pulled up. Also, related URC will be outputted before the module enters or exits the airplane mode. When the W_DISABLE# pin level becomes valid, the pulse signal generated on the MAIN_RI pin will still be outputted according to the configured mode, and the pulse signal will not be buffered. AT+QCFG='airplanecontrol' Enable/Disable Airplane Mode Control via W_DISABLE# Write Command Response AT+QCFG='airplanecontrol'[,] airplane mode control via W_DISABLE# is enabled and the current status of the module: +QCFG: 'airplanecontrol',, OK Maximum Response Time Characteristics If the optional parameter is specified, configure whether to enable the airplane mode control via W_DISABLE# pin: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Enable/disable airplane mode control via W_DISABLE# pin. 0 Disable 1 Enable The following URC will be reported when pulling up or down W_DISABLE# pin if airplane mode control via W_DISABLE# pin is enabled: +QIND: 'airplanestatus', Integer type. The current status of the module. 0 In normal mode 1 ln airplane mode BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 48 / 60 LPWA Module Series NOTE 1. The status of the W_DISABLE# pin may affect the validity of AT+CFUN (see document [1]). When airplane mode control via W_DISABLE# is enabled and the pin is pulled down, the module enters airplane mode no matter which status the module is set to via AT+CFUN, and also the module’s functionality level cannot be switched with AT+CFUN. 2. The function is only applicable for BG95 series module and BG77 module. For more details about W_DISABLE# pin, see the corresponding hardware design. Example AT+QCFG='airplanecontrol',1 OK //Pull down W_DISABLE# pin +QIND: 'airplanestatus',1 //Enable airplane mode control via W_DISABLE# //URC indicating that the module enters airplane mode AT+QCFG='airplanecontrol' +QCFG: 'airplanestatus',1,1 //Query whether airplane mode control via W_DISABLE# is enabled and the current status of the module //Airplane mode control via W_DISABLE# is enabled and the module is in airplane mode currently OK //Pull up W_DISABLE# pin +QIND: 'airplanestatus',0 //The module exits from airplane mode AT+QCFG='airplanecontrol' +QCFG: 'airplanestatus',1,0 //Query whether airplane mode control via W_DISABLE# is enabled and the current status of the module //Airplane mode control via W_DISABLE# is enabled and the module is in normal mode currently OK 3.1.2.9. AT+QCFG='cmux/urcport' Configure Output Port of CMUX URCs This Write Command queries or configures the output port of CMUX URCs. AT+QCFG='cmux/urcport' Configure Output Port of CMUX URCs Write Command AT+QCFG='cmux/urcport'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'cmux/urcport', BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 49 / 60 LPWA Module Series Maximum Response Time Characteristics OK If the optional parameter is specified, configure the output port of CMUX URCs: OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Output port of CMUX URCs. 0 All ports 1 Virtual port 1 2 Virtual port 2 3 Virtual port 3 4 Virtual port 4 Error code. See Chapter 4 for details. 3.1.2.10. AT+QCFG='apready' Configure AP_READY Behavior This Write Command queries or configures the behavior of AP_READY pin. An external MCU can change the AP_READY pin level as needed. When there is a URC to be reported, if the AP_READY pin level is invalid, the URC is buffered first, and the AP_READY pin level will be detected periodically according to the configured detection period. The URC will be outputted when the AP_READY pin level becomes valid. The pulse signal generated on the MAIN_RI pin can still be outputted according to the configured mode, and the pulse signal will not be buffered. AT+QCFG='apready' Configure AP_READY Behavior Write Command AT+QCFG='apready'[,[,[,]]] Response If the optional parameters are omitted, query the current setting: +QCFG: 'apready',,, BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 50 / 60 LPWA Module Series Maximum Response Time Characteristics OK If any of the optional parameters is specified, configure the AP_READY behavior: OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Enable/disable the AP_READY pin for AP sleep state detection. 0 Disable 1 Enable Integer type. Valid level of AP_READY. The parameter is valid only when the AP_READY detection function is enabled. 0 Low level 1 High level Integer type. Detection interval. Range: 100–3000. Default: 500. Unit: ms. This parameter is valid only when the AP_READY detection function is enabled. Error code. See Chapter 4 for details. NOTE 1. Maximally 15 URCs can be buffered. When the number of URC exceeds 15, the oldest one in the buffer will be cleared to store the new URC. 2. The RING URC is buffered only once for each call process. 3. The function is only applicable for BG95 series module and BG77 module. For details about AP_READY pin, see the corresponding hardware design. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 51 / 60 LPWA Module Series 3.1.2.11. AT+QCFG='uartcfg' Control DCD/RI/DTR/RTS/CTS Function This Write Command enables/disables DCD/RI/DTR/RTS/CTS function. AT+QCFG='uartcfg' Control DCD/RI/DTR/RTS/CTS Function Write Command AT+QCFG='uartcfg'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'uartcfg', OK If the optional parameter is specified, enable/disable DCD/RI/DTR/RTS/CTS function: OK Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Hexadecimal value. Enable/Disable DCD/RI/DTR/RTS/CTS function. 0x00 Enable DCD/RI/DTR/RTS/CTS function 0x01 Disable DCD function 0x02 Disable RI function 0x04 Disable DTR function 0x08 Disable RTS function 0x10 Disable CTS function NOTE For more details about DCD/RI/DTR/RTS/CTS pin, see the corresponding hardware design. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 52 / 60 LPWA Module Series 3.1.2.12. AT+QCFG='dbgctl' Configure Log Output Level This Write Command queries or configures the debug log output level. AT+QCFG='dbgctl' Configure Log Output level Write Command AT+QCFG='dbgctl'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'dbgctl', OK Maximum Response Time Characteristics If the optional parameter is specified, configure log output level: OK Or ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Log output level. 0 Enable the log output 1 Partially prohibit the log output 2 Disable the protocol stack log output 3.1.2.13. AT+QCFG='cmux/flowctrl' Configure Hardware Flow Control for CMUX Mode This Write Command queries or configures hardware flow control for CMUX Mode. AT+QCFG='cmux/flowctrl' Configure Hardware Flow Control for CMUX Mode Write Command AT+QCFG='cmux/flowctrl'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'cmux/flowctrl', OK If the optional parameter is specified, enable/disable the BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 53 / 60 LPWA Module Series Maximum Response Time Characteristics hardware flow control for CMUX mode: OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Enable/disable hardware flow control for CMUX mode. 0 Disable 1 Enable 3.1.2.14. AT+QCFG='fast/poweroff' Control Fast Shutdown Function This Write Command enables/disables fast shutdown function triggered by the specified pin. AT+QCFG='fast/poweroff' Control Fast Shutdown Function Write Command AT+QCFG='fast/poweroff'[,,] Response If the optional parameters are omitted, query the current setting: +QCFG: 'fast/poweroff',, OK Maximum Response Time Characteristics If the optional parameters are specified, enables/disables fast shutdown function triggered by the specified pin: OK Or ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 54 / 60 LPWA Module Series Integer type. The corresponding pin number of the GPIO which has an input and pull-up mode and can be triggered by a falling edge for fast shutdown. The corresponding pin number for BG95 series: 25 The corresponding pin number for BG77 module: 63 The corresponding pin number for BG600L-M3 module: 11 Integer type. Enable/Disable fast shutdown function. 0 Disable 1 Enable NOTE For more details about the pin number, see the corresponding hardware design. BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 55 / 60 LPWA Module Series 4 Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. values are mostly used by common message commands. The following table lists most of general and GPRS related ERROR codes. For some GSM protocol failure causes described in GSM specifications, the corresponding ERROR codes are not included. Table 3: Summary of CME ERROR Codes 0 1 2 3 4 5 6 7 10 11 12 13 14 15 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required (U)SIM failure (U)SIM busy (U)SIM wrong BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 56 / 60 LPWA Module Series 16 Incorrect password 17 (U)SIM PIN2 required 18 (U)SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 57 / 60 LPWA Module Series 5 Appendix References Table 4: Related Documents Document Name [1] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual Table 5: Terms and Abbreviations Abbreviation AP BIP CE CHAP CDS CME CMUX CS CTS DCD DCS DRX DTR EARFCN eDRX Description Application Processor Bearer Independent Protocol Coverage Enhancement Challenge Handshake Authentication Protocol Common Data Service Command Error Connection Multiplexing (Multiplexing Protocol) Circuit Switched Clear To Send Data Carrier Detection Data Coding Scheme Discontinuous Reception Data Terminal Ready E-UTRA Absolute Radio Frequency Channel Number extended Discontinuous Reception BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 58 / 60 EFS EGPRS EGSM EMM eMTC EPS FGI GPIO GPRS GSM IMS LAPI LED LTE MCU ME NAS NB-IoT NITZ PAP PCI PCS PIN PS PSM LPWA Module Series Encrypting File System Enhanced General Packet Radio Service Enhanced Global System for Mobile Communications EPS Mobility Management enhanced Machine-Type Communication Evolved Packet System Feature Group Indicators General-purpose Input/Output General Packet Radio Service Global System for Mobile Communication IP Multimedia Subsystem Low Access Priority Indication Light Emitting Diode Long Term Evolution Microcontroller Unit Mobile Equipment Non-Access Stratum Narrowband Internet of Things Network Identity and Time Zone Password Authentication Protocol Physical Cell Identity Personal Communications Service Personal Identification Number Packet Switched Power Saving Mode BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 59 / 60 PUK RAT RI RRC RTC RTS RX SIB SIM SMS SNR TA TAU UART UE URC (U)SIM VoLTE LPWA Module Series PIN Unlock Key Radio Access Technology Ring Indicator Radio Resource Control Real-Time Clock Request to Send Receive System Information Block Subscriber Identity Module Short Message Service Signal-to-Noise Ratio Terminal Adapter Tracking Area Update Universal Asynchronous Receiver/Transmitter User Equipment Unsolicited Result Code Universal Subscriber Identity Module Voice (voice calls) over LTE BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual 60 / 60

BG95&BG77&BG600L Series QCFGEXT AT Commands Manual LPWA Module Series Version: 1.1 Date: 2021-06-30 Status: Released LPWA Module Series Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 1 / 27 LPWA Module Series Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 2 / 27 LPWA Module Series About the Document Revision History Version Date Author Description 1.0 2020-08-15 Mac ZHU Initial 1. Deleted BG95-N1 from applicable modules (Chapter 1.1) Matt YE/ 2. Updated AT+QCFGEXT='nipds' (Chapter 2.1.1.3) 1.1 2021-06-30 Sherlock ZHAO 3. Added AT+QCFGEXT='pwm' (Chapter 2.1.2.5) 4. Added AT+QCFGEXT='usbnet' (Chapter 2.1.2.6) 5. Deleted AT+QCFGEXT='attm2mfeat' BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 3 / 27 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 1.2. Definitions .................................................................................................................................. 6 1.3. AT Command Syntax ................................................................................................................. 7 1.4. AT Command Responses .......................................................................................................... 8 1.5. Declaration of AT Command Examples ..................................................................................... 8 2 Description of AT+QCFGEXT Commands ....................................................................................... 9 2.1. AT+QCFGEXT Extended Configuration Settings ..................................................................... 9 2.1.1. PS Related AT Commands ........................................................................................... 10 2.1.1.1. AT+QCFGEXT='nipdcfg' Configure NIDD Connection .................................... 10 2.1.1.2. AT+QCFGEXT='nipd' Open or Close NIDD Connection ................................. 10 2.1.1.3. AT+QCFGEXT='nipds' Send MO Non-IP Data.................................................11 2.1.1.4. AT+QCFGEXT='nipdr' Retrieve MT Non-IP Data ............................................ 12 2.1.1.5. AT+QCFGEXT='fota_apn' Configure IP Family and APN for DFOTA ............. 13 2.1.1.6. AT+QCFGEXT='dnsc_timeout' Configure DNS Session Timeout................... 14 2.1.2. Platform Related AT Commands................................................................................... 15 2.1.2.1. AT+QCFGEXT='dump' Enable/Disable Dump Mode ...................................... 15 2.1.2.2. AT+QCFGEXT='quecopen' Enable/Disable QuecOpen Function................... 16 2.1.2.3. AT+QCFGEXT='disusb' Enable/Disable USB Function .................................. 16 2.1.2.4. AT+QCFGEXT='usb/event' Get USB Event .................................................... 17 2.1.2.5. AT+QCFGEXT='pwm' Configure PWM Function ............................................ 18 2.1.2.6. AT+QCFGEXT='usbnet' Configure USB Composition .................................... 19 2.1.3. GNSS Related AT Commands ...................................................................................... 20 2.1.3.1. AT+QCFGEXT='addgeo' Add a Geofence ...................................................... 20 2.1.3.2. AT+QCFGEXT='deletegeo' Delete a Geofence .............................................. 22 2.1.3.3. AT+QCFGEXT='querygeo' Query the Position Relative to Geofence ............ 23 2.2. Description of URCs ................................................................................................................ 23 2.2.1. +QIND: 'GEOFENCE' Indicate Entering or Leaving Geofence .................................. 23 2.2.2. +QIND: 'nipd','recv' Indicate the Incoming Non-IP Data............................................ 24 2.2.3. +QIND: 'nipd','close' Indicate the NIDD Connection is Closed ................................. 24 3 Summary of ..................................................................................................................... 25 4 Appendix A References.................................................................................................................... 26 BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 4 / 27 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Types of AT Commands ................................................................................................................. 7 Table 3: Summary of ................................................................................................................. 25 Table 4: Related Document........................................................................................................................ 26 Table 5: Terms and Abbreviations .............................................................................................................. 26 BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 5 / 27 LPWA Module Series 1 Introduction This document describes the AT+QCFGEXT command supported on BG95 series, BG77 and BG600L-M3 modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series BG95 BG77 BG600L Model BG95-M1 BG95-M2 BG95-M3 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS 1.2. Definitions ⚫ ⚫ ⚫ ⚫ [...] Carriage return character. Line feed character. Parameter name. Angle brackets do not appear on the command line. Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified. BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 6 / 27 ⚫ Underline Default setting of a parameter. LPWA Module Series 1.3. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. AT+QCFGEXT implemented by BG95 series, BG77 and BG600L-M3 modules is in 'Extended' syntax, as illustrated below. ⚫ Extended Syntax These commands can be operated in several modes, as shown in the following table: Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. Multiple commands can be placed on a single line using a semi-colon (;) between commands. In such cases, only the first command should have AT prefix. Commands can be in upper or lower case. Spaces should be ignored when you enter AT commands, except in the following cases: ⚫ Within quoted strings, where spaces are preserved; ⚫ Within an unquoted string or numeric parameter; ⚫ Within an IP address; ⚫ Within the AT command name up to and including a =, ? or =?. On input, at least a carriage return is required. A newline character is ignored so it is permissible to use BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 7 / 27 LPWA Module Series 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, ERROR will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. 1.4. 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 information responses are sent before the final OK, ERROR or +CME ERROR: . Responses will be in the format of: +CMD1: OK Or OK 1.5. Declaration of AT Command Examples The AT command examples in this document are provided to help you familiarize with AT commands and learn how to use them. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 8 / 27 LPWA Module Series 2 Description of AT+QCFGEXT Commands 2.1. AT+QCFGEXT Extended Configuration Settings The AT+QCFGEXT Write Commands query and configure various extended settings of the module. The following Test Command shows the various extended settings of the module. AT+QCFGEXT Extended Configuration Settings Test Command AT+QCFGEXT=? Response +QCFGEXT: 'addgeo',,,,,,[,[,,[,,]]] +QCFGEXT: 'deletegeo', +QCFGEXT: 'querygeo', +QCFGEXT: 'nipdcfg'[,[,[,,]]] +QCFGEXT: 'nipd'[,[,]] +QCFGEXT: 'nipds'[,,[,[,]]] +QCFGEXT: 'nipdr'[,[,]] +QCFGEXT: 'dump'[,(list of supported s)] +QCFGEXT: 'quecopen'[,(list of supported s)] +QCFGEXT: 'disusb',(list of supported s) +QCFGEXT: 'usb/event' +QCFGEXT: 'fota_apn',,[,,] +QCFGEXT: 'dnsc_timeout'[,(range of supported s)] +QCFGEXT: 'pwm',[,(list of supported s)[,(range of supported s),(range of supported s)]] +QCFGEXT: 'usbnet'[,(list of supported s)] OK BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 9 / 27 LPWA Module Series 2.1.1. PS Related AT Commands 2.1.1.1. AT+QCFGEXT='nipdcfg' Configure NIDD Connection This command configures an NIDD connection or queries the current setting. AT+QCFGEXT='nipdcfg' Configure NIDD Connection Write Command AT+QCFGEXT='nipdcfg'[,[,[,,]]] Response If the optional parameters are omitted, query the current setting: +QCFGEXT: 'nipdcfg',, OK If any of the optional parameters is specified, configure the NIDD connection: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Non-IP outgoing data type. 0 MO Non-IP data type. 1 MO Exception Non-IP data type. String type. Access point name. String type. Username of the selected APN. String type. Password of the selected APN. 2.1.1.2. AT+QCFGEXT='nipd' Open or Close NIDD Connection This command opens or closes an NIDD connection. AT+QCFGEXT='nipd' Open or Close NIDD Connection Write Command Response AT+QCFGEXT='nipd',[,<time If =0, close an NIDD connection: BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 10 / 27 LPWA Module Series out>] Maximum Response Time Characteristics OK If =1, open an NIDD connection: OK +QIND: 'nipd','open', If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Close or open an NIDD connection. 0 Close an NIDD connection. 1 Open an NIDD connection. Integer type. The timeout value when opening an NIDD connection. This parameter is valid only when =1. Range: 30–90. Default value: 30. Unit: s. Integer type. Error code. See Chapter 3 for details. NOTE NIDD function is disabled by default. AT+QCFG='nccconf',115 (see document [1] for details) can be used to enable the function. 2.1.1.3. AT+QCFGEXT='nipds' Send MO Non-IP Data This command sends MO Non-IP data to a server. AT+QCFGEXT='nipds' Send MO Non-IP Data Write Command AT+QCFGEXT='nipds',,[,[,]] Response OK If there is an error related to ME functionality: +CME ERROR: BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 11 / 27 LPWA Module Series Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Input format for . 0 ASCII format string. 1 Hex format string. ASCII format string or hex format string. The data to be sent. Integer type. The length of the data to be sent. Range: 1–1358 for ASCII format; 1–679 for hex format. Unit: byte. If this parameter is omitted, can be of any length within 1358 bytes of ASCII format, or within 679 bytes of hex format. Integer type. Whether to enable RAI flag when sending data to network side. 0 Disable. 1 Enable. Integer type. Error code. See Chapter 3 for details. 2.1.1.4. AT+QCFGEXT='nipdr' Retrieve MT Non-IP Data This command retrieves the data reported by the URC +QIND: 'nipd','recv'. AT+QCFGEXT='nipdr' Retrieve MT Non-IP Data Write Command AT+QCFGEXT='nipdr'[,[ ,]] Response +QCFGEXT: 'nipdr',, OK If there is no data that can be retrieved: +QCFGEXT: 'nipdr',0 OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 12 / 27 LPWA Module Series Write Command When is 0, query the read status of the retrieved data: AT+QCFGEXT='nipdr',0 Response If the connection has existed: +QCFGEXT: 'nipdr',,, OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Integer type. The length of the data to be retrieved. Retrieve all available data if this parameter is omitted. Unit: byte. Integer type. Displayed format for . This parameter is valid only when is not 0. 0 String type. 1 Hex type. Integer type. The actual length of retrieved data. Unit: byte. String type or hex type. Retrieved data. Integer type. The total length of received data. Unit: byte. Integer type. The length of retrieved data. Unit: byte. Integer type. The length of unread data. Unit: byte. Integer type. Error code. See Chapter 3 for details. 2.1.1.5. AT+QCFGEXT='fota_apn' Configure IP Family and APN for DFOTA This command configures the IP family and APN for DFOTA or queries the current setting. AT+QCFGEXT='fota_apn' Configure IP Family and APN for DFOTA Write Command AT+QCFGEXT='fota_apn'[, ,[,,]] Response If the optional parameters are omitted, query the current setting: +QCFGEXT: 'fota_apn',,[,,] BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 13 / 27 LPWA Module Series Maximum Response Time Characteristics OK If any of the optional parameters is specified, set the IP family and APN for DFOTA: OK If there is any error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. IP family. 0 IPv4 address family 1 IPv6 address family 2 IPv4 and IPv6 address family String type. Access point name. String type. Username of the selected APN. String type. Password of the selected APN. 2.1.1.6. AT+QCFGEXT='dnsc_timeout' Configure DNS Session Timeout This command configures the timeout value for DNS session or queries the current setting. AT+QCFGEXT='dnsc_timeout' Configure DNS Session Timeout Write Command AT+QCFGEXT='dnsc_timeout'[,] Response If the optional parameter is omitted, query the current setting: +QCFGEXT: 'dnsc_timeout', OK If the optional parameter is specified, set the DNS session timeout value: OK Maximum Response Time If there is any error: ERROR 300 ms BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 14 / 27 LPWA Module Series Characteristics The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Timeout value for DNS session. Range: 2–300. Default value: 60. Unit: second. 2.1.2. Platform Related AT Commands 2.1.2.1. AT+QCFGEXT='dump' Enable/Disable Dump Mode This command configures whether to enable dump mode or queries the current setting. AT+QCFGEXT='dump' Enable/Disable Dump Mode Write Command AT+QCFGEXT='dump'[,] Response If the optional parameter is omitted, query the current setting: +QCFGEXT: 'dump', OK If the optional parameter is specified, set whether to enable dump mode: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Enable/disable dump mode. 0 Disable 1 Enable BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 15 / 27 LPWA Module Series 2.1.2.2. AT+QCFGEXT='quecopen' Enable/Disable QuecOpen Function This command configures whether to enable your application to load the QuecOpen function or queries the current setting. AT+QCFGEXT='quecopen' Enable/Disable QuecOpen Function Write Command AT+QCFGEXT='quecopen'[,] Response If the optional parameter is omitted, query the current setting: +QCFGEXT: 'quecopen', OK If the optional parameter is specified, set whether to enable QuecOpen function: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Enable/disable QuecOpen function. 0 Enable 1 Disable 2.1.2.3. AT+QCFGEXT='disusb' Enable/Disable USB Function This command configures whether to enable USB function or queries the current setting. AT+QCFGEXT='disusb' Enable/Disable USB Function Write Command AT+QCFGEXT='disusb'[,] Response If the optional parameter is omitted, query the current setting: +QCFGEXT: 'disusb', OK BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 16 / 27 LPWA Module Series Maximum Response Time Characteristics If the optional parameter is specified, set whether to enable USB function: OK If there is any error: ERROR 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Enable/Disable USB function. 0 Disable 1 Enable 2.1.2.4. AT+QCFGEXT='usb/event' Get USB Event This command gets a USB event. AT+QCFGEXT='usb/event' Get USB Event Write Command AT+QCFGEXT='usb/event' Response +QCFGEXT: 'usb/event', OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms / Parameter Integer type. USB event. 0 USB CONNECT 1 USB DISCONNECT 2 USB SUSPEND 3 USB RESUME 4 USB RESUME COMPLETED 5 USB REMOTE WAKEUP BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 17 / 27 6 USB CONFIGURED 7 USB UNCONFIGURED 8 USB RESET 9 USB SPEED CHANGE LPWA Module Series 2.1.2.5. AT+QCFGEXT='pwm' Configure PWM Function This command configures PWM function or queries the current setting. AT+QCFGEXT='pwm' Configure PWM Function Write Command AT+QCFGEXT='pwm',[, [,,]] Response If the optional parameters are omitted, query the current setting: +QCFGEXT: 'pwm',,,, OK If any of the optional parameters is specified, configure the PWM function multiplexed from the corresponding GPIO: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Select the PWM function multiplexed from the corresponding GPIO. 0 BG95 Series: Pin 66, BG77: Pin 33 Integer type. Enable/Disable PWM function. 0 Disable 1 Enable Integer type. Set the percentage of PWM duty cycle. Range: 1–99. It is valid only when =1. Integer type. Set the frequency of PWM. Range: 293–600000. Unit: Hz. It is valid only when =1. BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 18 / 27 LPWA Module Series NOTE This command is valid only on BG95 series and BG77 modules, and is not available on BG600L-M3 module. For the corresponding GPIO pins, see documents [2] and [3] Example AT+QCFGEXT='pwm',0,1,10,1000 OK AT+QCFGEXT='pwm',0 +QCFGEXT: 'pwm',0,1,10,1000 OK AT+QCFGEXT='pwm',0,1,10,2000 OK AT+QCFGEXT='pwm',0,1,30,2000 OK AT+QCFGEXT='pwm',0,0 OK //Set duty cycle = 10 % and frequency = 1000 Hz. //PWM turned on successfully. //Query the current setting. //Modify the frequency to 2000 Hz. The duty cycle remains unchanged //Modify the duty cycle to 30 %. The frequency remains unchanged. //Turn off PWM. 2.1.2.6. AT+QCFGEXT='usbnet' Configure USB Composition This command switches different combinations of USB enumerations through configuring USB composition ID. AT+QCFGEXT='usbnet' Configure USB composition Write Command AT+QCFGEXT='usbnet'[,] Response If the optional parameter is omitted, query the current setting: +QCFGEXT: 'usbnet', OK If the optional parameter is specified, a corresponding feature will be enabled: OK If there is any error: ERROR BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 19 / 27 LPWA Module Series Maximum Response Time Characteristics 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter String type. 'rmnet' RmNet interface mode. This interface can accept QMI message. Corresponds to RmNet USB combination: USB DM + NMEA + Modem + RmNet. 'ecm' ECM interface mode. The host can connect to the module via USB and use the module as a CDC-Ethernet. Corresponds to ECM USB combination: USB DM + NMEA + Modem + ECM. 'modem' Modem interface mode. A second modem port will be additionally enabled for use. Corresponds to Modem USB combination: USB DM + NMEA + Modem + Modem. 2.1.3. GNSS Related AT Commands 2.1.3.1. AT+QCFGEXT='addgeo' Add a Geofence This command adds a geofence or queries the current setting. AT+QCFGEXT='addgeo' Add a Geofence Write Command AT+QCFGEXT='addgeo'[,[,< mode>,,,, [,[,,[,,]]]]] Response If the optional parameters are omitted, query the current setting of all geofences that have been added: [+QCFGEXT: 'addgeo',,,,, ,[,[,,[,,]]] … +QCFGEXT: 'addgeo',,,,,< lon1>,[,[,,[,,]]]] OK If all parameters after are omitted, query the current setting of the specified geofence: +QCFGEXT: 'addgeo',,,,,< lon1>,[,[,,[,,]]] OK BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 20 / 27 LPWA Module Series Maximum Response Time Characteristics If =0, add a circular geofence and the parameters after must be omitted: OK If =1, add a circular geofence and the parameters after must be omitted: OK If =2, add a triangle geofence and the parameters after must be omitted: OK If =3, add a quadrangle geofence and all parameters must be specified: OK If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. Geofence ID. Range: 0–9. Integer type. URC report mode. 0 Disable URC to be reported when the module enters or leaves the geofence. 1 Enable URC to be reported when the module enters the geofence. 2 Enable URC to be reported when the module leaves the geofence. 3 Enable URC to be reported when the module enters or leaves the geofence. For details about the URC, please refer to Chapter 2.2.1. Integer type. Geofence shape. 0 Circle with center and radius. 1 Circle with center and one point on the circle. 2 Triangle. 3 Quadrangle. The latitude of a point which is defined as the center of the geofence circular region or the first point. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. The longitude of a point which is defined as the center of the geofence circular region or the first point. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. When is 0, this parameter is a radius. Range: 0–6000000. Unit: meter. When is other values, this parameter is the latitude of the point on the circle or BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 21 / 27 LPWA Module Series the second point. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. If is 0, the parameters after must be omitted. The longitude of the point on the circle or the second point. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. If is 1, the parameters after must be omitted. The latitude of the third point. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. The longitude of the third point. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. If is 2, the parameters after must be omitted. The latitude of the fourth point. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. The longitude of the fourth point. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. Integer type. Error code. See Chapter 3 for details. 2.1.3.2. AT+QCFGEXT='deletegeo' Delete a Geofence This command deletes a geofence. AT+QCFGEXT='deletegeo' Delete a Geofence Write Command AT+QCFGEXT='deletegeo', Response OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Geofence ID. Range: 0–10. 10 means deleting all geofences. Integer type. Error code. See Chapter 3 for details. BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 22 / 27 LPWA Module Series 2.1.3.3. AT+QCFGEXT='querygeo' Query the Position Relative to Geofence This command queries the position relative to a geofence. AT+QCFGEXT='querygeo' Query the Position Relative to Geofence Write Command AT+QCFGEXT='querygeo', Response +QCFGEXT: 'querygeo',, OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. Geofence ID. Range: 0–9. Integer type. Position relative to a geofence. 0 An unknown position. 1 A position inside a geofence. 2 A position outside a geofence. Integer type. Error code. See Chapter 3 for details. 2.2. Description of URCs 2.2.1. +QIND: 'GEOFENCE' Indicate Entering or Leaving Geofence +QIND: 'GEOFENCE' Indicate Entering or Leaving Geofence +QIND: 'GEOFENCE',,,,,,,,,,< HDOP>, The URC indicates entering or leaving a geofence. Parameter Integer type. The ID of geofence the module enters or leaves. Integer type. The current action of the module. BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 23 / 27 LPWA Module Series 1 Entering the geofence. 2 Leaving the geofence. The UTC time when the module enters or leaves the geofence. Format: YYYY/MM/DD hh:mm:ss. The latitude of the module when it enters or leaves the geofence. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. The longitude of the module when it enters or leaves the geofence. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. Float type. Mean sea level altitude. Unit: meter. Float type. Course over ground, relative to true north. Unit: degree. Float type. Speed over ground. Unit: m/s. Float type. Position dilution of precision. Float type. Horizontal dilution of precision. Float type. Vertical dilution of precision. 2.2.2. +QIND: 'nipd','recv' Indicate the Incoming Non-IP Data After receiving the Non-IP data from the MT, the module reports the URC +QIND: 'nipd','recv' to notify the host that there is incoming data. Then host can retrieve data via AT+QCFGEXT='nipdr'. Please note that if the module receives data again when the buffer is not empty, it does not report a new URC until all the received data has been retrieved via AT+QCFGEXT='nipdr' from the buffer. The size of the buffer is 2048 bytes. If the data received exceeds the buffer size, the subsequent data will be discarded. +QIND: 'nipd','recv' Indicate the Incoming Non-IP Data +QIND: 'nipd','recv' The URC notifies the host that there is incoming non-IP data from the network. Then the host can retrieve the data via AT+QCFGEXT='nipdr'. 2.2.3. +QIND: 'nipd','close' Indicate the NIDD Connection is Closed +QIND: 'nipd','close' Indicate the NIDD Connection is Closed +QIND: 'nipd','close' The URC notifies that the NIDD connection is closed accidentally. If the connection is closed normally via AT+QCFGEXT='nipd',0, this URC will not be reported. BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 24 / 27 LPWA Module Series 3 Summary of The error code indicates an error related to mobile equipment or network. The table below describes the details about . Table 3: Summary of 501 517 651 652 654 656 657 Meaning Invalid parameter Geofence ID does not exist Invalid parameter for NIPD NIPD sending error NIDD operation in process NIDD connection not opened NIDD connection opened already BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 25 / 27 LPWA Module Series 4 Appendix A References Table 4: Related Document Document Name [1] Quectel_BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual [2] Quectel_BG95_Series_Hardware_Design [3] Quectel_BG77_Hardware_Design Table 5: Terms and Abbreviations Abbreviation APN ASCII CDC CME DFOTA DNS ECM EGPRS GNSS GPIO ID IP Description Access Point Name American Standard Code for Information Interchange Communication Device Class Command Error Delta Firmware Update Over-The-Air Domain Name Service Ethernet Control Model Enhanced General Packet Radio Service Global Navigation Satellite System General-Purpose Input/Output Identifier Internet Protocol BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 26 / 27 IPv4 IPv6 ME MO MT NIDD NIPD PPP PS PWM RAI TA URC USB UTC Internet Protocol version 4 Internet Protocol version 6 Mobile Equipment Mobile Originated Mobile Terminated Non-IP Data Delivery Non-IP Data Point-to-Point Protocol Packet Switched Pulse Width Modulation Release Assistance Indication Terminal Adapter Unsolicited Result Code Universal Serial Bus Coordinated Universal Time LPWA Module Series BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual 27 / 27

BC32 AT 命令手册 NB-IoT 模块系列 版本：BC32_AT_命令手册_V1.0 日期：2019-11-26 状态：受控文件 www.quectel.com BC32 AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 101 BC32 AT 命令手册 文档历史 修订记录 版本 日期 作者 1.0 2019-11-26 秦世鹏 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 101 BC32 AT 命令手册 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 定义 ............................................................................................................................................ 6 1.2. AT 命令语法................................................................................................................................ 6 1.3. 遵从 3GPP.................................................................................................................................. 7 2 通用命令（27.007） ............................................................................................................................. 8 2.1. ATI 显示产品标识信息 ............................................................................................................. 8 2.2. ATE 设置命令回显模式 ............................................................................................................ 9 2.3. AT&W 储存当前参数到用户定义的配置文件 ......................................................................... 10 2.4. AT+CGMI 查询制造商标识 .................................................................................................... 10 2.5. AT+CGMM 查询模块标识 .......................................................................................................11 2.6. AT+CGMR 查询制造商版本号 ............................................................................................... 12 2.7. AT+CGSN 查询产品序列号 ................................................................................................... 13 2.8. AT+CMEE 上报 MT 错误 ....................................................................................................... 14 3 串行接口控制命令 ............................................................................................................................... 16 3.1. AT+IPR 设置 TE-TA 固定的本地波特率................................................................................. 16 4 (U)SIM 卡相关命令.............................................................................................................................. 18 4.1. AT+CPIN 输入 PIN 码............................................................................................................ 18 4.2. AT+CIMI 查询国际移动用户识别码........................................................................................ 19 4.3. AT+QCCID USIM 卡识别....................................................................................................... 20 5 网络服务命令....................................................................................................................................... 22 5.1. AT+CSQ 上报信号强度.......................................................................................................... 22 5.2. AT+CESQ 扩展信号强度 ....................................................................................................... 23 5.3. AT+CREG GSM 网络注册信息.............................................................................................. 25 5.4. AT+CGREG GPRS 网络注册状态 ........................................................................................... 27 5.5. AT+CEREG EPS 网络注册信息 ............................................................................................ 29 5.6. AT+CGATT PS 附着与去附着................................................................................................ 32 5.7. AT+QCGDEFCONT 设置默认 PSD 连接 .............................................................................. 33 5.8. AT+CGDCONT 定义 PDP 上下文 ......................................................................................... 35 5.9. AT+CGACT 激活或去激活 PDP 上下文................................................................................. 37 5.10. AT+CGPADDR 显示 PDP 地址.............................................................................................. 39 5.11. AT+QICSGP 配置 TCP/IP 上下文参数 .................................................................................. 41 5.12. AT+CSCON 信令连接状态 .................................................................................................... 43 5.13. AT+COPS 运营商选择........................................................................................................... 44 5.14. AT+CPSMS 省电模式设置 .................................................................................................... 47 5.15. AT+CEDRXS eDRX 设置 ...................................................................................................... 49 5.16. AT+CEDRXRDP 读取动态 eDRX 参数.................................................................................. 52 上海移远通信技术股份有限公司 3 / 101 BC32 AT 命令手册 5.17. AT+QBAND 获取和设置工作频段.......................................................................................... 54 5.18. AT+QLOCKF 锁定 NB-IoT 频点 ............................................................................................ 55 5.19. AT+QENG 工程模式 .............................................................................................................. 57 5.20. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 .......................................................... 60 5.21. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表......................................................... 61 5.22. AT+QCFG 扩展配置设置 ....................................................................................................... 62 5.23. AT+CCIOTOPT CloT 优化配置 ............................................................................................. 63 5.24. AT+CTZR 上报时区 ............................................................................................................... 65 5.25. AT+CGAPNRC APN 速率控制 .............................................................................................. 67 5.26. AT+QSPCHSC 设置扰码算法 ............................................................................................... 68 5.27. AT+QNWCFG 配置网络工作模式.......................................................................................... 69 6 硬件相关指令....................................................................................................................................... 72 6.1. AT+CFUN 设置 UE 功能........................................................................................................ 72 6.2. AT+QSCLK 配置睡眠模式 ..................................................................................................... 73 6.3. AT+QRST 自动重启............................................................................................................... 75 6.4. AT+QPOWD 模块关机指令 ................................................................................................... 75 6.5. AT+CCLK 查询当前日期和时间............................................................................................. 77 6.6. AT+CBC 查询电源电压值 ...................................................................................................... 78 6.7. AT+QATWAKEUP 启用/禁用深度睡眠唤醒指示.................................................................... 79 6.8. AT+QLEDMODE 配置网络灯 ................................................................................................ 80 6.9. AT+QADC 读取 ADC............................................................................................................... 81 7 TCPIP 相关指令 .................................................................................................................................. 83 8 OneNET 相关指令............................................................................................................................... 84 9 CMDMP 相关指令 ............................................................................................................................... 85 10 DFOTA 相关指令 ................................................................................................................................ 86 11 MQTT 相关指令................................................................................................................................... 87 12 *FS 相关指令....................................................................................................................................... 88 13 举例 ..................................................................................................................................................... 89 13.1. 网络附着 ................................................................................................................................... 89 13.1.1. 手动查询网络附着状态 .................................................................................................. 89 13.1.2. 通过 URC 上报自动附着网络状态 ................................................................................. 90 13.1.3. 通过指定的 PLMN 附着网络.......................................................................................... 91 13.1.4. 通过指定的 EARFCN/PCI 附着网络.............................................................................. 92 13.1.5. 通过指定的频段附着网络 .............................................................................................. 94 13.1.6. 优先注册到 GSM 网络 ................................................................................................... 94 13.1.7. 优先注册到 NB-IoT 网络................................................................................................ 96 14 错误代码 .............................................................................................................................................. 97 15 附录 ................................................................................................................................................... 100 上海移远通信技术股份有限公司 4 / 101 BC32 AT 命令手册 表格索引 表 1：AT 命令及响应类型 .................................................................................................................................... 6 表 2: TCPIP 相关命令 ........................................................................................................................................ 83 表 3: ONENET 相关命令 .................................................................................................................................... 84 表 4: CMDMP 相关命令 ..................................................................................................................................... 85 表 5: DFOTA 相关命令 ....................................................................................................................................... 86 表 6: MQTT 相关命令......................................................................................................................................... 87 表 7: FS 相关命令 .............................................................................................................................................. 88 表 8：错误代码列表 ........................................................................................................................................... 97 表 9：指定错误代码列表.................................................................................................................................... 98 表 10：参考文档 .............................................................................................................................................. 100 表 11：术语和缩写 ........................................................................................................................................... 100 上海移远通信技术股份有限公司 5 / 101 BC32 AT 命令手册 1 引言 本文档详细介绍了移远通信 BC32 模块支持的 AT 命令集。 模块默认支持的波特率为 9600bps。当模块上电后，可以通过 MCU 发送命令 AT+IPR=配置通 信波特率，该设置将被自动保存至 NVM 中。 1.1. 定义 ⚫ ：回车符； ⚫ ：换行符； ⚫ ：参数名称。实际命令行中不应出现尖括号< >； ⚫ [..]：可选参数。实际命令行中不应出现方括号[ ]。 1.2. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应，省略。 BC32 实现的 AT 命令可以在语法上分为两类：基础类和扩展类，如下所列： ⚫ 基础语法 这些 AT 命令的格式为 AT或 AT&，其中是命令，是该命令的参数。以 ATE 为例， DCE 会根据的取值确定是否将接收到的字符回显给 DTE。如果是可选的，被省略时则将使 用默认值。 ⚫ 扩展类语法 这些命令可以在多种模式下运行，如下表所示。 表 1：AT 命令及响应类型 测试命令 AT+=? 返回相应设置命令可设置的参数清单或取值 范围。 上海移远通信技术股份有限公司 6 / 101 BC32 AT 命令手册 查询命令 设置命令 执行命令 AT+? AT+= AT+ 返回相应设置命令参数的当前设置值。 设置用户可自定义的参数值。 执行无需设置参数值的命令。 备注 1. 模块每次只支持单个 AT 命令。只有当前 AT 命令的执行完成时，才会执行下一个 AT 命令。 2. 本文档参数说明中添加下划线的参数值为默认值。 1.3. 3GPP 命令 3GPP 命令遵从 3GPP TS 27.007、3GPP TS 27.005 和 ITU V.250。 上海移远通信技术股份有限公司 7 / 101 2 通用命令 2.1. ATI 显示产品标识信息 该命令用于返回产品标志信息。 ATI 显示产品标识信息 执行命令 ATI 最大响应时间 响应 Quectel_Ltd Revision: OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 设备类型标识。 当前软件版本号。 举例 ATI Quectel_Ltd Quectel_BC32 Revision: BC32RAR01A01 OK 上海移远通信技术股份有限公司 BC32 AT 命令手册 8 / 101 BC32 AT 命令手册 2.2. ATE 设置命令回显模式 该命令用于设置是否从外接 MCU 接收 UE 回显字符。 ATE 设置命令回显模式 执行命令 ATE 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存（需先执行 AT&W 保存配置） 参数 0 关闭回显模式 1 开启回显模式 举例 ATE0 OK ATI Quectel_Ltd Quectel_BC32 Revision: BC32RAR01A01 OK ATE1 OK ATI ATI Quectel _Ltd Quectel_BC32 Revision: BC32RAR01A01 OK 上海移远通信技术股份有限公司 9 / 101 2.3. AT&W 储存当前参数到用户定义的配置文件 该命令将当前参数设置存储到 NVM 中的用户定义的配置文件中。 AT&W 储存当前参数到用户定义的配置文件 执行命令 响应 AT&W[] OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 0 用于储存当前参数的配置文件编号 2.4. AT+CGMI 请求制造商标识 该命令可返回制造商信息。 AT+CGMI 请求制造商标识 测试命令 AT+CGMI=? 执行命令 AT+CGMI 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 Quectel_Ltd Revision: RDA_8909B OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 BC32 AT 命令手册 10 / 101 最大响应时间 参数 设备类型标识。 举例 AT+CGMI Quectel_Ltd Quectel_BC32 Revision: RDA_8909B OK 或者 +CME ERROR: 300 毫秒 2.5. AT+CGMM 请求模块标识 该命令可返回模块信息。 AT+CGMM 请求模块标识 测试命令 AT+CGMI=? 执行命令 AT+CGMI 最大响应时间 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 BC32 AT 命令手册 11 / 101 参数 设备类型标识。 举例 AT+CGMM Quectel_BC32 OK BC32 AT 命令手册 2.6. AT+CGMR 请求制造商版本号 该命令返回制造商版本号。该文本是可读的，不适用于微控制器解析。默认返回固件版本号。 执行命令返回一行或多行信息文本 。 AT+CGMR 请求制造商版本号 测试命令 AT+CGMR=? 响应 OK 执行命令 AT+CGMR 若出现任何错误： ERROR 或者 +CME ERROR: 响应 Revision: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 当前软件版本号。 上海移远通信技术股份有限公司 12 / 101 举例 AT+CGMR Revision: BC32RAR01A01 OK BC32 AT 命令手册 2.7. AT+CGSN 请求产品序列号 该命令返回 IMEI 号及相关信息。对于不支持 的 TA，仅返回 OK。相关 错误码，请参 考第 14 章。 AT+CGSN 请求产品序列号 测试命令 AT+CGSN=? 响应 UE 支持且命令执行成功时： +CGSN: (支持的列表) OK 设置命令 AT+CGSN= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当=0 时： OK 当=1 时 +CGSN: OK 执行命令 AT+CGSN 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 13 / 101 BC32 AT 命令手册 最大响应时间 若出现任何错误，响应： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。被请求的序列号类型。 0 表示返回 128 位 UUID 1 表示返回 IMEI 号 UE 的 128 位 UUID。信息文本（包括行终止符在内）的字符总数不应超过 37 个字符， 且不包含 0 或 OK序列。 不带双引号的十进制格式的字符串型。IMEI 号。 举例 AT+CGSN=1 +CGSN: 490154203237511 OK //请求 IMEI 号 2.8. AT+CMEE 设置错误码上报 设置命令可以关闭或启用最终结果码 +CME ERROR: ，用于表示 MT 功能相关的错误。启用 后，发生错误时，模块会上报 +CME ERROR: ，而不仅仅是响应 ERROR。当发生语法、无效参数 或 TA 功能相关错误时，仅仅会响应 ERROR。 查询命令返回参数的当前设置值。 相关 错误码，请参考第 14 章。 AT+CMEE 设置错误码上报 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) OK 若出现任何错误： 上海移远通信技术股份有限公司 14 / 101 查询命令 AT+CMEE? 设置命令 AT+CMEE= 最大响应时间 特性说明 BC32 AT 命令手册 ERROR 或者 +CME ERROR: 响应 +CMEE: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 TA 禁用或使能最终结果码+CME ERROR: ，用于表示相 关的错误。 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存（需先执行 AT&W 保存配置） 参数 整型。表示错误模式。 0 禁用结果码 1 启用结果码，结果码为数值格式 2 启用结果码，结果码为详细错误信息 举例 AT+CMEE? +CMEE: 0 OK AT+CMEE=? +CMEE: (0-2) OK 上海移远通信技术股份有限公司 15 / 101 BC32 AT 命令手册 3 串行接口控制命令 3.1. AT+IPR 设置 TE-TA 固定的本地波特率 相关 错误码，请参考第 14 章。 AT+IPR 设置 TE-TA 固定的本地波特率 测试命令 AT+IPR=? 响应 +IPR: (支持的< rate>列表) OK 查询命令 AT+IPR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +IPR: OK 设置命令 AT+IPR= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存 上海移远通信技术股份有限公司 16 / 101 参数 每秒的波特率 2400 4800 9600 14400 19200 28800 33600 38400 57600 备注 该设置将应用于同一个 UART 连接级别路由的所有信道。 举例 AT+IPR=9600 OK AT+IPR? +IPR: 9600 //设置固定的波特率为 9600bps OK AT+IPR=? +IPR: (2400,4800,9600,14400,19200,28800,33600,38400,57600) OK BC32 AT 命令手册 上海移远通信技术股份有限公司 17 / 101 BC32 AT 命令手册 4 (U)SIM 卡相关命令 4.1. AT+CPIN 输入 PIN 码 相关错误码，请参考第 14 章。 AT+CPIN 输入 PIN 码 测试命令 AT+CPIN=? 响应 OK 查询命令 AT+CPIN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 TA 返回一个字母数字字符串，表示是否需要密码。 +CPIN: OK 设置命令 AT+CPIN=[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 如果出现任何错误, 响应: ERROR 或者 +CME ERROR: 5秒 参数配置立即生效 上海移远通信技术股份有限公司 18 / 101 参数 BC32 AT 命令手册 READY 无需进一步输入 SIM PIN MT 正在等待 USIM PIN 码 SIM PUK MT 正在等待 SIM PUK 码 PH_SP PIN 需要服务提供商个性化密码 SIM PIN2 MT 正 在 等 待 USIM PIN 2 码 。 仅 在 前 条 命 令 返 回 +CME ERROR: 17 时有效 SIM PUK2 MT 正 在 等 待 USIM PUK 2 码 。 仅 在 前 条 命 令 返 回 +CME ERROR: 18 时有效 NO SIM SIM 卡未插入 字符串型。PIN 码。 字符串型，表示请求的代码是 PUK 时所需的新密码。 举例 AT+CPIN? +CPIN: READY OK 4.2. AT+CIMI 查询国际移动用户识别码 此命令返回国际移动用户识别码（无双引号的字符串）。 该执行命令使 TA 返回 ，目的是允许 TE 识别附着到 MT 的 UICC（USIM）中的单独 USIM 卡 或活动应用。 相关 错误码，请参考第 14 章。 AT+CIMI 查询国际移动用户识别码 测试命令 AT+CIMI=? 响应 OK 执行命令 AT+CIMI 若出现任何错误： ERROR 或者 +CME ERROR: 响应 上海移远通信技术股份有限公司 19 / 101 最大响应时间 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 国际移动用户识别码（无双引号的字符串）。 举例 AT+CIMI 460001357924680 OK BC32 AT 命令手册 4.3. AT+QCCID USIM 卡识别 该命令用于读取 USIM 卡的 ICCID。如果没有 USIM 卡，或者 USIM 卡不可读，则不返回任何数据。 相关 错误码，请参考第 14 章。 AT+QICCID USIM 卡识别 执行命令 AT+QCCID 响应 +QCCID: OK 最大响应时间 若出现任何错误，响应： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 20 / 101 参数 USIM 卡识别号。 举例 AT+QCCID +QCCID: 89860317482035195410 OK BC32 AT 命令手册 上海移远通信技术股份有限公司 21 / 101 BC32 AT 命令手册 5 网络服务命令 5.1. AT+CSQ 上报信号质量 执行命令用于从 MT 返回接收信号强度指示和信道误码率。 测试命令返回参数支持的值的范围。 相关错误码，请参考第 14 章。 AT+CSQ 上报信号质量 测试命令 AT+CSQ=? 响应 +CSQ: (支持的列表),(支持的列表) OK 执行命令 AT+CSQ 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSQ: , OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。接收到信号强度等级。 0 等于或小于-113dBm 上海移远通信技术股份有限公司 22 / 101 BC32 AT 命令手册 1 -111dBm 2…30 -109dBm... -53dBm 31 大于或等于-51dBm 99 未知或无法检测 整型。信道误码率（百分比）。 0...7 用作 RXQUAL 值（RXQUAL_0…RXQUAL_7 定义请参考 3GPP TS 45.008） 99 未知或无法检测 举例 AT+CSQ +CSQ: 22,99 OK 5.2. AT+CESQ 扩展信号质量 执行命令返回接收信号质量参数。 终端将提供 0 到 99 的信号强度指示，通常数值越大强度越高。该数值基于单次测量，因此在短期内可 以发生较大变化。 相关 错误码，请参考第 14 章。 AT+CESQ 扩展信号质量 测试命令 AT+CESQ=? 响应 +CESQ: (支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的 列表) OK 执行命令 AT+CESQ 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CESQ: ,,,,, OK 上海移远通信技术股份有限公司 23 / 101 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 BC32 AT 命令手册 参数 整型。接收到信号强度等级。 0 < -110dBm 1 -110dBm ≤ < -109dBm 2 -109dBm ≤ < -108dBm … 61 -50dBm ≤ < -49dBm 62 -49dBm ≤ < -48dBm 63 -48dBm ≤ 99 未知或者不可检测 整型。信道位误码率（百分比）。 0…7 用作 RxQual 值（RXQUAL_0…RXQUAL_7 定义请参考 3GPP TS 45.008） 99 未知或者不可检测 整型。接收信号码功率（请参考 3GPP 25.133 和 3GPP 25.123）。 0 -120dBm 或者更低 1 -120dBm ≤ < -119dBm 2 -119dBm ≤ < -118dBm … 94 -27dBm ≤ < -26dBm 95 -26dBm ≤ < -25dBm 96 -25dBm ≤ 255 未知或者不可检测 整型。Ec/No（请参考 3GPP 25.133） 0 -24dBm 或者更低 1 -24dBm ≤ < -23.5dBm 2 -23.5dBm ≤ < -23dBm … 47 -1dBm ≤ < -0.5dBm 48 -0.5dBm ≤ < 0dBm 49 0dBm ≤ 255 未知或者不可检测 整型。参考信号接收质量（请参考 3GPP 36.133）。 0 -19.5dB 或者更低 1 -19.5dB ≤ < -19dB 2 -19dB ≤ < -18.5dB … 上海移远通信技术股份有限公司 24 / 101 BC32 AT 命令手册 32 -4dB ≤ < -3.5dB 33 -3.5dB ≤ < -3dB 34 -3dB ≤ 255 未知或者不可检测 整型。参考信号接收功率（请参考 3GPP 36.133）。 0 -140dBm 或者更低 1 -140dBm ≤ < -139dBm 2 -139dBm ≤ < -138dBm … 95 -46dBm ≤ < -45dBm 96 -45dBm ≤ < -44dBm 97 -44dBm ≤ 255 未知或者不可检测 举例 AT+CESQ +CESQ: 51,99,255,255,20,65 OK 备注 和目前不适用于 BC32 模块，所以两者的值为 255（未知或者不可检测）。 5.3. AT+CREG GSM 网络注册状态 AT+CREG GSM 网络注册状态 测试命令 AT+CREG=? 查询命令 AT+CREG? 响应 +CREG: (支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 TA 返回结果代码表示的状态和整数，表示网络当前是否 上海移远通信技术股份有限公司 25 / 101 设置命令 AT+CREG= 最大响应时间 BC32 AT 命令手册 指示了 ME 的注册。仅当=2 并且 ME 在网络中注册时，才 返回位置信息元素和。 +CREG: ,[,,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当=1 并且 ME 网络注册状态发生变化时，TA 控制 URC +CREG: 的上报。. OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。 0 禁用网络注册 URC 1 使能网络注册 URC +CREG: 2 使能网络注册与位置信息 URC 整型。表示 EPS 注册状态。 0 未注册，ME 目前未搜索新网络进行注册 1 已注册，本地网络 2 未注册，但 ME 目前正在连接或搜索新网络进行注册 3 注册被拒绝 4 未知 5 已注册，漫游网络 字符串型。十六进制格式 2 字节跟踪区域代码。 字符串型。十六进制格式 2 字节小区 ID。 备注 1. 如果=1 且 ME 网络注册状态发生变化上报 URC：+CREG: 2. 如果=2 且 ME 网络注册状态发生变化或网络单元发生变化上报 URC：+CREG: [,,] 3. 通过执行命令 AT&W，该设置将保存至 NVM 中。 4. 此命令仅在 GSM 网络下有效，网络制式可以通过 AT+COPS 返回的参数值中查询，0 表示在 上海移远通信技术股份有限公司 26 / 101 BC32 AT 命令手册 GSM 网络下注册，9 表示在 NB-IoT 网络下注册，其他值表示当前未注册到网络。 举例 AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'1878','0873' //使能网络注册 URC。 //网络注册 URC //激活扩展 URC 模式 // URC 报告已发现具有跟踪区域代码和小区 ID 5.4. AT+CGREG GPRS 网络注册状态 该命令可控制关于 GPRS 注册状态一些中间结果码的显示。 ⚫ 当=1，且 GPRS 注册状态发生改变，提示+CGREG : ； ⚫ 当=2，且 GPRS 注册状态发生改变且注册小区发生改变，提示+CGREG : [,,]。 AT+CGREG GPRS 网络注册状态 测试命令 AT+CGREG=? 响应 +CGREG: (取值列表) OK 查询命令 AT+CGREG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGREG: ,[,,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 27 / 101 配置命令 AT+CGREG= 最大响应时间 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 BC32 AT 命令手册 参数 整型。 0 禁用网络注册 URC 1 使能网络注册 URC +CGREG: 2 使能网络注册 URC +CGREG: [,,] 0 未注册，ME 当前未搜索新营运商进行注册 1 已注册，本地网络 2 未注册，但 ME 正在搜索注册业务的新营运商 3 注册被拒绝 4 未知 5 已注册，漫游 字符型；2 位十六进制位置区代码（比如：00C3 相当于十六进制中的 195） 字符型；2 位十六进制小区编号 备注 此命令仅在 GSM 网络下有效，网络制式可以通过 AT+COPS 返回的参数值中查询，0 表示在 GSM 网络下注册，9 表示在 NB-IoT 网络下注册，其他值表示当前未注册到网络。 举例 AT+CGREG=1 OK AT+CGREG? +CGREG: 1,1 OK AT+CGREG=? +CGREG: (0,1,2) OK //使能 GPRS 网络注册 URC。 上海移远通信技术股份有限公司 28 / 101 BC32 AT 命令手册 5.5. AT+CEREG EPS 网络注册状态 设置命令用于设置 EPS 网络注册状态 URC 的显示：=1 设置在 E-UTRAN 中 UE 的 EPS 网络注册 状态发生改变时的 URC +CEREG: 的显示；=2 设置在 E-UTRAN 中的网络小区发生改变时的 URC +CEREG: [,[],[],[]] 的显示。参数、和只有在可用时才会 上 报 。 在 =2 的 基 础 上 ， 如 果 可 用 ， =3 设 置 当 的 值 改 变 时 在 URC 显 示 更 多 参 数 和 。 =4 设 置 当 UE 请 求 PSM 减 少 其 功 率 消 耗 时 的 URC +CEREG: [,[],[],[][,[],[][,[],[] ]]]的显示。 当=4 时，如果 E-UTRAN 的小区发生改变，URC 将向 UE 提供附加的 active-time 值及扩展周期性 TAU 值信息。当=5 时，如果的值发生改变，URC 将会比=4 时多上报和 参数。 参 数 、 、 、 、 、 与 只有在可用时才会上报。 查询命令返回结果代码呈现的状态和整型参数，其指示了 UE 是否已经注册当前网络。如果位 置信息参数、与可用，可在=2、3、4 或 5，且 UE 已注册网络时上报。如果参数 [,,] 可用，当=3 或 5 时返回。 相关 错误码，请参考第 14 章。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 响应 +CEREG: (支持的范围) OK 查询命令 AT+CEREG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当 =0、1、2 或 3 时： +CEREG: ,[,[],[],[[,, ]]] 当 =4 或 5 时： +CEREG: ,[,[],[],[][,[],[][,[],[]]]] 上海移远通信技术股份有限公司 29 / 101 BC32 AT 命令手册 设置命令 AT+CEREG= 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存（需先执行 AT&W 保存配置） 参数 整型。 0 禁用网络注册 URC 1 使能网络注册 URC +CEREG: 2 使能网络注册与位置信息 URC +CEREG: [,[],[],[]] 3 表示使能网络注册、位置信息和 EMM 原因值 URC： +CEREG: [,[],[],[][,,]] 4 表示对于请求 PSM 的 UE，使能网络注册和位置信息 URC +CEREG: [,[],[],[][,,[,[], []]]] 5 对于请求 PSM 的 UE，使能网络注册、位置信息和 EMM 原因值 URC +CEREG: [,[],[],[][,[],[][, [],[]]]] 整型。表示 EPS 注册状态。 0 未注册，UE 目前未搜索运营商进行注册 1 已注册，本地网络 2 未注册，但 UE 目前正在连接或搜索运营商进行注册 3 注册被拒绝 4 未知（例如，不在 E-UTRAN 范围内） 5 已注册，漫游网络 字符串型，十六进制 2 字节跟踪区域代码（例如'00C3'等于十进制的 195）。 字符串型，十六进制 4 字节的 E-UTRAN 小区 ID。 整型。表示服务小区的接入技术。 7 E-UTRAN 上海移远通信技术股份有限公司 30 / 101 BC32 AT 命令手册 9 E-UTRAN（NB-S1 模式） 整型。类型。 0 包含一个 EMM 原因值（请参考 3GPP TS 24.008[8] Annex G） 1 包含一个特定制造商的原因值 整型。包含注册失败的原因。该参数的类型由定义。 字符串型。8 位为一个字符。表示在 E-UTRAN 中分配给 UE 的 Active-time 值（T3324）。 Active-time 值编码为 GPRS Timer 2 信息元素的一个字符（octet 3），编码为位格式（例 如'00100100'等于 4 分钟）。关于编码及取值范围，请参考 GPRS Timer 2 IE in 3GPP TS 24.008 Table 10.5.163/3Gpp TS 24.008，3GPP TS 23.682 和 3GPP TS 23.401 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 的定时器值单位，定义如下： 位数 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 该值表示定时器被停用 字符串型，8 位格式的 1 字节参数。表示在 E-UTRAN 中分配给 UE 的扩展周期性 TAU 值（T3412）。扩展的周期 TAU 值，编码为 GPRS Timer 3 信息元素的 1 个字节（octet 3），编码为位格式（例如'01000111'等于 70 小时）。 关于编码及取值范围，请参考 3GPP TS 24.008 Table 10.5.163a/3GPP TS 24.008 中的 GPRS Timers 3 IE，也可在协议 3GPP TS 23.682 和 3GPP TS 23.401 中查看。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器的值单位，定义如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增 1 1 1 该值表示定时器被停用 举例 AT+CEREG=1 OK AT+CEREG? +CEREG: 1,1 OK AT+CEREG=? //使能网络注册 URC。 上海移远通信技术股份有限公司 31 / 101 +CEREG: (0-5) OK BC32 AT 命令手册 5.6. AT+CGATT PS 附着与去附着 该命令用于将 MT 附着于 PS 域或将 MT 从 PS 域去附着。命令执行后，MT 保持在 V.250 命令状态。 如果 MT 已经处于请求状态，则会忽略命令，并响应 OK。如果未实现请求状态，则会返回 ERROR 或 +CME ERROR 响应。相关 错误码，请参考第 14 章。 当附着状态改为去附着状态时，任何已激活的 PDP 上下文将自动停用。 查询命令返回当前 PS 域服务状态。 查询命令返回当前 PS 域附着状态。 AT+CGATT PS 附着与去附着 测试命令 AT+CGATT=? 响应 +CGATT: (支持的列表) OK 查询命令 AT+CGATT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGATT: OK 设置命令 AT+CGATT= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 32 / 101 BC32 AT 命令手册 最大响应时间 特性说明 75 秒，由网络判定 参数配置立即生效 参数 整型。表示 PDP 上下文激活的状态。 0 去附着 1 附着 备注 1. 在 NB-IoT 模式下，启动时将自动激活=1 的上下文。 2. 如果在 AT+CGATT 命令处理完成前，执行新的 AT+CGATT 命令，将返回错误。 3. 执行 AT+CGATT=0 去附着后，模块仍然会自动附着网络。 举例 AT+CGATT? +CGATT: 0 OK AT+CGATT=1 OK AT+CGATT=? +CGATT: (0,1) OK 5.7. AT+QCGDEFCONT 设置默认 PDP 上下文 该命令用于配置模块默认 PDP 上下文。模块上电并附着 NB-IoT 网络时，会建立一路默认的 PDN 连 接。因此，默认的 PDN 连接设置必须保存在 NVM 中，以便 Modem 可以在附着流程中使用所述 PDN 连接 设置。 相关 错误码，请参考第 14 章。 AT+QCGDEFCONT 设置默认 PDPP 上下文 测试命令 AT+QCGDEFCONT=? 响应 +QCGDEFCONT: (支持的列表)[,] 上海移远通信技术股份有限公司 33 / 101 BC32 AT 命令手册 OK 查询命令 AT+QCGDEFCONT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QCGDEFCONT: [,] OK 设置命令 AT+QCGDEFCONT=[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置重启后生效，且掉电保存 参数 字符串型。指定分组数据协议。 IP 网络协议（IETF STD 5） IPv6 网络协议版本 6（IETF RFC 2460） IPv4v6 双栈，UE 性能（参见 3GPP TS 24.301） Non-IP 无 IP 数据到外部分组网络的传输（参见 3GPP TS 24.301） 字符串型。 用于选择 GGSN 或外部分组数据网络的逻辑名称。如果值为空或省略，则 将请求订阅值。 举例 AT+QCGDEFCONT='IPV4V6' OK AT+QCGDEFCONT? +QCGDEFCONT: 'IPV4V6' OK 上海移远通信技术股份有限公司 34 / 101 备注 1. 该命令专用于配置 =1 的默认 PDP 上下文。 2. 仅在 NB-IoT 模式下有效。 BC32 AT 命令手册 5.8. AT+CGDCONT 定义 PDP 上下文 设置命令用来指定上下文指示参数 对应的 PDP 上下文和本地上下文的 PDP 上下文参数。因为 PCO 可包含需要加密的信息，所以该命令也允许 TE 指定是否请求 ESM 信息的安全保护传输。可能有其他 原因需要 UE 使用 ESM 信息的安全保护传输，例如，当 UE 需要转换 APN 时。测试命令返回值的范围给 出了可以同时处于定义状态的 PDP 上下文数量。相关 错误码，请参考第 14 章。 对 EPS 而言，设置该命令后会建立 PDN 连接并建立相关的默认承载，参数应该省略。 不携带任何可选参数的 AT+CGDCONT= 是此设置命令的一种特殊形式，会直接删除 对 应的 PDP 上下文，使其变成未定义。 查询命令返回每个已定义上下文的当前设置。 默认情况下，=1 的上下文在启动时定义，不需要使用 AT+CGDCONT 命令设置。初始 PDP 上 下文具有制造商特定的默认设置，与 AT+CGDCONT 命令参数的任何默认值无关无关。模块在 E-UTRAN 网络中成功注册之后，会自动激活初始 PDP 上下文。如果停用所有已激活的上下文，则可以（重新）建立 初始 PDP 上下文。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT: (支持的范围),(支持的),,,(支 持的范围),(支持的范围) OK 查询命令 AT+CGDCONT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGDCONT: ,,,,, [+CGDCONT: ,,,,,] [...] 上海移远通信技术股份有限公司 35 / 101 OK 设置命令 AT+CGDCONT=,[[,< APN>[,[,[,]]]]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 BC32 AT 命令手册 参数 整型。指示一个 PDP 上下文的标识符。UE-TE 接口的本地参数，可以用在其他 PDP 上 下文相关的命令中。范围：1-7。 字符串型，分组数据协议类型。 IP 网络协议（IETF STD 5 [103]） IPv6 互联网协议版本 6 IPv4v6 引入虚拟 处理 IP 双栈 UE 功能 Non-IP 无 IP 字符串型，用于选择 GGSN 或外部分组数据网络的逻辑名称。值为空或值省略时，将请 求订阅值。 字符串型。用于标识适用于 PDP 的地址空间中的 UE。如果该值为空或被省略，则 TE 在 PDP 启动过程期间时提供该值，否则，将请求动态地址。即使在 PDP 启动过程中已经分 配了地址，查询命令中此值的返回值将仍然是空字符串。可以使用 AT+CGPADDR 命令 读取分配的地址。 字符串型，控制 PDP 数据的压缩。 0 关闭 1 开启 2 V.42bis 3 V.44bis 字符串型，控制 PDP 头部部分压缩 0 关闭（参数缺省时默认为该值） 1 开启 2 RFC 1144（仅适用于 SNDCP） 3 RFC 2507 4 RFC 3095[ROHC]（仅适用于 PDCP） 上海移远通信技术股份有限公司 36 / 101 BC32 AT 命令手册 备注 1. AT+CGDCONT=，用于清除此命令配置的 PDP 上下文。 2. 已被配置激活的无法被清除或配置。 3. =1 对应的为默认的 PDP 上下文，无法通过命令 AT+CGDCONT 进行配置或清除，但可以通 过命令 AT+QCGDEFCONT 进行配置。 举例 AT+CGDCONT=? +CGDCONT: (1-7),('IP','IPV6','IPV4V6','Non-IP'),,,(0-3),(0-4) OK AT+CGDCONT=2,'IP','CMNBIOT' OK AT+CGDCONT? +CGDCONT: 1,'IP','CMNBIOT','0.0.0.0',0,0 +CGDCONT: 2,'IP','CMNBIOT','0.0.0.0',0,0 OK 5.9. AT+CGACT 激活或停用 PDP 上下文 该命令用于激活或停用指定的 PDP 上下文。该命令设置完成后，MT 保持在 V.250 命令状态。若任意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；如果不能实现任意上下文的请求状态，将返 回 ERROR 或 +CME ERROR 响应。 当激活形式的命令执行时，如果 UE 没有附着 PS，首先会附着 PS，然后尝试激活指定的上下文。如 果附着失败，则会响应错误。 请注意以下 3GPP TS 27.007 中的声明。 对于 EPS，如果尝试断开上一条 PDN 连接，UE 将响应 ERROR，或者如果使能了扩展错误响应，则 响应 +CME ERROR。 EPS 承载资源激活请求由网络通过 EPS 专用承载激活请求或者 EPS 承载修改请求来响应。必须在 UE 接受此请求之后 PDP 上下文方可设置为建立状态。 如未指定，该命令的激活形式将激活所有定义的 non-emergency 上下文，去激活格式将停用所 有已激活的 PDP 上下文。 查询命令返回所有定义的 PDP 上下文的当前激活状态。 上海移远通信技术股份有限公司 37 / 101 相关错误码，请参考第 14 章。 AT+CGACT 激活或停用 PDP 上下文 测试命令 AT+CGACT=? 响应 +CGACT: (支持的列表) OK 查询命令 AT+CGACT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGACT: , [+CGACT: ,] […] OK 设置命令 AT+CGACT=[,[,[,...] ]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若成功激活上下文: OK 若成功去激活上下文: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 150 秒，由网络判定。 参数配置立即生效 参数 整型。PDP 上下文的激活状态。 0 去激活（停用） 1 激活 上海移远通信技术股份有限公司 BC32 AT 命令手册 38 / 101 BC32 AT 命令手册 整型。指定一个 PDP 上下文的标识符（请查看 AT+CGDCONT）。 备注 1. 模块启动时，会自动使用 AT+QCGDEFCONT 命令配置的参数初始化=1 的上下文。 2. 不可停用最后激活的一路 PDP 上下文。 3. 当前，仅允许两路已激活的 PDP 上下文同时存在。 4. 激活 PDP 上下文前，需通过命令 AT+CGATT? 查询确保模块已经附着网络。 举例 AT+CGACT=1,1 OK AT+CGACT? +CGACT: 1,1 OK AT+CGACT=? +CGACT: (0,1) OK 5.10. AT+CGPADDR 显示 PDP 地址 该命令返回设备的 IP 地址。 执行命令返回指定上下文标识符的 PDP 地址清单。如果没有指定 ，则返回所有已定义上下文 的地址。 测试命令返回已定义的列表。这些已被激活，可能有也可能没有与之关联的 IP 地址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (激活 PDP列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 39 / 101 查询命令 AT+CGPADDR? 设置命令 AT+CGPADDR=[,[,...]] 执行命令 AT+CGPADDR 最大响应时间 特性说明 BC32 AT 命令手册 响应 [+CGPADDR: [,[,]]] [+CGPADDR: [,[,]]] [...] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGPADDR: [,[,]] [+CGPADDR: [,[,]]] [...] OK 若出现任何错误，响应： ERROR 或者 +CME ERROR: 响应 [+CGPADDR: [,[,]]] [+CGPADDR: [,[,]]] [...] OK 若出现任何错误： ERROR 或者 +CME ERROR: 。 300 毫秒 参数配置立即生效 参数 和 整型。指示一个 PDP 上下文的标识符（请查看命令 AT+CGDCONT）。 如果没有指定，则返回所有已定义上下文的地址。 字符串型。在适用于 PDP 的地址空间识别 MT，地址可以为静 态或动态。静态地址由命令 AT+CGDCONT 设定。动态地址是在上 上海移远通信技术股份有限公司 40 / 101 BC32 AT 命令手册 一次 PDP 上下文激活期间分配的，使用引用的上下文。如果 和的地址均不可用，则省略。 当分配 IPv4 及 IPv6 的地址时，和均 被指定，对应 IPv4 的地址，对应 IPv6 的地址。 该字符串以点分隔的数字参数（范围 0-255）形式： IPv4 的形式为：a1.a2.a3.a4；IPv6 的形式为：a1a2:a3a4:a5a6:a7a 8:a9a10:a11a12:a13a14:a15a16。 备注 在 双 栈 终端 （ =IPV4V6 ）， 对应 IPv6 的地址 ； 对于 IPv6 单 栈终端 （=IPV6）或者由于向后兼容性的原因，IPv6 地址也可包含在参数 中。 举例 AT+CGPADDR=1 +CGPADDR: 1,'101.43.5.1' OK AT+CGPADDR=? +CGPADDR: (1) OK 5.11. AT+QICSGP 配置 TCP/IP 上下文参数 该命令可用于配置，，和 TCP/IP 上下文的其他参数。 AT+QICSGP 配置 TCP/IP 上下文参数 测试命令 AT+QICSGP=? 响应 +QICSGP: (1-7)[,(1,2),[,,[,(0-2)]]] OK 查询命令 AT+QICSGP= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QICSGP: 上海移远通信技术股份有限公司 41 / 101 BC32 AT 命令手册 ,,,, OK 设置命令 AT+QICSGP=[,,[,,)[,]]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 参数 整型。上下文 ID。取值范围 1-7。 整型。协议类型。 1 IPV4 2 IPV4V6 字符串型。接入点名称。 字符串型。用户名。 字符串型。密码。 整数类型。身份验证方法。 0 NONE 1 PAP 2 CHAP 举例 AT+QICSGP=1,1,'UNINET',,,1 OK AT+QICSGP=1 +QICSGP: 1,1,'UNINET',,,1 OK //配置上下文 1。 //查询上下文的配置 1。 备注 上海移远通信技术股份有限公司 42 / 101 BC32 AT 命令手册 1. 若未通过 AT+QICSGP 配置 PDP 上下文，则无法使用该命令读取 PDP 上下文。 2. 该命令仅在需要配置 APN 用户名和密码时使用，否则请使用命令 AT+CGDCONT 配置 PDP 上下文。 3. 此命令仅适用于 GSM 网络。 4. APN 是中国联通的 UNINET。 5.12. AT+CSCON 信令连接状态 该命令返回 TA 感知到的无线连接状态（即和基站的连接）的详细信息，并返回当前状态的指示。该状 态仅在无线事件发生时更新，例如发送和接收数据。因此，当前返回的状态可能已经过时。即使在返回状 态 =1（已连接）的情况下，因为连接质量的变化，模块仍可能无法使用基站。 设置命令控制 URC 的显示。 查询命令返回 URC 设置状态和整型参数 ， 指 MT 当前为空闲状态或已连接状态。 相关错误码，请参考第 14 章。 AT+CSCON 信令连接状态 测试命令 AT+CSCON=? 响应 +CSCON: (支持的列表) OK 查询命令 AT+CSCON? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCON: , OK 设置命令 AT+CSCON= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 43 / 101 最大响应时间 特性说明 BC32 AT 命令手册 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存（需先执行 AT&W 保存配置） 参数 整型。表示使能/禁用 URC。 0 禁用 URC 1 使能 URC +CSCON: 整型。表示信令连接状态。 0 空闲 1 已连接 举例 AT+CSCON=0 OK AT+CSCON? +CSCON: 0,1 OK AT+CSCON=? +CSCON: (0,1) OK AT+CSCON=1 OK AT+CSCON? +CSCON: 1,1 OK 5.13. AT+COPS 运营商选择 设置命令强制尝试使用安装在当前所选卡槽中的 USIM 卡来选择和注册 EPS 网络运营商。参数 用来设置找网动作，是由 UE 自动完成，还是通过该命令以特定的接入方式，强制选择运 营商（由指定）。如果选择的接入技术不可用，应在其他接入技术中选择相同的运营商。 选定运营商名称的格式同样适用于查询命令 AT+COPS?。=2 强制尝试注销网络。所选模式会影 响后续所有网络注册（例如，当设置=2 后，只有在设置=0 或 1 时 MT 才会注册网络）。 上海移远通信技术股份有限公司 44 / 101 BC32 AT 命令手册 尝试注册或注销时，此命令应该是可中止的。 查询命令返回当前模式、当前所选运营商以及当前接入技术。如果没有选择运营商，则不会返回 、和。 测试命令返回五个参数，表示网络中出现的运营商。指示当前运营商是否可用的整型参数、运 营 商 的 数 字 编 码 、 接 入 技 术 的 数 字 编 码 、 注 册 模 式 及 运 营 商 名 称 的 格 式 。和 根据实际出现的运营商数量可能重复出现。以上参数可能不可用，不可用时 为空字段。运营商清单应按此顺序排列：本地网络、USIM 中选用的网络或 UICC（USIM）中的活动应用 程序引用（顺序：HPLMN 选择器、用户控制的 PLMN 选择器、运营商控制的 PLMN 选择器、USIM 中的 PLMN 选择器）以及其他网络。 选择接入技术的参数仅应用于能够注册多种接入技术的终端。的选择不会限制小区重选 的能力，即使已经尝试选择一种接入技术，移动设备也可以在其他接入技术中重选小区。 相关错误码，请参考第 14 章。 AT+COPS 运营商选择 测试命令 AT+COPS=? 响应 +COPS: [运营商(,长字符,短字符数字< oper>[,])][,,(支持的列表),(支持的列 表)] OK 查询命令 AT+COPS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS: [,,][,] OK 设置命令 AT+COPS=[,[,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 45 / 101 最大响应时间 +CME ERROR: 630 秒 BC32 AT 命令手册 参数 整型。运营商选择模式。 0 自动模式（省略、和 字段） 1 手动模式（包含和字段，可选） 2 手动注销网络 3 仅设置（将不在查询命令 AT+COPS?响应中返回） 4 手动/自动选择。如果手动选择失败，则进入自动模式（=0） 整型。的格式配置。 0 长字符 1 短字符 2 数字 字符串型，指示此参数格式是否为数字格式；数字格式是 NB-IoT 网络位置 区域标识号，它由三位 BCD 数字 ITU-T 国家代码编码，加上两位或三位 BCD 数字网 络代码组成的。=0 时，参数省略。 整型。运营商状态。 0 未知运营商 1 可用运营商 2 当前运营商 3 禁用的运营商 整型。接入技术设置。 0 GSM 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 备注 1. 测试命令只能在模块处于 Idle 时执行，否则将返回错误。 2. 网络制式可以通过 AT+COPS 返回的参数值中查询，0 表示在 GSM 网络下注册，9 表示在 NB-IoT 网络下注册，其他值表示当前未注册到网络。 举例 AT+COPS=0 OK AT+COPS? +COPS: 0,2,'46000',9 OK 上海移远通信技术股份有限公司 46 / 101 BC32 AT 命令手册 5.14. AT+CPSMS 省电模式设置 该命令控制 UE 省电模式（PSM）参数的设置，可以用来控制 UE 是否应用 PSM，以及 E-UTRAN 中 请求的扩展周期 TAU 值的范围和激活时间值。请参考 AT+CEREG 返回的 URC 查看激活时间值以及 E-UTRAN 网络分配给 UE 的扩展周期 TAU 值。 AT+CPSMS=2 是该命令的一种特殊形式，在这种形式下，将禁用 PSM，并删除已通过 AT+CPSMS 命令设置的所有参数（若参数有默认值，则将其恢复为默认值）。 查询命令返回当前设置的参数值。 相关 错误码，请参考第 14 章。 AT+CPSMS 省电模式设置 测试命令 AT+CPSMS=? 响应 +CPSMS: (支持的列表),,,(支持的范围),(支持的范围) OK 查询命令 AT+CPSMS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPSMS: [,,,[],[] OK 设置命令 AT+CPSMS=[,,,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 47 / 101 BC32 AT 命令手册 特性说明 参数配置立即生效，且掉电保存 参数 整型。表示禁用或使能 UE 的 PSM。 0 禁用 PSM 1 启用 PSM 2 禁用 PSM 并删除 PSM 的所有参数，若有默认值，则重置为默认值。 字符串型。8 位格式的 1 字节参数。表示将在 E-UTRAN 分配给 UE 的请 求扩展周期性 TAU 值（T3412），且被编码为 GPRS Timer 3 信息的 1 个 字符（octet 3）（例如'01000111'等于 70 小时）。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了定时器值的单位，具体如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增（备注） 1 1 1 该值表示定时器被停用 字符串型，8 位格式的 1 字节参数。表示待分配给 UE 的请求激活时间值 （T3324）（如'00100100'等于 4 分钟）。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了 GPRS 定时器值的有效时间值单位，具体如下： 位数 8 7 6 0 0 0 0 0 1 0 1 0 1 1 1 该值以 2 秒的倍数递增 该值以 1 分钟的倍数递增 该值以 6 分钟的倍数递增 表示定时器被停用的值 备注 1. 该定时器值的单位仅适用于 T3412 扩展值 IE。如果以完整性保护消息的形式接收，那么将以 320 小 时的倍数解读接收到的值，否则，将以 1 小时的倍数解读。 2. AT+CPSMS? 查询命令只会返回模式值 0 和 1。 3. 该命令可以设置模块向核心网络请求的 TAU 和 Active-time 的时间，请求值是否生效最终取决于网络。 上海移远通信技术股份有限公司 48 / 101 BC32 AT 命令手册 举例 AT+CPSMS=1,,,'00111000','00000101' OK AT+CPSMS? +CPSMS: 1,,,'00111000','00000101' //设置请求的 TAU 值为 24 小时，Active-time 为 10 秒 OK AT+CPSMS=? +CPSMS: (0-2),,,('00000000'-'11111111'),('00000000'-'11111111') OK 5.15. AT+CEDRXS eDRX 设置 设置命令设置 UE 的 eDRX 参数，即设置 UE 是否要应用 eDRX，以及指定接入技术请求的 eDRX 值。 当=2，且网络提供的 eDRX 参数发生变化时，该设置命令将用于控制 URC +CEDRXP: [,[,[,]]] 的 上 报。 该设置命令包含一种特殊形式：AT+CEDRXS=3。此形式的命令将禁用 eDRX，并删除已通过 AT+CEDRXS 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 相关 错误码，请参考第 14 章。 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的范围),(支持的列表), (支持的范围) OK 查询命令 AT+CEDRXS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXS: ,, OK 上海移远通信技术股份有限公司 49 / 101 BC32 AT 命令手册 设置命令 AT+CEDRXS=[,[,< Requested_eDRX_value>]] 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误，响应： ERROR 或者 +CME ERROR: 300 毫秒 特性说明 参数配置立即生效，且掉电保存 参数 整型。表示启用或禁用 eDRX。该参数适用于所有指定的接入技术类型， 即的最新设置将对所有指定取值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并启用 URC +CEDRXP: [,[,[,]]]上报 3 禁用 eDRX 并清除所有的 eDRX 参数配置（若有默认值，则重置 为默认值） 整型。接入技术类型。 0 未使用 eDRX 的接入技术，该参数值仅在 URC 中使用。 5 E-UTRAN（NB-S1 模式） 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 上海移远通信技术股份有限公司 50 / 101 BC32 AT 命令手册 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型，4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS: 1,5,'0101' OK AT+CEDRXS=? +CEDRXS: (0-3),(5),('0000'-'1111') 上海移远通信技术股份有限公司 51 / 101 BC32 AT 命令手册 OK 5.16. AT+CEDRXRDP 查询动态 eDRX 参数 如 果 eDRX 用 于 MS 当 前 注 册 的 小 区 时 ， 该 执 行 命 令 返 回 、 、和。 如果 MS 当前注册的小区未使用 eDRX，则参数的返回值为 0。 相关错误码，请参考第 14 章。 AT+CEDRXRDP 查询动态 eDRX 参数 测试命令 AT+CEDRXRDP=? Response OK 执行命令 AT+CEDRXRDP 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXRDP: [,[,< NW-provided_eDRX_value>[,]]] OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。表示接入技术类型。 5 E-UTRAN（NB-S1 模式） 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 上海移远通信技术股份有限公司 52 / 101 BC32 AT 命令手册 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型，4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串型。4 位格式的半字节参数。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗口长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 上海移远通信技术股份有限公司 53 / 101 举例 AT+CEDRXRDP +CEDRXRDP: 5,'0010','1110','0101' OK AT+CEDRXRDP=? OK BC32 AT 命令手册 5.17. AT+QBAND 获取和设置工作频段 该命令用于获取当前使用的频段或设置要锁定的频段。相关错误码，请参考第 14 章。 AT+QBAND 获取和设置工作频段 测试命令 AT+QBAND=? 响应 +QBAND: (支持的范围)[,(支持的 列表)] OK 查询命令 AT+QBAND? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QBAND: OK 设置命令 AT+QBAND=[,[,[,…]]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 54 / 101 BC32 AT 命令手册 特性说明 参数配置重启后生效，且掉电保存 参数 整型。表示要设置的频段个数。 0 设置工作频段为模块支持的所有频段，此时无需后续参数指定具体的频段 1-5 要设置的频段个数 整型。 NB-IoT 频段。有效值：3、5、8、20 和 28。 整型。表示正在使用的频段。有效值：3、5、8、20 和 28。 备注 1. BC32-B8 机型是单频段版本，因此仅支持 B8。 2. 仅在 NB-IoT 网络下有效。 举例 AT+QBAND=? +QBAND: (0-5),(3,5,8,20,28) OK AT+QBAND=1,5 OK AT+QBAND? +QBAND: 5 OK //查询支持的频段列表。 //设置要使用的频段 //查询正在使用的频段 5.18. AT+QLOCKF 锁定 NB-IoT EARFCN 该命令用于将 UE 锁定到特定 EARFCN（频点），以及可选地，锁定到特定的小区 ID。相关错 误码，请参考第 14 章。 AT+QLOCKF 锁定 NB-IoT EARFCN 测试命令 AT+QLOCKF=? 响应 +QLOCKF: (支持的列表)[,,(支持的 范围)[,]] OK 上海移远通信技术股份有限公司 55 / 101 BC32 AT 命令手册 查询命令 AT+QLOCKF? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLOCKF: [,,[,]] OK 设置命令 AT+QLOCKF=[,,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，且掉电保存 参数 整型。激活/移除锁定。 0 移除锁定 1 激活锁定 整型。要请求锁定的 EARFCN。范围：0-262143。取值为 0 时，表示移除对 EARFCN 和小区的锁定。 整型。请求的 EARFCN 的偏移量。 0 偏移-20 1 偏移-19 … 19 偏移-1 … 37 偏移 17 38 偏移 18 整型。物理小区 ID，范围：0-503。 上海移远通信技术股份有限公司 56 / 101 备注 仅在 NB-IoT 模式下有效。 BC32 AT 命令手册 5.19. AT+QENG 查询工程模式 该命令用于查询工程模式下，服务小区的当前 Modem 状态信息和网络状态。相关错误码，请参 考第 14 章。 AT+QENG 查询工程模式 测试命令 AT+QENG=? 响应 +QENG: (支持的列表) OK 设置命令 AT+QENG= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当=0 时 +QENG: 0,,,,,[],[],[],[],< sc_band>,,[], [] [+QENG: 1,,,,, [+QENG: 1,,,,], […] OK 当=1 时： +QENG: 2,,,,,,,,,,,,,, OK 上海移远通信技术股份有限公司 57 / 101 BC32 AT 命令手册 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 * * 整型。请求的工程信息。 0 显示服务和相邻小区的无线电信息 1 仅当 Modem 处于 RRC-CONNECTED 状态时显示数据传输信息 整型。服务小区的 EARFCN。范围：0-262143。 整型。服务小区的 EARFCN 偏移量。 0 偏移-20 1 偏移-19 … 19 偏移-1 … 37 偏移 17 38 偏移 18 整型。服务小区的物理小区 ID，范围：0-503。 字符串型。4 字节（28 位）服务小区 ID。十六进制格式。. 带符号的小数型。服务小区的 RSRP 值。单位：dBm。（可为负数值）。仅 在 RRC-IDLE 状态下可用。 带符号的整型。表示服务小区的 RSRQ 值，单位：dB。（值可以是负数）。 仅在 RRC-IDLE 状态下可用。 有符号整型。表示服务小区的 RSSI 值。单位：dBm。（可为负数值）。仅 在 RRC-IDLE 状态下可用。 有符号整型。表示服务小区的上一个 SNR 值。单位：dB。仅在 RRC-IDLE 状态下可用。 整型。当前服务小区频段。 字符串型，双字节跟踪区域代码（TAC）。十六进制格式（例如，'00C3' 等于十进制格式的 195）。 整型。服务小区的上次增强覆盖级别（ECL）值。范围：0-2。 带符号的整型。当前 UE 发射功率。单位：cBm。 整型。相邻小区的 EARFCN，范围：0-262143。 整型。相邻小区的 EARFCN 偏移量 0 偏移-20 1 偏移-19 20 偏移 0 37 偏移 17 38 偏移 18 上海移远通信技术股份有限公司 58 / 101 BC32 AT 命令手册 整型。相邻小区的物理小区 ID。范围：0-503。 带符号的小数型。相邻小区的 RSRP 值。单位：dBm。（可为负数值）。 整型。百分比值。（范围：0-100）。RLC 层的 UL 误块率（根据每个 IRQ）。 基于所有建立的 RLC AM 无线电承载计算。从成功建立/恢复 RRC 连接开 始，或从前一个 =1 的 AT+QENG 开始计算（以较晚者为准）。仅 在 RRC-CONNECTED 状态下有效。 整型。百分比值。（范围：0-100）。RLC 层的 DL 误块率（根据每个 ARQ）。 基于所有建立的 RLC AM 无线承载计算。从成功建立/恢复 RRC 连接开始， 或从前一个 =1 的 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。 整型。百分比值。（范围：0-100）。UL-SCH 的 MAC 中的 UL 误块率（根 据每个 HARQ）。从成功建立/恢复/重新建立 RRC 连接开始，或从前一个 =1 的 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。 整型。百分比值。（范围：0-100）。DL-SCH 的 MAC 中的 DL 误块率， 不包括 BCCH。从成功建立/恢复/重新建立 RRC 连接开始计算，或者从之 前=1 时查询 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。 整型。在 UL-SCH 上（重新）传输块字节总数。基于针对 UL-SCH 的所有 HARQ 传输和重传计算。从成功建立/恢复/重新建立 RRC 连接开始，或 从前一个=1 时查询 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位：字节。 整型。在 DL-SCH 上传输（或重新）传输块字节总数，不包括 BCCH。从 成功建立/恢复/重新建立 RRC 连接开始计算，或者从前一个=1 时 查询 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状 态下有效。单位：字节。 整型。UL-SCH 上传输块的 HARQ（或重新）总次数。从成功建立/恢 复/重新建立 RRC 连接开始计算，或从前一个=1 时查询 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下 有效。单位：传输（或重传）次数。 整型。DL-SCH 上传输块的 HARQ（重新）传输总数，不包括 BCCH。从 成功建立/恢复/重新建立 RRC 连接开始计算，或者从前一个=1 时查询 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位：传输（或重传）次数。 整型。UL-SCH 上传输块的 HARQ 重传次数。从成功建立/恢复/重新建立 RRC 连接开始计算，或者从前一个=1 时查询 AT+QENG 开始计 算，以较晚者为准。仅在 RRC-CONNECTED 状态下有效。单位：传输（或 重传）次数。 整型。DL-SCH 上传输块的 HARQ 重传次数。不包括 BCCH。从成功建 立/恢复/重新建立 RRC 连接开始计算，或者从前一个=1 时查询 AT+QENG 开始计算，以较晚者为准。仅在 RRC-CONNECTED 状态下有 效。单位：传输（或重传）次数。 整型。RLC 上行吞吐量。计算所有已建立的 RLC AM 无线电承载。从成 功建立/恢复 RRC 连接开始计算，或者从前一个=1 时查询 上海移远通信技术股份有限公司 59 / 101 BC32 AT 命令手册 AT+QENG 开始计算，以较晚者为准。仅在 RRC-CONNECTED 状态下有 效。单位：kbits/s。 整型。RLC 下行吞吐量。计算所有已建立的 RLC AM 无线电承载。从成 功建立/恢复 RRC 连接开始计算，或者从前一个=1 时查询 AT+QENG 开始计算，以较晚者为准。仅在 RRC-CONNECTED 状态下有 效。单位：kbits/s。 整型。UL-SCH 上 MAC 中的 UL 吞吐量。从成功建立/恢复/重新建立 RRC 连接开始计算，或者从前一个=1 时查询 AT+QENG 开始计算（以 较晚者为准）。仅在 RRC-CONNECTED 状态下有效。单位：kbits/s。 整型。DL-SCH 上 MAC 中的下行吞吐量，不包括 BCCH。从成功建立/恢 复/重新建立 RRC 连接开始计算，或者从前一个=1 时查询 AT+QENG 开始计算（以较晚者为准）。仅在 RRC-CONNECTED 状态下 有效。单位：kbits/s。 备注 1. 该命令仅在 NB-IoT 网络下有效。 2. '*' 表示正在开发中。 5.20. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 该命令用于启用/禁用事件的上报 URC。相关错误码，请参考第 14 章。 AT+QNBIOTEVENT 启用/禁用 NB-loT 相关事件上报 测试命令 AT+QNBIOTEVENT=? 响应 +QNBIOTEVENT: (支持的列表),(支持的 列表) OK 查询命令 AT+QNBIOTEVENT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QNBIOTEVENT: , OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 60 / 101 BC32 AT 命令手册 设置命令 AT+QNBIOTEVENT=, 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存（需先执行 AT&W 保存配 置） 参数 整型。 0 禁用事件指示 URC 1 启用事件指示 URC：'+QNBIOTEVENT: ' 整型。 表示事件类型。 1 表示 PSM 状态。 字符串型。表示具体事件。 当为 PSM 时，为 ENTER PSM 或 EXIT PSM。 备注 该命令仅在 NB-IoT 网络下有效。 5.21. AT+QCSEARFCN 清除 NB-IoT/GSM 存储的 EARFCN 列表 该命令用于清除 UE 存储的 EARFCN 列表。相关错误码，请参考第 14 章。 AT+QCSEARFCN 清除 NB-loT/GSM 存储的 EARFCN 列表 测试命令 AT+QCSEARFCN=? 响应 +QCSEARFCN: (支持的列表) OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 61 / 101 设置命令 AT+QCSEARFCN= 最大响应时间 特性说明 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置重启后生效 参数 整型。表示清除 NB-IoT/GSM 存储的 EARFCN 列表 0 清除 NB-IoT 存储的 EARFCN 列表 1 清除 GSM 存储的 EARFCN 列表 举例 AT+QCSEARFCN=0 OK BC32 AT 命令手册 5.22. AT+QCFG 扩展配置设置 该命令用于配置 UE 的各种设置 AT+QCFG 扩展配置设置 测试命令 AT+QCFG=? 响应 +QCFG: 'EPCO',(支持的列表) OK 设置命令 AT+QCFG='EPCO'[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略参数，则查询当前 EPCO 配置： 上海移远通信技术股份有限公司 62 / 101 最大响应时间 特性说明 BC32 AT 命令手册 +QCFG: 'EPCO', OK 若指定 ，则配置 EPCO： OK 若出现任何错误: ERROR 或者 +CME ERROR: 300 毫秒 参数配置重启后生效，且掉电保存 参数 整型。EPCO 状态 0 禁用 EPCO 1 启用 EPCO 举例 AT+QCFG='EPCO' +QCFG: 1 OK AT+QCFG='EPCO',0 OK 备注 1. 当 EPCO 启用时，如果网络不支持 EPCO，模块在连接后自动禁用 EPCO。 2. 该命令仅在 NB-IoT 网络下有效。 5.23. AT+CCIOTOPT CloT 优化配置 设置命令设置 UE 在 ATTACH REQUEST 和 TRACKING AREA UPDATE REQUEST 消息中指示所支 持和优先选择的 CIoT EPS 优化配置。该命令还可用来上报网络支持的 CIoT EPS 优化配置。支持 CIoT 功 能的 UE 可以支持控制面（control plane）或用户面（user plane）的 CIoT EPS 优化配置，或两者都可支 上海移远通信技术股份有限公司 63 / 101 BC32 AT 命令手册 持（请参考 3GPP TS 24.301, sub-clause 9.9.3.34）。基于应用特性，UE 可能优先选择注册用于控制面的 CIoT EPS 优化配置或用于用户面的 CIoT EPS 优化配置（请参考 3GPP TS 24.301, sub-clause 9.9.3.0B）。 此外，网络可支持控制面 CIoT EPS 优化配置或用户面 CIoT EPS 优化配置或两者都可支持（请参考 3GPP TS 24.301, sub-clause 9.9.3.12A）。 设置命令还用于设置开启或关闭 URC +CCIOTOPTI: ，该 URC 用于表示 网络所支持的 CIoT EPS 优化配置。 查询命令返回当前支持和首选的 CIoT EPS 优化配置，以及当前 URC +CCIOTOPTI 的状态。 相关错误码，请参考第 14 章。 AT+CCIOTOPT CloT 优化配置 测试命令 AT+CCIOTOPT=? 响应 +CCIOTOPT: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的列 表) OK 查询命令 AT+CCIOTOPT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCIOTOPT: ,, OK 设置命令 AT+CCIOTOPT=[,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当=0 或=2： OK 当=1 时： OK +CCIOTOPTI: 上海移远通信技术股份有限公司 64 / 101 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存 BC32 AT 命令手册 参数 整型。开启/禁用 URC +CCIOTOPTI 的上报 0 禁用 URC 1 启用 URC 2 禁用上报并将用于 CIoT EPS 优化配置的参数重置为默认值 整型。表示 UE 支持的 CIoT EPS 优化配置 0 不支持 CP 及 up Ciot 1 支持控制面板 CIoT EPS 优化配置 2 支持用户面板 CIoT EPS 优化配置 3 支持控制面板 CIoT EPS 优化配置和支持用户面板 CIoT EPS 优化配置 整型。表示 UE 优先选择的 CIoT EPS 优化配置 1 优先选择用于控制面板的 CIoT EPS 优化配置 2 优先选择用于用户面板的 CIoT EPS 优化配置 整型。表示网络所支持的 CIoT EPS 优化配置数。范围：0-3。 备注 1. 由于 NB-IoT 必须支持 CP CIoT，故被配置为 0 或 2 时无效。 2. 该命令仅在 NB-IoT 网络下有效。 5.24. AT+CTZR 上报时区 设置命令启用/禁用时区变化事件上报。启用上报后，一旦时区发生改变，MT 将返回 URC +CTZV: 。相关错误码，请参考第 14 章。 AT+CTZR 上报时区 测试命令 AT+CTZR=? 响应 +CTZR: (支持的列表) OK 上海移远通信技术股份有限公司 65 / 101 查询命令 AT+CTZR? 设置命令 AT+CTZR= 最大响应时间 特性说明 BC32 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CTZR: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存（需先执行 AT&W 保存配置） 参数 整型。禁用或开启时区变化事件上报 URC。 0 禁用时区变化事件上报 URC 1 启用时区变化事件上报 URC +CTZV: 字符串型。本地时区总和（当地时间与 GMT 的时差，以 15 分钟表示）加上夏令时的 总和，格式为'±zz'，长度固定为-48 ~+56 的 2 位整数。为保持固定宽度，范围在 -9 ~+9 之间的数字均以 0 开头，例如'-09'，'+00'，'+09'。 举例 AT+CTZR=? +CTZR: (0,1) OK AT+CTZR=0 OK AT+CTZR? +CTZR: 0 上海移远通信技术股份有限公司 66 / 101 BC32 AT 命令手册 OK 5.25. AT+CGAPNRC 查询 APN 速率控制参数 设置命令返回指定的上下文标识符参数对应的 APN 速率控制参数（请参考 3GPP TS 24.008 [8]）。 执行命令返回所有的已激活 PDP 上下文的 APN 速率控制参数。 相关错误码，请参考第 14 章。 AT+CGAPNRC 查询 APN 速率控制参数 测试命令 AT+CGAPNRC=? 响应 +CGAPNRC: (已激活 PDP 上下文列表) OK 设置命令 AT+CGAPNRC= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAPNRC: [,[,[,]]] OK 执行命令 AT+CGAPNRC 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAPNRC: [,[,[,]]] [+CGAPNRC: [,[,< Uplink_time_unit>[,]]]] [...] OK 若出现任何错误： 上海移远通信技术股份有限公司 67 / 101 最大响应时间 特性说明 BC32 AT 命令手册 ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，掉电保存（需先执行 AT&W 保存配置） 参数 整型。指示一个 PDP 上下文的标识符（请参考 AT+CGDCONT 命令）。 整型。表示当达到最大上行速率时是否允许发送额外异常报告。 此参数为 3GPP TS 24.008 [8] subclause 10.5.6.3.2 中规定的 APN 速率控制参数 IE 的八位位组 1 的第 4 位。 0 表示不允许以最大速率发送 1 表示允许以最大速率发送 整型。最大上行速率使用的时间单位。为 3GPP TS 24.008 [8] subclause 10.5.6.3.2 中规定的 APN 速率控制参数 IE 的八位位组 1 的第 1 位到第 3 位。 0 不受限 1 分钟 2 小时 3 天数 4 周 整型。每个上行时间单位限制 UE 发送的最大消息数。为 3GPP TS 24.008 [8] subclause 10.5.6.3.2 中规定的 APN 速率控制参数 IE 的八位组 1 的第 2 位到第 4 位。 备注 该命令仅在 NB-IoT 网络下有效。 5.26. AT+QSPCHSC 设置加扰算法 该命令用来选择新旧扰码。由于扰码已经由 3GPP 更新，UE 需要为网络选择正确的扰码。相关 错误码，请参考第 14 章。 AT+QSPCHSC 设置加扰算法 测试命令 响应 上海移远通信技术股份有限公司 68 / 101 AT+QSPCHSC=? 查询命令 AT+QSPCHSC? 设置命令 AT+QSPCHSC= 最大响应时间 特性说明 参数 整型。算法类别。 0 旧算法 1 新算法 备注 该命令仅在 NB-IoT 网络下有效。 BC32 AT 命令手册 +QSPCHSC: (支持的列表) OK 响应 +QSPCHSC: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存 5.27. AT+QNWCFG 配置网络工作模式 该命令用于设置双模 UE 在上电时工作在 NB-IoT 优先级或 GSM 优先级；仅用于双模 UE。 AT+QNWCFG 配置网络工作模式 测试命令 AT+QNWCFG=? 响应 +QNWCFG: (支持的列表)[,(支持的参数 上海移远通信技术股份有限公司 69 / 101 设置命令 AT+QNWCFG =[,] 查询命令 AT+QNWCFG? 最大响应时间 BC32 AT 命令手册 列表)] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 如果有任何与 ME 功能相关的错误： +CME ERROR: 响应 +QNWCFG: [,] OK 如果有任何与 ME 功能相关的错误: +CME ERROR: 300 毫秒 参数 开机时的网络模式。 0 当模式设置为 0 时，GSM 或 NB-IoT 网络由优先级控制 1 忽略优先级影响，优先注册到 NB 网络 开机时的网络模式。 0 优先注册 NB-IoT 网络 1 优先注册 GSM 网络 举例 AT+QNWCFG=? +QNWCFG: (0,1)[,(0,1)] OK AT+QNWCFG=0,0 OK AT+QNWCFG? +QNWCFG: 0,0 //NB-IoT 网络优先级 //查询模式 上海移远通信技术股份有限公司 70 / 101 BC32 AT 命令手册 OK 备注 1. 当模式改变时，即 MODE 0/1 切换时，需要重启模块才能生效。 2. 模块正在搜网时，配置优先级会失败。当 MODE 为 0，改变网络优先级时，建议执行 AT+CFUN=0, 再执行 AT+QNWCFG=0,，AT+CFUN=1 来切换网络。 上海移远通信技术股份有限公司 71 / 101 BC32 AT 命令手册 6 硬件相关指令 6.1. AT+CFUN 设置 UE 功能 该命令用来选择 UE 的功能等级。'全部功能'等级对应高级别的功率。'最少功能'对应低级别的 功率。 查询命令返回的当前设置。 测试命令返回 MT 所支持参数的范围。 相关错误码，请参考第 14 章。 AT+CFUN 设置 UE 功能 测试命令 AT+CFUN=? 响应 +CFUN: (支持的列表),(支持的列表) OK 查询命令 AT+CFUN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CFUN: OK 设置命令 AT+CFUN=[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： 上海移远通信技术股份有限公司 72 / 101 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 15 秒, 由网络判定。 参数配置立即生效 参数 整型。UE 功能等级。 0 最少功能 1 全部功能 整型。表示在设置功率等级后是否重置 UE。 0 不重启 UE。 1 重启 UE，自动保存。 举例 AT+CFUN=? +CFUN:(0,1),(0,1) OK AT+CFUN=1 OK AT+CFUN? +CFUN:1 OK BC32 AT 命令手册 6.2. AT+QSCLK 设置睡眠模式 该命令用于设置睡眠模式。相关错误码，请参考第 14 章。 AT+QSCLK 设置睡眠模式 测试命令 AT+QSCLK=? 响应 +QSCLK: (支持的范围) OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 73 / 101 查询命令 AT+QSCLK? 设置命令 AT+QSCLK= 最大响应时间 特性说明 BC32 AT 命令手册 或者 +CME ERROR: 响应 +QSCLK: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，且掉电保存 参数 0 整型。睡眠模式。 1 启用轻度睡眠和深度睡眠，通过 PSM_EINT（低电平）唤醒 2 仅启用轻度睡眠，由主 UART 唤醒 备注 1. 在深度睡眠模式下，UART 不会工作。因此，当 AT+QSCLK=1 时，发送 AT 命令之前需确保已经唤 醒 UART。 2. 当 AT+QSCLK=0 时，UART 始终处于工作模式。当 AT+QSCLK=0 时，模块始终处于工作模式。 如 果需要允许模块进入睡眠模式，请重新发送命令 AT+QSCLK=1 或 2。 举例 AT+QSCLK=1 OK 上海移远通信技术股份有限公司 74 / 101 6.3. AT+QRST 重启模块 该命令用来立即重启模块。相关错误码，请参考第 14 章。 AT+QRST 重启模块 测试命令 AT+QRST=? 响应 +QRST: (支持的的列表) OK 设置命令 AT+QRST= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效 参数 1 立即自动重启 BC32 AT 命令手册 6.4. AT+QPOWD 模块关机 该命令用于关闭或重启模块。相关错误码，请参考第 14 章。 AT+QPOWD 模块关机 测试命令 AT+QPOWD=? 响应 +QPOWD: (支持的范围) OK 上海移远通信技术股份有限公司 75 / 101 设置命令 AT+QPOWD= 最大响应时间 特性说明 BC32 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当=0 时： OK 当=1 时： NORMAL POWER DOWN 当=2 时： OK 若出现任何错误： ERROR 或者 +CME ERROR: 1秒 参数配置立即生效 参数 0 1 2 举例 AT+QPOWD=0 OK 紧急关机（不发送 URC NORMAL POWER DOWN） 正常关机（执行从网络去附着的动作，并发送 URC NORMAL POWER DOWN） 重启模块 上海移远通信技术股份有限公司 76 / 101 BC32 AT 命令手册 6.5. AT+CCLK 查询当前日期和时间 一旦 UE 连接到网络，将自动设置时钟。 查询命令返回时钟的当前设置。 AT+CCLK 查询当前日期和时间 测试命令 AT+CCLK=? 响应 OK 查询命令 AT+CCLK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCLK: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 字符串型，格式为'yy/MM/dd,hh:mm:ss'，各字符分别表示年（最后 2 位数字），月， 日，时，分，秒。 举例 AT+CCLK=? OK 上海移远通信技术股份有限公司 77 / 101 BC32 AT 命令手册 6.6. AT+CBC 查询电源电压值 该命令用于查询电源的电压值。 相关错误码，请参考第 14 章。 AT+CBC 查询电源电压值 测试命令 AT+CBC=? 响应 +CBC: (支持的列表),(支持的列表),(的 值) OK 执行命令 AT+CBC 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CBC: ,, OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 电池充电状态 0 ME 不在充电 1 ME 正在充电 2 充电已经完成 3 充电适配器已连接，充电完成 4 充电异常，充电中断 5 充电温度异常，当温度超出允许范围内，充电中断 电池电量 0...100 电池剩余容量为 0-100％ 电池电压（mV）。 上海移远通信技术股份有限公司 78 / 101 BC32 AT 命令手册 备注 由于 BC32 模块不支持电池充电，和无效，而仍然代表正确的电源电压。 举例 AT+CBC +CBC: 0,0, 3856 OK 6.7. AT+QATWAKEUP 启用/禁用深度睡眠唤醒指示 该命令用于配置进入或退出深度睡眠时是否上报相关 URC。相关错误码，请参考第 14 章。 AT+QATWAKEUP 启用/禁用深度睡眠唤醒指示 测试命令 AT+QATWAKEUP=? 响应 +QATWAKEUP: (支持的列表) OK 查询命令 AT+QATWAKEUP? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QATWAKEUP: OK 设置命令 AT+QATWAKEUP= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 79 / 101 BC32 AT 命令手册 最大响应时间 特性说明 300 毫秒 参数配置立即生效，且掉电保存（需先执行 AT&W 保存配置） 参数 整型。 0 禁用当模块进入/退出深度睡眠模式时的 URC 1 启用当模块进入/退出深度睡眠模式时的 URC 备注 该命令仅在 NB-IoT 网络下有效。 举例 AT+QATWAKEUP=1 //启用唤醒指示 OK //模块进入深度睡眠模式。 +QATSLEEP //当模块成功进入深度睡眠模式时，将上报此 URC。 //模块进入深度睡眠模式。 +QATSLEEPFAIL //当模块进入深度睡眠模式失败时，将上报此 URC。 //该模块从深度睡眠模式唤醒 +QATWAKEUP //模块已完全被唤醒并准备接收 AT 命令/数据。 6.8. AT+QLEDMODE 配置网络指示灯 该命令用于启用或禁用网络指示灯。 AT+QLEDMODE 配置网络指示灯 测试命令 AT+QLEDMODE=? 响应 +QLEDMODE: (支持的列表) OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 80 / 101 查询命令 AT+QLEDMODE? 设置命令 AT+QLEDMODE= 最大响应时间 特性说明 或者 +CME ERROR: 响应 +QLEDMODE: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置重启后生效，且掉电保存 BC32 AT 命令手册 参数 整型。网络指示灯状态 0 禁用网络指示灯 1 启用网络指示灯 举例 AT+QLEDMODE=1 OK 6.9. AT+QADC 读取 ADC 该命令用于读取 ADC。 AT+QADC 读取 ADC 测试命令 AT+QADC=? 响应 +QADC: (支持的列表),(的值) 上海移远通信技术股份有限公司 81 / 101 查询命令 AT+QADC? 最大响应时间 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QADC: , OK 若出现任何错误： ERROR 或者 +CME ERROR: 2秒 参数 整型。读取状态。 0 读取失败 1 读取成功 ADC 值。范围：0~1890。单位：mV BC32 AT 命令手册 上海移远通信技术股份有限公司 82 / 101 BC32 AT 命令手册 7 TCPIP 相关指令 有关 TCPIP 功能的详细信息，请参考 Quectel_BC25&BC32_TCP(IP)_应用指导。 表 2: TCPIP 相关命令 命令 AT+QIOPEN AT+QICLOSE AT+QISTATE AT+QISEND AT+QIRD AT+QISENDEX AT+QISWTMD AT+QPING AT+QNTP AT+QIDNSGIP AT+QICFG AT+QIGETERROR AT+QIKALIVE AT+QIDNSCFG 描述 打开 Socket 关闭 Socket 查询 Socket 状态 发送文本字符串数据 读取收到的 TCP/IP 数据 发送十六进制字符串数据 切换数据访问模式 进行远程服务器 Ping 操作 通过 NTP 服务器同步本地时间 通过域名获取 IP 地址 配置可选参数 查询上一个错误代码 配置 TCP Socket Keepalive 功能 配置 DNS 服务器功能 上海移远通信技术股份有限公司 83 / 101 BC32 AT 命令手册 8 OneNET 相关指令 有关 OneNET 功能的详细信息，请参阅 Quectel_BC25&BC32_OneNET_应用指导。 表 3: OneNET 相关命令 命令 描述 AT+MIPLCONFIG OneNET 接入配置 AT+MIPLCREATE 创建 OneNET 通信套件实例 AT+MIPLDELETE 删除 OneNET 通信套件实例 AT+MIPLVER 查询当前 OneNET SDK 版本 AT+MIPLADDOBJ 添加 LwM2M 对象 AT+MIPLDELOBJ 删除 LwM2M 对象 AT+MIPLOPEN 发送注册请求 AT+MIPLCLOSE 发送注销请求 AT+MIPLDISCOVERRSP 响应发现资源请求 AT+MIPLOBSERVERSP 响应订阅请求 AT+MIPLREADRSP 响应读取请求 AT+MIPLWRITERSP 响应写入请求 AT+MIPLEXECUTERSP 响应执行请求 AT+MIPLPARAMETERRSP 响应写属性请求 AT+MIPLNOTIFY 向 OneNET 平台或应用服务器上报数据 AT+MIPLUPDATE 发送更新请求 上海移远通信技术股份有限公司 84 / 101 BC32 AT 命令手册 9 CMDMP 相关指令 有关 CMDMP 功能的详细信息，请参阅 Quectel_BC25&BC32_CMDMP_应用指导。 表 4: CMDMP 相关命令 命令 AT+QDMPCFG AT+QDMPCFGEX 描述 CMDMP 接入配置 CMDMP 接入扩展配置 上海移远通信技术股份有限公司 85 / 101 BC32 AT 命令手册 10 DFOTA 相关指令 有关 DFOTA 功能的详细信息，请参阅 Quectel_BC25&BC32_DFOTA_应用指导。 表 5: DFOTA 相关命令 命令 AT+QFOTADL 描述 通过 HTTP 服务器进行 DFOTA 升级、串口 DFOTA 升级和文件下载功能 上海移远通信技术股份有限公司 86 / 101 BC32 AT 命令手册 11 MQTT 相关指令 有关 MQTT 功能的详细信息，请参考 Quectel_BC25&BC32_MQTT_应用指导。 表 6: MQTT 相关命令 命令 AT+QMTCFG AT+QMTOPEN AT+QMTCLOSE AT+QMTCONN AT+QMTDISC AT+QMTSUB AT+QMTUNS AT+QMTPUB 描述 配置 MQTT 参数 打开 MQTT 客户端网络 关闭 MQTT 客户端网络 连接客户端到 MQTT 服务器 客户端断开与 MQTT 服务器的连接 订阅主题 退订主题 发布消息 上海移远通信技术股份有限公司 87 / 101 BC32 AT 命令手册 12 FS*相关命令 有关 FS 功能的详细信息，请参阅 Quectel_BC25&BC32_文件系统应用指导。 表 7: FS 相关命令 命令 AT+QFLST AT+QFLDS AT+QFUPL AT+QFDWL AT+QFDEL AT+QFMOV AT+QFOPEN AT+QFREAD AT+QFWRITE AT+QFSEEK AT+QFCLOSE AT+QFPOSITION AT+QFFLUSH AT+QFTUCAT AT+QFRENAME 备注 *该功能正在开发中 描述 列出文件 获取文件和存储空间大小 上传文件 下载文件 删除文件 从 RAM 移动文件至 UFS 打开文件 读取文件内容 写文件内容 移动当前文件操作指针 关闭文件 获取当前文件操作指针 将缓存内容写入文件 以当前文件操作指针截取文件 重命名文件 上海移远通信技术股份有限公司 88 / 101 BC32 AT 命令手册 13 举例 13.1. 网络附着 模块开机后会自动进行网络附着。 13.1.1. 手动查询网络附着状态 以下举例说明了如何配置模块自动附着网络。用户仅需通过如下命令来查询模块是否已经附着网络。 //开机 RDY +CFUN: 1 +CPIN: READY AT OK AT+CFUN? +CFUN: 1 //同步成功。 //全部功能。 OK AT+CIMI 460012345678969 //查询 IMSI。 OK AT+CESQ //查询扩展信号质量。 +CESQ: 36,99,255,255,12,53 OK AT+QENG=0 //查询模块当前网络状态。 +QENG: 0,2506,,25,'dda1b53',-74,25,-60,4,5,'69c9',0,1 OK AT+CGATT? +CGATT: 1 //查询是否附着了网络。 //表示成功附着网络。 上海移远通信技术股份有限公司 89 / 101 BC32 AT 命令手册 OK AT+CEREG? +CEREG: 0,1 OK AT+CSCON? +CSCON: 0,1 OK //查询 EPS 网络注册状态。 //已注册本地网络。 //查询信令连接状态。 //RRC 已连接。 13.1.2. 通过 URC 上报自动附着网络状态 以下是一个自动附着网络的简单示例。用户不需要通过命令查询模块是否已经附着网络，通过上报的 URC 即可得知网络附着状态。 //开机 RDY +CFUN: 1 +CPIN: READY //配置初始网络附着的 APN。 //一旦设置，参数将会被保存到 NVRAM。 //重启或重新注册时生效。 AT+QCGDEFCONT='IP','CMNBIOT' OK AT+QRST=1 OK RDY +CFUN: 1 +CPIN: READY AT+CFUN? +CFUN: 1 //全部功能。 OK AT+CIMI 460012345678969 //查询 IMSI。 OK AT+CEREG=1 //使能网络注册 URC。 上海移远通信技术股份有限公司 90 / 101 OK AT+CSCON=1 OK //使能 URC。 +CSCON: 1 //RRC 已连接。 +CEREG: 1 //已注册，本地网络。 AT+CESQ //查询扩展信号质量。 +CESQ: 36,99,255,255,25,53 OK AT+QENG=0 //查询模块当前网络状态。 +QENG: 0,3738,,105,'82e76b2',-71,22,-56,22,8,'4c10',1,-6 OK AT+CGATT? +CGATT: 1 //查询是否附着了网络。 //成功附着网络。 OK AT+CEREG? +CEREG: 1,1 //查询 EPS 网络注册状态。 //已注册本地网络。 OK AT+CSCON? +CSCON: 1,1 //查询信令连接状态。 //RRC 已连接。 OK 13.1.3. 通过指定的 PLMN 附着网络 以下举例说明了如何通过指定的 PLMN 自动附着网络。 //开机 RDY +CFUN: 1 +CPIN: READY //配置初始网络附着的 APN。 //一旦设置，参数将会保存到 NVRAM。 //重启或重新注册时生效。 AT+QCGDEFCONT='IP','CMNBIOT' OK AT+QRST=1 OK 上海移远通信技术股份有限公司 BC32 AT 命令手册 91 / 101 RDY +CFUN: 1 +CPIN: READY AT+CFUN? +CFUN: 1 //全部功能。 OK AT+CIMI 460012345678969 //查询 IMSI。 OK AT+COPS=1,2,'46000' //指定 PLMN。 OK AT+CESQ //查询扩展信号质量。 +CESQ: 36,99,255,255,255,53 OK AT+QENG=0 //查询模块当前网络状态。 +QENG: 0,3734,,105,'82e76b2',-71,22,-56,22,8,'4c10',1,-6 OK AT+CGATT? +CGATT: 1 //查询是否附着了网络。 //成功附着网络。 OK AT+CEREG? +CEREG: 0,1 //查询 EPS 网络注册状态。 //已注册本地网络。 OK AT+CSCON? +CSCON: 0,1 //查询信令连接状态。 //RRC 已连接。 OK 13.1.4. 通过指定的 EARFCN/PCI 附着网络 //开机 RDY +CFUN: 1 上海移远通信技术股份有限公司 BC32 AT 命令手册 92 / 101 +CPIN: READY //配置初始网络附着的 APN。 //一旦设置，参数将会保存到 NVRAM。 //重启或重新注册时生效。 AT+QCGDEFCONT='IP','CMNBIOT' OK AT+QRST=1 OK RDY +CFUN: 1 +CPIN: READY AT+CFUN? +CFUN: 1 //全部功能。 OK AT+CIMI 460012345678969 //查询 IMSI。 OK AT+QLOCKF=1,3734,19,105 OK AT+CESQ +CESQ: 36,99,255,255,12,53 //指定 EARFCN，偏移量和 PCI。 //查询扩展信号质量。 OK AT+QENG=0 //查询模块当前网络状态。 +QENG: 0,3734,,105,'82e76b2',-71,22,-56,22,8,'4c10',1,-6 OK AT+CGATT? +CGATT: 1 //查询是否附着了网络。 //成功附着网络。 OK AT+CEREG? +CEREG: 0,1 //查询网络注册状态。 //已注册本地网络。 OK AT+CSCON? +CSCON: 0,1 //查询信令连接状态。 //RRC 已连接。 上海移远通信技术股份有限公司 BC32 AT 命令手册 93 / 101 OK 13.1.5. 通过指定的频段附着网络 //开机 RDY +CFUN: 1 +CPIN: READY //配置初始网络附着 APN。 //一旦设置，参数将会保存到 NVRAM。 //重启或重新注册时生效。 AT+QCGDEFCONT='IP','CMNBIOT ' OK AT+QRST=1 OK RDY +CFUN: 1 +CPIN: READY AT+CFUN? +CFUN: 1 //全部功能。 OK AT+QBAND=? +QBAND: (0-5),(3,5,8,20,28) //查询支持的频段列表。 OK AT+QBAND=1,5 OK AT+QBAND? +QBAND: 5 //设置要使用的频段。 //查询正在使用的频段。 OK 13.1.6. 优先注册到 GSM 网络 //开机 RDY +CFUN: 1 上海移远通信技术股份有限公司 BC32 AT 命令手册 94 / 101 BC32 AT 命令手册 +CPIN: READY //配置网络工作模式和优先级。 //如果之前未配置过网络，则默认注册 NB-IoT 网络。 //重启后生效。 AT+QNWCFG? +QNWCFG: 1 //默认为 NB-IoT 优先级。 OK AT+CFUN=0 OK AT+QNWCFG=0,1 OK AT+QRST=1 OK //优先注册 GSM 网络。 //立即自动重启。 RDY +CFUN: 1 +CPIN: READY AT+CGACT? +CGACT: 1,1 OK AT+QNWCFG? +QNWCFG: 0,1 OK AT+COPS? +COPS: 0,2,'46000',0 //该命令用于查询驻留信息，0 表示 GSM 网络。 OK AT+CGDCONT=1,'IP' OK AT+CGACT=1,1 OK AT+CGPADDR? +CGPADDR: 1,'100.103.86.73' //GSM 模式下，需要手动配置 PDP。 //GSM 模式下，需要手动激活 PDP。 //查询是否获取到 IP，获取 IP 后可以正常进行网络业务。 OK 上海移远通信技术股份有限公司 95 / 101 BC32 AT 命令手册 13.1.7. 优先注册到 NB-IoT 网络 //开机 RDY +CFUN: 1 +CPIN: READY //配置网络工作模式和优先级。 //如果之前未配置过网络，则默认注册 NB-IoT 网络。 //重启后生效。 AT+QNWCFG? +QNWCFG: 0,1 //GSM 网络优先。 OK AT+CFUN=0 OK AT+QNWCFG=0,0 OK AT+QRST=1 OK //使用 AT+QNWCFG=1 命令可以强制模块的 NB-IoT 网络优先级。 //立即自动重启。 RDY +CFUN: 1 +CPIN: READY AT+CGACT? +CGACT: 1,1 OK AT+QNWCFG? +QNWCFG: 0,0 //NB-IoT 网络优先。 OK AT+COPS? +COPS: 0,2,'46000',9 //该命令用于查询驻留信息，9 表示 NB-IoT 网络。 OK AT+CGPADDR? +CGPADDR: 1,'100.103.86.73' //NB 模式下使用 AT+QCGDEFCONT 配置的参数，自动激活 PDP。 OK 上海移远通信技术股份有限公司 96 / 101 BC32 AT 命令手册 14 错误代码 本章主要介绍与 BC32 模块相关的错误代码。 下表列出的错误码符合 3GPP 规范。请参考 3GPP TS 27.007 V13.5.0, sub-clause 9.2 了解更多 错误码。 表 8：错误代码列表 3 4 10 13 14 22 24 49 50 51 52 53 58 错误代码 Operation not allowed Operation not supported USIM not inserted USIM failure USIM busy Not found Text overlong Execution not supported Execution failed AT command no memory Option not supported Parameter invalid Invalid command line 上海移远通信技术股份有限公司 97 / 101 以下错误代码为 BC32 模块指定的错误代码。 表 9：指定错误代码列表 111 112 113 132 133 149 160 264 265 301 302 304 305 310 311 312 313 314 315 332 517 错误代码 PLMN not allowed Location area not allowed Roaming not allowed in this location area Service option not supported Requested service option not subscribed PDP authentication failure AT command cannot actioned USIM verification failed USIM unblock failed SMS service reserved Operation not allowed Invalid PDU parameter Invalid TXT parameter USIM not inserted USIM pin required PH USIM pin required USIM failed USIM busy USIM wrong Network timeout Invalid PDU character 上海移远通信技术股份有限公司 BC32 AT 命令手册 98 / 101 BC32 AT 命令手册 备注 AT+CMEE= 命令禁用（=0）或使能（=1）使用最终结果代码 +CME ERROR: 。当 =1 时，发生错误时，将返回一组有限的错误代码。 上海移远通信技术股份有限公司 99 / 101 BC32 AT 命令手册 15 附录 表 10：参考文档 编号 文档名称 [1] Quectel_BC25&BC32_TCP(IP)_应用指导 [2] Quectel_BC25&BC32_OneNET_应用指导 [3] Quectel_BC25&BC32_CMDMP_应用指导 [4] Quectel_BC25&BC32_DFOTA_应用指导 备注 BC25 和 BC32 模块的 TCP/IP 应用指导 BC25 和 BC32 模块的 OneNET 应用指导 BC25 和 BC32 模块的中国移动设备管理平台应 用指导 BC25 和 BC32 模块的 DFOTA 应用指导 表 11：术语和缩写 缩写 3GPP BCD IMSI EARFCN eDRX GMT GPRS HPLMN IMEI MCU MS NB-IoT 英文描述 中文描述 3rd Generation Partnership Project 第三代合作伙伴计划 Binary Coded Decimal 二进码十进数 International Mobile Subscriber Identity 国际移动用户识别码 E-UTRAN Absolute Radio Frequency E-UTRAN 绝对无线频道编号 Channel Number Extended Discontinuous Reception 扩展非连续性接收 Greenwich Mean Time 格林尼治标准时间 General Packet Radio Service 通用分组无线服务技术 Home Public Land Mobile Network 本地公用陆地移动网络 International Mobile Equipment Identity 国际移动设备识别码 Microcontroller Unit 微控制单元 Mobile Station 移动台 Narrow Band Internet of Thing 窄带物联网 上海移远通信技术股份有限公司 100 / 101 NVM PDP PLMN PSM RRC TA TE UE UICC URC UUID Non-volatile Memory Packet Data Protocol Public Land Mobile Network Power Saving Mode Radio Resource Control Terminal Adapter Terminal Equipment User Equipment Universal Integrated Circuit Card Unsolicited Result Code Universally Unique Identifier BC32 AT 命令手册 非易失存储器 分组数据协议 公共陆地移动网络 省电模式 无线资源控制 终端适配器 终端设备 用户设备 通用集成电路卡 非请求结果码 通用唯一识别码 上海移远通信技术股份有限公司 101 / 101

EM12&EG12&EG18 AT Commands Manual LTE-A Module Series Rev. EM12&EG12&EG18_AT_Commands_Manual_V1.0 Date: 2020-01-08 Status: Released www.quectel.com LTE-A Module Series EM12&EG12&EG18 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. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2020. All rights reserved. EM12&EG12&EG18_AT_Commands_Manual 1 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual About the Document Revision History Revision Date 1.0 2020-01-08 Author Amos ZHANG/ Ned WANG Description Initial EM12&EG12&EG18_AT_Commands_Manual 2 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 9 1 Introduction .......................................................................................................................................... 9 1.1. Scope of the Document ............................................................................................................. 9 1.2. AT Command Syntax ................................................................................................................ 9 1.3. Supported Character Sets ....................................................................................................... 10 1.4. AT Command Interface ........................................................................................................... 10 1.5. Unsolicited Result Code .......................................................................................................... 10 1.6. Turn off Procedure................................................................................................................... 11 2 General Commands ........................................................................................................................... 12 2.1. ATI Display MT Identification Information ............................................................................. 12 2.2. AT+GMI Request Manufacturer Identification ...................................................................... 13 2.3. AT+GMM Request MT Model Identification ......................................................................... 13 2.4. AT+GMR Request MT Firmware Revision Identification...................................................... 14 2.5. AT+CGMI Request Manufacturer Identification.................................................................... 14 2.6. AT+CGMM Request MT Model Identification ....................................................................... 15 2.7. AT+CGMR Request MT Firmware Revision Identification ................................................... 15 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) ...................................... 16 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI).................................... 17 2.10. AT&F Set All Current Parameters to Manufacturer Defaults................................................ 17 2.11. AT&V Display Current Configuration .................................................................................... 18 2.12. AT&W Store Current Parameters to User Defined Profile ................................................... 19 2.13. ATZ Restore All AT Command Settings from User Defined Profile ..................................... 19 2.14. ATQ Set Result Code Presentation Mode ............................................................................ 20 2.15. ATV MT Response Format ................................................................................................... 20 2.16. ATE Set Command Echo Mode............................................................................................ 22 2.17. A/ Repeat Previous Command Line ..................................................................................... 22 2.18. ATS3 Set Command Line Termination Character ................................................................ 23 2.19. ATS4 Set Response Formatting Character .......................................................................... 24 2.20. ATS5 Set Command Line Editing Character ........................................................................ 24 2.21. ATX Set CONNECT Result Code Format and Monitor Call Progress ................................. 25 2.22. AT+CFUN Set UE Functionality............................................................................................ 26 2.23. AT+CMEE Error Message Format........................................................................................ 27 2.24. AT+CSCS Select TE Character Set ..................................................................................... 28 2.25. AT+QURCCFG Configure URC Indication Option ............................................................... 29 3 Status Control Commands ............................................................................................................... 31 3.1. AT+CPAS Mobile Equipment Activity Status........................................................................ 31 3.2. AT+CEER Extended Error Report ........................................................................................ 32 EM12&EG12&EG18_AT_Commands_Manual 3 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 3.3. AT+QCFG Extended Configuration Settings ........................................................................ 33 3.3.1. AT+QCFG='nwscanmode' Network Search Mode Configuration.............................. 34 3.3.2. AT+QCFG='roamservice' Roam Service Configuration ............................................ 35 3.3.3. AT+QCFG='servicedomain' Service Domain Configuration ...................................... 35 3.3.4. AT+QCFG='band' Band Configuration ...................................................................... 36 3.3.5. AT+QCFG='hsdpacat' HSDPA Category Configuration............................................. 37 3.3.6. AT+QCFG='hsupacat' HSUPA Category Configuration ............................................ 38 3.3.7. AT+QCFG='rrc' RRC Release Version Configuration ............................................... 39 3.3.8. AT+QCFG='sgsn' UE SGSN Release Version Configuration ................................... 39 3.3.9. AT+QCFG='msc' UE MSC Release Version Configuration....................................... 40 3.3.10. AT+QCFG='pdp/duplicatechk' Establish Multi PDNs with the Same APN ................ 41 3.3.11. AT+QCFG='risignaltype' RI Signal Output Carrier .................................................... 41 3.3.12. AT+QCFG='urc/delay' Delay URC Indication ............................................................ 42 3.3.13. AT+QCFG='tone/incoming' Enable/Disable Ringing Tone ........................................ 43 3.3.14. AT+QCFG='sarcfg' Set SAR Power Backoff Value for LTE/WCDMA Bands ............ 44 3.3.15. AT+QCFG='gpsdrx' Configure GNSS Antenna Connection Mode............................ 46 3.4. AT+QINDCFG URC Indication Configuration....................................................................... 46 4 (U)SIM Related Commands ............................................................................................................... 49 4.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) ...................................... 49 4.2. AT+CLCK Facility Lock ......................................................................................................... 50 4.3. AT+CPIN Enter PIN .............................................................................................................. 52 4.4. AT+CPWD Change Password.............................................................................................. 54 4.5. AT+CSIM Generic (U)SIM Access ....................................................................................... 55 4.6. AT+CRSM Restricted (U)SIM Access .................................................................................. 56 4.7. AT+QCCID Show ICCID ....................................................................................................... 57 4.8. AT+QPINC Display PIN Remainder Counter ....................................................................... 58 4.9. AT+QINISTAT Query Initialization Status of (U)SIM Card ................................................... 59 4.10. AT+QSIMDET (U)SIM Card Detection ................................................................................. 59 4.11. AT+QSIMSTAT (U)SIM Card Insertion Status Report ......................................................... 60 4.12. AT+QUIMSLOT Switch (U)SIM Slot ..................................................................................... 62 5 Network Service Commands ............................................................................................................ 64 5.1. AT+COPS Operator Selection .............................................................................................. 64 5.2. AT+CREG Network Registration Status ............................................................................... 66 5.3. AT+CSQ Signal Quality Report ............................................................................................ 67 5.4. AT+CPOL Preferred Operator List ....................................................................................... 69 5.5. AT+COPN Read Operator Names ....................................................................................... 70 5.6. AT+CTZU Automatic Time Zone Update.............................................................................. 71 5.7. AT+CTZR Time Zone Reporting........................................................................................... 72 5.8. AT+QLTS Obtain the Latest Time Synchronized through Network ..................................... 73 5.9. AT+QNWINFO Query Network Information ......................................................................... 75 5.10. AT+QSPN Query the Service Provider Name ...................................................................... 76 5.11. AT+QENG Query Primary Serving Cell and Neighbour Cell Information ............................ 77 5.12. AT+QCAINFO Query Carrier Aggregation Parameters ....................................................... 81 EM12&EG12&EG18_AT_Commands_Manual 4 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 5.13. AT+QNETINFO='servingcell' Query Serving Cell Information ............................................ 82 5.14. AT+QPING Ping a Remote Server ....................................................................................... 84 6 Call Related Commands.................................................................................................................... 87 6.1. ATA Answer an Incoming Call .............................................................................................. 87 6.2. ATD Originate a Call ............................................................................................................. 88 6.3. ATH Disconnect Existing Connection ................................................................................... 89 6.4. AT+CVHU Voice Hang up Control........................................................................................ 90 6.5. AT+CHUP Hang up Calls ..................................................................................................... 91 6.6. +++ Switch from Data Mode to Command Mode ................................................................. 91 6.7. ATO Switch from Command Mode to Data Mode ................................................................ 92 6.8. ATS0 Set Number of Rings before Automatically Answering Call ....................................... 93 6.9. ATS6 Set Pause before Blind Dialing ................................................................................... 94 6.10. ATS7 Set Time to Wait for Connection Completion ............................................................. 94 6.11. ATS8 Set the Time to Wait for Comma Dial Modifier ........................................................... 95 6.12. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier ................... 96 6.13. AT+CSTA Select Type of Address ....................................................................................... 96 6.14. AT+CLCC List Current Calls of MT ...................................................................................... 97 6.15. AT+CR Service Reporting Control........................................................................................ 98 6.16. AT+CRC Set Cellular Result Codes for Incoming Call Indication ........................................ 99 6.17. AT+CRLP Select Radio Link Protocol Parameter .............................................................. 101 6.18. AT+QECCNUM Configure Emergency Call Numbers ....................................................... 102 6.19. AT+QHUP Hang up Call with a Specific Release Cause................................................... 104 6.20. AT^DSCI Call Status Indication .......................................................................................... 105 6.21. AT+QCHLDIPMPTY Remove a Participant from the Conference Call .............................. 107 7 Phonebook Commands................................................................................................................... 108 7.1. AT+CNUM Subscriber Number .......................................................................................... 108 7.2. AT+CPBF Find Phonebook Entries .................................................................................... 109 7.3. AT+CPBR Read Phonebook Entries .................................................................................. 110 7.4. AT+CPBS Select Phonebook Memory Storage ................................................................. 111 7.5. AT+CPBW Write Phonebook Entry .................................................................................... 112 8 Short Message Service Commands............................................................................................... 114 8.1. AT+CSMS Select Message Service ................................................................................... 114 8.2. AT+CMGF Message Format............................................................................................... 115 8.3. AT+CSCA Service Center Address .................................................................................... 116 8.4. AT+CPMS Preferred Message Storage ............................................................................. 117 8.5. AT+CMGD Delete Messages ............................................................................................. 119 8.6. AT+CMGL List Messages ................................................................................................... 120 8.7. AT+CMGR Read Messages ............................................................................................... 123 8.8. AT+CMGS Send Messages................................................................................................ 127 8.9. AT+CMMS Send More Messages ...................................................................................... 128 8.10. AT+CMGW Write Messages to Memory ............................................................................ 129 8.11. AT+CMSS Send Messages from Storage .......................................................................... 131 8.12. AT+CNMA New Message Acknowledgement to UE/TE .................................................... 133 EM12&EG12&EG18_AT_Commands_Manual 5 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 8.13. 8.14. 8.15. 8.16. AT+CNMI SMS Event Reporting Configuration.................................................................. 135 AT+CSCB Select Cell Broadcast Message Types ............................................................. 137 AT+CSDH Show SMS Text Mode Parameters .................................................................. 138 AT+CSMP Set SMS Text Mode Parameters...................................................................... 139 9 Packet Domain Commands ............................................................................................................ 141 9.1. AT+CGATT Attachment or Detachment of PS ................................................................... 141 9.2. AT+CGDCONT Define PDP Contexts................................................................................ 142 9.3. AT+CGQREQ Quality of Service Profile (Requested) ....................................................... 144 9.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) ........................................ 146 9.5. AT+CGACT Activate or Deactivate PDP Contexts............................................................. 149 9.6. AT+CGDATA Enter Data State........................................................................................... 150 9.7. AT+CGPADDR Show PDP Address .................................................................................. 151 9.8. AT+CGREG GPRS Network Registration Status............................................................... 152 9.9. AT+CGEREP Packet Domain Event Reporting ................................................................. 154 9.10. AT+CGSMS Select Service for MO SMS Messages ......................................................... 157 9.11. AT+CEREG EPS Network Registration Status .................................................................. 157 9.12. AT+QGDCNT Packet Data Counter ................................................................................... 158 9.13. AT+QAUGDCNT Auto Save Packet Data Counter ............................................................ 160 9.14. AT+QMTUINFO Query MTU Value .................................................................................... 161 9.15. AT$QCRMCALL Start or Stop an RmNet Call ................................................................... 162 9.16. AT+QNETDEVSTATUS Query RmNet Device Status ....................................................... 163 10 Supplementary Service Commands .............................................................................................. 171 10.1. AT+CCFC Call Forwarding Number and Conditions Control ............................................. 171 10.2. AT+CCWA Call Waiting Control ......................................................................................... 173 10.3. AT+CHLD Call Related Supplementary Services .............................................................. 175 10.4. AT+CLIP Calling Line Identification Presentation............................................................... 177 10.5. AT+CLIR Calling Line Identification Restriction.................................................................. 178 10.6. AT+COLP Connected Line Identification Presentation ...................................................... 179 10.7. AT+CSSN Supplementary Service Notifications ................................................................ 181 10.8. AT+CUSD Unstructured Supplementary Service Data ...................................................... 182 11 Audio Commands ............................................................................................................................ 184 11.1. AT+CLVL Loudspeaker Volume Level Selection ............................................................... 184 11.2. AT+CMUT Mute Control ..................................................................................................... 185 11.3. AT+QAUDLOOP Enable/Disable Audio Loop Test ............................................................ 186 11.4. AT+VTS DTMF and Tone Generation ................................................................................ 186 11.5. AT+VTD Set Tone Duration................................................................................................ 188 11.6. AT+QAUDMOD Set Audio Mode........................................................................................ 189 11.7. AT+QDAI Digital Audio Interface Configuration ................................................................. 189 11.8. AT+QEEC Set Echo Cancellation Parameters................................................................... 192 11.9. AT+QSIDET Set the Side Tone Gain in Current Mode ...................................................... 193 11.10. AT+QMIC Set Uplink Gains of Microphone ........................................................................ 193 11.11. AT+QRXGAIN Set Downlink Gains of RX .......................................................................... 194 11.12. AT+QIIC IIC Read & Write.................................................................................................. 196 EM12&EG12&EG18_AT_Commands_Manual 6 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11.13. AT+QTONEDET Enable/Disable DTMF Detection ............................................................ 197 11.14. AT+QLDTMF Play Local DTMF.......................................................................................... 198 11.15. AT+QLTONE Play a Local Customized Tone .................................................................... 199 11.16. AT+QAUDCFG Configure Audio Related Settings............................................................. 200 11.16.1. AT+QAUDCFG='voltedtmfcfg' Configure VoLTE DTMF Tone ................................. 201 12 Hardware Related Commands ........................................................................................................ 203 12.1. AT+QPOWD Power off ....................................................................................................... 203 12.2. AT+CCLK Clock .................................................................................................................. 203 12.3. AT+CBC Battery Charge .................................................................................................... 204 12.4. AT+QADC Read ADC Value .............................................................................................. 205 12.5. AT+QSCLK Enable/Disable Entering Sleep Mode............................................................. 206 12.6. AT+QTEMP Get the Temperature of MT............................................................................ 207 12.7. AT+QPMUGPIO Set the PMU GPIO Output Value............................................................ 208 12.8. AT+QSAR Enable/Disable the SAR Power Backoff........................................................... 209 13 Appendix ........................................................................................................................................... 210 13.1. References ............................................................................................................................ 210 13.2. Factory Default Settings Restorable with AT&F.................................................................... 212 13.3. AT Command Settings Storable with AT&W ......................................................................... 214 13.4. AT Command Settings Storable with ATZ ............................................................................ 214 13.5. Summary of CME ERROR Codes......................................................................................... 215 13.6. Summary of CMS ERROR Codes......................................................................................... 217 13.7. Summary of URC................................................................................................................... 219 13.8. SMS Character Sets Conversions......................................................................................... 221 13.9. Release Cause Text List of AT+CEER ................................................................................. 227 EM12&EG12&EG18_AT_Commands_Manual 7 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Table Index TABLE 1: TYPES OF AT COMMANDS AND RESPONSES ............................................................................. 10 TABLE 2: AT&V RESPONSE............................................................................................................................. 18 TABLE 3: THE NUMERIC EQUIVALENTS AND BRIEF DESCRIPTION OF ATV0&ATV1 RESULT CODES .. 21 TABLE 4: DELAY CLASS ................................................................................................................................ 146 TABLE 5: RELATED DOCUMENTS ................................................................................................................ 210 TABLE 6: TERMS AND ABBREVIATIONS ...................................................................................................... 210 TABLE 7: FACTORY DEFAULT SETTINGS RESTORABLE WITH AT&F ...................................................... 212 TABLE 8: AT COMMAND SETTINGS STORABLE WITH AT&W .................................................................... 214 TABLE 9: AT COMMAND SETTINGS STORABLE WITH ATZ ....................................................................... 214 TABLE 10: DIFFERENT CODING SCHEMES OF +CME ERROR: ................................................... 215 TABLE 11: DIFFERENT CODING SCHEMES OF +CMS ERROR: ................................................... 217 TABLE 12: SUMMARY OF URC ..................................................................................................................... 219 TABLE 13: THE WAY OF SMS TEXT INPUT OR OUTPUT............................................................................ 221 TABLE 14: THE INPUT CONVERSIONS TABLE (DCS=GSM 7-BIT AND AT+CSCS='GSM') ...................... 221 TABLE 15: THE OUTPUT CONVERSIONS TABLE (DCS=GSM 7-BIT AND AT+CSCS='GSM').................. 222 TABLE 16: GSM EXTENDED CHARACTERS (GSM ENCODE).................................................................... 223 TABLE 17: THE INPUT CONVERSIONS TABLE (DCS=GSM 7-BIT AND AT+CSCS='IRA') ........................ 224 TABLE 18: IRA EXTENDED CHARACTERS .................................................................................................. 225 TABLE 19: THE OUTPUT CONVERSIONS TABLE (DCS=GSM 7-BIT AND AT+CSCS='IRA') .................... 225 TABLE 20: GSM EXTENDED CHARACTERS (ISO-8859-1/UNICODE) ........................................................ 226 TABLE 21: RELEASE CAUSE TEXT LIST OF AT+CEER .............................................................................. 227 EM12&EG12&EG18_AT_Commands_Manual 9 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 1 Introduction 1.1. Scope of the Document This document presents the AT command set supported by Quectel LTE-A modules EM12, EG12 and EG18. 1.2. AT Command Syntax The 'AT' or 'at' prefix must be set at the beginning of each command line. To terminate a command line, should be entered. Commands are usually followed by a response that includes ''. Throughout this document, only the responses are presented, '' are omitted intentionally. The AT commands set supported by EM12/EG12/EG18 is a combination of international standards, such as 3GPP TS 27.007, 3GPP TS 27.005 and ITU-T recommendation V.25ter as well as the AT Commands developed by Quectel. All these AT commands can be split into three categories syntactically: 'Basic Syntax', 'S Parameter Syntax', and 'Extended Syntax'. They are listed as follows:  Basic Syntax These AT commands are in the format of 'AT', or 'AT&', in which '' is the command, and '' is/are the argument(s) for that command. An example of this is 'ATE', which tells the DCE whether received characters should be echoed back to the DTE according to the value of ''. '' is optional and the default value will be used if it is null.  S Parameter Syntax These AT commands are in the format of 'ATS=', in which '' is the index of the S register to set, and '' is the value to assign to it.  Extended Syntax The types of these AT commands and the corresponding responses are shown in the following table. EM12&EG12&EG18_AT_Commands_Manual 9 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Table 1: Types of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? AT+? The command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. The command returns the currently set value of the parameter or parameters. AT+= The command sets the user-definable parameter values. AT+ The command reads non-variable parameters affected by internal processes in the UE. 1.3. Supported Character Sets The AT command interface of EM12/EG12/EG18 uses the GSM character set by default and supports the following character sets:  GSM format  UCS2  IRA The character set can be configured and interrogated by executing the AT+CSCS command (3GPP TS 27.007) and it is defined in 3GPP TS 27.005. The character set affects transmission and reception of SMS and SMS Cell Broadcast Messages, as well as the entry and display of phone book entries text field. 1.4. AT Command Interface The AT command interface includes two USB ports (USB MODEM port and USB AT port) and one main UART port. The main UART port and two USB ports support AT command communication and data transfer. 1.5. Unsolicited Result Code As an Unsolicited Result Code and a report message, URC is not issued as part of the response related to an executed AT command. URC is a report message issued by the EM12/EG12/EG18 without being requested by the TE and it is issued automatically when a certain event occurs. Typical events leading to URCs are incoming calls (RING), received short messages, high/low voltage alarm, high/low temperature alarm, etc. EM12&EG12&EG18_AT_Commands_Manual 10 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 1.6. Turn off Procedure It is recommended to execute AT+QPOWD command to power off the module, as it is the safest and best way. This procedure is realized by letting the module log off from the network and allowing the software to enter a secure and safe data state before disconnecting the power supply. After sending AT+QPOWD, please do not enter any other AT commands. When the command is executed successfully, the module will output message POWERED DOWN and then enter into the power-off state. In order to avoid data loss, it is suggested to wait for 1s to disconnect the power supply after the URC POWERED DOWN is outputted. If POWERED DOWN cannot be received within 65s, the power supply shall be disconnected compulsorily. EM12&EG12&EG18_AT_Commands_Manual 11 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 2 General Commands 2.1. ATI Display MT Identification Information This command is used to deliver an MT identification information text. ATI Display MT Identification Information Execution Command ATI Response TA issues a product information text. Quectel Revision: Maximum Response Time Reference V.25ter OK 300ms Parameter Identifier of device type Identification text of MT firmware version. Example ATI Quectel EM12 Revision: EM12GPAR01A07M4G OK EM12&EG12&EG18_AT_Commands_Manual 12 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 2.2. AT+GMI Request Manufacturer Identification The command returns a manufacturer identification text. It is identical with AT+CGMI command. AT+GMI Request Manufacturer Identification Test Command AT+GMI=? Execution Command AT+GMI Response OK Response TA reports an information text which permits the user to identify the manufacturer. Quectel Maximum Response Time Reference V.25ter OK 300ms 2.3. AT+GMM Request MT Model Identification The command returns an MT model identification text. It is identical with AT+CGMM command. AT+GMM Request MT Model Identification Test Command AT+GMM=? Execution Command AT+GMM Response OK Response TA returns a product model identification text. Maximum Response Time Reference V.25ter OK 300ms Parameter Identifier of device type EM12&EG12&EG18_AT_Commands_Manual 13 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 2.4. AT+GMR Request MT Firmware Revision Identification The command is used to deliver an identification text of MT firmware version. It is identical with AT+CGMR command. AT+GMR Request Firmware Revision Identification Test Command AT+GMR=? Execution Command AT+GMR Response OK Response TA reports one or more lines of information text which permit the user to identify the revision of firmware release. Maximum Response Time Reference V.25ter OK 300ms Parameter Identification text of MT firmware version. Example AT+GMR EM12GPAR01A07M4G OK 2.5. AT+CGMI Request Manufacturer Identification The command returns a manufacturer identification text. It is identical with AT+GMI command. AT+CGMI Request Manufacturer Identification Test Command AT+CGMI=? Execution Command AT+CGMI Response OK Response TA returns a manufacturer identification text. Quectel EM12&EG12&EG18_AT_Commands_Manual 14 / 234 Maximum Response Time Reference 3GPP TS 27.007 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK 300ms 2.6. AT+CGMM Request MT Model Identification The command returns an MT model identification text. It is identical with AT+GMM command. AT+CGMM Request MT Model Identification Test Command AT+CGMM=? Execution Command AT+CGMM Response OK Response MT returns a product model identification text. Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter Identifier of device type 2.7. AT+CGMR Request MT Firmware Revision Identification The command is used to deliver an identification text of MT firmware version. It is identical with AT+GMR command. AT+CGMR Request Firmware Revision Identification Test Command AT+CGMR=? Execution Command AT+CGMR Response OK Response TA returns an identification text of MT firmware version. EM12&EG12&EG18_AT_Commands_Manual 15 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter Identification text of MT firmware version 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) The command requests the International Mobile Equipment Identity (IMEI) number of the ME which permits the user to identify individual ME device. It is identical with AT+CGSN command. AT+GSN Request International Mobile Equipment Identity (IMEI) Test Command AT+GSN=? Execution Command AT+GSN Response OK Response TA reports the IMEI (International Mobile Equipment Identity) number in information text which permits the user to identify the individual ME device. Maximum Response Time Reference V.25ter OK 300ms Parameter IMEI number of the ME NOTE The IMEI is unique to every ME, thus it can be used to identify an ME. EM12&EG12&EG18_AT_Commands_Manual 16 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) The command requests International Mobile Equipment Identity (IMEI) number of the ME. It is identical with AT+GSN command. AT+CGSN Request International Mobile Equipment Identity (IMEI) Test Command AT+CGSN=? Execution Command AT+CGSN Response OK Response Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter IMEI number of the ME NOTE The IMEI is unique to every ME, thus it can be used to identify an ME. 2.10. AT&F Set All Current Parameters to Manufacturer Defaults The command is used to reset AT command settings to the manufacturer default values. AT&F Set All Current Parameters to Manufacturer Defaults Execution Command AT&F[] Response TA sets all current parameters to the manufacturer defined profile. See Table 7. OK Maximum Response Time 300ms Reference V.25ter EM12&EG12&EG18_AT_Commands_Manual 17 / 234 Parameter 0 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Set all current parameters to manufacturer defaults 2.11. AT&V Display Current Configuration The command is used to display the current settings of several AT command parameters, even including the single-letter AT command parameters which are not readable. AT&V Display Current Configuration Execution Command AT&V Response TA returns the current parameter settings. See Table 2. OK Maximum Response Time 300ms Reference V.25ter Table 2: AT&V Response AT&V &C: 1 &D: 2 &F: 0 &W: 0 E: 1 Q: 0 V: 1 X: 4 Z: 0 S0: 0 S3: 13 S4: 10 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 OK EM12&EG12&EG18_AT_Commands_Manual 18 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 2.12. AT&W Store Current Parameters to User Defined Profile The command stores the current AT command settings to a user defined profile in non-volatile memory. The AT command settings will be automatically restored from the user defined profile during power-up or if ATZ is executed. AT&W Store Current Parameters to User Defined Profile Execution Command AT&W[] Response TA stores the current parameter settings in the user defined profile. See Table 8. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 Profile number to store current parameters 2.13. ATZ Restore All AT Command Settings from User Defined Profile The command first resets the AT command settings to their manufacturer defaults, similar to AT&F. Afterwards the AT command settings are restored from the user defined profile in non-volatile memory, if they have been stored with AT&W before. Any additional AT command on the same command line may be ignored. ATZ Restore AT Command Settings from a User Defined Profile Execution Command ATZ[] Response TA restores the AT command settings from the user defined profile. See Table 9. OK Maximum Response Time 300ms Reference V.25ter EM12&EG12&EG18_AT_Commands_Manual 19 / 234 Parameter 0 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Reset to profile number 0 2.14. ATQ Set Result Code Presentation Mode The command is used to control whether the result code is transmitted to the TE. Other information text transmitted as response is not affected. ATQ Set Result Code Presentation Mode Execution Command ATQ Response This parameter setting determines whether TA transmits any result code to TE or not. Information text transmitted in response is not affected by this setting. If =0: OK Maximum Response Time Reference V.25ter If =1: (none) 300ms Parameter 0 1 TA transmits result code Result codes are suppressed and not transmitted 2.15. ATV MT Response Format The command determines the contents of header and trailer transmitted with AT command result codes and information responses. The numeric equivalents and brief descriptions of results code are listed in the following Table 3. ATV MT Response Format Execution Command ATV Response This parameter setting determines the contents of the header EM12&EG12&EG18_AT_Commands_Manual 20 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time Reference V.25ter and trailer transmitted with result codes and information responses. When =0 0 When =1 OK 300ms Parameter 0 1 Information response: Short result code format: Information response: Long result code format: Example ATV1 OK AT+CSQ +CSQ: 30,99 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //Set =1 //When =1, the result code is OK. //Set =0 //When =0, the result code is 0. Table 3: The Numeric Equivalents and Brief Description of ATV0&ATV1 Result Codes ATV1 OK CONNECT RING ATV0 0 1 2 Description Acknowledges execution of a command A connection has been established. The DCE is switching from command mode to data mode. The DCE has detected an incoming call signal from network EM12&EG12&EG18_AT_Commands_Manual 21 / 234 NO CARRIER 3 ERROR 4 NO DIALTONE 6 BUSY 7 NO ANSWER 8 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual The connection has been terminated or the attempt to establish a connection failed. Command not recognized, caused by command line maximum length exceeded, parameter value invalid, or other problem with processing the command line. No dial tone detected Engaged (busy) signal detected '@' (Wait for Quiet Answer) dial modifier was used, but remote ringing followed by five seconds of silence was not detected before expiration of the connection timer (S7) 2.16. ATE Set Command Echo Mode The command is used to control whether TA echoes characters received from TE or not during AT command mode. ATE Set Command Echo Mode Execution Command ATE Maximum Response Time Reference V.25ter Response This setting determines whether TA echoes characters received from TE or not during command mode. OK 300ms Parameter 0 1 Echo mode OFF Echo mode ON 2.17. A/ Repeat Previous Command Line The command is used to repeat previous AT command line, and '/' acts as the line termination character. EM12&EG12&EG18_AT_Commands_Manual 22 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual A/ Repeat Previous Command Line Execution Command A/ Reference V.25ter Response Repeat the previous command Example ATI Quectel EM12 Revision: EM12GPAR01A07M4G OK A/ Quectel EM12 Revision: EM12GPAR01A07M4G OK //Repeat the previous command. 2.18. ATS3 Set Command Line Termination Character The command determines the character recognized by TA to terminate an incoming command line. It is also generated for result codes and information text, along with character value set via ATS4. ATS3 Set Command Line Termination Character Read Command ATS3? Response Write Command ATS3= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the character recognized by TA to terminate an incoming command line. TA also returns this character in output. OK 300ms EM12&EG12&EG18_AT_Commands_Manual 23 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter 0-13-127 Command line termination character (Default 13=) 2.19. ATS4 Set Response Formatting Character The command determines the character generated by TA for result code and information text, along with the command line termination character set via ATS3. ATS4 Set Response Formatting Character Read Command ATS4? Response Write Command ATS4= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the character generated by TA for result code and information text. OK 300ms Parameter 0-10-127 Response formatting character (Default 10=) 2.20. ATS5 Set Command Line Editing Character The command is used to determine the value of editing character used by TA to delete the immediately preceding character from the AT command line (i.e. equates to backspace key). ATS5 Set Command Line Editing Character Read Command ATS5? Response OK EM12&EG12&EG18_AT_Commands_Manual 24 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Write Command ATS5= Maximum Response Time Reference V.25ter Response This parameter setting determines the character recognized by TA as a request to delete the immediately preceding character from the command line. OK 300ms Parameter 0-8-127 Response editing character (Default 8=) 2.21. ATX Set CONNECT Result Code Format and Monitor Call Progress The command is used to determine whether TA transmits particular result codes to TE or not. It also controls whether TA detects the presence of a dial tone when it begins dialing and the engaged tone (busy signal) or not. ATX Set CONNECT Result Code Format and Monitor Call Progress Execution Command ATX Response This parameter setting determines whether TA detects the presence of dial tone and busy signal or not and whether TA transmits particular result codes or not. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 1 2 CONNECT result code only returned, dial tone and busy detection are both disabled CONNECT result code only returned, dial tone and busy detection are both disabled CONNECT result code returned, dial tone detection is enabled, busy detection is disabled EM12&EG12&EG18_AT_Commands_Manual 25 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 3 CONNECT result code returned, dial tone detection is disabled, busy detection is enabled 4 CONNECT result code returned, dial tone and busy detection are both enabled 2.22. AT+CFUN Set UE Functionality The command is used to control the functionality level. It can also be used to reset the UE. AT+CFUN Set UE Functionality Test Command AT+CFUN=? Response +CFUN: (list of supported s),(list of supported s) Read Command AT+CFUN? OK Response +CFUN: Write Command AT+CFUN=[,] OK Response OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality, response: +CME ERROR: 15s, determined by the network. Parameter 0 1 4 0 1 Minimum functionality Full functionality Disable UE from both transmitting and receiving RF signals Do not reset UE before setting it to power level Default value when is not given Reset UE. The device is fully functional after the reset. This value is available only for =1 EM12&EG12&EG18_AT_Commands_Manual 26 / 234 Example AT+CFUN=0 OK AT+COPS? +COPS: 0 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN=1234 OK +CPIN: READY +QUSIM: 1 +QIND: PB DONE +QIND: SMS DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE CMCC',7 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Switch UE to minimum functionality. //No operator is registered. //(U)SIM failure //Switch UE to full functionality. //Operator is registered. 2.23. AT+CMEE Error Message Format The command is used to control the format of error result codes: ERROR, error numbers or verbose messages as +CME ERROR: . AT+CMEE Error Message Format Test Command AT+CMEE=? Response +CMEE: (list of supported s) EM12&EG12&EG18_AT_Commands_Manual 27 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Read Command AT+CMEE? Write Command AT+CMEE= Maximum Response Time Reference 3GPP TS 27.007 OK Response +CMEE: OK Response TA disables or enables the use of result code +CME ERROR: as an indication of an error related to the functionality of the MT. OK 300ms Parameter 0 1 2 Disable result code Enable result code and use numeric values Enable result code and use verbose values Example AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted //Disable result code. //Only ERROR will be displayed. //Enable error result code with numeric values. //Enable error result code with verbose (string) values. 2.24. AT+CSCS Select TE Character Set The Write Command informs the MT which character set is used by the TE. This enables the MT to convert character strings correctly between TE and MT character sets. EM12&EG12&EG18_AT_Commands_Manual 28 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+CSCS Select TE Character Set Test Command AT+CSCS=? Response +CSCS: (list of supported s) Read Command AT+CSCS? OK Response +CSCS: Write Command AT+CSCS= Maximum Response Time Reference 3GPP TS 27.007 OK Response Set character set which is used by the TE. Then the MT can convert character strings correctly between the TE and MT character sets. OK 300ms Parameter 'GSM' 'IRA' 'UCS2' GSM default alphabet International reference alphabet UCS2 alphabet Example AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //Query the current character set. //Set the character set to 'UCS2'. 2.25. AT+QURCCFG Configure URC Indication Option The command is used to configure the output port of URC. EM12&EG12&EG18_AT_Commands_Manual 29 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QURCCFG Configure URC Indication Option Test Command AT+QURCCFG=? Response +QURCCFG: 'urcport',('usbat','usbmodem','uart1','all') Write Command AT+QURCCFG='urcport'[,] OK If the configuration parameter is omitted, return the current configuration: +QURCCFG: 'urcport', OK Maximum Response Time If the configuration parameter is not omitted, response: OK Or ERROR 300ms Parameter Set URC output port 'usbat' 'usbmodem' 'uart1' 'all' USB AT port USB modem port Main UART All port NOTES 1. Configuration of URC output port will be saved to NVM immediately by default. 2. After configuration of URC output port is set successfully, it will take effect immediately. Example AT+QURCCFG=? +QURCCFG: 'urcport',('usbat','usbmodem','uart1','all') OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbat' OK AT+QURCCFG='urcport','usbmodem' EM12&EG12&EG18_AT_Commands_Manual 30 / 234 OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 31 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 3 Status Control Commands 3.1. AT+CPAS Mobile Equipment Activity Status The command is used to query the activity status of MT. AT+CPAS Mobile Equipment Activity Status Test Command AT+CPAS=? Response +CPAS: (list of supported s) Execution Command AT+CPAS OK Response TA returns the activity status of MT: +CPAS: OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter 0 3 4 Ready Ringing Call in progress or call hold EM12&EG12&EG18_AT_Commands_Manual 31 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Example AT+CPAS +CPAS: 0 OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10010',129 OK AT+CPAS +CPAS: 4 OK //MT is idle. //MT is ringing. //Call in progress. 3.2. AT+CEER Extended Error Report The command is used to query an extended error and report the cause of the last failed operation, such as:  The failure to release a call  The failure to set up a call (both mobile originated or terminated)  The failure to modify a call by using supplementary services  The failure to activate, register, query, deactivate or deregister a supplementary service The release cause is a text to describe the cause information given by the network. AT+CEER Extended Error Report Test Command AT+CEER=? Execution Command AT+CEER Response OK Response +CEER: EM12&EG12&EG18_AT_Commands_Manual 32 / 234 Maximum Response Time LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK Or ERROR If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Release cause text. Reason for the last call failure to setup or release (listed in Chapter 13.9). Both CS and PS domain call types are reported. Cause data is captured from Call Manager events and cached locally to later use by this command. 3.3. AT+QCFG Extended Configuration Settings The command is used to query and configure various settings of UE. AT+QCFG Extended Configuration Settings Test Command AT+QCFG=? Response +QCFG: 'gprsattach',(list of supported s) +QCFG: 'nwscanmode',(list of supported s),(list of supported s) +QCFG: 'roamservice',(list of supported s), (list of supported s) +QCFG: 'servicedomain',(list of supported s), (list of supported s) +QCFG: 'band',(list of supported s),(list of supported s),(list of supported s) +QCFG: 'hsdpacat',(list of supported s) +QCFG: 'hsupacat',(list of supported s) +QCFG: 'rrc',(list of supported s) +QCFG: 'sgsn',(list of supported s) +QCFG: 'msc',(list of supported s) +QCFG: 'pdp/duplicatechk',(list of supported s) +QCFG: 'tdscsq',(list of supported s) +QCFG: 'urc/ri/ring',(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) EM12&EG12&EG18_AT_Commands_Manual 33 / 234 Maximum Response Time Reference LTE-A Module Series EM12&EG12&EG18 AT Commands Manual +QCFG: 'urc/ri/smsincoming',(list of supported s),(list of supported s) +QCFG: 'urc/ri/other',(list of supported s), (list of supported s) +QCFG: 'risignaltype',(list of supported s) +QCFG: 'urc/cache',(list of supported s) OK 300ms 3.3.1. AT+QCFG='nwscanmode' Network Search Mode Configuration The command is used to specify the network search mode. If is omitted, the configuration will take effect immediately. AT+QCFG='nwscanmode' Network Search Mode Configuration Write Command AT+QCFG='nwscanmode'[,[,]] Response If and are both omitted, return the current configuration: +QCFG: 'nwscanmode', OK If and are not omitted, set the network search mode: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Network search mode 0 Automatic 2 WCDMA only 3 LTE only When to take effect 0 Take effect after UE reboots EM12&EG12&EG18_AT_Commands_Manual 34 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 1 Take effect immediately 3.3.2. AT+QCFG='roamservice' Roam Service Configuration The command is used to enable or disable the roam service. The configuration will take effect immediately. AT+QCFG='roamservice' Roam Service Configuration Write Command Response AT+QCFG='roamservice'[,<roammod If is omitted, return the current configuration: e>] +QCFG: 'roamservice', OK If is not omitted, configure the mode of roam service: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms Parameter The mode of roam service 1 Disable roam service 2 Enable roam service 3.3.3. AT+QCFG='servicedomain' Service Domain Configuration The command is used to specify the registered service domain. If is omitted, the configuration will take effect immediately. AT+QCFG='servicedomain' Service Domain Configuration Write Command AT+QCFG='servicedomain'[,[,]] Response If and are both omitted, return the current configuration: +QCFG: 'servicedomain', OK EM12&EG12&EG18_AT_Commands_Manual 35 / 234 Maximum Response Time LTE-A Module Series EM12&EG12&EG18 AT Commands Manual If and are not omitted, the service domain of UE can be set: OK Or ERROR If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Service domain of UE 0 CS only 1 PS only 2 CS & PS When to take effect 0 Take effect after UE reboots 1 Take effect immediately 3.3.4. AT+QCFG='band' Band Configuration The command is used to specify the preferred frequency bands to be searched by UE. If is omitted, the configuration will take effect immediately. AT+QCFG='band' Band Configuration Write Command AT+QCFG='band'[,,,[,]] Response If configuration parameters are omitted (that is, only execute AT+QCFG='band'), return current configuration: +QCFG: 'band',,, OK If configuration parameters are all entered, the preferred frequency bands to be searched can be set: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 36 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter A hexadecimal value that specifies the WCDMA frequency band. If set to 0, it means not to change the WCDMA frequency band. 00000000 No change 00000010 WCDMA 2100 B1 00000020 WCDMA 1900 B2 00000040 WCDMA 850 B5 00000080 WCDMA 900 B8 00000200 WCDMA 1700 B4 00000800 WCDMA 1800 B3 00001000 WCDMA Japan 850 B19 00004000 WCDMA Japan 1700 B9 0000FFFF Any frequency band A hexadecimal value that specifies the LTE frequency band. If it is set to 0 or 0x40000000, it means not to change LTE frequency band. (eg.: 0x15=0x1(LTE B1)+0x4(LTE B3)+0x10(LTE B5)) 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x2 (CM_BAND_PREF_LTE_EUTRAN_BAND2) LTE B2 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x8 (CM_BAND_PREF_LTE_EUTRAN_BAND4) LTE B4 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x20 (CM_BAND_PREF_LTE_EUTRAN_BAND6) LTE B6 0x40 (CM_BAND_PREF_LTE_EUTRAN_BAND7) LTE B7 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 … 0x80000(CM_BAND_PREF_LTE_EUTRAN_BAND20) LTE B20 0x7FFFFFFFFFFFFFFF(CM_BAND_PREF_ANY) Any frequency band When to take effect 0 Take effect after UE reboots 1 Take effect immediately Not supported. The default value is 0. 3.3.5. AT+QCFG='hsdpacat' HSDPA Category Configuration The command is used to specify the HSDPA category. This configuration is valid only after MT is restarted. AT+QCFG='hsdpacat' HSDPA Category Configuration Write Command AT+QCFG='hsdpacat'[,] Response If is omitted, return the current configuration: +QCFG: 'hsdpacat', OK EM12&EG12&EG18_AT_Commands_Manual 37 / 234 Maximum Response Time LTE-A Module Series EM12&EG12&EG18 AT Commands Manual If is not omitted, the HSDPA category can be set: OK Or ERROR If there is any error related to MT functionality: +CME ERROR: 300ms Parameter HSDPA category 6 Category 6 8 Category 8 10 Category 10 12 Category 12 14 Category 14 18 Category 18 20 Category 20 24 Category 24 3.3.6. AT+QCFG='hsupacat' HSUPA Category Configuration The command is used to specify the HSUPA category. This configuration is valid only after MT is restarted. AT+QCFG='hsupacat' HSUPA Category Configuration Write Command AT+QCFG='hsupacat'[,] Response If is omitted, return the current configuration: +QCFG: 'hsupacat', OK If is not omitted, the HSUPA category can be set: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 38 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter HSUPA category 5 Category 5 6 Category 6 7 Category 7 8 Category 8 3.3.7. AT+QCFG='rrc' RRC Release Version Configuration The command is used to specify the RRC release version. This configuration is valid only after MT is restarted. AT+QCFG='rrc' RRC Release Version Configuration Write Command AT+QCFG='rrc'[,] Response If is omitted, return the current configuration: +QCFG: 'rrc', OK If is not omitted, the RRC release version can be set: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms Parameter RRC release version 0 R99 1 R5 2 R6 3 R7 4 R8 5 R9 3.3.8. AT+QCFG='sgsn' UE SGSN Release Version Configuration The command is used to specify the UE SGSN release version. This configuration is valid only after MT is restarted. EM12&EG12&EG18_AT_Commands_Manual 39 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QCFG='sgsn' UE SGSN Release Version Configuration Write Command AT+QCFG='sgsn'[,] Response If is omitted, return the current configuration: +QCFG: 'sgsn', OK If is not omitted, configure the SGSN release version: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms Parameter SGSN release version 0 R97 1 R99 2 Dynamic 3.3.9. AT+QCFG='msc' UE MSC Release Version Configuration The command is used to specify the UE MSC release version. This configuration is valid only after MT is restarted. AT+QCFG='msc' UE MSC Release Version Configuration Write Command AT+QCFG='msc'[,] Response If is omitted, return the current configuration: +QCFG: 'msc', OK If is not omitted, the MSC release version can be set: OK Or ERROR EM12&EG12&EG18_AT_Commands_Manual 40 / 234 Maximum Response Time LTE-A Module Series EM12&EG12&EG18 AT Commands Manual If there is an error related to MT functionality: +CME ERROR: 300ms Parameter MSC release version 0 R97 1 R99 2 Dynamic 3.3.10. AT+QCFG='pdp/duplicatechk' Establish Multi PDNs with the Same APN The command is used to allow/refuse establishing multi PDNs with the same APN profile. The configuration will take effect immediately. AT+QCFG='PDP/duplicatechk' Establish Multi PDNs with the Same APN Write Command Response AT+QCFG='pdp/duplicatechk'[,<enabl If is omitted, return the current configuration: e>] +QCFG: 'pdp/duplicatechk', OK If is not omitted, allow/refuse establishing multiple PDNs with the same APN profile: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms Parameter 0 1 Refuse to establish multi PDNs with the same APN profile Allow to establish multi PDNs with the same APN profile 3.3.11. AT+QCFG='risignaltype' RI Signal Output Carrier The command is used to specify the RI (ring indicator) signal output carrier. EM12&EG12&EG18_AT_Commands_Manual 41 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QCFG='risignaltype' RI Signal Output Carrier Write Command Response AT+QCFG='risignaltype'[,<risignatyp If is omitted, return the current configuration: e>] +QCFG: 'risignaltype', OK If is not omitted, the RI signal output carrier can be set: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms Parameter RI signal output carrier. 'respective' The ring indicator behaves on the port where URC is presented. For example, if a URC is presented on UART port, it is physical ring indicator. If URC is presented on USB port, it is virtual ring indicator. If URC is presented on USB AT port which does not support ring indicator, then there will be no ring indicator. AT+QURCCFG='urcport' can get the port on which URC is presented. 'physical' No matter which port URC is presented on, URC only causes the behavior of physical ring indicator. 3.3.12. AT+QCFG='urc/delay' Delay URC Indication The command is used to delay the output of URC indication until ring indicator pulse ends. AT+QCFG='urc/delay' Delay URC Indication Write Command AT+QCFG='urc/delay'[,] Response If is omitted, return the current configuration: +QCFG: 'urc/delay', OK EM12&EG12&EG18_AT_Commands_Manual 42 / 234 Maximum Response Time LTE-A Module Series EM12&EG12&EG18 AT Commands Manual If is not omitted, set when the URC indication will be outputted: OK Or ERROR If there is any error related to MT functionality: +CME ERROR: 300ms Parameter 0 1 URC indication will be output when ring indicator pulse starts. URC indication will be output when ring indicator pulse ends (only effective when the type of ring indicator is 'pulse'. 3.3.13. AT+QCFG='tone/incoming' Enable/Disable Ringing Tone The command is used to enable/disable the ringing tone. AT+ QCFG='tone/incoming' Enable/Disable Ringing Tone Write Command AT+QCFG='tone/incoming'[, ] Response If is omitted, return the current configuration: +QCFG: 'tone/incoming', OK If is not omitted, enable/disable ring tone function: OK Or ERROR If there is any error related to MT functionality: +CME ERROR: Parameter 0 Disable ring tone 1 Enable local ring tone 2 Enable ring tone EM12&EG12&EG18_AT_Commands_Manual 43 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 3.3.14. AT+QCFG='sarcfg' Set SAR Power Backoff Value for LTE/WCDMA Bands AT+QCFG='sarcfg' Set SAR Power Backoff Value for LTE/WCDMA Bands Write Command AT+QCFG='sarcfg',[,,[,]] Response If , and are omitted, return the current configuration: [+QCFG: 'sarcfg','lte_wcdma',,,] […] OK Maximum Response Time If , and are not omitted, set the SAR power backoff value: OK Or ERROR 300ms Parameter The SAR power backoff value for supported LTE/WCDMA bands. 'LTE_WCDMA' Set/get configuration for all supported LTE&WCDMA bands. 'LTE' Set/get configuration for all supported LTE bands. 'WCDMA' Set/get configuration for all supported WCDMA bands. The value of SAR power backoff [level1]. The value ranges from 60 to 300 (i.e. 6dBm-30dBm). And the default value is 230 (23dBm). The reduced value for each grade. The default value is 10 (1dBm). backoff[leveln] = backoff[leveln-1] - The [leveln] ranges from 2 to 8. WCDMA: 1 WCDMA B1 WCDMA2100 2 WCDMA B2 WCDMA1900 3 WCDMA B3 WCDMA1700s 4 WCDMA B4 WCDMA1700 5 WCDMA B5 WCDMA850 8 WCDMA B8 WCDMA900 9 WCDMA B9 WCDMA1700 11 WCDMA B11 WCDMA1500 19 WCDMA B19 WCDMA850 LTE: 1 LTE B1 2 LTE B2 EM12&EG12&EG18_AT_Commands_Manual 44 / 234 3 LTE B3 4 LTE B4 5 LTE B5 6 LTE B6 7 LTE B7 8 LTE B8 9 LTE B9 10 LTE B10 11 LTE B11 12 LTE B12 13 LTE B13 14 LTE B14 17 LTE B17 18 LTE B18 19 LTE B19 20 LTE B20 21 LTE B21 23 LTE B23 25 LTE B25 26 LTE B26 27 LTE B27 28 LTE B28 30 LTE B30 34 LTE B34 38 LTE B38 39 LTE B39 40 LTE B40 41 LTE B41 42 LTE B42 43 LTE B43 46 LTE B46 47 LTE B47 48 LTE B48 66 LTE B66 71 LTE B71 250 LTE B250 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual NOTES 1. This command will take effect after module reboot. 2. When backoff[leveln-1] - < 0, the backoff[leveln] equals backoff[leveln-1]. And must be smaller than . 3. The setting is effective to all channels of each supported band. 4. Once the AT+QCFG='sarcfg' is executed, the SAR power takeoff will take effect when DPR is at EM12&EG12&EG18_AT_Commands_Manual 45 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual low level. 5. For detailed bands of each module supported, please refer to corresponding product specifications. 3.3.15. AT+QCFG='gpsdrx' Configure GNSS Antenna Connection Mode The command is used to configure GNSS antenna connection mode. AT+QCFG='gpsdrx' Configure GNSS Antenna Connection Mode Query Command AT+QCFG='gpsdrx' Response +QCFG: 'gpsdrx', Write Command AT+QCFG='gpsdrx', OK Response OK or ERROR Parameter GNSS antenna connection mode. 0 GNSS antenna uses the dedicated GNSS connector. 1 GNSS antenna and DIV antenna share the DIV&GNSS connector. NOTES 1. This command takes effect immediately. 2. This command is only supported by EM12 module. 3.4. AT+QINDCFG URC Indication Configuration The command is used to control URC indication. AT+QINDCFG URC Indication Configuration Test Command AT+QINDCFG=? Response +QINDCFG: 'all',(0,1),(0,1) +QINDCFG: 'csq',(0,1),(0,1) +QINDCFG: 'smsfull',(0,1),(0,1) +QINDCFG: 'ring',(0,1),(0,1) +QINDCFG: 'smsincoming',(0,1),(0,1) +QINDCFG: 'act',(0,1),(0,1) EM12&EG12&EG18_AT_Commands_Manual 46 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK Write Command AT+QINDCFG=[,[,< savetonvram>]] Response If and are omitted, the current configuration will be returned: +QINDCFG: , OK If and are not omitted, set the URC indication configurations: OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms Parameter URC type 'all' 'csq' 'smsfull' 'ring' 'smsincoming' 'act' Master switch of all URCs. Default is ON. Indication of signal strength and channel bit error rate change (similar to AT+CSQ). Default is OFF. If this configuration is ON, present: +QIND: 'csq',, SMS storage full indication. Default is OFF. If this configuration is ON, present: +QIND: 'smsfull', RING indication. Default is ON. Incoming message indication. Default is ON. Related URCs list: +CMTI, +CMT, +CDS Indication of network access technology change. Default is OFF. If this configuration is ON, present: +QIND: 'act', is string type. The values are as below: 'WCDMA' 'HSDPA' 'HSUPA' 'HSDPA&HSUPA' 'LTE' EM12&EG12&EG18_AT_Commands_Manual 47 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 'UNKNOWN' The examples of URC are as below: +QIND: 'act','HSDPA&HSUPA' +QIND: 'act','UNKNOWN' The description of 'act' is as below: 1. If MT does not register on network, the would be 'UNKNOWN'. 2. If this configuration is ON, the URC of 'act' will be reported immediately. Only when the network access technology changes, a new URC will be reported. URC indication is ON or OFF 0 OFF 1 ON Whether to save configuration into NVM. 0 Not save 1 Save EM12&EG12&EG18_AT_Commands_Manual 48 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 4 (U)SIM Related Commands 4.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) The command is used to request the International Mobile Subscriber Identity (IMSI) which is intended to permit the TE to identify the individual SIM card or active application in the UICC (GSM or USIM) that is attached to MT. AT+CIMI Request International Mobile Subscriber Identity (IMSI) Test Command AT+CIMI=? Response OK Execution Command AT+CIMI Response TA returns for identifying the individual (U)SIM which is attached to MT. OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter International Mobile Subscriber Identity (string without double quotes) Example AT+CIMI 460023210226023 OK //Query IMSI number of (U)SIM which is attached to MT. EM12&EG12&EG18_AT_Commands_Manual 49 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 4.2. AT+CLCK Facility Lock The command is used to lock/unlock or interrogate an MT or a network facility . It can be aborted when network facilities are being set or interrogated. The factory default password of PF, PN, PU, PP and PC lock is '12341234'. AT+CLCK Facility Lock Test Command AT+CLCK=? Response +CLCK: (list of supported s) OK Write Command Response AT+CLCK=,[, The command is used to lock, unlock or interrogate the MT or [,]] network facility . Password is normally needed to do such actions. When querying the status of network service (=2) the response line for ‘not active’ case (=0) should be returned only if service is not active for any . If is not equal to 2 and command is set successful: OK If =2 and the command is set successful: +CLCK: [,] […] OK Maximum Response Time 5s Reference 3GPP TS 27.007 Parameter 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' (U)SIM (lock SIM/UICC card inserted in the currently selected card slot) (SIM/UICC asks password in MT power-up and when this lock command is issued). BAOC (Bar All Outgoing Calls) (refer to 3GPP TS 22.088). BOIC (Bar Outgoing International Calls) (refer to 3GPP TS 22.088). BOIC-exHC (Bar Outgoing International Calls except to Home Country) (refer to 3GPP TS 22.088). BAIC (Bar All Incoming Calls) (refer to 3GPP TS 22.088). BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (refer EM12&EG12&EG18_AT_Commands_Manual 50 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual to 3GPP TS 22.088). 'AB' All Barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'AG' All outgoing barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'AC' All incoming barring services (refer to 3GPP TS 22.030) (applicable only for =0). 'FD' SIM card or active application in the UICC (GSM or USIM) fixed dialing memory feature (if PIN2 authentication has not been done during the current session, PIN2 is required as ). 'PF' Lock Phone to the very first inserted SIM/UICC card (also referred in the present document as PH-FSIM) (MT asks password when other SIM/UICC cards are inserted). 'PN' Network Personalization (refer to 3GPP TS 22.022) 'PU' Network Subset Personalization (refer to 3GPP TS 22.022) 'PP' Service Provider Personalization (refer to 3GPP TS 22.022) 'PC' Corporate Personalization (refer to 3GPP TS 22.022) 0 Unlock 1 Lock 2 Query status Password 1 Voice 2 Data 4 FAX 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization 0 OFF 1 ON Example AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK //Query the status of (U)SIM card. //The (U)SIM card is unlocked (OFF). //Lock (U)SIM card, and the password is 1234. //Query the status of (U)SIM card. //The (U)SIM card is locked (ON). //Unlock (U)SIM card. EM12&EG12&EG18_AT_Commands_Manual 51 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 4.3. AT+CPIN Enter PIN The command is used to enter a password or query whether MT requires a password or not before it can be operated. The password may be (U)SIM PIN, (U)SIM PUK, PH-SIM PIN, etc. AT+CPIN Enter PIN Test Command AT+CPIN=? Read Command AT+CPIN? Response OK Response MT returns an alphanumeric string indicating whether or not a password is required. +CPIN: OK Write Command AT+CPIN=[,] If there is any error related to MT functionality: +CME ERROR: Response MT stores a password, such as (U)SIM PIN, (U)SIM PUK, which is necessary before it can be operated. If the PIN is to be entered twice, the MT shall automatically repeat the PIN. If no PIN request is pending, no action will be taken and an error message +CME ERROR is returned to TE. Maximum Response Time Reference 3GPP TS 27.007 If the PIN required is (U)SIM PUK or (U)SIM PUK2, the second parameter is required. This second PIN , is used to replace the old pin in the (U)SIM. OK 5s Parameter READY SIM PIN SIM PUK SIM PIN2 SIM PUK2 PH-NET PIN PH-NET PUK MT is not pending for any password MT is waiting for (U)SIM PIN to be given MT is waiting for (U)SIM PUK to be given MT is waiting for (U)SIM PIN2 to be given MT is waiting for (U)SIM PUK2 to be given MT is waiting for network personalization password to be given MT is waiting for network personalization unlocking password to be given EM12&EG12&EG18_AT_Commands_Manual 52 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual PH-NETSUB PIN MT is waiting for network subset personalization password to be given PH-NETSUB PUK MT is waiting for network subset personalization unlocking password to be given PH-SP PIN MT is waiting for service provider personalization password to be given PH-SP PUK MT is waiting for service provider personalization unlocking password to be given PH-CORP PIN MT is waiting for corporate personalization password to be given PH-CORP PUK MT is waiting for corporate personalization unlocking password to be given Password. If the requested password was a PUK, such as (U)SIM PUK1, PH-FSIM PUK or another password, then must be followed by . New password required if the requested code was a PUK. Example //Enter PIN AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Enter PUK and PIN AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Waiting SIM PIN to be given. //Enter PIN. //PIN has already been entered. //Waiting SIM PIN to be given. //Enter PUK and the new password. //PUK has already been entered. EM12&EG12&EG18_AT_Commands_Manual 53 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 4.4. AT+CPWD Change Password The command is used to set a new password for the facility lock function defined by AT+CLCK. AT+CPWD Change Password Test Command AT+CPWD=? Response MT returns a list of pairs which present the available facilities and the maximum length of their password. +CPWD: (list of supported s),(s) Write Command AT+CPWD=,, OK Response MT sets a new password for the facility lock function. OK Maximum Response Time 5s Reference 3GPP TS 27.007 Parameter 'SC' (U)SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command is issued) 'AO' BAOC (Bar All Outgoing Calls, refer to 3GPP TS 22.088) 'OI' BOIC (Bar Outgoing International Calls, refer to 3GPP TS 22.088) 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country, refer to 3GPP TS 22.088) 'AI' BAIC (Bar All Incoming Calls, refer to 3GPP TS 22.088) 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country, refer to 3GPP TS 22.088) 'AB' All barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AG' All outgoing barring services (refer to 3GPP TS 22.030, applicable only for =0) 'AC All incoming barring services (refer to 3GPP TS 22.030, applicable only for =0) 'P2' (U)SIM PIN2 Maximum length of password Password specified for the facility from the user interface or with command. New password EM12&EG12&EG18_AT_Commands_Manual 54 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Example AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' OK //Change (U)SIM card password to '4321'. //Restart MT or re-activate the (U)SIM card AT+CPIN? +CPIN: SIM PIN //Waiting SIM PIN to be given. OK AT+CPIN='4321' OK //PIN must be entered to define a new password '4321'. +CPIN: READY 4.5. AT+CSIM Generic (U)SIM Access The command is used to allow a direct control of the (U)SIM that is inserted in the currently selected card slot by a distant application on TE. TE should then keep the processing of (U)SIM information within the frame specified by GSM/UMTS. AT+CSIM Generic (U)SIM Access Test Command AT+CSIM=? Write Command AT+CSIM=, Response OK Response +CSIM: , OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 55 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter Length of or string. Command transferred by the MT to the (U)SIM in the format as described in 3GPP TS 51.011. Response to the command transferred by the (U)SIM to the MT in the format as described in 3GPP TS 51.011. 4.6. AT+CRSM Restricted (U)SIM Access The command is used to offer easy and limited access to the (U)SIM database. It transmits the (U)SIM command number and its required parameters to MT. AT+CRSM Restricted (U)SIM Access Test Command AT+CRSM=? Write Command AT+CRSM=[,[,,,[,][,]]] Response OK Response +CRSM: ,[,] OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter (U)SIM command number 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS 203 RETRIEVE DATA 219 SET DATA EM12&EG12&EG18_AT_Commands_Manual 56 / 234 , , , LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Identifier for an elementary data file on (U)SIM, if used by . Parameters transferred by the MT to the (U)SIM. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in 3GPP TS 51.011. Information which should be written to the (U)SIM (hexadecimal character format; refer to AT+CSCS). The directory path of an elementary file on a SIM/UICC in hexadecimal format. Information from the (U)SIM about the execution of the actual command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command. Response of a successful completion of the command previously issued (hexadecimal character format; refer to AT+CSCS). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. The information includes the type of file and its size (refer to 3GPP TS 51.011). After READ BINARY, READ RECORD or RETRIEVE DATA command, the requested data will be returned. is not returned after a successful UPDATE BINARY, UPDATE RECORD or SET DATA command. 4.7. AT+QCCID Show ICCID The command returns the ICCID (Integrated Circuit Card Identifier) number of the (U)SIM card. AT+QCCID Show ICCID Test Command AT+QCCID=? Execution Command AT+QCCID Response OK Response +QCCID: Maximum Response Time OK Or ERROR 300ms Parameter ICCID (Integrated Circuit Card Identifier) number of the (U)SIM card EM12&EG12&EG18_AT_Commands_Manual 57 / 234 Example AT+QCCID +QCCID: 89860025128306012474 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Query ICCID of the (U)SIM card. 4.8. AT+QPINC Display PIN Remainder Counter The command is used to query the number of attempts left to enter the password of (U)SIM PIN/PUK. AT+ QPINC Display PIN Remainder Counter Test Command AT+QPINC=? Response +QPINC: ('SC','P2') Read Command AT+QPINC? OK Response +QPINC: 'SC', , +QPINC: 'P2', , Write Command AT+QPINC= OK Response +QPINC: ,, OK Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms Parameter 'SC' (U)SIM PIN 'P2' (U)SIM PIN2 Number of attempts left to enter the password of PIN Number of attempts left to enter the password of PUK EM12&EG12&EG18_AT_Commands_Manual 58 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 4.9. AT+QINISTAT Query Initialization Status of (U)SIM Card The command is used to query the initialization status of (U)SIM card. AT+QINISTAT Query Initialization Status of (U)SIM Card Test Command AT+QINISTAT=? Response +QINISTAT: (0-7) Execution Command AT+QINISTAT OK Response +QINISTAT: Maximum Response Time OK 300ms Parameter Initialization status of (U)SIM card. Actual value is the sum of several of the following four kinds (e.g. 7=1+2+4 means CPIN READY & SMS DONE & PB DONE). 0 Initial state 1 CPIN READY. Operation like locking/unlocking PIN is allowed. 2 SMS initialization completed 4 Phonebook initialization completed 4.10. AT+QSIMDET (U)SIM Card Detection The command is used to enable (U)SIM card hot-swap function. (U)SIM card is detected by GPIO interrupt. The level of (U)SIM card detection pin should also be set when the (U)SIM card is inserted. AT+QSIMDET (U)SIM Card Detection Test Command AT+QSIMDET=? Response +QSIMDET: (0,1),(0,1) Read Command AT+QSIMDET? OK Response +QSIMDET: , Write Command OK Response EM12&EG12&EG18_AT_Commands_Manual 59 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QSIMDET=, OK Or ERROR Maximum Response Time 300ms Parameter Enable or disable (U)SIM card detection 0 Disable 1 Enable The level of (U)SIM detection pin when a (U)SIM card is inserted 0 Low level 1 High level NOTES 1. Hot-swap function is invalid if the configured value of is inconsistent with hardware design. 2. Hot-swap function takes effect after the MT is restarted. Example AT+QSIMDET=1,0 OK +CPIN: NOT READY +CPIN: READY //Set (U)SIM card detection pin level as low when (U)SIM card is inserted. //If PIN1 of the (U)SIM card is unlocked. 4.11. AT+QSIMSTAT (U)SIM Card Insertion Status Report The command is used to query (U)SIM card insertion status or determine whether (U)SIM card insertion status report is enabled. The configuration of this command can be saved by AT&W. EM12&EG12&EG18_AT_Commands_Manual 60 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QSIMSTAT (U)SIM Insertion Status Report Test Command AT+QSIMSTAT=? Response +QSIMSTAT: (0,1) Read Command AT+QSIMSTAT? OK Response +QSIMSTAT: , Write Command AT+QSIMSTAT= Maximum Response Time OK Response OK Or ERROR 300ms Parameter Enable or disable (U)SIM inserted status report. If it is enabled, when (U)SIM card is inserted or removed the URC +QSIMSTAT: , will be reported. 0 Disable 1 Enable (U)SIM card is inserted or removed. This parameter is not allowed to be set. 0 Removed 1 Inserted 2 Unknown, before (U)SIM initialization Example AT+QSIMSTAT? +QSIMSTAT: 0,1 //Query (U)SIM card insertion status. OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 //Enable (U)SIM card insertion status report. OK EM12&EG12&EG18_AT_Commands_Manual 61 / 234 +QSIMSTAT : 1,0 +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK +QSIMSTAT : 1,1 +CPIN: READY LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Report of (U)SIM card insertion status: removed. //Report of (U)SIM card insertion status: inserted. 4.12. AT+QUIMSLOT Switch (U)SIM Slot The command is used to query the slot currently used by the (U)SIM and decide which to use. AT+QUIMSLOT Switch (U)SIM Slot Test Command AT+QUIMSLOT=? Response +QUIMSLOT: (1,2) Read Command AT+QUIMSLOT? OK Response +QUIMSLOT: Write Command AT+QUIMSLOT= Maximum Response Time OK Response OK Or ERROR 300ms Parameter Physical U(SIM) slot 1 (U)SIM slot1 2 (U)SIM slot2 EM12&EG12&EG18_AT_Commands_Manual 62 / 234 Example AT+QUIMSLOT? +QUSIMSLOT: 1 OK AT+QUIMSLOT=2 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Query the (U)SIM slot currently used. //Switch to slot2. EM12&EG12&EG18_AT_Commands_Manual 63 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 5 Network Service Commands 5.1. AT+COPS Operator Selection The command is used to return the current operators and their status, and allow setting automatic or manual network selection. AT+COPS Operator Selection Test Command AT+COPS=? Response MT returns a set of five parameters, each representing an operator presenting in the network. Any of the formats may be unavailable and should then be an empty field. The list of operators shall be in the order of: home network, networks referenced in (U)SIM and other networks. +COPS: (list of supported,long alphanumeric , short alphanumeric ,numeric s[,]) s][,(list of supported s),(list of supported s)] OK Read Command AT+COPS? If there is any error related to MT functionality: +CME ERROR: Response MT returns the current mode and the currently selected operator. If no operator is selected, , and are omitted. +COPS: [,[,][,]] OK Write Command AT+COPS=[,[,[,]]] If there is any error related to MT functionality: +CME ERROR: Response MT forces an attempt to select and register the GSM/UMTS network operator. If the selected operator is not available, no EM12&EG12&EG18_AT_Commands_Manual 64 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 other operator shall be selected (except =4). The format of selected operator name shall apply to further Read Commands (AT+COPS?). OK If there is any error related to MT functionality: +CME ERROR: 180s, determined by the network. Parameter 0 Unknown 1 Operator available 2 Current operator 3 Operator forbidden Operator in format as per 0 Automatic mode. field is ignored 1 Manual operator selection. field shall be present and optionally 2 Manually deregister from network 3 Set only (for AT+COPS? Read Command), and do not attempt registration/deregistration ( and fields are ignored). This value is invalid in the response of Read Command. 4 Manual/automatic selection. field shall be presented. If manual selection fails, automatic mode (=0) will be entered 0 Long format alphanumeric which can be up to 16 characters long 1 Short format alphanumeric 2 Numeric . GSM location area identification number Access technology selected. Values 4, 5, 6 occur only in the response of Read Command while MS is in data service state and is not intended for the AT+COPS Write Command. 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN Example AT+COPS=? //List all current network operators. +COPS: (1,'CHN-UNICOM','UNICOM','46001',2),(2,'CHN-UNICOM','UNICOM','46001',7),(3,'46011','460 EM12&EG12&EG18_AT_Commands_Manual 65 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11','46011',7),(3,'CHINA MOBILE','CMCC','46000',7),,(0-4),(0-2) OK AT+COPS? +COPS: 0,0,'CHN-UNICOM',7 //Query the currently selected network operator. OK 5.2. AT+CREG Network Registration Status The Read Command returns the network registration status. The Write Command sets whether to present URC or not. AT+CREG Network Registration Status Test Command AT+CREG=? Response +CREG: (list of supported s) Read Command AT+CREG? OK Response MT returns the status of result code presentation and an integer which shows whether the network has currently indicated the registration of MT. Location information parameters and are returned only when =2 and MT is registered on the network. +CREG: ,[,,[,]] OK Write Command AT+CREG=[] Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: Response MT controls the presentation of an unsolicited result code +CREG: when =1 and there is a change in the MT network registration status. OK 300ms EM12&EG12&EG18_AT_Commands_Manual 66 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code: +CREG: 2 Enable network registration unsolicited result code with location information: +CREG: [,,[,]] 0 Not registered. MT is not currently searching a new operator to register to 1 Registered, home network 2 Not registered, but MT is currently searching a new operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming Two bytes location area code in hexadecimal format 28-bit (UMTS/LTE) cell ID in hexadecimal format Access technology selected 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA 7 E-UTRAN Example AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'D509','80D413D',7 //URC reports that MT has registered on network. //Activate extended URC mode. //URC reports that operator has found location area code and cell ID. 5.3. AT+CSQ Signal Quality Report The command is used to indicate the received signal strength and the channel bit error rate . AT+CSQ Signal Quality Report Test Command AT+CSQ=? Response The Test Command returns values supported by MT. +CSQ: (list of supported s),(list of supported s) EM12&EG12&EG18_AT_Commands_Manual 67 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Execution Command AT+CSQ Maximum Response Time Reference 3GPP TS 27.007 OK Response The Execution Command returns received signal strength indication and channel bit error rate from MT. +CSQ: , OK If there is error related to MT functionality: +CME ERROR: 300ms Parameter 0 -113dBm or less 1 -111dBm 2...30 -109dBm... -53dBm 31 -51dBm or greater 99 Not known or not detectable Channel bit error rate (in percent) 0...7 As RxQual values in the table in 3GPP TS 45.008 99 Not known or not detectable subclause 8.2.4 Example AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,99 //The current signal strength indication is 28 and channel bit error rate is 99. OK NOTE After using network related commands such as AT+CCWA and AT+CCFC, it is recommended to wait for 3s before entering AT+CSQ so as to ensure that any network access required for the preceding command has been finished. EM12&EG12&EG18_AT_Commands_Manual 68 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 5.4. AT+CPOL Preferred Operator List The command is used to edit and query the list of preferred operators. AT+CPOL Preferred Operator List Test Command AT+CPOL=? Response +CPOL: (list of supported s),(list of supported s) Read Command AT+CPOL? OK Response Query the list of preferred operators: +CPOL: ,,[,,,,] … Write Command AT+CPOL=[,[, [,,, ]]] OK Response Edit the list of preferred operators: OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: If the is given but the is left out, the entry will be deleted. 300ms Parameter The order number of operator in the (U)SIM preferred operator list 0 Long format alphanumeric 1 Short format alphanumeric 2 Numeric indicates the format is alphanumeric or numeric (see AT+COPS) GSM access technology 0 Access technology is not selected 1 Access technology is selected EM12&EG12&EG18_AT_Commands_Manual 69 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual GSM compact access technology 0 Access technology is not selected 1 Access technology is selected UTRAN access technology 0 Access technology is not selected 1 Access technology is selected E-UTRAN access technology 0 Access technology is not selected 1 Access technology is selected NOTES 1. The access technology selection parameters , , and are required for (U)SIM cards or UICC’s containing PLMN selector with access technology. 2. and are not supported by the modules. 5.5. AT+COPN Read Operator Names The command returns the list of the supported operator names from MT. Each operator code that has an alphanumeric equivalent in the MT memory is returned. AT+COPN Read Operator Names Test Command AT+COPN=? Response OK Execution Command AT+COPN Response +COPN: , […] OK Maximum Response Time Reference 3GPP TS 27.007 If there is error related to MT functionality: +CME ERROR: Depends on the number of operator names. Parameter Operator names in numeric format (see AT+COPS) EM12&EG12&EG18_AT_Commands_Manual 70 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Operator names in long alphanumeric format (see AT+COPS) 5.6. AT+CTZU Automatic Time Zone Update The command is used to enable/disable automatic time zone update via NITZ. The configuration is stored to NVM automatically. AT+CTZU Automatic Time Zone Update Test Command AT+CTZU=? Response +CTZU: (0,1) Write Command AT+CTZU= Read Command AT+CTZU? OK Response OK Or ERROR Response +CTZU: Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter Indicate the mode of automatic time zone update 0 Disable automatic time zone update via NITZ 1 Enable automatic time zone update via NITZ Example AT+CTZU? +CTZU: 0 OK AT+CTZU=? +CTZU: (0,1) OK AT+CTZU=1 //Test command //Read command // enable automatic time zone update EM12&EG12&EG18_AT_Commands_Manual 71 / 234 OK AT+CTZU? +CTZU: 1 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 5.7. AT+CTZR Time Zone Reporting The command is used to control the time zone reporting of changed event. If reporting is enabled, MT returns the unsolicited result code +CTZV: or +CTZE: ,, whenever the time zone is changed. The configuration is stored to NVM automatically. AT+CTZR Time Zone Reporting Test Command AT+CTZR=? Response +CTZR: (0-2) Write Command AT+CTZR= Read Command AT+CTZR? OK Response OK Or ERROR Response +CTZR: Maximum Response Time Reference 3GPP TS 27.007 OK 300ms Parameter Indicate the mode of time zone reporting 0 Disable time zone reporting of changed event 1 Enable time zone reporting of changed event by unsolicited result code +CTZV: 2 Enable extended time zone reporting by unsolicited result code +CTZE: ,, Indicate the sum of the local time zone (difference between the local time and GMT is expressed in quarters of an hour) plus daylight saving time. The format is '±zz', expressed as a fixed width, two-digit integer with the range -48 ... +56. To maintain a fixed width, numbers in the range -9 ... +9 are expressed with a leading zero, e.g. '-09', EM12&EG12&EG18_AT_Commands_Manual 72 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual '+00' and '+09'. Indicate whether includes daylight savings adjustment 0 includes no adjustment for daylight saving time 1 includes +1 hour (equals 4 quarters in ) adjustment for daylight saving time 2 includes +2 hours (equals 8 quarters in ) adjustment for daylight saving time Indicate the local time. The format is 'YYYY/MM/DD,hh:mm:ss', expressed as integers representing year (YYYY), month (MM), date (DD), hour (hh), minute (mm) and second (ss). This parameter can be provided by the network when delivering time zone information and will be presented in the unsolicited result code of extended time zone reporting if provided by the network. Example AT+CTZR=2 OK AT+CTZR? +CTZR: 2 OK +CTZE: '+32',0,'2018/03/23,06:51:13' // is 2. 5.8. AT+QLTS Obtain the Latest Time Synchronized through Network The command is used to obtain the latest time synchronized through network. AT+QLTS Obtain the Latest Time Synchronized through Network Test Command AT+QLTS=? Response +QLTS: list of supported s Execution Command AT+QLTS OK Response The Execution Command returns the latest time that has been synchronized through network: +QLTS: , Write Command AT+QLTS= OK Response +QLTS: , EM12&EG12&EG18_AT_Commands_Manual 73 / 234 Maximum Response Time LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK Or ERROR If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Query network time mode 0 Query the latest time that has been synchronized through network 1 Query the current GMT time calculated from the latest time that has been synchronized through network 2 Query the current LOCAL time calculated from the latest time that has been synchronized through network Format is 'yy/MM/dd,hh:mm:ss±zz', in which characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range -48...+48). E.g. 6th of May 2004, 22:10:00 GMT+2 hours equals '04/05/06,22:10:00+08' Daylight saving time. 0 No adjustment 1 Plus one hour 2 Plus two hours NOTE If the time has not been synchronized through network, the command will return a null time string: +QLTS: ''. Example AT+QLTS=? +QLTS: (0-2) //Query supported network time modes. OK AT+QLTS //Query the latest time synchronized through network. +QLTS: '2017/01/13,03:40:48+32,0' OK AT+QLTS=0 //Query the latest time synchronized through network. It offers the same function as Execution Command AT+QLTS. +QLTS: '2017/01/13,03:40:48+32,0' EM12&EG12&EG18_AT_Commands_Manual 74 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK AT+QLTS=1 //Query the current GMT time calculated from the latest time that has been synchronized through network. +QLTS: '2017/01/13,03:41:22+32,0' OK AT+QLTS=2 //Query the current LOCAL time calculated from the latest time that has been synchronized through network. +QLTS: '2017/01/13,11:41:23+32,0' OK 5.9. AT+QNWINFO Query Network Information The command is used to query network information such as access technology selected, the operator and the band selected. AT+QNWINFO Query Network Information Test Command AT+QNWINFO=? Execution Command AT+QNWINFO Response OK Response +QNWINFO: ,,, Maximum Response Time OK 300ms Parameter String type; access technology selected 'NONE' 'WCDMA' 'HSDPA' 'HSUPA' 'HSPA+' 'TDD LTE' 'FDD LTE' Operator names in numeric format The band selected 'WCDMA 2100' B1 'WCDMA 1900' B2 EM12&EG12&EG18_AT_Commands_Manual 75 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 'WCDMA 1800' B3 'WCDMA 1700 US' B4 'WCDMA 850' B5 'WCDMA 900' B8 'WCDMA 1700 JAPAN' B9 'WCDMA 850 JAPAN' B19 'LTE BAND 1' – 'LTE BAND 66' Channel ID NOTES 1. If the devices have not been registered on a network, the command will return +QNWINFO: No Service. 2. For detailed bands of each module supported, please refer to corresponding product specifications. Example AT+QNWINFO=? OK AT+QNWINFO +QNWINFO: 'FDD LTE',46001,'LTE BAND 3',1650 OK 5.10. AT+QSPN Query the Service Provider Name The command is used to query the service provider name. AT+QSPN Query the Service Provider Name Test Command AT+QSPN=? Execution Command AT+QSPN Response OK Response +QSPN: ,,,, OK Reference EM12&EG12&EG18_AT_Commands_Manual 76 / 234 Parameter LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Full name of network Shortened name of network Service provider name Alphabet of full and shortened network name 0 GSM 7-bit default alphabet 1 UCS2 Registered PLMN NOTES 1. If is 0, and will be shown in GSM 7-bit default alphabet string. 2. If is 1, and will be shown in UCS2 hexadecimal string. Example AT+QSPN //Query the service provider name. +QSPN: 'CHN-UNICOM','UNICOM','',0,'46001' OK 5.11. AT+QENG Query Primary Serving Cell and Neighbour Cell Information The command is used to obtain the network information, such as serving cell, neighbour cells. AT+QENG Query Primary Serving Cell and Neighbour Cell Information Test Command AT+QENG=? Response +QENG: (list of supported s) Write Command Query the serving cell information AT+QENG='servingcell' OK Response In LTE mode: +QENG: 'servingcell',,'LTE',,,,,,,,,,,,,,,,, In WCDMA mode: EM12&EG12&EG18_AT_Commands_Manual 77 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual +QENG: 'servingcell',,'WCDMA',,, ,,,,,,,,,,, Write Command Query the information of neighbour cells AT+QENG='neighbourcell' OK Response In LTE mode: [+QENG: 'neighbourcell intra','LTE',,,,,,,,, ,,… [+QENG: 'neighbourcell inter','LTE',,,,,,,,, , … [+QENG:'neighbourcell','WCDMA',,,,,,< ecno>, … In WCDMA mode: [+QENG:'neighbourcell','WCDMA',,, ,,,,, … [+QENG: 'neighbourcell','LTE',,,,, … OK Reference Parameter The information of different cells. 'servingcell' The information of 3G/4G serving cells 'neighbourcell' The information of 3G/4G neighbour cells UE state. 'SEARCH' UE is searching but could not (yet) find a suitable 3G/4G cell. 'LIMSRV' UE is camping on a cell but has not registered on the network. 'NOCONN' UE is camping on a cell and has registered on the network, and it is in idle mode. 'CONNECT' UE is camping on a cell and has registered on the network, and a call is in progress. EM12&EG12&EG18_AT_Commands_Manual 78 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual LTE TDD or FDD mode Mobile Country Code (first part of the PLMN code) '-' Invalid Number format. Mobile Network Code (second part of the PLMN code) '-' Invalid Location Area Code. The parameter determines the two bytes location area code in hexadecimal format (e.g. 00C1 equals 193 in decimal) of the cell that was scanned. Range: 0-65535 '-' Cannot get the invalid value Cell ID. The parameter determines the 16-bit (GSM) or 28-bit (UMTS) cell ID. Range: 0-0xFFFFFFF. '-' Invalid Physical cell ID The parameter determines the UTRA-ARFCN of the cell that was scanned The parameter determines the E-UTRA-ARFCN of the cell that was scanned E-UTRA frequency band (see 3GPP 36.101) UL bandwidth 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz 4 15MHz 5 20MHz DL bandwidth 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz 4 15MHz 5 20MHz Tracking Area Code (see 3GPP 23.003 Section 19.4.2.3) The parameter determines the primary scrambling code of the cell that was scanned Routing Area Code. Range 0-255. The parameter determines the Received Signal Code Power level of the cell that was scanned. Carrier to noise ratio in dB=measured Ec/Io value in dB. Reference Signal Received Power (see 3GPP 36.214) Reference Signal Received Quality (see 3GPP 36.214) The par ameter indicates the Received Signal Strength Indication Logarithmic value of SINR. Range: -20~+30. Unit: dB. Channel Quality Indication, Range: 1-30. Tx power value in 1/10 dBm. It is the maximum of all UL channel tx power. The tx_power value is only meaningful when the device is in traffic. EM12&EG12&EG18_AT_Commands_Manual 79 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Physical channel 0 DPCH 1 FDPCH Spreading factor. 0 SF_4 1 SF_8 2 SF_16 3 SF_32 4 SF_64 5 SF_128 6 SF_256 7 SF_512 8 UNKNOWN (0-16): slot format for DPCH. (0-9): slot format for FDPCH Destination number on which call is to be deflected Number format. Compress mode 0 Not support compress mode 1 Support compress mode Receiver automatic gain control on the camped frequency. Carrier to noise ratio in dB = measured Ec/Io value in dB. 3G neighbour cell set 1 Active set 2 Synchronous neighbour set 3 Asynchronous neighbour set Rank of this cell as neighbour for inter-RAT cell reselection Suitable receive level for inter frequency cell To be considered for reselection. The suitable receive level value of an evaluated lower priority cell must be greater than this value. To be considered for reselection. The suitable receive level value of an evaluated higher priority cell must be greater than this value. Reselection threshold for high priority layers. Reselection threshold for low priority layers. Absolute power level of the common pilot channel as received by the UE in dBm x10. Ratio of the received energy per PN chip for the common pilot channel to the total received power spectral density at the UE antenna connector in dB x10. Select receive level value for base station in dB (see 3GPP 25.304). Cell reselection priority. Range: 0-7. Threshold to control non-intra frequency searches. Specifies the suitable receive level threshold (in dB) used by the UE on the serving cell when reselecting towards a lower priority RAT/frequency. Cell selection parameter for the intra frequency cell. EM12&EG12&EG18_AT_Commands_Manual 80 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual NOTE '-' or - indicates the parameter is invalid under current condition. Example AT +QENG='servingcell' +QENG: 'servingcell','LIMSRV','LTE','FDD',460,11,6935932,30,1825,3,4,4,6934,-115,-13,-83,13,0 OK AT +QENG='neighbourcell' +QENG: 'neighbourcell intra','LTE',38950,276,-3,-88,-65,0,37,7,16,6,44 +QENG: 'neighbourcell inter','LTE',39148,-,-,-,-,-,37,0,30,7,-,-,-,+QENG: 'neighbourcell inter','LTE',37900,-,-,-,-,-,0,0,30,6,-,-,-,- OK 5.12. AT+QCAINFO Query Carrier Aggregation Parameters The command is used to query carrier aggregation parameters. AT+QCAINFO Query Carrier Aggregation Parameters Test Command AT+QCAINFO=? Execution Command AT+QCAINFO Response OK Response +QCAINFO: 'PCC',,,,,, ,,, 'SCC',,,,,, ,,, ['SCC',,,,, ,,,, […]] OK Reference If no secondary cell was active: OK EM12&EG12&EG18_AT_Commands_Manual 81 / 234 Parameter LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Primary carrier component Secondary carrier component EARFCN Bandwidth 6 1.4MHz 15 3MHz 25 5MHz 50 10MHz 75 15MHz 100 20MHz DL Band information. LTE BAND 1 LTE BAND 2 LTE BAND 3 … LTE BAND 66 Primary cell state 0 No serving 1 Registered Secondary cell state 0 Deconfigured 1 Configured deactivated 2 Configured activated Physical Cell ID Reference Signal Received Power (see 3GPP 36.214) Reference Signal Received Quality (see 3GPP 36.214) Received Signal Strength Indication Logarithmic value of SINR. Values are in 1/5th of a dB. Range: 0-250, which translates to -20dB -+30dB. 5.13. AT+QNETINFO='servingcell' Query Serving Cell Information The command is used to query primary and secondary serving cells. AT+QNETINFO='servingcell' Query Serving Cell Information Test Command AT+QNETINFO=? Response … +QNETINFO: 'servingcell' … OK EM12&EG12&EG18_AT_Commands_Manual 82 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Write Command AT+QNETINFO='servingcell' Response Query the serving cell information +QNETINFO: 'servingcell',[,'LTE',,, +QNETINFO: 'servingcell','PCC',,,,,,,,,,,,] [+QNETINFO: 'servingcell','SCC',,,,,,,,, […]] […]] OK Parameter UE state. 'SEARCH' UE is searching but could not (yet) find a suitable 3G/4G cell. 'LIMSRV' UE is camping on a cell but has not registered on the network. 'NOCONN' UE is camping on a cell and has registered on the network, and it is in idle mode. 'CONNECT' UE is camping on a cell and has registered on the network, and a voice call is in progress. LTE mode TDD FDD Mobile Country Code (first part of the PLMN code) Mobile Network Code (second part of the PLMN code) Cell ID. The parameter determines the 16-bit (GSM) or 28-bit (UMTS) cell ID. Range: 0-0xFFFFFFF. Physical Cell ID The parameter determines the E-UTRA-ARFCN of the cell that was scanned E-UTRA frequency band (see 3GPP 36.101) Reference Signal Received Power (see 3GPP 36.214) Reference Signal Received Quality (see 3GPP 36.214) Received Signal Strength Indication Logarithmic value of SINR. Values are in 1/5th of a dB. Range 0-250, which translates to -20dB - +30dB. DL bandwidth 0 1.4MHz 1 3MHz 2 5MHz EM12&EG12&EG18_AT_Commands_Manual 83 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 3 10MHz 4 15MHz 5 20MHz Number format. UL bandwidth 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz 4 15MHz 5 20MHz Tracking Area Code (see 3GPP 23.003) Select RX Level Value for base station in dB (see 3GPP 25.304). 5.14. AT+QPING Ping a Remote Server The command is used to test the Internet protocol reachability of a host. Before using ping tools, the host should activate the context corresponding to via AT+QIACT. It will return the result during the set value of . AT+QPING Ping a Remote Server Test Command AT+QPING=? Response +QPING: (1-16),,(1-255),(1-10) Write Command AT+QPING=,[,[,]] OK Response If ping a remote server successfully, response: OK [+QPING: [,,,,]< CR>…] +QPING: [,,,,,,] Or ERROR Parameter Integer type. The context ID. The range is 1-16. The host address in string type. The format is a domain name or a dotted decimal IP address. EM12&EG12&EG18_AT_Commands_Manual 84 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Integer type. Set the maximum time to wait for the response of each ping request. The range is 1-255, and the default value is 4. If this parameter is not set, the default value will be used.Unit: second. Integer type. Set the maximum number of time for sending ping request. The range is 1-10, and the default value is 4. If this parameter is not set, the default value will be used. The result of each ping request. 0 Received the ping response from the server. In this case, it is followed by ,,, Others Please refer to Chapter 2. The IP address of the remote server formatted as a dotted decimal IP. The length of each sent ping request. Unit: byte. The time wait for the response of the ping request. Unit: ms. Time to live value of the response packet for the ping request. The final result of the command. 0 It is finished normally. It is successful to activate the context and find the host. In this case, it is followed by ,,,,,. Others Please refer to Chapter 2. Total number of sent ping requests. Total number of the ping requests that received the response. Total number of the ping requests that are timeout. The minimum response time. Unit: ms. The maximum response time. Unit: ms. The average response time. Unit: ms. Example AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.168.121.86' OK AT+QPING=1,'www.baidu.com' OK +QPING: 0,'14.215.177.38',32,39,255 +QPING: 0,'14.215.177.38',32,42,255 +QPING: 0,'14.215.177.38',32,41,255 EM12&EG12&EG18_AT_Commands_Manual 85 / 234 +QPING: 0,'14.215.177.38',32,38,255 +QPING: 0,4,4,0,38,42,39 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 86 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 6 Call Related Commands 6.1. ATA Answer an Incoming Call The command is used to connect the MT to an incoming voice or data call indicated by a RING URC. ATA Answer an Incoming Call Execution Command ATA Response MT sends off-hook to the remote station. Response in case of data call, if successfully connected CONNECT And MT switches to data mode. outputs only when is greater than 0 in ATX parameter setting. When MT returns to command mode after call release: OK Response in case of voice call, if successfully connected: OK Maximum Response Time Reference V.25ter Response if no connection: NO CARRIER 90s, determined by the network. NOTES 1. Any additional commands on the same command line are ignored. 2. This command may be aborted generally by receiving a character during execution. The aborting is impossible happened during some connection establishments such as handshaking. EM12&EG12&EG18_AT_Commands_Manual 87 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Example RING AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,1,4,0,0,'02154450290',129 OK ATA OK //A voice call is ringing. //PS call in LTE mode. //Incoming call. //Accept the voice call with ATA. 6.2. ATD Originate a Call The command is be used to set up outgoing voice and data calls. Supplementary services can also be controlled with this command. ATD Originate a Call Execution Command ATD[][;] Response This command is used to set up outgoing voice, data or fax calls. It also serves to control supplementary services. If no dial tone and ATX2 or ATX4 is set: NO DIALTONE If busy and ATX3 or ATX4 is set: BUSYBUSY If a connection cannot be established: NO CARRIER If connection is successful and there is a non-voice call: CONNECT And MT switches to data mode. Note: outputs only when is greater than 0 in ATX parameter setting. When MT returns to command mode after call release: OK Maximum Response Time If connection is successful and there is a voice call: OK 5s, determined by the network. EM12&EG12&EG18_AT_Commands_Manual 88 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Reference V.25ter Parameter String of dialing digits and optionally V.25ter modifiers Dialing digits: 0-9, *, #, +, A, B, C Following V.25ter modifiers are ignored: ,(comma), T, P, !, W, @ String of GSM modifiers: I Actives CLIR (Disable presentation of own number to the called party) i Deactivates CLIR (Enable presentation of own number to the called party) G Activates closed user group invocation for this call only g Deactivates closed user group invocation for this call only Only required to set up voice call, return to command state NOTES 1. This command may be aborted generally caused by receiving an ATH command or a character during execution. The aborting is not impossible happened during some connection establishment such as handshaking. 2. Parameter 'I' and 'i' only valid if no '*' or '#' code is within the dial string. 3. See ATX command for setting result code and call monitoring parameters. 4. Responses returned after dialing with ATD: For voice call, two different responses mode can be determined. MT returns OK immediately either after dialing was completed or after the call was established. The setting is controlled by AT+COLP. For factory version, the default is AT+COLP=0, which causes the MT to return OK immediately after dialing was completed. Otherwise MT will return OK, BUSY, NO DIAL TONE, or NO CARRIER. 5. Using ATD during an active voice call:  When a user originates a second voice call while there is already an active voice call, the first call will be automatically put on hold.  The current states of all calls can be easily checked at any time by using AT+CLCC command. Example ATD10086; OK //Dialing out the party’s number. 6.3. ATH Disconnect Existing Connection The command is used to disconnect data calls or voice calls. AT+CHUP is also used to disconnect the voice call. EM12&EG12&EG18_AT_Commands_Manual 89 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual ATH Disconnect Existing Connection Execution Command ATH[n] Response Disconnect existing call by local TE from command line and terminate the call. OK Maximum Response Time 90s, determined by the network. Reference V.25ter Parameter 0 Disconnect existing call from command line and terminate the call 6.4. AT+CVHU Voice Hang up Control The command is used to control whether ATH can be used to disconnect the voice call. AT+CVHU Voice Hang up Control Test Command AT+CVHU=? Response +CVHU: (list of supported s) Read Command AT+CVHU? OK Response +CVHU: Write Command AT+CVHU= Maximum Response Time Reference 3GPP TS 27.007 OK Response OK Or ERROR 300ms Parameter 0 ATH can be used to disconnect the voice call 1 ATH is ignored but OK response is returned EM12&EG12&EG18_AT_Commands_Manual 90 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 6.5. AT+CHUP Hang up Calls The command is used to cancel all voice calls in the state of Active, Waiting and Held. For data disconnections, use ATH. AT+CHUP Hang up Calls Test Command AT+CHUP=? Execution Command AT+CHUP Maximum Response Time Reference 3GPP 27.007 Response OK Response OK Or ERROR 90s, determined by the network. Example RING AT+CHUP OK //Incoming call. //Hang up the call. 6.6. +++ Switch from Data Mode to Command Mode The +++ character sequence supports the MT to switch from data mode to AT command mode. It allows executing AT commands while maintaining the data connection with the remote device. +++ Switch from Data Mode to Command Mode Execution Command +++ Response This command is only available when MT is in data mode. The '+++' character sequence makes the MT to cancel the data flow over the AT interface and switch to command mode. This allows executing AT command while maintaining the data connection with the remote server. Maximum Response Time Reference OK 300ms EM12&EG12&EG18_AT_Commands_Manual 91 / 234 V.25ter LTE-A Module Series EM12&EG12&EG18 AT Commands Manual NOTES 1. To prevent the +++ escape sequence from being misinterpreted as data, the following sequence should be followed:  Do not input any character within 1s before inputting +++.  Input +++ within 1s, and other characters cannot be inputted during the time.  Do not input any character within 1s after +++ has been inputted.  Switch to command mode successfully; otherwise return to step 1. 2. To return back to data mode from command mode, please enter ATO. 3. Another way to change to command mode is through DTR level change, and please refer to AT&D command for details. 6.7. ATO Switch from Command Mode to Data Mode The command is used to resume the connection and switch back from command mode to data mode. ATO Switch from Command Mode to Data Mode Execution Command ATO[n] Response MT resumes the connection and switches back to data mode from command mode. If connection is not successfully resumed: NO CARRIER Maximum Response Time Reference V.25ter If connection is successfully resumed, MT returns to data mode from command mode CONNECT 300ms Parameter 0 Switch from command mode to data mode EM12&EG12&EG18_AT_Commands_Manual 92 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual NOTE When MT returns to data mode from command mode successfully, CONNECT is returned. Please note that outputs only when set by ATX is greater than 0. 6.8. ATS0 Set Number of Rings before Automatically Answering Call The command is used to control automatic answering mode for the incoming calls. ATS0 Set Number of Rings before Automatically Answering Call Read Command ATS0? Response Write Command ATS0= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the number of rings before auto-answer. OK 300ms Parameter 0 Automatic answering is disabled 1-255 Enable automatic answering on the ring number specified NOTE If is set too high, the calling party may hang up before the call is answered automatically. Example ATS0=3 OK RING ##0 //Set three rings before automatically answering a call //A call is coming //Dual card single standby is supported currently, therefore only one (U)SIM card is active. ##0 indicates that the activated (U)SIM card has received an EM12&EG12&EG18_AT_Commands_Manual 93 / 234 RING ##0 RING ##0 incoming call. LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Automatically answering the call after three rings 6.9. ATS6 Set Pause before Blind Dialing The command is implemented for compatibility reasons only, and has no effect. ATS6 Set Pause before Blind Dialing Read Command ATS6? Response Write Command ATS6= Maximum Response Time Reference V.25ter OK Response OK 300ms Parameter 0-2-10 Number of seconds to wait before blind dialing 6.10. ATS7 Set Time to Wait for Connection Completion The command is used to specify the duration (unit: second) to wait for the connection completion in case of answering or originating a call. If no connection is established during the time, MT will be disconnected from the line. ATS7 Set Time to Wait for Connection Completion Read Command ATS7? Response OK EM12&EG12&EG18_AT_Commands_Manual 94 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Write Command ATS7= Maximum Response Time Reference V.25ter Response This parameter setting determines the amount of time (unit: second) to wait for the connection completion in case of answering or originating a call. OK 300ms Parameter 0 Disabled 1-255 Duration of seconds to wait for connection completion 6.11. ATS8 Set the Time to Wait for Comma Dial Modifier The command is implemented for compatibility reasons only, and has no effect. ATS8 Set the Time to Wait for Comma Dial Modifier Read Command ATS8? Response Write Command ATS8= Maximum Response Time Reference V.25ter OK Response OK 300ms Parameter 0 1-2-255 No pause when comma encountered in dial string Number of seconds to wait for comma dial modifier EM12&EG12&EG18_AT_Commands_Manual 95 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 6.12. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier The command is used to determine the duration (unit: tenths of a second) during which the UE remains connected in absence of a data carrier. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier Read Command ATS10? Response Write Command ATS10= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the amount of time (unit: tenths of a second) during which the MT will remain connected in absence of a data carrier. If the data carrier is once more detected before disconnection, the MT remains connected. OK 300ms Parameter 1-15-254 Duration of tenths of seconds to wait before disconnecting after UE has indicated the absence of received line signal 6.13. AT+CSTA Select Type of Address The command is used to select the type of number for further dialing commands ATD according to 3GPP Specifications. The Test Command returns values supported a compound value. AT+CSTA Select Type of Address Test Command AT+CSTA=? Response +CSTA: (list of supported s) Read Command OK Response EM12&EG12&EG18_AT_Commands_Manual 96 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+CSTA? Write Command AT+CSTA= Maximum Response Time Reference 3GPP TS 27.007 +CSTA: OK Response OK 300ms Parameter Current address type setting. 129 Unknown type 145 International type (contains the character '+') 6.14. AT+CLCC List Current Calls of MT The command returns the list of all current calls. If the command is executed successfully, but no calls existed, then no information will be responded but OK will be sent to TE. AT+CLCC List Current Calls of MT Test Command AT+CLCC=? Execution Command AT+CLCC Response OK Response MT returns a list of current calls of MT. If the command is executed successfully, but no calls are existed, then no information will be responded but OK response will be sent to TE. [+CLCC : ,,,,[,, [,]] ... OK Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 97 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter The call identification number as described in 3GPP TS 22.030 can be used in AT+CHLD command operations. 0 Mobile originated (MO) call 1 Mobile terminated (MT) call State of the call 0 Active 1 Held 2 Dialing (MO call) 3 Alerting (MO call) 4 Incoming (MT call) 5 Waiting (MT call) Bearer/teleservice 0 Voice 1 Data 2 FAX 0 Call is not one of multiparty (conference) call parties 1 Call is one of multiparty (conference) call parties Phone number in string type in format specified by Type of address of octet in integer format (Refer to 3GPP TS 24.008, subclause 10.5.4.7 for details). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type Alphanumeric representation for corresponding to the entry found in phonebook. Example ATD10086; OK AT+CLCC +CLCC: 1,0,0,1,0,'',128 +CLCC: 2,0,0,0,0,'10086',129 OK //Establish a call. //PS call in LTE mode. //Establish a call, and the call has been answered. 6.15. AT+CR Service Reporting Control The command is used to control whether the MT to transmit an intermediate result code +CR: to the TE or not when a call is set up. EM12&EG12&EG18_AT_Commands_Manual 98 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual If it is enabled, an intermediate result code is transmitted at the point during connect negotiation at which the MT has determined which speed and quality of service will be used, before any error control or data compression reports and before any final result code (e.g. CONNECT) is transmitted. AT+CR Service Reporting Control Test Command AT+CR=? Response +CR: (list of supported s) Read Command AT+CR? OK Response +CR: Write Command AT+CR=[] Maximum Response Time Reference 3GPP TS 27.007 OK Response MT controls whether intermediate result code +CR: is returned from TA to TE or not when a call is set up. OK 300ms Parameter 0 1 ASYNC SYNC REL ASYNC REL SYNC Disable Enable Asynchronous transparent Synchronous transparent Asynchronous non-transparent Synchronous non-transparent 6.16. AT+CRC Set Cellular Result Codes for Incoming Call Indication The command controls whether to use the extended format of incoming call indication or not. When it is enabled, an incoming call is indicated to TE with unsolicited result code +CRING: instead of the normal RING. AT+CRC Set Cellular Result Codes for Incoming Call Indication Test Command AT+CRC=? Response +CRC: (list of supported s) EM12&EG12&EG18_AT_Commands_Manual 99 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Read Command AT+CRC? Write Command AT+CRC=[] Maximum Response Time Reference 3GPP TS 27.007 OK Response +CRC: OK Response MT controls whether the extended format of incoming call indication is used or not. OK 300ms Parameter 0 1 ASYNC SYNC REL ASYNC REL SYNC FAX VOICE Disable extended format Enable extended format Asynchronous transparent Synchronous transparent Asynchronous non-transparent Synchronous non-transparent Facsimile Voice Example AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK RING ATH OK //Enable extended format. //Indicate incoming call to TE. //Disable extended format. //Indicate incoming call to TE. EM12&EG12&EG18_AT_Commands_Manual 100 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 6.17. AT+CRLP Select Radio Link Protocol Parameter The command selects radio link protocol (RLP) parameters used when non-transparent data calls are originated. AT+CRLP Select Radio Link Protocol Parameter Test Command AT+CRLP=? Response MT returns values supported. RLP (Radio Link Protocol) versions 0 and 1 share the same parameter set. MT returns only one line for this set (during which is not presented). +CRLP: (list of supported s),(list of supported s),(list of supported s),(list of supported s), +CRLP: (list of supported s),(list of supported s),(list of supported s),(list of supported s), +CRLP: (list of supported s),(list of supported s),(list of supported s),(list of supported s), Read Command AT+CRLP? OK Response MT returns current settings for RLP version. RLP versions 0 and 1 share the same parameter set. TA returns only one line for this set (during which is not presented). +CRLP: ,,,, ... Write Command AT+CRLP=[[,[,[,[,]]]]] OK Response TA sets radio link protocol (RLP) parameters used when non-transparent data calls are set up. OK Maximum Response Time 300ms Reference 3GPP TS27.007 Parameter 0-61 Interworking window size (IWF to MS) 0-240-488 For =2 EM12&EG12&EG18_AT_Commands_Manual 101 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 0-61 0-240-488 38-48-255 42-52-255 1-6-255 0-2 Mobile window size (MS to IWF) For =2 Acknowledgment timer T1 in a unit of 10ms For =2 Retransmission attempts N2 RLP version number in integer format 6.18. AT+QECCNUM Configure Emergency Call Numbers The command is used to query, add and delete ECC numbers (emergency call numbers). There are two kinds of ECC numbers: ECC numbers without (U)SIM and ECC numbers with (U)SIM. The default ECC numbers without (U)SIM is 911, 112, 00, 08, 110, 999, 118 and 119. The default ECC number with (U)SIM is 911 and 112. 911 and 112 will always be supported as ECC numbers, and cannot be deleted. ECC numbers can be saved into NVM automatically. If the (U)SIM card contains ECC file, the numbers in ECC file can also be regarded as ECC numbers. The maximal supported ECC numbers of each type is 20. AT+QECCNUM Configure Emergency Call Numbers Test Command AT+QECCNUM=? Response +QECCNUM: (0-2) Write Command AT+QECCNUM=,[,[,,…[,]]] OK Response If is equal to 0, query the ECC numbers. In this case, should be omitted +QECCNUM: ,,[…] OK Read Command AT+QECCNUM? If is not equal to 0: =1 is used to add the ECC number; =2 is used to delete the ECC number. In this case, at least one ECC number should be inputted, and the response is: OK Or ERROR Response +QECCNUM: 0,,[…] … OK EM12&EG12&EG18_AT_Commands_Manual 102 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time 300ms Parameter ECC number operation mode 0 Query ECC numbers 1 Add ECC numbers 2 Delete ECC numbers ECC number type 0 ECC numbers without (U)SIM 1 ECC numbers with (U)SIM String type. ECC numbers (e.g.110, 119) Example AT+QECCNUM=? +QECCNUM: (0-2) //Query the supported ECC number operation mode. OK AT+QECCNUM? //Query the ECC numbers with or without (U)SIM. +QECCNUM: 0,'911','112','00','08','110','999','118','119' +QECCNUM: 1,'911','112' OK AT+QECCNUM=0,1 +QECCNUM: 1,'911','112' //Query the ECC numbers with (U)SIM. OK AT+QECCNUM=1,1,'110', '234' //Add '110' and '234' into the type of ECC numbers with (U)SIM. OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1, '911','112','110','234' OK AT+QECCNUM=2,1,'110' //Delete '110' from the type of ECC numbers with (U)SIM. OK AT+QECCNUM=0,1 //Query the ECC numbers with (U)SIM. +QECCNUM: 1, '911','112','234' OK EM12&EG12&EG18_AT_Commands_Manual 103 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 6.19. AT+QHUP Hang up Call with a Specific Release Cause The command is used to terminate a call or calls (including both voice call and data call) with a specific 3GPP TS 24.008 release cause specified by the host. AT+QHUP Hang up Call with a Specific Release Cause Test Command AT+QHUP=? Write Command AT+QHUP=[,] Response OK Response OK Or ERROR Maximum Response Time Reference If there is any error related to MT functionality: +CME ERROR: 90s, determined by network. Parameter Release cause, 3GPP TS 24.008 release cause to be indicated to the network. 1 Release cause 'unassigned (unallocated) number' 16 Release cause 'normal call clearing' 17 Release cause 'user busy' 18 Release cause 'no user responding' 21 Release cause 'call rejected' 27 Release cause 'destination out of order' 31 Release cause 'normal, unspecified' 88 Release cause 'incompatible destination' Call identification number is an optional index in the list of current calls indicated by AT+CLCC. AT+QHUP will terminate the call identified by the given call number. The default call number 0 is not assigned to any call, but signifies all calls. 0 Terminate all known calls. However, if circuit switches data calls and voice calls at the same time, this command only terminates the CSD calls. 1…7 Terminate the specific call with identification number. Example AT+QHUP=? OK ATD10010; //Test Command //Dial 10010 EM12&EG12&EG18_AT_Commands_Manual 104 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK ATD10086; //Dial 10086 OK AT+CLCC //Query the status of calls +CLCC: 1,0,1,0,0,'10010',129 +CLCC: 2,0,0,0,0,'10086',129 OK AT+QHUP=17,1 //Terminate the call of which call ID is 1. Disconnect cause is 'user busy' OK AT+CLCC //Query the status of calls +CLCC: 1,0,0,0,0,'10086',129 OK AT+QHUP=16 OK AT+CLCC OK //Terminate all existing calls. Disconnect cause is 'normal call clearing' 6.20. AT^DSCI Call Status Indication The command is used to indicate the call status. AT^DSCI Call Status Indication Test Command AT^DSCI=? Response ^DSCI: (0,1) Read Command AT^DSCI? OK Response ^DSCI: Write Command AT^DSCI= Reference OK Response MT enables or disables the presentation of the DSCI at TE. OK Parameter 0 DSCI not supported 1 DSCI supported EM12&EG12&EG18_AT_Commands_Manual 105 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual NOTE When the presentation of the DSCI at the TE is enabled, an unsolicited result code is returned after the action: ^DSCI: ,,,,, Parameters Call ID Call direction 0 Mobile originated call 1 Mobile terminated call Call state 1 CALL_LOCAL_HOLD 2 CALL_ORIGINAL 3 CALL_CONNECT 4 CALL_INCOMING 5 CALL_WAITING 6 CALL_END 7 CALL_ALERTING 8 CALL_REMOTE_HOLD 9 CALL_BOTH_HOLD Call type 0 Voice call 1 PS call Phone number Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type Example //Dial a call AT^DSCI=1 OK ATD10086; OK ^DSCI: 1,0,2,0,10086,129 ^DSCI: 1,0,7,0,10086,129 ^DSCI: 1,0,3,0,10086,129 //Enable DSCI. //Dial 10086. //A call is originated. //The call is alerting. //The call is connected. EM12&EG12&EG18_AT_Commands_Manual 106 / 234 ATH OK ^DSCI: 1,0,6,0,10086,129 //Incoming call RING ^DSCI: 1,1,4,0,13022100000,129 RING ^DSCI: 1,1,6,0,13022100000,129 NO CARRIER LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //The call is ended. //A call is coming. //The call is ended. 6.21. AT+QCHLDIPMPTY Remove a Participant from the Conference Call The command is used to remove a participant from the conference call. It is only for VoLTE. AT+QCHLDIPMPTY Remove a Participant from the Conference Call Test Command AT+QCHLDIPMPTY=? Response +QCHLDIPMPTY: Write Command AT+QCHLDIPMPTY= Maximum Response Time OK Response OK Or ERROR 300ms Parameter A call number EM12&EG12&EG18_AT_Commands_Manual 107 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 7 Phonebook Commands 7.1. AT+CNUM Subscriber Number The command is used to get the subscribers’ own number(s) from the (U)SIM. AT+CNUM Subscriber Number Test Command AT+CNUM=? Execution Command AT+CNUM Response OK Response [+CNUM: [], ,] … OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Optional alphanumeric string associated with . The used character set should be the one selected with AT+CSCS command. String type phone number of format specified by Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type EM12&EG12&EG18_AT_Commands_Manual 108 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 7.2. AT+CPBF Find Phonebook Entries The command is used to search the phonebook entries starting with the given string from the current phonebook memory storage selected with AT+CPBS, and return all found entries sorted in alphanumeric order. AT+CPBF Find Phonebook Entries Test Command AT+CPBF=? Response +CPBF: , Write Command AT+CPBF= OK Response [+CPBF: ,,,] … OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to MT functionality: +CME ERROR: Depend on the storage of phonebook entries. Parameter Indicate the maximum length of field Indicate the maximum length of field The field of maximum length in current TE character set specified by AT+CSCS. In the range of location numbers of phone book memory Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type The field of maximum length in current TE character set specified by AT+CSCS. EM12&EG12&EG18_AT_Commands_Manual 109 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 7.3. AT+CPBR Read Phonebook Entries The command is used to read phonebook entries in location number range ... from the current phonebook memory storage selected with AT+CPBS. If is left out, only location will be returned. AT+CPBR Read Phonebook Entries Test Command AT+CPBR=? Response +CPBR: (list of supported s),, Write Command AT+CPBR=[,] OK Response +CPBR: ,,, … OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to MT functionality: +CME ERROR: Depends on the storage of phonebook entries. Parameter In the range of location numbers of phone book memory Indicate the maximum length of field Indicate the maximum length of field The first phonebook record to be read The last phonebook record to be read Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type The field of maximum length in current TE character set specified by AT+CSCS. EM12&EG12&EG18_AT_Commands_Manual 110 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 7.4. AT+CPBS Select Phonebook Memory Storage The command is used to select phonebook memory storage, which is used by other phonebook related commands. The Read Command returns currently selected memory, the number of used locations and the total number of locations in the memory when supported by manufacturer. The Test Command returns supported storages as compound value. AT+CPBS Select Phonebook Memory Storage Test Command AT+CPBS=? Response +CPBS: (list of supported s) OK Or ERROR Read Command AT+CPBS? If there is any error related to MT functionality: +CME ERROR: Response +CPBS: ,, OK Or ERROR Write Command AT+CPBS= If there is any error related to MT functionality: +CME ERROR: Response OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter 'SM' 'DC' 'FD' (U)SIM phonebook MT dialed calls list (AT+CPBW may not be applicable to this storage) (U)SIM fix dialing-phone book (AT+CPBW operation needs the authority of PIN2) EM12&EG12&EG18_AT_Commands_Manual 111 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 'LD' (U)SIM last-dialing-phone book (AT+CPBW may not be applicable to this storage) 'MC' MT missed (unanswered) calls list (AT+CPBW may not be applicable to this storage) 'ME' Mobile equipment phonebook 'RC' MT received calls list (AT+CPBW may not be applicable to this storage) 'EN' (U)SIM (or MT) emergency number (AT+CPBW may not be applicable to this storage) 'ON' (U)SIM own numbers (MSISDNs) list Indicates the total number of used locations in selected memory Indicates the total number of locations in selected memory 7.5. AT+CPBW Write Phonebook Entry The command is used to write phonebook entry in location number in the current phonebook memory storage selected with AT+CPBS. It can also delete a phonebook entry in location number . AT+CPBW Write Phonebook Entry Test Command AT+CPBW=? Response +CPBW: (The range of supported s),,(list of supported s), OK Or ERROR Write Command AT+CPBW=[][,[,[,]]] If there is any error related to MT functionality: +CME ERROR: Response OK Or ERROR Maximum Response Time Reference 3GPP 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 112 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter In the range of location numbers of phone book memory. If is not given, the first free entry will be used. If is given as the only parameter, the phonebook entry specified by is deleted. Indicates the maximum length of field Indicates the maximum length of field Type of address of octet in integer format (See 3GPP TS 24.008). Usually, it has three kinds of values: 129 Unknown type 145 International type (contains the character '+') 161 National type String type field of maximum length in current TE character set specified by AT+CSCS. Example AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK //Make a new phonebook entry at location 10. AT+CPBW=10 //Delete entry at location 10. OK EM12&EG12&EG18_AT_Commands_Manual 113 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 8 Short Message Service Commands 8.1. AT+CSMS Select Message Service The command is used to select message service and query the types of messages supported by MT. AT+CSMS Select Message Service Test Command AT+CSMS=? Response +CSMS: (list of supported s) Read Command AT+CSMS? OK Response +CSMS: ,,, Write Command AT+CSMS= OK Response +CSMS: ,, OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300ms Parameter Type of message service 0 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2 version 4.7.0; Phase 2+ features which do not require new command syntax can be supported, e.g. correct routing of messages with new Phase 2+ data coding schemes). 1 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is EM12&EG12&EG18_AT_Commands_Manual 114 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual compatible with 3GPP TS 27.005 Phase 2+ version; the requirement of setting 1 is mentioned under corresponding command descriptions). Mobile terminated messages 0 Type not supported 1 Type supported Mobile originated messages 0 Type not supported 1 Type supported Broadcast type messages 0 Type not supported 1 Type supported Example AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //Test command //Set type of message service as 1. //Read command 8.2. AT+CMGF Message Format The command is used to specify the input and output format of the short messages. indicates the format of messages used with send, list, read and write commands and unsolicited result codes resulting from received messages. The format of messages can be either PDU mode (entire TP data units used) or text mode (headers and body of the messages given as separate parameters). Text mode uses the value of parameter specified by command AT+CSCS to inform the character set to be used in the message body in the TA-TE interface. AT+CMGF Message Format Test Command AT+CMGF=? Response +CMGF: (list of supported s) EM12&EG12&EG18_AT_Commands_Manual 115 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Read Command AT+CMGF? Write Command AT+CMGF=[] Maximum Response Time Reference 3GPP TS 27.005 Parameter 0 1 PDU mode Text mode OK Response +CMGF: OK Response MT sets parameter to decide which kind of I/O format of messages is used. OK 300ms 8.3. AT+CSCA Service Center Address The Write Command updates the SMSC address when mobile originated SMS are transmitted. In text mode, the setting is used by Write Command. In PDU mode, setting is used by the same command, but only when the length of the SMSC address is coded into the parameter which equals to zero. AT+CSCA Service Center Address Test Command AT+CSCA=? Read Command AT+CSCA? Response OK Response +CSCA: , Write Command AT+CSCA=[,] OK Response OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CME ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 116 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ). Example AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //Set SMSC address. //Query SMSC address. 8.4. AT+CPMS Preferred Message Storage The command is used to select memory storages , and to be used for reading, writing, etc. AT+CPMS Preferred Message Storage Test Command AT+CPMS=? Response +CPMS: (list of supported s),(list of supported s),(list of supported s) Read Command AT+CPMS? OK Response +CPMS: ,,,,,,,, Write Command AT+CPMS=[,[,]] OK Response MT selects memory storages , and to be used for reading, writing, etc. +CPMS: ,,,,, OK EM12&EG12&EG18_AT_Commands_Manual 117 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300ms Parameter Messages to be read and deleted from this memory storage 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Messages will be written and sent to this memory storage 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Received messages will be placed in this memory storage if routing to PC is not set (AT+CNMI) 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location The number of current messages in The total number of messages which can be stored in Example AT+CPMS? //Query the current SMS message storage. +CPMS: 'ME',0,255,'ME',0,255,'ME',0,255 OK AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //Set SMS message storage as 'SM'. OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //Query the current SMS message storage. OK EM12&EG12&EG18_AT_Commands_Manual 118 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 8.5. AT+CMGD Delete Messages The command is used to delete short messages from the preferred message storage location . If is presented and not set to 0, then the ME should ignore and follow the rules of shown as below. AT+CMGD Delete Messages Test Command AT+CMGD=? Response +CMGD: (list of supported s),(list of supported s) Write Command AT+CMGD=[,] OK Response MT deletes message from preferred message storage location . OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300ms Note: Operation of depends on the storage of deleted messages. Parameter Integer type value in the range of location numbers supported by the associated memory. 0 Delete the message specified in 1 Delete all read messages from storage 2 Delete all read messages from storage and sent mobile originated messages 3 Delete all read messages from storage, sent and unsent mobile originated messages 4 Delete all messages from storage Example AT+CMGD=1 OK AT+CMGD=1,4 OK //Delete the message specified in =1. //Delete all messages from storage. EM12&EG12&EG18_AT_Commands_Manual 119 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 8.6. AT+CMGL List Messages The Read Command returns messages with status value from preferred message storage to the TE. If the status of the message is 'REC UNREAD', the status in the storage changes to 'REC READ'. When executing command AT+CMGL without status value , it will report the list of SMS with 'REC UNREAD' status. AT+CMGL List Messages Test Command AT+CMGL=? Response +CMGL: (list of supported s) Write Command AT+CMGL=[] OK Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-SUBMITs and/or SMS-DELIVERs: +CMGL: ,,,[],[][,,][ ... For SMS-STATUS-REPORTs: +CMGL: ,,,,[],[],,,[ ... For SMS-COMMANDs: +CMGL: ,,,[ … For CBM storage: +CMGL: ,,,,,[ ... OK If in PDU mode (AT+CMGF=0) and the command is executed successfully: +CMGL: ,,[], ... OK EM12&EG12&EG18_AT_Commands_Manual 120 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Execution Command AT+CMGL Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: Response List all messages with 'REC UNREAD' status from message storage , and then the status in the storage changes to 'REC READ'. 300ms. Note: Operation of depends on the storage of listed messages. Parameter In text mode: 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages 'ALL' All messages In PDU mode: 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages 4 All messages In the range of location numbers supported by the associated memory Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in TS 27.007); type of address is given by . String type alphanumeric representation of or corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer specified; the used character set should be the one selected with command Select TE Character Set AT+CSCS (see definition of this command in 3GPP TS 27.007). Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address EM12&EG12&EG18_AT_Commands_Manual 121 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). Message length, integer type. Indicate the length of the message body in the text mode (AT+CMGF=1); or the length of the actual TP data unit in octets in PDU mode (AT+CMGF=0) (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7-bit default alphabet is used and indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set. - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7 bit default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7 bit default alphabet 23) is presented as 17 (IRA 49 and 55)). - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7-bit default alphabet is used: - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS27.007): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A in 3GPP TS 27.007. - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7-bit default alphabet into two IRA character long hexadecimal number. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) 3GPP TS 27.007 Depends on the command or result code: first octet of 3GPP TS 23.040 [3] SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND (default 2) in integer format. 3GPP TS 23.040 [3] TP-Message-Reference in integer format 3GPP TS 23.040 [3] TP-Recipient-Address Address-Value field in string format; BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer command +CSCS in 3GPP TS 27.007 [9]); type of address given by 3GPP TS 24.011 [6] TP-Recipient-Address Type-of-Address octet in integer format (default refer ) 3GPP TS 23.040 [3] TP-Service-Centre-Time-Stamp in time-string format (refer EM12&EG12&EG18_AT_Commands_Manual 122 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual ) 3GPP TS 23.040 [3] TP-Discharge-Time in time-string format: month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. 3GPP TS 23.040 [3] TP-Status in integer format. 3GPP TS 23.040 [3] TP-Command-Type in integer format (default 0) 3GPP TS 23.041 [4] CBM Serial Number in integer format. 3GPP TS 23.041 [4] CBM Message Identifier in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 4-7 in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 0-3 in integer format. Example AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, OK //Set SMS message format as text mode. //List all messages from message storage. 8.7. AT+CMGR Read Messages The Read Command returns SMS message with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage will change to 'REC READ'. AT+CMGR Read Messages Test Command AT+CMGR=? Write Command AT+CMGR= Response OK Response MT returns SMS message with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage will change to 'REC READ'. If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-DELIVER: +CMGR: ,,[],[,,,,,,,] OK For SMS-SUBMIT: +CMGR: ,,[][,,,,,[],,,] OK For SMS-STATUS-REPORTs: +CMGR: ,,,[],[],,, OK For SMS-COMMANDs: +CMGR: ,,[,,[],[],[], ] OK For CBM storage: +CMGR: ,,,,, OK If in PDU mode (AT+CMGF=0) and command is executed successfully: +CMGR: ,[], OK If there is any error related to MT functionality: +CMS ERROR: Depends on the length of message content. EM12&EG12&EG18_AT_Commands_Manual 124 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter In the range of location numbers supported by the associated memory. In text mode 'REC UNREAD' 'REC READ' Received unread messages Received read messages 'STO UNSENT' 'STO SENT' Stored unsent messages Stored sent messages 'ALL' In PDU mode All messages 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages 4 All messages String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND in integer format. If a valid value has been entered once, the parameter can be omitted. Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ). Message number. 3GPP TS 23.040 TP-Message-Number in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Recipient address. 3GPP TS 23.040 TP-Recipient-Address Address-Value field in string format. BCD numbers (or GSM default alphabet characters) are converted to EM12&EG12&EG18_AT_Commands_Manual 125 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual characters of the currently selected TE character set (refer to AT+CSCS command). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (default refer ). Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ). Message length. Indicates in the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0) the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). The text of short message. Please refer Chapter 14.8 for details. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). 3GPP TS 23.040 [3] TP-Discharge-Time in time-string format: year (two last digits), month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. 3GPP TS 23.040 [3] TP-Status in integer format. 3GPP TS 23.040 [3] TP-Command-Type in integer format (default 0) 3GPP TS 23.041 [4] CBM Serial Number in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 4-7 in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 0-3 in integer format. Example +CMTI: 'SM',3 AT+CSDH=1 OK AT+CMGR=3 +CMGR: 'REC 0',145,27 //Indicate that new message has been received and saved to =3 of 'SM'. //Read message UNREAD','+8615021012496',,'13/12/13,15:06:37+32',145,4,0,0,'+861380021050 EM12&EG12&EG18_AT_Commands_Manual 126 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK 8.8. AT+CMGS Send Messages The command is used to send a short message from TE to the network (SMS-SUBMIT). After invoking the Write Command, wait for the prompt > and then start to write the message. After that, enter to indicate the ending of PDU and begin to send the message. Sending can be cancelled by giving character. Abortion is acknowledged with OK, though the message will not be sent. The message reference is returned to the TE on successful message delivery. The value can be used to identify message upon unsolicited delivery status report result code. AT+CMGS Send Messages Test Command AT+CMGS=? Write Command 1) If in text mode (AT+CMGF=1): AT+CMGS=[,] text is entered means quit without sending 2) If in PDU mode (AT+CMGF=0): AT+CMGS= PDU is given Response OK Response MT sends message from TE to the network (SMS-SUBMIT). Message reference value is returned to the TE on successful message delivery. Optionally (when AT+CSMS value is 1 and the network supports) will be returned. Values can be used to identify message upon unsolicited delivery status report result code. If in text mode (AT+CMGF=1) and sent successfully: +CMGS: OK If in PDU mode (AT+CMGF=0) and sent successfully: +CMGS: OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 120s, determined by the network. Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in EM12&EG12&EG18_AT_Commands_Manual 127 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Message length. Indicates in the text mode (AT+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > +CMGS: 247 OK //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text, send message, quits without sending. 8.9. AT+CMMS Send More Messages The command is used to control the continuity of the SMS relay protocol link. If the feature is enabled (and supported by the currently used network) multiple messages can be sent faster as the link is kept opening. AT+CMMS Send More Messages Test Command AT+CMMS=? Response +CMMS: (list of supporteds) Read Command AT+CMMS? OK Response +CMMS: Write Command AT+CMMS= OK Response OK Or EM12&EG12&EG18_AT_Commands_Manual 128 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.005 ERROR If there is any error related to MT functionality: +CMS ERROR: 120s, determined by network. Parameter 0 1 2 Feature disabled Keep enabled until the time between the response of the latest message send command (AT+CMGS, AT+CMSS, etc.) and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation); then ME shall close the link and MT switches back to 0 automatically. Feature enabled. If the time between the response of the latest message send command and the next send command exceeds 1-5 seconds (the exact value is up to ME implementation), ME shall close the link but MT will not switch back to 0 automatically. NOTE After the execution of the Read Command, a delay of 5-10 seconds is required before issuing the Write Command. Otherwise +CMS ERROR: 500 may appear. 8.10. AT+CMGW Write Messages to Memory The command is used to store short messages from TE to memory storage , and then the memory location of the stored message is returned. Message status will be set to 'stored unsent' by default; but parameter also allows other status values to be given. The syntax of input text is the same as the one specified in AT+CMGS Write Command. AT+CMGW Write Messages to Memory Test Command AT+CMGW=? Write Command 1) If in text mode (AT+CMGF=1): AT+CMGW=[,[,]] text is entered Response OK Response MT transmits SMS message (either SMS-DELIVER or SMS-SUBMIT) from TE to memory storage , and then the memory location of the stored message is returned. By default the message status will be set to ‘stored EM12&EG12&EG18_AT_Commands_Manual 129 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual quits without sending 2) If in PDU mode (AT+CMGF=0): AT+CMGW=[,] PDU is given Maximum Response Time Reference 3GPP TS 27.005 unsent’, but parameter also allows other status values to be given. If message writing is successful: +CMGW: OK If there is any error related to MT functionality: +CMS ERROR: 300ms Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address given by . Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Message length. Indicates in the text mode (AT+CMGF=1) the length of the message body (or ) in characters, or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.04TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Index of message in selected storage . EM12&EG12&EG18_AT_Commands_Manual 130 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Messages will be written and sent to this memory storage 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > +CMGW: 4 //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use to write message or to quit without sending. OK AT+CMGF=0 //Set SMS message format as PDU mode. OK AT+CMGW=18 > 0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK 8.11. AT+CMSS Send Messages from Storage The command is used to send a message with location value from message storage to the network. If a new recipient address is given for SMS-SUBMIT, it should be used instead of the one stored with the message. AT+CMSS Send Messages from Storage Test Command AT+CMSS=? Write Command AT+CMSS=[,[,]] Response OK Response MT sends message with location value from message storage to the network (SMS-SUBMIT). If new recipient address is given, it should be used instead of the one stored with the message. Reference value EM12&EG12&EG18_AT_Commands_Manual 131 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.005 is returned to the TE on successful message delivery. Values can be used to identify message upon unsolicited delivery status report result code. If in text mode (AT+CMGF=1) and sent successfully: +CMSS: [,] OK If in PDU mode (AT+CMGF=0) and sent successfully: +CMSS: [,] OK If there is any error related to MT functionality: +CMS ERROR: 120s, determined by network. Parameter Integer type in the range of location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM 7-bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007); type of address is given by . Type of destination address. 3GPP TS 24.011 TP-Detination-Address Type-of-Address octet in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). Format is same for in case of SMS, but without 3GPP TS 24.011 SC address field and parameter shall be bounded by double quote characters like a normal string type parameter. Messages will be written and sent to this memory storage 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' SMS status report storage location EM12&EG12&EG18_AT_Commands_Manual 132 / 234 Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK AT+CMSS=4 +CMSS: 54 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Set SMS message format as text mode. //Set character set as GSM which is used by the TE. //Enter in text. Use to send message or to quit without sending. //Send the message of index 4 from memory storage. 8.12. AT+CNMA New Message Acknowledgement to UE/TE The command is used to confirm successful receipt of a new message (SMS-DELIVER or SMS-STATUS-REPORT) routed directly to the TE. If the UE does not receive acknowledgement within required time (network timeout), it will send an RP-ERROR message to the network. The UE will automatically disable routing to the TE by setting both and values of AT+CNMI to 0. AT+CNMA New Message Acknowledgement to UE/TE Test Command AT+CNMA=? Response +CNMA: (list of supported s) Execution Command AT+CNMA OK Response OK Or ERROR Write Command AT+CNMA= If there is any error related to MT functionality: +CMS ERROR: Response OK Or ERROR If there is any error related to MT functionality: EM12&EG12&EG18_AT_Commands_Manual 133 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.005 +CMS ERROR: 300ms Parameter Parameter required only for PDU mode 0 Command operates similarly as in text mode 1 Send positive (RP-ACK) acknowledgement to the network. Accepted only in PDU mode. 2 Send negative (RP-ERROR) acknowledgement to the network. Accepted only in PDU mode. NOTE The Execution and Write commands shall only be used when AT+CSMS parameter equals 1 (phase 2+) and an appropriate URC has been issued by the MT, i.e.: +CMT for =2 incoming message classes 0,1,3 and none; +CMT for =3 incoming message classes 0 and 3; +CDS for =1. Example AT+CSMS=1 OK AT+CNMI=1,2,0,0,0 OK AT+CMGF=1 OK AT+CSDH=1 OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when SMS is incoming. AT+CNMA //Send ACK to the network. OK AT+CNMA +CMS ERROR: 340 //The second time return error; it needs ACK only once. EM12&EG12&EG18_AT_Commands_Manual 134 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 8.13. AT+CNMI SMS Event Reporting Configuration The command is used to select the procedure on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR is at low level (ON). If TE is inactive (e.g. DTR is at high level (OFF)), message receiving should be done as specified in 3GPP TS 23.038. AT+CNMI SMS Event Reporting Configuration Test Command AT+CNMI=? Response +CNMI: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CNMI? OK Response +CNMI: ,,,, Write Command AT+CNMI=[[,[,[,[,]]]]] OK Response MT selects the procedure on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR is at low level (ON). If TE is inactive (e.g. DTR is at high level (OFF)), message receiving should be done as specified in 3GPP TS 23.038. OK Or ERROR Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300ms Parameter 0 1 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications. Discard indication and reject new received message unsolicited result codes when TA-TE link is reserved (e.g. in data mode). Otherwise forward them directly to TE. EM12&EG12&EG18_AT_Commands_Manual 135 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in data mode) and flush them to the TE after reservation. Otherwise forward them directly to TE. The rules for storing received SMS depend on its data coding scheme (refer to 3GPPTS 23.038) and preferred memory storage (AT+CPMS) setting, and the value is: 0 No SMS-DELIVER indications are routed to TE. 1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE by using unsolicited result code: +CMTI: , 2 SMS-DELIVERs (except class 2) are routed directly to the TE using unsolicited result code: +CMT: [], (PDU mode enabled) or +CMT: ,[],[,,,,,,, ] (text mode enabled; about the parameters in italics, please refer to AT+CSDH command). Class 2 messages result in indication as defined in =1. 3 Class 3 SMS-DELIVERs are routed directly to TE by using unsolicited result codes defined in =2. Messages of other classes result in indication as defined in =1. The rules for storing received CBMs depend on its data coding scheme (refer to 3GPP TS 23.038) and the setting of Select CBM Types (AT+CSCB); and the value is: 0 No CBM indications are routed to the TE. 2 New CBMs are routed directly to the TE using unsolicited result code: +CBM: (PDU mode); or +CBM: ,,,, (text mode) 0 No SMS-STATUS-REPORTs are routed to the TE. 1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +CDS: (PDU mode) +CDS: ,,[],[],,, (text mode) 2 If SMS-STATUS-REPORT is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CDSI:, 0 TA buffer of unsolicited result codes defined within this command is flushed to the TE when 1...2 is entered (OK response shall be given before flushing the codes). 1 TA buffer of unsolicited result codes defined within this command is cleared when 1...2 is entered. NOTE Unsolicited result code: +CMTI: , +CMT: [], +CBM: Indicate that new message has been received Short message is outputted directly Cell broadcast message is outputted directly EM12&EG12&EG18_AT_Commands_Manual 136 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Example AT+CMGF=1 //Set SMS message format as text mode. OK AT+CSCS='GSM' //Set character set as GSM which is used by the TE. OK AT+CNMI=1,2,0,1,0 //Set SMS-DELIVERs are routed directly to the TE. OK AT+CSDH=1 //Show text mode parameters OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //Short message is outputted directly when an SMS is incoming. 8.14. AT+CSCB Select Cell Broadcast Message Types The command is used to select which types of CBMs are to be received by the ME. The command writes the parameters in NVM. AT+CSCB Select Cell Broadcast Message Types Test Command AT+CSCB=? Response It returns supported modes as a compound value. +CSCB: (list of supported s) Read Command AT+CSCB? OK Response +CSCB : ,, Write Command AT+CSCB=[,mids>[,]] OK Response MT selects which types of CBMs are to be received by the ME. OK Maximum Response Time Reference 3GPP TS 27.005 If there is any error related to MT functionality: +CMS ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 137 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter 0 Message types specified in and are accepted 1 Message types specified in and are not accepted All different possible combinations of CBM message identifiers (refer to ) (default is empty string), e.g. '0,1,5,320-478,922' All different possible combinations of CBM data coding schemes (refer to ) (default is empty string), e.g. '0-3,5' 8.15. AT+CSDH Show SMS Text Mode Parameters The command is used to control whether detailed header information is shown in text mode result codes. AT+CSDH Show SMS Text Mode Parameters Test Command AT+CSDH=? Response +CSDH: (list of supported s) Read Command AT+CSDH? OK Response +CSDH: Write Command AT+CSDH=[] Maximum Response Time Reference 3GPP TS 27.005 OK Response OK Or ERROR 300ms Parameter 0 1 Do not show header values defined in commands +CSCA, +CSMP (, , , , , ) and , or in +CMT, +CMGL, +CMGR result codes for SMS-DELIVERs and SMS-SUBMITs in text mode Show the values in result codes EM12&EG12&EG18_AT_Commands_Manual 138 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Example AT+CSDH=0 OK AT+CMGR=2 +CMGR: 'STO UNSENT' ,'', OK AT+CSDH=1 OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 OK 8.16. AT+CSMP Set SMS Text Mode Parameters The command is used to set values for additional parameters needed when a short message is sent to the network or placed in a storage in text mode. AT+CSMP Set SMS Text Mode Parameters Test Command AT+CSMP=? Read Command AT+CSMP? Response OK Response +CSMP: ,,, Write Command AT+CSMP=[,[,[,]] ] OK Response MT selects values for additional parameters needed when SM is sent to the network or placed in a storage when text mode is selected (AT+CMGF=1). It is possible to set the validity period starting from when the SMS is received by the SMSC ( ranges from 0 to 255) or define the absolute time of the validity period termination ( is a string). OK Maximum Response Time 300ms Reference 3GPP TS 27.005 EM12&EG12&EG18_AT_Commands_Manual 139 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, SMS-COMMAND in integer format. If a valid value has been entered once, parameter can be omitted. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ). Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. EM12&EG12&EG18_AT_Commands_Manual 140 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 9 Packet Domain Commands 9.1. AT+CGATT Attachment or Detachment of PS The command is used to attach MT to, or detach MT from the Packet Domain service. After the command has been completed, the MT remains in V.25ter command state. If MT is already in the requested state, the command will be ignored and the OK response will be returned. If the requested state cannot be achieved, an ERROR or +CME ERROR response will be returned. AT+CGATT Attachment or Detachment of PS Test Command AT+CGATT=? Response +CGATT: (list of supported s) Read Command AT+CGATT? OK Response +CGATT: Write Command AT+CGATT= OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 140s, determined by the network. Parameter Indicates the state of PS attachment 0 Detached 1 Attached Other values are reserved and will result in an ERROR response to the Write Command EM12&EG12&EG18_AT_Commands_Manual 141 / 234 Example AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Attach to PS service. //Detach from PS service. //Query the current PS service state. 9.2. AT+CGDCONT Define PDP Contexts The command is used to specify PDP context parameters for a specific context . A special form of the Write Command (AT+CGDCONT=) causes the values for context to become undefined. It is not allowed to change the definition of an already activated context. The Read Command returns the current settings for each defined PDP context. AT+CGDCONT Define PDP Contexts Test Command AT+CGDCONT=? Response +CGDCONT: (range of supported s),,< APN>,,(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CGDCONT? OK Response +CGDCONT: ,,,,, […] Write Command AT+CGDCONT=[,[,< APN>[,[,[,< head_comp>]]]]] OK Response OK Or ERROR Maximum Response Time 300ms Reference 3GPP TS 27.007 EM12&EG12&EG18_AT_Commands_Manual 142 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter PDP context identifier, a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of supported values (minimum value=1) is returned by the test form of the command. Packet data protocol type, a string parameter which specifies the type of packet data protocol. 'IP' IPV4. Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' Access point name, a string parameter that is a logical name used to select the GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested. A string parameter identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The allocated address may be read using the AT+CGPADDR command. A numeric parameter that controls PDP data compression (applicable for SNDCP only) (refer to 3GPP TS 44.065). 0 Off 1 On 2 V.42bis 3 V.44 (Not supported currently) A numeric parameter that controls PDP header compression (refer to 3GPP TS 44.065 and 3GPP TS 25.323). 0 Off 1 On 2 RFC1144 3 RFC2507 4 RFC3095 Controls how the MT/TA requests to get the IPv4 address information 0 IPv4 address allocation through NAS signaling 1 IPv4 address allocated through DHCP Indicate the type of PDP context activation request for the PDP context 0 PDP context is for new PDP context establishment or for handover from a non-3GPP access network (how the MT decides whether the PDP context is for new PDP context establishment or for handover is implementation specific) 1 PDP context is for emergency bearer services EM12&EG12&EG18_AT_Commands_Manual 143 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 9.3. AT+CGQREQ Quality of Service Profile (Requested) The command is used to allow the TE to specify the quality of service profile that is used when the MT activates a PDP context. The Write Command specifies a profile for the context . A special form of the Write Command, AT+CGQREQ= causes the requested profile for context number to become undefined. The Read Command returns the current settings for each defined context. Details can be found in 3GPP TS 23.107 and all parameters are saved in NVM automatically. AT+CGQREQ Quality of Service Profile (Requested) Test Command AT+CGQREQ=? Response +CGQREQ: ,(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CGQREQ? OK Response [+CGQREQ: ,,,>reliability>,,] […] Write Command AT+CGQREQ=[,[, [,[,[,]]]]] OK Response OK If there is any error related to MT functionality: +CME ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) Packet Data Protocol type 'IP' IPV4. Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' EM12&EG12&EG18_AT_Commands_Manual 144 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual A numeric parameter which specifies the precedence class 0 Network subscribed value 1 High Priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments should be maintained ahead of precedence class 3 3 Low priority. Service commitments should be maintained A numeric parameter which specifies the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the details, please refer to Table 4. 0 Network subscribed value 1-4 Please refer to Table 4. A numeric parameter which specifies the reliability class 0 Network subscribed value 1 Non real-time traffic, error-sensitive application that cannot cope with data loss 2 Non real-time traffic, error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic, error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic, error-sensitive application that can cope with data loss 5 Real-time traffic, error non-sensitive application that can cope with data loss A numeric parameter which specifies the peak throughput class, in octets per second. 0 Network subscribed value 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) 8 Up to 128 000 (1024 kbit/s) 9 Up to 256 000 (2048 kbit/s) A numeric parameter which specifies the mean throughput class, in octets per hour. 0 Network subscribed value 1 100 (~0.22 bit/s) 2 200 (~0.44 bit/s) 3 500 (~1.11 bit/s) 4 1 000 (~2.2 bit/s) 5 2 000 (~4.4 bit/s) 6 5 000 (~11.1 bit/s) 7 10 000 (~22 bit/s) 8 20 000 (~44 bit/s) 9 50 000 (~111 bit/s) EM12&EG12&EG18_AT_Commands_Manual 145 / 234 10 100 000 (~0.22 kbit/s) 11 200 000 (~0.44 kbit/s) 12 500 000(~1.11 kbit/s) 13 1000 000 (~2.2 kbit/s) 14 2 000 000 (~4.4 kbit/s) 15 5 000 000 (~11.1 kbit/s) 16 10 000 000 (~22 kbit/s) 17 20 000 000 (~44 kbit/s) 18 50 000 000 (~111 kbit/s) 31 Best effort LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Table 4: Delay Class SDU Size 128 octets 1024 octets Delay Class 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) 1 (Predictive) 2 (Predictive) 3 (Predictive) 4 (Best Effort) Mean Transfer Delay <0.5 <5 <50 Unspecified <0.5 <5 <50 Unspecified 95 Percentile <1.5 <25 <250 <1.5 <25 <250 - 9.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) The command is used to allow TE to specify a minimum acceptable profile which is checked by MT against the negotiated profile when the PDP context is activated. The Write Command specifies a profile for the context identified by the context identification parameter . A special form of the Write Command, AT+CGQMIN= causes the minimum acceptable profile for context number to become undefined. In this case no check is made against the negotiated profile. The Read Command returns the current settings for each defined context. Details can be found in 3GPP TS 23.107 and all parameters are saved in NVM automatically. EM12&EG12&EG18_AT_Commands_Manual 146 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+CGQMIN Quality of Service Profile (Minimum Acceptable) Test Command AT+CGQMIN=? Response +CGQMIN: ,(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CGQMIN? OK Response [+CGQMIN: ,,,,,] […] Write Command AT+CGQMIN=[,[,< delay>[,[,[,]]]]] OK Response OK If there is any error related to MT functionality: +CME ERROR: Maximum Response Time 300ms Reference 3GPP TS 27.007 Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) Packet Data Protocol type 'IP' IPV4. Internet Protocol (IETF STD 5) 'PPP' 'IPV6' 'IPV4V6' A numeric parameter which specifies the precedence class 0 Network subscribed value 1 High Priority. Service commitments shall be maintained ahead of precedence classes 2 and 3 2 Normal priority. Service commitments should be maintained ahead of precedence class 3 3 Low priority. Service commitments should be maintained A numeric parameter which specifies the delay class. This parameter defines the end-to-end transfer delay incurred in the transmission of SDUs through the network. For the detail please refer to Table 4. EM12&EG12&EG18_AT_Commands_Manual 147 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 0 Network subscribed value A numeric parameter which specifies the reliability class. 0 Network subscribed value 1 Non real-time traffic, error-sensitive application that cannot cope with data loss 2 Non real-time traffic, error-sensitive application that can cope with infrequent data loss 3 Non real-time traffic, error-sensitive application that can cope with data loss, GMM/SM, and SMS 4 Real-time traffic, error-sensitive application that can cope with data loss 5 Real-time traffic, error non-sensitive application that can cope with data loss A numeric parameter which specifies the peak throughput class, in octets per second. 0 Network subscribed value 1 Up to 1 000 (8 kbit/s) 2 Up to 2 000 (16 kbit/s) 3 Up to 4 000 (32 kbit/s) 4 Up to 8 000 (64 kbit/s) 5 Up to 16 000 (128 kbit/s) 6 Up to 32 000 (256 kbit/s) 7 Up to 64 000 (512 kbit/s) 8 Up to 128 000 (1024 kbit/s) 9 Up to 256 000 (2048 kbit/s) A numeric parameter which specifies the mean throughput class, in octets per second. 0 Network subscribed value 1 100 (~0.22 bit/s) 2 200 (~0.44 bit/s) 3 500 (~1.11 bit/s) 4 1 000 (~2.2 bit/s) 5 2 000 (~4.4 bit/s) 6 5 000 (~11.1 bit/s) 7 10 000 (~22 bit/s) 8 20 000 (~44 bit/s) 9 50 000 (~111 bit/s) 10 100 000 (~0.22 kbit/s) 11 200 000 (~0.44 kbit/s) 12 500 000(~1.11 kbit/s) 13 1000 000 (~2.2 kbit/s) 14 2 000 000 (~4.4 kbit/s) 15 5 000 000 (~11.1 kbit/s) 16 10 000 000 (~22 kbit/s) 17 20 000 000 (~44 kbit/s) 18 50 000 000 (~111 kbit/s) 31 Best effort EM12&EG12&EG18_AT_Commands_Manual 148 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 9.5. AT+CGACT Activate or Deactivate PDP Contexts The command is used to activate or deactivate the specified PDP context(s). After the command has been completed, the MT will remain in V.250 command state. If any PDP context is already in the requested state, the state for that context will remain unchanged. If MT is not PS attached when the activation form of the command is executed, MT will first perform a PS attach and then attempt to activate the specified contexts. If no s specify the activation/deactivation form of the command, it will activate or deactivate all defined contexts. AT+CGACT Activate or Deactivate PDP Contexts Test Command AT+CGACT=? Response +CGACT: (list of supported s) Read Command AT+CGACT? OK Response +CGACT: ,[] […] Write Command AT+CGACT=, OK Response OK Or NO CARRIER Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 150s, determined by network. Parameter Indicate the state of PDP context activation 0 Deactivated 1 Activated Other values are reserved and will result in an ERROR response to the Write Command A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) EM12&EG12&EG18_AT_Commands_Manual 149 / 234 Example AT+CGDCONT=4,'IP','UNINET' OK AT+CGACT=1,4 OK AT+CGACT? +CGACT: 1,1 +CGACT: 2,0 +CGACT: 3,0 +CGACT: 4,1 OK AT+CGACT=0,4 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Define a PDP context. //Activated the PDP. //Query the current PDP context state. //Deactivated the PDP. 9.6. AT+CGDATA Enter Data State The Write Command causes the MT to perform whatever actions that are necessary to establish communication between the TE and the network using one or more packet domain PDP types. This may include performing a PS attach and one or more PDP context activations. Any commands following the AT+CGDATA command in the AT command line will not be processed by MT. If the parameter value is unacceptable to MT, MT shall return an ERROR or +CME ERROR response. Otherwise, the MT issues the intermediate result code CONNECT and enters V.250 online data state. After data transfer is completed, and the layer 2 protocol termination procedure has been completed successfully, the command state is reentered and the MT returns the final result code OK. AT+CGDATA Enter Data State Test Command AT+CGDATA=? Response +CGDATA: (list of supported s) Write Command AT+CGDATA=, OK Response CONNECT Or ERROR Maximum Response Time If there is any error related to MT functionality: +CME ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 150 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Reference 3GPP TS 27.007 Parameter A string parameter that indicates the layer 2 protocol to be used between TE and MT: PPP (Point to Point protocol) for a PDP such as IP Other values are not supported and will result in an ERROR response to the execution command A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) 9.7. AT+CGPADDR Show PDP Address The command returns a list of PDP addresses for the specified context identifiers. If no is specified, the addresses for all defined contexts are returned. AT+CGPADDR Show PDP Address Test Command AT+CGPADDR=? Response +CGPADDR: (list of defined s) Write Command AT+CGPADDR[=[,[,…]]] OK Response +CGPADDR: , […] Maximum Response Time Reference 3GPP TS 27.007 OK Or ERROR 300ms Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) A string that identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by the AT+CGDCONT command when the context was defined. For a dynamic address it will be the one assigned EM12&EG12&EG18_AT_Commands_Manual 151 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual during the last PDP context activation that used the context definition referred to by . is omitted if none is available. Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' OK //Define a PDP context. //Activated the PDP. //Show the PDP address. 9.8. AT+CGREG GPRS Network Registration Status The command is used to query the network registration status and control the presentation of an unsolicited result code +CGREG: when =1 and there is a change in the MT’s GPRS network registration status in GERAN/UTRAN, or unsolicited result code +CGREG: [,[],[],[],[]] when =2 and there is a change of the network cell in GERAN/UTRAN. AT+CGREG GPRS Network Registration Status Test Command AT+CGREG=? Response +CGREG: (list of supported s) Read Command AT+CGREG? OK Response +CGREG: ,[,,[,]] Write Command AT+CGREG=[] Maximum Response Time Reference 3GPP TS 27.007 OK Response OK Or ERROR 300ms EM12&EG12&EG18_AT_Commands_Manual 152 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CGREG: 2 Enable network registration and location information unsolicited result code +CGREG: [,,[,]] 0 Not registered, MT is not currently searching an operator to register to. The UE is in GMM state GMM-NULL or GMM-DEREGISTERED-INITIATED. The GPRS service is disabled; the UE is allowed to attach for GPRS if requested by the user. 1 Registered, home network. The UE is in GMM state GMM-REGISTERED or GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED on the home PLMN. 2 Not registered, but MT is currently trying to attach or searching an operator to register to. The UE is in GMM state GMM-DEREGISTERED or GMM-REGISTERED-INITIATED. The GPRS service is enabled, but an allowable PLMN is currently not available. The UE will start a GPRS attach as soon as an allowable PLMN is available. 3 Registration denied. The UE is in GMM state GMM-NULL. The GPRS service is disabled; and the UE is not allowed to attach for GPRS if requested by the user. 4 Unknown 5 Registered, roaming Two bytes location area code in hexadecimal format (e.g. '00C3' equals 195 in decimal) 28-bit (UMTS/LTE) cell ID in hexadecimal format Access technology selected 2 UTRAN 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA and HSUPA One byte routing area code in hexadecimal format. NOTE If the MT also supports one or more of the circuit mode services in GERAN/UTRAN, EPS services in E-UTRAN, the AT+CREG command and +CREG: result codes, the AT+CEREG command and +CEREG: result codes and the command apply to the registration status and location information for those services. Example AT+CGREG=2 OK AT+CGATT=0 OK +CGREG: 2 EM12&EG12&EG18_AT_Commands_Manual 153 / 234 AT+CGATT=1 OK +CGREG: 1,'D504','80428B5',7 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 9.9. AT+CGEREP Packet Domain Event Reporting The command is used to enable/disable sending of unsolicited result codes +CGEV: XXX from MT to TE in the case of certain events occurring in the Packet Domain MT or the network. controls the processing of unsolicited result codes specified within this command. controls the effect on buffered codes when 1 or 2 is entered. AT+CGEREP Packet Domain Event Reporting Test Command AT+CGEREP=? Response +CGEREP: (list of supported s),(list of supported s) Read Command AT+CGEREP? OK Response +CGEREP: , Write Command AT+CGEREP=mode[,] Execution Command AT+CGEREP Maximum Response Time Reference 3GPP TS 27.007 OK Response OK Or ERROR Response OK 300ms Parameter 0 1 2 Buffer unsolicited result codes in the MT; if MT result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE. Discard unsolicited result codes when MT-TE link is reserved (e.g. in on-line data mode); otherwise forward them directly to the TE. Buffer unsolicited result codes in the MT when MT-TE link is reserved (e.g. in on-line data mode) and flush them to the TE when MT-TE link becomes available; EM12&EG12&EG18_AT_Commands_Manual 154 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual otherwise forward them directly to the TE. 0 MT buffer of unsolicited result codes defined within this command is cleaned when 1 or 2 is entered. 1 MT buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is entered (OK response shall be given before flushing the codes). NOTE The unsolicited result codes and the corresponding events are defined as follows: 1. +CGEV: REJECT , : A network request for PDP context activation occurred when the MT was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. Note: This event is not applicable for EPS. 2. +CGEV: NW REACT , , []: The network has requested a context reactivation. The used to reactivate the context is provided if known to the MT. Note: This event is not applicable for EPS. 3. +CGEV: NW DEACT , , []: The network has forced a context deactivation. The used to activate the context is provided if known to the MT. 4. +CGEV: ME DEACT , , []: The mobile equipment has forced a context deactivation. The used to activate the context is provided if known to the MT. 5. +CGEV: NW DETACH: The network has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 6. +CGEV: ME DETACH: The mobile equipment has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 7. +CGEV: NW CLASS : The network has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 8. +CGEV: ME CLASS : The mobile equipment has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 9. +CGEV: NW PDN ACT : The network has activated a context. The context represents a Primary PDP context in GSM/UMTS. This event is not applicable for EPS. 10. +CGEV: ME PDN ACT [,: The mobile termination has activated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. 11. +CGEV: NW PDN DEACT : The network has deactivated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. 12. +CGEV: ME PDN DEACT : The mobile termination has deactivated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM/UMTS. Parameter Packet data protocol type. A string parameter which specifies the type of packet data protocol. 'IP' IPv4 EM12&EG12&EG18_AT_Commands_Manual 155 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 'PPP' PPP 'IPV6' IPv6 'IPV4V6' IPv4v6 A string parameter identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP. PDP context identifier. A numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of AT+CGDCONT command. A string parameter which indicates the GPRS mobile class. A Class A (highest) B Class B C Class C in GPRS and circuit switched alternate mode CG Class C in GPRS only mode CC Class C in circuit switched only mode (lowest) Example AT+CGEREP=? //Test command +CGEREP: (0-2),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK AT+CGEREP=2,1 OK AT+CGACT=1,2 OK //Activated a context. +CGEV: PDN ACT2 AT+CGACT=0,2 //Deactivated a context. OK +CGEV: PDN DEACT2 EM12&EG12&EG18_AT_Commands_Manual 156 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 9.10. AT+CGSMS Select Service for MO SMS Messages The command is used to specify the service or service preference that the MT will use to send MO (mobile originated) SMS messages. AT+CGSMS Select Service for MO SMS Messages Test Command AT+CGSMS=? Response +CGSMS: (list of currently available s) Read Command AT+CGSMS? OK Response +CGSMS: Write Command AT+CGSMS= OK Response OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter A numeric parameter which indicates the service or service preference to be used 0 Packet Domain 1 Circuit switched 2 Packet Domain preferred (use circuit switched if GPRS not available) 3 Circuit switch preferred (use Packet Domain if circuit switched not available) 9.11. AT+CEREG EPS Network Registration Status The command is query the network registration status and controls the presentation of an unsolicited result code +CEREG: when =1 and there is a change in the MT’s EPS network registration status in E-UTRAN, or unsolicited result code +CEREG: [,[],[],[]] when =2 and there is a change of the network cell in E-UTRAN. EM12&EG12&EG18_AT_Commands_Manual 157 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+CEREG EPS Network Registration Status Test Command AT+CEREG=? Response +CEREG: (list of supported s) Read Command AT+CEREG? OK Response +CEREG: ,[,,[,]] Write Command AT+CEREG=[] Maximum Response Time Reference 3GPP TS 27.007 OK Response OK Or ERROR 300ms Parameter 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CEREG: 2 Enable network registration and location information unsolicited result code +CEREG: [,,[,]] 0 Not registered, MT is not currently searching an operator to register to 1 Registered, home network 2 Not registered, but MT is currently trying to attach or searching an operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming Two-byte tracking area code in hexadecimal format 28-bit (E-UTRAN) cell ID in hexadecimal format. Access technology selected 7 E-UTRAN Two byte tracking area code in hexadecimal format (e.g. '00C3' equals 195 in decimal). 9.12. AT+QGDCNT Packet Data Counter The command is used to allow the application to check how much bytes are sent to or received by MT. EM12&EG12&EG18_AT_Commands_Manual 158 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QGDCNT Packet Data Counter Test Command AT+QGDCNT=? Response +QGDCNT: (0,1) Read Command AT+QGDCNT? OK Response +QGDCNT: , Write Command AT+QGDCNT= OK Response OK Or ERROR Maximum Response Time Reference If there is any error related to MT functionality: +CME ERROR: 300ms Parameter The operation about data counter 0 Reset the data counter 1 Save the results of data counter to NVM. If results need to be automatically saved, please refer to AT+QAUGDCNT command. The amount of sent bytes. The amount of received bytes. NOTE When MT is powered on, and will be loaded from results of data counter in NVM. The default result in NVM is 0. Example AT+QGDCNT=? +QGDCNT: (0,1) //Test command OK AT+QGDCNT? //Query the current bytes sent and received. +QGDCNT: 3832,4618 EM12&EG12&EG18_AT_Commands_Manual 159 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK AT+QGDCNT=1 OK AT+QGDCNT=0 OK //Save the results to NVM. //Reset counter 9.13. AT+QAUGDCNT Auto Save Packet Data Counter The command is used to allow AT+QGDCNT to save results to NVM automatically. AT+QAUGDCNT Auto Save Packet Data Counter Test Command AT+QAUGDCNT=? Response +QAUGDCNT: (0,30-65535) Read Command AT+QAUGDCNT? OK Response +QAUGDCNT: Write Command AT+QAUGDCNT= OK Response OK Or ERROR Maximum Response Time Reference If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Default value is 0. The parameter is the time-interval for AT+QGDCNT command to save results to NVM automatically. If it is set to 0, auto-save feature would be disabled. Unit is second. NOTE The configuration would not be saved into NVM. EM12&EG12&EG18_AT_Commands_Manual 160 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Example AT+QAUGDCNT=? //Test command +QAUGDCNT: (0,30-65535) OK AT+QAUGDCNT=35 OK AT+QAUGDCNT? +QAUGDCNT: 35 //Set //Query the interval of auto-save. OK 9.14. AT+QMTUINFO Query MTU Value The command is used to query MTU (Maximum Transmission Unit) value from the network. AT+QMTUINFO Query MTU Value Test Command AT+QMTUINFO=? Read Command AT+QMTUINFO[?] Response OK Response +QMTUINFO:,, OK Reference If no network is active: OK Parameter PDP context identifier, a numeric parameter which specifies a particular PDP context. MTU value of IPv4 interface. MTU value of IPv6 interface. NOTES 1. If only IPv4 iface was activated by the network, the was replaced by '-'. 2. If just IPv6 iface was activated by the network, the was replaced by '-'. EM12&EG12&EG18_AT_Commands_Manual 161 / 234 Example AT+QMTUINFO=? OK AT+QMTUINFO //Query MTU value +QMTUINFO: 1,1460,1460 +QMTUINFO: 2,1460,- +QMTUINFO: 3,- ,1460 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 9.15. AT$QCRMCALL Start or Stop an RmNet Call The command triggers an RmNet call based on parameter which is typically a start or stop of an RmNet call. AT$QCRMCALL Start or Stop a RmNet Call Test Command AT$QCRMCALL=? Response $QCRMCALL: (0-1),(1-8),(1-3),(1-2),(1-42),, Read Command AT$QCRMCALL? OK Response If a RmNet call has been established: $QCRMCALL :, OK Write Command AT$QCRMCALL=,[,[,[,]]] If the establishment of RmNet call failed: OK Response OK Or ERROR Reference Parameter Start or stop a RmNet call 0 Stop an RmNet call 1 Start an RmNet call Currently this parameter only can be set to 1. IP types EM12&EG12&EG18_AT_Commands_Manual 162 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 1 Call type is IPv4 2 Call type is IPv6 3 Call type is IPv4v6 Technology type preferred 2 3GPP (WCDMA/LTE) Profile number. Range is 1-24. Call types V4 IPv4 call V6 IPv6 call Example AT$QCRMCALL=? //Test command $QCRMCALL: (0-1),(1,2,3,4,5,6,7,8),(1-3),(1-2),(1-42),, OK AT$QCRMCALL=1,1,1,2,1 $QCRMCALL: 1,V4 //Start an IPv4 RmNet call OK AT$QCRMCALL? $QCRMCALL: 1,V4 //Query the current RmNet call OK 9.16. AT+QNETDEVSTATUS Query RmNet Device Status The command is used to query RmNet device status. AT+QNETDEVSTATUS Query RmNet Device Status Test Command AT+QNETDEVSTATUS=? Response +QNETDEVSTATUS:(0,1) Read Command AT+QNETDEVSTATUS? OK Response If an RmNet call exists, , and will be included. +QNETDEVSTATUS: [,[,[,]]] OK Or EM12&EG12&EG18_AT_Commands_Manual 163 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual +QNETDEVSTATUS: Write Command AT+QNETDEVSTATUS= Reference OK Response OK Or ERROR Parameter URC of RmNet device status 0 Disable RmNet device status URC 1 Enable RmNet device status URC RmNet call status 0 A RmNet call is disconnected 1 A RmNet call is ready and MCU can get IP addresses by DHCP or QMI 2 A RmNet call is connected IP type 4 Call type is IPv4 6 Call type is IPv6 RmNet call instance. is always 1 in general. NOTE When MT gets IP addresses from network successfully, will change to 1 and MT will keep IP addresses for 2 minutes to wait for MCU to request IP addresses from MT by DHCP or QMI. And MT will disconnect an RmNet call if IP addresses requests are not be received by MT in 2 minutes. Example AT+QNETDEVSTATUS=? +QNETDEVSTATUS:(0,1) OK AT+QNETDEVSTATUS? +QNETDEVSTATUS: 0 OK AT+QNETDEVSTATUS=1 OK AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1 //Test command //Read command //Enable RmNet device status URC. //Read command EM12&EG12&EG18_AT_Commands_Manual 164 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual OK AT$QCRMCALL=1,1,1,2,1 $QCRMCALL: 1,V4 OK +QNETDEVSTATUS: 1,1,4,1 +QNETDEVSTATUS: 1,2,4,1 AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1,2,4,1 OK AT$QCRMCALL=0,1,1,2,1 OK +QNETDEVSTATUS: 1,0,4,1 AT+QNETDEVSTATUS? +QNETDEVSTATUS: 1 OK //Start an IPv4 RmNet call. //RmNet call is ready. //MCU gets IP addresses from the MT. //Read command //Stop an IPv4 RmNet call. //The MT reports URC of RmNet call disconnection. //Read command EM12&EG12&EG18_AT_Commands_Manual 165 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 10 Supplementary Service Commands 10.1. AT+CCFC Call Forwarding Number and Conditions Control The command is used to control of the call forwarding supplementary service according to 3GPP TS 22.082. Registration, erasure, activation, deactivation and status query are supported. AT+CCFC Call Forwarding Number and Conditions Control Test Command AT+CCFC=? Response +CCFC: (list of supported s) Write Command AT+CCFC=,[,[,[,[,[,[,time]]]]]] OK Response MT controls the call forwarding supplementary service. Registration, erasure, activation, deactivation, and status query are supported. If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully (only in connection with =(0-3)): For registered call forwarding numbers: +CCFC: ,[,,[,,[,]]] ... OK If no call forwarding numbers are registered (and therefore all classes are inactive): +CCFC: , OK where =0 and =15 If there is any error related to MT functionality: EM12&EG12&EG18_AT_Commands_Manual 171 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Maximum Response Time Reference 3GPP TS 27.007 +CME ERROR: 300ms Parameter 0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All call forwarding (refer 3GPP TS 22.030)) 5 All conditional call forwarding (refer 3GPP TS 22.030)) 0 Disable 1 Enable 2 Query status 3 Registration 4 Erasure String type phone number of forwarding address in format specified by Type of address in integer format; default value is 145 when dialing string includes international access code character '+'; otherwise 129 Sub-address in the format specified by Type of sub-address in integer 1 Voice 2 Data 4 Fax 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization 1…30 When 'no reply' (=no reply) is enabled or queried, this parameter gives the time in seconds to wait before call is forwarded; default value is 20 0 Not active 1 Active Example AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, //Register the destination number for unconditional call forwarding (CFU). //Query the status of CFU without specifying . EM12&EG12&EG18_AT_Commands_Manual 172 / 234 OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,255 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Erase the registered CFU destination number. //Query the status, no destination number. 10.2. AT+CCWA Call Waiting Control The command is used to allow control of the call waiting supplementary service according to 3GPP TS 22.083. Activation, deactivation and status query are supported. AT+CCWA Call Waiting Control Test Command AT+CCWA=? Response +CCWA: (list of supported s) Read Command AT+CCWA? OK Response +CCWA: Write Command AT+CCWA=[][,[,]] OK Response TA controls the call waiting supplementary service. Activation, deactivation and status query are supported. If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully: +CCWA: , ... OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms EM12&EG12&EG18_AT_Commands_Manual 173 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter 0 Disable presentation of an unsolicited result code 1 Enable presentation of an unsolicited result code When parameter is not given, network is not interrogated 0 Disable 1 Enable 2 Query status A sum of integers, each integer represents a class of information 1 Voice (telephony) 2 Data (bearer service) 4 FAX (facsimile) 16 Data circuit sync 32 Data circuit async 0 Disable 1 Enable Phone number in string type of calling address in format specified by Type of address octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Optional string type alphanumeric representation of corresponding to the entry found in phone book NOTES 1. =0 should be returned only if the service is not active for any i.e. +CCWA: 0, 7 will be returned in this case. 2. When =2, all active call waiting classes will be reported. In this mode the command is aborted by pressing any key. 3. Unsolicited result code: When the presentation call waiting at the MT is enabled (and call waiting is enabled) and a terminating call set up during an established call, an unsolicited result code is returned: +CCWA: ,,[,] Example AT+CCWA=1,1 OK ATD10086; OK +CCWA: '02154450293',129,1 //Enable presentation of an unsolicited result code. //Establish a call. //Indication of a call that has been waiting. EM12&EG12&EG18_AT_Commands_Manual 174 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 10.3. AT+CHLD Call Related Supplementary Services The command is used to allow the control of the following call related services:  A call can be temporarily disconnected from the MT but the connection is retained by the network;  Multiparty conversation (conference calls);  The served subscriber who has two calls (one held and the other either active or alerting) can connect the other parties and release the served subscriber’s own connection. Calls can be put on hold, recovered, released and added to a conversation, and transferred similarly as defined in 3GPP TS 22.030. This is based on the GSM/UMTS supplementary services HOLD (Call Hold; refer to 3GPP TS 22.083 clause 2), MPTY (MultiParty; refer to 3GPP TS 22.084) and ECT (Explicit Call Transfer; refer to 3GPP TS 22.091). The interaction of this command with other commands based on other GSM/UMTS supplementary services is described in the GSM/UMTS standards. Call Hold, MultiParty and Explicit Call Transfer are only applicable to teleservice 11. AT+CHLD Call Related Supplementary Services Test Command AT+CHLD=? Response +CHLD: (list of supported s) Write Command AT+CHLD=[] OK Response MT controls the supplementary services call hold, multiparty and explicit call transfer. Calls can be put on hold, recovered, released, added to conversation and transferred. OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter 0 1 Terminate all held calls or UDUB (User Determined User Busy) for a waiting call. If a call is waiting, terminate the waiting call. Otherwise, terminate all held calls (if any) Terminate all active calls (if any) and accept the other call (waiting call or held call). EM12&EG12&EG18_AT_Commands_Manual 175 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 1X Terminate the specific call number X (X=1-7) 2 Place all active calls on hold (if any) and accept the other call (waiting call or held call) as the active call 2X Place all active calls except call X (X=1-7) on hold 3 Add the held call to the active calls 4 Connect the two calls and disconnects the subscriber from both calls (ECT) Example ATD10086; OK +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129 +CLCC: 2,1,0,0,0,'02154450293',129 OK AT+CHLD=21 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 +CLCC: 2,1,1,0,1,'02154450293',129 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129 +CLCC: 2,1,0,0,1,'02154450293',129 OK //Establish a call. //Indication of a call that has been waiting. //Place the active call on hold and accept the waiting call as the active call. //The first call is on hold. //The second call is active. //Place the active call except call X=1 on hold. //The first call is active. //The second call is on hold. //Add a held call to the active calls in order to set up a conference (multiparty) call. EM12&EG12&EG18_AT_Commands_Manual 176 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 10.4. AT+CLIP Calling Line Identification Presentation The command refers to the GSM/UMTS supplementary service CLIP (Calling Line Identification Presentation) that enables a called subscriber to get the calling line identity (CLI) of the calling party when receiving a mobile terminated call. AT+CLIP Calling Line Identification Presentation Test Command AT+CLIP=? Response +CLIP: (list of supported s) Read Command AT+CLIP? OK Response +CLIP: , Write Command AT+CLIP= OK Response MT enables or disables the presentation of the calling line identity (CLI) at the TE. It has no effect on the execution of the supplementary service CLIP in the network. OK Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 15s, determined by network. Parameter 0 Suppress unsolicited result codes 1 Display unsolicited result codes 0 CLIP not provisioned 1 CLIP provisioned 2 Unknown Phone number in string type of calling address in format specified by Sub-address of format specified by Type of sub-address octet in integer format (refer to 3GPP TS 24.008 [8] subclause 10.5.4.8) Type of address octet in integer format; 129 Unknown type (IDSN format) 145 International number type (ISDN format) 161 National number EM12&EG12&EG18_AT_Commands_Manual 177 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual String type alphanumeric representation of corresponding to the entry found in phone book 0 CLI valid 1 CLI has been withheld by the originator 2 CLI is not available due to interworking problems or limitations of originating network NOTE When the presentation of the CLIP at the TE is enabled (and calling subscriber allows), an unsolicited result code is returned after every RING (or +CRING: ) at a mobile terminating call: +CLIP: ,,[subaddr],[satype],[], Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,,,'QUECTEL',0 10.5. AT+CLIR Calling Line Identification Restriction The command refers to the CLIR supplementary service (Calling Line Identification Restriction) according to 3GPP TS 22.081 and the OIR supplementary service (Originating Identification Restriction) according to 3GPP TS 24.607 that allows a calling subscriber to enable or disable the presentation of the calling line identity (CLI) to the called party when originating a call. AT+CLIR Calling Line Identification Restriction Test Command AT+CLIR=? Response +CLIR: (list of supported s) Read Command AT+CLIR? OK Response +CLIR: , OK EM12&EG12&EG18_AT_Commands_Manual 178 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Write Command AT+CLIR=[] Maximum Response Time Reference 3GPP TS 27.007 Response MT disables or enables the presentation of the calling line identity (CLI) to the called party when originating a call. The command overrides the CLIR subscription (default is restricted or allowed) when temporary mode is provisioned as a default adjustment for all following outgoing calls. This adjustment can be revoked by using the opposite command. OK If there is any error related to MT functionality: +CME ERROR: 15s, determined by network. Parameter Parameter sets the adjustment for outgoing calls 0 Presentation indicator is used according to the subscription of the CLIR service 1 CLIR invocation 2 CLIR suppression Parameter shows the subscriber CLIR service status in the network 0 CLIR not provisioned 1 CLIR provisioned in permanent mode 2 Unknown (e.g. no network, etc.) 3 CLIR temporary mode presentation restricted 4 CLIR temporary mode presentation allowed 10.6. AT+COLP Connected Line Identification Presentation The command is used to enable/disable a calling subscriber to get the connected line identity (COL) of the called party after setting up a mobile originated call, referring to the GSM/UMTS supplementary service COLP (Connected Line Identification Presentation). AT+COLP Connected Line Identification Presentation Test Command AT+COLP=? Response +COLP: (list of supported s) Read Command OK Response EM12&EG12&EG18_AT_Commands_Manual 179 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+COLP? Write Command AT+COLP=[] Maximum Response Time Reference 3GPP TS 27.007 +COLP: , OK Response MT enables or disables the presentation of the COL (Connected Line) at the TE for a mobile originating a call. It has no effect on the execution of the supplementary service COLR in the network. Intermediate result code is returned from TA to TE before any +CR or V.25ter responses. OK 15s, determined by network. Parameter Parameter sets/presents the result code presentation status in the MT 0 Disable 1 Enable Parameter presents the subscriber COLP service status in the network 0 COLP not provisioned 1 COLP provisioned 2 Unknown (e.g. no network, etc.) Phone number in string type, format specified by Type of address octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Sub-address of format specified by Type of sub-address octet in integer format (refer to 3GPP TS 24.008 subclause 10.5.4.8) Optional string type alphanumeric representation of corresponding to the entry found in phone book NOTE When enabled (and called subscriber allows), an intermediate result code is returned before any +CR or V.25ter responses: +COLP: ,,[],[],[] EM12&EG12&EG18_AT_Commands_Manual 180 / 234 Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 10.7. AT+CSSN Supplementary Service Notifications The command is used to enable/disable the presentation of notification result codes from TA to TE. AT+CSSN Supplementary Service Notifications Test Command AT+CSSN=? Response +CSSN: (list of supported s),(list of supported s) Read Command AT+CSSN? OK Response +CSSN: , Write Command AT+CSSN=[,] OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Integer type, sets/indicates the +CSSI intermediate result code presentation status to the TE 0 Disable 1 Enable EM12&EG12&EG18_AT_Commands_Manual 181 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Integer type, sets/indicates the +CSSU unsolicited result code presentation status to the TE 0 Disable 1 Enable Integer type, it is manufacturer specified and supports the following codes: 0 Unconditional call forwarding is active 1 Some of the conditional call forwarding are active 2 Call has been forwarded 3 Waiting call is pending 5 Outgoing call is barred Integer type, it is manufacturer specific and supports the following codes: 0 The incoming call is a forwarded call 2 Call has been put on hold (during a voice call) 3 Call has been retrieved (during a voice call) 5 Held call was terminated by another party 10 Additional incoming call forwarded NOTES 1. When =1 and a supplementary service notification is received after a mobile originated call setup, the +CSSI intermediate result code is sent to TE before any other MO call setup result codes: +CSSI: 2. When =1 and a supplementary service notification is received during a mobile terminated call setup or during a call, the +CSSU unsolicited result code is sent to TE: +CSSU: 10.8. AT+CUSD Unstructured Supplementary Service Data The command is used to allow control of the Unstructured Supplementary Service Data (USSD) according to 3GPP TS 22.090. Both network and mobile initiated operations are supported. Parameter is used to disable/enable the presentation of an unsolicited result code. The value =2 is used to cancel an ongoing USSD session. For a USSD response from the network, or a network initiated operation, the format is: +CUSD: [,,[]]. When is given, a mobile initiated USSD string or a response USSD string to a network initiated operation is sent to the network. The response USSD string from the network is returned in a subsequent +CUSD URC. EM12&EG12&EG18_AT_Commands_Manual 182 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+CUSD Unstructured Supplementary Service Data Test Command AT+CUSD=? Response +CUSD: (list of supported s) Read Command AT+CUSD? OK Response +CUSD: Write Command AT+CUSD=[[,[, ]]] OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 120s, determined by the network. Parameter Set/indicate the result code presentation status to the TE 0 Disable the result code presentation to the TE 1 Enable the result code presentation to the TE 2 Cancel session (not applicable to Read Command response) Unstructured Supplementary Service Data (USSD) to be sent to the network. If this parameter is not given, network is not interrogated. Unstructured Supplementary Service Data (USSD) received from the network Integer type, 3GPP TS 23.038 Cell Broadcast Data Coding Scheme (default 15) USSD response from the network or the network initiated operation 0 No further user action required (network initiated USSD Notify, or no further information needed after mobile initiated operation) 1 Further user action required (network initiated USSD Request, or further information needed after mobile initiated operation) 2 USSD terminated by network 3 Another local client has responded 4 Operation not supported 5 Network time out EM12&EG12&EG18_AT_Commands_Manual 183 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11 Audio Commands 11.1. AT+CLVL Loudspeaker Volume Level Selection The command is used to select the volume level of the internal loudspeaker of MT. AT+CLVL Loudspeaker Volume Level Selection Test Command AT+CLVL=? Response +CLVL: (list of supporteds) Read Command AT+CLVL? OK Response +CLVL: Write Command AT+CLVL= OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Value (0-3-5) with manufacturer specific range (Smallest value represents the lowest sound level) EM12&EG12&EG18_AT_Commands_Manual 184 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11.2. AT+CMUT Mute Control The command is used to enable/disable the uplink voice muting during a voice call. AT+CMUT Mute Control Test Command AT+CMUT=? Response +CMUT: (list of supporteds) Read Command AT+CMUT? OK Response +CMUT: Write Command AT+CMUT= OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter 0 1 Mute OFF Mute ON NOTE This parameter will not be saved and must be set during the call. EM12&EG12&EG18_AT_Commands_Manual 185 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11.3. AT+QAUDLOOP Enable/Disable Audio Loop Test The command is used to enable/disable audio loop test. AT+QAUDLOOP Enable/Disable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (0,1) Read Command AT+QAUDLOOP? OK Response +QAUDLOOP: Write Command AT+QAUDLOOP= Maximum Response Time OK Response OK Or ERROR 300ms Parameter Enable or disable audio loop test 0 Disable audio loop test 1 Enable audio loop test NOTE This parameter will not be saved. 11.4. AT+VTS DTMF and Tone Generation The command is used to send ASCII characters which cause MSC to transmit DTMF tones to a remote subscriber. This command can only be operated in a voice call. EM12&EG12&EG18_AT_Commands_Manual 186 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (0-9,A-D,*,#),(0-255) Write Command AT+VTS=[,] OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: Depends on the length of and . Parameter ASCII characters in the set 0...9, #, *, A, B, C, D. The string should be enclosed in quotation marks ('...'). When sending multiple tones at a time, the time interval of two tones can be specified by AT+VTD. The maximal length of the string is 31. The duration of each tone in 1/10 seconds with tolerance. The value ranges from 0 to 255. If the duration is less than the minimum time specified by the network, the actual duration will be the network specified time. If this parameter is omitted, is specified by AT+VTD. Example ATD12345678900; OK AT+VTS='1' OK AT+VTS='1234567890A' OK //Dial //The remote caller can hear the DTMF tone. //Send multiple tones at a time. EM12&EG12&EG18_AT_Commands_Manual 187 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11.5. AT+VTD Set Tone Duration The command is used to set the duration of DTMF tones. It can also set time interval of two tones when sending multiple tones at a time. AT+VTD Set Tone Duration Test Command AT+VTD=? Response +VTD: (0-255),(0-255) Read Command AT+VTD? OK Response +VTD: , Write Command AT+VTD=[,] OK Response OK Or ERROR Maximum Response Time Reference 3GPP TS 27.007 If there is any error related to MT functionality: +CME ERROR: 300ms Parameter The duration tone in 1/10 seconds with tolerance. The value range: 0-255, and the default is 3. If the duration is less than the minimum time specified by the network, the actual duration will be network specified time. The time interval of two tones when sending multiple tones at a time by AT+VTS. The value range is 0-255, and the default is 0. NOTE These parameters will not be saved. EM12&EG12&EG18_AT_Commands_Manual 188 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11.6. AT+QAUDMOD Set Audio Mode The command is used to set the audio mode required for the connected device. It will take effect at next sound activity. AT+QAUDMOD Set Audio Mode Test Command AT+QAUDMOD=? Response +QAUDMOD: (list of supported s) Read command AT+QAUDMOD? OK Response +QAUDMOD: Write Command AT+QAUDMOD= OK Response OK Or ERROR Maximum Response Time Reference Quectel If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Indicate the current configured audio mode 0 Echo canceller, noise suppressor, digital gain and calibration parameter for Handset 1 Echo canceller, noise suppressor, digital gain and calibration parameter for Headset 2 Echo canceller, noise suppressor, digital gain and calibration parameter for Speaker 3 Turn off all audio processing functions 11.7. AT+QDAI Digital Audio Interface Configuration The command is used to configure the digital audio interface. When there is no codec on board, customers can define the PCM formats by themselves. In the following conditions, the MT can be used directly with default settings (master mode, short-synchronization, 2048KHz clock frequency, 16-bit liner data format, 8KHz sampling rate). EM12&EG12&EG18_AT_Commands_Manual 189 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QDAI Digital Audio Interface Configuration Test Command AT+QDAI=? Response +QDAI: (list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ),(list of supported ) Read Command AT+QDAI? OK Response +QDAI: [,,,,,,,,] Write Command AT+QDAI=[,,,[,[,[,,[,]]]]] OK Response OK Or ERROR Maximum Response Time 300ms Reference Quectel Parameter x Unused (1-6 can be set) 0 Master mode 1 Slave mode 0 Primary mode (short-synchronization) 1 Auxiliary mode (long-synchronization) Clock frequency 0 128KHz 1 256KHz 2 512KHz 3 1024KHz 4 2048KHz 5 4096KHz Data format 0 16-bit linear 0 8KHz 1 16KHz 1 Number of slot EM12&EG12&EG18_AT_Commands_Manual 190 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 2 Number of slot (Set to 2 when use ) Slot mapping value. Range: 1-16. Slot mapping value. Range: 2-16. NOTES 1. The parameter settings will be saved to NVM immediately by default, and will take effect after the MT is reset. 2. 4096KHz clock frequency is only applicable for 16kHz sampling rate. 3. 128KHz clock frequency is not supported. 4. Bit per frame=/. For example, if is 2048kHz and is 8kHz, then bit per frame is 256. Bit per frame should be greater than 16. 5. When slave mode is selected, master and synchronization clock should be provided for the MT. 6. When a recommended codec is selected and 16kHz sampling rate is desired, please input . Currently the MT only supports 16kHz (AT+QDAI=x,0,0,5,0,1). Example AT+QDAI=? //Query the range. +QDAI: x,(0,1),(0,1),(0-5),(0-2),(0,1),(1-2),(1-16),(2-16) OK AT+QDAI? +QDAI: x,0,0,4,0,0,1,1 //Query the current interface configuration. OK AT+QDAI=x,1,0,4,0,0,1,1 OK AT+QDAI=x,0,0,4,0,1,1,1 //Set AUX PCM interface to slave, short-sync, 8kHz sample, 2048kHz BCLK. //Configure one slot. OK AT+QDAI=x,0,0,4,0,1,2,1,3 //Configure two slots. OK EM12&EG12&EG18_AT_Commands_Manual 191 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11.8. AT+QEEC Set Echo Cancellation Parameters The command is used to set echo cancellation parameters. AT+QEEC Set Echo Cancellation Parameters Test Command AT+QEEC=? Response +QEEC: (0-49),(0-65535) Read Command AT+QEEC? OK Response +QEEC: , ... Write Command AT+QEEC=, OK Response OK Or ERROR Parameter Indicate the parameter’s index. Range: 0-50 Indicate the parameter’s value. Range: 0-65535 NOTE These parameters will not be saved. Example AT+QEEC=? //Query the range. +QEEC: (0-50),(0-65535) OK AT+QEEC=6,1234 OK //Set the value of index 6 to 1234. EM12&EG12&EG18_AT_Commands_Manual 192 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11.9. AT+QSIDET Set the Side Tone Gain in Current Mode The command is used to set the side tone gain value in current mode. It will take effect at next sound activity. AT+QSIDET Set the Side Tone Gain in Current Mode Test Command AT+QSIDET=? Response +QSIDET: (list of supported s) Read Command AT+QSIDET? OK Response +QSIDET: Write Command AT+QSIDET= Maximum Response Time Reference Quectel OK Response OK Or ERROR 300ms Parameter Indicate the configured side tone gain in current mode Range: 0-65535. Default value might be different in different audio modes. NOTE This parameter will not be saved. 11.10. AT+QMIC Set Uplink Gains of Microphone The command is used to set the uplink gains of microphone. EM12&EG12&EG18_AT_Commands_Manual 193 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QMIC Set Uplink Gains of Microphone Test Command AT+QMIC=? Response +QMIC: (0-65535),(0-65535) Read Command AT+QMIC? OK Response +QMIC: , Write Command AT+QMIC=[,] Maximum Response Time OK Response OK Or ERROR 300ms Parameter Indicate uplink codec gain and the range is 0-65535. The default value might be different in different audio modes. Indicate uplink digital gain and the range is 0-65535. The default value might be different in different audio modes. NOTE These parameters will not be saved. 11.11. AT+QRXGAIN Set Downlink Gains of RX The command is used to set RX digital gains to change the downlink volume. AT+QRXAGIN Set Downlink Gains of RX Test Command AT+QRXGAIN=? Response +QRXGAIN: (0-65535) Read Command AT+QRXGAIN? OK Response +QRXGAIN: EM12&EG12&EG18_AT_Commands_Manual 194 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Write Command AT+QRXGAIN= Maximum Response Time Reference OK Response OK Or ERROR 300ms Parameter Indicate downlink digital gains. Range: 0-65535. The default value might be different in different audio modes. NOTE This parameter will not be saved. Example AT+QRXGAIN=? +QRXGAIN: (0-65535) OK AT+QRXGAIN? +QRXGAIN: 20577 OK AT+QRXGAIN=8192 OK AT+QRXGAIN? +QRXGAIN: 8192 OK //Test command //Query the current value. The default value might be different in different audio modes. //Set digital gain to 8192. //Query the current configuration. EM12&EG12&EG18_AT_Commands_Manual 195 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 11.12. AT+QIIC IIC Read & Write The command is used to configure the codec via IIC interface. AT+QIIC IIC Read & Write Test Command AT+QIIC=? Response +QIIC: (0,1),(0-0xFF),(0-0xFF),(1,2),(0-0xFFFF) Write Command AT+QIIC=,,,[,] OK Response If all configuration parameters are entered: OK If all configuration parameters are omitted: +QIIC: Maximum Response Time OK 300ms Parameter 0 1 0-0xFF 0-0xFF 1 2 0-0xFFFF Write command Read command 7-bit device address Register address Read bytes Write bytes Data value NOTE These parameters will not be saved. Example AT+QIIC=1,0x18,15,1,38 +QIIC: 0x0026 OK //Read register value, slave address: 0x18, register address: 15, read two bytes. EM12&EG12&EG18_AT_Commands_Manual 196 / 234 AT+QIIC=0,0x18,15,2,38 OK LTE-A Module Series EM12&EG12&EG18 AT Commands Manual //Write register value, slave address: 0x18, register address: 15, write two bytes. 11.13. AT+QTONEDET Enable/Disable DTMF Detection The command is used to enable or disable DTMF detection. When this function is enabled, DTMF tones sent by other side will be detected, and it will be reported on the assigned serial port. AT+QTONEDET Enable/Disable DTMF Detection Test Command AT+QTONEDET=? Response +QTONEDET: (list of supported s) Read Command AT+QTONEDET? OK Response +QTONEDET: Write Command AT+QTONEDET= Maximum Response Time Reference Quectel OK Response OK Or ERROR 300ms Parameter Enable/disable DTMF detection 0 Disable 1 Enable NOTES 1. This setting will take effect immediately. And it will revert to the default values after resetting the MT. 2. DTMF characters - ASCII: DTMF 0 1 2 ASCII 48 49 50 DTMF 8 9 A ASCII 56 57 65 EM12&EG12&EG18_AT_Commands_Manual 197 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 3 51 B 66 4 52 C 67 5 53 D 68 6 54 * 42 7 55 # 35 11.14. AT+QLDTMF Play Local DTMF The command is used to play a local DTMF string, and the maximum length is 20 characters. It can be used to stop playing the DTMF string. AT+QLDTMF Play Local DTMF Test Command AT+QLDTMF=? Response +QLDTMF: (1-1000),(0-9,*,#,A-G ) OK Write Command AT+QLDTMF=,[,< y>] Response OK If there is error related to MT functionality: +CME ERROR: Execute Command AT+QLDTMF Maximum Response Time After the DTMF string is completely played: +QLDTMF: 5 Response OK 300ms Parameter Indicates every DTMF’s play time and mute time. The range is 1 -1000, and the unit is 1/100 second when is set to 1, or 1/10 second when is not set. Maximum 20 DTMF strings, separated by comma. DTMF format: 0-9,*,#,A-G. The string should be enclosed in quotation marks ('...') 901 Audio unknown error 902 Audio invalid parameters 903 Audio operation is not supported 904 Audio device is busy EM12&EG12&EG18_AT_Commands_Manual 198 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual NOTE These parameters will not be saved. Example AT+QLDTMF=? //Query the range. +QLDTMF: (1-1000),(0-9,*,#,A-G) OK AT+QLDTMF=2,'A,B,1,2,#' OK AT+QLDTMF OK //Play 'A,B,1,2,#'. The play time & the mute time are 200ms separately. //Stop playing. 11.15. AT+QLTONE Play a Local Customized Tone The command is used to play a customized tone, use to indicate play time and to indicate mute time, and to indicate repeat times. AT+QLTONE Play a Local Customized Tone Test Command AT+QLTONE=? Response +QLTONE: (0,1),(100-4000),(0-1000),(0-1000),(0-65535) Write Command AT+QLTONE=[,, ,,] OK Response OK If there is error related to MT functionality: +CME ERROR: Maximum Response Time Reference After the tone is completely played: +QLTONE: 0 300ms EM12&EG12&EG18_AT_Commands_Manual 199 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter 0 Stop playing 1 Start to play Tone’s frequency. The range is 100-4000, and the unit is Hz. Tone’s play time on time. The range is 0-1000, and the unit is ms. Tone’s mute time. The range is 0-1000, and the unit is ms. Tone’s total time. The ranges is 0-65535. 901 Audio unknown error 902 Audio invalid parameters 903 Audio operation not supported 904 Audio device busy NOTE These parameters will not be saved. Example AT+QLTONE=? //Query the range. +QLTONE: (0,1),(100-4000),(0-1000),(0-1000),(0-65535) OK AT+QLTONE=1,1000,200,300,3000 OK //Play a 1000Hz tone. The play time is 200ms and the mute time is 300ms. Repeat 3000times. +QLTONE:0 AT+QLTONE=0 OK //Stop playing. 11.16. AT+QAUDCFG Configure Audio Related Settings The command is used to query and configure audio related settings. EM12&EG12&EG18_AT_Commands_Manual 200 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+QAUDCFG Configure Audio Related Settings Test Command AT+QAUDCFG=? Response +QAUDCFG: 'voltedtmfcfg',(0-400,0-9999) Maximum Response Time Reference OK 300ms 11.16.1. AT+QAUDCFG='voltedtmfcfg' Configure VoLTE DTMF Tone The command is used to set the duration and the volume of VoLTE DTMF tone for the MT. If the duration and the volume have never been set or the duration is set to 0, the duration of VoLTE DTMF tone will be controlled by the network. The default duration is 500ms and the default volume is 5000. AT+QAUDCFG='voltedtmfcfg' Configure VoLTE DTMF Tone Write Command AT+QAUDCFG='voltedtmfcfg'[,,] Response If and are omitted, return current configuration: +QAUDCFG: 'voltedtmfcfg',, OK If and are not omitted, set the duration and the volume: OK If there is any error: ERROR Parameter Duration of VoLTE DTMF tone in 2.5ms per unit (that is, the value is incremented in multiplies of 2.5ms). If this value is set to 0, the duration will be controlled by the network, not exceeding the default value 200 (ie. 500ms). Range: 0-400 Volume of VoLTE DTMF tone. If this value is not set before, it will be the default value 5000. Range: 0~9999 EM12&EG12&EG18_AT_Commands_Manual 201 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual NOTES 1. The time interval between two DTMF tones of VoLTE will be a little bit longer than the duration. 2. These parameters will be saved. Example AT+QAUDCFG='voltedtmfcfg',40,5000 OK AT+QAUDCFG='voltedtmfcfg' +QCFG: 'voltedtmfcfg', 40,5000 OK //Set VoLTE DTMF tone duration as 100ms and volume as 5000. //Query the current configuration. EM12&EG12&EG18_AT_Commands_Manual 202 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 12 Hardware Related Commands 12.1. AT+QPOWD Power off The command is used to power off the MT. The UE will return OK immediately when the command is executed. Then the UE will deactivate the network. After it is completed, the UE outputs POWERED DOWN message and enters into power-off state. The maximum time for unregistering network is 60 seconds. To avoid data loss, the power supply for the module cannot be disconnected before the URC POWERED DOWN is outputted. AT+QPOWD Power off Test Command AT+QPOWD=? Response +QPOWD: (0,1) Write Command AT+QPOWD=[] OK Response OK Maximum Response Time Reference POWERED DOWN 300ms Parameter 0 1 Immediate power down Normal power down 12.2. AT+CCLK Clock The command sets and queries the real time clock (RTC) of the MT. The current setting is retained until the MT is totally disconnected from the power supply. EM12&EG12&EG18_AT_Commands_Manual 203 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+CCLK Clock Test Command AT+CCLK=? Read Command AT+CCLK? Write Command AT+CCLK= Maximum Response Time Reference 3GPP TS 27.007 Response OK Response +CCLK: OK Response OK If there is any error related to MT functionality: +CME ERROR: 300ms Parameter String type value, format is 'yy/MM/dd,hh:mm:ss±zz', indicating year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range: -48...+56). E.g. May 6th, 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. Example AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //Query the local time 12.3. AT+CBC Battery Charge The command returns battery charge status and battery charge level of the MT. AT+CBC Battery Charge Test Command AT+CBC=? Response +CBC: (list of supported s),(list of supported s), EM12&EG12&EG18_AT_Commands_Manual 204 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Execution Command AT+CBC Maximum Response Time Reference 3GPP TS 27.007 OK Response +CBC: ,, OK If there is any error related to MT functionality: +CME ERROR: 300ms Parameter Battery charge status 0 MT is not charging 1 MT is charging 2 Charging has been finished Battery charge level 0-100 Battery has 0-100 percent of remaining capacity. Battery voltage (mV) 12.4. AT+QADC Read ADC Value The command is used to read the voltage value of ADC channel. AT+QADC Read ADC Value Test Command AT+QADC=? Response +QADC: (0,1) Read Command AT+QADC= OK Response +QADC: , Maximum Response Time OK 300ms EM12&EG12&EG18_AT_Commands_Manual 205 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Parameter Channel number of the ADC. 0 ADC Channel 0 1 ADC Channel 1 Indicate whether the ADC value read is successful. 0 Failed 1 Successful The voltage of specified ADC channel. Unit is mV. NOTE This command is not supported by EM12 module. 12.5. AT+QSCLK Enable/Disable Entering Sleep Mode The command is used to control whether MT enters sleep mode. When entering into sleep mode is enabled, the MT can directly enter into sleep mode. AT+QSCLK Enable/Disable Entering Sleep Mode Test Command AT+QSCLK=? Response +QSCLK: (list of supported s) Read Command AT+QSCLK? OK Response +QSCLK: , Write Command AT+QSCLK=[,] Maximum Response Time Reference Quectel OK Response OK 300ms Parameter Slow clock mode. 0 Disable slow clock 1 Enable slow clock. It is controlled by DTR. EM12&EG12&EG18_AT_Commands_Manual 206 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Whether to save the configuration into NVM. 0 Not to save 1 Save 12.6. AT+QTEMP Get the Temperature of MT The command is used to get the temperature of MT. AT+QTEMP Get the Temperature of MT Test Command AT+QTEMP=? Execution Command AT+QTEMP Response OK Response Query the information of serving cell OK Reference Quectel [+QTEMP: , […]] Parameter Sensor type. 'xo_therm_buf' XO crystal 'mdm_case_therm' BB chip 'pa_therm1' PA chip 'tsens_tz_sensor0' The first detection point on PCB board 'tsens_tz_sensor1' The second detection point on PCB board 'tsens_tz_sensor2' The third detection point on PCB board 'tsens_tz_sensor3' The forty detection point on PCB board 'tsens_tz_sensor4' The fifth detection point on PCB board Temperature value. Units are in degrees C. Example AT+QTEMP OK +QTEMP: 'xo_therm_buf','26' +QTEMP: 'mdm_case_therm','26' EM12&EG12&EG18_AT_Commands_Manual 207 / 234 +QTEMP: 'pa_therm1','26' +QTEMP: 'tsens_tz_sensor0','29' +QTEMP: 'tsens_tz_sensor1','28' +QTEMP: 'tsens_tz_sensor2','28' +QTEMP: 'tsens_tz_sensor3','28' +QTEMP: 'tsens_tz_sensor4','28' LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 12.7. AT+QPMUGPIO Set the PMU GPIO Output Value The command is used to set the PMU GPIO output value. AT+PMUGPIO Set the PMU GPIO Output Value Test Command AT+QPMUGPIO=? Response + QPMUGPIO: (0,1), Write Command AT+QPMUGPIO=, Maximum Response Time Reference Quectel OK Response OK 300ms Parameter PMU GPIO output value. 0 The PMU GPIO pin outputs high voltage level. 1 The PMU GPIO pin outputs low voltage level. The PMU GPIO number. Range: 1-10. 3 WWAN_LED# (pin 10) of EM12 Others Reserved NOTE The command is applicable to EM12 only. EM12&EG12&EG18_AT_Commands_Manual 208 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Example AT+QPMUGPIO=0,3 //Set the PMU GPIO number 3 (WWAN_LED# of EM12) output high. OK 12.8. AT+QSAR Enable/Disable the SAR Power Backoff The command is used to enable or disable the SAR power backoff. AT+QSAR Enable/Disable the SAR Power Backoff Test Command AT+QSAR=? Response +QSAR: (0-8),(0,1) Read Command AT+QSAR? OK Response +QSAR: Write Command AT+QSAR=[,] OK Response OK Or ERROR Maximum Response Time Reference If there is an error related to ME functionality: +CME ERROR: Parameter 0 Disable SAR power backoff. 1-8 SAR power backoff level. The value of the power backoff is determined by AT+QCFG='sarcfg' command. Whether to save the configuration into NVM. 0 Not to save 1 Save EM12&EG12&EG18_AT_Commands_Manual 209 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 13 Appendix 13.1. References Table 5: Related Documents SN Document Name [1] V.25ter [2] 3GPP TS 27.007 [3] 3GPP TS 27.005 Remark Serial asynchronous automatic dialing and control Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; AT command set for User Equipment (UE) Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; Use of Data Terminal Equipment – Data Circuit terminating Equipment (DTE-DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Table 6: Terms and Abbreviations Abbreviation AMR APN CSD DCD DCE DTE Description Adaptive Multi-Rate Access Point Name Circuit Switch Data Dynamic Content Delivery Data Communication Equipment Data Terminal Equipment EM12&EG12&EG18_AT_Commands_Manual 210 / 234 DTR ECT GPRS ME MS MT NVM PDN PDP PDU PSC RLP RTS/CTS SAR SGSN SMS TA TCP TE UDP UE URC LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Data Terminal Ready Explicit Call Transfer supplementary service General Packet Radio Service Mobile Equipment Mobile Station Mobile Terminal Non-Volatile Memory Public Data Network Packet Data Protocol Protocol Data Unit Primary Synchronization Code Radio Link Protocol Request To Send/Clear To Send Specific Absorption Rate Serving GPRS Support Node Short Messaging Service Terminal Adapter Transmission Control Protocol Terminal Equipment User Datagram Protocol User Equipment Unsolicited Result Code EM12&EG12&EG18_AT_Commands_Manual 211 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 13.2. Factory Default Settings Restorable with AT&F Table 7: Factory Default Settings Restorable with AT&F AT Command ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CBST AT+CMEE AT+CSCS AT+CSTA AT+CR Parameters ,, Factory Defaults 1 0 0 13 10 8 2 0 2 15 1 4 1 1 0 0 0,0,1 1 'GSM' 129 0 EM12&EG12&EG18_AT_Commands_Manual 212 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual AT+CRC AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+CVHU AT+CLIP AT+COLP AT+CLIR AT+CSSN AT+CTZR AT+CPBS AT+CGEREP AT+CEREG AT+CCWA AT+CUSD AT+CLVL AT+QAUDMOD AT+QAUDLOOP ,,, ,,, ,, ,, ,,,, , 0 0,1,1,1 0 17,167,0,0 0 0,'','' 'ME','ME','ME' 2,1,0,0,0 0 0 0 0 0 0,0 0 SM 0,0 0 0 0 3 0 0 EM12&EG12&EG18_AT_Commands_Manual 213 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 13.3. AT Command Settings Storable with AT&W Table 8: AT Command Settings Storable with AT&W AT Command ATE ATQ ATS0 ATS7 ATS10 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CEREG AT+QSIMSTAT Parameters Display with AT&V Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No No 13.4. AT Command Settings Storable with ATZ Table 9: AT Command Settings Storable with ATZ AT Command ATE ATQ Parameters Factory Defaults 1 0 EM12&EG12&EG18_AT_Commands_Manual 214 / 234 ATS0 ATS7 ATS10 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CEREG LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 0 0 15 1 4 1 1 0 0 0 13.5. Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code should be returned. values are mostly used by common message commands. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. Table 10: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported EM12&EG12&EG18_AT_Commands_Manual 215 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 5 PH-SIM PIN required 6 PH-FSIM PIN required 7 PH-FSIM PUK required 10 (U)SIM not inserted 11 (U)SIM PIN required 12 (U)SIM PUK required 13 (U)SIM failure 14 (U)SIM busy 15 (U)SIM wrong 16 Incorrect password 17 (U)SIM PIN2 required 18 (U)SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required EM12&EG12&EG18_AT_Commands_Manual 216 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 13.6. Summary of CMS ERROR Codes Final result code +CMS ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code should be returned. values are mostly used by common message commands: Table 11: Different Coding Schemes of +CMS ERROR: Code of 300 301 302 303 304 305 310 311 312 313 Meaning ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode (U)SIM not inserted (U)SIM pin necessary PH (U)SIM pin necessary (U)SIM failure EM12&EG12&EG18_AT_Commands_Manual 217 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 314 (U)SIM busy 315 (U)SIM wrong 316 (U)SIM PUK required 317 (U)SIM PIN2 required 318 (U)SIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network 332 Network timeout 500 Unknown 512 (U)SIM not ready 513 Message length exceeds 514 Invalid request parameters 515 ME storage failure 517 Invalid service mode 528 More message to send state error 529 MO SMS is not allowed 531 ME storage full EM12&EG12&EG18_AT_Commands_Manual 218 / 234 13.7. Summary of URC LTE-A Module Series EM12&EG12&EG18 AT Commands Manual Table 12: Summary of URC Index URC Display Meaning Condition 1 +CREG: Indicate registration status of the MT AT+CREG=1 After cell neighborhood changing +CREG: [,,[,< shows whether the network has 2 AT+CREG=2 Act>]] currently indicated the registration of the MT, with location area code 3 +CGREG: Indicate network registration status of AT+CGREG=1 the MT +CGREG: [,,[, Indicate network registration and 4 AT+CGREG=2 ]] location information of the MT 5 +CTZV: Time zone reporting AT+CTZR=1 6 +CTZE: ,, Extended time zone reporting AT+CTZR=2 7 +CMTI: , New message is received, and saved See AT+CNMI to memory +CMT: [], output directly to TE (PDU mode) +CMT: ,[], [,,,,,,,] +CBM: directly (PDU mode) +CBM: ,,,, +CDS: directly (PDU mode) +CDS: ,,[],[],,, directly to TE (Text mode) 14 +CDSI: , New message status report is See AT+CNMI received, and saved to memory ^HCDS: New CDS is received and output 15 ,,, ,,,,, The presentation of the COL +COLP: ,,[],[],[] mobile originated call +CLIP: ,,[sub 17 addr],[satype],[], An incoming call is indicated to the 18 +CRING: TE with unsolicited result code AT+CRC=1 instead of the normal RING +CCWA: ,,[,] AT+CCWA=1,1 20 +CSSI: Shows the +CSSI intermediate result AT+CSSN=1 code presentation status to the TE 21 +CSSU: Shows the +CSSU unsolicited result AT+CSSN=,1 code presentation status to the TE +CUSD: [,,[< USSD response from the network, or 22 AT+CUSD=1 dcs>]] a network initiated operation 23 RDY MT initialization is successful N/A 25 +CFUN: 1 All function of the MT is available N/A 26 +CPIN: (U)SIM card pin state N/A 27 +QIND: SMS DONE SMS initialization finished N/A 28 +QIND: PB DONE Phonebook initialization finished N/A 29 POWERED DOWN Module power down AT+QPOWD +CGEV: REJECT , and was automatically rejected. +CGEV: NW REACT ,,[] reactivation AT+CGEREP=2,1 +CGEV: NW DEACT ,,[] deactivation +CGEV: ME DEACT ,,[] deactivation. AT+CGEREP=2,1 34 +CGEV: NW DETACH The network has forced a Packet AT+CGEREP=2,1 Domain detach. 35 +CGEV: ME DETACH The mobile equipment has forced a AT+CGEREP=2,1 Packet Domain detach. 36 +CGEV: NW CLASS The network has forced a change of AT+CGEREP=2,1 EM12&EG12&EG18_AT_Commands_Manual 220 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual MS class. The mobile equipment has forced a 37 +CGEV: ME CLASS AT+CGEREP=2,1 change of MS class. 38 +QTEMP: , Temperature information See AT+QTEMP 13.8. SMS Character Sets Conversions In 3GPP TS 23.038 DCS (Data Coding Scheme) defined three kinds of alphabets in SMS, GSM 7-bit default alphabet, 8 bit data and UCS2 (16-bit). AT+CSMP can set the DCS in text mode (AT+CMGF=1). In text mode, DCS (Data Coding Scheme) and AT+CSCS determine the way of SMS text input or output. Table 13: The Way of SMS Text Input or Output DCS GSM 7-bit GSM 7-bit GSM 7-bit UCS2 8-bit AT+CSCS GSM IRA UCS2 - The Way of SMS Text Input or Output Input or output GSM character sets. Input or output IRA character sets. Input: UE will convert IRA characters to GSM characters. Output: UE will convert GSM characters to IRA characters. Input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Input: UE will convert the UCS2 hex string to GSM characters. Output: UE will convert the GSM characters to UCS2 hex string. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. When DCS=GSM 7-bit, the input or output needs conversion. The detailed conversion tables are shown as below. Table 14: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') No. 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 EM12&EG12&EG18_AT_Commands_Manual 221 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0A Submit 2A 3A 4A 5A 6A 7A B 0B Cancel 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 15: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='GSM') No. 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 EM12&EG12&EG18_AT_Commands_Manual 222 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B 0B 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 16: GSM Extended Characters (GSM Encode) No. 0 1 2 3 4 5 6 7 0 1B40 1 2 3 4 1B14 5 6 7 8 1B28 9 1B29 A B C 1B3C EM12&EG12&EG18_AT_Commands_Manual 223 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual D 1B3D E 1B3E F 1B2F Table 17: The Input Conversions Table (DCS=GSM 7-bit and AT+CSCS='IRA') No. 0 1 2 3 4 5 6 0 20 20 30 00 50 20 1 20 20 21 31 41 51 61 2 20 20 22 32 42 52 62 3 20 20 23 33 43 53 63 4 20 20 02 34 44 54 64 5 20 20 25 35 45 55 65 6 20 20 26 36 46 56 66 7 20 20 27 37 47 57 67 8 backspace 20 28 38 48 58 68 9 20 20 29 39 49 59 69 A 0A Submit 2A 3A 4A 5A 6A B 20 Cancel 2B 3B 4B 1B3C 6B C 20 20 2C 3C 4C 1B2F 6C D 0D 20 2D 3D 4D 1B3E 6D E 20 20 2E 3E 4E 1B14 6E F 20 20 2F 3F 4F 11 6F 7 70 71 72 73 74 75 76 77 78 79 7A 1B28 1B40 1B29 1B3D 20 EM12&EG12&EG18_AT_Commands_Manual 224 / 234 Table 18: IRA Extended Characters No. A B 0 20 20 1 40 20 2 20 20 3 01 20 4 24 20 5 03 20 6 20 20 7 5F 20 8 20 20 9 20 20 A 20 20 B 20 20 C 20 20 D 20 20 E 20 20 F 20 60 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual C D E F 20 20 7F 20 20 5D 20 7D 20 20 20 08 20 20 20 20 5B 20 7B 20 0E 20 0F 20 1C 5C 1D 7C 09 20 20 20 20 0B 04 0C 1F 20 05 06 20 20 20 20 20 20 20 20 20 5E 07 7E 20 20 20 20 20 20 20 20 20 1E 20 20 Table 19: The Output Conversions Table (DCS=GSM 7-bit and AT+CSCS='IRA') No. 0 1 2 3 4 5 6 7 0 40 20 20 30 A1 50 BF 70 1 A3 5F 21 31 41 51 61 71 2 24 20 22 32 42 52 62 72 3 A5 20 23 33 43 53 63 73 EM12&EG12&EG18_AT_Commands_Manual 225 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual 4 E8 20 A4 34 44 54 64 74 5 E9 20 25 35 45 55 65 75 6 F9 20 26 36 46 56 66 76 7 EC 20 27 37 47 57 67 77 8 F2 20 28 38 48 58 68 78 9 C7 20 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B D8 2B 3B 4B C4 6B E4 C F8 C6 2C 3C 4C D6 6C F6 D 0D E6 2D 3D 4D D1 6D F1 E C5 DF 2E 3E 4E DC 6E FC F E5 C9 2F 3F 4F A7 6F E0 Table 20: GSM Extended Characters (ISO-8859-1/Unicode) No. 0 1 2 3 4 5 6 7 0 7C 1 2 3 4 5E 5 6 7 8 7B 9 7D EM12&EG12&EG18_AT_Commands_Manual 226 / 234 LTE-A Module Series EM12&EG12&EG18 AT Commands Manual A B C 5B D 7E E 5D F 5C Because the low 8-bit of UCS2 character is the same as the IRA character:  The conversion table of DCS=GSM 7-bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'.  The conversion table of fmt=GSM 7-bit and AT+CSCS='GSM' is similar to AT+CSCS='GSM'.  The conversion table of fmt= GSM 7-bit and AT+CSCS='IRA' is similar to AT+CSCS='IRA'.  The conversion table of fmt=GSM 7-bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. The difference is the way of SMS text input or output. Please refer to Table 14 for more details. 13.9. Release Cause Text List of AT+CEER Table 21: Release Cause Text List of AT+CEER CS Internal Cause No cause information available (default) Phone is offline No service available Network release, no reason given Received incoming call Client ended call UIM not present Access attempt already in progress EM12&EG12&EG18_AT_Commands_Manual 227 / 234 Access failure, unknown source Concur service not supported by network No response received from network GPS call ended for user call SMS call ended for user call Data call ended for emergency call Rejected during redirect or handoff Lower-layer ended call Call origination request failed Client rejected incoming call Client rejected setup indication Network ended call No funds available No service available Full service not available Maximum packet calls exceeded Video connection lost Video protocol closed after setup Video protocol setup failure Internal error CS Network Cause Unassigned/unallocated number No route to destination Channel unacceptable Operator determined barring LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 228 / 234 Normal call clearing User busy No user responding User alerting, no answer Call rejected Number changed Non selected user clearing Destination out of order Invalid/incomplete number Facility rejected Response to status enquiry Normal, unspecified No circuit/channel available Network out of order Temporary failure Switching equipment congestion Access information discarded Requested circuit/channel not available Resources unavailable, unspecified Quality of service unavailable Requested facility not subscribed Incoming calls barred within the CUG Bearer capability not authorized Bearer capability not available Service/option not available LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 229 / 234 Bearer service not implemented ACM >= ACM max Requested facility not implemented Only RDI bearer is available Service/option not implemented Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Recovery on timer expiry Protocol error, unspecified Interworking, unspecified CS Network Reject IMSI unknown in HLR Illegal MS IMSI unknown in VLR IMEI not accepted Illegal ME LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 230 / 234 GPRS services not allowed GPRS and non GPRS services not allowed MS identity cannot be derived Implicitly detached PLMN not allowed Location area not allowed Roaming not allowed GPRS services not allowed in PLMN No suitable cells in location area MSC temporary not reachable Network failure MAC failure Synch failure Congestion GSM authentication unacceptable Service option not supported Requested service option not subscribed Service option temporary out of order Call cannot be identified No PDP context activated Semantically incorrect message Invalid mandatory information Message type non-existent Message type not compatible with state Information element non-existent LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 231 / 234 Message not compatible with state RR release indication RR random access failure RRC release indication RRC close session indication RRC open session failure Low level failure Low level failure no redial allowed Invalid SIM No service Timer T3230 expired No cell available Wrong state Access class blocked Abort message received Other cause Timer T303 expired No resources Release pending Invalid user data PS Internal Cause Invalid connection identifier Invalid NSAPI Invalid primary NSAPI PDP establish timeout LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 232 / 234 Invalid field SNDCP failure RAB setup failure No GPRS context PDP activate timeout PDP modify timeout PDP inactive max timeout PDP lower layer error PDP duplicate Access technology change PDP unknown reason CS PS Network Cause LLC or SNDCP failure Insufficient resources Missing or unknown APN Unknown PDP address or PDP type User authentication failed Activation rejected by GGSN Activation rejected, unspecified Service option not supported Requested service option not subscribed Service option temporary out of order NSAPI already used (not sent) Regular deactivation QoS not accepted LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 233 / 234 Network failure Reactivation required Feature not supported Semantic error in the TFT operation Syntactical error in the TFT operation Unknown PDP context PDP context without TFT already activated Semantic errors in packet filter Syntactical errors in packet filter Invalid transaction identifier Semantically incorrect message Invalid mandatory information Message non-existent/not implemented Message type not compatible with state IE non-existent/not implemented Conditional IE error Message not compatible with state Protocol error, unspecified LTE-A Module Series EM12&EG12&EG18 AT Commands Manual EM12&EG12&EG18_AT_Commands_Manual 234 / 234

BG95&BG77&BG600L Series AT Commands Manual LPWA Module Series Version: 2.0 Date: 2020-09-18 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series 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. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_AT_Commands_Manual 1 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Copyright The information contained here is proprietary technical information of Quectel Wireless Solutions Co., Ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved. BG95&BG77&BG600L_Series_AT_Commands_Manual 2 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual About the Document Revision History Version 1.0 Date 2019-08-31 Author Ethan YAN/ Hyman DING Ethan YAN/ 2.0 2020-09-18 Hyman DING Description Initial 1. Added the applicable module BG600L-M3 and removed BG95-N1. 2. Deleted AT+CIND, AT+QSPN, AT+CUSD, AT+QGMR and AT+QAPPVER. 3. Added AT+QADC, AT+QPTWEDRXS and AT+QCSCON. 4. Added the list of CoAP and LwM2M related AT commands as well as extended configuration commands. BG95&BG77&BG600L_Series_AT_Commands_Manual 3 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 8 1 Introduction .......................................................................................................................................... 9 1.1. Scope of the Document .............................................................................................................. 9 1.2. Definitions ................................................................................................................................... 9 1.3. AT Command Syntax ................................................................................................................ 10 1.4. AT Command Responses......................................................................................................... 11 1.5. Supported Character Sets ........................................................................................................ 12 1.6. AT Command Interface ............................................................................................................. 12 1.7. Unsolicited Result Code............................................................................................................ 12 1.8. Turn off Procedure .................................................................................................................... 12 2 General Commands ........................................................................................................................... 13 2.1. ATI Display Product Identification Information ....................................................................... 13 2.2. AT+GMI Request Manufacturer Identification........................................................................ 14 2.3. AT+GMM Request Model Identification ................................................................................. 14 2.4. AT+GMR Request Firmware Version Identification ............................................................... 15 2.5. AT+CGMI Request Manufacturer Identification ..................................................................... 15 2.6. AT+CGMM Request Model Identification............................................................................... 16 2.7. AT+CGMR Request Firmware Version Identification ............................................................ 16 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI)........................................ 17 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) ..................................... 18 2.10. AT&F Reset All AT Command Settings to Factory Settings .................................................. 18 2.11. AT&V Display Current Configuration...................................................................................... 19 2.12. AT&W Store Current AT Command Settings to User-defined Profile ................................... 20 2.13. ATZ Restore All AT Command Settings from User-defined Profile ....................................... 20 2.14. ATQ Set Result Code Presentation Mode ............................................................................. 21 2.15. ATV TA Response Format ..................................................................................................... 22 2.16. ATE Set Command Echo Mode ............................................................................................. 23 2.17. A/ Repeat Previous Command Line....................................................................................... 24 2.18. ATS3 Set Command Line Termination Character ................................................................. 24 2.19. ATS4 Set Response Formatting Character.......................................................................... 25 2.20. ATS5 Set Command Line Editing Character ......................................................................... 25 2.21. ATX Set CONNECT Result Code Format and Monitor Call Progress .................................. 26 2.22. AT+CFUN Set UE Functionality ............................................................................................. 27 2.23. AT+CMEE Error Message Format ......................................................................................... 29 2.24. AT+CSCS Select TE Character Set....................................................................................... 30 2.25. AT+QURCCFG Configure URC Indication Option................................................................. 31 3 Serial Interface Control Commands ................................................................................................ 33 3.1. AT&C Set DCD Behavior ....................................................................................................... 33 BG95&BG77&BG600L_Series_AT_Commands_Manual 4 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 3.2. AT&D Set DTR Behavior........................................................................................................ 33 3.3. AT+IFC Set TE-TA Local Flow Control .................................................................................. 34 3.4. AT+ICF Set TE-TA Character Framing.................................................................................. 35 3.5. AT+IPR Set TE-TA Fixed Local Rate..................................................................................... 36 3.6. AT+QRIR Restore MAIN_RI Behavior to Inactive ................................................................. 38 4 Status Control Commands ............................................................................................................... 39 4.1. AT+CPAS Query ME Activity Status ...................................................................................... 39 4.2. AT+QINDCFG URC Indication Configuration ........................................................................ 40 5 (U)SIM Related Commands ............................................................................................................... 42 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) ........................................ 42 5.2. AT+CLCK Facility Lock .......................................................................................................... 43 5.3. AT+CPIN Enter PIN................................................................................................................ 45 5.4. AT+CPWD Change Password ............................................................................................... 47 5.5. AT+CRSM Restricted (U)SIM Access.................................................................................... 49 5.6. AT+QCCID Show ICCID ........................................................................................................ 50 5.7. AT+QPINC Display PIN Remainder Counter......................................................................... 51 5.8. AT+QINISTAT Query Initialization Status of (U)SIM Card .................................................... 52 5.9. AT+QSIMDET (U)SIM Card Detection................................................................................... 52 5.10. AT+QSIMSTAT (U)SIM Card Insertion Status Report........................................................... 53 6 Network Service Commands ............................................................................................................ 56 6.1. AT+CREG Network Registration Status ................................................................................ 56 6.2. AT+COPS Operator Selection ............................................................................................... 57 6.3. AT+CSQ Signal Quality Report.............................................................................................. 59 6.4. AT+CPOL Preferred Operator List ......................................................................................... 60 6.5. AT+COPN Read Operator Names ......................................................................................... 62 6.6. AT+CTZU Automatic Time Zone Update ............................................................................... 63 6.7. AT+CPSMS Power Saving Mode Setting .............................................................................. 64 6.8. AT+QPSMS Power Saving Mode Setting .............................................................................. 66 6.9. AT+QPSMCFG PSM Feature and Minimum Threshold Value Setting ................................. 68 6.10. AT+QPSMEXTCFG Modem Optimization ............................................................................. 69 6.11. AT+CEDRXS e-I-DRX Setting ............................................................................................... 71 6.12. AT+QPTWEDRXS Paging Time Window Value and eDRX Setting.................................... 74 6.13. AT+CEDRXRDP Read Dynamic Parameters ........................................................................ 78 6.14. AT+CTZR Time Zone Reporting ............................................................................................ 81 6.15. AT+QNWINFO Query Network Information........................................................................... 82 6.16. AT+QCSQ Query and Report Signal Strength ...................................................................... 84 6.17. AT+QCSCON Signaling Connection Status .......................................................................... 85 6.18. AT+QLTS Obtain the Latest Time Synchronized Through Network...................................... 86 7 Call Related Commands* .................................................................................................................. 89 7.1. ATD Mobile Originated Call to Dial a Number ....................................................................... 89 7.2. ATH Disconnect Existing Connection .................................................................................... 90 7.3. AT+CVHU Voice Hang up Control ......................................................................................... 91 BG95&BG77&BG600L_Series_AT_Commands_Manual 5 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 7.4. AT+CHUP Hang up a Call...................................................................................................... 92 7.5. +++ Switch from Data Mode to Command Mode................................................................... 92 7.6. ATO Switch from Command Mode to Data Mode ................................................................. 93 7.7. ATS0 Set Number of Rings before Automatic Answering ..................................................... 94 7.8. ATS6 Set Pause before Blind Dialing .................................................................................... 95 7.9. ATS7 Set the Time to Wait for Connection Completion......................................................... 95 7.10. ATS8 Set the Time to Wait for Comma Dial Modifier ............................................................ 96 7.11. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier ..................... 97 7.12. AT+CRC Set Cellular Result Codes for Incoming Call Indication ......................................... 97 8 Short Message Service Commands............................................................................................... 100 8.1. AT+CSMS Select Message Service .................................................................................... 100 8.2. AT+CMGF Message Format ................................................................................................ 101 8.3. AT+CSCA Service Center Address ..................................................................................... 102 8.4. AT+CPMS Preferred Message Storage............................................................................... 103 8.5. AT+CMGD Delete Messages............................................................................................... 105 8.6. AT+CMGL List Messages .................................................................................................... 106 8.7. AT+CMGR Read Messages................................................................................................. 110 8.8. AT+CMGS Send Messages ................................................................................................. 114 8.9. AT+CMMS Send More Messages ....................................................................................... 116 8.10. AT+CMGW Write Messages to Memory.............................................................................. 117 8.11. AT+CMSS Send Messages from Storage ........................................................................... 119 8.12. AT+CNMA New Message Acknowledgement to UE/TE...................................................... 121 8.13. AT+CNMI New Message Indications to TE ......................................................................... 122 8.14. AT+CSDH Show Text Mode Parameters............................................................................. 124 8.15. AT+CSMP Set Text Mode Parameters ................................................................................ 126 8.16. AT+QCMGS Send Concatenated Messages ...................................................................... 127 8.17. AT+QCMGR Read Concatenated Messages ...................................................................... 128 9 Packet Domain Commands ............................................................................................................ 131 9.1. AT+CGATT PS Attach or Detach......................................................................................... 131 9.2. AT+CGDCONT Define PDP Context ................................................................................... 132 9.3. AT+CGACT PDP Context Activate or Deactivate................................................................ 133 9.4. AT+CGPADDR Show PDP Addresses ................................................................................ 135 9.5. AT+CGREG EGPRS Network Registration Status.............................................................. 136 9.6. AT+CGEREP Packet Domain Event Reporting................................................................... 138 9.7. AT+CGSMS Select Service for MO SMS Messages........................................................... 140 9.8. AT+CEREG EPS Network Registration Status.................................................................... 142 10 Supplementary Service Commands* ............................................................................................. 145 10.1. AT+CCFC Call Forwarding Number and Conditions Control .............................................. 145 10.2. AT+CCWA Call Waiting Control........................................................................................... 147 10.3. AT+CHLD Call Related Supplementary Services ................................................................ 149 10.4. AT+CLIP Calling Line Identification Presentation ................................................................ 151 10.5. AT+CLIR Calling Line Identification Restriction ................................................................... 153 10.6. AT+COLP Connected Line Identification Presentation........................................................ 154 BG95&BG77&BG600L_Series_AT_Commands_Manual 6 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 10.7. AT+CSSN Supplementary Service Notifications ................................................................. 155 11 Hardware Related Commands ........................................................................................................ 158 11.1. AT+QPOWD Power down .................................................................................................... 158 11.2. AT+CCLK Clock ................................................................................................................... 158 11.3. AT+CBC Battery Charge ...................................................................................................... 159 11.4. AT+QADC Read ADC Value................................................................................................ 160 11.5. AT+QSCLK Configure Whether or Not to Enter Sleep Mode .............................................. 161 11.6. AT+QTEMP Read Temperature........................................................................................... 162 12 DFOTA Related AT Command ........................................................................................................ 163 13 FTP(S) Related AT Commands ....................................................................................................... 164 14 HTTP(S) Related AT Commands .................................................................................................... 165 15 TCP(IP) Related AT Commands ..................................................................................................... 166 16 GNSS Related AT Commands ........................................................................................................ 167 17 SSL Related AT Commands ........................................................................................................... 168 18 FILE Related AT Commands........................................................................................................... 169 19 MQTT Related AT Commands ........................................................................................................ 170 20 CoAP Related AT Commands......................................................................................................... 171 21 LwM2M Related AT Commands ..................................................................................................... 172 22 Extended Configuration Commands ............................................................................................. 173 23 Appendix ........................................................................................................................................... 175 23.1. References .............................................................................................................................. 175 23.2. Factory Default Settings Restorable with AT&F ..................................................................... 177 23.3. AT Command Settings Storable with AT&W .......................................................................... 179 23.4. AT Command Settings Restorable with ATZ.......................................................................... 180 23.5. Summary of CME ERROR Codes .......................................................................................... 180 23.6. Summary of CMS ERROR Codes .......................................................................................... 182 23.7. Summary of URC .................................................................................................................... 184 23.8. SMS Character Sets Conversions .......................................................................................... 186 BG95&BG77&BG600L_Series_AT_Commands_Manual 7 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Table Index Table 1: Applicable Modules ........................................................................................................................ 9 Table 2: Types of AT Commands and Responses .................................................................................... 10 Table 3: AT&V Response........................................................................................................................... 19 Table 4: The Numeric Equivalents and Brief Description of ATV0 and ATV1 Result Codes.................... 23 Table 5: DFOTA Related AT Command .................................................................................................. 163 Table 6: FTP(S) Related AT Commands ................................................................................................. 164 Table 7: HTTP(S) Related AT Commands .............................................................................................. 165 Table 8: TCP/IP Related AT Commands ................................................................................................. 166 Table 9: GNSS Related AT Commands .................................................................................................. 167 Table 10: SSL Related AT Commands.................................................................................................... 168 Table 11: FILE Related AT Commands ................................................................................................... 169 Table 12: MQTT Related AT Commands ................................................................................................ 170 Table 13: CoAP Related AT Commands ................................................................................................. 171 Table 14: LwM2M Related AT Commands .............................................................................................. 172 Table 15: Related Documents.................................................................................................................. 175 Table 16: Terms and Abbreviations ......................................................................................................... 175 Table 17: Factory Default Settings Restorable with AT&F ...................................................................... 177 Table 18: AT Command Settings Storable with AT&W ........................................................................... 179 Table 19: AT Command Settings Restorable with ATZ ........................................................................... 180 Table 20: Different Coding Schemes of +CME ERROR: ............................................................... 181 Table 21: Different Coding Schemes of +CMS ERROR: ............................................................... 182 Table 22: Summary of URC ..................................................................................................................... 184 Table 23: The Way of SMS Text Input or Output..................................................................................... 186 Table 24: The Input Conversions Table (DCS=GSM 7 bit and AT+CSCS='GSM') ............................... 186 Table 25: The Output Conversions Table (DCS=GSM 7 bit and AT+CSCS='GSM') ............................ 187 Table 26: GSM Extended Characters (GSM Encode) ............................................................................. 188 Table 27: The Input Conversions Table (DCS=GSM 7 bit and AT+CSCS='IRA') ................................. 189 Table 28: IRA Extended Characters ........................................................................................................ 189 Table 29: The Output Conversions Table (DCS=GSM 7 bit and AT+CSCS='IRA')............................... 190 Table 30: GSM Extended Characters (ISO-8859-1/Unicode) ................................................................. 191 BG95&BG77&BG600L_Series_AT_Commands_Manual 8 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 1 Introduction 1.1. Scope of the Document This document presents the AT commands set supported by the following Quectel eMTC/NB-IoT modules: Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS NOTES 1. '*' means under development. 2. Hereinafter, BG95 series is collectively called BG95 unless otherwise specified. 1.2. Definitions BG95&BG77&BG600L_Series_AT_Commands_Manual 9 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on command line. When an optional parameter is omitted, the new value equals its previous value or its default setting, unless otherwise specified.  Underline Default setting of a parameter. 1.3. AT Command Syntax The AT or at prefix must be set at the beginning of each command line. Entering will terminate a command line. Commands are usually followed by a response that includes . Throughout this document, only the responses are presented, are omitted intentionally. The AT command set implemented by BG95/BG77/BG600L-M3 is a combination of 3GPP TS 27.007, 3GPP TS 27.005 and ITU-T recommendation V.25ter as well as the AT Commands developed by Quectel. All these AT commands can be split into three categories syntactically: 'Basic', 'S parameter', and 'Extended'. They are listed as follows:  Basic syntax These AT commands have the format of AT, or AT&, where is the command, and is/are the argument(s) for that command. An example of this is ATE, which tells the DCE whether received characters should be echoed back to the DTE according to the value of . is optional and a default will be used if it is null.  S parameter syntax These AT commands have the format of ATS=, where is the index of the S register to set, and is the value to assign to it.  Extended syntax These commands can be operated in several modes, as shown in the following table: Table 2: Types of AT Commands and Responses Test Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or BG95&BG77&BG600L_Series_AT_Commands_Manual 10 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual internal processes. Read Command Write Command Execution Command AT+? This command returns the currently set value of the parameter or parameters. AT+=[ This command sets the user-definable parameter ,[,[...]]] values. AT+ This command reads non-variable parameters affected by internal processes in the module. 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 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 =?. 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, ERROR will be returned. Optional parameters, unless explicitly stated, need to be provided up to the last parameter being entered. 1.4. 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 BG95&BG77&BG600L_Series_AT_Commands_Manual 11 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 1.5. Supported Character Sets BG95/BG77/BG600L-M3 AT command interface uses the GSM character set by default. BG95/BG77/BG600L-M3 module supports the following character sets:  GSM format  UCS2  IRA The character set can be configured and interrogated by using the AT+CSCS command (3GPP TS 27.007) and it is defined in 3GPP TS 27.005. The character set affects transmission and reception of SMS and SMS Cell Broadcast Messages, as well as the entry and display of phone book entries text field. 1.6. AT Command Interface BG95/BG77/BG600L-M3 AT command interface includes one USB MODEM port and one main UART port. The main UART port and the USB MODEM port support AT command communication and data transfer. 1.7. Unsolicited Result Code As an Unsolicited Result Code and a report message, URC is not issued as part of the response related to an executed AT command. URC is issued by BG95/BG77/BG600L-M3 without being requested by the TE and it is issued automatically when a certain event occurs. Typical events leading to URCs are incoming calls (RING), received short messages, high/low voltage alarm, high/low temperature alarm, etc. 1.8. Turn off Procedure It is recommended to execute AT+QPOWD command to power off the module, as it is the safest and best way. This procedure is realized by letting the module log off from the network and allowing the software to enter a secure and safe data state before disconnecting the power supply. After sending AT+QPOWD, do not enter any other AT commands. When the command is executed successfully, the module will output POWERED DOWN and set the STATUS pin as low to enter power-off state. In order to avoid data loss, it is suggested to wait for 1s at least to disconnect the power supply after the STATUS pin is set as low and the URC POWERED DOWN is outputted. If POWERED DOWN cannot be received within 65s, the power supply shall be disconnected compulsorily. BG95&BG77&BG600L_Series_AT_Commands_Manual 12 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 2 General Commands 2.1. ATI Display Product Identification Information This command delivers the product identification information text. ATI Display Product Identification Information Execution Command ATI Response Quectel Revision: Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter Identifier of product type. Identification text of product firmware version Example ATI Quectel BG95M2 Revision: BG95M2LAR01A01 OK BG95&BG77&BG600L_Series_AT_Commands_Manual 13 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 2.2. AT+GMI Request Manufacturer Identification This command returns the manufacturer identification text. It is identical with AT+CGMI in Chapter 2.5. AT+GMI Request Manufacturer Identification Test Command AT+GMI=? Execution Command AT+GMI Response OK Response TA reports one or more lines of information text which permits the user to identify the manufacturer. Quectel Maximum Response Time Characteristics Reference V.25ter OK 300 ms / 2.3. AT+GMM Request Model Identification This command returns the product model identification text. It is identical with AT+CGMM in Chapter 2.6. AT+GMM Request Model Identification Test Command AT+GMM=? Execution Command AT+GMM Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter Identifier of product type. BG95&BG77&BG600L_Series_AT_Commands_Manual 14 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 2.4. AT+GMR Request Firmware Version Identification This command returns the identification text of product firmware version. It is identical with AT+CGMR in Chapter 2.7. AT+GMR Request Firmware Version Identification Test Command AT+GMR=? Execution Command AT+GMR Response OK Response TA reports one line of information text which permits the user to identify the firmware version. Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter Identification text of product firmware version. Example AT+GMR BG95M2LAR01A01 OK 2.5. AT+CGMI Request Manufacturer Identification This command returns the manufacturer identification text. It is identical with AT+GMI in Chapter 2.2. AT+CGMI Request Manufacturer Identification Test Command AT+CGMI=? Execution Command AT+CGMI Response OK Response Quectel BG95&BG77&BG600L_Series_AT_Commands_Manual 15 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / 2.6. AT+CGMM Request Model Identification This command returns the model identification text of the product. It is identical with AT+GMM in Chapter 2.3. AT+CGMM Request Model Identification Test Command AT+CGMM=? Execution Command AT+CGMM Response OK Response Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter Identifier of product type. 2.7. AT+CGMR Request Firmware Version Identification This command returns the identification text of the product firmware version. It is identical with AT+GMR in Chapter 2.4. AT+CGMR Request Firmware Version Identification Test Command AT+CGMR=? Response OK BG95&BG77&BG600L_Series_AT_Commands_Manual 16 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Execution Command AT+CGMR Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response OK 300 ms / Parameter Identification text of product firmware version. 2.8. AT+GSN Request International Mobile Equipment Identity (IMEI) This command returns the International Mobile Equipment Identity (IMEI) number of the product in information text which permits the user to identify the individual ME device. It is identical with AT+CGSN in Chapter 2.9. AT+GSN Request International Mobile Equipment Identity (IMEI) Test Command AT+GSN=? Execution Command AT+GSN Response OK Response Maximum Response Time Characteristics Reference V.25ter OK 300 ms / Parameter IMEI number of the ME. BG95&BG77&BG600L_Series_AT_Commands_Manual 17 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual NOTE The IMEI can be used to identify ME since it is unique to each ME. 2.9. AT+CGSN Request International Mobile Equipment Identity (IMEI) This command returns the International Mobile Equipment Identity (IMEI) of the ME. It is identical with AT+GSN above. AT+CGSN Request International Mobile Equipment Identity (IMEI) Test Command AT+CGSN=? Execution Command AT+CGSN Response OK Response Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter IMEI number of the ME. NOTE The IMEI can be used to identify ME since it is unique to each ME. 2.10. AT&F Reset All AT Command Settings to Factory Settings This command resets all current AT command settings to the default values specified by the manufacturer. Refer to Table 17 for the list of supported AT commands. BG95&BG77&BG600L_Series_AT_Commands_Manual 18 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT&F Reset All AT Command Settings to Factory Settings Execution Command AT&F[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Set all current AT command settings to factory setting 2.11. AT&V Display Current Configuration This command displays the current settings of some AT command parameters (see Table 2), including the single-letter AT command parameters which are not readable otherwise. AT&V Display Current Configuration Execution Command AT&V Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Table 3: AT&V Response AT&V &C: 1 &D: 2 &F: 0 &W: 0 Q: 0 V: 1 X: 4 Z: 0 BG95&BG77&BG600L_Series_AT_Commands_Manual 19 / 192 E: 1 S0: 0 S4: 10 S5: 8 S6: 2 S7: 0 S8: 2 S10: 15 S3: 13 OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 2.12. AT&W Store Current AT Command Settings to User-defined Profile This command stores the current AT command settings to a user-defined profile in non-volatile memory. The AT command settings will be automatically restored from the user-defined profile during power-up or if ATZ is executed. Refer to Table 18 for the list of supported AT commands. AT&W Store Current AT Command Settings to User-defined Profile Execution Command AT&W[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Profile number to store the current AT command settings 2.13. ATZ Restore All AT Command Settings from User-defined Profile This command first resets the AT command settings to factory settings, which is similar to AT&F. Afterwards, the AT command settings are restored from the user-defined profile in the non-volatile memory if they have been stored with AT&W before. Any additional AT command on the same command line may be ignored. BG95&BG77&BG600L_Series_AT_Commands_Manual 20 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Refer to Table 19 for the list of supported AT commands. ATZ Restore All AT Command Settings from User-defined Profile Execution Command ATZ[] Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter Parameter Integer type. 0 Reset to profile number 0 2.14. ATQ Set Result Code Presentation Mode This command controls whether the result code is transmitted to the TE. Other information text transmitted as response is not affected by this setting. ATQ Set Result Code Presentation Mode Execution Command ATQ Response If =0: OK Maximum Response Time Characteristics Reference V.25ter If =1: (none) 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. 0 TA transmits result code 1 Result codes are suppressed and not transmitted BG95&BG77&BG600L_Series_AT_Commands_Manual 21 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 2.15. ATV TA Response Format This command determines the contents of header and trailer transmitted with AT command result codes and information responses. The numeric equivalents and brief descriptions of the use of result code are listed in the following table. ATV TA Response Format Execution Command ATV Response When =0: 0 Maximum Response Time Characteristics Reference V.25ter When =1: OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. 0 Information response: Short result code format: 1 Information response: Long result code format: Example ATV1 OK AT+CSQ +CSQ: 30,99 OK ATV0 0 AT+CSQ +CSQ: 30,99 0 //Set =1. //When =1, the result code is OK. //Set =0. //When =0, the result code is 0. BG95&BG77&BG600L_Series_AT_Commands_Manual 22 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Table 4: The Numeric Equivalents and Brief Description of ATV0 and ATV1 Result Codes ATV1 OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY NO ANSWER ATV0 0 1 2 3 4 6 7 8 Description Acknowledges execution of a command. A connection has been established. The DCE is swtiching from command mode to data mode. The DCE has detected an incoming call signal from network. The connection has been terminated or the attempt to establish a connection failed. Command not recognized, command line maximum length exceeded, parameter value invalid, or other problem with processing the command line. No dial tone detected. Engaged (busy) signal detected. @ (Wait for Quiet Answer) dial modifier was used, but remote ringing followed by five seconds of silence was not detected before expiration of the connection timer (S7). 2.16. ATE Set Command Echo Mode This command controls whether or not the module echoes characters received from TE during AT command mode. ATE Set Command Echo Mode Execution Command ATE Maximum Response Time Characteristics Reference V.25ter Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. Whether to echo the characters received from TE. 0 Echo mode OFF 1 Echo mode ON BG95&BG77&BG600L_Series_AT_Commands_Manual 23 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 2.17. A/ Repeat Previous Command Line This command repeats previous AT command line, and '/' acts as the line termination character. A/ Repeat Previous Command Line Execution Command A/ Response Repeat the previous command Characteristics / Reference V.25ter Example ATI Quectel BG95M2 Revision: BG95M2LAR01A01 OK A/ Quectel BG95M2 Revision: BG95M2LAR01A01 OK //Repeat the previous command. 2.18. ATS3 Set Command Line Termination Character This command determines the character recognized by the module to terminate an incoming command line. It is also generated for result codes and information text, along with character value set via ATS4. ATS3 Set Command Line Termination Character Read Command ATS3? Response Write Command ATS3= Maximum Response Time OK Response OK 300 ms BG95&BG77&BG600L_Series_AT_Commands_Manual 24 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Characteristics Reference V.25ter The command takes effect immediately. The configuration is not saved. Parameter Integer type. Command line termination character. Range: 0–127. Default value: 13 (13=). 2.19. ATS4 Set Response Formatting Character This command determines the character generated by the module for result code and information text, along with the command line termination character set via ATS3. ATS4 Set Response Formatting Character Read Command ATS4? Response Write Command ATS4= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Response formatting character. Range: 0–127. Default value: 10 (10=). 2.20. ATS5 Set Command Line Editing Character This command determines the character value used by the module to delete the immediately preceding character from the AT command line (i.e. equates to backspace key). BG95&BG77&BG600L_Series_AT_Commands_Manual 25 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual ATS5 Set Command Line Editing Character Read Command ATS5? Response Write Command ATS5= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Command line editing character Range: 0–127. Default value: 8 (8=). 2.21. ATX Set CONNECT Result Code Format and Monitor Call Progress This command determines whether or not the module transmits particular result codes to the TE. It also controls whether or not the module detects the presence of a dial tone when it begins dialing and the engaged tone (busy signal). ATX Set CONNECT Result Code Format and Monitor Call Progress Execution Command ATX Response OK Maximum Response Time 300 ms Characteristics Reference V.25ter The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. 0 CONNECT result code is returned only. Dial tone and busy signal detection are both disabled. BG95&BG77&BG600L_Series_AT_Commands_Manual 26 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 1 CONNECT result code is returned only. Dial tone and busy signal detection are both disabled. 2 CONNECT result code is returned. Dial tone detection is enabled, while busy signal detection is disabled. 3 CONNECT result code is returned. Dial tone detection is disabled, while busy signal detection is enabled. 4 CONNECT result code is returned. Dial tone and busy signal detection are both enabled. 2.22. AT+CFUN Set UE Functionality This command controls the functionality level of the UE. It can also be used to reset the UE. AT+CFUN Set UE Functionality Test Command AT+CFUN=? Response +CFUN: (list of supported s),(list of supported s) Read Command AT+CFUN? OK Response +CFUN: Write Command AT+CFUN=[,] OK Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 15 s, determined by the network. / Parameter Integer type. 0 Minimum functionality BG95&BG77&BG600L_Series_AT_Commands_Manual 27 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 1 Full functionality 4 Disable the UE from both transmitting and receiving RF signals Integer type. 0 Do not reset the UE before setting it to functionality level. 1 Reset the UE before setting it to functionality level. The device is fully functional after the reset. This value is available only for =1. Integer type. Error code. Refer to Table 20 for possible values. Example AT+CFUN=0 OK AT+COPS? +COPS: 2 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN=1234 OK +CPIN: READY +QUSIM: 1 +QIND: SMS DONE AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE CMCC',8 OK //Switch the UE to minimum functionality. //No operator is registered. //(U)SIM failure. //Switch the UE to full functionality. //Operator is registered. BG95&BG77&BG600L_Series_AT_Commands_Manual 28 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 2.23. AT+CMEE Error Message Format This command controls the format of error result codes: ERROR, error numbers or verbose messages as +CME ERROR: and +CMS ERROR: . AT+CMEE Error Message Format Test Command AT+CMEE=? Response +CMEE: (range of supported s) Read Command AT+CMEE? OK Response +CMEE: Write Command AT+CMEE= Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response TA disables or enables the use of result code +CME ERROR: or +CMS ERROR: as an indication of an error related to the functionality of the ME. OK 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. 0 Disable result code and use ERROR instead 1 Enable result code and use numeric values 2 Enable result code and use verbose values Integer type. Error code. Refer to Table 20 and Table 21 for possible values. Example AT+CMEE=0 OK AT+CPIN? ERROR AT+CMEE=1 OK AT+CPIN? //Disable result code. //Only ERROR will be displayed. //Enable error result code with numeric values. BG95&BG77&BG600L_Series_AT_Commands_Manual 29 / 192 +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN? +CME ERROR: SIM not inserted LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Enable error result code with verbose (string) values. 2.24. AT+CSCS Select TE Character Set The Write Command informs the module which character set is used by the TE. This enables the UE to convert character strings correctly between TE and UE character sets. AT+CSCS Select TE Character Set Test Command AT+CSCS=? Response +CSCS: (list of supported s) Read Command AT+CSCS? OK Response +CSCS: Write Command AT+CSCS= OK Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter String type. Character set 'GSM' GSM default alphabet 'IRA' International reference alphabet 'UCS2' UCS2 alphabet BG95&BG77&BG600L_Series_AT_Commands_Manual 30 / 192 Example AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Query the current character set. //Set the character set to UCS2. 2.25. AT+QURCCFG Configure URC Indication Option This command configures the output port of URC. AT+QURCCFG Configure URC Indication Option Test Command AT+QURCCFG=? Response +QURCCFG: 'urcport',(list of supported s) Write Command AT+QURCCFG='urcport'[,] OK Response If the optional parameter is omitted, the command returns the current configuration. +QURCCFG: 'urcport', OK If the optional parameter is specified, the command sets the URC output port. OK Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. BG95&BG77&BG600L_Series_AT_Commands_Manual 31 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter String type. URC output port. 'usbmodem' USB modem port 'uart1' Main UART Example AT+QURCCFG=? +QURCCFG: 'urcport',('usbmodem','uart1') OK AT+QURCCFG='urcport','usbmodem' OK AT+QURCCFG='urcport' +QURCCFG: 'urcport','usbmodem' OK BG95&BG77&BG600L_Series_AT_Commands_Manual 32 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 3 Serial Interface Control Commands 3.1. AT&C Set DCD Behavior This command controls the behavior of the UE’s DCD line. It determines how the state of circuit 109 (DCD) relates to the detection of received line signal from the distant end. AT&C Set DCD Behavior Execution Command AT&C[] Maximum Response Time Characteristics Reference V.25ter Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. 0 DCD function is always ON 1 DCD function is ON only in the presence of data carrier 3.2. AT&D Set DTR Behavior This command determines how the TA responds when circuit 108/2 (DTR) is changed from low to high level during data mode. AT&D Set DTR Behavior Execution Command AT&D[] Maximum Response Time Characteristics Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. BG95&BG77&BG600L_Series_AT_Commands_Manual 33 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Reference V.25ter Parameter Integer type. 0 TA ignores status on DTR. 1 LowHigh on DTR: Change to command mode while remaining the connected call. 2 LowHigh on DTR: Disconnect data call, and change to command mode. When DTR is in high level, auto-answer function is disabled. 3.3. AT+IFC Set TE-TA Local Flow Control This command controls the flow control behavior of the serial port. AT+IFC Set TE-TA Local Flow Control Test Command AT+IFC=? Response +IFC: (list of supported s),(list of supported s) Read Command AT+IFC? OK Response +IFC: , Write Command AT+IFC=, OK Response This parameter setting determines the data flow control on the UART interface for data mode. OK Maximum Response Time Characteristics Reference V.25ter If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. BG95&BG77&BG600L_Series_AT_Commands_Manual 34 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. Specifies the method to be used by TE when receiving data from TA 0 None 2 RTS flow control Integer type. Specifies the method that will be used by TA when receiving data from TE 0 None 2 CTS flow control Example AT+IFC=2,2 OK AT+IFC? +IFC: 2,2 OK //Enable hardware flow control. 3.4. AT+ICF Set TE-TA Character Framing This command determines the serial interface character framing format and parity received by TA from TE. AT+ICF Set TE-TA Character Framing Test Command AT+ICF=? Response +ICF: (list of supported s),(range of supported s) Read Command AT+ICF? OK Response +ICF: , Write Command AT+ICF=[,] OK Response OK Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. BG95&BG77&BG600L_Series_AT_Commands_Manual 35 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Reference V.25ter The configuration is not saved. Parameter Integer type. 3 8 data; 0 parity; 1 stop Integer type. 0 Odd 1 Even 2 Mark (1) 3 Space (0) NOTES 1. This command is valid only in command mode. 2. The field is ignored if no parity is specified in the field. 3.5. AT+IPR Set TE-TA Fixed Local Rate This command queries and sets the baud rate of the UART. The specified rate takes effect following the issuance of any result code(s) associated with the current command line. AT+IPR Set TE-TA Fixed Local Rate Test Command AT+IPR=? Response +IPR: (list of supported auto-detectable s),(list of supported fixed-only s) Read Command AT+IPR? OK Response +IPR: Write Command AT+IPR= OK Response OK Maximum Response Time If there is any other error: ERROR 300 ms BG95&BG77&BG600L_Series_AT_Commands_Manual 36 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Characteristics Reference V.25ter The command takes effect immediately. The configurations can be saved with AT&W. Parameter Integer type. Baud rate per second. Unit: bps. 9600 19200 38400 57600 115200 230400 460800 921600 2900000 3000000 3200000 3686400 4000000 NOTES 1. If a fixed baud rate is set, please make sure that both TE (DTE, usually the external processor) and TA (DCE, Quectel module) are configured to the same rate. 2. The value of AT+IPR cannot be restored with AT&F and ATZ, but it is still storable with AT&W. 3. In multiplex mode, the baud rate cannot be changed by the Write Command AT+IPR=, and the setting will be invalid and cannot be stored even if AT&W is executed after the Write Command. 4. A selected baud rate takes effect after the Write Command is executed and acknowledged by OK. Example AT+IPR=115200 OK AT&W OK AT+IPR? +IPR: 115200 OK AT+IPR=115200;&W //Specify the fixed baud rate as 115200 bps. //Store the current setting, that is, remain the default baud rate per second as 115200 bps after module resetting. //Specify the fixed baud rate as 115200 bps and store the current setting. BG95&BG77&BG600L_Series_AT_Commands_Manual 37 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual OK 3.6. AT+QRIR Restore MAIN_RI Behavior to Inactive If the MAIN_RI (ring indication signal) behavior is 'always', it can be restored to be inactive by the Execution Command. The RI behavior is controlled by AT+QCFG. Refer to AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming', and AT+QCFG='urc/ri/other' for more details. AT+QRIR Restore RI Behavior to Inactive Test Command AT+QRIR=? Execution Command AT+QRIR Response OK Response OK Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / BG95&BG77&BG600L_Series_AT_Commands_Manual 38 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 4 Status Control Commands 4.1. AT+CPAS Query ME Activity Status This Execution Command queries the activity status of ME. AT+CPAS Query ME Activity Status Test Command AT+CPAS=? Response +CPAS: (list of supported s) Execution Command AT+CPAS OK Response TA returns the activity status of ME: +CPAS: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms / Parameter Integer type. ME activity status. 0 Ready 3 Ringing 4 Call in progress or call hold Integer type. Error code. Refer to Table 20 for possible values. BG95&BG77&BG600L_Series_AT_Commands_Manual 39 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Example AT+CPAS +CPAS: 0 OK RING AT+CLCC +CLCC: 1,1,4,0,0,'15695519173',161 OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0, '10010',129 OK AT+CPAS +CPAS: 4 OK //ME is ready. //ME is ringing. //Call in progress. 4.2. AT+QINDCFG URC Indication Configuration This command controls URC indication. AT+QINDCFG URC Indication Configuration Test Command AT+QINDCFG=? Response +QINDCFG: 'all',(list of supported s),(list of supported s) +QINDCFG: 'csq',(list of supported s),(list of supported s) +QINDCFG: 'smsfull',(list of supported s),(list of supported s) +QINDCFG: 'ring',(list of supported s),(list of supported s) +QINDCFG: 'smsincoming',(list of supported s),(list of supported s) OK BG95&BG77&BG600L_Series_AT_Commands_Manual 40 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Write Command AT+QINDCFG=[ ,[,]] Response If the optional parameters are omitted, return the current configuration: +QINDCFG: , OK If any of the optional parameters is specified, set the URC indication configurations: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. determins whether to save the configuration. Parameter URC type 'all' Main switch of all URCs. is default to be 1 (ON). 'csq' Indication of signal strength and channel bit error rate change. is default to be 0 (OFF). If this configuration is ON, present: +QIND: 'csq',,. See AT+CSQ for details of the URC. 'smsfull' SMS storage full indication. is default to be 0 (OFF). If this configuration is ON, present: +QIND: 'smsfull', String type. SMS storage location 'SM' (U)SIM card 'ME' ME 'ring' RING indication. is default to be 1 (ON). 'smsincoming' Incoming message indication. is default to be 1 (ON). Related URC list: +CMTI, +CMT, +CDS See Table 22 for more details of the URCs. Integer type. URC indication is ON or OFF 0 OFF 1 ON Whether to save the configurations into NVRAM. 0 Not save 1 Save BG95&BG77&BG600L_Series_AT_Commands_Manual 41 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 5 (U)SIM Related Commands 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) This command requests the International Mobile Subscriber Identity (IMSI) which is intended to permit the TE to identify the individual SIM card or active application in the UICC (GSM or USIM) that is attached to MT. AT+CIMI Request International Mobile Subscriber Identity (IMSI) Test Command AT+CIMI=? Execution Command AT+CIMI Response OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: 300 ms / Parameter International Mobile Subscriber Identity (string without double quotes). Integer type. Error code. Refer to Table 20 for possible values. Example AT+CIMI 460023210226023 OK //Query IMSI number of the (U)SIM attached to MT. //The IMSI number of the (U)SIM attached to MT. BG95&BG77&BG600L_Series_AT_Commands_Manual 42 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 5.2. AT+CLCK Facility Lock This command locks, unlocks or interrogates an MT or a network facility . Password is normally needed to do such actions. When querying the status of a network service (=2) the response line for 'not active' case (=0) should be returned only if service is not active for any . The command can be aborted when network facilities are being set or interrogated. The factory default password of PF, PN, PU, PP and PC lock is '12341234'. AT+CLCK Facility Lock Test Command AT+CLCK=? Response +CLCK: (list of supported s) Write Command AT+CLCK=,[,[ ,]] OK Response If is not 2 and the command is set successfully: OK If =2 and the command is set successfully: +CLCK: [,] [+CLCK: [, ]] […] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 5 s The command takes effect immediately. The configuration is saved automatically. Parameter String type. Facility lock type. 'SC' (U)SIM (lock SIM/UICC card installed in the currently selected card slot) (SIM/UICC asks password in MT power-up and when this lock command is issued). 'AO' BAOC (Bar All Outgoing Calls) (see 3GPP TS 22.088 [6] clause 1). 'OI' BOIC (Bar Outgoing International Calls) (see 3GPP TS 22.088 [6] clause 1). 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country) (see 3GPP TS 22.088 [6] clause 1). 'AI' BAIC (Bar All Incoming Calls) (see 3GPP TS 22.088 [6] clause 2). 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (see 3GPP TS 22.088 [6] clause 2). BG95&BG77&BG600L_Series_AT_Commands_Manual 43 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 'AB' All Barring services (see 3GPP TS 22.030 [19]) (applicable only for =0). 'AG' All outGoing barring services (see 3GPP TS 22.030 [19]) (applicable only for =0). 'AC' All inComing barring services (see 3GPP TS 22.030 [19]) (applicable only for =0). 'FD' SIM card or active application in the UICC (GSM or USIM) fixed dialing memory feature (if PIN2 authentication has not been done during the current session, PIN2 is required as ). 'PF' Lock Phone to the very First inserted SIM/UICC card (also referred in the present document as PH-FSIM) (MT asks password when other SIM/UICC cards are inserted). 'PN' Network Personalization (see 3GPP TS 22.022 [33]). 'PU' Network sUbset Personalization (see 3GPP TS 22.022 [33]). 'PP' Service Provider Personalization (see 3GPP TS 22.022 [33]). 'PC' Corporate Personalization (see 3GPP TS 22.022 [33]). Integer type. Operation mode. 0 Unlock 1 Lock 2 Query status String type. Password. This parameter can be omitted when =2. Integer type. A sum of integers each representing a class of information. 1 Voice 2 Data 4 Fax 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization Integer type. Current status of the specified . 0 OFF 1 ON NOTE Only 'SC' lock is supported currently. Example AT+CLCK='SC',2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' //Query the status of (U)SIM card. //The (U)SIM card is unlocked (OFF). //Lock (U)SIM card, and the password is 1234. BG95&BG77&BG600L_Series_AT_Commands_Manual 44 / 192 OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Query the status of (U)SIM card. //The (U)SIM card is locked (ON). //Unlock (U)SIM card. 5.3. AT+CPIN Enter PIN This command sends to the MT a password which is necessary before it can be operated, or queries whether the MT requires a password or not before it can be operated. The password may be (U)SIM PIN, (U)SIM PUK, PH-SIM PIN, etc. After the Write Command is executed, the TA stores the password, such as (U)SIM PIN, (U)SIM PUK, etc., which is necessary before it can be operated. If the PIN is to be entered twice, the TA automatically repeats the PIN. If no PIN request is pending, no action is taken and an error message, +CME ERROR, is returned to TE. If the PIN required is (U)SIM PUK or (U)SIM PUK2, the second pin is required. This second pin, , is used to replace the old pin in the (U)SIM. AT+CPIN Enter PIN Test Command AT+CPIN=? Read Command AT+CPIN? Response OK Response +CPIN: Write Command AT+CPIN=[,] OK Response OK +CPIN: READY Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: 5 s / BG95&BG77&BG600L_Series_AT_Commands_Manual 45 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter String without double quotes. Indicates whether or not a password is required. READY MT is not pending for any password SIM PIN MT is waiting (U)SIM PIN to be given SIM PUK MT is waiting (U)SIM PUK to be given SIM PIN2 MT is waiting (U)SIM PIN2 to be given SIM PUK2 MT is waiting (U)SIM PUK2 to be given PH-NET PIN MT is waiting network personalization password to be given PH-NET PUK MT is waiting network personalization unblocking password to be given PH-NETSUB PIN MT is waiting network subset personalization password to be given PH-NETSUB PUK MT is waiting network subset personalization unblocking password to be given PH-SP PIN MT is waiting service provider personalization password to be given PH-SP PUK MT is waiting service provider personalization unblocking password to be given PH-CORP PIN MT is waiting corporate personalization password to be given PH-CORP PUK MT is waiting corporate personalization unblocking password to be given String type. Password. If the requested password was a PUK, such as (U)SIM PUK1, PH-FSIM PUK or another password, then must be followed by . String type. New password required if the requested code was a PUK. Integer type. Error code. Refer to Table 20 for possible values. Example //Enter PIN AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK //Enter PUK and PIN //Waiting for (U)SIM PIN to be given //Enter PIN //PIN has already been entered BG95&BG77&BG600L_Series_AT_Commands_Manual 46 / 192 AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' OK +CPIN: READY AT+CPIN? +CPIN: READY OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Waiting for (U)SIM PUK to be given //Enter PUK and the new password //PUK has already been entered 5.4. AT+CPWD Change Password The Write Command sets a new password for the facility lock function defined by AT+CLCK. The Test Command returns a list of pairs which present the available facilities and the maximum length of their passwords. AT+CPWD Change Password Test Command AT+CPWD=? Response +CPWD: (list of supported s), Write Command AT+CPWD=,, OK Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 5 s / BG95&BG77&BG600L_Series_AT_Commands_Manual 47 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter String type. Facility lock type. 'SC' (U)SIM (lock SIM/UICC card) (SIM/UICC asks password in MT power-up and when this lock command is issued) 'AO' BAOC (Bar All Outgoing Calls) (see 3GPP TS 22.088 [6] clause 1) 'OI' BOIC (Bar Outgoing International Calls) (see 3GPP TS 22.088 [6] clause 1). 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country) (see 3GPP TS 22.088 [6] clause 1). 'AI' BAIC (Bar All Incoming Calls) (see 3GPP TS 22.088 [6] clause 2). 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (see 3GPP TS 22.088 [6] clause 2). 'AB' All Barring services (see 3GPP TS 22.030 [19]) (applicable only for =0). 'AG' All outGoing barring services (see 3GPP TS 22.030 [19]) (applicable only for =0). 'AC' All inComing barring services (see 3GPP TS 22.030 [19]) (applicable only for =0) 'P2' (U)SIM PIN2 Integer type. Maximum length of password. String type. Password specified for the facility from the user interface or with command. String type. New password. NOTE Only 'SC' lock is supported currently. Example AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' //Change (U)SIM card password to '4321' OK //Restart the module or re-activate the (U)SIM card AT+CPIN? +CPIN: SIM PIN //Waiting (U)SIM PIN to be given OK AT+CPIN='4321' OK //PIN must be entered to define a new password '4321' BG95&BG77&BG600L_Series_AT_Commands_Manual 48 / 192 +CPIN: READY LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 5.5. AT+CRSM Restricted (U)SIM Access This command offers easy and limited access to the (U)SIM database. It transmits the (U)SIM command number () and its required parameters to the MT. AT+CRSM Restricted (U)SIM Access Test Command AT+CRSM=? Write Command AT+CRSM=[,[,,,[,][,]]] Response OK Response +CRSM: ,[,] OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms / Parameter // Integer type. (U)SIM command number. 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS Integer type. Identifier for an elementary data file on (U)SIM, if used by . Integer type. Parameters transferred by the MT to the (U)SIM. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in 3GPP TS 51.011 [28]. Information which shall be written to the (U)SIM (hexadecimal character BG95&BG77&BG600L_Series_AT_Commands_Manual 49 / 192 / LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual format; refer to AT+CSCS). String type. The directory path of an elementary file on the SIM/UICC in hexadecimal format. Integer type. Information from the (U)SIM about the execution of the actual command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command. Response of a successful completion of the command previously issued (hexadecimal character format; refer to AT+CSCS). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. The information includes the type of file and its size (refer to 3GPP TS 51.011 [28]). After READ BINARY, READ RECORD or RETRIEVE DATA command, the requested data will be returned. will not be returned after a successful UPDATE BINARY, UPDATE RECORD or SET DATA command. Integer type. Error code. Refer to Table 20 for possible values. 5.6. AT+QCCID Show ICCID This command returns the ICCID (Integrated Circuit Card Identifier) number of the (U)SIM card. AT+QCCID Show ICCID Test Command AT+QCCID=? Execution Command AT+QCCID Response OK Response +QCCID: OK Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter The ICCID number of the current (U)SIM card. BG95&BG77&BG600L_Series_AT_Commands_Manual 50 / 192 Example AT+QCCID +QCCID: 89860025128306012474 OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Query ICCID of the (U)SIM card 5.7. AT+QPINC Display PIN Remainder Counter This command queries the number of attempts left to enter the password of (U)SIM PIN/PUK. AT+QPINC Display PIN Remainder Counter Test Command AT+QPINC=? Response +QPINC: (list of supported s) Read Command AT+QPINC? OK Response +QPINC: 'SC',, +QPINC: 'P2',, Write Command AT+QPINC= OK Response +QPINC: ,, OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter String type. 'SC' (U)SIM PIN 'P2' (U)SIM PIN2 Number of attempts left to enter the password of PIN. Number of attempts left to enter the password of PUK. BG95&BG77&BG600L_Series_AT_Commands_Manual 51 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Integer type. Error code. Refer to Table 20 for possible values. 5.8. AT+QINISTAT Query Initialization Status of (U)SIM Card This command queries the initialization status of (U)SIM card. AT+QINISTAT Query Initialization Status of (U)SIM Card Test Command AT+QINISTAT=? Response +QINISTAT: (range of supported s) Execution Command AT+QINISTAT OK Response +QINISTAT: Maximum Response Time Characteristics OK 300 ms / Parameter Integer type. Initialization status of (U)SIM card. Actual value is the sum of several of the following three kinds (3 = 1 + 2 means CPIN READY & SMS initialization completed). 0 Initial state 1 CPIN READY. Operation like lock/unlock PIN is allowed 2 SMS initialization completed 5.9. AT+QSIMDET (U)SIM Card Detection This command enables (U)SIM card hot-swap function. (U)SIM card is detected by GPIO interrupt. The level of (U)SIM card detection pin should also be set when the (U)SIM card is inserted. AT+QSIMDET (U)SIM Card Detection Test Command AT+QSIMDET=? Response +QSIMDET: (list of supported s),(list of supported s) Read Command OK Response BG95&BG77&BG600L_Series_AT_Commands_Manual 52 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+QSIMDET? +QSIMDET: , Write Command AT+QSIMDET=, OK Response OK If there is any other error: ERROR Maximum Response Time 300 ms Characteristics This command takes effect after rebooting. The configuration is saved automatically. Parameter Integer type. Enables or disables (U)SIM card detection. 0 Disable 1 Enable Integer type. The level of (U)SIM card detection pin when a (U)SIM card is inserted. 0 Low level 1 High level NOTE Hot-swap function is invalid if the configured value of is inconsistent with hardware design. Example AT+QSIMDET=1,0 //Set (U)SIM card detection pin level as low when (U)SIM card is inserted OK //Remove (U)SIM card +CPIN: NOT READY //Insert (U)SIM card and if PIN1 of the (U)SIM card is unlocked +CPIN: READY 5.10. AT+QSIMSTAT (U)SIM Card Insertion Status Report This command queries (U)SIM card insertion status or determines whether (U)SIM card insertion status report is enabled. BG95&BG77&BG600L_Series_AT_Commands_Manual 53 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+QSIMSTAT (U)SIM Card Insertion Status Report Test Command AT+QSIMSTAT=? Response +QSIMSTAT: (list of supported s) Read Command AT+QSIMSTAT? OK Response +QSIMSTAT: , Write Command AT+QSIMSTAT= OK Response OK Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect after rebooting; The configuration is saved automatically. Parameter Integer type. Enables or disables (U)SIM card insertion status report. If it is enabled, the URC +QSIMSTAT: , will be reported when (U)SIM card is removed or inserted. 0 Disable 1 Enable Integer type. (U)SIM card is inserted or removed. This argument is not allowed to be set. 0 Removed 1 Inserted 2 Unknown, before (U)SIM initialization Example AT+QSIMSTAT? +QSIMSTAT: 0,1 OK AT+QSIMDET=1,0 OK AT+QSIMSTAT=1 OK AT+QSIMSTAT? //Query (U)SIM card insertion status //Enable (U)SIM card insertion status report BG95&BG77&BG600L_Series_AT_Commands_Manual 54 / 192 +QSIMSTAT: 1,1 OK +QSIMSTAT: 1,0 +CPIN: NOT READY AT+QSIMSTAT? +QSIMSTAT: 1,0 OK +QSIMSTAT: 1,1 +CPIN: READY LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Report of (U)SIM card insertion status: removed //Report of (U)SIM card insertion status: inserted BG95&BG77&BG600L_Series_AT_Commands_Manual 55 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 6 Network Service Commands 6.1. AT+CREG Network Registration Status The Write Command controls the presentation of an unsolicited result code +CREG: when =1 and there is a change in the MT’s circuit mode network registration status in GERAN/E-UTRAN, or unsolicited result code +CREG: [,[],[],[]] when =2 and there is a change of the network cell in GERAN/E-UTRAN. AT+CREG Network Registration Status Test Command AT+CREG=? Response +CREG: (range of supported s) Read Command AT+CREG? OK Response +CREG: ,[,,[,]] Write Command AT+CREG[=] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code: +CREG: 2 Enable network registration and location information unsolicited result code: +CREG: [,[],[],[]] BG95&BG77&BG600L_Series_AT_Commands_Manual 56 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Integer type. Circuit mode registration status. 0 Not registered. MT is not currently searching an operator to register to 1 Registered, home network 2 Not registered, but MT is currently trying to attach the network or searching an operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two-byte location area code in hexadecimal format. String type. Four-byte GERAN/E-UTRAN cell ID in hexadecimal format. Integer type. Access technology of the serving cell. 0 GSM 8 eMTC 9 NB-IoT 6.2. AT+COPS Operator Selection This command returns the current operators and their status, and allows automatic or manual network selection. The Test Command returns a set of five parameters, each representing an operator presenting in the network. The set consists of an integer indicating the availability of the operator , long and short alphanumeric format of the name of the operator, numeric format representation of the operator and access technology. Any of the formats may be unavailable and should then be an empty field. The list of operators shall be in the order of: home network, networks referenced in (U)SIM and other networks. The Read Command returns the current mode and the currently selected operator. If no operator is selected, then , and are omitted. The Write Command forces an attempt to select and register the GSM/LTE network operator. If the selected operator is not available, no other operator shall be selected (except =4). The format of selected operator name shall apply to further Read Commands (AT+COPS?). AT+COPS Operator Selection Test Command AT+COPS=? Response +COPS: [(list of supported s,long alphanumeric s,short alphanumeric ,numeric [,])s][,,(list of supported s),(list of supported s)] OK If there is an error related to ME functionality: BG95&BG77&BG600L_Series_AT_Commands_Manual 57 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual +CME ERROR: Read Command AT+COPS? If there is any other error: ERROR Response +COPS: [,[,][,]] OK Write Command AT+COPS=[,[,[,]]] If there is an error related to ME functionality: +CME ERROR: Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time 180 s, determined by the network. Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Unknown 1 Operator available 2 Current operator 3 Operator forbidden String type. Operator in format as per Integer type. 0 Automatic mode. field can be ignored. 1 Manual operator selection. field shall be presented and optionally. 2 Manual deregister from network. 3 Set only (for AT+COPS? Read Command), and do not attempt to register/deregister ( and fields are ignored). This value is invalid in the response of the Read Command. 4 Manual/automatic selection. field shall be presented. If manual selection fails, automatic mode (=0) is entered. Integer type. 0 Long format alphanumeric which can be up to 16 characters. 1 Short format alphanumeric 2 Numeric . GSM location area identification number. BG95&BG77&BG600L_Series_AT_Commands_Manual 58 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Integer type. Access technology selected. 0 GSM 8 eMTC 9 NB-IoT Integer type. Error code. Refer to Table 20 for possible values. Example AT+COPS=? //List all current network operators +COPS: (3,'CHN-UNICOM','UNICOM','46001',0),(3,'CHINA MOBILE','CMCC','46000',0),(1,'CH N-CT','CT','46011',9),,(0,1,2,3,4),(0,1,2) OK AT+COPS? +COPS: 0,0,'CHN-UNICOM',0 //Query the currently selected network operator OK 6.3. AT+CSQ Signal Quality Report The Execution Command returns the received signal strength indication and the channel bit error rate from the ME. AT+CSQ Signal Quality Report Test Command AT+CSQ=? Response +CSQ: (list of supported s),(list of supported s) Execution Command AT+CSQ OK Response +CSQ: , OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: 300 ms / BG95&BG77&BG600L_Series_AT_Commands_Manual 59 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. Received signal strength level. 0 -113 dBm or less 1 -111 dBm 2–30 -109 to -53 dBm 31 -51 dBm or greater 99 Not known or not detectable Integer type. Channel bit error rate (in percent) 0–7 As RxQual values in the table in 3GPP TS 45.008 subclause 8.2.4 99 Not known or not detectable Integer type. Error code. Refer to Table 20 for possible values. Example AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,99 OK //The current signal strength indication is 28 (-57 dBm) and channel bit error rate is 99 (not known or not detectable). NOTE After using the network related commands such as AT+CCWA and AT+CCFC, it is recommended to wait for 3 seconds before entering AT+CSQ so as to ensure that any network access required by the preceding command has been finished. 6.4. AT+CPOL Preferred Operator List This command edits and queries the list of preferred operators. AT+CPOL Preferred Operator List Test Command AT+CPOL=? Response +CPOL: (list of supported s),(range of supported s) Read Command AT+CPOL? OK Response +CPOL: ,,[,,<GSM_comp BG95&BG77&BG600L_Series_AT_Commands_Manual 60 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual act,,] [+CPOL: ,,[,,<GSM_comp act,,] […]] Write Command AT+CPOL=[,[,[,, ,]]] OK Response If all parameters after are omitted, delete the specified entry: OK If specified all parameters, edit the list of preferred operators: OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms Parameter Integer type. The order number of operator in the (U)SIM preferred operator list. Integer type. Format of operator name. 0 Long format alphanumeric 1 Short format alphanumeric 2 Numeric String type. Operation name. indicates the format is alphanumeric or numeric (see AT+COPS) Integer type. GSM access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. GSM compact access technology. 0 Access technology is not selected 1 Access technology is selected Integer type. UTRAN access technology. 0 Access technology is not selected 1 Access technology is selected BG95&BG77&BG600L_Series_AT_Commands_Manual 61 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Integer type. E-UTRAN access technology 0 Access technology is not selected 1 Access technology is selected NOTES 1. The access technology selection parameters , , and are required for SIM cards or UICCs containing PLMN selector with access technology. 2. The parameter is invalid. 6.5. AT+COPN Read Operator Names This command returns the list of operator names from the MT. Each operator code that has an alphanumeric equivalent in the MT memory is returned. AT+COPN Read Operator Names Test Command AT+COPN=? Execution Command AT+COPN Response OK Response +COPN: , [+COPN: , […]] OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: Depends on the number of operator names. / Parameter String type. Operator in numeric format (see AT+COPS). String type. Operator in long alphanumeric format (see AT+COPS). Integer type. Error code. Refer to Table 20 for possible values. BG95&BG77&BG600L_Series_AT_Commands_Manual 62 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 6.6. AT+CTZU Automatic Time Zone Update This command enables/disables automatic time zone update via NITZ. AT+CTZU Automatic Time Zone Update Test Command AT+CTZU=? Response +CTZU: (list of supported s) Read Command AT+CTZU? OK Response +CTZU: Write Command AT+CTZU= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. The mode of automatic time zone update. 0 Disable automatic time zone update via NITZ 1 Enable automatic time zone update via NITZ 3 Enable automatic time zone update via NITZ and update LOCAL time to RTC Example AT+CTZU? +CTZU: 0 OK AT+CTZU=? +CTZU: (0,1,3) OK AT+CTZU=1 OK BG95&BG77&BG600L_Series_AT_Commands_Manual 63 / 192 AT+CTZU? +CTZU: 1 OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 6.7. AT+CPSMS Power Saving Mode Setting This command controls the setting of the UE’s Power Saving Mode (PSM) parameters. AT+CPSMS Power Saving Mode Setting Test Command AT+CPSMS=? Response +CPSMS: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CPSMS? OK Response +CPSMS: ,[],[],[],[] Write Command AT+CPSMS=[[,[,[,[,]]]]] OK Response OK If there is any other error: ERROR Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Disable or enable the use of PSM in the UE. 0 Disable the use of PSM 1 Enable the use of PSM String type. One byte in an 8-bit format. Requested extended BG95&BG77&BG600L_Series_AT_Commands_Manual 64 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual periodic RAU value (T3312) to be allocated to the UE in GERAN. (e.g. '01000111' equals 70 hours) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute String type. One byte in an 8-bit format. Requested GPRS READY timer value (T3314) to be allocated to the UE in GERAN. (e.g. '01001010' equals 1 hours) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated. String type. One byte in an 8-bit format. Requested extended periodic TAU value (T3412) to be allocated to the UE in E-UTRAN. (e.g. '00001010' equals 100 minutes) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute String type. One byte in an 8-bit format. Requested Active Time value (T3324) to be allocated to the UE. (e.g. '00001111' equals 30 seconds) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated. BG95&BG77&BG600L_Series_AT_Commands_Manual 65 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Example AT+CPSMS=1,,,'00000100','00001111' //Set the requested T3412 value to 40 minutes, and set the requested T3324 value to 30 seconds. OK 6.8. AT+QPSMS Power Saving Mode Setting Quectel extended AT command for PSM setting. The Write Command controls the setting of the module’s Power Saving Mode (PSM) parameters. It is similar with AT+CPSMS. AT+QPSMS Power Saving Mode Setting Test Command AT+QPSMS=? Response +QPSMS: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+QPSMS? OK Response +QPSMS: ,[],[],[],[] Write Command AT+QPSMS=[[,[,[,[,]]]]] OK Response OK If there is any other error: ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Disable or enable the use of PSM in the UE. 0 Disable the use of PSM 1 Enable the use of PSM String type. One byte in an 8-bit format. Requested extended BG95&BG77&BG600L_Series_AT_Commands_Manual 66 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual periodic RAU value (T3312) to be allocated to the UE in GERAN. (e.g. '01000111' equals 70 hours) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute String type. One byte in an 8-bit format. Requested GPRS READY timer value (T3314) to be allocated to the UE in GERAN. (e.g. '01001010' equals 1 hours) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated. String type. One byte in an 8-bit format. Requested extended periodic TAU value (T3412) to be allocated to the UE in E-UTRAN. (e.g. '00001010' equals 100 minutes) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute String type. One byte in an 8-bit format. Requested Active Time value (T3324) to be allocated to the UE. (e.g. '00001111' equals 1 minute) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated. Integer type. Extended periodic RAU value (T3312) to be BG95&BG77&BG600L_Series_AT_Commands_Manual 67 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual allocated to the UE in GERAN, and the value is specified by network. Integer type. GPRS READY timer value (T3314) to be allocated to the UE in GERAN, and the value is specified by network. Integer type. Extended periodic TAU value (T3412) to be allocated to the UE in E-UTRAN, and the value is specified by network. Integer type. Active timer value (T3324) to be allocated to the UE in E-UTRAN, and the value is specified by network. Example AT+QPSMS=1,,,'00000100','00001111' //Set the requested T3412 value to 40 minutes, and set the requested T3324 value to 30 seconds. OK AT+QPSMS? +QPSMS: 1,,,'86400','2' //Query the PSM mode and the periodic-TAU and active time specified by the network. OK 6.9. AT+QPSMCFG PSM Feature and Minimum Threshold Value Setting This command sets NV#73769 (PSM configuration) parameters. You can use this AT command to enable or disable PSM function and set the minimum threshold value to enter PSM. AT+QPSMCFG PSM Feature and Minimum Threshold Value Setting Test Command AT+QPSMCFG=? Response +QPSMCFG: (range of supported s),(range of supported s) Read Command AT+QPSMCFG? OK Response +QPSMCFG: , Write Command AT+QPSMCFG=[[,]] OK Response OK If there is any other error: ERROR BG95&BG77&BG600L_Series_AT_Commands_Manual 68 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Minimum threshold value to enter PSM. Range: 20–4294967295. Unit: second. Integer type. Bitmask to indicate PSM modes (1: Enable; 0: Disable). Each bit is configured independently. Range: 0–15. Default value: 4. Bit 0 – PSM without network coordination Bit 1 – Rel-12 PSM without context retention Bit 2 – Rel-12 PSM with context retention Bit 3 – PSM in between eDRX cycles Example AT+QPSMCFG=100 OK AT+QPSMCFG? +QPSMCFG: 100,5 OK //Set the threshold to 100 seconds. //Query the threshold value and PSM mode. 6.10. AT+QPSMEXTCFG Modem Optimization This command configures PSM, and it is mainly used to set extended parameters for modem optimizations. AT+QPSMEXTCFG Modem Optimization Test Command AT+QPSMEXTCFG=? Response +QPSMEXTCFG: (range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s) OK BG95&BG77&BG600L_Series_AT_Commands_Manual 69 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Write Command AT+QPSMEXTCFG=[[,< max_oos_full_scans>[,[,[,[,]]]]]] Read Command AT+QPSMEXTCFG? Response OK If there is any other error: ERROR Response +QPSMEXTCFG: ,,,,, Maximum Response Time Characteristics OK 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Range: 0–15. Default value: 14. 1st bit of the parameter is used to enable/disable (0: disable; 1: enable) PSM ENTER request without sending PSM_READY_REQ to NAS. This is a quick PSM operation. 2nd bit of the parameter is used to enable/disable (0: disable; 1: enable) Out of Service (OoS) status indication from Modem to AP. 3rd bit of the parameter is used to enable/disable (0: disable; 1: enable) limited service status indication from Modem to AP. 4th bit the parameter is used to enable/disable (0: disable; 1: enable) deep-sleep mode if PSM cycle is less than the threshold value. If enabled, it puts the device in deep-sleep mode, if PSM is not entered due to not meeting threshold value. Integer type. Maximum number of full scans to wait before modem declares SYS_PSM_STATUS_OOS to clients. Range: 1–100. Default value: 2. Integer type. PSM cycle used by PSM daemon upon OOS/Limited Service indication, due to service outage. Range: 120–4294967295. Default value: 120. Unit: second. Integer type. PSM wakeup randomization window to avoid network congestion due to all the PSM devices waking up at the same time. Range: 1–1000. Default value: 5. Unit: second. Integer type. Maximum time in seconds to wait before declaring SYS_PSM_STATUS_OOS to clients. Range: 1–65535. Default value: 120. Unit: second. BG95&BG77&BG600L_Series_AT_Commands_Manual 70 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Integer type. Device wakes up early to account for boot-up and acquisition delay. While programming PMIC, PSM daemon reduces PSM cycle by this duration. Range: 1–1000. Default value: 3. Unit: second. Example AT+QPSMEXTCFG=14,2,120 OK AT+QPSMEXTCFG? +QPSMEXTCFG: 14,2,120,5,120,15 OK 6.11. AT+CEDRXS e-I-DRX Setting This command controls the setting of the UE’s e-I-DRX (extended Idle-mode DRX) parameters. AT+CEDRXS e-I-DRX Setting Test Command AT+CEDRXS=? Response +CEDRXS: (range of supported s),(list of support ed s),(list of supported s) Write Command AT+CEDRXS=[[,[, ]]] Read Command AT+CEDRXS? OK Response OK If there is any other error: ERROR Response [+CEDRXS: , [+CEDRXS: , [...]]] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms The command takes effect immediately. The configuration is saved automatically. BG95&BG77&BG600L_Series_AT_Commands_Manual 71 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. Disable or enable the use of e-I-DRX in the UE. 0 Disable the use of e-I-DRX 1 Enable the use of e-I-DRX 2 Enable the use of e-I-DRX and enable the unsolicited result code +CEDRXP: [,[,[,]]] 3 Disable the use of e-I-DRX and discard all parameters for e-I-DRX or, reset to the default values Integer type. The type of access technology. 0 Access technology is not using eDRX. This parameter value is only used in the unsolicited result code. 2 GSM (not applicable) 4 eMTC 5 NB-IoT String type. Half a byte in a 4-bit format. bit 4 321 E-UTRAN e-I-DRX cycle length duration 0 000 5.12 seconds 0 001 10.24 seconds 0 010 20.48 seconds 0 011 40.96 seconds 0 100 61.44 seconds 0 101 81.92 seconds 0 110 102.4 seconds 0 111 122.88 seconds 1 000 143.36 seconds 1 001 163.84 seconds 1 010 327.68 seconds 1 011 655,36 seconds 1 100 1310.72 seconds 1 101 2621.44 seconds 1 110 5242.88 seconds 1 111 10485.76 seconds String type. Half a byte in a 4 bit format. bit 4 321 E-UTRAN e-I-DRX cycle length duration 0 000 5.12 seconds 0 001 10.24 seconds 0 010 20.48 seconds 0 011 40.96 seconds 0 100 61.44 seconds 0 101 81.92 seconds 0 110 102.4 seconds BG95&BG77&BG600L_Series_AT_Commands_Manual 72 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 0 111 122.88 seconds 1 000 143.36 seconds 1 001 163.84 seconds 1 010 327.68 seconds 1 011 655,36 seconds 1 100 1310.72 seconds 1 101 2621.44 seconds 1 110 5242.88 seconds 1 111 10485.76 seconds String type. Half a byte in a 4 bit format. eMTC mode bit 4 321 Paging Time Window length 0 000 1.28 seconds 0 001 2.56 seconds 0 010 3.84 seconds 0 011 5.12 seconds 0 100 6.4 seconds 0 101 7.68 seconds 0 110 8.96 seconds 0 111 10.24 seconds 1 000 11.52 seconds 1 001 12.8 seconds 1 010 14.08 seconds 1 011 15.36 seconds 1 100 16.64 seconds 1 101 17.92 seconds 1 110 19.20 seconds 1 111 20.48 seconds NB-IoT mode bit 4 321 Paging Time Window length 0 000 2.56 seconds 0 001 5.12 seconds 0 010 7.68 seconds 0 011 10.24 seconds 0 100 12.8 seconds 0 101 15.36 seconds 0 110 17.92 seconds 0 111 20.48 seconds 1 000 23.04 seconds 1 001 25.6 seconds 1 010 28.16 seconds 1 011 30.72 seconds BG95&BG77&BG600L_Series_AT_Commands_Manual 73 / 192 Example AT+CEDRXS=1,5,'0000' OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 1 100 1 101 1 110 1 111 33.28 seconds 35.84 seconds 38.4 seconds 40.96 seconds //Set the requested e-I-DRX value to 5.12 seconds. NOTE =2 is not supported currently. 6.12. AT+QPTWEDRXS Paging Time Window Value and eDRX Setting This command controls the setting of the UE's paging time window (PTW) value and eDRX parameters, and whether the UE wants to apply PTW and eDRX or not, as well as the requested PTW and eDRX cycle for each specified type of access technology. It also controls the presentation of the URC +QPTWEDRXP: [,[,[,[,]]]] when =2 and there is a change in the paging time window and eDRX parameters provided by the network. A special form of the command can be given as AT+QPTWEDRXS=3. In this form, paging time window and eDRX will be disabled and data for all parameters in AT+QPTWEDRXS will be removed or, if available, set to the default values. The Read Command returns the current settings for each defined value of . The Test Command returns the supported s and the value ranges for the access technology and the requested paging time window and requested eDRX value as compound values. AT+QPTWEDRXS Test Command AT+QPTWEDRXS=? Paging Time Window Value and eDRX Setting Response +QPTWEDRXS: (range of supported s),(list of supported s),(list of supported s),(list of supported s) BG95&BG77&BG600L_Series_AT_Commands_Manual 74 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Read Command AT+QPTWEDRXS? OK Response +QPTWEDRXS: ,,[,[,]] OK If there is any error: +CME ERROR: Write Command AT+QPTWEDRXS=[,[, [,]]] If there is any other error: ERROR Response OK If there is any error: +CME ERROR: Maximum Response Time Characteristics Reference If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Indicates to disable or enable the use of requested paging time window and eDRX in the UE. This parameter is applicable to all specified types of access technology, i.e. the most recent setting of will take effect for all specified values of returned by AT+QNWINFO. 0 Disable the use of requested paging time window and eDRX 1 Enable the use of requested paging time window and eDRX 2 Enable the use of requested paging time window and eDRX, and enable the URC: +QPTWEDRXP: [,[,< Requested_eDRX_value>[,[,]]]] 3 Disable the use of eDRX and discard all parameters for eDRX or, if available, reset to the default values. Integer type. Indicates the type of access technology. This AT command is BG95&BG77&BG600L_Series_AT_Commands_Manual 75 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual used to specify the relationship between the type of access technology and the requested eDRX value. 0 Access technology is not using eDRX. This parameter value is only used in the unsolicited result code. 2 GSM (not applicable) 4 eMTC 5 NB-IoT String type. Half a byte in a 4-bit format. eMTC mode Bit 4 3 2 1 Paging Time Window length 0 0 0 0 1.28 seconds 0 0 0 1 2.56 seconds 0 0 1 0 3.84 seconds 0 0 1 1 5.12 seconds 0 1 0 0 6.4 seconds 0 1 0 1 7.68 seconds 0 1 1 0 8.96 seconds 0 1 1 1 10.24 seconds 1 0 0 0 11.52 seconds 1 0 0 1 12.8 seconds 1 0 1 0 14.08 seconds 1 0 1 1 15.36 seconds 1 1 0 0 16.64 seconds 1 1 0 1 17.92 seconds 1 1 1 0 19.20 seconds 1 1 1 1 20.48 seconds NB-IoT mode Bit 4 3 2 1 Paging Time Window length 0 0 0 0 2.56 seconds 0 0 0 1 5.12 seconds 0 0 1 0 7.68 seconds 0 0 1 1 10.24 seconds 0 1 0 0 12.8 seconds 0 1 0 1 15.36 seconds 0 1 1 0 17.92 seconds 0 1 1 1 20.48 seconds 1 0 0 0 23.04 seconds 1 0 0 1 25.6 seconds 1 0 1 0 28.16 seconds 1 0 1 1 30.72 seconds 1 1 0 0 33.28 seconds 1 1 0 1 35.84 seconds BG95&BG77&BG600L_Series_AT_Commands_Manual 76 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 1 1 1 0 38.4 seconds 1 1 1 1 40.96 seconds String type. Half a byte in a 4-bit format. Bit 4 3 2 1 E-UTRAN eDRX cycle length duration 0 0 0 0 5.12 seconds 0 0 0 1 10.24 seconds 0 0 1 0 20.48 seconds 0 0 1 1 40.96 seconds 0 1 0 0 61.44 seconds 0 1 0 1 81.92 seconds 0 1 1 0 102.4 seconds 0 1 1 1 122.88 seconds 1 0 0 0 143.36 seconds 1 0 0 1 163.84 seconds 1 0 1 0 327.68 seconds 1 0 1 1 655.36 seconds 1 1 0 0 1310.72 seconds 1 1 0 1 2621.44 seconds 1 1 1 0 5242.88 seconds 1 1 1 1 10485.76 seconds String type. Half a byte in a 4-bit format. Bit 4 3 2 1 E-UTRAN eDRX cycle length duration 0 0 0 0 5.12 seconds 0 0 0 1 10.24 seconds 0 0 1 0 20.48 seconds 0 0 1 1 40.96 seconds 0 1 0 0 61.44 seconds 0 1 0 1 81.92 seconds 0 1 1 0 102.4 seconds 0 1 1 1 122.88 seconds 1 0 0 0 143.36 seconds 1 0 0 1 163.84 seconds 1 0 1 0 327.68 seconds 1 0 1 1 655.36 seconds 1 1 0 0 1310.72 seconds 1 1 0 1 2621.44 seconds 1 1 1 0 5242.88 seconds 1 1 1 1 10485.76 seconds String type. Half a byte in a 4-bit format. eMTC mode Bit 4 3 2 1 Paging Time Window length BG95&BG77&BG600L_Series_AT_Commands_Manual 77 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 0 0 0 0 1.28 seconds 0 0 0 1 2.56 seconds 0 0 1 0 3.84 seconds 0 0 1 1 5.12 seconds 0 1 0 0 6.4 seconds 0 1 0 1 7.68 seconds 0 1 1 0 8.96 seconds 0 1 1 1 10.24 seconds 1 0 0 0 11.52 seconds 1 0 0 1 12.8 seconds 1 0 1 0 14.08 seconds 1 0 1 1 15.36 seconds 1 1 0 0 16.64 seconds 1 1 0 1 17.92 seconds 1 1 1 0 19.20 seconds 1 1 1 1 20.48 seconds NB-IoT mode Bit 4 3 2 1 Paging Time Window length 0 0 0 0 2.56 seconds 0 0 0 1 5.12 seconds 0 0 1 0 7.68 seconds 0 0 1 1 10.24 seconds 0 1 0 0 12.8 seconds 0 1 0 1 15.36 seconds 0 1 1 0 17.92 seconds 0 1 1 1 20.48 seconds 1 0 0 0 23.04 seconds 1 0 0 1 25.6 seconds 1 0 1 0 28.16 seconds 1 0 1 1 30.72 seconds 1 1 0 0 33.28 seconds 1 1 0 1 35.84 seconds 1 1 1 0 38.4 seconds 1 1 1 1 40.96 seconds Integer type. Error code. Refer to Table 20 for possible values. 6.13. AT+CEDRXRDP Read Dynamic Parameters The Execution Command returns , , and if e-I-DRX is used for the cell that the MS is currently registered to. BG95&BG77&BG600L_Series_AT_Commands_Manual 78 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CEDRXRDP Read Dynamic Parameters Test Command AT+CEDRXRDP=? Execution Command AT+CEDRXRDP Response OK Response +CEDRXRDP: [,[,< NW-provided_eDRX_value>[,]]] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms / Parameter Integer type. The type of access technology. 0 Access technology is not using eDRX 2 GSM (not applicable) 4 eMTC 5 NB-IoT String type. Half a byte in a 4 bit format. bit 4 321 E-UTRAN e-I-DRX cycle length duration 0 000 5.12 seconds 0 001 10.24 seconds 0 010 20.48 seconds 0 011 40.96 seconds 0 100 61.44 seconds 0 101 81.92 seconds 0 110 102.4 seconds 0 111 122.88 seconds 1 000 143.36 seconds 1 001 163.84 seconds 1 010 327.68 seconds 1 011 655,36 seconds 1 100 1310.72 seconds 1 101 2621.44 seconds 1 110 5242.88 seconds 1 111 10485.76 seconds String type. Half a byte in a 4 bit format. bit 4 321 E-UTRAN e-I-DRX cycle length duration BG95&BG77&BG600L_Series_AT_Commands_Manual 79 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 0 000 5.12 seconds 0 001 10.24 seconds 0 010 20.48 seconds 0 011 40.96 seconds 0 100 61.44 seconds 0 101 81.92 seconds 0 110 102.4 seconds 0 111 122.88 seconds 1 000 143.36 seconds 1 001 163.84 seconds 1 010 327.68 seconds 1 011 655,36 seconds 1 100 1310.72 seconds 1 101 2621.44 seconds 1 110 5242.88 seconds 1 111 10485.76 seconds String type. Half a byte in a 4 bit format. eMTC mode bit 4 321 Paging Time Window length 0 000 1.28 seconds 0 001 2.56 seconds 0 010 3.84 seconds 0 011 5.12 seconds 0 100 6.4 seconds 0 101 7.68 seconds 0 110 8.96 seconds 0 111 10.24 seconds 1 000 11.52 seconds 1 001 12.8 seconds 1 010 14.08 seconds 1 011 15.36 seconds 1 100 16.64 seconds 1 101 17.92 seconds 1 110 19.20 seconds 1 111 20.48 seconds NB-IoT mode bit 4 321 Paging Time Window length 0 000 2.56 seconds 0 001 5.12 seconds 0 010 7.68 seconds 0 011 10.24 seconds 0 100 12.8 seconds BG95&BG77&BG600L_Series_AT_Commands_Manual 80 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 0 101 0 110 0 111 1 000 1 001 1 010 1 011 1 100 1 101 1 110 1 111 15.36 seconds 17.92 seconds 20.48 seconds 23.04 seconds 25.6 seconds 28.16 seconds 30.72 seconds 33.28 seconds 35.84 seconds 38.4 seconds 40.96 seconds NOTE =2 is not supported currently. 6.14. AT+CTZR Time Zone Reporting This command controls the time zone change event reporting. If reporting is enabled, the MT returns the unsolicited result code +CTZV: or +CTZE: ,, whenever the time zone is changed. AT+CTZR Time Zone Reporting Test Command AT+CTZR=? Response +CTZR: (range of supported s) Write Command AT+CTZR= OK Response OK Read Command AT+CTZR? If there is any other error: ERROR Response +CTZR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK 300 ms The command takes effect immediately. The configuration is saved automatically. BG95&BG77&BG600L_Series_AT_Commands_Manual 81 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. Indicates the mode of time zone reporting. 0 Disable time zone change event reporting 1 Enable time zone change event reporting by unsolicited result code +CTZV: 2 Enable extended time zone and local time reporting by unsolicited result code: +CTZE: ,, String type. Represents the sum of the local time zone (difference between the local time and GMT is expressed in quarters of an hour) plus daylight saving time. The format is '±zz', expressed as a fixed width, two-digit integer within the range -48 to +56. To maintain a fixed width, numbers in the range -9 to +9 are expressed with a leading zero, e.g. '-09', '+00' and '+09'. Integer type. Indicates whether includes daylight savings adjustment. 0 includes no adjustment for daylight saving time 1 includes +1 hour (equals 4 quarters in ) adjustment for daylight saving time 2 includes +2 hours (equals 8 quarters in ) adjustment for daylight saving time String type. Represents the local time. The format is 'YYYY/MM/DD,hh:mm:ss', expressed as integers representing year (YYYY), month (MM), date (DD), hour (hh), minute (mm) and second (ss). The local time can be derived by the MT from information provided by the network at the time of delivering time zone information and will be present in the unsolicited result code for extended time zone and local time reporting if the universal time is provided by the network. Example AT+CTZR=2 OK AT+CTZR? +CTZR: 2 OK +CTZE: '+32',0,'2013/08/23,06:51:13' 6.15. AT+QNWINFO Query Network Information This command indicates network information such as the access technology selected, the operator, and the band selected. BG95&BG77&BG600L_Series_AT_Commands_Manual 82 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+QNWINFO Query Network Information Test Command AT+QNWINFO=? Execution Command AT+QNWINFO Response OK Response +QNWINFO: ,,, Maximum Response Time Characteristics OK 300 ms / Parameter String type. Access technology selected. 'No Service' 'GSM' 'GPRS' 'EDGE' 'eMTC' 'NBIoT' String type. Operator in numeric format. String type. Band selected. 'GSM 850' 'GSM 900' 'GSM 1800' 'GSM 1900' 'LTE BAND 1' – 'LTE BAND 85' Integer type. Channel ID. Example AT+QNWINFO=? OK AT+QNWINFO +QNWINFO: 'EDGE','46001','GSM 1800',653 OK BG95&BG77&BG600L_Series_AT_Commands_Manual 83 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 6.16. AT+QCSQ Query and Report Signal Strength This command queries and reports the signal strength of the current service network. If the MT is registered on multiple networks in different service modes, you can query the signal strength of networks in each mode. No matter whether the MT is registered on a network or not, the command can be run to query the signal strength or allow the MT to report the URC indicating the detected signal strength if the MT camps on the network. If the MT is not using any service network or the service mode is uncertain, 'NOSERVICE' will be returned as the query result. AT+QCSQ Query and Report Signal Strength Execution Command AT+QCSQ Response +QCSQ: ,[,[,[,[,]]]] Maximum Response Time Characteristics OK 300 ms / Parameter / / / / A string type value indicating the service mode in which the MT will unsolicited report the signal strength. 'NOSERVICE' NO SERVICE mode 'GSM' GSM/GPRS/EDGE mode 'eMTC' eMTC mode 'NBIoT' NB-IoT mode The following table lists the signal strength type corresponding to each service mode. 'NOSERVICE' 'GSM' 'eMTC' 'NBIoT' An integer indicating the received signal strength. These parameters are available for GSM and LTE mode respectively. An integer indicating the reference signal received power (RSRP). This parameter is available for LTE mode. An integer indicating the signal to interference plus noise ratio (SINR). Logarithmic value of SINR. Values are in 1/5th of a dB. Range: 0–250 which translates to -20 dB to +30 dB. BG95&BG77&BG600L_Series_AT_Commands_Manual 84 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual An integer indicating the reference signal received quality (RSRQ) in dB. Example AT+QCSQ //Execute the command to query signal +QCSQ: 'eMTC',-52,-81,195,-10 OK AT+QCSQ=? //List of supported s +QCSQ: 'NOSERVICE','GSM','eMTC','NBIoT' OK 6.17. AT+QCSCON Signaling Connection Status This command gives details of the terminal’s perceived radio connection status. It returns an indication of the current state. Note that this state is only updated when radio events, such as sending and receiving, take place. This means that the current state may be out of date. The terminal may think it is 'Connected' yet cannot currently use a base station due to a change in the link quality. AT+QCSCON Signalling Connection Status Test Command AT+QCSCON=? Response +QCSCON: (list of supported s) Read Command AT+QCSCON? OK Response +QCSCON: , OK Write Command AT+QCSCON= If there is any error: +CME ERROR: Response OK If there is any error: +CME ERROR: Maximum Response Time If there is any other error: ERROR 300 ms BG95&BG77&BG600L_Series_AT_Commands_Manual 85 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Characteristics The command takes effect immediately. The configuration is not saved. Parameter Integer type. Enables or disables the report of URC +QCSCON: ,. 0 Disable 1 Enable Integer type. indicates the signaling connection status. 0 Idle 1 Connected Integer type. Error code. Refer to Table 20 for possible values. Example AT+QCSCON=? +QCSCON: (0,1) OK AT+QCSCON? +QCSCON: 0,0 OK AT+QCSCON=1 OK AT+QIOPEN=1,0,'TCP','220.180.239.212',8433,0,1 OK +QCSCON: 1,1 //RRC connection setup +QIOPEN: 0,0 +QCSCON: 1,0 //RRC connection release 6.18. AT+QLTS Obtain the Latest Time Synchronized Through Network The Execution Command returns the latest time synchronized through network. AT+QLTS Obtain the Latest Time Synchronized Through Network Test Command AT+QLTS=? Response +QLTS: (range of supported s) BG95&BG77&BG600L_Series_AT_Commands_Manual 86 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Execution Command AT+QLTS Write Command AT+QLTS= Maximum Response Time Characteristics OK Response +QLTS: , OK Response +QLTS: , OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms / Parameter Integer type. Query network time mode 0 Query the latest time that has been synchronized through network 1 Query the current GMT time calculated from the latest time that has been synchronized through network 2 Query the current LOCAL time calculated from the latest time that has been synchronized through network String type. Format: 'yy/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range -48...+48). E.g. 6th of May 2004, 22:10:00 GMT+2 hours equals '04/05/06,22:10:00+08' Integer type. Daylight saving time. NOTES If the time has not been synchronized through network, the command will return a null time string: +QLTS: ''. Example AT+QLTS=? +QLTS: (0-2) //Query supported network time modes BG95&BG77&BG600L_Series_AT_Commands_Manual 87 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual OK AT+QLTS //Query the latest time synchronized through network +QLTS: '2020/06/02,01:47:33+32,0' OK AT+QLTS=0 //Query the latest time synchronized through network. It offers the same function as Execution Command AT+QLTS. +QLTS: '2020/06/02,01:47:33+32,0' OK AT+QLTS=1 //Query the current GMT time calculated from the latest time that has been synchronized through network. +QLTS: '2020/06/02,01:48:36+32,0' OK AT+QLTS=2 //Query the current LOCAL time calculated from the latest time that has been synchronized through network. +QLTS: '2020/06/02,09:48:51+32,0' OK BG95&BG77&BG600L_Series_AT_Commands_Manual 88 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 7 Call Related Commands* All commands in this chapter are still under development. 7.1. ATD Mobile Originated Call to Dial a Number This command sets up outgoing voice and data or fax calls. Supplementary services can also be controlled with this command. ATD Mobile Originated Call to Dial a Number Execution Command ATD[][;] Response If no dial tone and ATX2 or ATX4 is set: NO DIALTONE If busy and ATX3 or ATX4 is set: BUSY If a connection cannot be established: NO CARRIER If the connection is established successfully and a non-voice call is to be set up: CONNECT And TA switches to data mode. outputs only when is greater than 0 in ATX parameter setting. When TA returns to command mode after the call release: OK Maximum Response Time Characteristics Reference If the connection is established successfully and a voice call is set up: OK 5 s, determined by the network (AT+COLP=0). / BG95&BG77&BG600L_Series_AT_Commands_Manual 89 / 192 V.25ter LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter String of dialing digits and optionally V.25ter modifiers Dialing digits: 0-9, *, #, +, A, B, C Following V.25ter, modifiers are ignored: ,(comma), T, P, !, W, @ String of GSM modifiers: I Activates CLIR (Disable presentation of own number to called party) i Deactivates CLIR (Enable presentation of own number to called party) G Activates closed user group invocation for this call only g Deactivates closed user group invocation for this call only It is required when setting up voice call, and will return to command state after the call. NOTES 1. This command may be aborted generally by receiving an ATH command or a character during execution. The aborting is not possible during some states of connection establishment such as handshaking. 2. Parameters I and i can be omitted only when there is no * or # code within the dial string. 3. See ATX command for setting result code and call monitoring parameters. 4. Responses returned after dialing with ATD: For voice calls, two different response modes can be determined. TA returns OK immediately either after dialing was completed or after the call was established. The setting is controlled by AT+COLP, of which the default is AT+COLP=0, which causes the TA to return OK immediately after the dialing was completed. Otherwise TA will return OK, BUSY, NO DIAL TONE, or NO CARRIER. 5. Using ATD during an active voice call:  When a user originates a second voice call while there is already an active voice call, the first call will be automatically put on hold.  The current states of all calls can be easily checked at any time with AT+CLCC. Example ATD10086; OK //Dialing out the party’s number 7.2. ATH Disconnect Existing Connection This command disconnects circuit switched data calls or voice calls. AT+CHUP is also used to disconnect voice calls. BG95&BG77&BG600L_Series_AT_Commands_Manual 90 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual ATH Disconnect Existing Connection Execution Command ATH[n] Response OK Maximum Response Time 90 s, determined by the network. Characteristics / Reference V.25ter Parameter Integer type. 0 Disconnect existing call from command line and terminate the call. 7.3. AT+CVHU Voice Hang up Control This command controls whether ATH can be used to disconnect the voice call. AT+CVHU Voice Hang up Control Test Command AT+CVHU=? Response +CVHU: (list of supported s) Read Command AT+CVHU? OK Response +CVHU: Write Command AT+CVHU= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. BG95&BG77&BG600L_Series_AT_Commands_Manual 91 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. 0 ATH can be used to disconnect the voice call 1 ATH is ignored with the response OK returned only 7.4. AT+CHUP Hang up a Call This command cancels all voice calls in the state of Active, Waiting and Held. For data connections, please use ATH. AT+CHUP* Hang up a Call Test Command AT+CHUP=? Execution Command AT+CHUP Response OK Response OK Maximum Response Time Characteristics Reference 3GPP 27.007 If there is any other error: ERROR 90 s, determined by the network. / Example RING AT+CHUP OK //A call is incoming //Hang up the call 7.5. +++ Switch from Data Mode to Command Mode The +++ character sequence causes the TA to cancel the data flow over the AT interface and switch to command mode. It allows inputting AT commands while maintaining the data connection with the remote device. This command is only available when TA is in data mode. BG95&BG77&BG600L_Series_AT_Commands_Manual 92 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual +++ Switch from Data Mode to Command Mode Execution Command +++ Response OK Maximum Response Time 300 ms Characteristics / Reference V.25ter NOTES 1. To prevent the +++ escape sequence from being misinterpreted as data, the following sequence should be followed: 1) Do not input any character within 1 s before inputting +++. 2) Input +++ within 1 s, and no other characters can be inputted during the time. 3) Do not input any character within 1 s after +++ has been inputted. 4) Switch to command mode; otherwise return to step 1). 2. To return back to data mode from command mode, please enter ATO0. 3. Another way to switch to command mode is through DTR level change, and see AT&D for details. 7.6. ATO Switch from Command Mode to Data Mode This command resumes the connection and switches back to data mode from command mode. ATO Switch from Command Mode to Data Mode Execution Command ATO[n] Response If connection is not successfully resumed: NO CARRIER Maximum Response Time Characteristics Reference V.25ter If connection is successfully resumed, TA returns to data mode from command mode: CONNECT 300 ms / BG95&BG77&BG600L_Series_AT_Commands_Manual 93 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. 0 Switch from command mode to data mode NOTE When TA returns to data mode from command mode successfully, CONNECT is returned. Note that outputs only when is greater than 0 in ATX parameter setting. 7.7. ATS0 Set Number of Rings before Automatic Answering This command controls automatic answering mode for the incoming calls. ATS0 Set Number of Rings before Automatic Answering Read Command ATS0? Response Write Command ATS0= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. This parameter determines the number of rings before automatic answering. 0 Automatic answering is disabled 1-255 Enable automatic answering on the ring number specified NOTE If is set too high, the calling party may hang up before the call is answered automatically. BG95&BG77&BG600L_Series_AT_Commands_Manual 94 / 192 Example ATS0=3 OK RING RING RING LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Set three rings before automatically answering a call //A call is incoming //Automatically answer the call after three rings 7.8. ATS6 Set Pause before Blind Dialing This command is implemented for compatibility reasons only, and has no effect. ATS6 Set Pause before Blind Dialing Read Command ATS6? Response Write Command ATS6= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Number of seconds to wait before blind dialing. Range: 0–10. Default value: 2. Unit: second. 7.9. ATS7 Set the Time to Wait for Connection Completion This command specifies the amount of time (unit: second) to wait for the connection completion in case of answering or originating a call. If no connection is established during the time, the module will be disconnected from the line. BG95&BG77&BG600L_Series_AT_Commands_Manual 95 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual ATS7 Set the Time to Wait for Connection Completion Read Command ATS7? Response Write Command ATS7= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. This parameter determines the amount of time (unit: second) to wait for the connection completion in case of answering or originating a call. 0 Disabled 1-255 Number of seconds to wait for connection completion 7.10. ATS8 Set the Time to Wait for Comma Dial Modifier This command is implemented for compatibility reasons only, and has no effect. ATS8 Set the Time to Wait for Comma Dial Modifier Read Command ATS8? Response Write Command ATS8= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300 ms The command takes effect immediately. The configuration is not saved. BG95&BG77&BG600L_Series_AT_Commands_Manual 96 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. 0 No pause when comma encountered in dial string 1-2-255 Number of seconds to wait for comma dial modifier 7.11. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier This command determines the amount of time (unit: tenths of a second) during which the UE remains connected in absence of a data carrier. ATS10 Set Disconnection Delay after Indicating the Absence of Data Carrier Read Command ATS10? Response Write Command ATS10= Maximum Response Time Characteristics Reference V.25ter OK Response OK 300ms The command takes effect immediately. The configuration can be saved with AT&W. Parameter Integer type. This parameter determines the amount of time (unit: tenths of a second) during which the TA will remain connected in absence of a data carrier. If the data carrier is once more detected before disconnection, the TA remains connected. Default value: 15. 1–254 Number of tenths of a second to wait before disconnecting after UE has indicated the absence of received line signal 7.12. AT+CRC Set Cellular Result Codes for Incoming Call Indication This command controls whether or not to use the extended format of incoming call indication. When enabled, an incoming call is indicated to the TE with unsolicited result code +CRING: instead of the normal RING. BG95&BG77&BG600L_Series_AT_Commands_Manual 97 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CRC Set Cellular Result Codes for Incoming Call Indication Test Command AT+CRC=? Response +CRC: (list of supported s) Read Command AT+CRC? OK Response +CRC: Write Command AT+CRC= Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK 300 ms / Parameter Integer type. Disables or enables the extended format of incoming call URC +CRING: 0 Disable 1 Enable String type. ASYNC Asynchronous transparent SYNC Synchronous transparent REL ASYNC Asynchronous non-transparent REL SYNC Synchronous non-transparent FAX Facsimile VOICE Voice Example AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK //Enable extended format //Indicate incoming call to the TE //Disable extended format BG95&BG77&BG600L_Series_AT_Commands_Manual 98 / 192 RING ATH OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Indicate incoming call to the TE BG95&BG77&BG600L_Series_AT_Commands_Manual 99 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 8 Short Message Service Commands 8.1. AT+CSMS Select Message Service This command selects message service and returns the types of messages supported by the MT. AT+CSMS Select Message Service Test Command AT+CSMS=? Response +CSMS: (list of supported s) Read Command AT+CSMS? OK Response +CSMS: ,,, Write Command AT+CSMS= OK Response +CSMS: ,, OK If there is an error related to ME functionality: +CMS ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Type of message service. 0 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2 version 4.7.0; Phase 2+ features BG95&BG77&BG600L_Series_AT_Commands_Manual 100 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual which do not require new command syntax may be supported, e.g. correct routing of messages with new Phase 2+ data coding schemes). 1 3GPP TS 23.040 and 3GPP TS 23.041 (the syntax of SMS AT commands is compatible with 3GPP TS 27.005 Phase 2+ version; the requirement of setting 1 is mentioned under corresponding command descriptions). Integer type. Mobile terminated messages. 0 Type not supported 1 Type supported Integer type. Mobile originated messages. 0 Type not supported 1 Type supported Integer type. Broadcast type messages. 0 Type not supported 1 Type supported Integer type. Error code. Refer to Table 21 for possible values. Example AT+CSMS=? +CSMS: (0,1) OK AT+CSMS=1 +CSMS: 1,1,1 OK AT+CSMS? +CSMS: 1,1,1,1 OK //Query the type of message services supported by the module //Set the type of message service to 1. //Read the current setting. 8.2. AT+CMGF Message Format This command specifies the input and output formats of short messages. indicates the format of messages used with send, list, read and write commands and unsolicited result codes resulting from received messages. The format of messages can be either PDU mode (entire TP data units used) or text mode (headers and body of the messages given as separate parameters). Text mode uses the value of specified by AT+CSCS to inform the character set to be used in the message body in the TA-TE interface. BG95&BG77&BG600L_Series_AT_Commands_Manual 101 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CMGF Message Format Test Command AT+CMGF=? Read Command AT+CMGF? Write Command AT+CMGF[=] Maximum Response Time Characteristics Reference 3GPP TS 27.005 Response +CMGF: (list of supported s) OK Response +CMGF: OK Response OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. 0 PDU mode 1 Text mode 8.3. AT+CSCA Service Center Address The Write Command updates the SMSC address when mobile originated SMS are transmitted. In text mode, the setting is used by Write Command. In PDU mode, setting is used by the same command, but only when the length of the SMSC address is coded into the parameter which equals to zero. AT+CSCA Service Center Address Test Command AT+CSCA=? Read Command Response OK Response BG95&BG77&BG600L_Series_AT_Commands_Manual 102 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CSCA? Write Command AT+CSCA=[,] Maximum Response Time Characteristics Reference 3GPP TS 27.005 +CSCA: , OK Response OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS in 3GPP TS 27.007); type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ). Integer type. Error code. Refer to Table 20 for possible values. Example AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //Set SMSC address //Query SMSC address 8.4. AT+CPMS Preferred Message Storage This command selects the memory storages , and to be used for reading, writing, etc. BG95&BG77&BG600L_Series_AT_Commands_Manual 103 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CPMS Preferred Message Storage Test Command AT+CPMS=? Response +CPMS: (list of supported s),(list of supported s),(list of supported s) Read Command AT+CPMS? OK Response +CPMS: ,,,,,,,, Write Command AT+CPMS=[,[,]] OK Response +CPMS: ,,,,, OK If there is an error related to ME functionality: +CMS ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter String Type. Messages to be read and deleted from this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' The same as 'ME' storage 'SR' Status report storage String Type. Messages will be written and sent to this memory storage. 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' Status report storage String Type. Received messages will be placed in this memory storage if routing to PC is not set (AT+CNMI). BG95&BG77&BG600L_Series_AT_Commands_Manual 104 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 'SM' (U)SIM message storage 'ME' Mobile equipment message storage 'MT' Same as 'ME' storage 'SR' Status report storage Integer type. Number of current messages in . Integer type. Total number of messages which can be stored in . Integer type. Error code. Refer to Table 21 for possible values. Example AT+CPMS? //Query the current SMS message storage +CPMS: 'ME',0,23,'ME',0,23,'ME',0,23 OK AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //Set SMS message storage as 'SM' OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //Query the current SMS message storage OK 8.5. AT+CMGD Delete Messages This command deletes short messages from the preferred message storage location . If is presented and not set to 0, the ME shall ignore and follow the rules of shown as below. AT+CMGD Delete Messages Test Command AT+CMGD=? Response +CMGD: (list of supported s),(list of supported s) Write Command AT+CMGD=[,] OK Response OK If there is an error related to ME functionality: +CMS ERROR: If there is any other error: BG95&BG77&BG600L_Series_AT_Commands_Manual 105 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 ERROR 300ms. Note: Operation of depends on the storage of deleted messages. / Parameter Integer type value in the range of location numbers supported by the associated memory. Integer type. Delete flag. 0 Delete the message specified in 1 Delete all read messages from storage 2 Delete all read messages from storage and sent mobile originated messages 3 Delete all read messages from storage, sent and unsent mobile originated messages 4 Delete all messages from storage Integer type. Error code. Refer to Table 21 for possible values. Example AT+CMGD=1 OK AT+CMGD=1,4 OK //Delete the message specified in =1 //Delete all messages from storage 8.6. AT+CMGL List Messages The Write Command returns messages with status value from preferred message storage to the TE. If the status of the message is 'REC UNREAD', the status in the storage changes to 'REC READ'. When executing AT+CMGL without status value , it will report the list of SMS with 'REC UNREAD' status. AT+CMGL List Messages Test Command AT+CMGL=? Response +CMGL: (list of supported s) OK BG95&BG77&BG600L_Series_AT_Commands_Manual 106 / 192 Write Command AT+CMGL[=] LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-SUBMITs and/or SMS-DELIVERs: +CMGL: ,,,[],[][,,] [+CMGL: ,,,[],[][,,] [...]] OK For SMS-STATUS-REPORTs: +CMGL: ,,,,[],[],,, [+CMGL: ,,,,[],[],,, [...]] OK For SMS-COMMANDs: +CMGL: ,,, [+CMGL: ,,, [...]] OK For CBM storage: +CMGL:,,,,, [+CMGL: ,,,,, [...]] OK If in PDU mode (AT+CMGF=0) and the command is executed successfully: +CMGL: ,,[], [+CMGL: ,,[], [...]] BG95&BG77&BG600L_Series_AT_Commands_Manual 107 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK If there is an error related to ME functionality: +CMS ERROR: 300 ms. Note: Operation of depends on the storage of listed messages. / Parameter Integer type in PDU mode, or string type in text mode. The status of message in memory; Defined values: PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Integer type. In the range of location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS in 3GPP TS 27.007). Type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS in 3GPP TS 27.007). The type of address is given by . String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). Integer type. Message length. In the text mode (AT+CMGF=1) the length of the message body ; or in PDU mode (AT+CMGF=0) the length of the actual TP BG95&BG77&BG600L_Series_AT_Commands_Manual 108 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used and indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set. - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules of in 3GPP TS 27.007 Annex A. - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7 bit default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7 bit default alphabet 23) is presented as 17 (IRA 49 and 55)). - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used: - If TE character set other than 'HEX' (refer to AT+CSCS in 3GPP TS27.007): ME/TA converts GSM alphabet into current TE character set according to rules of 3GPP TS 27.007 Annex A. - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7 bit default alphabet into two IRA character long hexadecimal number. - If , indicates that 8-bit or UCS2 data coding scheme is used: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, SMS-COMMAND in integer format. If a valid value has been entered once, the parameter can be omitted. 3GPP TS 23.040 TP-Message-Reference in integer format. 3GPP TS 23.040 TP-Recipient-Address Address-Value field in string format. BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS). The type of address is given by . 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (default refer to ). Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). 3GPP TS 23.040 [3] TP-Discharge-Time in time-string format: BG95&BG77&BG600L_Series_AT_Commands_Manual 109 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 'yy/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals '94/05/06,22:10:00+08'. 3GPP TS 23.040 [3] TP-Status in integer format.. 3GPP TS 23.040 [3] TP-Command-Type in integer format (default 0). 3GPP TS 23.041 [4] CBM Serial Number in integer format. 3GPP TS 23.041 [4] CBM Message Identifier in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 4–7 in integer format. 3GPP TS 23.041 [4] CBM Page Parameter bits 0–3 in integer format. Integer type. Error code. Refer to Table 21 for possible values. Example AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','',, +CMGL: 2,'STO UNSENT','',, OK //Set SMS message format as text mode //List all messages from message storage 8.7. AT+CMGR Read Messages The Write Command returns SMS messages with location value from message storage to the TE. If status of the message is 'REC UNREAD', status in the storage changes to 'REC READ'. AT+CMGR Read Messages Test Command AT+CMGR=? Write Command AT+CMGR= Response OK Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-DELIVER: +CMGR: ,,[],[,,,,,,,] OK For SMS-SUBMIT: BG95&BG77&BG600L_Series_AT_Commands_Manual 110 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 +CMGR: ,,[][,,,,,[],,,] OK For SMS-STATUS-REPORTs: +CMGR: ,,,[],[],,, OK For SMS-COMMANDs: +CMGR: ,,[,,[],[],[], ] OK For CBM storage: +CMGR: ,,,,, OK If in PDU mode (AT+CMGF=0) and the command is executed successfully: +CMGR: ,[], OK If there is an error related to ME functionality: +CMS ERROR: Depends on the length of message content. / Parameter Integer type. In the range of location numbers supported by the associated memory. Integer type in PDU mode, or string type in text mode. The status of message in memory; Defined values: PDU mode Text mode Explanation BG95&BG77&BG600L_Series_AT_Commands_Manual 111 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages String type alphanumeric representation of or corresponding to the entry found in MT phonebook. Implementation of this feature is manufacturer specified. The used character set should be the one selected with AT+CSCS command (see definition of this command in 3GPP TS 27.007). Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). First octet. Depending on the command or result code: First octet of 3GPP TS 23.040 SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, or SMS-COMMAND in integer format. If a valid value has been entered once, the parameter can be omitted. Protocol identifier. 3GPP TS 23.040 TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 SMS Data Coding Scheme (default 0), or Cell Broadcast Data Coding Scheme in integer format. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 TP-Validity-Period either in integer format or in time-string format (refer to ). Message number. 3GPP TS 23.040 TP-Message-Number in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Recipient address. 3GPP TS 23.040 TP-Recipient-Address Address-Value field in string format. BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command). The type of address is given by . Type of recipient address. 3GPP TS 24.011 TP-Recipient-Address Type-of-Address octet in integer format (default refer to ). Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). Service center address. 3GPP TS 24.011 RP SC address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to BG95&BG77&BG600L_Series_AT_Commands_Manual 112 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of service center address. 3GPP TS 24.011 RP SC address Type-of-Address octet in integer format (default refer to ). Integer type. Message length. In the text mode (AT+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (AT+CMGF=0) the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 23.040 TP-User-Data in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used and indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is not set. - If TE character set other than 'HEX' (refer to AT+CSCS command in 3GPP TS 27.007): ME/TA converts GSM alphabet into current TE character set according to rules of in 3GPP TS 27.007 Annex A. - If TE character set is 'HEX': ME/TA converts each 7-bit character of GSM 7 bit default alphabet into two IRA character long hexadecimal number (e.g. character  (GSM 7 bit default alphabet 23) is presented as 17 (IRA 49 and 55)). - If , indicates that 8-bit or UCS2 data coding scheme is used, or indicates that 3GPP TS 23.040 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). In the case of CBS: 3GPP TS 23.041 CBM Content of Message in text mode responses; format: - If , indicates that 3GPP TS 23.038 GSM 7 bit default alphabet is used: - If TE character set other than 'HEX' (refer to AT+CSCS in 3GPP TS27.007): ME/TA converts GSM alphabet into current TE character set according to rules of 3GPP TS 27.007 Annex A. - If TE character set is 'HEX': ME/TA converts each 7-bit character of the GSM 7 bit default alphabet into two IRA character long hexadecimal number. - If , indicates that 8-bit or UCS2 data coding scheme is used: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number. In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.040 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). 3GPP TS 23.040 [3] TP-Discharge-Time in time-string format: 'yy/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone. E.g. 6th of May 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. 3GPP TS 23.040 [3] TP-Status in integer format. 3GPP TS 23.040 [3] TP-Command-Type in integer format (default 0). 3GPP TS 23.040 [3] TP-Command-Data in text mode responses; ME/TA converts each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer BG95&BG77&BG600L_Series_AT_Commands_Manual 113 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual value 42 is presented to TE as two characters 2A (IRA 50 and 65)) 3GPP TS 23.041 [4] CBM Serial Number in integer format 3GPP TS 23.041 [4] CBM Message Identifier in integer format 3GPP TS 23.041 [4] CBM Page Parameter bits 4-7 in integer format 3GPP TS 23.041 [4] CBM Page Parameter bits 0-3 in integer format Integer type. Error code. Refer to Table 21 for possible values. Example +CMTI: 'SM',3 AT+CSDH=1 OK AT+CMGR=3 +CMGR: 'REC 0',145,27 //Indicate that a new message has been received and saved to =3 of 'SM' //Read the message UNREAD','+8615021012496',,'13/12/13,15:06:37+32',145,4,0,0,'+861380021050 OK 8.8. AT+CMGS Send Messages This Write Command sends a short message from TE to network (SMS-SUBMIT). The message reference is returned to the TE on successful message delivery. Optionally (when AT+CSMS value is 1 and network supports) is returned. The values can be used to identify message upon unsolicited delivery status report result code. AT+CMGS Send Messages Test Command Response AT+CMGS=? OK Write Command Response If in text mode (AT+CMGF=1): If the message is sent successfully: AT+CMGS=[,] +CMGS: [,] After > is reponded, input the text message. After that, tap ctrl-Z to send OK the message. Sending can be cancelled by tapping ESC, and the abortion is If there is an error related to ME functionality: acknowledged with OK, though the +CMS ERROR: message will not be sent. Write Command Response If in PDU mode (AT+CMGF=0): If the message is sent successfully: BG95&BG77&BG600L_Series_AT_Commands_Manual 114 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CMGS= After > is reponded, input the PDU. After that, tap ctrl-Z to indicate the ending of PDU and begin to send the message. Sending can be cancelled by tapping ESC, and the abortion is acknowledged with OK, though the message will not be sent. +CMGS: [,] OK If there is an error related to ME functionality: +CMS ERROR: Maximum Response Time 120 s, determined by the network. Characteristics / Reference 3GPP TS 27.005 Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to command AT+CSCS in 3GPP TS 27.007). The type of address is given by . Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Integer type. Message length. In the text mode (AT+CMGF=1) the length of the text message in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to in AT+CMGL). Integer type. Error code. Refer to Table 21 for possible values. Refer to AT+CGMR for Other parameters. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > +CMGS: 247 //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text. Tap ctrl-Z to send message, or ESC to quit without sending. BG95&BG77&BG600L_Series_AT_Commands_Manual 115 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual OK 8.9. AT+CMMS Send More Messages This command controls the continuity of SMS relay protocol link. When the feature is enabled (and supported by the network) multiple messages can be sent much faster as the link is kept open. AT+CMMS Send More Messages Test Command AT+CMMS=? Response +CMMS: (range of supporteds) Read Command AT+CMMS? OK Response +CMMS: Write Command AT+CMMS= OK Response OK If there is an error related to ME functionality: +CMS ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any other error: ERROR 120 s, determined by the network. / Parameter Integer type 0 Feature disabled 1 Keep enabled until the time between the response of the latest message sending command (AT+CMGS, AT+CMSS, etc.) and the next sending command exceeds 1-5 s (the exact value is up to ME implementation); then ME shall close the link and TA switches back to 0 automatically. 2 Feature enabled. If the time between the response of the latest message sending command and the next sending command exceeds 1-5 s (the exact value is up to ME implementation), the ME shall close the link but TA will not switch back to 0 BG95&BG77&BG600L_Series_AT_Commands_Manual 116 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual automatically. Integer type. Error code. Refer to Table 21 for possible values. NOTE After the execution of Read Command, a delay of 5-10 s is required before issuing the Write Command. Otherwise +CMS ERROR: 500 may appear. 8.10. AT+CMGW Write Messages to Memory This command stores short messages (either SMS-DELIVER or SMS-SUBMIT) to memory storage (refer to AT+CPMS for details), and then the memory location of the stored message is returned. The message status will be set to ‘stored unsent’ by default, but the parameter also allows other status values to be given. The entering of text is done similarly as specified in AT+CMGS Write Command. AT+CMGW Write Messages to Memory Test Command AT+CMGW=? Write Command 1) If in text mode (AT+CMGF=1): AT+CMGW[=[,[,< stat>]]] After > is reponded, input the text message. After that, tap ctrl-Z to transmit the message to memory storage . Transmitting can be cancelled by tapping ESC, and the abortion is acknowledged with OK, though the message will not be transmitted. Response OK Response If message writing is successful: +CMGW: OK If there is an error related to ME functionality: +CMS ERROR: 2) If in PDU mode (AT+CMGF=0): AT+CMGW=[,] After > is reponded, input the PDU. After that, tap ctrl-Z to indicate the ending of PDU and begin to transmit the message to memory storage . Transmitting can be cancelled by tapping ESC, and the abortion is acknowledged with OK, though the BG95&BG77&BG600L_Series_AT_Commands_Manual 117 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual message will not be transmitted. Maximum Response Time Characteristics Reference 3GPP TS 27.005 300 ms / Parameter Destination address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Originating address. 3GPP TS 23.040 TP-Originating-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of originating address. 3GPP TS 24.011 TP-Originating-Address Type-of-Address octet in integer format (default refer to ). Integer type in PDU mode, or string type in text mode. The status of message in memory; Defined values: PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Integer type. Message length. In the text mode (AT+CMGF=1) the length of the text message in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length). In the case of SMS: 3GPP TS 24.011 SC address followed by 3GPP TS 23.04 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)). Integer type. Index of message in selected storage . Integer type. Error code. Refer to Table 21 for possible values. Example AT+CMGF=1 OK //Set SMS message format to text mode BG95&BG77&BG600L_Series_AT_Commands_Manual 118 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CSCS='GSM' OK AT+CMGW='15021012496' > +CMGW: 4 //Set character set as GSM which is used by the TE //Enter in text. Tap ctrl-Z to transmit the message to memory storage . OK AT+CMGF=0 //Set SMS message format as PDU mode OK AT+CMGW=18 > 0051FF00000008000A0500030002016D4B8BD5 +CMGW: 5 OK 8.11. AT+CMSS Send Messages from Storage This command sends messages with location value from message storage to the network (SMS-SUBMIT or SMS-COMMAND). If a new destination address is given for SMS-SUBMIT, it shall be used instead of the one stored with the message. Reference value is returned to the TE on successful message delivery. Values can be used to identify message upon unsolicited delivery status report result code. AT+CMSS Send Messages from Storage Test Command AT+CMSS=? Write Command AT+CMSS=[,[,]] Response OK Response If in text mode (AT+CMGF=1) and the message is sent successfully: +CMSS: [,] OK If in PDU mode (AT+CMGF=0) and the message is sent successfully: +CMSS: [,] OK If there is an error related to ME functionality: +CMS ERROR: BG95&BG77&BG600L_Series_AT_Commands_Manual 119 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.005 120 s, determined by the network. / Parameter Integer type. In the range of location numbers supported by the associated memory. Destination Address. 3GPP TS 23.040 TP-Destination-Address Address-Value field in string format. BCD numbers (or GSM 7 bit default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS command in 3GPP TS 27.007). The type of address is given by . Type of destination address. 3GPP TS 24.011 TP-Destination-Address Type-of-Address octet in integer format. Message reference. 3GPP TS 23.040 TP-Message-Reference in integer format. Service center time stamp. 3GPP TS 23.040 TP-Service-Centre-Time-Stamp in time-string format (refer to ). The format is same as in case of SMS, but without 3GPP TS 24.011 SC address field and parameter shall be bounded by double quote characters like a normal string type parameter. Integer type. Error code. Refer to Table 21 for possible values. Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > Hello +CMGW: 4 OK AT+CMSS=4 +CMSS: 54 OK //Set SMS message format to text mode //Set character set to GSM which is used by the TE //Enter in text. Tap ctrl-Z to send message. //Send the message of index 4 from memory storage. BG95&BG77&BG600L_Series_AT_Commands_Manual 120 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 8.12. AT+CNMA New Message Acknowledgement to UE/TE The Write and Execution Commands confirm successful receipt of a new message (SMS-DELIVER or SMS-STATUS-REPORT) routed directly to the TE. If the UE does not receive acknowledgement within required time (network timeout), it sends an RP-ERROR message to the network. The UE will automatically disable routing to the TE by setting both and values of AT+CNMI to 0. AT+CNMA New Message Acknowledgement to UE/TE Test Command AT+CNMA=? Response +CNMA: (list of supported s) Execution Command AT+CNMA OK Response OK If there is an error related to ME functionality: +CMS ERROR: Write Command AT+CNMA= If there is any other error: ERROR Response OK If there is an error related to ME functionality: +CMS ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any other error: ERROR 300 ms / Parameter Integer type. Parameter required only for PDU mode 0 Command operates similarly as in text mode 1 Send positive (RP-ACK) acknowledgement to the network. Accepted only in PDU mode. 2 Send negative (RP-ERROR) acknowledgement to the network. Accepted only in PDU mode. Integer type. Error code. Refer to Table 21 for possible values. BG95&BG77&BG600L_Series_AT_Commands_Manual 121 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual NOTE The Execution and Write Commands shall only be used when AT+CSMS parameter equals to 1 (phase 2+) and an appropriate URC has been issued by the module, i.e.: +CMT for =2 incoming message classes 0, 1, 3 and none; +CMT for =3 incoming message classes 0 and 3; +CDS for =1. Example AT+CSMS=1 +CSMS:1,1,1 OK AT+CNMI=1,2,0,0,0 OK +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //A short message is outputted directly when SMS is incoming. AT+CNMA //Send ACK to the network OK AT+CNMA +CMS ERROR: 340 //The second time return error. It needs ACK only once. 8.13. AT+CNMI New Message Indications to TE This command selects the procedure on how receiving of new messages from the network is indicated to the TE when TE is active, e.g. DTR is at low level (ON). If TE is inactive (e.g. DTR is at high level (OFF)), message receiving should be done as specified in 3GPP TS 23.038 [2]. AT+CNMI New Message Indications to TE Test Command AT+CNMI=? Response +CNMI: (range of supported s),(range of supported s),(list of supported s),(range of supported s),(list of supported s) Read Command AT+CNMI? OK Response +CNMI: ,,,, OK BG95&BG77&BG600L_Series_AT_Commands_Manual 122 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Write Command AT+CNMI[=[,[,[,[,]]]]] Response OK If there is an error related to ME functionality: +CMS ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.005 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. 0 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications. 1 Discard indication and reject new received message unsolicited result codes when TA-TE link is reserved (e.g. in data mode). Otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in data mode) and flush them to the TE after reservation. Otherwise forward them directly to the TE. Integer type. The rules for storing received SMs depend on its data coding scheme (refer to 3GPP TS 23.038 [2]), preferred memory storage (AT+CPMS) setting and this value. 0 No SMS-DELIVER indications are routed to the TE. 1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE by using unsolicited result code: +CMTI: , 2 SMS-DELIVERs (except class 2) are routed directly to the TE using unsolicited result code: +CMT: [], (PDU mode enabled) or +CMT: ,[],[,,,,,,, ] (text mode enabled; about parameters in italics, refer to AT+CSDH). Class 2 messages result in indication as defined in =1. 3 Class 3 SMS-DELIVERs are routed directly to TE by using unsolicited result codes defined in =2. Messages of other classes result in indication as defined in =1. Integer type. The rules for storing received CBMs depend on its data coding scheme (refer to 3GPP TS 23.038 [2]), the setting of Select CBM Types (AT+CSCB) and this value. 0 No CBM indications are routed to the TE. 2 New CBMs are routed directly to the TE using unsolicited result code: BG95&BG77&BG600L_Series_AT_Commands_Manual 123 / 192 the LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual +CBM: (PDU mode); or +CBM: ,,,, (text mode) Integer type. 0 No SMS-STATUS-REPORTs are routed to the TE. 1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +CDS: (PDU mode) +CDS: ,,[],[],,, (text mode) 2 If SMS-STATUS-REPORT is stored into ME/TA, indication of the memory location is routed to the TE using unsolicited result code: +CDSI: , Integer type. 0 TA buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is entered (OK response shall be given before flushing codes). 1 TA buffer of unsolicited result codes defined within this command is cleared when 1or 2 is entered. Integer type. Error code. Refer to Table 21 for possible values. NOTE Unsolicited result code: +CMTI: , +CMT: [], +CBM: Indicates that a new message has been received A short message is outputted directly Cell broadcast message is outputted directly Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CNMI=1,2,0,1,0 OK //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Set SMS-DELIVERs are routed directly to the TE +CMT: '+8615021012496',,'13/03/18,17:07:21+32',145,4,0,0,'+8613800551500',145,28 This is a test from Quectel. //A short message is outputted directly when SMS is incoming. 8.14. AT+CSDH Show Text Mode Parameters This command controls whether detailed header information is shown in text mode result codes. BG95&BG77&BG600L_Series_AT_Commands_Manual 124 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CSDH Show Text Mode Parameters Test Command AT+CSDH=? Response +CSDH: (list of supported s) Read Command AT+CSDH? OK Response +CSDH: Write Command AT+CSDH[=] Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. 0 Do not show header values defined in commands AT+CSCA, AT+CSMP (, , , , , ) and , or in +CMT, +CMGL, +CMGR result codes for SMS-DELIVERs and SMS-SUBMITs in text mode; for SMS-COMMANDs, in +CMGR result code, do not show , , , , or . 1 Show the values in result codes. Example AT+CSDH=0 //Set to disable the presenting of text mode parameters OK AT+CMGR=2 +CMGR: 'STO UNSENT' ,'', OK AT+CSDH=1 //Set to enable the presenting of text mode parameters OK AT+CMGR=2 +CMGR: 'STO UNSENT','',,128,17,0,0,143,'+8613800551500',145,18 BG95&BG77&BG600L_Series_AT_Commands_Manual 125 / 192 OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 8.15. AT+CSMP Set Text Mode Parameters This command selects values for additional parameters needed when SM is sent to the network or placed in a storage when text mode is selected (AT+CMGF=1). It is possible to set the validity period starting from when the SM is received by the SMSC ( is in range 0 to 255) or define the absolute time of the validity period termination ( is a string). AT+CSMP Set Text Mode Parameters Test Command AT+CSMP=? Read Command AT+CSMP? Response OK Response +CSMP: ,,, Write Command AT+CSMP=[,[,[,] ]] Maximum Response Time Characteristics Reference 3GPP TS 27.005 OK Response OK 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter First octet. Depending on the command or result code: first octet of 3GPP TS 23.040 [3] SMS-DELIVER, SMS-SUBMIT (default 17), SMS-STATUS-REPORT, SMS-COMMAND in integer format. If a valid value has been entered once, the parameter can be omitted. Validity period. Depending on SMS-SUBMIT setting: 3GPP TS 23.040 [3] TP-Validity-Period either in integer format or in time-string format (refer to ). Protocol identifier. 3GPP TS 23.040 [3] TP-Protocol-Identifier in integer format (default 0). Data coding scheme. Depending on the command or result code: 3GPP TS 23.038 [2] SMS Data Coding Scheme (default 240), or Cell Broadcast Data Coding Scheme in integer format. BG95&BG77&BG600L_Series_AT_Commands_Manual 126 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 8.16. AT+QCMGS Send Concatenated Messages This command sends concatenated massages. Different from AT+CMGS, when sending a concatenated message via this command, each segment of the concatenated message must be identified by the additional parameters , and . When sending all segments of the message one by one, AT+QCMGS must be executed multiple times (equal to ) for each segment. This command is only applicable in text mode (AT+CMGF=1). AT+QCMGS Send Concatenated Messages Test Command AT+QCMGS=? Write Command If in text mode (AT+CMGF=1): AT+QCMGS=[,][,,,] text is entered Response OK Response If in text mode (AT+CMGF=1) and the message is sent successfully: +QCMGS: OK If there is an error related to ME functionality: +CMS ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 120 s, determined by the network. / Parameter ,, Integer type. Message identification in the user data header (UDH). Range: 0– 255. This parameter is defined and inputted by the user. All segments of a same concatenated message must have the same . Different concatenated messages should have different . Integer type. Sequence number of a concatenated message. Range: 0–7. =0 means: ignore the value and regarded it as a non-concatenated message. Integer type. The total number of the segments of one concatenated message. Range: 0–7. =0 or 1 means: ignore the value and regard it as a non-concatenated message. Refer to AT+CMGS. Integer type. Error code. Refer to Table 21 for possible values. BG95&BG77&BG600L_Series_AT_Commands_Manual 127 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual NOTES 1. For concatenated messages, the maximum length will be reduced by the length of the user data header (UDH). 3GPP TS 23.040 defines two kinds of UDH length: 6 bytes and 7 bytes, so the two kinds of are 8 bit (6 bytes) and 16 bit (7 bytes). AT+QCMGS uses 8 bit .  In the case of GSM 7 bit default alphabet data coding scheme, the maximum length of each segment of a concatenated message is (140 octets - 6)*8/7=153 characters.  In the case of 16 bit UCS2 data coding scheme, the maximum length of each segment is (140-6)/2=67 characters.  In the case of 8-bit data coding scheme, the maximum length of each segment is 140-6=134 characters. 2. , Message-Reference field gives an integer representation of a reference number of the SMS-SUBMIT or SMS-COMMAND submitted to the SC by the MS, and it is used to confirm whether the SMS-DELIVER has been received from SC duplicate or not. , the field of UDH, is message identification of the concatenated SMS, which is different from . Each segment in a concatenated message should have the same , but must be incremented for each segment of a concatenated message. 3. AT+QCMGS does not support sending messages in PDU mode (AT+CMGF=0). Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+QCMGS='15056913384',120,1,2 >ABCD +QCMGS: 190 //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Input 120 for , send the first segment of the concatenated SMS OK AT+QCMGS= '15056913384',120,2,2 >EFGH +QCMGS: 191 //Send the second segment of the concatenated SMS. OK 8.17. AT+QCMGR Read Concatenated Messages The function of this command is similar to AT+CMGR, except that the message to be read is a segment of concatenated messages, and parameters , and would be shown in the result. Several segments should be concatenated to a whole concatenated message according to these BG95&BG77&BG600L_Series_AT_Commands_Manual 128 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual three parameters. Similar to AT+QCMGS, AT+QCMGR is only used in text mode (AT+CMGF=1). AT+QCMGR Read Concatenated Messages Test Command AT+QCMGR=? Write Command AT+QCMGR= Response OK Response If in text mode (AT+CMGF=1) and the command is executed successfully: For SMS-DELIVER: +QCMGR: ,,[],[,,,,,,,][,,,] OK For SMS-SUBMIT: +QCMGR: ,,[][,,,,,[],,,][,,,< msg_total>] OK For SMS-STATUS-REPORTs: +QCMGR: ,,,[],[],,,< st> OK For SMS-COMMANDs: +QCMGR: ,,[,,[],[],[],] OK Maximum Response Time Characteristics If there is an error related to ME functionality: +CMS ERROR: Depends on the length of message content. / Parameter Integer type. Message identification in the user data header (UDH). Range: 0–65535 (see NOTES). All segments of a same concatenated message have same . BG95&BG77&BG600L_Series_AT_Commands_Manual 129 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Different concatenated messages should have different . Integer type. Sequence number of a concatenated message. Range: 1–7. Integer type. The total number of the segments of one concatenated message. Range: 2–7. Integer type. Error code. Refer to Table 21 for possible values. Other parameters, please refer to AT+CMGR. NOTES 1. The in AT+QCMGR is different from the in AT+QCMGS. It is possible that UE receives concatenated messages with 8 bits or 16 bits . So its maximal value is 255 with 8 bits and 65535 with 16 bits. 2. If the message to be read is not a concatenated message, then , and would not be shown in the result. Example +CMTI: 'SM',3 //The first segment of a concatenated message comes +CMTI: 'SM',4 //The second segment of a concatenated message comes AT+QCMGR= 3 //Read the first segment of the concatenated message +QCMGR: 'REC UNREAD','+8615056913384',,'13/07/30,14:44:37+32',120,1,2 ABCD OK AT+QCMGR= 4 //Read the second segment of the concatenated message +QCMGR: 'REC UNREAD','+8615056913384',,'13/07/30,14:44:37+32',120,2,2 EFGH OK BG95&BG77&BG600L_Series_AT_Commands_Manual 130 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 9 Packet Domain Commands 9.1. AT+CGATT PS Attach or Detach This command attaches the MT to, or detaches the MT from, the Packet Domain service. After the command has completed, the MT remains in V.250 command state. If the MT is already in the requested state, the command is ignored and the OK response is returned. If the requested state cannot be achieved, an ERROR or +CME ERROR response is returned. AT+CGATT PS Attach or Detach Test Command AT+CGATT=? Response +CGATT: (list of supported s) Read Command AT+CGATT? OK Response +CGATT: Write Command AT+CGATT= OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: 140 s, determined by the network. / Parameter Integer type. The state of PS attachment. 0 Detached 1 Attached Other values are reserved and will result in an ERROR response to the Write Command. Integer type. Error code. Refer to Table 20 for possible values. BG95&BG77&BG600L_Series_AT_Commands_Manual 131 / 192 Example AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual //Attach to PS service //Detach from PS service //Query the current PS service state 9.2. AT+CGDCONT Define PDP Context This command specifies PDP context parameters for a specific context . A special form of the Write Command (AT+CGDCONT=) causes the values for context to become undefined. It is not allowed to change the definition of an already activated context. This Read Command returns the current settings for each defined PDP context. AT+CGDCONT Define PDP Context Test Command AT+CGDCONT=? Response +CGDCONT: (range of supported s), , , , (list of supported s), (list of supported s),(list of supported s) Read Command AT+CGDCONT? OK Response +CGDCONT: ,,,,,,[…] Write Command AT+CGDCONT=[,[,< APN>[,[,[,< head_comp>[,]]]]]] OK Response OK If there is any other error: ERROR Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configuration is saved automatically. BG95&BG77&BG600L_Series_AT_Commands_Manual 132 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. PDP context identifier, which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value = 1) is returned by the test form of the command. Range: 1–15. Packet data protocol type. A string parameter which specifies the type of packet data protocol. 'IP' IPv4 'PPP' PPP 'IPV6' IPv6 'IPV4V6' IPv4v6 'Non-IP' Non-IP String type. Access point name, a logical name used to select the GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested. String type. Identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The allocated address may be read using the AT+CGPADDR command. A numeric parameter that controls PDP data compression (applicable for SNDCP only) (refer to 3GPP TS 44.065 [61]). 0 OFF (Default value if the parameter is omitted) 1 ON (Manufacturer preferred compression) 2 V.42bis Integer type. Controls PDP header compression (refer to 3GPP TS 44.065 [61] and 3GPP TS 25.323 [62]). 0 OFF 1 ON 2 RFC 1144 3 RFC 2507 4 RFC 3095 Integer type. Controls how the MT/TA requests to get the IPv4 address information. 0 IPv4 address allocation through NAS signaling 9.3. AT+CGACT PDP Context Activate or Deactivate This command activates or deactivates the specified PDP context(s). After the command has completed, the MT remains in V.250 command state. If any PDP context is already in the requested state, the state for that context remains unchanged. If the MT is not PS attached when the activation form of the command is executed, the MT first performs a PS attach and then attempts to activate the specified contexts. If no s are specified, the activation/deactivation form of the command BG95&BG77&BG600L_Series_AT_Commands_Manual 133 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual activates/deactivates all defined contexts. AT+CGACT PDP Context Activate or Deactivate Test Command AT+CGACT=? Response +CGACT: (list of supported s) Read Command AT+CGACT? OK Response +CGACT: , [+CGACT: , […]] Write Command AT+CGACT=, OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: 150 s, determined by the network. / Parameter Integer type. Indicates the state of PDP context activation. 0 Deactivated 1 Activated Other values are reserved and will result in an ERROR response to the Write Command Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). Integer type. Error code. Refer to Table 20 for possible values. Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGACT=0,1 OK //Define a PDP context //Activate the PDP //Deactivate the PDP BG95&BG77&BG600L_Series_AT_Commands_Manual 134 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 9.4. AT+CGPADDR Show PDP Addresses This command returns a list of PDP addresses for the specified context identifiers. If no is specified, the addresses for all defined contexts are returned. AT+CGPADDR Show PDP Addresses Test Command AT+CGPADDR=? Response +CGPADDR: (list of defined s) Write Command AT+CGPADDR[=[,[,…]]] OK Response +CGPADDR: , [+CGPADDR: , […]] OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms / Parameter Integer type. Specifies a particular PDP context definition (see AT+CGDCONT). String type. Identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by the AT+CGDCONT command when the context was defined. For a dynamic address it will be the one assigned during the last PDP context activation that used the context definition referred to by . is omitted if none is available. Example AT+CGDCONT=1,'IP','UNINET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,10.76.51.180 //Define a PDP context //Activate the PDP //Show the PDP address BG95&BG77&BG600L_Series_AT_Commands_Manual 135 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual OK 9.5. AT+CGREG EGPRS Network Registration Status This command queries the EGPRS network registration status and controls the presentation of an unsolicited result code +CGREG: when =1 and there is a change in the MT’s EGPRS network registration status in GERAN, or unsolicited result code +CGREG: [,[],[],[],[]] when =2 and there is a change of the network cell in GERAN. AT+CGREG EGPRS Network Registration Status Test Command AT+CGREG=? Response +CGREG: (list of supported s) Read Command AT+CGREG? OK Response: When =0, 1, or 2 and the command is executed successfully: +CGREG: ,[,[],[],[],[][,,]] When =4 and the command is executed successfully : +CGREG: ,[,[],[],[],[][,[],[][,[],[],[]]]] Write Command AT+CGREG[=] OK Response OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration can be saved with AT&W. BG95&BG77&BG600L_Series_AT_Commands_Manual 136 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code: +CGREG: 2 Enable network registration and location information unsolicited result code: +CGREG: [,[],[],[],[]] 4 For a UE that wants to apply PSM, enable network registration and location information unsolicited result code: +CGREG: [,[],[],[],[][,,[,[], [],[]]]] Integer type. Indicates the EGPRS registration status. 0 Not registered. MT is not currently searching an operator to register to. The UE is in GMM state GMM-NULL or GMM-DEREGISTERED-INITIATED. The GPRS service is disabled, but the UE is allowed to attach for GPRS if requested by the user. 1 Registered, home network. The UE is in GMM state GMM-REGISTERED or GMM-ROUTING-AREA-UPDATING-INITIATED INITIATED on the home PLMN. 2 Not registered, but MT is currently trying to attach or searching an operator to register to. The UE is in GMM state GMM-DEREGISTERED or GMM-REGISTERED-INITIATED. The GPRS service is enabled, but an allowable PLMN is currently not available. The UE will start a GPRS attach as soon as an allowable PLMN is available. 3 Registration denied. The UE is in GMM state GMM-NULL. The GPRS service is disabled, and the UE is not allowed to attach for GPRS if requested by the user. 4 Unknown 5 Registered, roaming String type. Two-byte location area code in hexadecimal format (e.g. '00C3' equals 195 in decimal) String type. Four-byte cell ID in hexadecimal format. Integer type. Access technology of the serving cell. 0 GSM 8 eMTC (Not applicable) 9 NB-IoT (Not applicable) String type. One byte routing area code. NOTE This command is valid on BG95-M3 only. BG95&BG77&BG600L_Series_AT_Commands_Manual 137 / 192 Example AT+CGREG=2 OK AT+CGATT=0 OK +CGREG: 2 AT+CGATT=1 OK +CGREG: 1,'FFFE','82E76B2',9 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 9.6. AT+CGEREP Packet Domain Event Reporting This command enables or disables sending of unsolicited result codes +CGEV: XXX from MT to TE in the case of certain events occurring in the packet domain MT or the network. controls the processing of unsolicited result codes specified within this command. controls the effect on buffered codes when 1 or 2 is entered. AT+CGEREP Packet Domain Event Reporting Test Command AT+CGEREP=? Response +CGEREP: (range of supported s),(list of supported s) Read Command AT+CGEREP? OK Response +CGEREP: , Write Command AT+CGEREP=mode[,] OK Response OK Execution Command AT+CGEREP Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any error: ERROR Response OK 300 ms The command takes effect immediately. The configuration is not saved. BG95&BG77&BG600L_Series_AT_Commands_Manual 138 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. 0 Buffer unsolicited result codes in the MT. If MT result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE. 1 Discard unsolicited result codes when MT-TE link is reserved (e.g. in on-line data mode); otherwise forward them directly to the TE. 2 Buffer unsolicited result codes in the MT when MT-TE link is reserved (e.g. in data mode) and flush them to the TE when MT-TE link becomes available. Otherwise forward them directly to the TE. Integer type. 0 MT buffer of unsolicited result codes defined within this command is cleared when 1 or 2 is entered. 1 MT buffer of unsolicited result codes defined within this command is flushed to the TE when 1 or 2 is entered (OK response shall be given before flushing the codes). NOTE The unsolicited result codes and the corresponding events are defined as follows: 1. +CGEV: REJECT ,: A network request for PDP context activation occurred when the MT was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. Note: This event is not applicable for EPS. 2. +CGEV: NW REACT ,,[]: The network has requested a context reactivation. The used to reactivate the context is provided if known to the MT. Note: This event is not applicable for EPS. 3. +CGEV: NW DEACT ,,[]: The network has forced a context deactivation. The used to activate the context is provided if known to the MT. 4. +CGEV: ME DEACT ,,[]: The mobile equipment has forced a context deactivation. The used to activate the context is provided if known to the MT. 5. +CGEV: NW DETACH: The network has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 6. +CGEV: ME DETACH: The mobile equipment has forced a Packet Domain detach. This implies that all active contexts have been deactivated. These are not reported separately. 7. +CGEV: NW CLASS : The network has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 8. +CGEV: ME CLASS : The mobile equipment has forced a change of MS class. The highest available class is reported (see AT+CGCLASS). 9. +CGEV: PDN ACT : Activated a context. The context represents a PDN connection in LTE or a Primary PDP context in GSM. 10. +CGEV: PDN DEACT : Deactivated a context. The context represents a PDN connection in LTE or a primary PDP context in GSM. BG95&BG77&BG600L_Series_AT_Commands_Manual 139 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Packet data protocol type. A string parameter which specifies the type of packet data protocol. 'IP' IPv4 'PPP' PPP 'IPV6' IPv6 'IPV4V6' IPv4v6 A string parameter identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP. PDP context identifier. A numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context-related commands. The range of permitted values (minimum value=1) is returned by the test form of AT+CGDCONT command. A string parameter which indicates the GPRS mobile class A Class A (highest) B Class B C Class C in GPRS and circuit switched alternate mode CG Class C in GPRS only mode CC Class C in circuit switched only mode (lowest) Example AT+CGEREP=? +CGEREP: (0-2),(0,1) OK AT+CGEREP? +CGEREP: 0,0 OK 9.7. AT+CGSMS Select Service for MO SMS Messages This command specifies the service or service preference that the MT will use to send MO (mobile originated) SMS messages. BG95&BG77&BG600L_Series_AT_Commands_Manual 140 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CGSMS Select Service for MO SMS Messages Test Command AT+CGSMS=? Response +CGSMS: (range of currently available s) Read Command AT+CGSMS? OK Response +CGSMS: Write Command AT+CGSMS=[] OK Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Indicates the service or service preference to be used. 0 GPRS 1 Circuit switch 2 GPRS preferred (use circuit switched if GPRS is not available) 3 Circuit switch preferred (use GPRS if circuit switched is not available) Integer type. Error code. Refer to Table 20 for possible values. NOTE The circuit switched service route is the default method. BG95&BG77&BG600L_Series_AT_Commands_Manual 141 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 9.8. AT+CEREG EPS Network Registration Status This command queries the LTE network registration status and controls the presentation of an unsolicited result code +CEREG: when =1 and there is a change in the MT’s EPS network registration status in E-UTRAN, or unsolicited result code +CEREG: [,[],[],[]] when =2 and there is a change of the network cell in E-UTRAN. If the UE wants to apply PSM for reducing its power consumption, see AT+CPSMS command and 3GPP TS 23.682 [149], this command controls the presentation of an unsolicited result code +CEREG: [,[],[],[][,,[,[],[]]]] when =4 and there is a change of the network cell in E-UTRAN. AT+CEREG EPS Network Registration Status Test Command AT+CEREG=? Response +CEREG: (list of supported s) Read Command AT+CEREG? OK Response When =0, 1, or 2 and the command is executed successfully: +CEREG: ,[,[],[],[[,,]]] When =4 and the command is executed successfully : +CEREG: ,[,[],[],[][,[],[][,[],[]]]] Write Command AT+CEREG[=] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration can be saved with AT&W. BG95&BG77&BG600L_Series_AT_Commands_Manual 142 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code: +CEREG: 2 Enable network registration and location information unsolicited result code: +CEREG: [,[],[],[]] 4 For a UE that has applied PSM, and network assigns T3324 to UE, enable network registration and location information unsolicited result code: +CEREG: [,[],[],[][,,[,[],[ ]]]] Integer type. 0 Not registered. MT is not currently searching an operator to register to. 1 Registered, home network 2 Not registered, but MT is currently trying to attach or searching an operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two-byte tracking area code in hexadecimal format. String type. Four-byte E-UTRAN cell ID in hexadecimal format. Access technology selected 0 GSM (Not applicable) 8 eMTC 9 NB-IoT Integer type. The type of . 0 Indicates that contains an EMM cause value. 1 Indicates that contains a manufacturer-specific cause. Integer type. Contains the cause of the failed registration. The value is of type as defined by . String type. One byte in an 8-bit format. Active Time value (T3324) to be allocated to the UE. (e.g. '00001111' equals to 1 minute) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated. String type. One byte in an 8-bit format. Extend periodic TAU value (T3412_ext) to be allocated to the UE in E-UTRAN. (e.g. '00001010' equals to 100 minutes) BG95&BG77&BG600L_Series_AT_Commands_Manual 143 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute BG95&BG77&BG600L_Series_AT_Commands_Manual 144 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 10 Supplementary Service Commands* All commands in this chapter are still under development. 10.1. AT+CCFC Call Forwarding Number and Conditions Control This command allows control of the call forwarding supplementary service according to 3GPP TS 22.082 [4]. Registration, erasure, activation, deactivation and status query are supported. AT+CCFC Call Forwarding Number and Conditions Control Test Command AT+CCFC=? Response +CCFC: (list of supported s) Write Command AT+CCFC=,[,[,[,[,[,[,time]]]]]] OK Response Only and should be entered with =0/1/2/4. If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully (only in connection with =0/1/2/3): For registered call forwarding numbers: +CCFC: ,[,,[,,[,]]] [+CCFC: ,[,,[,,[,]]] […]] OK If no call forwarding numbers are registered (and therefore all classes are inactive): +CCFC: , BG95&BG77&BG600L_Series_AT_Commands_Manual 145 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK where =0 and =15 If there is an error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. 0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All call forwarding (0–3) 5 All conditional call forwarding (1–3) Integer type. 0 Disable 1 Enable 2 Query status 3 Registration 4 Erasure String type. Phone number of forwarding address in format specified by . Integer type. Type of address. Default 145 when dialing string includes international access code character '+', otherwise 129. String type. Subaddress of format specified by . Integer type. Type of subaddress. Integer type. A sum of integers each representing a class of information 1 Voice 2 Data 4 Fax 7 All telephony except SMS 8 Short message service 16 Data circuit synchronization 32 Data circuit asynchronization Integer type. When 'no reply' (=no reply) is enabled or queried, this gives the time in seconds to wait before the call is forwarded. Range: 1–30. Default value: 20. Integer type. 0 Not active BG95&BG77&BG600L_Series_AT_Commands_Manual 146 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 1 Active Integer type. Error code. Refer to Table 20 for possible values. Example AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145,,, OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,255 OK //Register the destination number for unconditional call forwarding (CFU) //Query the status of CFU without specifying //Erase the registered CFU destination number //Query the status and there is no destination number 10.2. AT+CCWA Call Waiting Control This command allows control of the call waiting supplementary service according to 3GPP TS 22.083 [5]. Activation, deactivation and status query are supported. AT+CCWA Call Waiting Control Test Command AT+CCWA=? Response +CCWA: (list of supported s) Read Command AT+CCWA? OK Response +CCWA: Write Command AT+CCWA[=][,[,]] OK Response If is not equal to 2 and the command is executed successfully: OK If =2 and the command is executed successfully: +CCWA: , [+CCWA: , [...]] BG95&BG77&BG600L_Series_AT_Commands_Manual 147 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK If there is an error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. 0 Disable presentation of an unsolicited result code 1 Enable presentation of an unsolicited result code Integer type. When is omitted, network is not interrogated 0 Disable 1 Enable 2 Query status Integer type. A sum of integers each representing a class of information 1 Voice (telephony) 2 Data (bearer service) 4 Fax (facsimile) 16 Data circuit synchronization 32 Data circuit asynchronization Integer type. 0 Disable 1 Enable String type. Phone number of calling address in format specified by Integer type. Type of address octet. 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Optional string type alphanumeric representation of corresponding to the entry found in phone book. Used character set should be the one selected with command select TE character set AT+CSCS. Integer type. Error code. Refer to Table 20 for possible values. NOTES 1. =0 should be returned only if service is not active for any i.e. +CCWA: 0,7 will be returned in this case. 2. When =2, all active call waiting classes will be reported. In this mode the command can be BG95&BG77&BG600L_Series_AT_Commands_Manual 148 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual aborted by pressing any key. 3. Unsolicited result code: When the presentation call waiting at the TA is enabled (and call waiting is enabled) and a terminating call set up during an established call, an unsolicited result code is returned: +CCWA: ,,[,] Example AT+CCWA=1,1 OK ATD10086; OK +CCWA: '02154450293',129,1 //Enable presentation of an unsolicited result code //Establish a call //Indication of a call that has been waiting 10.3. AT+CHLD Call Related Supplementary Services This command allows the control of the following call related services:  A call can be temporarily disconnected from the MT but the connection is retained by the network;  Multiparty conversation (conference calls);  The served subscriber who has two calls (one held and the other either active or alerting) can connect the other parties and release the served subscriber’s own connection. Calls can be put on hold, recovered, released, added to a conversation, and transferred similarly as defined in 3GPP TS 22.030 [19]. This is based on the GSM/UMTS supplementary services HOLD (Call Hold; refer to 3GPP TS 22.083 [5] clause 2 and 3GPP TS 24.610 [135]), MPTY (MultiParty; refer to 3GPP TS 22.084 [22]) and ECT (Explicit Call Transfer; refer to 3GPP TS 22.091 [30] and 3GPP TS 24.629 [139]). The interaction of this command with other commands based on other GSM/UMTS supplementary services is described in the GSM/UMTS standards. Call Hold, MultiParty and Explicit Call Transfer are only applicable to teleservice 11. AT+CHLD Call Related Supplementary Services Test Command AT+CHLD=? Response +CHLD: (list of supported s) Write Command AT+CHLD[=] OK Response TA controls the supplementary services call hold, multiparty and explicit call transfer. Calls can be put on hold, recovered, BG95&BG77&BG600L_Series_AT_Commands_Manual 149 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Maximum Response Time Characteristics Reference 3GPP TS 27.007 released, added to conversation and transferred. OK If there is an error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. 0 Terminate all held calls or UDUB (User Determined User Busy) for a waiting call. If a call is waiting, terminate the waiting call. Otherwise, terminate all held calls (if any). 1 Terminate all active calls (if any) and accept the other call (waiting call or held call) 1X Terminate the specific call number X (X=1-7) 2 Place all active calls on hold (if any) and accept the other call (waiting call or held call) as the active call 2X Place all active calls except call X (X=1-7) on hold 3 Add the held call to the active calls 4 Connects the two calls and disconnects the subscriber from both calls (ECT) Integer type. Error code. Refer to Table 20 for possible values. Example ATD10086; OK +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC +CLCC: 1,0,1,0,0,'10086',129 +CLCC: 2,1,0,0,0,'02154450293',129 OK AT+CHLD=21 OK //Establish a call //Indication of a call that has been waiting //Place the active call on hold and accept the waiting call as the active call //The first call on hold //The second call be active //Place the active call except call X=1 on hold BG95&BG77&BG600L_Series_AT_Commands_Manual 150 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 +CLCC: 2,1,1,0,1,'02154450293',129 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129 +CLCC: 2,1,0,0,1,'02154450293',129 OK //The first call be active //The second call on hold //Add a held call to the active calls in order to set up a conference (multiparty) call 10.4. AT+CLIP Calling Line Identification Presentation This command refers to the GSM/UMTS supplementary service CLIP (Calling Line Identification Presentation) that enables a called subscriber to get the calling line identity (CLI) of the calling party when receiving a mobile terminated call. AT+CLIP Calling Line Identification Presentation Test Command AT+CLIP=? Response +CLIP: (list of supported s) Read Command AT+CLIP? OK Response +CLIP: , Write Command AT+CLIP= OK Response TA enables or disables the presentation of the calling line identity (CLI) at the TE. It has no effect on the execution of the supplementary service CLIP in the network. OK Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: 15 s, determined by the network. / BG95&BG77&BG600L_Series_AT_Commands_Manual 151 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Reference 3GPP TS 27.007 Parameter Integer type. 0 Suppress unsolicited result codes 1 Display unsolicited result codes Integer type. 0 CLIP not provisioned 1 CLIP provisioned 2 Unknown Phone number in string type of calling address in format specified by String type subaddress of format specified by Type of subaddress octet in integer format (refer to 3GPP TS 24.008 [8] subclause 10.5.4.8) Type of address octet in integer format; 129 Unknown type (IDSN format) 145 International number type (ISDN format) 161 National number String type alphanumeric representation of corresponding to the entry found in phone book. Integer type. 0 CLI valid 1 CLI has been withheld by the originator 2 CLI is not available due to interworking problems or limitations of originating network Integer type. Error code. Refer to Table 20 for possible values. NOTE Unsolicited result code: When the presentation of the CLIP at the TE is enabled (and calling subscriber allows), an unsolicited result code is returned after every RING (or +CRING: ) at a mobile terminating call: +CLIP: ,,[subaddr],[satype],[], Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK BG95&BG77&BG600L_Series_AT_Commands_Manual 152 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual RING +CLIP: '02151082965',129,,,'QUECTEL',0 10.5. AT+CLIR Calling Line Identification Restriction This command refers to the CLIR supplementary service (Calling Line Identification Restriction) according to 3GPP TS 22.081 and the OIR supplementary service (Originating Identification Restriction) according to 3GPP TS 24.607 that allows a calling subscriber to enable or disable the presentation of the calling line identity (CLI) to the called party when originating a call. AT+CLIR Calling Line Identification Restriction Test Command AT+CLIR=? Response +CLIR: (list of supported s) Read Command AT+CLIR? OK Response +CLIR: , Write Command AT+CLIR[=] OK Response TA restricts or enables the presentation of the calling line identity (CLI) to the called party when originating a call. The command overrides the CLIR subscription (default is restricted or allowed) when temporary mode is provisioned as a default adjustment for all following outgoing calls. This adjustment can be revoked by using the opposite command. OK Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: 15 s, determined by the network. / Parameter Parameter sets the adjustment for outgoing calls 0 Presentation indicator is used according to the subscription of the CLIR service BG95&BG77&BG600L_Series_AT_Commands_Manual 153 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 1 CLIR invocation 2 CLIR suppression Parameter shows the subscriber CLIR service status in the network 0 CLIR not provisioned 1 CLIR provisioned in permanent mode 2 Unknown (e.g. no network, etc.) 3 CLIR temporary mode presentation restricted 4 CLIR temporary mode presentation allowed Integer type. Error code. Refer to Table 20 for possible values. 10.6. AT+COLP Connected Line Identification Presentation This command refers to the GSM/UMTS supplementary service COLP (Connected Line Identification Presentation) that enables a calling subscriber to get the connected line identity (COL) of the called party after setting up a mobile originated call. The command enables or disables the presentation of the COL at the TE. It has no effect on the execution of the supplementary service COLR in the network. AT+COLP Connected Line Identification Presentation Test Command AT+COLP=? Response +COLP: (list of supported s) Read Command AT+COLP? OK Response +COLP: , Write Command AT+COLP[=] OK Response TA enables or disables the presentation of the COL (Connected Line) at the TE for a mobile originating a call. It has no effect on the execution of the supplementary service COLR in the network. Maximum Response Time Characteristics Reference 3GPP TS 27.007 Intermediate result code is returned from TA to TE before any +CR or V.25ter responses. OK 15 s, determined by the network. / BG95&BG77&BG600L_Series_AT_Commands_Manual 154 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. Parameter sets/shows the result code presentation status in the TA 0 Disable 1 Enable Integer type. Parameter shows the subscriber COLP service status in the network 0 COLP not provisioned 1 COLP provisioned 2 Unknown (e.g. no network, etc.) Phone number in string type. Format specified by . Type of address octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format ) String type subaddress of format specified by Type of subaddress octet in integer format (refer to 3GPP TS 24.008 sub clause 10.5.4.8 ) String type alphanumeric representation of corresponding to the entry found in phone book NOTE Intermediate result code: When enabled (and called subscriber allows), an intermediate result code is returned before any +CR or V.25ter responses: +COLP: ,,[],[],[] Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,,,'QUECTEL' OK 10.7. AT+CSSN Supplementary Service Notifications This command refers to supplementary service related network initiated notifications. The Write Command enables/disables the presentation of notification result codes from TA to TE. BG95&BG77&BG600L_Series_AT_Commands_Manual 155 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CSSN Supplementary Service Notifications Test Command AT+CSSN=? Response +CSSN: (list of supported s),(list of supported s) Read Command AT+CSSN? OK Response +CSSN: , Write Command AT+CSSN=[,] OK Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is any other error: ERROR 300 ms / Parameter Integer type. Sets/shows the +CSSI intermediate result code presentation status to the TE. 0 Disable 1 Enable Integer type. Sets/shows the +CSSU unsolicited result code presentation status to the TE. 0 Disable 1 Enable Integer type. It is manufacturer specific, and supports the following codes: 0 Unconditional call forwarding is active 1 Some of the conditional call forwardings are active 2 Call has been forwarded 3 Waiting call is pending 5 Outgoing call is barred Integer type. It is manufacturer specific, and supports the following codes: 0 The incoming call is a forwarded call 2 Call has been put on hold (during a voice call) BG95&BG77&BG600L_Series_AT_Commands_Manual 156 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 3 Call has been retrieved (during a voice call) 5 Held call was terminated by another party 10 Additional incoming call forwarded Integer type. Error code. Refer to Table 20 for possible values. NOTES 1. When =1 and a supplementary service notification is received after a mobile originated call is setup, the +CSSI intermediate result code is sent to TE before any other MO call setup result codes: +CSSI: 2. When =1 and a supplementary service notification is received during a mobile terminated call setup or during a call, the +CSSU unsolicited result code is sent to TE: +CSSU: BG95&BG77&BG600L_Series_AT_Commands_Manual 157 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 11 Hardware Related Commands 11.1. AT+QPOWD Power down This command powers off the module. The UE will return OK immediately when the command is executed successfully. Then the UE will deactivate the network. After it is completed, the UE outputs POWERED DOWN and enters power-off state. The maximum time for unregistering network is 60 s. To avoid data loss, the power supply for the module cannot be disconnected before the module’s STATUS pin is set low and the URC POWERED DOWN is outputted. AT+QPOWD Power down Test Command AT+QPOWD=? Response +QPOWD: (list of supported s) Write Command AT+QPOWD[=] OK Response OK Maximum Response Time Characteristics POWERED DOWN 300 ms / Parameter 0 1 Immediate power down Normal power down 11.2. AT+CCLK Clock This command sets or queries the real time clock (RTC) of the module. The current setting is retained until the module is totally disconnected from power supply. BG95&BG77&BG600L_Series_AT_Commands_Manual 158 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CCLK Clock Test Command AT+CCLK=? Read Command AT+CCLK? Write Command AT+CCLK= Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response OK Response +CCLK: OK Response OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms / Parameter String type. The format is 'yy/MM/dd,hh:mm:ss±zz', indicating year (last two-digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range: -48...+56). E.g. May 6th, 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08'. Integer type. Error code. Refer to Table 20 for possible values. Example AT+CCLK? +CCLK: '08/01/04,00:19:43+00' OK //Query the local time 11.3. AT+CBC Battery Charge This command returns battery charge status () and battery charge level () of the MT. BG95&BG77&BG600L_Series_AT_Commands_Manual 159 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual AT+CBC Battery Charge Test Command AT+CBC=? Execution Command AT+CBC Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response +CBC: (range of supported s),(range of supported s), OK Response +CBC: ,, OK If there is an error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. Battery charge status 0 ME is not charging 1 ME is charging 2 Charging has been finished Battery charge level 0–100 Battery has 0–100 percent of capacity remaining Battery voltage (mV) Integer type. Error code. Refer to Table 20 for possible values. 11.4. AT+QADC Read ADC Value The command is used to read the voltage value of ADC channel. AT+QADC Read ADC Value Test Command AT+QADC=? Response +QADC: (0) Read Command OK Response BG95&BG77&BG600L_Series_AT_Commands_Manual 160 / 192 AT+QADC= Maximum Response Time LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual +QADC: , OK 300ms Parameter Channel number of the ADC 0 ADC Channel 0 Indicate whether the ADC value is read successfully 0 Fail 1 Success The voltage of specified ADC channel. Unit: mV. 11.5. AT+QSCLK Configure Whether or Not to Enter Sleep Mode This command is used to control whether the module enters sleep mode. When entering sleep mode is enabled and MAIN_DTR is pulled up, the module enters sleep mode directly. If entering sleep mode is enabled and MAIN_DTR is pulled down, there is a need to pull up the MAIN_DTR pin first to make the module enter sleep mode. AT+QSCLK Configure Whether or Not to Enter Sleep Mode Test Command AT+QSCLK=? Response +QSCLK: (list of supported s) Read Command AT+QSCLK? OK Response +QSCLK: Write Command AT+QSCLK= OK Response OK Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. BG95&BG77&BG600L_Series_AT_Commands_Manual 161 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Parameter Integer type. 0 Disable sleep mode 1 Enable sleep mode. It is controlled by MAIN_DTR. 11.6. AT+QTEMP Read Temperature This command is used to read the temperature of PMIC, XO and PA. AT+QTEMP Read Temperature Test Command AT+QTEMP=? Execution Command AT+QTEMP Response OK Response +QTEMP: ,, OK Maximum Response Time If there is any error: ERROR 300ms Parameter PMIC temperature. Unit: degrees celsius. XO temperature. Unit: degrees celsius. PA temperature. Unit: degrees celsius. BG95&BG77&BG600L_Series_AT_Commands_Manual 162 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 12 DFOTA Related AT Command Refer to Quectel_BG95&BG77&BG600L_Series_DFOTA_Application_Note for details of DFOTA function. Table 5: DFOTA Related AT Command Command Description AT+QFOTADL Upgrade firmware via DFOTA AT+QCFGEXT='fota_apn' Configure IP family and APN for DFOTA BG95&BG77&BG600L_Series_AT_Commands_Manual 163 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 13 FTP(S) Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_FTP(S)_Application_Note for details of FTP(S) function. Table 6: FTP(S) Related AT Commands Command AT+QFTPCFG AT+QFTPOPEN AT+QFTPCWD AT+QFTPPWD AT+QFTPPUT AT+QFTPGET AT+QFTPSIZE AT+QFTPDEL AT+QFTPMKDIR AT+QFTPRMDIR AT+QFTPLIST AT+QFTPNLIST AT+QFTPMLSD AT+QFTPMDTM AT+QFTPRENAME AT+QFTPLEN AT+QFTPSTAT AT+QFTPCLOSE Description Configure parameters for FTP(S) server Login to FTP(S) server Configure the current directory on FTP(S) server Get the current directory on FTP(S) server Upload a file to FTP(S) server Download a file from FTP(S) server Get the file size on FTP(S) server Delete a file on FTP(S) server Create a folder on FTP(S) server Delete a folder on FTP(S) server List content of a directory on FTP(S) server List file names of a directory on FTP(S) server List standardized file and directory information Get the file modification time on FTP(S) server Rename a file or folder on FTP(S) server Get the length of transferred data Get the status of FTP(S) server Log out from FTP(S) server BG95&BG77&BG600L_Series_AT_Commands_Manual 164 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 14 HTTP(S) Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_HTTP(S)_Application_Note for details of HTTP(S) function. Table 7: HTTP(S) Related AT Commands Command AT+QHTTPCFG AT+QHTTPURL AT+QHTTPGET AT+QHTTPPOST AT+QHTTPPOSTFILE AT+QHTTPREAD AT+QHTTPREADFILE Description Configure parameters for HTTP(S) server Set URL of HTTP(S) server Send GET request to HTTP(S) server Send POST request to HTTP(S) server via UART/USB Send POST request to HTTP(S) server via file Read response from HTTP(S) server via UART/USB Store the response from HTTP(S) server to a file BG95&BG77&BG600L_Series_AT_Commands_Manual 165 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 15 TCP(IP) Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_TCP(IP)_Application_Note for details of TCP(IP) function. Table 8: TCP/IP Related AT Commands Command AT+QICSGP AT+QIACT AT+QIDEACT AT+QIOPEN AT+QICLOSE AT+QISTATE AT+QISEND AT+QIRD AT+QISENDEX AT+QISWTMD AT+QPING AT+QNTP AT+QIDNSCFG AT+QIDNSGIP AT+QICFG AT+QISDE AT+QIGETERROR Description Configure parameters of a TCP/IP context Activate a PDP context Deactivate a PDP context Open a socket service Close a socket service Query socket service status Send data Retrieve the received TCP/IP data Send hex string data Switch data access mode Ping a remote server Synchronize local time with NTP server Configure address of DNS server Get IP address by domain name Configure optional parameters Control whether to echo the data for AT+QISEND Query the last error code BG95&BG77&BG600L_Series_AT_Commands_Manual 166 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 16 GNSS Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_GNSS_Application_Note for details of GNSS function. Table 9: GNSS Related AT Commands Command AT+QGPSCFG AT+QGPSDEL AT+QGPS AT+QGPSEND AT+QGPSLOC AT+QGPSGNMEA AT+QGPSXTRA AT+QGPSXTRATIME AT+QGPSXTRADATA AT+QCFGEXT Description Configure GNSS Delete assistance data Turn on GNSS Turn off GNSS Acquire positioning information Acquire NMEA sentences Enable gpsOneXTRA assistance function Inject gpsOneXTRA time Inject gpsOneXTRA data file Query and Configure Extended Settings for GNSS BG95&BG77&BG600L_Series_AT_Commands_Manual 167 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 17 SSL Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_SSL_Application_Note for details of SSL function. Table 10: SSL Related AT Commands Command AT+QSSLCFG AT+QSSLOPEN AT+QSSLEND AT+QSSLRECV AT+QSSLCLOSE AT+QSSLSTATE Description Configure parameters of an SSL context Open an SSL socket to connect remote server Send data via SSL connection Receive data via SSL connection Close an SSL connection Query the state of SSL connection BG95&BG77&BG600L_Series_AT_Commands_Manual 168 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 18 FILE Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_FILE_Application_Note for details of FILE function. Table 11: FILE Related AT Commands Command AT+QFLDS AT+QFLST AT+QFDEL AT+QFUPL AT+QFDWL AT+QFOPEN AT+QFREAD AT+QFWRITE AT+QFSEEK AT+QFPOSITION AT+QFTUCAT AT+QFCLOSE AT+QFCRC AT+QFCPY Description Get the space information of storage List file information Delete files Upload a file Download a file Open a file Read a file Write a file Set file pointer to a position Get the offset of a file pointer Truncate a file from the file pointer Close a file Calculate the CRC of a specified UFS file Make a copy of a specified file BG95&BG77&BG600L_Series_AT_Commands_Manual 169 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 19 MQTT Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_MQTT_Application_Note for details of MQTT function. Table 12: MQTT Related AT Commands Command AT+QMTCFG AT+QMTOPEN AT+QMTCLOSE AT+QMTCONN AT+QMTDISC AT+QMTSUB AT+QMTUNS AT+QMTPUB AT+QMTPUBEX AT+QMTRECV Description Configure optional parameters of MQTT Open a network for MQTT client Close a network for MQTT client Connect a client to MQTT server Disconnect a client from MQTT server Subscribe to topics Unsubscribe from topics Publish messages (Data Mode) Publish messages (Command Mode) Read messages from buffers BG95&BG77&BG600L_Series_AT_Commands_Manual 170 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 20 CoAP Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_CoAP_Application_Note for details of CoAP function. Table 13: CoAP Related AT Commands Command AT+QCOAPOPEN AT+QCOAPCLOSE AT+QCOAPHEADER AT+QCOAPOPTION AT+QCOAPSEND AT+QCOAPCFG Description Create a CoAP session Disconnect from CoAP server Configure header of CoAP message Configure options of CoAP message Send CoAP message Configure optional parameters of CoAP client BG95&BG77&BG600L_Series_AT_Commands_Manual 171 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 21 LwM2M Related AT Commands Refer to Quectel_BG95&BG77&BG600L_Series_LwM2M_Application_Note for details of LwM2M function. Table 14: LwM2M Related AT Commands Command AT+QLWCFG AT+QLWSVC Description Configure optional parameters of LwM2M client Select LwM2M client functionality BG95&BG77&BG600L_Series_AT_Commands_Manual 172 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 22 Extended Configuration Commands Refer to the following two documents for details of the extended configuration commands:  Quectel_BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual  Quectel_BG95&BG77&BG600L_Series_QCFGEXT_AT_Commands_Manual Table 12: Extended Configuration Commands Command AT+QCFG='nwscanmode' AT+QCFG='servicedomain' AT+QCFG='nwscanseq' AT+QCFG='band' AT+QCFG='iotopmode' AT+QCFG='celevel' AT+QCFG='nccconf' AT+QCFG='psm/enter' AT+QCFG='simeffect' AT+QCFG='lapiconf' AT+QCFG='snrscan' AT+QCFG='nasconfig' AT+QCFG='apn/display' AT+QCFG='irat/timer' AT+QCFG='nb1/bandprior' AT+QCFG='urc/ri/ring' AT+QCFG='urc/ri/smsincoming' Description Configure RAT(s) to be searched Service domain configuration Configure RATs searching sequence Band configuration Configure network category to be searched under LTE RAT Query NB-IoT coverage enhancement level Configure NB-IoT features Trigger the module into PSM immediately Enable/Disable RAT search order stored in (U)SIM cards Configure low access priority indication feature Configure band scan level under LTE Cat NB Configure NAS related parameters Enable/disable showing of allocated APN Configure high-priority RAT search timer Configure band scan priority under NB-IoT Configure MAIN_RI behavior in case of RING URC Configure MAIN_RI behavior in case of incoming SMS URCs BG95&BG77&BG600L_Series_AT_Commands_Manual 173 / 192 AT+QCFG='urc/ri/other' AT+QCFG='risignaltype' AT+QCFG='urc/delay' AT+QCFG='ledmode' AT+QCFG='gpio' AT+QCFG='airplanecontrol' AT+QCFG='cmux/urcport' AT+QCFG='apready' AT+QCFG='psm/urc' AT+QCFGEXT='addgeo' AT+QCFGEXT='deletegeo' AT+QCFGEXT='querygeo' AT+QCFGEXT='nipdcfg' AT+QCFGEXT='nipd' AT+QCFGEXT='nipds' AT+QCFGEXT='nipdr' AT+QCFGEXT='dump' AT+QCFGEXT='quecopen' AT+QCFGEXT='disusb' AT+QCFGEXT='usb/event' AT+QCFGEXT='fota_apn' AT+QCFGEXT='dnsc_timeout' AT+QCFGEXT='attm2mfeat' LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Configure MAIN_RI behavior in case of other URCs Configure MAIN_RI signal output carrier When to output URC Configure NET_STATUS output mode Configure GPIO status Enable/disable airplane mode control via W_DISABLE# Configure output port of URCs in MUX Mode Configure AP_READY behavior Enable/disable PSM entering indication Add a geo-fence Delete a geo-fence Query the position with respect to geo-fence Configure NIDD connection Open or close NIDD connection Send MO non-IP data Retrieve MT non-IP data Enable/Disable dump mode Enable/Disable QuecOpen function Enable/Disable USB function Get USB events Configure IP family and APN for DFOTA Configure DNS session timeout Enable/Disable AT&T LwM2M feature BG95&BG77&BG600L_Series_AT_Commands_Manual 174 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 23 Appendix 23.1. References Table 15: Related Documents SN Document Name [1] V.25ter [2] 3GPP TS 27.007 [3] 3GPP TS 27.005 Remark Serial asynchronous automatic dialing and control Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; AT command set for User Equipment (UE) Digital cellular telecommunications (Phase 2+); Universal Mobile Telecommunications System (UMTS); LTE; Use of Data Terminal Equipment - Data Circuit terminating Equipment (DTE-DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Table 16: Terms and Abbreviations Abbreviation AMR APN CBM CLIR CoAP CSD DCD DCE DFOTA Description Adaptive Multi-Rate Access Point Name Cell Broadcast Message Calling Line Identification Restriction Constrained Application Protocol Circuit Switch Data Data Carrier Detection Data Communication Equipment Delta Firmware Upgrade Over-The-Air BG95&BG77&BG600L_Series_AT_Commands_Manual 175 / 192 DTE DTR ECT eMTC FTP FTPS GGSN GNSS GPRS HTTP HTTPS IMS IRA LwM2M ME MQTT MS NB-IoT PDP PSC RAT RRC RTS/CTS SGSN SSL LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Data Terminal Equipment Data Terminal Ready Explicit Call Transfer enhanced Machine Type Communication File Transfer Protocol File Transfer Protocol Secure Gateway GPRS Support Node Global Navigation Satellite System General Packet Radio Service Hypertext Transfer Protocol Hypertext Transfer Protocol Secure IP Multimedia Subsystem International Reference Alphabet Lightweight Machine to Machine Mobile Equipment Message Queuing Telemetry Transport Mobile Station Narrowband Internet of Things Packet Data Protocol Primary Synchronization Code Radio Access Technology Radio Resource Control Request To Send/Clear To Send Serving GPRS Support Node Secure Sockets Layer BG95&BG77&BG600L_Series_AT_Commands_Manual 176 / 192 TA TCP TE UDP UE NVRAM VoLTE LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Terminal Adapter Transmission Control Protocol Terminal Equipment User Datagram Protocol User Equipment Non-Volatile Random Access Memory Voice over LTE (Long Term Evolution) 23.2. Factory Default Settings Restorable with AT&F Table 17: Factory Default Settings Restorable with AT&F AT Command ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT&C Parameters Factory Defaults 1 0 0 13 10 8 2 0 2 15 1 4 1 BG95&BG77&BG600L_Series_AT_Commands_Manual 177 / 192 AT&D AT+CREG AT+CGREG AT+CMEE AT+CSCS AT+CSTA AT+CR AT+CRC AT+CSMS AT+CMGF AT+CSMP AT+CSDH AT+CSCB AT+CPMS AT+CNMI AT+CMMS AT+CVHU AT+CLIP AT+COLP AT+CLIR AT+CSSN AT+CTZR AT+CPBS AT+CGEREP AT+CEREG LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual ,,, ,, ,,,, , 1 0 0 1 'GSM' 129 0 0 0 0 17,167,0,0 0 0 'ME','ME','ME' 2,1,0,0,0 0 0 0 0 0 0 0 ME 0,0 0 BG95&BG77&BG600L_Series_AT_Commands_Manual 178 / 192 AT+CCWA AT+CUSD AT+CLVL AT+QAUDMOD AT+QAUDLOOP LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 0 0 3 0 0 23.3. AT Command Settings Storable with AT&W Table 18: AT Command Settings Storable with AT&W AT Command ATE ATQ ATS0 ATS7 ATS10 ATV ATX AT&C AT&D AT+IPR AT+CREG AT+CGREG AT+CEREG Parameters Display with AT&V Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No No BG95&BG77&BG600L_Series_AT_Commands_Manual 179 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 23.4. AT Command Settings Restorable with ATZ Table 19: AT Command Settings Restorable with ATZ AT Command ATE ATQ ATS0 ATS7 ATS10 ATV ATX AT&C AT&D AT+CREG AT+CGREG AT+CEREG Parameters Factory Defaults 1 0 0 0 15 1 4 1 1 0 0 0 23.5. Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation of +CME ERROR: final result code is similar to the regular ERROR result code: if +CME ERROR: is the result code for any of the commands in a command line, none of the following commands in the same command line is executed (neither ERROR nor OK result code shall be returned as a result of a completed command line execution). The format of can be either numeric or verbose. This is set with AT+CMEE. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. BG95&BG77&BG600L_Series_AT_Commands_Manual 180 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Table 20: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 10 11 12 13 14 15 16 17 18 20 21 22 23 24 25 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required (U)SIM failure (U)SIM busy (U)SIM wrong Incorrect password (U)SIM PIN2 required (U)SIM PUK2 required Memory full Invalid index Not found Memory failure Text string too long Invalid characters in text string BG95&BG77&BG600L_Series_AT_Commands_Manual 181 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 23.6. Summary of CMS ERROR Codes Final result code +CMS ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands: Table 21: Different Coding Schemes of +CMS ERROR: Code of 300 301 302 Meaning ME failure SMS ME reserved Operation not allowed BG95&BG77&BG600L_Series_AT_Commands_Manual 182 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 303 Operation not supported 304 Invalid PDU mode 305 Invalid text mode 310 (U)SIM not inserted 311 (U)SIM pin necessary 312 PH (U)SIM pin necessary 313 (U)SIM failure 314 (U)SIM busy 315 (U)SIM wrong 316 (U)SIM PUK required 317 (U)SIM PIN2 required 318 (U)SIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network 332 Network timeout 500 Unknown 512 (U)SIM not ready 513 Message length exceeds 514 Invalid request parameters 515 ME storage failure 517 Invalid service mode 528 More message to send state error BG95&BG77&BG600L_Series_AT_Commands_Manual 183 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 529 MO SMS is not allow 530 GPRS is suspended 531 ME storage full 23.7. Summary of URC Table 22: Summary of URC Index URC Display Meaning Condition 1 +CREG: Indicate registration status of the ME AT+CREG=1 After cell neighborhood changing +CREG: [,[],[], shows whether the network has 2 AT+CREG=2 []] currently indicated the registration of the ME, with location area code 3 +CGREG: Indicate network registration status of AT+CGREG=1 the ME +CGREG: [,[],[],[],[]] location information of the ME 5 +CTZV: Time zone reporting AT+CTZR=1 6 +CTZE: ,, Extended time zone reporting AT+CTZR=2 7 +CMTI: , New message is received, and saved See AT+CNMI to memory +CMT: [], output directly to TE (PDU mode) +CMT: ,[], [,,,,,,, ] +CBM: directly (PDU mode) +CBM: ,,,, +CDS: directly (PDU mode) BG95&BG77&BG600L_Series_AT_Commands_Manual 184 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual +CDS: ,,[],[],,, directly to TE (Text mode) 14 +CDSI: , New message status report is See AT+CNMI received, and saved to memory The presentation of the COL +COLP: ,,[],[],[] mobile originated call +CLIP: ,,[sub 16 addr],[satype],[], AT+CLIP=1 An incoming call is indicated to the 17 +CRING: TE with unsolicited result code AT+CRC=1 instead of the normal RING +CCWA: ,,[,] AT+CCWA=1,1 19 +CSSI: Shows the +CSSI intermediate result AT+CSSN=1 code presentation status to the TE 20 +CSSU: Shows the +CSSU unsolicited result AT+CSSN=,1 code presentation status to the TE 21 APP RDY AP core initialization is successful N/A 22 RDY ME initialization is successful N/A 23 +CFUN: 1 All function of the ME is available N/A 24 +CPIN: SIM card pin state N/A 25 +QIND: SMS DONE SMS initialization finished N/A 26 POWERED DOWN Module power down AT+QPOWD +CGEV: REJECT , and was automatically rejected. +CGEV: NW REACT ,,[] reactivation +CGEV: NW DEACT ,,[] deactivation +CGEV: ME DEACT ,,[] deactivation. 31 +CGEV: NW DETACH The network has forced a Packet AT+CGEREP=2,1 Domain detach. 32 +CGEV: ME DETACH The mobile equipment has forced a AT+CGEREP=2,1 Packet Domain detach. BG95&BG77&BG600L_Series_AT_Commands_Manual 185 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual The network has forced a change of 33 +CGEV: NW CLASS AT+CGEREP=2,1 MS class. The mobile equipment has forced a 34 +CGEV: ME CLASS AT+CGEREP=2,1 change of MS class. 23.8. SMS Character Sets Conversions In 3GPP TS 23.038 DCS (Data Coding Scheme) defined three kinds of alphabets in SMS: GSM 7 bit default alphabet, 8 bit data and UCS2 (16bit). AT+CSMP can set the DCS in text mode (AT+CMGF=1). In text mode, DCS (Data Coding Scheme) and AT+CSCS determine the way of SMS text input or output. Table 23: The Way of SMS Text Input or Output DCS GSM 7 bit GSM 7 bit GSM 7 bit UCS2 8 bit AT+CSCS GSM IRA UCS2 - The Way of SMS Text Input or Output Input or output GSM character sets. Input or output IRA character sets. Input: UE will convert IRA characters to GSM characters. Output: UE will convert GSM characters to IRA characters. Input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Input: UE will convert the UCS2 hex string to GSM characters. Output: UE will convert the GSM characters to UCS2 hex string. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. Ignore the value of AT+CSCS, input or output a hex string similar to PDU mode. So only support characters ‘0’-‘9’ and ‘A’-‘F’. When DCS=GSM 7 bit, the input or output needs conversion. The detailed conversion tables are shown as below. Table 24: The Input Conversions Table (DCS=GSM 7 bit and AT+CSCS='GSM') 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 BG95&BG77&BG600L_Series_AT_Commands_Manual 186 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 9 09 19 29 39 49 59 69 79 A 0A Submit 2A 3A 4A 5A 6A 7A B 0B Cancel 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 25: The Output Conversions Table (DCS=GSM 7 bit and AT+CSCS='GSM') 0 1 2 3 4 5 6 7 0 00 10 20 30 40 50 60 70 1 01 11 21 31 41 51 61 71 2 02 12 22 32 42 52 62 72 3 03 13 23 33 43 53 63 73 4 04 14 24 34 44 54 64 74 5 05 15 25 35 45 55 65 75 6 06 16 26 36 46 56 66 76 7 07 17 27 37 47 57 67 77 8 08 18 28 38 48 58 68 78 BG95&BG77&BG600L_Series_AT_Commands_Manual 187 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 9 09 19 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A B 0B 2B 3B 4B 5B 6B 7B C 0C 1C 2C 3C 4C 5C 6C 7C D 0D 1A 2D 3D 4D 5D 6D 7D E 0E 1E 2E 3E 4E 5E 6E 7E F 0F 1F 2F 3F 4F 5F 6F 7F Table 26: GSM Extended Characters (GSM Encode) 0 1 2 3 4 5 6 7 0 1B40 1 2 3 4 1B14 5 6 7 8 1B28 9 1B29 A B C 1B3C D 1B3D E 1B3E F 1B2F BG95&BG77&BG600L_Series_AT_Commands_Manual 188 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual Table 27: The Input Conversions Table (DCS=GSM 7 bit and AT+CSCS='IRA') 0 1 2 3 4 5 6 0 20 20 30 00 50 20 1 20 20 21 31 41 51 61 2 20 20 22 32 42 52 62 3 20 20 23 33 43 53 63 4 20 20 02 34 44 54 64 5 20 20 25 35 45 55 65 6 20 20 26 36 46 56 66 7 20 20 27 37 47 57 67 8 backspace 20 28 38 48 58 68 9 20 20 29 39 49 59 69 A 0A Submit 2A 3A 4A 5A 6A B 20 Cancel 2B 3B 4B 1B3C 6B C 20 20 2C 3C 4C 1B2F 6C D 0D 20 2D 3D 4D 1B3E 6D E 20 20 2E 3E 4E 1B14 6E F 20 20 2F 3F 4F 11 6F 7 70 71 72 73 74 75 76 77 78 79 7A 1B28 1B40 1B29 1B3D 20 Table 28: IRA Extended Characters A B C D E F 0 20 20 20 20 7F 20 1 40 20 20 5D 20 7D 2 20 20 20 20 20 08 3 01 20 20 20 20 20 BG95&BG77&BG600L_Series_AT_Commands_Manual 189 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual 4 24 20 5B 20 7B 20 5 03 20 0E 20 0F 20 6 20 20 1C 5C 1D 7C 7 5F 20 09 20 20 20 8 20 20 20 0B 04 0C 9 20 20 1F 20 05 06 A 20 20 20 20 20 20 B 20 20 20 20 20 20 C 20 20 20 5E 07 7E D 20 20 20 20 20 20 E 20 20 20 20 20 20 F 20 60 20 1E 20 20 Table 29: The Output Conversions Table (DCS=GSM 7 bit and AT+CSCS='IRA') 0 1 2 3 4 5 6 7 0 40 20 20 30 A1 50 BF 70 1 A3 5F 21 31 41 51 61 71 2 24 20 22 32 42 52 62 72 3 A5 20 23 33 43 53 63 73 4 E8 20 A4 34 44 54 64 74 5 E9 20 25 35 45 55 65 75 6 F9 20 26 36 46 56 66 76 7 EC 20 27 37 47 57 67 77 8 F2 20 28 38 48 58 68 78 9 C7 20 29 39 49 59 69 79 A 0D0A 2A 3A 4A 5A 6A 7A BG95&BG77&BG600L_Series_AT_Commands_Manual 190 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual B D8 2B 3B 4B C4 6B E4 C F8 C6 2C 3C 4C D6 6C F6 D 0D E6 2D 3D 4D D1 6D F1 E C5 DF 2E 3E 4E DC 6E FC F E5 C9 2F 3F 4F A7 6F E0 Table 30: GSM Extended Characters (ISO-8859-1/Unicode) 0 1 2 3 4 5 6 7 0 7C 1 2 3 4 5E 5 6 7 8 7B 9 7D A B C 5B D 7E E 5D F 5C Because the low 8-bit of UCS2 character is the same as the IRA character: BG95&BG77&BG600L_Series_AT_Commands_Manual 191 / 192 LPWA Module Series BG95&BG77&BG600L Series AT Commands Manual  The conversion table of DCS=GSM 7 bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'.  The conversion table of fmt=GSM 7 bit and AT+CSCS='GSM' is similar to AT+CSCS='GSM'.  The conversion table of fmt= GSM 7 bit and AT+CSCS='IRA' is similar to AT+CSCS='IRA'.  The conversion table of fmt=GSM 7 bit and AT+CSCS='UCS2' is similar to AT+CSCS='IRA'. BG95&BG77&BG600L_Series_AT_Commands_Manual 192 / 192

BC26&BC20&BC030x 系列 AT 命令手册 NB-IoT 模块系列 版本：BC26&BC20&BC030x 系列_AT 命令手册_V1.0 日期：2020-03-12 状态：受控文件 www.quectel.com BC26&BC20&BC030x 系列 AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 106 BC26&BC20&BC030x 系列 AT 命令手册 文档历史 修订记录 版本 1.0 日期 作者 2020-03-12 饶晨 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 106 BC26&BC20&BC030x 系列 AT 命令手册 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 定义 ............................................................................................................................................ 7 1.2. AT 命令语法 ............................................................................................................................... 7 1.3. 数据模式说明.............................................................................................................................. 8 2 产品信息查询命令 ................................................................................................................................. 9 2.1. ATI 显示产品标识信息 ............................................................................................................. 9 2.2. AT+CGMI 查询平台信息........................................................................................................ 10 2.3. AT+CGMM 查询模块型号...................................................................................................... 10 2.4. AT+CGMR 查询制造商版本号............................................................................................... 11 2.5. AT+CGSN 查询产品序列号 ................................................................................................... 12 3 UART 功能命令................................................................................................................................... 14 3.1. ATE 设置命令回显模式.......................................................................................................... 14 3.2. AT+IPR 设置 TE-TA 的波特率............................................................................................... 15 4 网络状态查询命令 ............................................................................................................................... 17 4.1. AT+CSQ 上报信号质量 ......................................................................................................... 17 4.2. AT+CESQ 扩展信号质量 ....................................................................................................... 18 4.3. AT+CEREG EPS 网络注册状态 ............................................................................................ 20 4.4. AT+CGATT PS 域附着或去附着 ........................................................................................... 23 4.5. AT+QENG 网络服务信息 ...................................................................................................... 25 4.6. AT+CGPADDR 显示 PDP 地址 ............................................................................................. 28 4.7. AT+CSCON RRC 连接状态................................................................................................... 30 5 PDN 和 APN 相关命令 ........................................................................................................................ 32 5.1. AT+CGDCONT 定义 PDP 上下文 ......................................................................................... 32 5.2. AT+CGACT PDP 上下文激活/去激活.................................................................................... 36 5.3. AT+CIPCA 初始 PDP 上下文激活 ......................................................................................... 37 5.4. AT+CGAPNRC APN 速率控制.............................................................................................. 39 5.5. AT+QGACT 激活/去激活 PDN 上下文 .................................................................................. 40 5.6. AT+QCGDEFCONT 配置默认的 APN/PDN 连接.................................................................. 42 6 其他网络命令....................................................................................................................................... 44 6.1. AT+COPS PLMN 选择 .......................................................................................................... 44 6.2. AT+CCIOTOPT CloT 优化配置 ............................................................................................. 46 6.3. AT+QBAND 查询/设置工作频段 ............................................................................................ 47 6.4. AT+QBANDSL 设置优先搜索的频段列表.............................................................................. 49 6.5. AT+QLOCKF 锁定 NB-IoT 频点及 PCI.................................................................................. 50 6.6. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表 ........................................................ 51 上海移远通信技术股份有限公司 3 / 106 BC26&BC20&BC030x 系列 AT 命令手册 7 USIM 相关命令.................................................................................................................................... 52 7.1. AT+CIMI 查询 USIM 卡 IMSI ................................................................................................. 52 7.2. AT+CLCK 设备锁 .................................................................................................................. 53 7.3. AT+CPIN 输入 PIN ................................................................................................................ 54 7.4. AT+CPLS 优先 PLMN 列表选择.......................................................................................... 56 7.5. AT+CPOL 优先 PLMN 列表................................................................................................... 57 7.6. AT+CPWD 更改密码 ............................................................................................................. 59 7.7. AT+CRSM USIM 卡有限访问 ................................................................................................ 60 7.8. AT+QCCID USIM 卡识别 ...................................................................................................... 62 8 功耗相关命令....................................................................................................................................... 63 8.1. AT+CFUN 设置 UE 功能 ....................................................................................................... 63 8.2. AT+CPSMS 省电模式（PSM）设置 ..................................................................................... 64 8.3. AT+CEDRXS eDRX 设置 ...................................................................................................... 66 8.4. AT+CEDRXRDP 查询 eDRX 状态 ........................................................................................ 69 8.5. AT+QEDRXCFG eDRX 和 PTW 设置................................................................................... 71 8.6. AT+QNBIOTRAI NB-IoT 释放辅助指示................................................................................. 74 8.7. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 .......................................................... 75 8.8. AT+QRELLOCK 释放 AT 命令休眠锁 ................................................................................... 76 8.9. AT+QSCLK 配置休眠模式 ..................................................................................................... 76 9 平台相关命令....................................................................................................................................... 78 9.1. AT&W 存储当前参数到 NVRAM............................................................................................ 78 9.2. AT+CBC 查询电源电压.......................................................................................................... 78 9.3. AT+QADC 读取 ADC 通道输入电压值 .................................................................................. 79 9.4. AT+CMEE 启用/禁用移动终端错误上报................................................................................ 81 9.5. AT+CEER 扩展错误报告 ....................................................................................................... 82 9.6. AT+QRST 自动重启 .............................................................................................................. 83 9.7. AT+QATWAKEUP 启用/禁用深休眠唤醒指示....................................................................... 83 9.8. AT+QCFG 系统配置 .............................................................................................................. 84 9.9. AT+QPOWD 模块关机/重启 .................................................................................................. 86 9.10. AT+QVBATT 配置电压阈值................................................................................................... 87 10 时间相关命令....................................................................................................................................... 89 10.1. AT+CCLK 设置/查询当前日期和时间 .................................................................................... 89 10.2. AT+CTZR 上报时区变化 ....................................................................................................... 90 10.3. AT+QCCLK 设置/查询当前日期和 UTC ................................................................................ 91 11 其它命令 .............................................................................................................................................. 93 11.1. TCP/IP 相关 AT 命令................................................................................................................ 93 11.2. MQTT 相关 AT 命令 ................................................................................................................. 94 11.3. SSL 相关 AT 命令..................................................................................................................... 94 11.4. LwM2M 相关 AT 命令............................................................................................................... 95 11.5. 电信 IoT 平台相关 AT 命令....................................................................................................... 95 11.6. OneNET 相关 AT 命令 ............................................................................................................. 96 11.7. CMDMP 相关 AT 命令.............................................................................................................. 97 上海移远通信技术股份有限公司 4 / 106 BC26&BC20&BC030x 系列 AT 命令手册 11.8. 中国电信/联通自注册相关 AT 命令........................................................................................... 98 11.9. DFOTA 相关 AT 命令 ............................................................................................................... 98 12 错误代码汇总....................................................................................................................................... 99 12.1. 常见错误代码列表 .................................................................................................................... 99 12.2. 指定错误代码列表 .................................................................................................................. 100 13 附录 A 术语缩写 ............................................................................................................................... 102 13.1. 参考文档 ................................................................................................................................. 102 13.2. 术语缩写 ................................................................................................................................. 103 上海移远通信技术股份有限公司 5 / 106 BC26&BC20&BC030x 系列 AT 命令手册 表格索引 表 1：AT 命令格式 ....................................................................................................................................... 8 表 2：TCP/IP 相关 AT 命令列表 ................................................................................................................ 93 表 3：MQTT 相关 AT 命令列表 .................................................................................................................. 94 表 4：SSL 相关 AT 命令列表 ..................................................................................................................... 94 表 5：LwM2M 相关 AT 命令列表 ............................................................................................................... 95 表 6：电信 IoT 平台相关 AT 命令列表........................................................................................................ 96 表 7：OneNET 相关 AT 命令列表 .............................................................................................................. 96 表 8：CMDMP 相关 AT 命令列表 .............................................................................................................. 97 表 9：中国电信/联通自注册相关 AT 命令列表 ........................................................................................... 98 表 10：DFOTA 相关 AT 命令列表.............................................................................................................. 98 表 11：常见错误代码列表（27.007）........................................................................................................ 99 表 12：指定错误代码列表 ........................................................................................................................ 100 表 13：参考文档 ....................................................................................................................................... 102 表 14：术语缩写 ....................................................................................................................................... 103 上海移远通信技术股份有限公司 6 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 引言 本文档详细介绍了如下移远通信 NB-IoT 模块支持的 AT 命令集：  BC26  BC20  BC030x 系列（包含 BC3030S-CN 和 BC030N-B5） 模块默认处于自适应波特率模式。模块上电后，MCU 必须连续发送 AT 命令以便和模块进行波特率同 步，直至返回 OK。同步成功后，MCU 可以发送 AT+IPR=命令配置后续通信的波特率。若未指定波 特率，则应在下次重启时重新同步。 1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明，配 置命令中的可选参数被省略时，将使用其保存至 NVRAM 的值或其默认值。 参数的默认设置。 1.2. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应，省略 。 BC26、BC20 和 BC030x 系列模块实现的 AT 命令可以在语法上分为两类：基础类和扩展类，如下所 列。  基础类 基础类 AT 命令的格式为 AT 或 AT&，其中 是命令， 是该命令的参数。以 ATE 为例，DCE 会根据< value> 的取值确定是否将接收到的字符回显给 DTE。若 为可选 参数，则其被省略时将使用其默认值或已保存至 NVRAM 的设置值。 上海移远通信技术股份有限公司 7 / 106 BC26&BC20&BC030x 系列 AT 命令手册  扩展类 扩展类 AT 命令可以在多种模式下运行，如下表所示： 表 1：AT 命令格式 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令或内部程序可支持的参数取值列表或范 围。 AT+? 返回相应设置命令的当前参数设置值。 AT+=[,[, 设置用户可自定义的参数值。 [...]]] AT+ 主动执行内部程序实现的功能集。 备注 每次仅支持执行一个 AT 命令。仅当上一个命令执行完成后，方可执行下一个命令。 1.3. 数据模式说明 BC26、BC20 和 BC030x 系列模块支持两种串口模式：命令模式和数据模式。命令模式下，通过串口 输入的数据会被视为 AT 命令去解析；而数据模式下，通过串口输入的数据则被视为普通数据。 命令模式下，当串口输出 > 后，模块会在 500 毫秒内进入数据模式。之后若通过串口输入 Ctrl+Z 则模 块退出数据模式并处理接收到的数据，若通过串口输入 Esc 则模块退出数据模式并丢弃本次输入的数据。 备注 1. 命令模式下，当串口输出 > 后，建议 MCU 等待 500 毫秒后再发送实际数据。 2. 数据模式下，URC 会被直接丢弃，因此建议不要在数据模式下有等待动作，请尽快完成数据输入并 退出数据模式。 上海移远通信技术股份有限公司 8 / 106 BC26&BC20&BC030x 系列 AT 命令手册 2 产品信息查询命令 2.1. ATI 显示产品标识信息 该命令返回产品标识信息，如设备型号和固件版本号。 ATI 显示产品标识信息 执行命令 ATI 响应 Quectel_Ltd Revision: 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。设备型号。 字符串类型。固件版本号。 举例 ATI Quectel_Ltd Quectel_BC26 Revision: BC26NCR01A07 OK 上海移远通信技术股份有限公司 9 / 106 BC26&BC20&BC030x 系列 AT 命令手册 2.2. AT+CGMI 查询平台信息 该命令用于查询平台信息。 AT+CGMI 查询平台信息 测试命令 AT+CGMI=? 执行命令 AT+CGMI 最大响应时间 特性说明 响应 OK 响应 Quectel_Ltd Revision: MTK_2625 OK 300 毫秒 / 参数 字符串类型。设备型号。 举例 AT+CGMI Quectel_Ltd Quectel_BC26 Revision: MTK_2625 OK 2.3. AT+CGMM 查询模块型号 该命令用于查询模块型号。 AT+CGMM 查询模块型号 测试命令 AT+CGMM=? 执行命令 AT+CGMM 响应 OK 响应 上海移远通信技术股份有限公司 10 / 106 BC26&BC20&BC030x 系列 AT 命令手册 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。设备型号。 举例 AT+CGMM Quectel_BC26 OK 2.4. AT+CGMR 查询制造商版本号 该命令返回制造商版本号，默认为固件版本号。 AT+CGMR 查询制造商版本号 测试命令 AT+CGMR=? 执行命令 AT+CGMR 响应 OK 响应 Revision: 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。固件版本号。 上海移远通信技术股份有限公司 11 / 106 举例 AT+CGMR Revision: BC26NCR01A07 OK BC26&BC20&BC030x 系列 AT 命令手册 2.5. AT+CGSN 查询产品序列号 该命令返回产品的 IMEI 号及相关信息。对于不支持的 TA，仅返回 OK。 AT+CGSN 查询产品序列号 测试命令 AT+CGSN=? 响应 TE 支持且命令执行成功时： +CGSN: (支持的范围) 查询命令 AT+CGSN= OK 响应 当=0 时： OK 当=1 时 +CGSN: OK 当=2 时 +CGSN: OK 当=3 时 +CGSN: OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 12 / 106 执行命令 AT+CGSN 最大响应时间 特性说明 BC26&BC20&BC030x 系列 AT 命令手册 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。被请求的序列号类型。 0 128 位 UUID 1 IMEI 2 IMEISV 3 SVN 字符串类型。UE 的 128 位 UUID。信息文本（包括行终止符在内）的字符总数不应 超过 2048 个字符，且不包含 0或 OK序列。 十进制格式的字符串类型。产品的 IMEI。 十进制格式的字符串类型。产品的 IMEISV。 十进制格式的字符串类型。产品的 SVN，属于 IMEISV 的一部分。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CGSN=1 +CGSN: 490154203237511 OK //查询 IMEI 号 上海移远通信技术股份有限公司 13 / 106 BC26&BC20&BC030x 系列 AT 命令手册 3 UART 功能命令 3.1. ATE 设置命令回显模式 该命令用于设置 UE 是否回显从外部接收的命令。 ATE 设置命令回显模式 执行命令 ATE 最大响应时间 特性说明 响应 OK 300 毫秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。 0 不回显命令 1 回显命令 举例 ATE0 OK ATI Quectel_Ltd Quectel_BC26 Revision: BC26NCR01A07 OK ATE1 OK ATI ATI Quectel_Ltd Quectel_BC26 上海移远通信技术股份有限公司 14 / 106 Revision: BC26NCR01A07 OK BC26&BC20&BC030x 系列 AT 命令手册 3.2. AT+IPR 设置 TE-TA 的波特率 该命令用于设置 TE-TA 的波特率。 AT+IPR 设置 TE-TA 的波特率 测试命令 AT+IPR=? 响应 +IPR: (支持的自适应列表),(支持的固定列表) 查询命令 AT+IPR? OK 响应 +IPR: 设置命令 AT+IPR= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。每秒波特率。 0 （自适应波特率） 110 300 1200 2400 4800 9600 19200 38400 上海移远通信技术股份有限公司 15 / 106 BC26&BC20&BC030x 系列 AT 命令手册 57600 115200 230400 460800 921600 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 该设置将应用于同一个 UART 连接级别路由的所有信道。 2. 该命令不适用于 USB 接口。 3. 模块仅支持同步 115200 bps 及以下的波特率。 举例 AT+IPR=115200 OK AT+IPR? +IPR: 115200 OK //将波特率固定为 115200 bps 上海移远通信技术股份有限公司 16 / 106 BC26&BC20&BC030x 系列 AT 命令手册 4 网络状态查询命令 4.1. AT+CSQ 上报信号质量 该命令可返回接收信号强度指示和信道误码率。 AT+CSQ 上报信号质量 测试命令 AT+CSQ=? 响应 +CSQ: (支持的列表),(支持的列表) 执行命令 AT+CSQ OK 响应 +CSQ: , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。接收信号强度指示。 0 -113 dBm 或以下 1 -111 dBm 2-30 -109 至-53 dBm 31 -51 dBm 或以上 99 未知 整型。信道误码率（百分比）。 0-7 RxQual 值（RxQual_0 至 RxQual_7 的定义，请参阅 3GPP TS 45.008） 99 未知 上海移远通信技术股份有限公司 17 / 106 备注 该命令不适用于 BC3030S-CN。 举例 AT+CSQ +CSQ: 22,0 OK BC26&BC20&BC030x 系列 AT 命令手册 4.2. AT+CESQ 扩展信号质量 执行命令返回接收信号质量参数。 终端将提供 0 到 99 的信号强度指示，通常数值越大强度越高。 AT+CESQ 扩展信号质量 测试命令 AT+CESQ=? 响应 +CESQ: (支持的列表),(支持的列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表),(支持的列表) 执行命令 AT+CESQ OK 响应 +CESQ: ,,,,, OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 18 / 106 BC26&BC20&BC030x 系列 AT 命令手册 参数 整型。接收信号强度等级。 0 < -110 dBm 1 -110 dBm ≤ < -109 dBm 2 -109 dBm ≤ < -108 dBm … 61 -50 dBm ≤ < -49 dBm 62 -49 dBm ≤ < -48 dBm 63 -48 dBm ≤ 99 未知 整型。信道误码率（百分比）。 0-7 RxQual 值（RxQual_0 至 RxQual_7 的定义，请参阅 3GPP TS 45.008） 99 未知 整型。接收信号码功率（参见 3GPP 25.133 和 3GPP 25.123）。 0 -120 dBm 或以下 1 -120 dBm ≤ < -119 dBm 2 -119 dBm ≤ < -118 dBm … 94 -27 dBm ≤ < -26 dBm 95 -26 dBm ≤ < -25 dBm 96 -25 dBm ≤ 255 未知 整型。Ec/No（参见 3GPP 25.133）。 0 -24 dBm 或以下 1 -24 dBm ≤ < -23.5 dBm 2 -23.5 dBm ≤ < -23 dBm … 47 -1 dBm ≤ < -0.5 dBm 48 -0.5 dBm ≤ < 0 dBm 49 0 dBm ≤ 255 未知 整型。参考信号接收质量 （参见 3GPP 25.133）。需要发送数据时，建议 RSRQ 大于-10 dB。 0 -19.5 dB 或以下 1 -19.5 dB ≤ < -19 dB 2 -19 dB ≤ < -18.5 dB … 32 -4 dB ≤ < -3.5 dB 33 -3.5 dB ≤ < -3 dB 34 -3 dB ≤ 255 未知 整型。参考信号接收功率（参见 3GPP 25.133）。需要发送数据时，建议 RSRP 大于-115 dBm。 0 -140 dBm 或以下 上海移远通信技术股份有限公司 19 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 -140 dBm ≤ < -139 dBm 2 -139 dBm ≤ < -138 dBm … 95 -46 dBm ≤ < -45 dBm 96 -45 dBm ≤ < -44 dBm 97 -44 dBm ≤ 255 未知 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 和不适用于 NB-IoT 网络，应设置为未知（255）。 2. 为便于了解网络环境，可根据以下通用规则评估网络质量：  强：RSRP ≥ -10 0dBm，且 RSRQ ≥ -7 dB  中：-100 dBm ≥ RSRP ≥ -110 dBm，且 RSRQ ≥ -11 dB  弱：RSRP < -115 dBm 或 RSRQ < -11 dB 举例 AT+CESQ +CESQ: 15,99,255,255,8,30 OK 4.3. AT+CEREG EPS 网络注册状态 设置命令用于设置 EPS 网络注册状态 URC 的显示：  =1 设置 URC +CEREG: 的显示，该 URC 指示 E-UTRAN 中 MT 的 EPS 网络注册状 态的变化。  =2 设置 URC +CEREG: [,[],[],[]]的显示，该 URC 指示 E-UTRAN 中 的网络小区发生变化；参数、和仅在可用时才会上报；  在 =2 的 基 础 上 ， =3 进 一 步 设 置 当 的 值 改 变 时 在 URC 中 显 示 更 多 参 数 和 （若可用）； 若 UE 请求 PSM 降低其功耗，则设置命令还可控制以下 URC 的显示：+CEREG: [,[],[< ci>],[][,[],[][,[],[]]]]。 当=4 时，若 E-UTRAN 中的网络小区发生变化，则显示的 URC 将向 UE 提供额外信息，如激活时 间值 和扩展的周期性 TAU 值。当=5 时，若的值发生改变，URC 将会比=4 时多上报和参数。参数、,、、 、和仅在可用时才会上报。 上海移远通信技术股份有限公司 20 / 106 BC26&BC20&BC030x 系列 AT 命令手册 查询命令返回 URC 显示的状态，同时返回整型参数以指示 MT 是否已经注册到当前网络。位置 信息参数、和如果可用，仅在=2 且 MT 已注册到网络时上报。参数,如果可用，仅在=3 时上报。 测试命令返回支持的参数值。 AT+CEREG EPS 网络注册状态 测试命令 AT+CEREG=? 响应 +CEREG: (支持的列表) 查询命令 AT+CEREG? OK 响应 当=0、1、2 或 3 且命令成功执行时： +CEREG: ,[,[],[],[[,,]]] 当=4 或 5 并且命令成功执行时： +CEREG: ,[,[],[],[][,[],[][,[],[]]]] OK 设置命令 AT+CEREG= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；保存至 NVRAM（需先执行 AT&W）。 参数 整型。 0 禁止上报网络注册状态 URC 上海移远通信技术股份有限公司 21 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 允许上报网络注册状态 URC +CEREG: 2 允许上报网络注册状态和位置信息 URC +CEREG: [,[],[],[]] 3 允许上报网络注册状态、位置信息和 EMM 原因值 URC +CEREG: [,[], [],[][,,]] 4 对 于 请 求 PSM 的 UE ， 允 许 上 报 网 络 注 册 状 态 和 位 置 信 息 URC +CEREG: [,[],[],[][,,[,[],[]]]] 5 对于请求 PSM 的 UE，允许上报网络注册状态、位置信息和 EMM 原因值 URC +CEREG: [,[],[],[][,[],[][,[, []]]] 整型。EPS 注册状态。 0 未注册，MT 当前未搜索网络 1 已注册，归属网络 2 未注册，但 MT 当前正在尝试附着或搜索网络以进行注册 3 注册被拒绝 4 未知（例如：超出 E-UTRAN 覆盖范围） 5 已注册，漫游状态 字符串类型。跟踪区码，两个字节，十六进制格式（例如，'00C3'等于十进制的 195）。 字符串类型。位置区码，两个字节，十六进制格式（例如，'00C3'等于十进制的 195）。 字符串类型。E-UTRAN 小区 ID，四个字节，十六进制格式。 整型。注册网络的接入技术。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 整型。的类型 0 包含 EMM 原因值（请参见 3GPP TS 24.008 [8] Annex G） 1 包含特定制造商的原因值 整型。包含注册失败的原因。该参数的类型由定义。请参见 3GPP TS 24.301。 字符串类型。E-UTRAN 中分配给 UE 的激活时间值（T3324），八位为一个字节。激 活时间值被编码为 GPRS Timer 2 信息元素的一个字节（octet 3），所述信息元素编码 为位格式（例如'00100100' 等于 4 分钟）。有关编码和取值范围，请参阅 3GPP TS 24.008 Table 10.5.163/3GPP TS 24.008，3GPP TS 23.682 以及 3GPP TS 23.401 中 的 GPRS Timer 2 IE。 第 5 位至第 1 位表示二进制编码的定时器值。 第 6 位至第 8 位定义 GPRS 定时器步长，如下所示： 位 8 7 6 0 0 0 步长为 2 秒 0 0 1 步长为 1 分钟 0 1 0 步长为 6 分钟 1 1 1 停用该定时器 字符串类型。E-UTRAN 中分配给 UE 的扩展的周期性 TAU 值（T3412），八位为一个 字节。扩展的周期性 TAU 值被编码为 GPRS Timer 3 信息元素的一个字节（octet 3）， 所述信息元素编码为位格式（例如'01000111' 等于 70 小时）。有关编码和取值范围， 请参阅 3GPP TS 24.008 Table 10.5.163a/3GPP TS 24.008, 3GPP TS 23.682 以及 上海移远通信技术股份有限公司 22 / 106 BC26&BC20&BC030x 系列 AT 命令手册 3GPP TS 23.401 中的 GPRS Timer 3 IE。 第 5 位至第 1 位表示二进制编码的定时器值 第 8 位至第 6 位定义定时器步长，如下所示： 位 8 7 6 0 0 0 步长为 10 分钟 0 0 1 步长为 1 小时 0 1 0 步长为 10 小时 0 1 1 步长为 2 秒 1 0 0 步长为 30 秒 1 0 1 步长为 1 分钟 1 1 0 步长为 320 小时 1 1 1 停用该定时器 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CEREG=1 OK AT+CEREG? +CEREG: 1,1 OK AT+CEREG=? +CEREG: (0-5) OK //允许上报网络注册状态 URC 4.4. AT+CGATT PS 域附着或去附着 设置命令用于将 MT 附着于 PS 域，或者将 MT 从 PS 域去附着。命令完成后，MT 保持在 V.250 命令 状态。如果 MT 已经处于请求状态，则将忽略该命令，并且仍将响应 OK。如果 MT 无法实现请求状态，将 响应 ERROR 或+CME ERROR。 当附着状态更改为去附着状态时，将自动去激活所有已激活的 PDP 上下文。 查询命令返回当前 PS 域服务状态。 测试命令返回支持的 PS 域服务状态。 上海移远通信技术股份有限公司 23 / 106 BC26&BC20&BC030x 系列 AT 命令手册 AT+CGATT PS 域附着或去附着 测试命令 AT+CGATT=? 响应 +CGATT: (支持的列表) 查询命令 AT+CGATT? OK 响应 +CGATT: 设置命令 AT+CGATT= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 85 秒，取决于网络 / 参数 整型。PDP 上下文激活状态。 0 去附着 1 附着 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 如果支持初始 PDP 上下文建立，则在模块注网时会自动定义=1 的上下文。 2. 如果 AT+CGATT 命令正在执行中，在完成附着或去附着过程之前再次执行该命令将返回错误。 举例 AT+CGATT? +CGATT: 0 OK AT+CGATT=1 OK AT+CGATT=? 上海移远通信技术股份有限公司 24 / 106 +CGATT: (0,1) OK BC26&BC20&BC030x 系列 AT 命令手册 4.5. AT+QENG 网络服务信息 该命令用于查询模块当前的网络服务信息。当模块处于 PSM 状态或无服务时，设置命令不支持 =0，并且=1 仅在 RRC 连接状态下可用。 AT+QENG 网络服务信息 测试命令 AT+QENG=? 响应 +QENG: (支持的范围) 设置命令 AT+QENG= OK 响应 当=0 时： +QENG: 0,,,,,[],[],[],[< sc_SINR>],,,[],[], [+QENG: 1,,,,,[…]] OK 当=1 时： +QENG: 2,,,,,,,,,,,,,, OK 当=2 时： +QENG: 3,,, OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 25 / 106 最大响应时间 特性说明 BC26&BC20&BC030x 系列 AT 命令手册 或者 +CME ERROR: 300 毫秒 / 参数 整型。请求的模块信息。 0 显示服务小区和邻区小区（若有）信息 1 仅当 Modem 处于 RRC-CONNECTED 状态时显示数据传输信息 2 显示 Tx/Rx 运行的总时长 整型。服务小区的 EARFCN。范围：0-262143。 整型。服务小区的 EARFCN 偏移量。 0 偏移 -2 1 偏移 -1 2 偏移 -0.5 3 偏移 0 4 偏移 1 整型。服务小区物理小区识别码。取值范围：0-503。 字符串类型。4 字节（28 位）服务小区 ID；十六进制格式。 有符号整型。服务小区的 RSRP 值；单位：dBm；可为负数。 有符号整型。服务小区的 RSRQ 值；单位：dB；可为负数。 有符号整型。服务小区的 RSSI 值，单位：dBm；可为负数。 有符号整型。服务小区的最新 SINR 值，单位：dB；可为负数。 整型。当前服务小区频段。 字符串类型。双字节跟踪区域码（TAC）；十六进制格式（例如，'00C3' 等 于十进制的 195）。 整型。服务小区的最新增强覆盖等级（ECL）值；取值范围：0-2。仅在 RRC 连接状态下可用。 带符号整数。UE 的当前发射功率。单位：cBm（0 cBm=1 mW，此参数可以 为负值）。 整型。服务小区的部署模式： 0 LTE 带内部署相同 PCI 1 LTE 带内部署不同 PCI 2 LTE 保护带部署 3 独立部署 整型。相邻小区的 EARFCN；范围：0-262143。 整型。相邻小区的 EARFCN 偏移量。 0 偏移 -2 1 偏移 -1 2 偏移 -0.5 上海移远通信技术股份有限公司 26 / 106 BC26&BC20&BC030x 系列 AT 命令手册 3 偏移 0 4 偏移 1 整型。相邻小区的物理小区 ID；范围：0-503。 有符号整型。相邻小区的 RSRP 值；单位：dBm（可以为负值）。 整型。百分比值；范围：0-100。RLC 层的 UL 误块率（基于每次 ARQ）； 基于所有建立的 RLC AM 无线电承载计算；从成功建立/恢复 RRC 连接开始， 或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。百分比值；范围：0-100。RLC 层的 DL 误块率（基于每次 ARQ）； 基于所有建立的 RLC AM 无线电承载计算；从成功建立/恢复的 RRC 连接开始， 或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。百分比值；范围：0-100。UL-SCH 的 MAC 中的 UL 误块率（基于每次 HARQ）；从成功建立/恢复/重新建立 RRC 连接开始，或者自上一次执行 =1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。百分比值；范围：0-100。DL-SCH（不包括 BCCH）的 MAC 中的 DL 误块率（基于每次 HARQ）；从成功建立/恢复/重新建立 RRC 连接开始，或者 自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。在 UL-SCH 上传输/重传的传输块字节总数；基于所有 HARQ 传输和重 传中的 UL-SCH 计算得出；从成功建立/恢复/重新建立 RRC 连接开始，或者 自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单 位：字节。 整型。在 DL-SCH（不包括 BCCH）上传输/重传的传输块字节总数；从成功建 立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单位：字节。 整型。UL-SCH 上传输块的 HARQ 传输/重传总次数；从成功建立/恢复/ 重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。DL-SCH（不包括 BCCH）上传输块的 HARQ（重新）传输总次数； 从成功建立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。UL-SCH 上传输块的 HARQ 重传次数；从成功建立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计 算（以较晚者为准）。 整型。DL-SCH（不包括 BCCH）上传输块的 HARQ 重传次数；从成功建 立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）。 整型。RLC 上行链路吞吐量；基于所有已建立的 RLC AM 无线承载进行 计算；从成功建立/恢复的 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单位：千字节/秒。 整型。RLC 下行链路吞吐量；基于所有已建立的 RLC AM 无线承载进行 计算；从成功建立/恢复的 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计算（以较晚者为准）；单位：千字节/秒。 整型。MAC 中针对 UL-SCH 的上行吞吐量。从成功建立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QENG 命令开始计 算（以较晚者为准）；单位：千字节/秒。 上海移远通信技术股份有限公司 27 / 106 BC26&BC20&BC030x 系列 AT 命令手册 整型。MAC 中针对 DL-SCH（不包括 BCCH）的下行吞吐量；从成功建 立/恢复/重新建立 RRC 连接开始，或者自上一次执行=1 的 AT+QEN 命令开始计算（以较晚者为准）；单位：千字节/秒。 整型。本次启动后的睡眠持续总时间；单位：0.1 秒。 整型。本次启动后的 Rx 总时间；单位：0.1 秒。 整型。本次启动后的 Tx 总时间；单位：0.1 秒。 整型。错误码。详细信息，请参阅第 12 章。 4.6. AT+CGPADDR 显示 PDP 地址 该命令返回设备的 IP 地址。 执行命令返回指定上下文标识符的 PDP 地址列表。如果未指定，则返回所有已定义上下文的地 址。 测试命令返回已定义的列表；所述已激活，但未必有与之关联的 IP 地址。 AT+CGPADDR 显示 PDP 地址 测试命令 AT+CGPADDR=? 响应 +CGPADDR: (支持的已定义的列表) 查询命令 AT+CGPADDR? OK 响应 +CGPADDR: [,[,]] [+CGPADDR: [,[,]]] [...] 设置命令 AT+CGPADDR=[,[,...]] OK 响应 [+CGPADDR: [,[,]]] [+CGPADDR: [,[,]]] [...] 执行命令 AT+CGPADDR OK 响应 [+CGPADDR: [,[,]]] 上海移远通信技术股份有限公司 28 / 106 最大响应时间 特性说明 BC26&BC20&BC030x 系列 AT 命令手册 [+CGPADDR: [,[,]]] [...] OK 300 毫秒 / 参数 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义（请参阅 AT+CGDCONT 命令）。如果未指定，则返回所有已定义上下文的地址。 和 字符串类型。PDP 地址，用于在适用于 PDP 的地址空间中识别 MT；地址可以为静态 或动态。 静态地址，在定义上下文时由 AT+CGDCONT 命令设置。 动态地址，在上一次 PDP 上下文激活（使用了指定的上下文定义）期间分配。如 果没有可用的或，该参数将被省略。 当同时分配了 IPv4 和 IPv6 地址时，将同时包含和，其 中包含 IPv4 地址，而包含 IPv6 地址。 该字符串以点分隔的数值（0-255）参数形式给出： IPv4 地址形式：a1.a2.a3.a4 IPv6 地址形式：a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a13.a14.a15.a16 备注 在双栈终端（='IPV4V6'）中， 对应 IPv6 的地址；对于 IPv6 单栈终端 （='IPV6'）或具有向后兼容性的终端，IPv6 地址也可包含在参数 中。 举例 AT+CGPADDR=1 +CGPADDR: 1,101.43.5.1 OK AT+CGPADDR=? +CGPADDR: (1) OK 上海移远通信技术股份有限公司 29 / 106 BC26&BC20&BC030x 系列 AT 命令手册 4.7. AT+CSCON RRC 连接状态 该命令可提供 TA 感知的无线连接状态（即和基站的连接状态）信息，并可返回当前状态的指示。该状 态仅在无线事件（例如发送和接收）发生时更新。因此，当前返回的状态可能已经过时。即使在返回状态 =1（连接态）的情况下，因为连接质量的变化，模块仍可能无法连接到基站。 设置命令用于控制 URC +CSCON: 的显示。 值指示 MT 在 E-UTRAN 中时的状态：MT 在没有信令连接时为空闲态，有信令连接时为连接 态。 查询命令返回 URC 显示的状态和整型参数以指示 MT 当前为空闲态或连接态。 AT+CSCON RRC 连接状态 测试命令 AT+CSCON=? 响应 +CSCON: (支持的列表) 查询命令 AT+CSCON? OK 响应 +CSCON: , OK 设置命令 AT+CSCON= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。启用/禁用 URC。 上海移远通信技术股份有限公司 30 / 106 BC26&BC20&BC030x 系列 AT 命令手册 0 禁用 URC 1 启用 URC +CSCON: 整型。信令连接状态。 0 空闲态 1 连接态 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CSCON=0 OK AT+CSCON? +CSCON: 0,1 OK AT+CSCON=? +CSCON: (0,1) OK AT+CSCON=1 OK AT+CSCON? +CSCON: 1,1 OK 上海移远通信技术股份有限公司 31 / 106 BC26&BC20&BC030x 系列 AT 命令手册 5 PDN 和 APN 相关命令 5.1. AT+CGDCONT 定义 PDP 上下文 设置命令为由（本地）上下文标识参数所标识的 PDP 上下文指定上下文参数。因为 PCO 可包括 需要加密的信息，所以该命令也允许 TE 指定是否请求 ESM 信息的安全保护传输。UE 可能由于其他原因 而需要使用安全保护的 ESM 信息传输，例如当 UE 需要传输 APN 时。处于已定义状态的 PDP 上下文的数 量，由该测试命令返回的取值范围给出。 对 EPS 而言，设置该命令后会建立 PDN 连接并建立相关的默认承载，参数应该省略。 此设置命令的一种特殊形式 AT+CGDCONT=，会直接删除对应的 PDP 上下文参数，使其 变成未定义。 查询命令返回每个已定义上下文的当前配置。 如果 UE 支持几种 PDP 类型，则每个的参数值范围将以单行返回。 默认情况下，=1 的上下文在启动时定义，因此无需使用 AT+CGDCONT 命令创建。初始 PDP 上下文具有制造商特定的默认设置，与 AT+CGDCONT 命令的任何默认配置无关。根据 AT+CIPCA 命令 的设置，在 E-UTRAN 网络中，MT 成功注册到网络后会自动激活初始 PDP 上下文。如果所有活动上下文 都被去激活，则可以重新建立初始 PDP 上下文。 AT+CGDCONT 定义 PDP 上下文 测试命令 AT+CGDCONT=? 响应 +CGDCONT ： ( 支 持 的 范 围 ),( 支 持 的 列 表),(支持的范围),(支持的范围),(支持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的列 表),(支持的列表) 查询命令 AT+CGDCONT? OK 响应 [+CGDCONT: ,,,,< 上海移远通信技术股份有限公司 32 / 106 BC26&BC20&BC030x 系列 AT 命令手册 d_comp>,[,[,[,[, [,[,[,[,[,]]]]]]]]]] +CGDCONT: ,,,,,[,[,[,[, [,[,[,[,[,]]]]]]]]]] [...] 设置命令 AT+CGDCONT=[,[,< APN>[,[,[,[,[,[,[,[,[,[,[,[,] ]]]]]]]]]]]]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效。如果定义的已激活 PDN 连接，则 参数配置于深休眠唤醒后依然生效；如果定义的未激活 PDN 连接，则参数配置于深休眠唤醒后不再继续生效。 参数 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义。该参数是 UE-TE 接口的 本地参数，用于其他与 PDP 上下文相关的命令。范围：1-15。 字符串类型。指定分组数据协议类型。 'IP' 互联网协议（IETF STD 5 [103]） 'IPV6' 互联网协议版本 6 'IPV4V6' 引入虚拟来处理双栈 UE 功能 'PPP' 点对点协议（IETF STD 51 [104]） EPS 服务仅支持 IP、IPv6 和 IPv4v6 'NON-IP' 非 IP 类型 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。如果省略或为空，将请 求默认值。可配置的最大 APN 长度为 99 字节。值为空或值省略时，将请求订阅值。 字符串类型。用于标识适用于 PDP 的地址空间中的 UE。如果该值为空或被省略，则 TE 在 PDP 启动过程中提供该值，否则，将请求动态地址。即使在 PDP 启动过程中已 上海移远通信技术股份有限公司 33 / 106 BC26&BC20&BC030x 系列 AT 命令手册 经分配了地址，查询命令中此值的返回值仍将是空字符串。可以使用 AT+CGPADDR 命令读取分配的地址。 整型。控制 PDP 数据是否需要压缩。 0 关闭 1 打开 2 V.42bis 3 V.44bis 整型。控制 PDP 头部数据是否需要压缩。 0 关闭 1 打开 2 RFC 1144 （仅适用于 SNDCP） 3 RFC 2507 4 RFC 3095[ROHC] （仅适用于 PDCP） 整型。控制 MT/TA 请求获取 IPv4 地址信息的方式。 0 通过 NAS 信令分配 IPv4 地址 1 通过 DHCP 分配 IPv4 地址 整型。PDP 上下文激活请求的类型。请参阅 3GPP TS 24.301（subclause 6.5.1.2） 和 3GPP TS 24.008（subclause 10.5.6.17）。如果支持初始 PDP 上下文，则不允 许为紧急承载服务分配=0。根据 3GPP TS 24.008（subclause 4.2.4.2.2 和 subclause 4.2.5.1.4）和 3GPP TS 24.301（subclause 5.2.2.3.3 and subclause 5.2.3.2.2），必须为紧急承载服务建立单独的 PDP 上下文。 如果紧急承载服务的 PDP 上下文是唯一激活的上下文，则只允许紧急呼叫（请参 阅 3GPP TS 23.401 subclause 4.3.12.9）。 0 PDP 上下文用于建立新的 PDP 上下文或从非 3GPP 接入网进行切换（是 哪种情况，由 MT 根据实际执行情况决定） 1 PDP 上下文用于紧急承载服务 2 PDP 上下文用于建立新的 PDP 上下文 3 PDP 上下文用于从非 3GPP 接入网进行切换 整型。影响 MT/TA 如何请求获取 P-CSCF 地址（请参阅 3GPP TS 24.229 [89] 附录 B 和附录 L）。 0 不受 AT+CGDCONT 影响的 P-CSCF 地址发现 1 通过 NAS 信令发现 P-CSCF 地址 2 通过 DHCP 发现 P-CSCF 地址 整型。向网络指示 PDP 上下文是否仅用于 IM CN 子系统相关的信令。 0 UE 指示 PDP 上下文并非仅用于 IM CN 子系统相关的信令 1 UE 指示 PDP 上下文仅用于 IM CN 子系统相关的信令 整型。为此 PDP 上下文请求的 NAS 信令优先级。 0 指示将使用 MT 中配置的低优先级指示符的值激活该 PDP 上 下文 1 表示将使用低优先级指示符'未为 NAS 信令低优先级配置 MS'的值激活此 PDP 上下文 MT 使用 3GPP TS 24.301 [83]和 3GPP TS 24.008 中指定 的 NSLPI 信息。 整型。指定是否请求 PCO 的安全保护传输（仅适用于 EPS）。 0 不请求 PCO 的安全保护传输 上海移远通信技术股份有限公司 34 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 请求对 PCO 进行安全保护传输 整型。影响 MT/TA 如何请求获取 IPv4 MTU 大小，请参阅 3GPP TS 24.008 subclause 10.5.6.3。 0 不受 AT+CGDCONT 命令影响的 IPv4 MTU 大小发现 1 通过 NAS 信令发现 IPv4 MTU 大小 整型。指示终端是否支持传输流模板的本地 IP 地址 0 不支持 1 支持 整型。影响 MT/TA 如何请求获取 Non-IP MTU 大小（请参考 3GPP TS 24.008 subclause 10.5.6.3）。 0 不受 AT+CGDCONT 影响的 Non-IP MTU 大小发现 1 通过 NAS 信令发现 Non-IP MTU 大小 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 最多可同时激活 3 个 PDP 上下文。 2. 对于 EPS 而言，可省略参数。 3. Modem 协议不支持以下参数：        举例 AT+CGDCONT=? +CGDCONT: (1-15),'IP',,,(0-2),(0-4),(0),,,,,,(0,1),,(0,1) +CGDCONT: (1-15),'IPV6',,,(0-2),(0-4),(0),,,,,,(0,1),,(0,1) +CGDCONT: (1-15),'IPV4V6',,,(0-2),(0-4),(0),,,,,,(0,1),,(0,1) +CGDCONT: (1-15),'Non-IP',,,(0-2),(0-4),(0),,,,,,(0,1),,(0,1) OK AT+CGDCONT=1,'IP','CMNET' OK AT+CGDCONT? +CGDCONT: 1,'IP','CMNET','',0,0,0,,,,,,0,,0 OK 上海移远通信技术股份有限公司 35 / 106 BC26&BC20&BC030x 系列 AT 命令手册 5.2. AT+CGACT PDP 上下文激活/去激活 设置命令用于激活或去激活指定的 PDP 上下文。命令设置完成后，MT 保持 V.250 命令状态。若任意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；如果不能实现任意上下文的请求状态，将返 回 ERROR 或 +CME ERROR。AT+CMEE 命令可用于使能扩展错误响应。 在执行激活命令时，如果 UE 没有附着 PS，则 UE 会先执行 PS 附着，然后尝试激活指定的上下文。 如果附着失败，则 MT 会响应错误；若使能了扩展错误响应，则会响应附着失败的错误消息。 对于 EPS 而言，如果尝试断开上一条 PDN 连接，UE 将响应 ERROR；若使能了扩展错误响应，则响 应 +CME ERROR。 EPS 承载资源激活请求由网络通过 EPS 专用承载激活请求或者 EPS 承载修改请求来响应。必须在 UE 接受此请求之后 PDP 上下文方可设置为建立状态。 如果未指定，则该命令将激活所有已定义的非紧急上下文，而该命令的去激活将去活所有已激活 的上下文。 查询命令返回所有定义的 PDP 上下文的当前激活状态。 测试命令用于请求所有支持的 PDP 上下文激活状态信息。 AT+CGACT PDP 上下文激活/去激活 测试命令 AT+CGACT=? 响应 +CGACT: (支持的列表) 查询命令 AT+CGACT? OK 响应 +CGACT: , +CGACT: , […] 设置命令 AT+CGACT=[,[,[,...]] ] OK 响应： OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 36 / 106 BC26&BC20&BC030x 系列 AT 命令手册 最大响应时间 特性说明 150 秒，依赖于网络环境 / 参数 整型。PDP 上下文激活状态。 0 去激活 1 激活 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义（详见 AT+CGDCONT 命令）。 整型。错误码。详细信息，请参阅第 12 章。 备注 如果支持初始 PDP 上下文，则模块在启动时自动定义=1 的上下文。 举例 AT+CGACT=0,1 OK AT+CGACT? +CGACT: 1,0 OK AT+CGACT=? +CGACT: (0,1) OK 5.3. AT+CIPCA 初始 PDP 上下文激活 设置命令控制是否使能不带 PDN 连接的附着。=1 时，EPS 附着过程将不携 带 PDN 连接建立请求。 查询命令返回命令的当前设置。 AT+CIPCA 初始 PDP 上下文激活 测试命令 AT+CIPCA=? 响应 +CIPCA: (支持的列表),(支持的 上海移远通信技术股份有限公司 37 / 106 BC26&BC20&BC030x 系列 AT 命令手册 列表) 查询命令 AT+CIPCA? OK 响应 +CIPCA: [,] OK 设置命令 AT+CIPCA=, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。附着后激活 PDP 上下文。 3 当前设置无变化 整型。带有或不带 PDN 连接的 EPS 附着。 0 带有 PDN 连接的 EPS 附着 1 不带 PDN 连接的 EPS 附着 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CIPCA=3,1 OK AT+CIPCA? +CIPCA: 3,1 OK AT+CIPCA=? +CIPCA: 3,(0,1) 上海移远通信技术股份有限公司 38 / 106 BC26&BC20&BC030x 系列 AT 命令手册 OK 5.4. AT+CGAPNRC APN 速率控制 设置命令返回与指定的上下文标识符参数对应的 APN 速率控制参数（请参阅 3GPP TS 24.008 [8]）。 执行命令返回所有激活的 PDP 上下文的 APN 速率控制参数。 测试命令返回与已激活的辅助和非辅助 PDP 上下文的列表。 AT+CGAPNRC APN 速率控制 测试命令 AT+CGAPNRC=? 响应 +CGAPNRC: (已激活 PDP 上下文的列表) 设置命令 AT+CGAPNRC= OK 响应 +CGAPNRC: [,[,< uplink_time_unit>[,]]] OK 执行命令 AT+CGAPNRC 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAPNRC: [,[,< uplink_time_unit>[,]]] [+CGAPNRC: [,[,< uplink_time_unit>[,]]]] [...] OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 39 / 106 BC26&BC20&BC030x 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 / 参数 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义（详 见 AT+CGDCONT 命令）。 整型。表示当达到最大上行速率时是否允许发送额外异常报告。请 参阅 3GPP TS 24.008[8] subclause 10.5.6.3.2。 0 不允许在最大速率时发送其他异常上报 1 允许在最大速率时发送其他异常上报 整型。最大上行速率使用的时间单位。即 3GPP TS 24.008[8] subclause 10.5.6.3.2.中规定的 APN 速率控制参数 IE 的第一组八位 字节中的第 1 位至第 3 位。 0 不受限 1 分钟 2 小时 3 天 4 周 整型。每个上行时间单位内限制 UE 发送的最大消息数。即 3GPP TS 24.008[8] subclause 10.5.6.3.2。 整型。错误码。详细信息，请参阅第 12 章。 5.5. AT+QGACT 激活/去激活 PDN 上下文 设置命令用于激活或去激活指定的 PDN 上下文。 PDN 上下文激活和去激活请求均有三种响应结果：  如果 PDN 上下文为激活/去激活状态，则立即响应+QGACT: ,,[,]OK；  如果 PDN 上下文未处于激活/去激活状态，则先响应 +QGACT: OK，随后上报 激活/去激活结果 URC +QGACT: ,,[,]；  如果发生任何错误，例如参数无效，则立即返回 ERROR。 无论如何，参数仅在激活请求的返回结果中存在。另外，当被动去激活发生时 才上报 URC +QGACT: ,。 对于激活请求，设置命令的格式为+QGACT=,,[,,[,[,]]；而对于去激活请求，设置命令的格式为+QGACT=,。规范化的命令 上海移远通信技术股份有限公司 40 / 106 BC26&BC20&BC030x 系列 AT 命令手册 格式为+QGACT: ,[,[,,[,[,]]]]。 AT+QGACT 激活/去激活 PDN 上下文 设置命令 AT+QGACT=,[,[,,[,[,]]]] 响应 如果 PDN 上下文已处于激活/未激活状态： +QGACT: ,,[,] OK 如果 PDN 上下文未处于激活/去激活状态： +QGACT: OK +QGACT: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。去激活/激活请求。 0 去激活 1 激活 整型。待激活的 PDP 类型。 1 IPv4 2 IPv6 3 IPv4v6 4 Non-IP 整型。PDP 上下文标识符，用于指定特定 PDP 上下文的定义。 字符串类型。接入点名称；激活时必须配置，去激活时应省略。 字符串类型。接入 IP 网络的用户名；激活时必须配置，去激活时应省略。 字符串类型。访问 IP 网络的密码；激活时必须配置，去激活时应省略。 整型。要激活的承载类型；激活时可选配，去激活时应省略。 1 NB-IoT（目前仅支持 NB-IoT） 上海移远通信技术股份有限公司 41 / 106 BC26&BC20&BC030x 系列 AT 命令手册 整型。待使用的 USIM 卡的识别码；激活时可选配，去激活时应省略。 1 USIM 卡 1（当前仅支持 USIM 卡 1） 整型。 0 去激活的结果/URC 1 激活的结果/URC 2 被动去激活的 URC 整型。激活/去激活的结果。 0 失败 1 成功 整型。实际激活的 PDP 类型。 1 IPv4 2 IPv6 3 IPv4v6 4 Non-IP 整型。错误码。详细信息，请参阅第 12 章。 备注 模块注册到网络后，将自动建立默认的 PDN 连接（=1）。 举例 AT+QGACT=1,1,'apn','','' +QGACT: 1 OK +QGACT: 1,1,1,1 AT+QGACT=0,1 +QGACT: 1 OK +QGACT: 1,0,1 //激活 PDN 上下文 //如果没有错误，立即返回 OK //通过 URC 通知激活结果 //去激活 PDN 上下文 //如果没有错误，立即返回 OK //通过 URC 通知停用结果 5.6. AT+QCGDEFCONT 配置默认的 APN/PDN 连接 设置命令用于配置开机时 PDN 连接的 PSD 连接设置。当连接到 NB-IoT 网络时，必须执行 PDN 连接 设置。 上海移远通信技术股份有限公司 42 / 106 BC26&BC20&BC030x 系列 AT 命令手册 AT+QCGDEFCONT 配置默认的 APN/PDN 连接 测试命令 AT+QCGDEFCONT=? 响应 +QCGDEFCONT: (支持的列表) 查询命令 AT+QCGDEFCONT? OK 响应 +QCGDEFCONT: ,[[[],],] 设置命令 AT+QCGDEFCONT=[,[,[,password]]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 字符串类型。指定分组数据协议的类型。 'IP' 互联网协议（IETF STD 5） 'IPV6' 互联网协议版本 6（IETF RFC 2460） 'IPV4V6' 双栈（请参阅 3GPP TS 24.301） 'Non-IP' 将非 IP 数据传输到外部分组网络（请参阅 3GPP TS 24.301） 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。可配置的 APN 最大长 度为 99 个字节。如果该值为空或省略，则将请求订阅值。 字符串类型。接入 IP 网络的用户名。 字符串类型。接入 IP 网络的密码。 整型。错误码。详细信息，请参阅第 12 章。 上海移远通信技术股份有限公司 43 / 106 BC26&BC20&BC030x 系列 AT 命令手册 6 其他网络命令 6.1. AT+COPS PLMN 选择 用于选择是自动入网还是手动选择指定的 PLMN 入网。使用手动模式时，如果所选的 PLMN 不可用，则不得选择其他任何运营商（=4 除外）。如果所选的接入技术不可用，则应在其 他接入技术中选择同一运营商。所选运营商名称的格式也应适用于查询命令 AT+COPS?。=2 强制 尝试注销网络。所选模式会影响后续所有网络的注册（例如，设置=2 之后，只有在设置=0 或 1 时 MT 才会注册网络）。 查询命令返回当前模式、当前所选运营商和当前接入技术。如果未选择任何运营商，则不会返回 、和。 测试命令返回五个参数的集合，每个参数表示网络中的一个运营商。所述参数集合包含指示当前运营 商是否可用的整型参数、运营商的数字编码、接入技术的数字编码、注册模式 及运营商名称的格式 。以上参数可能不可用，不可用时为空字段。运营商列表的顺序应为： EH/HPLMN、UPLMN、OPLMN 和其他 PLMN。 选择接入技术的参数仅应用于能够注册多种接入技术的终端。的选择不会限制小区重选 的能力，即使已经尝试选择一种接入技术，移动设备也可以在其他接入技术中重选小区。 AT+COPS PLMN 选择 测试命令 AT+COPS=? 响应 +COPS: (支持的范围),(支持的列表),(支持的< AcT>列表),(支持的范围),(支持的列表) OK 查询命令 AT+COPS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS: [,,][,] OK 上海移远通信技术股份有限公司 44 / 106 BC26&BC20&BC030x 系列 AT 命令手册 设置命令 AT+COPS=[,[,[ ,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 900 秒 特性说明 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。 0 自动模式（忽略字段） 1 手动搜网模式（应出现字段） 2 手动注销网络 3 仅设置，不在查询命令中显示 4 手动/自动选择。如果手动选择失败，则进入自动搜网模式（=0） 整型。的格式配置。 2 数字格式 字符串类型。指示此参数是否为数字格式。数字格式是 NB-IoT 网络位置区域标识 号，它由三个 BCD 码 ITU-T 国家/地区代码，以及两个或三个 BCD 数字网络代码（用于特 定管理）组成。当=0 时，字段不存在。 整型。 0 未知网络 1 可用网络 2 当前选择的网络 3 禁止选择的网络 整型。接入技术。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 仅在模块处于空闲状态时才能执行测试命令，否则将返回错误。 2. 仅当模块处于空闲状态或已插入 USIM 卡的注销状态时才能执行设置命令，否则将返回错误。 上海移远通信技术股份有限公司 45 / 106 3. 手动模式只有在网络注册成功时，才会返回 OK。 BC26&BC20&BC030x 系列 AT 命令手册 举例 AT+COPS=0 OK AT+COPS? +COPS: 0,2,'46000',9 OK 6.2. AT+CCIOTOPT CloT 优化配置 设置命令设置 UE 在 ATTACH REQUEST 和 TRACKING AREA UPDATE REQUEST 消息中指示所支 持和优先选择的 CIoT EPS 优化配置。该命令还允许上报网络支持的 CIoT EPS 优化。支持 CIoT 功能的 UE 可以支持控制面（control plane）或用户面（user plane）的 CIoT EPS 优化，或两者都可支持（请参 阅 3GPP TS 24.301, sub-clause 9.9.3.34）。基于应用特性，UE 可能优先选择注册用于控制面的 CIoT EPS 优化配置或用于用户面的 CIoT EPS 优化配置（请参阅 3GPP TS 24.301，sub-clause 9.9.3.0B）。 设置命令还用于控制 URC +CCIOTOPTI 的显示。URC +CCIOTOPTI: 用于 指示网络所支持的 CIoT EPS 优化配置。 查询命令返回当前支持和优选的 CIoT EPS 优化配置，以及 URC +CCIOTOPTI 的当前状态。 AT+CCIOTOPT CloT 优化配置 测试命令 AT+CCIOTOPT=? 响应 +CCIOTOPT: (支持的范围),(支持的范围),(支持的范围) 查询命令 AT+CCIOTOPT? OK 响应 +CCIOTOPT: ,, 设置命令 AT+CCIOTOPT=[,[,]] OK 响应 当=0 或 2： OK 当=1： OK 上海移远通信技术股份有限公司 46 / 106 BC26&BC20&BC030x 系列 AT 命令手册 最大响应时间 特性说明 +CCIOTOPTI: 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。启用/禁用 URC +CCIOTOPTI 的上报。 0 禁用 1 启用 2 禁用上报并将 CIoT EPS 优化参数重置为默认值 整型。表示 UE 支持的 CIoT EPS 优化方案。 1 支持控制面 CIoT EPS 优化 2 支持用户面 CIoT EPS 优化 3 支持控制面和用户面 CIoT EPS 优化 整型。指示 UE 优先选择的 CIoT EPS 优化配置。 0 无优先级 1 优先控制面 CIoT EPS 优化 2 优先用户面 CIoT EPS 优化 整型。表示网络所支持的 CIoT EPS 优化方案。 0 不支持 1 支持控制面 CIoT EPS 优化 2 支持用户面 CIoT EPS 优化 3 同时支持控制面和用户面 CIoT EPS 优化方案 整型。错误码。详细信息，请参阅第 12 章。 6.3. AT+QBAND 查询/设置工作频段 设置命令用于查询当前注册的频段或设置要锁定的频段。 AT+QBAND 查询/设置工作频段 测试命令 AT+QBAND=? 响应 +QBAND: (支持的范围),[(支持的 列表)] 上海移远通信技术股份有限公司 47 / 106 BC26&BC20&BC030x 系列 AT 命令手册 OK 查询命令 AT+QBAND? 响应 +QBAND: OK 设置命令 AT+QBAND=[, [,[,…]]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。频段个数。 0 所有频段 1-16 频段个数 整型。NB-IoT 频段。有效值：1、3、5、8、20 等；详见备注。 整型。当前锁定的频段。有效值：1、3、5、8、20 等；详见备注。 举例 AT+QBAND=? +QBAND: (0-5),(1,3,5,8,20) OK AT+QBAND=1,5 OK AT+QBAND? +QBAND: 5 //查询 BC26 支持的频段列表 //设置要使用的频段 //查询之前设置的频段 上海移远通信技术股份有限公司 48 / 106 BC26&BC20&BC030x 系列 AT 命令手册 OK 备注 BC26、BC20 和 BC030x 系列模块所支持的具体频段信息，请参阅相应的模块产品规格书。根据采购编码 的不同，各模块可能支持不同的 NB-IoT 频段；请通过 AT+QBAND=?查询当前模块所支持的频段信息。 6.4. AT+QBANDSL 设置优先搜索的频段列表 设置命令用于设置优先搜索的频段列表。列表中频段的搜索顺序依赖于设置的顺序，最多仅支持设置 4 个优先搜索的频段。该命令设置的优先搜索的频段不会影响根据 USIM 卡匹配到的优先频段。 AT+QBANDSL 设置优先搜索的频段列表 设置命令 AT+QBANDSL=,,[,[,[,]]] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。启用/禁用设置优先搜索的频段列表。 0 禁用 1 启用 整型。需要优先搜索的频段数量。 有效值：1、2、3、4。 整型。优先搜索的频段。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QBANDSL=1,2,8,3 OK //设置优先搜索的频段为 B8 和 B3。 上海移远通信技术股份有限公司 49 / 106 BC26&BC20&BC030x 系列 AT 命令手册 6.5. AT+QLOCKF 锁定 NB-IoT 频点及 PCI 设置命令用于将 UE 锁定到特定的频点（EARFCN）和小区。当 PCI 取值大于 503 时将会返回错误， 当 PCI 取值小于 0 或非整型值时，将会忽略该参数。 AT+QLOCKF 锁定 NB-IoT 频点及 PCI 测试命令 AT+QLOCKF=? 查询命令 AT+QLOCKF? 设置命令 AT+QLOCKF=[,[,][,]] 响应 OK 响应 OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。锁定/解除锁定 0 解除锁定 1 锁定 整型。请求锁定的 EARFCN；取值范围：0-262143；0 表示解除 EARFCN 和小区的 任何锁定。 整型。请求的 EARFCN 偏移量。 0 偏移 -2 1 偏移 -1 2 偏移 -0.5 3 偏移 0 4 偏移 1 整型。物理小区识别码；取值范围：0-503。 整型。错误码。详细信息，请参阅第 12 章。 上海移远通信技术股份有限公司 50 / 106 BC26&BC20&BC030x 系列 AT 命令手册 6.6. AT+QCSEARFCN 清除 NB-IoT 存储的 EARFCN 列表 执行命令用于清除 UE 存储的 EARFCN 列表。 AT+QCSEARFCN 清除 NB-loT 存储的 EARFCN 列表 执行命令 AT+QCSEARFCN 响应 +QCSEARFCN: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。EARFCN 清除结果。 0 成功 2 失败 3 无记忆频点 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QCSEARFCN +QCSEARFCN: 0 OK 上海移远通信技术股份有限公司 51 / 106 BC26&BC20&BC030x 系列 AT 命令手册 7 USIM 相关命令 7.1. AT+CIMI 查询 USIM 卡 IMSI 执行命令使 TA 返回 USIM 卡的 IMSI（不带双引号的字符串），旨在允许 TE 识别连接到 MT 的 USIM。 AT+CIMI 查询 USIM 卡 IMSI 测试命令 AT+CIMI=? 执行命令 AT+CIMI 响应 OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 USIM 卡的 IMSI（国际移动用户识别码）（不带双引号的字符串）。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CIMI 460001357924680 OK 上海移远通信技术股份有限公司 52 / 106 BC26&BC20&BC030x 系列 AT 命令手册 7.2. AT+CLCK 设备锁 执行命令用于锁定、解锁或查询设备状态。通常需要密码才能执行此类操作。查询网络服务的状态 （=2）时，仅在所有的服务均未激活时，才会响应未激活（=0）。设置或查询时， 该命令可被中断。 AT+CLCK 设备锁 测试命令 AT+CLCK=? 响应 +CLCK: (支持的列表) 设置命令 AT+CLCK=,[,[, ]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 当=0 或 1 并且命令成功执行时： OK 当=2 并且命令成功执行时： +CLCK: [,] [+CLCK: ,] [...] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 字符串类型。网络设备。 'PS' PH-SIM（将 UE 锁定到当前所选卡槽中插入的 USIM 卡）（当插入当前 USIM 卡以外 的其他设备时，MT 将查验密码；插入 MT 已记忆的使用过的卡时，无需密码） 'SC' USIM 卡（锁定当前所选卡槽中插入的 USIM 卡）（USIM 在 MT 启动以及执行设备锁 定命令时查验密码） 上海移远通信技术股份有限公司 53 / 106 BC26&BC20&BC030x 系列 AT 命令手册 'PN' 网络个性化（请参阅 3GPP TS 22.022 [33]） 'PU' 网络子集个性化（请参阅 3GPP TS 22.022 [33]） 'PP' 服务提供商个性化（请参阅 3GPP TS 22.022 [33]） 'PC' 企业个性化（请参阅 3GPP TS 22.022 [33]） 整型。表示设备锁的模式。 0 解锁 1 锁定 2 查询是否锁定 整型。表示设备的状态。 0 未激活 1 激活 字符串类型。应与通过 MT 用户界面为设备指定的密码相同，或与通过 AT+CPWD 设置的密 码相同。 整数的总和，每个整数表示一类信息（默认值：7，表示语音、数据和传真） 1 语音（电话） 2 数据（指所有承载服务；如果 TA 不支持值 16、32、64 和 128，则=2 可能仅 指某些承载服务） 4 传真（传真服务） 8 短信服务 16 数据电路同步 32 数据电路异步 64 专用数据包访问 128 专用 PAD 访问 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 后续将仅支持'SC'。 2. 该命令不适用于 BC3030S-CN。 举例 AT+CLCK='PN',2 +CLCK: 0 OK 7.3. AT+CPIN 输入 PIN 设置命令用于输入 PIN。 上海移远通信技术股份有限公司 54 / 106 BC26&BC20&BC030x 系列 AT 命令手册 AT+CPIN 输入 PIN 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 TA 返回一个字母数字字符串，指示是否需要密码。 +CPIN: 设置命令 AT+CPIN=[,][,] OK 响应 使用之前，TA 必须已存储密码如 SIM PIN、SIM PUK、PH-SIM PIN 等。如果需要输入两次 PIN，则 TA 将自动重复 PIN。如 果没有待处理的 PIN 请求，则不会采取任何措施，并将返回 错误消息+CME ERROR 给 TE。 如果所需的 PIN 为 SIM PUK 或 SIM PUK2，则需输入第二个 ，用于替换 USIM 中的旧 PIN。 设置新密码时，也可以指定第三个参数。将第三个参数与新 密码进行对比，检查是否相同，以此作为额外的安全功能。 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 字符串类型。 READY SIM PIN SIM PUK PH_SIM PIN PH_NET PIN PH_NETSUB PIN PH_SP PIN PH_CORP PIN SIM PIN2 无需进一步输入 MT 正在等待 USIM PIN MT 正在等待 USIM PUK MT 正在等待电话到 USIM 卡的密码（防盗） 需要网络个性化密码 需要网络子集 需要服务提供商的个性化密码 需要企业个性化密码 MT 正在等待提供 USIM PIN 2；仅当上个命令返回+CME 上海移远通信技术股份有限公司 55 / 106 BC26&BC20&BC030x 系列 AT 命令手册 ERROR: 17 时才会需要 PIN2 SIM PUK2 MT 正在等待提供 USIM PUK 2；仅当上个命令返回+CME ERROR: 18 时才会需要 PUK2 字符串类型。密码。 字符串类型。如果所需的 PIN 为 SIM PUK 或 SIM PUK2，则为新密码。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CPIN? +CPIN: READY OK 7.4. AT+CPLS 优先 PLMN 列表选择 设置命令用于在 USIM 中选择一个包含接入技术的 PLMN 选择器列表，所选择的列表将用于 AT+CPOL 命令。 查询命令返回从 USIM 选定的 PLMN 选择器列表。 AT+CPLS 优先 PLMN 列表选择 测试命令 AT+CPLS=? 响应 +CPLS: OK 查询命令 AT+CPLS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPLS: OK 设置命令 若出现任何错误： ERROR 或者 +CME ERROR: 响应 上海移远通信技术股份有限公司 56 / 106 BC26&BC20&BC030x 系列 AT 命令手册 AT+CPLS= 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。 0 用户控制的包含接入技术的 PLMN 选择器（EFPLMNwAcT）；如果未在 USIM 中 找到 EFPLMNwAcT，则为 PLMN 优选列表 EFPLMNsel（此文件仅在 USIM 卡中 可用） 1 包含接入技术的运营商控制 PLMN 选择器（EFOPLMNwAcT） 2 包含接入技术的 HPLMN 选择器（EFHPLMNwAcT） 整型。已选列表。 整型。PLMN 列表的范围；当前范围：0-2。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CPLS? +CPLS: 1 OK 7.5. AT+CPOL 优先 PLMN 列表 设置命令用于编辑 USIM 卡中包含接入技术的 PLMN 选择器列表。 设置命令可向 USIM 卡的优先 PLMN 列表中写入一项条目，所述 PLMN 列表由 AT+CPLS 命令选择。 如果之前未选择过任何列表，则默认为包含接入技术的用户控制 PLMN 选择器（EFPLMNwAcT）。 查询命令返回 USIM 的优先 PLMN 列表中所有使用过的条目（所述 PLMN 列表由 AT+CPLS 命令选择）， 并显示为列表中的每个 PLMN 包含的接入技术。 测试命令返回 USIM 支持的整个索引范围和 PLMN 格式。 上海移远通信技术股份有限公司 57 / 106 BC26&BC20&BC030x 系列 AT 命令手册 AT+CPOL 优先 PLMN 列表 测试命令 AT+CPOL=? 查询命令 AT+CPOL? 设置命令 AT+CPOL= 最大响应时间 特性说明 响应 +CPOL: (支持的范围),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPOL: ,,[,,,,,] [] +CPOL: ,,[,,,,<E-UTRAN_AcT2, >] [...]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。USIM 优先运营商列表中的运营商序号，范围：1-80。 字符串类型。运营商名称。 整型。PLMN 格式。 2 数值 上海移远通信技术股份有限公司 58 / 106 BC26&BC20&BC030x 系列 AT 命令手册 整型。GSM 接入技术 0 未选择接入技术 1 选择接入技术 整型。GSM 压缩接入技术 0 未选择接入技术 1 选择接入技术 整型。UTRAN 接入技术 0 未选择接入技术 1 选择接入技术 整型。E-UTRAN 接入技术 0 未选择接入技术 1 选择接入技术 整型。NG-RAN 接入技术 0 未选择该接入技术 1 选择该接入技术 整型。错误码。详细信息，请参阅第 12 章。 备注 1. MT 也可以在选择新网络时自动使用包含接入技术的用户控制 PLMN 选择器（EFPLMNwAcT）。 2. 仅当向先前已验证的 USIM 中写入接入条件时，才可以写入包含接入技术的运营商控制 PLMN 选择器 （EFOPLMNwAcT）。 7.6. AT+CPWD 更改密码 设置命令为 AT+CLCK 定义的设备锁功能设置新密码。 测试命令返回成对的和列表，以显示可用设备和对应的密码最大长度。 AT+CPWD 更改密码 测试命令 AT+CPWD=? 响应 +CPWD: (支持的列表),(支持的 列表） 设置命令 AT+CPWD=,, 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 59 / 106 BC26&BC20&BC030x 系列 AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 , 字符串类型。 'P2' USIM PIN2 'PS' PH-SIM（将电话锁定到当前所选卡槽中插入的 USIM 卡）（当插入当 前 USIM 卡以外的其他设备时，MT 将查验密码；插入 MT 已记忆的 使用过的卡时，无需密码）。 'SC' USIM 卡（锁定当前所选卡槽中插入的 USIM 卡）（USIM 在 MT 启动 以及执行设备锁定命令时查验密码） 'PN' 网络个性化（请参阅 3GPP TS 22.022 [33]） 'PU' 'PP' 网络子集个性化（请参阅 3GPP TS 22.022 [33]） 互联网服务供应商个性化（请参阅 3GPP TS 22.022 [33]） 'PC' 企业个性化（请参阅 3GPP TS 22.022 [33]） 字符串类型。旧密码/新密码。旧密码必须与从 MT 用户界面为设备 指定的密码相同，或与 AT+ CPWD 命令中设置的密码相同；而为 新密码；密码的最大长度通过确定。 整型。设备密码的最大长度。 整型。错误码。详细信息，请参阅第 12 章。 备注 该命令不适用于 BC3030S-CN。 7.7. AT+CRSM USIM 卡有限访问 该命令提供了对 USIM 数据库的简单而有限的访问，用于向 MT 传输 USIM 命令序号()及 其所需的参数。 AT+CRSM USIM 卡有限访问 测试命令 AT+CRSM=? 响应 OK 上海移远通信技术股份有限公司 60 / 106 BC26&BC20&BC030x 系列 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 设置命令 响应 AT+CRSM=[,[,,, +CRSM: ,[,] [,][,]]] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 保 存 机 制 与 USIM 有 关 ； 参 数 配 置 不 保 存 至 NVRAM。 参数 ,, , 字符串类型。USIM 命令序号。 '176' 读取二进制 '178' 读取记录 '192' 获得响应 '214' 更新二进制 '220' 更新记录 '242' 状态 整型。USIM 卡文件标识。除'状态'命令外，必须包含此参数。 整型。由 MT 传送给 USIM 的参数，除'获得响应'及'状态'命令外，其他命令 均需包含此参数（请参阅 3GPP TS 51.011 [28]）。 十六进制字符串类型。写入 USIM 卡的信息。 十六进制字符串类型。相关文件在 UICC 的路径。 整型。来自 USIM 的关于执行相关命令的信息。无论命令执行成功或失败都会返回。 十六进制字符串类型。成功执行命令的响应。'获得响应'及'状态'命令将响应 数据信息，提供当前的基本数据字段；所述信息包括文件的类型和大小（参见 3GPP TS 51.011/102.221/31.102）。若成功执行'读取二进制'或'读取记录'命令， 则响应所请求的数据。'更新二进制'和'更新记录'命令则不会响应。 上海移远通信技术股份有限公司 61 / 106 BC26&BC20&BC030x 系列 AT 命令手册 7.8. AT+QCCID USIM 卡识别 执行命令读取 USIM 卡的 ICCID。如果没有 USIM 卡或者 USIM 卡不可读，则不会返回任何数据。 AT+QCCID USIM 卡识别 执行命令 AT+QCCID 响应 +QCCID: 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。USIM 卡识别号（集成电路卡识别码）。 举例 AT+QCCID +QCCID: 89860317482035195410 OK 上海移远通信技术股份有限公司 62 / 106 BC26&BC20&BC030x 系列 AT 命令手册 8 功耗相关命令 8.1. AT+CFUN 设置 UE 功能 设置命令用于选择 UE 的功能等级。'全功能'模式下全部功能打开，功耗最高；'最少功能'模式下 大多数功能关闭，只支持少量基本功能，此时功耗最低。 查询命令返回 UE 的当前功能等级设置。 测试命令返回 MT 所支持参数的范围。 AT+CFUN 设置 UE 功能 测试命令 AT+CFUN=? 响应 +CFUN: (支持的列表),(支持的范围) 查询命令 AT+CFUN? OK 响应 +CFUN: 设置命令 AT+CFUN=[,] OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 85 秒，由网络决定。 见参数说明 参数 整型。UE 功能等级。 0 最少功能 上海移远通信技术股份有限公司 63 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 全功能 4 禁止射频发送和接收 7 仅禁用 USIM。射频发送和接收电路仍有效。 整型。UE 重启设置。 0 无需重启 UE，命令立即生效，但参数配置不保存至 NVRAM 1 重启 UE 后命令生效，且参数配置保存至 NVRAM 2 无需重启 UE，命令立即生效，且参数配置保存至 NVRAM 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CFUN=? +CFUN: (0,1,4,7),(0-2) OK AT+CFUN=1 OK AT+CFUN? +CFUN: 1 OK 8.2. AT+CPSMS 省电模式（PSM）设置 设置命令用于控制 UE 省电模式（PSM）的参数设置，即配置 UE 是否使用 PSM 以及 E-UTRAN 中请 求的扩展周期 TAU 值和激活时间值。请参考 AT+CEREG 返回的 URC 查看激活时间值以及 E-UTRAN 网 络分配给 UE 的扩展周期 TAU 值。 AT+CPSMS=2 为该命令的一种特殊形式，用于禁用 PSM 并清除 AT+CPSMS 命令的所有参数配置（若 参数有默认值，则将其恢复为默认值）。 查询命令返回当前的参数设置情况。 测试命令返回支持的列表、请求的扩展周期 TAU 值范围以及请求的激活时间值范围。 AT+CPSMS 省电模式（PSM）设置 测试命令 AT+CPSMS=? 响应 +CPSMS: (支持的范围),,,(支持的列表),(支持的列表) OK 上海移远通信技术股份有限公司 64 / 106 BC26&BC20&BC030x 系列 AT 命令手册 查询命令 AT+CPSMS? 响应 +CPSMS: [,,,[],[] OK 设置命令 AT+CPSMS=[,,,[,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。禁用或启用 UE 的 PSM。 0 禁用 PSM 1 启用 PSM 2 恢复 PSM 设置为默认值 字符串类型。8 位格式的 1 字节参数。E-UTRAN 分配给 UE 的请 求扩展周期 TAU 值（T3412）。（例如，'01000111'等于 70 小时）。 第 5 位到第 1 位代表二进制编码的计时器值 第 6 位到第 8 位定义了定时器步长： 位 8 7 6 0 0 0 步长为 10 分钟 0 0 1 步长为 1 小时 0 1 0 步长为 10 小时 0 1 1 步长为 2 秒 1 0 0 步长为 30 秒 1 0 1 步长为 1 分钟 1 1 0 步长为 320 小时 1 1 1 去激活定时器 字符串类型。8 位格式的 1 字节参数。待分配给 UE 的请求激活时 间值（T3324）。 上海移远通信技术股份有限公司 65 / 106 BC26&BC20&BC030x 系列 AT 命令手册 （例如，'00100100'等于 4 分钟）。 位 5 至位 1 代表二进制编码的定时器值。 位 6 至位 8 定义 GPRS 定时器步长： 8 7 6 0 0 0 步长为 2 秒 0 0 1 步长为 1 分钟 0 1 0 步长为 6 分钟 1 1 1 去激活定时器 整型。错误码。详细信息，请参阅第 12 章。 备注 定时器步长仅适用于 T3412 扩展值 IE。若以完整性保护消息的形式接收到该值，则 T3412 扩展值应为 320 小时的倍数，否则为 1 小时的倍数。 举例 AT+CPSMS=1,,,'01000011','01000011' OK AT+CPSMS? +CPSMS: 1,,,'01000011','01000011' OK AT+CPSMS=? +CPSMS: (0-2),,,('00000000'-'11111111'), ('00000000'-'11111111') OK 8.3. AT+CEDRXS eDRX 设置 设置命令用于配置 UE 的 eDRX 参数，即 UE 是否使用 eDRX 以及为指定接入技术请求的 eDRX 周期。 当 =2 且 网 络 提 供 的 eDRX 参 数 发 生 变 化 时 ， 设 置 命 令 用 于 控 制 URC +CEDRXP: [,[,[,]]] 的 上 报。 AT+CEDRXS=3 为该命令的一种特殊形式，用于禁用 eDRX 并清除 AT+CEDRXS 命令的所有参数配 置（若参数有默认值，则将其恢复为默认值）。 查询命令返回的当前配置。 测试命令返回支持的列表、接入技术类型列表以及请求的 eDRX 周期列表。 上海移远通信技术股份有限公司 66 / 106 BC26&BC20&BC030x 系列 AT 命令手册 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的范围),(支持的列表), (支持的列表) 查询命令 AT+CEDRXS? OK 响应 +CEDRXS: , [+CEDRXS: ,] [...] 设置命令 AT+CEDRXS=[,[, ]] 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。禁用和启用 eDRX。该参数适用于所有指定接入技术，即 的最新设置将对所有指定的值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 和 URC +CEDRXP: [,[,[,]]]上报 3 禁用 eDRX 并清除所有的 eDRX 参数配置（若有默认值，则 重置为默认值） 整型。接入技术类型。AT+CEDRXS?可查询指定接入技术与请求的 eDRX 周期之间的关系。 0 未使用 eDRX 的接入技术，该参数值仅在 URC 中使用。 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。NB-S1 上海移远通信技术股份有限公司 67 / 106 BC26&BC20&BC030x 系列 AT 命令手册 模式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字 符 串 类 型 。 网 络 下 发 的 eDRX 周 期 ， 半 字 节 （ 4 位 ） 格 式 。 NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗，半字节（4 位）格式。 NB-S1 模式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 上海移远通信技术股份有限公司 68 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS: 5,'0101' OK AT+CEDRXS=? +CEDRXS: (0-3),(5),('0000'-'1111') OK 8.4. AT+CEDRXRDP 查询 eDRX 状态 若 eDRX 用于 MS 当前注册的小区，执行命令将返回、、 和。 若 MS 当前注册的小区未使用 eDRX，则仅返回且值为 0。 AT+CEDRXRDP 查询 eDRX 状态 测试命令 AT+CEDRXRDP=? 执行命令 AT+CEDRXRDP 响应 OK 响应 +CEDRXRDP: [,[,< NW_provided_eDRX_value>[,]]] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 69 / 106 BC26&BC20&BC030x 系列 AT 命令手册 参数 整型。接入技术类型。AT+CEDRXS?可查询指定接入技术与请求的 eDRX 周期之间的关系。 5 E-UTRAN（NB-S1 模式） 字符串类型。请求的 eDRX 周期，半字节（4 位）格式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的 eDRX 周期，半字节（4 位）格式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗，半字节（4 位）格式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 上海移远通信技术股份有限公司 70 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CEDRXRDP +CEDRXRDP: 5,'0010','1110','0101' OK AT+CEDRXRDP=? OK 8.5. AT+QEDRXCFG eDRX 和 PTW 设置 设置命令可设置 UE 的 eDRX/PTW 参数，即控制 UE 是否使用 eDRX、请求的 eDRX 周期值以及指定 接入技术的 PTW（寻呼时间窗）。 AT+QEDRXCFG eDRX 和 PTW 设置 测试命令 AT+QEDRXCFG=? 响应 +QEDRXCFG: (支持的范围),(支持的列 表),(支持的列表),(支持的列表) 查询命令 AT+QEDRXCFG? OK 响应 +QEDRXCFG: ,[,] 设置命令 AT+QEDRXCFG=[,[,[,]]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 71 / 106 BC26&BC20&BC030x 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令立即生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 整型。禁用或启用 eDRX。此参数适用于所有指定接入技术，即 的最新设置将对所有指定的值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 和 URC +CEDRXP: [,[,[,]]]上报 3 恢复默认参数 整型。接入技术类型。AT+CEDRXS?可查询指定接入技术与请求的 eDRX 周期之间的关系。 0 未使用 eDRX 的接入技术，此参数仅用于 URC 中 5 E-UTRAN（NB-S1 模式） 字符串类型。请求的 eDRX 周期，半字节（4 位）格式。NB-S1 模 式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。请求的寻呼时间窗，半字节（4 位）格式。 NB-S1 模式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 上海移远通信技术股份有限公司 72 / 106 上海移远通信技术股份有限公司 BC26&BC20&BC030x 系列 AT 命令手册 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 字符串类型。网络下发的 eDRX 周期，半字节（4 位） 格式。NB-S1 模式。 位 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。网络下发的寻呼时间窗，半字节（4 位） 格式。NB-S1 模式。 位 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 整型。错误码。详细信息，请参阅第 12 章。 73 / 106 BC26&BC20&BC030x 系列 AT 命令手册 举例 AT+QEDRXCFG=1,5,'0101' OK AT+QEDRXCFG? +QEDRXCFG: 5,'0101' OK AT+QEDRXCFG=? +QEDRXCFG: (0-3),(5),('0000'-'1111'),('0000'-'1111') OK 8.6. AT+QNBIOTRAI NB-IoT 释放辅助指示 该命令用于设置是否使用 NB-IoT 辅助释放指示，以便以此决定是否需要立即释放当前的 RRC 连接。 AT+QNBIOTRAI NB-IoT 释放辅助指示 测试命令 AT+QNBIOTRAI=? 响应 +QNBIOTRAI: (支持的范围) 查询命令 AT+QNBIOTRAI? OK 响应 +QNBIOTRAI: 设置命令 AT+QNBIOTRAI= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 仅对随后的一条数据生效。 参数 整型。指定释放辅助信息。 0 不使用释放辅助指示（或无其他可适用的选项） 上海移远通信技术股份有限公司 74 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 发送一个上行数据包之后，请求核心网立即释放 RRC 连接 2 发送一个上行数据包，并通知核心网在下发一个下行数据包后立即释放 RRC 连接 整型。错误码。详细信息，请参阅第 12 章。 8.7. AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 该命令用于启用或禁用 NB-IoT 相关事件上报。 AT+QNBIOTEVENT 启用/禁用 NB-IoT 相关事件上报 测试命令 AT+QNBIOTEVENT=? 查询命令 AT+QNBIOTEVENT? 设置命令 AT+QNBIOTEVENT=, 响应 OK 响应 OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。启用/禁用事件上报 URC。 0 禁用事件上报 URC 1 启用事件上报 URC：+QNBIOTEVENT: 整型。上报的事件。 1 PSM 状态 字符串类型。当上报的事件为 PSM 状态时，有如下两个值： ENTER PSM EXIT PSM 整型。错误码。详细信息，请参阅第 12 章。 上海移远通信技术股份有限公司 75 / 106 BC26&BC20&BC030x 系列 AT 命令手册 8.8. AT+QRELLOCK 释放 AT 命令休眠锁 每次发送完 AT 命令后，模块默认会启动休眠锁定时器（默认为 10 秒）以防止模块进入休眠模式。 该执行命令用于释放所述休眠锁，以便模块在无可用休眠句柄控制系统的休眠状态时可立即进入休眠 状态。 AT+QRELLOCK 释放 AT 命令睡眠锁 执行命令 AT+QRELLOCK 响应 OK 最大响应时间 300 毫秒 特性说明 / 举例 AT+QRELLOCK OK 8.9. AT+QSCLK 配置休眠模式 该命令用于配置 UE 的休眠模式。 AT+QSCLK 配置休眠模式 测试命令 AT+QSCLK=? 响应 +QSCLK: (支持的范围) 查询命令 AT+QSCLK? OK 响应 +QSCLK: 设置命令 AT+QSCLK= OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 76 / 106 BC26&BC20&BC030x 系列 AT 命令手册 最大响应时间 特性说明 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。 0 禁用休眠模式 1 启用轻休眠（Light Sleep）和深休眠（Deep Sleep），并通过 PSM_EINT（下降沿）唤醒深 休眠 2 仅启用轻休眠，并通过主串口唤醒 整型。错误码。详细信息，请参阅第 12 章。 备注 1. 轻休眠模式下，模块的串口不工作。因此，当 AT+QSCLK=1 或 2 时，请在发送其他命令之前先发 送 AT 以确保串口被唤醒。 2. 当 AT+QSCLK=0 时，串口始终有效。若要使模块进入休眠模式，请重新发送 AT+QSCLK=1/2。 3. 数据业务过程中，建议发送 AT+QSCLK=0 禁止模块进入休眠模式，以防止业务交互过程中模块自 动进入休眠而影响正常的业务流程；待业务收发完成后，再执行 AT+QSCLK=1 使能休眠模式。 4. 轻休眠模式下，模块通过 PSM_EINT 唤醒后会立刻再次进入轻休眠，因而会影响业务交互；此时建 议通过主串口发送 AT 命令唤醒模块，或遵循备注 3 的建议。 举例 AT+QSCLK=1 OK 上海移远通信技术股份有限公司 77 / 106 BC26&BC20&BC030x 系列 AT 命令手册 9 平台相关命令 9.1. AT&W 存储当前参数到 NVRAM 该命令用于存储当前参数配置到 NVRAM 里用户定义的配置文件中。目前可以通过该命令存储参数配 置的命令为：ATE、AT+CEREG、AT+CTZR、AT+CEDRXS、AT+CCIOTOPT、AT+QNBIOTEVENT 和 AT+QATWAKEUP。 AT&W 存储当前参数到 NVRAM 执行命令 AT&W[] 最大响应时间 响应 OK 300 毫秒 特性说明 / 参数 整型。 0 用于存储当前参数配置的配置文件编号 9.2. AT+CBC 查询电源电压 该命令用于查询电源的电压值。 AT+CBC 查询电源电压 测试命令 AT+CBC=? 执行命令 AT+CBC 响应 +CBC: (支持的范围),(支持的范围), OK 响应 +CBC: ,, 上海移远通信技术股份有限公司 78 / 106 最大响应时间 特性说明 BC26&BC20&BC030x 系列 AT 命令手册 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。电池充电状态。 0 ME 不在充电中 1 ME 正在充电 2 充电已完成 整型。充电完成情况（百分比）；范围：0-100，表示电池充电已经完成 0-100%。 整型。电池电压；单位：mV。 整型。错误码。详细信息，请参阅第 12 章。 备注 因 BC26、BC20 和 BC030x 系列模块不支持电池充电，故参数和无效，参数值始终为 0。 但参数仍会显示正确的电源电压。 举例 AT+CBC +CBC: 0,0,3368 OK 9.3. AT+QADC 读取 ADC 通道输入电压值 查询命令用于查询 ADC 通道的输入电压值。 设置命令可设置指定 ADC 通道的采样次数和采样间隔时间。 上海移远通信技术股份有限公司 79 / 106 BC26&BC20&BC030x 系列 AT 命令手册 AT+QADC 读取 ADC 通道输入电压值 测试命令 AT+QADC=? 响应 +QADC: (支持的列表),(支持的范围) 查询命令 AT+QADC? OK 响应 +QADC: , 设置命令 AT+QADC=[,[,]] OK 响应 +QADC: , OK 最大响应时间 300 毫秒（有延迟操作的命令除外） 特性说明 / 参数 整型。ADC 转换状态。 0 成功 1 失败 整型。采样电压值或采样电压平均值 ；单位：mV ；范围：0-1400。 整型。ADC 转换通道；范围：0-6，目前仅通道 0（ADC0）有效。 整型。采样次数；范围：1-100；默认值：1。 整型。ADC 采样间隔时间；单位：毫秒；范围：0-100；取值为 10 的整数倍， 默认值：0。 备注 AT+QADC?查询 ADC0 通道的输入电压值。 举例 AT+QADC? +QADC: 2,796 OK 上海移远通信技术股份有限公司 80 / 106 BC26&BC20&BC030x 系列 AT 命令手册 9.4. AT+CMEE 启用/禁用移动终端错误上报 设置命令启用/禁用指示 MT 功能错误的最终结果码+CME ERROR: 。启用后，若有 ME 相关错 误，模块会上报+CME ERROR: 作为最终结果码，而不会返回 ERROR。出现命令语法错误、参数无 效或 TA 功能错误时，依然返回 ERROR。 AT+CMEE 启用/禁用移动终端错误上报 测试命令 AT+CMEE=? 响应 +CMEE: (支持的范围) 查询命令 AT+CMEE? OK 响应 +CMEE: 设置命令 AT+CMEE= 最大响应时间 特性说明 OK 响应 OK 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。启用/禁用结果码+CME ERROR: 。 0 禁用 1 启用，并采用数字形式的结果码 2 启用，并采用详值形式的结果码 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CMEE? +CMEE: 0 OK AT+CMEE=? +CMEE: (0-2) OK 上海移远通信技术股份有限公司 81 / 106 BC26&BC20&BC030x 系列 AT 命令手册 9.5. AT+CEER 扩展错误报告 执行命令可使 TA 返回一行或多行信息文本，其中应包含如下错误的原因报告，上报的信息文 本由 MT 制造商决定。  上一次 PDP 上下文激活失败  PDP 上下文去激活失败 一般来说，TA 只返回一行文本格式信息，包含网络提供的原因信息。 AT+CEER 扩展错误报告 测试命令 AT+CEER=? 执行命令 AT+CEER 响应 OK 响应 +CEER: 最大响应时间 特性说明 OK 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 字符串类型。扩展错误报告。文本信息（包含终止符）的总字符数应不超过 2041 字符，文 本不包含序列 0或者 OK。 备注 该命令不适用于 BC3030S-CN。 举例 AT+CEER +CEER: EMM_CAUSE_EPS_AND_NON_EPS_SERVICES_NOT_ALLOWED OK AT+CEER=? OK 上海移远通信技术股份有限公司 82 / 106 BC26&BC20&BC030x 系列 AT 命令手册 9.6. AT+QRST 自动重启 该命令用于立即重启模块。 AT+QRST 自动重启 测试命令 AT+QRST=? 设置命令 AT+QRST= 最大响应时间 特性说明 响应 +QRST: (支持的列表) OK 响应 立即自动重启 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。 1 无需注销网络，立即自动重启。 整型。错误码。详细信息，请参阅第 12 章。 9.7. AT+QATWAKEUP 启用/禁用深休眠唤醒指示 该命令用于当模块从深休眠唤醒时，启用/禁用此信道上的 URC +QATWAKEUP 上报指示。 AT+QATWAKEUP 启用/禁用深休眠唤醒指示 测试命令 AT+QATWAKEUP=? 响应 +QATWAKEUP: (支持的列表) 查询命令 AT+QATWAKEUP? OK 响应 +QATWAKEUP: 上海移远通信技术股份有限公司 83 / 106 BC26&BC20&BC030x 系列 AT 命令手册 设置命令 AT+QATWAKEUP= 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。当模块从深休眠唤醒时，在此信道上启用/禁用通过 URC +QATWAKEUP 上报指示。 0 禁用 1 启用 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QATWAKEUP=1 OK //从深休眠模式唤醒模块 //启用深休眠唤醒指示 +QATWAKEUP //模块已被完全唤醒并准备接收 AT 命令或者数据 9.8. AT+QCFG 系统配置 该命令用于配置系统的可配置项。 AT+QCFG 系统配置 测试命令 AT+QCFG=? 响应 +QCFG: (支持的列表),(支持的列表) OK 上海移远通信技术股份有限公司 84 / 106 BC26&BC20&BC030x 系列 AT 命令手册 设置命令 AT+QCFG=[,] 最大响应时间 特性说明 响应 若省略参数，则查询当前配置： +QCFG: , OK 若配置参数： OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令重启后生效。 深休眠唤醒后有效；自动保存至 NVRAM。 参数 字符串类型。需配置的功能。 'epco' 配置扩展协议配置项（ePCO） 'combinedattach' 配置联合附着 'up' 配置是否使能用户面功能 'upopt' 配置是否使能用户面优化方案 'multidrb' 配置是否使能支持多 DRB 'autopdn' 配置 PDN 自动激活选项 'ripin' 配置 RI 引脚默认输出电平 'initlocktime' 通过 PSM_EINT 从深休眠唤醒模块或重启模块后配置初始休眠 锁的持续时间 'dsevent' 启用/禁用深休眠事件 URC Enter Deep Sleep 'atlocktime' 通过 AT 命令配置休眠锁持续时间 'urc/ri/mask' 配置 URC 上报是否触发 RI 跳变 'vbattimes' 配置 AT+QVBATT 命令中的电压检测周期 整型。 描述 'epco' 0 禁用 ePCO，即使用 PCO 'epco' 1 使能 ePCO 'combinedattach' 0 关闭联合附着 'combinedattach' 1 打开联合附着 'up' 0 关闭用户面功能 'up' 1 打开用户面功能 'upopt' 0 关闭用户面优化 上海移远通信技术股份有限公司 85 / 106 BC26&BC20&BC030x 系列 AT 命令手册 'upopt' 1 打开用户面优化 'multidrb' 0 关闭多 DRB 'multidrb' 1 打开多 DRB 'autopdn' 0 关闭 PDN 自动激活 'autopdn' 1 打开 PDN 自动激活 'ripin' 0 RI 引脚默认输出高电平 'ripin' 1 RI 引脚默认输出低电平 'dsevent' 0 关闭深休眠事件 URC 上报 'dsevent' 1 打开深休眠事件 URC 上报 'initlocktime' 1-30 配置初始休眠锁持续时间；单位：秒 'atlocktime' 0-10 通过 AT 命令可配置的休眠锁持续时间；单位：秒 'urc/ri/mask' 0, 解除指定 URC 上报时触发 RI 跳变的禁令 'urc/ri/mask' 1, 禁止 URC 上报时触发 RI 跳变 'urc/ri/mask' 2 所有 URC 上报均触发 RI 跳变 'vbattimes' 1-600 AT+QVBATT 命令中的电压检测周期；单位：秒 整型。错误码。详细信息，请参阅第 12 章。 9.9. AT+QPOWD 模块关机/重启 该命令用于使模块关机/重启。 AT+QPOWD 模块关机/重启 查询命令 AT+QPOWD=? 设置命令 AT+QPOWD= 最大响应时间 特性说明 响应 +QPOWD: (支持的范围) OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 85 秒 / 上海移远通信技术股份有限公司 86 / 106 BC26&BC20&BC030x 系列 AT 命令手册 参数 整型。 0 使模块正常关机 1 使模块强制关机 2 使模块重启 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QPOWD=0 OK 9.10. AT+QVBATT 配置电压阈值 该命令用于配置高低压报警阈值和关机阈值。 AT+QVBATT 配置电压阈值 测试命令 AT+QVBATT=? 响应 +QVBATT: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的列表) 查询命令 AT+QVBATT? OK 响应 +QVBATT: ,, 设置命令 AT+QVBATT=[,,] OK 响应 +QVBATT: ,, OK 最大响应时间 300 毫秒（有延迟操作的命令除外） 特性说明 / 参数 整型。配置电压阈值的类型。 0 低压报警 上海移远通信技术股份有限公司 87 / 106 BC26&BC20&BC030x 系列 AT 命令手册 1 低压关机 2 高压报警 3 高压关机 整型。电压阈值；单位：mV。 整型。对应功能类型的开启或关闭状态。 0 关闭 1 开启 备注 若电池电压达到设定的阈值，则对应上报如下 URC：  低压报警：UNDER VOLTAGE WARNING  低压关机：UNDER VOLTAGE POWER DOWN  高压报警：OVER VOLTAGE WARNING  高压关机：OVER VOLTAGE POWER DOWN 举例 AT+QVBATT? +QVBATT: 0,2900,0 +QVBATT: 1,2800,0 +QVBATT: 2,3600,0 +QVBATT: 3,3700,0 OK AT+QVBATT=? +QVBATT: 0,(2100-2900),(0,1) +QVBATT: 1,(2000-2800),(0,1) +QVBATT: 2,(3200-3600),(0,1) +QVBATT: 3,(3300-3700),(0,1) OK 上海移远通信技术股份有限公司 88 / 106 BC26&BC20&BC030x 系列 AT 命令手册 10 时间相关命令 10.1. AT+CCLK 设置/查询当前日期和时间 用户设备接收到 EMM INFORMATION 信号之后会自动同步 RTC 时钟。执行查询命令后返回当前时钟 设置。 AT+CCLK 设置/查询当前日期和时间 测试命令 AT+CCLK=? 查询命令 AT+CCLK? 响应 OK 响应 +CCLK: 设置命令 AT+CCLK= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 字符串类型。格式为'yyyy/mm/dd,hh:mm:ssGMT±zz'，各字符分别指代年、月、日、 时、分、秒和时区（以 1 小时为单位显示本地时间和 GMT 之间的时区差，范围： -12~+12），例如，'2019/05/06,22:10:00GMT+2'表示 2019 年 5 月 6 日，22:10:00 GMT+2 小时。 上海移远通信技术股份有限公司 89 / 106 举例 AT+CCLK? +CCLK: 2019/05/06,22:10:00GMT+2 OK BC26&BC20&BC030x 系列 AT 命令手册 10.2. AT+CTZR 上报时区变化 该命令用于启用/禁用时区变化事件的上报。若启用上报，则时区变化时移动终端会返回 URC +CTZV: 或者+CTZE: ,,[]。 AT+CTZR 上报时区变化 测试命令 AT+CTZR=? 响应 +CTZR: (支持的范围) 查询命令 AT+CTZR? OK 响应 +CTZR: OK 设置命令 AT+CTZR= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。（只能在搜网前设置） 参数 整型。是否上报时区变化。 上海移远通信技术股份有限公司 90 / 106 BC26&BC20&BC030x 系列 AT 命令手册 0 不上报 1 通过 URC +CTZV: 上报时区变化 2 通过 URC +CTZE: ,,[]上报时区信息和本地时间 字符串类型。表示本地时区（以 15 分钟为单位显示本地时间和 GMT 时间的差异）与夏令时 之和；格式为'±zz'，为两个整型数字的固定宽度；范围：-47~+48。为保证固定宽度，-9~+9 之间的数字前加 0，例如：'-09'，'+00'，'+09'。 整型。参数中是否包括夏令时调整。 0 不包括夏时令调整 1 包括+1 小时（相当于的一个小时）的夏时令调整 字符串类型。当前本地日期和时间。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+CTZR=? +CTZR: (0-2) OK AT+CTZR=0 OK AT+CTZR? +CTZR: 0 OK 10.3. AT+QCCLK 设置/查询当前日期和 UTC 设置命令用于设置移动终端的实时时钟。若设置失败，移动终端会上报错码+CME ERROR: 。 查询命令返回时钟的时间和 UTC。 AT+QCCLK 设置/查询当前日期和 UTC 测试命令 AT+QCCLK=? 查询命令 AT+QCCLK? 响应 OK 响应 +QCCLK: 设置命令 AT+QCCLK= OK 响应 OK 上海移远通信技术股份有限公司 91 / 106 BC26&BC20&BC030x 系列 AT 命令手册 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 字符串类型。格式为'yy/MM/dd,hh:mm:ss±zz'，分别指代年、月、日、时、分、秒和时区（以 15 分 钟 为 单 位 显 示 本 地 时 间 和 GMT 之 间 的 时 间 差 ， 范 围 ： -47~+48 ） ， 例 如 ， '19/05/06,22:10:00+08'表示 2019 年 5 月 6 日，22:10:00 GMT+2 小时。 整型。错误码。详细信息，请参阅第 12 章。 举例 AT+QCCLK=? OK AT+QCCLK='19/05/06,22:10:00+08' OK AT+QCCLK? +QCCLK: 19/05/06,22:10:00+08 OK 上海移远通信技术股份有限公司 92 / 106 BC26&BC20&BC030x 系列 AT 命令手册 11 其它命令 11.1. TCP/IP 相关 AT 命令 有关 TCP/IP AT 命令的详细介绍，请参考《Quectel_BC26&BC20_TCP(IP)_AT 命令手册》。 表 2：TCP/IP 相关 AT 命令列表 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] AT 命令名称 AT+QIOPEN AT+QICLOSE AT+QISTATE AT+QISEND AT+QIRD AT+QISENDEX AT+QISWTMD AT+QPING AT+QNTP AT+QIDNSGIP AT+QIDNSCFG AT+QICFG AT+QIGETERROR 功能描述 打开 Socket 服务 关闭 Socket 服务 查询 Socket 服务状态 发送十六进制/文本字符串数据 读取 TCP/IP 数据 发送十六进制字符串数据 切换数据访问模式 Ping 远程服务器 通过 NTP 服务器同步本地时间 转换域名为 IP 地址 配置 DNS 服务器地址 配置可选参数 查询上一个错误代码 上海移远通信技术股份有限公司 93 / 106 BC26&BC20&BC030x 系列 AT 命令手册 11.2. MQTT 相关 AT 命令 有关 MQTT AT 命令的详细介绍，请参考《Quectel_BC26&BC20_MQTT_应用指导》。 表 3：MQTT 相关 AT 命令列表 序号 [1] [2] [3] [4] [5] [6] [7] [8] AT 命令名称 AT+QMTCFG AT+QMTOPEN AT+QMTCLOSE AT+QMTCONN AT+QMTDISC AT+QMTSUB AT+QMTUNS AT+QMTPUB 功能描述 配置 MQTT 可选参数 打开 MQTT 客户端网络 关闭 MQTT 客户端网络 连接客户端至 MQTT 服务器 从 MQTT 服务器断开客户端连接 订阅主题 退订主题 发布消息 11.3. SSL 相关 AT 命令 有关 SSL AT 命令的详细介绍，请参考《Quectel_BC26_SSL_应用指导》。 表 4：SSL 相关 AT 命令列表 序号 [1] [2] [3] [4] AT 命令名称 AT+QSSLCFG AT+QSSLOPEN AT+QSSLSEND AT+QSSLCLOSE 功能描述 配置 SSL 可选参数 打开 SSL 套接字以连接远程服务器 通过 SSL 连接发送数据 关闭 SSL 连接 上海移远通信技术股份有限公司 94 / 106 BC26&BC20&BC030x 系列 AT 命令手册 11.4. LwM2M 相关 AT 命令 有关 LwM2M AT 命令的详细介绍，请参考《Quectel_BC26_LwM2M_应用指导》。 表 5：LwM2M 相关 AT 命令列表 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] AT 命令名称 AT+QLACONFIG AT+QLACFG AT+QLAREG AT+QLAUPDATE AT+QLADEREG AT+QLAADDOBJ AT+QLADELOBJ AT+QLARDRSP AT+QLAWRRSP AT+QLAEXERSP AT+QLAOBSRSP AT+QLANOTIFY AT+QLASENDDATA AT+QLARD AT+QLARECOVER AT+QLASTATUS 功能描述 配置注册参数 配置可选注册参数 发送注册请求 发送更新请求 发送注册请求 添加 LwM2M 对象 删除 LwM2M 对象 响应读请求 响应写请求 响应执行请求 响应订阅求情 上报被订阅资源的数据 直接发送数据（只支持 AndLink） 读取缓存数据 手动恢复 LwM2M 会话 查询当前的 LwM2M 状态 11.5. 电信 IoT 平台相关 AT 命令 有关电信 IoT 平台 AT 命令的详细介绍，请参考《Quectel_BC26&BC20_电信 IoT 平台_应用指导》。 上海移远通信技术股份有限公司 95 / 106 BC26&BC20&BC030x 系列 AT 命令手册 表 6：电信 IoT 平台相关 AT 命令列表 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] AT 命令名称 AT+QLWSERV AT+QLWCONF AT+QLWADDOBJ AT+QLWDELOBJ AT+QLWOPEN AT+QLWUPDATE AT+QLWCLOSE AT+QLWDATASEND AT+QLWDATASTATUS AT+QLWRD AT+QLWCFG AT+QLWDEL 功能描述 配置电信 loT 平台地址和端口 配置电信 IoT 平台参数 添加 LwM2M 对象 删除 LwM2M 对象 向电信 IoT 平台发送注册请求 向电信 IoT 平台发送更新请求 向电信 IoT 平台发送注销请求 发送数据到电信 IoT 平台 查询 CON 消息的发送状态 读取接收数据 配置可选参数 删除 LwM2M 场景 11.6. OneNET 相关 AT 命令 有关 OneNET AT 命令的详细介绍，请参考《Quectel_BC26&BC20_OneNET_应用指导》。 表 7：OneNET 相关 AT 命令列表 序号 AT 命令名称 [1] AT+MIPLCONFIG [2] AT+MIPLCREATE [3] AT+MIPLDELETE [4] AT+MIPLVER [5] AT+MIPLADDOBJ 功能描述 OneNET 接入配置 创建 OneNET 通信套件实例 删除 OneNET 通信套件实例 查询 OneNET 通信套件版本 添加 LwM2M 对象 上海移远通信技术股份有限公司 96 / 106 [6] AT+MIPLDELOBJ [7] AT+MIPLRD [8] AT+MIPLOPEN [9] AT+MIPLCLOSE [10] AT+MIPLDISCOVERRSP [11] AT+MIPLOBSERVERSP [12] AT+MIPLREADRSP [13] AT+MIPLWRITERSP [14] AT+MIPLEXECUTERSP [15] AT+MIPLPARAMETERRSP [16] AT+MIPLNOTIFY [17] AT+MIPLUPDATE BC26&BC20&BC030x 系列 AT 命令手册 删除 LwM2M 对象 读取接收数据 发送注册请求 发送注销请求 响应发现资源请求 响应订阅请求 响应读取请求 响应写入请求 响应执行请求 响应写属性请求 上报数据至 OneNET 平台或应用服务器 发送更新请求 11.7. CMDMP 相关 AT 命令 有 关 中 国 移 动 设 备 管 理 平 台 （ CMDMP ） 接 入 配 置 的 AT 命 令 详 细 介 绍 ， 请 参 考 《Quectel_BC26&BC20_CMDMP_接入指导》。 表 8：CMDMP 相关 AT 命令列表 序号 [1] [2] AT 命令名称 AT+QDMPCFG AT+QDMPCFGEX 功能描述 CMDMP 接入配置 CMDMP 接入扩展配置 上海移远通信技术股份有限公司 97 / 106 BC26&BC20&BC030x 系列 AT 命令手册 11.8. 中国电信/联通自注册相关 AT 命令 有关中国电信/联通自注册的详细介绍，请参考《Quectel_BC20&BC26_运营商自注册使用说明》。 表 9：中国电信/联通自注册相关 AT 命令列表 序号 [1] AT 命令名称 AT+QSREGENABLE 功能描述 启用/禁用电信/联通自注册 11.9. DFOTA 相关 AT 命令 有关 DFOTA AT 命令的详细介绍，请参考《Quectel_BC26&BC20_DFOTA_应用指导》。 表 10：DFOTA 相关 AT 命令列表 序号 [1] [2] AT 命令名称 AT+QFUPLEX AT+QFOTADL 功能描述 通过串口分包写入差分文件 使能 DFOTA 固件升级 上海移远通信技术股份有限公司 98 / 106 BC26&BC20&BC030x 系列 AT 命令手册 12 错误代码汇总 本章主要介绍与模块相关的错误码。 下表列出的错误代码符合 3GPP 规范。客户可以参考 3GPP TS 27.007 V13.5.0 sub-clause 9.2 了解 错误码。 12.1. 常见错误代码列表 表 11：常见错误代码列表（27.007） 3 4 10 13 14 20 23 24 25 30 31 32 50 100 错误代码 Operation not allowed Operation not supported USIM not inserted USIM failure USIM busy USIM memory full Memory failure Text string too long Invalid characters in text string No network service Network timeout Network not allowed - emergency calls only Incorrect parameters Unknown 中文解释 操作不允许 操作不支持 未插入 USIM USIM 失败 USIM 忙 USIM 内存已满 内存故障 文字字符串过长 文字字符串的字符无效 网络无服务 网络超时 网络不允许—仅限紧急呼叫 参数错误 未知 上海移远通信技术股份有限公司 99 / 106 BC26&BC20&BC030x 系列 AT 命令手册 12.2. 指定错误代码列表 以下错误代码为模块指定的错误代码。 表 12：指定错误代码列表 107 111 112 113 132 133 149 584 588 591 592 596 598 606 607 615 630 631 639 675 676 错误代码 中文解释 PSD services not allowed PSD 服务不允许 PLMN not allowed PLMN 不允许 Location area not allowed 位置区域不允许 Roaming not allowed in this location area 此位置区域不允许漫游 Service option not supported 服务选项不支持 Requested service option not subscribed 请求的服务选项未订阅 PDP authentication failure PDP 鉴权失败 Combined service not allowed 不允许组合服务 Feature not supported 该功能不支持 Implicitly detached 隐式分离 Insufficient resources 资源不足 Invalid value 无效的值 Mode value not in range 模式值不在范围内 Low layer failure 低层故障 Missing or unknown failure 缺失或未知故障 Network failure 网络故障 Profile () not defined Profile（）未定义 Unspecified protocol error 未指定协议错误 Service type not yet available 服务类型尚不可用 PDN type IPv4 only allowed 仅允许 IPv4 PDN 连接 PDN type IPv6 only allowed 仅允许 IPv6 PDN 连接 上海移远通信技术股份有限公司 100 / 106 BC26&BC20&BC030x 系列 AT 命令手册 692 EPS service not allowed 不允许 EPS 服务 695 EPS tracking area not allowed 不允许 EPS 跟踪区域 696 Roaming not allowed in TA 不允许 TA 漫游 697 Roaming not allowed in PLMN 不允许 PLMN 漫游 698 Not suitable cells in TA TA 中不适合的小区 700 ESM failure ESM 故障 703 Congestion 拥塞 704 UE security capability mismatch UE 安全能力不匹配 705 Security mode rejected 安全模式被拒绝 709 No EPS bearer context activated 无激活的 EPS 承载上下文 765 Invalid input value 输入值无效 766 Unsupported value or mode 不支持的值或模式 767 Operation failed 操作失败 769 Unable to get control of required module 无法控制所需的模块 770 USIM Invalid – network reject USIM 无效—网络拒绝 772 USIM powered down USIM 掉电 840 No service state 无服务状态 841 In cell search state 处于小区搜索状态 842 ERRC is deactivated ERRC 已停用 843 In cell-reselection state 处于小区重选状态 845 In re-establishment state 处于重建状态 846 In PSM state 处于 PSM 状态 847 No data transfer in idle state 空闲状态下无数据传输 备注 AT+CMEE=命令禁用（=0）或启用（=1）使用最终结果代码+CME ERROR: 。当=1 时，若发生错误，将返回一组有限的错误代码。 上海移远通信技术股份有限公司 101 / 106 BC26&BC20&BC030x 系列 AT 命令手册 13 附录 A 术语缩写 13.1. 参考文档 表 13：参考文档 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] 文档名称 备注 3GPP 27.007 AT Command Set for User Equipment 3GPP 27.005 Equipment (DTE - DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Quectel_BC26&BC20_TCP(IP)_AT 命令手册 用户设备的 3GPP 27.007 AT 命令集 用 于 短 消 息 服 务 （ SMS ） 的 3GPP 27.005 设备（DTE-DCE）接口和小区 广播服务（CBS） BC26/BC20 TCP/IP AT 命令手册 Quectel_BC26&BC20_MQTT_应用指导 BC26/BC20 MQTT 应用指导 Quectel_BC26_SSL_应用指导 BC26 SSL 应用指导 Quectel_BC26_LwM2M_应用指导 BC26 LwM2M 应用指导 Quectel_BC26&BC20_电信 IoT 平台_应用指导 BC26/BC20 电信 IoT 平台应用指导 Quectel_BC26&BC20_OneNET_应用指导 BC26/BC20 OneNET 平台应用指导 Quectel_BC26&BC20_CMDMP_接入指导 Quectel_BC20&BC26_运营商自注册使用说明 Quectel_BC26&BC20_DFOTA_应用指导 BC26/BC20 CMDMP 接入配置指导 BC20&BC26 中国电信/联通自注册配 置说明 BC26/BC20 DFOTA 应用指导 上海移远通信技术股份有限公司 102 / 106 13.2. 术语缩写 BC26&BC20&BC030x 系列 AT 命令手册 表 14：术语缩写 术语 3GPP ACK AM APN ARQ BCCH BCD CMDMP CN DCE DHCP DL DL-SCH DTE EARFCN ECL EMM E-UTRAN eDRX EGPRS ePCO 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 Acknowledgement 确认 Acknowledged Mode 确认模式 Access Point Name 接入点名称 Automatic Repeat Request 自动重传请求 Broadcast Control Channel 广播控制信道 Binary Coded Decimal 二进制编码的十进制 China Mobile Device Management Platform 中国移动设备管理平台 Core Network Data Communication Equipment (typically the module) Dynamic Host Configuration Protocol 核心网络 数据通信设备（特指模块） 动态主机配置协议 Downlink (Forward Link) 下行（前向链路） Downlink-Shared Channel 下行共享信道 Data Terminal Equipment (typically the MCU/external processor) 数据终端设备（特指 MCU/外部处理器） E-UTRA Absolute Radio Frequency Channel E-UTRA 绝对射频信道号 Number Enhanced Coverage Level 增强覆盖等级 EPS Mobility Management EPS 移动性管理 Evolved Universal Terrestrial Radio Access 演进的通用陆基无线接入网 Network extended Discontinuous Reception 扩展非连续接收 Enhanced General Packet Radio Service 增强型数据速率 GSM 演进技术 Extended Protocol Configuration Options 扩展协议配置选项 上海移远通信技术股份有限公司 103 / 106 BC26&BC20&BC030x 系列 AT 命令手册 EPS ESM GERAN GGSN GMT GPRS GSM HARQ HPLMN HSDPA HSUPA ICCID ICMP IE IM IMEI IMEISV IMSI MQTT MS MT MTU NB-IoT NSLPI NVRAM PAD Evolved Packet System 演进型分组系统 EPS Session Management EPS 会话管理 GSM/EDGE Radio Access Network GSM/EDGE 无线接入网 Gateway GPRS Support Node GPRS 网关支持节点 Greenwich Mean Time 格林尼治标准时间 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Hybrid Automatic Repeat Request 混合式自动重送请求 Home Public Land Mobile Network 本地公用陆地移动网 High-Speed Downlink Packet Access 高速下行分组接入 High-Speed Uplink Packet Access 高速上行分组接入 Integrated Circuit Card Identity 集成电路卡识别码 Internet Control Messages Protocol 网间控制报文协议 Information Element 信息单元 Intermodulation/IP Multimedia 互调/IP 多媒体 International Mobile Equipment Identity 国际移动设备识别码 International Mobile Equipment Identity and 国际移动用户识别码及软件版本 Software Version International Mobile Subscriber Identity 国际移动用户识别码 Message Queuing Telemetry Transport 消息队列遥测传输协议 Mobile Station 移动台 Mobile Termination (typically the module) 移动终端（特指模块） Maximum Transfer Unit 最大传输单元 Narrowband Internet of Things 窄带物联网 NAS (Non-access Stratum) Signaling Low 非接入层信令低优先级指示 Priority Indication Non-Volatile Random Access Memory 非易失性随机访问存储器 Packet Assember/Disassemble 分组组装拆卸器 上海移远通信技术股份有限公司 104 / 106 PCI PCO P-CSCF PDCP PDN PDP PSM PSD PSK QoS RAM RFC RLC RRC RSRP RSRQ RSSI RTC SNDCP SNR SVN TA TCP TE TTL UDP Physical Cell Identification Protocol Configuration Options Proxy Call Session Control Function Packet Data Convergence Protocol Public Data Network Packet Data Protocol Power Saving Mode Packet Switch Domin Pre-Shared key Quality of Service Random Access Memory Request For Comments Radio Link Control Radio Resource Control Received Signal Received Power Reference Signal Received Quality Received Signal Strength Indicator Real Time Clock Sub-Network Dependent Convergence Protocol Signal-to-Noise Ratio Software Version Number Terminal Adapter (typically the module) Transmission Control Protocol Terminal Equipment (typically the MCU/external processor) Time To Live User Datagram Protocol BC26&BC20&BC030x 系列 AT 命令手册 物理小区标识 协议配置选项 代理呼叫会话控制 分组数据汇聚协议 公用数据网 分组数据协议 省电模式 分组域 预共享密钥 服务质量 随机存取存储器 请求注解 无线链路控制 无线资源控制 参考信号接收功率 参考信号接收质量 接收的信号强度指示 实时时钟 子网相关融合协议 信噪比 软件版本 终端适配器（特指模块） 传输控制协议 终端设备（特指 MCU/外部处理器） 存活时间 用户数据报协议 上海移远通信技术股份有限公司 105 / 106 UE UICC UL UL-SCH URC UTC UUID User Equipment (typically the module) Universal Integrated Circuit Card Uplink (Reverse Link) Uplink Shared Channel Unsolicited Result Code Universal Time Coordinated Universally Unique Identifier BC26&BC20&BC030x 系列 AT 命令手册 用户设备（特指模块） 通用集成电路卡 上行（反向链路） 上行共享信道 非请求结果码 协调世界时 通用唯一识别码 上海移远通信技术股份有限公司 106 / 106

BC35-G&BC28&BC95 R2.0 AT 命令手册 NB-IoT 模块系列 版本：BC35-G&BC28&BC95 R2.0_AT 命令手册_V1.0 日期：2019-12-04 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0 AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 文档历史 修订记录 版本 1.0 日期 2019-12-04 作者 王成钧/ 刘强 变更表述 初始版本 上海移远通信技术股份有限公司 2 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 1.1. 定义 ............................................................................................................................................ 9 1.2. AT 命令语法 ............................................................................................................................... 9 1.3. AT 命令响应 ............................................................................................................................. 10 1.4. 3GPP ........................................................................................................................................ 10 2 3GPP 命令（27.007） ........................................................................................................................ 11 2.1. ATI 显示产品标识信息 ........................................................................................................... 11 2.2. ATE 设置命令的回显模式 ...................................................................................................... 12 2.3. AT+CGMI 请求制造商标识 .................................................................................................... 13 2.4. AT+CGMM 请求制造商型号 .................................................................................................. 13 2.5. AT+CGMR 请求制造商版本号............................................................................................... 14 2.6. AT+CGSN 请求产品序列号 ................................................................................................... 15 2.7. AT+CEREG EPS 网络注册状态 ............................................................................................ 17 2.8. AT+CSCON 信令连接状态 .................................................................................................... 20 2.9. AT+CLAC 列出可用命令 ....................................................................................................... 22 2.10. AT+CSQ 获取信号强度指示 .................................................................................................. 23 2.11. AT+CGPADDR 显示 PDP 地址 ............................................................................................. 24 2.12. AT+COPS PLMN 选择 .......................................................................................................... 25 2.13. AT+CGATT PS 附着与去附着 ............................................................................................... 28 2.14. AT+CGACT 激活或停用 PDP 上下文.................................................................................... 29 2.15. AT+CIMI 请求国际移动用户识别码 ....................................................................................... 31 2.16. AT+CGDCONT 定义 PDP 上下文 ......................................................................................... 32 2.17. AT+CFUN 设置 UE 功能 ....................................................................................................... 35 2.18. AT+CMEE 上报 UE 错误 ....................................................................................................... 36 2.19. AT+CCLK 返回当前日期和时间............................................................................................. 37 2.20. AT+CPSMS 设置省电模式 .................................................................................................... 38 2.21. AT+CEDRXS 设置 eDRX ...................................................................................................... 41 2.22. AT+CEER 扩展错误报告 ....................................................................................................... 44 2.23. AT+CEDRXRDP 读取动态 eDRX 参数 ................................................................................. 45 2.24. AT+CTZR 设置时区上报 ....................................................................................................... 47 2.25. AT+CIPCA 初始 PDP 上下文激活 ......................................................................................... 48 2.26. AT+CGAPNRC APN 速率控制.............................................................................................. 50 2.27. AT+CSODCP 通过控制面发送始端数据 ............................................................................... 51 2.28. AT+CRTDCP 通过控制面上报终端数据................................................................................ 53 2.29. AT+CGCONTRDP 查询 PDP 上下文的动态参数.................................................................. 55 2.30. AT+CGAUTH 定义 PDP 上下文鉴权参数.............................................................................. 56 2.31. AT+CNMPSD 指示无更多 PS 数据 ....................................................................................... 58 上海移远通信技术股份有限公司 3 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.32. AT+CPIN 输入 PIN 码............................................................................................................ 58 2.33. AT+CPINR 查询剩余 PIN 的重试次数 ................................................................................... 60 2.34. AT+CCHO 打开逻辑信道 ...................................................................................................... 61 2.35. AT+CCHC 关闭逻辑信道....................................................................................................... 62 2.36. AT+CGLA 通用 UICC 逻辑信道访问 ..................................................................................... 63 2.37. AT+CRSM 受限 SIM 卡访问.................................................................................................. 65 2.38. AT+CSIM 通用 SIM 卡访问 ................................................................................................... 67 2.39. AT+CGDATA 输入数据状态 .................................................................................................. 68 2.40. AT+CCIOTOPT CIoT 优化配置............................................................................................. 70 2.41. AT+CGCMOD 修改 PDP 上下文 ........................................................................................... 72 2.42. AT+CGEQOS 定义 EPS 服务器质量 .................................................................................... 73 2.43. AT+CGTFT 业务流模版......................................................................................................... 75 3 3GPP 命令 (27.005) ........................................................................................................................... 79 3.1. AT+CSMS 选择短信服务....................................................................................................... 79 3.2. AT+CNMA 发送新消息确认................................................................................................... 81 3.3. AT+CSCA 设置短信服务中心地址 ........................................................................................ 82 3.4. AT+CMGS 发送短信.............................................................................................................. 83 3.5. AT+CMGC 发送短信命令 ...................................................................................................... 85 3.6. AT+CMMS 发送更多信息 ...................................................................................................... 86 4 一般命令 .............................................................................................................................................. 88 4.1. AT+NRB 重启 UE .................................................................................................................. 88 4.2. AT+NUESTATS 查询 UE 统计信息....................................................................................... 88 4.3. AT+NEARFCN 指定搜索频率................................................................................................ 94 4.4. AT+NSOCR 创建 Socket....................................................................................................... 95 4.5. AT+NSOST 发送消息（仅限 UDP）..................................................................................... 97 4.6. AT+NSOSTF 发送带标志的消息（仅限 UDP） .................................................................... 98 4.7. AT+NQSOS 查询待处理的 Socket 消息清单 ........................................................................ 99 4.8. AT+NSORF 读取消息.......................................................................................................... 100 4.9. AT+NSOCO 连接命令（仅限 TCP） .................................................................................. 101 4.10. AT+NSOSD 发送消息（仅限 TCP）................................................................................... 102 4.11. AT+NSOCL 关闭 Socket ..................................................................................................... 103 4.12. AT+NSONMI 指示已到达 Socket 的消息 ............................................................................ 104 4.13. +NSOCLI 关闭 Socket 指示（仅用于响应） ....................................................................... 105 4.14. AT+NPING 测试到远程主机的 IP 网络连接......................................................................... 106 4.15. AT+NBAND 设置支持的频段............................................................................................... 107 4.16. AT+NLOGLEVEL 设置调试日志级别 .................................................................................. 108 4.17. AT+NCONFIG 配置 UE 行为............................................................................................... 109 4.18. AT+NATSPEED 配置 UART 端口波特率 ............................................................................ 113 4.19. AT+NCCID 识别 USIM 卡.................................................................................................... 115 4.20. AT+NFWUPD 通过 UART 更新固件 ................................................................................... 116 4.21. AT+NPOWERCLASS 设置 Band 和 Power Class 的映射 .................................................. 117 4.22. AT+NPSMR 省电模式状态上报........................................................................................... 118 4.23. AT+NPTWEDRXS 设置 PTW 和 eDRX .............................................................................. 119 上海移远通信技术股份有限公司 4 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.24. AT+NPIN PIN 运营商 .......................................................................................................... 122 4.25. AT+NCSEARFCN 清除存储的频点 ..................................................................................... 124 4.26. AT+NIPINFO 上报 IP 地址信息 ........................................................................................... 124 4.27. AT+NCPCDPR 配置要读取的 PDP 上下文动态参数 .......................................................... 126 4.28. AT+NQPODCP 通过控制面查询待处理的原始数据列表..................................................... 128 4.29. AT+NITZ 设置时间更新模式................................................................................................ 129 4.30. AT+QLEDMODE 设置 NETLIGHT 功能模式....................................................................... 130 4.31. AT+QIDNSCFG 配置 DNS 服务器地址............................................................................... 131 4.32. AT+QDNS 触发 DNS 域名解析 ........................................................................................... 133 4.33. AT+QCHIPINFO 读取系统信息 ........................................................................................... 134 4.34. AT+QCFG 扩展配置设置..................................................................................................... 135 4.34.1. AT+QCFG='LWM2M/Lifetime' 配置华为 IoT 平台注册生命周期............................. 135 4.34.2. AT+QCFG='LWM2M/EndpointName' 配置接入 IoT 平台时的 Endpoint Name...... 136 4.34.3. AT+QCFG='LWM2M/BindingMode' 配置接入 IoT 平台时的绑定模式 .................... 137 4.35. AT+NSNPD 发送 Non-IP 数据............................................................................................. 138 4.36. AT+NRNPDM 设置 Non-IP 数据模式上报........................................................................... 140 4.37. AT+NQPNPD 查询待处理的 Non-IP 数据列表.................................................................... 141 4.38. AT+NSOSTATUS 获取 Socket 状态 ................................................................................... 142 4.39. AT+NCIDSTATUS 获取状态 ...................................................................................... 144 4.40. AT+NGACTR 上报 PDP 上下文激活或去激活结果 ............................................................. 146 4.41. AT+NUICC 设置 UICC 功耗模式 ......................................................................................... 147 5 LwM2M 物联网平台命令................................................................................................................... 149 5.1. AT+NCDP 配置和查询 CDP 服务器设置............................................................................. 149 5.2. AT+QSECSWT 设置数据加密模式 ..................................................................................... 150 5.3. AT+QSETPSK 设置 PSK ID 和 PSK ................................................................................... 151 5.4. AT+QLWSREGIND 注册控制.............................................................................................. 152 5.5. AT+QLWULDATA 发送数据................................................................................................ 153 5.6. AT+QLWULDATAEX 发送 CON/NON 消息 ........................................................................ 154 5.7. AT+QLWULDATASTATUS 查询 CON 消息发送状态 ......................................................... 155 5.8. AT+QLWFOTAIND 设置 DFOTA 升级模式......................................................................... 156 5.9. AT+QREGSWT 设置注册模式 ............................................................................................ 156 5.10. AT+NMGS 发送消息............................................................................................................ 158 5.11. AT+NMGR 接收消息 ........................................................................................................... 159 5.12. AT+NNMI 设置新消息指示 .................................................................................................. 159 5.13. AT+NSMI 发送消息指示 ...................................................................................................... 161 5.14. AT+NQMGR 查询已接收消息状态 ...................................................................................... 162 5.15. AT+NQMGS 查询发送的消息状态 ...................................................................................... 163 5.16. AT+NMSTATUS 消息注册状态 ........................................................................................... 164 5.17. +QLWEVTIND LwM2M 事件上报（仅用于响应） .............................................................. 165 5.18. AT+QRESETDTLS 重置 DTLS 模式 ................................................................................... 165 5.19. AT+QDTLSSTAT 查询 DTLS 状态...................................................................................... 166 5.20. AT+QBOOTSTRAPHOLDOFF* Bootstrap 延时时长.......................................................... 167 5.21. AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP ............................................ 168 5.22. AT+QCRITICALDATA 查询是否可发送紧急数据................................................................ 169 上海移远通信技术股份有限公司 5 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5.23. AT+QSETBSPSK* 配置 PSK ID 和 PSK 到 Bootstrap........................................................ 170 5.24. AT+QBSSECSWT* 设置 Bootstrap 加密模式 ..................................................................... 171 6 错误码 ............................................................................................................................................... 173 7 重启原因 ............................................................................................................................................ 176 8 举例 ................................................................................................................................................... 178 8.1. 附着网络 ................................................................................................................................. 178 8.1.1. 自动附着网络............................................................................................................... 178 8.1.2. 手动附着网络............................................................................................................... 179 8.2. 发送/接收/读取 UDP 信息....................................................................................................... 180 8.3. 发送/接收/读取 TCP 信息 ....................................................................................................... 181 8.4. 华为 IoT 平台相关举例 ........................................................................................................... 182 8.4.1. 注册华为 IoT 平台........................................................................................................ 182 8.4.1.1. 自动注册模式.................................................................................................... 182 8.4.1.2. 手动注册模式.................................................................................................... 182 8.4.2. 从华为 IoT 平台发送/接收数据 .................................................................................... 183 8.4.3. 在华为 IoT 平台上升级固件 ......................................................................................... 183 8.4.3.1. 通过 DFOTA 自动升级固件 .............................................................................. 183 8.4.3.2. 通过 DFOTA 手动升级固件 .............................................................................. 184 8.4.4. 使用 DTLS 注册华为 IoT 平台 ..................................................................................... 185 9 附录 A 术语缩写 ............................................................................................................................... 187 上海移远通信技术股份有限公司 6 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 表格索引 表 1：指示模块更新状态的 URC ......................................................................................................................... 8 表 2：AT 命令及响应类型 .................................................................................................................................... 9 表 3：通用错误码（27.007） .......................................................................................................................... 173 表 4：通用错误码（27.005） .......................................................................................................................... 173 表 5：特定错误码............................................................................................................................................. 174 表 6：重启原因显示 ......................................................................................................................................... 176 表 7：术语缩写 ................................................................................................................................................ 187 上海移远通信技术股份有限公司 7 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 1 引言 本文档详细介绍了移远通信 NB-IoT 模块 BC35-G、BC28 和 BC95 R2.0 支持的 AT 命令集。 模块开启后，将输出字符串 NeulOK。收到此字符串后，AT 命令处 理器将开始准备接收 AT 命令。 如果 BC35-G、BC28 或 BC95 R2.0 模块由于任何不正常上电顺序导致了重新开机，将在字符串 NeulOK 前输出一条消息，以表明重新启动的原因，详细信息请参考第 7 章。 如果外部 MCU 介入模块 DFOTA 固件更新过程，模块将输出 URC 通知外部 MCU 当前的更新状态。 表 1：指示模块更新状态的 URC URC 描述 FIRMWARE DOWNLOADING 指示模块正在下载固件。 FIRMWARE DOWNLOAD FAILED 指示固件下载失败。 FIRMWARE DOWNLOADED 指示固件下载完成。 FIRMWARE UPDATING FIRMWARE UPDATE SUCCESS FIRMWARE UPDATE FAILED FIRMWARE UPDATE OVER 指示模块正在升级固件。 指示固件升级成功，但是升级状态尚未上报 给固件包服务器。 指示固件升级失败。 指示固件升级成功，且升级状态已上报给固 件包服务器（输出该URC后，升级完成）。 备注 在更新过程中，在报告 FIRMWARE UPDATE OVER 之前，请勿对模块进行操作（例如，不可执行 AT+NRB 命令关闭模块），否则将发生错误。 上海移远通信技术股份有限公司 8 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 1.1. 定义  ：回车符；  ：换行符；  ：参数名称。实际命令中不包括尖括号 < >；  [...]：可选参数。实际命令中不包括方括号 [ ]。 1.2. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅示出响应，省略 。 AT 命令的语法及响应类型如下表所示： 表 2：AT 命令及响应类型 测试命令 查询命令 设置命令 执行命令 AT+=? AT+? AT+= AT+ 返回相应设置命令可设置的参数列表及取值范围。 返回相应设置命令参数的当前设置值。 设置用户可自定义的参数值。 执行无需设置参数值的命令。 可以用分号（';'）将多个命令放在同一行。此时只有第一个命令带有'AT'前缀。命令可以是大写 或小写。 输入 AT 命令时，将忽略空格，但以下情况除外：  带引号的字符串内；  不带引号的字符串或数字参数内；  IP 地址内  在 AT 命令名称中的'='、'？'或'=？'内 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 上海移远通信技术股份有限公司 9 /190 备注 本文档参数说明中添加下划线的参数值为默认值。 BC35-G&BC28&BC95 R2.0 AT 命令手册 1.3. AT 命令响应 当 AT 命令处理器处理完一条命令后，将响应 OK、ERROR 或 +CME ERROR: ，表示已经准 备接收新命令。在返回最终的 OK，ERROR 或 +CME ERROR: 之前，会发送请求的响应消息。 在使用 AT 命令过程出现错误时，若返回 +CME ERROR: ，请参考第 6 章，查找 错误 码。 AT 命令响应的格式为： +CMD1: OK 或者 OK 1.4. 3GPP 本文档命令遵从 3GPP TS 27.007 v14.3.0 (2017-03)。 上海移远通信技术股份有限公司 10 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2 3GPP 命令（27.007） 2.1. ATI 显示产品标识信息 该命令返回产品标识信息。 ATI 显示产品标识信息 执行命令 ATI 最大响应时间 响应 Quectel Revision: OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 设备型号 软件版本号 举例 ATI Quectel BC35-G Revision:BC35GJBR01A01 OK 上海移远通信技术股份有限公司 11 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.2. ATE 设置命令的回显模式 该命令设置是否从外接 MCU 接收 UE 回显字符。 ATE 设置命令的回显模式 执行命令 ATE 响应 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 0 关闭回显模式 1 开启回显模式 举例 ATE0 OK ATI Quectel BC35-G Revision: BC35GJBR01A01 OK ATE1 OK ATI ATI Quectel BC35-G Revision: BC35GJBR01A01 OK 上海移远通信技术股份有限公司 12 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.3. AT+CGMI 请求制造商标识 该命令返回制造商信息，在标准平台下，将默认返回 Quectel。 AT+CGMI 请求制造商标识 执行命令 AT+CGMI 响应 OK 测试命令 AT+CGMI=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 制造商信息。信息文本（包括行终止符在内）的字符总数不超过 2048，且不包含 0 或 OK 序列。 举例 AT+CGMI Quectel OK 2.4. AT+CGMM 请求制造商型号 该命令返回制造商型号信息。 AT+CGMM 请求制造商型号 执行命令 AT+CGMM 响应 OK 上海移远通信技术股份有限公司 13 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 测试命令 AT+CGMM=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 制造商型号信息。信息文本（包括行终止符在内）的字符总数不应超过 2048，且不包 含 0 或 OK 序列。 举例 AT+CGMM BC35GJB-02-STD OK 2.5. AT+CGMR 请求制造商版本号 该命令返回制造商版本号。该命令默认返回发布和编译的固件版本（包括核及对应的版本号）。 该执行命令返回一行或多行 。 AT+CGMR 请求制造商版本号 执行命令 AT+CGMR 响应 OK 测试命令 AT+CGMR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 14 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 最大响应时间 300 毫秒 参数 制造商版本号。信息文本（包括行终止符在内）的字符总数不应超过 2048，且不包含 0 或 OK 序列。此参数的格式可能会改变。 举例 AT+CGMR SSB,V150R100C10B200SP1 SECURITY_A,V150R100C20B300SP2 PROTOCOL_A,V150R100C20B300SP2 APPLICATION_A,V150R100C20B300SP2 SECURITY_B,V150R100C20B300SP2 RADIO,Hi2115_RF1 OK AT+CGMR=? OK 2.6. AT+CGSN 请求产品序列号 该命令返回 IMEI 号及相关信息。对于不支持 的 UE，仅返回 OK。 AT+CGSN 请求产品序列号 执行命令 AT+CGSN[=] 响应 =0（或者省略）且命令执行成功时： =1 且命令执行成功时： +CGSN: =2 且命令执行成功时： +CGSN: 上海移远通信技术股份有限公司 15 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 测试命令 AT+CGSN=? 最大响应时间 =3 且命令执行成功时： +CGSN: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 UE 支持且命令执行成功时： +CGSN:(支持的列表) OK UE 不支持时： OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。被请求的序列号类型。 0 返回 1 返回 IMEI 号 2 返回 IMEISV 号 3 返回 SVN UE 的 128 位 UUID。信息文本（包括行终止符在内）的字符总数不应超过 2048，且不 包含 0 或 OK 序列。 十进制格式的字符串类型。IMEI 号 十进制格式的字符串类型。IMEISV 号 十进制格式的字符串类型。当前 SVN（SVN 是 IMEISV 的一部分） 举例 AT+CGSN=1 +CGSN:490154203237511 //请求 IMEI 号 上海移远通信技术股份有限公司 16 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 OK 2.7. AT+CEREG EPS 网络注册状态 设置命令用于设置 EPS 网络注册状态 URC 的显示：=1 设置在 E-UTRAN 中 UE 的 EPS 网络注册 状态发生改变时的 URC +CEREG: 的显示；=2 设置在 E-UTRAN 中的网络小区发生改变时的 URC +CEREG: [,[],[],[]] 的显示。参数 、 和 只有在可用时才 会上报。在 =2 的基础上，如果可用，=3 设置当 的值改变时在 URC 显示更多参数 和 。 =4 设置当 UE 请求 PSM 减少其功率消耗时的 URC +CEREG: [,[],[],[][,[< cause_type>],[][,[],[]]]] 的显示。 当 =4 时，如果 E-UTRAN 的小区发生改变，URC 将向 UE 提供附加的 active-time 值及扩展周期 性 TAU 值信息。当 =5 时，如果 的值发生改变，URC 将会比 =4 时多上报 和 参数。 参数 、、、、、 与 只有在可用时才会上报。 查询命令会返回结果码的显示状态和整数型参数 ，显示 UE 是否已经注册当前网络。如果可用， 位 置 信 息 参 数 、 与 ， 仅 在 =2 且 UE 已 注 册 网 络 时 上 报 。 如 果 参 数 [,,] 可用，当 =3 时返回。 AT+CEREG EPS 网络注册状态 设置命令 AT+CEREG= 响应 OK 查询命令 AT+CEREG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 =0、1、2 或 3 且命令执行成功时： +CEREG:,[,[],[],[[,, ]]] =4 或 5 且命令执行成功时： +CEREG:,[,[],[],[] [,[],[][,[],[]]]] 上海移远通信技术股份有限公司 17 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 测试命令 AT+CEREG=? 最大响应时间 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEREG:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。 0 禁用网络注册 URC 1 使能网络注册 URC：+CEREG: 2 使能网络注册与位置信息 URC：+CEREG:[,[],[],[]] 3 使能网络注册、位置信息和 EMM 原因值 URC： +CEREG:[,[],[],[][,,]] 4 对于请求 PSM 的 UE，使能网络注册和位置信息 URC： +CEREG:[,[],[],[][,,[,[],[]]]] 5 对于请求 PSM 的 UE，使能网络注册、位置信息和 EMM 原因值 URC： +CEREG:[,[],[],[][,[],[][,[< Active-Time>],[]]]] 整型。EPS 注册状态。 0 未注册，UE 目前未搜索运营商进行注册 1 已注册，本地网络 2 未注册，但 UE 目前正在连接或搜索运营商进行注册 3 注册被拒绝 4 未知（例如不在 E-UTRAN 范围内） 5 已注册，漫游网络 字符串类型。十六进制 2 字节跟踪区域代码（例如'00C3'等于十进制的 195）。 字符串类型。十六进制 4 字节的 E-UTRAN 小区 ID。 整型。服务小区的接入技术。 7 E-UTRAN 上海移远通信技术股份有限公司 18 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 9 E-UTRAN（NB-S1 模式） 整型。 类型。 0 表示 包含一个 EMM 原因值 1 表示 包含一个特定制造商的原因值 整型。包含注册失败的原因。该参数的类型由 定义。 字符串类型。8 位格式的一个字节。表示在 E-UTRAN 中分配给 UE 的 Active-time 值 （T3324）。Active-time 值编码为 GPRS Timer 2 信息元素的一个字节（octet 3），编 码为位格式（例如'00100100'等于 4 分钟）。 关于编码和值范围，请参考 3GPP TS 24.008、3GPP TS 23.682 和 3GPP TS 23.401。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器的值单位，定义如下： 位数 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 该值表示定时器被停用 在此版本的 3GPP 协议中，其他值应以 1 分钟的倍数递增。 字符串类型。8 位格式的一个字节。表示在 E-UTRAN 中分配给 UE 的扩展周期性 TAU 值（T3412）。扩展的周期 TAU 值，编码为 GPRS Timer 3 信息元素的一个字节（octet 3），编码为位格式（例如'01000111'等于 70 小时）。 对于编码和值范围，请参考 3GPP TS 24.008、3GPP TS 23.682 和 3GPP TS 23.401。 第 5 位到第 1 位代表二进制编码定时器值。 第 6 位到第 8 位定义 GPRS Timer 定时器值单位，定义如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增 1 1 1 该值表示定时器被停用 举例 AT+CEREG=1 OK AT+CEREG? +CEREG:1,1 OK AT+CEREG=? //使能网络注册 URC。 上海移远通信技术股份有限公司 19 /190 +CEREG:(0,1,2,3,4,5) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.8. AT+CSCON 信令连接状态 该命令返回 UE 感知到的无线连接状态（即和基站的连接）的详细信息，并返回当前状态的指示。该状 态仅在无线事件发生时更新，例如发送和接收数据。因此，当前返回的状态可能已经过时。即使在返回状 态 =1（已连接）的情况下，因为连接质量的变化，模块仍可能无法使用基站。 设置命令控制 URC 的显示。 UE 处于 E-UTRAN 网络时，当没有 PS 信令连接时，UE 为空闲模式；当 UE 与网络间的 PS 信令连接 建立时，UE 为连接模式。 UE 处于 E-UTRAN 网络时， 的值表示 UE 的状态。 查询命令返回结果码的显示状态和整型参数 。 指示 UE 当前为空闲模式或者连接模 式。 AT+CSCON 信令连接状态 设置命令 AT+CSCON= 响应 OK 查询命令 AT+CSCON? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCON:, OK 测试命令 AT+CSCON=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCON:(支持的列表) OK 上海移远通信技术股份有限公司 20 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。表示使能/禁用 URC。 0 禁用 URC 1 使能 URC：+CSCON: 整型。表示信令连接状态。 0 空闲 1 已连接 2-255 保留待用 举例 AT+CSCON=0 OK AT+CSCON? +CSCON:0,1 OK AT+CSCON=? +CSCON:(0,1) OK AT+CSCON=1 OK AT+CSCON? +CSCON:1,1 OK 上海移远通信技术股份有限公司 21 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.9. AT+CLAC 列出可用命令 该命令用于查询可用命令清单。执行命令会让 UE 返回一行或多行 AT 命令。本命令仅返回用户可用的 AT 命令。 AT+CLAC 列出可用命令 执行命令 AT+CLAC 响应 [] [...] OK 测试命令 AT+CLAC=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 举例 AT+CLAC AT+COPS AT+CGATT ... AT+NSOCR AT+NSOST … 表示定义包括前缀 AT 在内的 AT 命令。文本不包含 0 或 OK。 上海移远通信技术股份有限公司 22 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 OK 2.10. AT+CSQ 获取信号强度指示 该执行命令返回从 UE 接收到的信号强度指示 和信道误码率 。 测试命令返回所支持参数的范围。 AT+CSQ 获取信号强度指示 执行命令 AT+CSQ 响应 +CSQ:, OK 测试命令 AT+CSQ=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSQ:(支持的列表),(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 * 整型。表示接收到的信号强度。单位：dBm。 0 等于或小于-113dBm 1 -111dBm 2…30 -109dBm... -53dBm 31 大于或等于-51dBm 99 未知或无法检测 整型。表示信道误码率（百分比）。 0...7 作为 RxQual 值（请参考 3GPP 规范） 上海移远通信技术股份有限公司 23 /190 99 未知或无法检测 备注 当前不支持 ，因此该值始终为 99。 举例 AT+CSQ +CSQ:31,99 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.11. AT+CGPADDR 显示 PDP 地址 该命令返回设备 IP 地址。 设置命令返回指定 的 PDP 地址列表。如果没有指定 ，则返回所有已定义上下文的地址。 测试命令返回定义的 列表。这些 已被激活，可能有也可能没有与之关联的 IP 地址。 AT+CGPADDR 显示 PDP 地址 执行/设置命令 AT+CGPADDR[=[,[,...]]] 响应 +CGPADDR:[,[,]] [+CGPADDR:,[[,]]] [...]]] OK 测试命令 AT+CGPADDR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGPADDR:(已定义的列表) OK 若出现任何错误： 上海移远通信技术股份有限公司 24 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 ERROR 或 +CME ERROR: 300 毫秒 参数 和 整型。指定某个 PDP 上下文定义（请查看命令 AT+CGDCONT）。 范围：0~10。 字符串类型。在适用于 PDP 的地址空间识别 UE，地址可为静态 或动态。静态地址由命令 AT+CGDCONT 设定。动态地址在上 一次 PDP 上下文激活期间分配，使用 引用的上下文定义。 如果 和 的地址均不可用，则 省略；当分配 IPv4 及 IPv6 的地址时， 和 均被指定， 对应 IPv4 的地址， 对应 IPv6 的地址。 备注 1. 在双栈终端（=IPV4V6）， 对应 IPv6 的地址。对于单个 IPv6 堆栈终 端（=IPv6）或者因为向后兼容性，IPv6 地址也可包含在参数 中。 2. 使能 AUTOCONNECT 后，IP 地址获取之后才会列出 =0。 举例 AT+CGPADDR=0 +CGPADDR:0,101.43.5.1 OK AT+CGPADDR=? +CGPADDR:(0) OK 2.12. AT+COPS PLMN 选择 设置命令强制尝试使用安装在当前所选卡槽中的 USIM 卡来选择和注册 EPS 网络运营商。参数 用来设置找网动作，是由 UE 自动完成，还是通过该命令以特定的接入方式 ，强制选择运 营商 （由 指定）。如果选择的运营商不可用，则不会选择其他运营商。如果选择的接 入技术不可用，则会在其他接入技术中选择相同的运营商。选定运营商名称的格式同样适用于查询命令 AT+COPS?。=2 强制尝试注销网络。所选模式会影响后续所有网络注册（例如，当设置 =2 上海移远通信技术股份有限公司 25 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 后，只有在设置 =0 或 1 时 UE 才会注册网络）。尝试注册或注销时，此命令应该是可中止的。 查询命令返回当前模式、当前所选运营商以及当前接入技术。如果没有选择运营商，则不会返回 、 和 。 测试命令返回五个参数，表示网络中出现的运营商。指示当前运营商是否可用的整型参数 、运 营商的数字编码 、接入技术的数字编码 、注册模式 及运营商名称的格式 。以上参数可能不可用，不可用时为空字段。运营商清单应按此顺序排列：本地网络、USIM 中 选用的网络或 UICC（USIM）中的活动应用程序引用（顺序：HPLMN 选择器、用户控制的 PLMN 选择器、 运营商控制的 PLMN 选择器、USIM 中的 PLMN 选择器）以及其他网络。 选择接入技术的参数 仅应用于能够注册多种接入技术的终端。 的选择不会限制小区重 选的能力，即使已经尝试选择一种接入技术，UE 也可以在其他接入技术中重选小区。 AT+COPS PLMN 选择 设置命令 AT+COPS=[,[,[,]]] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 查询命令 AT+COPS? 响应 +COPS:[,,][,] OK 测试命令 AT+COPS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +COPS:[(支持的,列表[,])][,,(支持的范围),(支持的列表)] OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 630 秒 上海移远通信技术股份有限公司 26 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型 0 自动（省略 、 和 字段） 1 手动（包含 和 字段， 可选） 2 注销网络 =1 时，UE 重启后，将不会保留 PLMN 设置。=1 仅供研发使用；生产 环境使用 =0，此时 AUTOCONNECT 设置为 TRUE。 整型 2 为数字格式 字符串类型。 指示此参数格式是否为数字格式；数字格式是 NB-IoT 网络位 置区域标识号，由三位 BCD 数字 ITU-T 国家代码编码，加上两位或三位 BCD 数字网络 代码组成。=0 时， 参数不能出现 整型。运营商状态 0 未知 1 可用 2 当前 3 禁用 整型，接入技术设置。模块查询命令 AT+COPS?不会返回 。 7 E-UTRAN 9 E-UTRAN（NB-S1 模式） 备注 此命令的测试命令只能在 RRC 断开状态（模块处于 Idle 或 PSM 模式）下执行，否则将返回错误。 举例 AT+COPS=0 OK AT+COPS? +COPS:0,2,'46000' OK AT+COPS=? +COPS:(2,,,'46000'),,(0-2),(2) OK 上海移远通信技术股份有限公司 27 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.13. AT+CGATT PS 附着与去附着 该命令用于将 UE 附着于 PS 域或将 UE 从 PS 域去附着。命令执行后，UE 保持在 V.250 命令状态。 如果 UE 已经处于相同的 设置状态，则会忽略此命令，并返回 OK 响应。如果正在执行 AT+CGATT， 在附着或去附着注册步骤完成之前，再次执行此命令会返回错误。如果未达到请求状态，则会响应 ERROR 或 +CME ERROR: 。 当附着状态改为取消去附着状态时，任何活动的 PDP 上下文将自动停用。 查询命令返回当前 PS 域服务状态。 测试命令用于请求支持的 PS 域状态的信息。 AT+CGATT PS 附着与去附着 设置命令 AT+CGATT= 响应 OK 查询命令 AT+CGATT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGATT: OK 测试命令 AT+CGATT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGATT:(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 1 秒，由网络判定。 上海移远通信技术股份有限公司 28 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型，表示 PDP 上下文激活的状态。 0 去附着 1 附着 =1 时，自动设选择 AT+COPS=0。 备注 如果支持初始 PDP 上下文，启动时将自动定义 =0 的上下文。 举例 AT+CGATT? +CGATT:0 OK AT+CGATT=1 OK AT+CGATT=? +CGATT:(0,1) OK 2.14. AT+CGACT 激活或停用 PDP 上下文 该命令用于激活或停用指定的 PDP 上下文。该命令设置完成后，UE 保持在 V.250 命令状态。若任意 PDP 上下文已经进入请求状态，那么该上下文状态保持不变；如果不能实现任意上下文的请求状态，将返 回 ERROR 或 +CME ERROR 响应。执行该命令的激活形式时，如果 UE 没有附着 PS，UE 首先会附着 PS，然后尝试激活指定的上下文。如果附着失败，UE 则响应错误；或者，如果使能扩展错误响应，UE 则 响应相应的附着失败错误消息。对 EPS 而言，如果尝试断开与上一个 PDN 的连接，UE 则响应 ERROR， 或者如果使能扩展错误响应，则响应 +CME ERROR。 EPS 承载资源的激活请求由网络通过 EPS 专用承载激活或 EPS 承载修改请求来响应。UE 必须接受此 请求，PDP 上下文才可设置为建立状态。 查询命令返回所有定义的 PDP 上下文的当前激活状态。测试命令用于请求支持的 PDP 上下文激活状 态的信息。 上海移远通信技术股份有限公司 29 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 AT+CGACT 激活或停用 PDP 上下文 设置命令 AT+CGACT=, 响应 OK 查询命令 AT+CGACT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGACT:, [+CGACT:,] [...] OK 测试命令 AT+CGACT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGACT: (支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 1 秒，由网络判定。 参数 整型。表示 PDP 上下文的激活状态。 0 停用 1 激活 整型。此参数指定某个 PDP 上下文定义（请参考 AT+CGDCONT）。一次只能激活或 停用 1 个 。 上海移远通信技术股份有限公司 30 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 备注 1. 如果支持初始 PDP 上下文，启动时将自动定义 =0 的上下文。 2. PLMN 搜索、附着和去附着时，不可执行该命令。 3. 当 UE 与核心网络都支持无 PDN 连接时，该命令可以断开最后一路 PDN 连接。 举例 AT+CGACT=0,1 OK AT+CGACT? +CGACT:1,0 OK AT+CGACT=? +CGACT:(0,1) OK 2.15. AT+CIMI 请求国际移动用户识别码 该命令返回国际移动用户识别码（无双引号的字符串）。 该执行命令使 UE 返回 ，目的是允许 TE 识别附着到 UE 的 USIM 卡或 UICC 中的活动应用。 AT+CIMI 请求国际移动用户识别码 执行命令 AT+CIMI 响应 OK 测试命令 AT+CIMI=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 上海移远通信技术股份有限公司 31 /190 参数 BC35-G&BC28&BC95 R2.0 AT 命令手册 国际移动用户识别码（无双引号的字符串）。 备注 开机后几秒之内可能无法显示 IMSI。 举例 AT+CIMI 460001357924680 OK 2.16. AT+CGDCONT 定义 PDP 上下文 此命令的设置命令为 标识的 PDP 上下文和本地上下文指定 PDP 上下文参数。因为 PCO 可包 含需要加密的信息，所以该命令也允许 TE 指定是否请求 ESM 信息的安全保护传输。UE 可能有其他原因 使用 ESM 信息的安全保护传输，例如需要转换 APN。测试命令的响应给出了可以同时处于定义状态的 PDP 上下文数量范围。 对 EPS 而言，设置该命令后会建立 PDN 连接并建立相关的默认承载。 AT+CGDCONT= 是设置命令的一种特殊形式，会使 的值变成未定义。 如果支持初始 PDP 上下文，则在启动时自动定义 =0 的上下文，可以使用 AT+CGDCONT 修改 =0 的参数。 查询命令返回每个已定义上下文的当前设置。 测试命令返回支持的参数的范围。如果 UE 支持多种 PDP 类型，每个 的参数值范围会 在单独行返回。 AT+CGDCONT 定义 PDP 上下文 设置命令 AT+CGDCONT=[,[, [,[,[,[,[,[,[,[,[,< securePCO>]]]]]]]]]] 查询命令 AT+CGDCONT? 或者 +CME ERROR: 响应 +CGDCONT:[,[,[,[,< d_comp>[,[,[,[ ,[,[,[,]]]]]]]]]] OK 测试命令 AT+CGDCONT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGDCONT:(支持的范围),(支持的列表),,, (支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表),(支持的列表) [...] OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。指定某个 PDP 上下文。这是 TE-UE 接口的本地参数，可以用在其他 PDP 上下文 相关的命令中。测试命令返回参数值的范围（最小值为 1；如果支持初始 PDP 上下文， 最小值为 0）。 网络发起的 PDP 上下文的一些 值会超出 AT+CGDCONT=? 测试命令所列的 值的范围。支持的 值为 0-10。 使能 BIP 时，不可将 的值设置为 7。 字符串类型。指定分组数据协议类型。 IP 网络协议（IETF STD 5 [103]） IPV6 网络协议，IPv6 上海移远通信技术股份有限公司 33 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 IPV4V6 引入虚拟 处理双 IP 堆栈 UE 功能 NONIP 无 IP 字符串类型。表示逻辑名称，用于选择 GGSN 或外部 PDN。值为空或省略时，将请求 订阅值。 字符串的最大长度为 63 个字符。 整型。控制 PDP 数据压缩。 0 关闭 1 打开 （制造商首选压缩） 2 V.42bis 3 V.44 整型。控制 PDP 头压缩。 0 关闭 1 打开（制造商首选压缩） 2 RFC 1144 [105] （仅适用于 SNDCP） 3 RFC 2507 [107] 4 RFC 3095 [108] （仅只适用于 PDCP） 整型。为该 PDP 上下文请求的 NAS 信令优先级。 0 根据 UE 中配置的低优先级指示符的值激活此 PDP 上下文。 1 根据低优先级指示符设置为'NAS 信令低优先级 MS 未配置'，激活此 PDP 上下文。 UE 使用 3GPP TS 24.301 [83]和 3GPP TS 24.008 中提供的 NSLPI 信息。 整型。指定是否请求 PCO 的安全保护传输（适用于仅 EPS）。 0 不请求 PCO 的安全保护传输。 1 请求 PCO 的安全保护传输。 备注 1. 仅支持 'IP'、'NONIP'、'IPV6' 和 'IPV4V6'。 2. 此 命 令 仅 支 持 参 数 、 、 、 、 、 和 。 3. 的值仅支持 0。 的值仅支持 0 和 1。 举例 AT+CGDCONT=? +CGDCONT:(0-10),('IP','NONIP','IPV6','IPV4V6'),,,(0),(0,1),,,,,(0,1),(0,1) OK AT+CGDCONT=1,'IP','HUAWEI.COM' OK AT+CGDCONT? +CGDCONT:0,'IPV4V6',,,0,0,,,,,0,0 +CGDCONT:1,'IP','HUAWEI.COM',,0,0,,,,,0,0 OK 上海移远通信技术股份有限公司 34 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.17. AT+CFUN 设置 UE 功能 该命令选择 UE 的功能等级。'全部功能'等级对应高级别的功率。'最小功能'对应低级别的功率。 查询命令返回 的当前设置。 AT+ CFUN 设置 UE 功能 设置命令 AT+CFUN=[,] 响应 OK 查询命令 AT+CFUN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CFUN: OK 测试命令 AT+CFUN=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CFUN:(支持的列表),(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 85 秒 参数 整型。UE 功能等级。 0 最小功能 1 全部功能。使 UE 能够收发所有支持的无线接入技术 RF 电路。对于支持 AT+CSRA 的 UE，这相当于命令 AT+CSRA=?响应的 RATs。目前 AT+CSRA 设置被忽略。当此设置生效时，收发 RF 电路不必处于禁用状态。在 成 上海移远通信技术股份有限公司 35 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 功配置为 1 后，可以用 =0 或者其他方式关闭 UE。 整型。UE 重置。 0 在设置 功率级别之前不重置 UE。该参数缺省时为默认值。 1 在设置 功率级别之前重置 UE（暂不支持且被忽略）。 备注 系统不活动时将进入深度睡眠模式，但前提是网络已启用深度睡眠模式。 举例 AT+CFUN=? +CFUN:(0,1),(0,1) OK AT+CFUN=1 OK AT+CFUN? +CFUN:1 OK 2.18. AT+CMEE 上报 UE 错误 该设置命令可以禁用或使能 +CME ERROR: 结果码，用于表示 UE 功能相关的错误。启用后， UE 相关错误会返回 +CME ERROR: 最终结果码，而不只是 ERROR。当语法错误、无效参数或 UE 功能相关错误时，会正常返回 ERROR。 查询命令返回参数 的当前设置。 AT+CMEE 上报 UE 错误 设置命令 AT+CMEE= 响应 OK 查询命令 AT+CMEE? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMEE: 上海移远通信技术股份有限公司 36 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 测试命令 AT+CMEE=? 最大响应时间 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMEE:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型，表示错误模式 0 禁用 +CME ERROR: 结果码，使用 ERROR。 1 使能 +CME ERROR: 结果码，使用数值 错误码。 2.19. AT+CCLK 返回当前日期和时间 一旦 UE 连接到网络，将自动设置时钟。执行设置命令前请执行命令 AT+NITZ=0。 查询命令返回时钟的当前设置。 AT+CCLK 返回当前日期和时间 设置命令 AT+CCLK= 响应 OK 查询命令 AT+CCLK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCLK: 上海移远通信技术股份有限公司 37 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 测试命令 AT+CCLK=? 最大响应时间 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 字符串类型。格式为'yy/MM/dd,hh:mm:ss±zz'，各字符分别表示年（最后两位数字）、月、 日、时、分、秒及时区（表示当地时间与 GMT 的时差，以 15 分钟为单位，范围为-96~+96）。 例如，1994 年 5 月 6 日，22:10:00 GMT+2 小时相当于'94/05/06,22:10:00+08'。 备注 1. 如果 UE 不支持时区信息，那么命令 AT+CCLK? 将不会返回 的后三位字符'±zz'。 2. 核心网络发送 EMM INFORMATION 前不会返回任何值。 举例 AT+CCLK='18/11/09,05:36:42+32' OK AT+CCLK? +CCLK:18/11/09,05:36:42+32 OK AT+CCLK=? OK 2.20. AT+CPSMS 设置省电模式 该命令控制 UE 省电模式（PSM）参数的设置，可以用来控制 UE 是否应用 PSM。请参考 AT+CEREG 返回的 URC 查看激活时间值以及 E-UTRAN 分配给 UE 的扩展周期 TAU 值。 AT+CPSMS=2 是该命令的一种特殊形式，在这种形式下，将禁用 PSM，并删除已通过 AT+CPSMS 上海移远通信技术股份有限公司 38 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 查询命令返回当前参数值。 AT+ CPSMS 设置省电模式 设置命令 AT+CPSMS=[,[,[,[,]]]] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 查询命令 AT+CPSMS? 响应 +CPSMS:[,,,],[] OK 测试命令 AT+CPSMS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPSMS:(支持的列表),,,(支持的范围),(支持的范围) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 字符串类型。禁用或使能 UE 的 PSM。 0 禁用 PSM 1 启用 PSM 2 禁用 PSM 并删除 PSM 的所有参数，如果有默认参数，则重置为默认。 字符串类型。8 位格式的一个字节。表示请求的将在 E-UTRAN 分配给 UE 的扩展周期性 TAU 值（T3412），且被编码为 GPRS Timer 3 信息的一个 上海移远通信技术股份有限公司 39 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 字节（octet 3）（例如，'01000111'等于 70 小时）。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了定时器值的单位，定义如下： 位数 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增（备注） 1 1 1 该值表示定时器被停用 默认值为 10 小时。 字符串类型。8 位格式的一个字节。表示将分配给 UE 的请求激活时间值 （T3324），且被编码为 GPRS Timer 2 信息的一个字节（octet 3）（例 如，'00100100'等于 4 分钟）。 第 5 位到第 1 位表示二进制编码定时器值。 第 6 位到第 8 位定义了 GPRS 定时器值的有效时间值单位，定义如下： 位数 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 6 分钟的倍数递增 1 1 1 表示定时器被停用的值 默认值为 10 秒。 备注 1. 该定时器值的单位仅适用于 T3412 扩展值 IE。如果以完整性保护消息的形式接收，那么将以 320 小 时的倍数解读接收到的值，否则，将以 1 小时的倍数解读。 2. AT+CPSMS? 查询命令目前只能获取模式值 0 和 1。 3. 目前不支持 和 参数，输入任何 值都将被忽略，也没有任何值输出。 举例 AT+CPSMS=1,,,01000011,01000011 OK AT+CPSMS? +CPSMS:1,,,01000011,01000011 OK AT+CPSMS=? 上海移远通信技术股份有限公司 40 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 +CPSMS:(0,1,2),,,( 00000000-11111111), (00000000-11111111) OK 2.21. AT+CEDRXS 设置 eDRX 设置命令控制 UE 的 eDRX 参数的设置，用于控制是否要应用 eDRX，以及每种指定接入技术类型的 请求 eDRX 值。 当 =2，且当网络提供的 eDRX 参数改变时，该命令也可设置是否上报 URC +CEDRXP:[,[,[,]]]。 AT+CEDRXS=3 为该命令的一种特殊形式。此形式的命令将禁用 eDRX，并删除已通过 AT+CEDRXS 命令设置的所有参数值（若参数有默认值，则将其恢复为默认值）。 查询命令返回 的每个定义值的当前设置。 AT+CEDRXS 设置 eDRX 设置命令 AT+CEDRXS=,[,< Requested_eDRX_value>] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 查询命令 AT+CEDRXS? 响应 +CEDRXS:, OK 测试命令 AT+CEDRXS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXS:(支持的列表),(支持的列表), (支持的范围) OK 若出现任何错误： 上海移远通信技术股份有限公司 41 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。启用或禁用 eDRX。该参数适用于所有指定的接入技术类型，即 的最 新设置将对 的所有指定值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并启用 URC： +CEDRXP:[,[,[,]]] 3 禁用 eDRX 并删除 eDRX 的所有参数 整型。接入技术类型。 0 接入技术未使用 eDRX，该参数值仅在 URC 中使用 5 E-UTRAN（NB-S1 模式） 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度持续时间 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 上海移远通信技术股份有限公司 42 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗口时长 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 备注 在 B300SP5 或后续版本中，默认使能 UE 的 eDRX。 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS:5,'0101' OK AT+CEDRXS=? +CEDRXS:(0,1,2,3),(5),('0000'-'1111') OK AT+CEDRXS=0,5 OK 上海移远通信技术股份有限公司 43 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.22. AT+CEER 扩展错误报告 该执行命令让 UE 返回一行或多行由 UE 制造商确定的信息文本 ，这应该为 UE 的用户提供 一份错误原因的扩展报告，错误类型如下：  上一次呼叫释放失败  上一次 PDP 上下文激活失败  PDP 上下文去激活失败 通常，文本将由单行组成，包含网络给出文本格式原因信息。 AT+CEER 扩展错误报告 设置命令 AT+CEER 响应 +CEER: OK 测试命令 AT+CEER=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 扩展错误报告。信息文本（包括行终止符在内）的字符总数不超过 2041。文本不包含 0 或 OK 序列。 举例 AT+CEER +CEER:EMM_CAUSE_EPS_AND_NON_EPS_SERVICES_NOT_ALLOWED OK AT+CEER=? OK 上海移远通信技术股份有限公司 44 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.23. AT+CEDRXRDP 读取动态 eDRX 参数 当 eDRX 用于 UE 当前注册的小区时，该执行命令返回 、、 和 。 如果 UE 当前注册的小区未使用 eDRX，则返回 =0。 AT+CEDRXRDP 读取动态 eDRX 参数 执行命令 AT+CEDRXRDP 响应 +CEDRXRDP:[,[,[,]]] OK 测试命令 AT+CEDRXRDP=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 整型。接入技术类型。AT+CEDRXS? 用于指定接入技术类型与请求的 eDRX 值之 间的关系。 0 接入技术未使用 eDRX。该参数值仅在 URC 中使用。 5 E-UTRAN（NB-S1 模式） 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 上海移远通信技术股份有限公司 45 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗口长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.3 6 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 举例 AT+CEDRXRDP +CEDRXRDP:5,'0010','1110','0101' OK AT+CEDRXRDP=? OK 上海移远通信技术股份有限公司 46 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.24. AT+CTZR 设置时区上报 设置命令控制时区变化事件上报。启用上报后，一旦时区发生改变，UE 将返回 URC +CTZV:、 +CTZE:,,[]或+CTZEU:,,[]。如果网络提供时区，则 UE 会在网络注册 时提供时区。如果因 UE 错误导致设置失败，则返回 +CME ERROR:。 查询命令返回 UE 当前已设置的报告设置。 AT+CTZR 设置时区上报 设置命令 AT+CTZR= 响应 +CTZR: OK 查询命令 AT+CTZR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CTZR: OK 测试命令 AT+CTZR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CZTR:(支持的 列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 47 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型。上报状态 0 禁用时区变化事件 URC 上报 1 启用时区变化通过 URC +CTZV:上报 2 启用扩展时区和本地时间通过 URC +CTZE:,,[] 上报 3 启用扩展时区和世界时通过 URC +CTZEU:,,[] 上报 字符串类型。表示本地时区（当地时间与 GMT 的时差以 15 分钟为单位）加上夏令时的 总和，格式为'±zz'。长度固定，即两位整数，范围为-48~+56。为保持两位，范围在 -9~+9 之间的数字均以 0 开头，例如'-09'、'+00'和'+09'。 整型。指示 是否包含夏令时调整。 0 不包含夏令时调整 1 包括增加 1 小时（相当于 中的 4 个 15 分钟）的夏令时调整 2 包括增加 2 小时（相当于 中的 8 个 15 分钟）的夏令时调整 字符串类型。表示当地时间。格式为'YYYY/MM/DD,hh:mm:ss'，以整数形式分别表示年 （YYYY）、月（MM）、日（DD）、时（hh）、分（mm）和秒（ss）。如果核心网提供世 界时间，UE 可以从网络传输时区信息时提供的信息中得出本地时间，并以 URC 上报扩 展时区和本地时间。 字符串类型。表示世界时间。格式为'YYYY/MM/DD,hh:mm:ss'，以整数形式分别表示年 （YYYY）、月（MM）、日（DD）、时（hh）、分（mm）和秒（ss）。如果核心网提供世 界时间，在网络传输时区信息时可以得到世界时间，并以 URC 上报扩展时区和世界时间。 举例 AT+CTZR=0 OK AT+CTZR? +CTZR:0 OK AT+CTZR=? +CTZR:(0,1,2,3) OK 2.25. AT+CIPCA 初始 PDP 上下文激活 设置命令用来控制 UE 在是否有 PDN 连接的情况下连接到 E-UTRAN。当 =3 时适用于 E-UTRAN RATs。改变参数 的值不会引起 PDP 上下文去激活。 当参数 =1 时，表示在没有 PDN 连接的情况下进行 EPS 附着。 上海移远通信技术股份有限公司 48 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 查询命令会返回命令的当前设置情况。 AT+CIPCA 初始 PDP 上下文激活 设置命令 AT+CIPCA=[,] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 查询命令 AT+CIPCA? 响应 +CIPCA:[,] OK 测试命令 AT+CIPCA=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CIPCA:(支持的列表),(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。附着时激活 PDP 上下文。 3 不改变当前设置 整型。表示 EPS 附着是否有 PDN 连接。缺省值为 0。 0 表示 EPS 附着时有 PDN 连接 1 表示 EPS 附着时没有 PDN 连接 备注 对于该命令，术语漫游表示注册到了一个不同于 HPLMN 和 EHPLMN 的 VPLMN 网络。 上海移远通信技术股份有限公司 49 /190 举例 AT+CIPCA=3 OK AT+CIPCA=? +CIPCA:(3),(0,1) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.26. AT+CGAPNRC APN 速率控制 执行命令返回与对应上下文标识符 关联的 APN 速率控制参数（参考 3GPP TS 24.008 [8]）。 如果 参数省略，则返回所有活跃 PDP 上下文的 APN 速率控制参数。 AT+CGAPNRC APN 速率控制 执行/设置命令 AT+CGAPNRC[=] 响应 [+CGAPNRC:[,[,[,]]]] [+CGAPNRC:[,[,[,]]]] [...]]]] OK 测试命令 AT+CGAPNRC=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAPNRC:(与激活上下文关联的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 50 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型。指定某个 PDP 上下文定义（参考 AT+CGDCONT 命令）。 整型。表示当达到最大上行速率时是否允许发送附加异常报告。 0 不允许以最大速率发送（Additional exception reports） 1 允许以最大速率发送（Additional exception reports） 整型。用来指定最大上行速率的时间单位。 0 不受限 1 分钟 2 小时 3 天数 4 周 整型。指定每个上行时间单位限制 UE 发送的最大消息数。时间 单位以上行时间单位表示，如果上行时间单位设为'不受限'（即 0），那么 UE 可以发送的最大上行数据数量将不受限制。 举例 AT+CGAPNRC +CGAPNRC:0,0,0 OK AT+CGAPNRC=? +CGAPNRC:(0) OK 2.27. AT+CSODCP 通过控制面发送始端数据 TE 使用该设置命令通过 UE 将数据通过控制面传输到网络。上下文标识符 用于将数据连接到 特定的上下文。 该命令可以有选择性地指示 UE 的应用程序，是期望通过此上行数据完成数据的交换，还是通过接收到 的下一条下行数据完成数据交换。 该命令也可有选择性地指示将要传输的数据是否为异常数据，可以引发 ESM DATA TRANSPORT 消 息的传输，如 3GPP TS 24.301 [83] 中定义。 AT+CSODCP 通过控制面发送始端数据 设置命令 AT+CSODCP=,, [,[,[,]]] 测试命令 AT+CSODCP=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSODCP:(支持的范围),(支持的列 表),(支持的列表),(支持的列表), (支持的范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。一个数字参数，指定某个 PDP 上下文或 EPS 承载上下文定义。 是 TE-UE 接口的本地参数，用来标识已通过 AT 命令设置的 PDP 或 EPS 承载 上下文（参考 AT+CGDCONT 命令）。 整型。表示 参数字节数。当没有数据传输时，该值应设置为零。 八位字符串。包含用户数据容器内容。当没有数据要传输时，参数 应为空字符串（''）。该参数不应按照 3GPP TS 27.007 [9] 中的 AT+CSCS 进行常规字符转换。用户数据容器的编码格式和参数 的最大长度是 特定的。使用 non-IP 时，最大数据长度为 1358 字节，否则为 0。 整型。表示释放辅助指示的值，参考 3GPP TS 24.301 [83] 子条款 9.9.4.25。 0 无指示 1 ESM DATA TRANSPORT 消息传输后不期望有进一步上下行数据，核心 网可立即释放 2 接收最后的 ESM DATA TRANSPORT 消息后完成数据交换，核心网在下 发后立即释放 整型。表示传输的用户数据是正常数据还是异常数据。 0 正常数据 1 异常数据 数据序列。范围是 1-255。如果省略，则不会上报数据发送状态。如果不省略， 当数据报由 RF 发送或丢弃时，将会上报以下结果： +CSODCPR:,, 表示数据的状态。 0 错误 1 已发送 上海移远通信技术股份有限公司 52 /190 备注 每次只缓冲一条消息。 举例 AT+CSODCP=? +CSODCP:(0-10),(0),(0,1,2),(0,1),(1-255) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.28. AT+CRTDCP 通过控制面上报终端数据 接收到来自 CDP 服务器的消息时，设置命令用来启用和禁用从网络到 UE 的下行数据的上报。如果启 用数据上报，则当从网络接收到下行数据时，URC +CRTDCP: ,, 将会被 返回。 查询命令会返回当前的设置情况。 AT+CRTDCP 通过控制面上报终端数据 设置命令 AT+CRTDCP= 响应 OK 查询命令 AT+CRTDCP? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CRTDCP: OK 测试命令 AT+CRTDCP=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CRTDCP:(支持的范围),(支持的范围),(由 参数指定的用户数据的最大八位字节数) OK 上海移远通信技术股份有限公司 53 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。控制移动终端的控制面数据事件的上报。 0 禁用控制面数据的上报。 1 启用控制面数据的上报。 URC：+CRTDCP: ,,。 整型。一个数字参数，指定某个 PDP 上下文或 EPS 承载上下文定义。 是 TE-UE 接口的本地参数，用来标识已通过 AT 命令设置的 PDP 或 EPS 承载上下文 （参考 AT+CGDCONT 命令）。 整型。表示 参数字节数。当没有数据传输时，该值应设置为零。 八位字符串。包含用户数据容器内容。当没有数据要传输时，参数 应为 空字符串（''）。该参数不应按照 3GPP TS 27.007 [9] 中的 AT+CSCS 进行常规 字符转换。用户数据容器的编码格式和参数 的最大长度是特定的。使用 non-IP 时，最大数据长度为 1358 字节，否则为 0。 举例 AT+CRTDCP=1 OK AT+CRTDCP? +CRTDCP:1 OK AT+CRTDCP=? +CRTDCP:(0-1),(0-10),(0) OK +CRTDCP:0,2,'ab' //URC 上海移远通信技术股份有限公司 54 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.29. AT+CGCONTRDP 查询 PDP 上下文的动态参数 执行命令返回带有上下文标识符 的活跃非辅助 PDP 上下文相关信息 和 。  如果 UE 指示 2 个以上 P-CSCF 服务器的 IP 地址或 2 个以上 DNS 服务器的 IP 地址，则每个 将返回多行信息。  如果 UE 具有双栈功能，则每个 至少返回两行信息：一行带有 IPv4 参数，紧接在后的一 行带有 IPv6 参数。如果具有双栈功能的 UE 指示两个以上 P-CSCF 或 DNS 服务器的 IP 地址，则 将返回多对这样的信息行。  如果省略参数 ，将会返回所有活跃的非辅助 PDP 上下文的相关信息。 测试命令会响应与活跃的非辅助上下文相关的 列表。 AT+CGCONTRDP 查询 PDP 上下文的动态参数 执行/设置命令 AT+CGCONTRDP[=] 响应 +CGCONTRDP: [,[,[,[,[,[,]]]]]] OK 测试命令 AT+CGCONTRDP=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGCONTRDP:(与动态场景相关的参数列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。用来指定某个非辅助 PDP 上下文。此参数是 TE-MT 接口的本地参数，用于 与 PDP 上下文相关的其他命令（参考 AT+CGDCONT 命令）。 整型。承载的标识，例如 EPS 中的 EPS 承载。 上海移远通信技术股份有限公司 55 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 字符串类型。用于选择 GGSN 或外部分组数据网络的逻辑名称。 字符串类型。表示 MT 的 IP 地址和子网掩码。 该字符串为点分隔数字（0-255）参数的形式，如下所示： IPv4 的形式为'a1.a2.a3.a4.m1.m2.m3.m4'或 IPv6 的形式为'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a 15.a16.m1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m 15.m16'。 字符串类型。表示 MT 的网关地址。该字符串为点分隔数字（0-255）参数的形式。 字符串类型。表示主 DNS 服务器的 IP 地址。 字符串类型。表示备用 DNS 服务器的 IP 地址。 备注 1. 只有当参数 （请参考 AT+CGDCONT 命令）为 IP 或 IPV6 时，才能显示参数 和 。 2. 可以通过 AT+NCPCDPR 命令配置要查询的 PDP 上下文动态参数。 举例 AT+CGCONTRDP +CGCONTRDP:0,,'cmcc.MNC004.MCC460.GPRS',,,211.136.20.203,211.136.17.107 OK AT+CGCONTRDP=? +CGCONTRDP:(0) OK 2.30. AT+CGAUTH 定义 PDP 上下文鉴权参数 该设置命令允许 TE 为 PDP 上下文指定鉴权参数，该 PDP 上下文由 PDP 上下文激活和修改过程中使 用的（本地）上下文识别参数标识。由于参数 与 AT+CGDCONT 命令中使用的参数相同，因 此 AT+CGAUTH 命令实际上是 AT+CGDCONT 命令的扩展。 查询命令会返回每个已定义上下文的当前设置。 AT+CGAUTH 定义 PDP 上下文鉴权参数 设置命令 AT+CGAUTH=[,[,[,]]] 响应 OK 若出现任何错误： 上海移远通信技术股份有限公司 56 /190 查询命令 AT+CGAUTH? 测试命令 AT+CGAUTH=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 ERROR 或者 +CME ERROR: 响应 [+CGAUTH:,,,] [+CGAUTH:,,,] [...] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGAUTH:(支持的范围),(支持的列表),(支 持的长度范围),(支持的长度范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。用来指定某个 PDP 上下文（见 AT+CGDCONT 命令）。 整型。表示 PDP 上下文使用的鉴权协议。 0 无，用于指示此 PDP 上下文不使用任何鉴权协议，如果之前已指定，则删除用户名 和密码 1 PAP 2 CHAP 字符串类型。表示访问 IP 网络的用户名。参数 为 1 或 2 时，需要参数 。参数 的字符串最大长度为 60 个字节。 字符串类型。表示访问 IP 网络的密码。字符串最大长度为 60 个字节。 举例 AT+CGAUTH=1,2,'1234','1234' 上海移远通信技术股份有限公司 57 /190 OK AT+CGAUTH? +CGAUTH:0,1,'1234','1234' OK AT+CGAUTH=? +CGAUTH:(0-10),(0,1,2),(0-60),(0-60) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.31. AT+CNMPSD 指示无更多 PS 数据 执行命令指示 UE 中的应用程序不期望进行数据交换。该命令可用于普通和 Modem 兼容模式。 AT+CNMPSD 指示无更多 PS 数据 执行命令 AT+CNMPSD 响应 OK 测试命令 AT+CNMPSD=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 举例 AT+CNMPSD OK AT+CNMPSD=? OK 2.32. AT+CPIN 输入 PIN 码 此设置命令在 UE 可以操作之前，向 UE 发送必要的密码（如 USIM PIN 码和 USIM PUK 码等）。如 果需要输入两次 PIN 码，TA 将自动重复 PIN 码。如果没有待处理的 PIN 请求，此命令不会对 UE 实施任 何操作并且会响应错误 +CME ERROR: 。 上海移远通信技术股份有限公司 58 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 如果需要的 PIN 码是 SIM PUK 或 SIM PUK2，则需要第二个 PIN 参数 。第二个 PIN 用于 替换 SIM 中的旧 PIN。 查询命令会返回字母数字字符串，表示是否需要某些密码。 AT+CPIN 输入 PIN 码 设置命令 AT+CPIN=[,] 响应 OK 查询命令 AT+CPIN? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CPIN: OK 测试命令 AT+CPIN=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 字符串类型。表示密码。 字符串类型。表示请求的代码是 PUK 时所需的新密码。 READY SIM PIN SIM PUK SIM PUK BLOCKED 表示 UE 没有等待任何密码 表示 UE 正在等待 USIM PIN 码 表示 UE 正在等待 SIM PUK 码 如果在输入错误的 PUK 10 次后 sim 卡被锁定，则在开 机时主动上报 备注 1. 只有当 AT+CFUN=1 时，才能执行 AT+CPIN 的设置命令和查询命令。 2. USIM PIN 和 USIM PUK 指的是在 UICC 上所选程序的 PIN 码。例如，在 UTRAN 上下文中，当前 所选择的 UICC 上的应用程序应该是 USIM，所以 USIM PIN 代表的是所选 USIM 的 PIN 码。 如需 查看更多有关 UICC 上应用程序选择的详细信息，请参考 3GPP TS 31.101 [65]。 上海移远通信技术股份有限公司 59 /190 举例 AT+CPIN=1234 OK AT+CPIN? +CPIN: READY OK AT+CPIN=? OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.33. AT+CPINR 查询剩余 PIN 的重试次数 设置命令和执行命令会使 UE 返回其密码的剩余 PIN 重试次数。 AT+CPINR 查询剩余 PIN 重试次数 设置命令 AT+CPINR= 响应 [+CPINR: ,[,]] OK 执行命令 AT+CPINR 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+CPINR: ,[,]] [+CPINR: ,[,]] OK 测试命令 AT+CPINR=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 上海移远通信技术股份有限公司 60 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型。每个 PIN 的剩余重试次数。 整型。每个 PIN 的默认/初始重试次数。 PIN 的类型，除了 READY 之外，所有在 AT+CPIN 命令 参数列出的值。 备注 只有当 AT+CFUN=1 时，才能执行 AT+CPINR 的设置命令和执行命令。 举例 AT+CPINR='SIM PUK' +CPINR: SIM PUK,10,10 OK AT+CPINR +CPINR: SIM PIN,3,3 +CPINR: SIM PUK,10,10 OK 2.34. AT+CCHO 打开逻辑信道 执行命令 AT+CCHO=，MT 端会返回 ，TE 端通过此参数识别当前选定 UICC 分配的信道，这些操作都依附于 ME 端。当前选定的 UICC 会打开一个新的逻辑信道，选择由命令中参数 标识的应用，并返回一个会话 ID。ME 应将 TE 和 UICC 之间的通信限制在该逻辑信道上。 在执行命令 AT+CRLA 或 AT+CGLA 时，也将使用此 。 AT+CCHO 打开逻辑信道 设置命令 AT+CCHO= 响应 OK 测试命令 AT+CCHO=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 61 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 字符串类型。十六进制格式。UICC 中所有可选应用都用 DF Name 编码。 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM 和 ISIM） 上一个特定应用。 备注 APDU 命令中 CLASS 字节包含逻辑信道号，故发送到 UICC 的所有 APDU 命令都会包含逻辑信道号。因 此需由 MT 端负责管理 ADPU CLASS 字节中的逻辑信道部分，并确保选择的逻辑信道和执行命令返回的 相关联。 举例 AT+CCHO=? OK 2.35. AT+CCHC 关闭逻辑信道 该命令用来关闭 ME 与当前 UICC 之间的通信会话，ME 需关闭之前打开的逻辑信道，关闭后 TE 端无 法再次通过此逻辑信道发送命令。接收该命令后，UICC 会关闭逻辑信道。 AT+CCHC 关闭逻辑信道 设置命令 AT+CCHC= 响应 OK 测试命令 AT+CCHC=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 62 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM、ISIM） 上一个特定应用。 举例 AT+CCHC=1 OK AT+CCHC=? OK 2.36. AT+CGLA 通用 UICC 逻辑信道访问 执行命令发送 到 MT 端，然后由 MT 端发送 到所选择的 UICC。同样， UICC 会通过 MT 端返回 到 TA。 该命令允许通过 TE 上的远程应用程序直接控制当前选择的 UICC。然后，TE 应在 GSM/UMTS 指定的 框架内处理 UICC 信息。 虽然通用 UICC 逻辑信道访问命令 AT+CGLA 允许 TE 控制 UICC-MT 接口，但是逻辑上不需要从 TA/MT 外部访问 UICC-MT 接口的一些功能。此外，出于安全原因，不应在 TA/MT 之外处理 GSM 网络鉴权。因 此，无论 AT+CGLA 是锁定的还是解锁的，都不能在 TE 中使用 AT+CGLA 在 GSM 上下文中运行 GSM 算 法命令或鉴权命令。这不应禁止 TE 在其他安全上下文中（例如 EAP 安全上下文中）发送身份鉴权命令。 例如，当参数 P2 为 0（GSM 安全上下文）时，TA/MT 应禁止将鉴权命令发送到 USIM 应用程序。USIM 鉴权命令详细信息，请参考 3GPP TS 31.102 [59]。 AT+CGLA 通用 UICC 逻辑信道访问 设置命令 AT+CGLA=,, 响应 +CGLA: , OK 上海移远通信技术股份有限公司 63 /190 测试命令 AT+CGLA=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。会话 ID。用于指定一个使用逻辑通道机制的智能卡（例如：(U)SIM、WIM、ISIM） 上一个特定应用。 整型。在 或 中发送给 TE 的字符长度（是命令或响应实 际长度的两倍） MT 端以 3GPP TS 31.101[65] 所述的格式发送至 UICC 的命令（十六进制字符格式， 参考 AT+CSCS）。 UICC 发送到 MT 端针对 的响应，格式与 3GPP TS 31.101[65] 中描述 一致（十六进制字符格式，参考 AT+CSCS）。 备注 与访问受限 UICC 命令 AT+CRLA 相比，AT+CGLA 的定义允许 TE 对 UICC-MT 接口进行更多控制。接 口 的 锁 定 和 解 锁 可 以 通 过 特 殊 的 值 完 成 ， 也 可 以 由 TA/MT 自 动 完 成 （ 通 过 解 析 参数）。如果 TE 应用程序未在某个超时值中使用解锁命令（或者不发送使自动解锁的 ），则 MT 可以释放锁定。 举例 AT+CGLA=? OK 上海移远通信技术股份有限公司 64 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.37. AT+CRSM 受限 SIM 卡访问 通过使用该命令访问 SIM 数据库，相对于使用通用 SIM 访问命令 AT+CSIM 而言，该命令更简便也更 受限制。 执行命令向 MT 发送 SIM 及其所需参数。 如果 SIM 卡安装在当前选定的卡槽中，则 MT 在内部处理所有 SIM-MT 接口锁定和文件选择例程。作为对命令的响应，MT 发送实际 SIM 信息参数和 响应数据。当命令无法传递给 SIM 时，可能会返回 MT 错误结果代码 +CME ERROR，若 SIM 中执行命令 失败会在参数 和 中上报。 对于 SIM 发出的命令请求和 MT 内部 GSM/UMTS 应用程序发出的命令请求之间的协调取决于实现。 但是 TE 应注意 GSM/UMTS 应用程序命令对 TE 命令的优先级。 AT+CRSM 受限 SIM 卡访问 设置命令 AT+CRSM=[,[,,,[,[,]]]] 响应 +CRSM: ,[,] OK 测试命令 AT+CRSM=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应： OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 MT 传递给 SIM 的命令。参考 3GPP TS 51.011 [28] 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS 203 RETRIEVE DATA 上海移远通信技术股份有限公司 65 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 、、 、 219 SET DATA 所有其他值保留，命令 203 和 219 暂不支持。 整型。SIM 上基本数据文件的标识符。除 =242（STATUS）之外， 对于每个命令来说该参数为必要参数。 整型。MT 传递给 SIM 的参数。除 GET RESPONSE 和 STATUS 之外，对于每 个命令来说这些参数为必要参数。请参考 3GPP TS 51.011 [28]。 十六进制格式。应写入 SIM 的信息。参考 AT+CSCS。 字符串类型。十六进制格式。包含 SIM/UICC 基础文件路径（例如 SIM 和 UICC 情况下的'7F205F70'），仅用于'从 MF 选取路径'模式。 整型。来自 SIM 关于实际命令执行的信息。在命令执行成功或失败时，这些参 数都会传递给 TE。 字符串类型。十六进制格式。成功完成上一次发出命令的响应（请参考 +CSCS）。 STATUS 和 GET RESPONSE 返回数据。该数据提供有关当前基本数据字段的 信息。该信息包括文件类型及其大小（参考 3GPP TS 51.011 [28]）。在 READ BINARY，READ RECORD 或 RETRIEVE DATA 命令之后，将返回所请求的数 据。成功执行 UPDATE BINARY，UPDATE RECORD 或 SET DATA 命令后， 不会返回 。 备注 1. 在执行实际命令之前，MT 在内部执行选择目标文件所需的所有命令。 2. 有效文件标识符的范围取决于实际 SIM，可查看 3GPP TS 51.011 [28] 中定义。可选文件可能不显 示。 3. 由于有效的基本文件标识符在所有有效的专用文件标识符上可能不是唯一的，所以 表示在 模糊文件标识符的情况下的目标 UICC/SIM 目录路径。对于该规范的早期版本，或者省略了 ，则根据具体实现情况选择。 4. 目前不支持 203 和 219。 举例 AT+CRSM=242 +CRSM: 144,0 OK AT+CRSM=? OK 上海移远通信技术股份有限公司 66 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2.38. AT+CSIM 通用 SIM 卡访问 执行命令向 MT 发送 ，然后 MT 发送至 SIM 卡。同样，MT 发送 SIM 卡 至 TA。 该命令允许通过 TE 上的远程应用直接控制安装在当前所选卡槽中的 SIM 卡。然后，TE 应在 GSM/UMTS 指定的框架内处理 UICC 信息。 AT+CSIM 通用 SIM 卡访问 设置命令 AT+CSIM=, 响应 +CSIM: , OK 测试命令 AT+CSIM=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应： OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。在 或 中发送给 TE 的字符长度（命令或响应的 实际长度的两倍）。 由 MT 以 3GPP TS 51.011 [28]中描述的格式传送给 SIM 卡的命令（十六进制字符 格式；参考 +CSCS）。 响应 SIM 卡以 3GPP TS 51.011[28]（十六进制字符格式；参考 +CSCS）描述的 格式传递给 MT 的命令。 备注 与受限 SIM 卡访问命令 AT+CRSM 相比，AT+CSIM 的定义允许 TE 对 SIM-MT 接口进行更多控制。接口 的锁定和解锁可以通过特殊的 值完成，也可以由 TA/MT 自动完成（通过解析 参数）。若 TE 应用程序未在某个超时值中使用解锁命令（或者不发送使自动解锁的 ）， MT 可能会释放锁定。 上海移远通信技术股份有限公司 67 /190 举例 AT+CSIM=10,'00B2010426' +CSIM: 4,6981 OK AT+CSIM=? OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.39. AT+CGDATA 输入数据状态 执行命令使 MT 操作在 TE 和网络之间建立通信所需的任何动作，可使用一个或多个 Packet Domain PDP 类型。 包括执行 PS 附着和一个或多个 PDP 上下文激活。如果 MT 不接受 参数值，则 MT 应返回 ERROR 或 +CME ERROR，否则，MT 发出中间结果代码 CONNECT 并进入 V.250 在线数据状态。 MT 命令行中的 AT+CGDATA 命令后面的命令不应由 MT 处理。输入在线数据状态后的详细行为取决 于 PDP 类型。它在 3GPP TS 27.060[34]中有简要描述，在 3GPP TS 29.061[39]和相关 PDPs 的规范中 有更详细的描述。如果尚未使用 AT+CGATT 和 AT+CGACT 命令执行 PS 附着和 PDP 上下文激活过程， 则可以在 PDP 启动之前或期间进行 PS 附着和 PDP 上下文激活过程。如果在 PDP 启动期间发生上下文激 活，则可以指定一个或多个 以便提供上下文激活请求所需的信息。 在每个 PDP 启动过程中，MT 可以访问以下部分或全部信息：  MT 可以具有先验信息，例如，它可以仅实现一种 PDP 类型。  该命令可能提供了 参数值。  TE 可以在 PDP 启动过程期间向 MT 提供 PDP 类型和/或 PDP 地址。 如果任何此类信息发生冲突，命令将失败。上述信息中存在的任何 PDP 类型和/或 PDP 地址应与命令 中指定的任何上下文定义中的 PDP 类型和/或 PDP 地址进行比较，其出现的顺序为 。要匹配的上下 文定义：  PDP 类型必须完全匹配。  如果 PDP 地址相同或者未指定其中一个或两个地址，则认为它们匹配。例如，指定 PDP 类型为 IP 且没有 PDP 地址的 PPP NCP 请求将使 MT 在 PDP 类型为 IP 和任何 PDP 地址的情况下搜索 指定的上下文定义。 应使用 PDP 类型的匹配值和静态 PDP 地址（如果可用）以及 PDP 上下文定义中的其他信息激活上下 文。如果静态 PDP 地址不可用，则请求动态地址。 如果没有给出 或者如果没有匹配的上下文定义，则 MT 将尝试使用 MT 可用的任何信息来激活 上下文。其他上下文参数应设置为其默认值。 如果激活成功，则可以继续数据传输。数据传输完成后，第 2 层协议终止过程成功完成，重新进入 V.250 命令状态，MT 返回最终结果代码 OK。 上海移远通信技术股份有限公司 68 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 如果错误终止或无法启动，则重新进入 V.250 命令状态，MT 返回最终结果代码 NO CARRIER，或者 如果启用，则返回 +CME ERROR。可能会上报附着、激活和其他错误。 测试命令用于请求有关支持的第 2 层协议的信息。该命令可用于普通和调制解调器兼容模式。 AT+CGDATA 输入数据状态 设置命令 AT+CGDATA[=[,[, [,...]]]] 测试命令 AT+CGDATA=? 响应 CONNECT 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGDATA: (支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 字符串类型。表示 TE 和 MT 之间使用的第 2 层协议。 NULL 无，对于 PDP 型 OSP：IHOSS（已废弃） PPP 用于 PDP 的点对点协议，例如 IP PAD X.25 字符（三重 X PAD）模式的字符流（已废弃） X25 X.25 L2（LAPB）用于 X.25 数据包模式（已废弃） M-xxxx 制造商特定协议（xxxx 是字母数字字符串） 如果省略该值，则不指定第 2 层协议。其他值保留，将返回 ERROR。 字符串类型。十六进制格式。最大发送数据长度为 512 字节。 备注 1. 如果支持初始 PDP 上下文，则在启动时自动定义 =0 的上下文。 2. 仅支持 'PPP'。 3. 波特率需要大于或等于 57600bps。 4. 一次只能指定一个 。 上海移远通信技术股份有限公司 69 /190 举例 AT+CGDATA=? +CGDATA: () OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.40. AT+CCIOTOPT CIoT 优化配置 设置命令控制 UE 在 ATTACH REQUEST 和 TRACKING AREA UPDATE REQUEST 消息中指示支持 和优先选择的 CIOT EPS 优化配置。该命令还可用来上报网络支持的 CIoT EPS 优化配置。支持 CIoT 功能 的 UE 可以支持控制面（control plane）或用户面（user plane）的 CIoT EPS 优化配置，或两者都可支持 （请参考 3GPP TS 24.301 [83], subclause 9.9.3.34）。基于应用特性，UE 可能优先选择注册用于控制面 的 CIoT EPS 优化配置或用于用户面的 CIoT EPS 优化配置（请参考 3GPP TS 24.301, sub-clause 9.9.3.0B）。 此外，网络可支持控制面 CIoT EPS 优化配置或用户面 CIoT EPS 优化配置或两者都可支持（参考 3GPP TS 24.301 [83], subclause 9.9.3.12A）。 设置命令还用于设置开启或关闭 URC +CCIOTOPTI: ，该 URC 用于表示 网络所支持的 CIoT EPS 优化配置。 AT+CCIOTOPT CIoT 优化配置 设置命令 AT+CCIOTOPT=[,[[,]]] 查询命令 AT+CCIOTOPT? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCIOTOPT:,, OK 测试命令 AT+CCIOTOPT=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CCIOTOPT: (支持的列表),(支持的列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。启用或禁用 URC +CCIOTOPTI 的上报。 0 禁用 URC 1 启用 URC 3 禁用上报并将 CIoT EPS 优化配置的参数重置为默认值 整型。表示 UE 对 CIoT EPS 优化配置的支持情况。 0 不支持 1 支持控制面 CIoT EPS 优化 2 支持用户面 CIoT EPS 优化 3 支持控制面和用户面 CIoT EPS 优化 整型。表示 UE 对 CIoT EPS 优化的偏好。 0 没有偏好 1 偏好控制面 CIoT EPS 优化 2 偏好用户面 CIoT EPS 优化 整型。表示网络支持的 CIoT EPS 优化。 0 不支持 1 支持控制面 CIoT EPS 优化 2 支持用户面 CIoT EPS 优化 3 支持用户面 CIoT EPS 优化 备注 1. 仅支持 1 和 3。 2. 仅支持 1 和 2。 3. 仅当 为 3 时，才能将 设置为 2。 举例 AT+CCIOTOPT=1,3,2 OK 上海移远通信技术股份有限公司 71 /190 AT+CCIOTOPT? +CCIOTOPT:1,3,2 OK AT+CCIOTOPT=? +CCIOTOPT:(0,1,3),(1,3),(1,2) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.41. AT+CGCMOD 修改 PDP 上下文 设置命令用于根据 QoS 配置文件和 TFTs 修改指定的 PDP 上下文。命令完成后，MT 返回到 V.250 在 线数据状态。如果无法实现对任何指定上下文的请求修改，则返回 ERROR 或 +CME ERROR。AT+CMEE 命令可启用扩展错误响应。 对于 EPS，EPS 承载资源的修改请求将由网络通过 EPS 承载修改请求来响应。在有效地更改 PDP 上 下文之前，MT 必须接受该请求。如果未指定 ，则命令的激活形式将修改所有活动上下文。测试命令 返回与活动上下文关联的 列表。 AT+CGCMOD 修改 PDP 上下文 设置命令 AT+CGCMOD[=[,[,...]]] 响应 OK 测试命令 AT+CGCMOD=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGCMOD: (已激活上下文列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 72 /190 参数 BC35-G&BC28&BC95 R2.0 AT 命令手册 整型。指定某个 PDP 上下文定义（请参考+CGDCONT 命令）。 备注 1. 一次只能修改一个 。 2. 处理此命令时，会阻止其他命令。 举例 AT+CGCMOD=? +CGCOMD: (0) OK 2.42. AT+CGEQOS 定义 EPS 服务器质量 设 置 命 令 允 许 TE 为 对 应 的 PDP 上 下 文 或 业 务 流 指 定 EPS 服 务 质 量 参 数 [,,< UL_GBR>[,,]]（请参考 3GPP TS 24.301 [83] 和 3GPP TS 23.203 [85]）。在 UMTS/GPRS 中，MT 将映射功能应用于 UTMS/GPRS 服务质量。 AT+CGEQOS= 是设置命令的一种特殊形式，将使上下文编号 的值变为未定义。查询命 令返回每个定义的 QoS 的当前设置。设置命令将支持的参数范围作为复合值返回。 AT+CGEQOS 定义 EPS 服务器质量 设置命令 AT+CGEQOS=[[,[,,[,,<UL_M BR]]]] 查询命令 AT+CGEQOS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+CGEQOS:,,[,],[,]][+CGEQOS:,,[< DL_GBR>,],[,][...]] OK 上海移远通信技术股份有限公司 73 /190 测试命令 AT+CGEQOS=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGEQOS:(支持的范围),(支持的列表),(支持的< DL_GBR>列表),(支持的列表),(支持的列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。指定某个 PDP 上下文定义（请参考 +CGDCONT 命令）。 整型。指定 EPS QoS 等级（参考 3GPP TS 23.203 [85]和 3GPP TS 24.301 [83]）。 0 QCI 由网络选择 [1–4] 保证比特率业务流的值范围 75 保证比特率流量的值 [5–9] 非保证比特率业务流量的值范围 79 非保证比特率流量的值 [128–254] 运营商特定 QCI 的值范围 UE 不可请求 QCI 值 65，66，69 和 70。如果 TE 请求 QCI 参数 65，66，69 或 70， 则 MT 响应结果代码 +CME ERROR: 181（不支持的 QCI 值） 整型。在 GBR QCI 的情况下表示 DL GBR。单位：kbit/s。对于非 GBR QCI，省略该 参数（参考 3GPP TS 24.301 [83]）。 整型。在 GBR QCI 的情况下表示 UL GBR。单位：kbit/s。对于非 GBR QCI，省略该 参数（参考 3GPP TS 24.301 [83]）。 整型。表示 GBR QCI 情况下的 DL MBR。单位：kbit/s。对于非 GBR QCI，省略该参 数（参考 3GPP TS 24.301 [83]）。 整型。表示 GBR QCI 情况下的 UL MBR。单位：kbit/s。对于非 GBR QCI，省略该参 数（参考 3GPP TS 24.301 [83]）。 备注 1. 可以仅设置 ， 仅支持 0、5、6、7、8、9 和 79。 2. 只有在开机和定义 PDP 上下文时才能执行此命令。 上海移远通信技术股份有限公司 74 /190 举例 AT+CGEQOS=0,0 OK AT+CGEQOS? +CGEQOS: 0,0 OK AT+CGEQOS=? +CGEQOS: (0),(0,5,6,7,8,9,79) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 2.43. AT+CGTFT 业务流模版 该命令允许 TE 指定一个数据包过滤器（用于 PF 的业务流模板）TFT，在 UMTS/GPRS 中的 GGSN 和 EPS 中的 Packet GW，通过将数据包路由到不同的 QoS 流最终发送到 TE。参考 3GPP TS 23.060 [47] 中的描述。 TFT 由 1 个到多达 16 个数据包过滤器组成，每个数据包过滤器由唯一的 标识。数据包过滤器还具有 ，此参数值在与相同 PDP 地址 下所有 PDP 上下文相关联的所有 TFT 中是唯一的。 设置命令指定待添加到存储在 MT 中 TFT 的数据包过滤器，并用于由（本地）上下文标识参数 标识的上下文。指定的 TFT 将仅在激活或 MS 启动的相关上下文修改时存储在 UMTS / GPRS 中的 GGSN 和 EPS 中的 Packet GW 中。因为这与 AT+CGDCONT 命令中使用的参数相同，AT+CGTFT 命令实际上 是这些命令的扩展。数据包过滤器由许多参数组成，每个参数可以设置为一个单独的值。设置命令的一种 特殊形式，AT+CGTFT= 使得 TFT 中的所有数据包过滤器的上下文编号 变得不确定。在任何 时候都可能存在一个 PDP 上下文没有相关联的 TFT。若试图违反规则删除一个 TFT，将返回 ERROR 或 +CME ERROR。AT+CMEE 命令可是能扩展错误响应。 查询命令返回每个已定义上下文的所有数据包筛选器的当前设置。 测试命令返回支持的参数。如果 MT 支持多种 PDP 类型，则每个 PDP 类型的参数值范围将在单独的 行上返回。 TFT 仅用于 PDP 型 IP 和 PPP。对于 PDP 型 PPP，仅当 IP 流量通过 PPP 承载时，TFT 才适 用。如果 PPP 携带报头压缩的 IP 数据包，则不能使用 TFT。 AT+CGTFT 业务流模版 设置命令 AT+CGTFT= [,[,[,[,[,[,[, [,[,[,[,]]]]]]]]]]] 查询命令 AT+CGTFT? 或者 +CME ERROR: 响应 [+CGTFT: ,,,,,,,,,,,] [+CGTFT: ,,,,,,,,,,,[...]] OK 测试命令 AT+CGTFT=? 如出现任何错误： ERROR 或者 +CME ERROR: 响应 +CGTFT: ,( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的 列表) [+CGTFT: ,(支持的列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列表),(支持的 列表)[...]] OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT 命令）。 字符串类型。指定数据包数据协议的类型（请参考 AT+CGDCONT 命令）。 整型。范围：1-16。 整型。范围：0-255。 字符串类型。该字符串以点分隔数字（0-255）参数给出： 'a1.a2.a3.a4.m1.m2.m3.m4'，用于 IPv4。 或者 'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a1 6.m1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m 14.m15.m16'，用于 IPv6 当支持 AT+CGPIAF 时（目前不支持），其设置可以影响 AT+CGTFT? 参数返回格式。 整型。范围：0-255。 字符串类型。本地端口范围。'f.t' 形式的点分隔数字。范围： 0-65535。 字符串类型。远程端口范围。'f.t' 形式的点分隔数字。范围： 0-65535。 十六进制格式的数值。范围：00000000-FFFFFFFF。 字符串类型。't.m'形式的点分隔数字（0-255）。 数字型。十六进制格式。范围：00000-FFFFF。仅对 IPv6 有效。 整型。指定应用数据包过滤器的传输方向。 0 Pre-Release 7 TFT 过滤器（参考 3GPP TS 24.008 [8]，表 10.5.162） 上海移远通信技术股份有限公司 77 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 1 上行链路 2 下行链路 3 双向（上行和下行） 字符串类型。点分十进制（0-255）格式： 'a1.a2.a3.a4.m1.m2.m3.m4'，用于 IPv4 或者 'a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16.m 1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15. m16'，用于 IPv6 当支持 AT+CGPIAF 时，此命令配置可能影响 AT+CGTFT? 参 数返回格式。 备注 1. 只有在开机和定义 PDP 上下文时才能执行此命令。 2. 暂不支持 。 3. 部分参数可以在分组过滤器中共存，而其他属性互相排斥，请参考 3GPP TS 23.060 [47]。 举例 AT+CGTFT=0,2,6,'32.1.11.160.0.0.0.0.0.0.0.0.0.0.0.0.255.255.255.255.0.0.0.0.0.0.0.0.0.0.0.0',17,'600 01.60001','60350.60450',0x123456,168.252,0x12345,1 OK AT+CGTFT? +CGTFT:0,2,6,'2001:BA0::.FFFF:FFFF::',17,'60001.60001','60350.60450',0x123456,'168.252',0x1 2345,1 OK AT+CGTFT=? +CGTFT:'IP',(1,16),(0,255),'(0.0.0.1,255.255.255.255).(0.0.0.1,255.255.255.255)',(0,255),'(0,65535).( 0,65535)','(0,65535).(0,65535)',(0x0,0xFFFFFFFF),'(0,255).(0,255)',,(0,3)) +CGTFT:'NONIP',(1,16),(0,255),,(0,255),'(0,65535).(0,65535)','(0,65535).(0,65535)',(0x0,0xFFFFFF FF),'(0,255).(0,255)',,(0,3)) +CGTFT:'IPV6',(1,16),(0,255),'(::1,FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF).(::1,FFFF:FFFF: FFFF:FFFF:FFFF:FFFF:FFFF:FFFF)',(0,255),'(0,65535).(0,65535)','(0,65535).(0,65535)',(0x0,0xFFF FFFFF),'(0,255).(0,255)',(0x0,0xFFFFF),(0,3)) +CGTFT:'IPV4V6',(1,16),(0,255),'(0.0.0.1,255.255.255.255)(::1,FFFF:FFFF:FFFF:FFFF:FFFF:FFFF: FFFF:FFFF).(0.0.0.1,255.255.255.255)(::1,FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF)',(0,255),' (0,65535).(0,65535)','(0,65535).(0,65535)',(0x0,0xFFFFFFFF),'(0,255).(0,255)',(0x0,0xFFFFF),(0,3)) OK 上海移远通信技术股份有限公司 78 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 3 3GPP 命令 (27.005) 3.1. AT+CSMS 选择短信服务 设置命令用来选择短信服务，它会返回 UE 支持的短信类型： 表示被叫消息， 表示主叫 消息， 表示广播类型消息。如果 ME 不支持所选的服务，将会返回最终结果码 +CME ERROR:。 查询命令会返回当前服务设置中支持的消息类型。 AT+CSMS 选择短信服务 设置命令 AT+CSMS= 响应 +CSMS: ,, OK 查询命令 AT+CSMS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSMS: ,,, OK 测试命令 AT+CSMS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSMS:(支持的列表) OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 79 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 +CME ERROR: 300 毫秒 参数 整型。表示消息服务。 0 表示 3GPP TS 23.040 [3] 和 3GPP TS 23.041 [4] 1 表示 3GPP TS 23.040 [3] 和 3GPP TS 23.041 [4] 相应的命令描述中提到了参数 设置为 1 的要求 整型。被叫消息。 0 不支持 1 支持 整型。主叫消息。 0 不支持 1 支持 整型。广播类型消息。 0 不支持 1 支持 备注 1. 如果 UE 收到短信，将会上报 URC +CMT:[],（PDU 模式已启 用）。 2. 上述 URC 中的参数 的值始终为 0，如需查看更多 URC 的相关信息，请参考 3GPP TS 27005 中的 AT+CNMI 命令。 举例 AT+CSMS=1 +CSMS:2,3,4 OK AT+CSMS? +CSMS:1,2,3,4 OK AT+CSMS=? +CSMS:(0,1) OK 上海移远通信技术股份有限公司 80 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 3.2. AT+CNMA 发送新消息确认 该执行命令可以对发送到 UE 的新消息（SMS-DELIVER 或 SMS-STATUS-REPORT）进行确认。当 AT+CSMS 的参数 等于 1 时应使用此命令。在 PDU 模式下，可以向网络发送肯定（RPACK） 或否定（RP-ERROR）的确认消息。参数 决定发送哪个消息。可以有选择地（当参数 大 于 0 时）向网络发送确认 TPDU（RPACK 或 RP-ERROR 的 SMS-DELIVER-REPORT）。除了使用 的格式代替 （即不存在 SMSC 地址字段）之外，输入的 PDU 与命令 AT+CMGS 中指定的类似。 PDU 不应以双引号为界，在前一个消息被确认之前，UE 不应发送其他 +CMT 或 +CDS 结果码给 TE。 如果在规定的时间内（网络超时）没有收到确认消息，则 UE 应按照 3GPP TS 24.011 [6]中的规定向 网络发起响应消息。 如果执行该命令却没有收到相应的确认消息，或是发生其他 UE 相关的错误，则返回最终结果码 +CME ERROR: 。如果直传的路由消息必须要缓存在 UE 中，或者 AT 解析在结果码无法发送至 TE 的状态 保持时间过长（例如，用户使用 AT+CMGS 输入消息），则必须在不等待来自 TE 的 AT+CNMA 命令的情 况下，向网络发送确认消息（RP-ACK）。之后，当缓冲的结果码被刷新到 TE 时，TE 必须为每个结果码 发送 +CNMA [=0] 进行确认。通过这种方式，UE 可以决定消息是否应该保存在 NVM 中和禁用到 TE 的路 由（未接收到 +CNMA [=0]）。 AT+CNMA 发送新消息确认 执行/设置命令 AT+CNMA=[[,[PDU is given]]] 测试命令 AT+CNMA=? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CNMA:(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。 1 发送 RP-ACK（或者正确接收的缓冲结果码）。 上海移远通信技术股份有限公司 81 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 2 发送 RP-ERROR（如果没有给出 PDU，ME/TA 应发送 SMS-DELIVER-REPORT， 其中 3GPP TS 23.040 [3] TP-FCS 的值设置为'FF'。（未指明的错误原因）。 整型。 表示在文本模式下，消息体 （或 ）的长度。单位：字符；或者在 PDU 模式下，实际 TP 数据的长度。单位：八位字节（即 RP 层 SMSC 地址八位字节不计入 长度）。范围是 0-232。 备注 1. 如果 UE 收到短信，将会上报 URC +CMT:[],（PDU 模式已启 用）。 2. 上述 URC 中的参数 的值始终为 0，如需查看更多 URC 的相关信息,请参考 3GPP TS 27005 中的 AT+CNMI 命令。 举例 AT+CNMA=1 OK AT+CNMA=? +CNMA:(1,2) OK 3.3. AT+CSCA 设置短信服务中心地址 该设置命令可以更新 SMSC 地址，通过该地址发送主叫短信。在文本模式下，可以使用设置命令进行 设置。在 PDU 模式下，仅当 SMSC 地址的长度编码为 =0 时，可使用同一命令进行设置。 AT+CSCA 设置短信服务中心地址 设置命令 AT+CSCA=[,] 响应 OK 查询命令 AT+CSCA? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CSCA:[,] OK 上海移远通信技术股份有限公司 82 /190 测试命令 AT+CSCA=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 表示 3GPP TS 24.011 [6] RP SC 地址字符串格式的地址-值字段。BCD 数字（或 GSM 7 位 默认字母字符）被转换为当前选择的 TE 字符集的字符（参考 3GPP TS 27.007 [9]中的 AT+CSCS 命令）；地址类型由 给出。 表示 3GPP TS 24.011 [6] RP SC 地址整数格式的八位字节地址类型。当 （参考 3GPP TS 27.005）的第一个字符为'+(IRA 43)'时，此参数默认值为 145，否则默认值为 129。 举例 AT+CSCA=358501234567,145 OK AT+CSCA? +CSCA:'358501234567',145 OK AT+CSCA=? OK 3.4. AT+CMGS 发送短信 该命令可以从 TE 向网络发送消息（SMS-SUBMIT）。消息传输成功时，消息参考值 会被返回 给 TE。可选择（当 AT+CSMS 的参数 值为 1 且网络支持时）返回参数 。参数值可 在非请求的发送状态上报结果码时被用来标识消息。如果消息在网络中发送失败或 UE 发生错误，则会返回 最终结果码 + CME ERROR：。该命令是可以中止的。  参数 表示要给出的在 TP 层数据单元中编码的八位字节数（即排除 SMSC 地址八位字 节）。  在命令行以 终止后，UE 应发送一个四字符序列 （IRA 13, 10, 62, 32）；之后，可以从 TE 向 UE 发送 PDU。  在给出 PDU 时，DCD 信号应处于 ON 状态。  从 UE 返回的给定字符的回显由 V.25ter 回显命令 E 控制。  PDU 应为十六进制格式（和 指定的类似）并在一行中给出；UE 将该编码转换为 PDU 的 上海移远通信技术股份有限公司 83 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 实际八位字节。  当 SMSC 地址的八位字节长度（在 PDU 中给出）等于零时，使用以 AT+CSCA 命令设置的 SMSC 地址；在这种情况下，PDU 中不应存在 SMSC 地址的八位字节，也就是说 TPDU 长度计算在 SMSC 八位字节长度之后开始。  发送字符（IRA 27）可以取消发送。 AT+CMGS 发送短信 设置命令 AT+CMGS= 返回 > 后输入 PDU。过程中点击 Esc 可 取消操作。 响应 +CMGS:[,] OK 测试命令 AT+CMGS=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 整型。表示 3GPP TS 23.040 [3] TP-Message-Reference（消息参考）。 整型。表示在文本模式下消息体 （或 ）的长度。单位：字符；或者在 PDU 模式下，实际八位字节 TP 数据单元的长度（即 RP 层 SMSC 地址的八位字节不计 入长度）。范围：7-164。 表示 3GPP TS 23.040 [3] RP-ACK PDU 的 RP-User-Data 元素（用户数据元素）。格 式与 SMS 中 相同。但不同于 3GPP TS 24.011 [6] SC 地址字段，参数应和普 通字符串类型参数相同，由双引号标记。 备注 1. 目前不返回参数 。 2. 对于 PDU（3GPP TS 24.011）中的地址字段，应在其开头添加国家代码，例如中国的国家代码 86。 上海移远通信技术股份有限公司 84 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 3.5. AT+CMGC 发送短信命令 该命令可以从 TE 向网络发送命令消息（SMS-COMMAND）。文本的输入（3GPP TS 23.040 [3] TP-Command-Data）与 AT+CMGS 命令指定的类似，但格式固定为两个 IRA 字符长十六进制数的序列， UE 会将其转换为八位字节（参考 AT+CMGS）。消息传输成功时，消息参考值 会被返回给 TE。可 选择返回（当 AT+CSMS 的参数 的值为 1 且网络支持时）。参数值可在非请求的发送 状态上报结果码时被用来标识消息。如果在网络中消息发送失败或 UE 发生错误，则会返回最终结果码 +CME ERROR: 。该命令是可以中止的。 AT+CMGC 发送短信命令 设置命令 AT+CMGC= 返回 > 后输入 PDU。过程中点击 Esc 可 取消操作。 响应 +CMGC:[,] OK 测试命令 AT+CMGC=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 整型。表示 3GPP TS 23.040 [3] TP-Message-Reference（消息参考）。 整型。表示在文本模式下消息体 （或 ）的长度。单位：字符；或者在 PDU 模式下，实际八位字节 TP 数据单元的长度（即 RP 层 SMSC 地址的八位字节不计 入长度）。范围：8-174。 表示 3GPP TS 23.040 [3] RP-ACK PDU 的 RP-User-Data 元素（用户数据元素）。格 式与 SMS 中 相同。但不同于 3GPP TS 24.011 [6] SC 地址字段，参数应和普 通字符串类型参数相同，由双引号标记。 备注 1. 目前不返回参数 。 2. 对于 PDU（3GPP TS 24.011）中的地址字段，应在其开头添加国家代码，例如中国的国家代码 86。 上海移远通信技术股份有限公司 85 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 3.6. AT+CMMS 发送更多信息 该命令用于控制 SMS 中继协议链路的连续性。当启用功能（并由网络支持）时，由于保持链接打开， 可以更快地发送多条消息。 AT+CMMS 发送更多信息 设置命令 AT+CMMS=[] 响应 OK 查询命令 AT+CMMS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMMS: OK 测试命令 AT+CMMS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CMMS: (支持的列表) 最大响应时间 OK 300 毫秒 参数 整型。 0 禁用。 1 保持启用状态直到最新消息发送命令（AT+CMGS）响应和发送下一个命令之间时间超 过 1~5 秒（确切的值取决于 ME 实现），然后 ME 将关闭链路，TA 自动切换 为 0。 2 启用。如果最新消息发送命令和发送下一条命令的响应之间时间超过 1-5 秒（确切的值 取决于 ME 实现），ME 将关闭链路，TA 不会自动切换 为 0。 举例 AT+CMMS=0 OK AT+CMMS? 上海移远通信技术股份有限公司 86 /190 +CMMS: 0 OK AT+CMMS=? +CMMS: (0,1,2) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 上海移远通信技术股份有限公司 87 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4 一般命令 4.1. AT+NRB 重启 UE 该命令用来重启 UE。执行此命令之后，会有短暂的延迟，UE 才会重启。在执行该命令期间不再处理 其他 AT 命令。 须注意，由于 AT 命令的处理终止于该命令，因此最后不会返回 OK 表示命令行已处理完成。重启之前 不会发出确认消息。 AT+NRB 重启 UE 执行命令 AT+NRB 最大响应时间 响应 REBOOTING 300 毫秒 举例 AT+NRB REBOOTING 4.2. AT+NUESTATS 查询 UE 统计信息 该命令用来获取最新的操作统计信息。该命令可以采用一个可选参数来显示不同的统计数据集。参数 =RADIO 和执行命令 AT+NUESTATS 一样会提供默认值集，=ALL 将打印所有数据。 AT+NUESTATS 查询 UE 统计信息 执行命令 AT+NUESTATS 响应 Signal power: Total power: TX power: TX time: RX time: Cell ID: 上海移远通信技术股份有限公司 88 /190 设置命令 AT+NUESTATS=RADIO 查询具体无线信息 BC35-G&BC28&BC95 R2.0 AT 命令手册 ECL: SNR: EARFCN: PCI: RSRQ: OPERATOR MODE: CURRENT BAND: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:RADIO,Signal power: NUESTATS:RADIO,Total power: NUESTATS:RADIO,TX power: NUESTATS:RADIO,TX time: NUESTATS:RADIO,RX time: NUESTATS:RADIO,Cell ID: NUESTATS:RADIO,ECL: NUESTATS:RADIO,SNR: NUESTATS:RADIO,EARFCN: NUESTATS:RADIO,PCI: NUESTATS:RADIO,RSRQ: NUESTATS:RADIO,OPERATOR MODE: 上海移远通信技术股份有限公司 89 /190 设置命令 AT+NUESTATS=CELL 查询前八个小区信息 设置命令 AT+NUESTATS=THP 查询吞吐量 设置命令 AT+NUESTATS=BLER 查询误块率信息 上海移远通信技术股份有限公司 BC35-G&BC28&BC95 R2.0 AT 命令手册 NUESTATS:RADIO,CURRENT BAND: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:CELL,,,,,,, [...NUESTATS:CELL,,,,,,,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:THP,, [...NUESTATS:THP,,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:BLER,, [...NUESTATS:BLER,,] OK 若出现任何错误： ERROR 或者 90 /190 设置命令 AT+NUESTATS=APPSMEM 查询动态存取使用情况 设置命令 AT+NUESTATS= 测试命令 AT+NUESTATS=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 +CME ERROR: 响应 NUESTATS:APPSMEM,Current Allocated: NUESTATS:APPSMEM,Total Free: NUESTATS:APPSMEM,Max Free: NUESTATS:APPSMEM,Num Allocs: NUESTATS:APPSMEM,Num Frees: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:,,[,<value[,[...]]] [...NUESTATS:,,[,<value[,[...]]]] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 NUESTATS:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 91 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 不带引号的字符串类型。表示要显示的数据类型。参数 支持的值有： RADIO 具体无线信息 CELL 前 8 个小区信息 BLER 误块率信息 THP 吞吐量 APPSMEM 动态内存使用情况 ALL 所有信息。输出每种 数据类型的正确值。 如果 =RADIO，将返回默认值集： 信号功率。实际值需要除以十。 总功率。实际值需要除以十。 当前强发功率等级。实际值需要除以十。 自上次重启以来总的 TX 时间。单位：毫秒。 自上次重启以来总的 RX 时间。单位：毫秒。 上一个 SIB1 的小区 ID。 上一个 ECL 的值。 上一个 SNR 的值。 上一个 EARFCN 的值。 上一个 PCI 的值。 参考信号接收质量。实际值需要除以十。 SIB1 的部署模式。 0 未知模式 1 带内不同的 PCI 模式 2 带内相同的 PCI 模式 3 保护带模式 4 独立模式 服务小区的频段。 如果 =CELL 表示前 8 个小区信息，返回参数形式为：,,,,,, 绝对射频频道号。 物理小区 ID。 1 表示当前服务小区。 参考信号接收功率。 参考信号接收质量。 接收信号强度指示。 信噪比。 如果 =BLER，返回的参数类型如下： 误块率类型。 RLC 层误块率（上行），整数百分比。 RLC 层误块率（下行），整数百分比。 物理层误块率（上行），整数百分比。 物理层误块率（下行），整数百分比。 传输的总字节数。 上海移远通信技术股份有限公司 92 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 接收的总字节数。 发送的传输块。 接收的传输块。 重新传输的传输块。 收到 ACK/NACK 消息的总数。 如果 =THP，返回的参数类型如下： 整数。RLC 层吞吐量（上行）。单位：bps。 整数。RLC 层吞吐量（下行）。单位：bps。 整数。物理层吞吐量（上行）。单位：bps。 整数。物理层吞吐量（下行）。单位：bps。 如果 =APPSMEM，表示动态内存使用情况，返回的参数类型如下： 当前已分配的内存大小。 总的剩余内存大小。 最大的剩余内存大小。 分配内存的次数。 剩余内存的次数。 备注 1. 执行命令 AT+NUESTATS 的响应结果与设置命令 AT+NUESTATS=RADIO 的响应结果相同，但没 有命令和变量前缀（即 NUESTATS：RADIO）。此执行命令将在以后的版本中删除。 2. Tx time 和 Rx time 在三种情况下会清零，分别是 UE 开机、RRC 去激活、Oos 脱网。 举例 AT+NUESTATS Signal power:-842 Total power:-780 TX power:100 TX time:859 RX time:26543 Cell ID:137262770 ECL:0 SNR:226 EARFCN:3734 PCI:105 RSRQ:-108 OPERATOR MODE:4 CURRENT BAND:8 OK AT+NUESTATS=CELL NUESTATS:CELL,3734,105,1,-842,-108,-780,226 上海移远通信技术股份有限公司 93 /190 OK AT+NUESTATS=THP NUESTATS:THP,RLC UL,100 NUESTATS:THP,RLC DL,98 NUESTATS:THP,MAC UL,103 NUESTATS:THP,MAC DL,100 OK AT+NUESTATS=BLER NUESTATS:BLER,RLC UL BLER,10 NUESTATS:BLER,RLC DL BLER,5 NUESTATS:BLER,MAC UL BLER,8 NUESTATS:BLER,MAC DL BLER,3 NUESTATS:BLER,Total TX bytes,1080 NUESTATS:BLER,Total RX bytes,900 NUESTATS:BLER,Total TX blocks,80 NUESTATS:BLER,Total RX blocks,80 NUESTATS:BLER,Total RTX blocks,100 NUESTATS:BLER,Total ACK/NACK RX,100 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.3. AT+NEARFCN 指定搜索频率 该设置命令提供锁定特定 E-UTRAN 绝对射频信道号（EARFCN）的机制，如有需要，还可以锁定物 理小区 ID。在解除锁定或者 UE 重启之前，所有操作都将锁定到此载波上。该操作重启后不会保存，如果 指定的 EARFCN 不存在，则 UE 将进入停止服务模式。如果指定的 PCI 不存在，UE 也会进入停止服务模 式。 上海移远通信技术股份有限公司 94 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 AT+NEARFCN 指定搜索频率 设置命令 AT+NEARFCN=,[,] 测试命令 AT+NEARFCN=? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 300 毫秒 参数 整型。指定搜索类型并定义提供的参数。 0 锁定到指定的 EARFCN 整型。范围：1-65535。表示要搜索的 EARFCN。 整型。E-UTRAN 物理小区 ID。十六进制格式。有效范围 0-1F7。 举例 AT+NEARFCN=0,2506,AB OK 4.4. AT+NSOCR 创建 Socket 该命令可以在 UE 上创建一个 Socket，该命令与指定的协议相关。如果端口已设置，使能接收功能， 则对于在该端口上接收的任何消息，将上报 URC +NSONMI。 如果已经为协议或端口的组合创建了 Socket，那么第二次请求 AT+NSOCR 将会失败。 AT+NSOCR 创建 Socket 设置命令 AT+NSOCR=,,[,[,[,]]] 响应 OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 95 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 或者 +CME ERROR: 300 毫秒 参数 Socket 类型。 DGRAM UDP STREAM TCP 整型。标准互联网协议。例如，UDP 为 17，TCP 为 6。 整型。范围：0-65535。表示一个包含在发送的消息中的本地端口，并会通过此本 地端口接收消息。如果为 0（在创建 TCP Socket 时），则模块将为此 Socket 分配 一个随机的 。 大于等于 0 的整型。表示创建的 Socket 的编号。最多支持 7 个 Socket，但其他服 务可能会占用 Socket。 整型。接收控制。 0 忽略传入消息 1 接收传输消息 字符串类型。IPv4 是 AF_INET，IPv6 是 AF_INET6。默认值为 AF_INET。 IP 地址。网络分配给 UE 的 IP 地址。 备注 1. 启用 BIP（承载独立协议）时，TCP 的 不能设置为 20000。 2. 最大支持 7 个 Socket，但是其他服务，例如 MQTT,CoAP 等，也许会减少 Socket 的最大数量。 3. 参数 中，端口 5683、5684、56830、56831 和 56833 为预留端口，不建议使用。 举例 AT+NSOCR=DGRAM,17,4587,1,AF_INET 1 OK AT+NSOCR=DGRAM,17,1234,0 1 OK 上海移远通信技术股份有限公司 96 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.5. AT+NSOST 发送消息（仅限 UDP） 该命令可以将包含长度字节数据的 UDP 数据报发送到 上的 ，并将 返回发送的 Socket 以及发送的数据字节数。如果发送的数据超过最大可发送数据，AT+NSOST 的返回值 则显示成功发送了多少数据。 AT+NSOST 发送消息（仅限 UDP） 设置命令 AT+NSOST=,,,,[,< sequence>] 响应 , OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 IP 地址。支持十进制、八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：0-65535。 整型。表示要发送数据的十进制长度。 要传输的数据。十六进制格式。最大长度为 1358 字节。 数据的序列。范围：1-255。如果省略，则不会上报数据发送状态。如果不省略，当 数据通过 RF 发送或丢弃时，将上报以下结果： +NSOSTR:,, 数据报状态。 0 错误 1 已发送 备注 在通过 RF 发送或丢弃数据之前，不能使用相同的 ，否则 AT 命令将返回 ERROR。 举例 AT+NSOST=1,192.158.5.1,1024,2,AB30,1 1,2 上海移远通信技术股份有限公司 97 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 OK 4.6. AT+NSOSTF 发送带标志的消息（仅限 UDP） 该命令可以将包含长度字节数据的 UDP 数据报发送到 上的 ，允许 设置元数据标志，并将返回发送的 Socket 以及发送的数据字节数。如果发送的数据超过最大可发送数据， AT+NSOST 的返回值则显示成功发送了多少数据。 AT+NSOSTF 发送带标志的消息（仅限 UDP） 设置命令 AT+NSOSTF=,,,,,[,] 响应 , OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。表示由 AT+NSOCR 返回的 Socket 编号。 点分十进制 IPv4 地址。支持十进制，八进制或十六进制格式。 整型。接收消息的远端端口。支持十进制和十六进制格式。范围：0-65535。 整型。指定消息传输类型。此参数的值为十六进制格式，并通过对以下标志中的零 个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：表示收到该消息的回复后释放 若未设置 ，应将值设置为 0。 整型。要发送的数据长度。十进制格式。最大数据为 1358 字节。 要传输的数据。十六进制格式。 数据的序列。范围：1-255。 如果省略，则不会上报数据发送状态。如果不省略， 当数据通过 RF 发送或丢弃时，将上报以下结果： +NSOSTR:,, 数据报状态。 0 错误 1 已发送 上海移远通信技术股份有限公司 98 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 备注 在通过 RF 发送或丢弃之前，不能使用相同的 ，否则 AT 命令将返回 ERROR。 举例 AT+NSOSTF=1,192.158.5.1,1024,0x100,2,AB30,1 1,2 OK 4.7. AT+NQSOS 查询待处理的 Socket 消息清单 UE 可以使用该命令查询待处理上行消息清单。 AT+NQSOS 查询待处理的 Socket 消息清单 设置命令 AT+NQSOS=[,[,[…]]] 响应 [+NQSOS:,] [+NQSOS:,] […] OK 查询命令 AT+NQSOS? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+NQSOS:,] [+NQSOS:,] […] OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 99 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 Socket 编号。 待处理的上行消息序列。范围：1-255。 举例 AT+NQSOS=1,2 +NQSOS:1,2 +NQSOS:2,3 OK AT+NQSOS? +NQSOS:1,2 +NQSOS:2,3 OK 4.8. AT+NSORF 读取消息 该命令用于接收 Socket（）上的数据，响应中的 是返回的实际字符数。当数据到 达时，将上报 URC +NSONMI 响应结果以指示收到消息的 Socket 以及数据量。AT+NSORF 命令有一个长 度 ，此长度是返回的最大数据量。 如果请求的数据长度大于返回数据的实际长度，则仅提供返回数据的长度，并且剩余长度将返回为 0。 如果请求的数据长度小于返回数据的实际长度，则仅返回请求长度的数据，并指示剩余的字节数。消息完 全被读取后，如果有另一条消息需要处理，将发送新的 +NSONMI 通知。 如果消息的到达速度快于读取的速度，并且内部消息缓冲区已满，则最新消息将被丢弃。 AT+NSORF 读取消息 设置命令 AT+NSORF=, 响应 ,,,,, OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 100 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 最大响应时间 300 毫秒 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 返回的最大数据长度。十进制格式。最大请求数据长度为 1358 字节。 表示发送消息的系统地址。 点分十进制 IPv4 地址，点分十进制。IP 地址可以以十进制，八进制或十六进制表 示。仅支持 IPv4。 表示发送消息的远端端口。范围：0-65535。 表示返回的数据长度。十进制格式。 未读取的消息剩余数据长度。十进制字格式。剩余长度始终为 0 且剩余数据可读。 表示接收的数据，十六进制格式。最大的接收数据长度是 1358 字节。 举例 AT+NSORF=1,10 1,192.168.5.1,1024,2,ABAB,0 OK 4.9. AT+NSOCO 连接命令（仅限 TCP） 该命令将 TCP 服务器连接到指定的主机端口。 AT+NSOCO 连接命令（仅限 TCP） 设置命令 AT+NSOCO=,, 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 发送消息的系统地址。支持十进制，八进制或十六进制表示。 连接的远端端口。范围：0-65535。支持十进制和十六进制格式。 上海移远通信技术股份有限公司 101 /190 举例 AT+NSOCO=1,192.158.5.1,1024 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.10. AT+NSOSD 发送消息（仅限 TCP） 该命令可以发送 TCP 数据报到 TCP 服务器，会返回发送 Socket 和数据字节数量。AT+NSOSD 的返 回值将表示成功发送的数据长度。 AT+NSOSD 发送数据（仅限 TCP） 设置命令 AT+NSOSD=,,[,[,]] 响应 , OK 最大响应时间 若出现任何错误： ERROR Or +CME ERROR: 300 毫秒 参数 整型。由 AT+NSOCR 返回的 Socket 编号。 整型。表示发送的数据长度。十进制格式。 十六进制格式。要传输的数据。最大数据为 1358 字节。 整型。指定消息传输的类型。此参数的值为十六进制格式，并通过对以下标志中的 零个或多个进行逻辑'或'运算来形成： 0x100 异常消息：发送具有高优先级的消息 0x200 释放指示：指示该条消息发送后释放 0x400 释放指示：指示收到该条消息的回复后释放 如果未设置 ，则应将值设置为 0。 数据的序列。范围 1-255。如果省略，则不会上报数据发送状态；如果不省略，当 服务器请求数据报或 UE 丢弃数据报时，将上报以下结果： +NSOSTR:,, 数据报的状态。 0 错误 1 已发送 上海移远通信技术股份有限公司 102 /190 备注 参数 目前不生效。 举例 AT+NSOSD=1,2,AB30 1,2 OK AT+NSOSD=1,2,AB30,0x100 1,2 OK AT+NSOSD=1,2,AB30,0x100,255 1,2 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.11. AT+NSOCL 关闭 Socket 该命令用于关闭指定的 Socket。如果有待读取的未处理消息，则会将它们删除。不再打印 +NSONMI 通知。如果 Socket 已经关闭，或者从未被创建，该命令会返回错误。 AT+NSOCL 关闭 Socket 设置命令 AT+NSOCL= 响应 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。AT+NSOCR 返回的 Socket 编号。 上海移远通信技术股份有限公司 103 /190 举例 AT+NSOCL=1 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.12. AT+NSONMI 指示已到达 Socket 的消息 该命令用于设置 URC +NSONMI 指示已到达 Socket 的消息： 查询命令返回命令的当前设置。 AT+NSONMI 指示已到达的 Socket 消息 设置命令 AT+NSONMI= 响应 OK 查询命令 AT+NSONMI? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSONMI: OK 测试命令 AT+NSONMI=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSONMI: (支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 104 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型。控制下行数据格式。 0 禁用 URC 指示消息。 1 启用 URC 指示消息： +NSONMI:,。 2 启用指示消息，服务器地址和用户数据 URC +NSONMI:,, ,,。 3 启用指示消息、用户数据 URC +NSONMI: ,,. 整型。接收数据的 Socket。十进制数。由 AT+NSOCR 返回。 整型。第一条消息中的数据字节数。 发送消息的系统地址。 整型。接收消息的远程端口。范围：0-65535。 十六进制格式字符串类型。接收到的数据。接收数据的最大长度为 1358 字节。 举例 AT+NSONMI=1 OK AT+NSONMI? +NSONMI:1 OK AT+NSONMI=? +NSONMI:(0,1,2,3) OK 备注 如果无缓存消息，则随时会返回 URC +NSONMI:, 以指示已收到新消息。如果有缓存消 息，则在通过 AT+NSORF 命令完全读取已缓存的消息之后，才会上报此 URC。 4.13. +NSOCLI 关闭 Socket 指示（仅用于响应） 这是一条非请求消息，通知 Socket 已经被 LwIP 内部关闭。它会返回 Socket 编号。 +NSOCLI 关闭 Socket 指示（仅用于响应） URC 格式： +NSOCLI: 上海移远通信技术股份有限公司 105 /190 参数 BC35-G&BC28&BC95 R2.0 AT 命令手册 整型。接收数据的 Socket。十进制格式。由 AT+NSOCR 返回。 备注 此 URC 将仅在 TCP 模式下上报。 4.14. AT+NPING 测试到远程主机的 IP 网络连接 该命令将 ICMP 数据包发送到指定的主机地址。 尝试 PING 操作最多不超过 1 次。如果在设置的超时期限内没有任何数据包收到响应，则将会发生错 误。 如果收到响应，将上报 +NPING 消息。如果没有收到响应，将返回带有错误值的 +NPINGERR 主动 响应消息。 AT+NPING 测试到远程主机的 IP 网络连接 设置命令 AT+NPING=[,[,]] 响应 OK +NPING:,, 最大响应时间 若出现任何错误： ERROR 或者 +NPINGERR: 300 毫秒 参数 发送消息的对端地址。点分十进制 IPv4 地址。IP 地址可以用十进制、八进制 或十六进制表示法指定。仅支持 IPv4。 整型。回显数据包有效负载的字节大小。范围：12-1500。默认值是 12。 整型。等待回显回复响应的最大时间。范围：10-600000。单位：毫秒。默认 值为 10000。 整型。响应包中收到的 TTL。 整型。从发送包到收到的响应所经过的时间。单位：毫秒。 上海移远通信技术股份有限公司 106 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 整型。提供有关 PING 请求失败原因的相关信息。 1 在超时期间远端主机没有响应 2 发送 PING 请求失败 4.15. AT+NBAND 设置支持的频段 该命令可设置要使用的频段。测试命令将返回硬件支持的所有频段。 AT+NBAND 设置支持的频段 设置命令 AT+NBAND=[,[,[…]]] 响应 OK 查询命令 AT+NBAND? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NBAND:[,[,[…]]] OK 测试命令 AT+NBAND=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NBAND:(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。十进制格式。频段。 上海移远通信技术股份有限公司 107 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 备注 AT+NBAND= 必须在无线处于不活动状态下执行（AT+CFUN=0 将强制模块进入此状态）。 举例 AT+NBAND=? +NBAND:(1,3,5,8,20,28) OK AT+NBAND? +NBAND:5,8,3,28,20,1 OK 4.16. AT+NLOGLEVEL 设置调试日志级别 该命令用来设置日志级别。该值在重启后保持不变。 AT+NLOGLEVEL 设置调试日志级别 设置命令 AT+NLOGLEVEL=, 响应 OK 查询命令 AT+NLOGLEVEL? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NLOGLEVEL:, OK 测试命令 AT+NLOGLEVEL=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NLOGLEVEL:(支持的列表),(支持的列表) OK 上海移远通信技术股份有限公司 108 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 字符串类型。请求的核。 PROTOCOL APPLICATION SECURITY 字符串类型。需要的日志级别 VERBOSE NORMAL WARNING ERROR NONE 举例 AT+NLOGLEVEL? +NLOGLEVEL: SECURITY,NORMAL +NLOGLEVEL: PROTOCOL,NORMAL +NLOGLEVEL: APPLICATION,NORMAL OK 4.17. AT+NCONFIG 配置 UE 行为 该命令允许配置某些方面的 UE 行为。它的参数包含一个功能和一个控制该功能操作的值。 AT+NCONFIG 配置 UE 行为 设置命令 AT+NCONFIG=, 响应 OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 109 /190 查询命令 AT+NCONFIG? 测试命令 AT+NCONFIG=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 或者 +CME ERROR: 响应 +NCONFIG:, [+NCONFIG:,] […] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCONFIG:(,(,[, [,…]])) [+NCONFIG:(,(,[, [,…]]))] […] OK 若出现任何错误，响应 ERROR 或者 +CME ERROR: 300 毫秒 参数 要配置的 UE 功能。 AUTOCONNECT COMBINE_ATTACH CELL_RESELECTION ENABLE_BIP MULTITONE NAS_SIM_POWER_SAVING_ENABLE BARRING_RELEASE_DELAY RELEASE_VERSION 控制 UE 在开机或重启后是否会自动尝试连接 网络。当启用此功能时，它将设置 AT+CFUN=1 并从 USIM 中读取 PLMN。并且将使用网络提 供的 APN。 联合附着 小区重选 启用/禁用 BIP 多路 USIM 卡省电模式。 从禁止开始延时释放的时间。范围：0-1800。 单位：秒。 发布版本。仅支持版本 13 和 14。当 UE 不使 上海移远通信技术股份有限公司 110 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 RPM SYNC_TIME_PERIOD IPV6_GET_PREFIX_TIME NB_CATEGORY RAI HEAD_COMPRESS RLF_UPDATE CONNECTION_REESTABLISHMENT TWO_HARQ PCO_IE_TYPE T3324_T3412_EXT_CHANGE_REPORT NON_IP_NO_SMS_ENABLE SUPPORT_SMS HPPLMN_SEARCH_ENABLE 布尔类型。 TRUE FALSE 用功率等级 6 时应设置为 13。 RPM。如果 USIM 上存在 RPM 文件，USIM 设置将具有优先权。 来自 eNB 的同步时间周期。范围：0-65535。 单位：分钟。0 表示关闭时间同步。 设 置 获 取 IPv6 前 缀 的 最 长 时 间 。 范 围 ： 0-65535。单位：秒。0 表示立即获取 IPv6 前 缀，65535 表示不获取 IPv6 前缀。 配置 NB-IoT 类别。目前只支持 1 和 2。 启用/禁用 RAI。 头压缩。 'FALSE'表示当无线链路失败时，NAS 将立 即 TAU。'TRUE'表示当无线链路失败时， 在 TAU 之前期望会发出 ACK。 重建连接。 双 HARQ PCO 类型。支持'PCO'和'EPCO'。 启 用 / 禁 用 当 和 / 或 的 NAS 计 时 器 更 改 时， AT+CEREG=5 的 URC 显示。 'TRUE'表示 为 Non-IP 时， 不支持 SMS。 启用/禁用 SMS。 启用/禁用 HPPLMN 搜索。 备注 1. 'CR_'功能只是临时的，当不再需要时将删除。 2. 只有当无线处于非活动状态时（AT+CFUN=0 将强制模块进入此状态），才能设置 MULTITONE、 NAS_SIM_POWER_SAVING_ENABLE 、 RELEASE_VERSION 、 SYNC_TIME_PERIOD 、 NB_ CATEGORY 、 RAI 、 HEAD_COMPRESS 、 TWO_HARQ 、 PCO_IE_TYPE 、 HPPLMN_SEARCH_ ENABLE 和 SUPPORT_SMS。 举例 AT+NCONFIG? +NCONFIG:AUTOCONNECT,TRUE +NCONFIG:CR_0354_0338_SCRAMBLING,TRUE +NCONFIG:CR_0859_SI_AVOID,TRUE +NCONFIG:COMBINE_ATTACH,FALSE +NCONFIG:CELL_RESELECTION,TRUE 上海移远通信技术股份有限公司 111 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 +NCONFIG:ENABLE_BIP,FALSE +NCONFIG:MULTITONE,TRUE +NCONFIG:NAS_SIM_POWER_SAVING_ENABLE,TRUE +NCONFIG:BARRING_RELEASE_DELAY,64 +NCONFIG:RELEASE_VERSION,13 +NCONFIG:RPM,FALSE +NCONFIG:SYNC_TIME_PERIOD,0 +NCONFIG:IPV6_GET_PREFIX_TIME,15 +NCONFIG:NB_CATEGORY,2 +NCONFIG:RAI,FALSE +NCONFIG:HEAD_COMPRESS,FALSE +NCONFIG:RLF_UPDATE,TRUE +NCONFIG:CONNECTION_REESTABLISHMENT,FALSE +NCONFIG:TWO_HARQ,FALSE +NCONFIG:PCO_IE_TYPE,EPCO +NCONFIG:T3324_T3412_EXT_CHANGE_REPORT,FALSE +NCONFIG:NON_IP_NO_SMS_ENABLE,FALSE +NCONFIG:SUPPORT_SMS,TRUE +NCONFIG:HPPLMN_SEARCH_ENABLE,TRUE OK AT+NCONFIG=? +NCONFIG:(AUTOCONNECT,(FALSE,TRUE)) +NCONFIG:(CR_0354_0338_SCRAMBLING,(FALSE,TRUE)) +NCONFIG:(CR_0859_SI_AVOID,(FALSE,TRUE)) +NCONFIG:(COMBINE_ATTACH,(FALSE,TRUE)) +NCONFIG:(CELL_RESELECTION,(FALSE,TRUE)) +NCONFIG:(ENABLE_BIP,(FALSE,TRUE)) +NCONFIG:(MULTITONE,(FALSE,TRUE)) +NCONFIG:(NAS_SIM_POWER_SAVING_ENABLE,(FALSE,TRUE)) +NCONFIG:(BARRING_RELEASE_DELAY,(0-1800)) +NCONFIG:(RELEASE_VERSION,(13,14)) +NCONFIG:(RPM,(FALSE,TRUE)) +NCONFIG:(SYNC_TIME_PERIOD,(0-65535)) +NCONFIG:(IPV6_GET_PREFIX_TIME,(0-65535)) +NCONFIG:(NB_CATEGORY,(1,2)) +NCONFIG:(RAI,(FALSE,TRUE)) +NCONFIG:(HEAD_COMPRESS,(FALSE,TRUE)) +NCONFIG:(RLF_UPDATE,(FALSE,TRUE)) +NCONFIG:(CONNECTION_REESTABLISHMENT,(FALSE,TRUE)) +NCONFIG:(TWO_HARQ,(FALSE,TRUE)) +NCONFIG:(PCO_IE_TYPE,(PCO,EPCO)) +NCONFIG:(T3324_T3412_EXT_CHANGE_REPORT,(FALSE,TRUE)) +NCONFIG:(NON_IP_NO_SMS_ENABLE,(FALSE,TRUE)) 上海移远通信技术股份有限公司 112 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 +NCONFIG:(SUPPORT_SMS,(FALSE,TRUE)) +NCONFIG:(HPPLMN_SEARCH_ENABLE,(FALSE,TRUE)) OK 4.18. AT+NATSPEED 配置 UART 端口波特率 该命令用于配置 UART 端口波特率。 AT+NATSPEED 配置 UART 端口波特率 设置命令 AT+NATSPEED=,,,[,[,[,]]] 查询命令 AT+NATSPEED? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NATSPEED:,,,[,] OK 测试命令 AT+NATSPEED=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NATSPEED:(支持的列表),(支持的 范围),(支持的列表),(支持的范围),(支持 的列表),(支持的范围),(支持的 列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 113 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型。表示已请求的 UART 端口的波特率。 值大于低功耗 UART 所 支持的最快速度时，将禁用深度睡眠的低功耗操作，将返回： +NATSPEED:DISABLE_DEEP_SLEEP。 整型。表示在切换回原来速度之前等待通信的时间。单位：秒。默认值：3。最大值： 30。0 表示使用默认值。 整型。表示是否将 和 存储到 NVM。 0 不存储到 NVM，重启后需要重新配置 1 存储到 NVM，超时前有交互。 整型。LP UART 同步到它检测到的每个起始位，并使用它为数据中的每个后续位配 置其最佳采样点。如果需要，'同步模式'字段允许修改此采样点。当 为 4800bps 和 57600bps 时， 不支持 3。该参数可能在以后的版本 中删除。 0 正常采样 1 稍后采样 2 提前采样 3 更早采样 整型。LP UART 停止位。 1 1 个停止位 2 个停止位 整型。AT UART 奇偶校验。 0 未启用奇偶校验 1 奇校验 2 偶校验 AT UART 软件（XON/XOFF）流控 0 禁用软件流控 1 启用软件流控 举例 AT+NATSPEED=9600,3,1,2,1 OK AT+NATSPEED? +NATSPEED:9600,2,1,0,0 OK AT+NATSPEED=? +NATSPEED:(2400,4800,9600,57600,115200,230400,460800,921600),(0-30),(0,1),(0-3),(1,2),(0-2),(0,1) OK 上海移远通信技术股份有限公司 114 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 备注 1. 如果已设置 9600 波特率和停止位或奇偶校验位，则在 AT UART 上不能设置 =1，而将 设置 =2。 2. 修改 参数时，应在 超时之前使用新的波特率参数与模块进行通信。 4.19. AT+NCCID 识别 USIM 卡 执行和查询命令都可以从 USIM 卡读取 ICCID。如果没有 USIM 卡，或者 USIM 卡不可读，则会报错， 不返回任何 USIM 卡数据。 AT+NCCID 识别 USIM 卡 执行命令 AT+NCCID 响应 +NCCID: OK 查询命令 AT+NCCID? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCCID: OK 测试命令 AT+NCCID=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 USIM 卡识别码。 上海移远通信技术股份有限公司 115 /190 举例 AT+NCCID +NCCID:44123456789012345678 OK AT+NCCID? +NCCID:44123456789012345678 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.20. AT+NFWUPD 通过 UART 更新固件 该命令支持固件更新。它允许固件包擦除、下载、固件包最后验证结果检查、固件包名和版本查询以 及固件升级。 在升级固件之前，需要首先擦除固件包区域并下载固件包。下载完成后，发送固件升级命令。然后系 统将重新启动并验证固件包，如果固件包是合法的，会开始将固件升级到新版本，否则将重新启动而不升 级，然后用户可以使用相应的 AT 命令检查固件包验证错误信息。 AT+NFWUPD 通过 UART 更新固件 设置命令 AT+NFWUPD=[,,,,] 测试命令 AT+NFWUPD=? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NFWUPD:(支持的范围) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 116 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型。固件包处理命令。 0 清除内部闪存中的固件包区域 1 ,,,。下载固件包段。下载 DFOTA 包。固件包段是 DFOTA 包的 连续段。固件包段的长度可以是任意的，但必须按顺序提供 2 获取上次更新的包验证结果 3 获取固件包名称 4 获取固件包版本 5 更新固件 整型。序列号。从 0 开始，每个包段依次递增 1。 整型。数据长度。单位：字节。 字符串类型。要传输的十六进制格式的数据。 整型。包段中每个字节的 XOR8。以十六进制形式发送。 备注 B300 或更高版本支持 =3 和 =4。 4.21. AT+NPOWERCLASS 设置 Band 和 Power Class 的映射 该命令设置频段和功率等级的映射。该查询命令列出了频段和功率等级的所有映射。 AT+NPOWERCLASS 设置 Band 和 Power Class 的映射 设置命令 AT+NPOWERCLASS=, 查询命令 AT+NPOWERCLASS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPOWERCLASS:, OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 117 /190 测试命令 AT+NPOWERCLASS=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 响应 +NPOWERCLASS:(支持的列表),(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。频段，作为映射的关键。 整型。频段的功率等级。当前仅支持级别 3、5 和 6。只有当无线处于非活动状态时 （AT+CFUN=0 将强制模块进入此状态）才能设置该参数。 Power class 3 5 6 dBm 23 20 14 备注 只有当 AT+NCONFIG 中的 RELEASE_VERSION 为 14 时， 才能被设置为 6。 4.22. AT+NPSMR 省电模式状态上报 设 置 命 令 控 制 URC +NPSMR 的 显 示 。 如 果 =1 ， 在 功 率 模 式 发 生 改 变 时 ， 则 上 报 +NPSMR:。 查询命令在 =0 时返回 +NPSMR:，在 =1 时返回 +NPSMR:,。 AT+NPSMR 省电模式状态上报 设置命令 AT+NPSMR= 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 118 /190 查询命令 AT+NPSMR? 测试命令 AT+NPSMR=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 响应 +NPSMR:[,] OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPSMR:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。启用/禁用 URC。 0 禁用 URC 1 启用 URC +NPSMR: 整型。表示 UE 的功率模式。 0 正常模式 1 省电模式 4.23. AT+NPTWEDRXS 设置 PTW 和 eDRX 设置命令控制 UE PTW 和 eDRX 参数的设置。该命令控制 UE 是否想应用 PTW 和 eDRX，以及每个 指定接入技术类型所请求的 PTW 和 eDRX 值。 当 =2 并且网络提供的 PTW 和 eDRX 参数发生变化时，设置命令还控制相关 URC 的显示。 AT+NPTWEDRXS=3 为该命令的特殊形式。在此特殊形式中，将禁用 PTW 和 eDRX，并且命令中所 有参数的数据将被删除。 查询命令返回 的当前设置。该测试命令以复合值的形式将支持的参数 和访问 技术的取值范围以及请求的 PTW 和请求的 eDRX 值返回。 上海移远通信技术股份有限公司 119 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 AT+NPTWEDRXS 设置 PTW 和 eDRX 设置命令 AT+NPTWEDRXS=,[,[,]] 查询命令 AT+NPTWEDRXS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPTWEDRXS:,,[,[,]] OK 测试命令 AT+NPTWEDRXS=? 若出现任何错误： ERROR 或者 +CME ERROR: +NPTWEDRXS:(支持的范围),(支持的列 表),(支持的范围),(支 持的范围) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。启用或禁用 UE 中请求的 PTW 和 eDRX。该参数适用于所有指定类型的接入技术， 即 的最 新设 置将 对 所有 指定 的 参数 值 生 效 。当设 置 参数 为 0 并 且 没 有 参 数 或 参 数 时，则会将省略值设置为无效值，如 0x00。 0 禁用请求的 PTW 和 eDRX 1 启用请求的 PTW 和 eDRX 2 启用请求的 PTW 和 eDRX，并且启用 URC： +NPTWEDRXP:[,[,[,[,]]]] 3 禁用 eDRX 并移除 eDRX 的所有参数。 整型。接入技术的类型。该参数用于指定接入技术类型与请求的 eDRX 值之间的关系。 5 E-UTRAN（NB-S1 模式） 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 PTW 长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 E-UTRAN DRX 周期长度 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 上海移远通信技术股份有限公司 121 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。NB-S1 模式。 位数 4 3 2 1 PTW 长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 4.24. AT+NPIN PIN 运营商 设置命令用于验证、更改、启用、禁用或解锁 PIN。执行完 PIN 命令后，将收到 URC。 USIM PIN，USIM PUK 是指 UICC 上所选应用程序的 PIN。例如，在 E-UTRAN 上下文中，当前选定 UICC 上的所选应用程序应为 USIM，而 USIM PIN 则表示所选 USIM 的 PIN。有关 UICC 应用选择的更多 详细信息，请参考 3GPP TS 31.101 [65]。 AT+NPIN PIN 运营商 设置命令 AT+NPIN=, [,] 响应 OK +NPIN: 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 122 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 +CME ERROR: 300 毫秒 参数 ,, 整型。PIN 操作模式。 PIN 操作模式 0 验证 PIN 码 1 更改 PIN 码 2 启用 PIN 码 3 禁用 PIN 码 4 解锁 PIN 码 参数随 的设置而变化。 当参数 为 0、2 和 3 时，它是参数 。 当参数 为 1 时，它是参数 。 当参数 为 4 时，它是参数 。 参数随 的设置而变化。 当 为 0、2 和 3 时，参数被省略。 当 为 1 时，它是参数 。 当 为 4 时，它是参数 。 字符串类型。十进制数。参数 应与来自 MT 用户接口设备指定 密码或者 AT+NPIN=1,, 相同。 为设备指 定的密码相同。参数 是新密码。最小长度为 4，最大长度为 8。 单位：字节。 字符串类型。十进制格式。字符串大小为 8。单位：字节。 字符串类型。表示结果。 'OK' 'ERROR PIN disabled' 'ERROR PIN blocked' 'ERROR wrong PIN ' 'ERROR wrong format' 'ERROR' 十进制数，剩余的 PIN 重试次数。如果无剩余重试次数，则 PIN 被锁定。 再次使用 PIN 之前，需要输入 AT+NPIN=4,,。 举例 AT+NPIN=0,29102394 OK +NPIN:OK 上海移远通信技术股份有限公司 123 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.25. AT+NCSEARFCN 清除存储的频点 该命令用于清除存储的频点。 AT+NCSEARFCN 清除存储的频点 执行命令 AT+NCSEARFCN 响应 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 备注 该命令必须在无线处于非活动状态时执行（AT+CFUN=0 将强制模块进入此状态）。 举例 AT+NCSEARFCN OK 4.26. AT+NIPINFO 上报 IP 地址信息 该命令用于上报 IP 地址信息。设置命令设置是否显示 URC：  如果成功获取 IP 地址，将不会响应参数 。URC 将以 +NIPINFO:,, 的格式上报。  如果获取 IP 地址失败，将不会响应参数 。URC 将以 +NIPINFO:,, 的格式上报。 查询命令返回当前设置的参数 状态。 AT+NIPINFO 上报 IP 地址信息 设置命令 AT+NIPINFO= 响应 OK 若出现任何错误，响应 上海移远通信技术股份有限公司 124 /190 查询命令 AT+NIPINFO? 测试命令 AT+NIPINFO=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 ERROR 或者 +CME ERROR: 响应 +NIPINFO: OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NIPINFO:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。 0 禁用 URC 1 启用 URC +NIPINFO:,,[],[] 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT）。 整型。指定 IP 地址的类型。 IP 互联网协议（IETF STD 5 [103]） IPV6 互联网协议，版本 6 IPV4V6 引入虚拟参数 以处理双 IP 栈 UE 容量。 字符串类型。IP 地址。IPv4 地址为点分十进制，例如 100.1.0.26。IPv6 地址，以 十六进制数和冒号表示，例如 108F: 0: 0: 0: 8: 800: 200C: 417A。当地址获取失败 时，该参数不显示。 整型。获取 IP 地址失败的原因。 1 仅允许 PDN 类型 IPv4 2 仅允许 PDN 类型 IPv6 3 仅允许单地址承载 4 IPv6 RA 超时 5 未指定 上海移远通信技术股份有限公司 125 /190 举例 AT+NIPINFO=1 OK AT+NIPINFO? +NIPINFO:1 OK AT+NIPINFO=? +NIPINFO:(0,1) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.27. AT+NCPCDPR 配置要读取的 PDP 上下文动态参数 该命令可以配置需要读取的 PDP 上下文动态参数。 AT+NCPCDPR 配置要读取的 PDP 上下文动态参数 设置命令 响应 AT+NCPCDPR=, OK 查询命令 AT+NCPCDPR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCPCDPR:, [+NCPCDPR:,] [...] OK 测试命令 AT+NCPCDPR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCPCDPR:(支持的列表),(支持的列表) OK 若出现任何错误： 上海移远通信技术股份有限公司 126 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。要读取的动态参数。 0 获取 DNS 服务器 IPv4 地址请求 1 获取 DNS 服务器 IPv6 地址请求 整型。PDP 上下文动态参数读取状态。 0 禁用获取 1 启用获取 备注 该命令必须在无线处于非活动状态时执行（AT+CFUN=0 将强制模块进入此状态）。 举例 AT+NCPCDPR=1,1 OK AT+NCPCDPR? +NCPCDPR:0,1 +NCPCDPR:1,1 OK AT+NCPCDPR=? +NCPCDPR:(0,1),(0,1) OK 上海移远通信技术股份有限公司 127 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.28. AT+NQPODCP 通过控制面查询待处理的原始数据列表 该命令由 UE 通过控制平台查询待处理的原始数据列表。 AT+NQPODCP 通过控制面查询待处理的原始数据列表 执行命令 AT+NQPODCP= 响应 [+NQPODCP:[[...]]] OK 测试命令 AT+NQPODCP=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NQPODCP:(支持的范围) OK 300 毫秒 参数 整型。指定某个 PDP 上下文定义（请参考 +CGDCONT 命令）。 整型。待处理的原始消息序列号。范围：1-255。 备注 参数支持 0 到 10 之间的值。 举例 AT+NQPODCP=1 +NQPODCP:1,2,3 OK AT+NQPODCP=? +NQPODCP:(0-10) OK 上海移远通信技术股份有限公司 128 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.29. AT+NITZ 设置时间更新模式 该命令设置时间更新模式。查询命令会返回 UE 中的当前时间更新模式。 如果由于 UE 发生错误而导致设置失败，则返回 +CME ERROR:。 AT+NITZ 设置时间更新模式 设置命令 AT+NITZ= 响应 OK 查询命令 AT+NITZ? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NITZ: OK 测试命令 AT+NITZ=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NITZ:(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。表示时间更新模式。 0 通过本地时间更新时间 1 通过 NITZ 更新时间 上海移远通信技术股份有限公司 129 /190 举例 AT+NITZ=1 OK AT+NITZ? +NITZ:1 OK AT+NITZ=? +NITZ:(0,1) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.30. AT+QLEDMODE 设置 NETLIGHT 功能模式 该命令用于设置 NETLIGHT LED 指示灯的功能模式。 AT+QLEDMODE 设置 NETLIGHT 功能模式 设置命令 AT+QLEDMODE= 响应 OK 查询命令 AT+QLEDMODE? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLEDMODE: OK 测试命令 AT+QLEDMODE=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLEDMODE:(支持的列表) OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 130 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 +CME ERROR: 300 毫秒 参数 整型。NETLIGHT LED 指示灯的功能模式。 0 禁用 NETLIGHT LED 功能，NETLIGHT 引脚输出低电平。 1 启用 NETLIGHT LED 功能，NETLIGHT 引脚输出 PWM 信号。不同的高电平持续 时间和低电平持续时间表示不同的网络状态。 高电平持续时间 低电平持续时间 网络状态 64 毫秒 800 毫秒 网络搜索 64 毫秒 2000 毫秒 连接状态 备注 如果启用 NETLIGHT LED 指示灯功能，可能导致模块消耗更多电量。 举例 AT+QLEDMODE=1 OK 4.31. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置和查询 DNS 服务器地址。查询命令返回当前使用的 DNS 服务器地址。 AT+QIDNSCFG 配置 DNS 服务器地址 设置命令 AT+QIDNSCFG=[,] 查询命令 AT+QIDNSCFG? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 PrimaryDns: SecondaryDns: OK 上海移远通信技术股份有限公司 131 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 测试命令 AT+QIDNSCFG=? 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 参数 字符串类型。表示首选域名服务器地址。 字符串类型。表示备用域名服务器地址。 备注 1. 在执行 AT+QDNS 命令过程中，不允许配置 DNS 服务器地址。 2. 如果未配置 DNS 服务器地址，则默认将使用基站提供的 DNS 服务器地址。 举例 AT+QIDNSCFG=? OK AT+QIDNSCFG? PrimaryDns: 218.4.4.4 SecondaryDns: 208.67.222.222 OK AT+QIDNSCFG=8.8.8.8,8.8.4.4 OK AT+QIDNSCFG? PrimaryDns: 8.8.8.8 SecondaryDns: 8.8.4.4 OK 上海移远通信技术股份有限公司 132 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.32. AT+QDNS 触发 DNS 域名解析 该命令用于触发 DNS 域名解析。当域名解析完成后，UE 将显示域名解析的结果：+QDNS:。 如果未返回域名解析结果，再执行该设置命令，则会上报 ERROR。 AT+QDNS 触发 DNS 域名解析 设置命令 AT+QDNS=[,] 响应 OK +QDNS: 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。 0 DNS 域名解析，主机名不能为空。 1 如果主机名不为空，则清除内存中的主机名解析数据和 KV。如果主机名为空， 则将清除所有解析数据。 2 DNS 域名解析，主机名不能为空。模块不缓存解析结果。 域名。 域名解析的结果。 IP 域名解析完成相应的 IP 地址 FAIL 域名解析失败 举例 AT+QDNS=0,www.baidu.com OK +QDNS:111.13.100.91 上海移远通信技术股份有限公司 133 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.33. AT+QCHIPINFO 读取系统信息 该命令用于返回系统信息，包括温度和电池电压。 AT+QCHIPINFO 读取系统信息 设置命令 AT+QCHIPINFO= 响应 +QCHIPINFO:, [+QCHIPINFO:,] OK 测试命令 AT+QCHIPINFO=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QCHIPINFO:(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 要读取的系统信息。 ALL 返回所有数据 TEMP 模块的当前温度，单位：摄氏度 VBAT 电池电压，单位：mV 整型。与参数 对应的整数值。 举例 AT+QCHIPINFO=ALL +QCHIPINFO:TEMP,30 +QCHIPINFO:VBAT,3816 OK AT+QCHIPINFO=? 上海移远通信技术股份有限公司 134 /190 +QCHIPINFO:(ALL,TEMP,VBAT) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.34. AT+QCFG 扩展配置设置 该命令用于查询和配置 UE 的各种设置。 AT+QCFG 扩展配置设置 测试命令 AT+QCFG=? 响应 OK 查询命令 AT+QCFG? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 4.34.1. AT+QCFG='LWM2M/Lifetime' 配置华为 IoT 平台注册生命周期 该命令用于配置华为 IoT 平台的生命周期值。UE 的更新注册时间约为生命周期的 0.9 倍。 AT+QCFG='LWM2M/Lifetime' 配置华为 IoT 平台注册生命周期 设置命令 AT+QCFG='LWM2M/Lifetime'[,] 响应 如果指定参数，则配置平台的生命周期值： OK 如果省略参数，则查询平台的生命周期值： +QCFG: 'LWM2M/Lifetime', OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 135 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 或者 +CME ERROR: 300 毫秒 参数 整型。LwM2M 协议的生命周期。单位：秒。范围：0-30x86400。默认生命周期值为 86400。 0 禁用生命周期功能。UE 将不会定期向华为 loT 平台发送更新注册包。 1-30x86400 启用生命周期功能。但即使 UE 将生命周期值设置为 1-899 秒， 的最小有效值仍是 900 秒。 举例 AT+QCFG='LWM2M/lifetime' +QCFG: 'LWM2M/Lifetime',86400 OK AT+QCFG='LWM2M/lifetime',900 OK 4.34.2. AT+QCFG='LWM2M/EndpointName' 配置接入 IoT 平台时的 Endpoint Name 该命令用于配置接入 IoT 平台时的 Endpoin 名称（Endpoint Name），若没有配置，则使用的 IMEI 号 为默认值 AT+QCFG='LWM2M/EndpointName' 配置接入 IoT 平台时的 Endpoint Name 设置命令 AT+QCFG='LWM2M/Lifetime'[,] 响应 如果指定参数 ，则配置接入 IoT 平台的 Endpoint Name： OK 如果省略参数 ，则查询接入 IoT 平台的 Endpoint Name： +QCFG: 'LWM2M/EndpointName', OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 136 /190 参数 BC35-G&BC28&BC95 R2.0 AT 命令手册 字符串格式。LwM2M 客户端标识符。 举例 AT+QCFG='LWM2M/EndpointName','1234567890' OK AT+QCFG='LWM2M/EndpointName' +QCFG: 'LWM2M/EndpointName','1234567890' OK 4.34.3. AT+QCFG='LWM2M/BindingMode' 配置接入 IoT 平台时的绑定模式 该命令用于配置接入 IoT 平台时的绑定模式，默认为 UDP 模式 AT+QCFG='LWM2M/BindingMode' 配置接入 IoT 平台时的绑定模式 设置命令 AT+QCFG='LWM2M/BindingMode'[, ] 响应 如果指定参数 ，则配置接入 IoT 平台的绑定 模式： OK 如果省略参数 ，则查询当前接入 IoT 平台的 绑定模式： +QCFG: 'LWM2M/BindingMode', OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。LwM2M 协议的绑定模式。 1 UDP 模式 2 UDP queue 模式 上海移远通信技术股份有限公司 137 /190 举例 AT+QCFG='LWM2M/ BindingMode ' +QCFG: 'LWM2M/BindingMode',1 OK AT+QCFG='LWM2M/BindingMode',2 OK AT+QCFG='LWM2M/BindingMode' +QCFG: 'LWM2M/BindingMode',2 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.35. AT+NSNPD 发送 Non-IP 数据 TE 使用设置命令通过 MT 将 Non-IP 数据通过控制面或用户面发送到网络。上下文标识符 用于 将数据链接到特定上下文。该命令还可选地指示要传输的数据是否是异常数据。 该命令可发送 ESM DATA TRANSPORT 消息，如 3GPP TS 24.301 [83] 中所定义的一样。 如果未省略 ，则当服务器确认数据报或 UE 丢弃时，将上报如下 URC： +NSNPDR:,,。 AT+NSNPD 发送 Non-IP 数据 设置命令 AT+NSNPD=,,[,[,[,]]] 测试命令 AT+NSNPD=? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSNPD:(支持的范围),(支持的 列表),(支持的列表),(支持的列 表),(支持的范围) OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 138 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 +CME ERROR: 300 毫秒 参数 整型。指定某个 PDP 上下文或 EPS 承载上下文定义。 参数是 TE-MT 接口的本地参数，用于识别通过 AT 命令设置的 PDP 或 EPS 承载上下文（参 考 AT+CGDCONT 命令）。 整型。指示 信息元素的字节数。当没有数据要传输时，该 值应设置为零。 八位字节的字符串。包含用户数据内容（参考 3GPP TS 24.301 [83]子条款 9.9.4.24）。当没有数据要传输时， 应为空字符串（''）。 此参数不应按照 AT+CSCS 进行常规字符转换。用户数据容器的编码格式 和 的最大长度是特定实现的。 整型。释放辅助指示的值，参考 3GPP TS 24.301 [83]子条款 9.9.4.25。 0 无指示 1 ESM DATA TRANSPORT 消息传输后不期望有进一步上下行数据， 核心网可立即释放 2 接收最后的 ESM DATA TRANSPORT 消息后完成数据交换，核心网 在下发后立即释放 整型。指示传输的用户数据是常规还是异常。 0 常规数据 1 异常数据 数据序列。范围 1-255。如果省略，将不上报数据发送状态。 数据报的状态。 0 错误 1 已发送 备注 1. 使用 Non-IP 时，最大数据长度为 1358 字节，否则为 0。 2. 任何时候只能缓冲一条消息。 举例 AT+NSNPD=? +NSNPD:(0-10),(0),(0,1,2),(0,1),(1-255) OK 上海移远通信技术股份有限公司 139 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.36. AT+NRNPDM 设置 Non-IP 数据模式上报 设置命令用于启用和禁用从网络到 MT 的 Non-IP 数据上报，MT 通过控制面或用户面在下行链路方向 传输。如果启用了上报，则 MT 会在从网络接收数据时返回如下 URC： +NRNPDM:,,。 查询命令返回当前设置。 AT+NRNPDM 设置 Non-IP 数据模式上报 设置命令 AT+NRNPDM= 响应 OK 查询命令 AT+NRNPDM? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NRNPDM: OK 测试命令 AT+NRNPDM=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NRNPDM:(支持的范围),(支持的范围),(由 指示的用户数据的最大八位字节数) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型，控制 MT Non-IP 数据事件报告。 0 禁用 MT Non-IP 数据报告 上海移远通信技术股份有限公司 140 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 1 通过 URC +NRNPDM 启用 MT Non-IP 数据报告 整型。数字参数，指定某个 PDP 上下文或 EPS 承载上下文定义。 参数 是 TE-MT 接口的本地参数，用于识别通过 AT 命令设置的 PDP 或 EPS 承载上 下文（参考 AT+CGDCONT 命令）。 整型。指示 信息元素的字节数。当没有数据要传输时，该值 应设置为零。 八位字节字符串。包含用户数据容器内容（参考 3GPP TS 24.301 [83]子条款 9.9.4.24）。当没有数据要传输时， 应为空字符串（''）。 此参数不应按照 AT+CSCS 进行常规字符转换。用户数据容器的编码格式和 的最大长度是特定实现的。 备注 1. 使用 Non-IP 时，最大数据长度为 1358 字节，否则为 0。 2. 任何时候只能缓冲一条消息。 3. 在启用上报之前下行数据将被丢弃。 举例 AT+NRNPDM=1 OK AT+NRNPDM? +NRNPDM:1 OK AT+NRNPDM=? +NRNPDM:(0-1),(0-10),(0) OK 4.37. AT+NQPNPD 查询待处理的 Non-IP 数据列表 此命令由 MT 通过控制面或用户面查询待处理的 Non-IP 数据列表。 AT+NRNPDM 查询待处理的 Non-IP 数据列表 设置命令 AT+NQPNPD= 响应 [+NQPNPD:[[…]]] OK 若出现任何错误： 上海移远通信技术股份有限公司 141 /190 测试命令 AT+NQPNPD=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 ERROR 或者 +CME ERROR: 响应 +NQPNDP:(支持的范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT 命令）。 待发送 Non-IP 数据消息的序列。范围 1-255。 备注 支持 0 到 10 之间的值。 举例 AT+NQPNPD=? +NQPNPD:(0-10) OK 4.38. AT+NSOSTATUS 获取 Socket 状态 设置命令返回指定 对应的 Socket 状态信息，执行命令返回所有的 Socket 状态的清单。 AT+NSOSTATUS 获取 Socket 状态 设置命令 AT+NSOSTATUS= 响应 +NSOSTATUS:[,[]] OK 上海移远通信技术股份有限公司 142 /190 执行命令 AT+NSOSTATUS 测试命令 AT+NSOSTATUS=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+NSOSTATUS:[,[]] [+NSOSTATUS:[,[]] [...] +NSOSTATUS:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSOSTATUS:(支持的列表) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 Socket 编号。 整型。 0 可用的 1 不存在（如果 Socket 未绑定到分配的正确 IP 地址 NW，也会返回此状态） 2 流量控制 3 退避 退避定时器/T3396 定时器剩余时间。仅在退避状态时显示。单位：秒。 备注 Socket 0 用于 CoAP，如果支持 CoAP，启动时将自动创建 Socket 0。 上海移远通信技术股份有限公司 143 /190 举例 AT+NSOSTATUS=1 +NSOSTATUS:1,0 OK AT+NSOSTATUS +NSOSTATUS:0,0 +NSOSTATUS:1,0 +NSOSTATUS:2,1 +NSOSTATUS:3,1 +NSOSTATUS:4,1 +NSOSTATUS:5,1 +NSOSTATUS:6,1 OK AT+NSOSTATUS=? +NSOSTATUS:(0-6) OK BC35-G&BC28&BC95 R2.0 AT 命令手册 4.39. AT+NCIDSTATUS 获取状态 设置命令返回指定 的 PDP 上下文状态，执行命令返回所有已定义 PDP 上下文的状态。 AT+NCIDSTATUS 获取状态 设置命令 AT+NCIDSTATUS= 响应 +NCIDSTATUS:[,[]] OK 执行命令 AT+NCIDSTATUS 若出现任何错误： ERROR 或者 +CME ERROR: 响应 [+NCIDSTATUS:[,[]] [+NSOSTATUS:[,[]] [...] OK 上海移远通信技术股份有限公司 144 /190 测试命令 AT+NCIDSTATUS=? 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NCIDSTATUS:(支持的范围) OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT 命令）。 整型。 0 可用的 1 不存在（如果 PDP 上下文处于非活动状态，也会返回此状态）。 2 流量控制 3 退避 退避定时器/ T3396 定时器剩余时间（以秒为单位）。仅在退避状态时显示。 举例 AT+NCIDSTATUS=0 +NCIDSTATUS:0,0 OK AT+NCIDSTATUS +NCIDSTATUS:0,0 OK AT+NCIDSTATUS=0 +NCIDSTATUS:0,0 OK 上海移远通信技术股份有限公司 145 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 4.40. AT+NGACTR 上报 PDP 上下文激活或去激活结果 设置命令控制 URC +NGACTR 的显示。 如果 =1，则在 PDP 上下文激活或去激活完成时从 MT 发送 +NGACTR:。 AT+NGACTR 上报 PDP 上下文激活或去激活结果 设置命令 AT+NGACTR= 响应 OK 查询命令 AT+NGACTR? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NGACTR: OK 测试 AT+NGACTR=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NGACTR:(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。 0 禁用 URC 1 启用 URC +NGACTR:,, 整型。指定某个 PDP 上下文定义（请参考 AT+CGDCONT 命令）。 整型。表示 PDP 上下文激活的状态。默认值是制造商特定的。 0 去激活 上海移远通信技术股份有限公司 146 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 1 激活 整型。表示 PDP 上下文激活或去激活的结果。 0 成功 1 失败原因：未定义上下文 2 失败原因：上下文已激活 3 失败原因：上下文未激活 4 失败原因：资源错误 5 失败原因：本地拒绝 6 失败原因：APN 错误 7 失败原因：APN 退避运行 8 失败原因：仅 IPv4 9 失败原因：仅 IPv6 10 失败原因：仅 IP 11 失败原因：仅 Non-IP 12 失败原因：仅单 IP 13 失败原因：服务错误 14 失败原因：达到最大连接数 15 失败原因：请求重新激活 16 失败原因：不允许最后一个 PDN 断开连接 17 失败原因：未知 18 失败原因：不允许 NSLPI 重写 19 失败原因：正在附着 举例 AT+NGACTR=0 OK AT+NGACTR? +NGACTR:0 OK AT+NGACTR=? +NGACTR:(0,1) OK 4.41. AT+NUICC 设置 UICC 功耗模式 该命令用来打开/关闭 UICC。仅当 AT+NCONFIG 的配置项 NAS_SIM_POWER_SAVING_ENABLE 为真时才可使用，使用 AT+CSIM 和 AT+CRSM 命令时会用到该功能。使用该命令可能会影响开机时的功 耗。如果设置失败，则返回 +CME ERROR:。 上海移远通信技术股份有限公司 147 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 AT+NUICC 设置 UICC 功耗模式 设置命令 AT+NUICC= 响应 OK 测试命令 AT+NUICC=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NUICC:(支持的列表) OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。UICC 功耗模式。 0 下电 1 上电 举例 AT+NUICC=1 OK AT+NUICC=? OK 上海移远通信技术股份有限公司 148 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5 LwM2M 物联网平台命令 本章节描述了模块针对 LwM2M 物联网平台的 AT 命令。使用本章 AT 命令可用于对接中国电信物联网 平台和华为 OceanConnect 平台等物联网平台。 5.1. AT+NCDP 配置和查询 CDP 服务器设置 该命令用来设置和查询 CDP 服务器的 IP 地址和端口号。当网络服务器应用程序网关是海思 CDP 或者 华为物联网平台时，可使用该命令。 AT+NCDP 配置和查询 CDP 服务器设置 设置命令 AT+NCDP=[,] 响应 从提供的参数中更新 CDP 服务器配置： OK 查询命令 AT+NCDP? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 返回当前 CDP 服务器 IP 地址和端口号： +NCDP: , OK 最大响应时间 若未设置 CDP 服务器： ERROR 或者 +CME ERROR: 300 毫秒 参数 IoT 平台 IP 地址。支持 IPv4、Ipv6 和域名。最大不超过 256 字节。 整型。无符号整型。范围：0-65535。默认值：5683。若配置端口为 0，则使用默认端 上海移远通信技术股份有限公司 149 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 口；若没有指定端口，则使用之前设置的端口；若没有指定端口且之前未设置，则使用 默认端口。 备注 1. IMEI 号已被设置后，此设置命令才可用。 2. 修改将在注网成功之前生效。 举例 AT+NCDP=192.168.5.1,5683 OK AT+NCDP? +NCDP: 192.168.5.1,5683 OK 5.2. AT+QSECSWT 设置数据加密模式 该命令用来设置数据加密模式以及标准 DTLS 会话超时重新协商间隔。 AT+QSECSWT 设置数据加密模式 设置命令 响应 AT+QSECSWT=[,] OK 查询命令 AT+QSECSWT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QSECSWT: [,] OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 150 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 加密模式类型。 0 不加密 1 标准 DTLS 加密模式 2 DTLS+加密模式 NAT 类型，仅在标准 DTLS 加密模式下有效 0 使能 NAT，重新协商间隔时间为 30 秒 1 禁用 NAT 和重新协商 备注 只有在标准 DTLS 加密模式下（=1），参数 才有效。 举例 AT+QSECSWT=0 OK AT+QSECSWT=1,1 OK AT+QSECSWT? +NSECSWT: 1,1 OK 5.3. AT+QSETPSK 设置 PSK ID 和 PSK 该命令用来配置 PSK ID 和 PSK。该命令在重启后即生效。 AT+QSETPSK 设置 PSK ID 和 PSK 设置命令 AT+QSETPSK=, 响应 OK 查询命令 AT+QSETPSK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QSETPSK: , 上海移远通信技术股份有限公司 151 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 OK 若出现任何错误： ERROR 或者 +CME ERROR: 2秒 参数 PSK 索引。十进制数字。固定长度为 15 位数。该值必须和设备 IMEI 值相同。另外，该值 也必须和 IoT 平台设置的值保持一致。当 被设置为 0，则 IMEI 被用作 PSKID。 表示 PSK。十六进制数字。固定长度 16 位数。另外，该值必须和华为 IoT 平台设置为同 样的值。 举例 AT+QSETPSK= 867724030000225,E8E19CC16CE1F388E8E19CC16CE1F388 OK AT+QSETPSK? +QSETPSK: 867724030000225,*** OK 5.4. AT+QLWSREGIND 注册控制 该命令用来控制模块向 IoT 平台发起注册和注销。若消息未能发送，则返回 错误码和描述作为 中间消息。 AT+QLWSREGIND 注册控制 设置命令 AT+QLWSREGIND= 响应 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 152 /190 参数 整型。动作类型。 0 触发注册操作 1 触发注销操作 举例 AT+QLWSREGIND=0 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 5.5. AT+QLWULDATA 发送数据 该命令使用 LwM2M 协议向 IoT 平台发送数据。若消息未能发送，则返回 错误码及描述作为中 间消息。在模块注册到 IoT 平台之前，执行该命令则会触发注册操作并丢弃数据。 AT+QLWULDATA 发送数据 设置命令 AT+QLWULDATA=,[, ] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 参数 整型。表示发送数据的长度。 字符串类型。十六进制格式。最大发送数据长度为 1024 字节。 数据序列号。范围：0-255。如果使用非 0 的 来发送 CoAP 数据，且 当前有携带相同 的 NON 或者 CON 类型 CoAP 数据未发送完成，那 么会将数据丢弃并返回错误。 举例 AT+QLWULDATA=3,AA34BB OK 上海移远通信技术股份有限公司 153 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5.6. AT+QLWULDATAEX 发送 CON/NON 消息 该命令根据 LwM2M 协议使用 RAI 标识符向物联网平台发送需要确认的消息（CON）或者不需要确认 的消息（NON）。发送 CON 数据后，发送结果会自动反馈给 TE，TE 也可以使用命令 AT+QLWULDATA STATUS? 来查询已发送 CON 数据的状态。如果发送 CON 数据，它必须在发送下一个 CON 或者 NON 数据之前获取发送 CON 数据的状态（失败/超时/成功/获得重置消息）。如果模块尚未注册到 NB-IoT 平台， 则该命令将使模块仅启动注册，模块将丢弃发送的数据。 AT+QLWULDATAEX 发送 CON/NON 消息 设置命令 AT+QLWULDATAEX=,,[,] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 参数 整型。表示发送数据的长度。 十六进制格式字符串类型。最大发送数据长度为 1024 字节。 消息发送模式。 0x0000 表示发送 NON 消息。 0x0001 表示发送带有 RELEASE 释放辅助提示的 NON 消息。 0x0010 表示发送带有 RELEASE_AFTER_REPLY 释放辅助提示的 NON 消息。 0x0100 表示发送 CON 消息。 0x0101 表示发送带有 RELEASE_AFTER_REPLY 释放辅助提示的 CON 消息。 数据序列号。范围：0-255。如果使用非 0 的 发送 CoAP 数据，且当前有 携带相同 的 NON 或者 CON 类型 CoAP 数据未发送完成，那么会将数据 丢弃并返回错误。如果参数值为 0，则它被忽略。 举例 AT+QLWULDATAEX=3,AA34BB,0x0001 OK 上海移远通信技术股份有限公司 154 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5.7. AT+QLWULDATASTATUS 查询 CON 消息发送状态 此命令查询向 NB-IoT 平台发送 CON 数据的状态。此命令仅查询已发送的 CON 数据的状态。 当发送 CON 类型 CoAP 数据时携带了非 0 的 ，该命令的响应为：+QLWULDATASTATUS: ,；当发送 CON 类型 CoAP 数据时没有携带 或者携带的 为 0，该命令的响应为：+QLWULDATASTATUS: 。 AT+QLWULDATASTATUS 查询 CON 消息发送状态 查询命令 AT+QLWULDATASTATUS? 响应 +QLWULDATASTATUS: [,] OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。表示 CON 数据发送状态。 0 未发送 1 已发送，等待 IoT 平台响应 2 发送失败 3 超时 4 成功 5 收到 RESET 消息 数据序列。范围：0-255。若 参数值为 0 则被忽略。 举例 AT+QLWULDATASTATUS? +QLWULDATASTATUS: 4 OK 上海移远通信技术股份有限公司 155 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5.8. AT+QLWFOTAIND 设置 DFOTA 升级模式 该命令用来设置 DFOTA 升级模式，可以设置为下面任意一种模式：  自动模式：MCU 无需执行命令，可自动完成基于 DFOTA 的下载和升级。  受控模式：MCU 执行该命令去控制是否下载或升级固件。 受 控 模 式 下 ， 收 到 URC +QLWEVTIND: 6 （ 即 收 到 了 ' put package URI' 消 息 ） 或 者 URC +QLWEVTIND: 7（即收到了'update'消息）后，MCU 使用该命令控制是否下载或者升级固件。 AT+QLWFOTAIND 设置 DFOTA 升级模式 设置命令 响应 AT+QLWFOTAIND= OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。表示 DFOTA 升级模式。 0 使用自动 DFOTA 升级模式 1 使用受控 DFOTA 升级模式 2 MCU 通知模块开始下载版本文件 3 MCU 通知模块取消下载版本文件 4 MCU 通知模块开始升级 5 MCU 通知模块取消升级 举例 AT+QLWFOTAIND=1 OK 5.9. AT+QREGSWT 设置注册模式 该命令用于在重启模块后设置注册模式：  若 设置为 0，模块在重启并连接到网络后会发送 REGISTERNOTIFY 消息到设备，然后 上海移远通信技术股份有限公司 156 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 通过执行命令 AT+QLWSREGIND 触发注册。  若 设置为 1，模块在重启并连接到网络后会触发自动注册。  若 设置为 2，模块在重启并连接到网络后不会触发注册。 AT+QREGSWT 设置注册模式 设置命令 AT+QREGSWT= 响应 OK 查询命令 AT+QREGSWT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QREGSWT: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。表示注册模式。 0 手动注册模式 1 自动注册模式 2 禁用注册 备注 1、 如果不需要使用物联网平台，必须使用命令 AT+QREGSWT=2 禁用注册功能。该命令只有在使用 AT+NRB 重启 UE 后才生效，若不禁用注册功能会使 UE 从网络中分离，造成相关服务（例如 TCP/UDP） 失败。 2、 对于 Band 8 单频段的软件 ONT 版本，从 B300SP7 版本开始，默认关闭连接 IoT 平台功能，即 AT+QREGSWT=2，具体请参照对应版本的 RN。 举例 AT+QREGSWT=1 OK 上海移远通信技术股份有限公司 157 /190 AT+QREGSWT? +QREGSWT: 1 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 5.10. AT+NMGS 发送消息 该命令用来发送数据到华为 IoT 平台。若消息未能发送会返回 错误码及描述作为中间消息。如 果模块尚未注册到物联网平台，执行该命令将会促使模块发起注册，并丢弃数据。 AT+NMGS 发送消息 设置命令 AT+NMGS=,[,] 响应 OK 如出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 参数 消息的长度。十进制。最大为 1024。 待传输的数据。字符串类型。十六进制格式。待发数据最大长度是 1024 字节。 数据序列号。范围：0-255。如果使用非 0 的 发送 CoAP 数据，且当前有 携带相同 的 NON 或者 CON 类型 CoAP 数据未发送完成，那么会将数据 丢弃并返回错误。 举例 AT+NMGS=3,AA11BB OK 上海移远通信技术股份有限公司 158 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5.11. AT+NMGR 接收消息 该命令用于通过 LwM2M 协议从华为 IoT 平台接收消息。 该命令返回最先缓存的消息并从缓存中删除它，如果没有缓存消息，则该命令无响应；如果使能新消 息指示（AT+NNMI），执行该命令将无法获取收到的消息。 AT+NMGR 接收消息 执行命令 AT+NMGR 响应 , OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 消息长度。十进制。最大为 1024。 接收数据。十六进制格式。接收最大长度是 1024 字节。 举例 AT+NMGR 5,48656C6C6F OK 5.12. AT+NNMI 设置新消息指示 该命令用来设置或者获取已发送的新消息指示。UE 从 IoT 平台接收到一个下行消息后会发送新消息指 示。 AT+NNMI=1 使能新消息指示和数据，会返回当前所有缓存的消息，格式为 +NNMI: ,。 例如，+NNMI: 5,48656C6C6F。 AT+NNMI=2 仅使能新消息指示，每次收到新的消息都会触发指示 URC，响应结果格式为：+NNMI。 上海移远通信技术股份有限公司 159 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 可以通过命令 AT+NMGR 接收缓存消息。 默认值为 1，模块重启后 会还原到默认值。 AT+NNMI 设置新消息指示 设置命令 AT+NNMI= 响应 OK 查询命令 AT+NNMI? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NNMI: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 新消息指示状态。 0 无指示 1 指示和消息 2 仅指示 表示消息长度。十进制格式。 表示待接收的数据。十六进制格式。 举例 AT+NNMI=1 OK AT+NNMI? +NNMI: 1 OK 上海移远通信技术股份有限公司 160 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5.13. AT+NSMI 发送消息指示 当发送一条上行消息至 IoT 平台时，使用该命令设置或者获取已发送消息的指示。 如 果 开 启 了 发 送 消 息 指 示 ， 当 有 新 消 息 发 送 到 NB-IoT 栈 时 ， 会 返 回 URC ： +NSMI: [,]（例如：+NSMI: SENT）。 只有当发送数据的 AT 命令中包含非 0 参数 ，模块发送到 MCU 的通知消息中才会包含参 数 ，且该参数值与发送数据的 AT 命令中的 一致。 当发送 CoAP 数据的 AT 命令中包含非 0 参数 ，且 CoAP 数据成功发送到 NB-IoT 平台， 模块发送到 MCU 的通知消息中参数 值为 SENT_TO_AIR_INTERFACE；如果上述的命令中没 有参数 或者参数 值为 0 且 CoAP 数据成功发送到 NB-IoT 平台，模块发送到 MCU 的通知消息中参数 值为 SENT。 对于 CON 数据来说，SENT 和 SENT_TO_AIR_INTERFACE 说明发送数据到 NB-IoT 平台的结果；对 于 NON 数据来说，SENT 说明数据发送到 C 核；SENT_TO_AIR_INTERFACE 说明数据发送到基站的空 口。 AT+NSMI 发送消息指示 设置命令 AT+NSMI= 响应 OK 查询命令 AT+NSMI? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NSMI: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 0 不发送指示 1 发送指示 上海移远通信技术股份有限公司 161 /190 举例 AT+NSMI=1 OK AT+NSMI? +NSMI: 1 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 SENT SENT_TO_AIR_INTERFACE DISCARDED 数据序列。范围：1-255。表示 AT 命令中携带的非 0 的 向 loT 平台 发送数据。 5.14. AT+NQMGR 查询已接收消息状态 该命令用来查询从 IoT 平台已接收下行消息的状态。 AT+NQMGR 查询已接收消息状态 执行命令 AT+NQMGR 响应 BUFFERED=,RECEIVED=,DROPPE D= OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 举例 AT+NQMGR 下行缓存中等待读取的消息条数。 UE 启动后收到的消息总数。 UE 启动后丢弃的消息条数。 上海移远通信技术股份有限公司 162 /190 BUFFERED=0,RECEIVED=34,DROPPED=2 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 5.15. AT+NQMGS 查询发送的消息状态 该命令用来查询已发送到 IoT 平台上行消息的状态。 AT+NQMGS 查询发送的消息状态 执行命令 AT+NQMGS 响应 PENDING=,SENT=,ERROR= OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 上行缓存中等待发送的消息条数。 UE 启动后，发送到 NB-IoT 平台的上行消息总数。 UE 启动后，因错误被丢弃的消息条数。 备注 1. 对于 CON 类型 CoAP 数据，只有当 timeout、RST、sent_fail 或者 sent_success 之后，相应统计值 才会改变； 2. 对于 NON 类型 CoAP 数据，如果发送数据时携带了非 0 的 ，在数据发送到空口时，才 会相应统计值才会改变；如果发送数据时没有携带 或者携带的 为 0，在 数据发送到 C 核时相应统计值就会改变。 举例 AT+NQMGS PENDING=1,SENT=34,ERROR=0 OK 上海移远通信技术股份有限公司 163 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5.16. AT+NMSTATUS 消息注册状态 当模块连接到 CDP 服务器时，该命令用来上报当前注册状态。当 LwM2M 处于 MO_DATA_ENABLED 状态，则 UE 可以发送数据。 AT+NMSTATUS 消息注册状态 测试命令 AT+NMSTATUS=? 响应 (支持的列表) 查询命令 AT+NMSTATUS? OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NMSTATUS: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 当前注册状态 UNINITIALISED MISSING_CONFIG INIITIALISING INIITIALISED INIT_FAILED REGISTERING REGISTERED DEREGISTERED MO_DATA_ENABLED NO_UE_IP REJECTED_BY_SERVER TIMEOUT_AND_RETRYING REG_FAILED DEREG_FAILED 未初始化 配置丢失 初始化中 初始化完成 初始化失败 注册中 已注册 已注销 使能数据发送 无UE IP 服务器拒绝 超时并重试 注册失败 注销失败 上海移远通信技术股份有限公司 164 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 5.17. +QLWEVTIND LwM2M 事件上报（仅用于响应） 模块向设备上报 LwM2M 事件。 +QLWEVTIND LwM2M 事件上报（仅用于响应） URC 格式 +QLWEVTIND: 参数 整型。事件类型。 0 注册完成 1 注销完成 2 注册状态更新 3 订阅对象 19/0/0 完成 4 Bootstrap 完成 5 5/0/3 资源订阅完成 6 通知设备接收更新包 URL 7 通知设备下载完成 9 取消订阅对象 19/0/0 5.18. AT+QRESETDTLS 重置 DTLS 模式 该命令用来重置 DTLS 模式：  若 DTLS 完成握手或者重新协商，可用该命令设置 DTLS 状态为 INIT 状态，在下次发送数据时会 执行握手过程。  若当前 DTLS 的状态是正在握手或者正在进行重新协商，该命令会直接返回 OK，下次发送数据时 不会触发握手过程。 AT+QRESETDTLS 重置 DTLS 模式 执行命令 AT+QRESETDTLS 响应 OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 165 /190 举例 AT+QRESETDTLS OK BC35-G&BC28&BC95 R2.0 AT 命令手册 5.19. AT+QDTLSSTAT 查询 DTLS 状态 该命令用来查询 DTLS 当前链路状态。在每 8 秒发送一次上行数据的情况下，若 DTLS 未协商，则 DTLS 状态无法查询。  若 DTLS 协商可以在 8 秒内完成，那么可在协商完成后查询 DTLS 状态；  无论是模块通电后自动注册还是通过 AT 命令手动注册，IoT 平台注册过程都由 LwM2M 触发，不 会阻止任何 AT 命令。 DTLS 协商或者握手完成后，模块主动发送消息 +QDTLSSTAT: 0/3 到终端。 AT+QDTLSSTAT 查询 DTLS 状态 查询命令 AT+QDTLSSTAT? 响应 +QDTLSSTAT: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。DTLS 状态。 0 表示 DTLS 协商或握手完成 1 表示协商或握手未开始 2 表示正在协商或者握手 3 表示协商或者握手失败 举例 AT+QDTLSSTAT? +QDTLSSTAT:0 上海移远通信技术股份有限公司 166 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 OK 5.20. AT+QBOOTSTRAPHOLDOFF* Bootstrap 延时时长 该命令用来设置和查询客户端延时时间（仅与 Bootstrap 服务器相关）。默认值是 600 秒，建议最长 时间不超过 3000 秒：  如果时间设置过长（大于 3000 秒），会延迟终端 Bootstrap Sequence 尝试时间，进而影响终端 接入功耗；  如果时间设置过短（小于 600 秒），会导致 Factory Bootstrap（厂家存储相应消息在设备中）和 Server Initiated Bootstrap（服务器发起引导程序）时间过短，进而影响 Factory Bootstrap 和 Server Initiated Bootstrap 的成功率。因此，如果模块入网后需要执行 Server Initiated Bootstrap 过程（未 配置 Bootstrap 服务器和 LwM2M 服务器地址），或已配置了 LwM2M 服务器地址，不建议 ClientHoldOffTimer 值小于 600 秒。 必须在配置了 Bootstrap 服务器地址的情况下，ClientHoldOffTimer 才可以为 0。模块会直接进入 Client Initiated Bootstrap，缩短 Client Initiated Bootstrap 时间：  如果没有配置 Bootstrap 服务器地址，执行命令 AT+QBOOTSTRAPHOLDOFF=0 后会返回 ERROR；  如 果 Bootstrap 服 务 器 不 存 在 ， ClientHoldOffTimer 定 时 器 时 间 不 能 设 置 为 0 ； 如 果 ClientHoldOffTimer 定时器时间为 0，则不能擦除 Bootstrap 服务器 IP。 AT+QBOOTSTRAPHOLDOFF* Bootstrap 延时时长 设置命令 AT+QBOOTSTRAPHOLDOFF= 查询命令 AT+QBOOTSTRAPHOLDOFF? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QBOOTSTRAPHOLDOFF: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 167 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 参数 整型。单位：秒。表示客户端延时时长。默认值为 600 秒。建议设置值不超过 3000 秒。 备注 '*' 表示正在开发中。 举例 AT+QBOOTSTRAPHOLDOFF=600 OK AT+QBOOTSTRAPHOLDOFF? +QBOOTSTRAPHOLDOFF:600 OK 5.21. AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP 该命令用来设置和删除 Bootstrap 和 IoT 服务器 IP 地址。AT+QLWSERVERIP 和 AT+NCDP 两个命 令适用同一个 KV 项：  当 IP 地址和端口与 KV 匹配时，执行 AT+QLWSERVERIP=DEL,, 将会删除 IP 信息；  当 IP 地址与 KV 匹配时，执行 AT+QLWSERVERIP=DEL, 将会删除 IP 信息。 AT+QLWSERVERIP 设置/删除 Bootstrap/LwM2M 服务器 IP 设置命令 AT+QLWSERVERIP=,[,] 查询命令 AT+QLWSERVERIP? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLWSERVERIP: ,, OK 若出现任何错误： 上海移远通信技术股份有限公司 168 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 ERROR 或者 +CME ERROR: 300 毫秒 参数 Bootstrap/LwM2M 服务器 IP 类型。 LWM2M IoT 服务器 IP BS Bootstrap 服务器 IP DEL 删除 IP 信息 域名或者 IP 地址。IP 地址格式为点分十进制格式的 IPv4 地址，如：a1.a2.a3.a4。 范围：0-255。 整型。端口号。范围：0-65535。 举例 AT+QLWSERVERIP=BS,180.101.147.115,5683 OK AT+QLWSERVERIP=LWM2M,180.101.147.115,5683 OK AT+QLWSERVERIP? +QLWSERVERIP: BS,180.101.147.115,5683 +QLWSERVERIP: LWM2M,180.101.147.115,5683 OK AT+QLWSERVERIP=DEL,180.101.147.115,5683 OK 5.22. AT+QCRITICALDATA 查询是否可发送紧急数据 该命令用来查询是否可以在 DFOTA 升级过程中发送紧急数据，如果可以发送数据，当前 DFOTA 过程 会停止并优先传输数据。平台升级结果取决于超时处理。 在 DFOTA 升级过程中，如果有发送紧急数据请求，可先发送该命令：如果响应 OK，则可发送紧急数 据；如果响应 ERROR，则不能发送紧急数据。 AT+QCRITICALDATA 查询是否可发送紧急数据 设置命令 响应 AT+QCRITICALDATA= OK 上海移远通信技术股份有限公司 169 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。参数值只能设置为 1。用来查询是否可以发送紧急数据。 举例 AT+QCRITICALDATA=1 OK 5.23. AT+QSETBSPSK* 配置 PSK ID 和 PSK 到 Bootstrap 该命令用来配置 Bootstrap 服务器对接 DTLS 连接的 PSK ID 和 PSK。重启模块后该命令才生效。 AT+QSETBSPSK* 配置 PSK ID 和 PSK 到 Bootstrap 设置命令 AT+QSETBSPSK=, 响应 OK 查询命令 AT+QSETBSPSK? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QSETBSPSK: , OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 2秒 上海移远通信技术股份有限公司 170 /190 参数 BC35-G&BC28&BC95 R2.0 AT 命令手册 密钥索引。用于索引 PSK，固定长度为 15 位的十进制数字，取值需要和设备的 IMEI 号相同，需要和 IoT 平台保持一致。当该参数值设置为 0 时，IMEI 号被用作 。 预置密钥，固定长度为 16 字节的十六进制数字，需和 IoT 平台保持一致。 备注 1. '*' 表示正在开发中。 2. 必须在无线处于非活动状态时执行（AT+CFUN=0 将强制模块进入此状态）。 举例 AT+QSETBSPSK=201703230000024,0123456789ABCDEF0123456789ABCDEF OK AT+QSETBSPSK? +QSETBSPSK: 201703230000024,*** OK 5.24. AT+QBSSECSWT* 设置 Bootstrap 加密模式 该命令用来配置 Bootstrap 服务器对接的 DTLS 连接的开关，以及标准 DTLS 会话超时重协商时间。在 启动 DTLS 首次协商时启动计时器，每收到一次 Bootstrap 服务器的 DTLS 报文后重启定时器。发送上行报 文时，如果该定时器已经超时，需触发一个重新协商。 AT+QBSSECSWT* 设置 Bootstrap 加密模式 配置命令 AT+QBSSECSWT=[,] 查询命令 AT+QBSSECSWT? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QBSSECSWT: [,] OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 171 /190 最大响应时间 BC35-G&BC28&BC95 R2.0 AT 命令手册 或者 +CME ERROR: 300 毫秒 参数 加密模式类型 0 不加密 1 标准 DTLS 加密模式 2 DTLS+加密模式 NAT 类型仅在标准 DTLS 加密模式下有效。 0 使能 NAT，且重新协商时间为 30 秒 1 禁用 NAT 和重新协商 备注 1. '*' 表示仍在开发中。 2. 只有在标准 DTLS 加密模式下（即=1）参数 才有效。 举例 AT+QBSSECSWT=1,1 OK AT+QBSSECSWT? +QBSSECSWT:1,1 OK 上海移远通信技术股份有限公司 172 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 6 错误码 本章介绍与 BC35-G、BC28 和 BC95 R2.0 模块相关的错误码。 以下两个表中列出的错误代码符合 3GPP 规范。客户可以参考 3GPP TS 27.007 V13.5.0, sub-clause 9.2 了解所有可能的 错误码。 表 3：通用错误码（27.007） 错误码 3 4 5 23 30 50 51 52 100 159 描述 说明 Operation not allowed 操作不被允许 Operation not supported 不支持该操作 Need to enter PIN 需要输入 PIN Memory failure 内存故障 No network service 无网络服务 Incorrect parameters 参数不正确 Command implemented but currently disabled 命令被已执行但当前被禁用 Command aborted by user 命令被客户终止 Unknown 未知错误 Uplink busy/flow control 上行链路忙/流控 表 4：通用错误码（27.005） 错误码 300 301 302 303 描述 ME failure SMS service of ME reserved Operation not allowed Operation not supported 上海移远通信技术股份有限公司 说明 ME 故障 ME 保留的短信服务 操作不被允许 不支持该操作 173 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 304 Invalid PDU mode parameter 无效的 PDU 模式参数 305 Invalid text mode parameter 无效的 text 模式参数 310 USIM not inserted 未插入 USIM 卡 311 USIM PIN required 需要输入 USIM PIN 312 PH-USIM PIN required 需要输入 PH-USIM PIN 313 USIM failure USIM 故障 314 USIM busy USIM 忙 315 USIM wrong USIM 错误 316 USIM PUK required 需要输入 USIM PUK 317 USIM PIN2 required 需要输入 USIM PIN2 318 USIM PUK2 required 需要输入 USIM PUK2 320 Memory failure 内存故障 321 Invalid memory index 无效的内存索引 322 Memory full 内存已满 330 SMSC address unknown 未知的 SMSC 地址 331 No network service 无网络服务 332 Network timeout 网络超时 340 No +CNMA acknowledgement expected 预计无+CNMA 确认 500 Unknown error 未知错误 以下错误码是 BC35-G 和 BC28 模块的特定错误码。 错误码 512 是之前的错误码 256，错误码 513 是之前的错误码 257。 表 5：特定错误码 错误码 512 513 514 描述 Required parameter not configured TUP not registered AT internal error 说明 必要的参数未配置 TUP 未注册 AT 内部错误 上海移远通信技术股份有限公司 174 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 515 CID is active CID 处于激活状态 516 Incorrect state for command 命令状态错误 517 CID is invalid CID 无效 518 CID is not active CID 处于未激活状态 520 Deactivate the last active CID 停用上次激活的 CID 521 CID is not defined CID 未被定义 522 UART parity error UART 奇偶校验错误 523 UART frame error UART 帧错误 UE is in minimal function mode UE 处于最小功能模式 524 (AT+CFUN=0) (AT+CFUN=0) 525 AT command aborted: in processing AT 命令中止：处理中 526 AT command aborted: error AT 命令中止：错误 527 Command interrupted 命令被中断 528 Configuration conflicts 配置冲突 529 During FOTA updating FOTA 升级中 530 Not the AT allocated socket 不是 AT 分配的 Socket 531 USIM PIN is blocked USIM PIN 被锁定 532 USIM PUK is blocked USIM PUK 被锁定 533 Not mipi module 非 mipi 模块 534 File not found 未找到文件 535 conditions of use not satisfied 使用的条件不符 536 AT UART buffer error AT UART 口缓冲错误 537 Back off timer is running 退避定时器正在运行 备注 AT+CMEE=命令禁用（=0）或启用（=1）最终结果码 +CME ERROR:。 当=1 时，将返回一组有限的错误码。 上海移远通信技术股份有限公司 175 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 7 重启原因 除了重新上电或外部复位，如果模块因其他任何原因重新启动，将在字符串 NeulOK 前输出一条消息，以表明重新启动的原因。该打印的重启原因仅供参考，不能作为判断 模块重启的唯一原因。 表 6：重启原因显示 序号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 重启消息显示 REBOOT_CAUSE_SECURITY_RESET_UNKNOWN REBOOT_CAUSE_SECURITY_SYSRESETREQ REBOOT_CAUSE_SECURITY_WATCHDOG REBOOT_CAUSE_SECURITY_SELF REBOOT_CAUSE_SECURITY_ALTBOOT REBOOT_CAUSE_SECURITY_REG_0 REBOOT_CAUSE_SECURITY_REG_3 REBOOT_CAUSE_SECURITY_STANDARD_CHIP_WATCHDOG REBOOT_CAUSE_SECURITY_UPDATER_CHIP_WATCHDOG REBOOT_CAUSE_SEUCRITY_SCAN_ENTER_EXIT REBOOT_CAUSE_SECURITY_PMU_POWER_ON_RESET REBOOT_CAUSE_SECURITY_RESET_PIN REBOOT_CAUSE_SECURITY_REGIONS_UPDATED REBOOT_CAUSE_SECURITY_FOTA_UPGRADE REBOOT_CAUSE_PROTOCOL_SYSRESETREQ REBOOT_CAUSE_PROTOCOL_WATCHDOG 上海移远通信技术股份有限公司 176 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 17 REBOOT_CAUSE_PROTOCOL_MONITOR_REBOOT_REQ 18 REBOOT_CAUSE_PROTOCOL_RPC_TIMEOUT 19 REBOOT_CAUSE_APPLICATION_SYSRESETREQ 20 REBOOT_CAUSE_APPLICATION_WATCHDOG 21 REBOOT_CAUSE_APPLICATION_AT 22 REBOOT_CAUSE_APPLICATION_RPC_TIMEOUT 23 REBOOT_CAUSE_PROTOCOL_IMSI_UPDATE 24 REBOOT_CAUSE_UNKNOWN 上海移远通信技术股份有限公司 177 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 8 举例 8.1. 附着网络 执行命令 AT+NCONFIG=AUTOCONNECT,TRUE 模块自动附着网络。 如果需要手动注网，请通过执行命令 AT+NCONFIG=AUTOCONNECT,FALSE 禁用自动附着网络功 能。该设置将保存至 NVM，并在执行命令 AT+NRB 重启模块后生效。 8.1.1. 自动附着网络 以下是附着网络的简单示例。客户可以通过以下命令查询模块是否已附着到网络： REBOOT_CAUSE_SECURITY_PMU_POWER_ON_RESET Neul OK //模块上电开机 AT+CFUN? +CFUN:1 OK AT+CIMI 460111174590523 //查询 IMSI 号 OK AT+CEREG? +CEREG:0,1 //查询网络注册状态 //=0 表示已禁用网络注册 URC，=1 表示已注册 OK AT+CGATT? +CGATT:1 //查询网络是否被激活 //网络激活成功，通常需要等待 30s OK AT+CGPADDR //查询模块的 IP 地址 +CGPADDR:0,10.169.241.248 OK 上海移远通信技术股份有限公司 178 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 8.1.2. 手动附着网络 全频段搜网可能会花费较长的时间，因此建议手动注网时，只搜索指定的频段。 AT+NCONFIG=AUTOCONNECT,FALSE OK AT+NRB REBOOTING //禁用自动连接网络 //重启模块 REBOOT_CAUSE_APPLICATION_AT Neul OK AT+NBAND=5 OK AT+CFUN=1 OK AT+CIMI 460111174590523 //重启原因 //指定要搜索的频段 B5 //将模块设置为全功能模式 //查询 IMSI 号 OK AT+CGATT=1 OK AT+NUESTATS Signal power:-827 Total power:-684 TX power:230 TX time:2272 RX time:9354 Cell ID:110258001 ECL:1 SNR:-30 EARFCN:2506 PCI:100 RSRQ:-157 OPERATOR MODE:4 //触发网络连接 //查询模块状态 OK T+CEREG? +CEREG:0,1 //查询网络注册状态 //=0 表示已禁用网络注册 URC，=1 表示已注册 OK AT+CGATT? +CGATT:1 //查询网络是否被激活 //网络激活成功，通常需要等待 30s 上海移远通信技术股份有限公司 179 /190 OK AT+CGPADDR +CGPADDR:0,10.3.42.109 OK BC35-G&BC28&BC95 R2.0 AT 命令手册 //查询模块的 IP 地址 8.2. 发送/接收/读取 UDP 信息 以下是发送/接收/读取 UDP 信息的简单示例。Socket 关闭后，将不会收到任何响应。当不使用 IoT 平 台时，需要在模块连接到网络之前禁用 IoT 平台的注册功能。 AT+QREGSWT=2 OK … //禁用 IoT 平台的注册功能 //连接网络 AT+CGPADDR +CGPADDR:0,10.3.42.109 OK AT+NSOCR=DGRAM,17,0,1 1 //查询模块的 IP 地址 //创建一个 UDP 类型的 Socket，并接收传输消息 OK AT+NSOST=1,220.180.239.212,8012,5,1245783132,100 //发送信息 1,5 OK +NSOSTR:1,100,1 //RF 发送的数据报文 +NSONMI:1,5 //接收信息 AT+NSORF=1,5 //读取编号为 1 的 Socket 中 5 字节的信息 1,220.180.239.212,8012,5,1245783132,0 OK AT+NSOCL=1 OK //关闭 Socket 上海移远通信技术股份有限公司 180 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 8.3. 发送/接收/读取 TCP 信息 以下是发送/接收/读取 TCP 信息的简单示例。关闭 Socket 后，将不会收到任何响应。当不适用 IoT 平 台时，需要在模块连接到网络之前禁用 IoT 平台的注册功能。 AT+QREGSWT=2 OK … //禁用 IoT 平台的注册功能 //连接网络 AT+CGPADDR +CGPADDR:0,10.3.42.79 OK AT+NSOCR=STREAM,6,0,1 1 //查询模块的 IP 地址 //创建一个 TCP 类型的 Socket OK AT+NSOCO=1,220.180.239.212,8009 OK AT+NSOSD=1,4,01020304,0x100,101 1,4 //连接服务器 //发送数据 OK +NSOSTR:1,101,1 //确认数据报文已由服务器接收 +NSONMI:1,4 AT+NSORF=1,4 1,220.180.239.212,8009,4,01020304,0 //接收信息 //读取编号为 1 的 Socket 中 4 字节的信息 OK AT+NSOCL=1 OK //关闭 Socket 上海移远通信技术股份有限公司 181 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 8.4. 华为 IoT 平台相关举例 8.4.1. 注册华为 IoT 平台 8.4.1.1. 自动注册模式 AT+QREGSWT? +QREGSWT:1 OK AT+NCDP=180.101.147.115,5683 OK AT+NRB REBOOTING REBOOT_CAUSE_APPLICATION_AT Neul OK AT+CGPADDR +CGPADDR:0,10.3.42.109 OK +QLWEVTIND:0 +QLWEVTIND:3 //自动注册模式（默认模式） //设置 IoT 平台 IP 地址及端口 //重启模块 //重启原因 //查询模块的 IP 地址 //表明成功注册 //IoT 平台已观察到对象 19。当模块报告此消息时，数据可 以发送到 IoT 平台。 8.4.1.2. 手动注册模式 AT+CGATT? +CGATT:1 OK AT+NCDP=180.101.147.115,5683 OK AT+QREGSWT? +QREGSWT:0 OK AT+QLWSREGIND=0 上海移远通信技术股份有限公司 //查询 PS 服务连接状态 //已经连接了 PS 服务器 //设置 IoT 平台 IP 地址及端口 //查询注册模式 //手动注册模式 //开始注册 IoT 平台 182 /190 OK +QLWEVTIND:0 +QLWEVTIND:3 AT+QLWSREGIND=1 OK +QLWEVTIND:1 BC35-G&BC28&BC95 R2.0 AT 命令手册 //表明成功注册 //IoT 平台已观察到对象 19。当模块报告此消息时，数据 可以发送到 IoT 平台。 //从 IoT 平台注销 //表明注销成功 8.4.2. 从华为 IoT 平台发送/接收数据 +QLWEVTIND:0 +QLWEVTIND:3 AT+QLWULDATA=3,313233 OK +NNMI:4,AAAA0000 AT+QLWULDATAEX=3,313233,0X0100 OK +QLWULDATASTATUS:4 +NNMI:4,AAAA0000 AT+QLWULDATASTATUS? +QLWULDATASTATUS:4 OK //表明成功注册 //IoT 平台已观察到对象 19。当模块报告此消息时，数据 可以发送到 IoT 平台。 //发送 NON 数据，不需要 IoT 平台应答 ACK 消息。 //模块已从物联网平台接收数据 //发送 CON 消息， IoT 平台需要应答 ACK 消息 //数据发送成功 //模块已从物联网平台接收数据 //查询数据发送状态 //数据发送成功 8.4.3. 在华为 IoT 平台上升级固件 8.4.3.1. 通过 DFOTA 自动升级固件 //在 IoT 平台上创建一个固件升级任务 +QLWEVTIND:0 //表明成功注册 上海移远通信技术股份有限公司 183 /190 +QLWEVTIND:3 AT+QLWULDATA=3,313233 OK +QLWEVTIND:5 BC35-G&BC28&BC95 R2.0 AT 命令手册 //IoT 平台已观察到对象 19 //发送任意上行数据包并触发在线固件升级 //IoT 平台已观察到对象 5 FIRMWARE DOWNLOADING FIRMWARE DOWNLOADED FIRMWARE UPDATING //模块正在进行本地升级，这可能导致多次重新启动，因此需要一些时间。 REBOOT_CAUSE_SECURITY_FOTA_UPGRADE //重启模块 Neul OK FIRMWARE UPDATE SUCCESS +QLWEVTIND:0 //表明成功注册 +QLWEVTIND:3 //IoT 平台已观察到对象 19 FIRMWARE UPDATE OVER 8.4.3.2. 通过 DFOTA 手动升级固件 //在 IoT 平台上创建一个固件升级任务 AT+QLWFOTAIND? +QLWFOTAIND:1 OK AT+QLWSREGIND=0 OK +QLWEVTIND:0 +QLWEVTIND:3 上海移远通信技术股份有限公司 //查询固件的升级模式 //手动模式 //开始注册 IoT 平台 //表明成功注册 //IoT 平台已观察到对象 19 184 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 +QLWEVTIND:5 //IoT 平台已观察到对象 5 FIRMWARE DOWNLOADING +QLWEVTIND:6 AT+QLWFOTAIND=2 OK //通知设备接收更新包的 URL //设备通知模块开始下载 FIRMWARE DOWNLOADED +QLWEVTIND:7 AT+QLWFOTAIND=4 OK //通知设备下载已经完成 //设备通知模块开始升级 FIRMWARE UPDATING REBOOT_CAUSE_SECURITY_FOTA_UPGRADE Neul OK //模块重启 FIRMWARE UPDATE SUCCESS +QLWEVTIND:0 //表明成功注册 +QLWEVTIND:3 //IoT 平台已观察到对象 19 FIRMWARE UPDATE OVER 8.4.4. 使用 DTLS 注册华为 IoT 平台 AT+CGATT? +CGATT:1 //查询 PS 服务连接状态 //已经连接了 PS 服务器 OK AT+NCDP= 180.101.147.115,5684 //设置 IoT 平台 IP 地址及端，端口 5684. OK AT+QSECSWT=1 //使用标准 DTLS 加密 OK AT+QSETPSK=201703230000024,0123456789ABCDEF0123456789ABCDEF OK //设置 PSK ID 和 PSK AT+QREGSWT? //查询注册模式 上海移远通信技术股份有限公司 185 /190 +QREGSWT:0 OK AT+QLWSREGIND=0 OK +QLWEVTIND:0 +QLWEVTIND:3 BC35-G&BC28&BC95 R2.0 AT 命令手册 //手动注册模式 //开始注册 IoT 平台 //表明成功注册 //IoT 平台已观察到对象 19 上海移远通信技术股份有限公司 186 /190 BC35-G&BC28&BC95 R2.0 AT 命令手册 9 附录 A 术语缩写 表 7：术语缩写 缩写 APDU APN BIP BS CDP CS DCE DF DTLS EARFCN eDRX EGPRS EMS eNB EPS E-UTRA(N) EOR GBR 英文全称 中文全称 Application Protocol Data Unit 应用协议数据单元 Access Point Name 接入点名称 Bearer Independent Protocol 承载独立协议 Bootstrap 引导 Connected Device Platform 连接设备平台 Circuit Switched 电路交换 Data Communication Equipment 数据通信设备 Dedicated File 专用文件 Datagram Transport Layer Security 数据包传输层安全性协议 E-UTRA Absolute Radio Frequency Channel Number E-UTRA 绝对无线频道编号 Extended Discontinuous Reception 扩展非连续性接收 Enhanced General Packet Radio Service 增强型数据速率 GSM 演进技术 EPS Session Management EPS 会话管理 Evolved Node B 演进型 Node B Evolved Packet System 演进型分组系统 Evolved Universal Terrestrial Radio Access 演进型通用地面无线接入（网络） (Network) Exclusive Or 异或 Guaranteed Bit Rate 保证的比特率 上海移远通信技术股份有限公司 187 /190 GERAN GGSN GMT GPRS HPLMN HSDPA HSUPA ICMP IE IMEI IMEISV IP ISIM KV LwIP MBR MS NAS NAT NB-IoT NSLPI NVM PCI PCO PDP BC35-G&BC28&BC95 R2.0 AT 命令手册 GSM/EDGE Radio Access Network GSM/EDGE 无线接入网 Gateway GPRS Support Node 网关 GPRS 支持节点 Greenwich Mean Time 格林尼治标准时间 General Packet Radio Service 通用分组无线服务技术 Home Public Land Mobile Network 本地公用陆地移动网络 High Speed Downlink Packet Access 高速下行分组接入 High-Speed Uplink Packet Access 高速上行分组接入 Internet Control Messages Protocol 网间控制报文协议 Information Element 信息元素 International Mobile Equipment Identity 国际移动设备识别码 International Mobile Equipment Identity and 国际移动用户识别码及软件版本 Software Version Internet Protocol 互联网协议 IM (IP Multimedia) Service Identity Module IM（IP 多媒体）业务识别模块 Key Value 关键字取值 Lightweight IP(Internet Protocol) 轻型 IP 协议 Maximum Bit Rate 最大比特率 Mobile Station 移动台 Non-access stratum 非接入层 Network Address Translation 网络地址转换 Narrow Band Internet of Thing 窄带物联网 NAS Signalling Low Priority Indication 非接入层信令低优先级指示 Non-volatile Memory 非易失性存储器 Physical Cell Identity 物理小区识别码 Protocol Configuration Options 协议配置选项 Packet Data Protocol 分组数据协议 上海移远通信技术股份有限公司 188 /190 PF PS PSK PWM QCI QoS RAT RN RP RRC RTC RxQual SC SIB SNR SVN TA TCP TE TFT TP TPDU TTL UDP UE Packet Filter Packet Switch Pre-shared Key Pulse Width Modulation QoS Class Identifier Quality of Service Radio Access Technology Release Note Relay Protocol Radio Resource Control Real Time Clock Receive Quality Service Center System Information Block Signal-to-Noise Ratio Software Version Number Terminal Adapter Transmission Control Protocol Terminal Equipment Traffic Flow Template Transport Transport Protocol Data Unit Time to Live User Datagram Protocol User Equipment BC35-G&BC28&BC95 R2.0 AT 命令手册 分组过滤器 分组交换 预共享密钥 脉冲宽度调制 QoS 等级标识 服务质量 无线接入技术 发布说明 中继协议 无线资源控制 实时时钟 接收质量 服务中心 系统信息块 信噪比 软件版本 终端适配器 传输控制协议 终端设备 业务流模板 传输 传送协议数据单元 存活时间 用户数据报协议 用户设备 上海移远通信技术股份有限公司 189 /190 UICC URC USIM UUID WIM XOFF XON Oos BC35-G&BC28&BC95 R2.0 AT 命令手册 Universal Integrated Circuit Card Unsolicited Result Code Universal Subscriber Idneity Module Universally Unique Identifier Wireless Identity Module Transmit off Transmit on Out of service 通用集成电路卡 非请求结果码 通用用户识别卡 通用唯一识别码 无线识别模块 停止传输 继续传输 退出服务 上海移远通信技术股份有限公司 190 /190

MC20&MC30 AT Commands Manual GSM/GPRS/GNSS Module Series Rev. MC20&MC30_AT_Commands_Manual_V1.2 Date: 2018-09-14 Status: Released www.quectel.com GSM/GPRS/GNSS Module Series MC20&MC30 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. MC20&MC30_AT_Commands_Manual 1 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual About the Document History Revision Date 1.0 2016-07-08 1.1 2016-08-17 1.2 2018-09-14 Author Hyman DING Hyman DING Simon HU/ Sandy YE Description Initial Added AT+QDSIM command 1. Added MC30 as the applicable module of the document. 2. Deleted command AT+ILRR, AT+CRLP, AT+CMOD, AT+QHTTPRSP and AT+QCFG='RFTXburst'. 3. Updated the description of AT+QEAUART and AT+QSEDCB (Chapter 3.7 and 3.8) 4. Added notes for AT+CSIM (Chapter 5.6) 5. Added command AT+CGLA (Chapter 5.15), AT+QIKALIVE (Chapter 11.35), AT+QPCMON (Chapter 13.19), AT+QPCMVOL (Chapter 13.20), AT+QTEMP (Chapter 14.8) and AT+QMSDC (Chapter 14.8) MC20&MC30_AT_Commands_Manual 2 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Contents About the Document ................................................................................................................................2 Contents .................................................................................................................................................... 3 Table Index ...............................................................................................................................................9 1 Introduction .....................................................................................................................................10 1.1. Scope of the Document ..........................................................................................................10 1.2. AT Command Syntax..............................................................................................................10 1.2.1. Combining AT Commands on the Same Command Line ............................................. 11 1.2.2. Entering Successive AT Commands on Separate Lines .............................................. 11 1.3. Supported Character Sets ...................................................................................................... 11 1.4. Flow Control ...........................................................................................................................12 1.4.1. Software Flow Control (XON/XOFF Flow Control).......................................................12 1.4.2. Hardware Flow Control (RTS/CTS Flow Control) ........................................................13 1.5. Unsolicited Result Codes .......................................................................................................13 2 General Commands ........................................................................................................................14 2.1. ATI Display Product Identification Information......................................................................14 2.2. AT+GMI Request Manufacturer Identification ......................................................................15 2.3. AT+GMM Request TA Model Identification...........................................................................15 2.4. AT+GMR Request TA Revision Identification of Software Release......................................16 2.5. AT+GOI Request Global Object Identification......................................................................16 2.6. AT+CGMI Request Manufacturer Identification....................................................................17 2.7. AT+CGMM Request Model Identification .............................................................................18 2.8. AT+CGMR Request TA Revision Identification of Software Release ...................................18 2.9. AT+GSN Request International Mobile Equipment Identity (IMEI) .......................................19 2.10. AT+CGSN Request Product Serial Number Identification....................................................19 2.11. AT+QGSN Request Product Serial Number Identification (IMEI).........................................20 2.12. AT&F Set All Current Parameters to Manufacturer Defaults ................................................21 2.13. AT&V Display Current Configuration....................................................................................21 2.14. AT&W Store Current Parameters to User Defined Profile ....................................................23 2.15. ATQ Set Result Code Presentation Mode............................................................................23 2.16. ATV TA Response Format....................................................................................................24 2.17. ATX Set CONNECT Result Code Format and Monitor Call Progress ..................................26 2.18. ATZ Set All Current Parameters to User Defined Profile......................................................26 2.19. AT+CFUN Set ME Functionality...........................................................................................27 2.20. AT+QPOWD Power off ........................................................................................................28 2.21. AT+CMEE Report Mobile Equipment Error..........................................................................29 2.22. AT+CSCS Select TE Character Set .....................................................................................30 2.23. AT+GCAP Request Complete TA Capabilities List...............................................................31 3 Serial Interface Control Commands ..............................................................................................32 3.1. AT&C Set DCD Function Mode............................................................................................32 3.2. AT&D Set DTR Function Mode ............................................................................................32 MC20&MC30_AT_Commands_Manual 3 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 3.3. AT+ICF Set TE-TA Control Character Framing ....................................................................33 3.4. AT+IFC Set TE-TA Local Data Flow Control ........................................................................34 3.5. AT+IPR Set TE-TA Fixed Local Rate ...................................................................................35 3.5.1. Adaptive Baud Rate.....................................................................................................36 3.6. AT+CMUX Multiplexer Control .............................................................................................38 3.7. AT+QEAUART Configure Multi UART Function ...................................................................39 3.8. AT+QSEDCB Configure Parameters of the Multi UART ......................................................40 4 Status Control Commands .............................................................................................................42 4.1. AT+CEER Extended Error Report........................................................................................42 4.2. AT+CPAS Mobile Equipment Activity Status ........................................................................43 4.3. AT+QINDRI RI Indication When Using URC........................................................................44 4.4. AT+QMOSTAT Show State of Mobile Originated Call ..........................................................45 4.5. AT+QREFUSECS Refuse to Receive SMS/Incoming Call or Not ........................................46 4.6. AT+QIURC Enable or Disable Initial URC Presentation.......................................................46 4.7. AT+QEXTUNSOL Enable/Disable Proprietary Unsolicited Indications ................................47 4.8. AT+QINISTAT Query State of Initialization...........................................................................49 4.9. AT+QNSTATUS Query GSM Network Status ......................................................................49 4.10. AT+QNITZ Network Time Synchronization ..........................................................................50 4.11. AT+QLTS Obtain Latest Network Time Synchronized..........................................................51 4.12. AT+CTZU Network Time Synchronization and Update the RTC Time .................................52 4.13. AT+CTZR Network Time Synchronization Report ................................................................53 4.14. AT+QSIMDET Enable/Disable (U)SIM Card Detection ........................................................53 4.15. AT+QSIMSTAT (U)SIM Inserted Status Reporting ...............................................................54 4.16. AT+QCGTIND Circuit Switched Call or GPRS PDP Context Termination Indication............55 5 (U)SIM Related Commands ............................................................................................................57 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) .......................................57 5.2. AT+CLCK Facility Lock ........................................................................................................58 5.3. AT+CPIN Enter PIN .............................................................................................................60 5.4. AT+CPWD Change Password .............................................................................................61 5.5. AT+CRSM Restricted (U)SIM Access ..................................................................................63 5.6. AT+CSIM Generic (U)SIM Access .......................................................................................64 5.7. AT+QCSPWD Change PS Super Password........................................................................65 5.8. AT+CCID Show CCID ..........................................................................................................66 5.9. AT+QCCID Show CCID .......................................................................................................66 5.10. AT+QGID Get (U)SIM Card Group Identifier........................................................................67 5.11. AT+QSIMVOL Select (U)SIM Card Operating Voltage.........................................................68 5.12. AT+QSPN Get Service Provider Name from (U)SIM ...........................................................68 5.13. AT+QTRPIN Times Remained to Input (U)SIM PIN/PUK.....................................................69 5.14. AT+QDSIM Dual (U)SIM Switching......................................................................................70 5.15. AT+CGLA Generic (U)SIM Logical Channel Access ............................................................70 6 Network Service Commands..........................................................................................................72 6.1. AT+COPS Operator Selection .............................................................................................72 6.2. AT+CREG Network Registration Status...............................................................................74 MC20&MC30_AT_Commands_Manual 4 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 6.3. AT+CSQ Signal Quality Report............................................................................................75 6.4. AT+CPOL Preferred Operator List .......................................................................................76 6.5. AT+COPN Read Operator Names .......................................................................................77 6.6. AT+QBAND Get and Set Mobile Operation Band ................................................................78 6.7. AT+QENG Switch on or off Engineering Mode ....................................................................79 6.8. AT+QSCANF Scan Power of GSM Frequency ....................................................................82 6.9. AT+QLOCKF Lock GSM Frequency ....................................................................................83 7 Call Related Commands .................................................................................................................84 7.1. ATA Answer an Incoming Call ..............................................................................................84 7.2. ATD Mobile Originated Call to Dial a Number ......................................................................85 7.3. ATH Disconnect Existing Connection...................................................................................86 7.4. +++ Switch from Data Mode to Command Mode .................................................................87 7.5. ATO Switch from Command Mode to Data Mode ................................................................87 7.6. ATP Select Pulse Dialing .....................................................................................................88 7.7. ATS0 Set Number of Rings before Automatically Answering Call ........................................88 7.8. ATS6 Set Pause before Blind Dialing...................................................................................89 7.9. ATS7 Set the Time to Wait for Connection Completion........................................................90 7.10. ATS8 Set the Time to Wait for Comma Dial Modifier............................................................91 7.11. ATS10 Set Disconnect Delay after Indicating the Absence of Data Carrier .........................91 7.12. ATT Select Tone Dialing.......................................................................................................92 7.13. AT+CSTA Select Type of Address........................................................................................92 7.14. AT+CLCC List Current Calls of ME ......................................................................................93 7.15. AT+CR Service Reporting Control .......................................................................................94 7.16. AT+CRC Set Cellular Result Code for Incoming Call Indication ..........................................95 7.17. AT+CSNS Single Numbering Scheme .................................................................................96 7.18. AT+QSFR Preference Speech Coding.................................................................................97 7.19. AT+QSPCH Speech Channel Type Report..........................................................................98 7.20. AT+QDISH Disable ATH ......................................................................................................99 8 SMS Commands............................................................................................................................101 8.1. AT+CSMS Select Message Service...................................................................................101 8.2. AT+CMGF Select SMS Message Format ..........................................................................102 8.3. AT+CSCA SMS Service Center Address ...........................................................................102 8.4. AT+CPMS Preferred SMS Message Storage ....................................................................104 8.5. AT+CMGD Delete SMS Message ......................................................................................105 8.6. AT+CMGL List SMS Messages from Preferred Storage ....................................................106 8.7. AT+CMGR Read SMS Message........................................................................................109 8.8. AT+CMGS Send SMS Message ........................................................................................ 112 8.9. AT+CMGW Write SMS Message to Memory ..................................................................... 113 8.10. AT+CMSS Send SMS Message from Storage ................................................................... 115 8.11. AT+CMGC Send SMS Command ...................................................................................... 116 8.12. AT+CNMI New SMS Message Indications ......................................................................... 117 8.13. AT+CRES Restore SMS Settings ......................................................................................120 8.14. AT+CSAS Save SMS Settings...........................................................................................121 MC20&MC30_AT_Commands_Manual 5 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 8.15. AT+CSCB Select Cell Broadcast SMS Messages .............................................................121 8.16. AT+CSDH Show SMS Text Mode Parameters...................................................................122 8.17. AT+CSMP Set SMS Text Mode Parameters ......................................................................123 8.18. AT+QCLASS0 Store Class 0 SMS to (U)SIM When Receiving Class 0 SMS....................124 8.19. AT+QMGDA Delete All SMS ..............................................................................................126 8.20. AT+QSMSCODE Configure SMS Code Mode...................................................................126 9 Phonebook Commands ................................................................................................................128 9.1. AT+CPBS Select Phonebook Memory Storage .................................................................128 9.2. AT+CPBW Write Phonebook Entry ....................................................................................129 9.3. AT+CPBR Read Current Phonebook Entries.....................................................................130 9.4. AT+CPBF Find Phonebook Entries....................................................................................131 9.5. AT+CNUM Subscriber Number ..........................................................................................132 10 GPRS Commands .........................................................................................................................134 10.1. AT+CGATT Attach to/Detach from GPRS Service .............................................................134 10.2. AT+CGDCONT Define PDP Context .................................................................................135 10.3. AT+CGQREQ Quality of Service Profile (Requested)........................................................136 10.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) .........................................137 10.5. AT+CGACT PDP Context Activate or Deactivate...............................................................138 10.6. AT+CGDATA Enter Data State...........................................................................................139 10.7. AT+CGPADDR Show PDP Address...................................................................................140 10.8. AT+CGCLASS GPRS Mobile Station Class.......................................................................141 10.9. AT+CGEREP Control Unsolicited GPRS Event Reporting.................................................141 10.10. AT+CGREG Network Registration Status ..........................................................................142 10.11. AT+CGSMS Select Service for MO SMS Messages..........................................................144 10.12. AT+QGPCLASS Change GPRS Multi-slot Class ...............................................................145 11 TCP/IP Commands ........................................................................................................................146 11.1. AT+QIOPEN Start up TCP or UDP Connection .................................................................146 11.2. AT+QISEND Send Data through TCP or UDP Connection ................................................147 11.3. AT+QICLOSE Close TCP or UDP Connection...................................................................148 11.4. AT+QIDEACT Deactivate GPRS/CSD PDP Context .........................................................150 11.5. AT+QILPORT Set Local Port .............................................................................................150 11.6. AT+QIREGAPP Start TCP/IP Task and Set APN, User Name and Password ...................151 11.7. AT+QIACT Activate GPRS/CSD Context...........................................................................152 11.8. AT+QILOCIP Get Local IP Address ...................................................................................153 11.9. AT+QISTAT Query Current Connection Status ..................................................................153 11.10. AT+QISTATE Query Connection Status of the Current Access..........................................155 11.11. AT+QISSTAT Query the Current Server Status .................................................................156 11.12. AT+QIDNSCFG Configure Domain Name Server..............................................................157 11.13. AT+QIDNSGIP Query the IP Address of Given Domain Name ..........................................158 11.14. AT+QIDNSIP Connect with IP Address or Domain Name Server ......................................159 11.15. AT+QIHEAD Add an IP Header When Receiving Data......................................................160 11.16. AT+QIAUTOS Set Auto Sending Timer..............................................................................160 11.17. AT+QIPROMPT Set Prompt of ‘>’ When Sending Data .....................................................161 MC20&MC30_AT_Commands_Manual 6 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.18. AT+QISERVER Configured as Server ...............................................................................162 11.19. AT+QICSGP Select CSD or GPRS as the Bearer .............................................................163 11.20. AT+QISRVC Choose Connection ......................................................................................164 11.21. AT+QISHOWRA Set Whether or Not to Display the Address of Sender........................165 11.22. AT+QISCON Save TCP/IP Application Context .................................................................166 11.23. AT+QIMODE Select TCP/IP Transfer Mode.......................................................................167 11.24. AT+QITCFG Configure Transparent Transfer Mode ..........................................................168 11.25. AT+QISHOWPT Control Whether or Not to Show the Protocol Type.................................169 11.26. AT+QIMUX Control Whether or Not to Enable Multiple TCP/IP Sessions..........................170 11.27. AT+QISHOWLA Control Whether or Not to Display Local IP Address ...............................171 11.28. AT+QIFGCNT Select a Context as Foreground Context....................................................172 11.29. AT+QISACK Query the Data Information for Sending .......................................................173 11.30. AT+QINDI Set the Method to Handle Received TCP/IP Data ............................................173 11.31. AT+QIRD Retrieve the Received TCP/IP Data ..................................................................175 11.32. AT+QISDE Control Whether or Not to Echo the Data for QISEND ....................................176 11.33. AT+QPING Ping a Remote Server.....................................................................................177 11.34. AT+QNTP Synchronize the Local Time via NTP ................................................................178 11.35. AT+QIKALIVE Set TCP/IP Keep Alive Parameter..............................................................179 12 Supplementary Service Commands ............................................................................................181 12.1. AT+CCFC Call Forwarding Number and Conditions Control .............................................181 12.2. AT+CCUG Closed User Group Control..............................................................................183 12.3. AT+CCWA Call Waiting Control .........................................................................................184 12.4. AT+CHLD Call Hold and Multiparty....................................................................................185 12.5. AT+CLIP Calling Line Identification Presentation...............................................................187 12.6. AT+QCLIP Control Whether or Not to Show the Name of Incoming Call Number .............189 12.7. AT+CLIR Calling Line Identification Restriction..................................................................190 12.8. AT+COLP Connected Line Identification Presentation.......................................................191 12.9. AT+QCOLP Show Alpha Field in +COLP String ................................................................192 12.10. AT+CUSD Unstructured Supplementary Service Data ......................................................193 12.11. AT+CSSN Supplementary Services Notification ................................................................194 13 Audio Commands .........................................................................................................................196 13.1. ATL Set Monitor Speaker Loudness...................................................................................196 13.2. ATM Set Monitor Speaker Mode ........................................................................................196 13.3. AT+VTD Tone Duration ......................................................................................................197 13.4. AT+VTS DTMF and Tone Generation ................................................................................198 13.5. AT+CALM Alert Sound Mode.............................................................................................199 13.6. AT+CRSL Ringer Sound Level...........................................................................................199 13.7. AT+CLVL Loud Speaker Volume Level ..............................................................................200 13.8. AT+CMUT Mute Control.....................................................................................................201 13.9. AT+QSIDET Change the Side Tone Gain Level.................................................................201 13.10. AT+QMIC Change the Microphone Gain Level..................................................................202 13.11. AT+QLDTMF Generate Local DTMF Tones.......................................................................203 13.12. AT+QAUDCH Swap the Audio Channels ...........................................................................204 MC20&MC30_AT_Commands_Manual 7 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 13.13. AT+QAUDLOOP Audio Channel Loop Back Test ..............................................................204 13.14. AT+QLTONE Generate Local Specific Tone ......................................................................205 13.15. AT+QTONEP Set DTMF Output Path ................................................................................206 13.16. AT+QTDMOD Set Tone Detection Mode ...........................................................................207 13.17. AT+QTONEDET Detect DTMF ..........................................................................................208 13.18. AT+QWDTMF Play DTMF Tone During the Call ................................................................210 13.19. AT+QPCMON Configure PCM Interface ............................................................................212 13.20. AT+QPCMVOL Set/Get PCM Input/Output Volume ...........................................................213 14 Hardware Related Commands .....................................................................................................214 14.1. AT+CCLK Clock .................................................................................................................214 14.2. AT+QALARM Set Alarm.....................................................................................................215 14.3. AT+CBC Battery Charge....................................................................................................216 14.4. AT+QADC Read ADC ........................................................................................................217 14.5. AT+QSCLK Configure Slow Clock .....................................................................................217 14.6. AT+QLEDMODE Configure the Network Indication LED Patterns .....................................218 14.7. AT+QVBATT Configure the Threshold of Voltage ..............................................................219 14.8. AT+QTEMP Query the Current Voltage and Temperature .................................................221 14.9. AT+QMSDC Mount/Unmount an External SD Card ...........................................................222 15 Others Commands ........................................................................................................................224 15.1. A/ Re-issue the Last Command Given...............................................................................224 15.2. ATE Set Command Echo Mode .........................................................................................224 15.3. ATS3 Set Command Line Termination Character ..............................................................225 15.4. ATS4 Set Response Formatting Character ........................................................................225 15.5. ATS5 Set Command Line Editing Character ......................................................................226 15.6. AT+QRIMODE Set RI Time ...............................................................................................226 16 Appendix References ...................................................................................................................228 16.1. Related Documents ..............................................................................................................228 16.2. Terms and Abbreviations ......................................................................................................229 16.3. Factory Default Settings Restorable with AT&F ....................................................................230 16.4. AT Command Settings Storable with AT&W .........................................................................232 16.5. AT Command Settings Storable with ATZ.............................................................................234 16.6. Summary of URC .................................................................................................................236 16.7. Summary of CME ERROR Codes ........................................................................................239 16.8. Summary of CMS ERROR Codes ........................................................................................243 16.9. Summary of Cause for Extended Error Report .....................................................................245 16.9.1. Location ID for the Extended Error Report.................................................................245 16.9.2. Cause for Protocol Stack (PS) Layer .........................................................................245 16.9.3. Internal Cause for MM Layer .....................................................................................257 16.9.4. Cause for PPP/IP-Stack ............................................................................................258 MC20&MC30_AT_Commands_Manual 8 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Table Index TABLE 1: TYPES OF AT COMMANDS AND RESPONSES ..............................................................................11 TABLE 2: CURRENT CONFIGURATION LIST WHEN EXECUTING AT&V COMMAND ................................. 22 TABLE 3: ATV0&ATV1 RESULT CODES NUMERIC EQUIVALENTS AND BRIEF DESCRIPTIONS.............. 25 TABLE 4: RELATED DOCUMENTS ................................................................................................................ 228 TABLE 5: TERMS AND ABBREVIATIONS ...................................................................................................... 229 TABLE 6: FACTORY DEFAULT SETTINGS RESTORABLE WITH AT&F ...................................................... 230 TABLE 7: AT COMMAND SETTINGS STORABLE WITH AT&W .................................................................... 232 TABLE 8: AT COMMAND SETTINGS STORABLE WITH ATZ ....................................................................... 234 TABLE 9: SUMMARY OF URC ....................................................................................................................... 236 TABLE 10: DIFFERENT CODING SCHEMES OF +CME ERROR: ................................................... 239 TABLE 11: DIFFERENT CODING SCHEMES OF +CMS ERROR: ................................................... 243 TABLE 12: LOCATION ID FOR THE EXTENDED ERROR REPORT ............................................................ 245 TABLE 13: CAUSE FOR PROTOCOL STACK (PS) LAYER........................................................................... 245 TABLE 14: INTERNAL CAUSE FOR MM LAYER ........................................................................................... 257 TABLE 15: CAUSE FOR PPP/IP-STACK ........................................................................................................ 258 MC20&MC30_AT_Commands_Manual 9 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 1 Introduction 1.1. Scope of the Document This document presents the AT Commands Set for Quectel cellular engines MC20 and MC30. 1.2. AT Command Syntax The 'AT' or 'at' prefix must be set at the beginning of each command line. To terminate a command line enter . Commands are usually followed by a response that includes ''. Throughout this document, only the responses are presented, '' are omitted intentionally. The AT Commands Set implemented by MC20 & MC30 is a combination of GSM07.05, GSM07.07 and ITU-T recommendation V.25ter as well as the AT commands developed by Quectel. All these AT commands can be split into three categories syntactically: 'basic', 'S parameter', and 'extended'. They are listed as follows:  Basic syntax These AT commands have the format of 'AT', or 'AT&', where '' is the command, and '' is/are the argument(s) for that command. An example of this is 'ATE', which tells the DCE whether received characters should be echoed back to the DTE according to the value of ''. '' is optional and a default will be used if it is missing.  S parameter syntax These AT commands have the format of 'ATS=', where '' is the index of the S register to set, and '' is the value to assign to it.  Extended syntax These commands can be operated in several modes, as following table: MC20&MC30_AT_Commands_Manual 10 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Table 1: Types of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? AT+? AT+= AT+ This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. This command returns the currently set value of the parameter or parameters. This command sets the user-definable parameter values. This command reads non-variable parameters affected by internal processes in the GSM engine. 1.2.1. Combining AT Commands on the Same Command Line You can enter several AT commands on the same line. In this case, you do not need to type the 'AT' or 'at' prefix before every command. Instead, you only need to type 'AT' or 'at' at the beginning of the command line. Please note that use a semicolon as command delimiter. The command line buffer can accept a maximum of 256 characters. If the input characters exceeded the maximum, then no command will be executed and TA will return 'ERROR'. 1.2.2. Entering Successive AT Commands on Separate Lines When you need to enter a series of AT commands on separate lines, please note that you need to wait the final response (for example OK, CME error, CMS error) of the last AT command you entered before you enter the next AT command. 1.3. Supported Character Sets MC20/MC30 AT command interface defaults to the GSM character set. The module supports the following character sets:  GSM  UCS2  HEX  IRA  PCCP437  8859-1 The character set can be configured and interrogated using the AT+CSCS command (GSM 07.07). The character set is defined in GSM specification 07.05. The character set affects transmission and reception of SMS and SMS Cell Broadcast Messages, as well as the entry and display of phone book entries text MC20&MC30_AT_Commands_Manual 11 / 259 field and (U)SIM Application Toolkit alpha strings. GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 1.4. Flow Control Flow control is very important for correct communication between the GSM engine and the DTE. In cases such as a data or fax call, the sending device is transferring data faster than the receiving side ready to accept. When the receiving buffer reaches its capacity, the receiving device should be able to cause the sending device to pause until it catches up. There are basically two approaches to achieve data flow control: software flow control and hardware flow control. MC20/MC30 supports both two kinds of flow control. In multiplex mode, it is recommended to use the hardware flow control. The default flow control approach of MC20/MC30 is disabled. 1.4.1. Software Flow Control (XON/XOFF Flow Control) Software flow control sends different characters to stop (XOFF, decimal 19) and resume (XON, decimal 17) data flow. It is quite useful in some applications that only use three wires on the serial interface. The default flow control approach of MC20/MC30 is disabled. To enable software flow control in the DTE interface and within GSM engine, type the following AT command: AT+IFC=1,1 This setting is stored in volatile memory, for use after restart. AT+IFC=1,1 should be stored to the user profile with AT&W. Ensure that all communication software packages (e.g. ProComm Plus, Hyper Terminal or WinFax Pro) use software flow control. NOTE Software Flow Control should not be used for data calls where binary data will be transmitted or received (e.g. TCP/IP), because the DTE interface may interpret binary data as flow control characters. MC20&MC30_AT_Commands_Manual 12 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 1.4.2. Hardware Flow Control (RTS/CTS Flow Control) The default flow control approach of MC20/MC30 is disabled. To enable hardware flow control (RTS/CTS flow control) in the DTE interface and within GSM engine, type the following AT command: AT+IFC=2,2 This setting is stored volatile, for use after restart. AT+IFC=2,2 should be stored to the user profile with AT&W. Hardware flow control achieves the data flow control by controlling the RTS/CTS line. When the data transfer is suspended, the CTS line is set inactive until the transfer from the receiving buffer has been completed. When the receiving buffer is ready to receive more data, CTS goes active once again. To achieve hardware flow control, ensure that the RTS/CTS lines are available on your application platform. 1.5. Unsolicited Result Codes A URC is a report message sent from the ME to the TE. An unsolicited result code can be delivered automatically when an event occurs, reflect changes in system state, or act as the result of a query the ME received before. It is often delivered due to occurrences of errors in executing the queries. However, a URC is not issued as a direct response to an executed AT command. AT commands have their own implementations to validate inputs such as OK or ERROR. Typical URCs may be information about incoming calls, received SMS, changing temperature, status of the battery, etc. A summary of URCs is listed in Chapter 16.6. When sending a URC, the ME activates its Ring Interrupt (Logic 'l'), i.e. the line goes active low for a few milliseconds. If an event which delivers a URC coincides with the execution of an AT command, the URC will be output after command execution has been completed. MC20&MC30_AT_Commands_Manual 13 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2 General Commands 2.1. ATI Display Product Identification Information ATI Display Product Identification Information Execution Command ATI Response TA returns a product information text. Quectel_Ltd Revision: Maximum Response Time Reference V.25ter OK 300ms Parameter Identifier of device type Identification text of product software version Example ATI Quectel_Ltd Quectel_MC30 Revision: MC30CAR01A01 OK MC20&MC30_AT_Commands_Manual 14 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2.2. AT+GMI Request Manufacturer Identification AT+GMI Request Manufacturer Identification Test Command AT+GMI=? Execution Command AT+GMI Response OK Response TA reports one or more lines of information text which permits the user to identify the manufacturer. Quectel_Ltd Revision: MTK 0828 Maximum Response Time Reference V.25ter OK 300ms Parameter Identifier of device type 2.3. AT+GMM Request TA Model Identification AT+GMM Request TA Model Identification Test Command AT+GMM=? Execution Command AT+GMM Response OK Response TA returns a product model identification text. Maximum Response Time Reference V.25ter OK 300ms MC20&MC30_AT_Commands_Manual 15 / 259 Parameter Identifier of device type GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2.4. AT+GMR Request TA Revision Identification of Software Release AT+GMR Request TA Revision Identification of Software Release Test Command AT+GMR=? Execution Command AT+GMR Response OK Response TA reports one or more lines of information text which permits the user to identify the revision of software release. Revision: Maximum Response Time Reference V.25ter OK 300ms Parameter Identification text of product software version Example AT+GMR Revision: MC30CAR01A01 OK 2.5. AT+GOI Request Global Object Identification AT+GOI Request Global Object Identification Test Command AT+GOI=? Execution Command AT+GOI Response OK Response TA reports one or more lines of information text which permits MC20&MC30_AT_Commands_Manual 16 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference V.25ter the user to identify the device, based on the ISO system for registering unique object identifiers. OK 300ms Parameter Identifier of device type NOTE See CCITT Recommendation X.208 and CCITT Recommendation 209 for the format of . For example, in MC20 or MC30 module, string 'MC20' or 'MC30' is displayed. 2.6. AT+CGMI Request Manufacturer Identification AT+CGMI Request Manufacturer Identification Test Command AT+CGMI=? Execution Command AT+CGMI Response OK Response TA returns manufacturer identification text. Quectel_Ltd Revision: MTK 0828 Maximum Response Time Reference GSM 07.07 OK 300ms Parameter Identifier of device type MC20&MC30_AT_Commands_Manual 17 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2.7. AT+CGMM Request Model Identification AT+CGMM Request Model Identification Test Command AT+CGMM=? Execution Command AT+CGMM Response OK Response TA returns product model identification text. Maximum Response Time Reference GSM 07.07 OK 300ms Parameter Identifier of device type 2.8. AT+CGMR Request TA Revision Identification of Software Release AT+CGMR Request TA Revision Identification of Software Release Test Command AT+CGMR=? Execution Command AT+CGMR Response OK Response TA returns product software version identification text. Revision: Maximum Response Time Reference GSM 07.07 OK 300ms Parameter Identification text of product software version MC20&MC30_AT_Commands_Manual 18 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2.9. AT+GSN Request International Mobile Equipment Identity (IMEI) AT+GSN Request International Mobile Equipment Identity (IMEI) Test Command AT+GSN=? Execution Command AT+GSN Response OK Response TA reports the IMEI (International Mobile Equipment Identity) number in information text which permits the user to identify the individual ME device. Maximum Response Time Reference V.25ter OK 300ms Parameter IMEI of the ME NOTE The serial number (IMEI) varies with the individual ME device. 2.10. AT+CGSN Request Product Serial Number Identification The command returns International Mobile Equipment Identity (IMEI) number of ME. It is identical with AT+GSN. AT+CGSN Request Product Serial Number Identification Test Command AT+CGSN=? Execution Command AT+CGSN Response OK Response Maximum Response Time OK 300ms MC20&MC30_AT_Commands_Manual 19 / 259 Reference GSM 07.07 Parameter IMEI of the ME GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTE The serial number (IMEI) varies with the individual ME device. 2.11. AT+QGSN Request Product Serial Number Identification (IMEI) AT+QGSN Request Product Serial Number Identification (IMEI) Test Command AT+QGSN=? Execution Command AT+QGSN Response OK Response +QGSN: Maximum Response Time Reference OK 300ms Parameter A string parameter which indicates the IMEI of the ME NOTE The serial number (IMEI) varies with the individual ME device. Example AT+QGSN +QGSN: '865734020000749' //Query the IMEI OK MC20&MC30_AT_Commands_Manual 20 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2.12. AT&F Set All Current Parameters to Manufacturer Defaults AT&F Set All Current Parameters to Manufacturer Defaults Execution Command AT&F[] Response TA sets all current parameters to the manufacturer defined profile. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 Set all TA parameters to manufacturer defaults NOTE The command resets AT command settings to manufacturer default values. However, it does not change the current baud rate of UART. 2.13. AT&V Display Current Configuration AT&V Display Current Configuration Execution Command AT&V[] Response TA returns the current parameter setting. ACTIVE PROFILE OK Maximum Response Time 300ms Reference V.25ter Parameter 0 Profile number MC20&MC30_AT_Commands_Manual 21 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Table 2: Current Configuration List When Executing AT&V Command AT&V or AT&V0 AT&V ACTIVE PROFILE E: 1 Q: 0 V: 1 X: 4 S0: 0 S2: 43 S3: 13 S4: 10 S5: 8 S6: 2 S7: 60 S8: 2 S10: 15 +CR: 0 +FCLASS: 0 +CMGF: 0 +CSDH: 0 +ILRR: 0 +CMEE: 1 +CBST: 7,0,1 +IFC: 0,0 +ICF: 3,3 +CNMI: 2,1,0,0,0 +CSCS: 'GSM' +IPR: 0 &C: 1 &D: 0 +CSTA: 129 +CCWE: 0 +QSIMSTAT: 0 +CMUX: -1 +CCUG: 0,0,0 +CLIP: 0 +COLP: 0 +CCWA: 0 +CAOC: 1 +CLIR: 0 +CUSD: 0 +CREG: 0 MC20&MC30_AT_Commands_Manual 22 / 259 +QSIMDET: 0,0,0 +QMIC: 4,9,8 +QSIDET(NORMAL_AUDIO): 80 +QSIDET(HEADSET_AUDIO): 144 +QCLIP: 0 +QCOLP: 0 +CSNS: 0 OK GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2.14. AT&W Store Current Parameters to User Defined Profile AT&W Store Current Parameters to User Defined Profile Execution Command AT&W[] Response TA stores the current parameter setting in the user defined profile. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 Profile number to store current parameters NOTE The profile defined by user is stored in nonvolatile memory. 2.15. ATQ Set Result Code Presentation Mode ATQ Set Result Code Presentation Mode Execution Command ATQ[] Response This parameter setting determines whether or not the TA transmits any result code to the TE. Information text transmitted in response is not affected by this setting. MC20&MC30_AT_Commands_Manual 23 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference V.25ter If =0: OK If =1: (none) 300ms Parameter 0 1 TA transmits result code Result codes are suppressed and not transmitted 2.16. ATV TA Response Format ATV TA Response Format Execution Command ATV[] Maximum Response Time Reference V.25ter Response This parameter setting determines the contents of the header and trailer transmitted with result codes and information responses. When =0: 0 When =1: OK 300ms Parameter 0 1 Information response: Short result code format: Information response: Long result code format: NOTE The result codes, their numeric equivalents and brief descriptions of the use of each are listed in the following table. MC20&MC30_AT_Commands_Manual 24 / 259 Example ATV1 OK AT+CSQ +CSQ: 30,0 OK ATV0 0 AT+CSQ +CSQ: 30,0 0 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual //Set =1 //When =1, the result code is OK //Set =0 //When =0, the result code is 0 Table 3: ATV0&ATV1 Result Codes Numeric Equivalents and Brief Descriptions ATV1 OK CONNECT RING NO CARRIER ERROR NO DIALTONE BUSY NO ANSWER PROCEEDING CONNECT ATV0 Description 0 Acknowledges execution of a command A connection has been established; the DCE is moving 1 from command mode to data mode The DCE has detected an incoming call signal from 2 network. The connection has been terminated or the attempt to 3 establish a connection is failed. Command not recognized, command line maximum 4 length exceeded, parameter value invalid, or other problem with processing the command line 6 No dial tone detected 7 8 9 Manufacturer-specific Engaged (busy) signal detected '@' (Wait for Quiet Answer) dial modifier was used, but remote ringing followed by five seconds of silence was not detected before expiration of the connection timer (S7) An AT command is being processed Same as CONNECT, but includes manufacturerspecific text that may specify DTE speed, line speed, error control, data compression, or other status. MC20&MC30_AT_Commands_Manual 25 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2.17. ATX Set CONNECT Result Code Format and Monitor Call Progress ATX Set CONNECT Result Code Format and Monitor Call Progress Execution Command ATX[] Response This parameter setting determines whether or not the TA detected the presence of a dial tone or busy signal, and whether or not the TA transmits particular result codes. OK Maximum Response Time 300ms Reference V.25ter Parameter 0 1 2 3 4 CONNECT result code returned only. Dial tone and busy signal detection are both disabled. CONNECT result code returned only. Dial tone and busy signal detection are both disabled. CONNECT result code returned. Dial tone detection is enabled, while busy signal detection is disabled. CONNECT result code returned. Dial tone detection is disabled, while busy signal detection is enabled. CONNECT result code returned. Dial tone and busy signal detection are both enabled. NOTES 1. If parameter is omitted, the command has the same behavior as ATX0. 2. The factory default is =4. 2.18. ATZ Set All Current Parameters to User Defined Profile ATZ Set All Current Parameters to User Defined Profile Execution Command ATZ[] Response TA sets all current parameters to the user defined profile. OK Maximum Response Time 300ms MC20&MC30_AT_Commands_Manual 26 / 259 Reference V.25ter Parameter 0 Reset to profile number 0 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. The command restores the current AT command settings to the user defined profile in non-volatile memory, if one was stored with AT&W before. 2. Any additional AT commands on the same command line are ignored. 3. The command will not change the current baud rate of UART. 4. If the user profile is invalid, it will default to the factory default profile. 2.19. AT+CFUN Set ME Functionality AT+CFUN Set ME Functionality Test Command AT+CFUN=? Response +CFUN: (list of supported s),(list of supported s) Read Command AT+CFUN? OK Response +CFUN: Write Command AT+CFUN=[,] OK Response OK Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 15s, determined by network. Parameter 0 Minimum functionality MC20&MC30_AT_Commands_Manual 27 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 1 Full functionality (Default) 4 Disable the ME from both transmitting and receiving RF signals 0 Do not reset the ME before setting it to power level This is default when is not given 1 Reset the ME before setting it to power level Example AT+CFUN=0 +CPIN: NOT READY OK AT+COPS? +COPS: 0 OK AT+CPIN? +CME ERROR: 13 AT+CFUN=1 OK +CPIN: SIM PIN AT+CPIN=1234 +CPIN: READY OK Call Ready AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE' OK //Switch the ME to minimum functionality //Not registered to any operator //(U)SIM failure //Switch the ME to full functionality //Registered to an operator 2.20. AT+QPOWD Power off AT+QPOWD Power off Write Command AT+QPOWD= Response When =0: MC20&MC30_AT_Commands_Manual 28 / 259 Maximum Response Time Reference GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual OK When =1: NORMAL POWER DOWN 300ms Parameter 0 1 Urgent power off (Do not send out URC NORMAL POWER DOWN) Normal power off (Send out URC NORMAL POWER DOWN) Example AT+QPOWD=0 OK AT+QPOWD=1 NORMAL POWER DOWN //Urgent power off: returns OK //Normal power off: sends out URC NORMAL POWER DOWN 2.21. AT+CMEE Report Mobile Equipment Error AT+CMEE Report Mobile Equipment Error Test Command AT+CMEE=? Response +CMEE: (list of supported s) Read Command AT+CMEE? OK Response +CMEE: Write Command AT+CMEE=[] Maximum Response Time Reference GSM 07.07 OK Response TA disables or enables the use of result code +CME ERROR: as an indication of an error related to the functionality of the ME. OK 300ms MC20&MC30_AT_Commands_Manual 29 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 0 1 2 Disable result code Enable result code and use numeric values Enable result code and use verbose values Example AT+CMEE=0 OK AT+CPIN=1234 ERROR AT+CMEE=1 OK AT+CPIN=1234 +CME ERROR: 10 AT+CMEE=2 OK AT+CPIN=1234 +CME ERROR: SIM not inserted //Disable result code //Only ERROR will be displayed //Enable error result code with numeric values //Enable error result code with verbose (string) values 2.22. AT+CSCS Select TE Character Set AT+CSCS Select TE Character Set Test Command AT+CSCS=? Response +CSCS: (list of supported s) Read Command AT+CSCS? OK Response +CSCS: Write Command AT+CSCS= Maximum Response Time Reference GSM 07.07 OK Response Set character set which is used by the TE. The TA can then convert character strings correctly between the TE and ME character sets. OK 300ms MC20&MC30_AT_Commands_Manual 30 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 'GSM' 'HEX' 'IRA' 'PCCP437' 'UCS2' '8859-1' GSM default alphabet Character strings consist only of hexadecimal numbers from 00 to FF International reference alphabet PC character set code UCS2 alphabet ISO 8859 Latin 1 character set Example AT+CSCS? +CSCS: 'GSM' OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' OK //Query the current character set //Set the character set to 'UCS2' 2.23. AT+GCAP Request Complete TA Capabilities List AT+GCAP Request Complete TA Capabilities List Test Command AT+GCAP=? Execution Command AT+GCAP Response OK Response TA reports a list of additional capabilities. +GCAP: Maximum Response Time Reference V.25ter OK 300ms Parameter +CGSM GSM function is supported +FCLASS FAX function is supported MC20&MC30_AT_Commands_Manual 31 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 3 Serial Interface Control Commands 3.1. AT&C Set DCD Function Mode AT&C Set DCD Function Mode Execution Command AT&C[] Maximum Response Time Reference V.25ter Response This parameter determines how the state of circuit 109 (DCD) relates to the detection of received line signal from the distant end. OK 300ms Parameter 0 1 DCD (data carrier detection) function is always ON DCD (data carrier detection) function is ON only in the presence of data carrier 3.2. AT&D Set DTR Function Mode AT&D Set DTR Function Mode Execution Command AT&D[] Maximum Response Time Reference V.25ter Response This parameter determines how the TA responds when circuit 108/2 (DTR) is changed from low to high level during data mode. OK 300ms MC20&MC30_AT_Commands_Manual 32 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 0 TA ignores status on DTR. 1 LowHigh on DTR: Change to command mode while remaining the connected call. 2 LowHigh on DTR: Disconnect data call and change to command mode. When DTR is in high level, auto-answer function is disabled. 3.3. AT+ICF Set TE-TA Control Character Framing AT+ICF Set TE-TA Control Character Framing Test Command AT+ICF=? Response +ICF: (list of supported s),(list of supported s) Read Command AT+ICF? OK Response +ICF: , Write Command AT+ICF=[,] Maximum Response Time Reference V.25ter OK Response This parameter setting determines the serial interface character framing format and parity received by TA from TE. OK 300ms Parameter 1 2 3 4 5 6 0 1 2 3 8 data 0 parity 2 stop 8 data 1 parity 1 stop 8 data 0 parity 1 stop 7 data 0 parity 2 stop 7 data 1 parity 1 stop 7 data 0 parity 1 stop Odd Even Mark Space MC20&MC30_AT_Commands_Manual 33 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. The command is applied for command mode. 2. The field is ignored if the field specifies no parity. 3.4. AT+IFC Set TE-TA Local Data Flow Control AT+IFC Set TE-TA Local Data Flow Control Test Command AT+IFC=? Response +IFC: (list of supported s),(list of supported s) Read Command AT+IFC? OK Response +IFC: , Write Command AT+IFC=, OK Response This parameter setting determines the data flow control on the serial interface for data mode. OK Maximum Response Time 300ms Reference V.25ter Parameter Specifies the method that will be used by TE when receiving data from TA 0 None 1 XON/XOFF 2 RTS flow control Specifies the method that will be used by TA when receiving data from TE 0 None 1 XON/XOFF 2 CTS flow control Example AT+IFC=2,2 OK MC20&MC30_AT_Commands_Manual //Open the hardware flow control 34 / 259 AT+IFC? +IFC: 2,2 OK GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 3.5. AT+IPR Set TE-TA Fixed Local Rate AT+IPR Set TE-TA Fixed Local Rate Test Command AT+IPR=? Response +IPR: (list of supported auto detectable s),(list of supported fixed-only s) Read Command AT+IPR? OK Response +IPR: Write Command AT+IPR= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the data rate of the TA on the serial interface. After the delivery of any result code associated with the current command line, the rate set by the command takes effect. OK 300ms Parameter Baud rate per second 0 (Autobauding) 300 600 1200 2400 4800 9600 14400 19200 28800 38400 MC20&MC30_AT_Commands_Manual 35 / 259 57600 115200 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. The default configuration of AT+IPR is adaptive baud rate enabled (AT+IPR=0). 2. If a fixed baud rate is set, make sure that both TE (DTE, usually external processor) and TA (DCE, Quectel GSM module) are configured to the same rate. If adaptive baud rate is enabled, the TA could automatically recognize the baud rate currently used by the TE after receiving 'AT' or 'at' string. 3. The value of AT+IPR cannot be restored with AT&F and ATZ, but it is still storable with AT&W and visible in AT&V. 4. In multiplex mode, the baud rate cannot be changed by the write command AT+IPR=, and the setting is invalid and not stored even if AT&W is executed after the write command. 5. A selected baud rate takes effect after the Write Commands are executed and acknowledged by OK. Example AT+IPR=115200 OK AT&W OK AT+IPR? +IPR: 115200 OK //Set fixed baud rate to 115200bps //Store current setting, that is, the serial communication speed is 115200bps after restarting module. 3.5.1. Adaptive Baud Rate To take advantage of adaptive baud rate mode, specific attention must be paid to the following requirements: 1. Adaptive baud rate synchronization between TE and TA.  Ensure that TE and TA are correctly synchronized and the baud rate used by the TE is detected by the TA. The baud rate can be synchronized simply by use an 'AT' or 'at' string. This is necessary after customer activates adaptive baud rate or when customer starts up the module with adaptive baud rate enabled.  It is recommended to wait for 2 to 3 seconds before sending the first 'AT' or 'at' string after the module is started up with adaptive baud rate enabled. Otherwise undefined characters might be returned. MC20&MC30_AT_Commands_Manual 36 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2. Restriction on adaptive baud rate operation.  The serial interface shall be used with 8 data bits, no parity and 1 stop bit (factory setting).  The command 'A/' can’t be used.  Only the string 'AT' or 'at' can be detected (either 'AT' or 'at').  URCs that may be issued before the TA detect a new baud rate by receiving the first AT character, and they will be sent at the previously detected baud rate.  If TE’s baud rate is changed after TA has recognized the earlier baud rate, loss of synchronization between TE and TA would be encountered and an 'AT' or 'at' string must be re-sent by TE to regain synchronization on baud rate. To avoid undefined characters during baud rate resynchronization and the possible malfunction of resynchronization, it is not recommended to switch TE’s baud rate when adaptive baud rate is enabled. Especially, this operation is forbidden in data mode. 3. Adaptive baud rate and baud rate after restarting.  In the adaptive baud rate mode, the detected baud rate is not saved. Therefore, resynchronization is required after restarting the module.  Unless the baud rate is determined, an incoming CSD call can’t be accepted. This must be taken into account when adaptive baud rate and auto-answer mode (ATS0≠0) are enabled at the same time, especially if (U)SIM PIN 1 authentication is done automatically and the setting ATS0≠0 is stored to the user profile with AT&W.  Until the baud rate is synchronized, URCs after restarting will not be output when adaptive baud rate is enabled. 4. Adaptive baud rate and multiplex mode. If adaptive baud rate is active, it is not recommended to switch to multiplex mode. 5. Adaptive baud rate and Windows modem.  The baud rate used by Windows modem can be detected while setting up a dial-up GPRS/CSD connection. However, some Windows modem drivers switch TE’s baud rate to default value automatically after the GPRS call is terminated. In order to prevent no response to the Windows modem when it happens, it is not recommended to establish the dial-up GPRS/CSD connection in adaptive baud rate mode.  Based on the same considerations, it is also not recommended to establish the FAX connection in adaptive baud rate mode for PC FAX application, such as WinFax. NOTE To assure reliable communication and avoid any problem caused by undetermined baud rate between DCE and DTE, it is strongly recommended to configure a fixed baud rate and save it instead of using adaptive baud rate after start-up. MC20&MC30_AT_Commands_Manual 37 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 3.6. AT+CMUX Multiplexer Control AT+CMUX Multiplexer Control Test Command AT+CMUX=? Response +CMUX: (list of supported s),(s),(s),(s),(s),(s),(s),(s),(s) Read Command AT+CMUX? OK Response +CMUX: ,0,5,127,10,3,30,10,2 OK Write Command AT+CMUX=[[,[,[,[,[,[,[,[,]]]]]]]]] If there is any error, response: ERROR Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference GSM 07.07 Parameter Multiplexer transparency mechanism 0 Basic option The way by which the multiplexer control channel is set up 0 UIH frames used only Transmission rate 5 115200bit/s Maximum frame size 127 Acknowledgement timer in a unit of ten milliseconds 10 Maximum number of re-transmissions 3 Response timer for the multiplexer control channel in a unit of ten milliseconds 30 Wake up response timers in seconds 10 MC20&MC30_AT_Commands_Manual 38 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Window size, for advanced operation with Error Recovery options 2 NOTES 1. Advanced option with Error Recovery options is not supported. 2. The multiplexing transmission rate is fixed according to the current serial baud rate. It is recommended to enable multiplexing protocol under 115200bps baud rate. 3. Multiplexer control channels are listed as follows: Channel Number Type DLCI None Multiplexer Control 0 1 07.07 and 07.05 1 2 07.07 and 07.05 2 3 07.07 and 07.05 3 4 07.07 and 07.05 4 3.7. AT+QEAUART Configure Multi UART Function AT+QEAUART Configure Multi UART Function Test Command AT+QEAUART=? Response +QEAUART: (list of supported s), Read Command AT+QEAUART? OK Response +QEAUART: , OK Write Command AT+QEAUART=, If there is any error, response: ERROR Response OK Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300ms MC20&MC30_AT_Commands_Manual 39 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 0 1 2 3 2 3 99 Disable multi UART function UART 1 and UART 3 are used as AT UART port UART 1 and UART 2 are used as AT UART port UART 1, UART 2 and UART 3 are used as AT UART port UART 2 is used as debug port UART 3 is used as debug port No UART port is used as debug port NOTES 1. When multi UART function is enabled, the Debug UART port can be used to execute AT commands. For more details about the Debug UART port, please refer to document [8] and document [9]. 2. The Aux UART port cannot be used to execute data transmission-related AT commands. It is used for modem communication with MC20 or MC30’s embedded GNSS engine. 3.8. AT+QSEDCB Configure Parameters of the Multi UART AT+QSEDCB Configure Parameters of the Multi UART Test Command AT+QSEDCB=? Response +QSEDCB: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+QSEDCB? OK Response +QSEDCB: ,,,< parity>[; ,,,] OK Write Command AT+QSEDCB=,, ,, If there is any error, response: ERROR Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms MC20&MC30_AT_Commands_Manual 40 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Reference Quectel Parameter Baud rate 1200 2400 4800 9600 14400 19200 28800 38400 57600 115200 Data bits 5 6 7 8 Stop bits 1 2 3 Parity 0 None 1 Odd 2 Even 3 Mark The UART port to be configured 2 The selected UART port is UART 2 3 The selected UART port is UART 3 NOTES 1. This command can be saved by AT&W. 2. When multi UART port function is enabled, the AT+QSEDCB command will be executed successfully; otherwise an error will be returned. MC20&MC30_AT_Commands_Manual 41 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 4 Status Control Commands 4.1. AT+CEER Extended Error Report AT+CEER Extended Error Report Test Command AT+CEER=? Execution Command AT+CEER Response OK Response TA returns an extended report of the reason for the last call release. +CEER: , Maximum Response Time Reference GSM 07.07 OK 300ms Parameter Location ID as number code. Location IDs are listed in Table 12. Each ID is related with another table that contains a list of s. Reason for last call release as number code. The number codes are listed in several tables, sorted by different categories. The tables can be found proceeding from the Location ID given in Chapter 16.9. Example AT+CEER +CEER: 0,0 OK ATD10086; OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' //Query error reporting in normal state, return 'No error' MC20&MC30_AT_Commands_Manual 42 / 259 OK NO CARRIER AT+CEER +CEER: 1,16 OK GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual //Established a call and the remote party hangs up the call //Query error reporting, the =1 means 'Cause for protocol stack (PS) layer', =16 means 'Normal call clearing' 4.2. AT+CPAS Mobile Equipment Activity Status AT+CPAS Mobile Equipment Activity Status Test Command AT+CPAS=? Response +CPAS: (list of supported s) Execution Command AT+CPAS OK Response TA returns the activity status of ME. +CPAS: OK Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 2 3 4 Ready Unknown (ME is not guaranteed to respond to instructions) Ringing Call in progress or call hold Example AT+CPAS +CPAS: 0 //Module is idle MC20&MC30_AT_Commands_Manual 43 / 259 OK ATD10086; OK AT+CLCC +CLCC: 1,0,3,0,0,'10086',129,'' OK AT+CPAS +CPAS: 3 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK AT+CPAS +CPAS: 4 OK GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual //An incoming call is ringing //Call in progress 4.3. AT+QINDRI RI Indication When Using URC AT+QINDRI RI Indication When Using URC Test Command AT+QINDRI=? Response +QINDRI: (list of supported s) Read Command AT+QINDRI? OK Response +QINDRI: Write Command AT+QINDRI= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms MC20&MC30_AT_Commands_Manual 44 / 259 Parameter 0 Off 1 On GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 4.4. AT+QMOSTAT Show State of Mobile Originated Call AT+QMOSTAT Show State of Mobile Originated Call Test Command AT+QMOSTAT=? Response +QMOSTAT: (list of supported s) Read Command AT+QMOSTAT? OK Response +QMOSTAT: Write Command AT+QMOSTAT= Maximum Response Time Reference Quectel OK Response OK If there is an error, response: ERROR 300ms Parameter 0 1 Do not show call state of mobile originated call Show call state of mobile originated call. After dialing call numbers, the URC string of MO RING will be sent if the called party is alerted; and the URC string of MO CONNECTED will be sent if the call is established Example AT+QMOSTAT=1 OK ATD10086; OK MO RING //Show call state of mobile originated call //The called party is alerted MC20&MC30_AT_Commands_Manual 45 / 259 MO CONNECTED GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual //The call is established 4.5. AT+QREFUSECS Refuse to Receive SMS/Incoming Call or Not AT+QREFUSECS Refuse to Receive SMS/Incoming Call or Not Test Command AT+QREFUSECS=? Response +QREFUSECS: (list of supported s)[,(list of supported s)] Read Command AT+QREFUSECS? OK Response +QREFUSECS: , Write Command AT+QREFUSECS=[,] OK Response OK If there is any error, response: ERROR Maximum Response Time 300ms Reference Quectel Parameter 0 1 0 1 Receive the new SMS Refuse to receive the new SMS Receive the incoming call Refuse to receive the incoming call 4.6. AT+QIURC Enable or Disable Initial URC Presentation AT+QIURC Enable or Disable Initial URC Presentation Test Command AT+QIURC=? Response +QIURC: (list of supported s) Read Command OK Response MC20&MC30_AT_Commands_Manual 46 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+QIURC? Write Command AT+QIURC= Maximum Response Time Reference Quectel +QIURC: OK Response OK If there is any error, response: ERROR 300ms Parameter 0 1 Disable URC presentation Enable URC presentation NOTE When the module powers on and initialization procedure is over. URC Call Ready will be presented if is 1. 4.7. AT+QEXTUNSOL Enable/Disable Proprietary Unsolicited Indications AT+QEXTUNSOL Enable/Disable Proprietary Unsolicited Indications Test Command AT+QEXTUNSOL=? Response +QEXTUNSOL: (list of supported s) Write Command AT+QEXTUNSOL=, OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms MC20&MC30_AT_Commands_Manual 47 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter String type. Values currently reserved by the present document 'SQ' Signal Quality Report. Displays signal strength and channel bit error rate (similar to AT+CSQ) in form +CSQN: , when values change. 'FN' Forbidden network available only. When returning to a non-registered state, this indicates whether all the available PLMNs are forbidden. 'MW' SMS Message waiting. On receiving an SMS (as indicated by the +CMTI indication) the SMS is decoded and checked to see if it contains one or more of the message waiting indications (i.e. voicemail, email, fax, etc.). If so, an unsolicited indication is shown in the form for each message type: +QMWT: ,,,,,, where is the message store containing the SM; index is the message index and ; , , contain the number of waiting messages (with ‘0’ defined as clear indication, non-zero for one or more waiting messages) or blank for not specified in this message. 'UR' Unsolicited result code. Produces an unsolicited indication in the following call state transition. Multiple notifications may occur for the same transition +QGURC: , where describes the current call state: : 0 Terminated active call, at least one held call remaining 1 Attempt to make a Mobile Originated Call 2 Mobile Originated Call has failed for some reason 3 Mobile Originated Call is ringing 4 Mobile Terminated Call is queued (Call waiting) 5 Mobile Originated Call now has been connected 6 Mobile Originated or Mobile Terminated Call has been disconnected 7 Mobile Originated or Mobile Terminated Call is hung up. 8 Mobile Originated Call dialed a non-emergency number in emergency mode 9 No answer for Mobile Originated Call 10 Remote number busy for Mobile Originated Call 'BC' Battery Charge. Displays battery connection status and battery charge level (similar to AT+CBC) in form +CBCN: , when values change. 'BM' Band mode. Displays band mode (similar to AT+QBAND) in form +QBAND: when value changes. 'SM' Additional SMS Information. Displays additional information about SMS events in the form of unsolicited messages of the following format +TSMSINFO: where is a standard CMS error in the format defined by the AT+CMEE command i.e. either a number or a string. 'CC' Call information. Displays the disconnected call ID and the remaining call numbers after one of the calls is disconnected. +CCINFO: , 0 Disable MC20&MC30_AT_Commands_Manual 48 / 259 1 Enable 2 Query GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 4.8. AT+QINISTAT Query State of Initialization AT+QINISTAT Query State of Initialization Test Command AT+QINISTAT=? Execution Command AT+QINISTAT Response OK Response +QINISTAT: Maximum Response Time Reference Quectel OK 300ms Parameter 0 1 2 3 No initialization Ready to execute AT command Phonebook has finished initialization SMS has finished initialization NOTE When is 3, it also means initialization of (U)SIM card related functions has been finished. 4.9. AT+QNSTATUS Query GSM Network Status AT+QNSTATUS Query GSM Network Status Test Command AT+QNSTATUS=? Execution Command AT+QNSTATUS Response OK Response +QNSTATUS: OK MC20&MC30_AT_Commands_Manual 49 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 255 0 1 2 Not ready to retrieve network status Work in normal state No available cell Only limited service is available 4.10. AT+QNITZ Network Time Synchronization AT+QNITZ Network Time Synchronization Test Command AT+QNITZ=? Response +QNITZ: (list of supported s) Read Command AT+QNITZ? OK Response +QNITZ: Write Command AT+QNITZ= Maximum Response Time Reference Quectel OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 Disable to synchronize time from GSM network 1 Enable to synchronize time from GSM network If the function is enabled, on receiving network time message, an unsolicited indication is shown in the format of: +QNITZ: , MC20&MC30_AT_Commands_Manual 50 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual String type value. Format is 'yy/MM/dd,hh:mm:ss±zz,ds', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range: -47...+48). E.g. 6th of May 2004, 22:10:00 GMT+2 hours equals to '04/05/06,22:10:00+08' Daylight Saving Time. When it is zero, the format will be '04/05/06,22:10:00+08,0' NOTE This function needs support of local GSM network. And the unsolicited also can be read by AT+QLTS command later. 4.11. AT+QLTS Obtain Latest Network Time Synchronized AT+QLTS Obtain Latest Network Time Synchronized Test Command AT+QLTS=? Execution Command AT+QLTS Response OK Execution Command returns the latest time for network synchronization. Response +QLTS: , OK Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300ms Parameter String type value. Format is 'yy/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits), month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range: -47...+48). E.g. 6th of May 2004, 22:10:00 GMT+2 hours equals to '04/05/06,22:10:00+08' Daylight Saving Time. When it is zero, the format will be '04/05/06,22:10:00+08,0' MC20&MC30_AT_Commands_Manual 51 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 4.12. AT+CTZU Network Time Synchronization and Update the RTC Time AT+CTZU Network Time Synchronization and Update the RTC Time Test Command AT+CTZU=? Response +CTZU: (list of supported s) Read Command AT+CTZU? Write Command AT+CTZU= OK Response +CTZU: OK Response OK Maximum Response Time Reference If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 2 3 4 Disable automatic update RTC time via NITZ. Update network synchronized time to RTC and save time zone into NVRAM. Update GMT time with time zone to RTC, save time zone into NVRAM, and ignore daylight saving time. Update localized time and time zone to RTC, and save time zone into NVRAM. Same as =2 NOTE This function needs support of local GSM network. After setting the AT+CTZU, the value will be automatically saved into flash. After the module is restarted, it can also take effect. MC20&MC30_AT_Commands_Manual 52 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 4.13. AT+CTZR Network Time Synchronization Report AT+CTZR Network Time Synchronization Report Test Command AT+CTZR=? Response +CTZR: (list of supported s) Read Command AT+CTZR? Write Command AT+CTZR= OK Response +CTZR: OK Response OK Maximum Response Time Reference If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 2 Disable time zone change event reporting Enable time zone change event reporting by unsolicited result code +CTZV: Enable extended time zone reporting by unsolicited result code +CTZE: ,,[] NOTE This function needs support of local GSM network. After setting the AT+CTZU, the value will be automatically saved into flash. The function takes effect after the module is restarted. 4.14. AT+QSIMDET Enable/Disable (U)SIM Card Detection AT+QSIMDET Enable/Disable (U)SIM Card Detection Test Command AT+QSIMDET=? Response +QSIMDET: (list of supported s),(list of supported s),(list of supported s) MC20&MC30_AT_Commands_Manual 53 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Read Command AT+QSIMDET? OK Response +QSIMDET: ,, Write Command AT+QSIMDET=,, OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference Parameter Enable/Disable (U)SIM card detection function 0 Disable 1 Enable Configure pin level when (U)SIM card is inserted 0 Low level 1 High level Configure (U)SIM card detection pin 0 Configure SIM_PRESENCE (MC20) or SIM1_PRESENCE (MC30) as (U)SIM card detection pin 1 Configure DTR as (U)SIM card detection pin NOTES 1. This command can be saved by AT&W. 2. The pin of SIM_PRESENCE and DTR are multiplexed in MC20, and MC20 only supports DTR pin as (U)SIM card detection pin. If turning on the (U)SIM card detection function, it is recommended to set to 1. 4.15. AT+QSIMSTAT (U)SIM Inserted Status Reporting AT+QSIMSTAT (U)SIM Inserted Status Reporting Test Command AT+QSIMSTAT=? Response +QSIMSTAT: (list of supported s) MC20&MC30_AT_Commands_Manual 54 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Read Command AT+QSIMSTAT? Write Command AT+QSIMSTAT= Maximum Response Time Reference OK Response +QSIMSTAT: , OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Indicates whether to show an unsolicited event code that indicates whether the (U)SIM card has been inserted or removed 0 Disable (U)SIM card detection function 1 Enable (U)SIM card detection function Indicates whether (U)SIM card has been inserted 0 Low level of pin indicates (U)SIM card is present 1 High level of pin indicates (U)SIM card is present NOTE This command can be saved by AT&W. 4.16. AT+QCGTIND Circuit Switched Call or GPRS PDP Context Termination Indication AT+QCGTIND Circuit Switched Call or GPRS PDP Context Termination Indication Test Command AT+QCGTIND=? Response +QCGTIND: (list of supported s) OK MC20&MC30_AT_Commands_Manual 55 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Read Command AT+QCGTIND? Write Command AT+QCGTIND= Maximum Response Time Reference Quectel Response +QCGTIND: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A numeric parameter which indicates whether to enable an unsolicited event code indicating whether a circuit switched voice call, circuit switched data call or GPRS session has been terminated 0 Disable 1 Enable Connection type 0 Circuit switched voice call 1 Circuit switched data call 2 PPP connection NOTE When enabled, an unsolicited result code +QCGTIND: is returned after the connection has been terminated. Example ATD10086; OK +QCGTIND: 0 NO CARRIER //A circuit switched voice call has been terminated MC20&MC30_AT_Commands_Manual 56 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 5 (U)SIM Related Commands 5.1. AT+CIMI Request International Mobile Subscriber Identity (IMSI) AT+CIMI Request International Mobile Subscriber Identity (IMSI) Test Command AT+CIMI=? Execution Command AT+CIMI Response OK Response TA returns for identifying the individual (U)SIM card which is attached to ME. OK Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter International Mobile Subscriber Identity (string without double quotes) Example AT+CIMI 460023210226023 OK //Query IMSI number of (U)SIM card which is attached to ME MC20&MC30_AT_Commands_Manual 57 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 5.2. AT+CLCK Facility Lock AT+CLCK Facility Lock Test Command AT+CLCK=? Response +CLCK: (list of supported s) Write Command AT+CLCK=,,[, ] OK Response This command is used to lock, unlock or interrogate the ME or the network facility . Password is normally needed to perform such actions. When querying the status of a network service (=2) the response line for ‘not active’ case (=0) should be returned only if service is not active for any . If is not equal to 2 and the command is set successfully: OK If =2 and the command is set successfully: +CLCK: [,[ +CLCK: , class2....]] OK Maximum Response Time 5s Reference GSM 07.07 Parameter 'PS' 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' PH-SIM (lock Phone to (U)SIM card) (ME asks password when other than the current (U)SIM card inserted; ME may remember certain amount of previously used cards thus not requiring password when they are inserted) (U)SIM (lock (U)SIM card) ((U)SIM asks password in ME power-up and when this lock command is issued) BAOC (Bar All Outgoing Calls) (refer to GSM02.88[6] clause 1) BOIC (Bar Outgoing International Calls) (refer to GSM02.88[6] clause 1) BOIC-exHC (Bar Outgoing International Calls except to Home Country) (refer to GSM02.88[6] clause 1) BAIC (Bar All Incoming Calls) (refer to GSM02.88[6] clause 2) BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (refer to GSM02.88 [6] clause 2) MC20&MC30_AT_Commands_Manual 58 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 'AB' All Barring services (refer to GSM02.30[19]) (applicable only for =0) 'AG' All out Going barring services (refer to GSM02.30[19]) (applicable only for =0) 'AC' All in Coming barring services (refer to GSM02.30[19]) (applicable only for =0) 'FD' (U)SIM fixed dialing memory: If the mobile is locked to 'FD', only the phone numbers stored to the 'FD' memory can be dialed 'PF' Lock Phone to the very first (U)SIM card 'PN' Network Personalization (refer to GSM 02.22) 'PU' Network subset Personalization (refer to GSM 02.22) 'PP' Service Provider Personalization (refer to GSM 02.22) 'PC' Corporate Personalization (refer to GSM 02.22) 0 Unlock 1 Lock 2 Query status Password 1 Voice 2 Data 4 FAX 7 All telephony except SMS (Default) 8 Short message service 16 Data circuit sync 32 Data circuit async 0 Off 1 On Example AT+CLCK='SC', 2 +CLCK: 0 OK AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 +CLCK: 1 OK AT+CLCK='SC',0,'1234' OK //Query the status of (U)SIM card lock: unlock //Lock the (U)SIM card, and the password is 1234 //Query the status of (U)SIM card lock: lock //Unlock the (U)SIM card MC20&MC30_AT_Commands_Manual 59 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 5.3. AT+CPIN Enter PIN AT+CPIN Enter PIN Test Command AT+CPIN=? Read Command AT+CPIN? Write Command AT+CPIN=[,] Maximum Response Time Reference GSM 07.07 Response OK Response TA returns an alphanumeric string indicating whether or not some password is required. +CPIN: OK Response TA stores a password, such as (U)SIM PIN, (U)SIM PUK, PH-SIM PIN, etc., which is necessary before it can be operated. If the PIN is to be entered twice, the TA shall automatically repeat the PIN. If no PIN request is pending, no action is taken and an error message +CME ERROR is returned to TE. If the PIN required is (U)SIM PUK or (U)SIM PUK2, the second pin is required. This second pin is used to replace the old pin in the (U)SIM card. OK 5s Parameter READY SIM PIN SIM PUK PH_SIM PIN PH_SIM PUK SIM PIN2 SIM PUK2 String type. String type. No further entry needed ME is waiting for (U)SIM PIN ME is waiting for (U)SIM PUK ME is waiting for phone to (U)SIM card (antitheft) ME is waiting for (U)SIM PUK (antitheft) PIN 2, e.g. it is possible to edit the FDN book only if preceding command was acknowledged with +CME ERROR: 17 Possible only if preceding command was acknowledged with error +CME ERROR: 18 Password If the PIN required is (U)SIM PUK or (U)SIM PUK2: new password MC20&MC30_AT_Commands_Manual 60 / 259 Example AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 +CPIN: READY OK AT+CPIN? +CPIN: READY OK AT+CPIN? +CPIN: SIM PUK OK AT+CPIN='26601934','1234' +CPIN: READY OK AT+CPIN? +CPIN: READY OK GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual //Query PIN code is locked //PIN //PIN has already been entered //Query PUK code is locked //Enter PUK and new PIN password //PUK has already been entered 5.4. AT+CPWD Change Password AT+CPWD Change Password Test Command AT+CPWD=? Response TA returns a list of pairs which present the available facilities and the maximum length of their password. +CPWD: (list of supported s),(s) Write Command AT+CPWD=,, OK Response TA sets a new password for the facility lock function. OK Maximum Response Time 5s MC20&MC30_AT_Commands_Manual 61 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Reference GSM 07.07 Parameter 'PS' Phone locked to (U)SIM (device code). The 'PS' password may either be individually specified by the client or, depending on the subscription, supplied from the provider (e.g. with a prepaid mobile) 'SC' (U)SIM (lock (U)SIM card) ((U)SIM asks password in ME power-up and when this lock Command issued) 'AO' BAOC (Bar All Outgoing Calls) (refer to GSM02.88[6] clause 1) 'OI' BOIC (Bar Outgoing International Calls) (refer to GSM02.88[6] clause 1) 'OX' BOIC-exHC (Bar Outgoing International Calls except to Home Country) (refer to GSM02.88[6] clause 1) 'AI' BAIC (Bar All Incoming Calls) (refer to GSM02.88[6] clause 2) 'IR' BIC-Roam (Bar Incoming Calls when Roaming outside the home country) (refer to GSM02.88 [6] clause 2) 'AB' All Baring services (refer to GSM02.30[19]) (applicable only for =0) 'AG' All outgoing barring services (refer to GSM02.30[19]) (applicable only for =0 'AC' All incoming barring services (refer to GSM02.30[19]) (applicable only for =0) 'FD' (U)SIM fixed dialing memory feature 'P2' (U)SIM PIN2 Integer. Max length of password Password specified for the facility from the user interface or with command New password Example AT+CPIN? +CPIN: READY OK AT+CPWD='SC','1234','4321' OK AT+CPIN? +CPIN: SIM PIN OK AT+CPIN='4321' +CPIN: READY //Change (U)SIM card password to '4321' //Restart module or re-activate the (U)SIM card, query PIN code is locked //PIN must be entered to define a new password '4321' MC20&MC30_AT_Commands_Manual 62 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual OK 5.5. AT+CRSM Restricted (U)SIM Access AT+CRSM Restricted (U)SIM Access Test Command AT+CRSM=? Write Command AT+CRSM=[,[,,,[,]]] Response OK Response +CRSM: ,[,] OK Maximum Response Time Reference GSM 07.07 If there is any error, response: ERROR Or +CME ERROR: 300ms Parameter 176 READ BINARY 178 READ RECORD 192 GET RESPONSE 214 UPDATE BINARY 220 UPDATE RECORD 242 STATUS All other values are reserved; refer to GSM 11.11 Integer type. This is the identifier for an elementary data file on (U)SIM. Mandatory for every command except STATUS. ,, Integer type. Parameters passed on by the ME to the (U)SIM. These parameters are mandatory for every command, except GET RESPONSE and STATUS. The values are described in GSM 11.11. Information which shall be written to the (U)SIM (hexadecimal character format) , Integer type. Information from the (U)SIM about the execution of the actual command. These parameters are delivered to the TE in both cases, on successful or failed execution of the command. Response of a successful completion of the command previously issued (hexadecimal character format). STATUS and GET RESPONSE return data, which gives information about the current elementary data field. This information includes the type of file and its MC20&MC30_AT_Commands_Manual 63 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual size (refer to GSM 11.11). After READ BINARY or READ RECORD command the requested data will be returned. The parameter is not returned after a successful UPDATE BINARY or UPDATE RECORD command. Example AT+CRSM=242 +CRSM: 145, 211,'000000007F100200000000000A13000C0400838A808A' OK //=145, =211, '000000007F100200000000000 A13000C0400838A808A' is the content which is returned from (U)SIM card (refer to GSM 11.11) 5.6. AT+CSIM Generic (U)SIM Access AT+CSIM Generic (U)SIM Access Test Command AT+CSIM=? Write Command AT+CSIM=, Response OK Response +CSIM: , OK Maximum Response Time Reference GSM 07.07 If there is any error, response: ERROR Or +CME ERROR: 300ms Parameter Integer type. Length of characters sent to the TE in or (i.e. two times of octets in the raw data). String type (string should be included in quotation marks); Hex format: GSM11.11 (U)SIM Command sent from the ME to the SIM String type (string should be included in quotation marks); Hex format: GSM11.11 (U)SIM Command sent from the (U)SIM to MC20&MC30_AT_Commands_Manual 64 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. AT+CSIM is supported with limitation:  Only supports SELECT, STATUS, READ BINARY, UPDATE BINARY, READ RECORD, UPDATE RECORD, GET RESPONE commands.  Another application should not be selected, and termination indication or initialization indication should not be sent. If the user sends SELECT by AID, STATUS by initialization or termination, ERROR will be returned. 2. AT+CSIM is supported with GSM CLA and UICC CLA, but logical channels are not supported other than the default channel. 5.7. AT+QCSPWD Change PS Super Password AT+QCSPWD Change PS Super Password Test Command AT+QCSPWD=? Write Command AT+QCSPWD=, Response OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms Parameter String type. Old password and length should be 8 bytes. String type. New password and length should be 8 bytes. NOTES 1. The default value of is '12345678'. 2. If the module is locked to a specific (U)SIM card through AT+CLCK and the password is lost or (U)SIM state is PH-SIM PUK, then the super password can be used to unlock it. MC20&MC30_AT_Commands_Manual 65 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 5.8. AT+CCID Show CCID AT+CCID Show CCID Test Command AT+CCID=? Execution Command AT+CCID Maximum Response Time Reference Quectel Response OK Response +CCID: OK 300ms Parameter CCID number for the current (U)SIM card. Example AT+CCID +CCID: '898600220909A0206023' OK //Query CCID of the (U)SIM card 5.9. AT+QCCID Show CCID AT+QCCID Show CCID Test Command AT+QCCID=? Execution Command AT+QCCID Maximum Response Time Reference Quectel Response OK Response OK 300ms MC20&MC30_AT_Commands_Manual 66 / 259 Parameter CCID number for the current (U)SIM card. GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Example AT+QCCID 898600220909A0206023 OK //Query CCID of the (U)SIM card 5.10. AT+QGID Get (U)SIM Card Group Identifier AT+QGID Get (U)SIM Card Group Identifier Execution Command AT+QGID Response +QGID: OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms Parameter Integer type of (U)SIM card group identifier 1 Integer type of (U)SIM card group identifier 2 NOTE If the (U)SIM supports GID files, the GID values are retuned. Otherwise 0xff is retuned. MC20&MC30_AT_Commands_Manual 67 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 5.11. AT+QSIMVOL Select (U)SIM Card Operating Voltage AT+QSIMVOL Select (U)SIM Card Operating Voltage Test Command AT+QSIMVOL=? Response +QSIMVOL: (list of supported s) Read Command AT+QSIMVOL? OK Response +QSIMVOL: Write Command AT+QSIMVOL= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR Or +CME ERROR: 300ms Parameter 0 1 2 Recognize 1.8V and 3.0V (U)SIM card (Default) Recognize 1.8V (U)SIM card only Recognize 3.0V (U)SIM card only NOTE AT+QSIMVOL can take effect only when the command is set successfully and after the module is restarted. 5.12. AT+QSPN Get Service Provider Name from (U)SIM AT+QSPN Get Service Provider Name from (U)SIM Read Command AT+QSPN? Response +QSPN: (s),(list of supported s) MC20&MC30_AT_Commands_Manual 68 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter String type. Service provider name on (U)SIM. 0 Do not display PLMN. Already registered on PLMN 1 Display PLMN NOTE CME errors are possible if (U)SIM card is not inserted. 5.13. AT+QTRPIN Times Remained to Input (U)SIM PIN/PUK AT+QTRPIN Times Remained to Input (U)SIM PIN/PUK Execution Command AT+QTRPIN Response Times remained to input (U)SIM PIN. +QTRPIN: ,,, Maximum Response Time Reference Quectel OK 300ms Parameter Times remained to input CHV1 Times remained to input CHV2 Times remained to input PUK1 Times remained to input PUK2 MC20&MC30_AT_Commands_Manual 69 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 5.14. AT+QDSIM Dual (U)SIM Switching AT+QDSIM Dual (U)SIM Switching Test Command AT+QDSIM=? Response +QDSIM: (list of supported ) Read Command AT+QDSIM? OK Response +QDSIM: Write Command AT+QDSIM= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms Parameter 0 Switch to (U)SIM card 1 1 Switch to (U)SIM card 2 NOTE MC20/MC30 supports Dual SIM Single Standby function, and this command is used for switching between the two (U)SIM cards. 5.15. AT+CGLA Generic (U)SIM Logical Channel Access AT+CGLA Generic (U)SIM Logical Channel Access Test Command AT+CGLA=? Write Command AT+CGLA=,, Response OK Response +CGLA: , OK MC20&MC30_AT_Commands_Manual 70 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 27.007 If there is any error, response: ERROR Or +CME ERROR: 300ms Parameter integer type. This is the identifier of the session to be used in order to send the APDU commands to the UICC. It is mandatory in order to send commands to the UICC when targeting applications on the smart card using a logical channel other than the default channel (channel '0'). Integer type. The length of characters sent to the TE in or (i.e. two times of octets in the raw data). Command passed on by the MT to the UICC in the format of hexadecimal character as described in 3GPP TS 31.101 [65]. Please refer to AT +CSCS. Response to the command passed on by the UICC to the MT in the format of hexadecimal character as described in 3GPP TS 31.101 [65]. Please refer to AT +CSCS. NOTE This command is only supported by MC20 module with OC MC20ECA-04-BLE. MC20&MC30_AT_Commands_Manual 71 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 6 Network Service Commands 6.1. AT+COPS Operator Selection AT+COPS Operator Selection Test Command AT+COPS=? Response TA returns a list of quadruplets, each representing an operator present in the network. Any of the formats may be unavailable and should then be an empty field. The list of operators shall be in the order of: home network, networks referenced in (U)SIM, and other networks. +COPS: (list of supported , long alphanumeric , short alphanumeric , numeric s)[,(list of supported s),(list of supported s)] OK Read Command AT+COPS? If there is any error related to ME functionality: +CME ERROR: Response TA returns the current mode and the currently selected operator. If no operator is selected, and are omitted. +COPS: [,[,]] OK Write Command AT+COPS=[,[,]] If there is any error related to ME functionality: +CME ERROR: Response TA forces an attempt to select and register on the GSM network operator. If the selected operator is not available, no other operator shall be selected (except =4). The format of selected operator name shall apply to further read commands (AT+COPS?). OK MC20&MC30_AT_Commands_Manual 72 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 75s, determined by network. Parameter 0 Unknown 1 Operator available 2 Operator current 3 Operator forbidden Operator in format as per 0 Automatic mode; field is ignored 1 Manual operator selection; field shall be present 2 Manual deregister from network 3 Set only (for read command AT+COPS?) – not shown in read command response 4 Manual/automatic selected; if manual selection fails, automatic mode (=0) is entered 0 Long format alphanumeric ; can be up to 16 characters’ long 1 Short format alphanumeric 2 Numeric ; GSM Location Area Identification number NOTES 1. This write command is used to choose and register the GSM network operator. The setting of allows ME to determine whether automatic or manual network selection shall be used.  When =0, the ME searches for the operator which shall be used automatically.  When =1, the ME forces to register the selected . If the is invalid, the ME remains unregistered; until =0, the ME can register again. If restart module, the ME is still under =1 and there is no RPLMN. The ME will also be Not Registered on Network condition, until the mode is changed via the command to automatic registration mode.  When =4, if the ME fails to register to this operator, then it starts to select another operator automatically. 2. This command setting is saved to NVRAM automatically. Example AT+COPS=? //List all current network operators +COPS: (2,'CHINA MOBILE','CMCC','46000'),(3,'CHINA UNICOM GSM','UNICOM','46001') ,,(0-4),(0-2) OK MC20&MC30_AT_Commands_Manual 73 / 259 AT+COPS? +COPS: 0,0,'CHINA MOBILE' OK GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual //Query the currently selected network operator 6.2. AT+CREG Network Registration Status AT+CREG Network Registration Status Test Command AT+CREG=? Response +CREG: (list of supported s) Read Command AT+CREG? OK Response TA returns the status of result code presentation and an integer which shows whether the network has currently indicated the registration of the ME. Location information elements and are returned only when =2 and ME is registered in the network. +CREG: ,[,,] OK Write Command AT+CREG= Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: Response TA controls the presentation of an unsolicited result code +CREG: when =1 and there is a change in the ME network registration status. OK 300ms Parameter 0 1 2 0 1 2 Disable network registration unsolicited result code Enable network registration unsolicited result code +CREG: Enable network registration unsolicited result code with location information Not registered, ME is not currently searching a new network to register on Registered, home network Not registered, but ME is currently searching a new network to register on MC20&MC30_AT_Commands_Manual 74 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two-byte location area code in hexadecimal format String type. Two-byte cell ID in hexadecimal format NOTE Unsolicited result code If =1 and there is a change in the ME network registration status: +CREG: If =2 and there is a change in the ME network registration status or a change of the network cell: +CREG: [,,] Example AT+CREG=1 OK +CREG: 1 AT+CREG=2 OK +CREG: 1,'1878','0873' //URC reports that operator has been found //Activates extended URC mode //URC reports that operator has been found with location area code and cell ID 6.3. AT+CSQ Signal Quality Report AT+CSQ Signal Quality Report Test Command AT+CSQ=? The Test Command returns values supported by the TA. Response +CSQ: (list of supported s),(list of supported s) Execution Command AT+CSQ OK The Execution Command returns received signal strength indication and channel bit error rate from the ME. Response +CSQ: , OK If there is any error related to ME functionality: MC20&MC30_AT_Commands_Manual 75 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.07 +CME ERROR: 300ms Parameter 0 -113 dBm or less 1 -111 dBm 2...30 -109... -53 dBm 31 -51 dBm or greater 99 Not known or not detectable (in percent): 0...7 As RXQUAL values in the table in GSM 05.08 subclause 8.2.4 99 Not known or not detectable Example AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,0 OK //The current signal strength indication is 28 and channel bit error rate is 0 6.4. AT+CPOL Preferred Operator List AT+CPOL Preferred Operator List Test Command AT+CPOL=? Response +CPOL: (list of supported s),(list of supported s) Read Command AT+CPOL? OK Response +CPOL: ,, [+CPOL: ,, […]] MC20&MC30_AT_Commands_Manual 76 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual OK Write Command AT+CPOL=[,[, ]] If there is any error related to ME functionality: +CME ERROR: Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference GSM 07.07 Parameter I Integer type: order number of operator in (U)SIM preferred operator list 0 Long format alphanumeric 1 Short format alphanumeric 2 Numeric String type: indicates either alphanumeric or numeric format is used (see AT+COPS command) NOTE (U)SIM card does not allow editing the list of the preferred operators. 6.5. AT+COPN Read Operator Names AT+COPN Read Operator Names Test Command AT+COPN=? Execution Command AT+COPN Response OK Response +COPN: , [+COPN: , […]] OK MC20&MC30_AT_Commands_Manual 77 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter String type. Operator in numeric format (see AT+COPS) String type. Operator in long alphanumeric format (see AT+COPS) 6.6. AT+QBAND Get and Set Mobile Operation Band AT+QBAND Get and Set Mobile Operation Band Test Command AT+QBAND=? Response +QBAND: (list of supported s) Read Command AT+QBAND? OK Response +QBAND: Write Command AT+QBAND= OK Response OK Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 30s, determined by network. Parameter 'EGSM_MODE' 'DCS_MODE' 'PCS_MODE' 'GSM850_MODE' 'EGSM_DCS_MODE' 'GSM850_PCS_MODE' MC20&MC30_AT_Commands_Manual 78 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 'GSM850_EGSM_DCS_PCS_MODE' NOTE The following radio setting to be updated is stored in non-volatile memory. 6.7. AT+QENG Switch on or off Engineering Mode AT+QENG Switch on or off Engineering Mode Test Command AT+QENG=? Response +QENG: (list of supported s),(list of supported s) Read Command AT+QENG? OK Response The corresponding information is reported selectively according to . +QENG: , URCs of the serving cell information: +QENG: 0,,,,,,,< dbm>,,,,,,,,,, URCs of 1-6 neighboring cell information: [+QENG: 1,list of (,,,,,< c2>,,,,)…] URCs of cell frequency list (CA) of the serving cell: [+QENG: 2,list of ()…] BA measured result list: [+QENG: 4,record number of the list, list of (,< dbm>,)] Write Command AT+QENG=[,] OK Response OK If there is any error, response: ERROR MC20&MC30_AT_Commands_Manual 79 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel Or +CME ERROR: 300ms Parameter 0 Switch off engineering mode 1 Switch on engineering mode 2 Switch on engineering mode, and activate the URC report of network information 0 Only display the serving cell information 1 Display the serving cell information, 1-6 neighboring cells information 2 Display the serving cell information and list of serving cell carrier list 3 Display the serving cell information,1-6 neighboring cell information and list of serving cell carrier list 4 Display the serving cell information,1-6 neighboring cell information, list of serving cell carrier list and BA measured result list. Mobile country code Mobile network code Location area code in hex format Cell ID in hex format Absolute Radio Frequency Channel Number of Broadcast Control Channel (BCCH) Base station identity code Receive signal level in dBm unit C1 value C2 value Maximum TX power level when accessing on a CCH Minimum receiving level permitted to access the system Time Slots MAIO value HSN value ARFCN of TCH, ‘h’ figure hopping Timing Advance,range 0~63 RX quality(sub), range 0-7 RX quality(full), range 0-7 Number of neighboring six cell ID 1~6 Absolute radio frequency channel number MC20&MC30_AT_Commands_Manual 80 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTE The following radio settings to be updated are stored in non-volatile memory. 1. When mode is 2, auto URCs are reported per 5 seconds. 2. The and parameters are available in hex format, and these parameters are in decimal. 3. If the cell information is not detected, the parameter is replaced by ‘x’ char. 4. If the detecting is not expert mode, parameters , , , , , and will not display the parameter value while are replaced by ‘x’ char. 5. During the network connecting, if the hopping frequency is supported by the network, the channel of TCH is instable. Using the ’h’ figure under this mode. 6. Under expert mode, when the and of the serving cell cannot be updated, using the ‘-1’ figure to display the illegal value. At the same time, and parameters cannot be updated in a certain condition, all the same holding the value of idle mode. This is because ME cannot be updated in this mode. ME cannot update the selection of cell and reselection of the parameter. When the connecting is over, mobile device will go back to idle mode and offer the correct value. 7. If TA can report the information of the neighboring cell, the URCs of six neighboring cell should be reported. If some cells cannot be measured, the ‘x’ char will be filled in the parameter of these cells. 8. Under the special mode, and parameters of the neighboring cell may be measured, and then an unmeaning value will be reported. When , , and parameters of the neighboring cell cannot be measured, the 'x' char will be filled in these parameters of all the six cells. 9. The command does not report the RX level and the RX quality. The AT+CSQ command can be used to query the values of RX level and RX quality. 10. The AT+QSPCH command can be used to re-query the type of the voice channel during calling (FR, HR, EFR, AMR_FR, AMR_HR). 11. The maximum record number of BA measured result list is 32. If any of the BCCH cannot get the BSIC value, the BSIC will show ‘x’ instead. The measured list only includes the measured BCCH in the BA list, not the whole BA list. Example Idle mode: AT+QENG=2 OK +QENG: 0,460,00,1806,2602,64,46,-72,119,119,5,8,x,x,x,x,x,x,x Dedicated mode: AT+QENG=2,3 OK +QENG: 0,460,00,1806,2031,17,41,-73,-1,-1,5,8,h,7,0,24,1,0,1 +QENG: 1,1,17,-74,41,111,95,460,00,1806,2031,2,2,-74,45,110,94,460,00,1878,151,3,22,-77,40,100,8 MC20&MC30_AT_Commands_Manual 81 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 4,460,00,1806,2012,4,24,-77,45,97,81,460,00,1806,2013,5,25,-81,40,83,67,460,00,1806,2032,6,532,-9 2,48,-1,-1,x,x,x,x 6.8. AT+QSCANF Scan Power of GSM Frequency AT+QSCANF Scan Power of GSM Frequency Test Command AT+QSCANF=? Response +QSCANF: (list of supported s),(list of supported s) Write Command AT+QSCANF=, OK Response If =9999 and command is successful: +QSCANF: 1, CH113, -63.5 2, CH80, -64.2 4, CH22, -64.5 ….. 20, CH116, -74.2 OK Maximum Response Time Reference Quectel If is fixed frequency and command is successful: +QSCANF: CH, If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 BAND 900 1 BAND 1800 2 BAND 1900 3 BAND 850 9999 Scan all frequencies in a specified band 0-1023 Scan a fixed frequency in a specified band The signal strength indication in dbm value for a specified frequency MC20&MC30_AT_Commands_Manual 82 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTE Before using this AT command, RF function of system MUST be disabled. Please make sure equipment functionality level is 0 or 4. About how to change the functionality level, please refer to AT+CFUN. 6.9. AT+QLOCKF Lock GSM Frequency AT+QLOCKF Lock GSM Frequency Test Command AT+QLOCKF=? Response +QLOCKF: (list of supported s),(list of supported s),(list of supported s) Read Command AT+QLOCKF? OK Response +QLOCKF: Write Command AT+QLOCKF=,,< arfcn1>[,[,]] Maximum Response Time Reference Quectel OK Response OK If there is any error, response: ERROR Or +CME ERROR: 300ms Parameter 0 1 2 0 1 2 0-1024 0 1 Disable lock frequency Enable lock frequency Enable lock frequency and auto switch to saved frequency after powered on Not a cell ID of 1900 band Cell ID of 1900 band Auto distinguish whether is a cell ID of 1900 band ARFCN information ME did not lock a certain ARFCN ME has locked a certain ARFCN MC20&MC30_AT_Commands_Manual 83 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 7 Call Related Commands 7.1. ATA Answer an Incoming Call ATA Answer an Incoming Call Execution Command ATA Response TA sends off-hook to the remote station. Response in case of voice call, if successfully connected: OK Maximum Response Time Reference V.25ter Response if no connection: NO CARRIER 1s, determined by network. NOTES 1. Any additional commands on the same command line are ignored. 2. This command may be aborted generally by receiving a character during execution. The aborting is not possible during some states of connection establishment such as handshaking. 3. See also ATX. Example RING AT+CLCC +CLCC: 1,1,4,0,0,'02154450290',129,'' //A voice call is ringing OK ATA //Accept the voice call with ATA OK MC20&MC30_AT_Commands_Manual 84 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 7.2. ATD Mobile Originated Call to Dial a Number ATD Mobile Originated Call to Dial a Number Execution Command ATD[][;] Response This command can be used to set up outgoing voice, data or fax calls. It also serves to control supplementary services. Maximum Response Time Reference V.25ter If no dial tone and parameter setting ATX2 or ATX4: NO DIALTONE If busy and parameter setting ATX3 or ATX4: BUSY If a connection cannot be established: NO CARRIER If connection is successful and voice call: OK 1s, determined by network. Parameter String of dialing digits and optionally V.25ter modifiers Dialing digits: 0-9, * , #, +, A, B, C Following V.25ter modifiers are ignored: ,(comma), T, P, !, W, @ Emergency call: Standardized emergency number 112 (no (U)SIM needed) String of GSM modifiers: I Actives CLIR (Disables presentation of own number to called party) i Deactivates CLIR (Enable presentation of own number to called party) G Activates closed user group invocation for this call only g Deactivates closed user group invocation for this call only Only required to set up voice call, return to command state NOTES 1. This command may be aborted generally by receiving an ATH command or a character during execution. The aborting is not possible during some states of connection establishment such as handshaking. MC20&MC30_AT_Commands_Manual 85 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2. Parameter 'I' and 'i' are applicable for cases where there is no '*' or '#' code within the dial string. 3. is the default value for last number that can be dialed by ATDL. 4. *# codes sent with ATD are treated as voice calls. Therefore, the command must be terminated with a semicolon ';'. 5. See ATX command for setting result code and call monitoring parameters. 6. Responses returned after dialing with ATD  For voice call, two different responses modes can be determined. TA returns OK immediately either after dialing was completed or after the call was established. The setting is controlled by AT+COLP. Factory default is AT+COLP=0, which causes the TA returns OK immediately after dialing was completed; otherwise TA will return OK, BUSY, NO DIAL TONE, or NO CARRIER. 7. Using ATD during an active voice call:  When a user originates a second voice call while there is already an active voice call, the first call will be automatically put on hold.  The current states of all calls can be easily checked at any time by using AT+CLCC command. Example ATD10086; OK //Dialing out the called party’s number 7.3. ATH Disconnect Existing Connection ATH Disconnect Existing Connection Execution Command ATH[n] Response Disconnect existing call by local TE from command line and terminate call. OK Maximum Response Time 90s, determined by network. Reference V.25ter Parameter 0 Disconnect existing call from command line and terminate the call NOTE OK is issued after circuit 109 (DCD) is turned off, if it was previously on. MC20&MC30_AT_Commands_Manual 86 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 7.4. +++ Switch from Data Mode to Command Mode +++ Switch from Data Mode to Command Mode Execution Command +++ Response This command is only available during TA is in data mode, such as, a GPRS connection and a transparent TCP/IP connection. The +++ character sequence causes the TA to cancel the data flow over the AT interface and switch to command mode. This allows you to enter AT command while maintaining the data connection with the remote server or, accordingly, the GPRS connection. Maximum Response Time Reference V.25ter OK 300ms NOTES 1. To prevent the +++ escape sequence from being misinterpreted as data, it should comply to following sequence:  No characters entered for T1 time (0.5 seconds).  +++ characters entered with no characters in between. For PPP online mode, the interval between two '+' MUST be less than 1 second and for a transparent TCP/IP connection, the interval MUST be less than 20ms.  No characters entered for T1 time (0.5 seconds).  Switch to command mode, otherwise go to step 1. 2. To return from command mode back to data or PPP online mode: Enter ATO  Another way to change to command mode is through DTR, see AT&D command for the details. 7.5. ATO Switch from Command Mode to Data Mode ATO Switch from Command Mode to Data Mode Execution Command ATO[n] Response TA resumes the connection and switches back from command mode to data mode. If connection is not successfully resumed: NO CARRIER If connection is successfully resumed, TA returns to data mode MC20&MC30_AT_Commands_Manual 87 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference V.25ter from command mode CONNECT 300ms Parameter 0 Switch from command mode to data mode NOTE TA returns to data mode from command mode CONNECT , only if ATX parameter is set >0. 7.6. ATP Select Pulse Dialing ATP Select Pulse Dialing Execution Command ATP Maximum Response Time Reference V.25ter Response OK 300ms NOTE No effect in GSM. 7.7. ATS0 Set Number of Rings before Automatically Answering Call ATS0 Set Number of Rings before Automatically Answering Call Read Command ATS0? Response OK MC20&MC30_AT_Commands_Manual 88 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command ATS0= Maximum Response Time Reference V.25ter Response This parameter setting determines the number of rings before auto-answer. OK 300ms Parameter 0 Automatic answering is disabled 1-255 Enable automatic answering on the ring number specified NOTE If is set too large, the calling party may hang up before the call can be answered automatically. Example ATS0=3 OK RING RING RING //Set three rings before automatically answering a call //A call is incoming //Automatically answering the call after three rings 7.8. ATS6 Set Pause before Blind Dialing ATS6 Set Pause before Blind Dialing Read Command ATS6? Response Write Command ATS6= Maximum Response Time Reference V.25ter OK Response OK 300ms MC20&MC30_AT_Commands_Manual 89 / 259 Parameter 0-2-10 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Number of seconds to wait before blind dialing NOTE No effect in GSM. 7.9. ATS7 Set the Time to Wait for Connection Completion ATS7 Set the Time to Wait for Connection Completion Read Command ATS7? Response Write Command ATS7= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the duration of time to wait for the connection completion in case of answering or originating a call. OK 300ms Parameter 1-60-255 Number of seconds to wait for connection completion NOTES 1. If the called party has specified a high value for ATS0=, call setup may fail. 2. The correlation between ATS7 and ATS0 is important. For example: call may fail if ATS7=30 and ATS0=20. 3. ATS7 is only applicable to data call. MC20&MC30_AT_Commands_Manual 90 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 7.10. ATS8 Set the Time to Wait for Comma Dial Modifier ATS8 Set the Time to Wait for Comma Dial Modifier Read Command ATS8? Response Write Command ATS8= Maximum Response Time Reference V.25ter OK Response OK 300ms Parameter 0 1-2-255 No pause when comma encountered in dial string Number of seconds to wait NOTE No effect in GSM. 7.11. ATS10 Set Disconnect Delay after Indicating the Absence of Data Carrier ATS10 Set Disconnect Delay after Indicating the Absence of Data Carrier Read Command ATS10? Response Write Command ATS10= Maximum Response Time OK Response This parameter setting determines the amount of time that the TA will remain connected in absence of data carrier. If the data carrier is once more detected before disconnection, the TA remains connected. OK 300ms MC20&MC30_AT_Commands_Manual 91 / 259 Reference V.25ter Parameter 1-15-254 Number of delay in 100ms GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 7.12. ATT Select Tone Dialing ATT Select Tone Dialing Execution Command ATT Maximum Response Time Reference V.25ter Response OK 300ms NOTE No effect in GSM. 7.13. AT+CSTA Select Type of Address AT+CSTA Select Type of Address Test Command AT+CSTA=? Response +CSTA: (list of supported s) Read Command AT+CSTA? OK Response +CSTA: Maximum Response Time Reference GSM 07.07 OK 300ms MC20&MC30_AT_Commands_Manual 92 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter Current address type setting. 129 Unknown type (IDSN format number) 145 International number type (ISDN format) 161 National number type (IDSN format) 7.14. AT+CLCC List Current Calls of ME AT+CLCC List Current Calls of ME Test Command AT+CLCC=? Execution Command AT+CLCC Response OK Response TA returns a list of current calls of ME. If command succeeds but no calls are available, no information response is sent to TE. [+CLCC: ,,,,[, ,[,'']] ...] Maximum Response Time Reference GSM 07.07 OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Integer type; call identification number as described in GSM 02.30 subclause 4.5.5.1; this number can be used in AT+CHLD Command operations 0 Mobile originated (MO) call 1 Mobile terminated (MT) call State of the call 0 Active 1 Held 2 Dialing (MO call) 3 Alerting (MO call) 4 Incoming (MT call) MC20&MC30_AT_Commands_Manual 93 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 5 Waiting (MT call) Bearer/tele service 0 Voice 1 Data 2 FAX 9 Unknown 0 Call is not one of multiparty (conference) call parties 1 Call is one of multiparty (conference) call parties Phone number in string type in format specified by Type of address of octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format ) Example AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK //List the current call of ME 7.15. AT+CR Service Reporting Control AT+CR Service Reporting Control Test Command AT+CR=? Response +CR: (list of supported s) Read Command AT+CR? OK Response +CR: Write Command AT+CR=[] Maximum Response Time Reference GSM 07.07 OK Response TA controls whether or not intermediate result code +CR: is returned from the TA to the TE when a call set up. OK 300ms MC20&MC30_AT_Commands_Manual 94 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 0 Disable 1 Enable ASYNC Asynchronous transparent SYNC Synchronous transparent REL ASYNC Asynchronous non-transparent REL SYNC Synchronous non-transparent NOTE Intermediate result code: If it is enabled, an intermediate result code is transmitted at a point during link negotiation. At the same time, the TA has determined which speed and quality of service will be used, before any error control or data compression reports are transmitted, and before any final result code (e.g. CONNECT) is transmitted. 7.16. AT+CRC Set Cellular Result Code for Incoming Call Indication AT+CRC Set Cellular Result Code for Incoming Call Indication Test Command AT+CRC=? Response +CRC: (list of supported s) Read Command AT+CRC? OK Response +CRC: Write Command AT+CRC=[] Maximum Response Time Reference GSM 07.07 OK Response TA controls whether or not the extended format of incoming call indication is used. OK 300ms Parameter 0 1 Disable extended format Enable extended format MC20&MC30_AT_Commands_Manual 95 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTE Unsolicited result code: When it is enabled, an incoming call is indicated to the TE with unsolicited result code +CRING: instead of the normal RING. Parameter ASYNC Asynchronous transparent SYNC Synchronous transparent REL ASYNC Asynchronous non-transparent REL SYNC Synchronous non-transparent FAX Facsimile VOICE Voice Example AT+CRC=1 OK +CRING: VOICE ATH OK AT+CRC=0 OK RING ATH OK //Enable extended format //Indicate an incoming call to the TE //Disable extended format //Indicate incoming call to the TE 7.17. AT+CSNS Single Numbering Scheme AT+CSNS Single Numbering Scheme Test Command AT+CSNS=? Response +CSNS: (list of supported s) Read Command AT+CSNS? Write Command AT+CSNS=[] OK Response +CSNS: OK Response OK MC20&MC30_AT_Commands_Manual 96 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.07 If there is any error, response: ERROR 300ms Parameter 0 1 2 3 4 5 6 7 Voice Alternating voice/fax, voice first FAX Alternating voice/data, voice first Data Alternating voice/fax, fax first Alternating voice/data, data first Voice followed by data 7.18. AT+QSFR Preference Speech Coding AT+QSFR Preference Speech Coding Test Command AT+QSFR=? Response +QSFR: (list of supported s) Read Command AT+QSFR? OK Response +QSFR: Write Command AT+QSFR= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms MC20&MC30_AT_Commands_Manual 97 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Automatic mode FR HR EFR AMR_FR AMR_HR FR and EFR, FR priority EFR and FR, EFR priority EFR and HR, EFR priority EFR and AMR_FR, EFR priority AMR_FR and FR, AMR_FR priority AMR_FR and HR, AMR_FR priority AMR_FR and EFR, AMR_FR priority AMR_HR and FR, AMR_HR priority AMR_HR and HR, AMR_HR priority AMR_HR and EFR, AMR_HR priority NOTE This setting is stored in the non-volatile memory and will be used whenever the module is powered up again. 7.19. AT+QSPCH Speech Channel Type Report AT+QSPCH Speech Channel Type Report Test Command AT+QSPCH=? Response +QSPCH: (list of supported s) Read Command AT+QSPCH? OK Response +QSPCH: , Write Command AT+QSPCH= OK Response OK If there is any error, response: ERROR MC20&MC30_AT_Commands_Manual 98 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel 300ms Parameter 0 Disable report speech channel type 1 Enable report speech channel type Speech channel type 0 NO SPEECH TCH 1 FR 2 HR 3 EFR 4 AMR_FR 5 AMR_HR NOTE URC +QSPCH: , will be indicated when speech channel type changes. 7.20. AT+QDISH Disable ATH AT+QDISH Disable ATH Test Command AT+QDISH=? Read Command AT+QDISH? Write Command AT+QDISH= Maximum Response Time Reference Quectel Response +QDISH: (list of supported s) OK Response +QDISH: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms MC20&MC30_AT_Commands_Manual 99 / 259 Parameter Disable ATH 0 Enable ATH command 1 Disable ATH command GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual MC20&MC30_AT_Commands_Manual 100 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 8 SMS Commands 8.1. AT+CSMS Select Message Service AT+CSMS Select Message Service Test Command AT+CSMS=? Response +CSMS: (list of supported s) Read Command AT+CSMS? OK Response +CSMS: ,,, Write Command AT+CSMS= OK Response +CSMS: ,, Maximum Response Time Reference GSM 07.05 OK If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter 0 GSM 03.40 and 03.41 [the syntax of SMS AT commands is compatible with GSM 07.05 Phase 2 version 4.7.0; Phase 2+ features which do not require new command syntax may be supported (e.g. correct routing of messages with new Phase 2+ data coding schemes)] 128 SMS PDU mode - TPDU only used for ending/receiving SMSs Mobile Terminated Messages 0 Type not supported 1 Type supported Mobile Originated Messages MC20&MC30_AT_Commands_Manual 101 / 259 0 Type not supported 1 Type supported Broadcast Type Messages 0 Type not supported 1 Type supported GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 8.2. AT+CMGF Select SMS Message Format AT+CMGF Select SMS Message Format Test Command AT+CMGF=? Response +CMGF: (list of supported s) Read Command AT+CMGF? OK Response +CMGF: Write Command AT+CMGF=[] Maximum Response Time Reference GSM 07.05 OK Response TA sets parameter to denote which kind of I/O format of messages is used. OK 300ms Parameter 0 1 PDU mode Text mode 8.3. AT+CSCA SMS Service Center Address AT+CSCA SMS Service Center Address Test Command AT+CSCA=? Read Command AT+CSCA? Response OK Response +CSCA: , MC20&MC30_AT_Commands_Manual 102 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+CSCA=[,] Maximum Response Time Reference GSM 07.05 OK Response TA updates the SMSC address, through which mobile originated SMS are transmitted. In text mode, setting is used by sending and writing commands. In PDU mode, setting is used by the same commands, but only when the length of the SMSC address coded into parameter equals zero. OK If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter GSM 04.11 RP SC address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by Service center address format GSM 04.11 RP SC address Type-of-Address octet in integer format (default refer to ) NOTE The command writes the parameters in non-volatile memory. Example AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 OK //SMS service center address //Query SMS service center address MC20&MC30_AT_Commands_Manual 103 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 8.4. AT+CPMS Preferred SMS Message Storage AT+CPMS Preferred SMS Message Storage Test Command AT+CPMS=? Response +CPMS: (list of supported s),(list of supported s),(list of supported s) Read Command AT+CPMS? OK Response +CPMS: ,,,,,,,, Write Command AT+CPMS=[,[,]] OK Response TA selects memory storages , and to be used for reading, writing, etc. +CPMS: ,,,,, OK Maximum Response Time Reference GSM 07.05 If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter Messages to be read and deleted from this memory storage 'SM' SIM message storage 'ME' Mobile Equipment message storage 'MT' Sum of 'SM' and 'ME' storages Messages will be written and sent to this memory storage 'SM' SIM message storage 'ME' Mobile Equipment message storage 'MT' Sum of 'SM' and 'ME' storages Received messages will be placed in this memory storage, if routing to PC is not set (AT+CNMI) 'SM' SIM message storage 'ME' Mobile Equipment message storage 'MT' Sum of 'SM' and 'ME' storages MC20&MC30_AT_Commands_Manual 104 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Integer type. Number of messages currently in Integer type. Number of messages storable in NOTE The (U)SIM and ME message storages offer maximum space for 50 and 10 messages, respectively. The (U)SIM message storage is selected in priority. Example AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 //Set SMS message storage as 'SM' ((U)SIM) OK AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 //Query the current SMS message storage OK 8.5. AT+CMGD Delete SMS Message AT+CMGD Delete SMS Message Test Command AT+CMGD=? Response +CMGD: (list of supported s),(list of supported s) Write Command AT+CMGD=[,] OK Response TA deletes message from preferred message storage location . OK Maximum Response Time Reference GSM 07.05 If there is any error, response: ERROR Or +CMS ERROR: 300ms. Note: Operation of depends on the storage of deleted messages. MC20&MC30_AT_Commands_Manual 105 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter Integer type; value in the range of location numbers supported by the associated memory 0 Delete message specified in 1 Delete all read messages from storage, leaving unread messages and stored mobile originated messages (whether sent or not) untouched 2 Delete all read messages from storage and sent mobile originated messages, leaving unread messages and unsent mobile originated messages untouched 3 Delete all read messages from storage, sent and unsent mobile originated messages, leaving unread messages untouched 4 Delete all messages from storage Example AT+CMGD=1 OK AT+CMGD=1,4 OK //Delete the message specified in =1 //Delete all messages from storage 8.6. AT+CMGL List SMS Messages from Preferred Storage AT+CMGL List SMS Messages from Preferred Storage Test Command AT+CMGL=? Response +CMGL: (list of supported s) Write Command AT+CMGL=[,] OK Response TA returns messages with status value from message storage to the TE. If status of the message is 'received unread', status in the storage changes to 'received read'. 1) In text mode (AT+CMGF=1) and when the command is executed successfully: For SMS-SUBMITs and/or SMS-DELIVERs: +CMGL: ,,,[],[][,,][ ...] For SMS-STATUS-REPORTs: +CMGL: ,,,,[],[],,,[ ...] For SMS-COMMANDs: +CMGL: ,,,[ ..] For CBM storage: +CMGL: ,,,,,[ ...] OK 2) In PDU mode (+CMGF=0) and when the command is successful: +CMGL: ,,[], ...] OK 3) If there is any error related to ME functionality: +CMS ERROR: 300ms. Note: Operation of depends on the storage of listed messages. Parameter 1) In text mode 'REC UNREAD' Received unread messages 'REC READ' Received read messages 'STO UNSENT' Stored unsent messages 'STO SENT' Stored sent messages 'ALL' All messages 2) In PDU mode 0 Received unread messages 1 Received read messages 2 Stored unsent messages 3 Stored sent messages MC20&MC30_AT_Commands_Manual 107 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 4 All messages 0 Normal (default) 1 Not change status of the specified SMS record String type alphanumeric representation of or corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer specific; used character set should be the one selected with command select TE character set AT+CSCS (see definition of this command in TS 07.07) GSM 03.40 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS in TS 07.07); type of address given by In the case of SMS: GSM 03.40 TP-User-Data in text mode responses; format: − if indicates that GSM 03.38 default alphabet is used and indicates that GSM 03.40 is used: TPUser-Data-Header-Indication is not set − if TE character set other than 'HEX' (refer to Command Select TE character set +CSCS in TS 07.07): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A − if TE character set is 'HEX': ME/TA converts each 7-bit character of GSM alphabet into two IRA character long hexadecimal number [e.g. character P (GSM 23) is presented as 17 (IRA 49 and 55)] − if indicates that 8-bit or UCS2 data coding scheme is used, or indicates that GSM 03.40 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number [e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)] In the case of CBS: GSM 03.41 CBM Content of Message in text mode responses; format: − if indicates that GSM 03.38 default alphabet is used: ME/TA converts GSM into the current character supported by TE − if TE character set other than 'HEX' (refer to AT+CSCS in GSM 07.07): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A − if TE character set is 'HEX': ME/TA converts each 7-bit character of GSM alphabet into two IRA character long hexadecimal number − if indicates that 8-bit or UCS2 data coding scheme is used: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number Integer type value indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) Integer type value in the range of location numbers supported by the associated memory GSM 03.40 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (refer to AT+CSCS in TS 07.07); type of address given by In the case of SMS: GSM 04.11 SC address followed by GSM 03.40 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number [e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)]. In the case of CBS: GSM 03.41 TPDU in hexadecimal format MC20&MC30_AT_Commands_Manual 108 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual GSM 03.40 TP-Service-Center-Time-Stamp in time-string format (refer to ) GSM 04.11 TP-Destination-Address Type-of-Address octet in integer format (when first character of is + (IRA 43) default value is 145, otherwise default value is 129) GSM 04.11 TP-Originating-Address Type-of-Address octet in integer format (refer to ) NOTE If parameter is omitted, the command returns the list of SMS with 'REC UNREAD' status. Example AT+CMGF=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','','', This is a test from Quectel //Set SMS message format as text mode //List all messages from message storage +CMGL: 2,'STO UNSENT','','', This is a test from Quectel,once again. OK 8.7. AT+CMGR Read SMS Message AT+CMGR Read SMS Message Test Command AT+CMGR=? Write Command AT+CMGR=[,] Response OK Response TA returns SMS message with location value from message storage to the TE. If status of the message is 'received unread', status in the storage changes to 'received read'. 1) In text mode (AT+CMGF=1) and when the command is executed successfully: For SMS-DELIVER: +CMGR: ,,[],[,,,,,,,] For SMS-SUBMIT: MC20&MC30_AT_Commands_Manual 109 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.05 +CMGR: ,,[][,,,,,[],,,] for SMS-STATUS-REPORTs: +CMGR: ,,,[],[],,, For SMS-COMMANDs: +CMGR: ,,[,,[],[],[], ] For CBM storage: +CMGR: ,,,,, 2) In PDU mode (AT+CMGF=0) and when command is successful: +CMGR: ,[], OK 3) If there is any error related to ME functionality: +CMS ERROR: Depends on the length of message content. Parameter Integer type value in the range of location numbers supported by the associated memory 0 Normal 1 Not change the status of the specified SMS record String type alphanumeric representation of or corresponding to the entry found in MT phonebook; implementation of this feature is manufacturer specific GSM 03.40 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by In the case of SMS: GSM 03.40 TP-User-Data in text mode responses; format − if indicates that GSM 03.38 default alphabet is used and indicates that GSM 03.40 is used: TPUser-Data-Header-Indication is not set − if TE character set other than 'HEX' (refer to command select TE character set AT+CSCS in TS 07.07): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A MC20&MC30_AT_Commands_Manual 110 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual − if TE character set is 'HEX': ME/TA converts each 7-bit character of GSM alphabet into two IRA character long hexadecimal number [ e.g. character P (GSM 23) is presented as 17 (IRA 49 and 55)] − if indicates that 8-bit or UCS2 data coding scheme is used, or indicates that GSM 03.40 TP-User-Data-Header-Indication is set: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number [e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)] In the case of CBS: GSM 03.41 CBM Content of Message in text mode responses; format − if indicates that GSM 03.38 default alphabet is used: ME/TA converts GSM into the current character supported by TE − if TE character set other than 'HEX' (refer to AT+CSCS in GSM 07.07): ME/TA converts GSM alphabet into current TE character set according to rules of Annex A − if TE character set is 'HEX': ME/TA converts each 7-bit character of GSM alphabet into two IRA character long hexadecimal number − if indicates that 8-bit or UCS2 data coding scheme is used: ME/TA converts each 8-bit octet into two IRA character long hexadecimal number Depending on the command or result code: GSM 03.38 SMS Data Coding Scheme (default value is 0), or Cell Broadcast Data Coding Scheme in integer format Depending on the command or result code: first octet of GSM 03.40 SMS-DELIVER, SMS- SUBMIT (default value is 17), SMS-STATUS-REPORT, or SMS-COMMAND (default value is 2) in integer format Integer type value indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) GSM 03.41 CBM Message Identifier in integer format GSM 03.40 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by In the case of SMS: GSM 04.11 SC address followed by GSM 03.40 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number [e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)] In the case of CBS: GSM 03.41 TPDU in hexadecimal format GSM 03.40 TP-Protocol-Identifier in integer format (default value is 0) GSM 04.11 RP SC address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by GSM 03.40 TP-Service-Centre-Time-Stamp in time-string format (refer to ) PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages MC20&MC30_AT_Commands_Manual 111 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 3 'STO SENT' Stored sent messages 4 'ALL' All messages GSM 04.11 TP-Destination-Address Type-of-Address octet in integer format (when first character of is + (IRA 43) default value is 145, otherwise default is 129) GSM 04.11 TP-Originating-Address Type-of-Address octet in integer format (default refer to ) GSM 04.11 RP SC address Type-of-Address octet in integer format (default refer to ) Depending on SMS-SUBMIT setting: GSM 03.40 TP-Validity-Period either in integer format (default value is 167) or in time-string format (refer to ) Example +CMTI: 'SM',3 //Indicates that new message has been received and saved to =3 of 'SM' AT+CMGR=3 //Read message +CMGR: 'REC UNREAD','+8615021012496','','2010/09/25 15:06:37+32',145,4,0,241,'+8 613800210500',145,27 This is a test from Quectel OK 8.8. AT+CMGS Send SMS Message AT+CMGS Send SMS Message Test Command AT+CMGS=? Write Command 1) In text mode (AT+CMGF=1): AT+CMGS=[,] text is entered ESC quits without sending 2) In PDU mode (AT+CMGF=0): AT+CMGS= PDU is given Response OK Response TA sends message from a TE to the network (SMS-SUBMIT). Message reference value is returned to the TE on successful message delivery. Optionally (when +CSMS value is 1 and network supports) is returned. Values can be used to identify message upon unsolicited delivery status report result code. 1) In text mode (AT+CMGF=1) and when the command is sent successfully: +CMGS: OK 2) In PDU mode (AT+CMGF=0) and when the command is sent successfully: +CMGS: MC20&MC30_AT_Commands_Manual 112 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.05 OK 3) If there is any error related to ME functionality: +CMS ERROR: 120s, determined by network. Parameter GSM 03.40 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by GSM 04.11 TP-Destination-Address Type-of-Address octet in integer format [when first character of is + (IRA 43) default value is 145, otherwise default value is 129] Integer type value indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) GSM 03.40 TP-Message-Reference in integer format Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > This is a test from Quectel +CMGS: 247 OK //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text, send message, quits without sending 8.9. AT+CMGW Write SMS Message to Memory AT+CMGW Write SMS Message to Memory Test Command AT+CMGW=? Response OK MC20&MC30_AT_Commands_Manual 113 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command 1) In text mode (AT+CMGF=1): AT+CMGW[=[,[,]]] text is entered quits without sending 2) In PDU mode (AT+CMGF=0): AT+CMGW=[,] PDU is given Response TA transmits SMS message (either SMS-DELIVER or SMSSUBMIT) from TE to memory storage . Memory location of the stored message is returned. By default, message status will be set to 'stored unsent', but parameter also allows other status values to be given. If writing is successful: +CMGW: OK Maximum Response Time Reference GSM 07.05 If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter GSM 03.40 TP-Originating-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by GSM 03.40 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by GSM 04.11 TP-Originating-Address Type-of-Address octet in integer format (default refer to ) GSM 04.11 TP-Destination-Address Type-of-Address octet in integer format [when first character of is + (IRA 43) default value is 145, otherwise default value is 129] 129 Unknown type (IDSN format number) 145 International number type (ISDN format) PDU mode Text mode Explanation 0 'REC UNREAD' Received unread messages 1 'REC READ' Received read messages 2 'STO UNSENT' Stored unsent messages 3 'STO SENT' Stored sent messages 4 'ALL' All messages Integer type value indicating in the text mode (AT+CMGF=1) the length of the message body (or ) in characters; or in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) In the case of SMS: GSM 04.11 SC address followed by GSM 03.40 TPDU in hexadecimal MC20&MC30_AT_Commands_Manual 114 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number [ e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)] In the case of CBS: GSM 03.41 TPDU in hexadecimal format Index of message in selected storage Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGW='15021012496' > This is a test from Quectel +CMGW: 4 OK //Set SMS message format as text mode //Set character set as GSM which is used by the TE //Enter in text, write message, quits without sending 8.10. AT+CMSS Send SMS Message from Storage AT+CMSS Send SMS Message from Storage Test Command AT+CMSS=? Write Command AT+CMSS=[,[,]] Response OK Response TA sends message with location value from message storage to the network (SMS-SUBMIT). If new recipient address is given, it shall be used instead of the one stored with the message. Reference value is returned to the TE on successful message delivery. Values can be used to identify message upon unsolicited delivery status report result code. 1) In text mode (AT+CMGF=1) and when the command is sent successfully: +CMSS: [,] OK 2) In PDU mode (+CMGF=0) and the command is sent successfully; +CMSS: [,] MC20&MC30_AT_Commands_Manual 115 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.05 OK 3) If there is any error related to ME functionality: +CMS ERROR: 120s, determined by network. Parameter Integer type value in the range of location numbers supported by the associated memory GSM 03.40 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by GSM 04.11 TP-Destination-Address Type-of-Address octet in integer format [when first character of is + (IRA 43) default value is 145, otherwise default value is 129] GSM 03.40 TP-Message-Reference in integer format GSM 03.40 TP-Service-Centre-Time-Stamp in time-string format (refer to ) In the case of SMS: GSM 04.11 SC address followed by GSM 03.40 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number [e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)]. In the case of CBS: GSM 03.41 TPDU in hexadecimal format 8.11. AT+CMGC Send SMS Command AT+CMGC Send SMS Command Test Command AT+CMGC=? Write Command 1) In text mode (AT+CMGF=1): AT+CMGC=[,,,,,] text is entered ESC quits without sending 2) In PDU mode (AT+CMGF=0): AT+CMGC= PDU is given Response OK Response TA transmits SMS command message from a TE to the network (SMS-COMMAND). Message reference value is returned to the TE on successful message delivery. Value can be used to identify message upon unsolicited delivery status report result code. 1) In text mode(AT+CMGF=1) and when the command is sent successfully: +CMGC: [,] OK MC20&MC30_AT_Commands_Manual 116 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.05 2) In PDU mode(AT+CMGF=0) and when the command is sent successfully: +CMGC: [,] OK 3) If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter First octet of GSM 03.40 SMS-COMMAND (default value is 2) in integer format GSM 03.40 TP-Command-Type in integer format (default value is 0) GSM 03.40 TP-Protocol-Identifier in integer format (default value is 0) GSM 03.40 TP-Message-Number in integer format GSM 03.40 TP-Destination-Address Address-Value field in string format; BCD numbers (or GSM default alphabet characters) are converted to characters of the currently selected TE character set (specified by AT+CSCS in TS 07.07); type of address given by GSM 04.11 TP-Destination-Address Type-of-Address octet in integer format [when first character of is + (IRA 43) default value is 145, otherwise default value is 129] 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Integer type value indicating in PDU mode (AT+CMGF=0), the length of the actual TP data unit in octets (i.e. the RP layer SMSC address octets are not counted in the length) GSM 03.40 TP-Message-Reference in integer format GSM 03.40 TP-Service-Centre-Time-Stamp in time-string format (refer to ) In the case of SMS: GSM 04.11 SC address followed by GSM 03.40 TPDU in hexadecimal format: ME/TA converts each octet of TP data unit into two IRA character long hexadecimal number [e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)]. In the case of CBS: GSM 03.41 TPDU in hexadecimal format 8.12. AT+CNMI New SMS Message Indications AT+CNMI New SMS Message Indications Test Command AT+CNMI=? Response +CNMI: (list of supported s),(list of supported s),(list of supported s),(list of supported MC20&MC30_AT_Commands_Manual 117 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual s),(list of supported s) Read Command AT+CNMI? OK Response +CNMI: ,,,, Write Command AT+CNMI=[[,[,[,[,]]]]] OK Response TA selects the procedure on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR signal is ON. If TE is inactive (e.g. DTR signal is OFF), receiving message should be done as specified in GSM 03.38. OK Maximum Response Time Reference GSM 07.05 If there is any error related to ME functionality: ERROR 300ms Parameter 0 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered in some other place or the oldest indications may be discarded and replaced with the new received indications 1 Discard indication and reject new received message unsolicited result codes when TA-TE link is reserved (e.g. in on-line data mode). Otherwise forward them directly to the TE 2 Buffer unsolicited result codes in the TA when TA-TE link is reserved (e.g. in on- line data mode) and flush them to the TE after reservation. Otherwise forward them directly to the TE 3 Forward unsolicited result codes directly to the TE. Use specified TA-TE link technique to transmit both result codes and data to TE when TA is in on-line data mode (The rules for storing received SMS depend on its data coding scheme [refer to GSM 03.38 [2]), preferred memory storage (+CPMS) setting and this value]: 0 No SMS-DELIVER indications are routed to the TE 1 If SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE by using unsolicited result code: +CMTI: , 2 SMS-DELIVERs (except class 2) are routed directly to the TE using unsolicited result code: +CMT: [], (PDU mode enabled) or MC20&MC30_AT_Commands_Manual 118 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual +CMT: , [], [,,,,,,,] (Text mode enabled; about parameters in italics, refer to Command Show Text Mode Parameters AT++CSDH). Class 2 messages result in indication as defined in =1 3 Class 3 SMS-DELIVERs are routed directly to TE by using unsolicited result codes defined in =2. Messages of other classes result in indication as defined in =1 (The rules for storing received CBMs depend on its data coding scheme [refer to GSM 03.38 [2]), the setting of Select CBM Types (AT+CSCB) and this value]: 0 No CBM indications are routed to the TE 2 New CBMs are routed directly to the TE by using unsolicited result code: +CBM: (PDU mode enabled) or +CBM: ,,,, (Text mode enabled) 3 Class 3 CBMs are routed directly to TE by using unsolicited result codes defined in =2. If CBM storage is supported, messages of other classes result in indication as defined in =1 0 No SMS-STATUS-REPORTs are routed to the TE 1 SMS-STATUS-REPORTs are routed to the TE by using unsolicited result code: +CDS: (PDU mode enabled) or +CDS: ,,[],[],,, (Text mode enabled) 0 TA buffer of unsolicited result codes defined in this command is flushed to the TE when 1...3 is entered (OK response shall be given before flushing the codes) 1 TA buffer of unsolicited result codes defined within this command is cleared when 1…3 is entered NOTE Unsolicited result code +CMTI: , +CMT: [], +CBM: Indicates that new message has been received Short message is output directly Cell broadcast message is output directly Example AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CNMI=2,1 OK +CMTI: 'SM',5 //Set SMS message format as text mode //Set character set as GSM which is used by the TE //SMS-DELIVER is stored into ME/TA, indication of the memory location is routed to the TE //Indicate that new message has been received MC20&MC30_AT_Commands_Manual 119 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+CNMI=2,2 OK //Set SMS-DELIVERs are routed directly to the TE +CMT: '+8615021012496','','2010/09/25 17:25:01+32',145,4,0,241,'+8613800210500',145,27 This is a test from Quectel //Short message is output directly 8.13. AT+CRES Restore SMS Settings AT+CRES Restore SMS Settings Test Command AT+CRES=? Response +CRES: (list of supported s) Write Command AT+CRES[=] OK Response TA restores SMS settings from non-volatile memory to active memory. A TA can contain several profiles of settings. Settings specified in commands service center address AT+CSCA, set message parameters AT+CSMP and select cell broadcast message types AT+CSCB (if implemented) are restored. Certain settings may not be supported by the storage (e.g. (U)SIM SMS parameters) and therefore cannot be restored. OK Maximum Response Time Reference GSM 07.05 If there is any error, response: ERROR 300ms Parameter 0-3 Manufacturer specific profile number where settings are to be stored MC20&MC30_AT_Commands_Manual 120 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 8.14. AT+CSAS Save SMS Settings AT+CSAS Save SMS Settings Test Command AT+CSAS=? Response +CSAS: (list of supported s) Write Command AT+CSAS[=] OK Response TA saves active message service settings to non-volatile memory. A TA can contain several profiles of settings. Settings specified in commands service center address AT+CSCA, Set Message Parameters AT+CSMP and Select cell broadcast message Types AT+CSCB (if implemented) are saved. Certain settings may not be supported by the storage (e.g. (U)SIM SMS parameters) and therefore cannot be saved. OK Maximum Response Time Reference GSM 07.05 If there is any error, response: ERROR 300ms Parameter 0-3 Manufacturer specific profile number where settings are to be stored 8.15. AT+CSCB Select Cell Broadcast SMS Messages AT+CSCB Select Cell Broadcast SMS Messages Test Command AT+CSCB=? Response +CSCB: (list of supported s) Read Command AT+CSCB? OK Response +CSCB: ,, OK MC20&MC30_AT_Commands_Manual 121 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+CSCB=[,mids>[,]] Response TA selects which types of CBMs are to be received by the ME. OK Maximum Response Time Reference GSM 07.05 If there is any error related to ME functionality: +CMS ERROR: 300ms Parameter 0 Message types specified in and are accepted 1 Message types specified in and are not accepted String type. All different possible combinations of CBM message identifiers (refer to ) (default is empty string) e.g. '0,1,5,320-478,922' String type. All different possible combinations of CBM data coding schemes (refer to ) (default is empty string) e.g. '0-3,5' NOTE The command writes the parameters in non-volatile memory. 8.16. AT+CSDH Show SMS Text Mode Parameters AT+CSDH Show SMS Text Mode Parameters Test Command AT+CSDH=? Response +CSDH: (list of supported s) Read Command AT+CSDH? OK Response +CSDH: Write Command AT+CSDH=[] OK Response TA determines whether detailed header information is shown in text mode result codes. MC20&MC30_AT_Commands_Manual 122 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.05 OK 300ms Parameter 0 1 Do not show header values defined in commands AT+CSCA and AT+CSMP (, , , , and ) nor , or in +CMT, +CMGL, +CMGR result codes for SMS-DELIVERs and SMS-SUBMITs in text mode Show the values in result codes Example AT+CSDH=0 OK AT+CMGR=3 +CMGR: 'REC READ','+8615021012496','','2010/09/25 15:06:37+32' This is a test from Quectel OK AT+CSDH=1 OK AT+CMGR=3 +CMGR: 'REC READ','+8615021012496', ,'2010/09/25 15:06:37+32',145,4,0,241,'+861 3800210500',145,27 This is a test from Quectel OK 8.17. AT+CSMP Set SMS Text Mode Parameters AT+CSMP Set SMS Text Mode Parameters Test Command AT+CSMP=? Response +CSMP: (list of supported s),(list of supported s), (list of supported s),(list of supported s) OK MC20&MC30_AT_Commands_Manual 123 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Read Command AT+CSMP? Response +CSMP: ,,, Write Command AT+CSMP=[[,[,[,] ]]] OK Response TA selects values for additional parameters needed when SM is sent to the network or placed in a storage when text mode is selected (AT+CMGF=1). It is possible to set the validity period starting from when the SM is received by the SMSC ( is in range 0... 255) or define the absolute time of the validity period termination ( is a string). OK Maximum Response Time 300ms Reference GSM 07.05 Parameter Depending on the command or result code: first octet of GSM 03.40 SMS-DELIVER, SMS-SUBMIT (default value is 17), SMS-STATUS-REPORT, or SMS-COMMAND (default value is 2) in integer format. SMS status report is supported under text mode if is set to 49 Depending on SMS-SUBMIT setting: GSM 03.40 TP-Validity-Period either in integer format (default 167) or in time-string format (refer to ) GSM 03.40 TP-Protocol-Identifier in integer format (default value is 0) GSM 03.38 SMS Data Coding Scheme in Integer format NOTE The command writes the parameters in non-volatile memory. 8.18. AT+QCLASS0 Store Class 0 SMS to (U)SIM When Receiving Class 0 SMS AT+QCLASS0 Store Class 0 SMS to (U)SIM When Receiving Class 0 SMS Test Command AT+QCLASS0=? Response +QCLASS0: (list of supported s) MC20&MC30_AT_Commands_Manual 124 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Read Command AT+QCLASS0? Write Command AT+QCLASS0= Maximum Response Time Reference Quectel OK Response +QCLASS0: OK Response OK If there is any error, response: ERROR 300ms Parameter 0 1 Disable storing Class 0 SMS when receiving Class 0 SMS Enable storing Class 0 SMS when receiving Class 0 SMS Example //When in text mode: AT+CPMS? +CPMS: 'SM',6,50,'SM',6,50,'SM',6,50 OK AT+QCLASS0=0 OK //Disable storing SMS when receiving Class 0 SMS +CMT: '+8615021012496',,'2010/09/26 09:55:37+32' TEST1 from Quectel //Short message is output directly AT+QCLASS0=1 //Enable storing SMS when receiving Class 0 SMS OK +CMTI: 'SM',7 //Indicate that new message has been received AT+CMGR=7 +CMGR: 'REC UNREAD','+8615021012496','','2010/09/26 09:56:17+32' TEST2 from Quectel OK MC20&MC30_AT_Commands_Manual 125 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 8.19. AT+QMGDA Delete All SMS AT+QMGDA Delete All SMS Test Command AT+QMGDA=? Write Command AT+QMGDA= Maximum Response Time Reference Quectel Response +QMGDA: (listed of supported s) OK Response OK If there is any error, response: ERROR Or +CME ERROR: Depends on the storage of deleted messages. Parameter 1) In text mode: 'DEL READ' Delete all read messages 'DEL UNREAD' Delete all unread messages 'DEL SENT' Delete all sent SMS 'DEL UNSENT' Delete all unsent SMS 'DEL INBOX' Delete all received SMS 'DEL ALL' Delete all SMS 2) In PDU mode: 1 Delete all read messages 2 Delete all unread messages 3 Delete all sent SMS 4 Delete all unsent SMS 5 Delete all received SMS 6 Delete all SMS 8.20. AT+QSMSCODE Configure SMS Code Mode AT+QSMSCODE Configure SMS Code Mode Test Command Response MC20&MC30_AT_Commands_Manual 126 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+QSMSCODE=? Read Command AT+QSMSCODE? Write Command AT+QSMSCODE= Maximum Response Time Reference Quectel +QSMSCODE: (list of supported s) OK Response +QSMSCODE: OK Response OK If there is any error, response: ERROR 300ms Parameter 0 1 2 Code mode according with NOKIA Code mode according with SIEMENS Code mode according with NOKIA, and hexadecimal 0x11 treated as '_' hexadecimal 0x02 treated as '$' MC20&MC30_AT_Commands_Manual 127 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 9 Phonebook Commands 9.1. AT+CPBS Select Phonebook Memory Storage AT+CPBS Select Phonebook Memory Storage Test Command AT+CPBS=? Response +CPBS: (list of supported s) Read Command AT+CPBS? OK Response +CPBS: [,,] Write Command AT+CPBS= Maximum Response Time Reference GSM 07.07 OK Response TA selects current phone book memory storage, which is used by other phone book commands. OK 300ms Parameter 'MC' 'RC' 'DC' 'LA' 'ME' 'BN' 'SD' 'VM' 'FD' 'LD' 'ON' ME missed (unanswered) calls list ME received calls list ME dialed calls list (AT+CPBW may not be applicable or this storage) (same as LD) Last Number All list (LND/LNM/LNR) ME phonebook (U)SIM barred dialed number (U)SIM service dial number (U)SIM voice mailbox (U)SIM fix dialing-phone book (U)SIM last-dialing-phone book (U)SIM (or ME) own numbers (MSISDNs) list MC20&MC30_AT_Commands_Manual 128 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 'SM' (U)SIM phonebook Integer type value indicating the total number of used locations in selected memory Integer type value indicating the total number of locations in selected memory NOTE (U)SIM phonebook record can store up to 250pcs and ME phonebook record can store up to 100pcs. 9.2. AT+CPBW Write Phonebook Entry AT+CPBW Write Phonebook Entry Test Command AT+CPBW=? Response TA returns location range supported by the current storage, the maximum length of field, supported number formats of the storage, and the maximum length of field. +CPBW: (The range of supported s),,(list of supported s), Write Command AT+CPBW=[,[,[,]]] Maximum Response Time Reference GSM 07.07 OK Response TA writes phone book entry in location number in the current phone book memory storage selected with +CPBS. Entry fields written are phone number (in the format ) and text associated with the number. If those fields are omitted, phone book entry is deleted. If is left out, but is given, entry is written to the first free location in the phone book. OK 300ms Parameter Maximum length of phone number Maximum length of text for number Location number Phone number MC20&MC30_AT_Commands_Manual 129 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Type of number 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Text for phone number in current TE character set specified by AT+CSCS NOTES 1. If the current memory storage is 'MC', 'RC', 'DC', 'LA' or 'LD', , and parameters must be default. AT+CPBW command only supports settings delete the number of current phone book. 2. can’t be empty. 3. The following characters in must be entered via the escape sequence: GSM char Seq.Seq.(hex) Note 5C 5C 35 43 (backslash) ' 22 5C 32 32 (string delimiter) BSP 8 5C 30 38 (backspace) NULL 0 5C 30 30 (GSM null) ‘0’ (GSM null) may cause problems for application layer software when reading string lengths. Example AT+CSCS='GSM' OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK //Make a new phonebook entry at location 10 AT+CPBW=10 //Delete entry at location 10 OK 9.3. AT+CPBR Read Current Phonebook Entries AT+CPBR Read Current Phonebook Entries Test Command AT+CPBR=? Response TA returns location range supported by the current storage as a compound value and the maximum lengths of and fields. +CPBR: (list of supported s),, Write Command AT+CPBR=[,] OK Response TA returns phone book entries in location number range ... from the current phone book memory MC20&MC30_AT_Commands_Manual 130 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.07 storage selected with +CPBS. If is omitted, only location is returned. +CPBR:,,, [.... +CPBR: ,,,] OK 300ms. Note: Operation of depends on the storage of read phonebook entries. Parameter Location number Maximum length of phone number Maximum length of name for number The first phone book record to read The last phonebook record to read Phone number Type of number Text name for phone number in current TE character set specified by AT+CSCS Example AT+CSCS='GSM' OK AT+CPBR=10 //Query phonebook entries in location 10 +CPBR: '10,15021012496',129,'QUECTEL' OK 9.4. AT+CPBF Find Phonebook Entries AT+CPBF Find Phonebook Entries Test Command AT+CPBF=? Response +CPBF: , Write Command OK Response MC20&MC30_AT_Commands_Manual 131 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+CPBF=[] Maximum Response Time Reference GSM 07.07 TA returns phonebook entries (from the current phonebook memory storage selected with AT+CPBS) which contain alphanumeric string . [+CPBF: ,,, [...]] OK Depends on the storage of phonebook entries. Parameter String type field of maximum length in current TE character set specified by AT+CSCS. Integer type values in the range of location numbers of phone book memory Phone number in string type of format Type of address octet in integer format: 129 Unknown type (IDSN format number) 145 International number type (ISDN format) String type field of maximum length in current TE character set specified by AT+CSCS Integer type value indicating the maximum length of field Integer type value indicating the maximum length of field 9.5. AT+CNUM Subscriber Number AT+CNUM Subscriber Number Test Command AT+CNUM=? Execution Command AT+CNUM Response OK Response +CNUM: [],, [...] OK Maximum Response Time If there is any error related to ME functionality: +CME ERROR: 300ms MC20&MC30_AT_Commands_Manual 132 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Reference GSM 07.07 Parameter Optional alphanumeric string associated with ; used character set should be the one selected with command. Select TE character set AT+CSCS Phone number in string type of format specified by Type of address octet in integer format (refer to GSM 04.08 subclause 10.5.4.7) MC20&MC30_AT_Commands_Manual 133 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 10 GPRS Commands 10.1. AT+CGATT Attach to/Detach from GPRS Service AT+CGATT Attach to/Detach from GPRS Service Test Command AT+CGATT=? Response +CGATT: (list of supported s) Read Command AT+CGATT? OK Response +CGATT: Write Command AT+CGATT= OK Response OK Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 75s, determined by network. Parameter Indicates the state of GPRS attachment 0 Detached 1 Attached Other values are reserved and will result in an ERROR response to the Write Command Example AT+CGATT=1 OK AT+CGATT=0 OK //Attach to GPRS service //Detach from GPRS service MC20&MC30_AT_Commands_Manual 134 / 259 AT+CGATT? +CGATT: 0 OK GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual //Query the current GPRS service state 10.2. AT+CGDCONT Define PDP Context AT+CGDCONT Define PDP Context Test Command AT+CGDCONT=? Response +CGDCONT: (range of supported s),, ,,(list of supported s),(list of supported s) Read Command AT+CGDCONT? OK Response +CGDCONT: ,,,,, […] Write Command AT+CGDCONT=[,[,< APN>[,[,[,]]]]] OK Response OK If there is any error, response: ERROR Maximum Response Time 300ms Reference GSM 07.07 Parameter (PDP Context Identifier) a numeric parameter which specifies a particular PDP context definition. The parameter is local to the TE-MT interface and is used in other PDP context- related commands. The range of permitted values (minimum value=1) is returned by the test form of the command (Packet Data Protocol type) a string parameter which specifies the type of packet data protocol X25 ITU-T/CCITT X.25 layer 3 IP Internet Protocol (IETF STD 5) OSPIH Internet Hosted Octet Stream Protocol PPP Point to Point Protocol (IETF STD 51) (Access Point Name) a string parameter that is a logical name that is used to select the MC20&MC30_AT_Commands_Manual 135 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual GGSN or the external packet data network. If the value is null or omitted, then the subscription value will be requested A string parameter identifies the MT in the address space applicable to the PDP. If the value is null or omitted, then a value may be provided by the TE during the PDP startup procedure or, failing that, a dynamic address will be requested. The allocated address may be read using the AT+CGPADDR command A numeric parameter that controls PDP data compression 0 Off (default if value is omitted) Other values are reserved A numeric parameter that controls PDP header compression 0 Off (default if value is omitted) Other values are reserved Example AT+CGDCONT=1,'IP','CMNET' //Define PDP context by configuring =1, =IP and =CMNET. OK 10.3. AT+CGQREQ Quality of Service Profile (Requested) AT+CGQREQ Quality of Service Profile (Requested) Test Command AT+CGQREQ=? Response +CGQREQ: ,(list of supported s), (list of supported s),(list of supported s), (list of supported s),(list of supported s) Read Command AT+CGQREQ? OK Response +CGQREQ: ,,,,, […] Write Command AT+CGQREQ=[,[, [,[,[,]]]]] OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference MC20&MC30_AT_Commands_Manual 136 / 259 GSM 07.07 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) The following parameter are defined in GSM 03.60 A numeric parameter which specifies the precedence class A numeric parameter which specifies the delay class A numeric parameter which specifies the reliability class A numeric parameter which specifies the peak throughput class A numeric parameter which specifies the mean throughput class 10.4. AT+CGQMIN Quality of Service Profile (Minimum Acceptable) AT+CGQMIN Quality of Service Profile (Minimum Acceptable) Test Command AT+CGQMIN=? Response +CGQMIN: ,(list of supported s), (list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CGQMIN? OK Response +CGQMIN: ,,,,, […] Write Command AT+CGQMIN=[,[,< delay>[,[,[, ]]]]] OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference GSM 07.07 MC20&MC30_AT_Commands_Manual 137 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) The following parameters are defined in GSM 03.60. A numeric parameter which specifies the precedence class A numeric parameter which specifies the delay class A numeric parameter which specifies the reliability class A numeric parameter which specifies the peak throughput class A numeric parameter which specifies the mean throughput class 10.5. AT+CGACT PDP Context Activate or Deactivate AT+CGACT PDP Context Activate or Deactivate Test Command AT+CGACT=? Response +CGACT: (list of supported s) Read Command AT+CGACT? OK Response +CGACT: , […] Write Command AT+CGACT=[,] Maximum Response Time Reference GSM 07.07 OK Response OK If context is deactivated successfully, response: NO CARRIER If there is any error related to ME functionality: +CME ERROR: 150s, determined by network. Parameter Indicates the state of PDP context activation 0 Deactivated 1 Activated MC20&MC30_AT_Commands_Manual 138 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Other values are reserved and will result in an ERROR response to the Write Command A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command). The default value is 1. Example AT+CGDCONT=1,'IP','CMNET' OK AT+CGACT=1,1 OK AT+CGACT=0,1 NO CARRIER //Define PDP context //Activated PDP //Deactivated PDP 10.6. AT+CGDATA Enter Data State AT+CGDATA Enter Data State Test Command AT+CGDATA=? Response +CGDATA: (list of supported s) Write Command AT+CGDATA=[,[,[,… ]]] OK Response OK NO CARRIER Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A string parameter that indicates the layer 2 protocol to be used between the TE and MT: PPP - Point to Point protocol for a PDP such as IP Other values are not supported and will result in an ERROR response to the execution command A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) MC20&MC30_AT_Commands_Manual 139 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 10.7. AT+CGPADDR Show PDP Address AT+CGPADDR Show PDP Address Test Command AT+CGPADDR=? Response +CGPADDR: (list of defined s) Write Command AT+CGPADDR= OK Response +CGPADDR: [,] OK Maximum Response Time Reference GSM 07.07 If there is any error, response: ERROR 300ms Parameter A numeric parameter which specifies a particular PDP context definition (see AT+CGDCONT command) A string that identifies the MT in the address space applicable to the PDP. The address may be static or dynamic. For a static address, it will be the one set by the AT+CGDCONT command when the context was defined. For a dynamic address it will be the one assigned during the last PDP context activation that used the context definition referred to . is omitted if none is available NOTE This command dictates the behaviour of PPP in the ME but not that of any other GPRS-enabled foreground layer, e.g. browser. Example AT+CGDCONT=1,'IP','CMNET' OK AT+CGACT=1,1 OK AT+CGPADDR=1 +CGPADDR: 1,'10.76.51.180' //Define PDP context //Activated PDP //Show PDP address MC20&MC30_AT_Commands_Manual 140 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual OK 10.8. AT+CGCLASS GPRS Mobile Station Class AT+CGCLASS GPRS Mobile Station Class Test Command AT+CGCLASS=? Response +CGCLASS: (list of supported s) Read Command AT+CGCLASS? Write Command AT+CGCLASS= Maximum Response Time Reference GSM 07.07 OK Response +CGCLASS: OK Response OK ERROR If there is any error related to ME functionality: +CME ERROR: 30s, determined by network. Parameter A string parameter which indicates the GPRS mobile class (Functionality in descending order) 'B' Class B 'CG' Class C in GPRS only mode 'CC' Class C in circuit switched only mode 10.9. AT+CGEREP Control Unsolicited GPRS Event Reporting AT+CGEREP Control Unsolicited GPRS Event Reporting Test Command AT+CGEREP=? Response +CGEREP: (list of supported s) OK MC20&MC30_AT_Commands_Manual 141 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Read Command AT+CGEREP? Maximum Response Time Write Command AT+CGEREP= Reference GSM 07.07 Response +CGEREP: OK 300ms Response OK If there is any error, response: ERROR Parameter 0 1 Buffer unsolicited result codes in the MT; if MT result code buffer is full, the oldest one can be discarded. No codes are forwarded to the TE Discard unsolicited result codes when MT-TE link is reserved (e.g. in on-line data mode); otherwise forward them directly to the TE NOTE Unsolicited Result Codes supported: +CGEV: NW DEACT ,[,] +CGEV: ME DEACT ,[,] +CGEV: NW DETACH +CGEV: ME CLASS Parameters Packet Data Protocol type (see AT+CGDCONT command) Packet Data Protocol address (see AT+CGDCONT command) Context ID (see AT+CGDCONT command) GPRS mobile class (see AT+CGCLASS command ) 10.10. AT+CGREG Network Registration Status AT+CGREG Network Registration Status Test Command AT+CGREG=? Response +CGREG: (list of supported s) OK MC20&MC30_AT_Commands_Manual 142 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Read Command AT+CGREG? Write Command AT+CGREG=[] Maximum Response Time Reference GSM 07.07 Response +CGREG: ,[,,] OK Response OK If there is any error, response: ERROR 300ms Parameter 0 Disable network registration unsolicited result code 1 Enable network registration unsolicited result code +CGREG: 2 Enable network registration and location information unsolicited result code +CGREG: [,,] 0 Not registered, ME is not currently searching a new operator to register to 1 Registered, home network 2 Not registered, but ME is currently searching a new operator to register to 3 Registration denied 4 Unknown 5 Registered, roaming String type. Two-byte location area code in hexadecimal format (e.g. '00C3' equals 195 in decimal) String type. Two-byte cell ID in hexadecimal format NOTE Parameter state only supports options 0 and 1. Example AT+CGATT=0 NO CARRIER +CGREG: 0,'1878','0873' AT+CGATT=1 OK +CGREG: 2,'1878','0873' MC20&MC30_AT_Commands_Manual 143 / 259 +CGREG: 1,'1878','0873' GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 10.11. AT+CGSMS Select Service for MO SMS Messages AT+CGSMS Select Service for MO SMS Messages Test Command AT+CGSMS=? Response +CGSMS: (list of currently available s) Read Command AT+CGSMS? Write Command AT+CGSMS=[] Maximum Response Time Reference GSM 07.07 OK Response +CGSMS: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A numeric parameter which indicates the service or service preference to be used 0 GPRS 1 Circuit switch 2 GPRS preferred (use circuit switched if GPRS is not available) 3 Circuit switch preferred (use GPRS if circuit switched is not available) NOTE The circuit switched service route is the default method. MC20&MC30_AT_Commands_Manual 144 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 10.12. AT+QGPCLASS Change GPRS Multi-slot Class AT+QGPCLASS Change GPRS Multi-slot Class Test Command AT+QGPCLASS=? Response MULTISLOT CLASS: (list of currently available s) Read Command AT+QGPCLASS? OK Response MULTISLOT CLASS: Write Command AT+QGPCLASS= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms Parameter GPRS multi-slot class 1-12 Default value is 12 NOTE The command takes effect after the module is restarted. MC20&MC30_AT_Commands_Manual 145 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11 TCP/IP Commands 11.1. AT+QIOPEN Start up TCP or UDP Connection AT+QIOPEN Start up TCP or UDP Connection Test Command AT+QIOPEN=? Response +QIOPEN: (list of supported s),(IP address range),(port) +QIOPEN: (list of supported s),(domain name),(port) Write Command AT+QIOPEN=[,],/, OK Response If format is right, response: OK Otherwise response: ERROR If the connection has already existed, response: ALREADY CONNECT And then if connection is successful, 1) When AT+QIMODE=0, response: [,] CONNECT OK Maximum Response Time Reference Quectel 2) When AT+QIMODE=1, response: CONNECT Otherwise response: [,] CONNECT FAIL 75s, determined by network. MC20&MC30_AT_Commands_Manual 146 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter A numeric indicates which socket opens the connection. MC20/MC30 supports at most 6 sockets at the same time. This parameter is necessary only if AT+QIMUX was set as 1 (refer to AT+QIMUX). When AT+QIMUX was set as 0, the parameter MUST be omitted A string parameter which indicates the connection type 'TCP' Establish a TCP connection 'UDP' Establish a UDP connection A string parameter that gives the address of the remote server in dotted decimal style. The port of the remote server 0-65535 A string parameter which represents the domain name address of the remote server NOTES 1. This command is allowed to establish a TCP/UDP connection only when the state is IP INITIAL, IP STATUS or IP CLOSE. So it is necessary to process AT+QIDEACT or AT+QICLOSE before establishing a TCP/UDP connection with this command when the state is not IP INITIAL, IP STATUS or IP CLOSE. 2. If AT+QIMUX was set as 0 and the current state is CONNECT OK, which means the connection channel is used, it will reply ALREADY CONNECT after issuing the Write Command. 11.2. AT+QISEND Send Data through TCP or UDP Connection AT+QISEND Send Data through TCP or UDP Connection Test Command AT+QISEND=? Response +QISEND: Execution Command AT+QISEND response'>', then type data to send, tap CTRL+Z to send, tap ESC to cancel the operation OK Response This command is used to send changeable length data. If connection is not established or disconnected, response: ERROR If sending succeeds, response: SEND OK Write Command If sending fails, response: SEND FAIL Response MC20&MC30_AT_Commands_Manual 147 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 1) When AT+QIMUX=0 AT+QISEND= 2) When AT+QIMUX=1 AT+QISEND=[,] Maximum Response Time Reference Quectel This command is used to send fixed-length data or send data on the given socket (defined by ). If connection is not established or disconnected, response: ERROR If sending succeeds, response: SEND OK If sending fails, response: SEND FAIL 300ms Parameter The index of the socket for sending data. This parameter is necessary only if AT+QIMUX was set as 1 (refer to AT+QIMUX). When AT+QIMUX was set as 0, the parameter MUST be omitted A numeric parameter which indicates the length of data to be sent, it MUST be less than 1460 NOTES 1. This command is used to send data on the TCP or UDP connection that has been established already. ‘Ctrl+Z’ is used as a termination symbol. ESC is used to cancel sending data. 2. The maximum length of the data to input at a time is 1460. 3. Data can only be sent at the status of connection, otherwise ERROR will be responded. 4. SEND OK means the data have been put into the send window to send rather than it has received the ACK message for the data from the remote node. To check whether the data has been sent to the remote node, it is necessary to execute the command AT+QISACK to query it. 11.3. AT+QICLOSE Close TCP or UDP Connection AT+QICLOSE Close TCP or UDP Connection Test Command AT+QICLOSE=? Execution Command AT+QICLOSE Response OK Response If closing succeeds, response: CLOSE OK MC20&MC30_AT_Commands_Manual 148 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+QICLOSE= Maximum Response Time Reference Quectel If closing fails, response: ERROR Response If closing succeeds, response: ,CLOSE OK If closing fails, response: ERROR 300ms Parameter The index of the socket for sending data. This parameter is necessary only if AT+QIMUX was set as 1 (refer to AT+QIMUX). When AT+QIMUX was set as 0, the parameter MUST be omitted NOTES 1. Execution Command AT+QICLOSE:  If QISRVC is 1 (please refer to AT+QISRVC) and QIMUX is 0 (please refer to AT+QIMUX), this command will close the connection in which the module is used as a client.  If QISRVC is 1 and QIMUX is 1, it will return ERROR.  If QISRVC is 2, QIMUX equals 0, the module is used as a server and some clients have been connected to it, this command will close the connection between the module and the remote client.  If QISRVC is 2, QIMUX is 0 and the module is in listening state without any client, this command will cause the module to quit the listening state.  If QISRVC is 2, QIMUX is 1 and the module is used as a server, this command will close all the income connection and cause the module to quit the listening state. 2. Write Command AT+QICLOSE=:  This command is valid only if QIMUX is 1.  If QISRVC is 1 and QIMUX is 1, this command will close the corresponding connection according to and the module is used as a client in the connection.  If QISRVC is 2 and QIMUX is 1, this command will close the incoming connection according to . 3. If QISRVC is 1 and QIMUX is 0, AT+QICLOSE only closes the connection when the status is CONNECTING or CONNECT OK, otherwise responds with ERROR. After closing the connection, the status is IP CLOSE. MC20&MC30_AT_Commands_Manual 149 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.4. AT+QIDEACT Deactivate GPRS/CSD PDP Context AT+QIDEACT Deactivate GPRS/CSD PDP Context Test Command AT+QIDEACT=? Execution Command AT+QIDEACT Response OK Response If deactivation succeeds, response: DEACT OK Maximum Response Time Reference Quectel If deactivation fails, response: ERROR 40s, determined by network. NOTES 1. In addition to at the status of IP INITIAL, GPRS/CSD PDP context can be deactivated by AT+QIDEACT. After closing the connection, the status becomes IP INITIAL again. 2. CSD context is not supported at present. 11.5. AT+QILPORT Set Local Port AT+QILPORT Set Local Port Test Command AT+QILPORT=? Read Command AT+QILPORT? Write Command AT+QILPORT=, Maximum Response Time Response +QILPORT: (list of supported s) OK Response : ... OK Response OK If there is any error, response: ERROR 300ms MC20&MC30_AT_Commands_Manual 150 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Reference Quectel Parameter A string parameter which indicates the connection type 'TCP' TCP local port 'UDP' UDP local port 0-65535 A numeric parameter which indicates the local port NOTE This command is used to set the port for listening. 11.6. AT+QIREGAPP Start TCP/IP Task and Set APN, User Name and Password AT+QIREGAPP Start TCP/IP Task and Set APN, User Name and Password Test Command AT+QIREGAPP=? Response +QIREGAPP: 'APN','USER','PWD' Read Command AT+QIREGAPP? OK Response +QIREGAPP: ,, Write Command AT+QIREGAPP=,, [,] Execution Command AT+QIREGAPP OK Response OK If there is any error, response: ERROR Response OK Maximum Response Time Reference If there is any error, response: ERROR 300ms MC20&MC30_AT_Commands_Manual 151 / 259 Quectel GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter A string parameter which indicates the GPRS access point name or the call number of CSD A string parameter which indicates the GPRS/CSD user name A string parameter which indicates the GPRS/CSD password The speed of data transmit for CSD NOTES 1. The write command and execution commands are valid only at the status of IP INITIAL. After operating this command, the status will become IP START. 2. The value of QICSGP (please refer to AT+QICSGP) defines what kind of bearer (GPRS or CSD) the parameters are used for. 3. CSD function and related configuration are not supported at present. 11.7. AT+QIACT Activate GPRS/CSD Context AT+QIACT Activate GPRS/CSD Context Test Command AT+QIACT=? Execution Command AT+QIACT Response OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 150s, determined by network. NOTES 1. AT+QIACT only activates GPRS/CSD context at the status of IP START. After operating this command, the status will become IP CONFIG. If TA accepts the activated operation, the status will become IP IND. After GPRS/CSD context is activated successfully, the status will become IP GPRSACT, and responds with OK; otherwise responds with ERROR. 2. CSD context is not supported at present. MC20&MC30_AT_Commands_Manual 152 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.8. AT+QILOCIP Get Local IP Address AT+QILOCIP Get Local IP Address Test Command AT+QILOCIP=? Execution Command AT+QILOCIP Response OK Response If execution succeeds, response: Maximum Response Time Reference Quectel Otherwise response: ERROR 300ms Parameter A string parameter which indicates the IP address assigned from GPRS or CSD network NOTES 1. Only at the following status: IP GPRSACT, IP STATUS, TCP/UDP CONNECTING, CONNECT OK, IP CLOSE can get local IP address by AT+QILOCIP; otherwise responds ERROR. And if the status before executing the command is IP GPRSACT, the status will become IP STATUS after the command. 2. CSD function is not supported at present. 11.9. AT+QISTAT Query Current Connection Status AT+QISTAT Query Current Connection Status Test Command AT+QISTAT=? Execution Command AT+QISTAT Response OK Response When AT+QIMUX=0: OK STATE: When AT+QIMUX=1: MC20&MC30_AT_Commands_Manual 153 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel List of +QISTAT: ,,, … OK 300ms Parameter A string parameter to indicate the status of the connection 'IP INITIAL' The TCP/IP stack is in idle state 'IP START' The TCP/IP stack has been registered 'IP CONFIG' It has been start-up to activate GPRS/CSD context 'IP IND' It is activating GPRS/CSD context 'IP GPRSACT' GPRS/CSD context has been activated successfully 'IP STATUS' The local IP address has been gotten by the command AT+QILOCIP 'TCP CONNECTING' It is trying to establish a TCP connection 'UDP CONNECTING' It is trying to establish a UDP connection 'IP CLOSE' The TCP/UDP connection has been closed 'CONNECT OK' The TCP/UDP connection has been established successfully 'PDP DEACT' GPRS/CSD context was deactivated because of unknown reason If ATV was set to 0 by the command ATV0, the TCP/IP stack gives the following numeric to indicate the former status 0 'IP INITIAL' 1 'IP START' 2 'IP CONFIG' 3 'IP IND' 4 'IP GPRSACT' 5 'IP STATUS' 6 'TCP CONNECTING' or 'UDP CONNECTING' 7 'IP CLOSE' 8 'CONNECT OK' 9 'PDP DEACT' The index of the connection, the range is (0-5) The type of the connection 'TCP' TCP connection 'UDP' UDP connection The IP address of the remote The port of the remote MC20&MC30_AT_Commands_Manual 154 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. Display former style of response when QIMUX=0 and the later style of response when QIMUX=1. 2. CSD context is not supported at present. 11.10. AT+QISTATE Query Connection Status of the Current Access AT+QISTATE Query Connection Status of the Current Access Test Command AT+QISTATE=? Execution Command AT+QISTATE Response OK Response When AT+QIMUX=0: OK STATE: When AT+QIMUX=1: OK STATE: Maximum Response Time Reference Quectel +QISTATE: ,,,, OK Otherwise response: ERROR 300ms Parameter A string parameter to indicate the status of the connection When AT+QIMUX=0: 'IP INITIAL' The TCP/IP stack is in idle state. 'IP START' The TCP/IP stack has been registered. 'P CONFIG' It has been start-up to activate GPRS/CSD context. 'IP IND' It is activating GPRS/CSD context. 'IP GPRSACT' GPRS/CSD context has been activated successfully. MC20&MC30_AT_Commands_Manual 155 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 'IP STATUS' The local IP address has been gotten by the command AT+QILOCIP. 'TCP CONNECTING' It is trying to establish a TCP connection. 'UDP CONNECTING' It is trying to establish a UDP connection. 'IP CLOSE' The TCP/UDP connection has been closed. 'CONNECT OK' The TCP/UDP connection has been established successfully. 'PDP DEACT' GPRS/CSD context was deactivated because of unknown reason. When AT+QIMUX=1: 'IP INITIAL' The TCP/IP stack is in idle state. 'IP START' The TCP/IP stack has been registered. 'IP CONFIG' It has been start-up to activate GPRS/CSD context. 'IP IND' It is activating GPRS/CSD context. 'IP GPRSACT' GPRS/CSD context has been activated successfully. 'IP STATUS' The local IP address has been gotten by the command AT+QILOCIP. 'IP PROCESSING' Data phase. Processing the existing connection now. 'PDP DEACT' GPRS/CSD context was deactivated because of unknown reason. The index of the connection, the range is (0-5) The type of the connection 'TCP' TCP connection 'UDP' UDP connection The IP address of the remote The port of the remote A string parameter to indicate the status of the access connection, including INITIAL,CONNECTED. 11.11. AT+QISSTAT Query the Current Server Status AT+QISSTAT Query the Current Server Status Test Command AT+QISSTAT=? Execution Command AT+QISSTAT Response OK Response When AT+QIMUX=0: OK S: When AT+QIMUX=1: OK MC20&MC30_AT_Commands_Manual 156 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel S: C: ,,, Otherwise response: ERROR 300ms Parameter A string parameter to indicate the status of the connection 'INITIAL' The TCP/IP stack is in idle state 'OPENNING' The TCP/IP stack has been registered 'LISTENING' Listening to server port 'CLOSING' Closing connection now The index of the connection, the range is (0-4) The type of the connection 'TCP' TCP connection 'UDP' UDP connection The IP address of the remote The port of the remote 11.12. AT+QIDNSCFG Configure Domain Name Server AT+QIDNSCFG Configure Domain Name Server Test Command AT+QIDNSCFG=? Read Command AT+QIDNSCFG? Response OK Response PrimaryDns: SecondaryDns: Write Command AT+QIDNSCFG=[,] OK Response OK If there is any error: ERROR Maximum Response Time 300ms MC20&MC30_AT_Commands_Manual 157 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Reference Quectel Parameter A string parameter which indicates the IP address of the primary domain name server A string parameter which indicates the IP address of the secondary domain name server NOTES 1. Since TA will negotiate to get the DNS server from GPRS/CSD network automatically when activating GPRS/CSD context, it is STRONGLY suggested to configure the DNS server at the status of IP GPRSACT, IP STATUS, CONNECT OK and IP CLOSE if it is necessary. 2. CSD function and configuration are not supported currently. 11.13. AT+QIDNSGIP Query the IP Address of Given Domain Name AT+QIDNSGIP Query the IP Address of Given Domain Name Test Command AT+QIDNSGIP=? Write Command AT+QIDNSGIP= Response OK Response OK ERROR If the query succeeds, response: Maximum Response Time Reference Quectel If the query fails, response: ERROR: STATE: 14s, determined by network. Parameter A string parameter which indicates the domain name A string parameter which indicates the IP address corresponding to the domain name A numeric parameter which indicates the error code MC20&MC30_AT_Commands_Manual 158 / 259 1 DNS not Authorized 2 Invalid parameter 3 Network error 4 No server 5 Time out 6 No configuration 7 No memory 8 Unknown error Refer to AT+QISTAT GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.14. AT+QIDNSIP Connect with IP Address or Domain Name Server AT+QIDNSIP Connect with IP Address or Domain Name Server Test Command AT+QIDNSIP=? Response +QIDNSIP: (list of supported s) Read Command AT+QIDNSIP? OK Response +QIDNSIP: Write Command AT+QIDNSIP= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms Parameter A numeric parameter indicates which kind of server format is used when establishing the connection: IP address server or domain name server 0 The address of the remote server is a dotted decimal IP address 1 The address of the remote server is a domain name MC20&MC30_AT_Commands_Manual 159 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.15. AT+QIHEAD Add an IP Header When Receiving Data AT+QIHEAD Add an IP Header When Receiving Data Test Command AT+QIHEAD=? Response +QIHEAD: (list of supported s) Read Command AT+QIHEAD? OK Response +QIHEAD: Write Command AT+QIHEAD= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms Parameter A numeric parameter which indicates whether or not to add an IP header before the received data 0 DO Not add IP header 1 Add a header before the received data, and the format is 'IPD(data length):' 11.16. AT+QIAUTOS Set Auto Sending Timer AT+QIAUTOS Set Auto Sending Timer Test Command AT+QIAUTOS=? Response +QIAUTOS: (list of supported s),(list of supported s) Read Command AT+QIAUTOS? OK Response +QIAUTOS: , OK MC20&MC30_AT_Commands_Manual 160 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+QIAUTOS=[,] Maximum Response Time Reference Quectel Response OK If there is any error, response: ERROR 300ms Parameter A numeric parameter which indicates whether or not to set timer when sending data 0 Do not set timer for data sending 1 Set timer for data sending A numeric parameter which indicates a time in seconds After the time expires since AT+QISEND, the input data will be sent automatically 11.17. AT+QIPROMPT Set Prompt of ‘>’ When Sending Data AT+QIPROMPT Set Prompt of ‘>’ When Sending Data Test Command AT+QIPROMPT=? Response +QIPROMPT: (list of supported s) Read Command AT+QIPROMPT? OK Response +QIPROMPT: Write Command AT+QIPROMPT= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms MC20&MC30_AT_Commands_Manual 161 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter A numeric parameter which indicates whether or not to echo prompt '>' after issuing AT+QISEND Command 0 No prompt '>' and show 'SEND OK' when sending succeeds 1 Echo prompt '>' and show 'SEND OK' when sending succeeds 2 No prompt and not show 'SEND OK' when sending succeeds 3 Echo prompt '>' and show 'socket ID' 'SEND OK' when sending succeeds 11.18. AT+QISERVER Configured as Server AT+QISERVER Configured as Server Test Command AT+QISERVER=? Read Command AT+QISERVER? Response OK Response +QISERVER: , Execution Command AT+QISERVER Write Command AT+QISERVER=[,] Maximum Response Time Reference Quectel OK Response OK ERROR If configured as server succeeds, response: SERVER OK If configured as server does not succeeds, response: CONNECT FAIL Response OK ERROR If configured as server succeeds, response: SERVER OK If configured as server does not succeeds, return: CONNECT FAIL 150s, determined by network. MC20&MC30_AT_Commands_Manual 162 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 0 NOT configured as server 1 Configured as server The number of clients that have been connected in. The range is 0~5 A numeric indicates the type of the server 0 TCP server 1 UDP server The maximum number of clients allowed to connect in. The default value is 1. The range is 1-5 NOTES 1. Execution command configures the module as a TCP server and the maximum allowed client is 1. 2. The parameter is excluded when QIMUX is 0. 11.19. AT+QICSGP Select CSD or GPRS as the Bearer AT+QICSGP Select CSD or GPRS as the Bearer Test Command AT+QICSGP=? Response +QICSGP: 0-CSD,DIAL NUMBER,USER NAME,PASSWO RD,RATE(0-3) +QICSGP: 1-GPRS,APN,USER NAME,PASSWORD Read Command AT+QICSGP? OK Response +QICSGP: Write Command AT+QICSGP=[,(,,)/(, ,,)] OK Response OK If there is any error, response: ERROR Maximum Response Time 300ms Reference Quectel MC20&MC30_AT_Commands_Manual 163 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter A numeric parameter which indicates the bearer type 0 Set CSD as the bearer for TCP/IP connection 1 Set GPRS as the bearer for TCP/IP connection GPRS parameters: A string parameter which indicates the access point name A string parameter which indicates the user name A string parameter which indicates the password CSD parameters: A string parameter which indicates the CSD dial numbers A string parameter which indicates the CSD user name A string parameter which indicates the CSD password A numeric parameter which indicates the CSD connection rate 0 2400 1 4800 2 9600 3 14400 NOTE CSD configuration is not supported at present. 11.20. AT+QISRVC Choose Connection AT+QISRVC Choose Connection Test Command AT+QISRVC=? Response +QISRVC: (list of supported s) Read Command AT+QISRVC? OK Response +QISRVC: Write Command AT+QISRVC= OK Response OK If there is any error: ERROR MC20&MC30_AT_Commands_Manual 164 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel 300ms Parameter A numeric parameter which indicates the chosen connection 1 Choose the connection in which MS used as a client 2 Choose the connection in which MS used as a server NOTE There could be two connections at one time: one connection is that MS connects with a remote server as a client; the other connection is that MS accepts a remote client as a server. Using this command to specify which connection data will be sent through. 11.21. AT+QISHOWRA Set Whether or Not to Display the Address of Sender AT+QISHOWRA Set Whether or Not to Display the Address of Sender Test Command AT+QISHOWRA=? Response +QISHOWRA: (list of supported s) Read Command AT+QISHOWRA? Write Command AT+QISHOWRA= Maximum Response Time Reference Quectel OK Response +QISHOWRA: OK Response OK If there is any error: ERROR 300ms MC20&MC30_AT_Commands_Manual 165 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter A numeric parameter which indicates whether or not to show the address (including IP address in dotted decimal style of the remote end) when receiving data. 0 Do not show the address. 1 Show the address; the format to show the address is like: RECV FROM: : 11.22. AT+QISCON Save TCP/IP Application Context AT+QISCON Save TCP/IP Application Context Test Command AT+QISCON=? Read Command AT+QISCON? Response OK Response TA returns TCP/IP application context, which consists of the following AT command parameters. SHOW APPTCP/IP CONTEXT +QIDNSIP: +QIPROMPT: +QIHEAD: +QISHOWRA: +QICSGP: Gprs Config APN: Gprs Config UserId: Gprs Config Password: Gprs Config inactivityTimeout: App Tcpip Mode: [In Transparent Transfer Mode Number of Retry: Wait Time: Send Size: esc:] Execution Command AT+QISCON Maximum Response Time Reference Quectel OK Response OK 300ms MC20&MC30_AT_Commands_Manual 166 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter See AT+QIDNSIP See AT+QIPROMPT See AT+QIHEAD See AT+QISHOWRA See AT+QICSGP See AT+QICSGP See AT+QICSGP See AT+QICSGP See AT+QICSGP See AT+QICSGP See AT+QICSGP See AT+QICSGP See AT+QICSGP The following configurations are only for transparent transfer mode. See AT+QITCFG See AT+QITCFG See AT+QITCFG See AT+QITCFG NOTES 1. The execution command makes TA save TCP/IP Application Context which consists of the following AT Command parameters; and when the system is rebooted, these parameters will be loaded automatically: AT+QIDNSIP, AT+QIPROMPT, AT+QIHEAD, AT+QISHOWRA, AT+QICSGP, AT+QITCFG. 2. The execution command only saves the corresponding parameters of the foreground context (refer to AT+QIFGCNT). 3. CSD configuration is not supported at present. 11.23. AT+QIMODE Select TCP/IP Transfer Mode AT+QIMODE Select TCP/IP Transfer Mode Test Command AT+QIMODE=? Response +QIMODE: (list of supported s), Read Command AT+QIMODE? OK Response +QIMODE: MC20&MC30_AT_Commands_Manual 167 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+QIMODE= Maximum Response Time Reference Quectel OK Response OK If there is any error, response: ERROR 300ms Parameter 0 1 Normal mode. In this mode, the data should be sent by the command AT+QISEND Transparent mode. In this mode, UART will enter data mode after TCP/UDP connection has been established. In data mode, all input data from UART will be sent to the remote end. +++ can help to switch data mode to command mode. And then ATO can help to switch command mode to data mode. 11.24. AT+QITCFG Configure Transparent Transfer Mode AT+QITCFG Configure Transparent Transfer Mode Test Command AT+QITCFG=? Response +QITCFG: (list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+QITCFG? OK Response +QITCFG: ,,, Write Command AT+QITCFG=,,< SendSz>, Maximum Response Time Reference Quectel OK Response OK If there is any error, response: ERROR 300ms MC20&MC30_AT_Commands_Manual 168 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter Number of times to retry to send an IP packet Number of 100ms intervals to wait for serial input before sending the packet Size in bytes of data block to be received from serial port before sending Whether to turn on the escape sequence or not; default is TRUE NOTES 1. and are two conditions to send data packet. 2. Firstly, if the length of the input data from UART is greater than or equal to , the TCP/IP stack will send the data by length to the remote. 3. Secondly, if the length of the input data from UART is less than , and the idle time keeps beyond the time defined by , the TCP/IP stack will send all the data in the buffer to the remote. 4. This command is invalid when AT+QIMUX=1. 11.25. AT+QISHOWPT Control Whether or Not to Show the Protocol Type AT+QISHOWPT Control Whether or Not to Show the Protocol Type Test Command AT+QISHOWPT=? Response +QISHOWPT: (list of supported s) Read Command AT+QISHOWPT? OK Response +QISHOWPT: Write Command AT+QISHOWPT= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms MC20&MC30_AT_Commands_Manual 169 / 259 Parameter 0 1 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Do not show the transport protocol type at the end of header of the received TCP/UDP data Show the transport protocol type at the end of header of the received TCP/UDP data as the following format: IPD(data length)(TCP/UDP): NOTE This command is invalid if AT+QIHEAD=0. 11.26. AT+QIMUX Control Whether or Not to Enable Multiple TCP/IP Sessions AT+QIMUX Control Whether or Not to Enable Multiple TCP/IP Sessions Test Command AT+QIMUX=? Response +QIMUX: (list of supported s) Read Command AT+QIMUX? OK Response +QIMUX: Write Command AT+QIMUX= Maximum Response Time Reference Quectel OK Response OK If there is any error, response: ERROR 300ms Parameter 0 1 Do not enable multiple TCP/IP sessions at the same time Enable multiple TCP/IP sessions at the same time MC20&MC30_AT_Commands_Manual 170 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.27. AT+QISHOWLA Control Whether or Not to Display Local IP Address AT+QISHOWLA Control Whether or Not to Display Local IP Address Test Command AT+QISHOWLA=? Response +QISHOWLA: (list of supported s) Read Command AT+QISHOWLA? OK Response +QISHOWLA: Write Command AT+QISHOWLA= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms Parameter A numeric parameter indicates whether or not to show the destination address before receiving data. 0 Do not show the destination address 1 Show the destination address: TO: NOTE Since MC20/MC30 can activate two GPRS contexts at the same time, i.e. MC20/MC30 can get two local IP addresses. It is necessary to point out the destination of the received data when two GPRS contexts have been activated at the same time. MC20&MC30_AT_Commands_Manual 171 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.28. AT+QIFGCNT Select a Context as Foreground Context AT+QIFGCNT Select a Context as Foreground Context Test Command AT+QIFGCNT=? Response +QIFGCNT: (list of supported s) Read Command AT+QIFGCNT? OK Response +QIFGCNT: , Write Command AT+QIFGCNT= OK Response OK Maximum Response Time Reference Quectel If there is any error, response: ERROR 300ms Parameter A numeric indicates which context will be set as foreground context. The range is 0-2 A numeric indicates which channel is controlling the context 0 VIRTUAL_UART_1 1 VIRTUAL_UART_2 2 VIRTUAL_UART_3 3 VIRTUAL_UART_4 255 The context is not controlled by any channel NOTES 1. When CMUX is opened, if the status of the context defined by is not IP_INITIAL and the context is controlled by the other channel, it will return ERROR. 2. =2 is used only for EPO. MC20&MC30_AT_Commands_Manual 172 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.29. AT+QISACK Query the Data Information for Sending AT+QISACK Query the Data Information for Sending Test Command AT+QISACK=? Execution Command AT+QISACK Response OK Response +QISACK: , , Write Command AT+QISACK= OK Response +QISACK: , , Maximum Response Time Reference Quectel OK 300ms Parameter The index for querying the connection A numeric indicates the total length of the data that has been sent through the session A numeric indicates the total length of the data that has been acknowledged by the remote A numeric indicates the total length of the data that has been sent but not acknowledged by the remote NOTES 1. Write command is invalid when AT+QIMUX=0. 2. This command could be affected by the command AT+QISRVC. If AT+QISRVC=1, this command is used to query the information of sending data during the session in which MC20/MC30 serves as a client. If AT+QISRVC=2, this command is used to query the data information for sending during the session in which MC20/MC30 serves as a server. 11.30. AT+QINDI Set the Method to Handle Received TCP/IP Data AT+QINDI Set the Method to Handle Received TCP/IP Data Test Command AT+QINDI=? Response +QINDI: (list of supported s) MC20&MC30_AT_Commands_Manual 173 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Read Command AT+QINDI? Write Command AT+QINDI= Maximum Response Time Reference Quectel OK Response +QINDI: OK Response OK If there is any error, response: ERROR 300ms Parameter A numeric indicates how the mode handles the received data 0 Output the received data through UART directly. In the case, it probably includes header at the beginning of a received data packet. Please refer to the commands AT+QIHEAD, AT+QISHOWRA, AT+QISHOWPT and AT+QISHOWLA 1 Output a notification statement +QIRDI: ,, through UART. This statement will be displayed only one time until all the received data from the connection (defined by ,,) have been retrieved by the command AT+QIRD. 2 Output a notification statement +QIRDI: ,,,,, through UART. This statement will establish a buffer for each socket, the data received will be saved in the buffer until it has been retrieved by the command AT+QIRD, sum lengths of all the buffer is no more than 400K. A numeric points out which context the connection for the received data is based on. Please refer to the parameter in the command AT+QIFGCNT. The range is 0-1. A numeric points out the role of MC20/MC30 in the connection for the received data. 1 The module serves as the client of the connection 2 The module serves as the server of the connection A numeric indicates the index of the connection for the received data. The range is 0-5 When QIMUX was set as 0 by the command AT+QIMUX=0, this parameter will be always 0. The number of packets received in the buffer. The length of the current package in the buffer. The sum of the length of all packages received in the buffer. MC20&MC30_AT_Commands_Manual 174 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. The length of a package cannot exceed 1460 bytes. If it exceeds 1460 bytes, it may be split to two or more packages. 2. The sum of lengths of all packages received cannot exceed 400K bytes. 11.31. AT+QIRD Retrieve the Received TCP/IP Data AT+QIRD Retrieve the Received TCP/IP Data Test Command AT+QIRD=? Response +QIRD: (list of supported s),(list of supported s),(list of supported s),(list of supported s) Write Command AT+QIRD=,,, Maximum Response Time Reference Quectel OK Response [+QIRD: :,,] OK If there is any error, response: ERROR 300ms Parameter A numeric points out which context the connection for the received data is based on. Please refer to the parameter in the command AT+QIFGCNT. The range is 0-1. A numeric points out the role of MC20/MC30 in the connection for the received data 1 The module serves as the client of the connection 2 The module serves as the server of the connection A numeric indicates the index of the connection for the received data. The range is 0-5. When AT+QIMUX=0, this parameter will be always 0. The maximum length of data to be retrieved. The range is 1-1500 The address of the remote end. It is a dotted-decimal IP The port of the remote end An alpha string without quotation marks indicates the transport protocol type TCP the transport protocol is TCP MC20&MC30_AT_Commands_Manual 175 / 259 UDP the transport protocol is UDP The real length of the retrieved data The retrieved data GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. , and are the same as the parameters in the statement +QIRDI: ,,. 2. If it replies only OK for the write command, it means there is no received data in the buffer of the connection. 11.32. AT+QISDE Control Whether or Not to Echo the Data for QISEND AT+QISDE Control Whether or Not to Echo the Data for QISEND Test Command AT+QISDE=? Response +QISDE: (list of supported s) Read Command AT+QISDE? OK Response +QISDE: Write Command AT+QISDE= Maximum Response Time Reference Quectel OK Response OK If there is any error, response: ERROR 300ms Parameter A numeric indicates whether or not to echo the data for AT+QISEND 0 Do not echo the data 1 Echo the data MC20&MC30_AT_Commands_Manual 176 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 11.33. AT+QPING Ping a Remote Server AT+QPING Ping a Remote Server Test Command AT+QPING=? Response +QPING: 'HOST',(list of supported s),(list of supported s) Write Command AT+QPING=''[,[][,]] OK Response OK [+QPING: [,,,,] …] +QPING:[,,,,,, ] Maximum Response Time Reference Quectel If there is any error, response: ERROR Depends on . Parameter The host address in string style. It could be a domain name or a dotted decimal IP address A numeric gives the maximum time to wait for the response of each ping request. Unit: second. Range: 1-255. Default: 1 A numeric indicates the maximum time of ping request. Range: 1-10. Default: 4 The result of each ping request 0 Received the ping response from the server. In the case, it is followed by ',,,,' 1 Timeout for the ping request. In the case, no other information follows it The IP address of the remote server. It is a dotted decimal IP The length of sending each ping request The time expended to wait for the response for the ping request. Unit: ms The value of time to live of the response packet for the ping request The final result of the command 2 It is finished normally. It is successful to activate GPRS and find the host. In the case, it is followed by ',,,,,,' 3 The TCP/IP stack is busy now. In the case, no other information follows it 4 Do NOT find the host. In the case, no other information follows it MC20&MC30_AT_Commands_Manual 177 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 5 Failed to activate PDP context. In the case, no other information follows it Total number of sending the ping requests Total number of the ping requests that received the response Total number of the ping requests that were timeout The minimum response time. Unit: ms The maximum response time. Unit: ms The average response time. Unit: ms 11.34. AT+QNTP Synchronize the Local Time via NTP AT+QNTP Synchronize the Local Time Via NTP Test Command AT+QNTP=? Response +QNTP: 'SERVER',(list of supported s) Read Command AT+QNTP? OK Response +QNTP: '', Execution Command AT+QNTP Write Command AT+QNTP=''[,] Maximum Response Time Reference Quectel OK Response OK +QNTP: Response OK +QNTP: If there is any error, response: ERROR 120s, determined by network. Parameter The address of the Time Server in string style. It could be a domain name or a dotted decimal IP address The port of the Time Server The result of time synchronization MC20&MC30_AT_Commands_Manual 178 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 0 Successfully synchronize the local time 1 Failed to synchronize the local time because of unknown reason 2 Failed to receive the response from the Time Server 3 The TCP/IP stack is busy now 4 Do Not find the Time Server 5 Failed to activate PDP context NOTE The factory Time Server is the National Time Service Centre of China whose address is '210.72.145.44' and the port is 123. 11.35. AT+QIKALIVE Set TCP/IP Keep Alive Parameter AT+QIKALIVE Set TCP/IP Keep Alive Parameter Test Command AT+QIKALIVE=? Response +QIKALIVE: (list of supported s)[,(list of supported s),(list of supported s)] Read Command AT+QIKALIVE? OK Response +QIKALIVE: ,, Write Command AT+QIKALIVE=[,,] Maximum Response Time Reference Quectel OK Response OK If there is any error: ERROR 300ms Parameter 0 Enable the function 1 Disable the function The interval between heartbeat packets sent. 10 The range is 10-1800 seconds, and the default value is 10 seconds If the heartbeat package sending failed, the package will be sent again. MC20&MC30_AT_Commands_Manual 179 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 10 The range is 10-20 seconds, and the default value is 10 seconds NOTE The setting cannot be saved after reset. MC20&MC30_AT_Commands_Manual 180 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 12 Supplementary Service Commands 12.1. AT+CCFC Call Forwarding Number and Conditions Control AT+CCFC Call Forwarding Number and Conditions Control Test Command AT+CCFC=? Response +CCFC: (list of supported s) Write Command AT+CCFC=,[,[,[,[,[,[,time]]]]]] OK Response TA controls the call forwarding supplementary service. Registration, erasure, activation, deactivation, and status query are supported. Only and should be entered with mode (02,4) If 2 and the command is executed successfully, response: OK If =2 and the command is executed successfully (only in connection with 0-3): For registered call forwarding numbers: +CCFC: ,[,,[,,[,]]] [+CCFC: ....] OK If no call forwarding numbers are registered (and therefore all classes are inactive): +CCFC: , OK where =0 and =15 MC20&MC30_AT_Commands_Manual 181 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All call forwarding (0-3) 5 All conditional call forwarding (1-3) 0 Disable 1 Enable 2 Query status 3 Registration 4 Erasure Phone number in string type of forwarding address in format specified by Type of address in integer format; default value is 145 when dialing string includes international access code character '+', otherwise 129 String type sub-address of format specified by Type of sub-address octet in integer format (refer to GSM 04.08 subclause 10.5.4.8) 1 Voice 2 Data 4 Fax 7 All telephony except SMS 8 Short message service 16 Data circuit sync 32 Data circuit async 1…30 When 'no reply' (=no reply) is enabled or queried, this gives the time in seconds to wait before call is forwarded, default value is 20 0 Not active 1 Active Example AT+CCFC=0,3,'15021012496' OK AT+CCFC=0,2 +CCFC: 1,1,'+8615021012496',145 //Register the destination number for unconditional call forwarding (CFU) //Query the status of CFU without specifying MC20&MC30_AT_Commands_Manual 182 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual +CCFC: 1,4,'+8615021012496',145 +CCFC: 1,32,'+8615021012496',145 +CCFC: 1,16,'+8615021012496',145 OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0,7 OK //Erase the registered CFU destination number //Query the status, no destination number 12.2. AT+CCUG Closed User Group Control AT+CCUG Closed User Group Control Test Command AT+CCUG=? Read Command AT+CCUG? Response OK Response +CCUG: ,, Write Command AT+CCUG=[][,[,]] OK Response TA sets the closed user group supplementary service parameters as a default adjustment for all following calls. OK Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 Disable CUG 1 Enable CUG 0...9 CUG index 10 No index (preferred CUG taken from subscriber data) 0 Bo information MC20&MC30_AT_Commands_Manual 183 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 1 Suppress OA (Outgoing Access) 2 Suppress preferential CUG 3 Suppress OA and preferential CUG 12.3. AT+CCWA Call Waiting Control AT+CCWA Call Waiting Control Test Command AT+CCWA=? Response +CCWA: (list of supported s) Read Command AT+CCWA? OK Response +CCWA: Write Command AT+CCWA=[][,[,]] OK Response TA controls the call waiting supplementary service. Activation, deactivation and status query are supported. If 2 and the command is executed successfully: OK If =2 and the command is executed successfully: +CCWA: ,[+CCWA:, [...]] Maximum Response Time Reference GSM 07.07 OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 Disable presentation of an unsolicited result code 1 Enable presentation of an unsolicited result code When parameter is not given, network is not interrogated 0 Disable 1 Enable MC20&MC30_AT_Commands_Manual 184 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2 Query status A sum of integers, each integer represents a class of information 1 Voice (telephony) 2 Data (bearer service) 4 Fax (facsimile) 16 Data circuit sync 32 Data circuit async 0 Disable 1 Enable NOTES 1. =0 should be returned only if service is not active for any i.e. +CCWA: 0, 7 will be returned in this case. 2. When =2, all active call waiting classes will be reported. In this mode the command is available by pressing any key. 3. Unsolicited result code When the presentation call waiting at the TA is enabled (and call waiting is enabled) and a terminating call set up during an established call, an unsolicited result code is returned: +CCWA: ,,[,] Parameters Phone number in string type of calling address in format specified by Type of address octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format) Optional string type alphanumeric representation of corresponding to the entry found in phone book Example AT+CCWA=1,1 OK ATD10086; OK +CCWA: '02154450293',129,1 //Enable presentation of an unsolicited result code //Establish a call //Indication of a call that has been waiting 12.4. AT+CHLD Call Hold and Multiparty AT+CHLD Call Hold and Multiparty Test Command Response MC20&MC30_AT_Commands_Manual 185 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+CHLD=? Write Command AT+CHLD=[] Maximum Response Time Reference GSM 07.07 +CHLD: (list of supported s) OK Response TA controls the supplementary services call hold, multiparty and explicit call transfer. Calls can be put on hold, recovered, released, added to conversation and transferred. OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 1X 2 2X 3 Terminate all held calls or UDUB (User Determined User Busy) for a waiting call. If a call is waiting, terminate the waiting call. Otherwise, terminate all held calls (if any) Terminate all active calls (if any) and accept the other call (waiting call or held call). It cannot terminate active call if there is only one call Terminate the specific call number X (X=1-7)(active, waiting or held) Place all active calls on hold (if any) and accept the other call (waiting call or held call) as the active call Place all active calls except call X (X=1-7) on hold Add the held call to the active calls NOTE These supplementary services are only available to the teleservice 11 (Speech: Telephony). Example ATD10086; OK +CCWA: '02154450293',129,1 AT+CHLD=2 OK AT+CLCC //Establish a call //Indication of a call that has been waiting //Place the active call on hold and accept the waiting call as the active call MC20&MC30_AT_Commands_Manual 186 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual +CLCC: 1,0,1,0,0,'10086',129,'' //The first call on hold +CLCC: 2,1,0,0,0,'02154450293',129,'' //The second call becomes active OK AT+CHLD=21 OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' //Place the active call except call X=1 on hold //The first call becomes active +CLCC: 2,1,1,0,1,'02154450293',129,'' //The second call on hold OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129,'' //Add a held call to the active calls in order to set up a conference (multiparty) call +CLCC: 2,1,0,0,1,'02154450293',129,'' OK 12.5. AT+CLIP Calling Line Identification Presentation AT+CLIP Calling Line Identification Presentation Test Command AT+CLIP=? Response +CLIP: (list of supported s) Read Command AT+CLIP? OK Response +CLIP: , Write Command AT+CLIP=[] OK Response TA enables or disables the presentation of the calling line identity (CLI) at the TE. It has no effect on the execution of the supplementary service CLIP in the network. OK If there is any error related to ME functionality: +CME ERROR: MC20&MC30_AT_Commands_Manual 187 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.07 15s, determined by network. Parameter 0 1 0 1 2 Suppress unsolicited result codes Display unsolicited result codes CLIP not provisioned CLIP provisioned Unknown NOTE Unsolicited result code When the presentation of the CLI at the TE is enabled (and calling subscriber allows), an unsolicited result code is returned after every RING (or +CRING: ) at a mobile terminating call. +CLIP: ,,'[]',[],'[]', Parameters Phone number in string type of calling address in format specified by Type of address octet in integer format; 129 Unknown type (IDSN format number) 145 International number type (ISDN format) String type sub-address of format specified by Type of sub-address octet in integer format (refer to GSM 04.08 [8] subclause 10.5.4.8) String type alphanumeric representation of corresponding to the entry found in phone book 0 CLI valid 1 CLI has been withheld by the originator 2 CLI is not available due to interworking problems or limitations of originating network Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING +CLIP: '02151082965',129,'',,'',0 MC20&MC30_AT_Commands_Manual 188 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 12.6. AT+QCLIP Control Whether or Not to Show the Name of Incoming Call Number AT+QCLIP Control Whether or Not to Show the Name of Incoming Call Number Test Command AT+QCLIP=? Response +QCLIP: (list of supported s) Read Command AT+QCLIP? OK Response +QCLIP: Write Command AT+QCLIP= OK Response OK Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Enable or disable the function of show the name of incoming call number 0 Enable 1 Disable NOTE This AT command should be used in conjunction with CLIP command. Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+QCLIP=1 OK AT+CLIP=1 OK MC20&MC30_AT_Commands_Manual 189 / 259 RING +CLIP: '02151082965',129,'',,'QUECTEL',0 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 12.7. AT+CLIR Calling Line Identification Restriction AT+CLIR Calling Line Identification Restriction Test Command AT+CLIR=? Response +CLIR: (list of supported s) Read Command AT+CLIR? OK Response +CLIR: , Write Command AT+CLIR=[] Maximum Response Time Reference GSM 07.07 OK Response TA restricts or enables the presentation of the calling line identity (CLI) to the called party when originating a call. The command overrides the CLIR subscription (default is restricted or allowed) when temporary mode is provisioned as a default adjustment for all following outgoing calls. This adjustment can be revoked by using the opposite Command. OK If there is any error related to ME functionality: +CME ERROR: 15s, determined by network Parameter (Parameter sets the adjustment for outgoing calls) 0 Presentation indicator is used according to the subscription of the CLIR service 1 CLIR invocation 2 CLIR suppression (Parameter shows the subscriber CLIR service status in the network) 0 CLIR not provisioned 1 CLIR provisioned in permanent mode 2 Unknown (e.g. no network, etc.) 3 CLIR temporary mode presentation restricted MC20&MC30_AT_Commands_Manual 190 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 4 CLIR temporary mode presentation allowed 12.8. AT+COLP Connected Line Identification Presentation AT+COLP Connected Line Identification Presentation Test Command AT+COLP=? Response +COLP: (list of supported s) Read Command AT+COLP? OK Response +COLP: , Write Command AT+COLP=[] Maximum Response Time Reference GSM 07.07 OK Response TA enables or disables the presentation of the COL (Connected Line) at the TE for a mobile originating a call. It has no effect on the execution of the supplementary service COLR in the network. Intermediate result code is returned from TA to TE before any +CR or V.25ter responses. OK 15s, determined by network. Parameter (Parameter sets/shows the result code presentation status in the TA) 0 Disable 1 Enable (Parameter shows the subscriber COLP service status in the network) 0 COLP not provisioned 1 COLP provisioned 2 Unknown (e.g. no network, etc.) MC20&MC30_AT_Commands_Manual 191 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTE Intermediate result code When enabled (and called subscriber allows), an intermediate result code is returned before any +CR or V.25ter responses: +COLP: ,[,,[,]] Parameters Phone number in string type, format specified by Type of address octet in integer format 129 Unknown type (IDSN format number) 145 International number type (ISDN format) String type sub-address of format specified by Type of sub-address octet in integer format (refer to GSM 04.08 subclause 10.5.4.8) Optional string type alphanumeric representation of corresponding to the entry found in phone book Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,'',0,'' OK 12.9. AT+QCOLP Show Alpha Field in +COLP String AT+QCOLP Show Alpha Field in +COLP String Test Command AT+QCOLP=? Response +QCOLP: (list of supported s) Read Command AT+QCOLP? OK Response +QCOLP: Write Command AT+QCOLP= OK Response OK MC20&MC30_AT_Commands_Manual 192 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Whether or not to show alpha field in +COLP string 0 NOT show alpha field in +COLP string 1 Show alpha field in +COLP string NOTE This command setting only works under AT+COLP=1. Example AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+QCOLP=1 OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,'',0,'QUECTEL' OK 12.10. AT+CUSD Unstructured Supplementary Service Data AT+CUSD Unstructured Supplementary Service Data Test Command AT+CUSD=? Response +CUSD: (list of supported s) Read Command AT+CUSD? OK Response +CUSD: MC20&MC30_AT_Commands_Manual 193 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+CUSD=[[,[,]] Maximum Response Time Reference GSM 07.07 OK Response OK If there is any error related to ME functionality: +CME ERROR: 120s, determined by network. Parameter A numeric parameter which indicates control of the unstructured supplementary service data 0 Disable the result code presentation in the TA 1 Enable the result code presentation in the TA 2 Cancel session (not applicable to read command response) String type USSD-string Cell Broadcast Data Coding Scheme in integer format (default 0) Example AT+CSCS='UCS2' OK AT+CUSD=1,'002A0031003000300023' +CUSD: 1,'0031002E59296C14000A0032002E65B095FB000A0033002E8BC15238000A0034002E5F 697968000A0035002E751F6D3B000A0036002E5A314E50000A0037002E5E385DDE98CE91C7000A 002A002E900051FA000A',72 OK 12.11. AT+CSSN Supplementary Services Notification AT+CSSN Supplementary Services Notification Test Command AT+CSSN=? Response +CSSN: (list of supported s),(list of supported s) Read Command AT+CSSN? OK Response +CSSN: , MC20&MC30_AT_Commands_Manual 194 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+CSSN=[[,]] Maximum Response Time Reference GSM 07.07 OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter A numeric parameter which indicates whether to show the +CSSI: [,] result code presentation status after a mobile originated call setup 0 Disable 1 Enable A numeric parameter which indicates whether to show the +CSSU: result code presentation status during a mobile terminated call setup or during a call, or when a forward check supplementary service notification is received 0 Disable 1 Enable 0 Unconditional call forwarding is active 1 Some of the conditional call forwarding are active 2 Call has been forwarded 3 Call is waiting 4 This is a CUG call (also present) 5 Outgoing calls are barred 6 Incoming calls are barred 7 CLIR suppression rejected Closed user group index 0 This is a forwarded call MC20&MC30_AT_Commands_Manual 195 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 13 Audio Commands 13.1. ATL Set Monitor Speaker Loudness ATL Set Monitor Speaker Loudness Execution Command ATL Response OK Maximum Response Time 300ms Reference V.25ter Parameter 0 1 2 3 Low speaker volume Low speaker volume Medium speaker volume High speaker volume NOTE The two commands ATL and ATM are implemented only for V.25 compatibility reasons and have no effect. 13.2. ATM Set Monitor Speaker Mode ATM Set Monitor Speaker Mode Execution Command ATM Response OK Maximum Response Time 300ms Reference V.25ter MC20&MC30_AT_Commands_Manual 196 / 259 Parameter 0 1 2 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Speaker is always off Speaker is on until TA informs TE that the carrier has been detected Speaker is always on when TA is off-hook NOTE The two commands ATL and ATM are implemented only for V.25 compatibility reasons and have no effect. 13.3. AT+VTD Tone Duration AT+VTD Tone Duration Test Command AT+VTD=? Response +VTD: (list of supported s)[,(list of supported s)] Read Command AT+VTD? OK Response +VTD: , Write Command AT+VTD=[,] OK Response This command refers to an integer that defines the length of tones emitted as a result of the +VTS command. This does not affect the D command. OK Maximum Response Time 300ms Reference GSM 07.07 Parameter 1-255 0 1-100000 Duration between two tones. Unit: 100ms Do not set duration of every single tone. Duration of every single tone. Unit: 1ms MC20&MC30_AT_Commands_Manual 197 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 13.4. AT+VTS DTMF and Tone Generation AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (list of supported s),(list of supported s) Write Command AT+VTS= Maximum Response Time Reference GSM 07.07 OK Response This command allows the transmission of DTMF tones and arbitrary tones in voice mode. These tones may be used (for example) when announcing the start of a recording period. OK If there is any error related to ME functionality: +CME ERROR: Depends on the length of . Parameter It has a max length of 20 characters, must be entered between double quotes (' ') and consists of combinations of the following separated by commas. But a single character does not require quotes 1) A single ASCII characters in the set 0-9, #, *, A-D. This is interpreted as a sequence of DTMF tones whose duration is set by the AT+VTD command 2) {,} This is interpreted as a DTMF tone whose duration is determined by Duration of the tone, unit: 100ms, range: 1-255 Example ATD10086; OK AT+VTS=1 OK //Establish a call //Send a single DTMF tone according to the prompts of voice MC20&MC30_AT_Commands_Manual 198 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 13.5. AT+CALM Alert Sound Mode AT+CALM Alert Sound Mode Test Command AT+CALM=? Read Command AT+CALM? Write Command AT+CALM= Maximum Response Time Reference GSM 07.07 Response +CALM: (list of supported s) OK Response +CALM: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 Normal mode Silent mode (all sounds from ME are prevented) 13.6. AT+CRSL Ringer Sound Level AT+CRSL Ringer Sound Level Test Command AT+CRSL=? Response +CRSL: (list of supported s) Read Command AT+CRSL? OK Response +CRSL: Write Command AT+CRSL= OK Response OK MC20&MC30_AT_Commands_Manual 199 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Integer type value (0-100) with manufacturer specific range (smallest value represents the lowest sound level). 13.7. AT+CLVL Loud Speaker Volume Level AT+CLVL Loud Speaker Volume Level Test Command AT+CLVL=? Response +CLVL: (list of supported s) Read Command AT+CLVL? OK Response +CLVL: Write Command AT+CLVL= OK Response OK Maximum Response Time Reference GSM 07.07 If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Integer type value (0-100) with manufacturer specific range (smallest value represents the lowest sound level). The default values are 60, 40 and 35 for each channel. MC20&MC30_AT_Commands_Manual 200 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 13.8. AT+CMUT Mute Control AT+CMUT Mute Control Test Command AT+CMUT=? Read Command AT+CMUT? Write Command AT+CMUT= Maximum Response Time Reference GSM 07.07 Response +CMUT: (list of supported s) OK Response +CMUT: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 Mute off Mute on NOTE This command is to mute the uplink. 13.9. AT+QSIDET Change the Side Tone Gain Level AT+QSIDET Change the Side Tone Gain Level Test Command AT+QSIDET=? Response +QSIDET: (list of supported s) Read Command AT+QSIDET? OK Response (1) If AT+QAUDCH=0: MC20&MC30_AT_Commands_Manual 201 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+QSIDET= Maximum Response Time Reference Quectel +QSIDET(NORMAL_AUDIO): OK (2) If AT+QAUDCH=1: +QSIDET(HEADSET_AUDIO): OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Range is 0-255. Default value is 80. NOTE value is related to specific channel. 13.10. AT+QMIC Change the Microphone Gain Level AT+QMIC Change the Microphone Gain Level Test Command AT+QMIC=? Response +QMIC: (list of supported s）, (list of supported s) Read Command AT+QMIC? OK Response +QMIC: ,, Write Command OK Response MC20&MC30_AT_Commands_Manual 202 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+QMIC=, Maximum Response Time Reference Quectel OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 Normal microphone 1 Headset microphone 2 Loudspeaker microphone Range is 0-15. The default values are 4, 9, and 8 for each channel. 13.11. AT+QLDTMF Generate Local DTMF Tones AT+QLDTMF Generate Local DTMF Tones Test Command AT+QLDTMF=? Response +QLDTMF: (list of supported s ） ,(list of supported s) Write Command AT+QLDTMF=[,] Execution Command AT+QLDTMF Maximum Response Time Reference Quectel OK Response OK If there is any error related to ME functionality: +CME ERROR: Response OK Depends on the length of . Parameter A numeric parameter (1-1000) which indicates the duration of all DTMF tones in in 1/10 seconds A string parameter which has a max length of 20 DTMF characters (single ASCII chars MC20&MC30_AT_Commands_Manual 203 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual in the set 0-9, #, *, A-D), separated by commas NOTE Aborts any DTMF tones that are generated currently and any DTMF tones sequence. 13.12. AT+QAUDCH Swap the Audio Channels AT+QAUDCH Swap the Audio Channels Test Command AT+QAUDCH=? Response +QAUDCH: (list of supported s) Read Command AT+QAUDCH? OK Response +QAUDCH: Write Command AT+QAUDCH=[] Maximum Response Time Reference Quectel OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 2 Normal audio channel (default) Headset audio channel Loudspeaker audio 13.13. AT+QAUDLOOP Audio Channel Loop Back Test AT+QAUDLOOP Audio Channel Loop Back Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (list of supported s),(list of supported MC20&MC30_AT_Commands_Manual 204 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+QAUDLOOP=[,] Maximum Response Time Reference Quectel s) OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 0 1 2 Test is off Test is on Normal audio channel Headset audio channel Loudspeaker audio channel 13.14. AT+QLTONE Generate Local Specific Tone AT+QLTONE Generate Local Specific Tone Test Command AT+QLTONE=? Response +QLTONE: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Write Command AT+QLTONE=,,< periodOn>,, Maximum Response Time Reference Quectel OK Response OK If there is any error related to ME functionality: +CME ERROR: Depends on the content of the play. MC20&MC30_AT_Commands_Manual 205 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 0 Stop playing tone 1 Start playing tone The frequency of tone to be generated The period of generating tone The period of stopping tone Duration of tones in milliseconds NOTE When playing the tone of a specified frequency, the module will continuously play for , and then stop playing for in a cycle. The total time of cycles is . 13.15. AT+QTONEP Set DTMF Output Path AT+QTONEP Set DTMF Output Path Test Command AT+QTONEP=? Response +QTONEP: (list of supported s) Read Command AT+QTONEP? OK Response +QTONEP: Write Command AT+QTONEP= OK Response OK Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Output path 0 Output DTMF or tone from Normal speaker 1 Output DTMF or tone from Headset speaker 2 Output DTMF or tone from Loud speaker MC20&MC30_AT_Commands_Manual 206 / 259 3 Auto GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTE Set AT+QTONEP=3, output DTMF or tone from default speak path. For more details, consult AT+QAUDCH. 13.16. AT+QTDMOD Set Tone Detection Mode AT+QTDMOD Set Tone Detection Mode Test Command AT+QTDMOD=? Response +QTDMOD: (list of supported s),(list of supported s) Read Command AT+QTDMOD? OK Response +QTDMOD: , Write Command AT+QTDMOD=, OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference Quectel Parameter Operate function 1 Set detection range 2 Set detection mode Function status 0 When set =1, detect all DTMF, including 1400Hz and 2300Hz handshake signal. When set =2, detect DTMF tone by normal arithmetic 1 When set =1, only detect 1400Hz and 2300Hz handshake signal by using optimal arithmetic. When set =2, detect long MC20&MC30_AT_Commands_Manual 207 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual continuous DTMF tone by using optimal arithmetic 2 When set =1, not detected 1400Hz and 2300Hz handshake signal. NOTES 1. Set AT+QTDMOD=1,0, detect all DTMF, including 1400Hz and 2300Hz handshake signal. 2. Set AT+QTDMOD=1,1, only detect 1400Hz and 2300Hz handshake signal by using optimal arithmetic. 3. Set AT+QTDMOD=1,2, detect all DTMF, not including 1400Hz and 2300Hz handshake signal. 4. Set AT+QTDMOD=2,0, detect DTMF tone by using normal arithmetic. 5. Set AT+QTDMOD=2,1, detect long continuous DTMF tone by using optimal arithmetic. 6. Consult AT+QTONEDET. 13.17. AT+QTONEDET Detect DTMF AT+QTONEDET Detect DTMF Test Command AT+QTONEDET=? Response +QTONEDET: (list of supported s) Read Command AT+QTONEDET? OK Response +QTONEDET: Write Command AT+QTONEDET=[,][ ,][,][,] OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time Reference Quectel Open after successful DTMF tone is detected, report: +QTONEDET: [,< persistencetime>] 300ms Parameter Mode function 0 Close tone detection MC20&MC30_AT_Commands_Manual 208 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 1 Open tone detection 2 Configure 1400Hz or 2300Hz detection threshold, duration of which is 100ms 3 Configure 1400Hz and 2300Hz 400ms detection threshold 4 Configure DTMF detection threshold 5 Open debug Operate value When =2, is set as follows 0 Query threshold values; these values are 1400Hz and 2300Hz detection threshold, each duration of which is 100ms 1 Set threshold values; these values are 1400Hz and 2300Hz 100ms detection threshold When =3, is set as follows 0 Query threshold values; these values are 1400Hz and 2300Hz 400ms detect threshold 1 Set threshold values; these values are 1400Hz and 2300Hz 400ms detect threshold. When =4, is set as follows 0 Query threshold values; these values are detection threshold 1 Set threshold values; these values are DTMF detection threshold When =5, is set as follows 0 Working status, default value, report +QTONEDET: x,x, please refer to Note3 1 Debug status, only report +QTONEDTD:x,x,… debug information (refer to Note 2) 2 Debug status and working status, report +QTONEDTD: x,x,… debug information (refer to Note 2) and +QTONEDET:x,x, please refer to Note 4 Prefix pause number Low threshold value High threshold value DTMF tone code corresponding ASSCII 48 DTMF 0 49 DTMF 1 50 DTMF 2 51 DTMF 3 52 DTMF 4 53 DTMF 5 54 DTMF 6 55 DTMF 7 56 DTMF 8 57 DTMF 9 65 DTMF A 66 DTMF B 67 DTMF C 68 DTMF D 42 DTMF * MC20&MC30_AT_Commands_Manual 209 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 35 69 70 100 400 DTMF # 1400Hz frequency 2300Hz frequency 100ms of the tone is detected, only 1400Hz and 2300 Hz 400ms of the tone is detected, only 1400Hz and 2300 Hz NOTES 1. Available during voice call. 2. If the duration of DTMF tone is within the value range of low and high threshold value, it is effective. Unit: 20ms. 3. When in debug mode, report +QTONEDTD: ,,,, ,,. 4. When report as follows: +QTONEDET: 50 Detected DTMF 2 +QTONEDET: 69,100 Detected 100ms of 1400Hz +QTONEDET: 70,100 Detected 100ms of 2300Hz +QTONEDET: 69,400 Detected 400ms of 1400Hz +QTONEDET: 70,400 Detected 400ms of 2300Hz 5. Consult AT+QTDMOD. 13.18. AT+QWDTMF Play DTMF Tone During the Call AT+QWDTMF Play DTMF Tone During the Call Test Command AT+QWDTMF=? Response +QWDTMF: (list of supported s),(list of supported s),(',,'),(list of supported s),(list of supported s) Write Command AT+QWDTMF=,,(',,')[,][, ] OK Response If success is related to ME functionality: +QWDTMF: 5 OK If fail is related to ME functionality: +QWDTMF: MC20&MC30_AT_Commands_Manual 210 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Maximum Response Time Reference Quectel OK If there is any error related to ME functionality: +CME ERROR: Depends on the content of the play. Parameter 0-7, uplink channel of the volume 0-7, downlink channel of the volume, recommended to be set as 0 The DTMF tone strings ‘0’ DTMF 0 ‘1’ DTMF 1 ‘2’ DTMF 2 ‘3’ DTMF 3 ‘4’ DTMF 4 ‘5’ DTMF 5 ‘6’ DTMF 6 ‘7’ DTMF 7 ‘8’ DTMF 8 ‘9’ DTMF 9 ‘A’ DTMF A ‘B’ DTMF B ‘C’ DTMF C ‘D’ DTMF D ‘*’ DTMF * ‘#’ DTMF # ‘E’ Frequency of 1400Hz ‘F’ Frequency of 2300Hz ‘G’ Frequency of 1KHz Duration of each DTMF tone. Unit: ms Mute time. Unit: ms 0 Normal audio channel 1 Headset audio channel 2 Loudspeaker audio 0 Algorithm 1 (Default) 1 Algorithm 2 Indicate status of sending DTMF If is 5, it means sending DTMF successfully If is not 5, it means sending DTMF unsuccessfully MC20&MC30_AT_Commands_Manual 211 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. AT+QWDTMF=7,0,'0A5,50,50,1,55,50,23,100,50' Send DTMF ‘0’ for 50ms, mute 50ms; send DTMF ‘A’ for 50ms, mute 50ms; send DTMF ‘5’ for 50ms, mute 50ms; send DTMF ‘1’ for 55ms, mute 50ms; send DTMF ‘2’ for 100ms, mute 50ms; send DTMF ‘3’ for 100ms, mute 50ms. 2. is available for non-call. 13.19. AT+QPCMON Configure PCM Interface AT+QPCMON Configure PCM Interface Test Command AT+QPCMON=? Read Command AT+QPCMON? Response OK Response +QPCMON: ,,,, Write Command AT+QPCMON=,, , , OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time Reference Quectel Parameter PCM operate mode 0 Close PCM interface 1 PCM interface always ON 2 PCM interface ON while in call 3 Get PCM running status (0: IDLE; 1: RUNNING) Select long/short frame 0 Short frame 1 Long frame Length of synchronous frame Range: 1~8 Sign bit extension MC20&MC30_AT_Commands_Manual 212 / 259 0 Disable sign bit extension 1 Enable sign bit extension Most significant bit first 0 MSB first 1 LSB first GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTE If set as 1, AT+QPCMVOL setting will be invalid. 13.20. AT+QPCMVOL Set/Get PCM Input/Output Volume AT+QPCMVOL Set/Get PCM Input/Output Volume Test Command AT+QPCMVOL=? Response +QPCMVOL: (0-32767),(0-3 2767) Read Command AT+QPCMVOL? OK Response +QPCMVOL: , Write Command AT+QPCMVOL=, OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time Reference Quectel Parameter PCM input volume. The range is 0~32767. PCM output volume. The range is 0~32767. MC20&MC30_AT_Commands_Manual 213 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 14 Hardware Related Commands 14.1. AT+CCLK Clock AT+CCLK Clock Test Command AT+CCLK=? Read Command AT+CCLK? Write Command AT+CCLK= Maximum Response Time Reference GSM 07.07 Response OK Response +CCLK: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter String type value; format is 'yy/MM/dd,hh:mm:ss±zz', where characters indicate year (two last digits),month, day, hour, minutes, seconds and time zone (indicates the difference, expressed in quarters of an hour, between the local time and GMT; range -47...+48). E.g. May 6th, 1994, 22:10:00 GMT+2 hours equals to '94/05/06,22:10:00+08' Example AT+CCLK? +CCLK: '08/01/04, 00:19:43+00' OK //Query the local time MC20&MC30_AT_Commands_Manual 214 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 14.2. AT+QALARM Set Alarm AT+QALARM Set Alarm Test Command AT+QALARM=? Response +QALARM: (list of supported s),,(list of supported s),(list of supported s) Write Command AT+QALARM=,,, OK Response OK If there is any error, response: ERROR Or +CME ERROR: Maximum Response Time 300ms Reference Quectel Parameter An integer parameter which indicates whether or not to enable alarm 0 Clear alarm 1 Set alarm A string parameter which indicates the time when an alarm arises. The format is 'yy/MM/dd,hh:mm:ss±zz' where characters indicate the last two digits of year, month, day, hour, minute, second and time zone. The time zone is expressed in quarters of an hour between the local time and GMT, ranging from -47 to +48 An integer parameter which indicates the repeat mode 0 None 1 Daily 2 Weekly 3 Monthly An integer parameter which indicates the method of controlling power when alarm arises 0 None. Only send 'ALARM RING' to serial port 1 Alarm power off. Send 'ALARM RING' to serial port and power off in 5 seconds 2 Alarm power on. Send 'ALARM MODE' to serial port and enter into alarm mode MC20&MC30_AT_Commands_Manual 215 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTE In alarm mode, protocol stack and (U)SIM protocol are closed, only a few AT commands can be executed, and system will be powered down after 90 seconds, if neither power key is pressed nor functionality is changed to full functionality. If power key is pressed, system will be powered down immediately. 14.3. AT+CBC Battery Charge AT+CBC Battery Charge Test Command AT+CBC=? Execution Command AT+CBC Response +CBC: (list of supported s),(list of supported s),(voltage) OK Response +CBC: ,, Maximum Response Time Reference GSM 07.07 OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Battery charge status 0 ME is not charging 1 ME is charging 2 Charging has finished Battery charge level 0...100 Battery has 0-100 percent of capacity remaining vent Battery voltage (mV) NOTE As MC20/MC30 does not support battery charge, and are invalid while the still represents the correct voltage of VBATT. MC20&MC30_AT_Commands_Manual 216 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 14.4. AT+QADC Read ADC AT+QADC Read ADC Test Command AT+QADC=? Execution Command AT+QADC? Response +QADC: (list of supported s),(list of supported s) OK Response +QADC: , Maximum Response Time Reference Quectel OK 300ms Parameter Status 0 Fail 1 Success 0-2800 Voltage 14.5. AT+QSCLK Configure Slow Clock AT+QSCLK Configure Slow Clock Test Command AT+QSCLK=? Response +QSCLK: (list of supported s) Read Command AT+QSCLK? OK Response +QSCLK: Write Command AT+QSCLK= Maximum Response Time Reference OK Response OK 300ms MC20&MC30_AT_Commands_Manual 217 / 259 Quectel GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter 0 1 2 Disable slow clock Enable slow clock, and it is controlled by DTR When there is no data on serial port in 5 seconds, module will enter into sleep mode. Otherwise, it will exit from sleep mode. NOTE In mode 2, the first UART data that the module received in sleep mode will be discarded as it is used to wake up the module. It’s suggested to send an extra AT command to wake up the module first, and then continue to send other commands. 14.6. AT+QLEDMODE Configure the Network Indication LED Patterns AT+QLEDMODE Configure the Network Indication LED Patterns Test Command AT+QLEDMODE=? Response +QLEDMODE: (list of supported s) Read Command AT+QLEDMODE? OK Response +QLEDMODE: Write Command AT+QLEDMODE= Maximum Response Time Reference Quectel OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter 0 1 Network Indication LED flashes rapidly when a call is ringing No effect on the Network Indication LED when a call is ringing MC20&MC30_AT_Commands_Manual 218 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2 No effect on the Network Indication LED when a call is ringing, and RI will not change when URC reported until the ringing ends NOTE Please restart the module after the command is set. 14.7. AT+QVBATT Configure the Threshold of Voltage AT+QVBATT Configure the Threshold of Voltage Test Command AT+QVBATT=? Response +QVBATT: 0,(3451-3600),(0,1) +QVBATT: 1,(3100-3450),(0,1) +QVBATT: 2,(4300-4550),(0,1) +QVBATT: 3,(4551-4730),(0,1) Read Command AT+QVBATT? OK Response +QVBATT: 0,, +QVBATT: 1,, +QVBATT: 2,, +QVBATT: 3,, Write Command AT+QVBATT=[,[,]] OK Response If format is right, response: OK Else if is omitted and is legal, this command is used to query the value of the corresponding parameter, and response: +QVBATT: ,, OK Maximum Response Time Reference Quectel If there is any error related to ME functionality: +CME ERROR: 300ms MC20&MC30_AT_Commands_Manual 219 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Parameter Type of configuring voltage threshold. 0 The threshold of low voltage warning 1 The threshold of low voltage power down 2 The threshold of high voltage warning 3 The threshold of high voltage power down Voltage threshold. Unit: mV The corresponding function of parameter is enabled/disabled. The default low voltage warning and low voltage power down function is enabled. The default high voltage warning and high voltage power down function is disabled 0 The function is disabled 1 The function is enabled NOTES 1. When the battery voltage reaches the setting threshold, reported the URC as follows: UNDER_VOLTAGE WARNING UNDER_VOLTAGE POWER DOWN OVER_VOLTAGE WARNING OVER_VOLTAGE POWER DOWN 2. This command can be saved by AT&W. Example AT+QVBATT=? +QVBATT: 0,(3451-3600),(0,1) +QVBATT: 1,(3100-3450),(0,1) +QVBATT: 2,(4300-4550),(0,1) +QVBATT: 3,(4551-4730),(0,1) OK AT+QVBATT? +QVBATT: 0,3500,1 +QVBATT: 1,3100,1 +QVBATT: 2,4500,0 +QVBATT: 3,4600,0 OK AT+QVBATT=0,3490 OK AT+QVBATT=0 +QVBATT: 0,3490,1 //Test command, query threshold setting range //Read command //Set the low voltagel warning voltage as 3490mV //Query the low voltage warning threshold and state //0 is the function type of the low voltage warning; 3490 is MC20&MC30_AT_Commands_Manual 220 / 259 OK AT+QVBATT=1,3300,0 OK AT+QVBATT=1 +QVBATT: 1,3300,0 OK GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual the threshold of the low voltage warning; 1 means that the function of the low voltage power warning is enabled. //The functon of the low voltagel power off is disabled. //Query the threshold of the low voltage power off and the state //1 means the function type of the low voltage power off; 3300 is the threshold of the low voltage power off; 0 means that the function of low voltage power off is disabled. 14.8. AT+QTEMP Query the Current Voltage and Temperature AT+QTEMP Query the Current Voltage and Temperature Test Command AT+QTEMP=? Response +QTEMP: (list of supported s),(list of supported < tick>s),(list of supported s) Read Command AT+QTEMP? OK Response +QTEMP: ,, Write Command AT+QTEMP=[,, ] OK Response If =1 and the command is executed successfully, response: OK If =2 and the command is executed successfully, response: OK Maximum Response Time +QTEMP: ,, … If there is any error related to ME functionality: +CME ERROR: 300ms MC20&MC30_AT_Commands_Manual 221 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Reference Parameter 0 Disable 1 Enable 2 Sample and report circularly 1-40-65535 Sampling period, only takes effect when =2 1-254 Sampling times, only takes effect when =2 The current voltage of the temperature sensitive resistor (mV) The current temperature of the temperature sensitive resistor NOTES 1. When and are omitted, their default values will be used if they haven’t been set yet; otherwise their previous values will be used. 2. URC interval time is approximately equal to *(*4.615 + 6) milliseconds when =2. 14.9. AT+QMSDC Mount/Unmount an External SD Card AT+QMSDC Mount/Unmount an External SD Card Test Command AT+QMSDC=? Response +QMSDC: Write Command AT+QMSDC= OK Response OK Maximum Response Time Reference If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Number format. Indicate the status of an external SD card. 0 Unmount 1 Mount MC20&MC30_AT_Commands_Manual 222 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual NOTES 1. This command is only support by MC20 module. 2. The configuration of this command will take effect immediately and will not be saved after power-off. MC20&MC30_AT_Commands_Manual 223 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 15 Others Commands 15.1. A/ Re-issue the Last Command Given A/ Re-issue the Last Command Given Execution Command A/ Response Re-issue the previous command Maximum Response Time 300ms Reference V.25ter NOTE This command does not work when the serial multiplexer is active. It does not have to end with the terminating character. Example AT OK A/ OK //Re-issue the previous command 15.2. ATE Set Command Echo Mode ATE Set Command Echo Mode Execution Command ATE[] Maximum Response Time Reference V.25ter Response This setting determines whether or not the TA echoes characters received from TE during command state. OK 300ms MC20&MC30_AT_Commands_Manual 224 / 259 Parameter 0 1 Echo mode off Echo mode on GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 15.3. ATS3 Set Command Line Termination Character ATS3 Set Command Line Termination Character Read Command ATS3? Response Write Command ATS3= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the character recognized by TA to terminate an incoming command line. The TA also returns this character in output. OK 300ms Parameter 0-13-127 Command line termination character (Default 13=) 15.4. ATS4 Set Response Formatting Character ATS4 Set Response Formatting Character Read Command ATS4? Response Write Command ATS4= Maximum Response Time OK Response This parameter setting determines the character generated by the TA for result code and information text. OK 300ms MC20&MC30_AT_Commands_Manual 225 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Reference V.25ter Parameter 0-10-127 Response formatting character (Default 10=) 15.5. ATS5 Set Command Line Editing Character ATS5 Set Command Line Editing Character Read Command ATS5? Response Write Command ATS5= Maximum Response Time Reference V.25ter OK Response This parameter setting determines the character recognized by TA as a request to delete the immediately preceding character from the command line. OK 300ms Parameter 0-8-127 Response editing character (Default 8=) 15.6. AT+QRIMODE Set RI Time AT+QRIMODE Set RI Time Test Command AT+QRIMODE=? Read Command AT+QRIMODE? Response +QRIMODE: (list of supported s) OK Response +QRIMODE: MC20&MC30_AT_Commands_Manual 226 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Write Command AT+QRIMODE= Maximum Response Time Reference Quectel OK Response OK If there is any error related to ME functionality: +CME ERROR: 300ms Parameter Time mode 0 120ms low pulse for RI when receiving SMS or other URCs 1 120ms low pulse for RI when receiving SMS; 50ms low pulse when receiving other URCs 2 When a new SMS is received, RI changes to LOW and holds low level for 120ms; when other URCs are received, it takes no effect on RI MC20&MC30_AT_Commands_Manual 227 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 16 Appendix References 16.1. Related Documents Table 4: Related Documents SN Document Name [1] V.25ter [2] GSM 07.07 [3] GSM 07.05 [4] GSM 07.10 [5] Quectel_GSM_TCP(IP)_Application_Note [6] Quectel_GSM_MUX_Application_Note [7] Quectel_GSM_SMS_Application_Note [8] Quectel_MC20_Hardware_Design [9] Quectel_MC30_Hardware_Design Remark Serial asynchronous automatic dialing and control Digital cellular telecommunications (Phase 2+); AT command set for GSM Mobile Equipment (ME) Use of Data Terminal Equipment - Data Circuit terminating Equipment (DTE- DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS) Support GSM 07.10 multiplexing protocol GSM TCP/IP Application Note MUX Application Note SMS Application Note MC20 Hardware Design MC30 Hardware Design MC20&MC30_AT_Commands_Manual 228 / 259 16.2. Terms and Abbreviations GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Table 5: Terms and Abbreviations Abbreviation Description AMR AID Adaptive Multi-Rate Application IDentifier APDU CLA CSD Application Protocol Data Unit CLAss Circuit Switch Data DCD DCE DTE Dynamic Content Delivery Data Communication Equipment Data Terminal Equipment DTR GPRS Data Terminal Ready General Packet Radio Service ME MS PDP Mobile Equipment Mobile Station Packet Data Protocol PSC RTS/CTS Primary Synchronization Code Request To Send/Clear To Send TA Terminal Adapter TCP TE Transmission Control Protocol Terminal Equipment UDP UICC User Datagram Protocol Universal Integrated Circuit Card MC20&MC30_AT_Commands_Manual 229 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 16.3. Factory Default Settings Restorable with AT&F Table 6: Factory Default Settings Restorable with AT&F AT Command ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT&C AT&D AT+ILRR AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP Parameters ,, Factory Defaults 1 0 0 13 10 8 2 60 2 15 1 4 1 0 0 0 0,0,0 0 'GSM' 129 0 MC20&MC30_AT_Commands_Manual 230 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+CLIR AT+CMEE AT+COLP AT+CR AT+QDISH AT+CRSL AT+CLVL AT+CUSD AT+CSSN AT+CSNS AT+CMGF AT+CNMI AT+CSDH AT+CSMS AT+QSIDET AT+QMIC AT+QSCLK AT+QCLIP AT+QCOLP AT+QIURC AT+QEXTUNSOL 0 1 0 0 0 55 When AT+QAUDCH=0, the default value =60; When AT+QAUDCH=1, the default value =40; When AT+QAUDCH=2, the default value =35; 0 , 0,0 0 0 ,,,, 2,1,0,0,0 0 0 ,, When AT+QAUDCH=0, the default value =80; When AT+QAUDCH=1, the default value =144; 4,9,8 0 0 0 1 0 MC20&MC30_AT_Commands_Manual 231 / 259 AT+QRIMODE AT+QSIMDET AT+QSIMSTAT GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 0 ,, 0,0,0 0 16.4. AT Command Settings Storable with AT&W Table 7: AT Command Settings Storable with AT&W AT Command ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT&C AT&D AT+ICF AT+IFC Parameters , , Display with AT&V Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes No Yes Yes Yes Yes MC20&MC30_AT_Commands_Manual 232 / 259 AT+ILRR AT+IPR AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR AT+CMEE AT+COLP AT+CR AT+QDISH AT+CRSL AT+CLVL AT+CUSD AT+CSNS AT+CMGF AT+CNMI AT+CSDH AT+QSIDET AT+QMIC AT+QSCLK AT+QCLIP GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Yes Yes Yes ,, Yes Yes Yes Yes Yes Yes Yes Yes Yes No No No Yes Yes Yes ,,,, Yes Yes Yes ,, No Yes MC20&MC30_AT_Commands_Manual 233 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+QCOLP AT+QIURC AT+QEXTUNSOL AT+QRIMODE AT+QSIMDET AT+QSIMSTAT Yes No No No ,, Yes Yes 16.5. AT Command Settings Storable with ATZ Table 8: AT Command Settings Storable with ATZ AT Command ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT&C Parameters Factory Defaults 1 0 0 13 10 8 2 60 2 15 1 4 1 MC20&MC30_AT_Commands_Manual 234 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT&D AT+ILRR AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR AT+CMEE AT+COLP AT+CR AT+QDISH AT+CRSL ,, AT+CLVL AT+CUSD AT+CSSN AT+CSNS AT+CMGF AT+CNMI AT+CSDH AT+CSMS AT+QSIDET , ,,,, MC20&MC30_AT_Commands_Manual 0 0 0 0,0,0 0 'GSM' 129 0 0 1 0 0 0 55 When AT+QAUDCH=0, the default value =60; When AT+QAUDCH=1, the default value =40; When AT+QAUDCH=2, the default value =35; 0 0,0 0 0 2,1,0,0,0 0 0 When AT+QAUDCH=0, the default 235 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual AT+QMIC AT+QSCLK AT+QCLIP AT+QCOLP AT+QIURC AT+QEXTUNSOL AT+QRIMODE AT+QSIMDET AT+QSIMSTAT ,, value =80; When AT+QAUDCH=1, the default value =144; 4,9,8 0 0 0 1 0 0 ,, 0,0,0 0 16.6. Summary of URC Table 9: Summary of URC Index 1 2 3 4 5 URC display Meaning Condition +CMTI: , +CMT: [], +CMT: ,[],[, ,,,,,,] +CBM: +CBM: ,,,,,, New message is received, and saved to memory New short message is received and output directly to TE (PDU mode) New short message is received and output directly to TE (Text mode) New CBM is received and output directly (PDU mode) New CBM is received and output directly to TE (Text mode) AT+CNMI=2,1 AT+CNMI=2,2 AT+CNMI=2,2 AT+CNMI=2,2 AT+CNMI=2,2 MC20&MC30_AT_Commands_Manual 236 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual +CDS: directly (PDU mode) +CDS: ,,[],[],,, directly to TE (Text mode) +CGEV: NW DEACT,[,] AT+CGEREP=1 +CGEV: ME DEACT,[,] AT+CGEREP=1 10 +CGEV: NW DETACH GPRS network detach AT+CGEREP=1 11 +CGEV: ME DETACH GPRS ME detach AT+CGEREP=1 12 +CGREG: 1 Network registered AT+CGREG=1 13 +CGREG: 0 Network unregistered AT+CGREG=1 14 +CGREG: 1, Network registered, with location code AT+CGREG=2 15 +CGREG: 0, Network unregistered, with location AT+CGREG=2 code 16 +QCGTIND A CS voice call, CS data, fax call or AT+QCGTIND=1 GPRS session termination indicator 17 +CSQN: , Signal quality change AT+QEXTUNSOL ='SQ',1 18 +FPLMN: AT+QEXTUNSOL Forbidden network is available only ='FN',1 +CMWT: ,,,,, AT+QEXTUNSOL ='MW',1 20 +QGURC: Unsolicited result code follows particular call state transition AT+QEXTUNSOL ='UR',1 21 +CBCN: , Display battery connection status and battery charge level AT+QEXTUNSOL ='BC',1 22 +QBAND: Band mode display AT+QEXTUNSOL ='BM',1 +TSMSINFO: AT+QEXTUNSOL ='SM',1 Displays the disconnected call ID +CCINFO: , ='CC',1 one of the call is disconnected 25 RING Indicates incoming call N/A 26 Call Ready Device is ready to make/receive N/A calls MC20&MC30_AT_Commands_Manual 237 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual UNDER_VOLTAGE POWER 27 Under voltage shutdown indication N/A DOWN 28 UNDER_VOLTAGE WARNING Under voltage warning N/A OVER_VOLTAGE POWER 29 Over voltage shutdown indication N/A DOWN 30 OVER_VOLTAGE WARNING Over voltage warning N/A 31 NORMAL POWER DOWN Normal power down N/A The presentation of the +COLP: ,[,,[,]] mobile originated call +CLIP: ,,'[]',[],'[]', 34 +CRING: An incoming call is indicated to the TE with unsolicited result code instead of the normal RING AT+CRC=1 35 +CREG: Indicate registration status of the ME AT+CREG=1 After cell neighborhood changing shows whether the network has 36 +CREG: [,,] AT+CREG=2 currently indicated the registration of the ME, with location area code +CCWA: ,,[,] AT+CCWA=1,1 38 RDY ME initialization is successful N/A 39 +CFUN: 1 All function of the ME is available N/A 40 +CPIN: (U)SIM card pin state N/A 41 MO RING MO call ringing AT+QMOSTAT=1 42 MO CONNECTED 43 ALARM RING 44 ALARM MODE MO call connected Alarm event is triggered ME is switched on by alarm AT+QMOSTAT=1 AT+QALARM=1,,,0/1 AT+QALARM=1,,,2 MC20&MC30_AT_Commands_Manual 238 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 16.7. Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands. The following table lists most of general and GRPS related ERROR Codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. Table 10: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 8 10 11 12 13 14 15 16 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required PH_SIM_PUK_REQUIRED (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required (U)SIM failure (U)SIM busy (U)SIM wrong Incorrect password MC20&MC30_AT_Commands_Manual 239 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 17 (U)SIM PIN2 required 18 (U)SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required 48 Long dial-number storage is full 100 Unknow 103 Illegal MS 106 Illegal ME MC20&MC30_AT_Commands_Manual 240 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 107 GPRS services not allowed 111 PLMN not allowed 112 Location area not allowed 113 Roaming not allowed in this location area 132 Service option not supported 133 Requested service option not subscribed 134 Service option temporarily out of order 148 Unspecified GPRS error 149 PDP authentication failure 150 Invalid mobile class 151 Link NS SP person PIN required 152 Link NS SP person PUK required 153 Link SIM C person PIN required 154 Link SIM C person PUK required 302 Command conflict 600 No Error 601 Unrecognized command 602 Return error 603 Syntax error 604 Unspecified 605 Data transfer already 606 Action already 607 Not AT command 608 Multi command too long 609 Abort COPS MC20&MC30_AT_Commands_Manual 241 / 259 610 3513 3515 3516 3517 3518 3519 3738 3742 3765 3769 3771 3772 3773 3774 3775 3777 3778 3779 3780 3790 3791 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual No call disconnect Unread records on SIM PS busy Couldn't read SMS parameters from SIM SM not ready Invalid parameter Incomplete concatenate SMS CSCS mode not found CPOL operation format wrong Invalid input value Unable to get control Call setup in progress (U)SIM powered down Invalid CFUN state Invalid ARFCN The pin is not in GPIO mode Invalid sms character The length of SMS is zero No enough length for sc Incorrect data length Empty destination address Call is in progress MC20&MC30_AT_Commands_Manual 242 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 16.8. Summary of CMS ERROR Codes Final result code +CMS ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands: Table 11: Different Coding Schemes of +CMS ERROR: Code of 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 Meaning ME failure SMS ME reserved Operation not allowed Operation not supported Invalid PDU mode Invalid text mode (U)SIM not inserted (U)SIM pin necessary PH (U)SIM pin necessary (U)SIM failure (U)SIM busy (U)SIM wrong (U)SIM PUK required (U)SIM PIN2 required (U)SIM PUK2 required Memory failure Invalid memory index MC20&MC30_AT_Commands_Manual 243 / 259 322 330 331 332 500 512 513 514 515 517 528 529 530 531 3513 3515 3516 3517 3518 3742 3765 3769 3771 3772 3773 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Memory full SMSC address unknown No network Network timeout Unknown (U)SIM not ready Message length exceeds Invalid request parameters ME storage failure Invalid service mode More message to send state error MO SMS is not allow GPRS is suspended ME storage full Unread records on SIM PS busy Couldn't read SMS parameters from SIM SM not ready Invalid parameter Incorrect format Invalid input value Unable to get control of required module Call setup in progress (U)SIM powered down Unable to operate in this CFUN state MC20&MC30_AT_Commands_Manual 244 / 259 3774 3775 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Invalid ARFCN in this band The pin is not in GPIO mode 16.9. Summary of Cause for Extended Error Report 16.9.1. Location ID for the Extended Error Report Table 12: Location ID for the Extended Error Report ID Description 0 No error (default) 1 Cause for protocol stack (PS) layer 2 Internal cause for Mobility Management (MM) layer 3 Cause for PPP/IP-Stack 16.9.2. Cause for Protocol Stack (PS) Layer Table 13: Cause for Protocol Stack (PS) Layer Cause CM Cause 0 1 3 6 8 10 11 Description Radio link fail Unassigned number No route to destination Channel unacceptable Operator determined barring Call barred Reserved MC20&MC30_AT_Commands_Manual 245 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 16 Normal call clearing 17 User busy 18 No user responding 19 User alerting, no answer 21 Call rejected 22 Number changed 25 Pre-emption 26 Non-selected user clearing 27 Destination out of order 28 Invalid number format (incomplete number) 29 Facility rejected 30 Response to STATUS ENQUIRY 31 Normal, unspecified 34 No circuit/channel available 38 Network out of order 41 Temporary failure 42 Switching equipment congestion 43 Access information discarded 44 Requested circuit/channel not available 47 Resource unavailable, unspecified 49 Quality of service unavailable 50 Requested facility not subscribed 55 Incoming calls barred within the CUG 57 Bearer capability not authorized 58 Bearer capability not presently available MC20&MC30_AT_Commands_Manual 246 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 63 Service or option not available, unspecified 65 Bearer service not implemented 68 ACM equal or greater than ACM maximum 69 Requested facility not implemented 70 Only restricted digital information bearer capability is available 79 Service or option not implemented, unspecified 81 Invalid transaction identifier value 87 User not member of CUG 88 Incompatible destination 91 Invalid transit network selection 95 Semantically incorrect message 96 Invalid mandatory information 97 Message type non-existent or not implemented 98 Message type not compatible with protocol state 99 Information element non-existent or not implemented 100 Conditional information element error 101 Message not compatible with protocol 102 Recovery on timer expiry 111 Protocol error, unspecified 127 Interworking, unspecified 128 Telematic interworking not supported 129 Short message Type 0 not supported 130 Cannot replace short message 143 Unspecified TP-PID error 144 Data coding scheme (alphabet) not supported MC20&MC30_AT_Commands_Manual 247 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 145 Message class not supported 159 Unspecified TP-DCS error 160 Command cannot be acted 161 Command unsupported 175 Unspecified TP-Command error 176 TPDU not supported 192 SC busy 193 No SC subscription 194 SC system failure 195 Invalid SME address 196 Destination SME barred 197 SM Rejected-Duplicate SM 198 TP-VPF not supported 199 TP-VP not supported 208 (U)SIM SMS storage full 209 No SMS storage capability in SIM 210 Error in MS 211 Memory Capacity Exceeded 212 (U)SIM Application Toolkit Busy 213 (U)SIM data download error 224 CP retry exceed 225 RP trim timeout 226 SMS connection broken 255 Unspecified error cause 304 Invalid PDU mode parameter MC20&MC30_AT_Commands_Manual 248 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 305 Invalid TEXT mode parameter 313 (U)SIM failure 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 340 No +CNMA acknowledgement expected 500 Unknown error 512 SMS no error 513 Message length exceeds maximum length 514 Invalid request parameters 515 ME storage failure 516 Invalid bearer service 517 Invalid service mode 518 Invalid storage type 519 Invalid message format 520 Too many MO concatenated messages 521 SMSAL not ready 522 SMSAL no more service 523 Not support TP-Status-Report&TP-Command in storage 524 Reserved MTI 525 No free entity in RL layer 526 The port number is already registered 527 There is no free entity for port number 528 More Message to Send state error MC20&MC30_AT_Commands_Manual 249 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 529 530 531 532 CC Cause 768 769 770 771 772 773 774 775 776 777 778 896 897 898 SS Cause 1024 1025 1033 1034 1035 MO SMS is not allow GPRS is suspended ME storage full Doing (U)SIM refresh Command not allowed Illegal card ID Call allocation fail BC fill fail Call RE EST Illegal DTMF tone Illegal BC Modify actual mode Data action fail No response from network Call accept not allowed General cause CSD call is aborted by user during call establishment or MT call abort MO call/USSD CSD call is disconnected due to lower layer failure Cause none Unknown subscriber Illegal subscriber Bearer service not provisioned Tele service not provisioned MC20&MC30_AT_Commands_Manual 250 / 259 1036 1037 1040 1041 1042 1043 1044 1045 1051 1053 1054 1058 1059 1060 1061 1062 1067 1078 1095 1096 1145 1146 1147 1148 1149 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Illegal equipment Call barred Illegal SS operation SS error status SS not available SS subscription violation SS incompatibility Facility not supported Absent subscriber Short term denial Long term denial System failure Data missing Unexpected data value PW registration failure Negative PW check Number of PW attempts violation Position method failure Unknown alphabet USSD busy Rejected by user Rejected by network Deflection to served subscriber Special service code Invalid deflection to number MC20&MC30_AT_Commands_Manual 251 / 259 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 MM Cause 2048 2050 2051 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Max number of MPTY participants exceeded Resources not available General problem, unrecognized component General problem, mistyped component General problem, badly structured component Invoke problem, duplicate invoked Invoke problem, unrecognized operation Invoke problem, mistyped parameter Invoke problem, resource limitation Invoke problem, initiating release Invoke problem, unrecognized linked ID Invoke problem, linked resource unexpected Invoke problem, unexpected linked operation Return result problem, RR unrecognized invoked Return result problem, RR, return result unexpected Return result problem, RR mistyped parameter Return error problem, RE, unrecognized invoked Return error problem, RE return error unexpected Return error problem, RE unrecognized error Return error problem, RE unexpected error Return error problem, RE mistyped parameter Cause none IMSI unknown in HLR Illegal MS MC20&MC30_AT_Commands_Manual 252 / 259 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2068 2069 2070 2080 2081 2082 2086 2088 2096 2111 2143 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual IMSI unknown in VLR IMEI not accepted Illegal ME GPRS not allowed None GPRS not allowed MS ID not derived by network Implicit detach PLMN not allowed Location area not allowed Roaming area not allowed GPRS not allowed in PLMN No suitable cells in LA MSC temp not reachable Network failure MAC failure Sync failure Congestion Serve option not supported Request serve option not subscribed Serve option temp out of order Call cannot be identified No PDP context activated Retry upon entry into a new cell Retry upon entry into a new cell Semantically incorrect message MC20&MC30_AT_Commands_Manual 253 / 259 2144 2145 2146 2147 2148 2149 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 SIM Cause 2560 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Invalid MM info Message type non existent Message type incompatible with protocol state IE not implemented Conditional MM IE error Message not compatible with protocol state Protocol error unspecified Access barred Assignment reject Random access failure RR no service PLMN search reject emergency RR connection release Authentication failure IMSI detach Abort by network Connection timeout Enqueue fail Not updated State not allowed Emergency not allowed No service Access class barred Command success MC20&MC30_AT_Commands_Manual 254 / 259 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 SM Cause 3080 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3108 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual Command fail Fatal error No inserted CHV not init CHV verify error CHV block Access not allow SAT command busy DL error Memory problem Technical problem PUK unlock Operator determined barring LLC SND failure Insufficient resource Unknown APN Unknown PDP address or type Authentication failure Activation reject GGSN Activation reject Unsupported service option Unsubscribed service option Out of order service option Regular deactivation MC20&MC30_AT_Commands_Manual 255 / 259 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3153 3167 3168 3169 3170 3171 3172 3173 3183 3184 ABM Cause 3273 3274 3275 3276 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual QOS not accepted Network fail Reactivation required Unsupported network context activation Semantic error in TFT operation Syntactical error in TFT operation Unknown PDP context Semantic error in packet filter Syntax error in packet filter PDP context WO TFT already act Invalid TI Incorrect message Invalid MAND info Unimplemented message type Incompatible message type protocol state Unimplemented IE Conditional IE error Incompatible message protocol state Unspecified Startup failure Success Invalid network account ID GPRS reactivate GPRS protocol rejection MC20&MC30_AT_Commands_Manual 256 / 259 3277 3278 3279 3280 3283 3284 3285 3286 TCM Cause 3372 3373 3374 3375 3376 3377 3378 3379 3380 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual CSD reactivate CSD PPP negotiated failed CSD action failed CSD call setup failed Rejected Slot limited Abort None auto deactivation Invalid parameter NSAPI not in use ACL action not allowed ACL (U)SIM file full ACL add entry failed ACL del entry failed ACL set entry failed ACL (U)SIM read failed ACL (U)SIM write failed 16.9.3. Internal Cause for MM Layer Table 14: Internal Cause for MM Layer Cause 112 113 114 Description Forbidden PLMN Access class barred No coverage MC20&MC30_AT_Commands_Manual 257 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 115 GPRS service not allowed 116 Timer expiry 117 (U)SIM inserted 118 (U)SIM removed 119 (U)SIM absent 120 (U)SIM invalid for PS 121 (U)SIM invalid for CS 122 (U)SIM invalid for PS and CS 123 Low layer fail 124 Connection in progress 125 Not updated 126 Connection establish failure 127 Connection abort 128 Connection failure 129 Emergency not allowed 130 No GPRS coverage 131 Abnormal LU 132 Abnormal LU less than 4 times 133 Same LAI IMSI attaching 16.9.4. Cause for PPP/IP-Stack Table 15: Cause for PPP/IP-Stack Cause 0 1 Description No error LCP fail MC20&MC30_AT_Commands_Manual 258 / 259 GSM/GPRS/GNSS Module Series MC20&MC30 AT Commands Manual 2 Authentication fail 3 IPCP fail 4 ESC detect 5 Plug out detect 6 PPP GPRS dialup already activated 7 PPP not activated by external modem yet 8 PPP already activated by external modem 9 PPP not activated by WAP over CSD yet 10 PPP already activated by WAP over CSD 11 PPP wrong CSD mode ID 12 PPP detect AT command during dialup 13 PPP detect escape during dialup MC20&MC30_AT_Commands_Manual 259 / 259

GNSS SDK Commands Manual GNSS Module Series Rev. GNSS_SDK_Commands_Manual_V1.4 Date: 2017-07-21 www.quectel.com GNSS Module Series GNSS SDK 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 l Or Email to: support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2017. All rights reserved. GNSS_SDK_Commands_Manual Confidential / Released 1 / 28 GNSS Module Series GNSS SDK Commands Manual About the Document History Revision 1.0 1.1 1.2 1.3 1.4 Date 2015-09-11 l 2016-01-18 cte l 2016-05-20 ue tia 2016-08-15 CQonfiden 2017-07-21 Author Hyman DING Connie ZHOU Simon HU Simon HU Matt YE/ Simon HU Description Initial Added the current supported SDK commands in Table 1. 1. Added the following new commands: PQECEF, PQODO, PQPZ90, PQGLP, PQVEL. 2. Added L76 and L76-L in Table 1. 3. Added the Chapter 3: Appendix References. 1. Added L26 in Table 1. 2. Improved the function of PQODO to enable initial distance setting. 1. Updated notes for PQODO in Chapter 2.8 2. Added the following new commands:  PQJAM (Chapter 2.12)  PQRLM (Chapter 2.13)  PQGEO (Chapter 2.14)  PQPREC (Chapter 2.15)  PQGBS (Chapter 2.16) GNSS_SDK_Commands_Manual Confidential / Released 2 / 28 GNSS Module Series GNSS SDK Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 2 Quectel NMEA Packet Protocol.......................................................................................................... 7 2.1. Quectel NMEA Packet Format .................................................................................................. 7 2.2. PQBAUD Change NMEA Port Default Baud Rate ................................................................. 8 2.3. POEPE Enable/Disable PQEPE Sentence Output ................................................................ 8 3 2.4. 2.5. 2.6. 2.7. l 2.8. 2.9. te 2.10. 2.11. c l 2.12. ue tia 2.13. 2.14. 2.15. 2.16. PQ1PPS Set the Type and Pulse Width of 1PPS Output....................................................... 9 PQFLP Set the Module into FLP Mode ................................................................................ 10 PQTXT Enable/Disable GPTXT Sentence Output ............................................................... 11 PQECEF Enable/Disable ECEFPOSVEL Sentence Output ................................................ 12 PQODO Start/Stop Odometer Reading ................................................................................ 13 PQPZ90 Enable/Disable Switching from WGS84 to PZ-90.11 ............................................ 14 PQGLP Set the Module into GLP Mode ............................................................................... 15 PQVEL Enable/Disable 3 Ways Velocity Sentence Output .................................................. 16 PQJAM Enable/Disable Jamming Detection Function ......................................................... 17 PQRLM Enable/Disable Return Link Message Output......................................................... 18 PQGEO Configure Parameters of Geo-fence ...................................................................... 20 PQPREC Configure Parameter Precision in NMEA Sentences ........................................... 23 PQGBS Enable/Disable GBS Sentence Output ................................................................... 24 Q n Appendix References ........................................................................................................................ 26 e 3.1. Related Documents ................................................................................................................. 26 fid 3.2. Terms and Abbreviations ......................................................................................................... 26 3.3. Datum Sentence Definition...................................................................................................... 27 Con 3.4. GBS Sentence Definition......................................................................................................... 28 GNSS_SDK_Commands_Manual Confidential / Released 3 / 28 GNSS Module Series GNSS SDK Commands Manual Table Index TABLE 1: CURRENT SUPPORTED SDK COMMANDS..................................................................................... 5 TABLE 2: RELATED DOCUMENTS .................................................................................................................. 26 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 26 TABLE 4: DATUM SENTENCE DEFINITION .................................................................................................... 27 TABLE 5: GBS SENTENCE DEFINITION......................................................................................................... 28 CQouneficdteenl tial GNSS_SDK_Commands_Manual Confidential / Released 4 / 28 GNSS Module Series GNSS SDK Commands Manual 1 Introduction Quectel GNSS modules support SDK commands which are defined and developed by Quectel. This document describes these SDK commands. The configuration parameters saved by SDK commands will still exist in flash even after upgrading the modules’ firmware. This document is applicable to Quectel L70, L80, L76, L76-L, L86 and L26 modules. Their supported SDK commands are shown in the table below: Table 1: Current Supported SDK Commands l SDK Description te Commands PQBAUD Change NMEA Port Default Baud Rate L70 L80 L76 L76-L L86 L26 Y Y Y Y Y Y c l PQEPE Enable/Disable PQEPE Sentence Output Y Y Y Y ue tia Set the Type and Pulse Width of 1PPS PQ1PPS Y Y Y Y Output Q n PQFLP Set the Module into FLP (Fitness Low Y Y N N Power) Mode e PQTXT Enable/Disable GPTXT Sentence Output N Y N N fid Enable/Disable ECEFPOSVEL Sentence PQECEF N N Y Y Output PQODO Start/Stop Odometer Reading N N Y Y n Enable/Disable Switching from WGS84 to o PQPZ90 N N Y Y PZ-90.11 C PQGLP Set the Module into GLP (GNSS Low N N Y Y Y Y Y Y N N Y Y Y Y Y Y Y Y Y Y Power) Mode PQVEL Enable/Disable 3 Ways Velocity Sentence N N Y Y Output Y Y PQJAM Enable/Disable Jamming Detection N N Y Y Function Y Y PQRLM Enable/Disable Return Link Message N N Y Y Output Y Y PQGEO Configure Parameters of Geo-fence Y N Y Y Y Y GNSS_SDK_Commands_Manual Confidential / Released 5 / 28 GNSS Module Series GNSS SDK Commands Manual Configure Parameter Precision in NMEA PQPREC N N Y Y Sentences PQGBS Enable/Disable GBS Sentence Output N N Y Y Y Y Y Y NOTES 1. Y means supported; N means not supported. 2. For more details about the usage of PQFLP and PQGLP commands, please refer to document [1]. CQouneficdteenl tial GNSS_SDK_Commands_Manual Confidential / Released 6 / 28 GNSS Module Series GNSS SDK Commands Manual 2 Quectel NMEA Packet Protocol This chapter introduces the Quectel NMEA packet protocol which is a set of extension messages of the standard NMEA packet protocol. These messages are used to control and configure Quectel L70, L80, L76, L76-L, L86 and L26 modules. The structure of Quectel NMEA packet is shown as below: 2.1. Quectel NMEA Packet Format tel Preamble TalkerID PktType DataField * CHK1 CHK2 CR LF c l Packet Contents: ue tia Preamble: One byte character. ‘$’ TalkerID: Two bytes character string. Q n 'PQ' e PktType: 1-10 bytes character string. An identifier used to tell the decoder how to decode the packet. fid DataField: The DataFileld has variable lengths depending on the packet type. A command symbol ‘,’ must be inserted ahead of each data filed to help the decoder process the DataField. n * : 1 byte character. The star symbol is used to mark the end of DataField. o CHK1, CHK2: Two bytes character string. CCHK1 and CHK2 are the check sum of the data between Preamble and ‘*’. CR, LF: Two bytes binary data. The two bytes are used to identify the end of a packet. NOTE The maximum length of each packet is restricted to 255 bytes. GNSS_SDK_Commands_Manual Confidential / Released 7 / 28 GNSS Module Series GNSS SDK Commands Manual 2.2. PQBAUD Change NMEA Port Default Baud Rate PQBAUD Change NMEA Port Default Baud Rate Write Command $PQBAUD,W,*Checksum Response $PQBAUD,W,OK*Checksum If there is any error, response: $PQBAUD,W,ERROR*Checksum Reference Parameter NMEA port baud rate, default value is 9600bps, and can be set to 4800bps, 14400bps, 19200bps, 38400bps, 57600bps and 115200bps tel Example c l $PQBAUD,W,115200*43 $PQBAUD,W,OK*40 //Change NMEA port default baud rate to 115200bps //Set OK ue tia NOTES Q n 1. The command will be effective immediately after setting. e 2. Parameter is automatically saved. 3. If the baud rate is changed, then there is no response returned in the current baud rate. nfid 2.3. POEPE Enable/Disable PQEPE Sentence Output Co PQEPE Enable/Disable PQEPE Sentence Output Write Command Response $PQEPE,W,,*Checksu $PQEPE,W,OK*Checksum m If there is any error, response: $PQEPE,W,ERROR*Checksum URC Message $PQEPE,,*Checksum Parameter Estimated horizontal position error GNSS_SDK_Commands_Manual Confidential / Released 8 / 28 Reference GNSS Module Series GNSS SDK Commands Manual Estimated vertical position error Example $PQEPE,5.3050,3.2000*53 Parameter Operation 0 Disable the URC including EPE data 1 Enable the URC including EPE data Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart l Example te $PQEPE,W,1,1*2A c l $PQEPE,W,OK*02 //Enable the URC including EPE data, and save parameters into flash //Set OK ue tia NOTE The command will be effective immediately after setting. Q fiden 2.4. PQ1PPS Set the Type and Pulse Width of 1PPS Output n PQ1PPS Set the Type and Pulse Width of 1PPS Output o Write Command $PQ1PPS,W,,*Checksu C m Response $PQ1PPS,W,OK*Checksum If there is any error, response: $PQ1PPS,W,ERROR*Checksum Reference Parameter The type of 1PPS output 0 Disable 1PPS output GNSS_SDK_Commands_Manual Confidential / Released 9 / 28 GNSS Module Series GNSS SDK Commands Manual 1 Send 1PPS after the first fix 2 Send 1PPS after 3D fix 3 Send 1PPS after 2D fix 4 Send 1PPS always PPS pulse width in millisecond Range: 2-998 Example $PQ1PPS,W,4,100*1D //Set the type of 1PPS output and PPS pulse width $PQ1PPS,W,OK*30 //Set OK $PQ1PPS,W,0,0*18 //Disable 1PPS output $PQ1PPS,W,OK*30 //Set OK NOTES l 1. The command will be effective immediately after setting. 2. The parameters is automatically saved. te 3. If is set as 0, could be set as 0-998. uec tial 2.5. PQFLP Set the Module into FLP Mode Q n PQFLP Set the Module into FLP Mode e Write Command $PQFLP,W,,*Checksu fid m n Read Command o $PQFLP,R*Checksum Response $PQFLP,W,OK*Checksum If there is any error, response: $PQFLP,W,ERROR*Checksum Response $PQFLP,R,*Checksum C Reference Parameter Module operation mode 0 Normal mode 1 FLP mode Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart GNSS_SDK_Commands_Manual Confidential / Released 10 / 28 Example $PQFLP,W,1,1*20 $PQFLP,W,OK*08 $PQFLP,R*25 $PQFLP,R,1*38 GNSS Module Series GNSS SDK Commands Manual //Change to FLP mode //Set OK //Read mode //Read OK, FLP mode is enabled NOTE The command will be effective immediately after setting. 2.6. PQTXT Enable/Disable GPTXT Sentence Output l PQTXT Enable/Disable GPTXT Sentence Output te Write Command $PQTXT,W,,*Checksu c l m ue tia URCMessage Response $PQTXT,W,OK*Checksum If there is any error, response: $PQTXT,W,ERROR*Checksum $GPTXT,01,01,02,*Checksum Q n Parameter e Status of antenna ANTSTATUS=OK: antenna is well connected fidANTSTATUS=OPEN: antenna has been disconnected ANTSTATUS=SHORT: antenna is short-circuited Con Reference Example $GPTXT,01,01,02,ANTSTATUS=OK*3B Parameter Operation 0 Disable GPTXT sentence output 1 Enable GPTXT sentence output Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart GNSS_SDK_Commands_Manual Confidential / Released 11 / 28 Example $PQTXT,W,1,1*22 $PQTXT,W,OK*0A GNSS Module Series GNSS SDK Commands Manual //Enable GPTXT sentence output and save the parameter into flash //Set OK NOTE The command will be effective immediately after setting. 2.7. PQECEF Enable/Disable ECEFPOSVEL Sentence Output PQECEF Enable/Disable ECEFPOSVEL Sentence Output Write Command l $PQECEF,W,,*ChkSu m cte l ReadCommand ue tia $PQECEF,R*ChkSum URC Message Response $PQECEF,W,OK*ChkSum If there is any error, response: $PQECEF,W,ERROR*ChkSum Response $PQECEF,R,*ChkSum $ECEFPOSVEL,,,,,,,*C hkSum Q n Parameter e fid n o UTC from the internal real-time clock The value of X axis in ECEF The value of Y axis in ECEF The value of Z axis in ECEF Velocity component of X axis in ECEF Velocity component of Y axis in ECEF Velocity component of Z axis in ECEF C Example $ECEFPOSVEL,052743.000,-1526672.867459,6191083.982 801,143008.780911,0,0,0*14 Reference GNSS_SDK_Commands_Manual Confidential / Released 12 / 28 GNSS Module Series GNSS SDK Commands Manual Parameter Operation 0 Disable ECEFPOSVEL sentence output 1 Enable ECEFPOSVEL sentence output Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example $PQECEF,W,1,1*7F //Enable ECEFPOSVEL sentence output, and save the parameter into flash $PQECEF,W,OK*57 $PQECEF,R*7A $PQECEF,R,1*67 //Set OK //Read mode //Read OK, ECEFPOSVEL sentence output is enabled l NOTE te The command will be effective immediately after setting. uec tial 2.8. PQODO Start/Stop Odometer Reading Q n PQODO Start/Stop Odometer Reading e Write Command fid $PQODO,W,[,]*ChkSum n Read Command Co $PQODO,R*ChkSum Response $PQODO,W,OK*ChkSum If there is any error, response: $PQODO,W,ERROR*ChkSum Response $PQODO,R,*ChkSum If there is any error, response: $PQODO,R,ERROR*ChkSum Query Command Response $PQODO,Q*ChkSum $PQODO,Q,*ChkSum Reference If there is any error, response $PQODO,Q,ERROR*ChkSum GNSS_SDK_Commands_Manual Confidential / Released 13 / 28 GNSS Module Series GNSS SDK Commands Manual Parameter Start or stop odometer reading 0 Stop odometer reading and remember the distance value 1 Start odometer reading and initialize the distance according to the Set the initial distance, range: 0-1e09, unit: meter When is 1, this parameter can be omitted, and its default value is 0 When is 0, this parameter must be omitted Current distance. Unit: meter Example $PQODO,W,1*23 $PQODO,W,OK*16 $PQODO,W,1,1000000*3E l $PQODO,W,OK*16 $PQODO,R*3B te $PQODO,R,1*26 $PQODO,Q*38 c l $PQODO,Q,123.45*0B //Start odometer reading, and initial distance is 0m. //Set OK //Start odometer reading, and initial distance is 1,000,000m. //Set OK //Read mode //Read OK, odometer reading has already been started //Query the distance value //Current distance value is returned ue tia NOTES Q n 1. The command will be effective immediately after setting. 2. After module is restarted, the PQODO write command must be executed again to re-start odometer e reading. fid 3. The command is not supported in backup mode. n 2.9. PQPZ90 Enable/Disable Switching from WGS84 to PZ-90.11 Co PQPZ90 Enable/Disable Switching from WGS84 to PZ-90.11 Write Command $PQPZ90,W,,*ChkSum Read Command $PQPZ90,R*ChkSum URC Message Response $PQPZ90,W,OK*ChkSum If there is any error, response: $PQPZ90,W,ERROR*ChkSum Response $PQPZ90,R,*ChkSum $GNDTM,P90,x,xx.xxxx,x,xx.xxxx,x,xxx,W84*hh GNSS_SDK_Commands_Manual Confidential / Released 14 / 28 Reference GNSS Module Series GNSS SDK Commands Manual Parameter definition is available in Table 4. Chapter 3.3 Parameter Operation 0 Disable switching from WGS84 to PZ-90.11 1 Enable switching from WGS84 to PZ-90.11 Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example l $PQPZ90,W,1,1*79 $PQPZ90,W,OK*51 te $PQPZ90,R*7C $PQPZ90,R,0*60 //Enable switching from WGS84 to PZ-90.11, and save the parameter into flash //Set OK //Read mode //Read OK, switching from WGS84 to PZ-90.11 is enabled uec tial NOTES 1. The command will be effective immediately after setting to 0. However, when is set Q n to 1, it will be effective only after restart for versions earlier than L76NR03A01S (on L76 module), L76LNR02A01S (on L76-L module), L86NR02A01S (on L86 module) and L26NR02A01S (on L26 e module). 2. If switching from WGS84 to PZ-90.11 is enabled and effective, the coordinate values in RMC and fid GGA sentences will be switched to PZ-90.11 after fixing. Also, a DTM sentence will be displayed to identify the datum used. Con 2.10. PQGLP Set the Module into GLP Mode PQGLP Set the Module into GLP Mode Write Command $PQGLP,W,,*ChkSum Read Command $PQGLP,R*ChkSum Response $PQGLP,W,OK*ChkSum If there is any error, response: $PQGLP,W,ERROR*ChkSum Response $PQGLP,R,*ChkSum GNSS_SDK_Commands_Manual Confidential / Released 15 / 28 GNSS Module Series GNSS SDK Commands Manual Reference Parameter Module operation mode 0 Normal mode 1 GLP mode Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example $PQGLP,W,1,1*21 $PQGLP,W,OK*09 l $PQGLP,R*24 te $PQGLP,R,1*39 //Change to GLP mode //Set OK //Read mode //Read OK, GLP mode is enabled uec tial NOTE The command will be effective immediately after setting. Q fiden 2.11. PQVEL Enable/Disable 3 Ways Velocity Sentence Output PQVEL Enable/Disable 3 Ways Velocity Sentence Output n Write Command $PQVEL,W,,*ChkSum Co Response $PQVEL,W,OK*ChkSum If there is any error, response: $PQVEL,W,ERROR*ChkSum Read Command Response $PQVEL,R*ChkSum $PQVEL,R,*ChkSum URC Message $PQVEL,,,*ChkSum Parameter North velocity East velocity GNSS_SDK_Commands_Manual Confidential / Released 16 / 28 Reference GNSS Module Series GNSS SDK Commands Manual Down velocity Example $PQVEL,1.000000,2.000000,-0.000000*42 Parameter Enable/disable 3 ways velocity sentence output 0 Disable 1 Enable Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart l Example te $PQVEL,W,1,1*25 c l $PQVEL,W,OK*0D ue tia $PQVEL,R*20 $PQVEL,R,1*3D //Enable 3 ways velocity sentence output //Set OK //Read mode //Read OK, 3 ways velocity sentence output is enabled Q n NOTE e The command will be effective immediately after setting. nfid 2.12. PQJAM Enable/Disable Jamming Detection Function Co PQJAM Enable/Disable Jamming Detection Function Write Command $PQJAM,W,,*ChkSum Response $PQJAM,W,OK*ChkSum If there is any error, response: $PQJAM,W,ERROR*ChkSum Read Command $PQJAM,R*ChkSum URC Message Response $PQJAM,R,*ChkSum $PMTKSPF, *ChkSum GNSS_SDK_Commands_Manual Confidential / Released 17 / 28 Reference GNSS Module Series GNSS SDK Commands Manual Parameter Jamming status 1 No jamming, healthy status. 2 Warning status. 3 Critical status Example $PMTKSPF,1*5A Parameter tel Operation mode 0 Disable jamming detection function 1 Enable jamming detection function Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart uec tial Example $PQJAM,W,1,1*3C $PQJAM,W,OK*14 Q n $PQJAM,R*39 e $PQJAM,R,1*24 //Enable jamming detection function //Set OK //Read operation mode //Read OK fid NOTES n 1. The command will be effective immediately after setting. Co 2. The command is not supported in backup mode. 2.13. PQRLM Enable/Disable Return Link Message Output PQRLM Enable/Disable Return Link Message Output Write Command $PQRLM,W,,*ChkSum Response $PQRLM,W,OK*ChkSum If there is any error, response: $PQRLM,W,ERROR*ChkSum GNSS_SDK_Commands_Manual Confidential / Released 18 / 28 GNSS Module Series GNSS SDK Commands Manual Read Command $PQRLM,R*ChkSum URC Message Response $PQRLM,R,*ChkSum $PQRLM,,,,*ChkSum Parameter Beacon ID of RLM The GPS second when receiving RLM Message code The data parameters provided by RLS. (short message contains 4 hex characters, long message contains 24 hex characters) tel Reference Example $PQRLM,0a0a0a0a0a0a0a8,955065733,1,8aa1*3E $PQRLM,050505050505052,955065709,15,5555555555555 55555 c l Parameter ue tia Q fiden Enable/disable return link message output 0 Disable 1 Enable Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example n $PQRLM,W,1,1*29 Co $PQRLM,W,OK*01 //Enable return link message output //Set OK $PQRLM,R*2C //Read mode $PQRLM,R,1*31 //Read OK NOTE The command will be effective immediately after setting. GNSS_SDK_Commands_Manual Confidential / Released 19 / 28 GNSS Module Series GNSS SDK Commands Manual 2.14. PQGEO Configure Parameters of Geo-fence PQGEO Configure Parameters of Geo-fence Write Command Response $PQGEO,W,<GEO $PQGEO,W,OK*ChkSum ID>,,,,,,,,,<latitu $PQGEO,W,ERROR*ChkSum de3>,*ChkSum Read Command Response $PQGEO,R,*ChkSum ctel l Inquire Command ue tia $PQGEO,Q,*ChkSum CQonfiden URC Message $PQGEO,R,,,,,,,,,,,*ChkSum If there is any error, response: $PQGEO,R,ERROR*ChkSum Response $PQGEO,Q,,*ChkSum If there is any error, response: $PQGEO,Q,ERROR*ChkSum $PQGEO,,,,,,,,,,,,,,,,,,*ChkSum Parameters Geo-fence ID is from 0 to 9. The current action of the module 1 Enters a geo-fence 2 Leaves a geo-fence Fix status 0 No fix 1 2D fix 2 3D fix UTC time Format: DyyMMddThhmmss.sss D: char ‘D’, refers to date GNSS_SDK_Commands_Manual Confidential / Released 20 / 28 GNSS Module Series GNSS SDK Commands Manual Reference yy: current year-2000 MM: 1-12 dd: 1-31 T: char ‘T’, refers to time hh: 0-23 mm: 0-59 ss.sss: 00.000-59.9999 The latitude of current position Unit: degree Format: ±dd.dddddd Range: -90.000000~90.000000 The longitude of current position Unit: degree Format: ±ddd.dddddd Range: -180.000000~180.000000 Mean sea level (MSL) altitude lUnit: meter Speed over ground. Unit: km/h te Course over ground Unit: degree c l Range: 0-360.00 ue tia Fix mode 0 No fix 1 Estimated mode 2 Position fixed Q n3 Position fixed in DGPS mode e Reserved1 Horizontal dilution of precision fid Position dilution of precision Vertical dilution of precision Reserved2 n GPS satellites in view GPS satellites used Co Example $PQGEO,0,1,2,D150506T070127.000,31.856038,117.19711 0,49.4,14.92,0.18,2,,1.11,2.95,2.74,,14,9*5D Parameter Geo-fence ID, range: 0-9 Report mode GNSS_SDK_Commands_Manual Confidential / Released 21 / 28 GNSS Module Series GNSS SDK Commands Manual 0 Do not report when to enter or leave the geo-fence 1 Report when to enter the geo-fence 2 Report when to leave the geo-fence 3 Report when to enter or leave the geo-fence If is 0, the parameters after can be omitted. Fence shape 0 Circularity with center and radius 1 Circularity with center and one point on the circle 2 Triangle 3 Quadrangle The latitude of a point which is defined as the center of the geo-fence circular region or the first point, Unit: degree l cte l ue tia Q n fide Con Format: ±dd.dddddd, range: -90.000000~90.000000 The longitude of a point which is defined as the center of the geo-fence circular region or the first point. Unit: degree Format: ±ddd.dddddd, range: -180.000000~180.000000 When is 0, this parameter is radius, unit: meter, range: 0-6000000.0 When is other values, this parameter is latitude1, Unit: degree Format: ±dd.dddddd, range: -90.000000~90.000000 If is 0, the parameters after must be omitted. The longitude of second point. Unit: degree Format: ±ddd.dddddd, range: -180.000000~180.000000 If is 1, the parameters after must be omitted. The latitude of third point. Unit: degree Format: ±dd.dddddd, range: -90.000000~90.000000 The longitude of third point. Unit: degree Format: ±ddd.dddddd, range: -180.000000~180.000000 If is 2, the parameters after must be omitted. The latitude of fourth point. Unit: degree Format: ±dd.dddddd, range: -90.000000~90.000000 The longitude of fourth point. Unit: degree Format: ±ddd.dddddd, range: -180.000000~180.000000 The status of current position. 0 Unknown position 1 Inside the geo-fence 2 Outside the geo-fence Example $PQGEO,W,0,1,0,31.85913,117.1933,500.0*26 $PQGEO,W,OK*1F $PQGEO,W,4,3,1,31.91133,117.1129,31.994856,117.070281*1C $PQGEO,W,OK*1F $PQGEO,W,3,0*34 // is 0. // is 1. //Delete geo-fence 3. GNSS_SDK_Commands_Manual Confidential / Released 22 / 28 GNSS Module Series GNSS SDK Commands Manual $PQGEO,W,OK*1F $PQGEO,R,0*2E $PQGEO,R,0,1,0,31.859130,117.193300,500.0*13 $PQGEO,R,4*2A $PQGEO,R,4,3,1,31.911330,117.112900,31.994856,117.070281*29 $PQGEO,Q,0*2D $PQGEO,Q,0,1*30 $PQGEO,Q,4*29 $PQGEO,Q,4,2*37 NOTES 1. If is 0 and there are no parameters after , this command can delete the geo-fence. 2. If is 1 (or 2), when the module enters (or leaves) the geo-fence, the Reserved2 pin (pin 17) l level will change from high to low; when the module leaves (or enters) the geo-fence, the Reserved2 pin (pin 17) level will change from low to high or keep unchanged. If is 0 or 3, the Reserved2 te (17th) pin level will always keep high. This function is only supported on L76 module and the must be 0. c l 3. $PQGEO,R,10*1F command can inquire parameters of all geofences. ue tia 4. The command will be effective immediately after setting, and the parameters will be automatically saved into flash. 5. Input the latitude and longitude in sequence in clockwise or counter-clockwise order. Q en 2.15. PQPREC Configure Parameter Precision in NMEA Sentences fid The command is used to configure the parameter (latitude/longitude/altitude) precision in NMEA n sentences, through setting the number of digits after the decimal point. o PQPREC Configure Parameter Precision in NMEA Sentences C Write Command Response $PQPREC,W,<latitude $PQPREC,W,OK*ChkSum bits>,[,],*ChkSum If there is any error, response: $PQPREC,W,ERROR*ChkSum Read Command Response $PQPREC,R*ChkSum $PQPREC,R,,,*ChkSum Reference GNSS_SDK_Commands_Manual Confidential / Released 23 / 28 GNSS Module Series GNSS SDK Commands Manual Parameter The number of digits after the decimal point of latitude in NMEA sentences 4 - 6 The default value is 4 The number of digits after the decimal point of longitude in NMEA sentences 4 - 6 The default value is 4 The number of digits after the decimal point of altitude and geoidal separation in NMEA sentences. This parameter can be omitted 1 - 3 The default value is 1 Save operation 0 Configuration is not saved, and ineffective after restart 1 Configuration is saved in flash, and effective after restart Example $PQPREC,W,5,5,2,1*7D l $PQPREC,W,OK*56 //Set the number of digits after the decimal point of latitude and longitude to 5, and altitude to 2, then save the parameter into flash. //Set OK te //The following parameters in bold are variables: c l $xxRMC,030037.000,A,3150.77801,N,11711.95112,E,0.00,37.74,070816,,,A*xx ue tia $xxGGA,030037.000,3150.77801,N,11711.95112,E,1,6,1.66,96.54,M,0.01,M,,*xx $xxGLL,3150.77801,N,11711.95112,E,030037.000,A,A*xx Q n $PQPREC,R*7B $PQPREC,R,5,5,2*65 //Read parameter precision setting in NMEA sentences. //Read OK fide NOTE The command will be effective immediately after setting. Con 2.16. PQGBS Enable/Disable GBS Sentence Output The packet can enable or disable the output of GBS sentence which is used to support receiver autonomous integrity monitoring (RAIM). PQGBS Enable/Disable GBS Sentence Output Write Command $PQGBS,W,,*ChkSum Response $PQGBS,W,OK*ChkSum GNSS_SDK_Commands_Manual Confidential / Released 24 / 28 GNSS Module Series GNSS SDK Commands Manual Read Command $PQGBS,R*ChkSum URC Message If there is any error, response: $PQGBS,W,ERROR*ChkSum Response $PQGBS,R,*ChkSum $--GBS,hhmmss.ss,x.x,x.x,x.x,xx,x.x,x.x,x.x*hh Parameter definition is available in Table 5. Example $GNGBS,035459.000,8.30,4.43,9.41,22,0.0,-162.6,29.2,1,0* 6D Reference Parameter tel uec tial Module operation mode 0 Disable GBS sentence output 1 Enable GBS sentence output Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Q n Example e $PQGBS,W,1,1*2C fid $PQGBS,W,OK*04 $PQGBS,R*29 n $PQGBS,R,1*34 //Enable GBS sentence output and saved into flash //Set OK //Read mode //Read OK, GBS sentence output is enabled Co NOTE The command will be effective immediately after setting. GNSS_SDK_Commands_Manual Confidential / Released 25 / 28 GNSS Module Series GNSS SDK Commands Manual 3 Appendix References 3.1. Related Documents Table 2: Related Documents SN Document Name Remark Quectel_GNSS_Low_Power_Mode_Application [1] GNSS Low Power Mode Application Note _Note ctel l 3.2. Terms and Abbreviations ue tia Table 3: Terms and Abbreviations Abbreviation Q n 1PPS e ECEF fid EPE n FLP Description 1 Pulse Per Second Earth-centered, Earth-fixed Estimated Position Error Fitness Low Power o GBS C GGA GNSS Satellite Fault Detection Global Positioning System Fixed Data GLP GNSS Low Power GNSS Global Navigation Satellite System MLS Mean Sea Level NMEA National Marine Electronics Association ODO Odometer GNSS_SDK_Commands_Manual Confidential / Released 26 / 28 PZ90 RAIM RMC RLM RLS URC GNSS Module Series GNSS SDK Commands Manual Parametry Zemli 1990 Receiver Autonomous Integrity Monitoring Recommended Minimum Specific GNSS Data Return Link Message Return Link Service Unsolicited Result Code 3.3. Datum Sentence Definition The datum sentence definition for $GNDTM,xxx,x,xx.xxxx,x,xx.xxxx,x,xxx,xxx*hh is illustrated l below: te Table 4: Datum Sentence Definition c l Field ue tia 1 Q en 2 fid 3 n 4 o 5 C 6 Meaning Local datum code (xxx): W84 - WGS84 W72 - WGS72 S85 - SGS85 P90 - PZ-90 Local datum sub code (x) Latitude offset in minutes (xx.xxxx) Latitude offset mark (N: +, S: -) (x) Longitude offset in minutes (xx.xxxx) Longitude offset mark (E: +, W: -) (x) 7 Altitude offset in meters. Datum (xxx): W84 - WGS84 8 W72 - WGS72 S85 - SGS85 P90 - PZ-90 9 Checksum GNSS_SDK_Commands_Manual Confidential / Released 27 / 28 GNSS Module Series GNSS SDK Commands Manual 3.4. GBS Sentence Definition The GBS sentence definition for $--GBS,hhmmss.ss,x.x,x.x,x.x,xx,x.x,x.x,x.x,x,x*hh is illustrated below: Table 5: GBS Sentence Definition Field Meaning 1 UTC time of the GGA or GNS fix associated with this sentence. 2 3 4 5 6 7 8 9 10 11 NOTE Expected Error in latitude Expected Error in longitude Expected Error in altitude l ID number of most likely failed satellite te Probability of missed detection for most likely failed satellite c l Estimate of bias in meters on most likely failed satellite ue tia Standard deviation of bias estimate GNSS system ID Q n 1-GPS 2 - GLONASS e 3 - Galileo 4 - RESERVED fid GNSS signal ID 0 - All channel 1 - G1 C/A ConChecksum If only GPS, GLONASS, etc. is used for the reported position solution, the talker ID of GBS is GP, GL, etc., and the errors pertain to the individual system. If satellites from multiple systems are used to obtain the reported position solution, the talker ID is GN and the errors pertain to the combined solution. GNSS_SDK_Commands_Manual Confidential / Released 28 / 28

EC2x&EG9x&EM05 QuecCell AT Commands Manual LTE Module Series Rev. EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual_V1.0 Date: 2017-12-13 Status: Released www.quectel.com LTE Module Series EC2x&EG9x&EM05 QuecCell 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. 2017. All rights reserved. EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 1 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual About the Document History Revision 1.0 Date 2017-12-13 Author Duke XIN/ Adolph WANG Description Initial EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 2 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 1 Introduction .......................................................................................................................................... 4 2 Description of QuecCell AT Commands ........................................................................................... 5 2.1. AT+QENG Switch on/off Engineering Mode ............................................................................ 5 3 Appendix A Reference....................................................................................................................... 14 EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 3 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual 1 Introduction QuecCell is a featured function embedded in Quectel modules. It can be used to scan the detailed information of base stations. This document introduces the AT commands relating to QuecCell function. This document is applicable to following Quectel modules:  EC2x (including EC25, EC21, EC20 R2.0 and EC20 R2.1)  EG9x (including EG91 and EG95)  EM05 EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 4 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual 2 Description of QuecCell AT Commands 2.1. AT+QENG Switch on/off Engineering Mode Engineering mode is designed to report the information of serving cells, neighbour cells and packet switch parameters. The command is used to switch on/off the mode. AT+QENG Switch on/off Engineering Mode Test Command AT+QENG=? Response +QENG: (list of supported s) Query the information of serving cells AT+QENG='servingcell' OK Response In the case of GSM mode: +QENG: 'servingscell',,'GSM',,,,,,,,,,,,,,,,,,,,, ,,, OK In the case of WCDMA mode: +QENG: 'servingcell',,'WCDMA',,,,,,,,,,,,< slot>,, OK In the case of LTE mode: +QENG: 'servingcell',,'LTE',,,,,,,,,,,,,,, OK In the case of TD-SCDMA mode: +QENG: 'servingscell',,'TDSCDMA',,,, ,,,, OK In the case of CDMA mode or CDMA+HDR mode: +QENG: 'servingscell',,'CDMA',,,,,,,, [+QENG: 'servingscell',,'HDR',,,,,,,,] OK In the case of SRLTE mode: +QENG: 'servingscell',,'CDMA',,,,,,,, +QENG: 'servingcell',,'LTE',,,,,,,,,,,,,, Query the information of neighbour cells AT+QENG='neighbourcell' OK Response In the case of GSM mode: [+QENG: 'neighbourcell','GSM',,,,,,,,,,, […]] [+QENG: 'neighbourcell','WCDMA',,,, […]] [+QENG: 'neighbourcell','LTE':,,, […]] EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 6 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual Get 3G cell common information AT+QENG='3gcomm' OK In the case of WCDMA mode: [+QENG:'neighbourcell','WCDMA',,, ,,,,, […]] [+QENG: 'neighbourcell','GSM',,,, […]] [+QENG: 'neighbourcell','LTE',,,,,< s_rxlev> […]] OK In the case of LTE mode: [+QENG: 'neighbourcell intra','LTE',,,,,, ,,,,, […]] [+QENG: 'neighbourcell inter','LTE',,,,,, ,,,, […]] [+QENG: 'neighbourcell','GSM',,,,,,,,, […]] [+QENG: 'neighbourcell','WCDMA',,,,,,,, […]] OK Response Only in WCDMA mode, get 3G cell common items which EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 7 / 15 Reference LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual include the information about 3G neighbour cells, 2G neighbour cells and 3G serving cells information. For WCDMA serving cells information: [+QENG: '3gcomm',,,,,,, ,,,,,,, […]] For 3G neighbor cells information of WCDMA serving cell: [+QENG: '3gcomm',,,,,,, ,,,,,, […]] For 2G neighbor cells information of WCDMA serving cells: [+QENG: '3gcomm',,,,,,, […]] OK If the module works under 2G network, response: OK Parameter String format. The information of different cells. 'servingcell' The information of 2G/3G/4G serving cells 'neighbourcell' The information of 2G/3G/4G neighbour cells String format. UE state. 'SEARCH' UE is searching but could not (yet) find a suitable 2G/3G/4G cell. 'LIMSRV' UE is camping on a cell but has not registered on the network. 'NOCONN' UE is camping on a cell and has registered on the network, and it is in idle mode. 'CONNECT' UE is camping on a cell and has registered on the network, and a call is in progress. String format. Access technology, include: 'GSM' EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 8 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual 'WCDMA' 'LTE' 'CDMA' 'HDR' 'TDSCDMA' Number format. Mobile country code (first part of the PLMN code) '-' Invalid Number format. Mobile network code (second part of the PLMN code) '-' Invalid Hexadecimal format. Location area code. The parameter determines the two-byte location area code in hexadecimal format (e.g. 00C1 equals 193 in decimal) of the cell that was scanned. Range: 0-65535. '-' Invalid Hexadecimal format. Cell ID. The parameter determines the 16-bit (GSM) or 28-bit (UMTS) cell ID. Range: 0-0xFFFFFFF. '-' Invalid Number format. Base station identification code. Range: 0-63. Number format. The parameter determines the ARFCN of the cell that was scanned. Range: 0-1023. Number format. The current band. 0 DCS_1800 1 PCS_1900 '-' Other bands Number format. Routing area code. Range: 0-255. Primary frequency. Number format. RX level value for base station selection in dB (see 3GPP 25.304). Range: 0-63. Subtracting 111 from the RX level value, a dBm value will be got. Number format. MS maximum TX power in CCH. Number format. Minimum access RX level. Number format. Discontinuous reception cycle length. Number format. Cell selection criterion. Number format. Cell reselection criterion. Number format. Whether the current cell supports GPRS or not. 0 Not support GPRS 1 Support GPRS Number format. In hopping, displays „h‟, otherwise displays the current ARFCN in a voice call. Number format. Timeslot number. Number format. Timing advance for the base station. Range: 0-63. Number format. Mobile allocation index offset. Number format. Hopping sequence number. Number format. RX quality (sub). Range: 0-7. Number format. RX quality (full). Range: 0-7. Number format. RX level (sub). Range: 0-63. EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 9 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual Number format. RX level (full). Range: 0-63. String format. Channel mode during a voice call. 'HR' Half rate 'FR' Full rate 'EFR' Enhanced full rate 'AMR' Adaptive Multi-Rate 'AMRHR' AMR half rate 'AMRFR' AMR full rate 'AMRWB' AMR wide band '-' Invalid Number format. UTRA-ARFCN of the cell that was scanned. Number format. E-UTRA-ARFCN of the cell that was scanned. Number format. The parameter determines the primary scrambling code of the cell that was scanned. Number format. Received signal strength indication. Number format. Logarithmic value of SINR, and the values are only the first 1/5 part of the dB value. Range: 0-250, which translates to -20dB - +30dB. Number format. The received signal code power level of the cell that was scanned. Number format. Select RX level value for base station in dB (see 3GPP 25.304). Number format. Spreading factor. Values are 4, 8, 16, 32, 64, 128, 256, and 512. 0 SF_4 1 SF_8 2 SF_16 3 SF_32 4 SF_64 5 SF_128 6 SF_256 7 SF_512 8 UNKNOWN Number format. Slot format for DPCH (0-16). Slot format for FDPCH (0-9). Number format. Whether compress mode is supported. 0 Not support compress mode 1 Support compress mode Number format. GPRS cell selection criterion. Number format. GPRS cell reselection criterion. Number format. 3G neighbour cell set. 1 Active Set 2 Sync Neighbour Set 3 Async Neighbour Set Rank of this cell as neighbour for inter-RAT cell reselection. Number format. TX power level for the UE. TDD or FDD mode. Physical cell ID E-UTRA frequency band (see 3GPP 36.101). EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 10 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual Number format. UL bandwidth. 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz 4 15MHz 5 20MHz Number format. DL bandwidth. 0 1.4MHz 1 3MHz 2 5MHz 3 10MHz 4 15MHz 5 20MHz Tracking area code (see 3GPP 23.003 Chapter 19.4.2.3). Reference signal received power (see 3GPP 36.214 Chapter 5.1.1). Reference signal received quality (see 3GPP 36.214 Chapter 5.1.2). The threshold of (in dB) used by the UE on the serving cells when reselecting towards a lower priority RAT/frequency. Number format. Carrier to noise ratio in dB = measured Ec/Io value in dB. 0 DPCH 1 FDPCH Destination number on which the call is to be deflected. Rx power value in 1/10 dBm resolution. Number format. Carrier to noise ratio in dB = measured Ec/Io value in dB. Receiver automatic gain control on the camped frequency. Inter-frequency cell suitable receive level. Cell reselection priority. Range: 0-7. Threshold to control non-intra-frequency searches. Cell selection parameter for the intra-frequency cell. LTE serving cell ID. This is the cell ID for the serving cell and can be found in the cell list. Range: 0-503. To be referenced when reselection. The suitable receive level value of an evaluated lower priority cell must be greater than this value. To be referenced when reselection. The suitable receive level value of an evaluated higher priority cell must be greater than this value. Reselection threshold for high priority layers. Reselection threshold for low priority layers. Bitmask that specifies whether a neighbor with a particular network color code is to be reported. Bit n set to 1 means that a neighbor with NCC n is to be included in the report. Base station identity code ID. Reselection threshold for high priority layers. Reselection threshold for low priority layers. EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 11 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual Absolute power level of the common pilot channel as received by the UE in dBm×10. Ratio of the received energy per PN chip for the common pilot channel to the total received power spectral density at the UE antenna connector in dB×10. EARFCN. Active channel of the current system. NOTE If '-' or – is returned, it indicates the parameter is invalid under current condition. Example AT+QENG='servingcell' +QENG: 'servingcell','SEARCH' OK AT+QENG='servingcell' +QENG:'servingcell','LIMSRV','GSM',460,01,5504,2B55,52,123,0,-67,5,14,64,30,28,0,-,-,-,-,-,-,-,-,-,' -' OK AT+QENG='servingcell' +QENG:'servingcell','NOCONN','GSM',460,01,5504,2B55,52,123,0,-111,5,14,64,0,0,0,-,-,-,-,-,-,-,-,-, '-' OK AT+QENG='servingcell' +QENG:'servingcell','CONNECT','GSM',460,00,550A,2BB9,23,94,0,-61,5,14,4,0,0,0,h,1,0,0,33,50, 52,0,0,'EFR' OK AT +QENG='neighbourcell' [2016-08-15_20:23:32]+QENG: 'neighbourcell intra','LTE',38950,276,-3,-88,-65,0,37,7,16,6,44 [2016-08-15_20:23:32]+QENG: 'neighbourcell inter','LTE',39148,-,-,-,-,-,37,0,30,7,-,-,-,[2016-08-15_20:23:32]+QENG: 'neighbourcell inter','LTE',37900,-,-,-,-,-,0,0,30,6,-,-,-,[2016-08-15_20:23:32]+QENG: 'neighbourcell','GSM',0,3,14,50,255,0,0,-1920,0 [2016-08-15_20:23:32]+QENG: 'neighbourcell','GSM',94,3,14,50,255,0,0,-1920,0 [2016-08-15_20:23:32]+QENG: 'neighbourcell','GSM',93,3,14,50,255,0,0,-1920,0 [2016-08-15_20:23:32]+QENG: 'neighbourcell','GSM',91,3,14,50,255,0,0,-1920,0 [2016-08-15_20:23:32]+QENG: 'neighbourcell','GSM',90,3,14,50,255,0,0,-1920,0 [2016-08-15_20:23:32]+QENG: 'neighbourcell','GSM',89,3,14,50,255,0,0,-1920,0 [2016-08-15_20:23:32]+QENG: 'neighbourcell','GSM',87,3,14,50,255,0,0,-1920,0 [2016-08-15_20:23:32]+QENG: 'neighbourcell','GSM',85,3,14,50,255,0,0,-1920,0 EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 12 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual OK AT+QENG='neighbourcell' [2016-08-15_20:19:54]+QENG: 'neighbourcell','WCDMA',10713,-723,398,-880,-155,6,-32768,[2016-08-15_20:19:54]+QENG: 'neighbourcell','WCDMA',10713,-723,331,-870,-155,2,-32768,[2016-08-15_20:19:54]+QENG: 'neighbourcell','WCDMA',10713,-723,290,-880,-165,2,-32768,[2016-08-15_20:19:54]+QENG: 'neighbourcell','WCDMA',10713,-723,397,-910,-190,2,-32768,[2016-08-15_20:19:54]+QENG: 'neighbourcell','WCDMA',10713,-723,114,-910,-195,2,-32768,[2016-08-15_20:19:54]+QENG: 'neighbourcell','WCDMA',10713,-723,332,-940,-220,2,-32768,[2016-08-15_20:19:54]+QENG: 'neighbourcell','WCDMA',10713,-723,379,-950,-230,2,-32768,[2016-08-15_20:19:54]+QENG: 'neighbourcell','WCDMA',10713,-723,115,-1210,-250,6,-32768,- OK AT+QENG='3gcomm' //Get common information when in WCDMA mode +QENG:'3gcomm','servingcell','3G','NOCONN',460,01,D5D6,8062AF1,10713,38,-72,-74,11,25,32 +QENG: '3gcomm','neighbourcell','3G',460,01,D5D6,8062AEF,10713,36,-87,-87,36,0,27 +QENG: '3gcomm','neighbourcell','2G',123,52,-98,12,-5 OK EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 13 / 15 LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual 3 Appendix A Reference Table 1: Terms and Abbreviations Abbreviation ARFCN CCH CDMA DCS DL DPCH EARFCN E-UTRA E-UTRA-ARFCN FDPCH GPRS GSM HDR LTE MS NCC PCS PLMN PN Description Absolute Radio Frequency Channel Number Common Transport Channel Code Division Multiple Access Digital Cellular System Downlink Dedicated Physical Channel E-UTRA Absolute Radio Frequency Channel Number Evolved Universal Terrestrial Radio Access E-UTRA Absolute Radio Frequency Code Number Fractional DPCH General Packet Radio Service Global System of Mobile Communication High Data Rate Long-Term Evolution Mobile Station Network Color Code Personal Communication Service Public Land Mobile Network Pseudorandom Noise EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 14 / 15 RX SINR SRLTE TD-SCDMA TX UE UL UMTS UTRA-ARFCN WCDMA LTE Module Series EC2x&EG9x&EM05 QuecCell AT Commands Manual Receive Signal To Interference Plus Noise Ratio Single Radio LTE Time Division - Synchronous Code Division Multiple Access Transmit User Equipment Uplink Universal Mobile Telecommunications Service UTRA Absolute Radio Frequency Channel Number Wideband Code Division Multiple Access EC2x&EG9x&EM05_QuecCell_AT_Commands_Manual 15 / 15

M26 AT 命令手册 GSM/GPRS 系列 版本：M26_AT 命令手册_V1.1 日期：2015-08-31 www.quectel.com M26 AT 命令手册 移远公司始终以为客户提供最及时、最全面的服务为宗旨，如需任何帮助，请随时联系我司上海总部，联 系方式如下： 上海移远通信技术有限公司 上海市徐汇区田州路 99 号 13 幢 501 室 邮箱: info@quectel.com 电话:+86 21 51086236 或联系我司当地办事处，详情请登录： http://www.quectel.com/support/salesupport.aspx 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/support/techsupport.aspx Or Email: Support@quectel.com l 前言 te 移远公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规范，参数来设计其产品。 c l 由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未声明前，移远公司有权对 该文档规范进行更新。 ue tia 版权申明 本文档手册版权属于移远公司，任何人未经我公司复制转载该文档将承担法律责任。 Q en 版权所有 ©上海移远通信技术有限公司 2015，保留一切权利。 Confid Copyright © Quectel Wireless Solutions Co., Ltd. 2015 上海移远通信技术有限公司 1 / 256 M26 AT 命令手册 文档历史 修订记录 版本 1.0 1.1 日期 2014-09-05 CQouneficdteenl tial 2015-08-31 作者 王淑娟 王淑娟 变更表述 初始版本 1. 新增指令： AT+QEAUART/AT+QSEDCB/AT+QSIMDET/AT+QSIMSTAT/ AT+CSIM/AT+QADC/AT+CCID/AT+QCFG='RFTXburst'/ AT+QREFUSECS/AT+QVBATT 2. 更新指令：  更新 ATH/+++/AT+CPBW/AT+COPS/AT+CBC 命令备注 说明  增加 AT+QTDMOD/AT+QSCLK/AT+QINDI 参数  更新 AT+CSCS/AT+ICF/AT+IFC/AT+CGQREQ/ AT+QINDI/AT+CLIP/AT+COLP/AT+VTS/AT+CMUT/ AT+QSIDET/AT+QLTONE/AT+QSCLK 描述 3. 删除指令：AT+DR/AT+DS 上海移远通信技术有限公司 2 / 256 M26 AT 命令手册 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 9 1 引言 ...................................................................................................................................................... 10 1.1. 本章概要 ................................................................................................................................ 10 1.2. AT 命令术语缩写和惯例......................................................................................................... 10 1.3. AT 命令语法 ........................................................................................................................... 10 1.3.1. AT 命令类型.................................................................................................................... 11 1.3.2. AT 命令连写.................................................................................................................... 11 2 1.4. 支持的字符集 ......................................................................................................................... 12 1.5. 流控简介 ................................................................................................................................ 12 1.5.1. 软件流控 ......................................................................................................................... 12 1.5.2. 硬件流控 ......................................................................................................................... 13 l AT 命令详解 ......................................................................................................................................... 14 te 2.1. AT 命令格式 .......................................................................................................................... 14 2.2. ATI 显示产品 ID 信息 ............................................................................................................ 14 c l 2.3. AT+GMI 请求制造商 ID 信息................................................................................................. 15 ue tia 2.4. AT+GMM 请求 TA 制造商和型号信息...................................................................................15 2.5. AT+GMR 请求 TA 软件版本信息........................................................................................... 16 2.6. AT+GOI 请求全球目标识别 ID .............................................................................................. 16 Q n 2.7. AT+CGMI 请求制造商 ID 信息 .............................................................................................. 17 2.8. AT+CGMM 请求 TA 制造商和型号信息 ................................................................................ 17 e 2.9. AT+CGMR 请求 TA 软件版本信息 ........................................................................................ 18 2.10. AT+GSN 请求 TA 序列号（IMEI） ....................................................................................... 19 fid 2.11. AT+CGSN 请求 TA 序列号（IMEI）..................................................................................... 19 2.12. AT+QGSN 请求 TA 序列号（IMEI）..................................................................................... 20 2.13. AT&F 设置所有 TA 参数为出厂配置...................................................................................... 21 n 2.14. AT&V 显示当前配置 .............................................................................................................. 22 o 2.15. AT&W 保存用户配置参数...................................................................................................... 22 2.16. ATQ 设置结果码显示模式 ..................................................................................................... 23 C 2.17. ATV 设置 TA 响应返回内容格式............................................................................................ 24 2.18. ATX 设置 CONNECT 结果码格式和检测呼叫进程 ............................................................... 25 2.19. ATZ 复位为缺省配置 ............................................................................................................. 25 2.20. AT+CFUN 设置模块功能....................................................................................................... 26 2.21. AT+QPOWD 关机 ................................................................................................................. 28 2.22. AT+CMEE 上报移动设备错误 ............................................................................................... 28 2.23. AT+CSCS 选择 TE 字符集.................................................................................................... 30 2.24. AT+GCAP 请求 TA 功能列表 ................................................................................................ 31 3 串行接口控制命令 ................................................................................................................................ 32 3.1. AT&C 设置 DCD 功能模式 .................................................................................................... 32 上海移远通信技术有限公司 3 / 256 M26 AT 命令手册 3.2. AT&D 设置 DTR 功能模式 .................................................................................................... 32 3.3. AT+ICF 设置 TE-TA 帧格式 .................................................................................................. 33 3.4. AT+IFC 设置 TE-TA 流控 ...................................................................................................... 34 3.5. AT+ILRR 设置本地速率报告 ................................................................................................. 35 3.6. AT+IPR 设置 TE-TA 波特率 .................................................................................................. 36 3.6.1. 自适应波特率.................................................................................................................. 37 3.6.1.1. 自适应波特率操作限制 ...................................................................................... 38 3.6.1.2. 自适应波特率和 MUX ........................................................................................ 38 3.6.1.3. 自适应波特率和 windows 调制解调器 ............................................................... 38 3.7. AT+CMUX 多路复用 ............................................................................................................. 38 3.8. AT+QEAUART 开启双串口功能............................................................................................ 40 3.9. AT+QSEDCB 配置双串口的参数 .......................................................................................... 41 4 5 状态控制命令........................................................................................................................................ 43 4.1. AT+CEER 上报移动设备错误 ............................................................................................... 43 4.2. AT+CPAS 模块活动状态 ....................................................................................................... 44 4.3. AT+QINDRI 开启关闭 RI 引脚提示 ....................................................................................... 45 l 4.4. AT+QMOSTAT 开启或关闭去电呼叫状态报告...................................................................... 46 te 4.5. AT+QREFUSECS 开启或关闭来短信和来电拒接功能 ......................................................... 47 4.6. AT+QIURC 初始化完成提示上报 .......................................................................................... 48 c l 4.7. AT+QEXTUNSOL 开启关闭专有 URC 上报 ......................................................................... 48 4.8. AT+QINISTAT 初始化状态查询............................................................................................. 50 ue tia 4.9. AT+QNSTATUS 查询 GSM 网络状态 ...................................................................................50 4.10. AT+QNITZ 同步网络时间...................................................................................................... 51 4.11. AT+QLTS 获取最近一次的网络同步时间 .............................................................................. 52 Q n 4.12. AT+CTZU 网络时间同步以及更新 RTC 时间........................................................................ 53 4.13. AT+CTZR 网络时间同步上报................................................................................................ 54 e 4.14. AT+QSIMDET 开启或关闭 SIM 卡检测功能 ......................................................................... 54 fid 4.15. AT+QSIMSTAT SIM 卡插拔状态报告.................................................................................. 56 4.16. AT+QCGTIND 语音/数据呼叫结束提示 ................................................................................ 57 SIM 卡相关命令.................................................................................................................................... 59 n 5.1. AT+CIMI 请求国际移动台设备标识（IMSI） ........................................................................ 59 5.2. AT+CLCK 设备锁定 .............................................................................................................. 59 o 5.3. AT+CPIN 输入 PIN................................................................................................................ 61 C 5.4. AT+CPWD 设备锁定............................................................................................................. 63 5.5. AT+CRSM SIM 卡接入限制 ................................................................................................ 64 5.6. AT+CSIM 通用 SIM 操作..................................................................................................... 65 5.7. AT+QCSPWD 更改 PS 超级密码.......................................................................................... 66 5.8. AT+CCID 显示 CCID............................................................................................................. 67 5.9. AT+QCCID 显示 CCID.......................................................................................................... 67 5.10. AT+QGID 获取 SIM 卡 GID................................................................................................... 68 5.11. AT+QSIMVOL 固定 SIM 卡工作电压 .................................................................................... 69 5.12. AT+QSPN 读取 SIM 卡服务运营商名称 ............................................................................... 69 5.13. AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数....................................................................... 70 上海移远通信技术有限公司 4 / 256 M26 AT 命令手册 6 网络服务命令........................................................................................................................................ 71 6.1. AT+COPS 选择营运商 .......................................................................................................... 71 6.2. AT+CREG 网络注册信息 ....................................................................................................... 72 6.3. AT+CSQ 信号质量 ................................................................................................................ 74 6.4. AT+CPOL 优选运营商列表 ................................................................................................... 75 6.5. AT+COPN 查询运营商列表 .................................................................................................. 76 6.6. AT+QBAND 查询运营商列表 ................................................................................................ 76 6.7. AT+QENG 开启或关闭工程模式 ........................................................................................... 77 6.8. AT+QSCANF GSM 频率功率扫描 ...................................................................................... 80 6.9. AT+QLOCKF 锁 GSM 频率 .................................................................................................. 81 7 呼叫控制命令........................................................................................................................................ 83 7.1. ATA 呼叫应答 ........................................................................................................................ 83 8 7.2. 7.3. 7.4. 7.5. l 7.6. te 7.7. 7.8. c l 7.9. 7.10. ue tia 7.11. 7.12. 7.13. Q n 7.14. 7.15. e 7.16. fid 7.17. 7.18. 7.19. 7.20. n 7.21. o 7.22. ATD 移动台呼叫某一号码 ..................................................................................................... 84 ATH 挂机控制 ....................................................................................................................... 85 +++ 数据模式切换至命令模式............................................................................................... 86 ATO 命令模式切换至数据模式.............................................................................................. 86 ATP 选择脉冲拨号 ................................................................................................................ 87 ATS0 自动应答前振铃次数 ................................................................................................... 88 ATS6 盲拨号前暂停控制 ....................................................................................................... 89 ATS7 等待呼叫建立完成时间................................................................................................ 89 ATS8 暂停拨号时间 .............................................................................................................. 90 ATS10 挂机延时.................................................................................................................... 91 ATT 音频拨号 ........................................................................................................................ 91 AT+CSTA 选择地址类型 ....................................................................................................... 92 AT+CLCC 查询当前呼叫....................................................................................................... 92 AT+CR 业务上报控制 ........................................................................................................... 94 AT+CRC 蜂窝结果码 ............................................................................................................ 95 AT+CRLP 无线链路协议 ....................................................................................................... 96 AT+CSNS 单一编码方案....................................................................................................... 97 AT+CMOD 呼叫模式............................................................................................................. 97 AT+QSFR 配置语音编码模式 ............................................................................................... 98 AT+QSPCH 语音信道类型上报 ............................................................................................ 99 AT+QDISH ATH 使能控制................................................................................................. 100 C 短消息相关命令 .................................................................................................................................. 102 8.1. AT+CSMS 选择短消息业务 ................................................................................................ 102 8.2. AT+CMGF 配置短消息模式 ................................................................................................ 103 8.3. AT+CSCA 短消息服务中心地址.......................................................................................... 103 8.4. AT+CPMS 选择短消息存储器 ............................................................................................. 105 8.5. AT+CMGD 删除短消息 ....................................................................................................... 106 8.6. AT+CMGL 列出优选短消息存储器中的短消息 ................................................................... 107 8.7. AT+CMGR 读取短消息 ....................................................................................................... 110 8.8. AT+CMGS 发送短消息 ....................................................................................................... 113 8.9. AT+CMGW 写短消息 .......................................................................................................... 115 上海移远通信技术有限公司 5 / 256 M26 AT 命令手册 8.10. 8.11. 8.12. 8.13. 8.14. 8.15. 8.16. 8.17. 8.18. 8.19. 8.20. AT+CMSS 从存储器发送短消息 ......................................................................................... 116 AT+CMGC 发送短消息命令 ................................................................................................ 118 AT+CNMI 新短消息指示 ..................................................................................................... 119 AT+CRES 恢复 SMS 设置 .................................................................................................. 121 AT+CSAS 保存 SMS 设置 .................................................................................................. 122 AT+CSCB 选择小区广播消息类型 ...................................................................................... 122 AT+CSDH 显示文本格式参数 ............................................................................................. 123 AT+CSMP 设置文本格式参数 ............................................................................................. 124 AT+QCLASS0 接收 Class0 短信存储到当前存储器 ........................................................... 125 AT+QMGDA 删除指定类型的所有短信 ............................................................................... 127 AT+QSMSCODE 配置短消息字符集 .................................................................................. 128 9 电话本相关命令 .................................................................................................................................. 129 10 11 9.1. AT+CPBS 选择电话簿存储单元.......................................................................................... 129 9.2. AT+CPBW 写删电话簿记录 ................................................................................................ 130 9.3. AT+CPBR 查询电话簿记录 ................................................................................................. 131 9.4. AT+CPBF 查找电话簿记录 ................................................................................................. 133 l 9.5. AT+CNUM 用户号码 ........................................................................................................... 134 te GPRS 相关命令.................................................................................................................................. 135 10.1. AT+CGATT GPRS 附着和分离 ......................................................................................... 135 c l 10.2. AT+CGDCONT 定义 PDP 上下文....................................................................................... 136 ue tia 10.3. AT+CGQREQ 请求的服务质量...........................................................................................137 10.4. AT+CGQMIN 可接受的最小服务质量 ................................................................................. 138 10.5. AT+CGACT PDP 上下文激活和去激活............................................................................. 139 10.6. AT+CGDATA 进入数据模式 ................................................................................................ 140 Q n 10.7. AT+CGPADDR 显示 PDP 地址........................................................................................... 141 e 10.8. AT+CGCLASS GPRS 移动台类别.................................................................................... 142 10.9. AT+CGEREP 非请求 GPRS 事件上报控制 ........................................................................ 143 fid 10.10. AT+CGREG GPRS 网络注册状态 ....................................................................................144 10.11. AT+CGSMS 为 MO SMS 选择业务 .................................................................................... 145 10.12. AT+QGPCLASS 配置 GPRS 多时隙级别........................................................................... 146 n TCPIP 相关命令 ................................................................................................................................. 147 o 11.1. AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 ............................................................... 147 11.2. AT+QISEND 发送 TCP 或 UDP 数据.................................................................................. 148 C 11.3. AT+QICLOSE 关闭 TCP 或 UDP 连接 ............................................................................... 149 11.4. AT+QIDEACT 关闭 GPRS/CSD PDP 场景 ........................................................................ 151 11.5. AT+QILPORT 配置本地端口号 ........................................................................................... 151 11.6. AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码 ........................................... 152 11.7. AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） .............................................. 153 11.8. AT+QILOCIP 获取本地 IP 地址........................................................................................... 154 11.9. AT+QISTAT 查询当前连接状态........................................................................................... 154 11.10. AT+QISTATE 查询当前接入的连接状态 ............................................................................. 156 11.11. AT+QISSTAT 查询当前 Server 状态 ................................................................................... 157 11.12. AT+QIDNSCFG 配置域名服务器 DNS ............................................................................... 158 上海移远通信技术有限公司 6 / 256 M26 AT 命令手册 11.13. AT+QIDNSGIP 域名解析 .................................................................................................... 159 11.14. AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 ............................................................. 160 11.15. AT+QIHEAD 配置接收数据时是否显示 IP 头...................................................................... 160 11.16. AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 .............................................................. 161 11.17. AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' .............................................. 162 11.18. AT+QISERVER 配置为服务器 ............................................................................................ 163 11.19. AT+QICSGP 设置 CSD 或 GPRS 连接模式 ....................................................................... 164 11.20. AT+QISRVC 选择当前可操作连接...................................................................................... 165 11.21. AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号............................... 166 11.22. AT+QISCON 保存 TCPIP 应用场景配置 ............................................................................ 166 11.23. AT+QIMODE 配置 TCPIP 应用模式 ................................................................................... 168 11.24. AT+QITCFG 配置透明传输模式.......................................................................................... 169 12 11.25. 11.26. 11.27. 11.28. l 11.29. 11.30. te 11.31. 11.32. c l 11.33. ue tia 11.34. AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议..................................................... 170 AT+QIMUX 控制是否启用多路连接 .................................................................................... 170 AT+QISHOWLA 控制是否显示本地 IP 地址 ....................................................................... 171 AT+QIFGCNT 配置前置场景 .............................................................................................. 172 AT+QISACK 查询发送数据信息.......................................................................................... 173 AT+QINDI 配置是否缓存接收到的数据............................................................................... 173 AT+QIRD 读取缓存的数据 .................................................................................................. 174 AT+QISDE 控制 AT+QISEND 是否允许数据回显 .............................................................. 175 AT+QPING PING 远程服务器........................................................................................... 176 AT+QNTP 通过网络时间服务器同步本地时间.................................................................... 177 补充业务命令...................................................................................................................................... 179 12.1. AT+CCFC 设置呼叫转移..................................................................................................... 179 Q n 12.2. AT+CCUG 封闭用户组........................................................................................................ 181 12.3. AT+CCWA 呼叫等待 ........................................................................................................... 181 e 12.4. AT+CHLD 呼叫保持和多方通话.......................................................................................... 183 fid 12.5. AT+CLIP 来电号码显示设置 ............................................................................................... 185 12.6. AT+QCLIP 配置来电是否显示主叫号码名称....................................................................... 186 12.7. AT+CLIR 主叫识别限制 ...................................................................................................... 187 12.8. AT+COLP 显示被叫识别..................................................................................................... 188 n 12.9. AT+QCOLP 显示+COLP 字符串名称 ................................................................................. 190 o 12.10. AT+CUSD 非结构化附加业务 ............................................................................................. 191 C 12.11. AT+CSSN 附加业务通知..................................................................................................... 192 13 音频控制命令...................................................................................................................................... 194 13.1. ATL 设置监听扬声器音量 .................................................................................................... 194 13.2. ATM 设置监听扬声器模式................................................................................................... 194 13.3. AT+VTD 配置 DTMF 音播放时长........................................................................................ 195 13.4. AT+VTS DTMF 音调发送 .................................................................................................. 196 13.5. AT+CALM 来电警报模式..................................................................................................... 197 13.6. AT+CRSL 来电音量等级 ..................................................................................................... 198 13.7. AT+CLVL 扬声器音量等级 .................................................................................................. 198 13.8. AT+CMUT 上行静音控制 .................................................................................................... 199 上海移远通信技术有限公司 7 / 256 M26 AT 命令手册 13.9. 13.10. 13.11. 13.12. 13.13. 13.14. 13.15. 13.16. 13.17. 13.18. AT+QSIDET 配置侧音增益等级 .......................................................................................... 200 AT+QMIC 配置麦克风增益等级 .......................................................................................... 201 AT+QLDTMF 产生本地 DTMF 音 ....................................................................................... 201 AT+QAUDCH 切换音频通道 ............................................................................................... 202 AT+QAUDLOOP 音频通道回环测试................................................................................... 203 AT+QLTONE 产生本地定制单音......................................................................................... 203 AT+QTONEP 配置 DTMF/TONE 输出路径 ........................................................................ 204 AT+QTDMOD 设置 DTMF 检测模式................................................................................... 205 AT+QTONEDET DTMF 检测 ............................................................................................ 206 AT+QWDTMF 通话中播放 DTMF 音 .................................................................................. 208 14 硬件相关命令...................................................................................................................................... 211 14.1. AT+CCLK 实时时钟 ............................................................................................................ 211 15 16 14.2. 14.3. 14.4. 14.5. l 14.6. te 14.7. AT+QALARM 闹铃设置....................................................................................................... 212 AT+CBC 查询电池电量和充电状态..................................................................................... 213 AT+QADC 读取 ADC .......................................................................................................... 214 AT+QSCLK 慢时钟配置 ...................................................................................................... 214 AT+QLEDMODE 网络指示灯配置 ...................................................................................... 215 AT+QVBATT 配置电压阈值 ................................................................................................ 216 其他命令 ............................................................................................................................................. 219 c l 15.1. A/ 重复上一条 AT 指令........................................................................................................ 219 ue tia 15.2. ATE 命令回显模式 ..............................................................................................................219 15.3. ATS3 配置命令行终止符 ..................................................................................................... 220 15.4. ATS4 设置响应格式字符 ..................................................................................................... 220 15.5. ATS5 配置命令行编辑字符 ................................................................................................. 221 Q n 15.6. AT+QRIMODE 设置 RI 时长 ............................................................................................... 222 e 15.7. AT+QCFG='RFTXburst' RF 突发信号指示 ......................................................................... 222 fid 附录 .................................................................................................................................................... 224 16.1. 参考文档 .............................................................................................................................. 224 16.2. 术语缩写 .............................................................................................................................. 224 16.3. AT&F 影响到的 AT 命令及参数............................................................................................ 225 n 16.4. AT&W 影响到的 AT 命令及参数........................................................................................... 227 o 16.5. ATZ 影响到的 AT 命令及参数 .............................................................................................. 230 16.6. AT&V 影响到的 AT 命令及参数............................................................................................ 232 C 16.7. ATV 影响到的 AT 命令及参数 .............................................................................................. 233 16.8. +CME ERROR 错误代码列表.............................................................................................. 234 16.9. +CMS ERROR 错误代码列表.............................................................................................. 237 16.10. 扩展错误报告列表................................................................................................................ 239 16.10.1. Location ID 扩展错误报告列表 ............................................................................. 239 16.10.2. 协议栈层（PS）错误列表 ..................................................................................... 240 16.10.3. MM 层内部错误列表.............................................................................................. 252 16.10.4. PPP/IP 栈错误列表 ............................................................................................... 253 16.11. URCs 说明列表.................................................................................................................... 254 上海移远通信技术有限公司 8 / 256 M26 AT 命令手册 表格索引 表 1：参考文档 ............................................................................................................................................... 224 表 2：术语缩写 ............................................................................................................................................... 224 表 3：AT&F 影响到的 AT 命令及参数 ............................................................................................................. 225 表 4：AT&W 影响到的 AT 命令参数列表 ........................................................................................................ 227 表 5：ATZ 影响到的 AT 命令参数列表 ............................................................................................................ 230 表 6：AT&V 显示当前配置信息....................................................................................................................... 232 表 7：ATV 内容格式对照表 ............................................................................................................................. 233 表 8：+CME ERROR 错误代码列表 ............................................................................................................... 234 表 9：+CMS ERROR 错误代码列表 ............................................................................................................... 237 表 10：LOCATION ID 扩展错误报告列表 ...................................................................................................... 239 表 11：协议栈层（PS）错误列表 ................................................................................................................... 240 表 12：MM 层内部错误列表............................................................................................................................ 252 表 13：PPP/IP 栈错误列表 ............................................................................................................................. 253 CQouneficdteenl tial 表 14：URCS 说明列表 .................................................................................................................................. 254 上海移远通信技术有限公司 9 / 256 M26 AT 命令手册 1 引言 1.1. 本章概要 该文档主要描述 M26 模块软件 AT 指令集及参数详解。 1.2. AT 命令术语缩写和惯例 tel 文档内提及的 GSM 模块包括移动设备 ME（Mobile Equipment）、移动台 MS（Mobile Station）、终端 适配器 TA（Terminal Adapter）、数据通信设备 DCE（Data Communication Equipment）和传真 FAX（包 c l 括传真 Modem 和传真板）。 ue tia 通过串口发送 AT 命令，即可使用 GSM 模块。串行线终端的应用设备包括终端设备 TE（Terminal Equipment）、数据终端设备 DTE（Data Terminal Equipment）或其他应用设备。这些终端或应用设备可能 运行在嵌入式系统内。 Q en 文档内涉及到的相关名词术语缩写都是基于 GSM 规范书写。 fid 1.3. AT 命令语法 n 文档内所有 AT 命令行必须以'AT'或'at'作为开头，以回车（）作为结尾。 Co 返回响应通常紧随命令之后，它的样式是''（）。AT 命令介绍过程中，只有被详细介绍，过程中被有意省 略了。 上海移远通信技术有限公司 10 / 256 M26 AT 命令手册 1.3.1. AT 命令类型 文档内所有 AT 命令类型有如下三种： 基础类命令：此类 AT 命令格式有'AT'或者'AT&'，其中''是命令自带，''是指 该命令支持一个或多个参数。例如：'ATE'，该命令用于关闭或使能回显功能，即 DCE 会依据''值 决定是否把接收的字符回显给 DTE。''是可选配参数，若没有被赋值，将使用默认值。 参数类命令：此类 AT 命令格式有'ATS=[]'，其中''是 S 寄存器的索引，''是赋予的参 数值。在该 AT 命令中，''是可选配参数，若没有被赋值，将使用默认值。 扩展类命令：通常来讲，扩展类命令根据操作格式及应用功能可分为几种类型，详见 2.1. AT 命令格式。 AT 命令语法说明：  方括号（[]）中的值为可缺省值； l  选配参数和必配参数必须在操作的参数范围内进行设置并按规定的顺序排列，各参数间必须使用 te 逗号隔开；  举例：AT+CPWD=,,，该命令用于为设备锁定 AT+CLCK 命令锁定义 c l 的设备锁定功能设置新的密码； ue tia  如果参数是字符串（例如：），则该字符串必须放在双引号中；  举例：'12345'，'CMNET'等，双引号中的各项符号可看作是字符串； Q n  命令的可选子参数或 TA 返回结果的可选部分位于方括号中； e  不使用双引号时，字符串中各字符间的空格可忽略不计；  实际操作中，,[]不必输入； fid  所有 AT 命令本身不区分大小写，但其参数对大小写敏感。 n 1.3.2. AT 命令连写 o 在需要连续执行多个 AT 命令时，必须等到上一条 AT 命令作了最终响应（例如：返回 OK，ERROR， C CME ERROR，CMS ERROR 等），才能继续操作下一条 AT 命令。该动作强烈建议执行。 上海移远通信技术有限公司 11 / 256 M26 AT 命令手册 1.4. 支持的字符集 GSM 模块 AT 命令接口默认使用 GSM 字符集，字符集可以通过'AT+CSCS'命令（GSM 07.07）进行 查询和配置。其支持的字符集如下：  GSM  UCS2  HEX  IRA  PCCP437  8859-1 字符集会影响短消息，广播消息的读取，编辑，发送和接收，电话簿、SIM 卡工具箱等字符串的输入 l 和显示。 cte l 1.5. 流控简介 ue tia 要保障 GSM 模块与 DTE 之间可靠通信，流控很重要。假若一次数据或传真呼叫过程中，发送端的数 据发送速度大于接收端的数据接收速度，若接收缓存接近满时，接收端应该有方法将发送端暂停发送，直 Q n 到它的数据传输速度重新赶上发送端数据发送速度或有缓存可使用，这就是流控。 e 通常来讲，有两种方法来实现流控。它们是软件流控和硬件流控。M26 模块两种流控功能都支持。在 客户应用中，尤其多路复用（AT+CMUX）过程中，建议选择硬件流控。 fid M26 默认流控关闭。 n 1.5.1. 软件流控 Co 软件流控发送不同的字符去暂停（XOFF，十进制 19）和恢复（XON，十进制 17）数据流。它适用于 仅仅有三根线的串口通信。 M26 默认的流控关闭。软件流控需要通过下面的 AT 命令进行配置： AT+IFC=1,1 由于该配置不自动保存，若希望重启后仍保持有效，需通过 AT&W 保存到用户配置表中。同时，确保 所使用的串口通讯工具（例如：超级终端）是否支持软件流控。 上海移远通信技术有限公司 12 / 256 M26 AT 命令手册 备注 当有二进制数据发送或接收时，软件流控不应该被采用。因为 DTE 可能把二进制数据当做软件流控字符。 1.5.2. 硬件流控 M26 默认流控关闭，如果要使用硬件（RTS/CTS）流控，需要通过下面的 AT 命令进行配置： AT+IFC=2,2 该配置不支持自动保存，若希望重启后有效，则需要设置 AT+IFC=2, 2 后执行 AT&W 进行保存。 硬件流控通过 RTS/CTS 信号来实现。当接收缓存快满的时候，模块把 CTS 信号设置为无效，数据传 CQouneficdteenl tial 输被暂停。当模块的接收缓存可以接收更多数据时，CTS信号被重新设置为有效。 上海移远通信技术有限公司 13 / 256 M26 AT 命令手册 2 AT 命令详解 2.1. AT 命令格式 测试命令 AT+=? 该命令用于查询设置命令或内部程序设置的参数及其参数值范围 查询命令 配置命令 l 执行命令 AT+? AT+= AT+ 该命令用于查询参数的当前值 该命令用于设置用户自定义的参数值 该命令用于读出 GSM 模块内部程序所控制的不可变参数 cte l 2.2. ATI 显示产品 ID 信息 ue tia 该命令用于显示产品 ID 信息，TA 上报一行或多行制造商信息及软件版本信息。 Q n 语法 e ATI 显示产品 ID 信息 fid 执行命令 n ATI 响应 Quectel_Ltd Quectel_M26 Revision: M26FAR01A01 Co 最大响应时间 OK 300ms 参考 V.25ter 上海移远通信技术有限公司 14 / 256 M26 AT 命令手册 2.3. AT+GMI 请求制造商 ID 信息 该命令用于请求制造商 ID 信息，TA 上报一行或多行让用户识别 TA 制造商的文本信息。 语法 AT+GMI 请求制造商 ID 信息 测试命令 响应 AT+GMI=? OK 执行命令 响应 AT+GMI Quectel_Ltd l 最大响应时间 te 参考 V.25ter Quectel_M26 Revision: MTK 0828 OK 300ms uec tial 2.4. AT+GMM 请求 TA 制造商和型号信息 Q n 该命令用于请求 TA 制造商和型号信息，TA 上报一行或多行设备制造商和型号的信息。 e 语法 fid AT+GMM 请求 TA 制造商和型号信息 测试命令 响应 n AT+GMM=? OK o 执行命令 响应 C AT+GMM Quectel_M26 最大响应时间 参考 V.25ter OK 300ms 上海移远通信技术有限公司 15 / 256 M26 AT 命令手册 2.5. AT+GMR 请求 TA 软件版本信息 该命令用于请求 TA 软件版本信息，TA 上报一行或多行软件版本信息。 语法 AT+GMR 请求 TA 软件版本信息 测试命令 响应 AT+GMR=? OK 执行命令 响应 AT+GMR Revision: M26FAR01A01 最大响应时间 参考 l V.25ter OK 300ms cte l 2.6. AT+GOI 请求全球目标识别 ID ue tia 该命令用于请求全球目标识别 ID，TA 上报一行或多行设备标识信息（该设备基于 ISO 系统注册的唯 Q n 一设备标识）。 e 语法 fid AT+GOI 请求全球目标识别 ID 测试命令 响应 AT+GOI=? OK n 执行命令 响应 o AT+GOI M26 C OK 最大响应时间 300ms 参考 V.25ter 上海移远通信技术有限公司 16 / 256 M26 AT 命令手册 2.7. AT+CGMI 请求制造商 ID 信息 该命令用于请求制造商 ID 信息，TA 上报一行或多行让用户识别 TA 制造商的文本信息。 语法 AT+CGMI 请求制造商 ID 信息 测试命令 响应 AT+CGMI=? OK 执行命令 响应 AT+CGMI Quectel_Ltd l 最大响应时间 te 参考 GSM07.07 uec tial 备注 功能同 AT+GMI。 Quectel_M26 Revision: MTK 0828 OK 300ms Q fiden 2.8. AT+CGMM 请求 TA 制造商和型号信息 该命令用于请求 TA 制造商和型号信息，TA 上报一行或多行设备制造商和型号的信息。 on 语法 C AT+CGMM 请求 TA 制造商和型号信息 测试命令 响应 AT+CGMM=? OK 执行命令 响应 AT+CGMM Quectel_M26 最大响应时间 OK 300ms 上海移远通信技术有限公司 17 / 256 参考 GSM07.07 备注 功能同 AT+GMM。 M26 AT 命令手册 2.9. AT+CGMR 请求 TA 软件版本信息 该命令用于请求 TA 软件版本信息，TA 上报一行或多行软件版本信息。 语法 l AT+CGMR 请求 TA 软件版本信息 测试命令 te AT+CGMR=? c l 执行命令 AT+CGMR 响应 OK 响应 Revision: M26FAR01A01 ue tia 最大响应时间 Q n 参考 e GSM07.07 OK 300ms fid 备注 Con 功能同 AT+GMR。 上海移远通信技术有限公司 18 / 256 M26 AT 命令手册 2.10. AT+GSN 请求 TA 序列号（IMEI） 该命令用于请求 TA 序列号，TA 上报 ME 设备的 IMEI 号（国际移动台设备识别码）。 语法 AT+GSN 请求 TA 序列号（IMEI） 测试命令 响应 AT+GSN=? OK 执行命令 响应 AT+GSN 最大响应时间 参考 l GSM07.07 OK 300ms cte l 参数 ue tia IMEI 号（国际移动台设备识别码） Q n 备注 e 每台 ME 设备的序列号（IMEI）不同。 nfid 2.11. AT+CGSN 请求 TA 序列号（IMEI） Co 该命令用于请求 TA 序列号，TA 上报 ME 设备的 IMEI 号（国际移动台设备识别码）。 语法 AT+CGSN 请求 TA 序列号（IMEI） 测试命令 AT+CGSN=? 响应 OK 执行命令 AT+CGSN 响应 上海移远通信技术有限公司 19 / 256 最大响应时间 参考 GSM07.07 OK 300ms 参数 IMEI 号（国际移动台设备识别码） M26 AT 命令手册 备注 1. 每台 ME 设备的序列号（IMEI）不同； 2. 功能同 AT+GSN。 tel 2.12. AT+QGSN 请求 TA 序列号（IMEI） uec tial 该命令用于请求 TA 序列号，TA 上报 ME 设备的 IMEI 号（国际移动台设备识别码）。 语法 Q n AT+QGSN 请求 TA 序列号（IMEI） e 测试命令 响应 AT+QGSN=? OK fid 执行命令 响应 AT+QGSN +QGSN: 'sn' on 最大响应时间 C 参考 OK 300ms Quectel 参数 'sn' IMEI 号（国际移动台设备识别码） 上海移远通信技术有限公司 20 / 256 备注 1. 每台 ME 设备的序列号（IMEI）不同； 2. 功能同 AT+GSN 和 AT+CGSN。 M26 AT 命令手册 2.13. AT&F 设置所有 TA 参数为出厂配置 该命令可把 TA 部分配置当前参数设置为制造商的默认配置。所有 GPRS 相关应用参数配置不被 AT&F 影响。 语法 AT&F 设置所有 TA 参数为出厂配置 执行命令 响应 l AT&F[] OK te 最大响应时间 参考 c l V.25ter 300ms ue tia 参数 Q n 数字参数 0 返回当前配置参数及参数值 fide 备注 1. 所有相关参数恢复制造商默认配置，可见表 3： AT&F 影响到的 AT 命令及参数； n 2. AT&F 操作影响的部分参数可以通过 AT&W 进行保存，ATZ 恢复为缺省配置； 3. 可通过 AT&W 保存 AT&F 恢复出厂默认配置，见表 4：AT&W 影响到的 AT 命令及参数； o 4. 可通过 ATZ 恢复 AT&F 部分对应参数所保存的配置，见表 5：ATZ 影响到的 AT 命令及参数； C 5. 必须在模块处于空闲状态方可进行 AT&F 操作。 上海移远通信技术有限公司 21 / 256 M26 AT 命令手册 2.14. AT&V 显示当前配置 语法 AT&V 显示当前配置 执行命令 AT&V[] 响应 ACTIVE PROFILE …（参考表 6 AT&V 显示当前配置信息） OK 最大响应时间 300ms 参考 V.25ter l 参数 te 数字参数 0 返回当前配置参数及参数值 uec tial 详情请见附录A表6。 Q n 2.15. AT&W 保存用户配置参数 fide 该命令将用户设置的一些命令参数保存到非易失性存储器内。 语法 n AT&W 保存用户配置参数 o 执行命令 响应 C AT&W[] OK 最大响应时间 300ms 参考 V.25ter 参数 0 保存到用户当前配置表内 上海移远通信技术有限公司 22 / 256 M26 AT 命令手册 备注 1. AT&W 将用户配置在重启 TA 之后保持有效； 2. 通过 AT&F 恢复 AT&W 部分对应参数的出厂默认配置； 3. 可通过 ATZ 恢复 AT&W 部分对应参数所保存的配置； 4. 必须在模块处于空闲状态方可进行 AT&W 操作； 5. AT&W 章节列举的 AT 命令，若希望模块重启后其参数保持不变，都需要通过 AT&W 保存，而 V.25， 07.05，07.07 和 GPRS 中其他大多数 AT 命令会自动保存参数，即配置后重启参数不变。 2.16. ATQ 设置结果码显示模式 该命令用于设置 TA 是否向 TE 发送结果码。 语法 l ATQ 设置结果码显示模式 te 执行命令 ATQ[] uec tial 最大响应时间 Q n 参考 V.25ter 响应 当 =0，返回： OK 当=1，返回： (none) 300ms fide 参数 数字参数 n 0 向 TE 发送结果码 Co 1 结果码被抑制，不发送结果码至 TE 备注 1. 该设置不会影响响应内的内容； 2. ATQ 不带参数设置时参数默认值为 0。 上海移远通信技术有限公司 23 / 256 M26 AT 命令手册 2.17. ATV 设置 TA 响应返回内容格式 该命令用于设置结果码和返回结果的传送格式（数字格式或字符格式），并设置头部和尾部的内容，这 些内容是与结果码和返回结果信息一起发送。 语法 ATV 设置 TA 响应返回内容格式 执行命令 响应 ATV[] 当=0，返回： 0 当=1，返回： 最大响应时间 参考 l V.25ter OK 300ms te 参数 uec tial 0 Q n 1 信息返回结果： 结果码： 信息返回结果： 结果码： e 备注 fid 设置 ATV0 后，返回信息（如举例中的+CSQ: 30,0）前没有回车换行，返回的结果码 OK 变成了数字 0。 n 举例 Co ATV1 OK AT+CSQ +CSQ: 30, 0 OK ATV0 0 AT+CSQ +CSQ: 30, 0 上海移远通信技术有限公司 24 / 256 0 详情请见附录 A 表 7。 M26 AT 命令手册 2.18. ATX 设置 CONNECT 结果码格式和检测呼叫进程 使用该命令，可设置 TA 是否向 TE 发送某一个特定的结果码。 语法 ATX 设置 CONNECT 结果码格式和检测呼叫进程 执行命令 响应 ATX[] OK 最大响应时间 l 参考 te V.25ter 300ms c l 参数 Que entia 0 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均禁用 1 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均禁用 2 进入在线数据状态时即给定连接结果码。遇忙检测禁用，可启用拨号音 3 进入在线数据状态时即给定连接结果码。拨号音检测禁用，但可启用遇忙检测 4 进入在线数据状态时即给定连接结果码。拨号音和遇忙检测均可启用（AT&F） fid 备注 n 1. ATX 不带参数设置时参数默认值为 0； Co 2. AT&F 恢复出厂设置参数值为 4。 2.19. ATZ 复位为缺省配置 语法 ATZ 复位为缺省配置 执行命令 响应 ATZ[] OK 上海移远通信技术有限公司 25 / 256 最大响应时间 参考 V.25ter 参数 0 300ms 返回当前配置参数及参数值 M26 AT 命令手册 备注 1. 所有相关参数恢复制造商默认配置； 2. AT&F 操作影响的部分参数可以通过 AT&W 进行保存，ATZ 恢复为缺省配置； 3. 必须在模块处于空闲状态方可进行 ATZ 操作。 tel 2.20. AT+CFUN 设置模块功能 c l 该命令是用来切换模块各功能模式。可用来重启 ME 或将模块在全功能，最小功能，关闭射频电路的 ue tia 接收和发送等模式切换。 语法 Q n AT+CFUN 设置模块功能 e 测试命令 fid AT+CFUN=? 响应 +CFUN: (取值列表), (取值列表) n 查询命令 AT+CFUN? OK 响应 +CFUN: Co OK 配置命令 响应 AT+CFUN=[,] OK ERROR +CME ERROR: 最大响应时间 15s，受网络状态影响. 参考 GSM07.07 上海移远通信技术有限公司 26 / 256 M26 AT 命令手册 参数 0 1 4 0 1 最小功能模式 全功能模式（默认） 关闭射频电路的接收和发送功能模式 在设置功能等级后，不复位立即有效 在设置功能等级后，模块复位有效 备注 1. 为 1 是模块会进行复位动作，此时 GSM，GPRS 网络会注销启动后重新注册； 2. 该命令操作只能在模块处于空闲状态下操作，不然会导致其他功能操作异常。 举例 举例一：设置模块最小功能模式。该命令首先注销网络，之后取消激活 SIM 卡 l AT+CFUN=0 te +CPIN: NOT READY c l OK AT+COPS? ue tia +COPS:0 //无网络 OK Q n AT+CPIN? +CME ERROR: 13 //SIM 卡读取失败 fide 举例二：设置模块全功能模式。该命令首先激活 SIM 卡，之后注册网络 AT+CFUN=1 OK n +CPIN: SIM PIN o AT+CPIN=1234 C +CPIN: READY OK AT+CPIN? +CPIN: READY OK AT+COPS? +COPS: 0,0,'CHINA MOBILE' //注册上网络 OK 上海移远通信技术有限公司 27 / 256 M26 AT 命令手册 2.21. AT+QPOWD 关机 语法 AT+QPOWD 关机 配置命令 当=1 时，返回： AT+QPOWD= NORMAL POWER DOWN 当=0 时，返回： OK 最大响应时间 300ms 参考 Quectel 参数 tel 0 立即关机 1 正常关机 c l 备注 ue tia 该命令操作只能在模块处于空闲状态下操作，不然会导致其他功能操作异常。 Q en 举例 AT+QPOWD=1 fid NORMAL POWER DOWN AT+QPOWD=0 Con OK //模块正常关机提示 NORMAL POWER DOWN //模块立即关机 2.22. AT+CMEE 上报移动设备错误 该命令用于启用或禁用+CME ERROR: 或+CMS ERROR: 结果码。用于指示与 ME 功能相关的错误。 上海移远通信技术有限公司 28 / 256 M26 AT 命令手册 语法 AT+CMEE 上报移动设备错误 测试命令 AT+CMEE=? 响应 +CMEE: (取值列表) 查询命令 AT+CMEE? OK 响应 +CMEE: OK 配置命令 响应 AT+CMEE= 最大响应时间 l 参考 GSM07.07 OK ERROR +CME ERROR: 300ms cte l 参数 ue tia 0 禁用结果码+CME ERROR: ，使能 ERROR 1 启用结果码+CME ERROR: ，使用数值型的取值（AT&F） 2 启用结果码+CME ERROR: ，使用详细描述的取值 Q en 备注 fid 详细结果码对照请参照表 8：+CME ERROR 错误代码列表 和表 9：+CMS ERROR 错误代码列表。 n 举例 o AT+CMEE=0 C OK //禁用结果码+CME ERROR: ，使能 ERROR AT+CPIN=1234 ERROR AT+CMEE=1 //启用结果码+CME ERROR: ，使用数值型的取值 OK AT+CPIN? +CME ERROR: 10 AT+CMEE=2 //启用结果码+CME ERROR: ，使用详细描述的取值 OK AT+CPIN? 上海移远通信技术有限公司 29 / 256 +CME ERROR: SIM not inserted M26 AT 命令手册 2.23. AT+CSCS 选择 TE 字符集 该命令设置模块使用的字符集,以使用户终端能够在 TE 和 ME 的字符集之间正确转换字符串。 语法 AT+CSCS 选择 TE 字符集 测试命令 响应 AT+CSCS=? 查询命令 l AT+CSCS? te 配置命令 c l AT+CSCS= ue tia 最大响应时间 Q n 参考 GSM07.07 +CSCS: (取值列表) OK 响应 +CSCS: OK 响应 OK ERROR +CME ERROR: 300ms fide 参数 Con 'GSM' 'HEX' 'IRA' 'PCCP437' 'UCS2' GSM 默认字符集 十六进制，取值范围：00~FF 国际参考字符集 PC 字符集编码 16 位通用多字节编码字符集，字符串从 0000~FFFF '8859-1' ISO8859 拉丁 1 字符集 备注 该命令操作只能在模块处于空闲状态下操作，不然会导致其他功能操作异常。 上海移远通信技术有限公司 30 / 256 M26 AT 命令手册 举例 AT+CSCS? +CSCS: 'GSM' //查询当前字符集 OK AT+CSCS='UCS2' OK AT+CSCS? +CSCS: 'UCS2' //设置字符集为'UCS2'编码 OK 2.24. AT+GCAP 请求 TA 功能列表 l 语法 te AT+GCAP 请求 TA 功能列表 c l 测试命令 AT+GCAP=? ue tia 执行命令 AT+GCAP Q en 最大响应时间 参考 fid V.25ter 响应 OK 响应 +GCAP: OK 300ms n 参数 Co +CGSM 支持 GSM 功能 +FCLASS 支持 FAX 功能 上海移远通信技术有限公司 31 / 256 M26 AT 命令手册 3 串行接口控制命令 3.1. AT&C 设置 DCD 功能模式 该命令可设置 109（DCD）电路状态与远端接收线上信号检测之间的联系。 语法 AT&C 设置 DCD 功能模式 l 执行命令 AT&C[] te 最大响应时间 c l 参考 ue tia V.25ter 响应 OK 300ms 参数 Q en 0 1 DCD 线路打开 DCD 线路只在数据载波存在时打开 nfid 3.2. AT&D 设置 DTR 功能模式 Co 该命令用于在数据模式下，当 circuit108/2 (DTR)从 ON 变为 OFF 状态时，TA 的响应状态。 语法 AT&D 设置 DTR 功能模式 执行命令 响应 AT&D[] OK 最大响应时间 参考 V.25ter 300ms 上海移远通信技术有限公司 32 / 256 参数 0 1 2 M26 AT 命令手册 TA 忽略 DTR 状态 DTR 由 ON 至 OFF：TA 在保持当前数据通话的同时，切换至命令模式 DTR 由 ON 至 OFF：TA 释放数据通话，切换至命令模式。当 DTR=OFF 时，为自 动应答关闭状态 3.3. AT+ICF 设置 TE-TA 帧格式 语法 AT+ICF 设置 TE-TA 帧格式 测试命令 AT+ICF=? tel 查询命令 AT+ICF? uec tial 配置命令 AT+ICF=[,] Q en 最大响应时间 fid 参考 V.25ter 响应 +ICF: (取值列表),(取值列表) OK 响应 +ICF: , OK 响应 OK ERROR +CME ERROR: 300ms n 参数 Co 1 8 数据位 0 奇偶校验位 2 停止位 2 8 数据位 1 奇偶校验位 1 停止位 3 8 数据位 0 奇偶校验位 1 停止位 4 7 数据位 0 奇偶校验位 2 停止位 5 7 数据位 1 奇偶校验位 1 停止位 6 7 数据位 0 奇偶校验位 1 停止位 0 奇数位 1 偶数位 3 空格 上海移远通信技术有限公司 33 / 256 备注 1. 该命令适用于命令模式； 2. 在参数中，'0 奇偶校验位'表示无奇偶校验位； 3. 若设置为无奇偶校验位，则配置被忽略。 M26 AT 命令手册 3.4. AT+IFC 设置 TE-TA 流控 在使用 V.42 差错控制的情况下，AT+IFC 可控制 DTE 和 DCE 在数据状态下的本地流控操作。 语法 AT+IFC 设置 TE-TA 流控 测试命令 l AT+IFC=? 响应 +IFC: (取值列表),(取值列表) te 查询命令 c l AT+IFC? OK 响应 +IFC: , ue tia 配置命令 Q n AT+IFC=, e 最大响应时间 fid 参考 V.25ter OK 响应 OK ERROR +CME ERROR: 300ms on 参数 C 指定 TE 接收来自 TA 数据时采用的流控方法 0 无流控（默认） 1 软件流控 2 硬件流控 指定 TA 接收来自 TE 数据时采用的流控方法 0 无流控（默认） 1 软件流控 2 硬件流控 上海移远通信技术有限公司 34 / 256 备注 流量控制适用于数据模式。 M26 AT 命令手册 举例 AT+IFC=2,2 OK AT+IFC? +IFC: 2,2 //设置硬件流控 OK 3.5. AT+ILRR 设置本地速率报告 tel AT+ILRR 可设置是否从 DCE 发送中间结果码+ILRR: 到 DTE。 c l 若启用该功能，可在调制、差错控制、数据抑制报告发送之后，或最终结果码（如：CONNECT）发 送之前，发送该中间结果码。 ue tia 语法 Q n AT+ILRR 设置本地速率报告 测试命令 e AT+ILRR=? 响应 +ILRR: （取值列表） fid 查询命令 n AT+ILRR? OK 响应 +ILRR: Co 配置命令 OK 响应 AT+ILRR= OK ERROR +CME ERROR: 最大响应时间 300ms 参考 V.25ter 上海移远通信技术有限公司 35 / 256 M26 AT 命令手册 参数 0 1 禁用本地端口速率报告 启用本地端口速率报告 备注 1. 当=1 时，以下结果码会通过串口发送出来： +ILRR: 2. 为串口通讯波特率 300/1200/2400/4800/9600/14400/19200/28800/38400/57600/115200。 3.6. AT+IPR 设置 TE-TA 波特率 该命令用于设置 DTE-DCE 的波特率。在接收到其结果码后，该配置命令才生效。 tel 语法 c l AT+IPR 设置 TE-TA 波特率 测试命令 ue tia AT+IPR=? 响应 +IPR: (自适应波特率下支持的速率取值列表), ( 固定波特率下支持的速率取值列表) Q n 查询命令 e AT+IPR? OK 响应 +IPR: fid 配置命令 n AT+IPR= Co 最大响应时间 OK 响应 OK ERROR +CME ERROR: 300ms 参考 V.25ter 参数 0（自适应波特率） 75 150 上海移远通信技术有限公司 36 / 256 M26 AT 命令手册 300 600 1200 2400 4800 9600 14400 19200 28800 38400 57600 115200 备注 1. AT+IPR 默认配置为 0（自适应波特率）； l 2. 若自适应波特率功能打开，TA 会自动同步上 TE 的波特率； 3. 若设置为固定波特率，需保证 TE 和 TA 所配置的波特率相同； te 4. AT+IPR 的值不受 AT&F，ATZ 影响。但是可以通过 AT&W 保存当前配置，AT&V 显示当前配 c l 置； 5. 在多路复用模式下，不可以通过 AT+IPR 配置当前串口通讯波特率，使用 AT&W 保存操作亦无效； ue tia 6. 可以通过输入'AT'字符串确认是否返回 OK 来判断配置的波特率是否有效。 举例 Q n AT+IPR=115200 e OK fid AT&W OK AT+IPR? n +IPR: 115200 Co OK //设置固定波特率为 115200 //保存配置的固定波特率，即此时模块重启后串口通讯速率为 115200 3.6.1. 自适应波特率 DTE 与 DCE 之间的同步是为了确保 DTE 与 DCE 成功同步并使 DCE（=ME）检测到 DTE 使用的波 特率。当开启模块，串口波特率设置为自适应波特率，此时输入'AT'字符串是必要的，它允许 DCE 同步上 DTE 波特率。在发送第一个 AT 字符前最好等待 3 至 5 秒，否则将可能返回一些不确定字符。 如果需要同时使用自适应波特率和自动应答功能，可以先在激活自适应波特率时进行 DTE-DCE 同步， 然后配置自动应答模式。 上海移远通信技术有限公司 37 / 256 M26 AT 命令手册 3.6.1.1. 自适应波特率操作限制  串行接口必须工作在 8 位数据位，无奇偶校验位和 1 位停止位的出厂默认设置；  不能使用命令'A/'；  在自适应波特率状态下，可以通过使用字符串'AT'或者'at'（而非'aT'或 At'）同步波特率；  若希望 AT+IPR=0 设置在模块重启后仍然有效，需通过 AT&W 保存波特率配置；  当自适应波特率启用时，在波特率被同步以前，所有上报的 URC，如 RDY 等都不会被输出。 3.6.1.2. 自适应波特率和 MUX 如果自适应波特率被启用，不建议切换到 MUX 模式。 tel 3.6.1.3. 自适应波特率和 windows 调制解调器 c l 在建立 GPRS/CSD 拨号连接时，windows 调制解调器使用的波特率会被侦测到。但是一些 windows ue tia 调制解调器驱动程序在 GPRS 拨号结束后会将 TE 的波特率切换回默认值，这会导致 windows 调制解调器 接收不到响应。为了避免这种情况发生，不建议在启用自适应波特率的情况下去建立 GPRS/CSD 拨号。 Q n 基于同样的原因，也不建议在启用自适应波特率的情况下使用 PC 端 FAX 应用程序去建立 FAX 连接， 如 WinFax。 fide 备注 为了确保 DCE 和 DTE 之间通讯的可靠性和避免由于波特率不确定导致的问题，强烈建议在开机后配置 为固定波特率并将设置保存，即如操作 AT+IPR=115200&W。 Con 3.7. AT+CMUX 多路复用 该命令用于设置 DTE-DCE 的波特率。在接收到其结果码后，该配置命令才生效。 语法 AT+CMUX 多路复用 测试命令 AT+CMUX=? 响应 +CMUX: ( 取 值 列 表 ),( 取 值 列 表),(取值列表),(取值列表),(取值列 上海移远通信技术有限公司 38 / 256 M26 AT 命令手册 表),(取值列表),(取值列表),(取值列表),(取 值列表) 查询命令 AT+CMUX? OK 响应 +CMUX: ,0,5,127,10,3,30,10,2 配置命令 OK 响应 AT+CMUX=[[,[,[,[,[,[,[,[,]]]]]]]]] +CME ERROR: 最大响应时间 参考 GSM07.07 300ms l 参数 cte l ue tia Q n fide n Co 复用透传机制 0 基本选择 控制通道的复用器的建立方式 0 仅适用 UIH 包文 传输速率 5 115200bit/s 最大报文大小 127 接收确认定时器，以 10ms 为单元 10 重传的最大次数 3 复用控制通道的响应定时器，以 10ms 为单元 30 唤醒响应定时器，以秒为单位 10 窗口大小，适用于有错误恢复选项的高级配置 2 备注 1. 不支持错误恢复选项的高级配置； 2. 依据当前的串口波特率，强烈建议在波特率为 115200bit/s 使用多路复用； 3. 复用传输速率复用器控制通道如下所示： 上海移远通信技术有限公司 39 / 256 通道数 None 1 2 3 4 类型 Multiplexer Control 07.07 and 07.05 07.07 and 07.05 07.07 and 07.05 07.07 and 07.05 DLCI 0 1 2 3 4 M26 AT 命令手册 3.8. AT+QEAUART 开启双串口功能 使用此命令，可以打开双串口功能，主串口和 AUX UART 同时使用。 语法 AT+QEAUART 开启双串口功能 l 测试命令 te AT+QEAUART=? c l 查询命令 ue tia AT+QEAUART? Q n 配置命令 AT+QEAUART= fide 最大响应时间 参考 n Quectel 响应 +QEAUART: (取值列表) OK 响应 +QEAUART: OK 响应 OK ERROR +CME ERROR: 300ms Co 参数 < mode> 0 关闭双串口功能 1 开启双串口功能 备注 1. 打开双串口功能，UART3 可以执行 AT 命令，关于 UART3 可以参考 M26 硬件文档。 2. UART3 不能使用数传和文件上传/下载相关命令，例如 TCP, FTP, HTTP, SMTP, PPP 和 FILE 等。 3. 该命令设置成功后会自动保存。 上海移远通信技术有限公司 40 / 256 M26 AT 命令手册 3.9. AT+QSEDCB 配置双串口的参数 语法 AT+QSEDCB 配置双串口的参数 测试命令 AT+QSEDCB=? 响应 +QSEDCB: ( 取 值 列 表 ),( 取 值 列 表),(取值列表),(取值列表) OK 查询命令 响应 AT+QSEDCB? +QSEDCB: ,,, 配置命令 l AT+QSEDCB=,, , te 最大响应时间 c l 参考 ue tia Quectel OK 响应 OK ERROR +CME ERROR: 300ms Q n 参数 Confide 波特率 1200 2400 4800 9600 14400 19200 28800 38400 57600 115200 数据位 5 6 7 8 停止位 1 上海移远通信技术有限公司 41 / 256 M26 AT 命令手册 2 3 校验位 0 None 1 Odd 2 Even 3 Mark 备注 1. 该命令可通过 AT&W 命令保存。 2. 如果打开双串口功能，AT+QSEDCB 命令可执行成功，否则命令会报错。 CQouneficdteenl tial 上海移远通信技术有限公司 42 / 256 M26 AT 命令手册 4 状态控制命令 4.1. AT+CEER 上报移动设备错误 语法 AT+CEER 上报移动设备错误 测试命令 AT+CEER=? l 查询命令 te AT+CEER c l 最大响应时间 ue tia 参考 GSM07.07 响应 OK 响应 +CEER: , OK 300ms Q en 参数 fid 错误类型 ID 号 最后一次呼叫连接释放原因 n 备注 o 1. 及报告值参考表 10：Location ID 扩展错误报告列表； C 2. 表 10：Location ID 扩展错误报告列表 提供了下列原因的扩展报告： 1) 最近一次呼叫建立失败（发起或应答）或呼叫内修改 2) 最近一次呼叫释放 举例 AT+CEER +CEER: 0,0 OK //正常状态下，查询错误报告，返回 No error (default) 上海移远通信技术有限公司 43 / 256 M26 AT 命令手册 ATD10086; OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK NO CARRIER AT+CEER +CEER: 1,16 //通话建立，对方挂断通话，查询报告错误号提示：1：Cause for protocol stack(PS) layer，16：Normal call clearing OK 4.2. AT+CPAS 模块活动状态 l 语法 te AT+CPAS 模块活动状态 c l 测试命令 ue tia AT+CPAS=? Q n 查询命令 AT+CPAS fide 最大响应时间 参考 n GSM07.07 响应 +CPAS:(取值列表) OK 响应 +CPAS: OK 300ms Co 参数 0 2 3 4 准备（ME 允许来自 TA/TE 的命令） 未知（ME 未授权响应指令） 振铃（ME 准备好接收来自 TA/TE 的命令，但正在振铃） 呼叫进行中（ME 准备好来自 TA/TE 的命令，但当前有一个呼叫正在进行） 举例 AT+CPAS +CPAS: 0 上海移远通信技术有限公司 44 / 256 M26 AT 命令手册 OK //模块处于空闲状态，=0 ATD10086; OK AT+CLCC +CLCC: 1,0,3,0,0,'10086',129,'' OK AT+CPAS +CPAS: 3 OK //模块处于呼叫振铃状态，=3 AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK l AT+CPAS +CPAS: 4 te OK //模块处于呼叫建立状态，=4 uec tial 4.3. AT+QINDRI 开启关闭 RI 引脚提示 Q n 语法 e AT+QINDRI 开启关闭 RI 引脚提示 fid 测试命令 响应 AT+QINDRI=? +QINDRI: (取值列表) n 查询命令 Co AT+QINDRI? OK 响应 +QINDRI: 配置命令 OK 响应 AT+QINDRI= OK ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 45 / 256 参数 0 关闭 1 开启 M26 AT 命令手册 4.4. AT+QMOSTAT 开启或关闭去电呼叫状态报告 语法 AT+QMOSTAT 开启或关闭去电呼叫状态报告 测试命令 AT+QMOSTAT=? l 查询命令 AT+QMOSTAT? cte l 配置命令 ue tia AT+QMOSTAT= Q n 最大响应时间 e 参考 Quectel 响应 +QMOSTAT: (取值列表) OK 响应 +QMOSTAT: OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 Con 配置是否开启去电呼叫状态报告 0 关闭，不显示去电通话状态 1 开启，显示去电的通话状态。拨号后，呼叫响铃后显示'MO RING'，呼叫连接建立 成功后显示'MO CONNECTED' 举例 AT+QMOSTAT=1 OK ATD10086; OK 上海移远通信技术有限公司 46 / 256 MO RING MO CONNECTED //呼叫振铃，显示 MO RING //呼叫连接建立成功，显示 MO CONNECTED M26 AT 命令手册 4.5. AT+QREFUSECS 开启或关闭来短信和来电拒接功能 语法 AT+QREFUSECS 开启或关闭来短信和来电拒接功能 测试命令 响应 AT+QREFUSECS=? +QREFUSECS: (取值列表)[,(取 值列表)] l 查询命令 AT+QREFUSECS? OK 响应 +QREFUSECS: , cte l 配置命令 ue tia AT+QREFUSECS=[,] Q n 最大响应时间 参考 e Quectel OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 n Co 0 不拒绝短信 1 拒绝短信 0 不拒绝来电 1 拒绝来电 上海移远通信技术有限公司 47 / 256 M26 AT 命令手册 4.6. AT+QIURC 初始化完成提示上报 语法 AT+QIURC 初始化完成提示上报 测试命令 AT+QIURC=? 响应 +QIURC: (取值列表) 查询命令 AT+QIURC? OK 响应 +QIURC: 配置命令 AT+QIURC= tel 最大响应时间 c l 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms ue tia 参数 Q n 0 e 1 关闭显示 开启显示 fid 备注 Con 当=1 时，模块开机初始化完成后，终端会上报 'Call Ready' 提示。 4.7. AT+QEXTUNSOL 开启关闭专有 URC 上报 语法 AT+QEXTUNSOL 开启关闭专有 URC 上报 测试命令 响应 AT+QEXTUNSOL=? +QEXTUNSOL: (取值列表) OK 上海移远通信技术有限公司 48 / 256 M26 AT 命令手册 查询命令 AT+QEXTUNSOL=, 最大响应时间 参考 Quectel 响应 OK ERROR +CME ERROR: 300ms 参数 字符串参数（字符串需要加双引号）。当前专有 URC 提示参数值 'SQ' 'FN' l 'MW' CQouneficdteential 'UR' 信号质量报告。显示信号强度和误码率（类似于 AT+CSQ），当信号值或误码率 值有变化时上报+CSQN:,提示 可用网络被禁止时有效。当返回到非注册状态时，该提示表明所有可用的 PLMN 已被禁止 SMS 等待指示。当接收到一条 SMS 时，该 SMS 会被解码并检查是否还有一条 或多条消息在等待的指示（例如，语音邮件，电子邮件，传真等）。如果有等待 指示，会上报+QMWT: ,,,,,提 示。其中表示消息存储器类型，表示消息存储的位置索引, , , , 表示相应类型的等待消息的数量（„0‟表示清 除指示，其他非„0‟值表示等待消息的数量，空白表示没有对应类型的等待消息） URC 码。根据通话状态的转换上报 URC 提示+QGURC: 。同一次状态 的转换可能上报多个 URC，其中表示当前通话状态。 : 0 当前通话被终止，至少还存在一个被保持的通话 1 开始主动拨打电话 2 主动拨打电话失败 3 主动拨打电话，对方正在振铃 4 通话被转入呼叫等待状态 5 主动拨打的电话被接通 6 通话被终止 7 通话被挂起 8 在紧急拨号模式下拨打非紧急号码 9 主动拨打的电话没有应答 10 主动拨打电话，对方忙 'BC' 电池充电报告。显示电池连接状态和充电进度（类似于 AT+CBC）报告。 显示格式为+CBCN: , 'BM' 显示频段。按+QBAND: 格式报告频段变化情况（与 AT+QBAND 类似） 'SM' 额外的 SMS 信息提示。以+TSMSINFO: 格式的 URC 显示额 外的 SMS 事件。其中是标准的 CMS 错误提示（与 AT+CMEE 命令显示的一样） 'CC' 通话信息。当有通话断开时，以+CCINFO: , 格式上报断开的通话 ID 和仍然进行的通话 ID 上海移远通信技术有限公司 49 / 256 0 关闭 1 开启 2 查询 M26 AT 命令手册 4.8. AT+QINISTAT 初始化状态查询 语法 AT+QINISTAT 初始化状态查询 测试命令 响应 AT+QINISTAT=? 执行命令 AT+QINISTAT tel 最大响应时间 参考 c l Quectel OK 响应 +QINISTAT: OK 300ms ue tia 参数 Q fiden 0 ME 初始化操作开始 1 ME 可接收执行 AT 命令 2 电话本初始化完成 3 短消息初始化完成 n 备注 Co 当=3 时，表示 SIM 卡相关可操作功能初始化完成。 4.9. AT+QNSTATUS 查询 GSM 网络状态 语法 AT+QNSTATUS 查询 GSM 网络状态 测试命令 响应 AT+QNSTATUS=? OK 上海移远通信技术有限公司 50 / 256 M26 AT 命令手册 执行命令 AT+QNSTATUS 最大响应时间 参考 Quectel 响应 +QNSTATUS: OK 300ms 参数 255 未准备好检测网络状态 0 网络状态正常 1 无可用小区 2 限制服务状态 tel 4.10. AT+QNITZ 同步网络时间 c l 语法 ue tia AT+QNITZ 同步网络时间 测试命令 Q n AT+QNITZ=? fide 查询命令 AT+QNITZ? n 配置命令 Co AT+QNITZ= 响应 +QNITZ: (取值列表) OK 响应 +QNITZ: OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 51 / 256 M26 AT 命令手册 参数 0 禁用同步网络时间 1 启用同步网络时间, 开启同步网络时间功能，会直接上报'+QNITZ:,' 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年，月，日，小时，分钟，秒和时区 （用当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围： -47~+48） Daylight Savinng Time，零时区时，格式为'04/05/06,22:10:00+08,0' 备注 该功能应用需要当地的 GSM 网络支持网络时间同步。 l 4.11. AT+QLTS 获取最近一次的网络同步时间 te 语法 c l AT+QLTS 获取最近一次的网络同步时间 ue tia 测试命令 响应 AT+QLTS=? OK 执行命令 响应 Q n AT+QLTS +QLTS: , fide 最大响应时间 参考 n Quectel OK +CME ERROR: 300ms Co 参数 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年，月，日，小时，分钟，秒和时区（用 当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围：-47~+48） Daylight Savinng Time，零时区时，格式为'04/05/06,22:10:00+08,0' 备注 1. 该功能应用需要当地的 GSM 网络支持网络时间同步； 2. 该功能必须要设置 AT+QNITZ=1 时有效。 上海移远通信技术有限公司 52 / 256 M26 AT 命令手册 4.12. AT+CTZU 网络时间同步以及更新 RTC 时间 语法 AT+CTZU 网络时间同步以及更新 RTC 时间 测试命令 响应 AT+CTZU=? +CTZU: (取值列表) OK 查询命令 响应 AT+CTZU? +CTZU: 配置命令 AT+CTZU= tel 最大响应时间 参考 c l Quectel OK 响应 OK +CME ERROR: 300ms ue tia 参数 Q n 0 e 1 2 fid 3 4 NITZ 时不自动更新 RTC 时间 NITZ 时自动更新 RTC 时间 NITZ 时自动更新 GMT 时间至 RTC，时区保存在 NVROM，DST 无效 NITZ 时自动更新本地时间至 RTC，时区保存在 NVROM 同=2 模式 n 备注 o 1. 该功能应用需要当地的 GSM 网络支持网络时间同步； C 2. AT+CTZU 的参数无需保存，可以自动写入 Flash。 上海移远通信技术有限公司 53 / 256 M26 AT 命令手册 4.13. AT+CTZR 网络时间同步上报 语法 AT+CTZR 网络时间同步上报 测试命令 AT+CTZR=? 响应 +CTZR: (取值列表) 查询命令 AT+CTZR? OK 响应 +CTZR: 配置命令 AT+CTZR= l 最大响应时间 te 参考 c l Quectel OK 响应 OK +CME ERROR: 300ms ue tia 参数 Q n 0 1 e 2 网络时间同步时不上报时区信息的改变 网络时间同步时上报时区信息的改变，以+CTZV: 格式上报 网络时间同步时上报时区信息的改变，以+CTZE: ,,[]格式上报 fid 4.14. AT+QSIMDET 开启或关闭 SIM 卡检测功能 on 语法 C AT+QSIMDET 开启或关闭 SIM 卡检测功能 测试命令 响应 AT+QSIMDET=? +QSIMDET: ( 取 值 列 表 ),( 取 值 列 表),(取值列表) 查询命令 AT+QSIMDET? OK 响应 +QSIMDET: ,, OK 上海移远通信技术有限公司 54 / 256 M26 AT 命令手册 配置命令 AT+QSIMDET=[,[,]] 最大响应时间 参考 Quectel 响应 OK +CME ERROR: 300ms 参数 配置是否开启 SIM 卡检测功能 0 关闭 tel 1 开启 配置 SIM 卡插入时的检测引脚电平 0 低电平 1 高电平 配置 SIM 卡检测引脚 0 配置 SIM_PRESENCE 引脚作为 SIM 卡的检测引脚 1 配置 DTR 引脚作为 SIM 卡的检测引脚 c l 备注 ue tia 1. 此命令可使用AT&W保存； 2. M26 中 SIM_PRESENCE 和 DTR 引脚是复用的，M26 只支持 DTR 引脚作为 SIM 卡的检测引脚， Q n 所以开启 SIM 卡检测功能应设置为 1。 e 举例 fid AT+QSIMDET=1,0,1 OK //配置 DTR 引脚作为 SIM 卡的检测引脚，SIM 卡插入时为 DTR 低电平 n Co +CPIN: NOT READY //SIM 卡已掉卡 +CPIN: READY //SIM 卡已插入 上海移远通信技术有限公司 55 / 256 M26 AT 命令手册 4.15. AT+QSIMSTAT SIM 卡插拔状态报告 语法 AT+QSIMSTAT SIM 卡插拔状态报告 测试命令 响应 AT+QSIMSTAT=? +QSIMSTAT: (取值列表) 查询命令 AT+QSIMSTAT? OK 响应 +QSIMDET: , 配置命令 AT+QSIMSTAT= l 最大响应时间 te 参考 c l Quectel OK 响应 OK +CME ERROR: 300ms ue tia 参数 Q n 配置是否开启 SIM 卡插拔状态上报 0 关闭 e 1 开启 SIM 卡插入状态，此参数不允许设置 fid 0 拔出 1 插入 n 备注 o 1. 当 SIM 卡插入或拔出，URC 提示：+QSIMSTAT: ,; C 2. 此命令可用 AT&W 保存。 举例 AT+QSIMSTAT? +QSIMSTAT: 0,1 //查询 SIM 卡插入状态 OK AT+QSIMDET=1,0,1 OK 上海移远通信技术有限公司 56 / 256 M26 AT 命令手册 AT+QSIMSTAT=1 OK AT+QSIMSTAT? +QSIMSTAT: 1,1 //开启 SIM 卡插拔状态上报 OK +CPIN: NOT READY +QSIMSTAT: 1,0 //SIM 卡插拔状态上报，拔出 AT+QSIMSTAT? +QSIMSTAT: 1,0 OK l te +QSIMSTAT: 1,1 //SIM 卡插拔状态上报，插入 uec tial +CPIN:READY //SIM卡已插入 Q n 4.16. AT+QCGTIND 语音/数据呼叫结束提示 e 语法 fid AT+QCGTIND 语音/数据呼叫结束提示 测试命令 响应 n AT+QCGTIND=? +QCGTIND: (取值列表) Co 查询命令 OK 响应 AT+QCGTIND? +QCGTIND: 配置命令 AT+QCGTIND= 最大响应时间 OK 响应 OK ERROR +CME ERROR: 300ms 上海移远通信技术有限公司 57 / 256 M26 AT 命令手册 参考 Quectel 参数 配置是否开启提示语音/数据呼叫结束的 URC 到终端 0 关闭 1 开启 呼叫建立的连接类型 0 语音 1 数据 2 PPP 连接 备注 l 语音/数据呼叫结束，URC 提示：+QCGTIND: 。 cte l 举例 ue tia ATD10086; OK +QCGTIND: 0 CQonfiden NO CARRIER //语音通话连接挂断时上报提示，=0 上海移远通信技术有限公司 58 / 256 M26 AT 命令手册 5 SIM 卡相关命令 5.1. AT+CIMI 请求国际移动台设备标识（IMSI） 语法 AT+CIMI 请求国际移动台设备标识（IMSI） 测试命令 响应 AT+CIMI=? l 执行命令 OK 响应 AT+CIMI cte l 最大响应时间 ue tia 参考 GSM 07.07 OK 300ms Q n 参数 fide 国际移动设备标识 n 举例 o AT+CIMI C 460023210226023 //查询返回 ME 内，当前 SIM 卡的 IMSI 号 OK 5.2. AT+CLCK 设备锁定 该命令用于锁定、解锁、查询 ME 或网络设备。一般需要输入密码。当查询网络业务（=2） 状态时，只有当该业务对任何参数都是非激活状态，才返回'非激活'状态（=0）的返回结 果。当设定或查询网络设备时，该命令将被终止执行。 上海移远通信技术有限公司 59 / 256 M26 AT 命令手册 语法 AT+CLCK 设备锁定 测试命令 AT+CLCK=? 响应 +CLCK: (取值列表) OK 配置命令 响应 AT+CLCK=,[,[ 当不等于 2 且操作执行成功，返回： ,]] OK 当等于 2 且操作执行成功，返回： +CLCK: [,[ +CLCK: , class2....]] OK 最大响应时间 5s l 参考 GSM07.07 cte l 参数 CQounefidentia 'PS' 'SC' 'AO' 'OI' 'OX' 'AI' 'IR' 'AB' 'AG' 'AC' 'FD' PH-SIM（将 ME 锁定于 SIM 卡上，当其他 SIM 卡插入该被锁 ME 内，ME 提示输入密 码；可以设置 ME，使之能够识别使用过的几个 SIM 卡，这样在插入这些卡后，ME 不 会提示输入密码） SIM（SIM 卡锁，当 ME 重新启动时 SIM 请求输入 PIN 码） BAOC（禁止所有呼出呼叫，请参考 GSM02.88[6] clause 1） BOIC（禁止所有国际呼出呼叫，请参考 GSM02.88[6] clause 1） BOIC-exHC（禁止所有国际呼出呼叫，归属国除外，请参考 GSM02.88[6] clause 1） BAIC（禁止所有呼入呼叫，请参考 GSM02.88[6] clause 2) BIC-Roam（归属国以外漫游时，禁止所有呼入呼叫，请参考 GSM02.88 [6] clause 2） 禁止所有服务，仅当=0 有效（请参考 GSM02.30[19]） 禁止所有呼出服务，仅当=0 有效（请参考 GSM02.30[19]） 禁止所有呼入服务，仅当=0 有效（请参考 GSM02.30[19]） SIM 卡固定拨号特点，当 ME 操作锁'FD'，此时只有'FD'内的号码可以呼叫 'PF' 将 ME 锁定到插入的第一张 SIM 卡上（当插入其他 SIM 卡，ME 提示输入密码） 'PN' 网络个性化（请参考 GSM 02.22） 'PU' 网络子集个性化（请参考 GSM 02.22） 'PP' 服务供应商个性化（请参考 GSM 02.22） 'PC' 公司个性化（请参考 GSM 02.22） 0 解锁 1 锁定 2 查询状态 密码 上海移远通信技术有限公司 60 / 256 M26 AT 命令手册 1 2 4 7 8 16 32 0 1 语音 数据 传真 短消息（默认）以外所有类别 短消息 同步数据电路 异步数据电路 未激活 激活 备注 如果 ME 内未插入 SIM 卡或 PIN 码未解，操作 AT+CLCK 锁，会返回+CME ERROR: 相关报错。 举例 l AT+CLCK='SC', 2 te +CLCK: 0 c l OK ue tia AT+CLCK='SC',1,'1234' OK AT+CLCK='SC',2 Q n +CLCK: 1 //查询当前 SC 锁状态，未锁 //设置 SC 锁，密码为：1234 e OK AT+CLCK='SC',0,'1234' fid OK //查询当前 SC 锁状态，已锁 //解除 SC 锁，密码为：1234 Con 5.3. AT+CPIN 输入 PIN 使用该配置命令，可向 ME 发送操作需要的密码（SIM PIN，SIM PUK，PH-SIM PIN 等）。如果操作 返回的是 SIM PUK 或者 SIM PUK2，则为 PUK1 码或 PUK2 码，且需要写入第二个参数， 该用来取代 SIM 卡中的原有 PIN 码。 查询命令返回的字符串采用字母数字混编方式，指示是否需要密码。 上海移远通信技术有限公司 61 / 256 M26 AT 命令手册 语法 AT+CPIN 输入 PIN 测试命令 AT+CPIN=? 查询命令 AT+CPIN? 响应 OK 响应 +CPIN: OK 配置命令 响应 AT+CPIN=[,] OK ERROR 最大响应时间 参考 GSM 07.07 +CME ERROR: 5s tel 参数 c l Quefidentia READY ME 不再需要提供密码 SIM PIN ME 等待提供 SIM 卡的 PIN 码 SIM PUK ME 等待提供 SIM 卡的 PUK 码 PH_SIM PIN ME 等待提供从终端到最初 SIM 卡的密码（防盗） PH_SIM PUK ME 等待提供从终端到最初 SIM 卡的 PUK 密码 SIM PIN2 ME 等待提供 SIM 卡 PIN2（例如：当编辑 FDN 号码薄，可能返回 +CME ERROR: 17） SIM PUK2 ME 等待提供 SIM 卡的 PUK2（在执行该命令过程中可能返回+CME ERROR: 18） 原密码（字符型）（SIM 卡的 PIN 码或 PUK 密码，如：SIM PUK 或者 PH-SIM PUK） 新密码（字符型） Con 举例 AT+CPIN? +CPIN: SIM PIN OK AT+CPIN=1234 +CPIN: READY //查询有 PIN 码锁定 OK AT+CPIN? +CPIN: READY //输入 PIN 码 上海移远通信技术有限公司 62 / 256 M26 AT 命令手册 OK AT+CPIN? +CPIN: SIM PUK //PIN 码锁被解除 OK //查询有 PUK 码锁定 AT+CPIN='26601934','1234' +CPIN: READY OK AT+CPIN? +CPIN: READY //输入 PUK 码和新 PIN 码 OK //PUK 锁被解除 l 5.4. AT+CPWD 设备锁定 te 该命令可以修改设备锁定命令 AT+CLCK 定义的设备锁定密码。 uec tial 语法 AT+CPWD 设备锁定 Q n 测试命令 AT+CPWD=? 响应 +CPWD: (取值列表),(取值列表) fide 配置命令 AT+CPWD= ,, on 最大响应时间 C 参考 OK 响应 OK ERROR +CME ERROR: 5s GSM 07.07 参数 'PS' 'SC' 'AO' PH-SIM（将 ME 锁定于 SIM 卡上，当其他 SIM 卡插入该被锁 ME 内，ME 提示输 入密码；可以设置 ME，使之能够识别使用过的几个 SIM 卡，这样在插入这些卡后， ME 不会提示输入密码） SIM（SIM 卡锁，当 ME 重新启动时 SIM 请求输入 PIN 码） BAOC（禁止所有呼出呼叫，请参考 GSM02.88[6] clause 1） 上海移远通信技术有限公司 63 / 256 M26 AT 命令手册 'OI' BOIC（禁止所有国际呼出呼叫，请参考 GSM02.88[6] clause 1） 'OX' BOIC-exHC（禁止所有国际呼出呼叫，归属国除外，请参考 GSM02.88[6] clause1） 'AI' BAIC（禁止所有呼入呼叫，请参考 GSM02.88[6] clause 2） 'IR' BIC-Roam（归属国以外漫游时，禁止所有呼入呼叫，请参考 GSM02.88 [6] clause2） 'AB' 禁止所有服务，仅当=0 有效（请参考 GSM02.30[19]） 'AG' 禁止所有呼出服务，仅当=0 有效（请参考 GSM02.30[19]） 'AC' 禁止所有呼入服务，仅当=0 有效（请参考 GSM02.30[19]） 'FD' SIM 卡固定拨号特点，当 ME 操作锁'FD'，此时只有'FD'内的号码可以呼叫 'P2' SIM PIN2 整数型 表示密码最大长度 字符型 与 ME 用户接口使用的设备锁密码、修改密码命令设置的密码相同 字符型 新设定的密码 举例 AT+CPIN? l +CPIN: READY te OK AT+CPWD='SC','1234','4321' c l OK ue tia AT+CPIN? +CPIN: SIM PIN Q n OK e AT+CPIN='4321' +CPIN: READY fid OK //设置新 PIN 码为 4321 //重启模块 //重启模块或重激活 SIM 卡，会提示输入新 PIN 码解 PIN 锁 Con 5.5. AT+CRSM SIM 卡接入限制 语法 AT+CRSM SIM 卡接入限制 测试命令 AT+CRSM=? 配置命令 AT+CRSM=[,[,,,[,]]] 响应 OK 响应 +CRSM: , [,] OK 上海移远通信技术有限公司 64 / 256 M26 AT 命令手册 最大响应时间 参考 GSM 07.07 ERROR +CME ERROR: 300ms 参数 176 二进制读出 178 记录读出 192 获得返回结果 l te c l ue tia , 214 二进制更新 220 记录更新 242 状态 其他参数值保留；请参考 GSM11.11 整数型；用于标识 SIM 卡中的 EF 文件 整数型；范围 0-255，ME 传送到 SIM 的参数，请参考 GSM11.11[28] 参考 参考 将写入到 SIM 卡上的信息（十六进制；请参考 AT+CSCS） 整数型；返回 0-255 SIM 卡中与该命令实际运行相关的信息，命令可能执行成功，也可 能执行失败，两种情况下这些参数都被发送给 TE，请参考 GSM11.11 前一个命令执行成功完成后返回的结果（十六进制；请参考 AT+CSCS） Q en 举例 fid AT+CRSM=242 +CRSM: 145, 211, '000000007F100200000000000A13000C0400838A808A' n OK //242 为 SIM 卡状态查询的指令码（参考 11.11），145 为 SW1，211 为 SW2， '000000007F100200000000000A13000C0400838A808A'为 SIM 卡返回的 Co内容，可以根据 GSM11.11 中的相关规定来解析具体的参数 5.6. AT+CSIM 通用 SIM 操作 语法 AT+CSIM 通用 SIM 操作 测试命令 响应 AT+CSIM=? OK 上海移远通信技术有限公司 65 / 256 配置命令 AT+CSIM=, 最大响应时间 参考 GSM 07.07 响应 +CSIM: , OK ERROR +CME ERROR: 300ms M26 AT 命令手册 参数 tel 整数类型；发往 TE 的或者的字符长度（例如：原始字节数的 两倍） 字符串类型（字符串应该包含在引号内）：16 进制格式,GSM 11.11 SIM 命令从 ME 到 SIM 字符串类型（字符串应该包含在引号内）：16 进制格式,GSM 11.11 响应从 SIM 卡到命 令 uec tial 5.7. AT+QCSPWD 更改 PS超级密码 Q n 语法 e AT+QCSPWD 更改 PS 超级密码 fid 测试命令 AT+QCSPWD=? 配置命令 n AT+QCSPWD=, o 最大响应时间 C 参考 响应 OK 响应 OK ERROR 300ms Quectel 参数 字符串类型；长度必须为 8 位的旧密码 字符串类型；长度必须为 8 位的新密码 上海移远通信技术有限公司 66 / 256 M26 AT 命令手册 备注 1. 旧密码的缺省值是'12345678'； 2. 如果模块被锁，AT+CLCK 开启后密码丢失或者状态是 PH-SIM PUK，都可以使用超级密码来解锁。 5.8. AT+CCID 显示 CCID 语法 AT+CCID 显示 CCID 测试命令 AT+CCID=? 执行命令 AT+CCID tel 最大响应时间 c l 参考 Quectel 响应 OK 响应 +CCID: OK 300ms ue tia 参数 Q n 当前 SIM 卡的 CCID 号 fide 举例 AT+CCID //查询当前 SIM 卡的 CCID 号为 898600220909A0206023 n +CCID: '898600220909A0206023' Co OK 5.9. AT+QCCID 显示 CCID 语法 AT+QCCID 显示 CCID 测试命令 响应 AT+QCCID=? OK 上海移远通信技术有限公司 67 / 256 M26 AT 命令手册 执行命令 AT+QCCID 最大响应时间 参考 Quectel 响应 ccid data OK 300ms 举例 AT+QCCID //查询当前 SIM 卡的 CCID 号为 898600220909A0206023 898600220909A0206023 OK tel 5.10. AT+QGID 获取 SIM 卡 GID c l 语法 ue tia AT+QGID 获取 SIM卡 GID 执行命令 AT+QGID Q fiden 最大响应时间 参考 Quectel 响应 +QGID: OK ERROR 300ms Con 参数 GID1 GID2 备注 如果 SIM 卡支持 GID，那么 GID 值将返回，否则返回 0xFF。 上海移远通信技术有限公司 68 / 256 M26 AT 命令手册 5.11. AT+QSIMVOL 固定 SIM 卡工作电压 语法 AT+QSIMVOL 固定 SIM 卡工作电压 测试命令 响应 AT+QSIMVOL=? +QSIMVOL: (取值列表) 查询命令 AT+QSIMVOL? OK 响应 +QSIMVOL: 配置命令 AT+QSIMVOL= tel 最大响应时间 c l 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms ue tia 参数 Q en 0 自动选择 1.8 V 和 3.0V SIM 卡工作电压 1 固定 SIM 卡工作电压为 1.8V 2 固定 SIM 卡工作电压为 3V fid 备注 Con 该命令设置成功后会自动保存，模块重启后该命令才能生效。 5.12. AT+QSPN 读取 SIM 卡服务运营商名称 语法 AT+QSPN 读取 SIM 卡服务运营商名称 查询命令 响应 AT+QSPN? +QSPN: , 上海移远通信技术有限公司 69 / 256 M26 AT 命令手册 最大响应时间 参考 Quectel OK +CME ERROR: 300ms 参数 字符串类型；SIM 卡注册的服务运营商名称 0 不显示 PLMN，已经注册上 PLMN 1 显示 PLMN 备注 l 如果模块未插卡，执行则上报相关 CME ERROR。 cte l 5.13. AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数 ue tia 语法 Q n AT+QTRPIN 输入 PIN 码/PUK 码的剩余次数 e 执行命令 响应 AT+QTRPIN +QTRPIN: ,,, fid 最大响应时间 n 参考 Co Quectel OK 300ms 参数 输入 PIN 码的剩余次数 输入 PIN2 码的剩余次数 输入 PUK 码的剩余次数 输入 PUK2 码的剩余次数 上海移远通信技术有限公司 70 / 256 M26 AT 命令手册 6 网络服务命令 6.1. AT+COPS 选择营运商 语法 AT+COPS 选择营运商 测试命令 l AT+COPS=? 响应 +COPS: (取值列表, 长字母数字格式, 短字母数 字 格 式 , 数 字 格 式 )[,,( 取 值 列 表),( 取值列表)] cte l 查询命令 ue tia AT+COPS? OK 响应 +COPS: [, [, ]] Q n 配置命令 AT+COPS=[,[,]] fid 最大响应时间 参考 n GSM 07.07 OK 响应 OK ERROR +CME ERROR: 75s，受网络状态影响 Co 参数 0 未知 1 可用运营商 2 当前运运商 3 禁用运运商 字符型，表示该字符串采用字母数字型还是数字型；数字型表示 GSM 未知区标（请 参考 GSM04.08[8]底 10.5.1.3 小节），该号码包括一个 3 位 BCD 国家代码（符合 ITU-TE.212 Annex A[10]标准）和一个 2 位 BCD 网络代码，后者与管理有关 0 自动，字段可忽略 上海移远通信技术有限公司 71 / 256 M26 AT 命令手册 1 2 3 4 0 1 2 手动，字段不可忽略 从注册网络注销 仅设置（用于查询命令 AT+COPS?）；不尝试进行注册或注销（ 字段可忽略）；该取值不适用于查询命令的返回结果 手动/自动， 字段不可忽略；如果手动选择失败，将进入自动选择模式 （=0） 长字符型（采用字母数字格式），最多 16 个字符 短字符型（采用字母数字格式），最多 8 个字符 数字型 备注 1. 配置命令选择并注册 GSM 网络营运商。设置 ME 是自动选择营运商，还是使用该命 令强制选择营运商。  当=0 时，ME 将自动尝试选择可使用的运营商。  当=1 时，ME 将强制注册选择的运营商，若该运营商无效则当前 ME 不会搜索 l 其他可用运营商，直到=0 时 ME 才会重新注册网络。如果 ME 重启后仍然在=1 下且没有 RPLMN 的话，ME 会保持在不注册网络的状态直到使用命令改变成自动注册模式。 te  当=4 时，若手动选择运营商不可用，ME 会自动选择当前网络中可用运营商继续尝试注 c l 册。 2. 该命令设置成功后会自动保存。 ue tia 举例 Q n AT+COPS=? +COPS: (2,'CHINA MOBILE','CMCC','46000'),(3,'CHINA UNICOM GSM','UNICOM','46001') e ,,(0-4),(0-2) fid OK AT+COPS? n +COPS: 0,0,'CHINA MOBILE' //列举当前所有网络营运商 Co OK //查询用长字符型表示当前已注册的网络营运商 6.2. AT+CREG 网络注册信息 语法 AT+CREG 网络注册信息 测试命令 AT+CREG=? 响应 +CREG: (取值列表) 上海移远通信技术有限公司 72 / 256 M26 AT 命令手册 查询命令 AT+CREG? OK 响应 用 户 终端 返回 结果 码显 示状 态 ，返 回一 个整 数 ， 表 示 ME 是否已经注册。仅当=2 并且 ME 已经在网络中注册时， 返回未知信息和. +CREG: ,[,,] 配置命令 OK +CME ERROR: 响应 AT+CREG= OK 最大响应时间 参考 GSM 07.07 300ms l 参数 te uec tial Q fiden 0 禁用网络注册非请求结果码 1 启用网络注册非请求结果码+CREG: 2 启用网络注册和位置信息非请求结果码+CREG: [,,] 0 未注册；ME 当前没有搜索到要注册业务的新营运商 1 已注册，本地网 2 未注册，但 ME 正在搜索要注册业务的新营运商 3 注册被拒绝 4 未知 5 已注册，漫游 字符型：二个字节（16 进制格式）位置区编号 字符型：二个字节（16 进制格式）小区 ID n 备注 o URC 上报： C 1. 当=1 时，MT 的网络注册状态有变化，上报：+CREG: 2. 当=2 时，MT 的网络注册状态有变化或者网络 CELL 有变化上报：+CREG: [,,] 举例 AT+CREG=1 OK +CREG: 1 AT+CREG=2 //已注册 上海移远通信技术有限公司 73 / 256 OK +CREG: 1,'1878','0873' //带小区 ID 和位置区号 M26 AT 命令手册 6.3. AT+CSQ 信号质量 语法 AT+CSQ 信号质量 测试命令 响应 AT+CSQ=? 执行命令 l AT+CSQ cte l 最大响应时间 ue tia 参考 GSM 07.07 +CSQ: (取值列表),(取值列表) OK 响应 +CSQ: , OK +CME ERROR: 300ms Q n 参数 fide Con 0 小于等于-113 dB 1 -111 dBm 2...30 -109... -53 dBm 31 大于等于-51 dBm 99 未知或不可测 （百分比格式）： 0...7 RXQUA 值，参考 GSM05.08[20]章节 7.2.4 99 未知或不可测 举例 AT+CSQ=? +CSQ: (0-31,99),(0-7,99) OK AT+CSQ +CSQ: 28,0 上海移远通信技术有限公司 74 / 256 OK //查询当前 CSQ 信号值为 28，误码率为 0 M26 AT 命令手册 6.4. AT+CPOL 优选运营商列表 语法 AT+CPOL 优选运营商列表 测试命令 AT+CPOL=? 响应 +CPOL: (取值列表),(取值列表) 查询命令 l AT+CPOL? OK 响应 +CPOL: ,, [+CPOL: ,, […]] uecte tial 配置命令 AT+CPOL=[,[,]] Q n 最大响应时间 e 参考 fid GSM 07.07 OK +CME ERROR: 响应 OK ERROR +CME ERROR: 300ms 参数 on C 整数型；SIM 卡优选运营商列表中运营商的序号 0 长字符串型（采用字母数字格式）的 1 短字符串型（采用字母数字格式）的 2 数字型的 字符型；指明该格式采用字母数字混编方式还是数字方式（参考 AT+COPS） 备注 有些 SIM 卡不支持写入新的运营商列表。 上海移远通信技术有限公司 75 / 256 M26 AT 命令手册 6.5. AT+COPN 查询运营商列表 语法 AT+COPN 查询运营商列表 测试命令 AT+COPN=? 执行命令 AT+COPN 响应 OK 响应 +COPN: , [+COPN: , […]] 最大响应时间 l 参考 GSM 07.07 OK +CME ERROR: 300ms cte l 参数 ue tia 字符型；数字格式的运营商（请参考 AT+COPS） 字符型；长字符串格式（采用字母数字格式）的运营商（请参考 AT+COPS） Q n 备注 e 1. AT+COPN 命令运行结束后，返回营运商列表并输出 OK ； fid 2. AT+COPN 命令运行时，返回 OK 前不可再次运行该命令或其他命令，否则会出现异常。 Con 6.6. AT+QBAND 查询运营商列表 语法 AT+QBAND 查询运营商列表 测试命令 AT+QBAND=? 响应 +QBAND: (取值列表) 查询命令 AT+QBAND? OK 响应 +QBAND: 上海移远通信技术有限公司 76 / 256 M26 AT 命令手册 配置命令 AT+QBAND= 最大响应时间 参考 Quectel OK 响应 OK ERROR +CME ERROR: 30s，受网络状态影响 参数 ctel l 字符串参数，以下是支持的频段列表 'EGSM_MODE' 'DCS_MODE' 'PCS_MODE' 'GSM850_MODE' 'EGSM_DCS_MODE' 'GSM850_PCS_MODE' 'GSM850_EGSM_DCS_PCS_MODE' ue tia 备注 Q n 频段设置信息存放在用户不可擦写的存储区域。 fide 6.7. AT+QENG 开启或关闭工程模式 n 该命令可用于获取当前服务小区及邻近的 1~6 个小区信息。 Co 语法 AT+QENG 开启或关闭工程模式 测试命令 响应 AT+QENG=? +QENG: (取值列表),(取值列表) 查询命令 AT+QENG? OK 响应 小区信息提示类型由参数控制： +QENG: , 上海移远通信技术有限公司 77 / 256 M26 AT 命令手册 当前服务小区信息提示： +QENG: 0,,,,,,,,,,,,,,,,, 邻近 1~6 小区信息提示： [+QENG:1,list of (,,,,, ,, ,,)相邻小区列表] OK ctel l 配置命令 ue tia AT+QENG =[,] Q n 最大响应时间 参考 e Quectel 获取载波列表： [+QENG: 2,list of ()…] BA 内的测量频点列表： [+QENG: 4,record number of the list, list of (,,)] OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 n Co 0 关闭工程模式，字段被忽略 1 开启工程模式 2 开启工程模式，并激活自动上报网络信息 0 只提示当前服务小区信息 1 显示当前服务小区信息及邻近 1~6 个小区信息 2 显示当前服务小区信息及载波列表 3 显示当前服务小区信息，邻近 1~6 个小区信息以及载波列表 4 显示当前服务小区信息，邻近 1~6 个小区信息，载波列表以及 BA 测量结果列表 移动国家码 移动网络码 位置区号码，十六进制数据 小区号，十六进制数据 BCCH 信道的绝对无线频道编号 上海移远通信技术有限公司 78 / 256 M26 AT 命令手册 基站识别码 以 dBm 为单位的接收信号等级 C1 值 C2 值 访问一个 CCH 信道时的最大发射功率等级 允许访问系统的最小接收信号等级 TCH 信道的绝对无线频道编号，'h'道的表示跳频 时序号 MAIO 值 HSN 值 时间提前量，范围 0~63 接收质量 (sub), 范围是 0-7 接收质量 (full), 范围是 0-7 相邻 6 个小区的序号 1~6 频点号 备注 l 1. 当=2 时，每 5 秒自动上报 URC 提示； te 2. 参数和为十六进制数据；其他数据为十进制数据； 3. 如果未检测到区域数据，参数将被„x‟字符代替； c l 4. 如果不是检测专有模式，参数, , , , , , 不显示参 ue tia 数值，以字符„x‟代替； 5. 在一个连接中，如果网络支持跳频，那么 TCH 信道是不稳定的。在这种模式下使用‟h‟进行表 示； Q n 6. 在专有模式下，当前服务小区的和不能更新，用„-1‟表示非法值进行显示。同时，和 在一定的条件下也不能更新，仍然保持在空闲模式下的值。这是因为在这种模式下，ME 不能 e 更新小区选择和重选的参数。当连接结束时，移动设备回到空闲模式，将给出正确的值； 7. 如果 TA 报告临近小区的信息，临近 6 个小区的信息将上报。如果有的小区信息无法测量，„x‟将填写 fid 在这些小区的参数中； 8. 在专有模式中,临近小区的和参数可能被测量到，并上报一个无意义的值。临近小区的 , , 和 参数无法被测量，'x'将填写在所有 6 个小区的这些参数中； n 9. 命令不报告接收信号等级和接收质量，AT+CSQ 可用于获取这两个参数； 10. AT+QSPCH 可以用于在通话过程中重新获取语音信道类型 (FR, HR, EFR, AMR_FR, AMR_HR)； o 11. BA 测量结果列表最多支持 32 个，若有 BCCH 值无法获取基站信息，则以'x'代替。该值仅包括 BA C 列表中的所有已测量的 BCCH 值，非整个 BA 列表。 举例 空闲模式： AT+QENG=2 OK +QENG: 0,460,00,1806,2602,64,46,-72,119,119,5,8,x,x,x,x,x,x,x 上海移远通信技术有限公司 79 / 256 M26 AT 命令手册 专有检测模式： AT+QENG=2,3 OK +QENG: 0,460,00,1806,2031,17,41,-73,-1,-1,5,8,h,7,0,24,1,0,1 +QENG: 1,1,17,-74,41,111,95,460,00,1806,2031,2,2,-74,45,110,94,460,00,1878,151,3,22,-77,40,100,84,460,00,1 806,2012,4,24,-77,45,97,81,460,00,1806,2013,5,25,-81,40,83,67,460,00,1806,2032,6,532,-92,48,-1,-1,x ,x,x,x //注：该功能模式需特殊版本支持 6.8. AT+QSCANF GSM 频率功率扫描 l 语法 te AT+QSCANF GSM 频率功率扫描 测试命令 c l AT+QSCANF=? 响应 +QSCANF: (取值列表),(取值列表) ue tia 配置命令 Q nfiden AT+QSCANF=, OK 响应 当=9999，且执行成功返回： +QSCANF: 1, CH113, -63.5 2, CH80, -64.2 4, CH22, -64.5 ….. 20, CH116, -74.2 OK o 当为指定参数值，且执行成功返回： C +QSCANF: CH, 最大响应时间 参考 Quectel 如果执行失败，返回： +CME ERROR: 300ms 上海移远通信技术有限公司 80 / 256 M26 AT 命令手册 参数 0 BAND 900 1 BAND 1800 2 BAND 1900 3 BAND 850 9999 扫描所有频段频率 0-1023 扫描指定频段频率 频率信号强度，单位 dbm 备注 进行频率功率扫描操作，需确保 ME 的 RF 功能已关闭，即 AT+CFUN=0 或 4。关于如何使用 AT+CFUN 切换功能模式状态，请参考 AT+CFUN 命令。 l 6.9. AT+QLOCKF 锁 GSM 频率 cte l 语法 ue tia AT+QLOCKF 锁GSM频率 测试命令 Q n AT+QLOCKF=? 响应 +QLOCKF: ( 取 值 列 表 ),( 取 值 列 表) ,( 取值列表) fide 查询命令 AT+QLOCKF? OK 响应 +QLOCKF: n 配置命令 o AT+QLOCKF=,,< C arfcn1>[,[,]] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 81 / 256 M26 AT 命令手册 参数 0 1 2 0 1 2 0-1024 0 1 关闭频锁功能 开启频锁功能 开启锁频功能并开机自动切换到上次锁定的频点 非 1900 频段小区 1900 频段小区 自动选择是否 1900 频段小区 频率信息 ME 未指定锁于一个指定频率 ME 指定锁于一个指定频率 CQouneficdteenl tial 上海移远通信技术有限公司 82 / 256 M26 AT 命令手册 7 呼叫控制命令 7.1. ATA 呼叫应答 语法 ATA 呼叫应答 执行命令 ATA Quectenl tial 最大响应时间 e 参考 V.25ter 响应 语音呼叫并成功建立连接，响应为： OK 若不能建立连接，响应为： NO CARRIER 若无呼叫进入时操作，响应为： +CME ERROR: 1s，受网络状态影响 fid 备注 n 1. ATA 操作忽略同一行命令中 A 后面的附加命令； o 2. 在执行 ATA 操作过程中收到某一字符，该命令可能被中止执行。但是在建立连接的某些状态中（如： 握手状态），该命令不会被中断； C 3. 该命令无需以终止符作为结尾。 举例 RING AT+CLCC +CLCC: 1,1,4,0,0,'02154450290',129,'' OK //语音呼叫呼入 ATA //接听语音呼叫 上海移远通信技术有限公司 83 / 256 M26 AT 命令手册 OK 7.2. ATD 移动台呼叫某一号码 该命令用于建立语音、数据或传真的主叫，还可以用于控制补充业务。 语法 ATD 移动台呼叫某一号码 执行命令 响应 ATD[][;] Quecteenl tial 最大响应时间 fid 参考 V.25ter 若没有拨号音且（参数设置 ATX2 或者 ATX4），返回： NO DIALTONE 若遇忙占线（参数设置 ATX3 或者 ATX4），返回： BUSY 若连接无法建立成功或对方无应答，返回： NO CARRIER 若连接成功且为语音呼叫，返回： OK 其他功能操作错误，响应为： +CME ERROR: 1s，受网络状态影响 n 参数 Co 拨号位字符串和可选配 V.25ter 修改量： 拨号位：0-9，*，#，+，A，B，C 以下 V.25ter 拨号修改量可忽略： ,（逗号），T，P，!，W，@ 紧急呼叫： 标准的紧急呼叫号码 112（不需要 SIM 卡） GSM 修改量字符串： I 激活 CLIR（主叫用户不允许在被叫用户话机上显示自己的电话号码） i 禁止 CLIR（主叫用户允许在被叫用户话机上显示自己的电话号码） G 仅为本次呼叫激活闭合用户组请求 g 仅为本次呼叫不激活闭合用户组请求 上海移远通信技术有限公司 84 / 256 仅用来建立语音呼叫，TA 保持命令模式不变 M26 AT 命令手册 备注 1. 若在执行 ATD 过程中收到 ATH 命令，该命令可能被终止执行。但是在建立连接的某些状态（如：握 手状态），该命令不会被中止执行； 2. 参数'I'和'i'仅适用于拨号字符中无'*#'码的情况； 3. 默认为最后的号码，此号码可以使用 ATDL 来拨号； 4. 带有'*#'码的 ATD 命令将被作为语音呼叫处理，因此，该命令必须以分号';'结尾； 5. 关于结果码的设置和呼叫监控参数的详细介绍，请参考 ATX 命令； 6. ATD 命令的响应： 对于语音呼叫，可设置两种不同的响应模式：  在 TA 拨号完成后或者在呼叫建立成功后，立即返回 OK。 此设置由 AT+COLP 命令控制。出厂默认设置为 AT+COLP=0，这将使得 TA 在拨号完成后， 立即返回 OK。除此之外，TA 将返回'BUSY'，'NO DIALTONE'，'NO CARRIER'。 l  在一个已激活的语音呼叫中，使用 ATD： 在已存在一个已激活的语音呼叫时，用户发起了第二个语音呼叫，此时第一个语音呼叫将被自 te 动的设置为呼叫保持状态，所有呼叫的当前状态，可以随时使用 AT+CLCC 进行查询。 c l 举例 ue tia ATD10086; OK //ATD 建立语音呼叫 Q en 7.3. ATH 挂机控制 fid 该命令可以终止当前所有的通话。 n 语法 o ATH 挂机控制 C 执行命令 响应 ATH[0] OK 最大响应时间 参考 V.25ter 90s，受网络状态影响 上海移远通信技术有限公司 85 / 256 备注 在 Circuit109 (DCD)关闭后，返回 OK。 M26 AT 命令手册 7.4. +++ 数据模式切换至命令模式 该命令可以将 ME 从数据模式切换至 AT 命令模式。 语法 +++ 数据模式切换至命令模式 执行命令 +++ tel 最大响应时间 参考 c l V.25ter 响应 OK ERROR +CME ERROR: 300ms ue tia 备注 Q n 1. 为避免'+++'被错误的识别为数据，需遵循以下注意事项：  '+++'输入前 T1 时间（0.5 秒）内无字符 e  连续输入'+++'，中间不能有其他字符；每个+间隔时间不能超过 1 秒，TCP 透传应用下每个+ fid 间隔不能超过 20ms.  '+++'输入后 T1 时间（0.5 秒）内无字符输入 2. 切换至命令模式，否则重新进入步骤 1； n 3. 可通过 AT 命令 ATO，从命令模式返回数据模式。 Co 7.5. ATO 命令模式切换至数据模式 该命令可以将 ME 从 AT 命令模式切换至数据模式。 语法 ATO 命令模式切换至数据模式 执行命令 ATO[n] 响应 TA 保持数据传输连接，从命令模式切换回数据模式： 上海移远通信技术有限公司 86 / 256 M26 AT 命令手册 最大响应时间 参考 V.25ter CONNECT /CONNECT 若无法恢复至数据模式： NO CARRIER 其他功能操作错误，响应为： +CME ERROR: 300ms 参数 0 从 AT 命令模式切换至数据模式 tel 备注 c l 1. TA 从命令模式返回至数据模式 CONNECT，只有当 ATX中设置大于 0 时， 才输出； ue tia 2. 可以是速率、差错控制等。 Q n 7.6. ATP 选择脉冲拨号 fide 操作 ATP 设置为脉冲拨号。 语法 n ATP 选择脉冲拨号 o 执行命令 响应 C ATP OK 最大响应时间 300ms 参考 V.25ter 备注 GSM 无效。 上海移远通信技术有限公司 87 / 256 M26 AT 命令手册 7.7. ATS0 自动应答前振铃次数 该命令用于设置自动应答前的振铃次数。若设置为非零取值，呼叫指示（RING）达到设置次数后， ME 自动应答。 语法 ATS0 自动应答前振铃次数 查询命令 响应 ATS0? OK 配置命令 ATS0= 最大响应时间 l 参考 te V.25ter 响应 OK 300ms c l 参数 ue tia 0 禁用自动应答（默认） 1~255 达到指定的振铃次数后，启用自动应答 Q en 备注 fid 若值设置过高，呼叫方可能在呼叫被自动应答前停止呼叫。 n 举例 o ATS0=3 C OK //设置三次振铃后自动接听 RING RING RING //呼叫进入 //三次 RING 提示后，自动接听来电 上海移远通信技术有限公司 88 / 256 M26 AT 命令手册 7.8. ATS6 盲拨号前暂停控制 该命令用于盲拨号前暂停控制。当拨号音检测功能关闭，表示指定 DCE 在连线与拨号操作间需要 等待的秒数。 语法 ATS6 盲拨号前暂停控制 查询命令 响应 ATS6? OK 配置命令 ATS6= 最大响应时间 l 参考 te V.25ter 响应 OK 300ms c l 参数 ue tia 0-2-10 盲拨号前需要等待的秒数（默认为 2） Q en 备注 fid GSM无效。 Con 7.9. ATS7 等待呼叫建立完成时间 该命令可设置 TA 在应答或发起数据通话时，等待呼叫建立的秒数。 语法 ATS7 等待呼叫建立完成时间 查询命令 响应 ATS7? OK 上海移远通信技术有限公司 89 / 256 配置命令 ATS7= 最大响应时间 参考 V.25ter 响应 OK 300ms M26 AT 命令手册 参数 1-60-255 建立连接或释放呼叫所用的秒数 备注 1. 若 ATS0=设置的值太高，呼叫建立可能失败； 2. 确保 ATS7 与 ATS0 的正确设置，如：ATS7=20 和 ATS0=30，则呼叫建立失败； l 3. ATS7 仅用于数据连接。 cte l 7.10. ATS8 暂停拨号时间 ue tia 在拨号字符串中出现逗号拨号修改量时，使用该命令，可设置在建立到拨号网络的呼叫寻址信息信令 Q n 时，TA 暂停的秒数。 e 语法 fid ATS8 暂停拨号时间 查询命令 响应 ATS8? on 配置命令 C ATS8= OK 响应 OK 最大响应时间 300ms 参考 V.25ter 参数 0 1-2-255 拨号字符串中出现逗号时，禁止 DCE 中断 暂停的秒数 上海移远通信技术有限公司 90 / 256 备注 GSM 无效。 M26 AT 命令手册 7.11. ATS10 挂机延时 该命令可设置在 DCE 指示接收线路信号不存在后，DCE 连接到该线路的剩余时间。 语法 ATS10 挂机延时 查询命令 ATS10? tel 配置命令 ATS10= c l 最大响应时间 ue tia 参考 V.25ter Q n 参数 fide 1-15-254 响应 OK 响应 OK 300ms 以 100 毫秒为单位的时延 n 7.12. ATT 音频拨号 Co 该命令用于设置为 DTMF 音频拨号。 语法 ATT 音频拨号 执行命令 ATT 最大响应时间 响应 OK 300ms 上海移远通信技术有限公司 91 / 256 参考 V.25ter 备注 GSM 无效。 M26 AT 命令手册 7.13. AT+CSTA 选择地址类型 根据 GSM 规范，该命令可选择拨号命令（ATD）的号码类型。 语法 l AT+CSTA 选择地址类型 测试命令 te AT+CSTA=? 响应 +CSTA: (取值列表) uec tial 查询命令 AT+CSTA? OK 响应 +CSTA: Q en 最大响应时间 参考 fid GSM 07.07 OK 300ms n 参数 o 129 未知类型，默认值（IDSN 格式号码） C145 拨号字符串包含国际接入代码字符'+'（ISDN 格式号码） 161 国家号码类型（IDSN 格式号码） 其他 参考 GSM04.08[8]第 10.5.4.7 小节 7.14. AT+CLCC 查询当前呼叫 该命令用于查询当前 ME 对 TE 的呼叫。 上海移远通信技术有限公司 92 / 256 M26 AT 命令手册 语法 AT+CLCC 查询当前呼叫 测试命令 响应 AT+CLCC=? OK 执行命令 响应 AT+CLCC 如果命令成功但是没有呼叫，将不会有信息发送到 TE，只返 回 OK [+CLCC: ,,,,[,,[,' ']] [+CLCC: ,,,,[, ctel l 最大响应时间 参考 ue tia GSM07.07 ,[,'']] [...]]] OK 功能错误则返回： +CME ERROR: 300ms Q n 参数 e fid Con 整数型，呼叫识别号（参考 GSM 02.30 第 4.5.5.1 小节）；该参数可被使用在 AT+CHLD 0 移动发起的呼叫 1 移动终止的呼叫 呼叫状态 0 激活中 1 保持中 2 拨号中（MO 呼叫） 3 振铃中（MO 呼叫） 4 入局呼叫（MT 呼叫） 5 等待中（MT 呼叫） 承载/电信业务 0 语音 1 数据 2 传真 9 未知 0 呼叫不参加多方通话（如：会议） 1 呼叫参加多方通话（如：会议） 字符型；由规定的电话号码格式 上海移远通信技术有限公司 93 / 256 M26 AT 命令手册 指定的字符型电话号码 129 未知类型（IDSN 格式） 145 国际号码（IDSN 格式） 举例 AT+CLCC +CLCC: 1,0,0,0,0,'10086',129,'' OK //ME 当前存在已建立连接的主叫语音通话 7.15. AT+CR 业务上报控制 该命令用于控制是否将中间结果码+CR: 从 TA 返回给 TE。若返回，则该中间结果码将在连接 l 传输过程中的某一点上进行传输。与此同时，在传输差错控制或数据压缩报告之前，以及传输中间结果码 CONNECT 之前，TA 已经在连接传输过程中决定了所用业务的速率和质量。 cte l 语法 ue tia AT+CR 业务上报控制 测试命令 AT+CR=? 响应 +CR: (取值列表) Q en 查询命令 AT+CR? OK 响应 +CR: fid 配置命令 Con AT+CR=[] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 URC 提示： +CR: 参数 0 1 ASYNC 禁用上报 启用上报 异步透传 上海移远通信技术有限公司 94 / 256 SYNC 同步透传 REL ASYNC 异步非透传 REL SYNC 同步非透传 M26 AT 命令手册 7.16. AT+CRC 蜂窝结果码 该命令用于控制呼入指示或用于 PDP 上下文激活的 GPRS 网络请求是否使用扩展格式。若使用该格式， 则将使用非请求结果码+CRING: 把来电提示给 TE，而不是使用一般的铃音。 语法 AT+CRC 蜂窝结果码 测试命令 AT+CRC=? tel 查询命令 c l AT+CRC? ue tia 配置命令 AT+CRC=[] Q en 最大响应时间 fid 参考 GSM 07.07 n 参数 Co 0 禁用扩展格式 响应 +CRC: (取值列表) OK 响应 +CRC: OK 响应 OK ERROR +CME ERROR: 300ms URC 提示： +CRING: 1 启用扩展格式 举例 AT+CRC=1 OK +CRING: VOICE ATH OK //启用扩展格式 //语音来电提示 上海移远通信技术有限公司 95 / 256 AT+CRC=0 OK RING ATH OK //禁用扩展格式 //语音来电提示 M26 AT 命令手册 7.17. AT+CRLP 无线链路协议 该命令用于发起非透明数据传输呼叫。用户中断返回 RLP 版本的当前设置。RLP 版本 0 和 1 有相同的 参数集。用户终端仅仅返回这个集合的一行（不会显示出来）。 语法 l AT+CRLP 无线链路协议 测试命令 te AT+CRLP=? 响应 +CRLP: (取值列表), (取值列表), (取值列 表), (取值列表), (取值列表), (取值列表) uec tial 查询命令 AT+CRLP? OK 响应 +CRLP: ,,,,, Q en 配置命令 AT+CRLP=[[,[,[,[,[,]]]]]] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms n 参考 Co GSM 07.07 参数 0-61 0-61 39-255 1-255 0 3-255 交互串口大小（IWF 到 MS） 移动串口大小（MS 到 IWF） 确认定时器 T1（10ms 单元） 重传尝试 N2 RLP 版本号 整形格式的重拍间隔（单位 10ms） 上海移远通信技术有限公司 96 / 256 M26 AT 命令手册 7.18. AT+CSNS 单一编码方案 移动台作为被叫，建立单一编码方案的呼叫时，该命令可以设置承载或电信业务。 语法 AT+CSNS 单一编码方案 测试命令 AT+CSNS=? 响应 +CSNS: (取值列表) OK 查询命令 响应 AT+CSNS? 配置命令 l AT+CSNS=[] cte l 最大响应时间 参考 ue tia GSM07.07 +CSNS: OK 响应 OK ERROR +CME ERROR: 300ms Q n 参数 e < mode> 0 fid 1 2 3 n 4 5 o 6 C7 语音 语音/传真交替模式，语音优先 传真 语音/数据交替模式，语音优先 数据 语音/传真交替模式，传真优先 语音/数据交替模式，数据优先 数据跟随语音模式 7.19. AT+CMOD 呼叫模式 该命令用于选择后续的呼叫命令（ATD）或下一次应答命令（ATA）的呼叫模式。可以是单一模式，也 可以是交替模式（详情请参考 GSM 承载或电信业务，可以再一次呼叫中整合多种基本业务，如：语音、数 据和传真），呼叫发起和挂起流程与 ITU-T Recommendations V.25ter[14]中描述的步骤类似。 上海移远通信技术有限公司 97 / 256 M26 AT 命令手册 语法 AT+CMOD 呼叫模式 测试命令 AT+CMOD=? 响应 +CMOD: (取值列表) 配置命令 OK 响应 AT+CMOD=[] OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 l 参数 te 0 1 c l 2 ue tia 3 单一模式 语音/传真交替模式 语音/数据交替模式 数据跟随语音模式 Q n 7.20. AT+QSFR 配置语音编码模式 fide 语法 AT+QSFR 配置语音编码模式 测试命令 n AT+QSFR=? Co 查询命令 响应 +QSFR: (取值列表) OK 响应 AT+QSFR? +QSFR: 配置命令 AT+QSFR= 最大响应时间 OK 响应 OK ERROR +CME ERROR: 300ms 上海移远通信技术有限公司 98 / 256 参考 Quectel M26 AT 命令手册 参数 0 自动 1 FR 2 HR 3 EFR 4 AMR_FR 5 AMR_HR 6 FR 和 EFR，FR 优先 7 EFR 和 FR，EFR 优先 8 EFR 和 HR，EFR 优先 9 EFR 和 AMR_FR，EFR 优先 10 AMR_FR 和 FR，AMR_FR 优先 l 11 AMR_FR 和 HR，AMR_FR 优先 te 12 AMR_FR 和 EFR，AMR_FR 优先 13 AMR_HR 和 FR，AMR_HR 优先 c l 14 AMR_HR 和 HR，AMR_HR 优先 15 AMR_HR 和 EFR，AMR_HR 优先 ue tia 备注 Q n 该命令配置自动保存，重启有效。 fide 7.21. AT+QSPCH 语音信道类型上报 on 语法 C AT+QSPCH 语音信道类型上报 测试命令 响应 AT+QSPCH=? +QSPCH: (取值列表) 查询命令 AT+QSPCH? OK 响应 +QSPCH: , OK 上海移远通信技术有限公司 99 / 256 配置命令 AT+QSPCH= 最大响应时间 参考 Quectel M26 AT 命令手册 响应 OK ERROR +CME ERROR: 300ms 当语音信道类型发生变化时，URC 上报： +QSPCH: , 参数 0 关闭上报 ctel l 1 开启上报 语音通道类型 0 NO SPEECH TCH 1 FR 2 HR 3 EFR 4 AMR_FR 5 AMR_HR ue tia 7.22. AT+QDISH ATH 使能控制 Q n 语法 e AT+QDISH ATH 使能控制 fid 测试命令 AT+QDISH=? on 查询命令 C AT+QDISH? 响应 +QDISH: (取值列表) OK 响应 +QDISH: 配置命令 AT+QDISH= 最大响应时间 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms 上海移远通信技术有限公司 100 / 256 参数 0 ATH 命令有效 1 ATH 命令无效 M26 AT 命令手册 CQouneficdteenl tial 上海移远通信技术有限公司 101 / 256 M26 AT 命令手册 8 短消息相关命令 8.1. AT+CSMS 选择短消息业务 语法 AT+CSMS 选择短消息业务 测试命令 l AT+CSMS=? te 查询命令 c l AT+CSMS? ue tia 配置命令 Q n AT+CSMS= fide 最大响应时间 n 参考 GSM 07.05 Co 参数 响应 +CSMS: (取值列表) OK 响应 +CSMS: ,,, OK 响应 +CSMS: ,, OK ERROR +CMS ERROR: 300ms 0 GSM 03.40 和 03.41（SMS 的 AT 命令语法与 GSM07.05 Phase 2 中的 4.7.0 版本兼 容；支持不需要新命令语法的 Phase 2+特性（比如：使用 Phase 2+新编码方案的消息 路由）） 128 PDU 模式- TPDU 仅用于发送/接收短消息 移动终止的消息 0 类型不支持 1 类型支持 移动发起的消息 上海移远通信技术有限公司 102 / 256 0 类型不支持 1 类型支持 广播类型的消息 0 类型不支持 1 类型支持 M26 AT 命令手册 8.2. AT+CMGF 配置短消息模式 该命令用于指定短消息的输入和发送的模式。 语法 AT+CMGF 配置短消息模式 测试命令 l AT+CMGF=? te 查询命令 c l AT+CMGF? ue tia 配置命令 Q n AT+CMGF=[] fide 最大响应时间 参考 GSM 07.05 Con 参数 响应 +CMGF: (取值列表) OK 响应 +CMGF: OK 响应 OK ERROR +CMS ERROR: 300ms 0 PDU 模式 1 文本模式 8.3. AT+CSCA 短消息服务中心地址 该命令用于设置 SMSC（Short Message Service Center，短消息服务中心）地址。通过该地址，可以 发送 SMS。文本模式下，发送和配置命令都可以使用该项设置。 上海移远通信技术有限公司 103 / 256 M26 AT 命令手册 PDU 模式下，发送和配置命令也可以使用该项设置，但条件是编码后的 SMSC 地址长度等于 0，编码 后的 SMSC 地址用参数表示。 语法 AT+CSCA 短消息服务中心地址 测试命令 AT+CSCA=? 查询命令 AT+CSCA? 响应 OK 响应 +CSCA: , OK 配置命令 AT+CSCA=[,] l 最大响应时间 te 参考 GSM 07.05 响应 OK ERROR +CMS ERROR: 300ms uec tial 参数 Q n GSM 04.11 RP SC 使用字符型的地址取值字段； BCD 数字（或 GSM 缺省字母字符）需转换为字符；指定的地址类型 服务中心地址格式；GSM 04.11 RP SC 使用整数型的 8 位地址类型（缺省值请参考） fide 备注 1. 输入 SMS 服务中心地址时应该使用服务供应商规定的格式； n 2. 该命令配置可通过 AT+CSAS 保存至 SIM 卡内； 3. 强烈建议使用过程中不要改写 SIM 卡的 SMS 服务中心地址。 Co 举例 AT+CSCA='+8613800210500',145 OK AT+CSCA? +CSCA: '+8613800210500',145 //配置短消息服务中心号码 OK //查询短消息服务中心号码 上海移远通信技术有限公司 104 / 256 M26 AT 命令手册 8.4. AT+CPMS 选择短消息存储器 该命令用于选择读取、存储等操作的存储器，包括，和。 语法 AT+CPMS 选择短消息存储器 测试命令 AT+CPMS=? 响应 +CPMS: (取值列表),(取值列表),( 取值列表) OK 查询命令 l AT+CPMS? 响应 +CPMS: ,,,,,,< mem3>,, te 配置命令 c l AT+CPMS=[,[,]] ue tia 最大响应时间 Q n 参考 GSM 07.05 OK 响应 OK ERROR +CMS ERROR: 300ms fide 参数 Con 读取和删除 SMS 时使用的存储器 'SM' SIM 卡 SMS 存储器 'ME' ME SMS 存储器 'MT' SIM 卡和 ME SMS 存储器 存储和发送 SMS 时使用的存储器 'SM' SIM 卡 SMS 存储器 'ME' ME SMS 存储器 'MT' SIM 卡和 ME SMS 存储器 若没有建立到 TE 的路由，则将接收的 SMS 存储在该存储器内（AT+CNMI） 'SM' SIM 卡 SMS 存储器 'ME' ME SMS 存储器 'MT' SIM 卡和 ME SMS 存储器 整数型；中当前 SMS 的数量 整数型；中可存储的 SMS 的数量 上海移远通信技术有限公司 105 / 256 M26 AT 命令手册 备注 SIM 卡和 ME 总共最多支持 60 条短消息，其中 SIM 卡优先分配存储空间。SIM 卡最多支持 50 条（各 SIM 的支持条数不一致），ME 最多支持 10 条。 举例 AT+CPMS='SM','SM','SM' +CPMS: 0,50,0,50,0,50 OK //将短消息存储器更改为 SM AT+CPMS? +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 OK //查询当前短消息存储器配置 tel 8.5. AT+CMGD 删除短消息 c l 该命令可删除优选短消息存储器中，位置号码参数为的消息。 ue tia 语法 AT+CMGD 删除短消息 Q n 测试命令 e AT+CMGD=? 响应 +CMGD: (取值列表),(取值列表) fid 配置命令 AT+CMGD=[,] Con 最大响应时间 OK 响应 OK ERROR +CMS ERROR: 取决于待删除短消息的数目 参考 GSM 07.05 参数 整数型；关联存储器支持的地址编号范围内的取值 0 删除指定的短信 1 全部删除存储器中的已读短信 2 全部删除存储器中的已读和已发送短信 上海移远通信技术有限公司 106 / 256 M26 AT 命令手册 3 全部删除存储器中的已读、已发送和未发送短信 4 全部删除存储器中的已读、未读、已发送和未发送短信 备注 如果当前存储器中没有短信，操作 AT+CMGD 删除动作，仍返回 OK。 举例 AT+CMGD=1 OK //删除当前存储器中第一条短信 AT+CMGD=1,4 OK //删除当前存储器中全部短信 l 8.6. AT+CMGL 列出优选短消息存储器中的短消息 cte l 该命令可查询优选短消息存储器中，状态值为的消息显示在 TE 中。当=0 或 缺省时，若该短消息处于'已接收未读'状态，则将其状态变为'已接收已读'。当=1 时，若该短消息 ue tia 处于'已接收未读'状态，读取之后消息状态不发生改变。 语法 Q n AT+CMGL 列出优选短消息存储器中的短消息 e 测试命令 响应 AT+CMGL=? +CMGL: (取值列表) fid 配置命令 Con AT+CMGL=[,] OK 响应 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-SUBMIT 和/或 SMS-DELIVER： +CMGL: ,,,[],[][,, ][ +CMGL: ,,,[],[][,, ][...]] 对于 SMS-STATUS-REPORT： +CMGL: ,,,,[],[],,,[ 上海移远通信技术有限公司 107 / 256 M26 AT 命令手册 +CMGL: ,,,,[],[],,,[...]] 对于 SMS-COMMAND： +CMGL: ,,,[ +CMGL: , , , [...]] 最大响应时间 参考 GSM 07.05 参数 对于 CBM 存储： +CMGL: ,,,,,< data>[ +CMGL: ,,,,,< data>[...]] OK l 2）PDU 模式（AT+CMGF=0）且该命令执行成功： te +CMGL: ,,[], c l ue tia +CMGL: ,,[alpha], [...]] OK Q n 3）功能相关错误： e +CMS ERROR: 取决于待列举短消息的数目 Confid 1）文本模式 'REC UNREAD' 已接收但未读的短消息 'REC READ' 已接收且已读的短消息 'STO UNSENT' 已存储但未发送的短消息 'STO SENT' 已存储且已发送的短消息 'ALL' 所有短消息 2）PDU 模式 0 已接收但未读的短消息 1 已接收且已读的短消息 2 已存储但未发送的短消息 上海移远通信技术有限公司 108 / 256 M26 AT 命令手册 3 已存储且已发送的短消息 4 所有短消息 0 正常（缺省） 1 不改变指定短消息记录状态 字符型；在字母数字混编模式下，MT 电话簿记录对应的或的显示；该特征的 应用与制造商有关；所使用的字符集应与使用'选择 TE 字符集'命令 AT+CSCS 选择的 字符集相同（请参考 TS 07.07 中对该命令的定义） 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 短消息情况下：GSM 03.40 TP-User-Data 在文本模式下返回，格式定义如下： − 若指定用 GSM 03.38 缺省字母格式字符，且指定 GSM 03.40，则没有 设置 TPUser-Data-Header-Indication − 若 TE 字符集不为十六进制数据（参考 TS 07.07 中的 AT+CSCS 命令选择的 TE 字符集）；则根据 Annex A 规则，ME/TA 将 GSM 字母格式字符转换为当前 TE 的字符集 l − 若 TE 字符集为十六进制数据，则 ME/TA 将 GSM 字母格式字符的每个 7 位字符 转换为两个 IRA 字符表示的十六进制书（如字符 P（GSM 32）作为 17（IRA 49 te 和 55）） − 若指定用 8 位或 UCS2 编码方案，或指定 GSM03.40；则设置 c l TPUser-Data-Header-Indication：ME/TA 将 GSM 字母格式字符的每个 8 位字符 ue tia 转换为用两个 IRA 表示的十六进制数（如：8 位字符代表的整数 42 传给 TE 时用 两个字符来表示 2A（IRA 50 和 65）） 小区广播情况下：GSM 03.41 CBM 消息内容，在文本模式下返回，格式定义如下： Q n − 若指定用 GSM 03.38 缺省字母格式字符，则 ME/TA 将 GSM 转换成当前 e TE 支持的字符 − 若 TE 字符集不为十六进制数（参考 TS 07.07 中的 AT+CSCS 命令选择的 TE 字 fid 符集）；则根据 Annex A 规则，ME/TA 将 GSM 字母格式字符转换为当前 TE 的 字符集 − 若 TE 字符集为十六进制数，则 ME/TA 将 GSM 字母格式字符的每个 7 位总字符 n 自己转换为两个 IRA 字符表示的十六进制数 − 若指定用 8 位或 UCS2 编码方案，或指定 GSM 03.40；则设置 oTPUser-Data-Header-Indication：ME/TA 将 GSM 字母格式字符的每个 8 位 字符 C转换为用两个 IRA 表示的 16 进制数 整数类型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文 的长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） 整数类型；在相应存储器支持的短消息容量内的值 字符型的 GSM 03.40 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（参考 TA 07.07 中的 AT+CSCS 命令）；给定的地址类型 ISDMS 情况下：GSM 03.40 TPDU。十六进制，遵循 GSM 04.11SC 地址；ME/TA 把 TP 数据单元中每个 8 位字符转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值 上海移远通信技术有限公司 109 / 256 M26 AT 命令手册 为 42 的 8 位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） 广播消息情况下：使用十六进制的 GSM 03.41 TPDU 使用'时间—字符串'格式的 GSM 03.40 TP-Service-Center-Time-Stamp（参考） 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 整数型的 GSM 04.11 TP-Originating-Address 中的 8 位'类型—地址'字段（参考 ） 备注 若直接执行 AT+CMGL，则默认为列举当前存储单元内的全部未读短消息。 举例 AT+CMGF=1 l OK //设置短信为文本模式 AT+CMGL='ALL' te +CMGL: 1,'STO UNSENT','','', This is a test from Quectel uec tial +CMGL: 2,'STOUNSENT','','', This is a test from Quectel,once again. Q n OK //列举当前存储单元中的所有短信 fide 8.7. AT+CMGR 读取短消息 该命令可将短消息存储器中，索引号为的短消息返回到 TE。当=0 或缺省时， n 若该短消息处于'已接收未读'状态，则将其状态变为'已接收已读'。当=1 时，若该短消息处于'已接 o 收未读'状态，读取之后短消息状态不发生改变。 C 语法 AT+CMGR 读取短消息 测试命令 AT+CMGR=? 执行命令 AT+CMGR=[,] 响应 OK 响应 1）文本模式（AT+CMGF=1）且该命令执行成功： 对于 SMS-DELIVER： +CMGR: ,,[],[,,,,,< 上海移远通信技术有限公司 110 / 256 M26 AT 命令手册 sca>,,] 对于 SMS-SUBMIT： +CMGR: ,,[][,,,,,[],< sca>,,] 对于 SMS-STATUS-REPORTs： +CMGR: ,,,[],[],,, 最大响应时间 参考 GSM 07.05 参数 对于 SMS-COMMANDs： +CMGR: ,,[,,[],[],[], ] l 对于 CBM storage： +CMGR: te ,,,,, uec tial 2）PDU模式（AT+CMGF=0）且该命令执行成功： +CMGR: ,[], OK Q en 3）功能相关报错： +CMS ERROR: Confid 取决于待读取短消息的内容长度 整数类型；关联存储器支持的地址编号范围内取值 0 正常（缺省） 1 不改变指定短消息记录状态 字符型；在字母数字混编模式下，MT 电话簿记录对应的或的显示；该特征的 应用与制造商有关；所使用的字符集应与使用'选择 TE 字符集'命令 AT+CSCS 选择的 字符集相同（请参考 TS 07.07 中对该命令的定义） 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 上海移远通信技术有限公司 111 / 256 M26 AT 命令手册 短消息情况下：GSM 03.40 TP-User-Data 在文本模式下返回，格式定义如下： − 若指定用 GSM 03.38 缺省字母格式字符，且指定 GSM 03.40，则 没有设置 TPUser-Data-Header-Indication − 若 TE 字符集不为十六进制数据（参考 TS 07.07 中的 AT+CSCS 命令选择的 TE 字符集）；则根据 Annex A 规则，ME/TA 将 GSM 字母格式字符转换为当前 TE 的字符集 − 若 TE 字符集为十六进制数据，则 ME/TA 将 GSM 字母格式字符的每个 7 位字符 转换为两个 IRA 字符表示的十六进制书（如字符 P（GSM 32）作为 17（IRA 49 和 55）） − 若指定用 8 位或 UCS2 编码方案，或指定 GSM03.40；则设置 TPUser-Data-Header-Indication：ME/TA 将 GSM 字母格式字符的每个 8 位 字符 转换为用两个 IRA 表示的十六进制数（如：8 位字符代表的整数 42 传给 TE 时用 两个字符来表示 2A（IRA 50 和 65）） − 小区广播情况下：GSM 03.41 CBM 消息内容，在文本模式下返回，格式定义如下： 若指定用 GSM 03.38 缺省字母格式字符，则 ME/TA 将 GSM 转换成当前 TE 支持的字符 l − 若 TE 字符集不为十六进制数（参考 TS 07.07 中的 AT+CSCS 命令选择的 TE 字 符集）；则根据 Annex A 规则，ME/TA 将 GSM 字母格式字符转换为当前 TE 的 te 字符集 − 若 TE 字符集为十六进制数，则 ME/TA 将 GSM 字母格式字符的每个 7 位总字符 c l 自己转换为两个 IRA 字符表示的十六进制数 ue tia − 若指定用 8 位或 UCS2 编码方案，或指定 GSM 03.40；则设置 TPUser-Data-Header-Indication：ME/TA 将 GSM 字母格式字符的每个 8 位字符 转换为用两个 IRA 表示的 16 进制数 取决于该命令或该命令结果码 GSM 03.38 中的 SMS 数据编码方案。（缺省值 0）或者 Q n 小区广播数据编码方案 e 取决于该命令结果码 GSM 03.40 SMS-DELIVER，SMS-SUBMIT（缺省值 17）， SMS-STATUS-REPORT 或采用整数型 SMS-COMMAND（缺省值 2） fid 整数型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文的 长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） n 整数型的 GSM 03.41 CBM 消息标识 字符型的 GSM 03.40 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 o（或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（参考 TA 07.07 C中的 AT+CSCS 命令）；给定的地址类型 ISDMS 情况下：GSM 03.40 TPDU。十六进制，遵循 GSM 04.11SC 地址；ME/TA 把 TP 数据单元中每个 8 位字符转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值 为 42 的 8 位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） 广播消息情况下：使用十六进制的 GSM 03.41 TPDU 参考 GSM03.40；TP-协议-标识（缺省值 0） GSM 04.11 中的 RP SC 地址是字符串型参数；将 BCD 数值（或缺省 GSM 默认字母 的字符）转换成 TE 当前选择字符集中的字符（参考 TS 07.07 中的 AT+CSCS 命令）； 用来指定地址类型 使用'时间—字符串'格式的 GSM03.40 TP-Service-Center-Time-Stamp（参考） 上海移远通信技术有限公司 112 / 256 M26 AT 命令手册 PDU 模式 文本模式 说明 0 'REC UNREAD' 已收到但未读的短消息 1 'REC READ' 已收到且已读的短消息 2 'STO UNSENT' 已存储但未发送的短消息 3 'STO SENT' 已存储且已发送的短消息 4 'ALL' 所有短消息 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 整数型的 GSM 04.11 TP-Originating-Address 中的 8 位'类型—地址'字段（参考 ） 服务中心地址格式；GSM 04.11 RP SC 使用整数型的 8 位地址类型（缺省值请参考 ） 取决于 SMS-SUBMIT 的的设置；采用整数型（缺省值 167），或时间—字符型（参 考）的 GSM 03.40 TP-有效期 备注 tel 如果当前存储器中没有短信，操作 AT+CMGR 读取短消息动作，仍返回 OK。 c l 举例 ue tia +CMTI:'SM',3 //新短消息达到，存储在 SIM 卡位置 3 内 AT+CMGR=3 Q n +CMGR: 'REC UNREAD','+8615021012496','','2010/09/25 15:06:37+32',145,4,0,241,'+8 613800210500',145,27 e This is a test from Quectel fid OK //读取当前存储器 SIM 卡中第 3 条短信 n 8.8. AT+CMGS 发送短消息 Co 该命令可将 SMS（SMS-SUBMIT）从 TE 发送到网络层。发送成功后，短消息参考值将返回给 TE。在接收到非请求发送状态报告结果码时，使用该取值可进行短消息识别。 语法 AT+CMGS 发送短消息 测试命令 响应 AT+CMGS=? OK 上海移远通信技术有限公司 113 / 256 M26 AT 命令手册 配置命令 1) 文本模式（AT+CMGF=1）： 响应 1）文本模式(AT+CMGF=1) 且发送成功： AT+CMGS=[,] text is entered ESC 退出发送 +CMGS: OK 2）PDU 模式(AT+CMGF=0)且发送成功： 2）PDU 模式（AT+CMGF=0）： +CMGS: OK +CMGS= PDU is given 3）功能相关报错： +CMS ERROR: 最大响应时间 120s，受网络状态影响 参考 GSM 07.05 l 参数 te uec tial Q en 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 整数型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文的 长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） 整数型的 GSM 03.40 TP-Message-Reference fid 备注 n 发送短消息详细操作请参考 GSM 模块短信应用指导文档。 Co 举例 发送文本短消息，GSM 格式： AT+CMGF=1 OK AT+CSCS='GSM' OK AT+CMGS='15021012496' > This is a test from Quectel +CMGS: 247 //设置文本短信模式 //设置 TE 输入字符集格式为'GSM'格式 //输入短信内容，发送，退出 上海移远通信技术有限公司 114 / 256 M26 AT 命令手册 OK 8.9. AT+CMGW 写短消息 该命令可将 SMS（SMS-DELIVER 或 SMS-SUBMIT）从 TE 发送到存储器，并返回已存储短 消息的存储位置参数。除非指定其他参数，否则该短消息的状态将被设置为'存储未发送'。 语法 AT+CMGW 写短消息 测试命令 AT+CMGW=? 配置命令 1）文本模式（AT+CMGF=1）： l AT+CMGW=[,[,]] te 文本输入 c l 退出发送 响应 OK 响应 1）写短消息成功，返回： +CMGW: OK 2）功能相关报错 +CMS ERROR: ue tia 2）PDU模式（AT+CMGF=0）： AT+CMGW=[,] Q n PDU is given 最大响应时间 e 参考 fid GSM 07.05 300ms n 参数 Co 字符型的 GSM 03.40 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（参考 TA 07.07 中的 AT+CSCS 命令）；给定的地址类型 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 整数型的 GSM 04.11 TP-Originating-Address 中的 8 位'类型—地址'字段（参考 ） 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 129 未知类型（IDSN 格式号码） 上海移远通信技术有限公司 115 / 256 M26 AT 命令手册 145 国际号码类型（IDSN 格式号码） 整数型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文的 长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） ISDMS 情况下：GSM 03.40 TPDU。十六进制，遵循 GSM 04.11SC 地址；ME/TA 把 TP 数据单元中每个 8 位字符转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值 为 42 的 8 位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） 广播消息情况下：使用十六进制的 GSM 03.41 TPDU 整数类型；关联存储器支持的地址编号范围内取值 PDU 模式 文本模式 说明 0 'REC UNREAD' 已收到但未读的短消息 1 'REC READ' 已收到且已读的短消息 2 'STO UNSENT' 已存储但未发送的短消息 3 'STO SENT' 已存储且已发送的短消息 4 'ALL' 所有短消息 l 备注 te 写短消息详细操作请参考 GSM 模块短信应用指导文档。 uec tial 举例 写文本短消息，GSM 格式： Q n AT+CMGF=1 OK e AT+CSCS='GSM' OK fid AT+CMGW='15021012496' > This is a test from Quectel +CMGW: 4 Con OK //设置文本短消息模式 //设置 TE 输入字符集格式为'GSM'格式 //输入短消息内容，写入，退出 8.10. AT+CMSS 从存储器发送短消息 该命令可将短消息存储器中，位置取值参数为的消息发送到网络侧（SMS-SUBMIT 或 SMS-COMMAND）。若给定 SMS-SUBMIT 短消息的新接收地址参数，应使用该参数，而不能使用 已存储短消息的参数。发送成功后，参考值将返回给 TE。在接收到非请求发送状态报告结果码时， 可使用该命令的取值进行短消息识别。 上海移远通信技术有限公司 116 / 256 M26 AT 命令手册 语法 AT+CMSS 从存储器发送短消息 测试命令 AT+CMSS=? 配置命令 AT+CMSS=[,[,]] 响应 OK 响应 1）文本模式（AT+CMGF=1）且执行成功： +CMSS: [,] OK 最大响应时间 参考 GSM 07.05 参数 2）PDU 模式（ AT +CMGF=0）且执行成功： +CMSS: [,] OK 3）功能相关报错： +CMS ERROR: l 120s，受网络状态影响 uecte tial 整数类型；关联存储器支持的地址编号范围内取值 Q n 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS e 07.07 中的 AT+CSCS 命令）；给定的地址类型 fid 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 129 未知类型（IDSN 格式号码） 145 国际号码类型（IDSN 格式号码） n 整数型的 GSM 03.40 TP-Message-Reference o'时间—字符串'格式的 GSM 03.40 TP-Service-Center-Time-Stamp（请参考） RP-ACK PDU 中的 GSM 03.40 RP-User-Data 元素；SMS 情况下，与的格式相 C同，但没有 GSM 04.11 SC 地址字段；该参数应放在双引号中，与像普通的字符型参 数一样 上海移远通信技术有限公司 117 / 256 M26 AT 命令手册 8.11. AT+CMGC 发送短消息命令 语法 AT+CMGC 发送短消息命令 测试命令 响应 AT+CMGC=? OK 配置命令 响应 1）文本模式（+CMGF=1）： 1）文本模式（AT+CMGF=1）且执行成功： AT+CMGC=[,,,<d +CMGC: [,] a>,] OK text is entered 退出不发送 2）PDU 模式（+CMGF=0）： l AT+CMGC= PDU is given cte l 最大响应时间 参考 ue tia GSM07.05 2）PDU 模式（AT+CMGF=0）且执行成功： +CMGC: [,] OK 3）功能相关报错： +CMS ERROR: 300ms Q n 参数 e fid n Co 取决于该命令或结果码；GSM 03.40 SMS-DELIVER 的前 8 位；SMS-SUBIT（缺省值： 17）；SMS-STATUS-REPORT；或采用整数型的 SMS-COMMAND（缺省值：2） 整数型的 GSM 03.40 TP-Command-Type（缺省值：0） 整数型的 GSM 03.40 TP-Protocol-Identifier（缺省值：0） 整数型的 GSM 03.40 TP-Message-Number 字符型的 GSM 03.04 中的 TP-Destination-Address 地址——取值字段；将 BCD 数值 （或缺省 GSM 字母格式的字符）转换为当前选择的 TE 字符集中的字符（请参考 TS 07.07 中的 AT+CSCS 命令）；给定的地址类型 整数型的 GSM 04.11 TP-Destination-Address 中的 8 位：'类型—地址'字段（当 的首字符为+（IRA 43）时，缺省值为 145，否则缺省值为 129） 129 未知类型（IDSN 格式号码） 145 国际号码类型（IDSN 格式号码） 整数型；文本模式（AT+CMGF=1）下，用字符表示（或）消息正文的 长度；PDU 模式（AT+CMGF=0）下，8 位真实 TP 数据单位的长度（即 RP 层的 SMSC 地址中的 8 位字符将不计算在该长度内） ISDMS 情况下：GSM 03.40 TPDU。十六进制，遵循 GSM 04.11SC 地址；ME/TA 把 TP 数据单元中每个 8 位字符转换为包含 2 个 IRA 字符的十六进制数字（如：整数取值 为 42 的 8 位字符作为 2 位数字（2A，即 IRA 50 和 65）发送给 TE） 上海移远通信技术有限公司 118 / 256 M26 AT 命令手册 广播消息情况下：使用十六进制的 GSM 03.41 TPDU 整数类型；关联存储器支持的地址编号范围内取值 整数型的 GSM 03.40 TP-Message-Reference '时间—字符串'格式的 GSM 03.40 TP-Service-Center-Time-Stamp（请参考） RP-ACK PDU 中的 GSM 03.40 RP-User-Data 元素；SMS 情况下，与的格式相 同，但没有 GSM 04.11 SC 地址字段；该参数应放在双引号中，与像普通的字符型参 数一样 8.12. AT+CNMI 新短消息指示 当 TE 处于在使用状态时（如：DTR 信号处于'ON'状态），使用配置命令，可设置新到达的短消息如何 从网络侧发送到 TE。若 TE 处于待用状态（如：DTR 信号处于'OFF'状态），短消息接收流程应该按照 GSM 03.38 的规定。 l 若 DTR 信号不可用或者信号状态被忽略（V.25ter 命令：AT&D0），可使用 AT+CNMI 确认流程确保短 消息的可靠传输。 cte l '选择短消息服务'命令 AT+CSMS 应该用来检测 ME 是否支持接收 SMS 和 CBM，并决定直接发送到 TE 的短消息是否需要确认（请参考 AT+CNMI 命令）。 ue tia 语法 Q n AT+CNMI 新短消息指示 测试命令 e AT+CNMI=? 响应 +CNMI: (取值列表),(取值列表),(取值列 表),( 取值列表),(取值列表) fid 查询命令 n AT+CNMI？ OK 响应 +CNMI: ,,,, Co 配置命令 OK 响应 AT+CNMI=[[,[,[,[,]]]]] ERROR +CMS ERROR: 最大响应时间 300ms 参考 GSM 07.05 上海移远通信技术有限公司 119 / 256 M26 AT 命令手册 参数 控制指定的非请求结果码的处理情况 0 缓冲 TA 中的非请求结果码；若 TA 结果码缓冲器已满，结果码指示可以缓冲存储在其 他存储空间或者把最久的非请求结果码指示丢弃，替换为新接收到的指示 1 当 TA-TE 间的链路被占用（比如：在线数据模式下），丢弃结果码指示，并拒绝新接 收短消息的非请求结果码。否则，直接转发给 TE 2 当 TA-TE 间的链路被占用（比如：在线数据模式下），缓冲 TA 中的非请求结果码； 当链路释放后，把所有结果码发送给 TE。否则，直接转发给 TE 3 在 TA 处于数据模式的情况下，使用特定的 TA-TE 连接技术将结果码和数据同时传给 TE 存储接收短消息的规则取决于数据编码方案（请参考 GSM 03.38[2]）；优选短消息存 储器命令（AT+CPMS）的设置和本取值 0 没有 SMS-DELIVER 的指示发给 TE 1 若 SMS-DELIVER 存储在 ME/TA，存储位置靠非请求结果码+CMTI: , 来提示给 TE l 2 SMS-DELIVERs（除 Class2 短消息）直接发送给 TE，使用如下非请求结果码：+CMT: [], （ 启 用 PDU 模 式 ） 或 者 +CMT: , te [],[,,,,,,,] （ 启 用 文 本 模 式 ） ； 以 上 斜 体 部 分 参 数 定 义 参 见 命 令 c l AT+CSDH.Class2 短消息指示方式同=1 ue tia 3 通过使用=2 定义的非请求结果码，Class 3 的 SMS-DELIVER 短消息可直接发送 到 TE。其他数据编码方案下的短消息显示结果均遵循=1 定义 存储接收 CBM 规则取决于数据编码方案（请参考 GSM 03.38[2]）；选择小区广播消 息类型命令 AT+CSCB 的设置和本取值 Q n 0 无 CBM 指示发送到 TE e 2 收到的 CBM 使用如下格式直接发送到 TE： +CBM: （启用 PDU 模式）或者 fid +CBM: ,,,, （启用文本模式） 3 通过使用=2 定义的非请求结果码，Class 3 的 CBM 短消息可直接发送到 TE。其 他数据编码方案下的短消息显示结果均遵循=1 定义 n 0 无 SMS-STATUS-REPORT 发送到 TE 1 SMS-STATUS-REPORT 短消息使用如下格式直接发送到 TE： o+CDS: （启用 PDU 模式）或者 C+CDS: ,,[],[],,,（启用文本模式） 0 当为 1...3 时，该命令中定义的 TA 缓存中的非请求结果码发送给 TE（在发送 之前，OK 应该被接收到） 1 当为 1…3 时，将清除该命令中定义的 TA 对非请求结果码的缓冲 举例 AT+CMGF=1 OK AT+CSCS='GSM' //设置文本短信模式 //设置 TE 输入字符集格式为'GSM'格式 上海移远通信技术有限公司 120 / 256 M26 AT 命令手册 OK AT+CNMI=2,1 OK //设置将短信存储到 ME 或 SIM 卡后，再给出新短信指示 +CMTI: 'SM',5 //新短信指示 AT+CNMI=2,2 OK //设置收到新短信，直接打印短信内容 +CMT: '+8615021012496',' ','2010/09/25 17:25:01+32',145,4,0,241,'+8613800210500',145,27 This is a test from Quectel //收到新短信，直接打印短信内容 8.13. AT+CRES 恢复 SMS 设置 l AT+CRES 可把短消息服务设置从永久存储器恢复到当前存储器。一个 TA 可以包括几个配置号的设置。 可恢复以下命令规定的设置： te  服务中心地址：AT+CSCA c l  设置文本格式的参数：AT+CSMP ue tia  选择小区广播消息类型：AT+CSCB（若执行） 语法 Q n AT+CRES 恢复 SMS 设置 e 查询命令 AT+CRES=? 响应 +CRES: (取值列表) fid 配置命令 n AT+CRES[=] Co 最大响应时间 OK 响应 OK ERROR +CMS ERROR: 300ms 参考 GSM 07.05 参数 0-3 与制造商有关的配置号；用于存储各项设置 上海移远通信技术有限公司 121 / 256 M26 AT 命令手册 8.14. AT+CSAS 保存 SMS 设置 AT+CSAS 可将当前的短消息服务设置保存到永久存储器。一个 TA 可以包括几个配置号的设置。可保 存以下命令规定的设置：  服务中心地址：AT+CSCA  设置文本格式的参数：AT+CSMP  选择小区广播消息类型：AT+CSCB（若执行） 语法 AT+CSAS 保存 SMS 设置 查询命令 AT+CSAS=? l 配置命令 te AT+CSAS[=] uec tial 最大响应时间 参考 GSM 07.05 响应 +CSAS: (取值列表) OK 响应 OK ERROR +CMS ERROR: 300ms Q en 参数 fid 0-3 与制造商有关的配置号；用于存储各项设置 Con 8.15. AT+CSCB 选择小区广播消息类型 AT+CSCB 可选择 ME 接收到的 CBM 类型。 语法 AT+CSCB 选择小区广播消息类型 测试命令 AT+CSCB=? 响应 +CSCB: (取值列表) OK 上海移远通信技术有限公司 122 / 256 M26 AT 命令手册 查询命令 AT+CSCB? 响应 +CSCB: ,, 配置命令 AT+CSCB=[,mids>[,]] 最大响应时间 参考 GSM 07.05 OK 响应 OK ERROR +CMS ERROR: 300ms 参数 l cte l 0 接收由和指定的消息类型 1 不接收由和指定的消息类型 字符型（如'0,1,5,320-478,922'）；所有可能的 CBM 消息标识的组合（请参考） 字符型（如'0-3,5'）；所有可能的数据编码方案的组合（请参考，缺省值为空字符 串） ue tia 8.16. AT+CSDH 显示文本格式参数 Q n 该命令可用于控制是否在文本模式下的结果码中显示详细的头信息。 fide 语法 AT+CSDH 显示文本格式参数 测试命令 n AT+CSDH=? 响应 +CSDH: (取值列表) Co OK 查询命令 响应 AT+CSDH? +CSDH: 配置命令 AT+CSDH=[] 最大响应时间 OK 响应 OK ERROR +CMS ERROR: 300ms 上海移远通信技术有限公司 123 / 256 参考 GSM 07.05 M26 AT 命令手册 参数 0 不在+CMT，+CMGL，+CMGR 命令中显示、、、、和 （+CSCA 和+CSMP 命令中设置的取值），也不显示用于 SMS-DELIVER 和 SMS-SUBMIT 消息的结果码中的、或；对于+CMGR 命令结 果码中的 SMS-COMMAND，不显示、、、、以及 1 在结果码中显示这些取值 举例 AT+CSDH=0 l OK AT+CMGR=3 te +CMGR: 'REC READ','+8615021012496','','2010/09/25 15:06:37+32' This is a test from Quectel c l OK ue tia AT+CSDH=1 OK AT+CMGR=3 Q n +CMGR: 'REC READ','+8615021012496','','2010/09/25 15:06:37+32',145,4,0,241,'+861 e 3800210500',145,27 This is a test from Quectel fid OK Con 8.17. AT+CSMP 设置文本格式参数 文本模式下，当向网络侧发送短消息或将短消息存放在存储器中时，使用配置命令可选择需要附加参 数取值。除此之外，还可以用于设置从 SMSC 接收到该短消息时算起的有效期（的取值范围：0~255） 或定义有效期终止的绝对时间（为字符串时）。的格式由指定。若 TA 支持增强型有效期格 式（（$(EVPF)$，请参考 GSM 03.40），应该把 16 进制的编码字符串放于双引号中（请参考）。 上海移远通信技术有限公司 124 / 256 M26 AT 命令手册 语法 AT+CSMP 设置文本格式参数 测试命令 AT+CSMP=? 响应 +CSMP: ( 取 值 列 表 ),( 取 值 列 表 ),( 取 值 列 表),(取值列表) 查询命令 AT+CSMP? OK 响应 +CSMP: ,,, OK 配置命令 响应 AT+CSMP=[[,[,[, ]]]] l 最大响应时间 参考 te GSM 07.05 OK ERROR +CMS ERROR: 300ms uec tial 参数 Q en fid 取决于该命令或结果码；GSM 03.40 SMS-DELIVER，SMS-SUBMIT （缺省值：17）， SMS-STATUS-REPORT 的前 8 位；或采用整数型 SMS-COMMAND （缺省值：2）；在文 本模式下若值设为 49，则支持消息状态报告 取决于 SMS-SUBMIT 的的设置；采用整数型（缺省值：167），或时间字符型（参考） 的 GSM 03.40 TP-有效期 整数型；参考 GSM 03.40 TP-协议-标识（缺省值：0） 整数型；取决于该命令或该命令结果码 GSM 03.38 中的 SMS 数据编码方案 Con 8.18. AT+QCLASS0 接收 Class0 短信存储到当前存储器 语法 AT+QCLASS0 接收 Class0 短信存储到当前存储器 测试命令 响应 AT+QCLASS0=? +QCLASS0: (取值列表) 查询命令 AT+QCLASS0? OK 响应 +QCLASS0: 上海移远通信技术有限公司 125 / 256 M26 AT 命令手册 配置命令 AT+QCLASS0= 最大响应时间 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms 参数 0 接收到 Class0 短信时，不存储到当前短消息存储器内 1 接收到 Class0 短信时，存储到当前短消息存储器内 l 举例 te 以文本消息为例： c l AT+CPMS? +CPMS: 'SM',6,50,'SM',6,50,'SM',6,50 ue tia OK AT+QCLASS0=0 Q n OK //设置接收到 Class0 短信时，不存储到当前短消息存储器内 e +CMT: '+8615021012496',,'2010/09/26 09:55:37+32' fid TEST1 from Quectel //接收到 Class0 短信，MT 直接提示短消息 AT+QCLASS0=1 n OK //设置接收到 Class0 短信时，存储到当前短消息存储器内 o +CMTI: 'SM',7 C AT+CMGR=7 //接收到 Class0 短信，将短消息存储在当前存储器内（参考 AT+CPMS） +CMGR: 'REC UNREAD','+8615021012496','','2010/09/26 09:56:17+32' TEST2 from Quectel OK 上海移远通信技术有限公司 126 / 256 M26 AT 命令手册 8.19. AT+QMGDA 删除指定类型的所有短信 语法 AT+QMGDA 删除指定类型的所有短信 测试命令 响应 AT+QMGDA=? +QMGDA: (取值列表) OK 配置命令 响应 AT+QMGDA= OK ERROR 最大响应时间 参考 l Quectel +CME ERROR: 取决于待删除短消息的数目 te 参数 CQouneficdential PDU 模式 1 2 3 4 5 6 文本模式 'DEL READ' 'DEL UNREAD' 'DEL SENT' 'DEL UNSENT' 'DEL INBOX' 'DEL ALL' 删除所有已读的短消息 删除所有未读的短消息 删除所有已发送的短消息 删除所有未发送的短消息 删除所有接收到的短消息 删除所有短消息 删除所有已读的短消息 删除所有未读的短消息 删除所有已发送的短消息 删除所有未发送的短消息 删除所有接收到的短消息 删除所有短消息 上海移远通信技术有限公司 127 / 256 M26 AT 命令手册 8.20. AT+QSMSCODE 配置短消息字符集 语法 AT+QSMSCODE 配置短消息字符集 测试命令 响应 AT+QSMSCODE=? +QSMSCODE: (取值列表) 查询命令 AT+QSMSCODE? OK 响应 +QSMSCODE: 配置命令 AT+QSMSCODE= tel 最大响应时间 c l 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms ue tia 参数 CQonfiden 0 NOKIA 字符集 1 SIEMENS 字符集（默认值） 2 NOKIA 字符集，将 0x11 转译成'_'，0x02 转译成'$' 上海移远通信技术有限公司 128 / 256 M26 AT 命令手册 9 电话本相关命令 9.1. AT+CPBS 选择电话簿存储单元 AT+CPBS 配置命令可选择电话簿存储单元，可用于其它电话簿命令。查询命令 用于返回当前选择的存储单元。 语法 l AT+CPBS 选择电话簿存储单元 测试命令 te AT+CPBS=? uec tial 查询命令 AT+CPBS? Q n 配置命令 e AT+CPBS= fid 最大响应时间 n 参考 Co GSM 07.07 响应 +CPBS: (取值列表) OK 响应 +CPBS: [,,] OK 响应 OK ERROR +CME ERROR: 300ms 参数 'MC' 'RC' 'DC' 'LA' 'ME' 'BN' 'SD' ME 最近未接号码电话簿 ME 最近接听号码电话簿 ME 最近拨号号码电话簿 最近通话号码所有列表（LND/LNM/LNR） ME 电话簿 SIM 禁拨号码电话簿 SIM 服务号码电话簿 上海移远通信技术有限公司 129 / 256 M26 AT 命令手册 'VM' SIM 语音信箱号码电话簿 'FD' SIM 固定拨号号码电话簿（此功能开启及存储容量取决于 SIM 卡） 'LD' SIM 最近拨打的号码电话簿 'ON' SIM 卡（或 ME）中的号码（MSISDN）清单（也可以使用 AT+CNUM 命令读 出该存储器中的信息） 'SM' SIM 电话簿 整数型；表示所选存储器中使用过的位置号码个数 整数型；表示所选存储器中位置号码总数 备注 SIM 最多支持 250 条电话簿记录，ME 最多支持 100 条电话簿记录。 l 9.2. AT+CPBW 写删电话簿记录 te 该命令可在当前电话簿存储器的位置号码中写入电话簿记录。通过 AT+CPBS，可选择当前电 c l 话簿存储器。写入的记录字段是与号码有关的电话号码（使用格式）和文本。若 省略这些字段，则将删除电话簿记录。若为空，但给定，则记录将被写入电话簿中第一 ue tia 个空闲位置。 语法 Q n AT+CPBW 写删电话簿记录 e 测试命令 fid AT+CPBW=? 响应 +CPBW: (取值列表),,(取值列 表), n 配置命令 o AT+CPBW=[,,[,[]]] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 参数 电话簿存储器中位置号码范围内的整数型取值 上海移远通信技术有限公司 130 / 256 M26 AT 命令手册 字符型；格式的电话号码 整数型的八位字节地址类型（请参考 GSM 04.08[8]第 10.5.4.7 小节）；当拨号字符串包括国 际接入代码字符'+'时，缺省值为 145；其他情况下，缺省值为 129 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 字符型；最大长度的字符型字段；与'选择 TE 字符集'命令 AT+CSCS 规定的字符 集相同 表示字段最大长度的整数型取值 表示字段最大长度的整数型取值 备注 1. 若当前存储单元是'MC'， 'RC'，'DC' ，'LA'或'LD'， ,和参数必须省略， AT+CPBW 命令只支持设置删除当前电话簿的号码记录； 2. 不允许为空； l 3. 形式的下面的字符必须通过退出序列进入 GSM 字符 Seq. Seq.(hex) 注释 te 5C 5C 35 43 (反斜杠) ' 22 5C 32 32 (字符串分界符) c l BSP 8 5C 30 38 (退格键) NULL 0 5C 30 30 (GSM 空) ue tia 注：„0‟（GSM 空），对于应用层软件，当它们读字符串长度的时候可能引起问题。 Q n 举例 e AT+CSCS='GSM' fid OK AT+CPBW=10,'15021012496',129,'QUECTEL' OK //向当前电话簿位置 10 写入新号码 n AT+CPBW=10 Co OK //删当前电话簿位置 10 的电话簿 9.3. AT+CPBR 查询电话簿记录 该命令操作可返回位置号码范围为 ~ 的电话簿记录，该位置号码范围通过使用 AT+CPBS 从当前电话簿存储中选择。若为空，则只返回指定的电话簿。 上海移远通信技术有限公司 131 / 256 M26 AT 命令手册 语法 AT+CPBR 查询电话簿记录 测试命令 AT+CPBR=? 响应 +CPBR: (取值列表), , 配置命令 AT+CPBR= [,] OK 响应 +CPBR:,,,[+C PBR: .....+CPBR: , , , ] OK ERROR 最大响应时间 参考 l GSM 07.07 +CME ERROR: 取决于待读取的电话本数目 te 参数 uec tial Q n e fid 电话簿存储器中位置号码范围内的整数型取值 电话簿存储器中位置号码范围内的整数型取值 字符型；格式的电话号码 整数型的八位字节地址类型（请参考 GSM 04.08[8]第 10.5.4.7 小节） 字符型；最大长度的字符型字段；与'选择 TE 字符集'命令 AT+CSCS 规定的字符 集相同 表示字段最大长度的整数型取值 表示字段最大长度的整数型取值 n 备注 Co 应小于数值。 举例 AT+CSCS='GSM' OK AT+CPBR=10 +CPBR: 10,'15021012496',129,'QUECTEL' OK //查询当前电话簿位置 10 的电话簿 上海移远通信技术有限公司 132 / 256 M26 AT 命令手册 9.4. AT+CPBF 查找电话簿记录 该命令可从当前电话簿存储器中查找电话簿记录。通过 AT+CPBS，可选择当前电话簿存储器。 该字母数字混编方式的字段以字符串开始。 语法 AT+CPBF 查找电话簿记录 测试命令 AT+CPBF=? 响应 +CPBF: , 配置命令 AT+CPBF=[] uectel tial 最大响应时间 参考 Q n GSM 07.07 OK 响应 [+CPBF: , ,, [[...] +CBPF: ,,,] OK ERROR +CME ERROR: 取决于电话本的存储空间大小 e 参数 fid n o C 最大长度的字符型字段；与 '选择 TE 字符集' 命令 AT+CSCS 规定的字符集相同 电话簿存储器中位置号码范围内的整数型取值 电话簿存储器中位置号码范围内的整数型取值 字符型；格式的电话号码 整数型的八位字节地址类型（请参考 GSM 04.08[8]第 10.5.4.7 小节） 129 未知类型（ISDN 格式） 145 国际号码类型（ISDN 格式） 字符型；最大长度的字符型字段；与'选择 TE 字符集'命令 AT+CSCS 规定的字符 集相同 表示字段最大长度的整数型取值 表示字段最大长度的整数型取值 上海移远通信技术有限公司 133 / 256 备注 缺省时，返回当前电话簿存储器中所有电话簿。 M26 AT 命令手册 9.5. AT+CNUM 用户号码 AT+CNUM 返回与用户相关的 MSISDN（Mobile Station International ISDN Number），该信息可以存 储在 SIM 卡中，也可以存储在 ME 中。若用户有能满足不同业务需求的多个 MSISDN，则每个 MSISDN 将 占用单独一行返回。 语法 AT+CNUM 用户号码 测试命令 l AT+CNUM=? te 执行命令 AT+CNUM Quec ential 最大响应时间 fid 参考 GSM 07.07 响应 OK 响应 +CNUM: [],, [+CNUM: [],, [...]] OK ERROR +CME ERROR: 300ms n 参数 Co 与有关，可选项，字母数字混编字符串。所用的字符集与'选择 TE 字符集'命令 AT+CSCS 规定的相同 指定的字符型电话号码 整数型的八位字节地址类型（请参考 GSM 04.08[8]第 10.5.4.7 小节） 上海移远通信技术有限公司 134 / 256 M26 AT 命令手册 10 GPRS 相关命令 10.1. AT+CGATT GPRS 附着和分离 该命令用于将 MT 附着 GPRS 业务，或将 MT 从 GPRS 业务分离。该命令执行成功后，MT 保持 V.25ter 命令状态。若 MT 已处于请求状态，则忽略执行命令操作，且返回 OK。 当附着状态转为分离状态时，将自动去激活所有 PDP 上下文。 l 语法 te AT+CGATT GPRS 附着和分离 c l 测试命令 AT+CGATT=? 响应 +CGATT: (取值列表) ue tia 查询命令 Q n AT+CGATT? OK 响应 +CGATT: fide 配置命令 AT+CGATT= n 最大响应时间 o 参考 C GSM 07.07 OK 响应 OK ERROR +CME ERROR: 75s，受网络状态影响 参数 GPRS 附着状态 0 分离 1 附着 上海移远通信技术有限公司 135 / 256 举例 AT+CGATT=1 OK AT+CGATT=0 OK AT+CGATT? +CGATT: 0 OK //GPRS 附着 //GPRS 分离 //查询 GPRS 附着状态 M26 AT 命令手册 10.2. AT+CGDCONT 定义 PDP 上下文 该命令可为 PDP 上下文定义参数，该 PDP 上下文是由本地上下文标识参数标识的。该配置命令 的特殊形式 AT+CGDCONT=将使上下文号码的取值成为未定义取值。 tel 语法 c l AT+CGDCONT 定义 PDP 上下文 测试命令 ue tia AT+CGDCONT=? 响应 +CGDCONT: ( 取 值 列 表 ),,, ,(取值列表),(取值 列表) Q en 查询命令 Confid AT+CGDCONT? OK 响应 +CGDCONT: ,,,,, +CGDCONT:,,,,, … OK 配置命令 响应 AT+CGDCONT=[,,[ OK APN>[,[,[,]]]]] +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 136 / 256 M26 AT 命令手册 参数 1~3 数值型参数；用于指定 PDP 上下文标识。该参数对 TE-MT 接口而言是本地参数， 并且可用于其他 PDP 上下文相关命令 'IP' （分组数据协议类型）字符型参数；用于指定分组数据协议的类型。仅支持'IP'， 互联网协议 IP（Internet Protocol）（IETF STD5） 接入点名称；表示一个字符串参数，用于选择 GGSN 或外部分组数据网络的逻辑名称。若 该参数取值为空或省略，则需要请求签约值 字符型参数；用于表示对于特定 PDP 上下文，MT 分配的地址空间。若该参数取值为空或 省略，则 TE 在 PDP 启动过程中提供其他取值；若不能提供其他取值，则需要请求动态地 址。即便在 PDP 启动过程中已分配地址，该命令的读出形式仍继续返回为空。使用 AT+CGPADDR 命令，可读出该分配地址 关闭（若取值省略，则该参数为缺省值）；数值型参数；用于控制 PDP 数据压缩 关闭（若取值省略，则该参数为缺省值）；数值型参数；用于控制 PDP 头 举例 l AT+CGDCONT=1,'IP','CMNET' te OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' uec tial 10.3. AT+CGQREQ 请求的服务质量 Q n AT+CGQREQ 允许 MT 向网络发送 'PDP 上下文激活需求' 消息时，TE 指定一个服务质量。 e 使用配置命令，可为上下文指定一个由（本地）上下文标识参数标识的配置项。该命令的特殊形 式，即 AT+CGQREQ=，取消定义过的服务质量。 fid 语法 n AT+CGQREQ 请求的服务质量 o 测试命令 C AT+CGQREQ=? 响应 +CGQREQ: ,( 取 值 列 表 ), ( 取 值 列 表 ),( 取 值 列 表 ),( 取 值 列 表),(取值列表) 查询命令 AT+CGQREQ? OK 响应 +CGQREQ: , , ,>reliability>, , +CGQREQ: ,,,,, 上海移远通信技术有限公司 137 / 256 M26 AT 命令手册 … 配置命令 AT+CGQREQ=[,[, [,[,[,]]]]] 最大响应时间 参考 GSM 07.07 OK 响应 OK ERROR +CME ERROR: 300ms 参数 l te c l 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 整数型参数；用于指定优先级别 整数型参数；用于指定延时级别 数值型参数；用于指定处理不常见数据丢失的可靠性级别 整数型参数；用于指定峰值吞吐量级别 整数型参数；用于定义平均吞吐量级别 ue tia 10.4. AT+CGQMIN 可接受的最小服务质量 Q n AT+CGQMIN 允许 TE 指定一个可接受的最小服务质量。该配置项由 MT 检验，用于与 'PDP 上下文 e 激活' 消息所返回的协商配置进行比较。 fid 使用配置命令，可为上下文指定一个由（本地）上下文标识参数标识的配置项。该命令的特殊形 式，即 AT+CGQMIN=，取消定义过的可接受最小服务质量。 n 语法 Co AT+CGQMIN 可接受的最小服务质量 测试命令 响应 AT+CGQMIN=? +CGQMIN:,(取值列表),( 取 值 列 表 ),( 取 值 列 表 ),( 取 值 列 表),(取值列表) 查询命令 AT+CGQMIN? OK 响应 +CGQMIN: ,,,,, 上海移远通信技术有限公司 138 / 256 M26 AT 命令手册 +CGQMIN: ,,,,, … 配置命令 OK 响应 AT+CGQMIN=[,[,< OK delay>[,[,[, ERROR ]]]]] +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 参数 l te c l ue tia 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 整数型参数；用于指定优先级别 整数型参数；用于指定延时级别 数值型参数；用于指定处理不常见数据丢失的可靠性级别 整数型参数；用于指定峰值吞吐量级别 整数型参数；用于定义平均吞吐量级别 Q en 10.5. AT+CGACT PDP 上下文激活和去激活 fid 该命令可激活或去激活指定的 PDP 上下文。该命令执行成功后，MT 保持 V.25ter 命令状态。若 PDP 上下文已处于请求状态，则该状态保持不变。当执行该命令的激活形式时，若 MT 没有附着 GPRS，MT 首 n 先进行 GPRS 附着，然后尝试激活指定的上下文。 o 语法 C AT+CGACT PDP 上下文激活和去激活 测试命令 AT+CGACT=? 响应 +CGACT: (取值列表) 查询命令 AT+CGACT? OK 响应 +CGACT: ,[+CGACT:…] OK 上海移远通信技术有限公司 139 / 256 配置命令 AT+CGACT=[,] 最大响应时间 参考 GSM 07.07 响应 OK NO CARRIER +CME ERROR : 150s，受网络状态影响 M26 AT 命令手册 参数 PDP 上下文激活和去激活 0 去激活 1 激活 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT。缺省值为 1。 l 举例 te AT+CGDCONT=1,'IP','CMNET' c l OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' AT+CGACT=1,1 //PDP 激活 ue tia OK AT+CGACT=0,1 //PDP 去激活 NO CARRIER Q en 10.6. AT+CGDATA 进入数据模式 fid 该命令设置 MT 使用一个或多个 GPRS PDP 类型，执行相应的操作，在 TE 和网络间建立通信。 n MT 不处理 AT 命令中 AT+CGDATA 之后的命令。 Co 语法 AT+CGDATA 进入数据模式 测试命令 AT+CGDATA=? 响应 +CGDATA: (取值列表) 配置命令 AT+CGDATA=[,[,[,… ]]] OK 响应 OK NO CARRIER +CME ERROR : 上海移远通信技术有限公司 140 / 256 M26 AT 命令手册 最大响应时间 参考 GSM 07.07 300ms 参数 字符型参数；用于表示 TE 和 MT 之间网络建立通信时 PDP 上下文使用的 2 层协议： 'PPP'点到点协议，为一个分组数据协议，例如 IP 服务 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 10.7. AT+CGPADDR 显示 PDP 地址 该命令可返回指定上下文标识的 PDP 地址列表。 tel 语法 c l AT+CGPADDR 显示 PDP 地址 测试命令 ue tia AT+CGPADDR=? 响应 +CGPADDR: (取值列表) Q n 查询命令 AT+CGPADDR= OK 响应 +CGPADDR: [,] fide 最大响应时间 n 参考 Co GSM 07.07 OK ERROR 300ms 参数 整数型参数；用于标识一个 PDP 上下文定义，请参考 AT+CGDCONT 字符型参数；用于标识特定 PDP 上下文 MT 所获取的地址。该地址可以是静态的，也可以 是动态的。对于静止地址来说，当上下文定义后通过 AT+CGDCONT 命令设置的地址；对 于动态地址来说，在最后一次 PDP 上下文激活过程中，使用被参考的上下文定义时 所指配的地址。当地址不可用时，则省 上海移远通信技术有限公司 141 / 256 M26 AT 命令手册 举例 AT+CGDCONT=1,'IP','CMNET' OK //定义=1 的 PDP 上下文，PDP 类型为'IP'，APN 为'CMNET' AT+CGACT=1,1 //激活 PDP 场景=1 OK AT+CGPADDR=1 //查询场景=1 的 PDP 地址 +CGPADDR: 1,'10.76.51.180' OK 10.8. AT+CGCLASS GPRS 移动台类别 该命令可根据指定的 GPRS 移动台类别设置 MT，使之能够进行操作。 l 语法 te AT+CGCLASS GPRS 移动台类别 c l 测试命令 响应 AT+CGCLASS=? +CGCLASS: (取值列表) ue tia 查询命令 Q n AT+CGCLASS? OK 响应 +CGCLASS: fide 配置命令 AT+CGCLASS= n 最大响应时间 o 参考 C GSM 07.07 OK 响应 OK NO CARRIER +CME ERROR : 30s，受网络状态影响 参数 字符型参数；表示 GPRS 移动台的类别（按功能的降序排列） 'B' 类别 B 'CG' 仅在 GPRS 模式下为类别 C 'CC' 仅在电路交换模式下为类别 C（最低级别） 上海移远通信技术有限公司 142 / 256 M26 AT 命令手册 10.9. AT+CGEREP 非请求 GPRS 事件上报控制 该命令可根据指定的 GPRS 移动台类别设置 MT，使之能够进行操作。 语法 AT+CGEREP 非请求 GPRS 事件上报控制 测试命令 响应 AT+CGEREP=? +CGEREP: (取值列表) OK 查询命令 响应 AT+CGEREP? l 配置命令 AT+CGEREP= cte l 最大响应时间 ue tia 参考 GSM 07.07 +CGEREP: OK 响应 OK ERROR +CME ERROR: 300ms Q n 参数 fide 0 缓冲 MT 中的非请求结果码；若 MT 结果码缓冲器已满，则丢弃最旧的结果码。不转发 结果码给 TE 1 当保留 MT-TE 链路时（比如：在线数据模式下），丢弃非请求结果码；否则，直接转发 给 TE on 备注 C 相关 URC 上报： +CGEV: NW DEACT , [,] +CGEV: ME DEACT , [,] +CGEV: NW DETACH +CGEV: ME CLASS 参数 请参考 AT+CGDCONT 请参考 AT+CGDCONT 请参考 AT+CGDCONT 上海移远通信技术有限公司 143 / 256 请参考 AT+CGCLASS M26 AT 命令手册 10.10. AT+CGREG GPRS 网络注册状态 该命令可控制关于 GPRS 注册状态一些中间结果码的显示。  当=1 并且 GPRS 注册状态发生改变，会有+CGREG : 的提示；  当=2，GPRS 注册状态发生改变且注册小区发生改变，会有+CGREG : [,,] 的提示。 语法 AT+CGREG GPRS 网络注册状态 测试命令 l AT+CGREG=? 响应 +CGREG: (取值列表) cte l 查询命令 AT+CGREG? OK 响应 +CGREG: ,[,,] ue tia 配置命令 Q n AT+CGREG=[] fide 最大响应时间 参考 GSM 07.07 OK 响应 OK ERROR +CME ERROR: 300ms Con 参数 0 禁用网络注册非请求结果码+CGREG: 1 启用网络注册非请求结果码+CGREG: 2 启用网络注册非请求结果码+CGREG: [,,] 0 未注册；ME 当前没有搜索注册业务的新营运商 1 已注册，本地网 2 未注册，但 ME 正在搜索注册业务的新营运商 3 注册被拒绝 4 未知 5 已注册，漫游 上海移远通信技术有限公司 144 / 256 M26 AT 命令手册 字符型；2 位十六进制位置区代码（比如：00C3 相当于十六进制中的 195） 字符型；2 位十六进制小区编号 举例 AT+CGATT=0 NO CARRIER +CGREG: 0,'1878','0873' AT+CGATT=1 OK +CGREG: 2,'1878','0873' +CGREG: 1,'1878','0873' l 10.11. AT+CGSMS 为 MO SMS 选择业务 cte l 该命令用于在 MT 发送 MO SMS 消息时，指定业务或业务优先级别。 ue tia 语法 AT+CGSMS 为 MO SMS 选择业务 Q n 测试命令 AT+CGSMS=? 响应 +CGSMS: (取值列表) fide 查询命令 AT+CGSMS? OK 响应 +CGSMS: on 配置命令 C AT+CGSMS=[] OK 响应 OK ERROR +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 145 / 256 参数 使用的业务或业务优先级别 0 GPRS 1 电路交换 2 GPRS 优先（若 GPRS 不可用，则使用电路交换） 3 电路交换优先（若电路交换不可用，则使用 GPRS） M26 AT 命令手册 10.12. AT+QGPCLASS 配置 GPRS 多时隙级别 语法 AT+QGPCLASS 配置 GPRS 多时隙级别 测试命令 响应 l AT+QGPCLASS=? MULTISLOT CLASS: (取值列表) te 查询命令 c l AT+QGPCLASS? OK 响应 MULTISLOT CLASS: ue tia 配置命令 Q n AT+QGPCLASS= fide 最大响应时间 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms Con 参数 GPRS 多时隙级别 1-12 默认值为 12 备注 配置 GPRS 时隙级别，需要重启才能生效。 上海移远通信技术有限公司 146 / 256 M26 AT 命令手册 11 TCPIP 相关命令 11.1. AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 语法 AT+QIOPEN 建立 TCP 连接或注册 UDP 端口号 测试命令 响应 AT+QIOPEN=? +QIOPEN: (取值列表),(IP address range),(port l range) +QIOPEN: (取值列表),(domain name),(port range) cte l 配置命令 ue tia AT+QIOPEN=[,],/, OK 响应 如果格式正确，返回： OK 否则，返回： ERROR 如果连接已经存在，返回： ALREAY CONNECT fid 返回 OK 后，如果连接成功，返回： [,] CONNECT OK Con 最大响应时间 返回 OK 后，如果连接失败，返回： [,] CONNECT FAIL OK、ERROR 或 ALREADY CONNECT 的超时时间为 300ms， [,] CONNECT OK 或[,] CONNECT FAIL 的超 时时间为 75s，受网络状态影响 参考 Quectel 参数 0~5 表明连接序号（M26 支持 6 个 SOCKET 同时存在）。当且仅 AT+QIMUX=1 时， 该参数有效。当 AT+QIMUX=0 时，该参数必须缺省（请参考 AT+QIMUX） 上海移远通信技术有限公司 147 / 256 M26 AT 命令手册 字符串类型；表明连接类型 'TCP' 建立 TCP 连接 'UDP' 建立 UDP 连接 字符串类型；表明远端服务器 IP 地址 远端服务器端口号 字符串类型；表明远端服务器域名地址 备注 1. 当 ME 状态（可以通过 AT+QISTAT 查询）为 IP INITIAL 或者 IP STATUS 或者 IP CLOSE 时才建 立连接。若非以上状态，需要通过操作 AT+QIDEACT 或 AT+QICLOSE 使 ME 处于以上状态才能正 常建立连接； 2. 当 AT+QIMUX=0 时，当前已存在连接或 AT+QIMUX=1 时，指定序号也存在连接，那么再次操作 AT+QIOPEN 会返回 ALREADY CONNECT。 l 11.2. AT+QISEND 发送 TCP 或 UDP 数据 cte l 语法 ue tia AT+QISEND 发送 TCP 或 UDP 数据 测试命令 响应 AT+QISEND=? +QISEND: Q en 执行命令 fid AT+QISEND 响应'>'，输入数据，执行 CTRL+Z 来发 送，执行 ESC 来终止操作 n 注：该操作当且仅当 AT+QIMUX=0 时可 执行 OK 响应 如果连接存在，发送成功返回： SEND OK 如果连接存在，发送失败返回： SEND FAIL Co 如果 TCP 或 UDP 连接未建立，返回： ERROR 配置命令 响应 1）单路连接时（+QIMUX=0） 如果连接存在，发送成功返回： AT+QISEND= SEND OK 响应'>'，输入数据，直到数据长度达到 字长发送 如果连接存在，发送失败返回： SEND FAIL 2）多路连接时（+QIMUX=1） AT+QISEND=[,] 如果 TCP 或 UDP 连接未建立，返回： 上海移远通信技术有限公司 148 / 256 若缺省，响应'>'，输入数据， ERROR 执行 CTRL+Z 来发送，执行 ESC 来终止 操作； 若不缺省，响应'>'，输入数据， 直到数据长度达到字长发送 最大响应时间 300ms 参考 Quectel M26 AT 命令手册 参数 数字参数；表明连接序号；该参数仅适用于 AT+QIMUX=1，若 AT+QIMUX=0，该参数必须 缺省 数字参数，表明发送数据长度。该数值最大支持 1460 l 备注 te 1. 执行命令 AT+QISEND 操作，仅在 AT+QIMUX=0 可操作； c l 2. AT+QISEND 不可发送空字符，返回 SEND FAIL； 3. 只有在 TCP 或 UDP 连接建立时发送数据； ue tia 4. SEND OK 提示只表明数据已经传输至窗口进行发送，并不表示该数据已经收到确认报文。为确保数 据确认发送至对方，可以通过执行 AT+QISACK 命令进行查询。 Q en 11.3. AT+QICLOSE 关闭 TCP 或 UDP 连接 fid 语法 n AT+QICLOSE 关闭 TCP 或 UDP 连接 测试命令 响应 o AT+QICLOSE=? OK C 执行命令 响应 AT+QICLOSE 如果关闭连接成功返回： CLOSE OK 配置命令 AT+QICLOSE= 如果关闭连接失败，返回： ERROR 响应 如果关闭连接成功返回： , CLOSE OK 上海移远通信技术有限公司 149 / 256 最大响应时间 参考 Quectel 如果关闭连接失败，返回： ERROR 300ms M26 AT 命令手册 参数 数字参数；表明连接序号； 该参数仅适用于 AT+QIMUX=1，若 AT+QIMUX=0，该参数必须缺省 备注 1. 对于 AT+QICLOSE 操作： l  当 AT+QISRVC=1 且 AT+QIMUX=0 时，返回 CLOSE OK，关闭 ME 作为 Client 连接远程 Server te 的连接；  当 AT+QISRVC=1 且 AT+QIMUX=1 时，返回 ERROR； c l  当 AT+QISRVC=2 且 AT+QIMUX=0 时，返回 CLOSE OK，关闭 ME 作为 Server，远程 Client 连接 ME 建立的连接； ue tia  当 AT+QISRVC=2 且 AT+QIMUX=0 时，此时若无其他 Client 处于监听状态，该操作将使 ME 退出监听状态；  当 AT+QISRVC=2 且 AT+QIMUX=1 时，ME 作为 Server，该操作将关闭 ME 作为 Server，远 Q n 程 Client 连接 ME 建立的所有连接并且退出监听状态。 2. 对于 AT+QICLOSE=操作： e  该命令操作只在 AT+QIMUX=1 时有效； fid  当 AT+QISRVC=1 且 AT+QIMUX=1 时，该操作将会关闭 ME 作为第的 Client 连接远 程 Server 的连接并保留 ME 作为 Server 接入的 Client 连接；  当 AT+QISRVC=2 且 AT+QIMUX=1 时，该操作将会关闭 ME 作为 Server 接入的第的 n 远程 Client 连接； 3. 当 AT+QISRVC=1 且 AT+QIMUX=0 时，AT+QICLOSE 只在 AT+QISTAT 为 CONNECTING 或 Co CONNECT OK 状态时操作成功，其他状态返回 ERROR。关闭连接成功后，状态变化为 IP CLOSE。 上海移远通信技术有限公司 150 / 256 M26 AT 命令手册 11.4. AT+QIDEACT 关闭 GPRS/CSD PDP 场景 语法 AT+QIDEACT 关闭 GPRS/CSD PDP 场景 测试命令 响应 AT+QIDEACT=? OK 执行命令 AT+QIDEACT 响应 如果关闭成功返回： DEACT OK 最大响应时间 参考 l Quectel 如果关闭失败，返回： ERROR 40s，受网络状态影响 CSD 相关配置暂不支持 cte l 备注 ue tia 1. AT+QIDEACT 可关闭除 IP INITIAL 状态的任何 GPRS/CSD PDP 场景。关闭成功后，状态恢复至 IP INITIAL； 2. AT+QIMUX=0 时，AT+QIDEACT 可关闭当前连接和场景； Q n 3. AT+QIMUX=1 时，AT+QIDEACT 使所有连接和场景关闭。 fide 11.5. AT+QILPORT 配置本地端口号 n 语法 o AT+QILPORT 配置本地端口号 测试命令 C AT+QILPORT=? 响应 +QILPORT: (取值列表) 查询命令 AT+QILPORT? OK 响应 : : OK 上海移远通信技术有限公司 151 / 256 M26 AT 命令手册 配置命令 AT+QILPORT=, 最大响应时间 参考 Quectel 响应 OK ERROR 300ms CSD 相关配置暂不支持 参数 字符串参数；表明连接类型 'TCP' TCP 本地端口号 'UDP' 0~65535 UDP 本地端口号 数字参数，表明本地端口号 l 11.6. AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码 cte l 语法 ue tia AT+QIREGAPP 启动任务并设置接入点 APN、用户名和密码 测试命令 响应 AT+QIREGAPP=? +QIREGAPP: 'APN','USER','PWD' Q en 查询命令 fid AT+QIREGAPP? OK 响应 +QIREGAPP: ,, n 配置命令 AT+QIREGAPP=,,< o password>[,] C 执行命令 OK 响应 OK ERROR 响应 AT+QIREGAPP OK ERROR 最大响应时间 300ms 参考 Quectel CSD 相关配置暂不支持 上海移远通信技术有限公司 152 / 256 M26 AT 命令手册 参数 字符串参数；表明 GPRS/CSD 接入点名称 字符串参数；表明 GPRS/CSD 接入点用户名 字符串参数；表明 GPRS/CSD 接入点用户密码 表明 CSD 数据传输速率 备注 1. 当且仅当 ME 处于 IP INITIAL 状态时，执行命令和配置命令操作有效，操作成功后 ME 状态将变化 为 IP START； 2. AT+QICSGP 控制该执行命令参数的缺省值。 11.7. AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） tel 语法 c l AT+QIACT 激活移动场景（或发起 GPRS/CSD 无线连接） 测试命令 响应 ue tia AT+QIACT=? OK 执行命令 Q n AT+QIACT 响应 OK ERROR e 最大响应时间 150s，受网络状态影响 fid 参考 Quectel CSD 相关配置暂不支持 n 备注 o 1. AT+QIACT 只有在 IP START 状态下才能操作并激活移动场景，执行后状态变化为 IP CONFIG； C 2. 在 ME 接收激活场景操作后，如果移动场景激活成功，状态变化为 IP GPRSACT，返回 OK，否则 返回 ERROR。 上海移远通信技术有限公司 153 / 256 M26 AT 命令手册 11.8. AT+QILOCIP 获取本地 IP 地址 语法 AT+QILOCIP 获取本地 IP 地址 测试命令 AT+QILOCIP=? 执行命令 AT+QILOCIP 响应 OK 响应 若执行成功，返回： 最大响应时间 参考 l Quectel 否则，返回： ERROR 300ms CSD 相关配置暂不支持 cte l 参数 ue tia 字符串参数；表明 GPRS/CSD 方式下获取的 IP 地址 Q n 备注 e 只有在移动场景已激活状态：IP GPRSACT、TCP/UDP CONNECTING、CONNECT OK、IP CLOSE fid 下才可以通过 AT+QILOCIP 查询到本地 IP 地址，否则返回 ERROR。 n 11.9. AT+QISTAT 查询当前连接状态 Co 语法 AT+QISTAT 查询当前连接状态 测试命令 AT+QISTAT=? 执行命令 AT+QISTAT 响应 OK 响应 当 AT+QIMUX=0 是，返回： OK STATE: 上海移远通信技术有限公司 154 / 256 M26 AT 命令手册 最大响应时间 参考 Quectel 当 AT+QIMUX=1 是，返回： (+QISTAT: , , , ) 列表 OK 300ms CSD 相关配置暂不支持 参数 字符串参数；表明连接状态 'IP INITIAL' 初始化 'IP START' 启动任务 'IP CONFIG' 配置场景 l 'IP IND' 激活 GPRS/CSD 场景中 'IP GPRSACT' 接收场景配置 te 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） c l 'TCP CONNECTING' TCP 连接中 'UDP CONNECTING' UDP 连接中 ue tia 'IPCLOSE' TCP/UDP 连接关闭 'CONNECT OK' TCP/UDP 连接成功 'PDP DEACT' GPRS/CSD 场景异常关闭 Q n 在 ATV0 配置下，数字和字符串对应含义如下： e 0 'IP INITIAL' 1 'IP START' fid 2 'IP CONFIG' 3 'IP IND' 4 'IP GPRSACT' n 5 'IP STATUS' o 6 'TCP CONNECTING' or 'UDP CONNECTING' 7 'IP CLOSE' C8 'CONNECT OK' 9 'PDP DEACT' 连接序号，范围为 0-5 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 上海移远通信技术有限公司 155 / 256 M26 AT 命令手册 11.10. AT+QISTATE 查询当前接入的连接状态 语法 AT+QISTATE 查询当前接入的连接状态 测试命令 AT+QISTATE=? 响应 OK 执行命令 AT+QISTATE 响应 当 AT+QIMUX=0 是，返回： OK 最大响应时间 参考 Quectel 参数 STATE: 当 AT+QIMUX=1 是，返回： OK l STATE: te +QISTATE: c l ,,,, ue tia OK 否则，返回： Q n ERROR 300ms e CSD 相关配置暂不支持 onfid 字符串参数；表明连接状态，当 AT+QIMUX=0 时： 'IP INITIAL' 初始化 C'IP START' 启动任务 'IP CONFIG' 配置场景 'IP IND' 激活 GPRS/CSD 场景中 'IP GPRSACT' 接收场景配置 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） 'TCP CONNECTING' TCP 连接中 'UDP CONNECTING' UDP 连接中 'IP CLOSE' TCP/UDP 连接关闭 'CONNECT OK' TCP/UDP 连接成功 'PDP DEACT' GPRS/CSD 场景异常关闭 上海移远通信技术有限公司 156 / 256 M26 AT 命令手册 当 AT+QIMUX=1 时： 'IP INITIAL' 初始化 'IP START' 启动任务 'IP CONFIG' 配置场景 'IP IND' 激活 GPRS/CSD 场景中 'IP GPRSACT' 接收场景配置 'IP STATUS' 获得本地 IP 地址（参考 AT+QILOCIP 命令） 'IP PROCESSING' 数据阶段 'PDP DEACT' GPRS/CSD 场景异常关闭 连接序号，范围为 0-5 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 字符串参数；表明接入连接状态，有 INITIAL，CONNECTED tel 11.11. AT+QISSTAT 查询当前 Server 状态 uec tial 语法 AT+QISSTAT 查询当前 Server 状态 Q n 测试命令 响应 AT+QISSTAT=? OK e 执行命令 fid AT+QISSTAT 响应 当 AT+QIMUX=0 是，返回： OK nS: o 当 AT+QIMUX=1 是，返回： C OK S: C: ,,, 最大响应时间 否则，返回： ERROR 300ms 上海移远通信技术有限公司 157 / 256 M26 AT 命令手册 参考 Quectel 参数 字符串参数；表明连接状态 'INITIAL' 初始化 'OPENNING' 启动任务 'LISTENING' 监听状态 'CLOSING' 关闭过程中 连接序号，范围为 0-4（注：当模块做 Server 工作时，最多能接入 5 路连接） 连接类型 'TCP' TCP 连接 'UDP' UDP 连接 远程连接或接入 IP 地址 远程连接或接入端口号 ctel l 11.12. AT+QIDNSCFG 配置域名服务器 DNS ue tia 语法 AT+QIDNSCFG 配置域名服务器 DNS Q n 测试命令 响应 e AT+QIDNSCFG=? OK 查询命令 响应 fid AT+QIDNSCFG? PrimaryDns: SecondaryDns: on 配置命令 AT+QIDNSCFG=[,] OK 响应 OK ERROR 最大响应时间 300ms 参考 Quectel 参数 字符串参数；表明主域名服务器的 IP 地址 上海移远通信技术有限公司 158 / 256 字符串参数；表明二级域名服务器的 IP 地址 M26 AT 命令手册 备注 当激活 GPRS/CSD 场景时，TA 会主动向 GPRS/CSD 网络获取 DNS 服务器。因此强烈建议在状态为 IP GPRSACT，IP STATUS，CONNECT OK 和 IP CLOSE 时，配置 DNS 服务器。 11.13. AT+QIDNSGIP 域名解析 语法 AT+QIDNSGIP 域名解析 测试命令 l AT+QIDNSGIP=? te 配置命令 AT+QIDNSGIP= Queficdential 最大响应时间 参考 Quectel Con 参数 响应 OK 响应 OK ERROR 返回 OK 后，若解析成功： 返回 OK 后，若解析失败： ERROR: STATE: 14s，受网络状态影响 字符串参数；表明 Internet 上注册的域名 字符串参数；表明 IP 地址对应的域名 数字参数；表明错误代码号 1 DNS 未授权错误 2 参数配置错误 3 网络错误 4 未找到服务器 5 超时 6 未配置 上海移远通信技术有限公司 159 / 256 7 无内存 8 未知错误 参考 AT+QISTAT M26 AT 命令手册 11.14. AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 语法 AT+QIDNSIP 配置使用 IP 地址连接还是域名连接 测试命令 响应 AT+QIDNSIP=? 查询命令 l AT+QIDNSIP? te 配置命令 c l AT+QIDNSIP= ue tia 最大响应时间 参考 Q n Quectel +QIDNSIP: (取值列表) OK 响应 +QIDNSIP: OK 响应 OK ERROR 300ms fide 参数 Con 数字参数；表明连接使用 IP 地址连接还是使用域名连接 0 使用 IP 地址连接 1 使用域名方式连接 11.15. AT+QIHEAD 配置接收数据时是否显示 IP 头 语法 AT+QIHEAD 配置接收数据时是否显示 IP 头 测试命令 响应 AT+QIHEAD=? +QIHEAD: (取值列表) 上海移远通信技术有限公司 160 / 256 M26 AT 命令手册 查询命令 AT+QIHEAD? OK 响应 +QIHEAD: 配置命令 AT+QIHEAD= OK 响应 OK ERROR 最大响应时间 300ms 参考 Quectel 参数 tel 数字参数；表明接收数据时是否显示 IP 头 0 不显示 IP 头 1 显示 IP 头，格式为 'IPD (data length):' uec tial 11.16. AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 Q n 语法 e AT+QIAUTOS 设置自动发送 TCP/UDP 数据时间 测试命令 响应 fid AT+QIAUTOS=? +QIAUTOS: (取值列表), (取值列表) n 查询命令 o AT+QIAUTOS? OK 响应 +QIAUTOS: , C OK 配置命令 响应 AT+QIAUTOS=[,] OK ERROR 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 161 / 256 M26 AT 命令手册 参数 数字参数；表明发送 TCP/UDP 数据时是否设置自动发送功能 0 未设置自动发送数据（缺省值） 1 设置自动发送数据 数字参数；表明自动发送数据时间。操作 AT+QISEND，输入数据耗时后，数据自动 发送 11.17. AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' 语法 AT+QIPROMPT 设置发送数据时是否显示'>'和'SEND OK' 测试命令 响应 l AT+QIPROMPT=? +QIPROMPT: (取值列表) OK te 查询命令 响应 AT+QIPROMPT? +QIPROMPT: uec tial 配置命令 OK 响应 AT+QIPROMPT= OK ERROR Q n 最大响应时间 300ms e 参考 Quectel fid 参数 n 数字参数；表明 AT+QISEND 操作后，是否显示'>'和'SEND OK' o 0 发送成功时不显示'>'，返回'SEND OK' C1 发送成功时显示'>'，返回'SEND OK' 2 发送成功时不显示'>'，不返回'SEND OK' 3 发送成功时显示'>'，返回', SEND OK' 上海移远通信技术有限公司 162 / 256 M26 AT 命令手册 11.18. AT+QISERVER 配置为服务器 语法 AT+QISERVER 配置为服务器 测试命令 AT+QISERVER=? 查询命令 AT+QISERVER? 响应 OK 响应 +QISERVER: , OK 执行命令 AT+QISERVER uectel tial 配置命令 AT+QISERVER=[,] Q fiden 最大响应时间 n 参考 Co Quectel 响应 OK ERROR 成功配置为服务器，返回： SERVER OK 配置为服务器失败，返回： CONNECT FAIL 响应 OK ERROR 成功配置为服务器，返回： SERVER OK 配置为服务器失败，返回： CONNECT FAIL 150s，受网络状态影响 参数 0 不配置成服务器 1 配置成服务器 当前已连入的客户端的数量，范围为 1-5 数字参数；表明配置的服务器类型 0 TCP 服务器 1 UDP 服务器 服务器最大可接入连接数，默认为 1，范围为 1-5 上海移远通信技术有限公司 163 / 256 备注 当 AT+QIMUX=0 时，参数被缺省。 M26 AT 命令手册 11.19. AT+QICSGP 设置 CSD 或 GPRS 连接模式 语法 AT+QICSGP 设置 CSD 或 GPRS 连接模式 测试命令 响应 AT+QICSGP=? +QICSGP: 0-CSD,DIAL NUMBER,USER NAME,PASSWORD,RATE(0-3) +QICSGP: 1-GPRS,APN,USER NAME,PASSWORD tel 查询命令 AT+QICSGP? OK 响应 +QICSGP: uec tial 配置命令 AT+QICSGP=[,(,,)/ (,,,)] 最大响应时间 OK 响应 OK ERROR 300ms fid 参考 Quectel CSD 相关配置暂不支持 n 参数 Co 数字参数；表明无线连接模式 0 CSD 连接 1 GPRS 连接 GPRS 连接配置的参数说明： 字符串参数；表明接入点名称 字符串参数；表明用户名 字符串参数；表明用户密码 CSD 连接配置的参数说明： 上海移远通信技术有限公司 164 / 256 字符串参数；表明 CSD 号码 字符串参数；表明 CSD 连接用户名 字符串参数；表明 CSD 连接用户密码 数字参数；表明 CSD 连接速率 0 2400 1 4800 2 9600（缺省值） 3 14400 M26 AT 命令手册 11.20. AT+QISRVC 选择当前可操作连接 语法 AT+QISRVC 选择当前可操作连接 l 测试命令 AT+QISRVC=? 响应 +QISRVC: (取值列表) cte l 查询命令 ue tia AT+QISRVC? OK 响应 +QISRVC: Q n 配置命令 AT+QISRVC= fide 最大响应时间 参考 Quectel OK 响应 OK ERROR 300ms CSD 相关配置暂不支持 Con 参数 数字参数；用于选择当前可操作连接 1 选择 ME 作为 Client 的连接 2 选择 ME 作为 Server 的连接 备注 该操作用于以下情况，当前存在两路或多路连接，一路连接是 ME 作为 Client 连接远程 Server，一路连 接时 ME 作为 Server 接入远程 Client，通过该命令可区分和选择当前操作的连接。 上海移远通信技术有限公司 165 / 256 M26 AT 命令手册 11.21. AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号 语法 AT+QISHOWRA 配置接收数据时是否显示发送方的 IP 地址和端口号 测试命令 响应 AT+QISHOWRA=? +QISHOWRA: (取值列表) 查询命令 AT+QISHOWRA? OK 响应 +QISHOWRA: (取值列表) 配置命令 AT+QISHOWRA= l 最大响应时间 te 参考 c l Quectel OK 响应 OK ERROR 300ms ue tia 参数 Q en 数字参数；表明接收数据时是否显示发送方的 IP 地址和端口号 0 不显示 （默认值） 1 显示，格式为：RECV FROM: : fid 11.22. AT+QISCON 保存 TCPIP 应用场景配置 on 语法 C AT+QISCON 保存 TCPIP 应用场景配置 测试命令 响应 AT+QISCON=? OK 查询命令 AT+QISCON? 响应 显示 TCPIP 上下文： SHOW APPTCPIP CONTEXT +QIDNSIP: +QIPROMPT: +QIHEAD: 上海移远通信技术有限公司 166 / 256 M26 AT 命令手册 +QISHOWRA: +QICSGP: Gprs Config APN: Gprs Config UserId: Gprs Config Password: Gprs Config inactivityTimeout: CSD Dial Number: CSD Config UserId: CSD Config Password: CSD Config rate: App Tcpip Mode: In Transparent Transfer Mode tel 执行命令 AT+QISCON c l 最大响应时间 ue tia 参考 Quectel Number of Retry: Wait Time: Send Size: esc: OK 响应 OK 300ms Q n 参数 fide n o C 请参考 AT+QIDNSIP 请参考 AT+QIPROMPT 请参考 AT+QIHEAD 请参考 AT+QISHOWRA 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 请参考 AT+QICSGP 以下配置仅属于透明传输模式： 请参考 AT+QITCFG 请参考 AT+QITCFG 上海移远通信技术有限公司 167 / 256 M26 AT 命令手册 请参考 AT+QITCFG 请参考 AT+QITCFG 备注 1. 执行命令保存以下 AT 命令配置：AT+QIDNSIP，AT+QIPROMPT，AT+QIHEAD，AT+QISHOWRA， AT+QICSGP，AT+QITCFG； 2. 执行命令操作只影响当前前置场景各参数配置（请参考 AT+QIFGCNT）。 11.23. AT+QIMODE 配置 TCPIP 应用模式 语法 AT+QIMODE 配置 TCPIP 应用模式 l 测试命令 响应 te AT+QIMODE=? +QIMODE: (取值列表) c l 查询命令 ue tia AT+QIMODE? OK 响应 +QIMODE: Q n 配置命令 e AT+QIMODE= fid 最大响应时间 参考 Quectel OK 响应 OK ERROR 300ms Con 参数 0 非透传模式 1 透传模式（在该模式下，建立连接成功后，UART 将会进入数据模式。接收到的数据将 直接输出至串口，可通过'+++'退出数据模式，ATO 操作返回数据模式） 上海移远通信技术有限公司 168 / 256 M26 AT 命令手册 11.24. AT+QITCFG 配置透明传输模式 语法 AT+QITCFG 配置透明传输模式 测试命令 AT+QITCFG=? 响应 +QITCFG: (取值列表), (取值列表), (取 值列表), (取值列表) OK 查询命令 响应 AT+QITCFG? +QITCFG: ,,, l 配置命令 AT+QITCFG=,,< te SendSz>, 最大响应时间 c l 参考 ue tia Quectel OK 响应 OK ERROR 300ms Q n 参数 e fid 一个 IP 包的重传次数 间隔发送时间，单位为 100ms 每次发送数据字节数 是否开启转义序列，缺省值是 TRUE n 备注 Co 1. 最大值为 1460； 2. 和都可以指示发送数据操作。当发送的数据长度大于或等于时，将 优 先 发 送 长 度 的 数 据 给 远 程 连 接 ； 当 发 送 的 数 据 长 度 小 于 时 ， 将 会 等 待 时长，时间到后将串口已输入的数据发送出去； 3. 该命令只在 AT+QIMUX=0 状态下有效。 上海移远通信技术有限公司 169 / 256 M26 AT 命令手册 11.25. AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议 语法 AT+QISHOWPT 配置接收数据 IP 头是否显示传输协议 测试命令 响应 AT+QISHOWPT=? +QISHOWPT: (取值列表) 查询命令 AT+QISHOWPT? OK 响应 +QISHOWPT: 配置命令 AT+QISHOWPT= l 最大响应时间 te 参考 c l Quectel OK 响应 OK ERROR 300ms ue tia 参数 Q en 数字参数；配置在接收到 TCP 或 UDP 数据时，接收数据 IP 头内是否显示传输协议 0 不显示 1 显示，格式为：IPD (data length) (TCP/UDP): fid 备注 Con 该=1 只在 AT+QIHEAD=1 时有效。 11.26. AT+QIMUX 控制是否启用多路连接 语法 AT+QIMUX 控制是否启用多路连接 测试命令 AT+QIMUX=? 响应 +QIMUX: (取值列表) OK 上海移远通信技术有限公司 170 / 256 M26 AT 命令手册 查询命令 AT+QIMUX? 配置命令 AT+QIMUX= 最大响应时间 参考 Quectel 响应 +QIMUX: OK 响应 OK ERROR 300ms 参数 l 数字参数；控制当前场景下连接模式 0 不启用多路连接 1 启用多路连接 cte l 11.27. AT+QISHOWLA 控制是否显示本地 IP 地址 ue tia 语法 AT+QISHOWLA 控制是否显示本地 IP 地址 Q n 测试命令 响应 e AT+QISHOWLA=? +QISHOWLA: (取值列表) fid 查询命令 AT+QISHOWLA? OK 响应 +QISHOWLA: on 配置命令 C AT+QISHOWLA= OK 响应 OK ERROR 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 171 / 256 参数 数字参数；表明在接收到数据前是否显示数据发送的目的 IP 地址 0 不显示 1 显示，格式为：TO: M26 AT 命令手册 11.28. AT+QIFGCNT 配置前置场景 语法 AT+QIFGCNT 配置前置场景 测试命令 AT+QIFGCNT=? l 查询命令 te AT+QIFGCNT? c l 配置命令 ue tia AT+QIFGCNT= 最大响应时间 Q n 参考 e Quectel 响应 +QIFGCNT: (取值列表) OK 响应 +QIFGCNT: , OK 响应 OK ERROR 300ms fid 参数 n Co 数字参数；表明当前前置场景序号，范围为 0-1 数字参数；表明当前场景受控于哪一个通道 0 VIRTUAL_UART_1 1 VIRTUAL_UART_2 2 VIRTUAL_UART_3 3 VIRTUAL_UART_4 255 当前场景未受控于任何通道 备注 当 AT+CMUX=1 打开多路复用功能后，若当前通道操作指定的场景状态不是 IP INITIAL 且该 场景被其他通道控制，操作将失败，返回 ERROR。 上海移远通信技术有限公司 172 / 256 M26 AT 命令手册 11.29. AT+QISACK 查询发送数据信息 语法 AT+QISACK 查询发送数据信息 测试命令 AT+QISACK=? 执行命令 AT+QISACK 响应 OK 响应 +QISACK: , , OK 配置命令 响应 AT+QISACK= l 最大响应时间 参考 te Quectel +QISACK: , , OK 300ms uec tial 参数 Q n e 查询的连接序号 数字参数；表明已发送数据大小 数字参数；表明已发送并得到远程接收方确认的数据大小 数字参数；表明已发送但未得到远程接收方确认的数据大小 fid 备注 1. 执行命令仅在 AT+QIMUX=0 时有效； n 2. 配置命令仅在 AT+QIMUX=1 时有效； o 3. 该命令操作受控于 AT+QISRVC 配置。当 AT+QISRVC=1 时，查询的是 ME 作为 Client 向远程 Server C 发送数据信息；当 AT+QISRVC=2 时，查询的是 ME 作为 Server 向远程 Client 发送的数据信息。 11.30. AT+QINDI 配置是否缓存接收到的数据 语法 AT+QINDI 配置是否缓存接收到的数据 测试命令 响应 AT+QINDI=? +QINDI: (取值列表) 上海移远通信技术有限公司 173 / 256 M26 AT 命令手册 查询命令 AT+QINDI? OK 响应 +QINDI: 配置命令 AT+QINDI= OK 响应 OK ERROR 最大响应时间 300ms 参考 Quectel 参数 l Quectential e fid 数字参数；表明是否缓存接收到的数据 0 不缓存；接收到数据直接输出至串口 1 缓存模式 1；接收到数据将会向串口上报提示，格式为：+QIRDI: ,, （此 时可以通过 AT+QIRD 读取缓存的数据） 2 缓存模式 2；接收到数据将会向串口上报提示，格式为： +QIRDI: ,,,,,。每个 Socket 将建立一个缓存，接收 的数据将被保存在缓存中，直到通过 AT+QIRD 读取缓存的数据，缓存数据不应超过 400KB 数字参数；表明哪个场景接收到了新数据并缓存到缓存器内（可参考 AT+QIFGCNT）， 范围是 0-1 数字参数；表明 ME 是作为 Server 还是作为 Client 建立的连接接收到数据 1 ME 作为 Client 连接 2 ME 作为 Server 连接 数字参数；表明 ME 是哪一路连接接收到数据，范围是 0-5（当 AT+QIMUX=0 时，=0） Con 11.31. AT+QIRD 读取缓存的数据 语法 AT+QIRD 读取缓存的数据 测试命令 AT+QIRD=? 响应 +QIRD: (取值列表), (取值列表), (取值列表), (取值列表) OK 上海移远通信技术有限公司 174 / 256 M26 AT 命令手册 配置命令 AT+QIRD=,,, 最大响应时间 参考 Quectel 响应 [+QIRD: :,, ] OK ERROR 300ms 参数 l cte l ue tia Q en 数字参数；表明哪个场景接收到了新数据并缓存到缓存器内（可参考 AT+QIFGCNT），范围 是 0-1 数字参数；表明 ME 是作为 Server 还是作为 Client 建立的连接接收到数据 1 ME 作为 Client 连接 2 ME 作为 Server 连接 数字参数；表明 ME 是哪一路连接接收到数据，范围是 0-5（当 AT+QIMUX=0 时，=0） 读取数据长度，范围为 1-1500 发送数据方的 IP 地址 发送数据方的端口号 字符串类型；表明传输协议类型 TCP TCP 协议 UDP UDP 协议 读取到的真实数据长度 读取到的数据内容 nfid 11.32. AT+QISDE 控制 AT+QISEND 是否允许数据回显 Co 语法 AT+QISDE 控制 AT+QISEND 是否允许数据回显 测试命令 响应 AT+QISDE=? +QISDE: (取值列表) 查询命令 AT+QISDE? OK 响应 +QISDE: OK 上海移远通信技术有限公司 175 / 256 M26 AT 命令手册 配置命令 AT+QISDE= 最大响应时间 参考 Quectel 响应 OK ERROR 300ms 参数 数字参数；表明在操作 AT+QISEND 发送数据时，是否允许数据回显 0 不回显 1 回显 l 11.33. AT+QPING PING 远程服务器 te 语法 c l AT+QPING PING 远程服务器 ue tia 测试命令 AT+QPING=? 响应 +QPING: 'HOST',(取值列表),(取值列 表) Q en 配置命令 AT+QPING=''[,[][,]] OK 响应 OK [+QPING: [,,,,] n…] o +QPING:[,,,,,, C ] 最大响应时间 参考 Quectel ERROR 取决于 上海移远通信技术有限公司 176 / 256 M26 AT 命令手册 参数 字符串参数；远程服务器地址，可以是 IP 地址格式亦可以是域名格式 数字参数；每一次 PING 请求响应最大超时时间；单位：秒，范围：1-255，默认 1s 数字参数；PING 请求次数；范围：1-10，默认：4 PING 请求结果： 0 收到远程服务器响应，提示：, , , 1 PING 请求超时 远程服务器 IP 地址 每一次 PING 发送的数据长度 PING 请求耗时，单位：毫秒 PING 请求返回的当前时间 结束结果码 2 正常结束；成功激活 GPRS 连接上远程服务器，提示： ,,,,, 3 TCP/IP 协议栈忙 l 4 未找到远程服务器 5 激活 PDP 场景失败 te 发送 PING 请求总次数 发送 PING 请求并收到响应总次数 c l PING 请求超时次数 ue tia 最小响应时间，单位：毫秒 最大响应时间，单位：毫秒 平均响应时间，单位：毫秒 Q en 11.34. AT+QNTP 通过网络时间服务器同步本地时间 fid 语法 n AT+QNTP 通过网络时间服务器同步本地时间 测试命令 响应 Co AT+QNTP=? +QNTP: 'SERVER',(取值列表) OK 查询命令 响应 AT+QNTP? +QNTP: '', 执行命令 AT+QNTP OK 响应 OK +QNTP: 上海移远通信技术有限公司 177 / 256 M26 AT 命令手册 配置命令 AT+QNTP=''[,] ERROR 响应 OK +QNTP: 最大响应时间 参考 Quectel ERROR 120s，受网络状态影响 参数 l uecte tial 字符串参数；时间服务器的 IP 地址或域名 时间服务器的端口号 时间同步结果 0 本地时间同步成功 1 本地时间同步失败，未知错误 2 时间服务器无响应 3 TCP/IP 协议栈忙 4 未找到时间服务器 5 激活 PDP 场景失败 Q en 备注 Confid 中国默认国际时间服务器地址为'210.72.145.44' ，端口号是 123。 上海移远通信技术有限公司 178 / 256 M26 AT 命令手册 12 补充业务命令 12.1. AT+CCFC 设置呼叫转移 AT+CCFC 根据 GSM 02.82[4]，对呼叫转移业务进行控制，同时支持注册、删除、激活、去激活和状 态查询。 语法 l AT+CCFC 设置呼叫转移 测试命令 te AT+CCFC=? 响应 +CCFC: (取值列表) uec tial 设置命令 AT+CCFC=,[,,[,[,[,[,time]]]]]] OK 响应 若不等于2且操作成功： OK 若等于2且操作成功（当且仅当=0~3）： +CCFC: , [, , [,,[,]]] [+CCFC: ....] OK Con 最大响应时间 功能相关报错： +CME ERROR: 300ms 参考 GSM 07.07 参数 0 1 2 无条件 移动遇忙 无应答 上海移远通信技术有限公司 179 / 256 M26 AT 命令手册 3 不可及 4 所有呼叫转移(0-3)（请参考GSM 02.30[19]） 5 所有条件呼叫转移(1-3)（请参考GSM 02.30[19]） 0 禁用 1 启用 2 状态查询 3 注册 4 删除 字符型；呼叫转移地址的电话号码，其格式符合所规定的 整数型的八位字节地址类型（请参考GSM 04.08[8]第10.5.4.7小节）；当拨号字符串包括国际 接入代码字符'+'时，缺省值为145；其他情况下，缺省值为129 字符型；由规定的字符型子地址的格式 ctel l ue tia 整数型的八位字节子地址类型（请参考GSM 04.08[8]第10.5.4.8小节） 1 语音 2 数据 4 传真 7 语音，数据和传真 8 短消息 16 同步数据电路 32 异步数据电路 1…30 如果启用或禁止'无应答'，该参数使得再改呼叫转移前有秒数的等待时间，默认值 为20 0 非激活 1 激活 Q n 举例 e AT+CCFC=0, 3,'15021012496' fid OK AT+CCFC=0,2 +CCFC: 1, 1,'+8615021012496',145 //设置无条件转移至 15021012496 //查询无条件转移设置，转移成功 n +CCFC: 1, 4,'+8615021012496',145 Co +CCFC: 1, 32,'+8615021012496',145 +CCFC: 1, 16,'+8615021012496',145 OK AT+CCFC=0,4 OK AT+CCFC=0,2 +CCFC: 0, 7 //删除无条件转移 //查询无条件转移设置，设置删除 上海移远通信技术有限公司 180 / 256 M26 AT 命令手册 OK 12.2. AT+CCUG 封闭用户组 该命令可控制 CUG（Closed User Group）附加业务（详情请参考 GSM 02.85[21]）。用户可选择 CUG 索引、抑制 OA（Outgoing Access）、抑制优先 CUG。 语法 AT+CCUG 封闭用户组 测试命令 AT+CCUG=? 查询命令 AT+CCUG? 响应 OK 响应 +CCUG: ,, tel 设置命令 c l AT+CCUG=[][,[,]] ue tia 最大响应时间 参考 Q n GSM 07.07 OK 响应 OK +CME ERROR: 300ms e 参数 fid 0 1 n 0...9 10 o 0 C1 禁用暂时模式下提供的 CUG 业务 启用暂时模式下提供的 CUG 业务 CUG 索引 无索引（优先 CUG 取自用户数据） 无信息 抑制 OA 2 抑制优先 CUG 3 抑制 OA 和优先 CUG 12.3. AT+CCWA 呼叫等待 该命令根据 GSM02.83[5]，对呼叫等待业务进行禁用，启用及查询控制。 上海移远通信技术有限公司 181 / 256 M26 AT 命令手册 语法 AT+CCWA 呼叫等待 测试命令 AT+CCWA=? 响应 +CCWA: (取值列表) 查询命令 AT+CCWA? OK 响应 +CCWA: OK 配置命令 响应 AT+CCWA=[],[,]] 当不等于2且操作成功： OK 当等于2且操作成功： l +CCWA:,[+CCWA:,< class2>[...]] uecte tial 最大响应时间 参考 GSM 07.07 OK +CME ERROR: 300ms 相关 URC 上报： +CCWA: ,,[,] Q en 参数 fid Con 在 TA 设置或显示结果码的显示状态 0 禁用 1 启用 若没有给定该参数，则不能询问网络 0 禁用 1 启用 2 查询状态 代表每一种信息类别的整数的总和 1 语音（电话业务） 2 数据 4 传真 16 同步数据电路 32 异步数据电路 0 非激活 1 激活 字符串类型。电话号码的地址类型必须符合的要求 上海移远通信技术有限公司 182 / 256 M26 AT 命令手册 整型格式的地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 可选字符类型，字母数字的表示对应电话号码簿中的位置 备注 1. 如果对于任何，例如+CCWA: 0,7，服务都没有被激活，这种情况下，=0 将会返 回； 2. 当=2，所有的激活的呼叫转移号码将被上报，在这种模式下，按任何键，命令都可以被终 止。 举例 AT+CCWA=1,1 OK l ATD10086; te OK c l +CCWA: '02154450293',129,1 //启用在 TA 设置或显示结果码的显示状态 //建立通话 //通话中来电，来电处于呼叫等待状态中 ue tia 12.4. AT+CHLD 呼叫保持和多方通话 Q en 使用该命令，可将当前通话暂时从 ME 释放，但是网络和多方通话仍然保持该连接。具有两个通话（一 个通话保持，另一个通话在用或提示）的用户可以连接到其他各方的通话，并释放自己的连接。 fid 语法 n AT+CHLD 呼叫保持和多方通话 测试命令 Co AT+CHLD=? 响应 +CHLD: (取值列表) OK 配置命令 响应 AT+CHLD=[] OK +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 183 / 256 M26 AT 命令手册 参数 0 释放所有保持的呼叫或者等待中的呼叫（UDUB 用户决定忙）。如果有电话处于等待状 态，终止等待的电话，否则，终止所有保持的电话 1 如果存在当前呼叫，释放所有当前呼叫并将接听另外一个已保持或等待中的呼叫。当只 有一路通话时，该操作不能结束已激活的通话 1X 释放当前某一特定的呼叫 X（X=1~7） 2 如果存在当前呼叫，保持所有当前呼叫并接听另外一个已保持或等待中的呼叫 2X 保持除通讯必须支持的呼叫 X（X=1~7）外的所有当前呼叫 3 为会话增加一个已保持通话 备注 该业务仅适用于电信服务 11（报告：电话）。 l 举例 te AT+CCWA=1,1 OK c l ATD10086; ue tia OK //启用在 TA 设置或显示结果码的显示状态 //建立通话 +CCWA: '02154450293',129,1 Q n AT+CHLD=2 OK e AT+CLCC +CLCC: 1,0,1,0,0,'10086',129,'' // 通话中来电，来电处于呼叫等待状态中 //保持第一路通话，并接入第二路呼叫等待的通话 //第一路通话被保持 fid +CLCC: 2,1,0,0,0,'02154450293',129,'' //第二路通话被接入 n OK o AT+CHLD=21 OK C AT+CLCC //激活第一路通话，保持第二路通话 +CLCC: 1,0,0,0,0,'10086',129,'' //第一路通话被接入 +CLCC: 2,1,1,0,1,'02154450293',129,'' //第二路通话被保持 OK AT+CHLD=3 OK AT+CLCC +CLCC: 1,0,0,0,1,'10086',129,'' //激活所有通话，实现 3 方通话 上海移远通信技术有限公司 184 / 256 M26 AT 命令手册 +CLCC: 2,1,0,0,1,'02154450293',129,'' OK 12.5. AT+CLIP 来电号码显示设置 语法 AT+CLIP 来电号码显示设置 测试命令 AT+CLIP=? l 查询命令 AT+CLIP? cte l 配置命令 ue tia AT+CLIP=[] 最大响应时间 Q n 参考 fide GSM 07.07 响应 +CLIP: (取值列表) OK 响应 +CLIP: , OK 响应 OK +CME ERROR: 15s，受网络状态影响 URC 上报： 当可在 TE 显示 CLI 且主叫方允许的情况下，当所有 RING 或 +CRING: 的返回结果从 TA 发送到 TE 后，将返回： +CLIP: , ,'',,, 参数 on C 0 不显示结果码 1 显示结果码 0 未提供 CLIP 业务 1 提供 CLIP 业务 2 未知 字符型；由规定的电话号码格式 整数型的八位字节地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 字符串类型；电话本中条目对应的字符表示（该参数由 AT+QCLIP 控制是 否显示字符串内容） 0 CLI 有效 上海移远通信技术有限公司 185 / 256 M26 AT 命令手册 1 CLI 由发起端保留 2 CLI 由于网络问题或者由于发起端网络的限制而不可行 备注 1. 配置命令可启用或禁用 CLI 显示在 TE 上。但对附加业务 CLIP 在网络中的执行没有影响； 2. 查询命令给定的状态，并根据 GSM02.81[3]触发对 CLIP 业务的配置状态的查询。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+CLIP=1 OK RING tel +CLIP: '02151082965',129,'',,'',0 uec tial 12.6. AT+QCLIP 配置来电是否显示主叫号码名称 语法 Q n AT+QCLIP 配置来电是否显示主叫号码名称 e 测试命令 响应 fid AT+QCLIP=? +QCLIP: (取值列表) n 查询命令 AT+QCLIP? OK 响应 +QCLIP: Co OK 配置命令 响应 AT+QCLIP= OK +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 186 / 256 参数 来电是否显示主叫号码名称 0 不显示 1 显示 备注 该命令仅在 AT+CLIP=1 下有效。 M26 AT 命令手册 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+QCLIP=1 l OK AT+CLIP=1 te OK c l RING ue tia +CLIP: '02151082965',129,'',,'QUECTEL',0 Q en 12.7. AT+CLIR 主叫识别限制 fid 当主叫方发起呼叫时，使用该命令可启用或禁止在被叫方显示 CLI。对于所有的接下来的去电，已经设 置了一个默认值作为临时模式，那么这个命令将会覆盖 CLIR 设置（默认是限制或者允许）。通过使用相反 的命令，这个设置被撤销。 on 语法 C AT+CLIR 主叫识别限制 测试命令 响应 AT+CLIR=? +CLIR: (取值列表) 查询命令 AT+CLIR? OK 响应 +CLIR: , OK 功能相关报错： 上海移远通信技术有限公司 187 / 256 M26 AT 命令手册 配置命令 AT+CLIR=[] 最大响应时间 参考 GSM 07.07 +CME ERROR: 响应 OK +CME ERROR: 15s，受网络状态影响 参数 uectel tial 设置出局呼叫的调整状态 0 依据 CLIR 业务的开通状态使用提示指示语 1 CLIR 调用 2 CLIR 抑制 显示主叫在网络中的 CLIR 业务状态 0 未提供 CLIR 业务 1 永久方式下提供的 CLIR 业务 2 未知（如：无网络等） 3 暂时模式下提供的 CLIR 业务受限 4 暂时模式下提供的 CLIR 业务不受限 备注 Q n 使用该命令功能，需要注意对应 SIM 卡是否支持号码隐藏业务。 fide 12.8. AT+COLP 显示被叫识别 on 当主叫方在发起呼叫时，使用该命令可启用或禁止显示呼叫识别。在任何的+CR 或者 V.25ter 响应之 C 前，中间结果码直接从 TA 返回给 TE。 语法 AT+COLP 显示被叫识别 测试命令 AT+COLP=? 响应 +COLP: (取值列表) 查询命令 AT+COLP? OK 响应 +COLP: , 上海移远通信技术有限公司 188 / 256 M26 AT 命令手册 配置命令 AT+COLP=[] 最大响应时间 参考 GSM 07.07 OK 响应 OK +CME ERROR: 15s，受网络状态影响 URC 上报： 当使能（并且被叫用户容许），在任何+CR 和 V.25ter 响应之 前，一个中间结果码返回： +COLP: ,[,, [,]] 参数 l cte l ue tia Q n e 0 不显示结果码 1 显示结果码 0 未提供 COLP 业务 1 提供 COLP 业务 2 未知 字符型；由规定的电话号码格式 整数型的八位字节地址类型 129 未知类型（IDSN 格式号码） 145 国际号码类型（ISDN 格式） 字符串类型，子地址格式符合 整型格式的子地址类型（参考 GSM04.08[8]章节 10.5.4.8） 字符串类型；电话本中条目对应的字符表示（该参数由 AT+QCOLP 控制是 否显示字符串内容） fid 备注 Con 查询命令给定的状态，并根据 GSM02.81[3]，可触发对 COLP 业务的配置状态的查询（中给定）。 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,'',0,'' OK 上海移远通信技术有限公司 189 / 256 M26 AT 命令手册 12.9. AT+QCOLP 显示+COLP 字符串名称 语法 AT+QCOLP 显示+COLP 字符串名称 测试命令 响应 AT+QCOLP=? +QCOLP: (取值列表) 查询命令 AT+QCOLP? OK 响应 +QCOLP: 配置命令 AT+QCOLP= l 最大响应时间 te 参考 c l Quectel OK 响应 OK +CME ERROR: 300ms ue tia 参数 Q en 是否显示+COLP 字符串名称 0 不显示 1 显示 fid 备注 n 该命令仅在 AT+COLP=1 下有效。 Co 举例 AT+CPBW=1,'02151082965',129,'QUECTEL' OK AT+QCOLP=1 OK AT+COLP=1 OK ATD02151082965; +COLP: '02151082965',129,'',0,'QUECTEL' 上海移远通信技术有限公司 190 / 256 M26 AT 命令手册 OK 12.10. AT+CUSD 非结构化附加业务 该命令根据 GSM02.90[23]，用于对 USSD（Unstuctured Supplementary Service Data）进行控制。 该命令支持网络和移动发起的操作。用于启用或禁用非请求结果码（网络返回的 USSD 返回结果 或网络发起操作）+CUSD : [,,]显示在 TE 上的。 指定时，移动发起的 USSD 字符串或网络发起操作的返回结果 USSD 字符串将发送给网络。通 过非请求结果码+CUSD，返回网络侧的返回结果 USSD 字符串。 语法 l AT+CUSD 非结构化附加业务 测试命令 te AT+CUSD=? 响应 +CUSD: (取值列表) uec tial 查询命令 AT+CUSD? OK 响应 +CUSD: Q n 配置命令 e AT+CUSD=[[,[,]] fid 最大响应时间 参考 n GSM 07.07 OK 响应 OK +CME ERROR: 120s，受网络状态影响 Co 参数 用于指示非结构化附加业务数据控制的数字参数 0 禁用结果码显示在 TA 上 1 启用结果码显示在 TA 上 2 取消会话（不适用于查询命令的返回结果） 字符串类型，USSD 字符串（如果表示使用 GSM03.38[25]中的缺省符号值，ME/TA 将根 据 GSM07.05[24]Annex A，将 GSM 中的符号集转换为当前 TE 的字符集） GSM03.38[25]中采用整数型的小区广播数据编码方案（默认值为 0） 上海移远通信技术有限公司 191 / 256 M26 AT 命令手册 举例 AT+CSCS='UCS2' OK AT+CUSD=1,'002A0031003000300023' +CUSD: 1,'0031002E59296C14000A0032002E65B095FB000A0033002E8BC15238000A0034002E5F6979680 00A0035002E751F6D3B000A0036002E5A314E50000A0037002E5E385DDE98CE91C7000A002A002 E900051FA000A', 72 OK 12.11. AT+CSSN 附加业务通知 该命令表示与附加业务有关的由网络发起的通知。使用该配置命令，可启用或禁用 TA 的通知结果码显 l 示在 TE 上。 te 当 =1 ， 并 且 在 移 动 终 端 发 起 呼 叫 的 过 程 中 收 到 附 加 业 务 通 知 时 ， 中 间 结 果 码 +CSSI: c l [,]将被发送给 TE。 ue tia 当=1，并且在移动终端终止呼叫过程中收到附加业务通知时，或在收到前转校验附加业务通知时， 非请求结果码+CSSU:将被发送给 TE。 Q n 语法 e AT+CSSN 附加业务通知 fid 测试命令 AT+CSSN=? 响应 +CSSN: (取值列表), (取值列表) n 查询命令 Co AT+CSSN? OK 响应 +CSSN: , OK 配置命令 响应 AT+CSSN=[[,]] OK +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 192 / 256 M26 AT 命令手册 参数 在发起呼叫建立后，用以表示是否显示+CSSI : [,]结果码状态的数字参数 0 禁用 1 启用 当接收到呼叫转移补充业务通知，一个终端呼叫建立或者在呼叫进行中的时候，用以表示是 否显示+CSSU : 结果码状态的数字参数 0 禁用 1 启用 0 激活无条件呼叫转移 1 激活有条件呼叫转移 2 呼叫已经被转移 3 呼叫等待中 4 是CUG呼叫（也会出现） 5 禁止出局呼叫 6 禁止入局呼叫 l 7 CLIR抑制关闭 关闭的用户组索引号 CQouneficdteential 0 指示这是一个呼叫转移的呼叫 上海移远通信技术有限公司 193 / 256 M26 AT 命令手册 13 音频控制命令 13.1. ATL 设置监听扬声器音量 语法 ATL 设置监听扬声器音量 执行命令 ATL l 最大响应时间 te 参考 V.25ter uec tial 参数 0 低扬声器音量 Q n 1 中低扬声器音量 e 2 中扬声器音量 3 高扬声器音量 fid 备注 Con GSM无效。 响应 OK 300ms 13.2. ATM 设置监听扬声器模式 语法 ATM 设置监听扬声器模式 执行命令 响应 ATM OK 上海移远通信技术有限公司 194 / 256 M26 AT 命令手册 最大响应时间 参考 V.25ter 300ms 参数 0 扬声器关闭 1 扬声器被打开，当有载波被检测到 2 扬声器打开 备注 ATL 以及 ATM 命令仅在 V.25ter 生效，对 GSM 无效。 tel 13.3. AT+VTD 配置 DTMF 音播放时长 c l 语法 ue tia AT+VTD 配置 DTMF音播放时长 测试命令 Q n AT+VTD=? 响应 +VTD: ( 取 值 列 表 )[,( 取 值 列 表)] fide 查询命令 AT+VTD? OK 响应 +VTD: , on 配置命令 C AT+VTD= OK 响应 OK [,] +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 195 / 256 M26 AT 命令手册 参数 1-255 0 1-100000 以 100ms 为单位，设置播放 DTMF 的间隔时长 以 1/1000 秒为单位的 DTMF 音调播放时长，缺省默认为 0 单个 DTMF 音播放的时长，单位为 ms 备注 该命令控制 AT+VTS 产生的 DTMF 音播放时长。 13.4. AT+VTS DTMF 音调发送 该命令可发送一个或多个 ASCII 字符，这些字符的作用是使 MSC（Mobile Switching Center）为远程 l 用户发射双音多频 DTMF（Dual Tone Multi Frequency）音调。 te 语法 c l AT+VTS DTMF 音调发送 ue tia 测试命令 AT+VTS=? 响应 +VTS: (取值列表),,( 取值列表) Q n 配置命令 e AT+VTS= fid 最大响应时间 参考 n GSM 07.07 OK 响应 OK +CME ERROR: 取决于的长度 Co 参数 最大值为 20 个字符。必须放在双引号间。它由下面的字符串构成，间隔以','隔开。但 是单个字符不需要引号  单个 ASCII 字符，范围：0-9, #,*, A-D。它作为一个 DTMF 音调的序列被解 析，持续时间通过 AT+VTD 命令来控制  {, }作为一个 DTMF 音调被解析，持续时间由控制 1-255 以 100ms 秒为单位的 DTMF 音调播放时长 上海移远通信技术有限公司 196 / 256 M26 AT 命令手册 备注 1. 该配置命令仅适用于当前语音呼叫； 2. 允许用户在一段时间内发送一个序列的 DTMF 音调； 3. 允许用户发送单一的 DTMF 音调。在这种情况下，时间段可以在呼叫过程中单独决定。 举例 ATD10086; OK AT+VTS=1 OK //建立呼叫 //根据语音提示输入 1 的 DTMF 音 13.5. AT+CALM 来电警报模式 l 语法 te AT+CALM 来电警报模式 c l 测试命令 ue tia AT+CALM=? 查询命令 Q n AT+CALM? fide 配置命令 AT+CALM= n 最大响应时间 o 参考 C GSM 07.07 响应 +CALM: (取值列表) OK 响应 +CALM: OK 响应 OK +CME ERROR: 300ms 参数 0 正常模式 1 静音模式（禁止播放来自 ME 的所有声音） 上海移远通信技术有限公司 197 / 256 备注 该配置命令仅适用于来电铃音控制。 M26 AT 命令手册 13.6. AT+CRSL 来电音量等级 语法 AT+CRSL 来电音量等级 测试命令 响应 AT+CRSL=? 查询命令 l AT+CRSL? cte l 配置命令 AT+CRSL= ue tia 最大响应时间 Q n 参考 GSM 07.07 +CRSL: (取值列表) OK 响应 +CRSL: OK 响应 OK +CME ERROR: 300ms fide 参数 Con 整数型，制造商自定义范围：0-100。最小值为最低音量等级。 13.7. AT+CLVL 扬声器音量等级 语法 AT+CLVL 扬声器音量等级 测试命令 AT+CLVL=? 响应 +CLVL: (取值列表) OK 上海移远通信技术有限公司 198 / 256 M26 AT 命令手册 查询命令 AT+CLVL? 配置命令 AT+CLVL= 最大响应时间 参考 GSM 07.07 响应 +CLVL: OK 响应 OK +CME ERROR: 300ms 参数 整数型，制造商自定义范围：0-100。最小值为最低音量等级。 tel 13.8. AT+CMUT 上行静音控制 uec tial 语法 AT+CMUT 上行静音控制 Q n 测试命令 AT+CMUT=? fide 查询命令 AT+CMUT? on 配置命令 C AT+CMUT= 响应 +CMUT: (取值列表) OK 响应 +CMUT: OK 响应 OK +CME ERROR: 最大响应时间 300ms 参考 GSM 07.07 上海移远通信技术有限公司 199 / 256 参数 0 关闭静音 1 打开静音(MIC 被静音) 备注 仅在呼叫过程中，该命令操作有效。 M26 AT 命令手册 13.9. AT+QSIDET 配置侧音增益等级 语法 l AT+QSIDET 配置侧音增益等级 te 测试命令 c l AT+QSIDET= ? ue tia 查询命令 AT+QSIDET? Q fiden 配置命令 AT+QSIDET= on 最大响应时间 C 参考 响应 +QSIDET: (取值列表) OK 响应 +QSIDET(NORMAL_AUDIO): OK +QSIDET(HEADSET_AUDIO): OK 响应 OK +CME ERROR: 300ms Quectel 参数 增益等级范围：0-255 上海移远通信技术有限公司 200 / 256 M26 AT 命令手册 13.10. AT+QMIC 配置麦克风增益等级 语法 AT+QMIC 配置麦克风增益等级 测试命令 AT+QMIC=? 响应 +QMIC: (取值列表), (取值列表) OK 查询命令 响应 AT+QMIC? +QMIC: , ,<gai l 配置命令 AT+QMIC=, te 最大响应时间 c l 参考 ue tia Quectel nlevel(Loudspeaker_Mic)> OK 响应 OK +CME ERROR: 300ms Q n 参数 e fid 0 主通道 1 耳机通道 2 主免提通道 增益等级范围：0-15 Con 13.11. AT+QLDTMF 产生本地 DTMF 音 语法 AT+QLDTMF 产生本地 DTMF 音 测试命令 AT+QLDTMF=? 响应 +QLDTMF: (取值列表), (取值列 表) OK 上海移远通信技术有限公司 201 / 256 M26 AT 命令手册 配置命令 AT+QLDTMF=[,] 执行命令 AT+QLDTMF 最大响应时间 参考 Quectel 响应 OK +CME ERROR: 响应 OK 取决于的长度 参数 数字参数1~1000，表明所有DTMF音的持续时间，以1/10秒为单位 字符串参数，最大输入20个DTMF音，用逗号隔开，DTMF音为ASCII字符，含0-9，#， *，A-D l 备注 te AT+QLDTMF 执行命令操作用于终止当前所有正在生成的 DTMF 音和任何 DTMF 音序列。 uec tial 13.12.AT+QAUDCH 切换音频通道 Q en 语法 fid AT+QAUDCH 切换音频通道 测试命令 AT+QAUDCH=? on 查询命令 C AT+QAUDCH? 响应 +QAUDCH: (取值列表) OK 响应 +QAUDCH: 配置命令 AT+QAUDCH=[] 最大响应时间 参考 Quectel OK 响应 OK +CME ERROR: 300ms 上海移远通信技术有限公司 202 / 256 参数 0 主通道（默认值） 1 耳机通道 2 主免提通道 M26 AT 命令手册 13.13. AT+QAUDLOOP 音频通道回环测试 语法 AT+QAUDLOOP 音频通道回环测试 测试命令 响应 AT+QAUDLOOP=? +QAUDLOOP: (取值列表), (取值列表) l 配置命令 te AT+QAUDLOOP=[,] c l 最大响应时间 ue tia 参考 Quectel OK 响应 OK +CME ERROR: 300ms Q n 参数 fide Con 0 停止测试 1 开始测试 0 主通道（默认值） 1 辅助耳机通道 2 主免提通道 13.14. AT+QLTONE 产生本地定制单音 语法 AT+QLTONE 产生本地定制单音 测试命令 AT+QLTONE=? 响应 +QLTONE: ( 取 值 列 表 ),( 取 值 列 表 ),( 取 值 列 表 ),( 取 值 列 表 ) , 上海移远通信技术有限公司 203 / 256 M26 AT 命令手册 (取值列表) 配置命令 AT+QLTONE =,,,< periodOff >, 最大响应时间 参考 Quectel OK 响应 OK +CME ERROR: 取决于要播放的定制单音长度 参数 l te c l 0 停止播放 1 开始播放 播放单音频率 一个周期内播放单音的时长 一个周期内静音的时长 单音播放总时长，单位为毫秒 ue tia 备注 当开始播放指定频率单音时，模块会持续播放该单音时长，然后再停止播放单音 Q n 时长，依次循环。直至总时长结束。 fide 13.15. AT+QTONEP 配置 DTMF/TONE 输出路径 n 语法 o AT+QTONEP 配置 DTMF/TONE 输出路径 C 测试命令 响应 AT+QTONEP=? +QTONEP: (取值列表) 查询命令 AT+QTONEP? OK 响应 +QTONEP: 配置命令 AT+QTONEP= OK 响应 OK 上海移远通信技术有限公司 204 / 256 M26 AT 命令手册 最大响应时间 参考 Quectel ERROR +CME ERROR: 300ms 参数 0 从话柄通道输出 DTMF 音 1 从辅助通道输出 DTMF 音 2 从免提道输出 DTMF 音 3 自动 备注 l 当 AT+QTONEP=3 时，DTMF 音输出由当前 AT+QAUDCH 所配置的值控制。 uecte tial 13.16.AT+QTDMOD 设置 DTMF检测模式 语法 Q en AT+QTDMOD 设置 DTMF 检测模式 测试命令 响应 fid AT+QTDMOD=? +QTDMOD: (取值列表), (取值列表) n 查询命令 Co AT+QTDMOD? OK 响应 +QTDMOD: , OK 配置命令 响应 AT+QTDMOD=, ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 205 / 256 M26 AT 命令手册 参数 1 设置DTMF检测范围 2 设置检测模式 0 当=1时，检测所有的DTMF音。包含1400和2300的交接信号 当=2时，一般算法去侦测音 1 当=1时，仅支持检测1400和2300的交接信号 当=2时，加强抖动算法去侦测音 2 当=1时，不检测1400和2300的交接信号 备注 1. 当 AT+QTDMOD =1,0 时，侦测所有的音，包括 DTMF、1400Hz 和 2300Hz； 2. 当 AT+QTDMOD =1,1 时，优化侦测并且仅仅侦测 1400Hz 和 2300Hz； 3. 当 AT+QTDMOD =1,2 时，检测 DTMF 音但不包含 1400Hz 和 2300Hz 的交接信号； 4. 当 AT+QTDMOD =2,0 时，一般算法去侦测音（包括 DTMF、1400Hz 和 2300Hz）； l 5. 当 AT+QTDMOD =2,1 时，加强抖动算法去侦测音； 6. 请参考 AT+QTONEDET。 uecte tial 13.17.AT+QTONEDET DTMF检测 语法 Q n AT+QTONEDET DTMF 检测 e 测试命令 fid AT+QTONEDET=? n 查询命令 Co AT+QTONEDET? 响应 +QTONEDET: (取值列表) OK 响应 +QTONEDET: OK 配置命令 响应 AT+QTONEDET=[,][ OK ,][,][,] +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 206 / 256 M26 AT 命令手册 参数 < mode> 0 关闭DTMF检测 1 开启DTMF检测 2 检测1400Hz和2300Hz，100ms的DTMF 3 检测1400Hz和2300Hz，400ms的DTMF 4 配置DTMF检测入点 5 开启调试模式 当=2，配置如下： 0 查询1400Hz和2300Hz两个频率点100ms侦测阀值 1 设置1400Hz和2300Hz两个频率点100ms侦测阀值. 有效音前 空闲值个数, 有效音最低阀值, 有效音最高 阀值 当=3,配置如下： 0 查询1400Hz和2300Hz两个频率点400ms侦测阀值 l 1 设置1400Hz和2300Hz两个频率点400ms侦测阀值. 有效音前 空闲值个数, 有效音最低阀值, 有效音最高 te 阀值 c l 当=4,配置如下： ue tia 0 查询DTMF侦测阀值 1 设置DTMF侦测阀值. 有效音前空闲值个数， 有效音最低阀值, 有消音最高阀值 Q fiden n Co 当=5，配置如下： 0 正常工作状态, 报告+QTONEDET: x,x 1 调试状态，报告+QTONEDTD:x,x,… 2 混合状态，报告+QTONEDTD:x,x,…和+QTONEDET: x,x, 有效音前空闲值个数 有效音最低阀值 有效音最高阀值 DTMF代码 48 DTMF 0 49 DTMF 1 50 DTMF 2 51 DTMF 3 52 DTMF 4 53 DTMF 5 54 DTMF 6 55 DTMF 7 56 DTMF 8 57 DTMF 9 65 DTMF A 上海移远通信技术有限公司 207 / 256 M26 AT 命令手册 66 67 68 42 35 69 70 100 400 DTMF B DTMF C DTMF D DTMF * DTMF # 1400Hz 频率 2300Hz 频率 被侦测到100ms的1400Hz and 2300 Hz 被侦测到400ms的1400Hz and 2300 Hz 备注 1. 仅在通话中有效； 2. 若 DTMF 音的播放时长在阀值范围内，则该指令设置生效，单位为 20ms； 3. 在调试状态下，上报+QTONEDTD: ,,,, ,,； l 4. 上报时： a) +QTONEDET: 50 检测到 DTMF 2 te b) +QTONEDET: 69,100 检测到 100ms 的 1400Hz 单音 c l c) +QTONEDET: 70,100 检测到 100ms 的 2300Hz 单音 d) +QTONEDET: 69,400 检测到 400ms 的 1400Hz 单音 ue tia e) +QTONEDET: 70,400 检测到 400ms 的 2300Hz 单音 5. 请参考 AT+QTDMOD。 Q en 13.18. AT+QWDTMF 通话中播放 DTMF 音 fid 语法 n AT+QWDTMF 通话中播放 DTMF 音 测试命令 响应 Co AT+QWDTMF=? +QWDTMF: (取值列表), (取值列 表), (',,'), (取值列表), (取值列表) 配置命令 AT+QWDTMF=, ,(',,')[,][ ,] OK 响应 执行成功： +QWDTMF: 5 OK 执行失败： 上海移远通信技术有限公司 208 / 256 M26 AT 命令手册 最大响应时间 参考 Quectel +QWDTMF: OK +CME ERROR: 取决于要播放的 DTMF 音的长度 参数 CQouneficdteenl tial 控制对方听到的音量 0 静音，7 最大音量值 本地Speack输出音量 0 静音，7 最大音量值，推荐设置为0 播放的TONE串 '0' DTMF 0 '1' DTMF 1 '2' DTMF 2 '3' DTMF 3 '4' DTMF 4 '5' DTMF 5 '6' DTMF 6 '7' DTMF 7 '8' DTMF 8 '9' DTMF 9 'A' DTMF A 'B' DTMF B 'C' DTMF C 'D' DTMF D '*' DTMF * '#' DTMF # 'E' 1400Hz频率 'F' 2300Hz频率 'G' 1KHz频率 播放每个TONE时间长度，单位ms 播放TONE串时每个TONE间隔静音时间长度，单位ms 播放成功或失败提示 值为5表示播放成功，其它表示失败 播放通道，仅非通话时起作用。通话时与语音同一个通道, 即由 AT+QAUDCH 控 制。此参数缺省时，播放通道也是由 AT+QAUDCH 控制。 0 主通道（默认） 1 耳机通道 上海移远通信技术有限公司 209 / 256 M26 AT 命令手册 2 主免提通道 DTMF 音合成算法。缺省为 0。 0 算法 1 1 算法 2 备注 1. AT+QWDTMF=7,0, '0A5,50,50,1,55,50,23,100,50' 发送 DTMF „0‟ 音 50ms，静音 50ms；发送 DTMF „A‟ 音 50ms，静音 50ms；发送 DTMF „5‟ 音 50ms， 静音 50ms；发送 DTMF „1‟ 音 55ms，静音 50ms；发送 DTMF „2‟ 音 100ms，静音 50ms；发送 DTMF „3‟ 音 100ms，静音 50ms； 2. 非通话中有效。 CQouneficdteenl tial 上海移远通信技术有限公司 210 / 256 M26 AT 命令手册 14 硬件相关命令 14.1. AT+CCLK 实时时钟 语法 AT+CCLK 实时时钟 测试命令 AT+CCLK=? l 查询命令 te AT+CCLK? c l 配置命令 ue tia AT+CCLK= Q n 最大响应时间 e 参考 GSM 07.07 响应 OK 响应 +CCLK: OK 响应 OK ERROR +CME ERROR: 300ms fid 参数 Con 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年，月，日，小时，分钟，秒和时 区（用当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围 -47~+48） 举例 AT+CCLK? //查询当前 ME 时间 +CCLK: '08/01/04, 00:19:43+00' OK 上海移远通信技术有限公司 211 / 256 M26 AT 命令手册 14.2. AT+QALARM 闹铃设置 语法 AT+QALARM 闹铃设置 测试命令 AT+QALARM=? 响应 +QALARM: ( 取 值 列 表 ),,( 取 值 列 表),(取值列表) OK 配置命令 响应 AT+QALARM= OK ,,, 最大响应时间 l 参考 te Quectel ERROR +CME ERROR: 300ms c l 参数 ue tia Q n e Confid 整数型；闹铃状态指示 0 删除闹铃 1 设置闹铃 字符串类型；格式：yy/MM/dd,hh:mm:ss±zz，各指年、月、日、小时、分钟、秒和时区（用 当地时间和 GMT 时间之间的差别来表示，以四分之一小时格式来表示；范围-47~+48） 整数型；指示闹铃重复模式 0 一次性闹铃 1 日重复闹铃 2 周重复闹铃 3 月重复闹铃 整数型；指示闹铃时间到，ME 开关机操作 0 无任何操作，只上报'ALARM RING' 提示 1 关机闹铃，上报'ALARM RING'提示且 5S 后关机 2 开机闹铃，上报'ALARM MODE'提示，模块开机并进入闹铃模式 备注 闹铃模式下，协议栈和 SIM 卡协议关闭。只支持一些 AT 命令。若未按电源开关或未切换至全功能模式 （AT+CFUN=1），ME 将在 90S 内关机。如果按下电源开关，ME 将会进入关机状态。 上海移远通信技术有限公司 212 / 256 M26 AT 命令手册 14.3. AT+CBC 查询电池电量和充电状态 语法 AT+CBC 查询电池电量和充电状态 测试命令 AT+CBC=? 响应 +CBC: (取值列表),(取值列表),(voltage) 执行命令 AT+CBC OK 响应 +CBC: , , l 最大响应时间 参考 te GSM 07.07 OK +CME ERROR: 300ms uec tial 参数 Q en fid 充电状态 0 未充电 1 充电中 2 充电完毕 电池电量级别 0...100 电池相对于其原始电量的百分比 电池电压（单位：mV） n 备注 Co 由于 M26 不支持充电功能，和不适用； 仍然有效反映 VBATT 的电压值。 上海移远通信技术有限公司 213 / 256 M26 AT 命令手册 14.4. AT+QADC 读取 ADC 语法 AT+QADC 读取 ADC 测试命令 AT+QADC=? 响应 +QADC: (取值列表),(取值列表) 查询命令 AT+QADC? OK 响应 +QADC: , l 最大响应时间 参考 te Quectel uec tial 参数 Q n 0 失败 1 成功 范围是 0~2800 OK +CME ERROR: 2s fide 14.5. AT+QSCLK 慢时钟配置 n 语法 o AT+QSCLK 慢时钟配置 C 测试命令 响应 AT+QSCLK=? +QSCLK: (取值列表) 查询命令 AT+QSCLK? OK 响应 +QSCLK: 配置命令 AT+QSCLK= OK 响应 OK 上海移远通信技术有限公司 214 / 256 M26 AT 命令手册 最大响应时间 参考 Quectel ERROR +CME ERROR: 300ms 参数 0 禁用慢时钟 1 启用慢时钟，拉高 DTR 生效，拉低 DTR 唤醒 2 启用慢时钟，5 秒内串口无数据交互即进入睡眠模式；有数据时唤醒 备注 模式 2 下，第一次串口数据会被丢弃，仅仅起唤醒作用。建议此模式下先发一个 AT 来唤醒模块再继续其 l 他业务。 cte l 14.6. AT+QLEDMODE 网络指示灯配置 ue tia 语法 Q n AT+QLEDMODE 网络指示灯配置 e 测试命令 AT+QLEDMODE=? 响应 +QLEDMODE: (取值列表) fid 查询命令 n AT+QLEDMODE? OK 响应 +QLEDMODE: Co 配置命令 OK 响应 AT+QLEDMODE= OK ERROR +CME ERROR: 最大响应时间 300ms 参考 Quectel 上海移远通信技术有限公司 215 / 256 M26 AT 命令手册 参数 0 1 2 来电振铃时网络指示灯快速闪烁 来电振铃对网络指示灯无影响 来电振铃对网络指示灯无影响，但此时有 URC 上报，串口 RI 引脚不会变化，直到振 铃结束 14.7. AT+QVBATT 配置电压阈值 语法 AT+QVBATT 配置电压阈值 测试命令 tel AT+QVBATT=? 响应 +QVBATT: 0,(3451-3600),(0,1) +QVBATT: 1,(3100-3450),(0,1) +QVBATT: 2,(4300-4550),(0,1) +QVBATT: 3,(4551-4730),(0,1) uec tial 查询命令 Q n AT+QVBATT? OK 响应 +QVBATT: 0,, +QVBATT: 1,, +QVBATT: 2,, +QVBATT: 3,, fide 配置命令 AT+QVBATT=[,[,]] OK 响应 OK 如果参数有效并且省略，则该 命令会查询当前参数值，响应结果如下： +QVBATT: ,, 最大响应时间 OK 或 +CME ERROR: 300ms 参考 Quectel 上海移远通信技术有限公司 216 / 256 M26 AT 命令手册 参数 配置电压阈值的类型 0 低压报警 1 低压关机 2 高压报警 3 高压关机 电压阈值，单位 mV 参数对应的功能类型启用或关闭状态，默认开启了低压报警和低 压关机功能，默认关闭了高压报警和高压关机功能。 0 关闭 1 开启 备注 1. 若电池电压达到设定的阈值，则对应上报如下 URC： l UNDER_VOLTAGE WARNING UNDER_VOLTAGE POWER DOWN te OVER_VOLTAGE WARNING c l OVER_VOLTAGE POWER DOWN 2. 该命令可以通过 AT&W 保存。 ue tia 举例 Q n AT+QVBATT=? +QVBATT: 0,(3451-3600),(0,1) e +QVBATT: 1,(3100-3450),(0,1) fid +QVBATT: 2,(4300-4550),(0,1) +QVBATT: 3,(4551-4730),(0,1) n OK AT+QVBATT? o +QVBATT: 0,3500,1 C +QVBATT: 1,3100,1 //测试命令 //查询命令 +QVBATT: 2,4500,0 +QVBATT: 3,4600,0 OK AT+QVBATT=0,3490 OK AT+QVBATT=0 +QVBATT: 0,3490,1 //设置低压报警阈值为 3490mV //查询低压报警阈值和状态 //1 代表已开启低压报警功能 OK 上海移远通信技术有限公司 217 / 256 AT+QVBATT=1,3300,0 OK AT+QVBATT=1 +QVBATT: 1,3300,0 OK //关闭低压关机功能 //查询低压关机阈值和状态 M26 AT 命令手册 CQouneficdteenl tial 上海移远通信技术有限公司 218 / 256 M26 AT 命令手册 15 其他命令 15.1. A/ 重复上一条 AT 指令 语法 A/ 重复上一条 AT 指令 执行命令 A/ l 最大响应时间 te 参考 V.25ter 响应 上一条 AT 指令执行的返回 取决于上一个 AT 命令 uec tial 举例 AT Q n OK A/ e OK //重复上一次执行的 AT 操作 fid 15.2. ATE 命令回显模式 Con 使用该命令，可设置 TA 在命令状态下是否回显从 TE 接收到的字符。 语法 ATE 命令回显模式 执行命令 响应 ATE[] OK 最大响应时间 参考 V.25ter 300ms 上海移远通信技术有限公司 219 / 256 参数 0 关闭回显 1 启用回显 M26 AT 命令手册 15.3. ATS3 配置命令行终止符 使用该命令，可设置用于 AT 命令行终止符，该字符能被 TA 识别。 语法 ATS3 配置命令行终止符 查询命令 ATS3? tel 配置命令 ATS3= c l 最大响应时间 ue tia 参考 V.25ter 响应 OK 响应 OK 300ms Q en 参数 fid 0-13-127 命令行终止符（默认为 13=） Con 15.4. ATS4 设置响应格式字符 使用该命令，可设置用于获取结果码和信息文本的字符，该字符是由 TA 产生的。 语法 ATS4 设置响应格式字符 查询命令 响应 ATS4? OK 上海移远通信技术有限公司 220 / 256 M26 AT 命令手册 配置命令 ATS4= 最大响应时间 参考 V.25ter 响应 OK 300ms 参数 0-10-127 响应格式字符（默认为 10=） 15.5. ATS5 配置命令行编辑字符 l 使用该命令，可设置用于删除命令行中的字符，该字符由 TA 产生。 te 语法 c l ATS5 配置命令行编辑字符 ue tia 查询命令 响应 ATS5? Q n 配置命令 e ATS5= fid 最大响应时间 参考 V.25ter OK 响应 OK 300ms Con 参数 0-8-127 命令行编辑字符（默认为 8=） 上海移远通信技术有限公司 221 / 256 M26 AT 命令手册 15.6. AT+QRIMODE 设置 RI 时长 语法 AT+QRIMODE 设置 RI 时长 查询命令 AT+QRIMODE=? 响应 +QRIMODE: (取值列表) 查询命令 AT+QRIMODE? OK 响应 +QRIMODE: 配置命令 AT+QRIMODE= tel 最大响应时间 c l 参考 Quectel OK 响应 OK ERROR +CME ERROR: 300ms ue tia 参数 Q en 0 收到短消息时 RI 拉低 120ms，收到其他 URC 提示时 RI 拉低 120ms 1 收到短消息时 RI 拉低 120ms，收到其他 URC 提示时 RI 拉低 50ms 2 接收到新短信时，RI 拉低 120ms，其他 URC 对 RI 引脚无影响 nfid 15.7. AT+QCFG='RFTXburst' RF 突发信号指示 Co 语法 AT+QCFG='RFTXburst' RF 突发信号指示 查询命令 响应 AT+QCFG='RFTXburst' +QCFG: 'RFTXburst', 配置命令 AT+QCFG='RFTXburst', OK 响应 OK ERROR +CME ERROR: 上海移远通信技术有限公司 222 / 256 M26 AT 命令手册 最大响应时间 参考 Quectel 300ms 参数 突发指示信号的工作模式 0 关闭 TX 突发指示，该引脚作为 GPIO 功能输出低电平 1 开启 TX 突发指示，输出波形参考备注 2 2 开启 TX 突发指示，通话中该引脚将变为高电平，通话结束后该引脚变为低电平 备注 1. 该命令可使用 AT&W 保存； 2. =1 时的输出波形，如下： tel 220us 577us 4.615ms 220us 577us uec tial RFTXMON CQonfiden Transmit burst 上海移远通信技术有限公司 223 / 256 M26 AT 命令手册 16 附录 16.1. 参考文档 表 1：参考文档 序号 [1] l [2] te [3] c l [4] ue tia [5] [6] 文档名 GSM 模块 AT 命令应用指导 GSM_TCPIP_Application_Notes GPRS_Startup_User_Guide GSM_MUX_Application_Notes SMS_Application_Notes Quectel_M26_硬件设计手册 备注 GSM 模块 AT 命令应用指导 TCPIP 应用指导 GPRS 配置应用指导 MUX 应用指导 短消息应用指导 M26 硬件设计手册 Q fiden 16.2.术语缩写 n 表 2：术语缩写 o 缩写 C ADC 描述 Analog-to-Digital Converter AMR Adaptive Multi-Rate ARP Antenna Reference Point ME Mobile Equipment TA Terminal Adapter MS Mobile Station 上海移远通信技术有限公司 224 / 256 M26 AT 命令手册 DCE Data Communication Equipment TE Terminal Equipment DTE Data Terminal Equipment RTS/CTS Request To Send/Clear To Send GPRS General Packet Radio Service DCD Dynamic Content Delivery DTR Data Terminal Ready CSD PSC l PDP te TCP c l UDP Circuit Switch Data Primary Synchronization Code Packet Data Protocol Transmission Control Protocol User Datagram Protocol ue tia 16.3. AT&F 影响到的 AT 命令及参数 Q en 表 3：AT&F 影响到的 AT 命令及参数 fid AT命令 ATE n ATQ Co ATS0 参数名称 默认值 1 0 0 ATS3 13 ATS4 10 ATS5 8 ATS6 2 ATS7 60 上海移远通信技术有限公司 225 / 256 M26 AT 命令手册 ATS8 ATS10 ATV ATX AT&C AT&D AT+ILRR AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR AT+CMEE AT+COLP AT+CR AT+QDISH AT+CRLP AT+CRSL AT+CLVL AT+CUSD AT+CSSN 2 15 1 4 1 0 0 0 ,, 0,0,0 0 tel 'GSM' 129 uec tial 0 0 Q n 1 e 0 fid 0 0 n ,,,,, 61,61,128,6,0,3 Co 55 当 AT+QAUDCH=0 时，默认值为： 60 当 AT+QAUDCH=1 时，默认值为： 40 当 AT+QAUDCH=2 时，默认值为： 35 0 , 0,0 上海移远通信技术有限公司 226 / 256 M26 AT 命令手册 AT+CSNS 0 AT+CMOD 0 AT+CMGF 0 AT+CNMI ,,,, 2,1,0,0,0 AT+CSDH 0 AT+CSMS 0 当 AT+QAUDCH=0 时，默认值为： 80 AT+QSIDET AT+QMIC tel AT+QSCLK c l AT+QCLIP ue tia AT+QCOLP AT+QIURC Q n AT+QEXTUNSOL e AT+QRIMODE fid AT+QSIMDET AT+QSIMSTAT ,, 当 AT+QAUDCH=1 时，默认值为： 144 4,9,8 0 0 0 1 0 0 ,, 0,0,0 0 Con 16.4. AT&W 影响到的 AT 命令及参数 表 4：AT&W 影响到的 AT 命令参数列表 AT 指令 ATE ATQ 参数名称 是否通过 AT&V 显示 是 是 上海移远通信技术有限公司 227 / 256 M26 AT 命令手册 ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT&C AT&D AT+ICF AT+IFC AT+ILRR AT+IPR AT+QMUXC AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR AT+CMEE AT+COLP 是 是 是 是 是 是 是 是 是 否 tel 是 是 uec tial , 是 , 是 Q n 是 e 是 fid 否 是 n ,, 是 Co 是 是 是 是 是 是 是 上海移远通信技术有限公司 228 / 256 M26 AT 命令手册 AT+CR 是 AT+QDISH 否 AT+CRLP ,,,,, 是 AT+CRSL 否 AT+CLVL 否 AT+CUSD 是 AT+CSNS 是 AT+CMGF AT+CNMI AT+CSDH tel AT+QSIDET c l AT+QMIC ue tia AT+QSCLK AT+QCLIP Q en AT+QCOLP fid AT+QIURC AT+QEXTUNSOL n AT+QRIMODE o AT+QSIMDET C AT+QSIMSTAT 是 ,,,, 是 是 是 ,, 否 是 是 否 否 否 ,, 是 是 上海移远通信技术有限公司 229 / 256 M26 AT 命令手册 16.5. ATZ 影响到的 AT 命令及参数 表 5：ATZ 影响到的 AT 命令参数列表 AT 指令 ATE ATQ ATS0 ATS3 ATS4 ATS5 ATS6 ATS7 ATS8 ATS10 ATV ATX AT&C AT&D AT+ILRR AT+CREG AT+CCUG AT+CCWA AT+CSCS AT+CSTA AT+CLIP AT+CLIR 参数名称 默认值 1 0 0 13 10 8 l 2 te 60 c l 2 ue tia 15 Q n 1 e 4 fid 1 0 n 0 Co 0 ,, 0,0,0 0 'GSM' 129 0 0 上海移远通信技术有限公司 230 / 256 M26 AT 命令手册 AT+CMEE 1 AT+COLP 0 AT+CR 0 AT+QDISH 0 AT+CRLP ,,,,, 61,61,128,6,0,3 AT+CRSL AT+CLVL AT+CUSD AT+CSSN AT+CSNS AT+CMOD AT+CMGF AT+CNMI AT+CSDH AT+CSMS AT+QSIDET AT+QMIC AT+QSCLK AT+QCLIP 55 当 AT+QAUDCH=0 时，默认值为：60 当 AT+QAUDCH=1 时，默认值为：40 当 AT+QAUDCH=2 时，默认值为：35 0 , 0,0 l 0 te 0 c l 0 ue tia ,,,, 2,1,0,0,0 0 Q en 0 fid ,, 当 AT+QAUDCH=0 时，默认值为：80 当 AT+QAUDCH=1 时，默认值为：144 4,9,8 o 0 C 0 AT+QCOLP 0 AT+QIURC 1 AT+QEXTUNSOL 0 AT+QRIMODE 0 AT+QSIMDET ,, 0,0,0 上海移远通信技术有限公司 231 / 256 AT+QSIMSTAT M26 AT 命令手册 0 16.6. AT&V 影响到的 AT 命令及参数 表 6：AT&V 显示当前配置信息 AT&V or AT&V0 AT&V ACTIVE PROFILE E: 1 Q: 0 V: 1 l X: 4 te S0: 0 S2: 43 c l S3:13 S4: 10 ue tia S5:8 S6: 2 S7: 60 Q n S8:2 S10: 15 e +CR: 0 fid +FCLASS: 0 +CMGF: 0 +CSDH: 0 n +ILRR: 0 +CMEE: 1 o +CBST: 7,0,1 C +IFC: 0,0 +ICF: 3,3 +CNMI: 2,1,0,0,0 +CSCS: 'GSM' +IPR: 0 &C: 1 &D: 0 +CSTA: 129 +CRLP: 61,61,128,6,0,3 +CCWE: 0 +QSIMSTAT: 0 上海移远通信技术有限公司 232 / 256 M26 AT 命令手册 +CMUX: -1 +CCUG: 0,0,0 +CLIP: 0 +COLP: 0 +CCWA: 0 +CAOC: 1 +CLIR: 0 +CUSD: 0 +CREG: 0 +QSIMDET: 0,0,0 +QMIC: 4,9,8 +QECHO(NORMAL_AUDIO): 253,96,16388,57351,0 +QECHO(Earphone_AUDIO): 253,0,10756,57351,1 +QECHO(LoudSpk_AUDIO): 224,96,5256,57351,2 +QSIDET(NORMAL_AUDIO): 80 +QSIDET(HEADSET_AUDIO): 144 l +QCLIP: 0 +QCOLP: 0 te +CSNS: 0 OK uec tial 16.7. ATV影响到的 AT 命令及参数 Q n 表 7：ATV 内容格式对照表 fide ATV1 OK n CONNECT o RING C NO CARRIER ATV0 0 1 2 3 描述 执行命令的正确确认 连接已经建立，DCE 从命令状态切换为数据状态 DCE 已经检测到一个来自网络的呼叫 连接中断或尝试建立连接失败 ERROR 4 命令不能被识别，超出命令行的最大长度，参数值无效 或命令进程中的其他问题 NO DIALTONE 6 无法检测到拨号音 BUSY 7 NO ANSWER 8 检测到忙音信号（占线） 若'@'拨号修改量被使用，则紧跟 5 秒静默时间的远程振 铃没有在定时器（S7）超时前检测到，即无应答。 上海移远通信技术有限公司 233 / 256 PROCEEDING CONNECT M26 AT 命令手册 9 制造商特殊需求 一条 AT 命令正在被处理 与 CONNECT 相同，但包含制造商特殊需求定义的文本， 该文本可以是指定的 DTE 速率，行速度，错误控制，数 据压缩或其他状态 16.8. +CME ERROR 错误代码列表 表 8：+CME ERROR 错误代码列表 非请求结果码+CME ERROR: 表示移动设备或网络报错，类似于 ERROR 错误结果码。一旦命 令被执行，不管正确与否，都要返回 OK 或者 ERROR 结果。 含义 l 0 Phone failure te 1 No connection to phone c l 2 Phone-adaptor link reserved ue tia 3 Operation not allowed 4 Operation not supported Q n 5 PH-SIM PIN required e 6 PH-FSIM PIN required fid 7 PH-FSIM PUK required n 10 SIM not inserted o 11 SIM PIN required C 12 SIM PUK required 13 SIM failure 14 SIM busy 15 SIM wrong 16 Incorrect password 17 SIM PIN2 required 上海移远通信技术有限公司 234 / 256 M26 AT 命令手册 18 SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 27 30 31 32 40 41 42 43 44 45 46 47 Dial string too long Invalid characters in dial string l No network service te Network timeout c l Network not allowed - emergency calls only ue tia Network personalization PIN required Network personalization PUK required Q n Network subset personalization PIN required e Network subset personalization PUK required fid Service provider personalization PIN required Service provider personalization PUK required nCorporate personalization PIN required CoCorporate personalization PUK required 103 Illegal MS 106 Illegal ME 107 GPRS services not allowed 111 PLMN not allowed 112 Location area not allowed 上海移远通信技术有限公司 235 / 256 M26 AT 命令手册 113 Roaming not allowed in this location area 132 Service option not supported 133 Requested service option not subscribed 134 Service option temporarily out of order 148 Unspecified GPRS error 149 PDP authentication failure 150 Invalid mobile class 151 152 153 154 302 601 602 603 604 605 606 607 608 Link NS SP person PIN required Link NS SP person PUK required l Link SIM C person PIN required te Link SIM C person PUK required c l Command conflict ue tia Unrecognized command Return error Q n Syntax error e Unspecified fid Data transfer already Action already nNot AT command CoMulti command too long 609 Abort COPS 610 No call disconnect 3513 Unread records on SIM 3515 PS busy 3516 Couldn't read SMS parameters from SIM 上海移远通信技术有限公司 236 / 256 M26 AT 命令手册 3517 SM not ready 3518 Invalid parameter 3738 CSCS mode not found 3742 CPOL operation format wrong 3765 Invalid input value 3769 Unable to get control 3771 Call setup in progress 3772 3773 l 3774 te 3775 SIM powered down Invalid CFUN state Invalid ARFCN The pin is not in GPIO mode uec tial 16.9. +CMS ERROR 错误代码列表 Q n 表 9：+CMS ERROR 错误代码列表 e 非请求结果码+CMS ERROR: 表示移动设备或网络报错，类似于 ERROR 错误结果码。一旦命 fid 令被执行，不管正确与否，都要返回 OK 或者 ERROR 结果。 n 300 Co 301 含义 ME failure SMS ME reserved 302 Operation not allowed 303 Operation not supported 304 Invalid PDU mode 305 Invalid text mode 310 SIM not inserted 上海移远通信技术有限公司 237 / 256 M26 AT 命令手册 311 SIM pin necessary 312 PH SIM pin necessary 313 SIM failure 314 SIM busy 315 SIM wrong 316 SIM PUK required 317 SIM PIN2 required 318 320 321 322 330 331 332 500 512 513 514 515 517 SIM PUK2 required Memory failure l Invalid memory index te Memory full c l SMSC address unknown ue tia Nonetwork Network timeout Q n Unknown e SIM not ready fid Message length exceeds Invalid request parameters nME storage failure CoInvalid service mode 528 More message to send state error 529 MO SMS is not allow 530 GPRS is suspended 531 ME storage full 3513 Unread records on SIM 上海移远通信技术有限公司 238 / 256 M26 AT 命令手册 3515 PS busy 3516 Couldn't read SMS parameters from SIM 3517 SM not ready 3518 Invalid parameter 3742 Incorrect format 3765 Invalid input value 3769 Unable to get control of required module 3771 3772 l 3773 te 3774 c l 3775 Call setup in progress SIM powered down Unable to operate in this cfun state Invalid arfcn in this band The pin is not in GPIO mode ue tia 16.10.扩展错误报告列表 Q en 16.10.1. Location ID 扩展错误报告列表 fid 表 10：Location ID 扩展错误报告列表 ID 描述 on 0 No error (default) C 1 Cause for protocol stack (PS) layer 2 Internal cause for Mobility Management (MM) layer 3 Cause for PPP/IP-Stack 上海移远通信技术有限公司 239 / 256 M26 AT 命令手册 16.10.2. 协议栈层（PS）错误列表 表 11：协议栈层（PS）错误列表 原因 CM Cause 0 1 3 6 8 10 11 16 17 18 19 21 22 25 26 27 28 29 30 31 描述 Radio link fail Unassigned number No route to destination Channel unacceptable Operator determined barring l Call barred te Reserved c l Normal call clearing ue tia Userbusy Q n No user responding e User alerting, no answer fid Call rejected Number changed nPre-emption CoNon-selected user clearing Destination out of order Invalid number format (incomplete number) Facility rejected Response to STATUS ENQUIRY Normal, unspecified 上海移远通信技术有限公司 240 / 256 M26 AT 命令手册 34 No circuit/channel available 38 Network out of order 41 Temporary failure 42 Switching equipment congestion 43 Access information discarded 44 Requested circuit/channel not available 47 Resource unavailable, unspecified 49 50 55 57 58 63 65 68 69 70 79 81 87 Quality of service unavailable Requested facility not subscribed l Incoming calls barred within the CUG te Bearer capability not authorized c l Bearer capability not presently available ue tia Service or option not available, unspecified Bearer service not implemented Q n ACM equal or greater than ACM maximum e Requested facility not implemented fid Only restricted digital information bearer capability is available Service or option not implemented, unspecified nInvalid transaction identifier value CoUser not member of CUG 88 Incompatible destination 91 Invalid transit network selection 95 Semantically incorrect message 96 Invalid mandatory information 97 Message type non-existent or not implemented 上海移远通信技术有限公司 241 / 256 M26 AT 命令手册 98 Message type not compatible with protocol state 99 Information element non-existent or not implemented 100 Conditional information element error 101 Message not compatible with protocol 102 Recovery on timer expiry 111 Protocol error, unspecified 127 Interworking, unspecified 128 129 130 143 144 145 159 160 161 175 176 192 193 Telematic interworking not supported Short message Type 0 not supported l Cannot replace short message te Unspecified TP-PID error c l Data coding scheme (alphabet) not supported ue tia Message class not supported Unspecified TP-DCS error Q n Command cannot be acted e Command unsupported fid Unspecified TP-Command error TPDU not supported nSC busy CoNo SC subscription 194 SC system failure 195 Invalid SME address 196 Destination SME barred 197 SM Rejected-Duplicate SM 198 TP-VPF not supported 上海移远通信技术有限公司 242 / 256 M26 AT 命令手册 199 TP-VP not supported 208 SIM SMS storage full 209 No SMS storage capability in SIM 210 Error in MS 211 Memory Capacity Exceeded 212 SIM Application Toolkit Busy 213 SIM data download error 224 225 226 255 304 305 313 320 321 322 330 340 500 CP retry exceed RP trim timeout l SMS connection broken te Unspecified error cause c l Invalid PDU mode parameter ue tia Invalid TEXT mode parameter SIM failure Q n Memory failure e Invalid memory index fid Memory full SMSC address unknown nNo+CNMA acknowledgement expected CoUnknown error 512 SMS no error 513 Message length exceeds maximum length 514 Invalid request parameters 515 ME storage failure 516 Invalid bearer service 上海移远通信技术有限公司 243 / 256 M26 AT 命令手册 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 CC Cause 768 769 770 771 772 773 774 775 Invalid service mode Invalid storage type Invalid message format Too many MO concatenated messages SMSAL not ready SMSAL no more service Not support TP-Status-Report&TP-Command in storage Reserved MTI No free entity in RL layer l The port number is already registered te There is no free entity for port number c l More Message to Send state error ue tia MOSMSisnotallow GPRS is suspended Q n ME storage full e Doing SIM refresh fid Command not allowed nIllegal card ID CoCall allocation fail BC fill fail Call RE EST Illegal DTMF tone Illegal BC Modify actual mode 上海移远通信技术有限公司 244 / 256 M26 AT 命令手册 776 777 778 896 897 898 SS Cause 1024 1025 1033 1034 1035 1036 1037 1040 1041 1042 1043 1044 1045 1051 1053 1054 1058 1059 Data action fail No response from network Call accept not allowed General cause CSD call is aborted by user during call establishment or MT call abort MO call/USSD CSD call is disconnected due to lower layer failure Cause none Unknown subscriber l Illegal subscriber te Bearer service not provisioned c l Tele service not provisioned ue tia Illegalequipment Call barred Q n Illegal SS operation e SS error status fid SS not available nSS subscription violation oSS incompatibility C Facility not supported Absent subscriber Short term denial Long term denial System failure Data missing 上海移远通信技术有限公司 245 / 256 M26 AT 命令手册 1060 Unexpected data value 1061 PW registration failure 1062 Negative PW check 1067 Number of PW attempts violation 1078 Position method failure 1095 Unknown alphabet 1096 USSD busy 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 Rejected by user Rejected by network l Deflection to served subscriber te Special service code c l Invalid deflection to number ue tia Max number of MPTY participants exceeded Resources not available Q n General problem, unrecognized component e General problem, mistyped component fid General problem, badly structured component Invoke problem, duplicate invoked nInvoke problem, unrecognized operation CoInvoke problem, mistyped parameter 1158 Invoke problem, resource limitation 1159 Invoke problem, initiating release 1160 Invoke problem, unrecognized linked ID 1161 Invoke problem, linked resource unexpected 1162 Invoke problem, unexpected linked operation 上海移远通信技术有限公司 246 / 256 M26 AT 命令手册 1163 1164 1165 1166 1167 1168 1169 1170 MM Cause 2048 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 Return result problem, RR unrecognized invoked Return result problem, RR, return result unexpected Return result problem, RR mistyped parameter Return error problem, RE, unrecognized invoked Return error problem, RE return error unexpected Return error problem, RE unrecognized error Return error problem, RE unexpected error Return error problem, RE mistyped parameter l Cause none te IMSI unknown in HLR c l Illegal MS ue tia IMSIunknowninVLR IMEI not accepted Q n Illegal ME e GPRS not allowed fid None GPRS not allowed MS ID not derived by network nImplicit detach CoPLMN not allowed Location area not allowed Roaming area not allowed GPRS not allowed in PLMN No suitable cells in LA MSC temp not reachable 上海移远通信技术有限公司 247 / 256 M26 AT 命令手册 2065 Network failure 2068 MAC failure 2069 Sync failure 2070 Congestion 2080 Serve option not supported 2081 Request serve option not subscribed 2082 Serve option temp out of order 2086 2088 2096 2111 2143 2144 2145 2146 2147 2148 2149 2159 2160 Call cannot be identified No PDP context activated l Retry upon entry into a new cell te Retry upon entry into a new cell c l Semantically incorrect message ue tia InvalidMMinfo Message type non existent Q n Message type incompatible with protocol state e IE not implemented fid Conditional MM IE error Message not compatible with protocol state nProtocol error unspecified CoAccess barred 2161 Assignment reject 2162 Random access failure 2163 RR no service 2164 PLMN search reject emergency 2165 RR connection release 上海移远通信技术有限公司 248 / 256 M26 AT 命令手册 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 SIM Cause 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 SM Cause Authentication failure IMSI detach Abort by network Connection timeout Enqueue fail Not updated State not allowed Emergency not allowed No service l Access class barred cte l Command success ue tia Commandfail Fatal error Q n No inserted e CHV not init fid CHV verify error CHV block nAccess not allow CoSAT command busy DL error Memory problem Technical problem PUK unlock 上海移远通信技术有限公司 249 / 256 M26 AT 命令手册 3080 Operator determined barring 3097 LLC SND failure 3098 Insufficient resource 3099 Unknown APN 3100 Unknown PDP address or type 3101 Authentication failure 3102 Activation reject GGSN 3103 3104 3105 3106 3108 3109 3110 3111 3112 3113 3114 3115 3116 Activation reject Unsupported service option l Unsubscribed service option te Out of order service option c l Regular deactivation ue tia QOSnotaccepted Network fail Q n Reactivation required e Unsupported network context activation fid Semantic error in TFT operation Syntactical error in TFT operation nUnknown PDP context CoSemantic error in packet filter 3117 Syntax error in packet filter 3118 PDP context WO TFT already act 3153 Invalid TI 3167 Incorrect message 3168 Invalid MAND info 上海移远通信技术有限公司 250 / 256 M26 AT 命令手册 3169 Unimplemented message type 3170 Incompatible message type protocol state 3171 Unimplemented IE 3172 Conditional IE error 3173 Incompatible message protocol state 3183 Unspecified 3184 ABM Cause 3273 3274 3275 3276 3277 3278 3279 3280 3283 3284 3285 3286 TCM Cause Startup failure Success l Invalid network account ID te GPRS reactivate c l GPRS protocol rejection ue tia CSDreactivate CSD PPP negotiated failed Q n CSD action failed e CSD call setup failed fid Rejected Slot limited nAbort CoNone auto deactivation 3372 Invalid parameter 3373 NSAPI not in use 3374 ACL action not allowed 3375 ACL SIM file full 上海移远通信技术有限公司 251 / 256 M26 AT 命令手册 3376 3377 3378 3379 3380 ACL add entry failed ACL del entry failed ACL set entry failed ACL SIM read failed ACL SIM write failed 16.10.3. MM 层内部错误列表 表 12：MM 层内部错误列表 原因 l 112 te 113 c l 114 ue tia 115 116 Q n 117 fide 118 119 n 120 Co 121 描述 Forbidden PLMN Access class barred No coverage GPRS service not allowed Timer expiry SIM inserted SIM removed SIM absent SIM invalid for PS SIM invalid for CS 122 SIM invalid for PS and CS 123 Low layer fail 124 Connection in progress 125 Not updated 126 Connection establish failure 127 Connection abort 上海移远通信技术有限公司 252 / 256 M26 AT 命令手册 128 Connection failure 129 Emergency not allowed 130 No GPRS coverage 131 Abnormal LU 132 Abnormal LU less then 4 times 133 Same LAI IMSI attaching 16.10.4. PPP/IP 栈错误列表 表 13：PPP/IP 栈错误列表 l 原因 te 0 c l 1 ue tia 2 3 Q n 4 fide 5 6 n 7 Co 8 描述 No error LCP fail Authentication fail IPCP fail ESC detect Plug out detect PPP GPRS dialup already activated PPP not activated by external modem yet PPP already activated by external modem 9 PPP not activated by WAP over CSD yet 10 PPP already activated by WAP over CSD 11 PPP wrong CSD mode ID 12 PPP detect AT command during dialup 13 PPP detect escape during dialup 上海移远通信技术有限公司 253 / 256 M26 AT 命令手册 16.11. URCs 说明列表 表 14：URCs 说明列表 序号 URC 显示 含义 条件 1 +CMTI:, 新短消息到达并存储在存储器内 AT+CNMI=2,1 +CMT:[], 模式） AT+CNMI=2,2 +CMT:,[],[,,,,,,,] AT+CNMI=2,2 +CBM: 新小区广播消息到达并直接输出至 TE（PDU 模式） AT+CNMI=2,2 +CBM:,,, 新小区广播消息到达并直接输出至 l ,,, TE（TEXT 模式） AT+CNMI=2,2 te 短消息状态报告并直接输出至 TE +CDS: （PDU 模式） AT+CNMI=2,2 c l +CDS:,,[],[],< 短消息状态报告并直接输出至 TE ue tia scts>,, （TEXT 模式） AT+CNMI=2,2 +CGEV:NW DEACT, 网络去 GPRS 附着 AT+CGEREP=1 Q n [,] +CGEV:ME e DEACT, ME 去 GPRS 附着 AT+CGEREP=1 [,] fid +CGEV:NW DETACH 网络去 GPRS 附着 AT+CGEREP=1 +CGEV:ME DETACH ME 去 GPRS 附着 AT+CGEREP=1 on +CGREG:1 网络去注册 AT+CGREG=1 C+CGREG:0 网络未注册 AT+CGREG=1 14 +CGREG:1, 网络注册及本地小区信息 AT+CGREG=2 15 +CGREG:0, 16 +QCGTIND 17 +CSQN:, 网络未注册及本地小区信息 AT+CGREG=2 A CS voice call, CS data, fax call or AT+QCGTIND=1 GPRS session termination indicator Signal quality change AT+QEXTUNSOL ='SQ',1 上海移远通信技术有限公司 254 / 256 M26 AT 命令手册 AT+QEXTUNSOL 18 Forbidden network is available only ='FN',1 +CMWT:,,, 19 Message waiting ,, AT+QEXTUNSOL ='MW',1 20 +QGURC: Unsolicited result code follows AT+QEXTUNSOL particular call state transition ='UR',1 21 +CBCN, Display battery connection status AT+QEXTUNSOL and battery charge level ='BC',1 22 +QBAND: Band mode display AT+QEXTUNSOL ='BM',1 23 +TSMSINFO: Additional SMS information AT+QEXTUNSOL ='SM',1 24 25 26 27 28 29 30 31 32 33 +CCINFO:, l RING te Call Ready c l UNDER_VOLTAGE POWER DOWN ue tia UNDER_VOLTAGEWARNING OVER_VOLTAGE POWER Q n DOWN e OVER_VOLTAGE WARNING Displays the disconnected call ID AT+QEXTUNSOL and the remain call numbers after ='CC',1 one of the call is disconnected Indicates incoming call N/A Device is ready to make/receive N/A calls Under voltage shutdown indication N/A Under voltage warning N/A Over voltage shutdown indication N/A Over voltage warning N/A fid NORMAL POWER DOWN Normal power down N/A +COLP:,[,,[CLI validity]], o +CLIP:,'',,, The presentation of the COL(connected line) at the TE for a AT+COLP=1 mobile originated call Mobile terminating call indication AT+CLIP=1 An incoming call is indicated to the 34 +CRING: TE with unsolicited result code AT+CRC=1 instead of the normal RING 35 +CREG: Indicate registration status of the ME AT+CREG=1 36 +CREG:[,,] After cell neighborhood changing shows whether the network has currently indicated the registration of the ME, with location area code AT+CREG=2 上海移远通信技术有限公司 255 / 256 M26 AT 命令手册 +CCWA:,,[,] 38 RDY ME initialization is successful AT+CCWA=1,1 N/A 39 +CFUN:1 All function of the ME is available N/A 40 +CPIN: SIM card pin state N/A 41 MO RING MO call ringing AT+QMOSTAT=1 42 MO CONNECTED MO call connected AT+QMOSTAT=1 AT+QALARM=1,,,0/1 AT+QALARM=1,,,2 上海移远通信技术有限公司 256 / 256

L26-DR EVB User Guide GNSS Module Series Rev. L26-DR_EVB_User_Guide_V1.2 Date: 2019-12-25 Status: Released www.quectel.com GNSS Module Series L26-DR EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. L26-DR_EVB_User_Guide 1 / 28 GNSS Module Series L26-DR EVB User Guide About the document History Revision Date 1.0 2019-07-04 1.1 2019-11-09 1.2 2019-12-25 Author Brooke WANG Brooke WANG Shua SHI/ Brooke WANG Description Initial 1. Updated Figure 2, 9 and 15; 2. Updated the description in Chapter 5.2; 3. Updated the calibration procedure in Chapter 7; 4. Updated accessory information in Table 2. 1. Updated the description about calibration result monitoring in Chapter 6.2.2; 2. Moved description about EVB and accessories assembly into Chapter 2. L26-DR_EVB_User_Guide 2 / 28 GNSS Module Series L26-DR EVB User Guide Contents About the document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index...................................................................................................................................................4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Safety Information ....................................................................................................................... 6 2 General Overview.................................................................................................................................7 2.1. Top and Side Views of L26-DR EVB........................................................................................... 7 2.2. L26-DR EVB and Accessories .................................................................................................... 8 2.3. EVB and Accessories Assembly ................................................................................................. 9 3 Interface Applications ....................................................................................................................... 10 3.1. Micro-USB Interface..................................................................................................................10 3.2. SD Card Interface ..................................................................................................................... 11 3.3. Antenna Interface...................................................................................................................... 11 3.4. Switches and Buttons ............................................................................................................... 12 3.5. Operation Status Indication LEDs............................................................................................. 13 3.6. OBD Interface ........................................................................................................................... 14 4 EVB Operation Procedures............................................................................................................... 15 4.1. Communication via Micro-USB Interface.................................................................................. 15 4.2. Download Firmware .................................................................................................................. 16 4.2.1. Firmware Upgrade ......................................................................................................... 16 4.2.2. Boot Download ............................................................................................................... 16 5 Usage of Teseo-Suite Pro ................................................................................................................. 18 5.1. View GNSS Receiver Status..................................................................................................... 18 5.1.1. COM Port and Baud Rate Setting.................................................................................. 18 5.1.2. Explanations of Views and Windows ............................................................................. 20 5.2. Send PSTM Commands ........................................................................................................... 21 6 Calibration Procedure ....................................................................................................................... 22 6.1. Calibration for L26-DR (ADR)/L26-DR (ADRA) EVB................................................................ 22 6.1.1. Determination Process of EVB Installation Angle.......................................................... 22 6.1.2. Main Calibration Procedure ........................................................................................... 23 6.1.3. Calibration Result Monitoring......................................................................................... 24 6.2. L26-DR (UDR) EVB .................................................................................................................. 25 6.2.1. Calibration Procedure .................................................................................................... 25 6.2.2. Calibration Result Monitoring......................................................................................... 26 7 Appendix A Reference.......................................................................................................................27 L26-DR_EVB_User_Guide 3 / 28 GNSS Module Series L26-DR EVB User Guide Table Index TABLE 1: INTERFACES OF L26-DR EVB .......................................................................................................... 7 TABLE 2: LIST OF ACCESSORIES .................................................................................................................... 8 TABLE 3: SWITCHES AND BUTTONS............................................................................................................. 12 TABLE 4: OPERATION STATUS INDICATION LEDS....................................................................................... 13 TABLE 5: PIN DESCRIPTION ........................................................................................................................... 14 TABLE 6: RELATED DOCUMENTS .................................................................................................................. 27 TABLE 7: TERMS AND ABBREVIATIONS ........................................................................................................ 27 L26-DR_EVB_User_Guide 4 / 28 GNSS Module Series L26-DR EVB User Guide Figure Index FIGURE 1: TOP AND SIDE VIEWS OF L26-DR EVB......................................................................................... 7 FIGURE 2: L26-DR EVB & ACCESSORIES ....................................................................................................... 8 FIGURE 3: L26-DR EVB AND ACCESSORIES ASSEMBLY .............................................................................. 9 FIGURE 4: MICRO-USB INTERFACE .............................................................................................................. 10 FIGURE 5: SD CARD INTERFACE....................................................................................................................11 FIGURE 6: ANTENNA INTERFACE ...................................................................................................................11 FIGURE 7: SWITCHES AND BUTTONS .......................................................................................................... 12 FIGURE 8: OPERATION STATUS INDICATION LEDS .................................................................................... 13 FIGURE 9: OBD INTERFACE ........................................................................................................................... 14 FIGURE 10: USB PORTS ................................................................................................................................. 15 FIGURE 11: COM PORT SETTING OF QCOM ................................................................................................ 15 FIGURE 12: STA808X/9X FIRMWARE UPGRADE TOOL CONFIGURATIONS .............................................. 16 FIGURE 13: TESEOIII XLOADER TOOL CONFIGURATIONS ........................................................................ 17 FIGURE 14: TESEO-SUITE PRO INTERFACE ................................................................................................ 18 FIGURE 15: MANUAL CONFIGURATION FOR THE COM PORT ................................................................... 19 FIGURE 16: SIGNAL LEVEL............................................................................................................................. 20 FIGURE 17: SKY VIEW ..................................................................................................................................... 20 FIGURE 18: MODULE POSITIONING FORM .................................................................................................. 21 FIGURE 19: COMMAND SENDING VIA TESEO-SUITE PRO ......................................................................... 21 FIGURE 20: ADR CALIBRATION STATUS ....................................................................................................... 24 FIGURE 21: AXIS OF L26-DR (UDR) EVB ....................................................................................................... 25 FIGURE 22: UDR CALIBRATION STATUS....................................................................................................... 26 L26-DR_EVB_User_Guide 5 / 28 GNSS Module Series L26-DR EVB User Guide 1 Introduction This user guide describes detailed information about the usage of Quectel L26-DR EVB (Evaluation Board), the auxiliary for engineers to develop and test Quectel L26-DR module. 1.1. Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any terminal incorporating Quectel L26-DR module. Manufacturers of the terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for any failure to comply with these precautions. Be assure the use of the product conforms to the national safety and environmental regulations, and is allowed in the country and in the environment required. Keep away from explosive and flammable materials. The use of electronic products in extreme power supply conditions and locations with potentially explosive atmospheres may cause fire and explosion hazards. The product has to be powered by a stabilized voltage source, and the wiring shall conform to security and fire prevention regulations. Proper ESD handling procedures must be applied throughout the mounting, handling and operation of any application that incorporates the module to avoid ESD damages. L26-DR_EVB_User_Guide 6 / 28 GNSS Module Series L26-DR EVB User Guide 2 General Overview 2.1. Top and Side Views of L26-DR EVB The following figure illustrates the top and side views of L26-DR EVB. Figure 1: Top and Side Views of L26-DR EVB Table 1: Interfaces of L26-DR EVB Name A ANT B RESET C BOOT D OBD INTERFACE E SD Description Antenna Interface Reset Button Boot Button OBD Interface SD card Interface L26-DR_EVB_User_Guide 7 / 28 GNSS Module Series L26-DR EVB User Guide F USB/SD USB/SD Switch G 1PPS/RUN/PWR/IND Indication LEDs H USB Micro-USB Interface I POWER Power Switch 2.2. L26-DR EVB and Accessories GNSS Antenna EVB OBD Cable USB Flash Drive USB Cable Figure 2: L26-DR EVB & Accessories Table 2: List of Accessories Items EVB USB Cable OBD Cable 1) Description The evaluation board of L26-DR USB Cable OBD Cable Quantity 1 1 1 L26-DR_EVB_User_Guide 8 / 28 GNSS Module Series L26-DR EVB User Guide Antenna USB Flash Drive Instruction GNSS Antenna (Active) 1 USB Flash Drive (including L26-DR related documents, tools, drivers, etc.) 1 One-sheet-instruction giving instructions for EVB connection, details of EVB accessories, etc. 1 NOTE 1) L26-DR (UDR) EVB Kit does not contain the OBD Cable. 2.3. EVB and Accessories Assembly The following figure shows the assembly of L26-DR EVB and its accessories. Figure 3: L26-DR EVB and Accessories Assembly L26-DR_EVB_User_Guide 9 / 28 GNSS Module Series L26-DR EVB User Guide 3 Interface Applications 3.1. Micro-USB Interface Main power is supplied via the Micro-USB interface. Data can be transmitted either via Micro-USB or SD card interfaces. Please use the USB/SD switcher to select between the two options. Figure 4: Micro-USB Interface L26-DR_EVB_User_Guide 10 / 28 GNSS Module Series L26-DR EVB User Guide 3.2. SD Card Interface The SD card interface supports data saving over external SD card. The SD card capacity should not be greater than 32GB. Figure 5: SD Card Interface 3.3. Antenna Interface The antenna SMA female connector is used for connecting the external antenna. Figure 6: Antenna Interface L26-DR_EVB_User_Guide 11 / 28 3.4. Switches and Buttons The following figure illustrates the switches and buttons of the EVB. GNSS Module Series L26-DR EVB User Guide Figure 7: Switches and Buttons Table 3: Switches and Buttons Part No. Name I/O B RESET DI C BOOT DI I POWER PI F USB/SD IO Description The module will be reset through pressing and then releasing the button. Please refer to Chapter 4.2.2 for details. Power switch USB/SD switch L26-DR EVB supports data output via both Micro-USB and SD card interfaces, which is switched by the USB/SD switch. L26-DR_EVB_User_Guide 12 / 28 3.5. Operation Status Indication LEDs GNSS Module Series L26-DR EVB User Guide Figure 8: Operation Status Indication LEDs Table 4: Operation Status Indication LEDs Name I/O 1PPS DO RUN DO PWR DO IND DO Description Flash: 1PPS signal indicator. The frequency is 1Hz (configurable). Flash: SD card function is supported. Power indicator Flash: Data is output through SD card interface. Off: Data is output through USB card interface. L26-DR_EVB_User_Guide 13 / 28 3.6. OBD Interface The following figure illustrates the OBD interface of the EVB. GNSS Module Series L26-DR EVB User Guide Figure 9: OBD Interface Table 5: Pin Description Pin No. Signal I/O 1 GND - 2 CAN_L IO 3 CAN_H IO 4 SGND - 5 - - 6 WHEELTICK DI 7 FWD DI 8 GND - Description Ground Low level CAN bus line High level CAN bus line Signal ground Reserved Odometer wheel-tick input Forward/backward status signal input Ground NOTE L26-DR (UDR) EVB does not support WHEELTICK, FWD, CAN features. L26-DR_EVB_User_Guide 14 / 28 GNSS Module Series L26-DR EVB User Guide 4 EVB Operation Procedures This chapter mainly illustrates the operation procedures of L26-DR EVB. 4.1. Communication via Micro-USB Interface Step 1: Connect the EVB to a PC using the Micro-USB cable through the Micro-USB interface, and then set the POWER to ON in order to power on the EVB. Step 2: Plug the USB flash drive to the PC and install the USB driver. The USB port numbers will be viewed in Device Manager of the PC after the USB driver is installed, as shown below. Figure 10: USB Ports Step 3: Install the tool QCOM mounted on the USB flash drive. QCOM is used to review the L26-DR messages. The following figure shows the COM Port Setting of QCOM: select the correct 'COM Port' (USB Port shown in the above figure) and set the correct 'Baudrate' (the default value: 115200bps). For more details about the usage of QCOM, please refer to document [4]. Figure 11: COM Port Setting of QCOM L26-DR_EVB_User_Guide 15 / 28 GNSS Module Series L26-DR EVB User Guide 4.2. Download Firmware There are two methods to download the firmware: firmware upgrade and boot download. 4.2.1. Firmware Upgrade Firmware Upgrade should be operated as the following steps: Step 1: Connect the EVB to a PC using the USB cable. Step 2: Switch POWER to ON state to power on the EVB. Step 3: Run the tool STA808x/9x Firmware Upgrade and configure the tool as shown below. Figure 12: STA808x/9x Firmware Upgrade Tool Configurations Step 4: Click button and then reset the module to upgrade the firmware. 4.2.2. Boot Download Boot download should be performed as the following steps: Step 1: Connect the EVB to a PC using the USB cable. Step 2: Long press BOOT button (the BOOT pin of L26-DR will be pulled up to VCC with a 10kΩ resistor), and switch POWER to ON state to power on the EVB. Once the high voltage level of BOOT pin has been detected during the power-up, the module will enter boot download mode. L26-DR_EVB_User_Guide 16 / 28 GNSS Module Series L26-DR EVB User Guide Step 3: Release BOOT button to make BOOT pin of L26-DR return to normal floating. Step 4: Run the tool TeseoIII XLoader and configure the tool as shown below. Step 5: Click Figure 13: TeseoIII XLoader Tool Configurations button to download the firmware. L26-DR_EVB_User_Guide 17 / 28 GNSS Module Series L26-DR EVB User Guide 5 Usage of Teseo-Suite Pro After the EVB accessories are assembled, please turn on the module and start the tool Teseo-Suite Pro. The tool helps users to view the status of GNSS receiver. The following chapters only briefly describes the use of Teseo-Suite Pro. For more details about the tool, please click 'Help' and review the 'User Manual' in the tool. 5.1. View GNSS Receiver Status 5.1.1. COM Port and Baud Rate Setting After the tool is opened, the following interface will be shown: Figure 14: Teseo-Suite Pro Interface L26-DR_EVB_User_Guide 18 / 28 GNSS Module Series L26-DR EVB User Guide UART port can be automatically identified by Teseo-Suite Pro when the it is opened. If not, the steps from 'a' to 'd' illustrated in the following figure should be performed. Please click the corresponding buttons. After button is clicked, the 'Rover Configuration' box will be popped up, then please check the 'Add Control Port' box. a b c d Figure 15: Manual Configuration for the COM Port L26-DR_EVB_User_Guide 19 / 28 GNSS Module Series L26-DR EVB User Guide 5.1.2. Explanations of Views and Windows The following interface will be shown by clicking button. The digit shown above each flag is the C/No value. Below are displayed information such as the PRN, the frequency band used by the satellite ('BAND'), the azimuth ('AZI') and the elevation of the satellite ('ELE'). Clear flag means the navigation data of this satellite are in use, while faded flag means not used. Figure 16: Signal Level After button is clicked, 'Sky View' will be opened, which shows the current azimuth and elevation of satellites used for the fix. L26-DR_EVB_User_Guide Figure 17: Sky View 20 / 28 GNSS Module Series L26-DR EVB User Guide Through clicking button, 'View Positioning' form that shows information about GPS positioning of devices will be opened. Figure 18: Module Positioning Form 5.2. Send PSTM Commands PSTM Commands can be sent by Teseo-Suite Pro. Through clicking will be popped up, which is shown in the figure below. button, the command input box Figure 19: Command Sending via Teseo-Suite Pro L26-DR_EVB_User_Guide 21 / 28 GNSS Module Series L26-DR EVB User Guide 6 Calibration Procedure In order to utilize Dead Reckoning (DR) capabilities of L26-DR, a valid module calibration is essential. Please mount the module tightly on the vehicle during use. No movement or shaking should occur to ensure the performance of the module. This chapter introduces the detailed calibration procedure. 6.1. Calibration for L26-DR (ADR)/L26-DR (ADRA) EVB L26-DR (ADR) and L26-DR (ADRA) EVB allow for flexible installation regardless of the angle and direction. The module automatically recognizes the mounting angle deviation and compensates by internal algorithmic calculations. The calibration for L26-DR (ADR) and L26-DR (ADRA) comprises 7 steps, as describe in the following chapters. NOTES 1. This calibration process in this chapter is based on the precondition that users have fixed the EVB. And no displacement or rotation of the EVB should happen after the calibration. 2. The calibration process needs to be repeated only when:  The EVB has been moved and reinstalled.  During a DR cold start and when the NVM is blank or invalid. 3. Please follow the steps in Chapter 6.1.1 to finish the angle determination process as any improper operation may affect the calibration. 6.1.1. Determination Process of EVB Installation Angle Before the 6-axis accelerometer sensor is available, EVB installation angle needs to be determined by the following steps: Step 1: Install the EVB on a vehicle and connect the antenna. Step 2: Start the vehicle and power on the EVB. Step 3: Keep the vehicle unmoved for at least 20 seconds on a flat road (1°~2° tolerance in gravity L26-DR_EVB_User_Guide 22 / 28 GNSS Module Series L26-DR EVB User Guide direction). Step 4: Drive the vehicle for 1 minute. Step 5: Stop the vehicle and keep it unmoved for at least 5 seconds. The software will save the calculated installation angle to the flash memory. 6.1.2. Main Calibration Procedure Once installation angle is determined, the following steps should be performed to fine tune the calibration accurately: Step 6: After Step 5, the yaw rate offset is automatically initialized with a reliable value. Then, drive in a straight road (with speed > 30 km/h) for at least 5 minutes. Step 7: Drive in areas rich of curves (with speed > 30 km/h). This process is needed to calibrate the yaw rate gain. It is important that tight turns (with narrow radius of curvature) are required. Typical scenes that allow this step to be performed properly are roundabouts, tight turns, and road curves with direction changed in 90 degrees or more. Large turns (e.g. smooth turns on highway, lane changes, etc.) will not work. Please note that the success of this operation does not depend on its duration, but the number of valid turns. In order to have a fine-tuned yaw rate gain, it is suggested that the first-boot calibration route should include at least 10 tight turns described above. During this procedure, the same turn can be repeated for many times. It is of the utmost importance that all these operations should be performed under adequate GNSS signal conditions, which means that the antenna must have maximum sky visibility. Thus, the calibration should be performed in an open area, i.e. the area away from high-rise buildings, forests, tunnels and any other element that may cause signal blocking or reflection. NOTE Please notify that the hybrid GNSS/DR navigation mode will not be available until a valid calibration is done. Without a valid calibration, only single GNSS navigation is available. L26-DR_EVB_User_Guide 23 / 28 GNSS Module Series L26-DR EVB User Guide 6.1.3. Calibration Result Monitoring The calibration result can be monitored through Teseo-Suite Pro tool. After the tool is started, please click 'DR' in the menu. The 'Dead Reckoning' window will be popped up, as shown by the figure below. If the 'DR Calibration Status' shown below turns green, the calibration is successful. After that, the test can be started. If the 'DR Calibration Status' turns red, please repeat the calibration procedure. Figure 20: ADR Calibration Status L26-DR_EVB_User_Guide 24 / 28 GNSS Module Series L26-DR EVB User Guide 6.2. L26-DR (UDR) EVB The installation of L26-DR (UDR) EVB is relatively more demanding, one of the X, Y and Z axis, shown in the following figure, should be perpendicular to the horizontal plane, and the deviation should be less than 20°. In this case, there is no limit to the placement direction on the plane formed by the other two axes. For instance, if axis Z is perpendicular to the horizontal plane, there is no limit to the mounting direction of the EVB on the plane formed by axes X and Y. Z Y X Figure 21: Axis of L26-DR (UDR) EVB 6.2.1. Calibration Procedure Step 1: Install the EVB on a vehicle and connect the antenna. Step 2: Power on the EVB. Step 3: Keep the vehicle unmoved for 30s~60s. Step 4: Then start the vehicle and drive under strong GNSS signals, with speed changed for 2 times. L26-DR_EVB_User_Guide 25 / 28 GNSS Module Series L26-DR EVB User Guide 6.2.2. Calibration Result Monitoring The calibration result will be reported in an NMEA ($PQSOL) message. For more details about this message, please refer to document [2]. A method to check the UDR state message is shown by the following figure. Figure 22: UDR Calibration Status L26-DR_EVB_User_Guide 26 / 28 GNSS Module Series L26-DR EVB User Guide 7 Appendix A Reference Table 6: Related Documents SN Document name Remark [1] Quectel_L26-DR_Hardware_Design L26-DR Hardware Design [2] Quectel_L26-DR_GNSS_Protocol_Specification L26-DR GNSS Protocol Specification [3] Quectel_L26-DR_Reference Design L26-DR Reference Design [4] Quectel_QCOM_User_Guide QCOM User Guide Table 7: Terms and Abbreviations Abbreviation API CAN CNR DI DO EVB GNSS IO I/O LED NVM Description Application Programming Interface Controller Area Network Carrier-to-Noise Ratio Digital Input Digital Output Evaluation Board Global Navigation Satellite System Input and Output (Bidirectional) Input/Output Light Emitting Diode Non-volatile Memory L26-DR_EVB_User_Guide 27 / 28 OBD PI PPS PRN SV UART UTC On Board Diagnostics Power Input Pulse Per Second Pseudorandom Noise Satellite Vehicle Universal Asynchronous Receiver & Transmitter Coordinated Universal Time GNSS Module Series L26-DR EVB User Guide L26-DR_EVB_User_Guide 28 / 28

RG200U&RG500U Series 5G EVB User Guide 5G Module Series Version: 1.0. Date: 2023-05-30 Status: Released 5G Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. RG200U&RG500U_Series_5G_EVB_User_Guide 1 / 49 5G Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. RG200U&RG500U_Series_5G_EVB_User_Guide 2 / 49 5G Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. RG200U&RG500U_Series_5G_EVB_User_Guide 3 / 49 5G Module Series About the Document Revision History Version 1.0 Date 2022-07-21 2023-05-30 Author Description Neeson ZHANG Anthony LIU/ Cavan ZHU Creation of the document First Official Release RG200U&RG500U_Series_5G_EVB_User_Guide 4 / 49 5G Module Series Contents Safety Information....................................................................................................................................... 3 About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 7 Figure Index ................................................................................................................................................. 8 1 Introduction .......................................................................................................................................... 9 1.1. Applicable Modules ..................................................................................................................... 9 2 Product Overview .............................................................................................................................. 10 2.1. Top and Bottom Views .............................................................................................................. 10 2.2. Component Placement ............................................................................................................. 12 3 Kit Accessories & Assembly ............................................................................................................ 16 3.1. Accessories Assembly .............................................................................................................. 16 3.2. Accessories List ........................................................................................................................ 17 4 Application Interfaces ....................................................................................................................... 19 4.1. Power Supply ............................................................................................................................ 20 4.2. Module TE-A Interfaces ............................................................................................................ 21 4.3. USB Interface............................................................................................................................ 24 4.4. Audio Interfaces ........................................................................................................................ 24 4.4.1. Digital Audio Codec Board Interface .............................................................................. 25 4.4.2. Analog Audio Interfaces ................................................................................................. 26 4.4.2.1. Loudspeaker Application ..................................................................................... 26 4.4.2.2. Earphone Application .......................................................................................... 26 4.5. (U)SIM Card Interfaces ............................................................................................................. 28 4.6. SD Card Interface ..................................................................................................................... 30 4.7. UART Interfaces........................................................................................................................ 31 4.8. PCIe-to-USB Interface .............................................................................................................. 32 4.9. Status Indicators ....................................................................................................................... 33 4.10. Wi-Fi TE-A Interfaces ................................................................................................................ 34 4.11. Antenna Interfaces .................................................................................................................... 35 4.12. Switches and Buttons ............................................................................................................... 40 4.13. Test points ................................................................................................................................. 42 5 Operation Procedures ....................................................................................................................... 45 5.1. Turn on the Module ................................................................................................................... 45 5.2. Turn off the Module ................................................................................................................... 45 5.3. Communication via USB ........................................................................................................... 46 5.4. Firmware Upgrade .................................................................................................................... 46 5.4.1. Emergency Download .................................................................................................... 47 5.4.2. Normal Download........................................................................................................... 47 5.5. Reset the Module ...................................................................................................................... 47 RG200U&RG500U_Series_5G_EVB_User_Guide 5 / 49 5G Module Series 6 Appendix References ........................................................................................................................ 48 RG200U&RG500U_Series_5G_EVB_User_Guide 6 / 49 5G Module Series Table Index Table 1: Components & Functions ............................................................................................................. 13 Table 2: Accessories List ............................................................................................................................ 17 Table 3: Description of Power Supply ........................................................................................................ 20 Table 4: Description of Module TE-A Interfaces......................................................................................... 21 Table 5: Description of USB Interface ........................................................................................................ 24 Table 6: Description of Audio Interfaces..................................................................................................... 24 Table 7: Codec TE-A Configuration Switch ................................................................................................ 26 Table 8: Pin Definition of J0901 ................................................................................................................. 27 Table 9: Description of (U)SIM Card Interfaces ......................................................................................... 28 Table 10: Pin Definition of J1401 ............................................................................................................... 29 Table 11: Description of SD card Interface................................................................................................. 30 Table 12: SDIO Switch Function ................................................................................................................ 31 Table 13: Description of UART Interfaces .................................................................................................. 31 Table 14: Description of PCIe-to-USB Interface ........................................................................................ 32 Table 15: PCIe Connection Truth Table ..................................................................................................... 33 Table 16: Description of Status Indication LEDs........................................................................................ 33 Table 17: Description of Wi-Fi TE-A Interfaces .......................................................................................... 34 Table 18: Description of Antenna Interfaces .............................................................................................. 35 Table 19: RG500U-EA Antenna Interfaces description .............................................................................. 36 Table 20: RG500U-CN Antenna Interfaces description ............................................................................. 38 Table 21: RG200U-CN Antenna Interfaces description ............................................................................. 39 Table 22: Description of Switches and Buttons.......................................................................................... 40 Table 23: Pin Definition of Test Points........................................................................................................ 43 Table 24: Related Documents .................................................................................................................... 48 Table 25: Terms and Abbreviations ............................................................................................................ 48 RG200U&RG500U_Series_5G_EVB_User_Guide 7 / 49 5G Module Series Figure Index Figure 1: Top View...................................................................................................................................... 10 Figure 2: Bottom View .................................................................................................................................11 Figure 3: Top View for Component Placement .......................................................................................... 12 Figure 4: Bottom View for Component Placement..................................................................................... 13 Figure 5: RG200U & RG500U Series 5G EVB and Accessories Assembly .............................................. 16 Figure 6: RG200U & RG500U Series 5G EVB Kit Accessories ................................................................ 17 Figure 7: Block Diagram of the EVB Power Supply................................................................................... 20 Figure 8: EVB Power Supply Interface ...................................................................................................... 21 Figure 9: Power Plug Design ..................................................................................................................... 21 Figure 10: Connection Between the Module TE-A and the EVB ............................................................... 23 Figure 11: USB Interface Connection ........................................................................................................ 24 Figure 12: Connection Between Codec TE-A and EVB............................................................................. 25 Figure 13: Switch S2801 ............................................................................................................................ 25 Figure 14: Reference Circuit Design for Loudspeaker Application............................................................ 26 Figure 15: Reference Circuit Design for Earphone Application ................................................................. 27 Figure 16: Pin Assignment of J0901 .......................................................................................................... 27 Figure 17: Schematic of Audio Plug........................................................................................................... 28 Figure 18: Simplified Connector Schematic for (U)SIM Card Connectors ................................................ 29 Figure 19: Pin Assignment of (U)SIM Card Connector J1401 ................................................................... 29 Figure 20: SDIO Configuration Switch S2501 ........................................................................................... 30 Figure 21: UART Block Diagram ................................................................................................................ 31 Figure 22: PCIe Block Diagram.................................................................................................................. 32 Figure 23: PCIe Configuration Switch S1501 ............................................................................................ 32 Figure 24: Status Indicators ....................................................................................................................... 34 Figure 25: Connection Between RTL8111H TE-A and EVB ...................................................................... 35 Figure 26: Connection Between FC06E TE-A and EVB ............................................................................ 35 Figure 27: RG500U-EA Antenna Interfaces ............................................................................................... 36 Figure 28: RG500U-CN Antenna Interfaces .............................................................................................. 37 Figure 29: RG200U-CN Antenna Interfaces .............................................................................................. 39 Figure 30: Switches S0301 and S2501...................................................................................................... 41 Figure 31: Switch S1501 and Button S0201.............................................................................................. 41 Figure 32: Buttons S0202 and S0203........................................................................................................ 41 Figure 33: Switch S2801 ............................................................................................................................ 42 Figure 34: Test Points of J0103 and J0804................................................................................................ 42 Figure 35: Test Points of J0301 and J0304................................................................................................ 42 Figure 36: Test Points of J0401.................................................................................................................. 43 Figure 37: USB Ports ................................................................................................................................. 46 Figure 38: COM Port Setting Field on QCOM (USB AT Port Connection) ................................................ 46 Figure 39: SPRD U2S Diag Port ................................................................................................................ 47 RG200U&RG500U_Series_5G_EVB_User_Guide 8 / 49 5G Module Series 1 Introduction This user guide describes the application details of RG200U & RG500U Series 5G EVB (evaluation board), which is an assistant tool for developers to develop applications and test basic functionalities of applicable modules. 1.1. Applicable Modules For details about the applicable modules of this EVB, see document [1]. RG200U&RG500U_Series_5G_EVB_User_Guide 9 / 49 5G Module Series 2 Product Overview 2.1. Top and Bottom Views The size of RG200U & RG500U Series 5G EVB is 235 mm × 190 mm, and the top and bottom views are shown as below: Figure 1: Top View RG200U&RG500U_Series_5G_EVB_User_Guide 10 / 49 5G Module Series Figure 2: Bottom View RG200U&RG500U_Series_5G_EVB_User_Guide 11 / 49 5G Module Series 2.2. Component Placement J0304 J0401 S0301 USIM1 J1401 card RESET S0201 PCIE_SEL1 PCIE_SEL2 S1501 PCIe to USB J1601 PWRKEY S0202 SLEEP D 0 205 NET_ STATUS D 0 204 NET_ MODE D 0 203 STATUS D 0 202 POWER D 0201 J0301 SDIO_SWITCH S2501 OFF ON USB Type-C J1101 60 Pin J 0701 WIFI-TE-A J 0702 60 Pin ANT_GNSS L1L5 CODEC-TE-A J 2303 60 Pin J0802 I2S_WS I2S_DIN I2S_DOUT I2S_SCK I2S_MCLK GND J 0102 SLIC_SEL2 SLIC_SEL1 S2801 GND SPI1_MISO SPI1_CLK SPI1_CS SPI1_MOSI ANT0 J2311 J0103 S0203 USB_BOOT ANT_WIFI0 J 2346 140 Pin J2348 J2308 ANT7 J 2315 ANT6 Module TE-A ANT_GNSS L1 J 0101 140 Pin J 2317 ANT5 ANT_WIFI1 J 2347 J 2307 ANT4 3.8V_EN RESET_3.3V PWRKEY_3.3V ADAPTER REG_3V3 VCC_3V8_MODULE GND RTS_TEST ANT2 J 2304 DTR_TEST ANT1 J 2312 J 2318 ANT3 Figure 3: Top View for Component Placement RG200U&RG500U_Series_5G_EVB_User_Guide 12 / 49 SPK J0801 5G Module Series EARPHONE J0901 USIM2 card J1402 J2002 MAIN_UART J1301 SD card Figure 4: Bottom View for Component Placement J2003 DBG_UART J0303 5 V /3 A ADAPTER Table 1: Components & Functions Component RefDes. Power Supply J0303 Power Switch PWRKEY USB_BOOT S0301 S0202 S0203 Description Power jack on the EVB VBAT ON/OFF control ⚫ Power key (push button) ⚫ Used to turn ON/OFF the module Emergency download Implementation ⚫ DC power supply: 4.5–5.5 V ⚫ Typical supply voltage: +5 V/ 3 A Switch Button Button RG200U&RG500U_Series_5G_EVB_User_Guide 13 / 49 RESET S0201 USB Interface J1101 PCIe-to-USB Interface J1601 PCIe Configuration S1501 Switch SDIO Configuration Switch Codec Configuration Switch S2501 S2801 J0802 Audio Interfaces J0801 J0901 (U)SIM Card Interfaces J1401 J1402 SD Card Interface J1301 Main UART J2002 Debug UART J2003 D0201 Status Indicators D0202 D0203 D0204 5G Module Series ⚫ Reset button (push button) ⚫ Used to reset the module USB Type-C interface PCIe-to-USB interface, not supported by default Used to configure the module communication with different devices via PCIe signals Button Used for USB 3.0 and USB 2.0 communication Reserved Switch Used to switch between SD card and eMMC Switch Used for codec configuration Switch Codec board TE-A connector Test points for loudspeaker Audio jack for earphone (U)SIM1 card connector (U)SIM2 card connector SD card connector MAIN_UART for data communication ⚫ 1 digital audio codec board interface: Supports ALC5616-TE-A and TLV320AIC3104-TE-A codec boards ⚫ 2 analog audio interfaces: Used for loudspeaker and earphone Dual (U)SIM card supported: 1.8 V and 3.0 V COM1 (J2002): Default baud rate: 115200 bps DBG_UART for debugging COM2 (J2003): Default baud rate: 115200 bps Power supply ON/OFF indicator Module operation status indicator, indicating whether the module is turned on. 5 LEDs are available for signal Network mode indicator, indication indicating NET_MODE status of the module Network status indicator, indicating NET_STATUS status RG200U&RG500U_Series_5G_EVB_User_Guide 14 / 49 5G Module Series of the module Module TE-A Interfaces Wi-Fi TE-A Interfaces Antenna Interfaces D0205 J0101, J0102 J0701, J0702 J2303, J2304, J2307, J2308, J2311, J2312, J2315, J2317, J2318, J2346, J2347, J2348 Sleep status indicator, indicating SLEEP status of the module Connect module TE-A Connect Wi-Fi TE-A Antenna connectors Test Points J0103, J0301, J0304, J0401, J0804 Support the applicable modules Reserved 12 antenna connectors Five test points RG200U&RG500U_Series_5G_EVB_User_Guide 15 / 49 5G Module Series 3 Kit Accessories & Assembly 3.1. Accessories Assembly Figure 5: RG200U & RG500U Series 5G EVB and Accessories Assembly RG200U&RG500U_Series_5G_EVB_User_Guide 16 / 49 5G Module Series 3.2. Accessories List All accessories of the RG200U & RG500U Series 5G EVB kit are listed as below. Please contact the supplier if there is something missing. Figure 6: RG200U & RG500U Series 5G EVB Kit Accessories Table 2: Accessories List Items Cables Antennas Description USB-to-RS232 converter cable USB Type-A to Type-B cable USB Type-C cable RF cables Wi-Fi antennas Quantity (pcs) 1 1 1 9 2 RG200U&RG500U_Series_5G_EVB_User_Guide 17 / 49 5G Module Series RF antennas GNSS antennas (passive) Audio Earphone USB Driver Including module’s related documents, tools & drivers, etc. Codec TE-A ALC5616, TLV320AIC3104 Instruction Sheet PCIe-to-USB adapter A sheet of paper giving instructions for EVB connection, details of EVB accessories, etc. PCIe signal is transferred through USB 3.0 connector, not used by default. Heatsink Used to dissipate heat from the modules Bolts and Nuts Bolts and nuts for assembling the EVB Adapter plug type: BS Adapter Plug Adapter plug type: EU Adapter plug type: US Adapter plug type: CN Power Adapter +5 V/ 3 A power adapter 8 2 1 1 2 1 1 1 16 pairs 1 1 1 1 1 RG200U&RG500U_Series_5G_EVB_User_Guide 18 / 49 5G Module Series 4 Application Interfaces This chapter describes the hardware interfaces of the RG200U & RG500U Series 5G EVB, as listed below: ⚫ Power supply ⚫ Module TE-A interfaces ⚫ USB interface ⚫ Audio interfaces - Digital Audio Codec Board Interface - Analog Audio Interfaces -- Loudspeaker Application -- Earphone Application ⚫ (U)SIM card interfaces ⚫ SD card interface ⚫ UART interfaces ⚫ PCIe-to-USB interface ⚫ Status indicators ⚫ Wi-Fi TE-A interfaces ⚫ Antenna Interfaces ⚫ Switches and buttons ⚫ Test points RG200U&RG500U_Series_5G_EVB_User_Guide 19 / 49 5G Module Series 4.1. Power Supply The EVB can be powered by an external power adapter through the power jack on the EVB. Table 3: Description of Power Supply RefDes. J0303 Description Power jack on the EVB The following figures show the simplified power supply block diagram of the EVB. J0303 Power Jack 5 V /3 A REG_3V3 5 V TPS62130 MP2145 TLV75518 XC6227C301 MP1605 MP1605 1.5 V Wi-Fi AP 0.9 V AP/Wi-Fi 1.8 V eMMC 3.0 V eMMC 2.7 V Level Shift 2.5 V RGMII MOS TLV75533 5 V Test Points 3.3 V UART MP1605 4.2 V AP TPS62130 3.8 V Moudle TPS62130 TPS62130 ISL80101 REG_1V8 RGMII/Wi-Fi/ Level Shift/ADC/ Codec, etc. REG_3V3 SD_3.0V PHY/Wi-Fi/Level Shift/USB&PCIe Switch/Analog Switch/Multiplexer/ Codec, etc. SD Card TPS728180285 SDIO SD Card Figure 7: Block Diagram of the EVB Power Supply RG200U&RG500U_Series_5G_EVB_User_Guide 20 / 49 5G Module Series Figure 8: EVB Power Supply Interface If the power jack is used for power supply, the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 9: Power Plug Design 4.2. Module TE-A Interfaces Module TE-A interfaces are designed to accommodate the TE-A of applicable modules. The TE-A is connected to the EVB via BTB connector. The developer will be able to test the functionalities of the modules easily (insert as indicated by the arrow to prevent reverse insertion). Table 4: Description of Module TE-A Interfaces RefDes. J0101 J0102 Description Connect module TE-A RG200U&RG500U_Series_5G_EVB_User_Guide 21 / 49 5G Module Series The following figure shows the connection between the module TE-A and the EVB. RG200U&RG500U_Series_5G_EVB_User_Guide 22 / 49 5G Module Series Figure 10: Connection Between the Module TE-A and the EVB RG200U&RG500U_Series_5G_EVB_User_Guide 23 / 49 5G Module Series 4.3. USB Interface The EVB provides a USB Type-C interface, which complies with USB 3.0 and USB 2.0 standard. This USB interface is used for AT command communication, data transmission and firmware upgrade. Table 5: Description of USB Interface RefDes. J1101 Description USB Type-C interface, used for USB 3.0 and USB 2.0 communication Figure 11: USB Interface Connection 4.4. Audio Interfaces The EVB provides one digital audio codec board interface (I2S) and two analog audio interfaces. Table 6: Description of Audio Interfaces RefDes. J0802 J0801 J0901 Description Codec board TE-A connector Test point for loudspeaker Audio jack for earphone RG200U&RG500U_Series_5G_EVB_User_Guide 24 / 49 5G Module Series 4.4.1. Digital Audio Codec Board Interface The EVB supports two different kinds of external digital audio codec TE-As, i.e. ALC5616 and TLV320AIC3104. The codec circuit is assembled on an independent small board which can be interconnected with the EVB by the BTB connector J0802. Codecs can be selected according to specific application demands, the following figures show the connection between digital audio codec TE-A and the EVB. Figure 12: Connection Between Codec TE-A and EVB S2801 codec configuration switch MODEM: codec connected to the module AP: codec connected to the AP Figure 13: Codec Configuration Switch S2801 RG200U&RG500U_Series_5G_EVB_User_Guide 25 / 49 Table 7: Codec TE-A Configuration Switch SLIC_SEL1 Low High Low High SLIC_SEL2 Low High High Low AP NC I2S/SPI/RST/INT SPI/RST/INT I2S 5G Module Series MODEM I2S/SPI/RST/INT NC I2S SPI/RST/INT 4.4.2. Analog Audio Interfaces 4.4.2.1. Loudspeaker Application Audio interface J0801 is designed for loudspeaker and the following figure shows a reference design of loudspeaker with an external audio amplifier. J0802 Differential layout Codec LOUDL/P C1 TLV3104 LOUDR/N C2 Amp l ifie r circuit LM4871 Close to loudspeaker GND FB J0801 FB BTB GND Connector Figure 14: Reference Circuit Design for Loudspeaker Application 4.4.2.2. Earphone Application Audio interface J0901 is designed for earphone. A reference circuit design is shown by the following figure. RG200U&RG500U_Series_5G_EVB_User_Guide 26 / 49 5G Module Series Differential layout J0802 MIC_N MIC_P Close to Socket GND AGND GND GND GND 10 pF 33 pF 4.7 μF 75 pF 15 pF ESD AGND Codec 22 μF TLV3104 22 μF AGND SPK_L 1 μF SPK_R 1 μF BTB Connector Close to Socket 10 pF 33 pF 10 pF 33 pF ESD GND 0R NM_0R 2 4 6 5 3 1 J0901 Audio Jack NM_0R 0R AGND MIC_P Figure 15: Reference Circuit Design for Earphone Application The figure and table below illustrate the pin assignment and pin definition of earphone connector. 6 4 5 3 2 1 Figure 16: Pin Assignment of J0901 Table 8: Pin Definition of J0901 Pin No. 1 2 3 4 5, 6 Pin Name MIC AGND SPK_R SPK_L NC Description Microphone input Dedicated GND for audio Right channel of stereo audio output Left channel of stereo audio output NC RG200U&RG500U_Series_5G_EVB_User_Guide 27 / 49 5G Module Series The following figure shows a schematic of audio plug which suits the audio jack on the EVB. 4 3 2 GND 1 SW SPK_R 32 Ω MIC SPK_L 32 Ω Figure 17: Schematic of Audio Plug 4.5. (U)SIM Card Interfaces The EVB has two 8-pin push-push type (U)SIM card interfaces which support 1.8/3.0 V (U)SIM card. Table 9: Description of (U)SIM Card Interfaces RefDes. J1401 J1402 Description (U)SIM1 card connector (U)SIM2 card connector The following figure shows a simplified connector schematic for these connectors. RG200U&RG500U_Series_5G_EVB_User_Guide 28 / 49 5G Module Series Module USIM_VDD USIM_RST USIM_CLK USIM_DATA USIM_PRESENCE GND Push-Push C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK C7 (U)SIM card connector USIM_DATA C4 RESERVED C8 RESERVED CD USIM_PRESENCE J1401/J1402 Figure 18: Simplified Connector Schematic for (U)SIM Card Connectors The figure and table below illustrate the pin assignment and definition of (U)SIM card connector J1401. J1402 is similar to J1401. C1 C2 C3 C4 CD C5 C6 C7 C8 Figure 19: Pin Assignment of (U)SIM Card Connector J1401 Table 10: Pin Definition of J1401 Pin No. C1 Pin Name USIM_VDD I/O Function PO (U)SIM card power supply, provided by module RG200U&RG500U_Series_5G_EVB_User_Guide 29 / 49 5G Module Series C2 USIM_RST DO (U)SIM card reset C3 USIM_CLK DO (U)SIM card clock C4 RESERVED - NC C5 GND - Ground C6 VPP - NC C7 USIM_DATA DIO (U)SIM card data C8 RESERVED - NC CD USIM_PRESENCE DI (U)SIM card insertion detection 4.6. SD Card Interface The EVB provides an SD card interface, which can be used for connecting SD card or eMMC. Table 11: Description of SD card Interface RefDes. J1301 Description SD card connector If eMMC function is intended to be used, switch the SDIO Configuration Switch (S2501) to low level as illustrated in the figure below: S2501 SDIO configuration switch Figure 20: SDIO Configuration Switch S2501 RG200U&RG500U_Series_5G_EVB_User_Guide 30 / 49 Table 12: SDIO Switch Function SDIO Switch Low High Function Enable SD card function Enable eMMC function ⚫NOTE SD card function is not supported for the applicable modules. 5G Module Series 4.7. UART Interfaces The EVB supports two UART interfaces: main UART and debug UART, supporting baud rate of 115200 bps by default. The main UART interface is used for communication between the module and the host application. The debug UART interface is used for Linux console and log output. Table 13: Description of UART Interfaces RefDes. J2002 J2003 Description MAIN_UART for data communication DBG_UART for debugging The following figure shows a block diagram of UART interfaces of the EVB. J2002 RS232 Main UART RS232 Transceiver 3.3/1.8 V Level Shift 1.8 V J2003 Debug UART USB to UART Bridge 3.3/1.8 V Level Shift 1.8 V Module J0101 Figure 21: UART Block Diagram RG200U&RG500U_Series_5G_EVB_User_Guide 31 / 49 5G Module Series 4.8. PCIe-to-USB Interface The EVB reserves a PCIe 2.0 signal over USB interface for developers’ testing, and this function is not enabled by default. Table 14: Description of PCIe-to-USB Interface RefDes. J1601 Description PCIe-to-USB interface, not supported by default Please refer to the following block diagram: USB Type-A to Type-B cable J1601 USB Type-B 3.0 WiFi AP SEL_1 SEL_2 J0101 CLK PCIe Switch TX0/1 RX0/1 Module Figure 22: PCIe Block Diagram S1501 PCIE configuration switch Figure 23: PCIe Configuration Switch S1501 RG200U&RG500U_Series_5G_EVB_User_Guide 32 / 49 Table 15: PCIe Connection Truth Table PCIE_SEL1 0 1 1 PCIE_SEL2 1 0 1 5G Module Series Function Module → PC Module → AP Module → Wi-Fi 4.9. Status Indicators There are five status indication LEDs on the EVB. Table 16: Description of Status Indication LEDs RefDes. D0201 D0202 D0203 D0204 D0205 Description Indicates whether the power supply for module is ready ⚫ ON: VBAT ON ⚫ OFF: VBAT OFF Indicates the operation status of the module ⚫ ON: the module is turned ON ⚫ OFF: the module is turned OFF Indicates NET_MODE status of the module Indicates NET_STATUS status of the module Indicates the module’s SLEEP status RG200U&RG500U_Series_5G_EVB_User_Guide 33 / 49 The following figure manifests the positions of these LED indicators: D0205 D0204 D0203 D0202 D0201 5G Module Series Figure 24: Status Indicators 4.10. Wi-Fi TE-A Interfaces The Wi-Fi TE-A interface is designed to accommodate the FG50V/FC64E/FC06E TE-A and Ethernet TE-A (RTL8111H/RTL8125B). The TE-A is connected to the EVB via BTB connector. The interfaces allow developers to test the Wi-Fi function or the Ethernet function of the module. Table 17: Description of Wi-Fi TE-A Interfaces RefDes. J0701 J0702 Description Connect Wi-Fi TE-A The following two figures show the connection between TE-A (take RTL8111H TE-A and FC06E TE-A as examples) and EVB. RG200U&RG500U_Series_5G_EVB_User_Guide 34 / 49 5G Module Series Figure 25: Connection Between RTL8111H TE-A and EVB Figure 26: Connection Between FC06E TE-A and EVB 4.11. Antenna Interfaces The EVB includes twelve antenna interfaces. Table 18: Description of Antenna Interfaces RefDes. Description J2303, J2304, J2307, J2308, J2311, J2312, J2315, J2317, J2318, Antenna connectors J2346, J2347, J2348 RG200U&RG500U_Series_5G_EVB_User_Guide 35 / 49 The following figure shows the assembly of these antenna interfaces: 5G Module Series Figure 27: RG500U-EA Antenna Interfaces Table 19: RG500U-EA Antenna Interfaces description Module Pin No. TE-A 130 Ant1 139 Ant2 EVB Ant1 Ant4 Band ⚫ WCDMA: LMB TRX ⚫ LTE: LMB & B40 TRX ⚫ 5G NR: n1/n3 PRX1 & n8/n20/n28 TRX & n40 TRX1 ⚫ LTE: B7/B38/B41 TRX ⚫ 5G NR: n7/n77/n78/n79 PRX1 & RG200U&RG500U_Series_5G_EVB_User_Guide 36 / 49 148 Ant3 Ant0 157 Ant4 Ant5 166 Ant5 Ant6 184 Ant7 Ant7 5G Module Series n38/n41 TRX1 ⚫ WCDMA: LMB DRX ⚫ LTE: LMB & B40 DRX ⚫ 5G NR: n1/n3/n40 DRX1 & n8/n20/n28 DRX ⚫ LTE: B7/B38/B41 DRX ⚫ 5G NR: n7/n38/n41 DRX1 & n77/n78/n79 TX1 & DRX0 5G NR: LMHB DRX0 & n77/n78/n79 DRX1 5G NR: LMHB & n77/n78/n79 TRX0 Figure 28: RG500U-CN Antenna Interfaces RG200U&RG500U_Series_5G_EVB_User_Guide 37 / 49 5G Module Series Table 20: RG500U-CN Antenna Interfaces description Module Pin No. TE-A 130 Ant1 157 Ant4 166 Ant5 184 Ant7 EVB Ant1 Ant0 Ant5 Ant6 Band ⚫ WCDMA: LMB TRX ⚫ LTE: LMHB TRX ⚫ 5G NR: n1/n28 TRX & n41 TRX1 & n77/n78/n79 DRX1 ⚫ WCDMA: LMB DRX ⚫ LTE: LMHB DRX ⚫ 5G NR: n1 DRX0 & n28 DRX & n77/n78/n79 TRX1 & n41 DRX1 5G NR: n41/n77/n78/n79 DRX0 & n1 DRX1 5G NR: n41/n77/n78/n79 TRX0 & n1 PRX1 RG200U&RG500U_Series_5G_EVB_User_Guide 38 / 49 5G Module Series Figure 29: RG200U-CN Antenna Interfaces Table 21: RG200U-CN Antenna Interfaces description Module Pin No. TE-A 54 Ant0 EVB Ant1 Band ⚫ WCDMA: B1/B5/B8 TRX ⚫ LTE: LMHB TRX ⚫ 5G NR: n1/n3/n5/n8/n28/n41 TRX & n77/n78/n79 TRX1 RG200U&RG500U_Series_5G_EVB_User_Guide 39 / 49 64 Ant1 Ant5 82 Ant2 Ant6 90 Ant3 Ant0 5G Module Series 5G NR: n77/n78/n79 DRX1 & n1/n41 DRX MIMO 5G NR: n77/n78/n79 TRX0 & n1/n41 PRX MIMO ⚫ WCDMA: B1/B5/B8 DRX ⚫ LTE: LMHB DRX ⚫ 5G NR: n1/n3/n5/n8/n28/n41 DRX & n77/n78/n79 DRX0 4.12. Switches and Buttons The EVB includes four switches and three buttons, as shown in the following table and figures: Table 22: Description of Switches and Buttons RefDes. S0301 S0202 S0201 S0203 S1501 S2501 S2801 Description VBAT ON/OFF control ⚫ Power key (push button) ⚫ Used to turn ON/OFF the module ⚫ Reset button (push button) ⚫ Used to reset the module Emergency download Used to configure the module communication with different devices via PCIe signals Used to switch between SD card and eMMC Used for codec configuration RG200U&RG500U_Series_5G_EVB_User_Guide 40 / 49 5G Module Series OFF ON S0301 power switch S2501 SDIO configuration switch Figure 30: Switches S0301 and S2501 S0201 reset button S1501 PCIE configuration switch Figure 31: Switch S1501 and Button S0201 S0202 module power key Figure 32: Buttons S0202 and S0203 RG200U&RG500U_Series_5G_EVB_User_Guide 41 / 49 S2801 codec configuration switch MODEM: codec connected to the module AP: codec connected to the AP 5G Module Series Figure 33: Switch S2801 4.13. Test points The EVB provides test points which help you obtain the corresponding waveforms of some signals. The following figures show the details of all test points. J0804 1 2 3 4 5 6 J0103 54 3 21 Figure 34: Test Points of J0103 and J0804 J0301 2 1 2 46 J0304 39 Figure 35: Test Points of J0301 and J0304 RG200U&RG500U_Series_5G_EVB_User_Guide 42 / 49 5G Module Series J0401 1234 Figure 36: Test Points of J0401 Table 23: Pin Definition of Test Points J0804 Pin No. Pin Name 1 I2S_WS 2 I2S_DIN 3 I2S_DOUT 4 I2S_SCK 5 I2S_MCLK 6 GND J0103 Pin No. Pin Name 1 SPI1_MOSI 2 SPI1_CS 3 SPI1_CLK 4 SPI1_MISO 5 GND Module Pin No. RG200U-CN: 20 RG500U series: 259 RG200U-CN: 18 RG500U series: 257 RG200U-CN: 17 RG500U series: 255 RG200U-CN: 19 RG500U series: 256 - - Description I2S word select I2S data in I2S data out I2S clock I2S main clock Ground Module Pin No. RG200U-CN: 171 RG500U series: 204 RG200U-CN: 170 RG500U series: 207 RG200U-CN: 169 RG500U series: 210 RG200U-CN: 172 RG500U series: 213 - Description SPI master-out slave-in SPI chip select SPI clock SPI master-in slave-out Ground RG200U&RG500U_Series_5G_EVB_User_Guide 43 / 49 5G Module Series J0301 Pin No. Pin Name Module Pin No. Description VCC_3V8_ 1 - MODULE 3.8 V module power supply test pin RG200U-CN: 6, 7, 8, 9, 23, 24, 25, 26 RG500U series: 107, 2 VBAT_MODULE Module power supply test pin 109, 110, 112, 229, 230, 232, 233, 235, 236, 238 J0304 Pin No. Pin Name Module Pin No. Description 2 3.8V_EN - 3.8 V enable test pin 3 DTR_TEST - DTR test pin 4 RESET_3.3V - 3.3 V RESET test pin 6 PWRKEY_3.3V - 3.3 V PWRKEY test pin 9 RTS_TEST - RTS test pin J0401 Pin No. Pin Name Module Pin No. Description 1 ADAPTER - Adapter test pin 2 REG_3V3 - VCC_3V8_ 3 - MODULE 4 GND - 3.3 V power supply test pin 3.8 V module power supply test pin Ground RG200U&RG500U_Series_5G_EVB_User_Guide 44 / 49 5G Module Series 5 Operation Procedures This chapter introduces how to use the RG200U & RG500U Series 5G EVB for testing and evaluating applicable modules. Before starting the procedures below, please ensure modules and the EVB are correctly assembled. 5.1. Turn on the Module 1. Connect the module TE-A to the EVB via connectors J0101 and J0102. 2. Insert a (U)SIM card into the USIM1 card connector J1401 on EVB. 3. Use RF cables to connect the module TE-A to the EVB, and connect antennas to the EVB. 4. Connect the EVB to a 5 V/ 3 A power, then switch S0301 to the 'ON' side. Then D0201 (power supply ON/OFF indicator) will light up, which indicates that the power supply for the whole EVB is ready. 5. Press the PWRKEY S0202 for at least 1200 ms, then the module will be turned on and D0202 (module operation status indicator) will light up. NOTE Turning on the module should be performed only after the EVB assembling is completed to avoid any possible damage. 5.2. Turn off the Module There are two methods to turn off the module. ⚫ Turn off the module with AT command AT+QPOWD=1. This is a safer method. The module will log off from the network and save data before shutdown. ⚫ Turn off the module with PWRKEY button (S0202). Long press PWRKEY for at least 800 ms and then release, the module will be turned off. RG200U&RG500U_Series_5G_EVB_User_Guide 45 / 49 5G Module Series 5.3. Communication via USB 1. Turn on the module according to the procedure in Chapter 5.1. 2. Connect the EVB and a PC with USB cable through USB Type-C interface, and then run the driver disk on the PC to install the USB driver. For details about USB driver installation, please refer to document [2]. The USB port numbers can be viewed in Device Manager of the PC when the USB driver is installed, as shown below. Figure 37: USB Ports 3. Install and then use QCOM provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting of QCOM: select the correct 'COM Port' (USB AT Port, which is shown in figure above) and set correct 'Baudrate' (e.g. 115200 bps). For more details about QCOM usage and configuration, please refer to document [3]. Figure 38: COM Port Setting Field on QCOM (USB AT Port Connection) 5.4. Firmware Upgrade Firmware of the module is upgraded via USB port by default, and there are two methods for the upgrade: emergency download and normal download. Please refer to the following procedures to upgrade firmware through the EVB. RG200U&RG500U_Series_5G_EVB_User_Guide 46 / 49 5G Module Series 5.4.1. Emergency Download 1. Install the firmware upgrade tool QFlash on PC. 2. Connect the EVB and the PC through USB Type-C cable. 3. Press the USB_BOOT button (S0203). 4. Insert the DC power adapter and turn on the module. 5. Upgrade the firmware with QFlash. Please refer to document [4] for details about the use of QFlash. 5.4.2. Normal Download 1. Turn on the module according to the procedure in Chapter 5.1. 2. Wait for the USB port to be found in Device Manage of the PC. 3. Send AT+QDOWNLOAD=1 through the AT port. Then, the SPRD U2S Diag port will come out as below. Figure 39: SPRD U2S Diag Port 4. Open QFlash and upgrade the firmware. Please refer to document [4] for the detailed procedures. 5.5. Reset the Module Reset is only used in case of emergency or abnormality. For example, the software fails to respond for more than 5 seconds due to some serious problems. Long pressing the RESET button S0201 for more than 8 seconds, and then releasing it will reset the module. Note that this operation may cause loss of information in the memory as the module will be initialized after the resetting. RG200U&RG500U_Series_5G_EVB_User_Guide 47 / 49 6 Appendix References Table 24: Related Documents Document Name [1] Quectel_List_of_EVB_Applicable_Modules [2] Quectel_LTE&5G_Windows_USB_Driver_Installation_Guide [3] Quectel_QCOM_User_Guide [4] Quectel_QFlash_User_Guide Table 25: Terms and Abbreviations Abbreviation AGND AP BTB COM DC DI DO DRX DTX eMMC EVB Description Analog Ground Application Processor Board to Board Cluster Communication Port Direct Current Digital Input Digital Output Discontinuous Reception Discontinuous Transmission embedded Multi-Media Card Evaluation Board RG200U&RG500U_Series_5G_EVB_User_Guide 5G Module Series 48 / 49 GND GNSS I2S I/O LED MIC NC PC PCB PCIe PCM PHY PO PRX RF RTS SD SIM SPI UART USB (U)SIM Ground Global Navigation Satellite System Inter-IC Sound Input/Output Light Emitting Diode Microphone Not Connected Private Computer Printed Circuit Board Peripheral Component Interconnect Express Pulse Code Modulation Physical Layer Power Output Primary Receive Radio Frequency Request to Send Secure Digital Subscriber Identity Module Serial Peripheral Interface Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module 5G Module Series RG200U&RG500U_Series_5G_EVB_User_Guide 49 / 49

RMU500-EKNM EVB Kit User Guide 5G Module Series Version: 1.0 Date: 2021-10-13 Status: Released 5G Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. RMU500-EKNM_EVB_Kit_User_Guide 1 / 30 5G Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. RMU500-EKNM_EVB_Kit_User_Guide 2 / 30 5G Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fueling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. RMU500-EKNM_EVB_Kit_User_Guide 3 / 30 5G Module Series About the Document Revision History Version 1.0 Date 2021-09-27 2021-10-13 Author Albert XU Albert XU Description Creation of the document First official released RMU500-EKNM_EVB_Kit_User_Guide 4 / 30 5G Module Series Contents Safety Information....................................................................................................................................... 3 About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 6 Figure Index ................................................................................................................................................. 7 1 Introduction .......................................................................................................................................... 8 1.1. Applicable Modules....................................................................................................................... 8 2 General Overview................................................................................................................................. 9 2.1. Key Features................................................................................................................................. 9 2.2. Component Placement of the EVB ............................................................................................. 10 2.3. Top and bottom View of the EVB ............................................................................................... 11 2.4. EVB Kit Accessories ................................................................................................................... 12 3 Interface Application ......................................................................................................................... 13 3.1. Power Supply (J101/J301).......................................................................................................... 13 3.2. M.2 Interface (J201).................................................................................................................... 14 3.3. USB Interface (J301) .................................................................................................................. 15 3.4. (U)SIM Interface (J401) .............................................................................................................. 16 3.5. Status Indicator (D104/D107) ..................................................................................................... 17 3.6. RF Cables and Antennas............................................................................................................ 18 3.6.1. Antenna Design.............................................................................................................. 18 3.6.2. Antenna Efficiency ......................................................................................................... 19 3.6.3. Antenna Specification .................................................................................................... 20 4 EVB Operation Procedures............................................................................................................... 22 4.1. Component Assembling Steps ................................................................................................... 22 4.2. Turn On the Module .................................................................................................................... 26 4.3. Communication Via USB Interface ............................................................................................. 26 4.4. Firmware Upgrade ...................................................................................................................... 27 4.5. Turn Off the Module .................................................................................................................... 28 5 Appendix References ........................................................................................................................ 29 RMU500-EKNM_EVB_Kit_User_Guide 5 / 30 5G Module Series Table Index Table 1: Applicable Modules ........................................................................................................................ 8 Table 2: Key Features .................................................................................................................................. 9 Table 3: Interfaces of the EVB ................................................................................................................... 10 Table 4: List of Accessories ....................................................................................................................... 12 Table 5: Pin Definition of J401 ................................................................................................................... 17 Table 6: Description of Status Indicator LEDs ........................................................................................... 18 Table 7: Antenna Specification .................................................................................................................. 20 Table 8: Related Documents...................................................................................................................... 29 Table 9: Terms and Abbreviations ............................................................................................................. 29 RMU500-EKNM_EVB_Kit_User_Guide 6 / 30 5G Module Series Figure Index Figure 1: Component Placement of the EVB (Top View) .......................................................................... 10 Figure 2: EVB Top View ............................................................................................................................. 11 Figure 3: EVB Bottom View........................................................................................................................ 11 Figure 4: EVB Power Supply Interfaces..................................................................................................... 13 Figure 5: M.2 Connector of the EVB .......................................................................................................... 14 Figure 6: USB Connector ........................................................................................................................... 15 Figure 7: Connection Between PC and EVB ............................................................................................. 15 Figure 8: Simplified Connection Schematic for (U)SIM Card Connector J401.......................................... 16 Figure 9: Pin Assignment of (U)SIM Card Connector J401....................................................................... 16 Figure 10: Status Indicators ....................................................................................................................... 17 Figure 11: Reference Design for Antennas ............................................................................................... 18 Figure 12: Antenna Efficiency at 700–960 MHz and 1.7–6 GHz ............................................................... 19 Figure 13: Antenna Efficiency at 1.7–6 GHz.............................................................................................. 19 Figure 14: RM500Q-CN/RM500Q-GL RF cable Sequence....................................................................... 20 Figure 15: RM500Q-AE/RM502Q-AE RF Cable Sequence ...................................................................... 21 Figure 16: Assembling (Step One)............................................................................................................. 22 Figure 17: Assembling (Step Two)............................................................................................................. 23 Figure 18: Assembling (Step Three) .......................................................................................................... 23 Figure 19: RM500Q-CN/RM500Q-GL RF Cable Assembly ...................................................................... 24 Figure 20: RM500Q-AE/RM502Q-AE RF Cable Assembly....................................................................... 24 Figure 21: Assembling (Step Four) ............................................................................................................ 25 Figure 22 Assembling (Step Five).............................................................................................................. 25 Figure 23: Assembled EVB Kit................................................................................................................... 26 Figure 24: USB Ports ................................................................................................................................. 27 Figure 25: COM Port Setting Field on QCOM (USB AT Port Connection)................................................ 27 Figure 26: Configurations for Firmware Upgrade ...................................................................................... 28 RMU500-EKNM_EVB_Kit_User_Guide 7 / 30 5G Module Series 1 Introduction This document introduces the EVB kit, RMU500-EKNM, for Quectel 5G M.2 modules, which is an assistant tool kit for engineers to develop and test the modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series 5G Models RM500Q-CN RM500Q-GL RM500Q-AE RM502Q-AE RMU500-EKNM_EVB_Kit_User_Guide 8 / 30 5G Module Series 2 General Overview Quectel provides the RMU500-EKNM EVB kit for engineers to develop applications based on 5G M.2 modules and to test basic functionalities of the applicable modules. 2.1. Key Features Table 2: Key Features Features Power Supply M.2 Interface (U)SIM Interface USB Interface Status Indication Physical Characteristics Description DC power supply: +5 V/ 2.5 A for the EVB Interface to mount applicable 5G M.2 modules Support 1.8/2.95 V (U)SIM card ⚫ USB Type-C Interface ⚫ USB 2.0 & USB 3.1 2 LEDs available for signal indication Size: 100 mm × 60 mm RMU500-EKNM_EVB_Kit_User_Guide 9 / 30 2.2. Component Placement of the EVB 5G Module Series C207 J201 J301 Shielding Cover C209 C208 J101 Shielding Cover D104 D107 C206 J401 Type-B Figure 1: Component Placement of the EVB (Top View) Table 3: Interfaces of the EVB Interfaces Power Supply M.2 Interface Reference Designator J101 (Power Jack) J201 USB Interface J301 (U)SIM Interface J401 Indication LEDs D104 (POWER_LED) D107 (WWAN_LED) Description The power jack on the EVB Typical supply voltage: +5 V/ 2.5 A The M.2 connecter for the module USB Type-C interface used for: ⚫ data transmission ⚫ power supply (typical supply voltage: +5 V/ 2 A) (U)SIM card connector Power indicator, indicating whether the module’s power supply is ready RF status indicator for the module RMU500-EKNM_EVB_Kit_User_Guide 10 / 30 2.3. Top and bottom View of the EVB The following figure shows the top view of the EVB. 5G Module Series Figure 2: EVB Top View The following figure shows the bottom view of the EVB. Figure 3: EVB Bottom View RMU500-EKNM_EVB_Kit_User_Guide 11 / 30 2.4. EVB Kit Accessories 5G Module Series Table 4: List of Accessories Item Description Quantity (pcs) Type-C to dual Type-A cable 1 Cable RF cables 4 Antenna Antennas with brackets 4 Soft silicone pad Thermal conductive pad 1 Heatsink USB flash drive Screw Black anodized AL6063 1 Including the related documents, tools, and drivers for the 1 module and RMU500-EKNM. Used to clamp the module, antennas and heatsink on the EVB 19 NOTE NONE of the applicable 5G M.2 modules are included as accessories of the RMU500-EKNM EVB kit. RF cables, heatsink, soft silicone pad, and screws are included as accessories. RMU500-EKNM_EVB_Kit_User_Guide 12 / 30 5G Module Series 3 Interface Application This chapter describes the following hardware interfaces of RMU500-EKNM: ⚫ Power supply (J101/J301) ⚫ M.2 interface (J201) ⚫ USB interface (J301) ⚫ (U)SIM interface (J401) ⚫ RF cables and antennas It also provides information about the status indicator LEDs (D104/D107) to help you use the EVB. 3.1. Power Supply (J101/J301) The EVB is powered by an external power adapter through the power jack (J101) on the EVB. It can also be powered by the USB interface (J301, referring to Chapter 3.3). The following figure shows the power supply interfaces of the EVB. J301 J101 Figure 4: EVB Power Supply Interfaces RMU500-EKNM_EVB_Kit_User_Guide 13 / 30 5G Module Series 3.2. M.2 Interface (J201) The M.2 connector is designed to accommodate the module. The following figure shows the M.2 connector on the EVB. J201 M.2 Connector Figure 5: M.2 Connector of the EVB RMU500-EKNM_EVB_Kit_User_Guide 14 / 30 5G Module Series 3.3. USB Interface (J301) The EVB provides a Type-C USB connector (J301) for the connection with a host. Type-C USB can be used for data transmission. Also, it can be used as power supply interface to power on the EVB. J301 USB Connector Figure 6: USB Connector Figure 7: Connection Between PC and EVB RMU500-EKNM_EVB_Kit_User_Guide 15 / 30 5G Module Series One end of Type-A is connected to the computer, and, when necessary (e.g., when power supply from the Type-A connected to the PC is inadequate), the other end is connected to the auxiliary power supply. 3.4. (U)SIM Interface (J401) The EVB has an 8-pin push-push type (U)SIM card (1.8/2.95 V) connector (J401). The following figure shows a simplified connection schematic for the (U)SIM card connecter. Module USIM_VDD USIM_RST USIM_CLK USIM_DATA USIM_DET GND Push-Push C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK C7 USIM_DATA (U)SIM card connector C4 RESERVED C8 RESERVED CD USIM_DET J401 Figure 8: Simplified Connection Schematic for (U)SIM Card Connector J401 The figure and table below illustrate the pin assignment and pin definition of (U)SIM card connector. CD C8 C4 C7 C3 C6 C2 C5 C1 J401 Figure 9: Pin Assignment of (U)SIM Card Connector J401 RMU500-EKNM_EVB_Kit_User_Guide 16 / 30 Table 5: Pin Definition of J401 Pin No. C1 C2 C3 C4 C5 C6 C7 C8 CD Pin Name USIM_VDD USIM_RST USIM_CLK RESERVED GND VPP USIM_DATA RESERVED USIM_DET 5G Module Series I/O Function PO (U)SIM card power supply DO (U)SIM card reset DO (U)SIM card clock - Not connected - Ground - Not connected DIO (U)SIM card data - Not connected DI (U)SIM card detection 3.5. Status Indicator (D104/D107) The EVB provides two status indicator LEDs (D104 and D107). The following figure shows the positions of these indicators. D104 D107 Figure 10: Status Indicators RMU500-EKNM_EVB_Kit_User_Guide 17 / 30 5G Module Series Table 6: Description of Status Indicator LEDs Reference Designator D104 (POWER_LED) D107 (WWAN_LED) Description Power indicator, indicating whether the module’s power supply is ready. Light on: power on Light off: power off RF status indicator for the module. Light on: RF function is enabled Light off: RF function is disabled 3.6. RF Cables and Antennas 3.6.1. Antenna Design The following figure is a typical reference design for antennas of the EVB kit. Module ANT R1 0 R C1 C2 NM NM Figure 11: Reference Design for Antennas The matching circuit is composed of C1, C2 and R1 for antenna impedance modification. The value of R1 is 0 Ω, while C1 and C2 are not mounted by default. RMU500-EKNM_EVB_Kit_User_Guide 18 / 30 3.6.2. Antenna Efficiency 5G Module Series Figure 12: Antenna Efficiency at 700–960 MHz and 1.7–6 GHz Figure 13: Antenna Efficiency at 1.7–6 GHz NOTE All measurements are done for the antennas of the RMU500-EKNM EVB kit with Agilent E5071C ENA network analyzer and OTA chamber. RMU500-EKNM_EVB_Kit_User_Guide 19 / 30 5G Module Series 3.6.3. Antenna Specification The specification of antennas is provided in the following table. Table 7: Antenna Specification Antenna Ant 0 Ant 1 Ant 2 Ant 3 Specification Frequency Range: 0.7–6 GHz Input Impedance: 50 Ω Frequency Range: 1.7–6 GHz Input Impedance: 50 Ω Frequency Range: 1.7–6 GHz Input Impedance: 50 Ω Frequency Range: 0.7–6 GHz Input Impedance: 50 Ω The cable assembly varies when different modules are used with this EVB kit. The installations for RM500Q-CN and RM500Q-GL are the same, so does that for RM500Q-AE and RM502Q-AE). The following figures illustrate these cable connections. Figure 14: RM500Q-CN/RM500Q-GL RF cable Sequence RMU500-EKNM_EVB_Kit_User_Guide 20 / 30 5G Module Series Figure 15: RM500Q-AE/RM502Q-AE RF Cable Sequence NOTE 1. Ant 0–3 have been assembled on the EVB to prevent damage during transportation. 2. The RM500Q-CN module, which supports GNSS L1 + L5, cannot support L5 in this case because the frequency range of Ant 1 is 1.7–6 GHz. RMU500-EKNM_EVB_Kit_User_Guide 21 / 30 5G Module Series 4 EVB Operation Procedures This chapter introduces how to assemble and use the RMU500-EKNM EVB kit to test and evaluate the module. 4.1. Component Assembling Steps Please follow these steps to assemble the product. Step 1: Remove the antennas one by one, and keep the antennas and screws. Figure 16: Assembling (Step One) RMU500-EKNM_EVB_Kit_User_Guide 22 / 30 5G Module Series Step 2: Attach the thermal conductive pad, insert the module, and lock the screw. Figure 17: Assembling (Step Two) Step 3: Insert four RF cables. There are two RF cable assembling methods when the EVB kit is used with different modules. Figure 18: Assembling (Step Three) RMU500-EKNM_EVB_Kit_User_Guide 23 / 30 5G Module Series Figure 19: RM500Q-CN/RM500Q-GL RF Cable Assembly Figure 20: RM500Q-AE/RM502Q-AE RF Cable Assembly RMU500-EKNM_EVB_Kit_User_Guide 24 / 30 Step 4: Place the heatsink on the module and tighten the screws. 5G Module Series Figure 21: Assembling (Step Four) Step 5: Assemble the antenna in turn and tighten the screws. Figure 22 Assembling (Step Five) RMU500-EKNM_EVB_Kit_User_Guide 25 / 30 Then, the assembly is finished. The assembled EVB kit is shown below. 5G Module Series Figure 23: Assembled EVB Kit 4.2. Turn On the Module 1. Finish the assembling steps above. 2. Insert a (U)SIM card into the (U)SIM card connector on the EVB. 3. Insert the USB cable (Type-C to dual Type-A). Connect the type-C end to the EVB, one Type-A end to the computer, and the other Type-A end to an auxiliary power supply. The module will be turned on automatically when the EVB is powered through the USB interface (J301) or the power jack (J101). 4.3. Communication Via USB Interface 1. Power on the module according to the procedure in Chapter 4.1. 2. When the EVB is connected to a PC with the USB Type-C cable through the USB interface, run the USB driver disk on the PC to install the USB driver. For details about USB driver installation, see document [1]. The USB port numbers can be viewed in Device Manager of the PC when the USB driver is installed, as shown below. RMU500-EKNM_EVB_Kit_User_Guide 26 / 30 5G Module Series Figure 24: USB Ports 3. Install and then use QCOM provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting of QCOM: select correct 'COM Port' (USB AT Port which is shown in the figure above) and set correct 'Baudrate' (e.g. 115200 bps). For more details about QCOM usage and configuration, see document [2]. Figure 25: COM Port Setting Field on QCOM (USB AT Port Connection) 4.4. Firmware Upgrade Firmware of the module is upgraded via USB port by default, please follow the procedures below to upgrade the firmware. 1. Install and open the firmware upgrade tool, QFlash, on the PC and then turn on the module according to the procedures in Chapter 4.2. 2. Click the 'COM Port' dropdown list and select the Port No. corresponding to 'Quectel USB DM Port' in the Device Manager. 3. Click the 'Load FW Files' button and choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. RMU500-EKNM_EVB_Kit_User_Guide 27 / 30 5G Module Series Figure 26: Configurations for Firmware Upgrade For more details about QFlash usage and configuration, see document [3]. 4.5. Turn Off the Module There are two methods to turn off the module. ⚫ Hardware method: the module will be turned off after the power supply is disconnected. ⚫ Software method: the module can be turned off with AT+QPOWD command, which is a preferred and safer method. The module will log off from the network and save data before shutdown. RMU500-EKNM_EVB_Kit_User_Guide 28 / 30 5G Module Series 5 Appendix References Table 8: Related Documents Document Name [1] Quectel_LTE&5G_Windows_USB_Driver_Installation_Guide [2] Quectel_QCOM_User_Guide [3] Quectel_QFlash_User_Guide [4] Quectel_RG50xQ&RM5xxQ_Series_AT_Commands_Manual Table 9: Terms and Abbreviations Abbreviation COM DC DI DO EVB GND I/O LED NC PC PCB Description Communication Port Direct Current Digital Input Digital Output Evaluation Board Ground Input/Output Light Emitting Diode Not Connected Personal Computer Printed Circuit Board RMU500-EKNM_EVB_Kit_User_Guide 29 / 30 PO RF SD SIM UART USB (U)SIM 5G Module Series Power Output Radio Frequency Secure Digital Subscriber Identity Module Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module RMU500-EKNM_EVB_Kit_User_Guide 30 / 30

PCIe Card EVB User Guide LTE-A&5G Module Series Version: 1.1 Date: 2020-12-26 Status: Released www.quectel.com LTE-A&5G Module Series PCIe Card EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. PCIe_Card_EVB_User_Guide 1 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved.. PCIe_Card_EVB_User_Guide 2 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide About the Document Revision History Version Date 1.0 2020-09-15 Author Archibald JIANG 1.1 2020-12-26 Archibald JIANG Description Initial 1. Deleted the EM161R-GL in Table 1. 2. Added the switch S104 in Chapter 2.1, Chapter 2.2 and Chapter 4.6. 3. Updated Figures 1, 4, 6, 8, 15, 16, 19, and 31. PCIe_Card_EVB_User_Guide 3 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 1.1. Safety Information ...................................................................................................................... 8 2 General Overview................................................................................................................................ 9 2.1. Key Features .............................................................................................................................. 9 2.2. Interface Overview ................................................................................................................... 10 2.3. Top View of PCIe Card EVB .................................................................................................... 12 2.4. EVB Kit Accessories ................................................................................................................ 13 3 EVB and Accessories Assembly..................................................................................................... 15 4 Interface Application ........................................................................................................................ 16 4.1. Power Supply (J801/J401/J803/J501) ..................................................................................... 16 4.2. M.2 Interface (J101) ................................................................................................................. 18 4.3. USB Interface (J401) ............................................................................................................... 18 4.4. (U)SIM Interfaces (J301/J302)................................................................................................. 21 4.5. UART Interface (J601) ............................................................................................................. 22 4.6. Switches and Button (S101/S102/S103/S104*) ...................................................................... 24 4.7. Status Indicators (D101/D102)................................................................................................. 25 4.8. Test Points (J102/J103/J602/J603/J802)................................................................................. 26 5 Operation Procedures Illustration................................................................................................... 29 5.1. Power on the Module ............................................................................................................... 29 5.2. Communication ........................................................................................................................ 30 5.2.1. Communication via USB Type-B Interface ................................................................... 30 5.2.2. Communication Via PCIe Interface............................................................................... 31 5.3. Firmware Upgrade ................................................................................................................... 32 5.3.1. USB Firmware Upgrade via USB.................................................................................. 32 5.3.2. Firmware Upgrade via PCIe.......................................................................................... 33 5.4. Reset the Module ..................................................................................................................... 35 5.5. Power off the Module ............................................................................................................... 35 5.6. Current Consumption Test ....................................................................................................... 36 6 Appendix References ....................................................................................................................... 37 PCIe_Card_EVB_User_Guide 4 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide Table Index Table 1: Applicable Modules......................................................................................................................... 7 Table 2: Key Features of PCIe Card EVB .................................................................................................... 9 Table 3: Component Functions of PCIe Card EVB .................................................................................... 10 Table 4: Accessories List ............................................................................................................................ 13 Table 5: Pin Assignment of J401 ................................................................................................................ 19 Table 6: Pin Definition of J301/302 ............................................................................................................ 21 Table 7: Pin Definition of J601.................................................................................................................... 23 Table 8: Description of Switches and Button ............................................................................................. 24 Table 9: Description of Status Indicators.................................................................................................... 25 Table 10: Pin Definition of J102, J103, J602, J603 and J802.................................................................... 27 Table 11: Indication of D101 and D102 ...................................................................................................... 29 Table 12: Related Documents .................................................................................................................... 37 Table 13: Terms and Abbreviations ............................................................................................................ 37 PCIe_Card_EVB_User_Guide 5 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide Figure Index Figure 1: Overview of PCIe Card EVB Interface........................................................................................ 10 Figure 2: PCIe Card EVB Top View ........................................................................................................... 12 Figure 3: EVB Kit Accessories ................................................................................................................... 13 Figure 4: PCIe Card EVB and Accessories Assembly ............................................................................... 15 Figure 5: EVB Power Supply Block Diagram ............................................................................................. 16 Figure 6: EVB Power Supply Interface ...................................................................................................... 17 Figure 7: Power Plug Design ..................................................................................................................... 17 Figure 8: Connection between the Module and the EVB........................................................................... 18 Figure 9: Pin Assignment of J401 .............................................................................................................. 19 Figure 10: Diagram for Module and USB Type-B Receptacle Connection................................................ 20 Figure 11: Pin Assignment of J301 and J302 ............................................................................................ 21 Figure 12: Simplified Interface Schematic for (U)SIM Card Connector..................................................... 21 Figure 13: UART Block Diagram ................................................................................................................ 22 Figure 14: Pin Assignment of J601 ............................................................................................................ 23 Figure 15: Switch S101 and Button S102 .................................................................................................. 24 Figure 16: Switch S103 .............................................................................................................................. 24 Figure 17: Status Indicators ....................................................................................................................... 25 Figure 18: Test Points of J102 and J103.................................................................................................... 26 Figure 19: Test Points of J602 J603 and J802........................................................................................... 26 Figure 20: USB Ports ................................................................................................................................. 30 Figure 21: COM Port Setting Field on QCOM (USB AT Port Connection) ................................................ 30 Figure 22: EVB and Desktop Computer Connection via PCIe Interface ................................................... 31 Figure 23: PCIe Ports................................................................................................................................. 31 Figure 24: COM Port Setting Field on QCOM (AT Port Connection) ........................................................ 32 Figure 25: Configurations for Firmware Upgrade ...................................................................................... 32 Figure 26: First Step of Firmware Upgrade via PCIe ................................................................................. 33 Figure 27: Second Step of Firmware Upgrade via PCIe............................................................................ 33 Figure 28: Third Step of Firmware Upgrade via PCIe................................................................................ 34 Figure 29: Fourth Step of Firmware Upgrade via PCIe ............................................................................. 34 Figure 30: Location of R814....................................................................................................................... 36 Figure 31: Location of J803........................................................................................................................ 36 PCIe_Card_EVB_User_Guide 6 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 1 Introduction This document introduces Quectel evaluation board for PCIe cards, the assistant tool for engineers to develop and test Quectel modules, and how to use it. Table 1: Applicable Modules Module Series LTE-Advanced 5G Applicable Modules EM120R-GL/ EM121R-GL/ EM160R-GL RM500Q Series/ RM510Q-GL NOTE Quectel modules listed above may include multiple models. Please refer to the corresponding module Specifications for more specific information. PCIe_Card_EVB_User_Guide 7 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 1.1. Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating Quectel modules. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergent help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as mobile phone or other cellular terminals. Areas with potentially explosive atmospheres include fueling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders. PCIe_Card_EVB_User_Guide 8 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 2 General Overview Quectel supplies PCIe Card EVB to engineers to help with the application development. This chapter offers an overview of this EVB. 2.1. Key Features The following table describes the detailed features of PCIe Card EVB. Table 2: Key Features of PCIe Card EVB Features Description M.2 Interface (U)SIM Interfaces UART Interface Standard PCI Express M.2 interface Support (U)SIM card insertion detection Support (U)SIM card: 3.0/1.8 V UART interface for debugging purpose USB Interface USB Type-B (USB 2.0 and USB 3.0) Status Indication 2 LEDs available for signal indication Switches and Button Switches: Power Switch (S103), PWRKEY (S101), PCIe/USB Switch* (S104) Button: RESET (S102) Physical Characteristics Size: 101.8 mm × 112.0 mm NOTE '*' means under development. Currently the PCIe/USB Switch does not work no matter to which side the switch is switched. PCIe_Card_EVB_User_Guide 9 / 38 2.2. Interface Overview LTE-A&5G Module Series PCIe Card EVB User Guide S104 J501 J802 J101 Power Switch S103 ANT_MAIN (U)SIM1 J301 J603 (U)SIM2 J302 J602 M.2 Module ANT_MIMO1 J103 J102 WWAN_LED POWER ANT_MIMO2 D102 D101 J601 DBG_UART USB Type-B J401 ANT_DIV S102 J803 J801 S101 RESET EX_Power Power Supply PWRKEY Figure 1: Overview of PCIe Card EVB Interface Table 3: Component Functions of PCIe Card EVB Functions Power Supply 1) Reference No. J801 J401 Description The power jack on the EVB Typical supply voltage: +5 V USB Type-B interface Typical supply voltage: +5 V PCIe_Card_EVB_User_Guide 10 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide Power Switch PWRKEY RESET PCIe/USB Switch* USB Type-B (U)SIM1 (U)SIM2 UART Status Indicators Connectors Test Points J803 J501 S103 S101 S102 S104 J401 J301 J302 J601 D101 D102 J101 J501 J102, J103, J602, J603, J802 External power supply Typical supply voltage: +3.7 V PCIe card interface Typical supply voltage: +3.3 V VCC ON/OFF control Power key Turn on/off the module Reset button (push button) Reset the module PCIe/USB interface Switch USB device interface Supply power for the EVB (U)SIM card connector 1 (U)SIM card connector 2 Debug UART port Indicate power ON/OFF status of the EVB Indicate whether RF function is enabled or not M.2 standard connector for the module PCIe Card connector for the EVB Test pins NOTES 1. 1) The power supply information in the table above is for the module. Refer to Chapter 4.1 for detailed information about the power supply, 2. '*' means under development. Currently the PCIe/USB Switch does not work no matter to which side the switch is switched. PCIe_Card_EVB_User_Guide 11 / 38 2.3. Top View of PCIe Card EVB The top view of the PCIe Card EVB is shown below. LTE-A&5G Module Series PCIe Card EVB User Guide Figure 2: PCIe Card EVB Top View PCIe_Card_EVB_User_Guide 12 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 2.4. EVB Kit Accessories All accessories of the PCIe Card EVB kit are listed as below. Antennas USB to RS-232 Converter Cable Instruction Sheet Power Adapter Silicone Soft Pad Adapter plug CN Driver Disk RF Cables Adapter plug BS Adapter plug EU Bolts and Nuts Adapter plug US USB Type-B Cable Figure 3: EVB Kit Accessories Heatsink Table 4: Accessories List Items Cables Antennas Description USB to UART converter cable USB Type-B cable RF cables Antennas Quantity 1 1 4 4 PCIe_Card_EVB_User_Guide 13 / 38 Driver disk Silicone soft pad Others Instruction sheet Heat sink Power adapter Adapter plug LTE-A&5G Module Series PCIe Card EVB User Guide ⚫ USB 2.0 to RS-232 driver ⚫ USB driver 1 ⚫ QUD driver and UDE driver ⚫ Related tools for modules Thermal conductive gasket 1 Bolts and nuts for EVB assembling One-sheet instruction manual for the EVB connection, details of EVB accessories, etc. 4 + 4 for the EVB, 6 for the module and heat sink 1 Heat sink above the module 1 Power adapter 5 V/ 3 A 1 Adapter plug type BS 1 Adapter plug type EU 1 Adapter plug type US 1 Adapter plug type CN 1 NOTE The four antennas are identical and each of them can be used for main, diversity and GNSS reception. PCIe_Card_EVB_User_Guide 14 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 3 EVB and Accessories Assembly The following figure shows the assembly of the EVB and its accessories. Figure 4: PCIe Card EVB and Accessories Assembly PCIe_Card_EVB_User_Guide 15 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 4 Interface Application This chapter describes the following hardware interfaces, as well as the switches, button, status indicators and test points, of the PCIe Card EVB: ⚫ Power supply ⚫ M.2 interface ⚫ USB interface ⚫ (U)SIM interfaces ⚫ UART interface 4.1. Power Supply (J801/J401/J803/J501) The PCIe Card EVB can be powered by an external power adapter through the power jack (J801) or USB Type-B receptacle (J401) on the EVB. The power adapter is designed to be connected to a step-down converter that converts the supplied voltage into proper voltage (VCC) for the module. The power can also be supplied by inserting the EVB J501 into PCIe Card slot of the desktop computer. The module can be directly powered by an external power source through connecting with the power jack (J803), and this type of power supply is generally used for current consumption test. The following two figures show the simplified power supply block diagram and the power interface of Quectel PCIe Card EVB. J401 USB Type-B interface J501 PCIe interface Step-down U802 converter TPS54319 VCC J801 Power supply S103 VCC Power switch U203 LDO VCC_ MODULE U201 LDO 3.3 V J803 EX_POWER Power supply for M.2 module 1.8 V Figure 5: EVB Power Supply Block Diagram PCIe_Card_EVB_User_Guide 16 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 3.7 V DC Power Supply 5 V DC Power Supply 3.3 V DC Power Supply Figure 6: EVB Power Supply Interface When using the power jack for power supply, the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 7: Power Plug Design PCIe_Card_EVB_User_Guide 17 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 4.2. M.2 Interface (J101) The M.2 interface is designed to accommodate the modules. The module is connected to the EVB via BTB connector J101. This interface allows customers to easily test functionalities of the module or develop applications based on the module. The following figure shows the connection between the module and the EVB. Figure 8: Connection between the Module and the EVB 4.3. USB Interface (J401) The PCIe Card EVB provides a USB Type-B receptacle J401 for the connection with a host device. The VBUS lines can be used for USB connection detection and EVB power supply. PCIe_Card_EVB_User_Guide 18 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 9 8 7 65 1 4 11 2 3 10 Figure 9: Pin Assignment of J401 Table 5: Pin Assignment of J401 Pin No. 1 2 3 4 5 6 7 8 9 10 11 Pin Name VBUS USB_DM USB_DP GND TX- TX+ GND RX- RX+ GND GND PCIe_Card_EVB_User_Guide 19 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide The following figure shows the connection of the module and the USB Type-B receptacle. Module USB_SS_TX_M J401 TX+ USB_SS_TX_P TX- USB_SS_RX_M USB_SS_RX_P RX+ RX- USB_DP USB_DM R1 0R R2 0R ESD USB_DP USB_DM USB Type-B Figure 10: Diagram for Module and USB Type-B Receptacle Connection PCIe_Card_EVB_User_Guide 20 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 4.4. (U)SIM Interfaces (J301/J302) The PCIe Card EVB has two 8-pin push-push type Micro (U)SIM card (3.0/1.8 V) connectors J301 and J302. Both of them can be used for the modules. The following figure shows the pin assignment and definition of J301 and J302. J301 J302 CD C8 C4 C7 C3 C6 C2 C5 C1 CD C8 C4 C7 C3 C6 C2 C5 C1 C8 C7 C6 C5 C4 C3 C2 C1 C8 C7 C6 C5 C4 C3 C2 C1 Figure 11: Pin Assignment of J301 and J302 J101 USIM_VDD USIM_DATA USIM_CLK USIM_RST USIM_DET J301/J302 GND C1 USIM_VDD C7 USIM_DATA C3 USIM_CLK C2 USIM_RST CD USIM_DET C5 GND (U)SIM card connector Figure 12: Simplified Interface Schematic for (U)SIM Card Connector Table 6: Pin Definition of J301/302 Pin No. Pin Name I/O C1 USIM_VDD PO Description (U)SIM card power supply, provided by PCIe Card EVB PCIe_Card_EVB_User_Guide 21 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide C2 USIM_RST DO (U)SIM card reset C3 USIM_CLK DO (U)SIM card clock C4 RESERVED / Not connected C5 GND / Ground C6 VPP / Not connected C7 USIM_DATA IO (U)SIM card data C8 RESERVED / Not connected CD USIM_DET DI (U)SIM card insertion detection 4.5. UART Interface (J601) The PCIe Card EVB offers a UART interface: debug UART port J601. This UART interface supports 115200 bps baud rate by default and can be used for Linux console and log output. The following figure shows the block diagram of UART on PCIe Card EVB. COM DB9 J601 RS-232 RS-232 Level Match U601 3.0 V 3.0 V/1.8 V Transistor Level Translator U602 J602 DBG_TXD DBG_RXD 1.8 V J603 DBG_RTS DTR_TEST Figure 13: UART Block Diagram PCIe_Card_EVB_User_Guide 22 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide The figure and table below illustrate the pin assignment and pin definition of J601. 1 23 45 6 78 9 Figure 14: Pin Assignment of J601 Table 7: Pin Definition of J601 Pin No. 1 2 3 4 5 6 7 8 9 Pin Name NC DBG_TXD DBG_RXD DTR_TEST GND NC DBG_RTS NC NC I/O Description / Not connected DO Debug UART transmit DI Debug UART receive DI Data terminal ready / GND / Not connected DI Request to send / Not connected / Not connected PCIe_Card_EVB_User_Guide 23 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 4.6. Switches and Button (S101/S102/S103/S104*) The PCIe Card EVB includes two power switches (S101 and S103), a reset button (S102), and a PCIe/USB switch (S104)*, as shown in the following figures. S101 S102 Figure 15: Switch S101 and Button S102 S103 Figure 16: Switch S103 Table 8: Description of Switches and Button Reference No. S101 S102 S103 S104* Function PWRKEY RESET Power Switch PCIe/USB Switch Description Used to turn on/off the module Used to reset the module Power ON/OFF control PCIe/USB interface Switch PCIe_Card_EVB_User_Guide 24 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide NOTE '*' means under development. Currently the PCIe/USB Switch does not work no matter to which side the switch is switched. 4.7. Status Indicators (D101/D102) The PCIe Card EVB provides two status indication LEDs (D101 and D102). The following figure shows the location of these LED indicators. D101 D102 Figure 17: Status Indicators Table 9: Description of Status Indicators Reference No. D101 D102 Description Power ON/OFF indicator indicating the power supply status of the EVB Light on: the module is powered on; Light off: the power is powered off. RF status indicator for the module Light on: RF function is enabled; Light off: RF function is disabled. PCIe_Card_EVB_User_Guide 25 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 4.8. Test Points (J102/J103/J602/J603/J802) The PCIe Card EVB provides test points which help customers obtain the corresponding waveforms of some signals. The following figures show the test points of J102, J103, J602, J603 and J802. J103 J102 8 16 15 7 14 13 6 12 11 5 10 9 4 8 7 3 6 5 2 4 3 1 2 1 J603 J602 Figure 18: Test Points of J102 and J103 J802 1 2 1 2 12 Figure 19: Test Points of J602 J603 and J802 PCIe_Card_EVB_User_Guide 26 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide Table 10: Pin Definition of J102, J103, J602, J603 and J802 J102 Pin No. Pin Name 1 RFFE1_SDA 2 I2S_CLK 3 RFFE1_SCL 4 I2S_DIN 5 POWER_EN 6 I2S_DOUT 7 COEX3 8 I2S_WS 9 ANTCTL0 10 COEX2 11 ANTCTL1 12 COEX1 13 ANTCTL2 14 DPR 15 ANTCTL3 16 GND J103 Pin No. Pin Name 1 VCC_CARD 2 RESET 3 PWR_OFF# 4 DISABLE1 5 DISABLE2 Module Pin No. Description 58 RFFE data 20 Connected directly to I2S_CLK of the module 56 RFFE clock 22 Connected directly to I2S_IN of the module NA VCC enable pin 24 Connected directly to I2S_DOUT of the module 60 COEX3 28 Connected directly to I2S_WS of the module 59 Antenna tuner control 62 COEX UART transmit 61 Antenna tuner control 64 COEX UART receive 63 Antenna tuner control 25 Dynamic power reduction 65 Antenna tuner control 3, 5, 11, 27, 33, 39, 45, Ground 51, 57, 71, 73, 76, 79 Module Pin No. NA NA 6 8 26 Description EVB power supply Module reset control Turn on/off the module Airplane mode control GNSS enable control PCIe_Card_EVB_User_Guide 27 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 6 LED 10 WWAN status indicators test point 7 WAKE_ON_WAN 23 Wake up the host 8 MODULE_PIN68 68 Module pin 68 J602 Pin No. Pin Name Module Pin No. Description 1 TXD_1V8 NA TXD_1V8 2 RXD_1V8 NA RXD_1V8 J603 Pin No. Pin Name Module Pin No. Description 1 RTS_1V8 NA Connected directly to the voltage translator 2 DTR_3V3 NA Data terminal ready J802 Pin No. Pin Name Module Pin No. Description 1 VCC_MODULE 2, 4, 7, 72, 74 Module power supply 2 GND 3, 5, 11, 27, 33, 39, 45, Ground 51, 57, 71, 73, 76, 79 PCIe_Card_EVB_User_Guide 28 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 5 Operation Procedures Illustration This chapter introduces how to use the PCIe Card EVB for testing and evaluation of the module. 5.1. Power on the Module 1. Connect the module to the EVB. Insert the module into the BTB connector (J101) on the EVB, and then fix the module with screws. 2. Insert a (U)SIM card into the (U)SIM card connector on the EVB and connect the antennas to the module. 3. Connect the EVB to a 5.0 V power adapter, or connect the EVB to a PC by using a USB Type-B cable, or insert the EVB into the PCIe card slot of the desktop computer. 4. Switch S103 (Power Switch) to ON state, and then the D101 (Power ON/OFF indicator) will light up, which indicates that the power supply for the EVB is ready. In this case, switch S101 (PWRKEY) to ON state, the module will be powered on automatically, and D102 will light up when RF function is enabled. The following table shows the module status indicated by D101 and D102. Table 11: Indication of D101 and D102 Reference No. D101 D102 State Always ON Always OFF Always ON Always OFF Description VCC ON VCC OFF RF function is enabled RF function is disabled PCIe_Card_EVB_User_Guide 29 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 5.2. Communication 5.2.1. Communication via USB Type-B Interface 1. Power on the module according to the procedure mentioned in Chapter 5.1. 2. Connect the EVB and the PC with USB cable through USB Type-B interface, and then run the driver disk on PC to install the USB driver. For details about USB driver installation, please refer to document [1]. Figure 20: USB Ports 3. Install and then use the QCOM provided by Quectel to realize communication between the module and the PC. The following figure shows the settings for COM Port on QCOM: select the correct 'COM Port' (USB AT Port which is shown in the figure above) and set the correct 'Baudrate' (such as 115200 bps). For more details about QCOM usage and configuration, please refer to document [2]. Figure 21: COM Port Setting Field on QCOM (USB AT Port Connection) PCIe_Card_EVB_User_Guide 30 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 5.2.2. Communication Via PCIe Interface 1. Insert the EVB into the PCIe card slot of the desktop computer, as shown in the figure below. Then power on the module according to the procedure mentioned in Chapter 5.1. Please notice that when the EVB is inserted into the PCIe card slot of the desktop computer, do not power the EVB through other power supply interfaces. PCIe card EVB Desktop Figure 22: EVB and Desktop Computer Connection via PCIe Interface 2. Run the driver disk on PC to install the UDE driver and QUD driver. Figure 23: PCIe Ports 3. Install and then use QCOM provided by Quectel to realize communication between the module and the PC. The following figure shows the settings for COM Port on QCOM: select the correct 'COM Port' (AT Port shown in the above figure) and set the correct 'Baudrate' (such as 115200 bps). For more details about QCOM usage and configuration, please refer to document [2]. PCIe_Card_EVB_User_Guide 31 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide Figure 24: COM Port Setting Field on QCOM (AT Port Connection) 5.3. Firmware Upgrade 5.3.1. USB Firmware Upgrade via USB The firmware of the module is upgraded via USB port by default, please follow the procedures below to upgrade the firmware with the tool QFlash. 1. Install and open the firmware upgrade tool QFlash on PC and then power on the module according to the procedures in Chapter 5.1. 2. Click 'COM Port' dropdown list and select the USB DM port. 3. Click 'Load FW Files' button to choose the firmware package. 4. Click 'Start' button to start upgrading the firmware. Figure 25: Configurations for Firmware Upgrade For more details about QFlash usage and configuration, please refer to document [3]. PCIe_Card_EVB_User_Guide 32 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 5.3.2. Firmware Upgrade via PCIe To upgrade the firmware of the module via PCIe port, please follow the procedures below. 1. Use QCOM to open Diagnostic Port (COM5), and then check 'HEX String', sending HEX array: 0x4b, 0x65, 0x01, 0x00, 0x54, 0x0f, 0x7e. Figure 26: First Step of Firmware Upgrade via PCIe 2. After the above command is executed, the port shown in the following figure will show up in the Device Manger. Right click this node and select Disable. After this device node is disabled, right click it again and select Enable. Figure 27: Second Step of Firmware Upgrade via PCIe PCIe_Card_EVB_User_Guide 33 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 3. Open cmd.exe (Command Prompt) with administrator authority, then, switch to the firehose directory of the version upgrade file. Execute QBHiServer.exe to download prog_firehose_sdx24.mbn. Figure 28: Third Step of Firmware Upgrade via PCIe 4. After the above command is executed, the EDL port will show up after seconds. Figure 29: Fourth Step of Firmware Upgrade via PCIe 5. Directly call Qfirehoese.exe in CMD to execute command: Qfirehose.exe -f FW_PATH -p .COM3 -v 1 ⚫ FW_Path: the root directory of the version, that is, the parent directory of update. ⚫ COM3: EDL Port. Waiting for about 30 seconds, and the module will start to work. PCIe_Card_EVB_User_Guide 34 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 5.4. Reset the Module The RESET is only used in case of emergency. For example, the software does not respond for more than 5 seconds due to serious problems. Press the button S102 (RESET) for 250–600 ms and then release it to reset the module. However, this operation may cause the loss of information stored in the memory as the module will be reinitialized after the reset. NOTE The time for pressing the RESET button cannot exceed the maximum value, otherwise the module will be powered off. 5.5. Power off the Module There are two methods to power off the module. ⚫ Hardware shutdown: switch the S101 to OFF state and the module will be powered off. ⚫ Software shutdown: turn off the module by using AT+QPOWD command. NOTE Please refer to AT Commands Manuals of corresponding modules for details about the AT+QPOWD command. PCIe_Card_EVB_User_Guide 35 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 5.6. Current Consumption Test The PCIe Card EVB can also be used to test the current consumption of the module after modifications as follows: 1. Remove R814. R814 Figure 30: Location of R814 2. Connect an external power supply to J803 to power the module independently. J803 Figure 31: Location of J803 3. Power on the module according to the procedure mentioned in Chapter 5.1 and then test the current consumption according to specific demand. PCIe_Card_EVB_User_Guide 36 / 38 LTE-A&5G Module Series PCIe Card EVB User Guide 6 Appendix References Table 12: Related Documents SN Document Name Remark Quectel_LTE&5G_Windows_USB_Drivers_Installation_ Install USB drivers for M.2 module on [1] Guide Windows system [2] Quectel_QCOM_User_Guide User guide for QCOM tool [3] Quectel_QFlash_User_Guide User guide for QFlash tool Table 13: Terms and Abbreviations Abbreviation AGND BTB COM DC DI DO EVB GND GNSS I/O LED LTE Description Analog Ground Board to Board Communication Port Direct Current Digital Input Digital Output Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode Long Term Evolution PCIe_Card_EVB_User_Guide 37 / 38 NC PC PCB PCM PO RF UART USB (U)SIM LTE-A&5G Module Series PCIe Card EVB User Guide Not Connected Personal Computer Printed Circuit Board Pulse Code Modulation Power Output Radio Frequency Universal Asynchronous Receiver/Transmitter Universal Serial Bus (Universal) Subscriber Identity Module PCIe_Card_EVB_User_Guide 38 / 38

M.2-FPC EVB User Guide 5G & LTE-A Module Series Version: 1.0 Date: 2023-02-17 Status: Released 5G & LTE-A Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. M.2-FPC_EVB_User_Guide 1 / 41 5G & LTE-A Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. M.2-FPC_EVB_User_Guide 2 / 41 5G & LTE-A Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. M.2-FPC_EVB_User_Guide 3 / 41 5G & LTE-A Module Series About the Document Revision History Version 1.0 Date 2022-01-16 2023-02-17 Author Fung ZHU Fung ZHU Description Creation of the document First official release M.2-FPC_EVB_User_Guide 4 / 41 5G & LTE-A Module Series Contents Safety Information....................................................................................................................................... 3 About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 7 Figure Index ................................................................................................................................................. 8 1 Introduction .......................................................................................................................................... 9 1.1. Applicable Modules ..................................................................................................................... 9 1.2. Special Mark................................................................................................................................ 9 2 Product Overview .............................................................................................................................. 10 2.1. Top View.................................................................................................................................... 10 2.2. Component Placement ............................................................................................................. 11 3 Kit Accessories & Assembly ............................................................................................................ 14 3.1. Accessories Assembly .............................................................................................................. 14 3.2. Accessories List ........................................................................................................................ 15 4 Application Interfaces ....................................................................................................................... 16 4.1. Power Supply ............................................................................................................................ 16 4.2. M.2 Interface ............................................................................................................................. 18 4.3. USB Interface............................................................................................................................ 19 4.4. USB-to-UART Interface............................................................................................................. 20 4.5. (U)SIM Card Interfaces ............................................................................................................. 21 4.6. Status Indicators........................................................................................................................ 23 4.7. MCU*......................................................................................................................................... 24 4.8. 100 MHz Clock.......................................................................................................................... 25 4.9. Antenna Interfaces .................................................................................................................... 26 4.10. Switches .................................................................................................................................... 26 4.10.1. Power Switch ................................................................................................................. 26 4.10.2. DIP Switches.................................................................................................................. 28 4.11. Test Points................................................................................................................................. 29 5 Operation Procedures ....................................................................................................................... 34 5.1. Test on the Laptop..................................................................................................................... 34 5.1.1. Connection for Testing on the Laptop ............................................................................ 34 5.1.2. Preset DIP Switches for Testing on the Laptop ............................................................. 35 5.1.3. Turn On the Module ....................................................................................................... 36 5.2. Test on the EVB ........................................................................................................................ 36 5.2.1. Connection Between the Module and the EVB ............................................................. 36 5.2.2. Preset DIP Switches for Testing on the EVB ................................................................. 37 5.2.3. Turn On the Module ....................................................................................................... 37 5.2.4. Communication Via USB................................................................................................ 38 5.3. Turn Off the Module .................................................................................................................. 38 M.2-FPC_EVB_User_Guide 5 / 41 5G & LTE-A Module Series 5.4. Reset the Module ...................................................................................................................... 39 5.5. Current Consumption Test ........................................................................................................ 39 6 Appendix References ........................................................................................................................ 40 M.2-FPC_EVB_User_Guide 6 / 41 5G & LTE-A Module Series Table Index Table 1: Special Mark ................................................................................................................................... 9 Table 2: Components & Functions ............................................................................................................. 12 Table 3: Accessories List ............................................................................................................................ 15 Table 4: Description of Power Supply ........................................................................................................ 16 Table 5: Description of M.2 Interface ......................................................................................................... 18 Table 6: Description of USB Interface ........................................................................................................ 19 Table 7: Description of USB-to-UART Interface......................................................................................... 20 Table 8: Description of (U)SIM Card Interfaces ......................................................................................... 21 Table 9: Pin Definition of J1001/J1002....................................................................................................... 22 Table 10: Description of Status Indication LEDs ........................................................................................ 23 Table 11: Description of MCU..................................................................................................................... 24 Table 12: Description of Antenna Interfaces .............................................................................................. 26 Table 13: Description of Power Switch....................................................................................................... 26 Table 14: Power Switch Instructions .......................................................................................................... 27 Table 15: DIP Switches Instructions........................................................................................................... 28 Table 16: Pin Definition of Test Points........................................................................................................ 30 Table 17: Related Documents .................................................................................................................... 40 Table 18: Terms and Abbreviations ............................................................................................................ 40 M.2-FPC_EVB_User_Guide 7 / 41 5G & LTE-A Module Series Figure Index Figure 1: Top View...................................................................................................................................... 10 Figure 2: Top View for Component Placement ...........................................................................................11 Figure 3: M.2-FPC EVB and Accessories Assembly ................................................................................. 14 Figure 4: M.2-FPC EVB Kit Accessories.................................................................................................... 15 Figure 5: Block Diagram of EVB Power Supply......................................................................................... 17 Figure 6: EVB Power Supply Interfaces..................................................................................................... 17 Figure 7: Power Plug Design ..................................................................................................................... 18 Figure 8: Connection Between Module and EVB ...................................................................................... 18 Figure 9: USB Interface.............................................................................................................................. 19 Figure 10: USB-to-UART Interface ............................................................................................................ 20 Figure 11: Diagram of USB-to-UART Interface.......................................................................................... 20 Figure 12: Simplified Connector Schematic for (U)SIM Card Connectors ................................................ 21 Figure 13: Pin Assignment of (U)SIM Card Connectors ............................................................................ 22 Figure 14: Status Indicators ....................................................................................................................... 23 Figure 15: Position of MCU Related Components ..................................................................................... 24 Figure 16: 100 MHz Clock.......................................................................................................................... 25 Figure 17: Antenna Interfaces .................................................................................................................... 26 Figure 18: Diagram of Power Switch ......................................................................................................... 27 Figure 19: Diagram of DIP Switches .......................................................................................................... 28 Figure 20: Test Points of J1201 and J1203 and J1202.............................................................................. 30 Figure 21: Test Points of J0702.................................................................................................................. 30 Figure 22: M.2-FPC EVB Assembly ........................................................................................................... 34 Figure 23: Assembly of M.2-FPC EVB and the Laptop ............................................................................. 35 Figure 24: DIP Switches Position When the M.2-FPC EVB is Connected to Laptop................................ 36 Figure 25: M.2-FPC EVB Assembly for Testing ......................................................................................... 37 Figure 26: USB Ports ................................................................................................................................. 38 Figure 27: COM Port Setting on QCOM (USB AT Port Connection) ......................................................... 38 Figure 28: Current Consumption Power Supply Connection Diagram ...................................................... 39 M.2-FPC_EVB_User_Guide 8 / 41 5G & LTE-A Module Series 1 Introduction This user guide describes the application details of M.2-FPC EVB (evaluation board), which is an assistant tool for developers to develop applications and test basic functionalities of applicable modules. 1.1. Applicable Modules For details about the applicable modules of this EVB, see document [1]. 1.2. Special Mark Table 1: Special Mark Mark * Definition Unless otherwise specified, when an asterisk (*) is used after a function, feature, interface, pin name, AT command, or argument, it indicates that the function, feature, interface, pin, AT command, or argument is under development and currently not supported; and the asterisk (*) after a model indicates that the sample of the model is currently unavailable. M.2-FPC_EVB_User_Guide 9 / 41 LTE-A & 5G Module Series 2 Product Overview 2.1. Top View The size of M.2-FPC EVB is 120 mm × 135.2 mm, and the top view is shown as below: Figure 1: Top View M.2-FPC_EVB_User_Guide 10 / 41 2.2. Component Placement LTE-A & 5G Module Series J1302 J1304 J1306 J1308 J1201 J1203 J1202 2 16 2 16 2 16 1 15 1 15 1 15 S0401 S1102 S0302 S1101 J0901 J0902 13 1 14 2 U0902 1 2 3 4 S0901 30 120.00 mm J0401 J0402 1 J1001 J1002 1 3 3 3 J0702 1 3 1 1 3 1 1 3 3 1 3 1 U0702 1 2 2 1 40 1 2 U0301 M.2 Module 74 75 1 2 2 1 D0204 D0203 1 1 3 U0502135.20 mm S0201 S0301 H0201 4 2 J0101 2 3 1 Figure 2: Top View for Component Placement M.2-FPC_EVB_User_Guide 11 / 41 LTE-A & 5G Module Series Table 2: Components & Functions Components Power Supply Power Switch RESET M.2 Interface USB Interface USB-to-UART Interface (U)SIM Card Interfaces Status Indicators RefDes. J0101 H0201 S0201 S0301 Description Power jack on the EVB, external power supply interface External power supply interface for current consumption test Select the module’s power supply path M.2 module reset button Implementation Typical supply voltage: +5 V Typical supply voltage: +3.3 V Select power supply interface between H0201 and FPC Used to reset the M.2 module S0901 U0301 U0502 U0702 J1001 J1002 D0204 D0203 MCU* reset button Used to reset the MCU* Standard PCI Express M.2 Used to connect the module to the EVB interface ⚫ Used for USB 3.0, USB 3.1 and USB Type-C interface USB 2.0 communication ⚫ Used as power supply for the EVB, typical supply voltage is +5 V ⚫ Used to convert debug UART to USB 2.0 signal USB Type-C interface for debug ⚫ Used as power supply for the EVB, typical supply voltage is +5 V ⚫ Used to connect the module’s test points DBG_TXD, DBG_RXD and GND to the EVB (U)SIM1 card connector (U)SIM2 card connector ⚫ Support (U)SIM card insertion detection ⚫ Dual (U)SIM card supported: 1.8 V and 3.0 V Indicates whether the power supply for module is ready. ⚫ Light ON: VBAT ON ⚫ Light OFF: VBAT OFF Indicates the operation status of the module’s RF 2 LEDs available for signal indication state. ⚫ Light ON: the RF state is turned ON ⚫ Light OFF: the RF state is turned OFF M.2-FPC_EVB_User_Guide 12 / 41 FPC Interfaces DIP Switches MCU* Antenna Interfaces Test Points J0401, J0402 S0401, S1102, S0302, S1101 U0902 J0901 J0902 J1302, J1304, J1306, J1308 J1201, J1202, J1203, J0702 FPC connector DIP switch MCU MCU USB interface MCU JTAG interface 4 Antenna connectors 4 test points LTE-A & 5G Module Series Used to connect the laptop and the EVB Used to switch functions in different modes M.2-FPC_EVB_User_Guide 13 / 41 LTE-A & 5G Module Series 3 EVB Kit & Assembly 3.1. Kit Assembly Figure 3: M.2-FPC EVB and Kit Assembly M.2-FPC_EVB_User_Guide 14 / 41 LTE-A & 5G Module Series 3.2. Accessories List All accessories of the M.2-FPC EVB kit are listed as below. Contact the supplier if there is something missing. 40P FPC 30P FPC FPC Adapter Board M.2-FPC EVB Figure 4: M.2-FPC EVB Accessories Table 3: Accessories List Items M.2-FPC EVB FPC Adapter Board 30P FPC 40P FPC Description EVB mainboard Used to connect the EVB to the laptop for testing Used to connect the EVB mainboard to the FPC adapter board Used to connect the EVB mainboard to the FPC adapter board Quantity (pcs) 1 1 1 1 M.2-FPC_EVB_User_Guide 15 / 41 LTE-A & 5G Module Series 4 Application Interfaces This chapter describes the following application interfaces of the M.2-FPC EVB, and provides information about the status indicators, switches and test points so that you can use the M.2-FPC EVB better. ⚫ Power supply interfaces ⚫ M.2 interface ⚫ USB interface ⚫ USB-to-UART interface ⚫ (U)SIM card interfaces ⚫ Status indicators ⚫ MCU* ⚫ 100 MHz clock ⚫ Antenna interfaces ⚫ Switches ⚫ Test points 4.1. Power Supply Interfaces M.2-FPC EVB can be powered by an external power adapter through the power jack (J0101), or by two USB Type-C interfaces (U0502 and U0702). The J0101, U0502, and U0702 are all connected to a DC-DC chip, which can convert the 5 V power supply to 3.3 V power supply for the module. The EVB can also be powered by the laptop through FPC. The module can be directly powered by external power supply through H0201. This power supply method is commonly used for current consumption test. Table 4: Description of Power Supply RefDes. J0101 U0502 U0702 Description Power jack on the EVB, external power supply interface USB Type-C interface USB Type-C interface for debug M.2-FPC_EVB_User_Guide 16 / 41 LTE-A & 5G Module Series H0201 Current consumption test power supply interface The following figures show the simplified power supply block diagram of the EVB. DC-JACK J0101 DEBUG-VBUS U0702 USB-VBUS U0502 FPC 3V3 TPS54319 SGM2019 1.8 V FPC 3V3 CURRENT TEST PCMOS ENABLE SWITCH S0201 3.3 V M.2 CONNECTOR U0301 Figure 5: Block Diagram of EVB Power Supply U0301 U0702 Power Switch S0201 U0502 External Power Supply · Interface for Current Consumption Test H0201 Power Jack J0101 Figure 6: EVB Power Supply Interfaces M.2-FPC_EVB_User_Guide 17 / 41 LTE-A & 5G Module Series If the power jack is used for power supply, the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 7: Power Plug Design 4.2. M.2 Interface The M.2 interface is designed to accommodate the applicable modules. The module connects to the EVB through the M.2 connector (U0301). This interface is used to test functionalities of the module or to develop applications based on the module. Table 5: Description of M.2 Interface RefDes. U0301 Description Standard PCI Express M.2 interface The following figure shows the connection between the module and the EVB. U0301 U0301 Figure 8: Connection Between Module and EVB M.2-FPC_EVB_User_Guide 18 / 41 LTE-A & 5G Module Series 4.3. USB Interface The EVB provides a USB 3.1/3.0/2.0 Type-C interface and supports SuperSpeed (5 Gbps), high-speed (480 Mbps) and full-speed (12 Mbps) for connection with a host device. This USB interface is used for AT command communication, data transmission, GNSS NMEA sentences output, software debug and firmware upgrade. Table 6: Description of USB Interface RefDes. U0502 Description USB Type-C interface, used for USB 3.1, USB 3.0 and USB 2.0 communication Usage: Switch P2 of the DIP switch (S1102) to ON side so that the USB of the module can be connected to U0502 and be used normally. (For details, see Chapter 4.10.2) DIP Switch M.2 USB U0502 Figure 9: USB Interface M.2-FPC_EVB_User_Guide 19 / 41 LTE-A & 5G Module Series 4.4. USB-to-UART Interface The EVB provides a USB-to-UART interface. This interface is used for Linux console and converting log UART signal to USB 2.0 signal for debugging. Table 7: Description of USB-to-UART Interface RefDes. U0702 J0702 Description Used to convert debug UART to USB 2.0 signal Used to connect the module’s test points DBG_TXD, DBG_RXD and GND to the EVB Before using the USB-to-UART interface, DBG_TXD and DBG_RXD of the module should be connected to the corresponding positions of J0702 on the EVB. U0301 J0702 U0702 · Figure 10: USB-to-UART Interface The following figure shows the diagram of USB-to-UART interface. USB Type-C U0702 USB to UART 1.8/3.0 V Level-shifting 1.8 V Switch U0301 M.2 Interface J0702 Test Point Figure 11: Diagram of USB-to-UART Interface M.2-FPC_EVB_User_Guide 20 / 41 LTE-A & 5G Module Series 4.5. (U)SIM Card Interfaces The EVB has two push-push type (U)SIM card interfaces J1001 and J1002 which support 1.8/3.0 V (U)SIM card. Table 8: Description of (U)SIM Card Interfaces RefDes. J1001 J1002 Description (U)SIM1 card connector (U)SIM2 card connector The following figure shows a simplified connector schematic for these connectors. Module USIM_VDD USIM_RST USIM_CLK USIM_DATA GND Push-Push C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK (U)SIM card connector C7 USIM_DATA USIM_DET CD USIM_DET J1001/J1002 Figure 12: Simplified Connector Schematic for (U)SIM Card Connectors The figure and table below illustrate the pin assignment and definition of (U)SIM card connectors J1001 and J1002. M.2-FPC_EVB_User_Guide 21 / 41 LTE-A & 5G Module Series CD C7 C3 C6 C2 C5 C1 J1001 CD C7 C3 C6 C2 C5 C1 J1002 Figure 13: Pin Assignment of (U)SIM Card Connectors Table 9: Pin Definition of J1001/J1002 Pin No. Pin Name I/O C1 USIM_VDD PO C2 USIM_RST DO C3 USIM_CLK DO C5 GND - C6 VPP - C7 USIM_DATA DIO CD USIM_DET DI Description U(SIM) card power supply, provided by module U(SIM) card reset U(SIM) card clock Ground U(SIM) card data U(SIM) card detection M.2-FPC_EVB_User_Guide 22 / 41 LTE-A & 5G Module Series 4.6. Status Indicators There are two status indication LEDs on the EVB. Table 10: Description of Status Indication LEDs RefDes. D0204 D0203 Description Indicates whether the power supply for module is ready. ⚫ Light ON: VBAT ON ⚫ Light OFF: VBAT OFF Indicates the operation status of the module’s RF state. ⚫ Light ON: the RF state is turned ON ⚫ Light OFF: the RF state is turned OFF The following figure shows the positions of these LED indicators: D0204 D0203 Figure 14: Status Indicators M.2-FPC_EVB_User_Guide 23 / 41 4.7. MCU* The EVB has a MCU. Table 11: Description of MCU RefDes. U0902 J0901 J0902 S0901 Description MCU MCU USB interface MCU JTAG interface MCU reset button The following figure shows the position of MCU. MCU USB J0901 MCU JTAG J0902 LTE-A & 5G Module Series MCU Reset S0901 MCU U0902 Figure 15: Position of MCU Related Components MCU related functions are under development and verification. M.2-FPC_EVB_User_Guide 24 / 41 LTE-A & 5G Module Series 4.8. 100 MHz Clock This section describes the 100 MHz clock output of PCIe. The 100 MHz clock is only used for verification in specific software and hardware versions. Before turning on the 100 MHz clock of the EVB, the following operations must be completed: ⚫ Mount the two 0 Ω resistors R0350 and R0351. ⚫ Turn on the third switch (P3) of S0401 (switch to the left side in the following figure, see Chapter 4.10.2 for details). P3 of S0401 Mount 0 Ω resistors R0350 and R0351 Figure 16: 100 MHz Clock M.2-FPC_EVB_User_Guide 25 / 41 LTE-A & 5G Module Series 4.9. Antenna Interfaces The EVB includes four antenna interfaces: Table 12: Description of Antenna Interfaces RefDes. J1302 J1304 J1306 J1308 Description Antenna connectors The following figure shows the position of these antenna interfaces: J1302 J1304 J1306 J1308 Figure 17: Antenna Interfaces 4.10. Switches 4.10.1. Power Switch Table 13: Description of Power Switch RefDes. S0201 Description Select the module’s power supply path M.2-FPC_EVB_User_Guide 26 / 41 LTE-A & 5G Module Series This switch controls EVB power supply, as shown in the following figure. Power Switch S0201 U0702 USB 5 V Power Supply · PWR_FPC Side External Power Supply U0502 PWR_EXT Side Interface for Current USB 5 V Consumption Test Power Supply H0201 Figure 18: Diagram of Power Switch Power Jack 5 V Power Supply J0101 Table 14: Power Switch Instructions Switch Position Switch to PWR_EXT side Switch to PWR_FPC side Description When testing current consumption of the module, H0201 is utilized first. The external 5 V power supply or USB 5 V power supply is disconnected. When H0201 is unavailable, use the external 5 V power supply or USB 5 V power supply. The external FPC of laptop power supply is utilized first. The external 5 V power supply or USB 5 V power supply is disconnected. When the external FPC power supply is unavailable, use the external 5 V power supply or USB 5 V power supply. Usage scenarios and methods: ⚫ When connecting the EVB to a laptop through FPC, external power supply is not needed. Switch S0201 to PWR_FPC side in Figure 18. ⚫ When the EVB is only used for testing, external power supply is not needed. Switch S0201 to PWR_FPC side in Figure 18. ⚫ When testing current consumption of the module, connect the test power supply (PWR_EXT_3V3) to H0201 position. Switch S0201 to PWR_EXT side in Figure 18. ⚫ NOTE Do not switch this power switch when power supply is connected. Please disconnect the power supply before switching. M.2-FPC_EVB_User_Guide 27 / 41 LTE-A & 5G Module Series 4.10.2. DIP Switches There are four DIP switches, and the positions are shown as follows: P4 P3 P2 P1 S0401 S1102 S0302 S1101 Figure 19: Diagram of DIP Switches Table 15: DIP Switches Instructions RefDes No. Description . P1 DPR signal FULL_CARD_POWER_OFF#PC PCIE_RESET#_PC P2 PCIE_CLOCK#PC S0401 PCIE_WAKE#PC Four signals control P3 PCIe 100 MHz clock IC control OFF (The switch is on ON (The switch is on the right side) the left side) Pull up to 1.8 V by default Connect to ground Controlled by laptop through FPC Controlled by U0902 MCU* The 100 MHz clock IC is not used Clock IC power supply; Output PCIe 100 MHz clock; Pull up PCIE_RESET# M.2-FPC_EVB_User_Guide 28 / 41 LTE-A & 5G Module Series P4 U0702 connection direction Connect to J0702 test Connect to the module’s points pin 22 and pin 28 Control the CONFIG 0 to 3 P1 connection direction of the FPC Connect to the M.2 module Connect to DIP switch S1101 S1102 Control the module’s USB P2 connection direction Connect the module to the laptop Connect the module to the USB Type-C interface (U0502) of the EVB P3 W_DISABLE1# signal Pull up to 3.3 V by default Connect to ground to enter airplane mode P4 W_DISABLE2# signal Pull up to 3.3 V by default Connect to ground to close GNSS function COEX3/USB-PCIE_SWITCH P1 signal Pull down the 100 kΩ resistor to ground by default Pull up the 10 kΩ resistor to 1.8 V P2 PCM_CLK signal Pull up to 1.8 V by default Connect to ground S0302 Select whether the (U)SIM1 card Connect to the (U)SIM1 Adopt (U)SIM1 card P3 connector of the EVB or the laptop card connector of the connector of the EVB is adopted laptop with FPC Select whether the (U)SIM2 card Connect to the (U)SIM2 Adopt (U)SIM2 card P4 connector of the EVB or the laptop card connector of the connector of the EVB is adopted laptop with FPC P1 CONFIG_0_DBG Pull up to 3.3 V by default Connect to ground S1101 P2 CONFIG_1_DBG P3 CONFIG_2_DBG Pull up to 3.3 V by default Pull up to 3.3 V by default Connect to ground Connect to ground P4 CONFIG_3_DBG Pull up to 3.3 V by default Connect to ground 4.11. Test Points The EVB provides test points which help you obtain the corresponding waveforms of some signals. The following figures show the details of all test points. M.2-FPC_EVB_User_Guide 29 / 41 LTE-A & 5G Module Series J1203 J1202 J1201 2 4 6 8 10 12 14 16 1 3 5 7 9 11 1315 Figure 20: Test Points of J1201 and J1203 and J1202 12 3 J0702 Figure 21: Test Points of J0702 Table 16: Pin Definition of Test Points J1201 Pin No. 1 2 3 4 5 Pin Name Module Pin No. PWR_1V8 - GND - PCIE_WAKE#_PC - GND - COEX3/USB-PCIE_S - Description 1.8 V power supply Ground PCIE_WAKE signal of the laptop Ground COEX3/USB-PCIE_SWITCH signal, M.2-FPC_EVB_User_Guide 30 / 41 6 7 8 9 10 11 12 13 14 15 16 J1202 Pin No. 1 2 3 4 5 6 7 8 9 10 WITCH PWR_3V3_FPC - COEX_RXD 62 PWR_INT_TURN_OFF - COEX_TXD 64 NC - ANT_CONFIG 68 RESET#_PC - PWR_3V3 - PCIE_RESET#_PC - USB_VDD_3V3 - USB_VBUS_DBG - LTE-A & 5G Module Series 100 kΩ pull-down resistor by default 3.3 V power supply Connect to the module’s pin 62 Enables power supply from PWR_3V3 to PWR_MODLE_3V3 Connect to the module’s pin 64 Connect to the module’s pin 68 RESET signal output of the laptop, control the module reset 3.3 V power supply PCIE_RESET# control signal of the laptop TTL to USB 3.3 V power supply USB power supply Pin Name Module Pin No. FULL_CARD_POWER - _OFF#_PC ANTCTL0 59 CONFIG_0_M.2 21 ANTCTL1 61 CONFIG_1_M.2 69 ANTCTL2 63 CONFIG_2_M.2 75 ANTCTL3 65 CONFIG_3_M.2 1 DPR 25 Description FPC start-up signal Connect to the module’s pin 59 Connect to the module’s pin 21 Connect to the module’s pin 61 Connect to ground internally Connect to the module’s pin 63 Unconnected internally Connect to the module’s pin 65 Unconnected internally Connect to the module’s pin 25 M.2-FPC_EVB_User_Guide 31 / 41 11 12 13 14 15 16 J1203 Pin No. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 PWRKEY 6 PCIE_RESET# 50 GND - PCIE_CLKREQ# 52 GND - PCIE_WAKE# 54 LTE-A & 5G Module Series Module ON/OFF control signal PCIe reset, active low Ground PCIe clock request, active low Ground PCIe wake up, active low Pin Name Module Pin No. Description PWR_MODULE_3V3 2、4、70、72、74 Module power supply GND - Ground PWR_MODULE_3V3 2、4、70、72、74 Module power supply GND - Ground NC 38 Connect to the module’s pin 38 VDDIO_1V8 24 Connect to the module’s pin 24 WWAN_LED# 10 Radio indicator, active low WAKE_ON_WAN# 23 Connect to the module’s pin 23 PCM_CLK 20 W_DISABLE2# 26 PCM_IN/DBG_UART_ 22 RX_1V8 W_DISABLE1# 8 PCM_SYNC/DBG_UA 28 RT_TX_1V8 RFFE_CLK 56 PCIE_CLKREQ#_PC - RFFE_DATA 58 Connect to the module’s pin 20 GNSS function control, active low, turn off GNSS function Connect to the module’s pin 22 Airplane mode control, active low Connect to the module’s pin 28 Connect to the module’s pin 56 PCIe clock request control signal of the laptop Connect to the module’s pin 58 M.2-FPC_EVB_User_Guide 32 / 41 J0702 Pin No. 1 2 3 Pin Name GND RX_1V8 TX_1V8 LTE-A & 5G Module Series Module Pin No. - Description Ground URTA's RX signal URTA's TX signal M.2-FPC_EVB_User_Guide 33 / 41 LTE-A & 5G Module Series 5 Operation Procedures This chapter introduces how to use the M.2-FPC EVB for testing and evaluation of applicable modules. Before the procedures below, please ensure modules and the EVB are correctly assembled. M.2-FPC EVB mainly has two application scenarios: testing M.2 module on the laptop through FPC adapter board and cables and testing M.2 module on the EVB. 5.1. Test on the Laptop 5.1.1. Connection for Testing on the Laptop When testing M.2 module on the laptop, the EVB assembly should be connected in the following way: Figure 22: M.2-FPC EVB Assembly M.2-FPC_EVB_User_Guide 34 / 41 LTE-A & 5G Module Series Figure 23: Assembly of M.2-FPC EVB and the Laptop 5.1.2. Preset DIP Switches for Testing on the Laptop Since there are many DIP switches on the EVB, there will be different DIP switches presets in different application scenarios. This chapter describes the positions of DIP switches when the module is tested on the laptop through FPC. Configuration is shown in the following figure (see Chapter 4.10.2 for details): The power switch (S0201) is switched to PWR_FPC side. The DIP switches (S0401, S1102, S0302, and S1101) are all switched to the OFF side, which is the right side shown in the figure below. M.2-FPC_EVB_User_Guide 35 / 41 S0201 U0301 LTE-A & 5G Module Series S0401 S1102 S0302 S1101 Figure 24: DIP Switches Position When the M.2-FPC EVB is Connected to Laptop 5.1.3. Turn On the Module 1. Connect the module to the EVB: insert the module into the M.2 connector (U0301) on the EVB, and then fix the module with screws. 2. Connect antennas to the module. 3. Switch S0201 (power switch) to PWR_FPC side. Do not power the EVB through other power supply interfaces. 4. Connect the EVB to the laptop through FPC. D0204 (power ON/OFF indicator) lights up, which indicates that the power supply for the EVB is ready and the module is turned on. At this time, when the RF function is turned on, D0203 (module RF status indicator) lights up. See Chapter 4.6 for specific information. 5.2. Test on the EVB 5.2.1. Connection Between the Module and the EVB When testing M.2 module on the EVB, the EVB assembly should be connected in the following way: M.2-FPC_EVB_User_Guide 36 / 41 LTE-A & 5G Module Series Figure 25: M.2-FPC EVB Assembly for Testing 5.2.2. Preset DIP Switches for Testing on the EVB Since there are many DIP switches on the EVB, there will be different DIP switches presets in different application scenarios. This chapter describes the positions of DIP switches when the module is tested on the EVB. See Chapter 4.10.2 for detailed information. The power switch (S0201) is switched to PWR_FPC side. P3 of S0401, P2 of S1102, P3 and P4 of S0302 are switched to the ON side, which is the left side shown in Figure 24. Other DIP switches are switched to the OFF side, which is the right side shown in Figure 24. 5.2.3. Turn On the Module 1. Connect the module to the EVB: insert the module into the M.2 connector (U0301) on the EVB, and then fix the module with screws. 2. Insert the (U)SIM card into the (U)SIM card connector on the EVB and connect antennas to the module. 3. Switch S0201 (power switch) to PWR_ FPC side. 4. Connect the EVB to the 5 V power adapter or use the USB Type-C cable to connect the EVB to the laptop. D0204 (power ON/OFF indicator) lights up, which indicates that the power supply for the EVB is ready and the module is turned on. At this time, when the RF function is turned on, D0203 (module RF status indicator) lights up. See Chapter 4.6 for specific information. M.2-FPC_EVB_User_Guide 37 / 41 LTE-A & 5G Module Series 5.2.4. Communication Via USB 1. Turn on the module according to the procedure in Chapter 5.2.3. 2. Connect the EVB and laptop with USB cable through USB Type-C interface (U0502), and then install the CP210X USB driver on the laptop. The USB port numbers can be viewed in Device Manager of the PC when the USB driver is installed, as shown below. Figure 26: USB Ports 3. Install and then use QCOM provided by Quectel to realize the communication between the module and the laptop. The following figure shows the COM Port Setting of QCOM: select the correct 'COM Port' (USB AT Port, which is shown in figure above) and set correct 'Baudrate' (e.g. 115200 bps). For more details about QCOM usage and configuration, please refer to document [2]. Figure 27: COM Port Setting on QCOM (USB AT Port Connection) 5.3. Turn Off the Module There are two methods to turn off the module. ⚫ Turn off the module with AT+QPOWD. This is the best and the safest method. The module will log off from the network and save data before shutdown. When turning off the module with AT command, please keep PWRKEY at a high level after the execution of the power-off command, otherwise, the module will be turned on again after successful turn-off. ⚫ Turn off the module by powering down. ⚫NOTE For、more details about AT+QPOWD, see the AT commands manual of the corresponding module. M.2-FPC_EVB_User_Guide 38 / 41 LTE-A & 5G Module Series 5.4. Reset the Module Reset is only used in case of emergency or abnormality. For example, the software fails to respond for more than 5 seconds due to some serious problems. Press the button S0301, and then release it to reset the module. Please note that this operation may cause loss of information in the memory as the module will be initialized after the resetting. 5.5. Current Consumption Test M.2-FPC EVB can be used to test the current consumption of the module. The specific test steps are as follows: 1. Switch S0201 to PWR_EXT side. H0201 is connected to the external power supply to supply power for the module separately. 2. Use EVB to operate the module according to the process described in Chapter 5.1 and 5.2, and then test the current consumption. S0201 PWR_EXT Side GND PWR_FPC Side External Power Supply Interface for Current Consumption Test H0201 Figure 28: Current Consumption Power Supply Connection Diagram M.2-FPC_EVB_User_Guide 39 / 41 LTE-A & 5G Module Series 6 Appendix References Table 17: Related Documents Document Name [1] Quectel_List_of_EVB_Applicable_Modules [2] Quectel_QCOM_User_Guide [3] Quectel_QFlash_User_Guide [4] Quectel_LTE&5G_Windows_USB_Driver_Installation_Guide Table 18: Terms and Abbreviations Abbreviation COM DC DI DIP DO EVB FPC GND GNSS I/O JTAG LED Description Communication Port Direct Current Digital Input Dual In-line Package Digital Output Evaluation Board Flexible Printed Circuit Ground Global Navigation Satellite System Input/Output Joint Test Action Group Light Emitting Diode M.2-FPC_EVB_User_Guide 40 / 41 LTE MCU NC PCB PCM PCIe PO RF UART USB (U)SIM LTE-A & 5G Module Series Long Term Evolution Microcontroller Unit Not Connected Printed Circuit Board Pulse Code Modulation Peripheral Component Interconnect Express Power Output Radio Frequency Universal Asynchronous Receiver/Transmitter Universal Serial Bus (Universal) Subscriber Identity Module M.2-FPC_EVB_User_Guide 41 / 41

RMU500-EK User Guide 5G Module Series Version: 1.0 Date: 2020-11-23 Status: Released www.quectel.com 5G Module Series RMU500-EK User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. RMU500-EK_User_Guide 1 / 28 5G Module Series RMU500-EK User Guide Copyright The information contained here is proprietary technical information of Quectel wireless solutions co., ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved. RMU500-EK_User_Guide 2 / 28 5G Module Series RMU500-EK User Guide About the Document Revision History Version 1.0 Date 2019-12-19 2020-11-23 Author Tom TANG/ Shaky LIN Tom TANG/ Shaky LIN Description Creation of the document First official release RMU500-EK_User_Guide 3 / 28 5G Module Series RMU500-EK User Guide Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 1.1. Safety Information ................................................................................................................... 7 2 General Overview................................................................................................................................. 9 2.1. Key Features ........................................................................................................................... 9 2.2. Component Placement of the EVB ....................................................................................... 10 2.3. Top View of the EVB ............................................................................................................. 11 2.4. EVB Kit Accessories.............................................................................................................. 11 3 Components/Interfaces ..................................................................................................................... 13 3.1. Components/Interfaces of the EVB....................................................................................... 13 3.1.1. Power Supply (J101/J301) ............................................................................................. 13 3.1.2. M.2 Interface (J201) ....................................................................................................... 14 3.1.3. USB Interface (J301)...................................................................................................... 14 3.1.4. (U)SIM Interface (J401).................................................................................................. 15 3.1.5. Status Indicator (D104/D107) ........................................................................................ 17 3.1.6. RF Cables and Antennas ............................................................................................... 18 3.1.6.1. Antenna Design .................................................................................................... 18 3.1.6.2. Antenna Efficiency ................................................................................................ 18 3.1.6.3. Antenna Specification ........................................................................................... 19 3.2. Component Assembling Steps .............................................................................................. 20 4 EVB Operation Procedures............................................................................................................... 24 4.1. Turn on the Module ............................................................................................................... 24 4.2. Communication Via the USB Interface ................................................................................. 24 4.3. Firmware Upgrade................................................................................................................. 25 4.4. Turn Off the Module .............................................................................................................. 26 5 Appendix References ........................................................................................................................ 27 RMU500-EK_User_Guide 4 / 28 5G Module Series RMU500-EK User Guide Table Index Table 1: Key Features .................................................................................................................................. 9 Table 2: Interfaces and Functions of the EVB ........................................................................................... 10 Table 3: Accessories List ........................................................................................................................... 11 Table 4: Pin Definition of J401 ................................................................................................................... 16 Table 5: Description of Status Indicator LEDs ........................................................................................... 17 Table 6: Antenna Specification .................................................................................................................. 19 Table 7: Related Documents...................................................................................................................... 27 Table 8: Terms and Abbreviations ............................................................................................................. 27 RMU500-EK_User_Guide 5 / 28 5G Module Series RMU500-EK User Guide Figure Index Figure 1: Component Placement of the EVB (Top View) .......................................................................... 10 Figure 2: EVB Top View............................................................................................................................. 11 Figure 3: EVB Power Supply Interfaces..................................................................................................... 13 Figure 4: M.2 Connector on the EVB ......................................................................................................... 14 Figure 5: USB Connector ........................................................................................................................... 14 Figure 6: Connection Between PC and EVB ............................................................................................. 15 Figure 7: Simplified Connecting Schematic for (U)SIM Card Connector J401.......................................... 15 Figure 8: Pin Assignment of (U)SIM Card Connector J401....................................................................... 16 Figure 9: Status Indicators ......................................................................................................................... 17 Figure 10: Reference Design for Antennas ............................................................................................... 18 Figure 11: Antenna Efficiency at 700–960 MHz and 1.7–6 GHz............................................................... 18 Figure 12: Antenna Efficiency at 1.7–6 GHz.............................................................................................. 19 Figure 13: Assembling Step 1 .................................................................................................................... 20 Figure 14: Assembling Step 2 .................................................................................................................... 21 Figure 15: Assembling Step 3 .................................................................................................................... 21 Figure 16: Assembling Step 4 .................................................................................................................... 22 Figure 17: Assembling Step 5 .................................................................................................................... 22 Figure 18: Assembling Step 6 .................................................................................................................... 23 Figure 19: USB Ports ................................................................................................................................. 24 Figure 20: COM Port Setting Field on QCOM (USB AT Port Connection)................................................ 25 Figure 21: Configurations for Firmware Upgrade ...................................................................................... 25 RMU500-EK_User_Guide 6 / 28 5G Module Series RMU500-EK User Guide 1 Introduction This document introduces the evaluation board RMU500-EK for RM500Q-GL, the assistant tool for developers to develop and test the modules, and describes how to use it. 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergent help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. RMU500-EK_User_Guide 7 / 28 5G Module Series RMU500-EK User Guide The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. RMU500-EK_User_Guide 8 / 28 5G Module Series RMU500-EK User Guide 2 General Overview Quectel supplies RMU500-EK for designers to develop applications based on RM500Q-GL module and to test basic functionalities of it. 2.1. Key Features The following table describes the detailed features of RMU500-EK. Table 1: Key Features Features Power Supply M.2 Interface (U)SIM Interface USB Interface Status Indication Physical Characteristics Description DC supply: +5 V/ 2.5 A for the EVB Support RM500Q-GL Support (U)SIM card: 2.95/1.8 V USB 3.1 & USB 2.0 2 LEDs available for signal indication Size: 100 mm × 60 mm RMU500-EK_User_Guide 9 / 28 2.2. Component Placement of the EVB 5G Module Series RMU500-EK User Guide J301 Shielding Cover J101 Shielding Cover DDd D10 D4104 D107 J401 Type-B Figure 1: Component Placement of the EVB (Top View) Table 2: Interfaces and Functions of the EVB Interfaces Power Supply M.2 Interface Reference Designators Description J101 (Power Jack) J301 (Type-C USB) The power jack on the EVB Typical supply voltage: +5 V/ 2.5 A Type-C USB interface Typical supply voltage: +5 V/ 2 A J201 The M.2 connecter for the module USB Interface J301 USB interface (U)SIM Interface J401 Indicator LEDs D104 (POWER_LED) D107 (WWAN_LED) (U)SIM card connector Power indicator, indicating whether the module’s power supply is ready. RF status indicator RMU500-EK_User_Guide 10 / 28 2.3. Top View of the EVB Top view of the EVB is exhibited by the figure below. 5G Module Series RMU500-EK User Guide Figure 2: EVB Top View 2.4. EVB Kit Accessories All accessories for the EVB are listed in the following table. Table 3: Accessories List Items Cables Antennas Description Type-C to dual Type-A cable RF cables Antennas with brackets Quantity 1 4 4 RMU500-EK_User_Guide 11 / 28 Silicone Heatsink USB Flash Drive Screws 5G Module Series RMU500-EK User Guide Silicone soft pad 1 Black anodized AL6063 1 Including the related documents, tools, and 1 drivers for the module and RMU500-EK. Used to clamp the module, antennas and 19 heatsink on the EVB RMU500-EK_User_Guide 12 / 28 5G Module Series RMU500-EK User Guide 3 Components/Interfaces 3.1. Components/Interfaces of the EVB This chapter mainly describes the application of the following EVB interfaces: ⚫ Power supply ⚫ M.2 interface ⚫ USB interface ⚫ (U)SIM interface ⚫ RF cables and antennas It also provides information about the status indicator LEDs to help you use the EVB. 3.1.1. Power Supply (J101/J301) The EVB can be powered by an external power adapter through the power jack (J101) on the EVB. It can be also powered by the USB interface through the power jack (J301) on the EVB. The following figure shows the power supply interfaces of the EVB. Figure 3: EVB Power Supply Interfaces RMU500-EK_User_Guide 13 / 28 5G Module Series RMU500-EK User Guide 3.1.2. M.2 Interface (J201) The M.2 connector is designed to accommodate the module. The following figure shows the M.2 connector on RMU500-EK.. Figure 4: M.2 Connector on the EVB 3.1.3. USB Interface (J301) The EVB provides a Type-C USB connector J301 for the connection with a host. RMU500-EK_User_Guide Figure 5: USB Connector 14 / 28 5G Module Series RMU500-EK User Guide Figure 6: Connection Between PC and EVB One end of Type-A is connected to the computer, and, when necessary (e.g. when power supply from the Type-A connected to the PC is inadequate), the other end is connected to the auxiliary power supply. 3.1.4. (U)SIM Interface (J401) The EVB has an 8-pin push-push type (U)SIM card (1.8/2.95 V) connector J401. The following figure shows a simplified connecting schematic for J401. Module USIM_VDD USIM_RST USIM_CLK USIM_DATA USIM_DET GND Push-Push C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK C7 USIM_DATA (U)SIM card connector C4 RESERVED C8 RESERVED CD USIM_DET J401 Figure 7: Simplified Connecting Schematic for (U)SIM Card Connector J401 RMU500-EK_User_Guide 15 / 28 5G Module Series RMU500-EK User Guide The figure and table below illustrate the pin assignment and pin definition of (U)SIM card connector J401. Figure 8: Pin Assignment of (U)SIM Card Connector J401 Table 4: Pin Definition of J401 Pin No. C1 C2 C3 C4 C5 C6 C7 C8 CD Pin Name USIM_VDD USIM_RST USIM_CLK RESERVED GND VPP USIM_DATA RESERVED USIM_DET I/O Function PO (U)SIM card power supply DO (U)SIM card reset DO (U)SIM card clock - Not connected - Ground - Not connected I/O (U)SIM card data - Not connected DI (U)SIM card insertion detection 1) NOTE 1) USIM_DET function of RM500Q-GL module is under development. RMU500-EK_User_Guide 16 / 28 5G Module Series RMU500-EK User Guide 3.1.5. Status Indicator (D104/D107) The EVB provides two status indicator LEDs D104 and D107. The following figure shows the positions of these indicators. Figure 9: Status Indicators Table 5: Description of Status Indicator LEDs Reference Designators D104 D107 Description Indicates whether the power supply for the module is ready. Light on: Power on light off: Power off RF status indicator for the module. Light on: RF function is enabled; light off: RF function is disabled. RMU500-EK_User_Guide 17 / 28 3.1.6. RF Cables and Antennas 3.1.6.1. Antenna Design The following figure is a typical reference design for the antennas. 5G Module Series RMU500-EK User Guide Module ANT R1 0R C1 C2 NM NM Figure 10: Reference Design for Antennas The matching circuit is composed of C1, C2 and R1 for antenna impedance modification. By default, the value of R1 is 0 Ω, while C1 and C2 are not mounted. 3.1.6.2. Antenna Efficiency Figure 11: Antenna Efficiency at 700–960 MHz and 1.7–6 GHz RMU500-EK_User_Guide 18 / 28 5G Module Series RMU500-EK User Guide Figure 12: Antenna Efficiency at 1.7–6 GHz NOTE All measurements are done for the antenna mounted on RMU500-EK PCB with VNA Agilent 5071C and OTA chamber. 3.1.6.3. Antenna Specification The specification of antennas are provided in the following table. Table 6: Antenna Specification Antenna Ant.0 Ant.1 Ant.2 Ant.3 Specification Frequency Range: 0.7–6 GHz Input Impedance: 50 Ω Frequency Range: 1.7–6 GHz Input Impedance: 50 Ω Frequency Range: 1.7–6 GHz Input Impedance: 50 Ω Frequency Range: 0.7–6 GHz Input Impedance: 50 Ω RMU500-EK_User_Guide 19 / 28 3.2. Component Assembling Steps Please follow these steps to assemble the product. Step 1: Insert four RF cables. 5G Module Series RMU500-EK User Guide Figure 13: Assembling Step 1 RMU500-EK_User_Guide 20 / 28 5G Module Series RMU500-EK User Guide Step 2: Stick the thermal pad, insert the module into the M.2 connector and tighten the screw. Figure 14: Assembling Step 2 Step 3: Connect the EVB and the module with RF cables as illustrated by the figure below. Figure 15: Assembling Step 3 RMU500-EK_User_Guide 21 / 28 Step 4: Place the heatsink on the module and tighten the screws. 5G Module Series RMU500-EK User Guide Figure 16: Assembling Step 4 Step 5: Install the antennas in turn and tighten the screws. Figure 17: Assembling Step 5 RMU500-EK_User_Guide 22 / 28 Step 6: Assembling finished. 5G Module Series RMU500-EK User Guide Figure 18: Assembling Step 6 RMU500-EK_User_Guide 23 / 28 5G Module Series RMU500-EK User Guide 4 EVB Operation Procedures This chapter introduces how to use the EVB for the testing evaluation of the module. 4.1. Turn on the Module 1. Finish the assembling steps in Chapter 3.2. 2. Insert a (U)SIM card into the (U)SIM card connector on the EVB. 3. Insert the USB cable (Type-C to dual Type-A), and connect one Type-A end to the computer and the other end to the auxiliary power supply. The Type-C end is connected to the EVB. Power on the EVB and the module will be turned on automatically. 4.2. Communication Via the USB Interface 1. Turn on the module according to the procedure in Chapter 4.1. 2. Connect the EVB and a PC with the USB cable through USB interface, and then run the driver disk on the PC to install the USB driver. For details about USB driver installation, see document [1]. Figure 19: USB Ports 3. Install and then use the tool, QCOM, provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting in QCOM: select correct 'COM Port' (USB AT Port which is shown in the figure above) and set correct 'Baudrate' (such as 115200 bps). For more details about QCOM usage and configuration, see document [2]. RMU500-EK_User_Guide 24 / 28 5G Module Series RMU500-EK User Guide Figure 20: COM Port Setting Field on QCOM (USB AT Port Connection) 4.3. Firmware Upgrade The firmware of the module is upgraded via USB port by default, please follow the procedures below to upgrade the firmware. 1. Install and open the firmware upgrade tool, QFlash, on the PC and then turn on the module according to the procedures in Chapter 4.1. 2. Click the 'COM Port' dropdown list and select the Port No. corresponding to 'Quectel USB DM Port'. 3. Click the 'Load FW Files' button and choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. Figure 21: Configurations for Firmware Upgrade RMU500-EK_User_Guide 25 / 28 5G Module Series RMU500-EK User Guide For more details about QFlash usage and configuration, see document [3]. 4.4. Turn Off the Module There are two methods to turn off the module. ⚫ Hardware method: the module will be turned off after the USB cable is disconnected. ⚫ Software method: the module can be turned off with the AT command AT+QPOWD. RMU500-EK_User_Guide 26 / 28 5G Module Series RMU500-EK User Guide 5 Appendix References Table 7: Related Documents SN Document Name Description Quectel_LTE&5G_Windows_USB_Driver Installation guide of USB driver for LTE&5G modules [1] _Installation_Guide on Windows system [2] Quectel_QCOM_User_Guide User guide for QCOM tool [3] Quectel_QFlash_User_Guide User guide for QFlash tool Quectel_RG50xQ&RM5xxQ_Series_AT [4] _Commands_Manual AT commands manual for RM500Q-GL, RM500Q-AE, RM502Q-GL, RM502Q-AE, RM510Q-GL, RG500Q series, and RG502Q-EA module [5] Quectel_RM500Q-GL_Hardware_Design Hardware design for RM500Q-GL module Table 8: Terms and Abbreviations Abbreviation COM DC DI DO EVB GND GNSS I/O LED NC Description Communication Port Direct Current Digital Input Digital Output Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode Not Connected RMU500-EK_User_Guide 27 / 28 PC PCB PO RF SD SIM UART USB (U)SIM 5G Module Series RMU500-EK User Guide Personal Computer Printed Circuit Board Power Output Radio Frequency Secure Digital Subscriber Identity Module Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module RMU500-EK_User_Guide 28 / 28

M.2-FPC EVB 用户指导 5G & LTE-A 模块系列 版本：1.0 日期：2023-02-17 状态：受控文件 M.2-FPC EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 40 M.2-FPC EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 40 M.2-FPC EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或(U)SIM 卡无效时。如果设备支持紧急呼叫功能，请使用紧急呼叫，同时请确保设备开机并 且位于信号强度足够的区域。因不能保证所有情况下网络都能连接，故在紧急情况 下，不能将带有紧急呼叫功能的设备作为唯一的联系方式。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 3 / 40 M.2-FPC EVB 用户指导 文档历史 修订记录 版本 1.0 日期 2022-11-25 2023-02-17 作者 Fung ZHU Fung ZHU 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 4 / 40 M.2-FPC EVB 用户指导 目录 安全须知 ....................................................................................................................................................... 3 文档历史 ....................................................................................................................................................... 4 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 7 图片索引 ....................................................................................................................................................... 8 1 引言 ....................................................................................................................................................... 9 1.1. 适用模块 ..................................................................................................................................... 9 1.2. 特殊符号 ..................................................................................................................................... 9 2 产品综述 .............................................................................................................................................. 10 2.1. 俯视图....................................................................................................................................... 10 2.2. 器件布局 ................................................................................................................................... 11 3 EVB 套件及组装.................................................................................................................................. 14 3.1. 套件组装 ................................................................................................................................... 14 3.2. 配件列表 ................................................................................................................................... 15 4 接口应用 .............................................................................................................................................. 16 4.1. 电源接口 ................................................................................................................................... 16 4.2. M.2 接口 ................................................................................................................................... 18 4.3. USB 接口.................................................................................................................................. 19 4.4. USB-to-UART 接口 .................................................................................................................. 20 4.5. (U)SIM 卡接口 .......................................................................................................................... 21 4.6. 状态指示灯 ............................................................................................................................... 22 4.7. 单片机* ..................................................................................................................................... 23 4.8. 100 MHz 时钟........................................................................................................................... 24 4.9. 天线接口 ................................................................................................................................... 25 4.10. 开关 .......................................................................................................................................... 26 4.10.1. 电源切换开关................................................................................................................. 26 4.10.2. 拨码开关 ........................................................................................................................ 27 4.11. 测试点....................................................................................................................................... 29 5 操作程序说明....................................................................................................................................... 33 5.1. 笔电测试 ................................................................................................................................... 33 5.1.1. 笔电测试连接方式 ......................................................................................................... 33 5.1.2. 笔电测试上电前拨码开关预设 ....................................................................................... 34 5.1.3. 模块开机 ........................................................................................................................ 35 5.2. EVB 测试 .................................................................................................................................. 35 5.2.1. EVB 模块连接方式......................................................................................................... 35 5.2.2. EVB 测试上电前拨码开关预设 ...................................................................................... 36 5.2.3. 模块开机 ........................................................................................................................ 36 5.2.4. USB 接口通信................................................................................................................ 37 5.3. 模块关机 ................................................................................................................................... 37 上海移远通信技术股份有限公司 5 / 40 M.2-FPC EVB 用户指导 5.4. 模块复位 ................................................................................................................................... 38 5.5. 耗流测试 ................................................................................................................................... 38 6 附录 参考文档和术语缩写 .................................................................................................................. 39 上海移远通信技术股份有限公司 6 / 40 M.2-FPC EVB 用户指导 表格索引 表 1：特殊符号 .................................................................................................................................................... 9 表 2：组件功能 .................................................................................................................................................. 12 表 3：配件列表 .................................................................................................................................................. 15 表 4：电源接口描述 ........................................................................................................................................... 16 表 5：M.2 接口描述 ........................................................................................................................................... 18 表 6：USB 接口描述 .......................................................................................................................................... 19 表 7：USB-to-UART 接口描述........................................................................................................................... 20 表 8：(U)SIM 卡接口描述 .................................................................................................................................. 21 表 9：J1001/1002 引脚定义 .............................................................................................................................. 22 表 10：状态指示灯描述 ..................................................................................................................................... 23 表 11：单片机描述 ............................................................................................................................................. 23 表 12：天线接口描述 ......................................................................................................................................... 25 表 13：电源切换开关描述.................................................................................................................................. 26 表 14：电源开关使用说明.................................................................................................................................. 27 表 15：拨码开关使用说明.................................................................................................................................. 28 表 16：J1201、J1202、J1203、J0702 测试点定义 ......................................................................................... 30 表 17：参考文档 ................................................................................................................................................ 39 表 18：术语缩写 ................................................................................................................................................ 39 上海移远通信技术股份有限公司 7 / 40 M.2-FPC EVB 用户指导 图片索引 图 1：M.2-FPC EVB 俯视图 .............................................................................................................................. 10 图 2：器件布局俯视图 ........................................................................................................................................11 图 3: M.2-FPC EVB 和套件组装......................................................................................................................... 14 图 4：M.2-FPC EVB 配件图 .............................................................................................................................. 15 图 5：EVB 电源结构框图 ................................................................................................................................... 17 图 6：EVB 电源接口 .......................................................................................................................................... 17 图 7：适配器插头............................................................................................................................................... 18 图 8：模块和 EVB 连接...................................................................................................................................... 18 图 9：M.2 模块 USB 接口（U0502） ................................................................................................................ 19 图 10：USB-to-UART 接口（U0702） .............................................................................................................. 20 图 11：USB-to-UART 接口（U0702）结构框图................................................................................................ 21 图 12：(U)SIM 卡连接器的简化连接示意图 ....................................................................................................... 21 图 13：J1001 和 J1002 引脚分布 ...................................................................................................................... 22 图 14：状态指示灯............................................................................................................................................. 23 图 15：单片机相关器件位置 .............................................................................................................................. 24 图 16：100 MHz 时钟 ........................................................................................................................................ 25 图 17：天线接口示意图 ..................................................................................................................................... 26 图 18：电源切换开关示意图 .............................................................................................................................. 26 图 19：拨码开关示意图 ..................................................................................................................................... 27 图 20：J1201、J1202、J1203 测试点 .............................................................................................................. 29 图 21：J0702 测试点 ......................................................................................................................................... 29 图 22：M.2-FPC EVB 装配图 ............................................................................................................................ 33 图 23：M.2-FPC EVB 连接笔电装配图.............................................................................................................. 34 图 24：M.2-FPC EVB 连接笔电拨码开关位置 ................................................................................................... 35 图 25：M.2-FPC EVB 测试装配图 ..................................................................................................................... 36 图 26：USB 端口 ............................................................................................................................................... 37 图 27：QCOM 上的 COM 端口设置（通过 USB AT Port 连接）....................................................................... 37 图 28：耗流供电连接图 ..................................................................................................................................... 38 上海移远通信技术股份有限公司 8 / 40 M.2-FPC EVB 用户指导 1 引言 本文介绍了如何使用 M.2-FPC EVB 去调试 M.2 系列模块，该 EVB 是用于开发和测试移远通信模块的 辅助工具。 1.1. 适用模块 有关该 EVB 的适用模块，可参考文档 [1]。 1.2. 特殊符号 表 1：特殊符号 符号 * 定义 若无特别说明，模块功能、特性、接口、引脚名称、AT 命令或参数后所标记的星号（*）表 示该功能、特性、接口、引脚、AT 命令或参数正在开发中，因此暂不支持；模块子型号后所 标记的星号（*）表示该子型号暂无样品。 上海移远通信技术股份有限公司 9 / 40 M.2-FPC EVB 用户指导 2 产品综述 移远通信为工程师提供 M.2-FPC EVB 来帮助其开发应用程序。本章提供了此 EVB 的相应概述。 2.1. 俯视图 M.2-FPC EVB 的尺寸是 120 mm × 135.2 mm，其俯视图如下图所示： 图 1：M.2-FPC EVB 俯视图 上海移远通信技术股份有限公司 10 / 40 2.2. 器件布局 M.2-FPC EVB 用户指导 J1302 J1304 J1306 J1308 J1201 J1203 J1202 2 16 2 16 2 16 1 15 1 15 1 15 S0401 S1102 S0302 S1101 J0901 13 14 J0902 1 2 U0902 1 2 3 4 S0901 30 120.00 mm J0401 J0402 1 J1001 J1002 1 3 3 3 J0702 1 3 1 1 3 1 1 3 3 1 3 1 U0702 M.2 模块 74 2 U0301 1 2 2 1 40 1 1 75 1 2 2 1 D0204 D0203 1 3 U0502135.20 mm S0201 S0301 H0201 4 2 J0101 图 2：器件布局俯视图 2 3 1 上海移远通信技术股份有限公司 11 / 40 M.2-FPC EVB 用户指导 表 2：组件功能 器件 位号 电源 1 电源切换开关 J0101 H0201 S0201 RESET S0301 S0901 USB 接口 U0502 USB-to-UART 接口 U0702 (U)SIM 卡接口 J1001 J1002 状态指示灯 M.2 接口 FPC 接口 拨码开关 2 D0204 D0203 U0301 J0401、J0402 S0401、S1102、 S0302、S1101 描述 备注 适配器插座，外部供电 接口 典型供电电压：+5 V 耗流测试外接电源接口 典型供电电压：+3.3 V 选择模块供电路径 耗流测试电源接口供电（H0201）或 FPC 接口供电 M.2 模块复位按键 用于 M.2 模块复位 单片机*复位按键 用于单片机*复位 USB Type-C 接口 USB Type-C 调试接口 ⚫ 支持 USB 3.0， USB 3.1 以及 USB 2.0 通信 ⚫ 也可用于 EVB 供电，典型供电 电压为 +5 V ⚫ 用 于 将 调 试 串 口 转 换 成 USB 2.0 信号 ⚫ 也可用于 EVB 供电，典型供电 电压为 +5 V ⚫ 用于将模块的测试点 DBG_TXD 和 DBG_RXD 以及 GND 连接到 EVB (U)SIM1 连接器 (U)SIM2 连接器 ⚫ 支持(U)SIM 卡插入检测 ⚫ 支持双卡 1.8 V 和 3.0 V 电源开/关指示灯，指示 EVB 的电源状态 灯亮：EVB 通电 灯灭：EVB 断电 模块射频状态指示灯 灯亮：射频功能开启 灯灭：射频功能关闭 用于指示 EVB 供电状态 用于指示模块射频功能是否开启 M.2 标准接口 用于模块与 EVB 连接 FPC 连接器 用于连接笔电与 EVB 开关 用于在不同模式下的功能切换 1 上表中的电源信息适用于模块。有关电源的详细信息，请参阅第 4.1 章。 2 上表中的拨码开关信息适用于模块。有关拨码开关的详细信息，请参阅第 4.10.2 章。 上海移远通信技术股份有限公司 12 / 40 单片机* 测试点 天线接口 U0902 J0901 J0902 J1201、J1202、 J1203、J0702 J1302、J1304、 J1306、J1308 单片机 单片机 USB 接口 单片机 JTAG 接口 测试点 外接天线接口 M.2-FPC EVB 用户指导 上海移远通信技术股份有限公司 13 / 40 3 EVB 套件及组装 3.1. 套件组装 M.2-FPC EVB 用户指导 图 3: M.2-FPC EVB 和套件组装 上海移远通信技术股份有限公司 14 / 40 3.2. 配件列表 M.2-FPC EVB 用户指导 40P FPC 30P FPC FPC转接板 M.2-FPC EVB 图 4：M.2-FPC EVB 配件图 表 3：配件列表 配件 M.2-FPC EVB FPC 转接板 30P FPC 40P FPC 描述 EVB 主板 用于连接 EVB 和笔电，进行相应测试 用于连接 EVB 主板与 FPC 转接板 用于连接 EVB 主板与 FPC 转接板 数量 1 1 1 1 不同测试对应的具体连接方式见第 5 章。 上海移远通信技术股份有限公司 15 / 40 M.2-FPC EVB 用户指导 4 接口应用 本章介绍 M.2-FPC EVB 的如下接口应用，及有关状态指示灯、开关、测试点的相关信息，以便您更好 地使用 M.2-FPC EVB。 ⚫ 电源接口 ⚫ M.2 接口 ⚫ USB 接口 ⚫ USB-to-UART 接口 ⚫ (U)SIM 卡接口 ⚫ 状态指示灯 ⚫ 单片机* ⚫ 100 MHz 时钟 ⚫ 天线接口 ⚫ 开关 ⚫ 测试点 4.1. 电源接口 M.2-FPC EVB 可以通过适配器连接至适配器接口（J0101）供电，或通过 2 个 USB Type-C 接口（U0502、 U0702）供电。J0101、U0502、U0702 均连接至一个 DC-DC 芯片，可以将 5 V 的供电转为适用于模块的 3.3 V 供电，也可以通过 FPC 连接到笔电供电。 模块可通过 H0201 由外部电源直接供电。这种供电方式一般用于耗流测试。 表 4：电源接口描述 位号 J0101 U0502 U0702 H0201 描述 适配器插座，外部供电接口 USB Type-C 接口 USB Type-C 接口，用于调试 耗流测试外接电源接口 上海移远通信技术股份有限公司 16 / 40 M.2-FPC EVB 电源结构及接口如下图所示： M.2-FPC EVB 用户指导 DC-JACK J0101 DEBUG-VBUS U0702 USB-VBUS U0502 FPC 3V3 TPS54319 SGM2019 1.8 V FPC 3V3 CURRENT TEST PCMOS ENABLE SWITCH S0201 3.3 V M.2 CONNECTOR U0301 图 5：EVB 电源结构框图 U0301 U0702 U0502 耗流测试 外接电源 H0201 适配器供电 J0101 图 6：EVB 电源接口 电源切换开关 S0201 上海移远通信技术股份有限公司 17 / 40 当使用适配器供电时，适配器的插头设计如下图所示。 内接点 M.2-FPC EVB 用户指导 . 外层导体 图 7：适配器插头 4.2. M.2 接口 M.2 接口是为适应模块而设计的。模块通过 M.2 连接器 U0301 连接到 EVB。该接口便于您测试模块的 功能或基于该模块开发应用程序。 表 5：M.2 接口描述 位号 U0301 描述 M.2 标准接口 模块和 EVB 的连接方式如下图所示。 U0301 U0301 上海移远通信技术股份有限公司 图 8：模块和 EVB 连接 18 / 40 M.2-FPC EVB 用户指导 4.3. USB 接口 M.2-FPC EVB 提供一个 USB 接口（U0502）用于与主机连接，其中的 VBUS 用于给 EVB 供电。该接 口符合 USB 3.1/3.0/2.0 规范，支持超高速模式（5 Gbps）、高速模式（480 Mbps）和全速模式（12 Mbps）。 此 USB 接口可用于 AT 命令通信、数据传输、GNSS NMEA 语句输出、软件调试和固件升级。 表 6：USB 接口描述 位号 U0502 描述 USB Type-C 接口，支持 USB 3.1，USB 3.0 以及 USB 2.0 通信 使用方法：把此处拨码开关（S1102）的 P2 拨到 ON 端，模块的 USB 连接 U0502 后，才能正常使用。 （详情见第 4.10.2 章） 拨码开关 M.2 USB U0502 图 9：M.2 模块 USB 接口（U0502） 上海移远通信技术股份有限公司 19 / 40 M.2-FPC EVB 用户指导 4.4. USB-to-UART 接口 M.2-FPC EVB 提供一个 USB-to-UART 接口。此接口用于 Linux 控制台，将日志 UART 信号转为 USB 2.0 信号用于调试。 表 7：USB-to-UART 接口描述 位号 U0702 J0702 描述 用于将调试 UART 转换成 USB 2.0 信号 用于将模块的测试点 DBG_TXD 和 DBG_RXD 以及 GND 连接到 EVB 使用 USB-to-UART 接口前，模块的 DBG_TXD 和 DBG_RXD 应连接到 EVB 上 J0702 对应的位置。 U0301 J0702 U0702 · 图 10：USB-to-UART 接口（U0702） 上海移远通信技术股份有限公司 20 / 40 USB-to-UART 接口的结构框图如下图所示。 M.2-FPC EVB 用户指导 USB Type-C U0702 USB转UART 1.8/3.0 V 电平转换 1.8 V 切换开关 U0301 M.2接口 J0702 测试点 图 11：USB-to-UART 接口（U0702）结构框图 4.5. (U)SIM 卡接口 M.2-FPC EVB 有两个自弹式(U)SIM 卡（1.8/3.0 V）接口 J1001 和 J1002。 表 8：(U)SIM 卡接口描述 位号 J1001 J1002 描述 (U)SIM1 连接器 (U)SIM2 连接器 下图显示了(U)SIM 卡连接器的简化连接示意图。 模块 USIM_VDD USIM_RST USIM_CLK USIM_DATA GND 自弹式 C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK C7 USIM_DATA (U)SIM卡连接器 USIM_DET CD USIM_DET J1001/J1002 图 12：(U)SIM 卡连接器的简化连接示意图 上海移远通信技术股份有限公司 21 / 40 下图显示了 J1001 和 J1002 的引脚分布和定义。 M.2-FPC EVB 用户指导 CD C7 C3C6C2C5C1 J1001 CD C7C3C6C2C5C1 J1002 图 13：J1001 和 J1002 引脚分布 表 9：J1001/1002 引脚定义 引脚号 引脚名 I/O C1 USIM_VDD PO C2 USIM_RST DO C3 USIM_CLK DO C5 GND - C6 VPP - C7 USIM_DATA DIO CD USIM_DET DI 描述 (U)SIM 卡电源，由模块提供 (U)SIM 卡复位 (U)SIM 卡时钟 地 (U)SIM 卡数据 (U)SIM 卡检测 4.6. 状态指示灯 M.2-FPC EVB 提供两个状态指示灯（D0203 和 D0204）。 上海移远通信技术股份有限公司 22 / 40 表 10：状态指示灯描述 位号 D0204 D0203 描述 电源开/关指示灯，指示 EVB 的电源状态 灯亮：EVB 通电 灯灭：EVB 断电 模块射频状态指示灯 灯亮：射频功能开启 灯灭：射频功能关闭 状态指示灯位置如图所示。 D0204 D0203 M.2-FPC EVB 用户指导 图 14：状态指示灯 4.7. 单片机* M.2-FPC EVB 有一个单片机。 表 11：单片机描述 位号 U0902 J0901 描述 单片机 单片机 USB 接口 上海移远通信技术股份有限公司 23 / 40 J0902 S0901 单片机的位置如图所示。 单片机 JTAG 接口 单片机复位按键 单片机USB 单片机JTAG J0901 J0902 M.2-FPC EVB 用户指导 单片机复位 S0901 单片机 U0902 图 15：单片机相关器件位置 单片机相关功能，等待后续开发验证。 4.8. 100 MHz 时钟 本节介绍了实现 PCIe 的 100 MHz 时钟输出方法。100 MHz 时钟仅在特定的软硬件版本做验证使用。 开启 EVB 板 100 MHz 时钟前，需完成以下操作： ⚫ 贴上 R0350、R0351 的 0 Ω 电阻。 ⚫ 打开 S0401 的第三个开关（P3）（拨到图中左端，详情见第 4.10.2 章）。 上海移远通信技术股份有限公司 24 / 40 M.2-FPC EVB 用户指导 S0401 的 P3 贴上 R0350、 R0351 的 0 Ω 电阻 图 16：100 MHz 时钟 4.9. 天线接口 该 EVB 有四个天线接口。如果模块需要用到天线功能，可以由此天线接口，接入天线。 表 12：天线接口描述 位号 J1302 J1304 J1306 J1308 描述 外接天线接口 上海移远通信技术股份有限公司 25 / 40 天线接口的位置如下图所示。 M.2-FPC EVB 用户指导 J1302 J1304 J1306 J1308 图 17：天线接口示意图 4.10. 开关 4.10.1. 电源切换开关 表 13：电源切换开关描述 位号 S0201 描述 选择模块供电路径 此开关控制 EVB 电源，位置如图所示。 电源切换开关 S0201 · U0702 U0502 PWR_EXT端 USB的5 V供电 USB的5 V供电 耗流测试 外接电源 H0201 PWR_FPC端 图 18：电源切换开关示意图 适配器5 V供电 J0101 上海移远通信技术股份有限公司 26 / 40 M.2-FPC EVB 用户指导 表 14：电源开关使用说明 开关位置 开关拨到 PWR_EXT 端 开关拨到 PWR_FPC 端 说明 测模块耗流时 H0201 优先供电，外部 5 V 接口或者任意 USB 接口的 5 V 供电 断开。 当没有 H0201 时，使用外部 5 V 接口或者任意 USB 接口的 5 V 供电。 由外接的 FPC 端优先供电，外部 5 V 接口或者任意 USB 接口的 5 V 供电断开。 当没有 FPC 端供电时，使用外部 5 V 接口或者任意 USB 接口的 5 V 供电。 使用场景与方法： ⚫ 用 FPC 连接笔电使用时，不需要加外部电源，开关置于图 18 中 PWR_FPC 端。 ⚫ 只用 EVB 测试时，外部不加电源，开关置于图 18 中 PWR_FPC 端。 ⚫ 测模块耗流时，仅用测试电源连接到 H0201 位置，开关置于图 18 中 PWR_EXT 端。 备注 使用过程中，请不要在接通电源情况下切换此开关。请断开电源后再进行切换。 4.10.2. 拨码开关 拨码开关有 4 个，位置如图： P4 P3 P2 P1 S0401 S1102 S0302 S1101 图 19：拨码开关示意图 上海移远通信技术股份有限公司 27 / 40 M.2-FPC EVB 用户指导 表 15：拨码开关使用说明 位号 序号 功能作用 OFF 时（如图中开关靠右） ON 时（开关靠左） P1 P2 S0401 P3 P4 P1 P2 S1102 P3 P4 P1 P2 S0302 P3 P4 P1 DPR 信号 默认上拉到 1.8 V 拉低到地 FULL_CARD_POWER_OFF#PC PCIE_RESET#_PC PCIE_CLOCK#PC PCIE_WAKE#PC 四个信号控制 由笔电端通过 FPC 控制 PCIe 100 MHz 时钟 IC 控制 不使用 100 MHz 时钟 IC U0702 是否连接到模块 连接到 J0702 测试点 控制 FPC 的 CONFIG 0~3 连接方 向 连接到 M.2 模块 控制模块 USB 连接方向 连接到笔电 由 U0902 的单片机*控 制 时钟 IC 供电；输出 PCIe 100 MHz 的时钟；拉高 PCIE_RESET# 连接到模块引脚 22 与引 脚 28 连接到拨码开关 S1101 连接至 EVB 的 USB Type-C（U0502）接口 W_DISABLE1#信号 默认上拉到 3.3 V 拉低到地，进入飞行模式 W_DISABLE2#信号 COEX3/USB-PCIE_SWITCH 信 号 默认上拉到 3.3 V 默认 100 kΩ 电阻下拉到 地 拉低到地，GNSS 功能 关闭 加上 10 kΩ 电阻的 1.8 V 上拉。 PCM_CLK 信号 默认上拉到 1.8 V 拉低到地 选择(U)SIM1 卡是采用 EVB 的 (U)SIM1 连接器还是笔电的 (U)SIM1 连接器 选择(U)SIM2 卡是采用 EVB 的 (U)SIM2 连接器还是笔电的 (U)SIM2 连接器 使 用 FPC 连 接 到 笔 电 使用 EVB 的(U)SIM1 连 (U)SIM1 连接器 接器 使 用 FPC 连 接 到 笔 电 使用 EVB 的(U)SIM2 连 (U)SIM2 连接器 接器 CONFIG_0_DBG 默认上拉到 3.3 V 拉低到地 P2 S1101 P3 CONFIG_1_DBG CONFIG_2_DBG 默认上拉到 3.3 V 默认上拉到 3.3 V 拉低到地 拉低到地 P4 CONFIG_3_DBG 默认上拉到 3.3 V 拉低到地 上海移远通信技术股份有限公司 28 / 40 M.2-FPC EVB 用户指导 4.11. 测试点 M.2-FPC EVB 提供测试点，帮助您获得某些信号的相应波形。下图为 J1201、J1202、J1203、J0702 的测试点。 J1203 J1202 J1201 2 4 6 8 10 12 14 16 1 3 5 7 9 11 13 15 图 20：J1201、J1202、J1203 测试点 1 2 3 J0702 图 21：J0702 测试点 上海移远通信技术股份有限公司 29 / 40 表 16：J1201、J1202、J1203、J0702 测试点定义 J1201 测试点编号 1 2 3 4 5 6 7 8 测试点名称 模块对应引脚 PWR_1V8 - GND - PCIE_WAKE#_PC - GND - COEX3/USB-PCIE_S - WITCH PWR_3V3_FPC - COEX_RXD 62 PWR_INT_TURN_OFF - 9 COEX_TXD 64 10 NC - 11 ANT_CONFIG 68 12 13 14 15 16 J1202 测试点编号 1 2 3 RESET#_PC - PWR_3V3 - PCIE_RESET#_PC - USB_VDD_3V3 - USB_VBUS_DBG - 测试点名称 模块对应引脚 FULL_CARD_POWER - _OFF#_PC ANTCTL0 59 CONFIG_0_M.2 21 M.2-FPC EVB 用户指导 描述 1.8 V 供电 地 笔电端 PCIE_WAKE 信号 地 COEX3/USB-PCIE_SWITCH 信号，默认 100 kΩ 下拉 3.3 V 供电 连接模块的引脚 62 控制 PWR_3V3 对 PWR_MODLE_3V3 的电源供电使能 连接模块的引脚 64 连接模块的引脚 68 笔电端 RESET 信号输出，可以控制模块 复位 3.3 V 供电 笔电端 PCIE_RESET#控制信号 TTL 转 USB 的 3.3 V 供电 USB 供电 描述 FPC开机信号 连接模块的引脚 59 连接模块的引脚 21 上海移远通信技术股份有限公司 30 / 40 M.2-FPC EVB 用户指导 4 5 6 7 8 9 10 11 12 13 14 15 16 J1203 测试点编号 1 2 3 4 5 6 7 8 9 10 ANTCTL1 61 CONFIG_1_M.2 69 ANTCTL2 63 CONFIG_2_M.2 75 ANTCTL3 65 CONFIG_3_M.2 1 DPR 25 PWRKEY 6 PCIE_RESET# 50 GND - PCIE_CLKREQ# 52 GND - PCIE_WAKE# 54 连接模块的引脚 61 模块内部接地 连接模块的引脚 63 模块内部悬空 连接模块的引脚 65 模块内部悬空 连接模块的引脚 25 模块开关机控制信号 PCIe 复位，低电平有效 地 PCIe 时钟请求，低电平有效 地 PCIe 唤醒，低电平有效 测试点名称 PWR_MODULE_3V3 GND PWR_MODULE_3V3 GND NC VDDIO_1V8 WWAN_LED# WAKE_ON_WAN# PCM_CLK W_DISABLE2# 模块对应引脚 描述 2、4、70、72、74 模块供电 - 地 2、4、70、72、74 模块供电 - 地 38 连接模块的引脚 38 24 连接到模块的引脚 24 10 射频指示灯，低电平有效 23 连接到模块的引脚 23 20 连接模块的引脚 20 GNSS 功能控制，低电平有效，关闭 26 GNSS 功能 上海移远通信技术股份有限公司 31 / 40 11 12 13 14 15 16 J0702 测试点编号 1 2 3 PCM_IN/DBG_UART_ 22 RX_1V8 W_DISABLE1# 8 PCM_SYNC/DBG_UA 28 RT_TX_1V8 RFFE_CLK 56 PCIE_CLKREQ#_PC - RFFE_DATA 58 测试点名称 GND RX_1V8 TX_1V8 模块对应引脚 - M.2-FPC EVB 用户指导 连接模块的引脚 22 飞行模式控制，低电平有效 连接模块的引脚 28 连接模块的引脚 56 笔电端时钟请求控制信号 连接模块的引脚 58 描述 地 URTA 的 RX 信号 URAT 的 TX 信号 上海移远通信技术股份有限公司 32 / 40 M.2-FPC EVB 用户指导 5 操作程序说明 本章介绍如何使用 M.2-FPC EVB 对模块进行测试和评估。 M.2-FPC EVB 主要有 2 个应用场景：通过 FPC 转接板和 FPC 连接 M.2 模块在笔电上进行测试以及 M.2 模块在 EVB 板上进行测试。 5.1. 笔电测试 5.1.1. 笔电测试连接方式 使用 M.2 模块在笔电上进行使用测试时，首先应当按照以下方式进行连接： 图 22：M.2-FPC EVB 装配图 上海移远通信技术股份有限公司 33 / 40 M.2-FPC EVB 用户指导 图 23：M.2-FPC EVB 连接笔电装配图 5.1.2. 笔电测试上电前拨码开关预设 由于 EVB 中拨码开关较多，所以在不同的应用场景下，会有不同拨码开关的预设。本章节描述在 FPC 连接笔电情况下的拨码开关设置。如图配置（详情见第 4.10.2 章）： 电源切换开关（S0201）切换到 PWR_FPC 端。拨码开关（S0401、S1102、S0302、S1101）全部切 换到 OFF 端，即下图所示右端。 上海移远通信技术股份有限公司 34 / 40 S0201 U0301 M.2-FPC EVB 用户指导 S0401 S1102 S0302 S1101 图 24：M.2-FPC EVB 连接笔电拨码开关位置 5.1.3. 模块开机 1. 将模块连接到 EVB：将模块插入 EVB 上的 M.2 连接器（U0301），然后用螺钉固定模块； 2. 将天线连接到模块； 3. 将 S0201（电源切换开关）切换到 PWR_FPC 端，请勿通过其他电源接口为 EVB 供电； 4. 将 EVB 通过 FPC 连接到笔电。D0204（电源开/关指示灯）亮起，表示 EVB 的电源已就绪，模块 开机。此时，当 RF 功能开启时，D0203（模块射频状态指示灯）亮起，具体信息可参考第 4.6 章。 5.2. EVB 测试 5.2.1. EVB 模块连接方式 使用 M.2 模块在 EVB 上进行使用测试时，首先应当将模块插入 EVB 上的 M.2 连接器（U0301），然后 用螺钉固定模块，如下图所示： 上海移远通信技术股份有限公司 35 / 40 M.2-FPC EVB 用户指导 图 25：M.2-FPC EVB 测试装配图 5.2.2. EVB 测试上电前拨码开关预设 由于 EVB 中拨码开关较多，所以在不同的应用场景下，会有不同拨码开关的预设。本章节描述在 EVB 测试情况下的拨码开关设置。如图配置（详情见第 4.10.2 章）： 电源切换开关（S0201）切换到 PWR_FPC 端。拨码开关 S0401 的 P3，S1102 的 P2 以及 S0302 的 P3 与 P4 切换到 ON 端，即图 24 所示左端，其他拨码开关切换到 OFF 端，即图 24 所示右端。 5.2.3. 模块开机 1. 将模块连接到 EVB：将模块插入 EVB 上的 M.2 连接器（U0301），然后用螺钉固定模块； 2. 将(U)SIM 卡插入 EVB 上的(U)SIM 卡连接器，并将天线连接到模块； 3. 将 S0201（电源切换开关）切换到 PWR_FPC 端； 4. 将 EVB 连接到 5 V 电源适配器上，或使用 USB Type-C 线将 EVB 连接到笔电。D0204（电源开/ 关指示灯）亮起，表示 EVB 的电源已就绪，模块开机。此时，当 RF 功能开启时，D0203（模块 射频状态指示灯）亮起，具体信息可参考第 4.6 章。 上海移远通信技术股份有限公司 36 / 40 M.2-FPC EVB 用户指导 5.2.4. USB 接口通信 1. 将模块开机。 2. 通过 USB Type-C（U0502）接口，使用 USB 数据线连接 EVB 和笔电，然后在笔电上安装 CP210X 驱动程序。安装 USB 驱动后，可以在 PC 的设备管理器中查看 USB 端口号，如下图所示： 图 26：USB 端口 3. 安装并使用 Quectel 提供的 QCOM 工具实现模块与笔电之间的通信。QCOM 上的 COM 端口设置 如下图所示：选择正确的'COM Port'（COM 端口，上图中的'USB AT Port'）并设置正确的 'Baudrate'（波特率，如 115200 bps）。有关 QCOM 工具使用和配置的详细信息，请参阅文档 [2]。 图 27：QCOM 上的 COM 端口设置（通过 USB AT Port 连接） 5.3. 模块关机 如下两种方法可以将模块关机。 ⚫ 软件关机：执行 AT+QPOWD 关机。这是最好、最安全的方法，在关机前，模块会从网络上注销 并保存数据。用 AT 命令关闭模块时，请在执行关机命令后将 PWRKEY 保持在高电平，否则在关 机成功后，模块将再次开机。 ⚫ 硬件关机：断电。 备注 有关 AT+QPOWD 的详细信息，请参阅相应模块的 AT 命令手册。 上海移远通信技术股份有限公司 37 / 40 M.2-FPC EVB 用户指导 5.4. 模块复位 复位功能仅在紧急情况下使用。例如，由于某些严重问题，模块超过 5 秒没有响应。 按下按钮 S0301（M.2 模块复位）后释放以复位模块。由于复位功能会使模块初始化，此操作可能会 导致存储器中存储的信息丢失。 5.5. 耗流测试 M.2-FPC EVB 测试模块的耗流，具体测试步骤如下： 1. 将 S0201 电源切换开关切换到 PWR_EXT 端。H0201 连接到外部电源，为模块单独供电。 2. 按照第 5.1 章或第 5.2 章所述流程，使用 EVB 对模块进行操作，然后测试电流消耗。 S0201 PWR_EXT端 GND PWR_FPC端 耗流测试 外接电源 H0201 图 28：耗流供电连接图 上海移远通信技术股份有限公司 38 / 40 M.2-FPC EVB 用户指导 6 附录 参考文档和术语缩写 表 17：参考文档 文档名称 [1] Quectel_EVB 适用模块一览表 [2] Quectel_QCOM_User_Guide [3] Quectel_QFlash_用户指导 [4] Quectel_LTE&5G_Windows_USB_Driver_安装指导 表 18：术语缩写 缩写 COM DC DI DO EVB FPC GND GNSS I/O JTAG LED LTE 英文全称 Communication Port Direct Current Digital Input Digital Output Evaluation Board Flexible Printed Circuit Ground Global Navigation Satellite System Input/Output Joint Test Action Group Light Emitting Diode Long Term Evolution 中文全称 通信口 直流电 数字输入 数字输出 评估板 柔性电路板 地 全球导航卫星系统 输入/输出 联合测试工作组 发光二极管 长期演进 上海移远通信技术股份有限公司 39 / 40 M.2-FPC EVB 用户指导 PCB PCM PCIe PO RF UART USB (U)SIM Printed Circuit Board 印刷电路板 Pulse Code Modulation 脉冲编码调制 Peripheral Component Interconnect Express 快捷外围部件互连标准 Power Output 电源输出 Radio Frequency 射频 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module 通用用户识别模块 上海移远通信技术股份有限公司 40 / 40

LG69T (AA,AD) EVB User Guide GNSS Module Series Version: 1.0 Date: 2022-06-20 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LG69T(AA,AD)_EVB_User_Guide 1 / 31 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. LG69T(AA,AD)_EVB_User_Guide 2 / 31 GNSS Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any terminal incorporating Quectel GNSS module. Manufacturers of the terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Ensure that the product may be used in the country and the required environment, as well as that it conforms to the local safety and environmental regulations. Keep away from explosive and flammable materials. The use of electronic products in extreme power supply conditions and locations with potentially explosive atmospheres may cause fire and explosion accidents. The product must be powered by a stable voltage source, while the wiring must conform to security precautions and fire prevention regulations. Proper ESD handling procedures must be followed throughout the mounting, handling and operation of any devices and equipment that incorporate the module to avoid ESD damages. LG69T(AA,AD)_EVB_User_Guide 3 / 31 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LG69T (AA,AD) EVB User Guide GNSS Module Series EVB User Guide Released Revision History Version 1.0 Date 2020-04-23 2022-06-20 Description Creation of the document First official release LG69T(AA,AD)_EVB_User_Guide 4 / 31 GNSS Module Series Contents Safety Information...................................................................................................................................... 3 About the Document .................................................................................................................................. 4 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 Introduction ......................................................................................................................................... 8 1.1. Special Mark .............................................................................................................................. 8 2 General Overview................................................................................................................................ 9 2.1. EVB Kit ....................................................................................................................................... 9 2.2. Connect Cables and Antenna to EVB...................................................................................... 10 3 EVB User Interfaces.......................................................................................................................... 11 3.1. EVB Top View............................................................................................................................11 3.2. Board User Interfaces .............................................................................................................. 12 4 DR Application .................................................................................................................................. 15 4.1. Installation ................................................................................................................................ 15 4.2. Calibration Procedure .............................................................................................................. 16 4.2.1. EVB Installation Angle Confirmation ............................................................................. 17 4.2.2. Yaw Rate Calibration..................................................................................................... 17 4.3. Calibration Result Monitoring................................................................................................... 18 5 Communication via QCOM Tool...................................................................................................... 19 5.1. Communication via Micro-USB Interface................................................................................. 19 6 Test via QGNSS Tool ........................................................................................................................ 21 6.1. QGNSS Setting ........................................................................................................................ 21 6.1.1. QGNSS Interface Explanation ...................................................................................... 23 7 Firmware Download and Upgrade via GNSSFlashTool ................................................................ 25 7.1. Firmware Download in Boot Download Mode ......................................................................... 25 7.2. Firmware Upgrade in Normal Operating Mode........................................................................ 27 8 Appendix Reference ......................................................................................................................... 30 LG69T(AA,AD)_EVB_User_Guide 5 / 31 GNSS Module Series Table Index Table 1: Special Mark ................................................................................................................................... 8 Table 2: List of Kit Components ................................................................................................................... 9 Table 3: Detailed EVB Interfaces ............................................................................................................... 12 Table 4: J501 Pin Detailed Description ...................................................................................................... 13 Table 5: J302 Pin Detailed Description ...................................................................................................... 14 Table 6: QGNSS Interface Explanation...................................................................................................... 23 Table 7: Related Document........................................................................................................................ 30 Table 8: Terms and Abbreviations .............................................................................................................. 30 LG69T(AA,AD)_EVB_User_Guide 6 / 31 GNSS Module Series Figure Index Figure 1: EVB Kit Accessories ..................................................................................................................... 9 Figure 2: EVB and Components Assembly................................................................................................ 10 Figure 3: EVB Top View ..............................................................................................................................11 Figure 4: IMU Axis Direction....................................................................................................................... 15 Figure 5: Installation Diagram .................................................................................................................... 16 Figure 6: LG69T (AA) Calibration Status ................................................................................................... 18 Figure 7: USB Ports ................................................................................................................................... 19 Figure 8: COM Port Setting Interface of QCOM ........................................................................................ 19 Figure 9: NMEA Sentence Output – Displayed on QCOM Tool Interface ................................................. 20 Figure 10: COM Port Setting Interface of QGNSS .................................................................................... 21 Figure 11: QGNSS Interface (Connected) – LG69T (AA) ......................................................................... 22 Figure 12: QGNSS Interface (Connected) – LG69T (AD) ......................................................................... 22 Figure 13: Firmware Download – Step 1 ................................................................................................... 25 Figure 14: Firmware Download – Step 2 ................................................................................................... 26 Figure 15: Firmware Download – Step 3 ................................................................................................... 26 Figure 16: Firmware Download – Step 4 ................................................................................................... 26 Figure 17: Successful Firmware Download – Step 5................................................................................. 27 Figure 18: Firmware Upgrade – Step 1...................................................................................................... 27 Figure 19: Firmware Upgrade – Step 2...................................................................................................... 28 Figure 20: Firmware Upgrade – Step 3...................................................................................................... 28 Figure 21: Firmware Upgrade – Step 4...................................................................................................... 28 Figure 22: Successful Firmware Upgrade – Step 5 ................................................................................... 29 LG69T(AA,AD)_EVB_User_Guide 7 / 31 GNSS Module Series 1 Introduction This document provides information on the steps needed to evaluate the Quectel LG69T (AA) and LG69T (AD) using the Evaluation Board (EVB). The EVB is a reference tool that allows you to become familiar with the LG69T (AA) and LG69T (AD). Specifically, the document is divided into several sections: ⚫ Chapter 2 provides the general overview of EVB Kit. ⚫ Chapter 3 describes the EVB user interfaces. ⚫ Chapter 4 describes DR application. ⚫ Chapter 5 describes how to communicate with the modules via QCOM tool. ⚫ Chapter 6 describes how to test the modules via QGNSS tool. ⚫ Chapter 7 describes how to download and upgrade the module firmware via the GNSSFlashTool; ⚫ Chapter 8 is an appendix, which summarizes the relevant documents, terms and abbreviations appearing herein. ⚫ NOTE For EVB schematic and PCB layout design files, contact Quectel Technical Support (support@quectel.com). 1.1. Special Mark Table 1: Special Mark Mark * Definition Unless otherwise specified, when an asterisk (*) is used after a function, feature, interface, pin name, AT command, or argument, it indicates that the function, feature, interface, pin, AT command, or argument is under development and currently not supported; and the asterisk (*) after a model indicates that the sample of the model is currently unavailable. LG69T(AA,AD)_EVB_User_Guide 8 / 31 GNSS Module Series 2 General Overview 2.1. EVB Kit The EVB Kit includes: Evaluation Board (EVB), Quectel Active GNSS Antenna, Micro-USB Cable, Type-B USB Cable, Bolts and Coupling Nuts. Download the software tools (QCOM, QGNSS and GNSSFlashTool) from our website Download Zone or request them from Quectel Technical Support. The EVB Kit contents are shown in the figure below. Check Table 2 for details. Micro-USB cable EVB Active GNSS antenna Bolts and coupling nuts Figure 1: EVB Kit Accessories Type-B USB Cable Table 2: List of Kit Components Items EVB USB Cable Description Evaluation Board Size: 100 mm × 175 mm Micro-USB Cable Quantity 1 1 LG69T(AA,AD)_EVB_User_Guide 9 / 31 GNSS Module Series GNSS Antenna Instruction Sheet Others Type-B USB Cable 1 Quectel Active GNSS antenna: YEGM011BA Request the Antenna Datasheet from Quectel Technical 1 Support. Sheet providing instructions on how to connect the EVB and its components, detailed information on EVB 1 contents, etc. Bolts and Coupling Nuts 4 pairs 2.2. Connect Cables and Antenna to EVB The connection between the EVB and its components is shown in the figure below. For more information on how to connect the EVB and its components, refer to the instruction sheet inside the EVB Kit. Figure 2: EVB and Components Assembly ⚫ NOTE Make sure that the Active GNSS Antenna is placed with a clear line of sight to the sky. LG69T(AA,AD)_EVB_User_Guide 10 / 31 GNSS Module Series 3 EVB User Interfaces 3.1. EVB Top View EVB top view is shown in the figure below. D309 D310 TXD/1PPS GEO_F indication LED indication LED J501 OBD (Supported by LG69T (AA)) J401 LG69T_ANT D109 5V/3.3V indication LED U301 GNSS module J302 Test points S201 RESET_GNSS S202 BOOT_GNSS J201 USB_UART S101 Power switch Figure 3: EVB Top View EVB version J101 POWER_5V LG69T(AA,AD)_EVB_User_Guide 11 / 31 GNSS Module Series 3.2. Board User Interfaces The EVB interfaces are detailed in the table below. Table 3: Detailed EVB Interfaces Function Interfaces Description Power Supply J101 POWER_5V Power supply input: ⚫ DC power supply: 4.5–5.5 V, typ. 5.0 V. ⚫ Current capability should be > 1 A. Communication Interface J201 USB_UART Enhanced COM Port: Used for configuring the modules, firmware upgrade, and NMEA/RTCM message output. Standard COM Port: No message input/output, reserved for future use. RF Input J401 LG69T_ANT Antenna Connector The antenna in the kit supports: ⚫ GPS/QZSS L1 C/A and L5 ⚫ Galileo E1 and E5a ⚫ BDS B1I and B2a ⚫ SBAS * L1 D309 TXD/1PPS indication LED 1PPS (Red LED) TXD (Green LED) Flash: Outputs pulse signal of 1 Hz. Extinct: 1PPS is unavailable. Flash: Message output from UART1 TXD. Extinct/Bright: No message output from UART1 TXD. Signal Indication D109 5 V/3.3 V Indication LED 3.3 V (Red LED) EVB 3.3 V power indicator. 5 V EVB 5 V power indicator. (Green LED) D310 GEO_F Indication LED GEO_F (Red LED) Geofence indicator. S101 Power Switch Power the EVB on/off. Switch Buttons S201 and RESET_GNSS S202 BOOT_GNSS Short press the button to reset the modules. Press and hold the button first and then flip the power switch to ON position to make the modules enter Boot download mode. Test Points J501 Pins are detailed in Table 4 below. LG69T(AA,AD)_EVB_User_Guide 12 / 31 OBD 1 J302 Test Points Test points distributions are shown below: J501 Pin Assignment: NC NC NC WHEELTICK GNSS Module Series Pins are detailed in Table 5 below. NC FWD NC GND Table 4: J501 Pin Detailed Description Pin Name I/O NC - NC - NC - NC - NC - WHEELTICK DI FWD DI GND - J302 Pin Assignment: SPI_MOSI SPI_CS SPI_SCK SPI_MISO Description Odometer wheel-tick input. Forward/Backward signal input. Low level: Forward. Ground TXD1 TXD2 RXD1 RXD2 1PPS GND 1 The LG69T (AA) module supports the OBD interface, whereas LG69T (AD) module does not. LG69T(AA,AD)_EVB_User_Guide 13 / 31 Table 5: J302 Pin Detailed Description Pin Name I/O SPI_MOSI - SPI_SCK - TXD1 DO RXD1 DI 1PPS DO SPI_CS - SPI_MISO - TXD2 DO RXD2 DI GND - GNSS Module Series Description NC (Not connected) NC TXD1 Transmit data RXD1 Receive data One pulse per second NC NC TXD2 Transmit data RXD2 Receive data Ground LG69T(AA,AD)_EVB_User_Guide 14 / 31 GNSS Module Series 4 DR Application LG69T (AA) supports Dead Reckoning (DR) function. This chapter outlines how to configure the DR function. A valid module calibration is essential for utilizing its DR capabilities, see Chapter 4.2 for details. Fix the module on the vehicle frame. Any displacement, turn or tilt of the device, however small, will cause performance issues and/or void calibration. The IMU axis direction inside the module is presented below for your reference. Z Y X Figure 4: IMU Axis Direction 4.1. Installation Installation of LG69T (AA) EVB allows for flexibility, since it is not dependent on angle or direction. The module can automatically identify the installation angle deviation and compensate for it through internal algorithm calculations. The installation diagram is presented in the figure below: LG69T(AA,AD)_EVB_User_Guide 15 / 31 GNSS Module Series The car wheeltick access port Wheeltick input RF input EVB must be fixed on the car frame Power supply and get data PC Figure 5: Installation Diagram 4.2. Calibration Procedure This chapter details the calibration steps of LG69T (AA) EVB. Before calibration, it is necessary to confirm the EVB installation angle. The calibration procedure is based on the premise that the user has fixed the EVB on the car frame. No displacement or rotation of the EVB should occur after calibration, as described in the following chapters. The calibration procedure needs to be repeated only in the following cases: ⚫ The EVB has been moved and reinstalled. ⚫ During a DR cold start and when the NVM is blank or invalid. ⚫ NOTE Please strictly follow the steps in Chapter 4.2.1 to complete the angle calibration procedure, because any improper handling may affect the calibration. LG69T(AA,AD)_EVB_User_Guide 16 / 31 GNSS Module Series 4.2.1. EVB Installation Angle Confirmation Before the 6-axis accelerometer sensor is available, the EVB installation angle needs to be confirmed by following steps: Step 1: Install the EVB on a vehicle and connect the antenna. Step 2: Start the vehicle and power on the EVB. Step 3: Keep the vehicle stationary for at least 20 s on a flat road (the tolerance of the gravity direction is 1°–2°). Step 4: Drive the vehicle for 1 minute. Step 5: Stop the vehicle and keep it still for at least 5 seconds. The module saves the calculated installation angle to the flash memory through software logic. 4.2.2. Yaw Rate Calibration The yaw rate calibration steps of LG69T (AA) EVB are as follows: Once the installation angle is confirmed, the following steps should be performed to fine tune the calibration accurately: Step 1: Based on Step 5 above, the yaw rate offset will be automatically initialized with a reliable value. After it is initialized, drive in a straight road (speed > 30 km/h) for at least 5 minutes. Step 2: Drive in areas rich in curved roads (speed > 30 km/h). This is required for calibrating the yaw rate gain. It is important to make tight turns (with narrow curvature radius). Typical scenarios that allow proper performance of this step involve roundabouts, tight turns, and sharp bends greater than 90 degrees. Broader turns (e.g. smooth turns on highway, lane changes, etc.) will not work. Please note that the success of this operation does not depend on its duration, but rather on the number of valid turns. In order to have a fine-tuned yaw rate gain, it is suggested that the firstboot calibration route should include at least 10 tight turns described above. The same turn can be repeated many times. It is most important to perform all these operations under adequate GNSS signal conditions, which means that the antenna must have maximum sky visibility. Thus, the calibration should be performed under clear sky conditions, i.e. in the area away from high-rise buildings, forests, tunnels and any other element that may cause signal blocking or reflection. LG69T(AA,AD)_EVB_User_Guide 17 / 31 GNSS Module Series NOTE Please note that the hybrid GNSS/DR navigation mode will not be available until a proper calibration procedure is performed, and that only single GNSS navigation will be available. 4.3. Calibration Result Monitoring The calibration result will be reported in an NMEA message. The following figure illustrates how to check the calibration status message. Step 1: Enter the related software command in the 'Text Console' to filter out the NMEA message, as shown in the figure below. For more information on the command, see document [1]. Step 2: When the fifth parameter becomes '1', it means that the whole calibration procedure has been completed. Figure 6: LG69T (AA) Calibration Status LG69T(AA,AD)_EVB_User_Guide 18 / 31 GNSS Module Series 5 Communication via QCOM Tool This chapter explains how to use the QCOM tool to communicate with the module via the Micro-USB interface. For more information, see document [2]. Download the QCOM tool from our website Download Zone or request it from Quectel Technical Support. 5.1. Communication via Micro-USB Interface Step 1: Connect the EVB and the PC with a Micro-USB cable. Step 2: Connect the EVB and the PC with a Micro-USB cable. Flip the Power switch (S101) to ON position to power on the EVB. Step 3: View the USB port numbers in the Device Manager. Figure 7: USB Ports Step 4: Install the QCOM tool provided by Quectel. The COM interface for QCOM port setting is shown in the figure below (the LG69T (AA) module supports 460800 bps 2 and LG69T (AD) module supports 115200 bps 2 by default). Figure 8: COM Port Setting Interface of QCOM 2 UART interface default settings vary depending on software versions. LG69T(AA,AD)_EVB_User_Guide 19 / 31 GNSS Module Series Step 5: Select the correct 'COM Port' (shown in Figure 7 above) and the 'Baudrate'. Step 6: Click 'Open Port' to establish communication with the EVB. The NMEA message output by the module will be displayed in the receiving bar of the QCOM tool. Figure 9: NMEA Sentence Output – Displayed on QCOM Tool Interface LG69T(AA,AD)_EVB_User_Guide 20 / 31 GNSS Module Series 6 Test via QGNSS Tool This chapter explains how to use the QGNSS software tool for verifying the status of GNSS modules. You can request the QGNSS from Quectel Technical Support. For more information on QGNSS use, see document [3]. 6.1. QGNSS Setting Step 1: Assemble the EVB components. Step 2: Flip the Power Switch (S101) to ON position to power on the EVB. Step 3: Start the QGNSS and click 'Setting' and 'Serial Port Configuration'. In the 'Model' list, LG69T (AA) module select 'LG69T', and LG69T (AD) module select 'None' (the LG69T (AA) module supports 460800 bps 3 and LG69T (AD) module supports 115200 bps 3 by default). Figure 10: COM Port Setting Interface of QGNSS 3 UART interface default settings vary depending on software versions. LG69T(AA,AD)_EVB_User_Guide 21 / 31 GNSS Module Series Step 4: Click the 'Connect or disconnect' button. Depending on the module version, the interface shown below appears once the module is connected. Figure 11: QGNSS Interface (Connected) – LG69T (AA) Figure 12: QGNSS Interface (Connected) – LG69T (AD) LG69T(AA,AD)_EVB_User_Guide 22 / 31 GNSS Module Series 6.1.1. QGNSS Interface Explanation You can view GNSS information, such as C/N0 message, time, position, speed, and precision in the QGNSS interface. See the following table to find out more about these parameters. Table 6: QGNSS Interface Explanation Icon Explanation This sky view interface shows the position of the satellites in use. 1) The left column icon shows the satellites in use and their number. ⚫ BDS: 4 ⚫ GLO (GLONASS): 0 ⚫ GPS: 11 ⚫ GAL (Galileo): 0 ⚫ QZSS: 0 ⚫ NavIC (IRNSS)SBAS: 0 2) The grid map on the right shows the position of the satellites in use. GPS satellite BDS satellite GLONASS satellite Galileo satellite QZSS satellite NavIC (IRNSS) satellite ⚫ PRN 30 C/N0 is 39 dB-Hz. ⚫ Column in bright red means that the navigation data of the satellites are in use. ⚫ PRN 1 C/N0 is 21 dB-Hz. ⚫ Column in light red means that the navigation data of this satellites are not in use. LG69T(AA,AD)_EVB_User_Guide 23 / 31 GNSS Module Series ⚫ Longitude (unit: degree) ⚫ Latitude (unit: degree) ⚫ Altitude (MSL) (unit: m) ⚫ Altitude (EPH) (unit: m) ⚫ Receiver speed (unit: km/h) ⚫ Horizontal dilution of precision ⚫ Position dilution of precision ⚫ Fix Mode: 2D, 3D ⚫ Quality Indicator: GPS SPS mode ⚫ UTC date and time ⚫ Time of day 4 (unit: second) ⚫ Age of differential GPS data ⚫ Last TTFF(s) (unit: second) ⚫ Total Times ⚫ Fixed Points ⚫ RTK Float ⚫ RTK Fixed 4 Total number of seconds elapsed since midnight of the current day. LG69T(AA,AD)_EVB_User_Guide 24 / 31 GNSS Module Series 7 Firmware Download and Upgrade via GNSSFlashTool The modules upgrade firmware with GNSSFlashTool via the UART interface. You can request the GNSSFlashTool from Quectel Technical Support. For more information about GNSSFlashTool use, see document [4]. 7.1. Firmware Download in Boot Download Mode Before you start the module firmware download process: First: Connect the EVB to a PC with a Micro-USB cable. Second: Flip the Power Switch (S101) to OFF position before powering on the EVB Firmware download steps in Boot download mode: Step 1: Open GNSSFlashTool or click 'Tools' and select 'Firmware Download' in QGNSS tool. Figure 13: Firmware Download – Step 1 LG69T(AA,AD)_EVB_User_Guide 25 / 31 GNSS Module Series Step 2: Select 'LG69TAA_Download' for the modules as shown in the figure below. Figure 14: Firmware Download – Step 2 Step 3: Click 'Open File' to select module 'LG69TAANR01A01V01_4WDR_ST_BETA0810A_BOOT.bin' for 'LG69TADNR01A01V01_BOOT.bin' for LG69T (AD). firmware, LG69T (AA) e.g. module, Figure 15: Firmware Download – Step 3 Step 4: Confirm the 'Port' and 'Baud Rate' as the enhanced COM Port and then click 'Start' button. Press and hold the BOOT_GNSS button before flipping the power switch to ON position, and then release the BOOT_GNSS button to enter Boot download mode. Figure 16: Firmware Download – Step 4 LG69T(AA,AD)_EVB_User_Guide 26 / 31 GNSS Module Series Step 5: Upon successful firmware download, the GNSSFlashTool green progress bar on the screen will indicate '100%'. Figure 17: Successful Firmware Download – Step 5 7.2. Firmware Upgrade in Normal Operating Mode Before you start the firmware upgrade process, connect the EVB to a PC with a Micro-USB Cable. First: Connect the EVB to a PC with a Micro-USB Cable. Second: Flip the Power Switch (S101) to OFF position before powering on the EVB. Step 1: Open GNSSFlashTool or click 'Tools' and select 'Firmware Download' in QGNSS tool. Figure 18: Firmware Upgrade – Step 1 LG69T(AA,AD)_EVB_User_Guide 27 / 31 GNSS Module Series Step 2: Select 'LG69TAA_Upgrade' in the drop-down box of 'Tool Options'. Figure 19: Firmware Upgrade – Step 2 Step 3: Click 'Open File' to select module firmware, e.g. 'LG69TAANR01A01V01_4WDR_ST_BETA0810A_UPG.bin' for LG69T (AA) and 'LG69TADNR01A01V01_UPG.bin' for LG69T (AD). Figure 20: Firmware Upgrade – Step 3 Step 4: Confirm the 'Port' and 'Baud Rate' as the enhanced COM Port. Click 'Start' button and then flip the power switch to ON position. Press and release RESET_GNSS button on the EVB when the progress bar becomes 98.46%. If the operation is not performed, the firmware download will fail. Figure 21: Firmware Upgrade – Step 4 LG69T(AA,AD)_EVB_User_Guide 28 / 31 GNSS Module Series Step 5: Upon successful firmware upgrade, the GNSSFlashTool green progress bar on the screen will indicate 'PASS'. Figure 22: Successful Firmware Upgrade – Step 5 LG69T(AA,AD)_EVB_User_Guide 29 / 31 8 Appendix Reference Table 7: Related Document Document Name [1] Quectel_LG69T(AA,AD,AI,AJ)_GNSS_Protocol_Specification [2] Quectel_QCOM_User_Guide [3] Quectel_QGNSS_User_Guide [4] Quectel_GNSSFlashTool_User_Guide Table 8: Terms and Abbreviations Abbreviation BDS CEP C/N0 COM Port DI DO DR ESD EVB Galileo GLONASS GNSS GPS Description BeiDou Navigation Satellite System Circular Error Probable Carrier-to-Noise Ratio Communication Port Digital Input Digital Output Dead Reckoning Electrostatic Discharge Evaluation Board Galileo Satellite Navigation System (EU) Global Navigation Satellite System (Russia) Global Navigation Satellite System Global Positioning System GNSS Module Series LG69T(AA,AD)_EVB_User_Guide 30 / 31 I/O LED MISO MOSI MSL NMEA PC PCB 1PPS PRN QZSS RTCM RTK RXD SBAS TTFF TXD USB UTC Input/Output Light Emitting Diode Master In Slave Out Master Out Slave In Mean Sea Level National Marine Electronics Association Personal Computer Printed Circuit Board One Pulse Per Second Pseudorandom Noise Quasi-Zenith Satellite System Radio Technical Commission for Maritime services Real-Time Kinematic Receive Data (Pin) Satellite-Based Augmentation System Time to First Fix Transmit Data (Pin) Universal Serial Bus Coordinated Universal Time GNSS Module Series LG69T(AA,AD)_EVB_User_Guide 31 / 31

SA800U-WF EVB 用户指导 智能模块系列 版本：1.0 日期：2022-06-23 状态：正式文件 SA800U-WF EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 61 SA800U-WF EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 61 SA800U-WF EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或(U)SIM 卡无效时。如果设备支持紧急呼叫功能，请使用紧急呼叫，同时请确保设备开机并 且位于信号强度足够的区域。因不能保证所有情况下网络都能连接，故在紧急情况 下，不能将带有紧急呼叫功能的设备作为唯一的联系方式。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 3 / 61 SA800U-WF EVB 用户指导 文档历史 修订记录 版本 1.0 日期 作者 2022-05-16 Mary SHEN 2022-06-23 Mary SHEN 变更描述 文档创建 正式版本 上海移远通信技术股份有限公司 4 / 61 SA800U-WF EVB 用户指导 目录 安全须知 ........................................................................................................................................................ 3 文档历史 ........................................................................................................................................................ 4 目录 ............................................................................................................................................................... 5 表格索引 ........................................................................................................................................................ 7 图片索引 ........................................................................................................................................................ 8 1 引言 ...................................................................................................................................................... 10 1.1. 特殊符号 ................................................................................................................................ 10 2 产品综述 ............................................................................................................................................... 11 2.1. 俯视图和底视图 ..................................................................................................................... 11 2.2. 应用接口 ................................................................................................................................ 12 3 配件及装配 ........................................................................................................................................... 17 3.1. 配件装配 ................................................................................................................................ 17 3.2. 配件列表 ................................................................................................................................ 18 4 应用接口 ............................................................................................................................................... 20 4.1. 电源供电 ................................................................................................................................ 21 4.1.1. 适配器接口 ..................................................................................................................... 22 4.1.2. 电池接口 ......................................................................................................................... 23 4.2. B2B 和 FPC 接口 ................................................................................................................... 24 4.3. LCM 接口 ............................................................................................................................... 25 4.4. TP 接口 .................................................................................................................................. 27 4.5. 摄像头接口............................................................................................................................. 28 4.6. HDMI 接口 ............................................................................................................................. 31 4.7. USB 接口 ............................................................................................................................... 33 4.7.1. USB Type-C 接口 ........................................................................................................... 33 4.7.2. USB Type-A 接口 ........................................................................................................... 35 4.8. 音频接口 ................................................................................................................................ 36 4.8.1. 扬声器接口 ..................................................................................................................... 37 4.8.2. 耳机接口 ......................................................................................................................... 38 4.8.3. 听筒接口 ......................................................................................................................... 39 4.8.4. 麦克风接口 ..................................................................................................................... 39 4.9. (U)SIM 接口 ........................................................................................................................... 40 4.10. UART 接口............................................................................................................................. 42 4.11. CAN 接口 ............................................................................................................................... 42 4.12. 以太网接口............................................................................................................................. 43 4.13. M.2 接口................................................................................................................................. 44 4.14. SD 卡接口 .............................................................................................................................. 45 4.15. 闪光灯 .................................................................................................................................... 46 4.16. 传感器 .................................................................................................................................... 47 4.17. 紧急下载接口 ......................................................................................................................... 48 上海移远通信技术股份有限公司 5 / 61 SA800U-WF EVB 用户指导 4.18. 4.19. 4.20. 4.21. 马达........................................................................................................................................ 48 按键和开关............................................................................................................................. 49 状态指示灯............................................................................................................................. 51 测试点 .................................................................................................................................... 52 5 操作说明 ............................................................................................................................................... 54 5.1. 模块开机 ................................................................................................................................ 54 5.2. 模块关机 ................................................................................................................................ 55 5.3. USB 接口通信........................................................................................................................ 56 5.4. UART 接口通信...................................................................................................................... 57 5.5. 固件升级 ................................................................................................................................ 58 6 参考文档及术语缩写............................................................................................................................. 60 上海移远通信技术股份有限公司 6 / 61 SA800U-WF EVB 用户指导 表格索引 表 1：特殊符号 ........................................................................................................................................... 10 表 2：SA800U-WF EVB 应用接口 ............................................................................................................. 13 表 3：配件列表 ........................................................................................................................................... 18 表 4：电源描述 ........................................................................................................................................... 21 表 5：B2B 和 FPC 连接器 .......................................................................................................................... 24 表 6：LCM 接口.......................................................................................................................................... 25 表 7：触摸屏接口 ....................................................................................................................................... 27 表 8：摄像头接口 ....................................................................................................................................... 28 表 9：HDMI 接口 ........................................................................................................................................ 31 表 10：USB 接口........................................................................................................................................ 33 表 11：USB Type-C 和 DisplayPort 模式引脚对应表 ................................................................................. 35 表 12：音频接口 ......................................................................................................................................... 36 表 13：(U)SIM 接口.................................................................................................................................... 40 表 14：UART 接口 ..................................................................................................................................... 42 表 15：CAN 接口........................................................................................................................................ 42 表 16: 以太网接口 ...................................................................................................................................... 43 表 17：M.2 接口 ......................................................................................................................................... 44 表 18：SD 卡接口....................................................................................................................................... 45 表 19：闪光灯............................................................................................................................................. 46 表 20：传感器............................................................................................................................................. 47 表 21：马达 ................................................................................................................................................ 48 表 22：按键 ................................................................................................................................................ 49 表 23：开关 ................................................................................................................................................ 50 表 24：状态指示灯 ..................................................................................................................................... 51 表 25：测试点............................................................................................................................................. 52 表 26：参考文档 ......................................................................................................................................... 60 表 27：术语缩写 ......................................................................................................................................... 60 上海移远通信技术股份有限公司 7 / 61 SA800U-WF EVB 用户指导 图片索引 图 1：俯视图................................................................................................................................................11 图 2：底视图............................................................................................................................................... 12 图 3：俯视图应用接口 ................................................................................................................................ 12 图 4：底视图应用接口 ................................................................................................................................ 13 图 5：SA800U-WF EVB 配件装配 ............................................................................................................. 17 图 6：SA800U-WF EVB 配件..................................................................................................................... 18 图 7：SA800U-WF EVB 电源选择框图 ...................................................................................................... 21 图 8：SA800U-WF EVB 适配器接口.......................................................................................................... 22 图 9：适配器插头设计 ................................................................................................................................ 22 图 10：电池接口参考设计 .......................................................................................................................... 23 图 11：电池接口引脚分配........................................................................................................................... 23 图 12：B2B 与 FPC 连接器 ........................................................................................................................ 24 图 13：SA800U-WF 安装示意图（俯视图）.............................................................................................. 25 图 14：LCM 接口参考电路设计.................................................................................................................. 26 图 15：LCM 接口引脚分配 ......................................................................................................................... 26 图 16：TP 接口参考电路设计..................................................................................................................... 27 图 17：TP 接口的引脚分配 ........................................................................................................................ 27 图 18：摄像头 J0501 接口电路设计 ........................................................................................................... 28 图 19：摄像头 J0502 接口电路设计 ........................................................................................................... 29 图 20：TOF 摄像头接口参考设计............................................................................................................... 30 图 21：摄像头接口 ..................................................................................................................................... 30 图 22：HDMI 输入接口框图 ....................................................................................................................... 31 图 23：HDMI 输入接口............................................................................................................................... 32 图 24：HDMI 输出接口框图 ....................................................................................................................... 32 图 25：HDMI 输出接口............................................................................................................................... 33 图 26：Type-C 接口参考电路 ..................................................................................................................... 34 图 27：Type-C 接口实物图......................................................................................................................... 34 图 28：Type-A 接口框图 ............................................................................................................................ 35 图 29：Type-A 接口.................................................................................................................................... 36 图 30：扬声器接口参考电路....................................................................................................................... 37 图 31：扬声器............................................................................................................................................. 37 图 32：耳机接口简化电路 .......................................................................................................................... 38 图 33：耳机接口引脚分配 .......................................................................................................................... 38 图 34：听筒接口简化电路 .......................................................................................................................... 39 图 35：听筒 ................................................................................................................................................ 39 图 36：麦克风接口简化电路....................................................................................................................... 39 图 37：麦克风实物图.................................................................................................................................. 40 图 38：(U)SIM 卡接口（J0801）简化电路 ................................................................................................ 41 图 39：(U)SIM 卡卡座实物图 ..................................................................................................................... 41 图 40：UART 接口设计框图....................................................................................................................... 42 图 41：DB9 连接器实物图.......................................................................................................................... 42 上海移远通信技术股份有限公司 8 / 61 SA800U-WF EVB 用户指导 图 42：CAN 设计框图 ................................................................................................................................ 43 图 43：CAN 连接器 .................................................................................................................................... 43 图 44：以太网接口设计框图....................................................................................................................... 44 图 45：RJ45 连接器 ................................................................................................................................... 44 图 46：M.2 接口设计框图........................................................................................................................... 45 图 47：M.2 连接器...................................................................................................................................... 45 图 48：SD 卡接口简化电路 ........................................................................................................................ 46 图 49：SD 卡卡座实物图............................................................................................................................ 46 图 50：闪光灯设计简化示意图 ................................................................................................................... 47 图 51：闪光灯位置分布图 .......................................................................................................................... 47 图 52：传感器实物图.................................................................................................................................. 48 图 53：紧急下载接口简化电路 ................................................................................................................... 48 图 54：马达简化电路设计 .......................................................................................................................... 49 图 55：ERM 马达实物图 ............................................................................................................................ 49 图 56：按键图示 ......................................................................................................................................... 50 图 57：开关图示 ......................................................................................................................................... 50 图 58：状态指示灯 ..................................................................................................................................... 51 图 59：LCD 显示模块上电 ......................................................................................................................... 54 图 60：模块关机菜单.................................................................................................................................. 55 图 61：PC 设备管理器中的 USB 端口 ....................................................................................................... 56 图 62：'adb shell'命令 ............................................................................................................................... 56 图 63：PC 设备管理器中的 USB 串口序号 ................................................................................................ 57 图 64：QCOM 界面参数配置 ..................................................................................................................... 58 图 65：固件升级步骤.................................................................................................................................. 59 上海移远通信技术股份有限公司 9 / 61 SA800U-WF EVB 用户指导 1 引言 移远通信提供一整套 SA800U-WF EVB 评估套件，以方便适用模块的测试和使用。该文档详细介绍了 SA800U-WF EVB（评估板）的基本信息并提供其使用指导。适用模块如下所示。 ⚫ SA800U-WF ⚫ SG865W-WF 1.1. 特殊符号 表 1：特殊符号 符号 * 定义 若无特别说明，模块功能、特性、接口、引脚名称、AT 命令或参数后所标记的星号（*）表 示该功能、特性、接口、引脚、AT 命令或参数正在开发中，因此暂不支持；模块子型号后所 标记的星号（*）表示该子型号暂无样品。 上海移远通信技术股份有限公司 10 / 61 SA800U-WF EVB 用户指导 2 产品综述 移远通信为设计人员提供 SA800U-WF EVB，尺寸为 288 mm ×170 mm，用于开发基于适用模块的应 用程序和测试模块的基本功能。 2.1. 俯视图和底视图 图 1：俯视图 上海移远通信技术股份有限公司 11 / 61 SA800U-WF EVB 用户指导 图 2：底视图 2.2. 应用接口 J0301 D0301 S0302 S0301 J0302 RGB LED J1101 S1701 J0701 U1303 J0901 S0701 J1201 J0503 J0501 J0502 J1203 U1301 U1304 U1302 J0201 U0101 J0202 U0102 J1301 J1302 D0801 D0802 U0802 J0433 J0605 U0424 U0436 U0435 U0428 J0603 J0902 J0903 J0801 J0802 U1202 J1601 S0601 J0601 J1401 S1214 S0801 S1203 S1201 S1202 上海移远通信技术股份有限公司 图 3：俯视图应用接口 12 / 61 U0445(SPK) U0403(EAR) SA800U-WF EVB 用户指导 图 4：底视图应用接口 表 2：SA800U-WF EVB 应用接口 接口 供电 电源开关 PWRKEY VOL_UP VOL_DOWN M.2 接口 USB 接口 位号 J0301 J0302 S0301 S0302 S0801 S1202 S1203 S1201 U0802 J0701 描述 直流电源插孔 锂电池连接器 说明 ⚫ 直流电源：4.5~18 V ⚫ 典型供电电压：12 V/5 A 典型电压：3.8 V 直流电源与电池电源的切换开关 开关 电源开关 开关 5G 通信模块开关 开关 模块开关机按键 按键 音量加按键 按键 音量减按键 RM500Q-AE 的 M.2 连接座 Type-C 连接器 按键 SA800U-WF 的 标 准 PCI Express M.2 接口 ⚫ 支 持 USB Type-C 模 式 、 DisplayPort 模 式 和 USB OTG 上海移远通信技术股份有限公司 13 / 61 USB_BOOT 5G/HUB 开关 FCT 音频 (U)SIM SD 卡 CAN 调试 UART 以太网接口 M.2 状态指示灯 J0901 J0902 J0903 S1214 S1701 S0701 U0445 U0403 J0433 U0424 U0428 U0435 U0436 Type-A 连接器 紧急下载模式开关 5G/HUB 选择开关 工厂功能测试开关 扬声器 听筒 耳机插孔 硅麦克风 J0801 (U)SIM1 卡座 J0802 U1202 J1401 J1201 J1101 U0802 D0301 D0801 D0802 (U)SIM2 卡座 SD 卡座 CAN 连接器 调试 UART 连接器 RJ45 连接器 5G 模块接口 电源指示灯 RM500Q-AE 工作指示灯 RM500Q-AE电源指示灯 上海移远通信技术股份有限公司 SA800U-WF EVB 用户指导 ⚫ 用于AT命令传送、数据传 输、软件调试和固件升级 3 个 Type-A 接口，仅支持 Host 模式 开关 开关 开关 ⚫ 额定电阻：8 Ω ⚫ 额定功率：1.5 W ⚫ 额定电阻：32 Ω ⚫ 额定功率：30 mW ⚫ 支持(U)SIM 卡插入检测 ⚫ 支 持 (U)SIM1 和 (U)SIM2 卡：1.8 V 和 2.95 V ⚫ 用于调试 ⚫ 默认波特率：115200 bps 9个LED用于信号指示 14 / 61 TE-A HDMI 分辨率开关 摄像头 LCM TP 传感器 马达 风扇 纽扣电池 预留接口 D1201 D1202 D1203 D1301 D1302 D1303 U0101 U0102 J0201 J0202 J0601 J1601 S0601 J0501 J0502 J0503 J0603 J0605 U1301 U1302 U1303 U1304 J1202* U0311 J1301 红色LED 绿色LED 蓝色 LED 闪光灯 连接TE-A的连接器 HDMI信号输出连接器 HDMI信号输入连接器 支持1080P与4K切换 摄像头连接器 TOF摄像头连接器 液晶显示屏连接器 触摸屏连接器 光距感传感器 加速度计和陀螺仪传感器 地磁传感器 偏心振动马达 风扇连接器 用于RTC供电 MIC板连接器 SA800U-WF EVB 用户指导 B2B FPC 开关 上海移远通信技术股份有限公司 15 / 61 测试点 SA800U-WF EVB 用户指导 J1302 PWM/ADC/SPI接口 J1203 预留测试控制接口 TP0103、TP0104、TP0105、TP0201、TP0402、 29 个测试点 TP0404、TP0405、TP0412、TP0413、TP0415、 TP0422、TP0423、TP0425、TP0426、TP0601、 TP0602、TP0603、TP0604、TP0701、TP0702、 TP0803、TP0805、TP0806、TP1101、TP1402、 TP1403、TP1606、TP1607、TP1608 上海移远通信技术股份有限公司 16 / 61 SA800U-WF EVB 用户指导 3 配件及装配 3.1. 配件装配 USB 转UART 线 电源适配器 耳机 以太网线 USB Type-C 线 Type-C转 DP 线 SA800U-WF 模块 图 5：SA800U-WF EVB 配件装配 HDMI线 上海移远通信技术股份有限公司 17 / 61 SA800U-WF EVB 用户指导 3.2. 配件列表 SA800U-WF EVB 的所有配件如下所示。如有遗失，请联系供应商。 电源适配器 USB 转UART线 驱动光盘 Type-C 转 DP 线 HDMI 线 USB Type-C 线 千兆网线 FPC 和 RF 线 螺栓和螺母 耳机 Wi-Fi和蓝牙天线 表 3：配件列表 配件 适配器 线缆 图 6：SA800U-WF EVB 配件 描述 12 V/5 A 电源适配器 千兆网线 USB 转 UART 线 数量（件） 1 1 1 上海移远通信技术股份有限公司 18 / 61 天线 音频 光盘 FPC 排线 螺栓和螺母 USB Type-C 转接线 HDMI 线 Type-C 转 DP 线 RF 线 Wi-Fi/蓝牙天线 耳机 ⚫ USB 转 RS232 驱动 ⚫ USB 驱动 ⚫ 模块相关工具 用于 FPC 连接器 用于装配 EVB 的螺栓和螺母 SA800U-WF EVB 用户指导 1 1 1 2 2 1 1 2 12 上海移远通信技术股份有限公司 19 / 61 SA800U-WF EVB 用户指导 4 应用接口 本章描述 SA800U-WF EVB 各组应用接口的功能，如下所示： ⚫ 电源接口 ⚫ B2B 和 FPC 接口 ⚫ LCM 接口 ⚫ TP 接口 ⚫ 摄像头接口 ⚫ HDMI 接口 ⚫ USB 接口 ⚫ 音频接口 ⚫ (U)SIM 接口 ⚫ UART 接口 ⚫ CAN 接口 ⚫ 以太网口 ⚫ M.2 接口 ⚫ SD 卡接口 ⚫ 紧急下载接口 此外，章节还简述了闪光灯、传感器、马达、按键/开关、状态指示灯和测试点的相关信息，以更好地 帮助客户使用 SA800U-WF EVB。 上海移远通信技术股份有限公司 20 / 61 SA800U-WF EVB 用户指导 4.1. 电源供电 SA800U-WF EVB 通过外接 12 V 直流电源适配器供电。将电源适配器插入 J0301 电源插孔中，然后 经过 DC-DC 转换电路，将 12 V 电源转换成模块工作电压 4.2 V。SA800U-WF EVB 也可以通过电池连接 器 J0302 使用锂电池供电。 表 4：电源描述 位号 J0301 J0302 S0301 S0302 描述 直流电源插孔 电池接口 直流供电与电池供电的切换开关 VBAT 开关控制 下图为 SA800U-WF EVB 电源选择框图： J0301 直流电源 12 V 插孔 U0303 DC-DC 转换电路 4.2 V S0301 J0302 锂电池 电源选择 S0302 电源开关 图 7：SA800U-WF EVB 电源选择框图 EVB电源 上海移远通信技术股份有限公司 21 / 61 4.1.1. 适配器接口 SA800U-WF EVB 的适配器接口（J0301）如下图所示。 SA800U-WF EVB 用户指导 J0301 图 8：SA800U-WF EVB 适配器接口 SA800U-WF EVB 接通电源前，必须选择标配的 12 V 电源适配器供电，适配器的电源插头设计如下图 所示。 内接触 外接触 图 9：适配器插头设计 上海移远通信技术股份有限公司 22 / 61 4.1.2. 电池接口 电池接口（J0302）的参考电路设计如下图所示。 SA800U-WF EVB 用户指导 J0302 D1 VBAT_BATT 3 BATT_THERM 2 GND 1 D2 C1 100nF R2 NM-0R C2 VBAT_BATT BATT_THERM Notices: R1 SA800U-WF: R1=47 K SG865W-WF: R1=100 K NM-100nF 图 10：电池接口参考设计 电池接口引脚分配如下图所示： 3 J0302 2 1 图 11：电池接口引脚分配 上海移远通信技术股份有限公司 23 / 61 SA800U-WF EVB 用户指导 4.2. B2B 和 FPC 接口 SA800U-WF EVB 通过两个 B2B 连接器以及两个 FPC 连接器与模块进行连接。 表 5：B2B 和 FPC 连接器 位号 U0101 U0102 J0201 J0202 描述 B2B 连接器 FPC 连接器 下面两张图分别是 B2B 和 FPC 连接器，以及 SA800U-WF 模块安装示意图。 J0201 U0101 U0102 J0202 图 12：B2B 与 FPC 连接器 上海移远通信技术股份有限公司 24 / 61 SA800U-WF EVB 用户指导 图 13：SA800U-WF 安装示意图（俯视图） 关于 SA800U-WF EVB 上 B2B 和 FPC 连接器对应的模块引脚定义，请参见文档 [1]。 4.3. LCM 接口 SA800U-WF EVB 显示屏接口基于 MIPI_DSI 标准，支持 4 组高速差分数据传输。下图为 LCM 接口的 参考电路设计。 表 6：LCM 接口 位号 J0603 描述 LCD 连接器 上海移远通信技术股份有限公司 25 / 61 SA800U-WF EVB 用户指导 U0602 LCD0_TE0 LCD0_ RST MIPI_DSI0_LN3_P_A MIPI_DSI0_LN3_N_A MIPI_DSI0_LN2_P_A MIPI_DSI0_LN2_N_A MIPI_DSI0_LN1_P_A MIPI_DSI0_LN1_N_A MIPI_DSI0_LN0_P_A MIPI_DSI0_LN0_N_A MIPI_DSI0_CLK_P_A MIPI_DSI0_CLK_N_A MIPI SWITCH VREG_WLED WLED _SINK1 WLED _SINK2 D1 D2 LCM_VDD _2V 8 LDO14_1V88 C1 C2 C3 4.7uF 100nF 1uF FL1 1 3 6 5 2 4 1 3 FL2 6 5 2 4 1 3 FL3 6 5 2 4 FL4 1 3 6 5 2 4 FL5 1 3 6 5 2 4 EMI filter J0603 1 LEDA 2 NC 3 LEDK 4 NC 5 LPTE 6 RESET 7 LCD_ID 8 NC (SDA-TP) 9 NC (SCL-TP) 10 NC (RST-TP) 11 NC (EINT-TP) 12 GND 13 VIO18 14 VIO 28 15 NC (VTP-TP) 16 GND 17 MIPI_TDP3 18 MIPI_ TDN3 19 GND 20 MIPI_ TDP2 21 MIPI_ TDN2 22 GND 23 MIPI_ TDP1 24 MIPI_ TDN1 25 GND 26 MIPI_TDP0 27 MIPI_ TDN0 28 GND 29 MIPI_TCP 30 MIPI_ TCN 31 GND 32 GND 33 GND 34 GND LCM 图 14：LCM 接口参考电路设计 LCM 接口的引脚分配如下图所示： 图 15：LCM 接口引脚分配 上海移远通信技术股份有限公司 26 / 61 SA800U-WF EVB 用户指导 4.4. TP 接口 SA800U-WF EVB 触摸屏接口用于实现液晶显示屏触摸功能。下图为触摸屏接口的参考电路设计。 表 7：触摸屏接口 位号 J0605 描述 触摸屏连接器 J0605 SDA 1 2 SCL 3 RESET 4 INT GND 5 6 VDD 7 GND 8 GND LDO28_3V LDO14_1V88 R1 2.2 K R2 2.2 K C1 C2 4.7 uF 100 nF D1 D2 D3 D4 U0102 1 TP_I2C_SDA 2 TP_I2C_ SCL 3 TP_ RST 4 TP_ INT 模块 图 16：TP 接口参考电路设计 触摸屏接口的引脚分配如下图所示： J0605 53 1 642 7 8 图 17：TP 接口的引脚分配 上海移远通信技术股份有限公司 27 / 61 SA800U-WF EVB 用户指导 4.5. 摄像头接口 SA800U-WF EVB 基于 MIPI_CSI 标准，支持 2 个常规摄像头和 1 个 TOF 摄像头。摄像头接口（J0501） 支持 1 路 4 通道 MIPI_CSI1，摄像头接口（J0502）支持 1 路 4 通道 MIPI_CSI0，这 2 个摄像头的像素均 为 16 MP。TOF 摄像头接口（J0503）支持 1 路 2 通道 MIPI_CSI3，仅支持 RAW 格式且不支持预览。摄 像和照相质量由摄像头传感器、镜头规格参数等多种因素决定。 表 8：摄像头接口 位号 J0501 J0502 J0503 描述 摄像头连接器 TOF 摄像头连接器 J0501 GND 1 MCP 2 MCN 3 GND 4 MDP2 5 MDN2 6 GND 7 MDP0 8 MDN0 9 GND 10 MDP3 11 MDN3 12 GND 13 MDP1 14 MDN1 15 GND 16 ID(DOVDD) 17 GND 18 PWDN 19 RESET 20 SDA 21 SCL 22 DVDD_1V2 23 GND 24 MCLK 25 GND 26 DOVDD_1V8 27 GND 28 AVDD_2V95 29 AFVDD_2V8 30 GND 31 GND 32 GND 33 GND 34 CAMERA1 R1 0 R EMI U0101 CSI1_CLK_P CSI1_CLK_N CSI1_LN2_P EMI CSI1_LN2_N CSI1_LN0_P EMI CSI1_LN0_N CSI1_LN3_P EMI CSI1_LN3_N EMI R2 10 K R3 0 R R4 0 R LVS1A_1V8 CAM1_PWDN CAM1_PWDN CAM1_DVDD_1V1 R5 CAM1_MCLK1 2.2 K R6 2.2 K CSI1_LN1_P CSI1_LN1_N CCI_I2C_SDA1 CCI_I2C_SCL1 LVS1A_1V8 CAM1_AVDD_2V85 CAM1_AFDD_2V85 模块 图 18：摄像头 J0501 接口电路设计 上海移远通信技术股份有限公司 28 / 61 SA800U-WF EVB 用户指导 J0502 GND 1 MCP 2 MCN 3 GND 4 MDP2 5 MDN2 6 GND 7 MDP0 8 MDN0 9 GND 10 MDP3 11 MDN3 12 GND 13 MDP1 14 MDN1 15 GND 16 ID(DOVDD) 17 GND 18 PWDN 19 RESET 20 SDA 21 SCL 22 DVDD_1V2 23 GND 24 MCLK 25 GND 26 DOVDD_1V8 27 GND 28 AVDD_2V95 29 AFVDD_2V8 30 GND 31 GND 32 GND 33 GND 34 CAMERA0 R1 0 R EMI U0101 CSI0_CLK_P CSI0_CLK_N CSI0_LN2_P EMI CSI0_LN2_N CSI0_LN0_P EMI CSI0_LN0_N CSI0_LN3_P EMI CSI0_LN3_N EMI R2 10 K R3 0 R R4 0 R LVS1A_1V8 CAM0_PWDN CAM0_PWDN CAM0_DVDD_1V1 R5 CAM0_MCLK0 2.2 K R6 2.2 K CSI0_LN1_P CSI0_LN1_N CCI_I2C_SDA0 CCI_I2C_SCL0 LVS1A_1V8 CAM0_AVDD_2V85 CAM0_AFDD_2V85 模块 图 19：摄像头 J0502 接口电路设计 上海移远通信技术股份有限公司 29 / 61 CAM3_VILLU CCI_I2C_SDA1 CCI_I2C_SCL1 CAM3_RSTN CAM3_TRIGGER_OUT CAM3_TRIGGER_IN LVS1A_1V8 C1 1 uF J0503 33 34 1 30 2 29 3 28 4 27 5 26 6 25 7 24 8 23 9 22 10 21 11 20 12 19 13 18 14 17 15 16 32 31 SA800U-WF EVB 用户指导 CAM3_VCC_3V3 EMI EMI EMI CAM_MCLK3 MIPI_CSI3_LANE0_P MIPI_CSI3_LANE0_N MIPI_CSI3_CLK_P MIPI_CSI3_CLK_N MIPI_CSI3_LANE1_P MIPI_CSI3_LANE1_N 图 20：TOF 摄像头接口参考设计 J0503 J0501 J0502 图 21：摄像头接口 上海移远通信技术股份有限公司 30 / 61 SA800U-WF EVB 用户指导 4.6. HDMI 接口 SA800U-WF EVB 支持 HDMI 输入和 HDMI 输出功能。 表 9：HDMI 接口 位号 J0601 J1601 描述 HDMI OUT 连接器 HDMI IN 连接器 下图为 HDMI 输入接口（J1601）的电路设计框图。 J1601 HDMI1_TX2_P 1 GND 2 HDMI1_TX2_N 3 HDMI1_TX1_P 4 GND 5 HDMI1_TX1_N 6 HDMI1_TX0_P 7 GND HDMI1_TX0_N 8 9 10 HDMI1_CLK_P GND 11 HDMI1_CLK_N 12 13 NC 14 NC 15 HDMI1_SCL 16 HDMI1_SDA 17 GND 18 HDMI1_VDD 19 HDMI1_IN_DET VDD_5V HDMI IN 连接器 U1617 HDMI 与 MIPI CSI 转 换器 MIPI CSI2 模块 图 22：HDMI 输入接口框图 上海移远通信技术股份有限公司 31 / 61 SA800U-WF EVB 用户指导 1 19 J1601 图 23：HDMI 输入接口 下图为 HDMI 输出接口（J0601）的电路设计框图。 J0601 HDMI_TX2_P 1 GND 2 HDMI_TX2_N 3 HDMI_TX1_P 4 GND 5 HDMI_TX1_N 6 HDMI_TX0_P 7 GND HDMI_TX0_N 8 9 10 HDMI_CLK_P GND 11 HDMI_CLK_N 12 13 NC NC 14 15 HDMI_SCL 16 HDMI_SDA 17 GND 18 HDMI_VDD HDMI_5V 19 HDMI_IN_DET HDMI OUT 连接器 U0616 MIPI DSI 与 HDMI 转 换器 MIPI DSI1 图 24：HDMI 输出接口框图 模块 上海移远通信技术股份有限公司 32 / 61 SA800U-WF EVB 用户指导 1 19 J0601 图 25：HDMI 输出接口 4.7. USB 接口 SA800U-WF EVB 提供 1 个 USB Type-C 接口和 3 个 USB Type-A 接口，这两种接口均符合 USB 3.1/2.0 规范。在数据传输速率上，支持超高速（5 Gbps）模式、高速（480 Mbps）模式、全速（12 Mbps）模式。 USB Type-C 接口支持 DisplayPort 模式和 OTG 功能，可用于 AT 指令传输、数据传输、软件调试和软件 升级，USB Type-A 接口只支持 Host 模式。 表 10：USB 接口 位号 J0701 J0901 J0902 J0903 描述 USB Type-C 连接器 USB Type-A 连接器 4.7.1. USB Type-C 接口 USB Type-C 接口（J0701）具有一组兼容 USB 2.0 的 HS 接口，即 USB_DP、USB_DM，还有两组 支持 USB 3.1 的 SS 接口，即 USB_SS1 和 USB_SS2。 上海移远通信技术股份有限公司 33 / 61 SA800U-WF EVB 用户指导 当 Type-C 正面朝上插入时，USB_CC1 检测到外部设备，数据通过 USB_SS1 传输；反面朝上插入 时，USB_CC2 检测到外部设备，数据通过 USB_SS2 传输。下图分别为 Type-C 接口的电路设计和实物 图。 USB1_SS_TX0_P USB1_SS_TX0_M USB_VBUS USB_CC1 USB_DP_TYPEC USB_DM_TYPEC USB_SBU1 USB1_SS_RX1_M C4 100 nF C5 100 nF USB1_SS_RX1_P C1 100 nF C2 100 nF C3 1 uF J0701 A1 GND A2 TX1+ A3 TX1- A4 VBUS1 A5 CC1 A6 D1+ A7 D1- A8 SBU1 A9 VBUS2 A10 RX2A11 RX2+ A12 GND B1 GND B2 TX2+ B3 TX2- B4 VBUS3 B5 CC2 B6 D2+ B7 D2- B8 SBU2 B9 VBUS4 RX1- B10 B11 RX1+ GND B12 C5 100 nF C6 100 nF USB1_SS_TX1_P USB1_SS_TX1_M USB_VBUS USB_CC2 USB_DP_TYPEC USB_DM_TYPEC USB_SBU2 C7 100 nF USB1_SS_RX0_M C8 100 nF USB1_SS_RX0_P D1 D2 D3 D4 D5 D6 D7 D8 D9 D10 D11 D12 D13 D14 D15 D16 D17 D18 VDC_3V3 SBU_SW_SEL USB_SBU1 USB_SBU2 U0703 C9 1 μF VCC S D+ DGND VREG_L24A_3V075 R2 100 K VREG_S4A_1V8 R1 2.2 K OE HSD2+ HSD2HSD1+ HSD1- C10 C11 0.1 μF 0.1 μF R3 100K SBU_SW_OE EDP_AUX_N EDP_AUX_P 图 26：Type-C 接口参考电路 A1 A12 J0701 图 27：Type-C 接口实物图 上海移远通信技术股份有限公司 34 / 61 SA800U-WF EVB 用户指导 USB Type-C 接口支持 DisplayPort 功能，最大分辨率达到 4K @ 60fps。默认软件版本不支持 DP 功 能。如需 DP 功能，请与我司联系更新软件。USB Type-C 和 DisplayPort 模式下的引脚定义如下： 表 11：USB Type-C 和 DisplayPort 模式引脚对应表 Pin NO. A2, A3 B11, B10 B2, B3 A11, A10 A5, B8 A7, A6, B6, B7 A8, B5 A4, A9, B4, B9 A1, A12, B1, B12 USB Type-C Mode USB1_SS0_TX_P/M USB1_SS0_RX_P/M USB1_SS1_TX_P/M USB1_SS1_RX_P/M SBU1/2 USB1_DP/DM USB_CC1/CC2 USB_VBUS GND DisplayPort Mode DP_LANE2_P/M DP_LANE3_P/M DP_LANE1_P/M DP_LANE0_P/M DP_AUX_P/N USB1_DP/DM HOTPLUG_DET/VCONN USB_VBUS GND 4.7.2. USB Type-A 接口 SA800U-WF EVB 提供 3 个 Type-A 接口，是模块的 USB2 接口通过 HUB 芯片（U0901）扩展设计的。 下图是 Type-A 接口设计框图。 J0901 USB TYPE-A J0902 USB TYPE-A J0903 USB TYPE-A U0901 HUB IC USB2 模块 图 28：Type-A 接口框图 上海移远通信技术股份有限公司 35 / 61 SA800U-WF EVB 用户指导 J0901 J0902 J0903 图 29：Type-A 接口 4.8. 音频接口 SA800U-WF EVB 支持模拟音频功能，其中模拟音频接口支持 5 路输入信号和 3 路输出信号，分别是 1 路耳机输入和 4 路麦克风输入，以及耳机、听筒、扬声器等 3 种模拟音频输出。 表 12：音频接口 位号 U0445 U0403 J0433 U0424 U0428 U0435 U0436 描述 扬声器 听筒 耳机接口 硅麦克风 上海移远通信技术股份有限公司 36 / 61 SA800U-WF EVB 用户指导 4.8.1. 扬声器接口 SA800U-WF EVB 提供一个扬声器接口（U0445），下图是扬声器接口电路设计。 U0427 SPK_P SPK_N C1 33 pF C2 100 pF C3 100 pF U0445 图 30：扬声器接口参考电路 U0445 图 31：扬声器 上海移远通信技术股份有限公司 37 / 61 SA800U-WF EVB 用户指导 4.8.2. 耳机接口 SA800U-WF EVB 提供 1 个耳机接口，下图是耳机接口（J0433）的参考电路设计。 U0401A MIC_BIAS2 AMIC2_P AMIC2_M CDC_HPH_R CDC_HPH_L CDC_HPH_REF MBHC_HSDET_L WCD9341 R1 2.2K R2 20K C2 220 pF C3 C4 C5 220 pF 220 pF 220 pF D1 D2 D3 D4 ESD 6 1 3 5 2 4 J0433 D5 图 32：耳机接口简化电路 耳机接口的引脚分配如下图所示： 2 1 3 J0433 6 5 4 图 33：耳机接口引脚分配 上海移远通信技术股份有限公司 38 / 61 SA800U-WF EVB 用户指导 4.8.3. 听筒接口 SA800U-WF EVB 提供一个听筒接口（U0403）。下面是听筒接口的电路设计。 U0401A EAR_P EAR_N WCD9341 C1 33 pF C2 100 pF C3 100 pF U0403 图 34：听筒接口简化电路 U0403 图 35：听筒 4.8.4. 麦克风接口 SA800U-WF EVB 提供 4 个模拟麦克风，分别是 U0424、U0428、U0435 和 U0436。下图是麦克风接 口的电路设计。 U0401A MIC_BIAS MIC_N MIC _P WCD9341 F1 R1 0R C1 33 pF R2 0R C2 33 pF C4 100 nF 1 2 VDD GND 3 GND OUT 4 MEMS D1 图 36：麦克风接口简化电路 上海移远通信技术股份有限公司 39 / 61 SA800U-WF EVB 用户指导 U0424 U0428 U0436 U0435 图 37：麦克风实物图 4.9. (U)SIM 接口 SA800U-WF EVB 提供两个 6 针推入式(U)SIM 卡连接器，分别是(U)SIM1 卡连接器（J0801）和(U)SIM2 卡连接器（J0802）。 表 13：(U)SIM 接口 位号 J0801 J0802 描述 (U)SIM1 卡连接座 (U)SIM2 卡连接座 上海移远通信技术股份有限公司 40 / 61 USIM_ VDD USIM_ RST USIM_ CLK USIM_ DATA USIM_ DET M.2 模块 SA800U-WF EVB 用户指导 MODULE_VDD_1V8 R1 10K J0801 R2 22 R R3 22 R R4 22 R C2 22 pF C3 C4 22 pF 22 pF D1 ESD C1 100 nF C1 VCC C2 RST GND1 C3 CLK GND2 C7 IO GND3 C6 C4 C8 VPP GND4 RESERVED1 RESERVED2 CD CD C5 GND5 (U)SIM 卡卡座 图 38：(U)SIM 卡接口（J0801）简化电路 下图是(U)SIM 卡连接器（J0801 和 J0802）的实物图： J0801 J0802 C8 C7 C6 C5 CD C4 C3 C2 C1 C8 C7 C6 C5 CD C4 C3 C2 C1 图 39：(U)SIM 卡卡座实物图 上海移远通信技术股份有限公司 41 / 61 SA800U-WF EVB 用户指导 4.10. UART 接口 SA800U-WF EVB 提供一个调试 UART 接口，支持 RS-232 接口标准，可用于数据传输、AT 命令发送、 软件调试、固件升级。关于其设计原理如下图所示： 表 14：UART 接口 位号 J1201 描述 调试 UART 连接器 J1201 DB9 连接器 U1201 RS-232 收发器 U1210 电压转换器 UART 模块 图 40：UART 接口设计框图 5 9 2 6 图 41：DB9 连接器实物图 4.11. CAN 接口 SA800U-WF EVB 提供了一个 SPI 转换的 CAN 接口。 表 15：CAN 接口 位号 J1401 描述 CAN 连接器 上海移远通信技术股份有限公司 42 / 61 CAN 接口（J1401）设计框图如下图所示： SA800U-WF EVB 用户指导 J1401 1 GND 2 CAN_L 3 CAN_H 4 VDD CAN 连接器 U1407 CAN 收发器 CAN_5V U1401 SPI 接口转 CAN接口芯片 U1405 电压转换器 模块 图 42：CAN 设计框图 J1401 图 43：CAN 连接器 4.12. 以太网接口 SA800U-WF EVB 提供的 PCIe1 是 Gen 3 1 通道接口，每通道速率可达到 8 Gbps，支持以太网功能。 表 16: 以太网接口 位号 J1101 描述 RJ45 连接器，使用 LAN 线缆将其与 PC 端连接 上海移远通信技术股份有限公司 43 / 61 SA800U-WF EVB 用户指导 以太网电路设计框图如下所示： J1101 U1102 LANE0_MDI RJ45 连接器 变压器 U1101 LAN0_MDI 以太网芯片 PCle1 模块 图 44：以太网接口设计框图 J1101 图 45：RJ45 连接器 4.13. M.2 接口 SA800U-WF EVB 提供 1 个 M.2 接口，支持 5G 通信功能。 表 17：M.2 接口 位号 U0802 描述 M.2 连接器 上海移远通信技术股份有限公司 44 / 61 5G 通信模块 U0802 SA800U-WF EVB 用户指导 (U)SIM1 (U)SIM2 J0801 J0802 M.2 接口 PCIE0 PCM 模块 图 46：M.2 接口设计框图 U0802 图 47：M.2 连接器 4.14. SD 卡接口 SA800U-WF EVB支持SD卡，支持热插拔检测。 表 18：SD 卡接口 位号 U1202 描述 SD 卡连接器 上海移远通信技术股份有限公司 45 / 61 SA800U-WF EVB 用户指导 U1202 P1-DAT2 1 P2-CD/DAT3 2 P3-CMD 3 P4-VDD 4 P5-CLK 5 P6-VSS 6 P7-DAT0 7 P8-DAT1 8 DETECTIVE 9 GND 10 GND 11 GND 12 GND 13 SD 卡卡座 C1 2.2 uF C2 10 pF LDO21_2V95 LDO13_2V95 D1 D2 D3 D4 D5 R1 NM-51 K R2 NM-51 K R3 NM-51 K R4 NM-51 K R 5 NM-51 K VREG_S4A_1V8 R6 10 K R7 R8 R9 R10 R11 R12 R13 33 R 33 R 33 R 33 R 33 R 33 R 1 K D6 D7 D8 SD_DATA2 SD_DATA3 SD_CMD SD_CLK SD_DATA0 SD_DATA1 SD_DET 模块 图 48：SD 卡接口简化电路 10 9 11 8 7654 3 21 U1202 12 13 图 49：SD 卡卡座实物图 4.15. 闪光灯 SA800U-WF EVB 提供三个闪光灯，支持手电筒和闪光灯模式。下图是闪光灯的参考电路设计及其在 SA800U-WF EVB 上的位置分布（黄色部分）。 表 19：闪光灯 位号 D1301 D1302 D1303 描述 闪光灯 上海移远通信技术股份有限公司 46 / 61 SA800U-WF EVB 用户指导 FLASH_LED1 FLASH_LED2 FLASH_LED3 模块 D1301 D1302 D1303 图 50：闪光灯设计简化示意图 D1303 D1301 D1302 图 51：闪光灯位置分布图 4.16. 传感器 SA800U-WF EVB 提供三个传感器，如下图所示： 表 20：传感器 位号 U1301 U1302 U1303 描述 光距感传感器 加速度计和陀螺仪传感器 地磁传感器 上海移远通信技术股份有限公司 47 / 61 U1301 U1302 SA800U-WF EVB 用户指导 U1303 图 52：传感器实物图 4.17. 紧急下载接口 SA800U-WF EVB 提供一个紧急下载开关 USB_BOOT，强制模块进入下载模式，用于产品因故障无法 正常启动时的最终处理方式。使用该功能时，需要在模块上电之前，将 USB_BOOT 引脚拉至 1.8 V，其电 路设计原理如下所示： S1 USB_BOOT 模块 VREG_S4A_1V8 R1 10K 图 53：紧急下载接口简化电路 4.18. 马达 SA800U-WF EVB 提供一个 ERM 型振动器，即偏心振动马达，供客户测试模块的马达驱动接口。 表 21：马达 位号 U1304 描述 ERM 马达 上海移远通信技术股份有限公司 48 / 61 下图为马达电路设计和实物图： U1304 VIB+ VIB- 马达 C1 33 pF C2 33 pF SA800U-WF EVB 用户指导 J0201 HAP_P HAP_M 模块 图 54：马达简化电路设计 U1304 图 55：ERM 马达实物图 4.19. 按键和开关 SA800U-WF EVB 提供 3 个按键和 7 个开关。 表 22：按键 位号 S1202 S1203 S1201 描述 模块开关机按键 音量加按键 音量减按键 上海移远通信技术股份有限公司 49 / 61 表 23：开关 位号 S0301 S0302 S0801 S1214 S1701 S0701 S0601 SA800U-WF EVB 用户指导 描述 直流供电与电池供电的切换开关 VBAT 开关控制 5G 通信模块开关 紧急下载模式开关 5G/HUB 选择开关 工厂功能测试开关 分辨率选择开关，支持 1080P 与 4K 切换 S1203 S1201 S1202 图 56：按键图示 S0302 S0301 S0801 S0601 S1214 S1701 图 57：开关图示 S0701 上海移远通信技术股份有限公司 50 / 61 4.20. 状态指示灯 SA800U-WF EVB 配有 6 个状态指示灯： 表 24：状态指示灯 位号 D0301 D0801 D0802 D1201 D1202 D1203 描述 电源指示灯 ⚫ 灯亮：电源已接通 ⚫ 灯灭：电源未接通 RM500Q-AE 工作指示灯 RM500Q-AE 电源指示灯 红色 LED 绿色 LED 蓝色 LED SA800U-WF EVB 用户指导 D1201 D1202 D1203 D0801 D0802 图 58：状态指示灯 D0301 上海移远通信技术股份有限公司 51 / 61 SA800U-WF EVB 用户指导 4.21. 测试点 SA800U-WF EVB 提供测试点，方便客户测试一些信号的波形，如下表所示： 表 25：测试点 序号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 位号 TP0103 TP0104 TP0105 TP0201 TP0402 TP0404 TP0405 TP0412 TP0413 TP0415 TP0422 TP0423 TP0425 TP0426 TP0601 TP0602 TP0603 TP0604 TP0701 TP0702 描述 GND CBL HOME_KEY BATT_ID CODEC_RST_N CODEC_SLIMBUS_DATA0 CODEC_SLIMBUS_CLK CODEC_INT1_N CODEC_INT2_N LN_BB_CLK2_WCD WSA8815_EN WSA8815_INTR SWR_CLK SWR_DATA GPIO_4 HDMIOUT_SCL HDMIOUT_SDA GND USB_DP USB_DM 上海移远通信技术股份有限公司 52 / 61 21 TP0803 22 TP0805 23 TP0806 24 TP1101 25 TP1402 26 TP1403 27 TP1606 28 TP1607 29 TP1608 SA800U-WF EVB 用户指导 DPR COEX_UART_RX COEX_UART_TX LED1/GPO CLKO/SOF INT1/GPIO1 I2S_MCLK_GPIO9 CSCL_GPIO10 CSDA_GPIO11 上海移远通信技术股份有限公司 53 / 61 SA800U-WF EVB 用户指导 5 操作说明 本章介绍了使用 SA800U-WF EVB 对 SA800U-WF 进行测试和评估的基本操作说明。 5.1. 模块开机 模块上电的操作步骤： 1. 通过连接器 U0101、U0102、J0201、J0202 将模块 SA800U-WF 与 SA800U-WF EVB 连接。 2. 如果选择电池供电方式，请先在 J0302 上安装锂聚合物电池，然后通过开关 S0301 切换到电池供 电状态。当选择 12 V 直流电源供电时，通过开关 S0301 切换到直流供电状态。 3. 通过开关 S0302 选择'ON'状态，给 EVB 供电，同时电源指示灯 D0301 会被点亮。 4. 长按 PWRKEY 按键 S1202 至少 2 秒使模块开机。当所使用的液晶屏显示如下界面时，表示启动 已完成。 图 59：LCD 显示模块上电 上海移远通信技术股份有限公司 54 / 61 SA800U-WF EVB 用户指导 备注 模块上电后，可以通过 USB Type-C 转接线将 EVB 的 USB Type-C 接口与 PC 端连接，来触发模块开机。 5.2. 模块关机 有两种方法可使模块关机， 第一种方法步骤如下： 1. 开机状态下，按下 PWRKEY 按键（S1202）键至少 1 秒，液晶屏会出现一个选择菜单，如下图所 示： 图 60：模块关机菜单 2. 选择'关机'选项。 3. 模块进入关机状态。 第二种方法是按下 PWRKEY 至少 8 秒，直到模块完全关闭。 上海移远通信技术股份有限公司 55 / 61 SA800U-WF EVB 用户指导 5.3. USB 接口通信 1. 请按照 5.1 章 步骤将模块上电。 2. 使用 USB Type-C 转接线将 EVB 的 USB Type-C 接口（J0701）与 PC 端连接，然后在 PC 上安 装 USB 驱动和 ADB 驱动并运行。USB 端口号可以通过 PC 设备管理器进行查看，如下图所示： 图 61：PC 设备管理器中的 USB 端口 3. 打开 CMD 命令窗口。 Windows7 系统：点击'开始'→'所有程序'→'附件'→'命令提示符'。 Windows10 系统：方法 1：'开始'→'运行'→输入'cmd'后按回车键；方法 2：点击'开 始'菜单，在搜索框中输入'cmd'，点击'cmd.exe'。 4. 执行命令'adb shell'，使模块进入 adb 模式。然后客户可以使用 USB ADB 接口进行测试。 图 62：'adb shell'命令 上海移远通信技术股份有限公司 56 / 61 SA800U-WF EVB 用户指导 备注 1. 如研发人员希望使用 HyperTerminal 进行测试，则可以使用高通 HS-USB 调制解调器 901F。 2. 请注意，不同的模块之间的 USB 端口编号可能不同。 5.4. UART 接口通信 1. 在 PC 上运行驱动盘，安装 USB-TO-RS232 驱动。 2. 通过 USB 转 RS232 数据线将 UART 接口与 PC 连接，然后按照 5.1 章中的步骤给模块上电。之 后可以通过 PC 设备管理器查看到 USB 串口序号，如下图所示： 图 63：PC 设备管理器中的 USB 串口序号 3. 安装并使用移远通信提供的 QCOM 工具实现模块与 PC 的通信。QCOM 配置如下图：选择正确的 'COM Port'（USB 串口），设置正确的'Baudrate'（例如 115200 bps）。有关 QCOM 工 具使用和配置的详细信息，请参见文档 [2]。 上海移远通信技术股份有限公司 57 / 61 SA800U-WF EVB 用户指导 图 64：QCOM 界面参数配置 5.5. 固件升级 移远通信智能模块默认通过 USB 接口升级固件。请按照以下程序升级固件。 1. 在 PC 上安装并打开固件升级工具 QFIL，然后按照 5.1 章 的步骤给模块上电。 2. 点击'Select port'，选择 USB 端口'Qualcomm HS-USB Android DIAG 901F (COM194)'。 3. 在'Select Build Type'一栏选择'Flat Build'。 4. 点击'Browse'选择需要升级的固件。 5. 点击'Load XML'，选择需要升级的 XML。 6. 点击'Download'进行固件升级。 7. 存储类型选择'UFS'。 上海移远通信技术股份有限公司 58 / 61 SA800U-WF EVB 用户指导 1 2 3 4 5 6 7 图 65：固件升级步骤 上海移远通信技术股份有限公司 59 / 61 SA800U-WF EVB 用户指导 6 参考文档及术语缩写 表 26：参考文档 文档名称 [1] Quectel_SA800U-WF_硬件设计手册 [2] Quectel_QCOM_User_Guide 表 27：术语缩写 术语 英文全称 ADC Analog-to-Digital Converter B2B Board to Board CAN Controller Area Network DP DisplayPort EVB Evaluation Board FCT Facility Control Terminal FPC Flexible Printed Circuit HD High Definition HDMI High Definition Multimedia Interface LCD Liquid Crystal Display LCM LCD Module LED Light Emitting Diode M.2 Next Generation Form Factor MEMS Micro-Electro-Mechanical System 上海移远通信技术股份有限公司 中文全称 模拟数字转换器 板到板 控制器局域网络 显示接口 评估板 功能测试 柔性印制电路 高分辨率 高清多媒体接口 液晶显示器 液晶显示模块 发光二极管 M.2 接口 微机电系统 60 / 61 MIC MIPI OTG PC PWM RF RTC SD SPI TOF TP UART UFS USB (U)SIM SA800U-WF EVB 用户指导 Microphone 麦克风 Mobile Industry Processor Interface 移动工业处理器接口 On-The-Go 便携式 Personal Computer 个人电脑 Pulse Width Modulation 脉冲宽度调制 Radio Frequency 射频 Real-time clock 实时时钟 Secure Digital Memory Card 安全数码卡 Serial Peripheral Interface 串行外设接口 Time of Flight 飞行时间法 Touch Panel 触摸屏 Universal Asynchronous Receiver & Transmitter 通用异步收发器 Universal Flash Storage 通用闪存 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module （通用）用户标识模块 上海移远通信技术股份有限公司 61 / 61

RMU500-EKNM EVB Kit User Guide 5G Module Series Version: 1.0 Date: 2021-10-13 Status: Released 5G Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. RMU500-EKNM_EVB_Kit_User_Guide 1 / 30 5G Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. RMU500-EKNM_EVB_Kit_User_Guide 2 / 30 5G Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fueling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. RMU500-EKNM_EVB_Kit_User_Guide 3 / 30 5G Module Series About the Document Revision History Version 1.0 Date 2021-09-27 2021-10-13 Author Albert XU Albert XU Description Creation of the document First official released RMU500-EKNM_EVB_Kit_User_Guide 4 / 30 5G Module Series Contents Safety Information....................................................................................................................................... 3 About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 6 Figure Index ................................................................................................................................................. 7 1 Introduction .......................................................................................................................................... 8 1.1. Applicable Modules....................................................................................................................... 8 2 General Overview................................................................................................................................. 9 2.1. Key Features................................................................................................................................. 9 2.2. Component Placement of the EVB ............................................................................................. 10 2.3. Top and bottom View of the EVB ............................................................................................... 11 2.4. EVB Kit Accessories ................................................................................................................... 12 3 Interface Application ......................................................................................................................... 13 3.1. Power Supply (J101/J301).......................................................................................................... 13 3.2. M.2 Interface (J201).................................................................................................................... 14 3.3. USB Interface (J301) .................................................................................................................. 15 3.4. (U)SIM Interface (J401) .............................................................................................................. 16 3.5. Status Indicator (D104/D107) ..................................................................................................... 17 3.6. RF Cables and Antennas............................................................................................................ 18 3.6.1. Antenna Design.............................................................................................................. 18 3.6.2. Antenna Efficiency ......................................................................................................... 19 3.6.3. Antenna Specification .................................................................................................... 20 4 EVB Operation Procedures............................................................................................................... 22 4.1. Component Assembling Steps ................................................................................................... 22 4.2. Turn On the Module .................................................................................................................... 26 4.3. Communication Via USB Interface ............................................................................................. 26 4.4. Firmware Upgrade ...................................................................................................................... 27 4.5. Turn Off the Module .................................................................................................................... 28 5 Appendix References ........................................................................................................................ 29 RMU500-EKNM_EVB_Kit_User_Guide 5 / 30 5G Module Series Table Index Table 1: Applicable Modules ........................................................................................................................ 8 Table 2: Key Features .................................................................................................................................. 9 Table 3: Interfaces of the EVB ................................................................................................................... 10 Table 4: List of Accessories ....................................................................................................................... 12 Table 5: Pin Definition of J401 ................................................................................................................... 17 Table 6: Description of Status Indicator LEDs ........................................................................................... 18 Table 7: Antenna Specification .................................................................................................................. 20 Table 8: Related Documents...................................................................................................................... 29 Table 9: Terms and Abbreviations ............................................................................................................. 29 RMU500-EKNM_EVB_Kit_User_Guide 6 / 30 5G Module Series Figure Index Figure 1: Component Placement of the EVB (Top View) .......................................................................... 10 Figure 2: EVB Top View ............................................................................................................................. 11 Figure 3: EVB Bottom View........................................................................................................................ 11 Figure 4: EVB Power Supply Interfaces..................................................................................................... 13 Figure 5: M.2 Connector of the EVB .......................................................................................................... 14 Figure 6: USB Connector ........................................................................................................................... 15 Figure 7: Connection Between PC and EVB ............................................................................................. 15 Figure 8: Simplified Connection Schematic for (U)SIM Card Connector J401.......................................... 16 Figure 9: Pin Assignment of (U)SIM Card Connector J401....................................................................... 16 Figure 10: Status Indicators ....................................................................................................................... 17 Figure 11: Reference Design for Antennas ............................................................................................... 18 Figure 12: Antenna Efficiency at 700–960 MHz and 1.7–6 GHz ............................................................... 19 Figure 13: Antenna Efficiency at 1.7–6 GHz.............................................................................................. 19 Figure 14: RM500Q-CN/RM500Q-GL RF cable Sequence....................................................................... 20 Figure 15: RM500Q-AE/RM502Q-AE RF Cable Sequence ...................................................................... 21 Figure 16: Assembling (Step One)............................................................................................................. 22 Figure 17: Assembling (Step Two)............................................................................................................. 23 Figure 18: Assembling (Step Three) .......................................................................................................... 23 Figure 19: RM500Q-CN/RM500Q-GL RF Cable Assembly ...................................................................... 24 Figure 20: RM500Q-AE/RM502Q-AE RF Cable Assembly....................................................................... 24 Figure 21: Assembling (Step Four) ............................................................................................................ 25 Figure 22 Assembling (Step Five).............................................................................................................. 25 Figure 23: Assembled EVB Kit................................................................................................................... 26 Figure 24: USB Ports ................................................................................................................................. 27 Figure 25: COM Port Setting Field on QCOM (USB AT Port Connection)................................................ 27 Figure 26: Configurations for Firmware Upgrade ...................................................................................... 28 RMU500-EKNM_EVB_Kit_User_Guide 7 / 30 5G Module Series 1 Introduction This document introduces the EVB kit, RMU500-EKNM, for Quectel 5G M.2 modules, which is an assistant tool kit for engineers to develop and test the modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series 5G Models RM500Q-CN RM500Q-GL RM500Q-AE RM502Q-AE RMU500-EKNM_EVB_Kit_User_Guide 8 / 30 5G Module Series 2 General Overview Quectel provides the RMU500-EKNM EVB kit for engineers to develop applications based on 5G M.2 modules and to test basic functionalities of the applicable modules. 2.1. Key Features Table 2: Key Features Features Power Supply M.2 Interface (U)SIM Interface USB Interface Status Indication Physical Characteristics Description DC power supply: +5 V/ 2.5 A for the EVB Interface to mount applicable 5G M.2 modules Support 1.8/2.95 V (U)SIM card ⚫ USB Type-C Interface ⚫ USB 2.0 & USB 3.1 2 LEDs available for signal indication Size: 100 mm × 60 mm RMU500-EKNM_EVB_Kit_User_Guide 9 / 30 2.2. Component Placement of the EVB 5G Module Series C207 J201 J301 Shielding Cover C209 C208 J101 Shielding Cover D104 D107 C206 J401 Type-B Figure 1: Component Placement of the EVB (Top View) Table 3: Interfaces of the EVB Interfaces Power Supply M.2 Interface Reference Designator J101 (Power Jack) J201 USB Interface J301 (U)SIM Interface J401 Indication LEDs D104 (POWER_LED) D107 (WWAN_LED) Description The power jack on the EVB Typical supply voltage: +5 V/ 2.5 A The M.2 connecter for the module USB Type-C interface used for: ⚫ data transmission ⚫ power supply (typical supply voltage: +5 V/ 2 A) (U)SIM card connector Power indicator, indicating whether the module’s power supply is ready RF status indicator for the module RMU500-EKNM_EVB_Kit_User_Guide 10 / 30 2.3. Top and bottom View of the EVB The following figure shows the top view of the EVB. 5G Module Series Figure 2: EVB Top View The following figure shows the bottom view of the EVB. Figure 3: EVB Bottom View RMU500-EKNM_EVB_Kit_User_Guide 11 / 30 2.4. EVB Kit Accessories 5G Module Series Table 4: List of Accessories Item Description Quantity (pcs) Type-C to dual Type-A cable 1 Cable RF cables 4 Antenna Antennas with brackets 4 Soft silicone pad Thermal conductive pad 1 Heatsink USB flash drive Screw Black anodized AL6063 1 Including the related documents, tools, and drivers for the 1 module and RMU500-EKNM. Used to clamp the module, antennas and heatsink on the EVB 19 NOTE NONE of the applicable 5G M.2 modules are included as accessories of the RMU500-EKNM EVB kit. RF cables, heatsink, soft silicone pad, and screws are included as accessories. RMU500-EKNM_EVB_Kit_User_Guide 12 / 30 5G Module Series 3 Interface Application This chapter describes the following hardware interfaces of RMU500-EKNM: ⚫ Power supply (J101/J301) ⚫ M.2 interface (J201) ⚫ USB interface (J301) ⚫ (U)SIM interface (J401) ⚫ RF cables and antennas It also provides information about the status indicator LEDs (D104/D107) to help you use the EVB. 3.1. Power Supply (J101/J301) The EVB is powered by an external power adapter through the power jack (J101) on the EVB. It can also be powered by the USB interface (J301, referring to Chapter 3.3). The following figure shows the power supply interfaces of the EVB. J301 J101 Figure 4: EVB Power Supply Interfaces RMU500-EKNM_EVB_Kit_User_Guide 13 / 30 5G Module Series 3.2. M.2 Interface (J201) The M.2 connector is designed to accommodate the module. The following figure shows the M.2 connector on the EVB. J201 M.2 Connector Figure 5: M.2 Connector of the EVB RMU500-EKNM_EVB_Kit_User_Guide 14 / 30 5G Module Series 3.3. USB Interface (J301) The EVB provides a Type-C USB connector (J301) for the connection with a host. Type-C USB can be used for data transmission. Also, it can be used as power supply interface to power on the EVB. J301 USB Connector Figure 6: USB Connector Figure 7: Connection Between PC and EVB RMU500-EKNM_EVB_Kit_User_Guide 15 / 30 5G Module Series One end of Type-A is connected to the computer, and, when necessary (e.g., when power supply from the Type-A connected to the PC is inadequate), the other end is connected to the auxiliary power supply. 3.4. (U)SIM Interface (J401) The EVB has an 8-pin push-push type (U)SIM card (1.8/2.95 V) connector (J401). The following figure shows a simplified connection schematic for the (U)SIM card connecter. Module USIM_VDD USIM_RST USIM_CLK USIM_DATA USIM_DET GND Push-Push C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK C7 USIM_DATA (U)SIM card connector C4 RESERVED C8 RESERVED CD USIM_DET J401 Figure 8: Simplified Connection Schematic for (U)SIM Card Connector J401 The figure and table below illustrate the pin assignment and pin definition of (U)SIM card connector. CD C8 C4 C7 C3 C6 C2 C5 C1 J401 Figure 9: Pin Assignment of (U)SIM Card Connector J401 RMU500-EKNM_EVB_Kit_User_Guide 16 / 30 Table 5: Pin Definition of J401 Pin No. C1 C2 C3 C4 C5 C6 C7 C8 CD Pin Name USIM_VDD USIM_RST USIM_CLK RESERVED GND VPP USIM_DATA RESERVED USIM_DET 5G Module Series I/O Function PO (U)SIM card power supply DO (U)SIM card reset DO (U)SIM card clock - Not connected - Ground - Not connected DIO (U)SIM card data - Not connected DI (U)SIM card detection 3.5. Status Indicator (D104/D107) The EVB provides two status indicator LEDs (D104 and D107). The following figure shows the positions of these indicators. D104 D107 Figure 10: Status Indicators RMU500-EKNM_EVB_Kit_User_Guide 17 / 30 5G Module Series Table 6: Description of Status Indicator LEDs Reference Designator D104 (POWER_LED) D107 (WWAN_LED) Description Power indicator, indicating whether the module’s power supply is ready. Light on: power on Light off: power off RF status indicator for the module. Light on: RF function is enabled Light off: RF function is disabled 3.6. RF Cables and Antennas 3.6.1. Antenna Design The following figure is a typical reference design for antennas of the EVB kit. Module ANT R1 0 R C1 C2 NM NM Figure 11: Reference Design for Antennas The matching circuit is composed of C1, C2 and R1 for antenna impedance modification. The value of R1 is 0 Ω, while C1 and C2 are not mounted by default. RMU500-EKNM_EVB_Kit_User_Guide 18 / 30 3.6.2. Antenna Efficiency 5G Module Series Figure 12: Antenna Efficiency at 700–960 MHz and 1.7–6 GHz Figure 13: Antenna Efficiency at 1.7–6 GHz NOTE All measurements are done for the antennas of the RMU500-EKNM EVB kit with Agilent E5071C ENA network analyzer and OTA chamber. RMU500-EKNM_EVB_Kit_User_Guide 19 / 30 5G Module Series 3.6.3. Antenna Specification The specification of antennas is provided in the following table. Table 7: Antenna Specification Antenna Ant 0 Ant 1 Ant 2 Ant 3 Specification Frequency Range: 0.7–6 GHz Input Impedance: 50 Ω Frequency Range: 1.7–6 GHz Input Impedance: 50 Ω Frequency Range: 1.7–6 GHz Input Impedance: 50 Ω Frequency Range: 0.7–6 GHz Input Impedance: 50 Ω The cable assembly varies when different modules are used with this EVB kit. The installations for RM500Q-CN and RM500Q-GL are the same, so does that for RM500Q-AE and RM502Q-AE). The following figures illustrate these cable connections. Figure 14: RM500Q-CN/RM500Q-GL RF cable Sequence RMU500-EKNM_EVB_Kit_User_Guide 20 / 30 5G Module Series Figure 15: RM500Q-AE/RM502Q-AE RF Cable Sequence NOTE 1. Ant 0–3 have been assembled on the EVB to prevent damage during transportation. 2. The RM500Q-CN module, which supports GNSS L1 + L5, cannot support L5 in this case because the frequency range of Ant 1 is 1.7–6 GHz. RMU500-EKNM_EVB_Kit_User_Guide 21 / 30 5G Module Series 4 EVB Operation Procedures This chapter introduces how to assemble and use the RMU500-EKNM EVB kit to test and evaluate the module. 4.1. Component Assembling Steps Please follow these steps to assemble the product. Step 1: Remove the antennas one by one, and keep the antennas and screws. Figure 16: Assembling (Step One) RMU500-EKNM_EVB_Kit_User_Guide 22 / 30 5G Module Series Step 2: Attach the thermal conductive pad, insert the module, and lock the screw. Figure 17: Assembling (Step Two) Step 3: Insert four RF cables. There are two RF cable assembling methods when the EVB kit is used with different modules. Figure 18: Assembling (Step Three) RMU500-EKNM_EVB_Kit_User_Guide 23 / 30 5G Module Series Figure 19: RM500Q-CN/RM500Q-GL RF Cable Assembly Figure 20: RM500Q-AE/RM502Q-AE RF Cable Assembly RMU500-EKNM_EVB_Kit_User_Guide 24 / 30 Step 4: Place the heatsink on the module and tighten the screws. 5G Module Series Figure 21: Assembling (Step Four) Step 5: Assemble the antenna in turn and tighten the screws. Figure 22 Assembling (Step Five) RMU500-EKNM_EVB_Kit_User_Guide 25 / 30 Then, the assembly is finished. The assembled EVB kit is shown below. 5G Module Series Figure 23: Assembled EVB Kit 4.2. Turn On the Module 1. Finish the assembling steps above. 2. Insert a (U)SIM card into the (U)SIM card connector on the EVB. 3. Insert the USB cable (Type-C to dual Type-A). Connect the type-C end to the EVB, one Type-A end to the computer, and the other Type-A end to an auxiliary power supply. The module will be turned on automatically when the EVB is powered through the USB interface (J301) or the power jack (J101). 4.3. Communication Via USB Interface 1. Power on the module according to the procedure in Chapter 4.1. 2. When the EVB is connected to a PC with the USB Type-C cable through the USB interface, run the USB driver disk on the PC to install the USB driver. For details about USB driver installation, see document [1]. The USB port numbers can be viewed in Device Manager of the PC when the USB driver is installed, as shown below. RMU500-EKNM_EVB_Kit_User_Guide 26 / 30 5G Module Series Figure 24: USB Ports 3. Install and then use QCOM provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting of QCOM: select correct 'COM Port' (USB AT Port which is shown in the figure above) and set correct 'Baudrate' (e.g. 115200 bps). For more details about QCOM usage and configuration, see document [2]. Figure 25: COM Port Setting Field on QCOM (USB AT Port Connection) 4.4. Firmware Upgrade Firmware of the module is upgraded via USB port by default, please follow the procedures below to upgrade the firmware. 1. Install and open the firmware upgrade tool, QFlash, on the PC and then turn on the module according to the procedures in Chapter 4.2. 2. Click the 'COM Port' dropdown list and select the Port No. corresponding to 'Quectel USB DM Port' in the Device Manager. 3. Click the 'Load FW Files' button and choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. RMU500-EKNM_EVB_Kit_User_Guide 27 / 30 5G Module Series Figure 26: Configurations for Firmware Upgrade For more details about QFlash usage and configuration, see document [3]. 4.5. Turn Off the Module There are two methods to turn off the module. ⚫ Hardware method: the module will be turned off after the power supply is disconnected. ⚫ Software method: the module can be turned off with AT+QPOWD command, which is a preferred and safer method. The module will log off from the network and save data before shutdown. RMU500-EKNM_EVB_Kit_User_Guide 28 / 30 5G Module Series 5 Appendix References Table 8: Related Documents Document Name [1] Quectel_LTE&5G_Windows_USB_Driver_Installation_Guide [2] Quectel_QCOM_User_Guide [3] Quectel_QFlash_User_Guide [4] Quectel_RG50xQ&RM5xxQ_Series_AT_Commands_Manual Table 9: Terms and Abbreviations Abbreviation COM DC DI DO EVB GND I/O LED NC PC PCB Description Communication Port Direct Current Digital Input Digital Output Evaluation Board Ground Input/Output Light Emitting Diode Not Connected Personal Computer Printed Circuit Board RMU500-EKNM_EVB_Kit_User_Guide 29 / 30 PO RF SD SIM UART USB (U)SIM 5G Module Series Power Output Radio Frequency Secure Digital Subscriber Identity Module Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module RMU500-EKNM_EVB_Kit_User_Guide 30 / 30

RMU500-EK User Guide 5G Module Series Version: 1.0 Date: 2020-11-23 Status: Released www.quectel.com 5G Module Series RMU500-EK User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. RMU500-EK_User_Guide 1 / 28 5G Module Series RMU500-EK User Guide Copyright The information contained here is proprietary technical information of Quectel wireless solutions co., ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved. RMU500-EK_User_Guide 2 / 28 5G Module Series RMU500-EK User Guide About the Document Revision History Version 1.0 Date 2019-12-19 2020-11-23 Author Tom TANG/ Shaky LIN Tom TANG/ Shaky LIN Description Creation of the document First official release RMU500-EK_User_Guide 3 / 28 5G Module Series RMU500-EK User Guide Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 1.1. Safety Information ................................................................................................................... 7 2 General Overview................................................................................................................................. 9 2.1. Key Features ........................................................................................................................... 9 2.2. Component Placement of the EVB ....................................................................................... 10 2.3. Top View of the EVB ............................................................................................................. 11 2.4. EVB Kit Accessories.............................................................................................................. 11 3 Components/Interfaces ..................................................................................................................... 13 3.1. Components/Interfaces of the EVB....................................................................................... 13 3.1.1. Power Supply (J101/J301) ............................................................................................. 13 3.1.2. M.2 Interface (J201) ....................................................................................................... 14 3.1.3. USB Interface (J301)...................................................................................................... 14 3.1.4. (U)SIM Interface (J401).................................................................................................. 15 3.1.5. Status Indicator (D104/D107) ........................................................................................ 17 3.1.6. RF Cables and Antennas ............................................................................................... 18 3.1.6.1. Antenna Design .................................................................................................... 18 3.1.6.2. Antenna Efficiency ................................................................................................ 18 3.1.6.3. Antenna Specification ........................................................................................... 19 3.2. Component Assembling Steps .............................................................................................. 20 4 EVB Operation Procedures............................................................................................................... 24 4.1. Turn on the Module ............................................................................................................... 24 4.2. Communication Via the USB Interface ................................................................................. 24 4.3. Firmware Upgrade................................................................................................................. 25 4.4. Turn Off the Module .............................................................................................................. 26 5 Appendix References ........................................................................................................................ 27 RMU500-EK_User_Guide 4 / 28 5G Module Series RMU500-EK User Guide Table Index Table 1: Key Features .................................................................................................................................. 9 Table 2: Interfaces and Functions of the EVB ........................................................................................... 10 Table 3: Accessories List ........................................................................................................................... 11 Table 4: Pin Definition of J401 ................................................................................................................... 16 Table 5: Description of Status Indicator LEDs ........................................................................................... 17 Table 6: Antenna Specification .................................................................................................................. 19 Table 7: Related Documents...................................................................................................................... 27 Table 8: Terms and Abbreviations ............................................................................................................. 27 RMU500-EK_User_Guide 5 / 28 5G Module Series RMU500-EK User Guide Figure Index Figure 1: Component Placement of the EVB (Top View) .......................................................................... 10 Figure 2: EVB Top View............................................................................................................................. 11 Figure 3: EVB Power Supply Interfaces..................................................................................................... 13 Figure 4: M.2 Connector on the EVB ......................................................................................................... 14 Figure 5: USB Connector ........................................................................................................................... 14 Figure 6: Connection Between PC and EVB ............................................................................................. 15 Figure 7: Simplified Connecting Schematic for (U)SIM Card Connector J401.......................................... 15 Figure 8: Pin Assignment of (U)SIM Card Connector J401....................................................................... 16 Figure 9: Status Indicators ......................................................................................................................... 17 Figure 10: Reference Design for Antennas ............................................................................................... 18 Figure 11: Antenna Efficiency at 700–960 MHz and 1.7–6 GHz............................................................... 18 Figure 12: Antenna Efficiency at 1.7–6 GHz.............................................................................................. 19 Figure 13: Assembling Step 1 .................................................................................................................... 20 Figure 14: Assembling Step 2 .................................................................................................................... 21 Figure 15: Assembling Step 3 .................................................................................................................... 21 Figure 16: Assembling Step 4 .................................................................................................................... 22 Figure 17: Assembling Step 5 .................................................................................................................... 22 Figure 18: Assembling Step 6 .................................................................................................................... 23 Figure 19: USB Ports ................................................................................................................................. 24 Figure 20: COM Port Setting Field on QCOM (USB AT Port Connection)................................................ 25 Figure 21: Configurations for Firmware Upgrade ...................................................................................... 25 RMU500-EK_User_Guide 6 / 28 5G Module Series RMU500-EK User Guide 1 Introduction This document introduces the evaluation board RMU500-EK for RM500Q-GL, the assistant tool for developers to develop and test the modules, and describes how to use it. 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergent help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. RMU500-EK_User_Guide 7 / 28 5G Module Series RMU500-EK User Guide The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. RMU500-EK_User_Guide 8 / 28 5G Module Series RMU500-EK User Guide 2 General Overview Quectel supplies RMU500-EK for designers to develop applications based on RM500Q-GL module and to test basic functionalities of it. 2.1. Key Features The following table describes the detailed features of RMU500-EK. Table 1: Key Features Features Power Supply M.2 Interface (U)SIM Interface USB Interface Status Indication Physical Characteristics Description DC supply: +5 V/ 2.5 A for the EVB Support RM500Q-GL Support (U)SIM card: 2.95/1.8 V USB 3.1 & USB 2.0 2 LEDs available for signal indication Size: 100 mm × 60 mm RMU500-EK_User_Guide 9 / 28 2.2. Component Placement of the EVB 5G Module Series RMU500-EK User Guide J301 Shielding Cover J101 Shielding Cover DDd D10 D4104 D107 J401 Type-B Figure 1: Component Placement of the EVB (Top View) Table 2: Interfaces and Functions of the EVB Interfaces Power Supply M.2 Interface Reference Designators Description J101 (Power Jack) J301 (Type-C USB) The power jack on the EVB Typical supply voltage: +5 V/ 2.5 A Type-C USB interface Typical supply voltage: +5 V/ 2 A J201 The M.2 connecter for the module USB Interface J301 USB interface (U)SIM Interface J401 Indicator LEDs D104 (POWER_LED) D107 (WWAN_LED) (U)SIM card connector Power indicator, indicating whether the module’s power supply is ready. RF status indicator RMU500-EK_User_Guide 10 / 28 2.3. Top View of the EVB Top view of the EVB is exhibited by the figure below. 5G Module Series RMU500-EK User Guide Figure 2: EVB Top View 2.4. EVB Kit Accessories All accessories for the EVB are listed in the following table. Table 3: Accessories List Items Cables Antennas Description Type-C to dual Type-A cable RF cables Antennas with brackets Quantity 1 4 4 RMU500-EK_User_Guide 11 / 28 Silicone Heatsink USB Flash Drive Screws 5G Module Series RMU500-EK User Guide Silicone soft pad 1 Black anodized AL6063 1 Including the related documents, tools, and 1 drivers for the module and RMU500-EK. Used to clamp the module, antennas and 19 heatsink on the EVB RMU500-EK_User_Guide 12 / 28 5G Module Series RMU500-EK User Guide 3 Components/Interfaces 3.1. Components/Interfaces of the EVB This chapter mainly describes the application of the following EVB interfaces: ⚫ Power supply ⚫ M.2 interface ⚫ USB interface ⚫ (U)SIM interface ⚫ RF cables and antennas It also provides information about the status indicator LEDs to help you use the EVB. 3.1.1. Power Supply (J101/J301) The EVB can be powered by an external power adapter through the power jack (J101) on the EVB. It can be also powered by the USB interface through the power jack (J301) on the EVB. The following figure shows the power supply interfaces of the EVB. Figure 3: EVB Power Supply Interfaces RMU500-EK_User_Guide 13 / 28 5G Module Series RMU500-EK User Guide 3.1.2. M.2 Interface (J201) The M.2 connector is designed to accommodate the module. The following figure shows the M.2 connector on RMU500-EK.. Figure 4: M.2 Connector on the EVB 3.1.3. USB Interface (J301) The EVB provides a Type-C USB connector J301 for the connection with a host. RMU500-EK_User_Guide Figure 5: USB Connector 14 / 28 5G Module Series RMU500-EK User Guide Figure 6: Connection Between PC and EVB One end of Type-A is connected to the computer, and, when necessary (e.g. when power supply from the Type-A connected to the PC is inadequate), the other end is connected to the auxiliary power supply. 3.1.4. (U)SIM Interface (J401) The EVB has an 8-pin push-push type (U)SIM card (1.8/2.95 V) connector J401. The following figure shows a simplified connecting schematic for J401. Module USIM_VDD USIM_RST USIM_CLK USIM_DATA USIM_DET GND Push-Push C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK C7 USIM_DATA (U)SIM card connector C4 RESERVED C8 RESERVED CD USIM_DET J401 Figure 7: Simplified Connecting Schematic for (U)SIM Card Connector J401 RMU500-EK_User_Guide 15 / 28 5G Module Series RMU500-EK User Guide The figure and table below illustrate the pin assignment and pin definition of (U)SIM card connector J401. Figure 8: Pin Assignment of (U)SIM Card Connector J401 Table 4: Pin Definition of J401 Pin No. C1 C2 C3 C4 C5 C6 C7 C8 CD Pin Name USIM_VDD USIM_RST USIM_CLK RESERVED GND VPP USIM_DATA RESERVED USIM_DET I/O Function PO (U)SIM card power supply DO (U)SIM card reset DO (U)SIM card clock - Not connected - Ground - Not connected I/O (U)SIM card data - Not connected DI (U)SIM card insertion detection 1) NOTE 1) USIM_DET function of RM500Q-GL module is under development. RMU500-EK_User_Guide 16 / 28 5G Module Series RMU500-EK User Guide 3.1.5. Status Indicator (D104/D107) The EVB provides two status indicator LEDs D104 and D107. The following figure shows the positions of these indicators. Figure 9: Status Indicators Table 5: Description of Status Indicator LEDs Reference Designators D104 D107 Description Indicates whether the power supply for the module is ready. Light on: Power on light off: Power off RF status indicator for the module. Light on: RF function is enabled; light off: RF function is disabled. RMU500-EK_User_Guide 17 / 28 3.1.6. RF Cables and Antennas 3.1.6.1. Antenna Design The following figure is a typical reference design for the antennas. 5G Module Series RMU500-EK User Guide Module ANT R1 0R C1 C2 NM NM Figure 10: Reference Design for Antennas The matching circuit is composed of C1, C2 and R1 for antenna impedance modification. By default, the value of R1 is 0 Ω, while C1 and C2 are not mounted. 3.1.6.2. Antenna Efficiency Figure 11: Antenna Efficiency at 700–960 MHz and 1.7–6 GHz RMU500-EK_User_Guide 18 / 28 5G Module Series RMU500-EK User Guide Figure 12: Antenna Efficiency at 1.7–6 GHz NOTE All measurements are done for the antenna mounted on RMU500-EK PCB with VNA Agilent 5071C and OTA chamber. 3.1.6.3. Antenna Specification The specification of antennas are provided in the following table. Table 6: Antenna Specification Antenna Ant.0 Ant.1 Ant.2 Ant.3 Specification Frequency Range: 0.7–6 GHz Input Impedance: 50 Ω Frequency Range: 1.7–6 GHz Input Impedance: 50 Ω Frequency Range: 1.7–6 GHz Input Impedance: 50 Ω Frequency Range: 0.7–6 GHz Input Impedance: 50 Ω RMU500-EK_User_Guide 19 / 28 3.2. Component Assembling Steps Please follow these steps to assemble the product. Step 1: Insert four RF cables. 5G Module Series RMU500-EK User Guide Figure 13: Assembling Step 1 RMU500-EK_User_Guide 20 / 28 5G Module Series RMU500-EK User Guide Step 2: Stick the thermal pad, insert the module into the M.2 connector and tighten the screw. Figure 14: Assembling Step 2 Step 3: Connect the EVB and the module with RF cables as illustrated by the figure below. Figure 15: Assembling Step 3 RMU500-EK_User_Guide 21 / 28 Step 4: Place the heatsink on the module and tighten the screws. 5G Module Series RMU500-EK User Guide Figure 16: Assembling Step 4 Step 5: Install the antennas in turn and tighten the screws. Figure 17: Assembling Step 5 RMU500-EK_User_Guide 22 / 28 Step 6: Assembling finished. 5G Module Series RMU500-EK User Guide Figure 18: Assembling Step 6 RMU500-EK_User_Guide 23 / 28 5G Module Series RMU500-EK User Guide 4 EVB Operation Procedures This chapter introduces how to use the EVB for the testing evaluation of the module. 4.1. Turn on the Module 1. Finish the assembling steps in Chapter 3.2. 2. Insert a (U)SIM card into the (U)SIM card connector on the EVB. 3. Insert the USB cable (Type-C to dual Type-A), and connect one Type-A end to the computer and the other end to the auxiliary power supply. The Type-C end is connected to the EVB. Power on the EVB and the module will be turned on automatically. 4.2. Communication Via the USB Interface 1. Turn on the module according to the procedure in Chapter 4.1. 2. Connect the EVB and a PC with the USB cable through USB interface, and then run the driver disk on the PC to install the USB driver. For details about USB driver installation, see document [1]. Figure 19: USB Ports 3. Install and then use the tool, QCOM, provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting in QCOM: select correct 'COM Port' (USB AT Port which is shown in the figure above) and set correct 'Baudrate' (such as 115200 bps). For more details about QCOM usage and configuration, see document [2]. RMU500-EK_User_Guide 24 / 28 5G Module Series RMU500-EK User Guide Figure 20: COM Port Setting Field on QCOM (USB AT Port Connection) 4.3. Firmware Upgrade The firmware of the module is upgraded via USB port by default, please follow the procedures below to upgrade the firmware. 1. Install and open the firmware upgrade tool, QFlash, on the PC and then turn on the module according to the procedures in Chapter 4.1. 2. Click the 'COM Port' dropdown list and select the Port No. corresponding to 'Quectel USB DM Port'. 3. Click the 'Load FW Files' button and choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. Figure 21: Configurations for Firmware Upgrade RMU500-EK_User_Guide 25 / 28 5G Module Series RMU500-EK User Guide For more details about QFlash usage and configuration, see document [3]. 4.4. Turn Off the Module There are two methods to turn off the module. ⚫ Hardware method: the module will be turned off after the USB cable is disconnected. ⚫ Software method: the module can be turned off with the AT command AT+QPOWD. RMU500-EK_User_Guide 26 / 28 5G Module Series RMU500-EK User Guide 5 Appendix References Table 7: Related Documents SN Document Name Description Quectel_LTE&5G_Windows_USB_Driver Installation guide of USB driver for LTE&5G modules [1] _Installation_Guide on Windows system [2] Quectel_QCOM_User_Guide User guide for QCOM tool [3] Quectel_QFlash_User_Guide User guide for QFlash tool Quectel_RG50xQ&RM5xxQ_Series_AT [4] _Commands_Manual AT commands manual for RM500Q-GL, RM500Q-AE, RM502Q-GL, RM502Q-AE, RM510Q-GL, RG500Q series, and RG502Q-EA module [5] Quectel_RM500Q-GL_Hardware_Design Hardware design for RM500Q-GL module Table 8: Terms and Abbreviations Abbreviation COM DC DI DO EVB GND GNSS I/O LED NC Description Communication Port Direct Current Digital Input Digital Output Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode Not Connected RMU500-EK_User_Guide 27 / 28 PC PCB PO RF SD SIM UART USB (U)SIM 5G Module Series RMU500-EK User Guide Personal Computer Printed Circuit Board Power Output Radio Frequency Secure Digital Subscriber Identity Module Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module RMU500-EK_User_Guide 28 / 28

Smart 5G EVB User Guide Smart Module Series Version: 1.1 Date: 2022-06-18 Status: Released Smart Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide schematic designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. Smart_5G_EVB_User_Guide 1 / 62 Smart Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. Smart_5G_EVB_User_Guide 2 / 62 Smart Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. Smart_5G_EVB_User_Guide 3 / 62 Smart Module Series About the Document Revision History Version Date Author Description - 2022-01-26 Jian WU/ Chris ZHANG Creation of the document 1.0 2022-02-18 Jian WU/ Chris ZHANG First official release 1. Added a note about the single/dual screen configuration (Chapter 1). 1.1 2022-06-18 Jian WU/ Chris ZHANG 2. Upgraded the top view for the component placement (Figure 3). Smart_5G_EVB_User_Guide 4 / 62 Smart Module Series Contents Safety Information...................................................................................................................................... 3 About the Document .................................................................................................................................. 4 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 7 Figure Index ................................................................................................................................................ 8 1 Introduction ....................................................................................................................................... 10 2 Product Overview ............................................................................................................................. 11 Top and Bottom Views ............................................................................................................. 11 Component Placement ............................................................................................................ 13 Key Features ............................................................................................................................ 16 3 Kit Accessories & Assembly ........................................................................................................... 18 Accessories Assembly ............................................................................................................. 18 Accessories List ....................................................................................................................... 19 4 Application Interfaces ...................................................................................................................... 21 Power Supply ........................................................................................................................... 21 4.1.1. DC Power ...................................................................................................................... 22 4.1.2. Battery Power................................................................................................................ 23 4.1.3. Power Switch................................................................................................................. 24 TE-A Interface .......................................................................................................................... 25 LCM Interfaces......................................................................................................................... 32 4.3.1. Main/Secondary LCM Interfaces................................................................................... 32 4.3.2. Backlight Driver for LCM Interfaces .............................................................................. 35 Touch Panel Interfaces ............................................................................................................ 35 Camera Interfaces.................................................................................................................... 37 USB Interfaces ......................................................................................................................... 39 Audio Interfaces ....................................................................................................................... 40 4.7.1. Loudspeaker Interface .................................................................................................. 41 4.7.2. Earpiece Interface ......................................................................................................... 41 4.7.3. Headset Interface.......................................................................................................... 42 4.7.4. Microphone Interfaces................................................................................................... 43 (U)SIM Card Interfaces ............................................................................................................ 45 UART & Debug Interfaces ....................................................................................................... 47 SD Card Interface .................................................................................................................... 49 Flashlight .................................................................................................................................. 50 Sensors .................................................................................................................................... 51 Ethernet Interface..................................................................................................................... 51 Emergency Download Interface............................................................................................... 52 Vibrator..................................................................................................................................... 53 Buttons ..................................................................................................................................... 54 VBAT Status Indicator.............................................................................................................. 54 Smart_5G_EVB_User_Guide 5 / 62 Smart Module Series RF Antennas ............................................................................................................................ 55 4.18.1. Antenna Distribution and Definition .............................................................................. 55 4.18.2. Antenna Connection ..................................................................................................... 56 5 Operation Procedures ...................................................................................................................... 57 Turn On the Module ................................................................................................................. 57 Turn Off/Reboot the Module .................................................................................................... 58 Communication via USB Interface ........................................................................................... 58 Communication via UART Interface ........................................................................................ 59 6 Appendix References ....................................................................................................................... 61 Smart_5G_EVB_User_Guide 6 / 62 Smart Module Series Table Index Table 1: Components & Functions............................................................................................................. 14 Table 2: Key Features ................................................................................................................................ 16 Table 3: Accessory List .............................................................................................................................. 19 Table 4: Power Supply ............................................................................................................................... 21 Table 5: Pin Definition of Battery Connector.............................................................................................. 24 Table 6: TE-A B2B Connectors.................................................................................................................. 25 Table 7: Pin Definition of B2B Connectors ................................................................................................ 26 Table 8: LCM Interfaces ............................................................................................................................. 32 Table 9: Touch Panel Interfaces ................................................................................................................ 35 Table 10: Pin Definition of Touch Panel Connectors ................................................................................. 36 Table 11: USB Interfaces ........................................................................................................................... 39 Table 12: Pin Definition of Headset Audio Jack......................................................................................... 43 Table 13: (U)SIM Card Interfaces .............................................................................................................. 45 Table 14: Pin Definition of (U)SIM Card Connectors ................................................................................. 46 Table 15: UART Interfaces......................................................................................................................... 47 Table 16: Pin Definition of Main UART Connector .................................................................................... 48 Table 17: Ethernet Interface....................................................................................................................... 51 Table 18: Buttons ....................................................................................................................................... 54 Table 19: VBAT Status Indicator................................................................................................................ 55 Table 20: Antennas .................................................................................................................................... 56 Table 21: Related Document ..................................................................................................................... 61 Table 22: Terms and Abbreviations ........................................................................................................... 61 Smart_5G_EVB_User_Guide 7 / 62 Smart Module Series Figure Index Figure 1: Top View ..................................................................................................................................... 11 Figure 2: Bottom View ................................................................................................................................ 12 Figure 3: Top View for Component Placement.......................................................................................... 13 Figure 4: Bottom View for Component Placement..................................................................................... 14 Figure 5: Smart 5G EVB and Accessory Assembly................................................................................... 18 Figure 6: Smart 5G EVB Kit Accessories................................................................................................... 19 Figure 7: Simplified Power Supply Block Diagram of Smart 5G EVB ....................................................... 22 Figure 8: DC Power Jack ........................................................................................................................... 22 Figure 9: Power Plug Design ..................................................................................................................... 22 Figure 10: Schematic Design for Battery Connection................................................................................ 23 Figure 11: Pin Assignment of Battery Connector....................................................................................... 23 Figure 12: Battery Assembly ...................................................................................................................... 24 Figure 13: Power Switch ............................................................................................................................ 24 Figure 14: TE-A B2B Connectors .............................................................................................................. 25 Figure 15: Sketch Map of Smart 5G Module TE-A (Top View).................................................................. 25 Figure 16: Schematic Design for Main LCM Interface ............................................................................... 33 Figure 17: Schematic Design for Secondary LCM Interface ..................................................................... 34 Figure 18: Pin Assignment of LCM Connector .......................................................................................... 34 Figure 19: Schematic Design for Backlight Driver ..................................................................................... 35 Figure 20: Schematic Design for Touch Panel Interfaces ......................................................................... 36 Figure 21: Pin Assignment of Touch Panel Connectors ............................................................................ 36 Figure 22: Schematic Design for Camera1–5 Interfaces........................................................................... 38 Figure 23: Camera Interfaces with Cameras Assembled .......................................................................... 38 Figure 24: Schematic Design for USB Type-C Interface ........................................................................... 39 Figure 25: Schematic Design for Micro USB Interface .............................................................................. 40 Figure 26: Schematic Design for Loudspeaker Interface .......................................................................... 41 Figure 27: Schematic Design for Earpiece Interface ................................................................................. 41 Figure 28: Schematic Design for Headset Interface .................................................................................. 42 Figure 29: Pin Assignment of Headset Audio Jack.................................................................................... 42 Figure 30: Sketch Design of Audio Plug .................................................................................................... 43 Figure 31: Schematic Design for Analog Microphone Interfaces .............................................................. 44 Figure 32: ECM-Type and MEMS-Type Microphones............................................................................... 44 Figure 33: Schematic Design for DMIC Interfaces .................................................................................... 45 Figure 34: Schematic Design for (U)SIM Card Interfaces ......................................................................... 46 Figure 35: Pin Assignment of (U)SIM Card Connectors ............................................................................ 46 Figure 36: Debug Interface Circuit ............................................................................................................. 47 Figure 37: RS-232 Level Match Circuit ...................................................................................................... 48 Figure 38: Pin Assignment of Main UART Connector ............................................................................... 48 Figure 39: Schematic Design for SD Card Interface ................................................................................. 49 Figure 40: Pin Assignment of SD Card Connector .................................................................................... 49 Figure 41: Schematic Design for Flashlight Interface ................................................................................ 50 Smart_5G_EVB_User_Guide 8 / 62 Smart Module Series Figure 42: Flashlight................................................................................................................................... 50 Figure 43: Sensors ..................................................................................................................................... 51 Figure 44: Schematic Design for Ethernet Interface.................................................................................. 52 Figure 45: Ethernet Interface ..................................................................................................................... 52 Figure 46: Schematic Design for Emergency Download Interface............................................................ 52 Figure 47: Emergency Download Switch ................................................................................................... 53 Figure 48: Schematic Design for Vibrator .................................................................................................. 53 Figure 49: ERM-Type Vibrator ................................................................................................................... 53 Figure 50: Buttons ...................................................................................................................................... 54 Figure 51: VBAT Status Indicator .............................................................................................................. 54 Figure 52: Antenna Distribution ................................................................................................................. 55 Figure 53: Antenna Connection ................................................................................................................. 56 Figure 54: LCD Display Indicating Module’s Successful Power-on........................................................... 57 Figure 55: Menu to Select Whether to Continue Turn-off Operation......................................................... 58 Figure 56: Loaded USB Ports .................................................................................................................... 59 Figure 57: adb shell Command .................................................................................................................. 59 Figure 58: USB Serial Port ......................................................................................................................... 60 Figure 59: QCOM Configuration ................................................................................................................ 60 Smart_5G_EVB_User_Guide 9 / 62 Smart Module Series 1 Introduction This user guide describes the application details of the Smart 5G EVB (evaluation board), which is an assistant tool for you to develop applications and test basic functionalities of the Smart 5G module SG560D series. NOTE Single-screen is the default configuration of Smart 5G EVB. If you need a dual-screen configuration, please contact Quectel Technical Support. Smart_5G_EVB_User_Guide 10 / 62 Smart Module Series 2 Product Overview Top and Bottom Views The size of Smart 5G EVB is 190 mm × 265 mm, and the top and bottom views are as shown below: Figure 1: Top View Smart_5G_EVB_User_Guide 11 / 62 Smart Module Series Figure 2: Bottom View Smart_5G_EVB_User_Guide 12 / 62 Smart Module Series Component Placement ANT6 ANT2 U0301 U0203 Vibrator D0302 ANT3 J0802 Earpiece ANT_GNSS J0801 Speaker J0101 J0102 ANT4 J0401 J0503 CAM1 TP1 J0402 J0403 CAM2 CAM3 ANT0 J0404 CAM4 J0504 TP2 TE-A J0405 CAM5 ANT7 ANT1 WIFI_ANT0 WIFI_ANT2 J1101 S0201 J0302 S0305 J0501 LCM1 J0502 LCM2 ANT5 J0202 J0201 D0301 J1001 J1002 J0803 J0901 J0902 ECM MEMS U0801 U0802 WIFI_ANT1 S0301 S0302 S0303 S0304 WIFI_ANT3 U0803 U0804 Figure 3: Top View for Component Placement Smart_5G_EVB_User_Guide 13 / 62 J0801 J0802 Smart Module Series J0601 SD J0303 J0603 (U)SIM2 J0602 (U)SIM1 Figure 4: Bottom View for Component Placement Table 1: Components & Functions Components Power Supply RefDes. J0201 J0202 Power Switch PWRKEY RESET_N VOL_UP VOL_DOWN S0201 S0301 S0302 S0303 S0304 Description DC power jack on the EVB Typical power supply: 12 V Li-polymer battery connector Typical power supply: 4.0 V Used to select DC or battery as the power supply, or to switch off the power supply Turn on/off the module Reserved Turn up the volume Turn down the volume Smart_5G_EVB_User_Guide 14 / 62 Smart Module Series USB_BOOT USB Interfaces Audio Interfaces (U)SIM Card Interfaces UART Interface Debug Interface SD Card Interface VBAT Status Indicator TE-A Interfaces Camera Interfaces Flashlight LCM and Touch Panel Interfaces S0305 Emergency download switch J1001 Micro USB connector J1002 J0801 J0802 J0803 USB Type-C connector ⚫ Loudspeaker ⚫ Rated resistance: 8 Ω ⚫ Rated power: 1.5 W ⚫ Earpiece ⚫ Rated resistance: 32 Ω ⚫ Rated power: 30 mW Audio jack for headset U0801 ECM-type microphone U0802 MEMS-type microphone U0803 & U0804 Digital microphones J0602 (U)SIM1 card connector J0603 (U)SIM2 card connector J0901 Main UART J0902 Debug Interface (Type-C connector) J0601 SD card connector D0301 Indicates VBAT on/off of the module J0101 J0102 Two B2B connectors for connection with Smart 5G module TE-A J0401 Camera1 connector, supports 16 MP CMOS sensor J0402 Camera2 connector, supports 16 MP CMOS sensor J0403 Camera3 connector, supports 16 MP CMOS sensor J0404 Camera4 connector, supports 8 MP CMOS sensor J0405 Camera5 connector, supports 2 MP CMOS sensor D0302 LED flashlight J0501 Connector for main LCM J0503 ZIF connector for main touch panel Smart_5G_EVB_User_Guide 15 / 62 J0502 J0504 Sensors J0302 Vibrator U0301 Coin Cell Battery U0203 NFC + SPI/I2S Interfaces J0303 Ethernet Interface J1101 Smart Module Series Connector for secondary LCM ZIF connector for secondary touch panel Accelerometer and gyroscope sensor Ambient light and proximity sensor ERM-type vibrator Coin cell battery for RTC backup power supply Reserved Ethernet interface Key Features The following table describes the key features of Smart 5G EVB. Table 2: Key Features Features Power Supply LCM Interfaces Touch Panel Interfaces Camera Interfaces USB Interfaces Audio Interfaces Description ⚫ DC power supply: 3.6–18 V (typical: 12 V) ⚫ Battery power supply: 3.55–4.4 V (typical: 4.0 V) ⚫ Two 5-inch 1280 × 720 HD LCDs ⚫ 4-lane MIPI DSI for each LCD 2 capacitive touch panels 5 cameras: ⚫ Camera1 supports 16 MP with 4-lane CSI ⚫ Camera2 supports 16 MP with 4-lane CSI ⚫ Camera3 supports 16 MP with 4-lane CSI ⚫ Camera4 supports 8 MP with 2-lane CSI ⚫ Camera5 supports 2 MP with 1-lane CSI 2 USB interfaces: ⚫ One USB Type-C interface compliant with USB 3.1 (Gen 1) and USB 2.0 specifications, with transmission rate up to 5 Gbps on USB 3.1 (Gen 1) and 480 Mbps on USB 2.0 ⚫ One Micro USB interface compliant with USB 2.0 specifications, with transmission rate up to 480 Mbps Analog Outputs: Smart_5G_EVB_User_Guide 16 / 62 Smart Module Series (U)SIM Card Interfaces UART Interface Debug Interface SD Card Interface NFC + SPI/I2S Interfaces Flashlight Sensors Vibrator Ethernet Switches and Buttons VBAT Status Indicator 3 analog audio outputs: ⚫ One mono loudspeaker differential amplifier output ⚫ One mono earpiece differential output ⚫ One stereo headphone output for headset Analog Inputs: 3 analog microphone inputs: ⚫ One single-ended microphone input for headset ⚫ One differential microphone input for ECM-type microphone ⚫ One differential microphone input for MEMS-type microphone Digital Inputs: 2 digital microphone inputs ⚫ Supports USIM/SIM cards: 1.8 V and 2.95 V ⚫ Supports dual SIM dual standby Main UART for data transmission and AT command communication Debug interface for debugging (Type-C connector) Supports 4-bit SD card with hot-swap detection Reserved 1 LED flashlight for testing the module’s flashlight interface Sensor TE-A: ⚫ ALS/PS sensor ⚫ Accelerometer/gyroscope sensor 1 vibrator for testing the module’s motor drive interface 1 Ethernet interface 2 switches: ⚫ Power switch ⚫ Emergency download switch (USB_BOOT) 4 buttons: ⚫ PWRKEY ⚫ RESET_N (reserved) ⚫ VOL_UP ⚫ VOL_DOWN 1 LED indicator for VBAT on/off indication Smart_5G_EVB_User_Guide 17 / 62 Smart Module Series 3 Kit Accessories & Assembly Accessories Assembly Figure 5: Smart 5G EVB and Accessory Assembly Smart_5G_EVB_User_Guide 18 / 62 Smart Module Series Accessories List All accessories of the Smart 5G EVB kit are listed as below. Please contact the supplier if there is something missing. 12 V DC Adapter GNSS Antenna USB to RS-232 Converter Cable USB Type-C Cable Li-polymer Battery Earpiece RF Cables DC Power Cable Figure 6: Smart 5G EVB Kit Accessories Table 3: Accessory List Items Cables Description USB to RS-232 converter cable USB Type-C cable RF cables DC power cable Quantity (pcs) 1 1 14 1 Smart_5G_EVB_User_Guide 19 / 62 Antenna Audio Battery Power Adapter GNSS antenna (passive) Earpiece Li-polymer battery 12 V DC power supply Smart Module Series 1 1 1 1 Smart_5G_EVB_User_Guide 20 / 62 Smart Module Series 4 Application Interfaces This chapter describes the hardware interfaces or components of Smart 5G EVB, listed as below: ⚫ Power supply ⚫ TE-A interface ⚫ LCM interfaces ⚫ Touch panel interfaces ⚫ Camera interfaces ⚫ USB interfaces ⚫ Audio interfaces ⚫ (U)SIM card interfaces ⚫ UART interfaces ⚫ SD card interface ⚫ Flashlight ⚫ Sensors ⚫ Ethernet interface ⚫ Emergency download interface ⚫ Vibrator ⚫ Buttons ⚫ VBAT status indicator ⚫ RF antennas Power Supply Table 4: Power Supply RefDes. J0201 J0202 S0201 Description ⚫ DC power jack on the EVB ⚫ Typical power supply: 12 V ⚫ Li-polymer battery connector ⚫ Typical power supply: 4.0 V Used to select DC or battery as the power supply, or to switch off the power supply Smart_5G_EVB_User_Guide 21 / 62 Smart Module Series The following figure shows the simplified power supply block diagram of Smart 5G EVB. U0201 12 V DC J0201 DC Power Jack DC-DC Converter Li-polymer Battery J0202 S0201 4 V Power Switch DC/Off/Battery Power supply for the module Figure 7: Simplified Power Supply Block Diagram of Smart 5G EVB 4.1.1. DC Power The Smart 5G EVB can be powered by an external 12 V DC power adapter through the power jack (J0201) on the board. The power jack is internally connected to the step-down converter (DC-DC converter) to convert the 12 V DC power supply voltage to 4 V for powering up the module. The following figure shows the DC power jack of the Smart 5G EVB. Figure 8: DC Power Jack The EVB kit provides a 12 V DC power adapter to supply power for the Smart 5G EVB. The power plug design of the adapter is as shown below. Inner contact Outer contact Figure 9: Power Plug Design Smart_5G_EVB_User_Guide 22 / 62 Smart Module Series 4.1.2. Battery Power The Smart 5G EVB can also be powered by a Li-polymer battery through the battery connector (J0202) on the board. The following figure shows a schematic design for battery connection. VBAT_BATT 6 D1 5 VBAT_BATT BATT_ID 4 BATT_THERM 3 GND 2 D2 GND 1 J0202 NM-100nF C1 100nF VBAT_BATT R2 NM-0R BATT_THERM C2 R1 100K Figure 10: Schematic Design for Battery Connection The following figure shows the pin assignment of battery connector, and the following table shows the pin definition of battery connector. Figure 11: Pin Assignment of Battery Connector Smart_5G_EVB_User_Guide 23 / 62 Smart Module Series Table 5: Pin Definition of Battery Connector Pin No. 1, 2 3 4 5, 6 Pin Name GND BATT_THERM BATT_ID VBAT_BATT Description ⚫ Ground pins ⚫ Connected to the negative pole of the battery ⚫ Used for battery temperature detection ⚫ A 100 kΩ NTC thermistor is used for the battery protection circuit Reserved ⚫ Power input pins ⚫ Connected to the positive pole of the battery Figure 12: Battery Assembly 4.1.3. Power Switch Power switch (S0201) is used to select DC or battery as the power supply, or to switch off the power supply. S0201 DC Power OFF Battery Power Figure 13: Power Switch Smart_5G_EVB_User_Guide 24 / 62 Smart Module Series TE-A Interface The TE-A interface includes two B2B connectors for connection with Smart 5G module TE-A. Table 6: TE-A B2B Connectors RefDes. J0101 J0102 Description Two B2B connectors for connection with Smart 5G module TE-A The following two figures show the two B2B connectors and the sketch map of Smart 5G module TE-A. J0101 J0102 Figure 14: TE-A B2B Connectors Figure 15: Sketch Map of Smart 5G Module TE-A (Top View) Smart_5G_EVB_User_Guide 25 / 62 The following table describes the pin definition of the two B2B connectors. Smart Module Series NOTE Different modules have different pin definition, please refer the schematic of the TE-A. Table 7: Pin Definition of B2B Connectors Pin No. (J0101) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 Pin Name (J0101) UART1_CTS GYRO_INT UART1_RXD ACCEL_INT UART1_RTS SENSOR_I2C_SDA UART1_TXD SENSOR_I2C_SCL UART2_RXD ALPS_INT UART2_TXD MAG_INT GND AUDIO_I2C_SCL USB1_DP AUDIO_I2C_SDA USB1_DM GND GND LPI_MI2S2_MCLK LDO6A_3V0 Pin No. (J0102) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 Pin Name (J0102) USIM1_VDD GND USIM1_DET DSI0_LN3_P USIM1_CLK DSI0_LN3_N USIM1_RST GND USIM1_DATA DSI0_LN2_P USIM2_VDD DSI0_LN2_N USIM2_DET GND USIM2_CLK DSI0_LN1_P USIM2_RST DSI0_LN1_N USIM2_DATA GND GND Smart_5G_EVB_User_Guide 26 / 62 22 GND 22 23 LDO6A_3V0 23 24 LPI_MI2S2_SCLK 24 25 LDO8A_2V8 25 26 LPI_MI2S2_WS 26 27 LDO11A_1V8 27 28 LPI_MI2S2_DATA0 28 29 LDO14A_1V8 29 30 LPI_MI2S2_DATA1 30 31 LDO14A_1V8 31 32 GND 32 33 LDO1E_1V8 33 34 LPI_DMIC1_CLK 34 35 LDO8E_1V8 35 36 LPI_DMIC1_DATA 36 37 GND 37 38 LPI_DMIC2_CLK 38 39 VREG_L3P_2P8 39 40 LPI_DMIC2_DATA 40 41 VREG_L4P_2P9 41 42 GND 42 43 VREG_L7P_2P8 43 44 USB2_DM 44 45 GND 45 46 USB2_DP 46 47 VREG_L1P_1P2 47 48 GND 48 49 VREG_L1P_1P2 49 Smart_5G_EVB_User_Guide Smart Module Series DSI0_LN0_P CSI0_LN3_P DSI0_LN0_N CSI0_LN3_N GND GND DSI0_CLK_P CSI0_LN2_P DSI0_CLK_N CSI0_LN2_N GND GND LCD0_TE CSI0_LN1_P LCD0_RST CSI0_LN1_N TP0_I2C_SCL GND TP0_I2C_SDA CSI0_LN0_P TP0_RST CSI0_LN0_N TP0_INT GND GND CSI0_CLK_P DSI1_LN3_P CSI0_CLK_N 27 / 62 50 USB_SS1_TX_M 50 51 VREG_L1P_1P2 51 52 USB_SS1_TX_P 52 53 VREG_L2P_1P1 53 54 GND 54 55 VREG_L2P_1P1 55 56 USB_SS1_RX_M 56 57 VREG_L2P_1P1 57 58 USB_SS1_RX_P 58 59 VREG_L5P_2P8 59 60 GND 60 61 VREG_L6P_1P8 61 62 USB_SS2_TX_M 62 63 GND 63 64 USB_SS2_TX_P 64 65 VRTC 65 66 GND 66 67 GPIO02_EN 67 68 USB_SS2_RX_M 68 69 GPIO03_EN 69 70 USB_SS2_RX_P 70 71 MIC_EN 71 72 GND 72 73 RESERVE1 73 74 USB_CC1_ID 74 75 RESERVE2 75 76 USB_CC2 76 77 LCD1_BL_A 77 Smart_5G_EVB_User_Guide Smart Module Series DSI1_LN3_N GND GND CSI3_LN3_P DSI1_LN2_P CSI3_LN3_N DSI1_LN2_N GND GND CSI3_LN2_P DSI1_LN1_P CSI3_LN2_N DSI1_LN1_N GND GND CSI3_LN1_P DSI1_LN0_P CSI3_LN1_N DSI1_LN0_N GND GND CSI3_LN0_P DSI1_CLK_P CSI3_LN0_N DSI1_CLK_N GND GND CSI3_CLK_P 28 / 62 78 USB_DP_AUX_M 78 79 LCD1_BL_K1 79 80 USB_DP_AUX_P 80 81 LCD1_BL_K2 81 82 NFC_INT 82 83 LCD1_BL_K3 83 84 NFC_CLK 84 85 LCD1_BL_K4 85 86 NFC_EN 86 87 USB_VBUS2 87 88 NFC_CLK_REQ 88 89 USB_VBUS2 89 90 NFC_DWL_REQ 90 91 USB_VBUS2 91 92 NFC_I2C_SDA 92 93 USB_VBUS1 93 94 NFC_I2C_SCL 94 95 VPH_PWR 95 96 NFC_WKUP 96 97 VPH_PWR 97 98 MIC2_DET 98 99 GND 99 100 GND 100 101 BAT_THERM 101 102 PWM1 102 103 BAT_ID 103 104 PWM2 104 105 GND 105 Smart_5G_EVB_User_Guide Smart Module Series LCD1_TE CSI3_CLK_N LCD1_RST GND TP1_I2C_SCL CSI1_LN3_P TP1_I2C_SDA CSI1_LN3_N TP1_RST GND TP1_INT CSI1_LN2_P ETH_3V3_EN CSI1_LN2_N CSI0_PWDN GND CSI3_PWDN CSI1_LN1_P MCAM_PWDN CSI1_LN1_N SCAM_PWDN GND DCAM_PWDN CSI1_LN0_P CSI0_RST CSI1_LN0_N CSI3_RST GND 29 / 62 106 GPIO11_EN 106 107 BAT_ISNS_P 107 108 FORCE_USB_BOOT 108 109 BAT_ISNS_M 109 110 GPIO12_EN 110 111 GND 111 112 VIB_DRV 112 113 VBAT_VSNS_P 113 114 GND 114 115 VBAT_VSNS_M 115 116 MI2S2_SCLK 116 117 GND 117 118 MI2S2_WS 118 119 GND 119 120 MI2S2_DATA0 120 121 GND 121 122 MI2S2_DATA1 122 123 GND 123 124 MI2S2_DATA2 124 125 GND 125 126 MI2S2_DATA3 126 127 GND 127 128 GND 128 129 GND 129 130 MI2S2_MCLK 130 131 GND 131 132 GND 132 133 GND 133 Smart_5G_EVB_User_Guide Smart Module Series MCAM_RST CSI1_CLK_P SCAM_RST CSI1_CLK_N DCAM_RST GND GND CSI2_LN1_P CSI0_MCLK CSI2_LN1_N GND GND CSI3_MCLK CSI2_LN0_P GND CSI2_LN0_N MCAM_MCLK GND GND CSI2_CLK_P SCAM_MCLK CSI2_CLK_N GND GND DCAM_MCLK CSI2_LN3_P GND CSI2_LN3_N 30 / 62 134 PCIE_REFCLK_M 134 135 VBAT 135 136 PCIE_REFCLK_P 136 137 VBAT 137 138 GND 138 139 VBAT 139 140 PCIE_TX0_M 140 141 VBAT 141 142 PCIE_TX0_P 142 143 VBAT 143 144 GND 144 145 VBAT 145 146 PCIE_RX0_M 146 147 VBAT 147 148 PCIE_RX0_P 148 149 VBAT 149 150 GND 150 151 VBAT 151 152 PCIE_TX1_M 152 153 VBAT 153 154 PCIE_TX1_P 154 155 VBAT 155 156 GND 156 157 VBAT 157 158 PCIE_RX1_M 158 159 VBAT 159 160 PCIE_RX1_P 160 161 VBAT 161 Smart_5G_EVB_User_Guide Smart Module Series HS_DET GND CAM_I2C_SDA0 CSI2_LN2_P CAM_I2C_SCL0 CSI2_LN2_N CAM_I2C_SDA1 GND CAM_I2C_SCL1 SD_CMD CAM_I2C_SDA2 SD_DET CAM_I2C_SCL2 SD_CLK SPI_CLK SD_DATA0 SPI_MISO SD_DATA1 SPI_MOSI SD_DATA2 SPI_CS SD_DATA3 FLASH_LED1 GND FLASH_LED1 SD_LDO9E GND SD_LDO9E 31 / 62 Smart Module Series 162 GND 162 PWRKEY 163 VBAT 163 SD_LDO6E 164 PCIE_RST_N 164 RESET_N 165 VBAT 165 SBU_SW_SEL 166 PCIE_WAKE_N 166 KEY_VOL_DOWN 167 VBAT 167 SBU_SW_OE 168 PCIE_CLK_REQ 168 KEY_VOL_UP 169 GND 169 GND 170 GND 170 GND 171 NC 171 NC 172 NC 172 NC LCM Interfaces 4.3.1. Main/Secondary LCM Interfaces The Smart 5G EVB provides two LCM interfaces and can be equipped with two LCDs for dual display function. Currently the Smart 5G EVB provides two 5-inch 1280 × 720 HD LCDs (4-lane MIPI DSI for each LCD) for testing purpose. Table 8: LCM Interfaces RefDes. J0501 J0502 Description Connector for main LCM Connector for secondary LCM Smart_5G_EVB_User_Guide 32 / 62 Smart Module Series The following figure shows a schematic design for main LCM interface of the Smart 5G EVB. LCD0_TE LCD0_ RST ADC D SI0_ LN3_P D SI0_ LN3_N D SI0_ LN2_P DSI0_LN2_N D SI0_ LN1_P D SI0_ LN1_N D SI0_ LN0_P D SI0_ LN0_N DSI0_ CLK_P DSI0_ CLK_N Module LCM0_LED+ LCM0_LED- LDO8A_2V8 LDO14A_1V8 C1 C2 C3 4.7uF 100nF 1uF FL1 1 3 6 5 2 4 1 3 FL2 6 5 2 4 1 3 FL3 6 5 2 4 FL4 1 3 6 5 2 4 FL5 1 3 6 5 2 4 EMI filter J0501 1 LEDA 2 NC 3 LEDK 4 NC 5 LPTE 6 RESET 7 LCD_ID 8 NC (SDA-TP) 9 NC (SCL-TP) 10 NC (RST-TP) 11 NC (EINT-TP) 12 GND 13 VIO18 14 VCC28 15 NC (VTP-TP) 16 GND 17 MIPI_TDP3 18 MIPI_ TDN3 19 GND 20 MIPI_ TDP2 21 MIPI_ TDN2 22 GND 23 MIPI_ TDP1 24 MIPI_ TDN1 25 GND 26 MIPI_ TDP0 27 MIPI_ TDN0 28 GND 29 MIPI_ TCP 30 MIPI_ TCN 31 GND 32 GND 33 GND 34 GND LCM Figure 16: Schematic Design for Main LCM Interface Smart_5G_EVB_User_Guide 33 / 62 Smart Module Series The following figure shows a schematic design for secondary LCM interface of the Smart 5G EVB. LCD1_TE LCD1_RST DSI1_LN3_P DSI1_LN3_N DSI1_LN2_P DSI1_LN2_N DSI1_LN1_P DSI1_LN1_N DSI1_LN0_P DSI1_LN0_N DSI1_CLK_P DSI1_CLK_N Module LCM1_LED+ LCM1_LED- 1 2 1 2 1 2 1 2 1 2 5 5 5 5 5 LDO8A_2V8 LDO14A_1V8 6 6 6 6 6 FL1 3 4 3 FL2 4 3 FL3 4 FL4 3 4 FL5 3 4 EMI filter C1 C2 4.7 uF 100nF J0502 1 LEDA 2 NC 3 LEDK 4 NC 5 LPTE 6 RESET 7 LCD_ID 8 NC (SDA-TP) 9 NC (SCL-TP) C3 10 NC (RST-TP) 1 uF 11 NC (EINT-TP) 12 GND 13 VIO18 14 VCC28 15 NC (VTP-TP) 16 GND 17 MIPI_TDP3 18 MIPI_TDN3 19 GND 20 MIPI_TDP2 21 MIPI_TDN2 22 GND 23 MIPI_TDP1 24 MIPI_TDN1 25 GND 26 MIPI_TDP0 27 MIPI_TDN0 28 GND 29 MIPI_TCP 30 MIPI_TCN 31 GND 32 GND 33 GND 34 GND LCM Figure 17: Schematic Design for Secondary LCM Interface The following figure shows the pin assignment of LCM connector. Figure 18: Pin Assignment of LCM Connector Smart_5G_EVB_User_Guide 34 / 62 Smart Module Series 4.3.2. Backlight Driver for LCM Interfaces The Smart 5G EVB uses a PWM dimming step-up LED driver for the WLED backlighting of LCM interfaces. The following figure shows a schematic design for the backlight driver. VPH_PWR PWM ModuleGND C1 2.2 μF Backlight Driver LCM_LED+ LCM_LED- Figure 19: Schematic Design for Backlight Driver Touch Panel Interfaces The Smart 5G EVB provides two touch panel interfaces: Table 9: Touch Panel Interfaces RefDes. J0503 J0504 Description ⚫ ZIF connector for main touch panel ⚫ Used for the connection between touch panel interfaces of main LCM and EVB ⚫ ZIF connector for secondary touch panel ⚫ Used for the connection between touch panel interfaces of secondary LCM and EVB Smart_5G_EVB_User_Guide 35 / 62 Smart Module Series The following figure shows a schematic design for touch panel interfaces. LDO11A _1V8 LDO6A_3V0 TP_I2C_ SDA TP_I2C_ SCL TP_ RST TP_ INT Module R1 2.2K R2 2.2K D1 D2 D3 D4 C1 C2 D5 4.7 uF 100nF 1 TP_SDA 2 TP_SCL 3 TP_RST 4 TP_INT 5 GND 6 VDD TP Figure 20: Schematic Design for Touch Panel Interfaces The following figure shows the pin assignment of touch panel connectors, and the following table shows the pin definition of touch panel connectors. 6 1 J0503 6 1 J0504 Figure 21: Pin Assignment of Touch Panel Connectors Table 10: Pin Definition of Touch Panel Connectors Pin No. 1 2 3 4 5 6 Pin Name TP_SDA TP_SCL TP_RST TP_INT GND VDD Description I2C data signal of touch panel I2C clock signal of touch panel Reset signal of touch panel Interrupt signal of touch panel Ground power supply for touch panel VDD power Comment Active low Smart_5G_EVB_User_Guide 36 / 62 Smart Module Series Camera Interfaces Smart 5G EVB provides five camera interfaces (4-lane + 4-lane + 4-lane + 2-lane + 1-lane). ⚫ Camera1–3 use 16 MP digital CMOS sensors. ⚫ Camera4 uses 8 MP CMOS sensor. ⚫ Camera5 uses 2 MP CMOS sensor. The following figure shows a schematic design for camera interfaces. 1 μF 1 μF 100 nF 2.2K 2.2 μF 100 nF 1 μF 100 nF CAM0_RST CAM0_PWDN CAM0_MCLK CCI_I2C_SDA0 CCI_I2C_SCL0 CSI0_LN3_P CSI0_LN3_N CSI0_LN2_P CSI0_LN2_N CSI0_LN1_P CSI0_LN1_N CSI0_LN0_P CSI0_LN0_N CSI0_CLK_P CSI0_CLK_N CCI_I2C_SDA2 CCI_I2C_SCL2 CAM3_RST CAM3_PWDN CAM3_MCLK CSI3_LN3_P CSI3_LN3_N CSI3_LN2_P CSI3_LN2_N CSI3_LN1_P CSI3_LN1_N CSI3_LN0_P CSI3_LN0_N CSI3_CLK_P CSI3_CLK_N CAM1_RST CAM1_PWDN CAM1_MCLK CSI1_LN3_P CSI1_LN3_N CSI1_LN2_P CSI1_LN2_N CSI1_LN1_P CSI1_LN1_N CSI1_LN0_P CSI1_LN0_N CSI1_CLK_P CSI1_CLK_N CCI_I2C_SDA1 CCI_I2C_SCL1 VREG_L5P_2P8 VREG_L4P_2P9 VREG_L2P_1P1 VREG_L6P_1P8 EMI EMI EMI EMI EMI 2.2K 2.2K VREG_L3P_2P8 VREG_L1P_1P05 EMI EMI EMI EMI EMI VREG_L7P_2P8 EMI EMI EMI EMI EMI Smart_5G_EVB_User_Guide 100nF 1μF 100 nF 1 μF 2.2 μF 100 nF 2.2K AFVDD AVDD DVDD DOVDD AVDD DVDD DOVDD AVDD DVDD DOVDD 2.2K 2.2K Camera 3 Camera 2 Camera 1 37 / 62 Smart Module Series 1 μF 1 μF 100 nF 2.2K 2.2 μF 100 nF 1 μF 100 nF CAM2_RST CAM2_PWDN CAM2_MCLK CCI_I2C_SDA1 CCI_I2C_SCL1 CSI2_LN1_P CSI2_LN1_N CSI2_LN0_P CSI2_LN0_N CSI2_CLK_P CSI2_CLK_N GPIO_X GPIO_X GPIO_X CSI2_LN3_P CSI2_LN3_N CSI2_LN2_P CSI2_LN2_N VREG_L5P_2P8 VREG_L7P_2P8 VREG_L1P_1P05 VREG_L6P_1P8 EMI EMI EMI VREG_L7P_2P8 VREG_L6P_1P8 EMI EMI 100 nF 1 μF 2.2 μF 100 nF 2.2K Camera 5 Camera 4 AFVDD AVDD DVDD DOVDD AVDD DVDD DOVDD I2C Figure 22: Schematic Design for Camera1–5 Interfaces The following figure shows the camera interfaces with cameras assembled. Figure 23: Camera Interfaces with Cameras Assembled Smart_5G_EVB_User_Guide 38 / 62 Smart Module Series USB Interfaces The Smart 5G EVB provides two USB interfaces: Micro USB interface and Type-C interface. ⚫ Used for AT command communication, data transmission, software debugging and firmware upgrade. ⚫ The Type-C interface complies with USB 3.1 (Gen 1)/2.0 specifications and supports super speed (5 Gbps) on USB 3.1 (Gen 1), high speed (480 Mbps) and full speed (12 Mbps) modes on USB 2.0. ⚫ The Micro USB interface complies with USB 2.0 specifications and supports high speed (480 Mbps) and full speed (12 Mbps) modes. Table 11: USB Interfaces RefDes. J1001 J1002 Description Micro USB connector USB Type-C connector The following figures show schematic designs for USB interfaces. USB_VBUS2 USB2_DM USB2_DP USB_CC1 USB_CC2 Modu le USB_PHY_PS SS_DIR_OUT 0R USB _SS1_RX_P USB _SS1_RX_M USB _SS1_TX_P USB _SS1_TX_M USB _SS2_RX_P USB _SS2_RX_M USB _SS2_TX_P USB _ SS2_ TX_M USB_OPTION C6 330nF C7 330nF C8 220nF C9 220nF C10 330nF C11 330nF C12 220nF C13 220nF USB Type-C VBUS DD+ CC1 CC2 RX1+ RX1TX1+ TX1RX2+ RX2TX2+ TX2- 220K 22 0K 220K 22 0K Figure 24: Schematic Design for USB Type-C Interface Smart_5G_EVB_User_Guide 39 / 62 USB_VBUS1 USB1_DM USB1_DP ID Modu le Smart Module Series Micro USB VBUS DD+ ID GND Figure 25: Schematic Design for Micro USB Interface NOTE The Micro USB connector on Smart 5G EVB is only used for modules supporting second USB interface. Audio Interfaces Smart 5G EVB provides three analog audio outputs including one mono loudspeaker differential amplifier output, one mono earpiece differential output, and one stereo headphone output for headset. It also provides three analog audio inputs including one single-ended microphone input for headset and two differential microphone inputs for microphones. Additionally, two DMIC interfaces are provided for digital microphones. Smart_5G_EVB_User_Guide 40 / 62 Smart Module Series 4.7.1. Loudspeaker Interface Smart 5G EVB provides one loudspeaker interface and the loudspeaker is soldered onto the Smart 5G EVB via test point J0801. The following figure shows a schematic design for loudspeaker interface. Modul e I2S Codec ES8388 PA SPK_P 1.0 nF FB ESD SPK_N Close to speaker FB 1.0 nF J0801 ESD Figure 26: Schematic Design for Loudspeaker Interface 4.7.2. Earpiece Interface Smart 5G EVB provides one earpiece interface and the earpiece is soldered onto the Smart 5G EVB via test point J0802. The following figure shows a schematic design for earpiece interface. Codec ES8388 FB EAR_P I2S Module EAR_N 33 pF ESD Earpiece 100 pF ESD 33 pF J0802 Figure 27: Schematic Design for Earpiece Interface Smart_5G_EVB_User_Guide 41 / 62 4.7.3. Headset Interface The following figure shows a schematic design for headset interface. Smart Module Series F1 MIC2_P 6 1 3 I2S HPH_R R1 33R F2 5 Module HPH_L R2 F3 33R F4 2 4 HPH_REF DET Codec ES8388 C3 C4 C5 D1 D2 D3 D4 33 pF 33 pF 33 pF ESD Figure 28: Schematic Design for Headset Interface The following figure shows the pin assignment of headset audio jack. Figure 29: Pin Assignment of Headset Audio Jack Smart_5G_EVB_User_Guide 42 / 62 The following table shows the pin definition of headset audio jack. Smart Module Series Table 12: Pin Definition of Headset Audio Jack Pin No. 1 2 3 4 5 6 Pin Name MIC GND R-AUDIO DETECT L-AUDIO GND Description Microphone input (+) Dedicated GND for headset Headphone right channel Headset detection Headphone left channel Ground The following figure shows the sketch design of audio plug for the audio jack on Smart 5G EVB. HS_DET 5 4 3 2 GND 1 SW HPH_R 32 Ω MIC HPH_L 32 Ω Figure 30: Sketch Design of Audio Plug 4.7.4. Microphone Interfaces Smart 5G EVB provides two analog differential microphone inputs for ECM-type microphone and MEMStype microphone respectively. The following figures show a schematic design for analog microphone interfaces, as well as the ECM-type and MEMS-type microphones on the board. Smart_5G_EVB_User_Guide 43 / 62 Module Smart Module Series MIC1_P MIC1_N I2S MIC_BIAS1 MIC3_N MIC3 _P Codec ES8388 U0801 B1 C1 2 MIC_P B2 100pF 1 MIC_N 2C D1 ECM B1 100nF C3 C4 100nF 1 U0802 2 VDD GND 3 GND OUT 4 C5 33pF C2 D1 C1 MEMS 150pF 100nF Figure 31: Schematic Design for Analog Microphone Interfaces Figure 32: ECM-Type and MEMS-Type Microphones Smart_5G_EVB_User_Guide 44 / 62 Smart 5G EVB also provides two DMIC interfaces for digital microphones. Smart Module Series LDO14A_1V8 LPI_DMIC1_CLK LPI_DMIC1_DATA 100nF VDD GND 10K CLK L/R DATA GND NM_10K NM_10K Module LPI_DMIC2_CLK LPI_DMIC2_DATA 100nF VDD GND 10K CLK L/R DATA GND NM_10K NM_10K Figure 33: Schematic Design for DMIC Interfaces (U)SIM Card Interfaces The Smart 5G EVB provides two push-push type (U)SIM card (1.8/2.95 V) connectors: (U)SIM1 card connector and (U)SIM2 card connector. Table 13: (U)SIM Card Interfaces RefDes. J0602 J0603 Description (U)SIM1 card connector (U)SIM2 card connector Smart_5G_EVB_User_Guide 45 / 62 Smart Module Series LDO11A_1V8 R1 100K USIM_ VDD USIM_ RST R3 Module USIM_ CLK R4 USIM_ DET USIM_ DATA R5 USIM_ VDD R2 10K 22R 22R 22R C2 C3 C4 22pF 22pF 22pF C1 (U)SIM Card Connector 100nF C1 VCC GND C5 C2 RST C3 CLK CD2 GND VPP C6 IO C7 GND CD1 D1 ESD Figure 34: Schematic Design for (U)SIM Card Interfaces The following figure shows the pin assignment of (U)SIM card connectors (J0602/J0603): (U)SIM2 Card Connector CD1 CD2 (U)SIM1 Card Connector J0603 C7 C6 C5 C3 C2 C1 J0602 Figure 35: Pin Assignment of (U)SIM Card Connectors Table 14: Pin Definition of (U)SIM Card Connectors Pin No. C1 C2 Pin Name VCC RST I/O (from Module’s Direction) PO DO Function (U)SIM card power supply (U)SIM card reset signal Smart_5G_EVB_User_Guide 46 / 62 C3 C5 C6 C7 CD1 CD2 CLK DO GND - VPP - IO DIO GND - USIM_PRESENCE DI Smart Module Series (U)SIM card clock signal Ground Not connected (U)SIM card data signal (U)SIM card detection (U)SIM card detection UART & Debug Interfaces Smart 5G EVB provides a UART interface and a debug interface. The main UART can be used for data transmission and AT command communication and the debug interface is used for debugging. Table 15: UART Interfaces RefDes. J0901 J0902 Description Main UART Debug Interface (Type-C connector) The following figure shows the circuit design of debug interface on Smart 5G EVB. DBG_RXD DBG_TXD Modu le VBUS UART_TX D- UART_RX D+ XR21B1411IL116 Type-C VBUS DD+ Figure 36: Debug Interface Circuit Smart_5G_EVB_User_Guide 47 / 62 Smart Module Series The following figure shows the RS-232 level match circuit of main UART on Smart 5G EVB. UART_TXD UART_RTS UART_RXD UART_CTS GND Module 1.8V OE VCCA TXD_1.8V RTS_1.8V VCCB TXD_3.3V RTS_3.3V 3.3V RXD_1.8V CTS_1.8V RXD_3.3V CTS_3.3V GND 3.3V TXS0104 EPWR VCC DIN 1 DIN 2 DIN 3 DIN 4 DIN 5 R1OUTB ROUT 1 ROUT 2 ROUT 3 GND DOUT1 DOUT2 DOUT3 DOUT4 DOUT5 R IN 1 R IN 2 R IN 3 FORCEON /FORCEOFF /INVALID SN65C 3238 GND TXD RTS RXD CTS DB9 Figure 37: RS-232 Level Match Circuit The following figure shows the pin assignment of main UART DB9 connector (J0901): Figure 38: Pin Assignment of Main UART Connector Table 16: Pin Definition of Main UART Connector Pin No. Pin Name I/O 2 RS232_TXD DO 3 RS232_RXD DI 5 RS232_GND - 7 RS232_CTS DI 8 RS232_RTS DO Description Transmit data Receive data Ground Clear to send Request to send Smart_5G_EVB_User_Guide 48 / 62 Smart Module Series SD Card Interface Smart 5G EVB provides an SD card interface J0601 for you to test the module’s SD card interface. The following figure shows the schematic design for SD card interface on Smart 5G EVB. SD_DATA2 SD_DATA3 SD_CMD SD_CLK SD_DATA0 SD_DATA1 SD_DET Module LDO11A_1V8 SD_PU_VDD SD_VDD R7 R8 R9 R10 R11 R12 R13 R1 120K 33R 33R 33R 33R 33R 33R 1K R2 R3 R4 R5 R6 NM_51K NM_51K NM_10K NM_51K NM_51K D1 D2 D3 D4 D5 D6 D7 C1 C2 D8 4.7uF 33pF 1 P1-DAT2 2 P2-CD/DAT3 3 P3-CMD 4 P4-VDD 5 P5-CLK 6 P6-VSS 7 P7-DAT0 8 P8-DAT1 9 DETECTIVE 10 GND 11 GND 12 GND 13 GND SD Card Connector Figure 39: Schematic Design for SD Card Interface 9 8 7654321 Figure 40: Pin Assignment of SD Card Connector Smart_5G_EVB_User_Guide 49 / 62 Smart Module Series Flashlight Smart 5G EVB provides one LED flashlight D0302 for testing the module’s flashlight interface which supports flash mode and torch mode. The following figures show a schematic design for flashlight and its location on the board. FLASH_LED D0302 Module Figure 41: Schematic Design for Flashlight Interface Figure 42: Flashlight Smart_5G_EVB_User_Guide 50 / 62 Smart Module Series Sensors Smart 5G EVB provides sensors TE-A for testing purpose, as shown in the figure below. ALS/PS Accel/Gyro Figure 43: Sensors Ethernet Interface Smart 5G EVB provides an Ethernet interface which supports LAN. Table 17: Ethernet Interface RefDes. J1101 Description RJ45 connector, connected to PC with LAN cable Smart_5G_EVB_User_Guide 51 / 62 Smart Module Series The following figure shows the schematic design for Ethernet interface: J1101 LAN0_RJ45_D1P LAN0_RJ45_D1M LAN0_RJ45_D2P LAN0_RJ45_D2M LAN0_RJ45_D3P LAN0_RJ45_D3M LAN0_RJ45_D4P LAN0_RJ45_D4M S2 RJ45 Connector R1 75 R R2 75 R R3 75 R R4 75 R LAN0_RJ45_D1P LAN0_RJ45_D1M LAN0_RJ45_D2P LAN0_RJ45_D2M LAN0_RJ45_D3P LAN0_RJ45_D3M LAN0_RJ45_D4P LAN0_RJ45_D4M LAN0_D2_REC1 LAN0_D2_REC2 LAN0_D7_REC1 LAN0_D7_REC2 LAN0_MDI0P LAN0_MDI0N LAN0_MDI1P LAN0_MDI1N LAN0_MDI2P LAN0_MDI2N LAN0_MDI3P LAN0_MDI3N Transformer IC LAN0_MDI0P LAN0_MDI0N LAN0_MDI1P LAN0_MDI1N LAN0_MDI2P LAN0_MDI2N LAN0_MDI3P LAN0_MDI3N PCIE_RST PCIE_CLK_REQ PCIE_WAKE PCIE_RX_P PCIE_RX_M PCIE_REFCLK_P PCIE_REFCLK_P PCIE_TX_P PCIE_TX_M Ethernet IC Figure 44: Schematic Design for Ethernet Interface PCIE_RST PCIE_CLK_REQ PCIE_WAKE PCIE_RX_P PCIE_RX_M PCIE_REFCLK_P PCIE_REFCLK_P PCIE_TX_P PCIE_TX_M BTB Connector Figure 45: Ethernet Interface Emergency Download Interface Smart 5G EVB provides one emergency download switch USB_BOOT to force the module into download mode by pulling up USB_BOOT to 1.8 V before powering on the module. The following figures show a schematic design for the emergency download interface and its switch on the board. USB_BOOT Module S0305 LDO11A_1V8 R1 10K Figure 46: Schematic Design for Emergency Download Interface Smart_5G_EVB_User_Guide 52 / 62 Smart Module Series Figure 47: Emergency Download Switch Vibrator Smart 5G EVB provides an ERM-type vibrator for you to test the motor driver interface of the module. The following figures show a schematic design and the vibrator on the board. VIB_DRV_P 33pF Module VIB+ VIBGND Motor Figure 48: Schematic Design for Vibrator ERM-Type VIB- VIB+ Figure 49: ERM-Type Vibrator Smart_5G_EVB_User_Guide 53 / 62 Smart Module Series Buttons Smart 5G EVB provides four buttons (S0301, S0302, S0303 and S0304) including PWRKEY, RESET_N (reserved), VOL_UP and VOL_DOWN, as shown in the following figure. Figure 50: Buttons Table 18: Buttons RefDes. S0301 S0302 S0303 S0304 Items PWRKEY RESET_N VOL_UP VOL_DOWN Description Turn on/off the module Reserved Turn up the volume Turn down the volume VBAT Status Indicator There is one LED indicator (D0301) for VBAT on/off indication on Smart 5G EVB, as shown below. Figure 51: VBAT Status Indicator Smart_5G_EVB_User_Guide 54 / 62 Table 19: VBAT Status Indicator RefDes. D0301 Item VBAT Status Indicator Smart Module Series Description Indicates VBAT on/off of the module RF Antennas There are 13 antennas, including 8 cellular antennas, 4 Wi-Fi/Bluetooth antennas and 1 GNSS ceramic antenna. 4.18.1. Antenna Distribution and Definition See the following figure for antenna distribution. ANT6 ANT2 MH Band (MHB and Sub-6) ANT_GNSS ANT4 ANT0 Full Band (LMHB and Sub-6) Full Band (LMHB and Sub-6) ANT3 MH Band ANT7 (MHB and Sub-6) WIFI_ANT0 WIFI_ANT2 ANT1 Figure 52: Antenna Distribution ANT5 WIFI_ANT1 WIFI_ANT3 Smart_5G_EVB_User_Guide 55 / 62 Table 20: Antennas Antenna Name Antenna Type ANT0, ANT3 Cellular Antennas ANT1, ANT2, ANT4, ANT5, ANT6, ANT7 WIFI_ANT0–3 ANT_GNSS Cellular Antennas Wi-Fi/Bluetooth Antennas GNSS Antenna Smart Module Series Band Full Band (LMHB and Sub-6)： 699–960 MHz, 1710–2690 MHz, 3300–4200 MHz, 4400–5000 MHz MH Band (MHB and Sub-6)： 1710–2690 MHz, 3300–4200 MHz, 4400–5000 MHz 2.4/5 GHz L1/L5 4.18.2. Antenna Connection See the following figure for antenna connection. The RF connectors need to be matched one by one between TE-A and EVB. Figure 53: Antenna Connection Smart_5G_EVB_User_Guide 56 / 62 Smart Module Series 5 Operation Procedures This chapter introduces the basic operation procedures with the Smart 5G EVB. Turn On the Module To turn on the module, follow the steps below: 1. Connect the module TE-A to the B2B connectors (J0101 and J0102) on Smart 5G EVB. 2. If battery power is to be selected, mount a Li-polymer battery to the battery connector (J0202) and then switch S0201 to 'BATTERY' state. If 12 V DC power is to be selected, connect the 12 V power adapter to the power jack (J0201) and then switch S0201 to 'DC_POWER' state. Then D0301 indicator will light up. 3. Press S0301 (PWRKEY) for at least 1.6 s to turn on the module. When the utilized LCD(s) displays as below, it means the booting has been completed successfully. Figure 54: LCD Display Indicating Module’s Successful Power-on Smart_5G_EVB_User_Guide 57 / 62 Smart Module Series NOTE After the module’s VBAT power is provided, inserting USB into USB the interface can also turn on the module. Turn Off/Reboot the Module To turn off the module, follow the steps below: 1. Press S0301 (PWRKEY) for at least 3 s, and then the LCD will display a menu for selection: Figure 55: Menu to Select Whether to Continue Turn-off Operation 2. Choose 'Power off' option and then the module will be powered off normally. You can also press 'PWRKEY' for at least 8 s to reboot the module. Communication via USB Interface 1. Turn on the module according to the procedures mentioned in Chapter 5.1. 2. Connect Smart 5G EVB to PC with USB cable through USB interface and then run the USB flash drive on PC to install the USB driver and ADB driver. The loaded USB ports can be viewed through the PC Device Manager, as shown below. Smart_5G_EVB_User_Guide 58 / 62 Smart Module Series Figure 56: Loaded USB Ports 3. Open CMD tool: 'START' → 'All Programs' → 'Accessory' → 'Command Prompt'. 4. Use the adb shell command to make the module enter ADB mode. Then you can use USB ADB interface for test. Figure 57: adb shell Command NOTE 1. If you want to use HyperTerminal for test, then Qualcomm HS-USB Modem 9091 (or 90DB) can be used. 2. Qualcomm HS-USB Diagnostics 9091 (or 90DB) can be used for firmware upgrade. Communication via UART Interface 1. Connect the UART interface to the PC with USB to RS-232 converter cable or connect the debug interface (Type-C connector) to the PC with USB Type-C cable and then turn on the module according to the procedures mentioned in Chapter 5.1. After that, the USB Serial Port number can be viewed through the PC Device Manager, as shown below. Smart_5G_EVB_User_Guide 59 / 62 Smart Module Series Figure 58: USB Serial Port 2. Use the QCOM tool provided by Quectel to realize communication between the module and the PC. The following figure shows the QCOM configuration: select the correct 'COM Port' number corresponding to USB Serial Port and set the correct 'Baudrate' (such as 115200 bps). For more details about QCOM tool usage and configuration, see document [1]. Figure 59: QCOM Configuration Smart_5G_EVB_User_Guide 60 / 62 Smart Module Series 6 Appendix References Table 21: Related Document Document Name [1] Quectel_QCOM_User_Guide Table 22: Terms and Abbreviations Abbreviation ADB ALS CMOS CSI DSI ECM HD LCM LED LMHB MEMS MHB MIPI OTG PC Description Android Debug Bridge Ambient Light Sensor Complementary Metal Oxide Semiconductor Camera Serial Interface Display Serial Interface Electret Microphone High Definition Liquid Crystal Display Module Light Emitting Diode Low/Middle/High Band Micro-Electro-Mechanical System Middle/High Band Mobile Industry Processor Interface On-The-Go Personal Computer Smart_5G_EVB_User_Guide 61 / 62 PS PWM UART USB (U)SIM WLED ZIF Smart Module Series Proximity Sensor Pulse Width Modulation Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module White LED Zero Insertion Force Smart_5G_EVB_User_Guide 62 / 62

LC79H (AL) EVB 用户指导 GNSS 模块系列 版本：1.1 日期：2023-05-10 状态：受控文件 LC79H (AL) EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 33 LC79H (AL) EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 33 LC79H (AL) EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 请确保产品的使用符合国家和行业基础标准、安全标准和环境保护标准的要求，并符合 国家和特定场所对产品使用的具体规定。 请确保终端产品远离易燃易爆品。在极端供电和任何有潜在爆炸危险的（如靠近加油 站、油库、化工厂或爆炸作业场所）环境下使用电子产品可能存在安全隐患。 必须为产品提供稳定可靠的电源，并确保所有接线符合相关安全和防火法规。 在产品安装和使用过程中，必须小心处理以避免因为静电而对产品造成损坏。 上海移远通信技术股份有限公司 3 / 33 LC79H (AL) EVB 用户指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 LC79H (AL) EVB 用户指导 GNSS 模块系列 EVB 用户指导 受控文件 修订历史 版本 1.0 日期 2022-04-21 2022-07-20 1.1 2023-05-10 描述 文档创建 受控版本 1. 新增 GNSS 天线型号信息、删除 U 盘和说明书信息（第 2.1 章）。 2. 新增 1PPS 的 SMA 接口说明（图 3：和表 2）。 3. 新增 U410 测试点信息（图 3 和表 4）。 4. 删除使用 QCOM 工具进行通信的章节。 5. 更新固件升级工具为 QGNSS（第 4 章）。 6. 新增 EVB 及天线安装（第 5 章）。 7. 新增功耗测量指导（第 6 章）。 8. 新增 EVB 框架（第 7 章）。 9. 新增常见问题及故障排除（第 8 章）。 10. 新增注意事项（第 9 章）。 上海移远通信技术股份有限公司 4 / 33 LC79H (AL) EVB 用户指导 目录 安全须知 ....................................................................................................................................................... 3 关于文档 ....................................................................................................................................................... 4 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 简介 ....................................................................................................................................................... 8 2 概述 ....................................................................................................................................................... 9 2.1. EVB 套件 .................................................................................................................................... 9 2.2. EVB 套件连接示意图.................................................................................................................11 3 接口 ..................................................................................................................................................... 12 3.1. 位号分布图 ............................................................................................................................... 12 3.2. EVB 接口 .................................................................................................................................. 13 4 使用 QGNSS 工具进行测试和固件升级 .............................................................................................. 16 4.1. 使用 QGNSS 工具进行测试 ..................................................................................................... 16 4.2. 窗口界面说明............................................................................................................................ 18 4.3. 固件升级 ................................................................................................................................... 19 5 EVB 及天线安装.................................................................................................................................. 23 5.1. GNSS 天线安装........................................................................................................................ 23 5.2. EVB 安装 .................................................................................................................................. 23 6 功耗测量指导....................................................................................................................................... 24 6.1. 各阶段功耗 ............................................................................................................................... 24 6.2. VCC 功耗测量 .......................................................................................................................... 24 6.3. V_BCKP 功耗测量.................................................................................................................... 26 7 EVB 框架............................................................................................................................................. 28 8 常见问题及故障排除............................................................................................................................ 29 9 注意事项 .............................................................................................................................................. 30 10 附录 参考文档及术语缩写 ................................................................................................................... 31 上海移远通信技术股份有限公司 5 / 33 LC79H (AL) EVB 用户指导 表格索引 表 1：EVB 套件清单................................................................................................................................... 10 表 2：接口定义 ........................................................................................................................................... 13 表 3：U409 引脚描述 ................................................................................................................................. 14 表 4：U410 引脚描述 ................................................................................................................................. 15 表 5：QGNSS 窗口界面说明...................................................................................................................... 18 表 6：参考文档 ........................................................................................................................................... 31 表 7：术语缩写 ........................................................................................................................................... 31 上海移远通信技术股份有限公司 6 / 33 LC79H (AL) EVB 用户指导 图片索引 图 1：EVB 套件图......................................................................................................................................... 9 图 2：EVB 套件连接示意图 .........................................................................................................................11 图 3：EVB 位号分布图 ............................................................................................................................... 12 图 4：COM 端口和波特率设置 ................................................................................................................... 16 图 5：QGNSS 界面（已连接） .................................................................................................................. 17 图 6：工具启动 ........................................................................................................................................... 19 图 7：工具设置 ........................................................................................................................................... 20 图 8：固件选择 ........................................................................................................................................... 20 图 9：固件升级 - 1...................................................................................................................................... 21 图 10：固件升级 - 2.................................................................................................................................... 21 图 11：固件升级成功.................................................................................................................................. 22 图 12：各阶段功耗 ..................................................................................................................................... 24 图 13：用电流表测量 VCC 功耗................................................................................................................. 25 图 14：用耗流仪测量 VCC 功耗................................................................................................................. 25 图 15：用电流表测量 V_BCKP 功耗 .......................................................................................................... 26 图 16：用耗流仪测量 V_BCKP 功耗 .......................................................................................................... 27 图 17：EVB 框架 ........................................................................................................................................ 28 上海移远通信技术股份有限公司 7 / 33 LC79H (AL) EVB 用户指导 1 简介 移远通信提供一整套 LC79H (AL) EVB 配件，以方便 LC79H (AL)模块的测试和使用。本文档介绍了 LC79H (AL) EVB 套件及接口的基本信息，并提供了详细的 EVB 使用指导，主要包括如何使用软件工具 QGNSS 测试模块和固件升级、EVB 及天线安装、功耗测量指导、EVB 框架、常见问题及故障排除和注意 事项。 备注 QGNSS 工具可从移远通信技术支持处获取（support@quectel.com）。 上海移远通信技术股份有限公司 8 / 33 LC79H (AL) EVB 用户指导 2 概述 2.1. EVB 套件 EVB 套件包括：EVB 板、GNSS 有源天线、Type-B USB 连接线、铜柱和螺丝。 EVB 套件如下图所示，详情见表 1：EVB 套件清单。 Type-B USB连接线 EVB GNSS有源天线 铜柱和螺丝 图 1：EVB 套件图 上海移远通信技术股份有限公司 9 / 33 表 1：EVB 套件清单 项目 EVB USB 线 GNSS 有源天线 其它 描述 LC79H (AL)评估板 尺寸：80 mm × 120 mm Type-B USB 连接线 GNSS 有源天线（型号：YB0017AA） 天线尺寸：61.5 mm × 56.5 mm × 23 mm 线长：3000 mm 配件中的天线支持如下星系和频段：  GPS L1 C/A和L5  GLONASS L1  Galileo E1和E5a  BDS B1I和B2a  QZSS L1 C/A和L5  SBAS L1 铜柱和螺丝 LC79H (AL) EVB 用户指导 数量 1 2 1 4对 备注 有关 GNSS 有源天线详情，请联系移远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 10 / 33 2.2. EVB 套件连接示意图 EVB 套件连接示意图如下所示。 LC79H (AL) EVB 用户指导 备注 图 2：EVB 套件连接示意图 1. 客户可选择不使用 Type-B USB 线连接电脑和 EVB 的'POWER'接口（J204），详情请参考第 3.2 章 EVB 接口。 2. 将 GNSS 有源天线放置在可检测到卫星的户外开阔地带。 上海移远通信技术股份有限公司 11 / 33 LC79H (AL) EVB 用户指导 3 接口 3.1. 位号分布图 EVB 的器件位号分布图如下所示。 D514（POWER和VCC LED指示灯） D520（TXD和1PPS LED指示灯） S201（电源开关） J509（USB连接器） J204（POWER连接器） U409（测试点） 12 34 U410（测试点） 15 16 12 34 15 16 U103 （LC79H (AL) 模块） EVB版本号 S503（RESET按键） S502（WAKEUP按键） J103 （GNSS天线连接器） U512（1PPS连接器） 图 3：EVB 位号分布图 上海移远通信技术股份有限公司 12 / 33 LC79H (AL) EVB 用户指导 3.2. EVB 接口 EVB 接口如下表所示。 表 2：接口定义 功能 供电 接口 J204 POWER J509 USB 通信接口 SMA 连接器 D514 LED指示灯 信号指示 D520 LED指示灯 开关和按键 J509 USB J103 天线连接器 U512 1PPS连接器 POWER （绿色LED） VCC （红色LED） TXD （红色LED） 1PPS （绿色LED） S201 电源开关 S503 RESET按键 S502 WAKEUP按键 描述 J204：仅用于供电，避免J509供电不足。 J509：用于通信和供电。 供电输入：  直流电源：4.5~5.5 V，典型值：5.0 V。  电流负载能力应大于100 mA。 支 持RTCM语 句 、NMEA标 准 语 句 、PAIR/PQTM语 句、二进制数据和固件升级。 用于连接 GNSS 天线。 用于测试1PPS信号。 常亮：EVB 供电正常。 不亮：EVB 未供电。 常亮：模块供电正常。 不亮：模块未供电。 闪烁：UART TXD 有数据输出。 不亮或常亮：UART TXD无数据输出。 闪烁：定位成功，频率为1 Hz。 不亮：未定位。 控制EVB电源的通断。 短按按键后释放，模块复位。 短按按键后释放，将模块从Backup模式唤醒。 上海移远通信技术股份有限公司 13 / 33 U409 和 U410 测试点分布如下所示： LC79H (AL) EVB 用户指导 表 3：U409 引脚描述 测试点序号 测试点标签 测试点功能 I/O 描述 1 PIN1 GND - 地 2 PIN2 U103：引脚 2 DO TXD：发送数据 3 无标签 U103：引脚 3 DI RXD：接收数据 4 无标签 U103：引脚 4 DO 1PPS：一秒一个脉冲 5 无标签 - - 预留 6 无标签 U103：引脚 6 PI V_BCKP：模块备份域备份电源 7 无标签 - - 预留 8 无标签 U103：引脚 8 PI VCC：主电源 9 无标签 U103：引脚 9 DI RESET_N：复位模块 10 无标签 - - 地 11 无标签 - - 不连接 12 无标签 - - 地 13 无标签 U103：引脚 13 DI ANT_ON：控制外部 LNA 或有源天线供电 14 无标签 U103：引脚 14 PO VDD_RF：外部射频器件供电 15 PIN15 U103：引脚 15 - 预留 16 PIN16 U103：引脚 16 DIO I2C_SDA：I2C 串行数据 上海移远通信技术股份有限公司 14 / 33 表 4：U410 引脚描述 测试点序号 测试点标签 1 PIN17 2 PIN18 3 无标签 4 无标签 5 无标签 6 无标签 7 无标签 8 无标签 9 无标签 10 无标签 11 PIN27 12 PIN28 13 无标签 14 无标签 15 无标签 16 无标签 测试点功能 I/O U103：引脚 17 DI U103：引脚 18 DI - - - - U103：引脚 21 DO U103：引脚 22 DO U103：引脚 23 DO - - - - - - U103：引脚 27 - GND - - - - - - - - - LC79H (AL) EVB 用户指导 描述 I2C_SCL：I2C 串行时钟 WAKEUP：从 Backup 模式中唤醒 模块 预留 预留 GEOFENCE：地理围栏状态指示 JAM_IND：干扰指示 3D_FIX：3D 定位指示 预留 预留 预留 预留 地 不连接 不连接 不连接 不连接 备注 1. U409 和 U410 测试点序号如图 3：EVB 位号分布图中红色字体所示。 2. U409 和 U410 测试点对应模块相应引脚功能，详情请见文档 [1] hardware design。 上海移远通信技术股份有限公司 15 / 33 LC79H (AL) EVB 用户指导 4 使用 QGNSS 工具进行测试和固件升级 本章节介绍了如何使用软件工具 QGNSS 验证模块的状态以及进行固件升级。有关 QGNSS 工具的使 用详情，请参考文档 [2] QGNSS user guide。 4.1. 使用 QGNSS 工具进行测试 步骤 1：将配件连接至EVB。 步骤 2：将 EVB 通过'POWER'和'USB'接口用两根 Type-B USB 线连接至电脑，或通过'USB' 接口用一根 Type-B USB 线连接到电脑，再将电源开关（S201）拨至'ON'状态，给 EVB 上 电。 步 骤 3： 打 开QGNSS工 具 。 点 击 'Device' 和 'Serial Device Information'（ 默 认 波 特 率 ： 115200 bps 1）。 图 4：COM 端口和波特率设置 步骤 4：点击 'Connect or disconnect'按钮。成功连接模块之后，QGNSS界面如下图所示。 1 UART 接口默认波特率设置可能因软件版本不同而不同。 上海移远通信技术股份有限公司 16 / 33 LC79H (AL) EVB 用户指导 图 5：QGNSS 界面（已连接） 备注 首次使用 QGNSS 工具时，需确保已安装 CP210x 驱动。有关驱动详情，请联系移远通信技术支持 （support@quectel.com）。 上海移远通信技术股份有限公司 17 / 33 LC79H (AL) EVB 用户指导 4.2. 窗口界面说明 在 QGNSS 界面中可以查看 GNSS 信息，例如 C/N0 信息、时间、位置、速度和精度等。有关这些参 数的更多信息，请参考下表。 表 5：QGNSS 窗口界面说明 图标 说明 此天空视图界面显示正在被追踪的卫星信息。 1) 左侧图标显示正在被追踪的卫星及其数量。  BDS：15  GLO（GLONASS）：6  GPS：13  GAL（Galileo）：5  QZSS：0  NavIC：0  SBAS：0 2) 右侧的天空视图显示了正在被追踪中的卫星方位。 GPS 卫星 BDS 卫星 GLONASS 卫星 Galileo 卫星 QZSS 卫星 NavIC 卫星  PRN 30 的 C/N0 值是 39 dB-Hz。  亮红色柱表示卫星的导航数据正在使用中。  PRN 1 的 C/N0 值是 21 dB-Hz。  浅红色柱表示该卫星的导航数据未被使用。 上海移远通信技术股份有限公司 18 / 33 图标 LC79H (AL) EVB 用户指导 说明  经度（单位：°）  纬度（单位：°）  平均海拔高度（MSL，单位：m）  接收机速度（单位：km/h）  水平精度因子（HDOP）  位置精度因子（PDOP）  定位模式：2D、3D  质 量 指 标 ： 包 含 DGNSS、DGPS、GPS SPS、RTK 浮 点 （Float RTK）和 RTK 固定（Fixed RTK）模式  日期：UTC 日期  时间：UTC 时间  总次数  定位点  RTK 固定解  RTK 浮点解  GPS 差分数据时间  TTFF（单位：s）  2D 定位精度（单位：m）  3D 定位精度（单位：m） 4.3. 固件升级 固件升级前，需要保证 EVB 已上电，详情可参考第 4.1 章 使用 QGNSS 工具进行测试。 固件升级详细步骤如下： 步骤 1：打开 QGNSS 工具，点击'Tools'，并在下拉框中选择'Firmware Download'。 ① 图 6：工具启动 步骤 2：在打开的'Settings'下拉框中选择 'Download Baudrate'（921600 bps 或 115200 bps）。 上海移远通信技术股份有限公司 19 / 33 LC79H (AL) EVB 用户指导 ② 图 7：工具设置 步骤 3：点击 'Open Config File'按钮，选择相应的 Config 文件，例如'flash_download.cfg'。 ③ 图 8：固件选择 步骤 4：点击 'Run'按钮，待进度条提示复位模块后短按复位按键，开始下载固件。 上海移远通信技术股份有限公司 20 / 33 LC79H (AL) EVB 用户指导 ④ 图 9：固件升级（1） ⑤ 图 10：固件升级（2） 步骤 5：固件升级成功时，QGNSS 工具界面上将显示一个进度为'100 %'的进度条。 上海移远通信技术股份有限公司 21 / 33 LC79H (AL) EVB 用户指导 图 11：固件升级成功 上海移远通信技术股份有限公司 22 / 33 LC79H (AL) EVB 用户指导 5 EVB 及天线安装 5.1. GNSS 天线安装 天线安装的周围环境会影响天线的接收性能和可见卫星，从而影响 GNSS 接收机的定位性能。此外， 天线的位置和方向也会影响接收性能，故应当选择远离障碍物和干扰的位置进行安装。陶瓷贴片天线须水 平放置，保证天线辐射面朝向天空。 如果需要动态场景测试，安装天线时，应保证天线牢固地附着在测试设备上，避免与被测设备产生任 何相对运动或震动。 5.2. EVB 安装 如果需要动态场景测试，必须保证 EVB 牢固地附着在测试设备上，避免与测试设备之间产生任何相对 运动或震动。 上海移远通信技术股份有限公司 23 / 33 LC79H (AL) EVB 用户指导 6 功耗测量指导 6.1. 各阶段功耗 测量模块功耗时，将功耗分为三个阶段，分别为捕获和跟踪（包含历书下载）、跟踪（历书下载结束） 及进入 Backup 模式。  捕获和跟踪（包含历书下载）：0 s~12.5 min  跟踪（历书下载结束）：12.5 min 之后  进入 Backup 模式 电流 12.5 min 进入Backup模式 VCC 捕获和跟踪 （包含历书下载束） 跟踪 （历书下载结束） V_BCKP 0 12.5 min 时间 图 12：各阶段功耗 6.2. VCC 功耗测量 测量功耗之前，需将配件连接至 EVB，保证模块可以正常通信及定位，详情可参考第 4.1 章 使用 QGNSS 工具进行测试。 使用电流表测量 VCC 功耗的详细步骤： 步骤 1： 关闭电源开关（S201），拔出VCC_MODULE（J102）跳线帽，将电流表串联至J102排针两 端，如下所示。 步骤 2： 打开电源开关（S201），读取电流表读数。 上海移远通信技术股份有限公司 24 / 33 电流表 LC79H (AL) EVB 用户指导 图 13：用电流表测量 VCC 功耗 使用耗流仪测量VCC功耗的详细步骤： 步骤 1： 关闭电源开关（S201），拔出VCC_MODULE（J102）跳线帽后，需将耗流仪正极连接至 J102的引脚2（无箭头丝印），负极连接至GND，如下图所示。 步骤 2： 打开电源开关（S201），读取耗流仪读数。 耗流仪 GND VCC 图 14：用耗流仪测量 VCC 功耗 上海移远通信技术股份有限公司 25 / 33 LC79H (AL) EVB 用户指导 6.3. V_BCKP 功耗测量 功耗测量之前，需将配件连接至 EVB，保证模块可以正常通信及定位，详情可参考第 4.1 章 使用 QGNSS 工具进行测试。 使用电流表测量 V_BCKP 功耗的详细步骤： 步骤 1： 关闭电源开关（S201），拔出V_BCKP（J205）跳线帽，将电流表串联至J205排针两端。 步骤 2：打开电源开关（S201），读取电流表读数。 电流表 图15：用电流表测量V_BCKP功耗 使用耗流仪测量V_BCKP功耗的详细步骤： 步骤 1： 关闭电源开关（S201），拔出V_BCKP（J205）跳线帽后，需将耗流仪正极连接至J205的引 脚1（有箭头丝印），负极连接至GND，如下图所示。 步骤 2： 打开电源开关（S201），读取耗流仪读数。 上海移远通信技术股份有限公司 26 / 33 耗流仪 GND V_BCKP LC79H (AL) EVB 用户指导 图16：用耗流仪测量V_BCKP功耗 备注 1. 使用耗流仪测耗流时，请注意调整电流的分辨率。 2. 功率值可根据以下公式计算：P = VSupply × ITest。 3. 如 需 测 量 Backup 模 式 下 的 V_BCKP 耗 流 ， 请 确 保 模 块 已 进 入 Backup 模 式 ， 然 后 拔 掉 VCC_MODULE（J102）的跳线帽，断开 VCC 供电。关于进入/退出 Backup 模式的方式，详情请 见文档 [1] hardware design。 上海移远通信技术股份有限公司 27 / 33 LC79H (AL) EVB 用户指导 7 EVB 框架 通过 Type-B 给 EVB 供电，再通过低压差线性稳压器（LDO）给 GNSS 模块供电。GNSS 模块通过 USB 转 UART 芯片（CP2102N）从 EVB 的通信接口输出信号。搭配 EVB 的天线接口和控制按钮，用户 可以使用 GNSS 模块的完整功能，包括调试功能。 LDO 1.8 V 天线 接口 按键 按键 VCC V_BCKP 复位 唤醒 模块 测试点 LDO 3.3 V LDO 1.8 V USB转串口芯片 CP2102N 电源 Type-B 接口 Type-B 接口 图 17：EVB 框架 上海移远通信技术股份有限公司 28 / 33 LC79H (AL) EVB 用户指导 8 常见问题及故障排除 1. 将 EVB 通过 USB 线连接到 PC 后，设备管理器中未找到 COM 口。  查看 EVB 上的通信接口是否成功与 PC 连接；  查看 CP210x 驱动是否安装成功。 2. 串口不输出任何语句或命令。  查看 EVB 上的电源指示灯是否正常；  查看跳线帽是否按照图 1：EVB 套件图正确连接；  查看模块供电是否正常。 3. 无法搜到卫星信号。  若室内没有转发装置，则需要在开阔且四周无遮挡的环境中进行测试。 4. 固件升级失败。  确认模块是否进入了正常工作模式；  查看烧录的固件是否正确。  检查串口选择是否正确。 备注 如出现无法解决的问题，可联系移远通信技术支持进行解决（support@quectel.com）。 上海移远通信技术股份有限公司 29 / 33 LC79H (AL) EVB 用户指导 9 注意事项  对比不同 GNSS 模块参数时，注意在相同的环境下进行测量。  不同的芯片厂商对应冷启动、捕获、追踪等参数可能有不同的定义，请注意进行区别。  确认测量方法正确的情况下，若仍存在基于 EVB 测量的参数与所提供的参数相差过大，请联系移 远通信技术支持。  请注意有些实测获得的瞬时数据不能作为最终的参考数据，卫星会在不同的时间点到达不同的位 置，且环境、温度、湿度、海拔均可能会影响数据测量。  QGNSS 工具可能因 bug 修复、性能提升等进行版本更新，请尽量使用该工具的最新版本。 上海移远通信技术股份有限公司 30 / 33 LC79H (AL) EVB 用户指导 10 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_LC79H(AL)_Hardware_Design [2] Quectel_QGNSS_User_Guide 表 7：术语缩写 缩写 2D 3D BDS C/N0 CEP COM Port DC DI DO ECEF ESD EVB Galileo GLONASS 英文全称 中文全称 2 Dimension 2维 3 Dimension 3维 BeiDou Navigation Satellite System 北斗导航卫星系统 Carrier-to-Noise Ratio 载噪比 Circular Error Probable 圆误差概率 Communication Port 通信串口 Direct Current 直流 Digital Input 数字输入 Digital Output 数字输出 Earth-Centered, Earth-Fixed 地心地固坐标系 Electrostatic Discharge 静电放电 Evaluation Board 评估板 Galileo Satellite Navigation System (EU) 伽利略卫星导航系统（欧盟） Global Navigation Satellite System 全球导航卫星系统（俄罗斯） 上海移远通信技术股份有限公司 31 / 33 缩写 GND GNSS GPS HDOP I2C I/O NavIC LED LLA MSL NMEA PC PCB PDOP PI PO 1PPS PRN QZSS RF RTK RXD SBAS LC79H (AL) EVB 用户指导 英文全称 (Russia) Ground Global Navigation Satellite System Global Positioning System Horizontal Dilution of Precision Inter-Integrated Circuit Input/Output Indian Regional Navigation Satellite System Light Emitting Diode Longitude, Latitude, and Altitude Mean Sea Level NMEA (National Marine Electronics Association) 0183 Interface Standard Personal Computer Printed Circuit Board Position Dilution of Precision Power Input Power Output One Pulse Per Second Pseudorandom Noise Quasi-Zenith Satellite System Radio Frequency Real-Time Kinematic Receive Data (Pin) Satellite-Based Augmentation System 中文全称 地 全球导航卫星系统 全球定位系统 水平精度因子 I2C 总线 输入/输出 印度区域性导航卫星系统 发光二极管 经度、纬度和海拔 平均海平面 NMEA（美国船舶电子协会）0183 接 口标准 个人电脑 印刷电路板 位置精度因子 输入电源 输出电源 一秒一个脉冲 伪随机噪声 日本准天顶卫星系统 无线电频率 实时动态载波相位差分技术 接收数据（引脚） 星基增强系统 上海移远通信技术股份有限公司 32 / 33 缩写 SDA SPS TTFF TXD UART USB UTC WGS84 英文全称 I2C Serial Data Standard Positioning Service Time to First Fix Transmit Data (Pin) Universal Asynchronous Receiver & Transmitter Universal Serial Bus Coordinated Universal Time World Geodetic System 1984 LC79H (AL) EVB 用户指导 中文全称 I2C 串行数据 标准定位服务 首次定位时间 传输数据（引脚） 通用异步收发器 通用串行总线 协调世界时 世界大地测量系统 上海移远通信技术股份有限公司 33 / 33

Smart EVB G5 User Guide Smart Module Series Version: 1.0 Date: 2022-01-18 Status: Released Smart Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. Smart_EVB_G5_User_Guide 1 / 66 Smart Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. Smart_EVB_G5_User_Guide 2 / 66 Smart Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal shall notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it shall be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergent help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. Smart_EVB_G5_User_Guide 3 / 66 Smart Module Series About the Document Revision History Version Date - 2022-01-14 1.0 2022-01-18 Author Mary SHEN Mary SHEN Description Creation of the document First official release Smart_EVB_G5_User_Guide 4 / 66 Smart Module Series Contents Safety Information...................................................................................................................................... 3 About the Document .................................................................................................................................. 4 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 7 Figure Index ................................................................................................................................................ 8 1 Introduction ....................................................................................................................................... 10 Applicable Modules .................................................................................................................. 10 Special Mark ............................................................................................................................ 10 2 Product Overview ............................................................................................................................. 11 Key Features.............................................................................................................................11 Top and Bottom Views ............................................................................................................. 13 Component Placement of Smart EVB G5 ............................................................................... 15 3 Smart EVB G5 Kit Accessories ....................................................................................................... 19 Accessories Assembly ............................................................................................................. 19 List of Accessories ................................................................................................................... 20 4 Interface Application ........................................................................................................................ 22 Power Supply ........................................................................................................................... 22 4.1.1. Adapter Interface........................................................................................................... 23 4.1.2. Battery Interface ............................................................................................................ 24 Smart TE-A Interface................................................................................................................ 25 LCM Interfaces......................................................................................................................... 34 4.3.1. Main LCM Interface....................................................................................................... 35 4.3.2. Secondary LCM Interface ............................................................................................. 36 4.3.3. Backlight Driver for Secondary LCM Interface ............................................................. 37 Touch Panel Interfaces ............................................................................................................ 38 Camera Interfaces.................................................................................................................... 39 USB Interfaces ......................................................................................................................... 41 Audio Interfaces ....................................................................................................................... 42 4.7.1. Loudspeaker Interface .................................................................................................. 43 4.7.2. Headset Interface.......................................................................................................... 44 4.7.3. Earphone Interface........................................................................................................ 45 4.7.4. Microphone Interfaces................................................................................................... 46 (U)SIM Card Interfaces ............................................................................................................ 47 UART Interfaces....................................................................................................................... 49 SD Card Interface .................................................................................................................... 51 Flashlights ................................................................................................................................ 53 Sensors .................................................................................................................................... 54 Emergency Download Interface............................................................................................... 54 Vibrator..................................................................................................................................... 55 Smart_EVB_G5_User_Guide 5 / 66 Smart Module Series Switches and Buttons .............................................................................................................. 56 Status Indicators ...................................................................................................................... 57 5 Operation Procedures ...................................................................................................................... 59 Turn On the Module ................................................................................................................. 59 Turn Off the Module ................................................................................................................. 60 Communication via USB .......................................................................................................... 61 Communication via UART Interface......................................................................................... 62 Firmware Upgrade ................................................................................................................... 63 6 Appendix References ....................................................................................................................... 65 Smart_EVB_G5_User_Guide 6 / 66 Smart Module Series Table Index Table 1: Applicable Modules .............................................................................................................................. 10 Table 2: Special Mark ........................................................................................................................................ 10 Table 3: Key Features.........................................................................................................................................11 Table 3: Components & Functions of Smart EVB G5 ........................................................................................ 16 Table 5: Accessories List ................................................................................................................................... 20 Table 6: Description of Power Supply................................................................................................................ 22 Table 7: Pin Definition of Battery Interface ........................................................................................................ 25 Table 8: Description of Smart TE-A Interface .................................................................................................... 25 Table 9: Pin Definition of B2B Connector J0101 ............................................................................................... 27 Table 10: Pin Definition of B2B Connector J0102 ............................................................................................. 30 Table 11: Description of LCM Interfaces ............................................................................................................ 34 Table 12: Description of Touch Panel Interfaces ............................................................................................... 38 Table 13: Pin Definition of Touch Panel Interfaces ............................................................................................ 39 Table 14: Description of Camera Interfaces ...................................................................................................... 39 Table 15: Description of USB Interfaces............................................................................................................ 41 Table 16: Description of Audio Interfaces .......................................................................................................... 43 Table 17: Pin Definition of Headset Interface .................................................................................................... 45 Table 18: Description of (U)SIM Card Interfaces ............................................................................................... 47 Table 19: Pin Definition of (U)SIM1 Card Connector ......................................................................................... 48 Table 20: Description of UART Interfaces ......................................................................................................... 49 Table 21: Pin Definition of Main UART .............................................................................................................. 50 Table 22: Description of SD Card Interface ....................................................................................................... 51 Table 23: Pin Definition of SD Card Connector ................................................................................................. 52 Table 24: Description of Flashlight..................................................................................................................... 53 Table 25: Description of Sensors ....................................................................................................................... 54 Table 26: Description of Vibrator ....................................................................................................................... 55 Table 27: Description of Switches...................................................................................................................... 56 Table 28: Description of Buttons ........................................................................................................................ 56 Table 29: Description of Status Indication LEDs ............................................................................................... 57 Table 30: Related Documents ........................................................................................................................... 65 Table 31: Terms and Abbreviations.................................................................................................................... 65 Smart_EVB_G5_User_Guide 7 / 66 Smart Module Series Figure Index Figure 1: Smart EVB G5 Top View .................................................................................................................... 13 Figure 2: Smart EVB G5 Bottom View............................................................................................................... 14 Figure 3: Top View for Component Placement of Smart EVB G5 ..................................................................... 15 Figure 4: Bottom View for Component Placement of Smart EVB G5 ............................................................... 16 Figure 5: Smart EVB G5 and Accessories......................................................................................................... 19 Figure 6: Smart EVB G5 Kit Accessories .......................................................................................................... 20 Figure 7: Simplified Power Supply Block Diagram of Smart EVB G5 ............................................................... 23 Figure 8: 5 V DC Power Jack ............................................................................................................................ 23 Figure 9: Power Plug Design ............................................................................................................................. 23 Figure 10: Reference Design for Battery Interface ............................................................................................ 24 Figure 11: Pin Assignment of Battery Interface ................................................................................................. 24 Figure 12: B2B Connectors ............................................................................................................................... 26 Figure 13: Sketch Map of Smart TE-A (Top View)............................................................................................. 26 Figure 14: Reference Design for Main LCM Interface ....................................................................................... 35 Figure 15: Reference Design for Secondary LCM Interface ............................................................................. 36 Figure 16: Pin Assignments of LCM Interfaces ................................................................................................. 37 Figure 17: Reference Design for Backlight Driver ............................................................................................. 37 Figure 18: Reference Design for Touch Panel Interfaces.................................................................................. 38 Figure 19: Pin Assignments of Touch Panel Interfaces ..................................................................................... 38 Figure 20: Reference Design for Camera Interfaces......................................................................................... 40 Figure 21: Camera Interfaces with Cameras Assembled .................................................................................. 41 Figure 22: Reference Design for USB Interfaces .............................................................................................. 42 Figure 23: USB Interfaces ................................................................................................................................. 42 Figure 24: Reference Design for Loudspeaker Interface .................................................................................. 43 Figure 25: Reference Design for Headset Interface .......................................................................................... 44 Figure 26: Pin Assignment of Headset Interface ............................................................................................... 44 Figure 27: Sketch of Audio Plug ........................................................................................................................ 45 Figure 28: Reference Design for Earphone Interface........................................................................................ 46 Figure 29: Reference Design for Microphone Interfaces................................................................................... 46 Figure 30: MEMS-Type and ECM-Type Microphones ....................................................................................... 47 Figure 31: Reference Circuit for (U)SIM Interface with (U)SIM1 Card Connector ............................................ 48 Figure 32: Pin Assignment of J1001 and J1002 ................................................................................................ 48 Figure 33: RS-232 Level Match Circuit.............................................................................................................. 50 Figure 34: Pin Assignments of Main UART and Debug UART.......................................................................... 50 Figure 35: Simplified Interface Schematic for SD Card Interface...................................................................... 51 Figure 36: Pin Assignment of SD Card Interface............................................................................................... 52 Figure 37: Reference Circuit Design for Flashlight Interfaces ........................................................................... 53 Figure 38: Flashlights ........................................................................................................................................ 53 Figure 39: Sensors ............................................................................................................................................ 54 Figure 40: Reference Design for USB_BOOT................................................................................................... 55 Figure 41: Reference Design for Vibrator .......................................................................................................... 55 Smart_EVB_G5_User_Guide 8 / 66 Smart Module Series Figure 42: ERM-Type Vibrator ........................................................................................................................... 56 Figure 43: Switches ........................................................................................................................................... 57 Figure 44: Buttons ............................................................................................................................................. 57 Figure 45: Status Indicators............................................................................................................................... 58 Figure 46: LCD Display Indicating Module’s Turn-on ........................................................................................ 59 Figure 47: LCD Menu Display for Turning Off Module ...................................................................................... 60 Figure 48: USB Ports......................................................................................................................................... 61 Figure 49: 'adb shell' Command ....................................................................................................................... 61 Figure 50: USB Serial Port for UART ................................................................................................................ 62 Figure 51: QCOM Configuration When Connecting USB Serial Port................................................................ 63 Figure 52: Firmware Upgrade Steps ................................................................................................................. 64 Smart_EVB_G5_User_Guide 9 / 66 Smart Module Series 1 Introduction This user guide describes the application details of the Smart EVB G5 (evaluation board), which is an assistant tool for engineers to develop applications and test basic functions of applicable modules below. Applicable Modules Table 1: Applicable Modules Model Series SC200L/SC200E Special Mark Table 2: Special Mark Mark * Definition Unless otherwise specified, when an asterisk (*) is used after a function, feature, interface, pin name, AT command, or argument, it indicates that the function, feature, interface, pin, AT command, or argument is under development and currently not supported; and the asterisk (*) after a model indicates that the sample of such model is currently unavailable. Smart_EVB_G5_User_Guide 10 / 66 Smart Module Series 2 Product Overview Key Features Table 3: Key Features Features Power supply LCM interfaces Touch panel interfaces Camera interfaces USB interface Audio interfaces (U)SIM card interfaces Implementation ⚫ DC power supply: 5–36 V (typical: 5 V) ⚫ VBAT: 3.55–4.4 V (typical: 3.8 V) ⚫ Two 5-inch 1280 × 720 HD resolution LCDs ⚫ 4-lane MIPI DSI interface for each LCD Two capacitive touch panels Support three cameras: ⚫ Rear camera supports 16M pixels with 4-lane CSI interface ⚫ Front camera supports 8M pixels with 2-lane CSI interface ⚫ Depth camera supports 2M pixels with 1-lane CSI interface Support USB Type-C interface and Micro-USB interface: ⚫ Compliant with USB 3.0 and 2.0 specifications, with transmission rates up to 5 Gbps on USB 3.0 and 480 Mbps on USB 2.0 ⚫ Support USB OTG ⚫ Used for AT command communication, data transmission, software debugging and firmware upgrade Analog Inputs: 3 groups of analog microphone inputs, integrating internal bias voltage. ⚫ One headset input ⚫ One ECM-type microphone input ⚫ One MEMS-type microphone input Analog Outputs: 3 groups of analog audio outputs, including: ⚫ One stereo headset output ⚫ One mono earphone differential output ⚫ One mono loudspeaker differential amplifier output ⚫ Support (U)SIM cards: 1.8 V and 2.95 V ⚫ Support dual SIM dual standby Smart_EVB_G5_User_Guide 11 / 66 Smart Module Series UART interfaces SD card interface MIPI + SPI/I2S interface* Flashlights Sensors Vibrator Switches and buttons Status indicators Size Support two UART interfaces: ⚫ Main UART for data transmission and AT command communication ⚫ Debug UART for debugging Support 4-bit SD card with hot-plug detection A group of 4-lane MIPI_DSI interface and SPI/I2S interface Support 2 flashlight LEDs for testing the module’s flashlight function Support three sensors including ALS/PS, accelerometer/gyroscope and geomagnetic sensor A vibrator for testing the motor drive interface of the module ⚫ 4 switches including two power supply switches, one emergency download switch and one USB selection switch ⚫ 4 buttons including PWRKEY, RESET, VOL DOWN and VOL UP 3 LEDs are available for signal indication 26.5 cm × 19.0 cm Smart_EVB_G5_User_Guide 12 / 66 Top and Bottom Views Smart Module Series Figure 1: Smart EVB G5 Top View Smart_EVB_G5_User_Guide 13 / 66 Smart Module Series Figure 2: Smart EVB G5 Bottom View Smart_EVB_G5_User_Guide 14 / 66 Smart Module Series Component Placement of Smart EVB G5 J1202 J1301 J1302 J1303 J1305 J1304 J1306 U1301 U1303 U0305 SPK J1201 J0101 J0102 J0403 J0804 J0802 EAR BAT0201 U1201 U0301 U0304 U0302 J0202 J0201 U0202 D0501 D0503 D0502 D0506 D0507 D0508 D0509 D0514 D0515 D0516 D0517 J0402 S0501 J0401 S0601 J0803 J0801 J0601 J0602 J1101 J1001 J1002 S0502 S0503 S0505 S0504 S0201 S0202 Figure 3: Top View for Component Placement of Smart EVB G5 Smart_EVB_G5_User_Guide 15 / 66 Smart Module Series J1203 J1204 Figure 4: Bottom View for Component Placement of Smart EVB G5 Table 4: Components & Functions of Smart EVB G5 Components Power supply Power switches PWRKEY RESET VOL DOWN RefDes. J0201 J0202 S0201 S0202 S0502 S0503 S0504 Description ⚫ Power jack on the EVB ⚫ Typical power supply: +5 V ⚫ Li-polymer battery connector ⚫ Typical power supply: +3.7 V Select DC power supply or battery power supply VBAT on/off control ⚫ Power key (push button) ⚫ Turn on/off the module ⚫ Reset button (push button) ⚫ Reset the module Turn the volume down Smart_EVB_G5_User_Guide 16 / 66 Smart Module Series VOL UP FORCE USB BOOT USB interface Audio interfaces (U)SIM card interfaces UART interface SD card interface Status indicators Smart TE-A interface Camera interfaces Flashlights S0505 S0501 J0601 J0602 J1203 J1204 U1201 U1202 J1202 J1001 J1002 J1301 J1302 J1101 D0501 D0502 D0503 J0101, J0102 J0401 J0402 J0403 D0301 D0302 Turn the volume up Emergency download Micro-USB interface USB Type-C interface ⚫ Used for loudspeaker ⚫ Rated resistance: 8 Ω ⚫ Rated power: 1.5 W ⚫ Used for earphone ⚫ Rated resistance: 32 Ω ⚫ Rated power: 30 mW Used for MEMS-type microphone Used for ECM-type microphone Audio jack for headset (U)SIM1 card connector (U)SIM2 card connector Main UART for data communication Debug UART for debugging SD card connector Power supply on/off indicator Charging status indicator Module turn-on/turn-off indicator Connectors for connecting Smart TE-A with Smart EVB G5 Rear camera connector, support 16M CMOS sensor with auto-focusing function Front camera connector, support 8M CMOS sensor with auto-focusing function Depth camera connector, support 2M CMOS sensor with auto-focusing function Flashlight LED1 for testing module’s flashlight interface Flashlight LED2 for testing module’s flashlight interface Smart_EVB_G5_User_Guide 17 / 66 J0803 LCM and TP interfaces J0804 J0801 J0802 U0301 Sensors U0302 U0304 Vibrator U0305 Coin cell BAT0201 MIPI + SPI/I2S interface* J0902 Smart Module Series Connector for main LCM ZIF connector for main touch panel Connector for secondary LCM ZIF connector for secondary touch panel Accelerometer and gyroscope sensor Geomagnetic sensor Ambient light sensor (ALS) and proximity sensor (PS) Test module’s motor driver interface Coin cell battery for RTC power supply A group of 4-lane MIPI_DSI interface and SPI interface Smart_EVB_G5_User_Guide 18 / 66 Smart Module Series 3 Smart EVB G5 Kit Accessories Accessories Assembly Figure 5: Smart EVB G5 and Accessories NOTE The assembly method shown in the figure above is for reference only. Smart_EVB_G5_User_Guide 19 / 66 Smart Module Series List of Accessories All accessories of Smart EVB G5 kit are listed as below. Please contact the supplier if there is something missing. 5V DC adapter USB to RS232 converter cable USB Type-C cable GNSS antenna USB flash disk Headset Wi-Fi/Bluetooth antenna Main antennas Bolts& coupling nuts & RF cables Figure 6: Smart EVB G5 Kit Accessories Table 5: Accessories List Items Power adapter Cables Antennas Description 5 V DC power supply USB to RS-232 converter cable USB Type-C cable RF cables Main antennas Wi-Fi/Bluetooth antenna Quantity (pcs) 1 1 1 4 2 1 Smart_EVB_G5_User_Guide 20 / 66 Smart Module Series Audio USB flash disk Bolts and Nuts Instruction Sheet GNSS antenna (passive) 1 Headset 1 USB 2.0 to RS-232 driver USB driver 1 Related tools for modules Bolts and coupling nuts for fixing Smart EVB G5 4 for each A sheet of paper giving instructions for EVB connection, 1 details of EVB accessories, etc. NOTE The main antennas can also be used for diversity reception. Smart_EVB_G5_User_Guide 21 / 66 Smart Module Series 4 Interface Application This chapter describes the hardware interfaces of Smart EVB G5, as listed below: ⚫ Power supply ⚫ Smart TE-A interface ⚫ LCM interfaces ⚫ Touch panel interfaces ⚫ Camera interfaces ⚫ USB interfaces ⚫ Audio interfaces ⚫ (U)SIM card interfaces ⚫ UART interfaces ⚫ SD card interface ⚫ Emergency download interface It also provides information about flashlights, sensors, vibrator, switches and buttons, status indicators and test points to help customers use the Smart EVB G5. Power Supply The Smart EVB G5 can be powered by an external 5 V DC power adapter through the power jack J0201 and the step-down converter (DC-DC converter), which is used to convert 5 V DC power supply voltage to 4.0 V for powering up the module. The Smart EVB G5 can also be powered by a 3.7 V Li-polymer battery through the battery connector J0202 on the EVB. Table 6: Description of Power Supply RefDes. J0201 J0202 Description Power jack on the EVB Li-polymer battery connector Smart_EVB_G5_User_Guide 22 / 66 Smart Module Series The following figure shows the simplified power supply block diagram and power interfaces of Smart EVB G5. U0201 5V DC J0201 DC Power Jack DC-DC Converter Li-polymer Battery J0202 S0201 4V Power Switch S0202 Power ON/OFF Power Supply for Smart Modules Figure 7: Simplified Power Supply Block Diagram of Smart EVB G5 4.1.1. Adapter Interface The following figure shows the DC power jack of the Smart EVB G5. Figure 8: 5 V DC Power Jack When the power jack is used for power supply, the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 9: Power Plug Design Smart_EVB_G5_User_Guide 23 / 66 Smart Module Series 4.1.2. Battery Interface The following figure shows a reference circuit design for battery interface. VBAT TEMP GND Battery D1 D2 C1 C2 C3 R1 100 uF 1 nF 100 pF 47 K J0202 6 VBAT 5 VBAT 4 ID 3 BAT_THERM 2 GND 1 GND EVB Figure 10: Reference Design for Battery Interface The following figure shows the pin assignment of battery interface. The following table shows the pin definition of the battery connector. 6 5 4 3 2 1 Figure 11: Pin Assignment of Battery Interface Smart_EVB_G5_User_Guide 24 / 66 Smart Module Series Table 7: Pin Definition of Battery Interface Pin No. 1, 2 3 4 5, 6 Pin Name GND THERM ID VBAT Description GND pins Connected to the negative pole of the battery Detect battery temperature A 47K thermistor is used for the battery protection circuit Reserved Power input pins Connect to the positive pole of the battery Smart TE-A Interface The Smart TE-A interface includes two B2B connectors J0101 and J0102. Smart TE-A is connected to the EVB via the two connectors. Table 8: Description of Smart TE-A Interface RefDes. J0101 J0102 Description Connectors for connecting Smart TE-A with Smart EVB G5 Smart_EVB_G5_User_Guide 25 / 66 Smart Module Series The following two figures show the two B2B connectors and the sketch map of the Smart TE-A. 2 1 2 1 140 139 J0101 140 139 J0102 Figure 12: B2B Connectors Figure 13: Sketch Map of Smart TE-A (Top View) Smart_EVB_G5_User_Guide 26 / 66 Smart Module Series The following table describes the pin definition of the two B2B connectors J0101 and J0102. Table 9: Pin Definition of B2B Connector J0101 Pin No. Pin Name 1, 11, 37, 71, 83, 90, 94, 101, 103, 104, 109–111, 116, 122, GND 127–129, 134, 139, 140 2 LCD_RST1 3 UART1_CTS 4 GPIO5 5 UART1_RXD 6 INT_CC 7 UART1_RTS 8 TP2_HDMI_RST 9 UART1_TXD 10, 16, 21, 23, 25–27, 29, 31–33, 35,39, 41–44, 46–48, 51, NC 55, 57, 62–64,97, 118, 130 12, 14 VDD_3V3 13 UART2_CTS 15 UART2_RXD 17 UART2_RTS 18 GPIO_1 19 UART2_TXD 20 GPIO2 22 GPIO3 24 GPIO4 28 TP0101 30 TP0102 Smart_EVB_G5_User_Guide 27 / 66 34 36 38, 105, 107 40, 56 45 49 50 52 53 54 55 58 59 60 61 65 66 67 68 69 70 72 73 74 75 Smart_EVB_G5_User_Guide Smart Module Series CC1 CC2 USB_VBUS SEL_SW SD_LDO12 LDO2_1V1 I2S_MCLK/LCD_TE1 TP2_CC_HDMI_I2C_SDA CS_PLUS TP2_CC_HDMI_I2C_SCL CS_MINUS CHG_LED PMU_MPP2 GRENN_LED DSI_PWM CS_N MAG_INT CS_P TP2_HDMI_INT FORCE_USB_BOOT GPIO_8 CAM_1V2_EN HAP_P SENSOR_I2C_SCL HAP_N 28 / 66 76 77 78 79 80 81 82 84 85 86 87 88 89 91 92 93 95 96 98 99 100 102 106 108 112 Smart_EVB_G5_User_Guide Smart Module Series SENSOR_I2C_SDA LCD_BL_A GYROSCOPIC_INT LCD_BL_K1 FSYNC/INT2 LCD_BL_K2 ALPS_INT GPIO_7 LDO23_1V2 LCD_BL_K3 LDO5_1V8 LCD_BL_K4 LDO6_1V8 LDO10_2V8 FM_ANT LDO22_2V8 LDO17_2V85 HPH_R HPH_REF VRTC HPH_L HS_DET SPK_P SPK_N EAR_P 29 / 66 113, 115, 117, 119, 121, 123, 125 114 120 124 126 131 132 133 135 136 137 138 Smart Module Series VBAT EAR_N MIC_BIAS1 MIC_GND MIC3_P BATT_MINUS MIC2_P BATT_PLUS VBAT_SNS MIC1_N BAT_THERM MIC1_P Table 10: Pin Definition of B2B Connector J0102 Pin No. Pin Name 1 USIM1_VDD 2, 8, 14, 20, 21, 23, 26, 29, 32, 35, 41, 47, 53, 59, 65, 73, 79, 85, 90, 91, 94, 97, 98, 102, 103, 109, 114, 115, 120, GND 121, 126, 132, 139 3 USIM1_DET 4 DSI1_LN3_P 5 USIM1_RST 6 DSI1_LN3_N 7 USIM1_CLK 9 USIM1_DATA 10 DSI1_LN2_N 11 USIM2_VDD Smart_EVB_G5_User_Guide 30 / 66 12 13 15 16 17 18 19 22 24 28 30 34 36 37 38 39 40 42 43 44 45 46 48 49 50 51 Smart_EVB_G5_User_Guide Smart Module Series DSI1_LN2_P USIM2_DET USIM2_RST DSI1_LN1_N USIM2_CLK DSI1_LN1_P USIM2_DATA DSI1_LN0_N DSI1_LN0_P DSI1_CLK_N DSI1_CLK_P TP_RST TP_INT DSI0_LN3_P TP_I2C_SCL(TP2_CC_HDMI_I2C_SCL) DSI0_LN3_N TP_I2C_SDA(TP2_CC_HDMI_I2C_SDA) LCD_TE DSI0_LN2_P LCD_RST DSI0_LN2_N GPIO_16 I2S_MCLK DSI0_LN1_P CTP_EN DSI0_LN1_N 31 / 66 52 54 55 56 57 58 60 61 62 63 67 68 69 71 75 77 78 80 81 82 83 84 86 87 88 89 Smart_EVB_G5_User_Guide Smart Module Series SPI_CLK_I2S_CLK SPI_MISO_I2S_D1 DSI0_LN0_P SPI_MOSI_I2S_D0 DSI0_LN0_N SPI_CS_I2S_WS GPIO1_EXT DSI0_CLK_P GPIO2_EXT DSI0_CLK_N PWRKEY EN_AVDD_CAM RESET_N PMI_MPP1 CSI1_LN1_P CSI1_LN1_N SCAM_PWDN SCAM_RST CSI1_LN0_P CAM_I2C_SDA CSI1_LN0_N CAM_I2C_SCL MCAM_PWDN CSI1_CLK_P MCAM_RST CSI1_CLK_N 32 / 66 93 95 96 99 100 101 104 105 106 107 108 110 111 112 113 116 117 118 119 122 123 124 122 123 124 125 Smart_EVB_G5_User_Guide Smart Module Series CSI0_LN3_P CSI0_LN3_N SCAM_MCLK CSI0_LN2_P MCAM_MCLK CSI0_LN2_N FLASH_LED1 CSI0_LN1_P FLASH_LED2 CSI0_LN1_N USB_ID GPIO_6 CSI0_LN0_P USB_OTG_PWR_EN CSI0_LN0_N DM CSI0_CLK_P DP CSI0_CLK_N TX_M SD_LDO11 TX_P TX_M SD_LDO11 TX_P SD_CMD 33 / 66 127 128 129 130 131 133 135 136 137 138 25, 27, 31, 33, 64, 66, 70, 72, 74, 76, 92, 134, 140 Smart Module Series SD_DET RX_M SD_CLK RX_P SD_DATA0 SD_DATA1 SD_DATA2 KEY_VOL_DOWN SD_DATA3 KEY_VOL_UP NC LCM Interfaces The Smart EVB G5 provides two LCM interfaces and can be equipped with two LCD modules for dual display function. Currently, the Smart EVB G5 provides two 5-inch 1280 × 720 HD resolution liquid crystal displays for customers to test. Table 11: Description of LCM Interfaces RefDes. J0803 J0801 Description Connector for main LCM Connector for secondary LCM Smart_EVB_G5_User_Guide 34 / 66 Smart Module Series 4.3.1. Main LCM Interface The following figure shows a reference circuit design for main LCM interface of the Smart EVB G5. LCD0_TE LCD0_ RST PMI_ MPP1 DSI0_LN3_P DSI0_LN3_N DSI0_LN2_P DSI0_LN2_N DSI0_LN1_P DSI0_LN1_N DSI0_LN0_P DSI0_LN0_N DSI0_ CLK_P DSI0_ CLK_N Module LCD_BL_A LCD_BL_K1 LCD_BL_K2 VDD_2V8 LCM_IO C1 C2 C3 4.7uF 100nF 1uF FL1 1 3 6 5 2 4 1 3 FL2 6 5 2 4 1 3 FL3 6 5 2 4 FL4 1 3 6 5 2 4 FL5 1 3 6 5 2 4 EMI filter J0803 1 LEDA 2 NC 3 LEDK 4 NC 5 LPTE 6 RESET 7 LCD_ID 8 NC (SDA-TP) 9 NC (SCL-TP) 10 NC (RST-TP) 11 NC (EINT-TP) 12 GND 13 VIO18 14 VCC28 15 NC (VTP-TP) 16 GND 17 MIPI_TDP3 18 MIPI_ TDN3 19 GND 20 MIPI_TDP2 21 MIPI_ TDN2 22 GND 23 MIPI_TDP1 24 MIPI_ TDN1 25 GND 26 MIPI_TDP0 27 MIPI_ TDN0 28 GND 29 MIPI_TCP 30 MIPI_ TCN 31 GND 32 GND 33 GND 34 GND LCM Figure 14: Reference Design for Main LCM Interface NOTE The white LEDs (WLED) of main LCM interface are driven by the module. LCD_BL_A is the high voltage source for powering a string of WLEDs. LCD_BL_K1 and LCD_BL_K2 are the two output drivers for sinking the current from WLED strings. Smart_EVB_G5_User_Guide 35 / 66 Smart Module Series 4.3.2. Secondary LCM Interface The following figure shows a reference circuit design for secondary LCM interface of the Smart EVB G5. LCD1_TE LCD1_RST PMU_MPP2 DSI1_LN3_P DSI1_LN3_N DSI1_LN2_P DSI1_LN2_N DSI1_LN1_P DSI1_LN1_N DSI1_LN0_P DSI1_LN0_N DSI1_CLK_P DSI1_CLK_N Module LCM1_LED+ LCM1_LED- 1 2 1 2 1 2 1 2 1 2 5 5 5 5 5 VDD_2V8 LCM_IO 6 6 6 6 6 FL1 3 4 3 FL2 4 3 FL3 4 FL4 3 4 FL5 3 4 EMI filter C1 C2 4.7 uF 100nF J0801 1 LEDA 2 NC 3 LEDK 4 NC 5 LPTE 6 RESET 7 LCD_ID 8 NC (SDA-TP) 9 NC (SCL-TP) C3 10 NC (RST-TP) 1 uF 11 NC (EINT-TP) 12 GND 13 VIO18 14 VCC28 15 NC (VTP-TP) 16 GND 17 MIPI_TDP3 18 MIPI_TDN3 19 GND 20 MIPI_TDP2 21 MIPI_TDN2 22 GND 23 MIPI_TDP1 24 MIPI_TDN1 25 GND 26 MIPI_TDP0 27 MIPI_TDN0 28 GND 29 MIPI_TCP 30 MIPI_TCN 31 GND 32 GND 33 GND 34 GND LCM Figure 15: Reference Design for Secondary LCM Interface Smart_EVB_G5_User_Guide 36 / 66 The following figure shows the pin assignments of LCM interfaces. Smart Module Series J0803 J0801 Figure 16: Pin Assignments of LCM Interfaces 4.3.3. Backlight Driver for Secondary LCM Interface The Smart EVB G5 uses a PWM dimming step-up LED driver for the WLED backlighting of secondary LCM interface. The following figure shows a reference circuit design for the backlight driver. PWM Module VBAT_EVB U0802 Backlight Driver C1 LCM_LED+ LCM_LED- Figure 17: Reference Design for Backlight Driver Smart_EVB_G5_User_Guide 37 / 66 Smart Module Series Touch Panel Interfaces The Smart EVB G5 provides two touch panel interfaces: Table 12: Description of Touch Panel Interfaces RefDes. J0804 J0802 Description ZIF connector for main touch panel ZIF connector for secondary touch panel The following figure shows a reference design for touch panel interfaces. TP_I2C_ SDA TP_I2C_ SCL TP_ RST TP_ INT Module VIO_1V8 R1 2.2K R2 2.2K D1 D2 D3 VDD_2V8 D4 C1 C2 D5 4.7uF 100nF J0802/J0804 1 TP_SDA 2 TP_SCL 3 TP_RST 4 TP_INT 5 6 GND VDD TP Figure 18: Reference Design for Touch Panel Interfaces The following figure shows the pin assignments of touch panel interfaces, and the following table shows the pin definition of touch panel interfaces. 654321 654321 Figure 19: Pin Assignments of Touch Panel Interfaces Smart_EVB_G5_User_Guide 38 / 66 Smart Module Series Table 13: Pin Definition of Touch Panel Interfaces Pin No. 1 2 3 4 5 6 Pin Name TP_SDA TP_SCL TP_RST TP_INT GND VDD Description I2C data signal of touch panel I2C clock signal of touch panel Reset signal of touch panel Interrupt signal of touch panel Ground 2.8V power supply for touch panel VDD power Camera Interfaces Smart EVB G5 provides three camera interfaces (4-lane + 2-lane + 1-lane) with rear camera, front camera and depth camera assembled. Table 14: Description of Camera Interfaces RefDes. J0401 J0402 J0403 Description Rear camera connector, support 16M CMOS sensor with auto-focusing function Front camera connector, support 8M CMOS sensor with auto-focusing function Depth camera connector, support 2M CMOS sensor with auto-focusing function Smart_EVB_G5_User_Guide 39 / 66 The following figure shows a reference design for camera interfaces. Smart Module Series 4.7uF 4.7uF 1uF 1uF AFVDD_2V8 AVDD_2V95 DVDD_1V1 M CAM_ RST MCAM_PWDN MCAM_MCLK CAM_I2C_ SDA CAM_I2C_ SCL CSI0_LN3_P CSI0_LN3_N CSI0_LN2_P CSI0_LN2_N CSI0_LN1_P CSI0_LN1_N CSI0_LN0_P CSI0_LN0_N CSI0_ CLK_P CSI0_ CLK_N SCAM_RST SCAM_PWDN SCAM_MCLK DOVDD_1V8 2.2K 2.2K EMI EMI EMI EMI EMI DVDD_1V2 4.7uF 1uF 1uF CSI1_LN1_P EMI CSI1_LN1_N CSI1_LN0_P CSI1_LN0_N EMI CSI1_ CLK_P EMI CSI1_ CLK_N DCAM_RST DCAM_PWDN DCAM_MCLK CSI2_LN0_P CSI2_LN0_N EMI CSI2_ CLK_P EMI CSI2_ CLK_N AF_VDD AVDD DVDD DOVDD AVDD DOVDD DVDD AVDD DOVDD Front camera connector Rear camera connector Depth camera connector Figure 20: Reference Design for Camera Interfaces Smart_EVB_G5_User_Guide 40 / 66 Smart Module Series The following figure shows the camera interfaces with cameras assembled. Figure 21: Camera Interfaces with Cameras Assembled USB Interfaces The Smart EVB G5 provides two USB interfaces: a micro-USB interface and a type-C interface. Table 15: Description of USB Interfaces RefDes. J0601 J0602 Description Micro-USB interface USB type-C interface ⚫ The Type-C interface complies with the USB 3.0 specifications and supports super-speed (5 Gbps) on USB 3.0, high-speed (480 Mbps) on USB 2.0 and full-speed (12 Mbps) modes. USB Type-C interface support USB OTG function, and is used for AT command communication, data transmission, software debugging and firmware upgrade. ⚫ The Micro-USB interface complies with the USB 2.0 specifications and supports high-speed (480 Mbps) on USB 2.0 and full-speed (12 Mbps) modes. Smart_EVB_G5_User_Guide 41 / 66 The following figure shows a reference circuit design for USB interfaces. J0601 Micro-USB J0602 USB Type-C S0601 USB Switch U0601 USB2.0 Switch IC U0602 USB3.0 Switch IC Smart Module Series Module Figure 22: Reference Design for USB Interfaces The following figure shows the USB interfaces. Figure 23: USB Interfaces Audio Interfaces Smart EVB G5 provides three groups of analog audio outputs: one mono loudspeaker, one mono earphone, and one stereo headset. The Smart EVB G5 further provides three groups of analog audio inputs: two single-ended microphone inputs and one differential microphone input. One single-ended microphone input is used for headset interface. The other single-ended microphone input and the differential microphone input are used for microphone interfaces. Smart_EVB_G5_User_Guide 42 / 66 Table 16: Description of Audio Interfaces RefDes. J1203 J1204 U1201 U1202 J1202 Description ⚫ Used for loudspeaker ⚫ Rated resistance: 8 Ω ⚫ Rated power: 1.5 W ⚫ Used for earphone ⚫ Rated resistance: 32 Ω ⚫ Rated power: 30 mW Used for MEMS-type microphone Used for ECM-type microphone Audio jack for headset Smart Module Series 4.7.1. Loudspeaker Interface Smart EVB G5 provides one loudspeaker interface and the loudspeaker is soldered onto the Smart EVB G5 via test point J1203. The following figure shows a reference circuit design for loudspeaker interface. Module SPK_P SPK_N 1.0nF FB ESD J1203 Close to speaker FB 1.0nF ESD Figure 24: Reference Design for Loudspeaker Interface Smart_EVB_G5_User_Guide 43 / 66 Smart Module Series 4.7.2. Headset Interface The following figure shows a reference circuit design for headset interface. R1 MIC2_P R2 HPH_R 0R 33 R F1 F2 C1 HPH_L HPH_REF HS_DET Module R3 33 R R4 20K C2 C3 C4 33pF 33pF 33pF 100 pF F3 F4 R5 10 K R6 10 K D1 D2 D3 D4 D5 J1202 6 1 3 5 2 4 Figure 25: Reference Design for Headset Interface The following figure shows the pin assignment of headset interface. 2 1 3 6 5 4 Figure 26: Pin Assignment of Headset Interface Smart_EVB_G5_User_Guide 44 / 66 The following table shows the pin definition of headset interface. Smart Module Series Table 17: Pin Definition of Headset Interface Pin No. 1 2 3 4 5 6 Pin Name MIC GND R-AUDIO DETECT L-AUDIO GND Description Positive microphone input Dedicated GND for audio Headset right channel Headset detection Headset left channel Ground The following figure shows the sketch design of audio plug which suits for the audio jack on Smart EVB G5. HS_DET 5 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 27: Sketch of Audio Plug 4.7.3. Earphone Interface Smart EVB G5 provides one earphone interface and the earphone is soldered onto the Smart EVB G5 via test point J1204. The following figure shows a reference circuit design for earphone interface. Smart_EVB_G5_User_Guide 45 / 66 Smart Module Series Module FB EAR_P EAR_N 33pF 100pF 33pF ESD J1204 Earphone ESD Figure 28: Reference Design for Earphone Interface 4.7.4. Microphone Interfaces Smart EVB G5 provides one single-ended microphone input and one differential microphone input for microphone interfaces. The single-ended microphone input is for MEMS-type microphone and the differential microphone input is for ECM-type microphone. The following figures show a reference circuit design for microphone interfaces. Module MIC1_P MIC1_N U1202 B1 C1 B2 100pF 2 MIC_P 1 MIC_N C2 D1 ECM Module MIC_BIAS1 MIC3_N MIC3_P B1 C3 100nF C4 100nF C5 33pF C2 D1 150pF C1 100nF 1 U1201 2 VDD GND 3 GND OUT 4 MEMS Figure 29: Reference Design for Microphone Interfaces Smart_EVB_G5_User_Guide 46 / 66 Smart Module Series MEMS-Type ECM-Type Figure 30: MEMS-Type and ECM-Type Microphones (U)SIM Card Interfaces The Smart EVB G5 provides two 6-pin push-push type (U)SIM card (1.8/2.95 V) connectors which support 1.8/2.95 V (U)SIM card. Table 18: Description of (U)SIM Card Interfaces RefDes. J1001 J1002 Description (U)SIM1 card connector (U)SIM2 card connector Smart_EVB_G5_User_Guide 47 / 66 Smart Module Series The following figure shows the simplified interface schematic for J1001. USIM_ VDD USIM_ RST USIM_ CLK USIM_ DATA USIM_ DET Module USIM_VDD R1 10 K LDO_1V8 R5 NM-100 K R2 22 R R3 22 R R4 22 R C2 22 pF C3 C4 22 pF 22 pF ESD D1 C1 100 nF J1001 C1 VCC C2 RST C3 CLK GND C6 VPP C7 DATA CD2 CD2 CD1 CD1 GND1 GND2 R6 0 R (U)SIM Card Connector Figure 31: Reference Circuit for (U)SIM Interface with (U)SIM1 Card Connector The following figure shows the pin assignments of (U)SIM1 card connector (J1001) and (U)SIM2 card connector (J1002). CD1 CD2 C7 C3 C6 C2 C5 C1 (U)SIM1 Card Connector C7 C6 C5 C3 C2 C1 (U)SIM2 Card Connector Figure 32: Pin Assignment of J1001 and J1002 Table 19: Pin Definition of (U)SIM1 Card Connector No. Pin Name C1 USIM_VDD Description U(SIM) card power supply, provided by module Smart_EVB_G5_User_Guide 48 / 66 C2 C3 C5 C6 C7 CD1 CD2 USIM_RST USIM_CLK GND VPP USIM_DATA USIM_GND USIM_DET Smart Module Series U(SIM) card reset U(SIM) card clock Ground NC (U)SIM card data GND U(SIM) card insertion detection NOTE The reference circuit and pin assignment of J1002 are the same as J1001’s. UART Interfaces Smart EVB G5 provides two UART interfaces: main UART and debug UART. The main UART interface can be used for data transmission and AT command communication. The debug UART interface is used for debugging. Table 20: Description of UART Interfaces RefDes. J1301 J1302 Description Main UART for data communication Debug UART for debugging The following figure shows the block diagram of the UARTs on Smart EVB G5. Smart_EVB_G5_User_Guide 49 / 66 Smart Module Series UART_TXD UART_RTS UART_RXD UART_CTS GND Module 1.8V OE VCCA TXD_1.8V RTS_1.8V VCCB TXD_3.3V RTS_3.3V 3.3V RXD_1.8V CTS_1.8V RXD_3.3V CTS_3.3V GND 3.3V TXS0104 EPWR VCC DIN 1 DIN 2 DIN 3 DIN 4 DIN 5 R1OUTB ROUT 1 ROUT 2 ROUT 3 GND DOUT1 DOUT2 DOUT3 DOUT4 DOUT5 RIN1 RIN2 RIN3 FORCEON /FORCEOFF /INVALID SN65C 3238 Figure 33: RS-232 Level Match Circuit GND RXD CTS TXD RTS UART The following figure shows the pin assignments of main UART and debug UART. J1302 J1301 5 32 8 7 Figure 34: Pin Assignments of Main UART and Debug UART Table 21: Pin Definition of Main UART Pin No. 2 3 5 7 8 Pin Name Main_UART_TXD Main_UART_RXD Main_UART_GND Main_UART_CTS Main_UART_RTS Description Transmit data Receive data Ground Clear to send Request to send Smart_EVB_G5_User_Guide 50 / 66 Smart Module Series NOTE The level match circuit and pin assignment of J1302 are the same as those of J1301. SD Card Interface Smart EVB G5 provides an SD card interface for customers to test the module’s SD card interface. Table 22: Description of SD Card Interface RefDes. J1101 Description SD card connector The following figure shows the simplified interface schematic for SD card interface on Smart EVB G5. SD_DATA2 SD_DATA3 SD_CMD SD_CLK SD_DATA0 SD_DATA1 SD_DET Module LDO5_1P8 SD_LDO12 SD_LDO11 R7 R8 R9 R10 R11 R12 R13 R1 120K 33R 33R 33R 33R 33R 33R 1K R2 R3 R4 R5 R6 NM_51K NM_51K NM_10K NM_51K NM_51K D1 D2 D3 D4 D5 D6 D7 C1 C2 D8 4.7uF 33pF 1 SD_DATA2 2 SD_DATA3 3 SD_CMD 4 VDD 5 SD_CLK 6 VSS 7 SD_DATA0 8 SD_DATA1 9 SD_DET 10 GND 11 GND 12 GND 13 GND SD Card Connector Figure 35: Simplified Interface Schematic for SD Card Interface Smart_EVB_G5_User_Guide 51 / 66 9 8 76 5 4 3 21 Smart Module Series Figure 36: Pin Assignment of SD Card Interface Table 23: Pin Definition of SD Card Connector Pin No. 1 2 3 4 5 6 7 8 9 10–13 Pin Name SD_DATA2 SD_DATA3 SD_CMD VDD SD_CLK VSS SD_DATA0 SD_DATA1 SD_DET GND Description SDIO data bit 2 SDIO data bit 3 SD card command SD card power supply SD card clock power ground (GND) SDIO data bit 0 SDIO data bit 1 SD card hot-plug detect GND Smart_EVB_G5_User_Guide 52 / 66 Smart Module Series Flashlights Smart EVB G5 provides two flashlight LEDs for testing the module’s flashlight interfaces which support flash mode and torch mode. Table 24: Description of Flashlight RefDes. D0301 D0302 Description Flashlight LED1 for testing module’s flashlight interface Flashlight LED2 for testing module’s flashlight interface The following figures show a reference circuit design for flashlights and their locations on Smart EVB G5. FLASH_LED1 FLASH_LED2 Module D0301 D0302 Figure 37: Reference Circuit Design for Flashlight Interfaces D0301 D0302 Figure 38: Flashlights Smart_EVB_G5_User_Guide 53 / 66 Smart Module Series Sensors Smart EVB G5 provides three sensors for testing purpose, as shown in the table and figure below. Table 25: Description of Sensors RefDes. U0301 U0302 U0304 Description Accelerometer and gyroscope sensor Geomagnetic sensor Ambient light sensor (ALS) and proximity sensor (PS) U0301 U0302 U0304 Figure 39: Sensors Emergency Download Interface Smart EVB G5 provides one emergency download interface FORCE USB BOOT to force the module to enter emergency download mode. Pull up USB_BOOT to 1.8 V before powering on the module when the function is used. Smart_EVB_G5_User_Guide 54 / 66 Smart Module Series The following figures show a reference circuit design for the emergency download interface. S1 USB_BOOT Module LDO5_1V8 R1 10K Figure 40: Reference Design for USB_BOOT Vibrator Smart EVB G5 provides an ERM-type vibrator for customers to test the motor driver interface of Smart modules. Table 26: Description of Vibrator RefDes. U0305 Description Test module’s motor driver interface. The following figures show a reference circuit design and the vibrator on the board. HAP_P HAP_N Module C1 33pF C2 33pF VIB+ VIB- Motor Figure 41: Reference Design for Vibrator Smart_EVB_G5_User_Guide 55 / 66 Smart Module Series + _ Figure 42: ERM-Type Vibrator Switches and Buttons Smart EVB G5 includes four switches and four buttons, which are illustrated in the following tables and figures. Table 27: Description of Switches RefDes. S0201 S0202 S0501 S0601 Description Used to select DC power supply or battery power supply Used for VBAT on/off control Used for enable emergency download function Used to select Micro USB or USB Type-C Table 28: Description of Buttons RefDes. S0502 S0503 S0504 S0505 Description Turn on/off the module Used to reset the module Turn the volume down Turn the volume up Smart_EVB_G5_User_Guide 56 / 66 The switches are shown in following figures. Smart Module Series S0201 S0202 S0501 S0601 Figure 43: Switches Smart EVB G5 provides four buttons S0502, S0503, S0504 and S0505, which are PWRKEY, RESET, VOL DOWN and VOL UP respectively. The buttons are shown in the following figure. S0502 S0503 S0505 Figure 44: Buttons S0504 Status Indicators There are three status indication LEDs on Smart EVB G5, illustrated as below. Table 29: Description of Status Indication LEDs RefDes. D0501 D0502 Description Indicates whether the power supply for EVB is on ⚫ Bright: VBAT ON ⚫ Extinct: VBAT OFF Indicates whether the module is being charged ⚫ Bright: module is being charged Smart_EVB_G5_User_Guide 57 / 66 D0503 ⚫ Extinct: module stops being charged Indicates whether the module is turned on Smart Module Series Figure 45: Status Indicators Smart_EVB_G5_User_Guide 58 / 66 Smart Module Series 5 Operation Procedures This chapter introduces how to use the Smart EVB G5 for testing and evaluation of applicable modules. Before the procedures below, please ensure modules and the EVB are correctly assembled. Turn On the Module Step 1: Connect the module TE-A to the Smart EVB G5 through connectors J0101 and J0102. Step 2: If battery power supply mode is to be used, connect a Li-polymer battery through J0202 and then switch S0201 to BATTERY. If 5 V DC power supply mode is to be used, connect 5 V DC power adapter through J0201 and a DC-DC converter and then switch S0201 to DC POWER. Step 3: Switch S0202 to ON, and then D0501 will light up. Step 4: Press S0502 (PWRKEY) for at least 2s to turn on the module. When the following interface is displayed on the utilized LCD(s), it means the booting has been completed. Figure 46: LCD Display Indicating Module’s Turn-on Smart_EVB_G5_User_Guide 59 / 66 Smart Module Series NOTE After power supply is provided (i.e., Step 3 mentioned above), inserting a USB cable into USB interface of EVB can also turn on the module. Turn Off the Module There are two methods to turn off the module. The steps for the first method are as follows: Step 1: Press D0501 (PWRKEY) for at least 1s under the turn-on state of the module, and then the LCD will display a menu for selection as shown in the following figure: Figure 47: LCD Menu Display for Turning Off Module Step 2: Choose 'Power off' option, then the module will be turned off normally. The other method is to press down PWRKEY for at least 8s until the module is shut down completely. Smart_EVB_G5_User_Guide 60 / 66 Smart Module Series Communication via USB Step 1: Turn on the module according to the procedures in Chapter 5.1. Step 2: Connect Smart EVB G5 with PC using USB cable through USB interface and then run the USB flash disk on PC to install the USB driver and ADB driver. The USB port numbers can be viewed in Device Manager of the PC when the USB driver is installed, as shown below. Figure 48: USB Ports Step 3: Open CMD tool: 'START' → 'All Programs' → 'Accessory' → 'Command Prompt'. Step 4: Use the 'adb shell' command to make the module enter ADB mode. Then customers can use USB ADB interface for testing. Figure 49: 'adb shell' Command Smart_EVB_G5_User_Guide 61 / 66 Smart Module Series NOTE 1. If customers want to use HyperTerminal for testing, then Qualcomm HS-USB Modem 9091 can be used. 2. Please note that the USB port numbers may be different among different modules. Communication via UART Interface Step 1: Run the USB flash disk on PC to install the USB-to-RS232 driver. Step 2: Connect the UART interface (main UART or debug UART) to the PC with USB-to-RS232 converter cable and then turn on the module according to the procedures mentioned in Chapter 5.1. After that, the USB serial port can be viewed through the PC Device Manager, as shown in the figure below. Figure 50: USB Serial Port for UART Step 3: Install and then use the QCOM tool provided by Quectel to realize the communication between the smart module and the PC. The following figure shows the QCOM configuration: select correct 'COM port' (USB Serial Port) and set correct 'Baudrate' (such as 115200 bps). For more details about QCOM tool usage and configuration, refer to document [3]. Smart_EVB_G5_User_Guide 62 / 66 Smart Module Series Figure 51: QCOM Configuration When Connecting USB Serial Port Firmware Upgrade Firmware of the module is upgraded via USB port by default. Please refer to the following procedures to upgrade firmware through the EVB. Step 1: Install and open the firmware upgrade tool QFIL on PC and then turn on the smart module according to the procedures mentioned in Chapter 5.1. Step 2: Click the 'SelectPort' and select the USB port 'Qualcomm HS-USB Diagnostics Modem 9091 (COM24)'. Step 3: Select 'Flat Build' in 'Select Build Type' option. Step 4: Click 'Browse' in 'Select Programmer' option to select the firmware which needs to be upgraded. Step 5: Click 'Load XML' in 'Select Build' option to select the XML which needs to be upgraded. Step 6: Click 'Download' to upgrade the firmware. Smart_EVB_G5_User_Guide 63 / 66 Smart Module Series 1 2 3 4 5 6 Figure 52: Firmware Upgrade Steps Smart_EVB_G5_User_Guide 64 / 66 Smart Module Series 6 Appendix References Table 30: Related Documents Document name [1] Quectel_SC200L_Series_Hardware_Design [2] Quectel_SC200E_Series_Reference_Design [3] Quectel_QCOM_User_Guide Table 31: Terms and Abbreviations Abbreviation ALS CMOS ECM EVB LCM LED MEMS MIPI OTG PC PS PWM UART Description Ambient Light Sensor Complementary Metal Oxide Semiconductor Electret Condenser Microphone Evaluation Board LCD Module Light Emitting Diode Micro-Electro-Mechanical System Mobile Industry Processor Interface On-The-Go Personal Computer Proximity Sensor Pulse Width Modulation Universal Asynchronous Receiver & Transmitter Smart_EVB_G5_User_Guide 65 / 66 USB (U)SIM WLED ZIF Universal Serial Bus (Universal) Subscriber Identity Module White LED Zero Insert Force Smart Module Series Smart_EVB_G5_User_Guide 66 / 66

RG200U-CN-MINIPCIE EVB 用户指导 5G 模块系列 版本：1.0 日期：2022-07-13 状态：受控文件 RG200U-CN-MINIPCIE EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 29 RG200U-CN-MINIPCIE EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 29 RG200U-CN-MINIPCIE EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或(U)SIM 卡无效时。如果设备支持紧急呼叫功能，请使用紧急呼叫，同时请确保设备开机并 且位于信号强度足够的区域。因不能保证所有情况下网络都能连接，故在紧急情况 下，不能将带有紧急呼叫功能的设备作为唯一的联系方式。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 3 / 29 RG200U-CN-MINIPCIE EVB 用户指导 文档历史 修订记录 版本 日期 - 2022-04-29 1.0 2022-07-13 作者 Chan CHEN Chan CHEN 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 4 / 29 RG200U-CN-MINIPCIE EVB 用户指导 目录 安全须知 ..................................................................................................................................................... 3 文档历史 ..................................................................................................................................................... 4 目录 ............................................................................................................................................................ 5 表格索引 ..................................................................................................................................................... 6 图片索引 ..................................................................................................................................................... 7 1 引言 ..................................................................................................................................................... 8 2 产品综述.............................................................................................................................................. 9 2.1. 俯视图与底视图..................................................................................................................... 9 2.2. 器件分布图 ...........................................................................................................................11 3 应用接口............................................................................................................................................ 14 3.1. 电源供电接口 ...................................................................................................................... 14 3.2. Mini PCIe 接口 .................................................................................................................... 15 3.3. USB 接口 ............................................................................................................................ 16 3.4. (U)SIM 卡接口..................................................................................................................... 17 3.5. UART .................................................................................................................................. 18 3.6. 天线接口 ............................................................................................................................. 19 3.7. 开关、按键和指示灯............................................................................................................ 20 3.8. 测试点 ................................................................................................................................. 21 4 操作说明............................................................................................................................................ 24 4.1. 模块开机 ............................................................................................................................. 24 4.2. 模块关机 ............................................................................................................................. 24 4.3. USB 接口通信 ..................................................................................................................... 24 4.4. 固件升级 ............................................................................................................................. 26 4.5. 模块复位 ............................................................................................................................. 27 5 参考文档及术语缩写.......................................................................................................................... 28 上海移远通信技术股份有限公司 5 / 29 RG200U-CN-MINIPCIE EVB 用户指导 表格索引 表 1：接口与功能 .....................................................................................................................................11 表 2：关键特性........................................................................................................................................ 12 表 3：电源描述........................................................................................................................................ 14 表 4：Mini PCIe 接口描述 ....................................................................................................................... 15 表 5：USB 接口描述................................................................................................................................ 16 表 6：(U)SIM 卡接口描述 ........................................................................................................................ 17 表 7：J0501 和 J0502 引脚定义 .............................................................................................................. 18 表 8：UART 描述 .................................................................................................................................... 19 表 9：天线接口描述................................................................................................................................. 19 表 10：开关、按键和指示灯描述............................................................................................................. 21 表 11：测试点描述................................................................................................................................... 22 表 12：参考文档...................................................................................................................................... 28 表 13：术语缩写...................................................................................................................................... 28 上海移远通信技术股份有限公司 6 / 29 RG200U-CN-MINIPCIE EVB 用户指导 图片索引 图 1：俯视图 ............................................................................................................................................. 9 图 2：底视图 ........................................................................................................................................... 10 图 3：器件分布俯视图 ..............................................................................................................................11 图 4：EVB 电源框图................................................................................................................................ 14 图 5：EVB 供电接口................................................................................................................................ 15 图 6：电源插头设计................................................................................................................................. 15 图 7：Mini PCIe 接口............................................................................................................................... 16 图 8：USB Type-C 接口 .......................................................................................................................... 16 图 9：模块与 USB Type-C 接口的连接示意图 ......................................................................................... 17 图 10：(U)SIM 卡接口的引脚分配 ........................................................................................................... 18 图 11：UART 转 USB Type-C 接口.......................................................................................................... 19 图 12：天线接口...................................................................................................................................... 20 图 13：开关、按键和指示灯 .................................................................................................................... 20 图 14：测试点 ......................................................................................................................................... 21 图 15：PC 设备管理器界面中的 USB 设备.............................................................................................. 25 图 16：QCOM 上的 COM 端口设置字段（USB AT 端口连接）............................................................... 25 图 17：AT 命令使用实例.......................................................................................................................... 26 图 18：固件升级配置............................................................................................................................... 27 上海移远通信技术股份有限公司 7 / 29 RG200U-CN-MINIPCIE EVB 用户指导 1 引言 移远通信提供了一整套 RG200U-CN-MINIPCIE EVB 评估套件，用于开发基于 RG200U-CN Mini PCIe 模块的应用程序和测试模块的基本功能。本文档详细介绍了 RG200U-CN-MINIPCIE EVB 的基本信息并提 供其使用指导。 上海移远通信技术股份有限公司 8 / 29 RG200U-CN-MINIPCIE EVB 用户指导 2 产品综述 2.1. 俯视图与底视图 RG200U-CN-MINIPCIE EVB 的尺寸为 146 mm × 168 mm。俯视图与底视图如下所示： 图 1：俯视图 上海移远通信技术股份有限公司 9 / 29 RG200U-CN-MINIPCIE EVB 用户指导 图 2：底视图 上海移远通信技术股份有限公司 10 / 29 2.2. 器件分布图 RG200U-CN-MINIPCIE EVB 用户指导 D0202 POWER_LED LED_WWAN# D0206 S0101 ON S0201 OFF J0201 U0203 U0202 U0201 RESET VCC_EXT GND 1 2 3 4 5 J0105 U0301 L0201 L0203 L0202 USB TypeC J0301 J0703 VCC GND J0106 1 2 3 4 5 J0104 1 2 3 4 5 J0103 USB TypeB USIM 1 J0502 card USIM 2 J0501 card USB TypeC J0402 U0403 U0404 USB TypeC J0401 U0401 U0402 J0101 U0801 60 Pin J0702 J0701 60 Pin Mini PCIe 1 2 3 4 5 J0403 1 2 3 4 5 J0404 S0801 J0608 J0602 J0603 J0607 图 3：器件分布俯视图 表 1：接口与功能 接口 位号 电源供电 J0201 J0301 电源开关 S0201 描述 ⚫ EVB电源插孔 ⚫ 典型电压：+5 V/ 3 A ⚫ USB Type-C接口 ⚫ 典型电压：+5 V ⚫ ON：EVB系统上电 ⚫ OFF：EVB系统断电 上海移远通信技术股份有限公司 11 / 29 RG200U-CN-MINIPCIE EVB 用户指导 Mini PCIe接口 复位 USB接口 拨码开关 (U)SIM 卡 UART 转 USB Type-C 接口 天线接口 状态指示灯 J0101 S0101 J0301 S0801 J0502 J0501 J0401 J0402 J0602 J0603 J0607 J0608 D0202 D0206 标准PCI Express Mini Card接口 模块复位 USB Type-C接口，用于数据传输、AT命令通信、软件调试及固件升级 EVB USB 3.0功能控制开关 (U)SIM1 卡连接器 (U)SIM2 卡连接器 主 UART，用于模块和主机之间的数据传输和 AT 命令通信 调试 UART，用于 Linux 控制和部分日志输出 4 个天线接口 模块供电指示灯 模块网络状态指示 表 2：关键特性 参数 供电 Mini PCIe 接口 (U)SIM 卡接口 UART转USB Type-C接口 USB接口 说明 直流电源：+5 V/ 3 A 标准PCI Express Mini Card接口 支持(U)SIM卡：1.8 V和3.0 V COM1 (J0401): ⚫ 主 UART ⚫ 用于数据传输和 AT 命令通信 ⚫ 默认波特率：115200 bps COM2 (J0402): ⚫ 调试 UART ⚫ 用于 Linux 控制和部分日志输出 ⚫ 默认波特率：115200 bps 支持USB 3.0和USB 2.0 上海移远通信技术股份有限公司 12 / 29 信号指示灯 按键和开关 RG200U-CN-MINIPCIE EVB 用户指导 2个用于信号指示的LED灯 ⚫ 电源开关（S0201） ⚫ 复位（S0101） ⚫ EVB USB 3.0功能控制开关（S0801） 上海移远通信技术股份有限公司 13 / 29 RG200U-CN-MINIPCIE EVB 用户指导 3 应用接口 本章主要描述 RG200U-CN-MINIPCIE EVB 的硬件接口以及相关按键、开关、状态指示灯和测试点信 息。 3.1. 电源供电接口 RG200U-CN-MINIPCIE EVB 可通过电源插孔使用外部电源适配器或直接使用 USB Type-C 接口进行 供电。 表 3：电源描述 位号 J0201 J0301 描述 EVB 电源插孔 USB Type-C 接口 下图是简化后的供电框图和供电接口示意图： J0201 电源接口 J0301 Type-C 接口 S0201 电源开关 U0201 3.8 V J0101 DC-DC Mini PCIe 接口 U0202 3.3 V DC-DC U0203 1.8 V DC-DC J0701&J0702 图 4：EVB 电源框图 上海移远通信技术股份有限公司 14 / 29 RG200U-CN-MINIPCIE EVB 用户指导 J0201 5 V 电源接口 J0301 USB Type-C接口 图 5：EVB 供电接口 如果使用电源插座（J0201）供电，则适配器的电源插头设计如下图所示： 内部连接 外部连接 图 6：电源插头设计 3.2. Mini PCIe 接口 Mini PCIe 接口用于安装 RG200U-CN Mini PCIe 模块。可通过该接口来测试模块功能或基于模块来开 发应用程序。 表 4：Mini PCIe 接口描述 位号 J0101 描述 标准 PCI Express Mini Card 接口 上海移远通信技术股份有限公司 15 / 29 RG200U-CN-MINIPCIE EVB 用户指导 Mini PCIe 模块 图 7：Mini PCIe 接口 3.3. USB 接口 RG200U-CN-MINIPCIE EVB提供了USB Type-C接口，支持USB 3.0和USB 2.0，可将EVB与客户设备 相连接。USB接口可用于数据传输、AT命令通信、软件调试及固件升级；也可作为电源接口，为EVB供电。 表 5：USB 接口描述 位号 J0301 描述 ⚫ USB Type-C 接口 ⚫ 电源供电接口 J0301 USB Type-C 接口 图 8：USB Type-C 接口 上海移远通信技术股份有限公司 16 / 29 RG200U-CN-MINIPCIE EVB 用户指导 J0301 USB_SS_TX_P USB_SS_TX_M USB_SS_RX_P USB_SS_RX_M USB_DM USB_DP USB Type-C U0301 HD3SS3220 U0801 USB_SS_TX_P USB_SS_TX_M PI3PCIE3413A USB_SS_RX_P USB_SS_RX_M 0Ω USB_DM 0Ω USB_DP TP00307(DP) TP0302(DM) TP0306(GND) J0101 Mini PCIe接口 图 9：模块与 USB Type-C 接口的连接示意图 3.4. (U)SIM 卡接口 RG200U-CN-MINIPCIE EVB 提供了两个 8 针推入式(U)SIM 卡（1.8/ 3.0 V）接口。 表 6：(U)SIM 卡接口描述 位号 J0502 J0501 描述 (U)SIM1 卡连接器 (U)SIM2 卡连接器 以下图表介绍了 J0501 和 J0502 的引脚分配与引脚定义： 上海移远通信技术股份有限公司 17 / 29 RG200U-CN-MINIPCIE EVB 用户指导 J0502 USIM1 卡接口 CD C4 C8 C3 C7 C2 C6 C1 C5 J0501 USIM2 卡接口 CD C4 C8 C3 C7 C2 C6 C1 C5 图 10：(U)SIM 卡接口的引脚分配 表 7：J0501 和 J0502 引脚定义 引脚号 引脚名 I/O C1 VDD PO C2 RST DO C3 CLK DO C4 RESERVED - C5 GND - C6 VPP - C7 DATA DIO C8 RESERVED - CD DET DI 描述 (U)SIM 卡电源 (U)SIM 卡复位 (U)SIM 卡时钟 未连接 地 未连接 (U)SIM 卡数据 未连接 (U)SIM 卡插拔检测 3.5. UART RG200U-CN-MINIPCIE EVB 提供了两组 UART，默认波特率为 115200 bps。主 UART 用于模块和主 机之间的数据传输和 AT 命令通信，调试 UART 用于 Linux 控制和部分日志输出。 上海移远通信技术股份有限公司 18 / 29 表 8：UART 描述 位号 J0401 J0402 描述 主UART转USB Type-C接口 调试UART转USB Type-C接口 RG200U-CN-MINIPCIE EVB 用户指导 J0402 调试UART J0401 主UART 图 11：UART 转 USB Type-C 接口 3.6. 天线接口 RG200U-CN-MINIPCIE EVB支持600~6000 MHz天线，可接入4个天线接口中的任意一个。具体接口 描述如下： 表 9：天线接口描述 位号 J0608 J0602 J0603 J0607 接口名称 ANT3 ANT2 ANT1 ANT0 描述 天线接口ANT3 天线接口ANT2 天线接口ANT1 天线接口ANT0 上海移远通信技术股份有限公司 19 / 29 RG200U-CN-MINIPCIE EVB 用户指导 J0608 J0602 J0603 J0607 图 12：天线接口 3.7. 开关、按键和指示灯 RG200U-CN-MINIPCIE EVB 提供了 2 个开关、1 个按键和 2 个指示灯，如下所示： S0201 D0206 D0202 S0101 1 2 34 高 S0801 低 图 13：开关、按键和指示灯 上海移远通信技术股份有限公司 20 / 29 RG200U-CN-MINIPCIE EVB 用户指导 表 10：开关、按键和指示灯描述 位号 S0201 S0101 引脚 1、2 S0801 引脚 3 引脚 4 D0202 D0206 功能描述 电源开关，用于控制模块上下电 复位按键，用于复位模块 EVB USB 3.0 功能控制开关； ⚫ 引脚 1、2 都拨到低：U0801 为高阻态，USB 3.0 功能关闭 ⚫ 引脚 1、2 都拨到高：USB 3.0 功能打开 ⚫ 引脚 1 拨到高、引脚 2 拨到低：供移远通信内部使用 ⚫ 引脚 1 拨到低、引脚 2 拨到高：供移远通信内部使用 供移远通信内部使用 供移远通信内部使用 模块供电指示灯； ⚫ 灯亮：模块已上电 ⚫ 灯灭：模块未上电 模块网络状态指示灯； ⚫ 慢闪（200 ms 低/ 1800 ms 高）：找网状态 ⚫ 慢闪（1800 ms 低/ 200 ms 高）：待机状态 ⚫ 快闪（125 ms 低/ 125 ms 高）：数据传输模式 ⚫ 低电平：通话中 3.8. 测试点 RG200U-CN-MINIPCIE EVB提供了一系列测试点来帮助获取特定信号对应的波形，如下所示： J0105 1 2 3 4 5 J0104 1 2 3 4 5 J0103 1 2 3 4 5 J0403 1 2 3 4 5 J0404 1 2 3 4 5 图 14：测试点 上海移远通信技术股份有限公司 21 / 29 表 11：测试点描述 位号及引脚号 1 2 J0103 3 4 5 1 2 J0104 3 4 5 1 2 J0105 3 4 5 1 2 J0403 3 4 5 1 J0404 2 3 引脚名 GND WAKEUP_IN WAKEUP_OUT VDD_EXT RESET_N GND B_CODE B_CODE_5V WLAN_EN W_DISABLE GRFC1 GRFC2 RTS_RESET PWR_3V3 PWR_1V8 MAIN_UART_RXD MAIN_UART_TXD MAIN_UART_DTR MAIN_UART_RTS GND DBG_TXD DBG_RXD TXD_3V3 RG200U-CN-MINIPCIE EVB 用户指导 描述 地 睡眠/唤醒模块 唤醒主机 外部电路1.8 V电源 复位 地 B码输出 供移远通信内部使用 WLAN使能 飞行模式使能 通用射频控制 通用射频控制 供移远通信内部使用 3.3 V电源 1.8 V电源 1.8 V主UART接收 1.8 V主UART发送 供移远通信内部使用 供移远通信内部使用 地 1.8 V调试UART发送 1.8 V调试UART接收 3.3 V调试UART发送 上海移远通信技术股份有限公司 22 / 29 4 RXD_3V3 5 GND RG200U-CN-MINIPCIE EVB 用户指导 3.3 V调试UART接收 地 上海移远通信技术股份有限公司 23 / 29 RG200U-CN-MINIPCIE EVB 用户指导 4 操作说明 本章介绍了 RG200U-CN-MINIPCIE EVB 的操作流程。在操作前，请确保模块和 EVB 组装正确。 4.1. 模块开机 1. 将 RG200U-CN Mini PCIe 插入 EVB 的 Mini PCIe 接口（J0101）中并用螺钉固定，然后连接天线。 2. 将 5 V/ 3 A 的电源适配器接入电源插孔（J0201）。 3. 将电源开关（S0201）拨到'ON'侧，POWER_LED（D0202）亮起，表示 EVB 上电，模块将自 动开机。模块开机完成后，LED_WWAN#（D0206）亮起。 4.2. 模块关机 推荐通过AT+QPOWD使模块关机，这是最好最安全的方法。模块在关机前会从网络注销并保存数据。 关于AT命令的更多详情，请参考文档 [3]。 4.3. USB 接口通信 1. 在 PC 上安装对应的 USB 驱动程序，详情请参考文档 [1]。通过 USB 3.0 Type-C 线缆，将 USB Type-C 接口（J0301）与 PC 相连。 2. 按照第 4.1 章的步骤将模块开机。模块完全启动后，PC 端的设备管理器中会出现对应的 USB 设 备，如下图所示： 上海移远通信技术股份有限公司 24 / 29 RG200U-CN-MINIPCIE EVB 用户指导 图 15：PC 设备管理器界面中的 USB 设备 3. 安装并使用移远通信提供的 QCOM 工具。选择正确的'COM Port'（USB AT 端口号）和波特 率，然后点击'Open Port'。有关 QCOM 使用详情，请参考文档 [2]。 图 16：QCOM 上的 COM 端口设置字段（USB AT 端口连接） 4. USB AT 端口成功打开后，可通过 USB 与模块通信。通过 QCOM 工具发送 AT 命令，得到模块的 响应，如下图所示。有关 AT 命令详情，请参考文档 [3]。 上海移远通信技术股份有限公司 25 / 29 RG200U-CN-MINIPCIE EVB 用户指导 图 17：AT 命令使用实例 4.4. 固件升级 模块默认通过 USB 端口实现固件升级，具体步骤如下： 1. 按照第 4.1 章的步骤将模块开机。 2. 通过 QCOM 工具打开 USB AT 端口，发送 AT+QDOWNLOAD=1 使模块进入下载模式。有关 AT 命令详情，请参考文档 [3]。 3. 安装并打开移远通信提供的 QFlash 固件升级工具。 4. 点击'COM Port'下拉列表，在设备管理器中选择对应的端口号并选择波特率，如下图所示： 上海移远通信技术股份有限公司 26 / 29 RG200U-CN-MINIPCIE EVB 用户指导 图 18：固件升级配置 5. 点击'Load FW Files'，选择并加载固件包。 6. 点击'Start'，启动固件升级。 有关 QFlash 使用和配置的详细信息，请参考文档 [4]。 4.5. 模块复位 按下 RESET_N（S0101）可复位模块，此操作将导致调制解调器中所有数据的丢失和系统驱动程序的 移除，还将断开调制解调器与网络的连接。因此复位仅在紧急或异常情况下使用。例如，由于一些严重的 问题导致软件响应时间超过 5 秒。 上海移远通信技术股份有限公司 27 / 29 RG200U-CN-MINIPCIE EVB 用户指导 5 参考文档及术语缩写 表 12：参考文档 文档名称 [1] Quectel_LTE&5G_Windows_USB_Driver_Installation_Guide [2] Quectel_QCOM_User_Guide [3] Quectel_RGx00U&RM500U 系列_AT 命令手册 [4] Quectel_QFlash_用户指导 表 13：术语缩写 缩写 英文全称 中文全称 DI Digital Input 数字输入 DO EVB Digital Output Evaluation Board 数字输出 评估板 GND I/O Ground Input/Output 地 输入/输出 LED Light Emitting Diode 发光二极管 LTE Long Term Evolution PC Private Computer 长期演进 个人电脑 PCB Printed Circuit Board 印刷电路板 PO UART Power Output 电源输出 Universal Asynchronous Receiver & Transmitter 通用异步收发传输器 USB Universal Serial Bus 通用串行总线 上海移远通信技术股份有限公司 28 / 29 (U)SIM WLAN (Universal) Subscriber Identity Module Wireless Local Area Network RG200U-CN-MINIPCIE EVB 用户指导 （通用）用户身份识别模块 无线局域网 上海移远通信技术股份有限公司 29 / 29

RTA001-EV EVB User Guide 5G Module Series Version: 1.0 Date: 2022-06-24 Status: Released 5G Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide schematic designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. RTA001-EV_EVB_User_Guide 1 / 45 5G Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. RTA001-EV_EVB_User_Guide 2 / 45 5G Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. RTA001-EV_EVB_User_Guide 3 / 45 5G Module Series About the Document Revision History Version 1.0 Date 2022-06-20 2022-06-24 Author Murray YIN Murray YIN Description Creation of the document First official release RTA001-EV_EVB_User_Guide 4 / 45 5G Module Series Contents Safety Information....................................................................................................................................... 3 About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 7 Figure Index ................................................................................................................................................. 8 1 Introduction .......................................................................................................................................... 9 1.1. Applicable Modules ..................................................................................................................... 9 2 Product Overview .............................................................................................................................. 10 2.1. Top and Bottom Views .............................................................................................................. 10 2.2. Component Placement of RTA001-EV EVB ............................................................................. 12 3 Kit Accessories .................................................................................................................................. 16 3.1. List of Accessories .................................................................................................................... 16 4 Application Interfaces ....................................................................................................................... 17 4.1. Power Supply ............................................................................................................................ 18 4.2. Module TE-A Interface .............................................................................................................. 19 4.3. PHY TE-A Interface ................................................................................................................... 20 4.4. AP TE-A Interface ..................................................................................................................... 21 4.5. USB Interface............................................................................................................................ 22 4.6. Audio Interfaces ........................................................................................................................ 23 4.6.1. Digital Audio Codec Board Connector ........................................................................... 23 4.6.2. Analog Audio Interfaces ................................................................................................. 25 4.6.3. Loudspeaker Interface ................................................................................................... 25 4.6.4. Earphone Interface......................................................................................................... 25 4.7. (U)SIM Card Interfaces ............................................................................................................. 27 4.8. SD Card Interface ..................................................................................................................... 29 4.9. UART Interfaces........................................................................................................................ 31 4.10. PCIe-to-USB Interface .............................................................................................................. 32 4.11. Switches and Buttons ............................................................................................................... 34 4.12. Status Indicators ....................................................................................................................... 36 4.13. Wi-Fi TE-A Interface.................................................................................................................. 37 4.14. Antenna Interfaces .................................................................................................................... 40 5 Operation Procedures ....................................................................................................................... 41 5.1. Turn On the Module .................................................................................................................. 41 5.2. Turn Off the Module .................................................................................................................. 41 5.3. Communication Via USB .......................................................................................................... 42 5.4. Firmware Upgrade .................................................................................................................... 42 5.4.1. Emergency Download .................................................................................................... 43 5.4.2. Normal Download........................................................................................................... 43 5.5. Reset the Module ...................................................................................................................... 43 RTA001-EV_EVB_User_Guide 5 / 45 5G Module Series 6 Appendix References ........................................................................................................................ 44 RTA001-EV_EVB_User_Guide 6 / 45 5G Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 9 Table 2: Components and Functions ......................................................................................................... 13 Table 3: List of Accessories........................................................................................................................ 16 Table 4: Description of Power Supply ........................................................................................................ 18 Table 5: Description of Module TE-A Interface .......................................................................................... 19 Table 6: Description of PHY TE-A Interface ............................................................................................... 20 Table 7: PHY TE-A Configuration Switch ................................................................................................... 20 Table 8: Description of AP TE-A Interface.................................................................................................. 21 Table 9: AP TE-A Configuration Switch ...................................................................................................... 22 Table 10: Description of USB Interface ...................................................................................................... 22 Table 11: Description of Digital Audio Codec Board Connector................................................................. 23 Table 12: Codec TE-A Configuration Switch .............................................................................................. 24 Table 13: Description of Analog Audio Interfaces ...................................................................................... 25 Table 14: Pin Definition of J1001 ............................................................................................................... 26 Table 15: Description of (U)SIM Card Interfaces ....................................................................................... 28 Table 16: Pin Definition of J1501/J1502..................................................................................................... 28 Table 17: Description of SD Card Interface ............................................................................................... 29 Table 18: SDIO Switch Function ................................................................................................................ 30 Table 19: Description of UART Interfaces .................................................................................................. 31 Table 20: Description of PCIe-to-USB Interface ........................................................................................ 33 Table 21: PCIe Connection Truth Table ..................................................................................................... 33 Table 22: Description of Switches and Buttons.......................................................................................... 36 Table 23: Description of Status Indication LEDs........................................................................................ 37 Table 24: Description of Wi-Fi TE-A Interface ............................................................................................ 37 Table 25: Wi-Fi TE-A Configuration Switch ................................................................................................ 39 Table 26: Related Documents .................................................................................................................... 44 Table 27: Terms and Abbreviations ............................................................................................................ 44 RTA001-EV_EVB_User_Guide 7 / 45 5G Module Series Figure Index Figure 1: Top View...................................................................................................................................... 10 Figure 2: Bottom View .................................................................................................................................11 Figure 3: Top View for Component Placement .......................................................................................... 12 Figure 4: Bottom View for Component Placement..................................................................................... 13 Figure 5: Block Diagram of EVB Power Supply......................................................................................... 18 Figure 6: EVB Power Supply Interface ...................................................................................................... 19 Figure 7: Connection Between Module TE-A and EVB ............................................................................. 19 Figure 8: Connection Between PHY8211 TE-A and EVB.......................................................................... 20 Figure 9: S1801/S1802 Switch................................................................................................................... 21 Figure 10: Connection Between IPQ 8074A TE-A and EVB ..................................................................... 21 Figure 11: S2701/S2702/S2703/S1601 ..................................................................................................... 22 Figure 12: USB Interface Connection ........................................................................................................ 23 Figure 13: Connection Between Codec TE-A and EVB............................................................................. 24 Figure 14: S2501 Switch ............................................................................................................................ 24 Figure 15: Reference Circuit Design for Loudspeaker Interface J0901 .................................................... 25 Figure 16: Reference Circuit Design for Earphone Interface J1001.......................................................... 26 Figure 17: Pin Assignment of J1001 .......................................................................................................... 26 Figure 18: Schematic of Audio Plug........................................................................................................... 27 Figure 19: Simplified Schematic for (U)SIM Card Connectors .................................................................. 27 Figure 20: Pin Assignment of (U)SIM Card Connectors J1501/J1502 ...................................................... 28 Figure 21: Simplified Schematic for J1401 ................................................................................................ 29 Figure 22: S2401 Switch ............................................................................................................................ 30 Figure 23: Pin Assignment of SD Card Connector J1401 ......................................................................... 30 Figure 24: UART Block Diagram ................................................................................................................ 31 Figure 25: Main UART Interface (J2002) ................................................................................................... 32 Figure 26: Debug UART Interface (J2005) ................................................................................................ 32 Figure 27: PCIe Block Diagram.................................................................................................................. 33 Figure 28: S1601 Switch ............................................................................................................................ 33 Figure 29: S0301 and S2401 Switches...................................................................................................... 34 Figure 30: S1601/S1802 Switch and S0201 Button .................................................................................. 34 Figure 31: S0202/S0203 Button................................................................................................................. 35 Figure 32: S1801/S2501 Switch ................................................................................................................ 35 Figure 33: S2701/S2702/S2703 Switch ..................................................................................................... 35 Figure 34: Status Indicators ....................................................................................................................... 36 Figure 35: Connection Between WCN6856 TE-A and EVB ...................................................................... 38 Figure 36: Simplified Schematic for WCN6856 TE-A Interface ................................................................. 38 Figure 37: S2701/S2702/S2703/S1601 ..................................................................................................... 39 Figure 38: Antenna Interfaces .................................................................................................................... 40 Figure 39: USB Ports ................................................................................................................................. 42 Figure 40: COM Port Setting of QCOM (USB AT Port Connection) .......................................................... 42 Figure 41: USB Port in PC Device Manager.............................................................................................. 43 RTA001-EV_EVB_User_Guide 8 / 45 5G Module Series 1 Introduction This user guide describes the application details of the RTA001-EV EVB (Evaluation Board), which is an assistant tool for you to develop applications and test basic functionalities of 5G module series. 1.1. Applicable Modules Quectel RTA001-EV EVB is applicable to the following modules: Table 1: Applicable Modules Module Series RG50xQ RG5x0F RG520N RG525F-NA Module RG500Q Series RG501Q-EU RG502Q Series RG520F Series RG530F Series RG520N-NA/-EU/-EB RG525F-NA RTA001-EV_EVB_User_Guide 9 / 45 5G Module Series 2 Product Overview 2.1. Top and Bottom Views The size of RTA001-EV EVB is 235 mm × 190 mm, and the top and bottom views are as shown below: Figure 1: Top View RTA001-EV_EVB_User_Guide 10 / 45 5G Module Series Figure 2: Bottom View RTA001-EV_EVB_User_Guide 11 / 45 5G Module Series 2.2. Component Placement of RTA001-EV EVB ANT0 USIM1 J1501 card ANT_GNSS L1L5 60 Pins J1902 PH Y-TE-A J1901 60 Pins RGMII_SEL1 RGMII_SEL2 S1801 SPK J0901 J0902 J0903 3.3 RGMII_SEL3 S1802 RESET S0201 S1601 PCIE_SEL1 PCIE_SEL2 60 Pins J0801 WIFI-TE-A J0802 J2002 J2004 60 Pins D0205 SLEEP D0204 NET_STATUS D0203 NET_MODE D0202 STATUS D0201 POWER I2S_WS I2S_DIN I2S_DOUT J2303 I2S_SCK MCLK GND CODECTE-A S2501 GND J2311 J0103 SPI1_CLK SPI1_CS SPI1_MOSI SPI1_MISO J0904 SLIC_SEL2 SLIC_SEL1 J0905 60 Pins J1301 J0206 I2C3_SDA I2C3_SCL J0203 GND PON_1 1V8 USB_BOOT PS_HOLD J0202 S0203 ANT_WIFI0 J2346 J2308 ANT7 J2315 J0102 140 Pins Module TE-A J2348 ANT_GNSS L1 ANT6 J0101 140 Pins J2317 ANT5 PCIe to USB U1701 J2701 High S2701 Low PWRKEY S0202 S2702 J0302 S2703 SDIO_SWITCHVBAT_MODULE S2401 J2101 100 Pins AP-TE-A J2102 100 Pins ANT_WIFI1 J2347 J2307 ANT4 REG_1V8 AP_4.2 UART_3V3 WDISABLE_3.3V PWRKEY_3.3V PWRKEY_3.3V RTS_TEST 3.8V_EN J0502 RESET_3.3V GND J0501 Adapter REG_3V3 VCC_3V8 GND OFF S0301 ON USB Type-C J1201 ANT2 GND RX TX AP_DBG_UART High Low J0301 J1101 J2001 USB_Switch J2304 DTR_TEST DTR_TEST EFUSE_PWRKEY ANT1 RTS_TEST J2312 J2318 ANT3 Figure 3: Top View for Component Placement RTA001-EV_EVB_User_Guide 12 / 45 5G Module Series EARPHONE J1001 USIM2 card J1502 J2002 MAIN_UART J2005 DBG_UART J0303 5 V/3 A J1401 ADAPTER SD card Figure 4: Bottom View for Component Placement Table 2: Components and Functions Components Power supply Power switch PWRKEY PON USB_BOOT RESET RefDes. J0303 S0301 S0202 J0203 S0203 S0201 Description ⚫ The power jack on the EVB ⚫ Typical supply voltage: 5 V/ 3 A VBAT on/off control ⚫ Power key (push button) ⚫ Turn on/off the module Auto-power on control Emergency download control ⚫ Reset button (push button) RTA001-EV_EVB_User_Guide 13 / 45 5G Module Series ⚫ Reset the module USB interface J1201 PCIe-to-USB interface U1701 PCIe configuration switch S1601 SDIO configuration switch S2401 ⚫ USB Type-C interface ⚫ Support USB 3.0/3.1 and USB 2.0 PCIe-to-USB interface, not enabled by default Configure the module communication with different devices via PCIe signals Switch between SD card and eMMC RGMII configuration switch S1801, S1802 Configure RGMII Codec configuration switch S2501 Configure codec Wi-Fi configuration switch Wi-Fi clock signal configuration switch Wi-Fi sleep clock signal configuration switch S2701 S2702 S2703 Audio interfaces J0905 J0901 Configure Wi-Fi Select to provide clock signal to Wi-Fi or AP Select to provide a sleep clock signal to Wi-Fi or AP ⚫ Codec board TE-A connector ⚫ Support ALC5616 TE-A and TLV320AIC3104 TE-A codec boards Designed for loudspeaker J1001 Audio jack for earphone (U)SIM card interfaces J1501 J1502 Support dual (U)SIM cards: 1.8 V and 2.95 V SD card interface Main UART Debug UART Status indicators J1401 J2002 J2005 D0201 D0202 D0203 SD card connector ⚫ Main UART for data communication ⚫ Default baud rate: 115200 bps ⚫ Debug UART for debugging ⚫ Default baud rate: 115200 bps Power supply on/off indicator, indicating whether the module’s power supply is on or off. On: VBAT on Off: VBAT off Module operation status indicator, indicating whether the module is powered on. On: the module is powered on Off: the module is powered off Network registration mode indicator, indicating the module’s NET_MODE status. RTA001-EV_EVB_User_Guide 14 / 45 Module TE-A interface PHY TE-A interface Wi-Fi TE-A interface AP TE-A interface Antenna interfaces 5G Module Series D0204 D0205 Network activity status indicator, indicating the module’s NET_STATUS status. Sleep mode indicator, indicating the module’s SLEEP status. J0101, J0102 Module TE-A connectors ⚫ PHY TE-A connectors J1901, J1902 ⚫ Support PHY8211 and AR8035 J0801, J0802 Wi-Fi TE-A connectors J2101, J2102 J2303, J2304, J2307, J2308, J2311, J2312, J2315, J2317, J2318, J2346, J2347, J2348 ⚫ AP TE-A connectors ⚫ Support IPQ8074A TE-A and QPS615 TE-A Antenna connectors RTA001-EV_EVB_User_Guide 15 / 45 5G Module Series 3 Kit Accessories 3.1. List of Accessories All accessories of the RTA001-EV EVB kit are listed below. Please contact the supplier if there is something missing. Table 3: List of Accessories Items Description Quantity (pcs) USB to RS-232 converter cable 1 Cables USB Type-A to Type-B converter cable 1 USB Type-C cable 1 RF cables 9 Wi-Fi antenna 2 Antennas Cellular antenna 8 GNSS antenna (passive) 2 Audio Earphone 1 USB driver Module’s related documents, tools & drivers, etc. 1 Codec TE-A ALC5616, TLV320AIC3104 2 Screws Used to fasten TE-As on the EVB 8 Instruction sheet PCIe-to-USB adapter A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. PCIe signal is transferred through USB 3.0 1 connector, not used by default. Bolts and nuts Bolts and nuts for assembling the EVB 4 pairs Power adapter 5 V/ 3 A power adapter 1 RTA001-EV_EVB_User_Guide 16 / 45 5G Module Series 4 Application Interfaces This chapter describes the hardware interfaces of the RTA001-EV EVB, as listed below: ⚫ Power supply ⚫ Module TE-A interface ⚫ PHY TE-A interface ⚫ AP TE-A interface ⚫ USB interface ⚫ Audio interfaces - Digital audio codec board connector - Analog audio interfaces - Loudspeaker interface - Earphone interface ⚫ (U)SIM card interfaces ⚫ SD card interface ⚫ UART interfaces ⚫ PCIe-to-USB interface ⚫ Wi-Fi TE-A interface ⚫ Antenna interfaces It also provides information about the buttons, switches and status indication LEDs to help you use the EVB. RTA001-EV_EVB_User_Guide 17 / 45 5G Module Series 4.1. Power Supply The RTA001-EV EVB can be powered by an external power adapter through the power jack. Table 4: Description of Power Supply RefDes. J0303 Description DC power supply: 4.5–5.5 V Typical supply voltage: 5 V/ 3 A The following two figures display a simplified power supply block diagram and the power supply interface of RTA001-EV EVB. J0303 Power Jack 5V/3A REG_3V3 5 V U2201 SGM61133 U2202 MP2145 1.5 V 0.9 V Wi-Fi AP AP U0601 MP2145 U2402 TLV75518 U2403 XC6227C301 U0701 MP1605 0.9 V 1.8 V 3.0 V 2.7 V AP/Wi-Fi eMMC eMMC Level Shift U0702 MP1605 2.5 V RGMII U0301 SGM40666 U2004 TLV75533 U0506 SGM61133 U0302 SY81012VDC U0504 SGM61133 U0604 SGM2205 U0602 TLV75533 5 V 3.3 V 4.2 V System Power UART AP 3.8 V Module REG_1V8 RGMII/Wi-Fi/ Level Shift/ADC/ Codec, etc. 1.95 V Wi-Fi 3.8 V Sensor U0603 SGM2037 U0502 SGM61133 U0503 ISL80101 U0505 TPS728180285 1.35 V REG_3V3 SD_3V SDIO Wi-Fi PHY/Wi-Fi/Level Shift/USB&PCIe Switch/Analog Switch/Multiplexer/ Codec, etc. SD Card SD Card Figure 5: Block Diagram of EVB Power Supply RTA001-EV_EVB_User_Guide 18 / 45 5G Module Series Figure 6: EVB Power Supply Interface 4.2. Module TE-A Interface Module TE-A interface is designed to accommodate the TE-A of the module. The TE-A is mounted onto and connected to the EVB via BTB connectors J0101 and J0102 (insert as indicated by the arrow to prevent reverse insertion). You can test the functionalities of the module easily through this interface. Table 5: Description of Module TE-A Interface RefDes. J0101 J0102 Description Module TE-A connectors The following figure displays the connection between the module TE-A and the EVB. Figure 7: Connection Between Module TE-A and EVB RTA001-EV_EVB_User_Guide 19 / 45 5G Module Series 4.3. PHY TE-A Interface PHY TE-A interface is designed to accommodate the PHY TE-A (PHY8211 TE-A). The PHY TE-A is mounted onto and connected to the EVB via BTB connectors J1901 and J1902 (insert as indicated by the arrow to prevent reverse insertion). Table 6: Description of PHY TE-A Interface RefDes. J1901 J1902 Description ⚫ PHY TE-A connectors ⚫ Support PHY8211 and AR8035 The following figures display the connection between PHY8211 TE-A and EVB. Figure 8: Connection Between PHY8211 TE-A and EVB Table 7: PHY TE-A Configuration Switch RGMII_SEL1 Low High High RGMII_SEL2 High Low High RGMII_SEL3 1.8 V 2.5 V 1.8 V Function AR8035 RGMII IO 1.8 V AR8035 RGMII IO 2.5 V PHY8211 RGMII IO 1.8 V RTA001-EV_EVB_User_Guide 20 / 45 5G Module Series Figure 9: S1801/S1802 Switch 4.4. AP TE-A Interface AP TE-A interface is designed to accommodate the AP TE-A (IPQ8074A TE-A/QPS615 TE-A). The AP TE-A is mounted onto and connected to the EVB via BTB connectors J2101 and J2102 (insert as indicated by the arrow to prevent reverse insertion). Table 8: Description of AP TE-A Interface RefDes. J2101 J2102 Description ⚫ AP TE-A connectors ⚫ Support IPQ8074A TE-A and QPS615 TE-A The following figures display the connection between IPQ8074A TE-A and EVB. Figure 10: Connection Between IPQ 8074A TE-A and EVB RTA001-EV_EVB_User_Guide 21 / 45 5G Module Series Table 9: AP TE-A Configuration Switch S2701 Wi-Fi Wi-Fi/AP AP S2702 Wi-Fi AP AP S2703 Wi-Fi AP AP PCIE_SEL1 PCIE_SEL2 High High High Low High Low Function Module → Wi-Fi Module → QPS615 TE-A Module → IPQ8074 TE-A S2701 S2702 S2703 S1601 Figure 11: S2701/S2702/S2703/S1601 4.5. USB Interface A USB Type-C connector, which complies with USB 3.0/3.1 and USB 2.0 standard, is provided. This USB interface is used for AT command communication, data transmission and firmware upgrade. Table 10: Description of USB Interface RefDes. J1201 Description ⚫ USB Type-C interface ⚫ Support USB 3.0/3.1 and USB 2.0 RTA001-EV_EVB_User_Guide 22 / 45 5G Module Series Figure 12: USB Interface Connection 4.6. Audio Interfaces Quectel RTA001-EV EVB provides one digital audio codec board interface (I2S) J0905 and two analog audio interfaces J1001 and J0901. 4.6.1. Digital Audio Codec Board Connector The RTA001-EV EVB supports two different external digital audio codec TE-As named ALC5616 and TLV320AIC3104. The codec circuit is assembled on an independent small board which can be interconnected with the EVB by the BTB connector J0905. Table 11: Description of Digital Audio Codec Board Connector RefDes. J0905 Description ⚫ Codec board TE-A connector ⚫ Support ALC5616 TE-A and TLV320AIC3104 TE-A codec boards Codecs can be selected according to specific application demands, the following two figures display the connection between digital audio codec TE-A and the EVB. RTA001-EV_EVB_User_Guide 23 / 45 5G Module Series Figure 13: Connection Between Codec TE-A and EVB S2501: Codec configuration switch MODEM: Codec connected to the module AP: Codec connected to the AP Figure 14: S2501 Switch Table 12: Codec TE-A Configuration Switch SLIC_SEL1 SLIC_SEL2 AP High/Low Low NC High Low High High I2S/SPI/RST/INT to SLIC SPI/RST/INT Modem I2S/SPI/RST/INT to SLIC, PCM to Wi-Fi NC PCM to QPS RTA001-EV_EVB_User_Guide 24 / 45 4.6.2. Analog Audio Interfaces Table 13: Description of Analog Audio Interfaces RefDes. J0901 J1001 Description Design for loudspeaker Audio jack for earphone 5G Module Series 4.6.3. Loudspeaker Interface Audio interface J0901 is designed for loudspeaker and the following figure displays a reference design of loudspeaker with an external audio amplifier. J0905 Differential layout Codec LOUDL/P C1 TLV3104 LOUDR/N C2 U0901 Amp l ifie r circuit LM4871 Close to speaker GND FB J0901 FB BTB CON GND Figure 15: Reference Circuit Design for Loudspeaker Interface J0901 4.6.4. Earphone Interface Audio interface J1001 is designed for earphone and the following figure displays a reference circuit design of earphone interface. RTA001-EV_EVB_User_Guide 25 / 45 5G Module Series Differential layout J0905 MIC_N MIC_P Close to Socket GND AGND GND GND GND 10pF 33pF 4.7uF75pF 15pF ES D AG ND Codec 22 uF TLV3104 22uF AG ND SPK_L 1uF SPK_R 1uF BTB CON Close to Socket 10pF 33pF 10pF 33pF ES D GN D 0R NM_0R 2 4 6 5 3 1 J1001 Audio Jack NM_ 0R 0R AG ND MIC_P Figure 16: Reference Circuit Design for Earphone Interface J1001 The figure and table below illustrate the pin assignment and pin definition of earphone interface J1001. Figure 17: Pin Assignment of J1001 Table 14: Pin Definition of J1001 Pin No. 1 2 3 Pin Name MIC AGND SPK_R Description Microphone input Dedicated GND for audio Right channel of stereo audio output RTA001-EV_EVB_User_Guide 26 / 45 5G Module Series 4 SPK_L 5, 6 NC Left channel of stereo audio output Not connected The following figure displays a schematic of audio plug which suits the audio jack on RTA001-EV EVB. 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 18: Schematic of Audio Plug 4.7. (U)SIM Card Interfaces The RTA001-EV EVB has two 8-pin push-push type (U)SIM card (1.8/2.95 V) connectors J1501 and J1502. The following figure displays a simplified schematic for (U)SIM card connectors J1501 and J1502. Module USIM_VDD USIM_RST USIM_CLK USIM_DATA USIM_DET GND Push-Push C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK C7 USIM_DATA (U)SIM card connector C4 RESERVED C8 RESERVED CD USIM_PRESENCE J1501/J1502 Figure 19: Simplified Schematic for (U)SIM Card Connectors RTA001-EV_EVB_User_Guide 27 / 45 5G Module Series Table 15: Description of (U)SIM Card Interfaces RefDes. J1501/J1502 Description Support dual (U)SIM cards: 1.8 V and 2.95 V The figure and table below illustrate the pin assignment and definition of (U)SIM card connectors J1501 and J1502. Figure 20: Pin Assignment of (U)SIM Card Connectors J1501/J1502 Table 16: Pin Definition of J1501/J1502 Pin No. C1 C2 C3 C4 C5 C6 C7 Pin Name USIM_VDD USIM_RST USIM_CLK RESERVED1 GND VPP USIM_DATA I/O PO DO DO DIOO Function (U)SIM card power supply, provided by module (U)SIM card reset (U)SIM card clock Not connected Ground Not connected Data line, bi-directional RTA001-EV_EVB_User_Guide 28 / 45 5G Module Series C8 RESERVED2 - Not connected CD USIM_PRESENCE DI (U)SIM card insertion detection 4.8. SD Card Interface The RTA001-EV EVB provides an SDIO interface, which can be used for connecting SD card. The following figure displays the simplified schematic for J1401. J0101 Modu le U2404 SDIO_COM 6-bit Multiplexer/ Demultiplexer SDIO_NC J1401 SD Card Connector SDIO Switch Figure 21: Simplified Schematic for J1401 Table 17: Description of SD Card Interface RefDes. J1401 Description SD card connector If SD card function needs to be used, switch the SDIO switch to low level illustrated in the figure and table below. A standard SD card can be inserted into J1401 which supports micro SD card of maximum 32 GB. With the SD card interface, you can easily enhance the memory capacity of the module. RTA001-EV_EVB_User_Guide 29 / 45 5G Module Series Figure 22: S2401 Switch Table 18: SDIO Switch Function SDIO Switch Low High Function Enable SD card function Enable eMMC function Figure 23: Pin Assignment of SD Card Connector J1401 ⚫NOTE eMMC is not supported on the applicable modules. RTA001-EV_EVB_User_Guide 30 / 45 5G Module Series 4.9. UART Interfaces The RTA001-EV EVB provides two UART interfaces: main UART J2002 and debug UART J2005, both supporting baud rate of 115200 bps by default. Table 19: Description of UART Interfaces RefDes. J2002 J2005 Description ⚫ Main UART for data communication ⚫ Default baud rate: 115200 bps ⚫ Debug UART for debugging ⚫ Default baud rate: 115200 bps The main UART interface is used for communication between the module and the host application. The debug UART interface is used for Linux console and log output. The following figure diaplays the block diagram of UART interfaces of the EVB. J2002 U2003 RS232 Main UART RS232 Transceiver J2005 Debug UART U2005 USB to UART Bridge U2001 3.3V/1.8V Level Shift 1.8V Q2001 Q2002 3.3V/1.8V Level Shift 1.8V Module J0101 Figure 24: UART Block Diagram RTA001-EV_EVB_User_Guide 31 / 45 5G Module Series Figure 25: Main UART Interface (J2002) Figure 26: Debug UART Interface (J2005) 4.10. PCIe-to-USB Interface The RTA001-EV EVB reserves a PCIe 3.0 signal over USB interface for testing, and this function is not enabled by default. The block diagram is shown as follows. RTA001-EV_EVB_User_Guide 32 / 45 5G Module Series U1701 USB 3.0 AB cable USB 3.0B Wi-Fi AP U1601/U1602 CLK J0101 SEL_1 SEL_2 PCIe Switch TX0/1 RX0/1 Module Figure 27: PCIe Block Diagram Figure 28: S1601 Switch Table 20: Description of PCIe-to-USB Interface RefDes. U1701 Description PCIe-to-USB interface, not enabled by default Table 21: PCIe Connection Truth Table PCIE_SEL1 0 1 1 PCIE_SEL2 1 0 1 Function Module → PC Module → AP Module → Wi-Fi RTA001-EV_EVB_User_Guide 33 / 45 5G Module Series 4.11. Switches and Buttons The RTA001-EV EVB provides nine switches (S0301, S1601, S1801, S1802, S2401, S2501, S2701, S2702 and S2703) and three buttons (S0201, S0202 and S0203), as shown in the following figures. Figure 29: S0301 and S2401 Switches S1601 S0201 S1802 Figure 30: S1601/S1802 Switch and S0201 Button RTA001-EV_EVB_User_Guide 34 / 45 5G Module Series S0202 S0203 Figure 31: S0202/S0203 Button Figure 32: S1801/S2501 Switch S2701 S2702 S2703 Figure 33: S2701/S2702/S2703 Switch RTA001-EV_EVB_User_Guide 35 / 45 5G Module Series Table 22: Description of Switches and Buttons Switches and Buttons Power switch PWRKEY PCIe configuration switch RESET USB_BOOT RGMII configuration switch SDIO configuration switch Codec configuration switch Wi-Fi configuration switch RefDes. Description S0301 VBAT on/off control S0202 S1601 S0201 Power key to turn on/off the module Configure the module communication with different devices via PCIe signals Reset button to reset the module S0203 Emergency download control S1801, S1802 Configure RGMII S2401 Switch between SD card and eMMC S2501 Configure codec S2701, S2702, S2703 Configure Wi-Fi 4.12. Status Indicators There are five status indication LEDs on the EVB. The following figure displays the positions of these LED indicators. D0201 D0202 D0203 D0204 D0205 Figure 34: Status Indicators RTA001-EV_EVB_User_Guide 36 / 45 5G Module Series Table 23: Description of Status Indication LEDs RefDes. D0201 D0202 D0203 D0204 D0205 Description Indicates whether the module’s power supply is on or off. On: VBAT on Off: VBAT off Indicates whether the module is powered on. On: the module is powered on Off: the module is powered off Indicates the module’s NET_MODE status. Indicates the module’s NET_STATUS status. Indicates the module’s SLEEP status. 4.13. Wi-Fi TE-A Interface The Wi-Fi TE-A interface is designed to accommodate the TE-A of Wi-Fi modules (paired with WCN6856). The TE-A is connected to the EVB via BTB connectors J0801 and J0802. The interface allows you to test the Wi-Fi function of the module or to develop applications with Wi-Fi function easily. Table 24: Description of Wi-Fi TE-A Interface RefDes. J0801 J0802 Description Wi-Fi TE-A connectors RTA001-EV_EVB_User_Guide 37 / 45 5G Module Series The following two figures display the connection between WCN6856 TE-A and EVB. Figure 35: Connection Between WCN6856 TE-A and EVB GND PCM BT_UART COEX_UART WLAN_EN BT_EN WLAN_SLEEP_CLK WLAN_PWR_EN2 SDX_TO_WL_CTI WL_TO_SDX_CTI WL_LAA_AS_EN WL_PA_MUTING WL_LAA_RX WL_LAA_TX_EN WL_TX_EN I2C_SDA_BT I2C_SCL_BT J0801 VDD_3V3 VDD_1V8 PCM GND BT_UART GND COEX_UART GND WLAN_EN GND BT_EN GND WLAN_SLEEP_CLK GND VDD_EN SDX_TO_WL_CTI GND WL_TO_SDX_CTI WL_LAA_AS_EN WL_PA_MUTING WL_LAA_RX WL_LAA_TX_EN WL_TX_EN I2C_SDA_BT I2C_SCL_BT GND GND GND PCIe S2_1.224V S3_0.824V S4_1.904V 76.8MHz WCN6856 GND GND GND GND GND GND GND GND GND GND GND PCIe S2_1.224V S3_0.824V S4_1.904V 76.8MHz VDD_3V3 J0802 Figure 36: Simplified Schematic for WCN6856 TE-A Interface RTA001-EV_EVB_User_Guide 38 / 45 5G Module Series Table 25: Wi-Fi TE-A Configuration Switch S2701 Wi-Fi Wi-Fi/AP AP S2702 Wi-Fi AP AP S2703 Wi-Fi AP AP PCIE_SEL1 High High High PCIE_SEL2 High Low Low Function Module → Wi-Fi Module → QPS615 TE-A Module → IPQ8074 TE-A S2701 S2702 S2703 S1601 Figure 37: S2701/S2702/S2703/S1601 RTA001-EV_EVB_User_Guide 39 / 45 5G Module Series 4.14. Antenna Interfaces The RTA001-EV EVB provides 12 antenna interfaces. The following figure displays the assembly of these antenna interfaces. Figure 38: Antenna Interfaces RTA001-EV_EVB_User_Guide 40 / 45 5G Module Series 5 Operation Procedures This chapter introduces how to use the RTA001-EV EVB for testing and evaluating Quectel modules. Ensure module and the EVB are correctly assembled before beginning the following procedures. 5.1. Turn On the Module 1. Connect the module TE-A to the EVB via connectors J0101 and J0102. 2. Insert a (U)SIM card into the USIM1 card connector on EVB. 3. Use RF cable to connect the module TE-A to the EVB, and connect antennas to the EVB. 4. Connect the EVB to a 5 V/ 3 A power and switch S0301 to ON. Then D0201 (on/off indicator of the module’s power supply) will light up. 5. Press the S0202 (PWRKEY) for at least 500 ms and the module will be powered on and D0202 (operation status indicator of the module) will light up. 5.2. Turn Off the Module There are two methods to turn off the module. ⚫ Turn off the module with AT command AT+QPOWD. This is a safer method. The module will log off from the network and save data before shutdown. ⚫ Turn off the module with PWRKEY button (S0202). Long press PWRKEY for at least 800 ms and the module will be powered off. RTA001-EV_EVB_User_Guide 41 / 45 5G Module Series 5.3. Communication Via USB 1. Turn on the module according to the procedures in Chapter 5.1. 2. Connect the EVB and a PC with USB cable through USB Type-C interface, and then run the driver disk on the PC to install the USB driver. For details about USB driver installation, see document [1]. The USB port numbers can be viewed in Device Manager of the PC when the USB driver is installed, as shown below. Figure 39: USB Ports 3. Install and then use QCOM provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting of QCOM: select the correct 'COM Port' (USB AT Port, which is shown in figure above) and set correct 'Baudrate' (e.g. 115200 bps). For more details about QCOM use and configuration, see document [2]. Figure 40: COM Port Setting of QCOM (USB AT Port Connection) 5.4. Firmware Upgrade Firmware of the module is upgraded via USB port by default, and there are two methods for the upgrade: emergency download and normal download. See the following procedures to upgrade firmware through the EVB. RTA001-EV_EVB_User_Guide 42 / 45 5G Module Series 5.4.1. Emergency Download 1. Install the firmware upgrade tool QFlash on PC. 2. Connect the EVB and the PC through USB Type-C cable. 3. Insert the DC power adapter. 4. Press the USB_BOOT button (S0203) and power on the module. 5. Upgrade the firmware with QFlash. See document [3] for details about the use of QFlash. 5.4.2. Normal Download 1. Turn on the module according to the procedures in Chapter 5.1. 2. Wait for the USB port to be found in Device Manager of the PC. Figure 41: USB Port in PC Device Manager 3. Open QFlash and upgrade the firmware. See document [3] for detailed procedures. 5.5. Reset the Module The reset option is only used in case of abnormality. For example, the software fails to respond for more than 5 seconds due to some serious problems. Long press the button S0201 (RESET) for more than 8 seconds, and then release it to reset the module. RTA001-EV_EVB_User_Guide 43 / 45 6 Appendix References Table 26: Related Documents Document Name [1] Quectel_Windows_USB_Driver(Q)_NDIS_Installation_Guide [2] Quectel_QCOM_User_Guide [3] Quectel_QFlash_User_Guide Table 27: Terms and Abbreviations Abbreviation AGND BTB COM DC DI DO eMMC EVB GND GNSS I/O LED MIC Description Analog Ground Board to Board Cluster Communication Port Direct Current Digital Input Digital Output embedded Multi-Media Card Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode Microphone RTA001-EV_EVB_User_Guide 5G Module Series 44 / 45 NC PC PCB PCM PHY PO RF SD SIM UART USB (U)SIM Not Connected Personal Computer Printed Circuit Board Pulse Code Modulation Physical Layer Power Output Radio Frequency Secure Digital Subscriber Identity Module Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module 5G Module Series RTA001-EV_EVB_User_Guide 45 / 45

LG69T (AI,AJ) EVB 用户指导 GNSS 模块系列 版本：1.1 日期：2022-06-20 状态：受控文件 LG69T(AI,AJ) EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 27 LG69T(AI,AJ) EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 27 LG69T(AI,AJ) EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 请确保产品的使用符合国家和行业基础标准、安全标准和环境保护标准的要求，并符合 国家和特定场所对产品使用的具体规定。 请确保终端产品远离易燃易爆品。在极端供电和任何有潜在爆炸危险的（如靠近加油 站、油库、化工厂或爆炸作业场所）环境下使用电子产品可能存在安全隐患。 必须为产品提供稳定可靠的电源，并确保所有接线符合相关安全和防火法规。 在产品安装和使用过程中，必须小心处理以避免因为静电而对产品造成损坏。 上海移远通信技术股份有限公司 3 / 27 LG69T(AI,AJ) EVB 用户指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 LG69T (AI,AJ) EVB 用户指导 GNSS 模块系列 EVB 用户指导 受控文件 修订历史 版本 1.0 日期 2022-04-20 2022-06-15 1.1 2022-06-20 描述 文档创建 受控版本 1. 新增 Type-B USB 连接线（第 2 章和第 3 章）。 2. 新增 J101 接口信息（图 3）。 3. 更新 EVB 板供电接口为 J101（表 2）。 上海移远通信技术股份有限公司 4 / 27 LG69T(AI,AJ) EVB 用户指导 目录 安全须知 ....................................................................................................................................................... 3 关于文档 ....................................................................................................................................................... 4 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 简介 ....................................................................................................................................................... 8 2 概述 ....................................................................................................................................................... 9 2.1. EVB 套件 .................................................................................................................................... 9 2.2. EVB 套件连接示意图................................................................................................................ 10 3 EVB 接口............................................................................................................................................. 11 3.1. EVB 器件分布图 ........................................................................................................................11 3.2. EVB 接口 .................................................................................................................................. 12 4 使用 QCOM 工具进行通信 .................................................................................................................. 14 4.1. 操作步骤 ................................................................................................................................... 14 5 使用 QGNSS 工具进行测试 ................................................................................................................ 16 5.1. QGNSS 设置 ............................................................................................................................ 16 5.1.1. 窗口界面说明................................................................................................................. 17 6 使用 GNSSFlashTool 工具下载升级固件........................................................................................... 20 6.1. 在 Boot 下载模式中下载固件.................................................................................................... 20 6.2. 在正常工作模式中升级固件...................................................................................................... 22 7 附录 参考文档及术语缩写 ................................................................................................................... 25 上海移远通信技术股份有限公司 5 / 27 LG69T(AI,AJ) EVB 用户指导 表格索引 表 1：EVB 套件清单..................................................................................................................................... 9 表 2：接口定义 ........................................................................................................................................... 12 表 3：J302 引脚分配 .................................................................................................................................. 13 表 4：J302 引脚描述 .................................................................................................................................. 13 表 5：QGNSS 窗口界面说明...................................................................................................................... 17 表 6：参考文档 ........................................................................................................................................... 25 表 7：术语缩写 ........................................................................................................................................... 25 上海移远通信技术股份有限公司 6 / 27 LG69T(AI,AJ) EVB 用户指导 图片索引 图 1：EVB 套件图......................................................................................................................................... 9 图 2：EVB 套件连接示意图 ........................................................................................................................ 10 图 3：EVB 器件分布图 ................................................................................................................................11 图 4：USB 端口 .......................................................................................................................................... 14 图 5：QCOM 端口设置界面 ....................................................................................................................... 14 图 6：QCOM 界面 RTCM 语句输出 ........................................................................................................... 15 图 7：QGNSS 端口设置界面...................................................................................................................... 16 图 8：QGNSS 界面（已连接） .................................................................................................................. 17 图 9：固件下载—步骤 1 ............................................................................................................................. 20 图 10：固件下载—步骤 2 ........................................................................................................................... 20 图 11：固件下载—步骤 3 ........................................................................................................................... 21 图 12：固件下载—步骤 4 ........................................................................................................................... 21 图 13：固件下载成功—步骤 5.................................................................................................................... 22 图 14：固件升级—步骤 1 ........................................................................................................................... 22 图 15：固件升级—步骤 2 ........................................................................................................................... 23 图 16：固件升级—步骤 3 ........................................................................................................................... 23 图 17：固件升级—步骤 4 ........................................................................................................................... 23 图 18：固件升级成功—步骤 5.................................................................................................................... 24 上海移远通信技术股份有限公司 7 / 27 LG69T(AI,AJ) EVB 用户指导 1 简介 移远通信提供一整套 EVB 配件，以便 Quectel LG69T (AI)和 LG69T (AJ) 模块的测试和使用。本文档 主要介绍了 LG69T (AI)和 LG69T (AJ) 模块 EVB（评估板）套件的基本信息，并提供了详细的 EVB 使用 指导。 本文档具体分为以下几个章节： ⚫ 第二章主要介绍 EVB 套件的基本信息。 ⚫ 第三章主要介绍 EVB 的接口信息。 ⚫ 第四章主要介绍如何使用 QCOM 工具与模块进行通信。 ⚫ 第五章主要介绍如何使用 QGNSS 工具对模块进行测试。 ⚫ 第六章主要介绍如何使用 GNSSFlashTool 工具对模块进行固件下载和升级。 ⚫ 第七章为附录，主要介绍本文档中出现的参考文档和术语缩写。 备注 有关 EVB 原理图和 PCB 布局设计文件，请联系移远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 8 / 27 LG69T(AI,AJ) EVB 用户指导 2 概述 2.1. EVB 套件 套件包括：EVB 板、移远通信 GNSS 有源天线、Micro-USB 连接线、Type-B USB 连接线、铜柱和螺 丝。软件工具（QCOM、QGNSS 和 GNSSFlashTool）可从移远通信官网（下载专区）下载，或者从移远 通信技术支持处获取。 EVB 套件如下图所示，详情见表 1。 移远通信GNSS有源天线 EVB Type-B USB连接线 铜柱和螺丝 图 1：EVB 套件图 Micro-USB 连接线 表 1：EVB 套件清单 项目 EVB USB 线 GNSS 天线 说明书 描述 评估板 尺寸：100 mm × 175 mm Micro-USB 连接线 数量 1 1 Type-B USB 连接线 1 移远通信 GNSS 有源天线：YEGM011BA 可联系移远通信技术支持获取天线规格书 1 介绍评估板与配件连接方式以及 EVB 配件等详情的说明书 1 上海移远通信技术股份有限公司 9 / 27 其它 铜柱和螺丝 LG69T(AI,AJ) EVB 用户指导 4对 2.2. EVB 套件连接示意图 EVB 套件连接示意图如下所示。有关如何将配件连接至 EVB 板的详细信息，请参考配件中的说明书。 备注 图 2：EVB 套件连接示意图 将 GNSS 有源天线放置在可检测到卫星的户外开阔地带。 上海移远通信技术股份有限公司 10 / 27 LG69T(AI,AJ) EVB 用户指导 3 EVB 接口 3.1. EVB 器件分布图 EVB 器件分布图如下所示。 D309 TXD/1PPS指示灯 D109 5V/3.3V指示灯 J401 LG69T_ANT J302 测试点 S201 RESET_GNSS S202 BOOT_GNSS J201 USB_UART S101 电源开关 图 3：EVB 器件分布图 U301 GNSS模块 EVB版本号 J101 POWER_5V 上海移远通信技术股份有限公司 11 / 27 LG69T(AI,AJ) EVB 用户指导 3.2. EVB 接口 EVB 接口定义如下表所示。 表 2：接口定义 功能 供电 通信接口 射频输入 信号指示 开关和按键 测试点 接口 J101 POWER_5V J201 USB_UART J401 LG69T_ANT连接器 D309 TXD/1PPS指示灯 D109 5 V/3.3 V指示灯 S101 电源开关 S201 RESET_GNSS S202 BOOT_GNSS J302 测试点 1PPS （红色LED） TXD （绿色LED） 3.3 V （红色LED） 5 V （绿色LED） 描述 供电输入： ⚫ 供电电压范围：4.5~5.5 V，典型值：5.0 V ⚫ 电流负载能力应大于2 A。 增 强 型COM端 口 ： 用 于 设 置 模 块 、RTCM语 句 输 出和固件升级。 标准型COM端口：预留端口，无命令输入/输出。 配件中的天线支持如下星系： ⚫ GPS L1 C/A、L2 1 和L5 ⚫ GLONASS 1 L1和L2 ⚫ Galileo E1、E5b 1 和E5a ⚫ BDS B1I、B2I 1 和B2a ⚫ QZSS L1 C/A、L2 1 和L5 闪烁：输出频率为1 Hz的脉冲信号。 不亮：1PPS 失效。 闪烁：UART1 TXD 有数据输出。 不亮/常亮：UART1 TXD无数据输出。 EVB 3.3 V电源指示灯。 EVB 5 V电源指示灯。 控制EVB板电源的通断。 短按按键后释放，模块复位。 给EVB板 上电 前按 住BOOT按 键， 再打 开 电源 开 关，模块进入BOOT下载模式。 测试点详情可参考表3和表4。 1 仅 LG69T (AI)模块支持 GPS L2、GLONASS L1、 GLONASS L2、Galileo E5b、BDS B2I 和 QZSS L2 频段。 上海移远通信技术股份有限公司 12 / 27 测试点分布如下图所示： 表 3：J302 引脚分配 SPI_MOSI SPI_CS SPI_SCK SPI_MISO 表 4：J302 引脚描述 引脚名 I/O SPI_MOSI - SPI_SCK - TXD1 DO RXD1 DI 1PPS DO SPI_CS - SPI_MISO - TXD2 DO RXD2 DI GND - LG69T(AI,AJ) EVB 用户指导 TXD1 TXD2 RXD1 RXD2 1PPS GND 描述 不连接 不连接 串口 1 发送数据 串口 1 接收数据 一秒一个脉冲 不连接 不连接 串口 2 发送数据 串口 2 接收数据 地 上海移远通信技术股份有限公司 13 / 27 LG69T(AI,AJ) EVB 用户指导 4 使用 QCOM 工具进行通信 本章节介绍了如何使用 QCOM 工具通过 Micro-USB 接口与模块进行通信。有关 QCOM 工具的使用详 情，请参考文档 [1]。 软件工具 QCOM 可从移远通信官网（下载专区）下载，或者从移远通信技术支持处获取。 4.1. 操作步骤 步骤 1：将 EVB 通过 Micro-USB 线连接至电脑。 步骤 2：将电源开关（S101）拨至 ON 状态，给 EVB 上电。 步骤 3：在电脑的'设备管理器'界面中可查看 USB 的端口号，如下图所示。 图 4：USB 端口 步骤 4：安装由移远通信提供的 QCOM 工具，实现电脑与模块之间的通信。QCOM 通信端口设置如下图 所示。（默认波特率 460800 bps 2）。 图 5：QCOM 端口设置界面 步骤 5：选择正确的'COM Port'（端口号如图 4 所示）和'Baudrate'。 2 UART 接口默认波特率会因软件版本不同而有所变化。 上海移远通信技术股份有限公司 14 / 27 LG69T(AI,AJ) EVB 用户指导 步骤 6：点击'Open Port'（打开端口），如图 5 所示。与 EVB 的通信建立成功后，模块输出的 RTCM 语 句将通过 QCOM 工具显示出来，如图 6 所示。 图 6：QCOM 界面 RTCM 语句输出 上海移远通信技术股份有限公司 15 / 27 LG69T(AI,AJ) EVB 用户指导 5 使用 QGNSS 工具进行测试 本章节介绍了如何使用软件工具 QGNSS 验证模块的状态。相关工具可从移远通信技术支持处获取。 有关 QGNSS 工具的使用详情，请参考文档 [2]。 5.1. QGNSS 设置 步骤 1：将配件连接至EVB板。 步骤 2：将 EVB 通过 Micro-USB 线连接至电脑，电源开关（S101）拨至'ON'状态，给 EVB 上电。 步骤 3：打开由移远通信提供的QGNSS工具。点击'Setting'和'Serial Port Configuration'（默认波 特率460800 bps 3）。 图 7：QGNSS 端口设置界面 3 UART 接口默认波特率会因软件版本不同而有所变化。 上海移远通信技术股份有限公司 16 / 27 LG69T(AI,AJ) EVB 用户指导 步骤 4：点击 'Connect or disconnect'按钮。成功连接模块之后，QGNSS界面如下图所示。 图 8：QGNSS 界面（已连接） 5.1.1. 窗口界面说明 在 QGNSS 界面中可以查看 GNSS 信息，例如 C/N0 信息、时间、位置、速度和精度等。有关上述参 数的详细信息，请参考下表。 表 5：QGNSS 窗口界面说明 图标 说明 此天空视图界面显示正在被追踪的卫星信息。 1) 左侧图标显示正在被追踪的卫星及其数量。 ⚫ BDS：4 ⚫ GLO（GLONASS）：0 ⚫ GPS：11 ⚫ GAL（Galileo）：0 ⚫ QZSS：0 ⚫ NavIC （IRNSS）：0 ⚫ SBAS：0 2) 右侧的栅格地图显示了正在被追踪中的卫星方位。 上海移远通信技术股份有限公司 17 / 27 LG69T(AI,AJ) EVB 用户指导 GPS 卫星 BDS 卫星 GLONASS 卫星 Galileo 卫星 QZSS 卫星 NavIC（IRNSS）卫星 ⚫ PRN 30 的 C/N0 值是 39 dB-Hz。 ⚫ 亮红色柱表示卫星的导航数据正在使用中。 ⚫ PRN 1 的 C/N0 值是 21 dB-Hz。 ⚫ 浅红色柱表示该卫星的导航数据未被使用。 ⚫ 经度（单位：度） ⚫ 纬度（单位：度） ⚫ 平均海拔高度（MSL，单位：m） ⚫ 椭球面高度（EPH，单位：m） ⚫ 接收机速度（单位：km/h） ⚫ 水平精度因子 ⚫ 位置精度因子 ⚫ 定位模式：2D 和 3D ⚫ 质量指标：包含 DGNSS、DGPS 和 GPS SPS 模式 ⚫ UTC 日期和时间 ⚫ TOD 时间 4（单位：秒） ⚫ GPS 差分数据时间 ⚫ TTFF（单位：秒） 4 从当天午夜开始经过的总秒数。 上海移远通信技术股份有限公司 18 / 27 LG69T(AI,AJ) EVB 用户指导 ⚫ 总次数 ⚫ 定位点 ⚫ RTK 浮点解 ⚫ RTK 固定解 上海移远通信技术股份有限公司 19 / 27 LG69T(AI,AJ) EVB 用户指导 6 使用 GNSSFlashTool 工具下载升级固件 移远通信 LG69T(AI)和 LG69T(AJ)模块支持使用软件工具 GNSSFlashTool，可通过 UART 接口进行固 件升级。相关工具可从移远通信技术支持处获取。有关 GNSSFlashTool 工具的使用详情，请参考文档 [3]。 6.1. 在 Boot 下载模式中下载固件 在进行固件下载前，将 EVB 通过 Micro-USB 连接线连接至电脑，电源开关（S101）拨至 OFF 状态。 Boot 下载模式中下载固件的详细步骤如下： 步 骤 1： 打 开 移 远 通 信 提 供 的 GNSSFlashTool 工 具 或 者 在 QGNSS 工 具 中 点 击 'Tools' 并 选 择 'Firmware Download'，如下图所示。 图 9：固件下载—步骤 1 步骤 2：选择'Tool Options'下拉选项框中的'LG69TAA_Download'，如下图所示。 图 10：固件下载—步骤 2 上海移远通信技术股份有限公司 20 / 27 LG69T(AI,AJ) EVB 用户指导 步骤 3：点击'Open File'，选择模块的固件，如 LG69T (AI)固件'LG69TAINR01A04V01_BOOT.bin'； LG69T (AJ)固件'LG69TAJNR01A04V01_BOOT.bin'，如下图所示。 图 11：固件下载—步骤 3 步骤 4：确认'Port'和'Baud Rate'为增强型 COM 端口，点击'Start'按钮。先按住 BOOT 按钮， 再将电源开关（S201）拨到 ON 位置，然后松开 BOOT 按钮模块进入 Boot 下载模式。 图 12：固件下载—步骤 4 上海移远通信技术股份有限公司 21 / 27 LG69T(AI,AJ) EVB 用户指导 步骤 5：固件下载成功时，GNSSFlashTool工具界面上将显示一个进度为'PASS'的绿色进度条，如下 图所示。 图 13：固件下载成功—步骤 5 6.2. 在正常工作模式中升级固件 在进行固件升级前，将 EVB 通过 Micro-USB 连接线连接至电脑，电源开关（S101）拨至 ON 状态， 给 EVB 上电。 正常工作模式中升级固件的详细步骤如下： 步骤 1：打开移远通信提供的 GNSSFlashTool 工具或在 QGNSS 工具中点击'Tools'选择'Firmware Download'，如下图所示。 图 14：固件升级—步骤 1 上海移远通信技术股份有限公司 22 / 27 LG69T(AI,AJ) EVB 用户指导 步骤 2：选择'Tool Options'下拉选项框中的'LG69TAA_Upgrade'，如下图所示。 图 15：固件升级—步骤 2 步骤 3：点击'Open File'，选择模块固件版本，如 LG69T (AI)固件'LG69TAINR01A04V01_UPG.bin'， LG69T (AJ)固件'LG69TAJNR01A04V01_UPG.bin'，如下图所示。 图 16：固件升级—步骤 3 步骤 4：选择'Port'和'Baud Rate'为增强型 COM 端口，点击'Start'按钮开始下载 UPG 文件。请 在进度条分别为 5.17%和 98.28%时，按下并松开 EVB 板上的 RESET_GNSS 按键。若未执行此 操作，固件下载将会失败。 图 17：固件升级—步骤 4 上海移远通信技术股份有限公司 23 / 27 LG69T(AI,AJ) EVB 用户指导 步骤 5：固件升级成功时，GNSSFlashTool工具界面上将显示一个进度为'PASS'的绿色进度条，如下 图所示。 备注 图 18：固件升级成功—步骤 5 进行固件升级前，确保模块处于 Continuous 模式。 上海移远通信技术股份有限公司 24 / 27 LG69T(AI,AJ) EVB 用户指导 7 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_QCOM_User_Guide [2] Quectel_QGNSS_User_Guide [3] Quectel_GNSSFlashTool_User_Guide 表 7：术语缩写 缩写 2D 3D BDS C/N0 CEP COM Port DI DO EPH ESD EVB Galileo 英文全称 2 Dimension 3 Dimension BeiDou Navigation Satellite System Carrier-to-Noise Ratio Circular Error Probable Communication Port Digital Input Digital Output Ellipsoidal Height Electrostatic Discharge Evaluation Board Galileo Satellite Navigation System (EU) 中文全称 2维 3维 北斗导航卫星系统 载噪比 圆误差概率 通信串口 数字输入 数字输出 椭球面高度 静电放电 评估板 伽利略卫星导航系统（欧盟） 上海移远通信技术股份有限公司 25 / 27 LG69T(AI,AJ) EVB 用户指导 GLONASS GND GNSS GPS I/O IRNSS/NAVIC LED MISO MOSI Micro-USB MSL PC PCB 1PPS PRN QZSS RF RTCM RTK RXD SBAS SPS TTFF TXD UART Global Navigation Satellite System (Russia) 全球导航卫星系统（俄罗斯） Ground 地 Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 Input/Output 输入/输出 Indian Regional Navigation Satellite System 印度区域性导航卫星系统 Light Emitting Diode 发光二极管 Master In Slave Out 主机输入，从机输出 Master Out Slave In 主机输出，从机输入 Micro Universal Serial Bus 微型通用串行总线 Mean Sea Level 平均海平面 Personal Computer 个人电脑 Printed Circuit Board 印刷电路板 One Pulse Per Second 一秒一个脉冲 Pseudorandom Noise 伪随机噪声 Quasi-Zenith Satellite System 日本准天顶卫星系统 Radio Frequency 无线电频率 Radio Technical Commission for Maritime services 海事无线电技术委员会 Real-Time Kinematic 实时动态载波相位差分技术 Receive Data (Pin) 接收数据（引脚） Satellite-Based Augmentation System 星基增强系统 Standard Positioning Service 标准定位服务 Time to First Fix 首次定位时间 Transmit Data (Pin) 传输数据（引脚） Universal Asynchronous Receiver & Transmitter 通用异步收发器 上海移远通信技术股份有限公司 26 / 27 USB UTC Universal Serial Bus Coordinated Universal Time LG69T(AI,AJ) EVB 用户指导 通用串行总线 协调世界时 上海移远通信技术股份有限公司 27 / 27

LG69T (AM,AS) EVB User Guide GNSS Module Series Version: 1.0 Date: 2022-10-20 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LG69T(AM,AS)_EVB_User_Guide 1 / 45 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. LG69T(AM,AS)_EVB_User_Guide 2 / 45 GNSS Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any terminal incorporating Quectel LG69T(AM) module. Manufacturers of the terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Ensure that the product may be used in the country and the required environment, as well as that it conforms to the local safety and environmental regulations. Keep away from explosive and flammable materials. The use of electronic products in extreme power supply conditions and locations with potentially explosive atmospheres may cause fire and explosion accidents. The product must be powered by a stable voltage source, while the wiring must conform to security precautions and fire prevention regulations. Proper ESD handling procedures must be followed throughout the mounting, handling and operation of any devices and equipment that incorporate the module to avoid ESD damages. LG69T(AM,AS)_EVB_User_Guide 3 / 45 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LG69T (AM,AS) EVB User Guide GNSS Module Series EVB User Guide Released Revision History Version 1.0 Date 2022-03-14 2022-10-20 Description Creation of the document First official release LG69T(AM,AS)_EVB_User_Guide 4 / 45 GNSS Module Series Contents Safety Information...................................................................................................................................... 3 About the Document .................................................................................................................................. 4 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 Introduction ......................................................................................................................................... 8 2 General Overview................................................................................................................................ 9 2.1. EVB Kit ....................................................................................................................................... 9 2.2. Connect Cables and Antenna to EVB...................................................................................... 10 3 EVB Interfaces................................................................................................................................... 12 3.1. EVB Top View........................................................................................................................... 12 3.2. EVB Interfaces ......................................................................................................................... 13 4 Communication via QCOM Tool...................................................................................................... 16 5 GNSS Module Firmware Upgrade via QGNSS Tool ...................................................................... 18 5.1. QGNSS Setting ........................................................................................................................ 18 5.2. QGNSS Interface Explanation ................................................................................................. 20 5.3. Firmware Upgrade ................................................................................................................... 22 5.3.1. Module’s MCU Firmware Download in Boot Download Mode...................................... 22 5.3.2. Module’s MCU Firmware Upgrade in Normal Operating Mode.................................... 24 5.3.3. GNSS Firmware Upgrade ............................................................................................. 27 6 EG25-G Module Firmware Upgrade via QFlash Tool .................................................................... 30 7 RTK Application ................................................................................................................................ 34 7.1. Connect to Base Station .......................................................................................................... 34 7.1.1. Hardware Connection ................................................................................................... 35 7.2. Base Station Configuration ...................................................................................................... 36 7.2.1. Base Station Receiver Mode Configuration.................................................................. 36 7.2.2. Base Station RTCM MSM Mode Configuration ............................................................ 37 7.3. RTK Data Interaction Mode Configuration............................................................................... 37 7.4. STRSVR Tool Configuration .................................................................................................... 38 7.4.1. Steps for Data Transmission via NTRIP Protocol ......................................................... 38 7.4.2. Steps for Data Transmission via TCP Protocol............................................................. 40 8 Appendix Reference ......................................................................................................................... 43 LG69T(AM,AS)_EVB_User_Guide 5 / 45 GNSS Module Series Table Index Table 1: List of Kit Components ................................................................................................................. 10 Table 2: Detailed EVB Interfaces ............................................................................................................... 13 Table 3: J302 Pin Assignment .................................................................................................................... 14 Table 4: J302 Pin Detailed Description ...................................................................................................... 15 Table 5: QGNSS Interface Explanation...................................................................................................... 20 Table 6: NTRIP Caster Server Options ...................................................................................................... 39 Table 7: TCP Server Options...................................................................................................................... 41 Table 8: Related Document ........................................................................................................................ 43 Table 9: Terms and Abbreviations .............................................................................................................. 43 LG69T(AM,AS)_EVB_User_Guide 6 / 45 GNSS Module Series Figure Index Figure 1: EVB and Components .................................................................................................................. 9 Figure 2: EVB and Components Assembly.................................................................................................11 Figure 3: EVB Top View ............................................................................................................................. 12 Figure 4: USB Ports ................................................................................................................................... 16 Figure 5: QCOM Interface for COM Port Setting ....................................................................................... 16 Figure 6: RTCM Message Output of LG69T (AS) – Displayed on QCOM Tool Interface ......................... 17 Figure 7: NMEA Message Output of LG69T (AM) – Displayed on QCOM Tool Interface ......................... 17 Figure 8: COM Port and Baud Rate Setting .............................................................................................. 18 Figure 9: QGNSS Interface (Connected) ................................................................................................... 19 Figure 10: Converting WGS84 to ECEF .................................................................................................... 19 Figure 11: Converting WGS84 to ECEF .................................................................................................... 20 Figure 12: Launch Tool for MCU Firmware Downloading ......................................................................... 22 Figure 13: Configure Tool for MCU Firmware Downloading...................................................................... 22 Figure 14: Select MCU Firmware to be Downloaded ................................................................................ 23 Figure 15: Start MCU Firmware Downloading ........................................................................................... 23 Figure 16: Successful MCU Firmware Downloading ................................................................................. 24 Figure 17: Launch Tool for MCU Firmware Upgrading.............................................................................. 24 Figure 18: Configure Tool for MCU Firmware Upgrading .......................................................................... 25 Figure 19: Select MCU Firmware to be Upgraded..................................................................................... 25 Figure 20: Start MCU Firmware Upgrading ............................................................................................... 26 Figure 21: Successful MCU Firmware Upgrading ..................................................................................... 26 Figure 22: Launch Tool for GNSS Firmware Upgrading............................................................................ 27 Figure 23: Configure Tool for GNSS Firmware Upgrading........................................................................ 27 Figure 24: Select GNSS Firmware to be Upgraded .................................................................................. 28 Figure 25: Start GNSS Firmware Upgrading ............................................................................................. 28 Figure 26: Successful GNSS Firmware Upgrading ................................................................................... 29 Figure 27: Connection Between EVB and PC ........................................................................................... 30 Figure 28: USB Ports ................................................................................................................................. 31 Figure 29: QFlash Tool Setting .................................................................................................................. 31 Figure 30: Firmware Downloading ............................................................................................................. 32 Figure 31: Successful Firmware Downloading .......................................................................................... 32 Figure 32: Connect to Base Station ........................................................................................................... 35 Figure 33: EVB and Components Assembly.............................................................................................. 36 Figure 34: Configure STRSVR Tool – NTRIP 1 ......................................................................................... 38 Figure 35: Configure STRSVR Tool – NTRIP 2 ......................................................................................... 39 Figure 36: Configure STRSVR Tool – NTRIP 3 ......................................................................................... 39 Figure 37: Configure STRSVR Tool – NTRIP 4 ......................................................................................... 40 Figure 38: Configure STRSVR Tool – TCP 1............................................................................................. 40 Figure 39: Configure STRSVR Tool – TCP 2............................................................................................. 41 Figure 40: Configure STRSVR Tool – TCP 3............................................................................................. 41 Figure 41: Configure STRSVR Tool – TCP 4............................................................................................. 42 LG69T(AM,AS)_EVB_User_Guide 7 / 45 GNSS Module Series 1 Introduction This document provides information on the steps needed to evaluate the Quectel LG69T (AM) and LG69T (AS) GNSS modules using the Evaluation Board (EVB). The EVB is a convenient tool that allows you to become familiar with the modules. Specifically, the document is divided into several sections: ⚫ Chapter 2 provides the general overview of EVB Kit; ⚫ Chapter 3 describes the EVB interfaces; ⚫ Chapter 4 describes how to communicate with the modules via the QCOM tool; ⚫ Chapter 5 describes how to upgrade firmware of GNSS modules via the QGNSS tool; ⚫ Chapter 6 describes how to upgrade firmware of EG25-G module via the QFlash tool; ⚫ Chapter 7 introduces the RTK (Real-Time Kinematic) application; ⚫ Chapter 8 is an appendix, which summarizes the relevant documents, terms and abbreviations appearing herein. ⚫ NOTE 1. For EVB schematic and PCB layout design files, contact Quectel Technical Support (support@quectel.com). 2. Download the QCOM software tool from our website Download Zone or request it from Quectel Technical Support (support@quectel.com). 3. Request the QGNSS and QFlash software tools from Quectel Technical Support (support@quectel.com). LG69T(AM,AS)_EVB_User_Guide 8 / 45 GNSS Module Series 2 General Overview 2.1. EVB Kit The EVB kit includes: Evaluation Board (EVB), Quectel Active GNSS Antenna, LTE Antenna, Micro-USB Cable, Type-B USB Cable, Bolts and Coupling Nuts. The EVB kit components are shown in the figure below. Check Table 1: List of Kit Components for more information. Micro-USB Cable Type-B USB Cable LTE Antenna Quectel Active GNSS Antenna EVB Bolts and Coupling Nuts Figure 1: EVB and Components LG69T(AM,AS)_EVB_User_Guide 9 / 45 GNSS Module Series Table 1: List of Kit Components Items EVB USB Cables GNSS Antenna LTE Antenna Instruction Sheet Others Description Evaluation Board Size: 100 mm × 175 mm Micro-USB Cable Quantity 1 1 Type-B USB Cable 1 Active GNSS Antenna: YEGM011AA Antenna Size: Φ 146.4 mm × 65 mm Cable Length: 4000 mm The GNSS antenna supports: 1 ⚫ GPS L1 C/A and L5 ⚫ Galileo E1 and E5a ⚫ BDS B1I and B2a ⚫ QZSS L1 C/A and L5 (Only for LG69T (AS)) LTE Antenna 1 Sheet providing instructions on how to connect the EVB and its components, detailed information on EVB 1 components, etc. Bolts and Coupling Nuts 4 pairs ⚫ NOTE Request Quectel Technical Support (support@quectel.com) for details about Quectel Active GNSS Antenna and LTE Antenna. 2.2. Connect Cables and Antenna to EVB The connection between the EVB and its components is shown in the figure below. For more information on how to connect the EVB and its components, see the instruction sheet inside the EVB Kit. LG69T(AM,AS)_EVB_User_Guide 10 / 45 GNSS Module Series Figure 2: EVB and Components Assembly ⚫ NOTE Make sure that the active GNSS antenna is placed with a clear line of sight to the sky. LG69T(AM,AS)_EVB_User_Guide 11 / 45 GNSS Module Series 3 EVB Interfaces 3.1. EVB Top View EVB top view is shown in the figure below. J603 LTE-ANT D309 TXD/1PPS indication LED D310 GEO_F/RTK_S indication LED D109 5 V/3.3 V indication LED J401 LG69T GNSS_ANT U601 EG25-G module J302 Test points J604 SIM card S601 RESET_EC20 S201 RESET_GNSS S202 BOOT_GNSS J601 USB_EC20 J201 USB_UART Figure 3: EVB Top View U301 LG69T GNSS module EVB Version S101 Power switch LG69T(AM,AS)_EVB_User_Guide 12 / 45 GNSS Module Series 3.2. EVB Interfaces The EVB interfaces are detailed in the table below. Table 2: Detailed EVB Interfaces Function Interfaces Description Power Supply Communication Interface RF Interface Signal Indication J201 USB_UART J601 USB_EC20 J601 USB_EC20 J201 USB_UART J401 LG69T GNSS_ANT Connector J603 LTE_ANT Connector D309 TXD/1PPS indication LED 1PPS (Red LED) TXD (Green LED) D109 5 V/3.3 V indication LED 3.3 V (Red LED) 5 V (Green LED) D310 GEO_F/RTK_S Indication LED (Only for LG69T (AM)) GEO_F (Red LED) RTK_S (Green LED) Power supply input: ⚫ DC power supply: 4.5–5.5 V, typ. 5.0 V ⚫ Current capability should be > 2 A Used for configuring RTK account. Enhanced COM Port: Used for standard NMEA/RTCM message output, PQTM command input, and firmware download. Standard COM Port: Used for standard NMEA/RTCM message output, PQTM command input. If you need to use the Standard COM Port, configure the RTK function of the GNSS module via EG25-G module and insert the SIM card. Used for connecting GNSS antenna. Used for connecting LTE antenna Flashing: 1 Hz pulse signal output. Off: 1PPS is unavailable. Flashing: Data output from UART1 TXD. Fixed Off/On: No data output from UART1 TXD. EVB 3.3 V power indicator. EVB 5 V power indicator. Geofence indicator. RTK indicator. LG69T(AM,AS)_EVB_User_Guide 13 / 45 Function Switches Buttons Interfaces S101 Power Switch S201 RESET_GNSS and S601 RESET_EC20 S202 BOOT_GNSS Others Test Points J604 SIM Card Connector J302 Test Points J302 pin assignment is shown below: Table 3: J302 Pin Assignment SPI_MOSI SPI_CS SPI_SCK SPI_MISO GNSS Module Series Description Powers the EVB on/off. Short press the button to reset the GNSS module. Short press the button to reset the EG25-G module. Press and hold the BOOT_GNSS button first and then flip the power switch to ON position to set the GNSS module to Boot download mode. If the SIM card is not inserted and the RTK account is not configured, UART2 Standard COM Port cannot receive data. Pins are detailed in Table 4: J302 Pin Detailed Description. TXD1 TXD2 RXD1 RXD2 1PPS GND LG69T(AM,AS)_EVB_User_Guide 14 / 45 Table 4: J302 Pin Detailed Description Pin Name I/O SPI_MOSI - SPI_SCK - TXD1 DO RXD1 DI 1PPS DO SPI_CS - SPI_MISO - TXD2 DO RXD2 DI GND - GNSS Module Series Description NC (Not connected) NC TXD1 transmits data RXD1 receives data One pulse per second NC NC TXD2 transmits data RXD2 receives data Ground LG69T(AM,AS)_EVB_User_Guide 15 / 45 GNSS Module Series 4 Communication via QCOM Tool This chapter explains how to use the QCOM software tool to communicate with the module via the MicroUSB interface. For more information, see document [1] QCOM User Guide. To establish communication with the GNSS module via QCOM tool: Step 1: Connect the EVB and the PC with a Micro-USB cable via the Micro-USB connector. Flip the Power switch (S101) to ON position to power on the EVB. Step 2: View the USB port numbers in the PC OS system Device Manager. Figure 4: USB Ports Step 3: Install the QCOM tool provided by Quectel. The QCOM interface for COM port setting is shown in the figure below (default baud rate: 460800 bps 1). Figure 5: QCOM Interface for COM Port Setting Step 4: Select the correct 'COM Port' (USB Port shown in Figure 4: USB Ports) and correct 'Baudrate'. Step 5: Click 'Open Port' to establish communication with the EVB, as shown in Figure 5: QCOM Interface for COM Port Setting . The NMEA or RTCM message output by the module will be displayed on the QCOM tool interface, as shown in the figures below. 1 UART interface default settings may vary depending on software versions. LG69T(AM,AS)_EVB_User_Guide 16 / 45 GNSS Module Series Figure 6: RTCM Message Output of LG69T (AS) – Displayed on QCOM Tool Interface Figure 7: NMEA Message Output of LG69T (AM) – Displayed on QCOM Tool Interface LG69T(AM,AS)_EVB_User_Guide 17 / 45 GNSS Module Series 5 GNSS Module Firmware Upgrade via QGNSS Tool This chapter explains how to use the QGNSS software tool for verifying the status of GNSS modules and firmware upgrading. For more information about QGNSS usage, see document [2] QGNSS User Guide. 5.1. QGNSS Setting Step 1: Assemble the EVB components. Step 2: Connect the EVB and the PC with a Micro-USB cable. Flip the Power switch (S101) to ON position to power on the EVB. Step 3: Start the QGNSS and click 'Device' and 'Set Device Information' (default baud rate: 460800 bps 2). Figure 8: COM Port and Baud Rate Setting Step 4: Click 'Connect or disconnect' button. Once the module is connected, the interface shown in the figure below will appear. 2 UART interface default settings may vary depending on software versions. LG69T(AM,AS)_EVB_User_Guide 18 / 45 GNSS Module Series Figure 9: QGNSS Interface (Connected) Step 5: Click 'Deviation Map' button in the QGNSS toolbar, select 'Setup' interface to convert WGS84 (World Geodetic System) to ECEF (Geocentric Coordinate System). Enter the corresponding coordinates of Lon (Degree), Lat (Degree), Alt (m) in the LLA column, and then select 'Calculate CEP50' to convert WGS84 to the X, Y, Z coordinates of ECEF, as shown in the figures below. Figure 10: Converting WGS84 to ECEF LG69T(AM,AS)_EVB_User_Guide 19 / 45 GNSS Module Series Figure 11: Converting WGS84 to ECEF ⚫ NOTE WGS84 can be converted to ECEF regardless of whether QGNSS is connected or unconnected . 5.2. QGNSS Interface Explanation You can view GNSS information, such as C/N0 message, time, position, speed, and precision in the QGNSS interface. See the following table to find out more about these parameters. Table 5: QGNSS Interface Explanation Icon Explanation The sky view interface shows the position of the satellites in use. 1) The left column icons show the satellites in use and their number. ⚫ BDS: 6 ⚫ GLO (GLONASS): 0 ⚫ GPS: 6 ⚫ GAL (Galileo): 2 ⚫ QZSS: 0 ⚫ NavIC (IRNSS): 0 ⚫ SBAS: 0 2) The sky view on the right shows the position of the satellites in use. LG69T(AM,AS)_EVB_User_Guide 20 / 45 Icon Explanation GPS satellite BDS satellite GLONASS satellite Galileo satellite QZSS satellite NavIC (IRNSS) satellite GNSS Module Series ⚫ PRN 30 C/N0 is 39 dB-Hz. ⚫ Column in bright red means that the navigation data of the satellites are in use. ⚫ PRN 1 C/N0 is 21 dB-Hz. ⚫ Column in light red means that the navigation data of the satellites are not in use. ⚫ Longitude (unit: degree) ⚫ Latitude (unit: degree) ⚫ Altitude (MSL) (unit: m) ⚫ Altitude (EPH) (unit: m) ⚫ Receiver speed (unit: km/h) ⚫ Horizontal dilution of precision ⚫ Position dilution of precision ⚫ Fix Mode: 2D, 3D ⚫ Quality Indicator: DGNSS, DGPS, GPS SPS mode ⚫ UTC date and time ⚫ Age of differential GPS data ⚫ Last TTFF(s) (unit: second) ⚫ Total Times ⚫ Fixed Points ⚫ RTK Float ⚫ RTK Fixed LG69T(AM,AS)_EVB_User_Guide 21 / 45 GNSS Module Series 5.3. Firmware Upgrade The firmware of GNSS module’s MCU is upgraded with QGNSS via the UART interface. 5.3.1. Module’s MCU Firmware Download in Boot Download Mode Before the module’s MCU firmware download process, connect the EVB to a PC with a Micro-USB cable and flip the power switch (S101) to OFF position. To download the module’s MCU firmware in Boot download mode: Step 1: Open QGNSS tool, and click 'Tools' and select 'Firmware Download' in the drop-down box. ① Figure 12: Launch Tool for MCU Firmware Downloading Step 2: Select 'Download Baudrate' in the drop-down box of 'Settings'. ② Figure 13: Configure Tool for MCU Firmware Downloading LG69T(AM,AS)_EVB_User_Guide 22 / 45 GNSS Module Series Step 3: Select 'MCU_Download' and then click 'LG69TAMNR01A02V02_RTK_PO_BOOT.bin'. button to select firmware file, e.g., ③ Figure 14: Select MCU Firmware to be Downloaded Step 4: Press and hold the BOOT_GNSS button before flipping the power switch to ON position, and then release the BOOT_GNSS button to set the module to Boot download mode. Then, click button. ④ Figure 15: Start MCU Firmware Downloading LG69T(AM,AS)_EVB_User_Guide 23 / 45 GNSS Module Series Step 5: Upon successful MCU firmware download, the QGNSS tool progress bar on the screen will indicate '100 %'. Figure 16: Successful MCU Firmware Downloading 5.3.2. Module’s MCU Firmware Upgrade in Normal Operating Mode Before the module’s MCU firmware upgrade process, connect the EVB to a PC with a Micro-USB cable and flip the power switch (S101) to OFF position. To upgrade the module’s MCU firmware in Normal operating mode: Step 1: Open QGNSS tool, and click 'Tools' and select 'Firmware Download' in the drop-down box. ① Figure 17: Launch Tool for MCU Firmware Upgrading LG69T(AM,AS)_EVB_User_Guide 24 / 45 GNSS Module Series Step 2: Select 'Download Baudrate' in the drop-down box of 'Settings'. ② Figure 18: Configure Tool for MCU Firmware Upgrading Step 3: Select 'MCU_Upgrade' and then click 'LG69TAMNR01A02V02_RTK_PO_UPG.bin'. ③ to select firmware file, e.g., Figure 19: Select MCU Firmware to be Upgraded LG69T(AM,AS)_EVB_User_Guide 25 / 45 GNSS Module Series Step 4: Click button before flipping the power switch to ON position, and then start downloading the MCU firmware. ④ Figure 20: Start MCU Firmware Upgrading Step 5: Upon successful firmware upgrading, the QGNSS tool progress bar on the screen will indicate '100 %'. Figure 21: Successful MCU Firmware Upgrading LG69T(AM,AS)_EVB_User_Guide 26 / 45 GNSS Module Series 5.3.3. GNSS Firmware Upgrade Before GNSS firmware upgrade process, connect the EVB to a PC with a Micro-USB cable and flip the power switch (S101) to OFF position. To download GNSS firmware in Normal operating mode: Step 1: Open QGNSS tool, and click 'Tools' and select 'Firmware Download' in the drop-down box. ① Figure 22: Launch Tool for GNSS Firmware Upgrading Step 2: Select 'Download Baudrate' in the drop-down box of 'Settings'. ② Figure 23: Configure Tool for GNSS Firmware Upgrading Step 3: Select 'GNSS_Upgrade' and then click 'Open' button to select firmware file, e.g., 'LG69TAMNR01A02V02_RTK_PO_STA.bin'. LG69T(AM,AS)_EVB_User_Guide 27 / 45 GNSS Module Series ③ Figure 24: Select GNSS Firmware to be Upgraded Step 4: Click button before flipping the power switch to ON position, and then start downloading the firmware. ④ Figure 25: Start GNSS Firmware Upgrading LG69T(AM,AS)_EVB_User_Guide 28 / 45 GNSS Module Series Step 5: Upon successful firmware upgrading, the QGNSS tool progress bar on the screen will be indicate '100 %'. Figure 26: Successful GNSS Firmware Upgrading ⚫ NOTE Make sure the GNSS module is in Continuous mode before GNSS firmware upgrading. LG69T(AM,AS)_EVB_User_Guide 29 / 45 GNSS Module Series 6 EG25-G Module Firmware Upgrade via QFlash Tool This chapter explains how to use the QFlash software tool to upgrade EG25-G module firmware. For more information about QFlash usage, see document [3] QFlash User Guide. To upgrade EG25-G module firmware: Step 1: Before EG25-G module firmware upgrade process, connect the EVB to a PC with a Micro-USB cable via USB_EC20 interface (J601). Micro-USB (J 601) Micro-USB (J201) PC Figure 27: Connection Between EVB and PC LG69T(AM,AS)_EVB_User_Guide 30 / 45 GNSS Module Series Step 2: Flip the power switch (S101) to ON position to power on the EVB. View the AT and DM COM port number in the Device Manager, as shown in the figure below. Figure 28: USB Ports Step 3: Open QFlash tool, click 'Load FW File' and select 'ENPRG9x07.mbn'. Then set the 'COM Port' to DM Port and 'Baudrate' to 921600 bps. Figure 29: QFlash Tool Setting Step 4: Click 'Start' to start firmware downloading, as shown in the figure below. LG69T(AM,AS)_EVB_User_Guide 31 / 45 GNSS Module Series Figure 30: Firmware Downloading Step 5: Upon successful firmware downloade, the QFlash tool progress bar on the screen will indicate 'PASS'. Figure 31: Successful Firmware Downloading LG69T(AM,AS)_EVB_User_Guide 32 / 45 GNSS Module Series ⚫ NOTE The software version and QFlash tool cannot be stored in directories containing Chinese characters, special characters, and spaces when you download the firmware of the EG25-G module. Otherwise, the download will fail. LG69T(AM,AS)_EVB_User_Guide 33 / 45 GNSS Module Series 7 RTK Application RTK is a technique for increasing GNSS positioning accuracy. It involves the use of one stationary reference receiver, called the base station, that sends correction data to one moving receiver, called the rover. The correction data source can either be a: ⚫ local fixed base station; or ⚫ third party correction service This chapter outlines how the LG69T (AM) module is used as the rover and LG69T (AS) module is used as the base station, as well as how to: ⚫ Connect to the base station, ⚫ Configure the base station, ⚫ Configure RTK data interaction mode, and ⚫ Configure STRSVR tool. 7.1. Connect to Base Station LG69T (AS) module is the base station that provides correction data required by the rover to enter RTK mode. The transmission of such data from the base station to the rover is carried out via NTRIP or TCP protocol with STRSVR tool over the Internet. Users need to keep delays to a minimum when transmitting the data. LG69T(AM,AS)_EVB_User_Guide 34 / 45 GNSS Module Series The connection to the base station with STRSVR tool via NTRIP or TCP protocol illustrates below: GNSS Raw Measurements GNSS Raw Measurements LG69T (AS) Base Station Ntrip/TCP Server LG69T(AS) Base Station STRSVR ① Using NTRIP Protocol ② Using TCP Protocol RTCM RTCM Cellular Module GNSS Module Figure 32: Connect to Base Station Cellular Module 7.1.1. Hardware Connection The connection between EVB and PC is shown in the figure below. For more information about how to connect to the EVB and its components, see Chapter 2.2 Connect Cables and Antenna to EVB. LG69T(AM,AS)_EVB_User_Guide 35 / 45 LTE antenna GNSS antenna GNSS Module Series SIM card PC Micro-USB cables Figure 33: EVB and Components Assembly 7.2. Base Station Configuration 7.2.1. Base Station Receiver Mode Configuration The following command is used to set the Receiver Mode of base station. The base station needs to work in static mode and there are two ways to enter static mode: Survey-in mode and Fixed mode. For more information, see document [4] Protocol Specification. Synopsis: $PQTMSETRECVMODE,,,,,,* LG69T(AM,AS)_EVB_User_Guide 36 / 45 GNSS Module Series 7.2.2. Base Station RTCM MSM Mode Configuration The following command is used to set the RTCM MSM (Multiple Signal Messages) mode of base station. For more information, see document [4] Protocol Specification. Synopsis: $PQTMSETMSMMODE,* 7.3. RTK Data Interaction Mode Configuration RTK data interaction mode is configured by sending the command to the AT port of the EG25-G module. The RTK data interaction mode needs to be reconfigured every time the EG25-G module upgrades its firmware. The commands format is as follows: Synopsis: AT+QGNSSPARAM='ProtoMode','DataMode','ip','port','usr','pwd','mount_point' Parameter Parameter ProtoMode DataMode ip port usr pwd mount_point Description 0 = NTRIP protocol 1 = TCP protocol 0 = Rover Station 1 = Base station Server IP address Server port Username Password Mount point ⚫ NOTE The parameters 'usr','pwd' and 'mount_point' are only used for configuring RTK data interaction mode through NTRIP method. LG69T(AM,AS)_EVB_User_Guide 37 / 45 ⚫ If successful, the module returns: +QGNSSPARAM OK ⚫ If failed, the module returns: +QGNSSPARAM ERR GNSS Module Series 7.4. STRSVR Tool Configuration The main function of STRSVR tool is to transmit the differential data of the base station to the rover via NTRIP or TCP protocol over the network. The basic steps for data transmission via NTRIP or TCP protocol are listed below. 7.4.1. Steps for Data Transmission via NTRIP Protocol Step 1: Send AT+QGNSSPARAM=1,1,'ip','port','usr','pwd','mount_point' to AT port of the EG25-G to configure the LG69T (AS) module as the Base Station. Step 2: Send AT+QGNSSPARAM=1,0,'ip','port','usr','pwd','mount_point' to AT port of the EG25-G to configure LG69T (AM) module as the Rover Station. Step 3: Open STRSVR tool. '(0) Input' is the configuration of the Base Station and '(1) Output' is the configuration of the Rover Station. For '(0) Input' and '(1) Output', set the 'Type' to 'NTRIP Caster'. Figure 34: Configure STRSVR Tool – NTRIP 1 Step 4: For '(0) Input', set RTK account configuration information in the 'NTRIP Caster Server Options' interface. LG69T(AM,AS)_EVB_User_Guide 38 / 45 GNSS Module Series Figure 35: Configure STRSVR Tool – NTRIP 2 Table 6: NTRIP Caster Server Options Parameter NTRIP Caster Host Port Mountpoint User-ID Password Description Server IP address Server port Mount point Username Password Step 5: For '(1) Output', set RTK account configuration information in the 'NTRIP Caster Server Options' interface as shown below, and see Table 6: NTRIP Caster Server Options for details. Multiple modules can simultaneously be connected to the '(1) Output' port. Figure 36: Configure STRSVR Tool – NTRIP 3 LG69T(AM,AS)_EVB_User_Guide 39 / 45 GNSS Module Series Step 6: Click 'Start' to start configuring the server. Once the configuration is complete, the STRSVR tool progress bar on the screen will indicate 100%. Figure 37: Configure STRSVR Tool – NTRIP 4 7.4.2. Steps for Data Transmission via TCP Protocol Step 1: Send AT+QGNSSPARAM=1,1,'ip','port' to AT port of the EG25-G to configure the LG69T (AS) module as the Base Station. Step 2: Send AT+QGNSSPARAM=1,0,'ip','port' to AT port of the EG25-G to configure LG69T (AM) module as the Rover Station. Step 3: Open STRSVR tool. '(0) Input' is the configuration of the Base Station and '(1) Output' is the configuration of the Rover Station. Set the 'Type' of '(0) Input' and '(1) Input' to 'TCP Server'. Figure 38: Configure STRSVR Tool – TCP 1 LG69T(AM,AS)_EVB_User_Guide 40 / 45 GNSS Module Series Step 4: For '(0) Input', set RTK account configuration information in the 'TCP Server Options' interface. Figure 39: Configure STRSVR Tool – TCP 2 Table 7: TCP Server Options Parameter Server Host Port Description Server IP address Server port ⚫ NOTE TCP method does not require you to enter Mountpoint, User-ID and Password when setting RTK account configuration information. Step 5: For '(1) Output', set RTK account configuration information in the 'TCP Server Options' interface as shown below and see Table 7: TCP Server Options for details. Multiple modules can simultaneously be connected to the '(1) Output'. Figure 40: Configure STRSVR Tool – TCP 3 LG69T(AM,AS)_EVB_User_Guide 41 / 45 GNSS Module Series Step 6: Click 'Start' to start configuring the server. Once the configuration is complete, the STRSVR tool progress bar on the screen will indicate 100%. Figure 41: Configure STRSVR Tool – TCP 4 LG69T(AM,AS)_EVB_User_Guide 42 / 45 8 Appendix Reference Table 8: Related Document Document Name [1] Quectel_QCOM_User_Guide [2] Quectel_QGNSS_User_Guide [3] Quectel_QFlash_User_Guide [4] Quectel_LG69T(AS)_GNSS_Protocol_Specification Table 9: Terms and Abbreviations Abbreviation 2D 3D AT BDS CEP C/N0 DI DO DR EPH ESD EVB Description 2 Dimension 3 Dimension Attention BeiDou Navigation Satellite System Circular Error Probable Carrier-to-Noise Ratio Digital Input Digital Output Dead Reckoning Ellipsoidal Height Electrostatic Discharge Evaluation Board LG69T(AM,AS)_EVB_User_Guide GNSS Module Series 43 / 45 Abbreviation Galileo GLONASS GND GNSS GPS I/O LED Micro-USB MISO MOSI MSL MSM NAVIC/IRNSS NMEA NTRIP PC PCB 1PPS PRN QZSS RTCM RTK RXD SBAS Description Galileo Satellite Navigation System (EU) Global Navigation Satellite System (Russia) Ground Global Navigation Satellite System Global Positioning System Input/Output Light Emitting Diode Micro Universal Serial Bus Master In Slave Out Master Out Slave In Mean Sea Level Multiple Signal Messages Indian Regional Navigation Satellite System National Marine Electronics Association Networked Transport of RTCM via Internet Protocol Personal Computer Printed Circuit Board One Pulse Per Second Pseudorandom Noise Quasi-Zenith Satellite System Radio Technical Commission for Maritime services Real-Time Kinematic Receive Data (Pin) Satellite-Based Augmentation System GNSS Module Series LG69T(AM,AS)_EVB_User_Guide 44 / 45 Abbreviation TCP TF TNC TTFF TXD USB UTC Description Transmission Control Protocol TransFlash Thread Neill-Concelman Time to First Fix Transmit Data (Pin) Universal Serial Bus Coordinated Universal Time GNSS Module Series LG69T(AM,AS)_EVB_User_Guide 45 / 45

L76K EVB 用户指导 GNSS 模块系列 版本：1.0 日期：2022-05-25 状态：受控文件 L76K EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 21 L76K EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 21 L76K EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 请确保产品的使用符合国家和行业基础标准、安全标准和环境保护标准的要求，并符合 国家和特定场所对产品使用的具体规定。 请确保终端产品远离易燃易爆品。在极端供电和任何有潜在爆炸危险的（如靠近加油 站、油库、化工厂或爆炸作业场所）环境下使用电子产品可能存在安全隐患。 必须为产品提供稳定可靠的电源，并确保所有接线符合相关安全和防火法规。 在产品安装和使用过程中，必须小心处理以避免因为静电而对产品造成损坏。 上海移远通信技术股份有限公司 3 / 21 关于文档 文档信息 标题 副标题 文档类型 文档状态 L76K EVB 用户指导 GNSS 模块系列 EVB 用户指导 受控文件 修订历史 版本 1.0 日期 2022-02-23 2022-05-25 描述 文档创建 受控版本 L76K EVB 用户指导 上海移远通信技术股份有限公司 4 / 21 L76K EVB 用户指导 目录 安全须知 ....................................................................................................................................................... 3 关于文档 ....................................................................................................................................................... 4 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 简介 ....................................................................................................................................................... 8 2 概述 ....................................................................................................................................................... 9 2.1. EVB 套件 .................................................................................................................................... 9 2.2. EVB 套件连接示意图................................................................................................................ 10 3 EVB 接口............................................................................................................................................. 11 3.1. EVB 器件分布图 ........................................................................................................................11 3.2. EVB 接口 .................................................................................................................................. 12 4 使用 QCOM 工具进行通信 .................................................................................................................. 14 4.1. 操作步骤 ................................................................................................................................... 14 5 使用 QGNSS 工具进行测试 ................................................................................................................ 16 5.1. QGNSS 工具设置 ..................................................................................................................... 16 5.1.1. 窗口界面说明................................................................................................................. 17 6 附录 参考文档及术语缩写 ................................................................................................................... 20 上海移远通信技术股份有限公司 5 / 21 L76K EVB 用户指导 表格索引 表 1：EVB 套件清单..................................................................................................................................... 9 表 2：接口定义 ........................................................................................................................................... 12 表 3：J106 引脚分配 .................................................................................................................................. 12 表 4：J106 引脚描述 .................................................................................................................................. 13 表 5：QGNSS 窗口界面说明...................................................................................................................... 17 表 6：参考文档 ........................................................................................................................................... 20 表 7：术语缩写 ........................................................................................................................................... 20 上海移远通信技术股份有限公司 6 / 21 L76K EVB 用户指导 图片索引 图 1： EVB 套件图 ....................................................................................................................................... 9 图 2：EVB 套件连接示意图 ........................................................................................................................ 10 图 3：EVB 器件分布图 ................................................................................................................................11 图 4：USB 端口 .......................................................................................................................................... 14 图 5：QCOM 通信端口设置界面 ................................................................................................................ 14 图 6：QCOM 界面 NMEA 语句输出 ........................................................................................................... 15 图 7：COM 端口和波特率设置 ................................................................................................................... 16 图 8：QGNSS 界面（已连接） .................................................................................................................. 17 上海移远通信技术股份有限公司 7 / 21 L76K EVB 用户指导 1 简介 移远通信提供一整套 EVB 配件，以便 Quectel L76K 模块的测试和使用。本文档介绍了 L76K EVB （评估板）套件的基本信息，并提供了详细的 EVB 使用指导。 本文档具体分为以下几个章节： ⚫ 第二章主要介绍 EVB 套件的基本信息。 ⚫ 第三章主要介绍 EVB 的接口信息。 ⚫ 第四章主要介绍如何使用 QCOM 工具与模块进行通信。 ⚫ 第五章主要介绍如何使用 QGNSS 工具对模块进行测试。 ⚫ 第六章为附录，主要介绍本文档中出现的参考文档和术语。 备注 有关 EVB 原理图和 PCB 布局设计文件，请联系移远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 8 / 21 L76K EVB 用户指导 2 概述 2.1. EVB 套件 套件包括：EVB 板、GNSS 有源天线、Micro-USB 连接线、U 盘、铜柱和螺丝。软件工具（QCOM 和 QGNSS）可从移远通信官网（下载专区）下载，也可从移远通信技术支持处获取。 EVB 套件如下图所示，详情见表 1。 Micro-USB 连接线 铜柱和螺丝 GNSS有源天线 EVB U盘 图 1： EVB 套件图 表 1：EVB 套件清单 项目 EVB USB 线 描述 L76K 评估板 尺寸：70 mm × 60 mm Micro-USB 连接线 上海移远通信技术股份有限公司 数量 1 1 9 / 21 U盘 GNSS 天线 说明书 其它 L76K EVB 用户指导 8 GB U 盘（包含模块相关文档、工具和驱动程序） 1 GNSS 有源天线 可联系移远通信技术支持获取天线规格书 1 介绍评估板与配件连接方式以及 EVB 配件等详情的说明 书 1 铜柱和螺丝 4对 2.2. EVB 套件连接示意图 EVB 套件连接示意图如下所示。有关如何将配件连接至 EVB 板的详细信息，请参考配件中的说明书。 备注 图 2：EVB 套件连接示意图 将 GNSS 有源天线放置在可检测到卫星的户外开阔地带。 上海移远通信技术股份有限公司 10 / 21 L76K EVB 用户指导 3 EVB 接口 3.1. EVB 器件分布图 L76K 模块 EVB 的器件分布图如下所示。 Z101 复位按键 S301 UART↔USB开关 EVB版本号 S201 电源开关 J106 测试点 U101 L76K模块 图 3：EVB 器件分布图 J201 Micro-USB连接器 D101 1PPS和TXD 指示灯 J101 天线连接器 上海移远通信技术股份有限公司 11 / 21 L76K EVB 用户指导 3.2. EVB 接口 L76K EVB 接口如下图表所示。 表 2：接口定义 功能 供电 通信接口 射频输入 信号指示 开关和按键 测试点 接口 J201 Micro-USB 连接器 J201 Micro-USB连接器 J101 天线连接器 D101 LED指示灯 TXD （蓝色LED） 1PPS （红色LED） S201 电源开关 S301 UART↔USB开关 Z101 复位按键 J106 测试点 描述 供电输入： ⚫ 供电电压范围：4.5~5.5 V，典型值：5.0 V ⚫ 电流负载能力应大于100 mA。 用 于 标 准NMEA语 句 输 出 、PCAS命 令 输 入/输 出和CASIC语句输入/输出。 配件中的天线支持如下星系： ⚫ GPS L1 C/A ⚫ GLONASS L1 ⚫ BDS B1I ⚫ QZSS L1 C/A 闪烁：UART TXD 有数据输出。 不亮或常亮：UART TXD 无数据输出。 闪烁：定位成功，频率为 1 Hz。 不亮：未定位。 控制EVB板电源的通断。 用于切换模块的数据传输接口。 短按按键后释放，模块复位。 测试点详情可参考表 3 和表 4。 测试点分布如下表所示： 表 3：J106 引脚分配 32K/DRIN TIMER AADET_N RESET 1PPS TXD1 STANDBY RXD1 GND GND 上海移远通信技术股份有限公司 12 / 21 表 4：J106 引脚描述 引脚名 I/O 32K/DRIN - AADET_N - 1PPS DO STANDBY - GND - TIMER - RESET DI TXD DO RXD DI GND - 描述 不连接 不连接 一秒一个脉冲 不连接 地 不连接 复位模块 传输数据 接收数据 地 L76K EVB 用户指导 上海移远通信技术股份有限公司 13 / 21 L76K EVB 用户指导 4 使用 QCOM 工具进行通信 本章节介绍了如何使用 QCOM 工具通过 Micro-USB 接口与模块进行通信。更多有关 QCOM 工具的使 用信息，请参考文档 [1]。 软件工具 QCOM 可从移远通信官网（下载专区）下载，也可从移远通信技术支持处获取。 4.1. 操作步骤 步骤 1：将 EVB 通过 Micro-USB 线连接至电脑，再将电源开关（S201）拨至'ON'状态，给 EVB 上电。 并将 UART↔USB 开关（S301）拨至'USB'位置。 步骤 2：将提供的 USB 串口驱动安装至电脑端，在电脑的'设备管理器'界面中可看到 USB 的端口号， 如下图所示。 图 4：USB 端口 步骤 3：安装由移远通信提供的 QCOM 工具。QCOM 通信端口设置如下所示（默认波特率：9600 bps 1）。 图 5：QCOM 通信端口设置界面 步骤 4：选择正确的'COM Port'（端口号如图 4 所示）和'Baudrate'。 步骤 5：点击'Open Port'（打开端口），如图 5 所示。与 EVB 的通信建立成功后，L76K 模块输出的 NMEA 语句将通过 QCOM 工具显示出来，如图 6 所示。 1 UART 接口默认波特率会因软件版本不同而有所变化。 上海移远通信技术股份有限公司 14 / 21 L76K EVB 用户指导 图 6：QCOM 界面 NMEA 语句输出 上海移远通信技术股份有限公司 15 / 21 L76K EVB 用户指导 5 使用 QGNSS 工具进行测试 本章节介绍了如何使用软件工具 QGNSS 验证 L76K 模块的状态。更多有关 QGNSS 工具的使用信息， 请参考文档 [2]。 软件工具 QGNSS 可从移远通信官网（下载专区）下载，也可从移远通信技术支持处获取。 5.1. QGNSS 工具设置 步骤 1：将配件连接至EVB板。 步骤 2：将 EVB 通过 USB 线连接至电脑，再将电源开关（S201）拨至'ON'状态，给 EVB 上电。并将 UART↔USB 开关（S301）拨至'USB'位置。 步骤 3：打开由移远通信提供的QGNSS工具。点击'Setting'和'Serial Port Configuration'（默认波 特率：9600 bps 2）。 图 7：COM 端口和波特率设置 2 UART 接口默认波特率因软件版本不同而有所变化。 上海移远通信技术股份有限公司 16 / 21 L76K EVB 用户指导 步骤 4：点击 'Connect or disconnect'按钮。成功连接模块之后，QGNSS界面如下图所示。 图 8：QGNSS 界面（已连接） 5.1.1. 窗口界面说明 在 QGNSS 界面中可以查看 GNSS 信息，例如 C/N0 信息、时间、位置、速度和精度等。有关这些参 数的详细信息，请参考下表。 表 5：QGNSS 窗口界面说明 图标 说明 此天空视图界面显示正在被追踪的卫星信息。 1) 左侧图标显示正在被追踪的卫星及其数量。 ⚫ BDS：4 ⚫ GLO（GLONASS）：0 ⚫ GPS：11 ⚫ GAL（Galileo）：0 ⚫ QZSS：0 ⚫ NavIC（IRNSS）：0 ⚫ SBAS：0 2) 右侧的栅格地图显示了正在被追踪中的卫星方位。 上海移远通信技术股份有限公司 17 / 21 GPS 卫星 BDS 卫星 GLONASS 卫星 Galileo 卫星 QZSS 卫星 NavIC（IRNSS）卫星 L76K EVB 用户指导 ⚫ PRN 30 的 C/N0 值是 39 dB-Hz。 ⚫ 亮红色柱表示卫星的导航数据正在使用中。 ⚫ PRN 1 的 C/N0 值是 21 dB-Hz。 ⚫ 浅红色柱表示该卫星的导航数据未被使用。 ⚫ 经度（单位：度） ⚫ 纬度（单位：度） ⚫ 平均海拔高度（MSL，单位：m） ⚫ 椭球面高度（EPH，单位：m） ⚫ 接收机速度（单位：km/h） ⚫ 水平精度因子 ⚫ 位置精度因子 ⚫ 定位模式：2D、3D ⚫ 质量指标：包含 DGNSS、DGPS 和 GPS SPS 模式 ⚫ UTC 日期和时间 ⚫ TOD 时间 3（单位：秒） ⚫ GPS 差分数据时间 ⚫ TTFF（单位：秒） 3 从当天午夜开始经过的总秒数。 上海移远通信技术股份有限公司 18 / 21 ⚫ 总次数 ⚫ 定位点 ⚫ RTK 浮点解 ⚫ RTK 固定解 L76K EVB 用户指导 上海移远通信技术股份有限公司 19 / 21 L76K EVB 用户指导 6 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_QCOM_User_Guide [2] Quectel_QGNSS_User_Guide 表 7：术语缩写 缩写 BDS COM Port CEP C/N0 DI DO EPH EVB GND GNSS GPS I/O LED Micro-USB 英文全称 BeiDou Navigation Satellite System Communication Port Circular Error Probable Carrier-to-Noise Ratio Digital Input Digital Output Ellipsoidal Height Evaluation Board Ground Global Navigation Satellite System Global Positioning System Input/Output Light Emitting Diode Micro Universal Serial Bus 中文全称 北斗导航卫星系统 通信串口 圆误差概率 载噪比 数字输入 数字输出 椭球面高度 评估板 地 全球导航卫星系统 全球定位系统 输入/输出 发光二极管 微型通用串行总线 上海移远通信技术股份有限公司 20 / 21 MSL NMEA PI PO PRN RMS ROM SBAS SPS TTFF UART UTC L76K EVB 用户指导 Mean Sea Level 平均海平面 NMEA (National Marine Electronics NMEA（美国船舶电子协会）0183 接 Association) 0183 Interface Standard 口标准 Power Input 输入电源 Power Output 输出电源 Pseudorandom Noise 伪随机噪声 Root Mean Square 均方根 Read Only Memory 只读存储器 Satellite-Based Augmentation System 星基增强系统 Standard Positioning Service 标准定位服务 Time to First Fix 首次定位时间 Universal Asynchronous Receiver & 通用异步收发器 Transmitter Coordinated Universal Time 协调世界时 上海移远通信技术股份有限公司 21 / 21

BG770A-GL TE-A User Guide LPWA Module Series Version: 1.0 Date: 2021-12-29 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG770A-GL_TE-A_User_Guide 1 / 23 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. BG770A-GL_TE-A_User_Guide 2 / 23 LPWA Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular or mobile terminal incorporating the module. Manufacturers of the cellular terminal should distribute the following safety precautions to users and operating personnel, and incorporate them into all product manuals. Otherwise, Quectel assumes no liability for customer failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile terminal while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular or mobile terminals operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include refueling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. BG770A-GL_TE-A_User_Guide 3 / 23 LPWA Module Series About the Document Revision History Version Date Author Description - 2021-12-22 Lex LI Creation of the document 1.0 2021-12-29 Lex LI First official release BG770A-GL_TE-A_User_Guide 4 / 23 LPWA Module Series Contents Safety Information....................................................................................................................................... 3 About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 6 Figure Index ................................................................................................................................................. 7 1 Introduction .......................................................................................................................................... 8 2 Product Concept .................................................................................................................................. 9 2.1. Top and Bottom Views............................................................................................................. 9 2.2. Component & Interface Introduction ..................................................................................... 10 3 Application Interfaces ....................................................................................................................... 11 3.1. UART Interfaces .................................................................................................................... 11 3.2. BTB Connector ...................................................................................................................... 12 3.3. Test Points ............................................................................................................................. 16 4 Operating Procedures ....................................................................................................................... 18 4.1. Physical Assembly................................................................................................................. 18 4.2. Turning On/Off ....................................................................................................................... 19 4.3. Communicating with the Module via UART Interfaces.......................................................... 19 4.4. Firmware Upgrading .............................................................................................................. 20 5 Appendix References ........................................................................................................................ 22 BG770A-GL_TE-A_User_Guide 5 / 23 LPWA Module Series Table Index Table 1: Components and Interfaces of BG770A-GL TE-A ....................................................................... 10 Table 2: Pin Definition of the BTB1 Connector .......................................................................................... 13 Table 3: Pin Definition of Test Points.......................................................................................................... 16 Table 4: Related Documents ...................................................................................................................... 22 Table 5: Terms and Abbreviations .............................................................................................................. 22 BG770A-GL_TE-A_User_Guide 6 / 23 LPWA Module Series Figure Index Figure 1: BG770A-GL TE-A Top View .......................................................................................................... 9 Figure 2: BG770A-GL TE-A Bottom View .................................................................................................... 9 Figure 3: UART Interface ............................................................................................................................11 Figure 4: CP2102N Driver Installation ....................................................................................................... 12 Figure 5: BTB Connectors.......................................................................................................................... 13 Figure 6: Test Points................................................................................................................................... 16 Figure 7: Connection Between BG770A-GL TE-A, UMTS&LTE EVB and Antennas ................................ 18 Figure 8: Main UART Communication ....................................................................................................... 20 Figure 9: Emergency Download Mode Test Points.................................................................................... 21 BG770A-GL_TE-A_User_Guide 7 / 23 LPWA Module Series 1 Introduction This user guide describes the application details of BG770A-GL TE-A, which is an assistant tool for engineers to develop applications and test basic functionalities with Quectel BG770A-GL. BG770A-GL TE-A is intended to be used in combination with UMTS&LTE EVB. For detailed description of UMTS&LTE EVB, see document [1]. This EVB is suitable for the BG770A-GL TE-A’s functional tests. As peripheral devices on the EVB impact power consumption measurement, if accurate power consumption test results on TE-A are needed, please contact Quectel Technical Support. BG770A-GL_TE-A_User_Guide 8 / 23 LPWA Module Series 2 Product Concept 2.1. Top and Bottom Views F G A B D C E H I Figure 1: BG770A-GL TE-A Top View J J Figure 2: BG770A-GL TE-A Bottom View BG770A-GL_TE-A_User_Guide 9 / 23 LPWA Module Series 2.2. Component & Interface Introduction Detailed information about components and interfaces of BG770A-GL TE-A is listed below. Table 1: Components and Interfaces of BG770A-GL TE-A SN Component/Interface Description A UART_AUX Connects to auxiliary UART through CP2102N USB to UART bridge with the highest baud rate at 3 Mbps. Provides additional 1.8 V voltage to PON_TRIG switch. Note that B External 1.8 V LDO when UART_DBG and UART_AUX are not connected with a USB cable, LDO does not work. C UART_DBG D PON_TRIG Switch Connects to debug UART through CP2102N USB to UART bridge with the highest baud rate at 3 Mbps. When the switch is at '1V8' state, PON_TRIG is pulled up high. At 'GND' state, PON_TRIG is grounded via a 100 kΩ resistor. Short-circuit these two test points (DEBUG_TXD and DEBUG_RXD) E UART_DBG Test Points and then reset the module via the RESET button on EVB, the BG770A-GL enters the recovery mode. F GNSS Antenna Interface GNSS antenna connector G Main Antenna Interface Main antenna connector Polymer Tantalum H Capacitor According to tests, these two capacitors have a leakage current of over 2 μA. Switching to 'ON' turns on the power-on circuit automatically. When Automatic Power-on I Switch VBAT rushes from 0 V to 3.3 V, the module will boot automatically. By switching to 'OFF', the power circuit is disconnected automatically. When the automatic power-on circuit is enabled, there is a constant current consumption of about 700 μA. CP2102N USB to UART J For more information, see Chapter 3.1. Bridges NOTE All other interfaces and test points, which are not mentioned in the table above, are reserved for debugging purpose only - they are not for customers. BG770A-GL_TE-A_User_Guide 10 / 23 LPWA Module Series 3 Application Interfaces 3.1. UART Interfaces Figure 3: UART Interface UART_DBG is for firmware upgrading, software debugging, log outputting and NMEA messages outputting. UART_AUX is used for RF calibration and log outputting. Install the USB to UART Bridge VCP Driver before you use the UART interfaces. Access Silicon Labs’ official website from here CP2102N_QFN28 to acquire the installation package. The detailed downloading and installation steps are illustrated below. Some new versions of Windows 10 may automatically install the driver. The figure below is an example of the installation under the Windows x64 system. Once the driver is installed, you can receive boot logs via QCOM, or for subsequent firmware upgrades. BG770A-GL_TE-A_User_Guide 11 / 23 LPWA Module Series Figure 4: CP2102N Driver Installation 3.2. BTB Connector The BTB connector is used to connect TE-A to UMTS&LTE EVB. Most module pins are connected to BTB1 connector; some pins are connected directly to TE-A’s peripheral circuit or test points; and no pins are connected to BTB2 connector. Module signals derived from BTB1 connector are listed below: ⚫ PCM ⚫ I2C ⚫ RESET_N ⚫ PWRKEY ⚫ ADC1 ⚫ ADC0 ⚫ STATUS_N 1 ⚫ NET_STATUS ⚫ GPIO ⚫ USB ⚫ AP_READY ⚫ W_DISABLE# ⚫ Main UART 1 To synchronize with the indication LEDs on UMTS&LTE EVB, an inverter is added to the STATUS output signal of BG770A-GL, therefore the signal of BTB1 connector is defined as 'STATUS_N'. BG770A-GL_TE-A_User_Guide 12 / 23 ⚫ VDD_EXT ⚫ USIM LPWA Module Series Figure 5: BTB Connectors Table 2: Pin Definition of the BTB1 Connector Pin No. 100 98 96 94 92 90 88 86 84 Pin Name I/O VBAT PI VBAT PI GND - GND - GND - - - AP_READY DI - - W_DISABLE# DI Pin No. 99 97 95 93 91 89 87 85 83 Pin Name I/O VBAT PI VBAT PI VBAT PI GND - GND - - - - - - - USB_VBUS DI BG770A-GL_TE-A_User_Guide 13 / 23 82 - - 81 80 MAIN_RXD DI 79 78 MAIN_TXD DO 77 76 MAIN_DTR DI 75 74 MAIN_RTS DI 73 72 MAIN_CTS DO 71 70 MAIN_DCD DO 69 68 MAIN_RI DO 67 66 VDD_EXT PO 65 64 GND - 63 62 GPIO3 DIO 61 60 GPIO2 DIO 59 58 GPIO5 DIO 57 56 GPIO7 DIO 55 54 GND - 53 52 - - 51 50 - - 49 48 - - 47 46 - - 45 44 - - 43 42 - - 41 40 - - 39 38 GND - 37 36 - - 35 34 - - 33 32 - - 31 BG770A-GL_TE-A_User_Guide LPWA Module Series GND - USB_DM AIO USB_DP AIO GND - - - - - - - GPIO4 DIO NET_STATUS DO - - STATUS_N DO - - - - GND - ADC0 AI GND - ADC1 AI GND - PWRKEY DI RESET_N DI - - GND - I2C_SCL DO I2C_SDA DIO GND PCM_CLK DO 14 / 23 30 - - 29 28 - - 27 26 - - 25 24 - - 23 22 - - 21 20 - - 19 18 - - 17 16 GND - 15 14 USIM_DET DI 13 12 USIM_VDD PO 11 10 USIM_DATA DIO 9 8 USIM_CLK DO 7 6 USIM_RST DO 5 4 USIM_GND - 3 2 GND - 1 LPWA Module Series PCM_SYNC DO PCM_OUT DO PCM_IN DI - - - - - - - - - - - - - - - - - - - - GND - GND - BG770A-GL_TE-A_User_Guide 15 / 23 3.3. Test Points LPWA Module Series 148 259 3 6 10 7 11 13 12 14 20 18 19 15 16 17 21 24 22 25 23 26 27 28 29 Figure 6: Test Points Table 3: Pin Definition of Test Points No. Pin Name 2 I/O Description 1 GPIO6 DIO General-purpose input/output 2 AUX_RTS 2 DI DTE request to send signal from DCE (Connects to DTE’s RTS) 3 AUX_RXD DI Auxiliary UART receiver 4 GRFC1 DO Generic RF controller 5 AUX_CTS 2 DO DTE request to send signal from DCE (Connects to DTE’s CTS) 6 AUX_TXD DO Auxiliary UART transmitter 7 VDD_1V8 PO External 1V8 LDO output 8 GRFC2 DO Generic RF controller 9 GPIO1 DIO General-purpose input/output 10 PON_TRIG DI Used to enter or exit e-l-DRX, sleep, PSM and power-down 2 The 'Pin Name' column is defined as per the module pins that the test points connect to; therefore, the Pin Names might be different from the test point names (i.e., the silk screen printed names on the TE-A). BG770A-GL_TE-A_User_Guide 16 / 23 LPWA Module Series modes 11 DBG_CTS 2 DO DTE request to send signal from DCE (Connects to DTE’s CTS) 12 DBG_TXD DO Debug UART transmitter 13 DBG_RTS 2 DI DTE request to send signal from DCE (Connects to DTE’s RTS) 14 DBG_RXD DI Debug UART receiver 15 USB_DM AIO USB differential data (-) 16 USB_DP AIO USB differential data (+) 17 USB_VBUS AI USB connection detection 18 RESET_N DI Reset the module 19 PWRKEY DI Turn on/off the module 20 VDD_EXT PO Provide 1.8 V for external circuit 21 ADC1 AI General-purpose ADC interface 22 STATUS DO Indicate the module's operation status 23 AP_READY DI Application processor ready 24 ADC0 AI General-purpose ADC interface 25 NET_ STATUS DO Indicate the module's network activity status 26 W_DSIABLE# DI Airplane mode control 27 GPIO4 DIO General-purpose input/output 28 GND - - 29 VBAT PI Power supply for module NOTE All other test points, which are not mentioned in the table above, are reserved for debugging purpose only - they are not for customers. BG770A-GL_TE-A_User_Guide 17 / 23 LPWA Module Series 4 Operating Procedures 4.1. Physical Assembly The connection between BG770A-GL TE-A, UMTS&LTE EVB and main/GNSS antenna is presented below: Figure 7: Connection Between BG770A-GL TE-A, UMTS&LTE EVB and Antennas BG770A-GL_TE-A_User_Guide 18 / 23 LPWA Module Series 4.2. Turning On/Off Turn on/off procedure of BG770A-GL TE-A is controlled by TE-A itself and UMTS&LTE EVB. See document [1] and document [2] for more information. NOTE 1. With the TE-A and UMTS&LTE EVB, BG770A-GL supports automatic power-on according to the steps illustrated below: a) Connect the TE-A to the EVB. b) Switch the Automatic Power-on switch on TE-A to 'ON' state. c) Power on the EVB by connecting it to a power supply and switch S201 (Power Switch) on EVB to 'ON' state. d) The module powers on automatically. 2. Use of PON_TRIG switch on TE-A during the turning on procedure: a) Connect the TE-A to the EVB. b) Power on the EVB by connecting it to a power supply and switch S201 (Power Switch) on EVB to 'ON' state. c) Press S302 (PWRKEY) on EVB for 500–1000 ms, after which switch the PON_TRIG switch on TE-A to '1V8' state. d) The module powers on. 3. Use of PON_TRIG switch on TE-A during the turning off procedure: a) Press down the S302 button on EVB, or execute AT+APOWD. See document [3] for details of the command. b) Switch the PON_TRIG switch on TE-A to 'GND' state to power off the module. 4.3. Communicating with the Module via UART Interfaces 1. Connect the main UART of EVB to PC’s USB port with the USB-to-UART converter cable. 2. Connect the debug UART of BG770A-GL TE-A to PC’s USB port with the micro-USB cable. 3. Switch the PON_TRIG switch on BG770A-GL TE-A to '1V8' state (refer to figure below). Please note that if debug UART is not connected and the PON_TRIG switch is not switched to '1V8', then the main UART will be inaccessible. The debug UART of BG770A-GL is directly connected to TE-A's CP2102N by default. Therefore, COM2 on UMTS&LTE EVB cannot be used for debugging. BG770A-GL_TE-A_User_Guide 19 / 23 LPWA Module Series Figure 8: Main UART Communication 4.4. Firmware Upgrading If the module can be turned on normally, you can directly upgrade the firmware through the debug UART on the TE-A. If the module cannot be turned on normally, you can refer to the following steps to enter the recovery mode and upgrade the firmware forcibly. For more information about the recovery mode, please refer to document [2]. 1. Disconnect the Micro-USB cable of UART_DBG. 2. Short-circuit the two test points (DBG_TXD and DBG_RXD), and press S303 (RESET button) at least 100 ms on the UMTS&LTE EVB to reset the BG770A-GL. 3. Disconnect DBG_TXD and DBG_RXD. 4. Insert the Micro-USB cable of UART_DBG and upgrade the firmware through this UART. BG770A-GL_TE-A_User_Guide 20 / 23 LPWA Module Series Figure 9: Emergency Download Mode Test Points BG770A-GL_TE-A_User_Guide 21 / 23 LPWA Module Series 5 Appendix References Table 4: Related Documents Document Name [1] Quectel_UMTS&LTE_EVB_User_Guide [2] Quectel_BG770A-GL_Hardware_Design [3] Quectel_BG770A-GL&BG95xA-GL_AT_Commands_Manual Table 5: Terms and Abbreviations Abbreviation ADC BTB CLK DCE DI DTE e-I-DRX EVB GND GNSS GPIO I/O I2C Description Analog-to-Digital Converter Board-to-Board Clock Data Communications Equipment Digital Input Data Terminal Equipment extended Idle Discontinuous Reception Evaluation Board Ground Global Navigation Satellite System General Purpose Input/Output Input/Output Inter-Integrated Circuit BG770A-GL_TE-A_User_Guide 22 / 23 LDO LED LTE NMEA PC PSM RF RTS RXD SCL SDA TXD UART USB UMTS VBAT VDD LPWA Module Series Low-dropout Regulator Light Emitting Diode Long-Term Evolution National Marine Electronics Association) 0183 Interface Standard Personal Computer Power Saving Mode Radio Frequency Request to Send Receive Data (Pin) Serial Clock Serial Data Line Transmit Data (Pin) Universal Asynchronous Receiver/Transmitter Universal Serial Bus Universal Mobile Telecommunications System Voltage at Battery (Pin) Drain Voltage (Pin) BG770A-GL_TE-A_User_Guide 23 / 23

LC29H 系列 EVB 用户指导 GNSS 模块系列 版本：1.1 日期：2023-04-26 状态：受控文件 LC29H 系列 EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 36 LC29H 系列 EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 36 LC29H 系列 EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 请确保产品的使用符合国家和行业基础标准、安全标准和环境保护标准的要求，并符合 国家和特定场所对产品使用的具体规定。 请确保终端产品远离易燃易爆品。在极端供电和任何有潜在爆炸危险的（如靠近加油 站、油库、化工厂或爆炸作业场所）环境下使用电子产品可能存在安全隐患。 必须为产品提供稳定可靠的电源，并确保所有接线符合相关安全和防火法规。 在产品安装和使用过程中，必须小心处理以避免因为静电而对产品造成损坏。 上海移远通信技术股份有限公司 3 / 36 LC29H 系列 EVB 用户指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 LC29H 系列 EVB 用户指导 GNSS 模块系列 EVB 用户指导 受控文件 修订历史 版本 1.0 1.1 日期 2022-04-01 2022-06-24 2023-04-26 描述 文档创建 受控版本 1. EVB 版本号由 V1.2 更新至 V1.3。 2. 删除使用 QCOM 工具进行通信的章节。 3. 更新固件升级工具为 QGNSS（第 1 章）。 4. 新增以下章节，包括： DR 应用（第 5 章）； RTK 应用（第 6 章）； EVB 及天线安装（第 7 章）； 功耗测量指导（第 8 章）； EVB 框架（第 9 章）； 常见问题及故障排除（第 10 章）； 注意事项（第 11 章）。 上海移远通信技术股份有限公司 4 / 36 LC29H 系列 EVB 用户指导 目录 安全须知 ....................................................................................................................................................... 3 关于文档 ....................................................................................................................................................... 4 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 简介 ....................................................................................................................................................... 8 1.1. 特殊符号 ..................................................................................................................................... 8 2 概述 ....................................................................................................................................................... 9 2.1. EVB 套件 .................................................................................................................................... 9 2.2. EVB 套件连接示意图.................................................................................................................11 3 接口 ..................................................................................................................................................... 12 3.1. 位号分布图 ............................................................................................................................... 12 3.2. EVB 接口 .................................................................................................................................. 13 4 使用 QGNSS 工具进行测试和固件升级 .............................................................................................. 16 4.1. 使用 QGNSS 工具进行测试 ..................................................................................................... 16 4.2. 窗口界面说明............................................................................................................................ 18 4.3. 固件升级 ................................................................................................................................... 19 5 DR 应用 ............................................................................................................................................... 23 6 RTK 应用............................................................................................................................................. 24 7 EVB 及天线安装.................................................................................................................................. 26 7.1. GNSS 天线安装........................................................................................................................ 26 7.2. EVB 安装 .................................................................................................................................. 26 8 功耗测量指导....................................................................................................................................... 27 8.1. 各功耗阶段 ............................................................................................................................... 27 8.2. VCC 功耗测量 .......................................................................................................................... 27 8.3. V_BCKP 功耗测量.................................................................................................................... 29 9 EVB 框架............................................................................................................................................. 31 10 常见问题及故障排除............................................................................................................................ 32 11 注意事项 .............................................................................................................................................. 33 12 附录 参考文档及术语缩写 ................................................................................................................... 34 上海移远通信技术股份有限公司 5 / 36 LC29H 系列 EVB 用户指导 表格索引 表 1：特殊符号 ............................................................................................................................................. 8 表 2：EVB 套件清单................................................................................................................................... 10 表 3：接口定义 ........................................................................................................................................... 13 表 4：J401 引脚描述 .................................................................................................................................. 14 表 5：J402 引脚描述 .................................................................................................................................. 15 表 6：QGNSS 窗口界面说明...................................................................................................................... 18 表 7：参考文档 ........................................................................................................................................... 34 表 8：术语缩写 ........................................................................................................................................... 34 上海移远通信技术股份有限公司 6 / 36 LC29H 系列 EVB 用户指导 图片索引 图 1：EVB 套件图......................................................................................................................................... 9 图 2：EVB 套件连接示意图 .........................................................................................................................11 图 3：EVB 器件分布图 ............................................................................................................................... 12 图 4：COM 口和波特率设置....................................................................................................................... 16 图 5：QGNSS 界面（已连接） .................................................................................................................. 17 图 6：工具启动 ........................................................................................................................................... 19 图 7：工具设置 ........................................................................................................................................... 20 图 8：固件选择 ........................................................................................................................................... 20 图 9：固件升级 - 1...................................................................................................................................... 21 图 10：固件升级 - 2.................................................................................................................................... 21 图 11：固件升级成功.................................................................................................................................. 22 图 12：NTRIP Client 设置 .......................................................................................................................... 24 图 13：RTK 状态显示................................................................................................................................. 25 图 14：各阶段功耗 ..................................................................................................................................... 27 图 15：用电流表测量 VCC 功耗................................................................................................................. 28 图 16：用耗流仪测量 VCC 功耗................................................................................................................. 28 图 17：用电流表测量 V_BCKP 功耗 .......................................................................................................... 29 图 18：用耗流仪测量 V_BCKP 功耗 .......................................................................................................... 30 图 19：EVB 框架 ........................................................................................................................................ 31 上海移远通信技术股份有限公司 7 / 36 LC29H 系列 EVB 用户指导 1 简介 移远通信提供一整套 LC29H EVB 配件，以方便 LC29H 系列模块的测试和使用。本文档介绍了 LC29H EVB 套件及接口的基本信息，并提供了详细的 EVB 使用指导，主要包括如何使用软件工具 QGNSS 进行 测试和固件升级、DR 和 RTK 应用、EVB 及天线安装、功耗测量指导、EVB 框架、常见问题及故障排除和 注意事项。 LC29H 系列模块包括：LC29H (AA)、LC29H (BA)、LC29H (CA)、LC29 (DA)和 LC29 (EA)。 备注 1. QGNSS 工具可从移远通信技术支持处获取（support@quectel.com）。 2. 有关 LC29H (BS) EVB 的使用详情，请参考文档 [1] EVB 用户指导。 1.1. 特殊符号 表 1：特殊符号 标记 * 定义 若无特别说明，模块功能、特性、接口、引脚名称、或参数后所标记的星号（*）表示该功 能、特性、接口、引脚、或参数正在开发中，因此暂不支持；模块子型号后所标记的星号 （*）表示该子型号暂无样品。 上海移远通信技术股份有限公司 8 / 36 LC29H 系列 EVB 用户指导 2 概述 2.1. EVB 套件 EVB 配件包括：EVB 板、GNSS 有源天线、Type-B USB 连接线、铜柱和螺丝。 EVB 套件如下图所示，详情见表 2：EVB 套件清单。 Type-B USB连接线 螺丝和铜柱 GNSS有源天线 EVB 图 1：EVB 套件图 上海移远通信技术股份有限公司 9 / 36 表 2：EVB 套件清单 项目 EVB USB 线 GNSS 有源天线 其它 描述 LC29H 评估板 尺寸：80 mm × 120 mm Type-B USB 连接线 GNSS 有源天线（型号：YB0017AA） 天线尺寸：61.5 mm × 56.5 mm × 23 mm 线长：3000 mm 配件中的天线支持如下星系和频段： ⚫ GPS L1 C/A和L5 ⚫ GLONASS L1 ⚫ Galileo E1和E5a ⚫ BDS B1I和B2a ⚫ QZSS L1 C/A和L5 ⚫ SBAS L1（仅LC29H (AA, DA)支持） 铜柱和螺丝 LC29H 系列 EVB 用户指导 数量 1 2 1 4对 备注 有关 GNSS 有源天线详情，请联系移远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 10 / 36 2.2. EVB 套件连接示意图 EVB 套件连接示意图如下所示。 LC29H 系列 EVB 用户指导 图 2：EVB 套件连接示意图 备注 1. 客户可选择不使用 Type-B USB 线连接电脑和 EVB 的'POWER SUPPLY'接口（J201），详情请 参考第 3.2 章 EVB 接口。 2. 将 GNSS 有源天线放置在可检测到卫星的户外开阔地带。 上海移远通信技术股份有限公司 11 / 36 LC29H 系列 EVB 用户指导 3 接口 3.1. 位号分布图 EVB 的器件位号分布图如下所示。 S201 (电源开关) J501 (USB to UART) D501 (POWER和VCC LED指示灯) D507 (1PPS和TXD LED指示灯) J201 (POWER SUPPLY) 测试点16 测试点15 J401 (测试点) 测试点1 1 4 8 5 EVB版本号 U601 (LC29H GNSS模块) J402 (OBD) S501 (WAKEUP按键) S502 (RESET按键) J510 (1PPS连接器) 图 3：EVB 器件分布图 J101 (GNSS天线连接器) 上海移远通信技术股份有限公司 12 / 36 LC29H 系列 EVB 用户指导 3.2. EVB 接口 EVB 接口如下表所示。 表 3：接口定义 功能 供电 通信接口 SMA 连接器 信号指示 开关和按键 其他 接口 J201 POWER SUPPLY J501 USB to UART J501 USB to UART J101 天线连接器 J510 1PPS连接器 D501 LED指示灯 POWER （红色LED） VCC （绿色LED） D507 LED指示灯 1PPS （红色LED） TXD （绿色LED） S201 电源开关 S501 WAKEUP按键 S502 RESET按键 J402 OBD 描述 J201：仅用于供电，避免J501供电不足。 J501：用于通信和供电。 供电输入： ⚫ 直流电源：4.5~5.5 V，典型值：5.0 V。 ⚫ 电流负载能力应大于100 mA。 支持NMEA标准语句、RTCM语句、二进制数据、 PAIR/PQTM语句和固件升级。 用于连接GNSS天线。 用于测试1PPS信号。 常亮：EVB 供电正常。 不亮：EVB 未供电。 常亮：模块供电正常。 不亮：模块未供电。 闪烁：定位成功，频率为1 Hz。 不亮：未定位。 闪烁：UART TXD 有数据输出。 不亮或常亮：UART TXD无数据输出。 控制模块电源的通断。 短按按键后释放，将模块从Backup模式中唤醒。 短按按键后释放，模块复位。 用 于 输 入 WHEELTICK 和 FWD 信 号 （ 仅 LC29H (BA, CA)可用）。引脚详情可参考表5： J402引脚描述。 上海移远通信技术股份有限公司 13 / 36 LC29H 系列 EVB 用户指导 J401 引脚描述如下所示： 表 4：J401 引脚描述 测试点序号 测试点标签 测试点功能 I/O 1 GND GND - 2 PIN1 U601：引脚 1 DI 3 PIN2 U601：引脚 2 DI 4 PIN3 U601：引脚 3 DO 5 PIN4 U601：引脚 4 DI 6 PIN5 U601：引脚 5 DI 7 PIN6 U601：引脚 6 DI 8 PIN7 U601：引脚 7 PO 9 PIN8 U601：引脚 8 DI 10 PIN9 U601：引脚 9 PO 11 PIN14 U601：引脚 14 DO 12 PIN15 U601：引脚 15 DO 13 PIN16 U601：引脚 16 DI 14 PIN17 U601：引脚 17 DO 15 无标签 - - 16 无标签 - - 17 无标签 - - 18 无标签 - - 19 无标签 - - 20 无标签 - - 21 无标签 - - 22 PIN23 U601：引脚 23 PI 描述 地 WAKEUP：从 Backup 模式中唤醒模块 FWD：正/反向状态信号输入（仅 LC29H (BA, CA)可用） 1PPS：一秒一个脉冲 WHEELTICK： 车 速 脉 冲 信 号 输 入 （ 仅 LC29H (BA, CA)可用） D_SEL1：UART1/I2C/SPI*接口选择 D_SEL2：UART1/I2C/SPI*接口选择 VDD_EXT：2.8 V 电源输出 RESET_N：复位模块 VDD_RF：外部射频电路供电 ANT_ON：控制外部 LNA 或有源天线供电 TXD2：UART2 发送数据 RXD2：UART2 接收数据 WI*：报警指示（仅 LC29H (BA, CA)可用） 不连接 不连接 不连接 不连接 不连接 不连接 不连接 VCC：主电源 上海移远通信技术股份有限公司 14 / 36 LC29H 系列 EVB 用户指导 测试点序号 测试点标签 测试点功能 I/O 23 PIN22 U601：引脚 22 PI 24 GND GND - 25 GND GND - 26 PIN21 U601：引脚 21 DI 27 PIN20 U601：引脚 20 DO 28 PIN19 U601：引脚 19 DI 29 PIN18 U601：引脚 18 DIO 30 无标签 - - 描述 V_BCKP：备份域电源 地 地 RXD1：接收数据 TXD1：发送数据 I2C_SCL：I2C 串行时钟 I2C_SDA：I2C 串行数据 不连接 J402 引脚描述如下所示： 表 5：J402 引脚描述 引脚序号 引脚标签 引脚功能 I/O 1 - GND - 2 CAN_L - - 3 CAN_H - - 4 - GND - 5 - - - 6 WHEELTICK WHEELTICK DI 7 FWD FWD DI 8 - - - 描述 地 不连接 不连接 地 车速脉冲信号输入（仅 LC29H (BA, CA)可用） 正/反向状态信号输入（仅 LC29H (BA, CA)可用） - 备注 1. J401 测试点按顺时针排序，序号如图 3：EVB 器件分布图中红色字体所示。 2. J401 测试点对应模块相应引脚功能，详情请见文档 [2] 硬件设计手册。 3. 关于 WHEELTICK 和 FWD 的参考电路图，见文档 [3] reference design。 上海移远通信技术股份有限公司 15 / 36 LC29H 系列 EVB 用户指导 4 使用 QGNSS 工具进行测试和固件升级 本章节介绍了如何使用软件工具 QGNSS 验证模块的状态以及进行固件升级。更多有关 QGNSS 工具 的使用信息，请参考文档 [4] QGNSS user guide。 4.1. 使用 QGNSS 工具进行测试 步骤 1：将配件连接至EVB。 步骤 2：将 EVB 通过'POWER SUPPLY'和'USB to UART'接口用两根 Type-B USB 线连接到电 脑，或通过'USB to UART'接口用一根 Type-B USB 线连接到电脑。再将电源开关（S201）拨至'ON' 状态给模块上电。 步 骤 3： 打 开QGNSS工 具 。 点 击 'Device' 和 'Set Device Information'（ 默 认 波 特 率 ： 115200 bps 1）。 图 4：COM 口和波特率设置 步骤 4：点击 'Connect or disconnect'按钮。成功连接模块之后，QGNSS界面如下图所示。 1 UART 接口默认波特率设置可能因软件版本而异。 上海移远通信技术股份有限公司 16 / 36 LC29H 系列 EVB 用户指导 图 5：QGNSS 界面（已连接） 备注 首次使用 QGNSS 工具，需确保已安装 CP210x 驱动。有关驱动详情，请联系移远通信技术支持 （support@quectel.com）。 上海移远通信技术股份有限公司 17 / 36 LC29H 系列 EVB 用户指导 4.2. 窗口界面说明 在 QGNSS 界面中可以查看 GNSS 信息，例如 C/N0 信息、时间、位置、速度和精度等。有关这些参 数的更多信息，请参考下表。 表 6：QGNSS 窗口界面说明 图标 说明 此天空视图界面显示正在被追踪的卫星信息。 1) 左侧图标显示正在被追踪的卫星及其数量。 ⚫ BDS：10 ⚫ GLO（GLONASS）：6 ⚫ GPS：12 ⚫ GAL（Galileo）：7 ⚫ QZSS：0 ⚫ NAVIC：0 ⚫ SBAS：0 2) 右侧的天空图显示了正在被追踪中的卫星方位。 GPS 卫星 BDS 卫星 GLONASS 卫星 Galileo 卫星 QZSS 卫星 NavIC 卫星 ⚫ PRN 30 的 C/N0 值是 39 dB-Hz。 ⚫ 亮红色柱表示卫星的导航数据正在使用中。 ⚫ PRN 1 的 C/N0 值是 21 dB-Hz。 ⚫ 浅红色柱表示该卫星的导航数据未被使用。 上海移远通信技术股份有限公司 18 / 36 图标 LC29H 系列 EVB 用户指导 说明 ⚫ 经度（单位：°） ⚫ 纬度（单位：°） ⚫ 平均海拔高度（MSL，单位：m） ⚫ 接收机速度（单位：km/h） ⚫ 水平精度因子（HDOP） ⚫ 位置精度因子（PDOP） ⚫ 定位模式：2D、3D ⚫ 质 量 指 标 ： 包 含 DGNSS、DGPS、GPS SPS、RTK 浮 点 （Float RTK）和 RTK 固定（Fixed RTK）模式 ⚫ 日期：UTC 日期 ⚫ 时间：UTC 时间 ⚫ 总次数 ⚫ 定位点 ⚫ RTK 固定解 ⚫ RTK 浮点解 ⚫ GPS 差分数据时间 ⚫ TTFF（单位：s） ⚫ 2D 定位精度（单位：m） ⚫ 3D 定位精度（单位：m） 4.3. 固件升级 固件升级之前，需保证模块已上电，详情可参考第 4.1 章 使用 QGNSS 工具进行测试。 固件升级详细步骤如下： 步骤 1：打开 QGNSS 工具，点击'Tools'，并在下拉框中选择'Firmware Download'。 上海移远通信技术股份有限公司 图 6：工具启动 19 / 36 LC29H 系列 EVB 用户指导 步骤 2：在'Settings'下拉框中选择'Download Baudrate'（921600 bps 或 115200 bps）。 ② 图 7：工具设置 步骤 3：点击 'Open Config File'按钮，选择相应的 Config 文件，例如'flash_download.cfg'。 ③ 图 8：固件选择 步骤 4：点击 'Run'按钮，待进度条提示复位模块后短按复位键，开始下载固件。 上海移远通信技术股份有限公司 20 / 36 LC29H 系列 EVB 用户指导 图 9：固件升级 - 1 图 10：固件升级 - 2 步骤 5：固件升级成功时，QGNSS 工具界面上将显示一个进度为'100 %'的进度条。 上海移远通信技术股份有限公司 21 / 36 LC29H 系列 EVB 用户指导 图 11：固件升级成功 上海移远通信技术股份有限公司 22 / 36 LC29H 系列 EVB 用户指导 5 DR 应用 LC29H (BA)和 LC29H (CA)模块支持 DR 功能。本章主要介绍模块的 DR 功能。 在使用 DR 功能之前，需要对内置 IMU 的模块进行校准。为了保证模块的性能，在使用过程中必须确 保 EVB 紧紧地安装在车辆上，车辆和 EVB 之间不允许有相对运动。有关更多信息，可参考文档 [5] DR&RTK application note。 上海移远通信技术股份有限公司 23 / 36 LC29H 系列 EVB 用户指导 6 RTK 应用 LC29H (BA)、LC29H (DA)和 LC29H (EA)模块支持 RTK 功能。本章主要介绍测试模块 RTK 功能的操 作步骤。 在 RTK 数据传输前，需确保服务器网络通畅，并设置好 COM 端口和波特率，详情可参考第 4.1 章 使 用 QGNSS 工具进行测试。 测试 RTK 功能的详细步骤如下： 步骤 1：点击 'NTRIP Client'按钮，弹出 NTRIP Client 窗口。 步骤 2：在窗口中填写 NTRIP 账户信息（需客户自行获取）。确保使用区域内支持 RTK 校正服务。 步骤 3：点击'Update NTRIP source table'按钮，选择相应的'NTRIP mount point'。然后， 点击'Connect To Host'按钮至'ON'，连接 NTRIP 服务器，如下图所示。 ➀ ➁ ➂ 图 12：NTRIP Client 设置 建立连接后，RTK 状态可通过查询 GGA 语句的质量指标确认模块进入的 RTK 状态：2 表示模块进入 差分模式，4 表示模块进入 RTK 固定模式，5 表示模块进入 RTK 浮点模式。如下图所示： 上海移远通信技术股份有限公司 24 / 36 LC29H 系列 EVB 用户指导 图 13：RTK 状态显示 上海移远通信技术股份有限公司 25 / 36 LC29H 系列 EVB 用户指导 7 EVB 及天线安装 7.1. GNSS 天线安装 天线安装的周围环境会影响天线的接收性能和可见卫星，从而影响 GNSS 接收机的定位性能。此外， 天线方向来也会影响接收性能，故应当选择远离障碍物和干扰的位置进行安装。陶瓷贴片天线需水平放置， 保证天线辐射面朝向天空。 如果需要动态场景测试，安装天线时，应保证天线牢固地附着在测试设备上，避免与测试设备间产生 任何相对运动或震动。 7.2. EVB 安装 如果需要动态场景测试和 DR 性能测试，必须保证 EVB 牢固地附着在测试设备上，避免与测试设备间 产生任何相对运动或震动，否则会严重影响 DR 的性能。 上海移远通信技术股份有限公司 26 / 36 LC29H 系列 EVB 用户指导 8 功耗测量指导 8.1. 各功耗阶段 测量模块功耗时，将功耗分为三个阶段，分别为捕获和跟踪（包含历书下载）、跟踪（历书下载结束） 及进入 Backup 模式。 ⚫ 捕获和跟踪（包含历书下载）：0 s~12.5 min ⚫ 跟踪（历书下载结束）：12.5 min 之后 ⚫ 进入 Backup 模式 电流 12.5 min 进入Backup模式 VCC 捕获和跟踪 （包含历书下载） 跟踪 （历书下载结束） V_BCKP 0 12.5 min 时间 图 14：各阶段功耗 8.2. VCC 功耗测量 测量功耗之前，需将配件连接至 EVB，保证模块可以正常通信及定位，详情可参考第 4.1 章 使用 QGNSS 工具进行测试。 使用电流表测量 VCC 功耗的详细步骤： 步骤 1： 关闭电源开关（S201），拔出VCC_MODULE（J601）跳线帽，将电流表串联至J601排针两 端，如下所示。 步骤 2： 打开电源开关（S201），读取电流表读数。 上海移远通信技术股份有限公司 27 / 36 电流表 LC29H 系列 EVB 用户指导 图 15：用电流表测量 VCC 功耗 使用耗流仪测量VCC功耗的详细步骤： 步骤 1： 关闭电源开关（S201），拔出VCC_MODULE（J601）跳线帽后，需将耗流仪正极连接至 J601的引脚2（无箭头丝印），负极连接至GND，如下图所示： 步骤 2： 打开电源开关（S201），读取耗流仪读数。 耗流仪 GND VCC 图 16：用耗流仪测量 VCC 功耗 上海移远通信技术股份有限公司 28 / 36 LC29H 系列 EVB 用户指导 8.3. V_BCKP 功耗测量 功耗测量之前，需将配件连接至 EVB，保证模块可以正常通信及定位，详情可参考第 4.1 章 使用 QGNSS 工具进行测试。 使用电流表测量 V_BCKP 功耗的详细步骤： 步骤 1： 关闭电源开关（S201），拔出V_BACK（J202）跳线帽，将电流表串联至排针两端，如下图 所示。 步骤 2： 打开电源开关（S201），读取电流表读数。 电流表 图 17：用电流表测量 V_BCKP 功耗 使用耗流仪测量 V_BCKP 功耗的详细步骤： 步骤 1： 关闭电源开关（S201），拔出V_BCKP（J202）跳线帽后，需将耗流仪正极连接至J202的引 脚1（有箭头丝印），负极连接至GND，如下图所示： 步骤 2： 打开电源开关（S201），读取耗流仪读数。 上海移远通信技术股份有限公司 29 / 36 耗流仪 GND VCC LC29H 系列 EVB 用户指导 图 18：用耗流仪测量 V_BCKP 功耗 备注 1. 使用耗流仪测功耗时，请注意调整电流的分辨率。 2. 功率值可按照以下公式计算得出：P = VSupply × ITest。 3. 如 果 测 量 Backup 模 式 下 的 V_BCKP 耗 流 ， 请 确 保 模 块 已 进 入 Backup 模 式 ， 然 后 拔 掉 VCC_MODULE（J102）的跳线帽，断开 VCC 供电。关于进入/退出 Backup 模式的方式，详情请见 文档 [2] 硬件设计手册。 上海移远通信技术股份有限公司 30 / 36 LC29H 系列 EVB 用户指导 9 EVB 框架 通过 Type-B 给 EVB 供电，再通过低压差线性稳压器（LDO）给 GNSS 模块供电。GNSS 模块通过 USB 转 UART 芯片（CP2102N）从 EVB 的通信接口输出信号。搭配 EVB 的天线接口和控制按钮，用户 可以使用 GNSS 模块的完整功能，包括调试功能。 LDO 3.3 V LDO LDO 3.3 V 2.8 V 天线 接口 按键 VCC V_BCKP 复位 模块 按键 唤醒 USB转串口 芯片 CP2102N 车速接口 隔离电路 测试点 电源 Type-B 接口 Type-B 接口 图 19：EVB 框架 上海移远通信技术股份有限公司 31 / 36 LC29H 系列 EVB 用户指导 10 常见问题及故障排除 1. 将 EVB 通过 USB 线连接到电脑后，设备管理器中未找到 COM 口。 ⚫ 查看 EVB 上的通信接口是否成功与电脑连接； ⚫ 查看 CP210x 驱动是否安装成功。 2. 串口不输出任何语句或命令。 ⚫ 查看 EVB 电源指示灯是否正常； ⚫ 查看跳线帽是否按照图 1：EVB 套件图正确连接； ⚫ 查看模块供电是否正常。 3. 无法搜到卫星信号。 ⚫ 若室内没有转发装置，则需要在开阔且四周无遮挡的环境中进行测试。 4. 固件升级失败。 ⚫ 确认模块是否进入了正常工作模式； ⚫ 查看烧录的固件是否正确； ⚫ 检查串口选择是否正确。 备注 如出现无法解决的问题，可联系移远通信技术支持进行解决（support@quectel.com）。 上海移远通信技术股份有限公司 32 / 36 LC29H 系列 EVB 用户指导 11 注意事项 ⚫ 对比不同 GNSS 模块参数时，注意在相同的环境下进行测量。 ⚫ 不同的芯片厂商对应冷启动、捕获、追踪等参数可能有不同的定义，请注意进行区别。 ⚫ 确认测量方法正确的情况下，若仍存在基于 EVB 测量的参数与提供的参数相差过大，请联系移远 技术支持。 ⚫ 请注意有些实测获得的瞬时数据不能作为最终的参考数据，卫星会在不同的时间点到达不同的位 置，且环境、温度、湿度、海拔均可能会影响数据测量。 ⚫ QGNSS 工具可能因 bug 修复、性能提升等进行版本更新，请尽量使用该工具的最新版本。 上海移远通信技术股份有限公司 33 / 36 LC29H 系列 EVB 用户指导 12 附录 参考文档及术语缩写 表 7：参考文档 文档名称 [1] Quectel_LC29H(BS)_EVB_用户指导 [2] Quectel_LC29H 系列_硬件设计手册 [3] Quectel_LC29H_Series_Reference_Design [4] Quectel_QGNSS_User_Guide [5] Quectel_LC29H(BA,CA,DA,EA)_DR&RTK_Application_Note 表 8：术语缩写 缩写 英文全称 2D Two-dimensional 3D Three-dimensional BDS BeiDou Navigation Satellite System CAN Controller Area Network COM Port Communication Port C/N0 DI Carrier-to-Noise Ratio Digital Input DO Digital Output DR Dead Reckoning EVB Evaluation Board Galileo Galileo Satellite Navigation System (EU) 中文全称 2维 3维 北斗导航卫星系统 控制器域网 通信串口 载噪比 数字输入 数字输出 航位推测法 评估板 伽利略卫星导航系统 （欧盟） 上海移远通信技术股份有限公司 34 / 36 LC29H 系列 EVB 用户指导 缩写 英文全称 中文全称 GLONASS Global Navigation Satellite System (Russia) 格洛纳斯导航卫星系统（俄罗斯） GND Ground 地 GNSS Global Navigation Satellite System 全球导航卫星系统 GPS Global Positioning System 全球定位系统 HDOP Horizontal Dilution of Precision 水平精度因子 I/O Input/Output 输入/输出 LED Light Emitting Diode 发光二极管 MSL NMEA 1PPS Mean Sea Level 平均海平面 NMEA (National Marine Electronics Association) NMEA（美国船舶电子协会）0183 接 0183 Interface Standard 口标准 One Pulse Per Second 一秒一个脉冲 OBD On-Board Diagnostics 车载自诊断系统 PCB Printed Circuit Board 印刷电路板 PDOP Position Dilution of Precision 位置精度因子 PI Power Input 输入电源 PO Power Output 输出电源 PRN Pseudorandom Noise 伪随机噪声 QZSS Quasi-Zenith Satellite System 准天顶卫星系统（日本） RF Radio Frequency 射频 RXD Receive Data (Pin) 数据接收（引脚） RTK Real-Time Kinematic 实时动态载波相位差分技术 SBAS Satellite-Based Augmentation System 星基增强系统 SCL Serial Clock Line 时钟线 SDA Serial Data Line 双向数据线 SMA SubMiniature Version A 超小型版本 A 上海移远通信技术股份有限公司 35 / 36 LC29H 系列 EVB 用户指导 缩写 SPS TTFF TXD UART USB UTC WI 英文全称 Standard Positioning Service Time to First Fix Transmit Data (Pin) Universal Asynchronous Receiver/Transmitter Universal Serial Bus Coordinated Universal Time Warning Indication 中文全称 标准定位服务 首次定位时间 发送数据（引脚） 通用异步收发传输器 通用串行总线 协调世界时 报警指示 上海移远通信技术股份有限公司 36 / 36

5G-M2 EVB User Guide 5G Module Series Version: 1.0 Date: 2021-11-18 Status: Released 5G Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. 5G-M2_EVB_User_Guide 1 / 34 5G Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. 5G-M2_EVB_User_Guide 2 / 34 5G Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fueling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. 5G-M2_EVB_User_Guide 3 / 34 5G Module Series About the Document Revision History Version Date - 2021-10-11 1.0 2021-11-18 Author Royd WEI Kingson ZHANG Description Creation of the document First official release 5G-M2_EVB_User_Guide 4 / 34 5G Module Series Contents Safety Information...................................................................................................................................... 3 About the Document .................................................................................................................................. 4 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 Introduction ......................................................................................................................................... 8 1.1. Special Mark .............................................................................................................................. 8 2 General Overview................................................................................................................................ 9 2.1. Key Features .............................................................................................................................. 9 2.2. Top View and Component Placement ..................................................................................... 10 2.3. EVB Kit Accessories ................................................................................................................ 12 3 Interface Application ........................................................................................................................ 14 3.1. Power Supply (J0202/J0601)................................................................................................... 14 3.2. Switches, Button and Status Indicators ................................................................................... 15 3.3. M.2 Interface (J0101) ............................................................................................................... 16 3.4. USB Type-C Interface (J0601) ................................................................................................ 17 3.5. USB-TO-UART Interface (J0901/J0902) ................................................................................. 18 3.6. (U)SIM Interfaces (J0701/J0702)............................................................................................. 19 3.7. Audio Interfaces (J0801/J0802/J0803) .................................................................................... 20 3.7.1. Digital Audio Interface (J0803)...................................................................................... 20 3.7.2. Analog Audio Interfaces (J0801/J0802)........................................................................ 21 3.7.2.1. Earphone Interface (J0801) 21 3.7.2.2. Handset Interface (J0802) 23 3.8 PCIe Interface to WLAN/Ethernet Module (J0501/J0502)....................................................... 23 3.9. Antenna Interfaces ................................................................................................................... 25 3.10. Test Points ............................................................................................................................... 25 4 Operation Procedures ...................................................................................................................... 28 4.1. Turn On the Module ................................................................................................................. 28 4.2. Communication via USB .......................................................................................................... 29 4.3. Firmware Upgrade ................................................................................................................... 30 4.4. Reset the Module ..................................................................................................................... 31 4.5. Turn Off the Module ................................................................................................................. 31 4.6. Current Consumption Test....................................................................................................... 32 5 Appendix References ....................................................................................................................... 33 5G-M2_EVB_User_Guide 5 / 34 5G Module Series Table Index Table 1: Special Mark................................................................................................................................... 8 Table 2: Key Features of 5G-M2 EVB ......................................................................................................... 9 Table 3: Interfaces and Components of the EVB ...................................................................................... 11 Table 4: Accessory List .............................................................................................................................. 12 Table 5: Description of Switches, Button and Status Indicators ................................................................ 16 Table 6: Pin Definition of J0701/J0702 ...................................................................................................... 19 Table 7: Pin Definition of Earphone Interface (J0801)............................................................................... 22 Table 8: Description of Test Points ............................................................................................................ 26 Table 9: Related Documents...................................................................................................................... 33 Table 10: Terms and Abbreviations ........................................................................................................... 33 5G-M2_EVB_User_Guide 6 / 34 5G Module Series Figure Index Figure 1: Top View and Component Placement of the EVB...................................................................... 10 Figure 2: 5G-M2 EVB Kit Accessories ....................................................................................................... 12 Figure 3: EVB Power Supply Block Diagram ............................................................................................. 14 Figure 4: EVB Power Supply Interfaces (J0202/J0601) ............................................................................ 15 Figure 5: Switches, Button and Status Indicators ...................................................................................... 15 Figure 6: M.2 Connector of the EVB .......................................................................................................... 17 Figure 7: USB Type-C Interface (J0601) ................................................................................................... 17 Figure 8: Block Diagram of Connections Between the Module and the USB Type-C Interface ............... 18 Figure 9: USB-TO-UART Interface (J0901/J0902) .................................................................................... 18 Figure 10: Pin Assignments of (U)SIM Interfaces (J0701/J0702) ............................................................. 19 Figure 11: Audio Interfaces of the EVB (J0801/J0802/J0803) .................................................................. 20 Figure 12: Block Diagram of the Connection Between the Codec TE-A and the Module......................... 20 Figure 13: Block Diagram of the Connection Between the SLIC TE-A and the Module ........................... 21 Figure 14: Schematic of Earphone Interface (J0801) ................................................................................ 21 Figure 15: Reference Design for the Audio Plug ....................................................................................... 22 Figure 16: Schematic of Handset Interface (J0802) .................................................................................. 23 Figure 17: PCIe Interface Block Diagram .................................................................................................. 23 Figure 18: Connections Between the EVB and a PC via Ethernet............................................................ 24 Figure 19: Test Points of the EVB.............................................................................................................. 25 Figure 20: USB Device Exhibited in Device Manager ............................................................................... 28 Figure 21: COM Port and Baudrate Configurations................................................................................... 29 Figure 22: Example of an AT Command.................................................................................................... 29 Figure 23: Firmware Upgrade Configurations............................................................................................ 30 Figure 24: Modifications and Configurations for Current Consumption .................................................... 32 5G-M2_EVB_User_Guide 7 / 34 5G Module Series 1 Introduction This document describes how to use the 5G-M2 EVB, which is an assistant tool for engineers to develop and test Quectel’s RM500Q series, RM502Q series, and RM505Q-AE modules. 1.1. Special Mark Table 1: Special Mark Mark * Definition Unless otherwise specified, when an asterisk (*) is used after a function, feature, interface, pin name, AT command, or argument, it indicates that the function, feature, interface, pin, AT command, or argument is under development and currently not supported; and the asterisk (*) after a model indicates that the sample of such model is currently unavailable. 5G-M2_EVB_User_Guide 8 / 34 5G Module Series 2 General Overview Quectel provides the 5G-M2 EVB to engineers to develop applications, and test these basic functionalities of RM500Q series, RM502Q series, and RM505Q-AE modules. 2.1. Key Features Table 2: Key Features of 5G-M2 EVB Function Power Supply M.2 Interface (U)SIM USB USB-TO-UART WLAN/Ethernet Audio Physical Characteristics Antenna Description Typical power supply: ⚫ Power jack: 5 V / 3 A ⚫ USB Type-C: 5 V Standard PCI Express M.2 interface ⚫ (U)SIM1 and (U)SIM2 interfaces ⚫ (U)SIM card insertion detection ⚫ Class B (3.0 V) and Class C (1.8 V) ⚫ USB Type-C interface ⚫ USB 2.0 & 3.0 ⚫ Converts debug UART to USB 2.0 signal (J0901) ⚫ Connects the module’s DBG_TXD and DBG_RXD to the EVB (J0902) Supports AF50T WLAN or RTL8111H/RTL8125 Ethernet ⚫ Supports ALC5686 codec board or LE9643 SLIC board ⚫ Earphone: - 3.5 mm earphone interface - Used to test the analog audio function of codec modules ⚫ Handset: - RJ11-4P handset interface - Used to test the analog audio function of SLIC module Size: 146 mm × 168 mm 6 antennas supporting 600–6000 MHz 5G-M2_EVB_User_Guide 9 / 34 2.2. Top View and Component Placement S0201 S0101 S0102 Power Supply USB Micro-B U0202 U0203 U0207 DC-DC Converter S0301 D0107 D0108 VCC S1101 J0101 USB Type-C USB Type-B B 5G M.2 Module 5G Module Series GND ANT0 ANT1 ANT2 (U)SIM1 Card (U)SIM2 Card Earphone J0803 Handset CODEC/SLIC Module U0205 U0206 U0204 J0501 J0502 WLAN/ETH Module ANT3 ANT4 ANT5 Figure 1: Top View and Component Placement of the EVB 5G-M2_EVB_User_Guide 10 / 34 5G Module Series Table 3: Interfaces and Components of the EVB Function RefDes Description Power Supply J0202 J0601 ⚫ The power jack on the EVB ⚫ Typical supply voltage: 5 V / 3 A ⚫ USB Type-C interface ⚫ Typical supply voltage: 5 V M.2 Interface J0101 Standard PCI Express M.2 interface USB J0601 ⚫ USB Type-C interface ⚫ Used for the USB 2.0 & 3.0 communication USB-TO-UART (U)SIM Interfaces J0901 J0902 J0701 J0702 USB Micro-B used to convert debug UART to USB 2.0 signal Used to connect module’s DBG_TXD and DBG_RXD to the EVB ⚫ (U)SIM1 interface: Class B (3.0 V) and Class C (1.8 V) ⚫ Support (U)SIM card insertion detection ⚫ (U)SIM2 Interface: Class B (3.0 V) and Class C (1.8 V) ⚫ Support (U)SIM card insertion detection WLAN/Ethernet Interfaces J0501/J0502 Support AF50T WLAN or RTL8111H/RTL8125 Ethernet Audio Connector Earphone Interface Handset Interface J0803 J0801 J0802 Support ALC5686 codec board or LE9643 SLIC board ⚫ 3.5 mm earphone interface ⚫ Used to test the analog audio function of codec module ⚫ RJ11-4P handset interface ⚫ Used to test the analog audio function of SLIC module NOTE 1. See Chapter 3.2 for the details of switches and button (S0201/S0101/S0102/S0301/S1101), and LED indicators (D0107/D0108). 2. See Chapter 3.10 for the details of test points of the EVB. 3. J0401 (USB Type-B Interface) is for Quectel internal use only. 5G-M2_EVB_User_Guide 11 / 34 2.3. EVB Kit Accessories 5G Module Series Evaluation Board ALC5686 TE-A Codec RTL8111H TE-A Ethernet USB Flash Disk Soft Silicone Pad BS US BS CN USB Type-C Cable USB Micro-B Cable Headset Figure 2: 5G-M2 EVB Kit Accessories Table 4: Accessory List Items Power adapter Cables Description AC-DC power adapter (5 V/ 3 A) USB Micro-B cable USB Type-C cable Sub-6 GHz RF cables 5G-M2_EVB_User_Guide Heatsink Quantity (pcs) 1 1 1 6 12 / 34 5G Module Series Antennas USB Flash Disk Earphone ALC5686 TE-A RTL8111H TE-A Soft Silicone Pad Heatsink Instruction sheet Others Sub-6 GHz antennas 6 8 GB USB flash disk 1 3.5 mm earphone 1 Codec module 1 Ethernet module 1 Thermal conductive pad 1 60 mm × 60 mm black anodized heatsink 1 A sheet of paper giving instructions for EVB connection, 1 details of EVB accessories, etc. Screws and copper cylinder for EVB assembling 4 pairs Screws for module and heatsink assembling 8 5G-M2_EVB_User_Guide 13 / 34 5G Module Series 3 Interface Application This chapter describes the following hardware interfaces of 5G-M2 EVB: ⚫ Power supply (J0202/J0601) ⚫ Switches, button and status indicators ⚫ M.2 interface (J0101) ⚫ USB Type-C interface (J0601) ⚫ USB-TO-UART interface (J0901/J0902) ⚫ (U)SIM interfaces (J0701/J0702) ⚫ Audio interfaces (J0801/J0802/J0803) ⚫ PCIe interface to WLAN/Ethernet Module (J0501/J0502) ⚫ Antenna interfaces ⚫ Test points 3.1. Power Supply (J0202/J0601) The EVB can be powered by an external power adapter through the 5 V power jack (J0202) or USB Type-C receptacle (J0601) on the EVB. J0202 Power Jack J0601 Type-C Connector S0201 Power Switch U0202 DC-DC U0203 DC-DC U0207 DC-DC 3.8 V J0101 M.2 module 3.3 V 5 V 5 V 3.3 V 3.3 V U0206 DC-DC 1.95 V U0204 DC-DC 0.95 V J0501&J0502 WLAN/ETH J0803 CODEC/SLIC 1.8 V U0205 LDO 1.35 V 1.8 V 1.8 V Figure 3: EVB Power Supply Block Diagram 5G-M2_EVB_User_Guide 14 / 34 5G Module Series J0202 5V Power Supply J0601 USB Power Supply Figure 4: EVB Power Supply Interfaces (J0202/J0601) 3.2. Switches, Button and Status Indicators The EVB provides four switches (S0101/S0201/S0301/S1101), one button (S0102), and two indicators (D0107/D0108), as shown in the following figure. LOW level side HIGH level side LOW level side HIGH level side Figure 5: Switches, Button and Status Indicators 5G-M2_EVB_User_Guide 15 / 34 5G Module Series Table 5: Description of Switches, Button and Status Indicators RefDes Function Description S0201 Used to power on/off the EVB and module S0101 Used to turn on/off the module S0102 S0301 S1101 S0301.1 S0301.2 S0301.3 S0301.4 S1101.1 S1101.2 S1101.3 Used to reset the module ⚫ LOW: the module’s Pin 38 and 68 1 are connected to J0803 SLIC TE-A ⚫ HIGH: the module’s Pin 38 and 68 1 are connected to J0803 CODEC TE-A ⚫ LOW: the module’s Pin 20, 22, 24, and 28 are connected to J0501 and J0502 ⚫ HIGH: the module’s Pin 20, 22, 24, and 28 are connected to J0803 Quectel internal use only ⚫ LOW: the module’s PCIe is connected to J0401 USB Type-B Connector ⚫ HIGH: the module’s PCIe is connected to J0501 and J0502 Used to turn on/off airplane mode ⚫ LOW (FLIGHT_MD): turn on airplane mode ⚫ HIGH (NORMAL_MD): turn off airplane mode Used to enable/disable GNSS function ⚫ LOW (GNSS_OFF): disable GNSS function ⚫ HIGH (GNSS_ON): enable GNSS function Quectel internal use only D0107 D0108 S1101.4 Reserved Power on/off status indicator (PWR_LED) for the module ⚫ Light on: the module is powered on ⚫ Light off: the module is powered off RF status indicator (WWAN_LED) for the module ⚫ Light on: RF function is enabled ⚫ Light off: RF function is disabled 3.3. M.2 Interface (J0101) The M.2 interface (J0101) is designed to mount applicable modules. This interface allows engineers to easily test functionalities or develop applications based on the module. 1 Pin definitions might be different among applicable modules, please contact Quectel Technical Support in case of a different pin definition. 5G-M2_EVB_User_Guide 16 / 34 5G Module Series J0101 5G M.2 Module Figure 6: M.2 Connector of the EVB 3.4. USB Type-C Interface (J0601) The EVB provides a USB 2.0&3.0 Type-C interface (J0601) for the connection with a host. J0601 can be used for data transmission. Also, it can be used as power supply interface to power on the EVB. J0601 USB Type-C Interface Figure 7: USB Type-C Interface (J0601) 5G-M2_EVB_User_Guide 17 / 34 J0601 USB_SS_TX_P USB_SS_TX_M USB_SS_RX_P USB_SS_RX_M USB_DM USB_DP USB Type-C 5G Module Series U0601 HD3SS3220 USB_SS_TX_P USB_SS_TX_M USB_SS_RX_P USB_SS_RX_M 0Ω USB_DM 0Ω USB_DP TP0101(DP) TP0102(DM) TP0605(GND) J0101 M.2 Module Figure 8: Block Diagram of Connections Between the Module and the USB Type-C Interface 3.5. USB-TO-UART Interface (J0901/J0902) The EVB provides a USB-TO-UART interface (J0901/J0902). This interface is used for Linux console and converting debug log UART signal to USB 2.0 signal. Before using the USB-TO-UART interface, DBG_RXD and DBG_TXD of the module should be connected to the corresponding positions of J0902.2 (RXD_1V8) and J0902.3 (TXD_1V8) on the EVB respectively. A connection example of RM500Q-GL module is shown as below. J0902 J0901 USB-TO-UART 1 2 DBG_RXD 3 DBG_TXD 4 5 RM500Q-GL Figure 9: USB-TO-UART Interface (J0901/J0902) 5G-M2_EVB_User_Guide 18 / 34 5G Module Series 3.6. (U)SIM Interfaces (J0701/J0702) The EVB has two 8-pin push-push type Micro (U)SIM card connectors (J0701/J0702), which can be used for applicable modules. J0701 USIM1 Interface CD C4 C8 C3 C7 C2 C6 C1 C5 J0702 USIM2 Interface CD C4 C8 C3 C7 C2 C6 C1 C5 Figure 10: Pin Assignments of (U)SIM Interfaces (J0701/J0702) Table 6: Pin Definition of J0701/J0702 Pin No. Pin Name C1 USIM_VDD C2 USIM_RST C3 USIM_CLK C4 RESERVED C5 GND C6 VPP C7 USIM_DATA C8 RESERVED CD USIM_DET I/O Description PO (U)SIM card power supply DO (U)SIM card reset DO (U)SIM card clock - Not connected - Ground - Not connected DIO (U)SIM card data - Not connected DI (U)SIM card detection 5G-M2_EVB_User_Guide 19 / 34 5G Module Series 3.7. Audio Interfaces (J0801/J0802/J0803) The EVB provides one digital audio codec board connector (J0803), two analog audio connectors (J0801/J0802). This chapter gives a detailed introduction on these audio interfaces. J0801 Earphone Interface 2 46 13 5 J0803 J0802 Handset Interface CODEC/SLIC Figure 11: Audio Interfaces of the EVB (J0801/J0802/J0803) 3.7.1. Digital Audio Interface (J0803) The EVB supports external digital audio codec ALC5686 or SLIC LE9643. The codec or SLIC is assembled on an independent TE-A which can be connected to the EVB by the BTB connector (J0803). M.2 Module BTB CON ALC5686 BTB CON PCM_CLK PCM_SYNC PCM_DOUT PCM_DIN I2C_SCL I2C_SDA J0101 REG_1V8 2.2 K 2.2 K J0803 BCLK LRCK DACDAT1 ADCDAT1 SCL SDA IN2P IN2N HPO_L HPO_R LOUDL/P LOUDR/N J0803 J0801 1 4 6 5 3 2 J0802 Figure 12: Block Diagram of the Connection Between the Codec TE-A and the Module 5G-M2_EVB_User_Guide 20 / 34 5G Module Series M.2 Module SPI_CS SPI_CLK SPI_MOSI SPI_MISO INT# RST# PCM_CLK PCM_SYNC PCM_DOUT PCM_DIN J0101 BTB CON J0803 LE9643 CS# DCLK DIN DOUT INT# RST# PCLK FS DRA DXA Figure 13: Block Diagram of the Connection Between the SLIC TE-A and the Module 3.7.2. Analog Audio Interfaces (J0801/J0802) 3.7.2.1. Earphone Interface (J0801) The audio interface J0801 is designed for earphones. A schematic of the interface is shown by the following figure. Differential layout J0803 MIC_N Close to Socket AGND AGND AGND 10 pF 33 pF 4.7 μF 33 pF 10 pF ESD MIC_P Codec ALC5686 AGND SPK_L SPK_R 1 μF 1 μF Close to Socket 10 pF 33 pF 10 pF 33 pF BTB CON ESD ESD AGND J0801 2 4 6 5 3 1 Audio Jack AGND Figure 14: Schematic of Earphone Interface (J0801) 5G-M2_EVB_User_Guide 21 / 34 5G Module Series The table below illustrates the pin assignment and definition of the earphone connector. Table 7: Pin Definition of Earphone Interface (J0801) Pin No. 1 2 3 4 5, 6 Pin Name MIC AGND SPK_R SPK_L NC Description Microphone analog input Analog ground Right channel of stereo audio output Left channel of stereo audio output Not connected The following figure shows a reference design for the audio plug which matches the earphone connector on the EVB. 4 3 2 GND 1 SW SPK_R 32 Ω MIC SPK_L 32 Ω Figure 15: Reference Design for the Audio Plug 5G-M2_EVB_User_Guide 22 / 34 5G Module Series 3.7.2.2. Handset Interface (J0802) The audio interface J0802 is designed for handsets. A schematic of the interface is shown below. Codec ALC5686 J0803 0R MICP MICN SPKP SPKN AGND 10 pF 33 pF NM_10pF NM_33pF NM_10pF NM_33pF AGND ESD ESD J0802 4 1 3 2 BTB CON 10 pF 33 pF 10 pF33 pF10 pF 33 pF ESD ESD AGND AGND Figure 16: Schematic of Handset Interface (J0802) 3.8 PCIe Interface to WLAN/Ethernet Module (J0501/J0502) The EVB supports a PCIe interface to connect with PC or WLAN/Ethernet module: ⚫ If S0301.4 (PCIE_SEL) signal is set to LOW level side, the PCIe interface of the M.2 module will be connected to Type-B interface (J0401) for communication with a PC (Quectel internal use only). ⚫ If S0301.4 (PCIE_SEL) signal is set to HIGH level side, the PCIe interface of the M.2 module will be connected to WLAN/Ethernet module (J0501/J0502). J0401 Type-B Connector PCIe × 1 S0301.4 (PCIE_SEL) = LOW U0301 PCIe Switch S0301.4 (PCIE_SEL) = HIGH J0501&J0502 WLAN/ETH PCIe x 1 PCIE_CLK_P PCIE_CLK_M PCIE_RX_P PCIE_RX_M PCIE_TX_P PCIE_TX_M J0101 M.2 Connector Figure 17: PCIe Interface Block Diagram 5G-M2_EVB_User_Guide 23 / 34 5G Module Series The EVB supports AF50T TE-A and RTL8111H/RTL8125 TE-A. The TE-A is connected to the EVB via BTB connectors J0501 and J0502. The connectors allow engineers to easily test the WLAN and Ethernet function of the module. The connection and function verification steps for Ethernet are shown below: +5 V Power In 6 7 1 S0301.4=PCIE_SEL=H RM500Q-GL 5G M.2 Module 2 Micro-SIM 5 PC Ethernet Cable 4 RTL8111H/RTL8125 TE-A 3 Figure 18: Connections Between the EVB and a PC via Ethernet Functional verification steps: 1. Set S0301.4 (PCIE_SEL) to HIGH level side. 2. Insert an applicable module (e.g., RM500Q-GL), which should be configured by AT Commands 2, into the M.2 connector (J0101), and assemble the four antennas. 2 The following AT commands are used to set the module into WLAN/Ethernet function mode: ⚫ AT+QCFG='data_interface',1,0: switch the module to PCIe interface. ⚫ AT+QCFG='pcie/mode',1: set the module to PCIe RC mode. ⚫ AT+QETH='eth_driver','R8168',1: load the driver for RTL8111H TE-A. ⚫ AT+QETH='eth_at','enable': enable the driver. 5G-M2_EVB_User_Guide 24 / 34 5G Module Series 3. Insert the RTL8111H TE-A into the BTB connector (J0501, J0502). 4. Connect the EVB and PC with an Ethernet cable. 5. Insert a Micro-SIM card into the USIM1 connector (J0701). 6. Connect the AC-DC power adapter (5 V/ 3 A) between an AC power source and the power jack (J0202). 7. Switch S0201 to PWR_ON side and S0101 to PWRKEY_ON side to power on the whole EVB and turn on the module. 8. Until the green LED on RTL8111H TE-A blinks, it shows that the Ethernet PHY works normally. 3.9. Antenna Interfaces The six antennas provided in the EVB kit are exactly the same. They support 600–6000 MHz and can be randomly connected to the six antenna connectors (ANT0–ANT5) on the EVB, as shown in Figure 1. 3.10. Test Points The EVB provides a series of test points, helping to obtain the corresponding waveform of specific signals, as shown by the following figure and table. 3 3 16 1 1 1 5 2 2 27 2 2 2 4 1 1 38 3 3 3 3 49 4 3 3 4 4 2 5 10 5 2 2 5 5 1 1 1 2 1 Figure 19: Test Points of the EVB 5G-M2_EVB_User_Guide 25 / 34 5G Module Series Table 8: Description of Test Points RefDes J0102 J0102.1 J0102.2 J1101.1 J1101.2 J1101 J1101.3 J1101.4 J1101.5 J1104.1 J1104.2 J1104 J1104.3 J1104.4 J1104.5 J0902.1 J0902.2 J0902 J0902.3 J0902.4 J0902.5 J1103.1 J1103.2 J1103 J1103.3 J1103.4 J1103.5 Pin Name 3 GND VCC GND PWR_5V0 PWR_3V8 PWR_3V3 PWR_1V8 GND PWR_1V95 PWR_1V35 PWR_0V95 NC GND RXD_1V8 TXD_1V8 DTR_1V8 RTS_1V8 GND RTS_RST M2_RST# M2_DPR WK_ON_WAN# Description Ground M.2 module (Pin 2, 4, 70, 72, 74) power supply Ground 5 V power supply 3.8 V power supply of DC-DC U0202 3.3 V power supply of DC-DC U0203 1.8 V power supply of DC-DC U0207 Ground 1.95 V power supply of DC-DC U0206 1.35 V power supply of LDO U0205 0.95 V power supply of DC-DC U0204 Not connected Ground DEBUG_UART_RXD_1V8 DEBUG_UART_TXD_1V8 DEBUG_UART_DTR_1V8 DEBUG_UART_RTS_1V8 Ground Quectel internal use only M.2 module Pin 67, reset signal M.2 module Pin 25, dynamic power reduction signal M.2 module Pin 23, a signal to wake up the host 3 Pin definitions might be different among applicable modules, please contact Quectel Technical Support in case of a different pin definition. 5G-M2_EVB_User_Guide 26 / 34 5G Module Series J1103.6 J1103.7 J1103.8 RFFE_VIO_1V8 M.2 module Pin 65, a 1.8 V power output usually* FULL_CARD_POW M.2 module Pin 6, used to turn on/off the module ER_OFF# GPS_PPS M.2 module Pin 56, depend on the pin function of module J1103.9 W_DISABLE2# M.2 module Pin 26, GNSS disable control signal J1103.10 W_DISABLE1# M.2 module Pin 8, airplane mode control signal J1102 - - Quectel internal use only J1106 - - Quectel internal use only J1107 - - Quectel internal use only J1108 - - Quectel internal use only J1109 - - Quectel internal use only 5G-M2_EVB_User_Guide 27 / 34 5G Module Series 4 Operation Procedures This chapter introduces how to use the EVB for the testing and evaluation of the applicable modules. NOTE Please note that all EVB kit accessories and the applicable module should be assembled BEFORE the EVB is powered on to avoid any damages. 4.1. Turn On the Module 1. Run the USB flash disk on the PC to install the corresponding USB driver. For details about the USB driver installation, refer to document [1]. 2. Insert the applicable M.2 module to the EVB M.2 connector (J0101), and then fix it with screws. 3. Connect the power jack (J0202) to a power supply through the 5 V/ 3 A power adapter. 4. Connect the USB Type-C receptacle (J0601) to a PC via the USB 3.0 Type-C cable. 5. Switch the power switch (S0201) to the PWR_ON side, then PWR_LED (D0107) will light on, indicating that the EVB powers on. In such case, switch PWRKEY (S0101) to the ON side, then the module will turn on, and WWAN_LED (D0108) will light on when the RF function is enabled. 6. The corresponding USB device will be found in Device Manager of the PC after the module starts up completely, as shown by the following figure. Figure 20: USB Device Exhibited in Device Manager 5G-M2_EVB_User_Guide 28 / 34 5G Module Series 4.2. Communication via USB 1. Turn on the module according to the procedure in Chapter 4.1. 2. Install and then open the communication tool QCOM provided by Quectel. 3. Select correct 'COM Port' (the port number of USB AT Port, e.g., 'COM24' as exemplified in Figure 20) and 'Baudrate' (such as 115200 bps), and then click 'Open Port'. For more details about the usage of QCOM, refer to document [2]. Figure 21: COM Port and Baudrate Configurations 4. After the port opens successfully, you can start the communication with the module via USB. Send AT commands by QCOM, and you will get responses from the module, as shown by the following figure. For detailed AT commands, see document [3]. Figure 22: Example of an AT Command 5G-M2_EVB_User_Guide 29 / 34 5G Module Series 4.3. Firmware Upgrade The firmware of the module is upgraded via a USB port by default, please follow the procedures below to upgrade the firmware. 1. Power on the module according to the procedures in Chapter 4.1. 2. Install and open the firmware upgrade tool QFlash provided by Quectel on the PC. 3. Click the 'COM Port' dropdown list and select the port number corresponding to 'Quectel USB DM port' in the Device Manager (e.g., 'COM20' as exemplified in Figure 20) and select 'Baudrate', as illustrated by the following figure. Figure 23: Firmware Upgrade Configurations 4. Click the 'Load FW Files' button to select and load the firmware package. 5. Click the 'Start' button to start the firmware upgrade. For more details about QFlash usage and configuration, see document [4]. 5G-M2_EVB_User_Guide 30 / 34 5G Module Series 4.4. Reset the Module Press the RESET button (S0102) to reset the module. But the reset option is only used in case of emergency. For example, the software does not respond for more than 5 s due to some serious problems. NOTE Pressing the RESET button (i.e., triggering the RESET# signal) will lead to loss of all data in the modem and removal of system drivers. It will also disconnect the modem from the network. 4.5. Turn Off the Module There are two methods to turn off the module. ⚫ Hardware method: switch S0201 to PWR_OFF side to turn off the module. ⚫ Software method: send AT+QPOWD command to turn off the module, which is preferred and safer since the module will log off from the network and save data before shutdown. NOTE Please refer to document [3] for more details about AT+QPOWD command. 5G-M2_EVB_User_Guide 31 / 34 5G Module Series 4.6. Current Consumption Test The EVB can also be used to test the current consumption of the module after being modified and operated by the following steps. 2 4 1 RM500Q-GL 5G M.2 Module 5 3 R0145 R0146 Figure 24: Modifications and Configurations for Current Consumption 1. Disconnect or remove R0145 and R0146. 2. Set the power switch (S0201) to the PWR_ON or PWR_OFF side, and set PWRKEY (S0101) to the ON side. Please note that you will get the current consumption of the module in sleep mode at USB 3.0 when S0201 is on the PWR_ON side and that in sleep mode at USB 2.0 when S0201 is on the PWR_OFF side. 3. Insert an applicable module (e.g., RM500Q-GL) into the M.2 connector (J0101). 4. Connect an external power supply to the oval vias marked by the reference designators, VCC and GND, on the edge of the board to power the module independently. Then turn on the external power supply, and the module will turn on. 5. Connect the USB interface (J0601) to the USB 3.0 interface of a PC. 6. Send AT+QSCLK=1 and AT+CFUN=0 to enable the module to enter sleep mode. After the module enters sleep mode, you can test the current consumption from the external power supply. 5G-M2_EVB_User_Guide 32 / 34 5G Module Series 5 Appendix References Table 9: Related Documents Document Name [1] Quectel_LTE&5G_Windows_USB_Driver_Installation_Guide [2] Quectel_QCOM_User_Guide [3] Quectel_RG50xQ&RM5xxQ_Series_AT_Commands_Manual [4] Quectel_QFlash_User_Guide Table 10: Terms and Abbreviations Abbreviation BTB DI DO EVB GNSS I/O LED WLAN ETH SLIC NC Description Board to Board Digital Input Digital Output Evaluation Board Global Navigation Satellite System Input/Output Light Emitting Diode Wireless Local Area Network Ethernet Subscriber Line Interface Circuit Not Connected 5G-M2_EVB_User_Guide 33 / 34 PC PCB PCIe PO RefDes RF UART USB (U)SIM Personal Computer Printed Circuit Board Peripheral Component Interconnect Express Power Output Reference Designator Radio Frequency Universal Asynchronous Receiver/Transmitter Universal Serial Bus (Universal) Subscriber Identity Module 5G Module Series 5G-M2_EVB_User_Guide 34 / 34

5G-mmWave EVB User Guide 5G Module Series Version: 1.0 Date: 2021-07-25 Status: Released 5G Module Series Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. 5G-mmWave_EVB_User_Guide 1 / 23 5G Module Series Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. 5G-mmWave_EVB_User_Guide 2 / 23 5G Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. 5G-mmWave_EVB_User_Guide 3 / 23 5G Module Series About the Document Revision History Version 1.0 Date 2021-06-23 2021-07-25 Author Neeson ZHANG/ Jumping HE Kingson ZHANG/ Jumping HE Description Creation of the document First official release 5G-mmWave_EVB_User_Guide 4 / 23 5G Module Series Contents Safety Information....................................................................................................................................3 About the Document ................................................................................................................................4 Contents .................................................................................................................................................... 5 Table Index ...............................................................................................................................................6 Figure Index ..............................................................................................................................................7 1 Introduction .......................................................................................................................................8 1.1. Special Mark.............................................................................................................................8 2 General Overview..............................................................................................................................9 2.1. EVB Views and Placement .......................................................................................................9 2.2. List of Accessories..................................................................................................................12 3 Interface Application.......................................................................................................................14 3.1. Power Supply (J100) ..............................................................................................................14 3.2. M.2 Interface (J2000) .............................................................................................................15 3.3. USB Interface (J1403) ............................................................................................................16 3.4. USB-TO-UART Interface (J1901) ...........................................................................................16 3.5. (U)SIM Interface (J1501) ........................................................................................................17 3.6. LAN Interface (J200) ..............................................................................................................17 3.7. Buttons (S2001/S2002) ..........................................................................................................18 3.8. Status Indicators (D1601/D1602*/D1603*/D1604*) ................................................................18 3.9. Sub-6 GHz Antenna Interfaces (J1705/J1706/J1707/J1708)..................................................19 3.10. 5G-mmWave EVB Assembly ..................................................................................................19 4 EVB Operation Procedures ............................................................................................................20 4.1. Power on the Module..............................................................................................................20 4.2. Firmware Upgrade..................................................................................................................20 4.3. Reset the Module ...................................................................................................................21 5 Appendix References .....................................................................................................................22 5G-mmWave_EVB_User_Guide 5 / 23 5G Module Series Table Index Table 1: Special Mark ................................................................................................................................ 8 Table 2: Key Components and Features of 5G-mmWave EVB ............................................................... 10 Table 3: Accessories List of 5G-mmWave-EVB KIT (High-Power Solution) ............................................ 12 Table 4: Accessories List of 5G-mmWave-LP EVB KIT (Low-Power Solution) ........................................ 12 Table 5: Description of Buttons................................................................................................................ 18 Table 6: Description of Status Indicators ................................................................................................. 19 Table 7: Related Documents ................................................................................................................... 22 Table 8: Terms and Abbreviations............................................................................................................ 22 5G-mmWave_EVB_User_Guide 6 / 23 5G Module Series Figure Index Figure 1: Top View for Component Placement of the EVB ........................................................................ 9 Figure 2: Bottom View for Component Placement of the EVB................................................................. 10 Figure 3: EVB Power Supply Block Diagram........................................................................................... 14 Figure 4: EVB Power Supply Interface .................................................................................................... 15 Figure 5: Connection Between the Module and the EVB ........................................................................ 15 Figure 6: Connection Between the Module and USB Type-C Interface ................................................... 16 Figure 7: DBG_TXD and DBG_RXD Test Points of RM510Q-GL ........................................................... 16 Figure 8: Pin Assignment of the (U)SIM Interface (J1501) ...................................................................... 17 Figure 9: LAN Interface (J200) ................................................................................................................ 17 Figure 10: Buttons (S2001 and S2002) ................................................................................................... 18 Figure 11: Status Indicators..................................................................................................................... 18 Figure 12: Configurations for Firmware Upgrade .................................................................................... 21 5G-mmWave_EVB_User_Guide 7 / 23 5G Module Series 1 Introduction This document describes how to use the 5G-mmWave EVB, which is an assistant tool for engineers to develop and test Quectel RM510Q-GL module. There are two mmWave solutions realized with this EVB: low-power solution and high-power solution, whose EVB kit separately contains different accessories and is applied with different antennas. For low-power solution, the EVB kit '5G-mmWave-LP EVB KIT' is used with QTM525 mmWave antenna modules, while for high-power solution, the EVB kit '5G-mmWave-EVB KIT' is used with RA510T series RF carrier board (with QTM527 embedded) 1. 1.1. Special Mark Table 1: Special Mark Mark * Definition Unless otherwise specified, when an asterisk (*) is used after a function, feature, interface, pin name, AT command, or argument, it indicates that the function, feature, interface, pin, AT command, or argument is under development and currently not supported; and the asterisk (*) after a model indicates that the sample of such model is currently unavailable. 1 The EVB kits do not contain the RM510Q-GL module, QTM525 antenna modules, or RA510T series RF carrier boards. 5G-mmWave_EVB_User_Guide 8 / 23 5G Module Series 2 General Overview Quectel supplies 5G-mmWave EVB to engineers to develop applications. This EVB can be used to test basic functionalities of RM510Q-GL with QTM525 or RA510T series. 2.1. EVB Views and Placement J1901 USB Micro-B J2000 RM510Q-GL Module J1800 PON0 J1403 USB Type-C J1501 (U)SIM Card C4 C8 C3 C7 C2 C6 C1 C5 J200 LAN RJ45 J100 +12V Power Supply J1802 PON2 DBG_TXD of RM510Q-GL Module J1912 J1911 DBG_RXD of RM510Q-GL Module ETH Controller J1803 J1801 PON3 PON1 +12V GND DC-DC Converter J1708 ANT3_GNSSL1 J1707 ANT2 J1706 ANT1 J1705 ANT0 TURN ON S2001 PWRKEY TURN OFF S2002 RESET Figure 1: Top View for Component Placement of the EVB 5G-mmWave_EVB_User_Guide 9 / 23 J1804 5G Module Series J1805 D1601 D1602 D1603 D1604 Figure 2: Bottom View for Component Placement of the EVB Table 2: Key Components and Features of 5G-mmWave EVB Function Power Supply 2 USB Type-C RefDes J100 J1403 Description The power jack on the EVB. Typical power supply: +12 V / 2 A (using QTM525) or +12 V / 8 A (using RA510T series). Used for the USB 2.0/3.0 communication. 2 The power supply information in the above table is for the RM510Q-GL module. For detailed procedures to turn on the module, see Chapter 4.1. 5G-mmWave_EVB_User_Guide 10 / 23 5G Module Series USB-TO-UART (U)SIM LAN Interface J1901, J1911, J1912 J1501 J1901 is used to convert debug UART to USB 2.0 signal; J1911 and J1912 are used to connect the module’s test points DBG_TXD and DBG_RXD to the EVB. Support (U)SIM card insertion detection. Support (U)SIM card: Class B (3.0 V) and Class C (1.8 V). J200 Connected to PC with LAN cable. Buttons Status Indicators 3 Connectors S2001 PWRKEY used to turn on/off the module. S2002 RESET used to reset the module. D1601 D1602* D1603* D1604* D1601 is used to indicate power ON/OFF status of the module; D1602 is used to indicate 5G signal strength; D1603 is used to indicate the system status; D1604 is used as proximity alarm. J2000 Standard PCI Express M.2 interface for RM510Q-GL. J1800, J1801, J1802, J1803 J1804, J1805 BTB connectors for QTM525 power supply. Each connector has two control signals (PON). BTB connectors for QTM527 power supply and control signals. Each connector has two control signals (PON). J1705 ANT0 antenna connector. J1706 ANT1 antenna connector. J1707 ANT2 antenna connector. J1708 ANT3_GNSSL1 antenna connector. Physical Characteristics - EVB Size: 146 mm × 168 mm 3 D1602, D1603 and D1604 are all RGB (tri-color) LEDs. 5G-mmWave_EVB_User_Guide 11 / 23 5G Module Series 2.2. List of Accessories All accessories of the 5G-mmWave EVB kits are listed below: Table 3: Accessories List of 5G-mmWave-EVB KIT (High-Power Solution) Items Cables Memory Antennas Silicone Thermal Pads Instruction Sheet Screws Power Adapter FPC Description Quantity (pcs) 10 gigabit Ethernet cable 1 USB Micro-B cable 1 USB Type-C cable 1 RF mmWave cables 8 Sub-6 GHz RF cables 4 8 GB U disk 1 Sub-6 GHz antennas 4 Thermal conductive pads 4 A sheet of paper giving instructions for EVB connection, 1 details of EVB accessories, etc. Screws SC-PB3X6-1N 4 Screws SC-PM2.5X5-2L 2 +12 V/ 8 A power adapter 1 The power FPC transmits power and control signal from 2 the EVB to RA510T series Table 4: Accessories List of 5G-mmWave-LP EVB KIT (Low-Power Solution) Items Cables Description 10 gigabit Ethernet cable USB Micro-B cable USB Type-C cable Quantity (pcs) 1 1 1 5G-mmWave_EVB_User_Guide 12 / 23 5G Module Series Memory Antennas Silicone thermal pads Instruction sheet Screws Power adapter QTM525 power supply cable Heatsink RF mmWave cables 8 Sub-6 GHz RF cables 4 8 GB U disk 1 Sub-6 GHz antennas 4 Thermal conductive pads 5 A sheet of paper giving instructions for EVB connection, 1 details of EVB accessories, etc. Screws SC-PM2.5X10-2L 3 Screws SC-PM2.5X5-2L 2 +12 V/ 2 A power adapter 1 Used to connect QTM525 power supply to 4 J1800/J1801/J1802/J1803 on the EVB Heatsink AL6063T5 Black Anodized 60mmx60mm 1 H:30mm NOTE 1. Each of the four antennas can be used for main/diversity and GNSS reception. 2. The EVB kits do not contain the RM510Q-GL module, QTM525 antenna modules, or RA510T series RF carrier boards. 5G-mmWave_EVB_User_Guide 13 / 23 5G Module Series 3 Interface Application This chapter describes the following hardware interfaces and components of the 5G-mmWave EVB: ⚫ Power supply ⚫ M.2 interface ⚫ USB interface ⚫ USB-TO-UART interface ⚫ (U)SIM interface ⚫ LAN interface ⚫ PWRKEY and RESET Buttons ⚫ Status Indicators ⚫ Sub-6 GHz antenna interfaces 3.1. Power Supply (J100) The 5G-mmWave EVB can be powered by an external power adapter through the power jack (J100) on EVB. The power adapter is designed to be connected to a step-down converter, which converts the supplied voltage into proper voltage (VCC) for the module. The following two figures show the simplified power-supply block diagram and the power interface of 5G-mmWave EVB. J100 12 V @ 2/8 A Power supply U600 3.7 V @ 25 A DC-DC U700 DC-DC 3.3 V @ 2.5 A RM510Q-GL QTM525/527 mmWave module U900 DC-DC 0.85 V @ 6.0 A U801 DC-DC 1.20 V @ 1.0 A U800 DC-DC 2.10 V @ 1.0 A 3.30 V @ 1.0 A Loadswitch U1001 Ethernet controller Figure 3: EVB Power Supply Block Diagram 5G-mmWave_EVB_User_Guide 14 / 23 J100 Power Supply (+12 V) J1803 PON3 J1801 PON1 5G Module Series DC-DC Converter Figure 4: EVB Power Supply Interface 3.2. M.2 Interface (J2000) The M.2 connector (J2000) is designed to install RM510Q-GL. This interface is used to test functionalities of RM510Q-GL or to develop applications based on the module. The following figure shows USB Micro-B interface (J1901), USB 2.0 & USB 3.0 Type-C interface (J1403), and the connection between the module and the EVB. J1901 USB Micro-B J2000 RM510Q-GL Module Installation J1403 USB Type-C DBG_TXD of RM510Q-GL Module J1912 J1911 DBG_RXD of RM510Q-GL Module Figure 5: Connection Between the Module and the EVB 5G-mmWave_EVB_User_Guide 15 / 23 5G Module Series 3.3. USB Interface (J1403) The 5G-mmWave EVB provides a USB 2.0 & USB 3.0 Type-C interface (J1403) for connection with a host device, as shown in Figure 5 and Figure 6. J1403 USB_SS_TX_P USB_SS_TX_M USB_SS_RX_P USB_SS_RX_M USB_DM USB_DP USB Type-C U1400 USB_SS_TX_P USB_SS_TX_M USB_SS_RX_P USB_SS_RX_M 0Ω USB_DM 0Ω USB_DP TP2000 TP2001 TP1405 J2000 RM510Q-GL Figure 6: Connection Between the Module and USB Type-C Interface 3.4. USB-TO-UART Interface (J1901) The 5G-mmWave EVB provides a USB-TO-UART interface (J1901). This interface is used for Linux console and converting log UART signal to USB 2.0 signal for debugging. Before using the USB-TO-UART interface, DBG_TXD and DBG_RXD of the module, as shown in the following figure, should be connected to the corresponding positions of J1911 and J1912 on the EVB respectively, as shown in Figure 5. Figure 7: DBG_TXD and DBG_RXD Test Points of RM510Q-GL 5G-mmWave_EVB_User_Guide 16 / 23 5G Module Series 3.5. (U)SIM Interface (J1501) The 5G-mmWave EVB has one 8-pin push-push type Micro (U)SIM card connector (J1501) used for RM510Q-GL. The following figure shows the pin assignment of J1501. J1501 (U)SIM Card SIM_DET C4(RSV) C8(RSV) C3(SIM_CLK) C7(SIM_DAT) C2(SIM_RST) C6(VPP) C1(SIM_VDD) C5(GND) Figure 8: Pin Assignment of the (U)SIM Interface (J1501) 3.6. LAN Interface (J200) The 5G-mmWave EVB provides a LAN interface for connection with PC. The following figure shows the location of the LAN connector. Users can set the RM510Q-GL to PCIe RC mode through LAN interface. Automatic dialing can be realized by AT commands. For more details about the AT command, see document [1]. J200 LAN RJ45 Figure 9: LAN Interface (J200) 5G-mmWave_EVB_User_Guide 17 / 23 3.7. Buttons (S2001/S2002) 5G Module Series TURN ON S2001 PWRKEY TURN OFF S2002 RESET Figure 10: Buttons (S2001 and S2002) Table 5: Description of Buttons Function PWRKEY RESET RefDes S2001 S2002 Description Used to turn on/off the module Used to reset the module 3.8. Status Indicators (D1601/D1602*/D1603*/D1604*) The 5G-mmWave EVB provides four status indication LEDs (D1601/D1602*/D1603*/D1604*) on the bottom side. The following figure shows the location of these LED indicators. J1805 D1601 D1602 D1603 D1604 Figure 11: Status Indicators 5G-mmWave_EVB_User_Guide 18 / 23 5G Module Series Table 6: Description of Status Indicators RefDes D1601 D1602* D1603* D1604* Description Power ON/OFF indicator indicating the power supply status of the module. Light on: the module is powered on. Light off: the module is powered off. This RGB LED indicates different 5G signal strength. This RGB LED indicates different system status. This RGB LED is used as proximity alarm. 3.9. Sub-6 GHz Antenna Interfaces (J1705/J1706/J1707/J1708) The four antennas (J1705/J1706/J1707/J1708) provided in the EVB kit are the same. They support 600–6000 MHz and can be randomly connected to the four antenna connectors on the EVB. 3.10. 5G-mmWave EVB Assembly The assembly procedures of the EVB kit are different, please refer to document [2] for low-power solution, or refer to document [3] for high-power solution. 5G-mmWave_EVB_User_Guide 19 / 23 5G Module Series 4 EVB Operation Procedures This chapter introduces how to use the 5G-mmWave EVB for the testing and evaluation of the module. Before the procedures below, please ensure the RM510Q-GL, QTM525/RA510T series and the EVB are correctly assembled. 4.1. Power on the Module 1. Insert a (U)SIM card into the (U)SIM card connector (J1501) on the EVB and connect the antennas to the module; 2. Connect the LAN interface (J200) and the PC with a LAN cable; 3. Connect the EVB DC jack (J100) to power supply through the +12 V/ 2 A or +12 V/ 8 A power adapter; 4. Switch PWRKEY (S2001) to the 'TURN ON' side, the module and the EVB will be powered on. And then the POWER GOOD indicator LED (D1601) will light up, which indicates that the power supply for the whole EVB is ready. NOTE 1. If the PWRKEY has been switched to 'TURN ON' side before the power supply is connected, the module and the EVB will power on automatically when the power adapter is connected. 2. The power-on should be performed only after the EVB assembling is completed to avoid any possible damage. 4.2. Firmware Upgrade The firmware of the module is upgraded via USB port by default, please follow the procedures below to upgrade firmware. 1. Install and open the firmware upgrade tool QFlash on the PC and then power on the module according to the procedures in Chapter 4.1; 5G-mmWave_EVB_User_Guide 20 / 23 2. Select the USB DM port in the 'COM Port' dropdown list; 3. Click the 'Load FW Files' button to choose the target firmware package; 4. Click the 'Start' button to upgrade the firmware. 5G Module Series Figure 12: Configurations for Firmware Upgrade For more details about usage and configuration of the QFlash, see document [4]. 4.3. Reset the Module Reset is only used in case of emergency. For example, the software does not respond for more than 5 s due to serious problems. Press the RESET button (S2002) for 200–700 ms, then release it to reset the module. Please note that this operation may cause loss of information in the memory as the module will be initialized after the resetting. 5G-mmWave_EVB_User_Guide 21 / 23 5G Module Series 5 Appendix References Table 7: Related Documents Document Name [1] Quectel_RM5xxQ-GL&RG500Q_Series_AT_Commands_Manual [2] Quectel_RM510Q-GL+QTM525+5G-mmWave-LP_EVB_Kit_Assembly_Instruction [3] Quectel_RM510Q-GL+RA510T+5G-mmWave-EVB_Kit_Assembly_Instruction [4] Quectel_QFlash_User_Guide Table 8: Terms and Abbreviations Abbreviation BTB DI DO EVB GND GNSS I/O IF LED LTE mmWave NC Description Board to Board Digital Input Digital Output Evaluation Board Ground Global Navigation Satellite System Input/Output Intermediate-frequency Light Emitting Diode Long Term Evolution millimeter-wave Not Connected 5G-mmWave_EVB_User_Guide 22 / 23 PC PCB PCIe PO RefDes RF UART USB (U)SIM 5G Module Series Personal Computer Printed Circuit Board Peripheral Component Interconnect Express Power Output Reference Designator Radio Frequency Universal Asynchronous Receiver/Transmitter Universal Serial Bus (Universal) Subscriber Identity Module 5G-mmWave_EVB_User_Guide 23 / 23

LC29D EVB(2) User Guide GNSS Module Series Version: 1.0 Date: 2021-07-06 Status: Released GNSS Module Series Our aim is to provide customers with timely and comprehensive service. For any assistance, contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, visit: http://www.quectel.com/support/technical.htm Or send an 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 the use of or reliance upon the information. All information supplied herein is subject to change without prior notice. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without prior written consent by Quectel. Quectel reserves the right to take legal action for any noncompliance with the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information. LC29D_EVB(2)_User_Guide 1 / 42 GNSS Module Series Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission is forbidden. 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. 2021. All rights reserved. LC29D_EVB(2)_User_Guide 2 / 42 GNSS Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any terminal incorporating Quectel LC29D module. Manufacturers of the terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Ensure that the product may be used in the country and the required environment, as well as that it conforms to the local safety and environmental regulations. Keep away from explosive and flammable materials. The use of electronic products in extreme power supply conditions and locations with potentially explosive atmospheres may cause fire and explosion accidents. The product must be powered by a stable voltage source, while the wiring must conform to security precautions and fire prevention regulations. Proper ESD handling procedures must be followed throughout the mounting, handling and operation of any devices and equipment that incorporate the module to avoid ESD damages. LC29D_EVB(2)_User_Guide 3 / 42 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LC29D EVB(2) User Guide GNSS Module Series EVB User Guide Released Revision History Version 1.0 Date 2021-03-29 2021-07-06 Description Creation of the document First official release LC29D_EVB(2)_User_Guide 4 / 42 GNSS Module Series Contents Safety Information...................................................................................................................................... 3 About the Document .................................................................................................................................. 4 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 Introduction ......................................................................................................................................... 8 2 General Overview................................................................................................................................ 9 2.1. EVK Kit Accessories .................................................................................................................. 9 2.2. Connecting Cables and Antenna to EVB ................................................................................. 10 3 Board User Interfaces....................................................................................................................... 11 3.1. EVB Top View............................................................................................................................11 3.2. Board User Interfaces .............................................................................................................. 12 4 Using QCOM Tool to Communicate................................................................................................ 16 4.1. Communication via the Type-B USB Interface ........................................................................ 16 5 Using QGNSS Tool to Test............................................................................................................... 18 5.1. COM Port and Baud Rate Setting............................................................................................ 18 5.1.1. Interface Explanation .................................................................................................... 19 5.2. Automatic TTFF Testing ........................................................................................................... 21 6 DR Application .................................................................................................................................. 24 7 RTK Application ................................................................................................................................ 25 7.1. Connecting to Base Station ..................................................................................................... 25 7.1.1. Get RTCM Data through QGNSS Tool ......................................................................... 26 7.1.1.1. Hardware Link Connection ................................................................................... 26 7.1.1.2. Module Configuration Method .............................................................................. 26 7.1.1.3. RTK Account Configuration Method ..................................................................... 28 7.1.2. Get RTCM Data through EG25-G Module.................................................................... 29 7.1.2.1. Hardware Link Connection ................................................................................... 29 7.1.2.2. Module Configuration Method .............................................................................. 30 7.1.2.3. RTK Account Configuration .................................................................................. 32 7.2. Description of RTK Status........................................................................................................ 33 8 Firmware Download .......................................................................................................................... 35 8.1. Firmware Upgrade in Normal Working Mode .......................................................................... 35 8.2. Firmware Download in Boot Mode........................................................................................... 37 9 Appendix A Reference...................................................................................................................... 40 LC29D_EVB(2)_User_Guide 5 / 42 GNSS Module Series Table Index Table 1: List of Accessories........................................................................................................................ 10 Table 2: Detailed EVB Interfaces ............................................................................................................... 12 Table 3: J302 Pin Detailed Description ...................................................................................................... 14 Table 4: J501 Pin Detailed Description ...................................................................................................... 15 Table 5: Explanation of QGNSS Interface ................................................................................................. 19 Table 6: NTRIP Client Parameter............................................................................................................... 29 Table 7: Parameter ..................................................................................................................................... 32 Table 8: Parameter .................................................................................................................... 33 Table 9: Related Documents ...................................................................................................................... 40 Table 10: Terms and Abbreviations ............................................................................................................ 40 LC29D_EVB(2)_User_Guide 6 / 42 GNSS Module Series Figure Index Figure 1: EVK Kit Accessories ..................................................................................................................... 9 Figure 2: EVB and Accessories Assembly ................................................................................................. 10 Figure 3: EVB Top View ..............................................................................................................................11 Figure 4: USB Ports ................................................................................................................................... 16 Figure 5: COM Port Setting Interface of QCOM ........................................................................................ 16 Figure 6: QCOM Receiving Bar Interface (Connected) ............................................................................. 17 Figure 7: QGNSS Setting ........................................................................................................................... 18 Figure 8: QGNSS Interface (Connected) ................................................................................................... 19 Figure 9: Static TTFF Testing via QGNSS ................................................................................................. 21 Figure 10: AGNSS Select........................................................................................................................... 21 Figure 11: The Number of Testing .............................................................................................................. 22 Figure 12: Set TTFF Timeout (Seconds) ................................................................................................... 22 Figure 13: Run or Stop Test....................................................................................................................... 23 Figure 14: Test Results .............................................................................................................................. 23 Figure 15: IMU Axis Direction .................................................................................................................... 24 Figure 16: Connect to Base Station ........................................................................................................... 25 Figure 17: EVB and Accessories Assembly-1# ......................................................................................... 26 Figure 18: USB Ports-1# ............................................................................................................................ 26 Figure 19: QGNSS Setting-1#.................................................................................................................... 27 Figure 20: QGNSS Interface (Connected)-1#............................................................................................ 27 Figure 21: Configure RTK Account-1# ....................................................................................................... 28 Figure 22: RTCM Data Acquisition Successful-1#..................................................................................... 28 Figure 23: EVB and Accessories Assembly-2#.......................................................................................... 30 Figure 24: USB Ports-2# ............................................................................................................................ 30 Figure 25: QGNSS Setting-2#.................................................................................................................... 31 Figure 26: QGNSS Interface (Connected)-2#............................................................................................ 31 Figure 27: QGNSS Setting-AT Port............................................................................................................ 32 Figure 28: GGA Example Diagram ............................................................................................................ 33 Figure 29: Firmware Upgrade – Step 1...................................................................................................... 35 Figure 30: Firmware Upgrade – Step 2...................................................................................................... 36 Figure 31: Firmware Upgrade – Step 3...................................................................................................... 36 Figure 32: Firmware Upgrade – Step 4...................................................................................................... 36 Figure 33: Successful Firmware Upgrade ................................................................................................. 37 Figure 34: Firmware Download – Step 1 ................................................................................................... 38 Figure 35: Firmware Download – Step 2 ................................................................................................... 38 Figure 36: Firmware Download – Step 3 ................................................................................................... 38 Figure 37: Firmware Download – Step 4 ................................................................................................... 39 Figure 38: Successful Firmware Download ............................................................................................... 39 LC29D_EVB(2)_User_Guide 7 / 42 GNSS Module Series 1 Introduction This document provides information on how to develop and test the Quectel LC29D module using the Evaluation Board (EVB). The EVB is a convenient tool that allows you to become familiar with the LC29D module. Specifically, the document is divided into several sections: ⚫ Chapter 2 provides the general overview of EVB Kit accessories; ⚫ Chapter 3 describes the EVB user interfaces; ⚫ Chapter 4 describes how to communicate with the module by using the QCOM tool; ⚫ Chapter 5 describes how to test the module by using the QGNSS tool; ⚫ Chapter 6 describes how to configure the LC29D DR; ⚫ Chapter 7 introduces how to use the LC29D RTK; ⚫ Chapter 8 describes how to upgrade firmware; ⚫ Chapter 9 is an appendix, which summarizes the relevant documents and terms and abbreviations appearing herein. ⚫ NOTE If you need EVB schematic and PCB layout design files for reference, please ask your local Quectel FAE for support. LC29D_EVB(2)_User_Guide 8 / 42 GNSS Module Series 2 General Overview 2.1. EVK Kit Accessories The EVK Kit includes EVB, LC29D Active GNSS Antenna, EG25-G Antenna, Type-B USB Cables, and Bolts and Coupling Nuts. You can request the software tools from our website: www.quectel.com. The EVK Kit accessories are shown in the figure below. Check Table 1 for details. EG25-G antenna EVB Bolts and coupling nuts Type-B USB cable LC29D active GNSS antenna Type-B USB cable Figure 1: EVK Kit Accessories ⚫ NOTE The EVB version is LC29D-EVB_V1.2. LC29D_EVB(2)_User_Guide 9 / 42 GNSS Module Series Table 1: List of Accessories Item EVB USB Cable GNSS Antenna Others Description Evaluation Board Size: 100 mm × 175 mm Type-B USB Cables LC29D Active GNSS Antenna Request the Antenna Datasheet from our website: www.quectel.com. EG25-G Antenna Request the Antenna Datasheet from our website: www.quectel.com. Bolts and Coupling Nuts Quantity 1 2 1 1 4 pairs 2.2. Connecting Cables and Antenna to EVB The connection between the EVB and its accessories is shown in the figure below. For detailed information on how to connect the EVB and its accessories, refer to the instruction sheet inside the EVB Kit. Figure 2: EVB and Accessories Assembly ⚫ NOTE Place the active GNSS antenna where it can detect the satellites with a clear view of the sky. LC29D_EVB(2)_User_Guide 10 / 42 GNSS Module Series 3 Board User Interfaces 3.1. EVB Top View The EVB top view is shown in the figure below. J403 EG25_ANT connector J404 S401 (U)SIM card connector S301 EG25_RESET button LC29D_BOOT button J202 SD card connector J501 ODO connector J301 LC29D_ANT connector U401 EG25-G module U301 LC29D module J302 Test points J101 EG25_USB D104 J201 Power USB to UART D302 indication S203 GEO and RTK LEDs S101 D403 POWER_SWITCH EG25-G status and netlight DL/RTK indication LEDs switch S201 RESET_N indication LEDs D301 1PPS and TXD indication LEDs Figure 3: EVB Top View LC29D_EVB(2)_User_Guide 11 / 42 GNSS Module Series 3.2. Board User Interfaces The EVB interfaces are detailed in the table below. Table 2: Detailed EVB Interfaces Function Power Supply Interfaces J101 EG25_USB J201 USB to UART J101 EG25_USB User Interface J201 USB to UART RF Input J301 LC29D_ANT Antenna Connector Signal Indication J403 EG25_ANT Antenna Connector D301 Indication LEDs 1PPS (Red LED) Description Power supply input: ⚫ DC power supply: 4.5–5.5 V, typ. 5.0 V ⚫ Current capability should be > 2 A Account configuration for RTK function Enhanced COM Port: Be used for LC29D module NMEA output, command input, and firmware download. Switch S203 to the DL side when a firmware download or testing of RTK via PC is needed. Standard COM Port: Be used for LC29D module NMEA output and command input. Switch S203 to the RTK side when testing RTK with the EG25-G module. The premises are that the EG25-G module configures the RTK function and the SD card and (U)SIM card are inserted. Support: ⚫ GPS/QZSS L1 C/A and L5 ⚫ Galileo E1 and E5a ⚫ GLONASS L1 ⚫ BeiDou B1I and B2a ⚫ IRNSS L5 ⚫ SBAS L1 ⚫ Use with the antenna provided in the Kit 4G antenna Flash: Successful position fix The frequency is 1 Hz. Extinct: No position fix LC29D_EVB(2)_User_Guide 12 / 42 GNSS Module Series D302 Indication LEDs D104 Indication LEDs D403 Indication LEDs TXD (Green LED) GEO (Red LED) RTK (Green LED) POWER (Red LED) LC29D_PWR (Green LED) EG25-G STATUS (Red LED) EG25-G NETLIGHT (Green LED) S101 POWER_SWITCH S201 RESET_N S401 EG25_RESET Switches Buttons and S203 DL/RTK Switch Others S301 LC29D_BOOT J404 (U)SIM Card Connector Flash: The module is turned on successfully. NMEA messages output from UART TXD pin. Extinct: Failed to turn on the module. Geofence indicator RTK indicator EVB power indicator LC29D module power indicator Indicate the module operating status Flicker slowly (200 ms High/1800 ms LOW): Network searching Flicker slowly (1800 ms High/200 ms LOW): Idle Flicker quickly (125 ms High/125 ms LOW): Data transfer is ongoing. Always high: Voice calling Power the EVB on/off Short press the button to reset the LC29D module. Short press the button to reset the EG25-G module. DL: LC29D UART is connected to Enhanced COM Port and will be used for configuring LC29D module and downloading firmware. RTK: LC29D UART is connected to EG25-G and will be used when the LC29D module receives RTCM data. Press and hold the BOOT button when EVB is powered on to put the module into boot mode. If the (U)SIM card is not inserted and the LC29D RTK account is not configured, the SD card and Standard COM Port cannot receive data. LC29D_EVB(2)_User_Guide 13 / 42 GNSS Module Series Test Points J202 SD Card Connector J302 Test Points J501 ODO Connector The data received by the SD card and Standard COM Port are the same. Pins are detailed in Table 3 below. Pins are detailed in Table 4 below. Test points distribution is shown below: J302 pin assignment: VDD_EXT CTS1 RTS1 TXD1 RXD1 I2C_SDA I2C_SCL 1PPS GND VCC_3.3V Table 3: J302 Pin Detailed Description Pin Name I/O VDD_EXT - CTS1 DO RTS1 DO TXD1 DO RXD1 DI I2C_SDA - I2C_SCL - 1PPS DO GND - VCC_3.3V PO J501 pin assignment: NC NC NC WHEELTICK NC FWD Description Reserved Clear to send Request to send Transmits data Receives data Reserved Reserved 1 pulse per second Ground 3.3 V power output NC GND LC29D_EVB(2)_User_Guide 14 / 42 Table 4: J501 Pin Detailed Description Pin Name I/O NC - NC - NC - NC - NC - WHEELTICK DI FWD DI GND - GNSS Module Series Description Odometer wheel-tick input Forward/Backward signal input Ground LC29D_EVB(2)_User_Guide 15 / 42 GNSS Module Series 4 Using QCOM Tool to Communicate This chapter illustrates how to use the QCOM tool to communicate with the module via the Type-B USB interface. Request the QCOM tool from our website: www.quectel.com. 4.1. Communication via the Type-B USB Interface Step 1: Connect the EVB and the PC with Type-B USB cables via the Type-B USB interface, as shown in Figure 2. Step 2: Flip the power switch (S101) to the ON position to power on the EVB. Step 3: Run the provided driver installer to install the USB driver. Step 4: View the USB port numbers in the Device Manager, as shown in Figure 4 below. Figure 4: USB Ports Step 5: Install the QCOM tool provided by Quectel. The COM Port Setting interface of QCOM is shown in Figure 5 below. Figure 5: COM Port Setting Interface of QCOM Step 6: Select the correct 'COM Port' (USB Ports shown in Figure 5 above). LC29D_EVB(2)_User_Guide 16 / 42 GNSS Module Series Step 7: Set the correct 'Baudrate' (default value: 115200 bps). Step 8: Click 'Open Port' as shown in Figure 5 above, then the communication with EVB is successful. At this time, the NMEA message output by the module is displayed in the receiving bar of the QCOM tool, as shown in the figure below. For more details on QCOM usage, see document [1]. Figure 6: QCOM Receiving Bar Interface (Connected) LC29D_EVB(2)_User_Guide 17 / 42 GNSS Module Series 5 Using QGNSS Tool to Test This chapter explains how to use the QGNSS tool for checking the status of GNSS receivers when you are working with the EVB. For more details on QGNSS usage, see document [3]. Request the QGNSS tool from our website: www.quectel.com. 5.1. COM Port and Baud Rate Setting Step 1: Assemble the EVB Accessories. Step 2: Flip the power switch (S101) to the ON position to power on the EVB. Step 3: Start the QGNSS and click 'Setting' and 'Serial Port Configuration' (the LC29D module supports 115200 bps by default), as shown in the figure below. Figure 7: QGNSS Setting LC29D_EVB(2)_User_Guide 18 / 42 GNSS Module Series Step 4: Click the 'Connect or disconnect' button. After connecting the module, the interface appears as shown in the figure below. Figure 8: QGNSS Interface (Connected) 5.1.1. Interface Explanation You can view GNSS information, such as CNR message, time, position, speed, and precision in the QGNSS interface. To find out more about these parameters, see the following table. Table 5: Explanation of QGNSS Interface Icon Explanation The sky interface shows visible satellites and their numbers. ⚫ BDS (BeiDou): 7 ⚫ GLO (GLONASS): 2 ⚫ GPS: 8 ⚫ GAL (Galileo): 2 ⚫ QZSS: 2 LC29D_EVB(2)_User_Guide 19 / 42 GNSS Module Series ⚫ stands for a GPS satellite, for a BeiDou satellite, for a GLONASS satellite, for a QZSS satellite. for a Galileo satellite, and ⚫ Pseudorandom noise (PRN) 30 carrier-to-noise ratio (CNR) is 39 dB/Hz. ⚫ Column in bright red means that the navigation data of the satellite is in use. ⚫ PRN 1 CNR is 21 dB/Hz. ⚫ Column in light red means that the navigation data of this satellite is not in use. ⚫ Longitude degree ⚫ Latitude degree ⚫ Altitude (MSL) ⚫ Altitude (EPH) ⚫ Receiver speed ⚫ Horizontal dilution of precision ⚫ Position dilution of precision ⚫ FixMode ⚫ UTC date and time ⚫ Total number of seconds ⚫ Last TTFF(s) ⚫ Quality Indicator ⚫ Total Times ⚫ Fixed Points ⚫ RTK Float ⚫ RTK Fixed ⚫ CEP 95 (m) ⚫ RMS (m) LC29D_EVB(2)_User_Guide 20 / 42 GNSS Module Series 5.2. Automatic TTFF Testing The QGNSS tool allows users to measure Time to First Fix (TTFF) under the following testing conditions: ⚫ Full cold start, ⚫ Cold start, ⚫ Warm start, or ⚫ Hot start. QGNSS configuration steps for TTFF testing: Step 1: Click the 'Tools' menu, and select the 'Static TTFF Testing' as shown in the figure below. Figure 9: Static TTFF Testing via QGNSS Step 2: AGNSS is optional when testing TTFF for this tool, as shown in the figure below. Figure 10: AGNSS Select LC29D_EVB(2)_User_Guide 21 / 42 GNSS Module Series Step 3: Select the number of tests from 1, 10, 20, 100, 1000, and User Defined. Click the 'Run' button to start the test. Click the 'Stop' button to stop the test. Click the 'Clear + Stop' button to clear the data and stop the test. Figure 11: The Number of Testing Step 4: If you select hot start, it is recommended to set the 'TTFF Timeout (seconds)' to 10 s. If you select warm start, you can set the 'TTFF Timeout (seconds)' to 50 s. Or, if you select cold start, you can set the 'TTFF Timeout (seconds)' to 100 s. 'TTFF Timeout (seconds)' can help you to assess TTFF and save time. Figure 12: Set TTFF Timeout (Seconds) LC29D_EVB(2)_User_Guide 22 / 42 Step 5: Click on the 'Run' button to start the test. OR Click on the 'Stop' button to stop the test. GNSS Module Series Figure 13: Run or Stop Test Step 6: View the test results displayed visually in charts as shown in the figure below. The test results are stored in the directory where the tool is installed. Figure 14: Test Results LC29D_EVB(2)_User_Guide 23 / 42 GNSS Module Series 6 DR Application This chapter mainly introduces the account configuration of the LC29D Dead Reckoning (DR). A valid module calibration is essential for utilizing the DR capabilities of LC29D. Mount the module tightly on the vehicle during use. No movement or shaking should occur to ensure the performance of the module. For more information, you can refer to the document [2]. Here is the IMU axis direction inside the module for your reference. Figure 15: IMU Axis Direction LC29D_EVB(2)_User_Guide 24 / 42 GNSS Module Series 7 RTK Application This chapter introduces the use of LC29D Real-Time Kinematic (RTK) in two parts: Connect to Base Station and Description of RTK Status. 7.1. Connecting to Base Station This section shows how the LC29D module is used as a rover using correction information provided over the Internet using NTRIP. This is usually provided by a host from base stations. The host runs an NTRIP client and streams RTCM corrections to the LC29D module through a UART. Two major ways to connect to base stations are shown in the figure below: one is using the QGNSS tool, which only supports adopting the NTRIP protocol to obtain server base station data, and the other is using a cellular module. GNSS Raw Measurements GNSS Raw Measurements Base Station Ntrip Server Base Station Using Cellular Module Using QGNSS Tool Cellular Module RTCM GGA GNSS Module RTCM GGA QGNSS Figure 16: Connect to Base Station LC29D_EVB(2)_User_Guide 25 / 42 GNSS Module Series 7.1.1. Get RTCM Data through QGNSS Tool 7.1.1.1. Hardware Link Connection The connection between EVB and PC is shown in the figure below. Place S203 in the DL position. For more information about how to connect to the EVB and its accessories, see Chapter 2.2. GNSS Antenna Type-B USB cable Switch to DL PC Figure 17: EVB and Accessories Assembly-1# 7.1.1.2. Module Configuration Method Step 1: Connect Type-B USB cables and PC as shown in Figure 17 above. Step 2: Run the provided driver installer to install the USB driver. Step 3: Flip the power switch (S101) to the ON position to power on the EVB. Step 4: View the USB port numbers in the Device Manager, as shown in the figure below. Figure 18: USB Ports-1# LC29D_EVB(2)_User_Guide 26 / 42 GNSS Module Series Step 5: Start the QGNSS and click 'Setting' and 'Serial Port Configuration'. Select 'Enhanced COM Port (COM5)' for 'Port' and '115200' (the LC29D module supports 115200 bps by default) for 'Baud Rate', as shown in the figure below. Figure 19: QGNSS Setting-1# Step 6: Click the 'Connect or disconnect' button. After connecting the module, the interface appears as shown in the figure below. The icon has a blue shadow. Figure 20: QGNSS Interface (Connected)-1# LC29D_EVB(2)_User_Guide 27 / 42 GNSS Module Series 7.1.1.3. RTK Account Configuration Method Step 1: Open the QGNSS tool. Following Figure 20 above, click the the RTK account configuration interface. 'NTRIP Client' button to enter Step 2: Set RTK account configuration information in the 'NTRIP Client' interface. Figure 21: Configure RTK Account-1# Step 3: After entering the corresponding configuration information, click 'Connect'. You can see the text output is displayed as shown in the figure below: Send GGA to server and Received (570) bytes from server, which indicate that the RTCM data acquisition is successful. Figure 22: RTCM Data Acquisition Successful-1# LC29D_EVB(2)_User_Guide 28 / 42 Table 6: NTRIP Client Parameter Content Address Port Username Password Source NTRIP mount point Description Server IP address Server port User name Password Mount point NTRIP mount point GNSS Module Series ⚫ NOTE When using the QGNSS tool to configure RTK, the PC side maintains a network connection. 7.1.2. Get RTCM Data through EG25-G Module 7.1.2.1. Hardware Link Connection The connection between EVB and PC is shown in the figure below. Place S203 in the RTK position and insert SD card into J202 and (U)SIM card into J404. For more information about how to connect the EVB and its accessories, see Chapter 2.2. LC29D_EVB(2)_User_Guide 29 / 42 4G Antenna GNSS Module Series GNSS Antenna Switch to RTK PC Type-B USB cables Figure 23: EVB and Accessories Assembly-2# 7.1.2.2. Module Configuration Method Step 1: Connect Type-B USB cables and PC as shown in Figure 23 above. Step 2: Run the provided driver installer to install the USB driver. Step 3: Flip the power switch (S101) to the ON position to power on the EVB. Step 4: View the USB port numbers in the Device Manager, as shown in the figure below. Figure 24: USB Ports-2# Step 5: Start the QGNSS and click 'Setting' and 'Serial Port Configuration'. Select 'Standard COM Port (COM4)' for 'Port' and '115200' (the LC29D module supports 115200 bps by default) for 'Baud Rate', as shown in the figure below. LC29D_EVB(2)_User_Guide 30 / 42 GNSS Module Series Figure 25: QGNSS Setting-2# Step 6: Click the 'Connect or disconnect' button. After connecting the module, the interface appears as shown in the figure below. The icon has a blue shadow. Figure 26: QGNSS Interface (Connected)-2# Step 7: Use the QGNSS tool to connect to the AT port ('COM10') as shown in the figure below. The baud rate of the AT port is 115200 bps. Connect the module as shown in Figure 26 above. LC29D_EVB(2)_User_Guide 31 / 42 GNSS Module Series Figure 27: QGNSS Setting-AT Port 7.1.2.3. RTK Account Configuration RTK account binding is realized by sending commands to the AT port of the EG25-G module. The RTK account only needs to be configured for the first time unless the account expires or the EG25-G module upgrades the firmware. The commands format is as follows: Synopsis: AT+QGNSSPARAM= 0,0,' ip',port,'quectel_usr','quectel_pwd','mount_point',1,1 Table 7: Parameter Parameter ProtoMode DataMode IP Port Usr Pwd Description 0 (NTIRP protocol); 1 (TCP protocol) The TCP protocol is valid, 0(Rover Station); 1(Base station) Server IP address Server port User name Password LC29D_EVB(2)_User_Guide 32 / 42 GNSS Module Series Source AssistUart DataStore Mount point 0: close; 1: open, Standard COM Port can receive LC29D module NMEA data. 0: close; 1: open, SD card can receive LC29D module NMEA data. ⚫ If no error occurs, the returned message will be: +QGNSSPARAM OK ⚫ If there is any error, the returned message will be: +QGNSSPARAM ERR 7.2. Description of RTK Status The chapter mainly describes RTK status. The RTK status can be judged by the parameter value in GGA. The number 4 in the figure below represents fixed integers. Figure 28: GGA Example Diagram Table 8: Parameter Content Description GPS quality indicator: 0 = Fix not available or invalid LC29D_EVB(2)_User_Guide 33 / 42 GNSS Module Series 1 = GPS SPS Mode, fix valid 2 = Differential GPS, SPS Mode, or Satellite Based Augmentation System (SBAS), fix valid 3 = GPS PPS Mode, fix valid 4 = RTK. System used in RTK mode with fixed integers 5 = Float RTK. Satellite system used in RTK mode, floating integers 6 = Estimated (DR) mode LC29D_EVB(2)_User_Guide 34 / 42 GNSS Module Series 8 Firmware Download Quectel LC29D module upgrades firmware via UART interface. The module supports firmware download in both normal working mode and boot mode. Request the GNSSFlashTool from our website: www.quectel.com. 8.1. Firmware Upgrade in Normal Working Mode Before you start the firmware upgrade process: First: Connect the EVB to a PC with Type-B USB cables. Second: Flip the power switch (S101) to the ON position to power on the EVB and switch S203 to DL. Steps for firmware upgrade in normal working mode: Step 1: Open GNSSFlashTool (GNSSFlashTool_V1.21 is used as an illustration in this document). Click 'Tools' and select 'Firmware Download' as shown in the figure below, then the interface of GNSSFlashTool pops up. Figure 29: Firmware Upgrade – Step 1 Step 2: For the 'Tool Options' menu, select 'LC29D_Upgrade' as shown in the figure below. LC29D_EVB(2)_User_Guide 35 / 42 GNSS Module Series Figure 30: Firmware Upgrade – Step 2 Step 3: For 'Firmware select', click 'Open File', e.g., 'LC29DENR01A01S_4WDK_SCY_UPG.bin' as shown in the figure below. Figure 31: Firmware Upgrade – Step 3 Step 4: Confirm the 'Port' as 'COM5' (the Enhanced COM Port) and 'Baud Rate' for successful download. Click the 'Start' button. Figure 32: Firmware Upgrade – Step 4 Step 5: When the firmware upgrade is successful, the progress bar will indicate 100% and there will be a green rectangle on the screen. GNSSFlashTool appears as shown in the figure below. LC29D_EVB(2)_User_Guide 36 / 42 GNSS Module Series Figure 33: Successful Firmware Upgrade ⚫ NOTE Make sure the module is in continuous mode before downloading firmware in normal working mode. 8.2. Firmware Download in Boot Mode Before you start the firmware download process: First: Connect the EVB to a PC with Type-B USB cables. Second: Switch S203 to DL. Thirdly: Press and hold the LC29D_BOOT button (S301) when EVB is powered on to put the module into boot mode. After the module enters boot mode successfully, release the button. Steps for firmware download in boot mode: Step 1: Open GNSSFlashTool. Click the 'Tools' menu and select 'Firmware Download' as shown in the figure below, then the interface of GNSSFlashTool pops up. LC29D_EVB(2)_User_Guide 37 / 42 GNSS Module Series Figure 34: Firmware Download – Step 1 Step 2: For the 'Tool Options' menu, select 'LC29D_Downoad' as shown in the figure below. Figure 35: Firmware Download – Step 2 Step 3: For 'Firmware select', click 'Open File', e.g., 'LC29DENR01A01S_4WDK_SCY_BOOT.patch' as shown in the figure below. Figure 36: Firmware Download – Step 3 Step 4: Confirm the 'Port' as 'COM5' (the Enhanced COM Port) and 'Baud Rate' for successful download. Click the 'Start' button. LC29D_EVB(2)_User_Guide 38 / 42 GNSS Module Series Figure 37: Firmware Download – Step 4 Step 5: When the firmware download is successful, the progress bar will indicate 100% and there will be a green rectangle on the screen. GNSSFlashTool appears as shown in the figure below. Figure 38: Successful Firmware Download LC29D_EVB(2)_User_Guide 39 / 42 GNSS Module Series 9 Appendix A Reference Table 9: Related Documents SN Document Name Description [1] Quectel_QCOM_User_Guide [2] Quectel_LC29D_GNSS_DR&RTK(2)_Application_Note [3] Quectel_QGNSS_User_Guide QCOM User Guide LC29D GNSS DR&RTK(2) Application Note QGNSS User Guide [4] Quectel_LC29D_GNSS_Protocol_Specification LC29D GNSS Protocol Specification Table 10: Terms and Abbreviations Abbreviation BeiDou bps CEP CNR COM Port DI DL DO DR EPH ESD Description BeiDou Navigation Satellite System bits per second Circular Error Probable Carrier-to-Noise Ratio Communication Port Digital Input Download Digital Output Dead Reckoning Ephemeris Electrostatic Discharge LC29D_EVB(2)_User_Guide 40 / 42 EVB Galileo GGA GLONASS GND GNSS GPS I/O IMU IRNSS/NavIC LED LNA MSL NMEA NTRIP ODO OD PC PI PO 1PPS PPS PRN RMS RXD Evaluation Board Galileo Satellite Navigation System (EU) Global Positioning System Fix Data Global Navigation Satellite System (Russian) Ground Global Navigation Satellite System Global Positioning System Input/Output Inertial Measurement Unit Indian Regional Navigation Satellite System Light Emitting Diode Low-Noise Amplifier Mean Sea Level National Marine Electronics Association Networked Transport of RTCM via Internet Protocol Odometer Open Drain Personal Computer Power Input Power Output One Pulse Per Second Precise Positioning Service Pseudorandom Noise Root Mean Square Receive Data (Pin) GNSS Module Series LC29D_EVB(2)_User_Guide 41 / 42 RTCM RTK SBAS SPS TCP TTFF TXD UART USB UTC Radio Technical Commission for Maritime Services Real-Time Kinematic Satellite-Based Augmentation System Standard Positioning Service Transmission Control Protocol Time to First Fix Transmit Data (Pin) Universal Asynchronous Receiver/Transmitter Universal Serial Bus Coordinated Universal Time GNSS Module Series LC29D_EVB(2)_User_Guide 42 / 42

BC260Y-CN-TE-B 用户指导 NB-IoT 模块系列 版本：1.1 日期：2021-07-02 状态：受控文件 BC260Y-CN-TE-B 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 27 BC260Y-CN-TE-B 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或(U)SIM 卡无效时。如果设备支持紧急呼叫功能，请使用紧急呼叫，同时请确保设备开机并 且位于信号强度足够的区域。因不能保证所有情况下网络都能连接，故在紧急情况 下，不能将带有紧急呼叫功能的设备作为唯一的联系方式。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 2 / 27 BC260Y-CN-TE-B 用户指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-07-29 2020-07-29 2021-07-02 作者 变更表述 Clifton HE 文档创建 Clifton HE Clifton HE 受控文件 1. 增加 NB-IoT 无线电通信协议 3GPP Rel-13（第 2 章）。 2. 删除主串口部分自适应波特率的描述，并删除相关备注；更 新调试串口默认波特率为 3 Mbps（表 2）。 3. 优化深休眠/浅休眠唤醒功能相关备注（第 2.1 章）。 4. 更新绝对最大值数据（表 4）。 上海移远通信技术股份有限公司 3 / 27 BC260Y-CN-TE-B 用户指导 目录 安全须知 ..................................................................................................................................................... 2 文档历史 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................ 4 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 引言 ..................................................................................................................................................... 7 1.1. 特殊符号 ................................................................................................................................... 7 2 综述 ..................................................................................................................................................... 8 2.1. 主要性能 ................................................................................................................................... 8 2.2. 功能框图 ................................................................................................................................. 10 2.3. 接口分布图 ..............................................................................................................................11 2.4. Arduino 接口定义图 ................................................................................................................ 13 3 操作说明............................................................................................................................................ 14 3.1. 单板操作说明 .......................................................................................................................... 14 3.1.1. 单板使用接口示意图 .................................................................................................... 14 3.1.2. 操作步骤 ...................................................................................................................... 15 3.2. 多板操作说明 .......................................................................................................................... 16 3.2.1. 接口和修改示意图 ........................................................................................................ 16 3.2.2. 操作步骤 ...................................................................................................................... 18 3.2.3. 脚位连接说明 ............................................................................................................... 19 4 电气性能和可靠性 ............................................................................................................................. 21 4.1. 绝对最大值 ............................................................................................................................. 21 4.2. 工作和存储温度 ...................................................................................................................... 21 5 机械尺寸............................................................................................................................................ 22 5.1. BC260Y-CN-TE-B 机械尺寸 ................................................................................................... 22 5.2. BC260Y-CN-TE-B 俯视图和底视图......................................................................................... 23 6 BC260Y-CN-TE-B 套件及配件.......................................................................................................... 25 6.1. BC260Y-CN-TE-B 套件........................................................................................................... 25 6.2. BC260Y-CN-TE-B 配件........................................................................................................... 26 7 附录 参考文档................................................................................................................................... 27 上海移远通信技术股份有限公司 4 / 27 BC260Y-CN-TE-B 用户指导 表格索引 表 1：特殊符号.......................................................................................................................................... 7 表 2：BC260Y-CN-TE-B 开发板主要性能.................................................................................................. 8 表 3：接口列表........................................................................................................................................ 12 表 4：STM32-L476RG MCU 和 BC260Y-CN-TE-B 引脚连接表 .............................................................. 19 表 5：绝对最大值 .................................................................................................................................... 21 表 6：模块工作和存储温度范围............................................................................................................... 21 表 7：配件列表........................................................................................................................................ 26 表 8：参考文档........................................................................................................................................ 27 表 9：术语和缩写 .................................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 27 BC260Y-CN-TE-B 用户指导 图片索引 图 1：BC260Y-CN-TE-B 功能框图 .......................................................................................................... 10 图 2：BC260Y-CN-TE-B 接口分布图........................................................................................................11 图 3：ARDUINO 接口定义图 ................................................................................................................... 13 图 4：单板使用接口示意图 ...................................................................................................................... 14 图 5：USB-UART 接口显示图 ................................................................................................................. 15 图 6：多板使用接口示意图 ...................................................................................................................... 16 图 7：STM32 NUCLEO-64 开发板接口示意图（正面）.......................................................................... 17 图 8：STM32 NUCLEO-64 开发板修改示意图（背面）.......................................................................... 17 图 9：ST-LINK 接口显示图 ...................................................................................................................... 18 图 10：STM32-L476RG MCU 和 BC260Y-CN-TE-B 脚位连接示意图 ..................................................... 20 图 11：BC260Y-CN-TE-B 俯视尺寸图（单位：毫米） ............................................................................ 22 图 12：BC260Y-CN-TE-B 俯视图 ............................................................................................................ 23 图 13：BC260Y-CN-TE-B 底视图 ............................................................................................................ 24 图 14：BC260Y-CN-TE-B 套件 ............................................................................................................... 25 图 15：BC260Y-CN-TE-B 及其配件 ........................................................................................................ 26 上海移远通信技术股份有限公司 6 / 27 BC260Y-CN-TE-B 用户指导 1 引言 本文档定义了 BC260Y-CN-TE-B 开发板及其与客户应用连接的空中接口和硬件接口。 本文档可以帮助客户快速了解 BC260Y-CN-TE-B 开发板的硬件接口规范、电气特性、机械规范以及其 他相关信息。通过此文档，结合移远通信的硬件设计手册和参考设计手册，客户可以快速将 BC260Y-CN 模块应用于无线应用场景。 1.1. 特殊符号 表 1：特殊符号 符号 * 定义 若无特别说明，模块功能、特性、接口、引脚名称、AT 命令或参数后所标记的星号（*）表 示该功能、特性、接口、引脚、AT 命令或参数正在开发中，因此暂不支持；模块子型号后所 标记的星号（*）表示该子型号暂无样品。 上海移远通信技术股份有限公司 7 / 27 BC260Y-CN-TE-B 用户指导 2 综述 BC260Y-CN-TE-B 是一款带有 Arduino 接口的 NB-IoT 系列开发板，其尺寸为 70.0 mm × 74.0 mm × 1.6 mm。BC260Y-CN-TE-B 开发板可单独使用，也可与 STM32 Nucleo-64 系列开发板配合使用，以调试 和开发通过 NB-IoT 无线电通信协议（3GPP Rel-13 和 3GPP Rel-14）与移动网络运营商的基础设备之间 建立通信的应用。 2.1. 主要性能 表 2：BC260Y-CN-TE-B 开发板主要性能 特征 供电 发射功率 温度范围 USIM 接口 串口开关 说明 USB 接口： 供电电压范围：4.75~5.25 V 典型供电电压：5.0 V Arduino 接口： 供电电压范围：4.75~5.25 V 典型供电电压：5.0 V 电源适配器接口： 供电电压范围：4.75~5.25 V 典型供电电压：5.0 V 23 dBm ±2 dB 正常工作温度：-35 ~ +75 °C 1 扩展工作温度：-40 ~ +85 °C 2 存储温度：-40 ~ +90 °C 支持 1.8/3.0 V 外部 USIM 卡 用于切换模块主串口通信对象 1 模块在此温度范围工作时，模块的相关性能满足 3GPP 标准要求。 2 当模块在此温度范围工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能；不会出现不可恢复的故障；射频 频谱、网络基本不受影响。仅个别指标如输出功率等参数的值可能会超出 3GPP 标准的范围。当温度返回至正常工作温度范 围时，模块的各项指标仍符合 3GPP 标准。 上海移远通信技术股份有限公司 8 / 27 USB-UART 接口 Arduino 接口 RESET 按键 BOOT 按键 PSM_EINT 按键 物理特征 固件升级 天线接口 短信* BC260Y-CN-TE-B 用户指导 提供 2 路 UART 接口 主串口（USB Serial Converter A）： ⚫ 用于 AT 命令通信和数据传输，模块默认波特率为 9600 bps，详情请 参考文档 [1] ⚫ 用于固件升级，支持的波特率默认为 921600 bps ⚫ 深休眠/浅休眠唤醒功能 3 调试串口（USB Serial Converter C）： ⚫ 配合调试工具使用，辅助排查一些异常重启、网络和应用协议问题 ⚫ 串口默认波特率为 3 Mbps 连接 STM32 Nucleo-64 系列开发板 复位模块 控制模块进入下载模式 将模块从深休眠/浅休眠模式中唤醒 尺寸：(70.0 ±0.15) mm × (74.0 ±0.15) mm × (1.6 ±0.2) mm ⚫ 通过主串口 ⚫ DFOTA 升级 50 Ω 特征阻抗 Text 和 PDU 模式 3 使用深休眠/浅休眠唤醒功能时，可以通过主串口发送 AT 命令触发 RXD 下降沿以唤醒模块。一般建议连续发送命令 AT， 直到返回 OK 后，再继续发送其他业务 AT 命令。此串口唤醒功能默认开启。用户可以通过 AT+QCFG='wakeupRXD',1 来 配置开启，通过 AT+QCFG='wakeupRXD',0 来配置关闭。更多详情，请参考文档 [2]。 上海移远通信技术股份有限公司 9 / 27 2.2. 功能框图 下图为 BC260Y-CN-TE-B 功能框图： Arduino DC JACK J206 J306 J308 Micro USB J301 DC-DC U201 LDO U202 LDO U203 USB-UART Bridge U301 Switch J302 BC260Y-CN-TE-B 用户指导 BC260Y-CN U101 RF_ANT J304 USIM J303 U303/U304 Voltage-level Translator 图 1：BC260Y-CN-TE-B 功能框图 上海移远通信技术股份有限公司 10 / 27 2.3. 接口分布图 以下是 BC260Y-CN-TE-B 的接口分布图： BC260Y-CN-TE-B 用户指导 U307 J305 S103 J201 J308 J106 J304 J105 J301 J202 D304 J303 D203 J206 J306 J302 J307 S101 S102 图 2：BC260Y-CN-TE-B 接口分布图 上海移远通信技术股份有限公司 11 / 27 BC260Y-CN-TE-B 用户指导 表 3：接口列表 类型 位号 J301 电源接口 J202 J206 USB-UART 接口 USIM 接口 Arduino 接口 RF 天线接口 J306 J301 J303 J305、J306、 J307、J308 J304 串口开关 J302 BOOT 按键 RESET 按键 PSM_EINT 按键 电源指示灯 网络状态指示灯 测试点 S101 S102 S103 D203 D304 J105、J106、 J201、J202 描述 USB 供电接口 外部电源供电接口 电源适配器供电接口 Arduino 供电接口 支持 2 路 UART 接口 Micro-SIM 卡座 标准 Arduino 接口 射频 SMA 接头 切换模块主串口通信对象 （'MAIN UART TO USB'或者'MAIN UART TO MCU'） 控制模块进入下载模式 模块复位 将模块从深休眠/浅休眠模式中唤醒 电源状态指示 网络连接状态指示 测试模块的基本功能 上海移远通信技术股份有限公司 12 / 27 2.4. Arduino 接口定义图 以下是 BC260Y-CN-TE-B 的 Arduino 接口定义图。 BC260Y-CN-TE-B 用户指导 UART_MCU_RX UART_MCU_TX PSM_EINT_N BOOT_N RESET_N GND RI GND GND 5 V 3.3 V 3.3 V 图 3：Arduino 接口定义图 上海移远通信技术股份有限公司 13 / 27 BC260Y-CN-TE-B 用户指导 3 操作说明 本章主要介绍 BC260Y-CN-TE-B 的具体操作方法和流程。BC260Y-CN-TE-B 既可以作为单板使用，用 于 BC260Y-CN 模块软件升级或者开发调试基于 BC260Y-CN 模块的物联网应用；同时也可以使用 Arduino 接口配合 STM32 Nucleo-64 系列开发板使用，用于开发基于 STM32 的物联网应用。以下章节将分别具体 介绍单板和多板操作的流程。 3.1. 单板操作说明 本章节主要介绍单独使用 BC260Y-CN-TE-B 时的接口示意图和操作流程。 3.1.1. 单板使用接口示意图 U307 J304 J301 J206 J302 J303 图 4：单板使用接口示意图 上海移远通信技术股份有限公司 14 / 27 BC260Y-CN-TE-B 用户指导 3.1.2. 操作步骤 1. 下载并安装 USB-UART 芯片驱动，驱动下载地址为： https://www.ftdichip.cn/Drivers/VCP.htm； 2. 在 J303 卡座中插入 Micro-SIM 卡（请选择 NB-IoT 卡）； 3. 在 J304 射频接头上连接 SMA 接头棒状天线； 4. 将串口开关 J302 拨至'MAIN UART TO USB'档； 5. 使用 Micro USB 数据线连接 J301（USB-UART 接口）和电脑，随后从电脑的'设备管理器'可以 看到如下图所示的串口。其中'USB Serial Port (COM19)'（对应 USB Serial Converter A）连接 BC260Y-CN 的主串口，可用于 AT 命令传送、数据传输和固件升级；'USB Serial Port (COM21)' （对应 USB Serial Converter C）连接 BC260Y-CN 的调试串口，用于输出调试日志信息等。具体 的串口配置和操作请参阅文档 [1]。 图 5：USB-UART 接口显示图 备注 使用过程中，S102 可用于复位模块；S103 可将模块从深休眠/浅休眠模式中唤醒。 上海移远通信技术股份有限公司 15 / 27 BC260Y-CN-TE-B 用户指导 3.2. 多板操作说明 本章节将对 BC260Y-CN-TE-B 和 STM32 Nucleo-64 系列开发板配合使用时的操作流程进行详细说明。 3.2.1. 接口和修改示意图 U307 J305 S103 J201 J309 J308 J106 J304 J105 J301 J202 J303 D203 J206 J306 J302 J307 S101 S102 图 6：多板使用接口示意图 上海移远通信技术股份有限公司 16 / 27 BC260Y-CN-TE-B 用户指导 CN2 CN1 JP5 CN6 JP6 CN5 CN9 CN8 图 7：STM32 Nucleo-64 开发板接口示意图（正面） CN2 CN1 JP5 CN6 JP6 CN5 CN9 CN8 图 8：STM32 Nucleo-64 开发板修改示意图（背面） 上海移远通信技术股份有限公司 17 / 27 BC260Y-CN-TE-B 用户指导 3.2.2. 操作步骤 1. 安装 STM32 Nucleo-64 开发板驱动，驱动下载地址为： http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-ev al-tools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-l476rg.html； 2. 安装 USB-UART 芯片驱动，驱动下载地址为： https://www.ftdichip.cn/Drivers/VCP.htm； 3. 使用烙铁移除 STM32 Nucleo-64 开发板背面 SB13 和 SB14 位置的两颗 0 Ω 电阻，并分别焊接到 SB62 和 SB63 位置上； 4. 将 STM32 Nucleo-64 开发板正面 CN2 的 1 和 2 脚短接，3 和 4 脚短接，JP5 的 1 和 2 脚短接， JP6 的 1 和 2 脚短接； 5. 在 J303 卡座中插入 Micro-SIM 卡（请选择 NB-IoT 卡）； 6. 在 J304 射频接头上连接 SMA 接头棒状天线； 7. 将串口开关 J302 拨至'MAIN UART TO MCU'档； 8. 使用 Arduino 接口将 BC95-CNV-TE-B 与 STM32 Nucleo-64 开发板对接：BC95-CNV-TE-B 的 J305、J306、J307 和 J308 分别连接 STM32 Nucleo-64 开发板的 CN5、CN6、CN8 和 CN9； 9. 用 Mini USB 数据线连接 STM32 Nucleo-64 开发板 CN1 和电脑；等待模块上电开机后，从电脑的 '设备管理器'将可以看到如下图示的设备信息。 图 9：ST-LINK 接口显示图 上海移远通信技术股份有限公司 18 / 27 BC260Y-CN-TE-B 用户指导 3.2.3. 脚位连接说明 以下以 STM32-L476RG MCU 为例，说明 STM32 Nucleo-64 开发板和 BC260Y-CN-TE-B 的脚位连接 方式。 表 4：STM32-L476RG MCU 和 BC260Y-CN-TE-B 引脚连接表 序号 MCU (Morpho) Arduino BC260Y-CN-TE-B 备注 1 PA2 D1 CN9-2 UART_MCU_TX 与主串口 RX 连接 2 PA3 D0 CN9-1 UART_MCU_RX 与主串口 TX 连接 4 PA7 D11 CN5-4 PSM_EINT_N 深休眠/浅休眠唤醒 5 PA6 D12 CN5-5 BOOT_N 高电平有效 6 PA5 D13 CN5-6 RESET_N 高电平有效 7 PA0 A0 CN8-1 RI 振铃提示 8 +5V +5V CN6-5 +5V 5.0 V 电源 9 GND GND CN5-7、CN6-6、CN6-7 GND 地 10 +3.3V +3.3V CN6-4 +3.3V 3.3 V 电源 11 +3.3V IOREF CN6-2 +3.3V 3.3 V 电源 上海移远通信技术股份有限公司 19 / 27 BC260Y-CN-TE-B 用户指导 以下是 STM32-L476RG MCU 和 BC260Y-CN-TE-B 脚位连接示意图。 +3.3V +3.3V +5V GND GND RI GND RESET_N BOOT_N PSM_EINT_N UART_MCU_TX UART_MCU_RX Arduino Morpho BC260Y-CN-TE-B 图 10：STM32-L476RG MCU 和 BC260Y-CN-TE-B 脚位连接示意图 上海移远通信技术股份有限公司 20 / 27 BC260Y-CN-TE-B 用户指导 4 电气性能和可靠性 4.1. 绝对最大值 BC260Y-CN 模块数字和模拟引脚的电源供电电压最大耐受值如下表所示。 表 5：绝对最大值 参数 VBAT 数字引脚处电压 模拟引脚处电压 最小 -0.3 -0.3 -0.3 最大 4.5 3.6 3.6 单位 V V V 4.2. 工作和存储温度 下表所示为 BC260Y-CN 模块的工作和存储温度范围。 表 6：模块工作和存储温度范围 参数 正常工作温度范围 4 扩展工作温度范围 5 存储温度范围 最小 -35 -40 -40 典型 +25 - 最大 +75 +85 +90 单位 ºC ºC ºC 4 当模块在此温度范围内工作时，模块的相关性能满足 3GPP 标准要求。 5 当模块在此温度范围内工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能，不会出现不可恢复的故障。射 频频谱、网络基本不受影响，仅个别指标如输出功率等参数的值可能会超出 3GPP 标准的范围。当温度返回至正常工作温度 范围时，模块的各项指标仍符合 3GPP 标准。 上海移远通信技术股份有限公司 21 / 27 BC260Y-CN-TE-B 用户指导 5 机械尺寸 本章描述了 BC260Y-CN-TE-B 的机械尺寸。尺寸单位为毫米（mm），尺寸公差为 ±0.15 mm。 5.1. BC260Y-CN-TE-B 机械尺寸 图 11：BC260Y-CN-TE-B 俯视尺寸图（单位：毫米） 上海移远通信技术股份有限公司 22 / 27 5.2. BC260Y-CN-TE-B 俯视图和底视图 BC260Y-CN-TE-B 用户指导 图 12：BC260Y-CN-TE-B 俯视图 上海移远通信技术股份有限公司 23 / 27 BC260Y-CN-TE-B 用户指导 图 13：BC260Y-CN-TE-B 底视图 上海移远通信技术股份有限公司 24 / 27 BC260Y-CN-TE-B 用户指导 6 BC260Y-CN-TE-B 套件及配件 6.1. BC260Y-CN-TE-B 套件 图 14：BC260Y-CN-TE-B 套件 上海移远通信技术股份有限公司 25 / 27 6.2. BC260Y-CN-TE-B 配件 BC260Y-CN-TE-B 用户指导 图 15：BC260Y-CN-TE-B 及其配件 表 7：配件列表 配件 天线 数据线 说明书 描述 带 SMA 接头的棒状 NB-IoT 天线 Micro USB 线 说明 BC260Y-CN-TE-B 连接方式和配件信息的单页说明书 数量（件） 1 1 1 上海移远通信技术股份有限公司 26 / 27 BC260Y-CN-TE-B 用户指导 7 附录 参考文档 表 8：参考文档 文档名称 [1] Quectel_BC260Y-CN_硬件设计手册 [2] Quectel_BC260Y-CN_AT 命令手册 表 9：术语和缩写 缩写 bps DFOTA MCU NB-IoT PDU RF SMA UART USB USIM 英文全称 Bits Per Second Delta Firmware Upgrade Over-the-Air Microcontroller Unit Narrowband Internet of Things Protocol Data Unit Radio Frequency Sub Miniature Version A Universal Asynchronous Receiver & Transmitter Universal Serial Bus Universal Subscriber Identification Module 中文全称 位每秒 固件空中差分升级 微控制单元 窄带物联网 协议数据单元 射频 超小型版本A 通用异步收发机 通用串行总线 全球用户识别卡 上海移远通信技术股份有限公司 27 / 27

UMTS&LTE EVB R2.0 User Guide LTE-A Module Series Rev. UMTS&LTE_EVB_R2.0_User_Guide_V1.1 Date: 2019-09-05 Status: Released www.quectel.com LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. UMTS&LTE_EVB_R2.0_User_Guide 1 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide About the Document History Revision Date 1.0 2018-04-11 1.1 2019-09-05 Author Tiger CHENG/ King MA Oscar LIU Description Initial Added the applicable modules: EG12 and EG18 UMTS&LTE_EVB_R2.0_User_Guide 2 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Contents About the Document .................................................................................................................................. 2 Contents ...................................................................................................................................................... 3 Table Index.................................................................................................................................................. 4 Figure Index ................................................................................................................................................ 5 1 Introduction ......................................................................................................................................... 6 1.1. Safety Information ...................................................................................................................... 7 2 General Overview................................................................................................................................ 8 2.1. Key Features .............................................................................................................................. 8 2.2. Component Placement of UMTS&LTE EVB R2.0 ..................................................................... 9 2.3. Top and Bottom Views of UMTS&LTE EVB R2.0 .................................................................... 12 2.4. EVB Kit Accessories ................................................................................................................ 13 3 EVB and Accessories Assembly..................................................................................................... 16 4 EVB Components Application ......................................................................................................... 17 4.1. Power Supply (J201/J502)....................................................................................................... 17 4.2. UMTS&LTE TE-A Connectors (J101/J102) ............................................................................. 18 4.3. USB Connector (J502) ............................................................................................................. 19 4.4. Audio Connectors..................................................................................................................... 20 4.4.1. Digital Audio Codec Board Connector (J501) ............................................................... 20 4.4.2. Analog Audio Connectors (J601/J602) ......................................................................... 21 4.4.2.1. Earphone Connector (J601) 21 4.4.2.2. Handset Connector (J602) 23 4.4.3. Test Points for Loudspeaker (J603) .............................................................................. 24 4.5. (U)SIM Card Connector (J702) ................................................................................................ 25 4.6. SD Card Connector (J701) ...................................................................................................... 27 4.7. UART Connectors (J401/J402)................................................................................................ 28 4.8. Switches and Buttons .............................................................................................................. 30 4.9. Status Indicators ...................................................................................................................... 32 4.10. Test Points................................................................................................................................ 33 5 Operation Procedures Illustration................................................................................................... 38 5.1. Turn on the Module .................................................................................................................. 38 5.2. Communication via USB or UART Interface............................................................................ 38 5.2.1. Communication via USB Interface ................................................................................ 38 5.2.2. Communication via UART Interface.............................................................................. 39 5.3. Firmware Upgrade ................................................................................................................... 40 5.4. Reset the Module ..................................................................................................................... 41 5.5. Turn off the Module .................................................................................................................. 41 5.6. Test Current Consumption of the Module ................................................................................ 41 6 Appendix A References.................................................................................................................... 43 UMTS&LTE_EVB_R2.0_User_Guide 3 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Table Index TABLE 1: KEY FEATURES OF UMTS&LTE EVB R2.0 ...................................................................................... 8 TABLE 2: COMPONENT FUNCTIONS OF UMTS&LTE EVB R2.0 .................................................................. 10 TABLE 3: LIST OF ACCESSORIES .................................................................................................................. 14 TABLE 4: PIN ASSIGNMENT OF J502 ............................................................................................................. 19 TABLE 5: PIN DEFINITION OF J601 ................................................................................................................ 22 TABLE 6: PIN DEFINITION OF J602 ................................................................................................................ 24 TABLE 7: PIN DEFINITION OF J702 ................................................................................................................ 26 TABLE 8: PIN DEFINITION OF J701 ................................................................................................................ 28 TABLE 9: PIN DEFINITION OF J401 ................................................................................................................ 29 TABLE 10: PIN DEFINITION OF J402 .............................................................................................................. 30 TABLE 11: DESCRIPTION OF SWITCHES AND BUTTONS ........................................................................... 31 TABLE 12: DESCRIPTION OF STATUS INDICATORS .................................................................................... 32 TABLE 13: INDICATION OF D206 AND D208 .................................................................................................. 33 TABLE 14: PIN DEFINITION OF J803, J804, J805, J806 AND J403 ............................................................... 35 TABLE 15: RELATED DOCUMENTS ................................................................................................................ 43 TABLE 16: TERMS AND ABBREVIATIONS ...................................................................................................... 43 UMTS&LTE_EVB_R2.0_User_Guide 4 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Figure Index FIGURE 1: COMPONENT PLACEMENT OF EVB TOP SIDE (UNIT: MM) ........................................................ 9 FIGURE 2: COMPONENT PLACEMENT OF EVB BOTTOM SIDE (UNIT: MM) .............................................. 10 FIGURE 3: EVB TOP VIEW .............................................................................................................................. 12 FIGURE 4: EVB BOTTOM VIEW ...................................................................................................................... 13 FIGURE 5: EVB KIT ACCESSORIES ............................................................................................................... 14 FIGURE 6: UMTS&LTE EVB R2.0 AND ACCESSORIES ASSEMBLY............................................................. 16 FIGURE 7: EVB POWER SUPPLY BLOCK DIAGRAM .................................................................................... 17 FIGURE 8: EVB POWER SUPPLY INTERFACE .............................................................................................. 18 FIGURE 9: POWER PLUG DESIGN................................................................................................................. 18 FIGURE 10: CONNECTION BETWEEN TE-A AND EVB ................................................................................. 19 FIGURE 11: DIAGRAM FOR MODULE AND USB TYPE-C RECEPTACLE CONNECTION ........................... 20 FIGURE 12: DIAGRAM FOR CODEC BOARD AND EVB CONNECTION....................................................... 21 FIGURE 13: CONNECTION BETWEEN CODEC BOARD AND EVB .............................................................. 21 FIGURE 14: DIAGRAM FOR EARPHONE CONNECTOR J601 ...................................................................... 22 FIGURE 15: PIN ASSIGNMENT OF EARPHONE CONNECTOR J601 ........................................................... 22 FIGURE 16: SKETCH DESIGN OF AUDIO PLUG ........................................................................................... 23 FIGURE 17: DIAGRAM FOR HANDSET CONNECTOR J602 ......................................................................... 23 FIGURE 18: PIN ASSIGNMENT OF HANDSET CONNECTOR J602 .............................................................. 24 FIGURE 19: DIAGRAM FOR LOUDSPEAKER CONNECTOR J603 ............................................................... 25 FIGURE 20: DIAGRAM FOR (U)SIM CARD CONNECTOR J702.................................................................... 25 FIGURE 21: PIN ASSIGNMENT OF (U)SIM CARD CONNECTOR J702......................................................... 26 FIGURE 22: DIAGRAM FOR SD CARD CONNECTOR J701 .......................................................................... 27 FIGURE 23: PIN ASSIGNMENT OF SD CARD CONNECTOR J701 ............................................................... 27 FIGURE 24: UART BLOCK DIAGRAM ............................................................................................................. 28 FIGURE 25: PIN ASSIGNMENT OF UART CONNECTOR J401...................................................................... 29 FIGURE 26: PIN ASSIGNMENT OF UART CONNECTOR J402...................................................................... 30 FIGURE 27: S901 AND S902 SWITCHES........................................................................................................ 31 FIGURE 28: S201 SWITCH AND S301/S302/S303 BUTTONS ....................................................................... 31 FIGURE 29: STATUS INDICATORS ................................................................................................................. 32 FIGURE 30: TEST POINTS (J803, J805 AND J806) ........................................................................................ 34 FIGURE 31: TEST POINTS OF J804................................................................................................................ 34 FIGURE 32: TEST POINTS OF J403................................................................................................................ 35 FIGURE 33: USB PORTS ................................................................................................................................. 39 FIGURE 34: COM PORT SETTING FIELD ON QCOM (USB AT PORT CONNECTION) ................................ 39 FIGURE 35: USB SERIAL PORT ...................................................................................................................... 39 FIGURE 36: COM PORT SETTING FIELD ON QCOM (USB SERIAL PORT CONNECTION) ....................... 40 FIGURE 37: QFLASH TOOL CONFIGURATIONS FOR FIRMWARE UPGRADE ........................................... 40 FIGURE 38: LOCATION OF R104 .................................................................................................................... 42 FIGURE 39: LOCATION OF J103 ..................................................................................................................... 42 UMTS&LTE_EVB_R2.0_User_Guide 5 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 1 Introduction This document describes how to use the evaluation board of UMTS&LTE modules. It is an assistant tool for engineers to develop and test Quectel EG06/EG12/EG18 module. UMTS&LTE_EVB_R2.0_User_Guide 6 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating EG06, EG12 or EG18 module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for the customer’s failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If the device offers an Airplane Mode, then it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on boarding the aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signals and cellular network cannot be guaranteed to connect in all possible conditions (for example, with unpaid bills or with an invalid (U)SIM card). When emergent help is needed in such conditions, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. The cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. UMTS&LTE_EVB_R2.0_User_Guide 7 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 2 General Overview Quectel supplies UMTS&LTE EVB R2.0 to engineers to develop applications based on EG06/EG12/EG18 module. This EVB can test module basic functionalities. 2.1. Key Features The following table describes the detailed features of UMTS&LTE EVB R2.0. Table 1: Key Features of UMTS&LTE EVB R2.0 Features Description Power Supply DC power supply: 4.5V~5.5V, typically: 5.0V VBAT: 3.8V for J103 UMTS&LTE TE-A Connector Support EG06/EG12/EG18 module Wi-Fi & Ethernet TE-A Connector Reserved SD Card Connector Support SD card (U)SIM Connector Audio Connectors and Loudspeaker Test Points UART Connectors Support (U)SIM card insertion detection Support (U)SIM card: 3.0V/1.8V ⚫ One digital audio codec board connector Support TI TLV320AIC3104 codec board ⚫ Two analog connectors used for earphone and handset Two test points for loudspeaker Two UART connectors: ⚫ COM1: serial interface for data communication Max baud rate: 460800bps ⚫ COM2: serial interface for debugging purpose Max baud rate: 1Mbps USB Connector USB Type-C receptacle for USB 2.0 & 3.0 connectivity Status Indicators 6 LEDs are available for signal indication UMTS&LTE_EVB_R2.0_User_Guide 8 / 44 Switches and Buttons Physical Characteristics LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Power ON/OFF Switch(S201), PWRDWN_N (S301), PWRKEY (S302), RESET (S303), PCM Function Switch (S901), SD Card & eMMC* Function Switch (S902) Size: 146.4mm × 115.0mm NOTE '*' means eMMC function is under development, and the eMMC component is not mounted. 2.2. Component Placement of UMTS&LTE EVB R2.0 GND COM1 (MAIN) J302 COM2 (DBG) 115.0 RESERVED 60 Pins 60 Pins J902 J901 TE-A of the Module J102 100 Pins J701 SD Card Connector S901 S902 J401 Test Points Thermal GND PAD J403 J402 J805 J101 100 Pins J803 J806 Codec board 60 Pins J804 GND PAD 5V GND VBAT J501 J103 D209 D205 D207 D208 D206 D215 Power ON/OFF Switch S201 USB Type-C J502 PWRKEY S302 RESET S303 PWRDWN_N S301 GND 146.4 Test Points J603 Earphone Handset RJ11 (U)SIM Card Connector Connector J601 J602 J702 Figure 1: Component Placement of EVB Top Side (Unit: mm) UMTS&LTE_EVB_R2.0_User_Guide 9 / 44 J402 J703 Not Mounted eMMC LTE-A Module Series UMTS&LTE EVB R2.0 User Guide J401 COM2 (DBG) COM1 (MAIN) 115.0 Handset RJ11 Connector J702 Not Mounted J602 146.4 DC Power Supply J201 Figure 2: Component Placement of EVB Bottom Side (Unit: mm) Table 2: Component Functions of UMTS&LTE EVB R2.0 Functions Power Supply* Power ON/OFF Switch PWRKEY PWRDWN_N Component No. J201 (bottom side) J502 S201 S302 J302 S301 Description The power jack on the EVB Typical voltage supply: +5V USB Type-C connector Typical voltage supply: +5V VBAT power ON/OFF control Power key (push button) Used to turn on/off the module Used to connect PWRKEY to GND Reserved UMTS&LTE_EVB_R2.0_User_Guide 10 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide RESET S303 PCM Function Switch S901 SD Card & eMMC S902 Function Switch USB Connector Audio (U)SIM COM1 COM2 J502 J501 J603 J601 J602 (bottom side) J702 J401 (bottom side) J402 (bottom side) Status Indicators D209, D205, D207, D208, D206, D215 TE-A Connectors SD Card Connector J101, J102 J901, J902 J701 Reset button (push button) Used to reset the module ⚫ Switched to the left: function reserved ⚫ Switched to the right: connect the codec board connector on EVB to the module, for testing the codec’s PCM function ⚫ Switched to the left: test the SD card function of the module ⚫ Switched to the right: test the eMMC* function of the module USB Type-C receptacle Can also be used to supply power for EVB Codec board connector Test points for loudspeaker Used to test the analog audio function of the module Earphone connector Used to test the analog audio function of the module Handset connector Used to test the analog audio function of the module (U)SIM card connector Main UART port Debug UART port ⚫ D209 (VBAT power ON/OFF indicator) is used to indicate whether the module is powered on ⚫ D205 (turn ON/OFF indicator) is used to indicate whether the module is turned on ⚫ D207 (sleep status indicator) is used to indicate whether the module is in sleep mode. ⚫ D208 (Network mode indicator) is used to indicate the network mode of the module ⚫ D206 (network status indicator) is used to indicate the network status of the module ⚫ D215 is reserved Connectors for TE-A of the module Reserved SD card connector UMTS&LTE_EVB_R2.0_User_Guide 11 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide VBAT Test Points J103 J803, J804, J805, J806, J403 Used for VBAT voltage test Test points NOTE '*' means under development, and the eMMC component is not mounted. 2.3. Top and Bottom Views of UMTS&LTE EVB R2.0 The top and bottom views of the UMTS&LTE EVB R2.0 are shown as below. Figure 3: EVB Top View UMTS&LTE_EVB_R2.0_User_Guide 12 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Figure 4: EVB Bottom View 2.4. EVB Kit Accessories All accessories of the EVB kit are listed as below. UMTS&LTE_EVB_R2.0_User_Guide 13 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Instruction Sheet GNSS Antenna Main Antennas Codec Board RF Cables USB Flash Drive Earphone Bolts and Nuts USB to RS-232 Converter Cable USB Type-C Cable Figure 5: EVB Kit Accessories Table 3: List of Accessories Items Cables Antennas Audio USB Flash Drive Codec Board Description Quantity USB to RS-232 converter cable 1 USB Type-C cable 1 RF cables 4 Main Antennas 4 GNSS Antenna (passive) 1 Earphone 1 ⚫ USB 2.0 to RS-232 driver ⚫ USB driver (including EG06/EG12/EG18 1 module related documents, tools, drivers, etc.) TLV320AIC3104 codec board 1 UMTS&LTE_EVB_R2.0_User_Guide 14 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Others Instruction Sheet Bolts and nuts for assembling EVB 4 for each type A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. NOTE The main antennas can also be used for diversity reception. UMTS&LTE_EVB_R2.0_User_Guide 15 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 3 EVB and Accessories Assembly The following figure shows the assembly of UMTS&LTE EVB R2.0 and its accessories. Figure 6: UMTS&LTE EVB R2.0 and Accessories Assembly UMTS&LTE_EVB_R2.0_User_Guide 16 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 4 EVB Components Application This chapter mainly describes the following EVB components application: ⚫ Power supply ⚫ UMTS&LTE TE-A connector ⚫ USB connector ⚫ Audio connector ⚫ (U)SIM connector ⚫ SD card connector ⚫ UART connector It also provides information about the buttons, switches, status indicators and test points to help customers use the EVB. 4.1. Power Supply (J201/J502) The UMTS&LTE EVB R2.0 can be powered by an external power adapter through connected with the power jack (J201) or USB Type-C receptacle (J502) on the EVB. Please pay attention to the voltage value of the power adapter, and 5V/2A is recommended. The power adapter is designed to be connected to a step-down converter (U201), which can convert the supplied voltage into proper voltage (VBAT) for the module. The following two figures show the simplified power supply block diagram and the EVB power supply interface. J502 USB Type-C interface J201 Power supply S201 Power switch U301 LDO U303 LDO 1.8V 3.3V Power supply for Wi-Fi modules U302 LDO 2.85V Power supply for SD Card U201 TPS54319 Step-down converter J103 Power supply for VBAT the module Figure 7: EVB Power Supply Block Diagram UMTS&LTE_EVB_R2.0_User_Guide 17 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Figure 8: EVB Power Supply Interface When using the power jack for power supply, the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 9: Power Plug Design 4.2. UMTS&LTE TE-A Connectors (J101/J102) The UMTS&LTE TE-A connector is designed to accommodate the TE-A of the module. The TE-A is connected to the EVB via BTB connectors J101 and J102, which allows customers to easily test the functionalities of the module or develop applications based on the module. The following figure shows the connection between the TE-A and the EVB. UMTS&LTE_EVB_R2.0_User_Guide 18 / 44 J102 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide J101 Figure 10: Connection between TE-A and EVB 4.3. USB Connector (J502) The UMTS&LTE EVB R2.0 provides a USB Type-C receptacle J502 for connection with the module. The USB data lines D+ and D- are connected directly to the module. The CC1 and CC2 lines can be used to configure Type-C channel signals. The VBUS lines can be used for USB connection detection and EVB power supply. Table 4: Pin Assignment of J502 A1 A2 A3 A4 A5 A6 A7 A8 A9 A10 A11 A12 GND TX1+ TX1- VBUS CC1 D+ D- SBU1 VBUS RX2- RX2+ GND GND RX1+ RX1- VBUS SBU2 D- D+ CC2 VBUS TX2- TX2+ GND B12 B11 B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 The following figure shows the connection of the module and the USB Type-C receptacle. UMTS&LTE_EVB_R2.0_User_Guide 19 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Module USB_SS_TX_M USB_SS_TX_P USB_SS_RX_M USB_SS_RX_P USB_DP USB_DM U501 HD3SS3220IRNHT TXN TXP RXN RXP R1 0R TX1+ TX1RX1+ RX1TX2+ TX2RX2+ RX2CC1 CC2 R2 0R C1 100nF C2 100nF C3 100nF C4 100nF C5 100nF C6 100nF C7 100nF C8 100nF J502 USB Type-C TX1+ TX1RX1+ RX1TX2+ TX2RX2+ RX2CC1 CC2 USB_D+ USB_D- ESD Figure 11: Diagram for Module and USB Type-C Receptacle Connection 4.4. Audio Connectors The UMTS&LTE EVB R2.0 provides one digital audio codec board connector (PCM) J501, two analog audio connectors J601 and J602, and loudspeakers test points J603. 4.4.1. Digital Audio Codec Board Connector (J501) The digital audio codec used on the codec board is TLV320AIC3104. The codec board can be connected to the EVB through the BTB connector J501. The following figures show the connection between the digital audio codec board and the EVB. UMTS&LTE_EVB_R2.0_User_Guide 20 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Module PCM_CLK PCM_SYNC PCM_OUT PCM_IN I2C_SCL I2C_SDA J501 R C BTB Connector 4.7K 4.7K MIC_BIAS TLV3104 J501 MIC_BIAS BCLK IN2P IN2N U101 LRCK HPO_L 1 4 6 DACDAT1 HPO_R 5 3 2 ADCDAT1 SCL SDA LOUDL/P LOUDR/N VDD_EXT BTB Connector NCP2823 J602 MIC J601 J602 speaker J603 Figure 12: Diagram for Codec Board and EVB Connection Codec Board EVB Figure 13: Connection between Codec Board and EVB 4.4.2. Analog Audio Connectors (J601/J602) 4.4.2.1. Earphone Connector (J601) Audio connector J601 is designed for earphones. Its diagram is shown in the following figure. UMTS&LTE_EVB_R2.0_User_Guide 21 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide U101 Differential layout J501 MIC_N MIC_P Close to Socket GND AGND GND GND GND 10pF 33pF 4.7uF75pF 15pF ES D AG ND Codec TLV3104 22uF 22uF AG ND SP K_L SP K_R BTB Connector Close to Socket 10pF 33pF 10pF 33pF ES D GN D 0R NM_0R 2 4 6 5 3 1 J601 Audio Jack NM_0R 0R AG ND MIC_P Figure 14: Diagram for Earphone Connector J601 The figure and table below illustrate the pin assignment and pin definition of earphone connector J601. Figure 15: Pin Assignment of Earphone Connector J601 Table 5: Pin Definition of J601 Pin No. 1 2 Pin Name MIC AGND Description Microphone input Dedicated GND for audio UMTS&LTE_EVB_R2.0_User_Guide 22 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 3 SPK_R 4 SPK_L 5, 6 NC Right channel of stereo audio output Left channel of stereo audio output Not connected The following figure shows the design sketch of audio plug which suits the audio jack on UMTS&LTE EVB R2.0. 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 16: Sketch Design of Audio Plug 4.4.2.2. Handset Connector (J602) Audio connector J602 is designed for handsets. Its diagram is shown as below. U101 Cod ec TLV3104 IN2P IN2N LO UDL/P LO UDR/N J501 FB BTB Connector 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD J602 4 1 3 2 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD Figure 17: Diagram for Handset Connector J602 UMTS&LTE_EVB_R2.0_User_Guide 23 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide The figure and table below illustrate the pin assignment and pin definition of handset connector J602. 4 2 31 Figure 18: Pin Assignment of Handset Connector J602 Table 6: Pin Definition of J602 Pin No. 1 2 3 4 Pin Name MICN SPKN SPKP MICP Function Negative microphone input Negative loudspeaker output Positive loudspeaker output Positive microphone input 4.4.3. Test Points for Loudspeaker (J603) The two test points (J603) are designed for loudspeaker and the following figure shows the loudspeaker with an external Class-D audio amplifier. UMTS&LTE_EVB_R2.0_User_Guide 24 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide U101 J501 Differential layout Codec LOUDL/P C1 TLV3104 LOUDR/N C2 Amp l ifie r circuit NC P2 82 3 BTB Connector Close to speaker GND 10pF 33pF FB ESD J603 FB 10pF 33pF GND ESD Figure 19: Diagram for Loudspeaker Connector J603 4.5. (U)SIM Card Connector (J702) The UMTS&LTE EVB R2.0 provides a 6-pin push-push type (U)SIM card connector J702 which supports 1.8V/3.0V (U)SIM card. Its diagram is shown as below. USIM_VDD 12 USIM_DATA 10 USIM_CLK 8 USIM_RST 6 USIM_PRESENCE 14 J101 Push-Push C1 USIM_VDD C7 USIM_DATA C3 USIM_CLK C2 USIM_RST CD2 USIM_PRE. CD1 USIM_GND (U)SIM card connector GND J702 Figure 20: Diagram for (U)SIM Card Connector J702 The following are the pin assignment and pin definition of J702. UMTS&LTE_EVB_R2.0_User_Guide 25 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide CD1 CD2 C7C3C6C2 C5C1 C7 C6 C5 C3 C2 C1 Figure 21: Pin Assignment of (U)SIM Card Connector J702 Table 7: Pin Definition of J702 Pin No. C1 C2 C3 C5 C6 C7 CD1 CD2 Signal Name I/O USIM_VDD PO USIM_RST DO USIM_CLK DO GND / NC / USIM_DATA IO GND / USIM_PRESENCE DI Function (U)SIM card power supply, provided by UMTS&LTE EVB R2.0 (U)SIM card reset (U)SIM card clock Ground Not connected (U)SIM card data ground (U)SIM card insertion detection. Active low. UMTS&LTE_EVB_R2.0_User_Guide 26 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 4.6. SD Card Connector (J701) The UMTS&LTE EVB R2.0 provides an SD card connector that supports Micro SD card with maximum 32GB storage capacity. With the SD card interface, customers can easily increase the storage capacity of EG06/EG12/EG18 module. The diagram for J701 is shown as below. SD1_DATA2 29 SD1_DATA3 28 SD1_CMD 33 SD1_CLK 32 SD1_DATA0 31 SD1_DATA1 30 VDD_3V3 1 DAT2 2 CD/DAT3 3 CMD 4 VDD 5 CLK 6 VSS SD card connector 7 DAT0 8 DAT1 J101 GND J701 Figure 22: Diagram for SD Card Connector J701 1 2 3 4 56 78 Figure 23: Pin Assignment of SD Card Connector J701 UMTS&LTE_EVB_R2.0_User_Guide 27 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Table 8: Pin Definition of J701 Pin No. 1 2 3 4 5 6 7 8 Pin Name DAT2 CD/DAT3 CMD VDD CLK VSS DAT0 DAT1 I/O Description IO SDIO data (bit 2) IO SDIO data (bit 3) DI SDIO command PO SD card power supply DI SDIO clock Ground IO SDIO data (bit 0) IO SDIO data (bit 1) 4.7. UART Connectors (J401/J402) The UMTS&LTE EVB R2.0 offers two UART ports (COM1 and COM2) via two UART connectors J401 and J402. The main UART port COM1 is intended for the communication between the module and the host application. It can be used for data transmission and AT command communication. The debug UART port COM2 supports 115200bps baud rate by default. It can be used for Linux console and log output. The following figure shows the block diagram of UART connectors on UMTS&LTE EVB R2.0. J401 COM1 DB9 COM2 DB9 J402 U401 RS-232 RS-232 Level Match RS-232 RS-232 Level Match U402 3.0V U403 3.0V/1.8V Level Translator 1.8V 3.0V 3.0V/1.8V Transistor Level Translator U404 1.8V Module J101 Figure 24: UART Block Diagram UMTS&LTE_EVB_R2.0_User_Guide 28 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide The figure and table below illustrate the pin assignment and pin definition of J401 and J402. 5 9 48 37 2 6 1 5 4 321 Figure 25: Pin Assignment of UART Connector J401 Table 9: Pin Definition of J401 Pin No. 1 2 3 4 5 6 7 8 9 Pin Name DCD RXD TXD DTR GND DSR RTS CTS RI I/O Description DO Data carrier detection DI Receive data DO Transmit data DI Data terminal ready / GND / Not connected DI Request to send DO Clear to send DO Ring indication UMTS&LTE_EVB_R2.0_User_Guide 29 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 12 34 5 67 8 9 Figure 26: Pin Assignment of UART Connector J402 Table 10: Pin Definition of J402 Pin No. 1, 4, 6, 7, 8, 9 2 3 5 Pin Name NC RXD TXD GND I/O Description Not connected DI Receive Data DO Transmit data Ground 4.8. Switches and Buttons The UMTS&LTE EVB R2.0 includes three switches (S201, S901 and S902) and three buttons (S301, S302 and S303), as shown in the following figures. UMTS&LTE_EVB_R2.0_User_Guide 30 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide S901 S902 Figure 27: S901 and S902 Switches S201 S302 S303 S301 Figure 28: S201 Switch and S301/S302/S303 Buttons Table 11: Description of Switches and Buttons Reference No. S201 S901 S902 S302 Description VBAT Power ON/OFF control ⚫ Switched to the left: function reserved. ⚫ Switched to the right: connect the codec board connector on EVB to the module, for testing the codec’s PCM function. ⚫ Switched to the left: connect SD card connector to the module, for testing the SD card function of the module. ⚫ Switched to the right: connect the eMMC connector to the module, for testing the eMMC* function. Used to turn on/off the module UMTS&LTE_EVB_R2.0_User_Guide 31 / 44 S303 S301 Used to reset the module Reserved LTE-A Module Series UMTS&LTE EVB R2.0 User Guide NOTE '*' means eMMC function is under development, and the eMMC component is not mounted. 4.9. Status Indicators The UMTS&LTE EVB R2.0 provides six status indicators (D209, D205, D207, D208, D206 and D215). The following figure shows the location of these LED indicators. D209 D205 D207 D208 D206 D215 Figure 29: Status Indicators Table 12: Description of Status Indicators Reference No. Description D209 D205 VBAT power ON/OFF indicator. Indicates whether the module is powered on. Bright: VBAT ON Extinct: VBAT OFF Turn ON/OFF indicator. Indicates the operation status of the module. Bright: The module is turned on. UMTS&LTE_EVB_R2.0_User_Guide 32 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide D207 D208, D206 Extinct: The module is turned off. Sleep status indicator. Indicates the sleep status of the module. Bright: The module is in sleep mode. Extinct: The module is not in sleep mode. Network status indicator. Indicates the network status of the module. The following table shows the module’s network status and mode which are indicated via D206 and D208. Table 13: Indication of D206 and D208 Status Indicators State D206 NET_STATUS Flicker slowly (200ms ON/1800ms OFF) Flicker slowly (1800ms ON/200ms OFF) Flicker slowly (125ms ON/125ms OFF) Always ON D208 NET_MODE Always ON Always OFF Network Status Network searching Idle mode Data is being transferred over network Voice calling Registered on 3G/4G network successfully Others 4.10. Test Points The UMTS&LTE EVB R2.0 provides a series of test points. They can help customers to obtain the corresponding waveform of some signals. The following three figures show test points J803, J804, J805, J806 and J403. UMTS&LTE_EVB_R2.0_User_Guide 33 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide J806 12 34 56 78 9 10 J803 12 34 56 78 9 10 J805 12 34 56 78 9 10 Figure 30: Test Points (J803, J805 and J806) Figure 31: Test Points of J804 UMTS&LTE_EVB_R2.0_User_Guide 34 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Figure 32: Test Points of J403 Table 14: Pin Definition of J803, J804, J805, J806 and J403 J803 Pin No. 1, 3, 5 2 4 6 7 8 9 10 J804 Pin No. 1 2 3 Pin Name Description DTR_TEST Data terminal ready test pins POWER_EN VBAT enable pin PWRKEY_3.0V PWRKEY_3.0V test pin RESET_3.0V RESET_3.0V test pin VDD_EXT Connected directly to VDD_EXT of the module POWER_OFF_3.0V Reserved SPI_MRDY Reserved SPI_SRDY Reserved Pin Name VDD_3.0V PCM_SYNC VDD_1V8 Description 3.0V power supply from LDO U303 Connected directly to PCM_SYNC of the module 1.8V power supply from LDO U301 UMTS&LTE_EVB_R2.0_User_Guide 35 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 4 5 6 7 8 9 10 J805 Pin No. 1 2 3 4 5 6 7 8 9 10 J806 Pin No. 1 2 3 4 PCM_IN I2C_SDA PCM_OUT I2C_SCL PCM_CLK CLK_OUT GND Connected directly to PCM_IN of the module Connected directly to I2C_SDA of the module Connected directly to PCM_OUT of the module Connected directly to I2C_SCL of the module Connected directly to PCM_CLK of the module I2S_MCLK Ground Pin Name WAKE_IN SPI_CS_N AP_READY SPI_CLK W_DISABLE_N SPI_MISO USB_BOOT SPI_MOSI VDD_1.8V GND Description Connected directly to WAKEUP_IN of the module Not connected Not connected Not connected Connected directly to W_DISABLE# of the module Not connected Connected directly to USB_BOOT of the module Connected to VDD_1.8V via a resistor Ground Pin Name Description CTS_1.8V_UART Connected directly to the voltage translator RTS_1.8V_UART Connected directly to the voltage translator RXD_1.8V_UART Connected directly to the voltage translator RXD_3.0V Connected directly to the voltage translator UMTS&LTE_EVB_R2.0_User_Guide 36 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 5 6 7 8 9 10 J403 Pin No. 1 2 3 4 5 6 TXD_1.8V_UART TXD_3.0 DTR_1.8V DTR_3.0V RI_1.8V GND Connected directly to the voltage translator Connected directly to the voltage translator Connected directly to DTR of the module Connected directly to the voltage translator Connected directly to RI of the module Ground Pin Name Description WDOG_DISABLE Not Connected GND Ground DB_RX_3.3V Connected directly to the voltage translator DB_TX_3.3V Connected directly to the voltage translator DB_TX_1.8V Connected directly to DBG_TXD of the module DB_RX_1.8V Connected directly to DBG_RXD of the module UMTS&LTE_EVB_R2.0_User_Guide 37 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 5 Operation Procedures Illustration This chapter introduces how to use the UMTS&LTE EVB R2.0 for testing and evaluation of EG06/ EG12/EG18 module. 5.1. Turn on the Module 1. Connect the TE-A of the module to the EVB via connectors J101 and J102. 2. Insert a (U)SIM card into the (U)SIM card connector on EVB, and connect the antennas to the TE-A. 3. Connect the EVB to a 5V power adapter, or connect the EVB to PC via USB Type-C cable. 4. Switch S201 (VBAT Power ON/OFF Switch) to ON state, then D209 (VBAT ON/OFF indicator) will light up. Press the S302 (PWRKEY) for at least 100ms, then the module will be turned on and D205 (turn ON/OFF indicator) will light up. 5.2. Communication via USB or UART Interface 5.2.1. Communication via USB Interface 1. Turn on the module according to the procedures mentioned in Chapter 5.1. 2. Connect the EVB and the PC with USB Type-C cable through USB connector J502, and then run the driver disk on PC to install the USB driver. For details about USB driver installation, please refer to document [7] stored in USB drive disk. The USB port numbers can be viewed through the PC Device Manager, as shown below. UMTS&LTE_EVB_R2.0_User_Guide 38 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Figure 33: USB Ports 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting field on QCOM: select the correct 'COM Port' (USB AT Port which is shown in above figure) and set the correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [6]. Figure 34: COM Port Setting Field on QCOM (USB AT Port Connection) 5.2.2. Communication via UART Interface 1. Run the driver disk on PC to install the USB to RS-232 driver. 2. Connect the EVB to PC with USB to RS-232 converter cable through the main UART connector, and the USB serial port number can be viewed through the PC Device Manager, as shown below. Figure 35: USB Serial Port 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting field on QCOM: select the correct 'COM Port' (USB Serial Port) and set the correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [6]. UMTS&LTE_EVB_R2.0_User_Guide 39 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Figure 36: COM Port Setting Field on QCOM (USB Serial Port Connection) 5.3. Firmware Upgrade The firmware of the module is upgraded via USB port by default. Please follow the procedures below to upgrade the firmware. 1. Install and open the firmware upgrade tool QFlash on PC and then turn on the module according to the procedures mentioned in Chapter 5.1. For more details about QFlash, please refer to document [8]. 2. Click the 'COM Port' dropdown list and select the USB DM port. 3. Click the 'Load FW Files' button to choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. Figure 37: QFlash Tool Configurations for Firmware Upgrade UMTS&LTE_EVB_R2.0_User_Guide 40 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 5.4. Reset the Module The reset option is only used in case of emergency. For example, the software does not respond for more than 5s due to some serious problems. Press the RESET button S303 for more than 150ms then release it to reset the module. However, this operation may cause the loss of information stored in the memory as the reset module has been initialized. 5.5. Turn off the Module There are two ways to turn off the module. One way is to execute AT+QPOWD command. This is the best and the safest way since the module will log off from the network and save data before shutdown. When turning off module with AT command, please keep PWRKEY at high level after the execution of power-off command, otherwise the module will be turned on again after successful turn-off. For more details about the AT command, please refer to document [4] and [5]. The other way to turn off the module is to press down S302 (PWRKEY) for at least 0.6s. 5.6. Test Current Consumption of the Module The UMTS&LTE EVB R2.0 can also be used to test the current consumption of the module after making modifications according to the following steps. UMTS&LTE_EVB_R2.0_User_Guide 41 / 44 1. Remove R104. LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Figure 38: Location of R104 2. Connect an external power supply to J103 to supply power for the module independently. Figure 39: Location of J103 3. Turn on the module according to the procedure mentioned in Chapter 5.1 and then test the current consumption of the module. UMTS&LTE_EVB_R2.0_User_Guide 42 / 44 LTE-A Module Series UMTS&LTE EVB R2.0 User Guide 6 Appendix A References Table 15: Related Documents SN Document Name Remark [1] Quectel_EG06_Hardware_Design Hardware design of EG06 module [2] Quectel_EG12_Hardware_Design Hardware design of EG12 module [3] Quectel_EG18_Hardware_Design Hardware design of EG18 module Quectel_EP06&EG06&EM06_AT_Commands_ [4] Manual AT commands manual for EP06, EG06 and EM06 modules AT commands manual for EM12, EG12 [5] Quectel_EM12&EG12&EG18_AT_Commands_Manual and EG18 modules [6] Quectel_QCOM_User_Guide User guide for QCOM tool Quectel_LTE&5G_Windows_USB_Driver_Installation_ Windows USB driver installation guide [7] Guide for LTE and 5G modules [8] Quectel_QFlash_User_Guide QFlash user guide Table 16: Terms and Abbreviations Abbreviation AGND BTB COM DC DI DO eMMC Description Analog Ground Board-to-Board Cluster Communication Port Direct Current Digital Input Digital Output Embedded Multi Media Card UMTS&LTE_EVB_R2.0_User_Guide 43 / 44 EVB GND GNSS I/O LED LTE MIC NC PC PCB PCM PO RF SD UART UMTS USB (U)SIM VBAT LTE-A Module Series UMTS&LTE EVB R2.0 User Guide Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode Long Term Evolution Microphone Not Connected Private Computer Printed Circuit Board Pulse Code Modulation Power Output Radio Frequency Secure Digital Universal Asynchronous Receiver & Transmitter Universal Mobile Telecommunications System Universal Serial Bus (Universal) Subscriber Identity Module Voltage of Battery UMTS&LTE_EVB_R2.0_User_Guide 44 / 44

PCIe Card EVB 用户指导 LTE-A&5G 系列模块 版本：1.0 日期：2020-12-23 状态：受控文件 www.quectel.com PCIe Card EVB 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 37 PCIe Card EVB 用户指导 文档历史 修订记录 版本 1.0 日期 2020-12-03 2020-12-23 作者 变更描述 Archibald JIANG 文档创建 Archibald JIANG 受控版本 上海移远通信技术股份有限公司 2 / 37 PCIe Card EVB 用户指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 安全须知 ..................................................................................................................................... 7 2 产品综述 ................................................................................................................................................ 8 2.1. 关键特性 ..................................................................................................................................... 8 2.2. 接口概述 ..................................................................................................................................... 9 2.3. PCIe Card EVB 俯视图 ............................................................................................................ 11 2.4. PCIe Card EVB 配件 ................................................................................................................ 12 3 EVB 装配............................................................................................................................................. 14 4 接口应用 .............................................................................................................................................. 15 4.1. 电源接口（J801/J401/J803/J501） ......................................................................................... 15 4.2. M.2 接口（J101） .................................................................................................................... 17 4.3. USB 接口（J401）.................................................................................................................. 17 4.4. (U)SIM 接口（J301/J302）...................................................................................................... 20 4.5. UART 接口（J601） ............................................................................................................... 21 4.6. 开关和按钮（S101/S102/S103/S104*） ................................................................................. 23 4.7. 状态指示灯（D101/D102）...................................................................................................... 24 4.8. 测试点（J102/J103/J602/J603/J802）.................................................................................... 25 5 操作程序说明....................................................................................................................................... 28 5.1. 模块开机 ................................................................................................................................... 28 5.2. 通信 .......................................................................................................................................... 29 5.2.1. USB Type-B 接口通信 ................................................................................................... 29 5.2.2. PCIe 接口通信 ............................................................................................................... 29 5.3. 固件升级 ................................................................................................................................... 31 5.3.1. USB 固件升级................................................................................................................ 31 5.3.2. PCIe 固件升级 ............................................................................................................... 32 5.4. 模块复位 ................................................................................................................................... 34 5.5. 模块关机 ................................................................................................................................... 34 5.6. 耗流测试 ................................................................................................................................... 35 6 附录 ..................................................................................................................................................... 36 上海移远通信技术股份有限公司 3 / 37 PCIe Card EVB 用户指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：PCIE CARD EVB 关键特性................................................................................................................ 8 表 3：PCIE CARD EVB 组件功能................................................................................................................ 9 表 4：配件清单 ........................................................................................................................................... 12 表 5：J401 引脚分布 .................................................................................................................................. 18 表 6：J301/302 引脚定义 ........................................................................................................................... 21 表 7：J601 引脚定义 .................................................................................................................................. 22 表 8：开关和按钮说明 ................................................................................................................................ 24 表 9：状态指示灯说明 ................................................................................................................................ 25 表 10：J102、J103、J602、J603 和 J802 测试点定义 ............................................................................ 26 表 11：D101 和 D102 指示状态说明 ........................................................................................................ 28 表 12：参考文档 ......................................................................................................................................... 36 表 13：缩略语............................................................................................................................................. 36 上海移远通信技术股份有限公司 4 / 37 PCIe Card EVB 用户指导 图片索引 图 1：PCIE CARD EVB 接口示意图 ............................................................................................................ 9 图 2：PCIE CARD EVB 俯视图...................................................................................................................11 图 3：PCIE CARD EVB 配件...................................................................................................................... 12 图 4：PCIE CARD EVB 装配图.................................................................................................................. 14 图 5：EVB 电源结构框图........................................................................................................................... 15 图 6：EVB 电源接口................................................................................................................................... 16 图 7：适配器插头 ....................................................................................................................................... 16 图 8：模块和 EVB 连接 .............................................................................................................................. 17 图 9：J401 引脚分布 .................................................................................................................................. 18 图 10：模块及 USB 接口连接示意图.......................................................................................................... 19 图 11：J301 和 J302 引脚分布 ................................................................................................................... 20 图 12：(U)SIM 信号连接示意图.................................................................................................................. 20 图 13：UART 结构框图 .............................................................................................................................. 21 图 14：J601 引脚分布 ................................................................................................................................ 22 图 15：开关 S101 和按钮 S102.................................................................................................................. 23 图 16：开关 S103....................................................................................................................................... 23 图 17：状态指示灯 ..................................................................................................................................... 24 图 18：J102 和 J103 测试点 ..................................................................................................................... 25 图 19：J602、J603 和 J802 测试点........................................................................................................... 26 图 20：USB 端口........................................................................................................................................ 29 图 21：QCOM 上的 COM 端口设置（通过 USB AT PORT 连接）............................................................ 29 图 22：PCIE 接口通信连接方式................................................................................................................. 30 图 23：PCIE 端口...................................................................................................................................... 30 图 24：QCOM 上的 COM 端口设置（通过 AT PORT 连接） ................................................................... 30 图 25：固件升级 ......................................................................................................................................... 31 图 26：PCIE 固件升级第一步..................................................................................................................... 32 图 27：PCIE 固件升级第二步..................................................................................................................... 32 图 28：PCIE 固件升级第三步..................................................................................................................... 33 图 29：PCIE 固件升级第三步..................................................................................................................... 33 图 30：R814 位置....................................................................................................................................... 35 图 31：J803 位置 ....................................................................................................................................... 35 上海移远通信技术股份有限公司 5 / 37 PCIe Card EVB 用户指导 1 引言 本文介绍了如何使用 PCIe Card EVB 去调试 M.2 系列模块，该 EVB 是用于开发和测试移远模块的辅 助工具。 表 1：适用模块 模块系列 LTE-Advanced 模块系列 5G 模块系列 适用模块 EM120R-GL/ EM121R-GL/ EM160R-GL/ RM500Q 系列/ RM510Q-GL 备注 以上列出的移远模块可能包括多个型号。请参考相应模块的规格说明书以获得更详细的信息。 上海移远通信技术股份有限公司 6 / 37 PCIe Card EVB 用户指导 1.1. 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或(U)SIM 卡无效时。如果设备支持紧急呼叫功能，请使用紧急呼叫，同时请确保设备开机并 且位于信号强度足够的区域。因不能保证所有情况下网络都能连接，故在紧急情况 下，不能将带有紧急呼叫功能的设备作为唯一的联系方式。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 7 / 37 PCIe Card EVB 用户指导 2 产品综述 移远为工程师提供 PCIe Card EVB 来帮助其开发应用程序。本章提供了此 EVB 的相应概述。 2.1. 关键特性 下表描述了 PCIe Card EVB 的关键特性。 表 2：PCIe Card EVB 关键特性 特性 M.2 接口 (U)SIM 接口 UART 接口 USB 接口 状态指示灯 开关和按钮 尺寸 说明 标准 PCI Express M.2 接口 支持(U)SIM 卡热插拔检测 支持(U)SIM 卡电压：1.8/3.0 V 模块调试接口 USB Type-B (USB 2.0 和 USB 3.0) 2 个 LED 状态指示灯用于显示电源及网络状态 开关：电源开关 (S103)，PWRKEY (S101) 按钮：RESET (S102) 101.8 mm × 112.0 mm 上海移远通信技术股份有限公司 8 / 37 2.2. 接口概述 PCIe Card EVB 用户指导 S104 J501 PCIe Card 接口 M.2 接口 J101 测试点 J802 EVB电 源开关 S103 ANT_MAIN (U)SIM1 J301 测试点 J603 (U)SIM2 J302 J602 M.2 Module 测试点 ANT_MIMO1 J103 J102 状态指示灯 WWAN_LED POWER ANT_MIMO2 J601 DBG_UART D102 D101 USB Type-B J401 ANT_DIV S102 J803 J801 S101 RESET 外部供电接口 适配器供电 PWRKEY 图 1：PCIe Card EVB 接口示意图 表 3：PCIe Card EVB 组件功能 功能 编号 电源 1) J801 J401 说明 适配器插座 典型供电电压：+5 V USB Type-B 接口 典型供电电压：+5 V 上海移远通信技术股份有限公司 9 / 37 PCIe Card EVB 用户指导 J803 J501 电源开关 S103 PWRKEY S101 RESET PCIe/USB 开关* S102 S104 USB Type-B J401 (U)SIM1 J301 (U)SIM2 J302 UART J601 状态指示灯 D101 D102 M.2 及 PCIe Card J101 接口 J501 测试点 J102, J103, J602, J603, J802 外部供电接口 典型供电电压：+3.7 V PCIe Card 接口 典型供电电压：+3.3 V EVB 供电开关 模块供电开关 复位按键，用于模块复位 PCIe/USB 接口切换开关 USB 设备接口，也可用于 EVB 供电 (U)SIM1 卡槽 (U)SIM2 卡槽 调试串口 用于指示 EVB 供电状态 用于指示模块射频功能是否开启 M.2 标准接口，用于模块与 EVB 连接 PCIe Card 接口 测试点 备注 1. 1)上表中的电源信息适用于模块。有关电源的详细信息，请参阅 4.1 章节。 2. '*' 表示正在开发中。当前 PCIe/USB 开关无任何作用。 上海移远通信技术股份有限公司 10 / 37 2.3. PCIe Card EVB 俯视图 PCIe Card EVB 俯视图如下图所示： PCIe Card EVB 用户指导 图 2：PCIe Card EVB 俯视图 上海移远通信技术股份有限公司 11 / 37 PCIe Card EVB 用户指导 2.4. PCIe Card EVB 配件 PCIe Card EVB 所有配件如下图所示： USB转UART数据线 天线 说明书 适配器 导热垫片 U盘 CN类型适配 器插头 天线座连接线 BS类型适配 器插头 EU类型适配 器插头 螺丝螺柱 US类型适配 器插头 USB Type-B 数据线 图 3：PCIe Card EVB 配件 散热片 表 4：配件清单 配件 数据线 描述 USB 转 UART 数据线 USB Type-B 数据线 天线座连接线 上海移远通信技术股份有限公司 数量 1 1 4 12 / 37 天线 U盘 导热垫片 螺丝螺柱 说明书 散热片 适配器 适配器插头 PCIe Card EVB 用户指导 天线 ⚫ USB 2.0 转 RS-232 驱动 ⚫ USB 驱动 ⚫ QUD 驱动和 UDE 驱动 ⚫ 其它模块相关文档和工具 导热垫片 用于固定 EVB 和模块 简要说明主要配件及模块与 EVB 的连接方式 增强模块散热能力 5 V/3 A 电源适配器 BS 类型（英国标准） EU 类型（欧洲标准） US 类型（美国标准） CN 类型（中国标准） 4 1 1 4 个+ 4 个（两种型号螺丝， 各 4 个）用于 EVB, 6 个用 于固定模块和散热片 1 1 1 1 1 1 1 备注 四根天线中的每一根都可用于主集、分集和 GNSS 天线接口。 上海移远通信技术股份有限公司 13 / 37 3 EVB 装配 EVB 及配件装配方式如下图： PCIe Card EVB 用户指导 图 4：PCIe Card EVB 装配图 上海移远通信技术股份有限公司 14 / 37 PCIe Card EVB 用户指导 4 接口应用 本章介绍 PCIe Card EVB 的如下接口应用，及有关按钮、开关、状态指示灯、测试点的相关信息，以 便您更好地使用 PCIe Card EVB。 ⚫ 电源接口 ⚫ M.2 接口 ⚫ USB 接口 ⚫ (U)SIM 接口 ⚫ UART 接口 ⚫ 开关和按钮 ⚫ 状态指示灯 ⚫ 测试点 4.1. 电源接口（J801/J401/J803/J501） PCIe Card EVB 可以通过适配器连接至适配器接口（J801）供电，或通过 USB Type-B 接口（J401） 供电。J801 和 J401 均连接至一个 DC-DC 芯片，可以将 5 V 的供电转为适用于模块的 3.7 V 供电，也可以 通过将 EVB 插入台式计算机的 PCIe 卡插槽来获取电源。 模块可连接电源插座（J803），由外部电源直接供电。这种供电方式一般用于耗流测试。 PCIe Card EVB 电源结构及接口如下图所示： J401 USB Type-B 接口 J501 PCIe 接口 降压转换 U802 TPS54319 VCC J801 适配器供电 S103 VCC 电源开关 U203 LDO VCC_ MODULE U201 LDO 3.3 V J803 外部电源供电 M.2 模组电源 1.8 V 图 5：EVB 电源结构框图 上海移远通信技术股份有限公司 15 / 37 3.7 V DC 电源 PCIe Card EVB 用户指导 5 V DC 电源 3.3 V DC 电源 图 6：EVB 电源接口 当使用适配器供电时，适配器的插头设计如下图所示。 内接点 . 外层导体 图 7：适配器插头 上海移远通信技术股份有限公司 16 / 37 PCIe Card EVB 用户指导 4.2. M.2 接口（J101） M.2 接口是为适应模块而设计的。模块通过 BTB 连接器 J101 连接到 EVB。该接口便于您测试模块的 功能或基于该模块开发应用程序。 模块和 EVB 的连接方式如下图所示。 图 8：模块和 EVB 连接 4.3. USB 接口（J401） PCIe Card EVB 提供一个 USB Type-B 接口（J401）用于其与主机连接，其中的 VBUS 用于给 EVB 供电。 上海移远通信技术股份有限公司 17 / 37 PCIe Card EVB 用户指导 9 8 7 65 1 4 11 2 3 10 图 9：J401 引脚分布 表 5：J401 引脚分布 引脚号 引脚名 1 2 VBUS USB_DM 3 4 5 6 7 8 9 10 11 USB_DP GND TX- TX+ GND RX- RX+ GND GND 上海移远通信技术股份有限公司 18 / 37 下图显示了模块与 USB Type-B 插座的连接方式。 Module USB_SS_TX_M USB_SS_TX_P USB_SS_RX_M USB_SS_RX_P PCIe Card EVB 用户指导 J401 TX+ TXRX+ RX- USB_DP USB_DM R1 0R R2 0R ESD 图 10：模块及 USB 接口连接示意图 USB_DP USB_DM USB Type-B 上海移远通信技术股份有限公司 19 / 37 PCIe Card EVB 用户指导 4.4. (U)SIM 接口（J301/J302） PCIe Card EVB 有两个 8 针自弹式(U)SIM 卡（3.0/1.8 V）连接器 J301 和 J302。二者均可用于模块。 下图显示了 J301 和 J302 的引脚分布和定义。 J301 J302 CD C8 C4 C7 C3 C6 C2 C5 C1 CD C8 C4 C7 C3 C6 C2 C5 C1 C8 C7 C6 C5 C8 C7 C6 C5 C4 C3 C2 C1 C4 C3 C2 C1 图 11：J301 和 J302 引脚分布 J101 USIM_VDD USIM_DATA USIM_CLK USIM_RST USIM_DET J301/J302 GND C1 USIM_VDD C7 USIM_DATA C3 USIM_CLK C2 USIM_RST CD USIM_DET C5 GND (U)SIM card connector 图 12：(U)SIM 信号连接示意图 上海移远通信技术股份有限公司 20 / 37 表 6：J301/302 引脚定义 引脚号 引脚名 I/O C1 USIM_VDD PO C2 USIM_RST DO C3 USIM_CLK DO C4 RESERVED - C5 GND - C6 VPP - C7 USIM_DATA I/O C8 RESERVED - CD USIM_DET DI PCIe Card EVB 用户指导 描述 (U)SIM 卡电源，由模块提供 (U)SIM 卡复位 (U)SIM 卡时钟 地 (U)SIM 卡数据 (U)SIM 卡插拔检测引脚 4.5. UART 接口（J601） PCIe Card EVB 提供一个 UART 接口（J601）用于模块的调试。此 UART 接口默认支持 115200 bps 波特率。它可以用于 Linux 控制台和日志输出。其结构框图如下图所示。 COM DB9 J601 RS-232 RS-232 电平匹配 U601 3.0 V 3.0/1.8 V 电平转换 U602 J602 DBG_TXD DBG_RXD 1.8 V J603 DBG_RTS DTR_TEST 图 13：UART 结构框图 上海移远通信技术股份有限公司 21 / 37 如下图示及表格说明了 J601 的引脚分布及定义。 1 23 45 6 78 9 PCIe Card EVB 用户指导 图 14：J601 引脚分布 表 7：J601 引脚定义 引脚号 1 2 3 4 5 6 7 8 9 引脚名 NC DBG_TXD DBG_RXD DTR_TEST GND NC DBG_RTS NC NC I/O 描述 - 悬空引脚 DO Debug UART 发送 DI Debug UART 接收 DI 数据终端就绪 - 地 - 悬空引脚 DI 请求发送 - 悬空引脚 - 悬空引脚 上海移远通信技术股份有限公司 22 / 37 PCIe Card EVB 用户指导 4.6. 开关和按钮（S101/S102/S103/S104*） PCIe Card EVB 有两个电源开关（S101 和 S103）、一个复位按钮（S102）和一个 PCIe/USB 开关 （S104）*，如下图所示： S101 S102 图 15：开关 S101 和按钮 S102 S103 图 16：开关 S103 上海移远通信技术股份有限公司 23 / 37 表 8：开关和按钮说明 编号 S101 S102 S103 S104* 功能 模块开关 复位 电源开关 PCIe/USB 开关 PCIe Card EVB 用户指导 描述 模块开关机 模块复位 EVB 供电开关 PCIe/USB 接口切换开关 备注 '*' 表示正在开发中。当前 PCIe/USB 开关无任何作用。 4.7. 状态指示灯（D101/D102） PCIe Card EVB 提供两个状态指示灯（D101 和 D102），如图所示。 D101 D102 图 17：状态指示灯 上海移远通信技术股份有限公司 24 / 37 表 9：状态指示灯说明 编号 D101 D102 说明 电源开/关指示灯，指示 EVB 的电源状态 灯亮：EVB 通电； 灯灭：EVB 断电。 模块射频状态指示灯 灯亮：射频功能开启； 灯灭：射频功能关闭。 PCIe Card EVB 用户指导 4.8. 测试点（J102/J103/J602/J603/J802） PCIe Card EVB 提供测试点，帮助您获得某些信号的相应波形。下图为 J102、J103、J602、J603 和 J802 的测试点。 J103 J102 8 16 15 7 14 13 6 12 11 5 10 9 4 8 7 3 6 5 2 4 3 1 2 1 图 18：J102 和 J103 测试点 上海移远通信技术股份有限公司 25 / 37 PCIe Card EVB 用户指导 J603 J602 J802 1 2 1 2 12 图 19：J602、J603 和 J802 测试点 表 10：J102、J103、J602、J603 和 J802 测试点定义 J102 测试点编号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 测试点名称 RFFE1_SDA I2S_CLK RFFE1_SCL I2S_DIN POWER_EN I2S_DOUT COEX3 I2S_WS ANTCTL0 COEX2 ANTCTL1 COEX1 ANTCTL2 DPR 模块对应引脚 58 20 56 22 NA 24 60 28 59 62 61 64 63 25 描述 RFFE 串行接口数据信号 I2S 时钟 RFFE 串行接口时钟信号 模块音频接口数据信号 模块电源使能信号 模块音频接口数据信号 COEX3 模块音频接口帧同步信号 天线控制信号 LTE/WLAN 共存信号 天线控制信号 LTE/WLAN 共存信号 天线控制信号 动态功率调整 上海移远通信技术股份有限公司 26 / 37 PCIe Card EVB 用户指导 15 16 J103 测试点编号 1 2 3 4 5 6 7 8 J602 测试点编号 1 2 J603 测试点编号 1 2 J802 测试点编号 1 2 ANTCTL3 GND 65 天线控制信号 3, 5, 11, 27, 33, 39, 45, 地 51, 57, 71, 73, 76, 79 测试点名称 模块对应引脚 VCC_CARD NA RESET NA PWR_OFF# 6 DISABLE1 8 DISABLE2 26 LED 10 WAKE_ON_WAN 23 MODULE_PIN68 68 描述 EVB电源测试点 模块复位，高电平有效 模块开关机，高电平开机 飞行模式控制 GNSS 使能控制 WWAN 状态指示测试点 唤醒主机 模块 68 引脚 测试点名称 TXD_1V8 RXD_1V8 模块对应引脚 NA NA 描述 TXD_1V8 测试点 RXD_1V8 测试点 测试点名称 RTS_1V8 DTR_3V3 模块对应引脚 NA NA 描述 直接连接到电平转换芯片 数据终端就绪测试点 测试点名称 VCC_MODULE GND 模块对应引脚 描述 2, 4, 7, 72, 74 模块电源测试点 3, 5, 11, 27, 33, 39, 45, 地 51, 57, 71, 73, 76, 79 上海移远通信技术股份有限公司 27 / 37 PCIe Card EVB 用户指导 5 操作程序说明 本章介绍如何使用 PCIe Card EVB 对模块进行测试和评估。 5.1. 模块开机 1. 将模块连接到 EVB：将模块插入 EVB 上的 BTB 连接器（J101），然后用螺钉固定模块； 2. 将(U)SIM 卡插入 EVB 上的(U)SIM 卡连接器，并将天线连接到模块； 3. 将 EVB 连接到 5 V 电源适配器上，或使用 USB Type-B 线将 EVB 连接到 PC，或将 EVB 插入台式 计算机的 PCIe Card 插槽。 4. 将 S103（电源开关）切换到 ON 状态，D101（电源开/关指示灯）亮，表示 EVB 的电源已就绪， 此时将 S101（PWRKEY）切换到 ON 状态，模块开机。随后，当 RF 功能开启时，D102 亮。 下表显示了由 D101 和 D102 指示的模块状态。 表 11：D101 和 D102 指示状态说明 编号 D101 D102 状态 长亮 长灭 长亮 长灭 说明 EVB 供电 ON EVB 供电 OFF 射频功能开启 射频功能关闭 上海移远通信技术股份有限公司 28 / 37 PCIe Card EVB 用户指导 5.2. 通信 5.2.1. USB Type-B 接口通信 1. 按照第 5.1 章节所述的流程将模块开机。 2. 通过 USB Type-B 接口，使用 USB 数据线连接 EVB 和 PC，然后在 PC 上安装 U 盘里的 USB 驱 动程序。有关 USB 驱动程序安装的详细信息，请参阅文档 [1]。 图 20：USB 端口 3. 安装并使用 Quectel 提供的 QCOM 工具实现模块与 PC 之间的通信。QCOM 上的 COM 端口设置 如下图所示：选择正确的'COM Port'（COM 端口，上图中的 USB AT Port）并设置正确的 'Baudrate'（波特率，如 115200 bps）。有关 QCOM 工具使用和配置的详细信息，请参阅文档 [2]。 图 21：QCOM 上的 COM 端口设置（通过 USB AT Port 连接） 5.2.2. PCIe 接口通信 1. 将 EVB 插入台式机的 PCIe Card 插槽，如下图所示。然后按照第 5.1 章所述的流程接通模块电源。 请注意，当 EVB 插入台式计算机的 PCIe 卡插槽时，请勿通过其他电源接口为 EVB 供电。 上海移远通信技术股份有限公司 29 / 37 PCIe card EVB PCIe Card EVB 用户指导 机箱 图 22：PCIe 接口通信连接方式 2. 在 PC 上运行 UDE 驱动程序和 QUD 驱动程序。 图 23：PCIe 端口 3. 安装并使用 Quectel 提供的 QCOM 工具实现模块与 PC 之间的通信，下图显示了 QCOM 上的 COM 端口设置：选择正确的'COM Port'（上图所示的 AT Port）并设置正确的'Baudrate'（如 115200 bps）。有关 QCOM 工具使用和配置的详细信息，请参阅文档 [2]。 图 24：QCOM 上的 COM 端口设置（通过 AT Port 连接） 上海移远通信技术股份有限公司 30 / 37 PCIe Card EVB 用户指导 5.3. 固件升级 5.3.1. USB 固件升级 模块固件默认通过 USB 端口升级，请按照以下步骤升级固件。 1. 在 PC 上安装并打开固件升级工具 QFlash，然后按照第 5.1 章所述的步骤打开模块电源。 2. 点击'COM Port'下拉列表，选择 USB DM 端口。 3. 点击'Load FW Files'按钮选择固件包。 4. 点击'Start'按钮升级固件。 图 25：固件升级 有关 QFlash 工具使用和配置的更多详细信息，请参阅文档 [3]。 上海移远通信技术股份有限公司 31 / 37 PCIe Card EVB 用户指导 5.3.2. PCIe 固件升级 如需通过 PCIe 端口升级模块的固件，请按照以下步骤升级。 1. 使用 QCOM 打开 Diagnostic Port (COM5)，然后选择'HEX String'，发送十六进制数组：0x4b, 0x65, 0x01, 0x00, 0x54, 0x0f, 0x7e。 图 26：PCIe 固件升级第一步 2. 执行上述命令后，用户将看到下图所示设备，右键单击此节点并选择'禁用'。禁用此设备节点后， 再次右键单击该节点并选择'启用'。 图 27：PCIe 固件升级第二步 3. 使用管理员权限打开 cmd.exe（命令提示符），然后切换到版本升级文件的 firehouse 目录。执行 QBHiServer.exe 下载 prog_firehose_sdx24.mbn。 上海移远通信技术股份有限公司 32 / 37 PCIe Card EVB 用户指导 图 28：PCIe 固件升级第三步 4. 执行上述命令后，EDL 端口将显示出来。 图 29：PCIe 固件升级第三步 5. 直接在 CMD 里调用 Qfirehose.exe 执行命令： Qfirehose.exe -f FW_PATH -p .COM3 -v 1 ⚫ FW_Path：版本的根目录，即 update 的上一级目录。 ⚫ COM3：EDL Port. 6. 等待大约 30 秒，随后模块将开始工作。 上海移远通信技术股份有限公司 33 / 37 PCIe Card EVB 用户指导 5.4. 模块复位 复位功能仅在紧急情况下使用。例如，由于某些严重问题，模块超过 5 秒没有响应。 按下按钮 S102（RESET）250~600 毫秒后释放以复位模块。由于复位功能会使模块初始化，此操作 可能会导致存储器中存储的信息丢失。 备注 按下复位按钮的时间不能超过最大值，否则模块将关机。 5.5. 模块关机 如下两种方法可以将模块关机。 ⚫ 硬件关机：将 S101 切换到 OFF 状态，模块断电。 ⚫ 软件关机：使用 AT+QPOWD 命令关闭模块。 备注 有关 AT+QPOWD 命令的详细信息，请参阅相应模块的 AT 命令手册。 上海移远通信技术股份有限公司 34 / 37 5.6. 耗流测试 PCIe Card EVB 做了以下修改后，还可用于测试模块的耗流。 1. 移除 R814。 R814 PCIe Card EVB 用户指导 图 30：R814 位置 2. 将 J803 连接到外部电源，为模块单独供电。 J803 图 31：J803 位置 3. 按照第 5.1 章所述流程接通模块电源，然后测试电流消耗。 上海移远通信技术股份有限公司 35 / 37 PCIe Card EVB 用户指导 6 附录 表 12：参考文档 编号 文档名称 [1] Quectel_LTE&5G_Windows_USB_Driver_安装指导 [2] Quectel_QCOM_User_Guide [3] Quectel_QFlash_用户指导 备注 在 Windows 系统上为 M.2 模块安装 USB 驱动 QCOM 工具使用说明 QFlash 工具使用说明 表 13：缩略语 缩写 AGND BTB COM DC DI DO EVB GND GNSS I/O LED LTE 描述 Analog Ground Board to Board Communication Port Direct Current Digital Input Digital Output Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode Long Term Evolution 上海移远通信技术股份有限公司 36 / 37 NC PC PCB PCM PO RF UART USB (U)SIM Not Connected Personal Computer Printed Circuit Board Pulse Code Modulation Power Output Radio Frequency Universal Asynchronous Receiver/Transmitter Universal Serial Bus (Universal) Subscriber Identity Module PCIe Card EVB 用户指导 上海移远通信技术股份有限公司 37 / 37

Quectel RM510Q-GL + RA510T + 5G-mmWave-EVB Kit Assembly Instruction Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. Page 2 / 17 Version: 1.0 | Status: Released Pre-process Assembly Steps Function of Accessories Page 3 / 17 Version: 1.0 | Status: Released Pre-process – Housing Dismantling 1 2 3 4 1. Remove the 6 self-tapping screws (M3 × L8) from the back of the CPE. CPE: Customer-Premises Equipment Page 4 / 17 2. Remove the front housing. 3. Remove the screw (M3 × L8) on the EVB. 4. Then remove the EVB. Please loosen the side where network port locates first, and then loosen the other side where the SMA connector locates. Version: 1.0 | Status: Released Pre-process Assembly Steps Function of Accessories Page 5 / 17 Version: 1.0 | Status: Released Assembly Steps (1–2) 1 2 Silicone thermal pad 1 Silicone thermal pad 2 Silicone thermal pad 3 Silicone thermal pad 4 1. Take the silicone thermal pad 1–3 and stick them to the corresponding position on the inside the rear cover. • Silicone thermal pad 1 (35.5 mm × 11.5 mm, T0.7 mm), 2 pcs • Silicone thermal pad 2 (43 mm × 31 mm, T0.65 mm), 1 pcs • Silicone thermal pad 3 (15 mm × 36 mm, T0.65 m), 1 pcs Page 6 / 17 2. Take the Silicone thermal pad 4 (37 mm × 30 mm, T2.5 mm) and stick it to the corresponding position on the EVB. Version: 1.0 | Status: Released Assembly Steps (3) 3 RM510Q-GL Module Page 7 / 17 3. Assemble the RM510Q-GL module to the EVB and fix it with the screw (1 pcs, M2.5 × L6). NOTE: RM510Q-GL module and RA510T are not contained in the EVB kit. Version: 1.0 | Status: Released Assembly Steps (4) 4 mmWave RF Carrier Board 4. Assemble the mmWave RF carrier board (RA510T) to the fixed bracket, and fasten it with these 4 self-tapping screws (M3 × L6). Page 8 / 17 NOTE: RM510Q-GL module and RA510T are not contained in the EVB kit. Version: 1.0 | Status: Released Assembly Steps (5) 5 SMA Connectors Cable 1 (length: 72 mm, × 2) Cable 2 (length: 96 mm, × 2) 5. Connect the RF connector and SMA connectors with cables. Page 9 / 17 NOTE: RM510Q-GL module and RA510T are not contained in the EVB kit. Version: 1.0 | Status: Released Assembly Steps (6) 6 RA510T-RW mmWave RF Carrier Boards RM510Q-GL RA510T-US 6. Connect the RF connectors of RM510Q-GL module and the mmWave RF carrier board (RA510T-RW or RA510T-US) with Cable 3 (length: 82 mm, × 8). Page 10 / 17 NOTE: 1. RM510Q-GL module and RA510T are not contained in the EVB kit. 2. There are two models of RA510T: RA510T-RW and RA510T-US Version: 1.0 | Status: Released Assembly Steps (7) 7 7. Install the EVB with the mmWave RF carrier board (please pass the SMA connectors through the corresponding openings first, and then press the whole EVB into place) to the rear housing, and fasten it with screws (M3 × L8, 5 pcs). Page 11 / 17 NOTE: RM510Q-GL module and RA510T are not contained in the EVB kit. Version: 1.0 | Status: Released Assembly Steps (8–9) 8 9 8. Remove shielding covers shown above (2 on the EVB and 2 on the mmWave RF Carrier Board). Page 12 / 17 9. Fasten the FPCs (2 pcs). NOTE: RM510Q-GL module and RA510T are not contained in the EVB kit. Version: 1.0 | Status: Released Assembly Steps (10–11) 10 11 10. Install the silicone pads to the shielding covers (4 pcs). Page 13 / 17 11. Assemble the shielding covers back to the EVB and mmWave RF carrier board (4 pcs). NOTE: RM510Q-GL module and RA510T are not contained in the EVB kit. Version: 1.0 | Status: Released Assembly Steps (12–13) 12 13 12. Mount the front cover onto the rear housing. Page 14 / 17 13. Fasten the front housing with these 6 self-tapping screws (M3 × L8). Version: 1.0 | Status: Released Pre-process Assembly Steps Function of Accessories Page 15 / 17 Version: 1.0 | Status: Released Function of Accessories Type Description Qty. Size Pre-installed by Quectel Use for Customers Machine screw pan-head_M3 × L8 RO 5 Self-tapping screw 3 × 8 mm RO 6 Screw Screws SC-PM2.5X5-2L RO 7 Plastic self-tapping screw pan-head _M3 × L6 RO 4 Silicone Thermal Pad Silicone thermal pad 1: XK-P80 35.5 mm × 11.5 mm × 0.7 t 7.9 W/(m·K) RO 2 Silicone thermal pad 2: XK-P60 43 mm × 31 mm × 0.65 t 6.0 W/(m·K) RO 1 Silicone thermal pad 3: XK-P60 15 mm × 13 mm × 0.65 t 6.0 W/(m·K) RO 1 Silicone thermal pad 4: XK-P60 37 mm×30 mm×2.5 t 6.0 W/(m·K) RO 1 M3 × L8 1 piece for locking the EVB and 4 pcs for installing mmWave carrier rear housing board and rear housing M3 × L8 6 pcs for locking the front cover and the rear housing - M2.5 × L6 M3 × L6 Self-tapping 5 pcs for fastening the EVB to the bracket - 1 piece for installing the RM510QGL module, 1 piece reserved 4 pcs for fastening the mmWave RF carrier board to the bracket 35.5 × 11.5 × 0.7 mm - Silicone thermal pad to be sticked to the rear housing 43 × 31 × 0.65 mm - Silicone thermal pad to be sticked to the rear housing 15 × 13 × 0.65 mm - Silicone thermal pad to be sticked to the rear housing 37 × 30 × 2.5 mm - Silicone thermal pad to be sticked to the EVB Silicone Pad 5G- mmWave-EVB 22 × 10.6 mm H2.8 mm LST RO 4 22 × 10.6 × 2.8 mm - 4 pcs for pressing FPC conn Cable 1: RF cable DC-6 GHz Length: 72 mm Diameter: 1.13 mm with IPEX MHF4L RO 2 72 mm - Cable 2: RF cable DC-6 GHz Length: 96 mm Diameter: 1.13 mm with IPEX MHF4L RO 2 96 mm - Cable Cable 3: RF cable DC-12 GHz Length: 82 mm Diameter: 1.13 mm with IPEX MHF7S RO 8 82 mm - mmWave-EVB-FPC_V3.1 3L FPC 30 × 17 mm HB RO 2 30 × 17 mm - For connecting RM510Q-GL RF connectors to the SMA connectors. For connecting RM510Q-GL RF connectors to the SMA connectors. For connecting RM510Q-GL RF connectors to the mmWave RF carrier board. For the power supply to RA510T mmWave RF carrier board. Page 16 / 17 Version: 1.0 | Status: Released The number one cellular module vendor in the world and a leading GNSS module supplier • Unbeatable choice from the broadest module portfolio in the world • The highest quality products for the best possible prices • Superb support with the largest R&D team in the industry • Continuous innovation – first to market with 5G, LPWA, CV2X, snapdragon • A passionate, dedicated team of 'Quectelers' ensure our customers always come first Page 17 / 17 Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 • Email: info@quectel.com Technical Support: support@quectel.com Version: 1.0 | Status: Released

Quectel RM510Q-GL + QTM525 + 5G-mmWave-LP EVB Kit Assembly Instruction Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. Page 2 / 19 Version: 1.0 | Status: Released QTM525 Bracket Assembly RM510Q-GL Wiring Diagram 5G-mmWave-LP EVB Kit Assembly Function of Accessories Page 3 / 19 Version: 1.0 | Status: Released QTM525 N0 Bracket Assembly 1 3 4 2 5 6 1. Place the heatsink into the QTM525 bracket. 2. Tighten these two M2.5 × 5 screws. Page 4 / 19 3. Stick the silicone thermal pad 5. Insert QTM525. or apply heat dissipating glue. 6. Insert antenna cover. 4. Insert the QTM525 adapter board, and connect two RF cables (length: 200 mm) as well as one flat cable. NOTE: RM510Q-GL module and QTM525 are not contained in the EVB kit. Version: 1.0 | Status: Released QTM525 N1 Bracket Assembly 1 4 2 3 5 6 1. Place the heatsink into the QTM525 bracket. 2. Tighten these two M2.5 × 5 screws. Page 5 / 19 3. Insert QTM525 adapter board, 5. Insert QTM525. and connect two RF wires (length: 350 mm) as well as one flat cable. 6. Insert antenna cover. 4. Stick the silicone thermal pad or apply heat dissipating glue. NOTE: RM510Q-GL module and QTM525 are not contained in the EVB kit. Version: 1.0 | Status: Released QTM525 N2 Bracket Assembly 1 3 4 5 2 6 1. Place the heatsink into the QTM525 bracket. 2. Tighten these two M2.5 × 5 screws. Page 6 / 19 3. Stick the silicone thermal pad 5. Insert QTM525. or apply heat dissipating glue. 6. Insert antenna cover. 4. Insert QTM525 adapter board, and connect two RF wires (length: 200 mm) as well as one flat cable. NOTE: RM510Q-GL module and QTM525 are not contained in the EVB kit. Version: 1.0 | Status: Released QTM525 N3 Bracket Assembly 1 3 2 4 5 6 1. Place the heatsink into the QTM525 bracket. 2. Tighten these two M2.5 × 5 screws. Page 7 / 19 3. Stick the silicone thermal pad 5. Insert QTM525. or apply heat dissipating glue. 6. Insert antenna cover. 4. Insert QTM525 adapter board, and connect two RF wires (length: 350 mm) as well as one flat cable. NOTE: RM510Q-GL module and QTM525 are not contained in the EVB kit. Version: 1.0 | Status: Released QTM525 Bracket Assembly RM510Q-GL Wiring Diagram 5G-mmWave-LP EVB Kit Assembly Function of Accessories Page 8 / 19 Version: 1.0 | Status: Released RM510Q-GL Wiring Diagram QTM525 N3 QTM525 N1 Page 9 / 19 QTM525 N2 QTM525 N0 QTM525 N1 QTM525 N3 QTM525 N2 QTM525 N0 NOTE: RM510Q-GL module and QTM525 are not contained in the EVB kit. Version: 1.0 | Status: Released QTM525 Bracket Assembly RM510Q-GL Wiring Diagram 5G-mmWave-LP EVB Kit Assembly Function of Accessories Page 10 / 19 Version: 1.0 | Status: Released 5G-mmWave-LP EVB Kit Assembly – EVB PCBA 1. Place EVB PCBA properly and tighten these two self-tapping PB3 × 8 screws. 2. Stick the silicone thermal pad. 1 2 Page 11 / 19 Bottom Shell Version: 1.0 | Status: Released 5G-mmWave-LP EVB Kit Assembly – RM510Q-GL (1) 1. Insert two Sub-6 GHz RF cables (length: 72 mm). 1 2. Insert two Sub-6 GHz RF cables (length: 96 mm). 2 3. Tighten the M2.5 × 5 screw. 3 4 4. Install the RM510Q-GL module. NOTE: RM510Q-GL module and QTM525 are not contained in the EVB kit. Page 12 / 19 Version: 1.0 | Status: Released 5G-mmWave-LP EVB Kit Assembly – RM510Q-GL (2) 5. Install the RF cable trough. 5 6. Tighten these two PB3 × 8 self-tapping screws. 6 NOTE: RM510Q-GL module and QTM525 are not contained in the EVB kit. Page 13 / 19 Version: 1.0 | Status: Released 5G-mmWave-LP EVB Kit Assembly – QTM525 1. Install the QTM525 N3 bracket and connect corresponding cables properly. 1 2. Install the QTM525 N1 bracket and connect corresponding cables properly. 3. Install the QTM525 N2 bracket and connect corresponding cables properly. 4. Install the QTM525 N0 bracket 2 and connect corresponding cables properly. NOTE: RM510Q-GL module and QTM525 are not contained in the EVB kit. Page 14 / 19 3 4 Version: 1.0 | Status: Released 5G-mmWave-LP EVB Kit Assembly – Heatsink & Top Shell (1) 1. Install the AQC107 heatsink and tighten these two M2.5 × 5 screws. 1 2. Install the RM510Q-GLAA heatsink and tighten these three M2.5 ×10 screws. 2 Page 15 / 19 Version: 1.0 | Status: Released 5G-mmWave-LP EVB Kit Assembly – Heatsink & Top Shell (2) 3. Mount the top shell and tighten 3 these four PB3 × 8 self-tapping screws from rear side of the bottom shell. Page 16 / 19 Version: 1.0 | Status: Released QTM525 Bracket Assembly RM510Q-GL Wiring Diagram 5G-mmWave-LP EVB Kit Assembly Function of Accessories Page 17 / 19 Version: 1.0 | Status: Released Function of Accessories Type Screw Description Self-tapping Screw 3 × 8 mm RO Screw SC-PM2.5X10-2L RO Qty. 8 3 Screw SC-PM2.5X5-2L RO 12 Silicone Thermal pad XK-P60 37 mm × 30 mm × 2.5 t 6.0 W/(m·K) RO 1 Silicone Pad Silica Gel Pad 14.5 mm × 18.5 mm T0.5 mm 8 W/(m·K) RO 4 AL6063T5 Black Anodized 35 mm × 35 mm Height: 22 mm RO 1 Heatsink AL6063T5 Black Anodized 60 mm × 60 mm Height: 30 mm RO 1 Cable AL6063T5 Black Coating 18 × 12 mm Height: 20 mm RO 4 RF cable DC-12 GHz Length: 200 mm Diameter: 1.13 mm with IPEX MHF7S RO 4 RF cable DC-12 GHz Length: 350 mm Diameter: 1.13 mm with IPEX MHF7S RO 4 RF cable DC-6 GHz Length: 72 mm Diameter: 1.13 mm with IPEX MHF4L RO 2 RF cable DC-6 GHz Length: 96 mm Diameter: 1.13 mm with IPEX MHF4L RO 2 Page 18 / 19 Size PB3 × L8 M2.5 × L10 M2.5 × L5 37 × 30 × 2.5 mm 14.5 × 18.5 × 0.5 mm 35 × 35 × 22 mm 60 × 60 × 30 mm 35 × 35 × 22 mm Length: 200 mm Length: 350 mm Length: 72 mm Length: 96 mm Pre-installed by Quectel Use for Customers 2 pcs for installing EVB, 2 pcs for installing RF wire trough. 8 pcs for installing QTM525 heatsink, 2 pcs for installing AQC107 heatsink. - To be installed above AQC107 position of EVB - - - - - - 4 pcs for installing bracket 3 pcs for installing module’s heatsink 1 piece for installing the RM510Q-GL module; 1 piece reserved Silicone thermal pad to be sticked to the EVB Silicone thermal pad to be sticked to QTM525 - To be installed above the module position on the EVB To be installed on 4 brackets respectively To connect QTM525 N0/ QTM525 N2 and the EVB To connect QTM525 N1/ QTM525 N3 and the EVB To connect RM510Q-GL module and the EVB To connect RM510Q-GL module and the EVB Version: 1.0 | Status: Released The number one cellular module vendor in the world and a leading GNSS module supplier • Unbeatable choice from the broadest module portfolio in the world • The highest quality products for the best possible prices • Superb support with the largest R&D team in the industry • Continuous innovation – first to market with 5G, LPWA, CV2X, snapdragon • A passionate, dedicated team of 'Quectelers' ensure our customers always come first Page 19 / 19 Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 • Email: info@quectel.com Technical Support: support@quectel.com Version: 1.0 | Status: Released

Smart EVB G2 User Guide Smart LTE Module Series Rev. Smart_EVB_G2_User_Guide_V1.1 Date: 2018-06-05 Status: Released www.quectel.com Smart LTE Module Series Smart EVB G2 User Guide 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. Smart_EVB_G2_User_Guide 1 / 59 Smart LTE Module Series Smart EVB G2 User Guide About the Document History Revision Date 1.0 2017-09-19 1.1 2018-06-05 Author Vae LIU Glenn GE Description Initial 1. Updated the description of (U)SIM Interfaces in Table 1. 2. Updated the description of camera interface. 3. Added the reserved MIPI+SPI/I2S Interface. 4. Updated the size of the EVB into 26.5cm × 19.0cm. 5. Updated the description of USB interface (added a Micro USB interface and USB switch S0601). 6. Updated power supply design and the description of battery interface in Chapter 4.1. 7. Updated screen prints for some components. Smart_EVB_G2_User_Guide 2 / 59 Smart LTE Module Series Smart EVB G2 User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 8 1.1. Safety Information ....................................................................................................................... 9 2 General Overview............................................................................................................................... 10 2.1. Key Features ............................................................................................................................. 10 2.2. Interface Overviews .................................................................................................................. 12 2.3. Top and Bottom Views of Smart EVB G2 ................................................................................. 15 2.4. Smart EVB G2 Kit Accessories................................................................................................. 16 3 Smart EVB G2 Kit Accessories Assembly ...................................................................................... 19 4 Interface Applications ....................................................................................................................... 20 4.1. Power Supply Interfaces (J0201/J0202)................................................................................... 20 4.1.1. Adapter Interface............................................................................................................ 21 4.1.2. Battery Interface ............................................................................................................. 22 4.1.3. Switches for Power Supply ............................................................................................ 23 4.2. Smart TE-A Interface................................................................................................................. 24 4.3. LCM Interfaces.......................................................................................................................... 30 4.3.1. Main LCM Interface........................................................................................................ 30 4.3.2. Secondary LCM Interface .............................................................................................. 31 4.3.3. Backlight Driver for Secondary LCM Interface .............................................................. 32 4.4. Touch Panel Interfaces ............................................................................................................. 33 4.5. Camera Interfaces..................................................................................................................... 34 4.6. USB Interfaces .......................................................................................................................... 36 4.7. Audio Interfaces ........................................................................................................................ 38 4.7.1. Loudspeaker Interface ................................................................................................... 38 4.7.2. Headset Interface........................................................................................................... 38 4.7.3. Earphone Interface......................................................................................................... 40 4.7.4. Microphone Interfaces.................................................................................................... 41 4.8. (U)SIM Interfaces ...................................................................................................................... 42 4.9. UART Interfaces........................................................................................................................ 43 4.10. SD Card Interface ..................................................................................................................... 45 4.11. Flashlights ................................................................................................................................. 46 4.12. Sensors ..................................................................................................................................... 47 4.13. Emergency Download Interface................................................................................................ 48 4.14. Vibrator...................................................................................................................................... 49 4.15. Buttons ...................................................................................................................................... 49 4.16. Status Indication LEDs.............................................................................................................. 50 Smart_EVB_G2_User_Guide 3 / 59 Smart LTE Module Series Smart EVB G2 User Guide 5 Operation Procedures Illustration.................................................................................................... 52 5.1. Power ON Smart Modules ........................................................................................................ 52 5.2. Communication Via USB or UART Interface ............................................................................ 53 5.2.1. Communication via USB Interface ................................................................................. 53 5.2.2. Communication via UART Interface............................................................................... 54 5.3. Firmware Upgrade .................................................................................................................... 55 5.4. Power OFF Smart Modules ...................................................................................................... 56 6 Appendix A References..................................................................................................................... 58 Smart_EVB_G2_User_Guide 4 / 59 Smart LTE Module Series Smart EVB G2 User Guide Table Index TABLE 1: KEY FEATURES ............................................................................................................................... 10 TABLE 2: INTERFACES OF SMART EVB G2 .................................................................................................. 13 TABLE 3: ACCESSORIES LIST ........................................................................................................................ 17 TABLE 4: PIN DEFINITION OF BATTERY INTERFACE .................................................................................. 22 TABLE 5: DESCRIPTION OF POWER SUPPLY SWITCHES .......................................................................... 24 TABLE 6: PIN DEFINITION OF B2B CONNECTORS....................................................................................... 25 TABLE 7: PIN DEFINITION OF TOUCH PANEL INTERFACES ....................................................................... 34 TABLE 8: PIN DEFINITION OF HEADSET INTERFACE.................................................................................. 40 TABLE 9: PIN DEFINITION OF (U)SIM1 CARD CONNECTOR ....................................................................... 43 TABLE 10: PIN DEFINITION OF MAIN UART PORT ....................................................................................... 44 TABLE 11: DESCRIPTION OF BUTTONS ........................................................................................................ 50 TABLE 12: DESCRIPTION OF STATUS INDICATION LEDS ........................................................................... 51 TABLE 13: RELATED DOCUMENTS ................................................................................................................ 58 TABLE 14: TERMS AND ABBREVIATIONS ...................................................................................................... 58 Smart_EVB_G2_User_Guide 5 / 59 Smart LTE Module Series Smart EVB G2 User Guide Figure Index FIGURE 1: SMART EVB G2 INTERFACE OVERVIEW (TOP) ......................................................................... 12 FIGURE 2: SMART EVB G2 INTERFACE OVERVIEW (BOTTOM) ................................................................. 13 FIGURE 3: SMART EVB G2 TOP VIEW ........................................................................................................... 15 FIGURE 4: SMART EVB G2 BOTTOM VIEW ................................................................................................... 16 FIGURE 5: SMART EVB G2 KIT ACCESSORIES ............................................................................................ 17 FIGURE 6: SMART EVB G2 KIT ACCESSORIES ASSEMBLY ........................................................................ 19 FIGURE 7: SIMPLIFIED POWER SUPPLY BLOCK DIAGRAM OF SMART EVB G2...................................... 21 FIGURE 8: 5V DC POWER JACK..................................................................................................................... 21 FIGURE 9: POWER PLUG DESIGN................................................................................................................. 21 FIGURE 10: REFERENCE DESIGN FOR BATTERY INTERFACE.................................................................. 22 FIGURE 11: PIN ASSIGNMENT OF BATTERY INTERFACE ........................................................................... 22 FIGURE 12: BATTERY ASSEMBLY .................................................................................................................. 23 FIGURE 13: POWER SUPPLY SWITCHES ..................................................................................................... 23 FIGURE 14: B2B CONNECTORS..................................................................................................................... 24 FIGURE 15: SKETCH MAP OF SMART TE-A (TOP VIEW) ............................................................................. 25 FIGURE 16: REFERENCE DESIGN FOR MAIN LCM INTERFACE ................................................................ 30 FIGURE 17: REFERENCE DESIGN FOR SECONDARY LCM INTERFACE .................................................. 31 FIGURE 18: PIN ASSIGNMENTS OF LCM INTERFACES............................................................................... 32 FIGURE 19: REFERENCE DESIGN FOR BACKLIGHT DRIVER .................................................................... 32 FIGURE 20: REFERENCE DESIGN FOR TOUCH PANEL INTERFACES ...................................................... 33 FIGURE 21: PIN ASSIGNMENTS OF TOUCH PANEL INTERFACES ............................................................. 33 FIGURE 22: REFERENCE DESIGN FOR CAMERA INTERFACES ................................................................ 35 FIGURE 23: CAMERA INTERFACES WITH CAMERAS ASSEMBLED ........................................................... 36 FIGURE 24: REFERENCE DESIGN FOR USB INTERFACES ........................................................................ 37 FIGURE 25: USB INTERFACES AND S0601 SWITCH.................................................................................... 37 FIGURE 26: REFERENCE DESIGN FOR LOUDSPEAKER INTERFACE ....................................................... 38 FIGURE 27: REFERENCE DESIGN FOR HEADSET INTERFACE ................................................................. 39 FIGURE 28: PIN ASSIGNMENT OF HEADSET INTERFACE .......................................................................... 39 FIGURE 29: SKETCH OF AUDIO PLUG .......................................................................................................... 40 FIGURE 30: REFERENCE DESIGN FOR EARPHONE INTERFACE.............................................................. 40 FIGURE 31: REFERENCE DESIGN FOR MICROPHONE INTERFACES....................................................... 41 FIGURE 32: MEMS-TYPE AND ECM-TYPE MICROPHONES ........................................................................ 41 FIGURE 33: SIMPLIFIED INTERFACE SCHEMATIC FOR (U)SIM CARD CONNECTOR J1001 ................... 42 FIGURE 34: PIN ASSIGNMENT OF (U)SIM1 CARD CONNECTOR ............................................................... 42 FIGURE 35: RS232 LEVEL MATCH CIRCUIT.................................................................................................. 44 FIGURE 36: PIN ASSIGNMENT OF MAIN UART PORT.................................................................................. 44 FIGURE 37: SIMPLIFIED INTERFACE SCHEMATIC FOR SD CARD INTERFACE ....................................... 45 FIGURE 38: PIN ASSIGNMENT OF SD CARD INTERFACE........................................................................... 46 FIGURE 39: REFERENCE CIRCUIT DESIGN FOR FLASHLIGHT INTERFACES.......................................... 46 FIGURE 40: FLASHLIGHTS ............................................................................................................................. 47 FIGURE 41: SENSORS .................................................................................................................................... 47 Smart_EVB_G2_User_Guide 6 / 59 Smart LTE Module Series Smart EVB G2 User Guide FIGURE 42: REFERENCE DESIGN FOR EMERGENCY DOWNLOAD INTERFACE .................................... 48 FIGURE 43: EMERGENCY DOWNLOAD SWITCH ......................................................................................... 48 FIGURE 44: REFERENCE DESIGN FOR VIBRATOR ..................................................................................... 49 FIGURE 45: ERM-TYPE VIBRATOR ................................................................................................................ 49 FIGURE 46: BUTTONS ..................................................................................................................................... 50 FIGURE 47: STATUS INDICATION LEDS ........................................................................................................ 51 FIGURE 48: LCD DISPLAY INDICATING MODULE’S POWER-ON ................................................................ 52 FIGURE 49: USB COM PORTS ........................................................................................................................ 53 FIGURE 50: 'ADB SHELL' COMMAND............................................................................................................ 54 FIGURE 51: USB SERIAL PORT ...................................................................................................................... 54 FIGURE 52: QCOM CONFIGURATION WHEN CONNECTING USB SERIAL PORT ..................................... 55 FIGURE 53: FIRMWARE UPGRADE STEPS ................................................................................................... 56 Smart_EVB_G2_User_Guide 7 / 59 Smart LTE Module Series Smart EVB G2 User Guide 1 Introduction This document describes the evaluation board (Smart EVB G2) for Quectel Smart module SC60. The smart evaluation board is an assistant tool to develop and test Quectel SC60 modules. Smart_EVB_G2_User_Guide 8 / 59 Smart LTE Module Series Smart EVB G2 User Guide 1.1. Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating SC60 module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as to prevent interference with communication systems. Consult the airline staff about the use of wireless devices on boarding the aircraft, if your device offers an Airplane Mode which must be enabled prior to boarding an aircraft. Switch off your wireless device when in hospitals, clinics or other health care facilities. These requests are designed to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid (U)SIM card. While you are in this condition and need emergent help, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency energy. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. Smart_EVB_G2_User_Guide 9 / 59 Smart LTE Module Series Smart EVB G2 User Guide 2 General Overview Quectel supplies Smart EVB G2 for designers to develop applications based on Quectel SC60 module. This EVB can test basic functionalities of the module. 2.1. Key Features The following table describes the detailed features of Smart EVB G2. Table 1: Key Features Features Power Supply LCM Interfaces Touch Panel Interfaces Camera Interfaces USB Interface Audio Interfaces Implementation DC power supply: 4.75V~6.0V (typical: 5.0V) VBAT: 3.55V~4.4V (typical: 3.8V) Two 5-inch 1280 × 720 HD resolution LCDs 4-lane MIPI DSI interface for each LCD Two capacitive touch panels Support two cameras:  Rear camera supports 16M pixels with 4-lane CSI interface  Front camera supports 8M pixels with 2-lane CSI interface USB type-C interface Compliant with USB 3.0 and 2.0 specifications, with transmission rates up to 5Gbps on USB 3.0 and 480Mbps on USB 2.0. Support USB OTG Used for AT command communication, data transmission, software debugging and firmware upgrade Analog Input: 3 groups of analog microphone inputs, integrating internal bias voltage.  One headset input  One ECM-type microphone input  One MEMS-type microphone input Analog Output: 3 groups of analog audio outputs, including:  One stereo headset output  One mono earphone differential output Smart_EVB_G2_User_Guide 10 / 59 Smart LTE Module Series Smart EVB G2 User Guide (U)SIM Interfaces UART Interfaces SD Card Interface MIPI+SPI/I2S Interface Flashlights Sensors Vibrator Switches and Buttons Status Indication LEDs Physical Characteristics  One mono loudspeaker differential amplifier output Support USIM/SIM cards: 1.8V and 2.95V Support dual SIM dual standby Two UART interfaces:  Main UART for data transmission and AT command communication  Debug UART for debugging Support 4-bit SD card with hot-plug detection Reserved Support 2 flashlight LEDs for testing the module’s flashlight interfaces Support three sensors including ALS/PS, accelerometer/gyroscope and compass A vibrator for testing the motor drive interface of the module 4 switches including two power supply switches ,one emergency download switch and one USB switch; 4 buttons including RESET (reserved), PWRKEY, VOL_UP and VOL_DOWN; 3 LEDs are available for signal indication Size: 26.5cm × 19.0cm Smart_EVB_G2_User_Guide 11 / 59 2.2. Interface Overviews Smart LTE Module Series Smart EVB G2 User Guide J1202 J1301 J1302 RS-232 Transceivers J0804 J0802 J0902 Speaker Vibrator Level Shifter Earphone BAT0201 J0101 J0102 D0301 J0402 Main LCM D0302 J0401 J0803 Sub LCM J0801 Sensors MEM ECM U0302 MICs U0301 U0304 LEDs S0501 S0601 J0202 J1001 J1002 S0502 S0503 S0505 S0504 J0201 S0201 S0202 J0601 J0602 J1101 Figure 1: Smart EVB G2 Interface Overview (Top) Smart_EVB_G2_User_Guide 12 / 59 Smart LTE Module Series Smart EVB G2 User Guide SPEAKER EARPHONE BATTERY PACK Figure 2: Smart EVB G2 Interface Overview (Bottom) Table 2: Interfaces of Smart EVB G2 Interface VBAT Power Supply Switches PWRKEY RESET USB_BOOT Reference Number Description J0201 The power jack on the EVB. Typical power supply: +5.0V J0202 Li-polymer battery connector S0201 Used to select DC power supply or battery power supply S0202 S0502 S0503 Used to power on/off the module Power key (push button) Used to turn on/off the module Reserved S0501 Emergency download switch Smart_EVB_G2_User_Guide 13 / 59 VOL_UP VOL_DOWN USB S0505 S0504 J0601 J0602 Speaker Audio (U)SIM UART SD LEDs TE-A Cameras Flashlights LCM and TP Earphone MIC (MEMS) MIC (ECM) J1202 J1001 J1002 J1301 J1302 J1101 D0501 D0502 D0503* J0101, J0102 J0401 J0402 D0301 D0302 J0803 J0804 J0801 Smart LTE Module Series Smart EVB G2 User Guide Used to turn the volume up Used to turn the volume down Micro USB connector USB type-C connector Used for loudspeaker Rated resistance: 8Ω Rated power: 1.5W Used for earphone Rated resistance: 32Ω Rated power: 30mW Used for MEMS-type microphone Used for ECM-type microphone Audio Jack for headset (U)SIM1 card connector (U)SIM2 card connector Main UART port Debug UART port SD card connector D0501 indicates the power supply of the module D0502 indicates the charge status of the module D0503* indicates the operation status of the module Connectors for connecting Smart TE-A and Smart EVB G2 Rear camera connector, support 16M CMOS sensor Front camera connector, support 8M CMOS sensor Flashlight LED1 for testing module’s flashlight interfaces Flashlight LED2 for testing module’s flashlight interfaces Connector for main LCM ZIF connector for main touch panel Connector for secondary LCM Smart_EVB_G2_User_Guide 14 / 59 Sensors Coin Cell MIPI+SPI/I2S J0802 U0301 U0302 U0304 BAT0201 J0902 NOTE '*' means under development. Smart LTE Module Series Smart EVB G2 User Guide ZIF connector for secondary touch panel Accelerometer and gyroscope sensor Compass sensor Ambient light sensor and proximity sensor Coin cell battery for RTC power supply Reserved 2.3. Top and Bottom Views of Smart EVB G2 Figure 3: Smart EVB G2 Top View Smart_EVB_G2_User_Guide 15 / 59 Smart LTE Module Series Smart EVB G2 User Guide Figure 4: Smart EVB G2 Bottom View 2.4. Smart EVB G2 Kit Accessories All accessories of the Smart EVB G2 kit are listed as below. Please contact the supplier if there is something missing. Smart_EVB_G2_User_Guide 16 / 59 USB to RS232 converter cable Smart LTE Module Series Smart EVB G2 User Guide Li-polymer battery USB flash drive Earphone USB Type-C cable RF cables 5V DC adapter Bolts and coupling nuts GNSS antenna Wi-Fi/BT antenna Main antennas Figure 5: Smart EVB G2 Kit Accessories Table 3: Accessories List Items Cables Antennas Audio Description USB to RS232 converter cable USB Type-C cable RF cables Main antennas Wi-Fi/BT antenna GNSS antenna (passive) Earphone Quantity 1 1 4 2 1 1 1 Smart_EVB_G2_User_Guide 17 / 59 Smart LTE Module Series Smart EVB G2 User Guide USB Flash Drive Battery Adapter Others Including USB 2.0 to RS232 driver, USB driver, etc. Li-polymer battery 5.0V DC power supply Bolts and coupling nuts for fixing Smart EVB G2 1 1 1 4 for each NOTE The main antenna can also be used for diversity reception. Smart_EVB_G2_User_Guide 18 / 59 Smart LTE Module Series Smart EVB G2 User Guide 3 Smart EVB G2 Kit Accessories Assembly Figure 6: Smart EVB G2 Kit Accessories Assembly Smart_EVB_G2_User_Guide 19 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4 Interface Applications This chapter describes the hardware interfaces of Smart EVB G2, shown as follows:  Power supply interfaces  Smart TE-A interface  LCM interfaces  Touch panel interfaces  Camera interfaces  USB interface  Audio interfaces  (U)SIM interfaces  UART interfaces  SD card interface  Emergency download interface It also provides information about flashlights, sensors, vibrator, buttons, status indication LEDs and test points to help customers use the Smart EVB G2. 4.1. Power Supply Interfaces (J0201/J0202) The Smart EVB G2 can be powered by an external 5.0V DC power adapter. Connect the DC power adapter to the power jack (J0201) and then the step-down converter (DC-to-DC converter), which is used to regulate the 5.0V DC power supply voltage to 4.2V for powering up the module. The Smart EVB G2 can also be powered by a Li-polymer battery through the battery connector J0202 on the board. The following figure shows the simplified power supply block diagram of Smart EVB G2. Smart_EVB_G2_User_Guide 20 / 59 Smart LTE Module Series Smart EVB G2 User Guide U0201 5V DC J0201 DC-to-DC Converter 4.2V S0201 DC Power Jack Power switch Li-polymer Battery J0202 S0202 Power ON/OFF Power supply for Smart modules Figure 7: Simplified Power Supply Block Diagram of Smart EVB G2 4.1.1. Adapter Interface The following figure shows the DC power jack of the Smart EVB G2. Figure 8: 5V DC Power Jack Before connecting the power supply, customers have to select a proper +5V DC power adapter to supply power for the Smart EVB G2, and the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 9: Power Plug Design Smart_EVB_G2_User_Guide 21 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.1.2. Battery Interface The following figure shows a reference circuit design for battery interface. Figure 10: Reference Design for Battery Interface The following figure shows the pin assignment of battery interface, and the following table shows the pin definition of battery connector. 6 5 4 3 2 1 Figure 11: Pin Assignment of Battery Interface Table 4: Pin Definition of Battery Interface Pin No. Pin Name 1, 2 GND 3 THERM 4 ID Description Ground pins. Connected to the negative pole of the battery. Used for battery temperature detection. A 47K thermistor is used for the battery protection circuit. Reserved Smart_EVB_G2_User_Guide 22 / 59 5, 6 VBAT Smart LTE Module Series Smart EVB G2 User Guide Power input pins. Connect to the positive pole of the battery. Figure 12: Battery Assembly 4.1.3. Switches for Power Supply The switches for power supply are shown in following figure. S0201 is used to switch between DC power supply and battery power supply. S0202 is used to switch on/off the power supply. BATTERY ON DC POWER OFF Figure 13: Power Supply Switches Smart_EVB_G2_User_Guide 23 / 59 Smart LTE Module Series Smart EVB G2 User Guide Table 5: Description of Power Supply Switches Switch No. S0201 S0202 Description Used to select DC power supply or battery power supply Used to switch on/off the power supply 4.2. Smart TE-A Interface The Smart TE-A interface supports SC60 module, and includes two B2B connectors named J0101 and J0102, respectively. Smart TE-A is connected to the EVB via the two connectors. With Smart modules, customers can easily design wireless communication products. The following two figures show the two B2B connectors and the sketch map of the Smart TE-A. 2 1 2 1 140 139 J0101 140 139 J0102 Figure 14: B2B Connectors Smart_EVB_G2_User_Guide 24 / 59 Smart LTE Module Series Smart EVB G2 User Guide Figure 15: Sketch Map of Smart TE-A (Top View) The following table describes the pin definition of the two B2B connectors J0101 and J0102. Table 6: Pin Definition of B2B Connectors Pin No. of J0101 Pin Name of J0101 1, 11, 37, 71, 83, 90, 94, 101, 103, 104, 109~111, 116, 122, 127~129, 134, 139, 140 GND 2 LCD_RST1 3 UART1_CTS 4 GPIO5 5 UART1_RXD 6 INT_CC 7 UART1_RTS 8 TP2_HDMI_RST Pin No. of J0102 Pin Name of J0102 1 USIM1_VDD 2, 8, 14, 20, 21, 23, 26, 29, 32, 35, 41, 47, 53, 59, 65, 73, 79, 85, 90, 91, 94, 97, 98, 102, 103, 109, 114, 115, 120, 121, 126, 132, 139 GND 3 USIM1_DET 4 DSI1_LN3_P 5 USIM1_RST 6 DSI1_LN3_N 7 USIM1_CLK 9 USIM1_DATA Smart_EVB_G2_User_Guide 25 / 59 9 UART1_TXD 10 10, 16, 21, 23, 25~27, 29, 31~33, 35,39, 41~44, NC 11 46~48, 51, 55, 57, 62~67, 97, 118, 130 12, 14 VDD_3V3 12 13 UART2_CTS 13 15 UART2_RXD 15 17 UART2_RTS 16 18 GPIO_1 17 19 UART2_TXD 18 20 GPIO2 19 22 GPIO3 22 24 GPIO4 24 28 TP0101 25 30 TP0102 27 34 CC1 28 36 CC2 30 38, 105, 107 USB_VBUS 31 40, 56 SEL_SW 33 45 SD_LDO12 34 49 LDO2_1V1 36 50 I2S_MCLK/LCD_TE1 37 52 TP2_CC_HDMI_I2C_SDA 38 53 CS_PLUS 39 54 TP2_CC_HDMI_I2C_SCL 40 Smart_EVB_G2_User_Guide Smart LTE Module Series Smart EVB G2 User Guide DSI1_LN2_N USIM2_VDD DSI1_LN2_P USIM2_DET USIM2_RST DSI1_LN1_N USIM2_CLK DSI1_LN1_P USIM2_DATA DSI1_LN0_N DSI1_LN0_P NC NC DSI1_CLK_N DSI1_CLK_P NC NC TP_RST TP_INT DSI0_LN3_P TP_I2C_SCL( TP2_C C_HDMI_I2C_SCL) DSI0_LN3_N TP_I2C_SDA( TP2_ CC_HDMI_I2C_SDA) 26 / 59 55 CS_MINUS 42 58 CHG_LED 43 59 PMU_MPP2 44 60 GRENN_LED 45 61 DSI_PWM 46 68 TP2_HDMI_INT 48 69 FORCE_USB_BOOT 49 70 GPIO_8 50 72 CAM_1V2_EN 51 73 HAP_P 52 74 SENSOR_I2C_SCL 54 75 HAP_N 55 76 SENSOR_I2C_SDA 56 77 LCD_BL_A 57 78 GYROSCOPIC_INT 58 79 LCD_BL_K1 60 80 FSYNC 61 81 LCD_BL_K2 62 82 ALPS_INT 63 84 GPIO_7 67 85 LDO23_1V2 68 86 LCD_BL_K3 69 87 LDO5_1V8 70 88 LCD_BL_K4 71 89 LDO6_1V8 72 Smart_EVB_G2_User_Guide Smart LTE Module Series Smart EVB G2 User Guide LCD_TE DSI0_LN2_P LCD_RST DSI0_LN2_N GPIO_16 I2S_MCLK DSI0_LN1_P CTP_EN DSI0_LN1_N SPI_CLK_I2S_CLK SPI_MISO_I2S_D1 DSI0_LN0_P SPI_MOSI_I2S_D0 DSI0_LN0_N SPI_CS_I2S_WS GPIO1_EXT DSI0_CLK_P GPIO2_EXT DSI0_CLK_N PWRKEY EN_AVDD_CAM RESET_N NC PMI_MPP1 NC 27 / 59 91 LDO10_2V8 74 92 FM_ANT 75 93 LDO22_2V8 76 95 LDO17_2V85 77 96 HPH_R 78 98 HPH_REF 80 99 VRTC 81 100 HPH_L 82 102 HS_DET 83 106 SPK_P 84 108 SPK_N 86 112 EAR_P 87 113, 115, 117, 119, VBAT 88 121, 123, 125 114 EAR_N 89 120 MIC_BIAS1 92 124 MIC_GND 93 126 MIC3_P 95 131 BATT_MINUS 96 132 MIC2_P 99 133 BATT_PLUS 100 135 VBAT_SNS 101 136 MIC1_N 104 137 BAT_THERM 105 138 MIC1_P 106 107 Smart_EVB_G2_User_Guide Smart LTE Module Series Smart EVB G2 User Guide NC CSI1_LN1_P NC CSI1_LN1_N SCAM_PWDN SCAM_RST CSI1_LN0_P CAM_I2C_SDA CSI1_LN0_N CAM_I2C_SCL MCAM_PWDN CSI1_CLK_P MCAM_RST CSI1_CLK_N NC CSI0_LN3_P CSI0_LN3_N SCAM_MCLK CSI0_LN2_P MCAM_MCLK CSI0_LN2_N FLASH_LED1 CSI0_LN1_P FLASH_LED2 CSI0_LN1_N 28 / 59 Smart_EVB_G2_User_Guide Smart LTE Module Series Smart EVB G2 User Guide 108 110 111 112 113 116 117 118 119 122 123 124 125 127 128 129 130 131 133 135 136 137 138 64, 66, 134, 140 USB_ID GPIO_6 CSI0_LN0_P USB_OTG_PWR_EN CSI0_LN0_N DM CSI0_CLK_P DP CSI0_CLK_N TX_M SD_LDO11 TX_P SD_CMD SD_DET RX_M SD_CLK RX_P SD_DATA0 SD_DATA1 SD_DATA2 KEY_VOL_DOWN SD_DATA3 KEY_VOL_UP NC 29 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.3. LCM Interfaces 4.3.1. Main LCM Interface The Smart EVB G2 provides two LCM interfaces and can be equipped with two LCD modules for dual display function. Currently the Smart EVB G2 provides two 5-inch 1280 × 720 HD resolution liquid crystal displays for customers to test. The following figure shows a reference circuit design for main LCM interface of the Smart EVB G2. LCD0_TE LCD0_ RST PMI_ MPP1 DSI0_LN3_P DSI0_LN3_N DSI0_LN2_P DSI0_LN2_N DSI0_LN1_P DSI0_LN1_N DSI0_LN0_P DSI0_LN0_N DSI0_ CLK_P DSI0_ CLK_N Module LCD_BL_A LCD_BL_K1 LCD_BL_K2 LDO17_2V85 LDO 6_1V8 C1 C2 C3 4.7uF 100nF 1uF FL1 1 3 6 5 2 4 1 3 FL2 6 5 2 4 1 3 FL3 6 5 2 4 FL4 1 3 6 5 2 4 FL5 1 3 6 5 2 4 EMI filter J0803 1 LEDA 2 NC 3 LEDK 4 NC 5 LPTE 6 RESET 7 LCD_ID 8 NC (SDA-TP) 9 NC (SCL-TP) 10 NC (RST-TP) 11 NC (EINT-TP) 12 GND 13 VIO18 14 VCC28 15 NC (VTP-TP) 16 GND 17 MIPI_TDP3 18 MIPI_ TDN3 19 GND 20 MIPI_ TDP2 21 MIPI_ TDN2 22 GND 23 MIPI_ TDP1 24 MIPI_ TDN1 25 GND 26 MIPI_ TDP0 27 MIPI_ TDN0 28 GND 29 MIPI_ TCP 30 MIPI_ TCN 31 GND 32 GND 33 GND 34 GND LCM Figure 16: Reference Design for Main LCM Interface NOTE The white LEDs (WLED) of main LCM interface are driven by the module. LCD_BL_A is the high voltage source for powering a string of WLEDs. LCD_BL_K1 and LCD_BL_K2 are the two output drivers for sinking the current from WLED strings. Smart_EVB_G2_User_Guide 30 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.3.2. Secondary LCM Interface The following figure shows a reference circuit design for secondary LCM interface of the Smart EVB G2. LCD1_TE LCD1_RST PMU_MPP2 DSI1_LN3_P DSI1_LN3_N DSI1_LN2_P DSI1_LN2_N DSI1_LN1_P DSI1_LN1_N DSI1_LN0_P DSI1_LN0_N DSI1_CLK_P DSI1_CLK_N Module LCM1_LED+ LCM1_LED- 1 2 1 2 1 2 1 2 1 2 5 5 5 5 5 LDO17_2V 85 LDO6_1V8 6 6 6 6 6 FL1 3 4 3 FL2 4 3 FL3 4 FL4 3 4 FL5 3 4 EMI filter C1 C2 4.7 uF 100nF J0801 1 LEDA 2 NC 3 LEDK 4 NC 5 LPTE 6 RESET 7 LCD_ID 8 NC (SDA-TP) 9 NC (SCL-TP) C3 10 NC (RST-TP) 1 uF 11 NC (EINT-TP) 12 GND 13 VIO18 14 VCC28 15 NC (VTP-TP) 16 GND 17 MIPI_TDP3 18 MIPI_TDN3 19 GND 20 MIPI_TDP2 21 MIPI_TDN2 22 GND 23 MIPI_TDP1 24 MIPI_TDN1 25 GND 26 MIPI_TDP0 27 MIPI_TDN0 28 GND 29 MIPI_TCP 30 MIPI_TCN 31 GND 32 GND 33 GND 34 GND LCM Figure 17: Reference Design for Secondary LCM Interface The following figure shows the pin assignments of LCM interfaces. Smart_EVB_G2_User_Guide 31 / 59 Smart LTE Module Series Smart EVB G2 User Guide Figure 18: Pin Assignments of LCM Interfaces 4.3.3. Backlight Driver for Secondary LCM Interface The Smart EVB G2 uses a PWM dimming step-up LED driver for the WLED backlighting of secondary LCM interface. The following figure shows a reference circuit design for the backlight driver. Figure 19: Reference Design for Backlight Driver Smart_EVB_G2_User_Guide 32 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.4. Touch Panel Interfaces The Smart EVB G2 provides two touch panel interfaces: J0804 and J0802.  J0804 is used for the connection between touch panel interfaces of main LCM and EVB.  J0802 is used for the connection between touch panel interfaces of secondary LCM and EVB. The following figure shows a reference design for touch panel interfaces. LDO 6_1V8 LDO10_2V8 TP_I2C_ SDA TP_I2C_ SCL TP_ RST TP_ INT Module R1 2.2K R2 2.2K D1 D2 D3 D4 C1 C2 D5 4.7uF 100nF 1 TP_SDA 2 TP_SCL 3 TP_RST 4 TP_INT 5 GND 6 VDD TP Figure 20: Reference Design for Touch Panel Interfaces The following figure shows the pin assignments of touch panel interfaces, and the following table shows the pin definition of touch panel interfaces. J0804 6 1 J0802 6 1 Figure 21: Pin Assignments of Touch Panel Interfaces Smart_EVB_G2_User_Guide 33 / 59 Smart LTE Module Series Smart EVB G2 User Guide Table 7: Pin Definition of Touch Panel Interfaces Pin No. Pin Name 1 TP_SDA 2 TP_SCL 3 TP_RST 4 TP_INT 5 GND 6 VDD Description I2C data signal of touch panel I2C clock signal of touch panel Reset signal of touch panel Interrupt signal of touch panel Ground 2.8V power supply for touch panel VDD power Comment Active low 4.5. Camera Interfaces Smart EVB G2 provides two camera interfaces (4-lane+2-lane) with rear camera and front camera assembled.  The rear camera uses a 16M pixels digital CMOS sensor with auto-focusing function.  The front camera uses an 8M pixels CMOS sensor with auto-focusing function. The following figure shows a reference design for camera interfaces. Smart_EVB_G2_User_Guide 34 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.7uF 4.7uF 1uF 1uF Rear camera connector LDO17_2P85 LDO22_2P8 AF_VDD LDO2_1P1 MCAM_ RST MCAM_PWDN MCAM_MCLK CAM_I2C_ SDA CAM_I2C_ SCL CSI0_LN3_P CSI0_LN3_N CSI0_LN2_P CSI0_LN2_N CSI0_LN1_P CSI0_LN1_N CSI0_LN0_P CSI0_LN0_N CSI0_ CLK_P CSI0_ CLK_N SCAM_RST SCAM_PWDN SCAM_MCLK CSI2_LN3_P CSI2_LN3_N CSI2_LN2_P CSI2_LN2_N CSI2_LN1_P CSI2_LN1_N CSI2_LN0_P CSI2_LN0_N CSI2_ CLK_P CSI2_ CLK_N LDO 6_1P8 2.2K 2.2K EMI EMI EMI EMI EMI LDO23_1P2 4.7uF 1uF 1uF EMI EMI EMI EMI EMI AVDD DVDD DOVDD AVDD DOVDD DVDD Figure 22: Reference Design for Camera Interfaces The following figure shows the camera interfaces with cameras assembled. Front camera connector Smart_EVB_G2_User_Guide 35 / 59 Smart LTE Module Series Smart EVB G2 User Guide Front CAM Rear CAM Figure 23: Camera Interfaces with Cameras Assembled 4.6. USB Interfaces The Smart EVB G2 provides two USB interfaces: Micro USB interface and Type-C interface.  The Type-C interface complies with the USB 3.0/2.0 specifications and supports super speed (5Gbps) on USB 3.0, high speed (480 Mbps) on USB 2.0 and full speed (12 Mbps) modes.  The Micro USB interface complies with the USB 2.0 specifications and supports high speed (480 Mbps) on USB 2.0 and full speed (12 Mbps) modes.  Both USB interfaces support USB OTG function, and are used for AT command communication, data transmission, software debugging and firmware upgrade.  Switch S0601 is used to switch between the two interfaces. The following figure shows a reference circuit design for USB interfaces. Smart_EVB_G2_User_Guide 36 / 59 Smart LTE Module Series Smart EVB G2 User Guide Module V_BUS USB_DP USB_DM USB_SS_TX_P USB_SS_TX_M USB_SS_RX_P USB_SS_RX_M SLE_SW V2 SGM7227 VCC Switch R2 S D+ DGND HSD1+ HSD1- HSD2HSD2+ V1 P13DBS VDD C2 A0+ C3 A0- C4 A1+ C5 A1- SEL C1 4.7uF C14 R1 PD 100nF B0+ C6 B0- C7 B1+ C8 B1- C9 C0+ C10 C0- C11 C1+ C12 C1- 13 Micro USB V_BUS USB-DP USB_DM D- USB Type-C D+ V_BUS TX2+ TX2RX2+ RX2TX1+ TX1RX1+ RX1- Figure 24: Reference Design for USB Interfaces The following figure shows the USB interfaces and S0601 switch. MICRO USB TYPE C S0601 Figure 25: USB Interfaces and S0601 Switch Smart_EVB_G2_User_Guide 37 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.7. Audio Interfaces Smart EVB G2 provides three analog audio outputs including one mono loudspeaker, one mono earphone, and one stereo headset. The Smart EVB G2 also provides three analog audio inputs including two single-ended and one differential microphone inputs. One single-ended microphone input is used for headset interface. One single-ended and one differential microphone inputs are used for microphone interfaces. 4.7.1. Loudspeaker Interface Smart EVB G2 provides one loudspeaker interface and the loudspeaker is soldered onto the Smart EVB G2 via test point J1203. The following figure shows a reference circuit design for loudspeaker interface. Smart EVB G2 SPK_P SPK_N 1.0nF FB ESD Close to speaker FB 1.0nF J1203 ESD Figure 26: Reference Design for Loudspeaker Interface 4.7.2. Headset Interface The following figure shows a reference circuit design for headset interface. Smart_EVB_G2_User_Guide 38 / 59 Smart LTE Module Series Smart EVB G2 User Guide MIC_GND MIC2_P HPH_L HS_DET HPH_R HPH_REF Module R1 0R F1 R2 20K C3 C4 C5 33pF 33pF 33pF 1 5 F2 4 3 6 2 F3 F4 D1 D2 D3 D4 R3 0R ESD Figure 27: Reference Design for Headset Interface The following figure shows the pin assignment of headset interface. 2 1 3 6 5 4 Figure 28: Pin Assignment of Headset Interface The following table shows the pin definition of headset interface. Smart_EVB_G2_User_Guide 39 / 59 Smart LTE Module Series Smart EVB G2 User Guide Table 8: Pin Definition of Headset Interface Pin No. 1 2 3 4 5 6 Pin Name MIC GND R-AUDIO DETECT L-AUDIO GND Function Positive microphone input Dedicated GND for audio Headset right channel Headset detection Headset left channel Ground The following figure shows the sketch design of audio plug which suits for the audio jack on Smart EVB G2. HS_DET 5 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 29: Sketch of Audio Plug 4.7.3. Earphone Interface Smart EVB G2 provides one earphone interface and the earphone is soldered onto the Smart EVB G2 via test point J1204. The following figure shows a reference circuit design for earphone interface. Smart EVB G2 FB EAR_P EAR_N 33pF 100pF 33pF ESD Earphone ESD J1204 Figure 30: Reference Design for Earphone Interface Smart_EVB_G2_User_Guide 40 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.7.4. Microphone Interfaces Smart EVB G2 provides one single-ended and one differential microphone inputs for microphone interfaces. The single-ended microphone input is for MEMS-Type microphone and the differential microphone input is for ECM-Type microphone. The following figures show a reference circuit design for microphone interfaces and the two microphones. Figure 31: Reference Design for Microphone Interfaces MEMS-Type ECM-Type Figure 32: MEMS-Type and ECM-Type Microphones Smart_EVB_G2_User_Guide 41 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.8. (U)SIM Interfaces The Smart EVB G2 provides two 6-pin push-push type (U)SIM card (3V or 1.8V) connectors J1001 ( (U)SIM1 card connector) and J1002 ((U)SIM2 card connector). The following figure shows the simplified interface schematic for J1001. LD05_1P8 R1 100K USIM_ VDD USIM_ RST R3 Module USIM_CLK R4 USIM_ DET USIM_ DATA R5 USIM_ VDD R2 10K 22R 22R 22R C2 C3 C4 22pF 22pF 22pF C1 (U)SIM Card Connector 100nF C1 VCC GND C5 C2 RST C3 CLK CD2 GND VPP C6 IO C7 GND CD1 D1 ESD Figure 33: Simplified Interface Schematic for (U)SIM Card Connector J1001 The following figure shows the pin assignment of (U)SIM1 card connector (J1001). CD1 CD2 C7 C3 C6 C2C5 C1 (U)SIM1 Card Connector C7 C6 C5 C3 C2 C1 (U)SIM2 Card Connector Figure 34: Pin Assignment of (U)SIM1 Card Connector Smart_EVB_G2_User_Guide 42 / 59 Table 9: Pin Definition of (U)SIM1 Card Connector No. C1 C2 C3 C5 C6 C7 CD1 CD2 Pin Name USIM_VDD USIM_RST USIM_CLK GND VPP USIM_DATA USIM_GND USIM_PRESENCE I/O O O O I/O GND I Smart LTE Module Series Smart EVB G2 User Guide Function (U)SIM1 card power supply (U)SIM1 card reset signal (U)SIM1 card clock signal Ground Not connected (U)SIM1 card clock signal; Bi-directional (U)SIM1 card detection (U)SIM1 card detection NOTE The schematic and pin assignment of J1002 are the same as J1001’s. 4.9. UART Interfaces Smart EVB G2 provides two UART interfaces: main UART port J1301 and debug UART port J1302. The main UART interface can be used for data transmission and AT command communication. And the debug UART interface is used for debugging. The following figure shows the block diagram of UART on Smart EVB G2. Smart_EVB_G2_User_Guide 43 / 59 Smart LTE Module Series Smart EVB G2 User Guide UART_TXD UART_RTS UART_RXD UART_CTS GND Module 1.8V OE VCCA TXD_1.8V RTS_1.8V VCCB TXD_3.3V RTS_3.3V 3.3V RXD_1.8V CTS_1.8V RXD_3.3V CTS_3.3V GND 3.3V TXS0104 EPWR VCC DIN 1 DIN 2 DIN 3 DIN 4 DIN 5 R1OUTB ROUT 1 ROUT 2 ROUT 3 GND DOUT1 DOUT2 DOUT3 DOUT4 DOUT5 RIN1 RIN2 RIN3 FORCEON /FORCEOFF /INVALID SN65C 3238 Figure 35: RS232 Level Match Circuit The following figure shows the pin assignment of main UART port (J1301). GND RXD CTS TXD RTS DB-9 5 32 8 7 Figure 36: Pin Assignment of Main UART Port Table 10: Pin Definition of Main UART Port J1401 Pin Name I/O 2 RS232_TXD O 3 RS232_RXD I 5 RS232_GND Description Transmit data Receive data Ground Smart_EVB_G2_User_Guide 44 / 59 Smart LTE Module Series Smart EVB G2 User Guide 7 RS232_CTS I Clear to send 8 RS232_RTS O Request to send NOTE The schematic and pin assignment of J1302 are the same as J1301’s. 4.10. SD Card Interface Smart EVB G2 provides an SD card interface J1101 for customers to test the module’s SD card interface. The following figure shows the simplified interface schematic for SD card interface on Smart EVB G2. SD_DATA2 SD_DATA3 SD_CMD SD_CLK SD_DATA0 SD_DATA1 SD_DET Module LDO5_1P8 SD_LDO12 SD_LDO11 R7 R8 R9 R10 R11 R12 R13 R1 120K 33R 33R 33R 33R 33R 33R 1K R2 R3 R4 R5 R6 NM_51K NM_51K NM_10K NM_51K NM_51K D1 D2 D3 D4 D5 D6 D7 C1 C2 D8 4.7uF 33pF 1 P1-DAT2 2 P2-CD/DAT3 3 P3-CMD 4 P4-VDD 5 P5-CLK 6 P6-VSS 7 P7-DAT0 8 P8-DAT1 9 DETECTIVE 10 GND 11 GND 12 GND 13 GND SD Card Connector Figure 37: Simplified Interface Schematic for SD Card Interface Smart_EVB_G2_User_Guide 45 / 59 Smart LTE Module Series Smart EVB G2 User Guide 9 8 76 54 321 Figure 38: Pin Assignment of SD Card Interface 4.11. Flashlights Smart EVB G2 provides two flashlight LEDs D0301 and D0302 for testing the module’s flashlight interfaces which support flash mode and torch mode. The following figures show a reference circuit design for flashlights and their locations on Smart EVB G2. Figure 39: Reference Circuit Design for Flashlight Interfaces Smart_EVB_G2_User_Guide 46 / 59 D0301 Smart LTE Module Series Smart EVB G2 User Guide D0302 Figure 40: Flashlights 4.12. Sensors Smart EVB G2 provides three sensors for testing purpose, as shown in the figure below. Acce & Gyros Compass ALS/PS Figure 41: Sensors Smart_EVB_G2_User_Guide 47 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.13. Emergency Download Interface Smart EVB G2 provides one emergency download switch USB_BOOT to force the module enter into download mode. Pull up USB_BOOT pin to 1.8V before powering on the module when the function is used. The following figures show a reference circuit design for the emergency download interface and its switch. S1 USB_BOOT Module LDO5_1P8 R1 10K Figure 42: Reference Design for Emergency Download Interface Figure 43: Emergency Download Switch Smart_EVB_G2_User_Guide 48 / 59 Smart LTE Module Series Smart EVB G2 User Guide 4.14. Vibrator Smart EVB G2 provides an ERM-type vibrator for customers to test the motor driver interface of Smart modules. The following figures show a reference circuit design and the vibrator on the board. HAP_P HAP_N Module C1 33pF C2 33pF VIB+ VIB- Motor Figure 44: Reference Design for Vibrator VIB+ ERM-Type VIB- Figure 45: ERM-Type Vibrator 4.15. Buttons Smart EVB G2 provides four buttons (S0502, S0503, S0505 and S0504) including RESET (reserved), PWRKEY, VOL_UP and VOL_DOWN, which are shown in the following figure. Smart_EVB_G2_User_Guide 49 / 59 Smart LTE Module Series Smart EVB G2 User Guide Figure 46: Buttons Table 11: Description of Buttons Reference No. Items S0502 PWRKEY S0503 S0505 S0504 RESET VOL_UP VOL_DOWN Description Power key (push button) Used to turn on/off the module Reserved Used to turn the volume up Used to turn the volume down 4.16. Status Indication LEDs There are several status indication lights (D0501, D0502 and D0503*) for signal indication on Smart EVB G2, shown as below. Smart_EVB_G2_User_Guide 50 / 59 Smart LTE Module Series Smart EVB G2 User Guide POWER STATUS CHARGE Figure 47: Status Indication LEDs Table 12: Description of Status Indication LEDs Reference No. Items D0501 POWER D0502 STATUS* D0503 CHARGE Description Indicate the power supply status of Smart modules Bright: VBAT ON Extinct: VBAT OFF Indicate the operation status of Smart modules Indicate the charge status of Smart modules Bright: module is charging Extinct: module charge is stopped NOTE '*' means under development. Smart_EVB_G2_User_Guide 51 / 59 Smart LTE Module Series Smart EVB G2 User Guide 5 Operation Procedures Illustration This chapter introduces how to use the Smart EVB G2 for testing and evaluating Quectel Smart modules. 5.1. Power ON Smart Modules The following are the procedures for powering on the smart modules. 1. Connect the Smart TE-A to the connectors (J0101 and J0102) on Smart EVB G2. 2. If battery power supply mode is selected, install a Li-polymer battery on J0202 and then switch S0201 to BATTERY state. If 5.0V DC power supply mode is selected, switch S0201 to DC POWER state. 3. Switch S0202 to ON state, and then D0501 will be lighted. 4. Press D0501 (PWRKEY) for at least 2s to turn on the module. When the following interface is displayed on the utilized LCD(s), it means the booting has been completed. Figure 48: LCD Display Indicating Module’s Power-on Smart_EVB_G2_User_Guide 52 / 59 Smart LTE Module Series Smart EVB G2 User Guide NOTE Inserting USB into USB interface after power supply is provided can also turn on the module. 5.2. Communication Via USB or UART Interface 5.2.1. Communication via USB Interface 1. Power on the module according to the procedures mentioned in Chapter 5.1. 2. Connect Smart EVB G2 and the PC with USB cable through USB interface and then run the USB flash drive on PC to install the USB driver and ADB driver. The USB port numbers can be viewed through the PC’s Device Manager, shown as below. Figure 49: USB COM Ports 3. Open CMD tool: 'START'  'All Programs'  'Accessory'  'Command Prompt'. 4. Use the 'adb shell' command to make the module enter into ADB mode. Then customers can use USB ADB interface for test. Smart_EVB_G2_User_Guide 53 / 59 Smart LTE Module Series Smart EVB G2 User Guide Figure 50: 'adb shell' Command NOTES 1. If customers want to use HyperTerminal for testing, then Qualcomm HS-USB Modem 9091 can be used. 2. Please note that the USB port numbers may be different among different modules. 5.2.2. Communication via UART Interface 1. Run the driver disk on PC to install the USB-to-RS232 driver. 2. Connect the UART interface (main UART or debug UART) to the PC with USB-to-RS232 converter cable and then power on the module according to the procedures mentioned in Chapter 5.1. After that, the USB serial port number can be viewed through the PC Device Manager, shown as the following figure. Figure 51: USB Serial Port Smart_EVB_G2_User_Guide 54 / 59 Smart LTE Module Series Smart EVB G2 User Guide 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the smart module and the PC. The following figure shows the QCOM configuration: select correct 'COM port' (USB Serial Port) and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [5]. Figure 52: QCOM Configuration When Connecting USB Serial Port 5.3. Firmware Upgrade Quectel Smart modules upgrade firmware via USB port by default. Please follow the procedures below to upgrade firmware. 1. Install and open the firmware upgrade tool QFIL on PC and then power on the smart module according to the procedures mentioned in Chapter 5.1. 2. Click the 'SelectPort' and select the USB port 'Qualcomm HS-USB Diagnostics Modem 9091 (COM24)'. 3. Select 'Flat Build' in 'Select Build Type' option. 4. Click 'Browse' to select the firmware which needs to be upgraded in 'Select Programmer' option. 5. Click 'Load XML' to select the XML which needs to be upgraded in 'Select Build' option. 6. Click 'Download' to upgrade the firmware. Smart_EVB_G2_User_Guide 55 / 59 Smart LTE Module Series Smart EVB G2 User Guide 1 2 3 4 5 6 Figure 53: Firmware Upgrade Steps 5.4. Power OFF Smart Modules There are two methods to power off the module.  The steps for the first method are as follows: 1. Press D0501 (PWRKEY) for at least 1s under the power-on state of the module, and then LCD will display a menu for selection shown as the following figure: Smart_EVB_G2_User_Guide 56 / 59 Smart LTE Module Series Smart EVB G2 User Guide Figure 54: LCD Menu Display for Powering off Module 2. Choose 'Power off' option. 3. The module will be powered off normally.  The other method is to press down PWRKEY for at least 8s until the module is shut down completely. Smart_EVB_G2_User_Guide 57 / 59 Smart LTE Module Series Smart EVB G2 User Guide 6 Appendix A References Table 13: Related Documents SN Document name [1] Quectel_SC60_R1.0&R2.0_Hardware_Design [2] Quectel_SC60_R1.0&R2.0_Reference_Design [3] Quectel_SC60_R1.1&R2.1_Hardware_Design [4] Quectel_SC60_R1.1&R2.1_Reference_Design [5] Quectel_QCOM_User_Guide Remark SC60 R1.0&R2.0 hardware design SC60 R1.0&R2.0 reference design SC60 R1.1&R2.1 hardware design SC60 R1.1&R2.1 reference design User guide for QCOM tool Table 14: Terms and Abbreviations Abbreviation ALS CMOS ECM Smart EVB G2 LCM LED MEMS MIPI OTG PC PS Description Ambient Light Sensor Complementary Metal Oxide Semiconductor Electret Microphone Smart Evaluation Board 2nd Generation LCD Module Light Emitting Diode Micro-Electro-Mechanical System Mobile Industry Processor Interface On-The-Go Personal Computer Proximity Sensor Smart_EVB_G2_User_Guide 58 / 59 PWM UART USB (U)SIM WLED ZIF Smart LTE Module Series Smart EVB G2 User Guide Pulse Width Modulation Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module White LED Zero Insert Force Smart_EVB_G2_User_Guide 59 / 59

Smart EVB User Guide Smart LTE Module Series Rev. Smart_EVB_User_Guide_V1.1 Date: 2018-10-23 Status: Released www.quectel.com Smart LTE Module Series Smart EVB User Guide 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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 Smart_ EVB_User_Guide 1 / 45 Smart LTE Module Series Smart EVB User Guide About the Document History Revision 1.0 1.1 Date 2016-09-30 2018-10-23 Author Description Vae LIU Jerry WANG Initial 1. Added a comment for the power supply of Smart EVB in Table 1. 2. Updated the top view of Smart EVB in Figure 1. 3. Added a comment for RESET in Chapter 2.2. 4. Added the description of a separate battery interface in Chapter 3.1. 5. Added the descriptions of touch panel interface, LCM interface, camera interfaces and SD card interface in Chapter 3.2~3.5. 6. Added the description of flashlight, vibrator and sensors in Chapter 3.13~3.15. Smart_ EVB_User_Guide 2 / 45 Smart LTE Module Series Smart EVB User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 1.1. Safety Information ................................................................................................................... 8 2 General Overview................................................................................................................................. 9 2.1. Key Features ........................................................................................................................... 9 2.2. Interface Overview................................................................................................................. 11 2.3. Top and Bottom Views of Smart EVB.................................................................................... 13 2.4. Smart EVB Kit Accessories ................................................................................................... 14 3 Interface Application ......................................................................................................................... 16 3.1. Power Supply Interfaces (S801/S803) .................................................................................. 16 3.2. Touch Panel Interface (J403) ................................................................................................ 17 3.3. LCM Interface (J402)............................................................................................................. 18 3.4. Camera Interfaces (J301/J302)............................................................................................. 20 3.5. SD Card Interface (J502) ...................................................................................................... 22 3.6. USB Interface (J602) ............................................................................................................. 23 3.7. Audio Interfaces (J702) ......................................................................................................... 25 3.7.1. Loudspeaker Interface ................................................................................................... 25 3.7.2. Headphone Interface...................................................................................................... 26 3.7.3. Microphone and Earphone Interfaces............................................................................ 27 3.8. (U)SIM Interfaces (J503/J504) .............................................................................................. 28 3.9. UART Interfaces (J901/J604)................................................................................................ 30 3.10. Switches and Buttons ............................................................................................................ 31 3.11. Status Indication LEDs .......................................................................................................... 33 3.12. Test Points ............................................................................................................................. 34 3.13. Flashlight ............................................................................................................................... 35 3.14. Vibrator .................................................................................................................................. 36 3.15. Sensors.................................................................................................................................. 37 4 Operation Procedures Illustration.................................................................................................... 38 4.1. Power on SC20 Module ........................................................................................................ 38 4.2. Power off SC20 Module ........................................................................................................ 39 4.3. Communication via USB or UART Interface ......................................................................... 39 4.3.1. Communication via USB Interface ................................................................................. 39 4.3.2. Communication via UART Interface............................................................................... 41 4.4. Firmware Upgrade................................................................................................................. 42 5 EVB Accessories Assembly ............................................................................................................. 44 Smart_ EVB_User_Guide 3 / 45 Smart LTE Module Series Smart EVB User Guide 6 Appendix A Reference....................................................................................................................... 45 Smart_ EVB_User_Guide 4 / 45 Smart LTE Module Series Smart EVB User Guide Table Index TABLE 1: KEY FEATURES OF SMART EVB...................................................................................................... 9 TABLE 2: INTERFACES OF SMART EVB .........................................................................................................11 TABLE 3: ACCESSORIES LIST ........................................................................................................................ 15 TABLE 4: PIN ASSIGNMENT OF TOUCH PANEL INTERFACE ...................................................................... 18 TABLE 5: PIN ASSIGNMENT OF MICRO USB INTERFACE ........................................................................... 25 TABLE 6: PIN ASSIGNMENT OF HEADPHONE INTERFACE......................................................................... 27 TABLE 7: PIN ASSIGNMENT OF (U)SIM1 INTERFACE (J503) ....................................................................... 29 TABLE 8: PIN ASSIGNMENT OF DEBUG UART PORT .................................................................................. 31 TABLE 9: DESCRIPTION OF SWITCHES AND BUTTONS ............................................................................. 32 TABLE 10: DESCRIPTION OF STATUS INDICATION LEDS ........................................................................... 33 TABLE 11: DETAILS OF TEST POINTS ........................................................................................................... 35 TABLE 12: RELATED DOCUMENTS ................................................................................................................ 45 TABLE 13: TERMS AND ABBREVIATIONS ...................................................................................................... 45 Smart_ EVB_User_Guide 5 / 45 Smart LTE Module Series Smart EVB User Guide Figure Index FIGURE 1: SMART EVB INTERFACE OVERVIEW...........................................................................................11 FIGURE 2: SMART EVB TOP VIEW ................................................................................................................. 13 FIGURE 3: SMART EVB BOTTOM VIEW ......................................................................................................... 14 FIGURE 4: SMART EVB KIT ACCESSORIES .................................................................................................. 14 FIGURE 5: SIMPLIFIED POWER SUPPLY SCHEMATIC OF SMART EVB..................................................... 16 FIGURE 6: POWER SUPPLY INTERFACES.................................................................................................... 17 FIGURE 7: REFERENCE DESIGN FOR TOUCH PANEL INTERFACE........................................................... 17 FIGURE 8: PIN ASSIGNMENT OF TOUCH PANEL INTERFACE .................................................................... 18 FIGURE 9: REFERENCE DESIGN FOR LCM INTERFACE ............................................................................ 19 FIGURE 10: PIN ASSIGNMENT OF LCM INTERFACE ................................................................................... 20 FIGURE 11: REFERENCE CIRCUIT DESIGN FOR CAMERA INTERFACES ................................................. 21 FIGURE 12: CAMERA INTERFACES WITH CAMERAS ASSEMBLED ........................................................... 22 FIGURE 13: SIMPLIFIED INTERFACE SCHEMATIC FOR SD CARD INTERFACE ....................................... 22 FIGURE 14: PIN ASSIGNMENT OF SD CARD INTERFACE........................................................................... 23 FIGURE 15: REFERENCE CIRCUIT DESIGN FOR USB INTERFACE ........................................................... 24 FIGURE 16: PIN ASSIGNMENT OF MICRO USB INTERFACE....................................................................... 24 FIGURE 17: REFERENCE CIRCUIT DESIGN FOR LOUDSPEAKER INTERFACE ....................................... 25 FIGURE 18: REFERENCE CIRCUIT DESIGN FOR HEADPHONE INTERFACE ........................................... 26 FIGURE 19: PIN ASSIGNMENT OF HEADPHONE INTERFACE .................................................................... 26 FIGURE 20: SKETCH OF AUDIO PLUG .......................................................................................................... 27 FIGURE 21: REFERENCE CIRCUIT DESIGN FOR MICROPHONE AND EARPHONE INTERFACES ......... 28 FIGURE 22: SIMPLIFIED INTERFACE SCHEMATIC FOR (U)SIM1 CARD CONNECTOR (J503)................. 28 FIGURE 23: PIN ASSIGNMENT OF (U)SIM1 CARD CONNECTOR (J503) .................................................... 29 FIGURE 24: BLOCK DIAGRAM OF DEBUG UART PORT (J604) ................................................................... 30 FIGURE 25: PIN ASSIGNMENT OF DEBUG UART PORT (J604)................................................................... 30 FIGURE 26: SWITCHES AND BUTTONS ........................................................................................................ 32 FIGURE 27: STATUS INDICATION LEDS ........................................................................................................ 33 FIGURE 28: PIN ASSIGNMENT OF J904......................................................................................................... 34 FIGURE 29: REFERENCE CIRCUIT DESIGN FOR FLASHLIGHT INTERFACE ............................................ 35 FIGURE 30: FLASHLIGHT ................................................................................................................................ 36 FIGURE 31: REFERENCE CIRCUIT DESIGN FOR VIBRATOR ..................................................................... 36 FIGURE 32: ERM-TYPE VIBRATOR ................................................................................................................ 37 FIGURE 33: SENSORS .................................................................................................................................... 37 FIGURE 34: LCD DISPLAY INDICATING MODULE’S POWER-ON ................................................................ 38 FIGURE 35: LCD MENU DISPLAY FOR POWERING OFF MODULE ............................................................ 39 FIGURE 36: USB COM PORTS........................................................................................................................ 40 FIGURE 37: QCOM CONFIGURATION WHEN COMMUNICATING VIA USB INTERFACE .......................... 40 FIGURE 38: USB SERIAL PORT ...................................................................................................................... 41 FIGURE 39: QCOM CONFIGURATION WHEN COMMUNICATING VIA UART INTERFACE........................ 42 FIGURE 40: FIRMWARE UPGRADE STEPS ................................................................................................... 43 FIGURE 41: SMART EVB AND ACCESSORIES ASSEMBLY .......................................................................... 44 Smart_ EVB_User_Guide 6 / 45 Smart LTE Module Series Smart EVB User Guide 1 Introduction This document describes the evaluation board (Smart EVB) for Quectel Smart module SC20. The smart evaluation board is an assistant tool to develop and test SC20. Smart_ EVB_User_Guide 7 / 45 Smart LTE Module Series Smart EVB User Guide 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating SC20 module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for the customers' failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If the device offers an Airplane Mode, then it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on boarding the aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signals and cellular network cannot be guaranteed to connect in all possible conditions (for example, with unpaid bills or with an invalid (U)SIM) card. When emergent help is needed in such conditions, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. The cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. Smart_ EVB_User_Guide 8 / 45 Smart LTE Module Series Smart EVB User Guide 2 General Overview Quectel supplies Smart EVB for designers to develop applications based on Quectel SC20 module. This EVB can test basic functionalities of the module. 2.1. Key Features The following table describes the key features of Smart EVB. Table 1: Key Features of Smart EVB Features Power Supply (U)SIM Interfaces Audio Interfaces Camera Interfaces LCM Interface Touch Panel Interface SD Card Interface UART Interfaces USB Interface Signal Indication Buttons Implementation ⚫ DC power supply: 4.75V~6.0V (typical: 5.0V) ⚫ VBAT: 3.5V~4.2V (typical: 3.8V) ⚫ Support (U)SIM card detection ⚫ Support USIM/SIM cards: 2.95V and 1.8V ⚫ Analog interfaces used for loudspeaker, microphone, earphone and headphone Support two cameras: ⚫ Main camera supports 8M pixels with 2-lane CSI interface ⚫ Sub camera supports 2M pixels with 1-lane CSI interface ⚫ One 5-inch 1080 × 720 HD resolution LCD ⚫ 4-lane MIPI DSI interface for LCD ⚫ One capacitive touch panel ⚫ Support 4-bit SD card with hot-plug detection Two UART interfaces: ⚫ Debug UART for debugging ⚫ Main UART is not used by default ⚫ Compliant with USB 2.0 specifications ⚫ Support high speed and OTG function ⚫ 4 LEDs are available for signal indication ⚫ 9 buttons Smart_ EVB_User_Guide 9 / 45 Smart LTE Module Series Smart EVB User Guide Switches Flashlight Vibrator Sensors Physical Characteristics ⚫ 4 switches ⚫ Support a flashlight LED ⚫ A vibrator for testing the motor drive interface of the module ⚫ Support three sensors including ALS/PS, G-sensor/Gyroscopic sensor and compass sensor ⚫ Size: 24cm × 18cm Smart_ EVB_User_Guide 10 / 45 Smart LTE Module Series Smart EVB User Guide 2.2. Interface Overview J702 J504 SIM2 TP703 TP704 Earphone J905 S802 J701 S804 TE-A J102 J604 Debug U204 ALS/PS U203 G-sensor&Gyroscopic J101 Sub CAM J403 TP_CON U205 Compass LCM TP701 TP702 Speaker Main CAM J703 J704 LED D806 D808 D805 D807 Keypads S906 S909 S903 S904 D202 U206 J904 J802 J801 S801 S803 U701 MIC S901 S908 S905 S902 S907 J807 J602 J502 TF_CARD J503 SIM1 J901 UART J402 J601 JTAG Figure 1: Smart EVB Interface Overview Table 2: Interfaces of Smart EVB Interface Reference No. S801 S802 Power Supply Switches S803 S804 Description Used to select DC-DC power supply or battery power supply Used to force the module to boot from USB port Turned off by default Used to power on/off the EVB Used to turn on/off battery charger Turned off by default Smart_ EVB_User_Guide 11 / 45 PWRKEY RESET 1) Micro USB Audio (U)SIM SD Card Camera LCM TP Sensors Flashlight Vibrator UART LEDs TE-A S901 J903 S908 J602 Speaker EAR MIC J702 J503 J504 J502 J302 J301 J402 J403 U205 U204 U203 D202 U206 J901 J604 D805, D806, D807, D808 J101, J102 Smart LTE Module Series Smart EVB User Guide Power key (push button) Used to turn on/off the module Used to connect PWRKEY to GND Reset push button Used to reset the module USB interface Used for loudspeaker Used for earphone Used for microphone Used for headphone (U)SIM1 card connector (U)SIM2 card connector SD card connector Main camera connector, support 8M CMOS sensor Sub camera connector, support 2M CMOS sensor Connector for LCM ZIF connector for touch panel Compass sensor Ambient light sensor and proximity sensor G-sensor & gyroscopic sensor Flashlight LED Vibrator for customers to test the motor driver interface Main UART port Debug UART port D807: network registration status indicator D806: power supply status indicator D808/D805: disabled by default Connectors for connecting Smart TE-A and Smart EVB Smart_ EVB_User_Guide 12 / 45 DC interface J807 Smart LTE Module Series Smart EVB User Guide Used to connect to DC power adapter NOTE 1) The 'RESET' button does not work, because the RESET interface on SC20 module is disabled by default. Through enabling the RESET interface via software configuration, the 'RESET' button can work properly. 2.3. Top and Bottom Views of Smart EVB Figure 2: Smart EVB Top View Smart_ EVB_User_Guide 13 / 45 Smart LTE Module Series Smart EVB User Guide Figure 3: Smart EVB Bottom View 2.4. Smart EVB Kit Accessories All accessories of the Smart EVB kit are listed as below. Please contact the supplier if there is something missing. USB Flash drive RF cables USB to UART converter cable Wi-Fi antenna Bolts and coupling nuts USB cable Main antennas GNSS antenna Headphone Figure 4: Smart EVB Kit Accessories Smart_ EVB_User_Guide 14 / 45 Smart LTE Module Series Smart EVB User Guide Table 3: Accessories List Items Cables Antennas Audio USB Flash Drive Others Description USB to UART converter cable USB cable RF cables Main antennas 1) Wi-Fi antenna GNSS antenna (active) Headphone USB2.0 to RS232 driver, USB driver, etc. Bolts and coupling nuts for fixing Smart EVB Quantity 1 1 4 2 1 1 1 1 4 for each NOTE 1) The main antenna can also be used for diversity reception. Smart_ EVB_User_Guide 15 / 45 Smart LTE Module Series Smart EVB User Guide 3 Interface Applications This chapter describes the hardware interfaces of Smart EVB, shown as follows: ⚫ Power supply interfaces ⚫ Touch panel interface ⚫ LCM interface ⚫ Camera interfaces ⚫ SD card interface ⚫ USB interface ⚫ Audio interfaces ⚫ (U)SIM interfaces ⚫ UART interfaces It also provides information about LEDs, buttons, test points, flashlight, vibrator and sensors to help customers use the Smart EVB. 3.1. Power Supply Interfaces (S801/S803) The Smart EVB can be powered by an external 5.0V DC power adapter. Connect the DC power adapter to the DC interface (J807) and then the step-down converter (DC-to-DC converter), which is used to provide the supply voltage required for operating the module. A separate battery interface (J801) is provided, in case there are no other power options available. The following figures show the simplified power supply block diagram and power supply interfaces of Smart EVB. J 807 DC interface U801 DC-to-DC Step-down converter J801 VBAT interface S801 Power switch S803 Power ON/OFF Power supply for Smart modules Figure 5: Simplified Power Supply Schematic of Smart EVB Smart_ EVB_User_Guide 16 / 45 J801 S801 S803 Smart LTE Module Series Smart EVB User Guide J807 DC 5V U801 Figure 6: Power Supply Interfaces 3.2. Touch Panel Interface (J403) Smart EVB provides a touch panel interface J403, which is used for the connection between touch panel of LCM and EVB. The following figure shows a reference design for touch panel interface. LDO6_1V8 VCTP2V8 TP_I2C_ SDA TP_I2C_ SCL TP_ RST TP_ INT R1 2.2K R2 2.2K Module D1 D2 D3 D4 C1 C2 4.7 uF 100nF 1 TP_SDA 2 TP_SCL 3 TP_RST 4 TP_INT 5 GND 6 VDD 7 8 TP Figure 7: Reference Design for Touch Panel Interface Smart_ EVB_User_Guide 17 / 45 Smart LTE Module Series Smart EVB User Guide 6543 21 6543 1 J403 Figure 8: Pin Assignment of Touch Panel Interface Table 4: Pin Assignment of Touch Panel Interface Pin No. 1 2 3 4 5 6 Pin Name TP_SDA TP_SCL TP_RST TP_INT GND VDD Description I2C data signal of touch panel I2C clock signal of touch panel Reset signal of touch panel Interrupt signal of touch panel Ground 2.8V power supply for touch panel VDD power 3.3. LCM Interface (J402) Currently the smart EVB provides a 5-inch 1080 x 720 high-definition resolution LCD display for customers to test. The following figure shows a reference circuit design for LCM interface of the Smart EVB. Smart_ EVB_User_Guide 18 / 45 Smart LTE Module Series Smart EVB User Guide LC D _ TE LCD _ RST D SI0_ LN3_P D SI0_ LN3_M D SI0_ LN2_P D SI0_ LN2_M D SI0_ LN1_P D SI0_ LN1_M D SI0_ LN0_P D SI0_ LN0_M DSI0_ CLK_P DSI0_ CLK_M Module LCM_LED+ LCM_ LED- LDO17_2V85 LDO6_1V8 C1 C2 C3 4.7uF 0.1 uF 1uF FL1 1 3 6 5 2 4 1 3 FL2 6 5 2 4 1 3 FL3 6 5 2 4 FL4 1 3 6 5 2 4 FL5 1 3 6 5 2 4 EMI filter J402 1 LEDA 2 NC 3 LEDK 4 NC 5 LPTE 6 RESET 7 LCD_ID 8 NC (SDA-TP) 9 NC (SCL-TP) 10 NC (RST-TP) 11 NC (EINT-TP) 12 GND 13 VIO18 14 VCC28 15 NC (VTP-TP) 16 GND 17 MIPI_TDP3 18 MIPI_ TDN3 19 GND 20 MIPI_ TDP2 21 MIPI_ TDN2 22 GND 23 MIPI_ TDP1 24 MIPI_ TDN1 25 GND 26 MIPI_ TDP0 27 MIPI_ TDN0 28 GND 29 MIPI_ TCP 30 MIPI_ TCN 31 GND 32 GND 33 GND 34 GND LCM Figure 9: Reference Design for LCM Interface Smart_ EVB_User_Guide 19 / 45 Smart LTE Module Series Smart EVB User Guide Figure 10: Pin Assignment of LCM Interface 3.4. Camera Interfaces (J301/J302) Smart EVB provides two camera interfaces (2-lane+1-lane) with main camera and sub camera assembled. ⚫ The main camera uses an 8M pixels digital CMOS sensor with auto-focusing function. ⚫ The sub camera uses a 2M pixels CMOS sensor. The following figure shows a reference circuit design for camera interfaces. Smart_ EVB_User_Guide 20 / 45 Smart LTE Module Series Smart EVB User Guide 1 uF 100nF 1uF 100nF Ma in camera connector VDD _AF_2V8 LDO17_2V85 DVDD_1V2 MCAM_ RST MCAM_PWDN MCAM_MCLK CAM_I2C_ SDA CAM_I2C_ SCL CSI0_LN1_P CSI0_LN1_N CSI0_LN0_P CSI0_LN0_N CSI0_ CLK_P CSI0_ CLK_N LDO6_1V8 2.2K 2.2K EMI EMI EMI LDO6_1V8 2.2uF 0.1uF 1uF AF_VDD AVDD DVDD DOVDD AVDD DOVDD SCAM_RST SCAM_PWDN SCAM_MCLK CSI1_LN0_P EMI CSI1_LN0_N CSI1_ CLK_P EMI CSI1_ CLK_N Figure 11: Reference Circuit Design for Camera Interfaces Sub camera connector Smart_ EVB_User_Guide 21 / 45 Smart LTE Module Series Smart EVB User Guide J301 J302 Figure 12: Camera Interfaces with Cameras Assembled 3.5. SD Card Interface (J502) Smart EVB provides an SD card interface (J502) for customers to test the module’s SD card interface. The following figure shows the simplified interface schematic for SD card interface on Smart EVB. SD_DATA2 SD_DATA3 SD_CMD SD_CLK SD_DATA0 SD_DATA1 SD_DET LDO5_1V8 SD_LDO12 SD_LDO11 R1 120K R7 33R R8 33R R9 33R R10 33R R11 33R R12 33R R13 1K R2 R3 R4 R5 R6 NM_51K NM_51K NM_10K NM_51K NM_51K Module 27pF 27pF D1 27pF 27pF 27pF 27pF D2 D3 D4 D5 D6 D7 C1 C2 D8 2.2 uF 33pF 1 P1-DAT2 2 P2-CD/DAT3 3 P3-CMD 4 P4-VDD 5 P5-CLK 6 P6-VSS 7 P7-DAT0 8 P8-DAT1 9 DETECTIVE 10 GND 11 GND 12 GND 13 GND SD Card Connector Figure 13: Simplified Interface Schematic for SD Card Interface Smart_ EVB_User_Guide 22 / 45 Smart LTE Module Series Smart EVB User Guide 9 8 7654 32 1 Figure 14: Pin Assignment of SD Card Interface 3.6. USB Interface (J602) The Smart EVB provides a Micro USB interface (J602), which complies with USB 2.0 specifications and supports USB OTG function. This interface is used for AT command communication, data transmission and firmware upgrade. The reference circuit design for Micro USB interface is shown in the following figure and the pin assignment of it is listed in the table below. Smart_ EVB_User_Guide 23 / 45 Smart LTE Module Series Smart EVB User Guide Figure 15: Reference Circuit Design for USB Interface 1 2345 J602 Figure 16: Pin Assignment of Micro USB Interface Smart_ EVB_User_Guide 24 / 45 Smart LTE Module Series Smart EVB User Guide Table 5: Pin Assignment of Micro USB Interface Pin No. 1 2 3 4 5 Pin Name USB_VBUS USB_DM USB_DP USB_ID GND Description Used for USB detection and power supply of OTG equipment USB serial differential bus (minus) USB serial differential bus (plus) USB serial ID signal GND for USB interface NOTE The USB_DP and USB_DM data lines are connected directly to the module. 3.7. Audio Interfaces (J702) Smart EVB provides four audio interfaces, including loudspeaker, headphone, earphone and microphone interfaces. 3.7.1. Loudspeaker Interface Loudspeaker is soldered onto the Smart EVB via TP701 and TP702. The following figure shows the reference circuit design for loudspeaker interface. Smart EVB SPK_P Close to speaker GND 1 nF FB ESD SPK_N FB 1 nF GND ESD Figure 17: Reference Circuit Design for Loudspeaker Interface Smart_ EVB_User_Guide 25 / 45 Smart LTE Module Series Smart EVB User Guide 3.7.2. Headphone Interface The following figure shows the reference circuit design for headphone interface. MIC_GND MIC2_P HPH_L HS_DET HPH_R HPH_REF Module R1 0R C1 C2 NM NM 0R R4 0R F5 33R R5 R6 33R C6 100pF C3 C4 C5 33pF 33pF 33pF F1 F2 R2 20K F3 F4 R7 R8 D1 D2 D3 D4 10K10K ESD 1 5 4 3 6 2 R3 0R Figure 18: Reference Circuit Design for Headphone Interface The following figure shows the pin assignment of headphone interface. 2 1 3 6 5 4 Figure 19: Pin Assignment of Headphone Interface Smart_ EVB_User_Guide 26 / 45 Smart LTE Module Series Smart EVB User Guide Table 6: Pin Assignment of Headphone Interface Pin No. 1 2 3 4 5 6 Pin Name MIC GND R-AUDIO DETECT L-AUDIO GND Description Positive microphone input Dedicated GND for audio Headphone right channel Headphone detection Headphone left channel Dedicated GND for audio The following figure shows the sketch design of audio plug which suits for the audio jack on Smart EVB. HS_DET 5 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 20: Sketch of Audio Plug 3.7.3. Microphone and Earphone Interfaces Smart EVB provides a microphone interface and an earphone interface. The following figure shows the reference circuit design for microphone and earphone interfaces. Smart_ EVB_User_Guide 27 / 45 Smart LTE Module Series Smart EVB User Guide EVB FB MIC1_P MIC1_N EAR_P EAR_N 100pF 33pF 33pF ESD ESD 100pF ESD ESD 33pF 33pF MIC_BIAS U701 MIC Earphone Figure 21: Reference Circuit Design for Microphone and Earphone Interfaces 3.8. (U)SIM Interfaces (J503/J504) The Smart EVB provides the following two (U)SIM card (2.95V or 1.8V) connectors: ⚫ J503: (U)SIM1 card connector ⚫ J504: (U)SIM2 card connector The following figure shows the simplified interface schematic for J503. USIM_VDD USIM_RST USIM_CLK USIM_DATA USIM_DETECT EVB GND GND C1 USIM _VDD C5 USIM_GND C2 USIM_ RST C6 USIM_VPP C3 USIM_CLK Push-Push C7 USIM_ DATA CD2 USIM_ PRE CD1 USIM_GND (U)SIM card connector J503 Figure 22: Simplified Interface Schematic for (U)SIM1 Card Connector (J503) Smart_ EVB_User_Guide 28 / 45 Smart LTE Module Series Smart EVB User Guide Figure 23: Pin Assignment of (U)SIM1 Card Connector (J503) Table 7: Pin Assignment of (U)SIM1 Interface (J503) Pin No. C1 C2 C3 C5 C6 C7 CD1 CD2 Pin Name USIM_VDD USIM_RST USIM_CLK GND VPP USIM_DATA GND USIM_DETECT I/O O O O I/O GND I Description (U)SIM1 card power supply (U)SIM1 card reset signal (U)SIM1 card clock signal Ground Not connected Bi-directional data line Ground (U)SIM1 card detection NOTE The pin assignment of (U)SIM2 interface (J504) is the same as that of (U)SIM1 interface (J503). Smart_ EVB_User_Guide 29 / 45 Smart LTE Module Series Smart EVB User Guide 3.9. UART Interfaces (J901/J604) Smart EVB provides two UART interfaces: main UART port J901 and debug UART port J604. The debug UART interface is intended for data transmission and AT command communication. And the main debug UART interface is not used by default. The following figure and table show the block diagram of debug UART port J604 and the pin assignment of it. J 604 UART DB9 RS 232 U 602 RS 232 Level Match 3.3 V Module J 101 3.3V/1.8 V Level Translator 1.8 V Figure 24: Block Diagram of Debug UART Port (J604) 9 8 76 54 3 21 Figure 25: Pin Assignment of Debug UART Port (J604) Smart_ EVB_User_Guide 30 / 45 Table 8: Pin Assignment of Debug UART Port (J604) Pin No. Pin Name I/O 1 2 RS232_TXD O 3 RS232_RXD I 4 5 RS232_GND 6 7 8 9 Smart LTE Module Series Smart EVB User Guide Description Not connected Transmit data Receive data Not connected Ground Not connected Not connected Not connected Not connected 3.10. Switches and Buttons Smart EVB provides four switches (S801/S802/S803/S804) and nine buttons (S901/S902/S903 /S904/S905/S906/S907/S908/S909). Smart_ EVB_User_Guide 31 / 45 S802 OFF ON ON S804 OF F Smart LTE Module Series Smart EVB User Guide S801 S803 Battery ON DC_Power OFF S906 S909 S903 S904 S901 S908 S905 S902 S907 Figure 26: Switches and Buttons Table 9: Description of Switches and Buttons Items S801 S802 S803 S804 S901 S902 S903 Description Used to select DCDC power supply or battery power supply Used to force the module to boot from USB port Turned off by default Used to power on/off the module Used to turn on/off battery charger Turned off by default Power key (push button) Used to turn on/off the module Snapshot button Used to snapshot photos Home button Smart_ EVB_User_Guide 32 / 45 S904 S905 S906 S907 S908 S909 Used to enter home page Volume up button Used to increase volume Focus button Used to focus during shooting photos Menu button Volume down button Used to lower volume Reset push button Used to reset the module Back button Used to return to the previous page Smart LTE Module Series Smart EVB User Guide 3.11. Status Indication LEDs There are four LED status indication lights (D805, D806, D807 and D808) on the Smart EVB, which are shown as below. Figure 27: Status Indication LEDs Table 10: Description of Status Indication LEDs Items D806 Description Indicate the power supply status of SC20 module Smart_ EVB_User_Guide 33 / 45 D808, D805 D807 Bright: VBAT ON Extinct: VBAT OFF Disabled by default Indicate the network registration status of SC20 Bright: Registered on Network Extinct: Not Registered on Network Smart LTE Module Series Smart EVB User Guide 3.12. Test Points J904 consists of 10 test points. The details are shown in the following figure and table. Figure 28: Pin Assignment of J904 Smart_ EVB_User_Guide 34 / 45 Table 11: Details of Test Points Pin No. 1 2 3 4 5 6 7 8 9 10 Pin Name GPIO_T2 VDD_3V3 GPIO_ T2 CTS_3V3 VREG_L5 RXD_3V3 GND RTS_3V3 GPIO_T1 TXD_3V3 Smart LTE Module Series Smart EVB User Guide Description GPIO_68 test point 3.3V power supply of EVB GPIO_69 test point 3.3V CTS signal LDO5_1V8 power supply of the module 3.3V RXD signal Ground 3.3V RTS signal GPIO_14 test point 3.3V TXD signal 3.13. Flashlight The Smart EVB provides a flashlight LED D202, for testing the module’s flashlight interface which supports flash mode and torch mode. The following figures show a reference circuit design for flashlight and its location on Smart EVB. VBAT 13 AGND 3 AGND 7 PGND 15 GND CATHODE R5 0R C2 Module 1.0uH L1 FLASH_ EN 97 TORCH _ MODE90 R4 10K R3 10K GND 5 SW 6 SW 4 VIN 10 ENF 11 ENM U201 GND VOUT VOUT D1 D2 RSETF RSETM ANODE D202 Flashlight C1 R2 R1 75K 20K GND Figure 29: Reference Circuit Design for Flashlight Interface Smart_ EVB_User_Guide 35 / 45 Smart LTE Module Series Smart EVB User Guide U201 D202 Figure 30: Flashlight 3.14. Vibrator The Smart EVB provides an ERM-type vibrator for customers to test the motor driver interface of SC20 module. The following figures show the reference circuit design of the vibrator and its location on the board. VDD_3V3 C1 1uF VIB_DRV_N 28 Module D1 C2 33pF 1 VIB+ 2 VIB3 GND Motor Figure 31: Reference Circuit Design for Vibrator Smart_ EVB_User_Guide 36 / 45 U206 Vibrator Smart LTE Module Series Smart EVB User Guide Figure 32: ERM-Type Vibrator 3.15. Sensors Smart EVB provides three sensors for testing purpose, as shown in the figure below. ALS/PS G-se nso r&gy rosc opic Figure 33: Sensors Compass Smart_ EVB_User_Guide 37 / 45 Smart LTE Module Series Smart EVB User Guide 4 Operation Procedures This chapter introduces how to use the Smart EVB for testing and evaluating Quectel SC20 module. 4.1. Power on SC20 Module The following are the procedures for powering on SC20 module. 1. Connect the TE-A to the connectors (J101 and J102) on smart EVB. 2. Connect the DC adapter and pull S801 to DC POWER state. 3. Pull S803 to ON state, and then D806 will be lighted. 4. Press the S901 (PWRKEY) for at least 2s to turn on the module. When the following interface is displayed on the LCD, it means the booting has been completed. Figure 34: LCD Display Indicating Module’s Power-on Smart_ EVB_User_Guide 38 / 45 Smart LTE Module Series Smart EVB User Guide 4.2. Power off SC20 Module There are two methods to power off the module. One is to operate via the system. The steps are shown as follows. 1. Press S901 (PWRKEY) for at least 1s under power on state, and then LCM will display a menu as shown in the following figure. Figure 35: LCD Menu Display for Powering off Module 2. Choose 'Power off'. 3. The module will be powered off. Another way is to press down S901 (PWRKEY) until the module is shut down. 4.3. Communication via USB or UART Interface 4.3.1. Communication via USB Interface 1. Power on the module according to the procedures mentioned in Chapter 4.1. 2. Connect Smart EVB and PC with USB cable through USB interface and install USB driver from the USB Flash drive. The USB port numbers can be viewed through the PC’s Device Manager. Smart_ EVB_User_Guide 39 / 45 Smart LTE Module Series Smart EVB User Guide Figure 36: USB COM Ports 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the smart module and the PC. The following figure shows the QCOM configuration: select correct 'COM port' and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [2]. Figure 37: QCOM Configuration When Communicating via USB Interface Smart_ EVB_User_Guide 40 / 45 Smart LTE Module Series Smart EVB User Guide 4.3.2. Communication via UART Interface 1. Run the driver disk on PC to install the USB-to-RS232 driver. 2. Connect the UART interface (main UART or debug UART) to the PC with USB-to-RS232 converter cable and then power on the module according to the procedures mentioned in Chapter 4.1. After that, the USB serial port number can be viewed through the PC Device Manager, shown as the following figure. Figure 38: USB Serial Port 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the smart module and the PC. The following figure shows the QCOM configuration: select correct 'COM port' (USB Serial Port) and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [2]. Smart_ EVB_User_Guide 41 / 45 Smart LTE Module Series Smart EVB User Guide Figure 39: QCOM Configuration When Communicating via UART Interface 4.4. Firmware Upgrade Quectel SC20 module upgrade firmware via USB port by default. Please follow the procedures below to upgrade firmware. 1. Open the firmware upgrade tool QFIL on PC and then power on SC20 module according to the procedures mentioned in Chapter 4.1. 2. Click the 'SelectPort' and select the USB port 'Qualcomm HS-USB Diagnostics Modem 9091 (COM24)'. 3. Select 'Flat Build' in 'Select Build Type' option. 4. Click 'Browse' to select the firmware which needs to be upgraded in 'Select Programmer' option'. 5. Click 'Load XML' to select the XML which needs to be upgraded in 'Select Build' option. 6. Click 'Download' to upgrade the firmware. Smart_ EVB_User_Guide 42 / 45 1 3 Smart LTE Module Series Smart EVB User Guide 2 4 5 6 Figure 40: Firmware Upgrade Steps Smart_ EVB_User_Guide 43 / 45 Smart LTE Module Series Smart EVB User Guide 5 EVB Accessories Assembly Figure 41: Smart EVB and Accessories Assembly Smart_ EVB_User_Guide 44 / 45 Smart LTE Module Series Smart EVB User Guide 6 Appendix A Reference Table 12: Related Documents SN Document name [1] Quectel_SC20_Hardware_Design [2] Quectel_QCOM_User_Guide Remark SC20 hardware design User guide for QCOM tool Table 13: Terms and Abbreviations Abbreviation EVB OTG PC SIM USIM Description Evaluation Board On-The-Go Personal Computer Subscriber Identity Module Universal Subscriber Identity Module Smart_ EVB_User_Guide 45 / 45

5G EVB User Guide 5G/LTE-A Module Series Version: 1.2 Date: 2021-05-08 Status: Released 5G/LTE-A Module Series 5G EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. 5G_EVB_User_Guide 1 / 38 5G/LTE-A Module Series 5G EVB User Guide Copyright The information contained here is proprietary technical information of Quectel Wireless Solutions Co., Ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. 5G_EVB_User_Guide 2 / 38 5G/LTE-A Module Series 5G EVB User Guide Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating the module. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signal and cellular network cannot be guaranteed to connect in certain conditions, such as when the mobile bill is unpaid or the (U)SIM card is invalid. When emergency help is needed in such conditions, use emergency call if the device supports it. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. In an emergency, the device with emergency call function cannot be used as the only contact method considering network connection cannot be guaranteed under all circumstances. The cellular terminal or mobile contains a transceiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV sets, radios, computers or other electric equipment. In locations with explosive or potentially explosive atmospheres, obey all posted signs and turn off wireless devices such as mobile phone or other cellular terminals. Areas with explosive or potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, and areas where the air contains chemicals or particles such as grain, dust or metal powders. 5G_EVB_User_Guide 3 / 38 5G/LTE-A Module Series 5G EVB User Guide About the Document Revision History Version 1.0 1.1 1.2 Date 2020-05-25 2020-05-25 2020-05-26 2021-05-08 Author Description Iverson CHENG Creation of the document Iverson CHENG Iverson CHENG Besson RONG First official release Updated the firmware upgrade tool in Chapter 4.3 to QFlash. 1. Chapter 2: Updated the descriptions of interfaces/ switches/ buttons in Table 2; updated the top and bottom view for component placement (Figure 1 and Figure 2), and the interface table (Table 3); updated the accessories of the EVB (Table 4). 2. Chapter 3: Updated the interface reference designators and corresponding figures according to the EVB upgrade. 3. Chapter 4.3.1: Updated the emergency download procedure. 4. Chapter 4.4: Updated the period of pressing RESET button for the module reset. 5G_EVB_User_Guide 4 / 38 5G/LTE-A Module Series 5G EVB User Guide Contents Safety Information .................................................................................................................................... 3 About the Document ................................................................................................................................ 4 Contents.................................................................................................................................................... 5 Table Index ............................................................................................................................................... 6 Figure Index .............................................................................................................................................. 7 1 Introduction ....................................................................................................................................... 8 1.1. Applicable Modules .................................................................................................................. 8 2 General Overview .............................................................................................................................. 9 2.1. Key Features ............................................................................................................................ 9 2.2. Component Placement of 5G EVB ..........................................................................................11 2.3. Top and Bottom Views of 5G EVB .......................................................................................... 14 2.4. List of Accessories.................................................................................................................. 16 3 Interface Application....................................................................................................................... 17 3.1. Power Supply (J0303) ............................................................................................................ 18 3.2. Module TE-A Interface (J0101/J0102) .................................................................................... 19 3.3. PHY TE-A Interface (J1901/J1902) ........................................................................................ 20 3.4. USB Interface (J1101) ............................................................................................................ 21 3.5. Audio Interface (J0802/J0901/J0801)..................................................................................... 21 3.5.1. Digital Audio Codec Board Connector (J0802) ............................................................ 21 3.5.2. Analog Audio Interfaces (J0801/J0901) ....................................................................... 23 3.5.2.1. Loudspeaker Interface (J0801) ......................................................................... 23 3.5.2.2. Earphone Interface (J0901) .............................................................................. 23 3.6. (U)SIM Card Interfaces (J1401/J1402) ................................................................................... 25 3.7. SD Card Interface (J1301)...................................................................................................... 26 3.8. UART Interfaces (J2002/J2003) ............................................................................................. 28 3.9. PCIe to USB Interface (J1601) ............................................................................................... 28 3.10. Switches and Buttons ............................................................................................................. 29 3.11. Status Indicators (D0201/D0202/D0203/D0204/D0205)......................................................... 31 3.12. Wi-Fi Interfaces (J0701/J0702) .............................................................................................. 32 3.13. Antenna Interfaces ................................................................................................................. 33 4 EVB Operation Procedures ............................................................................................................ 34 4.1. Turn on the Module ................................................................................................................ 34 4.2. Communication via USB......................................................................................................... 34 4.3. Firmware Upgrade.................................................................................................................. 35 4.3.1. Emergency Download.................................................................................................. 35 4.3.2. Normal Download ........................................................................................................ 36 4.4. Reset the Module ................................................................................................................... 36 4.5. Turn off the Module................................................................................................................. 36 5 Appendix A References .................................................................................................................. 37 5G_EVB_User_Guide 5 / 38 5G/LTE-A Module Series 5G EVB User Guide Table Index Table 1: Applicable Modules ...................................................................................................................... 8 Table 2: Key Features ............................................................................................................................... 9 Table 3: Components & Interfaces of 5G EVB ........................................................................................ 12 Table 4: Accessories List ......................................................................................................................... 16 Table 5: PHY8035-TE-A Configuration Switch ........................................................................................ 21 Table 6: Codec TE-A Configuration Switch.............................................................................................. 22 Table 7: Pin Definition of J0901 ............................................................................................................... 24 Table 8: Pin Definition of J1401 ............................................................................................................... 26 Table 9: SDIO Switch Function................................................................................................................ 27 Table 10: PCIe Connection Truth Table ................................................................................................... 29 Table 11: Description of Switches and Buttons........................................................................................ 31 Table 12: Description of Status Indication LEDs...................................................................................... 31 Table 13: Related Documents ................................................................................................................. 37 Table 14: Terms and Abbreviations.......................................................................................................... 37 5G_EVB_User_Guide 6 / 38 5G/LTE-A Module Series 5G EVB User Guide Figure Index Figure 1: Top View for Component Placement of the EVB .......................................................................11 Figure 2: Bottom View for Component Placement of the EVB................................................................. 12 Figure 3: 5G EVB Top View ..................................................................................................................... 14 Figure 4: 5G EVB Bottom View ............................................................................................................... 15 Figure 5: Block Diagram of the EVB Power Supply ................................................................................. 18 Figure 6: EVB Power Supply Interface .................................................................................................... 19 Figure 7: Connection Between the Module TE-A and the EVB................................................................ 19 Figure 8: Connection Between PHY8035-TE-A and the EVB ................................................................. 20 Figure 9: S1801/S1802 Switch ................................................................................................................ 20 Figure 10: USB Interface Connection ...................................................................................................... 21 Figure 11: Connection Between Codec TE-A and the EVB ..................................................................... 22 Figure 12: S2801 Switch ......................................................................................................................... 22 Figure 13: Reference Circuit Design for Loudspeaker Interface J0801 ................................................... 23 Figure 14: Reference Circuit Design for Earphone Interface J0901 ........................................................ 23 Figure 15: Pin Assignment of J0901........................................................................................................ 24 Figure 16: Schematic of Audio Plug ........................................................................................................ 24 Figure 17: Simplified Connector Schematic for (U)SIM Card Connectors ............................................... 25 Figure 18: Pin Assignment of (U)SIM Card Connector J1401 ................................................................. 25 Figure 19: Simplified Interface Schematic for J1301 ............................................................................... 26 Figure 20: S2501 Switch ......................................................................................................................... 27 Figure 21: Pin Assignment of SD Card Connector J1301........................................................................ 27 Figure 22: UART Block Diagram ............................................................................................................. 28 Figure 23: PCIe Block Diagram ............................................................................................................... 28 Figure 24: S1501 Switch ......................................................................................................................... 29 Figure 25: Power Switch and S2501 Switch............................................................................................ 29 Figure 26: S1802/S1501 Switch and S0201 Button ................................................................................ 30 Figure 27: S0202/S0203 Button .............................................................................................................. 30 Figure 28: S1801/S2801 Switch .............................................................................................................. 30 Figure 29: Status Indicator ...................................................................................................................... 31 Figure 30: Simplified FG50V-TE-A Interface Schematic .......................................................................... 32 Figure 31: Connection Between FG50V-TE-A and the EVB .................................................................... 33 Figure 32: Antenna Interfaces ................................................................................................................. 33 Figure 33: USB Ports .............................................................................................................................. 34 Figure 34: COM Port Setting Field on QCOM (USB AT Port Connection) ............................................... 35 Figure 35: USB Port in PC Device Manage............................................................................................. 36 5G_EVB_User_Guide 7 / 38 5G/LTE-A Module Series 5G EVB User Guide 1 Introduction This user guide describes detailed information about the usage of the EVB (Evaluation Board) for Quectel 5G RG50xQ series and LTE-A EG512R-EA modules. The EVB is an auxiliary tool for engineers to develop and test these modules. 1.1. Applicable Modules Quectel 5G EVB is applicable to the following modules: Table 1: Applicable Modules Module Series 5G LTE-A Models RG50xQ Series: RG500Q Series/ RG502Q-EA EG512R-EA 5G_EVB_User_Guide 8 / 38 5G/LTE-A Module Series 5G EVB User Guide 2 General Overview Quectel supplies 5G EVB for engineers to develop applications based on Quectel 5G and LTE-A EG512R-EA modules. This EVB can be used to test basic functionalities of these modules. 2.1. Key Features The following table describes the detailed features of 5G EVB. Table 2: Key Features Features Power Supply Module TE-A Interface PHY TE-A Interface Wi-Fi TE-A Interface AP TE-A Interface SD Card Interface (U)SIM Card Interface Audio Interfaces UART Interface Implementation DC power supply: 4.5–5.5 V Typical: +5 V/ 3 A Quectel 5G RG50xQ Series and LTE-A EG512R-EA modules supported PHY AR8035 supported Reserved Reserved SD card connector Dual (U)SIM card supported: 1.8 V and 2.95 V ⚫ 1 digital audio codec board interface: Supporting ALC5616-TE-A and TLV320AIC3104-TE-A codec boards ⚫ 2 analog audio interfaces: Used for loudspeaker and earphone COM1 (J2002): ⚫ Main UART ⚫ For data communication ⚫ Default baud rate: 115200 bps COM2 (J2003): ⚫ Debug UART ⚫ For debugging 5G_EVB_User_Guide 9 / 38 5G/LTE-A Module Series 5G EVB User Guide USB Interface PCIe to USB Interface Signal Indication Button and Switches Physical Characteristics Antenna ⚫ Default baud rate: 115200 bps ⚫ USB Type C interface ⚫ USB 3.0 and USB 2.0 supported Reserved 5 LEDs are available for signal indication ⚫ PWRKEY (S0202) ⚫ RESET (S0201) ⚫ USB_BOOT (S0203) ⚫ PCIe Configuration Switch (S1501) ⚫ Power Switch (S0301) ⚫ SDIO Configuration Switch (S2501) ⚫ RGMII Configuration Switch (S1801/S1802) ⚫ Codec Configuration Switch (S2801) Size: 235 mm × 190 mm 12 antenna interfaces 5G_EVB_User_Guide 10 / 38 2.2. Component Placement of 5G EVB 5G/LTE-A Module Series 5G EVB User Guide J0301 100Pin 3.8V_EN RESET_3.3V PWRKEY_3.3V PWRKEY_3.3V CV2X_5V_CTL J0402 100Pin J0304 TX RX GND J2001 J1001 GND VCC _3V8 REG_3V3 Adapter_ 5V J0401 S0301 USIM1 J1401 card 60 Pin J1902 PH Y-TE-A J1901 60Pin RGMII_SEL2 RGMII_SEL1 S1801 RGMII_SEL3 S1802 RESET S0201 PCIE_SEL1 PCIE_SEL2 S1501 PCIe to USB J1601 PWRKEY S0202 SLEEP D 0 205 NET_ STATUS D 0 204 NET_ MODE D 0 203 STATUS D 0 202 POWER D 0201 SDIO_SWITCH S2501 OFF ON USB Type C J1101 ANT_GNSS L1L5 J0803 CODEC-TE-A J 2303 ANT0 J2311 J2308 J1201 J0804 SLIC_SEL2 SLIC_SEL1 S2801 SPI1_MOSI SPI1_CS SPI1_CLK SPI1_MISO GND J0805 60 Pin J 0701 WIFI-TE-A J 0702 60 Pin J 2101 60 Pin J0802 I2S_WS I2S_DIN I2S_DOUT I2S_SCK J0202 MCLK I2C3_SDA GND PS_HOLD I2C3_SCL J0203 PON 1.8V J0103 S0203 USB_BOOT ANT_WIFI0 J 2346 J 0102 140 Pin J2348 Module TE-A ANT_GNSS L1 J 0101 AP-TE-A 140 Pin J 2102 ANT_WIFI1 J 2347 ANT7 J 2315 ANT6 J 2317 ANT5 J 2307 ANT4 USB_Switch High Low AP _UART ANT2 J 2304 ANT1 J 2312 J 2318 ANT3 Figure 1: Top View for Component Placement of the EVB 5G_EVB_User_Guide 11 / 38 SPK J0801 5G/LTE-A Module Series 5G EVB User Guide EARPHONE J0901 USIM2 card J1402 J2002 MAIN_UART J2003 J1301 SD card DBG_UART J0303 5V/3A ADAPTER Figure 2: Bottom View for Component Placement of the EVB Table 3: Components & Interfaces of 5G EVB Interface Power Supply Power Switch PWRKEY PON USB_BOOT RESET Reference Designator Description J0303 The power jack on the EVB Typical supply voltage: +5 V/ 3 A S0301 VBAT ON/OFF control S0202 Power key (push button) Used to turn on/off the module J0203 Auto-power on control S0203 Emergency download S0201 Reset button (push button) 5G_EVB_User_Guide 12 / 38 USB PCIe to USB PCIe Configuration Switch SDIO Configuration Switch RGMII Configuration Switch Codec Configuration Switch Audio (U)SIM SD Card Main UART Debug UART Status Indicator Module TE-A PHY TE-A Wi-Fi TE-A AP TE-A J1101 J1601 S1501 S2501 S1801, S1802 S2801 J0802 J0801 J0901 J1401 J1402 J1301 J2002 J2003 D0201 D0202 D0203 D0204 D0205 J0101, J0102 J1901, J1902 J0701, J0702 J2101, J2102 5G/LTE-A Module Series 5G EVB User Guide Used to reset the module USB Type C interface PCIe to USB interface, not supported by default Used to configure the module communication with different devices via PCIe signals Used to switch between SD card and eMMC Used for RGMII configuration Used for codec configuration Codec board TE-A connector Designed for loudspeakers Audio jack for earphone (U)SIM1 card connector (U)SIM2 card connector SD card connector MAIN_UART port for data communication DBG_UART port for debugging Power supply on/off indicator, indicating whether the module’s power supply is on or off. Module operation status indicator, indicating whether the module is powered on. Net mode indicator, indicating NET_MODE status of the module. Net status indicator, indicating NET_STATUS status of the module. Sleep status indicator, indicating SLEEP status of the module. Module TE-A connectors PHY TE-A connectors Wi-Fi TE-A connectors AP TE-A connectors 5G_EVB_User_Guide 13 / 38 Antenna 5G/LTE-A Module Series 5G EVB User Guide J2303, J2304, J2307, J2308, J2311, J2312, J2315, J2317, J2318, J2346, J2347, J2348 Antenna connectors 2.3. Top and Bottom Views of 5G EVB The following figures shows the top and bottom views of the 5G EVB. 5G_EVB_User_Guide Figure 3: 5G EVB Top View 14 / 38 5G/LTE-A Module Series 5G EVB User Guide Figure 4: 5G EVB Bottom View 5G_EVB_User_Guide 15 / 38 5G/LTE-A Module Series 5G EVB User Guide 2.4. List of Accessories All accessories of the 5G EVB kit are listed below. Table 4: Accessories List Items Description Quantity (pcs) USB to RS-232 converter cable 1 USB Type A converter B cable 1 Cables USB Type-C cable 1 RF cables 9 Wi-Fi antenna 2 Antennas RF antennas 8 GNSS antenna (passive) 2 Audio Earphone 1 USB Driver Including module’s related documents, tools & drivers etc. 1 Codec TE-A ALC5616, TLV320AIC3104 2 PHY TE-A PHY AR8035 1 Screws Used to fasten TE-As on the EVB 8 Instruction Sheet PCIe to USB adapter A sheet of paper giving instructions for EVB connection, 1 details of EVB accessories, etc. PCIe signal is transferred through USB 3.0 connector, not 1 used by default. Bolts and Nuts Bolts and nuts for assembling the EVB 4 pairs Power Adapter +5 V/ 3 A power adapter 1 5G_EVB_User_Guide 16 / 38 5G/LTE-A Module Series 5G EVB User Guide 3 Interface Application This chapter describes the hardware interfaces of the 5G EVB, as listed below: ⚫ Power supply ⚫ Module TE-A interface ⚫ PHY TE-A interface ⚫ USB interface ⚫ Audio interfaces - Digital Audio Codec Board Connector - Analog Audio Interfaces -- Loudspeaker Interface -- Earphone Interface ⚫ (U)SIM interfaces ⚫ UART interfaces ⚫ SD card interface ⚫ PCIe to USB interface ⚫ Switches and buttons ⚫ Status indicators ⚫ Wi-Fi interface ⚫ Antenna Interfaces It also provides information about the buttons, switches, status indication LEDs and test points to help developers use the EVB. 5G_EVB_User_Guide 17 / 38 5G/LTE-A Module Series 5G EVB User Guide 3.1. Power Supply (J0303) The 5G EVB can be powered by an external power adapter through the power jack (J0303). The following two figures manifest a simplified power supply block diagram and the power interface of 5G EVB. JJ00330033 PPoowweerr JJaacckk 55VV//33AA REG_3V3 5V UU22220011 TTPPSS6622113300 UU22220022 MMPP22114455 1.5V 0.9V WiFi AP AP UU00550022 MMPP22114455 UU22550022 TTLLVV7755551188 UU22550044 XXCC66222277CC330011 UU00660022 MMPP11660055 0.9V 1.8V 3.0V 2.7V AP/WIFI EMMC EMMC Level Shift UU00660011 MMPP11660055 2.5V RGMII QQ00330022 MMOOSS 5V Test Point UU22000044 TTLLVV7755553333 3.3V UART UU00440033 MMPP11660055 4.2V AP UU00330011 TTPPSS6622113300 UU00440044 TTPPSS6622113300 3.8V Moudle REG_1V8 RGMII/Wi-Fi/ Level Shift/ADC/ Codec, etc. UU00440022 TTPPSS6622113300 REG_3V3 UU00440011 IISSLL8800110011 UU00440055 TTPPSS772288118800228855 SD_3.0V SDIO PHY/Wi-Fi/Level Shift/USB&PCIe Switch/Analog Switch/Multiplexer/ Codec, etc. SD Card SD Card Figure 5: Block Diagram of the EVB Power Supply 5G_EVB_User_Guide 18 / 38 5G/LTE-A Module Series 5G EVB User Guide Figure 6: EVB Power Supply Interface 3.2. Module TE-A Interface (J0101/J0102) Module TE-A interface is designed to accommodate the TE-A of the modules. The TE-A is mounted onto and connected to the EVB via BTB connectors J0101 and J0102. The developer will be able to test the functionalities of the modules easily (insert as indicated by the arrow to prevent reverse insertion). The following figure displays the connection between the module TE-A and the EVB. Figure 7: Connection Between the Module TE-A and the EVB 5G_EVB_User_Guide 19 / 38 5G/LTE-A Module Series 5G EVB User Guide 3.3. PHY TE-A Interface (J1901/J1902) The PHY TE-A interface is designed to accommodate the PHY TE-A (PHY8035-TE-A). The PHY TE-A is mounted onto and connected to the EVB via BTB connectors J1901 and J1902 (insert as indicated by the arrow to prevent reverse insertion). The following two figures displays the connection between PHY8035-TE-A and EVB. Figure 8: Connection Between PHY8035-TE-A and the EVB Figure 9: S1801/S1802 Switch 5G_EVB_User_Guide 20 / 38 Table 5: PHY8035-TE-A Configuration Switch RGMII_SEL1 Low High High RGMII_SEL2 Low Low High RGMII_SEL3 1.8 V 2.5 V - 5G/LTE-A Module Series 5G EVB User Guide Function 1.8 V AR8035 2.5 V AR8035 1.8 V RTL8211 3.4. USB Interface (J1101) A USB Type C connector, which complies with USB 3.0/3.1 and USB 2.0 standard, is provided. This USB interface is used for AT command communication, data transmission and firmware upgrade. Figure 10: USB Interface Connection 3.5. Audio Interface (J0802/J0901/J0801) Quectel 5G EVB provides one digital audio codec board interface (I2S) J0802 and two analog audio interfaces J0901 and J0801. 3.5.1. Digital Audio Codec Board Connector (J0802) The 5G EVB supports two different kinds of external digital audio codec TE-As named ALC5616 and TLV320AIC3104. The codec circuit is assembled on an independent small board which can be interconnected with the EVB by the BTB connector J0802. 5G_EVB_User_Guide 21 / 38 5G/LTE-A Module Series 5G EVB User Guide Codecs can be selected according to specific application demands, the following figures show the connection between digital audio codec TE-A and the EVB. Figure 11: Connection Between Codec TE-A and the EVB S2801 codec configuration switch MODEM: codec connected to the module AP: codec connected to the AP Figure 12: S2801 Switch Table 6: Codec TE-A Configuration Switch SLIC_SEL1 Low High Low High SLIC_SEL2 Low High High Low AP NC I2S/SPI/RST/INT SPI/RST/INT I2S MODEM I2S/SPI/RST/INT NC I2S SPI/RST/INT 5G_EVB_User_Guide 22 / 38 5G/LTE-A Module Series 5G EVB User Guide 3.5.2. Analog Audio Interfaces (J0801/J0901) 3.5.2.1. Loudspeaker Interface (J0801) Audio interface J0801 is designed for loudspeakers and the following figure shows a reference design of loudspeaker with an external audio amplifier. J0802 Differential layout Codec LOUDL/P C1 TLV3104 C2 LOUDR/N U0801 Amplifier circuit LM4871 Close to speaker GND FB J0801 FB BTB CON GND Figure 13: Reference Circuit Design for Loudspeaker Interface J0801 3.5.2.2. Earphone Interface (J0901) Audio interface J0901 is designed for earphone. A reference circuit design is shown by the following figure. Differential layout J0802 MIC_N MIC_P Close to Socket GND AGND GND GND GND 10pF 33pF 4.7uF75pF 15pF ESD AGND Codec 22uF TLV3104 22uF AGND SPK_L 1uF SPK_R 1uF BTB CON Close to Socket 10pF 33pF 10pF 33pF ESD GND 0R NM_0R 2 4 6 5 3 1 J0901 Audio Jack NM_0R 0R AGND MIC_P Figure 14: Reference Circuit Design for Earphone Interface J0901 5G_EVB_User_Guide 23 / 38 5G/LTE-A Module Series 5G EVB User Guide The figure and table below illustrates the pin assignment and pin definition of earphone connector J0901. Figure 15: Pin Assignment of J0901 Table 7: Pin Definition of J0901 Pin No. 1 2 3 4 5, 6 Pin Name MIC AGND SPK_R SPK_L NC Description Microphone input Dedicated GND for audio Right channel of stereo audio output Left channel of stereo audio output Not connected The following figure shows a schematic of audio plug which suits the audio jack on 5G EVB. 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 16: Schematic of Audio Plug 5G_EVB_User_Guide 24 / 38 5G/LTE-A Module Series 5G EVB User Guide 3.6. (U)SIM Card Interfaces (J1401/J1402) The 5G EVB has two 8-pin push-push type (U)SIM card (1.8/2.95 V) connectors J1401 and J1402. The following figure shows a simplified connector schematic for J1401 and J1402. Module USIM_VDD USIM_RST USIM_CLK USIM_DATA USIM_PRESENCE GND Push-Push C1 USIM_VDD C5 GND C2 USIM_RST C6 VPP C3 USIM_CLK C7 (U)SIM card connector USIM_DATA C4 RESERVED C8 RESERVED CD USIM_PRESENCE J1401/J1402 Figure 17: Simplified Connector Schematic for (U)SIM Card Connectors The figure and table below illustrate the pin assignment and definition of (U)SIM card connector J1401. J1402 is similar to J1401. Figure 18: Pin Assignment of (U)SIM Card Connector J1401 5G_EVB_User_Guide 25 / 38 Table 8: Pin Definition of J1401 Pin No. C1 C2 C3 C4 C5 C6 C7 C8 CD Pin Name I/O USIM_VDD PO USIM_RST DO USIM_CLK DO RESERVED - GND - VPP - USIM_DATA I/O RESERVED - USIM_PRESENCE DI 5G/LTE-A Module Series 5G EVB User Guide Function U(SIM) card power supply, provided by module U(SIM) card reset U(SIM) card clock Not connected Ground Not connected Data line, bi-directional Not connected U(SIM) card insertion detection. 3.7. SD Card Interface (J1301) The 5G EVB provides an SDIO interface, which can be used for connecting SD card. The following figure shows the simplified interface schematic for J1301. J0101 Module U2502 SDIO_COM 6-Bit Multiplexer/ Demultiplexer SDIO_NC J1301 SD Card Connector SDIO Switch Figure 19: Simplified Interface Schematic for J1301 If SD card function is intended to be used, please switch the SDIO Switch to low level illustrated in the figure and table below, a standard SD card can be inserted into J1301. Which supports micro SD card 5G_EVB_User_Guide 26 / 38 5G/LTE-A Module Series 5G EVB User Guide of maximal 32 GB. With the SD card interface, customers can easily enhance the memory capacity of modules. Figure 20: S2501 Switch Table 9: SDIO Switch Function SDIO Switch Low High Function Enable SD card function Enable eMMC function 1) Figure 21: Pin Assignment of SD Card Connector J1301 ⚫NOTE 1) eMMC is not supported for RG50xQ series and EG512R-EA. 5G_EVB_User_Guide 27 / 38 5G/LTE-A Module Series 5G EVB User Guide 3.8. UART Interfaces (J2002/J2003) The 5G EVB supports two UART interfaces: main UART J2002 and debug UART J2003, supporting baud rate of 115200 bps by default. The main UART interface is used for communication between the module and the host application. The debug UART interface is used for Linux console and log output. The following figure shows a block diagram of UART interfaces of the EVB. J2002 U2003 RS232 Main UART RS232 Transceiver J2003 Debug UART U2005 USB to UART Bridge U2001 3.3V/1.8V Level Shift 1.8V Q2001 Q2002 3.3V/1.8V Level Shift 1.8V Module J0101 Figure 22: UART Block Diagram 3.9. PCIe to USB Interface (J1601) The 5G EVB reserves a PCIe 3.0 signal over USB interface for developers’ testing, and this function is not enabled by default. Please refer to the following block diagram. J1601 USB3.0 AB cable USB3.0B WiFi AP U1501/U1701 CLK J0101 SEL_1 SEL_2 PCIe Switch TX0/1 RX0/1 Module Figure 23: PCIe Block Diagram 5G_EVB_User_Guide 28 / 38 5G/LTE-A Module Series 5G EVB User Guide Figure 24: S1501 Switch Table 10: PCIe Connection Truth Table PCIE_SEL1 0 1 1 PCIE_SEL2 1 0 1 Function Module → PC Module → AP Module → Wi-Fi 3.10. Switches and Buttons The 5G EVB includes six switches (S0301, S1501, S1801, S1802, S2501 and S2801) and three buttons (S0201, S0202 and S0203), as shown in the following figures. Figure 25: Power Switch and S2501 Switch 5G_EVB_User_Guide 29 / 38 5G/LTE-A Module Series 5G EVB User Guide Figure 26: S1802/S1501 Switch and S0201 Button Figure 27: S0202/S0203 Button S2801 codec configuration switch MODEM: codec connected to the module AP: codec connected to the AP Figure 28: S1801/S2801 Switch 5G_EVB_User_Guide 30 / 38 5G/LTE-A Module Series 5G EVB User Guide Table 11: Description of Switches and Buttons Interface Reference Designator Description Power Switch S0301 VBAT ON/OFF control PWRKEY S0202 Power key used to turn on/off the module. PCIe Configuration S1501 PCIe configuration switch. Refer to Chapter 3.9 RESET S0201 Reset button used to reset the module. USB_BOOT S0203 Emergency download control. RGMII Configuration S1801, S1802 RGMII configuration switch. Refer to Chapter 3.3 SDIO Configuration S2501 SDIO configuration switch. Refer to Chapter 3.7 Codec Configuration S2801 Codec configuration switch. Refer to Chapter 3.5 3.11. Status Indicators (D0201/D0202/D0203/D0204/D0205) There are five status indication LEDs on the EVB. The following figure manifests the positions of these LED indicators. Figure 29: Status Indicator Table 12: Description of Status Indication LEDs Reference Designator D0201 Description Indicates whether the power supply for module is ready. On: VBAT ON Off: VBAT OFF 5G_EVB_User_Guide 31 / 38 D0202 D0203 D0204 D0205 5G/LTE-A Module Series 5G EVB User Guide Indicates the operation status of the module. On: the module is powered on Off: the module is powered off Indicate the module’s NET_MODE status. Indicate the module’s NET_STATUS status. Indicate the module’s SLEEP status. 3.12. Wi-Fi Interfaces (J0701/J0702) The Wi-Fi TE-A interface is designed to accommodate the TE-A of Wi-Fi modules (paired with FG50V). The TE-A is connected to the EVB via BTB connectors J0701 and J0702. The interface allows customers to test the Wi-Fi function of the module or to develop applications with Wi-Fi function easily. The following two figures show the connection between FG50V-TE-A and EVB. PCM BT_UART COEX_UART WLAN_EN BT_EN WLAN_SLEEP_CLK WLAN_PWR_EN1 WLAN_PWR_EN2 WL_LAA_AS_EN WL_PA_MUTING WL_LAA_RX WL_LAA_TX_EN WL_TX_EN GND J0701 VDD_3V3 VDD_1V8 PCM BT_UART COEX_UART WLAN_EN BT_EN WLAN_SLEEP_CLK WLAN_PWR_EN1 WLAN_PWR_EN2 WL_LAA_AS_EN WL_PA_MUTING WL_LAA_RX WL_LAA_TX_EN WL_TX_EN GND GND GND GND GND GND GND GND GND GND PCIe S2_1.2V S3_0.8V S4_1.9V 38.4MHz FG50V-TE-A GND GND GND GND GND GND GND GND GND GND GND PCIe S2_1.2V S3_0.8V S4_1.9V 38.4MHz J0702 Figure 30: Simplified FG50V-TE-A Interface Schematic 5G_EVB_User_Guide 32 / 38 5G/LTE-A Module Series 5G EVB User Guide Figure 31: Connection Between FG50V-TE-A and the EVB 3.13. Antenna Interfaces The 5G EVB includes twelve antenna interfaces. The following figure shows the assembly of these antenna interfaces. 5G_EVB_User_Guide Figure 32: Antenna Interfaces 33 / 38 5G/LTE-A Module Series 5G EVB User Guide 4 EVB Operation Procedures This chapter introduces how to use the 5G EVB for testing and evaluation of Quectel modules. 4.1. Turn on the Module 1. Connect the module TE-A to the EVB via connectors J0101 and J0102. 2. Insert a (U)SIM card into the USIM1 card connector on EVB. 3. Use RF cable to connect the module TE-A to the EVB, and connect antennas to the EVB. 4. Connect the EVB to a 5 V/ 3 A power, then switch S0301 to ON. Then D0201 (ON/OFF indicator of the module’s power supply) will light up. 5. Press the S0202 (PWRKEY) for at least 500ms, then the module will be powered on and D0202 (operation indicator of the module) will light up. 4.2. Communication via USB 1. Power on the module according to the procedure in Chapter 4.1. 2. Connect the EVB and a PC with USB cable through USB Type-C interface, and then run the driver disk on the PC to install the USB driver. For details about USB driver installation, please refer to document [1]. The USB port numbers can be viewed in Device Manager of the PC when the USB driver is installed, as shown below. 5G_EVB_User_Guide Figure 33: USB Ports 34 / 38 5G/LTE-A Module Series 5G EVB User Guide 3. Install and then use QCOM provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting of QCOM: select the correct 'COM Port' (USB AT Port, which is shown in figure above) and set correct 'Baudrate' (e.g. 115200 bps). For more details about QCOM usage and configuration, please refer to document [2]. Figure 34: COM Port Setting Field on QCOM (USB AT Port Connection) 4.3. Firmware Upgrade Firmware of the module is upgraded via USB port by default, and there are two methods for the upgrade: emergency download and normal download. Please refer to the following procedures to upgrade firmware through the EVB. 4.3.1. Emergency Download 1. Install the firmware upgrade tool QFlash on PC. 2. Connect the EVB and the PC through USB Type-C cable. 3. Press the USB_BOOT button (S0203). 4. Insert the DC power adapter and power on the module. 5. Upgrade the firmware with QFlash. Please refer to Quectel_QFlash_User_Guide for details about the use of QFlash. 5G_EVB_User_Guide 35 / 38 4.3.2. Normal Download 1. Turn on the module according to the procedure in Chapter 4.1. 2. Wait for the USB port to be found in Device Manage of the PC. 5G/LTE-A Module Series 5G EVB User Guide Figure 35: USB Port in PC Device Manage 3. Open QFlash and upgrade the firmware. Please refer to Quctel_QFlash_User_Guide for the detailed procedure. 4.4. Reset the Module The reset option is only used in case of abnormality. For example, the software fails to respond for more than 5 seconds due to some serious problems. Long press the button S0201 (RESET) for more than 8 seconds, and then release it to reset the module. 4.5. Turn off the Module There are two methods to turn off the module. ⚫ Turn off the module with AT command AT+QPOWD. This is a safer method. The module will log off from the network and save data before shutdown. ⚫ Turn off the module with PWRKEY button (S0301). Long press PWRKEY for at least 800 ms, then the module will be powered off. 5G_EVB_User_Guide 36 / 38 5G/LTE-A Module Series 5G EVB User Guide 5 Appendix A References Table 13: Related Documents SN Document Name Quectel_LTE&5G_Windows_USB_Driver_ [1] Installation _Guide [2] Quectel_QCOM_User_Guide [3] Quectel_QFlash_User_Guide Remark The installation guide of Windows USB drivers for Quectel LTE and 5G modules The user guide of QCOM The user guide of QFlash Table 14: Terms and Abbreviations Abbreviation AGND BTB COM DC DI DO eMMC EVB GND GNSS I/O LED Description Analog Ground Board to Board Cluster Communication Port Direct Current Digital Input Digital Output embedded Multi-Media Card Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode 5G_EVB_User_Guide 37 / 38 MIC NC PC PCB PCM PHY PO RF SD SIM UART USB (U)SIM 5G/LTE-A Module Series 5G EVB User Guide Microphone Not Connected Private Computer Printed Circuit Board Pulse Code Modulation Physical Layer Power Output Radio Frequency Secure Digital Subscriber Identity Module Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identity Module 5G_EVB_User_Guide 38 / 38

L80&L80-R&L86&LC86L EVB User Guide GNSS Module Series Version: 2.1 Date: 2021-11-24 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. L80&L80-R&L86&LC86L_EVB_User_Guide 1 / 24 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. L80&L80-R&L86&LC86L_EVB_User_Guide 2 / 24 GNSS Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service, or repair of any cellular terminal or mobile incorporating L80, L80-R, L86, LC86L modules. Manufacturers of the cellular terminal should distribute the following safety precautions to users and operating personnel, and incorporate them into all manuals supplied with the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Ensure the use of the product conforms to the local safety and environment regulations and is allowed to be used in the country and in the required environment. Keep away from explosive and flammable materials. The use of electronic products in extreme power supply conditions and locations with potentially explosive atmospheres may cause fire and explosion accidents. The product must be powered by a stable voltage source, while the wiring must comply with security precautions and fire safety regulations. Proper ESD handling procedures must be followed throughout the mounting, handling and operation of any devices and equipment incorporating the module to avoid ESD damages. L80&L80-R&L86&LC86L_EVB_User_Guide 3 / 24 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status L80&L80-R&L86&LC86L EVB User Guide GNSS Module Series EVB User Guide Released Revision History Version Date 1.0 2014-08-18 2.0 2020-12-22 2.1 2021-11-24 Description Initial 1. Incorporated the information of L80, L80-R and L86 EVB user guides (created separately years ago) into this manual. 2. Added the applicable module LC86L. Updated the overall structure of the document, including but not limited to the adding of Chapters 4, 5 and 6. L80&L80-R&L86&LC86L_EVB_User_Guide 4 / 24 GNSS Module Series Contents Safety Information .......................................................................................................................................3 About the Document ...................................................................................................................................4 Contents .......................................................................................................................................................5 Table Index...................................................................................................................................................6 Figure Index .................................................................................................................................................7 1 Introduction ..........................................................................................................................................8 2 General Overview.................................................................................................................................9 2.1. EVB Kit Accessories....................................................................................................................9 2.2. Connecting Cables and Antenna to EVB ..................................................................................10 3 Board User Interfaces........................................................................................................................11 3.1. EVB Top View............................................................................................................................11 3.2. EVB Interfaces ..........................................................................................................................12 4 Communicating via QCOM Tool.......................................................................................................14 4.1. Communicating via the Micro-USB Interface............................................................................14 5 Testing with QGNSS Tool .................................................................................................................16 5.1. COM Port and Baud Rate Setting.............................................................................................16 5.1.1. QGNSS Interface Explanation .......................................................................................17 6 Firmware Upgrade via QGPSFlashTool...........................................................................................20 6.1. Firmware Upgrading..................................................................................................................20 7 Appendix Reference ..........................................................................................................................23 L80&L80-R&L86&LC86L_EVB_User_Guide 5 / 24 GNSS Module Series Table Index Table 1: List of Accessories ........................................................................................................................ 10 Table 2: Detailed EVB Interfaces ............................................................................................................... 12 Table 3: J401 Pin Detailed Description ...................................................................................................... 13 Table 4: QGNSS Interface Explanation...................................................................................................... 17 Table 5: Related Documents ...................................................................................................................... 23 Table 6: Terms and Abbreviations .............................................................................................................. 23 L80&L80-R&L86&LC86L_EVB_User_Guide 6 / 24 GNSS Module Series Figure Index Figure 1: EVB Kit Accessories ..................................................................................................................... 9 Figure 2: EVB and Accessories Assembly ................................................................................................. 10 Figure 3: EVB Top View ..............................................................................................................................11 Figure 4: USB Port ..................................................................................................................................... 14 Figure 5: COM Port Setting Interface of QCOM ........................................................................................ 14 Figure 6: NMEA Sentences Output – Displayed on QCOM Tool Interface................................................ 15 Figure 7: QGNSS Setting ........................................................................................................................... 16 Figure 8: QGNSS Interface (Connected) ................................................................................................... 17 Figure 9: Firmware Upgrading – Step 1..................................................................................................... 20 Figure 10: Firmware Upgrading – Step 2................................................................................................... 21 Figure 11: Firmware Upgrading – Step 3................................................................................................... 21 Figure 12: Firmware Upgrading – Step 4................................................................................................... 22 Figure 13: Successful Firmware Upgrading............................................................................................... 22 L80&L80-R&L86&LC86L_EVB_User_Guide 7 / 24 GNSS Module Series 1 Introduction This document provides information on the steps needed to evaluate the Quectel L80, L80-R, L86 and LC86L modules using the Evaluation Board (EVB). The EVB is a convenient tool that allows you to become familiar with the modules. Specifically, the document is divided into several sections: ⚫ Chapter 2 provides the general overview of EVB Kit accessories; ⚫ Chapter 3 describes the EVB user interfaces; ⚫ Chapter 4 describes how to communicate with a module by using the QCOM tool; ⚫ Chapter 5 describes how to test the module by using the QGNSS tool; ⚫ Chapter 6 describes how to upgrade module firmware by using the QGPSFlashTool; ⚫ Chapter 7 is an appendix, which summarizes the relevant documents, terms, and abbreviations appearing herein. ⚫ NOTE For EVB schematic and PCB layout design files, contact Quectel Technical Supports (support@quectel.com). L80&L80-R&L86&LC86L_EVB_User_Guide 8 / 24 GNSS Module Series 2 General Overview 2.1. EVB Kit Accessories The EVB Kit includes: Evaluation Board (EVB), Active GNSS Antenna, Micro-USB Cable, Bolts and Coupling Nuts. You can download the software tools (QCOM, QGNSS, QGPSFlashTool) from our website Download Zone or request them from Quectel Technical Supports. The EVB Kit accessories are shown in the figure below. Check Table 1 for more information. GNSS antenna EVB Micro-USB cable Bolts and coupling nuts Figure 1: EVB Kit Accessories L80&L80-R&L86&LC86L_EVB_User_Guide 9 / 24 GNSS Module Series Table 1: List of Accessories Items EVB USB Cable GNSS Antenna Instruction Sheet Others Description Quantity Evaluation Board 1 Size: 80 mm × 100 mm Micro-USB Cable 1 Active GNSS Antenna 1 Request the Antenna Datasheet from Quectel Technical 1 Supports. The sheet provides instructions on how to connect the EVB and its accessories, detailed information on EVB 1 accessories, etc. Bolts and Coupling Nuts 4 pairs 2.2. Connecting Cables and Antenna to EVB The connection between the EVB and its accessories is shown in the figure below. For more information on how to connect the EVB and its accessories, refer to the instruction sheet inside the EVB Kit. Figure 2: EVB and Accessories Assembly NOTE Make sure that the Active GNSS Antenna is placed so as to have a clear unobstructed view of the sky. 1 As the L80-R module does not support an external antenna, the active antenna is not included in the EVB kit for L80-R. L80&L80-R&L86&LC86L_EVB_User_Guide 10 / 24 GNSS Module Series 3 Board User Interfaces 3.1. EVB Top View EVB top view is shown in the figure below. J403 Antenna connector U404 GNSS module EVB version S101 Power switch D307 AADET_N indication LED D303 1PPS indication LED D304 TXD indication LED J401 Test points S201 USB↔SD Switch J103 Micro-USB connector Figure 3: EVB Top View S301 RESET button S302 FORCE_ON button L80&L80-R&L86&LC86L_EVB_User_Guide 11 / 24 GNSS Module Series 3.2. EVB Interfaces The EVB interfaces are detailed in the table below. Table 2: Detailed EVB Interfaces Function Interfaces Description Power Supply Communication Interf ace RF Input Signal Indication Switches and Buttons J103 Micro-USB J103 Micro-USB J403 Antenna Connector 2 D303 1PPS Indication LED D304 TXD Indication LED D307 AADET_N Indication LED 4 S101 Power Switch S301 RESET S302 FORCE_ON 5 S201 USB↔SD Switch Power supply input: ⚫ DC power supply: 4.5–5.5 V, typ. 5.0 V ⚫ Current capability should be > 50 mA NMEA sentence output and command input The antenna in the Kit supports: ⚫ GPS L1 C/A ⚫ QZSS L1 C/A ⚫ Galileo E1 (For LC86L (C) only) ⚫ BeiDou B1I (For LC86L only) ⚫ GLONASS L1 3 ⚫ SBAS L1 Flashing: Successful position fix. Frequency: 1 Hz. Extinct: No position fix. Flashing: The module is turned on successfully. Data output from UART TXD pin. Extinct or Bright: Failed to turn on the module. Bright: External active antenna is being used. Extinct: Internal antenna is being used. Powers the EVB on/off. Short press the button to reset the module. Short press the button to wake up the module from the Backup mode. Switches the data communication port. Keep the switch on 'USB' side, as the modules do not support the SD-card function. 2 The antenna connector is invalid for the L80-R module, as the module does not support any external antenna. 3 GLONASS is not supported by L80 and L80-R modules. L80 and L80-R are GPS-only modules, and support GPS, QZSS, and SBAS constellations. 4 The L80-R does not support active antenna detection interface, so D307 is invalid on this module. 5 The L80 and L80-R modules do not support the FORCE_ON interface, so the FORCE_ON button is invalid on them. L80&L80-R&L86&LC86L_EVB_User_Guide 12 / 24 Test Points J401 Test Points Test point distribution is shown below: GNSS Module Series Pins are detailed in Table 3 below. J401 Pin Assignment RXD 3.0V TXD SCL 1PPS SDA RESET 3DFIX GND GND Table 3: J401 Pin Detailed Description Pin Name I/O 3.0V PI SCL I/O SDA I/O 3DFIX 6 DO GND - RXD DI TXD DO 1PPS DO RESET DI GND - Description Not used I2C serial clock I2C serial data 3D fix indication Ground Receives data Transmits data 1 pulse per second Resets the module Ground 6 For L80, L86, and L80-R EVBs, keep the test point (3DFIX) reserved. L80&L80-R&L86&LC86L_EVB_User_Guide 13 / 24 GNSS Module Series 4 Communicating via QCOM Tool This chapter explains how to use the QCOM tool to communicate with the modules via the Micro-USB interface. For more information about QCOM tool use, see document [1]. Download the QCOM tool from our website Download Zone or request it from Quectel Technical Supports. 4.1. Communicating via the Micro-USB Interface Step 1: Connect the EVB and the PC with a Micro-USB cable via the Micro-USB interface. Step 2: Flip the Power switch (S101) to ON position to power on the EVB. Step 3: Run the provided driver installer to install the USB driver. Step 4: View the USB port number in the Device Manager, as shown in the figure below. Figure 4: USB Port Step 5: Install the QCOM tool provided by Quectel. The QCOM tool interface for COM port setting is shown in the figure below. Figure 5: COM Port Setting Interface of QCOM Step 6: Select the correct 'COM Port' (USB Port shown in Figure 4 above). L80&L80-R&L86&LC86L_EVB_User_Guide 14 / 24 GNSS Module Series Step 7: Set the correct 'Baudrate' (default value: 9600 bps). Step 8: Click 'Open Port' to establish communication with the EVB. The NMEA sentences output by the modules will be displayed by the QCOM tool, as shown in the figure below. Figure 6: NMEA Sentences Output – Displayed on QCOM Tool Interface L80&L80-R&L86&LC86L_EVB_User_Guide 15 / 24 GNSS Module Series 5 Testing with QGNSS Tool This chapter explains how to use the QGNSS software tool for verifying the status of GNSS modules. For more information about QGNSS use, see document [2]. Download the QGNSS tool from our website Download Zone or request it from Quectel Technical Supports. 5.1. COM Port and Baud Rate Setting Step 1: Assemble the EVB accessories. Step 2: Flip the Power switch (S101) to ON position to power on the EVB. Step 3: Start the QGNSS and click 'Setting' and 'Serial Port Configuration' (the modules support 9600 bps by default). Figure 7: QGNSS Setting L80&L80-R&L86&LC86L_EVB_User_Guide 16 / 24 GNSS Module Series Step 4: Click the 'Connect or disconnect' button. The interface shown in the figure below appears once a module is connected. Figure 8: QGNSS Interface (Connected) 5.1.1. QGNSS Interface Explanation You can view GNSS information, such as CNR message, time, position, speed, and precision in the QGNSS interface. See the table below to find out more about these parameters. Table 4: QGNSS Interface Explanation Icon Explanation The sky view interface shows the position of the satellites in use. 1) The left column icons show the satellites in use and their numbers. ⚫ BDS (BeiDou): 4 ⚫ GLO (GLONASS): 0 ⚫ GPS: 11 ⚫ GAL (Galileo): 0 ⚫ QZSS: 0 ⚫ NavIC (IRNSS): 0 ⚫ SBAS: 0 2) The grid map on the right shows the position of the satellites in use. L80&L80-R&L86&LC86L_EVB_User_Guide 17 / 24 GPS satellite BeiDou satellite GLONASS satellite Galileo satellite QZSS satellite NAVIC satellite GNSS Module Series ⚫ PRN 30 CNR is 39 dB/Hz. ⚫ Column in bright red means that the navigation data of the satellite are in use. ⚫ PRN 1 CNR is 21 dB/Hz. ⚫ Column in light red means that the navigation data of this satellite are not in use. ⚫ Longitude (unit: degree) ⚫ Latitude (unit: degree) ⚫ Altitude (MSL) (unit: m) ⚫ Altitude (EPH) (unit: m) ⚫ Receiver speed (unit: km/h) ⚫ Horizontal dilution of precision ⚫ Position dilution of precision ⚫ Quality indicator: 2D/3D ⚫ UTC date and time ⚫ Time of day 7 (unit: second) ⚫ Age of differential GPS data ⚫ Last TTFF (unit: second) 7 Total number of seconds elapsed since midnight of the current day. L80&L80-R&L86&LC86L_EVB_User_Guide 18 / 24 ⚫ Total Times ⚫ Fixed Points ⚫ RTK Float ⚫ RTK Fixed GNSS Module Series L80&L80-R&L86&LC86L_EVB_User_Guide 19 / 24 GNSS Module Series 6 Firmware Upgrade via QGPSFlashTool Quectel L80, L80-R, L86 and LC86L modules upgrade firmware via the UART interface using QGPSFlashTool. For more information about QGPSFlashTool use, see document [3]. Download the QGPSFlashTool from our website Download Zone or request it from Quectel Technical Supports. 6.1. Firmware Upgrading Before you start the firmware upgrading process: First: Connect the EVB to a PC with a Micro-USB Cable. Second: Flip the Power switch (S101) to ON position to power on the EVB. Firmware upgrading steps: Step 1: Start the QGPSFlashTool. Click 'Config', then select 'Options' and the interface of QGPSFlashTool will pop up as shown in the figure below. Figure 9: Firmware Upgrading – Step 1 L80&L80-R&L86&LC86L_EVB_User_Guide 20 / 24 GNSS Module Series Step 2: In the 'Options' popup window, set the number of channels to be used. In the 'Tool Options' drop-down list, select the model name such as 'LC86L' 8, then click 'OK'. Figure 10: Firmware Upgrading – Step 2 Step 3: Double-click the 'ROM file' selection box to select the ROM file, e.g. 'LC86LICNR01A01S.bin', then double-click the 'DA File' selection box to select the DA file, e.g. 'MTK_AllInOne_DA_MT3333.bin', as shown the figure below. Figure 11: Firmware Upgrading – Step 3 Step 4: Select the 'Serial Port' and 'Baudrate' of the COM Port that will be used, then click the 'Start' button to start downloading the firmware. 8 For L80 and L80-R modules, select 'L80'; for L86 module, select 'L86'. L80&L80-R&L86&LC86L_EVB_User_Guide 21 / 24 GNSS Module Series Figure 12: Firmware Upgrading – Step 4 Step 5: Upon successful firmware upgrading, the QGPSFlashTool green progress bar on the screen will indicate 100 %, as shown in the figure below. Figure 13: Successful Firmware Upgrading L80&L80-R&L86&LC86L_EVB_User_Guide 22 / 24 7 Appendix Reference Table 5: Related Documents Document Name [1] Quectel_QCOM_User_Guide [2] Quectel_QGNSS_User_Guide [3] Quectel_QGPSFlashTool_User_Guide Table 6: Terms and Abbreviations Abbreviation Description 2D 2 Dimension 3D 3 Dimension BeiDou BeiDou Navigation Satellite System COM Port Communication Port CNR Carrier-to-Noise Ratio DC Direct Current DI Digital Input DO Digital Output ESD Electrostatic Discharge EVB Evaluation Board Galileo Galileo Satellite Navigation System (EU) GND Ground GNSS Global Navigation Satellite System L80&L80-R&L86&LC86L_EVB_User_Guide GNSS Module Series 23 / 24 GPS GLONASS I2C I/O LED LNA Micro-USB NMEA PC PCB 1PPS PRN QZSS RF RXD RTK SBAS SCL SDA TTFF TXD UART USB UTC Global Positioning System Global Navigation Satellite System (Russia) Inter-Integrated Circuit Input/Output Light Emitting Diode Low-Noise Amplifier Micro Universal Serial Bus National Marine Electronics Association Personal Computer Printed Circuit Board One Pulse Per Second Pseudorandom Noise Quasi-Zenith Satellite System Radio Frequency Receive Data (Pin) Real-Time Kinematic Satellite-Based Augmentation System Serial Clock Line Serial Data Line Time to First Fix Transmit Data (Pin) Universal Asynchronous Receiver/Transmitter Universal Serial Bus Coordinated Universal Time GNSS Module Series L80&L80-R&L86&LC86L_EVB_User_Guide 24 / 24

M.2 EVB User Guide LTE Module Series Rev: M.2_EVB_User_Guide_V1.0 Date: 2018-07-13 Status: Released www.quectel.com LTE Module Series M.2 EVB User Guide 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. M.2_EVB_User_Guide 1 / 37 LTE Module Series M.2 EVB User Guide About the Document History Revision 1.0 Date 2018-07-13 Author Storm BAO/ Claude WEI Description Initial M.2_EVB_User_Guide 1 / 37 LTE Module Series M.2 EVB User Guide Contents About the Document .................................................................................................................................. 1 Contents ...................................................................................................................................................... 3 Table Index.................................................................................................................................................. 4 Figure Index ................................................................................................................................................ 5 1 Introduction ......................................................................................................................................... 6 1.1. Safety Information ...................................................................................................................... 6 2 General Overview................................................................................................................................ 8 2.1. Key Features .............................................................................................................................. 8 2.2. Interface Overview ..................................................................................................................... 9 2.3. Top and Bottom Views of M.2 EVB...........................................................................................11 2.4. EVB Kit Accessories ................................................................................................................ 12 3 EVB Kit Accessories Assembly ...................................................................................................... 15 4 Application Interfaces ...................................................................................................................... 16 4.1. Power Interface (J101/J701).................................................................................................... 16 4.2. M.2 Interface (J501) ................................................................................................................. 17 4.3. USB Interface (J701) ............................................................................................................... 18 4.4. Audio Interfaces (J301/J302/J303) .......................................................................................... 19 4.4.1. Digital Audio Codec Board Interface (J301) ................................................................. 19 4.4.2. Earphone Interface (J302) ............................................................................................ 20 4.4.3. Handset Interface (J303) .............................................................................................. 22 4.5. (U)SIM Interfaces (J401/J402)................................................................................................. 23 4.6. Switches and Button ................................................................................................................ 25 4.7. Status Indication LEDs............................................................................................................. 25 4.8. Test Points................................................................................................................................ 26 5 Operation Procedures Illustration................................................................................................... 32 5.1. Power on the Module ............................................................................................................... 32 5.2. Communication via USB Type-C Interface .............................................................................. 33 5.3. Firmware Upgrade ................................................................................................................... 33 5.4. Reset the Module ..................................................................................................................... 34 5.5. Power off the Module ............................................................................................................... 35 5.6. Test Current Consumption ....................................................................................................... 35 6 Appendix A References.................................................................................................................... 37 M.2_EVB_User_Guide 3 / 37 LTE Module Series M.2 EVB User Guide Table Index TABLE 1: KEY FEATURES OF M.2 EVB ............................................................................................................ 8 TABLE 2: INTERFACES OF M.2 EVB................................................................................................................. 9 TABLE 3: ACCESSORIES LIST ........................................................................................................................ 13 TABLE 4: PIN ASSIGNMENT OF J701 ............................................................................................................. 18 TABLE 5: PIN DEFINITION OF J302 ................................................................................................................ 21 TABLE 6: PIN DEFINITION OF J303 ................................................................................................................ 23 TABLE 7: PIN ASSIGNMENTS OF J401/J402.................................................................................................. 24 TABLE 8: DESCRIPTION OF THE SWITCHES AND BUTTON ....................................................................... 25 TABLE 9: DESCRIPTION OF STATUS INDICATORS ...................................................................................... 26 TABLE 10: PIN DEFINITION OF J502 .............................................................................................................. 27 TABLE 11: PIN DEFINITION OF J503 .............................................................................................................. 28 TABLE 12: PIN DEFINITION OF J504 .............................................................................................................. 29 TABLE 13: PIN DEFINITION OF J505 .............................................................................................................. 29 TABLE 14: PIN DEFINITION OF J202 .............................................................................................................. 30 TABLE 15: PIN DEFINITION OF J601 .............................................................................................................. 30 TABLE 16: PIN DEFINITION OF J602 .............................................................................................................. 31 TABLE 17: PIN DEFINITION OF J603 .............................................................................................................. 31 TABLE 18: PIN DEFINITION OF J604 .............................................................................................................. 31 TABLE 19: INDICATION OF D101, D102 AND D103........................................................................................ 32 TABLE 20: RELATED DOCUMENTS ................................................................................................................ 37 TABLE 21: TERMS AND ABBREVIATIONS ...................................................................................................... 37 M.2_EVB_User_Guide 4 / 37 LTE Module Series M.2 EVB User Guide Figure Index FIGURE 1: M.2 EVB INTERFACE OVERVIEW .................................................................................................. 9 FIGURE 2: M.2 EVB TOP VIEW ........................................................................................................................11 FIGURE 3: M.2 EVB BOTTOM VIEW ............................................................................................................... 12 FIGURE 4: M.2 EVB KIT ACCESSORIES ........................................................................................................ 13 FIGURE 5: M.2 EVB KIT ACCESSORIES ASSEMBLY .................................................................................... 15 FIGURE 6: POWER SUPPLY FOR M.2 EVB.................................................................................................... 16 FIGURE 7: POWER INTERFACE ..................................................................................................................... 17 FIGURE 8: POWER PLUG DESIGN................................................................................................................. 17 FIGURE 9: CONNECTION BETWEEN THE MODULE AND EVB.................................................................... 18 FIGURE 10: USB TYPE-C INTERFACE CIRCUIT ........................................................................................... 19 FIGURE 11: REFERENCE DESIGN FOR CONNECTION BETWEEN CODEC BOARD AND EVB................ 20 FIGURE 12: CONNECTION BETWEEN CODEC BOARD AND EVB .............................................................. 20 FIGURE 13: REFERENCE CIRCUIT DESIGN FOR EARPHONE INTERFACE J302 ..................................... 21 FIGURE 14: PIN ASSIGNMENT OF J302......................................................................................................... 21 FIGURE 15: SKETCH OF AUDIO PLUG .......................................................................................................... 22 FIGURE 16: REFERENCE CIRCUIT DESIGN FOR HANDSET INTERFACE J303 ........................................ 22 FIGURE 17: PIN ASSIGNMENT OF J303......................................................................................................... 23 FIGURE 18: PIN ASSIGNMENTS OF J401/J402 ............................................................................................. 24 FIGURE 19: SWITCHES AND BUTTON........................................................................................................... 25 FIGURE 20: STATUS INDICATORS ................................................................................................................. 26 FIGURE 21: TEST POINT J502 ........................................................................................................................ 27 FIGURE 22: TEST POINTS J503, J504 AND J505........................................................................................... 28 FIGURE 23: TEST POINTS J202, J601, J602, J603 AND J604 ....................................................................... 30 FIGURE 24: USB PORTS ................................................................................................................................. 33 FIGURE 25: COM PORT SETTING FIELD ON QCOM (USB AT PORT CONNECTION) ................................ 33 FIGURE 26: CONFIGURATIONS FOR FIRMWARE UPGRADE ..................................................................... 34 FIGURE 27: LOCATION OF R607 .................................................................................................................... 35 FIGURE 28: LOCATION OF J603 AND J604.................................................................................................... 36 M.2_EVB_User_Guide 5 / 37 LTE Module Series M.2 EVB User Guide 1 Introduction This document describes how to use the M.2 EVB (Evaluation Board). It is an assistant tool for engineers to develop and test Quectel EM05 and EM06 modules, which are designed in M.2 form factor. 1.1. Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating EM05 and EM06 modules. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If the device offers an Airplane Mode, then it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on boarding the aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signals and cellular network cannot be guaranteed to connect in all possible conditions (for example, with unpaid bills or with an invalid (U)SIM card). When emergent help is needed in such conditions, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. M.2_EVB_User_Guide 6 / 37 LTE Module Series M.2 EVB User Guide The cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. M.2_EVB_User_Guide 7 / 37 LTE Module Series M.2 EVB User Guide 2 General Overview Quectel supplies M.2 EVB for designers to develop applications based on Quectel EM05 and EM06 modules. The EVB can test all functionalities of these modules. 2.1. Key Features The following table describes the detailed features of M.2 EVB. Table 1: Key Features of M.2 EVB Features Power Supply M.2 Interface USB Interfaces Audio Interface (U)SIM Interfaces Switches and Button Signal Indication Physical Characteristics Implementation DC power supply: 4.5V~5.5V, typically: 5.0V VBAT: 3.7V Standard PCI Express M.2 interface USB Type-C Support USB 2.0 & USB 3.0 ⚫ One digital audio codec board interface Support TI TLV320AIC3104 codec board ⚫ Two analog interfaces used for earphone and handset Support (U)SIM card: 3.0V and 1.8V Include USIM1 and USIM2 interfaces Support Dual SIM Single Standby* Switches: Power Switch (S101), PWRKEY (S103) and Switch between EM05 and EM06 modules (S701) Button: RESET (S102) 3 LEDs are available for signal indication Size: 122.0mm × 100.0mm M.2_EVB_User_Guide 8 / 37 2.2. Interface Overview LTE Module Series M.2 EVB User Guide J802 J801 Reserved J402 EM05/EM06 Module S701 USIM2 J501 J401 USIM1 1 COM Port 6 J201 J101 Power Supply 9 5 J502 POWER D101 S101 J202 J602 J603 J504 J503 J505 J601 J604 WAKEUP_HOST WWAN_LED D103 D102 J301 Codec Board Interface J701 S103 S102 J302 J303 Power Switch USB Type-C PWRKEY RESET Audio Interface Figure 1: M.2 EVB Interface Overview Table 2: Interfaces of M.2 EVB Interface Power Supply Power Switch PWRKEY RESET USB Type-C Reference No. J101 (bottom side) J701 S101 Description The power jack on the EVB. Typical supply voltage: +5V USB Type-C interface Typical supply voltage: +5V Power ON/OFF control S103 S102 J701 Turn on/off the module Reset button (push button) Used to reset the module USB device interface Can also be used to supply power for the EVB M.2_EVB_User_Guide 9 / 37 LTE Module Series M.2 EVB User Guide Audio (U)SIM COM Port Status Indication LEDs M.2 Switches Connectors Test points J302 J303 (bottom side) J301 Used for earphone Used to test the analog audio function of the module Used for handset Used to test the analog audio function of the module Codec board interface J401 (bottom side) J402 (bottom side) J201 (bottom side) D101, D102, D103 J501 (U)SIM card connector 1 (U)SIM card connector 2 (Not applicable to EM05 module) Debug UART port (only for internal debugging by Quectel) D101 (Power ON/OFF indicator) is used to indicate power ON/OFF status of the EVB D102 is used to indicate whether RF is capable of transmitting D103 is used to indicate a URC reporting which could wake up the module M.2 standard connector for the module S701 J501 J801, J802 J202, J502-J505, J601-J604 Switch for controlling EM05 or EM06 module J501 is M.2 module connector J801 and J802 are reserved for future use Test pins M.2_EVB_User_Guide 10 / 37 LTE Module Series M.2 EVB User Guide 2.3. Top and Bottom Views of M.2 EVB The top and bottom views of the M.2 EVB are shown as following figures. Figure 2: M.2 EVB Top View M.2_EVB_User_Guide 11 / 37 LTE Module Series M.2 EVB User Guide Figure 3: M.2 EVB Bottom View 2.4. EVB Kit Accessories All accessories of the M.2 EVB kit are listed as below. M.2_EVB_User_Guide 12 / 37 RF Cables GNSS Antenna Main Antennas LTE Module Series M.2 EVB User Guide Earphone Codec Board USB to RS-232 Driver Disk Instruction Sheet USB Driver Disk USB Type-C Cable USB to RS-232 Converter Cable Figure 4: M.2 EVB Kit Accessories Bolts and Nuts Table 3: Accessories List Items Cables Antennas Audio Disks Codec Board Others Description USB type-C cable USB to UART converter cable RF cables Main antennas GNSS antenna (passive) Earphone USB 2.0 to RS-232 driver and USB driver disk TLV320AIC3104 codec board Bolts and coupling nuts for assembling EVB Quantity 1 1 3 2 1 1 2 1 4 for each type M.2_EVB_User_Guide 13 / 37 Instruction Sheet LTE Module Series M.2 EVB User Guide A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. NOTE The main antenna can also be used for diversity reception. M.2_EVB_User_Guide 14 / 37 LTE Module Series M.2 EVB User Guide 3 EVB Kit Accessories Assembly The following figure shows the EVB kit accessories assembly. Figure 5: M.2 EVB Kit Accessories Assembly M.2_EVB_User_Guide 15 / 37 LTE Module Series M.2 EVB User Guide 4 Application Interfaces This chapter describes the hardware interfaces of M.2 EVB, shown as follows: ⚫ Power interface ⚫ M.2 interface ⚫ USB interface ⚫ Audio interfaces ⚫ (U)SIM interface It also provides information about button, switches, status indication LEDs and test points to help customers use the M.2 EVB. 4.1. Power Interface (J101/J701) The M.2 EVB can be powered by an external power adapter through connecting with the power jack (J101) or USB receptacle (J701) on the EVB. The power adapter connects to a step-down converter which can provide the supply voltage (VBAT) required for operating the EVB and the module. The following two figures show the simplified power supply schematic and the power interface of the M.2 EVB. S101 Power switch U101 U103 VBAT Power supply for the module 1.8V J101 J701 U102 3.3V Power supply USB Type-C interface Step-down converter Figure 6: Power Supply for M.2 EVB M.2_EVB_User_Guide 16 / 37 LTE Module Series M.2 EVB User Guide 5V DC power supply Figure 7: Power Interface Before connecting the power supply, customers have to select a proper DC power adapter to supply power for the M.2 EVB, and the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 8: Power Plug Design 4.2. M.2 Interface (J501) The M.2 interface is designed to accommodate the EM05 and EM06 modules. The module is connected to the EVB via BTB connectors J501. The interface allows customers to easily test the functionalities of EM05 and EM06 modules or develop applications based on the module. The following figure shows the connection between the module and the EVB M.2_EVB_User_Guide 17 / 37 LTE Module Series M.2 EVB User Guide Figure 9: Connection between the Module and EVB 4.3. USB Interface (J701) The USB interface of EM05 complies with USB 2.0 specification, and that of EM06 complies with USB 2.0 and USB 3.0 specifications. USB 3.0 supports super speed (5Gbps) mode, and USB 2.0 supports high speed (480 Mbps) and full speed (12 Mbps) modes. The USB interface is used for AT command communication, data transmission, GNSS NMEA output, software debugging, firmware upgrade and voice over USB*1). The M.2 EVB provides a USB Type-C interface J701 for connection with a host device. The USB data lines D+ and D- are connected directly to the EM06 module. The CC1 and CC2 lines can be used for Type-C configuration channel signals. The VBUS lines can be used for USB connection detection and EVB power supply. Table 4: Pin Assignment of J701 A1 A2 A3 A4 A5 A6 A7 A8 A9 A10 A11 A12 GND TX1+ TX1- VBUS CC1 D+ D- SBU1 VBUS RX2- RX2+ GND GND RX1+ RX1- VBUS SBU2 D- D+ CC2 VBUS TX2- TX2+ GND B12 B11 B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 M.2_EVB_User_Guide 18 / 37 LTE Module Series M.2 EVB User Guide The following figure is a reference circuit design for the USB Type-C device interface. Module USB_SS_TX_M USB_SS_TX_P USB_SS_RX_M USB_SS_RX_P USB_DP USB_DM U301 HS3SS3220 TXN TXP RXN RXP R1 0R TX1+ TX1RX1+ RX1TX2+ TX2RX2+ RX2CC1 CC2 R2 0R C1 100nF C2 100nF C3 100nF C4 100nF C5 100nF C6 100nF C7 100nF C8 100nF ESD U701 USB Type-C TX1+ TX1RX1+ RX1TX2+ TX2RX2+ RX2CC1 CC2 USB_D+ USB_D- Figure 10: USB Type-C Interface Circuit NOTE 1. '*' means under development. 2. 1) The USB interface of EM05 does not support voice over USB function. 4.4. Audio Interfaces (J301/J302/J303) Quectel M.2 EVB provides one digital audio codec board interface (PCM) J301 and two analog audio interfaces J302 and J303. This chapter gives a detailed introduction on these audio interfaces. 4.4.1. Digital Audio Codec Board Interface (J301) The M.2 EVB supports the external digital audio codec of TLV320AIC3104. The codec circuit is assembled on an independent small board which can be interconnected with EVB by the BTB connector J301. The following figures show a reference design for the connection between digital audio codec board and the EVB. M.2_EVB_User_Guide 19 / 37 LTE Module Series M.2 EVB User Guide 4.7K 4.7K MIC_BIAS Module PCM_CLK PCM_SYNC PCM_OUT PCM_IN I2C_SCL I2C_SDA BTB CON TLV3104 BTB CON R MIC_BIAS BCLK IN2P IN2N C U101 LRCK HPO_L DACDAT1 HPO_R ADCDAT1 SCL SDA LOUDL/P LOUDR/N J301 VDD_EXT J301 J303 MIC 1 4 6 5 J302 3 2 Figure 11: Reference Design for Connection between Codec Board and EVB Figure 12: Connection between Codec Board and EVB 4.4.2. Earphone Interface (J302) Audio interface J302 is designed for earphones. A reference circuit design for the interface is shown as following figure. M.2_EVB_User_Guide 20 / 37 LTE Module Series M.2 EVB User Guide U101 Differential layout J301 MIC_N MIC_P Close to Socket GND AGND GND GND GND 10pF 33pF 4.7uF75pF 15pF ESD AGND Codec TE-A 22uF 22uF AGND SPK_L SPK_R BTB CON Close to Socket 10pF 33pF 10pF 33pF ESD GND 0R NM_0R 2 4 6 5 3 1 J302 Audio Jack NM_0R 0R AGND MIC_P Figure 13: Reference Circuit Design for Earphone Interface J302 The figure and table below illustrate the pin assignment and definition of earphone interface J302. 6 5 4 3 2 1 Figure 14: Pin Assignment of J302 Table 5: Pin Definition of J302 Pin No. 1 Pin Name MIC_P Description Microphone input-positive M.2_EVB_User_Guide 21 / 37 LTE Module Series M.2 EVB User Guide 2 AGND 3 SPK_R 4 SPK_L 5, 6 NC Dedicated GND for audio Right channel of stereo audio output Left channel of stereo audio output Not connected The following figure shows the sketch design of audio plug which suits for the audio jack on M.2 EVB. 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 15: Sketch of Audio Plug 4.4.3. Handset Interface (J303) Audio interface J303 is designed for handsets. A reference circuit design for handset interfaces J303 is shown below. U101 Codec TE-A IN2P IN2N LOUDL/P LOUDR/N J301 FB BTB CON 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD J303 4 1 3 2 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD Figure 16: Reference Circuit Design for Handset Interface J303 M.2_EVB_User_Guide 22 / 37 LTE Module Series M.2 EVB User Guide The figure and table below illustrate the pin assignment and definition of handset interface J303. 4 2 31 Figure 17: Pin Assignment of J303 Table 6: Pin Definition of J303 Pin No. 1 2 3 4 Pin Name MICN SPKN SPKP MICP Function Negative microphone input Negative loudspeaker output Positive loudspeaker output Positive microphone input 4.5. (U)SIM Interfaces (J401/J402) The M.2 EVB has two 8-pin push-push type (U)SIM card (3.0V or 1.8V) connector J401 and J402. Both of them can be used for EM06 module, and EM06 supports Dual SIM Single Standby* function. The J402 is not applicable for EM05 module. The following figure shows the pin assignment and definition of J401/J402. M.2_EVB_User_Guide 23 / 37 LTE Module Series M.2 EVB User Guide J402 CD1 CD2 C3 C7 C2 C6 C1 C5 J401 CD1 CD2 C3 C7 C2 C6 C1 C5 Figure 18: Pin Assignments of J401/J402 Table 7: Pin Assignments of J401/J402 Pin No. Signal Name I/O C1 SIM_VDD PO C2 SIM_RST DO C3 SIM_CLK DO C5 GND / C6 VPP / C7 SIM_DATA I/O CD1 / / CD2 SIM_PRESENCE I/O Description (U)SIM card power supply, provided by M.2 EVB (U)SIM card reset (U)SIM card clock Ground Not connected Data line, bi-directional (U)SIM card insertion detection (U)SIM card insertion detection When the (U)SIM card is present, it is at high level (pulled up to 1.8V). When the (U)SIM card is absent, it is at low level. M.2_EVB_User_Guide 24 / 37 LTE Module Series M.2 EVB User Guide 4.6. Switches and Button The M.2 EVB includes three switches S101/S103/S701 and a button S102, as shown in the following figure. S101 S103 S102 S701 Figure 19: Switches and Button Table 8: Description of the Switches and Button Reference No. S701 S101 S103 S102 Description Used to switch between EM05 and EM06 modules Power ON/OFF control Used to turn on/off the module Used to reset the module 4.7. Status Indication LEDs The M.2 EVB includes three status indication LEDs (D101, D102 and D103). The following figure shows the location of these LED indicators. M.2_EVB_User_Guide 25 / 37 LTE Module Series M.2 EVB User Guide D101 D103 D102 Figure 20: Status Indicators Table 9: Description of Status Indicators Reference No. D101 D103 D102 Description Power ON/OFF indicator indicating the power supply status of the EVB Bright: the module is powered on Extinct: the power is powered off Operation status indicator for the module When a URC returns, a 1s low level pulse will be outputted Used to indicate a URC reporting which could wake up the module Bright: A call, SMS message or data is coming, the module is woken up Extinct: the module is in idle or sleep mode RF status indicator for the module Bright: RF function is enabled Extinct: RF function is disabled 4.8. Test Points The M.2 EVB provides a series of test points. They can help customers to obtain the corresponding waveform of some signals. The following figures and tables show test points J502, J503, J504, J505, J202, J601, J602, J603 and J604. M.2_EVB_User_Guide 26 / 37 LTE Module Series M.2 EVB User Guide J502 15 13 11 9 7 5 3 1 16 14 12 10 8 6 4 2 Figure 21: Test Point J502 Table 10: Pin Definition of J502 Pin No. 1 2 3 4 5 6 7 8 9 10 11 12 Pin Name DTR GNSS_IRQ DTR W_DIS2 DTR W_DIS1 DTR N_RESET DTR P_OFF DTR P_EN Description Data terminal ready test pin GNSS_IRQ test pin Data terminal ready test pin GPS control test pin Data terminal ready test pin Airplane mode control test pin Data terminal ready test pin Module reset test pin Data terminal ready test pin A signal control to power on/off the module Data terminal ready test pin Module power supply enable pin M.2_EVB_User_Guide 27 / 37 13 DTR 14 DPR 15 / 16 / LTE Module Series M.2 EVB User Guide Data terminal ready test pin Dynamic power control test pin Not connected Not connected 7 6 5 4 3 2 1 J504 7 6 5 4 3 2 1 J503 7 6 5 4 3 2 1 J505 Figure 22: Test Points J503, J504 and J505 Table 11: Pin Definition of J503 Pin No. 1 2 3 4 5 6 Pin Name VBAT COEX3 COEX2 COEX1 SIM2_VDD GND Description Module power supply test pin Connected directly to pin 60 of EM06 module Connected directly to pin 62 of EM06 module Connected directly to pin 64 of EM06 module Power supply for (U)SIM2 card test pin Ground M.2_EVB_User_Guide 28 / 37 7 GND Ground LTE Module Series M.2 EVB User Guide Table 12: Pin Definition of J504 Pin No. 1 2 3 4 5 6 7 Pin Name ANT0 ANT1 ANT2 OTG_PWR_EN USB_ID SYS_CLK VDD_EXT/GPIO3 Description Tunable antenna control Tunable antenna control Tunable antenna control USB power supply enable pin USB_ID test pin PCM interface clock signal test pin Tunable antenna control Table 13: Pin Definition of J505 Pin No. 1 2 3 4 5 6 7 Pin Name VBAT LED# WAKEUP#HOST NC6 RESET GND GND Description Module power supply test pin WWAN status indicators test pin A signal to wake up the host Not connected System reset test pin Ground Ground M.2_EVB_User_Guide 29 / 37 LTE Module Series M.2 EVB User Guide 1 2 J202 J602 1 2 1 2 J601 J603 1 2 1 2 J604 Figure 23: Test Points J202, J601, J602, J603 and J604 Table 14: Pin Definition of J202 Pin No. 1 2 Pin Name DEBUG_TXD_1V8 DEBUG_RXD_1V8 Description DEBUG_TXD_1V8 test pin DEBUG_RXD_1V8 test pin Table 15: Pin Definition of J601 Pin No. 1 2 Pin Name DETECT_1 GND Description Module insertion detection pin Ground M.2_EVB_User_Guide 30 / 37 Table 16: Pin Definition of J602 Pin No. 1 2 Pin Name DETECT_2 GND Table 17: Pin Definition of J603 Pin No. 1 2 Pin Name VCC VBAT Table 18: Pin Definition of J604 Pin No. 1 2 Pin Name VBAT GND LTE Module Series M.2 EVB User Guide Description Module insertion detection pin Ground Description Module power supply test pin Module power supply test pin Description Module power supply test pin Ground M.2_EVB_User_Guide 31 / 37 LTE Module Series M.2 EVB User Guide 5 Operation Procedures Illustration This chapter introduces how to use the M.2 EVB for testing and evaluation of Quectel EM05 and EM06 modules. 5.1. Power on the Module 1. Connect the module to the EVB. Insert the module into the connectors (J501) on EVB, and then fix the other end of the module with screws. 2. Insert a (U)SIM card into the (U)SIM card connector on EVB and connect the antennas to the module. 3. Connect the EVB to a 5V power adapter or connect the EVB to PC via USB Type-C cable. 4. Switch S101 (Power Switch) to ON state, then the D101 (Power ON/OFF indicator) will light up, which indicates that the power supply for the EVB is ready. In such case, switch S103 (PWRKEY) to ON state, the module will be powered on automatically and then D102 (WWAN_LED) will be light up when RF function is enabled. Table 19: Indication of D101, D102 and D103 Reference Number D101 D102 State Always ON Always OFF Always ON Always OFF D103 Always ON Always OFF Description VBAT ON VBAT OFF RF function is enabled RF function is disabled A call, SMS message or data is coming, the module is woken up The module is in idle or sleep mode M.2_EVB_User_Guide 32 / 37 LTE Module Series M.2 EVB User Guide 5.2. Communication via USB Type-C Interface 1. Power on the module according to the procedure mentioned in Chapter 5.1. 2. Connect the EVB and the PC with USB cable through USB Type-C interface, and then run the driver disk on PC to install the USB driver. For details about USB driver installation, please refer to document [1]. Figure 24: USB Ports 3. Install and then use the QCOM tool provided by Quectel to realize communication between the module and the PC. The following figure shows the COM Port Setting field on QCOM: select correct 'COM Port' (USB AT Port which is shown in above figure) and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [4]. Figure 25: COM Port Setting Field on QCOM (USB AT Port Connection) 5.3. Firmware Upgrade The firmware of the module is upgraded via USB port by default. Please follow the procedures below to upgrade the firmware. 1. Install and open the firmware upgrade tool QFlash on PC, and then power on the module according to the procedure mentioned in Chapter 5.1. 2. Click the 'COM Port' dropdown list and select the USB DM port. M.2_EVB_User_Guide 33 / 37 3. Click the 'Load FW Files' button to choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. LTE Module Series M.2 EVB User Guide Figure 26: Configurations for Firmware Upgrade For more details about QFlash tool usage and configuration, please refer to document [5]. 5.4. Reset the Module The emergency reset option is only used in case of emergency. For example, the software does not respond for more than 5s due to some serious problems. Press the button S102 (RESET) for 250ms~600ms for EM06 module or 150ms~460ms for EM05 module, then release it to reset the module. However, this operation may cause the loss of information stored in the memory as the reset module has been initialized. NOTE The time for pressing the RESET button cannot exceed the maximum values, otherwise the module will be powered off. M.2_EVB_User_Guide 34 / 37 LTE Module Series M.2 EVB User Guide 5.5. Power off the Module There are two ways to power off the module. ⚫ Hardware shutdown: Switch the S103 to OFF state, the module will be powered off. ⚫ Software shutdown: Turn off the module using AT+QPOWD command. NOTE Please refer to document [2] for details about AT+QPOWD command. 5.6. Test Current Consumption The M.2 EVB can also be used to test the current consumption of the module after making the following modifications. 1. Remove R607. Figure 27: Location of R607 M.2_EVB_User_Guide 35 / 37 LTE Module Series M.2 EVB User Guide Connect an external power supply to J603 or J604 (either of them) to supply power for the module independently. Figure 28: Location of J603 and J604 2. Power on the module according to the procedure mentioned in Chapter 5.1 and then test the current consumption of the module. M.2_EVB_User_Guide 36 / 37 LTE Module Series M.2 EVB User Guide 6 Appendix A References Table 20: Related Documents SN Document Name Quectel_LTE_Windows_USB_Drivers_Installation_ [1] Guide [2] Quectel_xx_AT_Commands_Manual [3] Quectel_xx_Hardware_Design [4] Quectel_QCOM_User_Guide Remark Install USB drivers for M.2 module on Windows system Respective AT commands manual for EM05 and EM06 modules Respective hardware design for EM05 and EM06 modules User guide for QCOM tool [5] Quectel_QFlash_User_Guide User guide for QFlash tool Table 21: Terms and Abbreviations Abbreviation COM DC DO GND I/O LED PO (U)SIM VBAT Description Cluster Communication Port Direct Current Digital Output Ground Input/Output Light Emitting Diode Power Output (Universal) Mobile Telecommunication System Voltage of Battery M.2_EVB_User_Guide 37 / 37

EPXX EVB User Guide LTE-A Module Series Rev. EPXX_EVB_User_Guide_V1.0 Date: 2018-02-01 Status: Released www.quectel.com LTE-A Module Series EPXX EVB User Guide 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 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. EPXX_EVB_User_Guide 1 / 34 LTE-A Module Series EPXX EVB User Guide About the Document History Revision 1.0 Date 2018-02-01 Author Vae LIU Description Initial EPXX_EVB_User_Guide 2 / 34 LTE-A Module Series EPXX EVB User Guide Contents About the Document .................................................................................................................................. 2 Contents ...................................................................................................................................................... 3 Table Index.................................................................................................................................................. 4 Figure Index ................................................................................................................................................ 5 1 Introduction ......................................................................................................................................... 6 1.1. Safety Information .................................................................................................................. 6 2 General Overview................................................................................................................................ 8 2.1. Key Features .......................................................................................................................... 8 2.2. Interface Overview.................................................................................................................. 9 2.3. Top View of EVB .................................................................................................................. 11 2.4. Bottom View of EVB ............................................................................................................. 12 2.5. EVB Kit Accessories............................................................................................................. 13 3 EVB Kit Accessories Assembly ...................................................................................................... 15 4 Interface Application ........................................................................................................................ 16 4.1. Power Interface (J201/J301) ................................................................................................ 16 4.2. Mini PCIe Interface (J103/J104)........................................................................................... 17 4.3. USB Interface (J301) ............................................................................................................ 18 4.4. Audio Interfaces.................................................................................................................... 19 4.4.1. Digital Audio Codec Board Interface (J501) ................................................................. 19 4.4.2. Analog Audio Codec Board Interface (J601/J602) ....................................................... 21 4.4.2.1. Handset Interface (J601) ...................................................................................... 21 4.4.2.2. Earphone Interface (J602).................................................................................... 22 4.5. (U)SIM Interfaces (J402/J403) ............................................................................................. 24 4.6. Switch and Button................................................................................................................. 25 4.7. Status Indicators................................................................................................................... 26 4.8. Test Points............................................................................................................................ 27 5 Operation Procedures Illustration................................................................................................... 30 5.1. Power on EP06 Module........................................................................................................ 30 5.2. Communication Via USB Interface....................................................................................... 30 5.3. Firmware Upgrade................................................................................................................ 31 5.4. Reset EP06 Module ............................................................................................................. 32 5.5. Power off EP06 Module........................................................................................................ 32 6 Appendix A References.................................................................................................................... 33 EPXX_EVB_User_Guide 3 / 34 LTE-A Module Series EPXX EVB User Guide Table Index TABLE 1: KEY FEATURES OF EPXX EVB ........................................................................................................ 8 TABLE 2: INTERFACES OF EPXX EVB............................................................................................................. 9 TABLE 3: ACCESSORIES LIST........................................................................................................................ 13 TABLE 4: PIN ASSIGNMENT OF J301............................................................................................................. 18 TABLE 5: PIN DEFINITION OF J601 ................................................................................................................ 22 TABLE 6: PIN DEFINITION OF J602 ................................................................................................................ 23 TABLE 7: PIN DEFINITION OF J402 ................................................................................................................ 25 TABLE 8: DESCRIPTION OF SWITCH AND BUTTON.................................................................................... 26 TABLE 9: DESCRIPTION OF STATUS INDICATORS ..................................................................................... 27 TABLE 10: PIN DEFINITION OF J101 .............................................................................................................. 27 TABLE 11: PIN DEFINITION OF J102 .............................................................................................................. 28 TABLE 12: PIN DEFINITION OF J203 AND J204 ............................................................................................ 29 TABLE 13: RELATED DOCUMENTS ............................................................................................................... 33 TABLE 14: TERMS AND ABBREVIATIONS ..................................................................................................... 33 EPXX_EVB_User_Guide 4 / 34 LTE-A Module Series EPXX EVB User Guide Figure Index FIGURE 1: EPXX EVB INTERFACE OVERVIEW .............................................................................................. 9 FIGURE 2: EPXX EVB TOP VIEW.................................................................................................................... 11 FIGURE 3: EPXX EVB BOTTOM VIEW............................................................................................................ 12 FIGURE 4: EVB KIT ACCESSORIES ............................................................................................................... 13 FIGURE 5: EPXX EVB KIT ACCESSORIES ASSEMBLY ................................................................................ 15 FIGURE 6: POWER SUPPLY FOR EPXX EVB................................................................................................ 16 FIGURE 7: POWER INTERFACE ..................................................................................................................... 17 FIGURE 8: POWER PLUG DESIGN................................................................................................................. 17 FIGURE 9: CONNECTION BETWEEN EP06 AND EVB .................................................................................. 18 FIGURE 10: USB TYPE-C INTERFACE CIRCUIT ........................................................................................... 19 FIGURE 11: REFERENCE DESIGN FOR CONNECTION BETWEEN CODEC BOARD AND EVB ............... 20 FIGURE 12: CONNECTION BETWEEN CODEC BOARD AND EVB .............................................................. 20 FIGURE 13: REFERENCE CIRCUIT DESIGN FOR HANDSET INTERFACE J601 ........................................ 21 FIGURE 14: PIN ASSIGNMENTS OF J601 ...................................................................................................... 21 FIGURE 15: REFERENCE CIRCUIT DESIGN FOR EARPHONE INTERFACE J602 ..................................... 22 FIGURE 16: PIN ASSIGNMENTS OF J602 ...................................................................................................... 23 FIGURE 17: SKETCH OF AUDIO PLUG .......................................................................................................... 24 FIGURE 18: SIMPLIFIED INTERFACE SCHEMATIC FOR (U)SIM CARD CONNECTOR J402..................... 24 FIGURE 19: PIN ASSIGNMENTS OF J402 ...................................................................................................... 25 FIGURE 20: S201 SWITCH AND S101 BUTTON ............................................................................................ 26 FIGURE 21: STATUS INDICATORS................................................................................................................. 26 FIGURE 22: TEST POINTS J101...................................................................................................................... 27 FIGURE 23: TEST POINT J102 ........................................................................................................................ 28 FIGURE 24: TEST POINTS J203 AND J204 .................................................................................................... 29 FIGURE 25: USB PORTS ................................................................................................................................. 30 FIGURE 26: COM PORT SETTING FIELD ON QCOM .................................................................................... 31 FIGURE 27: QFLASH CONFIGURATIONS FOR FIRMWARE UPGRADE...................................................... 31 EPXX_EVB_User_Guide 5 / 34 LTE-A Module Series EPXX EVB User Guide 1 Introduction This document describes how to use EPXX EVB (Evaluation Board). It is an assistant tool for engineers to develop and test Quectel EP06 module. 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating EP06 module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for the customers’ failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as to prevent interference with communication systems. Consult the airline staff about the use of wireless devices on boarding the aircraft, if your device offers an Airplane Mode which must be enabled prior to boarding an aircraft. Switch off your wireless device when in hospitals, clinics or other health care facilities. These requests are designed to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid (U)SIM card. While you are in this condition and need emergent help, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. EPXX_EVB_User_Guide 6 / 34 LTE-A Module Series EPXX EVB User Guide Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency energy. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. EPXX_EVB_User_Guide 7 / 34 LTE-A Module Series EPXX EVB User Guide 2 General Overview Quectel supplies EPXX EVB for designers to develop applications based on Quectel EP06 module. This EVB can test basic functionalities of the module. 2.1. Key Features The following table describes the detailed features of EPXX EVB. Table 1: Key Features of EPXX EVB Features Power Supply Mini PCIe Interface (U)SIM Interfaces Audio Interfaces USB Interfaces Switch and Button Physical Characteristics Implementation  DC power supply: 4.5V~5.5V, typically: 5.0V  VBAT: 3.3V for J204  Support Quectel EP06 module  Support (U)SIM card: 3.0V and 1.8V  Include two (U)SIM interfaces  One digital audio codec board interface Support TI TLV320AIC3104 codec board  Two analog interfaces used for earphone and handset  USB Type-C (USB 2.0 & USB 3.0)  Power switch (S201) for VBAT ON/OFF control  Reset button (S101) for resetting EP06 module  Size: 122.0mm × 100.0mm EPXX_EVB_User_Guide 8 / 34 2.2. Interface Overview LTE-A Module Series EPXX EVB User Guide J104 J403 (U)SIM Card Connector 100mm J702 J701 Mini PCIe Interface J402 (U)SIM Card Connector J401 COM J101 J102 Test Points Test Points Test Points Test Points J203 J204 J201 Power Supply S201 Power Switch USB Type-C Interface J301 J103 Test Points J105 D10 D10 1 2 S101 RESET 122mm J601 Handset Figure 1: EPXX EVB Interface Overview Codec Board Interface J501 J602 Earphone Table 2: Interfaces of EPXX EVB Interface Power Supply Reference No. J201 (bottom side) J301 Power Switch S201 RESET S101 Description The power jack on the EVB Typical supply voltage: +5V USB Type-C interface Typical supply voltage: +5V VBAT ON/OFF control Reset button (push button) Used to reset the EP06 module EPXX_EVB_User_Guide 9 / 34 USB Type-C Audio (U)SIM COM Status Indicators J301 J501 J601 (bottom side) J602 J402 (bottom side) J403 (bottom side) J401 (bottom side) D101, D102 Mini PCIe Test Points J103, J104 J101, J102, J105, J203, J204 LTE-A Module Series EPXX EVB User Guide USB device interface Can also be used to supply power for EVB Codec board interface Used for handset Used to test the analog audio function of EP06 module Used for earphone Used to test the analog audio function of EP06 module U(SIM) card connector 1 U(SIM) card connector 2 Main/debug UART port D101 (VBAT ON/OFF indicator) is used to indicate whether the power supply for EG06 module is ready. D102 (power ON/OFF indicator) is used to indicate whether EG06 module is powered on. Mini PCIe Express connectors of EP06 module Test pins EPXX_EVB_User_Guide 10 / 34 2.3. Top View of EVB The top view of EPXX EVB is shown as following figure. LTE-A Module Series EPXX EVB User Guide Figure 2: EPXX EVB Top View EPXX_EVB_User_Guide 11 / 34 2.4. Bottom View of EVB The bottom view of the EPXX EVB is shown as following figure. LTE-A Module Series EPXX EVB User Guide Figure 3: EPXX EVB Bottom View EPXX_EVB_User_Guide 12 / 34 2.5. EVB Kit Accessories All accessories of the EPXX EVB kit are listed as below. LTE-A Module Series EPXX EVB User Guide USB to RS-232 Converter Cable and Driver Disk USB Type-C Cable GNSS Antenna Instruction Sheet Main Antennas Bolts and Nuts Earphone RF Cables Driver Disk Codec Board Figure 4: EVB Kit Accessories Table 3: Accessories List Items Cables Antennas Description USB to UART converter cable USB Type-C cable RF cables Main Antennas GNSS antenna (passive) Quantity 1 1 3 2 1 EPXX_EVB_User_Guide 13 / 34 LTE-A Module Series EPXX EVB User Guide Audio Disks Codec Boards Others Instruction Sheet Earphone 1 USB 2.0 to RS-232 driver and USB driver disk 2 TLV320AIC3104 codec board 1 Bolts and coupling nuts for assembling EVB 4 for each type A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. NOTE The main antenna can also be used for diversity reception. EPXX_EVB_User_Guide 14 / 34 LTE-A Module Series EPXX EVB User Guide 3 EVB Kit Accessories Assembly The following figure shows the EVB kit accessories assembly. Figure 5: EPXX EVB Kit Accessories Assembly EPXX_EVB_User_Guide 15 / 34 LTE-A Module Series EPXX EVB User Guide 4 Interface Application This chapter describes the hardware interfaces of EPXX EVB, shown as follows:  Power interface  Mini PCIe interface  USB interface  Audio interfaces  (U)SIM card interfaces It also provides information about button, switch, status indicators and test points to help customers use the EPXX EVB. 4.1. Power Interface (J201/J301) The EPXX EVB can be powered by an external power adapter through connecting with the power jack (J201) or USB Type-C receptacle (J301) on the EVB. The power adapter connects to a step-down converter which can provide the supply voltage (VBAT) required for operating the EVB and the module. The following two figures show the simplified power supply schematic and the power interface of the EPXX EVB. J301 USB-C interface J201 Power supply S201 Power switch U201 LDO U203 LDO 1.8V Power supply for 3.0V Codec module U202 VBAT Power supply for TPS54319 EP06 module Step-down converter Figure 6: Power Supply for EPXX EVB EPXX_EVB_User_Guide 16 / 34 LTE-A Module Series EPXX EVB User Guide J201 J301 5V DC Power Supply Figure 7: Power Interface Before connecting the power supply, customers have to select a proper DC power adapter to supply power for the EPXX EVB, and the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 8: Power Plug Design 4.2. Mini PCIe Interface (J103/J104) The Mini PCIe interface is designed to accommodate the EP06 module. EP06 module is connected to the EVB via Mini PCIe connectors J103 and J104 connectors. The interface allows customers to easily test the functionalities of EP06 module or to develop applications based on the module. The following figure shows the connection between EP06 and EVB. EPXX_EVB_User_Guide 17 / 34 LTE-A Module Series EPXX EVB User Guide Figure 9: Connection between EP06 and EVB 4.3. USB Interface (J301) Quectel EP06 module supports a USB interface, which complies with USB 2.0 and USB 3.0 specifications. USB 2.0 interface supports high speed (480Mbps) and full speed (12Mbps) modes, and the data rate of USB 3.0 interface is up to 5Gbps. This interface is used for AT command communication, data transmission, GNSS NMEA output, software debugging, firmware upgrade and voice over USB*. The EPXX EVB provides a USB Type-C interface J301 for connection with a host device. The USB data lines D+ and D- are connected directly to the EP06 module. The CC1 and CC2 lines can be used for TypeC configuration channel signals. The VBUS lines can be used for USB connection detection and EVB power supply. Table 4: Pin Assignment of J301 A1 A2 A3 A4 A5 A6 A7 A8 A9 A10 A11 A12 GND TX1+ TX1- VBUS CC1 D+ D- SBU1 VBUS RX2- RX2+ GND GND RX1+ RX1- VBUS SBU2 D- D+ CC2 VBUS TX2- TX2+ GND B12 B11 B10 B9 B8 B7 B6 B5 B4 B3 B2 B1 EPXX_EVB_User_Guide 18 / 34 LTE-A Module Series EPXX EVB User Guide The following figure is a reference circuit design for the USB Type-C device interface. EP06 Module USB_SS_TX_M USB_SS_TX_P USB_SS_RX_M USB_SS_RX_P USB_DP USB_DM U301 HS3SS3220 TXN TXP RXN RXP R1 0R R2 0R TX1+ TX1RX1+ RX1TX2+ TX2RX2+ RX2CC1 CC2 C1 100nF C2 100nF C3 100nF C4 100nF C5 100nF C6 100nF C7 100nF C8 100nF ESD U301 USB Type-C TX1+ TX1RX1+ RX1TX2+ TX2RX2+ RX2CC1 CC2 USB_D+ USB_D- Figure 10: USB Type-C Interface Circuit NOTE '*' means under development. 4.4. Audio Interfaces Quectel EPXX EVB provides one digital audio codec board interface (PCM) J501 and two analog audio interfaces J601 and J602. This chapter gives a detailed introduction on these audio interfaces. Digital Audio Codec Board Interface (J501) The EPXX EVB supports the external digital audio codec of TLV320AIC3104. The codec circuit is assembled on an independent small board which can be interconnected with EVB by the BTB connector J501. EPXX_EVB_User_Guide 19 / 34 LTE-A Module Series EPXX EVB User Guide The following figure shows a reference circuit design for the connection between digital audio codec board and EVB. 4.7K 4.7K MIC_BIAS EP06 Module R PCM_CLK PCM_SYNC PCM_OUT PCM_IN I2C_SCL I2C_SDA VDD_EXT BTB CON C TLV3104 BTB CON MIC_BIAS BCLK IN2P IN2N U101 LRCK DACDAT1 ADCDAT1 HPO_L HPO_R SCL SDA LOUDL/P LOUDR/N J501 J501 J601 MIC 1 4 6 5 J602 3 2 J601 speaker Figure 11: Reference Design for Connection between Codec Board and EVB Codec Board EVB Figure 12: Connection between Codec Board and EVB EPXX_EVB_User_Guide 20 / 34 LTE-A Module Series EPXX EVB User Guide Analog Audio Codec Board Interface (J601/J602) 4.4.2.1. Handset Interface (J601) Audio interface J601 is designed for handsets. A reference circuit design for handset interfaces J601 is shown below. U101 Codec TLV3104 IN2P IN2N LOUDL/P LOUDR/N J501 FB BTB CON 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD J601 4 1 3 2 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD Figure 13: Reference Circuit Design for Handset Interface J601 The figure and table below illustrate the pin assignment and pin definition of handset interface J601. 4 2 31 Figure 14: Pin Assignments of J601 EPXX_EVB_User_Guide 21 / 34 Table 5: Pin Definition of J601 Pin No. 1 2 3 4 Pin Name MIC_N SPK_N SPK_P MIC_P LTE-A Module Series EPXX EVB User Guide Function Negative microphone input Negative loud speaker output Positive loud speaker output Positive microphone input 4.4.2.2. Earphone Interface (J602) Audio interface J602 is designed for earphones. A reference circuit designs for interfaces is shown as following figure. U101 Differential layout J501 MIC_N MIC_P Close to Socket GND AGND GND GND GND 10pF 33pF 4.7uF 10pF 33pF ESD AGND Codec TLV3104 22uF 22uF AGND SPK_L SPK_R BTB CON Close to Socket 10pF 33pF 10pF 33pF ESD GND 0R NM_0R 2 4 6 5 3 1 J602 Audio Jack NM_0R 0R AGND MIC_P Figure 15: Reference Circuit Design for Earphone Interface J602 EPXX_EVB_User_Guide 22 / 34 LTE-A Module Series EPXX EVB User Guide The figure and table below illustrate the pin assignment and pin definition of earphone interface J602. 6 5 4 3 2 1 Figure 16: Pin Assignments of J602 Table 6: Pin Definition of J602 Pin No. 1 2 3 4 5, 6 Pin Name MIC_P AGND SPK_R SPK_L NC Description Microphone input Dedicated GND for audio Right channel of stereo audio output Left channel of stereo audio output Not connected EPXX_EVB_User_Guide 23 / 34 LTE-A Module Series EPXX EVB User Guide The following figure shows the sketch design of audio plug which suits for the audio jack on EPXX EVB. 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 17: Sketch of Audio Plug 4.5. (U)SIM Interfaces (J402/J403) The EPXX EVB has two 6-pin push-push type (U)SIM card (3.0V or 1.8V) connectors J402 and J403. The following figure shows the simplified interface schematic for J402, and that of J403 is identical. USIM_VDD USIM_DATA USIM_CLK USIM_RST C1 C2 C3 33pF 33pF 33pF J103 Push-Push C1 USIM_VDD C7 USIM_DATA C3 USIM_CLK C2 USIM_RST CD1 USIM_GND (U)SIM card connector GND GND J402 Figure 18: Simplified Interface Schematic for (U)SIM Card Connector J402 EPXX_EVB_User_Guide 24 / 34 LTE-A Module Series EPXX EVB User Guide The figure and table below show the pin assignment and pin definition of J402, and that of J403 is identical. C3 C7 C2 C6 C1 C5 CD1 CD2 C7 C3 C6 C2 C5 C1 Figure 19: Pin Assignments of J402 Table 7: Pin Definition of J402 Pin No. C1 C2 C3 C5 C6 C7 CD1 CD2 Signal Name USIM_VDD USIM_RST USIM_CLK GND VPP USIM_DATA GND NC I/O Function (U)SIM card power supply, provided by PO EPXX EVB DO (U)SIM card reset DO (U)SIM card clock / Ground / Not connected IO Data line, bi-directional / (U)SIM card insertion detection / (U)SIM card insertion detection 4.6. Switch and Button The EPXX EVB includes one switch (S201) and one button (S101), as shown in the following figure. EPXX_EVB_User_Guide 25 / 34 LTE-A Module Series EPXX EVB User Guide S201 S101 Figure 20: S201 Switch and S101 Button Table 8: Description of Switch and Button Reference No. S201 S101 Description VBAT ON/OFF control Used to reset the EP06 module 4.7. Status Indicators The EPXX EVB comprises two status indicators (D101 and D102). The following figure shows the location of these LED indicators. D101 D102 Figure 21: Status Indicators EPXX_EVB_User_Guide 26 / 34 Table 9: Description of Status Indicators Reference No. D101 D102 Description Power ON/OFF indicator for EP06 module Bright: the module is powered on Extinct: the power is powered off Network status indicator for EP06 module LTE-A Module Series EPXX EVB User Guide 4.8. Test Points The EPXX EVB provides a series of test points. They can help customers to obtain the corresponding waveform of some signals. The following figures show test points J101, J102, J203 and J204. 2 4 6 8 10 1 3 5 7 9 J101 Figure 22: Test Points J101 Table 10: Pin Definition of J101 J101 Pin No. Pin Name Description 1 GND Ground 2 W_DISABLE Airplane mode control 3 GRFC_0 External switch control for multiple antennas 4 USB_OTG_PWR_EN Control USB OTG power EPXX_EVB_User_Guide 27 / 34 LTE-A Module Series EPXX EVB User Guide 5 GRFC_1 External switch control for multiple antennas 6 WAKE_N Output signal, used to wake up the module 7 GRFC_2 External switch control for multiple antennas 8 RESET Output signal, RESET test pin, used to reset the module 9 GRFC_3 External switch control for multiple antenna 10 DTR Data terminal ready test pins 1 2 3 45 J102 Figure 23: Test Point J102 Table 11: Pin Definition of J102 J102 Pin No. 1 2 3 4 5 Pin Name GND TXD RXD VCC_3.3V VDD_EXT Description Ground Connected directly to voltage translator Connected directly to voltage translator 3.3V power from U202 chip 1.8V reference voltage output EPXX_EVB_User_Guide 28 / 34 LTE-A Module Series EPXX EVB User Guide 2 1 J203 2 1 J204 Figure 24: Test Points J203 and J204 Table 12: Pin Definition of J203 and J204 J203 Pin No. Pin Name 1 VBAT 2 VCC J204 Pin No. Pin Name 1 VBAT 2 GND Description Power supply for EP06 module 3.0V power supply from U202 chip Description Power supply for EP06 module Ground EPXX_EVB_User_Guide 29 / 34 LTE-A Module Series EPXX EVB User Guide 5 Operation Procedures Illustration This chapter introduces how to use the EPXX EVB for testing and evaluation of Quectel EP06 module. 5.1. Power on EP06 Module 1. Connect the EP06 to the connectors (J103 and J104) on EVB. 2. Insert a (U)SIM card into the (U)SIM card connector (J402) on EVB, and connect the antennas to EP06. 3. Connect the EVB to a 5V power adapter, or connect the EVB to PC via USB Type-C cable. 4. Switch S201 (Power switch) to ON state, then D101 (VBAT ON/OFF indicator) and D102 (Network status indicator) will be light up, which indicates the EP06 module has been powered on. 5.2. Communication Via USB Interface 1. Power on the EP06 module according to the procedures mentioned in Chapter 5.1. 2. Connect the EVB and the PC with USB Type-C cable through USB interface, and then run the driver disk on PC to install the USB driver. The USB port numbers can be viewed through the PC Device Manager, shown as following figure. Figure 25: USB Ports EPXX_EVB_User_Guide 30 / 34 LTE-A Module Series EPXX EVB User Guide 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the EP06 module and the PC. The following figure shows the Port Setting field on QCOM: select correct 'COM port' (USB AT Port which is shown in above figure) and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [2]. Figure 26: COM Port Setting Field on QCOM 5.3. Firmware Upgrade Firmware of EP06 module is upgraded via USB port by default, please follow the procedures below to upgrade firmware. 1. Install and open the firmware upgrade tool QFlash on PC and then power on the EP06 module according to the procedures mentioned in Chapter 5.1. 2. Click the 'COM Port' dropdown list and select the USB DM port. 3. Click the 'Load FW Files' button to choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. Figure 27: QFlash Configurations for Firmware Upgrade EPXX_EVB_User_Guide 31 / 34 LTE-A Module Series EPXX EVB User Guide 5.4. Reset EP06 Module The emergency reset option is only used in case of emergency. For example, the software does not respond for more than 5s due to some serious problems. Press the button S101 (Reset button) for more than 200ms then release it to reset EP06 module. However, this operation may cause the loss of information stored in the memory as the reset module has been initialized. 5.5. Power off EP06 Module Switching S201 (Power switch) to OFF status will shut down the EP06 module. EPXX_EVB_User_Guide 32 / 34 LTE-A Module Series EPXX EVB User Guide 6 Appendix A References Table 13: Related Documents SN Document Name [1] Quectel_EP06_Hardware_Design [2] Quectel_QCOM_User_Guide Remark EP06 hardware design User guide for QCOM tool Table 14: Terms and Abbreviations Abbreviation AGND BTB COM DC DI DO EVB GND GNSS I/O LED LTE-A MIC NC Description Analogue Ground Board to Board Cluster Communication Port Direct Current Digital Input Digital Output Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode Long Term Evolution Advanced Microphone Not Connected EPXX_EVB_User_Guide 33 / 34 PC PCB PCM PO RF SD SIM UART UMTS USB (U)SIM VBAT Private Computer Printed Circuit Board Pulse Code Modulation Power Output Radio Frequency Secure Digital Subscriber Identity Module Universal Asynchronous Receiver & Transmitter Universal Mobile Telecommunications System Universal Serial Bus (Universal) Subscriber Identity Module Voltage of Battery LTE-A Module Series EPXX EVB User Guide EPXX_EVB_User_Guide 34 / 34

LTE OPEN EVB User Guide LTE Module Series Rev. LTE_OPEN_EVB_User_Guide_V1.1 Date: 2018-03-19 Status: Released www.quectel.com LTE Module Series LTE OPEN EVB User Guide 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. LTE_OPEN_EVB_User_Guide 1 / 62 LTE Module Series LTE OPEN EVB User Guide About the Document History Revision 1.0 1.1 Date 2017-12-29 2018-03-19 Author Woody WU/ Lorry XU Eden LIU Description Initial Updated the GPIO List for AG35-QuecOpen module (Table 27). LTE_OPEN_EVB_User_Guide 2 / 62 LTE Module Series LTE OPEN EVB User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 8 1.1. Safety Information ................................................................................................................... 8 2 General Overview............................................................................................................................... 10 2.1. Applicable Modules ............................................................................................................... 10 2.2. Key Features ......................................................................................................................... 11 2.3. Interface Overview................................................................................................................. 13 2.4. Top View of LTE OPEN EVB ................................................................................................. 16 3 EVB Kit Accessories Assembly ....................................................................................................... 17 3.1. EVB Kit .................................................................................................................................. 17 3.2. EVB Kit Accessories .............................................................................................................. 18 4 Interface Applications ....................................................................................................................... 20 4.1. Power Interfaces (J0301/J0601) ........................................................................................... 20 4.2. LTE-QuecOpen TE-A Interface ............................................................................................. 22 4.3. Wi-Fi & Ethernet TE-A Interface ............................................................................................ 22 4.4. USB Interface (J0601)........................................................................................................... 25 4.5. Audio Interfaces..................................................................................................................... 26 4.5.1. Digital Audio Codec Board Interface (J0804)................................................................. 26 4.5.2. Analog Audio Interfaces (J0805/J0801/J0802) .............................................................. 28 4.5.2.1. Loudspeaker Interface (J0805) ............................................................................ 28 4.5.2.2. Earphone Interface (J0802) ................................................................................. 28 4.5.2.3. Handset Interface (J0801).................................................................................... 30 4.6. U(SIM) Interface (J0901)....................................................................................................... 31 4.7. SD Card Interfaces & eMMC (J0701/J0702 & U0702) ......................................................... 33 4.8. UART Interfaces (J0501/J0502/J0503)................................................................................. 38 4.9. SPI Flash (U0601) ................................................................................................................. 42 4.10. EEPROM (U0903) ................................................................................................................. 43 4.11. Switches and Buttons ............................................................................................................ 44 4.12. Status Indicators .................................................................................................................... 45 4.13. GPIO Interfaces..................................................................................................................... 46 4.14. Test Points ............................................................................................................................. 50 5 Operation Procedures Illustration.................................................................................................... 56 5.1. Power on Modules................................................................................................................. 56 5.1.1. Power on LTE-QuecOpen Modules ............................................................................... 56 5.1.2. Power on Wi-Fi Modules ................................................................................................ 56 5.2. Communication Via USB or UART Interface......................................................................... 57 LTE_OPEN_EVB_User_Guide 3 / 62 LTE Module Series LTE OPEN EVB User Guide 5.2.1. Communication via USB Interface ................................................................................. 57 5.2.2. Communication via UART Interface............................................................................... 58 5.3. Firmware Upgrade................................................................................................................. 59 5.4. Reset Modules....................................................................................................................... 59 5.5. Power off Modules................................................................................................................. 60 5.5.1. Power off LTE-QuecOpen modules ............................................................................... 60 5.5.2. Power off Wi-Fi modules ................................................................................................ 60 6 Appendix A References..................................................................................................................... 61 LTE_OPEN_EVB_User_Guide 4 / 62 LTE Module Series LTE OPEN EVB User Guide Table Index TABLE 1: KEY FEATURES OF LTE OPEN EVB................................................................................................11 TABLE 2: INTERFACES OF LTE OPEN EVB ................................................................................................... 13 TABLE 3: ACCESSORIES LIST ........................................................................................................................ 18 TABLE 4: S0201 FUNCTION............................................................................................................................. 24 TABLE 5: S1001 FUNCTION............................................................................................................................. 24 TABLE 6: WI-FI & ETHERNET FUNCTION GPIO CONFIGURATION ............................................................. 25 TABLE 7: CODEC FUNCTION GPIO CONFIGURATION................................................................................. 27 TABLE 8: PIN DEFINITION OF J0802 .............................................................................................................. 29 TABLE 9: PIN DEFINITION OF J0801 .............................................................................................................. 31 TABLE 10: PIN DEFINITION OF J0901 ............................................................................................................ 32 TABLE 11: (U)SIM HOT-PLUG GPIO CONFIGURATION................................................................................. 33 TABLE 12: PIN DEFINITION OF J0701 ............................................................................................................ 35 TABLE 13: PIN DEFINITION OF J0702 ............................................................................................................ 36 TABLE 14: S0701 FUNCTION .......................................................................................................................... 36 TABLE 15: SD CARD FUNCTION GPIO CONFIGURATION ........................................................................... 37 TABLE 16: EMMC FUNCTION GPIO CONFIGURATION................................................................................. 38 TABLE 17: PIN DEFINITION OF J0501 ............................................................................................................ 39 TABLE 18: PIN DEFINITION OF J0502 ............................................................................................................ 40 TABLE 19: PIN DEFINITION OF J0503 ............................................................................................................ 40 TABLE 20: COM (MAIN) & COM (UART1) FUNCTION GPIO CONFIGURATION........................................... 41 TABLE 21: SPI FLASH FUNCTION GPIO CONFIGURATION ......................................................................... 43 TABLE 22: EEPROM FUNCTION GPIO CONFIGURATION ............................................................................ 44 TABLE 23: DESCRIPTION OF SWITCHES AND BUTTONS ........................................................................... 45 TABLE 24: DESCRIPTION OF STATUS INDICATION LEDS ........................................................................... 46 TABLE 25: PIN DEFINITION OF J0202 ............................................................................................................ 46 TABLE 26: PIN DEFINITION OF J0201 ............................................................................................................ 47 TABLE 27: GPIO LIST FOR AG35-QUECOPEN MODULE .............................................................................. 48 TABLE 28: PIN DEFINITION OF TEST POINTS .............................................................................................. 51 TABLE 29: INDICATION OF D0312 .................................................................................................................. 57 TABLE 30: RELATED DOCUMENTS ................................................................................................................ 61 TABLE 31: TERMS AND ABBREVIATIONS ...................................................................................................... 61 LTE_OPEN_EVB_User_Guide 5 / 62 LTE Module Series LTE OPEN EVB User Guide Figure Index FIGURE 1: LTE OPEN EVB INTERFACE OVERVIEW..................................................................................... 13 FIGURE 2: LTE OPEN EVB TOP VIEW ............................................................................................................ 16 FIGURE 3: LTE OPEN EVB KIT........................................................................................................................ 17 FIGURE 4: EVB KIT ACCESSORIES ............................................................................................................... 18 FIGURE 5: POWER SUPPLY SCHEMATIC FOR LTE OPEN EVB .................................................................. 21 FIGURE 6: POWER INTERFACES................................................................................................................... 21 FIGURE 7: POWER PLUG DESIGN................................................................................................................. 21 FIGURE 8: CONNECTION BETWEEN LTE-QUECOPEN TE-A AND EVB ...................................................... 22 FIGURE 9: SIMPLIFIED FC20-TE-A/AF20-TE-A INTERFACE SCHEMATIC .................................................. 23 FIGURE 10: SIMPLIFIED SDC1 INTERFACE SCHEMATIC ............................................................................ 23 FIGURE 11: CONNECTION BETWEEN FC20-TE-A AND EVB ....................................................................... 24 FIGURE 12: WI-FI & ETHERNET FUNCTION GPIO CONFIGURATION......................................................... 25 FIGURE 13: REFERENCE DESIGN FOR CONNECTION BETWEEN CODEC BOARD AND EVB ............... 26 FIGURE 14: CONNECTION BETWEEN CODEC BOARD AND EVB .............................................................. 27 FIGURE 15: CODEC FUNCTION GPIO CONFIGURATION ............................................................................ 27 FIGURE 16: REFERENCE CIRCUIT DESIGN FOR LOUDSPEAKER INTERFACE J0805 ............................ 28 FIGURE 17: REFERENCE CIRCUIT DESIGN FOR EARPHONE INTERFACE J0802 ................................... 28 FIGURE 18: PIN ASSIGNMENT OF J0802....................................................................................................... 29 FIGURE 19: SKETCH OF AUDIO PLUG .......................................................................................................... 30 FIGURE 20: REFERENCE CIRCUIT DESIGN FOR HANDSET INTERFACE J0801 ...................................... 30 FIGURE 21: PIN ASSIGNMENT OF J0801....................................................................................................... 31 FIGURE 22: SIMPLIFIED INTERFACE SCHEMATIC FOR U(SIM) CARD CONNECTOR J0901 ................... 32 FIGURE 23: PIN ASSIGNMENT OF J0901....................................................................................................... 32 FIGURE 24: (U)SIM HOT-PLUG GPIO CONFIGURATION .............................................................................. 33 FIGURE 25: SIMPLIFIED INTERFACE SCHEMATIC FOR SD CARD INTERFACE J0701, J0702................. 34 FIGURE 26: PIN ASSIGNMENT OF J0701....................................................................................................... 34 FIGURE 27: PIN ASSIGNMENT OF J0702....................................................................................................... 34 FIGURE 28: EMMC DEVICE............................................................................................................................. 35 FIGURE 29: SD CARD FUNCTION GPIO CONFIGURATION ......................................................................... 37 FIGURE 30: EMMC FUNCTION GPIO CONFIGURATION .............................................................................. 37 FIGURE 31: UART BLOCK DIAGRAM ............................................................................................................. 38 FIGURE 32: PIN ASSIGNMENT OF J0501....................................................................................................... 39 FIGURE 33: PIN ASSIGNMENT OF J0502....................................................................................................... 39 FIGURE 34: PIN ASSIGNMENT OF J0503....................................................................................................... 40 FIGURE 35: COM (MAIN) & COM (UART1) FUNCTION GPIO CONFIGURATION ........................................ 41 FIGURE 36: SPI FLASH DEVICE ..................................................................................................................... 42 FIGURE 37: SPI FLASH FUNCTION GPIO CONFIGURATION....................................................................... 42 FIGURE 38: EEPROM DEVICE ........................................................................................................................ 43 FIGURE 39: EEPROM FUNCTION GPIO CONFIGURATION.......................................................................... 43 FIGURE 40: S0201/S0701/S1001 SWITCH ..................................................................................................... 44 FIGURE 41: S0301/S0401 SWITCH AND S0403/S0402 BUTTON.................................................................. 44 LTE_OPEN_EVB_User_Guide 6 / 62 LTE Module Series LTE OPEN EVB User Guide FIGURE 42: STATUS INDICATION LEDS ........................................................................................................ 45 FIGURE 43: GPIO JUMPERS J0201 AND J0202............................................................................................. 46 FIGURE 44: TEST POINT J1004/J1005/J1006 ................................................................................................ 50 FIGURE 45: TEST POINT J1003/J0505/J1007/J10204/J0203......................................................................... 51 FIGURE 46: USB PORTS ................................................................................................................................. 57 FIGURE 47: COM PORT SETTING FIELD ON QCOM (USB AT PORT CONNECTION) ................................ 58 FIGURE 48: USB SERIAL PORT ...................................................................................................................... 58 FIGURE 49: COM PORT SETTING FIELD ON QCOM (USB SERIAL PORT CONNECTION) ....................... 58 FIGURE 50: QFLASH CONFIGURATIONS FOR FIRMWARE UPGRADE ...................................................... 59 LTE_OPEN_EVB_User_Guide 7 / 62 LTE Module Series LTE OPEN EVB User Guide 1 Introduction This document describes how to use the evaluation board (LTE OPEN EVB) of Quectel LTE-QuecOpen and Wi-Fi modules. It is an assistant tool for engineers to develop and test Quectel LTE-QuecOpen and Wi-Fi modules. 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating Quectel LTE-QuecOpen and Wi-Fi modules. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as to prevent interference with communication systems. Consult the airline staff about the use of wireless devices on boarding the aircraft, if your device offers an Airplane Mode which must be enabled prior to boarding an aircraft. Switch off your wireless device when in hospitals, clinics or other health care facilities. These requests are designed to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid (U)SIM card. While you are in this condition and need emergent help, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. LTE_OPEN_EVB_User_Guide 8 / 62 LTE Module Series LTE OPEN EVB User Guide Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency energy. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. LTE_OPEN_EVB_User_Guide 9 / 62 LTE Module Series LTE OPEN EVB User Guide 2 General Overview The LTE OPEN EVB is designed for developers to develop applications based on Quectel LTE-QuecOpen modules. 2.1. Applicable Modules The EVB can test basic functionalities of the following modules: LTE-QuecOpen modules:  EC2x-QuecOpen 1)  BG96-QuecOpen  AG35-QuecOpen Wi-Fi modules:  FC20 series 2)  AF20 3) NOTES 1. 1) EC2x-QuecOpen refers to EC21/EC25/EC20 R2.0/EC20 R2.1-QuecOpen modules. 2. 2) FC20 series contains FC20 and FC20-N, and it is used in combination with Quectel EC2x-QuecOpen modules. Hereinafter, it is called FC20 collectively. 3. 3) AF20 is used in combination with Quectel AG35-QuecOpen module. LTE_OPEN_EVB_User_Guide 10 / 62 LTE Module Series LTE OPEN EVB User Guide 2.2. Key Features The following table describes the detailed features of LTE OPEN EVB. Table 1: Key Features of LTE OPEN EVB Features Power Supply LTE TE-A Interface Wi-Fi & Ethernet TE-A Interface eMMC Device SD Card Interface SPI Flash Device EEPROM Device U(SIM) Interface Audio Interfaces UART Interfaces USB Interface Signal Indicators Implementation DC power supply (J0301 or J0601): 4.5V~5.5V, typically 5.0V VBAT (T0104)1): 3.8V Support Quectel LTE-QuecOpen modules: EC2x/BG96/AG35-QuecOpen Support Quectel Wi-Fi modules: FC20/AF20 Manufacturer: MICRON Part number: MTFC4GACAJCN-4M IT Support standard SD card and TF card Manufacturer: GIGADEVICE Part number: GD25LQ64CWIGR Manufacturer: ATMEL Part number: AT24CS64-SSHM-T Support U(SIM) card insertion detection Support U(SIM) card: 3.0V and 1.8V  One digital audio codec board interface Support Realteck ALC5616 and TI Codec TLV320AIC3104  Three analog interfaces used for loudspeaker, earphone and handset Three UART interfaces:  COM (MAIN): Serial interface for data communication Maximum baud rate supported: 1Mbps 2)  COM (DEBUG): Serial interface for debugging purpose Maximum baud rate supported: 1Mbps 2)  COM (UART1): Serial interface for data communication Maximum baud rate supported: 1Mbps 2) Micro-B interface 4 LEDs are available for signal indication 4 LEDs are available for GPIO testing LTE_OPEN_EVB_User_Guide 11 / 62 LTE Module Series LTE OPEN EVB User Guide Switches and Buttons Physical Characteristics Five Switches:  Power Switch (S0301) for VBAT ON/OFF control  SDC1 function switch (S0201) for switching between GPIO and Wi-Fi function.  SDC2 function switch (S0701) for switching between SD and eMMC functions.  PCM function switch (S1001) for switching between BT and codec functions.  Switch S0401 reserved for internal testing. Two Buttons:  PWRKEY (S0403) for turning on/off LTE-QuecOpen modules  RESET (S0402) for resetting LTE-QuecOpen modules Size: 200.0mm × 145.0mm × 1.6mm NOTES 1. 1) VBAT (T0104) is a test point on LTE OPEN EVB, and is used to test the current of the modules. If it is used to supply power for the modules, then R0106 should be disconnected. 2. 2) The maximum baud rate is limited to the RS232 level shifter chip on the EVB. For the maximum baud rates supported by the modules, please refer to their respective hardware designs. LTE_OPEN_EVB_User_Guide 12 / 62 2.3. Interface Overview LTE Module Series LTE OPEN EVB User Guide 145mm COM1 (MAIN) 60Pin Wi-Fi & 60Pin Ethernet TE-A J1002 J1001 J0202 (U)SIM Card Connector J0902 J0102 100Pin J0203 U0702 Test Point eMMC J0201 J0701 SD Card J0702 D0204D0203 D0202D0201 LTE-QuecOpen TE-A J0204 Test Point S1001 J0502 J1005 Test Point J0101 100Pin J1007 Test Point Power supply J0301 J1006 J1004 Test Point Power Switch S0301 Micro-USB J0601 ADC0 ADC1 ADC2 Test Point GND VBAT Test Point U0903 U0601 EEPROM SPI FLASH 60Pin J0505 Test Point J1003 J0403 J0404 J0405 D0310 D0311D0312 D0313 Codec Board Interface J0804 Test Point S0401 PWRKEY S0403 RESET S0402 Earphone J0802 Handset J0901 J0401 GND GND J0801 (U)SIM Card Connector Reserved COM2 (DEBUG) COM2 (UART1) S0201 S0701 J0503 J0501 J0602 200mm Figure 1: LTE OPEN EVB Interface Overview Table 2: Interfaces of LTE OPEN EVB Interface Power Interfaces 1) Reference No. J0301 (bottom side) J0601 VBAT, GND Description  The power jack on the EVB  Typical supply voltage: +5V  Micro-B USB power supply  Typical supply voltage: +5V  Test points on the EVB to test the current of LTE-QuecOpen modules  Typical supply voltage: +3.8V  If VBAT is used to supply power for LTE-QuecOpen LTE_OPEN_EVB_User_Guide 13 / 62 Micro-B USB Interface Power Switch PWRKEY RESET J0601 S0301 S0403 J0401 S0402 SDC1 Function S0201 Switch SDC2 Function S0701 Switch PCM Function Switch S1001 Switch S0401 J0804 J0805 Audio Interfaces J0802 U(SIM) Interfaces J0801 (bottom side) J0901 J0902 LTE Module Series LTE OPEN EVB User Guide modules, then R0106 must be disconnected USB device interface VBAT ON/OFF control Power key (push button), used to turn on/off LTE-QuecOpen modules Jumper wire used to connect PWRKEY to GND Reset button (push button), used to reset LTE-QuecOpen modules  Switched to left: connect the GPIO interface of J0203 to the module’s SDC1 interface, for testing customers’ own modules  Switched to right: connect SDIO interface of FC20 and AF20 modules to SDC1 interface of LTE-QuecOpen modules  Switched to left: connect SD card interface of EVB to SDC2 interface of LTE-QuecOpen modules  Switched to right: connect eMMC to SDC2 interface of LTE-QuecOpen modules  Switched to left: connect BT interface (PCM) of AF20 to the PCM interface of AG35 module  Switched to right: connect the codec board interface (J0804) on EVB to the PCM interface of LTE-QuecOpen modules Reserved for internal testing. Switch it to down by default. Codec board interface  Used for loudspeaker  Used to test the analog audio function of LTE-QuecOpen modules  Used for earphone  Used to test the analog audio function of LTE-QuecOpen modules  Used for handset  Used to test the analog audio function of LTE-QuecOpen modules U(SIM) card connector 1 U(SIM) card connector 2 (Reserved) LTE_OPEN_EVB_User_Guide 14 / 62 LTE Module Series LTE OPEN EVB User Guide UART Interfaces J0501 (bottom side) J0502 (bottom side) J0503 (bottom side) Status Indicators D0310, D0311, D0312, D0313, D0201, D0202, D0203, D0204, J0101, J0102 TE-A Interfaces J0804 J1001, J1002 J0403, J0404, ADC Interfaces J0405 GPIO Interfaces J0201, J0202 Test Points J0203, J0204, J0505, J1003, J1004, J1005, J1006, J1007 Debug UART port Main UART port UART1 port  D0310: VBAT ON/OFF indicator  D0311: power ON/OFF status indicator for LTE-QuecOpen modules  D0312: network status indicator for LTE-QuecOpen modules  D0313: power saving mode status indicator for BG96-QuecOpen module  D0201~D0204: used for GPIO testing, and a high level will light up the LEDs Connectors for LTE-QuecOpen TE-A Connector for codec board interface Connectors for of Wi-Fi & Ethernet TE-A  Insert the jumper cap: connect the analog signals on EVB to the module’s ADC interface  Pull out the jumper cap: external analog signals can be connected to the connectors’ upper pins The GPIO pins can be short-circuited to other functional pins via the jumper caps. Test pins NOTE 1) The power supply interfaces are designed for LTE-QuecOpen modules. For details about the power supply for Wi-Fi modules, please refer to Chapter 4.1 and Chapter 4.3. LTE_OPEN_EVB_User_Guide 15 / 62 2.4. Top View of LTE OPEN EVB The top view of LTE OPEN EVB is shown as following figure. LTE Module Series LTE OPEN EVB User Guide Figure 2: LTE OPEN EVB Top View LTE_OPEN_EVB_User_Guide 16 / 62 LTE Module Series LTE OPEN EVB User Guide 3 EVB Kit Accessories Assembly 3.1. EVB Kit Figure 3: LTE OPEN EVB Kit LTE_OPEN_EVB_User_Guide 17 / 62 3.2. EVB Kit Accessories All accessories of LTE OPEN EVB kit are listed as below. LTE Module Series LTE OPEN EVB User Guide USB to RS-232 converter cable and driver disk Bolts and coupling nuts USB driver disk Micro-USB cable Wi-Fi antenna Codec boards Main antennas GNSS antenna RF cables Earphone Instruction sheet Figure 4: EVB Kit Accessories Table 3: Accessories List Items Cables Antennas Description USB to RS-232 converter cable Micro-USB cable RF cables Main antennas GNSS antenna (passive) LTE_OPEN_EVB_User_Guide Quantity 1 1 4 2 1 18 / 62 LTE Module Series LTE OPEN EVB User Guide Audio Disks Codec Boards Others Instruction Sheet Wi-Fi antenna 1 Earphone 1 USB 2.0 to RS-232 driver and USB driver disk 2 ALC5616 and TLV320AIC3104 codec boards 2 Bolts and coupling nuts for assembling EVB 1 A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. NOTE The main antenna can also be used for diversity reception. LTE_OPEN_EVB_User_Guide 19 / 62 LTE Module Series LTE OPEN EVB User Guide 4 Interface Applications This chapter describes the hardware interfaces of LTE OPEN EVB, shown as follows:  Power interfaces  LTE-QuecOpen TE-A interface  Wi-Fi & Ethernet TE-A interface  Micro-B USB interface  Audio interfaces  U(SIM) interfaces  SD card interfaces & eMMC  EEPROM  SPI Flash  UART interfaces It also provides information about the buttons, switches, status indicators and test points to help customers use the LTE OPEN EVB. 4.1. Power Interfaces (J0301/J0601) The LTE OPEN EVB can be powered by an external power adapter through connecting with the power jack (J0301) or Micro-USB receptacle (J0601) on the EVB. The power adapter connects to a step-down converter which can provide the supply voltage (VBAT) required for operating the EVB and the module. The following two figures show the simplified power supply schematic and the power interfaces of Quectel LTE OPEN EVB. LTE_OPEN_EVB_User_Guide 20 / 62 LTE Module Series LTE OPEN EVB User Guide J0601 Micro-USB interface J0301 Power jack S0301 Power switch U0401 LDO 1.8V Power supply for EEPROM, SD card, eMMC, SPI Flash, codec boards and Wi-Fi modules U0402 LDO 3.3V Power supply for Wi-Fi modules, ADC and eMMC U0403 LDO 2.85V Power supply for SD card U0301 TPS54319 VBAT Step-down converter Power supply for LTE-QuecOpen modules Figure 5: Power Supply Schematic for LTE OPEN EVB Figure 6: Power Interfaces Before connecting the power supply, customers have to select a proper DC power adapter to supply power for the LTE OPEN EVB, and the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 7: Power Plug Design LTE_OPEN_EVB_User_Guide 21 / 62 LTE Module Series LTE OPEN EVB User Guide 4.2. LTE-QuecOpen TE-A Interface The interface is designed to accommodate the TE-A of LTE-QuecOpen modules. The TE-A is connected to the EVB via BTB connectors J0101 and J0102. The interface allows customers to easily test the functionalities of LTE-QuecOpen modules or to develop applications based on these modules. The following figure shows the connection between LTE-QuecOpen TE-A and the EVB. J0102 J0101 Figure 8: Connection between LTE-QuecOpen TE-A and EVB 4.3. Wi-Fi & Ethernet TE-A Interface The Wi-Fi & Ethernet TE-A interface is designed to accommodate the TE-A of FC20 and AF20 modules. The TE-A is connected to the EVB via BTB connectors J1001 and J1002. The interface allows customers to easily test the Wi-Fi function of EC2x/AG35 modules or to develop applications with Wi-Fi function. The following two figures show the connection between FC20-TE-A/AF20-TE-A and the EVB. LTE_OPEN_EVB_User_Guide 22 / 62 LTE Module Series LTE OPEN EVB User Guide SGMII_RX_M 16 SGMII_RX_P 18 SGMII_TX_M 22 SGMII_TX_P 24 SGMII_MDIO_DAT 28 SGMII_MDIO_CLK 32 SGMII_RST_N 36 SGMII_INT_N 38 SDIO_CMD 42 SDIO_CLK 46 SDIO_D0 50 52 SDIO_D1 54 SDIO_D2 SDIO_D3 56 GND 16 SGMII_RX_M 18 SGMII_RX_P 22 SGMII_TX_M 24 SGMII_TX_P 28 SGMII_MDIO_DAT 32 SGMII_MDIO_CLK 36 SGMII_RST_N 38 SGMII_INT_N 42 SDIO_CMD 46 SDIO_CLK 50 SDIO_D0 52 SDIO_D1 54 SDIO_D2 56 SDIO_D3 1 GND 2 GND 3 GND 4 GND 27 GND 28 GND 29 GND 30 GND 43 GND 44 GND 57 GND 58 GND 59 GND GND 60 J1001 VDD_3V3 VDD_1V8 FC20-TE-A/AF20-TE-A GND 1 GND 2 3 GND 4 GND GND 27 GND 28 GND 29 30 GND GND 43 GND 44 GND 57 GND 58 GND 59 GND 60 GND J1002 Figure 9: Simplified FC20-TE-A/AF20-TE-A Interface Schematic J0102 PCM SDC1 S1001 SEL Analog Switch U1001 Analog Switch SEL U0201 S0201 J0804 PCM Codec Board Interface PCM Wi-Fi & Ethernet SDIO TE-A J1001 J0203 GPIO Test Points Figure 10: Simplified SDC1 Interface Schematic LTE_OPEN_EVB_User_Guide 23 / 62 Table 4: S0201 Function Switched Direction Left Right Table 5: S1001 Function Switched Direction Left Right Description Enable GPIO function Enable Wi-Fi function Description PCM used for BT PCM used for codec LTE Module Series LTE OPEN EVB User Guide J1002 J1001 Figure 11: Connection between FC20-TE-A and EVB If Wi-Fi and Ethernet function is intended to be used, then please switch S0201 to the right and also short the signals illustrated in the figure and table below with the jumper cap. LTE_OPEN_EVB_User_Guide 24 / 62 LTE Module Series LTE OPEN EVB User Guide Figure 12: Wi-Fi & Ethernet Function GPIO Configuration Table 6: Wi-Fi & Ethernet Function GPIO Configuration Pin No. Pin 27 (J0202) Pin 25 (J0202) Pin 23 (J0202) Pin21 (J0202) Pin 34 (J0201) Pin 31 (J0201) Pin 28 (J0201) Pin 25 (J0201) Pin Name COEX_UART_TX COEX_UART_RX WLAN_EN WAKE_WLAN EPHY_INT_N EPHY_RST_N SGMII_MDATA SGMII_CLK Operation Shorted to Shorted to Shorted to Shorted to Shorted to Shorted to Shorted to Shorted to Pin No. Pin 28 (J0202) Pin 26 (J0202) Pin 24 (J0202) Pin 22 (J0202) Pin 35 (J0201) Pin 32 (J0201) Pin 29 (J0201) Pin 26 (J0201) Pin Name GPIO_36 GPIO_37 GPIO_38 GPIO_59 GPIO_30 GPIO_29 GPIO_28 GPIO_27 4.4. USB Interface (J0601) Quectel LTE-QuecOpen modules provide a USB interface which complies with USB 2.0 specifications. USB 2.0 supports high-speed (480Mbps), full-speed (12Mbps) and low-speed (1.5Mbps) modes. The interface is used for AT command communication, data transmission, firmware upgrade and GNSS NEMA output. LTE_OPEN_EVB_User_Guide 25 / 62 LTE Module Series LTE OPEN EVB User Guide LTE OPEN EVB provides a Micro-USB interface J0601 for connection with a host device. The USB data lines USB_DP and USB_DM are connected directly to the LTE-QuecOpen modules. The USB_VBUS line can be used for USB connection detection and EVB power supply. 4.5. Audio Interfaces LTE OPEN EVB provides one digital audio codec board interface (PCM) J0804 and three analog audio interfaces J0801, J0802 and J0805. 4.5.1. Digital Audio Codec Board Interface (J0804) LTE OPEN EVB supports two different kinds of external digital audio codecs named ALC5616 and TLV320AIC3104. The codec circuit is assembled on an independent small board which can be interconnected with EVB via the BTB connector J0501. Customers can select different codecs according to their own application demands, and also can use AT command to switch between codecs. Two examples are provided below. For more details, please refer to document [5].  AT+QDAI=3: switch codec from TLV320AIC3104 to ALC5616  AT+QDAI=5: switch codec from ALC5616 to TLV320AIC3104 The following figure show a reference design for the connection between digital audio codec boards and the EVB. LTE-QuecOpen Module R PCM_CLK PCM_SYNC PCM_OUT PCM_IN I2C_SCL I2C_SDA VDD_EXT 4.7K 4.7K MIC_BIAS BTB CON ALC5616/TLV3104 BTB CON MIC_BIAS BCLK IN2P C IN2N LRCK U0101 HPO_L 1 4 6 DACDAT1 HPO_R 5 3 2 ADCDAT1 SCL SDA LOUDL/P LOUDR/N J0804 J0804 NCP2823 J0801 MIC J0802 J0801 speaker J0805 Figure 13: Reference Design for Connection between Codec Board and EVB LTE_OPEN_EVB_User_Guide 26 / 62 J0804 LTE Module Series LTE OPEN EVB User Guide Codec board EVB Figure 14: Connection between Codec Board and EVB If digital audio codec board is intended to be used, then please switch S1001 to the right and short signals illustrated in the figure and table below with the jumper cap. Figure 15: Codec Function GPIO Configuration Table 7: Codec Function GPIO Configuration Pin No. Pin 19 (J0202) Pin 17 (J0202) Pin 15 (J0202) Pin 13 (J0202) Pin 14 (J0201) Pin 17 (J0201) Pin Name PCM_SYNC PCM_CLK PCM_OUT PCM_IN I2C_SDA I2C_SCA Operation Shorted to Shorted to Shorted to Shorted to Shorted to Shorted to Pin No. Pin 20 (J0202) Pin 18 (J0202) Pin 16 (J0202) Pin 14 (J0202) Pin 13 (J0201) Pin 16 (J0201) Pin Name GPIO_79 GPIO_78 GPIO_77 GPIO_76 GPIO_6 GPIO_7 LTE_OPEN_EVB_User_Guide 27 / 62 LTE Module Series LTE OPEN EVB User Guide 4.5.2. Analog Audio Interfaces (J0805/J0801/J0802) 4.5.2.1. Loudspeaker Interface (J0805) Audio interface J0805 is designed for loudspeakers and the following figure shows a reference design of loudspeaker with an external Class-D audio amplifier. If loudspeaker function is intended to be used, please insert the jumper cap on J0803. U0101 J0804 VBAT J0803 Differential layout Codec LOUDL/P C1 ALC5616/ TLV3104 LOUDR/N C2 BTB CON Amplifier circuit U0801 VP NCP2823 Close to speaker GND 10pF 33pF FB ESD J0805 FB 10pF 33pF GND ESD Figure 16: Reference Circuit Design for Loudspeaker Interface J0805 4.5.2.2. Earphone Interface (J0802) Audio interface J0802 is designed for earphones. A reference circuit design for earphone interface J0802 is shown as following figure. U0101 Differential layout J0804 MIC_N MIC_P Close to Socket GND AGND GND GND GND 10pF 33pF 4.7uF75pF 15pF ESD AGND Codec ALC5616 22uF TLV3104 22uF AGND SPK_L SPK_R BTB CON Close to Socket 10pF 33pF 10pF 33pF ESD GND 0R NM_0R 2 4 6 5 3 1 J0802 Audio Jack NM_0R 0R AGND MIC_P Figure 17: Reference Circuit Design for Earphone Interface J0802 LTE_OPEN_EVB_User_Guide 28 / 62 LTE Module Series LTE OPEN EVB User Guide The figure and table below illustrate the pin assignment and pin definition of earphone interface J0802. 6 5 4 3 2 1 Figure 18: Pin Assignment of J0802 Table 8: Pin Definition of J0802 Pin No. 1 2 3 4 5, 6 Pin Name MIC AGND SPK_R SPK_L NC Description Microphone input Dedicated GND for audio Right channel of stereo audio output Left channel of stereo audio output Not connected LTE_OPEN_EVB_User_Guide 29 / 62 LTE Module Series LTE OPEN EVB User Guide The following figure shows the sketch design of audio plug which suits for the audio jack on LTE OPEN EVB. 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 19: Sketch of Audio Plug 4.5.2.3. Handset Interface (J0801) Audio interface J0801 is designed for handsets. A reference circuit design for handset interfaces J0801 is shown below. U0101 Codec ALC5616 TLV3104 IN2P IN2N LOUDL/P LOUDR/N J0804 FB BTB CON 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD J0801 4 1 3 2 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD Figure 20: Reference Circuit Design for Handset Interface J0801 LTE_OPEN_EVB_User_Guide 30 / 62 LTE Module Series LTE OPEN EVB User Guide The figure and table below illustrate the pin assignment and pin definition of handset interface J0801. 4 2 31 Figure 21: Pin Assignment of J0801 Table 9: Pin Definition of J0801 Pin No. 1 2 3 4 Pin Name MICN SPKN SPKP MICP Function Negative microphone input Negative loudspeaker output Positive loudspeaker output Positive microphone input 4.6. U(SIM) Interface (J0901) LTE OPEN EVB has two 6-pin push-push type U(SIM) card (3.0V or 1.8V) connectors J0901 and J0902, and J0902 is reserved for future use. The following figure shows the simplified interface schematic for J0901. LTE_OPEN_EVB_User_Guide 31 / 62 LTE Module Series LTE OPEN EVB User Guide USIM_VDD 12 USIM_DATA 10 USIM_CLK 8 USIM_RST 6 USIM_PRESENCE 14 J0101 Push-Push C1 USIM_VDD C7 USIM_DATA C3 USIM_CLK C2 USIM_RST CD2 USIM_PRE. CD1 USIM_GND U(SIM) card connector GND J0901 Figure 22: Simplified Interface Schematic for U(SIM) Card Connector J0901 The figure and table below illustrate the pin assignment and pin definition of J0901. CD1 CD2 C7C3C6C2 C5C1 C7 C6 C5 C3 C2 C1 Figure 23: Pin Assignment of J0901 Table 10: Pin Definition of J0901 Pin No. C1 C2 C3 C5 Signal Name USIM_VDD USIM_RST USIM_CLK GND I/O Function U(SIM) card power supply, provided by PO LTE OPEN EVB DO U(SIM) card reset signal DO U(SIM) card clock signal / Ground LTE_OPEN_EVB_User_Guide 32 / 62 LTE Module Series LTE OPEN EVB User Guide C6 C7 CD1 CD2 VPP / USIM_DATA IO GND / USIM_PRESENCE DI Not connected Data line, bidirectional U(SIM) card insertion detection U(SIM) card insertion detection. Support low level detection. If (U)SIM hot-plug function is intended to be used, then please short the signal illustrated in the figure and table below. Figure 24: (U)SIM Hot-Plug GPIO Configuration Table 11: (U)SIM Hot-Plug GPIO Configuration Pin No. Pin 3 (J0202) Pin Name USIM1_PRESENCE Operation Shorted to Pin No. Pin 4 (J0202) Pin Name GPIO_34 4.7. SD Card Interfaces & eMMC (J0701/J0702 & U0702) LTE OPEN EVB provides two SD card interfaces (J0701 and J0702), which can be used for micro SD cards and standard SD cards respectively. These two interfaces support maximally 32GB and cannot be used simultaneously. With the SD card interface, customers can easily enhance the memory capacity of modules. LTE_OPEN_EVB_User_Guide 33 / 62 LTE Module Series LTE OPEN EVB User Guide The following figure shows the simplified interface schematic for J0701, J0702 and U0702. J0101 SDC2 U0701 Analog switch SEL GPIO S0701 J0201 J0701 SDIO SD card connector SDIO DET J0702 SD card connector U0702 SDIO eMMC RESET Figure 25: Simplified Interface Schematic for SD Card Interface J0701, J0702 1 2345678 Figure 26: Pin Assignment of J0701 DET 9 1 2 34 5 6 78 Figure 27: Pin Assignment of J0702 LTE_OPEN_EVB_User_Guide 34 / 62 LTE Module Series LTE OPEN EVB User Guide Figure 28: eMMC Device Table 12: Pin Definition of J0701 Pin No. 1 2 3 4 5 6 7 8 Signal Name DAT2 CD/DAT3 CMD VDD CLK VSS DAT0 DAT1 I/O1) Function IO SDIO data line 2 IO Card detect/SDIO data line 3 IO SDIO command line PO Supply voltage DO SDIO clock / Power supply GND IO SDIO data line 0 IO SDIO data line 1 NOTE 1) Direction: from connector to SD card. LTE_OPEN_EVB_User_Guide 35 / 62 Table 13: Pin Definition of J0702 Pin No. 1 2 3 4 5 6 7 8 9 Signal Name CD/DAT3 CMD VSS VDD CLK VSS2 DAT0 DAT1 DAT2 DET LTE Module Series LTE OPEN EVB User Guide I/O1) Function IO Card detect/SDIO data line 3 IO SDIO command line / Power supply GND P Supply voltage IO SDIO clock / Power supply GND IO SDIO data line 0 IO SDIO data line 1 IO SDIO data line 2 DI SD card detect NOTE 1) Direction: from connector to SD card. Table 14: S0701 Function Switched Direction Left Right Description Enable SD card function Enable eMMC function If SD card function is intended to be used, then please switch S0701 to the left and short the signal illustrated in the figure and table below. After that, a standard SD card can be inserted into J0702 or a micro SD card into J0701. LTE_OPEN_EVB_User_Guide 36 / 62 LTE Module Series LTE OPEN EVB User Guide Figure 29: SD Card Function GPIO Configuration Table 15: SD Card Function GPIO Configuration Pin No. Pin 37 (J0201) Pin Name SD_INS_DET Operation Shorted to Pin No. Pin 38 (J0201) Pin Name GPIO_26 If eMMC function is intended to be used, then please switch S0701 to the right and short the signal illustrated in the figure and table below. Figure 30: eMMC Function GPIO Configuration LTE_OPEN_EVB_User_Guide 37 / 62 Table 16: eMMC Function GPIO Configuration Pin No. Pin 39 (J0201) Pin Name EMMC_RSTN Operation Shorted to LTE Module Series LTE OPEN EVB User Guide Pin No. Pin 38 (J0201) Pin Name GPIO_26 4.8. UART Interfaces (J0501/J0502/J0503) LTE OPEN EVB offers three UART interfaces: COM (DEBUG) J0501, COM3 (MAIN) J0502 and COM (UART1) J0503.  J0501 can be used for Linux console and log output.  J0502 is intended for the communication between the module and the host application. It can be used for data transmission and AT command communication.  J0503 is intended for the communication between the module and the host application. It can be used for data transmission. The following figure shows the block diagram of J0501/J0502/J0503 on LTE OPEN EVB. J0501 COM (DEBUG) DB9 RS-232 J0503 COM (UART1) DB9 RS-232 J0502 COM (MAIN) DB9 RS-232 U0502 RS-232 Level Match U0502 RS-232 Level Match U0501 RS-232 Level Match 3.0V 3.0V 3.0V U0504 3.0V/1.8V Level Translator 1.8V U0504 3.0V/1.8V Transistor Level Translator 1.8V U0503 3.0V/1.8V Transistor Level Translator 1.8V LTEQuecOpen Module J0101 Figure 31: UART Block Diagram LTE_OPEN_EVB_User_Guide 38 / 62 LTE Module Series LTE OPEN EVB User Guide The pin assignment and pin definition of J0501/J0502/J0503 are illustrated below. 98 7 6 54 321 Figure 32: Pin Assignment of J0501 Table 17: Pin Definition of J0501 Pin No. 1, 6, 7, 8, 9 2 3 4 5 Signal Name / RS232_RXD RS232_TXD RS232_DTR RS232_GND I/O Description / Not connected DI Receive Data DO Transmit data DI Data terminal ready / GND 9876 5 4 321 Figure 33: Pin Assignment of J0502 LTE_OPEN_EVB_User_Guide 39 / 62 LTE Module Series LTE OPEN EVB User Guide Table 18: Pin Definition of J0502 Pin No. 1 2 3 4 5 6 7 8 9 Signal Name NC RS232_RXD RS232_TXD RS232_DTR RS232_GND NC RS232_RTS RS232_CTS NC I/O Description / Not connected DI Receive data DO Transmit data DI Data terminal ready / GND / Not connected DI Request to send DO Clear to send / Not connected 987 6 54 3 21 Figure 34: Pin Assignment of J0503 Table 19: Pin Definition of J0503 Pin No. 1 2 3 Signal Name NC RS232_RXD RS232_TXD I/O Description / Not connected DI Receive data DO Transmit data LTE_OPEN_EVB_User_Guide 40 / 62 LTE Module Series LTE OPEN EVB User Guide 4 NC / Not connected 5 RS232_GND / GND 6 NC / Not connected 7 RS232_RTS DI Request to send 8 RS232_CTS DO Clear to send 9 NC / Not connected If COM (MAIN) and COM (UART1) functions are intended to be used, then please short the signals illustrated in the figure and table below. Figure 35: COM (MAIN) & COM (UART1) Function GPIO Configuration Table 20: COM (MAIN) & COM (UART1) Function GPIO Configuration Pin No. Pin Name COM (MAIN) J0502 Pin 5 (J0202) MAIN_TXD Pin 7 (J0202) MAIN_RXD Pin 9 (J0202) MAIN_RTS Pin 11 (J0202) MAIN_CTS Operation Shorted to Shorted to Shorted to Shorted to Pin No. Pin 6 (J0202) Pin 8 (J0202) Pin 10 (J0202) Pin 12 (J0202) Pin Name GPIO_0 GPIO_1 GPIO_2 GPIO_3 LTE_OPEN_EVB_User_Guide 41 / 62 COM (UART1) J0503 Pin 15 (J0201) UART1_RTS Pin 18 (J0201) UART1_CTS Pin 21 (J0201) UART1_TXD Pin 24 (J0201) UART1_RXD Shorted to Shorted to Shorted to Shorted to LTE Module Series LTE OPEN EVB User Guide Pin 14 (J0201) Pin 17 (J0201) Pin 20 (J0201) Pin 23 (J0201) GPIO_6 GPIO_7 GPIO_4 GPIO_5 4.9. SPI Flash (U0601) LTE OPEN EVB includes one SPI Flash device (U0601), as shown in the following figure. Figure 36: SPI Flash Device If the function is intended to be used, then please short the signals illustrated in the figure and table below. Figure 37: SPI Flash Function GPIO Configuration LTE_OPEN_EVB_User_Guide 42 / 62 Table 21: SPI Flash Function GPIO Configuration Pin No. Pin 3 (J0201) Pin 6 (J0201) Pin 9 (J0201) Pin 12 (J0201) Pin Name SPI_MOSI SPI_MISO SPI_CS_N SPI_CLK Operation Shorted to Shorted to Shorted to Shorted to LTE Module Series LTE OPEN EVB User Guide Pin No. Pin 2 (J0201) Pin 5 (J0201) Pin 8 (J0201) Pin 11 (J0201) Pin Name GPIO_20 GPIO_21 GPIO_22 GPIO_23 4.10. EEPROM (U0903) LTE OPEN EVB includes one EEPROM device (U0903), as shown in the following figure. Figure 38: EEPROM Device If the function is intended to be used, then please short the signals illustrated in the figure and table below. Figure 39: EEPROM Function GPIO Configuration LTE_OPEN_EVB_User_Guide 43 / 62 Table 22: EEPROM Function GPIO Configuration Pin No. Pin 14 (J0201) Pin 17 (J0201) Pin Name I2C_SDA I2C_SCA Operation Shorted to Shorted to LTE Module Series LTE OPEN EVB User Guide Pin No. Pin 13 (J0201) Pin 16 (J0201) Pin Name GPIO_6 GPIO_7 4.11. Switches and Buttons LTE OPEN EVB includes five switches (S0201, S0301, S0401, S1001 and S0701) and two buttons (S0402 and S0403), as shown in the following figures. S1001 S0201 S0701 Figure 40: S0201/S0701/S1001 Switch S0301 S0401 S0403 S0402 Figure 41: S0301/S0401 Switch and S0403/S0402 Button LTE_OPEN_EVB_User_Guide 44 / 62 LTE Module Series LTE OPEN EVB User Guide Table 23: Description of Switches and Buttons Reference No. S0301 S0401 S1001 S0201 S0701 S0403 S0402 Description VBAT ON/OFF control Reserved for internal testing. Switch it to down by default.  Switched to left: connect BT interface (PCM) of AF20 to the PCM interface of AG35 module  Switched to right: connect the codec board interface (J0804) on EVB to the PCM interface of LTE-QuecOpen modules  Switched to left: connect the GPIO interface of J0203 to the module’s SDC1 interface, for testing customers’ own modules  Switched to right: connect the SDIO interface of FC20 and AF20 modules to SDC1 interface of LTE-QuecOpen modules  Switched to left: connect SD interface of EVB to SDC2 interface of LTE-QuecOpen modules  Switched to right: connect eMMC to SDC2 interface of LTE-QuecOpen modules Power key (push button), used to turn on/off LTE-QuecOpen modules Reset button (push button), used to reset LTE-QuecOpen modules 4.12. Status Indicators LTE OPEN EVB provides 8 status indicators: D0310, D0311, D0312, D0313, D0201, D0202, D0203 and D0204. The following figure shows the location of these LED indicators. D0310 D0311 D0312 D313 D0204 D0203 D0202 D0201 Figure 42: Status Indication LEDs LTE_OPEN_EVB_User_Guide 45 / 62 LTE Module Series LTE OPEN EVB User Guide Table 24: Description of Status Indication LEDs Reference No. Description D0310 D0311 D0312 VBAT ON/OFF indicator. Bright: VBAT ON Extinct: VBAT OFF Power ON/OFF indicator for LTE-QuecOpen modules Bright: the module is powered on Extinct: the module is powered off Network status indicator for LTE-QuecOpen modules For detailed information, please refer to document [2]. D0313 Power saving mode status indicator for BG96-QuecOpen module D0201~D0204 Used for GPIO testing, and a high level will light up the LEDs 4.13. GPIO Interfaces J0202 29 30 J0201 37 38 39 12 123 Figure 43: GPIO Jumpers J0201 and J0202 Table 25: Pin Definition of J0202 Pin No. 29 27 Pin Name GND COEX_UART_TX LTE_OPEN_EVB_User_Guide Pin No. 30 28 Pin Name GND GPIO_36 46 / 62 25 COEX_UART_RX 23 WLAN_EN 21 WAKE_WLAN 19 PCM_SYNC 17 PCM_CLK 15 PCM_OUT 13 PCM_IN 11 MAIN_CTS 9 MAIN_RTS 7 MAIN_RXD 5 MAIN_TXD 3 USIM1_PRESENCE 1 VDD_1V8 LTE Module Series LTE OPEN EVB User Guide 26 GPIO_37 24 GPIO_38 22 GPIO_59 20 GPIO_79 18 GPIO_78 16 GPIO_77 14 GPIO_76 12 GPIO_3 10 GPIO_2 8 GPIO_1 6 GPIO_0 4 GPIO_34 2 VDD_1V8 Table 26: Pin Definition of J0201 Pin No. 37 34 31 28 25 22 19 16 13 Pin Name SD_INS_DET EPHY_INT_N EPHY_RST_N SGMII_MDATA SGMII_CLK NC NC I2C_SCL I2C_SDA Pin No. 38 35 32 29 26 23 20 17 14 Pin Name GPIO_26 GPIO_30 GPIO_29 GPIO_28 GPIO_27 GPIO_5 GPIO_4 GPIO_7 GPIO_6 Pin No. 39 36 33 30 27 24 21 18 15 Pin Name EMMC_RSTN USIM2_PRENSCE USIM2_RST USIM2_CLK USIM2_DATA UART1_RXD UART1_TXD UART1_CTS UART1_RTS LTE_OPEN_EVB_User_Guide 47 / 62 LTE Module Series LTE OPEN EVB User Guide 10 UART2_CTS_BT 11 7 UART2_RTS_BT 8 4 UART2_RXD_BT 5 1 UART2_TXD_BT 2 GPIO_23 12 GPIO_22 9 GPIO_21 6 GPIO_20 3 SPI_CLK SPI_CS_N SPI_MISO SPI_MOSI The name of the GPIO pins on LTE OPEN EVB are defined based on EC2x-QuecOpen modules. The pin assignment of AG35-QuecOpen and BG96-QuecOpen modules differs from that of EC2x-QuecOpen modules. The following table lists the detailed GPIO number on AG35-QuecOpen module. Table 27: GPIO List for AG35-QuecOpen Module AG35-QuecOpen AG35-QuecOpen Pin No. Pin Name 6 EPHY_RST_N GPIO Number on AG35-QuecOpen Module / Pin Name on LTE OPEN EVB GPIO_29 (J0201) 7 SGMII_CLK / GPIO_27 (J0201) 8 SGMII_DATA / GPIO_28 (J0201) 9 EPHY_INT_N GPIO_30 USIM_ 25 GPIO_34 PRESENCE 42 I2C1_SDA GPIO_18 GPIO_30 (J0201) GPIO_34 (J0202) GPIO_6 (J0201) 43 I2C1_SCL GPIO_19 GPIO_7 (J0201) 52 SDC2_INS_DET GPIO_26 GPIO_26 (J0201) 56 UART1_CTS GPIO_3 GPIO_3 J0202) 57 UART1_RTS GPIO_2 GPIO_2 (J0202) 58 UART1_RXD GPIO_1 GPIO_1 (J0202) 59 GPIO1 GPIO_38 GPIO_4 (J0201) 60 UART1_TXD GPIO_0 GPIO_0 (J0202) 61 GPIO2 GPIO_75 GPIO6 (J0203) 62 GPIO3 GPIO_74 GPIO_5 (J0201) LTE_OPEN_EVB_User_Guide 48 / 62 65 PCM_SYNC GPIO_79 66 PCM_IN GPIO_76 67 PCM_CLK GPIO_78 68 PCM_OUT GPIO_77 73 I2C2_SDA GPIO_6 74 I2C2_SCL GPIO_7 77 SPI_MOSI GPIO_20 78 SPI_MISO GPIO_21 79 SPI_CS_N GPIO_22 80 SPI_CLK GPIO_23 143 OTG_PWR_EN GPIO_41 144 GPIO4 GPIO_25 147 GPIO5 GPIO_24 149 WLAN_EN GPIO_54 150 GPIO6 GPIO_42 159 GPIO7 GPIO_58 160 WLAN_WAKE GPIO_59 163 UART2_TXD GPIO_8 164 UART2_CTS GPIO_11 165 UART2_RXD GPIO_9 166 UART2_RTS GPIO_10 LTE Module Series LTE OPEN EVB User Guide GPIO_79 (J0202) GPIO_76 (J0202) GPIO_78 (J0202) GPIO_77 (J0202) R0922 R0921 SPI_MOSI_AG35 (J1005) SPI_MISO_AG35 (J1005) SPI_CS_AG35 (J1005) SPI_CLK_AG35 (J1005) OTG_PWR_EN (J0603) GPIO3 (J0203) GPIO5 (J0203) GPIO_38 (J0202) GPIO1 (J0203) GPIO1_AG35 GPIO_59(J0202) GPIO_20 (J0201) GPIO_23 (J0201) GPIO_21 (J0201) GPIO_22 (J0201) NOTE The differences of GPIO pins for BG96-QuecOpen module will be added in a future release. LTE_OPEN_EVB_User_Guide 49 / 62 LTE Module Series LTE OPEN EVB User Guide Usage Examples  If GPIO output test function is intended to be used, then please connect the GPIO to be tested of J0201/J0202 to any one of J0204 pin 2~5. When the GPIO outputs a high-level, the LED will light up.  If GPIO input test function is intended to be used, then please connect the GPIO to be tested of J0201/J0202 to J0204 pin 1 (VDD_1V8) or pin 6 (GND). 4.14. Test Points LTE OPEN EVB provides a series of test points. They can help customers to obtain the corresponding waveform of some signals. The following two figures show test points J1003, J1004, J1005, J1006, J0505, J1007, J0203 and J0204. J1004 J1006 10 9 10 9 8 78 7 6 56 5 4 34 3 2 12 1 10 9 8 7 6 5 4 3 2 1 J1005 Figure 44: Test Point J1004/J1005/J1006 LTE_OPEN_EVB_User_Guide 50 / 62 LTE Module Series LTE OPEN EVB User Guide J1003 10 9 87 65 43 21 J0505 6 5 4 3 2 1 J1007 10 9 87 65 43 21 J0204 6 5 4 3 2 1 J0203 12 34 56 78 9 10 11 12 13 14 15 16 Figure 45: Test Point J1003/J0505/J1007/J10204/J0203 Table 28: Pin Definition of Test Points J0203 Pin No. 1 2 3 4 5 6 7 8 Pin Name GPIO1 GPIO2 GPIO3 GPIO4 GPIO5 GPIO6 GPIO_12 GPIO_13 Description Connect directly to LTE-QuecOpen modules Connect to LTE-QuecOpen modules with analog switch U0201. If GPIO function is intended to be used, S0201 should be switched to the left. LTE_OPEN_EVB_User_Guide 51 / 62 9 10 11 12 13 14 15 16 J0203 Pin No. 1 2 3 4 5 6 J0505 Pin No. 1 2 3 4 5 6 J1003 GPIO_14 GPIO_15 GPIO_16 GPIO_17 GPIO_18 GPIO_19 GRFC1 GRFC2 Reserved Reserved Reserved Reserved LTE Module Series LTE OPEN EVB User Guide Pin Name VDD_1V8 LED1 LED2 LED3 LED4 GND Description 1.8V power supply from U0401 Can be connected to any GPIO. Used for GPIO output test. GND Pin Name Description WDOG_DISABLE Reserved GND GND DEBUG_RXD_3.3V DEBUG_TXD_3.3V DEBUG_TXD_1.8V Used for test DEBUG_RXD_1.8V LTE_OPEN_EVB_User_Guide 52 / 62 LTE Module Series LTE OPEN EVB User Guide Pin No. 1 2 3 4 5 6 7 8 9 10 J1004 Pin No. 1, 3, 5, 7 2 4 6 8 Pin Name VDD_3.3V PCM_SYNC VDD_1V8 PCM_IN I2C_SDA PCM_OUT I2C_SCL PCM_CLK CLK_OUT GND Description 3.3V power supply from U0402 Connected to J0202 pin 19 with analog switch U1001. If this function is intended to be used, S1001 should be switched to the right. 1.8V power supply from U0401 Connected to J0202 pin 13 with analog switch U1001. If this function is intended to be used, S1001 should be switched to the right. Connected directly to J0201 pin 13 Connected to J0202 pin 15 with analog switch U1001. If this function is intended to be used, S1001 should be switched to the right. Connected directly to J0201 pin 16 Connected to J0202 pin 17 with analog switch U1001. If this function is intended to be used, S1001 should be switched to the right. Reserved Ground Pin Name DTR_TEST VDD_EXT POWER_EN PWRKEY_3.0V RESET_3.0V Description Data terminal ready test pins. Customers can connect COM (MAIN) to PC, and use the UART tool to control DTR. Connected directly to VDD_EXT of LTE-QuecOpen modules VBAT enable pin. Connect it to DTR_TEST pin, and then the VBAT of LTE-QuecOpen modules can be controlled by PC DTR. When DTR is at high level, VBAT will be switched off. PWRKEY_3.0V test pin. Connect it to DTR_TEST pin, and then PWRKEY of LTE-QuecOpen modules can be controlled by PC DTR. When DTR is at high level, PWRKEY will be pulled down to start up the module. RESET_3.0V test pin. Connect it to DTR_TEST pin, and then RESET of LTE-QuecOpen LTE_OPEN_EVB_User_Guide 53 / 62 10 J1005 Pin No. 1 2 3 4 5 6 7 8 9 10 J1006 Pin No. 1 2 3 4 5 6 VBUS_TEST LTE Module Series LTE OPEN EVB User Guide modules can be controlled by PC DTR. When DTR is at high level, RESET will be pulled down to reset the module. USB_VBUS enable pin. Connect it to DTR_TEST pin, and then USB_VBUS of LTE-QuecOpen modules can be controlled by PC DTR. When DTR is at low level, USB_VBUS will be switched off to disable recognition of module’s USB. Pin Name SPI_CS_N_AG35 VDD_1V8 SPI_MOSI_AG35 USB_BOOT SPI_MISO_AG35 SPI_MRDY SPI_CLK_AG35 SPI_SRDY GND GND Description Connected directly to AG35-QuecOpen module Connected directly to U0401. Connect it to USB_BOOT pin will make the EC2x/AG35-QuecOpen module enter into emergency download mode. Connected directly to AG35-QuecOpen module Connected directly to EC2x/AG35-QuecOpen module. Connect it to USB_BOOT pin will make the EC2x/AG35-QuecOpen modules enter into emergency download mode. Connected directly to AG35-QuecOpen module Reserved Connected directly to AG35-QuecOpen module Reserved GND GND Pin Name MAIN_RTS_1.8V MAIN_RTS_3.0V MAIN_CTS_1.8V MAIN_CTS_3.0V MAIN_RXD_1.8V MAIN_RXD_3.0V Description Used for test LTE_OPEN_EVB_User_Guide 54 / 62 7 8 9 10 J1007 Pin No. 1 2 3 4 5 6 7 8 9 10 LTE Module Series LTE OPEN EVB User Guide MAIN_TXD_1.8V MAIN_TXD_1.8V VDD_1V8 GND 1.8V power supply from U0401 GND Pin Name Description UART1_RTS_3.0V UART1_RTS_1.8V UART1_RXD_3.0V UART1_RXD_1.8V UART1_CTS_3.0V Used for test UART1_CTS_1.8V UART1_TXD_3.0V UART1_TXD_1.8V VDD_1V8 1.8V power supply from U0401 GND GND LTE_OPEN_EVB_User_Guide 55 / 62 LTE Module Series LTE OPEN EVB User Guide 5 Operation Procedures Illustration This chapter introduces how to use LTE OPEN EVB for testing and evaluation of Quectel LTE-QuecOpen and Wi-Fi modules. 5.1. Power on Modules 5.1.1. Power on LTE-QuecOpen Modules 1. Connect the TE-A of respective modules to the EVB via connectors J0101 and J0102. 2. Insert a (U)SIM card into the U(SIM) card connector J0901 on EVB, and connect the antennas to the TE-A. 3. Connect the EVB to a 5V power adapter, or connect the EVB to PC via USB to RS-232 converter cable. 4. Switch S0301 (POWER) to ON state, then D0310 (VBAT ON/OFF indicator) will light up. Press the S0403 (PWRKEY) for at least 100ms, then the module will be powered on and D0311 (power ON/OFF status indicator) will light up. 5.1.2. Power on Wi-Fi Modules Wi-Fi function is only supported on Quectel EC2x/AG35-QuecOpen module. BG96-QuecOpen does not support the function. 1. Make sure EC2x/AG35-QuecOpen module is powered on if there is a need to test the Wi-Fi function of them. 2. Connect the TE-A of Wi-Fi modules to the EVB via connectors J1001 and J1002, and then connect the Wi-Fi antenna to the TE-A. 3. Connect the TE-A to PC via an Ethernet cable. 4. Send AT+QWIFI=1 command to EC2x/AG35-QuecOpen module to enable power supply for Wi-Fi modules. For more details, please refer to document [2], [3] and [4]. Before sending the command, please make sure the EVB has been connected to PC via USB to RS-232 converter cable. LTE_OPEN_EVB_User_Guide 56 / 62 LTE Module Series LTE OPEN EVB User Guide The following table shows EC2x/AG35-QuecOpen module’s network status which is indicated via D0312. Table 29: Indication of D0312 Status Indication LEDs D0312 NET_STATUS State Flicker slowly (200ms ON/1800ms OFF) Flicker slowly (1800ms ON/200ms OFF) Flicker slowly (125ms ON/125ms OFF) Network Status Network searching Idle mode Data is being transferred over 2G/3G/4G network Always ON Voice calling 5.2. Communication Via USB or UART Interface 5.2.1. Communication via USB Interface 1. Power on the LTE-QuecOpen module according to the procedures mentioned in Chapter 5.1.1. 2. Connect the EVB and the PC with Micro-USB cable through USB interface, and then run the driver disk on PC to install the USB driver. For details about USB driver installation, please refer to document [1]. The USB port numbers can be viewed through the PC Device Manager, as shown below. Figure 46: USB Ports 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting field on QCOM: select correct 'COM port' (USB AT Port which is shown in above figure) and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [6]. LTE_OPEN_EVB_User_Guide 57 / 62 LTE Module Series LTE OPEN EVB User Guide Figure 47: COM Port Setting Field on QCOM (USB AT Port Connection) 5.2.2. Communication via UART Interface 1. Run the driver disk on PC to install the USB to RS-232 driver. 2. Connect the main UART interface of module to PC with the USB to RS-232 converter cable, and the USB serial port number can be checked through the PC Device Manager, as shown below. Figure 48: USB Serial Port 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting field on QCOM: select correct 'COM port' (USB Serial Port) and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [6]. Figure 49: COM Port Setting Field on QCOM (USB Serial Port Connection) LTE_OPEN_EVB_User_Guide 58 / 62 LTE Module Series LTE OPEN EVB User Guide 5.3. Firmware Upgrade The firmware of Quectel LTE-QuecOpen modules is upgraded via USB port by default. Please follow the procedures below to upgrade firmware. 1. Install and open the firmware upgrade tool QFlash on PC and then power on the LTE-QuecOpen modules according to the procedures mentioned in Chapter 5.1.1. 2. Click the 'COM Port' dropdown list and select the USB DM port. 3. Click the 'Load FW Files' button to choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. Figure 50: QFlash Configurations for Firmware Upgrade 5.4. Reset Modules The emergency reset option is only used in case of emergency. For example, the software does not respond for more than 5s due to some serious problems. Press the button S0402 (RESET) for more than 150ms then release it to reset LTE-QuecOpen modules. However, this operation may cause the loss of information stored in the memory as the reset module has been initialized. LTE_OPEN_EVB_User_Guide 59 / 62 LTE Module Series LTE OPEN EVB User Guide 5.5. Power off Modules 5.5.1. Power off LTE-QuecOpen modules There are two ways to power off LTE-QuecOpen modules. One way is to execute AT+QPOWD command, and this is the best and the safest way. The module will log off from the network and save data before shutdown, but it will be powered on again after shutdown. For more details about the AT command, please refer to document [5]. The other way is to press down S0302 (PWRKEY) for at least 0.6s, and then the module will be powered off. 5.5.2. Power off Wi-Fi modules AT+QWIFI=0 command can be used to power off Wi-Fi modules. For more details, please refer to document [3] and [4]. LTE_OPEN_EVB_User_Guide 60 / 62 LTE Module Series LTE OPEN EVB User Guide 6 Appendix A References Table 30: Related Documents SN Document Name Quectel_LTE_Windows_USB_Drivers_Installation_ [1] Guide [2] Quectel_xx_Hardware_Design [3] Quectel_FC20_Series_Hardware_Design [4] Quectel_AF20_Hardware_Design [5] Quectel_xx_AT_Commands_Manual [6] Quectel_QCOM_User_Guide Remark Windows USB driver installation guide for EC2x, BG96 and AG35 modules Respective hardware design for EC2x/BG96/AG35-QuecOpen modules FC20 series hardware design AF20 hardware design AT commands manual of EC2x, BG96 and AG35 modules User guide for QCOM tool Table 31: Terms and Abbreviations Abbreviation AGND BTB COM DC DI DO EVB GND GNSS Description Analogue Ground Board to Board Cluster Communication Port Direct Current Digital Input Digital Output Evaluation Board Ground Global Navigation Satellite System LTE_OPEN_EVB_User_Guide 61 / 62 I/O LED LTE MIC NC PC PCB PCM PO RF SD UART UMTS USB U(SIM) VBAT LTE Module Series LTE OPEN EVB User Guide Input/Output Light Emitting Diode Long Term Evolution Microphone Not Connected Private Computer Printed Circuit Board Pulse Code Modulation Power Output Radio Frequency Secure Digital Universal Asynchronous Receiver & Transmitter Universal Mobile Telecommunications System Universal Serial Bus (Universal) Subscriber Identity Module Voltage of Battery LTE_OPEN_EVB_User_Guide 62 / 62

Mini PCIe EVB 用户指导 UMTS/HSPA(+)/LTE Standard/LPWA 模块系列 版本：1.0 日期：2020-09-04 状态：受控文件 www.quectel.com Mini PCIe EVB 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 40 Mini PCIe EVB 用户指导 文档历史 修订记录 版本 1.0 日期 作者 2020-09-04 杨家准 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 40 Mini PCIe EVB 用户指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 .................................................................................................................................. 7 1.2. 安全须知 .................................................................................................................................. 8 2 综述 ........................................................................................................................................................ 9 2.1. 主要特性 .................................................................................................................................. 9 2.2. EVB 接口分布 ........................................................................................................................ 10 2.3. EVB 俯视图与底视图 ............................................................................................................. 12 2.4. EVB 配件 ............................................................................................................................... 13 3 EVB 组装套件 ...................................................................................................................................... 15 4 应用接口 ............................................................................................................................................... 16 4.1. 电源接口（J201/J302） ........................................................................................................ 16 4.2. USB 接口（J302） ................................................................................................................ 18 4.3. 音频接口（J501/J503/J502/J504） ...................................................................................... 19 4.3.1. 测试模块 PCM 功能的音频接口（J501/J503） ............................................................. 20 4.3.1.1. 耳机接口（J501） .......................................................................................... 20 4.3.1.2. 听筒接口（J503） .......................................................................................... 21 4.3.2. 测试 UC15 Mini PCIe 模拟音频功能的音频接口（J502/J504） .................................... 23 4.3.2.1. 听筒接口（J502） .......................................................................................... 23 4.3.2.2. 耳机接口（J504） .......................................................................................... 24 4.3.3. 音频插口示意图 .............................................................................................................. 26 4.4. (U)SIM 卡座（J303） ............................................................................................................ 26 4.5. 串口（J301） ........................................................................................................................ 28 4.6. 电源开关和复位按键（S201/S101）..................................................................................... 29 4.7. 状态指示灯（D103/D101） ................................................................................................... 30 4.8. 跳线（J401/J1031)/J2031)） .................................................................................................. 31 4.9. 测试点 .................................................................................................................................... 32 5 操作说明 ............................................................................................................................................... 34 5.1. 打开 Mini PCIe 模块电源 ....................................................................................................... 34 5.2. USB 或串口通信 .................................................................................................................... 34 5.2.1. USB 通信........................................................................................................................ 34 5.2.2. 串口通信 ......................................................................................................................... 35 5.3. 固件升级 ................................................................................................................................ 36 5.3.1. 固件升级（UC15/EC2x/EG2x-G/BGxx-M3 Mini PCIe） ............................................... 36 5.3.2. 固件升级（UC200T/EC200T Mini PCIe） ..................................................................... 37 5.4. Mini PCIe 模块复位................................................................................................................ 38 上海移远通信技术股份有限公司 3 / 40 Mini PCIe EVB 用户指导 5.5. Mini PCIe 模块关机................................................................................................................ 38 6 附件 A 参考文档及术语缩写................................................................................................................ 39 上海移远通信技术股份有限公司 4 / 40 Mini PCIe EVB 用户指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：主要特性 ............................................................................................................................................. 9 表 3：Mini PCIe EVB 接口描述 ...................................................................................................................11 表 4：清单列表 ........................................................................................................................................... 13 表 5：USB 接口（J302）引脚定义 ............................................................................................................ 18 表 6：耳机接口（J501）引脚定义 ............................................................................................................. 21 表 7：听筒接口（J503）引脚定义 ............................................................................................................. 22 表 8：听筒接口（J502）引脚定义 ............................................................................................................. 24 表 9：耳机接口座（J504）引脚定义.......................................................................................................... 25 表 10：(U)SIM 卡座（J303）引脚定义 ...................................................................................................... 27 表 11：串口引脚定义.................................................................................................................................. 29 表 12：电源开关、复位按键描述 ............................................................................................................... 30 表 13：状态指示灯描述 .............................................................................................................................. 30 表 14：J401 使用操作 ................................................................................................................................ 31 表 15：测试点描述 ..................................................................................................................................... 32 上海移远通信技术股份有限公司 5 / 40 Mini PCIe EVB 用户指导 图片索引 图 1：Mini PCIe EVB 俯视图（单位：mm） ............................................................................................. 10 图 2：Mini PCIe EVB 底视图（单位：mm） ............................................................................................. 10 图 3：Mini PCIe EVB 俯视图...................................................................................................................... 12 图 4：Mini PCIe EVB 底视图...................................................................................................................... 12 图 5：EVB 配件 ......................................................................................................................................... 13 图 6：Mini PCIe EVB 组装套件 .................................................................................................................. 15 图 7：电源框图 ........................................................................................................................................... 16 图 8：EVB 供电电源接口 ........................................................................................................................... 17 图 9：电源插头 ........................................................................................................................................... 17 图 10：USB 接口参考电路设计 .................................................................................................................. 18 图 11：音频编解码器参考电路设计 ............................................................................................................ 19 图 12：耳机参考电路设计 .......................................................................................................................... 20 图 13：耳机接口（J501）引脚分配 ........................................................................................................... 20 图 14：听筒接口（J503）参考电路设计.................................................................................................... 21 图 15：听筒接口（J503）引脚分配图 ....................................................................................................... 22 图 16：听筒接口（J502）参考电路设计.................................................................................................... 23 图 17：听筒接口座（J502）引脚分配图.................................................................................................... 23 图 18：耳机接口（J504）参考电路设计.................................................................................................... 24 图 19：耳机接口（J504）引脚分配 ........................................................................................................... 25 图 20：音频插口示意图 .............................................................................................................................. 26 图 21：(U)SIM 卡座（J303）参考电路设计............................................................................................... 26 图 22：(U)SIM 卡座（J303）引脚分配图 .................................................................................................. 27 图 23：串口框图 ......................................................................................................................................... 28 图 24：串口（J301）引脚分配图............................................................................................................... 28 图 25：电源开关和复位按键....................................................................................................................... 29 图 26：状态指示灯 ..................................................................................................................................... 30 图 27：测试点............................................................................................................................................. 32 图 28：UC15/EC2x/EG2x-G/BGxx-M3 Mini PCIe USB 端口 .................................................................... 34 图 29：UC200T/EC200T Mini PCIe USB 端口 .......................................................................................... 35 图 30：QCOM 工具 COM 端口设置（USB AT 端口连接）........................................................................ 35 图 31：USB 端口号 .................................................................................................................................... 35 图 32：QCOM 上的 COM 端口设置（USB 串行端口连接） ..................................................................... 35 图 33：固件升级配置（UC15/EC2x/EG2x-G/BGxx-M3 Mini PCIe）........................................................ 36 图 34：固件升级配置（UC200T/EC200T Mini PCIe）.............................................................................. 37 上海移远通信技术股份有限公司 6 / 40 Mini PCIe EVB 用户指导 1 引言 本文档介绍如何使用 Mini PCIe EVB 评估板，进行快速开发和测试移远通信 Mini PCIe 模块。 1.1. 适用模块 移远通信 Mini PCIe EVB 适用于以下模块。模块的相关详细信息请参考对应的硬件设计手册。 表 1：适用模块 模块系列 UMTS/HSPA(+) LTE Standard LPWA 模块 UC15 Mini PCIe UC200T Mini PCIe EC2x Mini PCIe: EC20 R2.1/EC21/EC25 Mini PCIe EG2x-G Mini PCIe: EG21-G/EG25-G Mini PCIe EC200T Mini PCIe BGxx-M3 Mini PCIe: BG95-M3/BG600L-M3 Mini PCIe 备注 上表所列模块产品可能包含多个型号，请参考各模块产品规格书了解详情。 上海移远通信技术股份有限公司 7 / 40 Mini PCIe EVB 用户指导 1.2. 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或(U)SIM 卡无效时。如果设备支持紧急呼叫功能，请使用紧急呼叫，同时请确保设备开机并 且位于信号强度足够的区域。因不能保证所有情况下网络都能连接，故在紧急情况 下，不能将带有紧急呼叫功能的设备作为唯一的联系方式。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 8 / 40 Mini PCIe EVB 用户指导 2 综述 移远通信为客户提供 Mini PCIe EVB 套件，供客户快速开发移远通信 Mini PCIe 模块的应用并测试其 基本功能。 2.1. 主要特性 下表描述了 Mini PCIe EVB 的主要特性。 表 2：主要特性 特性 供电 USB 接口 音频接口 (U)SIM 接口 UART 接口 指示灯 开关和按键 跳线端 物理特征 说明  供电范围：4.5~5.5 V，典型供电电压：5.0 V（J201）  VBAT：3.3 V（J204）  符合 USB 2.0 标准的 Micro-USB 接口  也可通过 USB_VBUS 为 EVB 供电  耳机（J501）和听筒（J503）两个模拟音频接口连接到音频编解码芯 片（ALC5616）以测试 PCM 功能  听筒（J502）和耳机（J504）两个模拟音频接口仅测试 UC15 Mini PCIe 模块的模拟音频功能  6-pin USIM/SIM 卡座  支持 USIM/SIM 卡：1.8 V 或 3.0 V  COM 口：用于数据传输和 AT 命令传送  最大波特率：460800 bps（默认为 115200 bps）  Mini PCIe 模块的网络状态指示灯  VBAT 电源开关指示灯  电源控制开关  模块复位按键 用于匹配 Mini PCIe 模块和 EVB 音频解码芯片的 PCM 电平，默认为 1.8 V 尺寸：94 mm × 58 mm 上海移远通信技术股份有限公司 9 / 40 Mini PCIe EVB 用户指导 COM (UART) 2.2. EVB 接口分布 58 音频接口 9 6 J502 94 USB_ON J103 GND W_DISABLE (U)SIM卡座 J303 1 2 J504 3V3 J101 Mini PCIe模块 J204 J202 51 52 测试点 VBAT GND D103 D101 指示灯 POWER_ON DTR_3.0 V J203 测试点 J201 S201 J302 测试点 J401 3V 3 V PCM 1.8 V 测试点 S101 电源接口 电源开关 Micro-USB 接口 复位按键 J102 5 J301 1 J501 J503 音频接口 图 1：Mini PCIe EVB 俯视图（单位：mm） 94 (U)SIM 卡座 J301 J303 J502 音频接口 5 9 58 COM 口 6 1 J503 音频接口 图 2：Mini PCIe EVB 底视图（单位：mm） 上海移远通信技术股份有限公司 J201 电源插孔 10 / 40 Mini PCIe EVB 用户指导 表 3：Mini PCIe EVB 接口描述 接口 供电 电源开关 复位按键 USB 接口 音频接口 (U)SIM 接口 UART 接口 指示灯 Mini PCIe 插槽 PCIe 支架 预留 跳线端 测试点 位号 描述 J201（底部）   EVB 电源插孔 供电范围：4.5~5.5 V，典型电源电压：5.0 V S201 VBAT 开关控制 S101 用于复位 Mini PCIe 模块 J302  符合 USB 2.0 标准的 Micro-USB 接口  也可通过 USB_VBUS 为 EVB 供电 J501  默认用于 Ф3.5 mm 耳机  用于测试 Mini PCIe 模块的 PCM 功能 J503（底部）   听筒接口 用于测试 Mini PCIe 模块的 PCM 功能 J502（底部）   听筒接口 仅用于测试 UC15 Mini PCIe 的模拟音频功能 J504  默认用于 Ф3.5 mm 耳机  仅用于测试 UC15 Mini PCIe 的模拟音频功能 J303（底部）   6-pin USIM/SIM 卡座 支持 USIM/SIM 卡：1.8 V 或 3.0 V J301（底部）   COM 口：用于数据通讯和 AT 命令通讯 最大波特率：460800 bps（默认为 115200 bps） D101、D103  D101：Mini PCIe 模块的网络状态指示灯  D103：VBAT 电源开关指示灯 J101 连接 Mini PCIe 模块和 EVB 的接口 J102 固定 Mini PCIe 模块 J202 J202 或 R207 可用于控制 DC-DC 输出和模块的 VBAT 之间的连接 J204 用于外部输入 3.3 V 电压，可测试模块的耗流 J103 引出模块的 W_DISABLE＃和 USB_ON 接口 J203 可通过控制 DTR_3.0 V 电平来控制模块是否供电 J401 用于匹配 Mini PCIe 模块和 EVB 音频解码芯片的 PCM 电平，默认为 1.8 V 详见第 4.9 章 测试 UART/PCM 信号 上海移远通信技术股份有限公司 11 / 40 2.3. EVB 俯视图与底视图 Mini PCIe EVB 的俯视图和底视图如下所示： Mini PCIe EVB 用户指导 图 3：Mini PCIe EVB 俯视图 图 4：Mini PCIe EVB 底视图 上海移远通信技术股份有限公司 12 / 40 2.4. EVB 配件 Mini PCIe EVB 套件的所有附件如下： U盘 铜柱 RF线 驱动光盘 Mini PCIe EVB 用户指导 USB数据线 GNSS天线 USB转RS-232串口线 耳机 表 4：清单列表 类型 数据线 天线 音频 光盘 图 5：EVB 配件 描述 USB 转 RS-232 串口线 USB 数据线 主天线 1) RF 线 GNSS 天线 耳机 USB 转 RS-232 串口驱动程序磁盘 上海移远通信技术股份有限公司 主天线 数量 1 1 2 3 1 1 1 13 / 40 Mini PCIe EVB 用户指导 U盘 其他 说明书 包含 Mini PCIe 模块驱动程序、相关文档和工具 1 铜柱用于固定 EVB 4 介绍了 EVB 的连接及附件的详细信息等 1 备注 1) 主天线也可用于分集接收。 上海移远通信技术股份有限公司 14 / 40 3 EVB 组装套件 下图为 Mini PCIe EVB 组装套件： Mini PCIe EVB 用户指导 图 6：Mini PCIe EVB 组装套件 上海移远通信技术股份有限公司 15 / 40 Mini PCIe EVB 用户指导 4 应用接口 本章主要介绍 Mini PCIe EVB 的硬件接口，如下所示：  电源接口  USB 接口  音频接口  (U)SIM 接口  串口 为了方便客户更好地使用 Mini PCIe EVB，EVB 上还提供电源开关、复位按键、LED 状态指示灯、跳 线和测试点等。 4.1. 电源接口（J201/J302） Mini PCIe EVB 可以通过外部电源适配器连接 EVB 上的电源插孔（J201）或 USB 接口（J302）来供 电。电源接口连接到降压芯片（U201），为 EVB 和 Mini PCIe 模块提供所需的 VBAT 电源。 下图分别为电源简化框图和电源接口图： S201 电源开关 U201 VBAT TPS54319RTER D202 D203 U202 R207 J202 3.3 V 为Mini PCIe 模块供电 1.8 V J201 电源插孔 J302 USB接口 U203 3.0 V 图 7：电源框图 上海移远通信技术股份有限公司 16 / 40 Mini PCIe EVB 用户指导 GND 5 V DC输入 图 8：EVB 供电电源接口 如果使用电源插孔供电，则适配器的电源插头示意图如下所示： 内为电源正极 外为电源负极 图 9：电源插头 上海移远通信技术股份有限公司 17 / 40 Mini PCIe EVB 用户指导 4.2. USB 接口（J302） 移远通信 Mini PCIe 模块提供符合 USB 2.0 标准的 USB 接口，支持高速（480 Mbps）模式。该接口 可用于 AT 命令通信、数据传输、固件升级和 GNSS NMEA 输出。 Mini PCIe EVB 提供 Micro-USB 接口（J302），用于连接主机设备。USB 数据线 USB_DP 和 USB_DM 直接连接到 Mini PCIe 模块。USB_VBUS 线可用于为 EVB 供电。 下图为 USB 接口参考设计： USB_DM 36 USB_DP 38 GND J101 差分走线 可为 EVB供电 NM_2 pF ESD Array 图 10：USB 接口参考电路设计 表 5：USB 接口（J302）引脚定义 引脚号 1 2 3 4 5 引脚名 USB_VBUS USB_DM USB_DP USB_ID GND 描述 可为 EVB 提供电源 USB 差分数据（-） USB 差分数据（+） 悬空 地 1 USB_VBUS 2 USB_DM 3 USB_DP 4 USB_ID 5 GND J302 上海移远通信技术股份有限公司 18 / 40 Mini PCIe EVB 用户指导 4.3. 音频接口（J501/J503/J502/J504） 移远通信 Mini PCIe 模块提供 1 个数字音频接口（PCM），另外 UC15 Mini PCIe 除了提供 1 个数字音 频接口之外，还提供 2 个模拟音频接口。Mini PCIe EVB 的音频编解码芯片（ALC5616）用于测试 Mini PCIe 模块的 PCM 功能，下图为该音频编解码器的参考电路设计。 4.7K 4.7K MIC_BIAS PCM_CLK 45 R PCM_SYNC 51 PCM_OUT 47 PCM_IN 49 I2C_SCL 30 I2C_SDA 32 J101 J401 1.8 V or 3.0 V MICBIAS1 32 24 BCLK1 C Codec IN2P 3 IN2N 4 23 LRCK1 ALC5616 HPO_L 20 22 DACDAT1 21 ADCDAT1 HPO_R 17 26 SCL 27 SDA LOUTP 9 LOUTN 10 U401 图 11：音频编解码器参考电路设计 麦克风 耳机 听筒 Mini PCIe EVB 提供 4 个模拟音频接口 J501、J503、J502 和 J504。J501 和 J503 通过连接音频编解 码芯片（ALC5616）来测试模块的 PCM 功能；J502 和 J504 仅用于测试 UC15 Mini PCIe 模块的模拟音 频功能。后续章节将详细介绍这 4 个音频接口。 上海移远通信技术股份有限公司 19 / 40 Mini PCIe EVB 用户指导 4.3.1. 测试模块 PCM 功能的音频接口（J501/J503） 4.3.1.1. 耳机接口（J501） 下图为耳机接口（J501）的参考电路设计： Codec IN2N 4 IN2P 3 HPO_R 17 HPO_L 20 AGND ALC5616 差分走线 4.7 μF GND GND GND AGND 33 pF 10 pF 10 pF 10 pF 33 pF 33 pF ESD ESD ESD 1 Audio Jack 3 5 4 2 J501 AGND GND 图 12：耳机参考电路设计 下图和表格说明了耳机接口（J501）的引脚分配和引脚定义： 6 5 4 3 2 1 图 13：耳机接口（J501）引脚分配 上海移远通信技术股份有限公司 20 / 40 表 6：耳机接口（J501）引脚定义 引脚号 1 2 3 4 5、6 引脚名 MIC AGND SPK_R SPK_L NC Mini PCIe EVB 用户指导 描述 麦克风信号输入 模拟地 右声道音频信号输出 左声道音频信号输出 悬空 4.3.1.2. 听筒接口（J503） 下图为听筒接口（J503）参考电路设计： Codec FB IN2P 3 IN2N 4 LOUTP 9 LOUTN 10 ALC5616 10 pF 33 pF 10 pF 33 pF 10 pF 33 pF ESD ESD 4 1 3 2 10 pF 33 pF 10 pF 33 pF 10 pF 33 pF J503 ESD ESD 图 14：听筒接口（J503）参考电路设计 上海移远通信技术股份有限公司 21 / 40 下图和表格说明了听筒接口（J503）的引脚分配和引脚定义： Mini PCIe EVB 用户指导 1 2 3 4 图 15：听筒接口（J503）引脚分配图 表 7：听筒接口（J503）引脚定义 引脚号 1 2 3 4 引脚名 MIC_N SPK_N SPK_P MIC_P 描述 麦克风信号输入（-） 扬声器输出信号（-） 扬声器输出信号（+） 麦克风信号输入（+） 上海移远通信技术股份有限公司 22 / 40 Mini PCIe EVB 用户指导 4.3.2. 测试 UC15 Mini PCIe 模拟音频功能的音频接口（J502/J504） 4.3.2.1. 听筒接口（J502） 下图为听筒接口（J502）参考电路设计： FB MIC_P (UC15 Mini PCIe) 1 MIC_N (UC15 Mini PCIe) 3 SPK_P (UC15 Mini PCIe) 5 SPK_N (UC15 Mini PCIe) 7 J101 10 pF 33 pF 10 pF 33 pF 10 pF 33 pF ESD ESD 4 1 3 2 10 pF 33 pF 10 pF33 pF 10 pF 33 pF J502 ESD ESD 图 16：听筒接口（J502）参考电路设计 下图为听筒接口（J502）引脚分配图： 1 3 2 4 图 17：听筒接口（J502）引脚分配图 上海移远通信技术股份有限公司 23 / 40 表 8：听筒接口（J502）引脚定义 引脚号 1 2 3 4 引脚名 MICN SPKN SPKP MICP Mini PCIe EVB 用户指导 描述 麦克风信号输入（-） 扬声器信号输出（-） 扬声器信号输出（+） 麦克风信号输入（+） 4.3.2.2. 耳机接口（J504） 下图为耳机接口（J504）参考电路设计： Differential layout 4.7 μF GND GND GND MIC_N (UC15 Mini PCIe) 3 MIC_P (UC15 Mini PCIe) 1 SPK_P (UC15 Mini PCIe) 5 SPK_N (UC15 Mini PCIe) 7 AGND AGND 33 pF 10 pF 10 pF 10 pF 33 pF 33 pF ESD ESD ESD 1 Audio Jack 3 5 4 2 J504 J101 AGND GND 图 18：耳机接口（J504）参考电路设计 上海移远通信技术股份有限公司 24 / 40 下图为耳机接口（J504）引脚分配图： 2 46 Mini PCIe EVB 用户指导 1 3 5 图 19：耳机接口（J504）引脚分配 表 9：耳机接口（J504）引脚定义 引脚号 1 2 3 4 5、6 引脚名 MIC2 AGND SPK2P SPK2N NC 描述 麦克风输入信号 模拟地 右声道音频信号输出 左声道音频信号输出 悬空 上海移远通信技术股份有限公司 25 / 40 4.3.3. 音频插口示意图 下图为适用于 Mini PCIe EVB 上音频接口的插口示意图： Mini PCIe EVB 用户指导 4 3 2 GND 1 SW SPK_R 32 Ω MIC 图 20：音频插口示意图 SPK_L 32 Ω 4.4. (U)SIM 卡座（J303） Mini PCIe EVB 具有 6-pin (U)SIM 卡座（1.8 V 或 3.0 V）。下图为(U)SIM 卡座（J303）简化接口示意 图： SIM_VDD 8 SIM_DATA 10 SIM_CLK 12 SIM_RST 14 GND J101 C1 SIM_VDD C7 SIM_DATA C3 SIM_CLK C2 SIM_RST GND SIM_GND (U)SIM卡座 J303 图 21：(U)SIM 卡座（J303）参考电路设计 上海移远通信技术股份有限公司 26 / 40 下图为(U)SIM 卡座（J303）引脚分配图和引脚定义： C1 C2 C3 C5 C6 C7 Mini PCIe EVB 用户指导 CD2 CD1 图 22：(U)SIM 卡座（J303）引脚分配图 表 10：(U)SIM 卡座（J303）引脚定义 引脚号 C1 C2 C3 C5 C6 C7 CD1 CD2 引脚名 SIM_VDD SIM_RST SIM_CLK GND VPP SIM_DATA / / I/O（模块方向） PO DO DO / / IO / / 描述 (U)SIM 卡供电电源 (U)SIM 复位信号 (U)SIM 时钟信号 地 悬空 (U)SIM 数据 悬空 悬空 上海移远通信技术股份有限公司 27 / 40 Mini PCIe EVB 用户指导 4.5. 串口（J301） Mini PCIe EVB 的串口用于模块和主机之间的数据传输和 AT 命令通信。 下图为 Mini PCIe EVB 上的串口框图： UART 接口 COM DB9 RS-232 RS-232 3.0 V 电平转换芯片 1.8 V 电平匹配芯片 J301 U301 U303 J101 图 23：串口框图 串口（J301）引脚分配图和引脚定义如下： 9 87 6 5 4 321 图 24：串口（J301）引脚分配图 上海移远通信技术股份有限公司 28 / 40 表 11：串口引脚定义 引脚号 1 2 3 4 5 6 7 8 9 引脚名 RS232_DCD RS232_RXD RS232_TXD RS232_DTR RS232_GND NC RS232_RTS RS232_CTS RS232_RI Mini PCIe EVB 用户指导 I/O（模块方向） DO DO DI DI / / DI DO DO 描述 输出载波检测 数据接收 数据发送 数据终端就绪 地 悬空 请求发送 清除发送 振铃提示 4.6. 电源开关和复位按键（S201/S101） Mini PCIe EVB 提供电源开关 S201 和复位按键 S101，如下图所示： S201 S101 图 25：电源开关和复位按键 上海移远通信技术股份有限公司 29 / 40 Mini PCIe EVB 用户指导 表 12：电源开关、复位按键描述 位号 S201 S101 描述 电源开关 Mini PCIe 模块复位按键 模块的复位操作如下：  UC15 Mini PCIe：将按键保持至低电平 50~200 ms 然后释放。  EC2x/EG2x-G Mini PCIe：将按键保持至低电平 150~460 ms，如果时间 超过 460 ms 模块将再次复位。  BGxx-M3 Mini PCIe：将按键保持至低电平 2000~3800 ms，如果时间超 过 3800 ms，模块将会再次复位。  UC200T/EC200T Mini PCIe：将按键保持至低电平 300 ms 以上然后释放。 4.7. 状态指示灯（D103/D101） Mini PCIe EVB 提供两个状态指示灯（D103 和 D101）。下图为它们在 EVB 上的位置： D103 D101 图 26：状态指示灯 表 13：状态指示灯描述 位号 D103 描述 VBAT 电源开关指示灯，指示 Mini PCIe 模块的电源是否准备就绪。  亮：VBAT ON  灭：VBAT OFF 上海移远通信技术股份有限公司 30 / 40 D101 Mini PCIe EVB 用户指导 网络状态指示灯，指示 Mini PCIe 模块的网络状态。 亮：注册网络  慢闪（200 ms 低/1800 ms 高）：找网状态  慢闪（1800 ms 低/200 ms 高）：待机状态  快闪（125 ms 低/125 ms 高）：数据传输模式 灭：  没有网络或未注册上网络  W_DISABLE#信号处于低电平  AT+CFUN=0 或 AT+CFUN=4  模块进入睡眠状态（仅适用于 UC15 Mini PCIe） 4.8. 跳线（J401/J1031)/J2031)） Mini PCIe EVB 提供了 3 个跳线：J401、J103 和 J203。J401 用于匹配 Mini PCIe 模块和 EVB 上的 音频编解码芯片之间的 PCM 信号电平。下表显示了跳线 J401 的操作。 如果需要使用飞行模式，请使用预留的跳线（J103）将 W_DISABLE#引脚短接到 GND。 如果需要通过 UART 的 DTR 控制电源，请将引脚 POWER_ON 和 DTR_3.0 V 与保留的跳线（J203） 短接。然后，当 DTR_3.0 V 处于高电平时可以关闭电源。 表 14：J401 使用操作 模块接口电平 3.0 V （UC15 Mini PCIe） 1.8 V （其他适用模块） J401 跳线 连接 3.0 V PCM 连接 1.8 V PCM 备注 1) 跳线 J103 和 J203 预留。 上海移远通信技术股份有限公司 31 / 40 Mini PCIe EVB 用户指导 4.9. 测试点 Mini PCIe EVB 提供了一些测试点，以便于客户获得相应的波形。下图为测试点信息： 表 15：测试点描述 测试点名 TXD CTS DTR RXD RI DCD RTS PCM_IN PCM_OUT 图 27：测试点 描述 连接到 Mini PCIe UART 接口的 TXD 连接到 Mini PCIe UART 接口的 RTS 连接到 Mini PCIe UART 接口的 DTR 连接到 Mini PCIe UART 接口的 RXD 连接到 Mini PCIe UART 接口的 RI 连接到 Mini PCIe UART 接口的 DCD 连接到 Mini PCIe UART 接口的 CTS 连接到 Mini PCIe PCM 接口的 PCM_IN 连接到 Mini PCIe PCM 接口的 PCM_OUT 上海移远通信技术股份有限公司 32 / 40 PCM_SYNC PCM_CLK CLK_OUT DD+ VBAT GND Mini PCIe EVB 用户指导 连接到 Mini PCIe PCM 接口的 PCM_SYNC 连接到 Mini PCIe PCM 接口的 PCM_CLK 为编解码器提供时钟 连接到 Mini PCIe USB 接口的 USB_DM 连接到 Mini PCIe USB 接口的 USB_DP 直接连接到 U201 的输出端 地 上海移远通信技术股份有限公司 33 / 40 Mini PCIe EVB 用户指导 5 操作说明 本章介绍如何使用 Mini PCIe EVB 来测试和评估移远通信 Mini PCIe 模块。 5.1. 打开 Mini PCIe 模块电源 1. 通过连接器 J101 将 Mini PCIe 模块连接到 EVB 上，并使用 USB 数据线或 5.0 V 电源适配器为 EVB 供电。 2. 将(U)SIM 卡插入 EVB 上的(U)SIM 卡座。 3. 将电源开关（S201）打开，然后 D103（VBAT ON/OFF 指示灯）将亮起，表示 EVB 的电源准备就绪。 模块将自动开机，模块在注册网络成功后，D101（NET_STATUS）将亮起。 5.2. USB 或串口通信 5.2.1. USB 通信 1. 按照第 5.1 章 所述步骤打开模块电源。 2. 确保 PC 上已成功安装对应模块的 USB 驱动程序（有关 USB 驱动程序安装的详细信息，请参考对应 模块的 USB 驱动安装指导）。再通过 USB 线连接 EVB 和 PC。可以通过 PC 设备管理器查看 USB 端口号，请注意，UC15/EC2x/EG2x-G/BGxx-M3 Mini PCIe 和 UC200T/EC200T Mini PCIe 的端口号 不同，如下所示： 图 28：UC15/EC2x/EG2x-G/BGxx-M3 Mini PCIe USB 端口 上海移远通信技术股份有限公司 34 / 40 Mini PCIe EVB 用户指导 图 29：UC200T/EC200T Mini PCIe USB 端口 3. 安装并使用移远通信提供的 QCOM 工具来实现 EVB 和 PC 之间的通信。下图显示了 QCOM 工具上 的 COM 端口设置：选择正确的'COM 端口'（USB AT 端口，如上图所示）并设置正确的'波特率' （例如 115200 bps）。有关 QCOM 工具使用和配置的更多详细信息，请参考文档 [1]。 图 30：QCOM 工具 COM 端口设置（USB AT 端口连接） 5.2.2. 串口通信 1. 按照第 5.1 章 所述步骤打开模块电源。 2. 通过光盘或 U 盘在 PC 上安装 USB 转 RS-232 串口的驱动程序。 3. 使用 USB 转 RS-232 串口数据线将模块的主串口连接到 PC 上，可通过 PC 设备管理器查看 USB 串 行端口号，如下图所示： 图 31：USB 端口号 4. 安装然后使用移远通信提供的 QCOM 工具来实现 EVB 和 PC 之间的通信。下图显示了 QCOM 上的 COM 端口设置：选择正确的'COM 端口'（USB 串行端口）并设置正确的'波特率'（如 115200 bps）。有关 QCOM 工具使用和配置的更多详细信息，请参考文档 [1]。 图 32：QCOM 上的 COM 端口设置（USB 串行端口连接） 上海移远通信技术股份有限公司 35 / 40 Mini PCIe EVB 用户指导 5.3. 固件升级 移远通信 Mini PCIe 模块默认通过 USB 端口升级固件。请按照以下步骤升级固件。 5.3.1. 固件升级（UC15/EC2x/EG2x-G/BGxx-M3 Mini PCIe） 1. 在 PC 上安装并打开固件升级工具 QFlash，然后按照第 5.1 章 所述步骤打开模块电源。 2. 单击'COM Port'下拉列表，选择 USB DM 端口。 3. 单击'Load FW Files'以选择固件包。 4. 单击'Start'开始固件升级。 图 33：固件升级配置（UC15/EC2x/EG2x-G/BGxx-M3 Mini PCIe） 上海移远通信技术股份有限公司 36 / 40 Mini PCIe EVB 用户指导 5.3.2. 固件升级（UC200T/EC200T Mini PCIe） 1. 在 PC 上安装并打开固件升级工具 Qflash（确保 Qflash 版本在 V4.12 以上），然后按照第 5.1 章 所 述步骤打开模块电源。 2. 单击'Load FW Files'按钮以选择固件压缩包。 3. 单击'Start'开始固件升级。 4. 根据提示复位 UC200T/EC200T Mini PCIe 模块开始固件升级。 图 34：固件升级配置（UC200T/EC200T Mini PCIe） 上海移远通信技术股份有限公司 37 / 40 Mini PCIe EVB 用户指导 5.4. Mini PCIe 模块复位 紧急复位选项仅在紧急情况下使用。例如：由于一些严重的问题，软件响应时间超过 5 秒。 模块的复位操作请参考第 4.6 章。 5.5. Mini PCIe 模块关机 Mini PCIe 模块可以通过以下两种方式关机：  通过 PC 执行 AT+QPOWD，这是最好也是最安全的关机方式。模块将在关机前注销网络并保存 数据，但在关机后将再次开机。有关 AT+QPOWD 命令的详细信息，请参考对应模块的 AT 命令 手册。  通过电源开关 S201 关闭电源。 上海移远通信技术股份有限公司 38 / 40 Mini PCIe EVB 用户指导 6 附件 A 参考文档及术语缩写 表 15：参考文档 序号 文档名称 [1] Quectel_QCOM_User_Guide 备注 QCOM 工具用户指导 表 16：术语缩写 术语 英文全称 AGND COM DC Analogue Ground Cluster Communication Port Direct Current DI DO DTR EVB GND GNSS Digital Input Digital Output Data Terminal Ready Evaluation Board Ground Global Navigation Satellite System I/O Input/Output LED Light Emitting Diode MIC Microphone NC PCM PO Not Connected Pulse Code Modulation Power Output 中文全称 模拟地 串行通讯端口 直流 数字输入 数字输出 数据终端就绪 评估板 地 全球导航卫星系统 输入/输出 发光二极管 麦克风 悬空 脉冲编码调制 电源输出 上海移远通信技术股份有限公司 39 / 40 Mini PCIe EVB 用户指导 RF Radio Frequency UART Universal Asynchronous Receiver & Transmitter USB Universal Serial Bus (U)SIM (Universal) Mobile Telecommunication System VBAT Voltage of Battery 射频 通用异步收发传输器 通用串行总线 （全球）用户识别卡 电池电压 上海移远通信技术股份有限公司 40 / 40

BC32-TE-B 用户指导 NB-IoT 模块系列 版本：BC32-TE-B_用户指导_V1.0 日期：2020-05-27 状态：受控文件 www.quectel.com BC32-TE-B 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 28 文档历史 修订记录 版本 1.0 日期 2020-05-27 作者 何道圆 变更表述 初始版本 BC32-TE-B 用户指导 上海移远通信技术股份有限公司 2 / 28 BC32-TE-B 用户指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 安全须知 ..................................................................................................................................... 7 2 综述 ....................................................................................................................................................... 8 2.1. 主要性能 ..................................................................................................................................... 8 2.2. 功能框图 ................................................................................................................................... 10 2.3. 接口分布图 ................................................................................................................................11 2.4. Arduino 接口定义图.................................................................................................................. 13 3 操作说明 .............................................................................................................................................. 14 3.1. 单板操作说明............................................................................................................................ 15 3.1.1. 单板使用接口示意图...................................................................................................... 15 3.1.2. 操作步骤 ........................................................................................................................ 16 3.2. 多板操作说明............................................................................................................................ 17 3.2.1. 接口和修改示意图 ......................................................................................................... 17 3.2.2. 操作步骤 ........................................................................................................................ 19 3.2.3. 脚位连接说明................................................................................................................. 20 4 电气性能和可靠性 ............................................................................................................................... 21 4.1. 绝对最大值 ............................................................................................................................... 21 4.2. 工作和存储温度 ........................................................................................................................ 21 5 机械尺寸 .............................................................................................................................................. 23 5.1. BC32-TE-B 机械尺寸 ............................................................................................................... 23 5.2. BC32-TE-B 俯视图和底视图 .................................................................................................... 24 6 BC32-TE-B 套件及配件 ...................................................................................................................... 26 6.1. BC32-TE-B 套件....................................................................................................................... 26 6.2. BC32-TE-B 配件....................................................................................................................... 27 7 附录 A 参考文档及术语缩写................................................................................................................ 28 上海移远通信技术股份有限公司 3 / 28 BC32-TE-B 用户指导 表格索引 表 1：BC32-TE-B 开发板主要性能 .............................................................................................................. 8 表 2：接口列表 ........................................................................................................................................... 12 表 3：STM32-L476RG MCU 和 BC32-TE-B 脚位连接表 .......................................................................... 20 表 4：绝对最大值 ....................................................................................................................................... 21 表 5：模块工作和存储温度范围 ................................................................................................................. 21 表 6：配件列表 ........................................................................................................................................... 27 表 7：参考文档 ........................................................................................................................................... 28 表 8：术语和缩写 ....................................................................................................................................... 28 上海移远通信技术股份有限公司 4 / 28 BC32-TE-B 用户指导 图片索引 图 1：BC32-TE-B 功能框图 ....................................................................................................................... 10 图 2：BC32-TE-B 接口分布图.....................................................................................................................11 图 3：Arduino 接口定义图.......................................................................................................................... 13 图 4：单板使用接口示意图......................................................................................................................... 15 图 5：USB 串口显示图............................................................................................................................... 16 图 6：多板使用接口示意图......................................................................................................................... 17 图 7：STM32 Nucleo-64 开发板修改示意图（正面） ............................................................................... 18 图 8：STM32 Nucleo-64 开发板修改示意图（背面） ............................................................................... 18 图 9：ST-LINK 接口显示图......................................................................................................................... 19 图 10：STM32-L476RG MCU 和 BC32-TE-B 脚位连接示意图 ................................................................. 20 图 11：BC32-TE-B 俯视尺寸图（单位：毫米） ........................................................................................ 23 图 12：BC32-TE-B 俯视图 ......................................................................................................................... 24 图 13：BC32-TE-B 底视图 ......................................................................................................................... 25 图 14：BC32-TE-B 套件............................................................................................................................. 26 图 15：BC32-TE-B 及其配件 ..................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 28 BC32-TE-B 用户指导 1 引言 本文档定义了 BC32-TE-B 开发板及其与客户应用连接的空中接口和硬件接口。 本文档可以帮助客户快速了解 BC32-TE-B 开发板硬件接口规范、电气特性、机械规范以及其他相关信 息。通过此文档的帮助，结合移远通信的硬件设计手册和参考设计手册，客户可以快速应用 BC32 系列模块 于无线应用。 上海移远通信技术股份有限公司 6 / 28 BC32-TE-B 用户指导 1.1. 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列安 全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵循 所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或 (U)SIM 卡无效时。在紧急情况下遇到上述情况时，请使用紧急呼叫功能，同时请 确保设备开机并且位于信号强度足够的区域。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 7 / 28 BC32-TE-B 用户指导 2 综述 BC32-TE-B 是一款带有 Arduino 接口的 LPWA/GSM/GPRS 系列开发板，其物理尺寸为 100.0 mm × 95.0 mm ×1.6 mm。BC32-TE-B 开发板可单独使用，也可与 STM32 Nucleo-64 系列开发板配合使用，以 调试开发通过 NB-IoT 无线电通信协议（3GPP Rel. 13 和 3GPP Rel. 14）或者 GSM/GPRS 无线电通信协 议与移动网络运营商的基础设备之间建立通信的应用。 2.1. 主要性能 下表详细描述了 BC32-TE-B 开发板的主要性能。 表 1：BC32-TE-B 开发板主要性能 特色 供电 发射功率 模块温度范围 USIM 接口 串口开关 说明 USB 接口： 供电电压范围：4.75~5.25 V 典型供电电压：5.0 V Arduino 接口： 供电电压范围：4.75~5.25 V 典型供电电压：5.0 V 电源适配器接口： 供电电压范围：4.75~5.25 V 典型供电电压：5.0 V NB-IoT: 23 dBm ±2 dB GSM/GPRS: ⚫ Class 4 (2 W)：GSM850 和 EGSM900 ⚫ Class 1 (1 W)：DCS1800 和 PCS1900 正常工作温度：-25 °C ~ +75 °C 1) 扩展工作温度：-40 °C ~ +85 °C 2) 存储温度范围：-40 °C ~ +90 °C 支持 1.8/3.0 V 外部 USIM 卡 用于切换模块主串口通信对象 上海移远通信技术股份有限公司 8 / 28 BC32-TE-B 用户指导 电源开关 USB 接口 Arduino 接口 RESET 按键 PWRKEY 按键 PSM_EINT 按键 物理特征 固件升级 天线接口 短信* 用于对 BC32-TE-B 供电通断控制 提供 2 路 UART 接口 主串口（USB Serial Converter A）： ⚫ 可用于 AT 命令传送和数据传输，支持的波特率最大为 57600 bps，默 认为 9600 bps ⚫ 当模块和 MCU 通信时，请置空 USB Serial Converter A 对应的端口 调试串口（USB Serial Converter B）： ⚫ 用于软件调试、升级、获取底层日志 ⚫ 支持的波特率为 921600 bps 用于连接 STM32 Nucleo-64 系列开发板 用于 BC32 系列模块复位 用于 BC32 系列模块开机 用于对 BC32 系列模块的 Deep Sleep 模式唤醒操作 尺寸：(100.0 ±0.15) mm × (95.0 ±0.15) mm × (1.6 ±0.2) mm 通过 TE-B 的 USB 接口或 DFOTA 升级 50 Ω 特征阻抗 Text 和 PDU 模式 短消息存储设备：(U)SIM 卡 备注 1. 1) 表示当模块在此温度范围工作时，模块的相关性能满足 3GPP 标准要求。 2. 2) 表示当模块在此温度范围工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能；不 会出现不可恢复的故障；射频频谱、网络基本不受影响。仅个别指标如输出功率等参数的值可能会 超出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 3. 模块 GSM 部分峰值电流 1.6 A，GSM 部分工作时，需电源适配器供电，且电源适配器的供电电流 应不小于 2 A 。 4. '*' 表示正在开发中。 上海移远通信技术股份有限公司 9 / 28 2.2. 功能框图 下图为 BC32-TE-B 功能框图： BC32-TE-B 用户指导 Arduino DC JACK J309 J310 Micro USB J306 Switch S201 LDO U201 LDO U203 LDO U202 USB-UART Bridge U301 Switch J304 U302/U303 Voltage-level Translator BC32 U101 RF J301 USIM_2G J402 USIM_NB/2G J401 图 1：BC32-TE-B 功能框图 上海移远通信技术股份有限公司 10 / 28 2.3. 接口分布图 以下是 BC32-TE-B 的接口分布图： BC32-TE-B 用户指导 S201 J204 D208 J307 J107 J310 J103 J108 J202 J104 J102 J306 D101 J304 J309 J311 J105 J106 J109 J301 J501 J203 J401 J402 S101 S102 S103 图 2：BC32-TE-B 接口分布图 上海移远通信技术股份有限公司 11 / 28 表 2：接口列表 类型 电源接口 USB-UART 接口 USIM 接口 Arduino 接口 RF 天线接口 电源开关 PWRKEY 按键 RESET 按键 PSM_EINT 按键 串口开关 电源指示灯 网络状态指示灯 测试点 BC32-TE-B 用户指导 位号 J306 J204 J309 J306 J401、J402 J307、J309、 J310、J311 J301 S201 S101 S102 S103 J304 D208 D101 J102、J103、 J104、J105、 J106、J107、 J108、J109、 J202、J203、 J501 描述 USB 供电接口 电源适配器供电接口 Arduino 供电接口 支持 2 路串口 Micro USIM 卡座 标准 Arduino 接口 射频 SMA 接头 用于对 BC32-TE-B 供电通断控制 用于对 BC32 系列的开机操作 用于对 BC32 系列的复位操作 用于对 BC32 系列的 Deep Sleep 模式唤醒操作 用于切换 BC32 系列模块主串口通信对象 （'MAIN UART TO USB'或' MAIN UART TO MCU'） 用于电源状态指示 用于网络连接状态指示 用于测试模块的基本功能 上海移远通信技术股份有限公司 12 / 28 2.4. Arduino 接口定义图 以下是 BC32-TE-B 的 Arduino 接口定义图。 J307 J310 BC32-TE-B 用户指导 hy J309 J311 图 3：Arduino 接口定义图 上海移远通信技术股份有限公司 13 / 28 BC32-TE-B 用户指导 3 操作说明 本章主要介绍 BC32-TE-B 的具体操作方法和流程。BC32-TE-B 既可以单板使用，用于 BC32 系列模 块软件升级或者开发调试基于模块的物联网应用；同时也可以使用 Arduino 接口配合 STM32 Nucleo-64 系 列开发板使用，用于开发基于 STM32 的物联网应用。以下章节将分别具体介绍单板和多板操作的流程。 上海移远通信技术股份有限公司 14 / 28 3.1. 单板操作说明 本章节主要介绍单独使用 BC32-TE-B 时的接口示意图和操作流程。 3.1.1. 单板使用接口示意图 BC32-TE-B 用户指导 S201 J204 J107 J103 J108 J202 J102 J301 J501 J203 J306 J304 J105 J106 J109 S101 S102 S103 图 4：单板使用接口示意图 J401 J402 上海移远通信技术股份有限公司 15 / 28 BC32-TE-B 用户指导 3.1.2. 操作步骤 1. 下载并安装 USB-UART 芯片驱动，驱动下载地址为： https://www.ftdichip.cn/Drivers/VCP.htm; 2. 在 J401 卡座中插入 Micro USIM 卡（请选择 NB-IoT 或 GSM 卡）；或者在 J402 卡座中插入 Micro USIM 卡（请选择 GSM 卡）； 3. 在 J301 射频接口上连接 SMA 接头棒状天线； 4. 将串口开关 J304 拨至'MAIN UART TO USB'档； 5. 使用 Micro USB 数据线连接 J306（USB 供电接口）和电脑，将电源开关 S201 拨至'ON'档，随后 从电脑的'设备管理器'可以看到如下图所示的串口。其中'USB Serial Port (COM19)'（对应 USB Serial Converter A）连接模块的主串口，可用于 AT 命令传送和数据传输；'USB Serial Port (COM20)' （对应 USB Serial Converter B）连接模块的调试串口，可用于软件调试和输出调试日志信息和固件升 级。具体的串口配置和操作请参阅 Quectel_BC32 系列_硬件设计手册。 图 5：USB 串口显示图 备注 1. 使用过程中 S102 可用于 BC32 系列模块的复位，S103 可用于 NB 模式下 Deep Sleep 唤醒。 2. 如果使用 GSM 网络，则需电源适配器供电，且电源适配器的供电电流应不小于 2 A。 上海移远通信技术股份有限公司 16 / 28 BC32-TE-B 用户指导 3.2. 多板操作说明 本章节将对 BC32-TE-B 和 STM32 Nucleo-64 系列开发板配合使用时的操作流程进行详细说明。 3.2.1. 接口和修改示意图 S201 J204 D208 J307 J107 J310 J103 J108 J202 J104 J102 J306 D101 J304 J309 J105 J106 J311 J109 J301 J501 J203 J401 J402 S101 S102 S103 图 6：多板使用接口示意图 上海移远通信技术股份有限公司 17 / 28 BC32-TE-B 用户指导 CN2 CN1 2J2 CN6 CN8 JP5 JP6 CN5 CN9 图 7：STM32 Nucleo-64 开发板修改示意图（正面） SB13 SB14 SB62 SB63 图 8：STM32 Nucleo-64 开发板修改示意图（背面） 上海移远通信技术股份有限公司 18 / 28 BC32-TE-B 用户指导 3.2.2. 操作步骤 1. 安装 STM32 Nucleo 开发板驱动，驱动下载地址为： http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-evaltools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-l476rg.html； 2. 安装 USB-UART 芯片驱动，驱动下载地址为： https://www.ftdichip.cn/Drivers/VCP.htm ； 3. 使用烙铁移除 STM32 Nucleo-64 开发板背面 SB13 和 SB14 两颗 0 Ω 电阻，并分别焊接到 SB62 和 SB63 位置上； 4. 将 STM32 Nucleo-64 开发板正面 CN2 的 1 和 2 脚短接，3 和 4 脚短接，JP5 的 1 和 2 脚短接，JP6 脚 1 和 2 脚短接； 5. 在 J401 卡座中插入 Micro USIM 卡（请选择 NB-IoT/GSM 卡）；或者在 J402 卡座中插入 Micro USIM 卡（请选择 GSM 卡）； 6. 在 J301 射频接头上连接 SMA 接头棒状天线； 7. 将串口开关 J304 拨至'MAIN UART TO MCU'档； 8. 使用 Arduino 接口将 BC32-TE-B 与 STM32 Nucleo-64 开发板对接：BC32-TE-B 的 J307、J309、J311 和 J310 分别连接 STM32 Nucleo-64 开发板的 CN5、CN6、CN8 和 CN9； 9. 用 Mini USB 数据线连接 STM32 Nucleo-64 开发板 CN1 和电脑，将电源开关 S201 拨至'ON'档； 等待模块上电开机后，从电脑的'设备管理器'将可以看到如下图示的设备信息。 图 9：ST-LINK 接口显示图 上海移远通信技术股份有限公司 19 / 28 BC32-TE-B 用户指导 3.2.3. 脚位连接说明 以下以 STM32-L476RG MCU 为例，说明 STM32 Nucleo-64 开发板和 BC32-TE-B 的脚位连接方式。 表 3：STM32-L476RG MCU 和 BC32-TE-B 脚位连接表 序号 MCU (Morpho) Arduino BC32-TE-B 备注 1 PA2 D1 CN9-2 UART_MCU_TX 与主串口 RX 连接 2 PA3 D0 CN9-1 UART_MCU_RX 与主串口 TX 连接 3 PA7 D11 CN5-4 PSM_EINT_N Deep Sleep 唤醒 4 PA6 D12 CN5-5 PWRKEY_N 高电平有效 5 PA5 D13 CN5-6 RESET_N 高电平有效 6 PA0 A0 CN8-1 RI 7 +5V +5V CN6-5 +5V 5.0 V 电源 8 GND GND CN5-7、CN6-6、 CN6-7 GND 地 以下是 STM32-L476RG MCU 和 BC32-TE-B 脚位连接示意图。 +3.3V +3.3V +5V GND GND RI GND RESET_EN PWRKEY_EN PSM_EINT_EN UART_MCU_TX UART_MCU_RX Arduino Morpho BC32-TE-B 图 10：STM32-L476RG MCU 和 BC32-TE-B 脚位连接示意图 上海移远通信技术股份有限公司 20 / 28 BC32-TE-B 用户指导 4 电气性能和可靠性 4.1. 绝对最大值 下表所示是 BC32 系列模块数字和模拟引脚的电源供电电压最大耐受值。 表 4：绝对最大值 参数 +5V VBAT 数字引脚电压 最小 -0.3 最大 +6 +4.35 +3 4.2. 工作和存储温度 下表所示为 BC32 系列模块的工作和存储温度范围。 表 5：模块工作和存储温度范围 参数 正常工作温度范围 1) 扩展工作温度范围 2) 存储温度范围 最小 -25 -40 -40 典型 +25 最大 +75 +85 +90 单位 V V V 单位 ºC ºC ºC 上海移远通信技术股份有限公司 21 / 28 BC32-TE-B 用户指导 备注 1. 1) 表示当模块在此温度范围工作时，模块的相关性能满足 3GPP 标准要求。 2. 2) 表示当模块在此温度范围工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能，不 会出现不可恢复的故障。射频频谱、网络基本不受影响，仅个别指标如输出功率等参数的值可能会 超出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 上海移远通信技术股份有限公司 22 / 28 BC32-TE-B 用户指导 5 机械尺寸 本章描述了 BC32-TE-B 的机械尺寸。尺寸单位为 mm，尺寸公差为 ±0.15 mm。 5.1. BC32-TE-B 机械尺寸 图 11：BC32-TE-B 俯视尺寸图（单位：毫米） 上海移远通信技术股份有限公司 23 / 28 5.2. BC32-TE-B 俯视图和底视图 BC32-TE-B 用户指导 图 12：BC32-TE-B 俯视图 上海移远通信技术股份有限公司 24 / 28 BC32-TE-B 用户指导 图 13：BC32-TE-B 底视图 上海移远通信技术股份有限公司 25 / 28 6 BC32-TE-B 套件及配件 6.1. BC32-TE-B 套件 BC32-TE-B 用户指导 图 14：BC32-TE-B 套件 上海移远通信技术股份有限公司 26 / 28 6.2. BC32-TE-B 配件 BC32-TE-B 用户指导 图 15：BC32-TE-B 及其配件 表 6：配件列表 配件 RF 天线 数据线 说明书 描述 带 SMA 接头的棒状 RF 天线 Micro USB 线 说明 BC32-TE-B 连接方式和配件信息的单页说明书 数量 1 1 1 上海移远通信技术股份有限公司 27 / 28 BC32-TE-B 用户指导 7 附录 A 参考文档及术语缩写 表 7：参考文档 序号 文档名称 [1] Quectel_BC32 系列_硬件设计手册 备注 BC32 系列模块的硬件设计手册 表 8：术语和缩写 缩写 DFOTA GPRS GSM LPWA MCU NB-IoT SMA UART USB USIM 描述 Delta Firmware Upgrade Over-the-air General Packet Radio Service Global System for Mobile Communications Lower-Power Wide-Area Microcontroller Unit Narrow Band Internet of Things SubMiniature Version A Universal Asynchronous Receiver & Transmitter Universal Serial Bus Universal Subscriber Identification Module 上海移远通信技术股份有限公司 28 / 28

BC25-TE-B 用户指导 LPWA 模块系列 版本：BC25-TE-B_用户指导_V1.0 日期：2019-06-27 状态：受控文件 www.quectel.com BC25-TE-B 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 23 文档历史 修订记录 版本 日期 1.0 2019-06-27 作者 变更表述 王亮/鲁义文/ 初始版本 吴灿/顾根全 BC25-TE-B 用户指导 上海移远通信技术股份有限公司 2 / 23 BC25-TE-B 用户指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 图片索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 安全须知 ...................................................................................................................................... 6 2 综述 ........................................................................................................................................................ 7 2.1. 主要性能 ...................................................................................................................................... 7 2.2. 功能框图 ...................................................................................................................................... 8 2.3. 接口分布图 .................................................................................................................................. 9 2.4. Arduino 接口定义图...................................................................................................................10 3 操作说明 ............................................................................................................................................... 11 3.1. 单板操作说明............................................................................................................................. 11 3.1.1. 单板使用接口示意图....................................................................................................... 11 3.1.2. 操作步骤 ......................................................................................................................... 12 3.2. 多板操作说明.............................................................................................................................13 3.2.1. 接口和修改示意图 .......................................................................................................... 13 3.2.2. 操作步骤 ......................................................................................................................... 15 3.2.3. 脚位连接说明..................................................................................................................15 4 电气性能和可靠性 ................................................................................................................................ 17 4.1. 绝对最大值 ................................................................................................................................ 17 4.2. 工作和存储温度 ......................................................................................................................... 17 5 机械尺寸 ............................................................................................................................................... 19 5.1. BC25-TE-B 机械尺寸 ................................................................................................................ 19 5.2. BC25-TE-B 俯视图和底视图 ..................................................................................................... 20 6 BC25-TE-B 套件及配件 .......................................................................................................................21 6.1. BC25-TE-B 套件........................................................................................................................21 6.2. BC25-TE-B 配件........................................................................................................................22 7 附录 A 参考文档 ...................................................................................................................................23 上海移远通信技术股份有限公司 3 / 23 BC25-TE-B 用户指导 表格索引 表 1：BC25-TE-B 开发板主要性能 ...................................................................................................................... 7 表 2：接口列表 .................................................................................................................................................... 9 表 3：STM32-L476RG MCU 和 BC25-TE-B 脚位连接表 .................................................................................. 15 表 4：绝对最大值............................................................................................................................................... 17 表 5：模块工作和存储温度范围 ......................................................................................................................... 17 表 6：配件列表 .................................................................................................................................................. 22 表 7：参考文档 .................................................................................................................................................. 23 表 8：术语和缩写............................................................................................................................................... 23 上海移远通信技术股份有限公司 4 / 23 BC25-TE-B 用户指导 图片索引 图 1：BC25-TE-B 功能框图 ................................................................................................................................. 8 图 2：BC25-TE-B 接口分布图 ............................................................................................................................. 9 图 3：ARDUINO 接口定义图 ............................................................................................................................. 10 图 4：单板使用接口示意图 .................................................................................................................................11 图 5：USB 串口显示图 ...................................................................................................................................... 12 图 6：多板使用接口示意图 ................................................................................................................................ 13 图 7：STM32 NUCLEO-64 开发板接口示意图（正面） ................................................................................... 14 图 8：STM32 NUCLEO-64 开发板修改示意图（背面） ................................................................................... 14 图 9：ST-LINK 接口显示图 ................................................................................................................................ 15 图 10：STM32-L476RG MCU 和 BC25-TE-B 脚位连接示意图 ......................................................................... 16 图 11：BC25-TE-B 俯视尺寸图（单位：毫米） ................................................................................................ 19 图 12：BC25-TE-B 俯视图 ................................................................................................................................ 20 图 13：BC25-TE-B 底视图 ................................................................................................................................ 20 图 14：BC25-TE-B 套件 .................................................................................................................................... 21 图 15：BC25-TE-B 及其配件............................................................................................................................. 22 上海移远通信技术股份有限公司 5 / 23 BC25-TE-B 用户指导 1 引言 本文档定义了 BC25-TE-B 开发板及其与客户应用连接的空中接口和硬件接口。 本文档可以帮助客户快速了解 BC25-TE-B 开发板硬件接口规范、电气特性、机械规范以及其他相关信 息。通过此文档的帮助，结合移远通信的硬件设计手册和参考设计手册，客户可以快速将 BC25 模块应用 于无线应用。 1.1. 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或(U)SIM 卡无效时。在紧急情况下遇到上述情况时，请使用紧急呼叫功能，同时请确保设备 开机并且位于信号强度足够的区域。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 6 / 23 BC25-TE-B 用户指导 2 综述 BC25-TE-B 是一款带有 Arduino 接口的 NB-IoT 开发板，其物理尺寸为 70.0mm × 74.0mm × 1.6mm。 BC25-TE-B 开发板可单独使用，也可与 STM32 Nucleo-64 系列开发板配合使用，通过 NB-IoT 无线电通信 协议（3GPP Rel-13 和 3GPP Rel-14*）与移动网络运营商基础设备建立通信，来调试和开发基于 NB-IoT 的物联网应用。 2.1. 主要性能 下表详细描述了 BC25-TE-B 开发板的主要性能。 表 1：BC25-TE-B 开发板主要性能 特色 供电 发射功率 模块温度范围 USIM 接口 串口开关 USB 接口 说明 USB 接口： 供电电压范围：4.75V~5.25V 典型供电电压：5.0V Arduino 接口： 供电电压范围：4.75V~5.25V 典型供电电压：5.0V 外部电源供电：5.0V 23dBm±2dB 正常工作温度：-25°C ~ +75°C 1) 扩展工作温度：-40°C ~ +85°C 2) 存储温度范围：-40°C ~ +90°C 支持 1.8V/3.0V 外部 USIM 卡 用于切换模块主串口通信对象 目前提供 2 路 UART 接口 主串口（Ch A）：  用于 AT 命令通信和数据传输，默认波特率：9600bps  可用于软件升级* 调试串口（Ch B）：  配合调试工具，通过软件调试获取底层日志  用于软件升级，默认波特率：921600bps 上海移远通信技术股份有限公司 7 / 23 Arduino 接口 复位按键 PWRKEY 按键 物理特征 软件升级 天线接口 短信* BC25-TE-B 用户指导 辅助串口*：  用于 AT 命令通信和数据传输  默认波特率：9600bps 用于连接 STM32 Nucleo-64 系列开发板 用于 BC25 模块的复位操作 用于 BC25 模块的开机操作 尺寸：(70.0±0.15)mm × (74.0±0.15)mm × (1.6±0.2)mm  通过主串口升级软件*  通过调试串口升级软件  通过 DFOTA 升级软件* 50Ω 特性阻抗 Text 和 PDU 模式 备注 1. 1) 表示当模块在此温度范围工作时，模块的相关性能满足 3GPP 标准要求。 2. 2) 表示当模块在此温度范围工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能；不 会出现不可恢复的故障；射频频谱、网络基本不受影响。仅个别指标如输出功率等参数的值可能会 超出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 3. '*' 表示正在开发中。 2.2. 功能框图 下图为 BC25-TE-B 功能框图： Arduino Power J202 J306 J308 Micro USB J301 DC-DC U201/U202 LDO U203 USB-UART Bridge U301 Switch J302 Voltagelevel Translator U303 BC25 U101 VDD_EXT RF J304 USIM J303 图 1：BC25-TE-B 功能框图 上海移远通信技术股份有限公司 8 / 23 2.3. 接口分布图 以下是 BC25-TE-B 的接口分布图。 BC25-TE-B 用户指导 J305 J308 J201 J106 J105 J304 J301 D203 J302 D304 J103 J303 J202 J306 J307 S101 S102 图 2：BC25-TE-B 接口分布图 表 2：接口列表 类型 位号 J301 电源接口 J306 J202 USB-UART 接口 J301 USIM 接口 Arduino 接口 J303 J305、J306、 J307、J308 描述 USB 供电接口 Arduino 供电接口 外部电源供电接口 支持 2 路串口 Micro USIM 卡座 标准 Arduino 接口 上海移远通信技术股份有限公司 9 / 23 RF 天线接口 串口开关 开机按键 复位按键 电源指示灯 网络指示灯 测试点 BC25-TE-B 用户指导 J304 J302 S101 S102 D203 D304 J103、J105、 J106、J201 射频 SMA 接头 用于切换 BC25 主串口通信对象 （'MAIN UART TO USB'或' MAIN UART TO MCU'） 用于对 BC25 的开机操作 用于对 BC25 的复位操作 用于指示电源开关位置 用于指示网络连接状态 用于测试 BC25 模块基本功能 2.4. Arduino 接口定义图 以下是 BC25-TE-B 的 Arduino 接口定义图。 GND RESET_N PWRKEY_N PSM_EINT_N MCU_TX MCU_RX U A R T _ +5V GND GND POWER_EN ADC 图 3：Arduino 接口定义图 上海移远通信技术股份有限公司 10 / 23 BC25-TE-B 用户指导 3 操作说明 本章主要介绍 BC25-TE-B 的具体操作方法和流程。BC25-TE-B 既可以单板使用，用于 BC25 模块软 件升级或者开发调试基于 BC25 模块的物联网应用；同时也可以使用 Arduino 接口配合 STM32 Nucleo-64 系列开发板使用，用于开发基于 STM32 的物联网应用。以下章节将分别具体说明单板和多板操作的流程。 3.1. 单板操作说明 本章节主要介绍单独使用 BC25-TE-B 时的接口示意图和操作流程。 3.1.1. 单板使用接口示意图 J301 J302 J304 J303 S101 S102 图 4：单板使用接口示意图 上海移远通信技术股份有限公司 11 / 23 BC25-TE-B 用户指导 3.1.2. 操作步骤 1. 下载并安装 USB-UART 芯片驱动，驱动下载地址为： https://www.exar.com/product/interface/uarts/usb-uarts/xr21v1414； 2. 在 J303 卡座中插入 Micro USIM 卡，请根据 BC25 模块硬件版本选择 USIM 卡类型； 3. 在 J304 射频接头上连接 SMA 接头棒状天线； 4. 将串口开关 J302 拨至'MAIN UART TO USB'档； 5. 使用 Micro USB 数据线连接 J301（USB 供电接口）和电脑，随后从电脑的'设备管理器'可以看到如 下图所示的串口。其中 Ch A 连接 BC25 的主串口，可用于 AT 命令传送和数据传输，Ch B 为调试串口， 用于输出调试日志信息和软件升级等。具体的串口配置和操作请参阅 Quectel_BC25_硬件设计手册。 图 5：USB 串口显示图 备注 使用过程中 S101 可以用于 BC25 模块的开机；S102 可用于 BC25 模块的复位。 上海移远通信技术股份有限公司 12 / 23 BC25-TE-B 用户指导 3.2. 多板操作说明 本章节将对 BC25-TE-B 和 STM32 Nucleo-64 系列开发板配合使用时的操作流程进行详细说明。 3.2.1. 接口和修改示意图 J305 J308 J301 J304 J302 J303 J306 J307 S101 S102 图 6：多板使用接口示意图 上海移远通信技术股份有限公司 13 / 23 CN2 CN1 BC25-TE-B 用户指导 CN6 CN8 JP5 JP6 CN5 CN9 图 7：STM32 Nucleo-64 开发板接口示意图（正面） SB13 SB14 SB62 SB63 图 8：STM32 Nucleo-64 开发板修改示意图（背面） 上海移远通信技术股份有限公司 14 / 23 BC25-TE-B 用户指导 3.2.2. 操作步骤 1. 安装 STM32 Nucleo 开发板驱动，驱动下载地址为： http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-to ols/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-l476rg.html； 2. 安装 USB-UART 芯片驱动，驱动下载地址为： https://www.exar.com/product/interface/uarts/usb-uarts/xr21v1414； 3. 使用烙铁移除 STM32 Nucleo-64 开发板背面 SB13 和 SB14 两颗 0Ω 电阻，并分别焊接到 SB62 和 SB63 位置上； 4. 将 STM32 Nucleo-64 开发板正面 CN2 的 1 和 2 脚短接，3 和 4 脚短接，JP5 的 1 和 2 脚短接，JP6 脚 1 和 2 脚短接； 5. 在 J303 卡座中插入 Micro USIM 卡，请根据 BC25 模块硬件版本选择 USIM 卡类型； 6. 在 J304 射频接头上连接 SMA 接头棒状天线； 7. 将串口开关拨至'MAIN UART TO MCU'档； 8. 使用 Arduino 接口将 BC25-TE-B 与 STM32 Nucleo-64 开发板对接：BC25-TE-B 的 J305、J306、J307 和 J308 分别连接 STM32 Nucleo-64 开发板的 CN5、CN6、CN8 和 CN9； 9. 用 Mini USB 数据线连接 STM32 Nucleo-64 开发板 CN1 和电脑；等待模块上电开机后，在电脑的'设 备管理器'中将可以看到如下图示的设备信息。 图 9：ST-LINK 接口显示图 3.2.3. 脚位连接说明 以下以 STM32-L476RG MCU 为例，说明 STM32 Nucleo-64 开发板和 BC25-TE-B 的脚位连接方式。 表 3：STM32-L476RG MCU 和 BC25-TE-B 脚位连接表 序号 1 2 MCU (Morpho) Arduino PA2 D1 CN9-2 PA3 D0 CN9-1 BC25-TE-B UART_MCU_TX UART_MCU_RX 备注 与主串口 RX 连接 与主串口 TX 连接 上海移远通信技术股份有限公司 15 / 23 BC25-TE-B 用户指导 3 PA7 4 PA6 5 PA5 6 PA1 7 PA0 8 +5V 9 GND D11 CN5-4 PSM_EINT_N D12 CN5-5 PWRKEY_N D13 CN5-6 RESET_N A1 CN8-2 ADC A0 CN8-1 POWER_N +5V CN6-5 +5V GND CN5-7、CN6-6、 CN6-7 GND 以下是 STM32-L476RG MCU 和 BC25-TE-B 脚位连接示意图。 PSM 中断 高电平有效 高电平有效 模数转换接口* DC-DC 使能 5.0V 电源 地 GND RESET_N PWRKEY_N PSM_EINT_N +5V GND GND APODPOCW0WERE_RE_NEN ADC UART_MCU_TX UART_MCU_RX Arduino Morpho BC25-TE-B 图 10：STM32-L476RG MCU 和 BC25-TE-B 脚位连接示意图 备注 '*' 表示正在开发中。 上海移远通信技术股份有限公司 16 / 23 BC25-TE-B 用户指导 4 电气性能和可靠性 4.1. 绝对最大值 下表所示是 BC25 模块数字和模拟引脚的电源供电电压/电流最大耐受值。 表 4：绝对最大值 参数 VBAT 数字引脚电压 模拟引脚电压 断电模式下，数字/模拟引脚电压 最小 0 待定 待定 待定 最大 +4.35 待定 待定 待定 单位 V V V V 4.2. 工作和存储温度 下表所示为 BC25 模块的工作和存储温度范围。 表 5：模块工作和存储温度范围 参数 正常工作温度范围 1) 扩展工作温度范围 2) 存储温度范围 最小 -25 -40 -40 典型 +25 最大 +75 +85 +90 单位 ºC ºC ºC 上海移远通信技术股份有限公司 17 / 23 BC25-TE-B 用户指导 备注 1. 1) 表示当模块在此温度范围工作时，模块的相关性能满足 3GPP 标准要求； 2. 2) 表示当模块在此温度范围工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能，不 会出现不可恢复的故障。射频频谱、网络基本不受影响，仅个别指标如输出功率等参数的值可能会 超出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 上海移远通信技术股份有限公司 18 / 23 BC25-TE-B 用户指导 5 机械尺寸 本章描述了 BC25-TE-B 的机械尺寸，单位为 mm，尺寸公差为±0.15mm。 5.1. BC25-TE-B 机械尺寸 图 11：BC25-TE-B 俯视尺寸图（单位：毫米） 上海移远通信技术股份有限公司 19 / 23 5.2. BC25-TE-B 俯视图和底视图 BC25-TE-B 用户指导 图 12：BC25-TE-B 俯视图 图 13：BC25-TE-B 底视图 上海移远通信技术股份有限公司 20 / 23 6 BC25-TE-B 套件及配件 6.1. BC25-TE-B 套件 BC25-TE-B 用户指导 图 14：BC25-TE-B 套件 上海移远通信技术股份有限公司 21 / 23 6.2. BC25-TE-B 配件 BC25-TE-B 用户指导 图 15：BC25-TE-B 及其配件 表 6：配件列表 配件 天线 数据线 说明书 描述 带 SMA 接头的棒状 NB-IoT 天线 Micro USB 线 BC25-TE-B 连接方式及配件信息说明书 数量 1 1 1 上海移远通信技术股份有限公司 22 / 23 BC25-TE-B 用户指导 7 附录 A 参考文档 表 7：参考文档 序号 文档名称 [1] Quectel_BC25_硬件设计手册 备注 BC25 硬件设计手册 表 8：术语和缩写 缩写 DFOTA LPWA MCU NB-IoT SMA UART USB USIM 描述 Delta Firmware Upgrade Over-the-air Low-Power Wide-Area Microcontroller Unit Narrow Band Internet of Things SubMiniature Version A Universal Asynchronous Receiver & Transmitter Universal Serial Bus Universal Subscriber Identification Module 上海移远通信技术股份有限公司 23 / 23

LC79D (A) EVB User Guide GNSS Module Series Rev. LC79D(A)_EVB_User_Guide_V1.0 Date: 2019-11-14 Status: Released www.quectel.com GNSS Module Series LC79D (A) EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. LC79D(A)_EVB_User_Guide 1 / 21 GNSS Module Series LC79D (A) EVB User Guide About the Document History Revision Date Author Description 1.0 2019-11-14 Brooke WANG Initial LC79D(A)_EVB_User_Guide 1 / 21 GNSS Module Series LC79D (A) EVB User Guide Contents About the Document .................................................................................................................................. 1 Contents ...................................................................................................................................................... 2 Table Index.................................................................................................................................................. 3 Figure Index ................................................................................................................................................ 4 1 Introduction ......................................................................................................................................... 5 1.1. Safety Information ...................................................................................................................... 5 2 General Overview................................................................................................................................ 6 2.1. Top View of the EVB .................................................................................................................. 6 2.2. EVB Kit Accessories .................................................................................................................. 7 2.3. EVB and Accessories Assembly ................................................................................................ 8 3 Interface Applications ........................................................................................................................ 9 3.1. Micro USB Interface ................................................................................................................... 9 3.2. Antenna Interface....................................................................................................................... 9 3.3. Switches and Buttons .............................................................................................................. 10 3.4. Operation Status Indication LEDs.............................................................................................11 3.5. Test Points................................................................................................................................ 12 4 EVB Operation Procedures.............................................................................................................. 14 4.1. Firmware Download ................................................................................................................. 14 4.1.1. Firmware Download in Normal Working Mode ............................................................. 14 4.1.2. Firmware Download in Host Mode................................................................................ 15 4.2. Communication via Micro USB Interface ................................................................................. 15 5 Usage of QGNSS ............................................................................................................................... 17 5.1. COM and Baud Rate Setting ................................................................................................... 17 5.2. PQ Command Sending ............................................................................................................ 18 5.3. Automatic TTFF Testing ........................................................................................................... 19 6 Appendix A References.................................................................................................................... 20 LC79D(A)_EVB_User_Guide 2 / 21 GNSS Module Series LC79D (A) EVB User Guide Table Index TABLE 1: INTERFACES OF LC79D (A) EVB...................................................................................................... 6 TABLE 2: LIST OF ACCESSORIES .................................................................................................................... 8 TABLE 3: SWITCHES AND BUTTONS............................................................................................................. 10 TABLE 4: OPERATION STATUS INDICATION LEDS........................................................................................11 TABLE 5: PIN DESCRIPTION OF J104 ............................................................................................................ 12 TABLE 6: PIN DESCRIPTION OF J105 ............................................................................................................ 13 TABLE 7: RELATED DOCUMENTS .................................................................................................................. 20 TABLE 8: TERMS AND ABBREVIATIONS ........................................................................................................ 20 LC79D(A)_EVB_User_Guide 3 / 21 GNSS Module Series LC79D (A) EVB User Guide Figure Index FIGURE 1: TOP VIEW OF LC79D (A) EVB ........................................................................................................ 6 FIGURE 2: EVB KIT ACCESSORIES ................................................................................................................. 7 FIGURE 3: LC79D (A) EVB AND ACCESSORIES ASSEMBLY ......................................................................... 8 FIGURE 4: MICRO USB CONNECTOR ............................................................................................................. 9 FIGURE 5: ANTENNA CONNECTOR ............................................................................................................... 10 FIGURE 6: SWITCHES AND BUTTONS .......................................................................................................... 10 FIGURE 7: OPERATION STATUS INDICATION LEDS .....................................................................................11 FIGURE 8: J104 TEST POINTS........................................................................................................................ 12 FIGURE 9: J105 TEST POINTS........................................................................................................................ 13 FIGURE 10: GNSSFLASHTOOL CONFIGURATIONS FOR FIRMWARE UPGRADE ..................................... 14 FIGURE 11: GNSSFLASHTOOL CONFIGURATIONS FOR HOST MODE DOWNLOAD ............................... 15 FIGURE 12: USB PORTS ................................................................................................................................. 15 FIGURE 13: COM PORT SETTING INTERFACE OF QCOM .......................................................................... 16 FIGURE 14: COM PORT AND BAUD RATE SELECTION ............................................................................... 17 FIGURE 15: QGNSS INTERFACE .................................................................................................................... 18 FIGURE 16: PQ COMMAND SENDING VIA QGNSS....................................................................................... 18 FIGURE 17: STATIC TTFF TESTING VIA QGNSS........................................................................................... 19 LC79D(A)_EVB_User_Guide 4 / 21 GNSS Module Series LC79D (A) EVB User Guide 1 Introduction This document specifies the usage of LC79D (A) EVB which is an assistant tool for engineers to develop and test Quectel LC79D (A) module. 1.1. Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any terminal incorporating Quectel LC79D (A) module. Manufacturers of the terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for customers’ failure to comply with these precautions. Ensure that the use of the product meets the national safety and environmental regulations, and is allowed in the country and in the environment required. Keep away from explosive and flammable materials. The use of electronic products in extreme power supply conditions and locations with potentially explosive atmospheres may cause fire and explosion hazards. The product has to be powered by a stabilized voltage source, and the wiring shall conform to security and fire prevention regulations. Proper ESD handling procedures must be applied throughout the mounting, handling and operation of any application that incorporates the module to avoid ESD damages. LC79D(A)_EVB_User_Guide 5 / 21 GNSS Module Series LC79D (A) EVB User Guide 2 General Overview 2.1. Top View of the EVB The following figure illustrates the top view of LC79D (A) EVB. A J B C K D E I FGH Figure 1: Top View of LC79D (A) EVB Table 1: Interfaces of LC79D (A) EVB SN. Reference No. A J102 B D101 C D103 Description Antenna connector 1PPS Indication LED Transmit Data Indication LED LC79D(A)_EVB_User_Guide 6 / 21 D J202 E S201 F S103 G S101 H S102 I J104 J U102 K J105 2.2. EVB Kit Accessories GNSS Antenna GNSS Module Series LC79D (A) EVB User Guide Micro USB connector Power Switch WAKE_UP Button NSTANDBY Button BOOT Button Test Points LC79D (A) Module Test Points EVB Micro USB Cable USB Flash Drive Bolts and Coupling Nuts Figure 2: EVB Kit Accessories LC79D(A)_EVB_User_Guide 7 / 21 GNSS Module Series LC79D (A) EVB User Guide Table 2: List of Accessories Items USB Cable EVB Antenna USB Flash Drive Instruction Sheet Other Description Micro USB Cable LC79D (A) evaluation board GNSS antenna (Active) USB Flash Drive (including LC79D related documents, tools, drivers, etc.) A sheet of paper giving instructions for EVB connection, details of EVB accessories, etc. Bolts and coupling nuts Quantity 1 1 1 1 1 4 for each 2.3. EVB and Accessories Assembly The following figure shows the assembly of LC79D (A) EVB and its accessories. Figure 3: LC79D (A) EVB and Accessories Assembly LC79D(A)_EVB_User_Guide 8 / 21 GNSS Module Series LC79D (A) EVB User Guide 3 Interface Applications 3.1. Micro USB Interface The EVB is mounted with a micro USB connector to support power supply input and data transmission. Micro-USB connector Figure 4: Micro USB Connector NOTE Before using the EVB, please run the USB flash drive on PC to install the USB driver. 3.2. Antenna Interface The EVB is mounted with an antenna connector for connection of an external passive or active GNSS antenna. LC79D(A)_EVB_User_Guide 9 / 21 GNSS Module Series LC79D (A) EVB User Guide Antenna connector Figure 5: Antenna Connector 3.3. Switches and Buttons The following figure illustrates the switches and buttons of the EVB. S201 S103 S101 S102 Figure 6: Switches and Buttons Table 3: Switches and Buttons Part No. Name I/O S101 NSTANDBY DI S102 S103 BOOT DI WAKE_UP DI Description 1. Long press (press and hold) the NSTANDBY button to enter standby mode, and release the button to exit from standby mode. 2. Short press (press and then release) the NSTANDBY button to reset the module. Press and hold the BOOT button during EVB power-on to make the module enter host mode. On the EVB, the module will enter sleep mode after sending LC79D(A)_EVB_User_Guide 10 / 21 GNSS Module Series LC79D (A) EVB User Guide S201 POWER $PQSETSLEEP,1 command. Long press WAKE_UP button to exit from sleep mode, and then send $PQSTARTGNSS to start the GNSS engine. PI EVB power on/off switch 3.4. Operation Status Indication LEDs D101 D103 Figure 7: Operation Status Indication LEDs Table 4: Operation Status Indication LEDs Part No. Name D101 1PPS D103 TXD I/O Description Flash: successful fix. The frequency is 1Hz. DO Extinct: no fix. Flash: the module is turned on successfully, and the micro USB port can DO output NMEA messages. Extinct: failed to turn on the module. LC79D(A)_EVB_User_Guide 11 / 21 3.5. Test Points The following figure illustrates the test points of the EVB. GNSS Module Series LC79D (A) EVB User Guide 97531 10 8 6 4 2 Figure 8: J104 test points Table 5: Pin Description of J104 Pin No. Signal I/O 1 CTS DI 2 RTS DO 3 REQ DO 4 RXD DI 5 1PPS DO 6 TXD DO 7 AP_REQ DI 8 STDBY DI 9 RDY DO 10 GND - Description Clear to send Request to send Data availability indication, used to indicate whether there is data available for reading Receive data One pulse per second Transmit data AP request to send Standby mode control Reserved Ground LC79D(A)_EVB_User_Guide 12 / 21 GNSS Module Series LC79D (A) EVB User Guide 12345 Figure 9: J105 Test Points Table 6: Pin Description of J105 Pin No. Signal I/O 1 SDA OD 2 SCL OD 3 INT DI 4 GND - 5 VCC_1.8V PO Description I2C serial clock I2C serial data Interrupt Ground 1.8V output power supply LC79D(A)_EVB_User_Guide 13 / 21 GNSS Module Series LC79D (A) EVB User Guide 4 EVB Operation Procedures This chapter mainly illustrates the operation procedures of LC79D (A) EVB. 4.1. Firmware Download The module supports firmware download in both normal working mode and host mode. 4.1.1. Firmware Download in Normal Working Mode Step 1: Connect the EVB to a PC with a micro USB cable. Step 2: Turn on the POWER switch (S201) to power on the EVB. Step 3: Run the GNSSFlashTool and then configure the tool as shown below. Figure 10: GNSSFlashTool Configurations for Firmware Upgrade  NOTE Please make sure the module is in full on mode before downloading firmware in normal working mode. LC79D(A)_EVB_User_Guide 14 / 21 GNSS Module Series LC79D (A) EVB User Guide 4.1.2. Firmware Download in Host Mode Step 1: Connect the EVB to a PC with a micro USB cable. Step 2: Press and hold the BOOT button during EVB power-on to make the module enter host mode. After the module enters host mode successfully, release the BOOT button. Step 3: Run the GNSSFlashTool and then configure the tool as shown below. Figure 11: GNSSFlashTool Configurations for Host Mode Download 4.2. Communication via Micro USB Interface Step 1: Connect the EVB to a PC with a micro USB cable through the micro USB interface, and then turn on the POWER switch (S201) to power on the EVB. Step 2: Run the USB flash drive on PC to install the USB driver. The USB port numbers can be viewed through the PC Device Manager, as shown below. Figure 12: USB Ports Step 3: Install and then use the QCOM tool provided by Quectel to realize the communication between the module and the PC. The following figure shows the COM Port Setting interface of QCOM: select the correct 'COM Port' (USB port number shown in the above figure) and set the correct 'Baudrate' (the default value: 115200bps). For more details of the usage of QCOM, please refer to document [4]. LC79D(A)_EVB_User_Guide 15 / 21 GNSS Module Series LC79D (A) EVB User Guide Figure 13: COM Port Setting Interface of QCOM LC79D(A)_EVB_User_Guide 16 / 21 GNSS Module Series LC79D (A) EVB User Guide 5 Usage of QGNSS QGNSS tool is used to check the status of GPS, GLONASS, BeiDou, Galileo and IRNSS receivers. This chapter mainly introduces how to use the tool while operating the EVB. For more details of the usage of QGNSS, please refer to document [5]. 5.1. COM and Baud Rate Setting After successful EVB connection, turn on the module and start up the QGNSS. Click 'Connect UART', select correct COM port and baud rate (115200bps by default), and then click 'OK'. Figure 14: COM Port and Baud Rate Selection After the tool is opened, the following interface in default layout will be shown: LC79D(A)_EVB_User_Guide 17 / 21 GNSS Module Series LC79D (A) EVB User Guide Figure 15: QGNSS Interface Through the QGNSS interface, users will be able to check GNSS receiver information such as CNR message, time, position, satellite information, precision and so on. 5.2. PQ Command Sending PQ commands can be sent through QGNSS. For more details about PQ commands, please refer to document [2]. Figure 16: PQ Command Sending via QGNSS LC79D(A)_EVB_User_Guide 18 / 21 GNSS Module Series LC79D (A) EVB User Guide 5.3. Automatic TTFF Testing TTFF under cold, warm and hot start conditions can be tested through QGNSS, and the number of tests can be selected from 10, 20, 50, 100 and 1000 to meet individual demands. After selecting the 'ReStart Type' and 'Times', click the 'Start' button to start the test and it can be stopped by clicking the 'Stop' button. Figure 17: Static TTFF Testing via QGNSS LC79D(A)_EVB_User_Guide 19 / 21 GNSS Module Series LC79D (A) EVB User Guide 6 Appendix A References Table 7: Related Documents SN Document name Remark [1] Quectel_LC79D_Hardware_Design LC79D Hardware Design [2] Quectel_LC79D_GNSS_Protocol_Specification LC79D GNSS Protocol Specification [3] Quectel_LC79D_Reference Design LC79D Reference Design [4] Quectel_QCOM_User_Guide QCOM User Guide [5] Quectel_QGNSS_User_Guide QGNSS User Guide Table 8: Terms and Abbreviations Abbreviation CNR DI DO EVB GNSS GPS LED LNA OD PI PO Description Carrier-to-Noise Ratio Digital Input Digital Output Evaluation Board Global Navigation Satellite System Global Positioning System Light Emitting Diode Low Noise Amplifier Open Drain Power Input Power Output LC79D(A)_EVB_User_Guide 20 / 21 PPS PRN SV TTFF UTC Pulse Per Second Pseudorandom Noise Satellite Vehicle Time To First Fix Universal Time Coordinated GNSS Module Series LC79D (A) EVB User Guide LC79D(A)_EVB_User_Guide 21 / 21

L26-LB EVB 用户指导 GNSS 模块系列 版本：1.1 日期：2022-08-01 状态：受控文件 L26-LB EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 25 L26-LB EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 25 L26-LB EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 请确保产品的使用符合国家和行业基础标准、安全标准和环境保护标准的要求，并符合 国家和特定场所对产品使用的具体规定。 请确保终端产品远离易燃易爆品。在极端供电和任何有潜在爆炸危险的（如靠近加油 站、油库、化工厂或爆炸作业场所）环境下使用电子产品可能存在安全隐患。 必须为产品提供稳定可靠的电源，并确保所有接线符合相关安全和防火法规。 在产品安装和使用过程中，必须小心处理以避免因为静电而对产品造成损坏。 上海移远通信技术股份有限公司 3 / 25 L26-LB EVB 用户指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 L26-LB EVB 用户指导 GNSS 模块系列 EVB 用户指导 受控文件 修订历史 版本 1.0 1.1 日期 2019-09-30 2022-08-01 描述 初始版本 1. 重组文档结构； 2. 更新使用 QCOM 工具通信的步骤（第 4 章）； 3. 测试工具由 PowerGPS 更新为 QGNSS（第 5.1 章）； 4. 固件升级工具由 Flash tool 更新为 QGNSS（第 5.2 章）。 上海移远通信技术股份有限公司 4 / 25 L26-LB EVB 用户指导 目录 安全须知 ....................................................................................................................................................... 3 关于文档 ....................................................................................................................................................... 4 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 简介 ....................................................................................................................................................... 8 2 概述 ....................................................................................................................................................... 9 2.1. EVB 成套配件............................................................................................................................. 9 2.2. EVB 成套配件连接示意图......................................................................................................... 10 3 EVB 接口............................................................................................................................................. 12 3.1. EVB 器件分布图 ....................................................................................................................... 12 3.2. EVB 接口 .................................................................................................................................. 12 4 使用 QCOM 工具进行通信 .................................................................................................................. 15 5 使用 QGNSS 工具进行测试和升级 ..................................................................................................... 17 5.1. QGNSS 设置 ............................................................................................................................ 17 5.1.1. 窗口界面说明................................................................................................................. 18 5.2. 固件升级 ................................................................................................................................... 20 6 附录 参考文档及术语缩写 ................................................................................................................... 24 上海移远通信技术股份有限公司 5 / 25 L26-LB EVB 用户指导 表格索引 表 1：EVB 成套配件清单............................................................................................................................ 10 表 2：接口定义 ........................................................................................................................................... 13 表 3：J106 引脚分配 .................................................................................................................................. 13 表 4：J106 引脚描述 .................................................................................................................................. 14 表 5：QGNSS 窗口界面说明...................................................................................................................... 18 表 6：参考文档 ........................................................................................................................................... 24 表 7：术语缩写 ........................................................................................................................................... 24 上海移远通信技术股份有限公司 6 / 25 L26-LB EVB 用户指导 图片索引 图 1：EVB 成套配件图 ................................................................................................................................. 9 图 2：EVB 成套配件连接示意图................................................................................................................. 10 图 3：EVB 器件分布图 ............................................................................................................................... 12 图 4：USB 端口 .......................................................................................................................................... 15 图 5：QCOM 通信端口设置界面 ................................................................................................................ 15 图 6：QCOM 界面 NMEA 语句输出 ........................................................................................................... 16 图 7：COM 端口和波特率设置 ................................................................................................................... 17 图 8：QGNSS 界面（已连接） .................................................................................................................. 18 图 9：工具启动 ........................................................................................................................................... 20 图 10：波特率设置 ..................................................................................................................................... 21 图 11：固件选择 ......................................................................................................................................... 21 图 12：固件升级 ......................................................................................................................................... 22 图 13：固件升级成功.................................................................................................................................. 22 上海移远通信技术股份有限公司 7 / 25 L26-LB EVB 用户指导 1 简介 移远通信提供一整套 L26-LB EVB 配件，以方便 L26-LB 模块的测试和使用。本文档介绍了 L26-LB EVB（评估板）成套配件的基本信息，并提供了详细的 EVB 使用指导。 本文档具体分为以下几个章节： ⚫ 第二章主要介绍 EVB 成套配件的基本信息。 ⚫ 第三章主要介绍 EVB 的接口信息。 ⚫ 第四章主要介绍如何使用 QCOM 工具与模块进行通信。 ⚫ 第五章主要介绍如何使用 QGNSS 工具对模块进行测试和升级。 ⚫ 第六章是附录部分，总结本文档中出现的参考文档和术语。 备注 1. 有关 EVB 原理图和 PCB 布局设计文件，请联系移远通信技术支持（support@quectel.com）。 2. QCOM 工具可从移远通信官网（下载专区）下载，或者从移远通信技术支持处获取； QGNSS 工具 需从移远通信技术支持处获取。 上海移远通信技术股份有限公司 8 / 25 L26-LB EVB 用户指导 2 概述 2.1. EVB 成套配件 成套配件包括：EVB 板、GNSS 有源天线、Micro-USB 连接线、U 盘、铜柱和螺丝。 EVB 成套配件如下图所示，详见表 1。 螺丝和铜柱 Micro-USB连接线 U盘 EVB 图 1：EVB 成套配件图 GNSS有源天线 上海移远通信技术股份有限公司 9 / 25 表 1：EVB 成套配件清单 项目 EVB USB 线 U盘 GNSS 天线 说明书 其它 描述 L26-LB 评估板 尺寸：60 mm × 70 mm Micro-USB 连接线 8 GB U 盘（包含模块相关文档、工具和驱动程序） GNSS 有源天线 可联系移远通信技术支持获取天线规格书 介绍评估板与配件等详情的说明书 铜柱和螺丝 L26-LB EVB 用户指导 数量 1 1 1 1 1 4对 2.2. EVB 成套配件连接示意图 EVB 成套配件连接示意图如下所示。有关如何将配件连接至 EVB 板的更多信息，请参考配件中的说 明书。 图 2：EVB 成套配件连接示意图 上海移远通信技术股份有限公司 10 / 25 备注 将 GNSS 有源天线放置在可检测到卫星的户外开阔地带。 L26-LB EVB 用户指导 上海移远通信技术股份有限公司 11 / 25 L26-LB EVB 用户指导 3 EVB 接口 3.1. EVB 器件分布图 EVB 的器件分布图如下所示。 S301 UART↔USB开关 S102 复位按键 S201 电源开关 J201 Micro-USB连接器 D105 (TXD LED指示灯) D106 (1PPS LED指示灯) J101 天线连接器 J106 测试点 U103 EVB版本号 L26-LB模块 图 3：EVB 器件分布图 3.2. EVB 接口 EVB 接口如下表所示。 上海移远通信技术股份有限公司 12 / 25 L26-LB EVB 用户指导 表 2：接口定义 功能 供电 通信接口 接口 J201 Micro-USB 连接器 J201 Micro-USB连接器 射频输入 J101 天线连接器 信号指示 开关和按键 测试点 D105 TXD LED指示灯 （蓝色LED） D106 1PPS LED指示灯 （红色LED） S201 电源开关 S301 UART↔USB开关 S102 复位按键 J106 测试点 测试点分布如下图所示： 表 3：J106 引脚分配 32K/DRIN TIMER AADET_N RESET 描述 供电输入： ⚫ 直流电源：4.5~5.5 V，典型值：5.0 V ⚫ 电流负载能力应大于100 mA。 用 于NMEA标 准 语 句 输 出 、PMTK/PQ命 令 输入输出和固件升级。 配件中的天线支持如下星系： ⚫ GPS L1 C/A ⚫ GLONASS L1 ⚫ BDS B1I ⚫ QZSS L1 C/A ⚫ SBAS L1 闪烁：UART TXD 有数据输出。 不亮或常亮：UART TXD 无数据输出。 闪烁：定位成功，频率为1 Hz。 不亮：未定位。 控制EVB板电源的通断。 用于UART和USB数据传输功能的切换。 短按按键后释放，模块复位。 测试点详见表3和表4。 1PPS TXD1 STANDBY RXD1 GND GND 上海移远通信技术股份有限公司 13 / 25 表 4：J106 引脚描述 引脚名 I/O 32K/DRIN - AADET_N DI 1PPS DO STANDBY DI GND - TIMER - RESET DI TXD1 DO RXD1 DI GND - L26-LB EVB 用户指导 描述 不连接 有源天线开路检测 一秒一个脉冲 进入或退出 Standby 模式 地 不连接 复位模块 发送数据 接收数据 地 上海移远通信技术股份有限公司 14 / 25 L26-LB EVB 用户指导 4 使用 QCOM 工具进行通信 本章节介绍了如何使用 QCOM 工具通过 Micro-USB 接口与模块进行通信。有关 QCOM 工具的使用详 情，请参考文档 [1]。 QCOM 工具与模块进行通信的具体步骤如下： 步骤 1：将 EVB 通过 Micro-USB 线连接至电脑，再将电源开关（S201）拨至'ON'状态，给 EVB 上电。 并将 UART↔USB 开关（S301）拨至'USB'位置。 步骤 2：将提供的 USB 串口驱动安装至电脑端，在电脑的'设备管理器'界面中可看到 USB 的端口号， 如下图所示。 图 4：USB 端口 步骤 3：安装由移远通信提供的 QCOM 工具，实现电脑与 L26-LB 模块之间的通信。QCOM 通信端口设置 如下图所示。（默认波特率 9600 bps 1）。 图 5：QCOM 通信端口设置界面 步骤 4：选择正确的'COM Port'（端口号如图 4 所示）和'Baudrate' 。 步骤 5：点击'Open Port'（打开端口），如图 5 所示。与 EVB 的通信建立成功后，L26-LB 模块输出的 NMEA 语句将通过 QCOM 工具显示出来，如图 6 所示。 1 UART 接口默认波特率设置可能因软件版本而异。 上海移远通信技术股份有限公司 15 / 25 L26-LB EVB 用户指导 图 6：QCOM 界面 NMEA 语句输出 上海移远通信技术股份有限公司 16 / 25 L26-LB EVB 用户指导 5 使用 QGNSS 工具进行测试和升级 本章节介绍了如何使用软件工具 QGNSS 验证 L26-LB 模块的状态并进行固件升级。更多有关 QGNSS 工具的使用信息，请参考文档 [2]。 5.1. QGNSS 设置 步骤 1：将配件连接至EVB板。 步骤 2：将 EVB 通过 Micro-USB 线连接至电脑，再将电源开关（S201）拨至'ON'状态，给 EVB 上电。 并将 UART↔USB 开关（S301）拨至'USB'位置。 步骤 3：打开由移远通信提供的QGNSS工具。点击'Setting'和'Serial Port Configuration'（默认波 特率：9600 bps 2）。 图 7：COM 端口和波特率设置 步骤 4：点击 'Connect or disconnect'按钮。成功连接模块之后，QGNSS界面如下图所示。 2 UART 接口默认波特率设置可能因软件版本而异。 上海移远通信技术股份有限公司 17 / 25 L26-LB EVB 用户指导 图 8：QGNSS 界面（已连接） 5.1.1. 窗口界面说明 在 QGNSS 界面中可以查看 GNSS 信息，例如 C/N0 信息、时间、位置、速度和精度等。有关这些参 数的详细信息，请参考下表。 表 5：QGNSS 窗口界面说明 图标 说明 此天空视图界面显示正在被追踪的卫星信息。 1) 左侧图标显示正在被追踪的卫星及其数量。 ⚫ BDS：0 ⚫ GLO（GLONASS）：5 ⚫ GPS：10 ⚫ GAL（Galileo）：0 ⚫ QZSS：0 ⚫ NAVIC（IRNSS）：0 ⚫ SBAS：0 2) 右侧的栅格地图显示了正在被追踪中的卫星方位。 上海移远通信技术股份有限公司 18 / 25 GPS 卫星 BDS 卫星 GLONASS 卫星 Galileo 卫星 QZSS 卫星 NavIC （IRNSS）卫星 L26-LB EVB 用户指导 ⚫ PRN 30 的 C/N0 值是 39 dB-Hz。 ⚫ 亮红色柱表示卫星的导航数据正在使用中。 ⚫ PRN 1 的 C/N0 值是 21 dB-Hz。 ⚫ 浅红色柱表示该卫星的导航数据未被使用。 ⚫ 经度（单位：度） ⚫ 纬度（单位：度） ⚫ 平均海拔高度（MSL，单位：m） ⚫ 椭球面高度（EPH，单位：m） ⚫ 接收机速度（单位：km/h） ⚫ 水平精度因子 ⚫ 位置精度因子 ⚫ 定位模式：2D、3D ⚫ 质量指标：包含 DGNSS、DGPS 和 GPS SPS 模式 ⚫ UTC 日期和时间 ⚫ GPS 差分数据时间 ⚫ TTFF（单位：秒） 上海移远通信技术股份有限公司 19 / 25 ⚫ 总次数 ⚫ 定位点 ⚫ RTK 浮点解 ⚫ RTK 固定解 L26-LB EVB 用户指导 5.2. 固件升级 固件升级详细步骤如下： 步骤 1：在 QGNSS 工具中点击'Tools'，然后选择'Firmware Download'。 ① 图 9：工具启动 步骤 2：选择'Download Baudrate'（波特率会影响固件下载的速率）。 上海移远通信技术股份有限公司 20 / 25 L26-LB EVB 用户指导 ② 图 10：波特率设置 步骤 3： 点 击 'Open DA File' 按 钮 ， 选 择 相 应 的 DA 文 件 ， 例 如 'MTK_AllInOne_DA_MT3333.bin'；再点击'ROM'文件选择框，选择 ROM 文件，例如 'L26LBNR03A01SV01_GLN.bin'。 ③ 上海移远通信技术股份有限公司 图 11：固件选择 21 / 25 L26-LB EVB 用户指导 步骤 4：点击'Run'按钮，弹出弹窗后短按复位按键复位模块，再点击'Yes'开始下载固件。 ④ 图 12：固件升级 步骤 5：固件升级成功时，QGNSS工具界面上将显示一个进度为'100 %'的进度条。 图 13：固件升级成功 上海移远通信技术股份有限公司 22 / 25 备注 进行固件升级前，确保模块处于 Continuous 模式。 L26-LB EVB 用户指导 上海移远通信技术股份有限公司 23 / 25 L26-LB EVB 用户指导 6 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_QCOM_User_Guide [2] Quectel_QGNSS_User_Guide 表 7：术语缩写 缩写 1PPS BDS COM Port CEP C/N0 DA DGNSS GGPS DI DO DR EPH EVB GND 英文全称 One Pulse Per Second BeiDou Navigation Satellite System Communication Port Circular Error Probable Carrier-to-Noise Ratio Download Agent Differential GNSS Differential GPS Digital Input Digital Output Dead Reckoning Ellipsoidal Height Evaluation Board Ground 中文全称 每秒一个脉冲 北斗卫星导航系统 通信串口 圆概率误差 载噪比 下载代理 差分全球卫星导航系统 差分全球定位系统 数字输入 数字输出 航位推测法 椭球面高度 评估板 地 上海移远通信技术股份有限公司 24 / 25 GNSS GPS I/O LED MSL NavIC NMEA PRN RMS ROM RTK SBAS SPS TTFF UART UTC L26-LB EVB 用户指导 Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 Input/Output 输入/输出 Light Emitting Diode 发光二极管 Mean Sea Level 平均海平面 Indian Regional Navigation Satellite System 印度区域导航卫星系统 NMEA (National Marine Electronics NMEA （ 美 国 国 家 海 洋 电 子 协 会 ） Association) 0183 Interface Standard 0183 接口标准 Pseudo Random Noise 伪随机噪声 Root Mean Square 均方根 Read Only Memory 只读存储器 Real-Time Kinematic 实时动态 Satellite-Based Augmentation System 星基增强系统 Standard Positioning Service 标准定位服务 Time to First Fix 首次定位时间 Universal Asynchronous Receiver & 通用异步收发传输器 Transmitter Coordinated Universal Time 协调世界时 上海移远通信技术股份有限公司 25 / 25

BC20-TE-B 用户指导 LPWA/GNSS 模块系列 版本：BC20-TE-B_用户指导_V1.0 日期：2019-07-31 状态：受控文件 www.quectel.com BC20-TE-B 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 26 BC20-TE-B 用户指导 文档历史 修订记录 版本 1.0 日期 2019-07-31 作者 魏大成/华志祥/ 董海波 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 26 BC20-TE-B 用户指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 安全须知 ..................................................................................................................................... 6 2 综述 ....................................................................................................................................................... 7 2.1. 主要性能 ..................................................................................................................................... 7 2.2. 功能框图 ..................................................................................................................................... 9 2.3. TE-B 接口分布图 ........................................................................................................................ 9 2.4. Arduino 接口定义图.................................................................................................................. 12 3 操作说明 .............................................................................................................................................. 13 3.1. 单板操作说明............................................................................................................................ 13 3.1.1. 单板使用接口示意图...................................................................................................... 13 3.1.2. 操作步骤 ........................................................................................................................ 14 3.2. 多板操作说明............................................................................................................................ 14 3.2.1. 接口和修改示意图 ......................................................................................................... 15 3.2.2. 操作步骤 ........................................................................................................................ 17 3.2.3. 脚位连接说明................................................................................................................. 17 4 电气性能和可靠性 ............................................................................................................................... 19 4.1. 绝对最大值 ............................................................................................................................... 19 4.2. 工作和存储温度 ........................................................................................................................ 19 5 机械尺寸 .............................................................................................................................................. 21 5.1. BC20-TE-B 机械尺寸 ............................................................................................................... 21 5.2. BC20-TE-B 俯视图和底视图 .................................................................................................... 22 6 BC20-TE-B 套件及配件 ...................................................................................................................... 24 6.1. BC20-TE-B 套件....................................................................................................................... 24 6.2. BC20-TE-B 及配件 ................................................................................................................... 25 7 附录 A 参考文档 .................................................................................................................................. 26 上海移远通信技术股份有限公司 3 / 26 BC20-TE-B 用户指导 表格索引 表 1：BC20-TE-B 开发板主要性能 ...................................................................................................................... 7 表 2：接口列表 ...................................................................................................................................................11 表 3：STM32-L476RG MCU 和 BC20-TE-B 脚位连接表 .................................................................................. 18 表 4：绝对最大值............................................................................................................................................... 19 表 5：模块工作和存储温度范围 ......................................................................................................................... 19 表 6：配件列表 .................................................................................................................................................. 25 表 7：参考文档 .................................................................................................................................................. 26 表 8：术语和缩写............................................................................................................................................... 26 上海移远通信技术股份有限公司 4 / 26 BC20-TE-B 用户指导 图片索引 图 1：BC20-TE-B 功能框图 ................................................................................................................................. 9 图 2：BC20-TE-B 接口分布图 ........................................................................................................................... 10 图 3：ARDUINO 接口定义图 ............................................................................................................................. 12 图 4：单板使用接口示意图 ................................................................................................................................ 13 图 5：USB 串口显示图 ...................................................................................................................................... 14 图 6：多板使用接口示意图 ................................................................................................................................ 15 图 7：STM32 NUCLEO-64 开发板接口示意图（正面） ................................................................................... 16 图 8：STM32 NUCLEO-64 开发板修改示意图（背面） ................................................................................... 16 图 9：ST-LINK 接口显示图 ................................................................................................................................ 17 图 10：STM32-L476RG MCU 和 BC20-TE-B 脚位连接示意图 ......................................................................... 18 图 11：BC20-TE-B 俯视尺寸图（单位：毫米） ................................................................................................ 21 图 12：BC20-TE-B 俯视图 ................................................................................................................................ 22 图 13：BC20-TE-B 底视图 ................................................................................................................................ 23 图 14：BC20-TE-B 套件 .................................................................................................................................... 24 图 15：BC20-TE-B 及其配件 ............................................................................................................................. 25 上海移远通信技术股份有限公司 5 / 26 BC20-TE-B 用户指导 1 引言 本文档定义了 BC20-TE-B 开发板及其与客户应用连接的空中接口和硬件接口。 本文档可以帮助客户快速了解 BC20-TE-B 开发板硬件接口规范、电气特性、机械规范以及其他相关信 息。通过此文档的帮助， 结合我们的硬件设计手册和参考设计手册， 客户可以快速应用 BC20 模块于无线 应用。 1.1. 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列安 全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵循 所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请先 停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞机 通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可能 会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其他 电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所时， 请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全隐患。 上海移远通信技术股份有限公司 6 / 26 BC20-TE-B 用户指导 2 综述 BC20-TE-B 是一款带有 Arduino 接口的 NB-IoT/GNSS 系列开发板，其物理尺寸为 70.0mm × 74.0mm × 1.6mm。BC20-TE-B 开发板可单独使用，也可与 STM32 Nucleo-64 系列开发板配合使用，以调试开发通 过 NB-IoT 无线电通信协议（3GPP Rel. 13）与移动网络运营商的基础设备之间建立通信的应用。 2.1. 主要性能 下表详细描述了 BC20-TE-B 开发板的主要性能。 表 1：BC20-TE-B 开发板主要性能 特性 供电 发射功率 模块温度范围 USIM 接口 串口开关 USB 接口 说明 USB 接口： 供电电压范围：4.75V~5.25V 典型供电电压：5.0V Arduino 接口： 供电电压范围：4.75V~5.25V 典型供电电压：5.0V 23dBm±2dB 正常工作温度：-35°C ~ +75°C 1) 扩展工作温度：-40°C ~ +85°C 2) 存储温度范围：-40°C ~ +90°C 支持 1.8V 外部 USIM 卡 用于切换模块主串口通信对象 提供 3 路 UART 接口和 1 路 GNSS 接口。 主串口（Interface 1）： ⚫ 可用于 AT 命令传送和数据传输，支持 115200bps 以下的波特率自适 应同步。 ⚫ 当模块和 MCU 通信时，把 J302 拨到 MCU 端，断开主串口。 调试串口（Interface 0）： ⚫ 用于固件升级。 ⚫ 也可用于输出日志信息以进行软件调试。 上海移远通信技术股份有限公司 7 / 26 BC20-TE-B 用户指导 Arduino 接口 复位按键 PWRKEY 按键 Deep Sleep 模式唤醒按键 物理特征 固件升级 天线接口 ⚫ 默认波特率：115200bps 辅助串口（Interface 3）： ⚫ 用于输出日志信息以进行软件调试。 ⚫ 默认波特率：115200bps GNSS 串口（Interface 2）： ⚫ 仅支持 TXD_GNSS，用于输出 GNSS 芯片 NMEA 语句；也可在主串 口发送 AT 命令查询 NMEA 语句。 ⚫ 默认波特率：115200bps 用于连接 STM32 Nucleo-64 系列开发板 用于复位 BC20 模块 用于 BC20 模块开机 用于对 BC20 的 Deep Sleep 模式唤醒操作 尺寸：(70.0±0.15)mm × (74.0±0.15)mm × (1.6±0.2)mm 通过模块的调试串口或 DFOTA 升级 50Ω 特征阻抗 备注 1. 1) 表示当模块工作在此温度范围时，模块的相关性能满足 3GPP 标准要求。 2. 2) 表示当模块工作在此温度范围时，模块仍能保持正常工作状态，具备短信*、数据传输等功能；不 会出现不可恢复的故障；射频频谱、网络基本不受影响。仅个别指标如输出功率等参数的值可能会超 出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 3. '*' 表示正在开发中。 上海移远通信技术股份有限公司 8 / 26 2.2. 功能框图 下图为 BC20-TE-B 功能框图： Arduino J306 J308 Micro USB J301 Micro USB Debug J111 DC-DC U201 (U204-NM) LDO U202 LDO U203 USB-UART Bridge U301 Switch J302 BC20-TE-B 用户指导 BC20 U101 RF J304 GPS J303 USIM J401 U302/U303 Voltage-level Tra nsl ato r 图 1：BC20-TE-B 功能框图 2.3. TE-B 接口分布图 以下为 BC20-TE-B 的接口分布图（下图红色高亮的部分）： 上海移远通信技术股份有限公司 9 / 26 BC20-TE-B 用户指导 J106 J305 S103 J105 J301 J302 D203 J202 J306 S101 S102 J104 J304 J308 J101 J102 J103 J112 D306D303D304 J303 J307 J111 J401 图 2：BC20-TE-B 接口分布图 上海移远通信技术股份有限公司 10 / 26 BC20-TE-B 用户指导 表 2：接口列表 类型 位号 描述 J301 USB 供电接口 电源接口 J202 外部电源供电接口 J306 Arduino 供电接口 USB 接口 J301 J111 支持 4 个串口：Interface 0、Interface 1、Interface 2 和 Interface 3 USB 下载或软件调试接口 USIM 接口 Arduino 接口 RF 天线接口 J401 Micro USIM 卡座 J305、J306、 J307、J308 标准 Arduino 接口 J304 射频 SMA 接头 GNSS 天线接口 串口开关 开机按键 J303 J302 S101 射频 SMA 接头 用于切换 BC20 主串口通信对象 （'MAIN UART TO USB' 或者'MAIN UART TO MCU'） 用于对 BC20 的开机操作 复位按键 S102 Deep Sleep 模式唤 醒按键 S103 电源指示灯 D203 用于对 BC20 的复位操作 用于对 BC20 的 Deep Sleep 模式唤醒操作 用于电源状态指示 Deep Sleep 指示灯 D306 用于 Deep Sleep 状态指示 网络状态指示灯 D304 用于网络连接状态指示 1PPS 指示灯 测试点 D303 用于 1PPS 状态指示 J101、J102、 J103、J104、 J105、J106 J112 用于测试 BC20 的基本功能 上海移远通信技术股份有限公司 11 / 26 hy 2.4. Arduino 接口定义图 以下是 BC20-TE-B 的 Arduino 接口定义图。 BC20-TE-B 用户指导 J305 J308 J306 J307 图 3：Arduino 接口定义图 上海移远通信技术股份有限公司 12 / 26 BC20-TE-B 用户指导 3 操作说明 本章主要介绍 BC20-TE-B 的具体操作方法和流程。BC20-TE-B 既可以单板使用，用于 BC20 模块软 件升级或者开发调试基于 BC20 模块的物联网应用；同时也可以使用 Arduino 接口配合 STM32 Nucleo-64 系列开发板使用，用于开发基于 STM32 的物联网应用。以下章节将分别具体介绍单板和多板操作的流程。 3.1. 单板操作说明 本章节主要介绍单独使用 BC20-TE-B 时的接口示意图和操作流程。 3.1.1. 单板使用接口示意图 J304 J301 J302 J303 J401 图 4：单板使用接口示意图 上海移远通信技术股份有限公司 13 / 26 BC20-TE-B 用户指导 3.1.2. 操作步骤 1. 下载并安装 USB-UART 芯片驱动，驱动下载地址为： https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers； 2. 在 J401 卡座中插入 Micro USIM 卡（请选择 NB-IoT 卡）； 3. 在 J303/J304 射频接头上连接 SMA 接头天线； 4. 将串口开关 J302 拨至'MAIN UART TO USB'档； 5. 使用 Micro USB 数据线连接 J301（USB 供电接口）和电脑，随后从电脑的'设备管理器'可以看到 如下图所示串口。其中 Interface 1 连接 BC20 的主串口，可用于 AT 命令传送和数据传输；Interface 0 连接 BC20 的调试串口，可用于固件升级；Interface 3 连接 BC20 的辅助串口，可用于输出调试日志 信息。具体的串口配置和操作请参考 Quectel_BC20_硬件设计手册。 图 5：USB 串口显示图 备注 使用过程中 S101 可以用于 BC20 模块的开机，S102 可用于 BC20 模块的复位。 3.2. 多板操作说明 本章节将对 BC20-TE-B 和 STM32 Nucleo-64 系列开发板配合使用时的操作流程进行详细说明。 上海移远通信技术股份有限公司 14 / 26 3.2.1. 接口和修改示意图 BC20-TE-B 用户指导 J304 J305 J308 J301 J203 J303 J302 J306 J307 J401 J111 图 6：多板使用接口示意图 上海移远通信技术股份有限公司 15 / 26 CN2 2J2 CN1 BC20-TE-B 用户指导 CN6 CN8 JP5 JP6 CN5 CN9 图 7：STM32 Nucleo-64 开发板接口示意图（正面） SB13 SB14 SB62 SB63 图 8：STM32 Nucleo-64 开发板修改示意图（背面） 上海移远通信技术股份有限公司 16 / 26 BC20-TE-B 用户指导 3.2.2. 操作步骤 1. 安装 STM32 Nucleo-64 开发板驱动，驱动下载地址为： http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-evaltools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-l476rg.html； 2. 安装 USB-UART 芯片驱动，驱动下载地址为： https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers； 3. 使用烙铁移除 STM32 Nucleo-64 开发板背面 SB13 和 SB14 两颗 0Ω 电阻，并分别焊接到 SB62 和 SB63 位置上； 4. 将 STM32 Nucleo-64 开发板正面 CN2 的 1 和 2 脚短接，3 和 4 脚短接，JP5 的 1 和 2 脚短接，JP6 脚 1 和 2 脚短接； 5. 在 J401 卡座中插入 Micro USIM 卡（请选择 NB-IoT 卡）； 6. 在 J303/J304 射频接头上连接 SMA 接头天线； 7. 将串口开关拨至'MAIN UART TO MCU'档； 8. 使用 Arduino 接口将 BC20-TE-B 与 STM32 Nucleo-64 开发板对接：BC20-TE-B 的 J305、J306、J307 和 J308 分别连接 STM32 Nucleo-64 开发板的 CN5、CN6、CN8 和 CN9； 9. 用 Mini USB 数据线连接 STM32 Nucleo-64 开发板 CN1 和电脑；等待模块上电开机后，从电脑的'设 备管理器'将可以看到如下图示的设备信息。 图 9：ST-LINK 接口显示图 3.2.3. 脚位连接说明 本章节以 STM32-L476RG MCU 为例，说明 STM32 Nucleo-64 开发板和 BC20-TE-B 的脚位连接方 式。 上海移远通信技术股份有限公司 17 / 26 BC20-TE-B 用户指导 表 3：STM32-L476RG MCU 和 BC20-TE-B 脚位连接表 序号 MCU (Morpho) Arduino 1 PA2 D1 CN9-2 2 PA3 D0 CN9-1 3 PA7 D11 CN5-4 4 PA6 D12 CN5-5 5 PA5 D13 CN5-6 6 PA0 A0 CN8-1 7 +5V +5V CN6-5 8 GND GND CN5-7, CN6-6, 7 BC20-TE-B 备注 UART_MCU_TX 主串口 RX UART_MCU_RX 主串口 TX PSM_EINT_N PSM 中断 PWRKEY_N 高电平有效 RESET_N 高电平有效 RI0 +5V 5.0V 电源 GND 地 以下是 STM32-L476RG MCU 和 BC20-TE-B 脚位连接示意图。 +3.3V +3.3V +5V GND GND RI0 GND RESET_N PWRKEY_N PSM_EINT_N UART_MCU_TX UART_MCU_RX Arduino Morpho BC20-TE-B 图 10：STM32-L476RG MCU 和 BC20-TE-B 脚位连接示意图 上海移远通信技术股份有限公司 18 / 26 BC20-TE-B 用户指导 4 电气性能和可靠性 4.1. 绝对最大值 下表所示为 BC20 模块数字和模拟引脚的电源供电电压/电流最大耐受值。 表 4：绝对最大值 参数 +5V VBAT 电源供电峰值电流 数字引脚电压 最小 -0.3 -0.3 0 -0.3 最大 6 +3.63 0.5 1.98 单位 V V A V 4.2. 工作和存储温度 下表所示为 BC20 模块的工作和存储温度范围。 表 5：模块工作和存储温度范围 参数 正常工作温度范围 1) 扩展工作温度范围 2) 存储温度范围 最小 -35 -40 -40 典型 +25 最大 +75 +85 +90 单位 ºC ºC ºC 上海移远通信技术股份有限公司 19 / 26 BC20-TE-B 用户指导 备注 1. 1) 表示当模块工作在此温度范围时，模块的相关性能满足 3GPP 标准要求； 2. 2) 表示当模块工作在此温度范围时，模块仍能保持正常工作状态，具备短信*、数据传输等功能，不 会出现不可恢复的故障。射频频谱、网络基本不受影响，仅个别指标如输出功率等参数的值可能会超 出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 3. '*' 表示正在开发中。 上海移远通信技术股份有限公司 20 / 26 BC20-TE-B 用户指导 5 机械尺寸 本章描述了 BC20-TE-B 的机械尺寸。尺寸单位为 mm，尺寸公差为±0.15mm。 5.1. BC20-TE-B 机械尺寸 图 11：BC20-TE-B 俯视尺寸图（单位：毫米） 上海移远通信技术股份有限公司 21 / 26 5.2. BC20-TE-B 俯视图和底视图 BC20-TE-B 用户指导 图 12：BC20-TE-B 俯视图 上海移远通信技术股份有限公司 22 / 26 BC20-TE-B 用户指导 图 13：BC20-TE-B 底视图 上海移远通信技术股份有限公司 23 / 26 6 BC20-TE-B 套件及配件 6.1. BC20-TE-B 套件 BC20-TE-B 用户指导 图 14：BC20-TE-B 套件 上海移远通信技术股份有限公司 24 / 26 6.2. BC20-TE-B 及配件 BC20-TE-B 用户指导 图 15：BC20-TE-B 及其配件 表 6：配件列表 配件 NB-IoT 天线 GNSS 天线 数据线 说明书 描述 带 SMA 接头的棒状 NB-IoT 天线 带 SMA 接头的 GNSS 天线 Micro USB 线 说明 BC20-TE-B 连接方式和配件信息的单页说明书 数量 1 1 1 1 上海移远通信技术股份有限公司 25 / 26 BC20-TE-B 用户指导 7 附录 A 参考文档 表 7：参考文档 序号 文档名称 [1] Quectel_BC20_硬件设计手册 备注 BC20 硬件设计手册 表 8：术语和缩写 缩写 DFOTA GNSS MCU NB-IoT SMA UART USB USIM 描述 Delta Firmware Upgrade Over-The-Air Global Navigation Satellite System Microcontroller Unit Narrow Band Internet of Things SubMiniature Version A Universal Asynchronous Receiver & Transmitter Universal Serial Bus Universal Subscriber Identification Module 上海移远通信技术股份有限公司 26 / 26

BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 LPWA 模块系列 版本：BC35-G-TE-B&BC95 R2.0-TE-B_用户指导_V1.0 日期：2019-04-19 状态：受控文件 www.quectel.com BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 文档历史 修订记录 版本 1.0 日期 2019-04-19 作者 唐奎奎 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 安全须知 ................................................................................................................................. 6 2 综述 ....................................................................................................................................................... 7 2.1. 主要性能 ................................................................................................................................. 7 2.2. 功能框图 ................................................................................................................................. 8 2.3. 接口分布图.............................................................................................................................. 9 2.4. Arduino 接口定义图 .............................................................................................................. 10 3 操作说明 .............................................................................................................................................. 11 3.1. 单板使用操作说明..................................................................................................................11 3.1.1. 单板使用接口示意图.......................................................................................................11 3.1.2. 操作步骤 ........................................................................................................................ 12 3.2. 多板操作说明 ........................................................................................................................ 13 3.2.1. 示意图............................................................................................................................ 13 3.2.2. 操作步骤 ........................................................................................................................ 15 3.2.3. 脚位连接说明................................................................................................................. 15 4 电气性能和可靠性 ............................................................................................................................... 17 4.1. 绝对最大值............................................................................................................................ 17 4.2. 工作温度和存储温度 ............................................................................................................. 17 5 机械尺寸 .............................................................................................................................................. 19 5.1. 机械尺寸 ............................................................................................................................... 19 5.2. 俯视图和底视图 .................................................................................................................... 20 5.2.1. BC35-G-TE-B 俯视图和底视图 ..................................................................................... 20 5.2.2. BC95 R2.0-TE-B 俯视图和底视图................................................................................. 21 6 套件及配件 .......................................................................................................................................... 22 6.1. BC35-G-TE-B 套件及配件 .................................................................................................... 22 6.2. BC95 R2.0-TE-B 套件及配件 ............................................................................................... 24 7 附录 A 参考文档及术语缩写................................................................................................................ 26 上海移远通信技术股份有限公司 3 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 表格索引 表 1：主要性能 .................................................................................................................................................... 7 表 2：接口列表 .................................................................................................................................................... 9 表 3：STM32-L476RG MCU 和 TE-B 脚位连接表 ............................................................................................ 15 表 4：绝对最大值............................................................................................................................................... 17 表 5：模块工作和存储温度范围 ......................................................................................................................... 17 表 6：BC35-G-TE-B 配件列表........................................................................................................................... 23 表 7：BC95 R2.0-TE-B 配件列表 ...................................................................................................................... 25 表 8：参考文档 .................................................................................................................................................. 26 表 9：术语缩写 .................................................................................................................................................. 26 上海移远通信技术股份有限公司 4 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 图片索引 图 1：BC35-G-TE-B 和 BC95 R2.0-TE-B 功能框图 ............................................................................................ 8 图 2：BC35-G-TE-B 和 BC95 R2.0-TE-B 接口分布图......................................................................................... 9 图 3：ARDUINO 接口定义图 ............................................................................................................................. 10 图 4：单板使用接口示意图 .................................................................................................................................11 图 5：USB 串口显示图 ...................................................................................................................................... 12 图 6：多板使用接口示意图 ................................................................................................................................ 13 图 7：STM32-NUCLEO 接口示意图（正面） ................................................................................................... 14 图 8：STM32-NUCLEO 修改示意图（背面） ................................................................................................... 14 图 9：ST-LINK 接口显示图 ................................................................................................................................ 15 图 10：STM32-L476RG MCU 和 BC35-G-TE-B 或 BC95 R2.0-TE-B 脚位连接示意图 .................................... 16 图 11：BC35-G-TE-B 和 BC95 R2.0 俯视尺寸图（单位：毫米） ..................................................................... 19 图 12：BC35-G-TE-B 俯视图 ............................................................................................................................ 20 图 13：BC35-G-TE-B 底视图 ............................................................................................................................ 20 图 14：BC95 R2.0-TE-B 俯视图........................................................................................................................ 21 图 15：BC95 R2.0-TE-B 底视图........................................................................................................................ 21 图 16：BC35-G-TE-B 套件 ................................................................................................................................ 22 图 17：BC35-G-TE-B 及其配件......................................................................................................................... 23 图 18：BC95 R2.0-TE-B 套件 ........................................................................................................................... 24 图 19：BC95 R2.0-TE-B 及其配件 .................................................................................................................... 25 上海移远通信技术股份有限公司 5 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 1 引言 本文档定义了 BC35-G-TE-B 和 BC95 R2.0-TE-B 开发板及其与客户应用连接的空中接口和硬件接口。 本文档可以帮助客户快速了解 BC35-G-TE-B 和 BC95 R2.0-TE-B 开发板硬件接口规范、电气特性、机 械规范以及其他相关信息。通过此文档的帮助，结合移远通信的应用手册和用户指导书，客户可以快速应用 BC35-G 和 BC95 R2.0 模块于无线应用。 1.1. 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列安 全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵循 所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请先 停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞机 通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可能 会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或（U）SIM 卡无效时。在紧急情况下遇到上述情况时，请使用紧急呼叫功能，同时请确保设备开 机并且位于信号强度足够的区域。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其他 电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所时， 请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全隐患。 上海移远通信技术股份有限公司 6 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 2 综述 BC35-G-TE-B 和 BC95 R2.0-TE-B 是带有 Arduino 接口的 NB-IoT 开发板。物理尺寸为 74.0mm × 70.0mm × 1.6mm。BC35-G-TE-B 和 BC95 R2.0-TE-B 开发板可单独使用，也可配合 STM32 Nucleo-64 系 列开发板调试开发基于 NB-IoT 的物联网应用，通过 NB-IoT 无线电通信协议（3GPP Release 14），与移 动网络运营商的基础设备之间建立通信。 2.1. 主要性能 下表详细描述了 BC35-G-TE-B 和 BC95 R2.0-TE-B 开发板的主要性能。 表 1：主要性能 特色 供电 发射功率 模块温度范围 USIM/eSIM 卡接口 串口开关 USB 接口 说明 USB 接口供电：4.75V~5.25V， 典型供电电压：5.0V Arduino 接口供电：4.75V~5.25V， 典型供电电压：5.0V 23dBm±2dB 正常工作温度：-35°C ~ +75°C 1) 扩展工作温度：-40°C ~ +85°C 2) 存储温度：-40°C ~ +90°C 支持 1.8V/3.0V 外部 USIM 卡和 2 种封装的 eSIM 卡 用于切换模块串口通信对象 支持 4 路 UART 接口，已使用 3 路 UART 接口 主串口（Ch A）：  用于 AT 命令传送和数据传输，波特率为 9600bps(默认)  用于软件升级，波特率为 115200bps 和 921600bps  当模块和 MCU 通信时，请置空 Ch A 调试串口（Ch B）：  用于软件调试  波特率只支持 921600bps 辅助串口（Ch D）：  用于数据传输，支持的波特率为 4800bps、9600bps、57600bps、 115200bps、230400bps、460800bps 和 921600bps 上海移远通信技术股份有限公司 7 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 Arduino 接口 复位按键 物理特征 固件升级 天线接口特征阻抗 用于连接 STM32 Nucleo-64 系列开发板 用于复位模块 尺寸：(74.0±0.15)mm × (70.0±0.15)mm × (1.6±0.2)mm 通过主串口升级或 DFOTA 50Ω 备注 1. 1) 表示当模块在此温度范围工作时，模块的相关性能满足 3GPP 标准要求。 2. 2) 表示当模块在此温度范围工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能，不 会出现不可恢复的故障。射频频谱、网络基本不受影响，仅个别指标如输出功率等参数的值可能会 超出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 2.2. 功能框图 下图为 BC35-G-TE-B 和 BC95 R2.0-TE-B 的功能框图： Arduino J308 Micro USB J301 LDO U202 USB-UART Bridge U301 E-SIM U303 E-SIM U304 Switch J302 Module U101 RF J304 USIM J303 图 1：BC35-G-TE-B 和 BC95 R2.0-TE-B 功能框图 上海移远通信技术股份有限公司 8 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 2.3. 接口分布图 以下是 BC35-G-TE-B 和 BC95 R2.0-TE-B 的接口分布图。 图 2：BC35-G-TE-B 和 BC95 R2.0-TE-B 接口分布图 表 2：接口列表 类型 电源 串口 USIM 接口 E-SIM 接口 位号 J301 J306 J301 J303 U303/U304 描述 USB 供电接口 Arduino 供电接口 支持 4 路串口 Micro USIM 卡座 2 x 2 和 MFF2 封装的 e-SIM 上海移远通信技术股份有限公司 9 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 Arduino 接口 RF 接口 串口开关 复位按键 网络指示灯 测试点 J305、J306、J307、 J308 标准 Arduino 接口 J304 射频 SMA 接头 J302 用于切换主串口通信对象 S101 用于进行复位操作 D304 用于指示网络状态 J101、J102、J103、 J104、J202、J203、 用于测试 BC35-G 和 BC95 R2.0 模块基本功能 J204、J309 2.4. Arduino 接口定义图 以下是 BC35-G-TE-B 和 BC95 R2.0-TE-B 的 Arduino 接口定义图。 图 3：Arduino 接口定义图 上海移远通信技术股份有限公司 10 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 3 操作说明 本章节主要说明 BC35-G-TE-B 和 BC95 R2.0-TE-B 具体使用操作流程。BC35-G-TE-B 和 BC95 R2.0TE-B 既可以单板使用，用于 BC35-G 模块和 BC95 R2.0 模块的软件升级，或者开发调试模块基于 TE-B 单 板的物联网应用；同时也可以使用 Arduino 接口配合 STM32 Nucleo-64 系列开发板使用，用于开发基于 STM32 的物联网应用。以下章节将分别具体说明单板和多板使用流程。 3.1. 单板使用操作说明 本章节将针对 BC35-G-TE-B 和 BC95 R2.0-TE-B 在单板使用情况进行详细的说明。 3.1.1. 单板使用接口示意图 图 4：单板使用接口示意图 上海移远通信技术股份有限公司 11 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 3.1.2. 操作步骤 1. 下载并安装 USB-UART 芯片驱动，驱动下载地址为： https://www.exar.com/product/interface/uarts/usb-uarts/xr21v1414; 2. 在 J303 卡座中插入 Micro USIM 卡，请根据模块硬件版本选择 USIM 卡类型； 3. 在 J304 射频接头上连接 SMA 接头棒状天线； 4. 将串口开关拨至'MAIN UART TO USB'档； 5. 使用 Micro USB 数据线连接 J301 和电脑，TE-B 开机后，电脑设备管理器将看到如下图所示的串口。 其中 Ch A 连接 BC35-G 或 BC95 R2.0 主串口，可以用于 AT 命令控制和系统软件升级，Ch B 为调试 串口，用于输出调试日志信息等，Ch D 为辅助串口，用于数据传输等，具体的串口配置和操作请参阅 文档 [1] 和文档 [2]。 图 5：USB 串口显示图 备注 使用过程中 S101 可以用于复位模块。 上海移远通信技术股份有限公司 12 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 3.2. 多板操作说明 本章节将对 TE-B 和 STM32 Nucleo-64 系列开发板配合使用操作流程进行详细说明。 3.2.1. 示意图 图 6：多板使用接口示意图 上海移远通信技术股份有限公司 13 / 26 CN2 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 CN1 CN6 CN8 JP5 JP6 CN5 CN9 图 7：STM32-Nucleo 接口示意图（正面） SB13 SB14 SB62 SB63 图 8：STM32-Nucleo 修改示意图（背面） 上海移远通信技术股份有限公司 14 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 3.2.2. 操作步骤 1. 安装 STM32-Nucleo 板驱动，驱动下载地址为： http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-evaltools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-l476rg.html； 2. 安装 USB-UART 芯片驱动，驱动下载地址为： https://www.exar.com/product/interface/uarts/usb-uarts/xr21v1414； 3. 使用烙铁移除 STM32-Nucleo 板背面 SB13 和 SB14 两颗 0Ω 电阻，并分别焊接到 SB62 和 SB63 位置 上； 4. 将 STM32-Nucleo 板正面 CN2 的 1 和 2 脚短接，3 和 4 脚短接，JP5 的 1 和 2 脚短接，JP6 脚 1 和 2 脚短接； 5. 在 J303 卡座中插入 Micro USIM 卡，请根据模块硬件版本选择 USIM 卡类型； 6. 在 J304 射频接头上连接 SMA 接头棒状天线； 7. 将串口开关拨至'MAIN UART TO MCU'档； 8. 使用 Arduino 接口对接 STM32-Nucleo 板，TE-B 的 J306、J307、J305 和 J308 分别连接 STM32- Nucleo 的 CN6、CN8、CN5 和 CN9； 9. 用 Mini USB 线连接 STM32-Nucleo 板 CN1 和电脑，等待模块上电开机后，设备管理器中看到如下图 示的设备信息。 图 9：ST-LINK 接口显示图 3.2.3. 脚位连接说明 以下以 STM32-L476RG MCU 为例，说明 STM32 Nucleo-64 开发板和模块 TE-B 脚位连接方式。 表 3：STM32-L476RG MCU 和 TE-B 脚位连接表 序号 1 2 MCU (Morpho) PA2 PA3 Arduino D1 CN9-2 D0 CN9-1 TE-B UART_MCU_TX UART_MCU_RX 备注 主串口 RX 主串口 TX 上海移远通信技术股份有限公司 15 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 3 PA0 4 PA5 5 +3V3 6 +5V 7 GND A0 D13 +3V3 +5V GND CN8-1 CN5-6 CN6-2, 4 CN6-5 CN5-7, CN6-6, 7 RI RESET_N +3.3V +5V GND 高电平有效 3.3V 电源 5.0V 电源 地 以下是 STM32-L476RG MCU 和 BC35-G-TE-B 或 BC95 R2.0-TE-B 脚位连接示意图。 +3.3V +3.3V +5V GND GND RI GND RESET_N UART_MCU_TX UART_MCU_RX Arduino Morpho BC95-TE-B_V1.2 图 10：STM32-L476RG MCU 和 BC35-G-TE-B 或 BC95 R2.0-TE-B 脚位连接示意图 上海移远通信技术股份有限公司 16 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 4 电气性能和可靠性 4.1. 绝对最大值 下表所示是 BC35-G 和 BC95 R2.0 模块数字和模拟引脚的电源供电电压电流最大耐受值。 表 4：绝对最大值 参数 +5V VBAT 极限电流 数字引脚处电压 模拟引脚处电压 关机模式下数字/模拟引脚处电压 最小 -0.3 -0.3 0 -0.3 -0.3 -0.25 最大 6V +4.25 0.5 +4.25 +4.25 +0.25 单位 V V A V V V 4.2. 工作温度和存储温度 下表所示为模块工作和存储温度范围。 表 5：模块工作和存储温度范围 参数 正常工作温度范围 1) 扩展工作温度范围 2) 存储温度范围 最小 -35 -40 -40 典型 +25 最大 +75 +85 +90 上海移远通信技术股份有限公司 单位 ºC ºC ºC 17 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 备注 1. 1) 表示当模块在此温度范围工作时，模块的相关性能满足 3GPP 标准要求。 2. 2) 表示当模块在此温度范围工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能，不 会出现不可恢复的故障。射频频谱、网络基本不受影响，仅个别指标如输出功率等参数的值可能会 超出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 上海移远通信技术股份有限公司 18 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 5 机械尺寸 该章节描述了 BC35-G-TE-B 和 BC95 R2.0-TE-B 的机械尺寸。尺寸公差为 ±0.15mm。 5.1. 机械尺寸 图 11：BC35-G-TE-B 和 BC95 R2.0 俯视尺寸图（单位：毫米） 上海移远通信技术股份有限公司 19 / 26 5.2. 俯视图和底视图 5.2.1. BC35-G-TE-B 俯视图和底视图 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 图 12：BC35-G-TE-B 俯视图 图 13：BC35-G-TE-B 底视图 上海移远通信技术股份有限公司 20 / 26 5.2.2. BC95 R2.0-TE-B 俯视图和底视图 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 图 14：BC95 R2.0-TE-B 俯视图 图 15：BC95 R2.0-TE-B 底视图 上海移远通信技术股份有限公司 21 / 26 6 套件及配件 6.1. BC35-G-TE-B 套件及配件 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 图 16：BC35-G-TE-B 套件 上海移远通信技术股份有限公司 22 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 图 17：BC35-G-TE-B 及其配件 表 6：BC35-G-TE-B 配件列表 配件 天线 数据线 说明书 描述 带 SMA 接头的棒状 NB-IoT 天线 Micro USB 线 说明 BC35-G-TE-B 连接方式和配件信息的单页说明书 数量 1 1 1 上海移远通信技术股份有限公司 23 / 26 6.2. BC95 R2.0-TE-B 套件及配件 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 图 18：BC95 R2.0-TE-B 套件 上海移远通信技术股份有限公司 24 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 图 19：BC95 R2.0-TE-B 及其配件 表 7：BC95 R2.0-TE-B 配件列表 配件 天线 数据线 说明书 描述 带 SMA 接头的棒状 NB-IoT 天线 Micro USB 线 说明 BC95 R2.0-TE-B 连接方式和配件信息的单页说明书 数量 1 1 1 上海移远通信技术股份有限公司 25 / 26 BC35-G-TE-B&BC95 R2.0-TE-B 用户指导 7 附录 A 参考文档及术语缩写 表 8：参考文档 序号 文档名称 [1] Quectel_BC35-G_硬件设计手册 [2] Quectel_BC95_R2.0_硬件设计手册 备注 BC35-G 模块硬件设计手册 BC95 R2.0 模块硬件设计手册 表 9：术语缩写 缩写 DFOTA LPWA MCU NB-IoT SMA UART USB USIM 描述 Delta Firmware Upgrade Over-the-Air Low-Power Wide-Area Microcontroller Unit Narrow Band Internet of Things SubMiniature Version A Universal Asynchronous Receiver & Transmitter Universal Serial Bus Universal Subscriber Identification Module 上海移远通信技术股份有限公司 26 / 26

BC26-TE-B 用户指导 LPWA 模块系列 版本：BC26-TE-B_用户指导_V2.1 日期：2019-06-03 状态：受控文件 www.quectel.com BC26-TE-B 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 27 BC26-TE-B 用户指导 文档历史 修订记录 版本 1.0 2.0 2.1 日期 2018-08-01 2018-10-23 作者 孙鹏鹏 孙鹏鹏 2019-06-03 孙鹏鹏 变更表述 初始版本 1. 更新 BC26-TE-B 元器件布局。 2. 更新 USB 接口相关描述（UART 接口数量增加为 4 路）。 1. 更新 USB-UART 芯片驱动下载链接（3.1.2 章节）。 2. 更新 BC26-TE-B 底视图（图 13）。 上海移远通信技术股份有限公司 2 / 27 BC26-TE-B 用户指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 图片索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 安全须知 ...................................................................................................................................... 7 2 综述 ........................................................................................................................................................ 8 2.1. 主要性能 ...................................................................................................................................... 8 2.2. 功能框图 .................................................................................................................................... 10 2.3. 接口分布图 ................................................................................................................................ 10 2.4. Arduino 接口定义图................................................................................................................... 12 3 操作说明 ............................................................................................................................................... 14 3.1. 单板操作说明............................................................................................................................. 14 3.1.1. 单板使用接口示意图....................................................................................................... 15 3.1.2. 操作步骤 ......................................................................................................................... 16 3.2. 多板操作说明............................................................................................................................. 16 3.2.1. 接口和修改示意图 .......................................................................................................... 17 3.2.2. 操作步骤 ......................................................................................................................... 19 3.2.3. 脚位连接说明.................................................................................................................. 19 4 电气性能和可靠性 ................................................................................................................................ 21 4.1. 绝对最大值 ................................................................................................................................ 21 4.2. 工作和存储温度 ......................................................................................................................... 21 5 机械尺寸 ............................................................................................................................................... 23 5.1. BC26-TE-B 机械尺寸 ................................................................................................................ 23 5.2. BC26-TE-B 俯视图和底视图 ..................................................................................................... 24 6 BC26-TE-B 套件及配件 ....................................................................................................................... 25 6.1. BC26-TE-B 套件........................................................................................................................ 25 6.2. BC26-TE-B 配件........................................................................................................................ 26 7 附录 A 参考文档 ................................................................................................................................... 27 上海移远通信技术股份有限公司 3 / 27 BC26-TE-B 用户指导 表格索引 表 1：BC26-TE-B 开发板主要性能 ...................................................................................................................... 8 表 2：接口列表 .................................................................................................................................................. 12 表 3：STM32-L476RG MCU 和 BC26-TE-B 脚位连接表 .................................................................................. 19 表 4：绝对最大值............................................................................................................................................... 21 表 5：模块工作和存储温度范围 ......................................................................................................................... 21 表 6：配件列表 .................................................................................................................................................. 26 表 7：参考文档 .................................................................................................................................................. 27 表 8：术语和缩写............................................................................................................................................... 27 上海移远通信技术股份有限公司 4 / 27 BC26-TE-B 用户指导 图片索引 图 1：BC26-TE-B 功能框图 ............................................................................................................................... 10 图 2：BC26-TE-B 接口分布图 ............................................................................................................................11 图 3：ARDUINO 接口定义图 ............................................................................................................................. 13 图 4：单板使用接口示意图 ................................................................................................................................ 15 图 5：USB 串口显示图 ...................................................................................................................................... 16 图 6：多板使用接口示意图 ................................................................................................................................ 17 图 7：STM32 NUCLEO-64 开发板接口示意图（正面） ................................................................................... 18 图 8：STM32 NUCLEO-64 开发板修改示意图（背面） ................................................................................... 18 图 9：ST-LINK 接口显示图 ................................................................................................................................ 19 图 10：STM32-L476RG MCU 和 BC26-TE-B 脚位连接示意图 ......................................................................... 20 图 11：BC26-TE-B 俯视尺寸图（单位：毫米） ................................................................................................ 23 图 12：BC26-TE-B 俯视图 ................................................................................................................................ 24 图 13：BC26-TE-B 底视图 ................................................................................................................................ 24 图 14：BC26-TE-B 套件 .................................................................................................................................... 25 图 15：BC26-TE-B 及其配件 ............................................................................................................................. 26 上海移远通信技术股份有限公司 5 / 27 BC26-TE-B 用户指导 1 引言 本文档定义了 BC26-TE-B 开发板及其与客户应用连接的空中接口和硬件接口。 本文档可以帮助客户快速了解 BC26-TE-B 开发板硬件接口规范、电气特性、机械规范以及其他相关信 息。通过此文档的帮助，结合我们的硬件设计手册和参考设计手册，客户可以快速应用 BC26 模块于无线 应用。 上海移远通信技术股份有限公司 6 / 27 BC26-TE-B 用户指导 1.1. 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 道路行驶，安全第一！开车时请勿使用手持移动终端设备，即使其有免提功能。请 先停车，再打电话！ 登机前请关闭移动终端设备。在飞机上禁止开启移动终端的无线功能，以防止对飞 机通讯系统的干扰。未遵守该提示项可能会影响飞行安全，甚至触犯法律。 出入医院或健康看护场所时，请注意是否存在移动终端设备使用限制。射频干扰可 能会导致医疗设备运行失常，因此可能需要关闭移动终端设备。 移动终端设备并不保障在任何情况下均能进行有效连接，例如在设备欠费或(U)SIM 卡无效时。在紧急情况下遇到上述情况时，请使用紧急呼叫功能，同时请确保设备 开机并且位于信号强度足够的区域。 移动终端设备在开机时会接收和发射射频信号。当靠近电视、收音机、电脑或者其 他电子设备时都会产生射频干扰。 确保移动终端设备远离易燃易爆品。当靠近加油站、油库、化工厂或爆炸作业场所 时，请关闭移动终端设备。在任何有潜在爆炸危险的场所操作电子设备均存在安全 隐患。 上海移远通信技术股份有限公司 7 / 27 BC26-TE-B 用户指导 2 综述 BC26-TE-B 是一款带有 Arduino 接口的 NB-IoT 系列开发板，其物理尺寸为 70.0mm × 74.0mm × 1.6mm。BC26-TE-B 开发板可单独使用，也可与 STM32 Nucleo-64 系列开发板配合使用，以调试开发通 过 NB-IoT 无线电通信协议（3GPP Rel. 13）与移动网络运营商的基础设备之间建立通信的应用。 2.1. 主要性能 下表详细描述了 BC26-TE-B 开发板的主要性能。 表 1：BC26-TE-B 开发板主要性能 特色 供电 发射功率 模块温度范围 USIM 接口 说明 USB 接口： 供电电压范围：4.75V~5.25V 典型供电电压：5.0V Arduino 接口： 供电电压范围：4.75V~5.25V 典型供电电压：5.0V 23dBm±2dB 正常工作温度：-35°C ~ +75°C 1) 扩展工作温度：-40°C ~ +85°C 2) 存储温度范围：-40°C ~ +90°C 支持 1.8V 外部 USIM 卡 串口开关 USB 接口 用于切换模块主串口通信对象 提供 4 路 UART 接口 主串口（Interface0）：  用于 AT 命令传送和数据传输  模块开机后默认处于自适应波特率模式（支持 115200bps 以下波特率 的自适应同步）；MCU 需要连续发送 AT 命令和模块进行波特率同步， 返回 OK 后表示同步成功；休眠唤醒后模块会直接使用开机后同步成 功的波特率，无需重新同步  也可用于本地软件升级；默认支持 921600bps 波特率 上海移远通信技术股份有限公司 8 / 27 Arduino 接口 复位按键 PWRKEY 按键 物理特征 固件升级 天线接口 BC26-TE-B 用户指导 辅助串口（Interface1）：  用于软件调试，获取底层日志  默认波特率：115200bps 调试串口（Interface2）：  用于软件调试，获取底层日志  默认波特率：115200bps 预留串口（Interface3） 用于连接 STM32 Nucleo-64 系列开发板 用于复位 BC26 模块 用于 BC26 模块开机 尺寸：(70.0±0.15)mm × (74.0±0.15)mm × (1.6±0.2)mm 通过模块的主串口或 DFOTA 升级 50Ω 特征阻抗 备注 1. 1) 表示当模块工作在此温度范围时，模块的相关性能满足 3GPP 标准要求。 2. 2) 表示当模块工作在此温度范围时，模块仍能保持正常工作状态，具备短信*、数据传输等功能；不 会出现不可恢复的故障；射频频谱、网络基本不受影响。仅个别指标如输出功率等参数的值可能会 超出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 3. '*' 表示正在开发中。 上海移远通信技术股份有限公司 9 / 27 2.2. 功能框图 下图为 BC26-TE-B 功能框图： Arduino J306 J308 Micro USB J301 Micro USB Debug J111 DC-DC U201 (U204-NM) LDO U202 LDO U203 USB-UART Bridge U301 Switch J302 BC26-TE-B 用户指导 BC26 U101 RF J304 USIM J401 U302/U303 Voltage-level Translator 图 1：BC26-TE-B 功能框图 2.3. 接口分布图 以下是 BC26-TE-B 的接口分布图： 上海移远通信技术股份有限公司 10 / 27 BC26-TE-B 用户指导 J309 J305 S103 J201 J301 J106 J304 J308 J105 J104 J302 J202 D203 J306 J307 J303 S101 S102 图 2：BC26-TE-B 接口分布图 上海移远通信技术股份有限公司 11 / 27 BC26-TE-B 用户指导 表 2：接口列表 类型 位号 电源接口 J301 J202 USB-UART 接口 USIM 接口 USB 接口 Arduino 接口 RF 天线接口 J306 J301 J303 J104 J305、J306、 J307、J308 J304 串口开关 J302 开机按键 复位按键 PSM 唤醒按键 电源指示灯 JTAG 接口 S101 S102 S103 D203 J309 描述 USB 供电接口 外部电源供电接口 Arduino 供电接口 支持 3 个串口：Interface 0/1/2 Micro-SIM 卡座 抓取 BC26 USB log 标准 Arduino 接口 射频 SMA 接头 用于切换 BC26 主串口通信对象 （'MAIN UART TO USB' 或者 ' MAIN UART TO MCU'） 用于对 BC26 的开机操作 用于对 BC26 的复位操作 用于将 BC26 从 PSM 模式唤醒 用于电源状态指示 用于软件调试 2.4. Arduino 接口定义图 以下是 BC26-TE-B 的 Arduino 接口定义图。 上海移远通信技术股份有限公司 12 / 27 BC26-TE-B 用户指导 UART_MCU_RX UART_MCU_TX PSM_EINT_N PWRKEY_N RESET_N GND hy RI GND GND 5V 3.3V 3.3V 图 3：Arduino 接口定义图 上海移远通信技术股份有限公司 13 / 27 BC26-TE-B 用户指导 3 操作说明 本章主要介绍 BC26-TE-B 的具体操作方法和流程。BC26-TE-B 既可以单板使用，用于 BC26 模块软 件升级或者开发调试基于 BC26 模块的物联网应用；同时也可以使用 Arduino 接口配合 STM32 Nucleo-64 系列开发板使用，用于开发基于 STM32 的物联网应用。以下章节将分别具体介绍单板和多板操作的流程。 3.1. 单板操作说明 本章节主要介绍单独使用 BC26-TE-B 时的接口示意图和操作流程。 上海移远通信技术股份有限公司 14 / 27 3.1.1. 单板使用接口示意图 J301 J302 BC26-TE-B 用户指导 J304 J104 J303 图 4：单板使用接口示意图 上海移远通信技术股份有限公司 15 / 27 BC26-TE-B 用户指导 3.1.2. 操作步骤 1. 下载并安装 USB-UART 芯片驱动，驱动下载地址为： https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers； 2. 在 J303 卡座中插入 Micro-SIM 卡（请选择 NB-IoT 卡）； 3. 在 J304 射频接头上连接 SMA 接头棒状天线； 4. 将串口开关 J302 拨至'MAIN UART TO USB'档； 5. 使用 Micro USB 数据线连接 J301（USB 供电接口）和电脑，随后从电脑的'设备管理器'可以看到如 下图所示的串口。其中 Interface0 连接 BC26 的主串口，可用于 AT 命令传送、数据传输和固件升级； Interface1/2 分别为辅助串口和调试串口，均可用于输出调试日志信息等。具体的串口配置和操作请参 阅 Quectel_BC26_硬件设计手册。 图 5：USB 串口显示图 备注 使用过程中 S101 可以用于 BC26 模块的开机；S102 可用于 BC26 模块的复位；S103 可将 BC26 模块 从 PSM 模式唤醒。 3.2. 多板操作说明 本章节将对 BC26-TE-B 和 STM32 Nucleo-64 系列开发板配合使用时的操作流程进行详细说明。 上海移远通信技术股份有限公司 16 / 27 3.2.1. 接口和修改示意图 BC26-TE-B 用户指导 J309 J305 S103 J201 J301 J106 J304 J308 J105 J104 J302 J202 D203 J306 J307 J303 S101 S102 图 6：多板使用接口示意图 上海移远通信技术股份有限公司 17 / 27 CN2 2J2 03 CN1 BC26-TE-B 用户指导 CN6 CN8 JP5 JP6 CN5 CN9 图 7：STM32 Nucleo-64 开发板接口示意图（正面） SB13 SB14 SB62 SB63 图 8：STM32 Nucleo-64 开发板修改示意图（背面） 上海移远通信技术股份有限公司 18 / 27 BC26-TE-B 用户指导 3.2.2. 操作步骤 1. 安装 STM32 Nucleo 开发板驱动，驱动下载地址为： http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-to ols/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-l476rg.html； 2. 安装 USB-UART 芯片驱动，驱动下载地址为： https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers； 3. 使用烙铁移除 STM32 Nucleo-64 开发板背面 SB13 和 SB14 两颗 0Ω 电阻，并分别焊接到 SB62 和 SB63 位置上； 4. 将 STM32 Nucleo-64 开发板正面 CN2 的 1 和 2 脚短接，3 和 4 脚短接，JP5 的 1 和 2 脚短接，JP6 脚 1 和 2 脚短接； 5. 在 J303 卡座中插入 Micro-SIM 卡（请选择 NB 卡）； 6. 在 J304 射频接头上连接 SMA 接头棒状天线； 7. 将串口开关拨至'MAIN UART TO MCU'档； 8. 使用 Arduino 接口将 BC26-TE-B 与 STM32 Nucleo-64 开发板对接：BC26-TE-B 的 J305、J306、J307 和 J308 分别连接 STM32 Nucleo-64 开发板的 CN5、CN6、CN8 和 CN9； 9. 用 Mini USB 数据线连接 STM32 Nucleo-64 开发板 CN1 和电脑；等待模块上电开机后，从电脑的'设 备管理器'将可以看到如下图示的设备信息。 图 9：ST-LINK 接口显示图 3.2.3. 脚位连接说明 以下以 STM32-L476RG MCU 为例，说明 STM32 Nucleo-64 开发板和 BC26-TE-B 的脚位连接方式。 表 3：STM32-L476RG MCU 和 BC26-TE-B 脚位连接表 序号 MCU (Morpho) Arduino 1 PA2 D1 CN9-2 2 PA3 D0 CN9-1 BC26-TE-B 备注 UART_MCU_TX 主串口 RX UART_MCU_RX 主串口 TX 上海移远通信技术股份有限公司 19 / 27 BC26-TE-B 用户指导 4 PA7 5 PA6 6 PA5 7 PA0 8 +5V 9 GND 10 +3.3V 11 +3.3V D11 CN5-4 D12 CN5-5 D13 CN5-6 A0 CN8-1 +5V CN6-5 GND CN5-7, CN6-6, 7 +3.3V CN6-4 IOREF CN6-2 PSM_EINT_N PWRKEY_N RESET_N RI +5V GND +3.3V +3.3V PSM 中断 高电平有效 高电平有效 振铃提示 5.0V 电源 地 3.3V 电源 3.3V 电源 以下是 STM32-L476RG MCU 和 BC26-TE-B 脚位连接示意图。 +3.3V +5+V3.3V GND GND GND RESET_N PWRKEY_N PSM_EINT_N APODCRW0I ER_EN UART_MCU_TX UART_MCU_RX Arduino Morpho BC26-TE-B 图 10：STM32-L476RG MCU 和 BC26-TE-B 脚位连接示意图 上海移远通信技术股份有限公司 20 / 27 BC26-TE-B 用户指导 4 电气性能和可靠性 4.1. 绝对最大值 下表所示是 BC26 模块数字和模拟引脚的电源供电电压/电流最大耐受值。 表 4：绝对最大值 参数 +5V VBAT 电源供电电流 数字引脚电压 模拟引脚电压 断电模式下，数字/模拟引脚电压 最小 -0.3 2.1 待定 待定 待定 待定 最大 6 3.63 待定 待定 待定 待定 4.2. 工作和存储温度 下表所示为 BC26 模块的工作和存储温度范围。 表 5：模块工作和存储温度范围 参数 正常工作温度范围 1) 扩展工作温度范围 2) 存储温度范围 最小 -35 -40 -40 典型 +25 最大 +75 +85 +90 单位 V V A V V V 单位 ºC ºC ºC 上海移远通信技术股份有限公司 21 / 27 BC26-TE-B 用户指导 备注 1. 1) 表示当模块工作在此温度范围时，模块的相关性能满足 3GPP 标准要求； 2. 2) 表示当模块工作在此温度范围时，模块仍能保持正常工作状态，具备短信*、数据传输等功能，不 会出现不可恢复的故障。射频频谱、网络基本不受影响，仅个别指标如输出功率等参数的值可能会 超出 3GPP 标准的范围。当温度返回至正常工作温度范围时，模块的各项指标仍符合 3GPP 标准。 3. '*' 表示正在开发中。 上海移远通信技术股份有限公司 22 / 27 BC26-TE-B 用户指导 5 机械尺寸 本章描述了 BC26-TE-B 的机械尺寸。尺寸单位为 mm，尺寸公差为±0.15mm。 5.1. BC26-TE-B 机械尺寸 图 11：BC26-TE-B 俯视尺寸图（单位：毫米） 上海移远通信技术股份有限公司 23 / 27 5.2. BC26-TE-B 俯视图和底视图 BC26-TE-B 用户指导 图 12：BC26-TE-B 俯视图 上海移远通信技术股份有限公司 图 13：BC26-TE-B 底视图 24 / 27 6 BC26-TE-B 套件及配件 6.1. BC26-TE-B 套件 BC26-TE-B 用户指导 图 14：BC26-TE-B 套件 上海移远通信技术股份有限公司 25 / 27 6.2. BC26-TE-B 配件 BC26-TE-B 用户指导 图 15：BC26-TE-B 及其配件 表 6：配件列表 配件 天线 数据线 说明书 描述 带 SMA 接头的棒状 NB-IoT 天线 Micro USB 线 说明 BC26-TE-B 连接方式和配件信息的单页说明书 数量 1 1 1 上海移远通信技术股份有限公司 26 / 27 BC26-TE-B 用户指导 7 附录 A 参考文档 表 7：参考文档 序号 文档名称 [1] Quectel_BC26_硬件设计手册 备注 BC26 硬件设计手册 表 8：术语和缩写 缩写 DFOTA MCU NB-IoT SMA UART USB (U)SIM 描述 Delta Firmware Upgrade Over-the-air Microcontroller Unit Narrow Band Internet of Things SubMiniature Version A Universal Asynchronous Receiver & Transmitter Universal Serial Bus (Universal) Subscriber Identification Module 上海移远通信技术股份有限公司 27 / 27

L96 EVB User Guide GNSS Module Series Rev. L96_EVB_User_Guide_V1.2 Date: 2018-08-14 Status: Released www.quectel.com GNSS Module Series L96 EVB User Guide 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. L96_EVB_User_Guide 1 / 29 GNSS Module Series L96 EVB User Guide About the Document History Revision Date 1.0 2017-10-27 1.1 2017-12-27 1.2 2018-08-14 Author Brooke WANG Brooke WANG Brooke WANG Description Initial Updated Figure 6, Figure 7 and added the description of how to switch between the internal and external antennas. Updated Table 5. Updated Chapter 6. L96_EVB_User_Guide 2 / 29 GNSS Module Series L96 EVB User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Safety Information ....................................................................................................................... 7 2 General Overview................................................................................................................................. 8 2.1. Top and Bottom Views ................................................................................................................ 8 2.2. L96 EVB & Kit Accessories ....................................................................................................... 10 3 Interface Applications ....................................................................................................................... 11 3.1. USB Interface............................................................................................................................ 11 3.2. UART Interface.......................................................................................................................... 12 3.3. Antenna Interface...................................................................................................................... 12 3.4. Switches and Buttons ............................................................................................................... 14 3.5. Operation Status Indication LEDs............................................................................................. 15 3.6. Test Points................................................................................................................................. 16 4 EVB and Accessories Assembly...................................................................................................... 17 5 EVB Operation Procedures............................................................................................................... 18 5.1. Communication via USB Interface ............................................................................................ 18 5.2. Firmware Upgrade .................................................................................................................... 19 6 Usage of PowerGPS .......................................................................................................................... 20 6.1. COM and Baud Rate Setting .................................................................................................... 20 6.1.1. Explanations of PowerGPS Interface ............................................................................ 21 6.2. PMTK Command Sending ........................................................................................................ 22 6.3. Automatic TTFF Testing ............................................................................................................ 23 7 Appendix A References..................................................................................................................... 28 L96_EVB_User_Guide 3 / 29 GNSS Module Series L96 EVB User Guide Table Index TABLE 1: INTERFACES OF L96 EVB ......................................................................................................... 9 TABLE 2: ACCESSORIES LIST................................................................................................................. 10 TABLE 3: PIN DEFINITION OF UART INTERFACE ................................................................................. 12 TABLE 4: L96 EVB SWITCHES AND BUTTONS...................................................................................... 14 TABLE 5: OPERATION STATUS INDICATION LEDS ............................................................................... 15 TABLE 6: PIN DESCRIPTION OF J106 .................................................................................................... 16 TABLE 7: EXPLANATIONS OF SIGNAL & NMEA TEXT .......................................................................... 21 TABLE 8: RELATED DOCUMENTS .......................................................................................................... 28 TABLE 9: TERMS AND ABBREVIATIONS ................................................................................................ 28 L96_EVB_User_Guide 4 / 29 GNSS Module Series L96 EVB User Guide Figure Index FIGURE 1: TOP VIEW OF L96 EVB............................................................................................................ 8 FIGURE 2: BOTTOM VIEW OF L96 EVB.................................................................................................... 9 FIGURE 3: L96 EVB & KIT ACCESSORIES ............................................................................................. 10 FIGURE 4: MICRO-USB INTERFACE........................................................................................................11 FIGURE 5: UART INTERFACE.................................................................................................................. 12 FIGURE 6: L96 EVB EXTERNAL ANTENNA INTERFACE ....................................................................... 13 FIGURE 7: L96 EVB LNA LAYOUT ........................................................................................................... 13 FIGURE 8: L96 EVB SWITCHES AND BUTTONS ................................................................................... 14 FIGURE 9: OPERATION STATUS INDICATION LEDS............................................................................. 15 FIGURE 10: L96 EVB TEST POINTS - J106............................................................................................. 16 FIGURE 11: L96 EVB AND ACCESSORIES ASSEMBLY ......................................................................... 17 FIGURE 12: USB PORTS .......................................................................................................................... 18 FIGURE 13: COM PORT SETTING INTERFACE OF QCOM................................................................... 18 FIGURE 14: FLASHTOOL CONFIGURATIONS FOR FIRMWARE UPGRADE ....................................... 19 FIGURE 15: POWERGPS INTERFACE .................................................................................................... 20 FIGURE 16: COM PORT AND BAUD RATE SELECTION........................................................................ 20 FIGURE 17: PMTK COMMAND SENDING VIA POWERGPS.................................................................. 22 FIGURE 18: STATIC TTFF TESTING VIA POWERGPS........................................................................... 23 FIGURE 19: CHOOSE REFERENCE LOCATION .................................................................................... 24 FIGURE 20: CLICK USE MEAN POSITION.............................................................................................. 24 FIGURE 21: CLICK CONFIG ..................................................................................................................... 25 FIGURE 22: SET TTFF TIME-OUT (SEC)................................................................................................. 26 FIGURE 23: CLICK RUN/STOP BUTTON ................................................................................................ 27 L96_EVB_User_Guide 5 / 29 GNSS Module Series L96 EVB User Guide 1 Introduction This document specifies the usage of L96 EVB (Evaluation Board) which is an assistant tool for engineers to develop and test Quectel L96 modules. L96_EVB_User_Guide 6 / 29 GNSS Module Series L96 EVB User Guide 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating L96 module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for the customers' failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as to prevent interference with communication systems. Consult the airline staff about the use of wireless devices on boarding the aircraft, if your device offers an Airplane Mode which must be enabled prior to boarding an aircraft. Switch off your wireless device when in hospitals, clinics or other health care facilities. These requests are designed to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid (U)SIM card. While you are in this condition and need emergent help, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency energy. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. L96_EVB_User_Guide 7 / 29 2 General Overview 2.1. Top and Bottom Views The following illustrate the top and bottom views of L96 EVB. GNSS Module Series L96 EVB User Guide Figure 1: Top View of L96 EVB L96_EVB_User_Guide 8 / 29 GNSS Module Series L96 EVB User Guide Figure 2: Bottom View of L96 EVB Table 1: Interfaces of L96 EVB Reference SN. Number A J301 B S301 C S102 D S103 E S201 F J201 G L1, L2 H J101 I U105 J S101 K J106 Description UART port USB ←→ UART (serial port alternation switch) RESET button FORCE_ON button POWER switch Micro-USB port Indication LEDs Antenna interface L96 module STANDBY switch Test points L96_EVB_User_Guide 9 / 29 2.2. L96 EVB & Kit Accessories EVB GNSS Module Series L96 EVB User Guide USB Cable GNSS Antenna USB Flash Drive Bolts and Coupling Nuts Figure 3: L96 EVB & Kit Accessories Table 2: Accessories List Items Cable Antenna USB Flash Drive Instruction Sheet Others Description Quantity USB cable 1 GNSS Antenna (Active) 1 USB Flash Drive 1 A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. Bolts and Coupling Nuts 4 for each type L96_EVB_User_Guide 10 / 29 GNSS Module Series L96 EVB User Guide 3 Interface Applications 3.1. USB Interface The main power is supplied via a micro-USB interface. Both micro-USB and UART interfaces can be used for data communication, and the two interfaces can be switched by the alternation switch (S301). If UART interface is used for data communication (NMEA sentences output), then both RS232 and micro-USB cables are necessary for operating the EVB. So it is strongly recommended to use the micro-USB interface for both power supply and NEMA output, during which only a USB cable is needed. Figure 4: Micro-USB Interface NOTE If the PowerGPS Tool needs to be used, then it is recommended to use the UART interface for data communication. L96_EVB_User_Guide 11 / 29 3.2. UART Interface GNSS Module Series L96 EVB User Guide Figure 5: UART Interface Table 3: Pin Definition of UART Interface Pin No. Signal I/O 2 RXD DI 3 TXD DO 5 GND Description Receive data Transmit data GND 3.3. Antenna Interface L96 module uses the internal antenna by default, and R141 is mounted by default. If an external antenna needs to be used, then R141 should be moved to R116. Both active antenna and passive antenna can be selected as the external antenna. The following illustrate the external antenna interface and LNA layout of the EVB. L96_EVB_User_Guide 12 / 29 GNSS Module Series L96 EVB User Guide Figure 6: L96 EVB External Antenna Interface Figure 7: L96 EVB LNA Layout Please note that the LNA is installed in the EVB by default, and thus customers have to move R112 to C107 and R105 to R118, when the LNA needs to be used. L96_EVB_User_Guide 13 / 29 3.4. Switches and Buttons The following figure illustrates the switches and buttons of the EVB. GNSS Module Series L96 EVB User Guide Figure 8: L96 EVB Switches and Buttons Table 4: L96 EVB Switches and Buttons Part No. Name I/O S101 STANDBY DI S102 S103 S201 S301 RESET DI FORCE_ON DI POWER PI USB ←→ UART (serial port DI alternation switch) Description The module will enter into standby mode after the S101 is switched from OFF to ON, and exit from standby mode through the opposite operation. Press and release the button, the module will be reset. Press and release the button, the module will be woken up from backup mode. Control power supply via micro-USB interface. L96 EVB supports data communication via both micro-USB and UART interfaces which are controlled by the S301 switch. L96_EVB_User_Guide 14 / 29 3.5. Operation Status Indication LEDs GNSS Module Series L96 EVB User Guide Figure 9: Operation Status Indication LEDs Table 5: Operation Status Indication LEDs Part Name I/O L1 TXD1 DO L2 1PPS DO Description Flash: the module is turned on successfully, and the micro-USB or UART port can be used to output messages. Extinct: fail to turn on the module. Flash: successful fix. The frequency is 1Hz. Extinct: no fix. L96_EVB_User_Guide 15 / 29 3.6. Test Points The following figure illustrates the test points of the EVB. GNSS Module Series L96 EVB User Guide Figure 10: L96 EVB Test Points - J106 Table 6: Pin Description of J106 Pin No. Signal I/O 1/2 GND - 3 STANDBY DI 4 RXD1 DI 5 1PPS DO 6 TXD1 DO 7/9 NC - 8 RESET DI 10 FORCE_ON DI Description Ground Enter or exit standby mode Receive data 1 pulse per second Transmit data Not connected System reset Logic high will force module to be woken up from backup mode. Keep this pin open or pulled low before entering into backup mode. If unused, keep this pin open. L96_EVB_User_Guide 16 / 29 GNSS Module Series L96 EVB User Guide 4 EVB and Accessories Assembly The following figure shows the assembly of L96 EVB and its accessories. Figure 11: L96 EVB and Accessories Assembly L96_EVB_User_Guide 17 / 29 GNSS Module Series L96 EVB User Guide 5 EVB Operation Procedures This chapter mainly illustrates the operation procedures of L96 EVB. 5.1. Communication via USB Interface Step 1: Connect the EVB and the PC with a USB cable through USB interface, and then switch the S201 to ON state to power on the EVB. Step 2: Run the driver disk on PC to install the USB driver. The USB port numbers can be viewed through the PC Device Manager, shown as below. Figure 12: USB Ports Step 3: Install and then use the QCOM tool provided by Quectel to realize the communication between the L96 module and the PC. The following figure shows the COM Port Setting interface of QCOM: select correct 'COM Port' (USB AT Port shown in above figure) and set the correct 'Baudrate' (the default value: 9600bps). For more details of QCOM usage, please refer to document [4]. Figure 13: COM Port Setting Interface of QCOM L96_EVB_User_Guide 18 / 29 GNSS Module Series L96 EVB User Guide 5.2. Firmware Upgrade Quectel L96 module upgrades the firmware via USB port by default. Please follow the procedures below to upgrade firmware. Step 1: Install and open the firmware upgrade tool FlashTool on PC. Step 2: Power on the EVB according to the procedures mentioned in Step 1 of Chapter 5.1. Step 3: Follow the steps below to start firmware upgrade. a) Click the 'Baud rate' dropdown list and select the 'Auto Detect'. b) Click the 'COM Port' dropdown list and select the COM port. c) Choose the firmware package. d) Click the 'Download' and 'Go' button to upgrade the firmware. Figure 14: FlashTool Configurations for Firmware Upgrade L96_EVB_User_Guide 19 / 29 GNSS Module Series L96 EVB User Guide 6 Usage of PowerGPS 6.1. COM and Baud Rate Setting The PowerGPS tool can help users to view the status of GPS/GLONASS/BeiDou/Galileo receivers conveniently. After EVB accessories are assembled, turn on the module and start up the PowerGPS. After the tool (PowerGPS Trial 2.3.6) is opened, the following interface in default layout will be shown: Figure 15: PowerGPS Interface At the bottom of the interface, select a correct COM port and baud rate (L96 module supports 9600bps by default), then click the button 'Create Connection'. Figure 16: COM Port and Baud Rate Selection L96_EVB_User_Guide 20 / 29 GNSS Module Series L96 EVB User Guide 6.1.1. Explanations of PowerGPS Interface From the PowerGPS interface, users can view CNR message, time, position, speed, precision and so on. Explanations are listed in the table below. Table 7: Explanations of Signal & NMEA Text Icon Explanation SV with PRN 65. If the position of SV is near to the centre of the Sky View, the elevation angle of SV is close to 90°. Dark blue means this satellite is in tracking. Light blue means this satellite is not in tracking. The CNR of PRN 24 is 51dB/Hz. G means it is a GPS satellite, R means it is a GLONASS satellite, S means it is a SBAS. Light blue column means the navigation data of this satellite is in use. The CNR of PRN 66 is 26dB/Hz. White column means the navigation data of this satellite is not in use. The range of GLONASS SVID is 65-96. L96_EVB_User_Guide 21 / 29 UTC time Latitude degree Longitude degree Position fix The number of satellites being used Horizontal Dilution of Precision Altitude based on WGS84 datum UTC date Fixing mode: No-fix, 3D or 2D SPS Satellite being used Position Dilution of Precision Vertical Dilution of Precision Speed of receiver GNSS Module Series L96 EVB User Guide 6.2. PMTK Command Sending PMTK command can be sent by PowerGPS. The format of PMTK command includes only characters between ‘$’ and ‘*’, for example: PMTK869,0. Figure 17: PMTK Command Sending via PowerGPS L96_EVB_User_Guide 22 / 29 GNSS Module Series L96 EVB User Guide 6.3. Automatic TTFF Testing PowerGPS tool allows customers to measure the TTFF (Time to First Fix) under different testing conditions. The TTFF can be tested under full start, cold start, warm start or hot start conditions, and the number of tests can be chosen from 1, 10, 20, 100, 1000 and 10000. Click the 'Run' button to start the test and it can be stopped by clicking the 'Stop' button. The following are the detailed configuration steps during TTFF testing: Step 1: Start 'MTK' menu, and then click 'Static TTFF Testing' to enter Automatic TTFF Testing as shown below: Restart Type The Number of Tests Figure 18: Static TTFF Testing via PowerGPS Step 2: Click 'Set Reference Point' and the Options window will be shown as below, then choose 'Reference Location'. L96_EVB_User_Guide 23 / 29 GNSS Module Series L96 EVB User Guide Figure 19: Choose Reference Location After that, the interface will be shown as below. Click 'Use Mean Position' and then 'OK'. Figure 20: Click Use Mean Position L96_EVB_User_Guide 24 / 29 GNSS Module Series L96 EVB User Guide Step 3: Return to the interface shown in Figure 18 and click 'Config' to get into the interface of TTFF Configuration. Then set 'TTFF Time- out (sec)', and finally click 'OK'. Figure 21: Click Config L96_EVB_User_Guide 25 / 29 GNSS Module Series L96 EVB User Guide Figure 22: Set TTFF Time-out (Sec) In generally, if hot start is selected, 'TTFF Time-out (sec)' is recommended to be set as 10s. If warm start is selected, it can be set as 50s. If cold start is selected, it can be set as 100s. 'TTFF Time–out (sec)' can help judge TTFF and save time. Step 4: After the above operations have been completed, click the 'Run' button to start the test and it can be stopped by clicking 'Stop' button. L96_EVB_User_Guide 26 / 29 GNSS Module Series L96 EVB User Guide Figure 23: Click Run/Stop Button Step 5: After finishing the testing, customers can see the testing result charts. Of course, the result also will be stored in the tool installation path, for convenient view of the corresponding log. L96_EVB_User_Guide 27 / 29 GNSS Module Series L96 EVB User Guide 7 Appendix A References Table 8: Related Documents SN Document name Remark [1] Quectel_L96_Hardware_Design L96 Hardware Design [2] Quectel_L96_GNSS_Protocol_Specification L96 GNSS Protocol Specification [3] Quectel_L96_Reference Design L96 Reference Design [4] Quectel_QCOM_User_Guide QCOM User Guide Table 9: Terms and Abbreviations Abbreviation CNR DI DO GPS GLONASS GNSS HDOP IO LED PDOP PI Description Carrier-to-Noise Ratio Digital input Digital output Global Positioning System Globalnaya Navigazionnaya Sputnikovaya Sistema, or Global Navigation Satellite System (Russia's version of GPS) Global Navigation Satellite System Horizontal Dilution of Precision Bidirectional Light Emitting Diode Position Dilution of Precision Power input L96_EVB_User_Guide 28 / 29 PO PPS PRN SPS SV UART UTC VDOP WGS84 Power output Pulse Per Second Pseudorandom Noise Standard Positioning Service Satellite Vehicle Universal Asynchronous Receiver & Transmitter Universal Time Coordinated Vertical Dilution of Precision World Geodetic System 1984 GNSS Module Series L96 EVB User Guide L96_EVB_User_Guide 29 / 29

L76C EVB User Guide GNSS Module Series Rev. L76C_EVB_User_Guide_V1.0 Date: 2018-08-29 Status: Released www.quectel.com GNSS Module Series L76C EVB User Guide 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. L76C_EVB_User_Guide 1 / 26 GNSS Module Series L76C EVB User Guide About the document History Revision Date 1.0 2018-08-29 Author Brooke WANG/ Gobber HU Description Initial L76C_EVB_User_Guide 2 / 26 GNSS Module Series L76C EVB User Guide Contents About the document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Safety Information ....................................................................................................................... 7 2 General Overview................................................................................................................................. 8 2.1. Top and Bottom Views ................................................................................................................ 8 2.2. Key Features ............................................................................................................................. 10 2.3. EVB Kit Accessories ................................................................................................................. 10 3 Interface Applications ....................................................................................................................... 12 3.1. Micro-USB Interface.................................................................................................................. 12 3.2. SD Card Interface ..................................................................................................................... 13 3.3. Antenna Interface...................................................................................................................... 13 3.4. Switches and Buttons ............................................................................................................... 14 3.5. Operation Status Indication LEDs............................................................................................. 15 3.6. Test Points................................................................................................................................. 16 4 EVB and Accessories Assembly...................................................................................................... 17 5 EVB Operation Procedures............................................................................................................... 18 5.1. Communication via USB Interface ............................................................................................ 18 5.2. Firmware Upgrade .................................................................................................................... 19 6 Usage of uSTAR ................................................................................................................................. 20 6.1. uSTAR Interface ........................................................................................................................ 20 6.1.1. COM Port and Baud Rate Setting.................................................................................. 20 6.1.2. Explanations of uSTAR Interface ................................................................................... 21 6.2. Command Sending ................................................................................................................... 22 6.3. TTFF Testing ............................................................................................................................. 23 7 Appendix A Reference....................................................................................................................... 26 L76C_EVB_User_Guide 3 / 26 GNSS Module Series L76C EVB User Guide Table Index TABLE 1: INTERFACES OF L76C EVB .............................................................................................................. 9 TABLE 2: KEY FEATURES OF L76C EVB........................................................................................................ 10 TABLE 3: LIST OF ACCESSORIES ...................................................................................................................11 TABLE 4: L76C SWITCHES AND BUTTONS ................................................................................................... 15 TABLE 5: OPERATION STATUS INDICATION LEDS....................................................................................... 15 TABLE 6: PIN DESCRIPTION OF J106 ............................................................................................................ 16 TABLE 7: EXPLANATIONS OF USTAR INTERFACE....................................................................................... 21 TABLE 8: TERMS AND ABBREVIATIONS ........................................................................................................ 26 L76C_EVB_User_Guide 4 / 26 GNSS Module Series L76C EVB User Guide Figure Index FIGURE 1: TOP VIEW OF L76C EVB................................................................................................................. 8 FIGURE 2: BOTTOM VIEW OF L76C EVB......................................................................................................... 9 FIGURE 3: EVB KIT ACCESSORIES ............................................................................................................... 10 FIGURE 4: MICRO-USB INTERFACE .............................................................................................................. 12 FIGURE 5: SD CARD INTERFACE................................................................................................................... 13 FIGURE 6: L76C EVB ANTENNA INTERFACE ................................................................................................ 14 FIGURE 7: L76C EVB SWITCHES AND BUTTONS ........................................................................................ 14 FIGURE 8: OPERATION STATUS INDICATION LEDS .................................................................................... 15 FIGURE 9: L76C EVB TEST POINTS - J106.................................................................................................... 16 FIGURE 10: L76C EVB AND ACCESSORIES ASSEMBLY .............................................................................. 17 FIGURE 11: USB PORTS.................................................................................................................................. 18 FIGURE 12: COM PORT SETTING INTERFACE OF QCOM .......................................................................... 18 FIGURE 13: FIREBIRD UPDATE FW TOOL CONFIGURATIONS FOR FIRMWARE UPGRADE ................... 19 FIGURE 14: USTAR TOOL INTERFACE .......................................................................................................... 20 FIGURE 15: COM PORT AND BAUD RATE SELECTION ............................................................................... 21 FIGURE 16: COMMAND SENDING VIA USTAR .............................................................................................. 23 FIGURE 17: STATIC TTFF TESTING VIA USTAR............................................................................................ 24 FIGURE 18: COLD START TTFF TESTING CONFIGURATION ...................................................................... 24 FIGURE 19: HOT START TTFF TESTING CONFIGURATION OPTIONS ....................................................... 25 FIGURE 20: WARM START TTFF TESTING CONFIGURATION OPTIONS.................................................... 25 L76C_EVB_User_Guide 5 / 26 GNSS Module Series L76C EVB User Guide 1 Introduction This document defines and specifies the usage of L76C EVB (Evaluation Board) which is an assistant tool for engineers to develop and test Quectel L76C module. L76C_EVB_User_Guide 6 / 26 GNSS Module Series L76C EVB User Guide 1.1. Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating L76C module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for customers' failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If the device offers an Airplane Mode, then it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on boarding the aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signals and cellular network cannot be guaranteed to connect in all possible conditions (for example, with unpaid bills or with an invalid (U)SIM card). When emergent help is needed in such conditions, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. The cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. L76C_EVB_User_Guide 7 / 26 GNSS Module Series L76C EVB User Guide 2 General Overview 2.1. Top and Bottom Views The following illustrate the top and bottom views of L76C EVB. H G I B J E F CD Figure 1: Top View of L76C EVB L76C_EVB_User_Guide 8 / 26 GNSS Module Series L76C EVB User Guide A Figure 2: Bottom View of L76C EVB Table 1: Interfaces of L76C EVB Reference SN. Description Number A J303 SD card interface B S301 USB ←→ SD (serial port alternation switch) C S102 RESET button D S103 Reserved E S201 POWER switch F J201 Micro-USB interface G D105, D106 Indication LEDs H J101 Antenna interface I U101 L76C module J J106 Test points L76C_EVB_User_Guide 9 / 26 GNSS Module Series L76C EVB User Guide 2.2. Key Features The following table describes the detailed features of L76C EVB. Table 2: Key Features of L76C EVB Features Power Supply SD Card Interface Micro-USB Interface Signal Indication Switches and Buttons Physical Characteristics Implementation DC power supply (J201): 4.5V~5.5V, typically: 5.0V SD card for NEMA output data storage Power supply and NEMA sentence output 2 LEDs are available for signal indication POWER Switch (S201) RESET (S102) USB ←→ SD (serial port alternation switch) (S301) Size: 115mm × 80mm 2.3. EVB Kit Accessories USB Cable GNSS Antenna USB Flash Drive EVB Bolts and Coupling Nuts L76C_EVB_User_Guide Figure 3: EVB Kit Accessories 10 / 26 GNSS Module Series L76C EVB User Guide Table 3: List of Accessories Items EVB Cable Antenna USB Flash Drive Instruction Sheet Others Description Quantity L76C EVB 1 USB cable 1 Active GNSS antenna 1 GNSS_EVB_Micro-USB_Driver_CP210x 1 A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. Bolts and coupling nuts 4 for each type L76C_EVB_User_Guide 11 / 26 GNSS Module Series L76C EVB User Guide 3 Interface Applications 3.1. Micro-USB Interface The main power is supplied via a Micro-USB interface. Both Micro-USB and SD card interfaces can be used for data communication, and they can be switched to each other by the alternation switch (S301). If SD card interface is used for data communication (NMEA sentence output), then both SD card and Micro-USB cables are necessary for operating the EVB. So it is strongly recommended to use the Micro-USB interface for both power supply and NEMA sentence output, during which only a USB cable is needed. Micro-USB Interface Figure 4: Micro-USB Interface L76C_EVB_User_Guide 12 / 26 GNSS Module Series L76C EVB User Guide 3.2. SD Card Interface The interface supports SD card to store module output data. The memory storage capacity of supported SD card should be no more than 32GB. Figure 5: SD Card Interface 3.3. Antenna Interface The L76C module can be connected to a dedicated passive or active GNSS antenna and it has a built-in LNA to improve sensitivity. The antenna interface is used for connection with an external antenna. L76C_EVB_User_Guide 13 / 26 GNSS Module Series L76C EVB User Guide Antenna Figure 6: L76C EVB Antenna Interface 3.4. Switches and Buttons The following illustrates the switches and buttons of the EVB. S301 S201 S102 S103 Figure 7: L76C EVB Switches and Buttons L76C_EVB_User_Guide 14 / 26 Table 4: L76C Switches and Buttons Part No. S102 S103 S201 S301 Name I/O RESET DI - - POWER PI USB ←→ SD (serial port IO alternation switch) GNSS Module Series L76C EVB User Guide Description Press and then release the button, the module will be reset. Reserved Control power supply via Micro-USB interface. L76C EVB supports data communication via both Micro-USB and SD card interfaces which are controlled and switched by the S301 switch. 3.5. Operation Status Indication LEDs D105 D106 Figure 8: Operation Status Indication LEDs Table 5: Operation Status Indication LEDs Part Name I/O D105 TXD DO D106 1PPS DO Description Flash: the module is turned on successfully, and either Micro-USB or SD card interface can be used to output messages. Extinct: failed to turn on the module. Flash: successful fix. The frequency is 1Hz. Extinct: no fix. L76C_EVB_User_Guide 15 / 26 3.6. Test Points The following figure illustrates the test points of the EVB. GNSS Module Series L76C EVB User Guide 54 321 6 7 8 9 10 Figure 9: L76C EVB Test Points - J106 Table 6: Pin Description of J106 Pin No. Signal I/O 1/10 GND - 2 NC - 3 1PPS DO 4 NC - 5 NC - 6 NC - 7 RESET DI 8 TXD1 DO 9 RXD1 DI Description Ground Reserved 1 pulse per second Reserved Reserved Reserved System reset Transmit data Receive data L76C_EVB_User_Guide 16 / 26 GNSS Module Series L76C EVB User Guide 4 EVB and Accessories Assembly The following figure shows the assembly of L76C EVB and its accessories. Figure 10: L76C EVB and Accessories Assembly L76C_EVB_User_Guide 17 / 26 GNSS Module Series L76C EVB User Guide 5 EVB Operation Procedures This chapter mainly illustrates the operation procedures of L76C EVB. 5.1. Communication via USB Interface Step 1: Connect the EVB and the PC with a USB cable through USB interface, and then switch S201 to ON state to power on the EVB. Step 2: Run the USB flash drive on PC to install the USB driver. The USB port numbers can be viewed through the PC Device Manager, shown as below. Figure 11: USB Ports Step 3: Install and then use the QCOM tool provided by Quectel to realize the communication between the L76C module and the PC. The following figure shows the COM Port Setting interface of QCOM: select the correct 'COM Port' (USB Port shown in the above figure) and set the correct 'Baudrate' (the default value: 9600bps). For more details of QCOM usage, please refer to Quectel_QCOM_User_Guide. Figure 12: COM Port Setting Interface of QCOM L76C_EVB_User_Guide 18 / 26 GNSS Module Series L76C EVB User Guide 5.2. Firmware Upgrade Quectel L76C module upgrades its firmware via USB interface by default. Please follow the procedures below to upgrade the firmware. Step 1: Install and open the firmware upgrade tool (Firebird Update FW Tool) on PC. Step 2: Power on the EVB according to the procedures mentioned in step 1 of Chapter 5.1. Step 3: Follow the steps below to start firmware upgrade. a) Select the COM port. b) Choose the firmware package. c) Click the 'Baud rate' dropdown list and select '9600'. d) Click the 'START' button to upgrade the firmware. b a c d Figure 13: Firebird Update FW Tool Configurations for Firmware Upgrade L76C_EVB_User_Guide 19 / 26 GNSS Module Series L76C EVB User Guide 6 Usage of uSTAR 6.1. uSTAR Interface 6.1.1. COM Port and Baud Rate Setting The uSTAR tool can help users to view the status of GNSS receiver conveniently. After EVB accessories are assembled, turn on the module and start up the uSTAR. After the tool is opened, the following interface will be shown: Figure 14: uSTAR Tool Interface L76C_EVB_User_Guide 20 / 26 GNSS Module Series L76C EVB User Guide After that, select a correct COM port and baud rate (L76C module supports 9600bps by default), then click the button 'OK'. Figure 15: COM Port and Baud Rate Selection 6.1.2. Explanations of uSTAR Interface From the uSTAR interface, users can view CNR message, time, position, speed, precision, and so on. Explanations are listed in the table below. Table 7: Explanations of uSTAR Interface Icon Explanation ⚫ SV with PRN 17 and 165. ⚫ If the position of SV is near to the centre of the Sky View, the elevation angle of SV is close to 90°. ⚫ Green or dark green means this satellite is in tracking. ⚫ Fuchsia means this satellite is not in tracking. ⚫ The CNR of PRN 30 is 52dB/Hz. ⚫ Green column means the navigation data of the GPS satellite is in use. ⚫ Orange column means the navigation data of the BeiDou satellite is in use. L76C_EVB_User_Guide 21 / 26 GNSS Module Series L76C EVB User Guide ⚫ The CNR of PRN 9 is 19dB/Hz. ⚫ White column means the navigation data of this satellite is not in use. ⚫ Longitude degree ⚫ Latitude degree ⚫ Altitude based on WGS84 datum ⚫ UTC time ⚫ The number of satellites being used ⚫ Speed of receiver ⚫ CPU ⚫ Trajectory 6.2. Command Sending UNICORE and PQ* Commands can be sent by uSTAR. The command input box is shown as below. NOTE '*' means under development. L76C_EVB_User_Guide 22 / 26 GNSS Module Series L76C EVB User Guide Figure 16: Command Sending via uSTAR 6.3. TTFF Testing uSTAR tool allows customers to measure the TTFF (Time To First Fix) under different testing conditions. The TTFF can be tested under cold start, warm start or hot start conditions. Click the 'Start' button to start the test and it can be stopped by clicking the 'Cancel' button. The following are the detailed configuration steps during TTFF testing: Step 1: Start 'Tool' menu, and then click 'TTFF' to enter the interface shown as below: L76C_EVB_User_Guide 23 / 26 GNSS Module Series L76C EVB User Guide Figure 17: Static TTFF Testing via uSTAR Step 2: For cold start TTFF testing Please click the dropdown list after 'Reset Mode' field to choose 'Cold Start', and then click 'Start', as shown below: Figure 18: Cold Start TTFF Testing Configuration L76C_EVB_User_Guide 24 / 26 GNSS Module Series L76C EVB User Guide For hot start TTFF testing Please click the dropdown list after 'Reset Mode' field to choose 'Hot Start', and then click 'Start', as shown below: Figure 19: Hot Start TTFF Testing Configuration Options For warm start TTFF testing Please click the dropdown list after 'Reset Mode' field to choose 'Self Define', then input command '$RESET,0,h01', and finally click 'Start', as shown below: Figure 20: Warm Start TTFF Testing Configuration Options L76C_EVB_User_Guide 25 / 26 GNSS Module Series L76C EVB User Guide 7 Appendix A Reference Table 8: Terms and Abbreviations Abbreviation CNR DI DO EVB GNSS GPS IO LED LNA PI PPS PRN SV TTFF UTC WGS84 Description Carrier-to-Noise Ratio Digital Input Digital Output Evaluation Board Global Navigation Satellite System Global Positioning System Bidirectional Light Emitting Diode Low Noise Amplifier Power Input Pulse Per Second Pseudorandom Noise Satellite Vehicle Time To First Fix Universal Time Coordinated World Geodetic System 1984 L76C_EVB_User_Guide 26 / 26

L26C EVB User Guide GNSS Module Series Rev. L26C_EVB_User_Guide_V1.0 Date: 2018-08-29 Status: Released www.quectel.com GNSS Module Series L26C EVB User Guide 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. L26C_EVB_User Guide 1 / 26 GNSS Module Series L26C EVB User Guide About the document History Revision Date 1.0 2018-08-29 Author Ward WANG Description Initial L26C_EVB_User Guide 2 / 26 GNSS Module Series L26C EVB User Guide Contents About the document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Safety Information ....................................................................................................................... 6 2 General Overview................................................................................................................................. 8 2.1. Top and Bottom Views ................................................................................................................ 8 2.2. Key Features ............................................................................................................................. 10 2.3. EVB Kit Accessories ................................................................................................................. 11 3 Interface Applications ....................................................................................................................... 12 3.1. Micro-USB Interface.................................................................................................................. 12 3.2. SD Card Interface ..................................................................................................................... 13 3.3. Antenna Interface...................................................................................................................... 13 3.4. Switches and Buttons ............................................................................................................... 14 3.5. Operation Status Indication LEDs............................................................................................. 15 3.6. Test Points................................................................................................................................. 16 4 EVB and Accessories Assembly...................................................................................................... 17 5 EVB Operation Procedures............................................................................................................... 18 5.1. Communication via USB Interface ............................................................................................ 18 5.2. Firmware Upgrade .................................................................................................................... 19 6 Usage of uSTAR ................................................................................................................................. 20 6.1. uSTAR Interface ........................................................................................................................ 20 6.1.1. COM Port and Baud Rate Setting.................................................................................. 20 6.1.2. Explanations of uSTAR Interface ................................................................................... 21 6.2. Command Sending ................................................................................................................... 22 6.3. TTFF Testing ............................................................................................................................. 23 7 Appendix A Reference....................................................................................................................... 26 L26C_EVB_User Guide 3 / 26 GNSS Module Series L26C EVB User Guide Table Index TABLE 1: INTERFACES OF L26C EVB .............................................................................................................. 9 TABLE 2: KEY FEATURES OF L26C EVB........................................................................................................ 10 TABLE 3: LIST OF ACCESSORIES ...................................................................................................................11 TABLE 4: L26C SWITCHES AND BUTTONS ................................................................................................... 14 TABLE 5: OPERATION STATUS INDICATION LEDS....................................................................................... 15 TABLE 6: PIN DESCRIPTION OF J106 ............................................................................................................ 16 TABLE 7: EXPLANATIONS OF USTAR INTERFACE....................................................................................... 21 TABLE 8: TERMS AND ABBREVIATIONS ........................................................................................................ 26 L26C_EVB_User Guide 4 / 26 GNSS Module Series L26C EVB User Guide Figure Index FIGURE 1: TOP VIEW OF L26C EVB................................................................................................................. 8 FIGURE 2: BOTTOM VIEW OF L26C EVB......................................................................................................... 9 FIGURE 3: EVB KIT ACCESSORIES ................................................................................................................11 FIGURE 4: MICRO-USB INTERFACE .............................................................................................................. 12 FIGURE 5: SD CARD INTERFACE................................................................................................................... 13 FIGURE 6: L26C EVB ANTENNA INTERFACE ................................................................................................ 13 FIGURE 7: L26C EVB SWITCHES AND BUTTONS ........................................................................................ 14 FIGURE 8: OPERATION STATUS INDICATION LEDS .................................................................................... 15 FIGURE 9: L26C EVB TEST POINTS - J106.................................................................................................... 16 FIGURE 10: L26C EVB AND ACCESSORIES ASSEMBLY .............................................................................. 17 FIGURE 11: USB PORTS.................................................................................................................................. 18 FIGURE 12: COM PORT SETTING INTERFACE OF QCOM .......................................................................... 18 FIGURE 13: FIREBIRD UPDATE FW TOOL CONFIGURATIONS FOR FIRMWARE UPGRADE ................... 19 FIGURE 14: USTAR TOOL INTERFACE .......................................................................................................... 20 FIGURE 15: COM PORT AND BAUD RATE SELECTION ............................................................................... 21 FIGURE 16: COMMAND SENDING VIA USTAR .............................................................................................. 23 FIGURE 17: STATIC TTFF TESTING VIA USTAR............................................................................................ 24 FIGURE 18: COLD START TTFF TESTING CONFIGURATION OPTIONS..................................................... 24 FIGURE 19: HOT START TTFF TESTING CONFIGURATION OPTIONS ....................................................... 25 FIGURE 20: WARM START TTFF TESTING CONFIGURATION OPTIONS.................................................... 25 L26C_EVB_User Guide 5 / 26 GNSS Module Series L26C EVB User Guide 1 Introduction This document defines and specifies the usage of L26C EVB (Evaluation Board) which is an assistant tool for engineers to develop and test Quectel L26C module. 1.1. Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating L26C module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as to prevent interference with communication systems. Consult the airline staff about the use of wireless devices on boarding the aircraft, if your device offers an Airplane Mode which must be enabled prior to boarding an aircraft. Switch off your wireless device when in hospitals, clinics or other health care facilities. These requests are designed to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid (U)SIM card. While you are in this condition and need emergent help, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. L26C_EVB_User Guide 6 / 26 GNSS Module Series L26C EVB User Guide Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency energy. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. L26C_EVB_User Guide 7 / 26 GNSS Module Series L26C EVB User Guide 2 General Overview 2.1. Top and Bottom Views The following illustrate the top and bottom views of L26C EVB. F G H BI ED C Figure 1: Top View of L26C EVB L26C_EVB_User Guide 8 / 26 GNSS Module Series L26C EVB User Guide A Figure 2: Bottom View of L26C EVB Table 1: Interfaces of L26C EVB Reference SN. Number A J303 B S301 C S102 D S201 E J201 F D105, D106, D107, D108 G J101 H U103 I J106 Description SD card interface USB ←→ SD (serial port alternation switch) RESET button POWER switch Micro USB interface Indication LEDs Antenna interface L26C module Test points L26C_EVB_User Guide 9 / 26 GNSS Module Series L26C EVB User Guide 2.2. Key Features The following table describes the detailed features of L26C EVB. Table 2: Key Features of L26C EVB Features Power Supply SD Card Interface Micro-USB Interface Signal Indication Switches and Buttons Physical Characteristics Implementation DC power supply (J201): 4.5V~5.5V, typically: 5.0V SD card for NEMA output data storage Power supply and NEMA sentence output 4 LEDs are available for signal indication POWER Switch (S201) RESET (S102) USB ←→ SD (serial port alternation switch) (S301) Size: 115mm × 80mm L26C_EVB_User Guide 10 / 26 2.3. EVB Kit Accessories GNSS Module Series L26C EVB User Guide USB Cable GNSS Antenna USB Flash Drive Bolts and Coupling Nuts EVB Figure 3: EVB Kit Accessories Table 3: List of Accessories Items EVB USB Cable GNSS Antenna USB Flash Drive Instruction Sheet Others Description Quantity L26C EVB 1 USB cable 1 Active GNSS antenna 1 GNSS_EVB_Micro-USB_Driver_CP210x 1 A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. Bolts and coupling nuts 4 for each type L26C_EVB_User Guide 11 / 26 GNSS Module Series L26C EVB User Guide 3 Interface Applications 3.1. Micro-USB Interface The main power is supplied via a Micro-USB interface. Both Micro-USB and SD card interfaces can be used for data communication, and they can be switched to each other by the alternation switch (S301). If SD card interface is used for data communication (NMEA sentence output), then both SD card and Micro-USB cables are necessary for operating the EVB. So it is strongly recommended to use the Micro-USB interface for both power supply and NEMA sentence output, during which only a USB cable is needed. Micro-USB Interface Figure 4: Micro-USB Interface L26C_EVB_User Guide 12 / 26 GNSS Module Series L26C EVB User Guide 3.2. SD Card Interface The interface supports SD card to store module output data. The memory storage capacity of supported SD card should be no more than 32GB. Figure 5: SD Card Interface 3.3. Antenna Interface The L26C module can be connected to a dedicated passive or active GNSS antenna and it has a built-in LNA to improve sensitivity. The antenna interface is used for connection with an external antenna. Antenna Figure 6: L26C EVB Antenna Interface L26C_EVB_User Guide 13 / 26 3.4. Switches and Buttons The following illustrates the switches and buttons of the EVB. S301 GNSS Module Series L26C EVB User Guide S201 S102 Figure 7: L26C EVB Switches and Buttons Table 4: L26C Switches and Buttons Part No. S102 S201 S301 Name I/O RESET DI POWER PI USB ←→ SD (serial port DI alternation switch) Description Press and then release the button, the module will be reset. Control power supply via Micro-USB interface. L26C EVB supports data communication via both Micro-USB and SD card interfaces which are controlled and switched by the S301 switch. L26C_EVB_User Guide 14 / 26 3.5. Operation Status Indication LEDs GNSS Module Series L26C EVB User Guide D108 D107 D105 D106 Figure 8: Operation Status Indication LEDs Table 5: Operation Status Indication LEDs Part Name I/O D105 TXD1 DO D106 1PPS DO D107 GEO_FENCE DO D108 JAM_IND DO Description Flash: the module is turned on successfully, and either Micro-USB or SD card interface can be used to output messages. Extinct: failed to turn on the module. Flash: successful fix. The frequency is 1Hz. Extinct: no fix. Geo-fence boundary indicator. Jamming detection indicator. L26C_EVB_User Guide 15 / 26 3.6. Test Points The following illustrates the test points of the EVB. GNSS Module Series L26C EVB User Guide 54 321 6 7 8 9 10 Figure 9: L26C EVB Test Points - J106 Table 6: Pin Description of J106 Pin No. Signal I/O 1/10 GND - 2 NC - 3 1PPS DO 4 AADET_N DI 5 NC - 6 NC - 7 RESET DI 8 TXD1 DO 9 RXD1 DI Description Ground Reserved 1 pulse per second Active antenna open circuit detection Reserved Reserved System reset Transmit data Receive data L26C_EVB_User Guide 16 / 26 GNSS Module Series L26C EVB User Guide 4 EVB and Accessories Assembly The following figure shows the assembly of L26C EVB and its accessories. Figure 10: L26C EVB and Accessories Assembly L26C_EVB_User Guide 17 / 26 GNSS Module Series L26C EVB User Guide 5 EVB Operation Procedures This chapter mainly illustrates the operation procedures of L26C EVB. 5.1. Communication via USB Interface Step 1: Connect the EVB and the PC with a USB cable through USB interface, and then switch S201 to ON state to power on the EVB. Step 2: Run the USB flash drive on PC to install the USB driver. The USB port numbers can be viewed through the PC Device Manager, shown as below. Figure 11: USB Ports Step 3: Install and then use the QCOM tool provided by Quectel to realize the communication between the L26C module and the PC. The following figure shows the COM Port Setting interface of QCOM: select the correct 'COM Port' (USB Port shown in the above figure) and set the correct 'Baudrate' (the default value: 9600bps). For more details of QCOM usage, please refer to Quectel_QCOM_User_Guide. Figure 12: COM Port Setting Interface of QCOM L26C_EVB_User Guide 18 / 26 GNSS Module Series L26C EVB User Guide 5.2. Firmware Upgrade Quectel L26C module upgrades firmware via USB interface by default. Please follow the procedures below to upgrade the firmware. Step 1: Install and open the firmware upgrade tool (Firebird Update FW Tool) on PC. Step 2: Power on the EVB according to the procedures mentioned in step 1 of Chapter 5.1. Step 3: Follow the steps below to start firmware upgrade. a) Select the COM port. b) Choose the firmware package. c) Click the 'Baud rate' dropdown list and select the '9600'. d) Click the 'START' button to upgrade the firmware. b a c d Figure 13: Firebird Update FW Tool Configurations for Firmware Upgrade L26C_EVB_User Guide 19 / 26 GNSS Module Series L26C EVB User Guide 6 Usage of uSTAR 6.1. uSTAR Interface 6.1.1. COM Port and Baud Rate Setting The uSTAR tool can help users to view the status of GNSS receiver conveniently. After EVB accessories are assembled, turn on the module and start up the uSTAR. After the tool is opened, the following interface will be shown: Figure 14: uSTAR Tool Interface L26C_EVB_User Guide 20 / 26 GNSS Module Series L26C EVB User Guide After that, select a correct COM port and baud rate (L26C module supports 9600bps by default), then click the button 'OK'. Figure 15: COM Port and Baud Rate Selection 6.1.2. Explanations of uSTAR Interface From the uSTAR interface, users can view CNR message, time, position, speed, precision, and so on. Explanations are listed in the table below. Table 7: Explanations of uSTAR Interface Icon Explanation ⚫ SV with PRN 17 and 165. ⚫ If the position of SV is near to the centre of the Sky View, the elevation angle of SV is close to 90°. ⚫ Green or dark green means this satellite is in tracking. ⚫ Fuchsia means this satellite is not in tracking. ⚫ The CNR of PRN 30 is 52dB/Hz. ⚫ Green column means the navigation data of the GPS satellite is in use. ⚫ Orange column means the navigation data of the BeiDou satellite is in use. L26C_EVB_User Guide 21 / 26 GNSS Module Series L26C EVB User Guide ⚫ The CNR of PRN 9 is 19dB/Hz. ⚫ White column means the navigation data of this satellite is not in use. ⚫ Longitude degree ⚫ Latitude degree ⚫ Altitude based on WGS84 datum ⚫ UTC time ⚫ The number of satellites being used ⚫ Speed of receiver ⚫ CPU ⚫ Trajectory 6.2. Command Sending UNICORE and PQ* Commands can be sent by uSTAR. The command input box is shown as below. NOTE '*' means under development. L26C_EVB_User Guide 22 / 26 GNSS Module Series L26C EVB User Guide Figure 16: Command Sending via uSTAR 6.3. TTFF Testing uSTAR tool allows customers to measure the TTFF (Time To First Fix) under different testing conditions. The TTFF can be tested under cold start, warm start or hot start conditions. Click the 'Start' button to start the test and it can be stopped by clicking the 'Cancel' button. The following are the detailed configuration steps during TTFF testing: Step 1: Start 'Tool' menu, and then click 'TTFF' to enter the interface shown as below: L26C_EVB_User Guide 23 / 26 GNSS Module Series L26C EVB User Guide Figure 17: Static TTFF Testing via uSTAR Step 2: For cold start TTFF testing Please click the dropdown list after 'Reset Mode' field to choose 'Cold Start', and then click 'Start', as shown below: Figure 18: Cold Start TTFF Testing Configuration Options L26C_EVB_User Guide 24 / 26 GNSS Module Series L26C EVB User Guide For hot start TTFF testing Please click the dropdown list after 'Reset Mode' field to choose 'Hot Start', and then click 'Start', as shown below: Figure 19: Hot Start TTFF Testing Configuration Options For warm start TTFF testing Please click the dropdown list after 'Reset Mode' field to choose 'Self Define', then input command '$RESET,0,h01', and finally click 'Start', as shown below: Figure 20: Warm Start TTFF Testing Configuration Options L26C_EVB_User Guide 25 / 26 GNSS Module Series L26C EVB User Guide 7 Appendix A Reference Table 8: Terms and Abbreviations Abbreviation CNR DI DO EVB GNSS GPS IO LED LNA PI PO PPS PRN SV UTC WGS84 Description Carrier-to-Noise Ratio Digital Input Digital Output Evaluation Board Global Navigation Satellite System Global Positioning System Bidirectional Light Emitting Diode Low Noise Amplifier Power Input Power Output Pulse Per Second Pseudorandom Noise Satellite Vehicle Universal Time Coordinated World Geodetic System 1984 L26C_EVB_User Guide 26 / 26

GSM EVB User Guide GSM/GPRS/UMTS/HSPA/NB-IoT Module Series Rev. GSM_EVB_User_Guide_V3.4 Date: 2017-03-03 www.quectel.com GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2017. All rights reserved. GSM_EVB_User_Guide Confidential / Released 1 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide About the Document History Revision 1.0 1.1 2.0 3.0 3.1 3.2 3.3 3.4 Date 2009-06-17 tel 2009-11-12 uec tial 2011-04-15 2013-05-03 Q n 2013-09-23 e 2014-01-14 fid 2015-05-20 Con 2017-03-03 Author Tracy ZHANG Yong AN Roy CHEN Tony WU Tony WU Vivian WANG Tony WU Bryant CHEN Description Initial 1. Modified Figure 5, 6, 7 and 10. 2. Added some contents on how to better operate module for customers when module is set to autobauding by default in Chapter 5.2. Added Introduction to UART in Section 5.6. Added SD card connector instead of LCD display connector. Optimized introduction description. Added introduction to SD interface. 1. Changed module name from 'M10' to 'GSM'. 2. Added applicable modules. 1. Added information about BC95 module. 2. Updated EVB kit accessories in Figure 3. 3. Updated description of firmware upgrade in Chapter 5.3. GSM_EVB_User_Guide Confidential / Released 2 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Safety Information ................................................................................................................... 6 2 General Overview................................................................................................................................. 8 2.1. GSM EVB Top and Bottom View ............................................................................................. 8 3 4 5 2.2. EVB Kit Accessories .............................................................................................................. 10 Interface Application ......................................................................................................................... 12 3.1. Power Interface ..................................................................................................................... 12 3.2. Audio Interfaces..................................................................................................................... 13 l 3.3. (U)SIM Card Interface ........................................................................................................... 14 te 3.4. Antenna Interface .................................................................................................................. 15 3.5. SD Card Interface.................................................................................................................. 16 c l 3.6. Main Port and Debug Port..................................................................................................... 17 3.7. UART3 Port ........................................................................................................................... 18 ue tia 3.8. Switches and Buttons............................................................................................................ 19 3.9. Status Indication LEDs .......................................................................................................... 20 3.10. Test Points ............................................................................................................................. 21 Q n 3.10.1. CON103 ......................................................................................................................... 21 3.10.2. CON101 ......................................................................................................................... 22 e 3.10.3. CON102 ......................................................................................................................... 23 fid 3.10.4. CON401 ......................................................................................................................... 24 3.10.5. CON501 ......................................................................................................................... 25 EVB Kit Accessories Assembly ....................................................................................................... 26 n Operation Procedures Illustration.................................................................................................... 27 o 5.1. Power on the Module ............................................................................................................ 27 C 5.2. Communication via UART Interface ...................................................................................... 27 5.3. Firmware Upgrade................................................................................................................. 28 5.4. Power off the Module............................................................................................................. 28 5.5. Emergency Off....................................................................................................................... 29 5.6. UART3 Port ........................................................................................................................... 29 5.7. Supplementary Information ................................................................................................... 29 6 60-pin Assignment ............................................................................................................................. 31 7 Appendix A Reference....................................................................................................................... 34 GSM_EVB_User_Guide Confidential / Released 3 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Table Index TABLE 1: ACCESSORIES LIST ........................................................................................................................ 10 TABLE 2: PIN DESCRIPTION OF POWER INTERFACE................................................................................. 12 TABLE 3: PIN DESCRIPTION OF AUDIO CHANNEL 1 ................................................................................... 13 TABLE 4: PIN DESCRIPTION OF AUDIO CHANNEL 2 ................................................................................... 13 TABLE 5: PIN DESCRIPTION OF (U)SIM CARD INTERFACE ........................................................................ 14 TABLE 6: PIN DESCRIPTION OF SD CARD INTERFACE .............................................................................. 16 TABLE 7: PIN DESCRIPTION OF MAIN PORT ................................................................................................ 17 TABLE 8: PIN DESCRIPTION OF DEBUG PORT ............................................................................................ 17 TABLE 9: PINS OF UART3 PORT .................................................................................................................... 18 TABLE 10: DESCRIPTION OF SWITCHES AND BUTTONS ........................................................................... 19 TABLE 11: DESCRIPTION OF STATUS INDICATION LEDS ........................................................................... 20 TABLE 12: PIN DESCRIPTION OF CON103 .................................................................................................... 21 TABLE 13: PINS DESCRIPTION OF CON101 ................................................................................................. 22 l TABLE 14: PINS DESCRIPTION OF CON102 ................................................................................................. 23 TABLE 15: PINS DESCRIPTION OF CON401 ................................................................................................. 24 te TABLE 16: PINS DESCRIPTION OF CON501 ................................................................................................. 25 TABLE 17: PIN DEFINITION OF THE 60-PIN DIP CONNECTOR ................................................................... 32 CQouneficdential TABLE 18: RELATED DOCUMENTS................................................................................................................ 34 GSM_EVB_User_Guide Confidential / Released 4 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Figure Index FIGURE 1: GSM EVB TOP VIEW ....................................................................................................................... 8 FIGURE 2: GSM EVB BOTTOM VIEW ............................................................................................................... 9 FIGURE 3: EVB KIT ACCESSORIES ............................................................................................................... 10 FIGURE 4: POWER INTERFACE ..................................................................................................................... 12 FIGURE 5: AUDIO INTERFACES ..................................................................................................................... 13 FIGURE 6: (U)SIM CARD INTERFACE ............................................................................................................ 14 FIGURE 7: ANTENNA INTERFACE .................................................................................................................. 15 FIGURE 8: SD CARD INTERFACE................................................................................................................... 16 FIGURE 9: MAIN PORT AND DEBUG PORT ................................................................................................... 17 FIGURE 10: UART3 PORT ............................................................................................................................... 18 FIGURE 11: SWITCHES AND BUTTONS......................................................................................................... 19 FIGURE 12: STATUS INDICATION LEDS ........................................................................................................ 20 FIGURE 13: TEST POINTS CON103................................................................................................................ 21 l FIGURE 14: CON101 POINTS.......................................................................................................................... 22 FIGURE 15: CON102 POINTS.......................................................................................................................... 23 te FIGURE 16: CON401 POINTS.......................................................................................................................... 24 FIGURE 17: CON501 POINTS.......................................................................................................................... 25 c l FIGURE 18: GSM EVB KIT AND ACCESSORIES............................................................................................ 26 ue tia FIGURE 19: SWITCHES STATE FOR FIRMWARE UPGRADE....................................................................... 28 FIGURE 20: CHANGE THE POWER SUPPLY................................................................................................. 29 FIGURE 21: CIRCUIT FOR PIN CONNECTIONS ............................................................................................ 30 CQonfiden FIGURE 22: DIP CONNECTOR OF GSM EVB ................................................................................................ 31 GSM_EVB_User_Guide Confidential / Released 5 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 1 Introduction This document describes how to use the GSM Evaluation Board (EVB), which is an assistant tool for engineers to develop and test Quectel GSM, UMTS and NB-IoT modules. This document is applicable to Quectel GSM modules, UC15 module and BC95 module. 1.1. Safety Information l The following safety precautions must be observed during all phases of the operation, such as usage, te service or repair of any cellular terminal or mobile incorporating GSM, UMTS and NB-IoT modules. Manufacturers of the cellular terminal should send the following safety information to users and operating c l personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for the customer’s failure to comply with these precautions. ue tia Full attention must be given to driving at all times in order to reduce the risk of an Q n accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations e restricting the use of wireless devices while driving. fid Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as to prevent interference with communication systems. Consult the airline staff about n the use of wireless devices on boarding the aircraft, if your device offers an oAirplane Mode which must be enabled prior to boarding an aircraft. CSwitch off your wireless device when in hospitals, clinics or other health care facilities. These requests are desinged to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid (U)SIM card. While you are in this condition and need emergent help, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. GSM_EVB_User_Guide Confidential / Released 6 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency energy. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. CQouneficdteenl tial GSM_EVB_User_Guide Confidential / Released 7 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 2 General Overview Quectel supplies GSM EVB for designers to develop applications based on Quectel GSM, UMTS and NB-IoT modules. This EVB can test basic functionalities of these modules. CQouneficdteenl tial 2.1. GSM EVB Top and Bottom View Figure 1: GSM EVB Top View NOTES 1. Some interfaces and test pins are reserved only for engineers to debug some functions which are not used for customers. 2. Some functions are only supported in certain software versions. GSM_EVB_User_Guide Confidential / Released 8 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide tel Figure 2: GSM EVB Bottom View uec tial A: Debugport B: Main port C: UART3 port Q n D: Adapter interface E: POWER switch e F: VCHG switch (Not used) fid G: D/L switch H: PWKEY button I: EMERG_OFF button J: Loudspeaker interface (Not used) n K: Earphone interface o L: Handset interface of audio channel 2 M: Handset interface of audio channel 1 C N: Test points O: Status indication LEDs (D203&D204 Not used) P: 60-pin TE-A interface Q: Battery interface (Not used) R: Fixture hole for RF cable connector S: (U)SIM card interface T: Fixture holes for EVB poles U: Screw holes for fixing the module V: SD card interface GSM_EVB_User_Guide Confidential / Released 9 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 2.2. EVB Kit Accessories All accessories of the GSM EVB kit are listed as below. Queficdteenl tial Figure3:EVBKitAccessories n Table 1: Accessories List Co Items Description Quantity USB to UART converter cable 1 Cables USB cable 1 RF cable 1 Antenna Antenna 1 Adapter 5V DC adapter 1 GSM_EVB_User_Guide Confidential / Released 10 / 34 Audio Disk Instruction Sheet Other GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Earphone 1 Disk involving related documents and drivers 1 A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. Bolts and nuts for fixing EVB 1 CQouneficdteenl tial GSM_EVB_User_Guide Confidential / Released 11 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 3 Interface Application 3.1. Power Interface CQouneficdteenl tial Figure4:PowerInterface Table 2: Pin Description of Power Interface Pin No. Signal I/O Description 1 Adapter input PI 5V/2A DC source input 2 GND Ground GSM_EVB_User_Guide Confidential / Released 12 / 34 3.2. Audio Interfaces GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide tel Figure 5: Audio Interfaces uec tial Table 3: Pin Description of Audio Channel 1 Q n Interface fide AIN1/AOUT1 Signal MIC1N SPK1N SPK1P MIC1P Pin No. 1 2 3 4 Description Channel 1 for negative microphone input. Channel 1 for negative receiver output. Channel 1 positive receiver output. Channel 1 positive microphone input. Con Table 4: Pin Description of Audio Channel 2 Interface Signal Pin No. Description MIC2N 1 Channel 2 for negative microphone input. AGND 2 AIN2/AOUT2 SPK2P 3 AGND of audio circuits. Channel 2 for positive receiver output. MIC2P 4 Channel 2 for positive microphone input. GSM_EVB_User_Guide Confidential / Released 13 / 34 3.3. (U)SIM Card Interface GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide uectel tial Figure 6: (U)SIM Card Interface Q en Table 5: Pin Description of (U)SIM Card Interface fid Pin No. Signal I/O 1 GND n 2 VPP o 3 SIM_DATA IO C 4 SIM_CLK DO Description Ground Not connected (U)SIM card data input and output (U)SIM card clock 5 SIM_RST DO (U)SIM card reset 6 SIM_VDD PO Power supply for (U)SIM card NOTE Only USIM card can be identified on BC95 module. GSM_EVB_User_Guide Confidential / Released 14 / 34 3.4. Antenna Interface GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide CQouneficdteenl tial Figure7:AntennaInterface GSM_EVB_User_Guide Confidential / Released 15 / 34 3.5. SD Card Interface GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Quecteenl tial Figure8:SDCardInterface fid Table 6: Pin Description of SD Card Interface n Pin No. o 1 C 2 Name SD_CMD SD_CLK I/O Description IO SD card command signal DO Clock signal of SD card output 3 SD_DATA IO Data output and input signal of SD card 4 SD_VDD PO Power supply for SD card 5 SD_VSS Ground The GSM EVB provides Micro SD card interface, but only supports 1-bit SD mode. For more details, please refer to corresponding hardware designs. GSM_EVB_User_Guide Confidential / Released 16 / 34 3.6. Main Port and Debug Port GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Figure 9: Main Port and Debug Port l Table 7: Pin Description of Main Port te Pin No. Signal I/O c l 1_1 DCD DO ue tia 1_2 TXD DO Q n 1_3 RXD DI e 1_4 DTR DI fid 1_5 GND 1_7 RTS DI n 1_8 CTS DO Co 1_9 RI DO Description Data carrier detection Transmit data Receive data Data terminal ready Ground Request to send Clear to send Ring indicator Table 8: Pin Description of Debug Port Pin No. Signal I/O 2_2 DBG_TXD DO 2_3 DBG_RXD DI 2_5 GND Description Transmit data Receive data Ground GSM_EVB_User_Guide Confidential / Released 17 / 34 3.7. UART3 Port GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Quecteenl tial Table9:PinsofUART3Port fid Pin No. 3_2 n 3_3 Co 3_5 Signal UART3_TXD UART3_RXD GND Figure 10: UART3 Port I/O Description DO Transmit data DI Receive data Ground GSM_EVB_User_Guide Confidential / Released 18 / 34 3.8. Switches and Buttons GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Figure 11: Switches and Buttons l Table 10: Description of Switches and Buttons te Part No. c l S202 ue tia S203 Q n S201 e S204 Confid S101 Pin Name I/O POWER DI VCHG DI D/L DI PWRKEY DI EMERG_OFF DI Description Control power supply via adaptor. Control charging if the module has charging function. Switch to 'ON' to download firmware for GSM and UC15 modules. Used to turn on/off GSM and UC15 modules. BC95 module does not have this function. Emergency button for shutting down the module. On BC95 module, it is used as RESET function to reset the module. GSM_EVB_User_Guide Confidential / Released 19 / 34 3.9. Status Indication LEDs GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Figure 12: Status Indication LEDs Table 11: Description of Status Indication LEDs l Part No. Part Name I/O te D503 POWER DO uec tial D502 D504 CQonfiden D101 NETLIGHT DO LIGHT_MOS DO STATUS DO Description Indicates the power supply for the module is ready. Bright: VBAT ON Extinct: VBAT OFF Indicates the network status of the module. This function is under development for BC95 module. Specially used for LIGHT_MOS demo. Indicates the operating status of the module. GSM_EVB_User_Guide Confidential / Released 20 / 34 3.10. Test Points 3.10.1. CON103 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide tel Figure 13: Test Points CON103 uec tial Table 12: Pin Description of CON103 Pin No. Signal I/O Q n 1 DBG_RXD DI e 2 GND fid 3 VBAT PI 4 STANDBY n 5 DBG_TXD DO Co 6 GND Description Receive data Ground Power supply for the module Not used Transmit data Ground 7 VBAT PI Power supply for the module GSM_EVB_User_Guide Confidential / Released 21 / 34 3.10.2. CON101 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide l Figure 14: CON101 Points cte l Table 13: Pins Description of CON101 ue tia PinNo. Signal I/O 1 RES5 Q n 2 ADC1 e 3 NETLIGHT DO fid 4 DISP_A0 n 5 LIGHT_MOS o 6 SDDATA IO C 7 SDCLK DO Description Not used Not used NETLIGHT driving output Reserved Reserved SD card interface 8 SDCMD IO 9 GPIO0 IO General purpose input/output port 10 DISPRST Reserved GSM_EVB_User_Guide Confidential / Released 22 / 34 3.10.3. CON102 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Figure 15: CON102 Points l Table 14: Pins Description of CON102 te Pin No. Signal I/O c l 1 ADC0 AI ue tia 2 GPIO101_KBC5 IO Q n 3 KBR1 DO e 4 KBC0 DI fid 5 KBC2 DI 7 KBR0 DO n 8 KBR2 DO o 9 KBC1 DI C 6 VRTC IO Description Analog to digital converter Keyboard interface RTC supply 10 SIM_PRESENCE DI (U)SIM card detection GSM_EVB_User_Guide Confidential / Released 23 / 34 3.10.4. CON401 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Figure 16: CON401 Points tel Table 15: Pins Description of CON401 c l PinNo. Signal I/O ue tia 1 RXD DI 2 RI DO Q n 3 GND e 4 TXD3 DO fid 5 RXD3 DI 6 TXD DO n 7 DCD DO Co 8 CTS DO Description Receive data Ring indicator Ground UART3 transmit data UART3 receive data Transmit data Data carrier detection Clear to send 9 DTR DI Data terminal ready 10 RTS DI Request to send GSM_EVB_User_Guide Confidential / Released 24 / 34 3.10.5. CON501 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Figure 17: CON501 Points tel Table 16: Pins Description of CON501 c l PinNo. Signal I/O ue tia 1 VCHG PI 2 RES1 Q n 3 RES2 e 4 RES3 fid 5 RES4 n 6 STATUS DO o 7 MCU_CL C 8 PWR_EN DO Description Voltage input for the charging circuit Reserved Operating status of the module Reserved Power enable control 9 PWRKEY 10 EMERGE Turn on/off the module DI The BC95 module does not have this function. Shut down the module in emergency. DI On BC95 module, it is used as RESET function to reset the module. GSM_EVB_User_Guide Confidential / Released 25 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 4 EVB Kit Accessories Assembly CQouneficdteenl tial Figure 18: GSM EVB Kit and Accessories GSM_EVB_User_Guide Confidential / Released 26 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 5 Operation Procedures Illustration 5.1. Power on the Module (1) Connect the TE-A to the 60-pin connector on EVB. (2) Connect EVB to the 5V power adapter. (3) Switch S202 to ON state, S203 to OFF state, and S201 to OFF state. The D503 LED on the EVB will be light. And BC95 module will be powered on (BC95 module does not have PWRKEY pin). l (4) Press the PWRKEY for about 2 seconds, the GSM and UC15 modules will be powered on, D101 LED te will be light. c l (5) The D502 LED will flicker at a certain frequency. The working status of the module can be judged by the LED status. Please refer to corresponding hardware designs for detailed network status ue tia indication. Q n 5.2. Communication via UART Interface fide (1) Connect the main port of EVB to PC’s USB port with the USB to UART converter cable. (2) Open the HyperTerminal (AT command window) on PC. The location of the HyperTerminal in Windows XP system is: Start→Program→Accessory→Communication→HyperTerminal. Set n appropriate baud rate (such as 115200bps) and COM number which can be checked by the Device o Manager on PC. C (3) Connect an antenna to TE-A with an RF cable. (4) Insert (U)SIM card (only USIM card for BC95 module) into the (U)SIM card connector. (5) Insert earphone or handset into audio interface. (6) Power on the module according to the procedures mentioned in Chapter 5.1. (7) Wait for 2~3 seconds, and input 'AT' or 'at' string once or more until 'OK' is received from the module in the HyperTerminal. The module is set to autobauding mode in default configuration. This operation is to synchronize the baud rate between the computer and the module. GSM_EVB_User_Guide Confidential / Released 27 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide (8) Input AT command and the module will execute its corresponding function. For instance, when inputting 'ATD112;', an emergency call will be established. 5.3. Firmware Upgrade For GSM and UC15 modules, start QFlash tool on PC to upgrade firmware, and then switch S201 and S202 on the EVB to ON state as shown in the figure below, the upgrading process will be started. For more details, please refer to document [4]. Quecteenl tial Figure 19: Switches State for Firmware Upgrade fid For BC95 module, run Universal Code Loader or Code Loader tool to upgrade firmware, and then switch S202 on the EVB to ON state, the upgrading process will be started. For more details, please refer to n document [5] and [6]. Co 5.4. Power off the Module Press the PWRKEY button for less than 1 second, the GSM and UMTS modules will be powered off. And switch S202 to OFF state, the BC95 module will be turned off. GSM_EVB_User_Guide Confidential / Released 28 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 5.5. Emergency Off Press the EMERG_OFF button for more than 0.1 second, the module will be shut down immediately. And the module can be restarted by pressing the PWRKEY button. NOTE This operation is harmful to the whole module system and should only be done in emergency, such as failing to turn off the module through the PWRKEY button. 5.6. UART3 Port l The module provides two UART ports for achieving dual UART. One is UART1 which is the main UART port; the other is UART 3 which is the assisted UART port. AT+QEAUART=1 command is used to enable te UART3 port. uec tial 5.7. Supplementary Information Q n If the module has been welded on your PCB, you can follow the steps below to connect the module with the EVB. After that, UART communication is ready. Confide 1. Remove R102 resistance to the place of the R224 resistance to change the power supply. Figure 20: Change the Power Supply GSM_EVB_User_Guide Confidential / Released 29 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Pull out the module pins of TXD, RXD, VBAT, and GND to the EVB pins of TXD, RXD, VBAT, and GND with 4 wires. Make the power key and GND to short-circuit for 1s and cut down the connection to run the module. CQouneficdteenl tial Figure21:CircuitforPinConnections GSM_EVB_User_Guide Confidential / Released 30 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 6 60-pin Assignment CQouneficdteenl tial Figure 22: DIP Connector of GSM EVB GSM_EVB_User_Guide Confidential / Released 31 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide Table 17: Pin Definition of the 60-pin DIP Connector Pin No. 1 3 5 7 9 11 13 15 17 19 21 23 25 27 29 31 33 35 37 39 41 43 45 47 49 51 Pin Name I/O Pin No. Pin Name I/O VBAT PI 2 GND VBAT PI 4 GND VBAT PI 6 GND VBAT PI 8 GND VBAT PI 10 GND VCHG PI 12 ADC1 AI 14 VDD_EXT PO 16 l PWRKEY DI 18 te STATUS DO 20 c l GPIO0 IO 22 ue tia BUZZER Reserved 24 SIM_VDD PO 26 Q n SIM_RST DO 28 SIM_DATA IO 30 e SIM_CLK DO 32 fid SIM_PRESENCE DI 34 GPIO1_KBC5 IO 36 n DCD DO 38 Co DTR DI 40 ADC0 AI VRTC IO NETLIGHT DO KBR0 DO KBR1 DO KBR2 DO TXD3 DO RXD3 DI KBC0 DI KBC1 DI KBC2 DI LIGHT_MOS DO EMERG_OFF DI SD_CMD IO SD_CLK DO RXD DI 42 SD_DATA IO TXD DO 44 DISP_A0 Reserved RTS DI 46 DISP_RST Reserved CTS DO 48 DBG_RXD DI RI DO 50 DBG_TXD DO AGND 52 AGND GSM_EVB_User_Guide Confidential / Released 32 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 53 SPK1P AO 54 55 SPK1N AO 56 57 SPK2P AO 58 59 AGND 60 MIC1P AI MIC1N AI MIC2P AI MIC2N AI CQouneficdteenl tial GSM_EVB_User_Guide Confidential / Released 33 / 34 GSM/GPRS/UMTS/HSPA/NB-IoT Module Series GSM EVB User Guide 7 Appendix A Reference Table 18: Related Documents SN Document Name Remark AT commands manual for Quectel GSM, UC15 and [1] [2] [3] [4] [5] [6] Quectel_xx_AT_Commands_Manual Quectel_GSM_UART_Application_Note l Quectel_xx_Hareware_Design te Quectel_QFlash_User_Guide c l Quectel_BC95_Firmware_Upgrade_via_ Universal_Code_Loader_User_Guide ue tia Quectel_BC95_Firmware_Upgrade_via_ CQonfiden Code_Loader_User_Guide BC95 modules The document of serial port application note Hardware designs for Quectel GSM, UC15 and BC95 modules Firmware upgrade user guide for GSM and UC15 modules BC95 firmware upgrade via Universal Code Loader user guide BC95 firmware upgrade via Code Loader user guide GSM_EVB_User_Guide Confidential / Released 34 / 34

UMTS&LTE EVB User Guide UMTS/HSPA/LTE Module Series Rev. UMTS&LTE_EVB_User_Guide_V2.1 Date: 2017-12-27 Status: Released www.quectel.com UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 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. 2017. All rights reserved. UMTS&LTE_EVB_User_Guide 1 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide About the Document History Revision 1.0 1.1 2.0 2.1 Date 2015-03-03 2015-06-10 2017-01-12 2017-12-27 Author Huik LI Radom XIANG Allen WANG Eden LIU/ Lyndon LIU Description Initial Deleted +5V adapter parts in EVB accessories 1. Added applicable modules of the EVB: EC25, EC21, EC20 R2.0, FC20 series and EG95 2. Added the description of UMTS&LTE TE-A interface (Chapter 4.2) 3. Added the description of Wi-Fi & Ethernet TE-A interface (Chapter 4.3) 4. Added the description of digital audio codec board interface (Chapter 4.5.1) 5. Added the description of SD card interface (Chapter 4.7) 6. Added a Wi-Fi antenna and two codec boards into EVB accessories 7. Added procedures for power on/off Wi-Fi modules in Chapter 5 Added the following applicable modules of the EVB: AG35, AF20, BG96, EG91 and EC20 R2.1. UMTS&LTE_EVB_User_Guide 2 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 1.1. Safety Information ................................................................................................................... 7 2 General Overview................................................................................................................................. 9 2.1. Applicable Modules ................................................................................................................. 9 2.2. Key Features ......................................................................................................................... 10 2.3. Interface Overview................................................................................................................. 11 2.4. Top View of EVB .................................................................................................................... 13 2.5. EVB Kit Accessories .............................................................................................................. 14 3 EVB Kit Accessories Assembly ....................................................................................................... 16 4 Interface Applications ....................................................................................................................... 17 4.1. Power Interface (J201/J801) ................................................................................................. 17 4.2. UMTS&LTE TE-A Interface ................................................................................................... 18 4.3. Wi-Fi & Ethernet TE-A Interface ............................................................................................ 19 4.4. USB Interface (J801) ............................................................................................................. 21 4.5. Audio Interfaces..................................................................................................................... 22 4.5.1. Digital Audio Codec Board Interface (J501)................................................................... 22 4.5.2. Analog Audio Interfaces (J603/J601/J602) .................................................................... 23 4.5.2.1. Loudspeaker Interface (J603) .............................................................................. 23 4.5.2.2. Earphone Interface (J601).................................................................................... 24 4.5.2.3. Handset Interface (J602) ...................................................................................... 25 4.6. (U)SIM Interface (J702)......................................................................................................... 27 4.7. SD Card Interface (J701) ...................................................................................................... 29 4.8. UART Interfaces (J401/J402)................................................................................................ 30 4.9. Switches and Buttons............................................................................................................ 32 4.10. Status Indication LEDs .......................................................................................................... 33 4.11. Test Points ............................................................................................................................. 34 5 Operation Procedures Illustration.................................................................................................... 38 5.1. Power on UMTS&LTE and Wi-Fi Modules............................................................................ 38 5.2. Communication Via USB or UART Interface......................................................................... 39 5.2.1. Communication via USB Interface ................................................................................. 39 5.2.2. Communication via UART Interface............................................................................... 40 5.3. Firmware Upgrade................................................................................................................. 41 5.4. Reset UMTS&LTE Modules .................................................................................................. 41 5.5. Power off UMTS&LTE and Wi-Fi Modules ............................................................................ 42 UMTS&LTE_EVB_User_Guide 3 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 6 Appendix A References..................................................................................................................... 43 UMTS&LTE_EVB_User_Guide 4 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Table Index TABLE 1: KEY FEATURES ............................................................................................................................... 10 TABLE 2: INTERFACES OF UMTS&LTE EVB...................................................................................................11 TABLE 3: ACCESSORIES LIST ........................................................................................................................ 14 TABLE 4: PIN DEFINITION OF J801 ................................................................................................................ 21 TABLE 5: PIN DEFINITION OF J601 ................................................................................................................ 25 TABLE 6: PIN DEFINITION OF J602 ................................................................................................................ 27 TABLE 7: PIN DEFINITION OF J702 ................................................................................................................ 28 TABLE 8: PIN DEFINITION OF J401 ................................................................................................................ 31 TABLE 9: PIN DEFINITION OF J402 ................................................................................................................ 31 TABLE 10: DESCRIPTION OF SWITCHES AND BUTTONS ........................................................................... 32 TABLE 11: DESCRIPTION OF STATUS INDICATION LEDS ........................................................................... 33 TABLE 12: PIN DEFINITION OF J803, J804, J805 AND J806 ......................................................................... 35 TABLE 13: INDICATION OF D206 AND D208 .................................................................................................. 39 TABLE 14: RELATED DOCUMENTS ................................................................................................................ 43 TABLE 15: TERMS AND ABBREVIATIONS ...................................................................................................... 43 UMTS&LTE_EVB_User_Guide 5 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Figure Index FIGURE 1: UMTS&LTE EVB INTERFACE OVERVIEW (UNIT: MM).................................................................11 FIGURE 2: UMTS&LTE EVB TOP VIEW .......................................................................................................... 13 FIGURE 3: EVB KIT ACCESSORIES ............................................................................................................... 14 FIGURE 4: UMTS&LTE EVB KIT ASSEMBLY .................................................................................................. 16 FIGURE 5: POWER SUPPLY FOR UMTS&LTE EVB....................................................................................... 17 FIGURE 6: POWER INTERFACES................................................................................................................... 18 FIGURE 7: POWER PLUG DESIGN................................................................................................................. 18 FIGURE 8: CONNECTION BETWEEN UMTS&LTE TE-A AND EVB ............................................................... 19 FIGURE 9: SIMPLIFIED FC20-TE-A/AF20-TE-A INTERFACE SCHEMATIC .................................................. 20 FIGURE 10: CONNECTION BETWEEN FC20-TE-A AND EVB ....................................................................... 20 FIGURE 11: REFERENCE CIRCUIT DESIGN FOR USB DEVICE INTERFACE............................................. 21 FIGURE 12: REFERENCE DESIGN FOR CONNECTION BETWEEN CODEC BOARD AND EVB ............... 22 FIGURE 13: CONNECTION BETWEEN CODEC BOARD AND EVB .............................................................. 23 FIGURE 14: REFERENCE CIRCUIT DESIGN FOR LOUDSPEAKER INTERFACE J603 .............................. 23 FIGURE 15: REFERENCE CIRCUIT DESIGN FOR EARPHONE INTERFACE J601 ..................................... 24 FIGURE 16: PIN ASSIGNMENT OF J601......................................................................................................... 24 FIGURE 17: SKETCH OF AUDIO PLUG .......................................................................................................... 25 FIGURE 18: REFERENCE CIRCUIT DESIGN FOR HANDSET INTERFACE J602 ........................................ 26 FIGURE 19: PIN ASSIGNMENT OF J602......................................................................................................... 26 FIGURE 20: SIMPLIFIED INTERFACE SCHEMATIC FOR (U)SIM CARD CONNECTOR J702 ..................... 27 FIGURE 21: PIN ASSIGNMENT OF J702......................................................................................................... 28 FIGURE 22: SIMPLIFIED INTERFACE SCHEMATIC FOR SD CARD INTERFACE J701............................... 29 FIGURE 23: PIN ASSIGNMENTS OF J701 ...................................................................................................... 29 FIGURE 24: UART BLOCK DIAGRAM ............................................................................................................. 30 FIGURE 25: PIN ASSIGNMENT OF J401......................................................................................................... 30 FIGURE 26: PIN ASSIGNMENT OF J402......................................................................................................... 31 FIGURE 27: S901 SWITCH .............................................................................................................................. 32 FIGURE 28: S201 SWITCH AND S301/S302/S303 BUTTONS ....................................................................... 32 FIGURE 29: STATUS INDICATION LEDS ........................................................................................................ 33 FIGURE 30: TEST POINTS J803, J805 AND J806........................................................................................... 34 FIGURE 31: TEST POINT J804 ........................................................................................................................ 35 FIGURE 32: USB PORTS ................................................................................................................................. 39 FIGURE 33: COM PORT SETTING FIELD ON QCOM (USB AT PORT CONNECTION) ................................ 40 FIGURE 34: USB SERIAL PORT ...................................................................................................................... 40 FIGURE 35: COM PORT SETTING FIELD ON QCOM (USB SERIAL PORT CONNECTION) ....................... 40 FIGURE 36: CONFIGURATIONS FOR FIRMWARE UPGRADE ..................................................................... 41 UMTS&LTE_EVB_User_Guide 6 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 1 Introduction This document describes how to use the evaluation board of UMTS&LTE modules and Wi-Fi modules. It is an assistant tool for engineers to develop and test Quectel UMTS, LTE and Wi-Fi modules. 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating UMTS&LTE and Wi-Fi modules. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for the customer’s failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as to prevent interference with communication systems. Consult the airline staff about the use of wireless devices on boarding the aircraft, if your device offers an Airplane Mode which must be enabled prior to boarding an aircraft. Switch off your wireless device when in hospitals, clinics or other health care facilities. These requests are designed to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid USIM/SIM card. While you are in this condition and need emergent help, please remember using emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. UMTS&LTE_EVB_User_Guide 7 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency energy. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. UMTS&LTE_EVB_User_Guide 8 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 2 General Overview Quectel supplies UMTS&LTE EVB for designers to develop applications based on Quectel UMTS&LTE modules and Wi-Fi modules. This EVB can test basic functionalities of these modules. 2.1. Applicable Modules UMTS&LTE EVB is applicable to the following module models. UMTS&LTE modules  UC20  UGxx 1)  EC2x 2)  EG9x 3)  AG35  BG96 Wi-Fi Modules  FC20 series 4)  AF20 NOTES 1. 1) UGxx contains UG95 and UG96. 2. 2) EC2x contains EC25, EC21, EC20, EC20 R2.0 and EC20 R2.1. 3. 3) EG9x contains EG91 and EG95. 4. 4) FC20 series (hereinafter FC20 simply) includes both FC20 and FC20-N. UMTS&LTE_EVB_User_Guide 9 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 2.2. Key Features The following table describes the detailed features of UMTS&LTE EVB. Table 1: Key Features Features Power Supply UMTS&LTE TE-A Interface Wi-Fi & Ethernet TE-A Interface SD Interface (U)SIM Interface Audio Interfaces UART Interfaces USB Interface Implementation DC supply: 4.5~5.5V, typical 5V VBAT: 3.8V for J103 Support UMTS&LTE modules: UC20/UGxx/EC2x/EG9x/AG35/BG96 Support Wi-Fi modules: FC20/AF20 Support SD card Support (U)SIM card insertion detection Support (U)SIM card: 3.0V and 1.8V  One digital audio codec board interface Support Realteck ALC5616 and TI TLV320AIC3104 codec boards  Three analog interfaces used for loudspeaker, earphone and handset Two UART interfaces:  COM1: serial interface for data communication Max baud rate: 460800bps;  COM2: serial interface for debug purpose Default baud rate: 115200bps USB 2.0 Signal Indication Button and Switches Physical Characteristics 5 LEDs are available for signal indication Power Switch (S201), PWRKEY (S302), RESET (S303), PWRDWN_N (S301), BT Function Switch (S901) Size: 146.4mm × 115.0mm UMTS&LTE_EVB_User_Guide 10 / 44 2.3. Interface Overview UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 60Pin FC20 TE-A 60Pin AF20 TE-A J902 J901 J401 J805 J102 100Pin UC20 TE-A UGxx TE-A EC2x TE-A EG9x TE-A AG35 TE-A BG96 TE-A J101 100Pin J701 SD card S901 J402 COM2 (DBG) COM1 (MAIN) J302 J803 J804 115 J806 Test Points J103 VBAT 60Pin Test Point Codec board interface J501 Power supply J201 D209 D205 D207 D208 D206 Power switch S201 Micro USB interface J801 PWRKEY S302 RESET PWRDWN_N S303 S301 Earphone J601 GND 146.4 Handset J702 J602 Figure 1: UMTS&LTE EVB Interface Overview (Unit: mm) USIM/SIM card connector Table 2: Interfaces of UMTS&LTE EVB Interface Power Supply 1) Reference No. J201 (bottom side) J801 Power Switch S201 Description The power jack on the EVB Typical supply voltage: +5V Micro-USB interface Typical supply voltage: +5V VBAT ON/OFF control UMTS&LTE_EVB_User_Guide 11 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide PWRKEY PWRDWN_N RESET S302 J302 S301 S303 BT Function Switch S901 Micro USB Audio (U)SIM COM1 COM2 J801 J501 J603 J601 J602 (bottom side) J702 J401 (bottom side) J402 (bottom side) Status Indication LEDs D209, D205, D207, D208, D206 TE-A Interfaces J101, J102 J901, J902 SD Card J701 Power key (push button) Used to turn on/off UC20/EC2x/EG9x/AG35/BG96 modules, or turn on UGxx modules only Jumper wire Used to connect PWRKEY to GND Used to turn off UGxx modules only Reset button (push button) Used to reset UMTS&LTE modules Switched to the left: connect BT interface (UART, PCM) of Wi-Fi modules to the PCM interface of EC2x/AG35 modules, for testing the BT function of Wi-Fi modules. Switched to the right: connect the main UART and codec board interfaces on EVB to UMTS&LTE modules, for testing the modules’ main UART functions, and the codec‘s PCM function. USB device interface Codec board interface Used for loudspeaker Used to test the analog audio function of UMTS&LTE modules Used for earphone Used to test the analog audio function of UMTS&LTE modules Used for handset Used to test the analog audio function of UMTS&LTE modules (U)SIM card connector Main UART port Debug UART port D209 (VBAT ON/OFF indicator) is used to indicate whether the power supply for UMTS&LTE modules is ready. D205 (power ON/OFF indicator) is used to indicate whether UMTS&LTE modules are powered on. D207 (sleep status indicator) is used to indicate whether UMTS&LTE modules are in sleep mode. D208 and D206 (network status indicator) are used to indicate the network status of UMTS&LTE modules. Connectors of UMTS&LTE TE-A Connectors of Wi-Fi & Ethernet TE-A SD card connector UMTS&LTE_EVB_User_Guide 12 / 44 VBAT Test Points J103 J803, J804, J805, J806 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Jumper wire Used for VBAT voltage test Test pins NOTE 1) The power supply information in above table is for UMTS&LTE modules. For the detailed information of power supply for Wi-Fi modules, please refer to Chapter 4.1 and Chapter 4.3. 2.4. Top View of EVB The top view of the UMTS&LTE EVB is shown as following figure. Figure 2: UMTS&LTE EVB Top View UMTS&LTE_EVB_User_Guide 13 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 2.5. EVB Kit Accessories All accessories of the UMTS&LTE EVB kit are listed as below. USB to UART converter cable Driver disk Bolts and coupling nuts Codec boards Main Wi-Fi Antennas Antenna RF cables USB cable GNSS Antenna Earphone Figure 3: EVB Kit Accessories Table 3: Accessories List Items Cables Antennas Description USB to UART converter cable USB cable RF cable Main antenna UMTS&LTE_EVB_User_Guide Quantity 1 1 4 2 14 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Audio Disk Codec Boards Others Instruction Sheet GNSS antenna (passive) 1 Wi-Fi antenna 1 Earphone 1 USB 2.0 to RS232 driver and USB driver disk 1 ALC5616 and TLV320AIC3104 2 Bolts and coupling nuts for assembling EVB 4 for each type A sheet of paper giving instructions for EVB 1 connection, details of EVB accessories, etc. NOTE The main antenna can also be used for diversity reception. UMTS&LTE_EVB_User_Guide 15 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 3 EVB Kit Accessories Assembly The following figure shows the EVB Kit accessories assembly. Figure 4: UMTS&LTE EVB Kit Assembly UMTS&LTE_EVB_User_Guide 16 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 4 Interface Applications This chapter describes the hardware interfaces of UMTS&LTE EVB, shown as follows:  Power interface  UMTS&LTE TE-A interface  Wi-Fi & Ethernet TE-A interface  USB interface  Audio interfaces  (U)SIM interface  SD card interface  UART interfaces It also provides information about the buttons, switch, status indication LEDs and test points to help customers use the UMTS&LTE EVB. 4.1. Power Interface (J201/J801) The UMTS&LTE EVB can be powered by an external power adapter through connecting with the power jack (J201) or USB receptacle (J801) on the EVB. The power adapter connects to a step-down converter which can provide the supply voltage (VBAT) required for operating the EVB and the module. The following two figures show the simplified power supply schematic and the power interface of Quectel UMTS&LTE EVB. J801 USB interface J201 Power supply S201 Power switch U301 LDO U303 LDO 1.8V 3.3V Power supply for Wi-Fi module U302 LDO 2.85V Power supply for SD Card U201 TPS54319 Step-down converter J103 Power supply for VBAT UMTS&LTE module Figure 5: Power Supply for UMTS&LTE EVB UMTS&LTE_EVB_User_Guide 17 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 5V DC power supply Figure 6: Power Interfaces Before connecting the power supply, customers have to select a proper DC power adapter to supply power for the UMTS&LTE EVB, and the power plug design of the adapter is shown as below. Inner contact Outer contact Figure 7: Power Plug Design 4.2. UMTS&LTE TE-A Interface The UMTS&LTE TE-A interface is designed to accommodate the TE-A of UMTS&LTE (UC20/UGxx/EC2x/EG9x/AG35/BG96) modules. The TE-A is connected to the EVB via BTB connectors J101 and J102. The interface allows customers to easily test the functionalities of UMTS&LTE modules or to develop applications based on them. The following figure shows the connection between UMTS&LTE TE-A and EVB. UMTS&LTE_EVB_User_Guide 18 / 44 J102 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide J101 Figure 8: Connection between UMTS&LTE TE-A and EVB 4.3. Wi-Fi & Ethernet TE-A Interface The Wi-Fi & Ethernet TE-A interface is designed to accommodate the TE-A of Wi-Fi (FC20/AF20) modules. The TE-A is connected to the EVB via BTB connectors J901 and J902. The interface allows customers to easily test the Wi-Fi function of EC2x/AG35 modules or to develop applications with Wi-Fi function. The following two figures show the connection between FC20-TE-A /AF20-TE-A and EVB. UMTS&LTE_EVB_User_Guide 19 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide SGMII_RX_M 16 SGMII_RX_P 18 SGMII_TX_M 22 SGMII_TX_P 24 SGMII_MDIO_DAT 28 SGMII_MDIO_CLK 32 SGMII_RST_N 36 SGMII_INT_N 38 SDIO_CMD 42 SDIO_CLK 46 SDIO_D0 50 52 SDIO_D1 54 SDIO_D2 SDIO_D3 56 GND 16 SGMII_RX_M 18 SGMII_RX_P 22 SGMII_TX_M 24 SGMII_TX_P 28 SGMII_MDIO_DAT 32 SGMII_MDIO_CLK 36 SGMII_RST_N 38 SGMII_INT_N 42 SDIO_CMD 46 SDIO_CLK 50 SDIO_D0 52 SDIO_D1 54 SDIO_D2 56 SDIO_D3 1 GND 2 GND 3 GND 4 GND 27 GND 28 GND 29 GND 30 GND 43 GND 44 GND 57 GND 58 GND 59 GND GND 60 J901 VDD_3V3 VDD_1V8 FC20-TE-A/AF20-TE-A GND 1 GND 2 3 GND 4 GND GND 27 GND 28 GND 29 30 GND GND 43 GND 44 GND 57 GND 58 GND 59 GND 60 GND J902 Figure 9: Simplified FC20-TE-A/AF20-TE-A Interface Schematic J902 J901 Figure 10: Connection between FC20-TE-A and EVB UMTS&LTE_EVB_User_Guide 20 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 4.4. USB Interface (J801) Quectel UMTS&LTE modules provide a USB interface which complies with USB 2.0 standard and supports high-speed (480Mbps), full-speed (12Mbps) and low-speed (1.5Mbps) modes. The interface is used for AT command communication, data transmission, firmware upgrade and GNSS NEMA output. The UMTS&LTE EVB provides a Micro-USB interface J801 for connection with a host device. The USB data lines USB_DP and USB_DM are connected directly to the module. The USB_VBUS line can be used for USB connection detection and EVB power supply. The following figure is a reference circuit design for the USB device interface. Figure 11: Reference Circuit Design for USB Device Interface Table 4: Pin Definition of J801 Pin No. 1 2 3 4 5 Pin Name USB_VBUS USB_DM USB_DP USB_ID GND Function Used for USB connection detection and EVB power supply USB serial differential bus (minus) USB serial differential bus (positive) USB ID bus for host or device GND for USB interface UMTS&LTE_EVB_User_Guide 21 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 4.5. Audio Interfaces Quectel UMTS&LTE EVB provides one digital audio codec board interface (PCM) J501 and three analog audio interfaces J601, J602 and J603. This chapter gives a detailed introduction on these audio interfaces. 4.5.1. Digital Audio Codec Board Interface (J501) The UMTS&LTE EVB supports two different kinds of external digital audio codecs named ALC5616 and TLV320AIC3104. The codec circuit is assembled on an independent small board which can be interconnected with EVB by the BTB connector J501. Customers can select different codecs according to their own application demands, and also can use AT command to switch between codecs. Two examples are provided below. For more details, please refer to document [5] or document [6].  AT+QDAI=3: switch codec from TLV320AIC3104 to ALC5616  AT+QDAI=5: switch codec from ALC5616 to TLV320AIC3104 The following figure show a reference design for the connection between digital audio codec boards and the EVB. 4.7K 4.7K MIC_BIAS UMTS&LTE Module BTB CON ALC5616/TLV3104 BTB CON PCM_CLK R C BCLK MIC_BIAS IN2P IN2N PCM_SYNC PCM_OUT PCM_IN LRCK U101 HPO_L 1 4 6 DACDAT1 HPO_R 5 3 2 ADCDAT1 I2C_SCL I2C_SDA SCL SDA LOUDL/P LOUDR/N VDD_EXT J501 J501 NCP2823 J602 MIC J601 J602 speaker J603 Figure 12: Reference Design for Connection between Codec Board and EVB UMTS&LTE_EVB_User_Guide 22 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Codec board EVB Figure 13: Connection between Codec Board and EVB 4.5.2. Analog Audio Interfaces (J603/J601/J602) 4.5.2.1. Loudspeaker Interface (J603) Audio interface J603 is designed for loudspeakers and the following figure shows a reference design of loudspeaker with an external Class-D audio amplifier. U101 J501 Differential layout Codec LOUDL/P C1 ALC5616/ TLV3104 LOUDR/N C2 Amplifier circuit NCP2823 BTB CON Close to speaker GND 10pF 33pF FB ESD J603 FB 10pF 33pF GND ESD Figure 14: Reference Circuit Design for Loudspeaker Interface J603 UMTS&LTE_EVB_User_Guide 23 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 4.5.2.2. Earphone Interface (J601) Audio interface J601 is designed for earphones. A reference circuit design for the interface is shown as following figure. U101 Differential layout J501 MIC_N MIC_P Close to Socket GND AGND GND GND GND 10pF 33pF 4.7uF75pF 15pF ESD AGND Codec ALC5616 22uF TLV3104 22uF AGND SPK_L SPK_R BTB CON Close to Socket 10pF 33pF 10pF 33pF ESD GND 0R NM_0R 2 4 6 5 3 1 J601 Audio Jack NM_0R 0R AGND MIC_P Figure 15: Reference Circuit Design for Earphone Interface J601 The figure and table below illustrate the pin assignment and pin definition of earphone interface J601. Figure 16: Pin Assignment of J601 UMTS&LTE_EVB_User_Guide 24 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Table 5: Pin Definition of J601 Pin No. 1 2 3 4 5, 6 Pin Name MIC AGND SPK_R SPK_L NC Description Microphone input Dedicated GND for audio Right channel of stereo audio output Left channel of stereo audio output Not connected The following figure shows the sketch design of audio plug which suits for the audio jack on UMTS&LTE EVB. 4 3 2 GND 1 SW SPK_R 32Ω MIC SPK_L 32Ω Figure 17: Sketch of Audio Plug 4.5.2.3. Handset Interface (J602) Audio interface J602 is designed for handsets. A reference circuit design for handset interfaces J602 is shown below. UMTS&LTE_EVB_User_Guide 25 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide U101 Codec ALC5616 TLV3104 IN2P IN2N LOUDL/P LOUDR/N J501 FB BTB CON 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD J602 4 1 3 2 10pF 33pF 10pF 33pF 10pF 33pF ESD ESD Figure 18: Reference Circuit Design for Handset Interface J602 The figure and table below illustrate the pin assignment and pin definition of handset interface J602. 4 2 31 Figure 19: Pin Assignment of J602 UMTS&LTE_EVB_User_Guide 26 / 44 Table 6: Pin Definition of J602 Pin No. 1 2 3 4 Pin Name MICN SPKN SPKP MICP UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Function Negative microphone input Negative loudspeaker output Positive loudspeaker output Positive microphone input 4.6. (U)SIM Interface (J702) The UMTS&LTE EVB has a 6-pin push-push type (U)SIM card (3V or 1.8V) connector J702. The following figure shows the simplified interface schematic for J702. USIM_VDD 12 USIM_DATA 10 USIM_CLK 8 USIM_RST 6 USIM_PRESENCE 14 J101 Push-Push C1 USIM_VDD C7 USIM_DATA C3 USIM_CLK C2 USIM_RST CD2 USIM_PRE. CD1 USIM_GND (U)SIM card connector GND J702 Figure 20: Simplified Interface Schematic for (U)SIM Card Connector J702 UMTS&LTE_EVB_User_Guide 27 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide The figure and table below illustrate the pin assignment and pin definition of J702. CD1 CD2 C7C3C6C2 C5C1 C7 C6 C5 C3 C2 C1 Figure 21: Pin Assignment of J702 Table 7: Pin Definition of J702 Pin No. C1 C2 C3 C5 C6 C7 CD1 CD2 Signal Name USIM_VDD USIM_RST USIM_CLK GND VPP USIM_DATA GND USIM_PRESENCE I/O PO DO DO / / I/O GND I Function U(SIM) card power supply, provided by UMTS&LTE EVB U(SIM) card reset U(SIM) card clock Ground Not connected Data line, bi-directional U(SIM) card insertion detection U(SIM) card insertion detection. Support low level detection. UMTS&LTE_EVB_User_Guide 28 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 4.7. SD Card Interface (J701) The UMTS&LTE EVB provides an SD card interface that supports maximally 32GB micro SD card. With the SD card interface, customers can easily enhance the memory capacity of modules. The following figure shows the simplified interface schematic for J701. SD1_DATA2 29 SD1_DATA3 28 SD1_CMD 33 SD1_CLK 32 SD1_DATA0 31 SD1_DATA1 30 VDD_3V3 1 DAT2 2 CD/DAT3 3 CMD 4 VDD 5 CLK 6 VSS SD card connector 7 DAT0 8 DAT1 J101 GND J701 Figure 22: Simplified Interface Schematic for SD Card Interface J701 12 34 5678 Figure 23: Pin Assignments of J701 UMTS&LTE_EVB_User_Guide 29 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 4.8. UART Interfaces (J401/J402) The UMTS&LTE EVB offers two UART interfaces: COM1 (main UART port J401 and J402) and COM2 (debug UART port). COM1 of UMTS&LTE EVB is intended for communication between the module and the host application. It can be used for data transmission and AT command communication. COM2 supports 115200bps baud rate by default. It can be used for Linux console and log output. The following figure shows the block diagram of UART on UMTS&LTE EVB. J401 COM1 DB9 COM2 DB9 J402 U401 RS232 RS232 Level Match RS232 RS232 Level Match U402 3.0V 3.0V U403 3.0V/1.8V Level Translator 1.8V UMTS&LTE Module 3.0V/1.8V Transistor Level Translator 1.8V J101 Figure 24: UART Block Diagram The following figures and tables show the pin assignment and pin definition of J401 and J402. 5 9 8 4 37 2 6 1 5 4 321 Figure 25: Pin Assignment of J401 UMTS&LTE_EVB_User_Guide 30 / 44 Table 8: Pin Definition of J401 Pin No. 1 2 3 4 5 6 7 8 9 Signal Name RS232_DCD RS232_RXD RS232_TXD RS232_DTR RS232_GND NC RS232_RTS RS232_CTS RS232_RI UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide I/O Description DO Data carrier detection DI Receive data DO Transmit data DI Data terminal ready / GND / Not connected DI Request to send DO Clear to send DO Ring indicator 12 34 5 67 8 9 Figure 26: Pin Assignment of J402 Table 9: Pin Definition of J402 Pin No. 2 3 Signal Name RS232_RXD RS232_TXD I/O Description DI Receive Data DO Transmit data UMTS&LTE_EVB_User_Guide 31 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 4.9. Switches and Buttons The UMTS&LTE EVB includes two switches (S201 and S901) and three buttons (S301, S302 and S303), as shown in the following figures. S901 Figure 27: S901 Switch S201 S302 S303 S301 Figure 28: S201 Switch and S301/S302/S303 Buttons Table 10: Description of Switches and Buttons Reference No. S201 S901 Description VBAT ON/OFF control Switched to the left: connect BT interface (UART, PCM) of Wi-Fi modules to the PCM interface of EC2x/AG35 modules, for testing the BT function of Wi-Fi modules. UMTS&LTE_EVB_User_Guide 32 / 44 S302 S303 S301 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Switched to the right: connect the main UART and codec board interfaces on EVB to UMTS&LTE module, for testing the module's main UART functions, and the codec‘s PCM function. Used to turn on/off UC20/EC2x/EG9x/AG35/BG96 modules, or turn on UGxx modules only Used to reset UMTS&LTE modules Used to turn off UGxx modules only 4.10. Status Indication LEDs The UMTS&LTE EVB comprises five status indication LEDs (D209, D205, D207, D208 and D206). The following figure shows the positions of these LED indicators. D209 D205 D207 D208 D206 Figure 29: Status Indication LEDs Table 11: Description of Status Indication LEDs Reference No. Description D209 D205 VBAT ON/OFF indicator. Indicates whether the power supply for UMTS&LTE modules is ready. Bright: VBAT ON Extinct: VBAT OFF Power ON/OFF indicator. Indicates the operation status of UMTS&LTE modules. Bright: the module is powered on Extinct: the module is powered off D207 Sleep status indicator. Indicates the sleep status of UMTS&LTE modules. UMTS&LTE_EVB_User_Guide 33 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide D208, D206 Bright: the module is in sleep mode Extinct: the module is not in sleep mode Network status indicator. Indicates the network status of UMTS&LTE modules. For detailed information please refer to document [2]. 4.11. Test Points The UMTS&LTE EVB provides a series of test points. They can help customers to obtain the corresponding waveform of some signals. The following two figures show test points J803, J804, J805 and J806. J806 12 34 56 78 9 10 J803 12 34 56 78 9 10 J805 12 34 56 78 9 10 Figure 30: Test Points J803, J805 and J806 UMTS&LTE_EVB_User_Guide 34 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 9 75 31 10 8 6 4 2 J804 Figure 31: Test Point J804 Table 12: Pin Definition of J803, J804, J805 and J806 J803 Pin No. 1, 3, 5 2 4 6 7 8 9 10 J804 Pin No. 1 2 Pin Name Description DTR_TEST Data terminal ready test pins POWER_EN VBAT enable pin PWRKEY_3.0V PWRKEY_3.0V test pin RESET_3.0V RESET_3.0V test pin VDD_EXT Connected directly to VDD_EXT of UMTS&LTE modules POWER_OFF_3.0V Used to power off UGxx modules SPI_MRDY RESERVED SPI_SRDY RESERVED Pin Name VDD_3.0V PCM_SYNC Description 3.0V power supply from U302 Connected directly to PCM_SYNC of UMTS&LTE modules UMTS&LTE_EVB_User_Guide 35 / 44 3 4 5 6 7 8 9 10 J805 Pin No. 1 2 3 4 5 6 7 8 9 10 J806 Pin No. 1 2 3 VDD_1V8 PCM_IN I2C_SDA PCM_OUT I2C_SCL PCM_CLK CLK_OUT GND UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 1.8V power supply from U301 Connected directly to PCM_IN of UMTS&LTE modules Connected directly to I2C_SDA of UMTS&LTE modules Connected directly to PCM_OUT of UMTS&LTE modules Connected directly to I2C_SCL of UMTS&LTE modules Connected directly to PCM_CLK of UMTS&LTE modules RESERVED Ground Pin Name WAKE_IN SPI_CS_N AP_READY SPI_CLK W_DISABLE_N SPI_MISO USB_BOOT SPI_MOSI VDD_1.8V GND Description Connected directly to WAKE_IN of UMTS&LTE modules Connected directly to SPI_CS_N of UMTS&LTE modules Connected directly to AP_READY of UMTS&LTE modules Connected directly to SPI_CLK of UMTS&LTE modules Connected directly to W_DISABLE# of UMTS&LTE modules Connected directly to SPI_MISO of UMTS&LTE modules Connected directly to USB_BOOT of UMTS&LTE modules Connected directly to SPI_MOSI of UMTS&LTE modules Connected to VDD_1.8V via a resistor Ground Pin Name CTS_1.8V_UART RTS_1.8V_UART RXD_1.8V_UART Description Connected directly to voltage translator Connected directly to voltage translator Connected directly to voltage translator UMTS&LTE_EVB_User_Guide 36 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 4 RXD_3.0V Connected directly to voltage translator 5 TXD_1.8V_UART Connected directly to voltage translator 6 TXD_3.0 Connected directly to voltage translator 7 DTR_1.8V Connected directly to DTR of UMTS&LTE modules 8 DTR_3.0V Connected directly to voltage translator 9 RI_1.8V Connected directly to RI of UMTS&LTE modules 10 GND Ground UMTS&LTE_EVB_User_Guide 37 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 5 Operation Procedures Illustration This chapter introduces how to use the UMTS&LTE EVB for testing and evaluation of Quectel UMTS&LTE modules and Wi-Fi modules. 5.1. Power on UMTS&LTE and Wi-Fi Modules  Power on UMTS&LTE modules 1. Connect the UMTS&LTE TE-A to the EVB via connectors J101 and J102. 2. Insert a (U)SIM card into the (U)SIM card connector on EVB, and connect the antennas to UMTS&LTE TE-A. 3. Connect the EVB to a 5V power adapter, or connect the EVB to PC via USB cable. 4. Switch S201 (Power Switch) to ON state, then D209 (VBAT ON/OFF indicator) will light up. Press the S302 (PWRKEY) for at least 100ms, then the UMTS&LTE module will be powered on and D205 (power ON/OFF indicator) will light up.  Power on Wi-Fi modules 1. Make sure the EC2x/AG35 module is powered on, if there is a need to test the Wi-Fi function of them. 2. Connect the TE-A of Wi-Fi modules to the EVB via connectors J901 and J902, and then connect the Wi-Fi antenna to the TE-A. 3. Connect the TE-A to PC via an Ethernet cable. 4. Send AT+QWIFI=1 command to EC2x/AG35 module to enable power supply for Wi-Fi modules. For more details, please refer to document [3] or document [4]. Before sending the command, please make sure the EVB has been connected to PC via USB cable. The following table shows the UMTS&LTE modules’ network status which are indicated via D206 and D208. UMTS&LTE_EVB_User_Guide 38 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Table 13: Indication of D206 and D208 Status State Indication LEDs Flicker slowly (200ms ON/1800ms OFF) D206 NET_STATUS Flicker slowly (1800ms ON/200ms OFF) Flicker slowly (125ms ON/125ms OFF) Network Status Network searching Idle mode Data is being transferred over 2G/3G/4G networks Always ON Voice calling D208 NET_MODE Always ON Always OFF Registered on 3G network successfully (UC20/UGxx) Registered on 4G network successfully (EC2x/EG95/AG35/BG96) Others 5.2. Communication Via USB or UART Interface 5.2.1. Communication via USB Interface 1. Power on the UMTS&LTE module according to the procedures mentioned in Chapter 5.1. 2. Connect the EVB and the PC with USB cable through USB interface, and then run the driver disk on PC to install the USB driver. For details about USB driver installation, please refer to document [1]. The USB port numbers can be viewed through the PC Device Manager, as shown below. Figure 32: USB Ports 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the UMTS&LTE module and the PC. The following figure shows the COM Port Setting field on QCOM: select correct 'COM port' (USB AT Port which is shown in above figure) and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [7]. UMTS&LTE_EVB_User_Guide 39 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Figure 33: COM Port Setting Field on QCOM (USB AT Port Connection) 5.2.2. Communication via UART Interface 1. Run the driver disk on PC to install the USB-to-RS232 driver. 2. Connect the main UART interface of module to PC with the USB-to-UART converter cable (USB-to-RS232 cable), and the USB serial port number can be viewed through the PC Device Manager, as shown below. Figure 34: USB Serial Port 3. Install and then use the QCOM tool provided by Quectel to realize the communication between the UMTS&LTE module and the PC. The following figure shows the COM Port Setting field on QCOM: select correct 'COM port' (USB Serial Port) and set correct 'Baudrate' (such as 115200bps). For more details about QCOM tool usage and configuration, please refer to document [7]. Figure 35: COM Port Setting Field on QCOM (USB Serial Port Connection) UMTS&LTE_EVB_User_Guide 40 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 5.3. Firmware Upgrade Quectel UMTS&LTE modules upgrade firmware via USB port by default, please follow the procedures below to upgrade firmware. 1. Install and open the firmware upgrade tool QFlash on PC and then power on the UMTS&LTE modules according to the procedures mentioned in Chapter 5.1. 2. Click the 'COM Port' dropdown list and select the USB DM port. 3. Click the 'Load FW Files' button to choose the firmware package. 4. Click the 'Start' button to upgrade the firmware. Figure 36: Configurations for Firmware Upgrade 5.4. Reset UMTS&LTE Modules The emergency reset option is only used in case of emergency. For example, the software does not respond for more than 5s due to some serious problems. Press the button S303 (RESET) for more than 150ms then release it to reset UMTS&LTE modules. However, this may causes the loss of information stored in the memory as the reset module has been initialized. UMTS&LTE_EVB_User_Guide 41 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 5.5. Power off UMTS&LTE and Wi-Fi Modules  Power off UMTS&LTE modules There are two ways to power off UMTS&LTE modules. One way is to execute AT command AT+QPOWD. This is the best and the safest way. The module will log off from the network and save data before shutdown, but it will be powered on again after shutdown. For more details about the AT command, please refer to document [5] or document [6]. The other way to power off the module is to press down S302/S301 button (S302 for UC20/EC2x/EG9x/AG35/BG96 modules, and S301 for UGxx modules) for at least 0.6s.  Power off Wi-Fi modules AT+QWIFI=0 command can be used to power off Wi-Fi modules. For more details, please refer to document [3] or document [4]. UMTS&LTE_EVB_User_Guide 42 / 44 UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide 6 Appendix A References Table 14: Related Documents SN Document Name Remark Respective Windows USB drivers installation guide for UC20, UGxx and [1] Quectel_xx_Windows_USB_Drivers_Installation_Guide LTE (EC2x, EG9x, AG35 and BG96) modules [2] Quectel_xx_Hardware_Design Respective hardware design for UC20, UG95, UG96, EC25, EC21, EC20, EC20 R2.0, EC20 R2.1, AG35 and BG96 modules [3] Quectel_FC20_Series_Hardware_Design FC20 series hardware design [4] Quectel_AF20_Hardware_Design [5] Quectel_WCDMA_UGxx_AT_Commands_Manual [6] Quectel_xx_AT_Commands_Manual [7] Quectel_QCOM_User_Guide AF20 hardware design AT commands manual for Quectel WCDMA UGxx modules Respective AT commands manual for UC20, EC25&EC21, EC20, EC20 R2.0, EC20 R2.1, AG35 and BG96 modules User guide for QCOM tool Table 15: Terms and Abbreviations Abbreviation AGND COM BTB DC DI Description Analogue Ground Cluster Communication Port Board to Board Direct Current Digital Input UMTS&LTE_EVB_User_Guide 43 / 44 DO EVB GND GNSS I/O LED LTE MIC NC PC PCB PCM PO RF SD SIM UART UMTS USB USIM VBAT UMTS/HSPA/LTE Module Series UMTS&LTE EVB User Guide Digital Output Evaluation Board Ground Global Navigation Satellite System Input/Output Light Emitting Diode Long Term Evolution Microphone Not Connected Private Computer Printed Circuit Board Pulse Code Modulation Power Output Radio Frequency Secure Digital Subscriber Identity Module Universal Asynchronous Receiver & Transmitter Universal Mobile Telecommunications System Universal Serial Bus Universal Subscriber Identity Module Voltage of Battery UMTS&LTE_EVB_User_Guide 44 / 44

MC20-TE-A User Guide GSM/GPRS/GNSS Module Series Rev. MC20-TE-A_User_Guide_V2.0 Date: 2016-09-27 www.quectel.com GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. MC20-TE-A_User_Guide Confidential / Released 1 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide About the Document History Revision 1.0 2.0 Date 2016-07-22 Author Tiger CHENG CQouneficdteenl tial 2016-09-27 TigerCHENG Description Initial 1. Added figures for reference in Chapter 5. 2. Added using main UART and UART3 to communicate with GNSS part in Chapter 5.3.3. MC20-TE-A_User_Guide Confidential / Released 2 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Safety Information ................................................................................................................... 7 2 Product Concept .................................................................................................................................. 8 2.1. MC20-TE-A Top and Bottom View........................................................................................... 8 3 4 5 6 7 Interface Application of MC20-TE-A ................................................................................................ 10 3.1. SIM2 Card Interface .............................................................................................................. 10 3.2. Test Points ............................................................................................................................. 11 l MC20-TE-A Accessories Assembly ................................................................................................. 13 te Illustration ........................................................................................................................................... 14 5.1. Power on ............................................................................................................................... 14 c l 5.2. Communicate with GSM Part of the Module......................................................................... 15 5.3. Communicate with GNSS Part of the Module....................................................................... 17 ue tia 5.3.1. Use Main UART (All-in-one Solution) ............................................................................ 17 5.3.2. Use UART3 (Stand-alone Solution) ............................................................................... 17 5.3.3. Use Main UART and UART3 ......................................................................................... 19 Q n 5.4. Firmware Upgrade through Main UART Port........................................................................ 20 5.5. Compatible Design and Applications..................................................................................... 20 e 60-pin Assignment............................................................................................................................. 23 Confid Appendix A References..................................................................................................................... 25 MC20-TE-A_User_Guide Confidential / Released 3 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Table Index TABLE 1: PINS OF SIM2 CARD INTERFACE .................................................................................................. 10 TABLE 2: PINS OF TEST POINTS.....................................................................................................................11 TABLE 3: PIN DEFINITION OF THE 60-PIN DIP CONNECTOR ..................................................................... 23 TABLE 4: RELATED DOCUMENTS .................................................................................................................. 25 CQouneficdteenl tial MC20-TE-A_User_Guide Confidential / Released 4 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Figure Index FIGURE 1: MC20-TE-A TOP VIEW ..................................................................................................................... 8 FIGURE 2: MC20-TE-A BOTTOM VIEW............................................................................................................. 9 FIGURE 3: SIM2 CARD INTERFACE ............................................................................................................... 10 FIGURE 4: TEST POINTS..................................................................................................................................11 FIGURE 5: MC20-TE-A TOOLKIT ACCESSORIES .......................................................................................... 13 FIGURE 6: CONNECTION BETWEEN MC20-TE-A AND GNSS/GSM ANTENNA .......................................... 14 FIGURE 7: S101/S102 SWITCH STATUS INDICATION................................................................................... 15 FIGURE 8: S101/S102 SWITCH STATUS ON MAIN UART WHEN COMMUNICATING WITH GSM PART ... 15 FIGURE 9: S101/S102 SWITCH STATUS ON UART3 WHEN COMMUNICATING WITH GSM PART ........... 16 FIGURE 10: S101/S102 SWITCH STATUS ON MAIN UART WHEN COMMUNICATING WITH GNSS PART 17 FIGURE 11: S101/S102 SWITCH STATUS ON UART3 WHEN COMMUNICATING WITH GNSS PART ....... 18 FIGURE 12: USER INTERFACE OF POWERGPS TOOL................................................................................ 18 FIGURE 13: J106 SHORT CIRCUIT CONNECTION........................................................................................ 19 l FIGURE 14: S101/S102 SWITCH STATUS ON MAIN UART&UART3 WHEN COMMUNICATING WITH GNSS PART ................................................................................................................................................................. 19 te FIGURE 15: SWITCH S101/S102 TO ON STATE............................................................................................. 20 FIGURE 16: USING A PASSIVE ANTENNA ..................................................................................................... 21 c l FIGURE 17: USING THE BUILT-IN BLUETOOTH ANTENNA.......................................................................... 21 ue tia FIGURE 18: USING AN EXTERNAL BLUETOOTH ANTENNA........................................................................ 22 CQonfiden FIGURE 19: DIP CONNECTOR OF MC20-TE-A.............................................................................................. 23 MC20-TE-A_User_Guide Confidential / Released 5 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 1 Introduction In order to help customers to develop applications with Quectel MC20 module, Quectel supplies corresponding evaluation board (EVB) kit and TE-A kit to test the module. This document can help customers quickly understand MC20-TE-A interface specifications, electrical and mechanical details and know how to use it. MC20-TE-A is intended to be used in combination with GSM EVB for MC20 module testing and CQouneficdteenl tial evaluation. For detailed description of GSM EVB, please refer to document [4]. MC20-TE-A_User_Guide Confidential / Released 6 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating Quectel module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for customer’s failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as l to prevent interference with communication systems. Consult the airline staff about the use of wireless devices on boarding the aircraft, if your device offers an te Airplane Mode which must be enabled prior to boarding an aircraft. c l Switch off your wireless device when in hospitals, clinics or other health care ue tia facilities. These requests are desinged to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular Q n network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid SIM card. While you are in this condition and need emergent e help, please remember using emergency call. In order to make or receive a call, fid the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, n it receives and transmits radio frequency energy. RF interference can occur if it is oused close to TV set, radio, computer or other electric equipment. CIn locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. MC20-TE-A_User_Guide Confidential / Released 7 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 2 Product Concept 2.1. MC20-TE-A Top and Bottom View Qouneficdteenl tial A: Serialselectorswitch C B: GSM antenna interface Figure 1: MC20-TE-A Top View C: GNSS antenna interface D: BT antenna interface E: LED indicator MC20-TE-A_User_Guide Confidential / Released 8 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide uectel tial F: SIM2 card interface G: Test points Figure 2: MC20-TE-A Bottom View Q n NOTES e 1. Some interfaces and test pins are reserved only for engineers to debug some functions which are not fid used for customers. Con 2. Some functions are only supported in certain software versions. MC20-TE-A_User_Guide Confidential / Released 9 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 3 Interface Application of MC20-TE-A 3.1. SIM2 Card Interface Queficdteenl tial Figure3:SIM2CardInterface n Table 1: Pins of SIM2 Card Interface Co Pin Signal I/O Description 1 CD1 Connect to ground 2 CD2 Reserved 3 SIM_DATA I/O SIM card data I/O 4 SIM_CLK O SIM card clock 5 VPP Reserved 6 SIM_RST O SIM card reset MC20-TE-A_User_Guide Confidential / Released 10 / 25 7 GND 8 SIM_VDD 9 GND 10 GND GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Ground Power supply for SIM card Ground Ground 3.2. Test Points CQouneficdteenl tial Table2:PinsofTestPoints Figure 4: Test Points Pin Signal I/O Description 1 PCM_CLK/SPI_CS O PCM clock 2 PCM_SYNC/SPI_MISO O PCM frame synchronization 3 TXD_AUX O Transmit data 4 PCM_IN/SPI_CLK I PCM data input 5 GND Ground MC20-TE-A_User_Guide Confidential / Released 11 / 25 6 GNSS_VCC_EN O 7 PCM_OUT/SPI_MOSI I/O 8 RXD_AUX I 9 I2C_SCL28 10 I2C_SDA28 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide GNSS power enabled General purpose input/output port Receive data Reserved Reserved CQouneficdteenl tial MC20-TE-A_User_Guide Confidential / Released 12 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 4 MC20-TE-A Accessories Assembly Queficdteenl tial Figure5:MC20-TE-AToolkitAccessories A: GNSS antenna n B: CD Co C: GNSS antenna patch lead MC20-TE-A_User_Guide Confidential / Released 13 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 5 Illustration MC20-TE-A kit is intended to be used in combination with GSM EVB for MC20 module testing and evaluation. The connection between MC20-TE-A and GNSS/GSM antenna can refer to the following figure. Quecteenl tial Figure 6: Connection between MC20-TE-A and GNSS/GSM Antenna fid 5.1. Power on on Power on procedure of MC20-TE-A is controlled by GSM EVB. Please refer to document [4] for detailed C power on procedures. MC20-TE-A_User_Guide Confidential / Released 14 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 5.2. Communicate with GSM Part of the Module (1) If the main UART is used for communication with GSM part of MC20 module, please turn the S101 and S102 switch to ON state on MC20-TE-A, and then connect the main UART of EVB to PC’s USB port with the USB to UART converter cable. This is the recommended method. Switch status description is available in the following figures. CQouneficdteenl tial Figure 7: S101/S102 Switch Status Indication Figure 8: S101/S102 Switch Status on Main UART When Communicating with GSM Part If the UART3 is used for communication with the GSM part, please turn the S101 switch to OFF and S102 switch to ON state on MC20-TE-A, and then connect the UART3 on EVB to PC’s USB port with the USB to UART converter cable. Currently, the software does not support this method. MC20-TE-A_User_Guide Confidential / Released 15 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Figure 9: S101/S102 Switch Status on UART3 When Communicating with GSM Part l (2) Open the QCOM (AT command window) on PC. Set appropriate Baud Rate (such as 115200bps) and COM number which can be checked by the Device Manager on PC. te (3) Connect the antenna to the GSM_ANT on MC20-TE-A with an RF cable. c l (4) Insert SIM card into the SIM card socket. ue tia (5) Insert earphone or handset into audio interface. (6) For power on procedure, please refer to document [4]. Q n (7) After waiting for 2~3 seconds, customers should first input 'AT' or 'at' string once or more until e receiving 'OK' from the module in the HyperTerminal. fid The module is set to autobauding mode in default configuration. This operation is to synchronize the baud rate between the computer and the module. Con (8) Input AT command and the module will execute its corresponding functions. MC20-TE-A_User_Guide Confidential / Released 16 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 5.3. Communicate with GNSS Part of the Module 5.3.1. Use Main UART (All-in-one Solution) (1) Turn the S101 and S102 switch to ON state on MC20-TE-A, and then connect the main UART of EVB to PC’s USB port with the USB to UART converter cable. This is the recommended method. ctel l Figure 10: S101/S102 Switch Status on Main UART When Communicating with GNSS Part ue tia (2) Open the QCOM (AT command window) on PC. Set appropriate Baud Rate (such as 115200bps) and COM number which can be checked by the Device Manager on PC. Q n (3) Connect the antenna to the GNSS_ANT on MC20-TE-A with an RF cable. e (4) For power on procedure, please refer to document [4]. fid (5) After waiting for 2~3 seconds, customers should first input 'AT' or 'at' string once or more until receiving 'OK' from the module in the HyperTerminal. n (6) Send corresponding AT commands to power on/off the GNSS part. When GNSS is powered on, the o LED D102 on MC20-TE-A will be lighted and NMEA data will be output. For details of the C corresponding AT commands, please refer to document [1]. 5.3.2. Use UART3 (Stand-alone Solution) (1) Turn the S101 switch to ON and S102 switch to OFF state on MC20-TE-A, and then connect the main UART and UART3 of EVB to PC’s USB ports with the USB to UART converter cables. MC20-TE-A_User_Guide Confidential / Released 17 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Figure 11: S101/S102 Switch Status on UART3 When Communicating with GNSS Part (2) Connect the antenna to the GNSS_ANT on MC20-TE-A with an RF cable. l (3) Insert the plug of the 5V power adapter. Turn the S202 switch to ON state on the EVB. The LED D503 on the EVB will be lighted. te (4) Send AT+QGNSSC=1 command via main UART to power on the GNSS part, and the LED D102 on c l MC20-TE-A will be lighted. For details of the corresponding AT commands, please refer to document [1]. ue tia (5) NMEA data will be received via UART3 and PMTK commands can be sent via UART3. Q n (6) The PowerGPS tool can be used to view the status of GPS&GLONASS receiver conveniently. When Confide the tool is opened, the user interface as shown below will be displayed. Figure 12: User Interface of PowerGPS Tool MC20-TE-A_User_Guide Confidential / Released 18 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 5.3.3. Use Main UART and UART3 In this solution, customers can send AT commands about GNSS and get the data of GNSS via main UART. At the same time, NMEA data will be received from UART3. (1) Use a short circuit cap to connect the J106. uectel tial Figure 13: J106 Short Circuit Connection Q n (2) Turn the S101 and S102 switch to ON state on MC20-TE-A, and then connect the main UART and Confide UART3 of EVB to PC’s USB ports with the USB to UART converter cables. Figure 14: S101/S102 Switch Status on Main UART&UART3 When Communicating with GNSS Part MC20-TE-A_User_Guide Confidential / Released 19 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide (3) Connect the antenna to the GNSS_ANT on MC20-TE-A with an RF cable. (4) Insert the plug of the 5V power adapter. Turn the S202 switch to ON state on the EVB. The LED D503 on the EVB will be lighted. (5) Send AT+QGNSSC=1 command via main UART to power on the GNSS part, and the LED D102 on MC20-TE-A will be lighted. For details of the corresponding AT commands, please refer to document [1]. (6) Send AT commands about GNSS and get the data of GNSS via main UART. (7) NMEA data will be received via UART3. 5.4. Firmware Upgrade through Main UART Port (1) Switch the S101 and S102 on MC20-TE-A to ON state. Queficdteenl tial Figure 15: Switch S101/S102 to ON State n (2) Start the firmware upgrade tool on PC. Co (3) Press the START button in the firmware upgrade tool. (4) Switch the S201 and S202 on the EVB to ON state. For details, please refer to document [4]. 5.5. Compatible Design and Applications When testing the GNSS function, a passive antenna is recommended to be used. In this case, there is no need to mount resistor R101 (10 ohm, 0805 package). If an active antenna is used, then R101 should be mounted. MC20-TE-A_User_Guide Confidential / Released 20 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide l Figure 16: Using a Passive Antenna te When testing the BT function, the built-in Bluetooth antenna of MC20-TE-A is recommended to be used. In c l this case, resistor R109 (0 ohm, 0402 package) is mounted, while resistor R105 (0 ohm, 0402 package) is not mounted. If an external Bluetooth antenna is used, then R105 should be mounted and R109 should not CQounefidentia be mounted. Figure 17: Using the Built-in Bluetooth Antenna MC20-TE-A_User_Guide Confidential / Released 21 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide CQouneficdteenl tial Figure 18: Using an External Bluetooth Antenna MC20-TE-A_User_Guide Confidential / Released 22 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 6 60-pin Assignment uectel tial Figure 19: DIP Connector of MC20-TE-A Q en Table 3: Pin Definition of the 60-pin DIP Connector fid Pin No. Pin Name I/O 1 VBAT I n 3 VBAT I Co 5 VBAT I Pin No. Pin Name I/O 2 GND 4 GND 6 GND 7 VBAT I 8 GND 9 VBAT I 10 GND 11 12 ADC0 I 13 14 VRTC I/O 15 VDD_EXT O 16 NETLIGHT O 17 PWRKEY I 18 KBR0 O MC20-TE-A_User_Guide Confidential / Released 23 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 19 20 KBR1 O 21 GPIO0 I/O 22 KBR2 O 23 24 TXD3 O 25 SIM1_VDD O 26 RXD3 I 27 SIM1_RST O 28 KBC0 I 29 SIM1_DATA I/O 30 KBC1 I 31 SIM1_CLK O 32 33 35 37 39 41 43 45 47 49 51 53 55 57 59 SIM1_PRESENCE I 34 36 DCD O 38 SD_CMD O l DTR I 40 SD_CLK O te RXD I 42 SD_DATA I/O c l TXD O 44 ue tia RTS I 46 CTS O 48 DBG_RXD I Q n RI O 50 DBG_TXD O e 52 fid SPK1P O 54 MICP I SPK1N O 56 MICN I n SPK2P O 58 MICP I Co 60 MICN I MC20-TE-A_User_Guide Confidential / Released 24 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 7 Appendix A References Table 4: Related Documents SN Document Name Remark [1] [2] [3] [4] Quectel_MC20_AT_Commands_Manual Quectel_GSM_UART_Application_Note Quectel_MC20_Hareware_Design CQouneficdteenl tial Quectel_GSM_EVB_User_Guide MC20 AT commands manual Serial port application note MC20 Hardware design GSM EVB user guide MC20-TE-A_User_Guide Confidential / Released 25 / 25

L70 EVB User Guide GPS Module Series Rev. L70_EVB_User_Guide_V2.0 Date: 2013-05-31 www.quectel.com GPS Module L70 EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarter: Quectel Wireless Solutions Co., Ltd. Room 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx l For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx cte l GENERAL NOTES ue tia QUECTEL OFFERS THIS 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 Q n MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT e ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN ARE SUBJECT TO fid CHANGE WITHOUT PRIOR NOTICE. n COPYRIGHT o THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS C DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS 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. 2013. All rights reserved. L70_EVB_User Guide Confidential / Released 1 / 24 GPS Module L70 EVB User Guide About the document History Revision l 1.0 CQouneficdteential 2.0 Date 2013-02-21 2013-05-28 Author Dishon ZHOU Ada LI Description Initial Hardware upgraded L70_EVB_User Guide Confidential / Released 2 / 24 GPS Module L70 EVB User Guide Contents About the document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 2 Introduction to EVB Kit ....................................................................................................................... 7 3 4 5 6 7 2.1. EVB Top and Bottom View .......................................................................................................... 7 2.2. EVB Accessories......................................................................................................................... 9 Interface Application ......................................................................................................................... 10 l 3.1. USB Interface............................................................................................................................ 10 3.2. UART Interface.......................................................................................................................... 11 te 3.3. Antenna Interface...................................................................................................................... 12 c l 3.4. Switches and Buttons ............................................................................................................... 13 3.5. Operating Status LEDs ............................................................................................................. 14 ue tia 3.6. Test Points................................................................................................................................. 15 EVB and Accessories ........................................................................................................................ 16 Q n Install Device Driver........................................................................................................................... 17 e Starting PowerGPS ............................................................................................................................ 18 Confid Appendix A Reference....................................................................................................................... 24 L70_EVB_User Guide Confidential / Released 3 / 24 GPS Module L70 EVB User Guide Table Index TABLE 1: PINS OF UART PORT .......................................................................................................................11 TABLE 2: SWITCHES AND BUTTONS............................................................................................................. 13 TABLE 3: OPERATING STATUS LEDS ............................................................................................................ 14 TABLE 4: PINS OF J106 ................................................................................................................................... 15 TABLE 5: EXPLANATIONS OF POWERGPS WINDOW .................................................................................. 19 TABLE 6: REFERENCE .................................................................................................................................... 24 TABLE 7: ABBREVIATIONS .............................................................................................................................. 24 CQouneficdteenl tial L70_EVB_User Guide Confidential / Released 4 / 24 GPS Module L70 EVB User Guide Figure Index FIGURE 1: EVB TOP VIEW ................................................................................................................................ 7 FIGURE 2: EVB BOTTOM VIEW ........................................................................................................................ 8 FIGURE 3: EVB ACCESSORIES ........................................................................................................................ 9 FIGURE 4: MICRO-USB INTERFACE .............................................................................................................. 10 FIGURE 5: UART INTERFACE ..........................................................................................................................11 FIGURE 6: ANTENNA INTERFACE .................................................................................................................. 12 FIGURE 7: LNA LAYOUT .................................................................................................................................. 12 FIGURE 8: SWITCHES AND BUTTONS .......................................................................................................... 13 FIGURE 9: OPERATING STATUS LEDS .......................................................................................................... 14 FIGURE 10: TEST POINTS J106...................................................................................................................... 15 FIGURE 11: EVB AND ACCESSORY EQUIPMENTS ...................................................................................... 16 l FIGURE 12: POWERGPS TOOL ...................................................................................................................... 18 te FIGURE 13: MTK COMMAND .......................................................................................................................... 20 FIGURE 14: STATIC TTFF TESTING ............................................................................................................... 21 c l FIGURE 15: STATIC TTFF TESTING CONFIGURATION OPTIONS ............................................................... 22 CQounefidentia FIGURE 16: STATIC TTFF TESTING CONFIGURATION ................................................................................ 23 L70_EVB_User Guide Confidential / Released 5 / 24 GPS Module L70 EVB User Guide 1 Introduction This document defines and specifies the usage of L70 EVB (Evaluation Board). You can get useful information about L70 EVB and GPS demo tool from this document. CQouneficdteenl tial L70_EVB_User Guide Confidential / Released 6 / 24 GPS Module L70 EVB User Guide 2 Introduction to EVB Kit 2.1. EVB Top and Bottom View CQEGF ouneDHficdtCeeJ IBnl tiaA l Figure 1: EVB Top View L70_EVB_User Guide Confidential / Released 7 / 24 GPS Module L70 EVB User Guide E F A l J G Queficdteential Figure 2: EVB Bottom View n A: UART port o B: Serial port alternation switch C C: RESET button D: POWER switch E: Micro-USB port F: Indication LEDs G: Antenna interface H: L70 Module I: STANDBY switch J: Test points L70_EVB_User Guide Confidential / Released 8 / 24 2.2. EVB Accessories GPS Module L70 EVB User Guide B A Queficdteenl tial Figure3:EVBAccessories A: USB cable Con B: GPS active antenna (3.3V) L70_EVB_User Guide Confidential / Released 9 / 24 GPS Module L70 EVB User Guide 3 Interface Application 3.1. USB Interface CQouneficdteenl tial Figure 4: Micro-USB Interface The main power is supplied via Micro-USB interface. Quectel provides two ways for data communication: Micro-USB and UART interface which are controlled by serial port alternation switch (S2). Both of RS232 and Micro-USB cable are necessary, if you want to use UART in order to output NEMA. So the easy way is that use Micro-USB cable which both provides the power and output NEMA. You can make alternation between UART port and Micro-USB interface via switch (S2). NOTE If you want to use PowerGPS Tool, UART interface is recommended for data communication. L70_EVB_User Guide Confidential / Released 10 / 24 3.2. UART Interface GPS Module L70 EVB User Guide Quectenl tial Figure5:UARTInterface fide Table 1: Pins of UART port n Pin Signal Co 2 RXD I/O Description I Receive data 3 TXD O Transmit data 5 GND GND . L70_EVB_User Guide Confidential / Released 11 / 24 3.3. Antenna Interface GPS Module L70 EVB User Guide Antenna CQouneficdteenl tial Figure6:AntennaInterface C109 R118 L70_EVB_User Guide Figure 7: LNA Layout Confidential / Released 12 / 24 GPS Module L70 EVB User Guide For choice of external antenna, both of active antenna and passive antenna can be selected. Please note the LNA is installed in the EVB by default, so you have to move C109 to R112 and R118 to R105, when you want to remove the LNA for test. 3.4. Switches and Buttons CQouneS1ficdtKee1 SS23nl tial Figure 8: Switches and Buttons Table 2: Switches and Buttons Part Name I/O S1 POWER I Serial port S2 I alternation switch Description Control power supply via Micro-USB. QUECTEL EVB supplies two communicative ways: Micro-USB and UART which are controlled by switch. L70_EVB_User Guide Confidential / Released 13 / 24 S3 STANDBY I K1 RESET I GPS Module L70 EVB User Guide The module will enter into standby mode when switching from OFF to ON, and exit from standby mode in the opposite operation. Press and release this button, then the module will reset. 3.5. Operating Status LEDs CQouneficdteenl tial Figure9:OperatingStatusLEDs Table 3: Operating status LEDs Part Name L1 TXD1 L2 1PPS I/O Description Flash: turn on successfully. Micro-USB or UART1 O port can output messages. Extinct: fail to turn on the module. Flash: fix successfully. The frequency is 1Hz. O Extinct: no fix. L70_EVB_User Guide Confidential / Released 14 / 24 3.6. Test Points GPS Module L70 EVB User Guide 5432 1 6 7 8 9 10 uectel tial Table4:PinsofJ106 Q en Pin Signal fid 1/10 GND 2 STANDBY n 3 1PPS Co 4 AADET_N Figure 10: Test Points J106 I/O Description Ground I Enter or exit standby mode O 1 pulse per second I Active antenna open circuit detection 5 32K/DRIN Reserved 6 TIMER(FORCE_ON) O Logic high will force module to be waked up from backup mode. Keep this pin open or pulled low before entering into backup mode. If unused, keep this pin open. 7 RESET I System reset 8 TXD1 O Transmit data 9 RXD1 I Receive data L70_EVB_User Guide Confidential / Released 15 / 24 GPS Module L70 EVB User Guide 4 EVB and Accessories The EVB and its accessories are equipped as shown in Figure 11. CQouneficdteenl tial Figure11:EVBandAccessoryEquipments L70_EVB_User Guide Confidential / Released 16 / 24 GPS Module L70 EVB User Guide 5 Install Device Driver Please note that you need to install the driver of Micro-USB, when use Micro-USB for data communication. The driver has been stored in our FTP server. The driver of CP210x also can be download from internet. The download path of our FTP server is as below: Overseas customer: /d:/FTP/OC/Overseas_Technical/Overseas_Module Official Documents/GNSS Module/Common/04 Tool Kit/ GNSS_EVB_Micro-USB_Driver_CP210x. Domestic customer: /d:/FTP/CC/Domestic_Technical/Domestic_Module Official Documents/GNSS CQouneficdteenl tial Module/Common/04ToolKit/GNSS_EVB_Micro-USB_Driver_CP210x. L70_EVB_User Guide Confidential / Released 17 / 24 GPS Module L70 EVB User Guide 6 Starting PowerGPS The PowerGPS version is V2.2.0. The PowerGPS tool can help user to view the status of GPS&GLONASS receiver conveniently. When the tool is opened, the following window will be displayed: Queficdteenl tial Figure12:PowerGPSTool on After EVB accessories are assembled, turn on the module and start up the PowerGPS. Select a correct C COM port and baud rate (L70 module supports 9600bps by default), then click the button 'Create Connection'. From the PowerGPS window, user can view CNR message, time, position, speed, precision and so on. Explanations are listed in Table 5. L70_EVB_User Guide Confidential / Released 18 / 24 GPS Module L70 EVB User Guide Table 5: Explanations of PowerGPS Window Icon Explanation SV with PRN 65. If the position of SV is near to the centre of the Sky View, the elevation angle of SV is close to 90°. Dark blue means this satellite is in tracking. Light blue means this satellite is not in tracking. The CNR of PRN 25 is 31dB/Hz. Light blue column means the l navigation data of this satellite is in use. Quecteential The CNR of PRN 70 is 32dB/Hz. White column means the fid navigation data of this satellite is not in use. The range of GLONASS SVID is 65-96. ConUTC time Latitude degree longitude degree Positing fix Using the number of satellites Horizontal Dilution of Precision Altitude based on WGS84 Datum UTC date Fix type: No-Fix, 3D or 2D SPS Using satellite Position Dilution of Precision Vertical Dilution of Precision Speed of receiver L70_EVB_User Guide Confidential / Released 19 / 24 GPS Module L70 EVB User Guide PMTK Command You can send PMTK command by PowerGPS. The format of PMTK command is included only characters between „$‟ and „*‟, for example: PMTK869,0. Quectenl tial Figure13:MTKCommand e Automatic TTFF Testing fid This tool allows you to measure the TTFF (Time to First Fix) under different testing conditions. You can choose to test the TTFF from full start, cold start, warm start and hot start and the number of tests can be n chosen from 1, 10, 20, 100, 1000 and 10000. Click on the Run button to start the test and it can be Co stopped by clicking on the Stop button. The configuration is as below: Start 'MTK' menu, and click 'Static TTFF Testing', then 'Static TTFF Testing' as shown below: L70_EVB_User Guide Confidential / Released 20 / 24 GPS Module L70 EVB User Guide Queficdteenl tial Figure14:StaticTTFFTesting n Click 'Set reference point', choose 'Reference location'. After start positioning, click 'Use Mean Position', Co then click 'OK'. As shown in the screenshots below: L70_EVB_User Guide Confidential / Released 21 / 24 GPS Module L70 EVB User Guide uectel tial Figure 15: Static TTFF Testing Configuration Options Q n Click 'Config', set 'TTFF Time- out (sec)', then click 'OK', shown as below: e In generally, if you choose hot start, 'TTFF Time-out (sec)' sets 10s. If you choose warm start, the 'TTFF Time-out (sec)' sets 50s. If you choose cold start, the 'TTFF Time-out (sec)' sets 100s. 'TTFF Time–out Confid (sec)' can help you judge TTFF and save time. L70_EVB_User Guide Confidential / Released 22 / 24 GPS Module L70 EVB User Guide Queficdteenl tial Figure16:StaticTTFFTestingConfiguration on The above operation is completed. Click on the Run button to start the test and it can be stopped by C clicking Stop button. After finishing the testing, you can see the testing result charts. Of course, the result also will be stored in the tool installation path, and you can view the corresponding log. L70_EVB_User Guide Confidential / Released 23 / 24 GPS Module L70 EVB User Guide 7 Appendix A Reference Table 6: Reference SN Document name Remark [1] L70_Hardware_Design L70 Hardware Design [2] L70_Protocol_Specification L70 Protocol Specification l [3] L70_Reference Design L70 Reference Design cte l Table 7: Abbreviations ue tia Abbreviation Q n CNR e GPS fid LED PPS n PRN Co SPS Description Carrier-to-Noise Ratio Global Positioning System Light Emitting Diode Pulse Per Second Pseudorandom Noise Standard Positioning Service SV Satellite Vehicle UART Universal Asynchronous Receiver & Transmitter UTC Universal Time Coordinated WGS84 World Geodetic System 1984 L70_EVB_User Guide Confidential / Released 24 / 24

L70-R Series EVB User Guide GPS Module Series Rev. L70-R_Series_EVB_User_Guide_V2.0 Date: 2016-06-01 www.quectel.com GPS Module Series L70-R Series EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx tel GENERAL NOTES QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION c l PROVIDED IS BASED UPON CUSTOMERS‟ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT ue tia 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 Q n CHANGE WITHOUT PRIOR NOTICE. fide COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS n DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS o ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL C OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. L70-R_Series_EVB_User Guide Confidential / Released 1 / 24 GPS Module Series L70-R Series EVB User Guide About the Document History Revision 1.0 2.0 Date 2014-05-07 CQouneficdteenl tial 2016-06-01 Author Ada LI Connie ZHOU Description Initial 1. Incorporated related information of L70-RL 2. Changed the document name from Quectel_L70-R_EVB_User_Guide to Quectel_L70-R_Series_EVB_User_ Guide L70-R_Series_EVB_User Guide Confidential / Released 2 / 24 GPS Module Series L70-R Series EVB User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 2 Introduction to L70-R Series EVB Kit ................................................................................................ 7 2.1. Top and Bottom View .................................................................................................................. 7 2.2. EVB Accessories......................................................................................................................... 9 3 4 5 6 7 Interface Application ......................................................................................................................... 10 3.1. USB Interface............................................................................................................................ 10 3.2. UART Interface.......................................................................................................................... 11 3.3. Antenna Interface...................................................................................................................... 11 l 3.4. Switches and Buttons ............................................................................................................... 13 te 3.5. Operating Status LEDs ............................................................................................................. 14 3.6. Test Points................................................................................................................................. 15 c l EVB and Accessories ........................................................................................................................ 16 ue tia Install Device Driver........................................................................................................................... 17 Starting PowerGPS ............................................................................................................................ 18 CQonfiden Appendix A References.....................................................................................................................24 L70-R_Series_EVB_User Guide Confidential / Released 3 / 24 GPS Module Series L70-R Series EVB User Guide Table Index TABLE 1: PINS OF UART PORT ................................................................................................................11 TABLE 2: SWITCHES AND BUTTONS ..................................................................................................... 13 TABLE 3: OPERATING STATUS LEDS ..................................................................................................... 14 TABLE 4: PINS OF J106 ............................................................................................................................ 15 TABLE 5: EXPLANATIONS OF POWERGPS WINDOW .......................................................................... 19 TABLE 6: REFERENCES........................................................................................................................... 24 TABLE 7: ABBREVIATIONS ...................................................................................................................... 24 CQouneficdteenl tial L70-R_Series_EVB_User Guide Confidential / Released 4 / 24 GPS Module Series L70-R Series EVB User Guide Figure Index FIGURE 1: EVB TOP VIEW ......................................................................................................................... 7 FIGURE 2: EVB BOTTOM VIEW ................................................................................................................. 8 FIGURE 3: EVB ACCESSORIES ................................................................................................................ 9 FIGURE 4: MICRO-USB INTERFACE....................................................................................................... 10 FIGURE 5: UART INTERFACE...................................................................................................................11 FIGURE 6: ANTENNA INTERFACE .......................................................................................................... 12 FIGURE 7: LNA LAYOUT........................................................................................................................... 12 FIGURE 8: SWITCHES AND BUTTONS................................................................................................... 13 FIGURE 9: OPERATING STATUS LEDS .................................................................................................. 14 FIGURE 10: TEST POINTS J106 .............................................................................................................. 15 FIGURE 11: EVB AND ACCESSORY EQUIPMENTS............................................................................... 16 FIGURE 12: POWERGPS TOOL............................................................................................................... 18 FIGURE 13: MTK COMMAND ................................................................................................................... 20 l FIGURE 14: STATIC TTFF TESTING........................................................................................................ 21 FIGURE 15: STATIC TTFF TESTING CONFIGURATION OPTIONS ....................................................... 22 CQouneficdteential FIGURE 16: STATIC TTFF TESTING CONFIGURATION.........................................................................23 L70-R_Series_EVB_User Guide Confidential / Released 5 / 24 GPS Module Series L70-R Series EVB User Guide 1 Introduction This document defines and specifies the usage of L70-R series EVB (Evaluation Board). You can get useful information about L70-R series EVB and GPS demo tool from this document. L70-R series EVB includes L70-R and L70-RL versions. L70-RL, which comes with a built-in LNA, provides better performance than L70-R in weak signal areas. CQouneficdteenl tial L70-R_Series_EVB_User Guide Confidential / Released 6 / 24 GPS Module Series L70-R Series EVB User Guide 2 Introduction to L70-R Series EVB Kit 2.1. Top and Bottom View L70-R series EVB includes L70-R and L70-RL versions. The following illustrates the top and bottom view of the EVB, by taking L70-R as the example. tel C c l B D E ue tia A Q n J Confide I F G H Figure 1: Top View of L70-R EVB L70-R_Series_EVB_User Guide Confidential / Released 7 / 24 GPS Module Series L70-R Series EVB User Guide E F A G J ctel l Figure 2: Bottom View of L70-R EVB ue tia A: UARTport Q n B: Serial port alternation switch C: RESET button e D: POWER switch fid E: Micro-USB port F: Indication LEDs G: Antenna interface H: L70-R module (it is L70-RL module in L70-RL EVB) n I: STANDBY switch Co J: Test points L70-R_Series_EVB_User Guide Confidential / Released 8 / 24 2.2. EVB Accessories GPS Module Series L70-R Series EVB User Guide B A Quectenl tial Figure 3: EVB Accessories e A: USB cable Confid B: GPS active antenna (3.3V) L70-R_Series_EVB_User Guide Confidential / Released 9 / 24 GPS Module Series L70-R Series EVB User Guide 3 Interface Application 3.1. USB Interface CQouneficdteenl tial Figure4:Micro-USBInterface The main power is supplied via Micro-USB interface. Quectel provides two ways for data communication: Micro-USB and UART interface which are controlled by serial port alternation switch (S2). Both RS232 and Micro-USB cable are necessary, if you want to use UART to output NEMA. So the easiest way is to use Micro-USB cable which is able to provide the power and also output NEMA. You can make alternation between UART port and Micro-USB interface via switch (S2). NOTE If you want to use PowerGPS Tool, UART interface is recommended for data communication. L70-R_Series_EVB_User Guide Confidential / Released 10 / 24 3.2. UART Interface GPS Module Series L70-R Series EVB User Guide Quectenl tial Table1:PinsofUARTPort e Pin No. fid 2 n 3 Co 5 Signal RXD TXD GND Figure 5: UART Interface I/O Description I Receive data O Transmit data GND 3.3. Antenna Interface L70-R series EVB includes L70-R and L70-RL versions. The following illustrates the antenna interface and LNA layout of the EVB, by taking L76 as the example. L70-R_Series_EVB_User Guide Confidential / Released 11 / 24 GPS Module Series L70-R Series EVB User Guide Antenna uectel tial Figure 6: L76-R EVB Antenna Interface CQonfidenC109 R118 Figure 7: L76-R EVB LNA Layout Both active antenna and passive antenna can be selected as the external antenna. Please note that the LNA is installed in the EVB by default, so you have to move C109 to R112 and R118 to R105, when you L70-R_Series_EVB_User Guide Confidential / Released 12 / 24 want to remove the LNA for test. GPS Module Series L70-R Series EVB User Guide NOTE There is a built-in LNA in L70-RL module, so LNA is not designed into the L70-RL EVB. 3.4. Switches and Buttons L70-R series EVB includes L70-R and L70-RL versions. The following illustrates the switches and buttons of the EVB, by taking L70-R as the example. l K1 S1 te S2 Quec ntial S3 Confide Figure 8: L70-R EVB Switches and Buttons Table 2: Switches and Buttons Part Name I/O Description S1 POWER I Serial port S2 I alternation switch Control power supply via Micro-USB. QUECTEL EVB supplies two communicative ways: Micro-USB and UART which are controlled by switch. L70-R_Series_EVB_User Guide Confidential / Released 13 / 24 S3 STANDBY I K1 RESET I 3.5. Operating Status LEDs GPS Module Series L70-R Series EVB User Guide The module will enter into standby mode when switching from OFF to ON, and exit from standby mode in the opposite operation. Press and release this button, then the module will reset. Queficdteenl tial Figure9:OperatingStatusLEDs n Table 3: Operating Status LEDs Co Part Name I/O Description Flash: turn on successfully. Micro-USB or UART1 L1 TXD1 O port can output messages. Extinct: fail to turn on the module. L2 1PPS Flash: successful fix. The frequency is 1Hz. O Extinct: no fix. L70-R_Series_EVB_User Guide Confidential / Released 14 / 24 3.6. Test Points GPS Module Series L70-R Series EVB User Guide 5432 1 6 7 8 9 10 l Figure 10: Test Points J106 cte l Table 4: Pins of J106 ue tia Pin Signal I/O 1/10 GND Q n 2 STANDBY I e 3 1PPS O fid 4 AADET_N I n 5 32K/DRIN o 6 TIMER(FORCE_ON) C 7 RESET I Description Ground Enter or exit standby mode 1 pulse per second Reserved Reserved Reserved System reset 8 TXD1 O Transmit data 9 RXD1 I Receive data L70-R_Series_EVB_User Guide Confidential / Released 15 / 24 GPS Module Series L70-R Series EVB User Guide 4 EVB and Accessories L70-R series EVB and its accessories are shown in Figure 11. CQouneficdteenl tial Figure11:EVBandAccessories L70-R_Series_EVB_User Guide Confidential / Released 16 / 24 GPS Module Series L70-R Series EVB User Guide 5 Install Device Driver Please note that you need to install the driver of Micro-USB when use Micro-USB for data communication. The driver has been stored in our FTP server. The driver of CP210x also can be downloaded from internet. The download path in our FTP server is as below: Overseas customers: /d:/FTP/OC/Overseas_Technical/Overseas_Module Official Documents/GNSS Module/Common/04 Tool Kit/ GNSS_EVB_Micro-USB_Driver_CP210x. Domestic customers: /d:/FTP/CC/Domestic_Technical/Domestic_Module Official Documents/GNSS Module/Common/04 Tool CQouneficdteenl tial Kit/ GNSS_EVB_Micro-USB_Driver_CP210x. L70-R_Series_EVB_User Guide Confidential / Released 17 / 24 GPS Module Series L70-R Series EVB User Guide 6 Starting PowerGPS The PowerGPS version is V2.2.0. The PowerGPS tool can help you to view the status of GPS&GLONASS receiver conveniently. When the tool is opened, the following window will be displayed: Queficdteenl tial Figure12:PowerGPSTool After EVB accessories are assembled, turn on the module and start up the PowerGPS. Select a correct n COM port and baud rate (L70-R series module supports 9600bps by default), and then click the button Co 'Create Connection'. From the PowerGPS window, you can view CNR message, time, position, speed, precision, and so on. Explanations are listed in Table 5. L70-R_Series_EVB_User Guide Confidential / Released 18 / 24 GPS Module Series L70-R Series EVB User Guide Table 5: Explanations of PowerGPS Window Icon Explanation SV with PRN 65. If the position of SV is near to the centre of the Sky View, the elevation angle of SV is close to 90°. Dark blue means this satellite is in tracking. Light blue means this satellite is not in tracking. The CNR of PRN 25 is 31dBHz. Light blue column means the navigation data of this satellite is in use. uectel tial The CNR of PRN 70 is 32dBHz. White column means the Q n navigation data of this satellite is not in use. The range of GLONASS SVID is 65-96. nfide UTC time Latitude degree oLongitude degree C Positing fix The number of satellites being used Horizontal Dilution of Precision Altitude based on WGS84 Datum UTC date Fixing mode: No-Fix, 3D or 2D SPS Satellite being used Position Dilution of Precision Vertical Dilution of Precision Speed of receiver L70-R_Series_EVB_User Guide Confidential / Released 19 / 24 GPS Module Series L70-R Series EVB User Guide  PMTK Command You can send PMTK command by PowerGPS. The format of PMTK command includes only characters between „$‟ and „*‟, for example: PMTK869,0 ctel l Figure 13: MTK Command ue tia  Automatic TTFF Testing Q n This tool allows you to measure the TTFF (Time to First Fix) under different testing conditions. You can e choose to test the TTFF in full start, cold start, warm start and hot start, and the number of tests can be fid chosen from 1, 10, 20, 100, 1000 and 10000. Click on the Run button to start the test and it can be stopped by clicking on the Stop button. The following are the detailed configuration steps during TTFF testing: on 1. Start 'MTK' menu, and then click 'Static TTFF Testing' to enter Automatic TTFF Testing as shown C below: L70-R_Series_EVB_User Guide Confidential / Released 20 / 24 GPS Module Series L70-R Series EVB User Guide Quectenl tial Figure 14: Static TTFF Testing fide 2. Click 'Set reference point', and choose 'Reference location'. After start positioning, click 'Use Con Mean Position', and then click 'OK', as shown in the screenshots below: L70-R_Series_EVB_User Guide Confidential / Released 21 / 24 GPS Module Series L70-R Series EVB User Guide tel Figure 15: Static TTFF Testing Configuration Options uec tial 3. Click 'Config', set 'TTFF Time- out (sec)', and then click 'OK', as shown below: In general, if you choose hot start, 'TTFF Time-out (sec)' is recommended to be set as10s. If you choose Q n warm start, the 'TTFF Time-out (sec)' can be set as 50s. If you choose cold start, the 'TTFF Time-out Confide (sec)' can be set as 100s. 'TTFF Time–out (sec)' can help you to judge TTFF and save time. L70-R_Series_EVB_User Guide Confidential / Released 22 / 24 GPS Module Series L70-R Series EVB User Guide Quecteenl tial Figure 16: Static TTFF Testing Configuration fid 4. After the above operations have been completed, click on the Run button to start the test and it can be stopped by clicking Stop button. on 5. After finishing the testing, you can see the testing result charts. Of course, the result also will be C stored in the tool installation path, and you can view the corresponding log. L70-R_Series_EVB_User Guide Confidential / Released 23 / 24 GPS Module Series L70-R Series EVB User Guide 7 Appendix A References Table 6: References SN Document Name Remark [1] Quectel_L70-R_Series_Hardware_Design L70-R Series Hardware Design [2] Quectel_L70-R_Series_Protocol_Specification L70-R Series Protocol Specification [3] Quectel_L70-R_Series_Reference Design L70-R Series Reference Design tel Table 7: Abbreviations c l Abbreviation ue tia CNR GPS Q n LED e PPS fid PRN SPS on SV C UART Description Carrier-to-Noise Ratio Global Positioning System Light Emitting Diode Pulse Per Second Pseudorandom Noise Standard Positioning Service Satellite Vehicle Universal Asynchronous Receiver & Transmitter UTC Universal Time Coordinated WGS84 World Geodetic System 1984 L70-R_Series_EVB_User Guide Confidential / Released 24 / 24

L80 EVB User Guide GPS Module Series Rev. L80_EVB_User_Guide_V1.0 Date: 2013-07-25 www.quectel.com GPS Module L80 EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarter: Quectel Wireless Solutions Co., Ltd. Room 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx tel GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION PROVIDED IS BASED UPON CUSTOMERS‟ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT e tia 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 u n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN ARE SUBJECT TO CHANGE WITHOUT PRIOR NOTICE. Q fide COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS n DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o 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 C OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2013. All rights reserved. L80_EVB_User_Guide Confidential / Released 1 / 20 GPS Module L80 EVB User Guide About the document History Revision CQouneficdteenl tial 1.0 Date 2013-07-25 Author Ada LI Description Initial L80_EVB_User_Guide Confidential / Released 2 / 20 GPS Module L80 EVB User Guide Contents About the document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 2 Introduction to EVB Kit ....................................................................................................................... 7 2.1. EVB Top and Bottom View .......................................................................................................... 7 2.2. EVB Accessories......................................................................................................................... 9 3 4 5 6 7 Interface Application ......................................................................................................................... 10 3.1. USB Interface............................................................................................................................ 10 3.2. UART Interface.......................................................................................................................... 11 3.3. Antenna Interface...................................................................................................................... 12 l 3.4. Switches and Buttons ............................................................................................................... 13 te 3.5. Test Point................................................................................................................................... 14 c l EVB and Accessories ........................................................................................................................ 15 Install Device Driver........................................................................................................................... 16 e tia Starting PowerGPS ............................................................................................................................ 17 CQounfiden Appendix A Reference.......................................................................................................................20 L80_EVB_User_Guide Confidential / Released 3 / 20 GPS Module L80 EVB User Guide Table Index TABLE 1: EVB BOTTOM VIEW ........................................................................................................................... 8 TABLE 2: EVB ACCESSORIES .......................................................................................................................... 9 TABLE 3: PINS OF UART PORT .......................................................................................................................11 TABLE 4: SWITCHES AND BUTTONS............................................................................................................. 13 TABLE 5: THE DESCRIPTION OF TEST POINTS ........................................................................................... 14 TABLE 6: EXPLANATIONS OF POWERGPS WINDOW .................................................................................. 18 TABLE 7: REFERENCE .................................................................................................................................... 20 TABLE 8: ABBREVIATIONS .............................................................................................................................. 20 CQouneficdteenl tial L80_EVB_User_Guide Confidential / Released 4 / 20 GPS Module L80 EVB User Guide Figure Index FIGURE 1: EVB TOP VIEW ................................................................................................................................ 7 FIGURE 2: EVB BOTTOM VIEW ........................................................................................................................ 8 FIGURE 3: EVB ACCESSORIES ........................................................................................................................ 9 FIGURE 4: MICRO-USB INTERFACE .............................................................................................................. 10 FIGURE 5: UART INTERFACE ..........................................................................................................................11 FIGURE 6: ANTENNA INTERFACE .................................................................................................................. 12 FIGURE 7: SWITCHES AND BUTTONS .......................................................................................................... 13 FIGURE 8: TEST POINTS................................................................................................................................. 14 FIGURE 9: EVB AND ACCESSORY EQUIPMENTS ........................................................................................ 15 FIGURE 10: POWERGPS TOOL ...................................................................................................................... 17 CQouneficdteenl tial FIGURE 11: COM PORT AND BAUD................................................................................................................ 17 L80_EVB_User_Guide Confidential / Released 5 / 20 GPS Module L80 EVB User Guide 1 Introduction This document defines and specifies the usage of L80 EVB (Evaluation Board). You can get useful information about L80 EVB and GPS demo tool from this document. CQouneficdteenl tial L80_EVB_User_Guide Confidential / Released 6 / 20 GPS Module L80 EVB User Guide 2 Introduction to EVB Kit 2.1. EVB Top and Bottom View CQouneficdteenl tial Figure1:EVBTopView L80_EVB_User_Guide Confidential / Released 7 / 20 GPS Module L80 EVB User Guide ectel tial Figure2:EVBBottomView u n Table 1: EVB Bottom View Q e Index fid A B n C Co D Description UART port Serial port alternation switch RESET button FORCE_ON E Micro-USB port F POWER switch G PATCH Antenna H L80 Module I Active Antenna interface L80_EVB_User_Guide Confidential / Released 8 / 20 J Test points 2.2. EVB Accessories GPS Module L80 EVB User Guide Queficdteenl tial Figure3:EVBAccessories Table 2: EVB Accessories n Index Co A Description USB cable L80_EVB_User_Guide Confidential / Released 9 / 20 GPS Module L80 EVB User Guide 3 Interface Application 3.1. USB Interface CQouneficdteenl tial Figure4:Micro-USBInterface The main power is supplied via Micro-USB interface. Quectel provides two ways for data communication: Micro-USB and UART interface which are controlled by serial port alternation switch (S401). Both of RS232 and Micro-USB cable are necessary, if you want to use UART in order to output NEMA. So the easy way is that use Micro-USB cable which both provides the power and output NEMA. You can make alternation between UART port and Micro-USB interface via switch (S401). L80_EVB_User_Guide Confidential / Released 10 / 20 3.2. UART Interface GPS Module L80 EVB User Guide uectenl tial Table3:PinsofUARTPort Q e Pin Signal fid 2 RXD 3 TXD Con 5 GND Figure 5: UART Interface I/O Description I Receive data O Transmit data GND L80_EVB_User_Guide Confidential / Released 11 / 20 3.3. Antenna Interface GPS Module L80 EVB User Guide CQouneficdteenl tial Figure6:AntennaInterface L80_EVB_User_Guide Confidential / Released 12 / 20 3.4. Switches and Buttons GPS Module L80 EVB User Guide uectenl tial Figure7:SwitchesandButtons Q e Table 4: Switches and Buttons fid Part Name I/O Description QUECTEL EVB supplies two communicative n Serial port alternation S1 I ways: Micro-USB and UART which are controlled switch o by switch. C S2 POWER I Control power supply via Micro-USB. K1 FORCE_ON Logic high will force module to be waked up from backup mode. K2 RESET Press and release this button, then the module I will reset. L80_EVB_User_Guide Confidential / Released 13 / 20 3.5. Test Point GPS Module L80 EVB User Guide ctel l Figure8:TestPoints e tia Table 5: The Description of Test Points u n Pin Signal I/O Q e 1 TXD1 O fid 2 RXD1 I n 3 RESET I o 4/6 GND C 5 1PPS O Description Transmit data Receive data System reset Ground 1 pulse per second 7 TIMER Logic high will force module to be waked up from backup mode. Keep this pin open O or pulled low before entering into backup mode. If unused, keep this pin open. L80_EVB_User_Guide Confidential / Released 14 / 20 GPS Module L80 EVB User Guide 4 EVB and Accessories The EVB and its accessories are equipped as shown in Figure 9. CQouneficdteenl tial Figure 9: EVB and Accessory Equipments NOTE The GPS active antenna is not included in L80EVB-KIT. It can be purchased separately by Quectel Sales Team, if it is necessary for your application. L80_EVB_User_Guide Confidential / Released 15 / 20 GPS Module L80 EVB User Guide 5 Install Device Driver Please note that you need to install the driver of Micro-USB, when using Micro-USB for data communication. The driver has been stored in our FTP server. The driver of CP210x also can be downloaded from internet. The download path of our FTP server is shown as below: Overseas Domestic customer: /d:/FTP/OC/Overseas_Technical/Overseas_Module Official Documents/GNSS Module/Common/04 Tool Kit/ GNSS_EVB_Micro-USB_Driver_CP210x. customer: /d:/FTP/CC/Domestic_Technical/Domestic_Module Official Documents/GNSS CQouneficdteenl tial Module/Common/04ToolKit/GNSS_EVB_Micro-USB_Driver_CP210x. L80_EVB_User_Guide Confidential / Released 16 / 20 GPS Module L80 EVB User Guide 6 Starting PowerGPS The PowerGPS version is V2.2.0. The PowerGPS tool can help user to view the status of GPS receiver conveniently. When the tool is opened, the following window will be displayed: Queficdteenl tial Figure10:PowerGPSTool n After EVB accessories are assembled, turn on the module and start up the PowerGPS. Select a correct o COM port and baud rate (L80 module supports 9600bps by default), then click the button 'Create C Connection'. Figure 11: COM Port and Baud From the PowerGPS window, user can view CNR message, time, position, speed, precision and so on. Explanations are listed in Table 6. L80_EVB_User_Guide Confidential / Released 17 / 20 GPS Module L80 EVB User Guide Table 6: Explanations of PowerGPS Window Icon Explanation SV with PRN 20. If the position of SV is near to the centre of the Sky View, the elevation angle of SV is close to 90°. Dark blue means this satellite is in tracking. Light blue means this satellite is not in tracking. The CNR of PRN 27 is 48dB/Hz. Light blue column means the navigation data of this satellite is in use. ectel tial The CNR of PRN 50 is 40dB/Hz. White column means the navigation data of this satellite is not in use. Qu en UTCtime Latitude degree fid longitude degree Positing fix Using the number of satellites nHorizontal Dilution of Precision Altitude based on WGS84 Datum oUTC date C Fix type: No-Fix, 3D or 2D SPS Using satellite Position Dilution of Precision Vertical Dilution of Precision Speed of receiver You can send PMTK command by PowerGPS. The format of PMTK command is included only characters between „$‟ and „*‟, for example: PMTK869,0. L80_EVB_User_Guide Confidential / Released 18 / 20 GPS Module L80 EVB User Guide CQouneficdteenl tial Figure12:MTKCommand L80_EVB_User_Guide Confidential / Released 19 / 20 GPS Module L80 EVB User Guide 7 Appendix A Reference Table 7: Reference SN Document name Remark [1] L80_Hardware_Design L80 Hardware Design [2] L80_Protocol_Specification L80 Protocol Specification [3] L80_Reference Design L80 Reference Design tel Table 8: Abbreviations c l Abbreviation Description e tia CNR Carrier-to-Noise Ratio u n GPS Global Positioning System Q e PPS Pulse Per Second fid PRN Pseudorandom Noise SPS Standard Positioning Service n SV Satellite Vehicle o UART Universal Asynchronous Receiver & Transmitter C UTC Universal Time Coordinated WGS84 World Geodetic System 1984 L80_EVB_User_Guide Confidential / Released 20 / 20

L26 EVB User Guide GNSS Module Series Rev. L26_EVB_User_Guide_V1.0 Date: 2013-04-26 www.quectel.com GNSS Module L26 EVB User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarter: Quectel Wireless Solutions Co., Ltd. Room 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/quectel_sales_office.html l For technical support, to report documentation errors, please visit: http://www.quectel.com/tecsupport.aspx cte l GENERAL NOTES ue tia QUECTEL OFFERS THIS 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 Q n MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT e ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN ARE SUBJECT TO fid CHANGE WITHOUT PRIOR NOTICE. n COPYRIGHT o THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS C DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS 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. 2013. All rights reserved. L26_EVB_User Guide Confidential / Released 1 / 22 GNSS Module L26 EVB User Guide About the document History Revision CQouneficdteenl tial 1.0 Date 2013-04-22 Author Ada LI Description Initial L26_EVB_User Guide Confidential / Released 2 / 22 GNSS Module L26 EVB User Guide Contents About the document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 2 Introduction to EVB Kit ....................................................................................................................... 7 3 4 5 6 7 2.1. EVB Top and Bottom View .......................................................................................................... 7 2.2. EVB Accessories......................................................................................................................... 9 Interface Application ......................................................................................................................... 10 l 3.1. USB Interface............................................................................................................................ 10 3.2. UART Interface.......................................................................................................................... 11 te 3.3. Antenna Interface...................................................................................................................... 12 3.4. Switches and Buttons ............................................................................................................... 12 c l 3.5. Operating Status LEDs ............................................................................................................. 14 ue tia 3.6. Test Points................................................................................................................................. 15 EVB and Accessories ........................................................................................................................ 17 Q n Install Device Driver........................................................................................................................... 18 e Starting PowerGPS ............................................................................................................................ 19 Confid Appendix A Reference....................................................................................................................... 22 L26_EVB_User Guide Confidential / Released 3 / 22 GNSS Module L26 EVB User Guide Table Index TABLE 1: PINS OF UART PORT .......................................................................................................................11 TABLE 2: SWITCHES AND BUTTONS............................................................................................................. 13 TABLE 3: OPERATING STATUS LEDS ............................................................................................................ 14 TABLE 4: PINS OF J106 ................................................................................................................................... 15 TABLE 5: EXPLANATIONS OF POWERGPS WINDOW .................................................................................. 20 TABLE 6: REFERENCE .................................................................................................................................... 22 TABLE 7: ABBREVIATIONS .............................................................................................................................. 22 CQouneficdteenl tial L26_EVB_User Guide Confidential / Released 4 / 22 GNSS Module L26 EVB User Guide Figure Index FIGURE 1: EVB TOP VIEW ................................................................................................................................ 7 FIGURE 2: EVB BOTTOM VIEW ........................................................................................................................ 8 FIGURE 3: EVB ACCESSORIES ........................................................................................................................ 9 FIGURE 4: MICRO-USB INTERFACE .............................................................................................................. 10 FIGURE 5: UART INTERFACE ..........................................................................................................................11 FIGURE 6: ANTENNA INTERFACE .................................................................................................................. 12 FIGURE 7: LNA LAYOUT .................................................................................................................................. 12 FIGURE 8: SWITCHES AND BUTTONS .......................................................................................................... 13 FIGURE 9: OPERATING STATUS LEDS .......................................................................................................... 14 FIGURE 10: TEST POINTS J106...................................................................................................................... 15 FIGURE 11: EVB AND ACCESSORY EQUIPMENTS ...................................................................................... 17 l FIGURE 12: POWERGPS TOOL ...................................................................................................................... 19 te FIGURE 13: MTK COMMAND .......................................................................................................................... 21 FIGURE 14: STATIC TTFF TESTING ............................................................................................................... 21 c l FIGURE 15: STATIC TTFF TESTING CONFIGURATION OPTIONS ............................................................... 21 CQounefidentia FIGURE 16: STATIC TTFF TESTING CONFIGURATION ................................................................................ 21 L26_EVB_User Guide Confidential / Released 5 / 22 GNSS Module L26 EVB User Guide 1 Introduction This document defines and specifies the usage of L26 EVB (Evaluation Board). You can get useful information about L26 EVB and GNSS demo tool from this document. CQouneficdteenl tial L26_EVB_User Guide Confidential / Released 6 / 22 GNSS Module L26 EVB User Guide 2 Introduction to EVB Kit 2.1. EVB Top and Bottom View A CQouBJnCeficDdtI eeE nl tGFiaH l Figure 1: EVB Top View L26_EVB_User Guide Confidential / Released 7 / 22 GNSS Module L26 EVB User Guide F G A J tel H Queficdential Figure 2: EVB Bottom View n A: UART port B: Serial port alternation switch o C: RESET button C D: FORCE_ON button E: POWER switch F: Micro-USB port G: Indication LEDs H: Antenna interface I: L26 Module J: Test points L26_EVB_User Guide Confidential / Released 8 / 22 2.2. EVB Accessories GNSS Module L26 EVB User Guide CQouneficdteenl tial Figure3:EVBAccessories A: USB cable B: GNSS active antenna (3.3V) L26_EVB_User Guide Confidential / Released 9 / 22 GNSS Module L26 EVB User Guide 3 Interface Application 3.1. USB Interface CQouneficdteenl tial Figure 4: Micro-USB Interface The main power is supplied via Micro-USB interface. We provide two ways for data communication: Micro-USB and UART interface which are controlled by alternation switch (S2). Both of RS232 and Micro-USB cable are necessary, if you want to use UART to output NEMA. So the easy way is to use Micro-USB cable which both supplies the power and outputs NEMA. You can makes alternation between UART port and Micro-USB interfaces via switch (S2). L26_EVB_User Guide Confidential / Released 10 / 22 3.2. UART Interface GNSS Module L26 EVB User Guide Quectenl tial Figure5:UARTInterface fide Table 1: Pins of UART port n Pin Signal Co 2 RXD I/O Description I Receive data 3 TXD O Transmit data 5 GND GND L26_EVB_User Guide Confidential / Released 11 / 22 3.3. Antenna Interface GNSS Module L26 EVB User Guide lAntenna Queficdteential Figure 6: Antenna Interface Con 3.4. Switches and Buttons L26_EVB_User Guide Confidential / Released 12 / 22 GNSS Module L26 EVB User Guide K2 S2 K1 S1 Quecteenl tial Figure7:SwitchesandButtons fid Table 2: Switches and Buttons on Part Name I/O C S1 POWER I Description Control power supply from Micro-USB. Serial port alternation S2 I switch K1 FORCE_ON K2 RESET I Quectel EVB supplies two communicative ways: Micro-USB and UART which are controlled by switch. Press and release the button, the module will be waked up from backup mode. Press and release this button, then the module will reset. L26_EVB_User Guide Confidential / Released 13 / 22 3.5. Operating Status LEDs GNSS Module L26 EVB User Guide uectel tial Figure8:OperatingStatusLEDs Q en Table 3: Operating status LEDs fid Part Name I/O Con L1 TXD1 O Description Flash: turn on successfully, Micro-USB or UART1 port can output messages. Extinct: fail to turn on the module Flash: fix successfully, the frequency is 1Hz L2 1PPS O Extinct: no fix L26_EVB_User Guide Confidential / Released 14 / 22 3.6. Test Points GNSS Module L26 EVB User Guide 5 4 3 2 1 tel 6 7 8 9 10 CQouneficdential Table4:PinsofJ106 Figure 9: Test Points J106 Pin Signal I/O Description 1/10 GND Ground 2 STANDBY Reserved 3 1PPS O 1 pulse per second 4 AADET_N I Active antenna open circuit detection 5 32K/DRIN 6 FORCE_ON Reserved Logic high will force module to be waked up from backup mode. Keep this pin open or pulled low L26_EVB_User Guide Confidential / Released 15 / 22 7 RESET I 8 TXD1 O 9 RXD1 I GNSS Module L26 EVB User Guide before entering into backup mode. If unused, keep this pin open. System reset Transmit data Receive data CQouneficdteenl tial L26_EVB_User Guide Confidential / Released 16 / 22 GNSS Module L26 EVB User Guide 4 EVB and Accessories The EVB and its accessories are equipped as shown in Figure 10. CQouneficdteenl tial Figure 7: EVB and Accessory Equipments L26_EVB_User Guide Confidential / Released 17 / 22 GNSS Module L26 EVB User Guide 5 Install Device Driver Before using Micro-USB port, please install the driver of Micro-USB. Customer can login our FTP for download device driver. Overseas FTP path is /d:/FTP/OC/Overseas_Technical/Overseas_Module Official Documents/GNSS Module/Common/04 Tool Kit/ GNSS_EVB_Micro-USB_Driver_CP210x. Domestic FTP path is /d:/FTP/CC/Domestic_Technical/Domestic_Module Official Documents/GNSS CQouneficdteenl tial Module/Common/04ToolKit/GNSS_EVB_Micro-USB_Driver_CP210x. L26_EVB_User Guide Confidential / Released 18 / 22 GNSS Module L26 EVB User Guide 6 Start PowerGPS The PowerGPS version is V2.2.0. The PowerGPS tool can help user to view the status of GPS&GLONASS receiver conveniently. When the tool is opened, the following window will be displayed: Queficdteenl tial Figure8:PowerGPSTool on After EVB accessories are assembled, turn on the module and start up the PowerGPS. Select a correct C COM port and baud rate (L26 module supports 9600bps by default), then click the button 'Create Connection'. From the PowerGPS window, user can view CNR message, time, position, speed, precision and so on. Explanations are listed in Table 5. L26_EVB_User Guide Confidential / Released 19 / 22 GNSS Module L26 EVB User Guide Table 5: Explanations of PowerGPS Window Icon Explanation SV with PRN 65. If the position of SV is near to the centre of the Sky View, the elevation angle of SV is close to 90°. Dark blue means this satellite is in tracking. Light blue means this satellite is not in tracking. The CNR of PRN 25 is 31dB/Hz. Light blue column means the l navigation data of this satellite is in use. Quecteential The CNR of PRN 70 is 32dB/Hz. White column means the fid navigation data of this satellite is not in use. The range of GLONASS SVID is 65-96. ConUTC time Latitude degree longitude degree Positing fix Using the number of satellites Horizontal Dilution of Precision Altitude based on WGS84 Datum UTC date Fix type: No-Fix, 3D or 2D SPS Using satellite Position Dilution of Precision Vertical Dilution of Precision Speed of receiver L26_EVB_User Guide Confidential / Released 20 / 22 GNSS Module L26 EVB User Guide PMTK Command You can send PMTK command by PowerGPS. The format of PMTK command is included only characters between „$‟ and „*‟, for example: PMTK869,0. CQouneficdteenl tial Figure9:MTKCommand L26_EVB_User Guide Confidential / Released 21 / 22 GNSS Module L26 EVB User Guide 7 Appendix A Reference Table 6: Reference SN Document name Remark [1] L26_Hardware_Design L26 Hardware Design [2] L26_Protocol_Specification L26 Protocol Specification l [3] L26_Reference_Design L26 Reference Design cte l Table 7: Abbreviations ue tia Abbreviation Q n CNR e GPS fid GLONASS GNSS n LED Co PPS Description Carrier-to-Noise Ratio Global Positioning System Global Navigation Satellite System (The Russian GNSS) Global Navigation Satellite System Light Emitting Diode Pulse Per Second PRN Pseudorandom Noise SPS Standard Positioning Service SV Satellite Vehicle UART Universal Asynchronous Receiver & Transmitter UTC Universal Time Coordinated WGS84 World Geodetic System 1984 L26_EVB_User Guide Confidential / Released 22 / 22

L76 系列 EVB 用户指导 GNSS 模块系列 版本：1.0 日期：2021-09-08 状态：受控文件 L76 系列 EVB 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 31 L76 系列 EVB 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 2 / 31 L76 系列 EVB 用户指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 请确保产品的使用符合国家和行业基础标准、安全标准和环境保护标准的要求，并符合 国家和特定场所对产品使用的具体规定。 请确保终端产品远离易燃易爆品。在极端供电和任何有潜在爆炸危险的（如靠近加油 站、油库、化工厂或爆炸作业场所）环境下使用电子产品可能存在安全隐患。 必须为产品提供稳定可靠的电源，并确保所有接线符合相关安全和防火法规。 在产品安装和使用过程中，必须小心处理以避免因为静电而对产品造成损坏。 上海移远通信技术股份有限公司 3 / 31 L76 系列 EVB 用户指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 L76 系列 EVB 用户指导 GNSS 模块系列 EVB 用户指导 受控文件 修订历史 版本 1.0 日期 2021-08-10 2021-09-08 描述 文档创建 受控版本 上海移远通信技术股份有限公司 4 / 31 L76 系列 EVB 用户指导 目录 安全须知 ....................................................................................................................................................... 3 关于文档 ....................................................................................................................................................... 4 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 简介 ....................................................................................................................................................... 8 2 概述 ....................................................................................................................................................... 9 2.1. EVB 成套配件............................................................................................................................. 9 2.2. EVB 成套配件连接示意图......................................................................................................... 10 3 接口 ..................................................................................................................................................... 11 3.1. 位号分布图 ................................................................................................................................11 3.2. EVB 接口 ...................................................................................................................................11 4 使用 QCOM 工具进行通信 .................................................................................................................. 14 4.1. 操作步骤 ................................................................................................................................... 14 5 使用 QGNSS 工具进行测试 ................................................................................................................ 16 5.1. COM 端口和波特率设置 ........................................................................................................... 16 5.1.1. 窗口界面说明................................................................................................................. 17 5.2. TTFF 测试................................................................................................................................. 19 5.3. AGNSS 设置............................................................................................................................. 21 5.3.1. 在线 AGNSS 辅助定位 .................................................................................................. 21 5.3.2. 离线 AGNSS 辅助定位 .................................................................................................. 24 6 使用 QGPSFlashTool 工具升级固件.................................................................................................. 27 7 附录 参考文档及术语缩写 ................................................................................................................... 30 上海移远通信技术股份有限公司 5 / 31 L76 系列 EVB 用户指导 表格索引 表 1：EVB 成套配件清单............................................................................................................................ 10 表 2：接口定义 ........................................................................................................................................... 12 表 3：J106 引脚描述 .................................................................................................................................. 13 表 4：QGNSS 窗口界面说明...................................................................................................................... 17 表 5：参考文档 ........................................................................................................................................... 30 表 6：术语缩写 ........................................................................................................................................... 30 上海移远通信技术股份有限公司 6 / 31 L76 系列 EVB 用户指导 图片索引 图 1：L76 系列 EVB 成套配件（配件图）.................................................................................................... 9 图 2：L76 系列 EVB 成套配件（连接示意图） .......................................................................................... 10 图 3：L76 系列 EVB 位号示意图 .................................................................................................................11 图 4：USB 端口 .......................................................................................................................................... 14 图 5：QCOM 通信端口设置界面 ................................................................................................................ 14 图 6：QCOM 界面 NMEA 语句输出 ........................................................................................................... 15 图 7：QGNSS 工具设置 ............................................................................................................................. 16 图 8：QGNSS 界面（已连接） .................................................................................................................. 17 图 9：使用 QGNSS 进行静态 TTFF 测试................................................................................................... 19 图 10：TTFF 测试设置 ............................................................................................................................... 19 图 11：AGNSS 设置 ................................................................................................................................... 20 图 12：启动或停止测试 .............................................................................................................................. 20 图 13：TTFF 测试结果 ............................................................................................................................... 21 图 14：AGNSS 方式选择 ........................................................................................................................... 21 图 15：Assistant GNSS Online 设置.......................................................................................................... 22 图 16：连接和下载 ..................................................................................................................................... 22 图 17：下载已选择的 EPO 文件 ................................................................................................................. 23 图 18：成功下载到模块 .............................................................................................................................. 23 图 19：AGNSS 方式选择 ........................................................................................................................... 24 图 20：Assistant GNSS Offline 设置.......................................................................................................... 24 图 21：连接和下载 ..................................................................................................................................... 25 图 22：下载已选择的 EPO 文件 ................................................................................................................. 25 图 23：成功下载到模块 .............................................................................................................................. 26 图 24：固件升级—步骤 1 ........................................................................................................................... 27 图 25：固件升级—步骤 2 ........................................................................................................................... 28 图 26：固件升级—步骤 3 ........................................................................................................................... 28 图 27：固件升级—步骤 4 ........................................................................................................................... 29 图 28：固件升级成功.................................................................................................................................. 29 上海移远通信技术股份有限公司 7 / 31 L76 系列 EVB 用户指导 1 简介 移远通信提供一整套 L76 系列 EVB 配件，以方便 L76 系列模块的测试和使用。本文档介绍了 L76 系 列 EVB（评估板）成套配件的基本信息，并提供了详细的 EVB 使用指导。 本文档具体分为以下几个章节： ⚫ 第二章主要介绍了 EVB 成套配件的基本信息。 ⚫ 第三章主要介绍了 EVB 的接口信息。 ⚫ 第四章主要介绍了如何使用 QCOM 工具与模块进行通信。 ⚫ 第五章主要介绍了如何使用 QGNSS 工具对模块进行测试。 ⚫ 第六章主要介绍了如何使用 QGPSFlashTool 工具对模块进行固件升级。 ⚫ 第七章是附录部分，总结了本文档中出现的参考文档和术语。 在此文档中，移远通信 L76 系列包括 L76B、L76、L76-L 和 L76-LB 模块。有关 L76-L(L)和 L76-LB(L) 的 EVB 使用指导，请参考文档 [1]。 备注 如需 EVB 原理图和 PCB 布局设计文件作为参考，请联系移远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 8 / 31 L76 系列 EVB 用户指导 2 概述 2.1. EVB 成套配件 成套配件包括：EVB 板、GNSS 有源天线、USB 连接线、铜柱和螺丝。软件工具（QCOM、QGNSS 和 QGPSFlashTool）可从移远通信官网（下载专区）下载，也可从移远通信技术支持处获取。 EVB 成套配件如下图所示，详情见表 1。 铜柱和螺丝 GNSS有源天线 USB连接线 EVB 图 1：L76 系列 EVB 成套配件（配件图） 上海移远通信技术股份有限公司 9 /31 表 1：EVB 成套配件清单 项目 EVB USB 线 GNSS 天线 说明书 其它 描述 L76 系列评估板 尺寸：60 mm × 70 mm USB 连接线 GNSS 有源天线 可联系移远通信技术支持获取天线规格书 介绍评估板与配件等详情的说明书 铜柱和螺丝 L76 系列 EVB 用户指导 数量 1 1 1 1 4对 2.2. EVB 成套配件连接示意图 EVB 成套配件连接示意图如下所示。有关如何将配件连接至 EVB 板的更多信息，请参考配件中的说 明书。 备注 图 2：L76 系列 EVB 成套配件（连接示意图） 将 GNSS 有源天线放置在可检测到卫星的户外开阔地带。 上海移远通信技术股份有限公司 10 /31 L76 系列 EVB 用户指导 3 接口 3.1. 位号分布图 L76 系列模块 EVB 的器件位号分布图如下所示。 J101 J106 天线连接器 U101 测试点 L76系列模块 S101 STANDBY开关 D101 1PPS和TXD LED指示灯 J201 Micro-USB连接器 S201 电源开关 J301 UART连接器 S301 UART USB开关 Z101 RESET按键 Z102 FORCE_ON按键 EVB版本号 图 3：L76 系列 EVB 位号分布图 3.2. EVB 接口 L76 系列 EVB 接口如下图所示。 上海移远通信技术股份有限公司 11 /31 L76 系列 EVB 用户指导 表 2：接口定义 功能 供电 用户接口 接口 J201 Micro-USB 连接器 J201 Micro-USB连接器 J301 UART连接器 射频输入 J101 天线连接器 信号指示 开关和按键 测试点 D101 LED指示灯 TXD （蓝色LED） 1PPS （红色LED） S201 电源开关 S101 STANDBY开关 (ENTER↔EXIT) S301 UART↔USB开关 Z101 复位按键 Z102 FORCE_ON按键 J106 测试点 测试点分布如下图所示： J106 引脚分配： 32K/DRIN TIMER AADET_N RESET 1PPS TXD1 描述 供电输入： ⚫ 直流电源：4.5~5.5 V，典型值：5.0 V ⚫ 电流负载能力应大于100 mA。 用于NMEA语句输出和命令输入。 用于NMEA语句输出和命令输入。 配件中的天线支持如下星系： ⚫ GPS L1 C/A ⚫ GLONASS L1 ⚫ BeiDou B1I ⚫ QZSS L1 C/A ⚫ SBAS L1 闪烁：UART TXD 有数据输出。 不亮或常亮：UART TXD 无数据输出。 闪烁：定位成功，频率为 1 Hz。 不亮：未定位。 控制EVB电源的通断。 拨至'ENTER'，模块进入Standby模式。 拨至'EXIT'，模块退出Standby模式。 用于切换模块的数据传输接口。 短按按键后释放，模块复位。 短按按键后释放，可将模块从Backup模式 唤醒。 测试点详情可参考表3。 STANDBY RXD1 GND GND 上海移远通信技术股份有限公司 12 /31 表 3：J106 引脚描述 引脚名 I/O 32K/DRIN - AADET_N - 1PPS DO STANDBY DI GND - TIMER DO RESET DI TXD DO RXD DI GND - L76 系列 EVB 用户指导 描述 不连接 不连接 一秒一个脉冲 进入或退出 Standby 模式 地 控制 GNSS 模块 ON/OFF 状态的开漏输出信号 复位模块 传输数据 接收数据 地 上海移远通信技术股份有限公司 13 /31 L76 系列 EVB 用户指导 4 使用 QCOM 工具进行通信 本章节介绍了如何使用 QCOM 工具通过 Micro-USB 接口与模块进行通信。更多有关 QCOM 工具的使 用信息，请参考文档 [2]。 4.1. 操作步骤 步骤 1：将 EVB 通过 USB 线连接至电脑，再将电源开关（S201）拨至'ON'状态，给 EVB 上电。并将 UART↔USB 开关（S301）拨至'USB'位置。 步骤 2：将提供的 USB 串口驱动安装至电脑端，在电脑的'设备管理器'界面中可看到 USB 的端口号， 如下图所示。 图 4：USB 端口 步骤 3：安装由移远通信提供的 QCOM 工具，实现电脑与 L76 系列模块之间的通信。QCOM 通信端口设 置如下图所示。 图 5：QCOM 通信端口设置界面 步骤 4：选择正确的'COM Port'（端口号如图 4 所示）和'Baudrate'（波特率，默认 9600 bps）。 步骤 5：点击'Open Port'（打开端口），如图 5 所示。与 EVB 的通信建立成功后，L76 系列模块输出的 NMEA 语句将通过 QCOM 工具显示出来，如图 6 所示。 上海移远通信技术股份有限公司 14 /31 L76 系列 EVB 用户指导 图 6：QCOM 界面 NMEA 语句输出 上海移远通信技术股份有限公司 15 /31 L76 系列 EVB 用户指导 5 使用 QGNSS 工具进行测试 本章节介绍了如何使用软件工具 QGNSS 验证 L76 系列模块的状态。更多有关 QGNSS 工具的使用信 息，请参考文档 [3]。 5.1. COM 端口和波特率设置 步骤 1：将配件连接至EVB板。 步骤 2：将 EVB 通过 USB 线连接至电脑，再将电源开关（S201）拨至'ON'状态，给 EVB 上电。并将 UART↔USB 开关（S301）拨至'USB'位置。 步骤 3：打开由移远通信提供的QGNSS工具。点击'Setting'和'Serial Port Configuration'（L76系 列模块默认支持9600 bps），具体如下图所示。 图 7：QGNSS 工具设置 步骤 4：点击 'Connect or disconnect'按钮。成功连接模块之后，QGNSS界面如下图所示。 上海移远通信技术股份有限公司 16 /31 L76 系列 EVB 用户指导 图 8：QGNSS 界面（已连接） 5.1.1. 窗口界面说明 在 QGNSS 界面中可以查看 GNSS 信息，例如 CNR 信息、时间、位置、速度和精度等。有关这些参 数的更多信息，请参考下表。 表 4：QGNSS 窗口界面说明 图标 说明 此天空视图界面显示正在被追踪的卫星信息。 左侧图标显示正在被追踪的卫星及其数量。 ⚫ BDS（BeiDou）：4 ⚫ GLO（GLONASS）：0 ⚫ GPS：11 ⚫ GAL（Galileo）：0 ⚫ QZSS：0 ⚫ NavIC：0 ⚫ SBAS：0 右侧的栅格地图显示了正在被追踪中的卫星方位。 上海移远通信技术股份有限公司 17 /31 GPS 卫星 BeiDou 卫星 GLONASS 卫星 Galileo 卫星 QZSS 卫星 IRNSS（NavIC）卫星 L76 系列 EVB 用户指导 ⚫ PRN 30 的 CNR 值是 39 dB/Hz。 ⚫ 亮色柱表示卫星的导航数据正在使用中。 ⚫ PRN 1 的 CNR 值是 21 dB/Hz。 ⚫ 浅色柱表示该卫星的导航数据未被使用。 ⚫ 经度（单位：度） ⚫ 纬度（单位：度） ⚫ 平均海拔高度（MSL，单位：m） ⚫ 椭球面高度（EPH，单位：m） ⚫ 接收机速度（单位：km/h） ⚫ 水平精度因子 ⚫ 位置精度因子 ⚫ 定位模式：包含未定位、2D 定位或 3D 定位 SPS ⚫ UTC 日期和时间 ⚫ 总时长（单位：秒） ⚫ 最新 TTFF（单位：秒） ⚫ 质量指标 ⚫ 总次数 ⚫ 定位点 ⚫ RTK 浮点解 ⚫ RTK 固定解 ⚫ CEP 95（单位：m） ⚫ RMS（单位：m） 上海移远通信技术股份有限公司 18 /31 L76 系列 EVB 用户指导 5.2. TTFF 测试 QGNSS 工具可以在下列条件进行 TTFF 测试： ⚫ 完全冷启动 ⚫ 冷启动 ⚫ 温启动 ⚫ 热启动 通过 QGNSS 工具进行 TTFF 测试的配置步骤如下： 步骤 1：点击 菜单栏中的'Tools'选项，在下拉框中选择'Static TTFF Testing'，如下图所示。 图 9：使用 QGNSS 进行静态 TTFF 测试 步骤 2：在弹出的 TTFF 界面中可选择'Restart type'（启动类型），设置'Number of tests'（测试次 数）和'TTFF Time-out'（TTFF 超时时间），如下图所示。 上海移远通信技术股份有限公司 图 10：TTFF 测试设置 19 /31 L76 系列 EVB 用户指导 步骤 3： AGNSS 功能设置可选：即可以在此步骤中设置 AGNSS，也可以在 TTFF 测试之前通过第 5.3 章 所述方式设置 AGNSS。如下图所示，点击'Set AGNSS'按钮，进入在线方式的 AGNSS 设置。 更多有关信息，请参考第 5.3.1 章。 图 11：AGNSS 设置 步骤 4：点击'Run'按钮，启动 TTFF 测试；点击'Stop'按钮，停止 TTFF 测试。 图 12：启动或停止测试 上海移远通信技术股份有限公司 20 /31 步骤 5：测试结果存储在工具安装目录中，如下图所示。 L76 系列 EVB 用户指导 图 13：TTFF 测试结果 5.3. AGNSS 设置 实现 AGNSS 辅助定位以提升 TTFF 的方式有两种：在线的 AGNSS 辅助定位（Assistant GNSS Online）和离线的 AGNSS 辅助定位（Assistant GNSS Offline）。 5.3.1. 在线 AGNSS 辅助定位 步骤 1：点击菜单栏中'AGNSS'选项，在下拉框中选择'Assistant GNSS Online'如下图所示。 图 14：AGNSS 方式选择 步骤 2：在'Assistant GNSS Online'界面中，填写 FTP 服务器信息；并根据需要设置'Time'、 'Position'和'Restart type'，并依次勾选'Time'、'Position'和'AGNSS Data'。 上海移远通信技术股份有限公司 21 /31 L76 系列 EVB 用户指导 图 15：Assistant GNSS Online 设置 步骤 3：点击'Connect'按钮，并根据需要选择相应的在线 EPO 文件，然后点击'Download selected file'按钮下载 EPO 文件。 上海移远通信技术股份有限公司 图 16：连接和下载 22 /31 L76 系列 EVB 用户指导 步骤 4：点击'Select file'按钮，选择待下载至模块的 EPO 文件，随后点击'Reset and Transfer'按 钮开始下载。如下图所示。 图 17：下载已选择的 EPO 文件 步骤 5：下载成功时，界面上将显示一个进度为 100 %绿色矩形进度条。如下图所示。 图 18：成功下载到模块 上海移远通信技术股份有限公司 23 /31 L76 系列 EVB 用户指导 5.3.2. 离线 AGNSS 辅助定位 步骤 1：点击菜单栏中的'AGNSS'选项，在下拉框中选择'Assistant GNSS Offline'，如下图所示。 图 19：AGNSS 方式选择 步骤 2：在'Assistant GNSS Offline'界面中，填写 FTP 服务器信息。 图 20：Assistant GNSS Offline 设置 步骤 3：点击'Connect'按钮，并根据需要选择离线 EPO 文件，然后点击'Download selected file' 按钮，从服务器中下载离线 EPO 文件。如下图所示。 上海移远通信技术股份有限公司 24 /31 L76 系列 EVB 用户指导 图 21：连接和下载 步骤 4：点击'Select file'按钮，选择待下载至模块的 EPO 文件，然后点击'Download to module' 按钮开始下载。如下图所示。 图 22：下载已选择的 EPO 文件 上海移远通信技术股份有限公司 25 /31 L76 系列 EVB 用户指导 步骤 5：下载成功时，界面上将显示一个进度为 100 %的绿色矩形进度条。如下图所示。 图23：成功下载到模块 上海移远通信技术股份有限公司 26 /31 L76 系列 EVB 用户指导 6 使用 QGPSFlashTool 工具升级固件 移远通信 L76 系列模块支持使用软件工具 QGPSFlashTool，可通过 UART 接口进行固件升级。更多 有关 QGPSFlashTool 工具的使用信息，请参考文档 [4]。 在进行固件升级前，首先将 EVB 通过 USB 线连接至电脑。其次，将电源开关（S201）拨至'ON' 状态，给 EVB 上电。并将 UART↔USB 开关（S301）拨至'USB'位置。 固件升级详细步骤如下： 步骤 1：打开移远通信提供的 QGPSFlashTool 工具，点击'Config'，选择'Options'，如下图所示。 图 24：固件升级—步骤 1 步骤 2：在打开的'Options'弹框界面中，设置需要使用的通道数量。在'Tool Options'下拉列表中 选择'L76'，然后点击'OK'，如下图所示。 上海移远通信技术股份有限公司 27 /31 L76 系列 EVB 用户指导 备注 图 25：固件升级—步骤 2 在'Tool Options'下拉列表中选择'L76'，适用于 L76B、L76、L76-L 和 L76-LB 模块。 步骤 3：双击'ROM file'选择框，选择相应的 ROM 文件，例如'L76BNR02A02S.bin'；然后双击'DA File'选择框，选择 DA 文件，例如'MTK_AllInOne_DA_MT3333_MP.bin'，如下图所示。 图 26：固件升级—步骤 3 步骤 4：基于步骤 2，波特率会被自动设置。确认'Serial Port'串口和'Baudrate'波特率， 然后点击 'Start'按钮开始下载，如下图所示。波特率的设置会影响下载速率。 上海移远通信技术股份有限公司 28 /31 L76 系列 EVB 用户指导 图 27：固件升级—步骤 4 步骤 5：下载成功时，界面上将显示一个进度为 100 %的绿色矩形进度条，如下图所示。 备注 图 28：固件升级成功 进行固件升级前，确保模块处于 Continuous 模式。 上海移远通信技术股份有限公司 29 /31 L76 系列 EVB 用户指导 7 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_L76-L(L)&L76-LB(L)_EVB_User_Guide [2] Quectel_QCOM_User_Guide [3] Quectel_QGNSS_User_Guide [4] Quectel_QGPSFlashTool_User_Guide 表 6：术语缩写 缩写 BeiDou COM Port CEP CNR DA DI DO EPH EVB GND GNSS GPS 英文全称 BeiDou Navigation Satellite System Communication Port Circular Error Probable Carrier-to-Noise Ratio Download Agent Digital Input Digital Output Ellipsoidal Height Evaluation Board Ground Global Navigation Satellite System Global Positioning System 中文全称 北斗导航卫星系统 通信串口 圆误差概率 载噪比 下载代理 数字输入 数字输出 椭球面高度 评估板 地 全球导航卫星系统 全球定位系统 上海移远通信技术股份有限公司 30 /31 I/O LED Micro-USB MSL NMEA PI PO 1PPS PRN RMS ROM RTK SBAS SPS TTFF UART UTC L76 系列 EVB 用户指导 Input/Output 输入/输出 Light Emitting Diode 发光二极管 Micro Universal Serial Bus 微型通用串行总线 Mean Sea Level 平均海平面 NMEA (National Marine Electronics NMEA（美国船舶电子协会）0183 接 Association) 0183 Interface Standard 口标准 Power Input 输入电源 Power Output 输出电源 One Pulse Per Second 一秒一个脉冲 Pseudorandom Noise 伪随机噪声 Root Mean Square 均方根 Read Only Memory 只读存储器 Real-Time Kinematic 实时动态载波相位差分技术 Satellite-Based Augmentation System 星基增强系统 Standard Positioning Service 标准定位服务 Time to First Fix 首次定位时间 Universal Asynchronous Receiver & 通用异步收发器 Transmitter Coordinated Universal Time 协调世界时 上海移远通信技术股份有限公司 31 /31

LC29T (AA)&LC99T (IA) GNSS Protocol Specification GNSS Module Series Version: 1.0 Date: 2023-02-09 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you re quire any assistance, please contact our headquarters: Que ctel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For te chnical support, or to report documentation errors, please v isit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illeg al or malicious use of the material. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 1 / 71 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third -party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non -infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing here in constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel ’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data in teraction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 202 3. All rights reserved. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 2 / 71 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LC29T (AA)&LC99T (IA) GNSS Protocol Specification GNSS Module Series GNSS Protocol Specification Released Revision History Ve rsion 1.0 Date 2022-07-04 2023-02-09 De scription Creation of the document First official release LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 3 / 71 GNSS Module Series Contents About the Document .............................................................................................................................3 Contents ................................................................................................................................................4 Table Index.............................................................................................................................................6 1 Introduction ....................................................................................................................................7 2 NMEA Protocol ...............................................................................................................................8 2.1. Structure of NMEA Protocol Messages ...............................................................................8 2.2. Standard Messages .........................................................................................................10 2.2.1. RMC .........................................................................................................................10 2.2.2. GGA..........................................................................................................................12 2.2.3. GSV ..........................................................................................................................15 2.2.4. GSA ..........................................................................................................................17 2.2.5. VTG ..........................................................................................................................19 2.2.6. GLL...........................................................................................................................21 2.2.7. ZDA ..........................................................................................................................23 2.3. PSTM Messages ..............................................................................................................24 2.3.1. PSTMCOLD ..............................................................................................................24 2.3.2. PSTMWARM.............................................................................................................25 2.3.3. PSTMHOT ................................................................................................................25 2.3.4. PSTMSRR ................................................................................................................26 2.3.5. PSTMSAVEPAR........................................................................................................26 2.3.6. PSTMRESTOREPAR ................................................................................................27 2.3.7. PSTMPPS.................................................................................................................28 2.3.7.1. Getting PPS Data: PPS_IF_PULSE_DATA_CMD ........................................29 2.3.7.2. Getting PPS Data: PPS_IF_TIMING_DATA_CMD .......................................31 2.3.7.3. Getting PPS Data: PPS_IF_POSITION_HOLD_DATA_CMD .......................32 2.3.7.4. Getting PPS Data: PPS_IF_TRAIM_CMD ...................................................33 2.3.7.5. Getting PPS Data: PPS_IF_TRAIM_USED_CMD ........................................34 2.3.7.6. Getting PPS Data: PPS_IF_TRAIM_RES_CMD ..........................................35 2.3.7.7. Getting PPS Data: PPS_IF_TRAIM_REMOVED_CMD ................................35 2.3.7.8. Setting PPS Data: PPS_IF_ON_OFF_CMD ................................................36 2.3.7.9. Setting PPS Data: PPS_IF_OUT_MODE_CMD ...........................................37 2.3.7.10. Setting PPS Data: PPS_IF_REFERENCE_TIME_CMD ...............................37 2.3.7.11. Setting PPS Data: PPS_IF_PULSE_DELAY_CMD ......................................38 2.3.7.12. Setting PPS Data: PPS_IF_CONSTELLAT ION_RF_DELAY_CMD ..............39 2.3.7.13. Setting PPS Data: PPS_IF_PULSE_DURAT ION_CMD ...............................39 2.3.7.14. Setting PPS Data: PPS_IF_PULSE_POLARITY_CMD ................................40 2.3.7.15. Setting PPS Data: PPS_IF_PULSE_DATA_CMD ........................................41 2.3.7.16. Setting PPS Data: PPS_IF_FIX_CONDITION_CMD ...................................42 2.3.7.17. Setting PPS Data: PPS_IF_SAT_T HRESHOLD_CMD ................................42 2.3.7.18. Setting PPS Data: PPS_IF_ELEVATION_MASK_CMD ...............................43 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 4 / 71 GNSS Module Series 2.3.7.19. Setting PPS Data: PPS_IF_CONSTELLAT ION_MASK_CMD ......................43 2.3.7.20. Setting PPS Data: PPS_IF_TIMING_DATA_CMD .......................................44 2.3.7.21. Setting PPS Data: PPS_IF_POSIT ION_HOLD_DATA_CMD .......................46 2.3.7.22. Setting PPS Data: PPS_IF_AUTO_HOLD_SAMPLES_CMD .......................46 2.3.7.23. Setting PPS Data: PPS_IF_TRAIM_CMD ....................................................47 2.3.8. PSTMPPSDATA ........................................................................................................48 2.3.9. PSTMPOSHOLD.......................................................................................................51 2.3.10. PSTMTRAIMSTATUS ...............................................................................................53 2.3.11. PSTMTRAIMUSED ...................................................................................................54 2.3.12. PSTMTRAIMRES......................................................................................................55 2.3.13. PSTMTRAIMREMOVED ...........................................................................................56 2.3.14. PSTMUTC ................................................................................................................57 2.3.15. PSTMCPU ................................................................................................................58 2.3.16. PSTMTG...................................................................................................................59 2.3.17. PSTMTS ...................................................................................................................62 2.3.18. PSTMSBAS ..............................................................................................................64 3 Appendix A References................................................................................................................66 4 Appendix B GNSS Satellites (NMEA) Numbering......................................................................69 5 Appendix C Other Basic Commands...........................................................................................70 5.1. Query Software Version....................................................................................................70 5.2. Change Baud Rate...........................................................................................................70 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 5 / 71 GNSS Module Series Table Index Table 1: Modules and Supported Frequency Bands.................................................................................7 Table 2: Supported Protocol ....................................................................................................................7 Table 3: Structure of NMEA Protocol Message ........................................................................................8 Table 4: NMEA Talker ID..........................................................................................................................9 Table 5: Terms and Abbreviations ..........................................................................................................66 Table 6: GNSS Satellite (NMEA) Numbering..........................................................................................69 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 6 / 71 GNSS Module Series 1 Introduction Quectel LC29T (AA) and LC99T (IA) GNSS modules are multi-constellation modules. Concurrent tracking of multi-frequency bands provides fast and accurate acquisition and makes those modules an ideal solution for timing in various vertical markets. See the table below for the actual frequency bands supported by LC29T (AA) and LC99T (IA). Table 1: Modules and Supported Frequency Bands M odule LC29T (AA) LC99T (IA) Fre quency Band GPS L1, GLONASS L1, Galileo E1, BDS B1I, QZSS L1 GPS L1/L5, GLONASS L1, Galileo E1/E5a, BDS B1I/B2a, QZSS L1/L5, NavIC (IRNSS) L5 This document describes the software commands that are used to control and modify the module configuration. The software commands are proprietary NMEA commands (PSTM Messages) defined by the chipset supplier. To report GNSS information, the modules support outputting messages in NMEA 0183 protocol format. Table 2: Supported Protocol Protocol NMEA 0183 V4.11 Type Output, ASCII, standard Input/output, ASCII, proprietary NOTE 1. LC99T (IA) supports dual bands (L1 + L5). 2. Quectel assumes no responsibility if commands other than the ones listed herein are used . LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 7 / 71 GNSS Module Series 2 NMEA Protocol 2.1. Structure of NMEA Protocol Messages Start of sentence character. Always Address field - contains talker identifier and sentence formatter Starts with a * 8-bit checksum value converted to two ASCII characters Data field(s), delimited by , End of sentence. Always $ () [,] * Range for checksum calculation Figure 1: Structure of NMEA Protocol Message Table 3: Structure of NMEA Protocol Message Fie ld $ De scription Start of the sentence (Hex 0x24). In Standard Messages: In standard messages, this field consists of a two-character talker identifier (TalkerID) and a three-character sentence formatter (SentenceFormatter). The talker identifier serves to define the nature of the data being transmitted. For more information on the TalkerID, see Table 4: NMEA Talker ID. The sentence formatter is used to define data format and type. In Proprietary Messages: In proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer's Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. Data fields, delimited by data field delimiter ‘,’. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 8 / 71 GNSS Module Series Fie ld De scription Variable length (depends on the NMEA message type). The checksum field follows the checksum delimiter character *. The checksum is the 8-bit exclusive OR of all characters in the sentence, including the comma (,) delimiter, between but not including the $ and the * delimiters. End of the sentence (Hex 0x0D 0x0A). Table 4: NMEA Talker ID GNSS Constellation Configuration GPS GLONASS Galileo BDS QZSS IRNSS Combination of Multiple Satellite Systems TalkerID (NMEA0183 V4.11) GP GL GA GB GQ GI GN Sample Code for NMEAChecksum: // pData is the data array of which the checksum needs to be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL == pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^= *(pData + i); } LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 9 / 71 return result; } GNSS Module Series 2.2. Standard Messages This chapter explains the NMEA 0183 V4.11 standard messages supported by the LC29T (AA) and LC99T (IA) modules. 2.2.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type : Output Synopsis: $RMC,,,,,,,,,,,,,* Parame te r: Fie ld $ RMC Format Character Unit - String, 2 characters - String, 3 characters - hhmmss.sss - Character - ddmm.mmmmmm - Example De scription $ GN RMC 032753.000 A 3149.333250 Each NMEA message starts with $. Talker identifier. Always 'GN' in NMEA 0183 V4.11. Recommended Minimum Specific GNSS Data. Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status. A = Data valid V = Navigation receiver warning Latitude. dd: Degrees (00–90) mm: Minutes (00–59) LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 10 / 71 GNSS Module Series Fie ld Format Character dddmm.mmmmmm Character Numeric Numeric ddmmyy - - Character Unit Example De scription - - Knot Degree - mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. North-south direction. N = North N S = South Note that this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) 11706.946888 mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. East-west direction. E = East E W = West Note that this field is empty in case of an invalid value. Speed over ground. Variable length. 0.028 Note that this field is empty in case of an invalid value. Course over ground. Variable length. Maximum value: 359.99. 0.00 Note that this field is empty in case of an invalid value. 200422 Date. dd: Day of month mm: Month yy: Year - - Magnetic variation. Not supported. - - - D Direction of magnetic variation. Not supported. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 11 / 71 GNSS Module Series Fie ld Format Character Hexadecimal Character Unit Example - C - *2F - - De scription position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid Navigational status. S = Safe C = Caution U = Unsafe V = Navigational status not valid, equipment is not providing navigational status indication. Checksum. Carriage return and line feed. Example : $GNRMC,032753.000,A,3149.333250,N,11706.946888,E,0.028,0.00,200422,,,D,C*2F NOTE 1. $PSTMSETPAR can be used to enable or disable the output of RMC sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable RMC sentence: $PSTMSETPAR,32,3,0,1,0x40*48 $PSTMSAVEPAR*58 //Disable RMC sentence: $PSTMSETPAR,32,3,0,2,0x40*4B $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.2. GGA Global Positioning System Fix Data, Time, position and fix-related data for a GNSS receiver. Type : Output LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 12 / 71 GNSS Module Series Synopsis: $GGA,,,,,,,,< HDOP>, , M,,M,,* Parame te r: Fie ld $ GGA Format Unit Character - String, 2 characters - String, 3 characters - hhmmss.sss - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - Example De scription $ Each NMEA message start with $. Talker identifier. GN Always 'GN' in NMEA 0183 V4.11. GGA Global Positioning System Fix Data. Position fix UTC. 034221.000 hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Note that this field is empty in case of an invalid value. Latitude. dd: Degrees (00–90) mm: Minutes (00–59) 3149.332992 mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. North-south direction. N = North N S = South Note that this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) 11706.946415 mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. East-west direction. E = East E W = West Note that this field is empty in case LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 13 / 71 GNSS Module Series Fie ld Format Unit Example Numeric, 1 digit - 2 1) Numeric, 2 digits - 25 Numeric - 0.6 Numeric Meter 49.3 M Character - M Numeric Meter -0.3 M Character Hexadecimal Character - M - - - - - *63 - - De scription of an invalid value. GPS quality indicator. 0 = Fix not available or invalid 1 = GPS SPS Mode, fix valid 2 = Differential GPS, SPS Mode, or Satellite Based Augmentation System (SBAS), fix valid 3 = GPS PPS Mode, fix valid Number of satellites in use. Horizontal dilution of precision. Altitude above mean-sea-level (geoid). Note that this field is empty in case of an invalid value. Unit of . 'M' = Meter. Geoid separation (the difference between the earth ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). Note that this field is empty in case of an invalid value. Unit of . 'M' = Meter. Differential GPS data age. Not supported. Differential reference station ID. Not supported. Checksum. Carriage return and line feed. Example : $GNGGA,034221.000,3149.332992,N,11706.946415,E,2,25,0.6,49.3,M,-0.3,M,,*63 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 14 / 71 GNSS Module Series NOTE 1. The NMEA 0183 specification indicates that the GGA message is GPS specific. However, when the receiver is configured for multi-constellations, the content of GGA message will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12 . 3. $PSTMSETPAR can be used to enable or disable the output of GGA sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTM SETPAR. //Enable GGA sentence: $PSTMSETPAR,32,3,0,1,0x2*7E $PSTMSAVEPAR*58 //Disable GGA sentence: $PSTMSETPAR,32,3,0,2,0x2*7D $PSTMSAVEPAR*58 4. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.3. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value, and contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of sentences being transmitted and the sentence number are indicated in the first two data fields . Type : Output Synopsis: $GSV,,,{,,< SatElev>,, }, * Parame te r: Fie ld $ GSV Format Unit Character - String, 2 characters - String, 3 characters - Example Description $ GP GSV Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. GNSS Satellites in View. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 15 / 71 GNSS Module Series Fie ld Format Numeric Numeric Numeric Start of repeat block. Repeat times: 4. Numeric Numeric Numeric Numeric End of repeat block. Numeric Hexadecimal Character Unit Example Description - 2 Total number of sentences. - 1 Sentence number. Range: 1–. - 07 Total number of satellites in view. - 14 Degree 81 Degree 191 dB-Hz 42 - 1 - *68 - - Satellite ID. See Table 6: GNSS Satellite (NMEA) Numbering. Satellite elevation. Range: 00–90. Note that this field is empty in case of an invalid value. Satellite azimuth, with true north as the reference plane. Range: 000–359. Note that this field is empty in case of an invalid value. Satellite SNR (C/N0). Range 00–99. Null when not tracking. GNSS signal ID. See Table 6: GNSS Satellite (NMEA) Numbering. Checksum. Carriage return and line feed. Example : $GPGSV,2,1,07,14,81,191,42,17,55,339,41,03,47,081,38,19,37,308,37,1*68 $GPGSV,2,2,07,06,35,246,37,01,29,041,37,30,16,205,,,,,,1*5F $GLGSV,2,1,07,79,51,206,40,86,50,302,39,76,47,314,45,88,36,028,37,1*78 $GLGSV,2,2,07,69,15,268,24,68,12,135,,92,07,032,32,,,,,1*48 $GQGSV,1,1,03,03,70,052,42,07,52,161,34,02,48,155,39,,,,,1*57 $GAGSV,2,1,07,21,77,234,40,13,58,020,40,26,52,265,41,01,38,315,36,7*73 $GAGSV,2,2,07,27,33,156,37,15,11,049,24,33,,,24,,,,,7*7E $GBGSV,3,1,12,07,85,358,40,10,73,321,38,13,46,215,37,24,44,275,39,1*77 $GBGSV,3,2,12,35,43,048,38,26,39,208,27,12,37,290,35,22,27,134,24,1*7C $GBGSV,3,3,12,19,25,075,37,05,17,252,30,34,12,275,30,08,,,36,1*43 $GIGSV,1,1,03,04,63,189,,03,35,230,20,02,31,283,28,,,,,7*4C $GPGSV,1,1,04,14,81,191,36,03,47,081,34,06,35,246,32,01,29,041,28,7*6C $GAGSV,2,1,06,13,,,32,21,,,31,01,,,29,27,,,28 ,1*77 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 16 / 71 $GAGSV,2,2,06,26,,,31,15,,,14,,,,,,,,,1*74 $GBGSV,1,1,04,26,,,24,35,,,30,24,,,32,19,,,26,5*7A $GQGSV,1,1,03,03,70,052,31,07,52,161,33,02,48,155,32,,,,,7*59 GNSS Module Series NOTE 1. GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, GSV sentences are output with the corresponding talker ID for each constellation, respectively. 2. $PSTMSETPAR can be used to enable or disable the output of GSV sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTM SETPAR. //Enable GSV sentence: $PSTMSETPAR,32,3,0,1,0x80000*74 $PSTMSAVEPAR*58 //Disable GSV sentence: $PSTMSETPAR,32,3,0,2,0x80000*77 $PSTMSAVEPAR*58 3. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.4. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA sentence, and DOP values. Type : Output Synopsis: $GSA,,{,},,,* Parame te r: Fie ld $ GSA Format Character Unit - String, 2 characters - String, 3 characters - Character - Example Description $ GN GSA A Each NMEA message starts with $. Talker identifier. Always 'GN' in NMEA 0183 V4.11. GNSS DOP and Active Satellites. Selection of 2D or 3D fix. M = Manual, forced to operate in 2D or 3D LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 17 / 71 GNSS Module Series Fie ld Format Unit Numeric - Start of repeat block. Repeat times: 12. Numeric - End of repeat block. Numeric - Numeric - Numeric - Numeric - Hexadecimal - Character - Example Description mode. A = Automatic, allowed to automatically switch 2D/3D. Fix mode. 1 = Fix not available 3 2 = 2D 3 = 3D ID numbers of satellites used in solution. See Table 6: GNSS Satellite (NMEA) 02 Numbering. Note that this field is empty in case of an invalid value. Position dilution of precision. 1.2 Maximum value: 99.99. Horizontal dilution of precision. 0.1 Maximum value: 99.99. Vertical dilution of precision. 1.0 Maximum value: 99.99. GNSS system ID. 1 See Table 6: GNSS Satellite (NMEA) Numbering. *38 Checksum. - Carriage return and line feed. Example : $GNGSA,A,3,02,05,11,20,13,29,,,,,,,1.2,0.7,1.0,1*38 $GNGSA,A,3,90,91,82,,,,,,,,,,1.2,0.7,1.0,2*3C $GNGSA,A,3,03,,,,,,,,,,,,1.2,0.7,1.0,5*33 $GNGSA,A,3,,,,,,,,,,,,,1.2,0.7,1.0,3*36 $GNGSA,A,3,22,19,35,13,16,06,21,29,,,,,1.2,0.7,1.0,4*34 $GNGSA,A,3,03,02,,,,,,,,,,,1.2,0.7,1.0,6*32 NOTE 1. If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used for navigation, only the IDs of the first 12 are output. 2. $PSTMSETPAR can be used to enable or disable the output of a GSA sentence as shown below. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 18 / 71 GNSS Module Series Contact Quectel Technical Support (support@quectel.com) for more details about $PSTM SETPAR. //Enable GSA sentence: $PSTMSETPAR,32,3,0,1,0x4*78 $PSTMSAVEPAR*58 //Disable GSA sentence $PSTMSETPAR,32,3,0,2,0x4*7B $PSTMSAVEPAR*58 3. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.5. VTG Course Over Ground & Ground Speed. The actual course and speed relative to the ground. Type : Output Synopsis: $VTG,,T,,M,,N,,K,* Parame te r: Fie ld $ VTG T M Format Unit Example Description Character - String, 2 characters - String, 3 characters - $ GN VTG Numeric Degrees 0.00 Character Numeric Character Numeric - T Degrees - - M Knots 0.048 Each NMEA message starts with $. Talker identifier. Always 'GN' in NMEA 0183 V4.11. Course Over Ground & Ground Speed. Course over ground, in true north course direction. Note that this field is empty in case of an invalid value. Fixed field: true. Course over ground (magnetic). Not supported. Fixed field: magnetic. Speed over ground in knots. Note that this field is empty in case of an invalid value. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 19 / 71 GNSS Module Series Fie ld N Format Character Numeric K Character Unit km/h - Character - Hexadecimal - Character - Example : $GNVTG,0.00,T,,M,0.048,N,0.089,K,D*2B Example Description N 0.089 K D *2B Fixed field: knot. Speed over ground in kilometers per hour. Note that this field is empty in case of an invalid value. Fixed field: kilometers per hour. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) M = Manual input mode N = Data not valid Checksum. - Carriage return and line feed. NOTE 1. $PSTMSETPAR can be used to enable or disable the output of VTG sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR //Enable VTG sentence: $PSTMSETPAR,32,3,0,1,0x10*4D $PSTMSAVEPAR*58 //Disable VTG sentence: $PSTMSETPAR,32,3,0,2,0x10*4E $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 20 / 71 GNSS Module Series 2.2.6. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type : Output Synopsis: $GLL,,,,,,,* Parame te r: Fie ld $ GLL Format Unit Example De scription Character - String, 2 characters - String, 3 characters - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - $ Each NMEA message starts with $. Talker identifier. GN Always 'GN' in NMEA 0183 V4.11. Geographic Position – GLL Latitude/Longitude. Latitude. dd: Degrees (00–90) 3149.332624 mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. North-south direction. N = North N S = South Note that this field is empty in case of an invalid value. 11706.946280 Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. East-west direction. E = East E W = West Note that this field is empty in case of an invalid value. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 21 / 71 GNSS Module Series Fie ld Format hhmmss.sss Character Character Hexadecimal Character Unit Example - 051051.000 - D - D - *4A - - De scription Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status. A = Data valid V = Data not valid Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) M = Manual input mode N = Data not valid Checksum. Carriage return and line feed. Example : $GNGLL,3149.332624,N,11706.946280,E,051051.000,D,D*4A NOTE 1. $PSTMSETPAR can be used to enable or disable the output of GLL sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable GLL sentence: $PSTMSETPAR,32,3,0,1,0x100000*4D $PSTMSAVEPAR*58 //Disable GLL sentence: $PSTMSETPAR,32,3,0,2,0x100000*4E $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 22 / 71 GNSS Module Series 2.2.7. ZDA Time & Date. UTC, day, month, year and local time zone. Type : Output Synopsis: $ZDA,,,,,,* Parame te r: Fie ld Format Unit Example De scription $ ZDA Character - String, 2 characters - String, 3 characters - hhmmss.sss - Numeric - $ Each NMEA message starts with $. GN ZDA 051634.000 Talker identifier. Always 'GN' in NMEA 0183 V4.11. Time & Date. UTC, day, month, year and local time zone. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds 20 Day of month. Range: 01–31. Numeric - 04 Month. Range: 01–12. Numeric Numeric Numeric Hexadecimal - 2022 - - - - - *49 Year. Local zone hours, 00 to ±13 hours. Not supported. Local zone minutes, 00 to +59 minutes. Not supported. Checksum. Character - - Carriage return and line feed. Example : $GNZDA,051634.000,20,04,2022,,*49 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 23 / 71 GNSS Module Series NOTE 1. $PSTMSETPAR can be used to enable or disable the output of ZDA sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable ZDA sentence: $PSTMSETPAR,32,3,0,1,0x1000000*7D $PSTMSAVEPAR*58 //Disable ZDA sentence: $PSTMSETPAR,32,3,0,2,0x1000000*7E $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3. PSTM Messages This chapter explains the PSTM messages (proprietary NMEA messages defined by the chipset supplier) supported by LC29T (AA) and LC99T (IA). 2.3.1. PSTMCOLD Performs a cold start. Type : Command Synopsis: $PSTMCOLD* Parame te r: None Re sult: Cold start initialization and GNSS engine restart. 1) Example : $PSTMCOLD*1E LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 24 / 71 NOTE 1) The GNSS engine will be reset. It is not a system reboot. 2.3.2. PSTMWARM Performs a warm start. Type : Command Synopsis: $PSTMWARM* Parame te r: None Re sult: Warm start initialization and GNSS engine restart. 1) Example : $PSTMWARM*13 NOTE 1) The GNSS engine will be reset. It is not a system reboot. 2.3.3. PSTMHOT Performs a hot start. Type : Command Synopsis: $PSTMHOT* LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification GNSS Module Series 25 / 71 Parame te r: None Re sult: Hot start initialization and GNSS engine restart. 1) Example : $PSTMHOT*49 NOTE 1) The GNSS engine will be reset. It is not a system reboot. 2.3.4. PSTMSRR Executes a system reset and reboots the GNSS firmware. Type : Command Synopsis: $PSTMSRR* Parame te r: None Re sult: ⚫ The system is reset and the GNSS firmware is rebooted. ⚫ No message is sent as a reply. Example : $PSTMSRR*49 2.3.5. PSTMSAVEPAR Saves current configuration data block to NVM. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification GNSS Module Series 26 / 71 Type : Command Synopsis: $PSTMSAVEPAR* Parame te r: None Re sult: ⚫ If successful, the module returns: $PSTMSAVEPAROK* ⚫ If failed, the module returns: $PSTMSAVEPARERROR* Example : $PSTM SAVEPAR*58 $PSTM SAVEPAROK*5C GNSS Module Series 2.3.6. PSTMRESTOREPAR Restores the factory setting parameters. The configuration data block stored in NVM, if present, will be invalidated. Any changed parameter will be lost. Type : Command Synopsis: $PSTMRESTOREPAR* Parame te r: None Re sult: ⚫ If successful, the module returns: $PSTMRESTOREPAROK* LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 27 / 71 ⚫ If failed, the module returns: $PSTMRESTOREPARERROR* Example : $PSTM RESTOREPAR*11 $PSTM RESTOREPAROK*15 GNSS Module Series NOTE The factory setting parameters will be restored and the configuration block in the NVM will be lost. A system reboot is needed to restore the factory settings, i.e. default settings. 2.3.7. PSTMPPS Sets/gets configurations related to the PPS function. Configurations are not saved after resetting. Type : Set/Get Synopsis: $PSTMPPS,,,[,…,]* Parame te r: Fie ld Format Numeric Numeric Unit - - De scription Command operation mode. 1 = GET operation (to get data from PPS manager) 2 = SET operation (to set data into PPS manager) Command type. 1 = PPS_IF_ON_OFF_CMD 2 = PPS_IF_OUT_MODE_CMD 4 = PPS_IF_PULSE_DELAY_CMD 5 = PPS_IF_PULSE_DURATION_CMD 6 = PPS_IF_PULSE_POLARITY_CMD 7 = PPS_IF_PULSE_DATA_CMD 8 = PPS_IF_FIX_CONDITION_CMD 9 = PPS_IF_SAT_TRHESHOLD_CMD 10 = PPS_IF_ELEVATION_MASK_CMD 11 = PPS_IF_COSTELLATION_MASK_CMD 12 = PPS_IF_TIMING_DATA_CMD 13 = PPS_IF_POSITION_HOLD_DATA_CMD LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 28 / 71 GNSS Module Series Fie ld Format ,…, - Unit - De scription 14 = PPS_IF_AUTO_HOLD_SAMPLES_CMD 15 = PPS_IF_TRAIM_CMD 16 = PPS_IF_TRAIM_USED_CMD 17 = PPS_IF_TRAIM_RES_CMD 18 = PPS_IF_TRAIM_REMOVED_CMD 19 = PPS_IF_REFERENCE_TIME_CMD 20 = PPS_IF_CONSTELLATION_RF_DELAY_CMD Parameters vary depending on specific SET operations and should be configured only in SET operations. Re sult: According to the operation mode, data is retrieved from or set into the PPS manager, see the commands listed in the following sub-chapters (i.e., Chapter 2.3.7.1 Getting PPS Data: PPS_IF_PULSE_DATA_CMD to Chapter 2.3.7.23 Setting PPS Data: PPS_IF_TRAIM_CMD) for details. ⚫ If successful for GET operations, the module returns different results. See the sub -chapters of GET operations for details. ⚫ If successful for SET operations, the module returns: $PSTMPPSOK,2,* ⚫ If failed for both SET and GET operations, the module returns: $PSTMPPSERROR* 2.3.7.1.Getting PPS Data: PPS_IF_PULSE_DATA_CM D Gets the pulse information from the PPS manager. Type : Get Synopsis: $PSTMPPS,1,7* Re sult: $PSTMPPS,1,7,,,,,*< CR> LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 29 / 71 GNSS Module Series Parameters included in the result: Fie ld Format Numeric Numeric Numeric Numeric Numeric Unit De scription PPS generation mode. 0 = PPS always generated - 1 = PPS generated on even seconds 2 = PPS generated on odd seconds PPS reference time. 0 = UTC 1 = GPS Time 2 = GLONASS Time 3 = UTC (SU) - 4 = GPS Time (from GLONASS time reference) 5 = BDS Time 6 = UTC (NTSC) 7 = Galileo Time 8 = UTC (GST) 9 = GPS Time (from Galileo time reference) Nanosecond Pulse delay. Second - Pulse duration. Pulse polarity. 0 = Not inverted 1 = Inverted Example : $PSTM PPS,1,7*4F $PSTM PPS,1,7,0,1,0,0.500000,0*79 NOTE 1. UTC (SU) is the Universal Time Coordinated of Russia; it is derived from GLONASS time by applying the UTC delta time downloaded from GLONASS satellites. 2. GPS Time (from GLONASS time reference) is the GPS time derived from GLONASS time by applying the GPS delta time downloaded from GLONASS satellites. 3. If the software is configured to work in GLONASS only mode, UTC (SU) is identical to UTC and GPS Time (from GLONASS time reference) is identical to GPS Time . 4. For GPS Time (from Galileo time reference), the reference time is GPS time, but it is corrected using the parameters downloaded by Galileo. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 30 / 71 GNSS Module Series 2.3.7.2.Getting PPS Data: PPS_IF_TIM ING_DATA_CM D Gets the time information from the PPS manager. Type : Get Synopsis: $PSTMPPS,1,12* Re sult: $PSTMPPS,1,12,,,, ,,* Parameters included in the result: Fie ld Format Numeric Numeric Numeric Hexadecimal Numeric Unit De scription Degree - GNSS fix condition for generating PPS signal. 0 or 1 = No fix 2 = 2D fix 3 = 3D fix Minimum number of satellites for generating PPS signal. Minimum satellite elevation for satellite usage in timing filtering. Satellite constellation bitmask for timing filtering. Bit 0 = GPS Bit 1 = GLONASS Bit 2 = QZSS Bit 3 = Galileo Bit 7 = BDS Bit 11 = GPS L5 Bit 12 = Galileo E5a Bit 14 = BDS B2a Note that the L5 band of QZSS and NavlC is not used in timing filtering. Nanosecond GPS path RF delay. Numeric Nanosecond GLONASS path RF delay. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 31 / 71 Example : $PSTM PPS,1,12*7B $PSTM PPS,1,12,0,0,10,0000588b,350,305*2D GNSS Module Series NOTE 1. enables the usage of mixed constellations satellites in the timing filtering, meaning that satellites from one constellation can be used to correct the reference time for other constellations. Benefited from this, the module can provide users with more accurate time information. 2. When the prerequisites that GPS time is selected for generating PPS signal and Bit 1 (or Bit 7) is enabled are met, GLONASS (or BDS) satellites can be used to correct the GPS reference time. Likewise, only the prerequisites that GLONASS time is selected for generating PPS signal and Bit 0 is enabled, GPS satellites can be used to correct the GLONASS reference time. 2.3.7.3.Getting PPS Data: PPS_IF_POSITION_HOLD_DATA_CM D Gets the information about the Position Hold from the PPS manager. Type : Get Synopsis: $PSTMPPS,1,13* Re sult: $PSTMPPS,1,13,,,,,,* Parameters included in the result: Fie ld Format Numeric Unit - ddmm.mmmmmm - Character - De scription Position Hold status. 0 = Disabled 1 = Enabled Position Hold, position latitude in degrees. dd: Degree mm: Minutes mmmmmm: Decimal fraction of minutes North-south direction. N = North S = South LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 32 / 71 GNSS Module Series Fie ld Format Unit dddmm.mmmmmm - Character - Numeric - De scription Position Hold, position longitude in degrees. ddd: Degree mm: Minutes mmmmmm: Decimal fraction of minutes. East-west direction. E = East W = West Position Hold mean sea level altitude. Example : $PSTM PPS,1,13*7A $PSTM PPS,1,13,0,3149.335650,N,11706.942196,E,63.7*64 2.3.7.4.Getting PPS Data: PPS_IF_TRAIM _CM D Gets the TRAIM-related information from PPS manager. TRAIM is a timing calibration algorithm. Type : Get Synopsis: $PSTMPPS,1,15* Re sult: $PSTMPPS,1,15,,,,,* Parameters included in the result: Fie ld Format Unit Numeric - Numeric - Numeric Nanosecond De scription TRAIM status. 0 = Disabled 1 = Enabled TRAIM algorithm status. 0 = Under alarm 1 = Over alarm 2 = Unknown Average time error. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 33 / 71 Fie ld Format Unit Numeric - Numeric - Example : $PSTM PPS,1,15*7C $PSTM PPS,1,15,1,0,-1,13,4*7B GNSS Module Series De scription Number of satellites used for timing correction. Number of satellites removed by timing correction. 2.3.7.5.Getting PPS Data: PPS_IF_TRAIM _USED_CM D Gets satellites used in the TRAIM algorithm from the PPS manager. Type : Get Synopsis: $PSTMPPS,1,16* Re sult: $PSTMPPS,1,16,,{,}* Parameters included in the result: Fie ld Format Numeric Numeric Unit - De scription TRAIM status. 0 = Disabled 1 = Enabled Number of satellites used for timing correction. Start of repeat block. Repeat times. Numeric - List of satellites IDs. End of repeat block. Example : $PSTM PPS,1,16*7F $PSTM PPS,1,16,1,15,91,156,153,24,524,154,149,173,92,168,146,15,18,518,523*65 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 34 / 71 GNSS Module Series 2.3.7.6.Getting PPS Data: PPS_IF_TRAIM _RES_CM D Gets satellites’ residuals in the TRAIM algorithm from the PPS manager. Type : Get Synopsis: $PSTMPPS,1,17* Re sult: $PSTMPPS,1,17,,{,}* Parameters included in the result: Fie ld Format Unit Numeric - Numeric - Start of repeat block. Repeat times. Numeric Nanosecond End of repeat block. De scription TRAIM status. 0 = Disabled 1 = Enabled Number of satellites used for timing correction. Satellite residuals. Each residual corresponds to the satellite in the used satellite list in the same position. Example : $PSTM PPS,1,17*7E $PSTM PPS,1,17,1,12,16,-2,0,-16,3,-3,-7,3,-8,-2,8,8*40 2.3.7.7.Getting PPS Data: PPS_IF_TRAIM _REM OVED_CM D Gets the removed satellites in the TRAIM algorithm from the PPS manager. Type : Get LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 35 / 71 GNSS Module Series Synopsis: $PSTMPPS,1,18* Re sult: $PSTMPPS,1,18,,{,}* Parameters included in the result: Fie ld Format Numeric Numeric Unit - De scription TRAIM status. 0 = Disabled 1 = Enabled Number of satellites removed by timing correction. Start of repeat block. Repeat times. Numeric - Removed satellite ID. End of repeat block. Example : $PSTM PPS,1,18*71 $PSTM PPS,1,18,1,4,524,161,164,92*49 2.3.7.8.Setting PPS Data: PPS_IF_ON_OFF_CM D Sets PPS feature status. Type : Set Synopsis: $PSTMPPS,2,1,* Parame te r: Fie ld Format Numeric Unit - De scription PPS feature status. 0 = Disable PPS 1 = Enable PPS LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 36 / 71 Example : $PSTM PPS,2,1,1*57 $PSTM PPSOK,2,1*4E GNSS Module Series 2.3.7.9.Setting PPS Data: PPS_IF_OUT_M ODE_CM D Sets PPS output mode. Type : Set Synopsis: $PSTMPPS,2,2,* Parame te r: Fie ld Format Numeric Unit - De scription PPS generation mode. 0 = PPS always generated 1 = PPS generated on even seconds 2 = PPS generated on odd seconds Example : $PSTM PPS,2,2,0*55 $PSTM PPSOK,2,2*4D 2.3.7.10.Setting PPS Data: PPS_IF_REFERENCE_TIME_CMD Sets reference time for synchronizing PPS signal. Type : Set Synopsis: $PSTMPPS,2,19,* LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 37 / 71 Parame te r: Fie ld Format Numeric Example : $PSTM PPS,2,19,1*6E $PSTM PPSOK,2,19*77 GNSS Module Series Unit - De scription PPS reference time. 0 = UTC 1 = GPS Time 2 = GLONASS Time 3 = UTC (SU) 4 = GPS Time (from GLONASS time reference) 5 = BDS Time 6 = UTC (NTSC) 7 = Galileo Time 8 = UTC (GST) 9 = GPS Time (from Galileo time reference) NOTE 1. UTC (SU) is the Universal Time Coordinated of Russia; it is derived from GLONASS time by applying the UTC delta time downloaded from GLONASS satellites. 2. GPS Time (from GLONASS time reference) is the GPS time derived from GLONASS time by applying the GPS delta time downloaded from GLONASS satellites. 3. If the software is configured to work in GLONASS only mode, UTC (SU) is identical to UTC and GPS Time (from GLONASS time reference) is identical to GPS Time . 4. For GPS Time (from Galileo time reference), the reference time is GPS time, but it is corrected using the parameters downloaded by Galileo. 2.3.7.11.Setting PPS Data: PPS_IF_PULSE_DELAY_CMD Sets a time correction to compensate any delay on the Pulse per Second (PPS) signal caused by cables and/or RF chain. Type : Set Synopsis: $PSTMPPS,2,4,* LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 38 / 71 Parame te r: Fie ld Format Numeric Example : $PSTM PPS,2,4,10*62 $PSTM PPSOK,2,4*4B GNSS Module Series Unit De scription Nanosecond Pulse delay. 2.3.7.12.Setting PPS Data: PPS_IF_CONSTELLATION_RF_DELAY_CMD Sets the RF time delay for the satellite signal path. Type : Set Synopsis: $PSTMPPS,2,20,* Parame te r: Fie ld Format Numeric Numeric Unit De scription Satellite constellation type. 0 = GPS - 1 = GLONASS 3 = Galileo 7 = BDS Nanosecond Time delay. Example : $PSTM PPS,2,20,0,350*7F $PSTM PPSOK,2,20*7D 2.3.7.13.Setting PPS Data: PPS_IF_PULSE_DURATION_CMD Sets the pulse duration of the PPS signal. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 39 / 71 Type : Set Synopsis: $PSTMPPS,2,5,* Parame te r: Fie ld Format Numeric Unit De scription Second Pulse duration. Example : $PSTM PPS,2,5,0.5*49 $PSTM PPSOK,2,5*4A GNSS Module Series 2.3.7.14.Setting PPS Data: PPS_IF_PULSE_POLARITY_CMD Sets pulse polarity. The pulse duration is the temporal distance between the PPS rising edge and the next falling edge if polarity inversion is disabled or the temporal distance between PPS falling edge and the next rising edge if polarity inversion is enabled. Type : Set Synopsis: $PSTMPPS,2,6,* Parame te r: Fie ld Format Numeric Example : $PSTM PPS,2,6,0*51 $PSTM PPSOK,2,6*49 Unit - De scription Pulse polarity. 0 = Not inverted 1 = Inverted LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 40 / 71 GNSS Module Series 2.3.7.15.Setting PPS Data: PPS_IF_PULSE_DATA_CMD Sets pulse data into the PPS manager. Type : Set Synopsis: $PSTMPPS,2,7,,,,,*< CR> Parame te r: Fie ld Format Numeric Numeric Numeric Numeric Numeric Unit - Nanosecond De scription PPS generation mode. 0 = PPS always generated 1 = PPS generated on even seconds 2 = PPS generated on odd seconds PPS reference time. 0 = UTC 1 = GPS Time 2 = GLONASS Time 3 = UTC (SU) 4 = GPS Time (from GLONASS time reference) 5 = BDS Time 6 = UTC (NTSC) 7 = Galileo Time 8 = UTC (GST) 9 = GPS Time (from Galileo time reference) Pulse delay. Second - Pulse duration. Pulse polarity. 0 = Not inverted 1 = Inverted Example : $PSTM PPS,2,7,0,1,10,0.5,0*7B $PSTM PPSOK,2,7*48 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 41 / 71 GNSS Module Series NOTE 1. UTC (SU) is the Universal Time Coordinated of Russia; it is derived from GLONASS time by applying the UTC delta time downloaded from GLONASS satellites. 2. GPS Time (from GLONASS time reference) is the GPS time derived from GLONASS time by applying the GPS delta time downloaded from GLONASS satellites. 3. If the software is configured to work in GLONASS only mode, UTC (SU) is identical to UTC and GPS Time (from GLONASS time reference) is identical to GPS Time . 4. For GPS Time (from Galileo time reference), the reference time is GPS time, but it is corrected using the parameters downloaded by Galileo. 2.3.7.16.Setting PPS Data: PPS_IF_FIX_CONDITION_CMD Sets GNSS fix condition for generating PPS signal. Type : Set Synopsis: $PSTMPPS,2,8,* Parame te r: Fie ld Format Unit Numeric - De scription GNSS fix condition for generating PPS signal. 0 or 1 = No fix 2 = 2D fix 3 = 3D fix Example : $PSTM PPS,2,8,1*5E $PSTM PPSOK,2,8*47 2.3.7.17.Setting PPS Data: PPS_IF_SAT_THRESHOLD_CMD Sets minimum number of satellites for generating PPS signal. Type : Set LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 42 / 71 GNSS Module Series Synopsis: $PSTMPPS,2,9,* Parame te r: Fie ld Format Numeric Unit De scription - Minimum number of satellites for generating PPS signal. Example : $PSTM PPS,2,9,5*5B $PSTM PPSOK,2,9*46 2.3.7.18.Setting PPS Data: PPS_IF_ELEVATION_MASK_CMD Sets the minimum elevation of a satellite when it is used in timing filtering. Type : Set Synopsis: $PSTMPPS,2,10,* Parame te r: Fie ld Format Numeric Unit - De scription Minimum satellite elevation for timing filtering. Example : $PSTM PPS,2,10,10*57 $PSTM PPSOK,2,10*7E 2.3.7.19.Setting PPS Data: PPS_IF_CONSTELLATION_MASK_CMD Selects the satellite constellation to be used in timing filtering. Type : Set LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 43 / 71 GNSS Module Series Synopsis: $PSTMPPS,2,11,* Parame te r: Fie ld Format Unit Numeric - De scription Satellite constellation bitmask for timing filtering. Bit 0 = GPS Bit 1 = GLONASS Bit 2 = QZSS Bit 3 = Galileo Bit 7 = BDS Bit 11 = GPS L5 Bit 12 = Galileo E5a Bit 14 = BDS B2a Note that the L5 band of QZSS and NavlC is not used in timing filtering. Example : $PSTM PPS,2,11,22667*60 $PSTM PPSOK,2,11*7F NOTE 1. enables the usage of mixed constellations satellites in the timing filtering, meaning that satellites from one constellation can be used to correct the reference time for other constellations. Benefited from this, the module can provide users with more ac curate time information. 2. When the prerequisites that GPS time is selected for generating PPS signal and Bit 1 (or Bit 7) is enabled are met, GLONASS (or BDS) satellites can be used to correct the GPS reference time. Likewise, only the prerequisites that GLONASS time is selected for generating PPS signal and Bit 0 is enabled, GPS satellites can be used to correct the GLONASS reference time. 2.3.7.20.Setting PPS Data: PPS_IF_TIMING_DATA_CMD Sets timing data into the PPS manager. Type : Set LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 44 / 71 GNSS Module Series Synopsis: $PSTMPPS,2,12,,,, * Parame te r: Fie ld Format Unit Numeric - Numeric - Numeric - Numeric - De scription GNSS fix condition for generating PPS signal. 0 or 1 = No fix 2 = 2D fix 3 = 3D fix Minimum number of satellites for generating PPS signal. Minimum satellite elevation for satellite usage in timing filtering. Satellite constellation bitmask for timing filtering. Bit 0 = GPS Bit 1 = GLONASS Bit 2 = QZSS Bit 3 = Galileo Bit 7 = BDS Bit 11 = GPS L5 Bit 12 = Galileo E5a Bit 14 = BDS B2a Note that the L5 band of QZSS and NavlC is not used in timing filtering. Example : $PSTM PPS,2,12,0,0,10,22667*4E $PSTM PPSOK,2,12*7C NOTE 1. enables the usage of mixed constellations satellites in the timing filtering, meaning that satellites from one constellation can be used to correct the reference time for other constellations. Benefited from this, the module can provide users with more ac curate time information. 2. When the prerequisites that GPS time is selected for generating PPS signal and Bit 1 (or Bit 7) is enabled are met, GLONASS (or BDS) satellites can be used to correct the GPS reference time. Likewise, only the prerequisites that GLONASS time is selected for generating PPS signal and Bit 0 is enabled, GPS satellites can be used to correct the GLONASS reference time. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 45 / 71 GNSS Module Series 2.3.7.21.Setting PPS Data: PPS_IF_POSITION_HOLD_DATA_CMD Sets the information about the Position Hold in the PPS manager. Type : Set Synopsis: $PSTMPPS,2,13,,,,,,* Parame te r: Fie ld Format Numeric ddmm.mmmmmm Character dddmm.mmmmmm Character Numeric Unit - De scription Position Hold status. 0 = Disabled 1 = Enabled Position Hold, position latitude in degrees. dd: Degree mm: Minutes mmmmmm: Decimal fraction of minutes North-south direction. N = North S = South Position Hold, position longitude in degrees. ddd: Degree mm: Minutes mmmmmm: Decimal fraction of minutes East-west direction. E = East W = West Position Hold, mean sea level altitude. Example : $PSTM PPS,2,13,1,3149.339242 ,N,11706.952207,E,004.01*60 $PSTM PPSOK,2,13*7D 2.3.7.22.Setting PPS Data: PPS_IF_AUTO_HOLD_SAMPLES_CMD Sets the number of position samples for the auto position algorithm. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 46 / 71 GNSS Module Series Type : Set Synopsis: $PSTMPPS,2,14,* Parame te r: Fie ld Format Numeric Unit - De scription Number of position samples for the auto position algorithm. If the number of samples is set to '0', the Auto Position Hold feature is disabled. Position average evaluation is restarted every time the command is executed. Example : $PSTM PPS,2,14,3600*57 $PSTM PPSOK,2,14*7A NOTE Auto Position Hold is a feature that the receiver calculates the average position over a period of time until a predefined number of position samples for the auto position algorithm has been reached. Afterwards the receiver automatically enters position hold status and the timing features will be activated. Progress during Auto Position Hold can be monitored with $PSTM POSHOLD message. 2.3.7.23.Setting PPS Data: PPS_IF_TRAIM_CMD Sets the time error threshold for satellites removal in the TRAIM algorithm. Satellites which have a time error bigger than the TRAIM threshold are not used for time correction. The TRAIM threshold is also used to raise the TRAIM alarm if the time correction error is bigger than TRAIM threshold. Type : Set Synopsis: $PSTMPPS,2,15,,* LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 47 / 71 Parame te r: Fie ld Format Numeric Numeric Example : $PSTM PPS,2,15,1,1.5E-8*34 $PSTM PPSOK,2,15*7B GNSS Module Series Unit Second De scription TRAIM status. 0 = TRAIM disabled 1 = TRAIM enabled TRAIM alarm (scientific notation is allowed). NOTE If the default value is not given for any parameter in a Set command, you can query it with the corresponding Get command provided that the default setting has not been changed by Set command. If the default setting had been changed by Set command, contact Quectel Technical Support (support@quectel.com) to get the default setting if necessary. 2.3.8. PSTMPPSDATA Outputs the PPS (Pulse Per Second) data. Type : Output Synopsis: $PSTMPPSDATA,,,,,,,,,,,,, ,,,,,,,,,,,,,,* Parame te r: Fie ld Format Unit Numeric Numeric - De scription PPS signal status. 0 = OFF 1 = ON Global PPS validity flag. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 48 / 71 Fie ld GNSS Module Series Format Unit Numeric Numeric - Numeric - Numeric Numeric Second De scription 0 = Invalid 1 = Valid PPS synchronization validity. 0 = Invalid 1 = Valid PPS generation mode. 0 = PPS always generated 1 = PPS generated on even seconds 2 = PPS generated on odd seconds PPS refence time. 0 = UTC 1 = GPS Time 2 = GLONASS Time 3 = UTC (SU) 4 = GPS Time (from GLONASS time reference) 5 = BDS Time 6 = UTC (NTSC) 7 = Galileo Time 8 = UTC (GST) 9 = GPS Time (from Galileo time reference) Refence constellation. 0 = GPS 1 = GLONASS 3 = Galileo 7 = BDS Pulse duration. Numeric Nanosecond Pulse delay. Numeric Nanosecond GPS path RF delay. Numeric Nanosecond GLONASS path RF delay. Numeric Nanosecond BDS path RF delay. Numeric Numeric Numeric Nanosecond Galileo path RF delay. Pulse polarity inversion. - 0 = Not inverted 1 = Inverted Selected GNSS fix condition for generating - PPS signal. 0 or 1 = No fix LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 49 / 71 GNSS Module Series Fie ld Format Unit Numeric Numeric - Numeric - Numeric Numeric Numeric - De scription 2 = 2D fix 3 = 3D fix Selected minimum number of satellites for generating PPS signal. Selected minimum satellite elevation for time correction. Satellite constellation bitmask for timing filtering. Bit 0 = GPS Bit 1 = GLONASS Bit 2 = QZSS Bit 3 = Galileo Bit 7 = BDS Bit 11 = GPS L5 Bit 12 = Galileo E5a Bit 14 = BDS B2a Note that the L5 band of QZSS and NavlC is not used in timing filtering. Second to which the reported PPS data is applied. According to configured reference time, it could be a UTC, GPS, GLONASS or BDS time second. GNSS position fix status when the time has been corrected. 1 = No fix 3 = 3D fix Used satellites for time correction. Numeric Second UTC–GPS leap seconds. Numeric Nanosecond UTC–GPS delta time. Numeric Nanosecond UTC–GLONASS delta time. Numeric Nanosecond UTC–Galileo delta time. Numeric Second Quantization error. Numeric Hz PPS clock frequency. Numeric Hz TCXO clock frequency. Numeric Second UTC–BDS leap seconds. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 50 / 71 GNSS Module Series Example : $PSTMPPSDATA,1,1,1,0,1,0,0.500000,0,350,305,357,841,0,0,0,10,22667,32,3,15,18,0,0,0,5.191e 09,65473971.84,26000005.36,4*24 NOTE 1. enables the usage of mixed constellations satellites in the timing filtering, meaning that satellites from one constellation can be used to correct the reference time for other constellations. Benefited from this, the module can provide users with more ac curate time information. 2. When the prerequisites that GPS time is selected for generating PPS signal and Bit 1 (or Bit 7) is enabled are met, GLONASS (or BDS) satellites can be used to correct the GPS reference time. Likewise, only the prerequisites that GLONASS time is selected for generating PPS signal and Bit 0 is enabled, GPS satellites can be used to correct the GLONASS reference time. 3. UTC (SU) is the Universal Time Coordinated of Russia; it is derived from GLONASS time applying the UTC delta time downloaded from GLONASS satellites. 4. GPS Time (from GLONASS time reference) is the GPS time derived from GLONASS time applying the GPS delta time downloaded from GLONASS satellites. 5. If the software is configured to work in GLONASS only mode, UTC (SU) is identical to UTC and GPS Time (from GLONASS time reference) is identical to GPS Time . 6. For GPS Time (from Galileo time reference), the reference time is GPS time, but it is corrected using the parameters downloaded by Galileo. 7. $PSTMSETPAR can be used to enable or disable the output of $PSTMPPSDATA as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMPPSDATA: $PSTMSETPAR,32,3,0,1,0x200000*4E $PSTMSAVEPAR*58 //Disable $PSTMPPSDATA: $PSTMSETPAR,32,3,0,2,0x200000*4D $PSTMSAVEPAR*58 8. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.9. PSTMPOSHOLD Outputs the Position Hold status and position. Type : Output Synopsis: $PSTMPOSHOLD,,,,,,* LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 51 / 71 GNSS Module Series Parame te r: Fie ld Format Numeric Unit - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character Numeric Meter De scription Position Hold status. 0 = Disabled 1 = Enabled Latitude in degrees. dd: Degree mm: Minutes mmmmmm: Decimal fraction of minutes North-south direction. N = North S = South Longitude in degrees. ddd: Degree mm: Minutes mmmmmm: Decimal fraction of minutes East-west direction. E = East W = West Height above mean sea level. Example : $PSTMPOSHOLD,0,3149.332411,N,11706.944452,E,071.24*4E NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTM POSHOLD as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTM POSHOLD: $PSTMSETPAR,32,3,0,1,0x4000000*78 $PSTMSAVEPAR*58 //Disable $PSTM POSHOLD: $PSTMSETPAR,32,3,0,2,0x4000000*7B $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 52 / 71 GNSS Module Series 2.3.10. PSTMTRAIMSTATUS Outputs the TRAIM algorithm status. Type : Output Synopsis: $PSTMTRAIMSTATUS,,,,,,,* Parame te r: Fie ld Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit - - Nanosecond Nanosecond - De scription TRAIM status. 0 = Disabled 1 = Enabled TRAIM algorithm status. 0 = Under Alarm 1 = Over Alarm 2 = Unknown Time error threshold. Average time error. Number of satellites used for timing correction. Number of satellites removed by timing correction. Second at which the PPS signal is generated based on reported TRAIM status. Example : $PSTMTRAIMSTATUS,1,0,15,2,7,4,18*5C NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMTRAIMSTATUS as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTM SETPAR. //Enable $PSTMTRAIMSTATUS: $PSTMSETPAR,32,3,0,1,0x2000000*7E $PSTMSAVEPAR*58 //Disable $PSTMTRAIMSTATUS: LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 53 / 71 GNSS Module Series $PSTMSETPAR,32,3,0,2,0x2000000*7D $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.11. PSTMTRAIMUSED Outputs the ID of satellite(s) used for timing correction. Type : Output Synopsis: $PSTMTRAIMUSED,,{,}* Parame te r: Fie ld Format Unit Numeric - Numeric - Start of repeat block. Repeat times. Numeric - End of repeat block. De scription TRAIM status. 0 = Disabled 1 = Enabled Number of satellites used for timing correction. Satellite ID. Example : $PSTMTRAIMUSED,1,7,87,78,161,871,162,872,511*41 NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMTRAIM USED as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTM SETPAR. //Enable $PSTMTRAIM USED: $PSTMSETPAR,32,3,0,1,0x2000000*7E $PSTMSAVEPAR*58 //Disable $PSTMTRAIM USED: $PSTMSETPAR,32,3,0,2,0x2000000*7D LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 54 / 71 GNSS Module Series $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.12. PSTMTRAIMRES Outputs the time error residuals for satellites used for timing correction. Type : Output Synopsis: $PSTMTRAIMRES,,{,}* Parame te r: Fie ld Format Numeric Numeric Unit - De scription TRAIM status. 0 = Disabled 1 = Enabled Number of satellites used for timing correction. Start of repeat block. Repeat times. Numeric - End of repeat block. Time error residuals for satellites reported in $PSTMTRAIMUSED message. Each residual refers to the satellite in the same message position. Example : $PSTMTRAIMRES,1,7,4,-24,1,9,3,-2,7*3B NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMTRAIM RES as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTM SETPAR. //Enable $PSTMTRAIM RES: $PSTMSETPAR,32,3,0,1,0x2000000*7E $PSTMSAVEPAR*58 //Disable $PSTMTRAIM RES: $PSTMSETPAR,32,3,0,2,0x2000000*7D LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 55 / 71 GNSS Module Series $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.13. PSTMTRAIMREMOVED Outputs the satellite removed by the timing correction algorithm. Type : Output Synopsis: $PSTMTRAIMREMOVED,,{,}* Parame te r: Fie ld Format Unit Numeric - Numeric - Start of repeat block. Repeat times. Numeric - End of repeat block. De scription TRAIM status. 0 = Disabled 1 = Enabled Number of removed satellites. Removed satellites ID. Example : $PSTMTRAIMREMOVED,1,4,69,506,152,153*23 NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMTRAIM REMOVED as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTM SETPAR. //Enable $PSTMTRAIM REMOVED: $PSTMSETPAR,32,3,0,1,0x2000000*7E $PSTMSAVEPAR*58 //Disable $PSTMTRAIM REMOVED: $PSTMSETPAR,32,3,0,2,0x2000000*7D $PSTMSAVEPAR*58 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 56 / 71 GNSS Module Series 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.14. PSTMUTC Outputs the UTC time, date and time offset parameters. Type : Output Synopsis: $PSTMUTC,,,,,* Parame te r: Fie ld Format Unit hhmmss.sss - ddmmyyyy - Numeric Numeric Second Second Numeric - De scription UTC time of fix, example: 160836.000. '.sss' is the fraction of seconds, which assumes non-zero values when the fix rate is higher than 1 Hz. Date. dd: Day of month mm: Month yyyy: Year UTC time expressed as number of seconds since January 6th, 1980. UTC to GPS time offset. UTC to GPS time offset validity. 0 = Invalid 1 = Read from NVM 2 = Valid Example : $PSTMUTC,040242.000,25062022,1340164962,18,2*5A NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMUTC as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMUTC: LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 57 / 71 GNSS Module Series $PSTMSETPAR,32,6,0,1,0x4*7D $PSTMSAVEPAR*58 //Disable $PSTMUTC: $PSTMSETPAR,32,6,0,2,0x4*7E $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.15. PSTMCPU Outputs the real-time CPU usage and the CPU speed setting. Type : Output Synopsis: $PSTMCPU,,,* Parame te r : Fie ld Format Numeric Numeric Numeric Unit De scription - CPU usage in percent (%). PLL enabling/disabling status. 0 = PLL disabled 1 = PLL enabled -1 = Not supported MHz CPU clock frequency. Example : $PSTMCPU,51.47,0,261*5C NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMCPU as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMCPU: $PSTMSETPAR,32,3,0,1,0x800000*44 $PSTMSAVEPAR*58 //Disable $PSTMCPU: $PSTMSETPAR,32,3,0,2,0x800000*47 LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 58 / 71 GNSS Module Series $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.16. PSTMTG Outputs time and satellite information. Type : Output Synopsis: $PSTMTG,,,,,,,,,,,,,,,,,,,,* Parame te r: Fie ld Format Numeric Numeric Numeric Numeric Numeric Numeric Unit Second - - Hz De scription Week number. Time of week. - CPU time. Valid time. 0 = No time 1 = Time read from flash 2 = TOW time (week number not available) 3 = Time set by user 4 = Time set by user RTC 5 = Approximate RTC time 6 = Accurate RTC time 7 = Approximate time 8 = Accurate time 9 = Position time 10 = Ephemeris time Estimated receiver clock drift. If clock steering is enabled, this value shall be used in the Doppler calculation (instead of the LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 59 / 71 Fie ld Format Unit Hexadecimal - Numeric - Numeric - Numeric - Numeric - GNSS Module Series De scription nominal values). Configuration status: ⚫ Byte 0: Kalman filter configuration. Note that 0 means feature is disabled and 1 means feature is enabled for all bits, unless otherwise specified. Bit 0: Walking mode Bit 1: Stop detection Bit 2: Frequency ramp Bit 3: Velocity estimator model 1 = Multiple model 0 = Single model Bit 4: Velocity estimator filter 1 = Slow 0 = Fast Bit 5: FDE status ⚫ Byte 1: Global configuration. Bit 0–3: Front-end frequency 1 = 48 MHz 0 = 26 MHz Bit 4–6: $PSTMTG, $PSTMTS version Bit 7: Clock steering indicator 1 = Steered 0 = No Bitmask where each bit means a specific constellation is enabled or disabled. Bit 0: GPS Bit 1: GLONASS Bit 2: QZSS Bit 3: Galileo Bit 7: BDS Bit 10: IRNSS L5 Bit 11: GPS L5 Bit 12: Galileo E5a Bit 14: BDS B2a Bit 16: QZSS L5 Selected best time satellite type. Master time satellite type. Master time week number. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 60 / 71 Fie ld Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric GNSS Module Series Unit De scription Second Master time TOW. Meter Master week number time validity. Additional flags and status. Bit 0: TCXO jump detected Bit 1: Earth rotation correction in satellite position 0 = Legacy 1 = Without earth rotation Bit 2: Spectral inversion 0 = Legacy (BDS inverted) 1 = Spectral inversion internally compensated Bit 3: Clock bias validity 0 = Invalid (legacy) 1 = Valid Bit 4: Indicates presence of field Bit 5: Satellite data 0 = Satellite data present 1 = No satellite data in $PSTMTS Bit 6: MTB timestamp 0 = No MTB timestamp 1 = Observable MTB timestamp present Bit 7: OSCI32 output status 0 = Output disabled 1 = Normal output Bit 8–31: Reserved Estimated receiver clock bias. - Second Millisecond Picosecond Multi-frequency configuration mask. Leap seconds. 0 = Unknown -1 = Invalid Other values = Valid data PPS edge counter @ 64F0 resolution. Master time-base. Number of milliseconds since time reference. Master time-base. Fixed-point fractional precision in picosecond. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 61 / 71 GNSS Module Series Example : $PSTMTG,2215,537572.00000000,0,3013755261,9, -47509.1666,a000,88205,0,0,2215,537572.000000 00,9,254,2.907,-2147399539,18,4016774297,2945875,304162685*5C NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMMTG as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMTG: $PSTMSETPAR,32,4,0,1,0x100*7A $PSTMSAVEPAR*58 //Disable $PSTMTG: $PSTMSETPAR,32,4,0,2,0x100*79 $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.17. PSTMTS Repeatedly outputs GNSS raw data for each tracked satellite and is used for calculating a fix. Type : Output Synopsis: $PSTMTS,,,,,,,,,, ,,,* Parame te r: Fie ld Format Numeric Numeric Numeric Numeric Numeric Unit - Meter Cycle De scription DSP data available. Bit 0 = 2nd band follows Bit 1 = Main band Satellite Identifier. Pseudo range. Satellite tracking frequency offset. Carrier phase measurement. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 62 / 71 Fie ld Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric GNSS Module Series Unit - dB-Hz Second Degree De scription DSP bit flags. Bit 0: Parameter status 1 = Available Bit 1: Preamble locked 1 = Locked Bit 2–3: Multi-path indicator 0 = No indication 3 = Strong indication Bit 4: Loss of lock indicator Bit 5–6: Reserved Bit 7: Preamble polarity 0 = Normal 1 = Reserved Bit 8: Half cycle ambiguity 0 = Fixed 1 = Not fixed Bit 9–13:Reserved Bit 14: Main or dual frequency 1 = Main frequency (L1) 0 = Dual frequency (L5) Bit 15: Cycle slip indicator (at current epoch vs previous one) 1 = Occurred Bit 16–21: Reserved Bit 22–24: Code alarm value Bit 25: Spoofing Satellite carrier to noise ratio. Track time of satellite. Moving average of the code-loop discriminator error in arbitrary units. Typical absolute value < 2000. Moving average of the error used to update the carrier loop in arbitrary units. Typical range: 1–10000. Total Cycle Slip Counter. GLONASS satellite slot number (1–24), if available; otherwise 0. Elevation degree. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 63 / 71 GNSS Module Series Example : $PSTMTS,2,72,21950007.875,-47644.02,-117294202.404,21635,42,77210,-167,1241,1,11,27*0C NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMMTS as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMTS: $PSTMSETPAR,32,4,0,1,0x200*79 $PSTMSAVEPAR*58 //Disable $PSTMTS: $PSTMSETPAR,32,4,0,2,0x200*7A $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.18. PSTMSBAS Outputs SBAS satellite data. Type : Output Synopsis: $PSTMSBAS,,,,,,* Parame te r: Fie ld Format Numeric Numeric Numeric Numeric Numeric Unit De scription SBAS Status. - 0 = No SBAS used 1 = SBAS used Whether the SBAS satellite is tracked. 0 = SBAS satellite is not tracked. - 1 = SBAS satellite is tracked, decoding is ongoing. 2 = SBAS satellite is tracked and decoded. Differential mode is on. - SBAS satellite ID. Degree SBAS satellite elevation. Degree SBAS satellite azimuth. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 64 / 71 GNSS Module Series Fie ld Format Numeric Unit dB-Hz De scription SBAS satellite signal strength CN0. Example : $PSTMSBAS,1,2,129,45,141,19*1D NOTE 1. $PSTMSETPAR can be used to enable or disable the output of $PSTMSBAS as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMSBAS: $PSTMSETPAR,32,3,0,1,0x4000*48 $PSTMSAVEPAR*58 //Disable $PSTMSBAS: $PSTMSETPAR,32,3,0,2,0x4000*4B $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to b e restarted for the command to take effect. LC29T(AA)&LC99T(IA) _GNSS_Protocol_Spe cification 65 / 71 GNSS Module Series 3 Appendix A References Table 5: Terms and Abbreviations Abbre v iation De scription 2D 2 Dimension 3D 3 Dimension C/N0 Carrier-to-Noise Ratio COG Course over Ground COGM Course over Ground (in Magnetic North Course Direction) COGT Course over Ground (in True North Course Direction) CPU Central Processing Unit DOP Dilution of Precision DSP Digital Signal Processing FDE False Detection Exclusion GGA Global Positioning System Fix Data GLL Geographic Position - Latitude and Longitude GLONASS Global Navigation Satellite System (Russia) GNSS Global Navigation Satellite System GPS Global Positioning System GSA GPS DOP and Active Satellites GST Galileo System Time GSV GNSS Satellites in View HDOP Horizontal Dilution of Precision LC29T(AA)&LC99T(IA)_GNSS_Protocol_Spe cification 66 / 71 Abbre v iation IRNSS MTB NavIC NCO NMEA NTSC NVM PDOP PLL PPS QZSS RF RMC RTC SBAS SNR SOG SPS TCXO TOW TRAIM UTC VDOP VTG GNSS Module Series De scription Indian Regional Navigation Satellite System Master Time-Base Navigation with Indian Constellation Numerically Controlled Oscillator NMEA (National Marine Electronics Association) 0183 Interface Standard National Time Service Center Non-Volatile Memory Position Dilution of Precision Phase Locked Loop Pulse Per Second Quasi-Zenith Satellite System Radio Frequency Recommended Minimum Specific GNSS Data Real-Time Clock Satellite-Based Augmentation System Signal to Noise Ratio Speed over Ground Standard Positioning Service Temperature Compensated Crystal Oscillator Time of Week Time Receiver Autonomous Integrity Monitoring Coordinated Universal Time Vertical Dilution of Precision Course Over Ground & Ground Speed LC29T(AA)&LC99T(IA)_GNSS_Protocol_Spe cification 67 / 71 Abbre v iation ZDA De scription Time & Date GNSS Module Series LC29T(AA)&LC99T(IA)_GNSS_Protocol_Spe cification 68 / 71 GNSS Module Series 4 Appendix B GNSS Satellites (NMEA) Numbering Table 6: GNSS Satellite (NMEA) Numbering GNSS Type System ID GPS 1 GLONASS 2 Galileo 3 BDS 4 QZSS 5 IRNSS 6 Satellite ID 01–99 01–32 are reserved for GPS 33–64 are reserved for SBAS 65–99 are undefined 01–99 33–64 are reserved for SBAS 65–99 are reserved for GLONASS 01–99 01–36 are reserved for Galileo 37–64 are reserved for SBAS 65–99 are undefined 01–99 01–64 are reserved for BDS 65–99 are undefined 01–99 01–10 are reserved for QZSS 55–63 are reserved for SBAS 64–99 are undefined 01–99 01–15 are reserved for IRNSS 33–64 are reserved for SBAS 16–32 and 65–99 are undefined Signal ID Signal Channel 1 L1 C/A 7 L5-I 1 L1 C/A 1 E5a 7 E1 1 B1I 5 B2a 1 L1 C/A 7 L5-I 7 L5 NOTE Table above is only applicable to standard NMEA messages. LC29T(AA)&LC99T(IA)_GNSS_Protocol_Spe cification 69 / 71 GNSS Module Series 5 Appendix C Other Basic Commands 5.1. Query Software Version $PSTMGETPAR,1,63*3B $PSTMGETPAR,1,P63,0,LC99TIANR01A01V02*01 NOTE Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMGETPAR. 5.2. Change Baud Rate The following NMEA commands are used to change the baud rate: Synopsis: $PSTMSETPAR,1,15,0,0,* Parame te r: Fie ld Format Unit Hexadecimal bps De scription 0xA = 115200 0xB = 230400 0xC = 460800 0xD = 921600 Example : $PSTMSETPAR,1,15,0,0,0xA*0B $PSTMSETPAROK,P01,L15,F00,0000000a*11 $PSTMSAVEPAR*58 LC29T(AA)&LC99T(IA)_GNSS_Protocol_Spe cification 70 / 71 GNSS Module Series NOTE After issuing all commands in the example of changing baud rate, the module must be restarted for the command to take effect. LC29T(AA)&LC99T(IA)_GNSS_Protocol_Spe cification 71 / 71

LC29H (BS) GNSS 协议规范 GNSS 模块系列 版本：1.0 日期：2023-12-20 状态：受控文件 LC29H (BS) GNSS 协议规范 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 27 LC29H (BS) GNSS 协议规范 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 27 LC29H (BS) GNSS 协议规范 文档历史 文档信息 标题 副标题 文档类别 文档状态 LC29H (BS) GNSS 协议规范 GNSS 模块系列 GNSS 协议规范 受控文件 修订记录 版本 1.0 日期 2023-09-28 2023-12-20 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 27 LC29H (BS) GNSS 协议规范 目录 文档历史 .................................................................................................................................................... 3 目录 ........................................................................................................................................................... 4 表格索引 .................................................................................................................................................... 5 1 引言 .................................................................................................................................................... 6 2 NEMA 协议 ........................................................................................................................................ 7 2.1. NMEA 协议消息结构................................................................................................................ 7 2.2. PQTM 消息 .............................................................................................................................. 8 2.2.1. PQTMCFGSVIN ........................................................................................................... 8 2.2.2. PQTMSAVEPAR ......................................................................................................... 10 2.2.3. PQTMRESTOREPAR ..................................................................................................11 2.2.4. PQTMVERNO............................................................................................................. 12 2.2.5. PQTMCFGMSGRATE ................................................................................................ 13 2.2.6. PQTMEPE .................................................................................................................. 14 2.2.7. PQTMSVINSTATUS ................................................................................................... 15 2.3. PAIR 消息 .............................................................................................................................. 16 2.3.1. PAIR001: PAIR_ACK .................................................................................................. 16 2.3.2. PAIR432: PAIR_RTCM_SET_OUTPUT_MODE ......................................................... 17 2.3.3. PAIR433: PAIR_RTCM_GET_OUTPUT_MODE......................................................... 18 2.3.4. PAIR434: PAIR_RTCM_SET_OUTPUT_ANT_PNT ................................................... 19 2.3.5. PAIR435: PAIR_RTCM_GET_OUTPUT_ANT_PNT ................................................... 19 2.3.6. PAIR436: PAIR_RTCM_SET_OUTPUT_EPHEMERIS............................................... 20 2.3.7. PAIR437: PAIR_RTCM_GET_OUTPUT_EPHEMERIS .............................................. 21 2.3.8. PAIR864: PAIR_IO_SET_BAUDRATE........................................................................ 22 3 RTCM 协议....................................................................................................................................... 24 4 附录 A 参考文档及术语缩写 ............................................................................................................ 26 5 附录 B 特殊字符 .............................................................................................................................. 27 上海移远通信技术股份有限公司 4 / 27 LC29H (BS) GNSS 协议规范 表格索引 表 1：支持的协议 ...................................................................................................................................... 6 表 2：NMEA 语句结构............................................................................................................................... 7 表 3：错误码 ............................................................................................................................................. 8 表 4：支持的语句 .................................................................................................................................... 14 表 5：支持的 RTCM 3 消息 ..................................................................................................................... 24 表 6：术语缩写........................................................................................................................................ 26 表 7：特殊字符........................................................................................................................................ 27 上海移远通信技术股份有限公司 5 / 27 LC29H (BS) GNSS 协议规范 1 引言 移远通信 LC29H (BS) GNSS 模块支持 GPS、GLONASS、Galileo、BDS 和 QZSS 定位，可以同时快 速捕获跟踪 GPS L1 C/A、GLONASS L1、Galileo E1、BDS B1l、QZSS L1 C/A、GPS L5、Galileo E5a、 BDS B2a 和 QZSS L5 频段。模块可用于基站和输出 RTK 校正信息。 本文档主要介绍用于控制和配置模块所需的软件命令；所述命令是由移远通信或芯片供应商定义的 NMEA 专有语句（PQTM/PAIR 命令）。模块还支持通过 RTCM 协议输出语句上报 GNSS 信息。 LC29H (BS)模块支持以下协议： 表 1：支持的协议 协议 消息类型 NMEA 0183 V3.01/V4.10 输入/输出，ASCII，专有 RTCM 10403.3 输出，二进制 备注 请使用本文档列出的命令控制或配置模块；对本文档未列出的其他命令情况，移远通信不承担任何责任。 上海移远通信技术股份有限公司 6 / 27 LC29H (BS) GNSS 协议规范 2 NEMA 协议 2.1. NMEA 协议消息结构 每一帧的起始字段，固定 均为 $ 地址字段，包含了Talker ID和语句的属性 以 * 开始，校验和为8位 异或的校验和转换成的十六 进制的数 数据字段，使用 , 隔开 结束字符，固定为 $ () [,] * 校验和的计算范围 图 1：NMEA 协议消息结构 表 2：NMEA 语句结构 字段 描述 $ NMEA 语句的起始字段（Hex 0x24）。 NMEA 专有语句： 专有地址字段由专有字符'P'、制造商助记码（三个字符）、以及可选附加字符组成。其 中制造商助记码用来标识发出一个专有语句的发送设备。 数据字段，由数据字段分隔符','分隔。 可变长度（取决于 NMEA 消息类型）。 所有的语句中都应包含校验和字段。校验和字段是语句中的最后一个字段，在校验和定界 符'*'之后。 校验和是对语句中所有字符的 8 位（不包括起始和结束位）进行异或运算，所有字符是指 在定界符'$'与'*'之间，但不包括这些定界符的全部字符，包括','在内。 NMEA 语句的结束字符（Hex 0x0D 0x0A）。 上海移远通信技术股份有限公司 7 / 27 LC29H (BS) GNSS 协议规范 NMEA 校验和示例代码： // pData is the data array whose checksum needs to be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL = = pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^ = *(pData + i); } return result; } 2.2. PQTM 消息 本章节介绍 LC29H (BS)模块支持的 PQTM 消息（由移远通信定义的 NMEA 专有语句）。 表 3：错误码 字段 格式 十进制 单位 - 描述 错误码。 1 = 参数无效 2 = 执行失败 2.2.1. PQTMCFGSVIN 设置/查询测量（survey-in）功能。该功能支持在测量（Survey-in）模式或固定（Fixed）模式下获取天 线位置。 为使模块作为基站运行，模块外部天线应安装在固定点上（尽量选择具有良好天空视野、避免遮挡的位 置安装）。天线精确的坐标位置可以通过自测过程获得。测量模式（ = 1）通过建立所有有效 3D 定 位结果的加权平均值来确定接收机的位置。可通过设置和确定用于位置估计 的最少定位次数和 3D 定位标准差。固定模式（ = 2）要求用户手动输入接收机位置坐标。基站位 上海移远通信技术股份有限公司 8 / 27 LC29H (BS) GNSS 协议规范 置的任何误差将直接转化为移动站位置误差。 类型： 设置/查询 格式： //设置： $PQTMCFGSVIN,W,,,,,,* //查询： $PQTMCFGSVIN,R* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 单位 - 米 米 米 米 描述 接收机模式。 0 = 禁用 1 = 测量（Survey-in）模式 2 = 固定（Fixed）模式（ARP 位置采用 ECEF 坐标系） 测量模式下最少定位次数。范围：0~86400。默认值：43200。 测量模式下 3D 定位精度。默认值：15.0。 该字段为 0 时，表示无 3D 定位精度限制。 WGS84 ECEF X 坐标。默认值：0.0。 WGS84 ECEF Y 坐标。默认值：0.0。 WGS84 ECEF Z 坐标。默认值：0.0。 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGSVIN,OK* //查询命令响应： $PQTMCFGSVIN,OK,,,,,,* 上海移远通信技术股份有限公司 9 / 27 LC29H (BS) GNSS 协议规范 ⚫ 如果失败，模块返回： $PQTMCFGSVIN,ERROR,* 详见表 3：错误码。 示例： //设置： $PQTMCFGSVIN,W,2,0,0.0,-2472446.4619,4828304.1363,3343730.2653*34 $PQTMCFGSVIN,OK*70 //查询： $PQTMCFGSVIN,R*26 $PQTMCFGSVIN,OK,2,0,0.0,-2472446.4619,4828304.1363,3343730.2653*67 备注 若需获取设置命令中部分参数未给出的默认值，可在未使用设置命令修改相关参数配置前，通过对应的 查询命令获取相应的默认值；若已使用设置命令修改过默认配置，可联系移远通信技术支持 （support@quectel.com）获取相关默认配置信息。 2.2.2. PQTMSAVEPAR 将 PQTM 命令设置的参数保存到 NVM 中。 类型： 命令 格式： $PQTMSAVEPAR* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMSAVEPAR,OK* 上海移远通信技术股份有限公司 10 / 27 ⚫ 如果失败，模块返回： $PQTMSAVEPAR,ERROR,* 详见表 3：错误码。 示例： $PQTMSAVEPAR*5A $PQTMSAVEPAR,OK*72 LC29H (BS) GNSS 协议规范 2.2.3. PQTMRESTOREPAR 将通过 PQTM 命令配置的所有参数恢复为默认值。该命令重启后生效。 类型： 命令 格式： $PQTMRESTOREPAR* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMRESTOREPAR,OK* ⚫ 如果失败，模块返回： $PQTMRESTOREPAR,ERROR,* 详见表 3：错误码。 示例： $PQTMRESTOREPAR*13 $PQTMRESTOREPAR,OK*3B 上海移远通信技术股份有限公司 11 / 27 LC29H (BS) GNSS 协议规范 2.2.4. PQTMVERNO 查询固件版本信息。 类型： 命令 格式： $PQTMVERNO* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMVERNO,,,* ⚫ 如果失败，模块返回： $PQTMVERNO,ERROR,* 结果中包含的参数： 字段 格式 单位 字符串 - yyyy/mm/dd - hh:mm:ss - 详见表 3：错误码。 描述 固件版本 固件创建日期 固件创建时间 示例： $PQTMVERNO*58 $PQTMVERNO,LC29HBSNR01A01S,2022/08/31,15:22:59*27 上海移远通信技术股份有限公司 12 / 27 LC29H (BS) GNSS 协议规范 2.2.5. PQTMCFGMSGRATE 设置/查询语句输出速率。 类型： 设置/查询 格式： //设置： $PQTMCFGMSGRATE,W,,,* //查询： $PQTMCFGMSGRATE,R,,* 参数： 字段 格式 字符串 十进制 十进制 单位 - 描述 语句。详见表 4：支持的语句。 语句输出频率。 0 = 不输出 N = 每 N 次定位输出一次 N 的范围详见表 4：支持的语句。 语句版本。 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGMSGRATE,OK* //查询命令响应： $PQTMCFGMSGRATE,OK,,,* ⚫ 如果失败，模块返回： $PQTMCFGMSGRATE,ERROR,* 详见表 3：错误码。 上海移远通信技术股份有限公司 13 / 27 示例： //设置$PQTMEPE 语句的输出频率为每定位一次输出一次： $PQTMCFGMSGRATE,W,PQTMEPE,1,2*1D $PQTMCFGMSGRATE,OK*29 //查询$PQTMEPE 语句的输出频率： $PQTMCFGMSGRATE,R,PQTMEPE,2*05 $PQTMCFGMSGRATE,OK,PQTMEPE,1,2*4E //设置$PQTMSVINSTATUS 语句的输出频率为每定位一次输出一次： $PQTMCFGMSGRATE,W,PQTMSVINSTATUS,1,1*58 $PQTMCFGMSGRATE,OK*29 //查询$PQTMSVINSTATUS 语句的输出频率： $PQTMCFGMSGRATE,R,PQTMSVINSTATUS,1*40 $PQTMCFGMSGRATE,OK,PQTMSVINSTATUS,1,1*0B LC29H (BS) GNSS 协议规范 表 4：支持的语句 语句 $PQTMSVINSTATUS $PQTMEPE 语句输出频率范围（N） 1~20 1~20 2.2.6. PQTMEPE 输出估计的定位误差。 类型： 输出 格式： $PQTMEPE,,,,,,* 上海移远通信技术股份有限公司 14 / 27 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 单位 米 米 米 米 米 LC29H (BS) GNSS 协议规范 描述 语句版本。 2 = 版本 2（此版本始终为 2） 估计北误差。 估计东误差。 估计高度误差。 估计 2D 位置误差。 估计 3D 位置误差。 示例： $PQTMEPE,2,3.259,3.303,15.440,4.640,16.122*5E 2.2.7. PQTMSVINSTATUS 输出测量（survey-in）状态。 类型： 输出 格式： $PQTMSVINSTATUS,,,,,,,,,,,* 参数： 字段 格式 十进制 十进制 十进制 单位 描述 语句版本。 - 1 = 版本 1（此版本始终为 1） 毫秒 GPS 周时间。 测量位置有效性标志。 0 = 无效 - 1 = 进行中 2 = 有效 上海移远通信技术股份有限公司 15 / 27 LC29H (BS) GNSS 协议规范 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 描述 - 预留。 - 预留。 - 测量期间使用的当前位置观测数。 通过$PQTMCFGSVIN 命令中字段配置的最少定位 - 次数。 米 ECEF 坐标系下沿 X 轴的当前测量平均位置。 米 ECEF 坐标系下沿 Y 轴的当前测量平均位置。 米 ECEF 坐标系下沿 Z 轴的当前测量平均位置。 米 当前测量平均位置精度估计。 示例： $PQTMSVINSTATUS,1,2241,1,,01,538,43200,-2472436.0802,4828383.0026,3343698.4839,9.5*38 2.3. PAIR 消息 本章介绍 LC29H (BS)模块支持的 PAIR 消息（由芯片供应商定义的专有 NMEA 消息）。 PAIR 消息格式： $PAIR[,] Packet Type：每个 PAIR 消息的标识符，为 000 到 999 的三字节字符串。 Data：该字段可以省略，也可通过数据字段分隔符','分隔多个字段。不同的命令对应不同的数据。详情 如下。 2.3.1. PAIR001: PAIR_ACK PAIR 命令的应答语句。模块返回$PAIR001，通知发送方其已收到数据包。 类型： 输出 上海移远通信技术股份有限公司 16 / 27 LC29H (BS) GNSS 协议规范 格式： $PAIR001,,* 参数： 字段 格式 单位 十进制 - 十进制 - 描述 待应答的命令类型。 结果。 0 = 命令已成功发送。 1 = 正在处理命令，请等待结果。 2 = 命令发送失败。 3 = 不支持。 4 = 命令参数错误，如超出范围、部分参数丢失或校验和错误。 5 = MNL 服务正忙。可稍后重新发送命令。 示例： $PAIR001,432,0*3E 2.3.2. PAIR432: PAIR_RTCM_SET_OUTPUT_MODE 设置 RTCM 输出模式。 类型： 设置 格式： $PAIR432,* 参数： 字段 格式 十进制 单位 - 描述 RTCM 输出模式设置。 -1 = 禁用输出 RTCM 消息 0 = 启用输出 RTCM3 消息（消息类型为 MSM4） 1 = 启用输出 RTCM3 消息（消息类型为 MSM7） 上海移远通信技术股份有限公司 17 / 27 结果： 返回$PAIR001 消息。 示例： $PAIR432,1*22 $PAIR001,432,0*3E LC29H (BS) GNSS 协议规范 2.3.3. PAIR433: PAIR_RTCM_GET_OUTPUT_MODE 查询 RTCM 输出模式。 类型： 查询 格式： $PAIR433* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR433,* 结果中包含的参数： 字段 格式 单位 十进制 - 描述 RTCM 输出模式设置。 -1 = 禁用输出 RTCM 消息 0 = 启用输出 RTCM3 消息（消息类型为 MSM4） 1 = 启用输出 RTCM3 消息（消息类型为 MSM7） 上海移远通信技术股份有限公司 18 / 27 示例： $PAIR433*3E $PAIR001,433,0*3F $PAIR433,-1*0E LC29H (BS) GNSS 协议规范 2.3.4. PAIR434: PAIR_RTCM_SET_OUTPUT_ANT_PNT 启用/禁用以 RTCM 格式输出静态天线参考点。 类型： 设置 格式： $PAIR434,* 参数： 字段 格式 十进制 单位 - 描述 启用/禁用输出静态天线参考点（消息类型 1005）。 0 = 禁用 1 = 启用 结果： 返回$PAIR001 消息。 示例： $PAIR434,1*24 $PAIR001,434,0*38 2.3.5. PAIR435: PAIR_RTCM_GET_OUTPUT_ANT_PNT 查询 RTCM 格式的静态天线参考点输出状态。 类型： 查询 上海移远通信技术股份有限公司 19 / 27 LC29H (BS) GNSS 协议规范 格式： $PAIR435* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR435,* 结果中包含的参数： 字段 格式 十进制 单位 - 描述 静态天线参考点输出状态（消息类型 1005）。 0 = 禁用 1 = 启用 示例： $PAIR435*38 $PAIR001,435,0*39 $PAIR435,1*25 2.3.6. PAIR436: PAIR_RTCM_SET_OUTPUT_EPHEMERIS 启用/禁用以 RTCM 格式输出卫星星历信息。 类型： 设置 格式： $PAIR436,* 上海移远通信技术股份有限公司 20 / 27 参数： 字段 格式 单位 十进制 - 结果： 返回$PAIR001 消息。 示例： $PAIR436,1*26 $PAIR001,436,0*3A LC29H (BS) GNSS 协议规范 描述 启用/禁用以 RTCM 格式输出卫星星历。 0 = 禁用 1 = 启用 2.3.7. PAIR437: PAIR_RTCM_GET_OUTPUT_EPHEMERIS 查询 RTCM 格式的卫星星历输出状态。 类型： 查询 格式： $PAIR437* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR437,* 上海移远通信技术股份有限公司 21 / 27 结果中包含的参数： 字段 格式 单位 十进制 - 示例： $PAIR437*3A $PAIR001,437,0*3B $PAIR437,1*27 LC29H (BS) GNSS 协议规范 描述 RTCM 格式的卫星星历输出状态。 0 = 禁用 1 = 启用 2.3.8. PAIR864: PAIR_IO_SET_BAUDRATE 设置 UART 接口的波特率（默认波特率为 115200 bps）。 类型： 设置 格式： $PAIR864,,,* 参数： 字段 格式 十进制 十进制 十进制 单位 - bps 描述 硬件接口类型。 0 = UART 硬件接口号。 0 = UART1 波特率。 4800 9600 19200 38400 57600 115200 230400 460800 921600 上海移远通信技术股份有限公司 22 / 27 字段 格式 单位 描述 3000000 LC29H (BS) GNSS 协议规范 结果： 返回$PAIR001 消息。 示例： $PAIR864,0,0,115200*1B $PAIR001,864,0*31 备注 1. 须在修改接口波特率后重启模块，所做更改将在模块重启后生效。 2. 输出波特率低于 115200 bps 时，模块可能会丢失消息。 上海移远通信技术股份有限公司 23 / 27 LC29H (BS) GNSS 协议规范 3 RTCM 协议 LC29H (BS) 模 块 支 持 RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services - Version 3 协议。该协议用于传输 GNSS 原始测量数据，可通过 https://www.rtcm.org/ 获取。 表 5：支持的 RTCM 3 消息 消息类型 模式 1005 1019 输出 输出 1020 输出 1042 输出 1044 输出 1046 1074 输出 输出 1077 输出 1084 1087 输出 输出 1094 输出 1097 输出 1114 输出 1117 1124 输出 输出 1127 输出 消息名称 静态 RTK 参考站 ARP GPS 星历 GLONASS 星历 BDS 卫星星历数据 QZSS 星历 Galileo I/NAV 卫星星历数据 GPS MSM4 GPS MSM7 GLONASS MSM4 GLONASS MSM7 Galileo MSM4 Galileo MSM7 QZSS MSM4 QZSS MSM7 BDS MSM4 BDS MSM7 上海移远通信技术股份有限公司 24 / 27 LC29H (BS) GNSS 协议规范 备注 1. 若相应的星系已被启用，$PAIR432 命令可用于启用或禁用 MSM4/MSM7（1074、1077、1084、 1087、1094、1097、1114、1117、1124 和 1127）消息。 2. $PAIR434 命令可用于启用或禁用静态 RTK 参考站 ARP（1005）消息。 3. 若相应的星系已被启用，$PAIR436 命令可用于启用或禁用星历（1019、1020、1042、1044 和 1046） 消息。 上海移远通信技术股份有限公司 25 / 27 LC29H (BS) GNSS 协议规范 4 附录 A 参考文档及术语缩写 表 6：术语缩写 缩写 英文全称 中文全称 ACK Acknowledgement 确认消息 ARP ASCII BDS Antenna Reference Point 天线参考点 American Standard Code for Information 美国信息交换标准码 Interchange BeiDou Navigation Satellite System 北斗卫星导航系统 ECEF Earth-Centered, Earth-Fixed 地心地固坐标系 Galileo Galileo Satellite Navigation System (EU) 伽利略卫星导航系统（欧盟） GNSS GPS Global Navigation Satellite System Global Positioning System 全球导航卫星系统 全球定位系统 MNL MSM NMEA NVM PAIR Middleware Navigation Library 导航中间件库 Multiple Signal Messages 多信号消息 NMEA (National Marine Electronics NMEA（美国国家海洋电子协会）0183 Association) 0183 Interface Standard 接口标准 Non-Volatile Memory 非易失性存储器 Proprietary Protocol of Airoha Airoha 专有协议 QZSS RTCM RTK Quasi-Zenith Satellite System 准天顶卫星系统（日本） Radio Technical Commission for Maritime 海事无线电技术委员会 Services Real-Time Kinematic 实时动态 UART WGS84 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 World Geodetic System 1984 世界大地坐标系 1984 上海移远通信技术股份有限公司 26 / 27 LC29H (BS) GNSS 协议规范 5 附录 B 特殊字符 表 7：特殊字符 特殊字符 […] {…} 下划线 描述 参数名称（实际命令中不包含尖括号） 可选参数（实际命令中不包含方括号） 循环参数（实际命令中不包含大括号） 参数的默认设置 上海移远通信技术股份有限公司 27 / 27

LG69T (AB) GNSS 协议规范 GNSS 模块系列 版本：1.0 日期：2024-04-22 状态：受控文件 LG69T(AB) GNSS 协议规范 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/supp 或 t/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/supp 或 t/technical.htm 或发送邮件至：supp 或 t@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 32 LG69T(AB) GNSS 协议规范 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 32 LG69T(AB) GNSS 协议规范 关于文档 文档信息 标题 副标题 文档类别 文档状态 LG69T (AB) GNSS 协议规范 GNSS 模块系列 GNSS 协议规范 受控文件 修订记录 版本 1.0 日期 2024-01-26 2024-04-22 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 32 LG69T(AB) GNSS 协议规范 目录 关于文档 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 E2E 协议 ............................................................................................................................................... 8 2.1. E2E 通信介绍 ............................................................................................................................. 8 3 RTCM 协议.......................................................................................................................................... 10 3.1. RTCM3 协议消息的结构........................................................................................................... 10 3.2. RTCM 数据字段.........................................................................................................................11 3.2.1. 支持的频段 .................................................................................................................... 15 3.2.2. 信号标识符（DF82P）和跟踪模式（DF86P） ............................................................. 17 3.3. 标准 RTCM 消息....................................................................................................................... 20 3.4. 专有 RTCM 消息....................................................................................................................... 21 3.4.1. RSS（子类型 ID = 1） .................................................................................................. 21 3.4.2. RCC（子类型 ID = 2）.................................................................................................. 24 3.4.3. POSQM（子类型 ID = 5） ............................................................................................ 25 3.4.4. IFB（子类型 ID = 8） .................................................................................................... 25 3.4.5. EPVT（子类型 ID = 21） .............................................................................................. 25 3.4.6. RFS（子类型 ID = 24） ................................................................................................ 27 3.4.7. FWVER（子类型 ID = 25） .......................................................................................... 28 3.4.8. SIGQM2（子类型 ID = 26） ......................................................................................... 28 4 附录 A 术语缩写.................................................................................................................................. 29 5 附录 B 特殊字符 .................................................................................................................................. 32 上海移远通信技术股份有限公司 4 / 32 LG69T(AB) GNSS 协议规范 表格索引 表 1：支持的协议 ......................................................................................................................................... 7 表 2：传输前导码 ......................................................................................................................................... 9 表 3：传输序列中的 E2E 帧头...................................................................................................................... 9 表 4：RTCM3 协议消息字段说明 ............................................................................................................... 10 表 5：数据字段表 ........................................................................................................................................11 表 6：星系掩码（卫星类型） ..................................................................................................................... 15 表 7：多频/跟踪模式掩码 ........................................................................................................................... 16 表 8：信号 ID 星系编码 .............................................................................................................................. 18 表 9：卫星类型和选择器字段 ..................................................................................................................... 18 表 10：支持的 RTCM3 消息 ....................................................................................................................... 20 表 11：芯片供应商专有 RTCM 消息列表 ................................................................................................... 21 表 12：SIS 错误码...................................................................................................................................... 23 表 13：监控告警掩码.................................................................................................................................. 23 表 14：术语缩写 ......................................................................................................................................... 29 表 15：特殊字符 ......................................................................................................................................... 32 上海移远通信技术股份有限公司 5 / 32 LG69T(AB) GNSS 协议规范 图片索引 图 1：E2E 协议消息结构 .............................................................................................................................. 8 图 2：RTCM3 协议消息的结构................................................................................................................... 10 图 3：信号 ID（DF82P）结构.................................................................................................................... 17 上海移远通信技术股份有限公司 6 / 32 LG69T(AB) GNSS 协议规范 1 引言 移远通信 LG69T(AB) GNSS 模块支持 GPS、GLONASS、Galileo、BDS、和 QZSS 定位。可以同时 快速捕获跟踪 GPS L1 C/A, L5, L2C、GLONASS L1、Galileo E1, E5a, E5b、BDS B1I, B2a, B2I 和 QZSS L1 C/A, L5, L2C 频段，使该模块成为各种垂直行业实现精准定位和导航的理想解决方案。 LG69T (AB)模块支持以下协议： 表 1：支持的协议 协议 E2E RTCM 10403.3 类型 输出、二进制、专有 输出、二进制、标准 输出、二进制、专有 备注 1. LG69T (AB)主要支持 L1 + L5 频段，也可以通过不同的配置支持 L1 + L2 频段。 2. 请使用本文档列出的命令控制或配置模块；对本文档未列出的其他命令情况，移远通信不承担任 何责任。 上海移远通信技术股份有限公司 7 / 32 LG69T(AB) GNSS 协议规范 2 E2E 协议 2.1. E2E 通信介绍 LG69T (AB)和主机之间的 End-To-End（E2E）通信和功能安全相关。为了减少可能因通信信道中的 传播延迟或位错误而产生的错误信息，定义了附加协议层。该协议层对 PDU（RTCM 数据）进行了扩展， 提供时间戳功能用于预估传输延迟并增加错误校验功能。 AUTOSAR E2E E2E 功能模块根据所选的 AUTOSAR E2E 配置文件格式化并封装输出消息（RTCM3）。计数器会基于 每条发送消息所含有效载荷的数据 ID 进行递增，并且根据 E2E 配置文件计算 CRC。该引擎是线程安全的、 没有复用功能，这意味着每个 RTCM3 帧都封装在单个 E2E 帧中。在接收端，协议栈在预期前缀上同步后 查找协议字段。非预期或不支持的值将报告给 SIS 中的 EFM 监控器。然后根据 E2E 配置文件检查数据包 并检查 E2E 帧头。协议栈将数据包存储到预期长度并验证 CRC。CRC 不匹配会报告给 SIS 中的 ECRC 监 控器。计数器在接收每个数据包时会根据有效载荷数据 ID 进行递增，但接收到的第一个消息的计数器值是 不递增的。CRC 不匹配都会报告给 SIS 中的 ECM 监控器。 E2E 协议栈消息结构如下图所示，所含单元信息列举如下： ⚫ 传输前导码，由同步序列和有效载荷信息组成，参考表 2：传输前导码。 ⚫ E2E 协议帧头，参考表 3：传输序列中的 E2E 帧头。 ⚫ 基于 RTCM3 数据帧的应用 PDU（第 3.1 章 RTCM3 协议消息的结构）。 4 字节, 由同步序列 和有效载荷信息组成 2 字节, 从E2E长度 到RTCM CRC 2 字节 4 字节 4 字节 传输前导码 E2E 长度 E2E 计数器 E2E 数据ID E2E CRC RTCM3数据帧 校验和计算范围（E2E CRC除外） 图 1：E2E 协议消息结构 上海移远通信技术股份有限公司 8 / 32 LG69T(AB) GNSS 协议规范 备注 有关 RTCM3 数据帧详细信息，请参考第 3.1 章 RTCM3 协议消息的结构。 表 2：传输前导码 前导码 字节 0 字节 1 字节 2 有效载荷信息 位 7 6 5 4 3 2 1 0 76 5 4 3 2 1 0 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 二进制值 0 0 0 0 1 1 1 1 1 1 1 1 0 0 0 0 0 1 0 1 1 0 1 0 0 0 0 0 0 0 1 1 十六进制值 0F F0 5A 03 传输前导码的同步序列由 3 字节序列组成（十六进制格式）： 0F F0 5A 发送的有效载荷信息字节如下： ⚫ 位 1 和位 0：E2E 配置文件（3 = AUTOSAR 配置文件 4） ⚫ 位 3 和位 2：同步配置文件（0 = 时间同步） ⚫ 位 5 和位 4：应用协议（0 = RTCM3） ⚫ 位 7 和位 6：预留位（固定为 0） 携带 RTCM3 有效载荷的消息的传输前导码： 0F F0 5A 03 表 3：传输序列中的 E2E 帧头 字节 0 传输序列 字节 1 字节 2 字节 3 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 0 E2E 长度 E2E 计数器 4 E2E 数据 ID 8 E2E CRC 校验 示例: 0F F0 5A 03 00 4B 00 4B 12 34 56 78 B8 B9 D4 DE D3 00 39 3E 71 50 01 FC 2B FF FF FF FF FE 00 07 FF FF F9 FF F8 7F FF FF FF FF FF FF 00 00 00 01 00 00 00 01 00 00 10 00 01 00 00 10 00 00 00 1F FF FF FF E0 00 00 00 00 00 00 00 00 DB 8E 90 上海移远通信技术股份有限公司 9 / 32 LG69T(AB) GNSS 协议规范 3 RTCM 协议 本章主要介绍 LG69T (AB)支持的 RTCM 标准协议和专有协议。LG69T (AB)模块支持的标准 RTCM 协 议符合 RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services Version 3 规范。该协议用于传输 GNSS 原始测量数据，可从 https:// www.rtcm.org/获取。LG69T (AB)模 块支持的芯片供应商专有的 RTCM 协议是 RTCM 消息类型 999。 3.1. RTCM3 协议消息的结构 8位，固定为 11010011 6位，固定为 000000 10位 可变长度 24位 前导码 预留 长度 数据内容 CRC校验 校验和计算范围 图 2：RTCM3 协议消息的结构 表 4：RTCM3 协议消息字段说明 字段 前导码 预留 长度 数据内容 CRC 校验 描述 RTCM3 协议前导码（8 位），固定为 11010011。 预留（6 位），固定为 000000。 消息字段长度（10 位）。 消息的有效载荷（可变长度）。 校验和（24 位）。 上海移远通信技术股份有限公司 10 / 32 LG69T(AB) GNSS 协议规范 3.2. RTCM 数据字段 RTCM 消息数据字段如下表所示。 后缀'P'标识专有数据字段。 表 5：数据字段表 DF DF 名称 DF002 消息号 DF 范围 0~4095 DF 分辨率 - DF003 DF004 DF009 参考站 ID GPS 周内秒 （TOW） GPS 卫星 ID 0~4095 - 0~604799999 1 毫秒 1~64 - DF021 ITRF 实际年份 - - DF038 GLONASS 卫星 ID 0~63 - DF054 闰秒，GPS-UTC 0~254 1秒 DF22P 监控告警掩码 - - DF252 Galileo 卫星 ID 0~63 - DF429 QZSS 卫星 ID 1~10 - DF488 BDS 卫星 ID 1~64 - DF01P 时间/PPS 状态 0~255 - 数据类型 备注 uint12 uint12 uint30 uint6 999（专有协议专用号） 差分参考站 ID 0x3FF = 无效 由最佳时间转换为 GPS 系统时间 - uint6 预留 uint6 uint8 Uint32 uint6 uint4 uint6 uint8 - UTC 转换为 GPS-UTC 产 生的时间差。 0xFF =无效或未提供 每个监控器对应一位。 0 = 正常 1 = 告警 见表 13：监控告警掩码 - QZSS 卫星 ID 号 1~10 对 应 QZSS 卫星的 PRN 号 如下所示： 1：193 2：194 … 10：202 - 时间/PPS 状态： 0 = 有效 1~255 = 不可用或无效 上海移远通信技术股份有限公司 11 / 32 DF DF 名称 DF02P 子类型 ID DF 范围 0~255 DF16P GNSS 历元时间 - DF18P GPS 周数 - DF19P 固件版本 - DF21P 星系告警掩码 - DF25P 配置 — 页码 - DF26P 配置 — 页码掩码 - 配置 — 基本配置 DF27P 单元 - LG69T(AB) GNSS 协议规范 DF 分辨率 1 毫秒 1周 - - - 数据类型 备注 uint8 uint30 uint16 表 11：芯片供应商专有 RTCM 消息列表。 GNSS 历元时间。 0x3FFFFFFF = 无效 包括周翻转。 如果 GNSS 历元时间设置 为 0x3FFFFFFF，则该字 段无效。在这种情况下， 将报告 0xFFFF。 uint24 0xFFFFFF = 无效 uint32 星系告警掩码。 每个星系对应一位： 0 = 正常，1 = 异常 Bit 0：GPS Bit 1：GLONASS Bit 2：QZSS L1 C/A Bit 3：Galileo Bit 4：预留 Bit 5：预留 Bit 6：预留 Bit 7：BDS Bit 8：预留 Bit 9：GPS L2C Bit 10：预留 Bit 11：GPS L5 Bit 12：Galileo E5 Bit 13：预留 Bit 14：BDS B2a Bit 15：QZSS L2C Bit 16：QZSS L5 Bit 17：预留 Bit 18：BDS B2I Bit 19：Galileo E5B Bit 20~31：预留 注：Bit 0 是最低位 uint8 配置和控制页码。 uint16 配置页码掩码，一位可设 置一个配置字。 uint32 32 位的基本配置单元。 上海移远通信技术股份有限公司 12 / 32 LG69T(AB) GNSS 协议规范 DF DF 名称 DF 范围 DF 分辨率 GPS 质量指示 DF28P （定位状态） 0~15 - DF29P 参与定位卫星数量 - - DF30P 精度因子（DOP） 0~25.4 0.1 大地水准面间距， DF31P 米 ±163.83 0.01 米 DF32P 差分数据龄期 DF33P 差分参考站 ID DF37P 可见卫星总数 0~4095 - DF49P 继续下一条消息 - DF50P CDB 写入标志 - DF53P 响应 ID - 1 毫秒 - DF72P 时间 ID DF73P 纬度 DF74P 经度 0~15 - -3.24*10^8 至 3.24*10^8 -6.48*10^8 至 6.48*10^8 0.001 角秒 0.001 角秒 数据类型 备注 uint4 uint8 uint8 int15 int24 uint12 uint8 uint1 GPS 质量指示： 0 = 未定位或无效 1 = GPS SPS 模式，定位 有效 2 = 差分 GPS SPS 模 式，定位有效 参与定位卫星数量 0xFF = 无效 0xFF =无效 大地水准面高度偏差（地 球椭球面与位置解中使用 的参考基准定义的平均海 平面（大地水准面）表面 之间的差异）。 0x4000 = 无效 差分 GPS 数据龄期 0xFFFFFF = 无效 差分参考站 ID。 0x3FF = 无效 可见卫星总数 0xFF = 无效 0 = 结束 1 = 继续下一条消息（仅 用于输出）。 uint1 uint10 uint4 0 = 不写 消息响应标识符。请求响 应的消息号（0x0000 表 示不需要响应）。 时间 ID： 0 = GPS 1 = GLONASS 2 = QZSS 3 = Galileo 7 = BDS 14 = UTC 15 = 无效 int32 0x80000000 = 无效 int32 0x80000000 = 无效 上海移远通信技术股份有限公司 13 / 32 LG69T(AB) GNSS 协议规范 DF DF 名称 DF75P 高度 DF76P 水平速度 DF77P 垂直速度 DF78P 航向角 DF82P 信号标识 DF86P 跟踪模式 DF 范围 -524287 至 524287 -524287 至 524287 -524287 至 524287 0~3599 DF 分辨率 0.1 米 0.01 米/秒 0.01 米/秒 0.1 度 - - - - DF87P 时间有效性 0~15 - DF95P GNSS 星系掩码 - 32 GNSS 多频星系掩 DF96P 码 - 32 DF112P 配置区域 1~3 - DF113P 最佳卫星类型 - - 数据类型 备注 int20 0x80000 = 无效或不可用 （2D 定位） int20 0x80000 = 无效 int20 int16 uint16 uint8 uint4 uint32 uint32 uint2 uint5 0x80000 = 无效 0x8000 = 无效 参考第 3.2.2 章 信号标识 符（DF82P）和跟踪模式 （DF86P）。 参考第 3.2.2 章 信号标识 符（DF82P）和跟踪模式 （DF86P）。 时间类型： 0 = 无时间 1 = 从 Flash 读取的时间 2 = TOW 时间（周数不可 用） 3 = 用户设定的时间 4 = 用户设置的 RTC 时间 5 = 预估的 RTC 时间 6 = 准确的 RTC 时间 7 = 预估的时间 8 = 准确的时间 9 = 定位时间 10 = 星历时间 11~15 = 预留 参考表 6：星系掩码（卫 星类型）。 参考表 7：多频/跟踪模式 掩码。 输出消息中的配置区域： 1 = 当前配置（RAM） 2 = 默认配置 3 = NVM存储配置 参考表 9：卫星类型和选 择器字段。 上海移远通信技术股份有限公司 14 / 32 LG69T(AB) GNSS 协议规范 备注 RTCM 消息以十六进制格式输出，为了方便查看，部分参数在注释中进行了十进制或二进制格式转换。 3.2.1. 支持的频段 星系掩码是一个 32 位整数掩码，其中每个位表示是否支持相应的卫星系统或信号，符合表 6：星系掩 码（卫星类型）。 表 6：星系掩码（卫星类型） 位 系统 0 GPS 1 GLONASS 2 QZSS 3 Galileo 4~6 预留 7 BDS 8 预留 9 GPS 10 预留 11 GPS 12 Galileo 13 预留 14 BDS 15 QZSS 16 QZSS 信号 L1 C/A L1 L1 C/A E1 预留 B1I 预留 L2C 预留 L5 E5a 或 E5b 预留 B2I 或 B2a L2C L5 描述 0 = 不支持 1 = 支持 0 = 不支持 1 = 支持 0 = 不支持 1 = 支持 0 = 不支持 1 = 支持 0 0 = 不支持 1 = 支持 0 0 = 不支持 1 = 支持 0 0 = 不支持 1 = 支持 0 = 不支持 1 = 支持 0 0 = B2I 1 = B2a 0 = 不支持 1 = 支持 0 = 不支持 1 = 支持 上海移远通信技术股份有限公司 15 / 32 LG69T(AB) GNSS 协议规范 位 17~31 系统 预留 信号 预留 描述 0 多频掩码是一个 32 位整数掩码，其中每一位表示对应主频信号的星系是否启用双频分量（表 7：多频 /跟踪模式掩码）。该掩码的位含义与星系掩码略有不同，因为并非所有频段组合均支持，并且部分配置允 许为单个主频信号（例如 E1）选择不同的双频段（例如 E5a 或 E5b）。 表 7：多频/跟踪模式掩码 位 系统 信号 0 GPS L1 C/A 1 GLONASS L1 2 QZSS L1 C/A 3 Galileo E1 4~6 预留 7 BDS B1I 8 预留 9 GPS L2C 10 预留 11 GPS 12 Galileo 13 预留 L5 E5a 或 E5b 14 BDS B2a 15 QZSS L2C 16 17~22 23 24 QZSS L5 预留 双频捕获（L5）：0 = 关闭，1 = 打开 分频模式：0 = 关闭，1 =打开 多频点支持情况 0 = 不支持，1 = L2C 或 L5 0 = 不支持 0 = 不支持，1 = L2C 或 L5 0 = 不支持，1 = E5a 或 E5b 0 = 不支持，1 = B2a 或 B2I 0 = 数据，1 = 导频 0 = 导频，1 = 数据 0 = E5a，1 = E5b 0 = 导频，1 = 数据 0 = 数据，1 = 导频 0 = 导频，1 = 数据 上海移远通信技术股份有限公司 16 / 32 位 25 26 27 28~29 30 31 系统 GPS/QZSS Galileo Galileo 预留 Galileo 固定为 0 信号 L2C E1 E1 E5a/E5b LG69T(AB) GNSS 协议规范 多频点支持情况 双通道模式： 0 = 不支持，1 = 数据 + 导频电文 双通道模式： 0 = 不支持，1 = 数据 + 导频电文 自动数据/导频通道切换： 0 = 打开，1 = 关闭 0 = 导频，1 = 数据 3.2.2. 信号标识符（DF82P）和跟踪模式（DF86P） 信号标识符是一个无符号的 16 位数字，其结构如下所示。 信号ID 预留 选择器 1位 2位 卫星类型 5 位 PRN 8 位 跟踪模式 图 3：信号 ID（DF82P）结构 ⚫ PRN 字段： 对于每个星系，该字段根据下表设置为相应的 RTCM 数据字段（如果 RTCM 数据字段长度小于 8 位， 则仅使用较低有效位，其余位将设置为零）。 'PRN'通常被分配一个从'1'开始的值，用于识别特定的卫星信号。'PRN'的值不能为零。通 常需预留该字段以识别特殊信号 ID（例如，无效 ID）。 上海移远通信技术股份有限公司 17 / 32 LG69T(AB) GNSS 协议规范 表 8：信号 ID 星系编码 星系 GPS GLONASS Galileo BDS QZSS RTCM PRN 的数据字段 DF009 DF038 DF252 DF488 DF429 ⚫ 卫星类型字段：星系 ID，详见表 9：卫星类型和选择器字段。 ⚫ 选择器字段：选择器用于识别信号分量的特定跟踪模式，例如数据与导频、E5a 与 E5b、I 与 Q 分量 等，详见表 9：卫星类型和选择器字段。。 表 9：卫星类型和选择器字段 卫星类型 编号 系统 0 GPS 1 GLONASS 2 QZSS 3 Galileo 4 预留 5 QZSS 6 QZSS 7 BDS 8 BDS 3 9 GPS 信号 L1 C/A L1 L1 C/A E1B（数据） E1C（导频） 预留 L1 SAIF（预留） L1C（预留） B1I B2I B1C（预留） L2C CM（数据） 选择器 00 00 00 00 01 00 预留 预留 00 01 预留 00 上海移远通信技术股份有限公司 18 / 32 卫星类型 编号 系统 10 预留 11 GPS 12 Galileo 13 Galileo 14 BDS 3 15 QZSS 16 QZSS 17-31 预留 ⚫ 预留字段： 预留字段并设置为零。 信号 L2C CL（导频） 预留 L5-Q（导频） L5-I（数据） E5a-I（数据） E5a-Q（导频） E5b-I（数据） E5b-Q（导频） E6（预留） B2a L2C CM（数据） L2C CL（导频） L5-Q（导频） L5-I（数据） 预留 LG69T(AB) GNSS 协议规范 选择器 01 预留 00 01 00 01 10 11 预留 预留 00 01 00 01 预留 上海移远通信技术股份有限公司 19 / 32 3.3. 标准 RTCM 消息 LG69T (AB)模块支持的标准 RTCM 协议如下所示。 表 10：支持的 RTCM3 消息 消息类型 消息 1013 1019 1020 1042 1044 1046 1077 1087 1097 1117 1127 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 消息名称 系统参数 GPS 星历数据 GLONASS 星历数据 BDS 卫星星历数据 QZSS 星历数据 Galileo I/NAV 卫星星历数据 GPS MSM7 GLONASS MSM7 Galileo MSM7 QZSS MSM7 BDS MSM7 LG69T(AB) GNSS 协议规范 上海移远通信技术股份有限公司 20 / 32 LG69T(AB) GNSS 协议规范 3.4. 专有 RTCM 消息 LG69T (AB)模块支持的芯片供应商专有 RTCM 协议如下所示。 表 11：芯片供应商专有 RTCM 消息列表 子类型 ID 1 2 5 8 21 24 25 26 模式 输出 输出 输出 输出 输出 输出 输出 输出 描述 接收机状态和安全（RSS）。 接收机配置和控制（RCC）。 位置质量指标（POSQM）。 频间偏差（IFB）。 扩展的位置、速度和时间（EPVT）。 射频状态（RFS）。 固件版本（FWVER）。 信号质量指标 2（SIGQM2）。 3.4.1. RSS（子类型 ID = 1） 报告接收机状态和安全信息。 数据名称 DF 字段 位偏移 消息号 DF002 0 子类型 ID DF02P 12 GPS 周内秒（TOW） DF004 20 GPS 周数 DF18P 50 闰秒，GPS-UTC DF054 66 位宽 12 8 30 16 8 安全信息 - 74 1 协议版本标志 - 75 7 说明 999（专有消息号）。 子类型 ID = 1。接收机状态和安全信息。 由最佳时间转换为 GPS 系统时间。 由最佳时间转换为 GPS 系统周数。 见表 5：数据字段表 安全信息。 0 = 不可用 1 = 可用 RTCM 协议版本。 3 = RTCM 3.3 上海移远通信技术股份有限公司 21 / 32 LG69T(AB) GNSS 协议规范 数据名称 固件版本 安全状态 DF 字段 位偏移 DF19P 82 位宽 24 - 106 8 SIS 错误码 硬件错误码 时间/PPS 状态 时间有效性 星系告警掩码 - 114 8 - 122 8 DF01P 130 8 DF87P 138 4 DF21P 142 32 监控告警掩码 DF22P 174 32 GNSS 星系掩码 DF95P 206 32 GNSS 多频星系掩码 DF96P 238 32 NCO 时钟漂移 - 270 32 最佳时间卫星类型 DF113P - - GNSS 星系不可用掩码 DF95P 307 32 说明 0xFFFFFF = 无效。 安全状态。 0 = BOOT 1 = NORMAL 2 = FAULT 3 = FAULT_STOP SIS 错误码。 255 = 无错误 见表 12：SIS 错误码 硬件错误码。 80 = 无错误 时间/PPS 状态。 0 = 可用 1~255 = 不使用或不可用 见表 5：数据字段表 见表 5：数据字段表 每个监控器对应一位。 0 = 正常 1 = 告警 见表 13：监控告警掩码 见表 6：星系掩码（卫星类型） 见表 7：多频/跟踪模式掩码 0.0001 Hz（有符号整数) 仅当协议版本标志为 2 或 3 时存在。 仅当协议版本标志为 3 时存在。见表 9： 卫星类型和选择器字段。 无法计算 IFB 控器状态的卫星星系掩码 （仅当协议版本标志为 3 时存在） 备注 1. 星系告警掩码将每个监控器报告的所有星系掩码与告警状态位进行合并。它可能包含不参与定位的 星系，并且必须与 GNSS 星系掩码和 GNSS 多频星系掩码结合查看，仅考虑相关位。 2. 时间/PPS 状态合并了监控告警掩码中的 PPSOBSM、PPSM、SYSTM、PLM 和 CLKESTM 位。 3. 有关硬件错误代码的详细信息，请联系移远技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 22 / 32 表 12：SIS 错误码 数值 0 1 2 3 4 5 6 7 8 9 10~254 255 描述 硬件监控器配置 SIS 消息超时 监控超时 内存分配 未知消息类型 未知消息命令 SIS 初始化 外部 RF MTU 检查 冗余数据解码器 预留 无错误 LG69T(AB) GNSS 协议规范 表 13：监控告警掩码 位 名称 0 SIS 1 CIM-L1 2 HWM 3 IFM 4 RFM 5 SYSTM 6 Res 7 IFBM 8 NVMM 9 PPSOBSM 上海移远通信技术股份有限公司 描述（0 = 正常，1 = 告警） 整机 SIS 告警 观测数据的完整性 硬件故障 宽带干扰 射频调谐器 系统时间完整性 预留 频间偏差 NVM 写入速率完整性 PPS vs.可观测星历 FAULT_STOP 是 是 是 - 23 / 32 LG69T(AB) GNSS 协议规范 位 10 11 12 13 14 15 16 17 18 19 20 21~31 名称 CWM PPSM CLKESTM ECM ECRC EFM ASM DCM PLM SPFM MTM N/A 描述（0 = 正常，1 = 告警） 窄带干扰 时间和 PPS 完整性 RX 时钟估算完整性 E2E 计数器不匹配 E2E CRC 校验失败 E2E 框架错误 天线检测 数据损坏 防护等级监控器 欺骗监控器 消息定时监控器 预留 FAULT_STOP - 是 - 备注 上表中 FAULT_STOP 列设置为'是'的监控器被视为不可恢复。如果在规定时间内未收到 RTCM 消息，则需要通过外部主机使模块断电后重新上电或硬件复位来重新启动 LG69T (AB)。 3.4.2. RCC（子类型 ID = 2） 接收机配置和控制输出消息用于报告当前配置信息。模块共计有 64 个配置页面，每个配置页面由 16 个基本配置单元组成，每个基本配置单元有 32 位字。模块在启动时，将在输出中报告所有配置页面（每 个配置页面一条 RCC 消息）。 数据名称 消息号 子类型 ID 响应 ID 配置区域 DF DF002 DF02P DF53P 位偏移 位宽 0 12 12 8 20 10 DF112P 30 2 备注 999（专有消息号）。 子类型 ID = 2。接收机配置和控制。 输出消息中均为 0x0000。 输出消息中的配置区域： 1 = 当前配置（RAM） 2 = 默认配置 上海移远通信技术股份有限公司 24 / 32 LG69T(AB) GNSS 协议规范 数据名称 DF 位偏移 位宽 配置 — 页码 DF25P 32 继续下一条消息 DF49P 40 CDB 写入标志 DF50P 41 配置 — 页码掩码 DF26P 42 配置 — 基本配置单元 DF27P 58 8 1 1 16 32*N 备注 3 = NVM存储配置。 配置和控制页码。 0 = 结束 1 = 继续下一条消息 0 = 不写 每页 1 位： 默认：FFFF 最多 16 个基本配置单元 备注 如果继续下一条消息标志设置为 1，将会继续输出 RCC 消息；否则，当前消息是当前读取序列的最后一 位。 3.4.3. POSQM（子类型 ID = 5） 输出消息，仅用于移远通信内部调试。 3.4.4. IFB（子类型 ID = 8） 输出消息，仅用于移远通信内部调试。 3.4.5. EPVT（子类型 ID = 21） 报告接收机 PVT 在 LLH 坐标下的标准位置，以及扩展的定位信息。 数据名称 消息号 子类型 ID 参考站 ID ITRF 实际年份 GPS 质量指示 （定位状态） DF DF002 DF02P DF003 DF021 DF28P 位偏移 0 12 20 32 38 位宽 12 8 12 6 4 备注 999 (专有消息号)。 子消息 ID = 21 扩展的位置、速度和时间（EPVT）。 差分参考站 ID。 0x3FF = 不可用 预留 GPS 质量指示： 0 = 未定位或不可用 上海移远通信技术股份有限公司 25 / 32 数据名称 DF 位偏移 位宽 数据状态 - 42 1 定位频段模式 - 43 1 定位完整性（RAIM） - 44 1 预留 - 45 1 参与定位卫星数量 DF29P 46 8 可见卫星总数 DF37P 54 8 HDOP VDOP PDOP DF30P 62 8 DF30P 70 8 DF30P 78 8 大地水准面间距，米 DF31P 86 15 差分数据龄期 DF32P 101 24 差分参考站 ID DF33P 125 12 时间 ID DF72P 137 4 时间有效性 DF87P 141 4 GNSS 历元时间 DF16P 145 30 GPS 周数 DF18P 175 16 闰秒，GPS-UTC DF054 191 8 纬度 DF73P 199 32 经度 DF74P 231 32 LG69T(AB) GNSS 协议规范 备注 1 = GPS SPS 模式，定位有效 2 = 差分 GPS，SPS 模式，定位有效 数据状态： 0 = 数据有效 1 = 导航接收机告警 定位模式： 0 = 单频 1 = 多频 校验状态： 0 = 未校验 1 = 已校验 预留 参与定位的卫星数量。 0xFF = 无效 可见卫星总数 0xFF = 无效 水平精度因子。 垂直精度因子。 位置精度因子。 大地水准面差距（WGS84 基准面与平均 海平面之间的差值）。 0x4000 =无效 差分 GPS 系统数据龄期。 0xFFFFFF = 无效 差分数据参考站 ID。 0x3FF = 无效 时间 ID。 0xF = 无效 见表 5：数据字段表 分辨率：1 毫秒 0x3FFFFFFF = 无效 见表 5：数据字段表 见表 5：数据字段表 0x80000000 = 无效 0x80000000 = 无效 上海移远通信技术股份有限公司 26 / 32 LG69T(AB) GNSS 协议规范 数据名称 高度 水平速度 垂直速度 航向角 水平防护等级 垂直防护等级 航向角防护等级 接收机时钟偏差 接收机时钟漂移 DF DF75P DF76P DF77P DF78P - 位偏移 263 283 303 323 339 355 371 387 419 位宽 20 20 20 16 16 16 16 32 32 备注 0x80000 = 无效或不可用（2D 定位） 0x80000 = 无效 0x80000 = 无效 0x8000 = 无效 分辨率：0.01 米 0xFFFF = 无效 分辨率：0.01 米 0xFFFF = 无效 分辨率：0.01 度 0xFFFF = 无效 单位：毫米 0x80000000 = 无效 单位：厘米/秒 0x80000000 = 无效 备注 1. 如果 GPS 质量指示（定位状态）为 0，则以下字段无论报告任何值都无效： ⚫ 定位频段模式 ⚫ 定位完整性（RAIM） ⚫ 大地水准面间距，米 ⚫ 纬度 ⚫ 经度 ⚫ 高度 ⚫ 水平速度 ⚫ 垂直速度 ⚫ 航向角 2. 2D 定位模式，高度字段设置为无效（0x80000）。 3.4.6. RFS（子类型 ID = 24） 输出消息，仅用于移远通信内部调试。 上海移远通信技术股份有限公司 27 / 32 3.4.7. FWVER（子类型 ID = 25） 报告当前固件版本。 数据名称 消息号 子类型 ID 固件版本数据长度 固件版本数据字符串 DF 字段 DF002 DF02P - 位偏移 位宽 0 12 12 8 20 8 28 8*N 3.4.8. SIGQM2（子类型 ID = 26） 输出消息，仅用于移远通信内部调试。 LG69T(AB) GNSS 协议规范 备注 999（专有消息号）。 子类型 ID = 25 固件版本号（FWVER） N 表示字节数 固件版本数据字符串为 char8*N。N 取决于固件版本数据长度。 上海移远通信技术股份有限公司 28 / 32 LG69T(AB) GNSS 协议规范 4 附录 A 术语缩写 表 14：术语缩写 缩写 2D ASM AUTOSAR BDS CDB CLKESTM CIM CRC CWM DCM DOP E2E ECM ECRC EFM EPVT FWVER GGA GLONASS 英文全称 中文全称 2 Dimension 2维 Antenna Sensing Monitor 天线检测监控器 Automotive Open System Architecture 汽车开放系统架构 BeiDou Navigation Satellite System 北斗卫星导航系统 Configuration Data Block 配置数据块 Receive Clock Estimate Integrity 接收机时钟估计完整性 Central Intelligence Monitor 中央故障监控器 Cyclic Redundancy Check 循环冗余校验 Continuous Waves Monitor 连续波监控器 Data Corruption Monitor 数据损坏监控器 Dilution of Precision 精度因子 End-To-End 端到端 E2E counter mismatch E2E 计数器不匹配 E2E CRC failure E2E 校验失败 E2E Frame Error E2E 帧错误 Extended Position, Velocity and Time 扩展的位置、速度和时间 Firmware Version 固件版本 Global Positioning System Fix Data 全球定位系统定位数据 Global Navigation Satellite System 格洛纳斯导航卫星系统（俄罗斯） 上海移远通信技术股份有限公司 29 / 32 缩写 GNSS GPS GSV HDOP HWM IFB IFBM IFM I/NAV ITRF LLH MTM MTU NCO NMEA NVM NVMM PDOP PDU PLM POSQM PPS PPSM LG69T(AB) GNSS 协议规范 英文全称 (Russia) 中文全称 Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 GNSS Satellites in View 可视的 GNSS 卫星 Horizontal Dilution of Precision 水平精度因子 Hardware Failure Monitor 硬件故障监控器 Inter Frequency Biases 频间偏差 Inter-Frequency Bias Monitor 频间偏差监控器 Intermediate Frequency Monitor 中频监控器 Integrity Navigation 完整的导航 International Terrestrial Reference Frame 国际地球参考框架 Latitude, Longitude and Height 纬度，经度和高度 Message Timing Monitor 消息定时监控器 Multi Timer Unit 多定时器 Numerically Controlled Oscillator 数控振荡器 NMEA (National Marine Electronics NMEA （ 美 国 国 家 海 洋 电 子 协 会 ） Association) 0183 Interface Standard 0183 接口标准 Non-Volatile Memory 非易失性存储器 Non-Volatile Memory Monitor 非易失性存储器监控器 Position Dilution of Precision 位置精度因子 Protocol Data Unit 协议数据单元 Protection Level Monitor 防护等级监控器 Position Quality Metrics 位置质量指标 Pulse Per Second 秒脉冲 Timing and PPS integrity 时间和 PPS 完整性 上海移远通信技术股份有限公司 30 / 32 缩写 PPSOBSM PRN PVT QZSS RAIM RAM RCC RESP RF RFM RFS RFU RSS RTC RTCM SBAS SIGQM2 SIS SPFM SYSTM TOW UTC VDOP LG69T(AB) GNSS 协议规范 英文全称 中文全称 PPS vs. Observable Epoch PPS 可观测历元 Pseudo Random Noise 伪随机噪声 Position, Velocity and Time 位置、速度和时间 Quasi-Zenith Satellite System Receiver Autonomous Monitoring Random Access Memory 准天顶卫星系统（日本） Integrity 接收机自主完善性监测 随机存取存储器 Receiver Configuration and Control 接收机配置与控制 Response 响应 Radio Frequency 射频 RF Tuners Monitor 射频调谐器监控器 RF Status 射频状态 Reserved for Further Use 保留供进一步使用 Receiver Status and Safety 接收机状态和安全 Real-Time Clock 实时时钟 Radio Technical Commission for Maritime 海事无线电技术委员会 Services Satellite-Based Augmentation System 星基增强系统 Signal Quality Metrics 2 信号质量指标 2 Security, Integrity and Safety 保护措施，完整性和安全性 Spoofing Monitor 欺骗监控器 System Time Integrity 系统时间完整性 Time of Week 周内秒 Coordinated Universal Time 协调世界 Vertical Dilution of Precision 垂直精度因子 上海移远通信技术股份有限公司 31 / 32 5 附录 B 特殊字符 LG69T(AB) GNSS 协议规范 表 15：特殊字符 特殊字符 [...] {…} Underline 释义 参数名称。尖括号不会出现在消息中。 消息的可选字段。方括号不会出现在消息中。 消息的循环字段。大括号不会出现在消息中。 参数的默认设置。 上海移远通信技术股份有限公司 32 / 32

LG69T (AM,AP) GNSS 协议规范 GNSS 模块系列 版本：1.0 日期：2024-04-29 状态：受控文件 LG69T(AM,AP) GNSS 协议规范 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同 时，您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分 析、评估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同 意，尽管移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在 '可用'基础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文 档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 54 LG69T(AM,AP) GNSS 协议规范 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问 性、安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 54 LG69T(AM,AP) GNSS 协议规范 关于文档 文档信息 标题 副标题 文档类别 文档状态 LG69T (AM,AP) GNSS 协议规范 GNSS 模块系列 GNSS 协议规范 受控文件 修订记录 版本 1.0 日期 2023-06-25 2024-04-29 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 54 LG69T(AM,AP) GNSS 协议规范 目录 关于文档 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 NEMA 协议............................................................................................................................................ 8 2.1. NMEA 协议语句结构 .................................................................................................................. 8 2.2. 标准语句 ................................................................................................................................... 10 2.2.1. RMC .............................................................................................................................. 10 2.2.2. GGA............................................................................................................................... 12 2.2.3. GSV ............................................................................................................................... 14 2.2.4. GSA ............................................................................................................................... 16 2.2.5. VTG ............................................................................................................................... 17 2.2.6. GLL................................................................................................................................ 19 2.2.7. GST ............................................................................................................................... 20 2.3. PQTM 语句（专有语句） ......................................................................................................... 22 2.3.1. PQTMCOLD .................................................................................................................. 22 2.3.2. PQTMWARM................................................................................................................. 23 2.3.3. PQTMHOT .................................................................................................................... 23 2.3.4. PQTMSRR .................................................................................................................... 24 2.3.5. PQTMVERNO ............................................................................................................... 24 2.3.6. PQTMCFGCNST .......................................................................................................... 26 2.3.7. PQTMCFGFIXRATE ..................................................................................................... 27 2.3.8. PQTMCFGNMEADP..................................................................................................... 29 2.3.9. PQTMCFGMSGRATE................................................................................................... 30 2.3.10. PQTMCFGUART........................................................................................................... 35 2.3.11. PQTMSAVEPAR ........................................................................................................... 37 2.3.12. PQTMRESTOREPAR ................................................................................................... 38 2.3.13. PQTMDEBUGON.......................................................................................................... 38 2.3.14. PQTMDEBUGOFF ........................................................................................................ 39 2.3.15. PQTMCFGPPS ............................................................................................................. 40 2.3.16. 里程计功能相关语句...................................................................................................... 41 2.3.16.1. PQTMCFGODO ................................................................................................. 41 2.3.16.2. PQTMRESETODO............................................................................................. 42 2.3.16.3. PQTMODO......................................................................................................... 43 2.3.17. 地理围栏功能相关语句 .................................................................................................. 44 2.3.17.1. PQTMCFGGEOFENCE ..................................................................................... 44 2.3.17.2. PQTMGEOFENCESTATUS ............................................................................... 46 2.3.18. 天线检测功能相关语句 .................................................................................................. 47 2.3.18.1. PQTMCFGANTENNA ........................................................................................ 47 2.3.18.2. PQTMANTENNASTATUS .................................................................................. 48 上海移远通信技术股份有限公司 4 / 54 LG69T(AM,AP) GNSS 协议规范 2.3.19. PQTMGNSSTEMP........................................................................................................ 49 3 RTCM 协议.......................................................................................................................................... 50 4 附录 A 参考文档及术语缩写................................................................................................................ 51 5 附录 B GNSS 卫星（NMEA）标识符 ................................................................................................. 53 6 附录 C 特殊符号 .................................................................................................................................. 54 上海移远通信技术股份有限公司 5 / 54 LG69T(AM,AP) GNSS 协议规范 表格索引 表 1：支持的协议 ......................................................................................................................................... 7 表 2：NMEA 语句结构.................................................................................................................................. 8 表 3：发送设备标识符助记码（TalkerID） .................................................................................................. 9 表 4：错误码............................................................................................................................................... 22 表 5：支持的语句 ....................................................................................................................................... 31 表 6：支持的 RTCM3 语句 ......................................................................................................................... 50 表 7：参考文档 ........................................................................................................................................... 51 表 8：术语缩写 ........................................................................................................................................... 51 表 9：GNSS 卫星（NMEA）标识符 .......................................................................................................... 53 表 10：特殊符号 ......................................................................................................................................... 54 上海移远通信技术股份有限公司 6 / 54 LG69T(AM,AP) GNSS 协议规范 1 引言 移远通信 LG69T (AM,AP) GNSS 模块支持 GPS、Galileo、BDS 和 QZSS 定位。可以快速捕获跟踪 GPS L1 C/A, GPS L5, Galileo E1, Galileo E5a, BDS B1, BDS B2a, QZSS L1 和 QZSS L5 频段，使该模 块成为各种垂直行业实现精准定位和导航的理想解决方案。 本文档主要介绍用于控制和配置模块所需的软件命令；所述命令是由移远通信（Quectel）定义的 NMEA 专有语句（PQTM 命令）。模块还支持通过 NMEA 0183 标准协议和 RTCM 协议格式输出语句上报 GNSS 信息。 LG69T (AM,AP) GNSS 模块支持以下协议： 表 1：支持的协议 协议 NMEA 0183 V4.11 RTCM 10403.3 类型 输出、ASCII、标准 输入/输出、ASCII、专有 输入/输出、二进制、标准 备注 请使用本文档列出的命令控制或配置模块；对本文档未列出的其他命令情况，移远通信不承担任何责 任。 上海移远通信技术股份有限公司 7 / 54 LG69T(AM,AP) GNSS 协议规范 2 NEMA 协议 2.1. NMEA 协议语句结构 每一帧的起始字段，固定 均为 $ 地址字段，包含了Talker ID和语句的属性 以 * 开始，校验和为8位 异或的校验和转换成的十六 进制的数 数据字段，使用 , 隔开 结束字符，固定为 $ () [,] * 校验和的计算范围 图 1：NMEA 协议语句结构 表 2：NMEA 语句结构 字段 $ 描述 NMEA 语句的起始字段（Hex 0x24）。 NMEA 标准语句： 标准地址字段由 5 个字符（大写字母）组成。标准地址字段前两个字母是发送设备标识 符（TalkerID），见表 3：发送设备标识符助记码（TalkerID），用于定义所传输数据的定 位模式。标准地址字段的后三个字符为标准语句标识符（SentenceFormatter），用于定 义语句中其它数据的格式和类型。 NMEA 专有语句： 专有地址字段由专有字符'P'、制造商助记码（三个字符）、以及可选附加字符组成。 其中制造商助记码用来标识发出一个专有语句的发送设备。 数据字段，由数据字段分隔符','分隔。 可变长度（取决于 NMEA 语句类型）。 所有的语句中都应包含校验和字段。校验和字段是语句中的最后一个字段，在校验和定 上海移远通信技术股份有限公司 8 / 54 LG69T(AM,AP) GNSS 协议规范 字段 描述 界符'*'之后。 校验和是对语句中所有字符的 8 位（不包括起始和结束位）进行异或运算，所有字符是 指在定界符'$'与'*'之间，但不包括这些定界符的全部字符，包括','在内。 NMEA 语句的结束字符（Hex 0x0D 0x0A）。 表 3：发送设备标识符助记码（TalkerID） GNSS 星系配置 GPS Galileo BDS QZSS 组合星系 TalkerID (NMEA 0183 V4.11) GP GA GB GQ GN NMEA 校验和示例代码： // pData is the data array of which the checksum needs to be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL == pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^= *(pData + i); } return result; } 上海移远通信技术股份有限公司 9 / 54 LG69T(AM,AP) GNSS 协议规范 2.2. 标准语句 本章节介绍 LG69T (AM,AP)模块支持的 NMEA 0183 V4.11 标准语句。 2.2.1. RMC RMC 表示推荐的最少专有 GNSS 数据。本语句包含 GNSS 接收机提供的时间、日期、位置、航向和 速度数据。 类型： 输出 格式： $RMC,,,,,,,,,,,,,* 参数： 字段 $ RMC 格式 字符 字符串，2 位 字符串，3 位 hhmmss.sss 字符 ddmm.mmmmmm 单位 示例 描述 - $ 每条 NMEA 语句均以'$'开始。 - GN 发送设备 TalkerID（标识符助记码）。详 见表 3：发送设备标识符助记码 （TalkerID）。 - RMC 推荐的最少专有 GNSS 数据。 定位的 UTC 时间。 hh：时（00~23） - 094138.900 mm：分（00~59） ss：秒（(00~59） sss：秒的十进制小数 定位系统状态。 - A A = 数据有效 V = 导航接收机警告 纬度。 dd：度（00~90） - 3149.324578 mm：分（00~59） mmmmmm：分的十进制小数 数据无效时，此字段为空。 上海移远通信技术股份有限公司 10 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 字符 dddmm.mmmmmm 字符 十进制 十进制 ddmmyy - 单位 - - 节 度 - 示例 描述 N 11706.979371 E 0.00 131222 纬度方向。 N = 北 S = 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmmmm：分的十进制小数 数据无效时，此字段为空。 经度方向。 E = 东 W = 西 数据无效时，此字段为空。 对地速度。可变长度。 数据无效时，此字段为空。 对地真航向。可变长度，最大值： 359.99。 数据无效时，此字段为空。 日期。 dd：日 mm：月 yy：年 - 磁偏角，暂不支持。 字符 字符 十六进制 - - - R - V - *3B 磁偏角方向，暂不支持。 模式指示。 A = 自主式模式，卫星系统处于非差分 定位模式 D = 差分模式，卫星系统处于差分定位 模式；基于地面站或 SBAS 的修正 E = 估算（航位推算/先前位置）模式 F = RTK 浮点解模式 N = 无定位，卫星系统没有用于位置定 位，或定位无效 R = RTK 固定解模式 导航状态。暂不支持。 始终为'V'（导航状态无效，设备不能 提供导航状态指示）。 校验和。 字符 - - 回车换行。 上海移远通信技术股份有限公司 11 / 54 LG69T(AM,AP) GNSS 协议规范 示例： $GNRMC,094138.900,A,3149.324578,N,11706.979371,E,0.000,,131222,,,R,V*3B $GNRMC,000000.000,V,,,,,,,010170,,,N,V*2E 备注 字段中的 E 对于不同模块表示的含义有所差异： ⚫ LG69T (AM)：估算（先前位置）模式 ⚫ LG69T (AP)：估算（航位推算）模式 2.2.2. GGA GGA 提供全球定位系统定位数据。本语句包含 GNSS 接收机提供的时间、位置和定位相关数据。 类型： 输出 格式： $GGA,,,,,,,,,,M,,M,,* 参数： 字段 $ GGA 格式 字符 字符串，2 位 字符串，3 位 hhmmss.sss ddmm.mmmmmm 单位 - - 示例 描述 $ GN GGA 114555.400 3149.325753 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码 （TalkerID）。详见表 3：发送设备 标识符助记码（TalkerID）。 全球定位系统定位数据。 定位的 UTC 时间。 hh：时（00~23） mm：分（00~59） ss：秒（00~59） sss：秒的十进制小数 纬度。 dd：度（00~90） mm：分（00~59） mmmmmm：分的十进制小数 上海移远通信技术股份有限公司 12 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 单位 字符 - dddmm.mmmmmm - 字符 - 十进制，1 位 - 1) 十进制，2 位 - 十进制 - 十进制 米 M 字符 - 十进制 米 M 字符 - - - 示例 描述 数据无效时，此字段为空。 N 11706.979576 E 1 纬度方向。 N = 北 S = 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmmmm：分的十进制小数 数据无效时，此字段为空。 经度方向。 E = 东 W = 西 数据无效时，此字段为空。 GPS 定位模式/状态指示。 0 = 定位不可用或无效 1 = GPS SPS 模式，定位有效 2 = 差分 GPS，SPS 模式，或 SBAS，定位有效 3 = GPS PPS 模式，定位有效 4 = RTK 固定解模式 5 = RTK 浮点解模式 6 = 估算（航位推算/先前位置）模 式 37 使用的卫星数。 0.45 129.400 M 0.0 M - 水平精度因子。 数据无效时，此字段为 99.99。 平均海平面以上海拔（大地水准 面）。 数据无效时，此字段为空。 的单位。 'M' = 米。 大地水准面差距（WGS84 基准面 与平均海平面之间的差值）。 数据无效时，此字段为空。 的单位。 'M' = 米。 差分卫星导航系统数据龄期。 数据无效时，此字段为空。 上海移远通信技术股份有限公司 13 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 十六进制 字符 单位 示例 - - - *44 - - 描述 差分基准站标识号。 数据无效时，此字段为空。 校验和。 回车换行。 示例： $GNGGA,114555.400,3149.325753,N,11706.979576,E,1,37,0.45,129.400,M,0.0,M,,*44 $GNGGA,000000.000,,,,,0,00,99.99,,M,,M,,*48 备注 1 根据 NMEA 0183 协议，GGA 语句为 GPS 系统特有；当接收机配置为多星系时，GGA 语句的内容 将从多星系解决方案中生成。 2 1) NMEA 0183 协议定义的使用中卫星数量范围为 00~12，然而，在多星系解决方案中，使用的卫星 数量可能超过 12 颗。 3. 字段中的 6 对于不同模块表示的含义有所差异： ⚫ LG69T (AM)：估算（先前位置）模式 ⚫ LG69T (AP)：估算（航位推算）模式 2.2.3. GSV GSV 表示可视的 GNSS 卫星。本语句包含可视的卫星数、卫星标识号、仰角、方位角和信噪比。每 次传送，一个 GSV 语句只能包含最多 4 颗卫星的数据，因此可能需要多个语句才能获得完整的信息。数 据字段的前两个字段表示传输的语句总数和当前句数。 类型： 输出 格式： $GSV,,,{,,,,}, * 上海移远通信技术股份有限公司 14 / 54 参数： 字段 格式 单位 $ 字符 - GSV 字符串，2 位 - 字符串，3 位 - 十进制 - 十进制 - 十进制 - 参数循环开始。循环次数：0~4 次。 十进制 - 示例 $ GP GSV 2 1 06 01 十进制 度 43 十进制 度 166 十进制 参数循环结束。 dB-Hz 43 十进制 - 7 十六进制 - *79 字符 - - LG69T(AM,AP) GNSS 协议规范 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见表 3：发送设备标识符助记码（TalkerID）。 可视的GNSS卫星。 语句总数。范围：1~9。 语句号。范围：1~。 可视的卫星总数。 卫 星 标 识 号 。 详 见 表 9 ： GNSS 卫 星 （NMEA）标识符。 仰角。范围：00~90。 数据无效时，此字段为空。 真方位角。范围：000~359。 数据无效时，此字段为空。 载噪比（C/N0）。范围：00~99。 未跟踪时为空。 信 号 标 识 符 。 详 见 表 9 ： GNSS 卫 星 （NMEA）标识符。 校验和。 回车换行。 示例： $GAGSV,2,1,06,01,43,166,43,12,38,261,38,24,24,318,37,26,28,046,38,7*79 $GAGSV,2,2,06,31,67,279,45,33,66,351,46,7*7E $GAGSV,1,1,00,1*75 备注 'GN'标识符不可用于该语句。如果有多个卫星系统可视，则设备输出多条 GSV 语句。 上海移远通信技术股份有限公司 15 / 54 LG69T(AM,AP) GNSS 协议规范 2.2.4. GSA GSA 表示 GNSS 精度因子（DOP）与有效卫星。本语句包含 GNSS 接收机工作模式，GGA 语句报 告的导航解算中用到的卫星以及精度因子的值。 类型： 输出 格式： $GSA,,{,},,,* 参数： 字段 $ GSA 格式 单位 字符 - 字符串，2 位 - 字符串，3 位 - 字符 - 十进制 - 参数循环开始。循环次数：12 次 十进制 - 参数循环结束。 十进制 - 十进制 - 十进制 - 十进制 - 示例 $ GN GSA A 3 01 0.82 0.45 0.68 1 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见表3：发 送设备标识符助记码（TalkerID）。 GNSS精度因子（DOP）与有效卫星。 A = 自动，允许 2D/3D 定位模式自动变换。 定位模式。 1 = 定位不可用 2 = 2D 定位模式 3 = 3D 定位模式 解算中用到的卫星标识号。详见表 9：GNSS 卫星 （NMEA）标识符。 数据无效时，此字段为空。 位置精度因子。最大值为 99.99。 数据无效时，此字段为 99.99。 水平精度因子。最大值为 99.99。 数据无效时，此字段为 99.99。 垂直精度因子。最大值为 99.99。 数据无效时，此字段为 99.99。 GNSS 系 统 标 识 符 。 详 见 表 9 ： GNSS 卫 星 （NMEA）标识符。 上海移远通信技术股份有限公司 16 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 十六进制 字符 单位 - 示例 *01 - 描述 校验和。 回车换行。 示例： $GNGSA,A,3,01,04,07,08,09,16,21,26,27,30,,,0.82,0.45,0.68,1*01 $GNGSA,A,3,02,07,13,15,19,21,27,30,34,,,,0.82,0.45,0.68,3*0F $GNGSA,A,1,,,,,,,,,,,,,99.99,99.99,99.99,1*33 备注 如果用于定位导航的卫星少于 12 颗，则剩余的字段将为空。如果超过 12 颗卫星用于定位导 航，则仅输出前 12 颗卫星的卫星标识号。 2.2.5. VTG VTG 语句包含相对于地面的实际航向和速度。 类型： 输出 格式： $VTG,,T,,M,,N,,K,* 参数： 字段 $ VTG 格式 单位 字符 - 字符串，2 位 - 字符串，3 位 - 十进制 度 示例 $ GN VTG - 描述 每条 NMEA 语句均以'$'开始。 发 送 设 备 标 识 符 助 记 码 （ TalkerID ）。 详 见 表 3：发送设备标识符助记码（TalkerID）。 相对于地面的实际航向和速度。 对地航向（真北）。 最大值：359.99. 数据无效时，此字段为空。 上海移远通信技术股份有限公司 17 / 54 LG69T(AM,AP) GNSS 协议规范 字段 T M N K 格式 字符 十进制 字符 十进制 字符 十进制 字符 单位 示例 - T 度 - - M 节 0.000 - N 千米/时 0.000 - K 字符 - R 十六进制 - *2E 字符 - - 描述 固定为'T'，表示参考真北方向。 对地航向（磁北）。 暂不支持。 固定为'M'，表示参考磁北方向。 对地速度，以节为单位。 数据无效时，此字段为空。 固定为'N'，表示单位为节。 对地速度，以千米每时为单位。 数据无效时，此字段为空。 固 定为 'K '， 表示 单位 为千 米每 小 时。 模式指示。 A = 自主式模式，卫星系统处于非差分定位模式 D =差分模式，卫星系统处于差分定位模式；基 于地面站或 SBAS 的修正 E = 估算（航位推算/先前位置）模式 F = RTK 浮点解模式 N = 无定位，卫星系统没有用于位置定位，或定 位无效 R = RTK 固定解模式 校验和。 回车换行。 示例： $GNVTG,,T,,M,0.000,N,0.000,K,R*2E $GNVTG,,T,,M,,N,,K,N*32 备注 字段中的 E 对于不同模块表示的含义有所差异： ⚫ LG69T (AM)：估算（先前位置）模式。 ⚫ LG69T (AP)：估算（航位推算）模式。 上海移远通信技术股份有限公司 18 / 54 LG69T(AM,AP) GNSS 协议规范 2.2.6. GLL GLL 表示地理位置—纬度和经度。本语句包含接收机的纬度与经度、定位时间和状态。 类型： 输出 格式： $GLL,,,,,,,* 参数： 字段 $ GLL 格式 字符 字符串，2 位 字符串，3 位 单位 - ddmm.mmmmmm - 字符 - dddmm.mmmmmm - 字符 - hhmmss.sss - 示例 描述 $ 每条 NMEA 语句均以'$'开始。 发 送 设 备 标 识 符 助 记 码 （ TalkerID ）。 GN 详见表 3：发送设备标识符助记码 （TalkerID）。 GLL 地理位置—纬度和经度。 3149.324576 N 11706.979370 E 110827.800 纬度。 dd：度（00~90） mm：分（00~59） mmmmmm：分的十进制小数 数据无效时，此字段为空。 纬度方向。 N = 北 S = 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmmmm：分的十进制小数 数据无效时，此字段为空。 经度方向。 E = 东 W = 西 数据无效时，此字段为空。 定位的 UTC 时间。 hh：时（00~23） mm：分（00~59） 上海移远通信技术股份有限公司 19 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 字符 字符 十六进制 字符 单位 示例 - A - R - *5D - - 描述 ss：秒（00~59） sss：秒的十进制小数 定位系统状态。 A = 数据有效 V = 数据无效 模式指示。 A = 自主式模式，卫星系统处于非差分 定位模式 D =差分模式，卫星系统处于差分定位 模式；基于地面站或 SBAS 的修正 E = 估算（航位推算/先前位置）模式 F = RTK 浮点解模式 N = 无定位，卫星系统没有用于位置定 位，或定位无效 R = RTK 固定解模式 校验和。 回车换行。 示例： $GNGLL,3149.324576,N,11706.979370,E,110827.800,A,R*5D $GNGLL,,,,,000000.000,V,N*64 备注 字段中的 E 对于不同模块表示的含义有所差异： ⚫ LG69T (AM)：估算（先前位置）模式 ⚫ LG69T (AP)：估算（航位推算）模式 2.2.7. GST GNSS 伪距误差统计。此语句支持接收机自主完整性监测（RAIM）。伪距测量误差统计可以在位置 域中转换，以便给出位置解质量的统计测量。 类型： 输出 上海移远通信技术股份有限公司 20 / 54 LG69T(AM,AP) GNSS 协议规范 格式： $GST,,,,,,,,* 参数： 字段 $ GST 格式 单位 示例 字符 - 字符串，2 位 - 字符串，3 位 - $ GN GST hhmmss.sss - 110404.000 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十六进制 字符 米 0.73 米 0.34 米 0.34 度 106.53 米 0.11 米 0.11 米 0.112 - *4F - - 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。 详见表 3：发送设备标识符助记码（TalkerID）。 GNSS 伪距误差统计。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 导航过程中输入的标准偏差范围的 RMS 值。 数据无效时，此字段为空。 误差椭圆半长轴的标准偏差。 数据无效时，此字段为空。 误差椭圆半短轴的标准偏差。 数据无效时，此字段为空。 误差椭圆半长轴方向。 数据无效时，此字段为空。 纬度误差的标准偏差。 数据无效时，此字段为空。 经度误差的标准偏差。 数据无效时，此字段为空。 高度误差的标准偏差。 数据无效时，此字段为空。 校验和。 回车换行。 示例： $GNGST,110404.000,0.73,0.34,0.34,106.53,0.11,0.11,0.12*4F $GNGST,000000.000,,,,,,,*57 上海移远通信技术股份有限公司 21 / 54 LG69T(AM,AP) GNSS 协议规范 2.3. PQTM 语句（专有语句） 本章节介绍 LG69T (AM,AP)模块支持的 PQTM 语句（移远通信定义的专有 NMEA 语句）。 表 4：错误码 字段 格式 十进制 单位 - 描述 错误码。 1 = 无效参数 2 = 执行失败 备注 除非另行说明，否则本文档中提到的多数 PQTM 语句将立即生效，不会自动保存配置。 2.3.1. PQTMCOLD 执行冷启动。冷启动将重新启动 GNSS 引擎，模块中不会存储任何位置信息，包括时间、位置、历书 和星历数据。 类型： 命令 格式： $PQTMCOLD* 参数： 无 结果： 接收机将重启且命令执行后不会返回响应语句。 上海移远通信技术股份有限公司 22 / 54 示例： $PQTMCOLD*1C LG69T(AM,AP) GNSS 协议规范 2.3.2. PQTMWARM 执行温启动。温启动将重新启动 GNSS 引擎，模块中已存储有效的位置、时间和历书数据，但星历数 据无效；因此，模块需要在定位之前下载星历数据。 类型： 命令 格式： $PQTMWARM* 参数： 无 结果： 接收机将重启且命令执行后不会返回响应语句。 示例： $PQTMWARM*11 2.3.3. PQTMHOT 执行热启动。热启动将重新启动 GNSS 引擎，模块中已存储有效的位置、时间、星历和历书数据；因 此，模块可以在更短的时间内获取定位。 类型： 命令 格式： $PQTMHOT* 上海移远通信技术股份有限公司 23 / 54 参数： 无 结果： 接收机将重启且命令执行后不会返回响应语句。 示例： $PQTMHOT*4B 2.3.4. PQTMSRR 执行系统复位。接收机将重新启动。 类型： 命令 格式： $PQTMSRR* 参数： 无 结果： 接收机将重启且命令执行后不会返回响应语句。 示例： $PQTMSRR*4B 2.3.5. PQTMVERNO 查询固件版本信息。 类型： 命令 上海移远通信技术股份有限公司 LG69T(AM,AP) GNSS 协议规范 24 / 54 LG69T(AM,AP) GNSS 协议规范 格式： $PQTMVERNO* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMVERNO,,,* 结果中包含的参数： 字段 格式 单位 描述 字符串 - yyyy/mm/dd - hh:mm:ss - ⚫ 如果失败，模块返回： 固件版本。 固件构建日期。 yyyy：年 mm：月 dd：日 固件构建时间。 hh：时（00~23） mm：分（00~59） ss：秒（00~59） $PQTMVERNO,ERROR,* 字段信息，详见表 4：错误码。 示例： $PQTMVERNO*58 $PQTMVERNO,LG69TAMNR01A01S_RQN,2022/12/14,20:09:50*3E 上海移远通信技术股份有限公司 25 / 54 LG69T(AM,AP) GNSS 协议规范 2.3.6. PQTMCFGCNST 设置/查询 GNSS 星系配置。 类型： 设置/查询 格式： //设置： $PQTMCFGCNST,W,,,,,,*< LF> //查询： $PQTMCFGCNST,R* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 单位 - 描述 启用/禁用 GPS。 0 = 禁用 1 = 启用 固定为 0。 启用/禁用 Galileo。 0 = 禁用 1 = 启用 启用/禁用 BDS。 0 = 禁用 1 = 启用 启用/禁用 QZSS。 0 = 禁用 1 = 启用 固定为 0。 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGCNST,OK*78 //查询： $PQTMCFGCNST,OK,,,,,,* 上海移远通信技术股份有限公司 26 / 54 ⚫ 如果失败，模块返回： $PQTMCFGCNST,ERROR,* 字段信息，详见表 4：错误码。 示例： //设置 GNSS 星系为 GPS + Galileo + BDS + QZSS： $PQTMCFGCNST,W,1,0,1,1,1,0*2B $PQTMCFGCNST,OK*78 //保存配置： $PQTMSAVEPAR*5A //查询 GNSS 星系配置： $PQTMCFGCNST,R*2E $PQTMCFGCNST,OK,1,0,1,1,1,0*78 备注 该设置命令下发后，需要先保存配置并重启模块后才能生效。 LG69T(AM,AP) GNSS 协议规范 2.3.7. PQTMCFGFIXRATE 设置/查询定位间隔。 类型： 设置/查询 格式： //设置 $PQTMCFGFIXRATE,W,* //查询 $PQTMCFGFIXRATE,R* 上海移远通信技术股份有限公司 27 / 54 参数： 字段 格式 十进制 LG69T(AM,AP) GNSS 协议规范 单位 毫秒 描述 定位间隔。 100 200 500 1000 备注 1. 该设置命令下发后，需要先保存配置并重启模块后才能生效。 2. 该命令仅适用于 LG69T (AM)模块。 3. 当使用$PQTMCFGFIXRATE配置，$PQTMCFGMSGRATE中所有的值将恢复为 默认值。 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGFIXRATE,OK*27 //查询： $PQTMCFGFIXRATE,OK,* ⚫ 如果失败，模块返回： $PQTMCFGFIXRATE,ERROR,* 字段信息，详见表 4：错误码。 示例： //将定位间隔设置为 1000 毫秒： $PQTMCFGFIXRATE,W,1000*59 $PQTMCFGFIXRATE,OK*27 //保存配置： $PQTMSAVEPAR*5A //获取定位间隔： $PQTMCFGFIXRATE,R*71 $PQTMCFGFIXRATE,OK,1000*0A 上海移远通信技术股份有限公司 28 / 54 LG69T(AM,AP) GNSS 协议规范 2.3.8. PQTMCFGNMEADP 设置/查询 NMEA 标准语句中、、、、、、、 、、、字段的小数位数。 类型： 设置/查询 格式： //设置： $PQTMCFGNMEADP,W,,,,,,* //查询： $PQTMCFGNMEADP,R* 参数： 字段 格式 单位 十进制 - 十进制 - 十进制 - 十进制 - 十进制 - 十进制 - 上海移远通信技术股份有限公司 描述 配置 NMEA 标准语句中 UTC 时间所含秒数的小数 位数。范围：0~3。默认值：3。 0 = 没有小数部分。 其他值：实际小数位，例如，1 表示十分位。 配置 NMEA 标准语句中纬度和经度的小数位数。范 围：0~8。默认值：6。 0 = 没有小数部分。 其他值：实际小数位，例如，1 表示十分位。 配置 NMEA 标准语句中高度和大地水准面间隔的小 数位数。范围：0~3。默认值：3。 0 = 没有小数部分。 其他值：实际小数位，例如，1 表示十分位。 配置 NMEA 标准语句中 DOP 的小数位数。范围： 0~3。默认值：2。 0 = 没有小数部分。 其他值：实际小数位，例如，1 表示十分位。 配置 NMEA 标准语句中速度的小数位数。范围： 0~3。默认值：3。 0 = 没有小数部分。 其他值：实际小数位，例如，1 表示十分位。 配置 NMEA 标准语句中 COG 的小数位数。范围： 0~3。默认值：2。 0 = 没有小数部分。 29 / 54 字段 格式 单位 LG69T(AM,AP) GNSS 协议规范 描述 其他值：实际小数位，例如，1 表示十分位。 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGNMEADP,OK*61 //查询： $PQTMCFGNMEADP,OK,,,,,,* ⚫ 如果失败，模块返回： $PQTMCFGNMEADP,ERROR,* 字段信息，详见表 4：错误码。 示例： //设置 NMEA 标准语句中各参数的小数位数为其默认值： $PQTMCFGNMEADP,W,3,6,3,2,3,2*37 $PQTMCFGNMEADP,OK*61 //查询 NMEA 标准语句各参数的小数位数： $PQTMCFGNMEADP,R*37 $PQTMCFGNMEADP,OK,3,6,3,2,3,2*64 2.3.9. PQTMCFGMSGRATE 设置/查询当前或指定接口的语句输出速率。 类型： 设置/查询 格式： //设置当前接口的语句输出速率： $PQTMCFGMSGRATE,W,,[,]* //查询当前接口的语句输出速率： $PQTMCFGMSGRATE,R,[,]* 上海移远通信技术股份有限公司 30 / 54 LG69T(AM,AP) GNSS 协议规范 //设置指定接口的语句输出速率： $PQTMCFGMSGRATE,W,,,,[,]* //查询指定接口的语句输出速率： $PQTMCFGMSGRATE,R,,,[,]* 参数： 字段 格式 十进制 十进制 字符串 十进制 十进制 单位 - - - 描述 接口类型： 1 = UART 接口 ID： 1 = UART1 2 = UART2 设置/查询的语句名称，详情见表 5：支持的语句。 语句的输出速率。 当 为 NMEA 标 准 语 句 、 PQTMODO 、 PQTMGEOFENCESTATUS 、 PQTMANTENNASTATUS 和 PQTMGNSSTEMP语句时，取值范围：0~20 0 = 不输出 N = 每N次定位输出一次 当为其他语句时取值对应的含义会有所不 同 ， 且 部 分 语 句 的 值 受 PQTMCFGFIXRATE 中 的 值影响，详情见表5：支持的语句。 语句版本。详细信息请参考备注1。 表 5：支持的语句 语句名称 RMC GGA GSV 语句输出速率（） LG69T (AM) LG69T (AP) 0~20（默认值：1） 0~20（默认值：1） 0~20（默认值：1） 0~20（默认值：1） （无论取值如何，默认值均为 10。） 若设置为 100，可设置为 0、10、 20 若设置为 200，可设置为 0、5、 10、15、20 0、10、20（默认值：10） 上海移远通信技术股份有限公司 31 / 54 LG69T(AM,AP) GNSS 协议规范 语句名称 GSA VTG 语句输出速率（） LG69T (AM) LG69T (AP) 若设置为 500，可设置为 0、2、4、 6、8、10、12、14、16、18、20 若设置为 1000，范围：0~20 （无论取值如何，默认值均为 10。） 若设置为 100，可设置为 0、10、 20 若设置为 200，可设置为 0、5、 10、15、20 若设置为 500，可设置为 0、2、4、 6、8、10、12、14、16、18、20 若设置为 1000，范围：0~20 0、10、20（默认值：10） 0~20（默认值：1） 0~20（默认值：1） GLL 0~20（默认值：10） 0~20（默认值：10） GST PQTMODO PQTMGEOFEN CESTATUS PQTMANTENN ASTATUS 0~20（默认值：1） 0~20（默认值：1） （无论取值如何，默认值均为 10。） 若设置为 100，可设置为 0、10、 20 若设置为 200，可设置为 0、5、 10、15、20 若设置为 500，可设置为 0、2、4、 6、8、10、12、14、16、18、20 若设置为 1000，范围：0~20 （无论取值如何，默认值均为 10。） 若设置为 100，可设置为 0、10、 20 若设置为 200，可设置为 0、5、 10、15、20 若设置为 500，可设置为 0、2、4、 6、8、10、12、14、16、18、20 若设置为 1000，范围：0~20 （无论取值如何，默认值均为 10。） 若设置为 100，可设置为 0、10、 20 若 设置为 20，可设置为 0、5、 10、15、20 若设置为 500，可设置为 0、2、4、 6、8、10、12、14、16、18、20 若设置为 1000，范围：0~20 0、1、2、5、10 （默认值：0） 0、10、20（默认值：0） 0、10、20（默认值：0） 上海移远通信技术股份有限公司 32 / 54 LG69T(AM,AP) GNSS 协议规范 语句名称 PQTMGNSSTE MP PQTMPVT PQTMDRPVA PQTMSENMSG PQTMVEHMSG PQTMTAR RTCM3-MSM7 RTCM3-EPH RTCM3-1006 语句输出速率（） LG69T (AM) LG69T (AP) （无论取值如何，默认值均为 10。） 若设置为 100，可设置为 0、10、 20 若设置为 200，可设置为 0、5、 10、15、20 若设置为 500，可设置为 0、2、4、 6、8、10、12、14、16、18、20 若设置为 1000，范围：0~20 （无论取值如何，默认值均为 10。） 若设置为 100，可设置为 0、10、 20 若设置为 200，可设置为 0、5、 10、15、20 若设置为 500，可设置为 0、2、4、 6、8、10、12、14、16、18、20 若设置为 1000，范围：0~20 - - - - （无论取值如何，默认值均为 10。） 若设置为 100，可设置为 0、1、2、 5、10 若设置为 200，可设置为 0、1、2、 5 若设置为 500，可设置为 0、1、2 若设置为 1000，可设置为 0 或 1 0 =不输出 1 =可用时输出 0 =不输出 1 =可用时输出 0、10、20（默认值：0） 0 = 不输出 1 = 可用时输出 0 = 不输出 1 = 可用时输出 0 = 不输出 10 = 每秒输出 10 条语句 20 = 每秒输出 20 条语句 50 = 每秒输出 50 条语句 100 = 每秒输出 100 条语句 0 = 不输出 1 = 可用时输出 0 = 不输出 1 = 可用时输出 0、1、2、5、10 （默认值：0） 0 = 不输出 1 = 可用时输出 0 = 不输出 1 = 可用时输出 上海移远通信技术股份有限公司 33 / 54 LG69T(AM,AP) GNSS 协议规范 备注 1. 当设置/查询 NMEA 标准语句或 RTCM3 标准语句的输出速率时，可以省略；当设置/查 询 NMEA 专有语句的输出速率时，需配置来指定语句版本，否则将报错。 2. 有 关 PQTMPVT 、 PQTMDRPVA 、 PQTMSENMSG 和 PQTMVEHMSG 语 句 ， 详 见 文 档 [1] application note；有关 PQTMTAR 语句，详见文档 [2] application note。 3. 有关 RTCM3-MSM7, RTCM3-EPH and RTCM3-1006 语句，详见表 6：支持的 RTCM3 语句。 结果： ⚫ 如果成功，模块返回： //设置当前/指定接口语句输出速率命令的响应： $PQTMCFGMSGRATE,OK* //查询当前接口语句输出速率命令的响应： $PQTMCFGMSGRATE,OK,,[,]* //查询指定接口语句输出速率命令的响应： $PQTMCFGMSGRATE,OK,,,,[,]* ⚫ 如果失败，模块返回： $PQTMCFGMSGRATE,ERROR,* 字段信息，详见表 4：错误码。 示例： //设置当前接口上 GGA 语句的输出速率为每次定位输出一次： $PQTMCFGMSGRATE,W,GGA,1*0A $PQTMCFGMSGRATE,OK*29 //查询当前接口上 GGA 语句的输出速率： $PQTMCFGMSGRATE,R,GGA*12 $PQTMCFGMSGRATE,OK,GGA,1*59 //设置当前接口上$PQTMSENMSG 语句的输出速率： $PQTMCFGMSGRATE,W,PQTMSENMSG,100,2*4C $PQTMCFGMSGRATE,OK*29 //查询当前接口上$PQTMSENMSG 语句的输出速率： $PQTMCFGMSGRATE,R,PQTMSENMSG,2*54C PQTMCFGMSGRATE,OK,PQTMSENMSG,100,2*1F 上海移远通信技术股份有限公司 34 / 54 LG69T(AM,AP) GNSS 协议规范 //设置 UART1 上 GGA 语句的输出速率为每次定位输出一次： $PQTMCFGMSGRATE,W,1,1,GGA,1*0A $PQTMCFGMSGRATE,OK*29 //查询 UART1 上 GGA 语句的输出速率： $PQTMCFGMSGRATE,R,1,1,GGA*12 $PQTMCFGMSGRATE,OK,1,1,GGA,1*59 //设置 UART1 上$PQTMSENMSG 语句的输出速率： $PQTMCFGMSGRATE,W,1,1,PQTMSENMSG,100,2*4C $PQTMCFGMSGRATE,OK*29 //查询 UART1 上$PQTMSENMSG 语句的输出速率： $PQTMCFGMSGRATE,R,1,1,PQTMSENMSG,2*54 PQTMCFGMSGRATE,OK,1,1,PQTMSENMSG,100,2*1F 2.3.10. PQTMCFGUART 设置/查询 UART 接口的波特率和相关配置。 类型： 设置/查询 格式： //设置当前/指定 UART 接口： $PQTMCFGUART,W[,],[,,,,]* //查询： $PQTMCFGUART,R[,]* 参数： 字段 格式 十进制 单位 - 描述 UART 标识。 1 = UART1 2 = UART2 如果设置该参数，则设置/查询指定 UART 的配置。 如果未设置该参数，则设置/查询当前 UART 的配置。 上海移远通信技术股份有限公司 35 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 十进制 十进制 十进制 十进制 十进制 单位 bps bit - 描述 UART 波特率： 115200 230400 460800 921600 UART 数据位： 8 = 8 bits 奇偶校验： 0 = 无奇偶校验 停止位： 1 = 1 个停止位 流量控制： 0 = 无 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGUART,OK*60 //查询： $PQTMCFGUART,OK,,,,,,* ⚫ 如果失败，模块返回： $PQTMCFGUART,ERROR,* 字段信息，详见表 4：错误码。 示例： //设置当前 UART 接口波特率： $PQTMCFGUART,W,460800*15 $PQTMCFGUART,OK*60 //设置 UART1 接口的波特率： $PQTMCFGUART,W,1,460800*08 $PQTMCFGUART,OK*60 //设置当前 UART 接口的所有参数： $PQTMCFGUART,W,460800,8,0,1,0*1C $PQTMCFGUART,OK*60 上海移远通信技术股份有限公司 36 / 54 LG69T(AM,AP) GNSS 协议规范 //设置 UART1 接口的所有参数： $PQTMCFGUART,W,1,460800,8,0,1,0*01 $PQTMCFGUART,OK*60 //查询当前 UART 接口的配置： $PQTMCFGUART,R*36 $PQTMCFGUART,OK,1,460800,8,0,1,0*52 //查询 UART1 接口的配置： $PQTMCFGUART,R,1*2B $PQTMCFGUART,OK,1,460800,8,0,1,0*52 2.3.11. PQTMSAVEPAR 将 PQTM 命令配置保存至 NVM。 类型： 命令 格式： $PQTMSAVEPAR* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMSAVEPAR,OK*5A ⚫ 如果失败，模块返回： $PQTMSAVEPAR,ERROR,* 字段信息，详见表 4：错误码。 示例： $PQTMSAVEPAR*5A $PQTMSAVEPAR,OK*72 上海移远通信技术股份有限公司 37 / 54 LG69T(AM,AP) GNSS 协议规范 2.3.12. PQTMRESTOREPAR 将所有配置还原成默认值。 类型： 命令 格式： $PQTMRESTOREPAR* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMRESTOREPAR,OK*3B ⚫ 如果失败，模块返回： $PQTMRESTOREPAR,ERROR,* 字段信息，详见表 4：错误码。 示例： $PQTMRESTOREPAR*13 $PQTMRESTOREPAR,OK*3B 2.3.13. PQTMDEBUGON 使能调试日志输出。 类型： 命令 格式： $PQTMDEBUGON* 上海移远通信技术股份有限公司 38 / 54 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMDEBUGON,OK*60 ⚫ 如果失败，模块返回： $PQTMDEBUGON,ERROR,* 字段信息，详见表 4：错误码。 示例： $PQTMDEBUGON*48 $PQTMDEBUGON,OK*60 LG69T(AM,AP) GNSS 协议规范 2.3.14. PQTMDEBUGOFF 禁用调试日志输出。 类型： 命令 格式： $PQTMDEBUGOFF* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMDEBUGOFF,OK*2E ⚫ 如果失败，模块返回： $PQTMDEBUGOFF,ERROR,* 上海移远通信技术股份有限公司 39 / 54 字段信息，详见表 4：错误码。 示例： $PQTMDEBUGOFF*06 $PQTMDEBUGOFF,OK*2E LG69T(AM,AP) GNSS 协议规范 2.3.15. PQTMCFGPPS 配置 1PPS 功能。 类型： 设置/查询 格式： //设置： $PQTMCFGPPS,W,,,,,,* //查询： $PQTMCFGPPS,R,* 参数： 字段 格式 十进制 单位 - 十进制 - 十进制 毫秒 十进制 - 十进制 - 十进制 - 描述 PPS 标识。 1 = PPS1 开启/关闭 PPS 输出。 0 = 禁用 1 = 启用 脉冲持续时间。(默认：100) 范围：0~900 配置何时输出 PPS。 1 = 一直输出 2 = 2D 定位时输出 3 = 3D 定位时输出 脉冲极性。 0 = 低 1 = 高 PPS 生成时间间隔。 0 = 每秒 1 = 奇数秒 上海移远通信技术股份有限公司 40 / 54 字段 格式 单位 描述 2 = 偶数秒 LG69T(AM,AP) GNSS 协议规范 备注 1. 当配置脉冲极性为低（ = 0）时，PPS 的生成时间间隔只能为每秒（ = 0）。 2. 该命令仅适用于 LG69T (AM)模块。 3. 该设置命令下发后，需要先保存配置并重启模块后才能生效。 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGPPS,OK* //查询： $PQTMCFGPPS,OK,,,,,,* ⚫ 如果失败，模块返回： $PQTMCFGPPS,ERROR,* 字段信息，详见表 4：错误码。 示例： //设置 PPS 特性： $PQTMCFGPPS,W,1,1,100,1,1,0*73 $PQTMCFGPPS,OK*21 //保存配置 $PQTMSAVEPAR*5A 2.3.16. 里程计功能相关语句 2.3.16.1. PQTMCFGODO 设置/查询里程计功能。 类型： 设置/查询 上海移远通信技术股份有限公司 41 / 54 LG69T(AM,AP) GNSS 协议规范 格式： //设置： $PQTMCFGODO,W,,*<LF //查询： $PQTMCFGODO,R* 参数： 字段 格式 单位 十进制 - 十进制 米 描述 里程计状态。 0 = 禁用 1 = 启用 初始里程。默认值：0。 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGODO,OK* //查询： $PQTMCFGODO,OK,,* ⚫ 如果失败，模块返回： $PQTMCFGODO,ERROR,* 字段信息，详见表 4：错误码。 示例： $PQTMCFGODO,W,1,10.5*4E $PQTMCFGODO,OK*36 2.3.16.2. PQTMRESETODO 重置里程计的累计里程。 类型： 命令 上海移远通信技术股份有限公司 42 / 54 LG69T(AM,AP) GNSS 协议规范 格式： $PQTMRESETODO* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMRESETODO,OK* ⚫ 如果失败，模块返回： $PQTMRESETODO,ERROR,* 字段信息，详见表 4：错误码。 示例： $PQTMRESETODO*09 $PQTMRESETODO,OK*21 2.3.16.3. PQTMODO 输出里程计信息。 类型： 输出 格式： $PQTMODO,,,,* 参数： 字段 格式 字符 hhmmss,sss 单位 - 描述 语句的版本。 1 = 版本 1（此版本始终为 1） UTC 时间。 hh：小时（00~23） 上海移远通信技术股份有限公司 43 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 十进制 十进制 单位 米 描述 mm：分钟（00~59） ss：秒（(00~59） sss：秒的十进制小数 里程计状态。 0 = 禁用 1 = 启用 上次重置后的里程，该字段等于累计里程加上 $PQTMCFGODO 命令中字段配置的初始里程。 示例： $PQTMODO,1,120635.000,1,112.3*6E 备注 $PQTMODO 中的字段值等于里程计的累计里程加上$PQTMCFGODO 中的字段值。累 计里程从 0 开始累计，可通过$PQTMRESETODO 命令或模块断电将累计里程重置为 0。若重新设置 $PQTMCFGODO 中的值，$PQTMODO 中的字段值等于新设置的值加上累 计里程，即： = 累计里程 + 。 2.3.17. 地理围栏功能相关语句 2.3.17.1. PQTMCFGGEOFENCE 设置/查询地理围栏配置。 类型： 设置/查询 格式： //设置： $PQTMCFGGEOFENCE,W,,[,,,,,[,,,,,]]* //查询： $PQTMCFGGEOFENCE,R,* 上海移远通信技术股份有限公司 44 / 54 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 LG69T(AM,AP) GNSS 协议规范 单位 - - - 度 度 米/度 度 度 度 度 度 描述 地理围栏标识。范围：0~3。 地理围栏功能状态。 0 = 禁用 1 = 启用 总是为 0。 地理围栏的形状。 0 = 由圆心和半径确定的圆 1 = 由圆心和圆上一点确定的圆 2 = 三角形 3 = 四边形（如正方形、长方形、梯形等） 第一个点的纬度。 第一个点的经度。 如果地理围栏形状是由圆心和半径确定的圆（即 = 0），则此值将为圆的半径；否则，此值将 为第二个点的纬度。 第二个点的经度。 第三个点的纬度。 第三个点的经度。 第四个点的纬度。 第四个点的经度。 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGGEOFENCE,OK* //查询： $PQTMCFGGEOFENCE,OK,,,,,,,[,< Lon1>,,,,]* ⚫ 如果失败，模块返回： $PQTMCFGGEOFENCE,ERROR,* 字段信息，详见表 4：错误码。 上海移远通信技术股份有限公司 45 / 54 LG69T(AM,AP) GNSS 协议规范 示例： //根据圆心和半径来设置地理围栏形状： $PQTMCFGGEOFENCE,W,0,1,0,0,31.451248,117.451245,100.5*18 $PQTMCFGGEOFENCE,OK*74 //查询地理围栏功能： $PQTMCFGGEOFENCE,R,0*3E $PQTMCFGGEOFENCE,OK,0,1,0,0,31.451248,117.451245,100.5*4B //关闭地理围栏功能： $PQTMCFGGEOFENCE,W,0,0*27 $PQTMCFGGEOFENCE,OK*74 备注 1. 如果已设置地理围栏形状和参数，然后需要禁用地理围栏功能，可以省略后面的字段。 2. 地理围栏形状上的点应按顺时针或逆时针顺序设置。 3. 当字段设置为 1 时，第一个点是圆心。 2.3.17.2. PQTMGEOFENCESTATUS 输出地理围栏状态。 类型： 输出 格式： $PQTMGEOFENCESTATUS,,{,}* 参数： 字段 格式 字符 hhmmss.sss 单位 - - 描述 语句版本。 1 = 版本 1（此版本始终为 1） UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（(00~59） 上海移远通信技术股份有限公司 46 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 参数循环开始。（循环 4 次） 十进制 参数循环结束。 单位 描述 sss：秒的十进制小数 地理围栏状态。（N 的范围：0~3） 0 = 未知 - 1 = 在地理围栏里面 2 = 在地理围栏外面 示例： $PQTMGEOFENCESTATUS,1,124521.000,1,2,2,2*27 2.3.18. 天线检测功能相关语句 2.3.18.1. PQTMCFGANTENNA 设置/查询天线的工作模式。 类型： 设置/查询 格式： //设置： $PQTMCFGANTENNA,W,,* //查询： $PQTMCFGANTENNA,R* 参数： 字段 格式 单位 十进制 - 十进制 - 描述 天线电源。 0 = 关闭电源 1 = 接通电源 天线工作模式。 0 = 自动模式 上海移远通信技术股份有限公司 47 / 54 LG69T(AM,AP) GNSS 协议规范 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGANTENNA,OK* //查询： $PQTMCFGANTENNA,OK,,* ⚫ 如果失败，模块返回： $PQTMCFGANTENNA,ERROR,* 字段信息，详见表 4：错误码。 示例： $PQTMCFGANTENNA,W,0,0*7E $PQTMCFGANTENNA,OK*2D 2.3.18.2. PQTMANTENNASTATUS 输出天线状态。 类型： 输出 格式： $PQTMANTENNASTATUS,,,* 参数： 字段 格式 单位 十进制 - 十进制 - 十进制 - 上海移远通信技术股份有限公司 描述 语句版本。 1 = 版本 1（此版本始终为 1） 天线状态。 0 = 未知 1 = 正常 2 = 开路 3 = 短路 天线电源指示灯。 0 = 关闭电源 48 / 54 LG69T(AM,AP) GNSS 协议规范 字段 格式 单位 示例： $PQTMANTENNASTATUS,1,1,1*4E 描述 1 = 接通电源 2 = 未知 2.3.19. PQTMGNSSTEMP 输出 GNSS 接收机温度。 类型： 输出 格式： $PQTMGNSSTEMP,,,,* 参数： 字段 格式 单位 描述 十进制 - hhmmss.sss - 语句的版本。 1 = 版本 1（此语句版本始终为 1） UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（(00~59） sss：秒的十进制小数 十进制 摄氏度 GNSS 接收机温度。 十进制 热传感器校准状态。 - 0 = 未校准 1 = 已校准 示例： $PQTMGNSSTEMP,1,083737.000,40,1*0F 上海移远通信技术股份有限公司 49 / 54 LG69T(AM,AP) GNSS 协议规范 3 RTCM 协议 LG69T (AM, AP)模块支持 RTCM 协议，该协议符合 RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services - Version 3。该协议用于输入实时差分校正数据和传输 GNSS 原始测量数据，可从 https://www.rtcm.org/获取。 表 6：支持的 RTCM3 语句 语句类型 类型 1005 1006 1019 1042 1044 1046 1074 1077 1094 1097 1114 1117 1124 1127 输入 输入/输出 输入/输出 输入/输出 输入/输出 输入/输出 输入 输入/输出 输入 输入/输出 输入 输入/输出 输入 输入/输出 语句名称 静止 RTK 参考站的天线参考坐标 带天线高度的固定 RTK 参考站的天线参考坐标 GPS 星历数据 BDS 卫星星历数据 QZSS 星历数据 Galileo I/NAV 卫星星历数据 GPS MSM4 GPS MSM7 Galileo MSM4 Galileo MSM7 QZSS MSM4 QZSS MSM7 BDS MSM4 BDS MSM7 上海移远通信技术股份有限公司 50 / 54 LG69T(AM,AP) GNSS 协议规范 4 附录 A 参考文档及术语缩写 表 7：参考文档 文档名称 [1] Quectel_LG69T(AM,AP)_DR&RTK_Application_Note [2] Quectel_LG69T(AM,AP)_Moving_Base_Application_Note 表 8：术语缩写 缩写 英文全称 中文全称 2D 2 Dimension 2维 3D 3 Dimension 3维 BDS BeiDou System 北斗卫星系统 COG COGM COGT DOP Course over Ground 对地航向 Course over Ground (in Magnetic North Course 对地航向（磁北） Direction) Course over Ground (in True North Course 对地航向（真北） Direction) Dilution of Precision 精度因子 Galileo Galileo Satellite Navigation System (EU) 伽利略卫星导航系统（欧盟） GGA Global Positioning System Fix Data 全球定位系统定位数据 GLL Geographic Position - Latitude and Longitude 地理位置—纬度/经度 GNSS Global Navigation Satellite System 全球导航卫星系统 GPS GSA Global Positioning System GNSS DOP and Active Satellites 全球定位系统 GNSS 精度因子（DOP）与有效卫 星 上海移远通信技术股份有限公司 51 / 54 缩写 GSV HDOP NMEA NVM OC PDOP PPS RMC RTCM RTK SBAS SNR SPS UTC UART VDOP VTG LG69T(AM,AP) GNSS 协议规范 英文全称 中文全称 GNSS Satellites in View 可视的 GNSS 卫星 Horizontal Dilution of Precision 水平精度因子 NMEA (National Marine Electronics Association) NMEA(国家海洋电子协会)0183 标 0183 Interface Standard 准 Non-volatile Memory 非易失性存储器 Ordering Code 指定代码 Position Dilution of Precision 位置精度因子 Pulse Per Second 秒脉冲 Recommended Minimum Specific GNSS Data 推荐的最少专有 GNSS 数据 Radio Technical Commission for Maritime 海事无线电技术委员会 Services Real-Time Kinematic 实时动态差分技术 Satellite-Based Augmentation System 星基增强系统 Signal to Noise Ratio 信噪比 Standard Positioning Service 标准定位服务 Coordinated Universal Time 协调世界时 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Vertical Dilution of Precision 垂直精度因子 Course Over Ground & Ground Speed 对地航向和对地速度 上海移远通信技术股份有限公司 52 / 54 LG69T(AM,AP) GNSS 协议规范 5 附录 B GNSS 卫星（NMEA）标识符 表 9：GNSS 卫星（NMEA）标识符 卫星系统 系统标识符 GPS 1 Galileo 3 BDS 4 QZSS 5 卫星标识号 1~32 1~36 1~64 1~10 备注 以上表格仅适用于 NMEA 标准语句。 信号标识号/信号通道 1 = L1 C/A 8 = L5-Q 1 = E5a 7 = L1 1 = B1I 5 = B2-a 1 = L1 C/A 8 = L5-Q 上海移远通信技术股份有限公司 53 / 54 LG69T(AM,AP) GNSS 协议规范 6 附录 C 特殊符号 表 10：特殊符号 特殊符号 [...] {…} 下划线 描述 参数名称。实际命令中不包含尖括号。 语句的可选字段。实际命令中不包含方括号。 循环参数。实际命令中不包含大括号。 参数的默认设置。 上海移远通信技术股份有限公司 54 / 54

MC25 GNSS 协议规范 GSM/GPRS/GNSS 模块系列 版本：1.0 日期：2023-03-22 状态：受控文件 MC25 GNSS 协议规范 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同 时，您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分 析、评估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同 意，尽管移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在 '可用'基础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文 档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 111 MC25 GNSS 协议规范 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问 性、安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 111 MC25 GNSS 协议规范 文档历史 修订记录 版本 1.0 日期 2022-08-17 2023-03-22 作者 Allan LIANG/Zack PAN Allan LIANG/Zack PAN 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 111 MC25 GNSS 协议规范 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 7 图片索引 ....................................................................................................................................................... 8 1 引言 ....................................................................................................................................................... 9 1.1. 模块应用模式.............................................................................................................................. 9 2 NMEA 协议.......................................................................................................................................... 10 2.1. NMEA 协议消息结构 ................................................................................................................ 10 2.2. 通用语句 ................................................................................................................................... 11 2.2.1. RMC ...............................................................................................................................11 2.2.2. VTG ............................................................................................................................... 13 2.2.3. GGA............................................................................................................................... 15 2.2.4. GSA ............................................................................................................................... 17 2.2.5. GSV ............................................................................................................................... 18 2.2.6. GLL................................................................................................................................ 20 2.2.7. DHV ............................................................................................................................... 21 2.2.8. ZDA ............................................................................................................................... 22 2.2.9. GST ............................................................................................................................... 23 2.3. 专用语句 ................................................................................................................................... 24 2.3.1. 数据包类型语句（MC25-MA） ..................................................................................... 25 2.3.1.1. 数据包类型：DFT............................................................................................... 25 2.3.1.2. 数据包类型：SIR................................................................................................ 25 2.3.2. PCAS 语句（MC25-MB）............................................................................................. 26 2.3.2.1. PCAS00.............................................................................................................. 26 2.3.2.2. PCAS01.............................................................................................................. 27 2.3.2.3. PCAS02.............................................................................................................. 28 2.3.2.4. PCAS03.............................................................................................................. 29 2.3.2.5. PCAS04.............................................................................................................. 31 2.3.2.6. PCAS05.............................................................................................................. 31 2.3.2.7. PCAS06.............................................................................................................. 32 2.3.2.8. PCAS10.............................................................................................................. 33 2.3.2.9. PCAS12.............................................................................................................. 34 3 SDBP 协议（MC25-MA） .................................................................................................................. 35 3.1. SDBP 协议数据类型................................................................................................................. 35 3.2. 数据框架基本结构 .................................................................................................................... 35 3.3. SDBP 协议语句 ........................................................................................................................ 36 3.3.1. 通用语句（0x01）......................................................................................................... 36 3.3.1.1. SDBP-PUB-ACK (0x01 0x01) ............................................................................ 36 3.3.1.2. SDBP-PUB-NACK (0x01 0x02) ......................................................................... 37 3.4. 控制语句（0x02）.................................................................................................................... 38 上海移远通信技术股份有限公司 4 / 111 MC25 GNSS 协议规范 3.4.1.1. SDBP-CTL-RESET (0x02 0x01) ........................................................................ 38 3.4.1.2. SDBP-CTL-DEFAULT (0x02 0x02) .................................................................... 38 3.4.1.3. SDBP-CTL-STANDBY (0x02 0x04) ................................................................... 39 3.5. 配置语句（0x03）.................................................................................................................... 39 3.5.1.1. SDBP-CFG-GNSS (0x03 0x11) ......................................................................... 39 3.5.1.2. SDBP-CFG-QZSS (0x03 0x12) ......................................................................... 40 3.5.1.3. SDBP-CFG-SBAS (0x03 0x13).......................................................................... 41 3.5.1.4. SDBP-CFG-UART (0x03 0x21).......................................................................... 41 3.5.1.5. SDBP-CFG-DYNAMIC (0x03 0x31)................................................................... 43 3.5.1.6. SDBP-CFG-FIX (0x03 0x32).............................................................................. 43 3.5.1.7. SDBP-CFG-SV (0x03 0x33) .............................................................................. 44 3.5.1.8. SDBP-CFG-INTERVAL (0x03 0x35) .................................................................. 45 3.5.1.9. SDBP-CFG-PPS (0x03 0x41) ............................................................................ 46 3.5.1.10. SDBP-CFG-NMEA (0x03 0x51) ......................................................................... 47 4 CASIC 协议（MC25-MB） ................................................................................................................. 49 4.1. CASIC 协议结构 ....................................................................................................................... 49 4.1.1. CASIC 协议数据类型..................................................................................................... 50 4.1.2. 语句概览 ........................................................................................................................ 50 4.2. CASIC 语句 .............................................................................................................................. 52 4.2.1. NAV (0x01) .................................................................................................................... 52 4.2.1.1. NAV-STATUS (0x01 0x00) ................................................................................. 52 4.2.1.2. NAV-DOP (0x01 0x01) ....................................................................................... 54 4.2.1.3. NAV-SOL (0x01 0x02) ........................................................................................ 55 4.2.1.4. NAV-PV (0x01 0x03) .......................................................................................... 57 4.2.1.5. NAV-IMUATT (0x01 0x06) .................................................................................. 58 4.2.1.6. NAV-TIMEUTC (0x01 0x10) ............................................................................... 59 4.2.1.7. NAV-CLOCK (0x01 0x11) ................................................................................... 61 4.2.1.8. NAV-GPSINFO (0x01 0x20)............................................................................... 62 4.2.1.9. NAV-BDSINFO (0x01 0x21) ............................................................................... 63 4.2.1.10. NAV-GLNINFO (0x01 0x22) ............................................................................... 65 4.2.2. TIM (0x02) ..................................................................................................................... 66 4.2.2.1. TIM-TP (0x02 0x00) ........................................................................................... 66 4.2.3. RXM (0x03) ................................................................................................................... 67 4.2.3.1. RXM-SENSOR (0x03 0x07)............................................................................... 67 4.2.3.2. RXM-MEASX (0x03 0x10) ................................................................................. 69 4.2.3.3. RXM-SVPOS (0x03 0x11).................................................................................. 71 4.2.4. ACK (0x05).................................................................................................................... 72 4.2.4.1. ACK-NACK (0x05 0x00)..................................................................................... 72 4.2.4.2. ACK-ACK (0x05 0x01) ....................................................................................... 73 4.2.5. CFG (0x06).................................................................................................................... 73 4.2.5.1. CFG-PRT (0x06 0x00) ....................................................................................... 73 4.2.5.2. CFG-MSG (0x06 0x01) ...................................................................................... 75 4.2.5.3. CFG-RST（0x06 0x02） ................................................................................... 76 4.2.5.4. CFG-TP (0x06 0x03) .......................................................................................... 77 上海移远通信技术股份有限公司 5 / 111 MC25 GNSS 协议规范 4.2.5.5. CFG-RATE（0x06 0x04） ................................................................................. 78 4.2.5.6. CFG-CFG (0x06 0x05)....................................................................................... 79 4.2.5.7. CFG-NAVX (0x06 0x07)..................................................................................... 80 4.2.5.8. CFG-GROUP (0x06 0x08) ................................................................................. 82 4.2.5.9. CFG-INS (0x06 0x10) ........................................................................................ 82 4.2.6. MSG (0x08) ................................................................................................................... 83 4.2.6.1. MSG-BDSUTC (0x08 0x00) ............................................................................... 83 4.2.6.2. MSG-BDSION (0x08 0x01) ................................................................................ 84 4.2.6.3. MSG-BDSEPH (0x08 0x02) ............................................................................... 85 4.2.6.4. MSG-GPSUTC (0x08 0x05)............................................................................... 87 4.2.6.5. MSG-GPSION (0x08 0x06)................................................................................ 88 4.2.6.6. MSG-GPSEPH (0x08 0x07)............................................................................... 89 4.2.6.7. MSG-GLNEPH (0x08 0x08) ............................................................................... 90 4.2.7. MON (0x0A) .................................................................................................................. 92 4.2.7.1. MON-HW (0x0A 0x09) ....................................................................................... 92 4.2.8. AID (0x0B)..................................................................................................................... 93 4.2.8.1. AID-INI (0x0B 0x01) ........................................................................................... 93 4.2.8.2. AID-HUI (0x0B 0x03) ......................................................................................... 94 5 GNSS AT 命令 .................................................................................................................................... 97 5.1. AT 命令说明 ............................................................................................................................. 97 5.1.1. 定义 ............................................................................................................................... 97 5.1.2. AT 命令语句................................................................................................................... 97 5.2. AT 示例声明 ............................................................................................................................. 98 5.3. AT 命令详解 ............................................................................................................................. 98 5.3.1. AT+QGNSSC 控制 GNSS 引擎.................................................................................... 98 5.3.2. AT+QGNSSRD 查询 GNSS 导航信息.......................................................................... 99 5.3.3. AT+QGNSSCMD 向 GNSS 引擎发送命令 ................................................................. 100 5.3.4. AT+QGNSSTS 获取 GNSS 引擎时间同步状态.......................................................... 101 5.3.5. AT+QGAGPS 从服务器中下载 AGPS 数据................................................................ 102 5.3.6. AT+QGAGPSAID 注入 AGPS 数据至 GNSS 引擎..................................................... 104 5.3.7. AT+QGREFLOC 为秒定功能设置参考位置信息 ........................................................ 104 5.3.8. AT+QGCFG 配置访问 AGPS 服务器的令牌 .............................................................. 105 5.3.9. AT+QGHAGPS 从 HTTP 服务器中下载 AGPS 数据.................................................. 106 5.4. 错误码..................................................................................................................................... 107 6 附录 A 参考文档及术语缩写.............................................................................................................. 108 7 附录 B 默认配置 ................................................................................................................................ 111 上海移远通信技术股份有限公司 6 / 111 MC25 GNSS 协议规范 表格索引 表 1：All-in-one 与 Stand-alone 的区别 ....................................................................................................... 9 表 2：NMEA 语句结构................................................................................................................................ 10 表 3：发送设备标识符助记码（TalkerID） .................................................................................................11 表 4：SDBP 协议数据类型 ......................................................................................................................... 35 表 5：DBP 协议语句结构 ........................................................................................................................... 36 表 6：SDBP-PUB-ACK 数据内容............................................................................................................... 37 表 7：SDBP-PUB-NACK 数据内容 ............................................................................................................ 37 表 8：SDBP-CTL-RESET 数据内容........................................................................................................... 38 表 9：SDBP-CTL-DEFAULT 数据内容....................................................................................................... 39 表 10：SDBP-CTL-STANDBY 数据内容 .................................................................................................... 39 表 11：SDBP-CFG-GNSS 数据内容 .......................................................................................................... 40 表 12：SDBP-CFG-QZSS 数据内容 .......................................................................................................... 41 表 13：SDBP-CFG-SBAS 数据内容 .......................................................................................................... 41 表 14：SDBP-CFG-UART 数据内容 .......................................................................................................... 42 表 15：SDBP-CFG-DYNAMIC 数据内容 ................................................................................................... 43 表 16：SDBP-CFG-FIX 数据内容 .............................................................................................................. 44 表 17：SDBP-CFG-SV 数据内容 ............................................................................................................... 45 表 18：SDBP-CFG-INTERVAL 数据内容................................................................................................... 45 表 19：SDBP-CFG-PPS 数据内容............................................................................................................. 46 表 20：SDBP-CFG-NMEA 数据内容.......................................................................................................... 47 表 21：CASIC 协议结构 ............................................................................................................................. 49 表 22：CASIC 协议数据类型...................................................................................................................... 50 表 23：CASIC 语句概览 ............................................................................................................................. 50 表 24：UART 工作模式掩码 ....................................................................................................................... 74 表 25：AT 命令类型.................................................................................................................................... 97 表 26：+CME ERROR: 错误码 ....................................................................................................... 107 表 27：参考文档 ....................................................................................................................................... 108 表 28：术语缩写 ....................................................................................................................................... 108 表 29：默认配置 ........................................................................................................................................111 表 30：GNSS 标识符 ................................................................................................................................111 上海移远通信技术股份有限公司 7 / 111 MC25 GNSS 协议规范 图片索引 图 1：NMEA 协议消息结构 ........................................................................................................................ 10 图 2：数据框架基本结构 ............................................................................................................................ 35 图 3：CASIC 协议结构 ............................................................................................................................... 49 上海移远通信技术股份有限公司 8 / 111 MC25 GNSS 协议规范 1 引言 移远通信 MC25 模块是一款集成了高性能 GNSS 引擎和四频 GSM/GPRS 引擎的多功能模块。GNSS 引擎为单个接收器，集成了 GPS、BDS 和 GLONASS 系统，支持自主 GPS、BDS、GLONASS、SBAS 和 QZSS 等多种定位导航系统。MC25 内嵌 GNSS 功能，可以帮助客户获取准确的坐标、高精度的时间 等，非常适用于可穿戴设备、车辆和人员跟踪等更多领域。 本文档介绍了 MC25 模块支持的 NMEA 0183 协议、SDBP 协议和 CASIC 协议，以及 GNSS 功能相 关 AT 命令。 1.1. 模块应用模式 MC25 模块内部的 GSM 和 GNSS 引擎可以根据客户的需求作为一个整体工作（All-in-one 应用模 式）或相对独立工作（Stand-alone 应用模式）。 在 All-in-one 应用模式中，MC25 作为一个整体工作。GNSS 部分可以看作是 GSM 部分的外围设 备，允许 GSM 和 GNSS 部件之间方便通信，例如发送用于 GNSS 控制的 AT 命令。 在 Stand-alone 应用模式中，GSM 和 GNSS 部分独立工作，因此必须单独控制。 在使用 All-in-one 或 Stand-alone 应用模式时，MC25 在获取 NMEA 输出数据或发送 GNSS 命令方 面存在一些差异。详情如下： 表 1：All-in-one 与 Stand-alone 的区别 功能 NMEA 输出数据收集 NMEA 格式（ASCII）命令发送 十六进制格式命令发送 All-in-one 通过发送 AT+QGNSSRD 获取 通过 AT+QGNSSCMD 发送 通过 AT+QGNSSCMD 发送 Stand-alone 直接获取 直接发送 直接发送 备注 AT 命令仅在模块处于 All-in-one 模式时有效。 上海移远通信技术股份有限公司 9 / 111 MC25 GNSS 协议规范 2 NMEA 协议 2.1. NMEA 协议消息结构 每一帧的起始字段，固定 均为 $ 地址字段，包含了Talker ID和语句的属性 以 * 开始，校验和为8位 异或的校验和转换成的十六 进制的数 数据字段，使用 , 隔开 结束字符，固定为 $ () [,] * 校验和的计算范围 图 1：NMEA 协议消息结构 表 2：NMEA 语句结构 字段 $ 描述 NMEA 语句的起始字段（Hex 0x24）。 NMEA 通用语句： 通用地址字段由 5 个字符（大写字母）组成。通用地址字段前两个字母是发送设备标识 符（TalkerID），详见表 3，用于定义所传输数据的定位模式。通用地址字段的后三个字 符为通用语句标识符（SentenceFormatter），用于定义语句中其它数据的格式和类型。 NMEA 专用语句： 专用地址字段由专用字符'P'、制造商助记码（三个字符）、以及可选附加字符组成。 其中制造商助记码用来标识发出一个专用语句的发送设备。 语句中的数据字段跟在定界符','之后。 由于存在可变长度字段和空字段，只有通过观察字段定界符','才能确定特定数据字段 在一条语句中的位置。因而应通过对定界符的计数来确定字段位置，而不应通过对接收 字符总个数的计数来确定字段位置。 上海移远通信技术股份有限公司 10 / 111 MC25 GNSS 协议规范 所有的语句中都应包含校验和字段。校验和字段是语句中的最后一个字段，在校验和定 界符'*'之后。 校验和是对语句中所有字符的 8 位（不包括起始和结束位）进行异或运算，所有字符是 指在定界符'$'与'*'之间，但不包括这些定界符的全部字符，包括','在内。 NMEA 语句的结束字符（Hex 0x0D 0x0A）。 表 3：发送设备标识符助记码（TalkerID） Talker ID GPS BDS GGA GP BD GLONASS GL GPS + GLONASS GN RMC GP BD GL GN GLL GP BD GL GN VTG GP BD GL GN GSA GP BD GL GN DHV GP BD GL GN GSV GP BD GL GP + GL GPS + BDS GN GN GN GN GN GN GP + BD GLONASS + BDS GN GN GN GN GN GN GL + BD 2.2. 通用语句 本章节介绍模块支持的 NMEA 0183 V4.10 通用语句。 2.2.1. RMC RMC 表示推荐的最少专用 GNSS 数据。本语句包含 GNSS 接收机提供的时间、日期、位置、航迹向 和速度数据。 类型： 输出。 格式： $RMC,,,,,,,,,,,,,* 上海移远通信技术股份有限公司 11 / 111 MC25 GNSS 协议规范 参数： 字段 $ RMC 格式 字符串，2 位 字符串，3 位 hhmmss.ss 字符 ddmm.mmmmm 字符 dddmm.mmmmm 字符 十进制 十进制 ddmmyy 单位 - - - - - 节 度 - 示例 描述 $ RMC 085152.00 A 3150.78499 N 11711.90193 E 0.176 221018 每条 NMEA 语句均以'$'开始。 发 送 设 备 标 识 符 助 记 码 （ TalkerID ）。 详情参考表 3。 推荐的最少专用 GNSS 数据。 定位的 UTC 时间。 hh：小时（范围：00~23） mm：分钟（范围：00~59） ss：秒（范围：00~59） ss：秒的十进制小数 定位系统状态。 A = 数据有效 V = 无效 纬度。 dd：度（范围：00~90） mm：分（范围：00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 纬度方向。 N = 北 S = 南 数据无效时，此字段为空。 经度。 ddd：度（范围：000~180） mm：分（范围：00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 经度方向。 E = 东 W = 西 数据无效时，此字段为空。 对地速度。可变长度。 数据无效时，此字段为空。 对地真航向。可变长度。最大值： 359.9。 数据无效时，此字段为空。 日期。 dd：日 mm：月 上海移远通信技术股份有限公司 12 / 111 - - 字符 字符 十六进制 字符 - - - - - A - V - *1E - - MC25 GNSS 协议规范 yy：年 磁偏角，不输出。 磁偏角方向，不输出。 定位模式。 A = 自主式模式，卫星系统处于非差分 定位模式。 D = 差分模式，卫星系统处于差分定位 模式；基于地面站或 SBAS 的修正。 N = 无定位，卫星系统没有用于位置定 位，或定位无效。 导 航 状 态 （ 暂 不 支 持 ）， 始 终 为 ' V ' （导航状态无效，设备不能提供导航状 态指示）。 校验和。 回车换行。 示例： $GNRMC,085152.00,A,3150.78499,N,11711.90193,E,0.176,,221018,,,A,V*1E $GPRMC,090853.00,A,3150.78462,N,11711.89851,E,0.071,,221018,,,A,V*01 $GLRMC,095332.00,A,3150.76852,N,11711.91845,E,0.111,,221018,,,A,V*1E $BDRMC,095703.00,A,3150.77667,N,11711.93068,E,0.518,,221018,,,A,V*14 2.2.2. VTG VTG 语句包含相对于地面的实际航向和速度。 类型： 输出。 格式： $VTG,,T,,M,,N,,K,* 上海移远通信技术股份有限公司 13 / 111 参数： 字段 $ VTG T M N K 格式 单位 - - 字符串，2 位 - 字符串，3 位 - 十进制 度 字符 十进制 字符 十进制 字符 十进制 字符 度 节 千米/小时 - 字符 - 十六进制 - 字符 - MC25 GNSS 协议规范 示例 $ VTG - T M 0.054 N 0.101 K A *3C - 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详 情参考表 3。 对地航向及速度。 对地航向（真北）。当设备静止，GNSS 定位位置未发生移动时，对于 MC25-MB 模 块 ， 该 值 为 0 ； 对 于 MC25-MA 模块，该值为空。 固定字段。 对地航向（磁北）。 暂不支持。 固定字段。 对地速度。 固定字段。 对地速度。 固定字段。 模式指示。 A = 自主模式，卫星系统处于非差分定 位模式。 D = 差分模式，卫星系统处于差分定位 模式；基于地面站或 SBAS 的修正。 N = 无定位，卫星系统没有用于位置定 位，或定位无效。 校验和。 回车换行。 示例： $GNVTG,,T,,M,0.054,N,0.101,K,A*3C $GPVTG,,T,,M,0.071,N,0.132,K,A*25 $GLVTG,,T,,M,0.111,N,0.206,K,A*3A $BDVTG,,T,,M,0.518,N,0.959,K,A*3B 上海移远通信技术股份有限公司 14 / 111 MC25 GNSS 协议规范 2.2.3. GGA GGA 提供全球定位系统定位数据。本语句包含 3D 位置和精度数据的基本定位数据。 类型： 输出。 格式： $GGA,,,,,,,,,,M,,M,,* 参数： 字段 $ GGA 格式 单位 示例 描述 - - $ 每条 NMEA 语句均以'$'开始。 字符串，2 位 - - 发送设备标识符助记码（TalkerID）。 详情参考表 3。 字符串，3 位 - GGA GGA 提供全球定位系统定位数据。 hhmmss.ss 定位的 UTC 时间。 hh：小时（范围：00~23） - 094324.00 mm：分钟（范围：(00~59） ss：秒（范围：00~59） ss：秒的十进制小数 ddmm.mmmmm - 3150.77559 纬度。 dd：度（范围：00~90） mm：分（范围：00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 字符 - N 纬度方向。 N = 北 S = 南 数据无效时，此字段为空。 经度。 dddmm.mmmmm ddd：度（范围：000~180） - 11711.92539 mm：分（范围：00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 字符 - E 经度方向。 E = 东 上海移远通信技术股份有限公司 15 / 111 十进制，1 位 - 1 1) 十进制，2 位 十进制 十进制 M 字符 十进制 M 字符 - 十六进制 字符 - 07 - 2.10 米 52.9 - M 米 -2.2 - M - - - - - *60 - - MC25 GNSS 协议规范 W = 西 数据无效时，此字段为空。 GPS 定位模式/状态指示。 0 = 定位不可用或无效 1 = GPS SPS 模式，定位有效 2 = 差分 GPS，定位有效 6 = 估算（航位推算）模式 使用的卫星数。范围：0~26。 水平精度因子。 平均海平面以上海拔（大地水准 面）。 固定字段。 大地水准面差距（WGS84 基准面与 平均海平面之间的差值）。 固定字段。 差分卫星导航系统数据龄期。若不使 用 DGPS，则该字段为空。 分基准站标识号。若不使用 DGPS， 则该字段为空。 校验和。 回车换行。 示例： $GNGGA,094324.00,3150.77559,N,11711.92539,E,1,07,2.10,52.9,M,-2.2,M,,*60 $GPGGA,090853.00,3150.78462,N,11711.89851,E,1,05,1.86,115.3,M,-2.2,M,,*48 $GLGGA,095332.00,3150.76852,N,11711.91845,E,1,04,5.85,65.7,M,-2.2,M,,*64 $BDGGA,095703.00,3150.77667,N,11711.93068,E,1,04,3.31,57.8,M,-2.2,M,,*64 备注 1. NMEA 0183 协议指示 GGA 消息为 GPS 系统特有；但当接收器配置为多星系时，GGA 消息的内容 将从多星系解决方案中生成。 2. 1) NMEA 0183 协议定义的使用中卫星数量范围为 00~12，然而，在多星系解决方案中，使用的卫星 数量可能超过 12 颗。 上海移远通信技术股份有限公司 16 / 111 MC25 GNSS 协议规范 2.2.4. GSA GSA 表示 GNSS 精度因子（DOP）与有效卫星。本语句包含 GNSS 接收机工作模式、GGA 或 GNS 语句报告的导航解算中用到的卫星以及精度因子的值。 类型： 输出。 格式： $GSA,,,,…,,,,* 参数： 字段 $ GSA 格式 单位 - - 字符串，2 位 - 字符串，3 位 - 字符 - 十进制 - 参数循环开始。循环次数：12 次 十进制 - 参数循环结束 十进制 - 十进制 - 十进制 - 十进制 - 示例 $ GSA A 3 12 2.68 1.45 2.25 1 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。 详情参考表 3。 GNSS 精度因子（DOP）与有效卫星。 模式。 M = 手动，强制用于 2D 或 3D 定位模式 A = 自动，允许 2D/3D 定位模式自动变换 定位模式。 1 = 定位不可用 2 = 2D 定位 3 = 3D 定位 解算中用到的卫星标识号。详情参考表 30。 位置精度因子。最大值为 99.0 水平精度因子。最大值为 99.0。 垂直精度因子。最大值为 99.0。 GNSS 系统标识符。 1 = GPS 上海移远通信技术股份有限公司 17 / 111 十六进制 - 字符 - 2 = GLONASS 4 = BDS *0E 校验和。 - 回车换行。 MC25 GNSS 协议规范 示例： $GNGSA,A,3,12,15,24,25,,,,,,,,,2.68,1.45,2.25,1*0E $GNGSA,A,3,70,80,69,71,,,,,,,,,3.03,2.10,2.18,2*0C $GNGSA,A,3,06,01,04,,,,,,,,,,3.03,2.10,2.18,4*0F $GPGSA,A,3,24,20,10,32,21,,,,,,,,3.92,1.86,3.45,1*1D $GLGSA,A,3,70,80,69,71,,,,,,,,,7.20,5.85,4.20,2*0D 备注 如果用于定位导航的卫星少于 12 颗，则剩余的字段将为空。如果超过 12 颗卫星用于定位导 航，则仅输出前 12 颗卫星的卫星标识号。 2.2.5. GSV GSV 表示可视的 GNSS 卫星。本语句包含可视的卫星数、卫星标识号、仰角、方位角和信噪比。每 次传送，一个 GSV 语句只能包含最多 4 颗卫星的数据，因此可能需要多个语句才能获得完整的信息。数 据字段的前两个字段表示传输的总句数和句数。 类型： 输出。 格式： $GSV,,,,,,,[, …],* 参数： 字段 $ 格式 单位 示例 - - $ 字符串，2 位 - - 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详情参 考表 3。 上海移远通信技术股份有限公司 18 / 111 MC25 GNSS 协议规范 GSV 字符串，3 位 - 十进制 - 十进制 - 十进制 - 参数循环开始。循环次数：1~4 次 十进制 - 十进制 度 十进制 度 GSV 3 1 09 10 49 322 十进制 dB-Hz 30 参数循环结束 十进制 - 0 十六进制 - *66 字符 - - 可视的 GNSS 卫星。 语句总数。范围：1~4。 语句号。范围：1~。 可视的卫星总数。 卫星标识号。详情参考表 30。 仰角。范围：00~90。 真方位角。范围：000~359。 载噪比（C/N0）。范围：00~99。 未跟踪时为空。 0 = 所有信道。 校验和。 回车换行。 示例： $GPGSV,3,1,09,10,49,322,30,12,29,119,16,14,10,272,09,15,31,068,,0*66 $GPGSV,3,2,09,20,80,322,27,21,35,216,30,24,52,044,18,25,19,159,13,0*6A $GPGSV,3,3,09,32,26,285,29,0*5D $GLGSV,1,1,04,69,20,109,40,70,60,046,43,71,33,331,50,80,55,041,46,0*75 $BDGSV,1,1,03,01,44,142,40,04,31,120,41,06,65,022,43,0*47 备注 'GN'标识符不可用于该语句。如果可以多个卫星系统可视，则设备输出多条 GSV 语句（用发送设备 标识符 GP 表示可视的 GPS 卫星，用 GL 表示可视的 GLONASS 卫星，用 BD 表示可视的 BDS 卫星 等）。 上海移远通信技术股份有限公司 19 / 111 MC25 GNSS 协议规范 2.2.6. GLL GLL 表示地理位置—纬度和经度。本语句包含接收机的纬度与经度、定位时间和状态。 类型： 输出。 格式： $GLL,,,,,,,* 参数： 字段 $ GLL 格式 字符串，2 位 字符串，3 位 ddmm.mmmmm 字符 dddmm.mmmmm 字符 hhmmss.ss 单位 - - - - - 示例 描述 $ 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详 - 情参考表 3。 GLL 地理位置—纬度和经度。 3150.77559 N 11711.92539 E 094324.00 纬度。 dd：度（范围：00~90） mm：分（范围：00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 纬度方向。 N = 北 S = 南 数据无效时，此字段为空。 经度。 ddd：度（范围：000~180） mm：分（范围：00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 经度方向。 E = 东 W = 西 数据无效时，此字段为空。 定位的 UTC 时间。 hh：小时（范围：00~23） mm：分钟（范围：00~59） ss：秒（范围：00~59） 上海移远通信技术股份有限公司 20 / 111 字符 字符 十六进制 字符 - A - A - *72 - - MC25 GNSS 协议规范 ss：秒的十进制小数 定位系统状态。 V = 无效 A = 自主模式 模式指示。 A = 自主模式，卫星系统处于非差分定 位模式。 D = 差分模式，卫星系统处于差分定位 模式；基于地面站或 SBAS 的修正。 N = 无定位，卫星系统没有用于位置定 位，或定位无效。 校验和。 回车换行。 示例： $GNGLL,3150.77559,N,11711.92539,E,094324.00,A,A*72 $GPGLL,3150.78462,N,11711.89851,E,090853.00,A,A*6C $GLGLL,3150.76847,N,11711.91841,E,095331.00,A,A*77 $BDGLL,3150.77668,N,11711.93041,E,095702.00,A,A*76 2.2.7. DHV 该语句用于显示接收机速度的详细信息。 类型： 输出。 格式： $DHV,,,,,,* 参数： 字段 $ 格式 字符串，2 位 单位 - 示例 - 描述 每条 NMEA 语句均以'$'开 始。 发送设备标识符助记码 （TalkerID）。详情参考表 3。 上海移远通信技术股份有限公司 21 / 111 MC25 GNSS 协议规范 DHV 字符串，3 位 - hhmmss.sss - 数值 m/s 数值 m/s 数值 m/s 数值 m/s 数值 m/s 十六进制 - 字符 - DHV 021150.000 0.03 0.006 -0.042 -0.026 0.06 *65 - 接收机速度详细信息。 当前定位的的 UTC 时间。 hh：小时（范围：00~23） mm：分钟（范围：00~59） ss：秒（范围：00~59） sss：秒的十进制小数 接收机三维速度。 接收机 ECEF-X 轴方向速度。 接收机 ECEF-Y 轴方向速度。 接收机 ECEF-Z 轴方向速度。 接收机水平地面方向速度。 校验和。 回车换行。 示例： $GNDHV,021150.000,0.03,0.006,-0.042,-0.026,0.06*65 备注 仅 MC25-MB 模块支持该语句。 2.2.8. ZDA ZDA 表示时间与日期。本语句主要用于输出 UTC 时间，日、月、年及本地时区。 类型： 输出。 格式： $ZDA,,,,,,* 上海移远通信技术股份有限公司 22 / 111 参数： 字段 $ ZDA 格式 字符串，2 位 字符串，3 位 单位 - hhmmss.sss - 十进制 日 十进制 月 十进制 年 十进制 时 十进制 分 十六进制 - 字符 - MC25 GNSS 协议规范 示例 ZDA 021150.000 13 3 2023 00 00 *4D - 描述 每条 NMEA 语句均以'$'开 始。 发送设备标识符助记码 （TalkerID）。详情参考表 3。 时间与日期。 当前定位的的 UTC 时间。 hh：小时（范围：00~23） mm：分钟（范围：00~59） ss：秒（范围：00~59） sss：秒的十进制小数 日。范围：01~31。 月。范围：01~12。 年。 不支持，固定为 0。 不支持，固定为 0。 校验和。 回车换行。 示例： $GNZDA,021150.000,13,03,2023,00,00*4D 2.2.9. GST 该语句用于输出 GNSS 伪距误差统计数据。 类型： 输出。 格式： $GST,,,,,,,,* 上海移远通信技术股份有限公司 23 / 111 参数： 字段 $ GST 格式 字符串，2 位 字符串，3 位 单位 - hhmmss.sss - 十进制 米 < StdMajor> 十进制 米 十进制 米 十进制 度 十进制 米 十进制 米 十进制 米 十六进制 - 字符 - 示例： $GNGST,112917.000,1.4,,,,1.0,1.2,2.5*5A MC25 GNSS 协议规范 示例 GST 112917.000 1.4 1.0 1.2 2.5 *5A - 描述 每条 NMEA 语句均以'$'开 始。 发送设备标识符助记码 （TalkerID）。详情参考表 3。 GNSS 伪距误差统计数。 当前定位的的 UTC 时间。 hh：小时（范围：00~23） mm：分钟（范围：00~59） ss：秒（范围：00~59） sss：秒的十进制小数 伪距误差的均方差。最大值： 3750000。 误差椭圆的半长轴。 误差椭圆的半短轴。 误差椭圆的半长轴指向，从正北 起顺时针。 纬度方向的误差均方差。 经度方向的误差均方差。 高度方向的误差均方差。 校验和。 回车换行。 2.3. 专用语句 本章节介绍 MC25 模块支持的拓展的 NMEA 语句（由芯片供应商定义的 NMEA 专用语句），这些语句 用于控制和配置 MC25 模块内部 GNSS 引擎。 上海移远通信技术股份有限公司 24 / 111 MC25 GNSS 协议规范 2.3.1. 数据包类型语句（MC25-MA） 本章介绍 MC25-MA 模块支持的数据包类型语句（由芯片供应商定义的 NMEA 专用语句）。 2.3.1.1. 数据包类型：DFT 该语句用于恢复默认设置。 类型： 输入。 格式： $CCDFT,* 参数： 字段 $CCDFT 格式 字符串，5 位 十进制 十六进制 字符 示例 0 *66 - 示例： $CCDFT,0,*66 描述 恢复默认设置。 恢复模式。 0 = 将所有设置恢复为默认值 校验和。 回车换行。 2.3.1.2. 数据包类型：SIR 该语句用于设置工作模式和启动模式。 类型： 输入。 上海移远通信技术股份有限公司 25 / 111 格式： $CCSIR,,* 参数： 字段 $CCSIR 格式 字符串 示例 - 十进制 3 十进制 1 十六进制 *4A 字符 - MC25 GNSS 协议规范 描述 设置工作模式和启动模式。 工作模式。 1 = BDS 2 = GPS 3 = BDS + GPS 4 = GLONASS 5 = BDS + GLONASS 6 = GPS + GLONASS 启动模式。 0 = 自动模式 1 = 冷启动 2 = 温启动 3 = 热启动 校验和。 回车换行。 示例： $CCSIR,3,1*4A 2.3.2. PCAS 语句（MC25-MB） 本章介绍 MC25-MB 模块支持的 PCAS 语句（由芯片供应商定义的 NMEA 专用语句）。 2.3.2.1. PCAS00 该语句用于保存当前配置信息至 flash 中，即使接收机完全断电，flash 中的信息也不会丢失。 类型： 输入。 上海移远通信技术股份有限公司 26 / 111 格式： $PCAS00* 参数： 字段 $PCAS00 格式 字符串 十六进制 字符 示例： $PCAS00*01 单位 - 描述 消息 ID，语句头。 校验和。 回车换行。 2.3.2.2. PCAS01 该语句用于配置串口（UART3）通信波特率。 类型： 输入。 格式： $PCAS01,* 参数： 字段 $PCAS01 格式 字符串 十进制 单位 - bps 描述 消息 ID，语句头。 波特率。 0 4800 bps 1 9600 bps 2 19200 bps 3 38400 bps 4 57600 bps 5 115200 bps MC25 GNSS 协议规范 上海移远通信技术股份有限公司 27 / 111 十六进制 字符 示例： $PCAS01,1*1D - 校验和。 - 回车换行。 MC25 GNSS 协议规范 2.3.2.3. PCAS02 该语句用于配置目标位置更新频率。 类型： 输入。 格式： $PCAS02,* 参数： 字段 $PCAS02 格式 字符串 单位 - 十进制 毫秒 十六进制 - 字符 - 描述 消息 ID，语句头。 定位更新时间间隔。 1000 更新率为 1 Hz，每秒输出 1 个定位点 500 更新率为 2 Hz，每秒输出 2 个定位点 250 更新率为 4 Hz，每秒输出 4 个定位点 200 更新率为 5 Hz，每秒输出 5 个定位点 校验和。 回车换行。 示例： $PCAS02,1000*2E 上海移远通信技术股份有限公司 28 / 111 MC25 GNSS 协议规范 2.3.2.4. PCAS03 该语句用于配置 NMEA 语句输出类型和输出频率。 类型： 输入。 格式： $PCAS03,,,,,,,,,,,,,,* 参数： 字段 $PCAS03 格式 字符串 十进制，1 位 十进制，1 位 十进制，1 位 十进制，1 位 十进制，1 位 十进制，1 位 单位 - 描述 消息 ID，语句头。 GGA 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 GLL 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 GSA 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 GSV 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 RMC 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 VTG 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 上海移远通信技术股份有限公司 29 / 111 十进制，1 位 - 十进制，1 位 - 十进制，1 位 - 十进制，1 位 - - - - - 十进制，1 位 - 十进制，1 位 - 十六进制 - 字符 - MC25 GNSS 协议规范 ZDA 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 ANT 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 DHA 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 LPS 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置，目前该语句暂未支持 保留（建议为 0）。 保留（建议为 0）。 UTC 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置，目前该语句暂未支持 GST 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 校验和。 回车换行。 示例： $PCAS03,1,1,1,1,1,1,1,1,0,1,0,0,1,0*02 备注 1. MC25-MB 模块不支持其中的 LPS/UTC 语句输出。 2. 有关上述语句的详细信息，请参考 NMEA 0183 V4.10。 上海移远通信技术股份有限公司 30 / 111 MC25 GNSS 协议规范 2.3.2.5. PCAS04 该语句用于配置 GNSS 工作模式。 类型： 输入。 格式： $PCAS04,* 参数： 字段 格式 单位 $PCAS04 字符串 - 十进制 - 十六进制 - 字符 - 描述 消息ID，语句头。 GNSS工作模式。 1 GPS 2 BDS 3 GPS + BDS 4 GLONASS 5 GPS + GLONASS 6 BDS + GLONASS 7 GPS + BDS + GLONASS 校验和。 回车换行。 示例： $PCAS04,3*1A 2.3.2.6. PCAS05 该语句用于配置 NMEA 语句兼容版本。 类型： 输入。 上海移远通信技术股份有限公司 31 / 111 格式： $PCAS05,* 参数： 字段 格式 单位 $PCAS05 字符串 - 十进制 - 十六进制 - 字符 - 示例： $PCAS05,2*1A 2.3.2.7. PCAS06 该语句用于查询产品信息。 类型： 输入。 格式： $PCAS06,* 参数： 字段 $PCAS06 格式 字符串 单位 - 十进制 - 上海移远通信技术股份有限公司 MC25 GNSS 协议规范 描述 消息 ID，语句头。 兼容版本。 2 与 NMEA 4.10 及更高版本兼容 5 与 NMEA 4.00 兼容 9 与 NMEA 2.20 兼容 校验和。 回车换行。 描述 消息 ID，语句头。 产品信息。 0 查询固件版本号 5 查询升级码信息 32 / 111 十六进制 - 字符 - 示例： $PCAS06,0*1B 校验和。 回车换行。 MC25 GNSS 协议规范 2.3.2.8. PCAS10 该语句用于设置模块/接收机的启动模式，并以该模式重启模块。 类型： 输入。 格式： $PCAS10,* 参数： 字段 $PCAS10 格式 字符串 单位 - 十进制 - 十六进制 - 字符 - 描述 消息 ID，语句头。 启动模式。 0 热启动。不进行数据初始化，备份中的所有数 据均有效。 1 温启动。不进行数据初始化，将清除星历数据。 2 冷启动。不进行数据初始化，除备份中的配置 外，将清除所有数据。 3 工厂启动。清除内存中的所有数据并将接收机 重置为出厂默认配置。 校验和。 回车换行。 示例： $PCAS10,0*1C 上海移远通信技术股份有限公司 33 / 111 2.3.2.9. PCAS12 该语句用于控制接收器待机模式。 类型： 输入。 格式： $PCAS12,* 参数： 字段 $PCAS12 格式 字符串 十进制 十六进制 字符 单位 秒 - 示例： $PCAS12,60*28 MC25 GNSS 协议规范 描述 消息 ID，语句头。 接收机维持在待机模式的时间，超过设定时间， 接收机自动退出待机模式。最大值：65535。 校验和。 回车换行。 上海移远通信技术股份有限公司 34 / 111 MC25 GNSS 协议规范 3 SDBP 协议（MC25-MA） 本章介绍 MC25-MA 模块支持的 SDBP 协议（由芯片供应商定义的专有协议）。这些协议语句用于控 制和配置 MC25-MA 模块内部 GNSS 引擎。 3.1. SDBP 协议数据类型 所有多字节数据都以小端模式保存和传输。数据类型定义如下表所示。 表 4：SDBP 协议数据类型 名称 类型 I8U unsigned char I16U unsigned short I32S I32U signed int unsigned int B8 bit field 字节 1 2 4 4 1 编码格式 补码 - 3.2. 数据框架基本结构 Head (2 Bytes) Identifier (2 Bytes) Check range Data length (2 Bytes) Data (n Bytes) Checksum (2 Bytes) 图 2：数据框架基本结构 上海移远通信技术股份有限公司 35 / 111 MC25 GNSS 协议规范 表 5：DBP 协议语句结构 字段 Head Identifier Data Length Data Checksum 说明 SDBP 协议语句的起始部分。2 字节的 16 进制值，恒为 0x23 0x3E。 标识符。2 字节的 16 进制数值。 数据长度。单位：字节。 数据。 校验和由 FletCher16 计算，范围包括标识符、数据长度和数据。 校验和示例代码如下： I16U FletCher16(const I8U* pbuf, I16U len) { I16U cs1,cs2; cs1= cs2= 0; while(len --) { cs1 += *pbuf++; cs2 += cs1; } return (cs2 << 8) | (cs1 & 0xFF); } 3.3. SDBP 协议语句 3.3.1. 通用语句（0x01） 3.3.1.1.SDBP-PUB-ACK (0x01 0x01) 该语句为信息响应语句，用于回应命令有效且执行成功。 类型： 输出。 上海移远通信技术股份有限公司 36 / 111 结构： 头 0x23 0x3E 标识符 0x01 0x01 数据长度 2 字节 MC25 GNSS 协议规范 数据 请参考表 6。 校验和 - 表 6：SDBP-PUB-ACK 数据内容 序号 0 1 类型 I8U I8U 名称 标识符的类型代码 标识符的功能代码 描述 已发送命令的类型代码（包含在标识符中）。 已发送命令的功能代码（包含在标识符中）。 3.3.1.2.SDBP-PUB-NACK (0x01 0x02) 该语句为信息响应语句，用于回应命令无效且执行失败。 类型： 输出。 结构： 头 0x23 0x3E 标识符 0x01 0x02 数据长度 2 字节 数据 请参考表 7。 校验和 - 表 7：SDBP-PUB-NACK 数据内容 序号 0 1 类型 I8U I8U 名称 标识符的类型代码 标识符的功能代码 描述 已发送命令的类型代码（包含在标识符中）。 已发送命令的功能代码（包含在标识符中）。 上海移远通信技术股份有限公司 37 / 111 MC25 GNSS 协议规范 3.4. 控制语句（0x02） 3.4.1.1. SDBP-CTL-RESET (0x02 0x01) 该命令用于重启模块。若该命令无效，则返回 SDBP-PUB-NACK。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x02 0x01 数据长度 1 字节 数据 请参考表 8。 校验和 - 表 8：SDBP-CTL-RESET 数据内容 序号 类型 名称 1 I8U 启动模式 描述 0x01 0x02 0x03 冷启动 温启动 热启动 3.4.1.2.SDBP-CTL-DEFAULT (0x02 0x02) 该命令用于恢复默认设置。若命令有效并成功执行，则返回 SDBP-PUB-ACK，否则返回 SDBPPUB-NACK。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x02 0x02 数据长度 1 字节 数据 请参考表 9。 校验和 - 上海移远通信技术股份有限公司 38 / 111 表 9：SDBP-CTL-DEFAULT 数据内容 序号 1 类型 I8U 名称 默认设置的位 MC25 GNSS 协议规范 描述 0xFF 将所有设置恢复为默认值 3.4.1.3.SDBP-CTL-STANDBY (0x02 0x04) 该命令用于配置模块进入低功耗待机模式。进入该模式后，芯片自动关闭主电源并停止工作，并通过 特定引脚（RXD）的电平变化（上升或下降）唤醒。唤醒芯片相当于重置芯片。若该命令有效并成功执 行，则模块进入待机模式。否则返回 SDBP-PUB-NACK。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x02 0x04 数据长度 1 数据 请参考表 10。 校验和 - 表 10：SDBP-CTL-STANDBY 数据内容 序号 类型 名称 1 I8U 控制模块进入待机模式 描述 0x01 进入待机模式 其他值 保留且无响应 3.5. 配置语句（0x03） 3.5.1.1.SDBP-CFG-GNSS (0x03 0x11) 该命令用于配置 GNSS 工作模式。若该命令无效，则返回 SDBP-PUB-NACK。若该命令有效且执行 成功，则返回 SDBP-PUB-ACK 且 RF 无需重新配置。若需配置 RF，则模块重启无响应。选择 GPS 系统 时，SBAS 系统自动开启；当不需要 SBAS 时，则需发送 SBAS 控制命令关闭系统。 上海移远通信技术股份有限公司 39 / 111 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x11 数据长度 2 MC25 GNSS 协议规范 数据 请参考表 11。 校验和 - 表 11：SDBP-CFG-GNSS 数据内容 序号 类型 名称 1 I8U GNSS 工作模式 2 I8U 自动保存 描述 1 BDS 2 GPS 3 BDS + GPS 4 GLONASS 5 BDS + GLONASS 6 GPS + GLONASS 1 保存到备份区 其他值 不保存，上电后恢复默认值 3.5.1.2.SDBP-CFG-QZSS (0x03 0x12) 该命令用于打开或关闭 QZSS。若该命令有效并成功执行，则返回 SDBP-PUB-ACK；否则返回 SDBP-PUB-NACK。QZSS 系统必须与 GPS 系统同时使用。若 GPS 关闭，则 QZSS 自动关闭；GPS 开 启后，根据需要使用控制命令开启或关闭 QZSS。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x12 数据长度 2 数据 请参考表 12。 校验和 - 上海移远通信技术股份有限公司 40 / 111 表 12：SDBP-CFG-QZSS 数据内容 序号 类型 名称 1 I8U QZSS 开关 2 I8U 自动保存 MC25 GNSS 协议规范 描述 0 关闭 QZSS 1 打开 QZSS 1 保存到备份区 其他值 不保存，上电后恢复默认值 3.5.1.3. SDBP-CFG-SBAS (0x03 0x13) 该命令用于打开或关闭 SBAS。若该命令有效并成功执行，则返回 SDBP-PUB-ACK；否则返回 SDBP-PUB-NACK。SBAS 系统必须与 GPS 系统同时使用。若 GPS 关闭，则 SBAS 自动关闭；GPS 开 启后，SBAS 自动开启，并根据需要使用控制命令关闭。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x13 数据长度 2 数据 请参考表 13。 校验和 - 表 13：SDBP-CFG-SBAS 数据内容 序号 类型 名称 1 I8U SBAS 开关 2 I8U 自动保存 描述 0 关闭 SBAS 1 打开 SBAS 1 保存到备份区 其他值 不保存，上电后恢复默认值 3.5.1.4. SDBP-CFG-UART (0x03 0x21) 该命令用于配置 UART。若该命令有效并成功执行，则返回 SDBP-PUB-ACK；否则返回 SDBPPUB-NACK。 默认设置： ⚫ 波特率：9600 bps ⚫ 数据位：8 位 上海移远通信技术股份有限公司 41 / 111 ⚫ 终止位：1 位 ⚫ 校验位：无 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x21 数据长度 6 MC25 GNSS 协议规范 数据 请参考表 14。 校验和 - 表 14：SDBP-CFG-UART 数据内容 序号 类型 名称 1 I8U UART 接口 2 I8U 波特率 3 I8U - 4 I8U - 5 I8U - 6 I8U 自动保存 描述 1 UART1 2 UART2 1 4800 bps 2 9600 bps 3 19200 bps 4 38400 bps 5 57600 bps 6 115200 bps 7 230400 bps 保留。 保留。 保留。 1 保存到备份区 其他值 不保存，上电后恢复默认值 备注 MC25-MA 模块的 GNSS 引擎不支持修改数据位、终止位和校验位。 上海移远通信技术股份有限公司 42 / 111 MC25 GNSS 协议规范 3.5.1.5. SDBP-CFG-DYNAMIC (0x03 0x31) 该命令用于配置运行模式，若该命令有效并成功执行，则返回 SDBP-PUB-ACK。否则返回 SDBP-PUBNACK。当运行模式发生改变时，模块会自动重启。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x31 数据长度 2 数据 请参考表 15。 校验和 - 表 15：SDBP-CFG-DYNAMIC 数据内容 序号 类型 名称 1 I8U 运行模式 2 I8U 自动保存 描述 1 自适应模式：最高速度 340 米/秒，最高海拔 15000 米，最大加速度 2 g。 2 静态模式：最高速度 5 米/秒，最高海拔 15000 米。 3 行走模式：最高速度 10 米/秒，最高海拔 15000 米。 4 汽车模式：最高速度 150 米/秒，最高海拔 15000 米。 5 船舶模式：最高航速 50 米/秒，最高海拔 1000 米。 1 保存到备份区 其他值 不保存，上电后恢复默认值 备注 1. 自适应模式涵盖静态、行走和汽车模式。如果使用船舶模式，则必须独立配置。 2. 根据相应的使用情况设置正确的模式，可有效提高定位精度。 3.5.1.6.SDBP-CFG-FIX (0x03 0x32) 该命令用于配置定位模式。若该命令有效并成功执行，则返回 SDBP-PUB-ACK。否则返回 SDBPPUB-NACK。 上海移远通信技术股份有限公司 43 / 111 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x32 数据长度 11 MC25 GNSS 协议规范 数据 请参考表 16。 校验和 - 表 16：SDBP-CFG-FIX 数据内容 序号 类型 名称 1 I8U 定位模式 2 I8U 首次定位模式 3 I32S 4 I32U 5 I8U 参考高度 参考高度精度 自动保存 比例 - 10-2 10-4 - 单位 - 米 米 - 描述 1 2D 模式 2 3D 模式 3 2D/3D 自动切换模式 仅当定位模式为 2D/3D 自动切换模式 时有效。 0 2D 模式 1 3D 模式 默认值：0。仅当定位模式为 2D 模式 有效。 方差，默认值：0.0。仅当定位模式 为 2D 模式有效。 1 保存到备份区 其他值 不保存，上电后恢复默认值 3.5.1.7.SDBP-CFG-SV (0x03 0x33) 该命令用于选择定位时使用的卫星。若该命令有效并成功执行，则返回 SDBP-PUB-ACK。否则返回 SDBP-PUB-NACK。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x33 数据长度 4 数据 请参考表 17。 校验和 - 上海移远通信技术股份有限公司 44 / 111 表 17：SDBP-CFG-SV 数据内容 序号 类型 1 I8U 2 I8U 3 I8U 4 I8U 名称 比例 参与定位解决方案的 最大卫星数量 - 参与定位解决方案的 最小卫星仰角 - 参与定位解决方案的 最小信号强度 （C/N0） 自动保存 - MC25 GNSS 协议规范 单位 度 描述 范围：4~20；默认值：20。 范围：0~90；默认值：5。 dB/Hz 范围：0~54；默认值：5。 1 保存到备份区 - 其他值 不保存，上电后恢复默认值 3.5.1.8.SDBP-CFG-INTERVAL (0x03 0x35) 该命令用于配置定位时间间隔。若该命令有效并成功执行，则返回 SDBP-PUB-ACK。否则返回 SDBP-PUB-NACK。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x35 数据长度 3 数据 请参考表 18。 校验和 - 表 18：SDBP-CFG-INTERVAL 数据内容 序号 类型 名称 比例 1 I16U 定位时间间隔 - 2 I8U 自动保存 - 单位 毫秒 - 描述 范围：100~60000；取值为 100 的整 数倍；默认值：1000。 1 保存到备份区 其他值 不保存，上电后恢复默认值 上海移远通信技术股份有限公司 45 / 111 备注 连续定位导航过程如下图所示： MC25 GNSS 协议规范 当第 N 次解析时刻需要的解析时间 TN 大于定位间隔 T 时，系统自动取消从定位时刻 TN+1 到 TN+X 的解析 过程，直到本次解析时间 TN 结束之后，才开始 TN+X+1 定位时刻的解析。因此，当定位时间间隔 T 过短 （即定位频率过高）且解析时间过长（即计算量过大，参与定位的元素过多）时，导航输出间隔将不会 等于设置的定位间隔。如果需要导航输出间隔等于定位间隔，需调整合适的定位间隔 T 或解析时间（可 通过命令 SDBP-CFG-GNSS 减少使用的卫星系统数量，并使用命令 SDBP-CFG-SV 减少定位方案中使 用的卫星数。） 3.5.1.9.SDBP-CFG-PPS (0x03 0x41) 该命令用于配置 PPS。若该命令有效并成功执行，则返回 SDBP-PUB-ACK。否则返回 SDBP-PUBNACK。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x41 数据长度 18 数据 请参考表 19。 校验和 - 表 19：SDBP-CFG-PPS 数据内容 序号 类型 1 I8U 2 I8U 名称 编号 开关 3 I8U 输出模式 比例 - 单位 - 描述 0 PPS0 0 关闭 PPS 1 打开 PPS 0 开机后输出 1 定位后输出 上海移远通信技术股份有限公司 46 / 111 MC25 GNSS 协议规范 4 I8U 5 I8U 6 I32U 7 I32U 8 I32U 9 I8U 脉冲极性 - GNSS 时间标准 - 周期 - 脉冲宽度 - 偏移 - 自动保存 - 毫秒 毫秒 纳秒 - 0 负极 1 正极 0 UTC ≥ 10 毫秒。默认值：1000。 范 围 ： 0~1000 （ 不 包 括 0 和 1000）；默认值：100。 默认值：0。 1 保存到备份区 其他值 不保存，上电后恢复默认值 备注 MC25 固件版本不支持调整 GNSS 时间标准，固定为 UTC。 3.5.1.10. SDBP-CFG-NMEA (0x03 0x51) 该命令用于配置 NMEA 输出语句。若该命令有效并成功执行，则返回 SDBP-PUB-ACK。否则返回 SDBP-PUB-NACK。 类型： 输入。 结构： 头 0x23 0x3E 标识符 0x03 0x51 数据长度 4 数据 请参考表 20。 校验和 - 表 20：SDBP-CFG-NMEA 数据内容 序号 类型 名称 1 I8U 语句 ID 描述 0x01 0x02 0x03 0x04 0x05 ZDA DTM RMC GGA GSA 上海移远通信技术股份有限公司 47 / 111 MC25 GNSS 协议规范 2 I8U 3 I8U 3 I8U 输出串口 输出频率 自动保存 0x06 GSV 0x07 VTG 0x08 GNS 0x09 GLL 0x0A GRS 0x0B GST 0x0C GBS 0x0D TXT 1 UART1 2 UART2 0 禁用输出 N 每定位 N 次，输出一次 （N 的取值范围：1~10） 1 保存到备份区 其他值 不保存，上电后恢复默认值 备注 有关上述语句的详细信息，请参考 NMEA 0183 V4.10。 上海移远通信技术股份有限公司 48 / 111 MC25 GNSS 协议规范 4 CASIC 协议（MC25-MB） 本章介绍 MC25-MB 模块支持的 CASIC 协议。模块使用自定义的标准接口协议（CSIP，CASIC 标准 接口协议）向主机发送数据，数据以异步串行方式传输。 4.1. CASIC 协议结构 起始字符：固定为 0xBA 0xCE 2个字节 1 个字节 1 个字节 长度可变 为4的倍数 4 个字节 Header Len Class ID 校验和计算的范围 Payload Checksum 图 3：CASIC 协议结构 表 21：CASIC 协议结构 字段 描述 Header CASIC 协议的起始部分。2 字节的 16 进制值，恒为 0xBA 和 0xCE。 Payload Len 有效载荷长度（2 个字节）表示有效荷载（字段 5）占用的字节数，不包括消息头、消 息类别、有效载荷长度和校验和长度。该字段是一个无符号短整数。 Message Class 语句类型，即当前语句所属的基本子集。1 字节。 Message ID 语句编号。1 字节。 Payload Checksum 有效载荷，为数据包实际传输的内容。长度可变，为 4 的整倍数。单位：字节。 校验和由 FletCher16 计算。校验范围包括标识符、数据长度和数据。详见第 3.2 章。 上海移远通信技术股份有限公司 49 / 111 MC25 GNSS 协议规范 4.1.1. CASIC 协议数据类型 所有多字节数据都以小端模式保存和传输。数据类型定义如下表所示。 表 22：CASIC 协议数据类型 名称 U1 I1 U2 I2 U4 I4 R4 R8 类型 无符号字符 有符号字符 无符号短整型 有符号短整型 无符号长整型 有符号长整型 IEEE754 单精度 IEEE754 双精度 CH[32] 长度（字节） 1 1 2 2 4 4 4 8 代码 补码 补码 补码 - 4.1.2. 语句概览 表 23：CASIC 语句概览 语句名称 NAV 类 NAV-STATUS NAV-DOP NAV-SOL NAV-PV 标识符 长度 0x01 0x00 80 0x01 0x01 28 0x01 0x02 72 0x01 0x03 80 NAV-IMUATT 0x01 0x06 32 NAV-TIMEUTC 0x01 0x10 24 NAV-CLOCK 0x01 0x11 64 类型 描述 NAV 导航结果 周期 接收机导航状态。 周期 几何精度因子。 周期 精简的 PVT 导航信息。 周期 周期 周期 位置与速度信息。 IMU 坐 标 系 相 对 于 本 地 导 航 坐 标 系 （NED）的姿态。 UTC 时间信息。 周期 时钟解算信息。 上海移远通信技术股份有限公司 50 / 111 MC25 GNSS 协议规范 NAV-GPSINFO 0x01 0x20 NAV-BDSINFO 0x01 0x21 NAV-GLNINFO 0x01 0x22 TIM 类 TIM-TP RXM 类 0x02 0x00 RXM_SENSOR 0x03 0x07 RXM-MEASX 0x03 0x10 RXM-SVPOS ACK 类 0x03 0x11 ACK-NACK 0x05 0x00 ACK-ACK CFG 类 0x05 0x01 CFG-PRT 0x06 0x00 CFG-MSG 0x06 0x01 CFG-RST 0x06 0x02 CFG-TP 0x06 0x03 CFG-RATE 0x06 0x04 CFG-CFG 0x06 0x05 CFG-NAVX 0x06 0x07 CFG-GROUP 0x06 0x08 CFG-INS 0x06 0x10 MSG 类 MSG-BDSUTC 0x08 0x00 MSG-BDSION 0x08 0x01 MSG-BDSEPH 0x08 0x02 8 + 12 × N 8 + 12 × N 8 + 12 × N 24 16 + 16 × N 16 + 32 × N 16 + 48 × N 4 4 0/8 0/4 4 0/16 0/4 4 0/44 0/56 0/4 20 16 92 周期 GPS 卫星信息。 周期 BDS 卫星信息。 周期 GLONASS 卫星信息。 TIM 时间消息 周期 授时脉冲信息。 RXM 接收机测量值信息 周期 传感器信息。 周期 伪距、载波相位原始测量信息。 周期 卫星位置信息。 ACK/NACK 消息 应答消息 回复表示消息未被正确接收。 应答消息 回复表示消息被正确接收。 CFG 输入配置消息 查询/设置 查询/配置 UART 的工作模式。 查询/设置 查询/配置语句发送频率。 设置 重启接收机/清除保存的数据结构。 查询/设置 查询/配置接收机 PPS 的相关参数。 查询/设置 查询/配置接收机的导航速率。 设置 清除、保存和加载配置信息。 查询/设置 查询/专业配置导航引擎参数。 查询/设置 查询/配置 GLONASS 的群延时参数。 查询/设置 查询/配置 INS 安装模式。 MSG 接收机卫星电文信息 周期 接收机输出 BDS 系统 UTC 信息。 周期 接收机输出 BDS 系统电离层信息。 周期 接收机输出 BDS 系统星历信息。 上海移远通信技术股份有限公司 51 / 111 MC25 GNSS 协议规范 MSG-GPSUTC 0x08 0x05 20 MSG-GPSION 0x08 0x06 16 MSG-GPSEPH 0x08 0x07 72 MSG-GLNEPH 0x08 0x08 68 MON 类 MON-VER 0x0A 0x04 64 MON-HW 0x0A 0x09 56 AID 类 AID-INI 0x0B 0x01 56 AID-HUI 0x0B 0x03 60 周期 接收机输出 GPS 系统 UTC 信息。 周期 接收机输出 GPS 系统电离层信息。 周期 接收机输出 GPS 系统星历信息。 周期 接收机输出 GLNASS 系统星历信息。 MON 监视消息 响应查询 输出版本信息。 周期/查询 硬件的各种配置状态。 AID 辅助消息 查询/输入 输入 辅助位置、时间、频率、时钟频偏等信 息。 辅助健康信息、UTC 参数、电离层参 数。 当模块接收到 CFG 类型的消息时，需要根据配置消息正确处理并回复 ACK-ACK 或 ACK-NACK 消 息。在模块回复 ACK 消息之前，主机不能再次发送 CFG 消息，在此期间，模块不会对其他任何命令做响 应。 4.2. CASIC 语句 4.2.1. NAV (0x01) 该语句为导航结果，包括位置、速度、时间、精度、航向、几何精度因子、卫星数等。NAV 消息分为 以下几种类型，每种类型包含不同的信息。 4.2.1.1.NAV-STATUS (0x01 0x00) 该语句用于查询或周期性上报接收机导航状态。 结构： 头 0xBA 0xCE 长度（字节） 80 标识符 0x01 0x00 有效载荷 见下表 校验和 4 字节 上海移远通信技术股份有限公司 52 / 111 MC25 GNSS 协议规范 有效载荷： 字符偏移 0 4 6 7 8 40 64 数据类型 U4 U2 U1 U1 U1*32 U1*24 U1*14 比例缩放 - - - - 名称 runTime fixInterval posValid velValid gpsMsgFlag glnMsgFlag bdsMsgFlag 单位 描述 毫秒 距离开机/复位的运行时间。 毫秒 - - 定位时间间隔。 定位标志。 0 定位无效 1 外部输入位置 2 粗略估计的位置 3 保持上一次的定位位置 4 航位推算 5 快速模式定位 6 2D 定位 7 3D 定位 8 GNSS + DR 组合导航 速度标志。 0 速度无效 1 外部输入的速度 2 粗略估计的速度 3 保持上一次的速度 4 速度推算 5 快速模式的速度 6 2D 速度 7 3D 速度 8 GNSS + DR 组合导航的速度 32 颗 GPS 卫星的历书和星历的电 文有效性标志。高 4 位表示历书的 电文有效性，低 4 位表示星历的电 文有效性。 0 缺失 1 不健康 2 过期 3 有效 24 颗 GLONASS 卫星的历书和星历 的电文有效性标志。高 4 位表示历 书的电文有效性，低 4 位表示星历 的电文有效性。 0 缺失 1 不健康 2 过期 3 有效 14 颗 BDS 卫星的历书和星历的电文 有效性标志。高 4 位表示历书的电 上海移远通信技术股份有限公司 53 / 111 MC25 GNSS 协议规范 文有效性，低 4 位表示星历的电文 有效性。 0 缺失 1 不健康 2 过期 3 有效 GPS 的 UTC 和电离层信息的电文有 效性标志。高 4 位表示 UTC 参数的 电文有效性，低 4 位表示电离层参 数的电文有效性。 78 U1 - gpsUtcionFlag - 0 缺失 1 不健康 2 过期 3 有效 BDS 的 UTC 和电离层信息的电文有 效性标志。高 4 位表示 UTC 参数的 电文有效性，低 4 位表示电离层参 数的电文有效性。 79 U1 - bdsUtcionFlag - 0 缺失 1 不健康 2 过期 3 有效 4.2.1.2.NAV-DOP (0x01 0x01) 该语句用于查询或周期性上报几何精度因子信息。 结构： 头 0xBA 0xCE 长度（字节） 28 标识符 0x01 0x01 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - runTime 4 R4 - pDop 8 R4 - hDop 单位 毫秒 - 描述 距离开机/复位的运行时间。 位置精度因子。 水平精度因子。 上海移远通信技术股份有限公司 54 / 111 MC25 GNSS 协议规范 12 R4 - vDop - 垂直精度因子。 16 R4 - nDop - 北向精度因子。 20 R4 - eDop - 东向精度因子。 24 R4 - tDop - 时间精度因子。 4.2.1.3.NAV-SOL (0x01 0x02) 该语句用于查询或周期性上报 ECEF 坐标系下的 PVT 导航信息。 结构： 头 0xBA 0xCE 长度（字节） 72 标识符 0x01 0x02 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - runTime 4 U1 - posValid 5 U1 - velValid 单位 毫秒 - - 描述 距离开机/复位的运行时间。 定位标志。 0 定位无效 1 外部输入位置 2 粗略估计的位置 3 保持上一次的定位位置 4 航位推算 5 快速模式定位 6 2D 定位 7 3D 定位 8 GNSS + DR 组合导航 速度标志。 0 速度无效 1 外部输入的速度 2 粗略估计的速度 3 保持上一次的速度 4 速度推算 5 快速模式的速度 6 2D 速度 7 3D 速度 上海移远通信技术股份有限公司 55 / 111 6 U1 - 7 U1 - 8 U1 - 9 U1 - 10 U1 - 11 U1 - 12 U2 - 14 U2 - 16 R8 24 R8 - 32 R8 - 40 R8 - 48 R4 - 52 R4 - 56 R4 - 60 R4 - 64 R4 - 68 R4 - MC25 GNSS 协议规范 timeSrc system numSV numSVGPS numSVBDS numSVGLN res week tow ecefX ecefY ecefZ pAcc ecefVX ecefVY ecefVZ sAcc pDop 8 GNSS + DR 组合导航的速度 时间源。 0 GPS 授时（即周内时间和星 期数是从 GPS 卫星中获得的 - 接收机本地时间） 1 BDS 授时 2 GLONASS 授时 接收机的多模接收模式掩码。 Bit 0 = 1 GPS 卫星用于定位 - Bit 1 = 1 BDS 卫星用于定位 Bit 2 = 1 GLONASS 卫星用于定位 - 参与解算的卫星总数。 - 参与解算的 GPS 卫星数目。 - 参与解算的 BDS 卫星数目。 参与解算的 GLONASS 卫星数目。 - 保留。 - 周数。 秒 周内时。 米 ECEF 坐标系中的 X 坐标。 米 ECEF 坐标系中的 Y 坐标。 米 ECEF 坐标系中的 Z 坐标。 平方米 3D 位置的估计精度误差的方差。 米/秒 ECEF 坐标系中的 X 速度。 米/秒 ECEF 坐标系中的 Y 速度。 米/秒 ECEF 坐标系中的 Z 速度。 平方米/秒 3D 速度的估计精度误差的方差。 - 位置精度因子。 上海移远通信技术股份有限公司 56 / 111 MC25 GNSS 协议规范 4.2.1.4.NAV-PV (0x01 0x03) 该语句用于查询或周期性上报大地坐标系下的位置与速度信息。 结构： 头 0xBA 0xCE 长度（字节） 80 标识符 0x01 0x03 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - runTime 单位 毫秒 4 U1 - posValid - 5 U1 - velValid - 6 U1 - system - 7 U1 - numSV - 8 U1 - numSVGPS - 描述 距离开机/复位的运行时间。 定位标志。 0 定位无效 1 外部输入位置 2 粗略估计的位置 3 保持上一次的定位位置 4 航位推算 5 快速模式定位 6 2D 定位 7 3D 定位 8 GNSS + DR 组合导航 速度标志。 0 速度无效 1 外部输入的速度 2 粗略估计的速度 3 保持上一次的速度 4 速度推算 5 快速模式的速度 6 2D 速度 7 3D 速度 8 GNSS + DR 组合导航的速度 接收机的多模接收模式掩码。 Bit 0 = 1 GPS 卫星用于定位 Bit 1 = 1 BDS 卫星用于定位 Bit 2 = 1 GLONASS 卫星用于定位 参与解算的卫星总数。 参与解算的 GPS 卫星数目。 上海移远通信技术股份有限公司 57 / 111 9 U1 - 10 U1 - 11 U1 - 12 R4 - 16 R8 - 24 R8 - 32 R4 - 36 R4 - 40 R4 - 44 R4 - 48 R4 - 52 R4 - 56 R4 - 60 R4 - 64 R4 - 68 R4 - 72 R4 - 76 R4 - MC25 GNSS 协议规范 numSVBDS - numSVGLN - res - pDop - lon 度 lat 度 height 米 sepGeoid 米 hAcc vAcc velN velE velU speed3D speed2D heading sAcc 平方米 平方米 米/秒 米/秒 米/秒 米/秒 米/秒 度 平方米/秒 cAcc 平方度 参与解算的 BDS 卫星数目。 参与解算的 GLONASS 卫星数目。 保留。 位置精度因子。 经度。 纬度。 大地高度（以椭球体为参考）。 高度异常（大地高度与海拔高度的差 值）。 水平位置精度误差的方差。 垂直位置精度误差的方差。 ENU 坐标系中的北向速度。 ENU 坐标系中的东向速度。 ENU 坐标系中的天向速度。 3D 速度。 2D 对地速度。 航向。 对地速度的精度误差的方差。 航向的精度误差的方差（heading 的方 差）。 4.2.1.5.NAV-IMUATT (0x01 0x06) 该语句用于查询或循环上报 IMU 坐标系相对于本地导航坐标系（NED）的姿态。 结构： 头 0xBA 0xCE 长度（字节） 32 标识符 0x01 0x06 有效载荷 见下表 校验和 4 字节 上海移远通信技术股份有限公司 58 / 111 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 0 U4 - rcvTow 秒 4 U2 - wn 周 6 U1 flag - 7 U1 - res - 8 I4 1e-5 roll 度 12 I4 1e-5 pitch 度 16 I4 1e-5 heading 度 20 U4 1e-5 rollAcc 度 24 U4 1e-5 pitchAcc 度 28 U4 1e-5 headingAcc 度 MC25 GNSS 协议规范 描述 接收机 GPS 周内时。接收机时间 尽可能与 GPS 时间系统对准。使 用接收机周内时 rcvTow、接收机 周数 week、闰秒值 leapS 可以将 时间转换到其他时间系统。更多关 于不同时间系统的信息请参考 RINEX 3 文档。当接收机工作在 单 GLONASS 模式，直接用接收 机时间减去闰秒值 leapS 即可得 到 UTC 时间，而无需考虑 recStat 中的标志位是否有效。 接收机 GPS 周数。 姿态可用标志。 0x01 姿态估计有效 0xFF 姿态估计无效 保留。 翻滚角。 俯仰角。 航向角。 翻滚角精度。 俯仰角精度。 航向角精度。 4.2.1.6.NAV-TIMEUTC (0x01 0x10) 该语句用于查询或循环上报 UTC 时间信息。 结构： 头 0xBA 0xCE 长度（字节） 24 标识符 0x01 0x10 有效载荷 见下表 校验和 4 字节 上海移远通信技术股份有限公司 59 / 111 MC25 GNSS 协议规范 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - runTime 4 R4 1/c2 tAcc 8 R4 - msErr 12 U2 - ms 14 U2 - year 16 U1 - month 17 U1 - day 18 U1 - hour 19 U1 - min 20 U1 - sec 21 U1 - valid 22 U1 - timeSrc 23 U1 - dateValid 单位 毫秒 平方秒 毫秒 毫秒 年 月 日 小时 分钟 秒 - - - 描述 距离开机/复位的运行时间。 时间估计精度。 毫秒取整后的残留误差。 UTC 时 间 的 毫 秒 部 分 。 范 围 ： 0~999。 UTC 年。范围：1999~2099。 UTC 月。范围：1~12。 UTC 月内天。范围：1~31。 UTC 天内小时。范围：0~23。 UTC 时内分。范围：0~59。 UTC 分内秒。范围：0~59。 时间有效标志。0 表示无效，1 表 示有效。 Bit 0 UTC 周内时 Bit 1 UTC 周数 Bit 2 UTC 闰秒修正 授时系统标志。 0 GPS 授时 1 BDS 授时 2 GLONASS 授时 日期有效标志。 1 日期无效 2 外部输入日期 3 从卫星得到日期 4 从多颗卫星得到可靠日期 上海移远通信技术股份有限公司 60 / 111 MC25 GNSS 协议规范 4.2.1.7.NAV-CLOCK (0x01 0x11) 该语句用于查询或周期性上报时钟解算信息。 结构： 头 0xBA 0xCE 长度（字节） 64 标识符 0x01 0x11 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 描述 0 U4 - RunTime 毫秒 距离开机/复位的运行时间。 4 R4 1/c freqBias - 时钟漂移（时钟频率偏差）。 8 R4 1/c^2 tAcc 平方秒 时间精度（方差）。 12 R4 1/c^2 fAcc - 频率精度（方差）。 重复部分开始（N = 0 表示 GPS，1 表示 BDS，2 表示 GLONASS） 16 + 16 × N R8 - 24 + 16 × N R4 - 28 + 16 × N U2 - 30 + 16 × N I1 - 31 + 16 × N U1 - tow dtUtc wn leapS valid 毫秒 秒 - 周内时间。 卫星时间与 UTC 时间差的小数秒 部分。 周数。 UTC 跳秒，卫星时间与 UTC 时间 差的整数秒部分。 时间有效性标志。 重复部分结束，N 最大值为（SYSTEM_ALL-1），当前版本其值为 2。 上海移远通信技术股份有限公司 61 / 111 MC25 GNSS 协议规范 4.2.1.8.NAV-GPSINFO (0x01 0x20) 该语句用于查询或循环上报 GPS 卫星信息。 结构： 头 0xBA 0xCE 长度（字节） 8 + 12 × N 标识符 0x01 0x20 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 0 U4 - runTime - 4 U1 - numViewSv - 5 U1 - numFixSv - 6 U1 - system - 7 U1 - res - 重复部分开始（N = numViewSv。范围：0~32。） 8 + 12 × N U1 - chn 9 + 12 × N U1 - svid - 10 + 12 × N U1 - flags - 11 + 12 × N U1 - quality - 描述 距离开机/复位的运行时间。 可见卫星数目。范围：0~32。 用于定位的卫星数目。 系统类型。 0 GPS 1 BDS 2 GLONASS 保留。 通道号。 卫星编号。 卫星状态掩码。 Bit 0 = 1 卫星参与了解算 Bit 1–Bit 3 保留 Bit 4 = 1 卫星预测信息无效 Bit 5 保留 Bit 7:Bit 6 00 = 保留 01 = 卫星的预测信息 基于历书 10 = 保留 信号测量的质量指示。 Bit 0 = 1 表示伪距测量值 prMes 有效 Bit 1 = 1 表示载波相位测 量值 cpMes 有 上海移远通信技术股份有限公司 62 / 111 12 + 12 × N U1 - 13 + 12 × N I1 - 14 + 12 × N I2 - 16 + 12 × N R4 - 重复部分结束 CN0 elev azim prRes MC25 GNSS 协议规范 dB-Hz 度 度 米 Bit 2 = 1 Bit 3 = 1 Bit 4 = 1 Bit 5 = 1 Bit 6、Bit 7 = 1 信号载噪比。 效 表示半周模糊度 有效（倒 π 修 正有效） 表示半周模糊度 从载波相位测量 值中减去 保留 表示载波频率有 效 保留 卫星仰角。范围：-90~90。 卫星方位角。范围：0~360。 伪距残差。 4.2.1.9.NAV-BDSINFO (0x01 0x21) 该语句用于查询或周期性上报 BDS 卫星信息。 结构： 头 0xBA 0xCE 长度（字节） 8 + 12 × N 标识符 0x01 0x21 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 0 U4 - runTime - 4 U1 - numViewSv - 5 U1 - numFixSv - 6 U1 - system - 描述 距离开机/复位的运行时间。 可见卫星数目。范围：0~32。 用于定位的卫星数目。 系统类型。 0 GPS 1 BDS 上海移远通信技术股份有限公司 63 / 111 7 U1 - res 重复部分开始（N = numViewSv。范围：0~32。） 8 + 12 × N U1 - chn 9 + 12 × N U1 - svid 10 + 12 × N U1 - flags 11 + 12 × N U1 - quality 12 + 12 × N U1 - 13 + 12 × N I1 - 14 + 12 × N I2 - 16 + 12 × N R4 - 重复部分结束 CN0 elev azim prRes MC25 GNSS 协议规范 2 GLONASS - 保留。 - - dB-Hz 度 度 米 通道号。 卫星编号。 卫星状态掩码。 Bit 0 卫星参与了解算 Bit 1–Bit 3 保留 Bit 4 卫星预测信息无效 Bit 5 保留 Bit 7:Bit 6 00 = 保留 01 = 卫星的预测信 息基于历书 10 = 保留 信号测量的质量指示。 Bit 0 = 1 表示伪距测量值 prMes 有效 Bit 1 = 1 表示载波相位测 量值 cpMes 有 效 Bit 2 = 1 表示半周模糊度 有效（倒 π 修 正有效） Bit 3 = 1 表示半周模糊度 从载波相位测量 值中减去 Bit 4 = 1 保留 Bit 5 = 1 表示载波频率有 效 Bit 6、Bit 7 = 1 保留 信号载噪比。 卫星仰角。范围：-90~90。 卫星方位角。范围：0~360。 伪距残差。 上海移远通信技术股份有限公司 64 / 111 MC25 GNSS 协议规范 4.2.1.10. NAV-GLNINFO (0x01 0x22) 该语句用于查询或循环上报 GLONASS 卫星信息。 结构： 头 0xBA 0xCE 长度（字节） 8 + 12 × N 标识符 0x01 0x22 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 0 U4 - runTime - 4 U1 - numViewSv - 5 U1 - numFixSv - 6 U1 - system - 7 U1 - res - 重复部分开始（N = numViewSv。范围：0~32。） 8 + 12 × N U1 - chn 9 + 12 × N U1 - svid - 10 + 12 × N U1 - flags - 11 + 12 × N U1 - quality - 描述 距离开机/复位的运行时间。 可见卫星数目。范围：0~32。 用于定位的卫星数目。 系统类型。 0 GPS 1 BDS 2 GLONASS 保留。 通道号。 卫星编号。 卫星状态掩码。 Bit 0 卫星参与了解算 Bit 1–Bit 3 保留 Bit 4 卫星预测信息无效 Bit 5 保留 Bit 7:Bit 6 00 = 保留 01 = 卫星的预测信 息基于历书 10 = 保留 信号测量的质量指示。 Bit 0 = 1 表示伪距测量值 prMes 有效 Bit 1 = 1 表示载波相位测 量值 cpMes 有 上海移远通信技术股份有限公司 65 / 111 12 + 12 × N U1 - 13 + 12 × N I1 - 14 + 12 × N I2 - 16 + 12 × N R4 - 重复部分结束 CN0 elev azim prRes MC25 GNSS 协议规范 dB-Hz 度 度 米 Bit 2 = 1 Bit 3 = 1 Bit 4 = 1 Bit 5 = 1 Bit 6、Bit 7 = 1 信号载噪比。 效 表示半周模糊度 有效（倒 π 修 正有效） 表示半周模糊度 从载波相位测量 值中减去 保留 表示载波频率有 效 保留 卫星仰角。范围：-90~90。 卫星方位角。范围：0~360。 伪距残差。 4.2.2. TIM (0x02) 4.2.2.1.TIM-TP (0x02 0x00) 该语句用于查询或循环上报授时脉冲信息。 结构： 头 0xBA 0xCE 长度（字节） 24 标识符 0x02 0x00 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 0 4 8 16 数据类型 比例缩放 U4 - R4 - R8 - U2 - 名称 runTime qErr tow wn 单位 毫秒 秒 秒 - 描述 距离开机/复位的运行时间。 下一个时间脉冲对应的时间量化误差。 下一个时间脉冲对应的周内时间。 下一个时间脉冲对应的周数。 上海移远通信技术股份有限公司 66 / 111 18 U1 - 19 U1 - 20 U4 - refTime - utcValid - res - MC25 GNSS 协议规范 授时脉冲参考时间。 Bit 3:Bit 0 0：GPS 时间源 1：BDS 时间源 2：GLONASS 时间源 Bit 7:Bit 4 0：时间基准为 UTC 1：时间基准为 GNSS （具体系统参考 Bit 3:Bit 0 取值） 有效标志。 0 缺失 1 保留 2 过期 3 有效 保留。 4.2.3. RXM (0x03) 4.2.3.1.RXM-SENSOR (0x03 0x07) 该语句用于查询或周期性上报传感器信息。 结构： 头 0xBA 0xCE 长度（字节） 16 + 16 × N 标识符 0x03 0x07 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 R8 - rcvTow 单位 秒 描述 接收机 GPS 周内时。接收机时间 尽可能与 GPS 时间系统对准。使 用接收机周内时 rcvTow、接收机 周数 week、闰秒值 leapS 可以将 时间转换到其他时间系统。更多关 于不同时间系统的信息请参考 RINEX 3 文档。当接收机工作在 单 GLONASS 模式，直接用接收 机时间减去闰秒值 leapS 即可得 到 UTC 时间，而无需考虑 recStat 中的标志位是否有效。 上海移远通信技术股份有限公司 67 / 111 MC25 GNSS 协议规范 8 I2 - wn 周 接收机 GPS 周数。 10 I1 - leapS 秒 当前 GPS 系统时闰秒时间。 测量值组数。由 CFG-MSG 语句 配置，numMeas 与 CFG-MSG 中 的 rate 相关。当 rate = 0 时， RXM-SENSOR 不输出。 当 rate ≠ 0 时：rate 取值为 1、 11 U1 - numMeas - 2、5、10、25、50 中任一值时， numMeas = rate；rate 取其他非 0 值 时 ， numMeas = 50 。 RXM_SENSOR 语句若输出，则 每秒输出一次。 12 U1 - recStat - 接收机状态。 系统时间。 13 U1 - timeSrc - 0 GPS 时间 1 BDS 时间 14 U1 - rcvrId - 0。 15 U1 - res - 保留。 重复部分开始（N = numMeas，可为离散数值 1、2、5、10、25、50） 16 + 16 × N I2 18 + 16 × N I2 20 + 16 × N I2 22 + 16 × N I2 24 + 16 × N I2 26 + 16 × N I2 1g/16384 accX 1g/16384 accY 1g/16384 accZ 250/32768 gyroX 250/32768 gyroY 250/32768 gyroZ m/s2 m/s2 m/s2 deg/s deg/s deg/s 加速度计 X 轴测量值。加速度计 量程为-2g ~ +2g。 加速度计 Y 轴测量值。加速度计 量程为-2g ~ +2g。 加速度计 Z 轴测量值。加速度计 量程为-2g ~ +2g。 陀螺仪 X 轴测量值。陀螺仪量程 为-250 deg/s ~ +250 deg/s。 陀螺仪 Y 轴测量值。陀螺仪量程 为-250 deg/s ~ +250 deg/s。 陀螺仪 Z 轴测量值。陀螺仪量程 为-250 deg/s ~ +250 deg/s。 28 + 16 × N I2 1/326.8 temp °C 温度计测量值。 30 + 16 × N I2 - res - 保留。 重复部分结束 上海移远通信技术股份有限公司 68 / 111 MC25 GNSS 协议规范 4.2.3.2.RXM-MEASX (0x03 0x10) 该语句用于查询或周期性上报伪距、载波相位原始测量信息。 结构： 头 0xBA 0xCE 长度（字节） 16 + 32 × N 标识符 0x03 0x10 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 0 R8 - rcvTow 秒 8 I2 - wn 周 10 I1 - leapS 秒 11 U1 - numMeas - 12 U1 - recStat - 13 U1 - res1 - 14 U1 - res2 - 15 U1 - res3 - 描述 接收机 GPS 周内时。接收机时间 尽可能与 GPS 时间系统对准。使 用接收机周内时 rcvTow、接收机 周数 week、闰秒值 leapS 可以将 时间转换到其他时间系统。更多关 于不同时间系统的信息请参考 RINEX 3 文档。当接收机工作在 单 GLONASS 模式，直接用接收 机时间减去闰秒值 leapS 即可得 到 UTC 时间，而无需考虑 recStat 中的标志位是否有效。 接收机 GPS 周数。 UTC 闰秒值。 GPS 时与 UTC 时之间的闰秒值， 该值是接收机所能知道的最新的 值。recStat 中的标志位指示该值 是否有效。 测量值组数。范围：0~32。 接收机状态。 Bit 0 = 1 表示闰秒值 leapS 有效 （UTC 修正参数有效） Bit 1 = 1 表示发生时钟重置，接收 机时间发生整数毫秒的跳 变。 保留。 保留。 保留。 上海移远通信技术股份有限公司 69 / 111 MC25 GNSS 协议规范 重复部分开始（N = numMeas。范围：0~32。） 16 + 32 × N R8 - prMes 24 + 32 × N R8 - 32 + 32 × N R4 - 36 + 32 × N U1 - 37 + 32 × N U1 - 38 + 32 × N U1 - 39 + 32 × N U1 - 40 + 32 × N U2 - 42 + 32 × N U1 - 43 + 32 × N U1 - 44 + 32 × N U1 - 45 + 32 × N U1 - cpMes doMes gnssid svid res4 freqid locktime cn0 res5 res6 res7 46 + 32 × N U1 - trkStat 47 + 32 × N U1 - res8 重复部分结束 米 周 Hz 毫秒 dB-Hz - - - 伪距测量值，对于 GLONASS 的 频率间偏差，接收机通过内置的修 正表予以补偿。 载波相位测量值。使用一个近似值 初始化载波相位的初始整周模糊 度，从而使载波相位测量值接近伪 距测量值。时钟重置机制同时作用 于伪距测量值和载波相位测量值， 符合 RINEX 3 的规定。 多普勒测量值，接近的卫星多普勒 为正值。 系统类型。 0 GPS 1 BDS 2 GLONASS 卫星编号。 保留。 频率号（偏移量为 8 bits），仅对 GLONASS 有效。范围：1~14， 对应频率：-7~6。 载波相位锁定时间，最大值为 65535。 载噪比。 保留。 保留。 保留。 卫星跟踪状态。 Bit 0 = 1 表 示 伪距 测 量值 prMes 有效 Bit 1 = 1 表示载波相位测量值 cpMes 有效 Bit 2 = 1 表示半周模糊度有效（倒 π 修正有效） Bit 3 = 1 表示半周模糊度从载波相 位测量值中减去了 保留。 上海移远通信技术股份有限公司 70 / 111 MC25 GNSS 协议规范 4.2.3.3.RXM-SVPOS (0x03 0x11) 该语句用于查询或周期性上报卫星位置信息。 结构： 头 0xBA 0xCE 长度（字节） 16 + 48 × N 标识符 0x03 0x11 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 0 R8 - rcvTow 秒 8 I2 - wn 10 U1 - numMeas 11 U1 - res1 12 I4 - res2 重复部分开始（N = numMeas。范围：0~32。） 16 + 48 × N R8 - x 24 + 48 × N R8 - x 32 + 48 × N R8 - y 40 + 48 × N R4 - z 44 + 48 × N R4 - svdt 48 + 48 × N R4 - tropDelay 周 - 米 米 米 米 米/秒 秒 描述 接收机 GPS 周内时。接收机时间 尽可能与 GPS 时间系统对准。使 用接收机周内时 rcvTow、接收机 周数 week、闰秒值 leapS 可以将 时间转换到其他时间系统。更多关 于不同时间系统的信息请参考 RINEX 3 文档。当接收机工作在 单 GLONASS 模式，直接用接收 机时间减去闰秒值 leapS 即可得 到 UTC 时间，而无需考虑 recStat 中的标志位是否有效。 接收机 GPS 周数。 测量值数目。范围：0~32。 保留。 保留。 卫星坐标。 卫星坐标。 卫星坐标。 卫星钟差。 卫星频率偏差。 对流层延迟。 上海移远通信技术股份有限公司 71 / 111 52 + 48 × N R4 - 56 + 48 × N U1 - 57 + 48 × N U1 - 58 + 48 × N U1 - 59 + 48 × N U1 - 60 + 48 × N U4 - 重复部分结束 ionoDelay 秒 svid - glnFreqid - gnssid - res3 - res4 - MC25 GNSS 协议规范 电离层延迟。 卫星编号。 频 率 号 （ 偏 移 量 8 ）， 对 GLONASS 有效。 系统类型。 0 GPS 1 BDS 2 GLONASS 保留。 保留。 4.2.4. ACK (0x05) 4.2.4.1.ACK-NACK (0x05 0x00) 该语句为信息响应语句，主要用于回应未正确接收的信息。 结构： 头 0xBA 0xCE 长度（字节） 4 标识符 0x05 0x00 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 0 1 2 数据类型 U1 U1 U2 比例缩放 - 名称 clsID msgID res 单位 描述 - 未正确接收信息的类型。 - 未正确接收信息的编号。 - 保留。 上海移远通信技术股份有限公司 72 / 111 MC25 GNSS 协议规范 4.2.4.2.ACK-ACK (0x05 0x01) 该语句为消息响应语句，主要用于回应正确接收的信息。 结构： 头 0xBA 0xCE 长度（字节） 标识符 4 0x05 0x01 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 0 1 2 数据类型 U1 U1 U2 比例缩放 - 名称 clsID msgID res 单位 描述 - 正确接收信息的类型。 - 正确接收信息的编号。 - 保留。 4.2.5. CFG (0x06) 该语句为配置语句，包括设置动态模式、波特率等。当有效长度为 0 时，表示查询配置信息，系统将 输出具有相同标识符的数据。 4.2.5.1.CFG-PRT (0x06 0x00) 该语句用于查询或配置 UART 的工作模式。 结构： ⚫ 该语句用于查询时： 头 长度（字节） 0xBA 0xCE 0 标识符 0x06 0x00 有效载荷 0 ⚫ 该语句用于配置时： 头 长度（字节） 0xBA 0xCE 8 标识符 0x06 0x00 有效载荷 见下表 校验和 4 字节 校验和 4 字节 上海移远通信技术股份有限公司 73 / 111 MC25 GNSS 协议规范 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U1 - portID 1 U1 - protoMask 2 U2 - mode 4 U4 - baudRate 单位 - - bps 描述 串口 ID。例如，0 表示 UART0；0xFF 表示 当前连接的 UART。 协议控制掩码。每个端口均同时支持多个协 议，若相应的 Bit 为 1 则表示启用该协议。 Bit 0 = 1 二进制协议输入 Bit 1 = 1 文本协议输入 Bit 4 = 1 二进制协议输出 Bit 5 = 1 文本协议输出 UART 工作模式掩码。详情请参考表 24。 波特率 表 24：UART 工作模式掩码 掩码 值 - 11 [11:9] 10x - 001 - 000 - x1x [13:12] 00 - 01 - 10 - 11 描述 8 bits 无校验（x = 0 或 1） 奇校验 偶校验 保留（x = 0 或 1） 1 个停止位 1.5 个停止位 2 个停止位 保留 上海移远通信技术股份有限公司 74 / 111 MC25 GNSS 协议规范 4.2.5.2.CFG-MSG (0x06 0x01) 该语句用于查询和配置 NMEA 语句发送的频率。 结构： ⚫ 该语句用于查询时： 头 长度（字节） 0xBA 0xCE 0 标识符 0x06 0x01 ⚫ 该语句用于配置时： 头 长度（字节） 0xBA 0xCE 4 标识符 0x06 0x01 有效载荷 0 校验和 4 字节 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 0 U1 - 1 U1 - 2 U2 - 名称 clsID msgID rate 单位 描述 - 信息类型 - 信息编号 信息发送频率。 0 不输出 1 每次定位，输出一次 2 两次定位，输出一次 N N 次定位，输出一次；特别当 - clsID = 0x03,msgID = 0x07， rate 表示所配置的 RXM-SENSOR 语句中传感器 输出每秒的测量值组数。 0xFFFF 立即输出一次，相当于查询输出 上海移远通信技术股份有限公司 75 / 111 MC25 GNSS 协议规范 4.2.5.3.CFG-RST（0x06 0x02） 该语句用于重启接收机或者清除保存的数据结构。 结构： 头 0xBA 0xCE 长度（字节） 标识符 4 0x06 0x02 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 0 U2 2 U1 3 U1 比例缩放 名称 单位 - navBbrMask - - resetMode - - startMode - 描述 清除由电池供电的 RAM。若相应的 Bit 为 1，则表示清除该位表示的数据。 Bit 0 星历 Bit 1 历书 Bit 2 健康信息 Bit 3 电离层参数 Bit 4 接收机定位信息 Bit 5 时钟漂移（时钟频偏） Bit 6 晶振参数 Bit 7 UTC 修正参数 Bit 8 RTC Bit 9 配置信息 复位模式。 0 立即硬件复位（通过看门狗定时器） 实现） 1 受控软件复位 2 受控软件复位（仅 GPS） 4 关机后硬件复位（通过看门狗定时器 实现） 启动模式。 0 热启动 1 温启动 2 冷启动 3 出厂启动 上海移远通信技术股份有限公司 76 / 111 MC25 GNSS 协议规范 4.2.5.4.CFG-TP (0x06 0x03) 该语句用于查询或配置时间脉冲参数。 结构： ⚫ 该语句用于查询时： 头 长度（字节） 标识符 0xBA 0xCE 0 0x06 0x03 ⚫ 该语句用于配置时： 头 长度（字节） 标识符 0xBA 0xCE 16 0x06 0x03 有效载荷 0 有效载荷 见下表 校验和 4 字节 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - 4 U4 - interval width 单位 微秒 微秒 8 U1 - enable - 9 U1 - 10 U1 - 11 U1 - polar - timeRef - timeSource - 描述 脉冲之间的时间间隔（脉冲周期）。 脉冲宽度。 使能标志。 0 关闭脉冲 1 使能脉冲 2 脉冲使能，并持续输出（当无法 正常定位时，自动维持脉冲更新 率） 3 在正常定位时输出脉冲（当接收 机无法正常定位时，不输出脉 冲） 脉冲极性配置。 0 上升边沿 1 下降边沿 参考时间。 0 UTC 时间 1 卫星时间 时间源。 0 强制单 GPS 授时 1 强制单 BDS 授时 2 强制单 GLONASS 授时 上海移远通信技术股份有限公司 77 / 111 12 R4 - userDelay 秒 MC25 GNSS 协议规范 3 4 5 6 7 其他 保留 主用 BDS，当 BDS 不可用 时可自动切换到其它授时系 统 主用 GPS，当 GPS 不可用 时可自动切换到其它授时系 统 主用 GLONASS，当 GLONASS 不可用时可自动 切换到其它授时系统 保留 自动选择授时系统 用户时间延时。 4.2.5.5.CFG-RATE（0x06 0x04） 该语句用于查询和配置接收机的定位速率。 结构： ⚫ 该语句用于查询时： 头 长度（字节） 0xBA 0xCE 0 ⚫ 该语句用于配置时： 头 长度（字节） 0xBA 0xCE 4 标识符 0x06 0x04 标识符 0x06 0x04 有效载荷 0 有效载荷 见下表 校验和 4 字节 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U2 - interval 2 U2 - Res 单位 描述 毫秒 两次定位间的间隔时间。 - 保留 上海移远通信技术股份有限公司 78 / 111 MC25 GNSS 协议规范 备注 接收机支持不同的定位速率（默认速率为每秒一次更新）。定位速率会直接影响功耗，速率越快，CPU 和通信负担就越大。 4.2.5.6.CFG-CFG (0x06 0x05) 该语句用于清除、保存和加载配置信息。 结构： 头 0xBA 0xCE 长度（字节） 标识符 4 0x06 0x05 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U2 - mask 2 U1 - mode 3 U1 - res 有效载荷 见下表 校验和 4 字节 单位 - - 描述 配置信息的掩码。 Bit 0 UART 工作模式（CFG-PRT） Bit 1 NMEA 语句发送频率（CFG-MSG） Bit 3 导航/定位速率和 PPS 授时模式 （CFG-RATE、CFG-TMODE） Bit 4 时间脉冲参数（CFG-TP） Bit 5 群延时参数（CFG-GROUP） 对配置信息的操作模式。 0 清除永久配置 1 保存当前配置到永久配置 2 永久配置载入到当前配置 保留。 上海移远通信技术股份有限公司 79 / 111 MC25 GNSS 协议规范 4.2.5.7.CFG-NAVX (0x06 0x07) 该语句用于查询或专业配置导航引擎参数。 结构： ⚫ 该语句用于查询时： 头 长度（字节） 标识符 0xBA 0xCE 0 0x06 0x07 ⚫ 该语句用于配置时： 头 长度（字节） 标识符 0xBA 0xCE 44 0x06 0x07 有效载荷 0 有效载荷 见下表 校验和 4 字节 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - mask 4 U1 - dyModel 单位 - 描述 参数掩码，只有相应的 Bit 设置为 1， 参数设置才应用。 Bit 0 应用动态模式设置 Bit 1 应用定位模式设置 Bit 2 应用最大/最小导航卫星个数 设置 Bit 3 应用最小信噪比设置 Bit 4 保留 Bit 5 应用初始定位 3D 设置 Bit 6 应用最小仰角设置 Bit 7 应用 DR 限制设置 Bit 8 应用导航系统使能 Bit 9 应用 GPS 星期翻转设置 Bit 10 应用高度辅助 Bit 11 应用位置精度因子限制 Bit 12 应用时间精度因子限制 Bit 13 应用静态保持设置 动态模式。 0 便携模式 1 静止模式 2 步行模式 3 车载模式 上海移远通信技术股份有限公司 80 / 111 MC25 GNSS 协议规范 4 航海模式 5 飞行模式加速度< 1g 6 飞行模式加速度< 2g 7 飞行模式加速度< 4g 定位模式。 0 保留 5 U1 - fixMode - 1 2D 定位 2 3D 定位 3 2D/3D 定位自动切换 6 U1 - minSVs - 用于定位的最小卫星数。 7 U1 - maxSVs - 用于定位的最大卫星数。 8 U1 - minCNO dB-Hz 用于定位的最小卫星信号载噪比。 9 U1 - res1 - 保留。 是否要求首次定位必须为 3D 定位。 10 U1 - iniFix3D - 0 否 1 是 11 I1 - minElev 度 用于定位的 GNSS 卫星最小仰角。 12 U1 - drLimit 秒 没有卫星信号的最大 DR 时间。 导航系统使能标志。 Bit 0 = 1 GPS 13 U1 - navSystem - Bit 1 = 1 BDS Bit 2 = 1 GLONASS GPS 星期翻转数。接收机输出的 GPS 的周数的有效范围是在此数据的前后各 14 U2 - wnRollOver - 512 周内有效。举例：wnRollOver = 2021，那么接收机输出的 GPS 周数有 效范围是 1509~2533。 16 R4 - fixedAlt 米 2D 定位时的固定高度。 20 R4 - fixedAltVar 平方米 2D 定位时的固定高度误差。 24 R4 - pDop - 位置精度因子最大值。 28 R4 - tDop - 时间精度因子最大值。 32 R4 - pAcc 平方米 位置精度最大值。 36 R4 - tAcc 平方米 时间精度最大值。 40 R4 - staticHoldTh 米/秒 保持静止阈值。 上海移远通信技术股份有限公司 81 / 111 MC25 GNSS 协议规范 4.2.5.8.CFG-GROUP (0x06 0x08) 该语句用于查询或配置 GLONASS 的群延时参数。 结构： ⚫ 该语句用于查询时： 头 长度（字节） 标识符 0xBA 0xCE 0 0x06 0x08 有效载荷 0 ⚫ 该语句用于配置时： 头 长度（字节） 标识符 0xBA 0xCE 56 0x06 0x08 有效载荷 见下表 校验和 4 字节 校验和 4 字节 有效载荷： 字符偏移 0 数据类型 比例缩放 名称 R4[14] - groupDealy 单位 描述 秒 GLONASS 各个频率对应的群延时，用距 离表征（群延时时间乘以光速得到距离）。 4.2.5.9.CFG-INS (0x06 0x10) 该语句用于查询或配置 INS 安装模式。 结构： ⚫ 该语句用于查询时： 头 长度（字节） 标识符 0xBA 0xCE 0 0x06 0x10 ⚫ 该语句用于配置时： 头 长度（字节） 标识符 0xBA 0xCE 4 0x06 0x10 有效载荷 0 有效载荷 见下表 校验和 4 字节 校验和 4 字节 上海移远通信技术股份有限公司 82 / 111 MC25 GNSS 协议规范 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - attMode 2 U2 - ramStart 单位 - 描述 模块相对于车辆相对安装姿态的模式配 置。 0 模块 X 轴指向车辆前方 1 模块 X 轴指向车辆右方 2 模块 X 轴指向车辆后方 3 模块 X 轴指向车辆左方 0 备份电源上电立即航位推算功能关闭 1 备份电源上电立即航位推算功能开启 4.2.6. MSG (0x08) 该语句为接收机导航语句，语句类型为 0x08。 4.2.6.1.MSG-BDSUTC (0x08 0x00) 该语句用于周期性上报 BDS 系统 UTC 信息（与 UTC 时间同步参数）。 结构： 头 0xBA 0xCE 长度（字节） 标识符 20 0x08 0x00 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 0 4 8 数据类型 U4 I4 I4 比例缩放 名称 - res1 2–30 a0UTC 2–50 a1UTC 12 I1 - dtls 13 I1 - dtlsf 14 U1 - res2 15 U1 - res3 单位 描述 - 保留。 秒 BDS 时间相对于 UTC 的钟差。 秒/秒 BDS 时间相对于 UTC 的钟速。 秒 新闰秒生效前，BDS 时间相对于 UTC 的 累计闰秒改正数。 秒 新闰秒生效后，BDS 时间相对于 UTC 的 累计闰秒改正数。 - 保留。 - 保留。 上海移远通信技术股份有限公司 83 / 111 MC25 GNSS 协议规范 16 U1 - wnlsf 周 新的闰秒生效的周计数。 17 U1 - dn 天 新的闰秒生效的周内日计数。 信息可用标志。 0 无效 18 U1 - valid - 1 不健康 2 过期 3 有效 19 U1 - res4 - 保留。 4.2.6.2.MSG-BDSION (0x08 0x01) 该语句用于周期性上报 BDS 系统电离层信息。 结构： 头 0xBA 0xCE 长度（字节） 标识符 16 0x08 0x01 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 0 U4 - res1 - 4 I1 2-30 alpha0 秒 5 I1 2-27 alpha1 s/π 6 I1 2-24 alpha2 s/π2 7 I1 2-24 alpha3 s/π3 8 I1 211 beta0 秒 9 I1 214 beta1 s/π 10 I1 216 beta2 s/π2 11 I1 216 beta3 s/π3 12 U1 - valid - 描述 保留。 电离层参数。 电离层参数。 电离层参数。 电离层参数。 电离层参数。 电离层参数。 电离层参数。 电离层参数。 信息可用标志。 0 无效 1 不健康 上海移远通信技术股份有限公司 84 / 111 13 U1 - 14 U2 - res2 - res2 - MC25 GNSS 协议规范 2 过期 3 有效 保留。 保留。 4.2.6.3.MSG-BDSEPH (0x08 0x02) 该语句用于周期性上报 BDS 系统星历信息。 结构： 头 0xBA 0xCE 长度（字节） 标识符 92 0x08 0x02 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - res1 4 U4 2-19 sqra 8 U4 2-33 es 12 I4 2-31 ω 16 I4 2-31 M0 20 I4 2-31 i0 24 I4 2-31 Ω0 28 I4 2-43 Ω 32 I2 2-43 Δn 34 I2 2-43 IDOT 36 I4 2-31 cuc 40 I4 2-31 cus 44 I4 2-6 crc 单位 m1/2 π π π π π/s π/s π/s 弧度 弧度 米 描述 保留。 卫星轨道半长轴的平方根。 卫星轨道偏心率。 近地点幅角。 参考时间的平近点角。 参考时间的轨道倾角。 按参考时间计算的升交点赤经。 升交点赤经变化率。 卫星平均运动速率与计算值之差。 轨道倾角变化率。 纬度幅角的余弦调和改正项振幅。 纬度幅角的正弦调和改正项振幅。 轨道半径的余弦调和改正项振幅。 上海移远通信技术股份有限公司 85 / 111 48 I4 2-6 crs 米 52 I4 2-31 cic 弧度 56 I4 2-31 cis 弧度 60 U4 23 toe 秒 64 U2 - wne - 66 U2 - res2 - 68 U4 23 toc 秒 72 I4 2-33 af0 秒 76 I4 2-50 af1 s/s 80 I2 2-66 af2 s/s2 82 I2 0.1 tgd 纳秒 84 U1 - iodc - 85 U1 - iode - 86 U1 - ura - 87 U1 - health - 88 U1 - svid - 89 U1 - valid - 90 U2 - res3 - MC25 GNSS 协议规范 轨道半径的正弦调和改正项振幅。 轨道倾角的余弦调和改正项振幅。 轨道倾角的正弦调和改正项振幅。 星历参考时刻。 参考时间的整周数。 保留。 本时段钟差参数参考时间。 卫星测距码相位时间偏移系数。 卫星测距码相位时间偏移系数。 卫星测距码相位时间偏移系数。 星上设备时延差。 时钟数据龄期。 星历数据龄期。 用户距离精度。 卫星自主健康标识。 卫星编号。 信息可用标志。 0 无效 1 不健康 2 过期 3 有效 保留。 上海移远通信技术股份有限公司 86 / 111 MC25 GNSS 协议规范 4.2.6.4.MSG-GPSUTC (0x08 0x05) 该语句用于周期性上报 GPS 系统 UTC 信息（与 UTC 时间参数同步）。 结构： 头 0xBA 0xCE 长度（字节） 标识符 20 0x08 0x05 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - res1 4 I4 2–30 a0UTC 8 I4 2–50 a1UTC 12 I1 - dtls 13 I1 - dtlsf 14 U1 212 tot 15 U1 - wnt 16 U1 - wnlsf 17 U1 - dn 18 U1 - valid 19 U1 - res2 单位 描述 - 保留。 秒 GPS 时间相对于 UTC 的钟差。 s/s GPS 时间相对于 UTC 的钟速。 秒 新闰秒生效前，GPS 时间相对于 UTC 的 累计闰秒改正数。 秒 新闰秒生效后，GPS 时间相对于 UTC 的 累计闰秒改正数。 秒 UTC 数据的参考时间。 周 UTC 参考星期数。 周 新的闰秒生效的周计数。 天 新的闰秒生效的周内日计数。 信息可用标志。 0 无效 - 1 不健康 2 过期 3 有效 - 保留。 上海移远通信技术股份有限公司 87 / 111 MC25 GNSS 协议规范 4.2.6.5.MSG-GPSION (0x08 0x06) 该语句用于周期性上报 GPS 系统电离层信息。 结构： 头 0xBA 0xCE 长度（字节） 标识符 16 0x08 0x06 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - res1 4 I1 2-30 alpha0 5 I1 2-27 alpha1 6 I1 2-24 alpha2 7 I1 2-24 alpha3 8 I1 211 beta0 9 I1 214 beta1 10 I1 216 beta2 11 I1 216 beta3 12 U1 - valid 13 U1 - res2 14 U2 - res2 单位 描述 - 保留。 秒 电离层参数。 s/π 电离层参数。 s/π2 电离层参数。 s/π3 电离层参数。 秒 电离层参数。 s/π 电离层参数。 s/π2 电离层参数。 s/π3 电离层参数。 信息可用标志。 0 无效 - 1 不健康 2 过期 3 有效 - 保留。 - 保留。 上海移远通信技术股份有限公司 88 / 111 MC25 GNSS 协议规范 4.2.6.6.MSG-GPSEPH (0x08 0x07) 该语句用于循环上报 GPS 系统星历信息。 结构： 头 0xBA 0xCE 长度（字节） 标识符 72 0x08 0x07 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - res1 4 U4 2-19 sqra 8 U4 2-33 es 12 I4 2-31 ω 16 I4 2-31 M0 20 I4 2-31 i0 24 I4 2-31 Ω0 28 I4 2-43 Ω 32 I2 2-43 Δn 34 I2 2-43 IDOT 36 I2 2-29 cuc 38 I2 2-29 cus 40 I2 2-5 crc 42 I2 2-5 crs 44 I2 2-29 cic 46 I2 2-29 cis 48 U2 24 toe 50 U2 - wne 单位 m1/2 π π π π π/s π/s π/s 弧度 弧度 米 米 弧度 弧度 秒 - 描述 保留。 卫星轨道半长轴的平方根。 卫星轨道偏心率。 近地点幅角。 参考时间的平近点角。 参考时间的轨道倾角。 按参考时间计算的升交点赤经。 升交点赤经变化率。 卫星平均运动速率与计算值之差。 轨道倾角变化率。 纬度幅角的余弦调和改正项振幅。 纬度幅角的正弦调和改正项振幅。 轨道半径的余弦调和改正项振幅。 轨道半径的正弦调和改正项振幅。 轨道倾角的余弦调和改正项振幅 轨道倾角的正弦调和改正项振幅。 星历参考时间。 参考时间的整周数。 上海移远通信技术股份有限公司 89 / 111 52 U4 24 toc 秒 56 I4 2-31 af0 秒 60 I2 2-43 af1 s/s 62 I1 2-55 af2 s/s2 63 I1 2-31 tgd 秒 64 U2 - iodc - 66 U1 - ura - 67 U1 - health - 68 U1 - svid - 69 U1 - valid - 70 U2 - res2 - MC25 GNSS 协议规范 本时段钟差参数参考时间。 卫星测距码相位时间偏移系数。 卫星测距码相位时间偏移系数。 卫星测距码相位时间偏移系数。 星上设备时延差。 时钟数据龄期。 用户距离精度。 卫星自主健康标识。 卫星编号。 信息可用标志。 0 无效 1 不健康 2 过期 3 有效 保留。 4.2.6.7.MSG-GLNEPH (0x08 0x08) 该语句用于周期性上报 GLONASS 系统星历信息。 结构： 头 0xBA 0xCE 长度（字节） 标识符 68 0x08 0x08 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 0 U4 - res1 4 I4 2-30 taon 8 I4 2-11 x 12 I4 2-11 y 单位 秒 千米 千米 描述 保留。 第 n 颗卫星相对 GLONASS 时间的修正值。 PZ-90 坐标系中卫星位置坐标。 PZ-90 坐标系中卫星位置坐标。 上海移远通信技术股份有限公司 90 / 111 MC25 GNSS 协议规范 16 I4 2-11 z 千米 PZ-90 坐标系中卫星位置坐标。 20 I4 2-20 dx 千米/秒 PZ-90 坐标系中卫星速度。 24 I4 2-20 dy 千米/秒 PZ-90 坐标系中卫星速度。 28 I4 2-20 dz 千米/秒 PZ-90 坐标系中卫星速度。 32 I4 2-31 taoc 秒 GLONASS 时间相对 UTC 时间标度校正量。 36 I4 2-30 taoGPS 天 从 GLONASS 时间到 GPS 时间的修正量。 40 I2 2-40 gamman - 卫星预测载波频率的相对偏差。 42 U2 - tk - 当前帧的天内时，共 12 位。 44 U2 - nt 天 从上一闰年的 1 月开始计时的当前日期。 46 I1 2-30 ddx km/s2 PZ-90 坐标系中卫星加速度。 47 I1 2-30 ddy km/s2 PZ-90 坐标系中卫星加速度。 48 I1 2-30 ddz km/s2 PZ-90 坐标系中卫星加速度。 49 I1 230 dtaon 秒 第 n 颗卫星 L2 信号和 L1 信号传播时间差。 50 U1 - bn - 健康标志。 51 U1 900 tb 秒 当前时刻（以 UTC+3 为准）的日内时。 52 U1 - M - GLONASS 卫星类别。 53 U1 - P - 控制部分技术参数。 54 U1 - ft - 卫星伪距的预测精确度。 55 U1 - en 天 卫星星历龄期。 56 U1 - p1 - 星历信息更新时间标志位。 57 U1 - p2 - 奇偶标志位。 58 U1 - p3 - 当前帧传递的历书包含卫星数目。 59 U1 - p4 - 星历数据更新标志。例如：1 为已更新。 60 U1 - 61 U1 - 62 U1 - ln - n4 svid - 卫星健康标志（GLONASS-M 型卫星）。 时 间 计数 （从 1996 年开 始 ，以 四 年为 周 期）。 卫星编号。 上海移远通信技术股份有限公司 91 / 111 63 U1 - 64 U1 - 65 U1 - 66 U2 - nl - valid - res2 - res3 - MC25 GNSS 协议规范 频率号。 信息可用标志。 0 无效 1 不健康 2 过期 3 有效 保留。 保留。 4.2.7. MON (0x0A) 该语句为监控语句，包括配置状态、任务状态等信息。 4.2.7.1.MON-HW (0x0A 0x09) 该语句用于查询或周期性上报硬件的各种配置状态，包括天线状态、IO 端口状态、噪声水平、AGC 信息等。 结构： 头 0xBA 0xCE 长度（字节） 标识符 56 0x0A 0x09 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 0 4 8 12 14 16 18 数据类型 U4 U4 U4 U4 U2 U2 U2 比例缩放 - - 名称 单位 描述 noisePerMs0 - DIF0 中频数据的噪声功率。 noisePerMs2 - DIF1 中频数据的噪声功率。 noisePerMs2 - agcData0 - agcData1 - agcData2 - res - DIF2 中频数据的噪声功率。 DIF0 中频数据的幅度位的 1 的数 目。 DIF1 中频数据的幅度位的 1 的数 目。 DIF2 中频数据的幅度位的 1 的数 目。 保留。 上海移远通信技术股份有限公司 92 / 111 MC25 GNSS 协议规范 天线状态。 0 初始化过程 1 未知状态 20 U1 - antStatus - 2 正常 3 短路 4 开路 21 U1 - res - 保留。 22 U1 - res - 保留。 23 U1 - res - 保留。 24 U4[8] 2^24 jamming - 干扰信号的中心频率（归一化）。 4.2.8. AID (0x0B) 该语句为辅助信息，如接收机的初始位置和时间等。 4.2.8.1.AID-INI (0x0B 0x01) 该语句用于查询或输入辅助位置、时间、频率、时钟频偏等信息。 结构： 头 0xBA 0xCE 长度（字节） 标识符 56 0x0B 0x01 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 0 R8 - ecefXOrLat 米或度 8 R8 - ecefYOrLon 米或度 16 R8 - ecefZOrAlt 米 24 R8 - tow 秒 描述 ECEF 坐 标 系 中 的 X 坐 标 或 纬 度：如是 ECEF 坐标系，单位是 米；如果是纬度，单位是度。 ECEF 坐 标 系 中 的 Y 坐 标 或 经 度：如果是 ECEF 坐标系，单位 是米；如果是经度，单位是度。 ECEF 坐 标 系 中 的 Y 坐 标 或 高 度。 GPS 的周内时间。 上海移远通信技术股份有限公司 93 / 111 MC25 GNSS 协议规范 时钟频率漂移。举例：FreqBias = 300 ， 表 示 晶 振 频 偏 1 ppm ； 32 R4 300 freqBias ppm FreqBias = -150，表示晶振频偏 -0.5 ppm。 36 R4 - pAcc 平方米 3D 位置的估计误差的方差 时间的估计误差的方差。举例： 40 R4 C^2 tAcc 平方秒 tAcc = 9 ， 表 示 时 间 误 差 为 sqrt(tAcc) / C = 3 / 3e8 = 10 ns。 时钟频率漂移误差的方差。举例： fAcc = 900 ， 表 示 时 间 误 差 为 44 R4 300^2 fAcc ppm^2 sqrt(fAcc) / 300 = 30 / 300 = 0.1 ppm。 48 U4 - res - 保留。 52 U2 - wn - GPS 的星期号。 54 U1 - timeSource - 时间源。 标志掩码。 Bit 0 = 1 位置有效 Bit 1 = 1 时间有效 Bit 2 = 1 时钟频率漂移数据有效 55 U1 - flags - Bit 3 保留 Bit 4 = 1 时钟频率漂移数据有效 Bit 5 = 1 位置是 LLA 格式 Bit 6 = 1 高度无效 Bit 7 保留 4.2.8.2.AID-HUI (0x0B 0x03) 该语句用于配置导航相关参数，包括辅助健康信息、UTC 参数、电离层参数等。 结构： 头 0xBA 0xCE 长度（字节） 标识符 60 0x0B 0x03 有效载荷 见下表 校验和 4 字节 上海移远通信技术股份有限公司 94 / 111 有效载荷： 字符偏移 数据类型 比例缩放 名称 单位 4 U4 - HeaGps - 8 U4 - HeaBds 12 U4 - HeaGln 16 I4 2-30 utcGpsA0 秒 20 I4 2-50 utcGpsA1 秒/秒 24 I1 - utcGpsLS 秒 25 I1 - utcGpsLSF 秒 26 U1 - utcGpsTow 秒 27 U1 - utcGpsWNT 周 28 U1 - utcGpsWNF 周 29 U1 - utcGpsDN 天 30 I2 - Res - 32 I4 2-30 utcBdsA0 秒 36 I4 2-50 utcBdsA1 秒/秒 40 I1 - utcBdsLS 秒 41 I1 - utcBdsLSF 秒 42 U1 - utcBdsTow 秒 43 U1 - utcBdsWNT 周 44 U1 - utcBdsWNF 周 45 U1 - utcBdsDN 天 MC25 GNSS 协议规范 描述 GPS 卫星的健康信息。Bit 0 表示 第 1 号卫星，依次类推，相应比 特等于 0，表示卫星健康。 BDS 卫星的健康信息。Bit 0 表示 第 1 号卫星，依次类推，相应比 特等于 0，表示卫星健康。 GLONASS 卫星的健康信息。Bit 0 表示第 1 号卫星，依次类推，相 应比特等于 0，表示卫星健康。 UTC 参 数 A0 ， GPS 时 相 对 于 UTC 的钟差。 UTC 参 数 A1 ， GPS 时 相 对 于 UTC 的钟速。 新的跳秒前 GPS 时相对于 UTC 的跳秒。 新的跳秒后 GPS 时相对于 UTC 的跳秒。 GPS 的 UTC 参数的参考星期时 间。 GPS 的 UTC 参数的参考星期号。 GPS 新的跳秒生效的星期号。 GPS 新的跳秒生效的周内天数。 保留。 UTC 参 数 A0 ， BDS 时 相 对 于 UTC 的钟差。 UTC 参 数 A1 ， BDS 时 相 对 于 UTC 的钟速。 新的跳秒前 BDS 时相对于 UTC 的跳秒。 新的跳秒后 BDS 时相对于 UTC 的跳秒。 BDS 的 UTC 参数的参考星期时 间。 BDS 的 UTC 参数的参考星期号。 BDS 新的跳秒生效的星期号。 BDS 新的跳秒生效的周内天数。 上海移远通信技术股份有限公司 95 / 111 MC25 GNSS 协议规范 46 I2 - Res - 保留。 48 I1 2-30 klobA0 s/π Klobuchar 模型参数 alpha0。 49 I1 2-27 klobA1 s/π1 Klobuchar 模型参数 alpha1。 50 I1 2-24 klobA2 s/π2 Klobuchar 模型参数 alpha2。 51 I1 2-24 klobA3 s/π3 Klobuchar 模型参数 alpha3。 52 I1 211 klobB0 s/π Klobuchar 模型参数 beta0。 53 I1 214 klobB1 s/π1 Klobuchar 模型参数 beta1。 54 I1 216 klobB2 s/π2 Klobuchar 模型参数 beta2。 55 I1 216 klobB3 s/π3 Klobuchar 模型参数 beta3。 有效标志掩码。 Bit 0 健康信息有效 56 U4 - flags - Bit 1 UTC 参数有效 Bit 2 电离层参数有效 上海移远通信技术股份有限公司 96 / 111 MC25 GNSS 协议规范 5 GNSS AT 命令 本章主要介绍 GNSS 相关 AT 命令，这些命令用于控制或配置 MC25 模块的内部 GNSS 引擎。以下 命令仅在 All-in-one 应用模式中有效。 5.1. AT 命令说明 5.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 5.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了， 仅显示命令和响应。 表 25：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 97 / 111 MC25 GNSS 协议规范 5.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意 见，也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接 关系或连续性。 5.3. AT 命令详解 5.3.1. AT+QGNSSC 控制 GNSS 引擎 该命令用于控制 GNSS 引擎。 AT+QGNSSC 控制 GNSS 引擎 测试命令 AT+QGNSSC=? 响应 +QGNSSC: (支持的列表) 查询命令 AT+QGNSSC? OK 响应 +QGNSSC: 设置命令 AT+QGNSSC= OK 响应 OK 最大响应时间 特性说明 若出错： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。控制 GNSS 引擎。 0 断电 1 通电 整型。错误码。详情参考第 5.4 章。 上海移远通信技术股份有限公司 98 / 111 举例 AT+QGNSSC? +QGNSSC: 0 OK AT+QGNSSC=1 OK //查询 GNSS 引擎状态。 //GNSS 引擎已断电。 //给 GNSS 引擎上电。 MC25 GNSS 协议规范 5.3.2. AT+QGNSSRD 查询 GNSS 导航信息 该命令可查询 GNSS 导航信息。 AT+QGNSSRD 查询 GNSS 导航信息 测试命令 AT+QGNSSRD=? 响应 +QGNSSRD: (支持的列表) 查询命令 AT+QGNSSRD? OK 响应 +QGNSSRD: (所有支持的信息列表) 设置命令 AT+QGNSSRD= OK 响应 +QGNSSRD: (指定的信息列表) OK 最大响应时间 特性说明 若出错： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。NMEA 语句。 'NMEA/GGA' GGA 语句 'NMEA/GLL' GLL 语句 'NMEA/GSA' GSA 语句 'NMEA/GSV' GSV 语句 'NMEA/RMC' RMC 语句 'NMEA/VTG' VTG 语句 整型。错误码。详情参考第 5.4 章。 上海移远通信技术股份有限公司 99 / 111 MC25 GNSS 协议规范 备注 给 GNSS 引擎通电至少 3 秒后才可执行该命令，否则将返回+CME ERROR: 7103。 举例 AT+QGNSSRD? //查询 GNSS NMEA 语句。 +QGNSSRD: $GNRMC,034035.000,A,3150.8617,N,11711.9038,E,3.02,183.45,240516,,,A*75 $GNVTG,183.45,T,,M,3.02,N,5.59,K,A*20 $GNGGA,034035.000,3150.8617,N,11711.9038,E,1,4,1.50,40.9,M,0.0,M,,*44 $GPGSA,A,3,26,21,,,,,,,,,,,1.75,1.50,0.91*0A $GLGSA,A,3,82,70,,,,,,,,,,,1.75,1.50,0.91*1C $GPGSV,3,1,12,16,67,308,,26,58,021,16,23,40,307,,31,40,088,*7F $GPGSV,3,2,12,08,17,199,,09,14,320,,21,10,086,14,14,10,153,*73 $GPGSV,3,3,12,22,09,226,,193,06,165,,32,03,154,,29,01,034,*45 $GLGSV,3,1,09,81,44,073,,79,40,041,,82,38,145,15,80,36,323,*66 $GLGSV,3,2,09,70,30,290,16,69,26,225,,78,12,078,,88,09,027,*64 $GLGSV,3,3,09,71,05,334,*5B $GNGLL,3150.8617,N,11711.9038,E,034035.000,A,A*4C OK AT+QGNSSRD='NMEA/RMC' //查询 RMC 语句。 +QGNSSRD: $GNRMC,034036.000,A,3150.8612,N,11711.9045,E,2.74,178.00,240516,,,A*7C OK AT+QGNSSRD='NMEA/GSA' //查询 GSA 语句。 +QGNSSRD: $GPGSA,A,3,26,21,,,,,,,,,,,1.76,1.50,0.91*09 $GLGSA,A,3,82,70,,,,,,,,,,,1.75,1.50,0.91*1C OK 5.3.3. AT+QGNSSCMD 向 GNSS 引擎发送命令 该命令用于向 GNSS 引擎发送命令，允许客户选择性地使用某些功能以满足应用需求。 AT+QGNSSCMD 向 GNSS 引擎发送命令 测试命令 AT+QGNSSCMD=? 响应 +QGNSSCMD: (支持的列表), (支持的 列表) 设置命令 AT+QGNSSCMD=, 最大响应时间 特性说明 若出错： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 参数 整型。命令类型。 0 NMEA 格式（ASCII）命令 1 十六进制格式命令 字符串类型。命令字符串。 整型。错误码。详情参考第 5.4 章。 备注 给 GNSS 引擎通电至少 3 秒后才可执行该命令，否则 GNSS 引擎无法接收命令。 5.3.4. AT+QGNSSTS 获取 GNSS 引擎时间同步状态 该命令用于获取模块 GNSS 引擎的时间同步状态。 AT+QGNSSTS 获取 GNSS 引擎时间同步状态 测试命令 AT+QGNSSTS=? 响应 +QGNSSTS: (<支持的列表>) 查询命令 AT+QGNSSTS? OK 响应 +QGNSSTS: OK 最大响应时间 特性说明 若出错： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 101 / 111 MC25 GNSS 协议规范 参数 整型。GNSS 引擎时间同步状态。 0 时间未同步 1 时间同步成功 整型。错误码。详情参考第 5.4 章。 备注 通过 AT+QGNSSTS 查询的时间同步状态将会在下列任何一种情况下更新： ⚫ 时间通过 NITZ 同步。 ⚫ 在 All-in-one 模式中固定 GNSS 时间状态，即手动同步时间。 举例 AT+QGNSSTS=? +QGNSSTS: (0,1) OK AT+QGNSSTS? +QGNSSTS: 1 OK //测试命令。 //查询时间状态同步。 //时间同步成功。 5.3.5. AT+QGAGPS 从服务器中下载 AGPS 数据 该命令用于从 TCP 服务器中下载 AGPS 数据。AGPS 数据将存储在 GSM 部分的 RAM 中，仅在两个 小时内有效，GSM 引擎掉电后数据将会丢失。 AT+QGAGPS 从服务器中下载 AGPS 数据 测试命令 响应 AT+QGAGPS=? OK 设置命令 响应 使用指定的服务器和端口下载 OK AGPS 数据 AT+QGAGPS=,<p +QGAGPS: ort> 若出错： +CME ERROR: 执行命令 响应 使用默认的服务器和端口下载 OK AGPS 数据 AT+QGAGPS +QGAGPS: 上海移远通信技术股份有限公司 102 / 111 MC25 GNSS 协议规范 最大响应时间 特性说明 若出错： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。AGPS 服务器地址。可以是域名或点分十进制 IP 地址。默认服务器地址是 'agnss.techtotop.com'。 整型。AGPS 服务器端口。默认值：9012。 整型。下载结果。 0 下载 AGPS 数据成功 1 创建 socket 失败 2 绑定 socket 失败 3 读取 socket 失败 4 网络出错 5 DNS 错误 6 DNS 超时 7 连接服务器失败 8 连接服务器超时 9 等待数据的时间 10 数据出错 11 服务器地址出错 整型。错误码。详情参考第 5.4 章。 备注 1. 仅 MC25-MA 模块支持该命令。 2. 执行该命令前需激活 PDP 上下文。 上海移远通信技术股份有限公司 103 / 111 5.3.6. AT+QGAGPSAID 注入 AGPS 数据至 GNSS 引擎 该命令用于注入 AGPS 数据至 GNSS 引擎。 AT+QGAGPSAID 注入 AGPS 数据至 GNSS 引擎 执行命令 响应 AT+QGAGPSAID OK 最大响应时间 特性说明 若出错： +CME ERROR: 5秒 / 参数 整型。错误码。详情参考第 5.4 章。 备注 执行该命令前需确保 GNSS 引擎为通电状态。 MC25 GNSS 协议规范 5.3.7. AT+QGREFLOC 为秒定功能设置参考位置信息 该命令用于为秒定功能设置参考位置信息。 AT+QGREFLOC 为秒定功能设置参考位置信息 测试命令 AT+QGREFLOC=? 响应 +QGREFLOC: , 查询命令 AT+QGREFLOC? OK 响应 +QGREFLOC: , 设置命令 AT+QGREFLOC=, OK 响应 OK 若出错： +CME ERROR: 最大响应时间 5 秒 上海移远通信技术股份有限公司 104 / 111 MC25 GNSS 协议规范 特性说明 该命令立即生效； 参数配置不保存。 参数 参考位置的纬度信息。范围：北纬-90°~90°。参数输入格式保留 6 位小数，单 位：度。 参考位置的经度信息。范围：东经-180°~180°。参数输入格式保留 6 位小数， 单位：度。 整型。错误码。详情参考第 5.4 章。 备注 1. 该命令立即将参考位置发送到 GNSS 引擎。 2. 执行该命令前需确保 GNSS 引擎为通电状态。 举例 AT+QGREGLOC=? //测试命令。 +QGREFLOC: , OK AT+QGREFLOC=31.507985,117.119750 OK 5.3.8. AT+QGCFG 配置访问 AGPS 服务器的令牌 该命令用于配置访问 AGPS 服务器的令牌。 AT+ QGCFG 配置访问 AGPS 服务器的令牌 测试命令 AT+QGCFG=? 设置命令 响应 OK 响应 AT+QGCFG='AGPS Token', 查询命令 AT+QGCFG? OK 若出错： +CME ERROR: 响应 OK 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 105 / 111 MC25 GNSS 协议规范 参数 字符串类型。申请访问移远通信 AGPS 服务器所需要的令牌。最大长度：63 字节。 整型。错误码。详情参考第 5.4 章。 备注 仅 MC25-MB 模块支持该命令。 5.3.9. AT+QGHAGPS 从 HTTP 服务器中下载 AGPS 数据 该命令用于从 HTTP 服务器中下载 AGPS 数据。AGPS 数据将存储在 GSM 部分的 RAM 中，仅在两 个小时内有效，GSM 引擎掉电后数据将会丢失。 AT+ QGHAGPS 从 HTTP 服务器中下载 AGPS 数据 测试命令 AT+QGHAGPS=? 响应 +QGHAGPS: ,(支持的范围) 设置命令 AT+QGHAGPS=, OK 响应 OK +QGHAGPS: 最大响应时间 特性说明 若出错： +CME ERROR: 150 秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。AGPS HTTP 服务器的 URL。前缀为'http://'。最大长度为 300 字节。 整型。AGPS HTTP 端口号。范围：1~65535；默认值：80。 整型。下载结果。 0 下载 AGPS 数据成功 1 创建 socket 失败 2 绑定 socket 失败 3 读取 socket 失败 4 网络出错 5 DNS 出错（15 秒） 上海移远通信技术股份有限公司 106 / 111 MC25 GNSS 协议规范 6 DNS 超时（15 秒） 7 连接服务器失败（60 秒） 8 连接服务器超时（60 秒） 9 等待服务器响应超时（30 秒） 10 接收数据失败 11 服务器地址出错 12 账号为空 13 参数为空 14 参数长度出错 15 密码认证失败 16 符号不存在 17 令牌无效 18 服务器响应出错 整型。错误码。详情参考第 5.4 章。 备注 1. 仅 MC25-MB 模块支持该命令。 2. 执行该命令前，需要从移远通信申请令牌，并通过 AT+QGCFG='AGPS Token',将令牌设 置到模块中。 3. 执行该命令前需激活 PDP 上下文。 5.4. 错误码 表 26：+CME ERROR: 错误码 错误码 7101 7102 7103 7105 说明 参数无效 不支持 操作失败 内存不足 上海移远通信技术股份有限公司 107 / 111 MC25 GNSS 协议规范 6 附录 A 参考文档及术语缩写 表 27：参考文档 文档名称 [1] Quectel_MC25_硬件设计手册 表 28：术语缩写 缩写 英文全称 2D 2 Dimensions 3D 3 Dimensions AGC Automatic Gain Control AGPS Assisted Global Positioning System BDS BeiDou Navigation Satellite System CPU Central Processing Unit CS Commercial Sample CSIP CASIC Standard Interface Protocol DFT Default DOP Dilution of Precision DGPS Differential Global Positioning System DIF Differential value DNS Domain Name System DTM NMEA: Datum being used. ECEF Earth-Centered, Earth-Fixed 上海移远通信技术股份有限公司 中文全称 二维 三维 自动增益控制 辅助全球卫星定位系统 北斗卫星导航系统 中央处理器 商业货样 CASIC 标准接口协议 默认 精度因子 差分全球定位系统 差离值 域名系统 NMEA 正在使用的基准。 地心地固坐标系 108 / 111 ENU GGA GLL GLONASS GNSS GPS GSA GSM GSV HDOP HTTP ID IMU INF LLA MP NED NMEA NITZ PDOP PDP PPP PPS PVT QZSS MC25 GNSS 协议规范 Local East, North, Up (ENU) Cartesian Coordinate System Global Positioning System Fix Data 站心坐标系 全球定位系统定位数据 Geographic Position-Latitude and Longitude 地理位置—纬度和经度 Global Navigation Satellite System (Russia) 格洛纳斯导航卫星系统（俄罗斯） Global Navigation Satellite System 全球导航卫星系统 Global Positioning System GPS DOP and Active Satellites Global System for Mobile Communications 全球定位系统 GNSS 精度因子（DOP）与有效卫 星 全球移动通信系统 GNSS Satellites in View 可视的 GNSS 卫星 Horizontal Dilution of Precision 水平精度因子 Hyper Text Transfer Protocol 超文本传输协议 Identifier 标识符 Inertial Measurement Unit 惯性测量单元 Device INFormation File 设备信息文件 Longitude,Latitude and Altitude 维度，经度和高度 Mass Production 批量生产 North East Down 导航坐标系 National Marine Electronics Association 美国国家海洋电子协会 Network Identity and Time Zone 网络标识和时区 Position Dilution of Precision 位置精度因子 Packet Data Protocol 分组数据协议 Pulse Per Second 秒脉冲 Precise Positioning Service 精密定位服务 Position, Velocity and Time 位置，速度和时间 Quasi-Zenith Satellite System 准天顶卫星系统 上海移远通信技术股份有限公司 109 / 111 RAM RMC RTC SBAS SIR SPS UART UTC VDOP VTG WAAS ZDA MC25 GNSS 协议规范 Random Access Memory Recommended Minimum Specific GNSS Data Real_Time Clock Satellite-Based Augmentation System Software Initiated Restart Standard Positioning Service Universal Asynchronous Receiver/Transmitter Universal Time Coordinated Vertical Dilution of Precision Course Over Ground & Ground Speed Wide Area Augmentation System Date and Time 随机存取存储器 推荐的最少专用 GNSS 数据 实时时钟 星基增强系统 软件重启 标准定位服务 通用异步收发传输器 协调世界时 垂直精度因子 对地航向和对地速度 广域增强系统 日期与时间 上海移远通信技术股份有限公司 110 / 111 MC25 GNSS 协议规范 7 附录 B 默认配置 表 29：默认配置 项目 NMEA 端口波特率 参考基准 定位速率 DGPS 模式 SBAS NMEA 标准语句 默认配置 9600 bps WGS84 1 Hz SBAS 启用 RMC、GGA、GSA、GSV、VTG 和 GLL 表 30：GNSS 标识符 卫星系统 系统标识符 GPS 1 GLONASS 2 BDS 4 QZSS 5 SBAS 1 卫星标识号 1-32 65-88 1-63 193-197 33-51 信号标识号 0 0 0 0 0 信号通道 L1 C/A L1 B1 L1 L1 上海移远通信技术股份有限公司 111 / 111

LG69T (AS) GNSS Protocol Specification GNSS Module Series Version: 1.2 Date: 2023-07-28 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LG69T(AS)_GNSS_Protocol_Specification 1 / 24 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. LG69T(AS)_GNSS_Protocol_Specification 2 / 24 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LG69T (AS) GNSS Protocol Specification GNSS Module Series GNSS Protocol Specification Released Revision History Version Date - 2021-07-01 1.0 2022-02-21 1.1 2023-01-09 1.2 2023-07-28 Description Creation of the document First official release 1. Updated PQTMVERNO message (Chapter 2.2.11). 2. Added the PQTMSVINSTATUS and PQTMCFGMSGRATE messages (Chapters 2.2.12 and 2.2.13). 3. Added RTCM-1005 message into supported RTCM3 messages (Table 4). 1. Added the note that most PQTM messages will take effect immediately, and the configuration will not be automatically saved (Chapter 2.2). 2. Added the PQTMCFGSBAS message (Chapter 2.2.14). LG69T(AS)_GNSS_Protocol_Specification 3 / 24 GNSS Module Series Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 2 NMEA Protocol ..................................................................................................................................... 7 2.1. Structure of NMEA Protocol Messages ...................................................................................... 7 2.2. PQTM Messages ........................................................................................................................ 8 2.2.1. PQTMSRR ....................................................................................................................... 8 2.2.2. PQTMCFGPORT ............................................................................................................. 9 2.2.2.1. UART Configuration ( = 0 or 1) .......................................................... 10 2.2.3. PQTMSETRECVMODE ................................................................................................. 10 2.2.4. PQTMGETRECVMODE................................................................................................. 11 2.2.5. PQTMSETMSMMODE................................................................................................... 12 2.2.6. PQTMGETMSMMODE .................................................................................................. 13 2.2.7. PQTMSETCONSTMASK ............................................................................................... 14 2.2.8. PQTMGETCONSTMASK .............................................................................................. 15 2.2.9. PQTMSAVEPAR ............................................................................................................ 15 2.2.10. PQTMRESTOREPAR .................................................................................................... 16 2.2.11. PQTMVERNO ................................................................................................................ 17 2.2.12. PQTMSVINSTATUS....................................................................................................... 17 2.2.13. PQTMCFGMSGRATE.................................................................................................... 18 2.2.14. PQTMCFGSBAS............................................................................................................ 20 3 RTCM Protocol ................................................................................................................................... 22 4 Appendix A References..................................................................................................................... 23 5 Appendix B Special Characters ....................................................................................................... 24 LG69T(AS)_GNSS_Protocol_Specification 4 / 24 GNSS Module Series Table Index Table 1: Supported Protocols ....................................................................................................................... 6 Table 2: Structure of NMEA Protocol Messages .......................................................................................... 7 Table 3: Supported RTCM3 Messages ...................................................................................................... 22 Table 4: Terms and Abbreviations .............................................................................................................. 23 Table 5: Special Characters ....................................................................................................................... 24 LG69T(AS)_GNSS_Protocol_Specification 5 / 24 GNSS Module Series 1 Introduction Quectel LG69T (AS) GNSS module supports GPS, Galileo, BDS and QZSS constellations. Concurrent tracking of GPS L1 C/A, GPS L5, Galileo E1, Galileo E5a, BDS B1, BDS B2a, QZSS L1 and QZSS L5 frequency bands enables fast and accurate acquisition and makes this module an ideal solution for a base station and for generating RTK corrections. This document describes the software commands necessary to control and modify the module configuration. The software commands are NMEA proprietary commands defined by Quectel (PQTM commands). To report GNSS information, the module supports outputting messages in NMEA 0183 protocol and RTCM protocol format. LG69T (AS) GNSS module supports the following protocols: Table 1: Supported Protocols Protocol NMEA 0183 V4.11 RTCM 10403.3 Type Input/output, ASCII, proprietary Output, binary, standard NOTE Quectel assumes no responsibility if commands other than the ones listed herein are used. LG69T(AS)_GNSS_Protocol_Specification 6 / 24 GNSS Module Series 2 NMEA Protocol 2.1. Structure of NMEA Protocol Messages Start of sentence character. Always Address field - contains talker identifier and sentence formatter Starts with a * 8-bit checksum value converted to two ASCII characters Data field(s), delimited by , End of sentence. Always $ () [,] * Range for checksum calculation Figure 1: Structure of NMEA Protocol Messages Table 2: Structure of NMEA Protocol Messages Field Description $ Start of the sentence (Hex 0x24). In Proprietary Messages: In NMEA proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer’s Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. Data fields, delimited by data field delimiter ‘,’. Variable length (depending on the NMEA message type). Checksum field follows the checksum delimiter character *. Checksum is the 8-bit exclusive OR of all characters in the sentence, including ‘,’ field delimiter, between but not including the $ and the * delimiters. End of the sentence (Hex 0x0D 0x0A). LG69T(AS)_GNSS_Protocol_Specification 7 / 24 GNSS Module Series 2.2. PQTM Messages This chapter explains the PQTM messages (proprietary NMEA messages defined by Quectel) supported by LG69T (AS). Table 3: Error Code Field Format Unit Numeric - Description Error code. 1 = Invaild parameters. 2 = Execution failed. NOTE Unless otherwise specified, most PQTM messages mentioned in this document will take effect immediately, and the configuration will not be automatically saved. 2.2.1. PQTMSRR Executes a system reset. Type: Command Synopsis: $PQTMSRR* Parameter: None Result: GNSS firmware is rebooted and no message is sent as a response. Example: $PQTMSRR*4B LG69T(AS)_GNSS_Protocol_Specification 8 / 24 GNSS Module Series 2.2.2. PQTMCFGPORT Sets a communication port or gets a communication port configuration. Type: Set/Get Synopsis: $PQTMCFGPORT,,,{,,,…,}*< LF> Parameter: Field Format Unit Description Decimal, 1 digit - Decimal, 1 digit - Decimal - - - Read or write port configuration: 0 = Read current configuration 1 = Configure the communication port Port type: 0 = UART 1 1 = UART 2 Protocol type: Bit 0 = NMEA command input Bit 1 = NMEA message output Bit 2 = RTCM output content depends on port type (). In case of UART interface, is the baud rate configuration. For more details, see Chapter 2.2.2.1 UART Configuration ( = 0 or 1). NOTE If the default value is not given for any parameter in a Set command, you can query it with the corresponding Get command provided that the default setting has not been changed by Set command. If the default setting had been changed by Set command, contact Quectel Technical Support (support@quectel.com) to get the default setting if necessary. LG69T(AS)_GNSS_Protocol_Specification 9 / 24 GNSS Module Series 2.2.2.1. UART Configuration ( = 0 or 1) Sets the baud rate of UART interface. Type: Set Synopsis: $PQTMCFGPORT,,,{,}* Parameter: Field Format Decimal Unit Description UART port baud rate. Supported baud rates: 115200 bps 230400 460800 921600 Example: //Read UART 1 baud rate: $PQTMCFGPORT,0,0*43 $PQTMPORT,0,0,3,460800*38 //Configure UART 1 baud rate: $PQTMCFGPORT,1,0,1,460800*79 $PQTMCFGPORTOK*47 NOTE If = 0, the parameters after will be omitted. If = 1, the parameters after will be specified. 2.2.3. PQTMSETRECVMODE Sets the receiver mode. The base station must work in static mode. It can enter static mode via Survey-in mode or Fixed mode. Survey-in mode ( = 1) determines the receiver’s position by calculating a weighted mean of all valid 3D position solutions. User can set value to define the minimum observation time regardless of the actual number of fixes used for position estimation. LG69T(AS)_GNSS_Protocol_Specification 10 / 24 GNSS Module Series In Fixed mode ( = 2), the user manually enters receiver position coordinates. Any error in base station position translates directly into rover position error. Type: Set Synopsis: $PQTMSETRECVMODE,,,,,,* Parameter: Field Format Unit Numeric - Numeric Numeric Numeric Numeric Numeric Second Meter Meter Meter Meter Description Receiver mode. 0 = None 1 = Survey-in 2 = Fixed with ECEF coordinate Survey-in minimum duration. Range: 0–60000. Antenna height. Range: 0–6.5535. WGS84 ECEF X coordinate of ARP position. WGS84 ECEF Y coordinate of ARP position. WGS84 ECEF Z coordinate of ARP position. Example: $PQTMSETRECVMODE,1,90,0,0,0,0*63 $PQTMSETRECVMODEOK*5F 2.2.4. PQTMGETRECVMODE Queries receiver mode. Type: Get Synopsis: $PQTMGETRECVMODE* LG69T(AS)_GNSS_Protocol_Specification 11 / 24 GNSS Module Series Parameter: None Result: ⚫ If successful, the module returns: $PQTMRECVMODE,,,,,,* Parameters included in result: Field Format Unit Numeric - Numeric Numeric Numeric Numeric Numeric Second Meter Meter Meter Meter Description Receiver mode. 0 = None 1 = Survey-in 2 = Fixed with ECEF coordinate Survey-in minimum duration. Range: 0–60000. Antenna height. Range: 0–6.5535. WGS84 ECEF X coordinate of ARP position. WGS84 ECEF Y coordinate of ARP position. WGS84 ECEF Z coordinate of ARP position. ⚫ If failed, the module returns: $PQTMRECVMODEERROR*41 Example: $PQTMGETRECVMODE*4F $PQTMRECVMODE,1,90,0.0000,0.0000,0.0000,0.0000*21 2.2.5. PQTMSETMSMMODE Sets the RTCM MSM message type. Type: Set Synopsis: $PQTMSETMSMMODE,* LG69T(AS)_GNSS_Protocol_Specification 12 / 24 GNSS Module Series Parameter: Field Format Numeric Example: $PQTMSETMSMMODE,4*12 $PQTMSETMSMMODEOK*0E Unit Description MSM message type. - 4 = MSM4 7 = MSM7 2.2.6. PQTMGETMSMMODE Queries the RTCM MSM message type. Type: Get Synopsis: $PQTMGETMSMMODE* Parameter: None Result: ⚫ If successful, the module returns: $PQTMMSMMODE,* Parameter included in result: Field Format Numeric Unit Description MSM message type. - 4 = MSM4 7 = MSM7 ⚫ If failed, the module returns: $PQTMGETMSMMODEERROR*46 LG69T(AS)_GNSS_Protocol_Specification 13 / 24 GNSS Module Series Example: $PQTMGETMSMMODE*1E $PQTMMSMMODE,4*50 2.2.7. PQTMSETCONSTMASK Sets the GNSS constellation bit mask. Type: Set Synopsis: $PQTMSETCONSTMASK,* Parameter: Field Format Numeric Unit Description GNSS constellation bit mask. This parameter is in decimal format. Bit 0 = GPS Bit 2 = Galileo Bit 3 = BDS Bit 4 = QZSS Result: ⚫ If successful, the module returns: $PQTMSETCONSTMASKOK*0F ⚫ If failed, the module returns: $PQTMSETCONSTMASKERROR*53 Example: $PQTMSETCONSTMASK,29*2C $PQTMSETCONSTMASKOK*0F LG69T(AS)_GNSS_Protocol_Specification 14 / 24 GNSS Module Series 2.2.8. PQTMGETCONSTMASK Queries the GNSS constellation bit mask. Type: Get Synopsis: $PQTMGETCONSTMASK* Parameter: None Result: ⚫ If successful, the module returns: $PQTMCONSTMASK,* Parameter included in result: Field Format Numeric Unit Description GNSS constellation bit mask. Bit 0 = GPS - Bit 2 = Galileo Bit 3 = BDS Bit 4 = QZSS ⚫ If failed, the module returns: $PQTMGETCONSTMASKERROR*47 Example: $PQTMGETCONSTMASK*1F $PQTMCONSTMASK,29*6E 2.2.9. PQTMSAVEPAR Saves configurations of GNSS commands to NVM. Type: Command LG69T(AS)_GNSS_Protocol_Specification 15 / 24 Synopsis: $PQTMSAVEPAR* Parameter: None Result: ⚫ If successful, the module returns: $PQTMSAVEPAROK*5E ⚫ If failed, the module returns: $PQTMSAVEPARERROR*02 Example: $PQTMSAVEPAR*5A $PQTMSAVEPAROK*5E 2.2.10. PQTMRESTOREPAR Restores all configurations to default values. Type: Command Synopsis: $PQTMRESTOREPAR* Parameter: None Result: ⚫ If successful, the module returns: $PQTMRESTOREPAROK*17 ⚫ If failed, the module returns: $PQTMRESTOREPARERROR*4B LG69T(AS)_GNSS_Protocol_Specification GNSS Module Series 16 / 24 GNSS Module Series Example: $PQTMRESTOREPAR*13 $PQTMRESTOREPAROK*17 2.2.11. PQTMVERNO Queries the firmware version. Type: Command Synopsis: $PQTMVERNO* Parameter: None Result: Firmware version string is returned. Example: $PQTMVERNO*58 $PQTMVERNO,LG69TASNR01A02,2021/12/30,17:38:07*63 2.2.12. PQTMSVINSTATUS Outputs the survey-in status. Type: Output Synopsis: $PQTMSVINSTATUS,,,,,,,,,,,* LG69T(AS)_GNSS_Protocol_Specification 17 / 24 GNSS Module Series Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric - Unit Description Message version. - 1 = Version 1 (Always 1 for this message version.) Millisecond GPS time of week. Survey-in position validity flag. 0 = Invalid 1 = In progress 2 = Valid Reserved. Always 0. Reserved. Always 0. Number of position observations used during survey-in. Second Configuration of duration. Meter Current survey-in mean position ECEF X coordinate. Meter Current survey-in mean position ECEF Y coordinate. Meter Current survey-in mean position ECEF Z coordinate. - Reserved. This field is always empty. Example: $PQTMSVINSTATUS,1,301386000,1,0,0,7,60000,-2472445.1423,4828301.6489,3343727.6841,*24 2.2.13. PQTMCFGMSGRATE Sets/gets the message output rate on the current port. Type: Set/Get Synopsis: //Set the output rate: $PQTMCFGMSGRATE,W,,[,]* //Get the output rate: $PQTMCFGMSGRATE,R,[,]* LG69T(AS)_GNSS_Protocol_Specification 18 / 24 Parameter: Field GNSS Module Series Format String Numeric Numeric Unit Description Message name. This command can only be used to set/get the message output rate listed below. Proprietary NMEA message: PQTMSVINSTATUS - Standard RTCM3 message: RTCM3-1005, RTCM3-1006, RTCM3-1019, RTCM3-1042, RTCM3-1044, RTCM3-1046, RTCM3-1077, RTCM3-1097, RTCM3-1117, RTCM3-1127. Configure whether to output the message. - 0 = Do not output 1 = Output when available - Message version. NOTE 1. When set or get the output rate of $PQTMSVINSTATUS, should be configured to specify the message version, otherwise an error will be returned. 2. When set or get the output rate of a standard RTCM3 message, is omitted. Result: ⚫ If successful, the module returns: //Set: $PQTMCFGMSGRATE,OK*29 //Get: $PQTMCFGMSGRATE,OK,,[,]* ⚫ If failed, the module returns: $PQTMCFGMSGRATE,ERROR,* For details about , see Table 3: Error Code. Example: //Set the output rate of $PQTMSVINSTATUS (version 1) message: $PQTMCFGMSGRATE,W,PQTMSVINSTATUS,1,1*58 $PQTMCFGMSGRATE,OK*29 LG69T(AS)_GNSS_Protocol_Specification 19 / 24 GNSS Module Series //Get the output rate of $PQTMSVINSTATUS (version 1) message: $PQTMCFGMSGRATE,R,PQTMSVINSTATUS,1*40 $PQTMCFGMSGRATE,OK,PQTMSVINSTATUS,1,1* 0B //Set the output rate of RTCM3-1046 message: $PQTMCFGMSGRATE,W,RTCM3-1046,1*5E $PQTMCFGMSGRATE,OK*29 //Get the output rate of RTCM3-1006 message: $PQTMCFGMSGRATE,R,RTCM3-1006*42 $PQTMCFGMSGRATE,OK, RTCM3-1006,1*29 2.2.14. PQTMCFGSBAS Sets/gets the SBAS configuration. Type: Set/Get Synopsis: //Set: $PQTMCFGSBAS,W,* //Get: $PQTMCFGSBAS,R* Parameter: Field Format Unit Hexadecimal - Description Value of SBAS configuration. Bit 0 = Wide Area Augmentation System (WAAS) Bit 1 = System for Differential Corrections and Monitoring (SDCM) Bit 2 = European Geostationary Navigation Overlay Service (EGNOS) Bit 3 = BDS Satellite-based Augmentation System (BDSBAS) Bit 4 = Multi-functional Satellite Augmentation System (MSAS) Bit 5 = GPS Aided GEO Augmented Navigation (GAGAN) LG69T(AS)_GNSS_Protocol_Specification 20 / 24 GNSS Module Series NOTE Only LG69T (AS) with LG69TASNR11A01 or higher versions support this command. Result: ⚫ If successful, the module returns: //Set: $PQTMCFGSBAS,OK* //Get: $PQTMCFGSBAS,OK,* ⚫ If failed, the module returns: $PQTMCFGSBAS,ERROR,* For details about , see Table 3: Error Code. Example: //Set the SBAS configuration to WAAS + SDCM + EGNOS + BDSBAS + MSAS + GAGAN $PQTMCFGSBAS,W,0x3F*33 $PQTMCFGSBAS,OK*71 //Get the SBAS configuration $PQTMCFGSBAS,R*27 $PQTMCFGSBAS,OK,0x3F*60 NOTE After issuing this command, the module needs to be rebooted for the command to take effect. LG69T(AS)_GNSS_Protocol_Specification 21 / 24 GNSS Module Series 3 RTCM Protocol This chapter outlines the RTCM standard and propriety protocols supported by LG69T (AS) module, which is in accordance with RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services - Version 3. This protocol is used for transferring GNSS raw measurement data and is available from https://www.rtcm.org/. Table 4: Supported RTCM3 Messages Message Type 1005 1006 1019 1042 1044 1046 1074 1077 1094 1097 1114 1117 1124 1127 Mode Output Output Output Output Output Output Output Output Output Output Output Output Output Output Description Stationary RTK Reference Station ARP Stationary RTK Reference Station ARP with Antenna Height GPS Ephemerides BDS Satellite Ephemeris Data QZSS Ephemerides Galileo I/NAV Satellite Ephemeris Data GPS MSM4 GPS MSM7 Galileo MSM4 Galileo MSM7 QZSS MSM4 QZSS MSM7 BDS MSM4 BDS MSM7 LG69T(AS)_GNSS_Protocol_Specification 22 / 24 GNSS Module Series 4 Appendix A References Table 5: Terms and Abbreviations Abbreviation ARP BDS ECEF Galileo GNSS GPS MSM NMEA NVM QZSS RTCM RTK UART UTC WGS84 SBAS Description Antenna Reference Point BDS Navigation Satellite System Earth-Centered, Earth-Fixed Galileo Satellite Navigation System (EU) Global Navigation Satellite System Global Positioning System Multiple Signal Messages National Marine Electronics Association Non-Volatile Memory Quasi-Zenith Satellite System Radio Technical Commission for Maritime Services Real-Time Kinematic Universal Asynchronous Receiver/Transmitter Universal Time Coordinated World Geodetic System 1984 Satellite-Based Augmentation System LG69T(AS)_GNSS_Protocol_Specification 23 / 24 GNSS Module Series 5 Appendix B Special Characters Table 6: Special Characters Special Character [...] {…} Underline Definition Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. LG69T(AS)_GNSS_Protocol_Specification 24 / 24

LC29D Series&LC79D (D) GNSS Protocol Specification GNSS Module Series Version: 1.2 Date: 2023-08-30 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 1 / 70 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 2 / 70 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LC29D Series&LC79D (D) GNSS Protocol Specification GNSS Module Series GNSS Protocol Specification Released Revision History Version Date - 2021-04-23 1.0 2021-10-20 1.1 2022-11-23 Description Creation of the document First official release 1. Updated applicable variants: Added LC29D (F) and LC79D (D); Deleted LC29D (A) and LC29D (B). 2. Deleted the chapter about Default Configurations. 3. Added the table about Supported Protocols (Table 1). 4. Added the Sample Code for NMEA Checksum (Chapter 2.1). 5. Updated the description of field and the example of RMC message (Chapter 2.2.1). 6. Deleted SBAS in field (Chapter 2.2.1, Chapter 2.2.3, Chapter 2.2.6 and Chapter 2.2.7). 7. Updated the description of 'M' field and the example of GGA message (Chapter 2.2.2). 8. Updated the maximum value in , and fields of GSA message (Chapter 2.2.5). 9. Added VTG and GLL messages (Chapter 2.2.6 and Chapter 2.2.7). 10. Deleted BRM-ASC-SLEEP message. 11. Added message NMEA_GLL and NMEA_VTG in the BRM-STP- LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 3 / 70 GNSS Module Series Version Date 1.2 2023-08-30 Description MESSAGE Message Content – Set Message Rate (Table 30). 12. Added a note about the maximum number of tracking channels available in hardware (NumTrkChHw) (Chapter 3.5.4). Added PQTM messages (Chapter 2.3). LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 4 / 70 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 7 Figure Index ................................................................................................................................................ 8 1 Introduction ......................................................................................................................................... 9 2 NMEA Protocol .................................................................................................................................. 10 2.1. Structure of NMEA Protocol Messages ................................................................................... 10 2.2. Standard Messages ................................................................................................................. 12 2.2.1. RMC .............................................................................................................................. 12 2.2.2. GGA............................................................................................................................... 14 2.2.3. GNS............................................................................................................................... 16 2.2.4. GSV ............................................................................................................................... 19 2.2.5. GSA ............................................................................................................................... 21 2.2.6. VTG ............................................................................................................................... 22 2.2.7. GLL................................................................................................................................ 23 2.3. PQTM Messages ..................................................................................................................... 25 2.3.1. PQTMVERNO ............................................................................................................... 25 2.3.2. PQTMSAVEPAR ........................................................................................................... 26 2.3.3. PQTMRESTOREPAR ................................................................................................... 27 2.4. PGLOR Messages ................................................................................................................... 28 2.4.1. FIX ................................................................................................................................. 28 2.4.2. LSQ ............................................................................................................................... 28 2.4.3. PWR .............................................................................................................................. 30 2.4.4. SAT................................................................................................................................ 32 2.4.5. STA................................................................................................................................ 34 2.4.6. SPD ............................................................................................................................... 36 3 Bream Protocol ................................................................................................................................. 38 3.1. Structure of Bream Protocol Messages ................................................................................... 38 3.2. ACK and NACK Messages (0x05) ........................................................................................... 39 3.2.1. BRM-ACK-ACK (0x05 0x01) ......................................................................................... 39 3.2.2. BRM-ACK-NAK (0x05 0x00) ......................................................................................... 39 3.3. ASIC (GNSS Device) Manager Messages (0x02)................................................................... 40 3.3.1. BRM-ASC-SUBFRAME (0x02 0x13) ............................................................................ 40 3.3.1.1. GPS/QZSS/NavIC Subframe ............................................................................... 41 3.3.1.2. BDS B1I D1 Subframe.......................................................................................... 42 3.3.1.3. GLONASS L1 OF Subframe ................................................................................ 42 3.3.1.4. Galileo E1 B Subframe ......................................................................................... 43 3.3.2. BRM-ASC-MEAS (0x02 0x15) ...................................................................................... 45 3.4. PVT Results Messages (0x01) ................................................................................................ 48 3.4.1. BRM-PVT-ACC_DIST (0x01 0x09) ............................................................................... 48 LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 5 / 70 GNSS Module Series 3.4.2. BRM-PVT-RESET_ACC_DIST (0x01 0x10)................................................................. 49 3.4.3. BRM-PVT-DOP (0x01 0x04) ......................................................................................... 49 3.4.4. BRM-PVT-EOE (0x01 0x61) ......................................................................................... 50 3.4.5. BRM-PVT-PVT (0x01 0x07) .......................................................................................... 51 3.4.6. BRM-PVT-SAT (0x01 0x35) .......................................................................................... 53 3.5. Setup Messages (0x06) ........................................................................................................... 56 3.5.1. BRM-STP-CONFIG (0x06 0x09)................................................................................... 56 3.5.2. BRM-STP-CONFIG2 (0x06 0x24)................................................................................. 57 3.5.3. BRM-STP-MESSAGE (0x06 0x01)............................................................................... 58 3.5.3.1. Poll a Message Setup........................................................................................... 58 3.5.3.2. Set Message Rate ................................................................................................ 59 3.5.3.3. Supported Periodic Messages ............................................................................. 60 3.5.4. BRM-STP-ME_SETTINGS (0x06 0x3E)....................................................................... 61 3.5.5. BRM-STP-PORT (0x06 0x00)....................................................................................... 63 3.5.5.1. Poll the Setup for One I/O Port............................................................................. 63 3.5.5.2. UART Port Setup .................................................................................................. 64 3.5.6. BRM-STP-RESET (0x06 0x04)..................................................................................... 65 4 Appendix A References.................................................................................................................... 67 5 Appendix B GNSS (NEMA) Numbering .......................................................................................... 69 6 Appendix C Special Characters ...................................................................................................... 70 LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 6 / 70 GNSS Module Series Table Index Table 1: Supported Protocols ....................................................................................................................... 9 Table 2: Structure of NMEA Protocol Messages........................................................................................ 10 Table 3: NMEA Talker ID .............................................................................................................................11 Table 4: Structure of Bream Protocol Messages ....................................................................................... 38 Table 5: BRM-ACK-ACK Message Content ............................................................................................... 39 Table 6: BRM-ACK-NAK Message Content ............................................................................................... 40 Table 7: BRM-ASC-SUBFRAME Message Content .................................................................................. 40 Table 8: BRM-ASC-MEAS Message Content ............................................................................................ 45 Table 9: MEAS Content Blocks – Repeated NumMeas Times .................................................................. 46 Table 10: RecStat Bit Field Definition......................................................................................................... 47 Table 11: SigID Signal Identifiers ............................................................................................................... 47 Table 12: PrStdev Bit Field Definition......................................................................................................... 47 Table 13: CpStdev Bit Field Definition........................................................................................................ 47 Table 14: DoStdev Bit Field Definition........................................................................................................ 48 Table 15: TrkStat Bit Field Definition .......................................................................................................... 48 Table 16: BRM-PVT-ACC_DIST Message Content ................................................................................... 49 Table 17: BRM-PVT-DOP Message Content ............................................................................................. 50 Table 18: BRM-PVT-EOE Message Content ............................................................................................. 51 Table 19: BRM-PVT-PVT Message Content .............................................................................................. 51 Table 20: Valid Flag Bits............................................................................................................................. 53 Table 21: Flags Flag Bits ............................................................................................................................ 53 Table 22: Flags2 Flag Bits.......................................................................................................................... 53 Table 23: BRM-PVT-SAT Message Content .............................................................................................. 54 Table 24: Flags Flag Bits ............................................................................................................................ 55 Table 25: BRM-STP-CONFIG Message Content....................................................................................... 56 Table 26: ClearMask (SaveMask, LoadMask) Flag Bits ............................................................................ 56 Table 27: BRM-STP-CONFIG2 Message Content..................................................................................... 57 Table 28: Mask Flag Bits ............................................................................................................................ 58 Table 29: BRM-STP-MESSAGE Message Content – Poll Request .......................................................... 59 Table 30: BRM-STP-MESSAGE Message Content – Set Message Rate................................................. 59 Table 31: BRM-STP-MESSAGE Message Content – Set Message Rate................................................. 60 Table 32: BRM-STP-ME_SETTINGS Message Content ........................................................................... 61 Table 33: Flags Flag Bits ............................................................................................................................ 62 Table 34: BRM-STP-PORT Message Content – Poll the Setup for one I/O Port ...................................... 63 Table 35: BRM-STP-PORT Message Content - UART Port Setup ........................................................... 64 Table 36: Flags Flag Bits ............................................................................................................................ 65 Table 37: BRM-STP-RESET Message Content......................................................................................... 65 Table 38: NavBbrMask Flag Bits ................................................................................................................ 66 Table 39: Terms and Abbreviations ............................................................................................................ 67 Table 40: GNSS Satellites (NMEA) Numbering ......................................................................................... 69 Table 41: Special Characters ..................................................................................................................... 70 LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 7 / 70 GNSS Module Series Figure Index Figure 1: Structure of NMEA Protocol Messages ...................................................................................... 10 Figure 2: Structure of Bream protocol message ........................................................................................ 38 Figure 3: Structure of GPS/QZSS/NavIC Subframe Word ........................................................................ 41 Figure 4: Structure of BDS B1I D1 Subframe Word .................................................................................. 42 Figure 5: Structure of GLONASS L1 OF Subframe Word ......................................................................... 43 Figure 6: Structure of Galileo E1 B Subframe Word.................................................................................. 44 LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 8 / 70 GNSS Module Series 1 Introduction Quectel LC29D series and LC79D (D) GNSS modules support GPS, GLONASS, Galileo, BDS, QZSS and NavIC constellations. Concurrent tracking of GPS L1 C/A and L5, GLONASS L1, Galileo E1 and E5a, BDS B1I and B2a, QZSS L1 C/A and L5, and NavIC L5 frequency bands provides fast and accurate acquisition and makes those modules an ideal solution for positioning and navigation in various vertical markets. This document describes the software commands that are needed to control and modify the module configuration. The modules can be controlled and configured through Bream command defined by the chipset supplier. To report GNSS information, the modules support output messages in NMEA 0183 protocol or Bream protocol format. This document is applicable to the following Quectel modules: ⚫ LC29D (C) ⚫ LC29D (F) ⚫ LC79D (D) The LC29D series and LC79D (D) GNSS modules support the following protocols: Table 1: Supported Protocols Protocol NMEA 0183 V4.11 Bream Type Output, ASCII, standard Input/output, ASCII, proprietary Input/output, binary, proprietary NOTE 1. Only LC29D (F) module supports BDS B2a frequency bands. 2. Quectel assumes no responsibility if commands other than the ones listed herein are used. 3. For conciseness purposes, LC29D series and LC79D (D) module will hereinafter be referred to collectively as 'the module/modules' in parts hereof applicable to all modules, and individually as 'LC29D (C)', 'LC29D (F)' and 'LC79D (D)' in parts hereof referring to the differences between them. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 9 / 70 GNSS Module Series 2 NMEA Protocol 2.1. Structure of NMEA Protocol Messages The start character of the frame, always ‘$’ Address field, contains talker Identifier and sentence formatter Start with a ‘*’, 8-bit checksum value convert to two ASCII characters Data field(s), delimited by ‘,’ End frame, always $ () [,] * The range for checksum calculation Figure 1: Structure of NMEA Protocol Messages Table 2: Structure of NMEA Protocol Messages Field $ Address Description Start of the sentence (Hex 0x24). In Standard Messages: In NMEA standard messages, this field consists of a two-character talker identifier (TalkerID) and a three-character sentence formatter (SentenceFormatter). The talker identifier serves to define the nature of the data being transmitted. For more information on the TalkerID. See Table 3: NMEA Talker ID. The sentence formatter is used to define the data format and type. Data In Proprietary Messages: In NMEA proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer's Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. Data fields, delimited by comma (,). Variable length (depends on the NMEA message type). LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 10 / 70 GNSS Module Series Field Checksum Description The checksum field follows the checksum delimiter character *. The checksum is the 8-bit exclusive OR of all characters in the sentence, including the comma (,) delimiter, between but not including the $ and the * delimiters. End of the sentence (Hex 0x0D 0x0A). Table 3: NMEA Talker ID GNSS Constellation Configuration GPS GLONASS Galileo BDS QZSS NavIC (IRNSS) Combination of multiple satellite systems TalkerID (NMEA V4.11) GP GL GA GB GQ GI GN Sample Code for NMEA Checksum: // pData is the data array of which the checksum needs to be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL == pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^= *(pData + i); } return result; } LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 11 / 70 GNSS Module Series 2.2. Standard Messages This chapter explains the standard NMEA 0183 V4.11 standard messages supported by the modules. 2.2.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type: Output Synopsis: $RMC,,,,,,,,,,,,,* Parameter: Field $ Format Unit Character - String, 2 characters - RMC String, 3 characters - hhmmss.sss - Character - ddmm.mmmmmm - Character - Example Description $ GN RMC 084353.000 A 3149.330916 N Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. Recommended Minimum Specific GNSS Data. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status: A = Data valid V = Navigation receiver warning Latitude. dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 12 / 70 GNSS Module Series Field Format Unit Example Description dddmm.mmmmmm Character Numeric Numeric ddmmyy - Knot Degree - 11706.960337 E 0.784 120822 N = North S = South Note that this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction. E = East W = West Note that this field is empty in case of an invalid value. Speed over ground. Variable length. Note that this field is empty in case of an invalid value. Course over ground. Variable length. Maximum value: 359.9. Note that this field is empty in case of an invalid value. Date. dd: Day of month mm: Month yy: Year - - - Magnetic variation. Not supported. - - - Character - A Direction of magnetic variation. Not supported. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix. D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations. E = Estimated (dead reckoning) mode. F = Float RTK. Satellite system used LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 13 / 70 GNSS Module Series Field Format Character Hexadecimal Character Unit Example - V - *25 - - Description in RTK mode with floating integers. M = Manual input mode. N = No fix. Satellite system not used in position fix, or fix not valid. R = Real Time Kinematic (RTK). Satellite system used in RTK mode with fixed integers. Navigational status. Not supported. Always 'V' (Navigational status not valid). Checksum. Carriage return and line feed. Example: $GNRMC,084353.000,A,3149.330916,N,11706.960337,E,0.784,,120822,,,A,V*25 2.2.2. GGA Global Positioning System Fix Data. Time, position, and fix-related data for a GNSS receiver. Type: Output Synopsis: $GGA,,,,,,,,,,M,,M,,* Parameter: Field $ GGA Format Unit Character - String, 2 characters - String, 3 characters - hhmmss.sss - Example $ GN GGA 084353.000 Description Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. Global Positioning System Fix Data. Position fix UTC: hh: Hours (00–23) LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 14 / 70 Field GNSS Module Series Format Unit ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - Numeric, 1 digit - Example Description 3149.330916 N 11706.960337 E 1 mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Latitude. dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction. N = North S = South Note that this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction. E = East W = West Note that this field is empty in case of an invalid value. GPS quality indicator. 0 = Fix not available or invalid. 1 = GPS SPS Mode, fix valid. 2 = Differential GPS, SPS Mode, fix valid. 3 = GPS PPS Mode, fix valid. 4 = Real Time Kinematic (RTK). System used in RTK mode with fixed integers. 5 = Float RTK. Satellite system used in RTK mode with floating integers. 6 = Estimated (dead reckoning) mode. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 15 / 70 GNSS Module Series Field 1) M Format Numeric, 2 digits Numeric Numeric Unit Example - 07 - 1.01 Meter 178.6 Character - M Numeric Meter -3.6 M Character Hexadecimal Character - M - - - - - *64 - - Description Number of satellites in use. Horizontal dilution of precision. Altitude above mean-sea-level (geoid). Unit of . 'M' = Meter. Geoidal separation (the difference between the earth ellipsoid surface and the meansea-level (geoid) surface defined by the reference datum used in the position solution) Unit of . 'M' = Meter. Differential GPS data age. Not supported. Differential reference station ID. Not supported. Checksum. Carriage return and line feed. Example: $GNGGA,084353.000,3149.330916,N,11706.960337,E,1,07,1.01,178.6,M,-3.6,M,,*64 NOTE 1. The NMEA 0183 specification indicates that the GGA message is GPS specific. However, when the receiver is configured for multi-constellations, the content of GGA message will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12. 2.2.3. GNS GNSS Fix Data. Fix data for single or combined satellite navigation systems (GNSS). Type: Output LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 16 / 70 GNSS Module Series Synopsis: $GNS,,,,,,,,,, ,,,* Parameter: Field $ GNS Format Character String, 2 characters String, 3 characters hhmmss.ss ddmm.mmmmmm Character dddmm.mmmmmm Character Unit Example Description - $ - GN Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. - GNS GNSS Fix Data. Position fix UTC: hh: Hours (00–23) - 053148.00 mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Latitude. dd: Degrees (00–90) mm: Minutes (00–59) - 3149.279018 mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction. N = North - N S = South Note that this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) - 11706.919922 mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction. E = East - E W = West Note that this field is empty in case of an invalid value. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 17 / 70 Field Format 1) Character Numeric Numeric Numeric Numeric - - Character Hexadecimal GNSS Module Series Unit Example - AANNNN - 04 - 5.3 Meter 95.1 Meter -3.6 - - - - - V - *0D Description Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix. D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations. E = Estimated (dead reckoning) mode. F = Float RTK. Satellite system used in RTK mode with floating integers. M = Manual input mode. N = No fix. Satellite system not used in position fix, or fix not valid. R = Real Time Kinematic (RTK). Satellite system used in RTK mode with fixed integers. Total number of satellites in use. Range: 00–99. Horizontal dilution of precision. Maximum value: 99.0. Antenna altitude above the mean sea level (geoid). Geoidal separation (the difference between the earth ellipsoid surface and the meansea-level (geoid) surface defined by the reference datum used in the position solution). Differential GPS data age. Not supported. Differential reference station ID. Not supported. Navigational status indicator. Not supported. Always 'V' (Navigational status not valid). Checksum. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 18 / 70 GNSS Module Series Field Format Character Unit Example - - Description Carriage return and line feed. Example: $GNGNS,053148.00,3149.279018,N,11706.919922,E,AANNNN,04,5.3,95.1,-3.6,,,V*0D NOTE 1) is a field type of variable length. The first character indicates the use of GPS satellites, the second character indicates the use of GLONASS satellites, the third character indicates the use of Galileo satellites, the fourth character indicates the use of BDS satellites, the fifth character indicates the use of QZSS satellites, and the sixth character indicates the use of NavIC (IRNSS) satellites. 2.2.4. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value, and contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of sentences being transmitted and the sentence number are indicated in the first two fields of data fields. Type: Output Synopsis: $GSV,,,{,,,,}, * Parameter: Field $ Format Unit Character - String, 2 characters - GSV String, 3 characters - Numeric - Numeric - Example Description $ GP GSV 3 1 Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. GNSS Satellites in View. Total number of sentences. Range: 1–9. Sentence number. Range: 1–. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 19 / 70 GNSS Module Series Field Format Unit Example Description Numeric - 11 Total number of satellites in view. Start of repeat block. Repeat times: 1–4. Numeric - 01 Numeric Degree 74 Numeric Degree 142 Numeric End of repeat block. Numeric Hexadecimal dB-Hz 46 - 1 - *64 Satellite ID. See Table 40: GNSS Satellites (NMEA) Numbering. Satellite elevation. Range: 00–90. Satellite azimuth, with true north as the reference plane. Range: 000–359. Satellite SNR (C/N0). Range: 00–99. Null when not tracking. GNSS signal ID. See Table 40: GNSS Satellites (NMEA) Numbering. Checksum. Character - - Carriage return and line feed. Example: $GPGSV,3,1,11,01,74,142,46,07,57,216,43,08,39,045,43,14,34,316,44,1*64 $GPGSV,3,2,11,17,18,261,40,21,62,060,44,28,28,313,41,30,52,280,44,1*60 $GPGSV,3,3,11,01,,,39,08,,,35,30,,,38,8*60 $GLGSV,1,1,01,86,65,266,31,1*44 $GQGSV,2,1,04,02,59,131,43,03,73,061,43,1*6F $GQGSV,2,2,04,02,,,32,03,,,30,8*6B $GBGSV,2,1,06,40,63,004,38,27,63,268,41,37,72,183,41,1*4A $GBGSV,2,2,06,40,,,36,27,,,36,37,,,37,5*75 $GAGSV,2,1,08,02,38,321,40,11,60,043,40,24,29,123,35,25,78,060,44,7*75 $GAGSV,2,2,08,02,,,34,11,,,34,24,,,27,25,,,36,1*7E NOTE GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, GSV sentence are output with the corresponding talker ID for each constellation respectively. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 20 / 70 GNSS Module Series 2.2.5. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA or GNS sentence, and DOP values. Type: Output Synopsis: $GSA,,{,},,,* Parameter: Field $ GSA Format Unit Character - String, 2 characters - String, 3 characters - Character - Numeric - Start of repeat block. Repeat times: 12. Numeric - End of repeat block. Numeric - Numeric - Numeric - Example $ GN GSA A 3 01 2.2 1.1 1.9 Description Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. GNSS DOP and Active Satellites. Selection of 2D or 3D fix: M = Manual, forced to operate in 2D or 3D mode. A = Automatic, allowed to automatically switch between 2D/3D mode. Fix mode: 1 = Fix not available 2 = 2D 3 = 3D ID numbers of satellites used in solution. See Table 40: GNSS Satellites (NMEA) Numbering. Position dilution of precision. Maximum value: 99.99. Horizontal dilution of precision. Maximum value: 99.99. Vertical dilution of precision. Maximum value: 99.99. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 21 / 70 GNSS Module Series Field Format Numeric Hexadecimal Character Unit Example Description - 1 GNSS system ID. See Table 40: GNSS Satellites (NMEA) Numbering. - *31 Checksum. - - Carriage return and line feed. Example: $GNGSA,A,3,01,07,08,14,30,,,,,,,,2.2,1.1,1.9,1*31 $GNGSA,A,3,86,,,,,,,,,,,,2.2,1.1,1.9,2*34 $GNGSA,A,3,02,03,,,,,,,,,,,2.2,1.1,1.9,5*3C $GNGSA,A,3,02,11,24,25,,,,,,,,,2.2,1.1,1.9,3*38 NOTE If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used for navigation, only the IDs of the first 12 are output. 2.2.6. VTG Course Over Ground and Ground Speed. The actual course and speed relative to the ground. Type: Output Synopsis: $VTG,,T,,M,,N,,K,* Parameter: Field $ VTG Format Unit Example Description Character - String, 2 characters - String, 3 characters - $ VTG Numeric Degrees - Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. Course Over Ground and Ground Speed. Course over ground, in true north course direction. Not supported. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 22 / 70 GNSS Module Series Field T M N K Format Character Numeric Character Numeric Character Numeric Character Character Hexadecimal Character Unit Example Description - T Degrees - - M Fixed field: true. Course over ground (magnetic). Not supported. Fixed field: magnetic. Knots 0.066 Speed over ground in knots. km/h - - - N 0.122 K A - Fixed field: knot. Speed over ground in kilometers per hour. Fixed field: kilometers per hour. Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations E = Estimated (dead reckoning) mode M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid Checksum. - - Carriage return and line feed. Example: $GNVTG,,T,,M,0.066,N,0.122,K,A*3C 2.2.7. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type: Output LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 23 / 70 GNSS Module Series Synopsis: $GLL,,,,,,,* Parameter: Field $ GLL Format Unit Character - String, 2 characters - String, 3 characters - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - hhmmss.sss - Character - Example Description $ Each NMEA message starts with $. 3149.332550 N 11706.951067 E 055253.000 A Talker identifier. See Table 3: NMEA Talker ID. Geographic Position – Latitude/Longitude. Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction: N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction: E = East W = West Note that this field is empty in case of an invalid value. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status: A = Data not valid LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 24 / 70 GNSS Module Series Field Format Character Hexadecimal Character Unit Example - A - - - - Description V = Data valid Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations E = Estimated (dead reckoning) mode M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid. Checksum. Carriage return and line feed. Example: $GNGLL,3149.332550,N,11706.951067,E,055253.000,A,A*43 2.3. PQTM Messages This chapter explains the PQTM messages (proprietary NMEA messages defined by Quectel) supported by LC29D series and LC79D (D). 2.3.1. PQTMVERNO Queries the firmware version information. Type: Command Synopsis: $PQTMVERNO* Parameter: None LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 25 / 70 GNSS Module Series Result: ⚫ If successful, the module returns: $PQTMVERNO,,,* Parameters included in the result: Field Format Unit String - yyyy/mm/dd - hh:mm:ss - Description Firmware version. Firmware build date. Firmware build time. ⚫ If failed, the module returns: $PQTMVERNOERROR* Example: $PQTMVERNO*58 $PQTMVERNO,LC29DCNR05A01S_2WDR_HYF_BETA0327,2023/03/29,09:44:16*17 2.3.2. PQTMSAVEPAR Saves the configurations set via PQTM commands into NVM. Type: Command Synopsis: $ PQTMSAVEPAR* Parameter: None Result: ⚫ If successful, the module returns: $PQTMSAVEPAROK* ⚫ If failed, the module returns: $PQTMSAVEPARERROR* LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 26 / 70 Example: $PQTMSAVEPAR*5A $PQTMSAVEPAROK*5E 2.3.3. PQTMRESTOREPAR Restores all parameters set via PQTM commands to default values. Type: Command Synopsis: $PQTMRESTOREPAR* Parameter: None Result: ⚫ If successful, the module returns: $PQTMRESTOREPAROK* ⚫ If failed, the module returns: $PQTMRESTOREPARERROR* Example: $PQTMRESTOREPAR*13 $PQTMRESTOREPAROK*17 GNSS Module Series LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 27 / 70 GNSS Module Series 2.4. PGLOR Messages This chapter explains the PGLOR messages (proprietary NMEA messages defined by the chipset supplier) supported by LC29D series and LC79D (D). 2.4.1. FIX GNSS time-to-first-fix (TTFF). Type: Output Synopsis: $PGLOR,,FIX,* Parameter: Field FIX Format Numeric Numeric Unit Description - Sentence version. Second - TTFF relative to when the request was received. Example: $PGLOR,0,FIX,41.1*17 NOTE This message only output when the modules are fixed. 2.4.2. LSQ LSQ is a kind of GNSS fix data, which contains time, LSQ position and fix-related data for a GNSS receiver. Type: Output LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 28 / 70 GNSS Module Series Synopsis: $PGLOR,,LSQ,,,,,,,,,,, ,,,,,,,,*< Checksum> Parameter: Field LSQ Format Numeric - hhmmss.ss Numeric Character Numeric Character Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit - - Meter Meter Meter m/s m/s m/s m/s Description Sentence version. LSQ is a kind of GNSS fix data, which contains time, LSQ position and fix-related data for a GNSS receiver. Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Latitude. Latitude direction: N = North S = South Longitude. Longitude direction: E = East W = West Horizontal error RMS. Horizontal dilution of precision. Antenna altitude above/below WGS84 ellipsoid. Altitude error RMS. Vertical dilution of precision. Horizontal speed. Horizontal speed error RMS. Vertical speed. Vertical speed error RMS. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 29 / 70 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Unit Degrees Degrees - Meter Meter^2 Description Track, azimuth clockwise from true North. Track error RMS. Number of satellites in use in LS (location service) fix, may be different from the number in view, and from number used in Kalman filter and shown in GNS/GGA. Bias estimation between L1 and L5 in the GNSS RF path. L5 bias estimation sigma. Example: $PGLOR,1,LSQ,061215.00,,,,,,,,,,,,,,,,00,,*3A 2.4.3. PWR Power consumption report. Type: Output Synopsis: $PGLOR,,PWR,mA,,RFTm,,OscTm,,MeasTm,,UTC,< UTC>,GNSSmA,,CPUTm,,COPTm,,SrchTm,,TrkTm,,RpcTm,,McuTotalTm,,McuSleepTm,,McuIdleTm,,Mcu26Tm,,Mcu52Tm,,McuTurboTm,* Parameter: Field PWR mA Format Numeric Numeric Unit Description - Sentence version. - Power consumption report. - - Average current during the last mA measurement. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 30 / 70 Field RFTm OscTm MeasTm UTC Format Numeric Numeric Numeric - hhmmss.ss GNSSmA CPUTm COPTm SrchTm TrkTm RpcTm McuTotalTm McuSleepTm Numeric Numeric Numeric Numeric Numeric Numeric Numeric - GNSS Module Series Unit Millisecond Millisecond Millisecond - - mA Millisecond Millisecond Millisecond Millisecond Millisecond Millisecond - Description RF working time. Oscillator working time. Measurement duration. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Average current attributed to the GNSS core. CPU working time. Coprocessor working time. Searching time. Tracking time. Time spent processing RPCs. Total profiling time of MCU. - LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 31 / 70 GNSS Module Series Field McuIdleTm Mcu26Tm Mcu52Tm McuTurboTm Format Numeric Numeric Numeric Numeric Numeric Unit Millisecond Millisecond Millisecond Millisecond Millisecond Description Time of MCU in sleep state. - Time of MCU in idle state. MCU time (The CPU is in 26 MHz mode.) MCU time (The CPU is in 52 MHz mode.) MCU time (The CPU is in turbo mode.) Example: $PGLOR,5,PWR,mA,42.3,RFTm,1000,OscTm,1000,MeasTm,1000,UTC,062504.00,GNSSmA,37.6,CPU Tm,538,COPTm,130,SrchTm,680,TrkTm,773,RpcTm,212,McuTotalTm,1002,McuSleepTm,0,McuIdleTm, 544,Mcu26Tm,3,Mcu52Tm,106,McuTurboTm,350*7D 2.4.4. SAT GNSS satellite information. Type: Output Synopsis: $PGLOR,,SAT,,{,,,}* Parameter: Field SAT Format Numeric Numeric Unit Description - Sentence version. - - - Total number of messages. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 32 / 70 GNSS Module Series Field Format Numeric Character + Numeric Numeric Hexadecimal Unit Description Range: 1–6. dB-Hz - Message number. Range: 1–. This is a concatenation of two items: the GNSS system ID and the GNSS satellite ID. GNSS system ID can be G, R, Q, S, B, E, or N. G = GPS R = GLONASS Q = QZSS B = BDS E = Galileo N = NavIC GNSS satellite ID: 01–64. Satellite C/N0. Range: 00–99. Null when not tracking. Satellite information in hex format. This will be two, three, or four hexadecimal characters with the following bit definitions: Bit 0: L1 Pr measurement valid from measurement engine. Bit 1: L1 Rr measurement valid from measurement engine. Bit 2: L1 Pr measurement used in the position computation. Bit 3: L1 Rr measurement used in the position computation. Bit 4 and 5: Ephemeris source. Bit 6: DGNSS used in position computation. Bit 7: L5 Pr measurement valid from measurement engine. Bit 8: L5 Rr measurement valid from measurement engine. Bit 9: L5 Pr measurement used in the position computation. Bit 10: L5 Rr measurement used in the position computation. Bit 11–31: Reserved. Pr = Pseudorange. Rr = Range rate. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 33 / 70 GNSS Module Series Example: $PGLOR,2,SAT,4,1,G01,43,1F,G04,42,13,G08,19,13,G09,40,09F,G11,32,13,G16,35,13*06 $PGLOR,2,SAT,4,2,G17,38,13,G22,42,13,G27,28,13,R13,36,1F,R23,20,11,R17,45,1F*24 $PGLOR,2,SAT,4,3,Q01,41,1F,Q02,32,1F,Q03,36,13,B06,38,13,B08,36,13,B09,38,13*25 $PGLOR,2,SAT,4,4,B11,39,13,B13,40,13,B16,38,13,B24,32,13,B26,43,13,B34,24,13*37 2.4.5. STA GNSS latitude/longitude status. Type: Output Synopsis: $PGLOR,,STA,,,,,,,,P,,L,,C,,S,,,,R,< HULASrc>,,,,LC,,,DR,0,* Parameter: Field STA Format Numeric - hhmmss.ss Numeric Numeric Numeric Numeric Numeric Numeric Unit Description - Sentence version. Second - Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds RTC initial error. Second RTC uncertainty. PPB Oscillator offset. PPB Oscillator uncertainty. Meter - Position uncertainty. Internal velocity and track quality (This field is independent of RMC speed and track, and does not indicate speed or track validity.): 0: Poor velocity, poor track. 1: Good velocity, poor track. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 34 / 70 Field Format P - Character L C Numeric - Numeric S Numeric Numeric Numeric R Numeric Character GNSS Module Series Unit Meter - - Description 2: Poor velocity, good track. 3: Good velocity, good track. - Power-saving mode status indications. D: Disabled, always in full-power mode. F: Enabled, now in full-power mode. S: Enabled, now in power-saving mode. H: Host offload mode. - HULA request for location input values. 0: Location input not needed. 1: Location input requested. - HULA position confidence values. 0: Unknown. 1: Low. 2: Medium. 3: High. - Not supported. Accumulated distance since start. Time Source. 0: Time is invalid. 1: Time is restored after standby. 2: Time is derived from assistance. 3: Time is from position computation (not supported yet). 4: Time is from TOW and WN decoding from one satellite. 5: Time is from TOW and WN decoding from more than one satellite. - Not supported. Aiding status: [tT][pP][eE][fF] Time available (T), not available (t). Position available (P), not available (p). Ephemeris available (E), not available for LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 35 / 70 GNSS Module Series Field Format LC,,,DR,0, Numeric Numeric - Unit Description 90% of all in view satellites (e). Frequency available (F), not available (f). - Number of satellites with valid ephemeris. ms Elapsed time (LMS). - - Example: $PGLOR,10,STA,070123.00,-0.002,0.000,961,0,2,0,P,D,L,0,C,0,S,00000000,0,0,R,00000000,tpef,0,432 4807,LC,,,DR,0,*31 2.4.6. SPD Speed status. Type: Output Synopsis: $PGLOR,,SPD,,,,,,,,,,,,* Parameter: Field SPD Format Numeric Numeric ddmmyy hhmmss.ss Unit Description - Sentence version. - - - Request ID. Date. dd: Day of month - mm: Month yy: Year UTC of position fix. hh: Hours (00–23) - mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 36 / 70 GNSS Module Series Field Format Character Numeric Character Numeric Character Numeric Character Numeric Numeric Unit m/s Meter Hz km Meter Description ‘S’ if speed is valid; otherwise ‘s’. Speed. ‘L’ if step length is valid, otherwise ‘l’. Step length in meters, if valid. ‘C’ if cadence is valid, otherwise ‘c’. Cadence in Hz, if valid. ‘D’ if distance is valid, otherwise ‘d’. Kilometer part of distance (A), if valid. Distance under kilometer part (B). Total distance = 1000 * A + B(meter). Example: $PGLOR,0,SPD,0,100420,074045.00,s, 0.0,l,0.00,c, 0.0,D, 0,768.7*1C LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 37 / 70 GNSS Module Series 3 Bream Protocol This chapter introduces the Bream proprietary protocol provided by the chipset supplier which is supported by LC29D series and LC79D (D). 3.1. Structure of Bream Protocol Messages The header of the frame, fixed as 0xB5 0x62 1 byte 1 byte 2 bytes 2 bytes Header Message Group Message Number Length The range for checksum calculation Content Checksum (CHK1, CHK2) Figure 2: Structure of Bream protocol message Table 4: Structure of Bream Protocol Messages Field Description Header Bream protocol frame header consisting of 2 bytes: 0xB5, 0x62. Message Group 1-byte message group. Message Number Length Content Checksum 1-byte message number. Content field length. It does not include the Header, Message Group, Message Number, Length or Checksum fields. The length format is a little-endian unsigned 16-bit integer. Message payload, with a variable number of bytes. 2-byte checksum (CHK1 and CHK2), i.e., a 16-bit checksum, whose calculation is similar to an 8-bit Fletcher algorithm. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 38 / 70 GNSS Module Series Checksum sample code: //Buffer is the data array of which the checksum needs to be calculated. uint8_t CHK1 = 0; uint8_t CHK2 = 0; for(i = 0; i < length; i++) { CHK1 = CHK1 + Buffer[i]; CHK2 = CHK2 + CHK1; } 3.2. ACK and NACK Messages (0x05) 3.2.1. BRM-ACK-ACK (0x05 0x01) Message acknowledged. Output upon processing an input message. Type: Output Structure: Header 0xB5 0x62 Message Group 0x05 Message Number 0x01 Length (Bytes) 2 Content Checksum See Table 5: BRM-ACKCHK1 CHK2 ACK Message Content. Table 5: BRM-ACK-ACK Message Content Byte Offset C99 Scaling Name Unit Description 0 uint8_t - GrpNum - Group number of the acknowledged message. Message number of the acknowledged 1 uint8_t - MsgNum - message. 3.2.2. BRM-ACK-NAK (0x05 0x00) Message not acknowledged. Output upon processing an input message. Type: Output LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 39 / 70 Structure: Header Message Message Group Number 0xB5 0x62 0x05 0x00 GNSS Module Series Length (Bytes) 2 Content Checksum See Table 6: BRM-ACK-NAK CHK1 CHK2 Message Content. Table 6: BRM-ACK-NAK Message Content Byte Offset C99 Scaling Name Unit Description 0 uint8_t - GrpNum - Group number of the unacknowledged message. Message number of the unacknowledged 1 uint8_t - MsgNum - message. 3.3. ASIC (GNSS Device) Manager Messages (0x02) 3.3.1. BRM-ASC-SUBFRAME (0x02 0x13) A navigation data subframe. This message reports a complete subframe of broadcast navigation data decoded from a single signal. The number of data words reported in each message depends on the signal type (which is determined from the GNSS_ID field). The supported signals are GPS L1 C/A, QZSS L1 C/A, GLONASS L1 OF, Galileo E1 B, BDS B1I D1, and NavIC L5A. Each BRM-ASC-SUBFRAME message contains a number of 32-bit words, as indicated by the NumWords field. Type: Output Structure Header 0xB5 0x62 Message Group 0x02 Message Number 0x13 Length (Bytes) 8 + 4 * NumWords Content See Table 7: BRM-ASCSUBFRAME Message Content. Checksum CHK1 CHK2 Table 7: BRM-ASC-SUBFRAME Message Content Byte Offset C99 Scaling Name 0 uint8_t - GNSS_ID Unit Description GNSS identifier. - See Table 40: GNSS Satellites (NMEA) Numbering. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 40 / 70 Byte Offset C99 Scaling Name 1 uint8_t - SvID 2 uint8_t - Reserved1 3 uint8_t - FreqID 4 uint8_t - NumWords 5 uint8_t - Reserved2 6 uint8_t - Version 7 uint8_t - Reserved3 Start of repeated block (NumSvs times) 8 + 4 * N uint32_t - Dwrd End of repeated block GNSS Module Series Unit Description Satellite identifier. - See Table 40: GNSS Satellites (NMEA) Numbering - Reserved. Only used for GLONASS. The value is - the frequency slot plus 7. Range: 0–13. The number of data words contained in - this message. - Reserved. - Version. 0x01 for this version. - Reserved. - NumWords data words. NOTE LC29D (C) does not support this message. 3.3.1.1. GPS/QZSS/NavIC Subframe The structure of GPS/QZSS/NavIC subframe words in this message are matched with subframe words description in the each ICD. Each subframe comprises 10 data words, which are reported in the same order they are received. MSB 1-10 Padding 2 bits Data 24 bits LSB Parity 6 bits Figure 3: Structure of GPS/QZSS/NavIC Subframe Word LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 41 / 70 GNSS Module Series NOTE The 2 most significant bits in each word are padding bits and should be ignored. 3.3.1.2. BDS B1I D1 Subframe The structure of BDS B1I D1 subframe words in this message are matched with subframe words description in the BDS ICD. Each subframe comprises 10 data words, which are reported in the same order they are received. MSB 1 Padding 2 bits Data 26 bits LSB Parity 4 bits 2-10 Padding 2 bits Data 22 bits Parity 8 bits Figure 4: Structure of BDS B1I D1 Subframe Word NOTE The 2 most significant bits in each word are padding bits and should be ignored. 3.3.1.3. GLONASS L1 OF Subframe There is a total of four 32-bit data words in each string. The first three words include 85 data bits and 11 padding bits in the least significant bits. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 42 / 70 MSB 1 Data (85 - 54) 32 bits GNSS Module Series LSB Data (53 - 22) 2 32 bits Data (21 - 1) Padding (All zero) 3 21 bits 11 bits Padding (All zero) 4 32 bits Figure 5: Structure of GLONASS L1 OF Subframe Word NOTE 1. The bits 0–10 in the 3rd word are padding bits and should be ignored. 2. The 4th word are all zero and should be ignored. 3.3.1.4. Galileo E1 B Subframe For Galileo E1 B signals, the 9 data words contain a pair of I/NAV pages as described in the Galileo ICD. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 43 / 70 MSB Page type 1 bit 1 0 0 Word type 6 bits Even/odd 1 bit 2 Data (122 - 99) 24 bits Data (98 - 67) 32 bits GNSS Module Series LSB 3 Data (66 - 35) 32 bits 4 Data (34 - 17) 18 bits Tail 6 bits Padding 8 bits Page type 1 bit 5 10 Data (16 - 1) 16 bits Reserved (40 - 27) 14 bits Even/odd 1 bit Reserved 1 (26 - 1) SAR (22 -17) 6 26 bits 8 bits 7 SAR (16 -1) 16 bits Spare 2 bits CRC (24 -11) 14 bits 8 CRC (10 -1) 16 bits Reserved 2 8 bits Tail 6 bits Padding 8 bits 9 Reserved 3 32 bits Figure 6: Structure of Galileo E1 B Subframe Word LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 44 / 70 GNSS Module Series NOTE 1. The bits 0–7 in 4th and 8th word are padding bits and should be ignored. 2. The 9th word should be ignored. 3.3.2. BRM-ASC-MEAS (0x02 0x15) Multi-GNSS raw measurement data. This message contains pseudorange, doppler shift, carrier phase, phase lock, and signal quality information for GNSS satellites after signals have been synchronized. The maximum message rate is limited to 1 Hz. Type: Output Structure Header 0xB5 0x62 Message Group 0x02 Message Number 0x15 Length (Bytes) 16 + 32 * NumMeas Content See Table 8: BRM-ASCMEAS Message Content. Checksum CHK1 CHK2 Table 8: BRM-ASC-MEAS Message Content Byte Offset C99 Scaling Name Unit Description Measurement time of week in receiver 0 double - RcvTOW Second local time approximately aligned to the GPS time system. 8 uint16_t - Week Week GPS week number. GPS leap second (GPS-UTC). This field represents the receiver's best knowledge 10 int8_t - LeapS Second of the leap second offsets. A flag is given in RecStat to indicate if the leap seconds are known. Number of measurements. 11 uint8_t - NumMeas - See Table 9: MEAS Content Blocks – Repeated NumMeas Times. Receiver tracking status bit field. 12 uint8_t - RecStat - See Table 10: RecStat Bit Field Definition 13 uint8_t[3] - Reserved - Reserved. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 45 / 70 GNSS Module Series Table 9: MEAS Content Blocks – Repeated NumMeas Times Byte Offset C99 Scaling Name 16 + 32 * N double - PrMes 24 + 32 * N double - CpMes 32 + 32 * N float - 36 + 32 * N uint8_t - DpMes GNSS_ID 37 + 32 * N uint8_t - SvID 38 + 32 * N uint8_t 39 + 32 * N uint8_t 40 + 32 * N uint16_t 42 + 32 * N uint8_t - SigID FreqID LockTime CN0 43 + 32 * N uint8_t 0.01 * 2^n PrStdev 44 + 32 * N uint8_t 0.004 CpStdev 45 + 32 * N uint8_t 0.002 * 2^n DoStDev 46 + 32 * N uint8_t - TrkStat Unit Description Meter Cycle Hz ms dB-Hz Meter Cycle Hz - Pseudorange measurement. GLONASS inter-frequency channel delays are compensated with an internal calibration table. Carrier phase measurement. The carrier phase initial ambiguity is initialized using an approximate value to make the magnitude of the phase close to the pseudorange measurement. Measured Doppler shift (positive sign for approaching satellites). GNSS identifier. See Table 40: GNSS Satellites (NMEA) Numbering. Satellite identifier. See Table 40: GNSS Satellites (NMEA) Numbering Signal identifier. See Table 11: SigID Signal Identifiers. Only used for GLONASS. The value is the frequency slot plus 7. Range: 0–13. Carrier phase lock-time counter (maximum 64,500 ms). Carrier-to-noise density ratio (signal strength). Estimated pseudorange measurement standard deviation. See Table 12: PrStdev Bit Field Definition. Estimated carrier phase measurement standard deviation. (A raw value of 0x0F indicates the value is invalid.) See Table 13: CpStdev Bit Field Definition. Estimated Doppler-shift measurement standard deviation. See Table 14: DoStdev Bit Field Definition. Tracking status bit field. See Table 15: TrkStat Bit Field Definition. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 46 / 70 GNSS Module Series Byte Offset C99 Scaling 47 + 32 * N uint8_t - Name Frac_CN0 Unit - Description Bits 0–2: Fractional part of CN0 (1/8 dBHz resolution). Bits 3–7: Reserved. Table 10: RecStat Bit Field Definition Name Bit ClkReset 0 LeapSec 1 Description Clock reset applied. Typically, the receiver clock is changed in increments of integer milliseconds. Leap seconds that have been determined. Table 11: SigID Signal Identifiers SigID GPS Galileo 0 L1 C/A E1 1 - - 4 - E5a 7 L5-Q - 9 - - BDS B1I D1 B1I D2 B2a - QZSS L1 C/A L5-Q GLONASS NavIC L1 L5 - - - - - - - - Table 12: PrStdev Bit Field Definition Name PrStd Bit Description 0–3 Estimated pseudorange standard deviation. Table 13: CpStdev Bit Field Definition Name CpStd Bit Description 0–3 Estimated carrier phase standard deviation. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 47 / 70 GNSS Module Series Table 14: DoStdev Bit Field Definition Name DoStd Bit Description 0-3 Estimated doppler-shift standard deviation. Table 15: TrkStat Bit Field Definition Name Bit PrValid 0 CpValid 1 HalfCyc 2 SubHalfCyc 3 Description The validity of Pseudorange. The validity of carrier phase. The validity of half cycle. Half cycle subtracted from phase. NOTE LC29D (C) does not support this message. 3.4. PVT Results Messages (0x01) 3.4.1. BRM-PVT-ACC_DIST (0x01 0x09) This message outputs the travel distance since the last reset (see BRM-PVT-RESET_ACC_DIST) together with an associated estimated accuracy and the total accumulated ground distance. The polled data can only be reset by a cold start of the GNSS device. Type: Output Structure Header 0xB5 0x62 Message Group Message Number Length (Bytes) 0x01 0x09 20 Content Checksum See Table 16: BRM-PVTACC_DIST Message Content. CHK1 CHK2 LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 48 / 70 GNSS Module Series Table 16: BRM-PVT-ACC_DIST Message Content Byte C99 Scaling Name Unit Offset 0 uint8_t - Version - Description Message version (0x00). 1 uint8_t[3] - Reserved - Reserved 4 uint32_t - TOW ms GPS time of week of the navigation epoch. 8 uint32_t - Distance Meter Ground distance since last reset. 12 uint32_t - 16 uint32_t - TotalDistance DistanceStd Meter Meter Total cumulative ground distance. Ground distance accuracy (1-sigma). (Not implemented) 3.4.2. BRM-PVT-RESET_ACC_DIST (0x01 0x10) This message resets the accumulated distance computed by the odometer (see BRM-PVT-ACC_DIST). BRM-ACK-ACK or BRM-ACK-NAK are returned to indicate success or failure. Type: Command Structure Header Message Group Message Number Length (Bytes) Content 0xB5 0x62 0x01 0x10 0 None Checksum CHK1 CHK2 3.4.3. BRM-PVT-DOP (0x01 0x04) DOP values are dimensionless. All DOP values are scaled by a factor of 100. If a DOP value transmits a value of 156, then the DOP value is 1.56. Type: Output LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 49 / 70 GNSS Module Series Structure Header Message Message Group Number 0xB5 0x62 0x01 0x04 Length (Bytes) 18 Content Checksum See Table 17: BRM-PVT-DOP CHK1 CHK2 Message Content. Table 17: BRM-PVT-DOP Message Content Byte Offset C99 0 uint32_t 4 uint16_t 6 uint16_t 8 uint16_t 10 uint16_t 12 uint16_t 14 uint16_t 16 uint16_t Scaling Name - TOW 0.01 GDOP 0.01 PDOP 0.01 TDOP 0.01 VDOP 0.01 HDOP 0.01 NDOP 0.01 EDOP Unit Description ms GPS time of week of the navigation epoch. - Geometric DOP. (Not supported) - Position DOP. - Time DOP. (Not supported) - Vertical DOP. - Horizontal DOP. - Northing DOP. (Not supported) - Easting DOP. (Not supported) 3.4.4. BRM-PVT-EOE (0x01 0x61) This message is intended to be used as a marker to collect all PVT messages of an epoch. It is output after all enabled PVT group messages and after all enabled NMEA messages. Type: Output Structure Header 0xB5 0x62 Message Group 0x01 Message Number 0x61 Length (Bytes) 4 Content Checksum See Table 18: BRM-PVTCHK1 CHK2 EOE Message Content. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 50 / 70 GNSS Module Series Table 18: BRM-PVT-EOE Message Content Byte Offset C99 0 uint32_t Scaling Name - TOW Unit Description ms GPS time of week of the navigation epoch. 3.4.5. BRM-PVT-PVT (0x01 0x07) Navigation position-velocity-time (PVT) solution. Type: Output Structure Header 0xB5 0x62 Message Group 0x01 Message Number 0x07 Length (Bytes) 92 Content Checksum See Table 19: BRM-PVT-PVT CHK1 CHK2 Message Content. Table 19: BRM-PVT-PVT Message Content Byte C99 Offset Scaling Name Unit 0 uint32_t - TOW ms Description GPS time of week of the navigation epoch. 4 uint16_t - Year Year Year (UTC). 6 uint8_t - Month Month Month. Range: 1–12 (UTC). 7 uint8_t - Day Day Day of the month. Range: 1–31 (UTC). 8 uint8_t - Hour Hour Hour of the day. Range: 0–23 (UTC). 9 uint8_t - Min Minute Minute of the hour. Range: 0–59 (UTC). 10 uint8_t - 11 uint8_t - 12 uint32_t - Sec Valid TAcc Second Second of the minute. Range: 0–59 (UTC). Validity flags. See - Table 20: Valid Flag Bits. ns Time accuracy estimate (UTC). 16 int32_t - Nano ns Fraction of second. Range: –1e9–1e9 (UTC). LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 51 / 70 GNSS Module Series Byte C99 Offset 20 uint8_t 21 uint8_t 22 uint8_t 23 uint8_t 24 int32_t Scaling Name - FixType 1e-7 Flags Flags2 NumSV Lon Unit Description - Degree GNSS fix type. 0: No fix. 1: Dead reckoning only. 2: Two-dimensional fix. 3: Three-dimensional fix. 4: GNSS plus dead reckoning combined. 5: Time-only fix. Fix status flags. See Table 21: Flags Flag Bits. Additional flags. See Table 22: Flags2 Flag Bits. Number of satellites used in the navigation solution. longitude 28 int32_t 1e-7 Lat Degree Latitude 32 int32_t - Height mm Height above ellipsoid. 36 int32_t - HMSL mm Height above mean sea level. 40 uint32_t - HAcc mm Horizontal accuracy estimate. 44 uint32_t - VAcc mm Reserved. Vertical accuracy estimate. 48 int32_t - VelN mm/s NED north velocity. 52 int32_t - VelE mm/s NED east velocity. 56 int32_t - VelD mm/s NED down velocity. 60 int32_t - GSpeed mm/s Ground speed (two-dimensional). 64 int32_t 1e-5 HeadMot Degree Heading of motion (two-dimensional). 68 uint32_t - SAcc mm/s Reserved. Speed accuracy estimate. Reserved. Heading accuracy estimate (both 72 uint32_t 1e-5 HeadAcc Degree motion and vehicle). 76 uint16_t 0.01 PDOP - Position DOP. 78 uint8_t[6] - Reserved - Reserved. 84 int32_t 1e-5 HeadVeh Degree Heading of vehicle (two-dimensional). LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 52 / 70 GNSS Module Series Byte Offset 88 C99 int16_t Scaling Name Unit Description 1e-2 MagDec Degree Magnetic declination. 90 uint16_t 1e-2 MagAcc Degree Magnetic declination accuracy. Table 20: Valid Flag Bits Name ValidDate ValidTime FullyResolved Flag Bits Description 0 1: Valid UTC date 1 1: Valid UTC time of day. 2 1: UTC time of day that has been fully resolved (no second uncertainty). Table 21: Flags Flag Bits Name GNSS_FixOK Flag Bits 0 Description 1: Valid fix (that is, within DOP and accuracy masks). Table 22: Flags2 Flag Bits Name Reserved Flag Bits 0–4 ConfirmedAvail 5 ConfirmedDate 6 ConfirmedTime 7 Description 1: Valid fix (that is, within DOP and accuracy masks). 1: Information about UTC date and time-of-day validity confirmation is available. 1: UTC date validity that has been confirmed. 1: UTC time of day that has been confirmed. 3.4.6. BRM-PVT-SAT (0x01 0x35) This message displays information about SVs that are either known to be visible or currently tracked by the GNSS device. All signal-related information corresponds to the subset of signals specified in the signal identifiers. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 53 / 70 GNSS Module Series Type: Output Structure Header Message Message Group Number 0xB5 0x62 0x01 0x35 Length (Bytes) 8 + 12 * NumSvs Content Checksum See Table 23: BRM-PVTCHK1 CHK2 SAT Message Content. Table 23: BRM-PVT-SAT Message Content Byte Offset C99 Scaling Name Unit 0 uint32_t - TOW ms 4 uint8_t - Version - Description GPS time of week of the navigation epoch. Message version (0x01). 5 uint8_t - NumSvs - Number of SVs. 6 uint8_t[2] - Reserved1 - Reserved. Start of repeated block (NumSvs times) 8 + 12 * N uint8_t - GNSS_ID 9 + 12 * N uint8_t - 10 + 12 * N uint8_t - 11 + 12 * N int8_t - 12 + 12 * N int16_t 14 + 12 * N int16_t 0.1 SvId CN0 Elev Azim PrRes - dB-Hz Degrees Degrees Meter GNSS identifier. See Table 40: GNSS Satellites (NMEA) Numbering. Satellite identifier. See Table 40: GNSS Satellites (NMEA) Numbering. Carrier-to-noise ratio (signal strength). Elevation (range: -90 to +90), unknown if out of range. Azimuth (range 0–360), unknown if elevation is out of range. Pseudorange residual. 16 + 12 * N uint32_t - Flags - Bit mask. See Table 24: Flags Flag Bits. End of repeated block LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 54 / 70 GNSS Module Series Table 24: Flags Flag Bits Name Flag Bits QualityInd 0–2 SvUsed 3 Health 4–5 Reserved 6–7 OrbitSource 8–10 EphAvail AlmAvail LTOAvail Reserved Reserved Frac_CN0 11 12 13 14 15–26 27–29 Carrier_band 30–31 Description Signal quality indicator: 0: No signal. 1: Searching signal. 2: Signal acquired. 3: Signal detected but unusable. 4: Code locked and time synchronized. 5–7: Code and carrier locked and time synchronized. 1: Signal in the subset specified in signal identifiers is currently being used for PVT. Signal health flag. 0: Unknown. 1: Healthy. 2: Unhealthy. Reserved. Orbit source. 0: No orbit information is available for this SV. 1: Ephemeris is used. 2: Almanac is used. 3: LTO orbit is used. 4: Reserved 5–7: Other orbit information is used. 1: Ephemeris is available for this SV. 1: Almanac is available for this SV. 1: LTO data is available for this SV. Reserved Reserved. Fractional part of the carrier-to-noise ratio (CN0). 0.125 dB-Hz resolution. Carrier band used: 0: L1. 2: L5. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 55 / 70 GNSS Module Series 3.5. Setup Messages (0x06) 3.5.1. BRM-STP-CONFIG (0x06 0x09) Clear, save, and load setups. Type: Command Structure Header 0xB5 0x62 Message Message Group Number 0x06 0x09 Length (Bytes) 13 Content Checksum See Table 25: BRM-STP-CONFIG CHK1 CHK2 Message Content. Table 25: BRM-STP-CONFIG Message Content Byte C99 Scaling Name Unit Offset 0 uint32_t - ClearMask - 4 uint32_t - SaveMask - 8 uint32_t - 12 uint8_t - LoadMask Reserved - Description Mask with setup subsections to clear (that is, load default setups to permanent setups in nonvolatile memory). See Table 26: ClearMask (SaveMask, LoadMask) Flag Bits. Mask with setup subsections to save (that is, to save current setups to nonvolatile memory). See Table 26: ClearMask (SaveMask, LoadMask) Flag Bits. Mask with setup subsections to load (that is, load permanent setups from nonvolatile memory to current setups). See Table 26: ClearMask (SaveMask, LoadMask) Flag Bits. Reserved. Table 26: ClearMask (SaveMask, LoadMask) Flag Bits Name IoPort Flag Bits 0 Description Communications port settings. Modifying this subsection results in an I/O system reset. Because of this, undefined data may be output for a short period of time after receiving the message. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 56 / 70 Name MsgConf InfMsg PVTConf ASCConf Reserved Reserved Reserved Reserved FtsConf GNSS Module Series Flag Bits 1 2 3 4 8 9 10 11 12 Description Message setup. WNG message setup. PVT setup. ASIC (GNSS device) manager setup. Reserved. Reserved. Reserved. Reserved. Frequency and time synchronization (FTS) setup. Not supported. 3.5.2. BRM-STP-CONFIG2 (0x06 0x24) Context settings/getting. Setting the receiver to the right dynamic platform model will improve performance in the expected environment. Or gettting the current cofiguration. Type: Set/Get Structure Header Message Group 0xB5 0x62 0x06 Message Number 0x24 Length (Bytes) 36 Content See Table 27: BRM-STP-CONFIG2 Message Content. Checksum CHK1 CHK2 Table 27: BRM-STP-CONFIG2 Message Content Byte Offset C99 Scaling Name 0 uint16_t - Mask 2 uint8_t - Context Unit Description Parameter bitmask. Only the masked - parameters will be applied. See Table 28: Mask Flag Bits. Dynamic platform model. - 0: Portable (low acceleration, generic model, valid for most use cases). LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 57 / 70 GNSS Module Series Byte Offset C99 Scaling Name 3 uint8_t[15] - Reserved Unit Description 2: Stationary (used for stationary applications). 3: Pedestrian (low speed and low vertical acceleration). 4: Driving (low vertical acceleration). 5: Swimming (zero vertical velocity). 10: Biking (low heading rate of change, low vertical acceleration). - Reserved. 18 uint16_t - PAcc Meter Position accuracy. 20 uint8_t[11] - Reserved - Reserved. Enable blind Galileo search (when 31 uint8_t - BlindGalSearch - LTO is not available). 32 uint8_t[4] - Reserved - Reserved. Table 28: Mask Flag Bits Name Flag Bits Dyn 0 PosMask 4 BlindGalSearch 11 Description 1: Apply dynamic model settings. 1: Apply position accuracy mask setting. 1: Apply blindGalSearch settings. 3.5.3. BRM-STP-MESSAGE (0x06 0x01) 3.5.3.1. Poll a Message Setup Type: Query LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 58 / 70 GNSS Module Series Structure – Poll Request Header Message Group Message Length Number (Bytes) 0xB5 0x62 0x06 0x01 2 Content Checksum See Table 29: BRM-STPMESSAGE Message Content – Poll Request. CHK1 CHK2 Table 29: BRM-STP-MESSAGE Message Content – Poll Request Byte Offset C99 0 uint8_t 1 uint8_t Scaling Name - MsgGrp - MsgNum Unit Description - Message group. - Message number. 3.5.3.2. Set Message Rate Sets/Gets message rate on current port. Type: Set/Get Structure – Set Message Rate Header Message Message Group Number 0xB5 0x62 0x06 0x01 Length (Bytes) 3 Content Checksum See Table 30: BRM-STPMESSAGE Message Content – Set Message Rate. CHK1 CHK2 Table 30: BRM-STP-MESSAGE Message Content – Set Message Rate Byte Offset C99 0 uint8_t 1 uint8_t 2 uint8_t Scaling Name - MsgGrp - MsgNum - Rate Unit Description - Message group. - Message number. - Send rate on current port. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 59 / 70 GNSS Module Series 3.5.3.3. Supported Periodic Messages Table 31: BRM-STP-MESSAGE Message Content – Set Message Rate Message Bytes (Group and Number) Message name 0x0104 BRM-PVT-DOP 0x0107 BRM-PVT-PVT Default State Disabled Disabled 0x0109 0x0135 0x0161 0x0213 0x0215 0xF000 0xF001 0xF002 0xF003 0xF004 0xF005 0xF00D BRM-PVT-ACC_DIST BRM-PVT-SAT BRM-PVT-EOE BRM-ASC-SUBFRAME BRM-ASC-MEAS NMEA_GGA NMEA_GLL NMEA_GSA NMEA_GSV NMEA_RMC NMEA_VTG NMEA_GNS Disabled Disabled Disabled Disabled Disabled Enabled Enabled Enabled Enabled Enabled Enabled Disabled 0xF100 0xF101 0xF102 0xF103 0xF104 0xF105 NMEA_PGLOR_SPD NMEA_PGLOR_FIX NMEA_PGLOR_SAT NMEA_PGLOR_LSQ NMEA_PGLOR_PWR NMEA_PGLOR_STA Disabled Disabled Disabled Disabled Disabled Disabled LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 60 / 70 GNSS Module Series 3.5.4. BRM-STP-ME_SETTINGS (0x06 0x3E) Configures measurement engine channels. Type: Get/Set Structure Header Message Group 0xB5 0x62 0x06 Message Number 0x3E Length (Bytes) Content 4 + 8 * NumConfigBlocks See Table 32: BRMSTP-ME_SETTINGS Message Content. Checksum CHK1 CHK2 Table 32: BRM-STP-ME_SETTINGS Message Content Byte Offset C99 Scaling Name Unit Description 0 uint8_t - MsgVer - Message version (0x00). Reserved. Number of tracking 1 uint8_t - NumTrkChHw - channels available in hardware (read only). Number of tracking channels to use. 2 uint8_t - NumTrkChUse - 4 < NumTrkChUse ≤ NumTrkChHw. 3 uint8_t - NumConfigBlocks - Number of configuration blocks. Start of repeated block (NumConfigBlocks times) 4 + 8 * N uint8_t - GNSS_ID 5 + 8 * N uint8_t - ResTrkCh 6 + 8 * N uint8_t - MaxTrkCh System identifier. See Table 40: GNSS - Satellites (NMEA) Numbering Reserved. Number of reserved - (minimum) tracking channels for this system. Reserved. The maximum number of tracking channels used for this system. The following conditions must be met: ⚫ > 0. - ⚫ ≥ ResTrkCh. ⚫ ≤ NumTrkChUse. ⚫ ≤ The maximum number of tracking channels supported for this system. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 61 / 70 Byte Offset C99 Scaling Name 7 + 8 * N uint8_t - Reserved1 8 + 8 * N uint32_t - Flags End of repeated block GNSS Module Series Unit Description - Reserved. Flag bits. At least one signal must be - configured in every enabled system. See Table 33: Flags Flag Bits. NOTE 1. The maximum number of tracking channels available in hardware (NumTrkChHw) is 32 for LC29D (C) and LC79D (D). 2. The maximum number of tracking channels available in hardware (NumTrkChHw) is 47 for LC29D (F). Table 33: Flags Flag Bits Name Flag Bits Enable 0 SigCfgMask 16 - 23 Description Enable this system. 1 = Enable Signal setup mask. When GNSS_ID is 0 (GPS): ⚫ 0x01: GPS L1 C/A. ⚫ 0x04: GPS L5. When GNSS_ID is 2 (Galileo): ⚫ 0x01: Galileo E1. ⚫ 0x04: Galileo E5. When GNSS_ID is 3 (BDS): ⚫ 0x01: BDS B1 (enabling this signal on an L1-only configuration forces the chip to use more hardware resources and slightly increases the power consumption). ⚫ 0x04: BDS B2a. When GNSS_ID is 5 (QZSS): ⚫ 0x01: QZSS L1 C/A. ⚫ 0x04: QZSS L5. When GNSS_ID is 6 (GLONASS): ⚫ 0x01: GLONASS L1. When GNSS_ID is 7 (NavIC): ⚫ 0x04: NavIC L5. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 62 / 70 GNSS Module Series 3.5.5. BRM-STP-PORT (0x06 0x00) 3.5.5.1. Poll the Setup for One I/O Port Polls the setup for one I/O port. Type: Query Structure – Poll the Setup for One I/O Port Header Message Group 0xB5 0x62 0x06 Message Number 0x00 Length (Bytes) 1 Content See Table 34: BRM-STP-PORT Message Content – Poll the Setup for one I/O Port. Checksum CHK1 CHK2 Table 34: BRM-STP-PORT Message Content – Poll the Setup for one I/O Port Byte Offset C99 0 uint8_t Scaling Name - PortID Unit Description Port ID. - 1 = UART 4 = SPI LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 63 / 70 GNSS Module Series 3.5.5.2. UART Port Setup This message can affect baud rate and other transmission parameters. Because there may be messages queued for transmission, there may be uncertainty about which protocol applies to such messages. In addition, a message currently in transmission may be corrupted by a protocol change. Host data reception parameters may have to be changed to be able to receive future messages, including the acknowledge message resulting from the BRM-STP-PORT message. Type: Set/Get Structure - UART Port Setup Header Message Message Group Number 0xB5 0x62 0x06 0x00 Length (Bytes) 20 Content See Table 35: BRM-STPPORT Message Content UART Port Setup. Checksum CHK1 CHK2 Table 35: BRM-STP-PORT Message Content - UART Port Setup Byte Offset C99 Scaling Name Unit 0 uint8_t - PortID - 1 uint8_t - Reserved - 2 uint16_t - Reserved - 4 uint32_t - Mode - 8 uint32_t - BaudRate bps 12 uint16_t - Reserved - 14 uint16_t - OutProtoMask - 16 uint16_t - Flags - 18 uint8_t[2] - Reserved - Description Port ID. 1 = UART Reserved. Reserved. Hard coded as 8N1. Baud rate. Reserved. Fixed as 3. Flags bit mask. See Table 36: Flags Flag Bits. Reserved. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 64 / 70 Table 36: Flags Flag Bits Name Flag Bits ExtendedTxTimeout 1 GNSS Module Series Description Extended TX timeout. 0: The port will timeout if there is no activity for 1.5 s, regardless of the amount of allocated TX memory. 1: The port will timeout if the allocated TX memory ≥ 4 KB and there is no activity for 1.5 s. 3.5.6. BRM-STP-RESET (0x06 0x04) Resets device and clear backup data structures. Type: Command Structure Header 0xB5 0x62 Message Message Group Number 0x06 0x04 Length (Bytes) 4 Content Checksum See Table 37: BRM-STP-RESET CHK1 CHK2 Message Content. Table 37: BRM-STP-RESET Message Content Byte C99 Scaling Name Unit Offset 0 uint16_t - NavBbrMask - 2 uint8_t - ResetMode - 3 Uint8_t - Reserved - Description On-chip persistent data sections to clear. The following special sets apply: 0x0000: Hot start. 0x0001: Warm start. 0xFFFF: Cold start. See Table 38: NavBbrMask Flag Bits Reset Type. 0x01: Controlled software reset. 0x02: Controlled software reset (GNSS only). 0x08: Controlled GNSS stop. 0x09: Controlled GNSS start. Reserved. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 65 / 70 Table 38: NavBbrMask Flag Bits Name Eph Alm Reserved Reserved Pos Clkd Reserved UTC RTC Flag Bits 0 1 2 3 4 5 6 7 8 GNSS Module Series Description Ephemeris. Almanac. Reserved. Reserved. Position. Clock drift. Reserved. UTC correction plus GPS leap-seconds parameters. RTC. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 66 / 70 GNSS Module Series 4 Appendix A References Table 39: Terms and Abbreviations Abbreviation Description 2D 2 Dimension 3D 3 Dimension C99 ISO/IEC 9899:1999 - Programming languages – C DOP Dilution of Precision DR Dead Reckoning FTS Frequency and time synchronization ICD Interface Control Document GGA Global Positioning System Fix Data GLL Geographic Position - Latitude and Longitude GNS Global Network Service GPS Global Positioning System GSA GPS DOP and Active Satellites GSV GPS Satellites in View HDOP Horizontal Dilution of Precision HULA Heading, UTC, Location, Altitude LMS Location Manager Service LS Location Service LSQ Least Squares LTO Long Term Orbit LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 67 / 70 Abbreviation NED NMEA PDOP PPS PVT RMC RMS RTK SV TOW UTC VDOP VTG WN WNG GNSS Module Series Description North, East, Down NMEA (National Marine Electronics Association) 0183 Interface Standard Position Dilution of Precision Pulse Per Second Position Velocity Time Recommended Minimum Specific GNSS Data Root Mean Square Real Time Kinematic Satellite in View Time of Week Coordinated Universal Time Vertical Dilution of Precision Course Over Ground and Ground Speed Week Number Warning LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 68 / 70 GNSS Module Series 5 Appendix B GNSS (NEMA) Numbering Table 40: GNSS Satellites (NMEA) Numbering GNSS Type System ID GNSS_ID in Bream Satellite ID GPS 1 0 1–32 GLONASS 2 6 65–96 Galileo 3 2 1–36 BDS 4 3 1–46 QZSS 5 5 NavIC 6 7 (IRNSS) 1–10 1–15 Signal ID 1 = L1 C/A 8 = L5-Q 1 = L1 C/A 1 = E5a 7 = E1 B/C 1 = B1I 5 = B2a 1 = L1 C/A 8 = L5-Q 1 = L5 LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 69 / 70 GNSS Module Series 6 Appendix C Special Characters Table 41: Special Characters Special Character [...] {…} Underline Definition Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. LC29D_Series&LC79D(D)_GNSS_Protocol_Specification 70 / 70

LG69T (AA,AD,AF,AI,AJ,AR) GNSS Protocol Specification GNSS Module Series Version: 1.3 Date: 2023-10-19 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 1 / 79 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 2 / 79 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LG69T (AA,AD,AF,AI,AJ,AR) GNSS Protocol Specification GNSS Module Series GNSS Protocol Specification Released Revision History Version Date Description - 2022-05-24 Creation of the document 1.0 2022-09-30 First official release 1.1 2022-10-14 Added the applicable variant: LG69T (AF) 1. Added the applicable variant: LG69T (AR). 2. Added the Sample Code for NMEA Checksum (Chapter 2.1) 3. Added the introduction on structure of RTCM3 protocol format. (Chapter 3.1) 1.2 2023-08-11 4. Updated the format of data representation for all proprietary RTCM messages. (Chapter 3.4) 5. Added DF95P field in RSS message. (Chapter 3.4.1) 6. Added a note to explain the positive values in the Longitude and Latitude parameters. (Chapter 3.4.6) 1. Added the note that the LG69T (AA) and LG69T (AJ) with IMU standalone solution do not support SENS message. (Chapters 3.4 and 3.4.10) 1.3 2023-10-19 2. Add the note to remind that the non-default frequencies have not been tested systematically. (Chapter 6.1.4) LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 3 / 79 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index .................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 Introduction ......................................................................................................................................... 8 2 NMEA Protocol .................................................................................................................................. 10 Structure of NMEA Protocol Messages................................................................................ 10 Standard Messages ............................................................................................................. 12 2.2.1. RMC .............................................................................................................................. 12 2.2.2. GGA............................................................................................................................... 14 2.2.3. GSV ............................................................................................................................... 17 2.2.4. GSA ............................................................................................................................... 19 2.2.5. VTG ............................................................................................................................... 21 2.2.6. GLL................................................................................................................................ 23 2.2.7. ZDA ............................................................................................................................... 25 PSTM Messages .................................................................................................................. 26 2.3.1. PSTMCOLD .................................................................................................................. 26 2.3.2. PSTMWARM ................................................................................................................. 27 2.3.3. PSTMHOT..................................................................................................................... 28 2.3.4. PSTMSRR..................................................................................................................... 28 2.3.5. PSTMSAVEPAR ............................................................................................................ 29 2.3.6. PSTMRESTOREPAR.................................................................................................... 30 2.3.7. PSTMPPSDATA ............................................................................................................ 30 2.3.8. PSTMCPU..................................................................................................................... 33 2.3.9. PSTMTG ....................................................................................................................... 34 2.3.10. PSTMTS ........................................................................................................................ 38 2.3.11. PSTMSBAS................................................................................................................... 40 2.3.12. PSTMSETCONSTMASK .............................................................................................. 41 3 RTCM Protocol .................................................................................................................................. 44 Structure of RTCM3 Protocol Messages.............................................................................. 44 RTCM Data Fields ................................................................................................................ 45 3.2.1. Supported Frequency Bands ........................................................................................ 51 3.2.2. Signal Identifier (DF82P) and Tracking Mode (DF86P) ................................................ 54 Standard RTCM Messages .................................................................................................. 56 Proprietary RTCM Messages ............................................................................................... 57 3.4.1. RSS (Subtype ID = 1) ................................................................................................... 58 3.4.2. RCC (Subtype ID = 2) ................................................................................................... 59 3.4.3. PVT (Subtype ID = 4) .................................................................................................... 61 3.4.4. POSQM (Subtype ID = 5) ............................................................................................. 62 3.4.5. RESP (Subtype ID = 19) ............................................................................................... 62 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 4 / 79 GNSS Module Series 3.4.6. 3.4.7. 3.4.8. 3.4.9. 3.4.10. EPVT (Subtype ID = 21) ............................................................................................... 63 RFS (Subtype ID = 24).................................................................................................. 66 FWVER (Subtype ID = 25)............................................................................................ 66 SIGQM2 (Subtype ID = 26)........................................................................................... 66 SENS (Subtype ID = 64) ............................................................................................... 66 4 Appendix A References .................................................................................................................... 69 5 Appendix B GNSS Satellites (NMEA) Numbering ......................................................................... 72 6 Appendix C Example ........................................................................................................................ 73 Basic Command ................................................................................................................... 73 6.1.1. Restart Receiver ........................................................................................................... 73 6.1.2. Debug Serial Port .......................................................................................................... 74 6.1.3. Query Software Version ................................................................................................ 74 6.1.4. Configure Raw Observation Data Output Frequency ................................................... 75 6.1.5. Supported Frequency Setting ....................................................................................... 76 6.1.6. Change Baud Rate with NMEA Command ................................................................... 77 6.1.7. Change Baud Rate with RTCM Command................................................................... 78 7 Appendix D Special Characters ...................................................................................................... 79 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 5 / 79 GNSS Module Series Table Index Table 1: Applicable Variants and Supported Frequency Bands................................................................... 8 Table 2: Supported Protocols ....................................................................................................................... 8 Table 3: Structure of NMEA Protocol Message.......................................................................................... 10 Table 4: NMEA Talker ID .............................................................................................................................11 Table 5: Field Description of RTCM3 Protocol Messages ......................................................................... 44 Table 6: Data Field Table............................................................................................................................ 45 Table 7: Constellation Mask (SatType) ...................................................................................................... 51 Table 8: Multi-Frequency/Tracking Mode Mask ......................................................................................... 52 Table 9: Signal ID Constellation Encoding ................................................................................................. 54 Table 10: Satellite Type and Selector......................................................................................................... 55 Table 11: Supported RTCM3 Messages .................................................................................................... 56 Table 12: Chipset Supplier Proprietary RTCM Message List .................................................................... 57 Table 13: Response Meaning..................................................................................................................... 63 Table 14: Message Frame for Sensor Common (Sensor type = 0x00) ..................................................... 67 Table 15: Message Frame for Odometer - Reverse (Sensor type = 0x03) ............................................... 67 Table 16: Message Frame for Accelerometer (Sensor type = 0x1E)......................................................... 67 Table 17: Message Frame for Gyroscope (Sensor type = 0x1F)............................................................... 68 Table 18: Related Document...................................................................................................................... 69 Table 19: Terms and Abbreviations ............................................................................................................ 69 Table 20: GNSS Satellites (NMEA) Numbering ......................................................................................... 72 Table 21: Supported Frequency Setting..................................................................................................... 76 Table 22: Special Characters ..................................................................................................................... 79 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 6 / 79 GNSS Module Series Figure Index Figure 1: Structure of NMEA Protocol Message ........................................................................................ 10 Figure 2: Structure of RTCM3 Protocol Messages .................................................................................... 44 Figure 3: Signal ID (DF82P) Structure ....................................................................................................... 54 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 7 / 79 GNSS Module Series 1 Introduction Quectel LG69T GNSS module is a multi-constellation module. Concurrent tracking of multi-frequency bands provides fast and accurate acquisition and makes this module an ideal solution for positioning and navigation in various vertical markets. See table below for the actual frequency bands supported by each variant. Table 1: Applicable Variants and Supported Frequency Bands Variant LG69T (AA) Frequency Band GPS L1/L5, Galileo E1/E5a, BDS B1I/B2a, QZSS L1/L5 LG69T (AD) GPS L1/L5, Galileo E1/E5a, BDS B1I/B2a, QZSS L1/L5 LG69T (AF) LG69T (AI) LG69T (AJ) GPS L1/L5, Galileo E1/E5a, BDS B1I/B2a, QZSS L1/L5 GPS L1/L2/L5, GLONASS L1/L2, Galileo E1/E5a/E5b, BDS B1I/B2a/B2I, QZSS L1/L2/L5 GPS L1/L5, Galileo E1/E5a, BDS B1I/B2a, QZSS L1/L5 LG69T (AR) GPS L1/L5, Galileo E1/E5a, BDS B1I/B2a, QZSS L1/L5 This document describes the software commands that are used to control and modify the module configuration. The software commands are NMEA proprietary commands (PSTM Messages) defined by the chipset supplier. To report GNSS information, the module supports outputting messages in NMEA 0183 standard protocol or RTCM protocol format. Table 2: Supported Protocols Protocol NMEA 0183 V4.11 Type Output, ASCII, standard Input/output, ASCII, proprietary RTCM 10403.3 Input/output, binary, standard Input/output, binary, proprietary LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 8 / 79 GNSS Module Series NOTE 1. Only LG69T (AD) and LG69T (AF) support NMEA messages. 2. Quectel assumes no responsibility if commands other than the ones listed herein are used. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 9 / 79 GNSS Module Series 2 NMEA Protocol Structure of NMEA Protocol Messages Start of sentence character. Always Address field - contains talker identifier and sentence formatter Starts with a * 8-bit checksum value converted to two ASCII characters Data field(s), delimited by , End of sentence. Always $ () [,] * Range for checksum calculation Figure 1: Structure of NMEA Protocol Message Table 3: Structure of NMEA Protocol Message Field $ Description Start of sentence (Hex 0x24). In Standard Messages: In standard messages, this field consists of a two-character talker identifier (TalkerID) and a three-character sentence formatter (SentenceFormatter). The talker identifier identifies the data type of talker. For more information on the TalkerID, see Table 4: NMEA Talker ID. The sentence formatter identifies the data type and the string format of the successive fields. In Proprietary Messages: In proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer’s Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 10 / 79 GNSS Module Series Field Description Data fields, delimited by data field delimiter ‘,’. Variable length (depends on the NMEA message type). Checksum field follows the checksum delimiter character *. Checksum is the 8-bit exclusive OR of all characters in the sentence, including ‘,’ the field delimiter, between but not including the $ and the * delimiters. End of sentence (Hex 0x0D 0x0A). Table 4: NMEA Talker ID GNSS Constellation Configuration GPS Galileo BDS QZSS Combination of Multiple Satellite Systems TalkerID (NMEA V4.11) GP GA GB GQ GN NMEA Checksum Sample Code: // pData is the data array whose checksum needs to be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL == pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^= *(pData + i); } return result; } LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 11 / 79 GNSS Module Series Standard Messages This chapter explains the standard NMEA 0183 V4.11 messages supported by LG69T (AD) and LG69T (AF). 2.2.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type: Output Synopsis: $RMC,,,,,,,,,,,,,* Parameter: Field $ RMC Format Unit Character - String, 2 characters - String, 3 characters - hhmmss.sss - Character - ddmm.mmmmmm - Example Description $ Each NMEA message starts with $. GN RMC 032753.000 A 3149.333250 Always 'GN' in NMEA 0183 V4.11. Recommended Minimum Specific GNSS Data. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status: A = Data valid V = Navigation receiver warning Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 12 / 79 GNSS Module Series Field Format Character dddmm.mmmmmm Character Numeric Numeric ddmmyy - Character Unit - - Knot Degree - - Example Description N 11706.946888 E 0.028 0.00 200422 North-south direction. N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. East-west direction. E = East W = West Note that this field is empty in case of an invalid value. Speed over ground. Variable length. Note that this field is empty in case of an invalid value. Course over ground. Variable length. Maximum value: 359.99. Note that this field is empty in case of an invalid value. Date: dd: Day of month mm: Month yy: Year - Magnetic variation. Not supported. Direction of magnetic variation. - Not supported. Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite D system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) E = Estimated (dead reckoning) LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 13 / 79 GNSS Module Series Field Format Character Hexadecimal Character Unit Example - C - *2F - - Description mode M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid Navigational status: S = Safe C = Caution U = Unsafe V = Navigational status not valid, equipment is not providing navigational status indication. Checksum. Carriage return and line feed. Example: $GNRMC,032753.000,A,3149.333250,N,11706.946888,E,0.028,0.00,200422,,,D,C*2F NOTE 1. RMC sentence is enabled by default. $PSTMSETPAR can be used to enable or disable the output of RMC sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable RMC sentence: $PSTMSETPAR,32,3,0,1,0x40*48 $PSTMSAVEPAR*58 //Disable RMC sentence: $PSTMSETPAR,32,3,0,2,0x40*4B $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.2. GGA Global Positioning System Fix Data, Time, position and fix-related data for a GNSS receiver. Type: Output LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 14 / 79 GNSS Module Series Synopsis: $GGA,,,,,,,,,,M,,M,,* Parameter: Field $ GGA Format Unit Character - String, 2 characters - String, 3 characters - hhmmss.sss - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - Numeric, 1 digit - Example Description $ Each NMEA message starts with $. GN Always 'GN' in NMEA 0183 V4.11. GGA 034221.000 3149.332992 N 11706.946415 E 2 Global Positioning System Fix Data. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. North-south direction. N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. East-west direction. E = East W = West Note that this field is empty in case of an invalid value. GPS quality indicator: 0 = Fix not available or invalid LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 15 / 79 GNSS Module Series Field Format Unit Example 1) Numeric, 2 digits - 25 Numeric - 0.6 Numeric Meter 49.3 M Character - M Numeric Meter -0.3 M Character Hexadecimal Character - M - - - - - *63 - - Description 1 = GPS SPS Mode, fix valid 2 = Differential GPS, SPS Mode, or Satellite Based Augmentation System (SBAS), fix valid 3 = GPS PPS Mode, fix valid 6 = Estimated (dead reckoning) mode Number of satellites in use. Horizontal dilution of precision. Altitude above mean-sea-level (geoid). Note that this field is empty in case of an invalid value. Unit of . M = Meter. Geoid separation (the difference between the earth ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). Note that this field is empty in case of an invalid value. Unit of . M = Meter. Differential GPS data age. Not supported. Differential reference station ID. Not supported. Checksum. Carriage return and line feed. Example: $GNGGA,034221.000,3149.332992,N,11706.946415,E,2,25,0.6,49.3,M,-0.3,M,,*63 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 16 / 79 GNSS Module Series NOTE 1. The NMEA 0183 specification indicates that the GGA messages are GPS specific. However, when the receiver is configured for multiple constellations, the content of GGA messages will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12. 3. GGA sentence is enabled by default. $PSTMSETPAR can be used to enable or disable the output of GGA sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable GGA sentence: $PSTMSETPAR,32,3,0,1,0x2*7E $PSTMSAVEPAR*58 //Disable GGA sentence: $PSTMSETPAR,32,3,0,2,0x2*7D $PSTMSAVEPAR*58 4. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.3. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value, and contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of transmitted sentences and the sentence number are indicated in the first two data fields. Type: Output Synopsis: $GSV,,,{,,,,}, * LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 17 / 79 GNSS Module Series Parameter: Field Format Unit Example Description $ Character - String, 2 characters - GSV String, 3 characters - Numeric - Numeric - Numeric - $ GB GSV 4 1 14 Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. GNSS satellites in view. Total number of sentences. Range: 1–9. Sentence number. Range: 1–. Total number of satellites in view. Start of repeat block. Repeat times: 1–4. Numeric - 39 Numeric Degree 70 Numeric Numeric End of repeat block. Numeric Hexadecimal Degree 326 dB-Hz 39 - 1 - *7E Satellite ID. See Table 20: GNSS Satellites (NMEA) Numbering. Satellite elevation. Range: 00–90. Note that this field is empty in case of an invalid value. Satellite azimuth, with true north as the reference plane. Range: 000–359. Note that this field is empty in case of an invalid value. Satellite SNR (C/N0). Range 00–99. Null when not tracking. GNSS signal ID. See Table 20: GNSS Satellites (NMEA) Numbering. Checksum. Character - - Carriage return and line feed. Example: $GPGSV,1,1,03,10,,,33,23,,,33,18,,,33,,,,,1*6E $GBGSV,4,1,14,39,70,326,39,16,68,295,38,08,68,192,36,06,66,284,36,1*7E $GBGSV,4,2,14,20,63,009,40,38,56,177,38,37,56,090,39,03,53,193,36,1*72 $GBGSV,4,3,14,09,52,262,34,01,43,135,34,32,32,088,36,04,31,119,31,1*75 $GBGSV,4,4,14,05,19,254,28,29,18,246,33,,,,,,,,,1*75 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 18 / 79 $GPGSV,1,1,03,10,,,30,23,,,37,18,,,35,,,,,8*66 $GBGSV,2,1,05,38,,,33,20,,,34,37,,,35,39,,,33,5*72 $GBGSV,2,2,05,32,,,30,,,,,,,,,,,,,5*75 GNSS Module Series NOTE 1. GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, GSV sentences are output with the corresponding talker ID for each constellation, respectively. 2. GSV sentence is enabled by default. $PSTMSETPAR can be used to enable or disable the output of GSV sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable GSV sentence: $PSTMSETPAR,32,3,0,1,0x80000*74 $PSTMSAVEPAR*58 //Disable GSV sentence: $PSTMSETPAR,32,3,0,2,0x80000*77 $PSTMSAVEPAR*58 3. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.4. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA sentence, and DOP values. Type: Output Synopsis: $GSA,,{,},,,* Parameter: Field $ GSA Format Unit Character - String, 2 characters - String, 3 characters - Character - Example Description $ Each NMEA message starts with $. GN Always 'GN' in NMEA 0183 V4.11. GSA A GNSS DOP and Active Satellites. Selection of 2D or 3D fix. M = Manual, forced to operate in 2D or LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 19 / 79 GNSS Module Series Field Format Unit Numeric - Start of repeat block. Repeat times: 12. Numeric - End of repeat block. Numeric - Numeric - Numeric - Numeric - Hexadecimal - Character - Example Description 3D mode. A = Automatic, allowed to automatically switch to 2D or 3D mode. Fix mode. 1 = Fix not available 3 2 = 2D 3 = 3D ID numbers of satellites used in solution. See Table 20: GNSS Satellites (NMEA) - Numbering. Note that this field is empty in case of an invalid value. Position dilution of precision. 2.0 Maximum value: 99.0. Horizontal dilution of precision. 1.1 Maximum value: 99.0. Vertical dilution of precision. 1.7 Maximum value: 99.0. GNSS system ID. 1 See Table 20: GNSS Satellites (NMEA) Numbering. *35 Checksum. - Carriage return and line feed. Example: $GNGSA,A,3,,,,,,,,,,,,,2.0,1.1,1.7,1*35 $GNGSA,A,3,,,,,,,,,,,,,2.0,1.1,1.7,5*31 $GNGSA,A,3,,,,,,,,,,,,,2.0,1.1,1.7,3*37 $GNGSA,A,3,01,06,16,03,20,37,39,32,38,29,08,09,2.0,1.1,1.7,4*3F LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 20 / 79 GNSS Module Series NOTE 1. If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used, multiple GSA sentences containing all satellite IDs will be output. 2. GSA sentence is enabled by default. $PSTMSETPAR can be used to enable or disable the output of GSA sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable GSA sentence: $PSTMSETPAR,32,3,0,1,0x4*78 $PSTMSAVEPAR*58 //Disable GSA sentence $PSTMSETPAR,32,3,0,2,0x4*7B $PSTMSAVEPAR*58 3. After issuing the enable/disable command, the module needs to be restarted for the command to take effect 2.2.5. VTG Course Over Ground & Ground Speed. The actual course and speed relative to the ground. Type: Output Synopsis: $VTG,,T,,M,,N,,K,* Parameter: Field $ VTG T Format Unit Example Description Character - $ Each NMEA message starts with $. String, 2 characters - GN Always 'GN' in NMEA 0183 V4.11. String, 3 characters - VTG Numeric Degrees 0.00 Character Numeric - T Degrees - Course Over Ground & Ground Speed. Course over ground, in true north course direction. Note that this field is empty in case of an invalid value. Fixed field: true. Course over ground (magnetic). Not supported. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 21 / 79 GNSS Module Series Field M N Format Character Numeric Character Numeric K Character Character Hexadecimal Character Unit Knots km/h - - - Example Description M 0.048 N 0.089 K D *2B Fixed field: magnetic. Speed over ground in knots. Note that this field is empty in case of an invalid value. Fixed field: knot. Speed over ground in kilometers per hour. Note that this field is empty in case of an invalid value. Fixed field: kilometers per hour. Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) E = Estimated (dead reckoning) mode. M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid Checksum. - Carriage return and line feed. Example: $GNVTG,0.00,T,,M,0.048,N,0.089,K,D*2B LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 22 / 79 GNSS Module Series NOTE 1. VTG sentence is enabled by default. $PSTMSETPAR can be used to enable or disable the output of VTG sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR //Enable VTG sentence: $PSTMSETPAR,32,3,0,1,0x10*4D $PSTMSAVEPAR*58 //Disable VTG sentence: $PSTMSETPAR,32,3,0,2,0x10*4E $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.6. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type: Output Synopsis: $GLL,,,,,,,* Parameter: Field $ GLL Format Unit Example Character - $ String, 2 characters - GN String, 3 characters - GLL ddmm.mmmmmm - 3149.33372 Character - N Description Each NMEA message starts with $. Always 'GN' in NMEA 0183 V4.11. Geographic Position – Latitude/ Longitude. Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. North-south direction. N = North S = South LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 23 / 79 GNSS Module Series Field Format dddmm.mmmmmm Character hhmmss.sss Character Character Hexadecimal Unit Example - 11706.94794 - E - 065910.000 - A - A - *43 Description Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. East-west direction. E = East W = West Note that this field is empty in case of an invalid value. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status: A = Data valid V = Data not valid. Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) E = Estimated (dead reckoning) mode. M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid Checksum. Character - - Carriage return and line feed. Example: $GNGLL,3149.33372,N,11706.94794,E,065910.000,A,A*43 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 24 / 79 GNSS Module Series NOTE 1. GLL sentence is enabled by default. $PSTMSETPAR can be used to enable or disable the output of GLL sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable GLL sentence: $PSTMSETPAR,32,3,0,1,0x100000*4D $PSTMSAVEPAR*58 //Disable GLL sentence: $PSTMSETPAR,32,3,0,2,0x100000*4E $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.2.7. ZDA Time & Date. UTC, day, month, year and local time zone. Type: Output Synopsis: $ZDA,,,,,,* Parameter: Field $ ZDA Format Unit Example Description Character - $ Each NMEA message starts with $. String, 2 characters String, 3 characters - hhmmss.sss - Numeric - GN ZDA 051634.000 20 Always 'GN' in NMEA 0183 V4.11. Time & Date. UTC, day, month, year, and local time zone. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Day of month. Range: 01–31. Numeric - 04 Month. Range: 01–12. Numeric - 2022 Year. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 25 / 79 GNSS Module Series Field Format Numeric Numeric Hexadecimal Character Unit Example - - - - - *49 - - Description Local zone hours, 00 to ±13 hours. Not supported. Local zone minutes, 00 to +59 minutes. Not supported. Checksum. Carriage return and line feed. Example: $GNZDA,051634.000,20,04,2022,,*49 NOTE 1. ZDA sentence is disabled by default. $PSTMSETPAR can be used to enable or disable the output of ZDA sentence as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable ZDA sentence: $PSTMSETPAR,32,3,0,1,0x1000000*7D $PSTMSAVEPAR*58 //Disable ZDA sentence: $PSTMSETPAR,32,3,0,2,0x1000000*7E $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. PSTM Messages This chapter explains the PSTM messages (proprietary NMEA messages defined by the chipset supplier) supported by LG69T (AD) and LG69T (AF). 2.3.1. PSTMCOLD Performs a cold start. Type: Command LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 26 / 79 Synopsis: $PSTMCOLD* Parameter: None Result: Cold start initialization and GNSS engine restart. 1) Example: $PSTMCOLD*1E NOTE 1) The GNSS engine will be reset. It is not a system reboot. 2.3.2. PSTMWARM Performs a warm start. Type: Command Synopsis: $PSTMWARM* Parameter: None Result: Warm start initialization and GNSS engine restart. 1) Example: $PSTMWARM*13 GNSS Module Series LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 27 / 79 NOTE 1) The GNSS engine will be reset. It is not a system reboot. 2.3.3. PSTMHOT Performs a hot start. Type: Command Synopsis: $PSTMHOT* Parameter: None Result: Hot start initialization and GNSS engine restart. 1) Example: $PSTMHOT*49 NOTE 1) The GNSS engine will be reset. It is not a system reboot. 2.3.4. PSTMSRR Executes a system reset and reboots the GNSS firmware. Type: Command Synopsis: $PSTMSRR* LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification GNSS Module Series 28 / 79 Parameter: None Result: ⚫ System is reset and the GNSS firmware is rebooted. ⚫ No message is sent as a reply. Example: $PSTMSRR*49 2.3.5. PSTMSAVEPAR Saves current configuration data block to NVM. Type: Command Synopsis: $PSTMSAVEPAR* Parameter: None Result: ⚫ If successful, the module returns: $PSTMSAVEPAROK* ⚫ If failed, the module returns: $PSTMSAVEPARERROR* Example: $PSTMSAVEPAR*58 $PSTMSAVEPAROK*5C GNSS Module Series LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 29 / 79 GNSS Module Series 2.3.6. PSTMRESTOREPAR Restores the factory setting parameters. The configuration data block stored in NVM, if present, will be invalidated. Any changed parameter will be lost. Type: Command Synopsis: $PSTMRESTOREPAR* Parameter: None Result: ⚫ If successful, the module returns: $PSTMRESTOREPAROK* ⚫ If failed, the module returns: $PSTMRESTOREPARERROR* Example: $PSTMRESTOREPAR*11 $PSTMRESTOREPAROK*15 NOTE The factory setting parameters will be restored and the configuration block in the NVM will be lost. A system reboot is needed to complete the factory reset restoring. 2.3.7. PSTMPPSDATA Outputs the PPS (Pulse Per Second) data. Type: Output LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 30 / 79 GNSS Module Series Synopsis: $PSTMPPSDATA,,,,,,,,,,,,,,,,,,,,,,,,,,,* Parameter: Field Format Unit Numeric Numeric Numeric Numeric - Numeric - Numeric Numeric Second Description PPS signal status: 0 = OFF 1 = ON Global PPS validity flag: 0 = Invalid 1 = Valid PPS synchronization validity: 0 = Invalid 1 = Valid PPS generation mode: 0 = PPS always generated 1 = PPS generated on even seconds 2 = PPS generated on odd seconds PPS refence time: 0 = UTC 1 = GPS UTC 2–4 = Reserved 5 = BDS UTC 6 = UTC (NTSC) 7 = Galileo 8 = UTC Galileo 9 = GPS from Galileo Refence constellation: 0 = GPS 1 = Reserved 3 = Galileo 7 = BDS Pulse duration. Numeric Nanosecond Pulse delay. Numeric Nanosecond GPS path RF delay. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 31 / 79 Field GNSS Module Series Format Unit Description - - - Numeric Nanosecond BDS path RF delay. Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Nanosecond - - - Galileo path RF delay. Pulse polarity inversion: 0 = Not inverted 1 = Inverted Selected GNSS fix condition for PPS signal generation: 0 or 1 = No fix 2 = 2D fix 3 = 3D fix Selected minimum number of satellites for PPS signal generation. Selected minimum satellite elevation for time correction. Satellite constellation bitmask for timing filtering: Bit 0 = GPS Bit 1 = Reserved Bit 2 = QZSS Bit 3 = Galileo Bit 4–6 = Reserved Bit 7 = BDS Bit 8–10 = Reserved Bit 11 = GPS L5 Bit 12 = Galileo E5a Bit 13 = Reserved Bit 14 = BDS B2a Bit 15 = Reserved Second at which the reported PPS data is applied. According to the reference time configuration, it could be UTC, GPS, or BDS time second. GNSS position fix status when the time has been corrected. Used satellites for time correction. Numeric Second UTC leap seconds. Numeric Nanosecond UTC–GPS delta time. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 32 / 79 GNSS Module Series Field Format Unit Description - - - Numeric Nanosecond UTC–Galileo delta time. Numeric Second Quantization error. Numeric Hz PPS clock frequency. Numeric Hz TCXO clock frequency. Numeric Second UTC–BDS leap second. Example: $PSTMPPSDATA,1,1,1,0,1,0,0.500000,0,350,305,818,841,0,0,0,0,22665,40,3,17,18,0,0,0,1.432e09,65473968.17,26000003.91,4*11 NOTE 1. $PSTMPPSDATA is disabled by default. $PSTMSETPAR can be used to enable or disable the output of $PSTMPPSDATA as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMPPSDATA: $PSTMSETPAR,32,3,0,1,0x200000*4E $PSTMSAVEPAR*58 //Disable $PSTMPPSDATA: $PSTMSETPAR,32,3,0,2,0x200000*4D $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.8. PSTMCPU Outputs the real-time CPU usage and the CPU speed setting. Type: Output Synopsis: $PSTMCPU,,,* LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 33 / 79 Parameter: Field Format Numeric Numeric Hexadecimal Example: $PSTMCPU,51.47,0,261*5C Unit MHz GNSS Module Series Description CPU usage in percentage (%). PLL status: 0 = PLL disabled 1 = PLL enabled -1 = Not supported CPU clock frequency. NOTE 1. $PSTMCPU is disabled by default. $PSTMSETPAR can be used to enable or disable the output of $PSTMCPU as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMCPU: $PSTMSETPAR,32,3,0,1,0x800000*44 $PSTMSAVEPAR*58 //Disable $PSTMCPU: $PSTMSETPAR,32,3,0,2,0x800000*47 $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.9. PSTMTG Outputs time and satellite information. Type: Output Synopsis: $PSTMTG,,,,,,,,,,,,,,,,,,,,* LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 34 / 79 Parameter: Field GNSS Module Series Format Numeric Numeric Numeric Unit Second - Numeric - Numeric Hz Hexadecimal - Description Week number. Time of week. - CPU time. Valid time: 0 = No time 1 = Time read from flash 2 = TOW time (week number not available) 3 = Time set by user 4 = Time set by user RTC 5 = Approximate RTC time 6 = Accurate RTC time 7 = Approximate time 8 = Accurate time 9 = Position time 10 = Ephemeris time Estimated receiver clock drift. If clock steering is enabled, this value shall be used in the Doppler calculation (instead of the nominal values). Configuration status: ⚫ Byte 0: Kalman filter configuration. Note: 0 means feature disabled and 1 means feature enabled for all bits of Byte 0, unless otherwise specified. Bit 0: Walking mode Bit 1: Stop detection Bit 2: Frequency ramp Bit 3: Velocity estimator model 1 = Multiple model 0 = Single model Bit 4: Velocity estimator filter 1 = Slow 0 = Fast Bit 5: FDE status ⚫ Byte 1: Global configuration. Bit 0–3: Front end frequency LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 35 / 79 GNSS Module Series Field Format Unit Numeric - Numeric Numeric Numeric Numeric Numeric Second Numeric - Description 1 = 48 MHz 0 = 26 MHz Bit 4–6: $PSTMTG, $PSTMTS version Bit 7: Clock steering indicator 1 = Steered 0 = No Bitmask where each bit enables/disables a specific constellation independently of the others: Bit 0: GPS constellation enabling/disabling Bit 1: Reserved Bit 2: QZSS constellation enabling/disabling Bit 3: Galileo constellation enabling/disabling Bit 4–6: Reserved Bit 7: BDS constellation enabling/disabling Bit 8–15: Reserved Selected best time satellite type. Master time satellite type. Master time week number. Master time TOW. Master week number time validity. Additional flags and status: Bit 0: TCXO jump detected Bit 1: Earth rotation correction in satellite position 0 = Legacy 1 = Without earth rotation Bit 2: Spectral inversion 0 = Legacy (BDS inverted) 1 = Spectral inversion internally compensated Bit 3: Clock bias validity 0 = Invalid (legacy) 1 = Valid Bit 4: Indicates presence of field Bit 5: Satellite Data 0 = Satellite data present 1 = No satellite data in $PSTMTS LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 36 / 79 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit Meter Description Bit 6: MTB timestamp 0 = No MTB timestamp 1 = Observable MTB timestamp presents Bit 7: OSCI32 output status 0 = Unable to output 1 = Normal output Bit 8–31: Reserved Estimated receiver clock bias. Second Millisecond Picosecond Multi-frequency configuration mask. Leap seconds: 0 = Unknown -1 = Invalid PPS edge counter @ 64F0 resolution. Master time-base. Number of milliseconds since time reference. Master time-base. Fixed-point fractional precision in picosecond. Example: $PSTMTG,2206,283972.00000004,0,4168902594,9,-47355.8601,a02a,88205,0,0,2206,283972.000000 04,10,126,9.026,-2147483507,18,708337484,4075040,864102909*04 NOTE 1. $PSTMMTG is disabled by default. $PSTMSETPAR can be used to enable or disable the output of $PSTMMTG as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMTG: $PSTMSETPAR,32,4,0,1,0x100*7A $PSTMSAVEPAR*58 //Disable $PSTMTG: $PSTMSETPAR,32,4,0,2,0x100*79 $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 37 / 79 GNSS Module Series 2.3.10. PSTMTS Repeatedly outputs the parameters of each tracked satellite used for calculating a fix. Type: Output Synopsis: $PSTMTS,,,,,,,,,, ,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit Meter Cycle - Description DSP data available: Bit 0: 2nd band Bit 1: Main band Bit 2: 3rd band Satellite identifier. Pseudo range. Satellite tracking frequency offset. Carrier phase measurement. DSP bit flags. Bit 0: Parameter status 1 = Available Bit 1: Preamble locked 1 = Locked Bit 2–3: Multi-path indicator 0 = No indication 3 = Strong indication Bit 4: Loss of lock indicator Bit 5–6: Reserved Bit 7: Preamble polarity 0 = Normal 1 = Reserved Bit 8: Half cycle ambiguity 0 = Fixed 1 = Not fixed Bit 9–13:Reserved Bit 14: Main or dual frequency LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 38 / 79 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric - Numeric Unit dB-Hz Description 1 = Main frequency (L1) 0 = Dual frequency (L2, L5, etc.) Bit 15: Cycle slip indicator (at current epoch vs previous one) 1 = Occurred Bit 16–21: Reserved Bit 22–24: Code alarm value Bit 25: Spoofing Satellite carrier to noise ratio. Second - Track time of satellite. Moving average of the code-loop discriminator error in arbitrary units. Typical abs < 2000. Moving average of the carrier loop update error in arbitrary units. Typical range 1–10 kHz. Total cycle slip counter. - - Degree Elevation degree. Example: $PSTMTS,2,146,39046353.062,-45299.46,-203324611.195,21511,33,245073,730,1622,0,0,26*1F NOTE 1. $PSTMTS is disabled by default. $PSTMSETPAR can be used to enable or disable the output of $PSTMMTS as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR command. //Enable $PSTMTS: $PSTMSETPAR,32,4,0,1,0x200*79 $PSTMSAVEPAR*58 //Disable $PSTMTS: $PSTMSETPAR,32,4,0,2,0x200*7A $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 39 / 79 GNSS Module Series 2.3.11. PSTMSBAS Outputs SBAS satellite data. Type: Output Synopsis: $PSTMSBAS,,,,,,* Parameter: Field Format Unit Numeric - Numeric - Numeric - Numeric Degree Numeric Degree Numeric dB-Hz Description SBAS status: 0 = No SBAS used 1 = SBAS used Whether the SBAS satellite is tracked: 0 = SBAS satellite is not tracked. 1 = SBAS satellite is tracked, decoding is ongoing. 2 = SBAS satellite is tracked and decoded. Differential mode is ON. SBAS satellite ID. SBAS satellite elevation. SBAS satellite azimuth. SBAS satellite signal strength CN0. Example: $PSTMSBAS,1,2,129,45,141,19*1D LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 40 / 79 GNSS Module Series NOTE 1. $PSTMSBAS is disabled by default. $PSTMSETPAR can be used to enable or disable the output of $PSTMSBAS as shown below. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMSETPAR. //Enable $PSTMSBAS: $PSTMSETPAR,32,3,0,1,0x4000*48 $PSTMSAVEPAR*58 //Disable $PSTMSBAS: $PSTMSETPAR,32,3,0,2,0x4000*4B $PSTMSAVEPAR*58 2. After issuing the enable/disable command, the module needs to be restarted for the command to take effect. 2.3.12. PSTMSETCONSTMASK Sets the GNSS constellation mask and usage (optional). It allows switching the multi-frequency configuration at run-time. In case of reset, constellation mask is restored to default value. Type: Set Synopsis: $PSTMSETCONSTMASK,,,[]* Parameter: Field Format Unit Numeric - Description Bitmask where each bit enables/disables a specific constellation independently of the others: Bit 0: GPS Bit 1: Reserved Bit 2: QZSS Bit 3: Galileo Bit 4–6: Reserved Bit 7: BDS Bit 8–10: Reserved Bit 11: GPS L5 Bit 12: Galileo E5 Bit 13: Reserved Bit 14: BDS B2a Bit 15: Reserved LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 41 / 79 GNSS Module Series Field Format Unit Numeric Numeric - Description Bit 16: QZSS L5 Bit 17–31: Reserved Bitmask where each bit enables/disables multi-frequency independently of the others: Bit 0: GPS 0 = OFF 1 = L5 Bit 1: Reserved Bit 2: QZSS 0 = OFF 1 = L5 Bit 3: Galileo 0 = OFF 1 = E5a Bit 4–6: Reserved Bit 7: BDS 0 = OFF 1 = B2a Bit 8–11: Reserved Bit 12: Galileo 0 = E5a Bit 13–30: Reserved Bit 31: 0 = Dual die mode (LG69T (AI)) 1 = Single die mode (other modules except LG69T (AI)) Specify which constellation is used for L1 PVT (optional) Result: ⚫ If successful, the module returns: $PSTMSETCONSTMASKOK,* ⚫ If failed, the module returns: $PSTMSETCONSTMASKERROR* Example: //Enable GPS L1 C/A: $PSTMSETCONSTMASK,1,1*09 $PSTMSETCONSTMASKOK,1,1*0D LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 42 / 79 GNSS Module Series NOTE If the default value is not given for any parameter in a Set command, you can query it with the corresponding Get command provided that the default setting has not been changed by Set command. If the default setting had been changed by Set command, contact Quectel Technical Support (support@quectel.com) to get the default setting if necessary. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 43 / 79 GNSS Module Series 3 RTCM Protocol This chapter outlines the RTCM standard and propriety protocols supported by LG69T (AA), LG69T (AD), LG69T (AI), LG69T (AJ) and LG69T (AR). The standard RTCM protocol supported by these modules is in accordance with RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services – Version 3. This protocol is used to transfer GNSS raw measurement data and is available from https://www.rtcm.org/. The chipset supplier propriety RTCM protocol supported by these modules are the RTCM message type 999. Structure of RTCM3 Protocol Messages 8 bits, fixed at 11010011 6 bits, fixed at 000000 10 bits variable size 24 bits Preamble Reserved Length Content CRC The range for checksum calculation Figure 2: Structure of RTCM3 Protocol Messages Table 5: Field Description of RTCM3 Protocol Messages Field Preamble Reserved Length Content Description RTCM3 protocol preamble. 8 bits, fixed at 11010011. Reserved. 6 bits, fixed at 000000. Message field length. 10 bits. Message payload, variable size. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 44 / 79 Field CRC Description Checksum. 24 bits. GNSS Module Series RTCM Data Fields RTCM message data fields are shown in the table below. Suffix ‘P’ identifies Proprietary Data Fields. Table 6: Data Field Table DF DF002 DF003 DF004 DF009 DF021 DF025 DF026 DF027 DF038 DF054 DF Name Message Number Reference Station ID GPS Epoch Time (TOW) GPS Satellite ID ITRF Realization Year Antenna Position ECEFX Antenna Position ECEFY Antenna Position ECEFZ GLONASS Satellite ID (Satellite Slot Number) Leap Seconds, GPS-UTC DF Range 0–4095 0–4095 0–604799999 1–64 - ±13743895.347 1 ±13743895.347 1 ±13743895.347 1 0–63 0–254 DF Resolution 1 ms 0.0001 m 0.0001 m 0.0001 m 1 s Data Type uint12 uint12 uint30 uint6 uint6 int38 int38 int38 uint6 uint8 Notes 999 (dedicated proprietary number). Differential reference station ID. 0x3FF = Invalid Best time converted to GPS system time. - Reserved. - - - - Converted to GPS-UTC. 0Xff = Invalid or not LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 45 / 79 DF DF Name DF Range DF252 Galileo Satellite 0–63 ID DF429 QZSS Satellite 1–10 ID DF488 DF01P BDS Satellite ID 1–64 Timing/PPS Status 0–255 DF02P DF16P Subtype ID 0–255 GNSS Epoch - Time DF18P Extended Week - Number Firmware DF19P - Version DF21P Constellation - Alarm Mask GNSS Module Series Data DF Resolution Type Notes provided - - 1 ms 1 week - uint6 - uint4 QZSS Satellite ID numbers from 1 to 10 correspond to the PRN codes of the QZSS satellite, as shown in the following ID map: 1: 193 2: 194 … 10: 202 uint6 - uint8 uint8 uint30 uint16 Timing/PPS status: 0 = Available 1–255 = Do not use/Not available See Table 12: Chipset Supplier Proprietary RTCM Message List. TOW for any GNSS. 0x3FFFFFFF = Invalid Include roll-over. The field is invalid if the GNSS Epoch Time is set 0x3FFFFFFF. In which case 0Xffff will be reported. uint24 0Xffffff = Invalid uint32 Constellation alarm mask: Bit 0: GPS Bit 1: GLONASS Bit 2: QZSS L1 C/A Bit 3: Galileo Bit 4: SBAS* Bit 5: Reserved LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 46 / 79 DF DF Name DF Range DF25P DF26P DF27P Configuration. - Page Number Configuration. Page Mask Configuration. Words DF28P GPS Quality Indicator (fix status) 0–15 DF29P DF30P DF31P Number of Satellites in Use Dilution of Precision (DOP) Geoidal Separation, Meters 0–25.4 ±163.83 GNSS Module Series DF Resolution - Data Type uint8 uint16 uint32 uint4 uint8 Notes Bit 6: Reserved Bit 7: BDS Bit 8: Reserved Bit 9: GPS L2C Bit 10: Reserved Bit 11: GPS L5 Bit 12: Galileo E5 Bit 13: Reserved Bit 14: BDS B2a Bit 15: QZSS L2C Bit 16: QZSS L5 Bit 17: Reserved Bit 18: BDS B2I Bit 19: Galileo E5B Bit 20–31: Reserved Note: Bit 0 is the least significant bit Configuration and control page number. Configuration and control page mask, 1-bit set per configuration word. Any configuration and control information field on 32-bit. GPS quality indicator: 0 = Fix not available or invalid 1 = GPS SPS Mode, fix valid 2 = Differential GPS, SPS Mode, fix valid Number of satellites in use. 0Xff = Invalid 0.1 uint8 0Xff = Invalid 0.01 m int15 Geoid separation (the difference between the Earth’s ellipsoid surface LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 47 / 79 GNSS Module Series DF DF32P DF33P DF34P DF35P DF36P DF37P DF49P DF50P DF53P DF54P DF64P DF Name DF Range Age of - Differentials Differential Reference Station ID Antenna Velocity ECEFX Antenna Velocity ECEFY Antenna Velocity ECEFZ Number of Satellites in View 0–4095 - Continue on - Next Message CDB Write Flag - Response ID - Message Response CPU Timestamp 0–4294967295 DF Resolution 1 ms 1E-6 m/s 1E-6 m/s 1E-6 m/s 977.5171 ns Data Type int24 uint12 int32 int32 int32 uint8 uint1 uint1 uint10 uint16 uint32 Notes and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). 0x4000 = Invalid Age of differential GPS data. 0Xffffff = Invalid Differential reference station ID. 0x3FF = Invalid - - - Total number of satellites in view. 0Xff = Invalid 0 = End 1 = Continue on next message (for output only). 0 = No 1 = CDB write (for input only). Message response identifier. A response message is requested (0x0000 means no response required). Content depends on the input message that has requested a response. 977.5171 ns for each step. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 48 / 79 GNSS Module Series DF DF65P DF66P DF67P DF68P DF69P DF70P DF71P DF72P DF73P DF74P DF75P DF76P DF Name Acc Raw X Acc Raw Y Acc Raw Z Gyro Raw X Gyro Raw Y Gyro Raw Z Sensor Type Time ID Latitude Longitude Height Velocity Horizontal DF Range -32768 to 32767 -32768 to 32767 -32768 to 32767 -32768 to 32767 -32768 to 32767 -32768 to 32767 - 0–15 -3.24*10^8 to 3.24*10^8 -6.48*10^8 to 6.48*10^8 1) -524287 to 524287 -524287 to 524287 Data DF Resolution Type 0.061 mg/LSB int16 0.061 mg/LSB int16 0.061 mg/LSB int16 4.37 mdps/LSB int16 4.37 mdps/LSB int16 4.37 mdps/LSB int16 - uint8 - uint4 Notes Raw X-axis acceleration. Full scale = ±2 g Raw Y-axis acceleration. Full scale = ±2 g Raw Z-axis acceleration. Full scale = ±2 g Raw X-axis angular rate. In milli-degree per second unit. Full scale = ±125 dps. Raw Y-axis angular rate. In milli-degree per second unit. Full scale = ±125 dps. Raw Z-axis angular rate. In milli-degree per second unit. Full scale = ±125 dps. Sensor Type. 0x00 = Sensor common parameters 0x03 = Odometer 0x1E = Accelerometer 0x1F = Gyroscope Time ID: 0 = GPS 1 = GLONASS 2 = QZSS 3 = Galileo 4 = SBAS* 7 = BDS 14 = UTC 15 = Invalid 0.001 arcsec int32 0x80000000 = Invalid 0.001 arcsec 0.1 m 0.01 m/s int32 int20 int20 0x80000000 = Invalid 0x80000 = Invalid or not available (2D fix) 0x80000 = Invalid LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 49 / 79 GNSS Module Series DF DF77P DF78P DF82P DF86P DF87P DF95P DF96P DF106P DF107P DF112P DF Name DF Range -524287 to Velocity Vertical 524287 Data DF Resolution Type 0.01 m/s int20 Notes 0x80000 = Invalid Course Angle 0–3599 0.1 Degree int16 0x8000 = Invalid Signal Identifier - - Tracking Mode - - Time Validity 0–15 - GNSS Constellation - 32 Mask GNSS Multi- Frequency - 32 Constellation Mask uint16 uint8 uint4 uint32 See Chapter 3.2.2 Signal Identifier (DF82P) and Tracking Mode (DF86P). See Chapter 3.2.2 Signal Identifier (DF82P) and Tracking Mode (DF86P). Time types: 0 = No time 1 = Time read from flash 2 = TOW time (week number not available) 3 = Time set by user 4 = Time set by user RTC 5 = Approximate RTC time 6 = Accurate RTC time 7 = Approximate Time 8 = Accurate time 9 = Position time 10 = Ephemeris time 11–15 = Reserved See Table 7: Constellation Mask (SatType). uint32 See Table 8: MultiFrequency/Tracking Mode Mask. Odometer 0–4294967295 uint32 Unsigned odometer count Reverse 0–1 Config. Block 1–3 - uint1 uint2 Reverse status 0 = Forward 1 = Reverse Configuration blocks in output message: 1 = Current configuration (RAM) 2 = Default configuration LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 50 / 79 DF DF Name DF Range DF113P Time Best - Satellite Type GNSS Module Series Data DF Resolution Type - uint5 Notes 3 = NVM stored configuration Not used (can be 0) in input message. See Table 10: Satellite Type and Selector. NOTE RTCM messages are output in hexadecimal format. For customer’s convenience, some parameter notes are converted to decimal or binary format to facilitate viewing. 3.2.1. Supported Frequency Bands The constellation mask is a 32-bit integer mask, where each enabling bit indicates if the corresponding satellite system or signals is supported, see Table 7: Constellation Mask (SatType) for details. Table 7: Constellation Mask (SatType) Bit System Signal 0 GPS L1 C/A 1 GLONASS L1 2 QZSS L1 C/A 3 Galileo E1 4 SBAS 5–6 Reserved 7 BDS 8 Reserved 9 GPS 10 Reserved L1(*) Reserved B1I Reserved L2C Reserved Description 0 = Unsupported 1 = Supported 0 = Unsupported 1 = Supported 0 = Unsupported 1 = Supported 0 = Unsupported 1 = Supported 0 = Unsupported 1 = Supported 0 0 = Unsupported 1 = Supported 0 0 = Unsupported 1 = Supported 0 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 51 / 79 Bit 11 12 13 14 15 16 17–31 System GPS Galileo Reserved BDS QZSS QZSS Reserved Signal L5 E5a or E5b Reserved B2I or B2a L2C L5 Reserved GNSS Module Series Description 0 = Unsupported 1 = Supported 0 = Unsupported 1 = Supported 0 0 = B2I, 1 = B2a 0 = Unsupported 1 = Supported 0 = Unsupported 1 = Supported 0 NOTE * means reserved for future use. The multi-frequency mask is a 32-bit integer mask, where each bit indicates if a dual-frequency component (Table 8: Multi-Frequency/Tracking Mode Mask) is supported for the corresponding main frequency signal. The bit meaning in this mask is slightly different from the constellation mask because some frequency combinations are not supported, and some configurations allow for the choice of the dual frequency among different possibilities (e.g., E5a or E5b as dual frequency of E1). Table 8: Multi-Frequency/Tracking Mode Mask Bit System Signal 0 GPS L1 C/A 1 GLONASS L1 2 QZSS L1 C/A 3 Galileo E1 4–6 Reserved 7 BDS B1I 8 Reserved Dual Frequency 0 = Unsupported, 1 = L2C or L5 0 = Unsupported, 1 = G2 0 = Unsupported, 1 = L2C or L5 0 = Unsupported, 1 = E5a or E5b 0 = Unsupported, 1 = B2a or B2I LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 52 / 79 GNSS Module Series Bit 9 10 11 12 13 14 15 16 17–22 23 24 25 26 27 28–29 30 31 System Signal Dual Frequency GPS L2C 0 = Data, 1 = Pilot Reserved GPS L5 0 = Pilot, 1 = Data Galileo E5a or E5b 0 = E5a, 1 = E5b Reserved BDS B2a 0 = Pilot, 1 = Data QZSS L2C 0 = Data, 1 = Pilot QZSS L5 0 = Pilot, 1 = Data Reserved Acquisition of dual frequency (L5): 0 = Disabled, 1 = Enabled Split Band Mode: 0= Disabled, 1=Enabled GPS/QZSS L2C Galileo E1 Galileo E1 Reserved Dual channel mode: 0 = Unsupported, 1 = Data + Pilot Dual channel mode: 0 = Unsupported, 1 = Data + Pilot Automatic data/pilot switch: 0 = Enabled, 1 = Disabled Galileo E5a/E5b 0 = Pilot, 1 = Data 0 = Dual Die (LG69T (AI)), 1 = Single Die (L1/L5) (Other modules except LG69T (AI)) NOTE * means reserved for future use. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 53 / 79 3.2.2. Signal Identifier (DF82P) and Tracking Mode (DF86P) Signal Identifier is an unsigned 16-bit number structured as shown below. Signal ID GNSS Module Series RES Selector SatType 1-bit 2-bit 5-bit PRN 8-bit Tracking Mode Figure 3: Signal ID (DF82P) Structure PRN Field: This field is set to the corresponding RTCM data field according to table below for each constellation (if the RTCM data field length is less than 8 bits, only the less significant bits will be used, while the remaining bits will be set to zero). 'PRN' is usually assigned a value starting from ‘1’, and it is used to identify a specific satellite signal. A 'PRN' value of zero is not allowed and it is reserved to identify special signal IDs (e.g., invalid IDs). Table 9: Signal ID Constellation Encoding Constellation GPS GLONASS Galileo QZSS BDS RTCM Data Field for PRN DF009 DF038 DF252 DF429 DF488 SatType Field: Represents the constellation ID as shown below. Selector Field: The 'selector' identifies specific tracking modes of the signal components, e.g., data vs. pilot, E5a vs. E5b, I vs. Q component etc. Refer to the table below for details. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 54 / 79 Table 10: Satellite Type and Selector SatType No. System Signal 0 GPS L1 C/A 1 GLONASS L1 2 QZSS L1 C/A 3 Galileo E1B (data) E1C (pilot) 4 SBAS L1(*) 5-6 Reserve B1I 7 BDS B2I 8 Reserved 9 GPS L2C CM (data) L2C CL (pilot) 10 Reserved 11 GPS L5-Q (pilot) L5-I (data) E5a-I (data) 12 Galileo E5a-Q (pilot) E5b-I (data) E5b-Q (pilot) 13 Reserved 14 BDS 3 B2a 15 QZSS L2C CM (data) GNSS Module Series Selector 00 00 00 00 01 00 00 01 00 01 00 01 00 01 10 11 00 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 55 / 79 SatType No. System 16 17-31 QZSS Reserved Signal L2C CL (pilot) L5-Q (pilot) L5-I (data) GNSS Module Series Selector 01 00 01 NOTE * means reserved for future use. RES Field: Reserved for future use and kept at zero. Standard RTCM Messages The LG69T (AA), LG69T (AD), LG69T (AI) LG69T (AJ) and LG69T (AR) modules support the RTCM protocol which is in accordance with RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services – Version 3. This protocol is used to transfer GNSS raw measurement data and is available from https://www.rtcm.org/. Table 11: Supported RTCM3 Messages Message Type Mode Message Name 1006 Output Stationary RTK Reference Station ARP with Antenna Height. 1013 Output System Parameters. 1019 Input/Output GPS Ephemerides. 1020 Input/Output GLONASS Ephemerides. 1042 Input/Output BDS Satellite Ephemeris Data. 1044 Input/Output QZSS Ephemerides. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 56 / 79 Message Type Mode 1046 Input/Output 1077 Output 1087 Output 1097 Output 1117 Output 1127 Output GNSS Module Series Message Name Galileo I/NAV Satellite Ephemeris Data. GPS MSM7. GLONASS MSM7 Galileo MSM7. QZSS MSM7. BDS MSM7. Proprietary RTCM Messages The RTCM message type 999 is a proprietary message specific to the chipset supplier. Table 12: Chipset Supplier Proprietary RTCM Message List Subtype ID Mode Description 1 Output Receiver Status and Safety (RSS). 2 Input/Output Receiver Configuration and Control (RCC). 4 Input/Output Receiver Position, Velocity and Time (PVT). 5 Output Position Quality Metrics (POSQM). 19 Output Response Message (RESP). 21 Output Extended Position, Velocity and Time (EPVT). 24 Output RF Status (RFS). 25 Output Firmware Version (FWVER). 26 Output Signal Quality Metrics 2 (SIGQM2) 64 Output Sensor message (SENS). LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 57 / 79 GNSS Module Series NOTE Only LG69T(AA) and LG69T(AJ) support SENS message output, but LG69T (AA) and LG69T(AJ) with IMU standalone solution do not support SENS message output, see document [1] IMU standalone solution application note for details on LG69T (AA) and LG69T(AJ) IMU standalone solution. 3.4.1. RSS (Subtype ID = 1) This message reports the receiver status and safety. Data Name DF Message Number DF002 Subtype ID DF02P GPS Epoch Time (TOW) DF004 GPS Extended Week Number DF18P Leap Seconds, GPS-UTC DF054 Safety Information - Protocol Version Flags Firmware Version Reserved Reserved Reserved DF19P - Timing/PPS Status DF01P Time Validity DF87P Constellation Alarm Mask DF21P Bit Position Bits Notes 0 12 999 (dedicated proprietary number). Subtype ID = 1. Receiver Status and 12 8 Safety. Best time converted to GPS system 20 30 time. Best time converted to GPS system 50 16 time. 66 8 See Table 6: Data Field Table Safety information 74 1 0 = Not available 1 = Available RTCM protocol version. 75 7 3 = RTCM 3.3 82 24 0xFFFFFF = Invalid. 106 8 - 114 8 - 122 8 - Timing/PPS status: 130 8 0 = Available 1–255 = Do not use/Not available 138 4 See Table 6: Data Field Table 142 32 See Table 6: Data Field Table LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 58 / 79 GNSS Module Series Data Name DF Bit Position Bits Notes Reserved - 174 GNSS Constellation Mask DF95P 206 GNSS Multi-Frequency DF96P 238 Constellation Mask NCO Clock Drift - 270 Time Best Satellite Type DF113P 302 Unavailable Satellite Type DF95P 307 Mask 32 - See Table 7: Constellation Mask 32 (SatType). See Table 8: Multi- 32 Frequency/Tracking Mode Mask. 0.0001 Hz (signed int) 32 Present only if protocol version flag is 2 or 3. Present only if protocol version flag 5 is 3. See Table 10: Satellite Type and Selector. Satellite constellation mask for which IFB Monitor status cannot be 32 computed. Present only if protocol the version flag is 3 or above. 3.4.2. RCC (Subtype ID = 2) The Receiver Configuration and Control output message is used to report the current configuration. The basic configuration elements are 32-bit words, organized in pages of 16 consecutive elements. At start-up, all configuration pages will be reported in the output (one RCC message for each page). Data Name Message Number Subtype ID Response ID Config. Block DF DF002 DF02P DF53P Bit Position Bits 0 12 12 8 20 10 DF112P 30 2 Notes 999 (dedicated proprietary number Subtype ID = 2. Receiver Configuration and Control. Always 0x0000 for output. Configuration blocks in output message: 1 = Current configuration (RAM) 2 = Default configuration 3 = NVM stored configuration. Not used (can be 0) in input message. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 59 / 79 GNSS Module Series Data Name Config. Page Number Continue on Next Message CDB Write Flag Config. Page Mask Config. Word DF DF25P DF49P DF50P DF26P DF27P Bit Position Bits 32 8 40 1 41 1 16 42 58 32*N Notes Configuration and control page number. 0 = End 1 = Continue on next message (for output only). 0 = No 1 = CDB Write (for input only). 1-bit per page: N: Number of lines to be written inside the page. See NOTE 6 for more details. Up to 16 words. NOTE 1. If the Continue on Next Message flag is set to 1, then there will be a subsequent RCC message, otherwise the current message is the last of the current reading sequence. 2. The input RCC message allows updating one or more lines of a specified page. Only one page can be updated at a time. 3. Config. Page Mask specifies which lines must be written in the Page. The bit 0 (i.e. the least significant bit) represents Line 0, bit 1 Line 1, and so on. To write a double type, 2 consecutive bits lines of Config Page Mask should be set (even + odd consecutive bits) to ensure a successful double write. 4. In the case of an RCC input message, if the response ID field is different from 0x0000, a response message is requested. In this case, the response value can be interpreted according to Table 13: Response Meaning. 5. If the CDB Write Flag is set to 1, the configuration reported by the current RCC input message will be stored in CDB, otherwise it will be stored only in the current configuration. 6. 'N' is the number of lines to be written within the page, and it can be calculated by counting the number of bits set in the Config Page Mask; the subsequent 32-bit Config word field must contain exactly N entries. The Lines reported in the Config word field are arranged in ascending order, starting from the Line with the lowest index to the Line with the higher index. 7. The subsequent RCC message (if any) in input should be issued after receiving the RESP message with the corresponding Response ID. 8. If the response is not received in two fixed periods (typically 2 seconds for 1 Hz fixed rate), the status of the RCC message should be considered as unknown. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 60 / 79 GNSS Module Series 3.4.3. PVT (Subtype ID = 4) This message reports the receiver PVT standard position in ECEF coordinates, plus additional fix information. Data Name DF Message Number DF002 Subtype ID DF02P Reference Station ID DF003 ITRF Realization Year DF021 GPS Quality Indicator DF28P (fix status) Number of Satellites in DF29P Use Number of Satellites in DF37P View HDOP DF30P VDOP DF30P PDOP DF30P Geoidal Separation DF31P Age of Differentials DF32P Differential Reference DF33P Station ID Time ID DF72P Bit Position Bits 0 12 12 8 20 12 32 6 38 4 42 8 50 8 58 8 66 8 74 8 82 15 97 24 121 12 133 4 Notes 999 (dedicated number). proprietary Subtype ID = 4. Receiver Position, Velocity and Time (PVT). Differential reference station ID. 0x3FF = Invalid Reserved GPS quality indicator: 0 = Fix not available or invalid 1 = GPS SPS Mode, fix valid 2 = Differential GPS, SPS Mode, fix valid Number of satellites in use. 0xFF = Invalid Total number of satellites in view. 0xFF = Invalid Horizontal Dilution of Precision. Vertical Dilution of Precision. Position Dilution of Precision. Geoid separation (the difference between the Earth's ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). 0x4000 = Invalid Age of differential GPS data. 0xFFFFFF = Invalid Differential reference station ID. 0x3FF = Invalid Time ID 0xF = Invalid LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 61 / 79 GNSS Module Series Data Name DF GNSS Epoch Time DF16P Extended Number Week DF18P Leap Seconds, GPSDF054 UTC Antenna ECEF-X Position DF025 Antenna ECEF-Y Position DF026 Antenna ECEF-Z Position DF027 Antenna Velocity ECEFDF34P X Antenna Velocity ECEFDF35P Y Antenna Velocity ECEFDF36P Z Bit Position Bits 137 30 167 16 183 8 191 38 229 38 267 38 305 32 337 32 369 32 Notes 1 millisecond resolution. 0x3FFFFFFF = Invalid See Table 6: Data Field Table See Table 6: Data Field Table - 3.4.4. POSQM (Subtype ID = 5) This message outputs information for Quectel’s internal debugging purposes only. 3.4.5. RESP (Subtype ID = 19) This message is the response to a previous input message that has requested a response. The response ID is used to identify the specific input message. The encoding of the response data field depends on the type of the corresponding input message. Data Name DF Message Number DF002 Subtype ID DF02P Response ID DF53P Bit Position Bits 0 12 12 8 20 10 Notes 999 (dedicated proprietary number). Subtype ID = 19, Response Message. Response ID is used to identify the input message that has requested a response. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 62 / 79 GNSS Module Series Data Name DF Message Response DF54P Bit Position Bits 30 16 Table 13: Response Meaning Response 0x0000 0x0001 0x0002–0xFFFF Description OK Error RFU Notes Response to the input message associated to the Response ID. NOTE It is not guaranteed that the response will be provided. In case it is provided, the response will be output in maximum two fixed periods (typically 2 seconds for 1 Hz fixed rate). 3.4.6. EPVT (Subtype ID = 21) This message reports the receiver PVT standard position in LLH coordinates, plus extended fix information. Data Name Message Number DF DF002 Subtype ID DF02P Reference Station ID DF003 ITRF Realization Year DF021 GPS Quality Indicator DF28P (fix status) Bit Position Bits 0 12 8 12 20 12 32 6 38 4 Notes 999 (dedicated number). proprietary Subtype ID = 21, Extended Position, Velocity and Time (EPVT). Differential reference station ID. 0x3FF = Invalid Reserved GPS quality indicator: 0 = Fix not available or invalid 1 = GPS SPS Mode, fix valid 2 = Differential GPS, SPS Mode, fix valid LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 63 / 79 GNSS Module Series Data Name DF Data Status - Fix Frequency Mode - Fix Integrity (RAIM) - Reserved - Number of Satellites in DF29P Use Number of Satellites in DF37P View HDOP DF30P VDOP DF30P PDOP DF30P Geoidal Meters Separation, DF31P Age of Differentials DF32P Differential Reference DF33P Station ID Time ID DF72P Time Validity DF87P GNSS Epoch Time DF16P Extended Week Number DF18P Bit Position Bits 42 1 43 1 44 1 45 1 46 8 54 8 62 8 70 8 78 8 86 15 101 24 125 12 137 4 141 4 145 30 175 16 Notes Data status: 0 = Data valid 1 = Navigation receiver warning Fix mode: 0 = Single frequency 1 = Multi-frequency Check status: 0 = Not checked 1 = Checked Reserved Number of satellites in use. 0xFF = Invalid Total number of satellites in view. 0xFF = Invalid Horizontal Dilution of Precision. Vertical Dilution of Precision. Position Dilution of Precision. Geoid separation (the difference between the Earth's ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). 0x4000 = Invalid Age of differential GPS data. 0xFFFFFF = Invalid Differential reference station ID. 0x3FF = Invalid Time ID. 0xF = Invalid See Table 6: Data Field Table 1 millisecond resolution. 0x3FFFFFFF = Invalid See Table 6: Data Field Table LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 64 / 79 GNSS Module Series Data Name DF Leap Seconds, GPSDF054 UTC Latitude DF73P Longitude DF74P Height DF75P Velocity Horizontal DF76P Velocity Vertical DF77P Course Angle DF78P Protection Horizontal Level - Protection Level Vertical - Protection Level Angle - Receiver Clock Bias - Receiver Clock Drift - Bit Position Bits 191 8 199 32 231 32 263 20 283 20 303 20 323 16 339 16 355 16 371 16 387 32 419 32 Notes See Table 6: Data Field Table 0x80000000 = Invalid 0x80000000 = Invalid 0x80000 = Invalid or not available (2D fix) 0x80000 = Invalid 0x80000 = Invalid 0x8000 = Invalid Resolution: 0.01 meter 0xFFFF = Invalid Resolution: 0.01 meter 0xFFFF = Invalid Resolution: 0.01 degree 0xFFFF = Invalid Unit: mm 0x80000000 = Invalid Unit: cm/s 0x80000000 = Invalid NOTE 1. If GPS Quality Indicator (fix status) is 0, then the following fields are invalid, regardless of their reported values: ⚫ Fix Frequency Mode ⚫ Fix Integrity (RAIM) ⚫ Geoidal Separation, Meters ⚫ Latitude ⚫ Longitude ⚫ Height ⚫ Velocity Horizontal ⚫ Velocity Vertical ⚫ Course Angle 2. Height field is set to invalid (0x80000) in 2D fix. 3. In EPVT message, positive values for Latitude represent east longitude, and positive values for Longitude represent north latitude. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 65 / 79 GNSS Module Series 3.4.7. RFS (Subtype ID = 24) This message outputs information for Quectel’s internal debugging purposes only. 3.4.8. FWVER (Subtype ID = 25) FWVER message reports the current firmware version. Data Name DF Message Number DF002 Subtype ID DF02P Firmware Version Data Length - Bit Position Bits 0 12 12 8 20 8 Firmware Version Data String - 28 8*N Notes 999 (dedicated proprietary number). Subtype ID = 25, Firmware Version (FWVER). N, number of bytes. Firmware version data string is char8*N, N depends on the firmware version data length. 3.4.9. SIGQM2 (Subtype ID = 26) This message outputs information for Quectel’s internal debugging purposes only. 3.4.10. SENS (Subtype ID = 64) Reports sensor message data, which is specific to the Message ID for each specific sensor configuration for RTCM 3 output (Odometer-reverse, Accelerometer and Gyroscope). Data Name DF Message Number DF002 Subtype ID DF02P Number of Frame Entries - Frame Entry - Bit Position Bits 0 12 12 8 20 8 28 variable Notes 999 (dedicated proprietary number). Subtype ID = 64, Sensor message (SENS). Number of Frame entry fields. Frame data according to Subtype ID. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 66 / 79 GNSS Module Series Table 14: Message Frame for Sensor Common (Sensor type = 0x00) Data Name Sensor Type CPU Timestamp Sensor Type Length DF DF71P DF64P - Sensor Common Version - Bit Position Bits 0 8 8 32 40 6 46 2 GPS Epoch Time (TOW) DF004 48 30 Notes Sensor type = 0x00 (Sensor common parameters). 977.5171 ns for each step. 4-bit length for each step. Total steps = 8 (i.e., 32 bits) Sensor common version: 0x0 = Version 0 0x1–0x3 = RFU Best time converted to GPS system time corresponding to CPU timestamp. Table 15: Message Frame for Odometer - Reverse (Sensor type = 0x03) Data Name DF Sensor Type DF71P CPU Timestamp DF64P Bit Position Bits 0 8 8 32 Notes Sensor type = 0x03 (Odometer - reverse). 977.5171 ns for each step. Odometer Reverse DF106P 40 DF107P 72 32 Unsigned odometer count. Reverse status. 1 0 = Forward, 1 = Reverse Table 16: Message Frame for Accelerometer (Sensor type = 0x1E) Data Name Sensor Type CPU Timestamp Acc Raw X Acc Raw Y DF DF71P DF64P DF65P DF66P Bit Position Bits 0 8 8 32 40 16 56 16 Notes Sensor type = (Accelerometer). 0x1E 977.5171 ns for each step. Raw X-axis acceleration. Full scale = ±2 g Raw Y-axis acceleration. Full scale = ±2 g LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 67 / 79 GNSS Module Series Data Name Acc Raw Z DF DF67P Bit Position Bits 72 16 Table 17: Message Frame for Gyroscope (Sensor type = 0x1F) Data Name DF Bit Position Bits Sensor Type DF71P 0 8 CPU Timestamp DF64P 8 32 Gyro Raw X DF68P 40 16 Gyro Raw Y DF69P 56 16 Gyro Raw Z DF70P 72 16 Notes Raw Z-axis acceleration. Full scale = ±2 g Notes Sensor type = 0x1F (Gyroscope). 977.5171 ns for each step. Raw X-axis angular rate. Full scale = ±125 dps. Raw Y-axis angular rate. Full scale = ±125 dps. Raw Z-axis angular rate. Full scale = ±125 dps. NOTE Only LG69T(AA) and LG69T(AJ) support SENS message output, but LG69T (AA) and LG69T(AJ) with IMU standalone solution do not support SENS message output, see document [1] IMU standalone solution application note for details on LG69T (AA) and LG69T(AJ) IMU standalone solution. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 68 / 79 GNSS Module Series 4 Appendix A References Table 18: Related Document Document Name [1] Quectel_LG69T(AA,AJ)_IMU_Standalone_Solution_Application_Note Table 19: Terms and Abbreviations Abbreviation Description 2D 2 Dimension 3D 3 Dimension CDB Configuration Data Block C/N0 Carrier-to-Noise Ratio COG Course over Ground COGM Course over Ground (in Magnetic North Course Direction) COGT Course over Ground (in True North Course Direction) CPU Central Processing Unit DOP Dilution of Precision DSP Digital Signal Processing ECEF Earth-centered, Earth-fixed EPVT Extended PVT FDE False Detection Exclusion FWVER Firmware Version LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 69 / 79 Abbreviation GGA GLL GLONASS GNSS GPS GSA GSV HDOP ITRF LLH LSB MTB NCO NMEA NTSC NVM PDOP PLL POSQM PPS PRN PVT QZSS RAIM GNSS Module Series Description Global Positioning System Fix Data Geographic Position - Latitude and Longitude Global Navigation Satellite System (Russia) Global Navigation Satellite System Global Positioning System GPS DOP and Active Satellites GNSS Satellites in View Horizontal Dilution of Precision International Terrestrial Reference Frame Latitude, Longitude, Height Least Significant Bit Master Time-Base Numerically Controlled Oscillator NMEA (National Marine Electronics Association) 0183 Interface Standard National Time Service Center Non-Volatile Memory Position Dilution of Precision Phase Locked Loop Position Quality Metrics Pulse Per Second Pseudo Random Noise Position, Velocity and Time Quasi-Zenith Satellite System Receiver Autonomous Integrity Monitoring LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 70 / 79 Abbreviation RAM RCC RESP RF RFS RFU RMC RSS RTC RTCM SBAS SENS SIGQM2 SNR SOG SPS TCXO TOW UTC VDOP VTG ZDA GNSS Module Series Description Random Access Memory Receiver Configuration and Control Response Radio Frequency RF Status Reserved for Further Use Recommended Minimum Specific GNSS Data Receiver Status and Safety Real-Time Clock Radio Technical Commission for Maritime Services Satellite-Based Augmentation System Sensor message Signal Quality Metrics 2 Signal to Noise Ratio Speed over Ground Standard Positioning Service Temperature Compensated Crystal Oscillator Time of Week Coordinated Universal Time Vertical Dilution of Precision Course Over Ground & Ground Speed Time & Date LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 71 / 79 GNSS Module Series 5 Appendix B GNSS Satellites (NMEA) Numbering Table 20: GNSS Satellites (NMEA) Numbering GNSS Type System ID GPS 1 GLONASS 2 Galileo 3 BDS 4 QZSS 5 Satellite ID Range: 01–99 01–32 is reserved for GPS 33–64 is reserved for SBAS 65–99 is undefined Range: 01–99 33–64 is reserved for SBAS 65–99 is reserved for GLONASS Range: 01–99 01–36 is reserved for Galileo 37–64 is reserved for SBAS 65–99 is undefined Range: 01–99 01–64 is reserved for BDS 65–99 is undefined Range: 01–99 01–10 is reserved for QZSS 1) 55–63 is reserved for SBAS 1) 64–99 is undefined Signal ID Signal Channel 1 L1 C/A 7 L5-I 1 L1 C/A 1 E5a 7 E1 1 B1I 5 B2a 1 L1 C/A 7 L5-I NOTE 1. 1) Satellite ID must be 6 LSBs of the 8-bit PRN Number (i.e., Satellite ID of PRN 193 is 1). 2. Table above is only applicable to standard NMEA messages. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 72 / 79 6 Appendix C Example Basic Command 6.1.1. Restart Receiver 1. Cold Start: NMEA Command $PSTMCOLD*1E RTCM Command D3 00 07 3E 71 00 00 00 00 F0 47 9E EE 2. Warm Start: NMEA Command $PSTMWARM*13 RTCM Command D3 00 07 3E 71 00 00 00 00 20 A8 34 11 3. Hot Start: NMEA Command $PSTMHOT*49 RTCM Command D3 00 07 3E 71 00 00 00 00 00 A4 E5 F8 4. Factory Reset: NMEA Command $PSTMRESTOREPAR*11 RTCM Command D3 00 06 3E 71 40 60 00 10 3C 9A B8 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification GNSS Module Series 73 / 79 5. Software Reset: NMEA Command $PSTMSRR*11 RTCM Command D3 00 07 3E 71 08 00 00 00 00 72 22 74 GNSS Module Series NOTE Module must be restarted after running the Factory Reset restoration command. 6.1.2. Debug Serial Port 1. Enable Debugging NMEA Command $PSTMSETPAR,1,12,0,0,0 *35 $PSTMSAVEPAR*58 RTCM Command D3 00 0C 3E 70 20 04 01 44 00 03 A0 04 40 00 0D 02 FC 2. Disable Debugging NMEA Command $PSTMSETPAR,1,12,0,0,1*34 $PSTMSAVEPAR*58 RTCM Command D3 00 0C 3E 70 20 04 01 44 00 03 A0 04 40 40 14 A1 2E NOTE Module must be restarted after running all the commands. 6.1.3. Query Software Version 1. Software version number: NMEA Command $PSTMGETPAR,1,63*3B LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 74 / 79 RTCM Command D3 00 08 3E 71 20 04 28 FF FF FC E5 E1 87 GNSS Module Series NOTE 1. You will get the RCC message (Subtype ID = 2, Config. Page Number = 63 and Config. Page Mask = 0xFFFF) after the command is sent. 2. Contact Quectel Technical Support (support@quectel.com) for more details about $PSTMGETPAR. 6.1.4. Configure Raw Observation Data Output Frequency The output frequency of original observation data was changed to 10 Hz: D3 00 10 3E 70 20 04 10 70 00 26 66 66 66 8F EE 66 66 40 1B 06 6B D3 00 0C 3E 70 20 04 10 48 00 00 00 00 02 80 43 98 8D D3 00 0C 3E 70 20 04 10 40 04 00 00 00 02 80 C2 F4 E2 The output frequency of original observation data was changed to 5 Hz: D3 00 10 3E 70 20 04 10 70 00 26 66 66 66 8F F2 66 66 40 99 29 9E D3 00 0C 3E 70 20 04 10 48 00 00 00 00 01 40 C2 ED 23 D3 00 0C 3E 70 20 04 10 40 04 00 00 00 01 40 43 81 4C The output frequency of original observation data was changed to 2 Hz: D3 00 10 3E 70 20 04 10 70 00 00 00 00 00 0F F8 00 00 00 CF AA E5 D3 00 0C 3E 70 20 04 10 48 00 00 00 00 00 80 8E 86 1D D3 00 0C 3E 70 20 04 10 40 04 00 00 00 00 80 0F EA 72 The output frequency of original observation data was changed to 1 Hz: D3 00 10 3E 70 20 04 10 70 00 00 00 00 00 0F FC 00 00 00 17 8F AD D3 00 0C 3E 70 20 04 10 48 00 00 00 00 00 40 A4 62 6B D3 00 0C 3E 70 20 04 10 40 04 00 00 00 00 40 25 0E 04 NOTE 1. Module must be restarted after running all the commands. 2. It is recommended to use the default frequency configuration. The performance after changing to non-default frequencies has not been tested systematically. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 75 / 79 GNSS Module Series 6.1.5. Supported Frequency Setting The following tables show the supported frequency settings. Table 21: Supported Frequency Setting L1 L2 L5 Scenario GPS GLO BDS GAL GPS GLO BDS GAL GPS BDS GAL L1 L1 B1I E1 L2C L2 B2I E5b L5 B2a E5a 0 ⚫ ⚫ ⚫ ⚫ ⚫ ⚫ ⚫ - - - - 1 ⚫ ⚫ ⚫ ⚫ ⚫ - ⚫ - - - - 2 ⚫ ⚫ ⚫ ⚫ - - - - ⚫ ⚫ ⚫ 3 ⚫ ⚫ ⚫ ⚫ ⚫ - - ⚫ - - - 5 ⚫ ⚫ ⚫ ⚫ ⚫ - ⚫ ⚫ - - - NOTE 1. Only LG69T (AI) supports the scenario change, and the performance after scene switching has not been tested systematically. 2. QZSS is systematically activated in parallel with GPS. 3. ⚫ means the scenario can be enabled. 4. - means the scenario cannot be enabled. Switch the scenarios through RTCM commands: Scenario 0: D3 00 0C 3E 70 20 04 15 40 04 00 00 20 A3 C0 55 3C BA D3 00 0C 3E 70 20 04 15 40 08 00 00 00 21 C0 54 4D 32 D3 00 0C 3E 70 20 04 15 40 10 00 00 00 23 40 F9 2B 33 D3 00 0C 3E 70 20 04 15 40 20 00 00 00 23 40 5F 55 59 Scenario 1: D3 00 0C 3E 70 20 04 15 40 04 00 00 20 A3 C0 55 3C BA D3 00 0C 3E 70 20 04 15 40 08 00 00 00 21 40 67 0A 96 D3 00 0C 3E 70 20 04 15 40 10 00 00 00 23 40 F9 2B 33 D3 00 0C 3E 70 20 04 15 40 20 00 00 00 23 40 5F 55 59 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 76 / 79 Scenario 2: D3 00 0C 3E 70 20 04 15 40 04 00 00 56 23 C0 2A FF 21 D3 00 0C 3E 70 20 04 15 40 08 00 00 00 23 40 AA 14 06 D3 00 0C 3E 70 20 04 15 40 10 00 00 00 23 40 F9 2B 33 D3 00 0C 3E 70 20 04 15 40 20 00 00 00 23 40 5F 55 59 Scenario 3: D3 00 0C 3E 70 20 04 15 40 04 00 00 24 A3 C0 D3 CE EB D3 00 0C 3E 70 20 04 15 40 08 00 00 04 03 40 CF 68 8F D3 00 0C 3E 70 20 04 15 40 10 00 00 00 23 40 F9 2B 33 D3 00 0C 3E 70 20 04 15 40 20 00 00 00 23 40 5F 55 59 Scenario 5: D3 00 0C 3E 70 20 04 15 40 04 00 00 24 A3 C0 D3 CE EB D3 00 0C 3E 70 20 04 15 40 08 00 00 04 23 40 2C E6 57 D3 00 0C 3E 70 20 04 15 40 10 00 00 00 23 40 F9 2B 33 D3 00 0C 3E 70 20 04 15 40 20 00 00 00 23 40 5F 55 59 NOTE Module must be restarted after running all the commands. GNSS Module Series 6.1.6. Change Baud Rate with NMEA Command The following NMEA commands are used to change the baud rate in NMEA message output: $PSTMSETPAR,1,15,0,0,* Parameter: Field Format Unit Hexadecimal bps Description 0xA = 115200 0xB = 230400 0xC = 460800 0xD = 921600 Example: $PSTMSETPAR,1,15,0,0,0xA*0B $PSTMSETPAROK,P01,L15,F00,0000000a*11 $PSTMSAVEPAR*58 LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 77 / 79 GNSS Module Series NOTE Module must be restarted after running all the commands. 6.1.7. Change Baud Rate with RTCM Command The following RTCM commands are used to change the baud rate in RTCM message output: Switch to 115200 bps: D3 00 0C 3E 70 20 04 01 60 00 00 80 00 02 80 03 A6 B6 Switch to 230400 bps: D3 00 0C 3E 70 20 04 01 60 00 00 80 00 02 C0 1A 05 64 Switch to 460800 bps: D3 00 0C 3E 70 20 04 01 60 00 00 80 00 03 00 56 6E 5A Switch to 921600 bps: D3 00 0C 3E 70 20 04 01 60 00 00 80 00 03 40 4F CD 88 NOTE Module must be restarted after running all the commands. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 78 / 79 GNSS Module Series 7 Appendix D Special Characters Table 22: Special Characters Special Characters Definition Parameter name. Angle brackets do not appear in the message. [...] Optional field of a message. Square brackets do not appear in the message. {…} Repeated field of a message. Curly brackets do not appear in the message. Underline Default setting of a parameter. LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification 79 / 79

LG69T (AQ) GNSS Protocol Specification GNSS Module Series Version: 1.2 Date: 2024-04-10 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LG69T(AQ)_GNSS_Protocol_Specification 1 / 48 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2024. All rights reserved. LG69T(AQ)_GNSS_Protocol_Specification 2 / 48 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LG69T (AQ) GNSS Protocol Specification GNSS Module Series GNSS Protocol Specification Released Revision History Version 1.0 1.1 1.2 Date 2022-09-02 2023-05-17 2024-04-10 Description Creation of the document 1 Deleted the applicable model: LG69T (AM). 2 Added the table about the supported protocols (Table 1: Supported Protocol). 3 Added the Sample Code for NMEA Checksum (Chapter 2.1). 4 Updated the result part of PQTMVRRNO message (Chapter 2.3.1). 5 Deleted 13200, 13201 and 13202 messages. 6 Added 13220, 13221 and 13222 messages (Chapters 3.2.10, 3.2.11 and 3.2.12). 1. Deleted the D value from field in the RMC and GLL messages. (Chapters 2.2.1 and 2.2.6) 2. Added 13001 and 10500 messages. (Chapters 3.2.2 and 3.2.3) 3. Updated the value of HOT_START and WARM_START commands in 13002 message (Table 7). 4. Updated the protocol version from 00 to 02 in 13002, 13005, 13100, 13101 and 13102 messages (Chapters 3.2.4 to 3.2.8) 5. Extended the message output rate configuration scope of 13220 message. (Chapter 3.2.10) 6. Updated the debug message IDs in 13220, 13221 and 13222 messages. (Chapters 3.2.10 to 3.2.12) LG69T(AQ)_GNSS_Protocol_Specification 3 / 48 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index .................................................................................................................................................. 5 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 2 NMEA Protocol .................................................................................................................................... 8 Structure of NMEA Protocol Messages.................................................................................. 8 Standard Messages ............................................................................................................. 10 2.2.1. RMC .............................................................................................................................. 10 2.2.2. GSV ............................................................................................................................... 12 2.2.3. GGA............................................................................................................................... 14 2.2.4. GSA ............................................................................................................................... 16 2.2.5. VTG ............................................................................................................................... 18 2.2.6. GLL................................................................................................................................ 19 PQTM Message.................................................................................................................... 21 2.3.1. PQTMVERNO ............................................................................................................... 21 3 Binary Protocol ................................................................................................................................. 23 Structure of Binary Protocol Messages................................................................................ 23 Message ............................................................................................................................... 25 3.2.1. Message Response (13000)......................................................................................... 25 3.2.2. System Status Request (13001) ................................................................................... 26 3.2.3. System Status Response (10500) ................................................................................ 27 3.2.3.1. GNSS Temperature Conversion ........................................................................... 28 3.2.4. Reset Request (13002) ................................................................................................. 29 3.2.5. Shutdown Request (13005) .......................................................................................... 32 3.2.6. Set Configuration (13100) ............................................................................................. 33 3.2.7. Get Configuration (13101) ............................................................................................ 35 3.2.8. Save Configuration (13102) .......................................................................................... 35 3.2.9. Configuration Response (13103) .................................................................................. 36 3.2.10. Set Message Rate (13220) ........................................................................................... 37 3.2.11. Get Message Rate (13221)........................................................................................... 40 3.2.12. Message Rate Response (13222) ................................................................................ 41 4 RTCM Protocol .................................................................................................................................. 44 5 Appendix A References .................................................................................................................... 45 6 Appendix B GNSS (NMEA) Numbering .......................................................................................... 47 7 Appendix C Special Characters ...................................................................................................... 48 LG69T(AQ)_GNSS_Protocol_Specification 4 / 48 GNSS Module Series Table Index Table 1: Supported Protocols ....................................................................................................................... 7 Table 2: Structure of NMEA Protocol Messages.......................................................................................... 8 Table 3: NMEA Talker ID .............................................................................................................................. 9 Table 4: Data Types.................................................................................................................................... 23 Table 5: Head Field .................................................................................................................................... 24 Table 6: Reset Mask Bits............................................................................................................................ 29 Table 7: Special Reset Mask Values .......................................................................................................... 30 Table 8: Parameter Types .......................................................................................................................... 34 Table 9: Supported RTCM3 Messages ...................................................................................................... 44 Table 10: Related Document...................................................................................................................... 45 Table 11: Terms and Abbreviations ............................................................................................................ 45 Table 12: GNSS Satellite (NMEA) Numbering ........................................................................................... 47 Table 13: Special Characters ..................................................................................................................... 48 LG69T(AQ)_GNSS_Protocol_Specification 5 / 48 GNSS Module Series Figure Index Figure 1: Structure of NMEA Protocol Messages ........................................................................................ 8 Figure 2: Structure of Binary Protocol Messages ...................................................................................... 23 LG69T(AQ)_GNSS_Protocol_Specification 6 / 48 GNSS Module Series 1 Introduction Quectel LG69T (AQ) module supports GPS, Galileo, and BDS constellations. The tracking of GPS L1 C/A, GPS L5, Galileo E1, Galileo E5a, BDS B1l and BDS B2a frequency bands provides fast and accurate acquisition and makes this module an ideal solution for positioning and navigation in various vertical markets. This document describes the software commands that are needed to control and modify the module configuration. The software commands are NMEA proprietary commands defined by Quectel (PQTM message). To report GNSS information, the module supports output messages in NMEA 0183 standard protocol and Binary protocol format. The LG69T (AQ) module supports the following protocols: Table 1: Supported Protocols Protocol NMEA 0183 V4.11 Binary RTCM 10403.3 Type Output, ASCII, standard Input/output, ASCII, proprietary Input/Output, binary, proprietary Input, binary, standard NOTE Quectel assumes no responsibility if commands other than the ones listed herein are used. LG69T(AQ)_GNSS_Protocol_Specification 7 / 48 GNSS Module Series 2 NMEA Protocol Structure of NMEA Protocol Messages Start of sentence character. Always Address field - contains talker identifier and sentence formatter Starts with a * 8-bit checksum value converted to two ASCII characters Data field(s), delimited by , End of sentence. Always $ () [,] * Range for checksum calculation Figure 1: Structure of NMEA Protocol Messages Table 2: Structure of NMEA Protocol Messages Field $ Address Description Start of the sentence (Hex 0x24). In Standard Messages: In standard messages, this field consists of a two-character talker identifier (TalkerID) and a three-character sentence formatter (SentenceFormatter). The talker identifier identifies the type of talker. For more information on the TalkerID, see Table 3: NMEA Talker ID. The sentence formatter identifies the data type and the string format of the successive fields. Data In Proprietary Messages: In proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer's Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. Data fields, delimited by the data field delimiter ‘,’. Variable length (depends on the NMEA message type). LG69T(AQ)_GNSS_Protocol_Specification 8 / 48 GNSS Module Series Field Checksum Description Checksum field follows the checksum delimiter character *. Checksum is the 8-bit exclusive OR of all characters in the sentence, including ‘,’ the field delimiter, between but not including the $ and the * delimiters. End of the sentence (Hex 0x0D 0x0A). Table 3: NMEA Talker ID GNSS Constellation Configuration GPS Galileo BDS Combination of Multiple Satellite Systems. TalkerID (NMEA V4.11) GP GA GB GN NMEA Checksum Sample Code: // pData is the data array whose checksum must be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL == pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^= *(pData + i); } return result; } LG69T(AQ)_GNSS_Protocol_Specification 9 / 48 GNSS Module Series Standard Messages This chapter explains the standard NMEA 0183 V4.11 messages supported by LG69T (AQ). 2.2.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type: Output Synopsis: $RMC,,,,,,,,,,,,,* Parameter: Field $ Format Unit Character - String, 2 characters - RMC String, 3 characters - hhmmss.sss - Character - ddmm.mmmmmm - Character - Example Description $ GN RMC 070747.100 A 3029.466780 N Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. Recommended Minimum Specific GNSS Data. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status: A = Data valid V = Navigation receiver warning. Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. North-south direction. LG69T(AQ)_GNSS_Protocol_Specification 10 / 48 GNSS Module Series Field Format dddmm.mmmmmm Character Numeric Numeric ddmmyy - Character Unit - Knot Degree - - Example Description 11430.071463 E 0.020 090.00 191223 N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. East-west direction. E = East W = West Note that this field is empty in case of an invalid value. Speed over ground. Variable length. Note that this field is empty in case of an invalid value. Course over ground. Variable length. Note that this field is empty in case of an invalid value. Date: dd: Day of month mm: Month yy: Year - Magnetic variation. Not supported. Direction of magnetic variation. Not - supported. Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix. D = Differential mode. Satellite system used in differential mode in A position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS). E = Estimated (dead reckoning) mode. F = Float RTK. Satellite system LG69T(AQ)_GNSS_Protocol_Specification 11 / 48 GNSS Module Series Field Format Character Hexadecimal Character Unit Example - V - *3A - - Description used in RTK mode with floating integers. N = No fix. Satellite system not used in position fix, or fix not valid. R = Real Time Kinematic (RTK). Satellite system used in RTK mode with fixed integers. Navigational status. Not supported. Always 'V' (Navigational status not valid). Checksum. Carriage return and line feed. Example: $GNRMC,070747.100,A,3029.466780,N,11430.071463,E,0.020,090.00,191223,,,A,V*3A 2.2.2. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value, and contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of sentences being transmitted and the sentence number are indicated in the first two data fields. Type: Output Synopsis: $GSV,,,{,,,,}, * Parameter: Field $ GSV Format Unit Character - String, 2 characters - String, 3 characters - Example Description $ GA GSV Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. GNSS Satellites in View. LG69T(AQ)_GNSS_Protocol_Specification 12 / 48 GNSS Module Series Field Format Numeric Numeric Numeric Unit Example Description - 2 - 1 Total number of sentences. Range: 1–9. Sentence number. Range: 1–. - 06 Total number of satellites in view. Start of repeat block. Repeat times: 1–4. Numeric - 01 Numeric Numeric Numeric End of repeat block. Degree 43 Degree 166 dB-Hz 43 Numeric - 7 Hexadecimal - *79 Satellite ID. See Table 12: GNSS Satellite (NMEA) Numbering. Satellite elevation. Range: 00–90. Satellite azimuth, with true north as the reference plane. Range: 000–359. Satellite C/N0. Range 00–99. Null when not tracking. GNSS signal ID. See Table 12: GNSS Satellite (NMEA) Numbering. Checksum. Character - - Carriage return and line feed. Example: $GAGSV,2,1,06,01,43,166,43,12,38,261,38,24,24,318,37,26,28,046,38,7*79 $GAGSV,2,2,06,31,67,279,45,33,66,351,46,7*7E NOTE GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, GSV sentences are output with the corresponding talker ID for each constellation, respectively. LG69T(AQ)_GNSS_Protocol_Specification 13 / 48 GNSS Module Series 2.2.3. GGA Global Positioning System Fix Data. Time, position, and fix-related data for a GNSS receiver. Type: Output Synopsis: $GGA,,,,,,,,,,M,,M,,* Parameter: Field $ GGA Format Unit Character - String, 2 characters - String, 3 characters - hhmmss.sss - ddmm.mmmmmm - Character - dddmm.mmmmm - m Example Description $ Each NMEA message starts with $. Talker identifier. GN See Table 3: NMEA Talker ID. GGA Global Positioning System Fix Data. 032941.424 3149.331769 N 11706.949769 Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. North-south direction. N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of LG69T(AQ)_GNSS_Protocol_Specification 14 / 48 GNSS Module Series Field Format Unit Example Character - E Numeric, 1 digit - 6 1) Numeric, 2 digits - 17 Numeric - - Numeric Meter 48.937 M Character - M Numeric Meter -0.310 M Character - - M - - Description an invalid value. East-west direction. E = East W = West Note that this field is empty in case of an invalid value. GPS quality indicator: 0 = Fix not available or invalid 1 = GPS SPS Mode, fix valid 2 = Differential GPS, SPS Mode, or Satellite Based Augmentation System (SBAS), fix valid 3 = GPS PPS Mode, fix valid 4 = Real Time Kinematic (RTK). System used in RTK mode with fixed integers 5 = Float RTK. Satellite system used in RTK mode, floating integers 6 = Estimated (dead reckoning) mode Number of satellites in use. Horizontal dilution of precision. Maximum value: 99.0. Altitude above mean-sea-level (geoid). Note that this field is empty in case of an invalid value. Unit of . 'M' = Meter. Geoid separation (the difference between the earth ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). Note that this field is empty in case of an invalid value. Unit of . 'M' = Meter. Differential GPS data age. Not supported. LG69T(AQ)_GNSS_Protocol_Specification 15 / 48 GNSS Module Series Field Format Hexadecimal Character Unit Example - - - *47 - - Description Differential reference station ID. Not supported. Checksum. Carriage return and line feed. Example: $GNGGA,032941.424,3149.331769,N,11706.949769,E,6,17,,48.937,M,-0.310,M,,*47 NOTE 1. The NMEA 0183 specification indicates that the GGA message is GPS specific. However, when the receiver is configured for multi-constellations, the content of GGA message will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12. 2.2.4. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA sentence, and DOP values. Type: Output Synopsis: $GSA,,{,},,,* Parameter: Field $ GSA Format Unit Example Description Character - String, 2 characters - String, 3 characters - Character - $ GN GSA A Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. GNSS DOP and Active Satellites. Selection of 2D or 3D fix. M = Manual, forced to operate in 2D or 3D LG69T(AQ)_GNSS_Protocol_Specification 16 / 48 GNSS Module Series Field Format Unit Example Description Numeric - 3 mode A = Automatic, allowed to automatically switch to 2D or 3D mode. Fix mode. 1 = Fix not available 2 = 2D 3 = 3D Start of repeat block. Repeat times: 12. Numeric - 01 Satellite ID used in solution. See Table 12: GNSS Satellite (NMEA) Numbering. Note that this field is empty in case of an invalid value. End of repeat block. Numeric Numeric Numeric Numeric - - - - - - - 3 Position dilution of precision. Maximum value: 99.99. Horizontal dilution of precision. Maximum value: 99.99. Vertical dilution of precision. Maximum value: 99.99. GNSS system ID. See Table 12: GNSS Satellite (NMEA) Numbering. Hexadecimal - *1C Checksum. Character - - Carriage return and line feed. Example: $GNGSA,A,3,01,33,,,,,,,,,,,,,,3*1C $GNGSA,A,3,07,27,30,32,38,40,46,,,,,,,,,4*17 $GNGSA,A,3,01,03,06,14,17,19,,,,,,,,,,1*10 NOTE If less than 12 satellites are used for navigation, the remaining SatID fields are left empty. If more than 12 satellites are used for navigation, only the IDs of the first 12 are output. LG69T(AQ)_GNSS_Protocol_Specification 17 / 48 GNSS Module Series 2.2.5. VTG Course Over Ground & Ground Speed. The actual course and speed relative to the ground. Type: Output Synopsis: $VTG,,T,,M,,N,,K,* Parameter: Field $ VTG T M N K Format Unit Example Description Character - $ String, 2 characters - GN String, 3 characters - VTG Numeric Degrees 340.84 Character - T Numeric Degrees - Character - M Numeric Knots 9.710 Character - N Numeric km/h 17.982 Character - K Character - D Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. Course Over Ground & Ground Speed. Course over ground, in true north direction. Fixed field: true. Course over ground (magnetic). Not supported. Fixed field: magnetic. Speed over ground in knots. Note that this field is empty in case of an invalid value. Fixed field: knot. Speed over ground in kilometers per hour. Note that this field is empty in case of an invalid value. Fixed field: kilometers per hour Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. LG69T(AQ)_GNSS_Protocol_Specification 18 / 48 GNSS Module Series Field Format Hexadecimal Character Unit Example Description Corrections from ground stations or Satellite Based Augmentation System (SBAS). E = Estimated (dead reckoning) mode. N = Data not valid - *17 Checksum. - - Carriage return and line feed. Example: $GNVTG,340.84,T,,M,9.710,N,17.982,K,D*17 2.2.6. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type: Output. Synopsis: $GLL,,,,,,,* Parameter: Field $ GLL Format Unit Example Description Character - String, 2 characters - String, 3 characters - ddmm.mmmmmm - $ GN GLL 3149.332460 Each NMEA message starts with $. Talker identifier. See Table 3: NMEA Talker ID. Geographic Position Latitude/Longitude. Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. LG69T(AQ)_GNSS_Protocol_Specification 19 / 48 GNSS Module Series Field Format Unit Example Description Character - dddmm.mmmmmm - Character - hhmmss.sss - Character - Character - N 11706.948123 E 033610.217 A A North-south direction. N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. East-west direction. E = East W = West Note that this field is empty in case of an invalid value. Position UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status: A = Data valid V = Data not valid Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS). E = Estimated (dead reckoning) mode. N = Data not valid Hexadecimal - *4F Checksum. Character - - Carriage return and line feed. LG69T(AQ)_GNSS_Protocol_Specification 20 / 48 Example: $GNGLL,3149.332460,N,11706.948123,E,033610.217,A,A*4F GNSS Module Series PQTM Message This chapter explains the PQTM messages (proprietary NMEA messages defined by Quectel) supported by LG69T (AQ). 2.3.1. PQTMVERNO Queries the firmware version information. Type: Command Synopsis: $PQTMVERNO, Parameter: None Result: ⚫ If successful, the module returns: $PQTMVERNO,,,* Parameters included in the result: Field Format Unit String - yyyy/mm/dd - hh:mm:ss - Description Firmware version Firmware build date Firmware build time ⚫ If failed, the module returns: $PQTMVERNO,ERROR,* LG69T(AQ)_GNSS_Protocol_Specification 21 / 48 GNSS Module Series Parameter included in the result: Field Format Unit Numeric - Description Error code. 1 = Invalid parameters. 2 = Execution failure. Example: //Query the firmware version: $PQTMVERNO*58 //Respond with the firmware version: $PQTMVERNO,LG69TAPNR11A01_CPA4,2023/02/15,22:46:48*5B LG69T(AQ)_GNSS_Protocol_Specification 22 / 48 GNSS Module Series 3 Binary Protocol Structure of Binary Protocol Messages The header of the frame, fixed at 0x2E 0x31 2 Bytes 4 Bytes 1 Byte 1 Byte 2 Bytes 4 Bytes 4 Bytes 4 Bytes Header Reserved CRC Protocol Version Message Version Message Type Sequence Number Payload Size Source Identifier Payload The range for checksum calculation Figure 2: Structure of Binary Protocol Messages Table 4: Data Types Data Type Size (Byte) u8 1 u16 2 u32 4 u8[N] N f32 4 Description Decimal value range: 0–255. Hexadecimal value range: 0–0xFF. Example: If 28 is used, it is 1C in the binary protocol. Decimal value range: 0–65535. Hexadecimal value range: 0–0xFFFF. Example: If 28 is used, it is 1C 00 in the binary protocol. Value range: 0–4294967295. Hexadecimal value range: 0–0xFFFFFFFF. Example: If 28 is used, it is1C 00 00 00 in the binary protocol. Multiple u8 data present in series. Value range refers to u8. Decimal value range: -3.4 × 1038 to 3.4 × 1038. Hexadecimal value range: 0xFFFFFFFF to 0x7FFFFFFF. Example: If 28 is used, it is 00 00 41 E0 in the binary protocol. LG69T(AQ)_GNSS_Protocol_Specification 23 / 48 Table 5: Head Field Field Header Type u8[2] Reserved u8[2] CRC u32 Protocol Version u8 Message Version u8 Message Type u16 Sequence u32 Number Payload Size u32 Source Identifier u32 CRC calculation code: Generate CRC Table uint32_t crc_table[256]; void Make_CRC32table(void) { uint32_t value; uint16_t i,j; for(i=0;i<256;i++) { value=i; GNSS Module Series Description 2-Byte Header of the binary protocol frame: 0x2E, 0x31. Reserved for future use. Filled with 0. 32-Bit CRC of all bytes from and including the protocol version field to the last byte in the message, including the message payload, which uses the standard CRC32 generator polynomial in reversed order. Polynomial: x32 + x26 + x23 + x22 + x16 + x12 + x11 + x10 + x8 + x7 + x5 + x4 + x2 + x + 1 Version of the protocol. See the definition of each command for details. Version of each message. See the definition of each command for details. Unique identification of each message. The combination of Message Version and Message Type should be used to decide on payload decoding method. 4-Byte serial number: For input message, a custom number can be filled in. For output message, the sequence number is generated incrementally. Size of the payload in Bytes. Identifies the source of the message when applicable. This definition can be changed depending on the message type. The value will be 0x00, 0x00, 0x00, 0x00 if undefined. LG69T(AQ)_GNSS_Protocol_Specification 24 / 48 for(j=0;j>1)^0xedb88320; } else { value=(value>>1); } } crc_table[i]=value; } } Calculate the CRC on a buffer of known length uint32_t Calculate_CRC32(uint8_t*buffer,uint16_tlength) { uint32_t crc32=0xFFFFFFFF; while(length--) { crc32=crc_table[(crc32&0xFF)^*buffer++]^(crc32>>8); } return crc32^0xFFFFFFFF; } NOTE Binary messages are in little endian format. GNSS Module Series Message 3.2.1. Message Response (13000) A generic response to input messages (13002, 13005, 13100, 13102 and 13220). Type: Output LG69T(AQ)_GNSS_Protocol_Specification 25 / 48 GNSS Module Series Structure: Field Type Head u8[24] Source Sequence u32 Number Response Code u8 Reserved u8[3] Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13000 (0x32C8) Sequence number of the request message which the module is responding to. Indicates response type: 0x00 = OK 0x01 = Unsupported Command 0x02 = Unsupported Feature 0x03 = Value Error 0x04 = Insufficient Space 0x05 = Execution Failure 0x06 = Inconsistent Payload Length 0x07 = Data Corrupted Reserved for future use. Filled with 0. Example: //Send reset request to restore the module to factory settings (FACTORY_RESET) (13002 message): 2E 31 00 00 3F E8 C5 39 00 00 CA 32 00 00 00 00 04 00 00 00 00 00 00 00 FF FF FF FF //Respond with OK: 2E 31 00 00 D9 46 4E D6 02 00 C8 32 D9 06 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 3.2.2. System Status Request (13001) Queries system status information. Only the temperature of GNSS receiver (10500 message) can be queried by 13001 currently. Type: Command Structure: Field Head Type u8[24] Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13001 (0x32C9) LG69T(AQ)_GNSS_Protocol_Specification 26 / 48 GNSS Module Series Field Message Type Reserved Type u16 u8[2] Description Type of the message to be requested. Supported Message Type: 10500 (0x2904) Reserved for future use. Filled with 0. Result: Returns 10500 message. Example: //Query system status information, i.e., the temperature of GNSS receiver currently: 2E 31 00 00 0A 89 C8 7F 02 00 C9 32 00 00 00 00 04 00 00 00 00 00 00 00 04 29 00 00 //Response to 13001 message that the temperature of GNSS receiver is 45 °C (0x1680) (10500 message): 2E 31 00 00 6B 1F 89 E2 02 00 04 29 2B 17 00 00 80 00 00 00 00 00 00 00 92 1C 00 00 C4 E3 30 20 00 1A 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 3.2.3. System Status Response (10500) Reports system status. At present, only the temperature of the GNSS receiver is reported. Type: Output Structure: Field Head Time Type u8[24] u32[2] Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 10500 (0x2904) Time accumulated from GPS Time (1980/6/1) including Seconds and Fraction. Seconds is the integer seconds accumulated from the reference epoch. 0xFFFFFFFF = Invalid Fraction is the fractional part of the timestamp in nanoseconds. 0xFFFFFFFF = Invalid LG69T(AQ)_GNSS_Protocol_Specification 27 / 48 GNSS Module Series Field Type GNSS Temperature i16 Reserved u8[118] Description Temperature of the GNSS receiver in Celsius. 0x7FFF = Invalid Calculation: Convert hexadecimal data to decimal data first and then multiply it by 2^-7. See Chapter 3.2.3.1 GNSS Temperature Conversion for details. Reserved for future use. Fixed at 00. Example: //Query system status information, i.e., the temperature of GNSS receiver currently (13001 message): 2E 31 00 00 0A 89 C8 7F 02 00 C9 32 00 00 00 00 04 00 00 00 00 00 00 00 04 29 00 00 //Response to 13001 message that the temperature of GNSS receiver is 52 °C (0x1A00): 2E 31 00 00 6B 1F 89 E2 02 00 04 29 2B 17 00 00 80 00 00 00 00 00 00 00 92 1C 00 00 C4 E3 30 20 00 1A 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 3.2.3.1. GNSS Temperature Conversion This section introduces how to convert the GNSS Temperature from hexadecimal data to temperature in Celsius, taking the following 10500 message as an example. 10500 Message Example: 2E 31 00 00 6B 1F 89 E2 02 00 04 29 2B 17 00 00 80 00 00 00 00 00 00 00 92 1C 00 00 C4 E3 30 20 00 1A 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Calculation: 1. The value in red (0x00 0x1A) in the example above is the GNSS Temperature. Binary messages are transmitted in little endian format, so the valid data is 0x1A 0x00. 2. Convert hexadecimal data to decimal data, i.e., 1A 00 = 6656. 3. Multiply the decimal data by 2^-7, i.e., 6656 × 2^-7 = 52 °C. LG69T(AQ)_GNSS_Protocol_Specification 28 / 48 GNSS Module Series 3.2.4. Reset Request (13002) Restarts the system and deletes positioning related information. Performs a specified group of reset operations. Type: Command Structure: Field Head Reset Mask Type u8[24] u32 Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13002 (0x32CA) Bit mask indicating the components to be reset. See Table 6: Reset Mask Bits. See Table 7: Special Reset Mask Values. Table 6: Reset Mask Bits Bit Name 0 RESTART_NAVIGATION_ENGINE 1 RESET_GNSS_CORRECTIONS 2–7 Reserved 8 RESET_POSITION_DATA 9 RESET_EPHEMERIS 10 RESET_FAST_IMU_CORRECTIONS 11 Reserved 12 RESET_NAVIGATION_ENGINE_DATA Description Restarts the navigation engine, but does not clear its position estimate. Valid example: 0x01, 0x00, 0x00, 0x00. Deletes all GNSS correction information. Valid example: 0x02, 0x00, 0x00, 0x00. Reserved for future use. Resets the navigation engine’s estimate of position, velocity, and orientation. Valid example: 0x00, 0x01, 0x00, 0x00. Deletes all saved satellite ephemeris. Valid example: 0x00, 0x02, 0x00, 0x00. Resets bias estimates, and other IMU corrections that are typically estimated quickly. Valid example: 0x00, 0x04, 0x00, 0x00. Reserved for future use. Resets all stored navigation engine data, including position, velocity, and orientation state, as well as all IMU corrections (fast and LG69T(AQ)_GNSS_Protocol_Specification 29 / 48 GNSS Module Series Bit Name 13 RESET_CALIBRATION_DATA 14-19 Reserved 20 RESET_CONFIG 21-23 Reserved 24 RESET_GNSS_MEASUREMENT_ENGINE 25 REBOOT_NAVIGATION_PROCESSOR 26-31 Reserved Description slower) and other training data. Valid example: 0x00, 0x10, 0x00, 0x00. Resets the module calibration data. Note: This does not reset the existing navigation engine state. It is recommended to use RESET_NAVIGATION_ENGINE_DATA under normal circumstances if the existing navigation state needs to be reset. Valid example: 0x00, 0x20, 0x00, 0x00. Reserved for future use. Resets all configuration settings back to factory defaults. Valid example: 0x00, 0x00, 0x10, 0x00. Reserved for future use. Restarts the GNSS measurement engine, performing a cold start to clear all position and satellite data. Valid example: 0x00, 0x00, 0x00, 0x01. Reboots the processor on which the navigation software is executed. Valid example: 0x00, 0x00, 0x00, 0x02. Reserved for future use. Table 7: Special Reset Mask Values Value Name 0x01, 0x00, 0x00, 0x00 HOT_START Description Performs a hot start. A hot start is typically used to restart the navigation engine in a deterministic state, particularly for logging purposes. Reset: ● Navigation engine ● All runtime data (GNSS corrections, etc.) Do not reset: ● Position, velocity, orientation state ● Fast IMU corrections ● Training parameters (slowly estimated IMU corrections, temperature, compensation, etc.) ● Calibration data ● User configuration settings LG69T(AQ)_GNSS_Protocol_Specification 30 / 48 GNSS Module Series Value Name Description ● GNSS measurement engine 0x01, 0x02, 0x00, 0x00 0xFF, 0x0F, 0x00, 0x00 0xFF, 0xFF, 0xFF, 0xFF WARM_START COLD_START FACTORY_RESET Performs a warm start. A warm start is typically used to reset the module's position estimate in case of an error. Reset: ● Navigation engine ● All runtime data (GNSS corrections, etc.) ● Position, velocity, orientation state Do not reset: ● Fast IMU corrections ● Training parameters (slowly estimated IMU corrections, temperature, compensation, etc.) ● Calibration data ● User configuration settings ● GNSS measurement engine Performs a cold start. A cold start is typically used to reset the module's state estimate in case of an error that cannot be resolved by a warm start. To reset training or calibration data as well, set the RESET_NAVIGATION_ENGINE_DATA and RESET_CALIBRATION_DATA bits. Reset: ● Navigation engine ● All runtime data (GNSS corrections, etc.) ● Position, velocity, orientation state ● Fast IMU corrections ● GNSS measurement engine Not reset: ● Training parameters (slowly estimated IMU corrections, temperature, compensation, etc.) ● Calibration data ● User configuration settings Restart mask to set all persistent data, including position/orientation, calibration and user configuration, back to factory settings. Result: Returns 13000 message. LG69T(AQ)_GNSS_Protocol_Specification 31 / 48 GNSS Module Series Example: //Send HOT_START request: 2E 31 00 00 35 D9 0C 95 02 00 CA 32 00 00 00 00 04 00 00 00 00 00 00 00 01 00 00 00 //Respond with OK (13000 message): 2E 31 00 00 21 EB E1 0D 02 00 C8 32 00 00 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 //Send WARM_START request: 2E 31 00 00 5B 0D 88 96 02 00 CA 32 00 00 00 00 04 00 00 00 00 00 00 00 01 02 00 00 //Respond with OK (13000 message): 2E 31 00 00 67 D0 86 68 02 00 C8 32 01 00 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 //Send COLD_START request: 2E 31 00 00 9C FF E9 F8 02 00 CA 32 00 00 00 00 04 00 00 00 00 00 00 00 FF 0F 00 00 //Respond with OK (13000 message): 2E 31 00 00 AD 9D 2F C7 02 00 C8 32 02 00 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 NOTE Fast IMU corrections, training parameters and calibration data supported only by LG69T (AQ). 3.2.5. Shutdown Request (13005) Powers off the module and sets whether to save the active configuration. Type: Command Structure: Name Head Flag Reserved Type u8[24] u8 u8[15] Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13005 (0x32CD) Bitmask flag used to control the shutdown process. It is recommended to set it to 0x00. 0x00 = Save all active parameters to persistent storage 0x01 = Revert active configuration to previously saved values 0x02 = Reset active and saved configuration to default values Reserved for future use. Filled with 0. LG69T(AQ)_GNSS_Protocol_Specification 32 / 48 GNSS Module Series Result: Returns 13000 message. Example: //Send shutdown request: 2E 31 00 00 71 6F 54 14 02 00 CD 32 00 00 00 00 10 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 //Respond with OK (13000 message): 2E 31 00 00 5A F8 75 B0 02 00 C8 32 9D 98 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 3.2.6. Set Configuration (13100) Sets the parameters of a user configuration. Type: Set Structure: Field Head Type u8[24] Parameter Type u16 Flags u8 Reserved u8 Value Length u32 Parameter Value Variable Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13100 (0x332C) Type of parameter to be configured. See Table 8: Parameter Types. Bitmask flag to modify the command. 0x00 = The current value is set to a temporary run value 0x01 = The current value is set to the stored value Reserved for future use. Filled with 0. Parameter value length in Bytes. Parameter value. See Table 8: Parameter Types. LG69T(AQ)_GNSS_Protocol_Specification 33 / 48 GNSS Module Series Table 8: Parameter Types Parameter Type (DEC) 0 256 257 Parameter Name Type (HEX) Parameter Description Value 0x00 0x00 Invalid None Invalid parameter. 0x00 0x01 UART 1 Baud Rate u32 0x01 0x01 UART 2 Baud Rate u32 UART 1 baud rate in bits/second. Common numbers: 115200 = 0x00 0xC2 0x01 0x00 230400 = 0x00 0x03 0x84 0x00 460800 = 0x00 0x08 0x07 0x00 921600 = 0x00 0x10 0x0E 0x00 UART 2 baud rate in bits/second. Common numbers: 115200 = 0x00 0xC2 0x01 0x00 230400 = 0x00 0x03 0x84 0x00 460800 = 0x00 0x08 0x07 0x00 921600 = 0x00 0x10 0x0E 0x00 Result: Returns 13000 message. Example: //Set UART 1 baud rate to 460800 bps: 2E 31 00 00 4F 72 07 79 02 00 2C 33 00 00 00 00 0C 00 00 00 00 00 00 00 00 01 00 00 04 00 00 00 00 08 07 00 //Respond with OK (13000 message): 2E 31 00 00 8E E0 7B F9 02 00 C8 32 E9 3A 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 //Set UART 2 baud rate to 460800 bps: 2E 31 00 00 20 3E A2 E2 02 00 2C 33 00 00 00 00 0C 00 00 00 00 00 00 00 01 01 00 00 04 00 00 00 00 08 07 00 //Respond with OK (13000 message): 2E 31 00 00 64 77 53 4A 02 00 C8 32 0E 50 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 NOTE If the default value is not given for any parameter in a Set command, you can query it with the corresponding Get command if the default setting has not been changed by Set command. If the default setting had been changed by Set command, contact Quectel Technical Support (support@quectel.com) to get the default setting if necessary. LG69T(AQ)_GNSS_Protocol_Specification 34 / 48 GNSS Module Series 3.2.7. Get Configuration (13101) Gets the parameters of a user configuration. Type: Get Structure: Field Head Type u8[24] Parameter Type u16 Configuration u8 Source Reserved u8 Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13101 (0x332D) Type of parameter to be obtained. See Table 8: Parameter Types. Data source to be obtained (active, saved, etc.). 0x00 = Active configuration settings currently in use by the module 0x01 = Settings currently saved in persistent storage Reserved for future use. Filled with 0. Result: Returns 13103 message. Example: //Get UART 2 baud rate: 2E 31 00 00 F4 5C E6 BB 02 00 2D 33 00 00 00 00 04 00 00 00 00 00 00 00 01 01 00 00 //Response to 13101 command that the baud rate of UART 2 is 460800 bps (13103 message): 2E 31 00 00 74 16 08 0E 02 00 2F 33 14 33 00 00 10 00 00 00 00 00 00 00 00 00 01 01 00 00 00 00 04 00 00 00 00 08 07 00 3.2.8. Save Configuration (13102) Saves or reloads configuration settings. Type: Command LG69T(AQ)_GNSS_Protocol_Specification 35 / 48 GNSS Module Series Structure: Name Head Save Action Reserved Type u8[24] u8 u8[3] Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13102 (0x332E) Configuration saving method. 0x00 = Save all active parameters to persistent storage 0x01 = Revert active configuration to previously saved values 0x02 = Reset active and saved configuration to default values Reserved for future use. Filled with 0. Result: Returns 13000 message. Example: //Save or reload configuration settings: 2E 31 00 00 C4 8C 1E E8 02 00 2E 33 00 00 00 00 04 00 00 00 00 00 00 00 00 00 00 00 //Respond with OK (13000 message): 2E 31 00 00 4D 46 85 BD 02 00 C8 32 DC 9F 08 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 3.2.9. Configuration Response (13103) A response to configuration query (13101). Type: Output Structure: Field Head Type u8[24] Configuration u8 Source Active Differs from u8 Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13103 (0x332F) Source of parameter value (active, saved, etc.). 0x00 = Active configuration settings currently in use by the module 0x01 = Settings currently saved in persistent storage Whether the active values are the same as the saved values. LG69T(AQ)_GNSS_Protocol_Specification 36 / 48 GNSS Module Series Field Saved Parameter Type Response Code Reserved Value Length Parameter Value Type u16 u8 u8[3] u32 Variable Description 0x00 = Same 0x01 = Different Type of parameter to be output. Set to 0 if the configuration query was rejected. See Table 8: Parameter Types. Indicates response type: 0x00 = OK 0x01 = Unsupported Command 0x02 = Unsupported Feature 0x03 = Value Error 0x04 = Insufficient Space 0x05 = Execution Failure 0x06 = Inconsistent Payload Length 0x07 = Data Corrupted Reserved for future use. Filled with 0. Length of the parameter value in Bytes. Using a format described below for the specified parameter type. See Table 8: Parameter Types. Example: //Get UART 2 baud rate (13101 message): 2E 31 00 00 F4 5C E6 BB 02 00 2D 33 00 00 00 00 04 00 00 00 00 00 00 00 01 01 00 00 //Response to 13101 command that the baud rate of UART 2 is 460800 bps: 2E 31 00 00 74 16 08 0E 02 00 2F 33 14 33 00 00 10 00 00 00 00 00 00 00 00 00 01 01 00 00 00 00 04 00 00 00 00 08 07 00 3.2.10. Set Message Rate (13220) Enables/disables an individual message on a specified output interface, or configures its output rate. Type: Set Structure: Field Head Type u8[24] Description See Table 5: Head Field. Protocol Version: 02 LG69T(AQ)_GNSS_Protocol_Specification 37 / 48 Field Transport Type Index Reserved Protocol Type Flags Message ID GNSS Module Series Type u8 u8 u8[2] u8 u8 u16 Description Message Version: 00 Message Type: 13220 (0x33A4) Transport type of target interface. 0x00 = Invalid 0x01 = Serial Port Transport type identifier. Only when the value of Transport Type is 0x01, the following values are valid. 0x00 = Invalid 0x01 = UART 1 0x02 = UART 2 Reserved for future use. Filled with 0. Message protocol being configured. 0x00 = Invalid 0x01 = Debug 0x02 = NMEA Bitmask flag to modify the command. 0x00 = Current value is set to a temporary run value. 0x01 = Current value is set to the stored value. 0x11 = Current value as well as the previously unsaved temporary run value are set to the stored value. Message ID for different message type to be configured. Only when the value of Protocol Type is 0x01, the following values are valid. For details on the following debug messages except 10500, refer to document [1] application note. 0x04 0x29 = 10500 0x74 0x2B = 11124 0x76 0x2B = 11126 0xF8 0x2A = 11000 0xEB 0x2E = 12011 Only when the value of Protocol Type is 0x02, the following values are valid. For details on P1CALSTATUS message, refer to document [1] application note. 0x00 0x00 = Invalid 0x01 0x00 = GGA 0x02 0x00 = GLL 0x03 0x00 = GSA 0x04 0x00 = GSV 0x05 0x00 = RMC 0x06 0x00 = VTG 0xB0 0x04 = PQTMVERNO 0xE8 0x03 = P1CALSTATUS LG69T(AQ)_GNSS_Protocol_Specification 38 / 48 GNSS Module Series Field Message Rate Reserved Type u8 u8[3] Description Enable/disable/set the message output interval. 0x00 = Disable 0x01 = Output message at default rate When Message ID is configured as standard NMEA messages, the following values are valid. Besides, the 10500 message also supports the message output rate from 0x06 to 0x0C. 0x02 = 10 ms 0x03 = 20 ms 0x04 = 40 ms 0x05 = 50 ms 0x06 = 100 ms 0x07 = 200 ms 0x08 = 500 ms 0x09 = 1 s 0x0A = 2 s 0x0B = 5 s 0x0C = 10 s Reserved for future use. Filled with 0. Result: Returns 13000 message. Example: //Disable the GGA message output on UART 1: 2E 31 00 00 C6 C6 2F A9 02 00 A4 33 00 00 00 00 0C 00 00 00 00 00 00 00 01 01 00 00 02 00 01 00 00 00 00 00 //Response to 13220 command that the GGA message output on UART 1 is disabled (13000 message): 2E 31 00 00 21 EB E1 0D 02 00 C8 32 00 00 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 //Set 10500 message output interval to 1 s on UART 1: 2E 31 00 00 DD 59 C3 60 02 00 A4 33 00 00 00 00 0C 00 00 00 00 00 00 00 01 01 00 00 01 01 04 29 09 00 00 00 //Respond with OK (13000 message): 2E 31 00 00 67 D0 86 68 02 00 C8 32 01 00 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 //10500 message is output at 1 s interval 2E 31 00 00 6B 1F 89 E2 02 00 04 29 2B 17 00 00 80 00 00 00 00 00 00 00 92 1C 00 00 C4 E3 30 20 00 1A 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 LG69T(AQ)_GNSS_Protocol_Specification 39 / 48 GNSS Module Series //Set the GGA message output interval to 10 s on UART 2: 2E 31 00 00 7F 1F 1B 7A 02 00 A4 33 00 00 00 00 0C 00 00 00 00 00 00 00 01 02 00 00 02 00 01 00 0C 00 00 00 //Respond with OK (13000 message): 2E 31 00 00 4C B0 57 CD 02 00 C8 32 CB 0F 01 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 NOTE 1. PQTMVERNO, P1CALSTATUS and debug messages except 10500 message do not support configuring the output interval, i.e., they only support enabling or disabling the output interval. 2. The 10500 message supports partial output interval configuration. For details on the supported output interval, see the description of Message Rate field. 3.2.11. Get Message Rate (13221) Queries the current output interval for the specified requested message type. Type: Get Structure: Field Head Type u8[24] Transport Type u8 Index u8 Reserved u8[2] Protocol Type u8 Configuration Source u8 Description See Table 5: Head Field. Protocol Version: 02 Message Version: 00 Message Type: 13221 (0x33A5) Transport type of target interface (serial port). 0x00 = Invalid 0x01 = Serial Port Transport type identifier. Only when the value of Transport Type is 0x01, the following values are valid. 0x00 = Invalid 0x01 = UART 1 0x02 = UART 2 Reserved for future use. Fixed at 0. Message protocol being queried. 0x00 = Invalid 0x01 = Debug 0x02 = NMEA Data source to be obtained (active, saved, etc.). LG69T(AQ)_GNSS_Protocol_Specification 40 / 48 GNSS Module Series Field Message ID Type u16 Description 0x00 = Active configuration settings currently in use by the device. 0x01 = Settings currently saved in persistent storage. Message ID to be queried. Only when the value of Protocol Type is 0x01, the following values are valid. For details on the following debug messages except 10500, refer to document [1] application note. 0x04 0x29 = 10500 0x74 0x2B = 11124 0x76 0x2B = 11126 0xF8 0x2A = 11000 0xEB 0x2E = 12011 Only when the value of Protocol Type is 0x02, the following values are valid. For details on P1CALSTATUS message, refer to document [1] application note. 0x00 0x00 = Invalid 0x01 0x00 = GGA 0x02 0x00 = GLL 0x03 0x00 = GSA 0x04 0x00 = GSV 0x05 0x00 = RMC 0x06 0x00 = VTG 0xB0 0x04 = PQTMVERNO 0xE8 0x03 = P1CALSTATUS Result: Returns 13222 message. Example: //Query the output rate of the GGA message on UART 1: 2E 31 00 00 9B FA EF FB 02 00 A5 33 00 00 00 00 08 00 00 00 00 00 00 00 01 01 00 00 02 00 01 00 //Response to 13221 command that the GGA message output on UART1 is disabled (13222 message): 2E 31 00 00 C4 20 72 4C 02 01 A6 33 26 28 02 00 10 00 00 00 00 00 00 00 00 00 01 00 01 01 00 00 02 01 01 00 00 00 00 00 3.2.12. Message Rate Response (13222) A response to message rate query (13221). Type: Output LG69T(AQ)_GNSS_Protocol_Specification 41 / 48 GNSS Module Series Structure: Field Head Type u8[24] Configuration Source u8 Response Code u8 Number of messages u16 Transport Type u8 Index u8 Reserved Protocol Type u8[2] u8 Flags u8 Message ID u16 Description See Table 5: Head Field. Protocol Version: 02 Message Version: 01 Message Type: 13222 (0x33A6) Source of parameter value (active, saved, etc.). 0x00 = Active configuration settings currently in use by the module 0x01 = Settings currently saved in persistent storage Response type: 0x00 = OK 0x01 = Unsupported Command 0x02 = Unsupported Feature 0x03 = Value Error 0x04 = Insufficient Space 0x05 = Execution Failure 0x06 = Inconsistent Payload Length 0x07 = Data Corrupted Number of messages reported in this message. Fixed at 01 00. Transport type of target interface (serial port). 0x00 = Invalid 0x01 = Serial Port Transport type identifier. Only when the value of Transport Type is 0x01, the following values are valid. 0x00 = Invalid 0x01 = UART 1 0x02 = UART 2 Reserved for future use. Filled with 0. Message protocol types. 0x00 = Invalid 0x01 = Debug 0x02 = NMEA Whether the active values are the same as the saved values. 0x00 = Different 0x01 = Same Message ID for different message type. 0x00 0x00 = Invalid 0x01 0x00 = GGA 0x02 0x00 = GLL 0x03 0x00 = GSA LG69T(AQ)_GNSS_Protocol_Specification 42 / 48 GNSS Module Series Field Configured Rate Effective Rate Reserved Type u8 u8 u8[2] Description 0x04 0x00 = GSV 0x05 0x00 = RMC 0x06 0x00 = VTG 0xB0 0x04 = PQTMVERNO 0xE8 0x03 = P1CALSTATUS 0x04 0x29 = 10500 0x74 0x2B = 11124 0x76 0x2B = 11126 0xF8 0x2A = 11000 0xEB 0x2E = 12011 Whether the message output interval is enabled or the configured message output interval. 0x00 = Disable 0x01 = Enable 0x02 = 10 ms 0x03 = 20 ms 0x04 = 40 ms 0x05 = 50 ms 0x06 = 100 ms 0x07 = 200 ms 0x08 = 500 ms 0x09 = 1 s 0x0A = 2 s 0x0B = 5 s 0x0C = 10 s Not supported. Its value is consistent with Configured Rate. Filled with 0. Example: //Query the output rate of the GGA message on the UART 1 (13221 message): 2E 31 00 00 9B FA EF FB 02 00 A5 33 00 00 00 00 08 00 00 00 00 00 00 00 01 01 00 00 02 00 01 00 //Response to 13221 command that the GGA message output interval is 1 s on UART1: 2E 31 00 00 F2 2E 7C A2 02 01 A6 33 BE 71 02 00 10 00 00 00 00 00 00 00 00 00 01 00 01 01 00 00 02 01 01 00 09 09 00 00 LG69T(AQ)_GNSS_Protocol_Specification 43 / 48 GNSS Module Series 4 RTCM Protocol The LG69T (AQ) module supports the RTCM protocol which complies with RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services - Version 3. This protocol is used to input the real-time differential correction data and is available from https://www.rtcm.org/. Table 9: Supported RTCM3 Messages Message Type Type Message Name 1005 Input Stationary RTK Reference Station ARP. 1006 Input Stationary RTK Reference Station ARP with Antenna Height. 1074 Input GPS MSM4 1075 Input GPS MSM5 1076 Input GPS MSM6 1077 Input GPS MSM7 1094 Input Galileo MSM4 1095 Input Galileo MSM5 1096 Input Galileo MSM6 1097 Input Galileo MSM7 1124 Input BDS MSM4 1125 Input BDS MSM5 1126 Input BDS MSM6 1127 Input BDS MSM7 LG69T(AQ)_GNSS_Protocol_Specification 44 / 48 GNSS Module Series 5 Appendix A References Table 10: Related Document Document Name [1] Quectel_LG69T(AQ)_DR&RTK_Application_Note Table 11: Terms and Abbreviations Abbreviation 2D 3D BDS COG COGM COGT DOP Galileo GGA GLL GNSS GPS GSA GSV HDOP Description 2 Dimension 3 Dimension Beidou Navigation Satellite System Course over Ground Course over Ground (in Magnetic North Course Direction) Course over Ground (in True North Course Direction) Dilution of Precision Galileo Satellite Navigation System (EU) Global Positioning System Fix Data Geographic Position - Latitude and Longitude Global Navigation Satellite System Global Positioning System GNSS DOP and Active Satellites GNSS Satellites in View Horizontal Dilution of Precision LG69T(AQ)_GNSS_Protocol_Specification 45 / 48 Abbreviation NMEA PDOP PPS RMC RTCM RTK SBAS SNR SPS UTC VDOP VTG UART GNSS Module Series Description National Marine Electronics Association Position Dilution of Precision Pulse Per Second Recommended Minimum Specific GNSS Data Radio Technical Commission for Maritime Services Real-Time Kinematic Satellite-Based Augmentation System Signal to Noise Ratio Standard Positioning Service Universal Time Coordinated Vertical Dilution of Precision Course Over Ground & Ground Speed Universal Asynchronous Receiver/Transmitter LG69T(AQ)_GNSS_Protocol_Specification 46 / 48 GNSS Module Series 6 Appendix B GNSS (NMEA) Numbering Table 12: GNSS Satellite (NMEA) Numbering GNSS Type System ID Satellite ID GPS 1 1–32 Galileo 3 1–36 BDS 4 1–64 Signal ID 1 = L1 C/A 8 = L5-Q 1 = E5a 7 = L1-BC 1 = B1I 5 = B2-a NOTE The table above is only applicable to standard NMEA messages. LG69T(AQ)_GNSS_Protocol_Specification 47 / 48 GNSS Module Series 7 Appendix C Special Characters Table 13: Special Characters Special Character [...] {…} Underline Definition Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. LG69T(AQ)_GNSS_Protocol_Specification 48 / 48

LC29H 系列&LC79H (AL) GNSS 协议规范 GNSS 模块系列 版本：1.1 日期：2024-03-12 状态：受控文件 LC29H 系列&LC79H (AL) GNSS 协议规范 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 文档历史 文档信息 标题 副标题 文档类别 文档状态 LC29H 系列&LC79H (AL) GNSS 协议规范 GNSS 模块系列 GNSS 协议规范 受控文件 修订记录 版本 1.0 日期 2023-03-28 2023-11-29 1.1 2024-03-12 变更表述 文档创建 受控版本 1. 删除 LC29H (EA)不支持$PQTMEPE 消息的备注（第 2.3.4 章）。 2. 更新$PQTMPVT 语句输出频率范围，新增有关 LC29H (BA, CA, DA, EA)语句输出频率的备注（第 2.3.5 章）。 3. 删除仅 LC29H (AA, EA)和 LC79H (AL)支持$PQTMCFGGEOFENCE 命令的备注（第 2.3.6 章）。 4. 删 除 有 关 仅 LC29H (CA) 支 持 $PQTMGNSSSTART 和 $PQTMGNSSSTOP 命令的备注（第 2.3.10 和 2.3.11 章）。 5. 删除仅 LC29H (BA, CA)支持$PQTMPVT 消息的备注（第 2.3.12 章）。 6. 新增如下 PQTM 消息（第 2.3.16~2.3.30 章）： ⚫ $PQTMCOLD ⚫ $PQTMHOT ⚫ $PQTMWARM ⚫ $PQTMSRR ⚫ $PQTMCFGSBAS ⚫ $PQTMCFGCNST ⚫ $PQTMDOP ⚫ $PQTMCFGFIXRATE 上海移远通信技术股份有限公司 3 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 ⚫ $PQTMCFGPPS ⚫ $PQTMDEBUGON ⚫ $PQTMDEBUGOFF ⚫ $PQTMVEL ⚫ $PQTMCFGODO ⚫ $PQTMRESETODO ⚫ $PQTMODO 7. 新增$PAIR066 支持的仅 BDS 星系的 GNSS 搜索模式（第 2.4.15 章）。 8. 删除$PAIR490、$PAIR491、$PAIR690 和$PAIR691 语句。 上海移远通信技术股份有限公司 4 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 8 1 引言 ....................................................................................................................................................... 9 1.1. 适用模块 ................................................................................................................................... 10 2 NEMA 协议.......................................................................................................................................... 11 2.1. NMEA 协议消息结构 .................................................................................................................11 2.2. 标准语句 ................................................................................................................................... 13 2.2.1. RMC .............................................................................................................................. 13 2.2.2. GGA............................................................................................................................... 15 2.2.3. GSV ............................................................................................................................... 18 2.2.4. GSA ............................................................................................................................... 20 2.2.5. VTG ............................................................................................................................... 22 2.2.6. GLL................................................................................................................................ 23 2.2.7. ZDA ............................................................................................................................... 25 2.2.8. GRS............................................................................................................................... 26 2.2.9. GST ............................................................................................................................... 29 2.3. PQTM 消息（专有语句）......................................................................................................... 30 2.3.1. PQTMVERNO ............................................................................................................... 31 2.3.2. PQTMSAVEPAR ........................................................................................................... 32 2.3.3. PQTMRESTOREPAR ................................................................................................... 32 2.3.4. PQTMEPE..................................................................................................................... 33 2.3.5. PQTMCFGMSGRATE................................................................................................... 34 2.3.6. PQTMCFGGEOFENCE ................................................................................................ 36 2.3.7. PQTMGEOFENCESTATUS.......................................................................................... 38 2.3.8. PQTMCFGSVIN ............................................................................................................ 38 2.3.9. PQTMSVINSTATUS...................................................................................................... 40 2.3.10. PQTMGNSSSTART ...................................................................................................... 41 2.3.11. PQTMGNSSSTOP ........................................................................................................ 42 2.3.12. PQTMPVT ..................................................................................................................... 43 2.3.13. PQTMCFGNMEADP..................................................................................................... 45 2.3.14. PQTMCFGRCVRMODE ............................................................................................... 46 2.3.15. PQTMPL........................................................................................................................ 48 2.3.16. PQTMCOLD .................................................................................................................. 49 2.3.17. PQTMHOT .................................................................................................................... 50 2.3.18. PQTMWARM................................................................................................................. 50 2.3.19. PQTMSRR .................................................................................................................... 51 2.3.20. PQTMCFGSBAS........................................................................................................... 52 2.3.21. PQTMCFGCNST .......................................................................................................... 53 2.3.22. PQTMDOP .................................................................................................................... 55 上海移远通信技术股份有限公司 5 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.23. PQTMCFGFIXRATE ..................................................................................................... 56 2.3.24. PQTMCFGPPS ............................................................................................................. 57 2.3.25. PQTMDEBUGON.......................................................................................................... 59 2.3.26. PQTMDEBUGOFF ........................................................................................................ 60 2.3.27. PQTMVEL ..................................................................................................................... 60 2.3.28. PQTMCFGODO ............................................................................................................ 61 2.3.29. PQTMRESETODO........................................................................................................ 63 2.3.30. PQTMODO.................................................................................................................... 64 2.4. PAIR 消息（专有语句） ........................................................................................................... 65 2.4.1. PAIR001: PAIR_ACK .................................................................................................... 65 2.4.2. PAIR002: PAIR_GNSS_SUBSYS_POWER_ON.......................................................... 66 2.4.3. PAIR003: PAIR_GNSS_SUBSYS_POWER_OFF........................................................ 66 2.4.4. PAIR004: PAIR_GNSS_SUBSYS_HOT_START ......................................................... 67 2.4.5. PAIR005: PAIR_GNSS_SUBSYS_WARM_START...................................................... 68 2.4.6. PAIR006: PAIR_GNSS_SUBSYS_COLD_START ....................................................... 68 2.4.7. PAIR007: PAIR_GNSS_SUBSYS_FULL_COLD_START ............................................ 69 2.4.8. PAIR010: PAIR_REQUEST_AIDING ............................................................................ 69 2.4.9. PAIR050: PAIR_COMMON_SET_FIX_RATE............................................................... 70 2.4.10. PAIR051: PAIR_COMMON_GET_FIX_RATE .............................................................. 71 2.4.11. PAIR058: PAIR_COMMON_SET_MIN_SNR ............................................................... 72 2.4.12. PAIR059: PAIR_COMMON_GET_MIN_SNR ............................................................... 73 2.4.13. PAIR062: PAIR_COMMON_SET_NMEA_OUTPUT_RATE ......................................... 74 2.4.14. PAIR063: PAIR_COMMON_GET_NMEA_OUTPUT_RATE ........................................ 75 2.4.15. PAIR066: PAIR_COMMON_SET_GNSS_SEARCH_MODE ....................................... 76 2.4.16. PAIR067: PAIR_COMMON_GET_GNSS_SEARCH_MODE ....................................... 78 2.4.17. PAIR070: PAIR_COMMON_SET_STATIC_THRESHOLD ........................................... 80 2.4.18. PAIR071: PAIR_COMMON_GET_STATIC_THRESHOLD .......................................... 80 2.4.19. PAIR072: PAIR_COMMON_SET_ELEV_MASK .......................................................... 81 2.4.20. PAIR073: PAIR_COMMON_GET_ELEV_MASK.......................................................... 82 2.4.21. PAIR074: PAIR_COMMON_SET_AIC_ENABLE ......................................................... 83 2.4.22. PAIR075: PAIR_COMMON_GET_AIC_STATUS ......................................................... 84 2.4.23. PAIR080: PAIR_COMMON_SET_NAVIGATION_MODE ............................................. 85 2.4.24. PAIR081: PAIR_COMMON_GET_NAVIGATION_MODE ............................................ 86 2.4.25. PAIR086: PAIR_COMMON_SET_DEBUGLOG_OUTPUT .......................................... 87 2.4.26. PAIR087: PAIR_COMMON_GET_DEBUGLOG_OUTPUT .......................................... 88 2.4.27. PAIR100: PAIR_COMMON_SET_NMEA_OUTPUT_MODE ....................................... 89 2.4.28. PAIR101: PAIR_COMMON_GET_NMEA_OUTPUT_MODE ....................................... 90 2.4.29. PAIR104: PAIR_COMMON_SET_DUAL_BAND .......................................................... 91 2.4.30. PAIR105: PAIR_COMMON_GET_DUAL_BAND.......................................................... 92 2.4.31. PAIR382: PAIR_TEST_LOCK_SYSTEM_SLEEP ........................................................ 93 2.4.32. PAIR391: PAIR_TEST_JAMMING_DETECT ............................................................... 94 2.4.33. PAIR400: PAIR_DGPS_SET_MODE............................................................................ 95 2.4.34. PAIR401: PAIR_DGPS_GET_MODE ........................................................................... 96 2.4.35. PAIR410: PAIR_SBAS_ENABLE .................................................................................. 97 上海移远通信技术股份有限公司 6 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.36. 2.4.37. 2.4.38. 2.4.39. 2.4.40. 2.4.41. 2.4.42. 2.4.43. 2.4.44. 2.4.45. 2.4.46. 2.4.47. 2.4.48. 2.4.49. 2.4.50. PAIR411: PAIR_SBAS_GET_STATUS ......................................................................... 98 PAIR432: PAIR_RTCM_SET_OUTPUT_MODE .......................................................... 99 PAIR433: PAIR_RTCM_GET_OUTPUT_MODE ........................................................ 100 PAIR434: PAIR_RTCM_SET_OUTPUT_ANT_PNT................................................... 100 PAIR435: PAIR_RTCM_GET_OUTPUT_ANT_PNT .................................................. 101 PAIR436: PAIR_RTCM_SET_OUTPUT_EPHEMERIS .............................................. 102 PAIR437: PAIR_RTCM_GET_OUTPUT_EPHEMERIS ............................................. 103 PAIR511: PAIR_NVRAM_SAVE_NAVIGATION_DATA .............................................. 104 PAIR513: PAIR_NVRAM_SAVE_SETTING................................................................ 105 PAIR650: PAIR_LOW_POWER_ENTRY_RTC_MODE ............................................. 106 PAIR752: PAIR_PPS_SET_CONFIG_CMD ............................................................... 107 PAIR864: PAIR_IO_SET_BAUDRATE ....................................................................... 107 PAIR865: PAIR_IO_GET_BAUDRATE ....................................................................... 109 PAIR866: PAIR_IO_SET_FLOW_CONTROL..............................................................110 PAIR867: PAIR_IO_GET_FLOW_CONTROL ............................................................. 111 3 RTCM 协议........................................................................................................................................ 112 4 附录 A 参考文档及术语缩写............................................................................................................. 114 5 附录 B GNSS 标识符 ........................................................................................................................ 117 6 附录 C 特殊字符 ............................................................................................................................... 118 上海移远通信技术股份有限公司 7 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 表格索引 表 1：支持的协议 ......................................................................................................................................... 9 表 2：适用模块 ........................................................................................................................................... 10 表 3：NMEA 语句结构.................................................................................................................................11 表 4：发送设备标识符助记码（Talker ID） ............................................................................................... 12 表 5：错误码............................................................................................................................................... 30 表 6：支持的语句 ....................................................................................................................................... 35 表 7：不同导航模式的海拔高度和速度范围 ............................................................................................... 85 表 8：支持的 RTCM3 消息 ....................................................................................................................... 112 表 9：参考文档 ......................................................................................................................................... 114 表 10：术语缩写 ....................................................................................................................................... 114 表 11：GNSS 标识符................................................................................................................................ 117 表 12：特殊字符 ....................................................................................................................................... 118 上海移远通信技术股份有限公司 8 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 1 引言 移远通信 LC29H 系列和 LC79H (AL) GNSS 模块支持 GPS、GLONASS、Galileo、BDS 和 QZSS 定 位，可以同时快速捕获跟踪 GPS L1 C/A、GLONASS L1、Galileo E1、BDS B1l、QZSS L1 C/A、GPS L5、 Galileo E5a、BDS B2a 和 QZSS L5 频段，成为各种垂直行业实现精准定位和导航的理想解决方案。 本文档主要介绍用于控制和配置模块所需的软件命令；所述命令是由移远通信或芯片供应商定义的 NMEA 专有语句（PAIR/PQTM 命令）。模块还支持通过 NMEA 0183 标准协议和 RTCM 协议输出语句上报 GNSS 信息。 LC29H 系列和 LC79H (AL) GNSS 模块支持以下协议： 表 1：支持的协议 协议 消息类型 NMEA 0183 V3.01/V4.10 输出，ASCII，标准 输入/输出，ASCII，专有 RTCM 10403.3 输出，二进制，标准 备注 请使用本文档列出的命令控制或配置模块；对本文档未列出的其他命令情况，移远通信不承担任何责任。 上海移远通信技术股份有限公司 9 / 118 1.1. 适用模块 表 2：适用模块 模块系列 LC29H LC79H 模块 LC29H (AA) LC29H (BA) LC29H (CA) LC29H (DA) LC29H (EA) LC79H (AL) LC29H 系列&LC79H (AL) GNSS 协议规范 上海移远通信技术股份有限公司 10 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2 NEMA 协议 2.1. NMEA 协议消息结构 每一帧的起始字段，固定 均为 $ 地址字段，包含了Talker ID和语句的属性 以 * 开始，校验和为8位 异或的校验和转换成的十六 进制的数 数据字段，使用 , 隔开 结束字符，固定为 $ () [,] * 校验和的计算范围 图 1：NMEA 协议消息结构 表 3：NMEA 语句结构 字段 $ 描述 NMEA 语句的起始字段（Hex 0x24）。 NMEA 标准语句： 通用地址字段由 5 个字符（大写字母）组成。通用地址字段前两个字母是发送设备标识符 （Talker ID），见表 4：发送设备标识符助记码（Talker ID），用于定义所传输数据的定位 模式。标准地址字段的后三个字符为通用语句标识符（SentenceFormatter），用于定义语 句中其它数据的格式和类型。 NMEA 专有语句： 专有地址字段由专有字符'P'、制造商助记码（三个字符）、以及可选附加字符组成。其 中制造商助记码用来标识发出一个专有语句的发送设备。 数据字段，由数据字段分隔符','分隔。 可变长度（取决于 NMEA 消息类型）。 所有的语句中都应包含校验和字段。校验和字段是语句中的最后一个字段，在校验和定界 上海移远通信技术股份有限公司 11 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 描述 符'*'之后。 校验和是对语句中所有字符的 8 位（不包括起始和结束位）进行异或运算，所有字符是指 在定界符'$'与'*'之间，但不包括这些定界符的全部字符，包括','在内。 NMEA 语句的结束字符（Hex 0x0D 0x0A）。 表 4：发送设备标识符助记码（Talker ID） GNSS 星系配置 GPS GLONASS Galileo BDS QZSS 组合星系 Talker ID (NMEA 0183 V3.01) GP GL GA GB GP GN Talker ID (NMEA 0183 V4.10) GP GL GA GB GP GN 备注 在 NMEA 0183 V4.10 中，LC29H (BA,CA,DA,EA)的 QZSS Talker ID 为 GQ。 NMEA 校验和示例代码： // pData is the data array whose checksum needs to be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL = = pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^ = *(pData + i); 上海移远通信技术股份有限公司 12 / 118 } return result; } LC29H 系列&LC79H (AL) GNSS 协议规范 2.2. 标准语句 本章节介绍模块支持的 NMEA 0183 V3.01 与 NMEA 0183 V4.10 标准语句。 2.2.1. RMC RMC 表示推荐的最少专有 GNSS 数据。本语句包含 GNSS 接收机提供的时间、日期、位置、航向和 速度数据。 类型： 输出 格式： NMEA 0183 V3.01： $RMC,,,,,,,,,,,,* NMEA 0183 V4.10（默认）： $RMC,,,,,,,,,,,,,* 参数： 字段 $ RMC 格式 字符 字符串，2 位 字符串，3 位 hhmmss.sss 单位 示例 - $ - GN - RMC - 093316.000 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（Talker ID）。 详见表 4：发送设备标识符助记码（Talker ID）。 推荐的最少专有 GNSS 数据。 定位的 UTC 时间。 hh：小时（00~23） 上海移远通信技术股份有限公司 13 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 单位 示例 描述 字符 - ddmm.mmmm - mm 字符 - dddmm.mmmm - mm 字符 - 十进制 节 十进制 度 ddmmyy - - - - - 字符 - A 3149.332558 N 11706.912570 E 0.00 237.67 140122 A mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 定位系统状态。 A = 数据有效 V = 导航接收机警告 纬度。 dd：度（00~90） mm：分（00~59） mmmmmm：分的十进制小数（可变长度） 数据无效时，此字段为空。 纬度方向。 N= 北 S= 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（(00~59） mmmmmm：分的十进制小数（可变长度） 数据无效时，此字段为空。 经度方向。 E= 东 W= 西 数据无效时，此字段为空。 对地速度。可变长度。 数据无效时，此字段为空。 对地真航向。可变长度。最大值：359.99。 数据无效时，此字段为空。 日期。 dd：日 mm：月 yy：年 磁偏角。暂不支持。 此字段为空。 磁偏角方向。暂不支持。 此字段为空。 模式指示。 A = 自主式模式，卫星系统处于非差分定位模 式。 D = 差分模式，卫星系统处于差分定位模式； 基于地面站或 SBAS 的修正。 上海移远通信技术股份有限公司 14 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 单位 示例 字符 - V 十六进制 字符 - 0B - - 描述 E = 估算（航位推算）模式。 F = RTK 浮点解模式。 N = 无定位，卫星系统没有用于定位，或定 位无效。 R = RTK 固定解模式。 导航状态，暂不支持。 始终为'V'（导航状态无效，设备不能提供 导航状态指示）。 注意，此参数只在 NMEA 0183 V4.10 及以上 版本的消息中支持。 校验和。 回车换行。 示例： NMEA 0183 V3.01： $GNRMC,093423.000,A,3149.332006,N,11706.913200,E,0.01,0.00,140122,,,A*79 NMEA 0183 V4.10： $GNRMC,093316.000,A,3149.332558,N,11706.912570,E,0.00,237.67,140122,,,A,V*0B 2.2.2. GGA GGA 提供全球定位系统定位数据。本语句包含 GNSS 接收机提供的时间、位置和定位相关数据。 类型： 输出 格式： NMEA 0183 V3.01： $GGA,,,,,,,,,,M,,M,,* NMEA 0183 V4.10（默认）： $GGA,,,,,,,,,,M,,M,,* 上海移远通信技术股份有限公司 15 / 118 参数： 字段 $ GGA LC29H 系列&LC79H (AL) GNSS 协议规范 格式 单位 示例 描述 字符 - 字符串，2 位 - 字符串，3 位 - hhmmss.sss - ddmm.mmmmmm - 字符 - dddmm.mmmmmm - 字符 - 十进制，1 位 - $ GN GGA 093316.000 3149.332558 N 11706.912570 E 1 每条 NMEA 语句均以'$'开始。 发 送 设 备 标 识 符 助 记 码 （ Talker ID）。详见表 4：发送设备标识符助 记码（Talker ID）。 全球定位系统定位数据。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 纬度。 dd：度（00~90） mm：分（00~59） mmmmm：分的十进制小数（可变 长度） 数据无效时，此字段为空。 纬度方向。 N= 北 S= 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmmmm：分的十进制小数（可 变长度） 数据无效时，此字段为空。 经度方向。 E= 东 W= 西 数据无效时，此字段为空。 GPS 定位模式/状态指示。 0 = 定位不可用或无效。 1 = GPS SPS 模式，定位有效。 2 = 差分 GPS、SPS 模式或 SBAS，定位有效。 4 = RTK 固定解模式。 5 = RTK 浮点解模式。 6 = 估算（航位推算）模式。 上海移远通信技术股份有限公司 16 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 1) 十进制，2 位 十进制 M 十进制 字符 十进制 M 2) 2) 字符 十进制 十进制 十六进制 字符 单位 示例 - 28 - 0.67 米 54.481 - M 米 -0.337 - M - - - - - *5D - - 描述 使用的卫星数。 数据无效时，此字段为空。 水平精度因子。可变长度。 范围：0.00~100.00。 数据无效时，此字段为空。 平均海平面以上海拔（大地水准 面）。可变长度。 数据无效时，此字段为空。 的单位。 'M' = 米。 大地水准面差距（WGS84 基准面 与平均海平面之间的差值）。可变长 度。 数据无效时，此字段为空。 的单位。 'M' = 米。 差分卫星导航系统数据龄期。 差分基准站标识号。 校验和。 回车换行。 示例： NMEA 0183 V3.01： $GNGGA,093423.000,3149.332006,N,11706.913200,E,1,22,0.75,45.346,M,-0.337,M,,*56 NMEA 0183 V4.10： $GNGGA,093316.000,3149.332558,N,11706.912570,E,1,28,0.67,54.481,M,-0.337,M,,*5D 备注 1. 根据 NMEA 0183 协议，GGA 语句为 GPS 系统特有；当接收机配置为多星系时，GGA 语句的内容 将从多星系解决方案中生成。 2. 1) 对于： ⚫ NMEA 0183 协议定义的使用中卫星数量范围为 00~12，然而，在多星系解决方案中，使用的卫 星数量可能超过 12 颗。 ⚫ 对于 LC29H (AA)和 LC79H (AL)，如果使用单频段（L1 或 L5）信号定位，GGA 中的 上海移远通信技术股份有限公司 17 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 将增加 1，如果使用同一卫星的双频段（L1 和 L5）信号定位，则增加 2。对于 LC29H (BA, CA, DA, EA) ， 使 用 同 一 卫 星 的 单 频 段 或 双 频 段 信 号 定 位 ， GGA 中 的 都将增加 1。 3. 2) 对于和： LC29H (BA, DA, EA)支持该参数，LC29H (AA, CA)和 LC79H (AL)不支持该参数。 2.2.3. GSV GSV 表示可视的 GNSS 卫星。本语句包含可视的卫星数、卫星标识号、仰角、方位角和信噪比。每个 GSV 语句最多包含 4 颗卫星的数据，因此可能需要多个语句才能获得完整的信息。数据字段的前两个字段 表示传输的总句数和语句号。 类型： 输出 格式： NMEA 0183 V3.01： $GSV,,,{,,,,}* NMEA 0183 V4.10（默认）： $GSV,,,{,,,,}, * 参数： 字段 $ 格式 字符 单位 - 字符串，2 位 - GSV 字符串，3 位 - 十进制 - 十进制 - 十进制 - 参数循环开始。循环次数：1~4 次。 示例 $ GP GSV 3 1 11 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（Talker ID）。详见表4： 发送设备标识符助记码（Talker ID）。 可视的GNSS卫星。 语句总数。范围：1~9。 语句号。范围：1~。 可视的卫星总数。 上海移远通信技术股份有限公司 18 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 十进制 十进制 十进制 十进制 参数循环结束。 单位 度 示例 08 76 度 353 dB-Hz 46 十进制 - 1 十六进制 - *5C 字符 - - 描述 卫星标识号。详见表 11：GNSS 标识符。 仰角。范围：00~90。 数据无效时，此字段为空。 真方位角。范围：000~359。 数据无效时，此字段为空。 载噪比（C/N0）。范围：00~99。 未跟踪时为空。 信号标识号。详见表 11：GNSS 标识符。 注意，此参数只在 NMEA 0183 V4.10 及以上 版本的消息中支持。 校验和。 回车换行。 示例： NMEA 0183 V3.01： $GPGSV,3,1,12,08,75,355,46,195,68,113,44,194,64,081,42,199,51,162,36*47 $GPGSV,3,2,12,27,45,037,44,21,44,156,43,16,30,072,39,30,18,317,38*72 $GPGSV,3,3,12,03,,,19,04,,,37,09,,,40,07,,,43*7C $GPGSV,2,1,08,08,75,355,38,195,68,113,38,194,64,081,38,199,51,162,38*4C $GPGSV,2,2,08,27,45,037,38,30,18,317,31,04,,,29,09,,,32*70 $GLGSV,1,1,04,86,63,182,32,85,59,041,42,76,36,333,41,66,07,278,*6A $GAGSV,1,1,00*68 $GAGSV,1,1,00*68 $GBGSV,3,1,12,29,82,083,41,07,64,319,41,09,54,220,40,36,47,113,45*66 $GBGSV,3,2,12,06,45,201,39,39,34,192,40,01,,,38,30,,,40*69 $GBGSV,3,3,12,16,,,41,05,,,31,02,,,36,13,,,35*6E $GBGSV,1,1,04,29,82,083,36,36,47,113,36,39,34,192,32,30,,,28*5F NMEA 0183 V4.10： $GPGSV,3,1,11,08,76,353,46,195,68,113,44,194,64,080,42,199,51,162,37,1*5C $GPGSV,3,2,11,27,45,037,43,07,44,315,43,21,43,156,44,16,30,071,39,1*6B $GPGSV,3,3,11,09,28,244,40,04,20,206,37,30,,,38,1*6F $GPGSV,2,1,08,08,76,353,35,195,68,113,34,194,64,080,33,199,51,162,34,8*5A $GPGSV,2,2,08,27,45,037,33,09,28,244,28,04,20,206,26,30,,,27,8*5E $GLGSV,1,1,03,85,59,042,41,76,35,333,40,66,07,279,32,1*43 $GAGSV,1,1,00,7*73 上海移远通信技术股份有限公司 19 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 $GAGSV,1,1,00,1*75 $GBGSV,4,1,13,07,64,319,41,40,61,345,43,36,47,113,43,06,45,201,40,1*7E $GBGSV,4,2,13,16,41,195,41,35,40,213,45,26,17,313,39,56,,,19,1*49 $GBGSV,4,3,13,57,,,37,01,,,39,02,,,36,60,,,40,1*7B $GBGSV,4,4,13,03,,,40,1*73 $GBGSV,1,1,04,40,61,345,32,36,47,113,32,35,40,213,29,26,17,313,23,5*79 备注 'GN'标识符不可用于该语句。如果有多个卫星系统可视，则设备输出多条 GSV 语句（发送设备标识符 'GP'表示可视的 GPS 卫星、'GL'表示可视的 GLONASS 卫星、'GA'表示可视的 Galileo 卫星、 'GB'表示可视的 BDS 卫星等）。 2.2.4. GSA GSA 表示 GNSS 精度因子（DOP）与有效卫星。本语句包含 GNSS 接收机工作模式，GGA 语句报告 的导航解算中用到的卫星以及精度因子的值。 类型： 输出 格式： NMEA 0183 V3.01： $GSA,,{,},,,* NMEA 0183 V4.10（默认）： $GSA,,{,},,,* 参数： 字段 $ GSA 格式 字符 单位 - 字符串，2 位 - 字符串，3 位 - 字符 - 示例 描述 $ GN GSA A 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（Talker ID）。详见表4：发送 设备标识符助记码（Talker ID）。 GNSS精度因子（DOP）与有效卫星。 2D 或 3D 定位模式。 M = 手动，强制用于 2D 或 3D 定位模式 上海移远通信技术股份有限公司 20 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 单位 十进制 - 参数循环开始。循环次数：12 次。 十进制 - 参数循环结束。 十进制 - 十进制 - 十进制 - 十进制 - 十六进制 - 字符 - 示例 描述 A = 自动，允许 2D/3D 定位模式自动变换 定位模式。 1 = 定位不可用 3 2 = 2D 定位 3 = 3D 定位 解算中用到的卫星标识号。详见表 11：GNSS 标识符。 08 数据无效时，此字段为空。 位置精度因子。最大值为 99.99。 1.03 数据无效时，此字段为空。 水平精度因子。最大值为 99.99。 0.67 数据无效时，此字段为空。 垂直精度因子。最大值为 99.99。 0.78 数据无效时，此字段为空。 GNSS 系统标识符。详见表 11：GNSS 标识符。 1 注意，此参数只在 NMEA 0183 V4.10 及以上版本的 消息中支持。 *3E 校验和。 - 回车换行。 示例： NMEA 0183 V3.01： $GPGSA,A,3,08,195,194,199,27,21,16,30,,,,,1.09,0.75,0.79*3C $GLGSA,A,3,86,85,76,,,,,,,,,,1.09,0.75,0.79*18 $GAGSA,A,3,,,,,,,,,,,,,1.09,0.75,0.79*17 $GBGSA,A,3,07,09,36,06,39,,,,,,,,1.09,0.75,0.79*13 NMEA 0183 V4.10： $GNGSA,A,3,08,195,194,199,27,07,21,16,09,04,,,1.03,0.67,0.78,1*3E $GNGSA,A,3,85,76,66,,,,,,,,,,1.03,0.67,0.78,2*02 $GNGSA,A,3,,,,,,,,,,,,,1.03,0.67,0.78,3*0F $GNGSA,A,3,07,40,36,06,16,35,26,,,,,,1.03,0.67,0.78,4*0D 上海移远通信技术股份有限公司 21 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 备注 如果用于定位导航的卫星少于 12 颗，则剩余的字段将为空。如果超过 12 颗卫星用于定位导航， 则仅输出前 12 颗卫星的卫星标识号。 2.2.5. VTG VTG 语句包含相对于地面的实际航向和速度。 类型： 输出 格式： NMEA 0183 V3.01： $VTG,,T,,M,,N,,K,* NMEA 0183 V4.10（默认）： $VTG,,T,,M,,N,,K,* 参数： 字段 $ VTG T M N 格式 字符 单位 - 字符串，2 位 - 字符串，3 位 - 十进制 度 字符 - 十进制 度 字符 - 十进制 节 字符 - 示例 $ GN VTG 237.67 T M 0.00 N 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（Talker ID）。详见 表 4：发送设备标识符助记码（Talker ID）。 相对于地面的实际航向和速度。 对地航向（真北）。 数据无效时，此字段为空。 固定字段：真。 对地航向（磁北）。 暂不支持。 固定字段：磁场。 对地速度，以节为单位。可变长度。 数据无效时，此字段为空。 固定字段：节。 上海移远通信技术股份有限公司 22 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 K 格式 十进制 字符 字符 十六进制 字符 单位 千米/时 - 示例 0.00 K - A - *24 - - 描述 对地速度。可变长度。 数据无效时，此字段为空。 固定字段：千米每时。 模式指示。 A = 自主式模式，卫星系统处于非差分定位 模式。 D = 差分模式，卫星系统处于差分定位模 式；基于地面站或 SBAS 的修正。 E = 估算（航位推算）模式。 N = 数据无效。 校验和。 回车换行。 示例： NMEA 0183 V3.01： $GNVTG,0.00,T,,M,0.01,N,0.02,K,A*20 NMEA 0183 V4.10： $GNVTG,237.67,T,,M,0.00,N,0.00,K,A*24 2.2.6. GLL GLL 表示地理位置——纬度和经度。本语句包含接收机的纬度与经度、定位时间和状态。 类型： 输出 格式： NMEA 0183 V3.01： $GLL,,,,,,,* NMEA 0183 V4.10（默认）： $GLL,,,,,,,* 上海移远通信技术股份有限公司 23 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 参数： 字段 $ GLL 格式 字符 字符串，2 位 字符串，3 位 单位 - ddmm.mmmmmm - 字符 - dddmm.mmmmmm - 字符 - hhmmss.sss - 字符 - 字符 - 示例 描述 $ GN GLL 3149.332558 N 11706.912570 E 093316.000 A A 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（Talker ID）。 详见表 4：发送设备标识符助记码 （Talker ID）。 地理位置——纬度和经度。 纬度。 dd：度（00~90） mm：分（00~59） mmmmmm：分的十进制小数（可变 长度） 数据无效时，此字段为空。 纬度方向。 N= 北 S= 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmmmm：分的十进制小数（可变 长度） 数据无效时，此字段为空。 经度方向。 E= 东 W= 西 数据无效时，此字段为空。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 定位系统状态。 A = 数据有效 V = 数据无效 模式指示。 A = 自主式模式，卫星系统处于非差 分定位模式 D = 差分模式，卫星系统处于差分定 位模式；基于地面站或 SBAS 的 修正 上海移远通信技术股份有限公司 24 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 十六进制 字符 单位 示例 - *45 - - 描述 E = 估算（航位推算）模式 N = 数据无效 校验和。 回车换行。 示例： NMEA 0183 V3.01： $GNGLL,3149.332006,N,11706.913200,E,093423.000,A,A*4B NMEA 0183 V4.10： $GNGLL,3149.332558,N,11706.912570,E,093316.000,A,A*45 2.2.7. ZDA ZDA 表示时间与日期。本语句主要是用于输出 UTC 时间，日、月、年及本地时区。 类型： 输出 格式： NMEA 0183 V3.01： $ZDA,,,,,,* NMEA 0183 V4.10（默认）： $ZDA,,,,,,* 参数： 字段 $ 格式 字符 字符串，2 位 单位 - 示例 $ - GN 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（Talker ID），详 见表 4：发送设备标识符助记码（Talker ID）。 上海移远通信技术股份有限公司 25 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 ZDA 格式 字符串，3 位 hhmmss.sss 十进制 十进制 十进制 十进制 十进制 十六进制 字符 单位 - - - 示例 描述 ZDA 时间与日期。 093316.000 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 14 日。范围：01~31。 01 月。范围：01~12。 2022 年。 - 本时区小时，00 至±13 时。暂不支持。 - 本时区分钟，00 至±59 分钟。暂不支持。 *40 校验和。 - 回车换行。 示例: NMEA 0183 V3.01： $GNZDA,093423.000,14,01,2022,,*41 NMEA 0183 V4.10： $GNZDA,093316.000,14,01,2022,,*40 备注 LC29H (BA, CA, DA, EA)不支持 ZDA 语句。 2.2.8. GRS GNSS 距离残差。此语句支持接收机自主完整性监测（RAIM）。在这个过程中，距离残差有两种计算 方法。大多数导航滤波器的基本测量积分周期产生一组残差，并用这些残差更新接收机的位置状态。 类型： 输出 上海移远通信技术股份有限公司 26 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： NMEA 0183 V3.01： $GRS,,{,}* NMEA 0183 V4.10（默认）： $GRS,,{,},,* 参数： 字段 $ GRS 格式 字符 字符串，2 位 字符串，3 位 hhmmss.sss 十进制 参数循环开始。循环次数：12。 十进制 参数循环结束。 十进制 十进制 十六进制 单位 示例 描述 - $ 每条 NMEA 语句均以'$'开始。 - GN 发送设备标识符助记码（Talker ID），详见 表 4：发送设备标识符助记码（Talker ID）。 - GRS GNSS 距离残差。 定位的 UTC 时间。 hh：小时（00~23） - 061549.000 mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 计算方法。 0 = 残差用于计算匹配的 GGA 或 GNS 语 - 1 句中给定的位置 1 = 计算 GGA 或 GNS 中位置后，重新计 算残差 米 6.2 用于导航的可视卫星距离残差。范围： -999~999。 数据无效时，此字段为空。 - 1 - 1 - *6F GNSS 系统标识符。详见表 11：GNSS 标 识符。 注意，此参数只在 NMEA 0183 V4.10 及以 上版本的消息中支持。 信号标识号。详见表 11：GNSS 标识符。 注意，此参数只在 NMEA 0183 V4.10 及以 上版本的消息中支持。 校验和。 上海移远通信技术股份有限公司 27 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 字符 单位 示例 - - 描述 回车换行。 示例: NMEA 0183 V3.01： $GNGRS,072520.000,1,-4.5,-133,-6.9,2.3,-4.3,-144,-4.9,-4.4,-2.2,-131,-76.7,-3.3*61 $GNGRS,072520.000,1,-4.5,,,,-4.3,,,-4.4,,,,-3.3*64 $GNGRS,072520.000,1,-2.3,0.3,-2.0,,,,,,,,,*4C $GNGRS,072520.000,1,-3.9,-4.6,3.0,-15.1,0.7,,,,,,,*58 $GNGRS,072520.000,1,-3.9,-4.6,3.0,-15.1,0.7,,,,,,,*58 $GNGRS,072520.000,1,-4.1,0.3,-0.2,6.1,-4.3,3.8,-0.2,-10.3,-6.6,1.8,12.2,-15.5*79 $GNGRS,072520.000,1,6.5,-6.3,1.9,-4.1,-141,0.5,,,,,,*5B $GNGRS,072520.000,1,-4.1,0.3,-0.2,,,,-0.2,,-6.6,,12.2,*55 $GNGRS,072520.000,1,,,1.9,,,0.5,,,,,,*6F NMEA 0183 V4.10： $GNGRS,061549.000,1,6.2,-7.5,0.4,-0.7,0.8,-8.6,4.0,4.1,7.7,7.2,2.0,-6.3,1,1*6F $GNGRS,061549.000,1,-4.8,5.2,-82.4,1.7,,,,,,,,,1,1*5C $GNGRS,061549.000,1,6.2,-7.5,,,0.8,-8.6,,4.1,,,,,1,8*4D $GNGRS,061549.000,1,-4.8,5.2,,,,,,,,,,,1,8*40 $GNGRS,061549.000,1,-2.5,11.2,-16.4,-1.5,,,,,,,,,2,1*43 $GNGRS,061549.000,1,-9.8,8.0,8.0,74.7,-16.2,-6.2,-101,,,,,,3,7*5F $GNGRS,061549.000,1,-9.8,8.0,8.0,74.7,-16.2,-6.2,,,,,,,3,1*44 $GNGRS,061549.000,1,-0.6,-2.0,-6.4,1.0,12.7,7.8,-18.0,3.3,-5.3,16.5,-7.6,-91.2,4,1*4D $GNGRS,061549.000,1,-3.8,5.9,-0.4,1.1,-107,-5.2,,,,,,,4,1*76 $GNGRS,061549.000,1,-0.6,-2.0,-6.4,,,,,3.3,,,,,4,4*44 $GNGRS,061549.000,1,-3.8,5.9,-0.4,1.1,,,,,,,,,4,4*6C 备注 1. LC29H (BA, CA, DA, EA)不支持 GRS 语句。 2. GRS 的卫星顺序与 GSA 中的卫星标识号顺序保持一致。如果残差超过±99.9 米，则小数部分被省略， 仅保留整数部分。 3. 计算方法：距离残差 = 计算距离 - 测量距离。 4. 若用于导航的卫星少于 12 颗，则余下的字段为空；若使用的卫星多于 12 颗，则全部 字段会通过多条 GSR 语句输出。 上海移远通信技术股份有限公司 28 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.2.9. GST GNSS 伪距误差统计。此语句支持接收机自主完整性监控（RAIM）。伪距测量误差统计可以在位置域 中转换，以得出位置解质量的统计度量。 类型： 输出 格式： NMEA 0183 V3.01： $GST,,,,,,,,* NMEA 0183 V4.10（默认）： $GST,,,,,,,,* 参数： 字段 $ 格式 字符 字符串，2 位 GST 字符串，3 位 hhmmss.sss 十进制 十进制 十进制 十进制 十进制 单位 - - 米 米 米 度 米 示例 描述 $ GN GST 061549.000 8.2 2.6 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（Talker ID）， 详见表 4：发送设备标识符助记码 （Talker ID）。 GNSS 伪距误差统计。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 导航过程中范围输入的标准偏差 RMS 值。 误差椭圆半长轴的标准偏差。 2.4 误差椭圆半短轴的标准偏差。 74.7 误差椭圆半长轴的方向。 2.4 纬度误差的标准偏差。 上海移远通信技术股份有限公司 29 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 十进制 十进制 十流进制 字符 单位 米 米 - 示例 2.6 8.5 *45 - 描述 经度误差的标准偏差。 高度误差的标准偏差。 校验和。 回车换行。 示例: NMEA 0183 V3.01： $GNGST,072520.000,6.5,2.9,2.3,98.2,2.3,2.9,11.2*79 NMEA 0183 V4.10： $GNGST,061549.000,8.2,2.6,2.4,74.7,2.4,2.6,8.5*45 备注 LC29H (BA, CA, DA, EA)不支持 GST 语句。 2.3. PQTM 消息（专有语句） 本章节介绍 LC29H 系列及 LC79H (AL)模块支持的 PQTM 消息（由移远通信定义的 NMEA 专有语句）。 表 5：错误码 字段 格式 十进制 单位 - 描述 错误码。 1 = 参数无效 2 = 执行失败 上海移远通信技术股份有限公司 30 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.1. PQTMVERNO 查询固件版本信息。 类型： 命令 格式： $PQTMVERNO* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMVERNO,,,* 结果中包含的参数： 字段 格式 单位 字符串 - yyyy/mm/dd - hh:mm:ss - 描述 固件版本 固件创建日期 固件创建时间 ⚫ 如果失败，模块返回： $PQTMVERNO,ERROR,* 详见表 5：错误码。 示例： $PQTMVERNO*58 $PQTMVERNO,LC29HAANR01A04S,2022/11/04,16:39:48*34 上海移远通信技术股份有限公司 31 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.2. PQTMSAVEPAR 保存配置到 NVM。 类型： 命令 格式： $PQTMSAVEPAR* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMSAVEPAR,OK* ⚫ 如果失败，模块返回： $PQTMSAVEPAR,ERROR,* 详见表 5：错误码。 示例： $PQTMSAVEPAR*5A $PQTMSAVEPAR,OK*72 2.3.3. PQTMRESTOREPAR 将所有命令配置的参数恢复为默认值。该命令重启后生效。 类型： 命令 格式： $PQTMRESTOREPAR* 上海移远通信技术股份有限公司 32 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMRESTOREPAR,OK* ⚫ 如果失败，模块返回： $PQTMRESTOREPAR,ERROR,* 详见表 5：错误码。 示例： $PQTMRESTOREPAR*13 $PQTMRESTOREPAR,OK*3B 2.3.4. PQTMEPE 输出估计的定位误差。 类型： 输出 格式： $PQTMEPE,,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 单位 米 米 米 米 描述 语句版本。 2 = 版本 2（此版本始终为 2） 估计北误差。 估计东误差。 估计高度误差。 估计 2D 位置误差。 上海移远通信技术股份有限公司 33 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 十进制 单位 米 描述 估计 3D 位置误差。 示例： $PQTMEPE,2,3.393,3.476,12.713,4.857,13.609*5D 2.3.5. PQTMCFGMSGRATE 设置/查询语句输出频率。 类型： 设置/查询 格式： //设置： $PQTMCFGMSGRATE,W,,[,]* //查询： $PQTMCFGMSGRATE,R,[,]* 参数： 字段 格式 字符串 十进制 十进制 单位 - - 描述 语句。详见表6：支持的消息。 语句输出频率。 0 = 不输出 N = 每 N 次定位输出一次 N 的范围详见表 6：支持的消息。 语句版本。可选字段。若需设置/查询NMEA 0183标准语句 的输出频率，该字段可以省略。 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGMSGRATE,OK* //查询命令响应： 上海移远通信技术股份有限公司 34 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 $PQTMCFGMSGRATE,OK,,[,]* ⚫ 如果失败，模块返回： $PQTMCFGMSGRATE,ERROR,* 详见表 5：错误码。 示例： //设置$PQTMGEOFENCESTATUS 语句为每定位一次输出一次： $PQTMCFGMSGRATE,W,PQTMGEOFENCESTATUS,1,1*5C $PQTMCFGMSGRATE,OK*29 //查询$PQTMGEOFENCESTATUS 语句的输出频率： $PQTMCFGMSGRATE,R,PQTMGEOFENCESTATUS,1*44 $PQTMCFGMSGRATE,OK,PQTMGEOFENCESTATUS,1,1*0F //设置$PQTMEPE 语句的输出频率为每定位一次输出一次： $PQTMCFGMSGRATE,W,PQTMEPE,1,2*1D $PQTMCFGMSGRATE,OK*29 //查询$PQTMEPE 语句的输出频率： $PQTMCFGMSGRATE,R,PQTMEPE,2*05 $PQTMCFGMSGRATE,OK,PQTMEPE,1,2*4E 表 6：支持的语句 语句 $PQTMSVINSTATUS $PQTMGEOFENCESTATUS $PQTMEPE $PQTMPVT $PQTMPL $PQTMDOP $PQTMVEL 语句输出频率范围（N）1) 1~20 1~20 1~20 1~20 1~20 1~20 1~20 上海移远通信技术股份有限公司 35 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 语句 $PQTMODO 语句输出频率范围（N）1) 1~20 备注 1. 若需设置/查询 PQTM 语句，则需通过字段指定语句版本，否则模块将报错。 2. 1) LC29H (BA, CA, DA, EA)仅支持设置语句输出频率为 1 Hz。 3. 若需获取设置命令中部分参数未给出的默认值，可在未使用设置命令修改相关参数配置前，通过对应 的查询命令获取相应的默认值；若已使用设置命令修改过默认配置，可联系移远通信技术支持 （support@quectel.com）来获取相关默认配置信息。 2.3.6. PQTMCFGGEOFENCE 设置/查询地理围栏功能。 类型： 设置/查询 格式： //设置： $PQTMCFGGEOFENCE,W,,,,,,,[,,,,,]* //查询： $PQTMCFGGEOFENCE,R,* 参数： 字段 格式 十进制 单位 - 十进制 - 十进制 - 十进制 - 描述 地理围栏数。范围：0~3。 地理围栏功能状态。 0 = 禁用 1 = 启用 预留。始终为 0。 地理围栏形状。 0 = 由圆心和半径定义的圆 1 = 由圆心和圆上一点定义的圆 上海移远通信技术股份有限公司 36 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 单位 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 度 度 度或米 度 度 度 度 度 描述 2 = 三角形 3 = 四边形（如正方形、矩形、梯形等） 第一个点的纬度。 第一个点的经度。 如果地理围栏形状为具有一定半径的圆，则该值为圆的 半径，否则该值为第二个点的纬度。 第二个点的经度。 第三点的纬度。 第三点的经度。 第四点的纬度。 第四点的经度。 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGGEOFENCE,OK* //查询命令响应： $PQTMCFGGEOFENCE,OK,,,,,,,[,< Lon1>,,,,]* ⚫ 如果失败，模块返回： $PQTMCFGGEOFENCE,ERROR,* 详见表 5：错误码。 示例： //设置： $PQTMCFGGEOFENCE,W,0,1,0,0,31.451248,117.451245,100.5*18 $PQTMCFGGEOFENCE,OK*74 //查询： $PQTMCFGGEOFENCE,R,0*3E $PQTMCFGGEOFENCE,OK,0,1,0,0,31.451248,117.451245,100.500000*7B 上海移远通信技术股份有限公司 37 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.7. PQTMGEOFENCESTATUS 输出地理围栏状态。 类型： 输出 格式： $PQTMGEOFENCESTATUS,,{,}* 参数： 字段 格式 十进制 hhmmss.sss 参数循环开始。循环次数：4。 单位 - 十进制 - 参数循环结束。 描述 语句版本。 1 = 版本 1（此版本始终为 1） UTC 时间。 地理围栏 N 状态。N 的范围：0~3。 0 = 未知 1 = 内部 2 = 外部 示例： $PQTMGEOFENCESTATUS,1,093444.000,2,0,0,0*29 2.3.8. PQTMCFGSVIN 设置/查询测量（survey-in）功能。 为使模块作为基站运行，模块外部天线应安装在固定点上。天线精确的坐标位置可以通过自测过程获 得。测量（Survey-in）模式（ = 1）通过建立所有有效 3D 定位解决方案的加权平均值来确定接收 机的位置。可通过设置和确定用于位置估计的最小观测时间和 3D 定位标准差。 固定（Fixed）模式（ = 2）要求用户手动输入接收机位置坐标。基站位置的任何误差将直接转化 为移动站位置误差。 上海移远通信技术股份有限公司 38 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 类型： 设置/查询 格式： //设置： $PQTMCFGSVIN,W,,,,,,* //查询： $PQTMCFGSVIN,R* 参数： 字段 格式 单位 十进制 - 十进制 - 十进制 米 十进制 米 十进制 米 十进制 米 描述 接收机模式。 0 = 禁用 1 = 测量（Survey-in）模式 2 = 固定（Fixed）模式（ARP 位置采用 ECEF 坐标系） 测量模式下最小观测时间。范围：0~86400。 测量模式下 3D 定位精度。 该字段为 0 时，表示无 3D 定位精度限制。 WGS84 ECEF X 坐标。 WGS84 ECEF Y 坐标。 WGS84 ECEF Z 坐标。 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGSVIN,OK* //获取命令响应： $PQTMCFGSVIN,OK,,,,,,* ⚫ 如果失败，模块返回： $PQTMCFGSVIN,ERROR,* 详见表 5：错误码。 上海移远通信技术股份有限公司 39 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 示例： //设置： $PQTMCFGSVIN,W,2,0,0,-2472446.4619,4828304.1363,3343730.2653*2A $PQTMCFGSVIN,OK*70 //查询： $PQTMCFGSVIN,R*26 $PQTMCFGSVIN,OK,2,0,0.0,-2472446.4619,4828304.1363,3343730.2653*67 备注 仅 LC29H (DA, EA)支持该命令。 2.3.9. PQTMSVINSTATUS 输出测量（survey-in）状态。 类型： 输出 格式： $PQTMSVINSTATUS,,,,,,,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 单位 描述 语句版本。 - 1 = 版本 1（此版本始终为 1） 毫秒 GPS 周时间。 测量位置有效性标志。 0 = 无效 - 1 = 进行中 2 = 有效 - 预留。 上海移远通信技术股份有限公司 40 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 描述 - 预留。 - 测量期间使用的位置观测数。 - 通过$PQTMCFGSVIN 命令中字段配置的最小观测时间。 米 ECEF 坐标系下沿 X 轴的当前测量平均位置。 米 ECEF 坐标系下沿 Y 轴的当前测量平均位置。 米 ECEF 坐标系下沿 Z 轴的当前测量平均位置。 米 当前测量平均位置精度。 示例： $PQTMSVINSTATUS,1,2241,1,,01,538,43200,-2472436.0802,4828383.0026,3343698.4839,9.5*38 备注 仅 LC29H (DA, EA)支持该命令。 2.3.10. PQTMGNSSSTART 启动 GNSS 引擎。 类型： 命令 格式： $PQTMGNSSSTART* 参数： 无 上海移远通信技术股份有限公司 41 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果： ⚫ 如果成功，模块返回： $PQTMGNSSSTART,OK* ⚫ 如果失败，模块返回： $PQTMGNSSSTART,ERROR,* 详见表 5：错误码。 示例： $PQTMGNSSSTART*51 $PQTMGNSSSTART,OK*79 2.3.11. PQTMGNSSSTOP 关闭 GNSS 引擎。 类型： 命令 格式： $PQTMGNSSSTOP* 参数： 无 执行结果： ⚫ 如果成功，模块返回： $PQTMGNSSSTOP,OK* ⚫ 如果失败，模块返回： $PQTMGNSSSTOP,ERROR,* 详见表 5：错误码。 上海移远通信技术股份有限公司 42 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 示例： $PQTMGNSSSTOP*09 $PQTMGNSSSTOP,OK*21 备注 该命令仅用于关闭 GNSS 引擎，启用该命令后，DR 引擎将继续工作。 2.3.12. PQTMPVT 输出 PVT（仅 GNSS）结果。 类型： 输出 格式： $PQTMPVT,,,,,,,,,,,,,,,,,,,* 参数： 字段 格式 十进制 十进制 单位 毫秒 YYYYMMDD - hhmmss.sss - 十进制 - 十进制 - 描述 语句版本。 1 = 版本 1（此版本始终为 1） 周时间。 UTC 日期。 YYYY：年 MM：月 DD：日 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的小数部分 预留。 定位模式。 0 = 不定位 上海移远通信技术股份有限公司 43 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 秒 度数 度数 米 米 m/s m/s m/s m/s 度数 - 描述 1 = 预留 2 = 2D 定位 3 = 3D 定位 正在使用的卫星数量。 闰秒。数据无效时，此字段为空。 纬度。数据无效时，此字段为空。 经度。数据无效时，此字段为空。 平均海平面以上海拔。数据无效时，此字段为空。 大地水准面差距（WGS84 基准面与平均海平面之间的 差值）。数据无效时，此字段为空。 北向速度。数据无效时，此字段为空。 东向速度。数据无效时，此字段为空。 下行速度。数据无效时，此字段为空。 地面速度。数据无效时，此字段为空。 航向。数据无效时，此字段为空。范围：0.00~360.00。 水平精度因子。数据无效时，该值为 99.99。 位置（3D）精度因子。数据无效时，该值为 99.99。 示例： //无定位： $PQTMPVT,1,1000,20221225,163355.000,,0,00,,,,,,,,,,,99.99,99.99*79 //3D 定位： $PQTMPVT,1,31075000,20221225,083737.000,,3,09,18,31.12738291,117.26372910,34.212,5.267,3.21 2,2.928,0.238,4.346,34.12,2.16,4.38*51 上海移远通信技术股份有限公司 44 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.13. PQTMCFGNMEADP 设置/查询 NMEA 语句的小数位数。 类型： 设置/查询 格式： //设置： $PQTMCFGNMEADP,W,,,,,,* //查询： $PQTMCFGNMEADP,R* 参数： 字段 格式 单位 十进制 - 十进制 - 十进制 - 十进制 - 十进制 - 十进制 - 描述 NMEA 标准语句中 UTC 秒的小数位数。 范围：0~3；默认值：3。 0 = 无小数部分 NMEA标准语句中纬度和经度的小数位数。 范围：0~8；默认值：6。 0 = 无小数部分 NMEA标准语句中海拔高度和大地水准面差距的小数位数。 范围：0~3；默认值：2。 0 = 无小数部分 NMEA标准语句中DOP的小数位数。 范围：0~3；默认值：2。 0 = 无小数部分 NMEA标准语句中速度的小数位数。 范围：0~3；默认值：3。 0 = 无小数部分 NMEA标准语句中COG的小数位数。 范围：0~3；默认值：2。 0 = 无小数部分 上海移远通信技术股份有限公司 45 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGNMEADP,OK* //查询命令响应： $PQTMCFGNMEADP,OK,,,,,,* ⚫ 如果失败，模块返回： $PQTMCFGNMEADP,ERROR,* 详见表 5：错误码。 示例： //设置： $PQTMCFGNMEADP,W,3,6,1,2,3,2*35 $PQTMCFGNMEADP,OK*61 //查询： $PQTMCFGNMEADP,R*37 $PQTMCFGNMEADP,OK,3,6,1,2,3,2*66 备注 仅 LC29H (BA, CA, DA, EA)支持该命令。 2.3.14. PQTMCFGRCVRMODE 设置/查询接收机的工作模式。 类型： 设置/查询 格式： //设置： $PQTMCFGRCVRMODE,W,* //查询： 上海移远通信技术股份有限公司 46 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 $PQTMCFGRCVRMODE,R* 参数： 字段 格式 单位 十进制 - 描述 接收机工作模式。 0 = 未知 1 = 移动站。当设置为此模式时，接收机将恢复到默认的 NMEA 语 句输出状态。 2 = 基站。当设置为此模式时，接收机将自动禁用 NMEA 语句输出 并启用 RTCM MSM4 和 1005 类型消息输出。 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGRCVRMODE,OK* //查询命令响应： $PQTMCFGRCVRMODE,OK,* ⚫ 如果失败，模块返回： $PQTMCFGRCVRMODE,ERROR,* 详见表 5：错误码。 示例： //设置： $PQTMCFGRCVRMODE,W,2*29 $PQTMCFGRCVRMODE,OK*64 //查询： $PQTMCFGRCVRMODE,R*32 $PQTMCFGRCVRMODE,OK,2*7A 备注 仅 LC29H (DA, EA)支持该命令。 上海移远通信技术股份有限公司 47 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.15. PQTMPL 输出保护等级信息。 类型： 输出 格式： $PQTMPL,,,,,,,,,,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 毫秒 % 毫米 毫米 毫米 毫米/秒 毫米/秒 毫米/秒 纳秒 描述 语句版本。 1 = 版本 1（此版本始终为 1。） 周时间。数据无效时，此字段为空。 历元的不确定性概率。 预留。始终为 1。 预留。始终为 1。 北向位置保护等级。数据无效时，此字段为空。 东向位置保护等级。数据无效时，此字段为空。 天向位置保护等级。数据无效时，此字段为空。 北向速度保护等级。数据无效时，此字段为空。 东向速度保护等级。数据无效时，此字段为空。 天向速度保护等级。数据无效时，此字段为空。 预留。此字段为空。 预留。此字段为空。 时间保护等级。数据无效时，此字段为空。 上海移远通信技术股份有限公司 48 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 示例： $PQTMPL,1,55045200,5.00,1,1,2879,2718,4766,5344,4323,10902,,,*1C 2.3.16. PQTMCOLD 冷启动模块。冷启动将重新启动 GNSS 引擎，该启动方式中 GNSS 引擎不会使用任何辅助信息，包括 时间、位置、历书和星历。 类型： 命令 格式： $PQTMCOLD* 参数： 无 结果： ⚫ 如果成功，模块将重新启动，且不返回任何消息。 ⚫ 如果失败，模块返回： $PQTMCOLD,ERROR,* 详见表 5：错误码。 示例： $PQTMCOLD*1C 备注 仅 LC29H (AA)和 LC79H (AL)支持该命令。 上海移远通信技术股份有限公司 49 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.17. PQTMHOT 热启动模块。热启动将重新启动 GNSS 引擎，该启动方式中 GNSS 引擎将会使用辅助信息（如果可用）， 包括时间、位置、历书和星历。 类型： 命令 格式： $PQTMHOT* 参数： 无 结果： ⚫ 如果成功，模块将重新启动，且不返回任何消息。 ⚫ 如果失败，模块返回： $PQTMHOT,ERROR,* 详见表 5：错误码。 示例： $PQTMHOT*4B 备注 仅 LC29H (AA)和 LC79H (AL)支持该命令。 2.3.18. PQTMWARM 温启动模块。温启动将重新启动 GNSS 引擎，该启动方式中 GNSS 引擎将会使用辅助信息（如果可用）， 包括时间、位置、历书，但不包括星历。因此模块需要重新下载星历才能计算出位置、速度等信息。 类型： 命令 上海移远通信技术股份有限公司 50 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： $PQTMWARM* 参数： 无 结果： ⚫ 如果成功，模块将重新启动，且不返回任何消息。 ⚫ 如果失败，模块返回： $PQTMWARM,ERROR,* 详见表 5：错误码。 示例： $PQTMWARM*11 备注 仅 LC29H (AA)和 LC79H (AL)支持该命令。 2.3.19. PQTMSRR 重启系统。接收机将重新启动。 类型： 命令 格式： $PQTMSRR* 参数： 无 上海移远通信技术股份有限公司 51 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果： ⚫ 如果成功，模块将重新启动，且不返回任何消息。 ⚫ 如果失败，模块返回： $PQTMSRR,ERROR,* 详见表 5：错误码。 示例： $PQTMSRR*4B 备注 仅 LC29H (AA)和 LC79H (AL)支持该命令。 2.3.20. PQTMCFGSBAS 设置/查询 SBAS 配置。 类型： 设置/查询 格式： //设置： $PQTMCFGSBAS,W,* //查询： $PQTMCFGSBAS,R* 参数： 字段 格式 十六进制 单位 - 描述 SBAS 配置。 Bit 0 = WAAS Bit 2 = EGNOS Bit 4 = MSAS Bit 5 = GAGAN 上海移远通信技术股份有限公司 52 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGSBAS,OK* //查询命令响应： $PQTMCFGSBAS,OK,* ⚫ 如果失败，模块返回： $PQTMCFGSBAS,ERROR,* 详见表 5：错误码。 示例： //设置： $PQTMCFGSBAS,W,35*08 $PQTMCFGSBAS,OK*71 //查询： $PQTMCFGSBAS,R*27 $PQTMCFGSBAS,OK,35*5B 备注 仅 LC29H (AA)和 LC79H (AL)支持该命令。 2.3.21. PQTMCFGCNST 设置/查询星系配置。 类型： 设置/查询 格式： //设置： $PQTMCFGCNST,W,,,,,,* 上海移远通信技术股份有限公司 53 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 //查询： $PQTMCFGCNST,R* 参数： 字段 格式 单位 十进制 - 十进制 - 十进制 - 十进制 - 十进制 - 十进制 - 描述 启用/禁用 GPS。 0 = 禁用 1 = 启用 启用/禁用 GLONASS。 0 = 禁用 1 = 启用 启用/禁用 Galileo。 0 = 禁用 1 = 启用 启用/禁用 BDS。 0 = 禁用 1 = 启用 启用/禁用 QZSS。 0 = 禁用 1 = 启用 预留。始终为 0。 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGCNST,OK* //查询命令响应： $PQTMCFGCNST,OK,,,,,,* ⚫ 如果失败，模块返回： $PQTMCFGCNST,ERROR,* 详见表 5：错误码。 上海移远通信技术股份有限公司 54 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 示例： //设置： $PQTMCFGCNST,W,1,1,1,1,0,0*2B $PQTMCFGCNST,OK*78 //查询： $PQTMCFGCNST,R*2E $PQTMCFGCNST,OK,1,1,1,1,0,0*78 备注 1. 仅 LC29H (BA, CA, DA, EA)和 LC79H (AL)支持该命令。 2. 支持的星系配置如下： ⚫ GPS + GLONASS + Galileo + BDS ⚫ GPS + GLONASS + Galileo ⚫ GPS + GLONASS + BDS ⚫ GPS + Galileo + BDS ⚫ GPS + GLONASS ⚫ GPS + Galileo ⚫ GPS + BDS ⚫ BDS ⚫ GPS 2.3.22. PQTMDOP 输出精度因子。 类型： 输出 格式： $PQTMDOP,,,,,,,,,* 参数： 字段 格式 十进制 单位 - 描述 语句版本。 上海移远通信技术股份有限公司 55 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 毫秒 - 描述 1 = 版本 1（此版本始终为 1。） 周时间。数据无效时，此字段为空。 几何精度因子。数据无效时，该值为 99.99。 位置（3D）精度因子。数据无效时，该值为 99.99。 时间精度因子。数据无效时，该值为 99.99。 垂直精度因子。数据无效时，该值为 99.99。 水平精度因子。数据无效时，该值为 99.99。 北向精度因子。数据无效时，该值为 99.99。 东向精度因子。数据无效时，该值为 99.99。 示例： //已定位： $PQTMDOP,1,570643000,1.01,0.88,0.49,0.73,0.50,0.36,0.35*7C //未定位： $PQTMDOP,1,,99.99,99.99,99.99,99.99,99.99,99.99,99.99*70 2.3.23. PQTMCFGFIXRATE 设置/查询定位频率。 类型： 设置/查询 格式： //设置： $PQTMCFGFIXRATE,W,* //查询： $PQTMCFGFIXRATE,R* 上海移远通信技术股份有限公司 56 / 118 参数： 字段 格式 十进制 单位 毫秒 描述 定位间隔。 LC29H 系列&LC79H (AL) GNSS 协议规范 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGFIXRATE,OK* //查询命令响应： $PQTMCFGFIXRATE,OK,* ⚫ 如果失败，模块返回： $PQTMCFGFIXRATE,ERROR,* 详见表 5：错误码。 示例： //设置： $PQTMCFGFIXRATE,W,1000*59 $PQTMCFGFIXRATE,OK*27 //查询： $PQTMCFGFIXRATE,R*71 $PQTMCFGFIXRATE,OK,1000*0A 备注 仅 LC29H (BA, CA, DA, EA)支持该命令。 2.3.24. PQTMCFGPPS 设置/查询 1PPS 功能配置。 类型： 设置/查询 上海移远通信技术股份有限公司 57 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： //设置： $PQTMCFGPPS,W,,,,,,* //查询： $PQTMCFGPPS,R,* 参数： 字段 格式 十进制 单位 - 十进制 十进制 毫秒 十进制 - 十进制 - 十进制 - 描述 PPS 索引。 1 = PPS 1 启用/禁用 PPS 输出。 0 = 禁用 1 = 启用 脉冲持续时间。范围：0~999；默认值：100。 PPS 输出定位模式。 1 = 始终 2 = 2D 定位 3 = 3D 定位 脉冲极性。 0= 低 1= 高 PPS 生成时间间隔。 0 = 每秒 1 = 奇数秒 2 = 偶数秒 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGPPS,OK* //查询命令响应： $PQTMCFGPPS,OK,,,,,,*< LF> ⚫ 如果失败，模块返回： $PQTMCFGPPS,ERROR,* 上海移远通信技术股份有限公司 58 / 118 详见表 5：错误码。 示例： //设置： $PQTMCFGPPS,W,1,1,100,1,1,0*73 $PQTMCFGPPS,OK*21 //查询： $PQTMCFGPPS,R,1*6A $PQTMCFGPPS,OK,1,1,100,1,1,0*20 备注 仅 LC29H (AA)和 LC79H (AL)支持该命令。 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.25. PQTMDEBUGON 启用调试日志。调试状态可以通过命令$PQTMSAVEPAR 保存。 类型： 命令 格式： $PQTMDEBUGON* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMDEBUGON,OK* ⚫ 如果失败，模块返回： $PQTMDEBUGON,ERROR,* 详见表 5：错误码。 上海移远通信技术股份有限公司 59 / 118 示例： $PQTMDEBUGON*48 $PQTMDEBUGON,OK*60 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.26. PQTMDEBUGOFF 禁用调试日志。 类型： 命令 格式： $PQTMDEBUGOFF* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMDEBUGOFF,OK* ⚫ 如果失败，模块返回： $PQTMDEBUGOFF,ERROR,* 详见表 5：错误码。 示例： $PQTMDEBUGOFF*06 $PQTMDEBUGOFF,OK*2E 2.3.27. PQTMVEL 输出速度信息。 类型： 输出 上海移远通信技术股份有限公司 60 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： $PQTMVEL,1,,,,,,,,,,< HeadingAcc>* 参数： 字段 格式 hhmmss.sss 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 米/秒 米/秒 米/秒 米/秒 米/秒 度 米/秒 米/秒 度 描述 UTC 时间。 北向速度。 东向速度。 向下速度。 2D 速度。 3D 速度。 航向。 估算 2D 速度精度。 估算 3D 速度精度。 估算航向精度。 示例： $PQTMVEL,1,154512.100,1.251,2.452,1.245,2.752,3.021,180.512,0.124,0.254,0.250*67 2.3.28. PQTMCFGODO 设置/查询里程表功能。 类型： 设置/查询 格式： //设置： $PQTMCFGODO,W,,* 上海移远通信技术股份有限公司 61 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 //查询： $PQTMCFGODO,R* 参数： 字段 格式 单位 十进制 - 十进制 米 描述 里程表功能状态。 0 = 禁用 1 = 启用 初始距离。默认值：0。 结果： ⚫ 如果成功，模块返回： //设置命令响应： $PQTMCFGODO,OK* //查询命令响应： $PQTMCFGODO,OK,,* ⚫ 如果失败，模块返回： $PQTMCFGODO,ERROR,* 详见表 5：错误码。 示例： //设置： $PQTMCFGODO,W,1,10.5*4E $PQTMCFGODO,OK*36A //查询： $PQTMCFGODO,R*60 $PQTMCFGODO,OK,1,10.5*1D 上海移远通信技术股份有限公司 62 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.29. PQTMRESETODO 重置里程表的累计距离。 类型： 命令 格式： $PQTMRESETODO* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMRESETODO,OK* ⚫ 如果失败，模块返回： $PQTMRESETODO,ERROR,* 详见表 5：错误码。 示例： $PQTMRESETODO*09 $PQTMRESETODO,OK*21 备注 可通过两种方式重置里程表的累计距离，即使用$PQTMRESETODO 命令或关闭模块电源。若在模块运 行时使用$PQTMCFGODO 命令禁用里程表功能，累计距离将停止计算，但不会清零。 上海移远通信技术股份有限公司 63 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.3.30. PQTMODO 输出里程表信息。 类型： 输出 格式： $PQTMODO,,,,* 参数： 字段 格式 十进制 单位 - hhmmss.sss - 十进制 - 十进制 米 描述 语句版本。 1 = 版本 1（此版本始终为 1） UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 里程表状态。 0 = 禁用 1 = 启用 自上次重置之后的累计距离。 示例： $PQTMODO,1,120635.000,1,112.3*6E 备注 $PQTMODO 中的表示$PQTMCFGODO 中设置的值与累计里程值的总和。累计里程从 0 米开始计算，在断电或使用$PQTMRESETODO 清除后重置为 0 米。如果$PQTMCFGODO 中的 值被修改，则$PQTMODO 中实际的输出等于累计距离和新的值的总和，即： = 累计距离 + 。 上海移远通信技术股份有限公司 64 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4. PAIR 消息（专有语句） 本章介绍 LC29H 系列及 LC79H (AL)模块支持的 PAIR 消息（由芯片供应商定义的专有 NMEA 消息）。 PAIR 消息格式： $PAIR[,] Packet Type：每个 PAIR 消息的标识符，为 000 到 999 的三字节字符串。 Data：该字段可以省略，也可通过数据字段分隔符','分隔多个字段。不同的命令对应不同的数据。详情 如下。 2.4.1. PAIR001: PAIR_ACK PAIR 命令的应答语句。模块返回$PAIR001，通知发送方其已收到数据包。 类型： 输出 格式： $PAIR001,,* 参数： 字段 格式 十进制 十进制 单位 - - 描述 待应答的命令类型。 结果。 0 = 命令已成功发送。 1 = 正在处理命令，请等待结果。 2 = 命令发送失败。 3 = 不支持。 4 = 命令参数错误，如超出范围、部分参数丢失或校验和错误。 5 = MNL 服务正忙。可稍后重新发送命令。 示例： $PAIR001,004,0*3F 上海移远通信技术股份有限公司 65 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.2. PAIR002: PAIR_GNSS_SUBSYS_POWER_ON 为 GNSS 系统上电，包括 DSP、RF、PE 和时钟。 类型： 命令 格式： $PAIR002* 参数： 无 结果： 返回$PAIR001 消息。 示例： $PAIR002*38 $PAIR001,002,1*38 $PAIR001,002,0*39 2.4.3. PAIR003: PAIR_GNSS_SUBSYS_POWER_OFF 关闭 GNSS 系统的电源，包括 DSP、RF、PE 和时钟。 类型： 命令 格式： $PAIR003* 参数： 无 上海移远通信技术股份有限公司 66 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果： 返回$PAIR001 消息。 示例： $PAIR003*39 $PAIR001,003,1*39 $PAIR001,003,0*38 备注 1. 若依次向模块发送$PAIR382,1*2E 和$PAIR003*39 命令，且模块返回$PAIR001,382,0*32，则模块 仍可以接收其他命令。否则，模块将不会响应任何命令。 2. 对于支持 I2C 通信的软件版本，发送$PAIR003*39 后，模块仍然可以接收命令。 2.4.4. PAIR004: PAIR_GNSS_SUBSYS_HOT_START 热启动模块（使用 NVRAM 中的所有可用数据）。通常，热启动指 GNSS 模块断电 2 小时内（RTC 必 须有效），且星历数据仍然有效。因此，热启动时无需再次下载星历数据，是最快的启动方式。 类型： 命令 格式： $PAIR004* 参数： 无 结果： 返回$PAIR001 消息。 示例： $PAIR004*3E $PAIR001,004,0*3F 上海移远通信技术股份有限公司 67 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.5. PAIR005: PAIR_GNSS_SUBSYS_WARM_START 温启动模块。该启动方式中 GNSS 引擎将会使用辅助信息（如果可用），包括时间、位置、历书，但不 包括星历。因此模块需要重新下载星历才能计算出位置、速度等信息。 类型： 命令 格式： $PAIR005* 参数： 无 结果： 返回$PAIR001 消息。 示例： $PAIR005*3F $PAIR001,005,0*3E 2.4.6. PAIR006: PAIR_GNSS_SUBSYS_COLD_START 冷启动模块。该启动方式中 GNSS 引擎不会使用任何辅助信息，包括时间、位置、历书和星历。 类型： 命令 格式： $PAIR006* 参数： 无 上海移远通信技术股份有限公司 68 / 118 结果： 返回$PAIR001 消息。 示例： $PAIR006*3C $PAIR001,006,0*3D LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.7. PAIR007: PAIR_GNSS_SUBSYS_FULL_COLD_START 完全冷启动模块。执行该指令时会清除系统和用户配置，即将模块重置为出厂设置。在完全冷启动时， 模块将丢失此前位置的所有数据。因此，模块定位前需要在全频谱上搜索所有可见卫星。 类型： 命令 格式： $PAIR007* 参数： 无 结果： 返回$PAIR001 消息。 示例： $PAIR007*3D $PAIR001,007,0*3C 2.4.8. PAIR010: PAIR_REQUEST_AIDING 通知存储在模块中的 GNSS 辅助数据已过期。该消息在模块上电时自动输出。 类型： 输出 上海移远通信技术股份有限公司 69 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： $PAIR010,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 单位 - - 周 秒 描述 待更新的数据类型。 0 = EPO 数据 1 = 时间 2 = 位置 所需的 GNSS 数据类型。 0 = GPS 数据 1 = GLONASS 数据 2 = Calieo 数据 3 = BDS 数据 4 = QZSS 数据 周数（自适应周翻转）。 周内秒。 示例： $PAIR010,0,0,2044,369413*33 2.4.9. PAIR050: PAIR_COMMON_SET_FIX_RATE 设置定位频率。 类型： 设置 格式： $PAIR050,* 参数： 字段 格式 十进制 单位 毫秒 描述 定位频率。范围：100~1000。默认值：1000。 上海移远通信技术股份有限公司 70 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果： 返回$PAIR001 消息。 示例： $PAIR050,1000*12 $PAIR001,050,0*3E 备注 1. 若需获取设置命令中部分参数未给出的默认值，可在未使用设置命令修改相关参数配置前，通过对应 的查询命令获取相应的默认值；若已使用设置命令修改过默认配置，可联系移远通信技术支持 （support@quectel.com）来获取相关默认配置信息。 2. 若设置频率大于 1 Hz，则只有 RMC 和 GGA 语句以设定频率输出，而 GSA 和 GSV 语句保持以 1 Hz 频率输出，其他 NMEA 语句不输出。 3. 为避免系统异常，请在完成设置后发送参数保存命令并重启模块，以使配置生效。 2.4.10. PAIR051: PAIR_COMMON_GET_FIX_RATE 查询定位输出频率。 类型： 查询 格式： $PAIR051* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR051,* 上海移远通信技术股份有限公司 71 / 118 结果中包含的参数： 字段 格式 十进制 单位 毫秒 LC29H 系列&LC79H (AL) GNSS 协议规范 描述 定位频率。范围：100~1000。默认值：1000。 示例： $PAIR051*3E $PAIR001,051,0*3F $PAIR051,1000*13 2.4.11. PAIR058: PAIR_COMMON_SET_MIN_SNR 设置正在使用的卫星的最小信噪比。如果设置了最小信噪比阈值，模块将不会使用信噪比低于阈值的 卫星。 类型： 设置 格式： $PAIR058,* 参数： 字段 格式 十进制 单位 dB 描述 正在使用的卫星的最小信噪比阈值。 范围：9~37。默认值：9。 结果： 返回$PAIR001 消息。 示例： $PAIR058,15*1F $PAIR001,058,0*36 上海移远通信技术股份有限公司 72 / 118 备注 LC29H (BA, CA, DA, EA)不支持该命令。 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.12. PAIR059: PAIR_COMMON_GET_MIN_SNR 查询正在使用卫星的最小信噪比。 类型： 查询 格式： $PAIR059* 参数： 无 执行结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR059,* 结果中包含的参数： 字段 格式 单位 十进制 dB 描述 正在使用的卫星的最小信噪比阈值。 范围：9~37。默认值：9。 示例： $PAIR059*36 $PAIR001,059,0*37 $PAIR059,15*1E 上海移远通信技术股份有限公司 73 / 118 备注 LC29H (BA, CA, DA, EA)不支持该命令。 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.13. PAIR062: PAIR_COMMON_SET_NMEA_OUTPUT_RATE 设置 NMEA 标准语句的输出频率。 类型： 设置 格式： $PAIR062,,* 参数： 字段 格式 十进制 十进制 单位 - 描述 NMEA 标准语句类型。 -1 = 将所有 NMEA 标准语句的输出频率重置为默认值 0 = NMEA_SEN_GGA 1 = NMEA_SEN_GLL 2 = NMEA_SEN_GSA 3 = NMEA_SEN_GSV 4 = NMEA_SEN_RMC 5 = NMEA_SEN_VTG 6 = NMEA_SEN_ZDA 7 = NMEA_SEN_GRS 8 = NMEA_SEN_GST 语句输出频率设置。 0 = 禁用语句输出 N = 每定位 N 次输出一次 N 的范围：0~20。 结果： 返回$PAIR001 消息。 示例： $PAIR062,0,3*3D 上海移远通信技术股份有限公司 74 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 $PAIR001,062,0*3F 备注 1. LC29H (BA, CA, DA, EA)仅支持取值为 0~5。 2. LC29H (BA, CA, DA, EA)仅支持取值为 0 或 1。 3. GGA、GLL、GSA、GSV、RMC 和 VTG 语句默认输出。 2.4.14. PAIR063: PAIR_COMMON_GET_NMEA_OUTPUT_RATE 查询 NMEA 标准语句的输出频率。 类型： 查询 格式： $PAIR063,* 参数： 字段 格式 十进制 单位 - 描述 NMEA 标准语句类型。 -1 = 返回所有 NMEA 标准语句的输出频率 0 = NMEA_SEN_GGA 1 = NMEA_SEN_GLL 2 = NMEA_SEN_GSA 3 = NMEA_SEN_GSV 4 = NMEA_SEN_RMC 5 = NMEA_SEN_VTG 6 = NMEA_SEN_ZDA 7 = NMEA_SEN_GRS 8 = NMEA_SEN_GST 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR063,,* 上海移远通信技术股份有限公司 75 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果中包含的参数： 字段 格式 单位 十进制 - 十进制 - 描述 NMEA 标准语句类型。 0 = NMEA_SEN_GGA 1 = NMEA_SEN_GLL 2 = NMEA_SEN_GSA 3 = NMEA_SEN_GSV 4 = NMEA_SEN_RMC 5 = NMEA_SEN_VTG 6 = NMEA_SEN_ZDA 7 = NMEA_SEN_GRS 8 = NMEA_SEN_GST 语句输出频率设置。 0 = 禁用或不支持 N = 每定位 N 次输出一次 N 的范围：1~20。 示例： $PAIR063,0*23 $PAIR001,063,0*3E $PAIR063,0,3*3C 备注 LC29H (BA, CA, DA, EA)仅支持取值为 0~5。 2.4.15. PAIR066: PAIR_COMMON_SET_GNSS_SEARCH_MODE 设置 GNSS 搜索模式。当 NVRAM 数据有效时，该设置有效。 类型： 设置 格式： $PAIR066,,,,,,* 上海移远通信技术股份有限公司 76 / 118 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 LC29H 系列&LC79H (AL) GNSS 协议规范 单位 描述 0 = 禁用（不搜索 GPS 卫星） - 1 = 搜索 GPS 卫星 0 = 禁用（不搜索 GLONASS 卫星） - 1 = 搜索 GLONASS 卫星 0 = 禁用（不搜索 Galieo 卫星） - 1 = 搜索 Galieo 卫星 0 = 禁用（不搜索 BDS 卫星） - 1 = 搜索 BDS 卫星 0 = 禁用（不搜索 QZSS 卫星） - 1 = 搜索 QZSS 卫星 - 预留。始终为 0。 结果： 返回$PAIR001 消息。 示例： //在双频星系组合之间切换。切换到 GPS + Galileo + BDS： $PAIR066,1,0,1,1,0,0*3B $PAIR001,066,0*3B //在单频星系组合之间切换。切换到 GPS： $PAIR066,1,0,0,0,0,0*3B $PAIR001,066,0*3B //从单频 GPS 切换到双频 GPS + GLONASS + Galileo + BDS 星系组合： $PAIR066,1,1,1,1,0,0*3A $PAIR001,066,0*3B $PAIR382,1*2E $PAIR001,382,0*32 $PAIR003*39 $PAIR001,003,0*38 $PAIR104,1*22 $PAIR001,104,0*3E $PAIR002*38 $PAIR001,002,0*39 //从双频 GPS + GLONASS + Galileo + BDS 切换到单频 GPS 星系： $PAIR382,1*2E $PAIR001,382,0*32 上海移远通信技术股份有限公司 77 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 $PAIR003*39 $PAIR001,003,0*38 $PAIR104,0*23 $PAIR001,104,0*3E $PAIR002*38 $PAIR001,002,0*39 $PAIR066,1,0,0,0,0,0*3B $PAIR001,066,0*3B 备注 1. QZSS 默认始终启用。 2. 支持的 GNSS 搜索模式（L1）： ⚫ BDS B1I ⚫ GPS L1 C/A ⚫ GPS L1 C/A + BDS B1I ⚫ GPS L1 C/A + QZSS L1 C/A ⚫ GPS L1 C/A + BDS B1I + QZSS L1 C/A ⚫ GPS L1 C/A + GLONASS L1 ⚫ GPS L1 C/A + GLONASS L1 + QZSS L1 C/A ⚫ GPS L1 C/A + Galileo E1 ⚫ GPS L1 C/A + Galileo E1 + QZSS L1 C/A ⚫ GPS L1 C/A + GLONASS L1 + Galileo E1 + BDS B1I ⚫ GPS L1 C/A + GLONASS L1 + Galileo E1 + BDS B1I + QZSS L1 C/A 3. 支持的 GNSS 搜索模式（L1 + L5）： ⚫ BDS B1I 和 BDS B2a ⚫ GPS L1 C/A 和 GPS L5 + Galileo E1 和 Galileo E5a + BDS B1I 和 BDS B2a ⚫ GPS L1 C/A 和 GPS L5 + Galileo E1 和 Galileo E5a + BDS B1I 和 BDS B2a + QZSS L1 C/A 和 QZSS L5 ⚫ GPS L1 C/A 和 GPS L5 + GLONASS L1 + Galileo E1 和 Galileo E5a + BDS B1I 和 BDS B2a ⚫ GPS L1 C/A 和 GPS L5 + GLONASS L1 + Galileo E1 和 Galileo E5a + BDS B1I 和 BDS B2a + QZSS L1 C/A 和 QZSS L5 4. LC29H (BA, CA, DA, EA)不支持该命令。 5. 若需从单频模式切换到双频模式，必须首先切换到单频和双频都支持的星座，然后发送$PAIR104， 最后发送$PAIR066。 2.4.16. PAIR067: PAIR_COMMON_GET_GNSS_SEARCH_MODE 查询 GNSS 搜索模式。 类型： 查询 上海移远通信技术股份有限公司 78 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： $PAIR067* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR067,,,,,,* 结果中包含的参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 单位 - 描述 0 = 禁用（不搜索 GPS 卫星） 1 = 搜索 GPS 卫星 0 = 禁用（不搜索 GLONASS 卫星） 1 = 搜索 GLONASS 卫星 0 = 禁用（不搜索 Galieo 卫星） 1 = 搜索 Galieo 卫星 0 = 禁用（不搜索 BDS 卫星） 1 = 搜索 BDS 卫星 0 = 禁用（不搜索 QZSS 卫星） 1 = 搜索 QZSS 卫星 预留。始终为 0。 示例： $PAIR067*3B $PAIR001,067,0*3A $PAIR067,1,1,1,1,1,0*3A 备注 LC29H (BA, CA, DA, EA)不支持该命令。 上海移远通信技术股份有限公司 79 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.17. PAIR070: PAIR_COMMON_SET_STATIC_THRESHOLD 设置静态导航速度阈值。如果实际速度低于阈值，输出位置保持不变，输出速度为 0。如果阈值设置为 0，则此功能将被禁用。 类型： 设置 格式： $PAIR070,* 参数： 字段 格式 十进制 单位 dm/s 描述 静态导航速度阈值。范围：0~20。默认值：0。 结果： 返回$PAIR001 消息。 示例： $PAIR070,4*25 $PAIR001,070,0*3C 备注 LC29H (BA, CA, DA, EA)不支持该命令。 2.4.18. PAIR071: PAIR_COMMON_GET_STATIC_THRESHOLD 查询静态导航速度阈值。 类型： 查询 上海移远通信技术股份有限公司 80 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： $PAIR071* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR071,* 结果中包含的参数： 字段 格式 十进制 单位 m/s 描述 静态导航速度阈值。范围：0~2。默认值：0。 示例： $PAIR071*3C $PAIR001,071,0*3D $PAIR071,0.4*3A 备注 LC29H (BA, CA, DA, EA)不支持该命令。 2.4.19. PAIR072: PAIR_COMMON_SET_ELEV_MASK 设置卫星仰角掩码。 类型： 设置 上海移远通信技术股份有限公司 81 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： $PAIR072,* 参数： 字段 格式 十进制 单位 度 描述 卫星仰角掩码。 范围：-90~90；默认值：5。 结果： 返回$PAIR001 消息。 示例： $PAIR072,5*26 $PAIR001,072,0*3E 备注 1. 低于卫星仰角掩码的卫星不用于定位。 2. LC29H (BA, CA, DA, EA)不支持该命令。 2.4.20. PAIR073: PAIR_COMMON_GET_ELEV_MASK 查询卫星仰角掩码。 类型： 查询 格式： $PAIR073* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 上海移远通信技术股份有限公司 82 / 118 查询结果消息格式： $PAIR073,* 结果中包含的参数： 字段 格式 十进制 单位 度数 示例： $PAIR073*3E $PAIR001,073,0*3F $PAIR073,5*27 备注 LC29H (BA, CA, DA, EA)不支持该命令。 LC29H 系列&LC79H (AL) GNSS 协议规范 描述 卫星仰角掩码。范围：-90~90。 2.4.21. PAIR074: PAIR_COMMON_SET_AIC_ENABLE 启用/禁用主动干扰消除（AIC）功能。有关 AIC 功能的详细信息，请参考文档 [1]和[2] 硬件设计手册。 类型： 设置 格式： $PAIR074,* 参数： 字段 格式 十进制 单位 - 描述 启用/禁用 AIC 功能。 0 = 禁用 1 = 启用 上海移远通信技术股份有限公司 83 / 118 结果： 返回$PAIR001 消息。 示例： $PAIR074,1*24 $PAIR001,074,0*38 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.22. PAIR075: PAIR_COMMON_GET_AIC_STATUS 查询主动干扰消除（AIC）功能的状态。 类型： 查询 格式： $PAIR075* 参数： 无 执行结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR075,* 结果中包含的参数： 字段 格式 单位 十进制 - 描述 AIC 功能的状态。 0 = 禁用 1 = 启用 示例： $PAIR075*38 上海移远通信技术股份有限公司 84 / 118 $PAIR001,075,0*39 $PAIR075,1*25 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.23. PAIR080: PAIR_COMMON_SET_NAVIGATION_MODE 设置导航模式。 类型： 设置 格式： $PAIR080,* 参数： 字段 格式 十进制 单位 - 描述 导航模式。 0 = 正常模式。该模式为基本模式，适用于大多数场景（例 如驾驶场景）。 1 = 健身模式。对于跑步和步行活动，低速（< 5 m/s）运动 对位置计算的影响更大。该模式降低了手臂运动引起的 测量噪声，并优化了低速场景下的导航性能。 2 = 预留。 3 = 预留。 4 = 静态模式。适用于假定为零动态的静态场景。 5 = 无人机模式。适用于在不同飞行阶段（例如悬停、巡航） 动态范围相同和垂直加速度相同时的无人机场景。 6 = 预留。 7 = 游泳模式。适用于游泳场景。该模式降低了手臂特定运 动产生的测量噪声，提升了模块出水后的定位能力。该 模式可以平滑轨迹，提高距离计算的准确性。 8 = 预留。 9 = 自行车模式。适用于共享单车场景。 表 7：不同导航模式的海拔高度和速度范围 模式 正常模式 最大海拔高度（m） 10000 最大速度（m/s） 100 上海移远通信技术股份有限公司 85 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 模式 健身模式 静态模式 无人机模式 游泳模式 自行车模式 最大海拔高度（m） 10000 10000 10000 10000 10000 最大速度（m/s） 30 10 30 10 30 结果： 返回$PAIR001 消息。 示例： $PAIR080,1*2F $PAIR001,080,0*33 2.4.24. PAIR081: PAIR_COMMON_GET_NAVIGATION_MODE 查询导航模式。 类型： 查询 格式： $PAIR081* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR081,* 上海移远通信技术股份有限公司 86 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果中包含的参数： 字段 格式 单位 十进制 - 描述 导航模式。 0 = 正常模式。该模式为基本模式，适用于大多数场景（例如驾 驶场景）。 1 = 健身模式。对于跑步和步行活动，低速（< 5 m/s）运动对位 置计算的影响更大。该模式降低了手臂运动引起的测量噪 声，并优化了低速场景下的导航性能。 2 = 预留。 3 = 预留。 4 = 静态模式。适用于假定为零动态的静态场景。 5 = 无人机模式。适用于在不同飞行阶段（例如悬停、巡航）动 态范围相同和垂直加速度相同时的无人机场景。 6 = 预留。 7 = 游泳模式。适用于游泳场景。该模式降低了手臂特定运动产 生的测量噪声，提升了模块出水后的定位能力。该模式可以 平滑轨迹，提高距离计算的准确性。 8 = 预留。 9 = 自行车模式。适用于共享单车场景。 示例： $PAIR081*33 $PAIR001,081,0*32 $PAIR081,0*2F 2.4.25. PAIR086: PAIR_COMMON_SET_DEBUGLOG_OUTPUT 启用/禁用以二进制格式输出调试日志。 类型： 设置 格式： $PAIR086,* 上海移远通信技术股份有限公司 87 / 118 参数： 字段 格式 十进制 结果： 返回$PAIR001 消息。 示例： $PAIR086,1*29 $PAIR001,086,0*35 LC29H 系列&LC79H (AL) GNSS 协议规范 单位 - 描述 调试日志输出设置。 0 = 禁用 1 = 启用全部调试日志输出 2 = 启用部分调试日志输出 2.4.26. PAIR087: PAIR_COMMON_GET_DEBUGLOG_OUTPUT 查询调试日志的输出配置。 类型： 查询 格式： $PAIR087* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR087,* 上海移远通信技术股份有限公司 88 / 118 结果中包含的参数： 字段 格式 单位 十进制 - 示例： $PAIR087*35 $PAIR001,087,0*34 $PAIR087,0*29 LC29H 系列&LC79H (AL) GNSS 协议规范 描述 调试日志输出配置。 0 = 禁用 1 = 启用全部调试日志输出 2 = 启用部分调试日志输出 2.4.27. PAIR100: PAIR_COMMON_SET_NMEA_OUTPUT_MODE 设置 NMEA 标准语句的输出模式。 类型： 设置 格式： $PAIR100,,* 参数： 字段 格式 单位 十进制 - 十进制 - 描述 NMEA 标准语句的输出模式。 0 = 禁用 1 = 启用 ASCII NMEA 0183 V4.10 输出 2 = 启用 ASCII NMEA 0183 V3.01 输出 预留。默认值：0。 结果： 返回$PAIR001 消息。 示例： $PAIR100,1,0*3A 上海移远通信技术股份有限公司 89 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 $PAIR001,100,0*3A 备注 LC29H (BA, CA, DA, EA)不支持该指令，其 NMEA 标准语句以 NMEA 0183 V4.10 格式输出。 2.4.28. PAIR101: PAIR_COMMON_GET_NMEA_OUTPUT_MODE 查询 NMEA 标准语句的输出模式。 类型： 查询 格式： $PAIR101* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR101,,* 结果中包含的参数： 字段 格式 单位 十进制 - 十进制 - 描述 NMEA 标准语句的输出模式。 0 = 禁用 1 = 启用 ASCII NMEA 0183 V4.10 输出 2 = 启用 ASCII NMEA 0183 V3.01 输出 预留。默认值：0。 上海移远通信技术股份有限公司 90 / 118 示例： $PAIR101*3A $PAIR001,101,0*3B $PAIR101,1,0*3B 备注 LC29H (BA, CA, DA, EA)不支持该命令。 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.29. PAIR104: PAIR_COMMON_SET_DUAL_BAND 启用/禁用 GNSS 双频段功能，该指令需在 GNSS 系统断电后发送。 类型： 设置 格式： $PAIR104,* 参数： 字段 格式 十进制 单位 - 描述 启用/禁用双频功能。 0 = 禁用 1 = 启用 结果： 返回$PAIR001 消息。 示例： $PAIR104,0*23 $PAIR001,104,0*3E 备注 1. LC29H (BA, CA, DA, EA)不支持该命令。 2. 使用$PAIR104 设置双频段功能前，需依次发送$PAIR382,1*2E 和$PAIR003*39 关闭 GNSS 系统。 上海移远通信技术股份有限公司 91 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 设置双频段功能后，发送$PAIR002*38 给模块上电。 2.4.30. PAIR105: PAIR_COMMON_GET_DUAL_BAND 查询双频段功能状态。 类型： 查询 格式： $PAIR105* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR105,* 结果中包含的参数： 字段 格式 单位 十进制 - 描述 双频功能的状态。 0 = 禁用 1 = 启用 示例： $PAIR105*3E $PAIR001,105,0*3F $PAIR105,1*23 上海移远通信技术股份有限公司 92 / 118 备注 LC29H (BA, CA, DA, EA)不支持该命令。 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.31. PAIR382: PAIR_TEST_LOCK_SYSTEM_SLEEP 启用/禁用休眠模式锁定。命令发送后，CPU 内核将锁定到休眠模式。 类型： 设置 格式： $PAIR382,* 参数： 字段 格式 十进制 单位 - 描述 休眠模式锁定设置。 0 = 禁用 1 = 启用 结果： 返回$PAIR001 消息。 示例： $PAIR382,1*2E $PAIR001,382,0*32 备注 1. 此配置不保存在 flash 或 RTC RAM 中。请在 GNSS 系统或主电源重新启动后重新发送此命令。 2. 若依次向模块发送$PAIR382,1*2E 和$PAIR003*39 命令，且模块返回$PAIR001,382,0*32，则模块 仍可以接收其他命令。否则，模块将不会响应任何命令。 上海移远通信技术股份有限公司 93 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.32. PAIR391: PAIR_TEST_JAMMING_DETECT 启用/禁用干扰检测。启用干扰检测后，将返回干扰状态信息。 类型： 设置/输出 格式： $PAIR391,* 参数： 字段 格式 十进制 单位 - 描述 启用/禁用干扰检测。 0 = 禁用 1 = 启用 结果： 返回$PAIR001 消息，并启用$PAIRSPF 或$PAIRSPF5 语句周期性（以 1 Hz 频率）输出。 查询结果消息格式： $PAIRSPF,* $PAIRSPF5,* 结果中包含的参数： 字段 格式 单位 十进制 - 描述 干扰状态。 0 = 未知状态 1 = 无干扰，状态良好 2 = 警告状态 3 = 紧急状态 示例： $PAIR391,1*2C $PAIR001,391,0*30 //未知状态： 上海移远通信技术股份有限公司 94 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 $PAIRSPF,0*53 $PAIRSPF5,0*66 //无干扰： $PAIRSPF,1*52 $PAIRSPF5,1*67 //警告状态： $PAIRSPF,2*51 $PAIRSPF5,2*64 //紧急状态： $PAIRSPF,3*50 $PAIRSPF5,3*65 备注 1. $PAIRSPF,*语句表示 L1 干扰状态。 2. $PAIRSPF5,*语句表示 L5 干扰状态。当仅接收和跟踪 L1 频段信 号时，该语句不输出。 3. 启用该功能后，模块将开始干扰检测。 ⚫ 如 果 没 有 干 扰 ， 将 输 出 $PAIRSF,1*52 或 $PAIRPF,1*55 和 $PAIRSF5,1*62 表 示 状 态 良 好 （ = 1）。 ⚫ 在持续干扰的情况下，干扰状态将从 1 变为 2，最后变为 3。 1) 当未完成定位时：模块状态在启用干扰检测后立即为 1，然后在检测到干扰时变为 2。在这 个过程中，模块不断尝试获取定位；如果抗干扰修复失败，干扰状态最终变为 3。 2) 定位成功后：干扰检测启用后，干扰状态为 1，检测到干扰时，干扰状态连续变为 2 和 3。 2.4.33. PAIR400: PAIR_DGPS_SET_MODE 设置 DGPS 校正数据源。 类型： 设置 格式： $PAIR400,* 上海移远通信技术股份有限公司 95 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 参数： 字段 格式 单位 十进制 - 描述 DGPS 数据源。 0 = 无 DGPS 数据源 1 = RTCM 2 = SBAS（包括 WAAS、EGNOS、GAGAN、MSAS） 结果： 返回$PAIR001 消息。 示例： $PAIR400,2*20 $PAIR001,400,0*3F 备注 LC29H (BA, CA, DA, EA)不支持该命令。 2.4.34. PAIR401: PAIR_DGPS_GET_MODE 查询 DGPS 校正数据源。 类型： 查询 格式： $PAIR401* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 上海移远通信技术股份有限公司 96 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 查询结果消息格式： $PAIR401,* 结果中包含的参数： 字段 格式 十进制 单位 - 描述 DGPS 数据源。 0 = 无 DGPS 数据源 1 = RTCM 2 = SBAS（包括 WAAS、EGNOS、GAGAN、MSAS） 示例： $PAIR401*3F $PAIR001,401,0*3E $PAIR401,2*21 备注 LC29H (BA, CA, DA, EA)不支持该命令。 2.4.35. PAIR410: PAIR_SBAS_ENABLE 启用/禁用 SBAS 卫星搜索。SBAS 通过地球静止卫星广播消息支持广域或区域增强。地球静止卫星在 位于精确测量点的多个地面站协助下，广播全球导航卫星系统完整的校正数据。 类型： 设置 格式： $PAIR410,* 参数： 字段 格式 十进制 单位 - 描述 启用或禁用 SBAS 卫星搜索。 0 = 禁用 1 = 启用 上海移远通信技术股份有限公司 97 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 结果： 返回$PAIR001 消息。 示例： $PAIR410,1*22 $PAIR001,410,0*3E 备注 1. 当导航模式为健身或游泳模式（参考$PAIR080 命令）时，模块不支持 SBAS。 2. LC29H (EA)不支持 SBAS 功能，因此不支持该命令。 2.4.36. PAIR411: PAIR_SBAS_GET_STATUS 查询 SBAS 卫星搜索状态。 类型： 查询 格式： $PAIR411* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR411,* 结果中包含的参数： 字段 格式 单位 十进制 - 描述 SBAS 卫星搜索状态。 0 = 禁用 上海移远通信技术股份有限公司 98 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 1 = 启用 示例： $PAIR411*3E $PAIR001,411,0*3F $PAIR411,1*23 备注 1. 当导航模式为健身或游泳模式（参考$PAIR080 命令）时，模块不支持 SBAS。 2. LC29H (EA)不支持 SBAS 功能，因此不支持该命令。 2.4.37. PAIR432: PAIR_RTCM_SET_OUTPUT_MODE 设置 RTCM 输出模式。 类型： 设置 格式： $PAIR432,* 参数： 字段 格式 十进制 单位 - 描述 RTCM 输出模式设置。 -1 = 禁用输出 RTCM 消息 0 = 启用输出 RTCM3 消息（消息类型为 MSM4） 1 = 启用输出 RTCM3 消息（消息类型为 MSM7） 结果： 返回$PAIR001 消息。 示例： $PAIR432,1*22 $PAIR001,432,0*3E 上海移远通信技术股份有限公司 99 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.38. PAIR433: PAIR_RTCM_GET_OUTPUT_MODE 查询 RTCM 输出模式。 类型： 查询 格式： $PAIR433* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR433,* 结果中包含的参数： 字段 格式 单位 十进制 - 描述 RTCM 输出模式设置。 -1 = 禁用输出 RTCM 消息 0 = 启用输出 RTCM3 消息（消息类型为 MSM4） 1 = 启用输出 RTCM3 消息（消息类型为 MSM7） 示例： $PAIR433*3E $PAIR001,433,0*3F $PAIR433,-1*0E 2.4.39. PAIR434: PAIR_RTCM_SET_OUTPUT_ANT_PNT 启用/禁用以 RTCM 格式输出静态天线参考点。 上海移远通信技术股份有限公司 100 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 类型： 设置 格式： $PAIR434,* 参数： 字段 格式 十进制 单位 - 描述 启用/禁用输出静态天线参考点（消息类型 1005）。 0 = 禁用 1 = 启用 结果： 返回$PAIR001 消息。 示例： $PAIR434,1*24 $PAIR001,434,0*38 2.4.40. PAIR435: PAIR_RTCM_GET_OUTPUT_ANT_PNT 查询以 RTCM 格式输出静态天线参考点的设置。 类型： 查询 格式： $PAIR435* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 上海移远通信技术股份有限公司 101 / 118 查询结果消息格式： $PAIR435,* 结果中包含的参数： 字段 格式 单位 十进制 - 示例： $PAIR435*38 $PAIR001,435,0*39 $PAIR435,1*25 LC29H 系列&LC79H (AL) GNSS 协议规范 描述 静态天线参考点输出状态（消息类型 1005）。 0 = 禁用 1 = 启用 2.4.41. PAIR436: PAIR_RTCM_SET_OUTPUT_EPHEMERIS 启用/禁用以 RTCM 格式输出卫星星历信息。 类型： 设置 格式： $PAIR436,* 参数： 字段 格式 十进制 单位 - 描述 启用/禁用输出卫星星历。 0 = 禁用 1 = 启用 结果： 返回$PAIR001 消息。 上海移远通信技术股份有限公司 102 / 118 示例： $PAIR436,1*26 $PAIR001,436,0*3A LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.42. PAIR437: PAIR_RTCM_GET_OUTPUT_EPHEMERIS 查询 RTCM 格式的卫星星历输出状态。 类型： 查询 格式： $PAIR437* 参数： 无 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR437,* 结果中包含的参数： 字段 格式 单位 十进制 - 描述 卫星星历输出状态。 0 = 禁用 1 = 启用 示例： $PAIR437*3A $PAIR001,437,0*3B $PAIR437,1*27 上海移远通信技术股份有限公司 103 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.43. PAIR511: PAIR_NVRAM_SAVE_NAVIGATION_DATA 将当前导航数据从 RTC RAM 保存到 NVM。 类型： 命令 格式： $PAIR511* 参数： 无 结果： 返回$PAIR001 消息。 示例： //如果定位频率为 1 Hz $PAIR511*3F $PAIR001,511,0*3E //如果定位频率大于 1 Hz $PAIR382,1*2E $PAIR001,382,0*32 $PAIR003*39 $PAIR001,003,0*38 $PAIR511*3F $PAIR001,511,0*3E $PAIR002*38 $PAIR001,002,0*39 备注 1. 如果模块断电后备份域无法通电，则每次修改参数后都需要发送此命令。 2. 当定位频率大于 1 Hz 时，依次发送$PAIR382,1*2E 和$PAIR003*39 关闭 GNSS 系统电源后，方可 发送该命令。发送$PAIR511*3F 后，通过$PAIRE002*38 重新给模块供电。定位频率低于 1 Hz 时无 此限制。 上海移远通信技术股份有限公司 104 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.44. PAIR513: PAIR_NVRAM_SAVE_SETTING 将当前配置从 RTC RAM 保存到 NVM。 类型： 命令 格式： $PAIR513* 参数： 无 结果： 返回$PAIR001 消息。 示例： //如果定位频率为 1 Hz $PAIR513*3D $PAIR001,513,0*3C //如果定位频率大于 1 Hz $PAIR382,1*2E $PAIR001,382,0*32 $PAIR003*39 $PAIR001,003,0*38 $PAIR513*3D $PAIR001,513,0*3C $PAIR002*38 $PAIR001,002,0*39 备注 1. 如果模块断电后备份域无法通电，则每次修改参数后都需要发送此命令。 2. 当定位频率大于 1 Hz 时，依次发送$PAIR382,1*2E 和$PAIR003*39 关闭 GNSS 系统电源后，方可 发送该命令。发送$PAIR513*3D 后，通过$PAIRE002*38 重新给模块供电。定位频率低于 1 Hz 时无 此限制。 上海移远通信技术股份有限公司 105 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.45. PAIR650: PAIR_LOW_POWER_ENTRY_RTC_MODE 关闭 GNSS 系统（不包括时钟）。命令发送后，CPU 内核将被设置为 Backup 模式，在该模式下，模 块无法接收任何命令。有关 Backup 模式的详细信息，请参考文档 [1]和[2]硬件设计手册。 类型： 设置 格式： $PAIR650,* 参数： 字段 格式 十进制 单位 秒 描述 退出 Backup 模式前待机的时间。 范围：0 和 10~62208000（2 年）；0 表示一直处于 Backup 模式。 结果： ⚫ 如无错误，模块返回$PAIR001 和$PAIR650 消息。模块将被设置为 Backup 模式，且无法接收任何命 令。 ⚫ 如出现任何参数错误，模块返回$PAIR001 消息。 示例： $PAIR650,0*25 $PAIR001,650,0*38 $PAIR650,0*25 备注 有关进入或退出 Backup 模式的详细信息，请参考文档 [1]和[2]硬件设计手册。 上海移远通信技术股份有限公司 106 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.46. PAIR752: PAIR_PPS_SET_CONFIG_CMD 设置 PPS 配置。 类型： 设置 格式： $PAIR752,,* 参数： 字段 格式 单位 十进制 - 十进制 毫秒 描述 PPS 脉冲类型。 0 = 禁用 1 = 首次定位后 2 = 仅 3D 定位 3 = 仅 2D/3D 定位 4 = 始终 PPS 脉冲宽度。范围：1~999。 默认值：100。 结果： 返回$PAIR001 消息。 示例： $PAIR752,2,100*39 $PAIR001,752,0*3B 2.4.47. PAIR864: PAIR_IO_SET_BAUDRATE 设置 UART 接口的波特率。 类型： 设置 上海移远通信技术股份有限公司 107 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 格式： $PAIR864,,,* 参数： 字段 格式 十进制 十进制 十进制 单位 - bps 描述 硬件接口类型。 0 = UART 硬件接口号。 0 = UART1 波特率。 4800 9600 19200 38400 57600 115200 230400 460800 921600 3000000 结果： 返回$PAIR001 消息。 示例： $PAIR864,0,0,115200*1B $PAIR001,864,0*31 备注 1. 须在修改接口波特率后重启模块，所做更改将在模块重启后生效。 2. 输出波特率低于 115200 bps 时，LC29H 系列和 LC79H (AL)模块可能会丢失消息。 上海移远通信技术股份有限公司 108 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.48. PAIR865: PAIR_IO_GET_BAUDRATE 查询 UART 接口的波特率。 类型： 查询 格式： $PAIR865,,* 参数： 字段 格式 十进制 十进制 单位 - 描述 硬件接口类型。 0 = UART 硬件接口号。 0 = UART1 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR865,* 结果中包含的参数： 字段 格式 单位 十进制 bps 描述 波特率。 4800 9600 19200 38400 57600 115200 230400 460800 921600 3000000 上海移远通信技术股份有限公司 109 / 118 示例： $PAIR865,0,0*31 $PAIR001,865,0*30 $PAIR865,115200*1A LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.49. PAIR866: PAIR_IO_SET_FLOW_CONTROL 设置 UART 接口流控。 类型： 设置 格式： $PAIR866,,,* 参数： 字段 格式 十进制 十进制 十进制 单位 - 描述 硬件接口类型。 0 = UART 硬件接口号。 0 = UART1 流控设置。 0 = 禁用流控 1 = 启用软件流控 结果： 返回$PAIR001 消息。 示例： $PAIR866,0,0,1*2F $PAIR001,866,0*33 上海移远通信技术股份有限公司 110 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 2.4.50. PAIR867: PAIR_IO_GET_FLOW_CONTROL 查询 UART 接口流控状态。 类型： 查询 格式： $PAIR867,,* 参数： 字段 格式 十进制 十进制 单位 - 描述 硬件接口类型。 0 = UART 硬件接口号。 0 = UART1 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR867,* 结果中包含的参数： 字段 格式 单位 十进制 - 描述 流控设置。 0 = 禁用流控 1 = 启用软件流控 示例： $PAIR867,0,0*33 $PAIR001,867,0*32 $PAIR867,0*2F 上海移远通信技术股份有限公司 111 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 3 RTCM 协议 LC29H 系列和 LC79H (AL)模块支持 RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services - Version 3 协 议 。 该 协 议 用 于 传 输 GNSS 原 始 测 量 数 据 ， 可 通 过 https://www.rtcm.org/获取。 表 8：支持的 RTCM3 消息 消息类型 1005 1019 1020 1042 1044 1046 1074 1077 1084 1087 1094 1097 1114 1117 1124 1127 模式 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 输出 消息名称 静态 RTK 参考站 ARP GPS 星历 GLONASS 星历 BDS 卫星星历数据 QZSS 星历 Galileo I/NAV 卫星星历数据 GPS MSM4 GPS MSM7 GLONASS MSM4 GLONASS MSM7 Galileo MSM4 Galileo MSM7 QZSS MSM4 QZSS MSM7 BDS MSM4 BDS MSM7 上海移远通信技术股份有限公司 112 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 备注 1. 若相应的卫星已被启用，$PAIR432 命令可用于启用或禁用 MSM4/MSM7（1074、1077、1084、1087、 1094、1097、1114、1117、1124 和 1127）消息。 2. $PAIR434 命令可用于启用或禁用静态 RTK 参考站 ARP（1005）消息。 3. 若相应的卫星已被启用，$PAIR436 命令可用于启用或禁用星历（1019、1020、1042、1044 和 1046） 消息。 上海移远通信技术股份有限公司 113 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 4 附录 A 参考文档及术语缩写 表 9：参考文档 文档名称 [1] Quectel_LC29H 系列_硬件设计手册 [2] Quectel_LC79H(AL)_Hardware_Design 表 10：术语缩写 缩写 英文全称 中文全称 2D 2 Dimensional 2维 3D 3 Dimensional 3维 ACK Acknowledgement 确认消息 AIC Active Interference Cancellation 主动干扰消除 ARP Antenna Reference Point 天线参考点 BDS BeiDou Navigation Satellite System 北斗卫星导航系统 DGPS Differential Global Positioning System 差分全球定位系统 DOP Dilution of Precision 精度因子 DSP Digital Signal Processing 数字信号处理 ECEF EGNOS EPO Earth-Centered, Earth-Fixed 地心地固坐标系 European Geostationary Navigation Overlay 欧洲地球静止导航重叠服务 Service Extended Prediction Orbit 延伸轨道预测 GAGAN GPS Aided Geo Augmented Navigation GPS 辅助型静地轨道增强导航 上海移远通信技术股份有限公司 114 / 118 缩写 Galileo GGA GLL GNSS GPS GRS GSA GST GSV RMS HDOP ID MNL MSAS NMEA NVRAM PAIR PDOP PE PPS QZSS RF RMC RTC LC29H 系列&LC79H (AL) GNSS 协议规范 英文全称 中文全称 Galileo Satellite Navigation System (EU) 伽利略卫星导航系统（欧盟） Global Positioning System Fix Data 全球定位系统定位数据 Geographic Position – Latitude and Longitude 地理位置——纬度和经度 Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 GNSS Range Residuals 全球导航卫星系统范围残差值 GNSS DOP and Active Satellites GNSS 精度因子（DOP）与有效卫星 GNSS Pseudorange Error Statistics GNSS 伪距误差统计 GNSS Satellites in View 可视的 GNSS 卫星 Root Mean Square 均方根 Horizontal Dilution of Precision 水平精度因子 Identifier 标识符 Middleware Navigation Library 导航中间件库 Multi-functional Satellite Augmentation System (Japan) NMEA (National Marine Electronics Association) 0183 Interface Standard 多功能卫星增强系统（日本） NMEA（美国国家海洋电子协会）0183 接口标准 Non-Volatile Random Access Memory 非易失性随机访问存储器 Proprietary Protocol of Airoha Airoha 专有协议 Position Dilution of Precision 位置精度因子 Positioning Engine 定位引擎 Pulse Per Second 秒脉冲 Quasi-Zenith Satellite System 准天顶卫星系统（日本） Radio Frequency 射频 Recommended Minimum Specific GNSS Data 推荐的最少专用 GNSS 数据 Real-Time Clock 实时时钟 上海移远通信技术股份有限公司 115 / 118 缩写 RTK SBAS SNR SV PVT UART UTC VDOP VTG WAAS ZDA LC29H 系列&LC79H (AL) GNSS 协议规范 英文全称 中文全称 Real-Time Kinematic 实时动态 Satellite-Based Augmentation System 星基增强系统 Signal-to-Noise Ratio 信噪比 Satellites in View 视图中的卫星 Position, Velocity, and Timing 位置、速度和时间 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Coordinated Universal Time 协调世界时 Vertical Dilution of Precision 垂直精度因子 Course Over Ground & Ground Speed 对地航向和对地速度 Wide Area Augmentation System 广域增强系统 Time & Date 时间与日期 上海移远通信技术股份有限公司 116 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 5 附录 B GNSS 标识符 表 11：GNSS 标识符 卫星系统 系统标识符 GPS 1 GLONASS 2 Galileo 3 BDS 4 QZSS 5 卫星标识号 1~32 33~51 为 SBAS 65~88 1~36 1~63 193~199 信号标识号/信号通道 1 = L1 C/A 8 = L5 1 = L1 1 = E5a 7 = E1 1 = B1I 5 = B2a 1 = L1 C/A 8 = L5 备注 1. LC29H (AA)和 LC79H (AL)模块的 QZSS 系统标识符为 1。 2. LC29H (BA, CA, DA, EA)的 QZSS 卫星标识号范围为 1~10。 上海移远通信技术股份有限公司 117 / 118 LC29H 系列&LC79H (AL) GNSS 协议规范 6 附录 C 特殊字符 表 12：特殊字符 特殊字符 […] {…} 下划线 描述 参数名称（实际命令中不包含尖括号） 可选参数（实际命令中不包含方括号） 循环参数（实际命令中不包含大括号） 参数的默认设置。 上海移远通信技术股份有限公司 118 / 118

LC79D (C) GNSS Protocol Specification GNSS Module Series Version: 1.0 Date: 2022-05-20 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LC79D(C)_GNSS_Protocol_Specification 1 / 42 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. LC79D(C)_GNSS_Protocol_Specification 2 / 42 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LC79D (C) GNSS Protocol Specification GNSS Module Series GNSS Protocol Specification Released Revision History Version 1.0 Date 2022-03-15 2022-05-20 Description Creation of the document First official release LC79D(C)_GNSS_Protocol_Specification 3 / 42 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index .................................................................................................................................................. 6 1 Introduction ......................................................................................................................................... 7 2 NMEA Protocol .................................................................................................................................... 8 2.1. Structure of NMEA Protocol Messages ..................................................................................... 8 2.2. Standard Messages ................................................................................................................... 9 2.2.1. RMC ................................................................................................................................ 9 2.2.2. GGA................................................................................................................................11 2.2.3. GSV ............................................................................................................................... 14 2.2.4. GSA ............................................................................................................................... 15 2.2.5. VTG ............................................................................................................................... 17 2.2.6. GLL................................................................................................................................ 18 2.3. PQTM Messages ..................................................................................................................... 20 2.3.1. PQTMCOLD .................................................................................................................. 20 2.3.2. PQTMWARM................................................................................................................. 20 2.3.3. PQTMHOT .................................................................................................................... 21 2.3.4. PQTMSRR .................................................................................................................... 21 2.3.5. PQTMSETGLP.............................................................................................................. 22 2.3.6. PQTMGETGLP ............................................................................................................. 23 2.3.7. PQTMSETBAUD ........................................................................................................... 24 2.3.8. PQTMSETCNST ........................................................................................................... 24 2.3.9. PQTMGETCNST........................................................................................................... 25 2.3.10. PQTMSETL5BIAS ........................................................................................................ 26 2.3.11. PQTMGETL5BIAS ........................................................................................................ 27 2.3.12. PQTMCFGODO ............................................................................................................ 28 2.3.13. PQTMREQODO............................................................................................................ 29 2.3.14. PQTMRESETODO ....................................................................................................... 30 2.3.15. PQTMSTARTODO ........................................................................................................ 30 2.3.16. PQTMSTOPODO.......................................................................................................... 31 2.3.17. PQTMCFGGEOFENCE................................................................................................ 32 2.3.18. PQTMSETGEOFENCE ................................................................................................ 33 2.3.19. PQTMGETGEOFENCE ................................................................................................ 34 2.3.20. PQTMREQGEOFENCE................................................................................................ 35 2.3.21. PQTMCFGNMEAMSG ................................................................................................. 36 2.3.22. PQTMCFGEAMASK ..................................................................................................... 37 2.3.23. PQTMCFGCLAMPING ................................................................................................. 37 2.3.24. PQTMSAVEPAR ........................................................................................................... 38 2.3.25. PQTMRESTOREPAR ................................................................................................... 39 3 Appendix A References .................................................................................................................... 40 LC79D(C)_GNSS_Protocol_Specification 4 / 42 GNSS Module Series 4 Appendix B GNSS Numbering......................................................................................................... 42 LC79D(C)_GNSS_Protocol_Specification 5 / 42 GNSS Module Series Table Index Table 1: Structure of the NMEA Protocol Message...................................................................................... 8 Table 2: NMEA Talker ID .............................................................................................................................. 9 Table 3: Terms and Abbreviations .............................................................................................................. 40 Table 4: GNSS Numbering ......................................................................................................................... 42 LC79D(C)_GNSS_Protocol_Specification 6 / 42 GNSS Module Series 1 Introduction Quectel LC79D (C) GNSS module supports GPS, GLONASS, Galileo, BDS, QZSS and NavIC (IRNSS) constellations. The tracking of GPS L1 C/A, GPS L5-Q, GLONASS L1 C/A, Galileo E1, Galileo E5a, BDS B1l, QZSS L1 C/A, QZSS L5-Q and NavIC L5-SPS frequency bands provides fast and accurate acquisition and makes this module an ideal solution for positioning and navigation in various vertical markets. This document describes the software commands that are needed to control and modify the module configuration. The software commands are NMEA proprietary commands defined by Quectel (PQTM commands). To report GNSS information, the module supports output messages in NMEA 0183 standard protocol. NOTE Quectel assumes no responsibility if commands other than the ones listed in this document are used. LC79D(C)_GNSS_Protocol_Specification 7 / 42 GNSS Module Series 2 NMEA Protocol 2.1. Structure of NMEA Protocol Messages The start character of the frame, always ‘$’ Address field, contains talker Identifier and sentence formatter Start with a ‘*’, 8-bit checksum value convert to two ASCII characters Data field(s), delimited by ‘,’ End frame, always $ () [,] * The range for checksum calculation Figure 1: Structure of the NMEA Protocol Message Table 1: Structure of the NMEA Protocol Message Field $ Description Start of the sentence (Hex 0x24). In Standard Messages: In NMEA standard messages, this field consists of a two-character talker identifier (TalkerID) and a three-character sentence formatter (SentenceFormatter). The talker identifier serves to define the nature of the data being transmitted. For more information on the TalkerID, see Table 2: NMEA Talker ID. The sentence formatter is used to define data format and type. In Proprietary Messages: In NMEA proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer's Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. Data fields, delimited by comma (,). Variable length (depends on the NMEA message type). LC79D(C)_GNSS_Protocol_Specification 8 / 42 GNSS Module Series The checksum field follows the checksum delimiter character *. The checksum is the 8-bit exclusive OR of all characters in the sentence, including the comma (,) delimiter, between but not including the $ and the * delimiters. End of the sentence (Hex 0x0D 0x0A). Table 2: NMEA Talker ID GNSS Constellation Configuration GPS GLONASS Galileo BDS QZSS NavIC (IRNSS) Combination of Multiple Satellite Systems TalkerID (NMEA V4.11) GP GL GA GB GQ GI GN 2.2. Standard Messages This chapter explains the NMEA 0183 V4.11 standard messages supported by the module. 2.2.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type: Output Synopsis: $RMC,,,,,,,,,,,,,* LC79D(C)_GNSS_Protocol_Specification 9 / 42 GNSS Module Series Parameter: Field $ RMC Format Unit - - String, 2 characters - String, 3 characters - hhmmss.ss - Character - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character Numeric Knot Example Description $ Each NMEA message starts with $. GN RMC 060512.00 A 3150.788156 N 11711.922383 E Talker identifier. See Table 2: NMEA Talker ID. Recommended Minimum Specific GNSS Data. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Positioning system status: A = Data valid V = Invalid D = Differential Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction: N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction: E = East W = West Note that this field is empty in case of an invalid value. 0.0 Speed over ground. Variable length. LC79D(C)_GNSS_Protocol_Specification 10 / 42 GNSS Module Series Numeric ddmmyy - - Character Character Hexadecimal Character Degree - - 311019 - - - - - A - V - *1B - - Note that this field is empty in case of an invalid value. Course over ground. Variable length. Maximum value: 359.9. Note that this field is empty in case of an invalid value. Date: dd: Day of month mm: Month yy: Year Magnetic variation. Not supported. The direction of magnetic variation. Not supported. Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix E = Estimated (dead reckoning) mode. M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid. Navigational status. Not supported. Always 'V' (Navigational status not valid). (NMEA V4.11) Checksum. Carriage return and line feed. Example: $GNRMC,000010.00,V,,,,,,,020712,,,N,V*1E $GNRMC,060512.00,A,3150.788156,N,11711.922383,E,0.0,,311019,,,A,V*1B 2.2.2. GGA Global Positioning System Fix Data. Time, position, and fix-related data for a GNSS receiver. Type: Output LC79D(C)_GNSS_Protocol_Specification 11 / 42 GNSS Module Series Synopsis: $GGA,,,,,,,,,,M,,M,,* Parameter: Field $ GGA Format Unit - - String, 2 characters - String, 3 characters - hhmmss.ss - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - Example Description $ Each NMEA message starts with $. GN GGA 062735.00 3150.788156 N 11711.922383 E Talker identifier. See Table 2: NMEA Talker ID. Global Positioning System Fix Data. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction: N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction: E = East W = West Note that this field is empty in case of an invalid value. LC79D(C)_GNSS_Protocol_Specification 12 / 42 GNSS Module Series Numeric, 1 digit - 1 1) Numeric, 2 digits - 12 Numeric - 2.0 Numeric Meter 90.0 M Character - M Numeric Meter - M Character Hexadecimal Character - M - - - - - *55 - - GPS quality indicator: 0 = Fix not available or invalid 1 = GPS SPS Mode, fix valid 3 = GPS PPS Mode, fix valid 6 = Estimated (dead reckoning) mode Number of satellites in use. Horizontal dilution of precision. Altitude above mean-sea-level (geoid). Note that this field is empty in case of an invalid value. - Geoid separation (the difference between the earth ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). Note that this field is empty in case of an invalid value. - Differential GPS data age. Not supported. Differential reference station ID. Not supported. Checksum. Carriage return and line feed. Example: $GNGGA,000010.00,,,,,0,00,99.0,,M,,M,,*49 $GNGGA,062735.00,3150.788156,N,11711.922383,E,1,12,2.0,90.0,M,,M,,*55 LC79D(C)_GNSS_Protocol_Specification 13 / 42 GNSS Module Series NOTE 1. The NMEA 0183 specification indicates that the GGA message is GPS specific. However, when the receiver is configured for multi-constellations, the content of GGA message will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12. 2.2.3. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value, and contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of sentences being transmitted and the sentence number are indicated in the first two data fields. Type: Output Synopsis: $GSV,,,{,,,,}, * Parameter: Field Format Unit Example Description $ - - String, 2 characters - GSV String, 3 characters - Numeric - Numeric - Numeric - $ GP GSV 3 1 11 Each NMEA message starts with $. Talker identifier. See Table 2: NMEA Talker ID. GNSS Satellites in View. Total number of sentences. Range: 1–9. Sentence number. Range: 1–. Total number of satellites in view. Start of repeat block. Repeat times: 1–4. Numeric - 05 Numeric Degree 09 Satellite ID. See Table 4: GNSS Numbering. Satellite elevation. Range: 00–90. Note that this field is empty in case of LC79D(C)_GNSS_Protocol_Specification 14 / 42 GNSS Module Series Numeric Numeric End of repeat block. Numeric Hexadecimal Character Degree 116 dB-Hz 27 - 1 - *68 - - an invalid value. Satellite azimuth, with true north as the reference plane. Range: 000–359. Note that this field is empty in case of an invalid value. Satellite C/N0. Range: 00–99. Null when not tracking. GNSS signal ID. See Table 4: GNSS Numbering. Checksum. Carriage return and line feed. Example: $GPGSV,3,1,11,05,09,116,27,10,24,312,44,12,09,141,28,13,14,055,41,1*68 $GPGSV,3,2,11,15,45,045,49,20,52,323,46,24,76,125,26,27,,,19,1*51 $GPGSV,3,3,11,10,24,312,43,24,76,125,13,27,,,19,8*63 $GLGSV,2,1,07,78,45,071,45,77,10,028,39,79,,,16,69,38,327,48,1*43 $GLGSV,2,2,07,84,35,279,21,85,09,331,32,67,09,083,44,1*4D $GQGSV,2,1,03,01,66,079,38,02,45,132,19,1*6A $GQGSV,2,2,03,01,66,079,35,8*56 $GBGSV,1,1,04,206,67,338,43,211,13,303,31,216,65,322,41,219,15,096,39,1*71 $GIGSV,1,1,02,03,38,233,23,07,,,25,1*44 NOTE GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, use separate GSV sentences with the corresponding Talker ID for each constellation. 2.2.4. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA sentence, and DOP values. Type: Output LC79D(C)_GNSS_Protocol_Specification 15 / 42 GNSS Module Series Synopsis: $GSA,,{,},,,* Parameter: Field $ GSA Format Unit - - String, 2 characters - String, 3 characters - Character - Numeric - Start of repeat block. Repeat times: 12. Numeric - End of repeat block. Numeric - Numeric - Numeric - Numeric - Hexadecimal - Character - Example Description $ GN GSA A 3 Each NMEA message starts with $. Talker identifier. See Table 2: NMEA Talker ID. GNSS DOP and Active Satellites. M = Manual, forced to operate in 2D or 3D mode A = Automatic, allowed to automatically switch to 2D/3D 1 = Fix not available 2 = 2D 3 = 3D ID numbers of satellites used in solution. See Table 4: GNSS Numbering. 10 Note that this field is empty in case of an invalid value. 2.5 Position dilution of precision. Maximum value: 99.0. 2.0 Horizontal dilution of precision. Maximum value: 99.0. 1.5 Vertical dilution of precision. Maximum value: 99.0. 1 GNSS system ID. See Table 4: GNSS Numbering. *35 Checksum. - Carriage return and line feed. Example: $GNGSA,A,3,10,13,15,20,,,,,,,,,2.5,2.0,1.5,1*35 $GNGSA,A,3,67,69,77,78,85,,,,,,,,2.5,2.0,1.5,2*3F LC79D(C)_GNSS_Protocol_Specification 16 / 42 $GNGSA,A,3,,,,,,,,,,,,,2.5,2.0,1.5,3*32 $GNGSA,A,3,,,,,,,,,,,,,2.5,2.0,1.5,4*35 $GNGSA,A,3,01,,,,,,,,,,,,2.5,2.0,1.5,5*35 $GNGSA,A,3,,,,,,,,,,,,,2.5,2.0,1.5,6*37 GNSS Module Series NOTE If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used for navigation, only the IDs of the first 12 are output. 2.2.5. VTG Course Over Ground & Ground Speed. The actual course and speed relative to the ground. Type: Output Synopsis: $VTG,,T,,M,,N,,K,* Parameter: Field $ VTG T M N Format Unit Example Description - - $ String, 2 characters - GN String, 3 characters - VTG Numeric Degree - Character - T Numeric Degree - Character - M Numeric Character Knot 0.0 - N Each NMEA message starts with $. Talker identifier. See Table 2: NMEA Talker ID. Course Over Ground & Ground Speed. Course over ground, in true north course direction. Not supported. Course over ground. (degrees true, fixed field). Course over ground (magnetic). Not supported. Course over ground. (degrees magnetic, fixed field). Speed over ground in knots. Note that this field is empty in case of an invalid value. Speed over ground (knots, fixed field). LC79D(C)_GNSS_Protocol_Specification 17 / 42 Numeric K Character Character Hexadecimal Character Example: $GNVTG,,T,,M,0.0,N,0.0,K,A*3D km/h 0.0 - K - A - *3D - - GNSS Module Series Speed over ground in kilometers per hour. Note that this field is empty in case of an invalid value. Speed over ground. (kilometers per hour, fixed field). Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix E = Estimated (dead reckoning) mode M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid Checksum. Carriage return and line feed. 2.2.6. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type: Output Synopsis: $GLL,,,,,,,* Parameter: Field $ Format - Unit Example - $ String, 2 characters - GN GLL String, 3 characters - GLL Description Each NMEA message starts with $. Talker identifier. See Table 2: NMEA Talker ID. Geographic Position – Latitude/Longitude. LC79D(C)_GNSS_Protocol_Specification 18 / 42 GNSS Module Series ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - hhmmss.ss - Character - Character - Hexadecimal - Character - 3150.788156 N 11711.922383 E 062735.00 A A Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction: N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction: E = East W = West Note that this field is empty in case of an invalid value. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Positioning system status: V = Invalid A = Autonomous D = Differential Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix E = Estimated (dead reckoning) mode M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid *76 Checksum. - Carriage return and line feed. LC79D(C)_GNSS_Protocol_Specification 19 / 42 Example: $GNGLL,,,,,000010.00,V,N*55 $GNGLL,3150.788156,N,11711.922383,E,062735.00,A,A*76 GNSS Module Series 2.3. PQTM Messages This chapter explains the PQTM messages (proprietary NMEA messages defined by Quectel) supported by LC79D (C). 2.3.1. PQTMCOLD Performs a cold start. Type: Command Synopsis: $PQTMCOLD* Parameter: None Result: Cold start initialization and GNSS engine restart. Example: $PQTMCOLD*1C 2.3.2. PQTMWARM Performs a warm start. Type: Command Synopsis: $PQTMWARM* LC79D(C)_GNSS_Protocol_Specification 20 / 42 Parameter: None Result: Warm start initialization and GNSS engine restart. Example: $PQTMWARM*11 2.3.3. PQTMHOT Performs a hot start. Type: Command Synopsis: $PQTMHOT* Parameter: None Result: Hot start initialization and GNSS engine restart. Example: $PQTMHOT*4B 2.3.4. PQTMSRR Resets a system. The GNSS firmware will be rebooted. Type: Command Synopsis: $PQTMSRR* LC79D(C)_GNSS_Protocol_Specification GNSS Module Series 21 / 42 Parameter: None Result: The GNSS firmware is rebooted and no message is sent as a reply. Example: $PQTMSRR*4B GNSS Module Series 2.3.5. PQTMSETGLP Enables/disables GNSS Low Power (GLP) mode. GLP is the best power-saving mode for acquisition and tracking. It helps the module to achieve a balance between performance and power consumption according to the signal strength. Type: Set Synopsis: $PQTMSETGLP,* Parameter: Field Format Unit Numeric - Description GLP mode: 0 = Disable GLP mode (default) 1 = Enable GLP mode Result: ⚫ If successful, the module returns: $PQTMSETGLPOK*05 ⚫ If failed, the module returns: $PQTMSETGLPERROR*59 Example: $PQTMSETGLP,1*1C $PQTMSETGLPOK*05 LC79D(C)_GNSS_Protocol_Specification 22 / 42 GNSS Module Series NOTE The GNSS engine will be restarted if this command is executed successfully. 2.3.6. PQTMGETGLP Gets the status of GLP mode. Type: Get Synopsis: $PQTMGETGLP* Parameter: None Result: ⚫ If successful, the module returns: $PQTMGLP,* The parameter included in the result above is listed below: Field Format Unit Numeric - Description GLP mode status: 0 = Disable GLP mode (default) 1 = Enable GLP mode ⚫ If failed, the module returns: $PQTMGETGLPERROR*4D Example: $PQTMGETGLP*15 $PQTMGLP,1*5E LC79D(C)_GNSS_Protocol_Specification 23 / 42 2.3.7. PQTMSETBAUD Configures NMEA port baud rate. Type: Set Synopsis: $PQTMSETBAUD,* Parameter: Field Format Unit Numeric bps Result: ⚫ If successful, the module returns: $PQTMSETBAUDOK*4C ⚫ If failed, the module returns: $PQTMSETBAUDERROR*10 Example: $PQTMSETBAUD,115200*63 $PQTMSETBAUDOK*4C 2.3.8. PQTMSETCNST Configures the GNSS constellation mask. Type: Set Synopsis: $PQTMSETCNST,* GNSS Module Series Description Supported baud rates: 115200 (default) 230400 460800 921600 LC79D(C)_GNSS_Protocol_Specification 24 / 42 GNSS Module Series Parameter: Field Format Unit Numeric - Result: ⚫ If successful, the module returns: $PQTMSETCNSTOK*54 ⚫ If failed, the module returns: $PQTMSETCNSTERROR*08 Example: $PQTMSETCNST,63*79 $PQTMSETCNSTOK*54 Description It is a bit mask where each bit enables (1 = enable) or disables (0 = disable) a specific constellation independently: bit 0: Enable/disable GPS constellation bit 1: Enable/disable GLONASS constellation bit 2: Enable/disable Galileo constellation bit 3: Enable/disable BDS constellation bit 4: Enable/disable NavIC constellation bit 5: Enable/disable QZSS constellation NOTE The GNSS engine will be restarted if the command is executed successfully. 2.3.9. PQTMGETCNST Gets the information of GNSS constellation mask. Type: Get Synopsis: $PQTMGETCNST* Parameter: None LC79D(C)_GNSS_Protocol_Specification 25 / 42 GNSS Module Series Result: ⚫ If successful, the module returns: $PQTMCNST,* The parameter included in the result above is listed below: Field Format Numeric Unit Description It is a bit mask where each bit enables (1 = enable) or disables (0 = disable) a specific constellation independently: bit 0: GPS constellation is enabled/disabled. - bit 1: GLONASS constellation is enabled/disabled. bit 2: Galileo constellation is enabled/disabled. bit 3: BDS constellation is enabled/disabled. bit 4: NAVIC constellation is enabled/disabled. bit 5: QZSS constellation is enabled/disabled. ⚫ If failed, the module returns: $PQTMGETCNSTERROR*1C Example: $PQTMGETCNST*44 $PQTMCNST,63*3B 2.3.10. PQTMSETL5BIAS Configures the L5 bias value. This value is used for correcting the L5 delay, and it can be acquired by connecting the module to QGNSS tool in open sky environment. Type: Set Synopsis: $PQTMSETL5BIAS,* Parameter: Field Format Unit Numeric - Description L5 bias value. LC79D(C)_GNSS_Protocol_Specification 26 / 42 Result: ⚫ If successful, the module returns: $PQTMSETL5BIASOK*3E ⚫ If failed, the module returns: $PQTMSETL5BIASERROR*62 Example: $PQTMSETL5BIAS,14.6*0B $PQTMSETL5BIASOK*3E $PQTMSAVEPAR*5A $PQTMSAVEPAROK*5E GNSS Module Series NOTE The configuration takes effect after rebooting, and it must be saved by $PQTMSAVEPAR (see Chapter 2.3.24 for details) before rebooting. 2.3.11. PQTMGETL5BIAS Gets the current L5 bias value. Type: Get Synopsis: $PQTMGETL5BIAS* Parameter: None Result: ⚫ If successful, the module returns: $PQTML5BIAS,* LC79D(C)_GNSS_Protocol_Specification 27 / 42 The parameter included in the result above is listed below: Field Format Unit Description Numeric - L5 bias value. ⚫ If failed, the module returns: $PQTMGETL5BIASERROR*76 Example: $PQTMGETL5BIAS*2E $PQTML5BIAS,14.600000*79 GNSS Module Series 2.3.12. PQTMCFGODO Sets or gets odometer configurations. Type: Set/Get Synopsis: $PQTMCFGODO,,,,* Parameter: Field Format Numeric, 1 digit Numeric, 1 digit Numeric, 1 digit Numeric Unit Description Read or write odometer configurations. - 0 = Read odometer configurations 1 = Configure odometer Enable or disable odometer to start automatically. - 0 = Disable (default) 1 = Enable Message report mode. - 0 = Do not output odometer message periodically 1 = Output odometer message periodically (default) - Odometer initial value. Default value: 0. Result: ⚫ If successful, the module returns: $PQTMCFGODOOK*1A LC79D(C)_GNSS_Protocol_Specification 28 / 42 ⚫ If failed, the module returns: $PQTMCFGODOERROR*46 Example: $PQTMCFGODO,1,0,1,0*1E $PQTMCFGODOOK*1A GNSS Module Series 2.3.13. PQTMREQODO Requests the current odometer configuration information. Type: Query Synopsis: $PQTMREQODO* Parameter: None Result: ⚫ If successful, the module returns: $PQTMODO,* The parameter included in the result above is listed below: Field Format Unit Description Numeric - The current odometer value. ⚫ If failed, the module returns: $PQTMREQODOERROR*42 Example: $PQTMREQODO*1A $PQTMODO,0.0*5E LC79D(C)_GNSS_Protocol_Specification 29 / 42 2.3.14. PQTMRESETODO Resets odometer. This command will clear the current odometer value. Type: Command Synopsis: $PQTMRESETODO* Parameter: None Result: ⚫ If successful, the module returns: $PQTMRESETODOOK*0D ⚫ If failed, the module returns: $PQTMRESETODOERROR*51 Example: $PQTMRESETODO*09 $PQTMRESETODOOK*0D 2.3.15. PQTMSTARTODO Starts odometer. Type: Command Synopsis: $PQTMSTARTODO* Parameter: None GNSS Module Series LC79D(C)_GNSS_Protocol_Specification 30 / 42 Result: ⚫ If successful, the module returns: $PQTMSTARTODOOK*18 ⚫ If failed, the module returns: $PQTMSTARTODOERROR*44 Example: $PQTMSTARTODO*1C $PQTMSTARTODOOK*18 2.3.16. PQTMSTOPODO Stops odometer. Type: Command Synopsis: $PQTMSTOPODO* Parameter: None Result: ⚫ If successful, the module returns: $PQTMSTOPODOOK*40 ⚫ If failed, the module returns: $PQTMSTOPODOERROR*1C Example: $PQTMSTOPODO*44 $PQTMSTOPODOOK*40 LC79D(C)_GNSS_Protocol_Specification GNSS Module Series 31 / 42 GNSS Module Series 2.3.17. PQTMCFGGEOFENCE Sets or gets geofence configurations. Type: Set/Get Synopsis: $PQTMCFGGEOFENCE,,,,,,,{,,,,,}* Parameter: Field Format Unit Numeric, 1 digit - Numeric, 1 digit - Numeric, 1 digit - Numeric, 1 digit - Float - Description Read or write geofence configurations. 0 = Read geofence configurations 1 = Configure geofence Geofence ID. Range: 0-2. Geofence message report mode. 0 = Do not report 1 = Report when entering the geo-fence 2 = Report when leaving the geo-fence 3 = Report when entering or leaving the geo-fence The shape of geofence. 0 = Circle with a radius 1 = Circle with one point on circle 2 = Triangle 3 = Quadrangle (such as square, rectangle trapezium, etc.) The latitude of the first point. Float Float Float - The longitude of the first point. If the geofence shape is a circle with a certain radius, this - value will be the radius of the circle, otherwise this value will be the latitude of the second point. - The longitude of the second point. Float - The latitude of the third point. Float - The longitude of the third point. Float - The latitude of the fourth point. LC79D(C)_GNSS_Protocol_Specification 32 / 42 GNSS Module Series Float - The longitude of the fourth point. Result: ⚫ If successful, the module returns: $PQTMCFGGEOFENCEOK*58 ⚫ If failed, the module returns: $PQTMCFGGEOFENCEERROR*04 Example: //If the geofence shape is a circle with a radius: $PQTMCFGGEOFENCE,1,0,3,0,31.5863,117.5686,2000*40 $PQTMCFGGEOFENCEOK*58 //If the geofence shape is circle with one point on circle: $PQTMCFGGEOFENCE,1,0,3,1,31.5863,117.5686,36.5548,118.4523*5E $PQTMCFGGEOFENCEOK*58 2.3.18. PQTMSETGEOFENCE Enables/disables geofence. Type: Set Synopsis: $PQTMSETGEOFENCE,* Parameter: Field Format Numeric, 1 digit Unit Description Enable or disable geofence. - 0 = Disable geofence (default) 1 = Enable geofence Result: ⚫ If successful, the module returns: $PQTMSETGEOFENCEOK*58 LC79D(C)_GNSS_Protocol_Specification 33 / 42 ⚫ If failed, the module returns: $PQTMSETGEOFENCEERROR*04 Example: $PQTMSETGEOFENCE,0*40 $PQTMSETGEOFENCEOK*58 GNSS Module Series 2.3.19. PQTMGETGEOFENCE Gets the status of geofence. Type: Get Synopsis: $PQTMGETGEOFENCE* Parameter: None Result: ⚫ If successful, the module returns: $PQTMGEOFENCE,* The parameter included in the result above are listed below: Field Format Numeric, 1 digit Unit Description The status of geofence. - 0 = Geofence is disabled (default). 1 = Geofence is enabled. ⚫ If failed, the module returns: $PQTMGETGEOFENCEERROR*10 Example: $PQTMGETGEOFENCE*48 $PQTMGEOFENCE,0*02 LC79D(C)_GNSS_Protocol_Specification 34 / 42 GNSS Module Series 2.3.20. PQTMREQGEOFENCE Requests if the current position is inside or outside the geofence. Type: Query Synopsis: $PQTMREQGEOFENCE,* Parameter: Field Format Unit Numeric, 1 digit - Description Geofence ID. Range: 0-2. Result: ⚫ If successful, the module returns: $PQTMGEOFENCESTATUS,,* The parameters included in the result above are listed below: Field Format Unit Description Numeric, 1 digit - Numeric, 1 digit Geofence ID. Range: 0-2. If the current position is inside or outside the geofence: 0 = Unknow 1 = Inside 2 = Outside ⚫ If failed, the module returns: $PQTMREQGEOFENCEERROR*00 Example: $PQTMREQGEOFENCE,0*44 $PQTMGEOFENCESTATUS,0,0*0A LC79D(C)_GNSS_Protocol_Specification 35 / 42 GNSS Module Series 2.3.21. PQTMCFGNMEAMSG Sets or gets the type of output NMEA messages. Type: Set/Get Synopsis: $PQTMCFGNMEAMSG,,,,,,,* Parameter: Field Format Unit Numeric, 1 digit - Numeric, 1 digit Numeric, 1 digit Numeric, 1 digit Numeric, 1 digit Numeric, 1 digit Numeric, 1 digit - Description Read or write NMEA message configurations. 0 = Read NMEA message configurations 1 = Configure NMEA message 0 = Disable GGA messages 1 = Enable GGA messages 0 = Disable RMC messages 1 = Enable RMC messages 0 = Disable GSV messages 1 = Enable GSV messages 0 = Disable GSA messages 1 = Enable GSA messages 0 = Disable GLL messages 1 = Enable GLL messages 0 = Disable VTG messages 1 = Enable VTG messages Result: ⚫ If successful, the module returns: $PQTMCFGNMEAMSGOK*00 ⚫ If failed, the module returns: $PQTMCFGNMEAMSGERROR*5C Example: $PQTMCFGNMEAMSG,1,1,1,1,1,1,1*19 $PQTMCFGNMEAMSGOK*00 LC79D(C)_GNSS_Protocol_Specification 36 / 42 GNSS Module Series 2.3.22. PQTMCFGEAMASK Sets or gets estimate accuracy. This function is used to change TTFF (negative correlation). Type: Set/Get Synopsis: $PQTMCFGEAMASK,,* Parameter: Field Format Numeric, 1 digit Numeric, 3 digits Unit Description Set or get EA_Mask value. - 0 = Get EA_Mask value 1 = Set EA_Mask value EA_Mask (estimate accuracy) is negatively correlated m with TTFF Range: 50–400 (default value: 100) Result: ⚫ If successful, the module returns: $PQTMCFGEAMASKOK*4E ⚫ If failed, the module returns: $PQTMCFGEAMASKERROR*12 Example: $PQTMCFGEAMASK,1,200*49 $PQTMCFGEAMASKOK*4E 2.3.23. PQTMCFGCLAMPING Sets or gets clamping function status. If the actual speed is very slow, output position remains the same and the output speed will be zero. Type: Set/Get LC79D(C)_GNSS_Protocol_Specification 37 / 42 GNSS Module Series Synopsis: $PQTMCFGCLAMPING,,* Parameter: Field Format Unit Numeric, 1 digit - Numeric, 1 digit - Description Set or get clamping function status. 0 = Get clamping function status 1 = Set clamping function status Enable/disable clamping function 0 = Disable (default) 1 = Enable Result: ⚫ If successful, the module returns: $PQTMCFGCLAMPINGOK*4D ⚫ If failed, the module returns: $PQTMCFGCLAMPINGERROR*11 Example: $PQTMCFGCLAMPING,1,1*49 $PQTMCFGCLAMPINGOK*4D 2.3.24. PQTMSAVEPAR Saves configurations of GNSS commands into NVM. Type: Command Synopsis: $PQTMSAVEPAR* Parameter: None LC79D(C)_GNSS_Protocol_Specification 38 / 42 Result: ⚫ If successful, the module returns: $PQTMSAVEPAROK*5E ⚫ If failed, the module returns: $PQTMSAVEPARERROR*02 Example: $PQTMSAVEPAR*5A $PQTMSAVEPAROK*5E 2.3.25. PQTMRESTOREPAR Restores all configurations to default values. Type: Command Synopsis: $PQTMRESTOREPAR* Parameter: None Result: ⚫ If successful, the module returns: $PQTMRESTOREPAROK*17 ⚫ If failed, the module returns: $PQTMRESTOREPARERROR*4B Example: $PQTMRESTOREPAR*13 $PQTMRESTOREPAROK*17 LC79D(C)_GNSS_Protocol_Specification GNSS Module Series 39 / 42 GNSS Module Series 3 Appendix A References Table 3: Terms and Abbreviations Abbreviation 2D 3D BDS C/N0 COG COGM COGT DOP Galileo GGA GLL GLONASS GLP GNSS GPS GSA GSV HDOP IRNSS Description 2 Dimension 3 Dimension BDS Navigation Satellite System Carrier-to-Noise-Density Ratio Course over Ground Course over Ground (in Magnetic North Course Direction) Course over Ground (in True North Course Direction) Dilution of Precision Galileo Satellite Navigation System (EU) Global Positioning System Fix Data Geographic Position - Latitude and Longitude Global Navigation Satellite System (Russian) GNSS Low Power Global Navigation Satellite System Global Positioning System GNSS DOP and Active Satellites GNSS Satellites in View Horizontal Dilution of Precision Indian Regional Navigation Satellite System LC79D(C)_GNSS_Protocol_Specification 40 / 42 NavIC NMEA NVM PDOP PPS QZSS RMC SNR SOG SPS TTFF UTC VDOP VTG GNSS Module Series Navigation with Indian Constellation National Marine Electronics Association Non-Volatile Memory Position Dilution of Precision Pulse Per Second Quasi-Zenith Satellite System Recommended Minimum Specific GNSS Data Signal to Noise Ratio Speed over Ground Standard Positioning Service Time to First Fix Universal Time Coordinated Vertical Dilution of Precision Course Over Ground & Ground Speed LC79D(C)_GNSS_Protocol_Specification 41 / 42 GNSS Module Series 4 Appendix B GNSS Numbering Table 4: GNSS Numbering GNSS Type System ID Satellite ID GPS 1 1–32 GLONASS 2 65–96 Galileo 3 101–136 BDS 4 201–236 QZSS 5 1–10 NavIC (IRNSS) 6 1–15 Signal ID 1 = L1 C/A 8 = L5-Q 1 = L1 C/A 1 = E5a 6 = E1 1 = B1I 1 = L1 C/A 8 = L5-Q 1 = L5-SPS LC79D(C)_GNSS_Protocol_Specification 42 / 42

MC20&MC30 GNSS Protocol Specification GSM/GPRS/GNSS Module Series Rev. MC20&MC30_GNSS_Protocol_Specification_V1.2 Date: 2018-08-29 Status: Released www.quectel.com GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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 MC20&MC30_GNSS_Protocol_Specification 1 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification About the Document History Revision Date 1.0 2016-07-22 Author Ziv LIAO 1.1 2017-08-24 Simon HU 1.2 2018-08-29 Simon HU Description Initial 1. Added the following new AT commands: AT+QGNSSTS/AT+QGNSSEPO/AT+QGREFLOC/ AT+QGEPOAID/AT+QGEPOF. 2. Added the following new PMTK commands: PMTK285/PMTK306/PMTK308/PMTK458/ PMTK461/PMTK607/PMTK707. 3. Added the following new SDK commands: 4. PQBAUD/PQECEF/PQODO/PQPZ90/PQVEL/ PQJAM/PQRLM/PQGEO. 5. Modified description of GSA/GSV/PMTK161/ PMTK225/PMTK353/PMTK886/PQEPE/PQGLP. 1. Added MC30 as the applicable module of the document. 2. Updated the longitude format in RMC and GGA messages. (Chapter 2.1 and 2.3) 3. Updated the description of parameter , example, and added notes for AT+QGNSSRD. (Chapter 3.2) 4. Updated notes for AT+QGNSSCMD and AT+QGNSSTS. (Chapter 3.3 and 3.4) 5. Added the value 2 of parameter , notes and example for AT+QGNSSEPO. (Chapter 3.5) 6. Added example for AT+QGREFLOC. (Chapter 3.6) 7. Updated the notes and added example for AT+QGEPOAID. (Chapter 3.7) 8. Added example for AT+QGEPOF. (Chapter 3.8) MC20&MC30_GNSS_Protocol_Specification 2 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 5 1 Introduction ....................................................................................................................................... 6 1.1. Differences between Two Application Modes .......................................................................... 6 2 Standard NMEA Packet Protocol ..................................................................................................... 8 2.1. --RMC ..................................................................................................................................... 8 2.2. --VTG ...................................................................................................................................... 9 2.3. --GGA.................................................................................................................................... 10 2.4. --GSA .....................................................................................................................................11 2.5. --GSV .................................................................................................................................... 13 2.6. --GLL..................................................................................................................................... 14 3 GNSS AT Commands...................................................................................................................... 16 3.1. AT+QGNSSC GNSS Module Power Control ...................................................................... 16 3.2. AT+QGNSSRD Read GNSS Navigation Information ......................................................... 17 3.3. AT+QGNSSCMD Send Commands to GNSS Module ....................................................... 19 3.4. AT+QGNSSTS Get Time Synchronization Status for GNSS Module.................................. 20 3.5. AT+QGNSSEPO Enable/Disable EPOTM Function............................................................. 21 3.6. AT+QGREFLOC Set Reference Location Information for QuecFastFix Online .................. 23 3.7. AT+QGEPOAID Trigger EPOTM Function ........................................................................... 24 3.8. AT+QGEPOF EPOTM File Operation .................................................................................. 25 4 MTK NMEA Packet Protocol........................................................................................................... 28 4.1. Packet Type: 010 PMTK_SYS_MSG .................................................................................... 28 4.2. Packet Type: 011 PMTK_TXT_MSG ..................................................................................... 29 4.3. Packet Type: 001 PMTK_ACK .............................................................................................. 29 4.4. Packet Type: 101 PMTK_CMD_HOT_START ...................................................................... 30 4.5. Packet Type: 102 PMTK_CMD_WARM_START ................................................................... 31 4.6. Packet Type: 103 PMTK_CMD_COLD_START .................................................................... 31 4.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START ......................................................... 32 4.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE .............................................................. 33 4.9. Packet Type: 183 PMTK_LOCUS_QUERY_STATUS ........................................................... 33 4.10. Packet Type: 184 PMTK_LOCUS_ERASE_FLASH.............................................................. 35 4.11. Packet Type: 185 PMTK_LOCUS_STOP_LOGGER ............................................................ 35 4.12. Packet Type: 220 PMTK_SET_POS_FIX ............................................................................. 36 4.13. Packet Type: 223 PMTK_SET_AL_DEE_CFG ..................................................................... 37 4.14. Packet Type: 225 PMTK_SET_PERIODIC_MODE............................................................... 37 4.15. Packet Type: 256 PMTK_SET_TIMING_PRODUCT ............................................................ 38 4.16. Packet Type: 285 PMTK_SET_PPS_CONFIG ..................................................................... 39 4.17. Packet Type: 286 PMTK_SET_AIC_ENABLED .................................................................... 40 MC20&MC30_GNSS_Protocol_Specification 3 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.18. 4.19. 4.20. 4.21. 4.22. 4.23. 4.24. 4.25. 4.26. 4.27. 4.28. 4.29. 4.30. 4.31. 4.32. 4.33. 4.34. 4.35. 4.36. 4.37. 4.38. 4.39. 4.40. 4.41. 4.42. 4.43. 4.44. 4.45. 4.46. Packet Type: 301 PMTK_API_SET_DGPS_MODE .............................................................. 40 Packet Type: 306 PMTK_API_SET_MIN_SNR..................................................................... 41 Packet Type: 308 PMTK_API_SET_DR_LIMIT .................................................................... 42 Packet Type: 311 PMTK_API_SET_ELEV_MASK ................................................................ 42 Packet Type: 313 PMTK_API_SET_SBAS_ENABLED......................................................... 43 Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT .......................................................... 44 Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA............................................ 46 Packet Type: 352 PMTK_API_SET_STOP_QZSS ............................................................... 47 Packet Type: 353 PMTK_API_SET_GNSS_SEARCH_MODE ............................................. 47 Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD ...................................................... 48 Packet Type: 400 PMTK_API_Q_FIX_CTL........................................................................... 49 Packet Type: 401 PMTK_API_Q_DGPS_MODE .................................................................. 50 Packet Type: 413 PMTK_API_Q_SBAS_ENABLED............................................................. 50 Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT .............................................................. 51 Packet Type: 458 PMTK_API_GET_POS_XYZ .................................................................... 51 Packet Type: 461 PMTK_API_GET_VEL_XYZ..................................................................... 52 Packet Type: 500 PMTK_DT_FIX_CTL ................................................................................ 53 Packet Type: 501 PMTK_DT_DGPS_MODE ........................................................................ 53 Packet Type: 513 PMTK_DT_SBAS_ENABLED .................................................................. 54 Packet Type: 514 PMTK_DT_NMEA_OUTPUT.................................................................... 55 Packet Type: 605 PMTK_Q_RELEASE ................................................................................ 56 Packet Type: 607 PMTK_Q_EPO_INFO............................................................................... 56 Packet Type: 622 PMTK_Q_LOCUS_DATA ......................................................................... 57 Packet Type: 705 PMTK_DT_RELEASE .............................................................................. 58 Packet Type: 707 PMTK_DT_EPO_INFO............................................................................. 58 Packet Type: 838 PMTK_TEST_ANTI_SPOOFING ............................................................. 59 Packet Type: 869 PMTK_EASY_ENABLE ............................................................................ 60 Packet Type: 875 PMTK_PMTKLSC_STN_OUTPUT ........................................................... 61 Packet Type: 886 PMTK_FR_MODE .................................................................................... 62 5 SDK NMEA Packet Protocol ........................................................................................................... 64 5.1. PQBAUD Change NMEA Port Default Baud Rate .............................................................. 64 5.2. PQEPE Enable/Disable PQEPE Sentence Output ............................................................. 65 5.3. PQECEF Enable/Disable ECEFPOSVEL Sentence Output ............................................... 66 5.4. PQODO Start/Stop Odometer Reading .............................................................................. 67 5.5. PQPZ90 Enable/Disable Switching from WGS84 to PZ-90.11 ........................................... 68 5.6. PQGLP Set the Module into GLP Mode ............................................................................. 69 5.7. PQVEL Enable/Disable 3 Ways Velocity Sentence Output................................................. 70 5.8. PQJAM Enable/Disable Jamming Detection Function........................................................ 71 5.9. PQRLM Enable/Disable Return Link Message Output ....................................................... 72 5.10. PQGEO Configure Parameters of Geo-fence..................................................................... 73 6 Default Configurations.................................................................................................................... 78 7 Appendix A References .................................................................................................................. 79 MC20&MC30_GNSS_Protocol_Specification 4 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Table Index TABLE 1: DIFFERENCES BETWEEN ALL-IN-ONE SOLUTION AND STAND-ALONE SOLUTION ................. 7 TABLE 2: OVERVIEW OF GNSS AT COMMANDS FOR MC20&MC30 ........................................................... 16 TABLE 3: DEFAULT CONFIGURATIONS ......................................................................................................... 78 TABLE 4: RELATED DOCUMENTS .................................................................................................................. 79 TABLE 5: TERMS AND ABBREVIATIONS ........................................................................................................ 79 TABLE 6: STRUCTURE OF NMEA MESSAGE ................................................................................................ 80 TABLE 7: STRUCTURE OF MTK NMEA PACKET ........................................................................................... 81 TABLE 8: DATUM SENTENCE DEFINITION .................................................................................................... 81 TABLE 9: TALKER ID DISPLAY IN DIFFERENT GNSS SYSTEM (FOR NMEA 0183 3.01 VERSION) .......... 82 MC20&MC30_GNSS_Protocol_Specification 5 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 1 Introduction MC20&MC30 are multi-purpose modules which integrate a high performance GNSS engine and a quad-band GSM/GPRS engine. The GNSS engine is a single receiver integrating GPS and BeiDou systems. It supports multiple positioning and navigation systems including autonomous GPS, BeiDou, SBAS (including WAAS, EGNOS, MSAS and GAGAN), and QZSS. With the embedded GNSS function, MC20&MC30 can help customers get accurate coordinates, high-precision time, etc., and thus is ideal for use in wearable devices, vehicle and personnel tracking, and more fields. This document describes the software aspects of MC20&MC30 modules. It supports NMEA 0183 standard commands, and also can be controlled and configured via MTK NMEA extended packet. The document is applicable to the following modules:  MC20 module which includes the following variants: a) OC: MC20CA-04-STD (supports BT3.0) b) OC: MC20ECA-04-BLE (supports BT4.0) c) OC: MC20CA-04-TTS (supports text-to-speech)  MC30 module (supports GNSS+Cell ID+Wi-Fi hybrid positioning) 1.1. Differences between Two Application Modes The internal GSM and GNSS engines of MC20/MC30 can work as a whole unit (All-in-one solution) or work relatively independently (Stand-alone solution) according to customers’ demands. In All-in-one solution, MC20/MC30 works as a whole unit. The GNSS part can be regarded as a peripheral of the GSM part. This allows for convenient communication between GSM and GNSS parts, such as AT command sending for GNSS control, GNSS part firmware upgrading, and EPO data download. In Stand-alone solution, GSM and GNSS parts work independently, and thus have to be controlled separately. When working in All-in-one or Stand-alone solution, there are some differences for MC20/MC30 to acquire NMEA output data, or send PMTK/SDK command. The details are listed below. MC20&MC30_GNSS_Protocol_Specification 6 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Table 1: Differences between All-in-one Solution and Stand-alone Solution Item All-in-one Acquire via sending AT+QGNSSRD NMEA Output Data Acquisition command PMTK Command Sending Send via AT+QGNSSCMD command SDK Command Sending Send via AT+QGNSSCMD command Stand-alone Acquire directly Send directly Send directly NOTE AT commands are effective only when the module is in All-in-one solution. MC20&MC30_GNSS_Protocol_Specification 7 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 2 Standard NMEA Packet Protocol MC20&MC30 support standard NMEA 0183 messages, and the following tables show the structure of these messages. 2.1. --RMC RMC-Recommended Minimum Position Data (including position, velocity and time). Example: $GPRMC,015606.000,A,3150.7584,N,11712.0491,E,0.00,231.36,280715,,,A*67 $GNRMC,084629.000,A,3150.7822,N,11711.9323,E,0.00,119.00,240715,,,D*7C $BDRMC,020547.000,A,3150.7813,N,11711.9212,E,0.37,229.71,280715,,,A*7C Field Description $ Each NMEA message starts with ‘$’ --RMC Message ID UTC Time Data Valid Latitude N/S Longitude E/W Speed Time in format ‘hhmmss.sss’ ‘V’=Invalid ‘A’=Valid Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmm’ (degrees and minutes) ‘E’=East ‘W’=West Speed over ground in knots COG Course over ground in degree Date Date in format ‘ddmmyy’ Magnetic Variation Magnetic variation in degree, not being output MC20&MC30_GNSS_Protocol_Specification 8 / 82 E/W Positioning Mode * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Magnetic variation E/W indicator, not being output ‘N’=No fix ‘A’=Autonomous GNSS fix ‘D’=Differential GNSS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 9. 2.2. --VTG VTG-Track Made Good and Ground Speed. Example: $GPVTG,227.15,T,,M,0.00,N,0.00,K,A*3E $GNVTG,19.11,T,,M,0.16,N,0.30,K,A*1F $BDVTG,229.71,T,,M,0.37,N,0.68,K,A*29 Field Description $ Each NMEA message starts with ‘$’ --VTG Message ID COG (T) Course over ground (true) in degree T Fixed field, true COG(M) Course over ground (magnetic), not being output M Fixed field, magnetic Speed Speed over ground in knots N Fixed field, knots Speed Speed over ground in km/h MC20&MC30_GNSS_Protocol_Specification 9 / 82 K Positioning Mode * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Fixed field, km/h ‘N’=No fix ‘A’=Autonomous GNSS fix ‘D’=Differential GNSS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 9. 2.3. --GGA GGA-Global Positioning System Fix Data, is the essential fix data which provides 3D location and accuracy data. Example: $GPGGA,015606.000,3150.7584,N,11712.0491,E,1,5,2.28,265.0,M,0.0,M,,*65 $GNGGA,083354.000,3150.7790,N,11711.9289,E,1,8,2.85,53.2,M,0.0,M,,*4B $BDGGA,020547.000,3150.7813,N,11711.9212,E,1,3,3.65,55.3,M,0.0,M,,*4C Field Description $ Each NMEA message starts with ‘$’ --GGA Message ID UTC Time Time in format ‘hhmmss.sss’ Latitude N/S Longitude E/W Fix Status Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmm’ (degrees and minutes) ‘E’=East ‘W’=West ‘0’=Invalid ‘1’=GNSS fix MC20&MC30_GNSS_Protocol_Specification 10 / 82 Number of SV HDOP Altitude M Geoid Separation M DGPS Age DGPS Station ID * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification ‘2’=DGPS fix ‘6’=Estimated (dead reckoning) Mode Number of satellites being used (0~26) Horizontal dilution of precision Altitude in meters according to WGS84 ellipsoid Fixed field, meter Height of Geoid (means sea level) above WGS84 ellipsoid, meter Fixed field, meter Age of DGPS data in seconds, empty if DGPS is not used DGPS station ID, empty if DGPS is not used End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 9. 2.4. --GSA GSA-GNSS DOP and Active Satellites, which provides details on the fix and includes the number of satellites being used in the current solution and the DOP. Example: $GPGSA,A,3,03,17,11,23,193,,,,,,,,3.72,2.85,2.39*3C $GNGSA,A,3,23,09,17,03,01,193,,,,,,,1.23,0.74,0.99*28 $GLGSA,A,3,68,66,82,67,81,,,,,,,,1.25,0.71,1.03*10 $GAGSA,A,3,07,,,,,,,,,,,,1.25,0.71,1.03*16 $BDGSA,A,2,10,11,07,,,,,,,,,,3.79,3.65,1.00*18 Field Description $ Each NMEA message starts with ‘$’ MC20&MC30_GNSS_Protocol_Specification 11 / 82 --GSA Mode Fix Status Satellite Used 1 Satellite Used 2 Satellite Used 3 Satellite Used 4 Satellite Used 5 Satellite Used 6 Satellite Used 7 Satellite Used 8 Satellite Used 9 Satellite Used 10 Satellite Used 11 Satellite Used 12 PDOP HDOP VDOP * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Message ID Auto selection of 2D or 3D fix ‘M’=Manual, forced to switch 2D/3D mode ‘A’=Allowed to automatically switch 2D/3D mode ‘1’=No fix ‘2’=2D fix ‘3’=3D fix Satellite used on channel 1 Satellite used on channel 2 Satellite used on channel 3 Satellite used on channel 4 Satellite used on channel 5 Satellite used on channel 6 Satellite used on channel 7 Satellite used on channel 8 Satellite used on channel 9 Satellite used on channel 10 Satellite used on channel 11 Satellite used on channel 12 Position dilution of precision Horizontal dilution of precision Vertical dilution of precision End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 9. MC20&MC30_GNSS_Protocol_Specification 12 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 2.5. --GSV GSV-GNSS Satellites in View. One GSV sentence can only provide data for at most 4 satellites, so several sentences might be required for full information. Since GSV includes satellites that are not used as part of the solution, GSV sentence contains more satellites than GGA does. Example: $GPGSV,3,1,11,193,69,099,30,17,62,354,36,06,47,272,,03,40,054,30*4E $GPGSV,3,2,11,02,13,255,,01,12,055,19,23,11,102,25,11,05,074,24*75 $GPGSV,3,3,11,24,03,303,,47,,,,32,,,21*4D $GLGSV,3,1,11,69,48,142,39,68,43,058,51,83,40,049,51,84,40,334,43*64 $GLGSV,3,2,11,74,30,271,15,73,17,218,19,75,13,324,30,70,07,184,*6E $GLGSV,3,3,11,85,06,296,34,82,02,092,21,67,02,023,*56 $BDGSV,2,1,06,08,63,015,30,11,59,350,32,12,39,081,26,14,29,184,21*68 $GAGSV,1,1,03,07,61,012,41,02,,,29,20,,,34*51 $BDGSV,2,2,06,13,07,295,,01,,,26*50 Field Description $ Each NMEA message starts with ‘$’ --GSV Number of Message Sequence Number Message ID Number of messages, total number of GPGSV messages being output (1~4) Sequence number of this entry (1~4) Satellites in View Total satellites in view Satellite ID 1 Satellite ID Elevation 1 Elevation in degree (0~90) Azimuth 1 Azimuth in degree (0~359) SNR 1 Signal to noise ration in dB-Hz (0~99), empty if not tracking Satellite ID 2 Satellite ID Elevation 2 Elevation in degree (0~90) Azimuth 2 Azimuth in degree (0~359) SNR 2 Signal to noise ration in dB-Hz (0~99), empty if not tracking Satellite ID 3 Satellite ID MC20&MC30_GNSS_Protocol_Specification 13 / 82 Elevation 3 Azimuth 3 SNR 3 Satellite ID 4 Elevation 4 Azimuth 4 SNR 4 * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Elevation in degree (0~90) Azimuth in degree (0~359) Signal to noise ration in dB-Hz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to noise ration in dB-Hz (0~99), empty if not tracking End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 9. 2.6. --GLL GLL-Geographic Latitude and Longitude, which contains position information, time of position fix and status. Example: $GPGLL,3150.7584,N,11712.0491,E,015606.000,A,A*5C $GNGLL,3150.7790,N,11711.9289,E,083354.000,A,A*4D $BDGLL,3150.7813,N,11711.9212,E,020547.000,A,A*49 Field Description $ Each NMEA message starts with ‘$’ --GLL Message ID Latitude N/S Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North ‘S’=South MC20&MC30_GNSS_Protocol_Specification 14 / 82 Longitude E/W UTC Time Data Valid Positioning Mode * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Longitude in format ‘dddmm.mmmm’ (degrees and minutes) ‘E’=East ‘W’=West Time in format ‘hhmmss.sss’ ‘V’=Invalid ‘A’=Valid ‘N’=No fix ‘A’=Autonomous GNSS fix ‘D’=Differential GNSS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 9. MC20&MC30_GNSS_Protocol_Specification 15 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 3 GNSS AT Commands The commands below are used to control or configure the internal GNSS engine of MC20&MC30. These commands are effective only in All-in-one solution. Table 2: Overview of GNSS AT Commands for MC20&MC30 Command AT+QGNSSC AT+QGNSSRD AT+QGNSSCMD AT+QGNSSTS AT+QGNSSEPO AT+QGREFLOC AT+QGEPOAID AT+QGEPOF Description GNSS module power control Read GNSS navigation information Send commands to GNSS module Get Time Synchronization Status for GNSS Module Enable/Disable EPOTM Function Set Reference Location Information for QuecFastFix Online Trigger EPOTM Function EPOTM File Operation 3.1. AT+QGNSSC GNSS Module Power Control The command is used to control the power supply of GNSS module. AT+QGNSSC GNSS Module Power Control Test Command AT+QGNSSC=? Response +QGNSSC: (list of supported s) Read Command AT+QGNSSC? OK Response +QGNSSC: MC20&MC30_GNSS_Protocol_Specification 16 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Write Command AT+QGNSSC= OK Response OK If there is any error, response: +CME ERROR: Parameter 0 Power off GNSS module 1 Power on GNSS module NOTE In Stand-alone solution, the power supply of GNSS is controlled by an external circuit rather than GPS_VCC_EN pin. In such case, AT+QGNSSC command cannot be used and thus can be ignored. Example AT+QGNSSC? +QGNSSC: 0 OK AT+QGNSSC=1 OK //Query GNSS power status //GNSS powered off //Power on GNSS 3.2. AT+QGNSSRD Read GNSS Navigation Information The command is used to read the GNSS navigation information. AT+QGNSSRD Read GNSS Navigation Information Test Command AT+QGNSSRD=? Response +QGNSSRD: (list of supported s) Read Command AT+QGNSSRD? OK Response +QGNSSRD: (information of all supported s) OK MC20&MC30_GNSS_Protocol_Specification 17 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Write Command AT+QGNSSRD= Response +QGNSSRD: (information of ) OK If there is any error, response: +CME ERROR: Parameter 'NMEA/GGA': Get GGA sentence 'NMEA/GLL': Get GLL sentence 'NMEA/GSA': Get GSA sentence 'NMEA/GSV': Get GSV sentence 'NMEA/RMC': Get RMC sentence 'NMEA/VTG': Get VTG sentence 'NMEA/EPE': Get PQEPE URC 'NMEA/ECEF': Get PQECEF URC 'NMEA/PZ90': Get PQPZ90 URC 'NMEA/VEL': Get PQVEL URC 'NMEA/GEO': Get PQGEO URC 'NMEA/JAM': Get PQJAM URC 'NMEA/RLM': Get PQRLM URC NOTES 1. The command can only be executed 3 seconds after GNSS is powered on, otherwise +CME ERROR: 7103 will be returned. 2. For more details about the URCs, please refer to Chapter 5. Example AT+QGNSSRD? //Query GNSS NMEA sentence +QGNSSRD: $GNRMC,034035.000,A,3150.8617,N,11711.9038,E,3.02,183.45,240516,,,A*75 $GNVTG,183.45,T,,M,3.02,N,5.59,K,A*20 $GNGGA,034035.000,3150.8617,N,11711.9038,E,1,4,1.50,40.9,M,0.0,M,,*44 $GPGSA,A,3,26,21,,,,,,,,,,,1.75,1.50,0.91*0A $GLGSA,A,3,82,70,,,,,,,,,,,1.75,1.50,0.91*1C $GPGSV,3,1,12,16,67,308,,26,58,021,16,23,40,307,,31,40,088,*7F $GPGSV,3,2,12,08,17,199,,09,14,320,,21,10,086,14,14,10,153,*73 $GPGSV,3,3,12,22,09,226,,193,06,165,,32,03,154,,29,01,034,*45 $GLGSV,3,1,09,81,44,073,,79,40,041,,82,38,145,15,80,36,323,*66 $GLGSV,3,2,09,70,30,290,16,69,26,225,,78,12,078,,88,09,027,*64 $GLGSV,3,3,09,71,05,334,*5B MC20&MC30_GNSS_Protocol_Specification 18 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification $GNGLL,3150.8617,N,11711.9038,E,034035.000,A,A*4C OK AT+QGNSSRD='NMEA/RMC' //Query RMC information +QGNSSRD: $GNRMC,034036.000,A,3150.8612,N,11711.9045,E,2.74,178.00,240516,,,A*7C OK AT+QGNSSRD='NMEA/GSA' //Query GSA information +QGNSSRD: $GPGSA,A,3,26,21,,,,,,,,,,,1.76,1.50,0.91*09 OK 3.3. AT+QGNSSCMD Send Commands to GNSS Module The command is used to send commands to GNSS module, which allows customers to optionally use some functions to meet application demands. AT+QGNSSCMD Send Commands to GNSS Module Test Command AT+QGNSSCMD=? Response +QGNSSCMD: (0,1),'cmdString' Write Command AT+QGNSSCMD=, OK Response OK If there is any error, response: +CME ERROR: Parameter 0 NMEA style command 1 Hex style command Command string NOTES 1. Currently only =0 is supported. 2. The command can only be executed 3 seconds after GNSS is powered on, otherwise it will not be able to reach GNSS. MC20&MC30_GNSS_Protocol_Specification 19 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Example AT+QGNSSCMD=0,'$PMTK605*31' OK //Query GNSS version information +QGNSSCMD: $PMTK705,AXN_5.10_3333_17062100,0001,MC20-GNSS,1.0*27 3.4. AT+QGNSSTS Get Time Synchronization Status for GNSS Module The command is used to get time synchronization status for GNSS module, and the time plays a very important role in EPOTM function. AT+QGNSSTS Get Time Synchronization Status for GNSS Module Test Command AT+QGNSSTS=? Response +QGNSSTS: Read Command AT+QGNSSTS? OK Response +QGNSSTS: OK Parameter 0 Time is not synchronized 1 Time is synchronized successfully NOTES 1. Exact time is very important to EPOTM function. So customers must ensure the time is valid before using EPOTM function. 2. The time synchronization status queried by AT+QGNSSTS? will be updated in either of the following cases:  The time is synchronized via NITZ.  GNSS gets fixed in All-in-one solution. Example AT+QGNSSTS=? +QGNSSTS: (0,1) //Test command MC20&MC30_GNSS_Protocol_Specification 20 / 82 OK AT+QGNSSTS? +QGNSSTS: 1 OK GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification //Read time synchronization status //Time is synchronized successfully 3.5. AT+QGNSSEPO Enable/Disable EPOTM Function The command is used to enable or disable EPOTM function. AT+QGNSSEPO Enable/Disable EPOTM Function Test Command AT+QGNSSEPO=? Response +QGNSSEPO: (list of supported s) Read Command AT+QGNSSEPO? OK Response +QGNSSEPO: , Write Command When =0 or 1, AT+QGNSSEPO=[,< account_id>] When =2, AT+QGNSSEPO=,[,] OK Response OK If there is any error, response: +CME ERROR: Parameter 0 Disable EPOTM function 1 Enable EPOTM function 2 Configure the EPO server address and port 2 Set account ID for EPOTM function String type. EPO server address. It could be domain name or IP address. 1-65535. Integer type. EPO server port. The default value is 80 when it is omitted. MC20&MC30_GNSS_Protocol_Specification 21 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification NOTES 1. The parameter only supports 2. It can be omitted and 2 will be its default value when it is omitted. 2. The EPOTM function should be enabled after the time is synchronized successfully. 3. =2 is only supported by MC20 module with OC MC20CA-04-STD and MC20ECA-04-BLE. 4. If the EPO server is not configured by =2, the MTK sever will be accessed by default. 5. If a third-party EPO server needs to be used, AT+QGNSSEPO=2,[,] should be executed before executing AT+QGNSSEPO=1. 6. The parameters and configured by =2 will be discarded after executing AT+QGNSSEPO=0. If a third-party EPO server needs to be used, the two parameters should be configured again before executing AT+QGNSSEPO=1. Since =2 is only supported by MC20 module with OC MC20CA-04-STD and MC20ECA-04-BLE, the examples of this command for MC20 and MC30 modules are shown respectively below. Example (MC20 Module) AT+QGNSSEPO=? +QGNSSEPO: (0,2) //Test command OK AT+CREG?;+CGREG? +CREG: 0,1 //Check network status +CGREG: 0,1 OK AT+QGNSSTS? +QGNSSTS: 1 //Read time synchronization status //Time is synchronized successfully OK AT+QGNSSEPO=2,'fota.quectel-service.com',81 //This is an optional procedure. If the command is used, the domain name of Quectel in this command is only for testing purpose and customers can use their own domain name. OK AT+QGNSSEPO=1 //Enable EPOTM function OK AT+QGNSSEPO? //Read EPOTM status +QGNSSEPO: 1,2 OK MC20&MC30_GNSS_Protocol_Specification 22 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Example (MC30 Module) AT+QGNSSEPO=? +QGNSSEPO: (0,1) //Test command OK AT+CREG?;+CGREG? +CREG: 0,1 //Check network status +CGREG: 0,1 OK AT+QGNSSTS? +QGNSSTS: 1 //Read time synchronization status //Time is synchronized successfully OK AT+QGNSSEPO=1 OK AT+QGNSSEPO? +QGNSSEPO: 1,2 //Enable EPOTM function //Read EPOTM status OK 3.6. AT+QGREFLOC Set Reference Location Information for QuecFastFix Online The command is used to set reference location information for QuecFastFix Online function. AT+QGREFLOC Set Reference Location Information for QuecFastFix Online Test Command AT+QGREFLOC=? Response +QGREFLOC: , Read Command AT+QGREFLOC? OK Response +QGREFLOC: , Write Command AT+QGREFLOC=, OK Response OK MC20&MC30_GNSS_Protocol_Specification 23 / 82 Parameter GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification If there is any error, response: +CME ERROR: Latitude information of the reference location Longitude information of the reference location NOTES 1. The range of is -90°~90° north latitude, and the range of is -180°~180°east longitude. The input format of the parameter should retain 6 decimal places, and the unit is degree. 2. The command works for QuecFastFix Online function and should be set before executing AT+QGNSSEPO=1. Example AT+QGREGLOC=? //Test command +QGREFLOC: , OK AT+QGREFLOC=31.507985,117.119750 OK 3.7. AT+QGEPOAID Trigger EPOTM Function The command is used to trigger EPOTM function. AT+QGEPOAID Trigger EPOTM Function Test Command AT+QGEPOAID=? Execution Command AT+QEPOAID Response OK Response OK If there is any error, response: +CME ERROR: MC20&MC30_GNSS_Protocol_Specification 24 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification NOTE If GNSS is powered on already, this command can be used to trigger EPOTM function after executing AT+QGNSSEPO=1. Example AT+QGNSSC=1 OK AT+CREG?;+CGREG? +CREG: 0,1 +CGREG: 0,1 OK AT+QGNSSTS? +QGNSSTS: 1 OK AT+QGNSSEPO=1 OK AT+QGEPOAID OK //Power on GNSS //Check network status //Inquire time synchronization status 3.8. AT+QGEPOF EPOTM File Operation The command is used to operate EPOTM related files, including deleting related files, getting file size and querying validity period of EPOTM files. AT+QGEPOF EPOTM File Operation Test Command AT+QGEPOF=? Response +QGEPOF: (list of supported s), (list of supported s) Write Command AT+QGEPOF=, OK Response If is 0, response: +QGEPOF: ,, OK If is 1, response: MC20&MC30_GNSS_Protocol_Specification 25 / 82 Parameter GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification OK If is 2, response: +QGEPOF: OK If there is any error, response: +CME ERROR: Operation mode 0 1 2 EPOTM file selection 1 2 3 Get EPOTM file size Delete EPOTM file Query validity period of EPOTM files Select the EPOTM file containing 6 hours of data Select the EPOTM file containing the first 3 days of data Select the EPOTM file containing the second 3 days of data 255 Select the above 3 files Integer value. Positive numbers indicate the file size, and negative numbers indicate failed file operation. 0-4032 Size of the EPOTM file containing 6 hours of data -9 File not found -16 File access denied -19 Path not found Other negative values Other failed file operation Integer value. Positive numbers indicate the file size, and negative numbers indicate failed file operation. 0-48384 Size of the EPOTM file containing the first 3 days of data -9 File not found -16 File access denied -19 Path not found Other negative values Other failed file operation Integer value. Positive numbers indicate the file size, and negative numbers indicate failed file operation. 0-48384 Size of the EPOTM file containing the second 3 days of data -9 File not found -16 File access denied MC20&MC30_GNSS_Protocol_Specification 26 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification -19 Path not found Other negative values Other failed file operation String type. The queried validity period of EPOTM files The format is 'yyyy-MM-dd hh:mm:ss' (UTC time), and the characters indicate year, month, day, hour, minute and second respectively. -9 File not found -16 File access denied -19 Path not found Other negative values Other failed file operation NOTES 1. If the EPOTM files are deleted, there is a need to trigger EPOTM function again. For more details, please refer to document [5]. 2. If is 2, can be omitted. 3. Commands AT+QGEPOF=1,1, AT+QGEPOF=1,2 and AT+QGEPOF=1,3 are only for testing purpose. Please use AT+QGEPOF=1,255 in the real application. Example AT+QGEPOF=? //Test command +QGEPOF: (0-2),(1-3,255) OK AT+QGEPOF=0,255 //Get EPOTM file size +QGEPOF: -9,48384,48384 OK AT+QGEPOF=2 //Query validity period of EPOTM files +QGEPOF: 2017-02-19 00:00:00 OK AT+QGEPOF=1,255 OK AT+QGEPOF=0,255 +QGEPOF: -9,-9,-9 //Delete all EPOTM files. OK AT+QGEPOF=2 +QGEPOF: -9 OK MC20&MC30_GNSS_Protocol_Specification 27 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4 MTK NMEA Packet Protocol This chapter introduces the MTK NMEA packet protocol, which is a set of extension messages of standard NMEA packet protocol. These messages are used to control and configure the internal GNSS engine of MC20&MC30. The following tables show the structure of MTK NMEA packet. 4.1. Packet Type: 010 PMTK_SYS_MSG This message is used to automatically output system messages through GNSS module. Data Field: None Example: $PMTK010,001*2E Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Message * 010 System message ‘0’=Unknown ‘1’=Startup ‘2’=Notification for the host aiding EPO ‘3’=Notification for the transition to normal mode is successfully done End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC20&MC30_GNSS_Protocol_Specification 28 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.2. Packet Type: 011 PMTK_TXT_MSG This message is used to automatically output system messages through GNSS module. Data Field: None Example: $PMTK011,MTKGPS*08 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 011 Message MTKGPS * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.3. Packet Type: 001 PMTK_ACK Acknowledgement of PMTK command. In order to inform the sender whether the receiver has received the packet, and an acknowledge packet PMTK_ACK should be returned after the receiver receives a packet. Some commands will cause the GNSS module to restart or change the baud rate. There is no PMTK_ACK for those commands as listed below.  PMTK_CMD_HOT_START  PMTK_CMD_WARM_START  PMTK_CMD_COLD_START  PMTK_CMD_FULL_COLD_START  PMTK_SET_NMEA_BAUDRATE Data Field: $PMTK001,Cmd,Flag Example: MC20&MC30_GNSS_Protocol_Specification 29 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification $PMTK001,869,3*37 Field $ PMTK Packet Type Cmd Flag * Checksum Description Each NMEA message starts with ‘$’ MTK proprietary message 001 The packet type that the acknowledge responds ‘0’=Invalid packet ‘1’=Unsupported packet type ‘2’=Valid packet, but action failed ‘3’=Valid packet, action succeeded End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.4. Packet Type: 101 PMTK_CMD_HOT_START This message is used to perform the hot start of the GNSS module (use all available data in the NV store). Normally hot start means the GNSS module was powered down for less than 3 hours (RTC must be alive) and its ephemeris is still valid. As there is no need for downloading ephemeris, it is the fastest startup method. Data Field: None Example: $PMTK101*32 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 101 * End character of data field Checksum Hexadecimal checksum MC20&MC30_GNSS_Protocol_Specification 30 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Each NMEA message ends with ‘CR’ and ‘LF’ 4.5. Packet Type: 102 PMTK_CMD_WARM_START This message is used to perform the warm start of the GNSS module. Warm start means the GNSS module has approximate information on time, position and coarse data of satellite positions. But it needs to download ephemeris until it can get a fix. Using this message will force a warm restart on the GNSS module without using the ephemeris data in NV. Data Field: None Example: $PMTK102*31 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 102 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.6. Packet Type: 103 PMTK_CMD_COLD_START This message is used to perform cold start of the GNSS module. Using this message will force a cold restart on the GNSS module without using any prior location information, including time, position, almanacs and ephemeris data. Data Field: None Example: $PMTK103*30 Field Description MC20&MC30_GNSS_Protocol_Specification 31 / 82 $ PMTK Packet Type * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Each NMEA message starts with ‘$’ MTK proprietary message 103 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START This message is essentially a cold restart, but additionally clear system and user configuration at re-start. That is, reset the GNSS module to the factory status. Full cold start means the GNSS module has no information on last location. It needs to search the full time and frequency space, and also all possible satellite numbers before it can get a fix. Data Field: None Example: $PMTK104*37 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 104 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC20&MC30_GNSS_Protocol_Specification 32 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE This message is used to enter into standby mode for power saving and is not supported in All-in-one solution. Data Field: $PMTK161,Type Example: $PMTK161,0*28 Response: $PMTK001,161,3*36 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 161 Type ‘0’=Stop mode * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.9. Packet Type: 183 PMTK_LOCUS_QUERY_STATUS This message is used to query LOCUS logging status and is not supported in All-in-one solution. Data Field: None Example: $PMTK183*38 Response: $PMTK001,183,3*3A Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message MC20&MC30_GNSS_Protocol_Specification 33 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Packet Type * Checksum 183 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Return: Example: $PMTKLOG,456,0,11,31,2,0,0,0,3769,46*48 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type LOG Serial# Logging serial number: 0~65535 Type Logging type-0: Overlap, 1: Fullstop Mode Logging mode-0x08: Interval logger Content Logging contents of configuration Interval Logging interval setting (valid when interval mode is selected) Distance Logging distance setting (valid when distance mode is selected) Speed Logging speed setting (valid when speed mode is selected) Status Logging status-1: Stop logging, 0: Logging Number Logging number of data record Percent Logging life used percentage (0%~100%) * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC20&MC30_GNSS_Protocol_Specification 34 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.10. Packet Type: 184 PMTK_LOCUS_ERASE_FLASH This message is used to erase logger flash and is not supported in All-in-one solution. Data Field: $PMTK184,Type Example: $PMTK184,1*22 Response: $PMTK001,184,3*3D Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 184 Type ‘1’=Erase all logger internal flash data * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.11. Packet Type: 185 PMTK_LOCUS_STOP_LOGGER This message is used to stop or start logging data and is not supported in All-in-one solution. Data Field: $PMTK185,Stutas Example: $PMTK185,1*23 Response: $PMTK001,185,3*3C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message MC20&MC30_GNSS_Protocol_Specification 35 / 82 Packet Type Status * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 185 ‘0’=Start logging ‘1’=Stop logging End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.12. Packet Type: 220 PMTK_SET_POS_FIX This message is used to set position fix interval. Data Field: $PMTK220, Interval Example: $PMTK220,1000*1F Response: $PMTK001,220,3*30 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 220 Interval Position fix interval (msec). Range:100~10000 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC20&MC30_GNSS_Protocol_Specification 36 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.13. Packet Type: 223 PMTK_SET_AL_DEE_CFG This message is used to configure DEE. Data Field: $PMTK223,SV,SNR,Extension threshold,Extension gap Example: $PMTK223,1,30,180000,60000*3C Response: $PMTK001,223,3*33 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 223 SV Range: 1~4 (Default value: 1) SNR Range: 25~30 (Default value: 30) Extension Threshold Range: 40000~180000 (Default value: 180000) Extension Gap Range: 0~3600000 (Default value: 60000) * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.14. Packet Type: 225 PMTK_SET_PERIODIC_MODE This message is used to enter into periodic mode for power saving and is not supported in All-in-one solution. Data Field: $PMTK225,Type,Running time,Sleep time,Second running time,Second sleep time Example: $PMTK225,8*23 Response: $PMTK001,225,3*35 MC20&MC30_GNSS_Protocol_Specification 37 / 82 Field $ PMTK Packet Type Type Run Time Sleep Time Second Run Time Second Sleep Time * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Description Each NMEA message starts with ‘$’ MTK proprietary message 225 ‘0’=Back to normal mode ‘1’=Periodic Backup mode ‘2’=Periodic Standby mode ‘8’=AlwaysLocateTM Standby mode ‘9’=AlwaysLocateTM Backup mode ‘0’: Disable >=’1000’: Enable (Range: 1000~518400000) (Range: 1000~518400000) ‘0’: Disable >=’1000’: Enable (Range: 1000~518400000) (Range: 1000~518400000) End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE The unit of run time or sleep time is msec. The second runtime should be more than the first run time when the first run time is a non-zero value. 4.15. Packet Type: 256 PMTK_SET_TIMING_PRODUCT This message is used to enable or disable the timing of product mode (Default: off). Data Field: $PMTK256,Enable Example: $PMTK256,0*2F Response: $PMTK001,256,3*31 MC20&MC30_GNSS_Protocol_Specification 38 / 82 Field $ PMTK Packet Type Enable * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Description Each NMEA message starts with ‘$’ MTK proprietary message 256 ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.16. Packet Type: 285 PMTK_SET_PPS_CONFIG This message is used to set PPS type. Data Field: $PMTK285,Type,PPSPulseWidth Example: $PMTK285,4,100*38 Response: $PMTK001,285,3*3F Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Type PPSPulseWidth 285 ‘0’=Disable ‘1’=After the first fix ‘2’=3D fix only ‘3’=2D/3D fix only ‘4’=Always 2~998 (Unit: ms) * End character of data field MC20&MC30_GNSS_Protocol_Specification 39 / 82 Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.17. Packet Type: 286 PMTK_SET_AIC_ENABLED This message is used to enable or disable AIC function. It is suggested to set cold start command first and then PMTK command. Data Field: $PMTK286,Enable Example: $PMTK286,0*22 Response: $PMTK001,286,3*3C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Enable * 286 ‘0’=Disable ‘1’=Enable End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.18. Packet Type: 301 PMTK_API_SET_DGPS_MODE This message is used to configure the source mode of DGPS correction data. Data Field: $PMTK301,Mode Example: $PMTK301,2*2E Response: MC20&MC30_GNSS_Protocol_Specification 40 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification $PMTK001,301,3*32 Field $ PMTK Packet Type Mode * Checksum Description Each NMEA message starts with ‘$’ MTK proprietary message 301 DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM (Not Supported) ‘2’=SBAS (Including WAAS/EGNOS/GAGAN/MSAS) End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE Currently mode 1 is not supported. 4.19. Packet Type: 306 PMTK_API_SET_MIN_SNR This message is used to set the minimum SNR of used satellites. If the minimum SNR threshold value is set, the chip would not use the satellite whose SNR is smaller than it. Example: $PMTK306,15*1F Field Description $ PMTK Packet Type MIN_SNR * Each NMEA message starts with ‘$’ MTK proprietary message 306 Minimum SNR threshold of used satellites. Valid range: 9~37 End character of data field MC20&MC30_GNSS_Protocol_Specification 41 / 82 Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.20. Packet Type: 308 PMTK_API_SET_DR_LIMIT This message is used to set the number of estimated fix when entering the tunnel. Example: $PMTK308,0*25 => Disable the estimated fix when entering the tunnel. $PMTK308,3*26 => Keep outputting 3 fix when entering the tunnel. Field Description $ PMTK Packet Type DR_LIMIT * Checksum Each NMEA message starts with ‘$’ MTK proprietary message 308 Number of estimated fix. Valid range: 0~500 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.21. Packet Type: 311 PMTK_API_SET_ELEV_MASK This message is used to set satellite elevation mask. Data Field: $PMTK311,Type Example: $PMTK311,5*28 Response: $PMTK001,311,3*33 Field Description MC20&MC30_GNSS_Protocol_Specification 42 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification $ PMTK Packet Type Satellite Elevation Mask * Checksum Each NMEA message starts with ‘$’ MTK proprietary message 311 (Range: 0~90o) End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE The satellite elevation mask is recommended to be set not more than 10 degrees. As with the increase of satellite elevation mask, the number of satellites involved in positioning will decrease. 4.22. Packet Type: 313 PMTK_API_SET_SBAS_ENABLED This message is used to enable or disable the searching of a SBAS satellite. SBAS (Satellite-Based Augmentation System) is a system that supports wide-area or regional augmentation through the use of geostationary satellite-broadcast messages. The geostationary satellite-broadcast GNSS integrity and correction data are composed of multiple ground stations which are located at accurately surveyed points. Data Field: $PMTK313,Enable Example: $PMTK313,1*2E Response: $PMTK001,313,3*31 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Enable 313 ‘0’=Disable ‘1’=Enable MC20&MC30_GNSS_Protocol_Specification 43 / 82 * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.23. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT This message is used to set NMEA sentence output frequencies. There are totally 19 data fields that present output frequencies for the 19 supported NMEA sentences individually. Supported Frequency Settings:  0 - Disabled or not supported sentence  1 - Output once every one position fix  2 - Output once every two position fixes  3 - Output once every three position fixes  4 - Output once every four position fixes  5 - Output once every five position fixes Data Field: None Example: The module only outputs RMC once every one position fix. $PMTK314,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*29 Response: $PMTK001,314,3*36 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 314 0 GLL GLL interval - Geographic position, latitude and longitude 1 RMC RMC interval - Recommended minimum specific GNSS sentence 2 VTG VTG interval - Course over ground and ground speed 3 GGA GGA interval - GNSS fix data MC20&MC30_GNSS_Protocol_Specification 44 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4 GSA 5 GSV 6 GRS 7 GST 8 Reserved 9 Reserved 10 Reserved 11 Reserved 12 Reserved 13 Reserved 14 Reserved 15 Reserved 16 Reserved 17 ZDA 18 MCHN * Checksum GSA interval - GNSS DOPS and active satellites GSV interval - GNSS satellites in view GRS interval – GNSS range residuals GST interval – GNSS pseudorange error statistics Always 0 Always 0 Always 0 Always 0 Always 0 Always 0 Always 0 Always 0 Always 0 ZDA interval - Time and date PMTKCHN interval - GNSS channel status End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ The following messages are be used to restore the system default setting: Example: $PMTK314,-1*04 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 314 MC20&MC30_GNSS_Protocol_Specification 45 / 82 Restore * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Always -1 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.24. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA The receiver supports new NMEA format for QZSS. The command allows users to enable or disable QZSS NMEA format. QZSS NMEA format is disabled by default and is not supported in All-in-one solution. Data Field: $PMTK351,Enable Example: $PMTK351,1*28 Response: $PMTK001,351,3*37 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type QZSS_Enable * 351 ‘0’=Disable ‘1’=Enable End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC20&MC30_GNSS_Protocol_Specification 46 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.25. Packet Type: 352 PMTK_API_SET_STOP_QZSS QZSS is regional positioning service and is used to enable or disable QZSS function. It is enabled by default and is not supported in All-in-one solution. Data Field: $PMTK352,Enable Example: $PMTK352,0*2A Response: $PMTK001,352,3*34 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type QZSS_Enable * 352 ‘0’=Enable ‘1’=Disable End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.26. Packet Type: 353 PMTK_API_SET_GNSS_SEARCH_MODE This command is used to configure the receiver to start searching satellite system. Data Field: $PMTK353,GPS_Enable,Reserved,Reserved,Reserved,BEIDOU_Enable Example: $PMTK353,1,0,0,0,1*2B: Search GPS+BeiDou Response: $PMTK001,353,3,1,0,0,0,1,17*03 Field Description $ Each NMEA message starts with ‘$’ MC20&MC30_GNSS_Protocol_Specification 47 / 82 PMTK Packet Type GPS_Enable Reserved Reserved Reserved BEIDOU_Enable * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification MTK proprietary message 353 ‘0’=Disable (DO NOT search GPS satellites) ‘1’or non-ZERO: search GPS satellites Always 0 Always 0 Always 0 ‘0’=Disable ‘1’or non-ZERO: search BeiDou satellites End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTES 1. Actually BeiDou only mode is only for testing purpose. Please use GPS+BeiDou in the real application. 2. For more details about talker ID, please refer to Table 9. 4.27. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD This message is used to set the speed threshold for static navigation. If the actual speed is below the threshold, the output position will keep the same and output speed will be zero. This function is disabled if the threshold is set to 0. Data Field: $PMTK386,Speed_threshold Example: $PMTK386,0.3*3E Response: $PMTK001,386,3*3D Field Description $ Each NMEA message starts with ‘$’ MC20&MC30_GNSS_Protocol_Specification 48 / 82 PMTK Packet Type Speed Threshold * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification MTK proprietary message 386 0~2m/s End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.28. Packet Type: 400 PMTK_API_Q_FIX_CTL This message is used to query the rate of position fixing activity. Refer to PMTK_API_SET_FIX_CTL for setting the rate. Refer to PMTK_DT_FIX_CTL for the result of the query. Data Field: None Example: $PMTK400*36 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 400 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC20&MC30_GNSS_Protocol_Specification 49 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.29. Packet Type: 401 PMTK_API_Q_DGPS_MODE This message is used to query the setting of DGPS mode. Refer to PMTK_API_SET_DGPS_MODE for setting the DGPS mode. Refer to PMTK_DT_DGPS_MODE for the result of the query. Data Field: None Example: $PMTK401*37 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 401 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.30. Packet Type: 413 PMTK_API_Q_SBAS_ENABLED This message is used to query the setting of SBAS. Refer to PMTK_API_SET_SBAS_ENABLE for SBAS setting. Refer to PMTK_DT_SBAS_ENABLED for the result of the query. Data Field: None Example: $PMTK413*34 Field Description $ Each NMEA message starts with ‘$’ MC20&MC30_GNSS_Protocol_Specification 50 / 82 PMTK Packet Type * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification MTK proprietary message 413 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.31. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT This message is used to query the current NMEA sentence output frequencies. Refer to PMTK_API_SET_NMEA_OUTPUT for the frequencies setting. Refer to PMTK_DT_NMEA_OUTPUT for the result of the query. Data Field: None Example: $PMTK414*33 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 414 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.32. Packet Type: 458 PMTK_API_GET_POS_XYZ This message is used to return the WGS84 ECEF XYZ Cartesian position vector (metres) with an estimated 1-sigma accuracy. MC20&MC30_GNSS_Protocol_Specification 51 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Example: $PMTK458*3B Field Description $ PMTK Packet Type * Checksum Each NMEA message starts with ‘$’ MTK proprietary message 458 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.33. Packet Type: 461 PMTK_API_GET_VEL_XYZ This message is used to return the WGS84 ECEF XYZ Cartesian velocity vector (m/s) with an estimated 1-sigma accuracy. Example: $PMTK461*31 Field Description $ PMTK Packet Type * Checksum Each NMEA message starts with ‘$’ MTK proprietary message 461 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC20&MC30_GNSS_Protocol_Specification 52 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.34. Packet Type: 500 PMTK_DT_FIX_CTL This message is the response to PMTK_API_Q_FIX_CTL. Data Field: $PMTK500,Fix interval Example: $PMTK500,1000,0,0,0,0*1A Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 500 Fix Interval Position fix interval (msec). Range: 100~10000 Reserved Always 0 Reserved Always 0 Reserved Always 0 Reserved Always 0 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.35. Packet Type: 501 PMTK_DT_DGPS_MODE This message is the response to PMTK_API_Q_DGPS_MODE. Data Field: $PMTK501,Mode Example: $PMTK501,1*2B Field Description MC20&MC30_GNSS_Protocol_Specification 53 / 82 $ PMTK Packet Type Mode * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Each NMEA message starts with ‘$’ MTK proprietary message 501 DGPS data source mode ‘0’=No DGPS source ‘1’=RTCM ‘2’=SBAS End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.36. Packet Type: 513 PMTK_DT_SBAS_ENABLED This message is the response to PMTK_API_Q_SBAS_ENABLED. Data Field: $PMTK513,Enable Example: $PMTK513,1*28 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Enable * 513 ‘0’=Disable ‘1’=Enable End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC20&MC30_GNSS_Protocol_Specification 54 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 4.37. Packet Type: 514 PMTK_DT_NMEA_OUTPUT This message is the response to PMTK_API_Q_NMEA_OUTPUT. Data Field: None Example: $PMTK514,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0*33 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 514 0 GLL GLL interval - Geographic position, latitude and longitude 1 RMC RMC interval - Recommended minimum specific GNSS sentence 2 VTG VTG interval - Course over ground and ground speed 3 GGA GGA interval - GNSS fix data 4 GSA GSA interval - GNSS DOPS and active satellites 5 GSV GSV interval - GNSS satellites in view 6 Reserved GRS interval – GNSS range residuals 7 Reserved GST interval – GNSS pseudorange error statistics 8 Reserved 9 Reserved 10 Reserved 11 Reserved 12 Reserved 13 Reserved 14 Reserved 15 Reserved MC20&MC30_GNSS_Protocol_Specification 55 / 82 16 Reserved 17 ZDA 18 Reserved * Checksum GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification ZDA interval - Time and date PMTKCHN interval - GNSS channel status End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.38. Packet Type: 605 PMTK_Q_RELEASE This message is used to query the firmware release information. Refer to PMTK_DT_RELEASE for the result of the query. Data Field: None Example: $PMTK605*31 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 605 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.39. Packet Type: 607 PMTK_Q_EPO_INFO This command is used to query the EPO data status stored in the GNSS chip. MC20&MC30_GNSS_Protocol_Specification 56 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Data Field: None Example: $PMTK607*33 Response: PMTK_DT_EPO_INFO Field Description $ PMTK Packet Type * Checksum Each NMEA message starts with ‘$’ MTK proprietary message 607 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.40. Packet Type: 622 PMTK_Q_LOCUS_DATA This message is used to dump locus flash data and is not supported in All-in-one solution. Data Field: $PMTK622,Type Example: $PMTK622,1*29 Response: $PMTK001,622,3*36 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 622 Type ‘1’=Dump partial in used LOCUS flash data. * End character of data field Checksum Hexadecimal checksum MC20&MC30_GNSS_Protocol_Specification 57 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Each NMEA message ends with ‘CR’ and ‘LF’ 4.41. Packet Type: 705 PMTK_DT_RELEASE This message is the response to PMTK_Q_RELEASE. Data Field: $PMTK705,Release string,Build ID,Product Model (SDK Version) Example: $PMTK705,AXN_5.10_3333_17062100,0001,MC20-GNSS,1.0*27 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Release String Build ID 705 Firmware release name and version 3318: Mcore_x.x 3329: AXN_x.x 3339: AXN_x.x 3333: AXN_x.x 3337: AXN_x.x Build ID set in CoreBuilder for firmware version control Product Model SDK Version (Optional) * Product model set in CoreBuilder for product identification Showing SDK version if the firmware is used for SDK End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.42. Packet Type: 707 PMTK_DT_EPO_INFO This response packet contains EPO data status stored in GNSS chip. MC20&MC30_GNSS_Protocol_Specification 58 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Data Field: $PMTK707,Set,FWN,FTOW,LWN,LTOW,FCWN,FCTOW,LCWN,LCTOW*CS Example: $PMTK707,56,1468,172800,1470,151200,1468,259200,1468,259200*1F Response: PMTK_DT_EPO_INFO Field Description $ PMTK Packet Type Set FWN FTOW LWN LTOW FCWN FCTOW LCWN LCTOW * Checksum Each NMEA message starts with ‘$’ MTK proprietary message 707 Total number sets of EPO data stored in GNSS chip GPS week number of the first set of EPO data stored in GNSS chip GPS week TOW of the first set of EPO data stored in GNSS chip GPS week number of the last set of EPO data stored in GNSS chip GPS week TOW of the last set of EPO data stored in GNSS chip GPS week number of the first set of EPO data that are currently used GPS week TOW of the first set of EPO data that are currently used GPS week number of the last set of EPO data that are currently used GPS week TOW of the last set of EPO data that are currently used End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.43. Packet Type: 838 PMTK_TEST_ANTI_SPOOFING This message is used to enable or disable jamming detection function. Data Field: $PMTK838,CmdType MC20&MC30_GNSS_Protocol_Specification 59 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Example: $PMTK838,1*2C Response: $PMTK001,838,3,1*2E Return: $PMTKSPF,1*5A => No jamming, healthy status (status 1) $PMTKSPF,2*59 => Warning status (status 2) $PMTKSPF,3*58 => Critical status (status 3) Field Description $ PMTK Packet Type CmdType * Checksum Each NMEA message starts with ‘$’ MTK proprietary message 838 ‘0’=Disable jamming detection function ‘1’=Enable jamming detection function End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE After jamming detection is enabled, the module starts to detect whether there is jamming. 1. If there is no jamming, '$PMTKSPF,1*5A' will be reported to indicate healthy status (status 1). 2. If there is continuous jamming, then the module status will change from 1 to 2 and finally 3.  In the case of not being positioned: after jamming detection is enabled, the module status will be 1 at the very beginning, and then change to 2 when jamming is detected. During the process, the module will attempt to fix position. If it still fails in positioning after 200s, the module status will change to 3 finally.  In the case of being positioned: after jamming detection is enabled, the module status will be 1 at the very beginning. When jamming is detected, the module status will change to 2 and then 3 consecutively. 4.44. Packet Type: 869 PMTK_EASY_ENABLE This message is used to enable or disable EASYTM function, and query whether EASYTM is enabled or disabled. MC20&MC30_GNSS_Protocol_Specification 60 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Data Field: $PMTK869,CmdType[,Enabled] Example: $PMTK869,1,1*35 Response: $PMTK001,869,3*37 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type CmdType Enabled * 869 ‘0’=Query ‘1’=Set ‘2’=Result for query operation ‘0’=Disable ‘1’=Enable End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTES 1. If EASYTM is disabled, the receiver returns: $PMTK869,2,0,0*2B 2. If EASYTM is enabled and is not finished yet, the receiver may return: $PMTK869,2,1,0*2A 3. If EASYTM is enabled and is finished after 1 day, the receiver may return: $PMTK869,2,1,1*2B 4. If EASYTM is enabled and is finished after 2 days, the receiver may return: $PMTK869,2,1,2*28 5. If EASYTM is enabled and is finished after 3 days, the receiver may return: $PMTK869,2,1,3*29 4.45. Packet Type: 875 PMTK_PMTKLSC_STN_OUTPUT This message is used to enable or disable PMTKLSC sentence output and query whether PMTKLSC sentence output is enabled or disabled. This command is not supported in All-in-one solution. MC20&MC30_GNSS_Protocol_Specification 61 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Data Field: $PMTK875,CmdType[,Enabled] Example: $PMTK875,1,1*38: Enable PMTKLSC and PMTKLSCB sentence output Response: $PMTKLSC,Parameter1,Parameter2,Parameter3*CS $PMTKLSB,Parameter1,Parameter2,Parameter3*CS Where Parameter1: current leap second Parameter2: leap indicator, 1 means updated from broadcast data Parameter3: next leap second Field $ PMTK Packet Type CmdType Enabled * Checksum Description Each NMEA message starts with ‘$’ MTK proprietary message 875 ‘0’=Query ‘1’=Set ‘2’=Result for query operation ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 4.46. Packet Type: 886 PMTK_FR_MODE This message is used to set navigation mode. Data Field: $PMTK886,CmdType Example: $PMTK886,3*2B Response: $PMTK001,886,3*36 MC20&MC30_GNSS_Protocol_Specification 62 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Field $ PMTK Packet Type CmdType * Checksum Description Each NMEA message starts with ‘$’ MTK proprietary message 886 ‘0’=Normal mode: For general purpose ‘1’=Fitness mode: For running and walking purpose that the low-speed (<5m/s) movement will have more effect on the position calculation. ‘2’=Aviation mode: For high-dynamic purpose that the large-acceleration movement will have more effect on the position calculation. ‘3’=Balloon mode: For high-altitude balloon purpose that the vertical movement will have more effect on the position calculation. ‘4’=Stationary mode: For stationary applications that zero dynamics is assumed. End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE Each mode has its altitude limitation. Please choose the appropriate mode base on the table below. If the test scenario exceeds the limitation, the position calculation will be incorrect. Mode Altitude Limitation Normal mode 10000m Fitness mode 10000m Aviation mode 10000m Stationary mode 10000m Balloon mode 80000m MC20&MC30_GNSS_Protocol_Specification 63 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 5 SDK NMEA Packet Protocol This chapter introduces the SDK NMEA packet protocol, which is a set of extension messages of standard NMEA packet protocol. These messages are used to control and configure the internal GNSS engine of MC20&MC30. The following table shows the structure of SDK NMEA packet. The SDK NMEA packet is sent through AT commands. 5.1. PQBAUD Change NMEA Port Default Baud Rate PQBAUD Change NMEA Port Default Baud Rate Write Command $PQBAUD,W,*Checksum Response $PQBAUD,W,OK*Checksum If there is any error, response: $PQBAUD,W,ERROR*Checksum Reference Parameter NMEA port baud rate, default value is 115200bps, and can be set to 4800bps,9600bps 14400bps, 19200bps, 38400bps and 57600bps in Stand-alone solution Example $PQBAUD,W,38400*7B $PQBAUD,W,OK*40 //Change NMEA port default baud rate to 38400bps //Set OK NOTES 1. The command will be valid in Stand-alone solution only. 2. The command will be effective immediately after setting. 3. Parameter is automatically saved. 4. If the baud rate is changed, then there is no response returned in the current baud rate. MC20&MC30_GNSS_Protocol_Specification 64 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 5.2. PQEPE Enable/Disable PQEPE Sentence Output PQEPE Enable/Disable PQEPE Sentence Output Write Command $PQEPE,W,,*Checksu m URC Message Response $PQEPE,W,OK*Checksum If there is any error, response: $PQEPE,W,ERROR*Checksum $PQEPE,,*Checksum Parameter Estimated horizontal position error Estimated vertical position error Reference Example $PQEPE,5.3050,3.2000*53 Parameter Operation 0 Disable the URC including EPE data 1 Enable the URC including EPE data Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example $PQEPE,W,1,1*2A $PQEPE,W,OK*02 //Enable the URC including EPE data, and save parameters into flash //Set OK NOTE The command will be effective immediately after setting. MC20&MC30_GNSS_Protocol_Specification 65 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 5.3. PQECEF Enable/Disable ECEFPOSVEL Sentence Output PQECEF Enable/Disable ECEFPOSVEL Sentence Output Write Command $PQECEF,W,,*ChkSu m Read Command $PQECEF,R*ChkSum URC Message Response $PQECEF,W,OK*ChkSum If there is any error, response: $PQECEF,W,ERROR*ChkSum Response $PQECEF,R,*ChkSum $ECEFPOSVEL,,,,,,,*C hkSum Parameter UTC from the internal real-time clock The value of X axis in ECEF The value of Y axis in ECEF The value of Z axis in ECEF Velocity component of X axis in ECEF Velocity component of Y axis in ECEF Velocity component of Z axis in ECEF Reference Example $ECEFPOSVEL,052743.000,-1526672.867459,6191083.982 801,143008.780911,0,0,0*14 Parameter Operation 0 Disable ECEFPOSVEL sentence output 1 Enable ECEFPOSVEL sentence output Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example $PQECEF,W,1,1*7F $PQECEF,W,OK*57 $PQECEF,R*7A $PQECEF,R,1*67 //Enable ECEFPOSVEL sentence output, and save the parameter into flash //Set OK //Read mode //Read OK, ECEFPOSVEL sentence output is enabled MC20&MC30_GNSS_Protocol_Specification 66 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification NOTE The command will be effective immediately after setting. 5.4. PQODO Start/Stop Odometer Reading PQODO Start/Stop Odometer Reading Write Command $PQODO,W,[,]*ChkSum Read Command $PQODO,R*ChkSum Response $PQODO,W,OK*ChkSum If there is any error, response: $PQODO,W,ERROR*ChkSum Response $PQODO,R,*ChkSum Query Command $PQODO,Q*ChkSum If there is any error, response: $PQODO,R,ERROR*ChkSum Response $PQODO,Q,*ChkSum Reference If there is any error, response $PQODO,Q,ERROR*ChkSum Parameter Start or stop odometer reading 0 Stop odometer reading and remember the distance value 1 Start odometer reading and initialize the distance according to the Set the initial distance, range: 0-1e09, unit: meter When is 1, this parameter can be omitted, and its default value is 0 When is 0, this parameter must be omitted Current distance. Unit: meter Example $PQODO,W,1*23 $PQODO,W,OK*16 //Start odometer reading, and initial distance is 0m. //Set OK MC20&MC30_GNSS_Protocol_Specification 67 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification $PQODO,W,1,1000000*3E $PQODO,W,OK*16 $PQODO,R*3B $PQODO,R,1*26 $PQODO,Q*38 $PQODO,Q,123.45*0B //Start odometer reading, and initial distance is 1,000,000m. //Set OK //Read mode //Read OK, odometer reading has already been started //Query the distance value //Current distance value is returned NOTES 1. The command will be effective immediately after setting. 2. After module is restarted, the PQODO write command must be executed again to re-start odometer reading. 3. The command is not supported in backup mode. 5.5. PQPZ90 Enable/Disable Switching from WGS84 to PZ-90.11 PQPZ90 Enable/Disable Switching from WGS84 to PZ-90.11 Write Command $PQPZ90,W,,*ChkSum Read Command $PQPZ90,R*ChkSum URC Message Response $PQPZ90,W,OK*ChkSum If there is any error, response: $PQPZ90,W,ERROR*ChkSum Response $PQPZ90,R,*ChkSum $xxDTM,P90,x,xx.xxxx,x,xx.xxxx,x,xxx,W84*hh Parameter definition is available in Table 8. Reference Parameter Operation 0 Disable switching from WGS84 to PZ-90.11 1 Enable switching from WGS84 to PZ-90.11 Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart MC20&MC30_GNSS_Protocol_Specification 68 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Example $PQPZ90,W,1,1*79 $PQPZ90,W,OK*51 $PQPZ90,R*7C $PQPZ90,R,0*60 //Enable switching from WGS84 to PZ-90.11, and save the parameter into flash //Set OK //Read mode //Read OK, switching from WGS84 to PZ-90.11 is enabled NOTES 1. The command will be effective immediately. 2. If switching from WGS84 to PZ-90.11 is enabled and effective, the coordinate values in RMC and GGA sentences will be switched to PZ-90.11 after fixing. Also, a DTM sentence will be displayed to identify the datum used. 5.6. PQGLP Set the Module into GLP Mode PQGLP Set the Module into GLP Mode Write Command $PQGLP,W,,*ChkSum Read Command $PQGLP,R*ChkSum Response $PQGLP,W,OK*ChkSum If there is any error, response: $PQGLP,W,ERROR*ChkSum Response $PQGLP,R,*ChkSum Reference Parameter Module operation mode 0 Normal mode 1 GLP mode Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example $PQGLP,W,1,1*21 $PQGLP,W,OK*09 //Change to GLP mode //Set OK MC20&MC30_GNSS_Protocol_Specification 69 / 82 $PQGLP,R*24 $PQGLP,R,1*39 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification //Read mode //Read OK, GLP mode is enabled NOTES 1. The command will be effective immediately after setting. 2. For more details about the usage of PQGLP command, please refer to document [4]. 5.7. PQVEL Enable/Disable 3 Ways Velocity Sentence Output PQVEL Enable/Disable 3 Ways Velocity Sentence Output Write Command $PQVEL,W,,*ChkSum Read Command $PQVEL,R*ChkSum URC Message Response $PQVEL,W,OK*ChkSum If there is any error, response: $PQVEL,W,ERROR*ChkSum Response $PQVEL,R,*ChkSum $PQVEL,,,*ChkSum Parameter North velocity East velocity Down velocity Reference Example $PQVEL,1.000000,2.000000,-0.000000*42 Parameter Enable/disable 3 ways velocity sentence output 0 Disable 1 Enable Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart MC20&MC30_GNSS_Protocol_Specification 70 / 82 Example $PQVEL,W,1,1*25 $PQVEL,W,OK*0D $PQVEL,R*20 $PQVEL,R,1*3D GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification //Enable 3 ways velocity sentence output //Set OK //Read mode //Read OK, 3 ways velocity sentence output is enabled NOTE The command will be effective immediately after setting. 5.8. PQJAM Enable/Disable Jamming Detection Function PQJAM Enable/Disable Jamming Detection Function Write Command $PQJAM,W,,*ChkSum Read Command $PQJAM,R*ChkSum URC Message Response $PQJAM,W,OK*ChkSum If there is any error, response: $PQJAM,W,ERROR*ChkSum Response $PQJAM,R,*ChkSum $PMTKSPF, *ChkSum Parameter Jamming status 1 No jamming, healthy status 2 Warning status 3 Critical status Reference Example $PMTKSPF,1*5A Parameter Operation mode 0 Disable jamming detection function 1 Enable jamming detection function MC20&MC30_GNSS_Protocol_Specification 71 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example $PQJAM,W,1,1*3C $PQJAM,W,OK*14 $PQJAM,R*39 $PQJAM,R,1*24 //Enable jamming detection function //Set OK //Read operation mode //Read OK NOTES 1. The command will be effective immediately after setting. 2. The command is not supported in backup mode. 5.9. PQRLM Enable/Disable Return Link Message Output PQRLM Enable/Disable Return Link Message Output Write Command $PQRLM,W,,*ChkSum Read Command $PQRLM,R*ChkSum URC Message Response $PQRLM,W,OK*ChkSum If there is any error, response: $PQRLM,W,ERROR*ChkSum Response $PQRLM,R,*ChkSum $PQRLM,,,,*ChkSum Parameter Beacon ID of RLM The GPS second when receiving RLM Message code The data parameters provided by RLS. (short message contains 4 hex characters, long message contains 24 hex characters) Example $PQRLM,0a0a0a0a0a0a0a8,955065733,1,8aa1*3E $PQRLM,050505050505052,955065709,15,5555555555555 MC20&MC30_GNSS_Protocol_Specification 72 / 82 Reference 55555 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Parameter Enable/disable return link message output 0 Disable 1 Enable Save operation 0 Parameter is not saved, and ineffective after restart 1 Parameter is saved in flash, and effective after restart Example $PQRLM,W,1,1*29 $PQRLM,W,OK*01 $PQRLM,R*2C $PQRLM,R,1*31 //Enable return link message output //Set OK //Read mode //Read OK NOTE The command will be effective immediately after setting. 5.10. PQGEO Configure Parameters of Geo-fence PQGEO Configure Parameters of Geo-fence Write Command $PQGEO,W,,,,,,,,,,,*ChkSum Read Command $PQGEO,R,*ChkSum Response $PQGEO,W,OK*ChkSum If there is any error, response: $PQGEO,W,ERROR*ChkSum Response $PQGEO,R,,,,,,,,,,,*ChkSum If there is any error, response: $PQGEO,R,ERROR*ChkSum Inquire Command Response $PQGEO,Q,*ChkSum $PQGEO,Q,,*ChkSum If there is any error, response: $PQGEO,Q,ERROR*ChkSum URC Message $PQGEO,,,,,,,,,,,,,,,,,,*ChkSum Parameters Geo-fence ID is from 0 to 9. The current action of the module 1 Enters a geo-fence 2 Leaves a geo-fence Fix status 0 No fix 1 2D fix 2 3D fix UTC time Format: DyyMMddThhmmss.sss D: char ‘D’, refers to date yy: current year-2000 MM: 1-12 dd: 1-31 T: char ‘T’, refers to time hh: 0-23 mm: 0-59 ss.sss: 00.000-59.9999 The latitude of current position Unit: degree Format: ±dd.dddddd Range: -90.000000~90.000000 The longitude of current position Unit: degree Format: ±ddd.dddddd Range: -180.000000~180.000000 Mean sea level (MSL) altitude MC20&MC30_GNSS_Protocol_Specification 74 / 82 Reference Parameter GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Unit: meter Speed over ground. Unit: km/h Course over ground Unit: degree Range: 0-360.00 Fix mode 0 No fix 1 Estimated mode 2 Position fixed 3 Position fixed in DGPS mode Reserved1 Horizontal dilution of precision Position dilution of precision Vertical dilution of precision Reserved2 GPS satellites in view GPS satellites used Example $PQGEO,0,1,2,D150506T070127.000,31.856038,117.19711 0,49.4,14.92,0.18,2,,1.11,2.95,2.74,,14,9*5D Geo-fence ID, range: 0-9 Report mode 0 Do not report when to enter or leave the geo-fence 1 Report when to enter the geo-fence 2 Report when to leave the geo-fence 3 Report when to enter or leave the geo-fence If is 0, the parameters after can be omitted. Fence shape 0 Circularity with center and radius 1 Circularity with center and one point on the circle 2 Triangle 3 Quadrangle The latitude of a point which is defined as the center of the geo-fence circular region or the first point, Unit: degree Format: ±dd.dddddd, range: -90.000000~90.000000 The longitude of a point which is defined as the center of the geo-fence circular region or the first point. Unit: degree Format: ±ddd.dddddd, range: -180.000000~180.000000 MC20&MC30_GNSS_Protocol_Specification 75 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification When is 0, this parameter is radius, unit: meter, range: 0-6000000.0 When is other values, this parameter is latitude1, Unit: degree Format: ±dd.dddddd, range: -90.000000~90.000000 If is 0, the parameters after must be omitted. The longitude of the second point. Unit: degree Format: ±ddd.dddddd, range: -180.000000~180.000000 If is 1, the parameters after must be omitted. The latitude of the third point. Unit: degree Format: ±dd.dddddd, range: -90.000000~90.000000 The longitude of the third point. Unit: degree Format: ±ddd.dddddd, range: -180.000000~180.000000 If is 2, the parameters after must be omitted. The latitude of the fourth point. Unit: degree Format: ±dd.dddddd, range: -90.000000~90.000000 The longitude of the fourth point. Unit: degree Format: ±ddd.dddddd, range: -180.000000~180.000000 The status of current position. 0 Unknown position 1 Inside the geo-fence 2 Outside the geo-fence Example $PQGEO,W,0,1,0,31.85913,117.1933,500.0*26 $PQGEO,W,OK*1F $PQGEO,W,4,3,1,31.91133,117.1129,31.994856,117.070281*1C $PQGEO,W,OK*1F $PQGEO,W,3,0*34 $PQGEO,W,OK*1F // is 0. // is 1. //Delete geo-fence 3. $PQGEO,R,0*2E $PQGEO,R,0,1,0,31.859130,117.193300,500.0*13 $PQGEO,R,4*2A $PQGEO,R,4,3,1,31.911330,117.112900,31.994856,117.070281*29 $PQGEO,Q,0*2D $PQGEO,Q,0,1*30 $PQGEO,Q,4*29 $PQGEO,Q,4,2*37 NOTES 1. If is 0 and there are no parameters after , this command can delete the geo-fence. 2. $PQGEO,R,10*1F command can inquire parameters of all geofences. MC20&MC30_GNSS_Protocol_Specification 76 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 3. The command will be effective immediately after setting, and the parameters will be automatically saved into flash. 4. Input the latitude and longitude in sequence in clockwise or counter-clockwise order. MC20&MC30_GNSS_Protocol_Specification 77 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 6 Default Configurations Table 3: Default Configurations Item NMEA Port Baud Rate Datum Rate of Position Fixing DGPS Mode SBAS NMEA Output Messages AIC EASYTM Default 115200bps WGS84 1Hz SBAS Enabled GGA, RMC, GSA, GSV, VTG and GLL On On MC20&MC30_GNSS_Protocol_Specification 78 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 7 Appendix A References Table 4: Related Documents SN Document Name Remark [1] Quectel_MC20_Series_Hardware_Design [2] Quectel_MC30_Hardware_Design MC20 Series Hardware Design MC30 Hardware Design [3] Quectel_GNSS_SDK_Commands_Manual GNSS SDK Commands Manual Quectel_GNSS_Low_Power_Mode_Application_ [4] GNSS Low Power Mode Application Note Note Quectel_MC20&MC30_GNSS_AGPS_Application MC20&MC30 GNSS AGPS Application [5] _Note Note Table 5: Terms and Abbreviations Abbreviation AGPS Description Assisted Global Positioning System AIC Active Interference Cancellation CS Commercial Sample DGPS EASY Differential Global Positioning System Embedded Assist System GBS NMEA: GPS Satellite Fault Detection GGA GLL GLONASS GNSS NMEA: Global Positioning System Fix Data NMEA: Geographic Latitude and Longitude GLObalnaya NAvigatsionnaya Sputnikovaya Sistema, the Russian Global Navigation Satellite System Global Navigation Satellite System MC20&MC30_GNSS_Protocol_Specification 79 / 82 BeiDou GPS GSA GSV HDOP MP NMEA NITZ PDOP PMTK RMC SBAS UTC VDOP VTG WAAS GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification Chinese Satellite Navigation System Global Positioning System NMEA: GNSS DOP and Active Satellites NMEA: GNSS Satellites in View Horizontal Dilution of Precision Mass Production National Marine Electronics Association Network Identity and Time Zone Position Dilution of Precision Private Protocol of MTK NMEA: Recommended Minimum Position Data Satellite-Based Augmentation System Universal Time Coordinated Vertical Dilution of Precision NMEA: Track Made Good and Ground Speed Wide Area Augmentation System Table 6: Structure of NMEA Message Filed $ Length (Bytes) 1 Talker ID 1~2 NMEA 3 Message ID Data Field Variable, depends on the Description Each NMEA message starts with ‘$’ Talker IDs can be ‘GP’, ‘GN’ and ‘BD’ when the message ID is RMC, VTG, GLL or GGA; Talker IDs can be ‘GP’, ‘GN’, ‘BD’ and ‘GA’ when the message ID is GSA; Talker IDs can be ‘GP’, ‘GL’, ‘BD’ and ‘GA’ when the message ID is GSV, and Talker IDs can be ‘GN’ when the message ID is GBS. NMEA message ID Data fields, delimited by comma ‘,’ MC20&MC30_GNSS_Protocol_Specification 80 / 82 NMEA message type * 1 Checksum 2 2 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification End character of data field A hexadecimal number calculated by exclusive OR of all characters between ‘$’ and ‘*’ Each NMEA message ends with ‘CR’ and ‘LF’ NOTE The default output messages of MC20&MC30 are as following six sentences: RMC, VTG, GGA, GSA, GSV and GLL. Table 7: Structure of MTK NMEA Packet Filed Length (Bytes) Description $ 1 Talker ID 1 Each NMEA message starts with ‘$’ ‘P’ for proprietary message NMEA Data Type 3 Data Filed Packet Type 3 Variable, depends Packet Data on the packet type * 1 Checksum 2 2 Always ‘MTK’ to indicate MTK proprietary message Packet type, from ‘000’ to ‘999’ Data fields, delimited by comma ‘,’ End character of data field A hexadecimal number calculated by exclusive OR of all characters between ‘$’ and ‘*’ Each NMEA message ends with ‘CR’ and ‘LF’ Table 8: Datum Sentence Definition $xxDTM,P90,x,xx.xxxx,x,xx.xxxx,x,xxx,W84*hh Field Meaning 1 Talker ID, refer to Table 9 Local datum code (xxx): 2 W84 - WGS84 P90 - PZ-90 MC20&MC30_GNSS_Protocol_Specification 81 / 82 GSM/GPRS/GNSS Module Series MC20&MC30 GNSS Protocol Specification 3 Local datum sub code (x) 4 Latitude offset in minutes (xx.xxxx) 5 Latitude offset mark (N: +, S: -) (x) 6 Longitude offset in minutes (xx.xxxx) 7 Longitude offset mark (E: +, W: -) (x) 8 Altitude offset in meters. Datum (xxx): 9 W84 - WGS84 P90 - PZ-90 10 Checksum Table 9: Talker ID Display in Different GNSS System (for NMEA 0183 3.01 Version) Talker GPS BeiDou GLONASS Galileo GPS+ GPS+ GPS+ GPS+GLONASS ID Only Only Only Only GLONASS BeiDou Galileo +Galileo GGA GP BD GL GA GN GN GN GN RMC GP BD GL GA GN GN GN GN GLL GP BD GL GA GN GN GN GN VTG GP BD GL GA GN GN GN GN GSA GP BD GL GA GP+GL GP+BD GP+GA GP+GA+GL GSV GP BD GL GA GP+GL GP+BD GP+GA GP+GA+GL DTM GP BD GL GA GN GN GN GN MC20&MC30_GNSS_Protocol_Specification 82 / 82

L76K&L26K GNSS 协议规范 GNSS 模块系列 版本：1.2 日期：2021-12-16 状态：受控文件 L76K&L26K GNSS 协议规范 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 41 L76K&L26K GNSS 协议规范 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 2 / 41 L76K&L26K GNSS 协议规范 文档历史 文档信息 标题 副标题 文档类别 文档状态 L76K&L26K GNSS 协议规范 GNSS 模块系列 GNSS 协议规范 受控文件 修订记录 版本 1.0 日期 2020-07-28 1.1 2021-09-10 1.2 2021-12-16 变更表述 初始版本 1. 增加适用模块 L26K。 2. 更新 PCAS02 参数的取值（第 2.3.2 章节）。 3. 增加 CASIC 语句类型说明（第 3.1.2 章节）。 4. 增加 CASIC 语句编号说明（第 3.1.3 章节）。 5. 更正 CFG-PRT 示例（第 3.2.2.1 章节）。 6. 更新 CFG_RATE 有效载荷描述（表 18）。 1. 更新 BeiDou 卫星对应的（表 2）。 2. 更新 GGA 语句参数和的描述（第 2.2.2 章）。 3. 更正 GSV、VTG 和 ZDA 语句示例（第 2.2.3 章、2.2.5 章和 2.2.8 章）。 4. 更新 PCAS02 中的参数名为（第 2.3.2 章）。 上海移远通信技术股份有限公司 3 / 41 L76K&L26K GNSS 协议规范 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 NMEA 协议............................................................................................................................................ 8 2.1. NMEA 协议消息结构 .................................................................................................................. 8 2.2. 通用语句 ..................................................................................................................................... 9 2.2.1. RMC ................................................................................................................................ 9 2.2.2. GGA............................................................................................................................... 12 2.2.3. GSV ............................................................................................................................... 14 2.2.4. GSA ............................................................................................................................... 15 2.2.5. VTG ............................................................................................................................... 16 2.2.6. GLL................................................................................................................................ 18 2.2.7. TXT................................................................................................................................ 19 2.2.8. ZDA ............................................................................................................................... 20 2.3. PCAS 语句（专用语句）.......................................................................................................... 21 2.3.1. PCAS01......................................................................................................................... 21 2.3.2. PCAS02......................................................................................................................... 22 2.3.3. PCAS03......................................................................................................................... 23 2.3.4. PCAS04......................................................................................................................... 25 2.3.5. PCAS10......................................................................................................................... 26 3 CASIC 协议 ......................................................................................................................................... 27 3.1. CASIC 语句结构....................................................................................................................... 27 3.1.1. 数据类型 ........................................................................................................................ 28 3.1.2. 语句概述 ........................................................................................................................ 28 3.2. CASIC 语句 .............................................................................................................................. 29 3.2.1. ACK ............................................................................................................................... 29 3.2.1.1. ACK-NACK（0x05 0x00）................................................................................. 29 3.2.1.2. ACK-ACK（0x05 0x01)...................................................................................... 30 3.2.2. CFG ............................................................................................................................... 31 3.2.2.1. CFG-PRT（0x06 0x00)...................................................................................... 31 3.2.2.2. CFG-MSG（0x06 0x01） .................................................................................. 33 3.2.2.3. CFG-RST（0x06 0x02)...................................................................................... 34 3.2.2.4. CFG-RATE（0x06 0x04） ................................................................................. 35 4 附录 A 参考文档及术语缩写............................................................................................................... 37 5 附录 B GNSS 标识符 .......................................................................................................................... 40 6 附录 C 默认配置 ................................................................................................................................. 41 上海移远通信技术股份有限公司 4 / 41 L76K&L26K GNSS 协议规范 表格索引 表 1：NMEA 语句结构.................................................................................................................................. 8 表 2：发送设备标识符助记码（TalkerID） .................................................................................................. 9 表 3：CASIC 语句结构............................................................................................................................... 27 表 4：数据类型 ........................................................................................................................................... 28 表 5：语句概述 ........................................................................................................................................... 28 表 6：ACK-NACK 有效载荷 ....................................................................................................................... 30 表 7：ACK-ACK 有效载荷.......................................................................................................................... 30 表 8：CFG-PRT 有效载荷.......................................................................................................................... 31 表 9：协议控制掩码.................................................................................................................................... 31 表 10：模式掩码 ......................................................................................................................................... 32 表 11：CFG-MSG 有效载荷 ....................................................................................................................... 33 表 12：CFG_RST 有效载荷 ....................................................................................................................... 34 表 13：CFG_RATE 有效载荷..................................................................................................................... 35 表 14：参考文档 ......................................................................................................................................... 37 表 15：术语缩写 ......................................................................................................................................... 37 表 16：GNSS 标识符 ................................................................................................................................. 40 表 17：默认配置 ......................................................................................................................................... 41 上海移远通信技术股份有限公司 5 / 41 L76K&L26K GNSS 协议规范 图片索引 图 1：NMEA 协议消息结构 .......................................................................................................................... 8 图 2：CASIC 语句结构............................................................................................................................... 27 上海移远通信技术股份有限公司 6 / 41 L76K&L26K GNSS 协议规范 1 引言 移远通信 L76K 和 L26K GNSS 模块支持 GPS、BeiDou、GLONASS 和 QZSS 定位，默认支持 GPS + BeiDou。可以同时快速捕获跟踪 GPS L1 C/A、GLONASS L1、BeiDou B1 和 QZSS L1 频段，使该模块 成为各种垂直行业实现精准定位和导航的理想解决方案。 本文档主要介绍用于控制和配置模块所需的软件命令；所述命令是由芯片供应商定义的 NMEA 专用语 句（PCAS 命令）和 CASIC 指令。模块还支持通过 NMEA 0183 通用协议和 CASIC 协议输出语句上报 GNSS 信息。 备注 1. L76K 和 L26K 默认支持 GPS + BeiDou；QZSS 默认一直使能，不可禁用。 2. 请使用本文档列出的命令控制或配置模块；对本文档未列出的其他命令情况，移远通信不承担任何责 任。 上海移远通信技术股份有限公司 7 / 41 L76K&L26K GNSS 协议规范 2 NMEA 协议 2.1. NMEA 协议消息结构 每一帧的起始字段，固定 均为 $ 地址字段，包含了Talker ID和语句的属性 以 * 开始，校验和为8位 异或的校验和转换成的十六 进制的数 数据字段，使用 , 隔开 结束字符，固定为 $ () [,] * 校验和的计算范围 图 1：NMEA 协议消息结构 表 1：NMEA 语句结构 字段 $ 描述 NMEA 语句的起始字段（Hex 0x24）。 NMEA 通用语句： 通用地址字段由 5 个字符（大写字母）组成。通用地址字段前两个字母是发送设备标识符 （TalkerID），见表 2：发送设备标识符助记码（TalkerID），用于定义所传输数据的定位 模式。通用地址字段的后三个字符为通用语句标识符（SentenceFormatter），用于定义语 句中其它数据的格式和类型。 NMEA 专用语句： 专用地址字段由专用字符'P'、制造商助记码（三个字符）、以及可选附加字符组成。其 中制造商助记码用来标识发出一个专用语句的发送设备。 语句中的数据字段跟在定界符','之后。 由于存在可变长度字段和空字段，只有通过观察字段定界符','才能确定特定数据字段 在一条语句中的位置。因而应通过对定界符的计数来确定字段位置，而不应通过对接收字 符总个数的计数来确定字段位置。 上海移远通信技术股份有限公司 8 / 41 L76K&L26K GNSS 协议规范 所有的语句中都应包含校验和字段。校验和字段是语句中的最后一个字段，在校验和定界 符'*'之后。 校验和是对语句中所有字符的 8 位（不包括起始和结束位）进行异或运算，所有字符是指 在定界符'$'与'*'之间，但不包括这些定界符的全部字符，包括','在内。 NMEA 语句的结束字符（Hex 0x0D 0x0A）。 表 2：发送设备标识符助记码（TalkerID） GNSS 星系配置 GPS GLONASS BeiDou QZSS 组合星系 TalkerID GP GL BD GP GN 备注 QZSS 和 GPS 星系配置下均为 GP；有关卫星标识符的详情，请参考表 16：GNSS 标识符。 2.2. 通用语句 本章节介绍模块支持的 NMEA 0183 通用语句。 2.2.1. RMC RMC 表示推荐的最少专用 GNSS 数据。本语句包含 GNSS 接收机提供的时间、日期、位置、航迹向 和速度数据。 类型： 输出 上海移远通信技术股份有限公司 9 / 41 L76K&L26K GNSS 协议规范 格式： $RMC,,,,,,,,,,,,,* 参数： 字段 $ RMC 格式 单位 示例 描述 - - 字符 - 字符 - hhmmss.sss - 字符 - ddmm.mmmmm - 字符 - dddmm.mmmmm - 字符 - 十进制 节 $ GN RMC 071556.000 A 3149.29103 N 11706.92916 E 0.00 NMEA 语句的起始字段。 发送设备标识符助记码（TalkerID），详见 表 2：发送设备标识符助记码（TalkerID）。 推荐的最少专用 GNSS 数据。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 定位系统状态。 A = 数据有效 V = 无效 D = 差分 纬度。 dd：度（00~90） mm：分（00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 纬度方向。 N= 北 S= 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 经度方向。 E= 东 W= 西 数据无效时，此字段为空。 对地速度。可变长度。 数据无效时，此字段为空。 上海移远通信技术股份有限公司 10 / 41 十进制 ddmmyy - - 字符 字符 十六进制 字符 度 0.00 - 250420 - - - - - A - V - *09 - - L76K&L26K GNSS 协议规范 对地真航向。可变长度。最大值：359.9。 数据无效时，此字段为空。 日期。 dd：日 mm：月 yy：年 磁偏角，暂不支持。 磁偏角方向，暂不支持。 模式指示。 A = 自主模式，卫星系统处于非差分定位 模式 D = 差分模式，卫星系统处于伪距差分定 位模式；基于地面站或 SBAS 的修正 E = 估算（航位推算）模式 N = 无定位，卫星系统没有用于位置定位， 或定位无效 导航状态： S = 安全（Safe） C = 警告（Caution） U = 不安全（Unsafe） V = 导航状态无效，设备不能提供导航状 态指示 校验和。 回车换行。 示例： $GNRMC,071556.000,A,3149.29103,N,11706.92916,E,0.00,0.00,250420,,,A,V*09 备注 QZSS 和 GPS 星系配置下均为 GP；有关卫星标识符的详情，请参考表 16：GNSS 标识符。 上海移远通信技术股份有限公司 11 / 41 L76K&L26K GNSS 协议规范 2.2.2. GGA GGA 提供全球定位系统定位数据。本语句包含 GNSS 接收机提供的时间、位置和定位相关数据。 类型： 输出。 格式： $GGA,,,,,,,,,,M,,M,,* 参数： 字段 $ GGA 格式 单位 示例 描述 - - 字符 - 字符 - hhmmss.sss - ddmm.mmmmm - 字符 - dddmm.mmmmm - 字符 - $ GN GGA 071556.000 3149.29103 N 11706.92916 E NMEA 语句的起始字段。 发送设备标识符助记码（TalkerID）， 详见表 2：发送设备标识符助记码 （TalkerID）。 GGA 提供全球定位系统定位数据。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数 纬度。 dd：度（00~90） mm：分（00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 纬度方向。 N= 北 S= 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 经度方向。 上海移远通信技术股份有限公司 12 / 41 十进制，1 位 - 1 1) 十进制，2 位 十进制 十进制 M 字符 十进制 M 字符 十六进制 字符 - 21 - 0.7 米 75.7 - M 米 -5.0 - M - - - - - *69 - - L76K&L26K GNSS 协议规范 E= 东 W= 西 数据无效时，此字段为空。 GPS 定位模式/状态指示。 0 = 定位不可用或无效 1 = GPS SPS 模式，定位有效 2 = 差分 GPS，SPS 模式，或 SBAS， 定位有效 6 = 估算（航位推算）模式 使用的卫星数。 水平精度因子。 平均海平面以上海拔（大地水准面）。 数据无效时，此字段为空 数据无效时，此字段为空。 大地水准面差距（WGS84 基准面与平 均海平面之间的差值）。 数据无效时，此字段为空。 数据无效时，此字段为空。 差分卫星导航系统数据龄期，暂不支 持。 分基准站标识号，暂不支持。 校验和。 回车换行。 示例： $GNGGA,071556.000,3149.29103,N,11706.92916,E,1,21,0.7,75.7,M,-5.0,M,,*69 备注 1. QZSS 和 GPS 星系配置下均为 GP；有关卫星标识符的详情，请参考表 16：GNSS 标识 符。 2. NMEA 0183 协议指示 GGA 消息为 GPS 系统特有；但当接收器配置为多星系时，GGA 消息的内容将 从多星系解决方案中生成。 3. 1) NMEA 0183 协议定义的使用中卫星数量范围为 00~12，然而，在多星系解决方案中，使用的卫星数 量可能超过 12 颗。 上海移远通信技术股份有限公司 13 / 41 L76K&L26K GNSS 协议规范 2.2.3. GSV GSV 表示可视的 GNSS 卫星。本语句包含可视的卫星数、卫星标识号、仰角、方位角和信噪比。每次 传送，一个 GSV 语句只能包含最多 4 颗卫星的数据，因此可能需要多个语句才能获得完整的信息。由于 GSV 包含的卫星不用于定位解决方案，所以 GSV 语句指示的卫星可能比 GGA 多。 类型： 输出。 格式： $GSV,,,,,,,[, …],* 参数： 字段 格式 单位 示例 $ - - $ 字符 - GP GSV 字符 - 十进制 - 十进制 - 十进制 - 参数循环开始。循环次数：1~4 次 十进制 - 十进制 度 十进制 度 GSV 3 1 12 02 49 123 十进制 dB-Hz 43 参数循环结束 十进制 - 0 十六进制 - *66 字符 - - 描述 NMEA语句的起始字段。 发送设备标识符助记码（TalkerID）。 详见表2：发送设备标识符助记码（TalkerID）。 可视的GNSS卫星。 语句总数。范围：1~9。 语句号。范围：1~TotalNumSen。 可视的卫星总数。最大值：32。 卫星标识号。详见表 16：GNSS 标识符。 仰角。范围：00~90。 真方位角。范围：000~359。 载噪比（C/N0）。范围：00~99。 未跟踪时为空。 信号标识符。恒为 0。 校验和。 回车换行。 上海移远通信技术股份有限公司 14 / 41 L76K&L26K GNSS 协议规范 示例： $GPGSV,3,1,12,02,49,123,43,05,60,005,43,06,06,127,29,07,05,042,33,0*66 $GPGSV,3,2,12,13,79,139,44,15,55,225,44,18,12,314,36,20,44,055,42,0*6C $GPGSV,3,3,12,29,48,275,42,30,20,069,38,193,69,062,42,195,46,160,42,0*6A $BDGSV,4,1,16,01,43,135,36,03,54,193,36,04,31,120,34,06,43,189,35,0*7B $BDGSV,4,2,16,07,06,196,28,08,63,008,35,09,30,194,32,10,09,210,29,0*74 $BDGSV,4,3,16,13,59,342,38,16,50,184,37,27,57,183,40,30,53,295,39,0*77 $BDGSV,4,4,16,32,65,305,41,38,68,046,40,39,59,181,38,41,40,042,38,0*78 备注 1. QZSS 和 GPS 星系配置下均为 GP；有关卫星标识符的详情，请参考表 16：GNSS 标识 符。 2. 'GN'标识符不可用于该语句。如果可以多个卫星系统可视，则设备输出多条 GSV 语句，用不同的 发送设备标识符表示相应的卫星。 2.2.4. GSA GSA 表示 GNSS 精度因子（DOP）与有效卫星。本语句包含 GNSS 接收机工作模式，GGA 或 GNS 语句报告的导航解算中用到的卫星以及精度因子的值。 类型： 输出。 格式： $GSA,,,,…,,,,* 参数： 字段 $ GSA 格式 字符 字符 字符 单位 - - 示例 $ GN GSA A 描述 NMEA语句的起始字段。 发送设备标识符助记码（TalkerID）。 详见表2：发送设备标识符助记码（TalkerID）。 GNSS精度因子（DOP）与有效卫星。 模式。 M = 手动，强制用于 2D 或 3D 定位模式 A = 自动，允许 2D/3D 定位模式自动变换 上海移远通信技术股份有限公司 15 / 41 十进制 - 参数循环开始。循环次数：12 次 十进制 - 参数循环结束 十进制 - 十进制 - 十进制 - 十进制 - 十六进制 - 字符 - L76K&L26K GNSS 协议规范 定位模式。 1 = 定位不可用 3 2 = 2D 定位 3 = 3D 定位 解算中用到的卫星标识号。 10 详见表 16：GNSS 标识符。 2.5 位置精度因子。最大值为 99.0。 2.0 水平精度因子。最大值为 99.0。 1.5 垂直精度因子。最大值为 99.0。 1 GNSS 系统标识符。详见表 16：GNSS 标识符。 *35 校验和。 - 回车换行。 示例： $GNGSA,A,3,10,13,15,20,,,,,,,,,2.5,2.0,1.5,1*35 备注 1. QZSS 和 GPS 星系配置下均为 GP；有关卫星标识符的详情，请参考表 16：GNSS 标识 符。 2. 如果用于定位导航的卫星少于 12 颗，则剩余的字段将为空。如果超过 12 颗卫星用于定位导 航，则仅输出前 12 颗卫星的卫星标识号。 2.2.5. VTG VTG 语句包含相对于地面的实际航向和速度。 类型： 输出。 格式： $VTG,,T,,M,,N,,K,* 上海移远通信技术股份有限公司 16 / 41 参数： 字段 $ VTG T M N K 格式 字符 字符 十进制 字符 十进制 字符 十进制 字符 十进制 字符 字符 十六进制 字符 L76K&L26K GNSS 协议规范 单位 度 度 节 km/h - - - 示例 $ GN VTG 0.00 T M 0.00 N 0.00 K A *23 - 描述 NMEA 语句的起始字段。 发送设备标识符助记码（TalkerID）。 详见表 2：发送设备标识符助记码（TalkerID）。 航向超过地面和地面速度。 对地航向（真北）。 - 对地航向（磁北）。暂不支持。 - 对地速度。 - 对地速度。 模式指示。 A = 自主模式，卫星系统处于非差分定位模式 E = 估算（航位推算）模式 N = 无定位，卫星系统没有用于位置定位，或定 位无效 校验和。 回车换行。 示例： $GNVTG,0.00,T,,M,0.00,N,0.00,K,A*23 备注 QZSS 和 GPS 星系配置下均为 GP；有关卫星标识符的详情，请参考表 16：GNSS 标识符。 上海移远通信技术股份有限公司 17 / 41 L76K&L26K GNSS 协议规范 2.2.6. GLL GLL 表示地理位置—纬度和经度。本语句包含接收机的纬度与经度、定位时间和状态。 类型： 输出。 格式： $GLL,,,,,,,* 参数： 字段 $ GLL 格式 字符 字符 单位 - ddmm.mmmmm - 字符 - dddmm.mmmmm - 字符 - hhmmss.sss - 示例 描述 $ GN GLL 3149.29103 N 11706.92916 E 071556.000 NMEA 语句的起始字段。 发送设备标识符助记码（TalkerID），详见 表 2：发送设备标识符助记码（TalkerID）。 地理位置—纬度和经度。 纬度。 dd：度（00~90） mm：分（00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 纬度方向。 N= 北 S= 南 数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmmm：分的十进制小数 数据无效时，此字段为空。 经度方向。 E= 东 W= 西 数据无效时，此字段为空。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） 上海移远通信技术股份有限公司 18 / 41 字符 - A 字符 十六进制 字符 - A - *45 - - L76K&L26K GNSS 协议规范 sss：秒的十进制小数（可变长度，1 到 3 位） 定位系统状态。 V = 无效 A = 自主模式 模式指示。 A = 自主模式，卫星系统处于非差分定位 模式 E = 估算（航位推算）模式 N = 无定位，卫星系统没有用于位置定 位，或定位无效 校验和。 回车换行。 示例： $GNGLL,3149.29103,N,11706.92916,E,071556.000,A,A*45 备注 QZSS 和 GPS 星系配置下均为 GP；有关卫星标识符的详情，请参考表 16：GNSS 标识符。 2.2.7. TXT TXT 表示文本传送。本语句用于文本消息的传送，较长的文本信息可用多语句传送。 类型： 输出。 格式： $TXT,,,,* 参数： 字段 $ 格式 字符 单位 - 示例 $ GP 描述 NMEA 语句的起始字段。 发送设备标识符助记码（TalkerID），始终为 上海移远通信技术股份有限公司 19 / 41 TXT 字符 - 十进制 - 十进制 - 十进制 - 字符 - 十六进制 - 字符 - L76K&L26K GNSS 协议规范 'GP'。 TXT 文本传送。 01 语句总数。范围：01~99。 01 02 MA=CASIC 语句编号。范围：01~99。 文本识别符。 00 = 错误信息 01 = 警告信息 02 = 通用信息 03 = 用户信息 文本信息 *27 校验和。 - 回车换行。 示例： $GPTXT,01,01,02,MA=CASIC*27 $GPTXT,01,01,01,ANTENNA OPEN*25 2.2.8. ZDA ZDA 表示时间与日期。本语句主要是用于输出 UTC 时间，日、月、年及本地时区。 类型： 输出。 格式： $ZDA,,,,,,* 参数： 字段 $ ZDA 格式 字符 字符 单位 - 示例 $ - GN - ZDA 描述 NMEA 语句的起始字段。 发送设备标识符助记码（TalkerID）。 详见表 2：发送设备标识符助记码（TalkerID）。 时间与日期。 上海移远通信技术股份有限公司 20 / 41 L76K&L26K GNSS 协议规范 hhmmss.sss - 十进制 日 十进制 月 十进制 年 十进制 - 十进制 - 十六进制 - 字符 - 053712.000 21 定位的 UTC 时间： hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） sss：秒的十进制小数（可变长度，1 到 3 位） 日。范围：01~31。 10 月。范围：01~12。 2021 年。 00 暂不支持。恒为 00。 00 暂不支持。恒为 00。 *49 校验和。 - 回车换行。 示例: $GNZDA,053712.000,21,10,2021,00,00*49 备注 QZSS 和 GPS 星系配置下均为 GP；有关卫星标识符的详情，请参考表 16：GNSS 标识符。 2.3. PCAS 语句（专用语句） 本章节介绍 L76K 和 L26K 模块支持的 PCAS 消息（由芯片供应商定义的 NMEA 专用语句）。 2.3.1. PCAS01 配置 NMEA 串口波特率。 类型： 设置。 格式： $PCAS01,* 上海移远通信技术股份有限公司 21 / 41 参数： 字段 格式 单位 十进制 bps 示例： $PCAS01,1*1D 描述 支持以下波特率： 0 = 4800 1 = 9600 2 = 19200 3 = 38400 4 = 57600 5 = 115200 L76K&L26K GNSS 协议规范 2.3.2. PCAS02 设置定位频率。 类型： 设置。 格式： $PCAS02,* 参数： 字段 格式 单位 十进制 毫秒 描述 定位间隔： 1000：设置定位频率为 1 Hz 500：设置定位频率为 2 Hz 200：设置定位频率为 5 Hz 示例： $PCAS02,1000*2E 上海移远通信技术股份有限公司 22 / 41 L76K&L26K GNSS 协议规范 备注 如果设置参数小于 1000 时，需要将 NMEA 语句输出类型设置成单语句输出，并且修改波特率 为 115200 bps。 2.3.3. PCAS03 配置 NMEA 语句输出类型和输出频率。 类型： 设置。 格式： $PCAS03,,,,,,,,,,,,,,* 参数： 字段 格式 十进制，1 位 十进制，1 位 十进制，1 位 十进制，1 位 十进制，1 位 十进制，1 位 单位 - 描述 GGA 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 GLL 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 GSA 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 GSV 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 RMC 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 VTG 语句输出频率： 上海移远通信技术股份有限公司 23 / 41 十进制，1 位 - 十进制，1 位 - - - - - - - - - - - - - L76K&L26K GNSS 协议规范 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 ZDA 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 ANT 语句输出频率： 每定位 N（1~9）次输出 1 次 0 表示不输出 空表示保留上一次配置 恒为 0 恒为 0 预留 预留 恒为 0 恒为 0 示例： $PCAS03,1,1,1,1,1,1,1,1,0,0,,,0,0*02 备注 NMEA 专用语句中的 ANT 信息包含在 NMEA 通用 TXT 语句中。 上海移远通信技术股份有限公司 24 / 41 L76K&L26K GNSS 协议规范 2.3.4. PCAS04 配置星系。 类型： 设置。 格式： $PCAS04,* 参数： 字段 格式 单位 十进制 - 描述 GNSS星系配置： 1 = GPS 2 = BeiDou 3 = GPS + BeiDou（默认） 4 = GLONASS 5 = GPS + GLONASS 6 = BeiDou + GLONASS 7 = GPS + BeiDou + GLONASS 示例： $PCAS04,3*1A 备注 QZSS 默认使能且不支持配置。 上海移远通信技术股份有限公司 25 / 41 2.3.5. PCAS10 重启模块。 类型： 输入。 格式： $PCAS10,* 参数： 字段 格式 单位 十进制，1 位 - 示例 $PCAS10,0*1C L76K&L26K GNSS 协议规范 描述 重启模式： 0 = 热启动 1 = 温启动 2 = 冷启动 3 = 冷启动并恢复出厂设置 上海移远通信技术股份有限公司 26 / 41 L76K&L26K GNSS 协议规范 3 CASIC 协议 本章介绍由芯片供应商定义的 CASIC 专有协议。 3.1. CASIC 语句结构 起始字符：固定为 0xBA 0xCE 2个字节 1 个字节 1 个字节 长度可变 为4的倍数 4 个字节 Header Len Class ID 校验和计算的范围 Payload Checksum 图 2：CASIC 语句结构 表 3：CASIC 语句结构 字段 Header Len Class ID Payload Checksum 描述 CASIC 语句的起始字符。恒为 0xBA 0XCE。 有效载荷（Payload）的长度（不包括 Header、Len、Class、ID 和 Checksum）。 语句类型，即当前语句所属的基本子集。 语句编号。 有效载荷，为数据包实际传输的内容。长度可变，为 4 的倍数。 校验和是语句中的最后一个字段，是从 Len 至 Payload 所有数据按字（1 个字占 4 个字节）的累加和。 上海移远通信技术股份有限公司 27 / 41 L76K&L26K GNSS 协议规范 校验和计算示例： Checksum = (ID << 24) + (Class << 16) + Len; for (i = 0; i < (Len / 4); i++) { Checksum = Checksum + Payload [i]; } 备注 针对用于查询或获取参数配置的命令，其有效载荷为空，有效载荷长度为 0。 3.1.1. 数据类型 表 4：数据类型 缩写 U1 I1 U2 I2 U4 I4 R4 R8 类型 无符号字符 有符号字符 无符号短整型 有符号短整型 无符号长整型 有符号长整型 IEEE754 单精度 IEEE754 双精度 3.1.2. 语句概述 表 5：语句概述 语句 ACK-NACK ACK-ACK CFG-PRT 长度（字节） 1 1 2 2 4 4 4 8 备注 补码 补码 补码 - 编号 0x05 0x00 0x05 0x01 0x06 0x00 上海移远通信技术股份有限公司 28 / 41 CFG-MSG CFG-RST CFG-RATE NMEA-GGA NMEA-GLL NMEA-GSA NMEA-GSV NMEA-RMC NMEA-VTG NMEA-ZDA 0x06 0x01 0x06 0x02 0x06 0x04 0x4E 0x00 0x4E 0x01 0x4E 0x02 0x4E 0x03 0x4E 0x04 0x4E 0x05 0x4E 0x08 L76K&L26K GNSS 协议规范 3.2. CASIC 语句 3.2.1. ACK 3.2.1.1. ACK-NACK（0x05 0x00） 该语句为信息响应语句，主要用于回应未正确接收。 类型： 输出。 结构： 头 长度（字节） 标识符 0xBA 0xCE 4 0x05 0x00 有效载荷 详见表 6：ACK-NACK 有效载荷。 校验和 4 字节 上海移远通信技术股份有限公司 29 / 41 表 6：ACK-NACK 有效载荷 字符偏移 0 1 2 数据类型 U1 U1 U2 比例缩放 - 命名 ClsID MsgID Res L76K&L26K GNSS 协议规范 单位 - 描述 未正确接收语句的类型。 未正确接收语句的编号。 预留 3.2.1.2. ACK-ACK（0x05 0x01) 该语句为消息响应语句，主要用于回应正确接收。 类型： 输出。 结构： 头 长度（字节） 0xBA 0xCE 4 标识符 0x05 0x01 有效载荷 详见表 7：ACK-ACK 有效载荷。 校验和 4 字节 表 7：ACK-ACK 有效载荷 字符偏移 0 1 2 数据类型 比例缩放 命名 U1 - ClsID U1 - MsgID U2 - Res 单位 描述 - 正确接收语句的类型 - 正确接收语句的编号 - 预留 上海移远通信技术股份有限公司 30 / 41 L76K&L26K GNSS 协议规范 3.2.2. CFG 3.2.2.1. CFG-PRT（0x06 0x00) 该语句主要用于查询/配置串口的工作模式。 类型： 查询/设置。 结构： 头 0xBA 0xCE 长度（字节） 有效载荷长度 标识符 0x06 0x00 有效载荷 详见表 8：CFG-PRT 有效载荷。 校验和 4 字节 表 8：CFG-PRT 有效载荷 字符偏移 0 1 2 4 数据类型 比例缩放 命名 单位 描述 U1 - U1 - U2 - U4 - PortID - ProtoMask - Mode - BaudRate bps 串口 ID。例如，0 表示 UART0。 协议控制掩码。每个端口均同时支持多个协 议，若相应的 bit 为 1 则表示使能该协议； 详情请参考 表 9：协议控制掩码。 UART 工作模式掩码； 详情请参考表 10：模式掩码。 波特率 表 9：协议控制掩码 掩码 Bit 0 Bit 1 Bit 4 Bit 5 描述 1 = 二进制协议输入 1 = 文本协议输入 1 = 二进制协议输出 1 = 文本协议输出 上海移远通信技术股份有限公司 31 / 41 表 10：模式掩码 掩码 值 [6:7] 00 01 10 11 [9:11] 10x 001 000 x1x [12:13] 00 01 10 11 描述 5 bits 6 bits 7 bits 8 bits 无校验 奇校验 偶校验 预留 1 个停止位 1.5 个停止位 2 个停止位 预留 L76K&L26K GNSS 协议规范 示例： //查询： //发送： BA CE 00 00 06 00 00 00 06 00 //响应： BA CE 08 00 06 00 01 07 C0 08 00 C2 01 00 09 C9 C7 08 // UART1 当前配置（无效） BA CE 08 00 06 00 00 33 C0 08 00 4B 00 00 08 7E C6 08 // UART0 当前配置 //ACK： BA CE 04 00 05 01 06 00 00 00 0A 00 05 01 //配置： //发送： //配置当前 UART 口波特率为 9600 bps BA CE 08 00 06 00 FF 33 C0 08 80 25 00 00 87 59 C6 08 //ACK： BA CE 04 00 05 01 06 00 00 00 0A 00 05 01 上海移远通信技术股份有限公司 32 / 41 L76K&L26K GNSS 协议规范 3.2.2.2. CFG-MSG（0x06 0x01） 该语句主要用于查询和配置 NMEA 语句发送的频率。 类型： 查询/设置。 结构： 头 0xBA 0xCE 长度（字节） 有效载荷长度 标识符 0x06 0x01 有效载荷 校验和 详见表 11：CFG-MSG 有效载荷。 4 字节 表 11：CFG-MSG 有效载荷 字符偏移 数据类型 比例缩放 0 U1 - 1 U1 - 名称 ClsID MsgID 2 U2 - Rate 单位 描述 - 语句类型，详见表 5：语句概述 - 语句编号，详见表 5：语句概述 NMEA 语句发送的频率，范围 0~9。 0：不输出 - N：每 N 次定位，输出一次；N 的取值为 1~9 0xFFFF：立即输出一次，相当于查询输出 示例： //查询： //发送： BA CE 00 00 06 01 00 00 06 01 //响应： BA CE 04 00 06 01 03 11 00 00 07 11 06 01 //ACK： BA CE 04 00 05 01 06 01 00 00 0A 01 05 01 //配置： //发送： //配置 GGA 语句输出频率 BA CE 04 00 06 01 4E 00 01 00 52 00 07 01 上海移远通信技术股份有限公司 33 / 41 //ACK： BA CE 04 00 05 01 06 01 00 00 0A 01 05 01 L76K&L26K GNSS 协议规范 3.2.2.3. CFG-RST（0x06 0x02) 此语句主要用于重启模块或者清除保存的数据结构。 类型： 命令。 结构： 头 0xBA 0xCE 长度（字节） 标识符 4 0x06 0x02 有效载荷 详见表 12：CFG_RST 有效载荷 校验和 4 字节 表 12：CFG_RST 有效载荷 字符偏移 数据类型 0 U2 2 U1 3 U1 比例缩放 名称 单位 - NavBbrMask - - ResetMode - - StartMode - 描述 清除由电池供电的 RAM。若掩码某位为 1， 则表示清除该位表示的数据。 Bit 0 = 星历 Bit 1 = 历书 Bit 2 = 健康信息 Bit 3 = 电离层参数 Bit 4 = 接收机定位信息 Bit 5 = 时钟漂移（时钟频偏） Bit 6 = 晶振参数 Bit 7 = UTC 修正参数 Bit 8 = RTC Bit 9 = 配置信息 复位模式。 0 = 立即硬件复位（通过 Watchdog 实现） 1 = 受控软件复位 2 = 受控软件复位（仅 GPS） 4 = 关机后硬件复位（通过 Watchdog 实现） 启动模式。 0 = 热启动 1 = 温启动 2 = 冷启动 3 = 出厂启动 上海移远通信技术股份有限公司 34 / 41 示例： //配置： //发送： //清除配置信息 BA CE 04 00 06 02 FF 01 00 00 03 02 06 02 //ACK： BA CE 04 00 05 01 06 02 00 00 0A 02 05 01 L76K&L26K GNSS 协议规范 3.2.2.4. CFG-RATE（0x06 0x04） 此语句主要用于查询和配置定位的间隔时间。 类型： 查询/设置。 结构： 头 长度（字节） 0xBA 0xCE 4 标识符 0x06 0x04 有效载荷 详见表 13：CFG_RATE 有效载荷 校验和 4 字节 表 13：CFG_RATE 有效载荷 字符偏移 数据类型 比例缩放 0 U2 - 2 U2 - 名称 Interval Res 单位 毫秒 - 示例： //查询： //发送： BA CE 00 00 06 04 00 00 06 04 //响应： BA CE 04 00 06 04 E8 03 00 00 EC 03 06 04 //ACK: 描述 两次定位间的间隔时间。 例：200、500、1000 预留 上海移远通信技术股份有限公司 35 / 41 BA CE 04 00 05 01 06 04 00 00 0A 04 05 01 //配置： //发送： //配置定位速率为 2 Hz BA CE 04 00 06 04 F4 01 00 00 F8 01 06 04 //ACK： BA CE 04 00 05 01 06 04 00 00 0A 04 05 01 L76K&L26K GNSS 协议规范 上海移远通信技术股份有限公司 36 / 41 L76K&L26K GNSS 协议规范 4 附录 A 参考文档及术语缩写 表 14：参考文档 文档名称 [1] Quectel_L76K_硬件设计手册 [2] Quectel_L76K_EVB_用户指导 [3] Quectel_L76K_参考设计手册 [4] Quectel_L26K_硬件设计手册 [5] Quectel_L26K_EVB_用户指导 [6] Quectel_L26K_参考设计手册 表 15：术语缩写 缩写 2D 3D ACK ANT CASIC CFG COG COGM COGT 英文全称 中文全称 2 Dimension 2维 3 Dimension 3维 Acknowledgement 确认消息 Antenna China Aerospace Science & Industry Corporation Configure 天线 中国航天科工集团有限公司 配置 Course over Ground 对地航向 Course over Ground (in Magnetic North Course 对地航向（磁北） Direction) Course over Ground (in True North Course 对地航向（真北） Direction) 上海移远通信技术股份有限公司 37 / 41 L76K&L26K GNSS 协议规范 C/N0 DGPS DOP GGA GLL GLONASS GNS GNSS GPS GSA GSV HDOP NACK NMEA PDOP PPS QZSS RMC RTC SBAS SNR SOG SPS TXT UART Carrier-to-Noise-Density Ratio 载噪比 Differential Global Positioning System 差分全球定位系统 Dilution of Precision 精度因子 Global Positioning System Fix Data 全球定位系统定位数据 Geographic Position-Latitude and Longitude 地理位置—纬度/经度 Global Navigation Satellite System (Russian) 格洛纳斯卫星导航系统（俄罗斯） Global Network Service 全球网络服务 Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 GNSS DOP and Active Satellites GNSS 精度因子（DOP）与有效卫星 GNSS Satellites in View 可视的 GNSS 卫星 Horizontal Dilution of Precision 水平精度因子 Negative Acknowledgement 否定消息 NMEA (National Marine Electronics Association) NMEA（美国国家海洋电子协会）0183 0183 Interface Standard 接口标准 Position Dilution of Precision 位置精度因子 Pulse Per Second 秒脉冲 Quasi-Zenith Satellite System 准天顶卫星系统（日本） Recommended Minimum Specific GNSS Data 推荐的最少专用 GNSS 数据 Real-Time Kinematic 实时时钟 Satellite-Based Augmentation System 星基增强系统 Signal-to-Noise Ratio 信噪比 Speed over Ground 对地航速 Standard Positioning Service 标准定位服务 Text Transmission 文本传送 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 上海移远通信技术股份有限公司 38 / 41 UTC VDOP VTG WGS84 ZDA Coordinated Universal Time Vertical Dilution of Precision Course Over Ground & Ground Speed World Geodetic System 1984 Time & Date L76K&L26K GNSS 协议规范 协调世界时 垂直精度因子 对地航向和对地速度 世界大地坐标系 1984 时间与日期 上海移远通信技术股份有限公司 39 / 41 L76K&L26K GNSS 协议规范 5 附录 B GNSS 标识符 表 16：GNSS 标识符 卫星系统 GPS GLONASS BeiDou QZSS 系统标识符 1 2 4 5 卫星标识号 1~32 65~88 1~63 193~197 信号标识号/信号通道 1 = L1 C/A 1 = L1 1 = B1 1 = L1 上海移远通信技术股份有限公司 40 / 41 L76K&L26K GNSS 协议规范 6 附录 C 默认配置 表 17：默认配置 项目 NMEA 端口波特率 参考基准 定位速率 DGPS 模式 NMEA 标准语句 GNSS 配置 默认配置 9600 bps WGS84 1 Hz 关闭 RMC、GGA、GSV、GSA、VTG、GLL、TXT 和 ZDA GPS + BeiDou 上海移远通信技术股份有限公司 41 / 41

L26-DR&L26-P&L26-T&LC98S Series GNSS Protocol Specification GNSS Module Series Version: 1.3 Date: 2023-09-12 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 1 / 113 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 2 / 113 GNSS Module Series About the Document Document Information Title L26-DR&L26-P&L26-T&LC98S Series GNSS Protocol Specification Subtitle GNSS Module Series Document Type GNSS Protocol Specification Document Status Released Revision History Version Date Description 1.0 2020-02-13 Initial 1. Updated the default constellation combination of L26-P module to GPS + BeiDou in Chapter 4. 2. Updated the default baud rate of L26-P module from 115200 bps to 1.1 2020-03-17 460800 bps in Chapter 4. 3. Updated the default NMEA output messages in Chapter 3.1.1, Chapter 3.2.1 and Chapter 4. 4. Added the message $PSTMCPU in Chapter 3.2.2.11. 1. Incorporated the information of L26-DR series and LC98S into this document. 2. Added RLM sentence formatter (Chapter 2.2.10). 3. Added the following proprietary NMEA messages: ⚫ PSTMSETPAR,1122 (Chapter 2.3.26); ⚫ PSTMGETPAR,1122 (Chapter 2.3.27); 1.2 2022-10-20 ⚫ PSTMPOSHOLD (Chapter 2.3.45); ⚫ PSTMTRAIMSTATUS (Chapter 2.3.46); ⚫ PSTMTRAIMUSED (Chapter 2.3.47); ⚫ PSTMTRAIMRES (Chapter 2.3.48); ⚫ PSTMTRAIMREMOVED (Chapter 2.3.49). 4. Updated PSTMDRSENMSG (Chapter 2.3.34). L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 3 / 113 GNSS Module Series Version Date Description 5. Added table of GNSS Numbering (Table 16). 1. Incorporated the information of L26-DR (AA), L26-T (B) and L26-T (D) into this document. 2. Added the following proprietary NMEA messages: ⚫ PSTMSBASSERVICE (Chapter 2.3.11); ⚫ PSTMSETPAR,1300 (Chapter 2.3.28); ⚫ PSTMNOTCH (Chapter 2.3.32 ); ⚫ PSTMNOTCHSTATUS (Chapter 2.3.33); ⚫ PSTMPRES (Chapter 2.3.41); ⚫ PSTMVRES (Chapter 2.3.42); ⚫ PSTMPV (Chapter 2.3.43); ⚫ PSTMNAVM (Chapter 2.3.44). 3. Added a note about GSV when the LC98S module is configured with NMEA V3.01 protocol (Chapter 2.2.4). 1.3 2023-09-12 4. Added a note about configuring RLM message output (Chapter 2.2.10). 5. Added a note about the module response if it enters the Standby mode immediately after receiving $PSTMFORCESTANDBY (Chapter 2.3.17). 6. Added a note about baud rates supported on L26-DR series module (Chapter 2.3.18). 7. Updated the description of field (Chapter 2.3.20). 8. Added 0x02 supported by on L26-DR (ADRC) (Chapters 2.3.26 & 2.3.27). 9. Added information that the LC98S module does not support $PSTMANTENNASTATUS and instructions on how to enable the message output on L26-P (Chapter 2.3.31). 10. Added a note about configuring $PSTMSBAS message output for the LC98S module (Chapter 2.3.39). L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 4 / 113 GNSS Module Series Contents About the Document ............................................................................................................................... 3 Contents................................................................................................................................................... 5 Table Index............................................................................................................................................... 8 1 Introduction ...................................................................................................................................... 9 2 NMEA Protocol ................................................................................................................................11 2.1. Structure of NMEA Protocol Messages...............................................................................11 2.2. Standard Messages ........................................................................................................... 13 2.2.1. RMC ........................................................................................................................... 13 2.2.2. GGA............................................................................................................................ 16 2.2.3. GNS ............................................................................................................................ 18 2.2.4. GSV ............................................................................................................................ 21 2.2.5. GSA ............................................................................................................................ 23 2.2.6. VTG ............................................................................................................................ 25 2.2.7. GLL ............................................................................................................................. 27 2.2.8. ZDA ............................................................................................................................ 29 2.2.9. GST ............................................................................................................................ 30 2.2.10. RLM ............................................................................................................................ 32 2.3. PSTM Messages................................................................................................................ 33 2.3.1. PSTMINITGPS ........................................................................................................... 33 2.3.2. PSTMINITTIME .......................................................................................................... 35 2.3.3. PSTMCLREPHS ......................................................................................................... 36 2.3.4. PSTMDUMPEPHEMS ................................................................................................ 36 2.3.5. PSTMCLRALMS ......................................................................................................... 45 2.3.6. PSTMDUMPALMANAC .............................................................................................. 45 2.3.7. PSTMCOLD................................................................................................................ 50 2.3.8. PSTMWARM .............................................................................................................. 51 2.3.9. PSTMHOT .................................................................................................................. 51 2.3.10. PSTMSRR .................................................................................................................. 52 2.3.11. PSTMSBASSERVICE................................................................................................. 52 2.3.12. PSTMSBASONOFF.................................................................................................... 53 2.3.13. PSTMGETRTCTIME................................................................................................... 54 2.3.14. PSTMSETCONSTMASK ............................................................................................ 55 2.3.15. PSTMCFGCONST...................................................................................................... 56 2.3.16. PSTMPPS................................................................................................................... 57 2.3.16.1. Getting PPS Data: PPS_IF_PULSE_DATA_CMD ........................................ 59 2.3.16.2. Getting PPS Data: PPS_IF_TIMING_DATA_CMD ....................................... 60 2.3.16.3. Getting PPS Data: PPS_IF_POSITION_HOLD_DATA_CMD....................... 61 2.3.16.4. Getting PPS Data: PPS_IF_TRAIM_CMD.................................................... 62 2.3.16.5. Getting PPS Data: PPS_IF_TRAIM_USED_CMD........................................ 63 2.3.16.6. Getting PPS Data: PPS_IF_TRAIM_RES_CMD .......................................... 64 2.3.16.7. Getting PPS Data: PPS_IF_TRAIM_REMOVED_CMD................................ 65 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 5 / 113 GNSS Module Series 2.3.16.8. Setting PPS Data: PPS_IF_ON_OFF_CMD................................................. 66 2.3.16.9. Setting PPS Data: PPS_IF_OUT_MODE_CMD ........................................... 66 2.3.16.10. Setting PPS Data: PPS_IF_REFERENCE_TIME_CMD............................... 67 2.3.16.11. Setting PPS Data: PPS_IF_PULSE_DELAY_CMD ...................................... 68 2.3.16.12. Setting PPS Data: PPS_IF_CONSTELLATION_RF_DELAY_CMD ............. 68 2.3.16.13. Setting PPS Data: PPS_IF_PULSE_DURATION_CMD ............................... 69 2.3.16.14. Setting PPS Data: PPS_IF_PULSE_POLARITY_CMD ................................ 69 2.3.16.15. Setting PPS Data: PPS_IF_PULSE_DATA_CMD ........................................ 70 2.3.16.16. Setting PPS Data: PPS_IF_FIX_CONDITION_CMD.................................... 71 2.3.16.17. Setting PPS Data: PPS_IF_SAT_TRHESHOLD_CMD ................................ 72 2.3.16.18. Setting PPS Data: PPS_IF_ELEVATION_MASK_CMD ............................... 72 2.3.16.19. Setting PPS Data: PPS_IF_CONSTELLATION_MASK_CMD...................... 73 2.3.16.20. Setting PPS Data: PPS_IF_TIMING_DATA_CMD........................................ 74 2.3.16.21. Setting PPS Data: PPS_IF_POSITION_HOLD_DATA_CMD ....................... 74 2.3.16.22. Setting PPS Data: PPS_IF_AUTO_HOLD_SAMPLES_CMD ...................... 75 2.3.16.23. Setting PPS Data: PPS_IF_TRAIM_CMD .................................................... 76 2.3.17. PSTMFORCESTANDBY............................................................................................. 77 2.3.18. PSTMCFGPORT ........................................................................................................ 78 2.3.19. PSTMCFGTDATA ....................................................................................................... 79 2.3.20. PSTMCFGMSGL ........................................................................................................ 80 2.3.21. PSTMCFGAGPS ........................................................................................................ 84 2.3.22. PSTMIMUSELFTESTCMD ......................................................................................... 85 2.3.23. PSTMSETTHTRK ....................................................................................................... 86 2.3.24. PSTMSETTHPOS ...................................................................................................... 86 2.3.25. PSTMGETPAR,1500 .................................................................................................. 87 2.3.26. PSTMSETPAR,1122 ................................................................................................... 88 2.3.27. PSTMGETPAR,1122................................................................................................... 89 2.3.28. PSTMSETPAR,1300................................................................................................... 90 2.3.29. PSTMSAVEPAR ......................................................................................................... 91 2.3.30. PSTMRESTOREPAR ................................................................................................. 92 2.3.31. PSTMANTENNASTATUS ........................................................................................... 93 2.3.32. PSTMNOTCH ............................................................................................................. 94 2.3.33. PSTMNOTCHSTATUS ............................................................................................... 95 2.3.34. PSTMDRSENMSG ..................................................................................................... 96 2.3.34.1. IMU Temperature Message ( = 24) ................................................ 97 2.3.34.2. IMU Accelerometer Message ( = 30).............................................. 97 2.3.34.3. IMU Gyroscope Message ( = 31) ................................................... 98 2.3.35. PSTMTG..................................................................................................................... 99 2.3.36. PSTMTS ..................................................................................................................... 99 2.3.37. PSTMPPSDATA.......................................................................................................... 99 2.3.38. PSTMUTC ................................................................................................................ 102 2.3.39. PSTMSBAS .............................................................................................................. 103 2.3.40. PSTMCPU ................................................................................................................ 104 2.3.41. PSTMPRES .............................................................................................................. 104 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 6 / 113 GNSS Module Series 2.3.42. PSTMVRES .............................................................................................................. 104 2.3.43. PSTMPV ................................................................................................................... 105 2.3.44. PSTMNAVM.............................................................................................................. 105 2.3.45. PSTMPOSHOLD ...................................................................................................... 105 2.3.46. PSTMTRAIMSTATUS ............................................................................................... 106 2.3.47. PSTMTRAIMUSED................................................................................................... 106 2.3.48. PSTMTRAIMRES ..................................................................................................... 107 2.3.49. PSTMTRAIMREMOVED .......................................................................................... 108 3 Appendix A References ............................................................................................................... 109 4 Appendix B GNSS (NMEA) Numbering .......................................................................................112 5 Appendix C Special Characters ...................................................................................................113 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 7 / 113 GNSS Module Series Table Index Table 1: Supported Protocol ...................................................................................................................... 9 Table 2: Applicable Modules ...................................................................................................................... 9 Table 3: Structure of NMEA Protocol Messages.......................................................................................11 Table 4: NMEA Talker ID ......................................................................................................................... 12 Table 5: Ephemeris Data Format for GPS ............................................................................................... 37 Table 6: Ephemeris Data Format for GLONASS ..................................................................................... 39 Table 7: Ephemeris Data Format for Galileo ........................................................................................... 41 Table 8: Ephemeris Data Format for BDS ............................................................................................... 43 Table 9: Almanac Data Format for GPS .................................................................................................. 46 Table 10: Almanac Data Format for GLONASS....................................................................................... 47 Table 11: Almanac Data Format for Galileo ............................................................................................. 48 Table 12: Almanac Data Format for BDS................................................................................................. 49 Table 13: NMEA Message List ................................................................................................................ 81 Table 14: Related Documents ............................................................................................................... 109 Table 15: Terms and Abbreviations........................................................................................................ 109 Table 16: GNSS Satellites (NMEA) Numbering ......................................................................................112 Table 17: Special Characters .................................................................................................................113 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 8 / 113 GNSS Module Series 1 Introduction Quectel L26-DR series, L26-P, L26-T series and LC98S GNSS modules support GPS, GLONASS, Galileo, BDS and QZSS constellations. Concurrent tracking of GPS L1 C/A, GLONASS L1, Galileo E1, BDS B1 and QZSS L1 C/A frequency bands provides fast and accurate acquisition and makes these modules ideal positioning, navigation or timing solutions for various vertical markets. This document describes the software commands that are needed to control and modify the module configuration. The software commands are NMEA proprietary commands defined by the chipset supplier (PSTM commands). To report GNSS information, these modules support outputting messages in NMEA 0183 standard protocol format. The L26-DR series, L26-P, L26-T series and LC98S module supports the following protocols: Table 1: Supported Protocol Protocol NMEA 0183 V3.01/V4.10 Type Output, ASCII, standard Input/output, ASCII, proprietary This document is applicable to the following Quectel GNSS modules: Table 2: Applicable Modules Module Series L26-DR Series L26-P L26-T Series Model L26-DR (AA) L26-DR (ADR) L26-DR (ADRC) L26-DR (UDR) L26-P L26-T L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 9 / 113 Module Series LC98S Model L26-T (B) L26-T (D) LC98S GNSS Module Series NOTE 1. It is impossible to enable all supported constellations at the same time. Allowed combinations to achieve maximum coverage are: ⚫ GPS + GLONASS + Galileo + QZSS and ⚫ GPS + Galileo + BDS + QZSS. Any of the aforementioned constellations can be enabled as a standalone satellite navigation system. 2. Quectel assumes no responsibility if commands other than the ones listed herein are used. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 10 / 113 GNSS Module Series 2 NMEA Protocol 2.1. Structure of NMEA Protocol Messages Start of sentence character. Always Address field - contains talker identifier and sentence formatter Starts with a * 8-bit checksum value converted to two ASCII characters Data field(s), delimited by , End of sentence. Always $ () [,] * Range for checksum calculation Figure 1: Structure of NMEA Protocol Messages Table 3: Structure of NMEA Protocol Messages Field Description $ Start of sentence (Hex 0x24). In Standard Messages: In standard messages, this field consists of a two-character talker identifier (TalkerID) and a three-character sentence formatter (SentenceFormatter). The talker identifier identifies the type of talker. For more information on the TalkerID, see Table 4: NMEA Talker ID. The sentence formatter identifies the data type and the string format of the successive fields. In Proprietary Messages: In proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer’s Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 11 / 113 GNSS Module Series Field Description Data fields, delimited by data field delimiter ‘,’. Variable length (depending on NMEA message type). Checksum field follows the checksum delimiter character ‘*’. Checksum is the 8-bit exclusive OR of all characters in the sentence, including ‘,’ the field delimiter, between but not including the ‘$’ and the ‘*’ delimiters. End of sentence (Hex 0x0D 0x0A). Table 4: NMEA Talker ID GNSS Constellation Configuration GPS GLONASS Galileo BDS QZSS Combination of Multiple Satellite Systems TalkerID (NMEA 0183 V3.01/V4.10) GP GL GA BD QZ GN NMEA Checksum Sample Code: // pData is the data array of which the checksum needs to be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL == pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^= *(pData + i); } L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 12 / 113 return result; } GNSS Module Series 2.2. Standard Messages This chapter explains the standard NMEA 0183 V3.01 and V4.10 messages supported by the modules. ⚫ L26-DR (AA, ADR, UDR), L26-P and L26-T series modules support NMEA 0183 V3.01 protocol by default. ⚫ L26-DR (ADRC) and LC98S modules support NMEA 0183 V4.10 protocol by default. 2.2.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type: Output Synopsis: NMEA 0183 V3.01 format: $GPRMC,,,,,,,,,,,,* NMEA 0183 V4.10 format: $RMC,,,,,,,,,,,,,* Parameter: Field $ Format Character String RMC String hhmmss.sss Unit Example Description - $ Each NMEA message starts with $. Talker identifier. - GN See Table 4: NMEA Talker ID. Always 'GP' in NMEA 0183 V3.01. - RMC Recommended Minimum Specific GNSS Data. Position fix UTC. - 080215.000 hh: Hours (00–23) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 13 / 113 GNSS Module Series Field Format Unit Example Character - A ddmm.mmmmm - 3149.33195 Character - N dddmm.mmmmm - 11706.94936 Character - E Numeric Numeric Knot 0.0 Degree 0.0 Description mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Positioning system status. A = Data valid. V = Navigation receiver warning. Latitude. dd: Degrees (00–90) mm: Minutes (00–59) mmmmm: Decimal fraction of minutes Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. North-south direction. N = North S = South Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) mmmmm: Decimal fraction of minutes Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. East-west direction. E = East W = West Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Speed over ground. Variable length. Note that this field is empty in case of an invalid value. Course over ground. Variable length. Maximum value: 359.9. Note that this field is empty in case of an invalid value. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 14 / 113 GNSS Module Series Field Format ddmmyy - - Character Character Hexadecimal Character Unit Example - 150222 - - - - - A - C - *15 - - Description Date. dd: Day of month mm: Month yy: Year Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Magnetic variation. Not supported. Direction of magnetic variation. Not supported. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix. D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS). E = Estimated (dead reckoning) mode. N = No fix. Satellite system not used in position fix, or fix not valid. Navigational status. S = Safe C = Caution U = Unsafe V = Navigational status not Valid Note that this parameter is only available in messages in line with NMEA 0183 V4.10 and later versions. Checksum. Carriage return and line feed. NMEA 0183 V3.01 example: $GPRMC,081027.000,A,3149.33388,N,11706.94688,E,0.0,0.0,140222,,,D*66 NMEA 0183 V4.10 example: $GNRMC,080215.000,A,3149.33195,N,11706.94936,E,0.0,0.0,150222,,,A,C*15 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 15 / 113 GNSS Module Series 2.2.2. GGA Global Positioning System Fix Data. Time, position, and fix-related data for the GNSS receiver. Type: Output Synopsis: NMEA 0183 V3.01 format: $GPGGA,,,,,,,,,,M,,M,,* NMEA 0183 V4.10 format: $GGA,,,,,,,,,,M,,M,,* Parameter: Field $ GGA Format Unit Character - String - String - hhmmss.sss - ddmm.mmmmm - Example $ GN GGA 080247.000 3149.33477 Description Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. Always 'GP' in NMEA 0183 V3.01. Global Positioning System Fix Data. Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Latitude. dd: Degrees (00–90) mm: Minutes (00–59) mmmmm: Decimal fraction of minutes Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 16 / 113 GNSS Module Series Field Format Unit Character - dddmm.mmmmm - Character - Numeric - 1) Numeric - Numeric - M Numeric Meter Character Numeric Meter Example N 11706.94845 E 1 17 0.8 048.21 M -0.3 Description North-south direction. N = North S = South Note that in NMEA 0183 V4.10 messages, this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) mmmmm: Decimal fraction of minutes Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. East-west direction. E = East W = West Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. GPS quality indicator. 0 = Fix not available or invalid. 1 = GPS SPS Mode, fix valid. 2 = Differential GPS, SPS Mode, or Satellite Based Augmentation System (SBAS), fix valid. 6 = Estimated (dead reckoning) mode. Number of satellites in use. Horizontal dilution of precision. Variable length. Maximum value: 99.0. Altitude above mean-sea-level (geoid). Variable length. Maximum value: 100000.0. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Unit of . 'M' = meter. Geoid separation (the difference between the earth ellipsoid surface and the mean-sea-level (geoid) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 17 / 113 GNSS Module Series Field Format M Character Hexadecimal Character Unit Example - M - - - - - *6A - - Description surface defined by the reference datum used in the position solution). Variable length. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Unit of . 'M' = meter. Differential GPS data age. Not supported. Differential reference station ID. Not supported. Checksum. Carriage return and line feed. NMEA 0183 V3.01 example: $GPGGA,082233.000,3149.33371,N,11706.94684,E,2,16,0.8,054.42,M,-0.3,M,,*7D NMEA 0183 V4.10 example: $GNGGA,080247.000,3149.33477,N,11706.94845,E,1,17,0.8,048.21,M,-0.3,M,,*6A NOTE 1. The NMEA 0183 specification indicates that GGA messages are GPS specific. However, when the receiver is configured for multi-constellations, the content of a GGA message will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12. 2.2.3. GNS GNSS Fix Data. Fix data for single or combined satellite navigation systems (GNSS). Type: Output L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 18 / 113 GNSS Module Series Synopsis: NMEA 0183 V3.01 format: $GNS,,,,,,,,,, ,,* NMEA 0183 V4.10 format: $GNS,,,,,,,,,, ,,,* Parameter: Field $ GNS Format Unit Character - String - String - hhmmss.sss - ddmm.mmmmm - Character - dddmm.mmmmm - Example Description $ GN GNS 090647.000 3149.33069 N 11706.94657 Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. GNSS Fix Data. Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Latitude. dd: Degrees (00–90) mm: Minutes (00–59) mmmmm: Decimal fraction of minutes Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. North-south direction. N = North S = South Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Longitude. ddd: Degrees (000–180) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 19 / 113 Field Format Character 1) Character Numeric Numeric Numeric Numeric GNSS Module Series Unit Example - E - ADDNNN - 17 - 0.7 Meter 0055.7 Meter -0.3 Description mm: Minutes (00–59) mmmmm: Decimal fraction of minutes Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. East-west direction. E = East W = West Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix. D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS). E = Estimated (dead reckoning) mode. N = No fix. Satellite system not used in position fix, or fix not valid. Total number of satellites in use. Range: 00–99. Horizontal dilution of precision. Maximum value: 99.0. Antenna altitude above the meansea-level (geoid). Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Geoid separation (the difference between the earth ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 20 / 113 GNSS Module Series Field Format - Character Hexadecimal Character Unit Example - - - - - C - *24 - - Description Differential GPS data age. Not supported. Differential reference station ID. Not supported. Navigational status indicator. S = Safe C = Caution U = Unsafe V = Navigational status not valid, equipment is not providing navigational status indication. Note that this parameter is only available in messages in line with NMEA 0183 V4.10 and later versions. Checksum. Carriage return and line feed. NMEA 0183 V3.01 example: $GNGNS,082901.000,3149.32957,N,11706.95092,E,AAANNN,16,0.7,0051.4,-0.3,,*48 NMEA 0183 V4.10 example: $GNGNS,090647.000,3149.33069,N,11706.94657,E,ADDNNN,17,0.7,0055.7,-0.3,,,C*24 NOTE 1) is a variable length field. The first character indicates the use of GPS satellites; the second character indicates the use of GLONASS satellites; the third character indicates the use of Galileo satellites; the fourth character indicates the use of BDS satellites; the fifth character indicates the use of QZSS satellites; and the sixth character is fixed as N. 2.2.4. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value, and it contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of sentences being transmitted and the sentence number are indicated in the first two data fields. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 21 / 113 GNSS Module Series Type: Output Synopsis: NMEA 0183 V3.01 format: $GSV,,,{,,,,}* NMEA 0183 V4.10 format: $GSV,,,{,,,,}, * Parameter: Field $ Format Unit Character - String - GSV String - Numeric - Numeric - Numeric - Start of repeat block. Repeat times: 1–4. Numeric - Numeric Numeric Numeric End of repeat block. Degree Degree dB-Hz Numeric - Example Description $ GP GSV 3 1 12 Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. GNSS Satellites in View. Total number of sentences. Range: 1–8. Sentence number. Range: 1–. Total number of satellites in view. Maximum value: 32. Satellite ID. 20 See Table 16: GNSS Satellites (NMEA) Numbering. 66 Satellite elevation. Range: 00–90. Satellite azimuth, with true north as the 295 reference plane. Range: 000–359. Satellite C/N0. Range 00–99. 31 Null when not tracking. GNSS signal ID. 1 See Table 16: GNSS Satellites (NMEA) Numbering. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 22 / 113 GNSS Module Series Field Format Unit Hexadecimal - Character - Example Description Note that this parameter is only available in messages in line with NMEA 0183 V4.10 or later versions. *6E Checksum. - Carriage return and line feed. NMEA 0183 V3.01 example: $GPGSV,3,1,12,20,66,289,38,11,59,348,37,02,57,343,36,06,46,063,36*70 $GPGSV,3,2,12,05,40,250,38,19,37,142,28,12,29,256,34,09,23,049,29*77 $GPGSV,3,3,12,17,18,143,31,25,15,298,30,13,11,184,,50,51,161,31*78 $GLGSV,2,1,06,68,71,186,34,82,54,074,38,67,51,035,33,83,48,352,23*62 $GLGSV,2,2,06,69,19,203,20,81,16,115,,,,,,,,,*6C NMEA 0183 V4.10 example: $GPGSV,3,1,12,20,66,295,31,11,59,354,31,02,59,346,35,06,45,066,34,1*6E $GPGSV,3,2,12,05,41,253,34,19,35,143,31,12,28,253,28,09,22,047,26,1*66 $GPGSV,3,3,12,25,15,296,25,17,15,144,28,13,13,183,,50,51,161,26,1*6E $GLGSV,2,1,06,68,74,187,34,82,54,079,35,83,50,355,25,67,48,034,34,1*7D $GLGSV,2,2,06,69,22,204,22,81,14,117,,,,,,,,,,1*7C NOTE 1. GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, GSV sentences are output with the corresponding talker ID for each constellation. 2. When the LC98S module is configured with the NMEA V3.01 protocol, of the GSV sentence is always GN. If satellites of multiple constellations are in view, , , are collectively reported, with no individual count provided for each constellation. 2.2.5. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA or GNS sentence, and DOP values. Type: Output L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 23 / 113 GNSS Module Series Synopsis: NMEA 0183 V3.01 format: $GSA,,{,},,,* NMEA 0183 V4.10 format: $GSA,,{,},,,,* Parameter: Field Format Unit Example Description $ GSA Character String String Character - $ - GN - GSA - A Numeric - 3 Start of repeat block. Repeat times: 12. Numeric - 08 End of repeat block. Numeric Numeric Numeric Numeric - 1.4 - 0.8 - 1.1 - 1 Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. GNSS DOP and Active Satellites. Selection of 2D or 3D fix. M = Manual, forced to operate in 2D or 3D mode. A = Automatic, allowed to automatically switch to 2D or 3D mode. Fix mode. 1 = Fix not available 2 = 2D 3 = 3D ID numbers of satellites used in solution. See Table 16: GNSS Satellites (NMEA) Numbering. Note that this field is empty in case of invalid value. Position dilution of precision. Maximum value: 99.99. Horizontal dilution of precision. Maximum value: 99.99. Vertical dilution of precision. Maximum value: 99.99. GNSS system ID. See Table 16: GNSS Satellites (NMEA) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 24 / 113 GNSS Module Series Field Format Hexadecimal Character Unit Example Description Numbering. Note that this parameter is only available in messages in line with NMEA 0183 V4.10 or higher versions. - *37 Checksum. - - Carriage return and line feed. NMEA 0183 V3.01 example: $GNGSA,A,3,08,07,01,30,27,14,17,,,,,,1.1,0.7,0.9*29 NMEA 0183 V4.10 example: $GNGSA,A,3,08,07,21,01,27,30,,,,,,,1.4,0.8,1.1,1*37 NOTE If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used, only the IDs of the first 12 are output. 2.2.6. VTG Course Over Ground & Ground Speed. The actual course and speed relative to the ground. Type: Output Synopsis: NMEA 0183 V3.01 format: $GPVTG,,T,,M,,N,,K,* NMEA 0183 V4.10 format: $VTG,,T,,M,,N,,K,* Parameter: Field $ Format Unit Character - Example Description $ Each NMEA message starts with $. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 25 / 113 GNSS Module Series Field Format String VTG String Numeric T M Character Numeric Character Numeric N Character Numeric K Character Character Hexadecimal Unit Degrees Degrees Knots km/h - - - Example Description Talker identifier. GN See Table 4: NMEA Talker ID. Always 'GP' in NMEA 0183 V3.01. VTG Course Over Ground & Ground Speed. 110.3 Course over ground, in true north direction. Note that this field is empty in case of an invalid value. T Fixed field: true. Course over ground (magnetic). - Not supported. M Fixed field: magnetic. Speed over ground in knots. Variable length. 0.4 Note that this field is empty in case of invalid value. N Fixed field: knot. Speed over ground in kilometers per hour. Variable length. 0.6 Note that this field is empty in case of invalid value. K Fixed field: kilometers per hour. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix. D = Differential mode. Satellite system used in D differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS). E = Estimated (dead reckoning) mode. N = Data not valid. *17 Checksum. Character - - Carriage return and line feed. NMEA 0183 V3.01 example: $GPVTG,0.0,T,,M,0.1,N,0.2,K,A*0E L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 26 / 113 NMEA 0183 V4.10 example: $GNVTG,110.3,T,,M,0.4,N,0.6,K,D*17 GNSS Module Series 2.2.7. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type: Output Synopsis: NMEA 0183 V3.01 format: $GPGLL,,,,,,,* NMEA 0183 V4.10 format: $GLL,,,,,,,* Parameter: Field $ GLL Format Unit Example Description Character - String - String - ddmm.mmmmm - Character - dddmm.mmmmm - $ GP GLL 3149.33233 N 11706.94768 Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. Always 'GP' in NMEA 0183 V3.01. Geographic Position – Latitude/Longitude. Latitude. dd: Degrees (00–90) mm: Minutes (00–59) mmmmm: Decimal fraction of minutes Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. North-south direction. N = North S = South Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Longitude. ddd: Degrees (000–180) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 27 / 113 GNSS Module Series Field Format Character hhmmss.sss Character Character Hexadecimal Character Unit Example - E - 083358.000 - A - A - *54 - - Description mm: Minutes (00–59) mmmmm: Decimal fraction of minutes Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. East-west direction. E = East W = West Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Position UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Positioning system status. A = Data valid. V = Data not valid. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix. D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS). E = Estimated (dead reckoning) mode. N = Data not valid. Checksum. Carriage return and line feed. NMEA 0183 V3.01 example: $GPGLL,3149.33233,N,11706.94768,E,083358.000,A,A*54 NMEA 0183 V4.10 example: $GNGLL,3149.33372,N,11706.94794,E,065910.000,A,A*43 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 28 / 113 GNSS Module Series 2.2.8. ZDA Time & Date. UTC, day, month and year. Type: Output Synopsis: NMEA 0183 V3.01 format: $GPZDA,,,,,00,00* NMEA 0183 V4.10 format: $ZDA,,,,,,* Parameter: Field $ Format Unit Character - String - ZDA String - hhmmss.sss - Numeric - Numeric - Numeric - Hexadecimal - Example Description $ Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. GN Always 'GP' in NMEA 0183 V3.01. ZDA Time & Date. UTC, day, month and year. 080839.000 15 02 2022 Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Day of month. Range: 01–31. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Month. Range: 01–12. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Year. Minimum value: 1994. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. *46 Checksum. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 29 / 113 GNSS Module Series Field Format Character Unit Example - - Description Carriage return and line feed. NMEA 0183 V3.01 example: $GPZDA,084707.000,14,02,2022,00,00*5F NMEA 0183 V4.10 example: $GNZDA,080839.000,15,02,2022,,*46 2.2.9. GST GNSS Pseudorange Error Statistics. This sentence supports Receiver Autonomous Integrity Monitoring (RAIM). Pseudorange measurement error statistics can be translated in the position domain in order to give statistical measures of the quality of the position solution. Type: Output Synopsis: NMEA 0183 V3.01 format: $GPGST,,,,,,,,* NMEA 0183 V4.10 format: $GST,,,,,,,,* Parameter: Field Format Unit $ Character - String, 2 characters - GST String, 3 characters - hhmmss.sss - Example Description $ Each NMEA message starts with $. Talker identifier. See Table 4: NMEA GN Talker ID. Always 'GP' in NMEA 0183 V3.01. GST GNSS Pseudorange Error Statistics. Position fix UTC. 081018.000 hh: Hours (00–23) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 30 / 113 Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Hexadecimal Character GNSS Module Series Unit Example Meter 29.5 Meter 6.7 Meter 4.9 Degree 90.4 Meter 5.3 Meter 6.4 Meter 5.6 - *71 - - Description mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Equivalent Horizontal Position Error. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Standard deviation of semi-major axis of error ellipse. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Standard deviation of semi-minor axis of error ellipse. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Orientation of semi-major axis of error ellipse (true north degrees). Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Standard deviation of latitude error. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Standard deviation of longitude error. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Standard deviation of altitude error. Note that in NMEA 0183 V4.10 messages, this field is empty in case of invalid value. Checksum. Carriage return and line feed. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 31 / 113 NMEA 0183 V3.01 example: $GPGST,091702.000,17.5,5.7,4.8,90.7,5.1,5.3,5.2*6C NMEA 0183 V4.10 example: $GNGST,081018.000,29.5,6.7,4.9,90.4,5.3,6.4,5.6*71 GNSS Module Series 2.2.10. RLM Return link message. The receiver will detect the Galileo Search and Rescue (SAR) Return Link Message when the RLM function is enabled. Type: Output Synopsis: NMEA 0183 V3.01 format: $RLM,,,,* NMEA 0183 V4.10 format: $RLM,,,,* Parameter: Field $ RLM Format Character String String Hexadecimal < UTC > hhmmss.ss Hexadecimal Unit Example Description - $ Each NMEA message starts with $. - GA Talker identifier. See Table 4: NMEA Talker ID. RLM Return link message. 9A22BE29 Beacon of RLM. Beacon ID. 15 hex - 630F010 characters (60 bits). RLM timestamp (i.e., time of reception of the last 20-bit packet of the RLM) in UTC. - 081213.00 hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds - F Type of RLM Message Service. 0 = Reserved L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 32 / 113 GNSS Module Series Field Format Hexadecimal Hexadecimal Character Unit Example - 1F02 *77 Description 1 = Acknowledgement Service RLM 2 = Command Service RLM 3 = Message Service RLM 4–E = Reserved F = Test Service RLM. Variable field length encapsulating the data parameters into hexadecimal format. Galileo Short Message: 4 hexadecimal digits Galileo Long Message: 24 hexadecimal digits Checksum. - Carriage return and line feed. NMEA 0183 V3.01 example: $GARLM,9982BE29630F100,074813.00,F,1F02*05 NMEA 0183 V4.10 example: $GARLM,9A22BE29630F010,081213.00,F,1F02*77 NOTE 1. Currently RLM is only supported by Galileo. 2. You must send $PSTMCFGMSGL and $PSTMSETPAR,1227,10,1 commands to enable RLM message output. The settings take effect only after you send PSTMSAVEPAR and then reset the system with PSTMSRR. The configurations are retained even after power cycling. 2.3. PSTM Messages This chapter explains PSTM messages (proprietary NMEA messages defined by the chipset supplier) supported by L26-DR series, L26-P, L26-T series and LC98S modules. 2.3.1. PSTMINITGPS Initializes the GPS position and time of GNSS receiver in UTC format. The command must be issued after a cold start or it will fail. The date issued with parameters , and must be later than L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 33 / 113 GNSS Module Series January 2018. Type: Input Synopsis: $PSTMINITGPS,,,,,,,,,,, * Parameter: Field Format ddmm.mmm Character dddmm.mmm Character Numeric dd mm yyyy hh mm ss Unit - - - - Meter - Description Latitude (i.e., Degree-Minutes. Minute decimals). North-south direction. N = North S = South Longitude (i.e., Degree-Minutes. Minute decimals). East-west direction. E = East W = West Altitude in meters. Range: 0–10000. Day of month. Range: 01–31. Month. Range: 01–12. Year. Minimum value: 2018. Hours. Range: 00–23. Minutes. Range: 00–59. Seconds. Range: 00–59. Result: ⚫ If successful, the module returns: $PSTMINITGPSOK* ⚫ If failed, the module returns: $PSTMINITGPSERROR* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 34 / 113 Example: $PSTMINITGPS,3149.333,N,11706.947,E,0530,15,02,2022,01,31,30*56 $PSTMINITGPSOK*40 GNSS Module Series NOTE 1. The deviation of input time from current time should be less than 3 seconds. GPS time = UTC time + Leap second. For example, in 2019, Leap second = 18 s. 2. The deviation of input position from actual position should be less than 30 kilometers. 2.3.2. PSTMINITTIME Initializes the GPS time of GNSS receiver in UTC format. The date issued with parameters , and must be later than January 2018. Type: Input Synopsis: $PSTMINITTIME,,,,,,* Parameter: Field Format dd mm yyyy hh mm ss Unit Description - Day of month. Range: 01–31. - Month. Range: 01–12. - Year. Minimum value: 2018. - Hours. Range: 00–23. - Minutes. Range: 00–59. - Seconds. Range: 00–59. Result: ⚫ If successful, the module returns: $PSTMINITTIMEOK* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 35 / 113 ⚫ If failed, the module returns: $PSTMINITTIMEERROR* Example: $PSTMINITTIME,15,02,2022,01,37,30*17 $PSTMINITTIMEOK*11 GNSS Module Series NOTE The error deviation of input GPS time from current GPS time should be less than 3 seconds. GPS time = UTC time + Leap second, e.g., in 2019, Leap second = 18 s. 2.3.3. PSTMCLREPHS Clears all ephemeris data. It erases all the ephemeris data stored in the NVM backup memory. Type: Command Synopsis: $PSTMCLREPHS* Parameter: None Result: ⚫ All ephemeris data stored in the NVM backup memory will be deleted. ⚫ No message is sent as a reply. Example: $PSTMCLREPHS*49 2.3.4. PSTMDUMPEPHEMS Sends all ephemeris data stored in the NVM backup memory. Type: Command L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 36 / 113 GNSS Module Series Synopsis: $PSTMDUMPEPHEMS* Parameter: None Result: $PSTMEPHEM,,{,}* Parameters in the result: Field Format Unit Description Numeric - Satellite ID. Numeric - Number of the ephemeris data bytes. Start of repeat block. Repeat times. Hexadecimal - The Nth byte of the ephemeris data. End of repeat block. The data from byte 1 to byte N (byte 1 and byte N included) are the dump of structures that contain all ephemeris information. Ephemeris data format is constellation dependent. Refer to the tables below for details. Table 5: Ephemeris Data Format for GPS Bits Structure Member Description 16 week Week number of the issue of data. 16 toe Time of week for ephemeris epoch. 16 toc Time of week for clock epoch. 8 iode1 Issue of data 1. 8 iode2 Issue of data 2. 10 iodc Issue of data clock. 14 i_dot Rate of inclination angle. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 37 / 113 GNSS Module Series Bits Structure Member Description 8 reserved - 24 omega_dot Rate of right ascension. 8 reserved Must be 0. 16 crs Amplitude of the sine harmonic correction to the orbit radius. 16 crc Amplitude of the cosine harmonic correction to the orbit radius. 16 cus Amplitude of the sine harmonic correction to the argument of latitude. 16 cuc Amplitude of the cosine harmonic correction to the argument of latitude. 16 cis Amplitude of the sine harmonic correction to the angle of inclination. 16 cic Amplitude of the cosine harmonic correction to the angle of inclination. 16 motion_difference Mean motion difference from the computed value. 16 reserved Must be 0. 32 inclination Inclination angle at the reference time. 32 e Eccentricity. 32 root_A Square root of major axis. 32 mean_anomaly Mean anomaly at the reference time. 32 omega_zero Longitude of the ascending node of an orbit plane at weekly epoch. 32 perigee Argument of perigee. 8 time_group_delay Estimated group delay differential. 8 af2 Second order clock correction. 16 af1 First order clock correction. 22 af0 Constant clock correction. 1 reserved Reserved for use by GNSS library – must be 1. 1 reserved Reserved for use by GNSS library – must be 1. 1 reserved Reserved for use by GNSS library – must be 1. 1 available Contains1 if the ephemeris is available, 0 if not. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 38 / 113 GNSS Module Series Bits Structure Member Description 1 health Contains 1 if the satellite is unhealthy, 0 if healthy. 1 reserved Must be 0. 4 accuracy Accuracy. Table 6: Ephemeris Data Format for GLONASS Bits Structure Member 16 week 16 toe 4 toe_lsb 11 NA 7 tb 2 M 2 P1 1 P3 1 P2 1 P4 2 KP 1 Reserved 27 xn 5 xn_dot_dot 24 xn_dot 5 n 3 Bn Description Week number of the issue of data. Time of week for ephemeris epoch. Time of week for ephemeris epoch (LSB). Calendar day number within the four-year period since the beginning of the last leap year (almanac). Time of ephemeris index. Type of satellite. 00 = GLONASS 01 = GLONASS-M Time interval between two adjacent tb parameters. Number of satellites for which almanac is transmitted within this frame. 0 = 4 satellites 1 = 5 satellites Flag of oddness ('1') or evenness ('0') of the value of tb. Flag to show that ephemeris parameters are present. Notification on the forthcoming leap second correction of UTC. - Satellite PZ-90 x coordinate at epoch tb. Satellite PZ-90 x velocity at epoch tb. Satellite PZ-90 x acceleration component at epoch tb. Slot number (1–24). Healthy flags. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 39 / 113 GNSS Module Series Bits Structure Member 27 yn 5 yn_dot_dot 24 yn_dot 8 age_h 27 zn 5 zn_dot_dot 24 zn_dot 8 reserved 11 gamma_n 5 E_n 4 freq_id 12 reversed 22 tau_n 10 reserved 32 tau_c 22 tau_GPS 10 reserved 11 NT 5 N4 12 tk 4 FT 32 reserved 5 m_available 1 nvm_reliable 26 spare Description Satellite PZ-90 y coordinate at epoch tb. Satellite PZ-90 y acceleration component at epoch tb. Satellite PZ-90 y velocity at epoch tb. Age of predicted ephemeris (hours). Satellite PZ-90 z coordinate at epoch tb. Satellite PZ-90 z acceleration component at epoch tb. Satellite PZ-90 z velocity at epoch tb. Must be 0. Satellite clock frequency drift at epoch tb. Age of the ephemeris information. Frequency ID. Satellite clock correction at epoch tb. Must be 0. GLONASS to UTC (SU) time correction. GLONASS to GPS system time correction. Calendar day number of ephemeris within the four-year period since the beginning of last leap year. Four-year interval number starting from 1996. Satellite time referenced to the beginning of the frame. Predicted satellite user range accuracy at time tb. Must be 0x1F. Must be 1. - L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 40 / 113 GNSS Module Series Bits Structure Member 25 reserved 1 available 1 health 1 reserved 4 reserved Description Contains 1 if the ephemeris is available, 0 if not. Contains 1 if the satellite is unhealthy, 0 if healthy. Must be 0. - Table 7: Ephemeris Data Format for Galileo Bits Structure Member Description 16 week Week number of the issue of data. 16 toe Time of week for ephemeris epoch. 2 reserved - 16 toc Time of week for clock epoch. 10 iod_nav Issue of data. 8 SISA Signal in space accuracy. 10 reserved Must be 0. 10 BGD_E1_E5a E1-E5a broadcast group delay. 10 BGD_E1_E5b E1-E5b broadcast group delay. 2 E1BHS E1-B signal health status. 32 inclination Inclination angle at the reference time. 32 eccentricity Eccentricity. 32 root_a Square root of the major axis. 32 mean_anomaly Mean anomaly at the reference time. 32 omega_zero Longitude of the ascending node of an orbit plane at weekly epoch. 32 perigee Argument of perigee. 14 i_dot Rate of inclination angle. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 41 / 113 GNSS Module Series Bits Structure Member Description 1 available Contains 1 if ephemeris is available, 0 if not. 1 health Contains 1 if the satellite is unhealthy, 0 if healthy. 16 motion_difference Mean motion difference from the computed value. 16 crs Amplitude of the sine harmonic correction to the orbit radius. 16 crc Amplitude of the cosine harmonic correction to the orbit radius. 16 cus Amplitude of the sine harmonic correction to the argument of latitude. 16 cuc Amplitude of the cosine harmonic correction to the argument of latitude. 16 cis Amplitude of the sine harmonic correction to the angle of inclination. 16 cic Amplitude of the cosine harmonic correction to the angle of inclination. 24 omega_dot Rate of right ascension. 6 SVID Space vehicle identification. 1 E1BDVS E1-B data validity status. 1 reserved Must be 0. 8 reserved Must be 0. 16 reserved Must be 0. 6 af2 Second order clock correction. 21 af1 First order clock correction. 5 word_available Must be 0x1F. 31 af0 Constant clock correction. 1 reserved - 6 reserved Must be 0. 26 reserved Reserved for use by GNSS library – must be 1. 1 reserved Must be 0. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 42 / 113 GNSS Module Series Table 8: Ephemeris Data Format for BDS Bits Structure Member 32 inclination 32 eccentricity 32 root_a 32 mean_anomaly 32 omega_zero 32 perigee 17 toe 10 time_group_delay 5 aode 24 omega_dot 8 A0 24 af0 8 A1 20 sow 11 af2 1 is_geo 22 af1 10 subframe_avail 16 motion_difference 8 A2 8 A3 18 crs 8 B2 4 urai Description Inclination angle at the reference time. Eccentricity. Square root of the major axis. Mean anomaly at the reference time. Longitude of the ascending node of an orbit plane at weekly epoch. Argument of perigee. Time of week for ephemeris epoch. Estimated group delay differential. Issue of data, ephemeris. Rate of right ascension. Ionospheric Delay Model Parameter α0. Constant clock correction. Ionospheric Delay Model Parameter α1. Seconds of week. Second order clock correction. 1 for Geostationary satellites, otherwise 0. First order clock correction. Must be 0x3FF. Mean motion difference from the computed value. Ionospheric delay model parameter α2. Ionospheric delay model parameter α3. Amplitude of the sine harmonic correction to the orbit radius. Ionospheric delay model parameter β2. User range accuracy index. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 43 / 113 GNSS Module Series Bits Structure Member 2 reserved 18 crc 8 B3 5 aodc 1 spare 18 cus 14 i_dot 18 cuc 8 B0 6 spare 18 cis 8 B1 6 reserved 18 cic 1 nvm_reliable 11 reserved 2 spare 17 toc 13 week 1 available 1 health Description Must be 0. Amplitude of the cosine harmonic correction to the orbit radius. Ionospheric delay model parameter β3. Issue of data, clock. Amplitude of the sine harmonic correction to the argument of latitude. Rate of inclination angle. Amplitude of the cosine harmonic correction to the argument of latitude. Ionospheric delay model parameter β0. Amplitude of the sine harmonic correction to the angle of inclination. Ionospheric Delay Model Parameter β1. Must be 0. Amplitude of the cosine harmonic correction to the angle of inclination. Must be 1. Must be 0. Time of week for clock epoch. Week number of the issue of data. Contains 1 if the ephemeris is available, 0 if not. Contains 1 if the satellite is unhealthy, 0 if healthy. Example: $PSTMDUMPEPHEMS*10 $PSTMEPHEM,3,64,9508f12bf12b0c0c0c60ee0063a7ff00bbeff8214a0cd1f11f00ecff0a2e00001930a0 27ec46fe012d7f0da18f02f723734557dc3a87fe26040069ff1102fc03*5E $PSTMEPHEM,10,64,9508f22bf22b0f0f0ff8ee007ca6ff001df26423ed0abaf322000600a42e0000a65d 9e27035dd70387780da1fdad330011313adc8eec94990500a4ffa07df503*32 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 44 / 113 GNSS Module Series $PSTMEPHEM,16,64,9508f12bf12b020202d0ec00b3aaff000affc61adc1176ff2b00a000102f0000d694 8727d6848806becf0ca1b5ea81d138d400609eeedc1cea00d5ff309df003*6C $PSTMEPHEM,22,64,9508f22bf22b232323cc13005aaeff000afe1c15e2162cfeb7ff6400292d0000dfe9 2e276e51990627440da195a78ba62bc1590addb1b3b3eb003200d000c703*38 $PSTMEPHEM,25,64,9508f22bf22b2a2a2a5ce700c0a6ff009afda01b6411a6fd3900aafff73300000c41 0427b1bc600570a70da1a957cc12086b1e5c2096fa270c002f00385cc903*3D $PSTMEPHEM,26,64,9508f12bf12b16161690eb0095a4ff0037fdc41bbf0fc4fd2500230062380000cc15 3c26b7528503af940da1feae19f8634b345ab76c130f0f001c00a901c603*31 2.3.5. PSTMCLRALMS Deletes all the almanacs stored in the NVM backup memory. Type: Command Synopsis: $PSTMCLRALMS* Parameter: None Result: ⚫ All almanacs stored in the NVM backup memory will be deleted. ⚫ No message is sent as a reply. Example: $PSTMCLRALMS*54 2.3.6. PSTMDUMPALMANAC Dumps almanac data, i.e., the command sends out all almanacs stored in the NVM backup memory. Type: Command Synopsis: $PSTMDUMPALMANAC* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 45 / 113 GNSS Module Series Parameter: None Result: $PSTMALMANAC,,{,}* Parameters included in the result: Field Format Unit Description Numeric - Satellite ID. Numeric - Number of the almanac data bytes. Start of repeat block. Repeat times. Hexadecimal - The Nth byte of the almanac data. End of repeat block. The data from byte 1 to byte N are the dump of structures that contain all almanac information. Almanac data format is constellation dependent. Refer to tables below for details. Table 9: Almanac Data Format for GPS Bits Structure Member Description 8 satid Satellite ID. 16 week Week number for the epoch. 8 toa Almanac reference time. 16 e Eccentricity. 16 delta_i Rate of inclination angle. 16 omega_dot Rate of right ascension. 24 root_A Square root of semi-major axis. 24 omega_zero Longitude of ascending node of orbital plane at weekly epoch. 24 perigee Argument of perigee. 24 mean_anomaly Mean anomaly at the reference time. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 46 / 113 11 af0 11 af1 1 health 1 available GNSS Module Series Constant clock correction. First order clock correction. Contains 1 if the satellite is unhealthy, 0 if healthy. Contains 1 if the almanac is available, 0 if not. Table 10: Almanac Data Format for GLONASS Bits Structure Member Description 8 satid Satellite ID. 16 week Week number for the epoch. 8 toa Reference time almanac. 5 n_A Slot number. Range: 1–24. 5 H_n_A 2 M_n_A 10 tau_n_A Carrier frequency channel number. Type of satellite. 00 = GLONASS 01 = GLONASS-M Satellite clock correction. 15 epsilon_n_A Eccentricity. 21 t_lambda_n_A Time of the first ascending node passage. 21 lambda_n_A Longitude of the ascending node of an orbital plane at almanac epoch. 18 delta_i_n_A Inclination angle correction to the nominal value. 7 delta_T_n_dot_A Draconian period rate of change. 22 delta_T_n_A Draconian period correction. 16 omega_n_A Argument of perigee. 1 health Contains 1 if the satellite is unhealthy, 0 if healthy. 1 available Contains 1 if the almanac is available, 0 if not. 32 Tau_c - 11 NA - L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 47 / 113 Bits Structure Member Description 5 N4 - 16 Spare - GNSS Module Series Table 11: Almanac Data Format for Galileo Bits Structure Member Description 16 satid Satellite ID. 6 svid Space vehicle identification. 16 week Week number for the epoch. 20 toa Almanac reference time. 13 delta_a Semi-major axis difference at reference time 11 e Eccentricity. 16 perigee Argument of perigee. 11 delta_i Rate of inclination angle. 16 omega_zero Longitude of ascending node of orbital plane at weekly epoch. 11 omega_dot Rate of change of right ascension. 16 mean_anomaly Satellite mean anomaly at reference time. 16 af0 Satellite clock correction bias 'truncated' 13 af1 Satellite clock correction linear 'truncated' 2 E5b_HS Satellite E5b signal health status. 2 E1B_HS Satellite E1-B/C signal health status. 4 ioda_1 Almanac issue of data 1. 4 ioda_2 Almanac issue of data 2. 2 word_available - 1 health Contains 1 if the satellite is unhealthy, 0 if healthy. 1 available Contains 1 if almanac is available, 0 if not. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 48 / 113 Bits Structure Member Description 3 spare6 - 32 spare7 - 32 spare8 - GNSS Module Series Table 12: Almanac Data Format for BDS Bits Structure Member Description 8 prn PRN number of the corresponding almanac data. 16 week Almanac reference week number. 8 toa Almanac reference time. 17 eccentricity Eccentricity. 11 af0 Satellite clock bias correction coefficient. 1 is_geo Satellite orbit type. 1 WNa_valid - 2 spare0 - 17 omega_dot Rate of right ascension. 11 af1 Satellite clock time drift correction coefficient. 4 spare1 - 24 root_a Square root of semi-major axis. 8 spare2 24 omega_zero 8 spare3 Longitude of ascending node of orbital plane computed according to reference time. - 24 perigee Argument of perigee. 8 spare4 - 24 mean_anomaly Mean anomaly at reference time. 8 spare5 - L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 49 / 113 GNSS Module Series Bits Structure Member Description 16 delta_i Correction of orbit reference inclination at reference time. 1 health Satellite health information. 1 available Contains 1 if the almanac is available, 0 if not. 8 last_received_toa - 6 spare6 - Example: $PSTMDUMPALMANAC*5B $PSTMALMANAC,1,40,0195084e495dd41c48fd0000f90ca1000e1ab200f1ea23007eff8f00c3e9bf0000 00000000000000*15 $PSTMALMANAC,2,40,0295084e56a9b90e41fd0000250da1007276ae008143c500bedd95005505800 00000000000000000*15 $PSTMALMANAC,3,40,0395084ee51f94133cfd00000a0da1003b4bdc00d9fa2600710561007edfbf000 000000000000000*1B $PSTMALMANAC,4,40,0495084eec0d770c66fd0000e60ca100af560800e15483002489d8003a0f8000 0000000000000000*4C $PSTMALMANAC,5,40,0595084e2230160b2ffd0000eb0ca1009ba5da0052132900c323fc00b5078000 0000000000000000*16 $PSTMALMANAC,6,40,0695084e19166d1c4bfd0000fc0ca100c5c3b100ce02d9003b4f9d00d5188000 0000000000000000*45 $PSTMALMANAC,15,40,0f95084e2e722af847fd00008a0da10099dc0100d2cd2b005ba5c300a90f800 00000000000000000*29 2.3.7. PSTMCOLD Performs a cold start. The cold start restarts the GNSS engine without location information stored in the receiver, including time, position and ephemeris data. Type: Command Synopsis: $PSTMCOLD* Parameter: None L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 50 / 113 Result: The receiver will be restarted and no message will be sent as a reply. Example: $PSTMCOLD*1E GNSS Module Series 2.3.8. PSTMWARM Performs a warm start. The warm start restarts the GNSS engine, and the modules retain valid position, time and almanac. However, the ephemeris becomes invalid, requiring the modules to download the ephemeris before achieving a fix. Type: Command Synopsis: $PSTMWARM* Parameter: None Result: The receiver will be restarted and no message will be sent as a reply. Example: $PSTMWARM*13 2.3.9. PSTMHOT Performs a hot start. The hot start restarts the GNSS engine, and the modules retain valid position, time, ephemeris and almanac. As a result, the modules will achieve positioning in a shorter time. Type: Command Synopsis: $PSTMHOT* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 51 / 113 Parameter: None Result: The receiver will be restarted and no message will be sent as a reply. Example: $PSTMHOT*49 2.3.10. PSTMSRR Executes a system reset. The receiver will be rebooted. Type: Command Synopsis: $PSTMSRR* Parameter: None Result: The receiver will be rebooted and no message will be sent as a reply. Example: $PSTMSRR*49 2.3.11. PSTMSBASSERVICE Switches between SBAS services or disables the SBAS service. Type: Command Synopsis: $PSTMSBASSERVICE,* GNSS Module Series L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 52 / 113 GNSS Module Series Parameter: Field Format Numeric Unit Description SBAS service. 0 = WAAS 1 = EGNOS - 2 = MSAS 3 = GAGAN 7 = OFF 15 = AUTO Result: ⚫ If is set to 0, 1, 2 or 3, the SBAS engine will assign all satellites associated with the specified service to the tracker. ⚫ If is set to 7 (OFF), no satellites will be assigned to the tracker. ⚫ If is set to 15 (AUTO), the SBAS engine automatically selects the appropriate SBAS service based on the computed user position (latitude and longitude). ⚫ If successful, the module returns: $PSTMSBASSERVICEOK* ⚫ If failed, the module returns: $PSTMSBASSERVICEERROR* Example: $PSTMSBASSERVICE,15*6C $PSTMSBASSERVICEOK*40 2.3.12. PSTMSBASONOFF Suspends/resumes the SBAS software execution. Type: Command Synopsis: $PSTMSBASONOFF* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 53 / 113 GNSS Module Series Parameter: None Result: ⚫ If SBAS is running, it will be suspended. If SBAS has been suspended, it will start running. ⚫ No message is sent as a reply. Example: $PSTMSBASONOFF*57 2.3.13. PSTMGETRTCTIME Gets the current RTC time and status. Type: Get Synopsis: $PSTMGETRTCTIME* Parameter: None Result: ⚫ The module returns RTC time and status: $PSTMRTCTIME,,,,* Parameters included in the result: Field Format Unit hhmmss.sss - ddmmyy - Description Current time read on RTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Current date read on RTC. dd: Day of month mm: Month yy: Year L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 54 / 113 GNSS Module Series Field Format Unit Numeric - Numeric - Example: $PSTMGETRTCTIME*1C $PSTMRTCTIME,022234.670,150222,2,8*5C Description RTC status. 0 = RTC status invalid 1 = RTC status stored 2 = RTC status approximate Validity. 0 = No time 1 = Flash time 2 = TOW time 3 = User time 4 = User RTC time 5 = RTC time 6 = RTC time accurate 7 = Approximate time 8 = Accurate time 9 = Position time 10 = Ephemeris time 2.3.14. PSTMSETCONSTMASK Sets the GNSS constellation mask. It takes effect immediately. The settings can only be saved if you issue PSTMSAVEPAR and then reset the system with PSTMSRR. Once saved, the configurations will remain unchanged even after a power cycling. Type: Set Synopsis: $PSTMSETCONSTMASK,* Parameter: Field Format Unit Numeric - Description Bitmask where each bit enables or disables a specific constellation independently of the others. Bit 0 = Enable or disable GPS constellation Bit 1 = Enable or disable GLONASS constellation L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 55 / 113 GNSS Module Series Field Format Unit Description Bit 2 = Enable or disable QZSS constellation Bit 3 = Enable or disable Galileo constellation Bit 7 = Enable or disable BDS constellation Result: ⚫ If successful, the module returns: $PSTMSETCONSTMASKOK,* ⚫ If failed, the module returns: $PSTMSETCONSTMASKERROR* Example: Enable GPS only: $PSTMSETCONSTMASK,1*14 $PSTMSETCONSTMASKOK,1*10 Enable GLONASS only: $PSTMSETCONSTMASK,2*17 $PSTMSETCONSTMASKOK,2*13 Enable GPS and GLONASS: $PSTMSETCONSTMASK,3*16 $PSTMSETCONSTMASKOK,3*12 NOTE If the default value is not given for any parameter in a Set command, you can query it with the corresponding Get command if the default setting has not been changed. If the default setting had been changed with the Set command, contact Quectel Technical Support (support@quectel.com) for the default setting. 2.3.15. PSTMCFGCONST Configures satellite constellation. The settings can only take effect if you issue PSTMSAVEPAR and then reset the system with PSTMSRR. Once saved, the configurations will remain unchanged even after a power cycling. Type: Set L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 56 / 113 GNSS Module Series Synopsis: $PSTMCFGCONST,,,,,* Parameter: Field Format Unit Unsigned - Unsigned - Unsigned - Unsigned - Unsigned - Description GPS constellation status. 0 = Constellation off 1 = Constellation being tracked 2 = Constellation being tracked and used in positioning GLONASS constellation status. 0 = Constellation off 1 = Constellation being tracked 2 = Constellation being tracked and used in positioning Galileo constellation status. 0 = Constellation off 1 = Constellation being tracked 2 = Constellation being tracked and used in positioning QZSS constellation status. 0 = Constellation off 1 = Constellation being tracked 2 = Constellation being tracked and used in positioning BDS constellation status. 0 = Constellation off 1 = Constellation being tracked 2 = Constellation being tracked and used in positioning Result: ⚫ If successful, the module returns: $PSTMCFGCONSTOK* ⚫ If failed, the module returns: $PSTMCFGCONSTERROR* Example: $PSTMCFGCONST,2,0,0,0,0*03 $PSTMCFGCONSTOK*19 2.3.16. PSTMPPS Sets/gets configurations related to the 1PPS feature. Configurations are not saved after a reset. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 57 / 113 GNSS Module Series Type: Set/Get Synopsis: $PSTMPPS,,,[,…,]* Parameter: Field Format Numeric Numeric ,…, - Unit Description Command operation mode. - 1 = GET operation (to get data for PPS management) 2 = SET operation (to set data for PPS management) Command type. 1 = PPS_IF_ON_OFF_CMD 2 = PPS_IF_OUT_MODE_CMD 4 = PPS_IF_PULSE_DELAY_CMD 5 = PPS_IF_PULSE_DURATION_CMD 6 = PPS_IF_PULSE_POLARITY_CMD 7 = PPS_IF_PULSE_DATA_CMD 8 = PPS_IF_FIX_CONDITION_CMD 9 = PPS_IF_SAT_TRHESHOLD_CMD 10 = PPS_IF_ELEVATION_MASK_CMD - 11 = PPS_IF_COSTELLATION_MASK_CMD 12 = PPS_IF_TIMING_DATA_CMD 13 = PPS_IF_POSITION_HOLD_DATA_CMD 14 = PPS_IF_AUTO_HOLD_SAMPLES_CMD 15 = PPS_IF_TRAIM_CMD 16 = PPS_IF_TRAIM_USED_CMD 17 = PPS_IF_TRAIM_RES_CMD 18 = PPS_IF_TRAIM_REMOVED_CMD 19 = PPS_IF_REFERENCE_TIME_CMD 20 = PPS_IF_CONSTELLATION_RF_DELAY_CMD - Parameters in accordance with the command types. Result: According to the operation mode, parameters for PPS management are retrieved or set. For details, refer to the commands listed in the following sub-chapters (i.e., Chapter 2.3.16.1 Getting PPS Data: PPS_IF_PULSE_DATA_CMD to Chapter 2.3.16.23 Setting PPS Data: PPS_IF_TRAIM_CMD). ⚫ For SET operations, if successful, the module returns: $PSTMPPSOK,2,* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 58 / 113 ⚫ For both SET and GET operations, if failed, the module returns: $PSTMPPSERROR* GNSS Module Series 2.3.16.1. Getting PPS Data: PPS_IF_PULSE_DATA_CMD Gets the operating modes for PPS signal generation. Type: Get Synopsis: $PSTMPPS,1,7* Result: $PSTMPPS,1,7,,,,,* Parameters included in the result: Field Format Numeric Numeric Numeric Numeric Numeric Unit - - Nanosecond Second - Description PPS generation mode. 0 = PPS always generated 1 = PPS generated on even seconds 2 = PPS generated on odd seconds PPS reference time. 0 = UTC 1 = GPS UTC 2 = GLONASS UTC 3 = UTC (SU) 4 = GPS UTC from GLONASS 5 = BDS UTC 6 = UTC (NTSC) 7 = Galileo 8 = UTC Galileo 9 = GPS from Galileo Pulse delay. Pulse duration. Pulse polarity. 0 = Not inverted L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 59 / 113 GNSS Module Series Field Format Unit Example: $PSTMPPS,1,7*4F $PSTMPPS,1,7,0,0,0,0.500000,0*78 Description 1 = Inverted NOTE 1. UTC (SU) is the Universal Time Coordinated of Russia; it is derived from GLONASS time by applying the UTC delta time downloaded from GLONASS satellites. 2. GPS UTC from GLONASS is the GPS time derived from GLONASS time by applying the GPS delta time downloaded from GLONASS satellites. 3. If the software is configured to work in GLONASS-only mode, UTC (SU) is identical to UTC and GPS UTC from GLONASS is identical to GPS UTC. 2.3.16.2. Getting PPS Data: PPS_IF_TIMING_DATA_CMD Gets the timing data for PPS management. Type: Get Synopsis: $PSTMPPS,1,12* Result: $PSTMPPS,1,12,,,,,,< GLONASS_RF_Delay>* Parameters included in the result: Field Format Unit Numeric - Description GNSS fix condition for generating PPS signal. 0 or 1 = No fix 2 = 2D fix 3 = 3D fix L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 60 / 113 GNSS Module Series Field Format Numeric Numeric Hexadecimal Numeric Unit Description Degree - Minimum number of satellites for generating PPS signal. Minimum satellite elevation for satellite usage in timing filtering. Satellite constellation bitmask for timing filtering. Bit 0 = GPS Bit 1 = GLONASS Bit 3 = Galileo Bit 7 = BDS Nanosecond GPS path RF delay. Numeric Second GLONASS path RF delay. Example: $PSTMPPS,1,12*7B $PSTMPPS,1,12,0,0,10,0000000b,633,420*28 NOTE parameter enables the usage of mixed constellation satellites in the timing filtering. Mixing constellations for time correction means that satellites from one constellation are used to correct the reference time for other constellations. If GPS time is selected for PPS signal generation and bit 1 (or bit 7) is enabled, GLONASS satellites (or BDS satellites) are used to correct the GPS reference time. If GLONASS time is selected for PPS signal generation and bit 0 is enabled, GPS satellites are used to correct the GLONASS reference time. 2.3.16.3. Getting PPS Data: PPS_IF_POSITION_HOLD_DATA_CMD Gets the information about Position Hold feature. Type: Get Synopsis: $PSTMPPS,1,13* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 61 / 113 GNSS Module Series Result: $PSTMPPS,1,13,,,,,,* Parameters included in the result: Field Format Numeric ddmm.mmmmm Character dddmm.mmmmm Character Numeric Unit Description Position Hold status. - 0 = Disabled 1 = Enabled Latitude in degrees. dd: Degree - mm: Minutes mmmmm: Decimal fraction of minutes North-south direction. - N = North S = South Longitude in degrees. ddd: Degree - mm: Minutes mmmmm: Decimal fraction of minutes East-west direction. - E = East W = West - Height above mean sea level. Example: $PSTMPPS,1,13*7A $PSTMPPS,1,13,1,3149.29601,N,11706.91919,E,076.68*6A 2.3.16.4. Getting PPS Data: PPS_IF_TRAIM_CMD Gets the TRAIM-related information. TRAIM is a timing calibration algorithm. Type: Get Synopsis: $PSTMPPS,1,15* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 62 / 113 GNSS Module Series Result: $PSTMPPS,1,15,,,,,* Parameters included in the result: Field Format Numeric Numeric Numeric Numeric Numeric Unit Description TRAIM status. - 0 = Disabled 1 = Enabled TRAIM algorithm status. 0 = Under alarm - 1 = Over alarm 2 = Unknown Nanosecond Average time error. - Number of satellites used for timing correction. - Number of satellites removed by timing correction. Example: $PSTMPPS,1,15*7C $PSTMPPS,1,15,1,0,14,5,1*50 2.3.16.5. Getting PPS Data: PPS_IF_TRAIM_USED_CMD Gets satellites used in the TRAIM algorithm. Type: Get Synopsis: $PSTMPPS,1,16* Result: $PSTMPPS,1,16,,{,}* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 63 / 113 GNSS Module Series Parameters included in the result: Field Format Unit Numeric - Numeric - Start of repeat block. Repeat times. Numeric - End of repeat block. Example: $PSTMPPS,1,16*7F $PSTMPPS,1,16,1,4,26,31,16,4*4F Description TRAIM status. 0 = Disabled 1 = Enabled Number of satellites used for timing correction. Satellite ID. 2.3.16.6. Getting PPS Data: PPS_IF_TRAIM_RES_CMD Gets satellite residuals in the TRAIM algorithm. Type: Get Synopsis: $PSTMPPS,1,17* Result: $PSTMPPS,1,17,,{,}* Parameters included in the result: Field Format Unit Numeric - Numeric - Start of repeat block. Repeat times. Description TRAIM status. 0 = Disabled 1 = Enabled Number of satellites used for timing correction. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 64 / 113 GNSS Module Series Field Format Numeric End of repeat block. Unit Description Nanosecond Satellite residuals. Each residual corresponds to the satellite in the used satellite list in the same position. Example: $PSTMPPS,1,17*7E $PSTMPPS,1,17,1,5,9,-10,-3,1,2*5E 2.3.16.7. Getting PPS Data: PPS_IF_TRAIM_REMOVED_CMD Gets the removed satellites in the TRAIM algorithm. Type: Get Synopsis: $PSTMPPS,1,18* Result: $PSTMPPS,1,18,,{,}* Parameters included in the result: Field Format Numeric Numeric Unit Description TRAIM status. - 0 = Disabled 1 = Enabled - Number of removed satellites. Start of repeat block. Repeat times. Numeric - Removed satellite ID. End of repeat block. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 65 / 113 Example: $PSTMPPS,1,18*71 $PSTMPPS,1,18,1,2,3,29*4A 2.3.16.8. Setting PPS Data: PPS_IF_ON_OFF_CMD Sets the status of PPS feature. Type: Set Synopsis: $PSTMPPS,2,1,* Parameter: Field Format Numeric Unit Description PPS feature status. - 0 = Off 1 = On Example: $PSTMPPS,2,1,1*57 $PSTMPPSOK,2,1*4E 2.3.16.9. Setting PPS Data: PPS_IF_OUT_MODE_CMD Sets PPS generation mode. Type: Set Synopsis: $PSTMPPS,2,2,* GNSS Module Series L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 66 / 113 Parameter: Field Format Numeric Example: $PSTMPPS,2,2,0*55 $PSTMPPSOK,2,2*4D GNSS Module Series Unit Description PPS generation mode. 0 = PPS always generated 1 = PPS generated on even seconds 2 = PPS generated on odd seconds 2.3.16.10. Setting PPS Data: PPS_IF_REFERENCE_TIME_CMD Sets reference time for PPS signal synchronization. Type: Set Synopsis: $PSTMPPS,2,19,* Parameter: Field Format Numeric Unit Description PPS reference time. 0 = UTC 1 = GPS UTC 2 = GLONASS UTC 3 = UTC (SU) - 4 = GPS UTC from GLONASS 5 = BDS UTC 6 = UTC (NTSC) 7 = Galileo 8 = UTC Galileo 9 = GPS from Galileo Example: $PSTMPPS,2,19,1*6E $PSTMPPSOK,2,19*77 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 67 / 113 GNSS Module Series NOTE 1. UTC (SU) is the Universal Time Coordinated of Russia; it is derived from GLONASS time by applying the UTC delta time downloaded from GLONASS satellites. 2. GPS UTC from GLONASS is the GPS time derived from GLONASS time by applying the GPS delta time downloaded from GLONASS satellites. 3. If the software is configured to work in GLONASS only mode, UTC (SU) is identical to UTC and GPS UTC from GLONASS is identical to GPS UTC. 2.3.16.11. Setting PPS Data: PPS_IF_PULSE_DELAY_CMD Sets PPS pulse delay. Type: Set Synopsis: $PSTMPPS,2,4,* Parameter: Field Format Numeric Unit Nanosecond Description Pulse delay. Example: $PSTMPPS,2,4,10*62 $PSTMPPSOK,2,4*4B 2.3.16.12. Setting PPS Data: PPS_IF_CONSTELLATION_RF_DELAY_CMD Sets the RF time delay for the satellite signal path. Type: Set Synopsis: $PSTMPPS,2,20,* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 68 / 113 Parameter: Field Format Numeric Numeric Example: $PSTMPPS,2,20,0,633*7F $PSTMPPSOK,2,20*7D GNSS Module Series Unit Description Satellite constellation type. 0 = GPS - 1 = GLONASS 3 = Galileo 7 = BDS Nanosecond Time delay. 2.3.16.13. Setting PPS Data: PPS_IF_PULSE_DURATION_CMD Sets the pulse duration of the PPS signal. Type: Set Synopsis: $PSTMPPS,2,5,* Parameter: Field Format Numeric Unit Description Second Pulse duration. Example: $PSTMPPS,2,5,0.5*49 $PSTMPPSOK,2,5*4A 2.3.16.14. Setting PPS Data: PPS_IF_PULSE_POLARITY_CMD Sets pulse polarity. The pulse duration is the time interval between the PPS rising edge and the next falling edge if polarity inversion is disabled or the time interval between falling and rising edge if polarity inversion is enabled. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 69 / 113 Type: Set Synopsis: $PSTMPPS,2,6,* Parameter: Field Format Numeric Unit Description Pulse polarity. - 0 = Not inverted 1 = Inverted Example: $PSTMPPS,2,6,0*51 $PSTMPPSOK,2,6*49 GNSS Module Series 2.3.16.15. Setting PPS Data: PPS_IF_PULSE_DATA_CMD Sets the operating modes for PPS signal generation. Type: Set Synopsis: $PSTMPPS,2,7,,,,,* Parameter: Field Format Numeric Numeric Unit Description PPS generation mode. 0 = PPS always generated - 1 = PPS generated on even seconds 2 = PPS generated on odd seconds PPS reference time. 0 = UTC - 1 = GPS UTC 2 = GLONASS UTC 3 = UTC (SU) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 70 / 113 GNSS Module Series Field Format Numeric Numeric Numeric Example: $PSTMPPS,2,7,0,1,10,0.5,0*7B $PSTMPPSOK,2,7*48 Unit Description 4 = GPS UTC from GLONASS 5 = BDS UTC 6 = UTC (NTSC) 7 = Galileo 8 = UTC Galileo 9 = GPS from Galileo Nanosecond Pulse delay. Second - Pulse duration. Pulse polarity. 0 = Not inverted 1 = Inverted NOTE 1. UTC (SU) is the Universal Time Coordinated of Russia; it is derived from GLONASS time by applying the UTC delta time downloaded from GLONASS satellites. 2. GPS UTC from GLONASS is the GPS time derived from GLONASS time by applying the GPS delta time downloaded from GLONASS satellites. 3. If the software is configured to work in GLONASS only mode, UTC (SU) is identical to UTC and GPS UTC from GLONASS is identical to GPS UTC. 2.3.16.16. Setting PPS Data: PPS_IF_FIX_CONDITION_CMD Sets GNSS fix condition for generating PPS signal. Type: Set Synopsis: $PSTMPPS,2,8,* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 71 / 113 Parameter: Field Format Numeric Example: $PSTMPPS,2,8,1*5E $PSTMPPSOK,2,8*47 GNSS Module Series Unit Description GNSS fix condition for generating PPS signal. 0 or 1 = No fix 2 = 2D fix 3 = 3D fix 2.3.16.17. Setting PPS Data: PPS_IF_SAT_TRHESHOLD_CMD Sets minimum number of satellites for generating PPS signal. Type: Set Synopsis: $PSTMPPS,2,9,* Parameter: Field Format Numeric Unit Description - Minimum number of satellites for generating PPS signal. Example: $PSTMPPS,2,9,5*5B $PSTMPPSOK,2,9*46 2.3.16.18. Setting PPS Data: PPS_IF_ELEVATION_MASK_CMD Sets the minimum elevation of a satellite when it is used in timing filtering. Type: Set L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 72 / 113 GNSS Module Series Synopsis: $PSTMPPS,2,10,* Parameter: Field Format Numeric Unit Description - Minimum satellite elevation for timing filtering. Example: $PSTMPPS,2,10,10*57 $PSTMPPSOK,2,10*7E 2.3.16.19. Setting PPS Data: PPS_IF_CONSTELLATION_MASK_CMD Selects the satellite constellation for timing filtering. Type: Set Synopsis: $PSTMPPS,2,11,* Parameter: Field Format Numeric Unit Description Satellite constellation bitmask for timing filtering. Bit 0 = GPS - Bit 1 = GLONASS Bit 3 = Galileo Bit 7 = BDS Example: $PSTMPPS,2,11,1*66 $PSTMPPSOK,2,11*7F NOTE parameter enables the usage of mixed satellite constellations in the timing filtering. Mixed constellations for time correction mean that satellites from one constellation are used L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 73 / 113 GNSS Module Series for correcting the reference time for other constellations. If GPS time is selected for PPS signal generation and bit 1 (or bit 7) is enabled, also GLONASS satellites (or BDS satellites) are used to correct the GPS reference time. If GLONASS time is selected for PPS signal generation and bit 0 is enabled, GPS satellites are used to correct the GLONASS reference time. 2.3.16.20. Setting PPS Data: PPS_IF_TIMING_DATA_CMD Sets the timing data for PPS management. Type: Set Synopsis: $PSTMPPS,2,12,,,,* Parameter: Field Format Unit Numeric - Numeric Numeric - Numeric - Description GNSS fix condition for PPS signal generation. 0 or 1 = No fix 2 = 2D fix 3 = 3D fix Minimum number of satellites for PPS signal generation. Minimum satellite elevation for satellite usage in timing filtering. Satellite constellation bitmask for timing filtering. Bit 0 = GPS Bit 1 = GLONASS Bit 3 = Galileo Bit 7 = BDS Example: $PSTMPPS,2,12,0,0,10,11*79 $PSTMPPSOK,2,12*7C 2.3.16.21. Setting PPS Data: PPS_IF_POSITION_HOLD_DATA_CMD Sets Position Hold feature. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 74 / 113 GNSS Module Series Type: Set Synopsis: $PSTMPPS,2,13,,,,,,* Parameter: Field Format Unit Numeric - ddmm.mmmmm - Character - dddmm.mmmmm - Character - Numeric - Description Position Hold status. 0 = Disabled 1 = Enabled Latitude in degrees. dd: Degree mm: Minutes mmmmm: Decimal fraction of minutes North-south direction. N = North S = South Longitude in degrees. ddd: Degree mm: Minutes mmmmm: Decimal fraction of minutes East-west direction. E = East W = West Height above mean sea level. Example: $PSTMPPS,2,13,1,3149.32536,N,11706.98049,E,136.42*6C $PSTMPPSOK,2,13*7D 2.3.16.22. Setting PPS Data: PPS_IF_AUTO_HOLD_SAMPLES_CMD Sets the number of position samples for the auto position algorithm. Type: Set L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 75 / 113 GNSS Module Series Synopsis: $PSTMPPS,2,14,* Parameter: Field Format Unit Numeric - Description Number of position samples for the auto position algorithm. If the number of samples is set to '0', the auto position hold feature is disabled. Position average evaluation is restarted every time the command is executed. Maximum value: 65535. Example: $PSTMPPS,2,14,3600*57 $PSTMPPSOK,2,14*7A 2.3.16.23. Setting PPS Data: PPS_IF_TRAIM_CMD Sets the time error threshold for satellite removal in the TRAIM algorithm. Satellites which have a time error greater than the TRAIM threshold are not used for time correction. If the time correction error is greater that the TRAIM threshold, the TRAIM alarm will be raised. Type: Set Synopsis: $PSTMPPS,2,15,,,* Parameter: Field Format Numeric Numeric Numeric Unit Description Enable or disable TRAIM. - 0 = Disable 1 = Enable Second TRAIM alarm – scientific notation is allowed. Enable or disable TRAIM adaptive mode. - 0 = Disable 1 = Enable L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 76 / 113 Example: $PSTMPPS,2,15,1,1.000000E-06,0*23 $PSTMPPSOK,2,15*7B GNSS Module Series 2.3.17. PSTMFORCESTANDBY Forces the module to enter the Standby mode. Type: Command Synopsis: $PSTMFORCESTANDBY,* Parameter: Field Format Unit Numeric Second Description Standby time duration. Valid range: 0–65535. When set to 0, the module stays in the Standby mode until it is awakened by hardware. For details, see documents [1], [2], [3] and [4] hardware designs. Result: ⚫ If successful, the module returns: $PSTMFORCESTANDBYOK* ⚫ If failed, the module returns: $PSTMFORCESTANDBYERROR* Example: $PSTMFORCESTANDBY,5*09 $PSTMFORCESTANDBYOK*14 NOTE If the module enters Standby mode immediately after receiving the $PSTMFORCESTANDBY command, $PSTMFORCESTANDBYOK*14 will not be returned. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 77 / 113 GNSS Module Series 2.3.18. PSTMCFGPORT Configures a general-purpose port for NMEA purpose. The settings can only be saved if you issue PSTMSAVEPAR and then reset the system with PSTMSRR. Once saved, the configurations will remain unchanged even after a power cycling. Type: Set Synopsis: $PSTMCFGPORT,,,,* Parameter: Field Format Numeric Numeric 1) Numeric Numeric Unit Description Port type. - 0 = UART Protocol type. 0 = NMEA - NMEA port number (linearly addressed). Range: 0–255. Port baud rate. 9600 14400 19200 38400 bps 57600 115200 230400 460800 921600 Result: ⚫ If successful, the module returns: $PSTMCFGPORTOK* ⚫ If failed, the module returns: $PSTMCFGPORTERROR* Example: //Get the current NMEA port number: $PSTMGETPAR,1101*22 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 78 / 113 GNSS Module Series //Response: $PSTMSETPAR,1101,0x01*53 //According to the response, the current NMEA port number is 01. The commands for changing the baud rate to 230400 bps are as follows. //Set a general-purpose port for NMEA: $PSTMCFGPORT,0,0,1,230400*75 //Response: $PSTMCFGPORTOK*45 //Save the configuration: $PSTMSAVEPAR*58 //Response: $PSTMSAVEPAROK*5C //Restart the module: $PSTMSRR*49 NOTE 1. No NMEA sentence will be output if the configuration of this parameter is incorrect. This issue can only be resolved by re-flashing firmware. 2. L26-DR series only supports the following baud rates: 115200, 230400, 460800, and 921600 bps. 2.3.19. PSTMCFGTDATA Configures date and time-related parameters. The setting can only take effect if you issue PSTMSAVEPAR and then reset the system with PSTMSRR. Once saved, the configurations will remain unchanged even after a power cycling. Type: Set Synopsis: $PSTMCFGTDATA,,,,* Parameter: Field Format Unsigned Unsigned Unit Description Minimum GPS week number. - Default value: 1964. Maximum GPS week number. Default value: 3443. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 79 / 113 GNSS Module Series Double Unsigned Second Fix rate. Default value: 1.0. UTC delta time. Result: ⚫ If successful, the module returns: $PSTMCFGTDATAOK* ⚫ If failed, the module returns: $PSTMCFGTDATAERROR* Example: $PSTMCFGTDATA,1964,3443,1.0,10*38 $PSTMCFGTDATAOK*18 2.3.20. PSTMCFGMSGL Configures the message list, which allows you to enable or disable message output. The setting can only take effect if you issue PSTMSAVEPAR and then reset the system with PSTMSRR. Once saved, the configurations will remain unchanged even after a power cycling. Type: Set Synopsis: $PSTMCFGMSGL,,,,* Parameter: Field Format Unit Numeric - Numeric - Hexadecimal, 8 digits - Hexadecimal, 8 digits - Description List selector. 0 = NMEA list 0 (for messages output at 1 Hz) 2 = NMEA list 2 (for messages output at multi-Hz) Note that an output message cannot be configured by both message lists simultaneously. Rate scaler of a message list. Range: 0–255. Low 32 bits. See Table 13: NMEA Message List for details. High 32 bits. See Table 13: NMEA Message List for details. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 80 / 113 Table 13: NMEA Message List Low 32 Bits Bit Bitmask (32 bits) 0 0x1 1 0x2 2 0x4 3 0x8 4 0x10 5 0x20 6 0x40 7 0x80 8 0x100 9 0x200 10 0x400 11 0x800 12 0x1000 13 0x2000 14 0x4000 15 0x8000 16 0x10000 17 0x20000 18 0x40000 19 0x80000 20 0x100000 21 0x200000 22 0x400000 Function GNS message GGA message GSA message GST message VTG message Reserved RMC message Reserved $PSTMTG message $PSTMTS message Reserved Reserved $PSTMPRES message $PSTMVRES message Reserved $PSTMSBAS message Reserved Reserved Reserved Reserved GSV message GLL message $PSTMPPSDATA message Reserved GNSS Module Series L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 81 / 113 23 0x800000 24 0x1000000 25 0x2000000 26 0x4000000 27 0x8000000 28 0x10000000 29 0x20000000 30 0x40000000 31 0x80000000 High 32 Bits Bit Bitmask (32 bits) 32 0x1 33 0x2 34 0x4 35 0x8 36 0x10 37 0x20 38 0x40 39 0x80 40 0x100 41 0x200 42 0x400 43 0x800 44 0x1000 45 0x2000 GNSS Module Series $PSTMCPU message ZDA message $PSTMTRAIMSTATUS message $PSTMTRAIMUSED message $PSTMTRAIMRES message $PSTMTRAIMREMOVED message $PSTMPOSHOLD message Reserved Reserved Reserved $PSTMNOTCHSTATUS message Reserved Function $PSTMPV message Reserved $PSTMUTC message Reserved $PSTMANTENNASTATUS message $PSTMNAVM message Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 82 / 113 GNSS Module Series 46 0x4000 47 0x8000 48 0x10000 49 0x20000 50 0x40000 51 0x80000 52 0x100000 53 0x200000 54 0x400000 55 0x800000 56 0x1000000 57 0x2000000 58 0x4000000 59 0x8000000 60 0x10000000 61 0x20000000 62 0x40000000 63 0x80000000 Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved $PSTMDRSENMSG message Reserved Reserved RLM message Result: ⚫ If successful, the module returns: $PSTMCFGMSGLOK* ⚫ If failed, the module returns: $PSTMCFGMSGLERROR* Example: //Disable the output of RMC message: //Get low 32-bit NMEA message list 0: $PSTMGETPAR,1201*21 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 83 / 113 GNSS Module Series //Response: $PSTMSETPAR,1201,0x00180056*5B //Get high 32-bit message list 0: $PSTMGETPAR,1228*2A //Response: $PSTMSETPAR,1228,0x6ec20010*59 //The bitmask of $GPRMC message is 0x40, low 32 bits. Then, 0x00180056 - 0x40 = 0x00180016. //Set the message list 0: $PSTMCFGMSGL,0,1,00180016,6ec20010*41 //Response: $PSTMCFGMSGLOK*49 //Save the configuration: $PSTMSAVEPAR*58 //Response: $PSTMSAVEPAROK*5C //Restart the module: $PSTMSRR*49 2.3.21. PSTMCFGAGPS Enable or disable AGNSS. The setting can only take effect if you issue PSTMSAVEPAR and then reset the system with PSTMSRR. Once saved, the configurations will remain unchanged even after a power cycling. Type: Set Synopsis: $PSTMCFGAGPS,* Parameter: Field Format Numeric Unit Description Enable or disable AGNSS. - 0 = Disable 1 = Enable Result: ⚫ If successful, the module returns: $PSTMCFGAGPSOK* ⚫ If failed, the module returns: L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 84 / 113 $PSTMCFGAGPSERROR* Example: $PSTMCFGAGPS,1*40 $PSTMCFGAGPSOK*59 GNSS Module Series 2.3.22. PSTMIMUSELFTESTCMD Executes the self-test procedure in IMU. Only L26-DR (UDR, ADR, ADRC) and L26-P support this command. Type: Command Synopsis: $PSTMIMUSELFTESTCMD,* Parameter: Field Format Numeric Unit Description IMU type. - 0 = Accelerometer 1 = Gyroscope Result: ⚫ In successful, the module returns: $PSTMIMUSELFTESTCMDOK* ⚫ In failed, the module returns: $PSTMIMUSELFTESTCMDKO* ⚫ If the self-test command is not supported by the mounted IMU or by the FW (sensor layer is not present in FW), the module returns: $PSTMIMUSELFTESTCMDERROR* Example: //Executes accelerometer self-test: $PSTMIMUSELFTESTCMD,0*17 $PSTMIMUSELFTESTCMDOK*0F //Executes gyroscope self-test: L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 85 / 113 GNSS Module Series $PSTMIMUSELFTESTCMD,1*16 $PSTMIMUSELFTESTCMDOK*0F 2.3.23. PSTMSETTHTRK Configures the C/N0 and elevation mask angle thresholds for tracking. It takes effect immediately. The configuration will not be saved after a reset. Type: Set Synopsis: $PSTMSETTHTRK,,* Parameter: Field Format Numeric Numeric Unit dB-Hz Degree Description Tracking C/N0 threshold. Tracking elevation mask angle. Result: ⚫ If successful, the module returns: $PSTMSETTHTRKOK* ⚫ If failed, the module returns: $PSTMSETTHTRKERROR* Example: $PSTMSETTHTRK,7,5*0B $PSTMSETTHTRKOK*0D 2.3.24. PSTMSETTHPOS Configures the C/N0 and elevation mask angle thresholds for positioning. It takes effect immediately. The configuration will not be saved after a reset. Type: Set L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 86 / 113 GNSS Module Series Synopsis: $PSTMSETTHPOS,,* Parameter: Field Format Numeric Numeric Unit dB-Hz Degree Description Positioning C/N0 threshold. Positioning elevation mask angle. Result: ⚫ If successful, the module returns: $PSTMSETTHPOSOK* ⚫ If failed, the module returns: $PSTMSETTHPOSERROR* Example: $PSTMSETTHPOS,15,5*39 $PSTMSETTHPOSOK*0C 2.3.25. PSTMGETPAR,1500 Queries the firmware version information. Type: Command Synopsis: $PSTMGETPAR,1500* Parameter: None Result: ⚫ If successful, the module returns: $PSTMSETPAR,1500,* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 87 / 113 GNSS Module Series Parameters included in the result: Field Format Unit String - Description Firmware version information. ⚫ If failed, the module returns: $PSTMGETPARERROR* Example: $PSTMGETPAR,1500*27 $PSTMSETPAR,1500,L26ADRNR02A01V02*0A 2.3.26. PSTMSETPAR,1122 Switches the NMEA 0183 message format. The setting can only take effect if you issue $PSTMSAVEPAR and then reset the system with $PSTMSRR. Once saved, the configurations will remain unchanged even after a power cycling. Type: Set Synopsis: $PSTMSETPAR,1122,* Parameter: Field Format Hexadecimal Unit Description NMEA 0183 message format. 0x02 = NMEA 0183 V3.01 (only for L26-DR (ADRC)) 0x04 = NMEA 0183 V4.10 0x0C = NMEA 0183 V3.01 Result: ⚫ If successful, the module returns: $PSTMSETPAROK,1122* ⚫ If failed, the module returns: $PSTMSETPARERROR* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 88 / 113 Example: $PSTMSETPAR,1122,0x04*57 $PSTMSETPAROK,1122*33 GNSS Module Series 2.3.27. PSTMGETPAR,1122 Gets the NMEA 0183 message format. Type: Get Synopsis: $PSTMGETPAR,1122* Parameter: None Result: ⚫ If successful, the module returns: $PSTMSETPAR,1122,* Parameter included in the result: Field Format Unit Hexadecimal - Description NMEA 0183 message format. 0x02 = NMEA 0183 V3.01, only for L26-DR (ADRC) 0x04 = NMEA 0183 V4.10 0x0C = NMEA 0183 V3.01 ⚫ If failed, the module returns: $PSTMSETPARERROR* Example: $PSTMGETPAR,1122*23 $PSTMSETPAR,1122,0x0c*00 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 89 / 113 GNSS Module Series 2.3.28. PSTMSETPAR,1300 Configures the output message rate for the Low Latency Interface ( LLI) feature. The setting can only take effect if you issue PSTMSAVEPAR and then reset the system with PSTMSRR. Once saved, the configurations will remain unchanged even after a power cycling. Only L26-DR (AA, ADR), L26-P, L26-T, L26-T (D), and LC98S support this command. Type: Set Synopsis: $PSTMSETPAR,1300,* Parameter: Field Format Numeric Unit Description NMEA message output rate. 0.1 = 10 Hz - 0.2 = 5 Hz 0.5 = 2 Hz 0 = 1 Hz Result: ⚫ If successful, the module returns: $PSTMSETPAROK,1300* ⚫ If failed, the module returns: $PSTMSETPARERROR* Example: //Set RMC message 5 Hz output: //Get low 32-bit NMEA message list 0: $PSTMGETPAR,1201*21 //Response: $PSTMSETPAR,1201,0x00180056*5B //Get high 32-bit message list 0: $PSTMGETPAR,1228*2A //Response: $PSTMSETPAR,1228,0x6ec20010*59 //The bitmask of $GPRMC message is 0x40, low 32 bits. Then, 0x00180056 - 0x40 = 0x00180016. //Set the message list 0: L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 90 / 113 $PSTMCFGMSGL,0,1,00180016,6ec20010*41 //Response: $PSTMCFGMSGLOK*49 //Set the message list 2: $PSTMCFGMSGL,2,1,00000040,0*7A //Response: $PSTMCFGMSGLOK*49 //Enable the LLI: $PSTMSETPAR,1227,40000000,1*04 //Response: $PSTMSETPAROK,1227*35 //Set the RMC message output rate to 5 Hz: $PSTMSETPAR,1300,0.2*35 $PSTMSETPAROK,1300*31 //Save the configuration: $PSTMSAVEPAR*58 //Response: $PSTMSAVEPAROK*5C //Restart the module: $PSTMSRR*49 GNSS Module Series NOTE 1. This command can be used to configure the output rate of all output messages except $PSTMDRSENMSG. 2. When configuring 10 Hz output, it is recommended to change the baud rate to above 460800 bps to prevent data loss. 3. When configuring multi-Hz output, the LLI feature must be enabled with $PSTMSETPAR,1227,40000000,1*04. 2.3.29. PSTMSAVEPAR Saves the current configuration data block, including changed parameters, into the NVM backup memory. Type: Command Synopsis: $PSTMSAVEPAR* Parameter: None L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 91 / 113 Result: ⚫ If successful, the module returns: $PSTMSAVEPAROK* ⚫ If failed, the module returns: $PSTMSAVEPARERROR* Example: $PSTMSAVEPAR*58 $PSTMSAVEPAROK*5C GNSS Module Series 2.3.30. PSTMRESTOREPAR Restores the factory setting configurations. The configuration data block stored in the NVM backup memory, if present, will be invalidated. Any changed parameter will be lost. System rebooting is needed to complete factory setting restoration and to get system running on default configurations. Type: Command Synopsis: $PSTMRESTOREPAR* Parameter: None Result: ⚫ If successful, the module returns: $PSTMRESTOREPAROK* ⚫ If failed, the module returns: $PSTMRESTOREPARERROR* Example: $PSTMRESTOREPAR*11 $PSTMRESTOREPAROK*15 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 92 / 113 GNSS Module Series 2.3.31. PSTMANTENNASTATUS Reports antenna status (normal, open, or short-circuited). It also reports the information about the operating mode of antenna detection and the type of antenna (external or internal). LC98S does not support this message. Type: Output Synopsis: $PSTMANTENNASTATUS,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description Current antenna status. -1 = Antenna uninitialized - 0 = Normal 1 = Open 2 = Short-circuited Operating mode. 0 = Auto – the antenna is managed automatically by the - software logic 1 = Manual – the antenna’s on or off state or RF switching is controlled by commands Current RF path. - 0 = External antenna 1 = Internal antenna (not supported) Antenna power status. - 0 = On 1 = Off Example: $PSTMANTENNASTATUS,0,0,0,0*51 NOTE By default, the output of this message is enabled on the L26-DR series and L26-T series modules and disabled on the L26-P module. Therefore, for L26-P, execute the following commands after $PSTMCFGMSGL to ensure that $PSTMANTENNASTATUS is output accurately. //Set the sensing type to ADC mode: $PSTMSETPAR,1226,3481401E*62 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 93 / 113 //Response: $PSTMSETPAROK,1226*34 //Set the GPIO port of the power switch: $PSTMSETPAR,1242,00000018*17 //Response: $PSTMSETPAROK,1242*36 //Set GPIO mode: $PSTMSETPAR,1243,00000001*1E //Response: $PSTMSETPAROK,1243*37 //Set power on: $PSTMSETPAR,1244,00000001*19 //Response: $PSTMSETPAROK,1244*30 //Save the configuration: $PSTMSAVEPAR*58 //Response: $PSTMSAVEPAROK*5C //Restart the module: $PSTMSRR*49 GNSS Module Series 2.3.32. PSTMNOTCH Configures the Adaptive Notch Filter (ANF) operation mode. It takes effect immediately. The configuration will not be saved after a reset. Type: Set Synopsis: $PSTMNOTCH,,* Parameter: Field Format Numeric Numeric Unit Description Satellite type for ANF path. - 0 = GPS or Galileo 1 = GLONASS or BDS ANF operation mode. - 0 = Disabled 2 = Auto insertion mode (recommended) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 94 / 113 Result: ⚫ No message is sent as a reply. Example: $PSTMNOTCH,0,0*44 $PSTMNOTCH,1,2*47 GNSS Module Series 2.3.33. PSTMNOTCHSTATUS Reports information on the Adaptive Notch Filter (ANF) status. When ANF is disabled, all parameters are set to zero. Frequency/power values are relevant only when Notch Filter is locked. Type: Output Synopsis: $PSTMNOTCHSTATUS,,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Description Actual value of notch frequency estimation (GPS Hz path). Frequency lock flag (GPS path). - 0 = Unlocked. No interference detected. 1 = Locked. Interference detected. Internal power estimation of Band Pass Filter (GPS - path). Dimensionless quantity. Internal mask output used to calculate overflow flag status. - Overflow flag status (3 digits) = - 1000 × Frequency lock flag ANF mode (GPS path). - 0 = Disabled 2 = Auto insertion mode (recommended) Actual value of notch frequency estimation Hz (GLONASS path). Frequency lock flag (GLONASS path). - 0 = Unlocked. No interference detected. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 95 / 113 GNSS Module Series Field Format Unit Description 1 = Locked. Interference detected. Numeric Numeric Numeric - Internal power estimation of band pass filter (GLONASS path). Dimensionless quantity. Internal mask output used to calculate overflow flag status. Overflow flag status (3 digits) = - 1000 × Frequency lock flag ANF mode (GLONASS path): 0 = Disabled 2 = Auto insertion mode (recommended) Example: $PSTMNOTCHSTATUS,3616176,0,2187,0,2,7050638,0,3873,0,2*5E 2.3.34. PSTMDRSENMSG Outputs the IMU raw data. Only L26-DR (UDR, ADR, ADRC) and L26-P modules support this message. Type: Output Synopsis: $PSTMDRSENMSG,[,]* Parameter: Field Format Unit Numeric - - - Description Message ID. 24 = IMU temperature 30 = IMU accelerometer 31 = IMU gyroscope This field varies with the message type. See Chapters 2.3.34.1 IMU Temperature Message ( = 24), 2.3.34.2 IMU Accelerometer Message ( = 30), and 2.3.34.3 IMU Gyroscope Message ( = 31) for details. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 96 / 113 GNSS Module Series 2.3.34.1. IMU Temperature Message ( = 24) Outputs the IMU temperature. Type: Output Synopsis: $PSTMDRSENMSG,24,,,* Parameter: Field Format Numeric Numeric Numeric Unit Description - CPU tick count since the power on. IMU temperature. - Real temperature in degrees Celsius: Degrees Celsius = / 256 + 25.0 Validity. - 0 = Temperature is invalid. 1 = Temperature is valid. Example: $PSTMDRSENMSG,24,17186159,-787,1*2B 2.3.34.2. IMU Accelerometer Message ( = 30) Outputs the IMU accelerometer data. FS = ±2g Sensitivity = 0.061mg/LSB Type: Output Synopsis: $PSTMDRSENMSG,30,,,,* L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 97 / 113 GNSS Module Series Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description - CPU tick count since power on. Raw signed 16-bit integer X-axis acceleration data - in sensor frame. Raw signed 16-bit integer Y-axis acceleration data in sensor frame. Raw signed 16-bit integer Z-axis acceleration data in sensor frame. Example: $PSTMDRSENMSG,30,17370342,-2442,2272,16295*34 $PSTMDRSENMSG,30,17380596,-2443,2267,16305*39 2.3.34.3. IMU Gyroscope Message ( = 31) Outputs the IMU gyroscope data. FS = ±125 dps Sensitivity = 4.375 mdps/LSB Type: Output Synopsis: $PSTMDRSENMSG,31,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description - CPU tick count since power on. Raw signed 16-bit integer X-axis angular rate data - in sensor frame. Raw signed 16-bit integer Y-axis angular rate data in sensor frame. Raw signed 16-bit integer Z-axis angular rate data in sensor frame. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 98 / 113 Example: $PSTMDRSENMSG,31,17370342,44,-5,-53*17 $PSTMDRSENMSG,31,17380596,61,-5,-50*13 GNSS Module Series 2.3.35. PSTMTG This message is intended solely for Quectel’s internal debugging purposes. 2.3.36. PSTMTS This message is intended solely for Quectel’s internal debugging purposes. 2.3.37. PSTMPPSDATA Outputs the PPS (Pulse Per Second) data. Type: Output Synopsis: $PSTMPPSDATA,,,,,,,,,,,,,,,,,,,,,,,,,,,*< Checksum> Parameter: Field Format Unit Numeric - Numeric - Numeric - Numeric - Description PPS feature status. 0 = Off 1 = On PPS validity flag. 0 = Invalid 1 = Valid PPS synchronization validity. 0 = Invalid 1 = Valid PPS output mode. 0 = PPS always generated L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 99 / 113 Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric GNSS Module Series Unit Second Description 1 = PPS generated on even seconds 2 = PPS generated on odd seconds PPS reference time. 0 = UTC 1 = GPS UTC 2 = GLONASS UTC 3 = UTC (SU) 4 = GPS UTC from GLONASS 5 = BDS UTC 6 = UTC (NTSC) 7 = Galileo 8 = UTC Galileo 9 = GPS from Galileo Refence constellation: 0 = GPS 1 = GLONASS 3 = Galileo 7 = BDS Pulse duration. Nanosecond Pulse delay. Nanosecond GPS path RF delay. Nanosecond GLONASS path RF delay. Nanosecond BDS path RF delay. Nanosecond Galileo path RF delay. Pulse polarity. - 0 = Not inverted 1 = Inverted GNSS fix condition for PPS signal generation. - 0 or 1 = No fix 2 = 2D fix 3 = 3D fix Minimum number of satellites for - generating PPS signal. Minimum satellite elevation for time - correction. Selected constellation(s) for time - correction. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 100 / 113 GNSS Module Series Field Format Numeric Numeric Numeric Unit Second - Description Bit 0 = GPS Bit 1 = GLONASS Bit 3 = Galileo Bit 7 = BDS Seconds at which the reported PPS data is applied. According to the reference time configuration it could be UTC, GPS, GLONASS or BDS time seconds. GNSS position fix status when the time has been corrected. Satellites used for correcting time. Numeric Second UTC-GPS leap seconds. Numeric Nanosecond UTC-GPS delta time. Numeric Nanosecond UTC-GLONASS delta time. Numeric Nanosecond UTC-Galileo delta time. Numeric (scientific notation format) Second Quantization error. Numeric Hz PPS clock frequency. Numeric Hz TCXO clock frequency. Numeric Second UTC-BDS leap seconds. Example: $PSTMPPSDATA,1,0,0,0,0,0,0.500000,0,633,420,420,633,0,0,0,0,0,53,3,5,18,0,0,0,1.217e08,65473921.09,25999985.21,4*2C NOTE 1. In : 1) UTC (SU) is the Universal Time Coordinated of Russia, it is derived from GLONASS time by applying the UTC delta time downloaded from GLONASS satellites; 2) GPS UTC from GLONASS is the GPS time derived from GLONASS time by applying the GPS delta time downloaded from GLONASS satellites; 3) If the software is configured to work in GLONASS-only mode, UTC (SU) is identical to UTC and GPS UTC from GLONASS is identical to GPS UTC. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 101 / 113 GNSS Module Series 2. In , the reference constellation reports which reference time has been used for generating the PPS signal. 2.3.38. PSTMUTC Reports the UTC time, date, and time offset parameters. It is not supported for Galileo constellation. Type: Output Synopsis: $PSTMUTC,,,,,, ,,,,,* Parameter: Field Format Unit hhmmss.sss - ddmmyyyy - Numeric Second Numeric Second Numeric - Numeric Second Numeric - Numeric Second Numeric - Description UTC time of fix, example: 160836.000. 'sss' is the fraction of seconds. Date of fix. UTC time expressed as number of seconds since January 6, 1980. UTC to GPS time offset. UTC to GPS time offset validity. 0 = Invalid 1 = Read from NVM 2 = Valid (downloaded from sky) UTC to GLONASS time offset (always 0). UTC to GLONASS time offset validity. 0 = Invalid 1 = Read from NVM 2 = Valid (downloaded from sky) UTC to BDS time offset. UTC to BDS time offset validity. 0 = Invalid 1 = Read from NVM 2 = Valid (downloaded from sky) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 102 / 113 GNSS Module Series Field Format Numeric Numeric Unit Second - Description UTC to GPS time offset. UTC to GPS time offset validity. 0 = Invalid 1 = Read from NVM 2 = Valid (downloaded from sky) Example: $PSTMUTC,063216.000,15022022,1328941936,18,2,00,2,04,0,18,2*60 2.3.39. PSTMSBAS Outputs SBAS satellite data. Type: Output Synopsis: $PSTMSBAS,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit - - Degree Degree dB-Hz Description SBAS status. 0 = No SBAS used 1 = SBAS used SBAS satellite tracking status. 0 = SBAS satellite not tracked 1 = SBAS satellite tracked, ongoing decoding 2 = SBAS satellite tracked and decoded. Differential mode is on SBAS satellite ID. SBAS satellite elevation. SBAS satellite azimuth. SBAS satellite signal strength C/N0. Example: $PSTMSBAS,1,1,137,51,161,41*1B L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 103 / 113 GNSS Module Series NOTE By default, the SBAS feature is enabled on the L26-DR series, L26-P and L26-T series modules and disabled on the LC98S module. Therefore, for LC98S, it is necessary to send $PSTMCFGMSGL and $PSTMSBASONOFF commands to configure the output of the $PSTMSBAS message. 2.3.40. PSTMCPU Outputs the real-time CPU usage and the CPU speed setting. Type: Output Synopsis: $PSTMCPU,,,* Parameter: Field Format Numeric Numeric Numeric Unit - MHz Description CPU usage in percentage (%). PLL enabling or disabling status. 0 = PLL disabled 1 = PLL enabled -1 = Not supported CPU clock frequency. Values: 49, 98, 196 MHz. Example: $PSTMCPU,70.47,-1,196*78 2.3.41. PSTMPRES This message is intended solely for Quectel’s internal debugging purposes. 2.3.42. PSTMVRES This message is intended solely for Quectel’s internal debugging purposes. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 104 / 113 GNSS Module Series 2.3.43. PSTMPV This message is intended solely for Quectel’s internal debugging purposes. 2.3.44. PSTMNAVM This message is intended solely for Quectel’s internal debugging purposes. 2.3.45. PSTMPOSHOLD Reports the Position Hold status and position. Type: Output Synopsis: $PSTMPOSHOLD,,,,,,* Parameter: Field Format Unit Numeric - ddmm.mmmmm - Character - dddmm.mmmmm - Character Numeric Meter Description Position Hold status. 0 = Disabled 1 = Enabled Latitude in degrees. dd: Degree mm: Minutes mmmmm: Decimal fraction of minutes North-south direction. N = North S = South Longitude in degrees. ddd: Degree mm: Minutes mmmmm: Decimal fraction of minutes East-west direction. E = East W = West Height above mean sea level. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 105 / 113 Example: $PSTMPOSHOLD,0,9000.00000,N,00000.00000,E,-6356765.31*68 GNSS Module Series 2.3.46. PSTMTRAIMSTATUS Reports the TRAIM algorithm status. Please note that all TRAIM-related messages are enabled/disabled collectively by the same mask. Type: Output Synopsis: $PSTMTRAIMSTATUS,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Unit Description TRAIM status. - 0 = TRAIM disabled 1 = TRAIM enabled T-RAIM algorithm status. 0 = Under alarm - 1 = Over alarm 2 = Unknown Nanosecond Time error threshold. Numeric Nanosecond Average time error. Numeric - Number of satellites used for the timing correction. Numeric Numeric - Number of satellites removed by the timing correction. Second at which the PPS signal is generated based on reported TRAIM status. Example: $PSTMTRAIMSTATUS,1,1,15,-26,6,2,0*78 2.3.47. PSTMTRAIMUSED Reports the satellite used for timing correction. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 106 / 113 GNSS Module Series Type: Output Synopsis: $PSTMTRAIMUSED,,{,}* Parameter: Field Format Unit Numeric - Numeric - Start of repeat block. Repeat times. Numeric - End of repeat block. Description TRAIM status. 0 = Disabled 1 = Enabled Number of satellites used for timing correction. Satellite ID. Example: $PSTMTRAIMUSED,1,6,8,7,21,9,16,30*68 2.3.48. PSTMTRAIMRES Reports the time error residuals for satellites used for timing correction. Type: Output Synopsis: $PSTMTRAIMRES,,{,}* Parameter: Field Format Unit Description Numeric - TRAIM status. 0 = Disabled 1 = Enabled Numeric - Number of satellites used for timing correction. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 107 / 113 GNSS Module Series Field Format Unit Description Start of repeat block. Repeat times. Numeric - Time error residuals for satellites reported in $PSTMTRAIMUSED. Each residual corresponds to the satellite in the same message position. End of repeat block. Example: $PSTMTRAIMRES,1,6,-12,4,12,13,-12,-5*37 2.3.49. PSTMTRAIMREMOVED Reports the satellite removed in the timing correction algorithm. Type: Output Synopsis: $PSTMTRAIMREMOVED,,{,}* Parameter: Field Format Unit Numeric - Numeric - Start of repeat block. Repeat times. Numeric - End of repeat block. Description TRAIM status. 0 = Disabled 1 = Enabled Number of removed satellites. Removed satellite ID. Example: $PSTMTRAIMREMOVED,1,2,27,4*29 L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 108 / 113 GNSS Module Series 3 Appendix A References Table 14: Related Documents Document Name [1] Quectel_L26-DR_Series_Hardware_Design [2] Quectel_L26-P&L26-T_Hardware_Design [3] Quectel_L26-T(D)_Hardware_Design [4] Quectel_LC98S_Hardware_Design Table 15: Terms and Abbreviations Abbreviation 2D 3D ANF BDS C/N0 DOP DR EHPE Galileo GGA GLL GLONASS Description 2 Dimension 3 Dimension Adaptive Notch Filter BeiDou Navigation Satellite System Carrier-to-Noise-Density Ratio Dilution of Precision Dead Reckoning Equivalent Horizontal Position Error Galileo Satellite Navigation System (EU) Global Positioning System Fix Data Geographic Position – Latitude/Longitude Global Navigation Satellite System (Russia) L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 109 / 113 Abbreviation GNS GNSS GPIO GPS GSA GST GSV HDOP IMU LLI LSB NMEA NVM PDOP PLL PPS PRN PSTM QZSS RAIM RLM RMC RTC SBAS GNSS Module Series Description GNSS Fix Data Global Navigation Satellite System General-Purpose Input/Output Global Navigation Satellite System GPS DOP and Active Satellites GNSS Pseudorange Error Statistics GPS Satellites in View Horizontal Dilution of Precision Inertial Measurement Unit Low Latency Interface Least Significant Bit National Marine Electronics Association Non-Volatile Memory Position Dilution of Precision Phase Locked Loop Pulse Per Second Pseudo Random Noise ST Proprietary Message Quasi-Zenith Satellite System Receiver Autonomous Integrity Monitoring Return Link Message Recommended Minimum Specific GNSS Data Real-Time Clock Satellite-Based Augmentation System L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 110 / 113 Abbreviation TCXO TOW TRAIM UART UTC VDOP VTG ZDA GNSS Module Series Description Temperature Compensated Crystal Oscillator Time of Week Time-Receiver Autonomous Integrity Monitoring Universal Asynchronous Receiver/Transmitter Universal Time Coordinated Vertical Dilution of Precision Course Over Ground and Ground Speed Time & Date L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 111 / 113 GNSS Module Series 4 Appendix B GNSS (NMEA) Numbering Table 16: GNSS Satellites (NMEA) Numbering GNSS Type GPS GLONASS Galileo BDS QZSS SBAS System ID 1 2 3 4 5 - Satellite ID V3.01: 1–32 V4.10: 1–32 V3.01: 65–92 V4.10: 65–99 V3.01: 301–336 V4.10: 1–36 V3.01: 141–177 V4.10: 1–37 V3.01: 183–202 V4.10: 1–32 V3.01: 33–51 V4.10: 33–64 Signal ID 1 = L1 C/A 1 = L1 C/A 6 = L1-A 7 = L1-BC 1 = B1I 2 = B1Q 1 = L1 C/A - NOTE The table above is only applicable to standard NMEA messages. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 112 / 113 GNSS Module Series 5 Appendix C Special Characters Table 17: Special Characters Special Character [...] {…} Underline Definition Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. L26-DR&L26-P&L26-T&LC98S_Series_GNSS_Protocol_Specification 113 / 113

LC79D (A) GNSS Protocol Specification GNSS Module Series Version: 1.1 Date: 2022-05-20 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LC79D(A)_GNSS_Protocol_Specification 1 / 44 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. LC79D(A)_GNSS_Protocol_Specification 2 / 44 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LC79D (A) GNSS Protocol Specification GNSS Module Series GNSS Protocol Specification Released Revision History Version 1.0 Date 2019-12-11 1.1 2022-05-20 Description Initial 1. Added types for all messages. 2. Deleted the chapter of Commands. 3. Added the chapter of Structure of NMEA Protocol Messages. 4. Updated the contents and parameters of RMC, GGA, GSV, GSA, VTG and GLL sentences. 5. Deleted PQSTARTGNSS, PQSTOPGNSS, PQSETASSTIME, PQSETASSPOS and PQSETASSGNSS messages. 6. Added PQCFGEAMASK and PQCFGCLAMPING messages. 7. Deleted the chapter of Default Configurations. 8. Added the chapter of GNSS Numbering. LC79D(A)_GNSS_Protocol_Specification 3 / 44 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index .................................................................................................................................................. 6 1 Introduction ......................................................................................................................................... 7 2 NMEA Protocol .................................................................................................................................... 8 2.1. Structure of NMEA Protocol Messages ..................................................................................... 8 2.2. Standard Messages ................................................................................................................... 9 2.2.1. RMC ................................................................................................................................ 9 2.2.2. GGA................................................................................................................................11 2.2.3. GSV ............................................................................................................................... 14 2.2.4. GSA ............................................................................................................................... 15 2.2.5. VTG ............................................................................................................................... 17 2.2.6. GLL................................................................................................................................ 18 2.3. PQ Messages........................................................................................................................... 19 2.3.1. PQCOLD ....................................................................................................................... 20 2.3.2. PQWARM ...................................................................................................................... 20 2.3.3. PQHOT.......................................................................................................................... 21 2.3.4. PQSRR.......................................................................................................................... 21 2.3.5. PQSETSLEEP .............................................................................................................. 22 2.3.6. PQGETSLEEP .............................................................................................................. 22 2.3.7. PQSETGLP ................................................................................................................... 23 2.3.8. PQGETGLP................................................................................................................... 24 2.3.9. PQSETBAUD ................................................................................................................ 25 2.3.10. PQSETCNST ................................................................................................................ 26 2.3.11. PQGETCNST ................................................................................................................ 27 2.3.12. PQSETL5BIAS .............................................................................................................. 28 2.3.13. PQGETL5BIAS ............................................................................................................. 29 2.3.14. PQCFGODO ................................................................................................................. 29 2.3.15. PQREQODO ................................................................................................................. 30 2.3.16. PQRESETODO ............................................................................................................. 31 2.3.17. PQSTARTODO ............................................................................................................. 32 2.3.18. PQSTOPODO ............................................................................................................... 32 2.3.19. PQCFGGEOFENCE ..................................................................................................... 33 2.3.20. PQSETGEOFENCE...................................................................................................... 35 2.3.21. PQGETGEOFENCE ..................................................................................................... 35 2.3.22. PQREQGEOFENCE ..................................................................................................... 36 2.3.23. PQCFGNMEAMSG....................................................................................................... 37 2.3.24. PQCFGEAMASK .......................................................................................................... 38 2.3.25. PQCFGCLAMPING....................................................................................................... 39 2.3.26. PQSAVEPAR................................................................................................................. 40 LC79D(A)_GNSS_Protocol_Specification 4 / 44 GNSS Module Series 2.3.27. PQRESTOREPAR......................................................................................................... 40 3 Appendix A References .................................................................................................................... 42 4 Appendix B GNSS Numbering......................................................................................................... 44 LC79D(A)_GNSS_Protocol_Specification 5 / 44 GNSS Module Series Table Index Table 1: Structure of the NMEA Protocol Message...................................................................................... 8 Table 2: NMEA Talker ID .............................................................................................................................. 9 Table 3: Terms and Abbreviations .............................................................................................................. 42 Table 4: GNSS Numbering ......................................................................................................................... 44 LC79D(A)_GNSS_Protocol_Specification 6 / 44 GNSS Module Series 1 Introduction Quectel LC79D (A) GNSS module supports GPS, GLONASS, Galileo, BDS, QZSS and NavIC (IRNSS) constellations. The tracking of GPS L1 C/A, GPS L5-Q, GLONASS L1 C/A, Galileo E1, Galileo E5a, BDS B1l, QZSS L1 C/A, QZSS L5-Q and NavIC L5-SPS frequency bands provides fast and accurate acquisition and makes this module an ideal solution for positioning and navigation in various vertical markets. This document describes the software commands that are needed to control and modify the module configuration. The software commands are NMEA proprietary commands defined by Quectel (PQ commands). To report GNSS information, the module supports output messages in NMEA 0183 standard protocol. NOTE Quectel assumes no responsibility if commands other than the ones listed in this document are used. LC79D(A)_GNSS_Protocol_Specification 7 / 44 GNSS Module Series 2 NMEA Protocol 2.1. Structure of NMEA Protocol Messages The start character of the frame, always ‘$’ Address field, contains talker Identifier and sentence formatter Start with a ‘*’, 8-bit checksum value convert to two ASCII characters Data field(s), delimited by ‘,’ End frame, always $ () [,] * The range for checksum calculation Figure 1: Structure of the NMEA Protocol Message Table 1: Structure of the NMEA Protocol Message Field $ Description Start of the sentence (Hex 0x24). In Standard Messages: In NMEA standard messages, this field consists of a two-character talker identifier (TalkerID) and a three-character sentence formatter (SentenceFormatter). The talker identifier serves to define the nature of the data being transmitted. For more information on the TalkerID, see Table 2: NMEA Talker ID. The sentence formatter is used to define data format and type. In Proprietary Messages: In NMEA proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer's Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. Data fields, delimited by comma (,). Variable length (depends on the NMEA message type). LC79D(A)_GNSS_Protocol_Specification 8 / 44 GNSS Module Series The checksum field follows the checksum delimiter character *. The checksum is the 8-bit exclusive OR of all characters in the sentence, including the comma (,) delimiter, between but not including the $ and the * delimiters. End of the sentence (Hex 0x0D 0x0A). Table 2: NMEA Talker ID GNSS Constellation Configuration GPS GLONASS Galileo BDS QZSS NavIC (IRNSS) Combination of Multiple Satellite Systems TalkerID (NMEA V4.11) GP GL GA GB GQ GI GN 2.2. Standard Messages This chapter explains the NMEA 0183 V4.11 standard messages supported by the module. 2.2.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type: Output Synopsis: $RMC,,,,,,,,,,,,,* LC79D(A)_GNSS_Protocol_Specification 9 / 44 GNSS Module Series Parameter: Field $ RMC Format Unit - - String, 2 characters - String, 3 characters - hhmmss.ss - Character - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character Numeric Knot Example Description $ Each NMEA message starts with $. GN RMC 060512.00 A 3150.788156 N 11711.922383 E Talker identifier. See Table 2: NMEA Talker ID. Recommended Minimum Specific GNSS Data. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Positioning system status: A = Data valid V = Invalid D = Differential Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction: N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction: E = East W = West Note that this field is empty in case of an invalid value. 0.0 Speed over ground. Variable length. LC79D(A)_GNSS_Protocol_Specification 10 / 44 GNSS Module Series Numeric ddmmyy - - Character Character Hexadecimal Character Degree - - 311019 - - - - - A - V - *1B - - Note that this field is empty in case of an invalid value. Course over ground. Variable length. Maximum value: 359.9. Note that this field is empty in case of an invalid value. Date: dd: Day of month mm: Month yy: Year Magnetic variation. Not supported. The direction of magnetic variation. Not supported. Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid. Navigational status. Not supported. Always 'V' (Navigational status not valid). (NMEA V4.11) Checksum. Carriage return and line feed. Example: $GNRMC,000010.00,V,,,,,,,020712,,,N,V*1E $GNRMC,060512.00,A,3150.788156,N,11711.922383,E,0.0,,311019,,,A,V*1B 2.2.2. GGA Global Positioning System Fix Data. Time, position, and fix-related data for a GNSS receiver. Type: Output LC79D(A)_GNSS_Protocol_Specification 11 / 44 GNSS Module Series Synopsis: $GGA,,,,,,,,,,M,,M,,* Parameter: Field $ GGA Format Unit - - String, 2 characters - String, 3 characters - hhmmss.ss - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - Example Description $ Each NMEA message starts with $. GN GGA 062735.00 3150.788156 N 11711.922383 E Talker identifier. See Table 2: NMEA Talker ID. Global Positioning System Fix Data. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction: N = North S = South Note that this field is empty in case of an invalid value. Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction: E = East W = West Note that this field is empty in case of an invalid value. LC79D(A)_GNSS_Protocol_Specification 12 / 44 GNSS Module Series Numeric, 1 digit - 1 1) Numeric, 2 digits - 12 Numeric - 2.0 Numeric m 90.0 M Character - M Numeric m - M Character Hexadecimal Character - M - - - - - *55 - - GPS quality indicator: 0 = Fix not available or invalid 1 = GPS SPS Mode, fix valid 3 = GPS PPS Mode, fix valid Number of satellites in use. Horizontal dilution of precision. Altitude above mean-sea-level (geoid). Note that this field is empty in case of an invalid value. - Geoid separation (the difference between the earth ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). Note that this field is empty in case of an invalid value. - Differential GPS data age. Not supported. Differential reference station ID. Not supported. Checksum. Carriage return and line feed. Example: $GNGGA,000010.00,,,,,0,00,99.0,,M,,M,,*49 $GNGGA,062735.00,3150.788156,N,11711.922383,E,1,12,2.0,90.0,M,,M,,*55 NOTE 1. The NMEA 0183 specification indicates that the GGA message is GPS specific. However, when the receiver is configured for multi-constellations, the content of GGA message will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12. LC79D(A)_GNSS_Protocol_Specification 13 / 44 GNSS Module Series 2.2.3. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value. and contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of sentences being transmitted and the sentence number are indicated in the first two data fields. Type: Output Synopsis: $GSV,,,{,,,,}, * Parameter: Field Format Unit Example Description $ - - String, 2 characters - GSV String, 3 characters - Numeric - Numeric - Numeric - Start of repeat block. Repeat times: 1–4. Numeric - $ GP GSV 3 1 11 05 Numeric Degree 09 Numeric Numeric Degree 116 dB-Hz 27 Each NMEA message starts with $. Talker identifier. See Table 2: NMEA Talker ID. GNSS Satellites in View. Total number of sentences. Range: 1–9. Sentence number. Range: 1–. Total number of satellites in view. Maximum value: 32. Satellite ID. See Table 4: GNSS Numbering. Satellite elevation. Range: 00–90. Note that this field is empty in case of an invalid value. Satellite azimuth, with true north as the reference plane. Range: 000–359. Note that this field is empty in case of an invalid value. Satellite C/N0. Range 00–99. Null when not tracking. LC79D(A)_GNSS_Protocol_Specification 14 / 44 GNSS Module Series End of repeat block. Numeric - 1 GNSS signal ID. See Table 4: GNSS Numbering. Hexadecimal - *68 Checksum. Character - - Carriage return and line feed. Example: $GPGSV,3,1,11,05,09,116,27,10,24,312,44,12,09,141,28,13,14,055,41,1*68 $GPGSV,3,2,11,15,45,045,49,20,52,323,46,24,76,125,26,27,,,19,1*51 $GPGSV,3,3,11,10,24,312,43,24,76,125,13,27,,,19,8*63 $GLGSV,2,1,07,78,45,071,45,77,10,028,39,79,,,16,69,38,327,48,1*43 $GLGSV,2,2,07,84,35,279,21,85,09,331,32,67,09,083,44,1*4D $GQGSV,2,1,03,01,66,079,38,02,45,132,19,1*6A $GQGSV,2,2,03,01,66,079,35,8*56 $GBGSV,1,1,04,206,67,338,43,211,13,303,31,216,65,322,41,219,15,096,39,1*71 $GIGSV,1,1,02,03,38,233,23,07,,,25,1*44 NOTE GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, use separate GSV sentences with the corresponding Talker ID for each constellation. 2.2.4. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA sentence, and DOP values. Type: Output Synopsis: $GSA,,{,},,,* Parameter: Field $ Format - Unit Example Description - $ Each NMEA message starts with $. LC79D(A)_GNSS_Protocol_Specification 15 / 44 GNSS Module Series GSA String, 2 characters String, 3 characters - GN GSA Character - A Numeric - 3 Start of repeat block. Repeat times: 12. Numeric - 10 End of repeat block. Numeric Numeric Numeric Numeric Hexadecimal Character - 2.5 - 2.0 - 1.5 - 1 - *35 - - Example: $GNGSA,A,3,10,13,15,20,,,,,,,,,2.5,2.0,1.5,1*35 $GNGSA,A,3,67,69,77,78,85,,,,,,,,2.5,2.0,1.5,2*3F $GNGSA,A,3,,,,,,,,,,,,,2.5,2.0,1.5,3*32 $GNGSA,A,3,,,,,,,,,,,,,2.5,2.0,1.5,4*35 $GNGSA,A,3,01,,,,,,,,,,,,2.5,2.0,1.5,5*35 $GNGSA,A,3,,,,,,,,,,,,,2.5,2.0,1.5,6*37 Talker identifier. See Table 2: NMEA Talker ID. GNSS DOP and Active Satellites. M = Manual, forced to operate in 2D or 3D mode A = Automatic, allowed to automatically switch to 2D/3D 1 = Fix not available 2 = 2D 3 = 3D ID numbers of satellites used in solution. See Table 4: GNSS Numbering. Note that this field is empty in case of an invalid value. Position dilution of precision. Maximum value: 99.0. Horizontal dilution of precision. Maximum value: 99.0. Vertical dilution of precision. Maximum value: 99.0. GNSS system ID. See Table 4: GNSS Numbering. Checksum. Carriage return and line feed. NOTE If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used for navigation, only the IDs of the first 12 are output. LC79D(A)_GNSS_Protocol_Specification 16 / 44 GNSS Module Series 2.2.5. VTG Course Over Ground & Ground Speed. The actual course and speed relative to the ground. Type: Output Synopsis: $VTG,,T,,M,,N,,K,* Parameter: Field $ VTG T M N K Format Unit - - String, 2 characters - String, 3 characters - Numeric Degree Character Numeric Character Degree - Numeric Character Knot - Numeric km/h Character - Character - Example Description $ GN VTG T M 0.0 N 0.0 K A Each NMEA message starts with $. Talker identifier. See Table 2: NMEA Talker ID. Course Over Ground & Ground Speed. Course over ground, in true north course direction. Not supported. Course over ground. (degrees true, fixed field). Course over ground (magnetic). Not supported. Course over ground. (degrees magnetic, fixed field). Speed over ground in knots. Note that this field is empty in case of an invalid value. Speed over ground (knots, fixed field). Speed over ground in kilometers per hour. Note that this field is empty in case of an invalid value. Speed over ground. (kilometers per hour, fixed field). Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix LC79D(A)_GNSS_Protocol_Specification 17 / 44 GNSS Module Series Hexadecimal - Character - Example: $GNVTG,,T,,M,0.0,N,0.0,K,A*3D M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid. *3D Checksum. - Carriage return and line feed. 2.2.6. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type: Output Synopsis: $GLL,,,,,,,* Parameter: Field $ GLL Format Unit Example Description - - String, 2 characters - String, 3 characters - ddmm.mmmmmm - Character - $ GN GLL 3150.788156 N Each NMEA message starts with $. Talker identifier. See Table 2: NMEA Talker ID Geographic Position – Latitude/Longitude. Latitude: dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Latitude direction: N = North S = South Note that this field is empty in case of an invalid value. LC79D(A)_GNSS_Protocol_Specification 18 / 44 GNSS Module Series dddmm.mmmmmm - Character - hhmmss.ss - Character - Character - Hexadecimal - Character - 11711.922383 E 062735.00 A A Longitude: ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes Note that this field is empty in case of an invalid value. Longitude direction: E = East W = West Note that this field is empty in case of an invalid value. Position fix UTC: hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Positioning system status: V = Invalid A = Autonomous D = Differential Mode indicator: A = Autonomous mode. Satellite system used in non-differential mode in position fix M = Manual input mode N = No fix. Satellite system not used in position fix, or fix not valid. *76 Checksum. - Carriage return and line feed. Example: $GNGLL,,,,,000010.00,V,N*55 $GNGLL,3150.788156,N,11711.922383,E,062735.00,A,A*76 2.3. PQ Messages This chapter explains the PQ messages (proprietary NMEA messages defined by Quectel) supported by LC79D (A). LC79D(A)_GNSS_Protocol_Specification 19 / 44 2.3.1. PQCOLD Performs a cold start. Type: Command Synopsis: $PQCOLD* Parameter: None Result: Cold start initialization and GNSS engine restart. Example: $PQCOLD*05 2.3.2. PQWARM Performs a warm start. Type: Command Synopsis: $PQWARM* Parameter: None Result: Warm start initialization and GNSS engine restart. Example: $PQWARM*08 LC79D(A)_GNSS_Protocol_Specification GNSS Module Series 20 / 44 2.3.3. PQHOT Performs a hot start. Type: Command Synopsis: $PQHOT* Parameter: None Result: Hot start initialization and GNSS engine restart. Example: $PQHOT*52 2.3.4. PQSRR Executes a system reset. The GNSS firmware will be rebooted. Type: Command Synopsis: $PQSRR* Parameter: None Result: The GNSS firmware is rebooted and no message is sent as a reply. Example: $PQSRR*52 LC79D(A)_GNSS_Protocol_Specification GNSS Module Series 21 / 44 2.3.5. PQSETSLEEP Enables/disables sleep mode. Type: Set Synopsis: $PQSETSLEEP,* Parameter: Field Format Unit Numeric - Result: ⚫ If successful, the module returns: $PQSETSLEEPOK*08 ⚫ If failed, the module returns: $PQSETSLEEPERROR*54 Example: $PQSETSLEEP,1*11 $PQSETSLEEPOK*08 GNSS Module Series Description Sleep mode: 0 = Disable sleep mode (default) 1 = Enable sleep mode NOTE 1. In sleep mode, the UART is inaccessible. 2. When sleep mode is enabled with $PQSETSLEEP,1*11 and GNSS engine is stopped, the module can enter sleep mode by pulling down AP_REQ pin. 2.3.6. PQGETSLEEP Gets the status of sleep mode. Type: Get LC79D(A)_GNSS_Protocol_Specification 22 / 44 GNSS Module Series Synopsis: $PQGETSLEEP* Parameter: None Result: ⚫ If successful, the module returns: $PQSLEEP,* The parameter included in the result above is listed below: Field Format Unit Numeric - Description Sleep mode status: 0 = The sleep mode is disabled (default). 1 = The sleep mode is enabled. ⚫ If failed, the module returns: $PQGETSLEEPERROR*40 Example: $PQGETSLEEP*18 $PQSLEEP,1*53 2.3.7. PQSETGLP Enables/disables GNSS Low Power (GLP) mode. GLP is the best power-saving mode for acquisition and tracking. It helps the module to achieve a balance between performance and power consumption according to signal condition. Type: Set Synopsis: $PQSETGLP,* LC79D(A)_GNSS_Protocol_Specification 23 / 44 Parameter: Field Format Unit Numeric - Result: ⚫ If successful, the module returns: $PQSETGLPOK*1C ⚫ If failed, the module returns: $PQSETGLPERROR*40 Example: $PQSETGLP,1*05 $PQSETGLPOK*1C GNSS Module Series Description GLP mode: 0 = Disable GLP mode (default) 1 = Enable GLP mode NOTE The GNSS engine will be restarted if this command is executed successfully. 2.3.8. PQGETGLP Gets the status of GLP mode. Type: Get Synopsis: $PQGETGLP* Parameter: None Result: ⚫ If successful, the module returns: $PQGLP,* LC79D(A)_GNSS_Protocol_Specification 24 / 44 GNSS Module Series The parameter included in the result above is listed below: Field Format Unit Numeric - Description GLP mode status: 0 = The GLP mode is disabled (default). 1 = The GLP mode is enabled. ⚫ If failed, the module returns: $PQGETGLPERROR*54 Example: $PQGETGLP*0C $PQGLP,1*47 2.3.9. PQSETBAUD Configures NMEA port baud rate. Type: Set Synopsis: $PQSETBAUD,* Parameter: Field Format Unit Numeric bps Result: ⚫ If successful, the module returns: $PQSETBAUDOK*55 ⚫ If failed, the module returns: $PQSETBAUDERROR*09 Description Supported baud rates: 115200 (default) 230400 460800 921600 LC79D(A)_GNSS_Protocol_Specification 25 / 44 Example: $PQSETBAUD,115200*7A $PQSETBAUDOK*55 GNSS Module Series 2.3.10. PQSETCNST Configures the GNSS constellation mask. Type: Set Synopsis: $PQSETCNST,* Parameter: Field Format Unit Numeric - Description It is a bit mask where each bit enables (1 = enable) or disables (0 = disable) a specific constellation independently: bit 0: Enable/disable GPS constellation bit 1: Enable/disable GLONASS constellation bit 2: Enable/disable Galileo constellation bit 3: Enable/disable BDS constellation bit 4: Enable/disable NavIC constellation bit 5: Enable/disable QZSS constellation Result: ⚫ If successful, the module returns: $PQSETCNSTOK*4D ⚫ If failed, the module returns: $PQSETCNSTERROR*11 Example: $PQSETCNST,63*60 $PQSETCNSTOK*4D LC79D(A)_GNSS_Protocol_Specification 26 / 44 GNSS Module Series NOTE The GNSS engine will be restarted if the command is executed successfully. 2.3.11. PQGETCNST Gets the information of GNSS constellation mask. Type: Get Synopsis: $PQGETCNST* Parameter: None Result: ⚫ If successful, the module returns: $PQCNST,* The parameter included in the result above is listed below: Field Format Unit Numeric - Description It is a bit mask where each bit enables (1 = enable) or disables (0 = disable) a specific constellation independently: bit 0: GPS constellation is enabled/disabled. bit 1: GLONASS constellation is enabled/disabled. bit 2: Galileo constellation is enabled/disabled. bit 3: BDS constellation is enabled/disabled. bit 4: NAVIC constellation is enabled/disabled. bit 5: QZSS constellation is enabled/disabled. ⚫ If failed, the module returns: $PQGETCNSTERROR*05 Example: $PQGETCNST*5D $PQCNST,63*22 LC79D(A)_GNSS_Protocol_Specification 27 / 44 GNSS Module Series 2.3.12. PQSETL5BIAS Configures the L5 bias value. This value is used for correcting the L5 delay, and it can be acquired by connecting the module to QGNSS tool in open sky conditions. Type: Set Synopsis: $PQSETL5BIAS,* Parameter: Field Format Unit Numeric - Description L5 bias value. Result: ⚫ If successful, the module returns: $PQSETL5BIASOK*27 ⚫ If failed, the module returns: $PQSETL5BIASERROR*7B Example: $PQSETL5BIAS,14.6*12 $PQSETL5BIASOK*27 $PQSAVEPAR*43 $PQSAVEPAROK*47 NOTE The configuration takes effect after rebooting, and it must be saved by $PQSAVEPAR (see Chapter 2.3.26 for details) before rebooting. LC79D(A)_GNSS_Protocol_Specification 28 / 44 GNSS Module Series 2.3.13. PQGETL5BIAS Gets the current L5 bias value. Type: Get Synopsis: $PQGETL5BIAS* Parameter: None Result: ⚫ If successful, the module returns: $PQL5BIAS,* The parameter included in the result above is listed below: Field Format Unit Description Numeric - L5 bias value. ⚫ If failed, the module returns: $PQGETL5BIASERROR*6F Example: $PQGETL5BIAS*37 $PQL5BIAS,14.600000*60 2.3.14. PQCFGODO Sets or gets odometer configurations. Type: Set/Get Synopsis: $PQCFGODO,,,,* LC79D(A)_GNSS_Protocol_Specification 29 / 44 GNSS Module Series Parameter: Field Format Numeric, 1 digit Numeric, 1 digit Numeric, 1 digit Numeric Unit Description Read or write odometer configurations. - 0 = Read odometer configurations 1 = Configure odometer Enable or disable odometer to start automatically. - 0 = Disable (default) 1 = Enable Message report mode. - 0 = Do not output odometer message periodically 1 = Output odometer message periodically (default) - Odometer initial value. Default value: 0. Result: ⚫ If successful, the module returns: $PQCFGODOOK*03 ⚫ If failed, the module returns: $PQCFGODOERROR*5F Example: $PQCFGODO,1,0,1,0*07 $PQCFGODOOK*03 2.3.15. PQREQODO Requests the current odometer configuration information. Type: Query Synopsis: $PQREQODO* Parameter: None LC79D(A)_GNSS_Protocol_Specification 30 / 44 GNSS Module Series Result: ⚫ If successful, the module returns: $PQODO,* The parameter included in the result above is listed below: Field Format Unit Description Numeric - The current odometer value. ⚫ If failed, the module returns: $PQREQODOERROR*5B Example: $PQREQODO*03 $PQODO,0.0*47 2.3.16. PQRESETODO Resets odometer. This command will clear the current odometer value. Type: Command Synopsis: $PQRESETODO* Parameter: None Result: ⚫ If successful, the module returns: $PQRESETODOOK*14 ⚫ If failed, the module returns: $PQRESETODOERROR*48 LC79D(A)_GNSS_Protocol_Specification 31 / 44 Example: $PQRESETODO*10 $PQRESETODOOK*14 2.3.17. PQSTARTODO Starts odometer. Type: Command Synopsis: $PQSTARTODO* Parameter: None Result: ⚫ If successful, the module returns: $PQSTARTODOOK*01 ⚫ If failed, the module returns: $PQSTARTODOERROR*5D Example: $PQSTARTODO*05 $PQSTARTODOOK*01 2.3.18. PQSTOPODO Stops odometer. Type: Command Synopsis: $PQSTOPODO* LC79D(A)_GNSS_Protocol_Specification GNSS Module Series 32 / 44 Parameter: None Result: ⚫ If successful, the module returns: $PQSTOPODOOK*59 ⚫ If failed, the module returns: $PQSTOPODOERROR*05 Example: $PQSTOPODO*5D $PQSTOPODOOK*59 GNSS Module Series 2.3.19. PQCFGGEOFENCE Sets or gets geofence configurations. Type: Set/Get Synopsis: $PQCFGGEOFENCE,,,,,,,{,,,,,}* Parameter: Field Format Unit Numeric, 1 digit - Numeric, 1 digit - Numeric, 1 digit - Numeric, 1 digit - Description Read or write geofence configurations. 0 = Read geofence configurations 1 = Configure geofence Geofence ID. Range: 0-2. Geofence message report mode. 0 = Do not report 1 = Report when entering the geo-fence 2 = Report when leaving the geo-fence 3 = Report when entering or leaving the geo-fence The shape of geofence. 0 = Circle with a radius LC79D(A)_GNSS_Protocol_Specification 33 / 44 GNSS Module Series Float Float Float Float Float Float Float Float 1 = Circle with one point on circle 2 = Triangle 3 = Quadrangle (such as square, rectangle trapezium, etc.) - The latitude of the first point. - The longitude of the first point. If the geofence shape is a circle with a certain radius, this value will be the radius of the circle, otherwise this value will be the latitude of the second point. - The longitude of the second point. - The latitude of the third point. - The longitude of the third point. - The latitude of the fourth point. - The longitude of the fourth point. Result: ⚫ If successful, the module returns: $PQCFGGEOFENCEOK*41 ⚫ If failed, the module returns: $PQCFGGEOFENCEERROR*1D Example: //If the geofence shape is a circle with a radius: $PQCFGGEOFENCE,1,0,3,0,31.5863,117.5686,2000*59 $PQCFGGEOFENCEOK*41 //If the geofence shape is circle with one point on circle: $PQCFGGEOFENCE,1,0,3,1,31.5863,117.5686,36.5548,118.4523*47 $PQCFGGEOFENCEOK*41 LC79D(A)_GNSS_Protocol_Specification 34 / 44 GNSS Module Series 2.3.20. PQSETGEOFENCE Enables/disables geofence. Type: Set Synopsis: $PQSETGEOFENCE,* Parameter: Field Format Unit Numeric, 1 digit - Result: ⚫ If successful, the module returns: $PQSETGEOFENCEOK*41 ⚫ If failed, the module returns: $PQSETGEOFENCEERROR*1D Example: $PQSETGEOFENCE,0*59 $PQSETGEOFENCEOK*41 Description Enable or disable geofence. 0 = Disable geofence (default) 1 = Enable geofence 2.3.21. PQGETGEOFENCE Gets the status of geofence. Type: Get Synopsis: $PQGETGEOFENCE* LC79D(A)_GNSS_Protocol_Specification 35 / 44 GNSS Module Series Parameter: None Result: ⚫ If successful, the module returns: $PQGEOFENCE,* The parameter included in the result above is listed below: Field Format Unit Numeric, 1 digit - Description The status of geofence. 0 = Geofence is disabled (default). 1 = Geofence is enabled. ⚫ If failed, the module returns: $PQGETGEOFENCEERROR*09 Example: $PQGETGEOFENCE*51 $PQGEOFENCE,0*1B 2.3.22. PQREQGEOFENCE Requests if the current position is inside or outside the geofence. Type: Query Synopsis: $PQREQGEOFENCE,* Parameter: Field Format Unit Numeric, 1 digit - Description Geofence ID. Range: 0-2. LC79D(A)_GNSS_Protocol_Specification 36 / 44 GNSS Module Series Result: ⚫ If successful, the module returns: $PQGEOFENCESTATUS,,* The parameters included in the result above are listed below: Field Format Unit Description Numeric, 1 digit - Numeric, 1 digit - Geofence ID. Range: 0-2. If the current position is inside or outside the geofence: 0 = Unknow 1 = Inside 2 = Outside ⚫ If failed, the module returns: $PQREQGEOFENCEERROR*19 Example: $PQREQGEOFENCE,0*5D $PQGEOFENCESTATUS,0,0*13 2.3.23. PQCFGNMEAMSG Sets or gets the type of output NMEA messages. Type: Set/Get Synopsis: $PQCFGNMEAMSG,,,,,,,* Parameter: Field Format Unit Numeric, 1 digit - Numeric, 1 digit - Description Read or write NMEA message configurations. 0 = Read NMEA message configurations 1 = Configure NMEA message 0 = Disable GGA messages 1 = Enable GGA messages LC79D(A)_GNSS_Protocol_Specification 37 / 44 Numeric, 1 digit - Numeric, 1 digit - Numeric, 1 digit - Numeric, 1 digit - Numeric, 1 digit - Result: ⚫ If successful, the module returns: $PQCFGNMEAMSGOK*19 ⚫ If failed, the module returns: $PQCFGNMEAMSGERROR*45 Example: $PQCFGNMEAMSG,1,1,1,1,1,1,1*00 $PQCFGNMEAMSGOK*19 GNSS Module Series 0 = Disable RMC messages 1 = Enable RMC messages 0 = Disable GSV messages 1 = Enable GSV messages 0 = Disable GSA messages 1 = Enable GSA messages 0 = Disable GLL messages 1 = Enable GLL messages 0 = Disable VTG messages 1 = Enable VTG messages 2.3.24. PQCFGEAMASK Sets or gets estimate accuracy. This function is used to change TTFF (negative correlation). Type: Set/Get Synopsis: $PQCFGEAMASK,,* Parameter: Field Format Numeric, 1 digit Numeric, 3 digits Unit Description Set or get EA_Mask value. - 0 = Get EA_Mask value 1 = Set EA_Mask value EA_Mask (estimate accuracy) is negatively correlated m with TTFF LC79D(A)_GNSS_Protocol_Specification 38 / 44 GNSS Module Series Range: 50–400 (default value: 100) Result: ⚫ If successful, the module returns: $PQCFGEAMASKOK*57 ⚫ If failed, the module returns: $PQCFGEAMASKERROR*0B Example: $PQCFGEAMASK,1,200*50 $PQCFGEAMASKOK*57 2.3.25. PQCFGCLAMPING Sets or gets clamping function status. If the actual speed is very slow, output position remains the same and the output speed will be zero. Type: Set/Get Synopsis: $PQCFGCLAMPING,,* Parameter: Field Format Unit Description Numeric, 1 digit Numeric, 1 digit - Set or get clamping function status. 0 = Get clamping function status 1 = Set clamping function status 0 = Disable clamping function(default) 1 = Enable clamping function Result: ⚫ If successful, the module returns: $PQCFGCLAMPINGOK*54 LC79D(A)_GNSS_Protocol_Specification 39 / 44 ⚫ If failed, the module returns: $PQCFGCLAMPINGERROR*08 Example: $PQCFGCLAMPING,1,1*50 $PQCFGCLAMPINGOK*54 2.3.26. PQSAVEPAR Saves configurations of GNSS commands into NVM. Type: Command Synopsis: $PQSAVEPAR* Parameter: None Result: ⚫ If successful, the module returns: $PQSAVEPAROK*47 ⚫ If failed, the module returns: $PQSAVEPARERROR*1B Example: $PQSAVEPAR*43 $PQSAVEPAROK*47 2.3.27. PQRESTOREPAR Restores all configurations to default values. Type: Command LC79D(A)_GNSS_Protocol_Specification GNSS Module Series 40 / 44 Synopsis: $PQRESTOREPAR* Parameter: None Result: ⚫ If successful, the module returns: $PQRESTOREPAROK*0E ⚫ If failed, the module returns: $PQRESTOREPARERROR*52 Example: $PQRESTOREPAR*0A $PQRESTOREPAROK*0E GNSS Module Series LC79D(A)_GNSS_Protocol_Specification 41 / 44 GNSS Module Series 3 Appendix A References Table 3: Terms and Abbreviations Abbreviation 2D 3D BDS C/N0 COG COGM COGT DOP Galileo GGA GLL GLONASS GLP GNSS GPS GSA GSV HDOP IRNSS Description 2 Dimension 3 Dimension BDS Navigation Satellite System Carrier-to-Noise-Density Ratio Course over Ground Course over Ground (in Magnetic North Course Direction) Course over Ground (in True North Course Direction) Dilution of Precision Galileo Satellite Navigation System (EU) Global Positioning System Fix Data Geographic Position - Latitude and Longitude Global Navigation Satellite System (Russian) GNSS Low Power Global Navigation Satellite System Global Positioning System GPS DOP and Active Satellites GNSS Satellites in View Horizontal Dilution of Precision Indian Regional Navigation Satellite System LC79D(A)_GNSS_Protocol_Specification 42 / 44 NavIC NMEA NVM PDOP PPS QZSS RMC SNR SOG SPS TTFF UART UTC VDOP VTG GNSS Module Series Navigation with Indian Constellation NMEA (National Marine Electronics Association) 0183 Interface Standard Non-Volatile Memory Position Dilution of Precision Pulse Per Second Quasi-Zenith Satellite System Recommended Minimum Specific GNSS Data Signal-to-Noise Ratio Speed over Ground Standard Positioning Service Time to First Fix Universal Asynchronous Receiver/Transmitter Coordinated Universal Time Vertical Dilution of Precision Course Over Ground & Ground Speed LC79D(A)_GNSS_Protocol_Specification 43 / 44 GNSS Module Series 4 Appendix B GNSS Numbering Table 4: GNSS Numbering GNSS Type System ID GPS 1 GLONASS 2 Galileo 3 BDS 4 QZSS 5 NavIC (IRNSS) 6 Satellite ID 1–32 65–96 101–136 201–236 1–10 1–15 Signal ID 1 = L1 C/A 8 = L5-Q 1 = L1 C/A 1 = E5a 6 = E1 1 = B1I 1 = L1 C/A 8 = L5-Q 1 = L5-SPS LC79D(A)_GNSS_Protocol_Specification 44 / 44

L80-R GPS Protocol Specification GPS Module Series Rev. L80-R_GPS_Protocol_Specification_V1.2 Date: 2016-10-18 www.quectel.com GPS Module Series L80-R GPS Protocol Specification Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. L80-R_GPS_Protocol_Specification Confidential / Released 1 / 36 GPS Module Series L80-R GPS Protocol Specification About the Document History Revision Date 1.0 2015-08-10 l 1.1 2015-12-03 Author Connie ZHOU Connie ZHOU CQouneficdteential 1.2 2016-10-18 Matt YE Description Initial 1. Added Packet Type 255, 285 and 886 2. Deleted Packet Type 300 1. Modified the description of Packet Type 220 2. Modified the description of Packet Type 500 3. Modified the example of Packet Type 705 L80-R_GPS_Protocol_Specification Confidential / Released 2 / 36 GPS Module Series L80-R GPS Protocol Specification Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 5 1 Introduction ....................................................................................................................................... 6 2 Standard NMEA Packet Protocols ................................................................................................... 7 2.1. GPRMC................................................................................................................................... 7 2.2. GPVTG ................................................................................................................................... 8 2.3. GPGGA................................................................................................................................... 9 3 2.4. GPGSA ................................................................................................................................. 10 2.5. GPGSV ..................................................................................................................................11 2.6. GPGLL .................................................................................................................................. 13 MTK NMEA Packet Protocols ......................................................................................................... 14 l 3.1. Packet Type: 010 PMTK_SYS_MSG .................................................................................... 14 te 3.2. Packet Type: 011 PMTK_TXT_MSG ..................................................................................... 15 3.3. Packet Type: 001 PMTK_ACK .............................................................................................. 16 c l 3.4. Packet Type: 101 PMTK_CMD_HOT_START ...................................................................... 16 3.5. Packet Type: 102 PMTK_CMD_WARM_START ................................................................... 17 ue tia 3.6. Packet Type: 103 PMTK_CMD_COLD_START .................................................................... 18 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START ......................................................... 18 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE .............................................................. 19 Q n 3.9. Packet Type: 220 PMTK_SET_POS_FIX ............................................................................. 19 3.10. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE ............................................................. 20 e 3.11. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA ............................................................. 21 fid 3.12. Packet Type: 285 PMTK_SET_PPS_CONFIG ..................................................................... 21 3.13. Packet Type: 286 PMTK_SET_AIC_ENABLED .................................................................... 22 3.14. Packet Type: 301 PMTK_API_SET_DGPS_MODE .............................................................. 23 n 3.15. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT .......................................................... 23 3.16. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD ...................................................... 25 o 3.17. Packet Type: 400 PMTK_API_Q_FIX_CTL........................................................................... 26 C 3.18. Packet Type: 401 PMTK_API_Q_DGPS_MODE .................................................................. 27 3.19. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT .............................................................. 27 3.20. Packet Type: 605 PMTK_Q_RELEASE ................................................................................ 28 3.21. Packet Type: 500 PMTK_DT_FIX_CTL ................................................................................ 29 3.22. Packet Type: 501 PMTK_DT_DGPS_MODE ........................................................................ 29 3.23. Packet Type: 514 PMTK_DT_NMEA_OUTPUT.................................................................... 30 3.24. Packet Type: 705 PMTK_DT_RELEASE .............................................................................. 31 3.25. Packet Type: 869 PMTK_EASY_ENABLE ............................................................................ 32 3.26. Packet Type: 886 PMTK_FR_MODE .................................................................................... 33 4 Default Configurations.................................................................................................................... 34 L80-R_GPS_Protocol_Specification Confidential / Released 3 / 36 GPS Module Series L80-R GPS Protocol Specification 5 Appendix A References .................................................................................................................. 35 CQouneficdteenl tial L80-R_GPS_Protocol_Specification Confidential / Released 4 / 36 GPS Module Series L80-R GPS Protocol Specification Table Index TABLE 1: STRUCTURE OF NMEA MESSAGE .................................................................................................. 7 TABLE 2: STRUCTURE OF MTK NMEA PACKET ........................................................................................... 14 TABLE 3: DEFAULT CONFIGURATIONS ......................................................................................................... 34 TABLE 4: RELATED DOCUMENTS .................................................................................................................. 35 TABLE 5: TERMS AND ABBREVIATIONS ........................................................................................................ 35 CQouneficdteenl tial L80-R_GPS_Protocol_Specification Confidential / Released 5 / 36 GPS Module Series L80-R GPS Protocol Specification 1 Introduction L80-R is a full featured GPS module with super sensitivity. It is characteristic of low power consumption and compact size. The module supports autonomous GPS C/A. It can be used in the positioning, navigation and other industries. This document describes the software aspects of L80-R. L80-R supports NMEA 0183 standard CQouneficdteenl tial commands. MTK NMEA extended packet is supported to control and configure L80-R GPS module. L80-R_GPS_Protocol_Specification Confidential / Released 6 / 36 GPS Module Series L80-R GPS Protocol Specification 2 Standard NMEA Packet Protocols L80-R supports NMEA 0183 standard messages. The following table shows the structure of a NMEA 0183 standard message. Table 1: Structure of NMEA Message Filed Length (Bytes) Description $ 1 Each NMEA message starts with ‘$’ l Talker ID 1~2 ‘GP’ for a GPS receiver te NMEA Message ID c l Data Field 3 NMEA message ID Variable, depend on the NMEA Data fields, delimited by comma ‘,’ message type ue tia * 1 End character of data field Q n Checksum 2 A hexadecimal number calculated by exclusive OR of all characters between ‘$’ and ‘*’ e 2 Each NMEA message ends with ‘CR’ and ‘LF’ fid NOTE n The default output message of L80-R has the following six sentences: RMC, VTG, GGA, GSA, GSV and Co GLL. 2.1. GPRMC RMC–Recommended Minimum Position Data (including position, velocity and time). Example: $GPRMC,060949.000,A,3150.7815,N,11711.9239,E,2.87,314.13,050314,,,D*69 Field Description L80-R_GPS_Protocol_Specification Confidential / Released 7 / 36 GPS Module Series L80-R GPS Protocol Specification $ Each NMEA message starts with ‘$’ GPRMC Message ID UTC Time Time in format ‘hhmmss.sss’ Data Valid ‘V’=Invalid ‘A’=Valid Latitude Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North N/S ‘S’=South Longitude Longitude in format ‘dddmm.mmmm’ (degrees and minutes) E/W Speed l COG te Date c l Magnetic Variation ue tia E/W Positioning Mode Q en * fid Checksum ‘E’=East ‘W’=West Speed over ground in knots Course over ground in degree Date in format ‘ddmmyy’ Magnetic variation in degree, not being output Magnetic variation E/W indicator, not being output ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Con 2.2. GPVTG VTG–Track Made Good and Ground Speed. Example: $GPVTG,0.0,T,,M,0.0,N,0.1,K,A*0C Field Description $ Each NMEA message starts with ‘$’ L80-R_GPS_Protocol_Specification Confidential / Released 8 / 36 GPS Module Series L80-R GPS Protocol Specification GPVTG Message ID COG (T) Course over ground (true) in degree T Fixed field, true COG (M) Course over ground (magnetic), not being output M Fixed field, magnetic Speed Speed over ground in knots N Fixed field, knots Speed K l Positioning Mode te * c l Checksum ue tia Speed over ground in km/h Fixed field, km/h ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Q en 2.3. GPGGA fid GGA–Global Positioning System Fix Data, is the essential fix data which provides 3D location and accuracy data. n Example: o $GPGGA,060950.000,3150.7820,N,11711.9231,E,2,8,1.17,23.5,M,0.0,M,0000,0000*5A C Field Description $ Each NMEA message starts with ‘$’ GPGGA Message ID UTC Time Time in format ‘hhmmss.sss’ Latitude N/S Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North ‘S’=South L80-R_GPS_Protocol_Specification Confidential / Released 9 / 36 GPS Module Series L80-R GPS Protocol Specification Longitude E/W Fix Status Number of SV Longitude in format ‘dddmm.mmmm’ (degrees and minutes) ‘E’=East ‘W’=West ‘0’=Invalid ‘1’=GPS fix ‘2’=DGPS fix Number of satellites being used (0~12) HDOP Horizontal Dilution of Precision Altitude Altitude in meters according to WGS84 ellipsoid M GeoID Separation l M te DGPS Age c l DGPS Station ID ue tia * Checksum Q n Fixed field, meter Height of GeoID (means sea level) above WGS84 ellipsoid, meter Fixed field, meter Age of DGPS data in seconds, empty if DGPS is not used DGPS station ID, empty if DGPS is not used End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ fide 2.4. GPGSA n GSA–GPS DOP and Active Satellites, provides details on the fix, including the numbers of the satellites being used and the DOP. At most the first 12 satellite IDs are output. Co Example: $GPGSA,A,3,18,25,12,193,24,15,22,14,,,,,1.47,1.17,0.89*37 Field Description $ Each NMEA message starts with ‘$’ GPGSA Mode Message ID Auto selection of 2D or 3D fix ‘M’=Manual, forced to switch 2D/3D mode ‘A’=Allowed to automatically switch 2D/3D mode L80-R_GPS_Protocol_Specification Confidential / Released 10 / 36 GPS Module Series L80-R GPS Protocol Specification Fix Status Satellite Used 1 ‘1’=No fix ‘2’=2D fix ‘3’=3D fix Satellite used on channel 1 Satellite Used 2 Satellite used on channel 2 Satellite Used 3 Satellite used on channel 3 Satellite Used 4 Satellite used on channel 4 Satellite Used 5 Satellite used on channel 5 Satellite Used 6 Satellite Used 7 Satellite Used 8 l Satellite Used 9 te Satellite Used 10 c l Satellite Used 11 ue tia SatelliteUsed12 Q n PDOP e HDOP fid VDOP * n Checksum Co Satellite used on channel 6 Satellite used on channel 7 Satellite used on channel 8 Satellite used on channel 9 Satellite used on channel 10 Satellite used on channel 11 Satellite used on channel 12 Position Dilution Of Precision Horizontal Dilution Of Precision Vertical Dilution Of Precision End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 2.5. GPGSV GSV–GPS Satellites in View. One GSV sentence can only provide data for at most 4 satellites, so several sentences might be required for the full information. Since GSV includes satellites that are not used as part of the solution, GSV sentence contains more satellites than GGA does. L80-R_GPS_Protocol_Specification Confidential / Released 11 / 36 GPS Module Series L80-R GPS Protocol Specification Example: $GPGSV,3,1,12,01,05,060,18,02,17,259,43,04,56,287,28,09,08,277,28*77 $GPGSV,3,2,12,10,34,195,46,13,08,125,45,17,67,014,,20,32,048,24*74 $GPGSV,3,3,12,23,13,094,48,24,04,292,24,28,49,178,46,32,06,037,22*7D Field Description $ Each NMEA message starts with ‘$’ GPGSV Message ID Number of Message Number of messages, total number of GPGSV messages being output (1~3) Sequence Number Sequence number of this entry (1~3) Satellites in View Satellite ID 1 l Elevation 1 te Azimuth 1 c l SNR1 ue tia SatelliteID2 Elevation 2 Q n Azimuth 2 e SNR 2 fid Satellite ID 3 Elevation 3 n Azimuth 3 Co SNR 3 Total satellites in view Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to Noise Ration in dBHz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to Noise Ration in dBHz (0 ~ 99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to Noise Ration in dBHz (0~99), empty if not tracking Satellite ID 4 Satellite ID Elevation 4 Elevation in degree (0~90) Azimuth 4 Azimuth in degree (0~359) SNR 4 Signal to Noise Ration in dBHz (0~99), empty if not tracking * End character of data field Checksum Hexadecimal checksum L80-R_GPS_Protocol_Specification Confidential / Released 12 / 36 GPS Module Series L80-R GPS Protocol Specification Each NMEA message ends with ‘CR’ and ‘LF’ 2.6. GPGLL GLL–Geographic Latitude and Longitude, contains position information, time of position fix and status. Example: $GPGLL,3110.2908,N,12123.2348,E,041139.000,A,A*59 Field Description $ GPGLL l Latitude te N/S c l Longitude ue tia E/W UTC Time Q en DataValid fid Positioning Mode n * o Checksum C Each NMEA message starts with ‘$’ Message ID Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmm’ (degrees and minutes) ‘E’=East ‘W’=West Time in format ‘hhmmss.sss’ ‘V’=Invalid ‘A’=Valid ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ L80-R_GPS_Protocol_Specification Confidential / Released 13 / 36 GPS Module Series L80-R GPS Protocol Specification 3 MTK NMEA Packet Protocols This chapter introduces the MTK NMEA packet protocol, which is a set of extension messages of the standard NMEA packet protocol. These messages are used to control and configure L80-R GPS module. The following table shows the structure of a MTK NMEA packet. Table 2: Structure of MTK NMEA Packet Filed $ tel Talker ID Length (Bytes) 1 1 Description Each NMEA message starts with ‘$’ ‘P’ for proprietary message NMEA Data type uec tial DataFiled Packet type Packet data Q n * e Checksum fid 3 Always ‘MTK’ to indicate MTK proprietary message 3 Packet type, from ‘000’ to ‘999’ Variable, depends Data fields, delimited by comma ‘,’ on the packet type 1 End character of data field A hexadecimal number calculated by exclusive OR of 2 all characters between ‘$’ and ‘*’ 2 Each NMEA message ends with ‘CR’ and ‘LF’ Con 3.1. Packet Type: 010 PMTK_SYS_MSG This message is used to automatically output system messages by GPS module. Data Field: None Example: $PMTK010,001*2E Field Description L80-R_GPS_Protocol_Specification Confidential / Released 14 / 36 GPS Module Series L80-R GPS Protocol Specification $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Message * 010 System message ‘0’=Unknown ‘1’=Startup ‘2’=Notification for the host aiding EPO ‘3’=Notification for the transition to normal mode is successfully done End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ tel 3.2. Packet Type: 011 PMTK_TXT_MSG c l This message is used to automatically output system messages by GPS module. ue tia DataField: None Q n Example: $PMTK011,MTKGPS*08 e Field Description fid $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message n Packet Type 011 Co Message MTKGPS * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ L80-R_GPS_Protocol_Specification Confidential / Released 15 / 36 GPS Module Series L80-R GPS Protocol Specification 3.3. Packet Type: 001 PMTK_ACK Acknowledgement of PMTK command. In order to inform the sender whether the receiver has received the packet, an acknowledge packet PMTK_ACK should return after the receiver receives a packet. Some commands will cause the GPS module to restart or change the baud rate.There is no PMTK_ACK for those commands as listed below. PMTK_CMD_HOT_START PMTK_CMD_WARM_START PMTK_CMD_COLD_START PMTK_CMD_FULL_COLD_START PMTK_SET_NMEA_BAUDRATE Data Field: l $PMTK001,Cmd,Flag Example: te $PMTK001,869,3*37 c l Field Description ue tia $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Q n Packet Type 001 e Command fid Flag on * The packet type that the acknowledge responds ‘0’=Invalid packet ‘1’=Unsupported packet type ‘2’=Valid packet, but action failed ‘3’=Valid packet, action succeeded End character of data field C Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.4. Packet Type: 101 PMTK_CMD_HOT_START This message is used to hot start the GPS module (use all available data in the NV store). Normally hot start means the GPS module was powered down less than 3 hours (RTC must be alive) and its ephemeris L80-R_GPS_Protocol_Specification Confidential / Released 16 / 36 GPS Module Series L80-R GPS Protocol Specification is still valid. As there is no need for downloading ephemeris, it is the fastest startup method. Data Field: None Example: $PMTK101*32 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 101 * Checksum l End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ cte l 3.5. Packet Type: 102 PMTK_CMD_WARM_START ue tia This message is used to warm start the GPS module. Warm start means the GPS module has approximate information of time, position and coarse data on satellite positions. But it needs to download Q n ephemeris until it can get a fix. Using this message will force the GPS warm restarted without using the e ephemeris data in NV. fid Data Field: None Example: n $PMTK102*31 o Field Description C $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 102 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ L80-R_GPS_Protocol_Specification Confidential / Released 17 / 36 GPS Module Series L80-R GPS Protocol Specification 3.6. Packet Type: 103 PMTK_CMD_COLD_START This message is used to cold start the GPS module. Using this message will force the GPS cold restarted without using any prior location information, including time, position, almanacs and ephemeris data. Data Field: None Example: $PMTK103*30 Field Description $ PMTK Packet Type l * te Checksum c l Each NMEA message starts with ‘$’ MTK proprietary message 103 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Que ntia 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START e This message is essentially a cold restart, but additionally clear system and user configurations at re-start. fid That is, reset the GPS module to the factory status. Full cold start means the GPS module has no information on last location. It needs to search the full time and frequency space, and also all possible satellite numbers before it can get a fix. n Data Field: o None C Example: $PMTK104*37 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 104 L80-R_GPS_Protocol_Specification Confidential / Released 18 / 36 * Checksum GPS Module Series L80-R GPS Protocol Specification End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE This message is used to enter standby mode for power saving. Data Field: $PMTK161,Type Example: $PMTK161,0*28 l Response: $PMTK001,161,3*36 te Field Description c l $ Each NMEA message starts with ‘$’ ue tia PMTK MTK proprietary message Packet Type 161 Q n Type ‘0’=Stop mode e * End character of data field fid Checksum Hexadecimal checksum Con Each NMEA message ends with ‘CR’ and ‘LF’ 3.9. Packet Type: 220 PMTK_SET_POS_FIX This message is used to set position fix interval. Data Field: $PMTK220, Interval Example: $PMTK220,1000*1F L80-R_GPS_Protocol_Specification Confidential / Released 19 / 36 GPS Module Series L80-R GPS Protocol Specification Response: $PMTK001,220,3*30 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 220 Interval Position fix interval [msec]. [Range:100~10000] * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ tel 3.10. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE c l This message is used to set NMEA port baud rate. Using PMTK251command to setup baud rate setting, ue tia the setting will be back to default value in the condition: Full cold start command is issued. Data Field: Q n $PMTK251,Baudrate e Example: $PMTK251,38400*27 fid Field Description $ Each NMEA message starts with ‘$’ n PMTK MTK proprietary message Co Packet Type 251 Baud rate setting: 9600–default setting 4800 9600 Baud Rate 14400 19200 38400 57600 115200 L80-R_GPS_Protocol_Specification Confidential / Released 20 / 36 * Checksum GPS Module Series L80-R GPS Protocol Specification End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.11. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA This message is used to enable or disable fix NMEA output time behind PPS function. (Default off) Data Field: $PMTK255,Enable Example: $PMTK255,0*2C l Response: te $PMTK001,255,3*32 Field Description c l $ Each NMEA message starts with ‘$’ ue tia PMTK MTK proprietary message Q n Packet Type e Enable fid * 255 ‘0’=Disable ‘1’=Enable End character of data field Checksum Hexadecimal checksum Con Each NMEA message ends with ‘CR’ and ‘LF’ 3.12. Packet Type: 285 PMTK_SET_PPS_CONFIG This message is used to set PPS type. Data Field: $PMTK285,Type,PPSPulseWidth Example: $PMTK285,4,100*38 L80-R_GPS_Protocol_Specification Confidential / Released 21 / 36 GPS Module Series L80-R GPS Protocol Specification Response: $PMTK001,285,3*3F Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 285 ‘0’=Disable ‘1’=After the first fix Type ‘2’=3D fix only PPSPulseWidth l * te Checksum c l ‘3’=2D/3D fix only ‘4’=Always 2~998 (Unit: ms) End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ ue tia 3.13. Packet Type: 286 PMTK_SET_AIC_ENABLED Q en This message is used to enable or disable AIC function. It is suggested to set cold start command first and then PMTK command. fid Data Field: $PMTK286,Enable n Example: $PMTK286,0*22 o Response: C $PMTK001,286,3*3C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Enable 286 ‘0’=Disable ‘1’=Enable L80-R_GPS_Protocol_Specification Confidential / Released 22 / 36 * Checksum GPS Module Series L80-R GPS Protocol Specification End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.14. Packet Type: 301 PMTK_API_SET_DGPS_MODE This message is used to configure the source mode of DGPS correction data. Data Field: $PMTK301,Mode Example: $PMTK301,1*2D l Response: $PMTK001,301,3*32 te Field Description c l $ Each NMEA message starts with ‘$’ ue tia PMTK MTK proprietary message Packet Type Q en Mode fid * 301 DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM mode End character of data field Checksum Hexadecimal checksum Con Each NMEA message ends with ‘CR’ and ‘LF’ 3.15. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT This message is used to set NMEA sentence output frequencies. There are totally 19 data fields that present output frequencies for the 19 supported NMEA sentences individually. L80-R_GPS_Protocol_Specification Confidential / Released 23 / 36 GPS Module Series L80-R GPS Protocol Specification Supported Frequency Settings: 0–Disabled or not supported sentence 1–Output once every one position fix 2–Output once every two position fixes 3–Output once every three position fixes 4–Output once every four position fixes 5–Output once every five position fixes Data Field: None Example: The module only output RMC once every one position fix. $PMTK314,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*29 Response: $PMTK001,314,3*36 l Field Description te $ Each NMEA message starts with ‘$’ c l PMTK MTK proprietary message ue tia PacketType 314 0 GLL GLL interval–Geographic Position, Latitude and Longitude Q n 1RMC RMC interval–Recommended Minimum Specific GPS Sentence e 2 VTG VTG interval–Course Over Ground and Ground Speed fid 3 GGA GGA interval–GPS Fix Data 4 GSA GSA interval–GPS DOPS and Active Satellites n 5 GSV GSV interval–GPS Satellites in View Co 6 GRS GRS interval–GPS Range Residuals 7 GST GST interval–GPS Pseudorange Error Statistics 8 Reserved Always 0 9 Reserved Always 0 10 Reserved Always 0 11 Reserved Always 0 L80-R_GPS_Protocol_Specification Confidential / Released 24 / 36 GPS Module Series L80-R GPS Protocol Specification 12 Reserved Always 0 13 Reserved Always 0 14 Reserved Always 0 15 Reserved Always 0 16 Reserved Always 0 17 ZDA ZDA interval–Time and Date 18 MCHN PMTKCHN interval–GPS Channel Status * Checksum l End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ te To restore the system default setting, use the messages below: c l Example: ue tia $PMTK314,-1*04 Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type 314 Restore Always -1 n * End character of data field Co Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.16. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD This message is used to set the speed threshold for static navigation. If the actual speed is below the threshold, output position will keep the same and output speed will be zero. If threshold value is set to 0, this function is disabled. L80-R_GPS_Protocol_Specification Confidential / Released 25 / 36 GPS Module Series L80-R GPS Protocol Specification Data Field: $PMTK386,Speed_threshold Example: $PMTK386,0.3*3E Response: $PMTK001,386,3*3D Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 386 Speed_threshold * l Checksum te 0~2m/s End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ uec tial 3.17. Packet Type: 400 PMTK_API_Q_FIX_CTL Q n This message is used to query the rate of position fixing activity. e Refer to PMTK_API_SET_FIX_CTL for setting the rate. fid Refer to PMTK_DT_FIX_CTL for the result of the query. n Data Field: None o Example: C $PMTK400*36 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 400 * End character of data field L80-R_GPS_Protocol_Specification Confidential / Released 26 / 36 Checksum GPS Module Series L80-R GPS Protocol Specification Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.18. Packet Type: 401 PMTK_API_Q_DGPS_MODE This message is used to query the setting of DGPS mode. Refer to PMTK_API_SET_DGPS_MODE for setting the DGPS mode. Refer to PMTK_DT_DGPS_MODE for the result of the query. Data Field: None l Example: $PMTK401*37 te Field Description c l $ Each NMEA message starts with ‘$’ ue tia PMTK MTK proprietary message Packet Type 401 Q n * End character of data field fide Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Con 3.19. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT This message is used to query the current NMEA sentence output frequencies. Refer to PMTK_API_SET_NMEA_OUTPUT for the frequencies setting. Refer to PMTK_DT_NMEA_OUTPUT for the result of the query. Data Field: None L80-R_GPS_Protocol_Specification Confidential / Released 27 / 36 GPS Module Series L80-R GPS Protocol Specification Example: $PMTK414*33 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 414 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ l 3.20. Packet Type: 605 PMTK_Q_RELEASE te This message is used to query the firmware release information. uec tial Refer to PMTK_DT_RELEASE for the result of the query. Data Field: Q n None Example: e $PMTK605*31 fid Field Description $ Each NMEA message starts with ‘$’ n PMTK MTK proprietary message Co Packet Type 605 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ L80-R_GPS_Protocol_Specification Confidential / Released 28 / 36 GPS Module Series L80-R GPS Protocol Specification 3.21. Packet Type: 500 PMTK_DT_FIX_CTL This message is the response to PMTK_API_Q_FIX_CTL. Data Field: $PMTK500,Fix interval Example: $PMTK500,1000,0,0,0,0*1A Field Description $ Each NMEA message starts with ‘$’ PMTK Packet Type l Fix Interval te Reserved c l Reserved ue tia Reserved Reserved Q n * e Checksum fid MTK proprietary message 500 Position fix interval [msec]. [Range: 100~10000] Always 0 Always 0 Always 0 Always 0 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Con 3.22. Packet Type: 501 PMTK_DT_DGPS_MODE This message is the response to PMTK_API_Q_DGPS_MODE. Data Field: $PMTK501,Mode Example: $PMTK501,1*2B Field Description $ Each NMEA message starts with ‘$’ L80-R_GPS_Protocol_Specification Confidential / Released 29 / 36 GPS Module Series L80-R GPS Protocol Specification PMTK Packet Type Mode * Checksum MTK proprietary message 501 DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM mode End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.23. Packet Type: 514 PMTK_DT_NMEA_OUTPUT l This message is the response to PMTK_API_Q_NMEA_OUTPUT. te Data Field: c l None Example: ue tia $PMTK514,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0*2E Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type 514 0 GLL GLL interval–Geographic Position, Latitude and Longitude n 1 RMC RMC interval–Recommended Minimum Specific GPS Sentence Co 2 VTG VTG interval–Course Over Ground and Ground Speed 3 GGA GGA interval–GPS Fix Data 4 GSA GSA interval–GPS DOPS and Active Satellites 5 GSV GSV interval–GPS Satellites in View 6 GRS GRS interval–GPS Range Residuals 7 GST GST interval–GPS Pseudorange Error Statistics L80-R_GPS_Protocol_Specification Confidential / Released 30 / 36 GPS Module Series L80-R GPS Protocol Specification 8 Reserved 9 Reserved 10 Reserved 11 Reserved 12 Reserved 13 Reserved 14 Reserved 15 Reserved 16 Reserved l 17 ZDA te 18 MCHN c l * ue tia Checksum ZDA interval–Time and Date PMTKCHN interval–GPS Channel Status End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Q en 3.24. Packet Type: 705 PMTK_DT_RELEASE fid This message is the response to PMTK_Q_RELEASE. n Data Field: o $PMTK705, Release string, Build ID, Product Model (,SDK Version) Example: C $PMTK705,AXN_2.32_3337_15010801,0000,,*2D Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Release String 705 Firmware release name and version 3318: Mcore_x.x L80-R_GPS_Protocol_Specification Confidential / Released 31 / 36 GPS Module Series L80-R GPS Protocol Specification Build ID 3329: AXN_x.x 3339: AXN_x.x 3333: AXN_x.x 3337: AXN_x.x Build ID set in CoreBuilder for firmware version control Product Model SDK Version (Optional) * Product Model set in CoreBuilder for product identification Showing SDK version if the firmware is used for SDK End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ l 3.25. Packet Type: 869 PMTK_EASY_ENABLE cte l This message is used to enable or disable EASY function, and it also can be used to query if EASY is enabled or disabled. ue tia DataField: $PMTK869,CmdType[, Enabled] Q n Example: e $PMTK869,1,1*35 Response: fid $PMTK001,869,3*37 Field Description n $ Each NMEA message starts with ‘$’ o PMTK MTK proprietary message C Packet Type 869 CmdType Enabled ‘0’=Query ‘1’=Set ‘2’=Result for Query operation ‘0’=Disable ‘1’=Enable * End character of data field Checksum Hexadecimal checksum L80-R_GPS_Protocol_Specification Confidential / Released 32 / 36 GPS Module Series L80-R GPS Protocol Specification Each NMEA message ends with ‘CR’ and ‘LF’ 3.26. Packet Type: 886 PMTK_FR_MODE This message is used to set navigation mode. Data Field: $PMTK886,CmdType Example: $PMTK886,3*2B Response: $PMTK001,886,3*36 Field Description l $ Each NMEA message starts with ‘$’ te PMTK MTK proprietary message c l Packet Type Que ntia CmdType fide * 886 ‘0’=Normal mode: For general purpose ‘1’=Fitness mode: For running and walking purpose that the low-speed (<5m/s) movement will have more effect on the position calculation. ‘2’=Aviation mode: For high-dynamic purpose that the large-acceleration movement will have more effect on the position calculation. ‘3’=Balloon mode: For high-altitude balloon purpose that the vertical movement will have more effect on the position calculation. End character of data field n Checksum Hexadecimal checksum Co Each NMEA message ends with ‘CR’ and ‘LF’ L80-R_GPS_Protocol_Specification Confidential / Released 33 / 36 GPS Module Series L80-R GPS Protocol Specification 4 Default Configurations Table 3: Default Configurations Item Default NMEA Port Baud Rate Datum Rate of Position Fixing l DGPS Mode te EASYTM c l NMEA Output Messages CQounefidentia AIC 9600bps WGS84 1Hz Off Enabled RMC, VTG, GGA, GSA, GSV and GLL On L80-R_GPS_Protocol_Specification Confidential / Released 34 / 36 GPS Module Series L80-R GPS Protocol Specification 5 Appendix A References Table 4: Related Documents SN Document Name Remark [1] Quectel_L80-R_Hardware_Design L80-R Hardware Design [2] Quectel_L80-R_EVB_User_Guide L80-R EVB User Guide [3] Quectel_L80-R_Reference_Design L80-R Reference Design tel Table 5: Terms and Abbreviations c l Abbreviation ue tia AGPS Description Assisted Global Positioning System AIC Q n DGPS Active Interference Cancellation Differential Global Positioning System e EASY Embedded Assist System fid GGA n GLL NMEA: Global Positioning System Fix Data NMEA: Geographic Latitude and Longitude o GPS C GSA Global Navigation Satellite System NMEA: GPS DOP and Active Satellites GSV NMEA: GPS Satellites in View HDOP NMEA Horizontal Dilution of Precision National Marine Electronics Association PDOP Position Dilution of Precision PMTK Private Protocol of MTK L80-R_GPS_Protocol_Specification Confidential / Released 35 / 36 PPS RMC UTC VDOP VTG GPS Module Series L80-R GPS Protocol Specification Pulse Per Second NMEA: Recommended Minimum Position Data Universal Time Coordinated Vertical Dilution of Precision NMEA: Track Made Good and Ground Speed CQouneficdteenl tial L80-R_GPS_Protocol_Specification Confidential / Released 36 / 36

L76 Series GNSS Protocol Specification GNSS Module Series Rev. L76_Series_GNSS_Protocol_Specification_V3.3 Date: 2017-07-21 www.quectel.com GNSS Module Series L76 Series GNSS Protocol Specification 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 l Or Email to: support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2017. All rights reserved. L76_Series_GNSS_Protocol_Specification Confidential / Released 1 / 55 GNSS Module Series L76 Series GNSS Protocol Specification About the Document History Revision 1.0 1.1 1.2 1.3 1.4 1.5 2.0 2.1 Date 2013-02-08 tel 2013-02-25 uec tial 2013-03-22 Q en 2013-09-29 fid 2014-08-19 Con 2014-12-19 Author Description Ada LI Ada LI Dishon ZHOU Ada LI Ada LI Connie ZHOU Initial 1. Modified the default baud rate of Packet Type 251. 2. Modified „2‟=SBAS of Packet Type 301 into „2‟=WAAS. 3. Added the Release string of Packet Type 705. 4. Added the description of AIC and WAAS in Table 2. 5. Added Packet Type 352 1. Deleted the description of RTCM. 2. Added LOCUS‟s Packet Type 183,184,185 and 622. 3. Deleted Packet Type 291 and 120. 4. Modified Packet Type 353. 1. Modified the description of RMC. 2. Modified the Example of Packet Type 314, 352 and 514. 1. Modified the description of GGA. 2. Modified the description of PMTK 251. 3. Added Packet Type 220 and 223. 1. Modified the description of DGPS_MODE. 2. Added parameter for 'Fix status' in GPGGA sentence. 3. Added parameter for packet type 353. 4. Modified the Notes in Chapter 2.1. 1. Added BEIDOU and Galileo sentences description 2. Modified Packet Type 353 2015-08-05 Connie ZHOU 3. Modified Packet Type 622 4. Added Packet Type 351 5. Added Packet Type 875 2015-10-12 1. Added Packet Type 255, 256, 285 and 886 Connie ZHOU 2. Added the Notes for packet type 869 L76_Series_GNSS_Protocol_Specification Confidential / Released 2 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3. Deleted Packet Type 300 3.0 2016-05-03 Ziv LIAO Incorporated related information of L76-L module 3.1 2016-06-02 Ziv LIAO Added Packet Type 311 3.2 2016-08-15 Simon HU Added Packet Type 838 1. Enabled Galileo satellites system 2. Modified Packet Type 353 and 886 Matt YE/ 3.3 2017-07-21 3. Added a new segment in RMC, GSA and GSV for Simon HU NMEA V4.10 4. Added Packet Type 306, 308, 458 and 461 CQouneficdteenl tial L76_Series_GNSS_Protocol_Specification Confidential / Released 3 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 6 1 Introduction .......................................................................................................................................... 7 2 Standard NMEA Packet Protocol ....................................................................................................... 8 2.1. --RMC ........................................................................................................................................ 8 2.2. --VTG ....................................................................................................................................... 10 2.3. --GGA....................................................................................................................................... 11 3 2.4. --GSA ....................................................................................................................................... 12 2.5. --GSV ....................................................................................................................................... 14 2.6. --GLL........................................................................................................................................ 16 MTK NMEA Packet Protocol ............................................................................................................. 17 l 3.1. Packet Type: 010 PMTK_SYS_MSG ...................................................................................... 17 te 3.2. Packet Type: 011 PMTK_TXT_MSG ....................................................................................... 18 3.3. Packet Type: 001 PMTK_ACK ................................................................................................ 18 c l 3.4. Packet Type: 101 PMTK_CMD_HOT_START ........................................................................ 19 3.5. Packet Type: 102 PMTK_CMD_WARM_START .................................................................... 20 ue tia 3.6. Packet Type: 103 PMTK_CMD_COLD_START......................................................................20 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START........................................................... 21 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE................................................................ 21 Q n 3.9. Packet Type: 183 PMTK_LOCUS_QUERY_STATUS ............................................................ 22 3.10. Packet Type: 184 PMTK_LOCUS_ERASE_FLASH ............................................................... 23 e 3.11. Packet Type: 185 PMTK_LOCUS_STOP_LOGGER.............................................................. 24 fid 3.12. Packet Type: 622 PMTK_Q_LOCUS_DATA ........................................................................... 25 3.13. Packet Type: 220 PMTK_SET_POS_FIX ............................................................................... 25 3.14. Packet Type: 223 PMTK_SET_AL_DEE_CFG ....................................................................... 26 n 3.15. Packet Type: 225 PMTK_SET_PERIODIC_MODE ................................................................ 27 3.16. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE............................................................... 28 o 3.17. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA............................................................... 28 C 3.18. Packet Type: 256 PMTK_SET_TIMING_PRODUCT .............................................................. 29 3.19. Packet Type: 285 PMTK_SET_PPS_CONFIG ....................................................................... 30 3.20. Packet Type: 286 PMTK_SET_AIC_ENABLED...................................................................... 30 3.21. Packet Type: 301 PMTK_API_SET_DGPS_MODE ............................................................... 31 3.22. Packet Type: 306 PMTK_API_SET_MIN_SNR ...................................................................... 32 3.23. Packet Type: 308 PMTK_API_SET_DR_LIMIT ...................................................................... 32 3.24. Packet Type: 311 PMTK_API_SET_ELEV_MASK ................................................................. 33 3.25. Packet Type: 313 PMTK_API_SET_SBAS_ENABLED .......................................................... 33 3.26. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT ........................................................... 34 3.27. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA............................................. 36 3.28. Packet Type: 352 PMTK_API_SET_STOP_QZSS ................................................................. 37 L76_Series_GNSS_Protocol_Specification Confidential / Released 4 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.29. Packet Type: 353 PMTK_API_SET_GNSS_SEARCH_MODE .............................................. 37 3.30. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD........................................................ 39 3.31. Packet Type: 400 PMTK_API_Q_FIX_CTL ............................................................................ 39 3.32. Packet Type: 401 PMTK_API_Q_DGPS_MODE.................................................................... 40 3.33. Packet Type: 413 PMTK_API_Q_SBAS_ENABLED .............................................................. 41 3.34. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT ............................................................... 41 3.35. Packet Type: 458 PMTK_API_GET_POS_XYZ...................................................................... 42 3.36. Packet Type: 461 PMTK_API_GET_VEL_XYZ ...................................................................... 42 3.37. Packet Type: 605 PMTK_Q_RELEASE .................................................................................. 43 3.38. Packet Type: 500 PMTK_DT_FIX_CTL .................................................................................. 44 3.39. Packet Type: 501 PMTK_DT_DGPS_MODE.......................................................................... 44 3.40. Packet Type: 513 PMTK_DT_SBAS_ENABLED .................................................................... 45 4 5 3.41. 3.42. 3.43. 3.44. l 3.45. 3.46. Packet Type: 514 PMTK_DT_NMEA_OUTPUT ..................................................................... 46 Packet Type: 705 PMTK_DT_RELEASE ................................................................................ 47 Packet Type: 838 PMTK_TEST_ANTI_SPOOFING ............................................................... 48 Packet Type: 869 PMTK_EASY_ENABLE.............................................................................. 49 Packet Type: 875 PMTK_PMTKLSC_STN_OUTPUT ............................................................ 50 Packet Type: 886 PMTK_FR_MODE ...................................................................................... 51 te Default Configurations ...................................................................................................................... 52 CQouneficdential Appendix A References.....................................................................................................................53 L76_Series_GNSS_Protocol_Specification Confidential / Released 5 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Table Index TABLE 1: DEFAULT CONFIGURATIONS ......................................................................................................... 52 TABLE 2: RELATED DOCUMENTS .................................................................................................................. 53 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 53 TABLE 4: STRUCTURE OF NMEA MESSAGE ................................................................................................ 54 TABLE 5: STRUCTURE OF MTK NMEA PACKET ........................................................................................... 55 CQouneficdteenl tial L76_Series_GNSS_Protocol_Specification Confidential / Released 6 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 1 Introduction L76 series module includes three variants (L76, L76-L and L76B) which can use GPS, GLONASS, BeiDou and Galileo constellations and features accurate acquisition. The module supports autonomous GNSS C/A, SBAS function (including WAAS and EGNOS) and AGPS (EASYTM function). It can be used in the positioning, navigation and other industries. Now L76 supports SDK commands which are developed by Quectel. At present the SDK commands contain $PQGLP, $PQBAUD, $PQ1PPS, $PQEPE and so on. For more infomations please refer to document [4]. l This document describes the software aspects of L76 series. L76 series supports NMEA 0183 standard commands. MTK NMEA extended packet is enabled to control and configure L76 series module. te L76-L, which comes with built-in LNA, provides better performance than L76 in weak signal areas. uec tial Please note that L76NR03A01S version of L76 and L76LNR02A01S version of L76-L use NMEA V4.10. It CQonfiden will change the format of RMC, GSA and GSV sentences. L76_Series_GNSS_Protocol_Specification Confidential / Released 7 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 2 Standard NMEA Packet Protocol L76 series supports NMEA 0183 standard messages. The following table shows the structure of a NMEA 0183 standard message. 2.1. --RMC RMC, Recommended Minimum Position Data (including position, velocity and time). l Example 1: te $GPRMC,015606.000,A,3150.7584,N,11712.0491,E,0.00,231.36,280715,,,A*67 $GNRMC,084629.000,A,3150.7822,N,11711.9323,E,0.00,119.00,240715,,,D*7C c l $BDRMC,020547.000,A,3150.7813,N,11711.9212,E,0.37,229.71,280715,,,A*7C Example 2 (for NMEA V4.10): ue tia $GPRMC,110642.979,A,3150.7759,N,11711.9310,E,0.06,0.00,190717,,,A,V*1B $GNRMC,110604.000,A,3150.7773,N,11711.9229,E,0.09,0.00,190717,,,A,V*0C $BDRMC,110921.000,A,3150.773933,N,11711.940482,E,0.87,271.15,190717,,,A,V*00 Q n Field Description e $ Each NMEA message starts with „$‟ fid --RMC Message ID UTC Time n Data Valid Co Latitude Time in format „hhmmss.sss‟ „V‟=Invalid „A‟=Valid Latitude in format „ddmm.mmmm‟ (degrees and minutes) „N‟=North N/S „S‟=South Longitude Longitude in format „dddmm.mmmm‟ (degrees and minutes) „E‟=East E/W „W‟=West Speed Speed over ground in knots L76_Series_GNSS_Protocol_Specification Confidential / Released 8 / 55 GNSS Module Series L76 Series GNSS Protocol Specification COG Course over ground in degree Date Date in format „ddmmyy‟ Magnetic Variation Magnetic variation in degree, not being output E/W Magnetic variation E/W indicator, not being output „N‟=No fix Positioning Mode „A‟=Autonomous GNSS fix „D‟=Differential GNSS fix Navigational Status (Only supported for „V‟=Navigational status not valid NMEA V4.10) * Checksum l End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ cte l NOTES ue tia A. When the firmware supports GPS and GLONASS systems, the NMEA sentences output as below: 1. If the receiver is fixed by GPS only, it will print GPRMC, GPVTG, GPGGA, GPGSA, GPGSV and GPGLL. Q n 2. If the receiver is fixed by GPS only, and can also search QZSS satellite, it will print GPRMC, GPVTG, GPGGA, GPGSA, QZQSA, GPGSV, QZGSV and GPGLL. e 3. If the receiver is fixed by GLONASS only, it will print GNRMC, GPVTG, GPGGA, GNGSA, fid GPGSV, GLGSV and GNGLL. 4. If the receiver is fixed by GPS and GLONASS, it will print GNRMC, GPVTG, GPGGA, GNGSA, GPGSV, GLGSV and GNGLL. n 5. In the state of no satellite positioning, it will print initial state of NMEA, such as GPRMC, GPVTG, GPGGA, GPGSA, GPGSV and GPGLL. The time before satellite positioning after cold start, o warm start or hot start is belong to this situation. C B. When the firmware supports GPS and BeiDou systems, the NMEA sentences output as below: 1. If the receiver is fixed by GPS only, it will print GPRMC, GPVTG, GPGGA, GPGSA, GPGSV and GPGLL. 2. If the receiver is fixed by BeiDou only, it will print BDRMC, BDVTG, BDGGA, BDGSA, BDGSV and BDGLL. 3. If the receiver is fixed by GPS and BeiDou, it will print GNRMC, GNVTG, GNGGA,GPGSA, BDGSA ,GPGSV, BDGSV and GNGLL. 4. In the state of no satellite positioning, it will print initial state of NMEA, such as GNRMC, GNVTG, GNGGA and GNGLL. The time before satellite positioning after cold start, warm start or hot start is belong to this situation. L76_Series_GNSS_Protocol_Specification Confidential / Released 9 / 55 GNSS Module Series L76 Series GNSS Protocol Specification C. When the firmware supports GPS and Galileo systems, the NMEA sentences output as below: 1. If the receiver is fixed by GPS only, it will print GPRMC, GPVTG, GPGGA, GPGSA, GPGSV and GPGLL. 2. If the receiver is fixed by GPS only, and can also search QZSS satellite, it will print GPRMC, GPVTG, GPGGA, GPGSA, QZQSA, GPGSV, QZGSV and GPGLL. 3. If the receiver is fixed by Galileo only, it will print GNRMC, GPVTG, GPGGA, GNGSA, GPGSV, GAGSV and GNGLL. 4. If the receiver is fixed by GPS and Galileo, it will print GNRMC, GPVTG, GPGGA, GNGSA, GPGSV, GAGSV and GNGLL. 5. In the state of no satellite positioning, it will print initial state of NMEA, such as GPRMC, GPVTG, GPGGA, GPGSA, GPGSV and GPGLL. The time before satellite positioning after cold start, warm start or hot start is belong to this situation. D. When the firmware supports GPS, GLONASS and Galileo systems, the NMEA sentences output as below: If the receiver is fixed by GPS, GLONASS and Galileo, it will print GPGGA, GNGSA, GPGSV, GLGSV, GAGSV, GNRMC, GPVTG and GNGLL. ctel l 2.2. --VTG ue tia VTG, Track Made Good and Ground Speed. Example: Q n $GPVTG,227.15,T,,M,0.00,N,0.00,K,A*3E e $GNVTG,19.11,T,,M,0.16,N,0.30,K,A*1F $BDVTG,229.71,T,,M,0.37,N,0.68,K,A*29 fid Field Description $ Each NMEA message starts with „$‟ n --VTG Message ID Co COG (T) Course over ground (true) in degree T Fixed field, true COG(M) Course over ground (magnetic), not being output M Fixed field, magnetic Speed Speed over ground in knots N Fixed field, knots L76_Series_GNSS_Protocol_Specification Confidential / Released 10 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Speed K Positioning Mode * Checksum Speed over ground in km/h Fixed field, km/h „N‟=No fix „A‟=Autonomous GNSS fix „D‟=Differential GNSS fix End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ NOTE For the details, please refer to the notes of Chapter 2.1. ctel l 2.3. --GGA ue tia GGA, Global Positioning System Fix Data, is the essential fix data which provides 3D location and accuracy data. Q n Example: e $GPGGA,015606.000,3150.7584,N,11712.0491,E,1,5,2.28,265.0,M,0.0,M,,*65 fid $GNGGA,083354.000,3150.7790,N,11711.9289,E,1,8,2.85,53.2,M,0.0,M,,*4B $BDGGA,020547.000,3150.7813,N,11711.9212,E,1,3,3.65,55.3,M,0.0,M,,*4C Field Description n $ Each NMEA message starts with „$‟ Co --GGA Message ID UTC Time Time in format „hhmmss.sss‟ Latitude N/S Longitude E/W Latitude in format „ddmm.mmmm‟ (degrees and minutes) „N‟=North „S‟=South Longitude in format „dddmm.mmmm‟ (degrees and minutes) „E‟=East „W‟=West L76_Series_GNSS_Protocol_Specification Confidential / Released 11 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Fix Status Number of SV „0‟=Invalid „1‟=GNSS fix „2‟=DGPS fix „6‟=Estimated (dead reckoning) mode Number of satellites being used (0~24) HDOP Horizontal dilution of precision Altitude Altitude in meters according to WGS84 ellipsoid M Fixed field, meter Geoid Separation Height of Geoid (means sea level) above WGS84 ellipsoid, meter M DGPS Age l DGPS Station ID te * c l Checksum ue tia Fixed field, meter Age of DGPS data in seconds, empty if DGPS is not used DGPS station ID, empty if DGPS is not used End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Q n NOTE e For the details, please refer to the notes of Chapter 2.1. nfid 2.4. --GSA Co GSA, GNSS DOP and Active Satellites, which provides details on the fix and includes the number of satellites being used in the current solution and the DOP. At most the first 12 satellite IDs are output. Example 1: $GPGSA,A,3,03,17,11,23,193,,,,,,,,3.72,2.85,2.39*3C $GNGSA,A,3,23,09,17,03,01,193,,,,,,,1.23,0.74,0.99*28 $BDGSA,A,2,10,11,07,,,,,,,,,,3.79,3.65,1.00*18 $GAGSA,A,3,12,,,,,,,,,,,,0.91,0.58,0.70*12 Example 2 (for NMEA V4.10): $GPGSA,A,3,02,05,06,30,19,,,,,,,,1.98,1.73,0.96,1*1F L76_Series_GNSS_Protocol_Specification Confidential / Released 12 / 55 GNSS Module Series L76 Series GNSS Protocol Specification $BDGSA,A,3,11,01,04,14,,,,,,,,,3.94,3.81,0.97,*35 $GNGSA,A,3,15,07,06,05,29,20,30,,,,,,1.22,0.91,0.82,1*08 $GNGSA,A,3,86,70,71,,,,,,,,,,1.22,0.91,0.82,2*0E $GNGSA,A,3,08,07,,,,,,,,,,,1.22,0.91,0.82,3*0F Field Description $ Each NMEA message starts with „$‟ --GSA Message ID Auto selection of 2D or 3D fix Mode „M‟=Manual, forced to switch 2D/3D mode „A‟=Allowed to automatically switch 2D/3D mode Fix Status l Satellite Used 1 te Satellite Used 2 c l Satellite Used 3 ue tia SatelliteUsed4 Satellite Used 5 Q n Satellite Used 6 e Satellite Used 7 fid Satellite Used 8 Satellite Used 9 n Satellite Used 10 Co Satellite Used 11 „1‟=No fix „2‟=2D fix „3‟=3D fix Satellite used on channel 1 Satellite used on channel 2 Satellite used on channel 3 Satellite used on channel 4 Satellite used on channel 5 Satellite used on channel 6 Satellite used on channel 7 Satellite used on channel 8 Satellite used on channel 9 Satellite used on channel 10 Satellite used on channel 11 Satellite Used 12 Satellite used on channel 12 PDOP Position dilution of precision HDOP Horizontal dilution of precision VDOP GNSS System ID (Only supported for NMEA Vertical dilution of precision 1 - GPS 2 - GLONASS L76_Series_GNSS_Protocol_Specification Confidential / Released 13 / 55 V4.10) * Checksum GNSS Module Series L76 Series GNSS Protocol Specification 3 - Galileo 4 - BeiDou End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ NOTE For the details, please refer to the notes of Chapter 2.1. 2.5. --GSV l GSV, GNSS Satellites in View. One GSV sentence can only provide data for at most 4 satellites, so te several sentences might be required for full information. Since GSV includes satellites that are not used as part of the solution, GSV sentence contains more satellites than GGA does. uec tial Example1: $GPGSV,3,1,11,193,69,099,30,17,62,354,36,06,47,272,,03,40,054,30*4E $GPGSV,3,2,11,02,13,255,,01,12,055,19,23,11,102,25,11,05,074,24*75 $GPGSV,3,3,11,24,03,303,,47,,,,32,,,21*4D Q n $GLGSV,3,1,11,69,48,142,39,68,43,058,51,83,40,049,51,84,40,334,43*64 e $GLGSV,3,2,11,74,30,271,15,73,17,218,19,75,13,324,30,70,07,184,*6E $GLGSV,3,3,11,85,06,296,34,82,02,092,21,67,02,023,*56 fid $BDGSV,2,1,06,08,63,015,30,11,59,350,32,12,39,081,26,14,29,184,21*68 $BDGSV,2,2,06,13,07,295,,01,,,26*50 $GAGSV,1,1,01,12,46,287,38*5E n Example 2 (for NMEA V4.10): $GPGSV,3,1,11,13,71,174,16,193,67,058,29,02,60,110,25,05,59,016,42,0*51 o $GPGSV,3,2,11,29,45,288,49,20,43,295,48,15,37,217,36,41,37,232,36,0*60 C $GPGSV,3,3,11,30,19,077,30,06,12,123,25,07,07,046,42,0*5B $GLGSV,2,1,08,86,77,291,36,71,58,344,43,85,39,164,31,72,37,263,18,1*74 $GLGSV,2,2,08,70,22,037,38,87,21,331,,80,07,064,,73,03,109,,1*77 $GAGSV,1,1,02,08,,,39,07,,,40,0*77 $BDGSV,1,1,02,02,,,30,14,,,37,0*76 Field Description $ Each NMEA message starts with „$‟ --GSV Message ID L76_Series_GNSS_Protocol_Specification Confidential / Released 14 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Number of Message Sequence Number Number of messages, total number of GPGSV messages being output (1~3) Sequence number of this entry (1~3) Satellites in View Total satellites in view Satellite ID 1 Satellite ID Elevation 1 Elevation in degree (0~90) Azimuth 1 Azimuth in degree (0~359) SNR 1 Signal to noise ration in dBHz (0~99), empty if not tracking Satellite ID 2 Satellite ID Elevation 2 Azimuth 2 l SNR 2 te Satellite ID 3 c l Elevation 3 ue tia Azimuth3 SNR 3 Q n Satellite ID 4 e Elevation 4 Azimuth 4 fid SNR 4 Signal ID n (Only supported for NMEA o V4.10) C * Elevation in degree (0~90) Azimuth in degree (0~359) Signal to noise ration in dBHz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to noise ration in dBHz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to noise ration in dBHz (0~99), empty if not tracking 0 - All channel 1 - G1 C/A End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ NOTE 1. For the details, please refer to the notes of Chapter 2.1. 2. The receiver features built-in RAIM function which filters out low quality satellites. Thus, in most cases, there are more viewed satellites than used ones, and positioning accuracy is greatly improved. L76_Series_GNSS_Protocol_Specification Confidential / Released 15 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 2.6. --GLL GLL, Geographic Latitude and Longitude, which contains position information, time of position fix and status. Example: $GPGLL,3150.7584,N,11712.0491,E,015606.000,A,A*5C $GNGLL,3150.7790,N,11711.9289,E,083354.000,A,A*4D $BDGLL,3150.7813,N,11711.9212,E,020547.000,A,A*49 Field Description $ --GLL Latitude tel N/S c l Longitude ue tia E/W UTC Time Q n Data Valid fide Positioning Mode * n Checksum Co Each NMEA message starts with „$‟ Message ID Latitude in format „ddmm.mmmm‟ (degrees and minutes) „N‟=North „S‟=South Longitude in format „dddmm.mmmm‟ (degrees and minutes) „E‟=East „W‟=West Time in format „hhmmss.sss‟ „V‟=Invalid „A‟=Valid „N‟=No fix „A‟=Autonomous GNSS fix „D‟=Differential GNSS fix End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ NOTE For the details, please refer to the notes of Chapter 2.1. L76_Series_GNSS_Protocol_Specification Confidential / Released 16 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3 MTK NMEA Packet Protocol This chapter introduces the MTK NMEA packet protocol, which is a set of extension messages of standard NMEA packet protocol. These messages are used to control and configure L76 series GNSS module. The following table shows the structure of a MTK NMEA packet. 3.1. Packet Type: 010 PMTK_SYS_MSG This message is used to automatically output system messages through GNSS module. tel Data Field: None c l Example: $PMTK010,001*2E ue tia Field Description $ Each NMEA message starts with „$‟ Q n PMTK MTK proprietary message e Packet Type nfid Message Co * 010 System message „0‟=Unknown „1‟=Startup „2‟=Notification for the host aiding EPO „3‟=Notification for the transition to normal mode is successfully done End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 17 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.2. Packet Type: 011 PMTK_TXT_MSG This message is used to automatically output system messages through GNSS module. Data Field: None Example: $PMTK011,MTKGPS*08 Field Description $ Each NMEA message starts with „$‟ PMTK Packet Type l Message te * c l Checksum ue tia MTK proprietary message 011 MTKGPS End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Q en 3.3. Packet Type: 001 PMTK_ACK fid Acknowledgement of PMTK command. In order to inform the sender whether the receiver has received the packet, an acknowledge packet PMTK_ACK should be returned after the receiver receives a packet. n Some commands will cause the GNSS module to restart or change the baud rate. There is no PMTK_ACK o for those commands as listed below. C  PMTK_CMD_HOT_START  PMTK_CMD_WARM_START  PMTK_CMD_COLD_START  PMTK_CMD_FULL_COLD_START  PMTK_SET_NMEA_BAUDRATE Data Field: $PMTK001,Cmd,Flag Example: $PMTK001,869,3*37 L76_Series_GNSS_Protocol_Specification Confidential / Released 18 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 001 Cmd The packet type that the acknowledge responds „0‟=Invalid packet „1‟=Unsupported packet type Flag „2‟=Valid packet, but action failed „3‟=Valid packet, action succeeded * Checksum l End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ cte l 3.4. Packet Type: 101 PMTK_CMD_HOT_START ue tia This message is used to perform hot start on GNSS module (use all available data in the NV store). Q n Normally hot start means the GNSS module was powered down less than 3 hours (RTC must be alive) and its ephemeris is still valid. As there is no need for downloading ephemeris, it‟s the fastest startup method. e Data Field: fid None Example: $PMTK101*32 n Field Co $ Description Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 101 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 19 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.5. Packet Type: 102 PMTK_CMD_WARM_START This message is used to perform warm start on GNSS module. Warm start means the GNSS module has approximate information of time, position and coarse data on satellite positions. But it needs to download ephemeris until it can get a fix. Using this message will force a warm restart on the GNSS module without using the ephemeris data in NV. Data Field: None Example: $PMTK102*31 Field $ l PMTK te Packet Type c l * ue tia Checksum Description Each NMEA message starts with „$‟ MTK proprietary message 102 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Q en 3.6. Packet Type: 103 PMTK_CMD_COLD_START fid This message is used to perform cold start on GNSS module. Using this message will force a cold restart on n GNSS module without using any prior location information, including time, position, almanacs and ephemeris data. Co Data Field: None Example: $PMTK103*30 Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 103 L76_Series_GNSS_Protocol_Specification Confidential / Released 20 / 55 * Checksum GNSS Module Series L76 Series GNSS Protocol Specification End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START This message is essentially a cold restart, but additionally clear system and user configurations at re-start. That is, reset the GNSS module to the factory status. Full cold start means the GNSS module has no information on last location. It needs to search the full time and frequency space, and also all possible satellite numbers before it can get a fix. Data Field: l None te Example: $PMTK104*37 c l Field ue tia $ PMTK Q n Packet Type e * fid Checksum Con Description Each NMEA message starts with „$‟ MTK proprietary message 104 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE This message is used to enter standby mode for power saving. Data Field: $PMTK161,Type Example: $PMTK161,0*28 Response: L76_Series_GNSS_Protocol_Specification Confidential / Released 21 / 55 GNSS Module Series L76 Series GNSS Protocol Specification $PMTK001,161,3*36 Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 161 Type „0‟=Stop mode * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ tel 3.9. Packet Type: 183 PMTK_LOCUS_QUERY_STATUS c l This message is used to query LOCUS logging status. ue tia DataField: None Q n Example: e $PMTK183*38 Response: fid $PMTK001,183,3*3A Field Description n $ Each NMEA message starts with „$‟ Co PMTK MTK proprietary message Packet Type 183 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 22 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Return: Example: $PMTKLOG,456,0,11,31,2,0,0,0,3769,46*48 Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type LOG Serial# Type Mode Content Interval Distance Speed Status Number Percent * Checksum Logging serial number: 0~65535 Logging type-0: Overlap, 1: Fullstop Logging mode-0x08: Interval logger l Logging contents of configuration te Logging interval setting (valid when interval mode is selected) c l Logging distance setting (valid when distance mode is selected) ue tia Logging speed setting (valid when speed mode is selected) Logging status-1: Stop logging, 0: Logging Q n Logging number of data record e Logging life used percentage (0%~100%) fid End character of data field nHexadecimal checksum CoEach NMEA message ends with „CR‟ and „LF‟ 3.10. Packet Type: 184 PMTK_LOCUS_ERASE_FLASH This message is used to erase logger flash. Data Field: $PMTK184,Type Example: L76_Series_GNSS_Protocol_Specification Confidential / Released 23 / 55 GNSS Module Series L76 Series GNSS Protocol Specification $PMTK184,1*22 Response: $PMTK001,184,3*3D Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 184 Type „1‟=Erase all logger internal flash data * Checksum End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ ctel l 3.11. Packet Type: 185 PMTK_LOCUS_STOP_LOGGER ue tia This message is used to stop or start logging data. Q n Data Field: $PMTK185,Stutas e Example: $PMTK185,1*23 fid Response: $PMTK001,185,3*3C n Field Description o $ Each NMEA message starts with „$‟ C PMTK MTK proprietary message Packet Type Status * 185 „0‟=Start logging „1‟=Stop logging End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 24 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.12. Packet Type: 622 PMTK_Q_LOCUS_DATA This message is used to dump LOCUS flash data. Data Field: $PMTK622,Type Example: $PMTK622,1*29 Response: $PMTK001,622,3*36 Field Description $ PMTK l Packet Type te Type c l * ue tia Checksum Each NMEA message starts with „$‟ MTK proprietary message 622 „1‟=Dump partial in used LOCUS flash data. End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Q fiden 3.13. Packet Type: 220 PMTK_SET_POS_FIX This message is used to set position fix interval. on Data Field: $PMTK220,Interval C Example: $PMTK220,1000*1F Response: $PMTK001,220,3*30 Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message L76_Series_GNSS_Protocol_Specification Confidential / Released 25 / 55 Packet Type Interval * Checksum GNSS Module Series L76 Series GNSS Protocol Specification 220 Position fix interval (msec). Range: 100~10000 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.14. Packet Type: 223 PMTK_SET_AL_DEE_CFG This message is used to config DEE. l Data Field: $PMTK223,SV,SNR,Extension threshold,Extension gap te Example: $PMTK223,1,30,180000,60000*3C c l Response: ue tia $PMTK001,223,3*33 Field Description Q n $ Each NMEA message starts with „$‟ e PMTK MTK proprietary message fid Packet Type 223 SV Range: 1~4 (Default value: 1) n SNR Range: 25~30 (Default value: 30) Co Extension Threshold Range: 40000~180000 (Default value: 180000) Extension Gap Range: 0~3600000 (Default value: 60000) * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 26 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.15. Packet Type: 225 PMTK_SET_PERIODIC_MODE This message is used to enter periodic mode for power saving. Data Field: $PMTK225,Type,Run time,Sleep time,Second run time,Second sleep time Example: $PMTK225,8*23 Response: $PMTK001,225,3*35 Field Description $ PMTK l Packet Type cte l Type Que ntia RunTime e Sleep Time fid Second Run Time Second Sleep Time on * C Checksum Each NMEA message starts with „$‟ MTK proprietary message 225 „0‟=Back to normal mode „1‟=Periodic backup mode „2‟=Periodic standby mode „4‟=Perpetual backup mode „8‟=AlwaysLocateTM standby mode „9‟=AlwaysLocateTM backup mode „0‟: Disable >=„1000‟: Enable. Range: 1000~518400000 Range: 1000~518400000 „0‟: Disable >=‟1000‟: Enable. Range: 1000~518400000 Range: 1000~518400000 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ NOTE The unit of run time or sleep time is msec. The second run time should be larger than the first run time when the first run time is a non-zero value. L76_Series_GNSS_Protocol_Specification Confidential / Released 27 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.16. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE This message is used to set NMEA port baud rate. Using PMTK251 command to setup baud rate setting, the setting will be back to default value in the condition: Full cold start command is issued. Data Field: $PMTK251,Baudrate Example: $PMTK251,38400*27 Field Description $ PMTK Packet Type uectel tial Baudrate Q en * fid Checksum Each NMEA message starts with „$‟ MTK proprietary message 251 Baud rate setting: 9600 - default setting 4800 9600 14400 19200 38400 57600 115200 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Con 3.17. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA This message is used to enable or disable fix NMEA output time behind PPS function (Default: off). Data Field: $PMTK255,Enable Example: $PMTK255,0*2C Response: L76_Series_GNSS_Protocol_Specification Confidential / Released 28 / 55 GNSS Module Series L76 Series GNSS Protocol Specification $PMTK001,255,3*32 Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 255 Enable „0‟=Disable „1‟=Enable * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ tel 3.18. Packet Type: 256 PMTK_SET_TIMING_PRODUCT uec tial This message is used to enable or disable timing product mode (Default: off). Data Field: Q n $PMTK256,Enable Example: e $PMTK256,0*2F Response: fid $PMTK001,256,3*31 Field Description n $ Each NMEA message starts with „$‟ Co PMTK MTK proprietary message Packet Type 256 Enable „0‟=Disable „1‟=Enable * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 29 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.19. Packet Type: 285 PMTK_SET_PPS_CONFIG This message is used to set PPS type. Data Field: $PMTK285,Type,PPSPulseWidth Example: $PMTK285,4,100*38 Response: $PMTK001,285,3*3F Field Description $ PMTK l Packet Type cte l Type ue tia PPSPulseWidth Q n * e Checksum fid Each NMEA message starts with „$‟ MTK proprietary message 285 „0‟=Disable „1‟=After the first fix „2‟=3D fix only „3‟=2D/3D fix only „4‟=Always 2~998 (Unit: ms) End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Con 3.20. Packet Type: 286 PMTK_SET_AIC_ENABLED This message is used to enable or disable AIC function. It is suggested to set cold start command first and then PMTK command. Data Field: $PMTK286,Enable Example: $PMTK286,0*22 Response: $PMTK001,286,3*3C L76_Series_GNSS_Protocol_Specification Confidential / Released 30 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type Enable * 286 „0‟=Disable „1‟=Enable End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ l 3.21. Packet Type: 301 PMTK_API_SET_DGPS_MODE cte l This message is used to configure the source mode of DGPS correction data. ue tia DataField: $PMTK301,Mode Example: Q n $PMTK301,2*2E Response: e $PMTK001,301,3*32 fid Field Description $ Each NMEA message starts with „$‟ n PMTK MTK proprietary message Co Packet Type 301 DGPS data source mode. Mode „0‟=No DGPS source „1‟=RTCM „2‟=SBAS (Include WAAS/EGNOS/GAGAN/MSAS) * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 31 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.22. Packet Type: 306 PMTK_API_SET_MIN_SNR This message is used to set the minimum SNR of used satellites. If the minimum SNR threshold value is set, the chip would not use the satellite whose SNR is smaller than it. Example: $PMTK306,15*1F Field Description $ Each NMEA message starts with „$‟ PMTK Packet Type l MIN_SNR te * c l Checksum ue tia MTK proprietary message 306 Minimum SNR threshold of used satellites. Valid range: 9~37 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Q n 3.23. Packet Type: 308 PMTK_API_SET_DR_LIMIT fide This message is used to set the number of estimated fix when entering the tunnel. Example: n $PMTK308,0*25 => Disable the estimated fix when entering the tunnel. $PMTK308,3*26 => Keep outputting 3 fix when entering the tunnel. Co Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 308 DR_LIMIT Number of estimated fix. Valid range: 0~500 * End character of data field L76_Series_GNSS_Protocol_Specification Confidential / Released 32 / 55 Checksum GNSS Module Series L76 Series GNSS Protocol Specification Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.24. Packet Type: 311 PMTK_API_SET_ELEV_MASK This message is used to set satellite elevation mask. Data Field: $PMTK311,Type Example: $PMTK311,5*28 Response: $PMTK001,311,3*33 l Field Description te $ Each NMEA message starts with „$‟ c l PMTK MTK proprietary message ue tia PacketType Q n Satellite Elevation Mask 311 Range: 0~90o e * End character of data field fid Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ on NOTE C The satellite elevation mask is recommended to be set not more than 10 degrees. As with the increase of satellite elevation mask, the number of satellites involved in positioning will decrease. 3.25. Packet Type: 313 PMTK_API_SET_SBAS_ENABLED This message is used to enable or disable searching a SBAS satellite. SBAS (Satellite Based Augmentation Systems) is a system that supports wide-area or regional augmentation through geostationary satellite broadcast messages. The geostationary satellite broadcasts GNSS integrity and correction data with the L76_Series_GNSS_Protocol_Specification Confidential / Released 33 / 55 GNSS Module Series L76 Series GNSS Protocol Specification assistance of multiple ground stations which are located at accurately-surveyed points. Data Field: $PMTK313,Enable Example: $PMTK313,1*2E Response: $PMTK001,313,3*31 Field Description $ Each NMEA message starts with „$‟ PMTK Packet Type Enable tel * Checksum uec tial MTK proprietary message 313 „0‟=Disable „1‟=Enable End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Q n 3.26. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT fide This message is used to set NMEA sentence output frequencies. There are totally 19 data fields that present output frequencies for the 19 supported NMEA sentences individually. n Supported Frequency Settings: o  0 - Disabled or not supported sentence C  1 - Output once every one position fix  2 - Output once every two position fixes  3 - Output once every three position fixes  4 - Output once every four position fixes  5 - Output once every five position fixes Data Field: None Example: The module only outputs RMC once every one position fix. L76_Series_GNSS_Protocol_Specification Confidential / Released 34 / 55 GNSS Module Series L76 Series GNSS Protocol Specification $PMTK314,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*29 Response: $PMTK001,314,3*36 Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 314 0 GLL GLL interval - Geographic position - latitude longitude 1 RMC 2 VTG 3 GGA 4 GSA 5 GSV 6 GRS 7 GST 8 Reserved 9 Reserved 10 Reserved 11 Reserved 12 Reserved 13 Reserved 14 Reserved RMC interval - Recommended minimum specific GNSS sentence VTG interval - Course over ground and ground speed GGA interval - GPS fix data l GSA interval - GNSS DOPS and active satellites te GSV interval - GNSS satellites in view c l GRS interval – GNSS range residuals ue tia GST interval – GNSS pseudorange error statistics Q n Always 0 e Always 0 fid Always 0 Always 0 nAlways 0 CoAlways 0 Always 0 15 Reserved Always 0 16 Reserved Always 0 17 ZDA ZDA interval - Time and date 18 MCHN PMTKCHN interval - GNSS channel status L76_Series_GNSS_Protocol_Specification Confidential / Released 35 / 55 GNSS Module Series L76 Series GNSS Protocol Specification * Checksum End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ To restore the system default setting, use the following message: Example: $PMTK314,-1*04 Field Description $ PMTK l Packet Type te Restore c l * ue tia Checksum Each NMEA message starts with „$‟ MTK proprietary message 314 Always -1 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Q en 3.27. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA fid The receiver support new NMEA format for QZSS. The command allow users to enable or disable QZSS n NMEA format. QZSS NMEA format is disabled by defult. o Data Field: C $PMTK351,Enable Example: $PMTK351,1*28 Response: $PMTK001,351,3*37 Field Description $ PMTK Each NMEA message starts with „$‟ MTK proprietary message L76_Series_GNSS_Protocol_Specification Confidential / Released 36 / 55 Packet Type QZSS_Enable * Checksum GNSS Module Series L76 Series GNSS Protocol Specification 351 „0‟=Disable „1‟=Enable End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.28. Packet Type: 352 PMTK_API_SET_STOP_QZSS QZSS is regional positioning service. This command is used to enable or disable QZSS function. QZSS function is enabled by default. l Data Field: te $PMTK352,Enable c l Example: $PMTK352,0*2A ue tia Response: $PMTK001,352,3*34 Field Description Q en $ fid PMTK Packet Type n QZSS_Enable Co * Each NMEA message starts with „$‟ MTK proprietary message 352 „0‟=Enable „1‟=Disable End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.29. Packet Type: 353 PMTK_API_SET_GNSS_SEARCH_MODE This command is used to configure the receiver to start searching satellite system. L76_Series_GNSS_Protocol_Specification Confidential / Released 37 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Data Field: $PMTK353,GPS_Enable,GLONASS_Enable,GALILEO_Enable,GALILEO_FULL_Enable,BEIDOU_Enable Example: $PMTK353,1,1,0,0,0*2B: Search GPS+GLONASS Response: $PMTK001,353,3,1,1,0,0,0,3*36 Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type GPS_Enable l GLONASS_Enable te GALILEO_Enable c l GALILEO_FULL_Enable ue tia BEIDOU_Enable Q n * e Checksum fid 353 „0‟=Disable (DO NOT search GPS satellites) „1‟or non-ZERO: search GPS satellites „0‟=Disable (DO NOT search GLONASS satellites) „1‟or non-ZERO: search GLONASS satellites „0‟=Disable (DO NOT search Galileo satellites) „1‟or non-ZERO: search Galileo satellites „0‟=Disable (DO NOT search Galileo full mode satellites) „1‟or non-ZERO: search Galileo satellites „0‟=Disable „1‟or non-ZERO: search BeiDou satellites End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ n NOTE o 1. Actually GLONASS only, BeiDou only, and Galileo only mode is only for testing purpose. Please use C GPS+GLONASS, GPS+BeiDou, GPS+Galileo or GPS+GLONASS+Galileo in the real application. GLONASS and BeiDou can not be enabled at the same time. Galileo and BeiDou can not be enabled at the same time too. 2. When the receiver is fixed by GPS+GLONASS+Galileo, the maximum frequency supported is 5Hz. 3. For the details, please refer to the notes of Chapter 2.1. L76_Series_GNSS_Protocol_Specification Confidential / Released 38 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.30. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD This message is used to set the speed threshold for static navigation. If the actual speed is below the threshold, output position will keep the same and output speed will be zero. If threshold value is set to 0, this function is disabled. Data Field: $PMTK386,Speed_threshold Example: $PMTK386,0.3*3E Response: $PMTK001,386,3*3D Field Description $ l PMTK te Packet Type c l Speed_threshold ue tia * Q n Checksum e Each NMEA message starts with „$‟ MTK proprietary message 386 0~2m/s End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ fid 3.31. Packet Type: 400 PMTK_API_Q_FIX_CTL Con This message is used to query the rate of position fixing activity. Refer to PMTK_API_SET_FIX_CTL for setting the rate. Refer to PMTK_DT_FIX_CTL for the result of the query. Data Field: None Example: $PMTK400*36 L76_Series_GNSS_Protocol_Specification Confidential / Released 39 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 400 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.32. Packet Type: 401 PMTK_API_Q_DGPS_MODE tel This message is used to query the setting of DGPS mode. c l Refer to PMTK_API_SET_DGPS_MODE for setting the DGPS mode. ue tia Refer to PMTK_DT_DGPS_MODE for the result of the query. Data Field: Q n None e Example: $PMTK401*37 fid Field n $ o PMTK C Packet Type Description Each NMEA message starts with „$‟ MTK proprietary message 401 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 40 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.33. Packet Type: 413 PMTK_API_Q_SBAS_ENABLED This message is used to query the setting of SBAS. Refer to PMTK_API_SET_SBAS_ENABLE for SBAS setting. Refer to PMTK_DT_SBAS_ENABLED for the result of the query. Data Field: None Example: $PMTK413*34 Field $ l PMTK te Packet Type c l * ue tia Checksum Q n Description Each NMEA message starts with „$‟ MTK proprietary message 413 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ fide 3.34. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT n This message is used to query the current NMEA sentence output frequencies. Co Refer to PMTK_API_SET_NMEA_OUTPUT for the frequencies setting. Refer to PMTK_DT_NMEA_OUTPUT for the result of the query. Data Field: None Example: $PMTK414*33 Field Description L76_Series_GNSS_Protocol_Specification Confidential / Released 41 / 55 $ PMTK Packet Type * Checksum GNSS Module Series L76 Series GNSS Protocol Specification Each NMEA message starts with „$‟ MTK proprietary message 414 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.35. Packet Type: 458 PMTK_API_GET_POS_XYZ This message is used to return the WGS84 ECEF XYZ Cartesian position vector ( metres ) with an l estimated 1-sigma accuracy. te Example: c l $PMTK458*3B ue tia Field Description $ Q n PMTK e Packet Type fid * Checksum Con Each NMEA message starts with „$‟ MTK proprietary message 458 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.36. Packet Type: 461 PMTK_API_GET_VEL_XYZ This message is used to return the WGS84 ECEF XYZ Cartesian velocity vector ( m/s ) with an estimated 1-sigma accuracy. Example: $PMTK461*31 L76_Series_GNSS_Protocol_Specification Confidential / Released 42 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Field Description $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type 461 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.37. Packet Type: 605 PMTK_Q_RELEASE tel This message is used to query the firmware release information. c l Refer to PMTK_DT_RELEASE for the result of the query. ue tia DataField: None Example: Q n $PMTK605*31 e Field fid $ PMTK n Packet Type Co * Description Each NMEA message starts with „$‟ MTK proprietary message 605 End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 43 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.38. Packet Type: 500 PMTK_DT_FIX_CTL This message is the response to PMTK_API_Q_FIX_CTL. Data Field: $PMTK500,Fix interval Example: $PMTK500,1000,0,0,0,0*1A Field Description $ Each NMEA message starts with „$‟ PMTK Packet Type l Fix Interval te Reserved c l Reserved ue tia Reserved Reserved Q n * e Checksum fid MTK proprietary message 500 Position fix interval (msec). Range: 100~10000 Always 0 Always 0 Always 0 Always 0 End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ Con 3.39. Packet Type: 501 PMTK_DT_DGPS_MODE This message is the response to PMTK_API_Q_DGPS_MODE. Data Field: $PMTK501,Mode Example: $PMTK501,1*2B Field Description L76_Series_GNSS_Protocol_Specification Confidential / Released 44 / 55 GNSS Module Series L76 Series GNSS Protocol Specification $ Each NMEA message starts with „$‟ PMTK MTK proprietary message Packet Type Mode * 501 DGPS data source mode „0‟=No DGPS source „1‟=RTCM „2‟=SBAS End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ l 3.40. Packet Type: 513 PMTK_DT_SBAS_ENABLED cte l This message is the response to PMTK_API_Q_SBAS_ENABLED. ue tia DataField: $PMTK513,Enable Example: Q n $PMTK513,1*28 e Field Description fid $ PMTK n Packet Type Co Enable Each NMEA message starts with „$‟ MTK proprietary message 513 „0‟=Disable „1‟=Enable * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 45 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.41. Packet Type: 514 PMTK_DT_NMEA_OUTPUT This message is the response to PMTK_API_Q_NMEA_OUTPUT. Data Field: None Example: $PMTK514,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0*2E Field Description $ PMTK Packet Type 0 GLL 1 RMC 2 VTG 3 GGA 4 GSA 5 GSV 6 Reserved 7 Reserved 8 Reserved 9 Reserved 10 Reserved Each NMEA message starts with „$‟ MTK proprietary message 514 l GLL interval - Geographic position - latitude longitude te RMC interval - Recommended minimum specific GNSS sentence c l VTG interval - Course over ground and ground speed ue tia GGAinterval - GPS fix data GSA interval - GNSS DOPS and active satellites Q n GSV interval - GNSS satellites in view e GRS interval – GNSS range residuals Confid GST interval – GNSS pseudorange error statistics 11 Reserved 12 Reserved 13 Reserved 14 Reserved 15 Reserved L76_Series_GNSS_Protocol_Specification Confidential / Released 46 / 55 16 Reserved 17 ZDA 18 Reserved * Checksum GNSS Module Series L76 Series GNSS Protocol Specification ZDA interval - Time and date PMTKCHN interval - GNSS channel status End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ 3.42. Packet Type: 705 PMTK_DT_RELEASE This message is the response to PMTK_Q_RELEASE. tel Data Field: $PMTK705, Release string, Build ID, Product Model(,SDK Version) c l Example: $PMTK705,AXN_3.10_3333_12102201,0000,QUECTEL-L76,*18 ue tia Field Description Q n $ e PMTK fid Packet Type Con Release String Each NMEA message starts with „$‟ MTK proprietary message 705 Firmware release name and version 3318: Mcore_x.x 3329: AXN_x.x 3339: AXN_x.x 3333: AXN_x.x 3337: AXN_x.x Build ID Build ID set in CoreBuilder for firmware version control Product Model SDK Version (Optional) * Product model set in CoreBuilder for product identification Showing SDK version if the firmware is used for SDK End character of data field Checksum Hexadecimal checksum L76_Series_GNSS_Protocol_Specification Confidential / Released 47 / 55 GNSS Module Series L76 Series GNSS Protocol Specification Each NMEA message ends with „CR‟ and „LF‟ 3.43. Packet Type: 838 PMTK_TEST_ANTI_SPOOFING This message is used to enable or disable jamming detection function. Data Field: $PMTK838,CmdType Example: $PMTK838,1*2C Response: $PMTK001,838,3,1*2E Return: l $PMTKSPF,1*5A => No jamming, healthy status (status 1). $PMTKSPF,2*59 => Warning status (status 2). te $PMTKSPF,3*58 => Critical status (status 3). c l Field Description ue tia $ PMTK Q n Packet Type e CmdType fid * n Checksum Co Each NMEA message starts with „$‟ MTK proprietary message 838 „0‟=Disable jamming detection function „1‟=Enable jamming detection function End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ NOTE After jamming detection is enabled, the module starts to detect whether there is jamming. 1. If there is no jamming, '$PMTKSPF,1*5A' will be reported to indicate healthy status (status 1). 2. If there is continuous jamming, then the module status will change from 1 to 2 and finally 3.  In the case of not being positioned: after jamming detection is enabled, the module status will be 1 at the very beginning, and then change to 2 when jamming is detected. During the process, the module will attempt to fix position. If it still fails in positioning after 200s, the module status will change to 3 finally. L76_Series_GNSS_Protocol_Specification Confidential / Released 48 / 55 GNSS Module Series L76 Series GNSS Protocol Specification  In the case of being positioned: after jamming detection is enabled, the module status will be 1 at the very beginning. When jamming is detected, the module status will change to 2 and then 3 consecutively. 3.44. Packet Type: 869 PMTK_EASY_ENABLE This message is used to enable or disable EASYTM function, and it can also be used to query whether EASYTM is enabled or disabled. Data Field: $PMTK869,CmdType[, Enabled] Example: $PMTK869,1,1*35 l Response: $PMTK001,869,3*37 te Field Description c l $ ue tia PMTK Packet Type Q en CmdType fid Enabled n * Co Checksum Each NMEA message starts with „$‟ MTK proprietary message 869 „0‟=Query „1‟=Set „2‟=Result for query operation „0‟=Disable „1‟=Enable End character of data field Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ NOTE 1. If EASYTM is disabled, the receiver returns: $PMTK869,2,0,0*2B 2. If EASYTM is enabled and is not finished yet, the receiver may return: $PMTK869,2,1,0*2A 3. If EASYTM is enabled and is finished after 1 day, the receiver may return: L76_Series_GNSS_Protocol_Specification Confidential / Released 49 / 55 GNSS Module Series L76 Series GNSS Protocol Specification $PMTK869,2,1,1*2B 4. If EASYTM is enabled and is finished after 2 days, the receiver may return: $PMTK869,2,1,2*28 5. If EASYTM is enabled and is finished after 3 days, the receiver may return: $PMTK869,2,1,3*29 3.45. Packet Type: 875 PMTK_PMTKLSC_STN_OUTPUT This message is used to enable or disable PMTKLSC sentence output. Query whether PMTKLSC sentence output is enabled or disabled. Data Field: $PMTK875,CmdType[,Enabled] l Example: $PMTK875,1,1*38: Enable PMTKLSC and PMTKLSCB sentence output te Response: $PMTKLSC,Parameter1,Parameter2,Parameter3*CS c l $PMTKLSB,Parameter1,Parameter2,Parameter3*CS ue tia Where Parameter1: current leap second Parameter2: leap indicator, 1 means updated from broadcast data Parameter3: next leap second Q n Field Description e $ fid PMTK Packet Type Con CmdType Each NMEA message starts with „$‟ MTK proprietary message 875 „0‟=Query „1‟=Set „2‟=Result for query operation „0‟=Disable Enabled „1‟=Enable * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 50 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 3.46. Packet Type: 886 PMTK_FR_MODE This message is used to set navigation mode. Data Field: $PMTK886,CmdType Example: $PMTK886,3*2B Response: $PMTK001,886,3*36 Field $ PMTK Packet Type CmdType * Checksum NOTE Description Each NMEA message starts with „$‟ MTK proprietary message l 886 te „0‟=Normal mode: For general purpose c l „1‟=Fitness mode: For running and walking purpose that the low-speed (<5m/s) movement will have more effect on the position calculation. ue tia „2‟=Aviation mode: For high-dynamic purpose that the large-acceleration movement will have more effect on the position calculation. „3‟=Balloon mode: For high-altitude balloon purpose that the vertical Q n movement will have more effect on the position calculation. „4‟=Stationary mode: For stationary applications that zero dynamics is e assumed. fid End character of data field Hexadecimal checksum ConEach NMEA message ends with „CR‟ and „LF‟ Each mode has its altitude limitation. Please choose the appropriate mode base on the table below. If the test scenario exceeds the limitation, the position calculation will be incorrect. Mode Altitude Limitation Normal mode 10000m Fitness mode 10000m Aviation mode 10000m Stationary mode 10000m Balloon mode 80000m L76_Series_GNSS_Protocol_Specification Confidential / Released 51 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 4 Default Configurations Table 1: Default Configurations Item Default NMEA Port Baud Rate 9600bps Datum Rate of Position Fixing l DGPS Mode te SBAS Enable c l NMEA Output Messages ue tia AIC CQonfiden EASYTM WGS84 1Hz SBAS Enable GGA, RMC, GSA, GSV, VTG and GLL On On L76_Series_GNSS_Protocol_Specification Confidential / Released 52 / 55 GNSS Module Series L76 Series GNSS Protocol Specification 5 Appendix A References Table 2: Related Documents SN Document Name Remark [1] Quectel_L76_Series_Hardware_Design L76 Series Hardware Design [2] Quectel_L76_Series_EVB_User Guide L76 Series EVB User Guide [3] Quectel_L76_Series_Reference_Design L76 Series Reference Design l [4] Quectel_GNSS_SDK_Commands_Manual GNSS SDK Commands Manual cte l Table 3: Terms and Abbreviations ue tia Abbreviation AGPS Q n AIC e CS fid DGPS n GGA o GLL C GLONASS Description Assisted Global Positioning System Active Interference Cancellation Commercial Sample Differential Global Positioning System NMEA: Global Positioning System Fix Data NMEA: Geographic Latitude and Longitude Global Navigation Satellite System (The Russian GNSS) GNSS Global Navigation Satellite System GPS Global Positioning System GSA GSV HDOP NMEA: GNSS DOP and Active Satellites NMEA: GNSS Satellites in View Horizontal Dilution of Precision L76_Series_GNSS_Protocol_Specification Confidential / Released 53 / 55 GNSS Module Series L76 Series GNSS Protocol Specification NMEA National Marine Electronics Association PDOP Position Dilution of Precision PPS Pulse Per Second PMTK Private Protocol of MTK RMC NMEA: Recommended Minimum Position Data SBAS Satellite-Based Augmentation System UTC Universal Time Coordinated VDOP VTG l WAAS Vertical Dilution of Precision NMEA: Track Made Good and Ground Speed Wide Area Augmentation System cte l Table 4: Structure of NMEA Message ue tia Filed $ Q fiden TalkerID Con NMEA Message ID Length (Bytes) Description 1 Each NMEA message starts with „$‟ Talker IDs can be „GP‟, „GN‟ and „BD‟ when the message ID is RMC, VTG, GLL or GGA. Talker IDs can be „GP‟, „GN‟, „BD‟ and „GA‟ when the message ID is GSA. 1~2 Talker IDs can be „GP‟, „GL‟, „BD‟ and „GA‟ when the message ID is GSV. Talker IDs can be „GN‟ when the message ID is GBS. 3 NMEA message ID Variable, depends on the Data Field Data fields, delimited by comma „,‟ NMEA message type * 1 End character of data field Checksum 2 A hexadecimal number calculated by exclusive OR of all characters between „$‟ and „*‟ 2 Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 54 / 55 GNSS Module Series L76 Series GNSS Protocol Specification NOTE The default output message of L76 series has the following six sentences: RMC, VTG, GGA, GSA, GSV and GLL. But if the receiver is fixed by GPS, GLONASS and Galileo, the default output message of L76 series has the following six sentences: RMC, VTG, GGA, GSA, GSV and GBS. Table 5: Structure of MTK NMEA Packet Filed Length (Bytes) Description $ 1 Each NMEA message starts with „$‟ Talker ID 1 „P‟ for proprietary message NMEA Data Type 3 Always „MTK‟ to indicate MTK proprietary message tel Data Filed Packet Type 3 Packet type, from „000‟ to „999‟ Variable, depends Packet Data Data fields, delimited by comma „,‟ on the packet type c l * 1 End character of data field ue tia Checksum 2 A hexadecimal number calculated by exclusive OR of all characters between „$‟ and „*‟ CQonfiden 2 Each NMEA message ends with „CR‟ and „LF‟ L76_Series_GNSS_Protocol_Specification Confidential / Released 55 / 55

L70-R Series GPS Protocol Specification GPS Module Series Rev. L70-R_Series_GPS_Protocol_Specification_V3.0 Date: 2016-06-01 www.quectel.com GPS Module Series L70-R Series GPS Protocol Specification Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. THE INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. L70-R_Series_GPS_Protocol_Specification Confidential / Released 1 / 38 GPS Module Series L70-R Series GPS Protocol Specification About the Document History Revision 1.0 2.0 2.1 3.0 Date 2014-05-07 l 2015-07-09 cte l 2015-12-03 CQounefidentia 2016-06-01 Author Ada LI Connie ZHOU Connie ZHOU Connie ZHOU Description Initial 1. Added Packet Type 869 2. Deleted Packet Type 183, 184, 185, 223, 225, 313, 413, 513 and 622 3. Modified parameter for Packet Type 301 1. Added Packet Type 255, 285 and 886 2. Deleted Packet Type 300 1. Changed the document name from Quectel_L70-R_GPS_Protocol_Specification to Quectel_L70-R_Series_GPS_Protocol_Specific ation 2. Modified example for Packet Type 705 3. Modified parameter for Packet Type 220 and 500 4. Modified example for NMEA sentences GPRMC, GPGGA, GPGLL 5. Added Packet Type 351, 352 L70-R_Series_GPS_Protocol_Specification Confidential / Released 2 / 38 GPS Module Series L70-R Series GPS Protocol Specification Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 2 Standard NMEA Packet Protocol ....................................................................................................... 7 2.1. GPRMC ....................................................................................................................................... 7 2.2. GPVTG........................................................................................................................................ 8 2.3. GPGGA ....................................................................................................................................... 9 3 2.4. GPGSA...................................................................................................................................... 10 2.5. GPGSV...................................................................................................................................... 11 2.6. GPGLL ...................................................................................................................................... 13 MTK NMEA Packet Protocol ............................................................................................................. 14 l 3.1. Packet Type: 010 PMTK_SYS_MSG........................................................................................ 14 te 3.2. Packet Type: 011 PMTK_TXT_MSG ........................................................................................ 15 3.3. Packet Type: 001 PMTK_ACK.................................................................................................. 16 c l 3.4. Packet Type: 101 PMTK_CMD_HOT_START.......................................................................... 16 3.5. Packet Type: 102 PMTK_CMD_WARM_START ...................................................................... 17 ue tia 3.6. Packet Type: 103 PMTK_CMD_COLD_START .......................................................................18 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START ............................................................ 18 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE ................................................................. 19 Q n 3.9. Packet Type: 220 PMTK_SET_POS_FIX................................................................................. 19 3.10. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE ................................................................ 20 e 3.11. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA ................................................................ 21 fid 3.12. Packet Type: 285 PMTK_SET_PPS_CONFIG......................................................................... 21 3.13. Packet Type: 286 PMTK_SET_AIC_ENABLED ....................................................................... 22 3.14. Packet Type: 301 PMTK_API_SET_DGPS_MODE ................................................................. 23 n 3.15. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT............................................................. 24 3.16. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA .............................................. 26 o 3.17. Packet Type: 352 PMTK_API_SET_STOP_QZSS .................................................................. 26 C 3.18. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD ......................................................... 27 3.19. Packet Type: 400 PMTK_API_Q_FIX_CTL .............................................................................. 28 3.20. Packet Type: 401 PMTK_API_Q_DGPS_MODE ..................................................................... 28 3.21. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT ................................................................. 29 3.22. Packet Type: 605 PMTK_Q_RELEASE.................................................................................... 29 3.23. Packet Type: 500 PMTK_DT_FIX_CTL.................................................................................... 30 3.24. Packet Type: 501 PMTK_DT_DGPS_MODE ........................................................................... 31 3.25. Packet Type: 514 PMTK_DT_NMEA_OUTPUT....................................................................... 31 3.26. Packet Type: 705 PMTK_DT_RELEASE.................................................................................. 33 3.27. Packet Type: 869 PMTK_EASY_ENABLE ............................................................................... 34 3.28. Packet Type: 886 PMTK_FR_MODE ....................................................................................... 34 L70-R_Series_GPS_Protocol_Specification Confidential / Released 3 / 38 GPS Module Series L70-R Series GPS Protocol Specification 4 Appendix A References..................................................................................................................... 36 5 Default Configurations ...................................................................................................................... 38 CQouneficdteenl tial L70-R_Series_GPS_Protocol_Specification Confidential / Released 4 / 38 GPS Module Series L70-R Series GPS Protocol Specification Table Index TABLE 1: STRUCTURE OF NMEA MESSAGE .......................................................................................... 7 TABLE 2: STRUCTURE OF MTK NMEA PACKET ................................................................................... 14 TABLE 3: RELATED DOCUMENTS .......................................................................................................... 36 TABLE 4: TERMS AND ABBREVIATIONS ................................................................................................ 36 TABLE 5: DEFAULT CONFIGURATIONS.................................................................................................. 38 CQouneficdteenl tial L70-R_Series_GPS_Protocol_Specification Confidential / Released 5 / 38 GPS Module Series L70-R Series GPS Protocol Specification 1 Introduction L70-R series module includes L70-R and L70-RL variants. It is a collection of full-featured GPS module with super sensitivity. It is characteristic by low power consumption and compact size. The module supports autonomous GPS C/A. It can be used in positioning, navigation and other industries. This document describes the software aspects of L70-R series module. L70-R series supports NMEA 0183 standard commands. MTK NMEA extended packet is supported to control and configure L70-R CQouneficdteenl tial seriesGPSmodule. L70-R_Series_GPS_Protocol_Specification Confidential / Released 6 / 38 GPS Module Series L70-R Series GPS Protocol Specification 2 Standard NMEA Packet Protocol L70-R series supports NMEA 0183 standard messages. The following table shows the structure of a NMEA 0183 standard message. Table 1: Structure of NMEA Message Filed Length (Bytes) Description $ 1 Each NMEA message starts with ‘$’ l Talker ID 1~2 ‘GP’ for a GPS receiver te NMEA Message ID c l Data Field 3 NMEA message ID Variable, depend on the NMEA Data fields, delimited by comma ‘,’ message type ue tia * 1 End character of data field Q n Checksum 2 A hexadecimal number calculated by exclusive OR of all characters between ‘$’ and ‘*’ e 2 Each NMEA message ends with ‘CR’ and ‘LF’ fid NOTE The default output message of L70-R series has the following six sentences: RMC, VTG, GGA, GSA, Con GSV and GLL. 2.1. GPRMC RMC: recommended minimum position data (including position, velocity and time). Example: $GPRMC,104749.000,A,3150.7846,N,11711.9256,E,0.16,48.45,230516,,,A*5D Field Description L70-R_Series_GPS_Protocol_Specification Confidential / Released 7 / 38 GPS Module Series L70-R Series GPS Protocol Specification $ Each NMEA message starts with ‘$’ GPRMC Message ID UTC Time Time in format ‘hhmmss.sss’ Data Valid ‘V’=Invalid ‘A’=Valid Latitude Latitude in format ‘ddmm.mmmm’ (degree and minutes) ‘N’=North N/S ‘S’=South Longitude Longitude in format ‘dddmm.mmmm’ (degree and minutes) E/W Speed l COG te Date c l Magnetic Variation ue tia E/W Positioning Mode Q en * fid Checksum ‘E’=East ‘W’=West Speed over ground in knots Course over ground in degree Date in format ‘ddmmyy’ Magnetic variation in degree, not being output Magnetic variation E/W indicator, not being output ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each of message Con 2.2. GPVTG VTG: track made good and ground speed. Example: $GPVTG,0.0,T,,M,0.0,N,0.1,K,A*0C Field Description $ Each NMEA message starts with ‘$’ L70-R_Series_GPS_Protocol_Specification Confidential / Released 8 / 38 GPS Module Series L70-R Series GPS Protocol Specification GPVTG Message ID COG (T) Course over ground (true) in degree T Fixed field, true COG (M) Course over ground (magnetic), not being output M Fixed field, magnetic Speed Speed over ground in knots N Fixed field, knots Speed K l Positioning Mode te * c l Checksum ue tia Speed over ground in km/h Fixed field, km/h ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each of message Q en 2.3. GPGGA fid GGA: global positioning system fix data. It is the essential fix data which provides 3D location and accuracy data. on Example: C $GPGGA,104750.000,3150.7855,N,11711.9258,E,1,6,1.73,54.9,M,0.0,M,,*59 Field Description $ Each NMEA message starts with ‘$’ GPGGA Message ID UTC Time Time in format ‘hhmmss.sss’ Latitude Latitude in format ‘ddmm.mmmm’ (degree and minutes) L70-R_Series_GPS_Protocol_Specification Confidential / Released 9 / 38 GPS Module Series L70-R Series GPS Protocol Specification N/S Longitude E/W Fix Status Number of SV ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmm’ (degree and minutes) ‘E’=East ‘W’=West ‘0’=Invalid ‘1’=GPS fix ‘2’=DGPS fix Number of satellites being used (0~12) HDOP Horizontal Dilution Of Precision Altitude M l GeoID Separation te M c l DGPSAge ue tia DGPSStationID * Q n Checksum e Altitude in meters according to WGS84 ellipsoid Fixed field, meter Height of GeoID (mean sea level) above WGS84 ellipsoid, meter Fixed field, meter Age of DGPS data in seconds, empty if DGPS is not used DGPS station ID, empty if DGPS is not used End character of data field Hexadecimal checksum Each of message nfid 2.4. GPGSA Co GSA: GPS DOP and Active Satellites. It provides details on the fix, including the numbers of the satellites being used and the DOP. At most the first 12 satellite IDs are outputted. Example: $GPGSA,A,3,18,25,12,193,24,15,22,14,,,,,1.47,1.17,0.89*37 Field Description $ Each NMEA message starts with ‘$’ GPGSA Message ID L70-R_Series_GPS_Protocol_Specification Confidential / Released 10 / 38 GPS Module Series L70-R Series GPS Protocol Specification Mode Fix Status Satellite Used 1 Auto selection of 2D or 3D fix ‘M’=Manual, forced to switch 2D/3D mode ‘A’=Allowed to automatically switch 2D/3D mode ‘1’=No fix ‘2’=2D fix ‘3’=3D fix Satellite used on channel 1 Satellite Used 2 Satellite used on channel 2 Satellite Used 3 Satellite used on channel 3 Satellite Used 4 Satellite used on channel 4 Satellite Used 5 Satellite Used 6 l Satellite Used 7 te Satellite Used 8 c l Satellite Used 9 ue tia SatelliteUsed10 Satellite Used 11 Q n Satellite Used 12 fide PDOP HDOP n VDOP o * C Checksum Satellite used on channel 5 Satellite used on channel 6 Satellite used on channel 7 Satellite used on channel 8 Satellite used on channel 9 Satellite used on channel 10 Satellite used on channel 11 Satellite used on channel 12 Position Dilution Of Precision Horizontal Dilution Of Precision Vertical Dilution Of Precision End character of data field Hexadecimal checksum Each of message 2.5. GPGSV GSV: GPS Satellites in View. One GSV sentence can only provide data for at most 4 satellites, so several sentences might be required for the full information. Since GSV includes satellites that are not used as L70-R_Series_GPS_Protocol_Specification Confidential / Released 11 / 38 GPS Module Series L70-R Series GPS Protocol Specification part of the solution, GSV sentence contains more satellites than GGA does. Example: $GPGSV,3,1,12,01,05,060,18,02,17,259,43,04,56,287,28,09,08,277,28*77 $GPGSV,3,2,12,10,34,195,46,13,08,125,45,17,67,014,,20,32,048,24*74 $GPGSV,3,3,12,23,13,094,48,24,04,292,24,28,49,178,46,32,06,037,22*7D Field Description $ Each NMEA message starts with ‘$’ GPGSV Message ID Number of messages, total number of GPGSV messages being output Number of Message Sequence Number Satellites in View l Satellite ID 1 te Elevation 1 c l Azimuth 1 ue tia SNR1 Satellite ID 2 Q n Elevation 2 e Azimuth 2 fid SNR 2 Satellite ID 3 n Elevation 3 Co Azimuth 3 (1~3) Sequence number of this entry (1~3) Total satellites in view Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to Noise Ration in dBHz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to Noise Ration in dBHz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) SNR 3 Signal to Noise Ration in dBHz (0~99), empty if not tracking Satellite ID 4 Satellite ID Elevation 4 Elevation in degree (0~90) Azimuth 4 Azimuth in degree (0~359) SNR 4 Signal to Noise Ration in dBHz (0~99), empty if not tracking * End character of data field L70-R_Series_GPS_Protocol_Specification Confidential / Released 12 / 38 Checksum GPS Module Series L70-R Series GPS Protocol Specification Hexadecimal checksum Each of message 2.6. GPGLL GLL: Geographic Latitude and Longitude. It contains position information, time of position fix and status. Example: $GPGLL,3150.7855,N,11711.9258,E,104750.000,A,A*57 Field $ l GPGLL te Latitude c l N/S ue tia Longitude E/W Q en UTCTime fid Data Valid n Positioning Mode Co * Description Each NMEA message starts with ‘$’ Message ID Latitude in format ‘ddmm.mmmm’ (degree and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmm’ (degree and minutes) ‘E’=East ‘W’=West Time in format ‘hhmmss.sss’ ‘V’=Invalid ‘A’=Valid ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Checksum Hexadecimal checksum Each of message L70-R_Series_GPS_Protocol_Specification Confidential / Released 13 / 38 GPS Module Series L70-R Series GPS Protocol Specification 3 MTK NMEA Packet Protocol This chapter introduces the MTK NMEA packet protocol, which is a set of extension messages of the standard NMEA packet protocol. These messages are used to control and configure L70-R series GPS module. The following table shows the structure of a MTK NMEA packet. Table 2: Structure of MTK NMEA Packet Filed $ tel Talker ID NMEA Data type uec tial DataFiled Packet type Packet data Q n * e Checksum fid Length(Bytes) 1 1 3 Description Each NMEA message starts with ‘$’ ‘P’ for proprietary message Always ‘MTK’ to indicate MTK proprietary message 3 Packet type, from ‘000’ to ‘999’ Variable, depend Data fields, delimited by comma ‘,’ on the packet type 1 End character of data field A hexadecimal number calculated by exclusive OR of 2 all characters between ‘$’ and ‘*’ 2 Each NMEA message ends with ‘CR’ and ‘LF’ Con 3.1. Packet Type: 010 PMTK_SYS_MSG This message is used to automatically output system messages of GPS module. Data Field: None Example: $PMTK010,001*2E Field Description L70-R_Series_GPS_Protocol_Specification Confidential / Released 14 / 38 GPS Module Series L70-R Series GPS Protocol Specification $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Message * 010 System message ‘0’=Unknown ‘1’=Startup ‘2’=Notification for the host aiding EPO ‘3’=Notification for the transition to normal mode is successfully done End character of data field Checksum Hexadecimal checksum Each of message tel 3.2. Packet Type: 011 PMTK_TXT_MSG c l This message is used to automatically output system messages of GPS module. ue tia DataField: None Q n Example: e $PMTK011,MTKGPS*08 Field Description fid $ Each NMEA message starts with ‘$’ n PMTK MTK proprietary message o Packet Type 011 C Message MTKGPS * End character of data field Checksum Hexadecimal checksum Each of message L70-R_Series_GPS_Protocol_Specification Confidential / Released 15 / 38 GPS Module Series L70-R Series GPS Protocol Specification 3.3. Packet Type: 001 PMTK_ACK Acknowledgement of PMTK command. In order to inform the sender whether the receiver has received the packet, an acknowledge packet PMTK_ACK should return after the receiver receives a packet. Some commands will cause the GPS module to restart or change the baud rate.There is no PMTK_ACK for those commands as listed below.  PMTK_CMD_HOT_START  PMTK_CMD_WARM_START  PMTK_CMD_COLD_START  PMTK_CMD_FULL_COLD_START  PMTK_SET_NMEA_BAUDRATE Data Field: l $PMTK001,Cmd,Flag Example: te $PMTK001,869,3*37 c l Field Description ue tia $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Q n Packet Type 001 e Command fid Flag on * The packet type that the acknowledge responds ‘0’=Invalid packet ‘1’=Unsupported packet type ‘2’=Valid packet, but action failed ‘3’=Valid packet, action succeeded End character of data field C Checksum Hexadecimal checksum Each of message 3.4. Packet Type: 101 PMTK_CMD_HOT_START This message is used to hot start the GPS module (use all available data in the NV store). Normally hot start means the GPS module was powered down less than 3 hours (RTC must be alive) and its ephemeris L70-R_Series_GPS_Protocol_Specification Confidential / Released 16 / 38 GPS Module Series L70-R Series GPS Protocol Specification is still valid. As there is no need for downloading ephemeris, it is the fastest startup method. Data Field: None Example: $PMTK101*32 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 101 * Checksum l End character of data field Hexadecimal checksum Each of message uecte tial 3.5. Packet Type: 102 PMTK_CMD_WARM_START This message is used to warm start the GPS module. Warm start means the GPS module has Q n approximate information of time, position and coarse data on satellite positions. But it needs to download ephemeris until it can get a fix. Using this message will enable the GPS module to be warm-restarted e without using the ephemeris data in NV. fid Data Field: None n Example: $PMTK102*31 Co Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 102 * End character of data field Checksum Hexadecimal checksum L70-R_Series_GPS_Protocol_Specification Confidential / Released 17 / 38 Each of message GPS Module Series L70-R Series GPS Protocol Specification 3.6. Packet Type: 103 PMTK_CMD_COLD_START This message is used to cold start the GPS module. Using this message will enable the GPS module to be cold-restarted without using any prior location information, including time, position, almanacs and ephemeris data. Data Field: None Example: $PMTK103*30 Field Description l $ Each NMEA message starts with ‘$’ te PMTK MTK proprietary message c l Packet Type 103 ue tia * End character of data field Q n Checksum Hexadecimal checksum e Each of message fid 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START on This message is essentially a cold restart, but additionally it will clear system and user configurations at C re-start. That is, reset the GPS module to the factory status. Full cold start means that the GPS module has no information on last location. It needs to search the full time and frequency space, and also all possible satellite numbers before it can get a fix. Data Field: None Example: $PMTK104*37 Field Description L70-R_Series_GPS_Protocol_Specification Confidential / Released 18 / 38 $ PMTK Packet Type * Checksum GPS Module Series L70-R Series GPS Protocol Specification Each NMEA message starts with ‘$’ MTK proprietary message 104 End character of data field Hexadecimal checksum Each of message 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE This message is used to enter standby mode for power saving. tel Data Field: $PMTK161,Type c l Example: $PMTK161,0*28 ue tia Response: $PMTK001,161,3*36 Q n Field Description e $ Each NMEA message starts with ‘$’ fid PMTK MTK proprietary message Packet Type 161 n Type ‘0’=Stop mode Co * End character of data field Checksum Hexadecimal checksum Each of message 3.9. Packet Type: 220 PMTK_SET_POS_FIX This message is used to set position fix interval. L70-R_Series_GPS_Protocol_Specification Confidential / Released 19 / 38 GPS Module Series L70-R Series GPS Protocol Specification Data Field: $PMTK220, Interval Example: $PMTK220,1000*1F Response: $PMTK001,220,3*30 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 220 Interval * l Checksum te Position fix interval [msec]. [Range: 100~10000] End character of data field Hexadecimal checksum Each of message uec tial 3.10. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE Q n This message is used to set NMEA port baud rate. Using PMTK251 command to setup baud rate setting, e the setting will back to default value when full cold start command is issued. fid Data Field: $PMTK251,Baudrate Example: n $PMTK251,38400*27 Co Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Baud Rate 251 Baud rate setting: 9600 - default setting 4800 9600 14400 L70-R_Series_GPS_Protocol_Specification Confidential / Released 20 / 38 * Checksum GPS Module Series L70-R Series GPS Protocol Specification 19200 38400 57600 115200 End character of data field Hexadecimal checksum Each of message 3.11. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA This message is used to enable or disable fix NMEA output time behind PPS function. (Default off) l Data Field: te $PMTK255,Enable Example: c l $PMTK255,0*2C Response: ue tia $PMTK001,255,3*32 Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type Enable n * 255 ‘0’=Disable ‘1’=Enable End character of data field Co Checksum Hexadecimal checksum Each of message 3.12. Packet Type: 285 PMTK_SET_PPS_CONFIG This message is used to set PPS type. L70-R_Series_GPS_Protocol_Specification Confidential / Released 21 / 38 GPS Module Series L70-R Series GPS Protocol Specification Data Field: $PMTK285,Type,PPSPulseWidth Example: $PMTK285,4,100*38 Response: $PMTK001,285,3*3F Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 285 Type tel PPSPulseWidth c l * ue tia Checksum ‘0’=Disable ‘1’=After the first fix ‘2’=3D fix only ‘3’=2D/3D fix only ‘4’=Always 2~998 (Unit: ms) End character of data field Hexadecimal checksum Each of message Q fiden 3.13. Packet Type: 286 PMTK_SET_AIC_ENABLED This message is used to enable or disable AIC function. It is suggested to set cold start command first and n then PMTK command. Co Data Field: $PMTK286,Enable Example: $PMTK286,0*22 Response: $PMTK001,286,3*3C Field Description $ Each NMEA message starts with ‘$’ L70-R_Series_GPS_Protocol_Specification Confidential / Released 22 / 38 GPS Module Series L70-R Series GPS Protocol Specification PMTK Packet Type Enable * Checksum MTK proprietary message 286 ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each of message 3.14. Packet Type: 301 PMTK_API_SET_DGPS_MODE l This message is used to configure the source mode of DGPS correction data. te Data Field: $PMTK301,Mode c l Example: ue tia $PMTK301,1*2D Response: $PMTK001,301,3*32 Q n Field Description e $ Each NMEA message starts with ‘$’ fid PMTK MTK proprietary message Packet Type Con Mode 301 DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM mode * End character of data field Checksum Hexadecimal checksum Each of message L70-R_Series_GPS_Protocol_Specification Confidential / Released 23 / 38 GPS Module Series L70-R Series GPS Protocol Specification 3.15. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT This message is used to set NMEA sentence output frequencies. There are totally 19 data fields that present output frequencies for the 19 supported NMEA sentences individually. Supported Frequency Settings:  0 - Disabled or not supported sentence  1 - Output once every one position fix  2 - Output once every two position fixes  3 - Output once every three position fixes  4 - Output once every four position fixes  5 - Output once every five position fixes Data Field: l None Example: te The module only output RMC once every one position fix. $PMTK314,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*29 c l Response: ue tia $PMTK001,314,3*36 Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type 314 0 GLL GLL interval - Geographic Position - Latitude longitude n 1 RMC RMC interval - Recommended Minimum Specific GPS Sentence Co 2 VTG VTG interval - Course Over Ground and Ground Speed 3 GGA GGA interval - GPS Fix Data 4 GSA GSA interval - GPS DOPS and Active Satellites 5 GSV GSV interval - GPS Satellites in View 6 Reserved Always 0 7 Reserved Always 0 8 Reserved Always 0 L70-R_Series_GPS_Protocol_Specification Confidential / Released 24 / 38 GPS Module Series L70-R Series GPS Protocol Specification 9 Reserved Always 0 10 Reserved Always 0 11 Reserved Always 0 12 Reserved Always 0 13 Reserved Always 0 14 Reserved Always 0 15 Reserved Always 0 16 Reserved 17 ZDA l 18 Reserved te * c l Checksum ue tia Always 0 ZDA interval - Time and Date Always 0 End character of data field Hexadecimal checksum Each of message The following message can be used to restore the system default setting: Q n Example: e $PMTK314,-1*04 fid Field Description $ Each NMEA message starts with ‘$’ n PMTK MTK proprietary message Co Packet Type 314 Restore Always -1 * End character of data field Checksum Hexadecimal checksum Each of message L70-R_Series_GPS_Protocol_Specification Confidential / Released 25 / 38 GPS Module Series L70-R Series GPS Protocol Specification 3.16. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA The receiver supports the new NMEA format for QZSS. The command allows users to enable or disable QZSS NMEA format. QZSS NMEA format is disabled by defult. Data Field: $PMTK351,Enable Example: $PMTK351,1*28 Response: $PMTK001,351,3*37 Field $ l PMTK te Packet Type c l QZSS_Enable ue tia * Checksum Q n Description Each NMEA message starts with ‘$’ MTK proprietary message 351 ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each of message fide 3.17. Packet Type: 352 PMTK_API_SET_STOP_QZSS n QZSS is regional positioning service. This command is used to enable or disable QZSS function. QZSS Co function is enabled by defualt. Data Field: $PMTK352,Enable Example: $PMTK352,0*2A Response: $PMTK001,352,3*34 Field Description L70-R_Series_GPS_Protocol_Specification Confidential / Released 26 / 38 GPS Module Series L70-R Series GPS Protocol Specification $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type QZSS_Enable * 352 ‘0’=Enable ‘1’=Disable End character of data field Checksum Hexadecimal checksum Each of message 3.18. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD tel This message is used to set the speed threshold for static navigation. If the actual speed is below the threshold, output position will keep the same and output speed will be zero. If the threshold value is set as c l 0, this function is disabled. ue tia DataField: $PMTK386,Speed_threshold Example: Q n $PMTK386,0.3*3E e Response: $PMTK001,386,3*3D fid Field Description $ on PMTK C Packet Type Each NMEA message starts with ‘$’ MTK proprietary message 386 Speed_threshold 0~2m/s * End character of data field Checksum Hexadecimal checksum Each of message L70-R_Series_GPS_Protocol_Specification Confidential / Released 27 / 38 GPS Module Series L70-R Series GPS Protocol Specification 3.19. Packet Type: 400 PMTK_API_Q_FIX_CTL This message is used to query the rate of position fixing activity. Refer to PMTK_API_SET_FIX_CTL for setting the rate. Refer to PMTK_DT_FIX_CTL for the result of query. Data Field: None Example: $PMTK400*36 Field Description $ l PMTK te Packet Type c l * ue tia Checksum Q n Each NMEA message starts with ‘$’ MTK proprietary message 400 End character of data field Hexadecimal checksum Each of message fide 3.20. Packet Type: 401 PMTK_API_Q_DGPS_MODE n This message is used to query the setting of DGPS mode. Co Refer to PMTK_API_SET_DGPS_MODE for setting the DGPS mode. Refer to PMTK_DT_DGPS_MODE for the result of query. Data Field: None Example: $PMTK401*37 Field Description L70-R_Series_GPS_Protocol_Specification Confidential / Released 28 / 38 $ PMTK Packet Type * Checksum GPS Module Series L70-R Series GPS Protocol Specification Each NMEA message starts with ‘$’ MTK proprietary message 401 End character of data field Hexadecimal checksum Each of message 3.21. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT This message is used to query the current NMEA sentence output frequencies. tel Refer to PMTK_API_SET_NMEA_OUTPUT for the frequencies setting. c l Refer to PMTK_DT_NMEA_OUTPUT for the result of query. ue tia DataField: None Example: Q n $PMTK414*33 e Field Description fid $ PMTK n Packet Type Co * Each NMEA message starts with ‘$’ MTK proprietary message 414 End character of data field Checksum Hexadecimal checksum Each of message 3.22. Packet Type: 605 PMTK_Q_RELEASE This message is used to query the firmware release information. L70-R_Series_GPS_Protocol_Specification Confidential / Released 29 / 38 GPS Module Series L70-R Series GPS Protocol Specification Refer to PMTK_DT_RELEASE for the result of query. Data Field: None Example: $PMTK605*31 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type * Checksum l 605 End character of data field Hexadecimal checksum Each of message uecte tial 3.23. Packet Type: 500 PMTK_DT_FIX_CTL This message is the response to PMTK_API_Q_FIX_CTL. Q en DataField: $PMTK500,Fix interval fid Example: $PMTK500,1000,0,0,0,0*1A n Field Description o $ C PMTK Each NMEA message starts with ‘$’ MTK proprietary message Packet Type 500 Fix Interval Position fix interval [msec]. [Range: 100~10000]. Reserved Always 0 Reserved Always 0 Reserved Always 0 L70-R_Series_GPS_Protocol_Specification Confidential / Released 30 / 38 Reserved * Checksum GPS Module Series L70-R Series GPS Protocol Specification Always 0 End character of data field Hexadecimal checksum Each of message 3.24. Packet Type: 501 PMTK_DT_DGPS_MODE This message is the response to PMTK_API_Q_DGPS_MODE. Data Field: $PMTK501,Mode l Example: $PMTK501,1*2B te Field Description c l $ ue tia PMTK Q n Packet Type e Mode fid * n Checksum Co Each NMEA message starts with ‘$’ MTK proprietary message 501 DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM mode End character of data field Hexadecimal checksum Each of message 3.25. Packet Type: 514 PMTK_DT_NMEA_OUTPUT This message is the response to PMTK_API_Q_NMEA_OUTPUT. Data Field: None Example: L70-R_Series_GPS_Protocol_Specification Confidential / Released 31 / 38 GPS Module Series L70-R Series GPS Protocol Specification $PMTK514,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0*2E Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 514 0 GLL GLL interval - Geographic Position - Latitude longitude 1 RMC RMC interval - Recommended Minimum Specific GPS Sentence 2 VTG 3 GGA l 4 GSA te 5 GSV c l 6 Reserved ue tia 7Reserved 8 Reserved Q n 9 Reserved e 10 Reserved fid 11 Reserved 12 Reserved n 13 Reserved Co 14 Reserved VTG interval - Course Over Ground and Ground Speed GGA interval - GPS Fix Data GSA interval - GPS DOPS and Active Satellites GSV interval - GPS Satellites in View 15 Reserved 16 Reserved 17 ZDA ZDA interval - Time and Date 18 Reserved Always 0 * End character of data field L70-R_Series_GPS_Protocol_Specification Confidential / Released 32 / 38 Checksum GPS Module Series L70-R Series GPS Protocol Specification Hexadecimal checksum Each of message 3.26. Packet Type: 705 PMTK_DT_RELEASE This message is the response to PMTK_Q_RELEASE. Data Field: $PMTK705, Release string, Build ID, Product Model(,SDK Version) Example: $PMTK705,AXN_2.32_3337_15010801,0000,,*2D Field Description l $ te PMTK c l Packet Type Que ntia ReleaseString fide Build ID Product Model n SDK Version o (Optional) C * Each NMEA message starts with ‘$’ MTK proprietary message 705 Firmware release name and version 3318: Mcore_x.x 3329: AXN_x.x 3339: AXN_x.x 3333: AXN_x.x 3337: AXN_x.x Build ID set in CoreBuilder for firmware version control Product Model set in CoreBuilder for product identification Showing SDK version if the firmware is used for SDK End character of data field Checksum Hexadecimal checksum Each of message L70-R_Series_GPS_Protocol_Specification Confidential / Released 33 / 38 GPS Module Series L70-R Series GPS Protocol Specification 3.27. Packet Type: 869 PMTK_EASY_ENABLE This message is used to enable or disable EASY function, and it can also be used to query whether EASY is enabled or disabled. Data Field: $PMTK869,CmdType[, Enabled] Example: $PMTK869,1,1*35 Response: $PMTK001,869,3*37 Field $ l PMTK te Packet Type c l CmdType ue tia Enabled Q n * e Checksum fid Description Each NMEA message starts with ‘$’ MTK proprietary message 869 ‘0’=Query ‘1’=Set ‘2’=Result for Query operation ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each of message Con 3.28. Packet Type: 886 PMTK_FR_MODE This message is used to set navigation mode. Data Field: $PMTK886,CmdType Example: $PMTK886,3*2B Response: $PMTK001,886,3*36 L70-R_Series_GPS_Protocol_Specification Confidential / Released 34 / 38 GPS Module Series L70-R Series GPS Protocol Specification Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 886 CmdType * Checksum ‘0’=Normal mode: For general purpose ‘1’=Fitness mode: For running and walking purpose that the low-speed (<5m/s) movement will have more effect on the position calculation. ‘2’=Aviation mode: For high-dynamic purpose that the large-acceleration movement will have more effect on the position calculation. ‘3’=Balloon mode: For high-altitude balloon purpose that the vertical movement will have more effect on the position calculation. End character of data field l Hexadecimal checksum CQouneficdteential Each of message L70-R_Series_GPS_Protocol_Specification Confidential / Released 35 / 38 GPS Module Series L70-R Series GPS Protocol Specification 4 Appendix A References Table 3: Related Documents SN Document Name Remark [1] Quectel_L70-R_Series_Hardware_Design L70-R Series Hardware Design [2] Quectel_L70-R_Series_EVB_User_Guide L70-R Series EVB User Guide [3] Quectel_L70-R_Series_Reference_Design L70-R Series Reference Design tel Table 4: Terms and Abbreviations c l Abbreviation ue tia AGPS Description Assisted Global Positioning System AIC Q n DGPS e EASY Active Interference Cancellation Differential Global Positioning System Embedded Assist System fid GGA n GLL o GPS NMEA: Global Positioning System Fix Data NMEA: Geographic Position – Latitude/Longitude Global Navigation Satellite System C GSA NMEA: GPS DOP and Active Satellites GSV NMEA: GPS Satellites in View HDOP Horizontal Dilution of Precision NMEA PDOP PMTK National Marine Electronics Association Position Dilution of Precision Private protocol of MTK L70-R_Series_GPS_Protocol_Specification Confidential / Released 36 / 38 PPS RMC UTC VDOP VTG GPS Module Series L70-R Series GPS Protocol Specification Pulse Per Second NMEA: Recommended Minimum Position Data Universal Time Coordinated Vertical Dilution of Precision NMEA: Track Made Good and Ground Speed CQouneficdteenl tial L70-R_Series_GPS_Protocol_Specification Confidential / Released 37 / 38 GPS Module Series L70-R Series GPS Protocol Specification 5 Default Configurations Table 5: Default Configurations Item Default NMEA port baud rate Datum Rate of position fixing l DGPS mode te EASY c l NMEA output messages CQounefidentia AIC 9600bps WGS84 1HZ Off Enabled RMC, VTG, GGA, GSA, GSV and GLL On L70-R_Series_GPS_Protocol_Specification Confidential / Released 38 / 38

L80 GPS Protocol Specification GPS Module Series Rev. L80_GPS_Protocol_Specification_V1.4 Date: 2016-10-18 www.quectel.com GPS Module Series L80 GPS Protocol Specification Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. L80_GPS_Protocol_Specification Confidential / Released 1 / 48 GPS Module Series L80 GPS Protocol Specification About the Document History Revision 1.0 1.1 1.2 1.3 1.4 Date 2013-07-08 l 2013-09-29 te 2014-08-19 uec tial 2015-12-03 CQonfiden 2016-10-18 Author Ada LI Ada LI Ada LI Connie ZHOU Matt YE Description Initial 1. Modified the description of RMC 2. Modified the example of Packet Type 314, 514 and 705 Added Packet Type 220, 223, 356 and 875 1. Modified the description of Packet Type 251 2. Modified the example of Packet Type 386 3. Added Packet Type 255, 351, 352, 262, 285 and 886 4. Modified the description of GPTXT 5. Deleted Packet Type 300 1. Modified the description of Packet Type 220 2. Modified the description of Packet Type 500 L80_GPS_Protocol_Specification Confidential / Released 2 / 48 GPS Module Series L80 GPS Protocol Specification Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 5 1 Introduction ....................................................................................................................................... 6 2 Standard NMEA Packet Protocols ................................................................................................... 7 2.1. GPRMC .................................................................................................................................... 7 2.2. GPVTG ..................................................................................................................................... 8 2.3. GPGGA .................................................................................................................................... 9 3 2.4. GPGSA................................................................................................................................... 10 2.5. GPGSV....................................................................................................................................11 2.6. GPGLL ................................................................................................................................... 13 2.7. GPTXT ................................................................................................................................... 13 l MTK NMEA Packet Protocols......................................................................................................... 15 te 3.1. Packet Type: 010 PMTK_SYS_MSG...................................................................................... 15 3.2. Packet Type: 011 PMTK_TXT_MSG ...................................................................................... 16 c l 3.3. Packet Type: 001 PMTK_ACK................................................................................................ 17 3.4. Packet Type: 101 PMTK_CMD_HOT_START ........................................................................ 17 ue tia 3.5. Packet Type: 102 PMTK_CMD_WARM_START .................................................................... 18 3.6. Packet Type: 103 PMTK_CMD_COLD_START ..................................................................... 19 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START........................................................... 19 Q n 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE ............................................................... 20 3.9. Packet Type: 183 PMTK_LOCUS_QUERY_STATUS ............................................................ 20 e 3.10. Packet Type: 184 PMTK_LOCUS_ERASE_FLASH ............................................................... 22 fid 3.11. Packet Type: 185 PMTK_LOCUS_STOP_LOGGER.............................................................. 22 3.12. Packet Type: 622 PMTK_Q_LOCUS_DATA ........................................................................... 23 3.13. Packet Type: 220 PMTK_SET_POS_FIX ............................................................................... 24 n 3.14. Packet Type: 223 PMTK_SET_AL_DEE_CFG....................................................................... 24 3.15. Packet Type: 225 PMTK_SET_PERIODIC_MODE ................................................................ 25 o 3.16. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE .............................................................. 26 C 3.17. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA............................................................... 27 3.18. Packet Type: 262 PMTK_SET_FLP_MODE........................................................................... 28 3.19. Packet Type: 285 PMTK_SET_PPS_CONFIG ....................................................................... 28 3.20. Packet Type: 286 PMTK_SET_AIC_ENABLED ..................................................................... 29 3.21. Packet Type: 301 PMTK_API_SET_DGPS_MODE ............................................................... 30 3.22. Packet Type: 313 PMTK_API_SET_SBAS_ENABLED .......................................................... 30 3.23. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT ........................................................... 31 3.24. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA ............................................. 33 3.25. Packet Type: 352 PMTK_API_SET_STOP_QZSS ................................................................. 34 3.26. Packet Type: 356 PMTK_API_SET_HDOP_THRESHOLD .................................................... 34 3.27. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD........................................................ 35 L80_GPS_Protocol_Specification Confidential / Released 3 / 48 GPS Module Series L80 GPS Protocol Specification 3.28. Packet Type: 400 PMTK_API_Q_FIX_CTL ............................................................................ 36 3.29. Packet Type: 401 PMTK_API_Q_DGPS_MODE.................................................................... 36 3.30. Packet Type: 413 PMTK_API_Q_SBAS_ENABLED .............................................................. 37 3.31. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT ............................................................... 38 3.32. Packet Type: 605 PMTK_Q_RELEASE.................................................................................. 38 3.33. Packet Type: 500 PMTK_DT_FIX_CTL .................................................................................. 39 3.34. Packet Type: 501 PMTK_DT_DGPS_MODE ......................................................................... 40 3.35. Packet Type: 513 PMTK_DT_SBAS_ENABLED .................................................................... 40 3.36. Packet Type: 514 PMTK_DT_NMEA_OUTPUT ..................................................................... 41 3.37. Packet Type: 705 PMTK_DT_RELEASE................................................................................ 42 3.38. Packet Type: 869 PMTK_EASY_ENABLE ............................................................................. 43 3.39. Packet Type: 875 PMTK_PMTKLSC_STN_OUTPUT ............................................................ 44 4 5 3.40. Packet Type: 886 PMTK_FR_MODE ..................................................................................... 44 Default Configurations.................................................................................................................... 46 CQouneficdteenl tial Appendix A References.................................................................................................................. 47 L80_GPS_Protocol_Specification Confidential / Released 4 / 48 GPS Module Series L80 GPS Protocol Specification Table Index TABLE 1: STRUCTURE OF NMEA MESSAGE .................................................................................................. 7 TABLE 2: STRUCTURE OF MTK NMEA PACKET ........................................................................................... 15 TABLE 3: DEFAULT CONFIGURATIONS ......................................................................................................... 46 TABLE 4: RELATED DOCUMENTS .................................................................................................................. 47 TABLE 5: TERMS AND ABBREVIATIONS ........................................................................................................ 47 CQouneficdteenl tial L80_GPS_Protocol_Specification Confidential / Released 5 / 48 GPS Module Series L80 GPS Protocol Specification 1 Introduction L80 is a full featured GPS module with super sensitivity. It is characteristic of low power consumption and compact size. The module supports autonomous GPS C/A, SBAS (including WAAS and EGNOS) and AGPS (EASYTM) functions. It can be used in positioning, navigation and other fields. Now L80 supports SDK commands which are developed by Quectel. At present the SDK commands contain $PQFLP, $PQBAUD, $PQ1PPS, $PQEPE and so on. For more infomation please refer to document [4]. This document describes the software aspects of L80. L80 supports standard NMEA 0183 commands, CQouneficdteenl tial and also can be controlled and configured via MTK NMEA extended packet. L80_GPS_Protocol_Specification Confidential / Released 6 / 48 GPS Module Series L80 GPS Protocol Specification 2 Standard NMEA Packet Protocols L80 supports standard NMEA 0183 messages, and the following table shows the structure of these messages. Table 1: Structure of NMEA Message Filed Length (Bytes) $ 1 l Talker ID 1~2 te NMEA Message ID uec tial DataField 3 Variable with the NMEA message type * 1 Q n Checksum 2 e 2 Description Each NMEA message starts with ‘$’ ‘GP’ for a GPS receiver NMEA message ID Data fields, delimited by comma ‘,’ End character of data field A hexadecimal number calculated by exclusive OR of all characters between ‘$’ and ‘*’ Each NMEA message ends with ‘CR’ and ‘LF’ fid NOTE n The default output message of L80 has the following seven sentences: RMC, VTG, GGA, GSA, GSV, GLL Co and GPTXT. 2.1. GPRMC RMC–Recommended Minimum Position Data (including position, velocity and time). Example: $GPRMC,013732.000,A,3150.7238,N,11711.7278,E,0.00,0.00,220413,,,A*68 Field Description L80_GPS_Protocol_Specification Confidential / Released 7 / 48 GPS Module Series L80 GPS Protocol Specification $ Each NMEA message starts with ‘$’ GPRMC Message ID UTC Time Time in format ‘hhmmss.sss’ Data Valid ‘V’=Invalid ‘A’=Valid Latitude Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North N/S ‘S’=South Longitude Longitude in format ‘dddmm.mmmm’ (degrees and minutes) E/W Speed l COG te Date c l Magnetic Variation ue tia E/W Q n Positioning Mode e * fid Checksum Con ‘E’=East ‘W’=West Speed over ground in knots Course over ground in degree Date in format ‘ddmmyy’ Magnetic variation in degree, not being output Magnetic variation E/W indicator, not being output ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 2.2. GPVTG VTG–Track Made Good and Ground Speed. Example: $GPVTG,0.0,T,,M,0.0,N,0.1,K,A*0C Field Description $ Each NMEA message starts with ‘$’ L80_GPS_Protocol_Specification Confidential / Released 8 / 48 GPS Module Series L80 GPS Protocol Specification GPVTG Message ID COG (T) Course over ground (true) in degree T Fixed field, true COG (M) Course over ground (magnetic), not being output M Fixed field, magnetic Speed Speed over ground in knots N Fixed field, knots Speed Speed over ground in km/h K l Positioning Mode te * c l Checksum ue tia Fixed field, km/h ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Q en 2.3. GPGGA fid GGA–Global Positioning System Fix Data, is the essential fix data which provides 3D location and accuracy data. n Example: o $GPGGA,074244.000,3150.7827,N,11711.9302,E,1,4,2.13,49.0,M,0.0,M,,*56 C Field Description $ Each NMEA message starts with ‘$’ GPGGA Message ID UTC Time Time in format ‘hhmmss.sss’ Latitude N/S Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North ‘S’=South L80_GPS_Protocol_Specification Confidential / Released 9 / 48 GPS Module Series L80 GPS Protocol Specification Longitude E/W Fix Status Number of SV Longitude in format ‘dddmm.mmmm’ (degrees and minutes) ‘E’=East ‘W’=West ‘0’=Invalid ‘1’=GPS fix ‘2’=DGPS fix Number of satellites being used (0~12) HDOP Horizontal Dilution of Precision Altitude Altitude in meters according to WGS84 ellipsoid M GeoID Separation l M te DGPS Age c l DGPS Station ID ue tia * Checksum Q n Fixed field, meter Height of GeoID (means sea level) above WGS84 ellipsoid, meter Fixed field, meter Age of DGPS data in seconds, empty if DGPS is not used DGPS station ID, empty if DGPS is not used End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ fide 2.4. GPGSA n GSA–GPS DOP and Active Satellites, provides details on the fix, including the number of the satellites Co being used and the DOP. At most the first 12 satellite IDs are output. Example: $GPGSA,A,3,14,06,16,31,23,,,,,,,,1.66,1.42,0.84*0F Field Description $ Each NMEA message starts with ‘$’ GPGSA Mode Message ID Auto selection of 2D or 3D fix ‘M’=Manual, forced to switch 2D/3D mode L80_GPS_Protocol_Specification Confidential / Released 10 / 48 GPS Module Series L80 GPS Protocol Specification ‘A’=Allowed to automatically switch 2D/3D mode Fix Status Satellite Used 1 ‘1’=No fix ‘2’=2D fix ‘3’=3D fix Satellite used on channel 1 Satellite Used 2 Satellite used on channel 2 Satellite Used 3 Satellite used on channel 3 Satellite Used 4 Satellite used on channel 4 Satellite Used 5 Satellite Used 6 Satellite Used 7 l Satellite Used 8 te Satellite Used 9 c l Satellite Used 10 ue tia SatelliteUsed11 Q n Satellite Used 12 e PDOP fid HDOP VDOP n * Co Checksum Satellite used on channel 5 Satellite used on channel 6 Satellite used on channel 7 Satellite used on channel 8 Satellite used on channel 9 Satellite used on channel 10 Satellite used on channel 11 Satellite used on channel 12 Position Dilution of Precision Horizontal Dilution of Precision Vertical Dilution of Precision End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 2.5. GPGSV GSV–GPS Satellites in View. One GSV sentence can only provide data for at most 4 satellites, so several sentences might be required for the full information. Since GSV includes satellites that are not used as part of the solution, GSV sentence contains more satellites than GGA does. L80_GPS_Protocol_Specification Confidential / Released 11 / 48 GPS Module Series L80 GPS Protocol Specification Example: $GPGSV,3,1,12,01,05,060,18,02,17,259,43,04,56,287,28,09,08,277,28*77 $GPGSV,3,2,12,10,34,195,46,13,08,125,45,17,67,014,,20,32,048,24*74 $GPGSV,3,3,12,23,13,094,48,24,04,292,24,28,49,178,46,32,06,037,22*7D Field Description $ Each NMEA message starts with ‘$’ GPGSV Message ID Number of Message Number of messages, total number of GPGSV messages being output (1~3) Sequence Number Sequence number of this entry (1~3) Satellites in View Satellite ID 1 l Elevation 1 te Azimuth 1 c l SNR1 ue tia SatelliteID2 Elevation 2 Q n Azimuth 2 e SNR 2 fid Satellite ID 3 Elevation 3 n Azimuth 3 Co SNR 3 Total satellites in view Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to Noise Ration in dBHz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to Noise Ration in dBHz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to Noise Ration in dBHz (0~99), empty if not tracking Satellite ID 4 Satellite ID Elevation 4 Elevation in degree (0~90) Azimuth 4 Azimuth in degree (0~359) SNR 4 Signal to Noise Ration in dBHz (0~99), empty if not tracking * End character of data field Checksum Hexadecimal checksum L80_GPS_Protocol_Specification Confidential / Released 12 / 48 GPS Module Series L80 GPS Protocol Specification Each NMEA message ends with ‘CR’ and ‘LF’ 2.6. GPGLL GLL–Geographic Latitude and Longitude, contains position information, time of position fix and status. Example: $GPGLL,3110.2908,N,12123.2348,E,041139.000,A,A*59 Field Description $ GPGLL l Latitude te N/S c l Longitude ue tia E/W Q n UTCTime e Data Valid fid Positioning Mode n * Co Checksum Each NMEA message starts with ‘$’ Message ID Latitude in format ‘ddmm.mmmm’ (degrees and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmm’ (degrees and minutes) ‘E’=East ‘W’=West Time in format ‘hhmmss.sss’ ‘V’=Invalid ‘A’=Valid ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 2.7. GPTXT This message is used to ouput information. This sentence is output by default. You can use the SDK command $PQTXT to permanently modify and L80_GPS_Protocol_Specification Confidential / Released 13 / 48 GPS Module Series L80 GPS Protocol Specification save. For details please refer to document [4]. Example: $GPTXT,01,01,02,ANTSTATUS=OK*3B Field Description $ Each NMEA message starts with ‘$’ GPTXT Message ID XX Total number of messages in this transmission. (01~99) YY Message number in this transmission. (01~99) ZZ tel Text Message c l * ue tia Checksum Severity of the message ‘00’=ERROR ‘01’=WARNING ‘02’=NOTICE ‘07’=USER Output information End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Q en NOTES fid L80 module supports antomatic antenna switch. The GPTXT sentence can be used to identify the status of external active antenna, which is listed as below: 1. If ANTSTATUS=OK, it means the external active antenna is connected and will be used by the n module. o 2. If ANTSTATUS=OPEN, it means the open-circuit state is dectected and the internal antenna will be used by the module. C 3. If ANTSTATUS=SHORT, it means short circuit is dectected and the internal antenna will be used. L80_GPS_Protocol_Specification Confidential / Released 14 / 48 GPS Module Series L80 GPS Protocol Specification 3 MTK NMEA Packet Protocols This chapter introduces the MTK NMEA packet protocol, which is a set of extension messages of the standard NMEA packet protocol. These messages are used to control and configure L80 GPS module. The following table shows the structure of a MTK NMEA packet. Table 2: Structure of MTK NMEA Packet Filed $ tel Talker ID Length (Bytes) 1 1 Description Each NMEA message starts with ‘$’ ‘P’ for proprietary message NMEA Data type uec tial DataFiled Packet type Packet data Q n * e Checksum fid 3 Always ‘MTK’ to indicate MTK proprietary message 3 Packet type, from ‘000’ to ‘999’ Variable, depends Data fields, delimited by comma ‘,’ on the packet type 1 End character of data field A hexadecimal number calculated by exclusive OR of 2 all characters between ‘$’ and ‘*’ 2 Each NMEA message ends with ‘CR’ and ‘LF’ Con 3.1. Packet Type: 010 PMTK_SYS_MSG This message is used to automatically output system messages by GPS module. Data Field: None Example: $PMTK010,001*2E Field Description L80_GPS_Protocol_Specification Confidential / Released 15 / 48 GPS Module Series L80 GPS Protocol Specification $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Message * 010 System message ‘0’=Unknown ‘1’=Startup ‘2’=Notification for the host aiding EPO ‘3’=Notification for the transition to normal mode is successfully done End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ tel 3.2. Packet Type: 011 PMTK_TXT_MSG c l This message is used to automatically output system messages through GPS module. ue tia DataField: None Q n Example: e $PMTK011,MTKGPS*08 Field Description fid $ Each NMEA message starts with ‘$’ n PMTK MTK proprietary message o Packet Type 011 C Message MTKGPS * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ L80_GPS_Protocol_Specification Confidential / Released 16 / 48 GPS Module Series L80 GPS Protocol Specification 3.3. Packet Type: 001 PMTK_ACK Acknowledgement of PMTK command. In order to inform the sender whether the receiver has received the packet, an acknowledge packet PMTK_ACK should be returned after the receiver receives a packet. Some commands will cause the GPS module to restart or change the baud rate. There is no PMTK_ACK for those commands as listed below. PMTK_CMD_HOT_START PMTK_CMD_WARM_START PMTK_CMD_COLD_START PMTK_CMD_FULL_COLD_START PMTK_SET_NMEA_BAUDRATE Data Field: l $PMTK001,Cmd,Flag Example: te $PMTK001,869,3*37 c l Field Description ue tia $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Q n Packet Type 001 e Command fid Flag on * The packet type that the acknowledgement responds ‘0’=Invalid packet ‘1’=Unsupported packet type ‘2’=Valid packet, but action failed ‘3’=Valid packet, action succeeded End character of data field C Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.4. Packet Type: 101 PMTK_CMD_HOT_START This message is used to achieve hot start the GPS module (use all available data in the NV store). Normally hot start means the GPS module was powered down for less than 3 hours (RTC must be alive) L80_GPS_Protocol_Specification Confidential / Released 17 / 48 GPS Module Series L80 GPS Protocol Specification and its ephemeris is still valid. As there is no need for downloading ephemeris, it is the fastest startup method. Data Field: None Example: $PMTK101*32 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type * l Checksum te 101 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ uec tial 3.5. Packet Type: 102 PMTK_CMD_WARM_START Q n This message is used to achieve warm start the GPS module. Warm start means the GPS module has approximate information of time, position and coarse data on satellite positions. But it needs to download e ephemeris until it can get a fix. Using this message will force the GPS warm restarted without using the fid ephemeris data in NV. Data Field: n None Example: o $PMTK102*31 C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 102 * End character of data field Checksum Hexadecimal checksum L80_GPS_Protocol_Specification Confidential / Released 18 / 48 GPS Module Series L80 GPS Protocol Specification Each NMEA message ends with ‘CR’ and ‘LF’ 3.6. Packet Type: 103 PMTK_CMD_COLD_START This message is used to cold start the GPS module. Using this message will force the GPS cold restarted without using any prior location information, including time, position, almanacs and ephemeris data. Data Field: None Example: $PMTK103*30 Field Description l $ Each NMEA message starts with ‘$’ te PMTK MTK proprietary message c l Packet Type 103 ue tia * End character of data field Checksum Hexadecimal checksum Q n Each NMEA message ends with ‘CR’ and ‘LF’ fide 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START n This message is essentially a cold restart, but additionally clear system and user configurations at re-start. o That is, reset the GPS module to the factory status. Full cold start means the GPS module has no C information on last location. It needs to search the full time and frequency space, and also all possible satellite numbers before it can get a fix. Data Field: None Example: $PMTK104*37 Field Description $ Each NMEA message starts with ‘$’ L80_GPS_Protocol_Specification Confidential / Released 19 / 48 PMTK Packet Type * Checksum GPS Module Series L80 GPS Protocol Specification MTK proprietary message 104 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE This message is used to enter standby mode for power saving. l Data Field: $PMTK161,Type te Example: $PMTK161,0*28 c l Response: ue tia $PMTK001,161,3*36 Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type 161 Type ‘0’=Stop mode n * End character of data field Co Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.9. Packet Type: 183 PMTK_LOCUS_QUERY_STATUS This message is used to query LOCUS logging status. L80_GPS_Protocol_Specification Confidential / Released 20 / 48 GPS Module Series L80 GPS Protocol Specification Data Field: None Example: $PMTK183*38 Response: $PMTK001,183,3*3A Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 183 * Checksum l End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ te Return: uec tial Example: $PMTKLOG,456,0,11,31,2,0,0,0,3769,46*48 Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type LOG n Serial# Logging serial number: 0~65535 o Type Logging type–0: Overlap, 1: Fullstop C Mode Logging mode–0 x 08: Interval logger Content Logging contents of configuration Interval Logging interval setting (valid when interval mode is selected) Distance Logging distance setting (valid when distance mode is selected) Speed Logging speed setting (valid when speed mode is selected) Status Logging status–1: Stop logging, 0: Logging L80_GPS_Protocol_Specification Confidential / Released 21 / 48 Number Percent * Checksum GPS Module Series L80 GPS Protocol Specification Logging number of data record Logging life used percentage (0%~100%) End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.10. Packet Type: 184 PMTK_LOCUS_ERASE_FLASH This message is used to erase logger flash. l Data Field: $PMTK184,Type te Example: $PMTK184,1*22 c l Response: ue tia $PMTK001,184,3*3D Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type 184 Type ‘1’=Erase all logger internal flash data n * End character of data field Co Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.11. Packet Type: 185 PMTK_LOCUS_STOP_LOGGER This message is used to stop or start logging data. L80_GPS_Protocol_Specification Confidential / Released 22 / 48 GPS Module Series L80 GPS Protocol Specification Data Field: $PMTK185,Stutas Example: $PMTK185,1*23 Response: $PMTK001,185,3*3C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 185 Status * l Checksum te ‘0’=Start logging ‘1’=Stop logging End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ uec tial 3.12. Packet Type: 622 PMTK_Q_LOCUS_DATA Q n This message is used to dump locus flash data. fide Data Field: $PMTK622,Type Example: n $PMTK622,1*29 Response: o $PMTK001,622,3*36 C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 622 Type ‘1’=Dump partial in used flash data * End character of data field L80_GPS_Protocol_Specification Confidential / Released 23 / 48 Checksum GPS Module Series L80 GPS Protocol Specification Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.13. Packet Type: 220 PMTK_SET_POS_FIX This message is used to set position fix interval. Data Field: $PMTK220, Interval Example: $PMTK220,1000*1F Response: $PMTK001,220,3*30 l Field Description te $ Each NMEA message starts with ‘$’ c l PMTK MTK proprietary message ue tia PacketType 220 Q n Interval Position fix interval [msec]. [Range: 100~10000] e * End character of data field fid Checksum Hexadecimal checksum Con Each NMEA message ends with ‘CR’ and ‘LF’ 3.14. Packet Type: 223 PMTK_SET_AL_DEE_CFG This message is used to config DEE. Data Field: $PMTK223,SV,SNR,Extension threshold,Extension gap Example: $PMTK223,1,30,180000,60000*3C L80_GPS_Protocol_Specification Confidential / Released 24 / 48 GPS Module Series L80 GPS Protocol Specification Response: $PMTK001,223,3*33 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 223 SV Range: 1~4 (Default value: 1) SNR Range: 25~30 (Default value: 30) Extension Threshold Extension Gap l * te Checksum c l Range: 40000~180000 (Default value: 180000) Range: 0~3600000 (Default value: 60000) End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Que ntia 3.15. Packet Type: 225 PMTK_SET_PERIODIC_MODE e This message is used to enter periodic mode for power saving. fid Data Field: $PMTK225,Type,Run time,Sleep time,Second run time,Second sleep time n Example: $PMTK225,8*23 o Response: C $PMTK001,225,3*35 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Type 225 ‘0’=Back to normal mode ‘1’=Periodic Backup mode ‘2’=Periodic Standby mode L80_GPS_Protocol_Specification Confidential / Released 25 / 48 GPS Module Series L80 GPS Protocol Specification Run Time Sleep Time Second Run Time Second Sleep Time ‘4’=Perpetual Backup mode ‘8’=AlwaysLocate Standby mode ‘9’=AlwaysLocate Backup mode ‘0’: Disable >=’1000’: Enable (Range: 1000~518400000) (Range: 1000~518400000) ‘0’: Disable >=‘1000’: Enable (Range: 1000~518400000) (Range: 1000~518400000) * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ tel NOTE c l The unit of run time or sleep time is msec, the second run time should be larger than first run time for non-zero value. Que ntia 3.16. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE e This message is used to set NMEA port baud rate. Using PMTK251 command to setup baud rate setting, fid the setting will be back to default value in the condition: Full cold start command is issued. You can use the SDK command $PQBAUD to permanently modify and save baud rate. For details please n refer to document [4]. o Data Field: C $PMTK251,Baudrate Example: $PMTK251,115200*1F Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 251 L80_GPS_Protocol_Specification Confidential / Released 26 / 48 GPS Module Series L80 GPS Protocol Specification Baud Rate * Baud rate setting: 9600–default setting 4800 9600 14400 19200 38400 57600 115200 End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ l 3.17. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA cte l This message is used to enable or disable fix NMEA output time behind PPS function. (Default off) ue tia DataField: $PMTK255,Enable Example: Q n $PMTK255,0*2C Response: e $PMTK001,255,3*32 fid Field Description $ Each NMEA message starts with ‘$’ n PMTK MTK proprietary message Co Packet Type 255 Enable ‘0’=Disable ‘1’=Enable * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ L80_GPS_Protocol_Specification Confidential / Released 27 / 48 GPS Module Series L80 GPS Protocol Specification 3.18. Packet Type: 262 PMTK_SET_FLP_MODE This message is used to set FLP mode. Fitness low power (FLP) is an optimized solution for wearable, fitness and tracking device. You can use the SDK command $PQFLP to permanently modify and save. For details please refer to document [4]. Data Field: $PMTK262,Mode Example: $PMTK262,1*29 Response: $PMTK001,262,3,1*2B Field Description l $ Each NMEA message starts with ‘$’ te PMTK MTK proprietary message c l Packet Type ue tia Mode Q n * 262 ‘0’=Normal mode ‘1’=FLP mode End character of data field e Checksum Hexadecimal checksum fid Each NMEA message ends with ‘CR’ and ‘LF’ Con 3.19. Packet Type: 285 PMTK_SET_PPS_CONFIG This message is used to set PPS type. You can use the SDK command $PQ1PPS to permanently set and save. For details please refer to document [4]. Data Field: $PMTK285,Type,PPSPulseWidth Example: $PMTK285,4,100*38 L80_GPS_Protocol_Specification Confidential / Released 28 / 48 GPS Module Series L80 GPS Protocol Specification Response: $PMTK001,285,3*3F Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 285 ‘0’=Disable ‘1’=After the first fix Type ‘2’=3D fix only PPSPulseWidth l * te Checksum c l ‘3’=2D/3D fix only ‘4’=Always 2~998 (Unit: ms) End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ ue tia 3.20. Packet Type: 286 PMTK_SET_AIC_ENABLED Q en This message is used to enable or disable AIC function. It is suggested to set cold start command first and fid then PMTK command. Data Field: $PMTK286,Enable n Example: o $PMTK286,0*22 C Response: $PMTK001,286,3*3C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Enable 286 ‘0’=Disable ‘1’=Enable L80_GPS_Protocol_Specification Confidential / Released 29 / 48 * Checksum GPS Module Series L80 GPS Protocol Specification End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.21. Packet Type: 301 PMTK_API_SET_DGPS_MODE This message is used to configure the source mode of DGPS correction data. Data Field: $PMTK301,Mode Example: $PMTK301,2*2E l Response: te $PMTK001,301,3*32 Field Description c l $ Each NMEA message starts with ‘$’ ue tia PMTK MTK proprietary message Q n Packet Type e Mode fid * 301 DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM ‘2’=SBAS (Including WAAS/EGNOS/GAGAN/MSAS) End character of data field n Checksum Hexadecimal checksum Co Each NMEA message ends with ‘CR’ and ‘LF’ 3.22. Packet Type: 313 PMTK_API_SET_SBAS_ENABLED This message is used to enable or disable to search a SBAS satellite. SBAS (Satellite-Based Augmentation Systems) is a system that supports wide-area or regional augmentation through geostationary satellite broadcast messages. The geostationary satellite broadcast GPS integrity and correction data with the assistance of multiple ground stations which are located at accurately-surveyed L80_GPS_Protocol_Specification Confidential / Released 30 / 48 GPS Module Series L80 GPS Protocol Specification points. Data Field: $PMTK313,Enable Example: $PMTK313,1*2E Response: $PMTK001,313,3*31 Field Description $ Each NMEA message starts with ‘$’ PMTK Packet Type Enable tel * Checksum uec tial MTK proprietary message 313 ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Q n 3.23. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT fide This message is used to set NMEA sentence output frequencies. There are totally 19 data fields that present output frequencies for the 19 supported NMEA sentences individually. n Supported Frequency Settings: o 0–Disabled or not supported sentence C 1–Output once every one position fix 2–Output once every two position fixes 3–Output once every three position fixes 4–Output once every four position fixes 5–Output once every five position fixes Data Field: None Example: The module only output RMC once every one position fix. L80_GPS_Protocol_Specification Confidential / Released 31 / 48 GPS Module Series L80 GPS Protocol Specification $PMTK314,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*29 Response: $PMTK001,314,3*36 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 314 0 GLL GLL interval–Geographic Position, Latitude and Longitude 1 RMC 2 VTG 3 GGA 4 GSA 5 GSV 6 Reserved 7 Reserved 8 Reserved 9 Reserved 10 Reserved 11 Reserved 12 Reserved 13 Reserved 14 Reserved RMC interval–Recommended Minimum Specific GPS Sentence VTG interval–Course Over Ground and Ground Speed GGA interval–GPS Fix Data l GSA interval–GPS DOPS and Active Satellites te GSV interval–GPS Satellites in View c l GRS interval–GPS Range Residuals ue tia GST interval–GPS Pseudorange Error Statistics Q n Always 0 e Always 0 fid Always 0 Always 0 nAlways 0 CoAlways 0 Always 0 15 Reserved Always 0 16 Reserved Always 0 17 ZDA ZDA interval–Time and Date 18 Reserved PMTKCHN interval–GPS Channel Status L80_GPS_Protocol_Specification Confidential / Released 32 / 48 GPS Module Series L80 GPS Protocol Specification * Checksum End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ To restore the system default setting, use below message: Example: $PMTK314,-1*04 Field Description $ PMTK l Packet Type te Restore c l * ue tia Checksum Each NMEA message starts with ‘$’ MTK proprietary message 314 Always -1 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Q en 3.24. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA fid The receiver support new NMEA format for QZSS. The command allow user enable or disable QZSS n NMEA format. Default is disable QZSS NMEA format. o Data Field: C $PMTK351,Enable Example: $PMTK351,1*28 Response: $PMTK001,351,3*37 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message L80_GPS_Protocol_Specification Confidential / Released 33 / 48 Packet Type QZSS_Enable * Checksum GPS Module Series L80 GPS Protocol Specification 351 ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.25. Packet Type: 352 PMTK_API_SET_STOP_QZSS Since QZSS is regional positioning service. This command is used to enable or disable QZSS function. Default is enable QZSS function. l Data Field: te $PMTK352,Enable c l Example: $PMTK352,0*2A ue tia Response: $PMTK001,352,3*34 Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type n QZSS_Enable Co * 352 ‘0’=Enable ‘1’=Disable End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.26. Packet Type: 356 PMTK_API_SET_HDOP_THRESHOLD This command is to set HDOP threshold. If the HDOP value is larger than this threshold value, the L80_GPS_Protocol_Specification Confidential / Released 34 / 48 GPS Module Series L80 GPS Protocol Specification position will not be fixed. Data Field: $PMTK356, HDOP Threshold Example: $PMTK356,0.9*39 Response: $PMTK356,0.9 Set OK!*5E Field Description $ Each NMEA message starts with ‘$’ PMTK Packet Type HDOP Threshold tel * Checksum uec tial MTK proprietary message 356 ‘0’: Disable this function. Other value: Enable set the HDOP threshold. End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Q n 3.27. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD fide This message is used to set the speed threshold for static navigation. If the actual speed is below the threshold, output position will keep the same and output speed will be zero. If threshold value is set to 0, this function is disabled. n Data Field: o $PMTK386,Speed_threshold C Example: $PMTK386,0.3*3E Response: $PMTK001,386,3*3D Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message L80_GPS_Protocol_Specification Confidential / Released 35 / 48 Packet Type Speed_threshold * Checksum GPS Module Series L80 GPS Protocol Specification 386 0~2m/s End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.28. Packet Type: 400 PMTK_API_Q_FIX_CTL This message is used to query the rate of position fixing activity. l Refer to PMTK_API_SET_FIX_CTL for setting the rate. te Refer to PMTK_DT_FIX_CTL for the result of the query. c l Data Field: ue tia None Example: $PMTK400*36 Q n Field Description e $ Each NMEA message starts with ‘$’ fid PMTK MTK proprietary message Packet Type 400 n * End character of data field Co Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.29. Packet Type: 401 PMTK_API_Q_DGPS_MODE This message is used to query the setting of DGPS mode. Refer to PMTK_API_SET_DGPS_MODE for setting the DGPS mode. L80_GPS_Protocol_Specification Confidential / Released 36 / 48 GPS Module Series L80 GPS Protocol Specification Refer to PMTK_DT_DGPS_MODE for the result of the query. Data Field: None Example: $PMTK401*37 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 401 * Checksum l End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ uecte tial 3.30. Packet Type: 413 PMTK_API_Q_SBAS_ENABLED This message is used to query the setting of SBAS. Q n Refer to PMTK_API_SET_SBAS_ENABLE for SBAS setting. fide Refer to PMTK_DT_SBAS_ENABLED for the result of the query. Data Field: n None Example: o $PMTK413*34 C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 413 * End character of data field Checksum Hexadecimal checksum L80_GPS_Protocol_Specification Confidential / Released 37 / 48 GPS Module Series L80 GPS Protocol Specification Each NMEA message ends with ‘CR’ and ‘LF’ 3.31. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT This message is used to query the current NMEA sentence output frequencies. Refer to PMTK_API_SET_NMEA_OUTPUT for the frequencies setting. Refer to PMTK_DT_NMEA_OUTPUT for the result of the query. Data Field: None Example: l $PMTK414*33 te Field Description $ Each NMEA message starts with ‘$’ uec tial PMTK MTK proprietary message Packet Type 414 Q n * End character of data field e Checksum Hexadecimal checksum fid Each NMEA message ends with ‘CR’ and ‘LF’ Con 3.32. Packet Type: 605 PMTK_Q_RELEASE This message is used to query the firmware release information. Refer to PMTK_DT_RELEASE for the result of the query. Data Field: None Example: $PMTK605*31 Field Description L80_GPS_Protocol_Specification Confidential / Released 38 / 48 $ PMTK Packet Type * Checksum GPS Module Series L80 GPS Protocol Specification Each NMEA message starts with ‘$’ MTK proprietary message 605 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.33. Packet Type: 500 PMTK_DT_FIX_CTL This message is the response to PMTK_API_Q_FIX_CTL. tel Data Field: $PMTK500,Fix interval c l Example: $PMTK500,1000,0,0,0,0*1A ue tia Field Description $ Each NMEA message starts with ‘$’ Q n PMTK MTK proprietary message fide Packet Type 500 Fix Interval Position fix interval [msec]. [Range: 100~10000] n Reserved Always 0 o Reserved Always 0 C Reserved Always 0 Reserved Always 0 * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ L80_GPS_Protocol_Specification Confidential / Released 39 / 48 GPS Module Series L80 GPS Protocol Specification 3.34. Packet Type: 501 PMTK_DT_DGPS_MODE This message is the response to PMTK_API_Q_DGPS_MODE. Data Field: $PMTK501,Mode Example: $PMTK501,1*2B Field Description $ Each NMEA message starts with ‘$’ PMTK Packet Type tel Mode c l * ue tia Checksum MTK proprietary message 501 DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM ‘2’=SBAS End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ Q fiden 3.35. Packet Type: 513 PMTK_DT_SBAS_ENABLED n This message is the response to PMTK_API_Q_SBAS_ENABLED. o Data Field: C $PMTK513,Enable Example: $PMTK513,1*28 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 513 L80_GPS_Protocol_Specification Confidential / Released 40 / 48 Enable * Checksum GPS Module Series L80 GPS Protocol Specification ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.36. Packet Type: 514 PMTK_DT_NMEA_OUTPUT This message is the response to PMTK_API_Q_NMEA_OUTPUT. Data Field: None l Example: te $PMTK514,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0*2E Field Description c l $ Each NMEA message starts with ‘$’ ue tia PMTK MTK proprietary message Q n Packet Type 514 e 0 GLL GLL interval–Geographic Position, Latitude and Longitude fid 1 RMC RMC interval–Recommended Minimum Specific GPS Sentence 2 VTG VTG interval–Course Over Ground and Ground Speed n 3 GGA GGA interval–GPS Fix Data Co 4 GSA GSA interval–GPS DOPS and Active Satellites 5 GSV GSV interval–GPS Satellites in View 6 Reserved GRS interval–GPS Range Residuals 7 Reserved GST interval–GPS Pseudorange Error Statistics 8 Reserved 9 Reserved L80_GPS_Protocol_Specification Confidential / Released 41 / 48 GPS Module Series L80 GPS Protocol Specification 10 Reserved 11 Reserved 12 Reserved 13 Reserved 14 Reserved 15 Reserved 16 Reserved 17 ZDA 18 Reserved l * te Checksum c l ZDA interval–Time and Date Always 0 End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ ue tia 3.37. Packet Type: 705 PMTK_DT_RELEASE Q en This message is the response to PMTK_Q_RELEASE. fid Data Field: $PMTK705, Release string, Build ID, Product Model (,SDK Version) Example: n $PMTK705,AXN_2.5_3339_15080600,0004,QUECTEL-L80,1.0*0C o Field Description C $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Release String 705 Firmware release name and version 3318: Mcore_x.x 3329: AXN_x.x 3339: AXN_x.x L80_GPS_Protocol_Specification Confidential / Released 42 / 48 GPS Module Series L80 GPS Protocol Specification Build ID Product Model SDK Version (Optional) * Checksum Build ID set in CoreBuilder for firmware version control Product Model set in CoreBuilder for product identification Showing SDK version if the firmware is used for SDK End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ 3.38. Packet Type: 869 PMTK_EASY_ENABLE l This message is used to enable or disable EASY function, and it also can be used to query if EASY is enabled or disabled. te Data Field: c l $PMTK869,CmdType[,Enabled] ue tia Example: $PMTK869,1,1*35 Response: Q n $PMTK001,869,3*37 Field Description e $ Each NMEA message starts with ‘$’ fid PMTK MTK proprietary message n Packet Type Co CmdType 869 ‘0’=Query ‘1’=Set ‘2’=Result for Query operation Enabled ‘0’=Disable ‘1’=Enable * End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ L80_GPS_Protocol_Specification Confidential / Released 43 / 48 GPS Module Series L80 GPS Protocol Specification 3.39. Packet Type: 875 PMTK_PMTKLSC_STN_OUTPUT This message is used to enable or disable PMTKLSC Sentence ouput. And it also can be used to query if PMTKLSC Sentence ouput enabled or disabled. Data Field: $PMTK875,CmdType[,Enabled] Example: $PMTK875,1,1*38: Enable PMTKLSC Sentence output Response: $PMTKLSC,Parameter1,Parameter2,Parameter3*CS Where Parameter1: current leap second Parameter2: leap indicator, 1 means updated from broadcast data Parameter3: next leap second Field Description l $ Each NMEA message starts with ‘$’ te PMTK MTK proprietary message c l Packet Type ue tia CmdType Q n Enabled fide * 875 ‘0’=Query ‘1’=Set ‘2’=Result for Query operation ‘0’=Disable ‘1’=Enable End character of data field Checksum Hexadecimal checksum Con Each NMEA message ends with ‘CR’ and ‘LF’ 3.40. Packet Type: 886 PMTK_FR_MODE This message is used to set navigation mode. Data Field: $PMTK886,CmdType Example: $PMTK886,3*2B L80_GPS_Protocol_Specification Confidential / Released 44 / 48 GPS Module Series L80 GPS Protocol Specification Response: $PMTK001,886,3*36 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 886 CmdType * Checksum ‘0’=Normal mode: For general purpose ‘1’=Fitness mode: For running and walking purpose that the low-speed (<5m/s) movement will have more effect on the position calculation. ‘2’=Aviation mode: For high-dynamic purpose that the large-acceleration movement will have more effect on the position calculation. ‘3’=Balloon mode: For high-altitude balloon purpose that the vertical movement will have more effect on the position calculation. l End character of data field te Hexadecimal checksum CQouneficdential Each NMEA message ends with ‘CR’ and ‘LF’ L80_GPS_Protocol_Specification Confidential / Released 45 / 48 GPS Module Series L80 GPS Protocol Specification 4 Default Configurations Table 3: Default Configurations Item Default NMEA Port Baud Rate Datum Rate of Position Fixing l DGPS Mode te SBAS c l NMEA Output Messages ue tia AIC CQonfiden EASYTM 9600bps WGS84 1Hz SBAS Enabled RMC, VTG, GGA, GSA, GSV, GLL and GPTXT On On L80_GPS_Protocol_Specification Confidential / Released 46 / 48 GPS Module Series L80 GPS Protocol Specification 5 Appendix A References Table 4: Related Documents SN Document Name Remark [1] Quectel_L80_Hardware_Design L80 Hardware Design [2] Quectel_L80_EVB_User Guide L80 EVB User Guide [3] Quectel_L80_Reference_Design L80 Reference Design l [4] Quectel_GNSS_SDK_Commands_Manual GNSS SDK Commands Manual cte l Table 5: Terms and Abbreviations ue tia Abbreviation Description AGPS Q n AIC Assisted Global Positioning System Active Interference Cancellation e DGPS Differential Global Positioning System fid EASY n GGA Embedded Assist System NMEA: Global Positioning System Fix Data o GLL C GPS NMEA: Geographic Latitude and Longitude Global Navigation Satellite System GSA NMEA: GPS DOP and Active Satellites GSV HDOP NMEA: GPS Satellites in View Horizontal Dilution of Precision NMEA National Marine Electronics Association PDOP Position Dilution of Precision L80_GPS_Protocol_Specification Confidential / Released 47 / 48 GPS Module Series L80 GPS Protocol Specification PMTK Private Protocol of MTK PPS Pulse Per Second RMC NMEA: Recommended Minimum Position Data SBAS Satellite-Based Augmentation System UTC Universal Time Coordinated VDOP Vertical Dilution of Precision VTG NMEA: Track Made Good and Ground Speed WAAS CQouneficdteenl tial WideAreaAugmentationSystem L80_GPS_Protocol_Specification Confidential / Released 48 / 48

L70 GPS Protocol Specification GPS Module Series Rev. L70_GPS_Protocol_Specification_V2.5 Date: 2015-12-03 www.quectel.com GPS Module Series L70 GPS Protocol Specification Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. THE INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. L70_GPS_Protocol_Specification Confidential / Released 1 / 47 GPS Module Series L70 GPS Protocol Specification About the Document History Revision 1.0 1.1 2.0 2.1 2.2 2.3 2.4 2.5 Date 2012-07-09 l 2013-03-21 te 2013-05-20 c l 2013-09-25 ue tia 2014-08-19 Q n 2015-08-21 fide 2015-09-11 Con 2015-12-03 Author Ada LI Dishon ZHOU Ada LI Ada LI Ada LI Connie ZHOU Connie ZHOU Connie ZHOU Description Initial 1. Deleted the description of RTCM. 2. Added LOCUS of packet type 183, 184, 185 and 622. 3. Deleted packet type 120. Modified type 225. 1. Modified the description of RMC. 2. Modified the example of packet type 314 and 514. 1. Modified the description of GGA. 2. Added packet type 220 and 223. 1. Modified the description of packet type 251. 2. Modified the example of packet type 386. 3. Added packet type 351, 352, 262, 285 and 875. Added packet type 886. Added packet type 255. L70_GPS_Protocol_Specification Confidential / Released 2 / 47 GPS Module Series L70 GPS Protocol Specification Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 2 Standard NMEA Packet Protocol ....................................................................................................... 7 2.1. GPRMC...................................................................................................................................... 7 2.2. GPVTG ...................................................................................................................................... 8 2.3. GPGGA...................................................................................................................................... 9 3 2.4. GPGSA .................................................................................................................................... 10 2.5. GPGSV .................................................................................................................................... 12 2.6. GPGLL ..................................................................................................................................... 13 MTK NMEA Packet Protocol ............................................................................................................. 14 l 3.1. Packet Type: 010 PMTK_SYS_MSG ...................................................................................... 14 te 3.2. Packet Type: 011 PMTK_TXT_MSG ....................................................................................... 15 3.3. Packet Type: 001 PMTK_ACK ................................................................................................ 16 c l 3.4. Packet Type: 101 PMTK_CMD_HOT_START ........................................................................ 16 3.5. Packet Type: 102 PMTK_CMD_WARM_START .................................................................... 17 ue tia 3.6. Packet Type: 103 PMTK_CMD_COLD_START......................................................................18 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START........................................................... 18 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE................................................................ 19 Q n 3.9. Packet Type: 183 PMTK_LOCUS_QUERY_STATUS ............................................................ 20 3.10. Packet Type: 184 PMTK_LOCUS_ERASE_FLASH ............................................................... 21 e 3.11. Packet Type: 185 PMTK_LOCUS_STOP_LOGGER.............................................................. 22 fid 3.12. Packet Type: 622 PMTK_Q_LOCUS_DATA ........................................................................... 22 3.13. Packet Type: 220 PMTK_SET_POS_FIX ............................................................................... 23 3.14. Packet Type: 223 PMTK_SET_AL_DEE_CFG ....................................................................... 24 n 3.15. Packet Type: 225 PMTK_SET_PERIODIC_MODE ................................................................ 24 3.16. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE............................................................... 25 o 3.17. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA............................................................... 26 C 3.18. Packet Type: 262 PMTK_SET_FLP_MODE ........................................................................... 27 3.19. Packet Type: 285 PMTK_SET_PPS_CONFIG ....................................................................... 28 3.20. Packet Type: 286 PMTK_SET_AIC_ENABLED...................................................................... 28 3.21. Packet Type: 301 PMTK_API_SET_DGPS_MODE ............................................................... 29 3.22. Packet Type: 313 PMTK_API_SET_SBAS_ENABLED .......................................................... 30 3.23. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT ........................................................... 30 3.24. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA............................................. 32 3.25. Packet Type: 352 PMTK_API_SET_STOP_QZSS ................................................................. 33 3.26. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD........................................................ 34 3.27. Packet Type: 400 PMTK_API_Q_FIX_CTL ............................................................................ 34 3.28. Packet Type: 401 PMTK_API_Q_DGPS_MODE.................................................................... 35 L70_GPS_Protocol_Specification Confidential / Released 3 / 47 GPS Module Series L70 GPS Protocol Specification 3.29. 3.30. 3.31. 3.32. 3.33. 3.34. 3.35. 3.36. 3.37. 3.38. 3.39. Packet Type: 413 PMTK_API_Q_SBAS_ENABLED .............................................................. 36 Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT ............................................................... 36 Packet Type: 605 PMTK_Q_RELEASE .................................................................................. 37 Packet Type: 500 PMTK_DT_FIX_CTL .................................................................................. 37 Packet Type: 501 PMTK_DT_DGPS_MODE.......................................................................... 38 Packet Type: 513 PMTK_DT_SBAS_ENABLED .................................................................... 39 Packet Type: 514 PMTK_DT_NMEA_OUTPUT ..................................................................... 39 Packet Type: 705 PMTK_DT_RELEASE ................................................................................ 41 Packet Type: 869 PMTK_EASY_ENABLE.............................................................................. 42 Packet Type: 875 PMTK_PMTKLSC_STN_OUTPUT ............................................................ 42 Packet Type: 886 PMTK_FR_MODE ...................................................................................... 43 4 Appendix A Reference....................................................................................................................... 45 CQouneficdteenl tial 5 Default Configurations......................................................................................................................47 L70_GPS_Protocol_Specification Confidential / Released 4 / 47 GPS Module Series L70 GPS Protocol Specification Table Index TABLE 1: STRUCTURE OF NMEA MESSAGE .................................................................................................. 7 TABLE 2: STRUCTURE OF MTK NMEA PACKET ........................................................................................... 14 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 45 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 45 TABLE 5: DEFAULT CONFIGURATIONS ......................................................................................................... 47 CQouneficdteenl tial L70_GPS_Protocol_Specification Confidential / Released 5 / 47 GPS Module Series L70 GPS Protocol Specification 1 Introduction L70 is a full featured GPS module with super sensitivity. It is characteristic of low power consumption and compact size. The module supports autonomous GPS C/A, SBAS function (including WAAS and EGNOS) and AGPS (EASY function). It can be used in the positioning, navigation and other industries. Now L70 supports SDK commands which are developed by Quectel. At present the SDK commands contain $PQFLP, $PQBAUD, $PQ1PPS, $PQEPE and so on. For more infomations please refer to Quectel_GNSS_SDK_Commands_Manual. This document describes the software aspects of L70. L70 supports NMEA 0183 standard commands. CQouneficdteenl tial MTK NMEA extended packet is supported to control and configure L70 GPS module. L70_GPS_Protocol_Specification Confidential / Released 6 / 47 GPS Module Series L70 GPS Protocol Specification 2 Standard NMEA Packet Protocol L70 supports NMEA 0183 standard messages. The following table shows the structure of a NMEA 0183 standard message. Table 1: Structure of NMEA Message Filed Length (Bytes) Description $ 1 Each NMEA message starts with ‘$’ l Talker ID 1~2 ‘GP’ for a GPS receiver. te NMEA Message ID uec tial DataField 3 NMEA message ID Variable, depend on the NMEA Data fields, delimited by comma ‘,’ message type * 1 End character of data field Q n Checksum 2 A hexadecimal number calculated by exclusive OR of all characters between ‘$’ and ‘*’ e 2 Each NMEA message ends with ‘CR’ and ‘LF’ fid NOTE n The default output message of L70 has the following six sentences: RMC, VTG, GGA, GSA, GSV and Co GLL. 2.1. GPRMC RMC, recommended minimum position data (including position, velocity and time). Example: $GPRMC,013732.000,A,3150.7238,N,11711.7278,E,0.00,0.00,220413,,,A*68 Field Description L70_GPS_Protocol_Specification Confidential / Released 7 / 47 GPS Module Series L70 GPS Protocol Specification $ Each NMEA message starts with ‘$’ GPRMC Message ID UTC Time Time in format ‘hhmmss.sss’ Data Valid ‘V’=Invalid ‘A’=Valid Latitude Latitude in format ‘ddmm.mmmm’ (degree and minutes) ‘N’=North N/S ‘S’=South Longitude Longitude in format ‘dddmm.mmmm’ (degree and minutes) E/W Speed l COG te Date c l Magnetic Variation ue tia E/W Positioning Mode Q en * fid Checksum ‘E’=East ‘W’=West Speed over ground in knots Course over ground in degree Date in format ‘ddmmyy’ Magnetic variation in degree, not being output Magnetic variation E/W indicator, not being output ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each of message Con 2.2. GPVTG VTG, track made good and ground speed. Example: $GPVTG,0.0,T,,M,0.0,N,0.1,K,A*0C Field Description $ Each NMEA message starts with ‘$’ L70_GPS_Protocol_Specification Confidential / Released 8 / 47 GPS Module Series L70 GPS Protocol Specification GPVTG Message ID COG(T) Course over ground (true) in degree T Fixed field, true COG(M) Course over ground (magnetic), not being output M Fixed field, magnetic Speed Speed over ground in knots N Fixed field, knots Speed K l Positioning Mode te * c l Checksum ue tia Speed over ground in km/h Fixed field, km/h ‘N’=No fix ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix End character of data field Hexadecimal checksum Each of message Q en 2.3. GPGGA fid GGA, global positioning system fix data, is the essential fix data which provides 3D location and accuracy data. on Example: C $GPGGA,074244.000,3150.7827,N,11711.9302,E,1,4,2.13,49.0,M,0.0,M,,*56 Field Description $ Each NMEA message starts with ‘$’ GPGGA Message ID UTC Time Time in format ‘hhmmss.sss’ Latitude Latitude in format ‘ddmm.mmmm’ (degree and minutes) L70_GPS_Protocol_Specification Confidential / Released 9 / 47 GPS Module Series L70 GPS Protocol Specification N/S Longitude E/W Fix Status Number of SV ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmm’ (degree and minutes) ‘E’=East ‘W’=West ‘0’=Invalid ‘1’=GPS fix ‘2’=DGPS fix Number of satellites being used (0~12) HDOP Horizontal Dilution Of Precision Altitude M l GeoID Separation te M c l DGPSAge ue tia DGPSStationID * Q n Checksum e Altitude in meters according to WGS84 ellipsoid Fixed field, meter Height of GeoID (mean sea level) above WGS84 ellipsoid, meter Fixed field, meter Age of DGPS data in seconds, empty if DGPS is not used DGPS station ID, empty if DGPS is not used End character of data field Hexadecimal checksum Each of message nfid 2.4. GPGSA Co GSA, GPS DOP and Active Satellites, provides details on the fix, including the numbers of the satellites being used and the DOP. At most the first 12 satellite IDs are output. Example: $GPGSA,A,3,14,06,16,31,23,,,,,,,,1.66,1.42,0.84*0F Field Description $ Each NMEA message starts with ‘$’ GPGSA Message ID L70_GPS_Protocol_Specification Confidential / Released 10 / 47 GPS Module Series L70 GPS Protocol Specification Mode Fix Status Satellite Used 1 Auto selection of 2D or 3D fix ‘M’=Manual, forced to switch 2D/3D mode ‘A’=Allowed to automatically switch 2D/3D mode ‘1’=No fix ‘2’=2D fix ‘3’=3D fix Satellite used on channel 1 Satellite Used 2 Satellite used on channel 2 Satellite Used 3 Satellite used on channel 3 Satellite Used 4 Satellite used on channel 4 Satellite Used 5 Satellite Used 6 l Satellite Used 7 te Satellite Used 8 c l Satellite Used 9 ue tia SatelliteUsed10 Satellite Used 11 Q n Satellite Used 12 fide PDOP HDOP n VDOP o * C Checksum Satellite used on channel 5 Satellite used on channel 6 Satellite used on channel 7 Satellite used on channel 8 Satellite used on channel 9 Satellite used on channel 10 Satellite used on channel 11 Satellite used on channel 12 Position Dilution of Precision Horizontal Dilution of Precision Vertical Dilution of Precision End character of data field Hexadecimal checksum Each of message L70_GPS_Protocol_Specification Confidential / Released 11 / 47 GPS Module Series L70 GPS Protocol Specification 2.5. GPGSV GSV, GPS Satellites in View. One GSV sentence can only provide data for at most 4 satellites, so several sentences might be required for the full information. Since GSV includes satellites that are not used as part of the solution, GSV sentence contains more satellites than GGA does. Example: $GPGSV,3,1,12,01,05,060,18,02,17,259,43,04,56,287,28,09,08,277,28*77 $GPGSV,3,2,12,10,34,195,46,13,08,125,45,17,67,014,,20,32,048,24*74 $GPGSV,3,3,12,23,13,094,48,24,04,292,24,28,49,178,46,32,06,037,22*7D Field Description $ GPGSV l Number of Message te Sequence Number c l Satellites in View ue tia SatelliteID1 Elevation 1 Q n Azimuth 1 e SNR 1 fid Satellite ID 2 Elevation 2 n Azimuth 2 Co SNR 2 Each NMEA message starts with ‘$’ Message ID Number of messages, total number of GPGSV messages being output (1~3) Sequence number of this entry (1~3) Total satellites in view Satellite ID Elevation in degree (00~90) Azimuth in degree (000~359) Signal to Noise Ration in dBHz (00~99), empty if not tracking Satellite ID Elevation in degree (00~90) Azimuth in degree (000~359) Signal to Noise Ration in dBHz (00~99), empty if not tracking Satellite ID 3 Satellite ID Elevation 3 Elevation in degree (00~90) Azimuth 3 Azimuth in degree (000~359) SNR 3 Signal to Noise Ration in dBHz (00~99), empty if not tracking Satellite ID 4 Satellite ID Elevation 4 Elevation in degree (00~90) L70_GPS_Protocol_Specification Confidential / Released 12 / 47 Azimuth 4 SNR 4 * Checksum GPS Module Series L70 GPS Protocol Specification Azimuth in degree (000~359) Signal to Noise Ration in dBHz (00~99), empty if not tracking End character of data field Hexadecimal checksum Each of message 2.6. GPGLL GLL, Geographic Latitude and Longitude, contains position information, time of position fix and status. Example: l $GPGLL,3110.2908,N,12123.2348,E,041139.000,A,A*59 te Field Description c l $ Each NMEA message starts with ‘$’ ue tia GPGLL Message ID Latitude Q n N/S e Longitude fid E/W n UTC Time Co Data Valid Latitude in format ‘ddmm.mmmm’ (degree and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmm’ (degree and minutes) ‘E’=East ‘W’=West Time in format ‘hhmmss.sss’ ‘V’=Invalid ‘A’=Valid ‘N’=No fix Positioning Mode ‘A’=Autonomous GPS fix ‘D’=Differential GPS fix * End character of data field Checksum Hexadecimal checksum Each of message L70_GPS_Protocol_Specification Confidential / Released 13 / 47 GPS Module Series L70 GPS Protocol Specification 3 MTK NMEA Packet Protocol This chapter introduces the MTK NMEA packet protocol, which is a set of extension messages of the standard NMEA packet protocol. These messages are used to control and configure L70 GPS module. The following table shows the structure of a MTK NMEA packet. Table 2: Structure of MTK NMEA Packet Filed $ tel Talker ID NMEA Data type uec tial DataFiled Packet type Packet data Q n * e Checksum fid Length (Bytes) 1 1 3 Description Each NMEA message starts with ‘$’ ‘P’ for proprietary message Always ‘MTK’ to indicate MTK proprietary message 3 Packet type, from ‘000’ to ‘999’ Variable, depend Data fields, delimited by comma ‘,’ on the packet type 1 End character of data field A hexadecimal number calculated by exclusive OR 2 of all characters between ‘$’ and ‘*’ 2 Each NMEA message ends with ‘CR’ and ‘LF’ Con 3.1. Packet Type: 010 PMTK_SYS_MSG This message is used to automatically output system messages by GPS module. Data Field: None Example: $PMTK010,001*2E Field Description L70_GPS_Protocol_Specification Confidential / Released 14 / 47 GPS Module Series L70 GPS Protocol Specification $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type Message * 010 System message ‘0’=Unknown ‘1’=Startup ‘2’=Notification for the host aiding EPO ‘3’=Notification for the transition to normal mode is successfully done End character of data field Checksum Hexadecimal checksum Each of message tel 3.2. Packet Type: 011 PMTK_TXT_MSG c l This message is used to automatically output system messages by GPS module. ue tia DataField: None Q n Example: e $PMTK011,MTKGPS*08 Field Description fid $ Each NMEA message starts with ‘$’ n PMTK MTK proprietary message o Packet Type 011 C Message MTKGPS * End character of data field Checksum Hexadecimal checksum Each of message L70_GPS_Protocol_Specification Confidential / Released 15 / 47 GPS Module Series L70 GPS Protocol Specification 3.3. Packet Type: 001 PMTK_ACK Acknowledgement of PMTK command. In order to inform the sender whether the receiver has received the packet, an acknowledge packet PMTK_ACK should return after the receiver receives a packet. Some commands will cause the GPS module to restart or change the baud rate.There is no PMTK_ACK for those commands as listed below.  PMTK_CMD_HOT_START  PMTK_CMD_WARM_START  PMTK_CMD_COLD_START  PMTK_CMD_FULL_COLD_START  PMTK_SET_NMEA_BAUDRATE Data Field: l $PMTK001,Cmd,Flag Example: te $PMTK001,869,3*37 c l Field Description ue tia $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Q n Packet Type 001 e Command fid Flag on * The packet type that the acknowledge responds ‘0’=Invalid packet ‘1’=Unsupported packet type ‘2’=Valid packet, but action failed ‘3’=Valid packet, action succeeded End character of data field C Checksum Hexadecimal checksum Each of message 3.4. Packet Type: 101 PMTK_CMD_HOT_START This message is used to hot start the GPS module (use all available data in the NV store). Normally hot start means the GPS module was powered down less than 3 hours (RTC must be alive) and its ephemeris L70_GPS_Protocol_Specification Confidential / Released 16 / 47 GPS Module Series L70 GPS Protocol Specification is still valid. As there is no need for downloading ephemeris, it’s the fastest startup method. Data Field: None Example: $PMTK101*32 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 101 * Checksum l End character of data field Hexadecimal checksum Each of message uecte tial 3.5. Packet Type: 102 PMTK_CMD_WARM_START This message is used to warm start the GPS module. Warm start means the GPS module has Q n approximate information of time, position and coarse data on satellite positions. But it needs to download ephemeris until it can get a fix. Using this message will force the GPS warm restarted without using the e ephemeris data in NV. fid Data Field: None n Example: $PMTK102*31 Co Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 102 * End character of data field Checksum Hexadecimal checksum L70_GPS_Protocol_Specification Confidential / Released 17 / 47 Each of message GPS Module Series L70 GPS Protocol Specification 3.6. Packet Type: 103 PMTK_CMD_COLD_START This message is used to cold start the GPS module. Using this message will force the GPS cold restarted without using any prior location information, including time, position, almanacs and ephemeris data. Data Field: None Example: $PMTK103*30 Field Description l $ Each NMEA message starts with ‘$’ te PMTK MTK proprietary message c l Packet Type 103 ue tia * End character of data field Checksum Hexadecimal checksum Q n Each of message fide 3.7. Packet Type: 104 PMTK_CMD_FULL_COLD_START n This message is essentially a cold restart, but additionally clear system and user configurations at re-start. o That is, reset the GPS module to the factory status. Full cold start means the GPS module has no C information on last location. It needs to search the full time and frequency space, and also all possible satellite numbers before it can get a fix. Data Field: None Example: $PMTK104*37 Field Description $ Each NMEA message starts with ‘$’ L70_GPS_Protocol_Specification Confidential / Released 18 / 47 PMTK Packet Type * Checksum MTK proprietary message 104 End character of data field Hexadecimal checksum Each of message GPS Module Series L70 GPS Protocol Specification 3.8. Packet Type: 161 PMTK_CMD_STANDBY_MODE This message is used to enter standby mode for power saving. l Data Field: $PMTK161,Type te Example: $PMTK161,0*28 c l Response: ue tia $PMTK001,161,3*36 Field Description Q n $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message e Packet Type 161 fid Type ‘0’=Stop mode n * End character of data field o Checksum Hexadecimal checksum C Each of message L70_GPS_Protocol_Specification Confidential / Released 19 / 47 GPS Module Series L70 GPS Protocol Specification 3.9. Packet Type: 183 PMTK_LOCUS_QUERY_STATUS This message is used to query LOCUS logging status. Data Field: None Example: $PMTK183*38 Response: $PMTK001,183,3*3A Field Description $ PMTK l Packet Type te * c l Checksum ue tia Each NMEA message starts with ‘$’ MTK proprietary message 183 End character of data field Hexadecimal checksum Each of message Return: Q n Data Field: e $PMTKLOG,Serial#,Type, Mode, Content, Interval, Distance, Speed, Status, Log number, Percent*CH fid Example: $PMTKLOG,456,0,11,31,2,0,0,0,3769,46*48 Field Description n $ Each NMEA message starts with ‘$’ Co PMTK MTK proprietary message Packet Type LOG Serial# Logging serial number: 0~65535 Type Logging type-0: Overlap, 1: Fullstop Mode Logging mode-0x08: Interval logger Content Logging contents of configuration Interval Logging interval setting (valid when interval mode is selected) L70_GPS_Protocol_Specification Confidential / Released 20 / 47 GPS Module Series L70 GPS Protocol Specification Distance Logging distance setting (valid when distance mode is selected) Speed Logging speed setting (valid when speed mode is selected) Status Logging status-1: Stop logging, 0: Logging Number Logging number of data record Percent Logging life used percentage (0%~100%) * End character of data field Checksum Hexadecimal checksum Each of message l 3.10. Packet Type: 184 PMTK_LOCUS_ERASE_FLASH te This message is used to erase logger flash. c l Data Field: ue tia $PMTK184,Type Example: $PMTK184,1*22 Q n Response: $PMTK001,184,3*3D e Field Description fid $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message on Packet Type 184 C Type ‘1’=Erase all logger internal flash data * End character of data field Checksum Hexadecimal checksum Each of message L70_GPS_Protocol_Specification Confidential / Released 21 / 47 GPS Module Series L70 GPS Protocol Specification 3.11. Packet Type: 185 PMTK_LOCUS_STOP_LOGGER This message is used to stop or start logging data. Data Field: $PMTK185,Stutas Example: $PMTK185,1*23 Response: $PMTK001,185,3*3C Field Description $ PMTK l Packet Type te Status c l * ue tia Checksum Each NMEA message starts with ‘$’ MTK proprietary message 185 ‘0’=Start logging ‘1’=Stop logging End character of data field Hexadecimal checksum Each of message Q fiden 3.12. Packet Type: 622 PMTK_Q_LOCUS_DATA n This message is used to dump locus flash data. o Data Field: C $PMTK622,Type Example: $PMTK622,1*29 Response: $PMTK001,622,3*36 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message L70_GPS_Protocol_Specification Confidential / Released 22 / 47 Packet Type Type * Checksum GPS Module Series L70 GPS Protocol Specification 622 ‘1’=dump partial in used flash data End character of data field Hexadecimal checksum Each of message 3.13. Packet Type: 220 PMTK_SET_POS_FIX This message is used to set position fix interval. l Data Field: $PMTK220, Interval te Example: $PMTK220,1000*1F c l Response: ue tia $PMTK001,220,3*30 Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type 220 Interval Position fix interval [msec]. Must be greater than 200. n * End character of data field Co Checksum Hexadecimal checksum Each of message L70_GPS_Protocol_Specification Confidential / Released 23 / 47 GPS Module Series L70 GPS Protocol Specification 3.14. Packet Type: 223 PMTK_SET_AL_DEE_CFG This message is used to configure DEE. Data Field: $PMTK223,SV,SNR,Extension threshold,Extension gap Example: $PMTK223,1,30,180000,60000*3C Response: $PMTK001,223,3*33 Field $ l PMTK te Packet Type c l SV ue tia SNR Extension Threshold Q n Extension Gap e * fid Checksum Description Each NMEA message starts with ‘$’ MTK proprietary message 223 Range: 1~4 (Default value: 1) Range: 25~30 (Default value: 30) Range: 40000~180000 (Default value: 180000) Range: 0~3600000 (Default value: 60000) End character of data field Hexadecimal checksum Each of message Con 3.15. Packet Type: 225 PMTK_SET_PERIODIC_MODE This message is used to enter periodic mode for power saving. Data Field: $PMTK225,Type,Run time,Sleep time,Second run time,Second sleep time Example: $PMTK225,8*23 Response: $PMTK001,225,3*35 L70_GPS_Protocol_Specification Confidential / Released 24 / 47 GPS Module Series L70 GPS Protocol Specification Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 225 ‘0’=Back to normal mode ‘1’=Periodic Backup mode Type ‘2’=Periodic Standby mode ‘4’=Perpetual Backup mode ‘8’=AlwaysLocate Standby mode Run Time Sleep Time l Second Run Time cte l Second SleepTime ue tia * Checksum Q n ‘9’=AlwaysLocate Backup mode ‘0’: Disable >=’1000’: Enable (Range: 1000~518400000) (Range:1000~518400000) ‘0’: Disable >=’1000’: Enable (Range: 1000~518400000) (Range: 0 or 1000~518400000) End character of data field Hexadecimal checksum Each of message fide NOTE The unit of run time or sleep time is msec, the second run time should be larger than the first run time for non-zero value. Con 3.16. Packet Type: 251 PMTK_SET_NMEA_BAUDRATE This message is used to set NMEA port baud rate. Using PMTK251 command to setup baud rate setting, the setting will be back to default value when the full cold start command is issued. You can use the SDK command $PQBAUD to permanently modify and save baud rate. For details please refer to Quectel_GNSS_SDK_Commands_Manual. L70_GPS_Protocol_Specification Confidential / Released 25 / 47 GPS Module Series L70 GPS Protocol Specification Data Field: $PMTK251,Baudrate Example: $PMTK251,115200*1F Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 251 Baud rate setting: Baud Rate ctel l * ue tia Checksum 4800 9600 - default setting 14400 19200 38400 57600 115200 End character of data field Hexadecimal checksum Each of message Q en 3.17. Packet Type: 255 PMTK_SET_SYNC_PPS_NMEA fid This message is used to enable or disable fix NMEA output time behind PPS function.(Default off) n Data Field: o $PMTK255,Enable C Example: $PMTK255,0*2C Response: $PMTK001,255,3*32 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message L70_GPS_Protocol_Specification Confidential / Released 26 / 47 Packet Type Enable * Checksum 255 ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each of message GPS Module Series L70 GPS Protocol Specification 3.18. Packet Type: 262 PMTK_SET_FLP_MODE This message is used to set FLP mode. Fitness low power (FLP) is an optimized solution for wearable, fitness and tracking device. You can use the SDK command $PQFLP to permanently modify and save. l For details please refer to Quectel_GNSS_SDK_Commands_Manual. te Data Field: c l $PMTK262,Mode Example: ue tia $PMTK262,1*29 Response: $PMTK001,262,3,1*2B Q n Field Description e $ Each NMEA message starts with ‘$’ fid PMTK MTK proprietary message Packet Type n Mode Co * 262 ‘0’=Normal mode ‘1’=FLP mode End character of data field Checksum Hexadecimal checksum Each of message L70_GPS_Protocol_Specification Confidential / Released 27 / 47 GPS Module Series L70 GPS Protocol Specification 3.19. Packet Type: 285 PMTK_SET_PPS_CONFIG This message is used to set PPS type. You can use the SDK command $PQ1PPS to permanently set and save. For details please refer to Quectel_GNSS_SDK_Commands_Manual. Data Field: $PMTK285,Type,PPSPulseWidth Example: $PMTK285,4,100*38 Response: $PMTK001,285,3*3F Field $ l PMTK te Packet Type uec tial Type Q n PPSPulseWidth e * fid Checksum Description Each NMEA message starts with ‘$’ MTK proprietary message 285 ‘0’=Disable ‘1’=After the first fix ‘2’=3D fix only ‘3’=2D/3D fix only ‘4’=Always 2~998 (Unit: ms) End character of data field Hexadecimal checksum Each of message Con 3.20. Packet Type: 286 PMTK_SET_AIC_ENABLED This message is used to enable or disable AIC function. It is suggested to set cold start command first and then send PMTK command. Data Field: $PMTK286,Enable Example: $PMTK286,0*22 Response: L70_GPS_Protocol_Specification Confidential / Released 28 / 47 GPS Module Series L70 GPS Protocol Specification $PMTK001,286,3*3C Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 286 Enable ‘0’=Disable ‘1’=Enable * End character of data field Checksum Hexadecimal checksum Each of message tel 3.21. Packet Type: 301 PMTK_API_SET_DGPS_MODE uec tial This message is used to configure the source mode of DGPS correction data. Data Field: Q n $PMTK301,Mode Example: e $PMTK301,2*2E Response: fid $PMTK001,301,3*32 Field Description n $ Each NMEA message starts with ‘$’ Co PMTK MTK proprietary message Packet Type 301 Mode DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM ‘2’=SBAS(Include WAAS/EGNOS/GAGAN/MSAS) * End character of data field Checksum Hexadecimal checksum L70_GPS_Protocol_Specification Confidential / Released 29 / 47 Each of message GPS Module Series L70 GPS Protocol Specification 3.22. Packet Type: 313 PMTK_API_SET_SBAS_ENABLED This message is used to enable or disable to search a SBAS satellite. SBAS (Satellite Based Augmentation Systems) is a system that supports wide-area or regional augmentation through geostationary satellite broadcast messages. The geostationary satellite broadcast GPS integrity and correction data with the assistance of multiple ground stations which are located at accurately-surveyed points. Data Field: $PMTK313,Enable Example: l $PMTK313,1*2E Response: te $PMTK001,313,3*31 c l Field Description ue tia $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Q n Packet Type e Enable fid * 313 ‘0’=Disable ‘1’=Enable End character of data field Checksum Hexadecimal checksum Con Each of message 3.23. Packet Type: 314 PMTK_API_SET_NMEA_OUTPUT This message is used to set NMEA sentence output frequencies. There are totally 19 data fields that present output frequencies for the 19 supported NMEA sentences individually. L70_GPS_Protocol_Specification Confidential / Released 30 / 47 GPS Module Series L70 GPS Protocol Specification Supported Frequency Settings:  0 – Disabled or not supported sentence  1 – Output once every one position fix  2 – Output once every two position fixes  3 – Output once every three position fixes  4 – Output once every four position fixes  5 – Output once every five position fixes Data Field: None Example: The module only output RMC once every one position fix. $PMTK314,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*29 Response: $PMTK001,314,3*36 l Field Description te $ Each NMEA message starts with ‘$’ c l PMTK MTK proprietary message ue tia PacketType 314 0 GLL GLL interval – Geographic Position – Latitude longitude Q n 1RMC RMC interval – Recommended Minimum Specific GPS Sentence e 2 VTG VTG interval – Course Over Ground and Ground Speed fid 3 GGA GGA interval – GPS Fix Data 4 GSA GSA interval – GPS DOPS and Active Satellites n 5 GSV GSV interval – GPS Satellites in View Co 6 GRS GRS interval – GPS Range Residuals 7 GST GST interval – GPS Pseudorange Error Statistics 8 Reserved Always 0 9 Reserved Always 0 10 Reserved Always 0 11 Reserved Always 0 L70_GPS_Protocol_Specification Confidential / Released 31 / 47 GPS Module Series L70 GPS Protocol Specification 12 Reserved Always 0 13 Reserved Always 0 14 Reserved Always 0 15 Reserved Always 0 16 Reserved Always 0 17 ZDA ZDA interval – Time and Date 18 Reserved PMTKCHN interval – GPS channel status * Checksum l End character of data field Hexadecimal checksum Each of message te To restore the system default setting, use below message: c l Example: ue tia $PMTK314,-1*04 Field Description Q n $ Each NMEA message starts with ‘$’ e PMTK MTK proprietary message fid Packet Type 314 Restore Always -1 n * End character of data field Co Checksum Hexadecimal checksum Each of message 3.24. Packet Type: 351 PMTK_API_SET_SUPPORT_QZSS_NMEA The receiver support new NMEA format for QZSS. The command allow user enable or disable QZSS NMEA format. Default is disable QZSS NMEA format. L70_GPS_Protocol_Specification Confidential / Released 32 / 47 GPS Module Series L70 GPS Protocol Specification Data Field: $PMTK351,Enable Example: $PMTK351,1*28 Response: $PMTK001,351,3*37 Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type QZSS_Enable l * te Checksum 351 ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum uec tial 3.25. Packet Type: 352 PMTK_API_SET_STOP_QZSS Q n Since QZSS is regional positioning service. This command is used to enable or disable QZSS function. Default is enable QZSS function. fide Data Field: $PMTK352,Enable Example: $PMTK352,0*2A n Response: o $PMTK001,352,3*34 C Field Description $ PMTK Packet Type QZSS_Enable Each NMEA message starts with ‘$’ MTK proprietary message 352 ‘0’=Enable ‘1’=Disable L70_GPS_Protocol_Specification Confidential / Released 33 / 47 * Checksum End character of data field Hexadecimal checksum GPS Module Series L70 GPS Protocol Specification 3.26. Packet Type: 386 PMTK_API_SET_STATIC_NAV_THD This message is used to set the speed threshold for static navigation. If the actual speed is below the threshold, output position will keep the same and output speed will be zero. If threshold value is set to 0, this function is disabled. Data Field: $PMTK386,Speed_threshold Example: $PMTK386,0.3*3E l Response: te $PMTK001,386,3*3D c l Field Description ue tia $ PMTK Q n Packet Type e Speed_threshold fid * Checksum Con Each NMEA message starts with ‘$’ MTK proprietary message 386 0~2m/s End character of data field Hexadecimal checksum Each of message 3.27. Packet Type: 400 PMTK_API_Q_FIX_CTL This message is used to query the rate of position fixing activity. Refer to PMTK_DT_FIX_CTL for the result of the query. Data Field: None L70_GPS_Protocol_Specification Confidential / Released 34 / 47 GPS Module Series L70 GPS Protocol Specification Example: $PMTK400*36 Field Description $ Each NMEA message starts with ‘$’ PMTK Packet Type * MTK proprietary message 400 End character of data field Checksum Hexadecimal checksum Each of message tel 3.28. Packet Type: 401 PMTK_API_Q_DGPS_MODE c l This message is used to query the setting of DGPS mode. ue tia Refer to PMTK_API_SET_DGPS_MODE for setting the DGPS mode. Refer to PMTK_DT_DGPS_MODE for the result of the query. Q en DataField: None fid Example: $PMTK401*37 n Field Description o $ C PMTK Each NMEA message starts with ‘$’ MTK proprietary message Packet Type 401 * End character of data field Checksum Hexadecimal checksum Each of message L70_GPS_Protocol_Specification Confidential / Released 35 / 47 GPS Module Series L70 GPS Protocol Specification 3.29. Packet Type: 413 PMTK_API_Q_SBAS_ENABLED This message is used to query the setting of SBAS. Refer to PMTK_API_SET_SBAS_ENABLE for SBAS setting. Refer to PMTK_DT_SBAS_ENABLED for the result of the query. Data Field: None Example: $PMTK413*34 Field Description $ l PMTK te Packet Type c l * ue tia Checksum Q n Each NMEA message starts with ‘$’ MTK proprietary message 413 End character of data field Hexadecimal checksum Each of message fide 3.30. Packet Type: 414 PMTK_API_Q_NMEA_OUTPUT n This message is used to query the current NMEA sentence output frequencies. Co Refer to PMTK_API_SET_NMEA_OUTPUT for the frequencies setting. Refer to PMTK_DT_NMEA_OUTPUT for the result of the query. Data Field: None Example: $PMTK414*33 Field Description L70_GPS_Protocol_Specification Confidential / Released 36 / 47 $ PMTK Packet Type * Checksum GPS Module Series L70 GPS Protocol Specification Each NMEA message starts with ‘$’ MTK proprietary message 414 End character of data field Hexadecimal checksum Each of message 3.31. Packet Type: 605 PMTK_Q_RELEASE This message is used to query the firmware release information. tel Refer to PMTK_DT_RELEASE for the result of the query. c l Data Field: None ue tia Example: $PMTK605*31 Q n Field Description e $ fid PMTK Packet Type n * Co Checksum Each NMEA message starts with ‘$’ MTK proprietary message 605 End character of data field Hexadecimal checksum Each of message 3.32. Packet Type: 500 PMTK_DT_FIX_CTL This message is the response to PMTK_API_Q_FIX_CTL. L70_GPS_Protocol_Specification Confidential / Released 37 / 47 GPS Module Series L70 GPS Protocol Specification Data Field: $PMTK500,Fix interval Example: $PMTK500,1000,0,0,0,0*1A Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 500 Fix Interval Position fix interval [msec]. Greater than 100. Reserved Reserved l Reserved te Reserved c l * ue tia Checksum Always 0 Always 0 Always 0 Always 0 End character of data field Hexadecimal checksum Each of message Q fiden 3.33. Packet Type: 501 PMTK_DT_DGPS_MODE n This message is the response to PMTK_API_Q_DGPS_MODE. o Data Field: C $PMTK501,Mode Example: $PMTK501,1*2B Field Description $ PMTK Packet Type Each NMEA message starts with ‘$’ MTK proprietary message 501 L70_GPS_Protocol_Specification Confidential / Released 38 / 47 Mode * Checksum DGPS data source mode. ‘0’=No DGPS source ‘1’=RTCM ‘2’=SBAS End character of data field Hexadecimal checksum Each of message GPS Module Series L70 GPS Protocol Specification 3.34. Packet Type: 513 PMTK_DT_SBAS_ENABLED This message is the response to PMTK_API_Q_SBAS_ENABLED. l Data Field: te $PMTK513,Enable Example: c l $PMTK513,1*28 ue tia Field Description $ Q n PMTK e Packet Type fid Enable n * o Checksum C Each NMEA message starts with ‘$’ MTK proprietary message 513 ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each of message 3.35. Packet Type: 514 PMTK_DT_NMEA_OUTPUT This message is the response to PMTK_API_Q_NMEA_OUTPUT. L70_GPS_Protocol_Specification Confidential / Released 39 / 47 GPS Module Series L70 GPS Protocol Specification Data Field: None Example: $PMTK514,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0*2E Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 514 0 GLL 1 RMC 2 VTG 3 GGA 4 GSA 5 GSV 6 Reserved 7 Reserved 8 Reserved 9 Reserved 10 Reserved 11 Reserved 12 Reserved 13 Reserved GLL interval – Geographic Position – Latitude longitude RMC interval – Recommended Minimum Specific GPS Sentence VTG interval – Course Over Ground and Ground Speed l GGA interval – GPS Fix Data te GSA interval – GPS DOPS and Active Satellites c l GSV interval – GPS Satellites in View ue tia GRS interval – GPS Range Residuals CQonfiden GST interval – GPS Pseudorange Error Statistics 14 Reserved 15 Reserved 16 Reserved 17 ZDA ZDA interval – Time and Date 18 Reserved PMTKCHN interval – GPS channel status L70_GPS_Protocol_Specification Confidential / Released 40 / 47 * Checksum End character of data field Hexadecimal checksum Each of message GPS Module Series L70 GPS Protocol Specification 3.36. Packet Type: 705 PMTK_DT_RELEASE This message is the response to PMTK_Q_RELEASE. Data Field: $PMTK705, Release string, Build ID, Product Model(,SDK Version) Example: $PMTK705,AXN_2.10_3339_11092201,0004,QUECTEL-L70,*1A l Field Description te $ c l PMTK ue tia PacketType Q n Release String fide Build ID Product Model n SDK Version o (Optional) C * Each NMEA message starts with ‘$’ MTK proprietary message 705 Firmware release name and version 3318: Mcore_x.x 3329: AXN_x.x 3339: AXN_x.x Build ID set in CoreBuilder for firmware version control Product Model set in CoreBuilder for product identification Showing SDK version if the firmware is used for SDK End character of data field Checksum Hexadecimal checksum Each of message L70_GPS_Protocol_Specification Confidential / Released 41 / 47 GPS Module Series L70 GPS Protocol Specification 3.37. Packet Type: 869 PMTK_EASY_ENABLE This message is used to enable or disable EASY function, and it also can be used to query if EASY is enabled or disabled. Data Field: $PMTK869,CmdType[, Enabled] Example: $PMTK869,1,1*35 Response: $PMTK001,869,3*37 Field $ l PMTK te Packet Type c l CmdType ue tia Enabled Q n * e Checksum fid Description Each NMEA message starts with ‘$’ MTK proprietary message 869 ‘0’=Query ‘1’=Set ‘2’=Result for Query operation ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each of message Con 3.38. Packet Type: 875 PMTK_PMTKLSC_STN_OUTPUT This message is used to enable or disable PMTKLSC Sentence output. Query if PMTKLSC Sentence output is enabled or disabled. Data Field: $PMTK875,CmdType[,Enabled] Example: $PMTK875,1,1*38 : Enable PMTKLSC Sentence output Response: $PMTKLSC,Parameter1,Parameter2,Parameter3*CS L70_GPS_Protocol_Specification Confidential / Released 42 / 47 GPS Module Series L70 GPS Protocol Specification Where Parameter1 : current leap second Parameter2 : leap indicator, 1 means updated from broadcast data Parameter3 : next leap second Field Description $ Each NMEA message starts with ‘$’ PMTK MTK proprietary message Packet Type 875 ‘0’=Query CmdType ‘1’=Set Enabled l * te Checksum c l ‘2’=Result for Query operation ‘0’=Disable ‘1’=Enable End character of data field Hexadecimal checksum Each of message ue tia 3.39. Packet Type: 886 PMTK_FR_MODE Q en This message is used to set navigation mode. fid Data Field: $PMTK886,CmdType Example: n $PMTK886,3*2B o Response: C $PMTK001,886,3*36 Field Description $ PMTK Packet Type CmdType Each NMEA message starts with ‘$’ MTK proprietary message 886 ‘0’=Normal mode: For general purpose ‘1’=Fitness mode: For running and walking purpose that the low-speed L70_GPS_Protocol_Specification Confidential / Released 43 / 47 * Checksum GPS Module Series L70 GPS Protocol Specification (<5m/s) movement will have more effect on the position calculation. ‘2’=Aviation mode: For high-dynamic purpose that the large-acceleration movement will have more effect on the position calculation. ‘3’=Balloon mode: For high-altitude balloon purpose that the vertical movement will have more effect on the position calculation. End character of data field Hexadecimal checksum Each of message CQouneficdteenl tial L70_GPS_Protocol_Specification Confidential / Released 44 / 47 GPS Module Series L70 GPS Protocol Specification 4 Appendix A Reference Table 3: Related Documents SN Document Name Remark [1] Quectel_L70_Hardware_Design L70 Hardware Design [2] Quectel_L70_EVB_User Guide L70 EVB User Guide [3] Quectel_L70_Reference_Design L70 Reference Design l [4] Quectel_GNSS_SDK_Commands_Manual GNSS SDK Commands Manual cte l Table 4: Terms and Abbreviations ue tia Abbreviation GPS Q n NMEA e PMTK fid GGA n RMC o GSA C GSV Description Global Navigation Satellite System National Marine Electronics Association Private protocol of MTK NMEA: Global Positioning System Fix Data NMEA: Recommended Minimum Position Data NMEA: GPS DOP and Active Satellites NMEA: GPS Satellites in View GLL NMEA: Geographic Position – Latitude/Longitude VTG NMEA: Track Made Good and Ground Speed SBAS AGPS DGPS Satellite-Based Augmentation System Assisted Global Positioning System Differential Global Positioning System L70_GPS_Protocol_Specification Confidential / Released 45 / 47 GPS Module Series L70 GPS Protocol Specification EASY Embedded Assist System AIC Active Interference Cancellation PDOP Position Dilution of Precision VDOP Vertical Dilution of Precision HDOP Horizontal Dilution of Precision WAAS Wide Area Augmentation System PPS Pulse Per Second UTC FLP Universal Time Coordinated CQouneficdteenl tial FitnessLowPower L70_GPS_Protocol_Specification Confidential / Released 46 / 47 GPS Module Series L70 GPS Protocol Specification 5 Default Configurations Table 5: Default Configurations Item Default NMEA port baud rate Datum Rate of position fixing l DGPS mode te SBAS enable c l NMEA output messages ue tia AIC CQonfiden EASY 9600bps WGS84 1HZ SBAS Enable GGA,RMC, GSA, GSV,VTG and GLL On On L70_GPS_Protocol_Specification Confidential / Released 47 / 47

MC25 GNSS Protocol Specification GSM/GPRS/GNSS Module Series Rev. MC25_GNSS_Protocol_Specification_V1.1 Date: 2019-11-26 Status: Released www.quectel.com GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. MC25_GNSS_Protocol_Specification 2 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification About the Document Revision History Revision Date 1.0 2018-12-28 Author Jenn XIANG 1.1 2019-11-26 Simon HU Description Initial Added GNSS AT command AT+QGAGPS (Chapter 3.5), AT+QGAGPSAID (Chapter 3.6), and AT+QGREFLOC (Chapter 3.7) MC25_GNSS_Protocol_Specification 3 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 6 1 Introduction .......................................................................................................................................... 7 1.1. Differences Between Two Application Modes............................................................................. 7 2 Standard NMEA Packet Protocols ..................................................................................................... 9 2.1. --RMC.......................................................................................................................................... 9 2.2. --VTG......................................................................................................................................... 10 2.3. --GGA ........................................................................................................................................ 11 2.4. --GSA ........................................................................................................................................ 12 2.5. --GSV ........................................................................................................................................ 14 2.6. --GLL ......................................................................................................................................... 15 3 GNSS AT Commands ........................................................................................................................ 17 3.1. AT+QGNSSC GNSS Module Power Control ......................................................................... 17 3.2. AT+QGNSSRD Read GNSS Navigation Information ............................................................ 18 3.3. AT+QGNSSCMD Send Commands to GNSS Module .......................................................... 20 3.4. AT+QGNSSTS Get Time Synchronization Status for GNSS Module .................................... 20 3.5. AT+QGAGPS Download AGPS Data from Server................................................................. 21 3.6. AT+QGAGPSAID Inject AGPS Data to GNSS....................................................................... 22 3.7. AT+QGREFLOC Set Reference Location Information for QuecFastFix Online .................... 23 4 NMEA Packet Protocols .................................................................................................................... 25 4.1. Packet Type: DFT ..................................................................................................................... 25 4.2. Packet Type: SIR ...................................................................................................................... 26 5 Hexadecimal Packet Protocols......................................................................................................... 27 5.1. Hexadecimal Packet Structure.................................................................................................. 27 5.1.1 Data Type............................................................................................................................. 27 5.1.2 Data Frame Basic Structure ................................................................................................ 28 5.1.3 Head .................................................................................................................................... 28 5.1.4 Identifier ............................................................................................................................... 28 5.1.5 Data Length ......................................................................................................................... 28 5.1.6 Data ..................................................................................................................................... 28 5.1.7 Checksum ............................................................................................................................ 28 5.2. General Protocols (0x01) .......................................................................................................... 29 5.2.1 ACK (0x01) .......................................................................................................................... 29 5.2.2 NACK (0x02)........................................................................................................................ 29 5.3. Control Protocols (0x02) ........................................................................................................... 30 5.3.1 RESET (0x01)...................................................................................................................... 30 5.3.2 DEFAULT (0x02).................................................................................................................. 30 5.3.3 STANDBY (0x04) ................................................................................................................. 31 MC25_GNSS_Protocol_Specification 4 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 5.4. Setting Protocols (0x03)............................................................................................................ 31 5.4.1 GNSS (0x11)........................................................................................................................ 31 5.4.2 QZSS (0x12)........................................................................................................................ 32 5.4.3 SBAS (0x13) ........................................................................................................................ 32 5.4.4 UART (0x21) ........................................................................................................................ 33 5.4.5 DYNAMIC (0x31) ................................................................................................................. 34 5.4.6 FIX (0x32) ............................................................................................................................ 35 5.4.7 SV (0x33) ............................................................................................................................. 36 5.4.8 INTERVAL (0x35) ................................................................................................................ 36 5.4.9 PPS (0x41) .......................................................................................................................... 37 5.4.10 NMEA (0x51) ..................................................................................................................... 38 5.5. Query Protocols (0x05) ............................................................................................................. 39 5.5.1 GNSS (0x02) ....................................................................................................................... 39 6 Default Configurations ...................................................................................................................... 41 7 Appendix A References..................................................................................................................... 42 MC25_GNSS_Protocol_Specification 5 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Table Index TABLE 1: DIFFERENCES BETWEEN ALL-IN-ONE SOLUTION AND STAND-ALONE SOLUTION ................. 7 TABLE 2: OVERVIEW OF GNSS AT COMMANDS FOR MC25 ....................................................................... 17 TABLE 3: DATA TYPE ....................................................................................................................................... 27 TABLE 4: DEFAULT CONFIGURATIONS ......................................................................................................... 41 TABLE 5: RELATED DOCUMENT .................................................................................................................... 42 TABLE 6: TERMS AND ABBREVIATIONS ........................................................................................................ 42 TABLE 7: STRUCTURE OF NMEA MESSAGE ................................................................................................ 43 TABLE 8: TALKER ID DISPLAY IN DIFFERENT GNSS SYSTEM (FOR NMEA 0183 4.10 VERSION) .......... 44 TABLE 9: DIFFERENT CODING SCHEMES OF +CME ERROR RELATED TO GNSS: .................... 44 MC25_GNSS_Protocol_Specification 6 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 1 Introduction MC25 is multi-purpose module which integrates a high performance GNSS engine and a quad-band GSM/GPRS engine. The GNSS engine is a single receiver integrating GPS, BeiDou and GLONASS systems. It supports multiple positioning and navigation systems including autonomous GPS, BeiDou, SBAS and QZSS. With the embedded GNSS function, MC25 can help customers get accurate coordinates, high-precision time, etc., and thus is ideal for use in wearable devices, vehicle and personnel tracking, and more fields. This document describes the software aspects of MC25 module. It supports NMEA 0183 standard commands, and also can be controlled and configured via NMEA packet. 1.1. Differences Between Two Application Modes The internal GSM and GNSS engines of MC25 can work as a whole unit (All-in-one solution) or work relatively independently (Stand-alone solution) according to customers’ demands. In All-in-one solution, MC25 works as a whole unit. The GNSS part can be regarded as a peripheral of the GSM part. This allows for convenient communication between GSM and GNSS parts, such as AT command sending for GNSS control. In Stand-alone solution, GSM and GNSS parts work independently, and thus have to be controlled separately. When working in All-in-one or Stand-alone solution, there are some differences for MC25 to acquire NMEA output data, or send GNSS command. The details are listed below. Table 1: Differences between All-in-one Solution and Stand-alone Solution Item All-in-one NMEA Output Data Acquisition Acquire via sending AT+QGNSSRD command ASCII Command Sending HEX Command Sending Send via AT+QGNSSCMD command Send via AT+QGNSSCMD command Stand-alone Acquire directly Send directly Send directly MC25_GNSS_Protocol_Specification 7 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification NOTE AT commands are effective only when the module is in All-in-one solution. MC25_GNSS_Protocol_Specification 8 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 2 Standard NMEA Packet Protocols MC25 supports standard NMEA 0183 messages, and the following tables show the structure of these messages. 2.1. --RMC RMC, namely Recommended Minimum Specific GNSS Data (including position, velocity and time). Example: $GNRMC,085152.00,A,3150.78499,N,11711.90193,E,0.176,,221018,,,A,V*1E $GPRMC,090853.00,A,3150.78462,N,11711.89851,E,0.071,,221018,,,A,V*01 $GLRMC,095332.00,A,3150.76852,N,11711.91845,E,0.111,,221018,,,A,V*1E $BDRMC,095703.00,A,3150.77667,N,11711.93068,E,0.518,,221018,,,A,V*14 Field Description $ Each NMEA message starts with ‘$’ --RMC Message ID UTC Time Data Valid Latitude N/S Longitude E/W Speed Time in format ‘hhmmss.ss’ ‘V’=Invalid ‘A’=Valid Latitude in format ‘ddmm.mmmmm’ (degrees and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmmm’ (degrees and minutes) ‘E’=East ‘W’=West Speed over ground in knots COG Course over ground in degree Date Date in format ‘ddmmyy’ MC25_GNSS_Protocol_Specification 9 / 44 Magnetic Variation E/W Positioning Mode Navigation State * Checksum GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Magnetic variation in degree, not being output Magnetic variation E/W indicator, not being output ‘N’=No fix ‘A’=Autonomous GNSS fix ‘D’=Differential GNSS fix 'V'=Navigational status not valid End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 8. 2.2. --VTG VTG, namely Course Over Ground and Ground Speed. Example: $GNVTG,,T,,M,0.054,N,0.101,K,A*3C $GPVTG,,T,,M,0.071,N,0.132,K,A*25 $GLVTG,,T,,M,0.111,N,0.206,K,A*3A $BDVTG,,T,,M,0.518,N,0.959,K,A*3B Field Description $ Each NMEA message starts with ‘$’ --VTG Message ID COG (T) Course over ground (true) in degree T Fixed field, true COG(M) Course over ground (magnetic), not being output M Fixed field, magnetic Speed Speed over ground in knots MC25_GNSS_Protocol_Specification 10 / 44 N Speed K Positioning Mode * Checksum GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Fixed field, knots Speed over ground in km/h Fixed field, km/h ‘N’=No fix ‘A’=Autonomous GNSS fix ‘D’=Differential GNSS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 8. 2.3. --GGA GGA, namely Global Positioning System Fix Data, is the essential fix data which provides 3D location and accuracy data. Example: $GNGGA,094324.00,3150.77559,N,11711.92539,E,1,07,2.10,52.9,M,-2.2,M,,*60 $GPGGA,090853.00,3150.78462,N,11711.89851,E,1,05,1.86,115.3,M,-2.2,M,,*48 $GLGGA,095332.00,3150.76852,N,11711.91845,E,1,04,5.85,65.7,M,-2.2,M,,*64 $BDGGA,095703.00,3150.77667,N,11711.93068,E,1,04,3.31,57.8,M,-2.2,M,,*64 Field Description $ Each NMEA message starts with ‘$’ --GGA Message ID UTC Time Time in format ‘hhmmss.ss’ Latitude N/S Longitude Latitude in format ‘ddmm.mmmmm’ (degrees and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmmm’ (degrees and minutes) MC25_GNSS_Protocol_Specification 11 / 44 E/W Fix Status Number of SV HDOP Altitude M Geoid Separation M DGPS Age DGPS Station ID * Checksum GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification ‘E’=East ‘W’=West ‘0’=Invalid ‘1’=GNSS fix ‘2’=DGPS fix ‘6’=Estimated (dead reckoning) Mode Number of satellites being used (0~26) Horizontal dilution of precision Altitude in meters according to WGS84 ellipsoid Fixed field, meter Height of Geoid (means sea level) above WGS84 ellipsoid, meter Fixed field, meter Age of DGPS data in seconds, empty if DGPS is not used DGPS station ID, empty if DGPS is not used End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 8. 2.4. --GSA GSA, namely GNSS DOP and Active Satellites, which provides details on the fix and includes the number of satellites being used in the current solution and the DOP. Example: $GNGSA,A,3,12,15,24,25,,,,,,,,,2.68,1.45,2.25,1*0E $GNGSA,A,3,70,80,69,71,,,,,,,,,3.03,2.10,2.18,2*0C $GNGSA,A,3,06,01,04,,,,,,,,,,3.03,2.10,2.18,4*0F $GPGSA,A,3,24,20,10,32,21,,,,,,,,3.92,1.86,3.45,1*1D $GLGSA,A,3,70,80,69,71,,,,,,,,,7.20,5.85,4.20,2*0D MC25_GNSS_Protocol_Specification 12 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification $BDGSA,A,3,01,04,06,09,,,,,,,,,6.42,3.31,5.50,4*00 Field $ --GSA Mode Fix Status Satellite Used 1 Satellite Used 2 Satellite Used 3 Satellite Used 4 Satellite Used 5 Satellite Used 6 Satellite Used 7 Satellite Used 8 Satellite Used 9 Satellite Used 10 Satellite Used 11 Satellite Used 12 PDOP HDOP VDOP GNSS System ID * Description Each NMEA message starts with ‘$’ Message ID Auto selection of 2D or 3D fix ‘M’=Manual, forced to switch 2D/3D mode ‘A’=Allowed to automatically switch 2D/3D mode ‘1’=No fix ‘2’=2D fix ‘3’=3D fix Satellite used on channel 1 Satellite used on channel 2 Satellite used on channel 3 Satellite used on channel 4 Satellite used on channel 5 Satellite used on channel 6 Satellite used on channel 7 Satellite used on channel 8 Satellite used on channel 9 Satellite used on channel 10 Satellite used on channel 11 Satellite used on channel 12 Position dilution of precision Horizontal dilution of precision Vertical dilution of precision 1 = GPS 2 = GLONASS 4 = BeiDou End character of data field MC25_GNSS_Protocol_Specification 13 / 44 Checksum GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 8. 2.5. --GSV GSV, namely GNSS Satellites in View. One GSV sentence can only provide data for at most 4 satellites, so several sentences might be required for full information. Since GSV includes satellites that are not used as part of the solution, GSV sentence contains more satellites than GGA does. Example: $GPGSV,3,1,09,10,49,322,30,12,29,119,16,14,10,272,09,15,31,068,,0*66 $GPGSV,3,2,09,20,80,322,27,21,35,216,30,24,52,044,18,25,19,159,13,0*6A $GPGSV,3,3,09,32,26,285,29,0*5D $GLGSV,1,1,04,69,20,109,40,70,60,046,43,71,33,331,50,80,55,041,46,0*75 $BDGSV,1,1,03,01,44,142,40,04,31,120,41,06,65,022,43,0*47 Field Description $ Each NMEA message starts with ‘$’ --GSV Number of Message Sequence Number Message ID Number of messages, total number of GPGSV messages being output (1~4) Sequence number of this entry (1~4) Satellites in View Total satellites in view Satellite ID 1 Satellite ID Elevation 1 Elevation in degree (0~90) Azimuth 1 Azimuth in degree (0~359) SNR 1 Signal to noise ration in dB-Hz (0~99), empty if not tracking Satellite ID 2 Satellite ID MC25_GNSS_Protocol_Specification 14 / 44 Elevation 2 Azimuth 2 SNR 2 Satellite ID 3 Elevation 3 Azimuth 3 SNR 3 Satellite ID 4 Elevation 4 Azimuth 4 SNR 4 Signal ID * Checksum GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Elevation in degree (0~90) Azimuth in degree (0~359) Signal to noise ration in dB-Hz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to noise ration in dB-Hz (0~99), empty if not tracking Satellite ID Elevation in degree (0~90) Azimuth in degree (0~359) Signal to noise ration in dB-Hz (0~99), empty if not tracking 0 = All channel End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 8. 2.6. --GLL GLL, namely Geographic Position in Latitude and Longitude, which contains position information, time of position fix and status. Example: $GNGLL,3150.77559,N,11711.92539,E,094324.00,A,A*72 $GPGLL,3150.78462,N,11711.89851,E,090853.00,A,A*6C $GLGLL,3150.76847,N,11711.91841,E,095331.00,A,A*77 $BDGLL,3150.77668,N,11711.93041,E,095702.00,A,A*76 MC25_GNSS_Protocol_Specification 15 / 44 Field $ --GLL Latitude N/S Longitude E/W UTC Time Data Valid Positioning Mode * Checksum GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Description Each NMEA message starts with ‘$’ Message ID Latitude in format ‘ddmm.mmmmm’ (degrees and minutes) ‘N’=North ‘S’=South Longitude in format ‘dddmm.mmmmm’ (degrees and minutes) ‘E’=East ‘W’=West Time in format ‘hhmmss.ss’ ‘V’=Invalid ‘A’=Valid ‘N’=No fix ‘A’=Autonomous GNSS fix ‘D’=Differential GNSS fix End character of data field Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ NOTE For more details about talker ID, please refer to Table 8. MC25_GNSS_Protocol_Specification 16 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 3 GNSS AT Commands The commands below are used to control or configure the internal GNSS engine of MC25. These commands are effective only in All-in-one solution. Table 2: Overview of GNSS AT Commands for MC25 Command AT+QGNSSC AT+QGNSSRD AT+QGNSSCMD AT+QGNSSTS AT+QGAGPS AT+QGAGPSAID AT+QGREFLOC Description GNSS module power control Read GNSS navigation information Send commands to GNSS module Get time synchronization status for GNSS module Download AGPS Data from Server Inject AGPS Data to GNSS Set Reference Location Information for QuecFastFix Online 3.1. AT+QGNSSC GNSS Module Power Control The command is used to control the power supply of GNSS module. AT+QGNSSC GNSS Module Power Control Test Command AT+QGNSSC=? Response +QGNSSC: (list of supported s) Read Command AT+QGNSSC? OK Response +QGNSSC: OK MC25_GNSS_Protocol_Specification 17 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Write Command AT+QGNSSC= Response OK If there is any error, response: +CME ERROR: Parameter 0 Power off GNSS module 1 Power on GNSS module NOTE In Stand-alone solution, the power supply of GNSS is controlled by an external circuit rather than GPS_VCC_EN pin. In such case, AT+QGNSSC command cannot be used and thus can be ignored. Example AT+QGNSSC? +QGNSSC: 0 OK AT+QGNSSC=1 OK //Query GNSS power status //GNSS powered off //Power on GNSS 3.2. AT+QGNSSRD Read GNSS Navigation Information The command is used to read the GNSS navigation information. AT+QGNSSRD Read GNSS Navigation Information Test Command AT+QGNSSRD=? Response +QGNSSRD: (list of supported s) Read Command AT+QGNSSRD? OK Response +QGNSSRD: (information of all supported s) Write Command AT+QGNSSRD= OK Response +QGNSSRD: (information of ) OK MC25_GNSS_Protocol_Specification 18 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Parameter If there is any error, response: +CME ERROR: 'NMEA/GGA': Get GGA sentence 'NMEA/GLL': Get GLL sentence 'NMEA/GSA': Get GSA sentence 'NMEA/GSV': Get GSV sentence 'NMEA/RMC': Get RMC sentence 'NMEA/VTG': Get VTG sentence NOTE The command can only be executed 3 seconds after GNSS is powered on, otherwise +CME ERROR: 7103 will be returned. Example AT+QGNSSRD? //Inquire GNSS NMEA sentence. +QGNSSRD: $GNRMC,034035.000,A,3150.8617,N,11711.9038,E,3.02,183.45,240516,,,A*75 $GNVTG,183.45,T,,M,3.02,N,5.59,K,A*20 $GNGGA,034035.000,3150.8617,N,11711.9038,E,1,4,1.50,40.9,M,0.0,M,,*44 $GPGSA,A,3,26,21,,,,,,,,,,,1.75,1.50,0.91*0A $GLGSA,A,3,82,70,,,,,,,,,,,1.75,1.50,0.91*1C $GPGSV,3,1,12,16,67,308,,26,58,021,16,23,40,307,,31,40,088,*7F $GPGSV,3,2,12,08,17,199,,09,14,320,,21,10,086,14,14,10,153,*73 $GPGSV,3,3,12,22,09,226,,193,06,165,,32,03,154,,29,01,034,*45 $GLGSV,3,1,09,81,44,073,,79,40,041,,82,38,145,15,80,36,323,*66 $GLGSV,3,2,09,70,30,290,16,69,26,225,,78,12,078,,88,09,027,*64 $GLGSV,3,3,09,71,05,334,*5B $GNGLL,3150.8617,N,11711.9038,E,034035.000,A,A*4C OK AT+QGNSSRD='NMEA/RMC' //Inquire RMC information. +QGNSSRD: $GNRMC,034036.000,A,3150.8612,N,11711.9045,E,2.74,178.00,240516,,,A*7C OK AT+QGNSSRD='NMEA/GSA' //Inquire GSA information. +QGNSSRD: $GPGSA,A,3,26,21,,,,,,,,,,,1.76,1.50,0.91*09 $GLGSA,A,3,82,70,,,,,,,,,,,1.75,1.50,0.91*1C MC25_GNSS_Protocol_Specification 19 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification OK 3.3. AT+QGNSSCMD Send Commands to GNSS Module The command is used to send commands to GNSS module, which allows customers to optionally use some functions to meet application demands. AT+QGNSSCMD Send Commands to GNSS Module Test Command AT+QGNSSCMD=? Response +QGNSSCMD: (0,1),'cmdString' Write Command AT+QGNSSCMD=, OK Response OK If there is any error, response: +CME ERROR: Parameter 0 NMEA style command 1 Hex style command Command string NOTE The command can only be executed 3 seconds after GNSS is powered on, otherwise it will not be able to be received by GNSS. 3.4. AT+QGNSSTS Get Time Synchronization Status for GNSS Module The command is used to get time synchronization status for GNSS module. AT+QGNSSTS Get Time Synchronization Status for GNSS Module Test Command AT+QGNSSTS=? Response +QGNSSTS: OK MC25_GNSS_Protocol_Specification 20 / 44 Read Command AT+QGNSSTS? Parameter Response +QGNSSTS: OK GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 0 Time is not synchronized 1 Time is synchronized successfully NOTE The time synchronization status queried by AT+QGNSSTS? will be updated in either of the following cases:  The time is synchronized via NITZ.  GNSS gets fixed in All-in-one solution. Example AT+QGNSSTS=? +QGNSSTS: (0,1) OK AT+QGNSSTS? +QGNSSTS: 1 OK //Test command //Read time synchronization status //Time is synchronized successfully 3.5. AT+QGAGPS Download AGPS Data from Server The command is used to download AGPS data from TCP server. The AGPS data will be stored in the RAM of GSM part which means it will be lost after powering down GSM part and it is only valid in two hours. AT+ QGAGPS Download AGPS Data from Server Test Command AT+QGAGPS=? Execution Command Use the default server and port to download AGPS data. AT+QGAGPS Response OK Response OK +QGAGPS: MC25_GNSS_Protocol_Specification 21 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Write Command Use the specified server and port to download AGPS data. AT+QGAGPS=, If there is any error, response: +CME ERROR: Response OK +QGAGPS: If there is any error, response: +CME ERROR: Parameter String type. The address of the AGPS server. It could be a domain name or a dotted decimal IP address. The default server address is 'agnss.techtotop.com'. The port of the AGPS server. The default port is 9012. The result of downloading. 0 Successfully download the AGPS data 1 Failed to create socket 2 Failed to bind socket 3 Failed to read socket 4 Network error 5 DNS error 6 DNS timeout 7 Failed to connect server 8 Connect server timed out 9 Time of waiting for data 10 Data wrong 11 Server address error 3.6. AT+QGAGPSAID Inject AGPS Data to GNSS The command is used to inject the AGPS data to GNSS part. AT+QGAGPSAID Inject AGPS Data to GNSS Execution Command AT+QGAGPSAID Response OK If there is any error, response: +CME ERROR: MC25_GNSS_Protocol_Specification 22 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification NOTE The GNSS part must be power on before executing this command. 3.7. AT+QGREFLOC Set Reference Location Information for QuecFastFix Online The command is used to set reference location information for QuecFastFix Online function. AT+QGREFLOC Set Reference Location Information for QuecFastFix Online Test Command AT+QGREFLOC=? Response +QGREFLOC: , Read Command AT+QGREFLOC? OK Response +QGREFLOC: , Write Command AT+QGREFLOC=, OK Response OK If there is any error, response: +CME ERROR: Parameter Latitude information of the reference location. Range: -90°~90° north latitude. The input format of the parameter should retain 6 decimal places, and the unit is degree Longitude information of the reference location. Range: -180°~180° east longitude. The input format of the parameter should retain 6 decimal places, and the unit is degree NOTES 1. This command sends reference location to GNSS part immediately. 2. The GNSS part must be power on before executing this command. MC25_GNSS_Protocol_Specification 23 / 44 Example AT+QGREGLOC=? //Test command +QGREFLOC: , OK AT+QGREFLOC=31.507985,117.119750 OK GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification MC25_GNSS_Protocol_Specification 24 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 4 NMEA Packet Protocols This chapter introduces the NMEA packet protocols, which are a set of extension messages of standard NMEA packet protocols. These messages are used to control and configure the internal GNSS engine of MC25. The following tables show the structure of NMEA packet. 4.1. Packet Type: DFT This message is used to restore default settings. Data Field: $CCDFT,Mode,*Checksum Example: $CCDFT,0,*66 Response: None. Field Description $ Each NMEA message starts with ‘$’ CCDFT Mode * Restore default settings message The mode of restore ‘0’ = Restore all settings to default End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC25_GNSS_Protocol_Specification 25 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 4.2. Packet Type: SIR This message is used to set work and start mode. Data Field: $CCSIR,Type,Mode*Checksum Example: $CCSIR,3,1*4A Response: None. Field Description $ Each NMEA message starts with ‘$’ CCSIR Type Mode * Set work and startup mode message Work type ‘1’ = BeiDou ‘2’ = GPS ‘3’ = BeiDou+GPS ‘4’ = GLONASS ‘5’ = BeiDou+GLONASS ‘6’ = GPS+GLONASS Start mode ‘0’ = Auto mode ‘1’ = Cold start ‘2’ = Warm start ‘3’ = Hot start End character of data field Checksum Hexadecimal checksum Each NMEA message ends with ‘CR’ and ‘LF’ MC25_GNSS_Protocol_Specification 26 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 5 Hexadecimal Packet Protocols This chapter introduces the hexadecimal packet protocols, which are a set of extension messages of standard NMEA packet protocols. These messages are used to control and configure the internal GNSS engine of MC25. The following table shows the structure of hexadecimal packet, which is sent through AT commands. 5.1. Hexadecimal Packet Structure 5.1.1 Data Type All multibyte data is saved and transferred in little endian mode. The data type is defined in following table. Table 3: Data Type Name I8S I8U I16S I16U I32S I32U F32 F64 B8 B16 B32 CH Type signed char unsigned char signed short unsigned short signed int unsigned int single precision float double precision float bit field bit field bit field Char Byte 1 1 2 2 4 4 4 8 1 2 4 1 Code Complemental code IEEE 754 MC25_GNSS_Protocol_Specification 27 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 5.1.2 Data Frame Basic Structure Head (2 Bytes) Identifier (2 Bytes) Check range Data length (2 Bytes) Data (n Bytes) Checksum (2 Bytes) 5.1.3 Head The head includes 2-byte HEX values (0x23 and 0x3E), and the values are fixed. 5.1.4 Identifier The identifier includes 2-byte HEX values (Type and Function codes). For details, please refer to Chapter 5.2, 5.3, 5.4 and 5.5. 5.1.5 Data Length The data length is the number of data bytes. 5.1.6 Data The data is specifically defined by identifier. 5.1.7 Checksum The checksum is calculated by FletCher16. The check range includes identifier, data length and data. The reference code of FletCher16 is as follows: I16U FletCher16(const I8U* pbuf, I16U len) { I16U cs1,cs2; cs1= cs2= 0; while(len --) { cs1 += *pbuf++; cs2 += cs1; } return (cs2 << 8) | (cs1 & 0xFF); } MC25_GNSS_Protocol_Specification 28 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 5.2. General Protocols (0x01) 5.2.1 ACK (0x01) SDBP-PUB-ACK Type: Output Description This is the response if the command is valid and executed successfully. Structure Head Identifier 0x23 0x3E 0x01 0x01 Data Length 2 Data See below Checksum - Data No. Type Name Description This is the type code (included in the identifier) 1 I8U Type code of identifier of the command that has been sent. This is the function code (included in the 2 I8U Function code of identifier identifier) of the command that has been sent. 5.2.2 NACK (0x02) SDBP-PUB-NACK Type: Output Description This is the response if the command is invalid and executed failed. Structure Head Identifier 0x23 0x3E 0x01 0x02 Data Length 2 Data See below Checksum - Data No. Type Name Description This is the type code (included in the identifier) 1 I8U Type code of identifier of the command that has been sent. This is the function code (included in the 2 I8U Function code of identifier identifier) of the command that has been sent. MC25_GNSS_Protocol_Specification 29 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 5.3. Control Protocols (0x02) 5.3.1 RESET (0x01) SDBP-CTL-RESET Description Type: Input This command is used to restart the module. Module will response SDBP-PUB-NACK if the command is invalid. Structure Head Identifier 0x23 0x3E 0x02 0x01 Data Length 1 Data See below Checksum - Data No. Type 1 I8U Name The mode of start Description 0x01: Cold start 0x02: Warm start 0x03: Hot start 5.3.2 DEFAULT (0x02) SDBP-CTL-DEFAULT Description Type: Input This command is used to restore default settings. Module will response SDBP-PUB-ACK if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. Structure Head Identifier 0x23 0x3E 0x02 0x02 Data Length 1 Data See below Checksum - Data No. Type Name Description 1 B8 The bit of the default settings 0xFF: Restore all settings to default MC25_GNSS_Protocol_Specification 30 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 5.3.3 STANDBY (0x04) SDBP-CTL-STANDBY Description Type: Input The standby mode is a low power mode, and this command is used to enter into this mode. After entering into the mode, the chip will turn off the main power automatically and stop working, and will be woken up with a level change (rising or falling) of the specific pin (UART1_RX). Waking up the chip is equivalent to resetting it. Module will enter into standby mode if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. Structure Head Identifier 0x23 0x3E 0x02 0x04 Data Length 1 Data See below Checksum - Data No. Type Name 1 I8U Enable control Description 0x01: Enter into standby mode Other values: Reserved and no response 5.4. Setting Protocols (0x03) 5.4.1 GNSS (0x11) SDBP-CFG-GNSS Description Type: Input/Output This command is used to configure GNSS mode. Module will response SDBP-PUB-NACK if the command is invalid. Module will response SDBP-PUB-ACK if the command is valid, executed successfully, and RF does not need to be reconfigured. Module will be restarted and not respond if RF needs to be reconfigured. When GPS system is selected, the SBAS system is automatically turned on; when SBAS is not required, the SBAS control command needs to be sent to turn off the system. Structure Head Identifier 0x23 0x3E 0x03 0x11 Data Length 2 Data See below Checksum - Data MC25_GNSS_Protocol_Specification 31 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification No. Type 1 I8U 2 I8U Name GNSS mode Auto-save Description 1: BeiDou 2: GPS 3: BeiDou+GPS (SBAS is turned on) 4: GLONASS 5: BeiDou+GLONASS 6: GPS+GLONASS 1: Save to backup area Other values: not saved, and restore default values after power-on 5.4.2 QZSS (0x12) SDBP-CFG-QZSS Description Type: Input This command is used to turn on/off QZSS. Module will response SDBP-PUB-ACK if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. QZSS system must be used simultaneously with the GPS system. If GPS is turned off, QZSS is automatically turned off; after GPS is turned on, QZSS is turned on or off using control commands as needed. Structure Head Identifier 0x23 0x3E 0x03 0x12 Data Length 2 Data See below Checksum - Data No. Type Name 1 I8U QZSS switch 2 I8U Auto-save Description 0: Turn off QZSS 1: Turn on QZSS 1: Save to backup area Other values: not saved, and restore default values after power-on 5.4.3 SBAS (0x13) SDBP-CFG-SBAS Description Type: Input This command is used to turn on/off SBAS. Module will response SDBP-PUB-ACK if the command is valid and executed MC25_GNSS_Protocol_Specification 32 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Structure successfully, otherwise response SDBP-PUB-NACK. QZSS system must be used simultaneously with the GPS system. If GPS is turned off, QZSS is automatically turned off; after GPS is turned on, SBAS is automatically turned on, and will be turned off using control commands as needed. Head Identifier Data Length Data Checksum 0x23 0x3E 0x03 0x13 2 See below - Data No. Type 1 I8U 2 I8U Name SBAS switch Auto-save Description 0: Turn off SBAS 1: Turn on SBAS 1: Save to backup area. Other values: not saved, and restore default values after power-on 5.4.4 UART (0x21) SDBP-CFG-UART Description Type: Input This command is used to configure UART. Module will response SDBP-PUB-ACK if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. Default settings (UART1):  Baudrate: 9600bps  Data bit: 8bits  Stop bit: 1bit  Parity bit: None Structure Head Identifier 0x23 0x3E 0x03 0x21 Data Length 6 Data See below Checksum - Data No. Type 1 I8U 2 I8U Name UART port Baud rate Description 1: UART1 2: UART2 1: 4800 2: 9600 3: 19200 4: 38400 MC25_GNSS_Protocol_Specification 33 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 3 I8U 4 I8U 5 I8U 6 I8U None None None Auto-save 5: 57600 6: 115200 7: 230400 Reserved Reserved Reserved 1: Save to backup area Other values: not saved, and restore default values after power-on NOTE This system does not support the modification of data bits, stop bits, and parity bits. 5.4.5 DYNAMIC (0x31) SDBP-CFG-DYNAMIC Description Type: Input This command is used to configure motion mode. Module will response SDBP-PUB-ACK if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. When the mode changes, the module automatically restarts. 1. Adaptive mode: maximum speed 340m/s, maximum altitude 15000m, maximum acceleration 2g. 2. Static mode: maximum speed 5m/s, maximum altitude 15000m. 3. Walking mode: maximum speed 10m/s, maximum altitude 15000m. 4. Automotive mode: maximum speed 150m/s, maximum altitude 15000m. 5. Ship mode: maximum speed 50m/s, maximum altitude 1000m. Structure Head Identifier 0x23 0x3E 0x03 0x31 Data Length 2 Data See below Checksum - Data No Type 1 I8U Name Motion mode Description 1: Adaptive 2: Static 3: Walking 4: Automotive MC25_GNSS_Protocol_Specification 34 / 44 2 I8U Auto-save GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 5: Ship 1: Save to backup area Other values: not saved, and restore default values after power-on NOTES 1. Adaptive mode covers static, walking, and automotive modes. If ship mode is used, it must be configured independently. 2. Set the correct mode according to the corresponding usage, which can effectively improve positioning precision. 5.4.6 FIX (0x32) SDBP-CFG-FIX Description Type: Input This command is used to configure fix mode. Module will response SDBP-PUB-ACK if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. Structure Head Identifier 0x23 0x3E 0x03 0x32 Data Length 11 Data See below Checksum - Data No. Type Name Scale Unit Description 1: 2D mode 1 I8U Fix mode 2: 3D mode - - 3: 2D/3D automatic switching mode Only for 2D/3D automatic 2 I8U First fix mode switching mode - - 0: 2D mode 1: 3D mode Only for 2D mode 3 I32S Reference altitude 10-2 m Default: 0m Reference altitude Variance, only for 2D mode 4 I32U 10-4 m precision Default: 0.0m 1: Save to backup area 5 I8U Auto-save - - Other values: not saved, and restore default values after MC25_GNSS_Protocol_Specification 35 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification power-on 5.4.7 SV (0x33) SDBP-CFG-SV Description Type: Input This command is used to configure the satellite selected for positioning. The module will response SDBP-PUB-ACK if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK.. Structure Head Identifier 0x23 0x3E 0x03 0x33 Data Length 4 Data See below Checksum - Data No. Type Name Ratio Unit Description The maximum quantity of 4 ≤ Satellite quantity ≤ 20 1 I8U satellites participating in the - - Default: 20 positioning solution Minimum satellite elevation 0 ≤ Elevation angle ≤ 90 2 I8U angle participating in - Degree Default: 5 positioning solution Minimum signal strength 0 ≤ Signal strength ≤ 54 3 I8U (C/N0) participating in - dB/Hz Default: 5 positioning solution 1: Save to backup area. 4 I8U Auto-save Other values: not saved, - - restore default vales after power-on 5.4.8 INTERVAL (0x35) SDBP-CFG-INTERVAL Description Type: Input This command is used to configure positioning interval. The module will response SDBP-PUB-ACK if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. The continuous positioning and navigation process is shown in the figure below. MC25_GNSS_Protocol_Specification 36 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Structure When the solution time TN required for the solution moment N is greater than positioning time interval T, system automatically cancels the solution process from positioning moment TN+1 to the positioning moment TN+X until the process is completed, and then the solution of positioning moment TN+X+1 is started. Therefore, when the positioning time interval T is short (the positioning frequency is high) and the solution time is long (the amount of calculation is large, and the number of elements participating in the solution is too large), the navigation output interval does not match the set positioning interval. If the navigation output interval is required to match the positioning interval, the appropriate positioning interval T or solution time needs to be adjusted (use SDBP-CFG-GNSS command to reduce the satellite system used, and use SDBP-CFG-SV command to reduce the number of satellites used for positioning solution). Head Identifier Data Length Data Checksum 0x23 0x3E 0x03 0x35 3 See below - Data No. Type Name 1 I16U Positioning interval 2 I8U Auto-save Ratio - - Unit Description 100 ≤ Interval ≤ 60000; ms An integer multiple of 100; Default: 1000 1: Save to backup area. Other values: not saved, restore default vales after power-on 5.4.9 PPS (0x41) SDBP-CFG-PPS Description Type: Input This command is used to configure PPS. Module will response SDBP-PUB-ACK if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. Default settings (PPS0): PPS0: Switch = 1; Output Mode = 1; Pulse Polarity = 0; Period = 1000; Pulse Width = 100; Offset = 0. Structure Head Identifier Data Length Data Checksum MC25_GNSS_Protocol_Specification 37 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 0x23 0x3E 0x03 0x41 18 See below - Data No. Type Name Ratio Unit Description 1 I8U Serial number - - 0: PPS0 2 I8U Switch 0: Turn off PPS - - 1: Turn on PPS 3 I8U Output mode 0: Output after power-on - - 1: Output after fix 4 I8U Pulse polarity 0: Negative - - 1: Positive 0: UTC 1: BeiDou 5 I8U GNSS time standard 1) - - 2: GPS 3: GLONASS 6 I32U Period - ms ≥ 10ms 7 I32U Pulse width - ms 8 I32S 9 I8U Offset Auto-save - ns 1: Save to backup area. Other values: not saved, and - - restore default values after power-on NOTE 1) The firmware version of MC25 does not support the adjustment of GNSS time standard, which is fixed to UTC. 5.4.10 NMEA (0x51) SDBP-CFG-NMEA Description Type: Input This command is used to configure NMEA active output statement. Module will response SDBP-PUB-ACK if the command is valid and executed successfully otherwise response SDBP-PUB-NACK. Structure Head Identifier Data Length Data Checksum MC25_GNSS_Protocol_Specification 38 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 0x23 0x3E 0x03 0x51 4 See below - Data No. Type Name Description 0x01: ZDA 0x02: DTM 0x03: RMC 0x04: GGA 0x05: GSA 0x06: GSV 1 I8U Sentence ID 0x07: VTG 0x08: GNS 0x09: GLL 0x0A: GRS 0x0B: GST 0x0C: GBS 0x0D: TXT 1: UART1 2 I8U Output port 2: UART2 0: Turn off the output. 1~N: Integer multiple of the positioning 3 I8U Output frequency frequency. Example: 2 means positioning twice and output once. 1: Save to backup area 4 I8U Auto-save Other values: not saved, and restore default values after power-on. 5.5. Query Protocols (0x05) 5.5.1 GNSS (0x02) SDBP-QUE-GNSS Description Type: Input This command is used to query GNSS configuration information. Module will response the queried result if the command is valid and executed successfully, otherwise response SDBP-PUB-NACK. Structure Head Identifier Data Length Data Checksum MC25_GNSS_Protocol_Specification 39 / 44 0x23 0x3E 0x05 0x02 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 0 - - SDBP-QUE-GNSS Type: Output Description This is the GNSS configuration information queried. Structure Head Identifier 0x23 0x3E 0x05 0x02 Data Length 3 Data See below Checksum - Data No. Type 1 B8 2 B8 3 B8 Name BeiDou state GPS state GLONASS state Description BIT[0]: 0: Turn off BeiDou; 1: Turn on BeiDou BIT[1~7]: Reserved BIT[0]: 0: Turn off GPS; 1: Turn on GPS BIT[1]: 0: Turn off SBAS; 1: Turn on SBAS BIT[2]: 0: Turn off QZSS; 1: Turn on QZSS BIT[3~7]: Reserved BIT[0]: 0: Turn off GLONASS; 1: Turn on GLONASS BIT[1~7]: Reserved MC25_GNSS_Protocol_Specification 40 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 6 Default Configurations Table 4: Default Configurations Item NMEA Port Baud Rate Datum Rate of Position Fixing DGPS Mode SBAS NMEA Output Messages Default 9600bps WGS84 1Hz SBAS Enabled RMC, GGA, GSA, GSV, VTG and GLL MC25_GNSS_Protocol_Specification 41 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification 7 Appendix A References Table 5: Related Document SN Document Name [1] Quectel_MC25_Hardware_Design Remark MC25 Hardware Design Table 6: Terms and Abbreviations Abbreviation AGPS Description Assisted Global Positioning System BeiDou CS DGPS GGA GLL GLONASS GNSS Chinese Satellite Navigation System Commercial Sample Differential Global Positioning System NMEA: Global Positioning System Fix Data NMEA: Geographic Position in Latitude and Longitude GLObalnaya NAvigatsionnaya Sputnikovaya Sistema, the Russian Global Navigation Satellite System Global Navigation Satellite System GPS GSA GSV Global Positioning System NMEA: GNSS DOP and Active Satellites NMEA: GNSS Satellites in View HDOP MP NMEA Horizontal Dilution of Precision Mass Production National Marine Electronics Association NITZ Network Identity and Time Zone MC25_GNSS_Protocol_Specification 42 / 44 PDOP QZSS RMC SBAS UTC VDOP VTG WAAS GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Position Dilution of Precision Quasi-Zenith Satellite System NMEA: Recommended Minimum Specific GNSS Data Satellite-Based Augmentation System Universal Time Coordinated Vertical Dilution of Precision NMEA: Course Over Ground and Ground Speed Wide Area Augmentation System Table 7: Structure of NMEA Message Filed Length (Bytes) Description $ 1 Each NMEA message starts with ‘$’ Talker ID NMEA Message ID Data Field Talker IDs can be ‘GP’, ‘GN’, ‘BD’ and ‘GL’ when the message ID is RMC, VTG, GLL ,GGA and GSA; Talker 1~2 IDs can be ‘GP’, ‘GL’ and ‘BD’ when the message ID is GSV. 3 NMEA message ID. Variable, and depends on the Data fields, delimited by comma ‘,’. NMEA message type * 1 End character of data field. Checksum 2 A hexadecimal number calculated by exclusive OR of all characters between ‘$’ and ‘*’. 2 Each NMEA message ends with ‘CR’ and ‘LF’. NOTE The default output messages of MC25 are as following six sentences: RMC, VTG, GGA, GSA, GSV and GLL. MC25_GNSS_Protocol_Specification 43 / 44 GSM/GPRS/GNSS Module Series MC25 GNSS Protocol Specification Table 8: Talker ID Display in Different GNSS System (for NMEA 0183 4.10 Version) Talker ID GGA GPS Only GP GLONASS GPS+ GPS+ GLONASS+ BeiDou Only Only GLONASS BeiDou BeiDou BD GL GN GN GN RMC GP BD GL GN GN GN GLL GP BD GL GN GN GN VTG GP BD GL GN GN GN GSA GP BD GL GN GN GN GSV GP BD GL GP+GL GP+BD GL+BD Table 9: Different Coding Schemes of +CME ERROR Related to GNSS: Code of 7101 7102 7103 7105 Meaning Invalid parameter Not supported Operation failed No enough memory MC25_GNSS_Protocol_Specification 44 / 44

LG77L (C)&Lx0&Lx6&LC86L Series GNSS Protocol Specification GNSS Module Series Version: 2.2 Date: 2024-03-29 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 1 / 101 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2024. All rights reserved. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 2 / 101 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LG77L (C)&Lx0&Lx6&LC86L Series GNSS Protocol Specification GNSS Module Series GNSS Protocol Specification Released Revision History Version Date 1.0 2019-05-15 1.1 2020-03-07 2.0 2021-11-30 Description Initial 1. Added applicable modules L26-LB and LC86L 2. Deleted the following packet types: ⚫ 300 PMTK_API_SET_FIX_CTL ⚫ 458 PMTK_API_GET_POS_XYZ ⚫ 461 PMTK_API_GET_VEL_XYZ 3. Updated NMEA standard messages according to NMEA V4.10 4. Updated the following packet types: ⚫ 001 PMTK_ACK ⚫ 225 PMTK_SET_PERIODIC_MODE ⚫ 183 PMTK_LOCUS_QUERY_STATUS 1. Updated the overall structure of the document. 2. Added LG77L, L26, L76, L76-L, L86, L96, L70 and L80 as the applicable modules of this document. 3. Added GBS and DTM messages (Chapter 2.2.8 and Chapter 2.2.9). 4. Updated NMEA Talker ID (Table 2). 5. Added a new note for the parameter in the Query Result Message returned with PMTK_LOCUS_QUERY_STATUS (Chapter 2.3.9). LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 3 / 101 GNSS Module Series Version Date 2.1 2022-04-01 2.2 2024-03-09 Description 6. Detailed the description for the parameter in PMTK_SET_POS_FIX (Chapter 2.3.12). 7. Added range and default value for the parameter in PMTK_SET_AL_DEE_CFG (Chapter 2.3.13). 8. Added the default value for the parameter in PMTK_SET_PPS_CONFIG (Chapter 2.3.18). 9. Added new notes for PMTK_API_SET_DGPS_MODE (Chapter 2.3.20). 10. Added PQ messages (Chapter 2.4). 11. Deleted the following packet types: ⚫ 400 PMTK_API_Q_FIX_CTL ⚫ 500 PMTK_DT_FIX_CTL 1. Updated the note for NMEA Talker ID (Chapter 2.1). 2. Added PQVERNO message (Chapter 2.4.17). 1. Deleted the EOL products: LG77L (A, B). 2. Added the table about Supported protocol (Chapter 1). 3. Added the NMEA Checksum Sample Code (Chapter 2.1). 4. Updated some parameter descriptions and examples of standard NMEA messages (Chapter 2.2). 5. Updated the range of repeat times of , , and (Chapter 2.2.3). 6. Added ZDA, GRS and GST messages and updated some reserved parameters to ,, and (Chapters 2.2.10 to 2.2.12, Chapters 2.3.24 and 2.3.35). 7. Updated the message type of $PMTK 183 message (Chapter 2.3.9). 8. Added a note that when is 0, the fields after can be omitted (Chapter 2.3.14). 9. Updated the notes for $PMTK311 and $PQGEO commands (Chapters 2.3.22 and 2.4.14). 10. Added the notes for $PMTK353, $PMTK355, $PMTK622, $PMTKSPF and $PQRLM commands (Chapters 2.3.27, 2.3.28, 2.3.37, 2.3.43 and 2.4.13). 11. Added $PMTK355 message (Chapter 2.3.28). 12. Updated the message types and added the results of $PMTK401, $PMTK413, $PMTK414 and $PMTK605 commands (Chapters 2.3.30, 2.3.31, 2.3.32, and 2.3.36). 13. Updated the message types and results of $PMTK869 and $PMTK875 commands (Chapters 2.3.40 and 0). 14. Updated the GNSS Numbering and added notes (Chapter 4). LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 4 / 101 GNSS Module Series Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 7 1 Introduction .......................................................................................................................................... 8 2 NMEA Protocol ................................................................................................................................... 10 2.1. Structure of NMEA Protocol Messages .................................................................................... 10 2.2. Standard Messages .................................................................................................................. 12 2.2.1. RMC ............................................................................................................................... 12 2.2.2. GGA................................................................................................................................ 15 2.2.3. GSV ................................................................................................................................ 17 2.2.4. GSA ................................................................................................................................ 19 2.2.5. VTG ................................................................................................................................ 20 2.2.6. GLL................................................................................................................................. 22 2.2.7. TXT................................................................................................................................. 24 2.2.8. GBS ................................................................................................................................ 25 2.2.9. DTM................................................................................................................................ 27 2.2.10. ZDA ................................................................................................................................ 28 2.2.11. GRS................................................................................................................................ 29 2.2.12. GST ................................................................................................................................ 31 2.3. PMTK Messages....................................................................................................................... 33 2.3.1. PMTK001 PMTK_ACK................................................................................................... 33 2.3.2. PMTK010 PMTK_SYS_MSG......................................................................................... 34 2.3.3. PMTK011 PMTK_TXT_MSG ......................................................................................... 34 2.3.4. PMTK101 PMTK_CMD_HOT_START........................................................................... 35 2.3.5. PMTK102 PMTK_CMD_WARM_START ....................................................................... 35 2.3.6. PMTK103 PMTK_CMD_COLD_START ........................................................................ 36 2.3.7. PMTK104 PMTK_CMD_FULL_COLD_START ............................................................. 36 2.3.8. PMTK161 PMTK_CMD_STANDBY_MODE .................................................................. 37 2.3.9. PMTK183 PMTK_LOCUS_QUERY_STATUS ............................................................... 37 2.3.10. PMTK184 PMTK_LOCUS_ERASE_FLASH ................................................................. 39 2.3.11. PMTK185 PMTK_LOCUS_STOP_LOGGER ................................................................ 39 2.3.12. PMTK220 PMTK_SET_POS_FIX.................................................................................. 40 2.3.13. PMTK223 PMTK_SET_AL_DEE_CFG ......................................................................... 41 2.3.14. PMTK225 PMTK_SET_PERIODIC_MODE................................................................... 42 2.3.15. PMTK251 PMTK_SET_NMEA_BAUDRATE ................................................................. 43 2.3.16. PMTK255 PMTK_SET_SYNC_PPS_NMEA ................................................................. 43 2.3.17. PMTK256 PMTK_SET_TIMING_PRODUCT ................................................................ 44 2.3.18. PMTK285 PMTK_SET_PPS_CONFIG.......................................................................... 45 2.3.19. PMTK286 PMTK_SET_AIC_ENABLED ........................................................................ 45 2.3.20. PMTK301 PMTK_API_SET_DGPS_MODE .................................................................. 46 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 5 / 101 GNSS Module Series 2.3.21. PMTK306 PMTK_API_SET_MIN_SNR ......................................................................... 47 2.3.22. PMTK311 PMTK_API_SET_ELEV_MASK .................................................................... 48 2.3.23. PMTK313 PMTK_API_SET_SBAS_ENABLED ............................................................ 48 2.3.24. PMTK314 PMTK_API_SET_NMEA_OUTPUT.............................................................. 49 2.3.25. PMTK351 PMTK_API_SET_SUPPORT_QZSS_NMEA ............................................... 51 2.3.26. PMTK352 PMTK_API_SET_STOP_QZSS ................................................................... 52 2.3.27. PMTK353 PMTK_API_SET_GNSS_SEARCH_MODE................................................. 53 2.3.28. PMTK355 PMTK_API_GET_GNSS_SEARCH_MODE ................................................ 54 2.3.29. PMTK386 PMTK_API_SET_STATIC_NAV_THD .......................................................... 55 2.3.30. PMTK401 PMTK_API_Q_DGPS_MODE ...................................................................... 56 2.3.31. PMTK413 PMTK_API_Q_SBAS_ENABLED................................................................. 56 2.3.32. PMTK414 PMTK_API_Q_NMEA_OUTPUT .................................................................. 57 2.3.33. PMTK501 PMTK_DT_DGPS_MODE ............................................................................ 58 2.3.34. PMTK513 PMTK_DT_SBAS_ENABLED....................................................................... 58 2.3.35. PMTK514 PMTK_DT_NMEA_OUTPUT ........................................................................ 59 2.3.36. PMTK605 PMTK_Q_RELEASE..................................................................................... 60 2.3.37. PMTK622 PMTK_Q_LOCUS_DATA.............................................................................. 61 2.3.38. PMTK705 PMTK_DT_RELEASE................................................................................... 62 2.3.39. PMTK838 PMTK_TEST_ANTI_SPOOFING ................................................................. 62 2.3.40. PMTK869 PMTK_EASY_ENABLE ................................................................................ 64 2.3.41. PMTK875 PMTK_PMTKLSC_STN_OUTPUT............................................................... 65 2.3.42. PMTK886 PMTK_FR_MODE ........................................................................................ 67 2.3.43. PMTKSPF ...................................................................................................................... 68 2.4. PQ Messages............................................................................................................................ 69 2.4.1. PQBAUD ........................................................................................................................ 69 2.4.2. PQEPE ........................................................................................................................... 70 2.4.3. PQ1PPS ......................................................................................................................... 71 2.4.4. PQFLP............................................................................................................................ 73 2.4.5. PQTXT ........................................................................................................................... 74 2.4.6. PQECEF......................................................................................................................... 75 2.4.7. ECEFPOSVEL ............................................................................................................... 76 2.4.8. PQODO .......................................................................................................................... 77 2.4.9. PQPZ90.......................................................................................................................... 79 2.4.10. PQGLP ........................................................................................................................... 81 2.4.11. PQVEL ........................................................................................................................... 82 2.4.12. PQJAM ........................................................................................................................... 84 2.4.13. PQRLM........................................................................................................................... 85 2.4.14. PQGEO .......................................................................................................................... 87 2.4.15. PQPREC ........................................................................................................................ 93 2.4.16. PQGBS........................................................................................................................... 94 2.4.17. PQVERNO ..................................................................................................................... 96 3 Appendix A References..................................................................................................................... 97 4 Appendix B GNSS Numbering........................................................................................................ 100 5 Appendix C Special Characters ..................................................................................................... 101 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 6 / 101 GNSS Module Series Table Index Table 1: Applicable Modules and Constellations Supported........................................................................ 8 Table 2: Supported Protocol......................................................................................................................... 9 Table 3: Structure of NMEA Protocol Messages ........................................................................................ 10 Table 4: NMEA Talker ID .............................................................................................................................11 Table 5: Terms and Abbreviations .............................................................................................................. 97 Table 6: GNSS Numbering ....................................................................................................................... 100 Table 7: Special Characters ..................................................................................................................... 101 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 7 / 101 GNSS Module Series 1 Introduction Quectel L70, L80, L26, L76, L76-L, L86, L96, L26-LB, L76-LB, LC86L (A, B, C) and LG77L (C) are multiconstellation modules. See Table 1: Applicable Modules and Constellations Supported on the actual constellations supported on each applicable module. Also, they support autonomous GNSS C/A code, SBAS function (including WAAS, EGNOS, MSAS and GAGAN) and AGNSS (EASY function). The tracking of GPS L1 C/A, GLONASS L1, BDS B1, QZSS L1, Galileo E1 frequency bands provides fast and accurate acquisition and makes those modules an ideal solution for positioning and navigation in various vertical markets. This document describes the software commands that are needed to control and modify the module configuration. The software commands are NMEA proprietary commands defined by the chipset supplier (PMTK commands) and Quectel (PQ commands). To report GNSS information, the modules support output messages in NMEA 0183 standard protocol. Table 1: Applicable Modules and Constellations Supported Module Family Module Series Lx0 - - - - Lx6 - - - - - LC86L Model L70 L80 L26 L76 L76-L L86 L96 L26-LB L76-LB LC86L (A) LC86L (B) Constellation GPS + QZSS GPS + QZSS GPS + GLONASS + Galileo + BDS + QZSS GPS + GLONASS + Galileo + BDS + QZSS GPS + GLONASS + Galileo + BDS + QZSS GPS + GLONASS + Galileo + BDS + QZSS GPS + GLONASS + Galileo + BDS + QZSS GPS + GLONASS + BDS + QZSS GPS + GLONASS + BDS + QZSS GPS + GLONASS + BDS + QZSS GPS + GLONASS + BDS + QZSS LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 8 / 101 GNSS Module Series Module Family Module Series - - Model LC86L (C) LG77L (C) Constellation GPS + GLONASS + Galileo + BDS + QZSS GPS + GLONASS + Galileo + BDS + QZSS The modules support the following protocols: Table 2: Supported Protocol Protocol NMEA 0183 V4.10 Type Output, ASCII, standard Input/output, ASCII, proprietary NOTE Quectel assumes no responsibility if commands other than the ones listed herein are used. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 9 / 101 GNSS Module Series 2 NMEA Protocol 2.1. Structure of NMEA Protocol Messages Start of sentence character. Always Address field - contains talker identifier and sentence formatter Starts with a * 8-bit checksum value converted to two ASCII characters Data field(s), delimited by , End of sentence. Always $ () [,] * Range for checksum calculation Figure 1: Structure of NMEA Protocol Messages Table 3: Structure of NMEA Protocol Messages Field $ Description Start of the sentence (Hex 0x24). In Standard Messages: In standard messages, this field consists of a two-character talker identifier (TalkerID) and a three-character sentence formatter (SentenceFormatter). The talker identifier identifies the type of talker. For more information on the TalkerID, see Table 4: NMEA Talker ID. The sentence formatter identifies the data type and the string format of the successive fields. In Proprietary Messages: In proprietary messages, this field consists of the proprietary character P followed by a three-character Manufacturer's Mnemonic Code, used to identify the TALKER issuing a proprietary sentence, and any additional characters as required. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 10 / 101 GNSS Module Series Field Description Data fields, delimited by the data field delimiter ‘,’. Variable length (depending on the NMEA message type). Checksum field follows the checksum delimiter character *. Checksum is the 8-bit exclusive OR of all characters in the sentence, including ‘,’ the field delimiter, between but not including the $ and the * delimiters. End of sentence (Hex 0x0D 0x0A). Table 4: NMEA Talker ID GNSS Constellation Configuration GPS GLONASS Galileo BDS QZSS Combination of Multiple Satellite Systems TalkerID (NMEA 0183 V4.10) GP GL GA BD QZ GN NMEA Checksum Sample Code: // pData is the data array of which the checksum needs to be calculated: unsigned char Ql_Check_XOR(const unsigned char *pData, unsigned int Length) { unsigned char result = 0; unsigned int i = 0; if((NULL == pData) || (Length < 1)) { return 0; } for(i = 0; i < Length; i++) { result ^= *(pData + i); } return result; } LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 11 / 101 GNSS Module Series NOTE On L26, L76, L76-L, L86 and L96, the Talker ID in the following listed messages has been modified to be compatible with the previous protocol versions and the Talker ID in other standard NMEA messages. Unless otherwise specified, the Talker ID complies with the rules listed in Table 4: NMEA Talker ID. 1. The Talker ID listed the messages when the position is fixed. Constellation RMC GGA GSA GLL VTG GPS + GLONASS GN GP GN GN GP GPS + BDS GP GP GP GP GP GPS + Galileo GN GP GN GN GP GPS + GLONASS + Galileo GN GP GN GN GP 2. The Talker ID is always GP when the position is unfixed. 2.2. Standard Messages This chapter explains the standard NMEA 0183 V4.10 messages supported by the modules. 2.2.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type: Output Synopsis: $RMC,,,,,,,,,,,,,* Parameter: Field $ Format Unit Character - String, 2 characters - Example $ GN Description Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 12 / 101 GNSS Module Series Field RMC Format Unit Example Description String, 3 characters - hhmmss.sss - Character - ddmm.mmmmmm - Character - dddmm.mmmmmm - Character - RMC Recommended Minimum Specific GNSS Data. Position fix UTC. hh: Hours (00–23) 080608.000 mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status. A A = Data valid V = Navigation receiver warning Latitude. dd: Degrees (00–90) mm: Minutes (00–59) 3029.461489 mmmmmm: Decimal fraction of minutes. (variable length 4 to 6 digits) Note that this field is empty in case of an invalid value. North-south direction. N = North N S = South Note that this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) 11430.07200 mmmmmm: Decimal fraction of 2 minutes. (variable length 4 to 6 digits) Note that this field is empty in case of an invalid value. East-west direction. E = East E W = West Note that this field is empty in case of an invalid value. Numeric Knot 0.00 Speed over ground. Variable length. Numeric ddmmyy Degree 148.41 - 210423 Course over ground. Variable length. Maximum value: 359.99 Date. dd: Day of month mm: Month yy: Year LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 13 / 101 GNSS Module Series Field Format - - Character Character Hexadecimal Character Unit Example Description - - - - - D - V - *09 Magnetic variation. Not supported. Direction of magnetic variation. Not supported. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) E = Estimated (dead reckoning) mode N = No fix. Satellite system not used in position fix, or fix not valid Navigational status. Not supported. Always 'V' (Navigational status not valid). Checksum. - - Carriage return and line feed. Example: Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GNRMC,080608.000,A,3029.461489,N,11430.072002,E,0.00,148.41,210423,,,D,V*09 //GPS only mode: $GPRMC,072316.000,A,3029.464977,N,11430.067548,E,0.00,5.09,230423,,,D,V*10 NOTE The length of minutes decimal fraction is 4 digits in and when RMC is supported by L26, L76, L76-L, L86, L96, L70 and L80 modules. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 14 / 101 GNSS Module Series 2.2.2. GGA Global Positioning System Fix Data. Time, position, and fix-related data for a GNSS receiver. Type: Output Synopsis: $GGA,,,,,,,,,,M,,M,,* Parameter: Field $ GGA Format Unit Character - String, 2 characters - String, 3 characters - hhmmss.sss - ddmm.mmmmmm - Character - dddmm.mmmmmm - Example Description $ Each NMEA message starts with $. GN GGA 072741.000 3029.463944 N 11430.070240 Talker identifier. See Table 4: NMEA Talker ID. Global Positioning System Fix Data. Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Latitude. dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes (variable length, 4 to 6 digits) Note that this field is empty in case of an invalid value. North-south direction. N = North S = South Note that this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) mm: Minutes (00–59) mmmmmm: Decimal fraction of LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 15 / 101 GNSS Module Series Field Format Unit Example Character - E Numeric, 1 digit - 2 1) Numeric, 2 digits - 17 Numeric - 0.64 M Numeric Character Meter 141.895 - M Numeric Meter -13.122 M Character - - M - - - - Description minutes (variable length, 4 to 6 digits) Note that this field is empty in case of an invalid value. East-west direction. E = East W = West Note that this field is empty in case of an invalid value. GPS quality indicator. 0 = Fix not available or invalid 1 = GPS SPS Mode, fix valid 2 = Differential GPS, SPS Mode, or Satellite Based Augmentation System (SBAS), fix valid 6 = Estimated (dead reckoning) mode Number of satellites in use. Horizontal dilution of precision. Note that this field is empty in case of an invalid value. Altitude above mean-sea-level (geoid). Note that this field is empty in case of an invalid value. Unit of . 'M' = Meter. Geoid separation (the difference between the earth ellipsoid surface and the mean-sea-level (geoid) surface defined by the reference datum used in the position solution). Note that this field is empty in case of an invalid value. Unit of . 'M' = Meter. Differential GPS data age. Not supported. Differential reference station ID. Not supported. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 16 / 101 GNSS Module Series Field Format Hexadecimal Character Unit Example - *5A - - Description Checksum. Carriage return and line feed. Example: Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GNGGA,072741.000,3029.463944,N,11430.070240,E,2,17,0.64,141.895,M,-13.122,M,,*5A //GPS only mode: $GPGGA,072357.000,3029.464977,N,11430.067548,E,1,11,0.90,142.212,M,-13.122,M,,*41 NOTE 1. The NMEA 0183 specification indicates that the GGA messages are GPS specific. However, when the receiver is configured for multi-constellations, the content of GGA message will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12. 3. The length of minutes decimal fraction is 4 digits in and when the GGA message is supported by L26, L76, L76-L, L86, L96, L70 and L80 modules. 4. The length of minutes decimal fraction is 1 digit in and when the GGA message is supported by L26, L76, L76-L, L86, L96, L70 and L80 modules. 2.2.3. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value, and contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of sentences being transmitted and the sentence number are indicated in the first two data fields. Type: Output Synopsis: $GSV,,,{,,,,}, * LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 17 / 101 GNSS Module Series Parameter: Field Format Unit Example Description $ Character - String, 2 characters - GSV String, 3 characters - Numeric - Numeric - Numeric - $ GP GSV 3 1 11 Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. GNSS Satellites in view. Total number of sentences. Range: 1–9. Sentence number. Range: 1–. Total number of satellites in view. Start of repeat block. Repeat times: 0–4. Numeric - 19 Numeric Degree 67 Numeric Numeric End of repeat block. Numeric Hexadecimal Degree 075 dB-Hz 44 - 1 - *60 Satellite ID. See Table 6: GNSS Numbering. Satellite elevation. Range: 00–90. Note that this field is empty in case of an invalid value. Satellite azimuth, with true north as the reference plane. Range: 000–359. Note that this field is empty in case of an invalid value. Satellite C/N0. Range 00–99. Null when not tracking. GNSS signal ID. See Table 6: GNSS Numbering. Checksum. Character - - Carriage return and line feed. Example: Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GPGSV,3,1,12,19,68,070,41,06,57,003,18,17,50,104,40,11,41,290,39,1*69 $GPGSV,3,2,12,50,41,130,33,20,37,226,38,09,28,096,38,12,27,308,37,1*61 $GPGSV,3,3,12,04,17,064,,05,11,219,31,14,10,168,,03,02,039,,1*6A $QZGSV,1,1,02,03,64,068,38,02,30,166,29,1*75 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 18 / 101 GNSS Module Series $GLGSV,1,1,04,67,50,135,28,66,39,054,44,80,29,268,32,79,16,213,29,1*72 //GPS only mode: $GPGSV,3,1,11,19,67,075,44,06,56,006,45,17,49,107,44,42,44,136,,1*60 $GPGSV,3,2,11,11,42,292,42,20,38,227,42,09,29,094,42,12,28,307,40,1*64 $GPGSV,3,3,11,04,16,063,24,05,12,220,28,14,08,168,,1*5A NOTE GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, GSV sentence are output with the corresponding talker ID for each constellation, respectively. 2.2.4. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA sentence, and DOP values. Type: Output Synopsis: $GSA,,,{},,,* Parameter: Field $ GSA Format Unit Character - String, 2 characters - String, 3 characters - Character - Numeric - Example Description $ GN GSA A 3 Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. GNSS DOP and Active Satellites. Selection of 2D or 3D fix. M = Manual, forced to operate in 2D or 3D mode A = Automatic, allowed to automatically switch to 2D or 3D mode Fix mode. 1 = Fix not available 2 = 2D 3 = 3D LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 19 / 101 GNSS Module Series Field Format Unit Start of repeat block. Repeat times: 12. Numeric - End of repeat block. Numeric - Numeric - Numeric - Numeric - Hexadecimal - Character - Example Description ID numbers of satellites used in solution. 30 See Table 6: GNSS Numbering. Position dilution of precision. 1.30 Maximum value: 99.99. Horizontal dilution of precision. 0.67 Maximum value: 99.99. Vertical dilution of precision. 1.12 Maximum value: 99.99. GNSS system ID. 1 See Table 6: GNSS Numbering. *00 Checksum. - Carriage return and line feed. Example: Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GNGSA,A,3,30,01,04,07,08,195,16,194,21,27,09,,1.30,0.67,1.12,1*00 $GNGSA,A,3,87,76,78,88,77,68,67,,,,,,1.30,0.67,1.12,2*0D //GPS only mode: $GPGSA,A,3,30,14,19,17,03,06,,,,,,,1.32,0.99,0.87,1*1D NOTE If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used for navigation, only the IDs of the first 12 are output. 2.2.5. VTG Course Over Ground & Ground Speed. The actual course and speed relative to the ground. Type: Output LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 20 / 101 GNSS Module Series Synopsis: $VTG,,T,,M,,N,,K,* Parameter: Field Format Unit Example Description $ VTG T M Character - $ String, 2 characters - GN String, 3 characters - VTG Numeric Degree 191.88 Character - T Numeric Degree - Character - M Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. Course Over Ground & Ground Speed. Course over ground, in true north course direction. Fixed field: true. Course over ground (magnetic). Not supported. Fixed field: magnetic. Numeric Knot 0.14 Speed over ground in knots. N K Character Numeric Character Character Hexadecimal - N km/h 0.26 - K - A - *2B Fixed field: knot. Speed over ground in kilometers per hour. Fixed field: kilometers per hour. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) E = Estimated (dead reckoning) mode M = Manual input mode N = Data not valid Checksum. Character - - Carriage return and line feed. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 21 / 101 GNSS Module Series Example: Take LC86L (B) for example: //GPS + GLONASS +QZSS mode: $GNVTG,191.88,T,,M,0.14,N,0.26,K,A*2B //GPS only mode: $GPVTG,321.97,T,,M,0.00,N,0.00,K,A*33 2.2.6. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type: Output Synopsis: $GLL,,,,,,,* Parameter: Field $ GLL Format Unit Example Description Character - String, 2 characters - String, 3 characters - ddmm.mmmmmm - Character - dddmm.mmmmmm - $ Each NMEA message starts with $. GN GLL 3029.465454 N 11430.074441 Talker identifier. See Table 4: NMEA Talker ID. Geographic Position – Latitude/Longitude. Latitude. dd: Degrees (00–90) mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes (variable length, 4 to 6 digits) Note that this field is empty in case of an invalid value. North-south direction. N = North S = South Note that this field is empty in case of an invalid value. Longitude. ddd: Degrees (000–180) LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 22 / 101 GNSS Module Series Field Format Character hhmmss.sss Character Character Hexadecimal Character Unit Example - E - 020549.000 - A - A - *42 - - Description mm: Minutes (00–59) mmmmmm: Decimal fraction of minutes (variable length, 4 to 6 digits) Note that this field is empty in case of an invalid value. East-west direction. E = East W = West Note that this field is empty in case of an invalid value. Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Positioning system status. A = Data valid. V = Data not valid. Mode indicator. A = Autonomous mode. Satellite system used in non-differential mode in position fix D = Differential mode. Satellite system used in differential mode in position fix. Corrections from ground stations or Satellite Based Augmentation System (SBAS) E = Estimated (dead reckoning) mode M = Manual input mode N = Data not valid. Checksum. Carriage return and line feed. Example: Take LC86L (B) for example: //GPS + GLONASS +QZSS mode: $GNGLL,3029.465454,N,11430.074441,E,020549.000,A,A*42 //GPS only mode: $GPGLL,3029.464259,N,11430.069356,E,020628.000,A,A*5F LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 23 / 101 GNSS Module Series NOTE The length of minutes decimal fraction is 4 digits in and when the GLL is supported by L26, L76, L76-L, L86, L96, L70 and L80 modules. 2.2.7. TXT Text Transmission. Type: Output Synopsis: $TXT,,,,* Parameter: Field Format Unit Example Description $ Character - $ String, 2 characters - GP Each NMEA message starts with $. Talker identifier. Always 'GP'. TXT String, 3 characters - TXT Text Transmission. Numeric Numeric Numeric String - 01 Total number of sentences. Always '01'. - 01 Sentence number. Always '01'. Text identifier, used to identify - 02 different text messages. Always '02'. ASCII characters and code delimiters, if needed; up to the - ANTSTATUS=OK maximum permitted sentence length (i.e., up to 61 characters including any code delimiters). Hexadecimal - *3B Checksum. Character - - Carriage return and line feed. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 24 / 101 Example: Take LC86L (B) for example: //GPS only or GPS + GLONASS + QZSS mode: $GPTXT,01,01,02,ANTSTATUS=OK*3B GNSS Module Series NOTE This message is supported by L26, L86, L26-LB, L80, LC86L and LG77L (C) modules and the is always 'GP'. 2.2.8. GBS GNSS Satellite Fault Detection. This sentence is used to support Receiver Autonomous Integrity Monitoring (RAIM). Type: Output Synopsis: $GBS,,,,,,,,< StdDev>,,* Parameter: Field Format Unit Example Description $ GBS Character - $ Each NMEA message starts with $. String, 2 characters - GN Talker identifier. See Table 4: NMEA Talker ID. String, 3 characters - GBS GNSS Satellite Fault Detection. hhmmss.sss Position fix UTC. hh: Hours (00–23) - 023333.000 mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Numeric Meter 2.95 Expected Error in latitude. Numeric Meter 3.12 Expected Error in longitude. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 25 / 101 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Hexadecimal Character Unit Example Meter 12.06 - - - - Meter - - - - - - - - *66 - - Description Expected Error in altitude. ID number of most likely failed satellite. Note that this field is empty in case of an invalid value. Probability of missed detection for most likely failed satellite. Note that this field is empty in case of an invalid value. Estimate of bias in meters on most likely failed satellite. Note that this field is empty in case of an invalid value. Standard deviation of bias estimate. Note that this field is empty in case of an invalid value. GNSS system ID. See Table 6: GNSS Numbering. Note that this field is empty in case of an invalid value. GNSS signal ID. See Table 6: GNSS Numbering. Note that this field is empty in case of an invalid value. Checksum. Carriage return and line feed. Example: Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GNGBS,023333.000,2.95,3.12,12.06,,,,,,*66 //GPS only mode: $GPGBS,023620.000,4.08,4.01,14.58,,,,,,*75 NOTE This message is not supported on L70 and L80 modules. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 26 / 101 GNSS Module Series 2.2.9. DTM Local geodetic datum and datum offsets from a reference datum. This sentence is used to define the datum to which a position location, and geographic locations in subsequent sentences, is referenced. Latitude, longitude and altitude offsets from the reference datum, and the selection of reference datum, are also provided. Type: Output Synopsis: $DTM,,,,,,,,* Parameter: Field Format Unit Example Description $ DTM Character - String, 2 characters - String, 3 characters - String - Character Numeric Character Numeric - Minute Minute $ GN DTM W84 0.000000 S 0.000000 Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. Datum Reference. Local datum code. WGS84 = W84 WGS72 = W72 SGS85 = S85 PE90 = P90 User defined = 999 IHO datum code. Local datum subdivision code. One character subdivision datum code when available or user defined reference character for user defined datums, null field otherwise. Offset in Latitude. North-south direction. N = North S = South Offset in Longitude. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 27 / 101 GNSS Module Series Field Format character Numeric string Hexadecimal Character Unit Meter - - Example E 0.00 W84 *41 - Description East-west direction. E = East W = West Offset in altitude. Reference datum code. WGS84 = W84 WGS72 = W72 SGS85 = S85 PE90 = P90 Checksum. Carriage return and line feed. Example: Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GNDTM,W84,,0.000000,N,0.000000,E,0.00,W84*41 //GPS only mode: $GPDTM,W84,,0.000000,N,0.000000,E,0.00,W84*5F 2.2.10. ZDA Time & Date. UTC, day, month, year and local time zone. Type: Output Synopsis: $ZDA,,,,,,* Parameter: Field $ Format Unit Example Character - $ String, 2 characters - GN Description Each NMEA message starts with $. Talker identifier. See Table 4: NMEA Talker ID. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 28 / 101 GNSS Module Series Field ZDA Format String, 3 characters hhmmss.sss Numeric Unit - - Example Description ZDA 024112.000 Time & Date. UTC, day, month, year and local time zone. Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds 24 Day of month. Range: 01–31. Numeric - 04 Month. Range: 01–12. Numeric Numeric Numeric Hexadecimal - 2023 - - - - - *4D Year. Local zone hours, 00 to ±13 hours. Not supported. Local zone minutes, 00 to +59 minutes. Not supported. Checksum. Character - - Carriage return and line feed. Example: Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GNZDA,024112.000,24,04,2023,,*4D //GPS only mode: $GPZDA,024222.000,24,04,2023,,*53 2.2.11. GRS GNSS range residuals. This sentence supports Receiver Autonomous Integrity Monitoring (RAIM). Range residuals can be computed in two ways for this process. The basic measurement integration cycle of most navigation filters generates a set of residuals and uses these to update the position state of the receiver. Type: Output LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 29 / 101 GNSS Module Series Synopsis: $GRS,,{,},,* Parameter: Field $ GRS Format Unit Character - String, 2 characters - String, 3 characters - hhmmss.sss - Numeric - Start of repeat block. Repeat time: 12. Numeric m End of repeat block. Numeric - Numeric - Hexadecimal - Character - Example Description $ Each NMEA message starts with $. Talker identifier. GP See Table 4: NMEA Talker ID. GRS GNSS range residuals. 024321.000 1 Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Calculation method. 0 = Residuals were used to calculate the position given in the matching GGA sentence. 1 = Residuals were recomputed after the GGA position was computed. Range residuals for satellites used in navigation. Range: -999 to 999. 4.21 Note that this field is empty in case of an invalid value. GNSS system ID. See Table 6: GNSS Numbering. 1 Note that this parameter is only available in NMEA 0183 V4.10 or later. GNSS signal ID. See Table 6: GNSS Numbering. 1 Note that this parameter is only available in NMEA 0183 V4.10 or later. *71 Checksum. Carriage return and line feed. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 30 / 101 GNSS Module Series Example: Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GPGRS,025820.000,1,-0.07,1.02,1.23,-2.96,-0.60,-5.48,2.52,-5.68,-5.72,-10.6,1.73,2.78,1,1*59 //GPS only mode: $GPGRS,024321.000,1,4.21,0.07,-0.25,-4.18,-1.50,-0.57,3.48,1.63,-1.86,5.82,10.6,-8.98,1,1*71 NOTE 1. The satellite order in a GRS sentence should match the order of satellite ID numbers in a GSA sentence. If the range residual exceeds ±99.9 meters, then the decimal part is dropped, resulting in an integer. 2. The calculation method is: Range Residual = Calculated Range - Measured Range 3. If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used for navigation, only the IDs of the first 12 are output. 2.2.12. GST GNSS Pseudorange Error Statistics. This sentence supports Receiver Autonomous Integrity Monitoring (RAIM). Pseudorange measurement error statistics can be translated in the position domain in order to give statistical measures of the quality of the position solution. Type: Output Synopsis: $GST,,,,,,,,* Parameter: Field $ GST Format Unit Character - String, 2 characters - String, 3 characters - hhmmss.sss - Example Description $ Each NMEA message starts with $. Talker identifier. GP See Table 4: NMEA Talker ID. GST GNSS Pseudorange Error Statistics. 024703.000 Position fix UTC. hh: Hours (00–23) mm: Minutes (00–59) LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 31 / 101 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Hexadecimal Character Unit Example Meter 3.3 Meter 3.4 Meter 2.8 Degree 35.8 Meter 3.2 Meter 3.0 Meter 12 - *79 - - Description ss: Seconds (00–59) sss: Decimal fraction of seconds RMS value of the standard deviation of the range inputs to the navigation process. Standard deviation of semi-major axis of error ellipse. Standard deviation of semi-minor axis of error ellipse. Orientation of semi-major axis of error ellipse. Standard deviation of latitude error. Standard deviation of longitude error. Standard deviation of altitude error. Checksum. Carriage return and line feed. Example Take LC86L (B) for example: //GPS + GLONASS + QZSS mode: $GPGST,024703.000,3.3,3.4,2.8,35.8,3.2,3.0,12*79 //GPS only mode: $GPGST,024422.000,3.6,3.9,3.7,140.6,3.8,3.8,15*47 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 32 / 101 GNSS Module Series 2.3. PMTK Messages This chapter explains the PMTK messages (proprietary NMEA messages defined by the chipset supplier) supported by the modules. PMTK Message Format: $PMTK[,]* Packet Type: Three-byte character string, from 000 to 999. An identifier for each PMTK message. Data: This field can be omitted, or multiple fields can be delimited by a data field delimiter ‘,’. Different commands correspond to different data. See the specific values below. 2.3.1. PMTK001 PMTK_ACK Acknowledges a PMTK command to inform the sender whether the receiver has received the packet. The following commands will make the GNSS modules restart or change the baud rate, and thus there will be no PMTK_ACK for those commands. ⚫ PMTK_CMD_HOT_START ⚫ PMTK_CMD_WARM_START ⚫ PMTK_CMD_COLD_START ⚫ PMTK_CMD_FULL_COLD_START ⚫ PMTK_SET_NMEA_BAUDRATE Type: Output Synopsis: $PMTK001,,[,,…,]* Parameter: Field Format Unit Numeric - Numeric - Description The packet type that the acknowledgement responds. ACK flag. 0 = Invalid packet 1 = Unsupported packet type 2 = Valid packet, but action failed 3 = Valid packet, and action succeeded LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 33 / 101 GNSS Module Series Field Format Unit [,,…,] Numeric - Description Extended parameters (Optional). Example: $PMTK001,869,3*37 2.3.2. PMTK010 PMTK_SYS_MSG Automatically outputs system message when the modules are powered up. Type: Output Synopsis: $PMTK010,* Parameter: Field Format Numeric Unit Description System message. 000 = Unknown 001 = Startup 002 = Notification for the host aiding EPO 003 = Notification that the transition to normal mode is successfully done Example: $PMTK010,002*2D 2.3.3. PMTK011 PMTK_TXT_MSG Automatically outputs text message when the modules are powered up. Type: Output Synopsis: $PMTK011,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 34 / 101 GNSS Module Series Parameter: Field Format String Example: $PMTK011,MTKGPS*08 Unit Description - The system’s text message. 2.3.4. PMTK101 PMTK_CMD_HOT_START Performs a hot start on the modules (using all available data in the NVM). Normally a hot start means the GNSS modules are powered down less than 2 hours with RTC in operation and the ephemeris is still valid. As there is no need for downloading ephemeris, it is the fastest startup method. Type: Command Synopsis: $PMTK101* Parameter: None Example: $PMTK101*32 2.3.5. PMTK102 PMTK_CMD_WARM_START Performs a warm start on the modules. A warm start means the GNSS modules contains approximate information of time, position and coarse data on satellite positions, but they need to download ephemeris until they can get a fix. Using this message will force a warm restart on the modules without using the ephemeris data in NVM. Type: Command Synopsis: $PMTK102* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 35 / 101 GNSS Module Series Parameter: None Example: $PMTK102*31 2.3.6. PMTK103 PMTK_CMD_COLD_START Performs a cold start on the modules. This command will force a cold restart on the modules without using any prior location information, including position and ephemeris data. Type: Command Synopsis: $PMTK103* Parameter: None Example: $PMTK103*30 2.3.7. PMTK104 PMTK_CMD_FULL_COLD_START Perfoms a full cold restart on the modules. It additionally clears system and user configurations at restart, that is, resetting the modules to the factory settings. A full cold start means there are no last position information in the modules. The modules need to search for the full time and frequency space, and also all possible satellites before they can get a fix. Type: Command Synopsis: $PMTK104* Parameter: None LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 36 / 101 Example: $PMTK104*37 GNSS Module Series 2.3.8. PMTK161 PMTK_CMD_STANDBY_MODE Makes the modules enter Standby mode for power saving. Sending any data will make the modules exit Standby mode. Type: Command Synopsis: $PMTK161,* Parameter: Field Format Numeric Unit Description - Always '0'. Result: Returns a PMTK_ACK message. Example: $PMTK161,0*28 $PMTK001,161,3*36 2.3.9. PMTK183 PMTK_LOCUS_QUERY_STATUS Queries the LOCUS logging status. Type: Command Synopsis: $PMTK183* Parameter: None LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 37 / 101 GNSS Module Series Result: Returns a PMTK_ACK message and the query result. Query Result Message Format: $PMTKLOG,,,,,,,,,, * The parameters included in the result above are listed as below: Field 1) Format Unit Description Numeric Numeric - Character Numeric - Logging serial number. Range: 0–65535. Logging type. 0 = Overlap 1 = Stop logging when full Logging mode: 0x02 = Fix only mode (logging when 3D-fix only) 0x04 = Normal mode (logging per positioning, e.g. 1 s) Customization mode: 0x08 = Interval mode (logging per pre-set interval, e.g. 15 s) 0x10 = Distance mode (logging when the distance exceeds the preset value, e.g. 10 m) 0x20 = Speed mode (logging when the speed exceeds the preset value, e.g. 10 m/s) Default value is 0x0b: Fix only mode + Interval mode. Logging contents of configuration. Numeric - Logging interval setting (valid when interval mode is selected). Numeric - Logging distance setting (valid when distance mode is selected). Numeric Numeric Numeric - Logging speed setting (valid when speed mode is selected). Logging status. 0 = Logging 1 = Stop logging Logging number of data record. Numeric - Used percentage of logging capacity (0 %–100 %). Example: $PMTK183*38 $PMTK001,183,3*3A $PMTKLOG,0,1,b,31,15,0,0,1,0,0*12 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 38 / 101 GNSS Module Series NOTE 1) The 'Fix only mode' is compatible with all other options. The 'Interval mode', 'Distance mode' and 'Speed mode' are called 'Customization mode' and all of them are && condition with 'Fix only mode' and 'Normal mode'. 2.3.10. PMTK184 PMTK_LOCUS_ERASE_FLASH Erases the LOCUS logger flash data. Type: Command Synopsis: $PMTK184,* Parameter: Field Format Numeric Unit Description Erasing type. - 1 = Erase all logger internal flash data Result: Returns a PMTK_ACK message. Example: $PMTK184,1*22 $PMTK001,184,3*3D 2.3.11. PMTK185 PMTK_LOCUS_STOP_LOGGER Stops or starts LOCUS data logging. Type: Command Synopsis: $PMTK185,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 39 / 101 Parameter: Field Format Unit Numeric - Result: Returns a PMTK_ACK message. Example: $PMTK185,1*23 $PMTK001,185,3*3C GNSS Module Series Description Start or stop LOCUS data logging. 0 = Start 1 = Stop 2.3.12. PMTK220 PMTK_SET_POS_FIX Sets position fix interval. Type: Set Synopsis: $PMTK220,* Parameter: Field Format Numeric Unit Millisecond Description Position fix interval. Range: 100–10000. For value ≤ 1000, position fix interval is the value (time) set. For value > 1000 and value ≤ 10000, position fix interval is an integer multiple of 1000 (1000, 2000, …, 10000). Default value: 1000. Result: Returns a PMTK_ACK message. Example: $PMTK220,1000*1F $PMTK001,220,3,1000*1D LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 40 / 101 GNSS Module Series NOTE 1. A higher fixed rate requires a higher baud rate, so that the data can be fully output. For example, if the fixed rate is 10 Hz (interval = 100 ms), the baud rate should be 57600 bps or higher. 2. If the default value is not given for any parameter in a Set command, you can query it with the corresponding Get command provided that the default setting has not been changed by Set command. If the default setting had been changed by Set command, contact Quectel Technical Support (support@quectel.com) to get the default setting if necessary. 2.3.13. PMTK223 PMTK_SET_AL_DEE_CFG Configures DEE. This message sets dynamic ephemeris extension parameters in Periodic mode and should follow PMTK_SET_PERIODIC_MODE. Type: Set Synopsis: $PMTK223,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit - Millisecond Millisecond Description Required number of SV which satisfies the SNR condition to trigger dynamic ephemeris extension. Range: 1–4. Default value: 1. SV signal SNR criteria used to trigger dynamic ephemeris extension. Range: 25–30. Default value: 30. Time duration of dynamic ephemeris extension. Range: 40000–180000. Default value: 180000. The limitation of the interval between neighboring DEE intervals. Range: 0–3600000. Default value: 60000. Result: Returns a PMTK_ACK message. Example: $PMTK223,1,30,180000,60000*3C $PMTK001,223,3*33 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 41 / 101 GNSS Module Series 2.3.14. PMTK225 PMTK_SET_PERIODIC_MODE Sets the modules to Periodic mode for power saving. Type: Set Synopsis: $PMTK225,[,,,,]*< CR> Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Unit - Millisecond Millisecond Millisecond Millisecond Description Power saving mode. 0 = Back to normal mode 1 = Periodic backup mode 2 = Periodic standby mode 4 = Perpetual backup mode Note that when is 0, the fields after can be omitted. Run time. 0 = Disable 1000–518400000 = Run time Sleep time. Range: 1000–518400000. Second run time. 0 = Disable 1000–518400000 = Second run time Second sleep time. Range: 1000–518400000. Result: Returns a PMTK_ACK message. Example: //Periodic standby mode: $PMTK225,0*2B $PMTK001,225,3*35 $PMTK225,2,3000,12000,18000,72000*15 $PMTK001,225,3*35 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 42 / 101 GNSS Module Series NOTE The second run time should be longer than the first run time when the first run time is a non-zero value. 2.3.15. PMTK251 PMTK_SET_NMEA_BAUDRATE Sets the baud rate of NMEA port. The baud rate will be restored to the default setting when the modules perform full cold restart or enter Standby mode. Type: Set Synopsis: $PMTK251,* Parameter: Field Format Numeric Unit Description The baud rate. 4800 9600 14400 bps 19200 38400 57600 115200 Example: $PMTK251,38400*27 2.3.16. PMTK255 PMTK_SET_SYNC_PPS_NMEA Enables or disables the function of fixing NMEA output time in PPS function. Type: Set Synopsis: $PMTK255,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 43 / 101 Parameter: Field Format Unit Numeric - Result: Returns a PMTK_ACK message. Example: $PMTK255,0*2C $PMTK001,255,3*32 GNSS Module Series Description Enable or disable the function of fixing NMEA output time in PPS function. 0 = Disable 1 = Enable 2.3.17. PMTK256 PMTK_SET_TIMING_PRODUCT Enables or disables timing product mode. The timing product mode is used to enhance the PPS output timing accuracy. Type: Set Synopsis: $PMTK256,* Parameter: Field Format Numeric Unit Description Enable or disable timing product mode. - 0 = Disable 1 = Enable Result: Returns a PMTK_ACK message. Example: $PMTK256,0*2F $PMTK001,256,3*31 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 44 / 101 GNSS Module Series 2.3.18. PMTK285 PMTK_SET_PPS_CONFIG Sets PPS type. Type: Set Synopsis: $PMTK285,,* Parameter: Field Format Numeric Numeric Unit Millisecond Description PPS type. 0 = Disable 1 = After the first fix 2 = 3D fix only 3 = 2D/3D fix only 4 = Always PPS pulse width. Range: 2–998. Default value: 100. Result: Returns a PMTK_ACK message. Example: $PMTK285,2,100*3E $PMTK001,285,3*3F NOTE Before you send PMTK_SET_PPS_CONFIG, make sure the baud rate is 19200 bps at least. 2.3.19. PMTK286 PMTK_SET_AIC_ENABLED Enables or disables AIC function. It is recommended to send PMTK_CMD_COLD_START to force a cold restart on the modules before sending this command. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 45 / 101 GNSS Module Series Type: Set Synopsis: $PMTK286,* Parameter: Field Format Unit Numeric - Result: Returns a PMTK_ACK message. Example: $PMTK286,1*23 $PMTK001,286,3*3C Description Enable or disable AIC function. 0 = Disable 1 = Enable 2.3.20. PMTK301 PMTK_API_SET_DGPS_MODE Configures the source mode of DGPS correction data. Type: Set Synopsis: $PMTK301,* Parameter: Field Format Unit Numeric - Description DGPS data source mode. 0 = No DGPS source 1 = RTCM 2 = SBAS (includes WAAS/EGNOS/GAGAN/MSAS) LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 46 / 101 Result: Returns a PMTK_ACK message. Example: $PMTK301,1*2D $PMTK001,301,3*32 GNSS Module Series NOTE 1. Before you send PMTK_API_SET_DGPS_MODE to select RTCM mode, make sure the baud rate is 115200 bps at least. 2. Send PMTK_API_SET_SBAS_ENABLED to enable SBAS searching first before setting SBAS as DGPS mode. 2.3.21. PMTK306 PMTK_API_SET_MIN_SNR Sets the minimum SNR of satellites in use. If the minimum SNR threshold value is set, the modules would not use the satellite whose SNR is smaller than the shreshold value. Type: Set Synopsis: $PMTK306,* Parameter: Field Format Numeric Unit Description Minimum SNR threshold of satellites in use. - Range: 9–37. Default value: 9. Result: Returns a PMTK_ACK message. Example: $PMTK306,15*1F $PMTK001,306,3,15*1D LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 47 / 101 GNSS Module Series NOTE This command is not supported on L70 and L80. 2.3.22. PMTK311 PMTK_API_SET_ELEV_MASK Sets satellite elevation mask. Type: Set Synopsis: $PMTK311,* Parameter: Field Format Numeric Unit Degree Description Satellite elevation mask. Range: 0–90. Result: Returns a PMTK_ACK message. Example: $PMTK311,5*28 $PMTK001,311,3*33 NOTE 1. The satellite elevation mask is recommended to be no more than 10 degrees. With the increase of satellite elevation mask, the number of satellites involved in positioning will decrease. 2. This command is not supported on L70 modules. 2.3.23. PMTK313 PMTK_API_SET_SBAS_ENABLED Enables or disables SBAS satellite searching. SBAS supports wide-area or regional augmentation through geostationary satellite broadcast messages. The geostationary satellite broadcasts GNSS integrity and correction data with the assistance of multiple ground stations which are located at accurately-surveyed points. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 48 / 101 GNSS Module Series Type: Set Synopsis: $PMTK313,* Parameter: Field Format Unit Numeric - Result: Returns a PMTK_ACK message. Example: $PMTK313,1*2E $PMTK001,313,3*31 Description Enable or disable SBAS satellite searching. 0 = Disable 1 = Enable 2.3.24. PMTK314 PMTK_API_SET_NMEA_OUTPUT Sets NMEA sentence output frequencies. There are totally 22 data fields that present output frequency for the 22 supported NMEA sentences individually. Type: Set Synopsis: $PMTK314,,,,,,,,,,,,,,,,,,,,,,* Parameter: Field Format Numeric Unit Description GLL sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 49 / 101 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Description RMC sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 VTG sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 GGA sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 GSA sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 GSV sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 GRS sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 GST sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 - Always '0'. - Always '0'. - Always '0'. - Always '0'. - Always '0'. - Always '0'. - Always '0'. - Always '0'. - Always '0'. ZDA sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 - Always '0'. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 50 / 101 GNSS Module Series Field Format Numeric Numeric Numeric Unit Description DTM sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 GBS sentence output frequency. - 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 - Always '0'. Result: Returns a PAIR_ACK message. Example: $PMTK314,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*35 $PMTK001,314,3*36 NOTE $PMTK314,-1* can be used to restore the NMEA sentence output frequency to the system default setting. Result: Returns a PAIR_ACK message. L26, L76, L76-L, L86, L96, L26-LB, L76-LB, LC86L and LG77L (C) will output RMC, GGA, GSV, GSA, VTG, GLL and GBS messages. L70 and L80 will output RMC, GGA, GSV, GSA, VTG and GLL messages. Example: $PMTK314,-1*04 $PMTK001,314,3*36 2.3.25. PMTK351 PMTK_API_SET_SUPPORT_QZSS_NMEA Enables or disables QZSS NMEA format. Type: Set LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 51 / 101 GNSS Module Series Synopsis: $PMTK351,* Parameter: Field Format Unit Numeric - Result: Returns a PMTK_ACK message. Example: $PMTK351,1*28 $PMTK001,351,3*37 Description Enable or disable QZSS NMEA format. 0 = Disable 1 = Enable 2.3.26. PMTK352 PMTK_API_SET_STOP_QZSS Enables or disables QZSS function. Type: Set Synopsis: $PMTK352,* Parameter: Field Format Numeric Unit Description Enable or disable QZSS function. - 0 = Enable 1 = Disable Result: Returns a PMTK_ACK message. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 52 / 101 Example: $PMTK352,0*2A $PMTK001,352,3*34 GNSS Module Series 2.3.27. PMTK353 PMTK_API_SET_GNSS_SEARCH_MODE Configures the modules to start searching satellite system. Type: Set Synopsis: $PMTK353,,,,,* Parameter: Field Format Unit Numeric - Numeric - Numeric - Numeric - Numeric - Description Enable or disable GPS satellite searching. 0 = Disable 1 or other non-zero values = Enable Enable or disable GLONASS satellite searching. 0 = Disable 1 or other non-zero values = Enable Enable or disable Galileo satellite searching. 0 = Disable 1 or other non-zero values = Enable Always '0'. Enable or disable BDS satellite searching. 0 = Disable 1 or other non-zero values = Enable Result: Returns a PMTK_ACK message. Example: //Search GPS + GLONASS: $PMTK353,1,1,0,0,0*2B $PMTK001,353,3,1,1,0,0,0,3*36 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 53 / 101 GNSS Module Series //Search GPS + BDS: $PMTK353,1,0,0,0,1*2B $PMTK001,353,3,1,0,0,0,1,49*08 NOTE 1. This command is not supported on the L70 and L80. 2. GLONASS and BDS cannot be enabled at the same time. Galileo and BDS cannot be enabled at the same time. 3. GLONASS only, BDS only and Galileo only mode is only for testing purpose. 4. If the satellite system to be set is inconsistent with the current satellite system, the module will restart and satellite system set successfully. If the satellite system to be set is consistent with the current satellite system, the module will not restart and return an ACK response. 2.3.28. PMTK355 PMTK_API_GET_GNSS_SEARCH_MODE Gets whether the GPS/GLONASS/BDS/Galileo satellite seraching is enabled or not. Type: Get Synopsis: $PMTK355* Parameter: None Result: $PMTK001,355,,,,,* Parameter included in the query result: Field Format Unit Numeric - Description ACK flag. 0 = Invalid packet 1 = Unsupported packet 2 = Valid packet, but action failed LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 54 / 101 GNSS Module Series Field Format Unit Numeric - Numeric - Numeric - Numeric - Description 3 = Valid packet, and action succeeded Enable or disable GPS satellite searching. 0 = Disable 1 or other non-zero values = Enable Enable or disable GLONASS satellite searching. 0 = Disable 1 or other non-zero values = Enable Enable or disable BDS satellite searching. 0 = Disable 1 or other non-zero values = Enable Enable or disable Galileo satellite searching. 0 = Disable 1 or other non-zero values = Enable Example: $PMTK355*31 $PMTK001,355,3,1,1,0,0*33 NOTE This command is not supported by L70 and L80. 2.3.29. PMTK386 PMTK_API_SET_STATIC_NAV_THD Sets the speed threshold for static navigation. If the actual speed is below the threshold, the output position will remain the same and the output speed will be zero. If the threshold value is set to 0, this function is disabled. Type: Set Synopsis: $PMTK386,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 55 / 101 GNSS Module Series Parameter: Field Format Unit Numeric m/s Result: Returns a PMTK_ACK message. Example: $PMTK386,0.4*39 $PMTK001,386,3*3D Description Speed threshold. Range: 0–2. Default value: 0.4. 2.3.30. PMTK401 PMTK_API_Q_DGPS_MODE Queries the setting of DGPS mode. See PMTK_API_SET_DGPS_MODE for the setting of DGPS mode and PMTK_DT_DGPS_MODE for the query result. Type: Command Synopsis: $PMTK401* Parameter: None Result: Returns a PMTK_DT_DGPS_MODE message. Example: $PMTK401*37 $PMTK501,1*2B 2.3.31. PMTK413 PMTK_API_Q_SBAS_ENABLED Queries the setting of SBAS. See PMTK_API_SET_SBAS_ENABLED for SBAS setting and PMTK_DT_SBAS_ENABLED for the query result. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 56 / 101 Type: Command Synopsis: $PMTK413* Parameter: None Result: Returns a PMTK_DT_SBAS_ENABLED message. Example: $PMTK413*34 $PMTK513,1*28 GNSS Module Series 2.3.32. PMTK414 PMTK_API_Q_NMEA_OUTPUT Queries the current NMEA sentence output frequency. See PMTK_API_SET_NMEA_OUTPUT for the frequency setting and PMTK_DT_NMEA_OUTPUT for the query result. Type: Command Synopsis: $PMTK414* Parameter: None Result: Returns a PMTK_DT_NMEA_OUTPUT message. Example: $PMTK414*33 $PMTK514,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*33 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 57 / 101 GNSS Module Series 2.3.33. PMTK501 PMTK_DT_DGPS_MODE This message is the response to PMTK_API_Q_DGPS_MODE. Type: Output Synopsis: $PMTK501,* Parameter: Field Format Numeric Unit Description DGPS data source mode. 0 = No DGPS source 1 = RTCM 2 = SBAS Example: $PMTK501,1*2B 2.3.34. PMTK513 PMTK_DT_SBAS_ENABLED This message is the response to PMTK_API_Q_SBAS_ENABLED. Type: Output Synopsis: $PMTK513,* Parameter: Field Format Numeric Unit Description Setting result. - 0 = Disable 1 = Enable LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 58 / 101 Example: $PMTK513,1*28 GNSS Module Series 2.3.35. PMTK514 PMTK_DT_NMEA_OUTPUT This message is the response to PMTK_API_Q_NMEA_OUTPUT. Type: Output Synopsis: $PMTK514,,,,,,,,,,,,,,,,,,,,,,* Parameter: Field Format Unit Numeric - Numeric - Numeric - Numeric - Numeric - Numeric - Numeric - Numeric - Description GLL sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 RMC sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5. VTG sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5. GGA sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5. GSA sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5. GSV sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5. GRS sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5. GST sentence output frequency. 0 = Disabled or not supported sentence LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 59 / 101 GNSS Module Series Field Format Unit Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric - Numeric - Numeric - Numeric - Numeric - Numeric - Description n = Output once every 'n' position fix. 'n' ranges from 1 to 5. Always '0'. Always '0'. Always '0'. Always '0'. Always '0'. Always '0'. Always '0'. Always '0'. Always '0'. ZDA sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5. Always '0'. DTM sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5. GBS sentence output frequency. 0 = Disabled or not supported sentence n = Output once every 'n' position fix. 'n' ranges from 1 to 5 Always '0'. Example: $PMTK514,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*32 2.3.36. PMTK605 PMTK_Q_RELEASE Queries the firmware release information. See PMTK_DT_RELEASE for the query result. Type: Command LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 60 / 101 GNSS Module Series Synopsis: $PMTK605* Parameter: None Result: Returns a PMTK_DT_RELEASE message. Example: $PMTK605*31 $PMTK705,AG3331_AXN5.1.9_MODULE_STD_F8_P2,000B,Quectel-LC86L,1.0*26 2.3.37. PMTK622 PMTK_Q_LOCUS_DATA Dumps LOCUS flash data. Type: Input Synopsis: $PMTK622,* Parameter: Field Format Unit Numeric - Description Type of dumping. 0 = Dump all the LOCUS data in the flash 1 = Dump the LOCUS data in the current flash sector Result: Returns a PMTK_ACK message. Example: $PMTK622,1*29 $PMTK001,622,3*36 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 61 / 101 GNSS Module Series NOTE When the UTC time is not a non-integer second, the UTC time stored in LOCUS may differ from the actual UTC time by ±1 s. 2.3.38. PMTK705 PMTK_DT_RELEASE This message is the response to PMTK_Q_RELEASE. Type: Output Synopsis: $PMTK705,,,,* Parameter: Field Format Unit Numeric - Numeric - Numeric - Numeric - Description Firmware release version and name. Build ID for firmware version control. Product model for product identification. Showing SDK version if the firmware is used for SDK. Example: $PMTK705,AG3331_AXN5.1.9_MODULE_STD_F8_P2,000B,Quectel-LC86L,1.0*26 2.3.39. PMTK838 PMTK_TEST_ANTI_SPOOFING Enables or disables jamming detection function. Type: Set Synopsis: $PMTK838,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 62 / 101 GNSS Module Series Parameter: Field Format Numeric Unit Description Enable or disable jamming detection function. - 0 = Disable 1 = Enable Result: Returns a PMTK_ACK message and the query result. Query Result Message Format: $PMTKSPF,* Parameter included in the result above is listed as below: Field Format Numeric Unit Description Status of jamming detection function. 1 = No jamming, healthy status 2 = Warning status 3 = Critical status Example: $PMTK838,1*2C $PMTK001,838,3,1*2E //Healthy status: $PMTKSPF,1*5A //Warning status: $PMTKSPF,2*59 //Critical status: $PMTKSPF,3*58 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 63 / 101 GNSS Module Series NOTE After jamming detection is enabled, the modules start to detect whether there is any jamming. 1. If there is no jamming, $PMTKSPF,1*5A will be reported to indicate healthy status (status 1). 2. If there is continuous jamming, the module status will change from 1 to 2 and finally 3. 1) In the case of not being positioned: after jamming detection is enabled, the module status will be 1 at the very beginning, and then change to 2 when jamming is detected. During the process, the modules will attempt to fix position. If position fix still fails after 200 s, the module status will change to 3 finally. 2) In the case of being positioned: after jamming detection is enabled, the module status will be 1 at the very beginning. When jamming is detected, the module status will change to 2 and then 3 consecutively. 3. This command is only supported on L70 and L80. 2.3.40. PMTK869 PMTK_EASY_ENABLE Enables or disables EASY function, and it can also get whether EASY is enabled or disabled. Type: Set/Get/Output Synopsis: $PMTK869,[,][,]* Parameter: Field Format Unit Numeric - Numeric - Numeric - Description Message type. 0 = Query 1 = Set 2 = Query result Enable or disable EASY function. 0 = Disable 1 = Enable Finished extension days. Range:0–3. Result: 1) Set: ⚫ Returns a PMTK_ACK message. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 64 / 101 2) Get: ⚫ Outputs a PMTK_EASY_ENABLE message. Example: //Set: $PMTK869,1,1*35 $PMTK001,869,3*37 //Get: $PMTK869,0*29 $PMTK869,2,0,0*2B GNSS Module Series NOTE 1. If EASY is disabled, the modules return: $PMTK869,2,0,0*2B. 2. If EASY is enabled and is not finished yet, the modules may return: $PMTK869,2,1,0*2A. 3. If EASY is enabled and is finished after 1 day, the modules may return: $PMTK869,2,1,1*2B. 4. If EASY is enabled and is finished after 2 days, the modules may return: $PMTK869,2,1,2*28. 5. If EASY is enabled and is finished after 3 days, the modules may return: $PMTK869,2,1,3*29. 2.3.41. PMTK875 PMTK_PMTKLSC_STN_OUTPUT PMTKLSC message is the leap second indication statement. This command enables or disables PMTKLSC message output, and it can also query whether PMTKLSC message output is enabled or disabled. Type: Set/Get/Output Synopsis: $PMTK875,[,]* Parameter: Field Format Unit Numeric - Description Message type. 0 = Query 1 = Set 2 = Query result LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 65 / 101 GNSS Module Series Field Format Unit Numeric - Description Enable or disable PMTKLSC message output. 0 = Disable 1 = Enable Result: 1) Set command: ⚫ Returns a PMTK_ACK message and query result messages. 2) Get command: ⚫ Outputs a PMTK_PMTKLSC_STN_OUTPUT message and query result messages. Query Result Message Format: $PMTKLSC,,,* $PMTKLSCB,,,* The parameters included in the result above is listed as below: Packet Data Format Numeric Unit Second Numeric - Numeric Second Description Current leap second. Leap indicator. 1 = Updated from broadcast data Next leap second. Example: //Set: $PMTK875,1,1*38 $PMTK001,875,3*3A $PMTKLSC,18,1,18*43 $PMTKLSCB,0,0,0*00 //Get: $PMTK875,0*24 $PMTK875,2,1*3B $PMTKLSC,18,1,18*43 $PMTKLSCB,0,0,0*00 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 66 / 101 GNSS Module Series 2.3.42. PMTK886 PMTK_FR_MODE Sets the navigation mode. Type: Set Synopsis: $PMTK886,* Parameter: Field Format Unit Description Numeric - The navigation mode. 0 = Normal Mode. For general purposes 1 = Fitness Mode. For running and walking purposes that the low-speed (< 5 m/s) movement will have more effect on the position calculation 2 = Aviation Mode. For high-dynamic purposes that the largeacceleration movement will have more effect on the position calculation 3 = Balloon Mode. For high-altitude balloon purposes that the vertical movement will have more effect on the position calculation 4 = Stationary Mode. For stationary applications that zero dynamics is assumed Result: Returns PMTK_ACK message. Example: $PMTK886,3*2B $PMTK001,886,3*36 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 67 / 101 GNSS Module Series NOTE Each mode has its altitude limitation. Please choose an appropriate mode based on the altitude limitations listed below, otherwise the position calculation will be incorrect. Mode Normal Mode Fitness Mode Aviation Mode Stationary Mode Balloon Mode Unit Meter Meter Meter Meter Meter Altitude Limitation 10000 10000 10000 10000 80000 2.3.43. PMTKSPF Outputs Jamming status when jamming detection function is enabled. Type: Output Synopsis: $PMTKSPF,* Parameter: Field Format Numeric Unit Description Jamming status. 0 = No jamming, healthy status 1 = Warning status 2 = Critical status Example: $PMTKSPF,1*5A LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 68 / 101 GNSS Module Series NOTE When the Jamming detection function is enabled on L96 module by $PQJAM command, the pin 20 (JAM_IND) is at a high level when the Jamming status is 0 or 1; the pin 20 (JAM_IND) is at a low level when the Jamming status is 2. For details on PQJAM command, see Chapter 2.4.12 PQJAM for details. 2.4. PQ Messages This chapter explains the PQ messages which are defined and developed by Quectel. The configuration parameters saved by PQ messages will still exist in flash even after upgrading the modules’ firmware. 2.4.1. PQBAUD Sets NMEA port default baud rate. Type: Set Synopsis: $PQBAUD,W,* Parameter: Field Format Unit Numeric bps Description NMEA port baud rate: 4800 9600 14400 19200 38400 57600 115200 Result: ⚫ In case of no errors: $PQBAUD,W,OK* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 69 / 101 ⚫ In case of any error: $PQBAUD,W,ERROR* Example: //Set NMEA port default baud rate to 115200 bps: $PQBAUD,W,115200*43 //Set successfully: $PQBAUD,W,OK*40 GNSS Module Series NOTE 1. The command takes effect immediately after setting. 2. The parameter is automatically saved. 3. There is no response returned if the baud rate is changed to a different value. 2.4.2. PQEPE Enables/disables PQEPE message output. If enabled, PQEPE message will be automatically output. Type: Set/Output Synopsis: //Set Command: $PQEPE,W,,* //Output message: $PQEPE,,* Parameter: Field Format Numeric Numeric Numeric Unit - Meter Description Enable or disable PQEPE message output. 0 = Disable 1 = Enable Saving operation. 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart Estimated horizontal position error. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 70 / 101 GNSS Module Series Field Format Numeric Unit Meter Description Estimated vertical position error. Result: ⚫ In case of no errors: $PQEPE,W,OK* ⚫ In case of any error: $PQEPE,W,ERROR* Example: //Enable PQEPE message output and save parameters into flash: $PQEPE,W,1,1*2A //Set successfully: $PQEPE,W,OK*02 //Output message: $PQEPE,5.3050,3.2000*53 NOTE The command takes effect immediately after setting. 2.4.3. PQ1PPS Sets the type and pulse width of 1PPS output. Type: Set Synopsis: $PQ1PPS,W,,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 71 / 101 GNSS Module Series Parameter: Field Format Numeric Numeric Unit Millisecond Description The type of 1PPS output. 0 = Disable 1PPS output 1 = Send 1PPS after the first fix 2 = Send 1PPS after 3D fix 3 = Send 1PPS after 2D fix 4 = Send 1PPS always PPS pulse width. Range: 2–998. Result: ⚫ In case of no errors: $PQ1PPS,W,OK* ⚫ In case of any error: $PQ1PPS,W,ERROR* Example: //Set the type of 1PPS output and PPS pulse width: $PQ1PPS,W,4,100*1D //Set successfully: $PQ1PPS,W,OK*30 //Disable 1PPS output: $PQ1PPS,W,0,0*18 //Set successfully: $PQ1PPS,W,OK*30 NOTE 1. The command takes effect immediately after setting. 2. The parameters are automatically saved. 3. If is set as 0, could be set as 0–998. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 72 / 101 GNSS Module Series 2.4.4. PQFLP Sets the modules into FLP mode and gets module operation mode. Type: Set/Get Synopsis: $PQFLP,,,* Parameter: Field Format Unit String - Numeric - Numeric - Description Command type. W = Set R = Get When is R, other parameters can be omitted. Module operation mode. 0 = Normal mode 1 = FLP mode Saving operation. 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart Result: 1) Set: ⚫ In case of no errors: $PQFLP,W,OK* ⚫ In case of any error: $PQFLP,W,ERROR* 2) Get: $PQFLP,R,* Example: //Change to FLP mode: $PQFLP,W,1,1*20 //Set successfully: LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 73 / 101 $PQFLP,W,OK*08 //Get the mode: $PQFLP,R*25 //Get successfully, FLP mode is enabled: $PQFLP,R,1*38 NOTE 1. The command takes effect immediately after setting. 2. This command is supported on L70 and L80 modules only. GNSS Module Series 2.4.5. PQTXT Enables or disables GPTXT message output. Type: Set Synopsis: $PQTXT,W,,* Parameter: Field Format Numeric Numeric Unit Description Enable or disable GPTXT message output. - 0 = Disable 1 = Enable Saving operation. - 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart Result: ⚫ In case of no errors: $PQTXT,W,OK* ⚫ In case of any error: $PQTXT,W,ERROR* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 74 / 101 Example: //Enable GPTXT message output and save the parameter into flash: $PQTXT,W,1,1*22 //Set successfully: $PQTXT,W,OK*0A GNSS Module Series NOTE 1. The command takes effect immediately after setting. 2. This command is only supported on the modules which support antenna detection feature. 2.4.6. PQECEF Enables or disables ECEFPOSVEL message output. If enabled, ECEFPOSVEL message is automatically output. This command can also get module operation mode. Type: Set/Get Synopsis: $PQECEF,,,* Parameter: Field Format Unit String - Numeric - Numeric - Description Command type. W = Set R = Get When is R, other parameters can be omitted. Enable or Disable ECEFPOSVEL message output. 0 = Disable 1 = Enable Saving operation. 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 75 / 101 GNSS Module Series Result: 1) Set: ⚫ In case of no errors: $PQECEF,W,OK* ⚫ In case of any error: $PQECEF,W,ERROR* 2) Get: $PQECEF,R,* Example: //Enable ECEFPOSVEL message output, and save the parameter into flash: $PQECEF,W,1,1*7F //Set successfully: $PQECEF,W,OK*57 //Get the mode: $PQECEF,R*7A //Get successfully, ECEFPOSVEL message output is enabled: $PQECEF,R,1*67 NOTE The command takes effect immediately after setting. 2.4.7. ECEFPOSVEL This message is automatically output when PQECEF is enabled. Type: Output Synopsis: $ECEFPOSVEL,,,,,,,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 76 / 101 GNSS Module Series Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Description - UTC from the internal real-time clock. - The value of X axis in ECEFPOSVEL message. - The value of Y axis in ECEFPOSVEL message. - The value of Z axis in ECEFPOSVEL message. - Velocity component of X axis in ECEFPOSVEL message. - Velocity component of Y axis in ECEFPOSVEL message. - Velocity component of Z axis in ECEFPOSVEL message. Example: $ECEFPOSVEL,052743.000,-1526672.867459,6191083.982801,143008.780911,0,0,0*14 2.4.8. PQODO Starts or stops odometer reading. This command can also get whether the odometer reading is started and query the distance value. Type: Set/Get/Query Synopsis: $PQODO,,,* Parameter: Field Format Unit String - Numeric - Description Command type. W = Set R = Get Q = Query When is R or Q, other parameters can be omitted. Start or stop odometer reading. 0 = Stop odometer reading and remember the distance value 1 = Start odometer reading and initialize the distance LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 77 / 101 GNSS Module Series Field Format Unit Description according to the Numeric Meter Set the initial distance. Range: 0-1e09. When is 1, this parameter can be omitted, and its default value is 0. When is 0, this parameter must be omitted. Result: 1) Set: ⚫ In case of no errors: $PQODO,W,OK* ⚫ In case of any error: $PQODO,W,ERROR* 2) Get: ⚫ In case of no errors: $PQODO,R,* ⚫ In case of any error: $PQODO,R,ERROR* 3) Query: ⚫ In case of no errors: $PQODO,Q,* ⚫ In case of any error: $PQODO,Q,ERROR* Parameter included in the query result: Field Format Unit Numeric Meter Description Current distance. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 78 / 101 Example: //Start odometer reading, and initial distance is 0 m: $PQODO,W,1*23 //Set successfully: $PQODO,W,OK*16 //Start odometer reading, and initial distance is 1,000,000 m: $PQODO,W,1,1000000*3E //Set successfully: $PQODO,W,OK*16 //Get the mode: $PQODO,R*3B //Get successfully, odometer reading has already been started: $PQODO,R,1*26 //Query the distance value: $PQODO,Q*38 //Current distance value is returned: $PQODO,Q,123.45*0B GNSS Module Series NOTE 1. The command takes effect immediately after setting. 2. After module is restarted, the PQODO Set Command must be executed again to re-start odometer reading. 3. The command is not supported in Backup mode. 2.4.9. PQPZ90 Enables or disables switching from WGS84 to PZ-90.11. This command can also get whether switching from WGS84 to PZ-90.11 is enabled. Type: Set/Get Synopsis: $PQPZ90,,,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 79 / 101 GNSS Module Series Parameter: Field Format String Numeric Numeric Unit Description Command type. W = Set - R = Get When is R, other parameters can be omitted. Enable or Disable switching from WGS84 to PZ-90.11. - 0 = Disable 1 = Enable Saving operation. - 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart Result: 1) Set: ⚫ In case of no errors: $PQPZ90,W,OK* ⚫ In case of any error: $PQPZ90,W,ERROR* 2) Get: $PQPZ90,R,* Example: //Enable switching from WGS84 to PZ-90.11, and save the parameter into flash: $PQPZ90,W,1,1*79 //Set successfully: $PQPZ90,W,OK*51 //Get the mode: $PQPZ90,R*7C //Get successfully, switching from WGS84 to PZ-90.11 is enabled: $PQPZ90,R,0*60 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 80 / 101 GNSS Module Series NOTE 1. The command takes effect immediately after setting to 0. However, when is set to 1, it takes effect only after restart for versions earlier than L76NR03A01S (on L76 module), L76LNR02A01S (on L76-L module), L86NR02A01S (on L86 module) and L26NR02A01S (on L26 module). 2. If switching from WGS84 to PZ-90.11 is enabled and takes effect, the coordinate values in RMC and GGA sentences will be switched to PZ-90.11 after fixing. Also, a DTM sentence will be displayed to identify the datum used. 2.4.10. PQGLP Sets the modules to GLP mode and gets whether the GLP mode is enabled. Type: Set/Get Synopsis: $PQGLP,,,* Parameter: Field Format String Numeric Numeric Unit Description Command type. W = Set R = Get When is R, other parameters can be omitted. Module operation mode. - 0 = Normal mode 1 = GLP mode Saving operation. - 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart Result: 1) Set: ⚫ In case of no errors: $PQGLP,W,OK* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 81 / 101 ⚫ In case of any error: $PQGLP,W,ERROR* 2) Get: $PQGLP,R,* GNSS Module Series Example: //Change to GLP mode: $PQGLP,W,1,1*21 //Set successfully: $PQGLP,W,OK*09 //Get the mode: $PQGLP,R*24 //Get successfully. GLP mode is enabled: $PQGLP,R,1*39 NOTE 1. The command takes effect immediately after setting. 2. This command is not supported on L70 and L80. 2.4.11. PQVEL Enables or disables PQVEL message output. If enabled, PQVEL message will be automatically output. This command can also get whether PQVEL message output is enabled. Type: Set/Get/Output Synopsis: //Set/Get command: $PQVEL,,,* //Output message: $PQVEL,,,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 82 / 101 GNSS Module Series Parameter: Field Format String Numeric Numeric Numeric Numeric Numeric Unit Description Command type. W = Set - R = Get When is R, other parameters can be omitted. Enable or disable PQVEL message output. - 0 = Disable 1 = Enable Saving operation. - 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart m/s North velocity. m/s East velocity. m/s Down velocity. Result: 1) Set: ⚫ In case of no errors: $PQVEL,W,OK* ⚫ In case of any error: $PQVEL,W,ERROR* 2) Get: $PQVEL,R,* Example: //Set message output: $PQVEL,W,1,1*25 //Set successfully: $PQVEL,W,OK*0D //Get the mode: $PQVEL,R*20 //The mode is enabled: LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 83 / 101 $PQVEL,R,1*3D //Output message: $PQVEL,1.000000,2.000000,-0.000000*42 ffNOTE The command takes effect immediately after setting. GNSS Module Series 2.4.12. PQJAM Enables or disables jamming detection function. This command can also get whether jamming detection function is enabled. Type: Set/Get Synopsis: $PQJAM,,,* Parameter: Field Format String Numeric Numeric Unit Description Command type. W = Set - R = Get When is R, other parameters can be omitted. Enable or disable jamming detection function. - 0 = Disable 1 = Enable Saving operation. - 0 = Parameter is not saved, and will is invalid restart 1 = Parameter is saved in flash, and is valid after restart Result: 1) Set: ⚫ In case of no errors: $PQJAM,W,OK* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 84 / 101 ⚫ In case of any error: $PQJAM,W,ERROR* 2) Get: $PQJAM,R,* Example: //Enable jamming detection function: $PQJAM,W,1,1*3C //Set successfully: $PQJAM,W,OK*14 //Get operation mode: $PQJAM,R*39 //Get successfully: $PQJAM,R,1*24 NOTE 1. The command takes effect immediately after setting. 2. The command is not supported in Backup mode. GNSS Module Series 2.4.13. PQRLM Enables/disables the return link message output. This command can also receive distress signal. Type: Set/Get/Output Synopsis: //Set/Get Command: $PQRLM,,,* //Output message: $PQRLM,,,,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 85 / 101 GNSS Module Series Parameter: Field Format Unit String - Numeric - Numeric - Numeric - Numeric Second Numeric - Numeric - Description Command type. W = Set R = Get When is R, other parameters can be omitted. Enable or disable return link message output. 0 = Disable 1 = Enable Saving operation. 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart Beacon ID of RLM. The GPS seconds when receiving RLM. Note: The output format is hhmmss.ss for L76L module. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) ss: Decimal fraction of seconds Message code. The data parameters provided by RLS. Short message contains 4 hex characters and long message contains 24 hex characters. Result: 1) Set: ⚫ In case of no errors: $PQRLM,W,OK* ⚫ In case of any error: $PQRLM,W,ERROR* 2) Get: $PQRLM,R,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 86 / 101 Example: //Enable return link message output: $PQRLM,W,1,1*29 //Set successfully: $PQRLM,W,OK*01 //Get the mode: $PQRLM,R*2C //Get successfully: $PQRLM,R,1*31 //Output message: $PQRLM,a042be29630f190,1370324891,15,6503*66 //Output message for L76L module: $PQRLM,9c02be29630f0a0,054131.00,15,6503*1C GNSS Module Series NOTE 1. The command takes effect immediately after setting. 2. This command is not supported on the following modules: ⚫ L70 ⚫ L80 ⚫ L26-LB ⚫ L76-LB ⚫ LC86L (A, B) 3. The $PQRLM can output up to 10 messages. If there are more than 10 output messages, the new one will overwrite the old one. 2.4.14. PQGEO Configures parameters of Geo-fence. This command can also get Geo-fence setting and query the Geofence ID status of current position. Type: Set/Get/Query/Output LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 87 / 101 GNSS Module Series Synopsis: //Set/Get/Query Command: $PQGEO,,,,,,,,,,, ,* //Output message: $PQGEO,,,,,,,,,,,,,,,,* Parameter: Field Format String Numeric Numeric Numeric ±dd.dddddd ±ddd.dddddd Unit - - Degree Degree Description Command type. W = Set R = Get Q = Query When is R or Q, other parameters can be omitted except . Geo-fence ID. Range: 0–9. URC Report mode. 0 = Disable URC to be reported when entering or leave the Geo-fence 1 = Enable URC to be reported when entering the Geo-fence 2 = Enable URC to be reported when leaving the Geofence 3 = Enable URC to be reported when entering or leaving the Geo-fence If is 0, the parameters after can be omitted. Fence shape. 0 = Circularity with center and radius 1 = Circularity with center and one point on the circle 2 = Triangle 3 = Quadrangle The latitude of a point which is defined as the center of the Geo-fence circular region or the first point. Range: -90.000000–90.000000 (variable length, 4 to 6 digits). The longitude of a point which is defined as the center of the Geo-fence circular region or the first point. Range: -180.000000–180.000000 (variable length, 4 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 88 / 101 GNSS Module Series Field Format Unit Description to 6 digits). ±dd.dddddd ±ddd.dddddd ±dd.dddddd ±ddd.dddddd, ±dd.dddddd ±ddd.dddddd Numeric Meter/ Degree Degree Degree Degree Degree Degree - When is 0, this parameter is radius. Range: 0-6000000.0. When is other values, this parameter is latitude1. Range: -90.000000–90.000000 (variable length, 4 to 6 digits). If is 0, the parameters after must be omitted. The longitude of the second point. Range: -180.000000–180.000000 (variable length, 4 to 6 digits). If is 1, the parameters after must be omitted. The latitude of the third point. Range: -90.000000–90.000000 (variable length, 4 to 6 digits). The longitude of the third point. Range: -180.000000–180.000000 (variable length, 4 to 6 digits). If is 2, the parameters after must be omitted. The latitude of fourth point. Range: -90.000000–90.000000 (variable length, 4 to 6 digits). The longitude of fourth point. Range: -180.000000–180.000000 (variable length, 4 to 6 digits). The status of current position. 0 = Unknown position 1 = Inside the Geo-fence 2 = Outside the Geo-fence Numeric - Geo-fence ID. Range: 0–9. Numeric - Numeric - The current action of the module. 1 = Entering the Geo-fence 2 = Leaving the Geo-fence Fix status. 0 = No fix 1 = 2D fix 2 = 3D fix LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 89 / 101 GNSS Module Series Field Format Unit Description DyyMMddThh - mmss.sss ±dd.dddddd Degree ±ddd.dddddd Degree UTC time. D: char 'D', refers to date yy: current year–2000 MM: 1–12 dd: 1–31 T: char 'T', refers to time hh: 0–23 mm: 0–59 ss.sss: 00.000–59.999 The latitude of current position. Range: -90.000000–90.000000. The longitude of current position. Range: -180.000000–180.000000. Numeric Meter Mean sea level (MSL) altitude. Numeric km/h Speed over ground. Numeric Numeric Numeric Degree Course over ground. Range: 0–359.99 Degree Fix mode. 0 = No fix 1 = Estimated mode 2 = Position fixed 3 = Position fixed in DGPS mode - Reserved. Always null. Numeric - Horizontal dilution of precision. Numeric - Position dilution of precision. Numeric - Vertical dilution of precision. Numeric - Reserved. Always null. Numeric - GPS satellites used. Result: 1) Set: ⚫ In case of no errors: $PQGEO,W,OK* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 90 / 101 GNSS Module Series ⚫ In case of any error: $PQGEO,W,ERROR* 2) Get: ⚫ In case of no errors: $PQGEO,R,,,,,,,,,,,* ⚫ In case of any error: $PQGEO,R,ERROR* 3) Query: ⚫ In case of no errors: $PQGEO,Q,,* ⚫ In case of any error: $PQGEO,Q,ERROR* Example: //Enable the Gen-fence 0 to report when entering the circularity with center and radius: $PQGEO,W,0,1,0,30.491225,114.501417,100.0*11 //Set successfully: $PQGEO,W,OK*1F //Disable the Gen-fence 4 to report when entering or leaving the circularity with center and one point on the circle: $PQGEO,W,4,3,1,30.491079,114.501307,30.494856,114.070281*21 //Set successfully: $PQGEO,W,OK*1F //Set the Geo-fence 3 not report when entering or leaving the Geo-fence: $PQGEO,W,3,0*34 //Set successfully: $PQGEO,W,OK*1F //Get the Geo-fence 0 settings: $PQGEO,R,0*2E //Get successfully: LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 91 / 101 GNSS Module Series $PQGEO,R,0,1,0,30.491225,114.501417,100.0*14 //Get the Geo-fence 4 settings: $PQGEO,R,4*2A //Get successfully: $PQGEO,R,4,3,1,30.491079,114.501307,30.494856,114.070281*24 //Query the Geo-fence 0 status of current position: $PQGEO,Q,0*2D //Query successfully: $PQGEO,Q,0,1*30 //Query the Geo-fence 4 status of current position: $PQGEO,Q,4*29 //Query successfully: $PQGEO,Q,4,2*37 //Output message: $PQGEO,0,1,2,D230608T032927.000,30.491130,114.501387,175.1,2.62,320.16,2,,0.78,1.06,0.71,,13*4 E NOTE 1. If is 0 and no parameters follow , this command can delete the Geo-fence. 2. Only L96 module can indicate whether it is inside or outside the Geofence via the voltage level change of pin 24 (GEO_FENCE). To do this, the must be set to 0. The truth table below shows the GEO_FENCE voltage level when the module is inside or outside the Geofence. Mode = 0 Mode = 1 Mode = 2 Mode = 3 Inside the Geofence Voltage Level Message High None Low Output High None High Output Outside the Geofence Voltage Level Message High None High None Low Output High Output 3. $PQGEO,R,10*1F can query parameters of all Geo-fences. 4. The command takes effect immediately after setting, and the parameters will be automatically saved into flash. 5. Input the latitude and longitude in sequence in clockwise or counter-clockwise order. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 92 / 101 GNSS Module Series 2.4.15. PQPREC Configures the parameter (latitude/longitude/altitude) in NMEA sentences through setting the number of digits after the decimal point. Type: Set/Get Synopsis: $PQPREC,,,[,],* Parameter: Field Format Unit String - Numeric Numeric Numeric - Numeric - Description Command type. W = Set R = Get When is R, other parameters can be omitted. The number of digits after the decimal point of latitude in NMEA sentences. Range: 4–6. Default value: 4. The number of digits after the decimal point of longitude in NMEA sentences. Range: 4–6. Default value: 4. The number of digits after the decimal point of altitude and geoidal separation in NMEA sentences. This parameter can be omitted. Range: 1–3. Default value: 1. Saving operation. 0 = Configuration is not saved, and is invalid after restart 1 = Configuration is saved in flash, and is valid after restart Result: 1) Set: ⚫ In case of no errors: $PQPREC,W,OK* ⚫ In case of any error: $PQPREC,W,ERROR* 2) Get: $PQPREC,R,,,* LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 93 / 101 GNSS Module Series Example: //Set the number of digits after the decimal point of latitude and longitude to 5, and altitude to 2, then save the parameter into flash: $PQPREC,W,5,5,2,1*7D //Set successfully: $PQPREC,W,OK*56 //The following parameters in bold are variables: $xxRMC,030037.000,A,3150.77801,N,11711.95112,E,0.00,37.74,070816,,,A*xx $xxGGA,030037.000,3150.77801,N,11711.95112,E,1,6,1.66,96.54,M,0.01,M,,*xx $xxGLL,3150.77801,N,11711.95112,E,030037.000,A,A*xx //Get parameter precision setting in NMEA sentences: $PQPREC,R*7B //Get successfully: $PQPREC,R,5,5,2*65 NOTE 1. The command takes effect immediately after setting. 2. This command is not supported on L70 and L80. 2.4.16. PQGBS The command enables/disables the output of GBS sentence which is used to support receiver autonomous integrity monitoring (RAIM). Type: Set/Get Synopsis: $PQGBS,,,* Parameter: Field Format String Unit Description Command type. - W = Set R = Get LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 94 / 101 GNSS Module Series Field Format Numeric Numeric Unit Description When is R, other parameters can be omitted. Enable or disable GBS sentence output. - 0 = Disable 1 = Enable Saving operation. - 0 = Parameter is not saved, and is invalid after restart 1 = Parameter is saved in flash, and is valid after restart Result: 1) Set: ⚫ In case of no errors: $PQGBS,W,OK* ⚫ In case of any error: $PQGBS,W,ERROR* 2) Get: $PQGBS,R,* Example: //Enable GBS sentence output and save into flash: $PQGBS,W,1,1*2C //Set successfully: $PQGBS,W,OK*04 //Get the mode: $PQGBS,R*29 //Get successfully. GBS sentence output is enabled: $PQGBS,R,1*34 NOTE 1. The command takes effect immediately after setting. 2. This command is not supported on L70 and L80. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 95 / 101 GNSS Module Series 2.4.17. PQVERNO Queries the information about firmware version. Type: Query/Output Synopsis: //Query Command: $PQVERNO,R* //Output message: $PQVERNO,R,,,* Parameter: Field Format Unit String - yyyy/mm/dd - hh:mm - Description Firmware version. The date when the firmware version is generated. yyyy: Year mm: Month dd: Day of month The time when the firmware version is generated. hh: Hours (00–23) mm: Minutes (00–59) Example: //Query Command: $PQVERNO,R*3F //Output message: $PQVERNO,R,LC86LIBNR11A01S,2023/02/09,09:20*63 LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 96 / 101 GNSS Module Series 3 Appendix A References Table 5: Terms and Abbreviations Abbreviation 1PPS 2D Description 1 Pulse Per Second 2 Dimension 3D ACK AGNSS 3 Dimension Acknowledgement Assisted GNSS AIC DEE DGPS Active Interference Cancellation Dynamic Ephemeris Extension Differential Global Positioning System DOP EASY ECEF Dilution of Precision Embedded Assist System Earth-centered, Earth-fixed EGNOS EPE EPO European Geostationary Navigation Overlay Service Estimated Position Error Extended Prediction Orbit FLP GAGAN GBS Fitness Low Power GPS-aided GEO Augmented Navigation GNSS Satellite Fault Detection GGA GLL Global Positioning System Fix Data Geographic Position – Latitude/Longitude LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 97 / 101 Abbreviation GLONASS GLP GNSS GPS GSA GSV HDOP MSAS MSL NMEA NVM ODO PDOP PMTK PPS PZ90 QZSS RAIM RLM RMC RTC RTCM SBAS SNR GNSS Module Series Description Global Navigation Satellite System (The Russian GNSS) GNSS Low Power Global Navigation Satellite System Global Positioning System GNSS DOP and Active Satellites GNSS Satellites in View Horizontal Dilution of Precision Multi-functional Satellite Augmentation System Mean Sea Level National Marine Electronics Association Non-volatile Memory Odometer Position Dilution of Precision Proprietary Protocol of MTK Pulse Per Second Parametry Zemli 1990 Quasi-Zenith Satellite System Receiver Autonomous Integrity Monitoring Return Link Message Recommended Minimum Specific GNSS Data Real-time Clock Radio Technical Commission for Maritime Services Satellite-Based Augmentation System Signal-to-noise Ratio LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 98 / 101 Abbreviation SV TXT URC UTC VDOP VTG WAAS WGS84 Description Satellites in View Text Transmission Unsolicited Result Code Coordinated Universal Time Vertical Dilution of Precision Course Over Ground and Ground Speed Wide Area Augmentation System World Geodetic System 1984 GNSS Module Series LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 99 / 101 GNSS Module Series 4 Appendix B GNSS Numbering Table 6: GNSS Numbering GNSS Type GPS GLONASS System ID 1 2 Satellite ID Signal ID 1–32 are reserved for GPS 1 = L1 C/A 33–64 are reserved for SBAS 65–99 1 = L1 C/A Galileo 3 1–36 6 = L1 BDS 4 1–36 1 = B1I QZSS 5 193–202 1 = L1 C/A NOTE 1. The table above is only applicable to standard NMEA messages. 2. The GPS Signal ID of Lx6 modules are 0. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 100 / 101 GNSS Module Series 5 Appendix C Special Characters Table 7: Special Characters Special Character [...] {…} Underline Definition Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification 101 / 101

L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 GNSS 模块系列 版本：1.1 日期：2022-08-22 状态：受控文件 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 关于文档 文档信息 标题 副标题 文档类别 文档状态 修订记录 版本 1.0 日期 2018-08-02 1.1 2022-08-22 L26C&&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 GNSS 模块系列 GNSS 协议规范 受控文件 变更表述 初始版本 1. 重组文档结构； 2. 新增适用模块 L26C R3.0 和 L76C R3.0； 3. 新增适用模块星系支持情况的说明及备注信息（第 1 章）； 4. 新增 NMEA 协议消息结构（第 2.1 章）； 5. 更新$RESET 消息的参数对应冷启动方式的取值（第 3.2.2 章）； 6. 更新$CFGPRT 消息的、、和 参数（第 3.3.1 章）； 7. 更 新 $CFGTP 消 息 的 参 数 以 及 $CFGNMEA 消 息 的 参数（第 3.3.4、3.3.5 章）； 8. 更新$CFGSYS 消息的参数以及$CFGSAVE 消息的 参数（第 3.3.6、3.3.8 章）； 9. 新增$CFGGEOID 和$AIDINFO 消息（第 3.3.7、3.3.12 章）； 10. 新增 GNSS 标识符（第 5 章）。 上海移远通信技术股份有限公司 3 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 目录 关于文档 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 2 NEMA 协议............................................................................................................................................ 9 2.1 NMEA 协议消息结构 .................................................................................................................. 9 2.2 标准语句 ................................................................................................................................... 10 2.2.1 RMC .............................................................................................................................. 10 2.2.2 GGA............................................................................................................................... 12 2.2.3 GSV ............................................................................................................................... 15 2.2.4 GSA ............................................................................................................................... 17 2.2.5 VTG ............................................................................................................................... 18 2.2.6 GLL................................................................................................................................ 20 2.2.7 ZDA ............................................................................................................................... 21 2.2.8 GST ............................................................................................................................... 23 3 专有协议 .............................................................................................................................................. 25 3.1 专有协议消息结构 .................................................................................................................... 25 3.2 消息定义 ................................................................................................................................... 26 3.2.1 产品信息（PDTINFO）................................................................................................. 26 3.2.2 复位（RESET） ............................................................................................................ 27 3.2.3 正确执行命令的回应（OK） ......................................................................................... 28 3.2.4 命令错误的回应（Fail） ................................................................................................ 28 3.3 配置消息（Config Message） ................................................................................................. 29 3.3.1 串口配置（CFGPRT）.................................................................................................. 29 3.3.2 消息输出配置（CFGMSG） ......................................................................................... 31 3.3.3 定位配置（CFGNAV）.................................................................................................. 32 3.3.4 授时脉冲配置（CFGTP） ............................................................................................. 33 3.3.5 NMEA 配置（CFGNMEA） .......................................................................................... 35 3.3.6 卫星系统配置（CFGSYS） .......................................................................................... 36 3.3.7 高程配置（CFGGEOID） ............................................................................................. 37 3.3.8 保存配置（CFGSAVE）................................................................................................ 38 3.3.9 加载配置（CFGLOAD） ............................................................................................... 39 3.3.10 清除配置（CFGCLR）.................................................................................................. 40 3.3.11 查询辅助数据（CFGAID）............................................................................................ 40 3.3.12 查询辅助数据（AIDINFO）........................................................................................... 42 3.4 导航结果消息（Navigation Result Message） ........................................................................ 43 3.4.1 位置信息（NAVPOS）.................................................................................................. 43 3.4.2 速度信息（NAVVEL）................................................................................................... 45 3.4.3 时间信息（NAVTIME）................................................................................................. 46 上海移远通信技术股份有限公司 4 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3.4.4 定位速度精度信息（NAVACC） ................................................................................... 47 3.5 其他消息（Misc Message） .................................................................................................... 48 3.5.1 查询天线状态检测（ANTSTAT1） ................................................................................ 48 4 附录 A 术语缩写 ................................................................................................................................. 50 5 附录 B GNSS 标识符 .......................................................................................................................... 51 上海移远通信技术股份有限公司 5 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 表格索引 表 1：NMEA 语句结构.................................................................................................................................. 9 表 2：发送设备标识符助记码（TalkerID） ................................................................................................ 10 表 3：消息结构 ........................................................................................................................................... 25 表 4：消息类别和 ID................................................................................................................................... 32 表 5：术语缩写 ........................................................................................................................................... 50 表 6：GNSS 标识符 ................................................................................................................................... 51 上海移远通信技术股份有限公司 6 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 图片索引 图 1：NMEA 协议消息结构 .......................................................................................................................... 9 图 2：消息格式 ........................................................................................................................................... 25 上海移远通信技术股份有限公司 7 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 1 引言 移远通信 L26C、L26C R3.0、L76C 和 L76C R3.0 GNSS 模块支持 GPS、BDS（和 QZSS）定位，默 认支持 GPS + BDS。模块可以同时快速捕获跟踪 GPS L1 C/A、BDS B1I（和 QZSS L1 C/A）信号，是各 种垂直行业实现精准定位和导航的理想解决方案。 本文档主要介绍用于上报 GNSS 信息的 NMEA 0183 通用协议输出语句，还介绍用于控制和配置模块 所需的专有协议命令。 备注 1. 仅 L26CNR02A01 和 L76CNR01A04 及之后固件版本支持 QZSS 定位（默认打开）。 2. 请使用本文档列出的命令控制或配置模块；对本文档未列出的其他命令情况，移远通信不承担任何责 任。 上海移远通信技术股份有限公司 8 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 2 NEMA 协议 2.1 NMEA 协议消息结构 每一帧的起始字段，固定 均为 $ 地址字段，包含了Talker ID和语句的属性 以 * 开始，校验和为8位 异或的校验和转换成的十六 进制的数 数据字段，使用 , 隔开 结束字符，固定为 $ () [,] * 校验和的计算范围 图 1：NMEA 协议消息结构 表 1：NMEA 语句结构 字段 描述 $ NMEA 语句的起始字段（Hex 0x24）。 NMEA 标准语句： 通用地址字段由 5 个字符（大写字母）组成。通用地址字段前两个字母是发送设备标识符 （TalkerID），详见表 2：发送设备标识符助记码（TalkerID），用于定义所传输数据的定 位模式。通用地址字段的后三个字符为标准语句标识符（SentenceFormatter），用于定义 语句中其它数据的格式和类型。 语句中的数据字段跟在定界符','之后。 由于存在可变长度字段和空字段，只有通过观察字段定界符','才能确定特定数据字段 在一条语句中的位置。因而应通过对定界符的计数来确定字段位置，而不应通过对接收字 符总个数的计数来确定字段位置。 所有的语句中都应包含校验和字段。校验和字段是语句中的最后一个字段，在校验和定界 符'*'之后。 校验和是对语句中所有字符的 8 位（不包括起始和结束位）进行异或运算，所有字符是指 在定界符'$'与'*'之间，但不包括这些定界符的全部字符，包括','在内。 NMEA 语句的结束字符（Hex 0x0D 0x0A）。 上海移远通信技术股份有限公司 9 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 表 2：发送设备标识符助记码（TalkerID） GNSS 星系配置 TalkerID (NMEA V3.0) GPS GP BDS BD QZSS GP 组合星系 GN TalkerID (NMEA V4.1) GP GB GP GN 2.2 标准语句 本章节介绍模块支持的 NMEA 0183 标准语句。 2.2.1 RMC RMC 表示推荐的最少专用 GNSS 数据。本语句包含 GNSS 接收机提供的时间、日期、位置、航迹向 和速度数据。 类型： 输出。 格式： //NMEA V3.0： $RMC,,,,,,,,,,,,* //NMEA V4.1（默认）： $RMC,,,,,,,,,,,,,* 上海移远通信技术股份有限公司 10 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 参数： 字段 $ RMC 格式 单位 示例 描述 - - 字符串，2 位 - 字符串，3 位 - hhmmss.ss - 字符 - ddmm.mmmm - 字符 - dddmm.mmmm - 字符 - 十进制 节 十进制 度 ddmmyy - $ GN RMC 070700.00 A 3149.3327 N 11706.9143 E 0.048 161221 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。 详见表 2：发送设备标识符助记码（TalkerID）。 推荐的最少专用 GNSS 数据。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） ss：秒的十进制小数（可变长度，2~3 位） 定位系统状态。 A = 数据有效 V = 导航接收机告警 纬度。 dd：度（00~90） mm：分（00~59） mmmm：分的十进制小数（可变长度，4~6 位） 对于 NMEA V4.1，数据无效时，此字段为空。 纬度方向。 N= 北 S= 南 对于 NMEA V4.1，数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmm：分的十进制小数（可变长度，4~6 位） 对于 NMEA V4.1，数据无效时，此字段为空。 经度方向。 E= 东 W= 西 对于 NMEA V4.1，数据无效时，此字段为空。 对地速度。 对于 NMEA V4.1，数据无效时，此字段为空。 对地真航向（暂不支持）。 对于 NMEA V3.0，此字段固定为 0.000； 对于 NMEA V4.1，此字段为空。 日期。 dd：日 mm：月 yy：年 上海移远通信技术股份有限公司 11 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 字段 格式 - - 单位 示例 - - - - 字符 - A 字符 十六进制 字符 - V - *1B - - 描述 数据无效时，此字段为空。 磁偏角（暂不支持）。 磁偏角方向（暂不支持）。 对于 NMEA V3.0，此字段固定为 E（E = 东）。 对于 NMEA V4.1，此字段为空。 模式指示。 A = 自主式模式，卫星系统处于非差分定位模 式 D = 差分模式，卫星系统处于差分定位模式； 基于地面站或 SBAS 的修正 N = 无定位，卫星系统没有用于位置定位，或 定位无效 导航状态（暂不支持）。 始终为'V'（导航状态无效，设备不能提供导 航状态指示）。 （此参数仅 NMEA V4.1 版本支持。） 校验和。 回车换行。 示例： 以 L26C 为例： //NMEA V3.0： $GNRMC,061146.000,A,3149.334129,N,11706.913862,E,0.126,0.000,150122,,E,A*36 //NMEA V4.1： $GNRMC,070700.00,A,3149.3327,N,11706.9143,E,0.048,,161221,,,A,V*1B 2.2.2 GGA GGA 提供全球定位系统定位数据。本语句包含 GNSS 接收机提供的时间、位置和定位相关数据。 类型： 输出。 上海移远通信技术股份有限公司 12 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 格式： $GGA,,,,,,,,,,M,,M,,* 参数： 字段 $ GGA 格式 字符串，2 位 字符串，3 位 单位 - hhmmss.ss - ddmm.mmmm - 字符 - dddmm.mmmm - 字符 - 示例 描述 $ GN GGA 070700.00 3149.3327 N 11706.9143 E 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见 表 2：发送设备标识符助记码（TalkerID）。 GGA 提供全球定位系统定位数据。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） ss：秒的十进制小数（可变长度，2~3 位） 纬度。 dd：度（00~90） mm：分（00~59） mmmm：分的十进制小数（可变长度， 4~6 位） 对于 NMEA V4.1，数据无效时，此字段 为空。 纬度方向。 N= 北 S= 南 对于 NMEA V4.1，数据无效时，此字段 为空。 经度。 ddd：度（000~180） mm：分（00~59） mmmm：分的十进制小数（可变长度， 4~6 位） 对于 NMEA V4.1，数据无效时，此字段 为空。 经度方向。 E= 东 W= 西 对于 NMEA V4.1，数据无效时，此字段 为空。 上海移远通信技术股份有限公司 13 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 字段 格式 单位 示例 十进制，1 位 - 1 1) 十进制，2 位 - 16 十进制 - 0.91 十进制 米 57.1 M 字符 十进制 M 字符 十六进制 字符 - M 米 - - M - - - - - *67 - - 描述 GPS 定位模式/状态指示。 0 = 定位不可用或无效 1 = GPS SPS 模式，定位有效 2 = 差分 GPS，SPS 模式，或 SBAS， 定位有效 6 = 估算（航位推算）模式 使用的卫星数。 水平精度因子。 对于 NMEA V3.0，范围为 0.000~127.000，不定位时值为 127.000； 对于 NMEA V4.1，范围为 0.00~99.99， 不定位时值为 99.99。 平均海平面以上海拔（大地水准面）。 （小数可变长度，1~3 位）。 对于 NMEA V4.1，数据无效时，此字段 为空。 的单位，固定为 M。 对于 NMEA V4.1，数据无效时，此字段 为空。 大地水准面差距（WGS84 基准面与平均 海平面之间的差值）。 默认输出为空。 大地水准面差距单位，固定为 M。 对于 NMEA V4.1，数据无效时，此字段 为空。 差分卫星导航系统数据龄期（暂不支持）。 差分基准站标识号（暂不支持）。 校验和。 回车换行。 示例： 以 L26C 为例： //NMEA V3.0： $GNGGA,092619.000,3149.3322,N,11706.9500,E,1,16,1.084,50.6,M,,M,,*62 //NMEA V4.1（默认）： $GNGGA,070700.00,3149.3327,N,11706.9143,E,1,16,0.91,54.1,M,,M,,*67 上海移远通信技术股份有限公司 14 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 备注 1. NMEA 0183 协议指示 GGA 消息为 GPS 系统特有；但当接收机配置为多星系时，GGA 消息的内容 将从多星系解决方案中生成。 2. 1) NMEA 0183 协议定义的使用中卫星数量范围为 00~12，然而，在多星系解决方案中，使用的卫星 数量可能超过 12 颗。 3. NMEA GGA 语句中的参数默认为空，可以使用指令$CFGGEOID,1 开启显示。 2.2.3 GSV GSV 表示可视的 GNSS 卫星。本语句包含可视的卫星数、卫星标识号、仰角、方位角和信噪比。每次 传送，一个 GSV 语句只能包含最多 4 颗卫星的数据，因此可能需要多个语句才能获得完整的信息。数据字 段的前两个字段表示传输的语句总数和语句编号。 类型： 输出。 格式： //NMEA V3.0： $GSV,,,{,,,,}* //NMEA V4.1（默认）： $GSV,,,{,,,,}, * 参数： 字段 格式 单位 $ - - 字符串，2 位 - GSV 字符串，3 位 - 十进制 - 十进制 - 十进制 - 示例 $ GP GSV 3 01 11 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见表2： 发送设备标识符助记码（TalkerID）。 可视的GNSS卫星。 语句总数。范围：1~9。 语句编号。 对于 NMEA V3.0，范围：1 至。 对于 NMEA V4.1，范围：01 至。 可视的卫星总数。 上海移远通信技术股份有限公司 15 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 字段 格式 单位 参数循环开始。循环次数：1~4 次 示例 十进制 - 02 参数循环结束 十进制 十进制 十进制 度 34 度 277 dB-Hz 41 十进制 - 0 十六进制 - *57 字符 - - 描述 卫星标识号。 详见表 6：GNSS 标识符。 仰角。范围：00~90。 真方位角。范围：000~359。未跟踪时为空。 载噪比（C/N0）。范围：00~99。未跟踪时为空。 信号标识符。默认为 0（0 = '所有信号'）。 （此参数仅 NMEA V4.1 版本支持） 校验和。 回车换行。 示例： 以 L26C 为例： //NMEA V3.0： $GPGSV,3,1,12,3,8,241,34,4,51,295,42,8,26,199,39,9,19,316,36*4C $GPGSV,3,2,12,16,67,331,43,18,9,72,37,26,46,39,43,27,55,178,44*4A $GPGSV,3,3,12,31,32,99,5,34,64,55,41,35,51,161,37,36,42,134,41*4C $BDGSV,2,1,8,162,37,230,5,163,5,,32,164,30,119,5,165,17,251,5*6D $BDGSV,2,2,8,166,82,168,35,167,65,257,33,169,80,306,35,170,54,250,32*55 //NMEA V4.1： $GPGSV,3,01,11,02,34,277,41,03,16,043,35,05,04,215,35,06,69,333,48,0*57 $GPGSV,3,02,11,09,25,110,41,12,31,305,43,17,55,116,46,19,76,088,46,0*56 $GPGSV,3,03,11,23,23,077,40,25,04,328,32,28,05,171,36,0*67 $GBGSV,3,01,12,01,37,145,42,02,34,225,39,03,44,188,42,04,25,123,37,0*4C $GBGSV,3,02,12,05,17,249,36,06,30,169,38,07,03,188,31,08,69,027,43,0*4E $GBGSV,3,03,12,09,09,186,34,10,15,211,36,12,26,306,40,13,60,316,44,0*48 备注 1. 'GN'标识符不可用于该语句。如果可以多个卫星系统可视，则设备输出多条 GSV 语句（用不同的 发送设备标识符表示相应的卫星）。 2. 可视的 QZSS 卫星信息在 GPS 语句中上报。 上海移远通信技术股份有限公司 16 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 2.2.4 GSA GSA 表示 GNSS 精度因子（DOP）与有效卫星。本语句包含 GNSS 接收机工作模式，GGA 语句报告 的导航解算中用到的卫星以及精度因子的值。 类型： 输出。 格式： //NMEA V3.0： $GSA,,{,},,,* //NMEA V4.1（默认）： $GSA,,{,},,,* 参数： 字段 $ GSA 格式 单位 示例 - - $ 字符串，2 位 - GN 字符串，3 位 - GSA 字符 - A 十进制 - 3 参数循环开始。循环次数：12 次 十进制 - 02 参数循环结束 十进制 - 1.29 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见表2：发 送设备标识符助记码（TalkerID）。 GNSS精度因子（DOP）与有效卫星。 控制模式。 M = 手动，强制用于 2D 或 3D 定位模式 A = 自动，允许 2D/3D 定位模式自动变换 定位模式。 1 = 定位不可用 2 = 2D 定位 3 = 3D 定位 解算中用到的卫星标识号。 详见表 6：GNSS 标识符。 位置精度因子。 对于 NMEA V3.0，范围为 0.000~127.000，不定 位时值为 127.000； 对于 NMEA V4.1，范围为 0.00~99.99，不定位时 上海移远通信技术股份有限公司 17 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 字段 格式 十进制 十进制 十进制 十六进制 字符 单位 示例 - 0.63 - 1.12 - 1 - *0D - - 描述 值为 99.99。 水平精度因子。 对于 NMEA V3.0，范围为 0.000~127.000，不定 位时值为 127.000； 对于 NMEA V4.1，范围为 0.00~99.99，不定位时 值为 99.99。 垂直精度因子。 对于 NMEA V3.0，范围为 0.000~127.000，不定 位时值为 127.000； 对于 NMEA V4.1，范围为 0.00~99.99，不定位时 值为 99.99。 GNSS 系统标识符。详见表 6：GNSS 标识符。 （此参数仅 NMEA V4.1 版本支持） 校验和。 回车换行。 示例： 以 L26C 为例： //NMEA V3.0： $GNGSA,A,3,27,4,16,34,36,8,9,35,18,,,,1.840,1.017,1.533*18 $GNGSA,A,3,166,167,170,169,,,,,,,,,1.840,1.017,1.533*2B //NMEA V4.1： $GNGSA,A,3,02,04,05,06,09,12,17,19,20,25,33,36,1.29,0.63,1.12,1*0D $GNGSA,A,3,01,02,03,04,07,08,10,13,,,,,1.29,0.63,1.12,4*01 备注 1. 如果用于定位导航的卫星少于 12 颗，则剩余的字段将为空。如果用于定位导航的卫星超过 12 颗，则仅输出前 12 颗卫星的卫星标识号。 2. 解算中用到的 QZSS 卫星信息在 GPS 语句中上报。 2.2.5 VTG VTG 语句包含相对于地面的实际航向和速度。 上海移远通信技术股份有限公司 18 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 类型： 输出。 格式： $VTG,,T,,M,,N,,K,* 参数： 字段 $ VTG T M N K 格式 字符串，2 位 字符串，3 位 十进制 字符 十进制 字符 十进制 字符 十进制 字符 单位 度 度 节 km/h - 字符 - 十六进制 - 字符 - 示例 $ GN VTG T M 0.000 N 0.000 K A *3D - 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见表 2： 发送设备标识符助记码（TalkerID）。 航向超过地面和地面速度。 对地航向（真北）（暂不支持）。 航向标志，固定填 T。 对于 NMEA V4.1，数据无效时，此字段为空。 对地航向（磁北）（暂不支持）。 航向标志，固定填 M。 对于 NMEA V4.1，数据无效时，此字段为空。 对地速度。 对于 NMEA V4.1，数据无效时，此字段为空。 速率单位，固定填 N。 对于 NMEA V4.1，数据无效时，此字段为空。 对地速度。 对于 NMEA V4.1，数据无效时，此字段为空。 速率单位，固定填 K。 对于 NMEA V4.1，数据无效时，此字段为空。 模式指示。 A = 自主模式，卫星系统处于非差分定位模式 D = 差分模式，卫星系统处于差分定位模式；基 于地面站或 SBAS 的修正 N = 无定位，卫星系统没有用于位置定位，或定 位无效 校验和。 回车换行。 上海移远通信技术股份有限公司 19 / 51 示例： 以 L26C 为例： //NMEA V3.0 $GNVTG,0.000,T,,M,0.000,N,0.000,K,A*13 //NMEA V4.1 $GNVTG,,T,,M,0.000,N,0.000,K,A*3D L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 2.2.6 GLL GLL 表示地理位置—纬度和经度。本语句包含接收机的纬度与经度、定位时间和状态。 类型： 输出。 格式： $GLL,,,,,,,* 参数： 字段 $ GLL 格式 字符串，2 位 字符串，3 位 单位 - ddmm.mmmm - 字符 - dddmm.mmmm - 示例 描述 $ GN GLL 3149.3318 N 11706.9138 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见表 2： 发送设备标识符助记码（TalkerID）。 地理位置—纬度和经度。 纬度。 dd：度（00~90） mm：分（00~59） mmmm：分的十进制小数（可变长度，4~6 位） 对于 NMEA V4.1，数据无效时，此字段为空。 纬度方向。 N= 北 S= 南 对于 NMEA V4.1，数据无效时，此字段为空。 经度。 ddd：度（000~180） mm：分（00~59） 上海移远通信技术股份有限公司 20 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 字段 格式 字符 hhmmss.ss 字符 字符 十六进制 字符 单位 - 示例 E 112917.00 A A *7E - 描述 mmmm：分的十进制小数（可变长度，4~6 位） 对于 NMEA V4.1，数据无效时，此字段为空。 经度方向。 E= 东 W= 西 对于 NMEA V4.1，数据无效时，此字段为空。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） ss：秒的十进制小数（可变长度，2~3 位） 定位系统状态。 V = 数据无效 A = 数据有效 模式指示。 A = 自主模式，卫星系统处于非差分定位模式 D = 差分模式，卫星系统处于差分定位模式； 基于地面站或 SBAS 的修正 N = 无定位，卫星系统没有用于位置定位，或 定位无效 校验和。 回车换行。 示例： 以 L26C 为例： //NMEA V3.0 $GNGLL,3149.3311,N,11706.9131,E,113002.000,A,A*42 //NMEA V4.1 $GNGLL,3149.3318,N,11706.9138,E,112917.00,A,A*7E 2.2.7 ZDA ZDA 表示时间与日期。本语句主要是用于输出 UTC 时间，日、月、年及本地时区。 类型： 输出。 上海移远通信技术股份有限公司 21 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 格式： $ZDA,,,,,,* 参数： 字段 $ ZDA 格式 单位 示例 - - $ 字符串，2 位 - GN 字符串，3 位 - ZDA hhmmss.ss - 061932.00 十进制 十进制 十进制 十进制 十进制 十六进制 字符 日 18 月 01 年 2022 时 00 分 00 - 74 - - 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见表 2： 发送设备标识符助记码（TalkerID）。 时间与日期。 定位的 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） ss：秒的十进制小数（可变长度，2~3 位） 日。范围：01~31。 月。范围：01~12。 年。 本时区小时。00 至±13 小时。 本时区分钟。00 至±59 分钟。 校验和。 回车换行。 示例： 以 L26CNR02A01 为例： //NMEA V3.0： $GNZDA,075103.000,15,01,2022,00,00*4F //NMEA V4.1： $GNZDA,061932.09,18,01,2022,00,00*74 上海移远通信技术股份有限公司 22 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 备注 1. 针对 L26CNR01A03 和 L76CNR01A03 及之前的固件版本，NMEA V4.1 ZDA 语句的字段、 、始终为空。 2. 针对 L26CNR01A03 和 L76CNR01A03 之后的固件版本，数据无效时，ZDA 语句的字段、 、为空。 3. 针对 L26 R3.0 及 L76 R3.0，数据无效时，NMEA V4.1 ZDA 语句的字段、、 为空。 2.2.8 GST GST 语句主要用于输出 GNSS 伪距误差统计数据。 类型： 输出。 格式： $GST,,,,,,,,* 参数： 字段 $ GST 格式 单位 - - 字符串，2 位 - 字符串，3 位 - hhmmss.ss - 十进制 米 十进制 米 十进制 米 十进制 度 示例 $ GN GST 112917.00 1.4 - 描述 每条 NMEA 语句均以'$'开始。 发送设备标识符助记码（TalkerID）。详见表 2： 发送设备标识符助记码（TalkerID）。 GNSS 伪距误差统计数据。 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（00~59） ss：秒的十进制小数（可变长度，2~3 位） 伪距误差的均方差。最大值：3750000。 误差椭圆的半长轴。 误差椭圆的半短轴。 误差椭圆的半长轴指向，从正北起顺时针。 上海移远通信技术股份有限公司 23 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 字段 格式 十进制 十进制 十进制 十六进制 字符 单位 米 米 米 - 示例 1.0 1.2 2.5 *6A - 描述 纬度方向的误差均方差。 经度方向的误差均方差。 高度方向的误差均方差。 校验和。 回车换行。 示例： 以 L26C 为例： //NMEA V3.0： $GNGST,113002.000,1.0,,,,3.1,3.5,9.2*58 //NMEA V4.1： $GNGST,112917.00,1.4,,,,1.0,1.2,2.5*6A 备注 仅 L26C R3.0 和 L76C R3.0 支持 NMEA V3.0 GST 语句的、和字段。 上海移远通信技术股份有限公司 24 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3 专有协议 3.1 专有协议消息结构 每一帧的起始字段，固定 均为 $ $ 消息名变量字段 以 * 开始，校验和为8位 异或的校验和转换成的十六 进制的数 数据字段，使用 , 隔开 结束字符，固定为 ,[] * 校验和的计算范围 图 2：消息格式 芯片供应商专有协议中，输入和输出的语句统称为消息。每条消息均为全 ASCII 字符组成的字符串。 消息的基本格式为：$,[]*。 表 3：消息结构 字段 $ * 长度（字节） 1 变量 变量 1 2 2 描述 所有消息均以'$'（Hex 0x24）开始。 消息名。 不定数目的消息数据。 数据域结束符'*'（Hex 0x2A）。 校验和，计算方法为从'$'起到'*'之间的所有字符 （不包括'$'和'*'）的异或，以十六进制表示。 每条消息均以结束。 上海移远通信技术股份有限公司 25 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 备注 1. 每条消息的总长度不超过 256 个字节。消息名、数据字段和校验和中的字母均不区分大小写。 2. 大多数消息名既可以作为输入消息（即命令），又可以作为输出信息。同样的消息名作为输入时，用 于设定参数或查询当前的配置；用于输出时，则用于输出接收机信息或配置。 3.2 消息定义 3.2.1 产品信息（PDTINFO） 获取产品信息。接收机收到此命令后输出$PDTINFO 消息。 类型： 查询/输出。 格式： //查询： $PDTINFO,* //输出： $PDTINFO,,,,,,* 参数： 字段 格式 字符串 字符串 字符串 字符串 字符串 字符串 单位 - 描述 产品名称。 产品配置选项。 硬件版本号。 固件版本号。 产品 ID。 序列号。 结果： 返回查询结果。 上海移远通信技术股份有限公司 26 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 示例： $PDTINFO,*62 $PDTINFO,UM220,G1B1,V4.1,R3.0Build13260,080101000001,000101114303845*35 备注 L26C R3.0 和 L76C R3.0 模块无字段。 3.2.2 复位（RESET） 接收机复位。 类型： 命令。 格式： $RESET,,* 参数： 字段 格式 单位 十进制 - 十六进制 - 描述 复位类型。 0 = 软件复位 1 = 芯片级复位（看门狗复位） 2 = 板级复位 3 = 接收机停止（暂不支持） 复位时清除接收机保存的信息，对应的 Bit 置 1 代表复位时清除。 Bit 0 = 星历 Bit 1 = 预留 Bit 2 = 接收机位置和时间 Bit 3 = 预留 Bit 4 = 电离层修正参数和 UTC 参数 Bit 5, 6 = 预留 Bit 7 = 历书 几个常用的启动方式： h00 = 热启动 h01 = 温启动 hFF = 冷启动 上海移远通信技术股份有限公司 27 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 示例： //温启动： $RESET,0,h01*0C 备注 1. 启动复位时，复位参数不符会导致接收机启动状态错误。 2. 发生闰秒时，冷启动复位后，接收机同步到 UTC 时间可能只需要最多 25 分钟。 3.2.3 正确执行命令的回应（OK） 接收机正确执行命令的回应，该消息只在接收到命令的串口输出。 类型： 输出。 格式： $OK* 参数： 无。 示例： $OK*04 3.2.4 命令错误的回应（Fail） 输入命令错误的回应，该消息只在接收到命令的串口输出。 类型： 输出。 格式： $Fail,* 上海移远通信技术股份有限公司 28 / 51 参数： 字段 示例： $Fail,0*3E 格式 十进制 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 单位 - 描述 错误代码。 0 = 命令非法或参数格式错误 1 = 校验和错误 3.3 配置消息（Config Message） 3.3.1 串口配置（CFGPRT） 查询/设置串口配置，接收机收到此命令后输出$CFGPRT 消息。 类型： 查询/设置/输出。 格式： //查询： $CFGPRT,* //设置/输出： $CFGPRT,,,,,* 参数： 字段 格式 十进制 十六进制 十进制 单位 - bps 描述 输出端口号。 1 = 串口 1 如果该字段为空，则输出当前串口的配置。 默认值：h0。 输出端口为串口时，波特率可以设置为： 4800 9600 14400 19200 上海移远通信技术股份有限公司 29 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 字段 格式 十六进制 十六进制 单位 - 描述 38400 57600 115200 230400 输出端口非串口时，无意义。 输入协议，对应的 Bit 置 1 代表协议在该串口被开启。 Bit 0 = UNICORE 协议 Bit 1–4 = 预留 Bit 5 = RTCM2.3 协议 Bit 6 = 预留 Bit 7 = RTCM3.2 协议 Bit 8 = 预留 Bit 9 = 里程计输入协议（仅在组合导航产品中支持） Bit 10 = MEMS 输入协议（仅在组合导航产品中支持） 输出协议，对应的 Bit 置 1 代表协议在该串口被开启。 Bit 0 = UNICORE 协议 Bit 1 = NMEA 协议 Bit 2 = RTCM3.2 协议（暂不支持） Bit 3, 4 = 预留 结果： 返回查询/设置结果。 示例： //查询/输出： $CFGPRT,1*09 $CFGPRT,1,h0,19200,33,3*58 //设置： $CFGPRT,1,h0,9600,129,3*57 $OK*04 备注 1. 若需获取设置命令中部分参数未给出的默认值，可在未使用设置命令修改相关参数配置前，通过对应 的查询命令获取相应的默认值；若已使用设置命令修改过默认配置，可联系移远通信技术支持 （support@quectel.com）来获取相关默认配置信息。 2. AGNSS 辅助定位数据以 RTCM3.2 协议格式输入。 3. 使用 DGPS 功能时，建议波特率设为 115200bps。 上海移远通信技术股份有限公司 30 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3.3.2 消息输出配置（CFGMSG） 查询/设置某条消息的输出配置，接收机收到此命令后输出$CFGMSG 消息。 类型： 查询/设置/输出。 格式： //查询： $CFGMSG,,* //设置/输出： $CFGPRT,,,* 参数： 字段 格式 十进制 十进制 十进制 单位 - - 描述 消息类别（见表 4：消息类别和 ID）。 消息 ID（见表 4：消息类别和 ID）。 输出频度。消息的实际输出频度基于接收机的定位频度，其 值的设定含义为进行 N 次定位解算后输出一次选定消息。比 如，当通过$CFGNAV 配置接收机的定位频度为 2 Hz 时，如 果设定为 1，则该消息每秒输出 2 次；如果设 定为 2，则该消息每秒输出 1 次；如果设定为 0，则 关闭该消息输出。 每条消息都有其设置范围。如果设定值超出范围，则该消息 无效。 结果： 返回查询/设置结果。 示例： //查询/输出： $CFGMSG,0,1*1A $CFGMSG,0,1,1*07 //设置： $CFGMSG,0,1,1 *07 $OK*04 上海移远通信技术股份有限公司 31 / 51 表 4：消息类别和 ID 消息名 NMEA 语句 GGA GLL GSA GSV RMC VTG ZDA GST 导航结果消息 NAVPOS NAVVEL NAVTIME NAVACC 其他消息 Reserved ANTSTAT1 类别 0 0 0 0 0 0 0 0 1 1 1 1 预留 3 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 ID 频度设置范围 最高输出频度 0 0~5 1 0~5 2 0~5 3 0~5 4 0~5 5 0~5 6 0~5 7 0~5 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 0 0~5 1 0~5 2 0~5 3 0~5 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 预留 - 3 1 预留 1 Hz（不可修改） 3.3.3 定位配置（CFGNAV） 查询/设置当前的定位配置，接收机收到此命令后输出$CFGNAV 消息。 类型： 查询/设置/输出。 上海移远通信技术股份有限公司 32 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 格式： //查询： $CFGNAV,* //设置/输出： $CFGNAV,,,* 参数： 字段 格式 十进制 十进制 十六进制 单位 毫秒 毫秒 - 描述 原始观测量输出频度。 此值目前无作用。 定位频度。默认值：1000。 支持的值包括 1000（1 Hz）、500（2 Hz）、200（5 Hz）。 大气修正控制，对应的 Bit 置 1 代表开启相应的修正。 Bit 0 = 电离层修正 Bit 1 = 对流层修正 结果： 返回查询/设置结果。 示例： //查询/输出： $CFGNAV,*37 $CFGNAV,1000,1000,3*04 //设置： $CFGNAV,1000,1000,3*04 $OK*04 3.3.4 授时脉冲配置（CFGTP） 查询/设置当前的授时脉冲配置，接收机收到此命令后输出$CFGTP 消息。 类型： 查询/设置/输出。 上海移远通信技术股份有限公司 33 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 格式： //查询： $CFGTP,* //设置/输出： $CFGTP,,,,,,* 参数： 字段 格式 十进制 十进制 十六进制 十进制 十进制 十进制 单位 毫秒 毫秒 - 纳秒 纳秒 纳秒 描述 授时脉冲频度，默认值：1000000。 授时脉冲宽度。 其最大值不应超过对应值减1 μs。上升沿与整授 时脉冲频度对齐时为高电平宽度，下降沿与整授时脉冲频度 对齐时为低电平宽度。 授时脉冲的配置，包括： Bit 0： 置 0 表示关闭授时脉冲输出 置 1 表示打开授时脉冲输出 Bit 1： 置 0 表示上升沿与整秒对齐 置 1 表示下降沿与整秒对齐 Bit 2： 置 0 表示只在授时有效（能够准确同步到设定的时标）时才 输出授时脉冲 置 1 表示总是输出授时脉冲 天线延迟。范围：-32768 ~ 32767。 射频单元延迟。范围：-32768 ~ 32767。 用户设定的延迟。 延迟设定为负数会使授时脉冲的边沿推迟出现； 修改延迟可能会导致秒脉冲在调整期内精度下降。 结果： 返回查询/设置结果。 上海移远通信技术股份有限公司 34 / 51 示例： //查询/输出： $CFGTP,*6A $CFGTP,1000000,500000,1,0,800,0*7B //设置： $CFGTP,1000000,500000,1,0,800,0*7B $OK*04 备注 此命令仅 L26C 与 L76C 支持。 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3.3.5 NMEA 配置（CFGNMEA） 查询/设置当前的 NMEA 配置，接收机收到此命令后输出$CFGNMEA 消息。 类型： 查询/设置/输出。 格式： //查询： $CFGNMEA,* //设置/输出： $CFGNMEA,* 参数： 字段 格式 十六进制 单位 描述 输出的 NMEA 协议版本。 h30 = 在标准 NMEA V3.0 基础上扩展 BDS 相关语句的协议 - 版本 h51 = 在标准 NMEA V4.1 基础上扩展 BDS 相关语句的协议 版本 结果： 返回查询/设置结果。 上海移远通信技术股份有限公司 35 / 51 示例： //查询/输出： $CFGNMEA,*69 $CFGNMEA,h51*05 //设置： $CFGNMEA,h51*05 $OK*04 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3.3.6 卫星系统配置（CFGSYS） 查询/设置当前的卫星系统配置。查询时，接收机收到该命令后输出$CFGSYS 消息。设置时，接收机 收到该命令后会自动复位，设置的开启卫星频点在复位后生效。 类型： 查询/设置/输出。 格式： //查询： $CFGSYS,* //设置/输出： $CFGSYS,* 参数： 字段 格式 单位 十六进制 - 描述 开启的卫星频点，对应的 Bit 置 1 代表开启。 Bit 0 = GPS L1 Bit 1–3 = 预留 Bit 4 = BDS B1 Bit 5–15 = 预留 Bit 16 = BDS B1C Bit 17–31 = 预留 结果： 返回查询/设置结果。 上海移远通信技术股份有限公司 36 / 51 示例： //查询/输出 $CFGSYS,*37 $CFGSYS,h11*5F //设置 $CFGSYS,h11*5F $OK*04 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 备注 L26CNR02A01 和 L76CNR01A04 及之后的固件版本支持 QZSS 定位（默认打开）。支持的卫星系 统配置如下： ⚫ BDS ⚫ GPS + QZSS ⚫ GPS + BDS + QZSS L26C R3.0、L76C R3.0 模块以及 L26CNR02A01 和 L76CNR01A04 之前的固件版本支持如下三种 卫星系统配置： ⚫ GPS ⚫ BDS ⚫ GPS + BDS 其他系统配置正在开发中。 3.3.7 高程配置（CFGGEOID） 设置或查询高程配置，接收机收到查询指令时输出$CFGGEOID 消息。 类型： 查询/设置/输出。 格式： //查询 $CFGGEOID,* //设置/输出 $CFGGEOID,* 上海移远通信技术股份有限公司 37 / 51 参数： 字段 格式 十进制 结果： 返回查询/设置结果。 示例： //查询/输出： $CFGGEOID,*2E $CFGGEOID,0*1E //设置： $CFGGEOID,0*1E $OK*04 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 单位 - 描述 高程配置。默认值：0。 0 = 高程输出为椭球高 1 = 高程输出为海拔高 3.3.8 保存配置（CFGSAVE） 存储当前接收机配置，当前的配置被存储到 NOR Flash 中。 类型： 命令。 格式： $CFGSAVE,* 参数： 字段 格式 单位 十六进制 - 描述 需存储的配置类型。 Bit 0 = CFGPRT 配置 Bit 1 = CFGMSG 和 CFGNMEA 配置 Bit 2 = CFGNAV 配置 Bit 3–8 = 预留 如果为空，则保存所有的配置。 上海移远通信技术股份有限公司 38 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 结果： 返回执行结果。 示例： $CFGSAVE,h0F*71 $OK*04 备注 在输入$CFGSAVE 命令后 1 秒内请勿切断接收机电源。该过程中断电可能会导致当前接收机配置损坏， 如接收机损坏，其配置将恢复到出厂设置。 3.3.9 加载配置（CFGLOAD） 重新加载当前接收机配置时，将 NOR Flash 中存储的配置加载为当前接收机的配置，重启接收机后生 效。 类型： 命令。 格式： $CFGLOAD,* 参数： 字段 格式 单位 十六进制 - 描述 需重新加载的配置类型。 Bit 定义与$CFGSAVE 中相同；如果为空，则加载所有的配置。 结果： 返回执行结果。 示例： $CFGLOAD,h0F*76 $OK*04 上海移远通信技术股份有限公司 39 / 51 备注 该命令修改的配置在复位接收机后生效。 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3.3.10 清除配置（CFGCLR） 清除当前接收机配置。当前配置和 NOR Flash 中存储的配置被同时恢复为出厂配置，重启或重新上电 接收机后生效。 类型： 命令。 格式： $CFGCLR,* 参数： 字段 格式 十六进制 单位 - 描述 需清除的配置类型。 Bit 定义与$CFGSAVE 中相同；如果为空，则清除 所有的配置。 结果： 返回执行结果。 示例： $CFGCLR,h0F*2D $OK*04 备注 该命令修改的配置在复位接收机后生效。 3.3.11 查询辅助数据（CFGAID） 查询接收到的辅助数据，接收机收到此命令后输出$CFGAID 语句。 上海移远通信技术股份有限公司 40 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 类型： 查询/输出。 格式： $CFGAID,* 参数： 字段 格式 十进制 单位 - 描述 星系。 0 = GPS 1 = BDS 结果： 返回查询结果。 查询结果消息格式： $CFGAID,,,,* 结果中包含的参数如下所示： 字段 格式 十进制 十六进制 十六进制 十六进制 单位 - - 描述 星系。 0 = GPS 1 = BDS 星历 bitmap。共 32 位，低位为低卫星号。 0 = 星历无效 1 = 星历有效 历书 bitmap。共 32 位，低位为低卫星号。 0 = 历书无效 1 = 历书有效 辅助数据类型 bitmap。对应 Bit 置 1 代表收到并解析。 Bit 0 = 预留 Bit 1 = 电离层参数 Bit 2 = UTC 参数 Bit 3 = 星历参数 Bit 4 = 历书参数 Bit 5 = 位置时间参数 Bit 6, 7 = 预留 上海移远通信技术股份有限公司 41 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 示例： $CFGAID,0*12 $CFGAID,0,C1B26E01,00000000,2E*39 备注 此命令仅以下模块与固件版本支持： ⚫ L26C：L26CNR01A03、L26CNR01A02、L26CNR01A01 ⚫ L26C R3.0 ⚫ L76C：L76CNR01A03、L76CNR01A02、L76CNR01A01 ⚫ L76C R3.0 3.3.12 查询辅助数据（AIDINFO） 查询接收到的辅助数据。接收机收到此命令后输出$AIDINFO 语句。 类型： 查询/输出。 格式： $AIDINFO,* 结果： 返回查询结果。 查询结果消息格式： $AIDINFO,,,,,,,,,* 结果中包含的参数如下所示： 字段 格式 十六进制 十六进制 单位 - 描述 GPS 星历的接收状态。只要接收到的数据校验通过，则相应位 置 1；如果 GPS 系统没有使能，则此字段为空。 GPS星历有效且可用于定位，则相应位置1；如果GPS系统没 有使能，则此字段为空。 上海移远通信技术股份有限公司 42 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 十六进制 - 十六进制 - 十六进制 - 十六进制 - 十六进制 - 十六进制 - 十六进制 - BDS 星历的接收状态。只要接收到的数据校验通过，则相应位 置 1；如果 BDS 系统没有使能，则此字段为空。 BDS 星历有效且可用于定位，则相应位置 1；如果 BDS 系统没 有使能，则此字段为空。 暂不支持，此字段为空。 暂不支持，此字段为空。 暂不支持，此字段为空。 暂不支持，此字段为空。 辅助类型： Bit 0：有GPS星历辅助 Bit 1：有BDS星历辅助 Bit 2, 3：预留 Bit 4：辅助位置有效 Bit 5：使用辅助位置 Bit 6, 7：预留 Bit 8：辅助时间有效 Bit 9：使用辅助时间 Bit 10–15：预留 示例： $AIDINFO,*6E $AIDINFO,0x003FFFFFF7,0x000000FA00,0x0000003F7F,0x0000001A3F,,,,,0x0003*27 备注 此命令仅以下模块固件版本支持： ⚫ L26C：L26CNR02A01 ⚫ L76C：L76CNR01A04 3.4 导航结果消息（Navigation Result Message） 3.4.1 位置信息（NAVPOS） 输出接收机位置信息。 上海移远通信技术股份有限公司 43 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 类型： 输出。 格式： $NAVPOS,,,,,,,,,* 参数： 字段 格式 单位 十进制 毫秒 十六进制 - 十进制 - 十进制 米 十进制 米 十进制 米 十进制 度 十进制 度 十进制 米 描述 定位解对应的时间。 时间的含义取决于当前定位使用的系统，优先级为 GPS > BDS。 对于 GPS 和 BDS，此字段为对应系统的周内毫秒计数。 当前定位使用的系统。 Bit 0 = GPS Bit 2 = BDS 当前定位质量。 0 = 无效定位 1 = 外部设置 2 = 粗略定位 3 = 精确定位 ECEF 坐标系 X。 ECEF 坐标系 Y。 ECEF 坐标系 Z。 接收机纬度，北纬为正，南纬为负。 接收机经度，东经为正，西经为负。 接收机椭球高。 示例： $NAVPOS,282201000,5,3,-2160481.168,4383619.182,4084735.203,40.078998,116.236534,52.843847* 1C 备注 此消息仅 L26C 支持。 上海移远通信技术股份有限公司 44 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3.4.2 速度信息（NAVVEL） 输出接收机速度信息。 类型： 输出。 格式： $NAVVEL,,,,,,,* 参数： 字段 格式 十进制 单位 毫秒 十六进制 - 十进制 十进制 十进制 十进制 十进制 - 米/秒 米/秒 米/秒 米/秒 描述 定位解对应的时间。 时间的含义取决于当前定位使用的系统，优先级 为 GPS > BDS。对于 GPS 和 BDS，此字段为对 应系统的周内毫秒计数。 当前定位使用的系统。 Bit 0 = GPS Bit 2 = BDS 当前定位质量。 0 = 无效定位 1 = 外部设置 2 = 粗略定位 3 = 精确定位 ECEF 坐标系 Vx。 ECEF 坐标系 Vy。 ECEF 坐标系 Vz。 晶振漂移的等效速度。 示例： $NAVVEL,282201000,5,3,0.000,0.000,0.000,31.785*2F 备注 此消息仅 L26C 支持。 上海移远通信技术股份有限公司 45 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3.4.3 时间信息（NAVTIME） 输出接收机时间信息。 类型： 输出。 格式： $NAVTIME,,,,,,,,,,, ,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 - - 秒 秒 描述 GPS 周。 GPS 周内秒。 GPS 时间质量。 0 = 无效 1 = 外部设置 2 = 粗略 3 = 精确 GLONASS 年（暂不支持）。 GLONASS 天（暂不支持）。 GLONASS 天开始的秒计数（暂不支持）。 GLONASS 时间质量（暂不支持）。 定义与相同。 BDS 周。 BDS 周内秒。 BDS 时质量；定义与相同。 BDS 时与 GPS 时的时差。 GLONASS 时与 GPS 时的时差（暂不支持）。 上海移远通信技术股份有限公司 46 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 示例： $NAVTIME,1848,282201.000291049,3,0,0,0.000000000,0,492,282187.000291134,3,0.000000085,0.000 000000*63 备注 此消息仅 L26C 支持。 3.4.4 定位速度精度信息（NAVACC） 输出接收机定位测速精度信息。 类型： 输出。 格式： $NAVACC,,,,,* 参数： 字段 格式 单位 hhmmss.ss - 字符 十进制 十进制 十进制 - 0.001 米 0.001 米/秒 0.001 度 描述 UTC 时间。 hh = 小时 mm = 分钟 ss.ss = 秒 数据有效标识。 V = 无效 A = 有效 水平定位精度，水平方向二维定位误差的均方差。 水平测速精度，水平方向二维测速误差的均方差。 地面航向精度。 示例： $NAVACC,085206.00,A,2480,70,1250*5D 上海移远通信技术股份有限公司 47 / 51 备注 此消息仅 L26C 支持。 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 3.5 其他消息（Misc Message） 3.5.1 查询天线状态检测（ANTSTAT1） 查询天线检测状态信息。 类型： 查询/输出。 格式： $ANTSTAT1,* 参数： 无。 结果： 返回查询结果。 查询结果消息格式： $ANTSTAT1,,* 结果中包含的参数如下所示： 字段 格式 单位 十进制 - 十进制 - 描述 天线检测状态。 0 = 初始化 1 = 未知 2 = 正常 3 = 短路 4 = 开路 天线供电状态。 0 = 断路，未检测到天线供电 上海移远通信技术股份有限公司 48 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 1 = 正常，检测到天线供电 2 = 未知 示例： $ANTSTAT1,*54 $ANTSTAT1,2,1*7B 备注 1. 仅 L26C 支持天线状态检测。 2. 外部天线检测电路不存在时，所查询到的外部天线检测状态信息无效。 3. 天线检测输出与引脚（Pin）电平状态（请参考 Quectel_L26C_硬件设计手册）的映射关系为： Pin 5、Pin 6 分别为高、低电平，该值为 2 时：正常 Pin 5、Pin 6 分别为低、高电平，该值为 3 时：短路 其他情况，该值为 1 时：未知 Pin 6 为高电平，该值为 0 时：未检测到天线供电 Pin 6 为低电平，该值为 1 时：检测到天线供电 PIN# 5 6 功能 ANT_DET ANT_ON 描述 有源天线短路状态。 高电平 - 天线正常 低电平 - 天线异常 天线供电控制。 高电平 - 关闭天线供电 低电平 - 开启天线供电 上海移远通信技术股份有限公司 49 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 4 附录 A 术语缩写 表 5：术语缩写 缩写 AGPS 2D 3D C/N0 GGA GLL GNSS GPS GSA GSV NMEA RMC RTK VTG UTC SPS SBAS PPS 英文全称 中文全称 Assisted Global Positioning System 辅助全球定位系统 2 Dimension 2维 3 Dimension 3维 Carrier-to-noise-density Ratio 载噪比 Global Positioning System Fix Data 全球定位系统定位数据 Geographic Position-Latitude and Longitude 地理位置—纬度和经度 Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 GNSS DOP and Active Satellites GNSS 精度因子（DOP）与有效 卫星 GNSS Satellites in View 可视的 GNSS 卫星 NMEA (National Marine Electronics NMEA（美国国家海洋电子协会） Association) 0183 Interface Standard 0183 接口标准 Recommended Minimum Specific GNSS 推荐的最少专用 GNSS 数据 Data Real-Time Kinematic 实时动态 Course Over Ground & Ground Speed 对地航向和对地速度 Coordinated Universal Time 协调世界时 Standard Positioning Service 标准定位服务 Satellite-Based Augmentation System 星基增强系统 Precise Positioning Service 精确定位服务 上海移远通信技术股份有限公司 50 / 51 L26C&L26C R3.0&L76C&L76C R3.0 GNSS 协议规范 5 附录 B GNSS 标识符 表 6：GNSS 标识符 卫星系统 系统标识符 GPS 1 GLONASS 2 Galileo 3 BDS 4 QZSS - SBAS - 卫星标识号 1~32 65~92 NMEA V3.0: 101~136 NMEA V4.1: 01~36 NMEA V3.0: 161~197 NMEA V4.1: 01~37 193、194、195、199 33~51 信号标识号/信号通道 1 = L1 C/A 1 = G1 C/A 1 = E5a 1 = B1I 1 = L1 C/A - 上海移远通信技术股份有限公司 51 / 51

EC2x&EG9x AWS IoT Platform Access Guide LTE Standard Module Series Rev. EC2x&EG9x_AWS_IoT_Platform_Access_Guide_V1.0 Date: 2020-08-24 Status: Preliminary www.quectel.com LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. DISCLAIMER WHILE QUECTEL HAS MADE EFFORTS TO ENSURE THAT THE FUNCTIONS AND FEATURES UNDER DEVELOPMENT ARE FREE FROM ERRORS, IT IS POSSIBLE THAT THESE FUNCTIONS AND FEATURES COULD CONTAIN ERRORS, INACCURACIES AND OMISSIONS. UNLESS OTHERWISE PROVIDED BY VALID AGREEMENT, QUECTEL MAKES NO WARRANTIES OF ANY KIND, IMPLIED OR EXPRESS, WITH RESPECT TO THE USE OF FEATURES AND FUNCTIONS UNDER DEVELOPMENT. TO THE MAXIMUM EXTENT PERMITTED BY LAW, QUECTEL EXCLUDES ALL LIABILITY FOR ANY LOSS OR DAMAGE SUFFERED IN CONNECTION WITH THE USE OF THE FUNCTIONS AND FEATURES UNDER DEVELOPMENT, REGARDLESS OF WHETHER SUCH LOSS OR DAMAGE MAY HAVE BEEN FORESEEABLE. 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 WITHOUT PERMISSION ARE FORBIDDEN. 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. 2020. All rights reserved. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 1 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide About the Document Revision History Version Date Author Description 1.0 2020-08-24 Domingo DENG Initial EC2x&EG9x_AWS_IoT_Platform_Access_Guide 2 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Contents About the Document .................................................................................................................................. 2 Table Index.................................................................................................................................................. 4 Figure Index ................................................................................................................................................ 5 1 Introduction ......................................................................................................................................... 6 1.1. Brief Introduction on AWS IoT.................................................................................................... 6 1.2. Document Overview................................................................................................................... 6 1.3. Applicable Modules .................................................................................................................... 7 2 AWS IoT Platform Access .................................................................................................................. 8 2.1. Accessing the AWS IoT Platform ............................................................................................... 8 2.2. Using Device Shadow Service................................................................................................. 16 2.2.1. Device Shadow Service ................................................................................................ 16 2.2.2. Subscribe and Publish Shadow Topics ......................................................................... 17 3 Example ............................................................................................................................................. 22 4 Appendix A References.................................................................................................................... 25 EC2x&EG9x_AWS_IoT_Platform_Access_Guide 3 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Table Index Table 1: Related Documents ...................................................................................................................... 25 Table 2: Terms and Abbreviations .............................................................................................................. 25 EC2x&EG9x_AWS_IoT_Platform_Access_Guide 4 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure Index Figure 1: Communication between AWS IOT and the Device ..................................................................... 6 Figure 2: Browse to the AWS IoT Console................................................................................................... 8 Figure 3: Create a Single Thing ................................................................................................................... 9 Figure 4: Name Your Thing .......................................................................................................................... 9 Figure 5: Choose 'Next'............................................................................................................................. 10 Figure 6: Create Certificate ........................................................................................................................ 10 Figure 7: Select the Appropriate Root CA...................................................................................................11 Figure 8: Download and Activate the Private Key and Certificate ..............................................................11 Figure 9: Certificates Created during Device Registration ........................................................................ 12 Figure 10: MQTTS Connection Address .................................................................................................... 13 Figure 12: Certificate Files Downloaded from AWS IoT ............................................................................ 14 Figure 13: Upload Certificate Files............................................................................................................. 14 Figure 14: Configure TLS ........................................................................................................................... 15 Figure 15: Connect to AWS IoT with MQTTS ............................................................................................ 16 Figure 16: Shadow Topics .......................................................................................................................... 17 Figure 17: Shadow Document.................................................................................................................... 18 Figure 18: Subscribe Shadow Topics......................................................................................................... 19 Figure 19: Publish Shadow Topics ............................................................................................................. 20 Figure 20: View Shadow State ................................................................................................................... 21 EC2x&EG9x_AWS_IoT_Platform_Access_Guide 5 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide 1 Introduction 1.1. Brief Introduction on AWS IoT AWS IoT provides secure, bi-directional communication between Internet-connected devices such as sensors, actuators, embedded micro-controllers, or smart appliances and the AWS Cloud. This enables to collect telemetry data from multiple devices, and store and analyze the data. AWS IoT Cloud platform supports TLS dual authentication for client certificates, in which MQTT can act as a message broker which provides a secure mechanism for devices and AWS IoT applications to publish and receive messages from each other. After importing certificates into Quectel module, the module can access to AWS IoT Cloud platform through MQTTS. Figure 1: Communication between AWS IOT and the Device 1.2. Document Overview This document mainly provides users with AWS IoT Cloud platform access method, including how to connect Quectel module to AWS IoT Cloud platform with MQTTS and the related AT command involved in the AWS IoT platform access process. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 6 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide 1.3. Applicable Modules This document is applicable to the following Quectel modules:  EC2x: EC25/EC21/EC20 R2.0/EC20 R2.1  EG9x: EG91/EG95 EC2x&EG9x_AWS_IoT_Platform_Access_Guide 7 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide 2 AWS IoT Platform Access This chapter mainly describes AWS IoT Cloud platform access process and how to use the device shadow service after accessing the AWS IoT. NOTE Before using AWS IoT services, an AWS account must be created. Please refer to the AWS offici al website link https://aws.amazon.com/premiumsupport/knowledgecenter/create-and-activate-aws-acc ount/ for details on how to create an AWS account. 2.1. Accessing the AWS IoT Platform 1. Register devices and get certificates A. Browse to the AWS IoT console B. In the navigation pane, choose 'Manage', and then choose 'Things'. C. If you do not have any IoT things registered in your account, then you don't have any things yet page is displayed. If you see this page, choose 'Register a thing'. Otherwise, choose 'Create'. Figure 2: Browse to the AWS IoT Console EC2x&EG9x_AWS_IoT_Platform_Access_Guide 8 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide D. On the 'Creating AWS IoT things' page, choose 'Create a single thing'. Figure 3: Create a Single Thing E. On the 'Add your device to the thing registry' page, enter a name for your thing, and then choose 'Next'. Figure 4: Name Your Thing EC2x&EG9x_AWS_IoT_Platform_Access_Guide 9 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 5: Choose 'Next' F. On the Add a certificate for your thing page, under 'One-click certificate creation', choose 'Create certificate'. Figure 6: Create Certificate G. Download your private key and certificate by choosing the Download links for each. Note that the keys cannot be retrieved after you close this page. H. For the root CA for AWS IoT, click on Download and select the appropriate one: RSA 2048 bit key: Amazon Root CA 1 ECC 256 bit key: Amazon Root CA 3 EC2x&EG9x_AWS_IoT_Platform_Access_Guide 10 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 7: Select the Appropriate Root CA I. Choose 'Activate' to activate your certificate. Certificates must be activated prior to use. J. You can either attach an existing policy, or create one. Choose 'Attach a policy' to attach a policy to your certificate that grants your device access to AWS IoT operations. Figure 8: Download and Activate the Private Key and Certificate Select the policy (or policies) to be attached, and choose Register thing. At this point, your device has been provisioned with AWS IoT and can begin to communicate. The certificates and keys created during device registration that need to be imported into the module are shown as below. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 11 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 9: Certificates Created during Device Registration 2. Find MQTTS connection address and port of devices A. Browse to the AWS IoT console B. In the navigation pane, choose 'Settings'. C. Your AWS IoT endpoint is displayed in Endpoint. It should look like 1234567890123- ats.iot.us-east-1.amazonaws.com. D. Make a note of this endpoint. Your account number and region name may be different from the example shown above. The steps above are shown in the figure below: EC2x&EG9x_AWS_IoT_Platform_Access_Guide 12 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 10: MQTTS Connection Address The MQTTS connection port supported by AWS IoT platform is shown as below. Figure 11: MQTTS Connection Port 3. Import certificates and connect to AWS IoT platform Import certificates into the module and connect the module to AWS IoT platform with AT command related to MQTTS. The process is shown as below. Step 1: Upload the certificate files and configure TLS. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 13 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 12: Certificate Files Downloaded from AWS IoT Figure 13: Upload Certificate Files EC2x&EG9x_AWS_IoT_Platform_Access_Guide 14 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 14: Configure TLS Step 2: Connect to AWS IoT with MQTTS. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 15 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 15: Connect to AWS IoT with MQTTS NOTE Some old FW required additional TLS configuration by AT command below: AT+QSSLCFG='ignoreinvalidcertsign' and AT+QSSLCFG='ignoremulticertchainverify'. 2.2. Using Device Shadow Service 2.2.1. Device Shadow Service Device shadow service, provided by AWS IoT Cloud platform, maintains a shadow which is a JSON document that is used to store and retrieve current state information for each device connected to AWS EC2x&EG9x_AWS_IoT_Platform_Access_Guide 16 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide IoT. For using shadow service, please subscribe and publish topics specified by the AWS IoT in JSON format through MQTT. For details, please refer to AWS IoT official website documentation through the link https://docs.aws.amazon.com/iot/latest/developerguide/io t-device-shadows.html. 2.2.2. Subscribe and Publish Shadow Topics Step 1: Sign in to the AWS IoT console, search 'IoT' in search bar, choose 'Manage'->'Things', select the created Thing, and on the pop-up page, choose 'Interact' in the Details column to view shadow topics which should be subscribed after the module accesses to AWS IoT, as shown below. Figure 16: Shadow Topics Step 2: On the page after clicking the created Thing, choose 'Shadow' in the Details column to view shadow document where the shadow state will update when receiving messages published from devices, as shown below. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 17 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 17: Shadow Document Step 3: Modules are to subscribe and publish shadow topics, as shown below. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 18 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 18: Subscribe Shadow Topics EC2x&EG9x_AWS_IoT_Platform_Access_Guide 19 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 19: Publish Shadow Topics Step 4: Back to 'Shadow Document' to view the shadow state, as shown below. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 20 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide Figure 20: View Shadow State EC2x&EG9x_AWS_IoT_Platform_Access_Guide 21 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide 3 Example This chapter provides examples for AWS IoT platform access authentication. The following shows the whole process of accessing the AWS IoT with MQTTS. //Import certificates into the module. AT+QFUPL='ca.pem',1206 CONNECT +QFUPL: 1206,5a63 OK AT+QFUPL='cc.pem',1220 CONNECT +QFUPL: 1220,3879 OK AT+QFUPL='ck.pem',1675 CONNECT +QFUPL: 1675,6136 OK AT+QFLST='*' +QFLST: 'UFS:ca.pem',1206 +QFLST: 'UFS:cc.pem',1220 +QFLST: 'UFS:ck.pem',1675 OK //Configure TLS. AT+QSSLCFG='clientkey',1,'UFS:ck.pem' OK AT+QSSLCFG='clientcert',1,'UFS:cc.pem' OK AT+QSSLCFG='cacert',1,'UFS:ca.pem' OK AT+QSSLCFG='ciphersuite',1,0XFFFF OK AT+QSSLCFG='seclevel',1,2 OK //Connect to AWS through MQTTS. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 22 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide AT+QMTCFG='ssl',1,1,1 OK AT+QMTOPEN=1,'af5c7l4oo3fcr-ats.iot.us-west-2.amazonaws.com',8883 OK +QMTOPEN: 1,0 AT+QMTCONN=1,'test' OK +QMTCONN: 1,0,0 //Connected to AWS IoT successfully. //Test shadow service. AT+QMTSUB=1,1,'$aws/things/MyIotThing/shadow/update/accepted',0 OK +QMTSUB: 1,1,0,0 AT+QMTSUB=1,1,'$aws/things/MyIotThing/shadow/update/rejected',0 OK +QMTSUB: 1,1,0,0 AT+QMTPUB=1,1,1,0,'$aws/things/MyIotThing/shadow/update' > { 'state': { 'reported': { 'color': 'red' } } } OK +QMTPUB: 1,1,0 +QMTRECV:1,0,'$aws/things/MyIotThing/shadow/update/accepted','{'state':{'reported':{'color' :'red'}},'metadata':{'reported':{'color':{'timestamp':1579138722}}},'version':15,'timestamp':1 579138722}' //Received the response from shadow service. //Disconnect from the AWS IoT. AT+QMTCLOSE=1 OK +QMTCLOSE: 1,0 NOTE EC2x&EG9x_AWS_IoT_Platform_Access_Guide 23 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide For the details of above commands, please refer to Document [1], Document [2] and Document [3] listed in Appendix A. EC2x&EG9x_AWS_IoT_Platform_Access_Guide 24 / 25 LTE Standard Module Series EC2x&EG9x AWS IoT Platform Access Guide 4 Appendix A References Table 1: Related Documents SN Document Name [1] Quectel_LTE_Standard_FILE_Application_Note [2] Quectel_LTE_Standard_MQTT_Application_Note Quectel_EC2x&EG9x&EM05_SSL_AT_ [3] Commands_Manual Remark LTE Standard FILE Application Note LTE Standard MQTT Application Note EC2x&EG9x&EM05 SSL AT Commands Manual Table 2: Terms and Abbreviations Abbreviation AWS IoT MQTT(S) TLS SSL Description Amazon Internet of Things Message Queuing Telemetry Transport (Security) Transport Layer Security Secure Sockets Layer EC2x&EG9x_AWS_IoT_Platform_Access_Guide 25 / 25

LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note BG96_MQTT_Attach_AWS_IoTCore_Application_Note LPWA Module Series Contents BG96_MQTT_Attach_AWS_IoTCore_Application_Note ......................................................................... 1 1. Module MQTTS attach AWS IoT Core. ............................................................................................... 2 1.1 Get the certificates ...................................................................................................................... 2 1.2 Connection address and port...................................................................................................... 4 1.3 Module load certificates and use the MQTTS connect AWS IoT Core: ..................................... 5 1.4 Use the Device Shadow service ................................................................................................. 6 2. Detailed AT command steps for module connection to AWS IoT core. ........................................ 7 2.1 Configure the network ................................................................................................................. 7 2.2 Load certificates .......................................................................................................................... 8 2.3 Active PDP context ................................................................................................................... 10 2.4 Configure SSL option ................................................................................................................ 11 2.5 Configure MQTT option ............................................................................................................ 12 2.6 MQTT connect and data interaction ......................................................................................... 12 Support band list....................................................................................................................................... 13 Quectel Wireless Solutions Co., Ltd. 1 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note 1. Module MQTTS attach AWS IoT Core. AWS IoT Core supports TLS client and server certificates authentication, with the MQTT protocol as a message broker. Module import certificates, then it can be used to connect the AWS IoT Core by MQTTS. Connection step as below: 1.1 Get the certificates Sign in to the AWS IoT platform and register your device in the registry. Certificates will be created in the enrolled device. Note that these certificates should downloaded to the local computer. These certificates will be imported into the module later. On the AWS website have details about how to register the device, refer to the link: https://docs.aws.amazon.com/iot/?id=docs_gateway Please save the certificates which the red box note in the below, this will load into the module, the certificates need active, then attach policy and attach thing. Create Policies: Quectel Wireless Solutions Co., Ltd. 2 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note Attach policy and thing: Quectel Wireless Solutions Co., Ltd. 3 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note 1.2 Connection address and port Find the MQTT connection server as below: AWS-IOT support connection port as bolew: Quectel Wireless Solutions Co., Ltd. 4 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note 1.3 Module load certificates and use the MQTTS connect AWS IoT Core: Load the certificates in the module: Configure TLS option: Quectel Wireless Solutions Co., Ltd. 5 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note Configure MQTTS and MQTT protocol version: Connect server: 1.4 Use the Device Shadow service In the Things->mydevice1->Interact, we can find the MQTT shadow tocpic. Use topics to enable applications and things to get, update, or delete the state information for a Thing. Quectel Wireless Solutions Co., Ltd. 6 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note The shadow data report use json format. 2.Detailed AT command steps for module connection to AWS IoT core. 2.1 Configure the network // AT+QCFG='nwscanmode', [,] //: 0 Automatic // 1 GSM only // 3 LTE only //E.g configure the scan mode is LTE only. AT+QCFG='nwscanmode',3 OK //AT+QCFG='iotopmode'[,] // Number format. Network category to be searched under LTE RAT. // 0 eMTC // 1 NB-IoT // 2 eMTC and NB-IoT //E.g configure the network is NB-IoT. AT+QCFG='iotopmode',1 OK //AT+QCFG='band'[,,,] //: A hexadecimal value that specifies the GSM frequency band. If it is set to 0, it //means Quectel Wireless Solutions Co., Ltd. 7 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note not to change GSM frequency band. //:A hexadecimal value that specifies the eMTC frequency band. If it is set to 0 or //0x40000000, it means not to change the frequency band //:A hexadecimal value that specifies the NB-IoT frequency band. If it is set to 0 or //0x40000000, it means not to change the frequency band //Which band need configure please confirm for chapter 7 . //E.g configure NB-IoT network BAND 5, the hexadecimal value is 0x10, only need input 10. AT+QCFG='band',0,0,10 OK //Query the network status. AT+CEREG?;+QNWINFO;+QCSQ +CEREG: 0,1 //Registered NB-IoT network +QNWINFO: 'CAT-NB1','46011','LTE BAND 5',2506 +QCSQ: 'CAT-NB1',-80,-94,103,-15 OK 2.2 Load certificates //If module already have the certificates, can use AT+QFDEL delete it first. AT+QFDEL='cacert.pem' OK AT+QFDEL='client.pem' OK AT+QFDEL='user_key.pem' OK //The server certificate size is 1188 bytes, the timeout is 5000s, after echoing 'CONNECT' load it. AT+QFUPL='cacert.pem',1188,5000 CONNECT -----BEGIN CERTIFICATE----MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6 b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM 9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6 VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L 93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm Quectel Wireless Solutions Co., Ltd. 8 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU 5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy rqXRfboQnoZsG4q5WTP468SQvvG5 -----END CERTIFICATE----+QFUPL: 1188,2d13 OK //The client certificate size is 1224 bytes, the timeout is 5000s, after echoing 'CONNECT' load it. AT+QFUPL='client.pem',1224,5000 CONNECT -----BEGIN CERTIFICATE----MIIDWjCCAkKgAwIBAgIVAOBjU0wHkgefunhH3vJLBLjUJD0lMA0GCSqGSIb3DQEB CwUAME0xSzBJBgNVBAsMQkFtYXpvbiBXZWIgU2VydmljZXMgTz1BbWF6b24uY29t IEluYy4gTD1TZWF0dGxlIFNUPVdhc2hpbmd0b24gQz1VUzAeFw0xOTA1MjAyMDM3 NThaFw00OTEyMzEyMzU5NTlaMB4xHDAaBgNVBAMME0FXUyBJb1QgQ2VydGlmaWNh dGUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDF99Sr+7QjYsScC4uU xpNJ2Z4+InchoC8afsuCXAS14FJDJhs5iuG+rrV4fo3oBUfWxU0YeMueVOE4wcG7 gJco3RX13COwrQqmKAdEMd7JCFk874MLHx4LILqHWJiF7IwdCMX+fGx9cTL/EKj4 iX3x0le+KrtRr0ax2JJig6A9lAdmSYRPppqQaiZJA+ytSwf6fi2iafscpA8r8d5R c+alZbE5ocChkd5SOu99JZzEsgB1gCBdIsY5POEENc9iGvl8x1GNtzzr/NG83Woq 6ZmA6DJjSLUqyYX0vHOWMBWdNOrkLKu2dG85XJJn1CxZWPhcP88RSvQGO6xGJdOR UrT9AgMBAAGjYDBeMB8GA1UdIwQYMBaAFP09llWYvUvKRzDClcBpc+AmFEI4MB0G A1UdDgQWBBTSt4AT/FfXa/JDjKMLpKvEcneeXDAMBgNVHRMBAf8EAjAAMA4GA1Ud DwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAQEAA+3wJL4MJ78JZIRqfLxtCD6h hEK0PhBw9Oiyfrzl4zsrRe0Tme/PZ6xOcxixS2mDnE3uPfbGOr5LP4MQ7ACFuV+9 Pu00W3gAnKU2w7MaqBkuUmWYd1yMVbD0osx6BH0hMUzOqqX6oNFwZw5E0gnSAubj ztqfCKXGSs6R2oeUfX+gCAhMPbV7atmi6wMZG6vaeP3HWF5p0YJOLQysHYsRjglN 0zr+P1mHxkpKeiwE3S9xxMOF2C+TXjkvKkarm2YIRie42Xz26rb0lL/ifz5KkgQU 2dxq8ohryewCXBeqwyyzQlLbGkhz5Ot+dYXpbWuxCow7Eocobmdx7+KSI5+n4A== -----END CERTIFICATE----+QFUPL: 1224,7a6c OK //The client key size is 1675 bytes, the timeout is 5000s, after echoing 'CONNECT' load it. AT+QFUPL='user_key.pem',1675,5000 CONNECT Quectel Wireless Solutions Co., Ltd. 9 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note -----BEGIN RSA PRIVATE KEY----MIIEowIBAAKCAQEAxffUq/u0I2LEnAuLlMaTSdmePiJ3IaAvGn7LglwEteBSQyYb OYrhvq61eH6N6AVH1sVNGHjLnlThOMHBu4CXKN0V9dwjsK0KpigHRDHeyQhZPO+D Cx8eCyC6h1iYheyMHQjF/nxsfXEy/xCo+Il98dJXviq7Ua9GsdiSYoOgPZQHZkmE T6aakGomSQPsrUsH+n4tomn7HKQPK/HeUXPmpWWxOaHAoZHeUjrvfSWcxLIAdYAg XSLGOTzhBDXPYhr5fMdRjbc86/zRvN1qKumZgOgyY0i1KsmF9LxzljAVnTTq5Cyr tnRvOVySZ9QsWVj4XD/PEUr0BjusRiXTkVK0/QIDAQABAoIBACzg7wSCDidLd7jM YTs7/R3ryJTbaVhlIOiHwAjwZVz52oxAckGMO3rnzlnfjrn/oHaOydh3Yeml4lzk h8/C6gGohRb0bd7ai6R5RJRwHcpDKz/GKFX4Gu543/BY5FLP+j+GwqPbfxi89cue 8j9NpBCTF7MTqt1st8EPkLfmkQgERTzv3979VSALMSg0F5aPTKd8baJk5RQfyNqV TYuPc1YbwQGC7MfVgP/e0aXRjxq4FtRnLhsbaEhpp2kenuZZnpwAr5c03+Q2NIz9 4l3tZp3BzA9+CczSE3DSSkqow+h0JWmMsc4h2JKnl69nyni3/7d2MvYHhc9V9kZD 8cSZQiECgYEA+d8NDKu5QpnDOCRXEeje5Wq0qMSiWw94pfWWvPMP9vwSI9FVj8vN gkZhAFFQnVtCFe5yhDP6/gTCcY5E2Q9WfxaWkKbAIWRMZul6FWdCRXnEgVxJZBUv ofERMyn5GdlEH4SmN4FFimxDRSeIALGwYRE7AJHpQuwHpodCOdaukekCgYEAytLg yOvG0DHIfh4+aGlb3YVg1skGTZ5KdiV78/wa7jRTp16vF18yMUFkFT2X8yfnk1Se OHC9uAukXH5MN4aSbEa9KH8W0/fuBaAD3ZTFsm73Rfdvo+Gm6ar3/wymqiOAn5PN UZOY9IqnS8lchlmK6WzK+OqMuGBR34YF8PFU6fUCgYAbiP7xJINX2YXvy+FkcdsO QQIDjxetHTlYYIXp8IcT2pdNJyZcoELXVlYeKNfPX10a+ZnZA7lnALNEvD7OBKit fJm++wE1LM5WkOgJL8XXziFfeAIGa2dCW0Rf9QIkXRLqvj1q5G37YQ7QshiEqxAa wkFUQMAJxeTZ7xHXOdcm8QKBgHvREHiXtt8SBRs4y1BiQTqSWfPE9JwdrcdCStE/ bhFM0GS0YJ8b9kArczWkTEacbbp7Rbue17KrKMNuNokPFgQTixZVv1HXYO7+KF30 nFu5ciq8SuL4tjSfspV426Wx1quURxstx4pBuq+BVYKO10Z4q9AZH57O7ixOXQIh 0XyhAoGBAOeVZ7SmY2RVkB0Arfhb0IlYnnovG1rremCoxq+y5IgaYl1ArAkP0p0t GQadZ5yAShVEDuuL/x9OEZmMGkt+vWrvwO/5pg4x+BbnTmZJ+Ud5zWf7Dletx+Ce Fs0yJkWTJCpHA5SFGTeFdWyYcstv+nvVIg7wOPj/tLHWmTAuxTcd -----END RSA PRIVATE KEY----+QFUPL: 1675,150 OK //Query the list file. AT+QFLST +QFLST: 'cacert.pem',1188 +QFLST: 'client.pem',1224 +QFLST: 'user_key.pem',1675 OK 2.3 Active PDP context //AT+QICSGP=[,,[,,[,]]] Quectel Wireless Solutions Co., Ltd. 10 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note // Integer type. The context ID. The range is 1-16 //< context_type >: Integer type. The protocol type. 1 IPv4 // : String type. The access point name. //: String type. The username. // : String type. The password // Integer type. The authentication methods. // 0 None // 1 PAP // 2 CHAP // 3 PAP or CHAP // E.g configure Parameters of a TCP/IP Context, the is 1, is IPv4, the // // is 'm2m64.com.attz' , the and is empty, the //is 0. AT+QICSGP=1,1,'m2m64.com.attz','','',0 OK //Active PDP contextID is 1. AT+QIACT=1 OK 2.4 Configure SSL option //Configure the path of server certificate for SSL context 2. AT+QSSLCFG='cacert',2,'cacert.pem' OK //Configure the path of client certificate for SSL context 2. AT+QSSLCFG='clientcert',2,'client.pem' OK //Configure the path of client private key for SSL context 2. AT+QSSLCFG='clientkey',2,'user_key.pem' OK //Configure the authentication mode for SSL context 2, SSL authentication mode: server and client authentication if requested by the remote server AT+QSSLCFG='seclevel',2,2 OK //SSL authentication version AT+QSSLCFG='sslversion',2,4 OK Quectel Wireless Solutions Co., Ltd. 11 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note //Cipher suite AT+QSSLCFG='ciphersuite',2,0xFFFF OK // Ignore the time of authentication AT+QSSLCFG='ignorelocaltime',2,1 OK 2.5 Configure MQTT option // Configure MQTT session into SSL mode for SSL context 2 AT+QMTCFG='SSL', 0, 1, 2 OK //Configure MQTT protocol version MQTT v3.1.1 AT+QMTCFG='version',0,4 OK 2.6 MQTT connect and data interaction //Start MQTT SSL connection AT+QMTOPEN=0,'a2sgasbshsff52-ats.iot.us-west-2.amazonaws.com',8883 OK +QMTOPEN: 0,0 //Connect to MQTT server AT+QMTCONN=0,'Quectel' OK +QMTCONN: 0,0,0 //Subscribe to topics AT+QMTSUB=0,1,'$aws/things/pabi/shadow/update/accepted',0 OK +QMTSUB: 0,1,0, //Publish messages, after echoing >, send the payload, and execution 'ctrl+Z' send the data. AT+QMTPUB=0,1,1,0,'$aws/things/pabi/shadow/update' > { 'state' : { 'reported' : { 'color' : 'red' } } } OK Quectel Wireless Solutions Co., Ltd. 12 +QMTPUB: 0,1,0 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note +QMTRECV: 0,0,'$aws/things/pabi/shadow/update/accepted','{'state':{'reported':{'color':'red'}},'metadata' :{'reported':{'color':{'timestamp':1578336900}}},'version':3,'timestamp':1578336900}' //Close MQTTS connection AT+QMTCLOSE=0 OK +QMTCLOSE: 0,0 Support band list : (eg.: 0x0a=0x02(GSM1800)+0x08(GSM1900)). This parameter is valid on BG95-M3 only. 00000000 No change 00000001 GSM 900MHz 00000002 GSM 1800MHz 00000004 GSM 850MHz 00000008 GSM 1900MHz 0000000F Any frequency band : (eg.: 0x15=0x01(LTEB1)+0x04(LTE B3)+0x10(LTE B5)) 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x2 (CM_BAND_PREF_LTE_EUTRAN_BAND2) LTE B2 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x8 (CM_BAND_PREF_LTE_EUTRAN_BAND4) LTE B4 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 0x800 (CM_BAND_PREF_LTE_EUTRAN_BAND12) LTE B12 0x1000 (CM_BAND_PREF_LTE_EUTRAN_BAND13) LTE B13 0x2000 (CM_BAND_PREF_LTE_EUTRAN_BAND14) LTE B14 0x20000 (CM_BAND_PREF_LTE_EUTRAN_BAND18) LTE B18 0x40000 (CM_BAND_PREF_LTE_EUTRAN_BAND19) LTE B19 0x80000 (CM_BAND_PREF_LTE_EUTRAN_BAND20) LTE B20 0x1000000 (CM_BAND_PREF_LTE_EUTRAN_BAND25) LTE B25 0x2000000 (CM_BAND_PREF_LTE_EUTRAN_BAND26) LTE B26 0x4000000 (CM_BAND_PREF_LTE_EUTRAN_BAND27) LTE B27 0x8000000 (CM_BAND_PREF_LTE_EUTRAN_BAND28) LTE B28 0x40000000 (CM_BAND_PREF_LTE_EUTRAN_BAND31) LTE B31 0x20000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND66) LTE B66 Quectel Wireless Solutions Co., Ltd. 13 LPWA Module Series BG96_MQTT_Attach_AWS_IoTCore_Application_Note 0x800000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND72) LTE B72 0x1000000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND73) LTE B73 0x1000000000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND85) LTE B85 0x4000000000000000000000 No change 0x4001C2000000000F0E389F (CM_BAND_PREF_ANY) Any frequency band : 0x1 (CM_BAND_PREF_LTE_EUTRAN_BAND1) LTE B1 0x2 (CM_BAND_PREF_LTE_EUTRAN_BAND2) LTE B2 0x4 (CM_BAND_PREF_LTE_EUTRAN_BAND3) LTE B3 0x8 (CM_BAND_PREF_LTE_EUTRAN_BAND4) LTE B4 0x10 (CM_BAND_PREF_LTE_EUTRAN_BAND5) LTE B5 0x80 (CM_BAND_PREF_LTE_EUTRAN_BAND8) LTE B8 0x800 (CM_BAND_PREF_LTE_EUTRAN_BAND12) LTE B12 0x1000 (CM_BAND_PREF_LTE_EUTRAN_BAND13) LTE B13 0x20000 (CM_BAND_PREF_LTE_EUTRAN_BAND18) LTE B18 0x40000 (CM_BAND_PREF_LTE_EUTRAN_BAND19) LTE B19 0x80000 (CM_BAND_PREF_LTE_EUTRAN_BAND20) LTE B20 0x1000000 (CM_BAND_PREF_LTE_EUTRAN_BAND25) LTE B25 0x2000000 (CM_BAND_PREF_LTE_EUTRAN_BAND26) LTE B26 0x8000000 (CM_BAND_PREF_LTE_EUTRAN_BAND28) LTE B28 0x40000000 (CM_BAND_PREF_LTE_EUTRAN_BAND31) LTE B31 0x20000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND66) LTE B66 0x400000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND71) LTE B71 0x800000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND72) LTE B72 0x1000000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND73) LTE B73 0x1000000000000000000000 (CM_BAND_PREF_LTE_EUTRAN_BAND85) LTE B85 0x4000000000000000000000 No change 0x4001C2000000004E0E189F (CM_BAND_PREF_ANY) Any frequency band Quectel Wireless Solutions Co., Ltd. 14

使用 MQTTS 接入 AWS IOT 说明 目录 一、MQTTS 接入 AWS IOT 说明 ............................................................................................ 2 1、 获取证书.................................................................................................................... 2 2、 查找设备的连接地址与端口 .................................................................................... 3 3、 使用 Device Shadow 服务 ........................................................................................ 4 二、AWS IOT 认证 模块指令流程 ......................................................................................... 6 一、MQTTS 接入 AWS IOT 说明 AWS IOT 云平台支持客户端证书的 TLS 双向身份验证，可用 MQTT 作为消息代 理。模块导入证书，可使用 mqtts 来连接云平台。 连接步骤如下： 1、 获取证书 登录 AWS IoT 控制台，在注册表中注册设备。在注册设备中会创建证书，注 意下载这些证书到本地，后续要将这些证书导入模块。AWS 网站有详细介绍 如何注册设备，参考链接 https://docs.aws.amazon.com/iot/?id=docs_gateway 注意保存证书，红框标注的后面需要导入模块，如下图所示： 2、 查找设备的连接地址与端口 查找 mqtt 连接的服务器地址，步骤如下： 查看地址：登录 aws iot 控制台选择 管理->物品(之前创建的)->交互。如下 af5c7l4oo3fcr-ats.iot.us-west-2.amazonaws.com 即为连接地址 Aws-iot 支持的连接端口如下： 3、模块导入证书使用 mqtts 连接云平台 导入证书，配置 TLS 使用 MQTTS 连接 3、 使用 Device Shadow 服务 AWS IOT 云平台提供 Device Shadow 服务，Device Shadow 服务为连接到 AWS IoT 的每台设备保留一个影子，影子是指用于存储和检索设备的当前状态 信息的 JSON 文档。 对于模块要使用 shadow 服务，只需使用 mqtt 订阅和发布 aws 规定的相关主 题，发布的内容符合 shadow 服务的 json 文档格式即可。具体可参考 aws 官 方文档：https://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/iot-deviceshadows.html 订阅 shadow 服务相关主题 登录 AWS IOT 控制台 选择 管理->物品->交互 可查看影子主题，模块连接成功 后需订阅这些主题, 如下图 登录 AWS IOT 控制台 选择 管理->物品->影子 可查看设备影子文档，影子状态 的更新可在此处看到，如下图 模块订阅并发布影子主题 登录 AWS IOT 控制台 选择 管理->物品->影子 可查看影子状态的更新 二、AWS IOT 认证 模块指令流程 根据沟通，AWS 云平台接入认证需要自己提供认证操作步骤，证明可以连接到 AWS 平台并且可以使用 shadow 服务即可，先将模块 AT 命令认证步骤整理如 下： //1、 将证书导入模块 AT+qfupl='ca.pem',1206 CONNECT +QFUPL: 1206,5a63 OK AT+qfupl='cc.pem',1220 CONNECT +QFUPL: 1220,3879 OK AT+qfupl='ck.pem',1675 CONNECT +QFUPL: 1675,6136 OK AT+QFLST='*' +QFLST: 'UFS:ca.pem',1206 +QFLST: 'UFS:cc.pem',1220 +QFLST: 'UFS:ck.pem',1675 OK //2、配置 SSL AT+QSSLCFG='clientkey',1,'UFS:ck.pem' OK AT+QSSLCFG='clientcert',1,'UFS:cc.pem' OK AT+QSSLCFG='cacert',1,'UFS:ca.pem' OK AT+QSSLCFG='ciphersuite',1,0XFFFF OK AT+QSSLCFG='ignoremulticertchainverify',1,1 OK at+qsslcfg='ignoreinvalidcertsign',1,1 OK AT+QSSLCFG='seclevel',1,2 OK //3、使用MQTTS 连接aws AT+QMTCFG='ssl',1,1,1 OK AT+QMTOPEN=1,'af5c7l4oo3fcr-ats.iot.us-west-2.amazonaws.com',8883 OK +QMTOPEN: 1,0 AT+QMTCONN=1,'test' OK +QMTCONN: 1,0,0 //连接AWS成功 //4、测试shadow 服务 AT+QMTSUB=1,1,'$aws/things/MyIotThing/shadow/update/accepted',0 OK +QMTSUB: 1,1,0,0 AT+QMTSUB=1,1,'$aws/things/MyIotThing/shadow/update/rejected',0 OK +QMTSUB: 1,1,0,0 AT+QMTPUB=1,1,1,0,'$aws/things/MyIotThing/shadow/update' > { 'state': { 'reported': { 'color': 'red' } } } OK +QMTPUB: 1,1,0 +QMTRECV:1,0,'$aws/things/MyIotThing/shadow/update/accepted','{'state ':{'reported':{'color':'red'}},'metadata':{'reported':{'color':{'time stamp':1579138722}}},'version':15,'timestamp':1579138722}'//收到 shadow服务回应 //5、断开连接 AT+QMTCLOSE=1 OK +QMTCLOSE: 1,0

QLog Linux Android 用户指导 版本：2.0 日期：2024-03-01 状态：受控文件 上海移远通信技术股份有限公司 1 / 26 QLog Linux Android 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的 相关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或 对此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生 作品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商 标权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授 予许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 26 QLog Linux Android 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或 特定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的 不侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何 其他硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式 维持生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 26 文档历史 修订记录 版本 1.0 日期 2020-08-27 2.0 2024-03-01 作者 Carl YIN Aaron LIU 变更表述 初始版本 1. 更新适用模块。 2. 新增功能参数-t、-g、-a、-j、-c 和-x； 更新参数说明-p、-m、-s 和-f（第 3 章）。 3. 新增 QWinLog 工具操作步骤三和步骤四，以及参数配置 界面和适用模块相关备注（第 4.1.2 章）。 4. 新增 QPST 工具操作步骤三和步骤四，以及适用模块相 关备注（第 4.1.3 章）。 5. 新增 QLog 与 FTP 服务器配合通过局域网抓取 Log 数据 和 Dump 信息（第 4.1.4 章）。 6. 新增步骤一（第 4.1.5 章）。 上海移远通信技术股份有限公司 3 / 26 QLog Linux Android 用户指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 2 工具包 ................................................................................................................................................. 11 3 工具参数 .............................................................................................................................................. 12 4 使用指导 .............................................................................................................................................. 14 4.1. Linux......................................................................................................................................... 14 4.1.1. QLog 抓取 Log 数据和 Dump 信息至本地存储.............................................................. 14 4.1.2. QLog 和 QWinLog 配合通过局域网抓取 Log 数据 ........................................................ 15 4.1.3. QLog 和 QPST 配合通过局域网抓取 Log 数据 ............................................................. 18 4.1.4. QLog 和 FTP 服务器配合通过局域网抓取 Log 数据和 Dump 信息 ............................... 19 4.1.5. QLog 和 TFTP 服务器配合通过局域网抓取 Dump 信息................................................ 22 4.2. Android ..................................................................................................................................... 23 4.2.1. QLog 抓取 Log 数据和 Dump 信息至本地存储.............................................................. 24 4.2.2. QLog 和 QWinLog、QPST 以及 ADB 配合通过局域网抓取 Log 数据 .......................... 25 5 附录 术语缩写..................................................................................................................................... 26 上海移远通信技术股份有限公司 4 / 26 QLog Linux Android 用户指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：参数说明 ........................................................................................................................................... 12 表 3：QWinLog 工具局域网参数配置......................................................................................................... 17 表 4：术语缩写 ........................................................................................................................................... 26 上海移远通信技术股份有限公司 5 / 26 QLog Linux Android 用户指导 图片索引 图 1：抓取 Log 数据至本地存储................................................................................................................. 14 图 2：抓取 Dump 信息至本地存储 ............................................................................................................. 15 图 3：通过局域网抓取 Log 数据................................................................................................................. 15 图 4：QWinLog 工具主界面 ....................................................................................................................... 16 图 5：QPTS 工具主界面 ............................................................................................................................ 18 图 6：配置 QPTS 工具局域网参数 ............................................................................................................. 19 图 7：QPST 局域网模式 ............................................................................................................................ 19 图 8：配置 FileZilla Server 工具局域网参数............................................................................................... 20 图 9：FileZilla Server 工具成功连接服务器................................................................................................ 20 图 10：QLog 工具在局域网内以 FTP 方式抓取 Log 数据 .......................................................................... 21 图 11：QLog 工具在局域网内以 FTP 方式抓取 Dump 信息....................................................................... 21 图 12：配置 Tftpd32 工具局域网参数 ........................................................................................................ 22 图 13：QLog 工具在局域网内以 TFTP 方式抓取 Dump 信息 .................................................................... 23 图 14：抓取 Log 数据至本地存储............................................................................................................... 24 图 15：抓取 Dump 信息至本地存储 ........................................................................................................... 24 上海移远通信技术股份有限公司 6 / 26 QLog Linux Android 用户指导 1 引言 本文档主要介绍如何使用 QLog 工具从 Linux 和 Android 系统中抓取移远通信模块的 Log 数据和 Dump 信息。 QLog 工具会自动探测模块当前是正常工作还是 Dump 状态，以抓取 Log 数据和 Dump 信息，并保存 到用户设备的存储器（例如硬盘、U 盘）中。若用户设备上的本地存储空间不足，QLog 还支持通过局域网 将 Log 数据和 Dump 信息保存至用户电脑上。 1.1. 适用模块 表 1：适用模块 产品线 WCDMA LTE Standard 模块 UC200A-GL AG35-CEN EC200A 系列 EC200D 系列 EC200G-CN EC200M-CN EC200N 系列 EC200R 系列 EC200S 系列 EC200U 系列 EC20-CE EC21 系列 EC25 系列 上海移远通信技术股份有限公司 7 / 26 EC300R-LA EC600E-CN EC600G 系列 EC600K-CN EC600M 系列 EC600N-CN EC600U 系列 EC600Z-CN EC800E-CN EC800G-CN EC800K 系列 EC800M-CN EC800N-CN EC800Z-CN EC801E-CN EG21-G EG25-G EG700G-CN EG800G 系列 EG800K 系列 EG800Q 系列 EG810M 系列 EG912N-EN EG912Y 系列 EG915G-EU EG915N 系列 上海移远通信技术股份有限公司 QLog Linux Android 用户指导 8 / 26 车载模块 LPWA LTE-A EG915Q-NA EG915U 系列 EG916Q-GL EG91 系列 EG95 系列 EM05 系列 AG15 AG215S 系列 AG35 系列 AG520R 系列 AG521R 系列 AG529R 系列 BG77 BG600L-M3 BG95 系列 BG96 EG06 系列 EG060V-EA EG060W-EA EG12 系列 EG18 系列 EG512R-EA EM06 系列 EM120R-GL EM12-G EM160R-GL 上海移远通信技术股份有限公司 QLog Linux Android 用户指导 9 / 26 QLog Linux Android 用户指导 EP06 系列 RG200U 系列 RG207U-CN RG255C 系列 RG500Q 系列 RG500U 系列 RG502Q 系列 RG520F 系列 RG520N 系列 RG530F 系列 RG650E 系列 5G RG650V 系列 RM255C-GL RM500K-CN RM500Q 系列 RM500U 系列 RM502Q-AE RM510Q-GL RM520N 系列 RM521F-GL RM530N-GL 备注 上表所列模块产品可能包含多个型号，详细信息可参考各模块产品规格书。 上海移远通信技术股份有限公司 10 / 26 QLog Linux Android 用户指导 2 工具包 QLog 工具包包含源码、过滤器配置文件、示例以及 Android 上可直接执行的程序。 文件列表如下： ⚫ main.c, asr.c, mdm.c, sahara.c, tty2tcp.c, ftp.c, sony.c, eigen.c, tftp.c, unisoc.c, ymodem.c, qdss1.c, mtk.c, usb_linux.c, qshrink4.c ⚫ Android.mk, Makefile ⚫ qlog.h, sahara.h ⚫ conf/*.cfg ⚫ example_catch_asr_dump.txt ⚫ example_catch_dump.readme.txt ⚫ example_catch_dump_by_tftp.readme.txt ⚫ android/arm64-v8a/QAndroidLog ⚫ android/armeabi/QAndroidLog 备注 1. 请确保 QLog 工具有读写模块的权限。 2. Linux 上可执行的 QLog 程序需用户自行编译，可参考第 4.1 章。 3. 其中 conf/*.cfg 是指位于 conf 路径下的多个过滤器配置文件。 上海移远通信技术股份有限公司 11 / 26 QLog Linux Android 用户指导 3 工具参数 QLog 工具支持配置多个参数，可根据实际需求选择并配置参数。本章节详细介绍每个参数的用法及配 置说明。 表 2：参数说明 序号 参数 可选/ 条件必选 1 -p 可选 2 -m 可选 3 -n 可选 4 -s 条件必选 说明 串口，表示模块上用于抓取 Log 数据或者 Dump 信息的 DM 口。 ⚫ 若用户系统中仅存在一个模块，由于 QLog 工具会自动探测当 前模块状态，因此不建议配置此参数；若用户系统中存在多个 模块，需配置此参数以指定需要抓取 Log 数据或者 Dump 信息 的模块。 ⚫ 和-t 参数配合抓取串口 Log 数据 ⚫ -p /dev/ttyUSB0 仅抓取单个串口的 Log 数据； ⚫ -p /dev/ttyUSB0 -p /dev/ttyUSB1 同时抓取 2 个串口的 Log 数据。 单个 Log 文件的最大值。 单位：MB。 默认值：256。 可设置范围：2~512。 可保存至本地存储的最大 Log 文件个数。 默认：0。 可设置范围：0~512。 0 表示无个数限制 其他值 表示可保存至本地存储的最大 Log 文件个数。当实际文件 个数超过设置的最大文件个数时，QLog 工具将自动删除 最早的 Log 文件。 QLog 支持保存 Log 数据和 Dump 信息到本地存储，以及通过局域 网保存至用户电脑。使用不同方式保存 Log 数据和 Dump 信息时， 此参数的作用不同。 ⚫ 保存 Log 数据和 Dump 信息到本地存储时，表示文件的 存储目录名；若未设置，则默认保存在当前目录。详细 使用方法可参考第 4.1.1 章、第 4.2.1 章。 ⚫ 通过局域网保存 Log 数据到用户电脑时，必须设置此参数为-s 9000。详细使用方法可参考第 4.1.2 章、第 4.1.3 章。 ⚫ 通过局域网保存 Log 数据或 Dump 信息到用户电脑上的 FTP 上海移远通信技术股份有限公司 12 / 26 QLog Linux Android 用户指导 5 -f 可选 服务器时，必须设置此参数为-s ftp:-user:-pass:。详细使用方法可参考 第 4.1.4 章。 ⚫ 通过局域网保存 Dump 信息到用户电脑上的 TFTP Server 时， 必须设置此参数为-s tftp:。详细使用方法可参考 第 4.1.5 章。 过滤器配置文件名。 仅 AG35-CEN、EC20-CE、EC21 系列、EC25 系列、EG21-G、 EG25-G、EG91 系列、EG95 系列、EM05 系列、EC20-CN、EG800Q 系 列 、 EG915Q-NA 、 EG916Q-GL 、 AG15 、 AG215S 系 列 、 AG35 系列、AG520R 系列、AG521R 系列、AG529R 系列、BG77、 BG600L-M3、BG95 系列、BG96、EG06 系列、EM06 系列、EP06 系列、EG12 系列、EG18 系列、EG512R-EA、EM120R-GL、 EM12-G、EM160R-GL、RG255C 系列、RG500Q 系列、RG502Q 系列、RG520F 系列、RG520N 系列、RG530F 系列、RG650E 系 列、RG650V 系列、RM255C-GL、RM500Q 系列、RM502Q-AE、 RM510Q-GL、RM520N 系列、RM521F-GL、RM530N-GL、RG500U 系列、RM500U 系列、RG207U-CN 和 RG200U 系列模块支持通过 此参数指定过滤器配置文件。 ⚫ RG500U 系列、RM500U 系列、RG207U-CN 和 RG200U 系 列模块未指定此参数时，不使用过滤器配置文件； ⚫ 其他模块未指定此参数时，使用 QLog 默认的过滤器配置文件 default.cfg。 6 -t 条件必选 搭配-p 参数指定设备节点。抓取串口 Log 数据时此参数必选。 指定模块型号。 若 模 块 型 号 为 EC200A-CN 、 EC200N-CN 、 EC800N-CN 、 7 -g 条件必选 EC20-CE、RG200U-CN、RM500U-CN 或 EC200D-CN，由于特殊 的 VID 和 PID 值（0x3793 0x3C93 和 0x3C93 0xFFFF），此参数 必选。 查询模块状态。 若模块型号为 EC200U 系列、EC600U 系列、EG915U 系列、 8 -a 条件必选 EC600G 系列、EC800G-CN、EG700G-CN、EG800G 系列、 EG915G-EU 和 EC200G-CN 模块，则抓取 Dump 信息时此参数必 选。其他模块型号不支持配置此参数。 9 -j 条件必选 仅指定 DM 口抓取 Log。 当模块抓取 Log 时，若除 DM 口外还存在 QDSS 或 DPL 口，为了 和 QPST 连接配合抓取 Log 数据，此参数必选。 10 -c 条件必选 持续运行 QLog。 所有模块抓取 Dump 信息后 QLog 进程会默认退出，若希望 QLog 进程持续运行，则此参数必选。 11 -x 条件必选 指定 NMEA 口抓取 Log 数据。 仅适用于 RG500U 系列、RM500U 系列、RG207U-CN 和 RG200U 系列，且此参数必选。 上海移远通信技术股份有限公司 13 / 26 QLog Linux Android 用户指导 4 使用指导 本章节主要介绍如何使用 QLog 工具从 Linux 和 Android 系统中抓取移远通信模块的 Log 数据和 Dump 信息。 4.1. Linux 对于 Linux 系统，使用 QLog 抓取 Log 数据和 Dump 信息前，需先执行如下命令编译 QLog 源码，编 译出可执行的 QLog 程序。 make CROSS_COMPILE= 将编译后的可执行 QLog 程序和过滤器配置文件拷贝到设备上，然后根据需求设置不同的参数，最后 调用 QLog 程序抓取 Log 数据和 Dump 信息。 4.1.1. QLog 抓取 Log 数据和 Dump 信息至本地存储 执行 QLog -s ，抓取 Log 数据和 Dump 信息并保存至指定路径，例如：QLog -s /tmp/log123。 图 1：抓取 Log 数据至本地存储 上海移远通信技术股份有限公司 14 / 26 QLog Linux Android 用户指导 图 2：抓取 Dump 信息至本地存储 4.1.2. QLog 和 QWinLog 配合通过局域网抓取 Log 数据 若需长时间抓取 Log 数据，但 Linux 设备本地存储不足，可通过局域网抓取 Log 数据并保存至用户电 脑上。QWinLog 是由移远通信开发，用于在 Windows 系统上抓取 Log 数据的工具。此方法要求用户电脑 （操作系统需为 Windows）和 Linux 设备位于同一个局域网，在 Linux 设备上运行 QLog 工具抓取 Log 数 据，然后通过局域网发送至用户电脑上运行的 QWinLog 工具。关于 QWinLog 工具的详细信息，可联系移 远通信技术支持。 步骤一：在 Linux 设备上执行 QLog -s 9000 设置 QLog 工具运行模式为服务器模式、端口为 9000。 图 3：通过局域网抓取 Log 数据 上海移远通信技术股份有限公司 15 / 26 QLog Linux Android 用户指导 步骤二：在用户电脑上运行 QWinLog 工具，主界面如下图所示： 图 4：QWinLog 工具主界面 上海移远通信技术股份有限公司 16 / 26 步骤三：配置局域网模式指定参数，参数配置要求如下表： QLog Linux Android 用户指导 表 3：QWinLog 工具局域网参数配置 参数项 Type Server IP Server port Config file Log path QXDM log QASR log 选择'LAN Port' Linux 设备的 IP 地址 9000 根据端口实际存在情况选择是否勾 选'ADPL Port'（默认值：9002） 9000 和'Qdss Port'（默认值：9001）， 如无特殊需求，保持默认值即可 过滤器配置文件路径 Log 保存路径 UNISOC log ap：9000 cp：9001 MTK log 9000 备注 1. 抓取并发送 Log 数据时，由于 Log 数据的体量较大且需要实时传输，而 Wi-Fi 网络一般不太稳定，故 推荐使用有线网。 2. 不同的模块型号需在对应参数栏进行局域网参数配置，其中： 1） AG35-CEN、EC20-CE、EC21 系列、EC25 系列、EG21-G、EG25-G、EG91 系列、EG95 系 列、EM05 系列、EC20-CN、EG800Q 系列、EG915Q-NA、EG916Q-GL、AG15、AG215S 系 列、AG35 系列、AG520R 系列、AG521R 系列、AG529R 系列、BG77、BG600L-M3、BG95 系列、BG96、EG06 系列、EM06 系列、EP06 系列、EG12 系列、EG18 系列、EG512R-EA、 EM120R-GL、EM12-G 模块、EM160R-GL、RG255C 系列、RG500Q 系列、RG502Q 系列、 RG520F 系列、RG520N 系列、RG530F 系列、RG650E 系列、RG650V 系列、RM255C-GL、 RM500Q 系列、RM502Q-AE、RM510Q-GL、RM520N 系列、RM521F-GL 和 RM530N-GL 模 块需在'QXDM log'参数栏配置局域网参数； 2） UC200A-GL、EC200A 系列、EC200M-CN、EC200N 系列、EC200R 系列、EC200S 系列、 EC300R-LA、EC600K-CN、EC800K 系列、EC600M 系列、EC600N-CN、EC800N-CN、EG915N 系 列 、 EG912N-EN 、 EC800M-CN 、 EG810M 系 列 、 EG800K 系 列 、 EG912Y 系 列 、 EG060V-EA 和 EG060W-EA 模块需在'QSAR log'参数栏配置局域网参数； 3） EC200D 系列、EC200G-CN、EC200U 系列、EC600G 系列、EC600U 系列、EG915U 系列、 EC800G-CN、EG700G-CN、EG800G 系列、EG915G-EU、RG200U 系列、RG207U-CN、 RG500U 系列和 RM500U 系列模块需在'UNISOC log'参数栏配置局域网参数； 4） RM500K-CN 模块需在'MTK log'参数栏配置局域网参数。 3. EC600E-CN、EC600Z-CN、EC800E-CN、EC800Z-CN 和 EC801E-CN 模块当前无法使用 QWinLog 工具，可参考第 4.1.4 章内容抓取 Log 数据和 Dump 信息。 步骤四：点击'Start'按钮，开始抓取 Log 数据。 上海移远通信技术股份有限公司 17 / 26 QLog Linux Android 用户指导 4.1.3. QLog 和 QPST 配合通过局域网抓取 Log 数据 此方法与第 4.1.2 章中所述和 QWinLog 配合通过局域网抓取 Log 数据类似，区别在于用户电脑（操作 系统需为 Windows）上运行的工具为 QPST 工具。 备注 1. QPST 工具的安装和使用需要高通授权。 2. 仅 AG35-CEN、EC20-CE、EC21 系列、EC25 系列、EG21-G、EG25-G、EG91 系列、EG95 系列、 EM05 系列、EC20-CN、EG800Q 系列、EG915Q-NA、EG916Q-GL、AG15、AG215S 系列、AG35 系列、AG520R 系列、AG521R 系列、AG529R 系列、BG77、BG600L-M3、BG95 系列、BG96、 EG06 系列、EM06 系列、EP06 系列、EG12 系列、EG18 系列、EG512R-EA、EM120R-GL、 EM12-G 模块、EM160R-GL、RG255C 系列、RG500Q 系列、RG502Q 系列、RG520F 系列、RG520N 系列、RG530F 系列、RG650E 系列、RG650V 系列、RM255C-GL、RM500Q 系列、RM502Q-AE、 RM510Q-GL、RM520N 系列、RM521F-GL 和 RM530N-GL 模块可以使用 QPST 工具进行 Log 抓 取。 步骤一：在 Linux 设备上执行./QLog -s 9000，设置 QLog 工具运行模式为服务器模式、端口为 9000。 步骤二：在用户电脑上运行 QPST 工具，主界面如下图所示。点击右下角'Add New Port…'按钮， 在弹窗内输入 Linux 设备的 IP 地址和 9000 端口号。 图 5：QPTS 工具主界面 上海移远通信技术股份有限公司 18 / 26 QLog Linux Android 用户指导 步骤三：点击'Add New Port'窗口左下角'OK'按钮，开始抓取 Log 数据。 图 6：配置 QPTS 工具局域网参数 端口信息会显示在工具主界面，抓取的 Log 保存至用户电脑。 图 7：QPST 局域网模式 4.1.4. QLog 和 FTP 服务器配合通过局域网抓取 Log 数据和 Dump 信息 此方法要求用户电脑（操作系统无要求）和 Linux 设备位于同一个局域网，在 Linux 设备上运行 QLog 工具抓取 Log 数据和 Dump 信息，然后通过局域网发送至用户电脑上运行的 FileZilla Server 工具。FileZilla Server 为免费开源工具，用户可访问官网 https://filezilla-project.org/，自行下载并安装。 步骤一：运行 FileZilla Server 工具，在自动弹出的'输入服务器进行管理'窗口内，配置'主机'项 为 Linux 设备地址'127.0.0.1'（本地回环 IP），配置'端'项为端口号（默认为'14147'）， '密码'项默认为空，配置完成后点击右下角'连接'按钮，如下图所示： 上海移远通信技术股份有限公司 19 / 26 QLog Linux Android 用户指导 图 8：配置 FileZilla Server 工具局域网参数 服务器会自动启动并成功登录。 图 9：FileZilla Server 工具成功连接服务器 上海移远通信技术股份有限公司 20 / 26 QLog Linux Android 用户指导 步骤二：在 Linux 设备上运行./QLog -s ftp:-user:-pass:，开始在局域网内以 FTP 方式抓取 Log 数据和 Dump 信息并打印在 QLog 窗口， 如下图所示： 图 10：QLog 工具在局域网内以 FTP 方式抓取 Log 数据 图 11：QLog 工具在局域网内以 FTP 方式抓取 Dump 信息 上海移远通信技术股份有限公司 21 / 26 QLog Linux Android 用户指导 备注 若用户电脑上开启了防火墙，建议临时关闭，否则防火墙可能会拒绝 QLog 工具的访问，导致 Log 数据 或 Dump 信息抓取失败。 4.1.5. QLog 和 TFTP 服务器配合通过局域网抓取 Dump 信息 此方法要求用户电脑（操作系统无要求）和 Linux 设备位于同一个局域网，在 Linux 设备上运行 QLog 工具抓取 Dump 信息，然后通过局域网发送至用户电脑上运行的 Tftpd32 工具。Tftpd32 为免费开源工具， 用户可访问官网 https://pjo2.github.io/tftpd64/，自行下载并安装。 步骤一：运行 Tftpd32 工具，在自动弹出的主界面窗口内配置'Current Directory'项为 Dump 数据的 存放路径，配置'Server interfaces'项为用户电脑 IP，如下图所示： 图 12：配置 Tftpd32 工具局域网参数 步骤二：在 Linux 设备上执行./QLog -s tftp:，开始在局域网内以 TFTP 方式抓取 Dump 信息并打印在 QLog 窗口，如下图所示： 上海移远通信技术股份有限公司 22 / 26 QLog Linux Android 用户指导 图 13：QLog 工具在局域网内以 TFTP 方式抓取 Dump 信息 备注 若用户电脑上开启了防火墙，建议临时关闭，否则防火墙可能会拒绝 QLog 工具的访问，导致 Dump 信 息抓取失败。 4.2. Android 对于 Android 系统，移远通信已提供编译好的 QLog 程序，用户可直接使用。 在抓取 Log 数据和 Dump 信息之前，需将编译好的 QLog 程序和过滤器配置文件拷贝到 Android 设备 上，然后根据需求设置不同的参数，最后调用 QLog 程序抓取 Log 数据和 Dump 信息。 上海移远通信技术股份有限公司 23 / 26 QLog Linux Android 用户指导 4.2.1. QLog 抓取 Log 数据和 Dump 信息至本地存储 Android 设备的本地存储空间一般较大，可直接抓取 Log 数据和 Dump 信息保存至 Android 设备的本 地存储器。执行 QAndroidLog -s ，抓取 Log 数据和 Dump 信息并保存至指定路径。 图 14：抓取 Log 数据至本地存储 图 15：抓取 Dump 信息至本地存储 上海移远通信技术股份有限公司 24 / 26 QLog Linux Android 用户指导 4.2.2. QLog 和 QWinLog、QPST 以及 ADB 配合通过局域网抓取 Log 数据 若需长时间抓取 Log 数据，但本地存储不足，可使用第 4.1.2 章、第 4.1.3 章介绍的方法进行抓取。 由于用户电脑和 Android 设备之间一般通过 USB 连接，可先执行如下命令，使用 ADB 工具建立虚拟 网络连接。 C:UsersQ>adb forward tcp:9000 tcp:9000 然后可参考第 4.1.2 章或第 4.1.3 章的步骤，在 QWinLog 或 QPST 工具里将 IP 地址设置为 127.0.0.1 以及将端口设置为 9000，最后进行 Log 数据的抓取。 上海移远通信技术股份有限公司 25 / 26 QLog Linux Android 用户指导 5 附录 术语缩写 表 4：术语缩写 缩写 ADB ADPL DM DPL FTP IP LAN LPWA PID QDSS QPST TCP TFPT USB VID 英文全称 Android Debug Bridge Accelerated Data Protocol Logging Device Manager Data Protocol Logging File Transfer Protocol Internet Protocol Local Area Network Low-Power Wide-Area Product ID Qualcomm Debug Subsystem Qualcomm Product Support Tool Transmission Control Protocol Trivial File Transfer Protocol Universal Serial Bus Vendor ID 中文全称 安卓调试桥 加速数据协议日志记录 设备管理端口 数据协议日志记录 文件传输协议 网际互连协议 局域网 低功耗广域技术 产品识别码 高通调试系统 针对高通芯片开发的传输软件 传输控制协议 简单文件传送协议 通用串行总线 运营商代码 上海移远通信技术股份有限公司 26 / 26

UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide UMTS/HSPA/LTE Module Series Rev. UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_ Installation_Guide_V1.2 Date: 2016-05-09 www.quectel.com UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 1 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide About the Document History Revision 1.0 1.1 1.2 Date 2015-02-27 l 2015-07-02 Author Carl YIN Arno WANG CQouneficdteential 2016-05-09 Arno WANG Description Initial Changed the document name from 'UC&EC Series' to 'UC20&UC15&EC20' Changed the document name 'UC20&UC15&EC20' 'UC20&UC15&EC20&EC21&EC25' from to UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 2 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Figure Index ................................................................................................................................................. 4 1 Introduction .......................................................................................................................................... 5 2 Install Driver ......................................................................................................................................... 6 2.1. Installation ................................................................................................................................. 7 2.2. Test .......................................................................................................................................... 14 3 Uninstall Driver................................................................................................................................... 15 3.1. CQouneficdteenl tial Uninstallation...........................................................................................................................15 UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 3 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide Figure Index FIGURE 1: DRIVER NOT INSTALLED FOR UC20/UC15 .......................................................................... 6 FIGURE 2: DRIVER NOT INSTALLED FOR EC20 ..................................................................................... 7 FIGURE 3: CONFIRM INSTALLATION........................................................................................................ 8 FIGURE 4: CHOOSE DESTINATION LOCATION....................................................................................... 8 FIGURE 5: COPYING FILES ....................................................................................................................... 9 FIGURE 6: AUTOMATIC INSTALLATION.................................................................................................... 9 FIGURE 7: COMPLETE INSTALLATION .................................................................................................. 10 FIGURE 8: CHECK INSTALLATION RESULT FOR UC20.........................................................................11 FIGURE 9: CHECK INSTALLATION RESULT FOR UC15........................................................................ 12 FIGURE 10: CHECK INSTALLATION RESULT FOR EC20 ...................................................................... 13 FIGURE 11: PORT TESTING PROGRAM................................................................................................. 14 FIGURE 12: CHOOSE DRIVER ................................................................................................................ 15 FIGURE 13: UNINSTALL DRIVER ............................................................................................................ 16 l FIGURE 14: CHECK UNINSTALLATION SETTING.................................................................................. 17 FIGURE 15: CONFIRM UNINSTALLATION .............................................................................................. 17 te FIGURE 16: AUTOMATIC UNINSTALLATION .......................................................................................... 18 FIGURE 17: REMOVING FILES ................................................................................................................ 18 c l FIGURE 18: COMPLETE UNINSTALLATION ........................................................................................... 19 ue tia FIGURE 19: CHECK UNINSTALLATION RESULT FOR UC20/UC15...................................................... 20 CQonfiden FIGURE 20: CHECK UNINSTALLATION RESULT FOR EC20................................................................. 21 UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 4 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 1 Introduction This document illustrates how to install UC20&UC15&EC20&EC21&EC25 drivers on Windows systems via installation package. This installation package supports Windows XP, Windows Vista, Windows 7 and Windows 8 systems. This document introduces the procedure on Windows 7 system as an example. CQouneficdteenl tial UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 5 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 2 Install Driver This chapter mainly describes how to install UC20/UC15/EC20/EC21/EC25 drivers by installation package. Connect UC20/UC15/EC20/EC21/EC25 to PC by USB cable and press UC20/UC15/EC20/EC21/EC25’s Power Key to start the module. If you have not installed any Quectel drivers on your system before, there would be a prompt about new device which indicates you to update the drivers. Please ignore the prompt and go to the next step. CQouneficdteenl tial The figure below shows that the system has not installed the driver. Figure 1: Driver Not Installed for UC20/UC15 UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 6 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide uectel tial Figure 2: Driver Not Installed for EC20 Q en NOTE fid For Windows XP system, you must ensure the UC20/UC15/EC20/EC21/EC25 module has been connected to PC before installing the drivers. Con 2.1. Installation Please get the latest installation package from disk equipped by Quectel or from Quectel technical support. This document takes the installation of 'Quectel_USB_Drivers_for_UC20&UC15&EC20_V1.1.zip' as an example, and the details are shown as below. UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 7 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 1. Check Installation Setting ctel l Figure 3: Confirm Installation ue tia 2. Choose Destination Location CQonfiden If you do not want to change the default location, please click 'Next' directly to go on. Figure 4: Choose Destination Location UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 8 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 3. Prepare Driver Files Needed for Installation Click 'Next' to go on, as shown below. ctel l Figure 5: Copying Files ue tia 4. Automatic Installation CQonfiden It may take some time to install the drivers, please wait patiently for the process to complete. Figure 6: Automatic Installation UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 9 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 5. Complete Installation The drivers have been installed completely, shown as below. CQouneficdteenl tial Figure7:CompleteInstallation UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 10 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide Click 'Finish' to complete the installation. You can check the installation result through Computer Management. CQouneficdteenl tial Figure 8: Check Installation Result for UC20 UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 11 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide CQouneficdteenl tial Figure 9: Check Installation Result for UC15 UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 12 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide CQouneficdteenl tial Figure 10: Check Installation Result for EC20 UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 13 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 2.2. Test After the drivers have been installed, you can test whether the drivers can work normally or not by QNavigator. Please refer to the following figure: CQouneficdteenl tial Figure11:PortTestingProgram UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 14 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 3 Uninstall Driver This chapter mainly provides the ways to uninstall UC20/UC15/EC20/EC21/EC25 drivers. The uninstallation can be realized by re-operating installation package or adding/deleting program on Control Panel. By taking as an example, this document introduces using the latter method to uninstall the 'Quectel USB Drivers for UC20&UC15&EC20'. 3.1. Uninstallation l 1. Choose Driver CQouneficdteential Enter Control Panel and choose the installed driver, then click 'Uninstall', as shown below. Figure 12: Choose Driver UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 15 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide CQouneficdteenl tial Figure13:UninstallDriver UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 16 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 2. Check Uninstallation Setting uectel tial Figure 14: Check Uninstallation Setting Q n 3. Confirm Uninstallation Confide Click 'Yes' to confirm the uninstallation. Figure 15: Confirm Uninstallation UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 17 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 4. Automatic Uninstallation It may take some time to uninstall, please wait patiently for the process to complete. Figure 16: Automatic Uninstallation CQouneficdteenl tial The drivers are uninstalling now, as shown below. Figure 17: Removing Files UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 18 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 5. Complete Uninstallation The drivers have been uninstalled completely, as shown below. CQouneficdteenl tial Figure18:CompleteUninstallation UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 19 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide 6. Check Uninstallation Result After the drivers have been uninstalled, the device will switch to uninstalled status. You can check whether the drivers have been uninstalled successfully or not through Computer Management. Please refer to the figure below: CQouneficdteenl tial Figure 19: Check Uninstallation Result for UC20/UC15 UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 20 / 21 UMTS/HSPA/LTE Module Series UC20&UC15&EC20&EC21&EC25 Windows USB Drivers Installation Guide CQouneficdteenl tial Figure 20: Check Uninstallation Result for EC20 UC20&UC15&EC20&EC21&EC25_Windows_USB_Drivers_Installation_Guide Confidential / Released 21 / 21

QDloader Linux Android 用户指导 版本：1.1 日期：2022-08-26 状态：受控文件 QDloader Linux Android 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同 时，您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分 析、评估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同 意，尽管移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在 '可用'基础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文 档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 12 QDloader Linux Android 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问 性、安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 12 QDloader Linux Android 用户指导 文档历史 修订记录 版本 1.0 日期 2021-05-19 2021-08-23 1.1 2022-08-26 作者 Carl YIN Carl YIN Aaron LIU 变更表述 文档创建 受控版本 1. 增 加 适 用 模 块 EC200A 系 列 、 EC200D-CN 、 EC200N-CN 、 EC600N-CN 、 EC800G-CN 、 EC800N-CN、EG912Y-EU、 EG915N-EU； 2. 删除 EC200T 系列。 上海移远通信技术股份有限公司 3 / 12 QDloader Linux Android 用户指导 目录 文档历史 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................4 表格索引 ..................................................................................................................................................... 5 1 引言.....................................................................................................................................................6 1.1. 适用模块 ...................................................................................................................................6 2 工具包 .................................................................................................................................................8 3 工具参数..............................................................................................................................................9 4 使用指导............................................................................................................................................10 4.1. 工具准备 .................................................................................................................................10 4.2. 本地固件升级..........................................................................................................................10 5 附录 术语缩写 ...................................................................................................................................12 上海移远通信技术股份有限公司 4 / 12 QDloader Linux Android 用户指导 表格索引 表 1：适用模块.......................................................................................................................................... 6 表 2：文件列表.......................................................................................................................................... 8 表 3：参数说明.......................................................................................................................................... 9 表 4：术语缩写........................................................................................................................................ 12 上海移远通信技术股份有限公司 5 / 12 QDloader Linux Android 用户指导 1 引言 本文档主要介绍了在 Linux 和 Android 系统上，如何使用 QDloader 工具升级移远通信 LTE Standard 和 5G 模块的固件。 1.1. 适用模块 表 1：适用模块 模块系列 5G LTE Standard 模块 RG500U-CN RM500U-CN EC200A 系列 EC200D-CN EC200N-CN EC200S 系列 EC200U 系列 EC600N-CN EC600S-CN EC600U 系列 EC800G-CN EC800N-CN EG500U-CN EG700U-CN EG912Y-EU 上海移远通信技术股份有限公司 6 / 12 QDloader Linux Android 用户指导 EG915N-EU EG915U 系列 备注 上表所列模块产品可能包含多个型号，详细信息请参考各模块产品规格书。 上海移远通信技术股份有限公司 7 / 12 QDloader Linux Android 用户指导 2 工具包 QDloader 工具包中的文件有：编译好的可执行程序（适用于 Android 系统）、参考日志文件、用于编 译的工程文件和源代码 （适用于 Linux 系统）。相关文件如下表所示： 表 2：文件列表 目录文件 android log android.mk Makefile .c和.h文件 说明 该目录包含为 Android 系统编译好的可执行程序，可直接使用。 该目录包含 QDloader 工具的使用日志。当遇到升级错误时，可对比日志以 初步排查错误原因。 工程文件和源代码；适用于 Linux 系统，对 QDloader 工具进行编译，生成 可执行程序，详情可参考第 4.1 章。 上海移远通信技术股份有限公司 8 / 12 QDloader Linux Android 用户指导 3 工具参数 QDloader 工具支持如下参数设置，下表详细介绍了参数的用法。 表 3：参数说明 序号 参数 1 -f 可选/强制 强制 说明 固件文件名；固件文件包含在移远通信释放的固件包（默认 为 zip 格式的压缩包）中，固件文件名仅为以下三种形式中 的一种： ⚫ 固件文件名后缀为.pac。 ⚫ 固件文件名为 firmware.bin。 ⚫ 固件文件名后缀为_fbf.bin。 若客户设备中存在多个移远通信模块，需通过该参数指定待 升级模块；若仅有一个模块，则无需通过该参数指定待升级 模块。 2 -s 用于标识模块，每个模块均有不 同的标识。QDloader 工具会打印出所有模块标识，客户可 根据打印日志进行选择。 各模块的标识由客户的硬件设计决定（USB 拓扑），即使设 备或者模块重启，标识也不会改变。 上海移远通信技术股份有限公司 9 / 12 QDloader Linux Android 用户指导 4 使用指导 本章节介绍了如何使用 QDloader 工具在 LTE Standard 和 5G 模块的 Linux 和 Android 系统上进行固 件升级。 4.1. 工具准备 ⚫ 若使用 Linux 系统，可通过如下命令编译工具源码，生成可执行程序： make CROSS_COMPILE= ⚫ 若使用 Android 系统，可直接使用工具包中 android 目录下已编译完成的可执行程序。若 Android 系统为 32 位，选择 armeabi-v7a；若为 64 位，选择 arm64-v8a。 4.2. 本地固件升级 客户设备需要有足够的存储空间来存放模块的固件包，可参考如下步骤进行升级。 1. 拷贝固件包和编译后的 QDloader 可执行程序文件到设备上； 2. 在设备中执行如下命令运行工具并进行固件升级； ./QDloader -f 3. 根据工具的退出码或工具打印出的日志信息中的最后一行日志判断固件升级是否成功。 执行如下命令获取工具的退出码，0 表示升级成功，其他值表示升级失败。 # echo $? 查看工具打印的最后一行日志，若显示如下，则表示升级成功； # ./QDloader -f ~/ec200s.bin [000:000] Version: Quectel_QDloader_Linux&Android_V0.0.4 上海移远通信技术股份有限公司 10 / 12 QDloader Linux Android 用户指导 [000:000] scan quectel modem /sys/bus/usb/devices/1-4 2c7c/6002/318 ……. [039:305] [cmd] < PROG100 [039:305] [cmd] < OKAY [039:305] [INFO: Aboot ] Waiting for 1 second to reboot... bluk in = -1, errno: 9 (Bad file descriptor) [040:310] Upgrade module successfullyroot@OpenWrt:~# echo $? 0 查看工具打印的最后一行日志，若显示如下，则表示升级失败； # ./QDloader -f ~/ec200s.bin [000:000] Version: Quectel_QDloader_Linux&Android_V0.0.4 [000:000] scan quectel modem /sys/bus/usb/devices/1-4 2c7c/6002/318 ……. [007:925] Upgrade module fail # echo $? 110 如果固件升级失败，可通过对比升级成功的日志初步排查失败原因。升级成功的.txt 日志文件位于工 具包中/log 目录下。 上海移远通信技术股份有限公司 11 / 12 5 附录 术语缩写 表 4：术语缩写 缩写 ID LTE USB 英文全称 Identifier Long-Term Evolution Universal Serial Bus QDloader Linux Android 用户指导 中文全称 标识符 长期演进 通用串行总线 上海移远通信技术股份有限公司 12 / 12

QConnectManager Linux 用户指导 版本：1.0 日期：2021-11-04 状态：受控文件 QConnectManager Linux 用户指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 20 QConnectManager Linux 用户指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 2 / 20 QConnectManager Linux 用户指导 文档历史 修订记录 版本 1.0 日期 2021-08-25 2021-11-04 作者 Carl YIN Carl YIN 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 20 QConnectManager Linux 用户指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块和驱动 .......................................................................................................................... 6 2 工具包 ................................................................................................................................................... 9 3 工具参数 .............................................................................................................................................. 10 4 使用指导 .............................................................................................................................................. 12 4.1. 准备工具 ................................................................................................................................... 12 4.2. 基本用法 ................................................................................................................................... 12 4.3. 单路拨号 ................................................................................................................................... 13 4.4. 聚合拨号 ................................................................................................................................... 13 4.5. 多路拨号 ................................................................................................................................... 14 4.6. 网桥 .......................................................................................................................................... 15 5 常见问题 .............................................................................................................................................. 17 6 附录 参考文档及术语缩写 .................................................................................................................. 19 上海移远通信技术股份有限公司 4 / 20 QConnectManager Linux 用户指导 表格索引 表 1：适用模块和驱动 .................................................................................................................................. 6 表 2：文件列表 ............................................................................................................................................. 9 表 3：参数说明 ........................................................................................................................................... 10 表 4：聚合拨号 ........................................................................................................................................... 13 表 5：多路拨号 ........................................................................................................................................... 14 表 6：参考文档 ........................................................................................................................................... 19 表 7：术语缩写 ........................................................................................................................................... 19 上海移远通信技术股份有限公司 5 / 20 QConnectManager Linux 用户指导 1 引言 QConnectManager 为移远通信提供的网卡拨号工具，支持 QMI、MBIM 协议拨号和 AT+QNETDEVCTL 拨号。该工具支持移远通信的 qmi_wwan_q、GobiNet、pcie_mhi、pcie_mhi_mbim 驱动以及 Linux 内核中 的 qmi_wwan、cdc_mbim、cdc_ncm、RNDIS 和 ECM 驱动，同时支持聚合、多路 PDN 拨号、网桥等高 级功能。 QConnectManager 可自动检测移远通信模块以及其使用的拨号协议。本文档主要介绍如何使用该工具 及一些常见问题。 1.1. 适用模块和驱动 表 1：适用模块和驱动 驱动 qmi_wwan qmi_wwan_q GobiNet 协议/AT 命令 QMI QMI QMI cdc_mbim MBIM 聚多网 合 路 桥 模块系列 - - √ √ √ √ √ √ LTE Standard √ √ LTE-A 适用模块 ⚫ AG35-CEN ⚫ EC20-CE ⚫ EC20-CN ⚫ EC21 系列 ⚫ EC25 系列 ⚫ EG21-G ⚫ EG25-G ⚫ EG91 系列 ⚫ EG95 系列 ⚫ EM05 系列 ⚫ EM06 系列 ⚫ EG06 系列 ⚫ EP06 系列 ⚫ EG060K-EA ⚫ EG12 系列 ⚫ EM12-G ⚫ EG18 系列 ⚫ EM160R-GL ⚫ EM120R-GL ⚫ EG512R-EA 上海移远通信技术股份有限公司 6 / 20 pcie_mhi pcie_mhi_mbim cdc_ncm RNDIS ECM QConnectManager Linux 用户指导 ⚫ EM121R-GL QMI MBIM 车规级 5G √ √ √ LTE-A √ √ √ 5G ⚫ AG35 系列 ⚫ AG520R 系列 ⚫ AG521R 系列 ⚫ AG529R-CN ⚫ RG500Q 系列 ⚫ RG501Q 系列 ⚫ RG502Q 系列 ⚫ RM500Q 系列 ⚫ RM502Q 系列 ⚫ RM505Q-AE ⚫ RM510Q-GL ⚫ EM160R-GL ⚫ EM120R-GL ⚫ EG512R-EA ⚫ EM121R-GL ⚫ RG500Q 系列 ⚫ RG501Q 系列 ⚫ RG502Q 系列 ⚫ RM500Q 系列 ⚫ RM502Q 系列 ⚫ RM505Q-AE ⚫ RM510Q-GL AT+QNETDEVCTL √ AT+QNETDEVCTL √ - √ ⚫ UC200T 系列 √ UMTS/HSPA+ ⚫ UG89 ⚫ EC200T 系列 ⚫ EC200S 系列 ⚫ EC600S-CN ⚫ EC200N-CN ⚫ EC600N-CN ⚫ EC100N-CN AT+QNETDEVCTL - - √ LTE Standard ⚫ EG912Y-EU ⚫ EC100Y-CN ⚫ EC200U 系列 ⚫ EC600U 系列 ⚫ EG500U-CN ⚫ EG700U-CN ⚫ RG500U-CN 5G ⚫ RM500U-CN 上海移远通信技术股份有限公司 7 / 20 QConnectManager Linux 用户指导 备注 1. 支持 USB 接口的模块可通过 AT+QCFG='usbnet'配置成不同的网卡模式。 2. qmi_wwan、cdc_mbim、ECM、RNDIS 和 cdc_ncm 均为 Linux 内核内置驱动。Linux 内核 3.4 及以 上版本支持 qmi_wwan 驱动；Linux 内核 3.18 及以上版本支持 cdc_mbim 驱动；Linux 内核 2.6 及以 上版本支持 ECM/RNDIS/cdc_ncm 驱动。 3. qmi_wwan_q 为移远通信基于 qmi_wwan 开发的驱动。 4. pcie_mhi 和 pcie_mhi_mbim 使用同一份驱动源码，模块参数 mhi_mbim_enabled 设置为 1，表示使 用 MBIM 驱动；模块参数 mhi_mbim_enabled 设置为 0，表示使用 QMI 驱动。 5. '√'表示支持，'-'表示不支持或不适用。 上海移远通信技术股份有限公司 8 / 20 QConnectManager Linux 用户指导 2 工具包 QConnectManager 工具包内含参考日志文件、工程文件、源代码等文件。相关文件如下表所示： 表 2：文件列表 目录 log Makefile .c和.h文件 Notice ReleaseNote.txt 说明 该目录包含 QConnectManager 工具的使用日志。拨号失败时，可对比该日 志以初步排查错误原因。 工程文件和源代码。Linux 操作系统用户可据此对 QConnectManager 工具进 行编译，并生成可执行程序。 版权信息。 修改记录。 上海移远通信技术股份有限公司 9 / 20 QConnectManager Linux 用户指导 3 工具参数 QConnectManager 工具支持多个参数设置，各参数用法详见下表。 表 3：参数说明 序号 参数 1 -s apn [user password auth] 2 -f logfile 3 -u usbmonlog 4 -v 5 -4 6 -6 7 -i iface 8 -n pdn 9 -k pdn 可选/强制 可选 可选 可选 可选 可选 可选 可选 可选 可选 说明 设置拨号时的 apn/user/password/auth 参数。需向 签约运营商咨询获取，其中参数 auth 可设置为 0（无 验证）、1（PAP 验证）、2（CHAP 验证）。 保存该工具日志到 log 文件。 保存 usbmon log 至参数-u 指定的文件。使用该参数 前需确保用户 Linux 操作系统已移植 usbmon 驱动。 usbmon 即 USB 监控工具（USB monitor），用于监 控 USB 总线上的数据传输。使用 QMI/MBIM/AT 命 令进行网卡拨号且模块无回应时，可通过此 log 查找 原因。 打印二进制 QMI 和 MBIM 消息。 使用 QMI/MBIM 拨号且模块无回应或拨号失败时， 可通过此 log 查找原因。 本次拨号 IPv4。 本次是否拨号 IPv6。 -4 本次只拨号 IPv4 -6 本次只拨号 IPv6 -4 -6 本次同时拨号 IPv4 和 IPv6 无-4 -6 本次默认只拨号 IPv4 当用户产品中有多个移远通信模块时，可通过'-i 网卡名'的方式设置本次拨号需使用的模块。 指定使用第几路 PDN 拨号。默认为 1。 ⚫ 使用 QMI/MBIM 多路拨号时，可通过该参数指 定使用第几路 PDN 拨号，且该参数必须设置。 ⚫ 使用单路拨号时，该参数可根据需求设置。 ⚫ 使用美国 Verizon 网络时，必须设置为 3。 用于在 QMI/MBIM 多路拨号时，断开通过-n pdn 参 数配置的 PDN 拨号。 上海移远通信技术股份有限公司 10 / 20 10 -m iface-idx 11 -b 12 -p pincode 13 -p proxy server 可选 可选 可选 可选 QConnectManager Linux 用户指导 默认为-n X，即绑定本次拨号到第 X 个网卡。 使用 QMI/MBIM 多路拨号时，默认绑定到-n 参数指 定的网卡；其中，使用 QMI 多路拨号时，还可通过 该参数绑定拨号到其他网卡。 使能网桥模式，仅支持 QMI 拨号。 用于验证(U)SIM 卡的 PIN 码。该参数仅在(U)SIM 卡设置了 PIN 码时使用。 连接到代理程序（不直接打开 QMI/MBIM 设备节 点）。支持 quectel-qmi-proxy、quectel-mbim-proxy、 qmi-proxy、mbim-proxy 等代理程序。 如 使 用 QMI/MBIM 多 路 拨 号 ， 需 运 行 多 个 QConnectManager 实例。 qmi_wwan_q/cdc_mbim/pcie_mhi 驱动限定同时只 可有一个应用程序读写 QMI/MBIM 设备节点。因此， 当运行多个 QConnectManager 实例时，需使用一 个 QMI/MBIM 代 理 程 序 ， 将 所 有 的 QConnectManager 实例连接到该代理程序以读写 QMI/MBIM 设备节点。 当使用 QMI/MBIM 多路拨号、且未通过该参数指定 代 理 程 序 时 ， QConnetManager 将 自 动 连 接 quectel-qmi-proxy 或 quectel-mbim-proxy。 上海移远通信技术股份有限公司 11 / 20 QConnectManager Linux 用户指导 4 使用指导 本章节介绍如何使用 QConnectManager 在 Linux 操作系统上进行拨号。 4.1. 准备工具 执行如下命令编译工具源码，生成可执行程序： make CROSS_COMPILE= 编译三个可执行程序 quectel-CM、quectel-qmi-proxy、quectel-mbim-proxy。quectel-CM 为拨号程序， quectel-qmi-proxy 和 quectel-mbim-proxy 为多路 PDN 拨号时需使用的代理程序。 备注 qmi-proxy 和 mbim-proxy 为开源驱动，用户可根据需要自行安装。 4.2. 基本用法 执行如下命令运行 quectel-CM： ./quectel-CM & quectel-CM 需持续运行，不可退出。命令末尾'&'用于保持程序后台运行。 如需断开拨号，运行如下命令直接退出 quectel-CM 即可。 Killall quectel-CM 上海移远通信技术股份有限公司 12 / 20 4.3. 单路拨号 若只需要一路 PDN 拨号，可参考第 4.2 章。 每个驱动的拨号日志如下： ⚫ log/cdc_mbim.txt ⚫ log/ecm_ncm_rndis.txt ⚫ log/gobinet.txt ⚫ log/pcie_mhi_mbim.txt ⚫ log/pcie_mhi_qmap=1.txt ⚫ log/qmi_wwan_q.txt ⚫ log/qmi_wwan.txt QConnectManager Linux 用户指导 4.4. 聚合拨号 传统拨号方式一次 USB 传输（URB）中仅携带一个 IP 网络包，而聚合拨号可在一次 USB 传输（URB） 中携带多个 IP 网络包。通过聚合拨号，可以极大减少 USB 传输次数，从而减少系统 CPU 负载，提高数据 吞吐量。 ⚫ 使用支持 LTE-A 和 5G 网络的模块时，推荐使用聚合拨号。 ⚫ 使用支持 LTE 网络的模块时，如上位机 CPU 频率较低、吞吐测试时未能达到理论速率，推荐使用 聚合拨号。 按照如下所示使能聚合后，参考第 4.2 章拨号即可。 表 4：聚合拨号 驱动 qmi_wwan_q GobiNet 使能 设置模块参数qmap_mode为1。 1 使能 0 关闭 大于1 多路拨号 该参数默认值为0。 使用支持LTE-A和5G网络的模块时，即使qmap_mode为0，也会自动使能聚合。 日志：log/qmi_wwan_q_qmap=1.txt 设置模块参数qmap_mode为1。 1 使能 0 关闭 上海移远通信技术股份有限公司 13 / 20 pcie_mhi pcie_mhi_mbim cdc_mbim cdc_ncm RNDIS 大于1 多路拨号 该参数默认值为0。 日志：log/gobinet_qmap=1.txt 设置模块参数qmap_mode为1。 1 使能 0 关闭 大于1 多路拨号 该参数默认值为1。 日志：log/pcie_mhi_qmap=1.txt 设置模块参数qmap_mode为1。 1 使能 0 关闭 大于1 多路拨号 该参数默认值为1。 日志：log/pcie_mhi_mbim.txt 无需设置，自动使能。 日志：log/cdc_mbim.txt 无需设置，自动使能。 日志：log/ecm_ncm_rndis.txt 无需设置，自动使能。 日志：log/ecm_ncm_rndis.txt QConnectManager Linux 用户指导 4.5. 多路拨号 多路拨号是指在一个物理网卡的基础上创建多个虚拟网卡，不同 PDN 上的拨号通过不同的虚拟网卡上 网。 使用不同驱动进行多路拨号的基本步骤如下： 表 5：多路拨号 驱动 qmi_wwan_q GobiNet 使能 1. 设置模块参数qmap_mode为需要的网卡个数，例如4。最大可设置为7。 2. 后台运行quectel-qmi-proxy -d /dev/cdc-wdm0代理程序。 3. 调用quectel-CM工具拨号，-n参数指定使用第几路PDN拨号。 日志：log/qmi_wwan_q_qmap=4.txt 1. 设置模块参数qmap_mode为需要的网卡个数，例如4。最大可设置为7。 2. 调用quectel-CM工具拨号，-n参数指定使用第几路PDN拨号。 日志：log/gobinet_qmap=4.txt 上海移远通信技术股份有限公司 14 / 20 QConnectManager Linux 用户指导 pcie_mhi pcie_mhi_mbim cdc_mbim 1. 设置模块参数qmap_mode为需要的网卡个数，例如4。最大可设置为7。 2. 后台运行quectel-qmi-proxy -d /dev/mhi_QMI0代理程序。 3. 调用quectel-CM工具拨号，-n参数指定使用第几路PDN拨号。 日志：log/pcie_mhi_qmap=4.txt 1. 设置模块参数qmap_mode为需要的网卡个数，例如4。最大可设置为7。 2. 后台运行quectel-mbim-proxy -d /dev/mhi_MBIM代理程序。 3. 调用quectel-CM工具拨号，-n参数指定使用第几路PDN拨号。 日志：log/pcie_mhi_mbim_qmap=4.txt 1. 使用如下命令创建VLAN网卡。X表示第几路PDN。 # ip link add link wwan0 name wwan0.X type vlan id X 2. 后台运行quectel-mbim-proxy -d /dev/cdc-wdm0代理程序。 3. 调用quectel-CM工具拨号。-n参数指定使用第几路PDN拨号，取值与创建VLAN 网卡时的X相同。 日志：log/cdc_mbim_vlan.txt 4.6. 网桥 传统的路由器应用方式是个人电脑、手机等设备通过 Wi-Fi/网线连接到路由器的 LAN 网卡，路由器将 模块网卡作为 WAN 网卡。个人电脑获取到的 IP 为以数字 192 开头的局域网 IP，路由器使用 NAT 的方式 让个人电脑最终可以通过 WAN 网卡连网。这种应用方式下，如需将个人电脑作为 TCP/UDP 服务器使用， 则必须在路由器上设置端口转发。 另一种实现方式则是将 LAN 网卡和 WAN 网卡加入到一个网桥中，以使个人电脑直接获取运营商 IP 地 址。如通过网桥方式，网卡需支持 ARP 功能。使用 ECM、RNIDS 和 cdc_ncm 驱动时，生成的网卡支持 ARP 功能，可直接加入网桥。使用 GobiNet、pcie_mhi、qmi_wwan_q 和 pcie_mhi_mbim 驱动时，创建的 网卡不支持 ARP 功能，此时如需使用网桥功能，可按照如下步骤操作： 1. 使能驱动源码中的宏 QUECTEL_BRIDGE_MODE。源码路径如下：Quectel_Linux_PCIE_MHI_ Driver_V1.3.1.zippcie_mhidevicesmhi_netdev_quectel.c。 2. 参考第 4.4 章和第 4.5 章使能驱动的聚合/多路设置。 3. 如为多路拨号，需根据不同驱动后台运行 quectel-qmi-proxy 或 quectel-mbim-proxy 代理程序。 4. 创建网桥，并将相关网卡加入网桥。 一个网桥中只能加入一个 LAN 网卡和一个移远通信模块的网卡；且路由器不可再调用任何 DHCP 程序从模块中获取 IP 地址。 5. 调用 quectel-CM 拨号，拨号时需携带-b 参数，表示本次拨号需要使用网桥功能。 下列日志文件展示 GobiNet、pcie_mhi、qmi_wwan_q 和 pcie_mhi_mbim 驱动使用网桥功能拨号的步 骤： ⚫ log/gobinet_bridge.txt ⚫ log/gobinet_qmap=1_bridge.txt 上海移远通信技术股份有限公司 15 / 20 ⚫ log/gobinet_qmap=4_bridge.txt ⚫ log/pcie_mhi_qmap=1_bridge.txt ⚫ log/pcie_mhi_qmap=4_bridge.txt ⚫ log/qmi_wwan_q_bridge.txt ⚫ log/qmi_wwan_q_qmap=1_bridge.txt ⚫ log/qmi_wwan_q_qmap=4_bridge.txt ⚫ log/pcie_mhi_mbim_qmap=1_bridge.txt ⚫ log/pcie_mhi_mbim_qmap=4_bridge.txt QConnectManager Linux 用户指导 上海移远通信技术股份有限公司 16 / 20 QConnectManager Linux 用户指导 5 常见问题 1. 问：为什么显示拨号成功，却无法上网？ 答：（1）运行 ifconfig 命令检查网卡是否有 IP 地址。 （2）运行 ip ro show 命令检查路由表设置，确保只有一个默认路由、且其使用的是模块的网卡。 2. 问：为什么可以 PING 通 IP，但无法 PING 通域名？ 答：运行 cat /etc/resolv.conf 命令检查是否有 DNS、且 DNS 是通过 quectel-CM 工具拨号获取的。 3. 问：为什么 udhcpc 显示已获取 IP，但网卡却没有 IP？ 答：Udhcpc 成功获取到 IP 和 DNS 之后，调用 default.script 脚本文件，该脚本文件负责设置网卡 IP 和 更新 DNS 到/etc/resolv.conf。 可运行下列命令查看该脚本的存放位置。请确保该脚本文件存在且有可执行权限。 # busybox udhcpc -h -s PROG Run PROG at DHCP events (default /etc/udhcpc/default.script) 如不存在，可拷贝 quectel-CM 源码目录里的 default.script 至 default/etc/udhcpc/目录下，需注意该 脚本应有可执行权限。 4. 问：拨号失败时需提供哪些 log？ 答：（1）首先执行 AT 命令检测模块是否注网成功：通过 AT+COPS?获取运营商信息，再执行 AT+CGREG? （3G 网络）、AT+CEREG?（4G 网络）或 AT+C5GREG?（5G 网络）获取模块注网状态。 （2）运行 quectel-CM 工具时带上参数-v -u usbmon_logfile；然后提供 quectel-CM 工具的运行日志 以及 usbmon_logfile。 （3）使用 QLog 工具抓取模块的日志。关于 QLog 工具的详细信息，请参考文档 [1]。 5. 问：如何通过 OpenWrt 上网？ 答：除需在 OpenWrt 上运行 quectel-CM 工具拨号外，还需将模块的网卡设置为 WAN 网卡，可通过如 下命令查看网卡配置： # uci show network.wan.ifname network.wan.ifname='usb0' 再执行命令 ifstatus wan 查看 WAN 网卡的状态。 6. 问：多路 PDN 拨号时，如何选择 PDN 通路？ 答：部分 PDN 通路已被模块内部应用使用，不建议用户使用此类 PDN 通路进行拨号。一般而言，内部 使用的 PDN 通路名称中含有'ims'、'SOS'等字符，可通过如下命令查看： 上海移远通信技术股份有限公司 17 / 20 QConnectManager Linux 用户指导 # busybox microcom /dev/ttyUSB2 AT+CGDCONT? +CGDCONT: 1,'IP','cmnet','0.0.0.0',0,0,0,0 +CGDCONT: 2,'IPV4V6','ims','0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0',0,0,0,0 +CGDCONT: 3,'IPV4V6','SOS','0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0',0,0,0,1 OK 可选择内部未使用的 PDN 通路或未设置过 APN 的 PDN 通路进行拨号。 对于未设置过 APN 的 PDN 通路，必须先通过 AT+CGDCONT 或 AT+QICSGP 设置 APN 后，才可 使用 quectel-CM 工具拨号，否则将导致拨号失败。 备注 文档相关 AT 命令，请参考对应模块的 AT 命令手册及 TCP(IP)应用指导。 上海移远通信技术股份有限公司 18 / 20 QConnectManager Linux 用户指导 6 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_QLog_Linux&Android_用户指导 表 7：术语缩写 缩写 APN ARP CDC CHAP CPU DHCP DNS ECM IP IPv4 IPv6 LAN LTE MBIM MHI 英文全称 Access Point Name Address Resolution Protocol Communications Device Class Challenge-Handshake Authentication Protocol Central Processing Unit Dynamic Host Configuration Protocol Domain Name Server Ethernet Control Model Internet Protocol Internet Protocol version 4 Internet Protocol version 6 Local Area Network Long-Term Evolution Mobile Broadband Interface Model Modem Host Interface 中文全称 接入点名称 地址解析协议 通信设备类 挑战握手认证协议 中央处理器 动态主机设置协议 域名系统（服务）协议 以太网控制模型 网际互连协议 第 4 版互联网协议 第 6 版互联网协议 局域网 长期演进 移动宽带接口模型 调制解调器主机接口 上海移远通信技术股份有限公司 19 / 20 NAT NCM PAP PCIe PDN PIN QMI RNDIS TCP UDP URB USB (U)SIM VLAN WAN WWAN QConnectManager Linux 用户指导 Network Address Translation Network Control Model Password Authentication Protocol Peripheral Component Interconnect express Public Data Network Personal Identification Number Qualcomm Message Interface Remote Network Driver Interface Specification Transmission Control Protocol User Datagram Protocol USB Request Block Universal Serial Bus (Universal) Subscriber Identity Module Virtual Local Area Network Wide Area Network Wireless Wide Area Network 网络地址转换 网络控制模型 口令验证协议 快捷外围部件互连标准 公用数据网络 个人识别号 高通信息接口 远程网络驱动接口规范 传输控制协议 用户数据报协议 USB 请求块 通用串行总线 （通用）用户识别模块 虚拟局域网 广域网 无线广域网 上海移远通信技术股份有限公司 20 / 20

QLog Linux&Android 用户指导 UMTS/HSPA(+)/LTE/5G 模块系列 版本：1.0 日期：2020-08-27 状态：受控文件 www.quectel.com QLog Linux&Android 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 17 QLog Linux&Android 用户指导 文档历史 修订记录 版本 1.0 日期 2020-08-27 作者 殷张成 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 17 QLog Linux&Android 用户指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 工具包 ................................................................................................................................................... 8 3 工具参数 ................................................................................................................................................ 9 4 使用指导 .............................................................................................................................................. 10 4.1. Linux......................................................................................................................................... 10 4.1.1. 抓取 Log 数据和 Dump 信息至本地存储 ....................................................................... 10 4.1.2. Linux 设备和 QWinLog 配合通过局域网抓取 Log 数据 ..................................................11 4.1.3. Linux 设备和 QPST 配合通过局域网抓取 Log 数据 ...................................................... 12 4.1.4. Linux 设备和 TFPT 配合通过局域网抓取 Dump 信息 ................................................... 13 4.2. Android ..................................................................................................................................... 14 4.2.1. 抓取 Log 数据和 dump 信息至本地存储 ........................................................................ 15 4.2.2. Android 设备和 QwinLog、QPST 以及 ADB 配合通过局域网抓取 Log 数据................ 16 5 附录 A 术语缩写 ................................................................................................................................. 17 上海移远通信技术股份有限公司 3 / 17 QLog Linux&Android 用户指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：参数说明 ............................................................................................................................................. 9 表 3：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 4 / 17 QLog Linux&Android 用户指导 图片索引 图 1：抓取 Log 数据至本地存储................................................................................................................. 10 图 2：抓取 Dump 信息至本地存储 ..............................................................................................................11 图 3：QLog 工具通过局域网抓取 Log 数据.................................................................................................11 图 4：QWinLog 工具配置局域网模式......................................................................................................... 12 图 5：QPTS 工具配置 ................................................................................................................................ 12 图 6：QPST 局域网模式 ............................................................................................................................ 13 图 7：Tftp32 局域网模式 ............................................................................................................................ 13 图 8：QLog 工具局域网抓取 Dump 信息 ................................................................................................... 14 图 9：抓取 Log 数据至本地存储................................................................................................................. 15 图 10：抓取 Dump 信息至本地存储 ........................................................................................................... 15 上海移远通信技术股份有限公司 5 / 17 QLog Linux&Android 用户指导 1 引言 本文档主要介绍了如何使用 QLog 工具从 Linux 和 Android 系统中抓取移远通信模块的 log 数据和 dump 信息。 QLog 工具会自动探测模块当前是正常工作还是 dump 状态，以抓取 log 数据和 dump 信息，并保存到 客户设备的存储器（例如硬盘、U 盘）中。若客户设备上的本地存储空间不足，QLog 还支持通过局域网将 log 数据和 dump 信息保存至客户电脑上。 1.1. 适用模块 表 1：适用模块 模块系列 UMTS/HSPA(+) LTE Standard LTE Automotive LPWA LTE-A 型号 ⚫ UC15 ⚫ UC200T ⚫ AG35-CEN ⚫ EC2x：EC25/EC21/EC20 R2.1 ⚫ EG2x-G：EG25-G/EG21-G ⚫ EG9x：EG91/EG95 ⚫ EM05 ⚫ EP200F-CE ⚫ EC20-CN ⚫ EC200T ⚫ EG912Y ⚫ ECx00S：EC200S/EC600S-CN ⚫ AGxx：AG15/AG35 ⚫ AG52xR：AG520R/AG521R/AG529R-CN ⚫ AG55xQ：AG550Q/AG551Q/AG552Q/AG553Q ⚫ AG215S-CN ⚫ BGxx：BG95/BG77 ⚫ Ex06：EG06/EP06/EM06 ⚫ Ex12：EG12/EM12-G ⚫ EG18 ⚫ EG512R-EA 上海移远通信技术股份有限公司 6 / 17 QLog Linux&Android 用户指导 ⚫ EM160R-GL ⚫ EM120R-GL ⚫ EG060V-EA ⚫ RG50xQ：RG500Q/RG502Q-EA 5G ⚫ RM5xxQ：RM500Q/RM502Q-GL/RM510Q-GL ⚫ RG500U-CN 备注 上表所列模块产品可能包含多个型号，详细信息可参考各模块产品规格书。 上海移远通信技术股份有限公司 7 / 17 QLog Linux&Android 用户指导 2 工具包 QLog 工具包包含源码、过滤器配置文件、示例以及 Android 上可直接执行的程序。 文件列表如下： ⚫ main.c asr.c mdm.c sahara.c tty2tcp.c ⚫ Android.mk Makefile ⚫ qlog.h sahara_protocol.h ⚫ conf/*.cfg ⚫ example_catch_asr_dump.txt ⚫ example_catch_dump.readme.txt ⚫ example_catch_dump_by_tftp.readme.txt ⚫ android/arm64-v8a/QAndroidLog ⚫ android/armeabi/QAndroidLog 其中 conf/*.cfg 是过滤器配置文件。 备注 1. 请确保 QLog 工具有读写模块的权限。 2. UC200T 系列模块不需要过滤器配置文件。 3. Linux 上可执行的程序需客户自己编译，可参考第 4.1 章。 上海移远通信技术股份有限公司 8 / 17 QLog Linux&Android 用户指导 3 工具参数 QLog 工具支持配置多个参数，可根据实际需求选择并配置参数。本章节详细介绍了每个参数的用法及 配置说明。 表 2：参数说明 序号 参数 1 -p 可选/强制 可选 2 -m 可选 3 -n 可选 4 -s 可选 5 -f 可选 说明 串口，表示模块上用于抓取 log 数据或者 dump 信息的 DM 口。因 QLog 工具会自动探测，因此不建议对该参数进行 配置。若客户系统中存在多个模块，需配置该参数以指定 需要抓取 log 数据或者 dump 信息的模块。 单个 log 文件的最大值。 单位：MB 默认：128 可设置范围：2~512 可保存至本地存储的最大 log 文件个数。 默认：0 可设置范围：0~512 0 表示无个数限制，其他值表示当实际文件个数超过设置 的最大数时，QLog 工具将自动删除最老的 log 文件。 QLog 支持保存 log 和 dump 到本地存储，以及通过局域 网保存到客户电脑上，使用不同方式保存 log 和 dump 时， 本参数的作用不同。 1. 保存 log 和 dump 到本地存储时，表示文件的存储目 录名，若未设置该参数，则默认保存在当前目录。详 细使用方法可参考 第 4.1.1 章、第 4.2.1 章。 2. 通过局域网保存 log 到客户电脑时，必须设置此参数 为 9000。详细使用方法可参考 第 4.1.2 章、第 4.1.3 章。 3. 通过局域网保存 dump 到客户电脑上的 TFTP Server 时。必须设置此参数为 tftp:客户电脑 IP。详细使用方 法可参考 第 4.1.4 章。 过滤器配置文件名（UC200T 系列模块不需要指定过滤文 件）。如果未设置该参数，则会使用 QLog 文件内置的默认 过滤配置。 上海移远通信技术股份有限公司 9 / 17 QLog Linux&Android 用户指导 4 使用指导 本章节主要介绍如何使用 QLog 工具从 Linux 和 Android 系统中抓取移远通信模块的 log 数据和 dump 信息。 4.1. Linux 使用 Linux 系统，需先编译 QLog 源码，编译出可执行的 QLog 程序，命令如下： make CROSS_COMPILE= 在抓取 log 数据和 dump 信息之前，需把编译后的可执行 QLog 程序和过滤文件拷贝到设备上，然后根 据需求设置不同的参数，最后调用 QLog 程序抓取 log 数据和 dump 信息。 4.1.1. 抓取 Log 数据和 Dump 信息至本地存储 图 1：抓取 Log 数据至本地存储 上海移远通信技术股份有限公司 10 / 17 QLog Linux&Android 用户指导 图 2：抓取 Dump 信息至本地存储 4.1.2. Linux 设备和 QWinLog 配合通过局域网抓取 Log 数据 若需长时间抓取 log 数据，但本地存储不足，可通过局域网抓取 log 数据。QWinLog 是由移远通信开 发，用于在 Windows 上抓取 log 数据的工具。该方法要求客户电脑和 Linux 设备位于同一个局域网，在 Linux 设备上运行 QLog 工具抓取 log 数据，然后通过局域网发送至客户电脑上运行的 QWinLog 工具。关于该工 具的详细信息，可联系移远通信技术支持。 首先配置参数'-s 9000'设置 Qlog 工具运行模式为服务器模式，9000 为端口号。 图 3：QLog 工具通过局域网抓取 Log 数据 上海移远通信技术股份有限公司 11 / 17 QLog Linux&Android 用户指导 然后在客户电脑上运行 QWinLog 工具，选择 LAN 模式，输入 Linux 设备的 IP 地址和 9000 端口。 图 4：QWinLog 工具配置局域网模式 备注 抓取并发送 log 数据过程中，因为 log 的数据量较大且需要实时传输，而 Wi-Fi 网络一般不太稳定，推荐使 用有线网。 4.1.3. Linux 设备和 QPST 配合通过局域网抓取 Log 数据 该方法与第 4.3 章中所述和 QWinLog 配合通过局域网抓取 log 数据类似，区别在于客户电脑上运行的 工具为 QPST 工具。 首先在 Linux 设备上运行./QLog -s 9000 设置 QLog 工具运行模式为服务器模式。然后在客户电脑上 运行 QPST 工具，输入 Linux 设备的 IP 地址和 9000 端口号，如下图所示： 上海移远通信技术股份有限公司 图 5：QPTS 工具配置 12 / 17 QLog Linux&Android 用户指导 备注 使用 QPST 工具需高通授权。 图 6：QPST 局域网模式 4.1.4. Linux 设备和 TFPT 配合通过局域网抓取 Dump 信息 该方法要求客户电脑和 Linux 设备之间位于同一个局域网，在 Linux 设备上运行 QLog 工具抓取 dump 信息，然后通过局域网发送至客户电脑上运行的 Tftpd32 工具。 首先在客户电脑上运行 Tftpd32 工具并进行配置，如下所示： 图 7：Tftp32 局域网模式 上海移远通信技术股份有限公司 13 / 17 QLog Linux&Android 用户指导 然后在 Linux 设备上运行./QLog -s tftp:192.168.1.20，其中 192.168.1.20 为客户电脑的 IP 地址。 图 8：QLog 工具局域网抓取 Dump 信息 备注 若客户电脑上开启了防火墙，建议临时关闭，否则防火墙可能会拒绝 QLog 工具的访问，导致抓取 dump 信息失败。 4.2. Android 对于 Android 系统，移远通信已提供编译好的 QLog 程序，可直接使用。 在抓取 log 数据和 dump 信息之前，需把编译好的 QLog 程序和过滤器配置文件拷贝到设备上，然后根 据需求设置不同的参数，最后调用 QLog 程序抓取 log 数据和 dump 信息。 上海移远通信技术股份有限公司 14 / 17 QLog Linux&Android 用户指导 4.2.1. 抓取 Log 数据和 dump 信息至本地存储 Android 设备，本地存储空间一般较大，可直接抓取 log 数据和 dump 信息保存至 Android 设备的本地 存储器。 图 9：抓取 Log 数据至本地存储 图 10：抓取 Dump 信息至本地存储 上海移远通信技术股份有限公司 15 / 17 QLog Linux&Android 用户指导 4.2.2. Android 设备和 QwinLog、QPST 以及 ADB 配合通过局域网抓取 Log 数据 若需长时间抓取 log 数据，但本地存储不足，可使用第 4.1.2 章、第 4.1.3 章介绍的方法进行抓取。由 于客户电脑和 Android 设备之间一般通过 USB 连接，可使用 ADB 工具建立虚拟网络连接，命令如下： C:UsersQ>adb forward tcp:9000 tcp:9000 随后可参考 4.1.2 章、第 4.1.3 章的步骤，在 QwinLog 和 QPST 工具里设置 IP 地址为 127.0.0.1 以及 端口为 9000，最后进行 Log 数据的抓取。 上海移远通信技术股份有限公司 16 / 17 QLog Linux&Android 用户指导 5 附录 A 术语缩写 表 3：术语缩写 缩写 ADB DM HSPA IP LAN LPWA QPST TCP TFPT UMTS USB 英文全称 中文全称 Android Debug Bridge 安卓调试桥 Diagnostics 诊断端口 High-Speed Packet Access 增强型高速分组接入技术 Internet Protocol 网际互连协议 Local Area Network 局域网 Low-Power Wide-Area 低功耗广域技术 Qualcomm Product Support Tool 针对高通芯片开发的传输软件 Transmission Control Protocol 传输控制协议 Trivial File Transfer Protocol 简单文件传送协议 Universal Mobile Telecommunications System 通用移动通信系统 Universal Serial Bus 通用串行总线 上海移远通信技术股份有限公司 17 / 17

LTE&5G QFirehose Linux&Android 用户指导 LTE/5G 模块系列 版本：1.0 日期：2020-08-27 状态：受控文件 www.quectel.com LTE&5G QFirehose Linux&Android 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 12 LTE&5G QFirehose Linux&Android 用户指导 文档历史 修订记录 版本 1.0 日期 2020-08-27 作者 殷张成 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 12 LTE&5G QFirehose Linux&Android 用户指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 1.1. 适用模块 ..................................................................................................................................... 5 2 工具包 ................................................................................................................................................... 7 3 工具参数 ................................................................................................................................................ 8 4 使用指导 ................................................................................................................................................ 9 4.1. 准备工具 ..................................................................................................................................... 9 4.2. 本地固件升级.............................................................................................................................. 9 4.2.1. Ubuntu 升级注意事项 .................................................................................................... 10 4.3. 局域网固件升级 ........................................................................................................................ 10 5 附录 A 术语缩写 ................................................................................................................................. 12 上海移远通信技术股份有限公司 3 / 12 LTE&5G QFirehose Linux&Android 用户指导 表格索引 表 1：适用模块 ............................................................................................................................................. 5 表 2：文件列表 ............................................................................................................................................. 7 表 3：参数说明 ............................................................................................................................................. 8 表 4：术语缩写 ........................................................................................................................................... 12 上海移远通信技术股份有限公司 4 / 12 LTE&5G QFirehose Linux&Android 用户指导 1 引言 本文档主要介绍了在 Linux 和 Android 系统上，如何使用 QFirehose 工具升级移远通信 LTE 和 5G 模 块的固件。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard LTE Automotive LTE-A 5G 模块 ⚫ AG35-CEN ⚫ EC2x：EC25/EC21/EC20 R2.1 ⚫ EG2x-G：EG25-G/EG21-G ⚫ EG9x：EG91/EG95 ⚫ EM05 ⚫ EP200F-CE ⚫ EC20-CN ⚫ AGxx：AG15/AG35 ⚫ AG52xR：AG520R/AG521R/AG529R-CN ⚫ AG55xQ：AG550Q/AG551Q/AG552Q/AG553Q ⚫ AG215S-CN ⚫ Ex06：EG06/EP06/EM06 ⚫ Ex12：EG12/EM12-G ⚫ EG18 ⚫ EG512R-EA ⚫ EM160R-GL ⚫ EM120R-GL ⚫ RG50xQ：RG500Q/RG502Q-EA ⚫ RM5xxQ：RM500Q/RM502Q-GL/RM510Q-GL 上海移远通信技术股份有限公司 5 / 12 LTE&5G QFirehose Linux&Android 用户指导 备注 1. 上表所列模块产品可能包含多个型号，详细信息请参考各模块产品规格书。 2. 可通过查看固件包目录下是否存在目录/update/firehose 来判断模块是否支持使用 QFirehose 工具进行 固件升级，若该目录存在，则表示模块支持使用 Qfirehose 工具升级。 3. 移远通信释放的固件包默认为 zip 压缩包，QFirehose 工具不支持直接从压缩包升级，必须先解压后方 可使用该工具进行升级。 上海移远通信技术股份有限公司 6 / 12 LTE&5G QFirehose Linux&Android 用户指导 2 工具包 QFirehose 工具包中的文件有：为 Android 系统编译好的可执行程序（Linux 系统可参考第 4.1 章编译 可执行程序）、参考日志文件、工程文件、源代码。相关文件如下表所示： 表 2：文件列表 目录 android log android.mk Makefile .c和.h文件 说明 该目录包含为 Android 系统编译好的可执行程序，可直接使用。 若 Android 系统为 32 位，选择 armeabi-v7a；若为 64 位，选择 arm64-v8a。 该目录包含 QFirehose 工具的使用日志。当遇到升级错误时，可对比日志以 初步排查错误原因。 工程文件和源代码，用于 Linux 系统客户对 QFirehose 工具进行编译，生成 可执行程序。 上海移远通信技术股份有限公司 7 / 12 LTE&5G QFirehose Linux&Android 用户指导 3 工具参数 QFirehose 工具支持多个参数设置，下表详细介绍了各参数的用法。 表 3：参数说明 序号 参数 1 -f 2 -p 可选/强制 强制 可选 说明 固件包目录名。移远通信释放的固件包默认为 zip 格式的压缩 包，必须先解压后方可使用。 模块的 DM 端口。QFirehose 工具使用 DM 口进行升级，建 议客户不要指定该参数，因为工具可智能查找 DM 口并使用。 若客户设备中存在多个移远通信模块，需通过该参数指定待 升级模块；若仅有一个模块，则无需通过该参数指定待升级 模块。 3 -s 用于标识模块，每个模块均有不同 的标识。QFirehose 工具会打印出所有模块标识，客户可根据 打印日志进行选择。 各模块的标识由客户的硬件设计决定（USB 拓扑），即使设备 或者模块重启，标识也不会改变。 仅当 Linux 系统存在一个特殊 bug 时方需使用该参数，且必 须设置为 0。 4 -z 可选 特殊 bug 指： USB 控制器类型为 XHCI，且 Linux 内核版本小于等于 V4.2 时，存在一个 USB 零包 bug。V4.2 版本上修复了该 bug，修 复 ID 是 4758dcd19a7d9ba9610b38fecb93f65f56f86346。 5 -e 可选 若当前使用的 Linux 系统上存在该 bug，建议客户优先联系芯 片厂商修复该 bug，若修复则无需使用该参数。 全部擦除模块的 NAND flash。仅在某些特殊情况下由移远通 信通知时使用，否则不可轻易使用该参数。 上海移远通信技术股份有限公司 8 / 12 LTE&5G QFirehose Linux&Android 用户指导 4 使用指导 本章节介绍了如何使用 QFirehose 工具在 LTE 和 5G 模块的 Linux 和 Android 系统上进行固件升级。 4.1. 准备工具 ⚫ 若使用 Linux 系统，可通过如下命令编译工具源码，生成可执行程序： make CROSS_COMPILE= ⚫ 若使用 Android 系统，可直接使用工具包中 Android 目录下已编译完成的可执行程序。若 Android 系统为 32 位，选择 armeabi-v7a；若为 64 位，选择 arm64-v8a。 4.2. 本地固件升级 若客户设备的存储空间足够存放模块的固件包，可参考如下步骤进行升级。 1. 拷贝固件包和编译后的 QFirehose 可执行程序文件到设备上。 2. 在设备中执行如下命令运行工具并进行固件升级： ./QFirehose -f 3. 根据工具的退出码或工具打印出的日志信息中的最后一行日志判断固件升级是否成功。 执行如下命令获取工具的退出码，0 表示升级成功，其他值表示失败。 # echo $? 查看工具打印的最后一行日志，若显示如下，则表示升级成功： root@OpenWrt:~# ./QFirehose -f /mnt/RM500QGLAAR01A01M4G_BETA_20200428F [000.000]: QFirehose Version: Quectel_LTE&5G_QFirehose_Linux&Android_V1.3.4 ……. [057.875]: firehose_protocol.c fh_recv_cmd 327 fail [057.875]: THE TOTAL DOWNLOAD TIME IS 53.818 s 上海移远通信技术股份有限公司 9 / 12 LTE&5G QFirehose Linux&Android 用户指导 [057.876]: Upgrade module successfully. root@OpenWrt:~# echo $? 0 root@OpenWrt:~# 查看工具打印的最后一行日志，若显示如下，则表示升级失败： root@OpenWrt:~# ./QFirehose -f ../EM20GRAR01A04V01M4G [000.000] QFirehose Version: LTE&5G_QFirehose_Linux&Android_V1.3.4 ……. [041.136] Upgrade module fail. root@OpenWrt:~# QFirehose_linux# echo $? 172 如果固件升级失败，可通过对比升级成功的日志初步排查失败原因。升级成功的日志文件 MCU_local.log.txt 位于工具包中/log 目录下。 4.2.1. Ubuntu 升级注意事项 如果客户需要通过 Ubuntu 电脑进行模块固件本地升级，需注意 Ubuntu 系统中的软件'qcseria.ko' 和'ModeManager'会干扰固件升级，并导致升级失败。建议在连接模块到 Ubuntu 电脑之前，执行如下 命令以保证固件升级成功： 1. 执行如下命令临时移除'qcseria.ko'： $ sudo mv /lib/modules/`uname -r`/kernel/drivers/usb/serial/qcserial.ko ~/ $ sudo rmmod qcserial 2. 执行如下命令停止服务'ModeManager'： $ sudo service ModemManager stop $ sudo service ModemManager status 3. 执行如下命令查看当前 Linux 内核版本。建议 Ubuntu 系统的 Linux 内核版本大于 4.2，可参考表 3 中关于工具参数'-z'的说明。 $ uname -r 4.3. 局域网固件升级 若客户设备存储空间不足以存放模块固件包，可使用局域网升级固件。此方法需要额外使用一台 Ubuntu 电脑，且 Ubuntu 电脑和客户设备处于同一个局域网中，固件包放在 Ubuntu 电脑里，Ubuntu 电脑和客户 设备里各自运行 QFirehose 工具，2 个 QFirehose 工具通过 TCP Socket 进行通信。 上海移远通信技术股份有限公司 10 / 12 LTE&5G QFirehose Linux&Android 用户指导 请按照如下步骤通过局域网远程升级模块固件： 1. 在 Ubuntu 电脑上准备好模块固件包和 QFirehose 工具可执行程序。 2. 在客户设备上准备好 QFirehose 工具可执行程序。 3. 在客户设备上执行如下命令调用 QFirehose 工具可执行程序，参数是'-p 9008'。 ./QFirehose -p 9008 4. 在 Ubuntu 电脑上执行如下命令调用 QFirehose 工具可执行程序开始升级模块固件，参数是 '-f < 固件包目录名> -p :9008'。 ./QFirehose -f -p :9008 5. 根据工具的退出码或工具打印出的日志信息中的最后一行日志判断固件升级是否成功。 执行如下命令获取工具的退出码，0 表示升级成功，其他值表示失败。 # echo $? 查看工具打印的最后一行日志，若显示如下，则表示升级成功： root@OpenWrt:~# ./QFirehose -f /mnt/RM500QGLAAR01A01M4G_BETA_20200428F [000.000]: QFirehose Version: Quectel_LTE&5G_QFirehose_Linux&Android_V1.3.4 ……. [057.875]: firehose_protocol.c fh_recv_cmd 327 fail [057.875]: THE TOTAL DOWNLOAD TIME IS 53.818 s [057.876]: Upgrade module successfully. root@OpenWrt:~# echo $? 0 root@OpenWrt:~# 查看工具打印的最后一行日志，若显示如下，则表示升级失败： root@OpenWrt:~# ./QFirehose -f ../EM20GRAR01A04V01M4G [000.000] QFirehose Version: LTE&5G_QFirehose_Linux&Android_V1.3.4 ……. [041.136] Upgrade module fail. root@OpenWrt:~# QFirehose_linux# echo $? 172 如果固件升级失败，可通过对比升级成功的日志初步排查失败原因。升级成功的日志文件 MCU_remote.log.txt 和 Ubuntu_remote.log.txt 位于工具包中/log 目录下。 上海移远通信技术股份有限公司 11 / 12 LTE&5G QFirehose Linux&Android 用户指导 5 附录 A 术语缩写 表 4：术语缩写 缩写 DM ID LTE MCU TCP USB XHCI 英文全称 中文全称 Diagnostics 诊断端口 Mostly refers to Identifier in terms of software 软件中多数指'标识符' (Long-Term Evolution) a 4G mobile communications 长期演进 standard Microcontroller Unit 微控制单元 Transmission Control Protocol 传输控制协议 Universal Serial Bus 通用串行总线 eXtensible Host Controller Interface 可扩展主机控制器接口 上海移远通信技术股份有限公司 12 / 12

LTE&LTE-A QFlash Linux&Android User Guide LTE/LTE-A Module Series Rev. LTE&LTE-A_QFlash_Linux&Android_User_Guide_V2.0 Date: 2019-05-05 Status: Released www.quectel.com LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. LTE&LTE-A_QFlash_Linux&Android_User_Guide 1 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide About the Document History Revision 1.0 2.0 Date 2017-05-17 2019-05-05 Author Hunter LV Lee LI Description Initial Numerous updates has been made to this document and thus it is recommended to read it in its entirety. LTE&LTE-A_QFlash_Linux&Android_User_Guide 2 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Figure Index ................................................................................................................................................. 4 1 Introduction .......................................................................................................................................... 5 1.1. Applicable Modules ................................................................................................................... 5 2 Introduction on Port ............................................................................................................................ 6 3 Operating Parameters of QFlash........................................................................................................ 7 4 Upgrade Firmware through QFlash ................................................................................................... 8 4.1. Upgrade Firmware by Method 0 (Sahara + Fastboot) .............................................................. 8 4.2. Upgrade Firmware by Method 1 (Streaming).......................................................................... 10 4.3. Upgrade Firmware by Method 2 (AT Command + Fastboot).................................................. 11 4.4. Upgrade Firmware by Method 3 (Firehose) ............................................................................ 12 LTE&LTE-A_QFlash_Linux&Android_User_Guide 3 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide Figure Index FIGURE 1: UPGRADING PROCESS (METHOD 0) ........................................................................................... 9 FIGURE 2: FIRMWARE IS UPGRADED SUCCESSFULLY (METHOD 0) ......................................................... 9 FIGURE 3: UPGRADING PROCESS (METHOD 1) ......................................................................................... 10 FIGURE 4: FIRMWARE IS UPGRADED SUCCESSFULLY (METHOD 1) ....................................................... 10 FIGURE 5: UPGRADING PROCESS (METHOD 2) ..........................................................................................11 FIGURE 6: FIRMWARE IS UPGRADED SUCCESSFULLY (METHOD 2) ....................................................... 12 FIGURE 7: UPGRADING PROCESS (METHOD 3) ......................................................................................... 12 FIGURE 8: FIRMWARE IS UPGRADED SUCCESSFULLY (METHOD 3) ....................................................... 13 LTE&LTE-A_QFlash_Linux&Android_User_Guide 4 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 1 Introduction This document mainly introduces how to use QFlash tool to upgrade firmware on Linux and Android systems for the following Quectel LTE and LTE-A modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series LTE Standard LTE LPWA Automotive LTE-A Models  EC2x: EC21/ EC25/ EC20 R2.1/ EC20 R2.0/ EC20  EG9x: EG91/ EG95  EM05  EG25-G  BG96  BG95  AG35  AG36  AG15  Ex06: EG06/ EP06/ EM06  Ex12: EG12/ EM12  EG18  EM20 LTE&LTE-A_QFlash_Linux&Android_User_Guide 5 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 2 Introduction on Port Before using QFlash tool on Linux & Android systems, please ensure that USB driver of the module has been installed successfully in host system. After the module has been connected to the host via USB cable, the corresponding USB virtual ports will be displayed. The UART ports and the descriptors of corresponding USB virtual ports on the host system are listed as below.  ttyUSB0  ttyUSB1  ttyUSB2  ttyUSB3  ttyUSB4 DM Port NEMA Port (may not be available in some customized firmware versions) AT Port Modem Port Wireless Ethernet Adapter Port NOTE The descriptors of USB virtual ports listed above are under the assumption that the host is not connected with other USB virtual devices. It is suggested that the host is only connected with Quectel modules when upgrading. LTE&LTE-A_QFlash_Linux&Android_User_Guide 6 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 3 Operating Parameters of QFlash QFlash program can specify the operating parameters in command line. The detailed parameters are illustrated as below. Table 2: Description of Operating Parameters Item 1 2 3 4 5 6 Parameter -f -p -m -u -s -v Optional/ Non-optional Non-optional Optional Optional Optional Optional Description The name of the firmware package to be upgraded. The port on which the firmware is upgraded (ttyUSBx), and the default value is ttyUSB0. Upgrading methods: 0 Sahara first and then Fastboot 1 Streaming 2 AT command first and then Fastboot 3 Firehose The default value is 3. If method 3 is not supported by the module, then the default value will be 0. More details about the upgrading methods are provided in Chapter 4. Vendor ID and Product ID. The parameter is necessary in some firmware versions with different s. The size of the transport block in unit of KB, and the default value is 1024. Optional Verbose. 7 -h Optional Help message. LTE&LTE-A_QFlash_Linux&Android_User_Guide 7 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 4 Upgrade Firmware through QFlash This chapter mainly introduces how to use the QFlash to upgrade firmware on Linux and Android systems. The firmware can be upgraded via the following ports:  DM port  AT port  Modem port virtualized from USB driver  UART port There are four methods to upgrade the firmware, and the details are provided in the following chapters. NOTE Due to the complex operating environment on Linux and Android systems, sometimes customers have to compile source codes under their own development environment to generate the QFlash tool. In this case, customers need to contact Quectel Technical Support to apply for the source codes to run the QFlash. 4.1. Upgrade Firmware by Method 0 (Sahara + Fastboot) 1. Run QFlash by the following command: ./QFlash -f –m 0 2. Then the upgrading process will be shown as below: LTE&LTE-A_QFlash_Linux&Android_User_Guide 8 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide Figure 1: Upgrading Process (Method 0) 3. If the prompt in the following red box shows up, then the firmware is upgraded successfully. Figure 2: Firmware is Upgraded Successfully (Method 0) LTE&LTE-A_QFlash_Linux&Android_User_Guide 9 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 4.2. Upgrade Firmware by Method 1 (Streaming) This method may take much more time than other methods. 1. Run QFlash by the following command: ./QFlash –f –m 1 2. Then the upgrading process will be shown as below: Figure 3: Upgrading Process (Method 1) 3. If the prompt in the following red box shows up, then the firmware is upgraded successfully. Figure 4: Firmware is Upgraded Successfully (Method 1) LTE&LTE-A_QFlash_Linux&Android_User_Guide 10 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 4.3. Upgrade Firmware by Method 2 (AT Command + Fastboot) Method 2 also uses Fastboot method to upgrade firmware. The difference between Method 0 and Method 2 is that the former uses Sahara first to get needed firmware package, while the latter uses AT+QFASTBOOT command to enter Fastboot mode first before upgrading. 1. Run QFlash by the following command: ./QFlash –f –m 2 2. Then the upgrading process will be shown as below: Figure 5: Upgrading Process (Method 2) LTE&LTE-A_QFlash_Linux&Android_User_Guide 11 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 3. If the prompt in the following red box shows up, then the firmware is upgraded successfully. Figure 6: Firmware is Upgraded Successfully (Method 2) 4.4. Upgrade Firmware by Method 3 (Firehose) This method cannot be operated in virtual environment. If this method is intended to be used, then it is necessary to remove qcserial module or remove ‘05c6:9008’ in qcserial module source code. 1. Run QFlash by the following command: ./QFlash –f –m 3 2. Then the upgrading process will be shown as below: Figure 7: Upgrading Process (Method 3) LTE&LTE-A_QFlash_Linux&Android_User_Guide 12 / 13 LTE/LTE-A Module Series LTE&LTE-A QFlash Linux&Android User Guide 3. If the prompt in the following red box shows up, then the firmware is upgraded successfully. Figure 8: Firmware is Upgraded Successfully (Method 3) LTE&LTE-A_QFlash_Linux&Android_User_Guide 13 / 13

WCDMA UGxx DownloadTool Linux User Guide UMTS/HSPA Module Series Rev. WCDMA_UGxx_DownloadTool_Linux_User_Guide_V1.2 Date: 2015-04-01 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 1 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide About the Document History Revision 1.0 1.1 1.2 Date 2014-08-01 l 2015-03-04 CQouneficdteential 2015-04-01 Author Arno WANG Arno WANG Arno WANG Description Initial Changed the document name from 'UG95' to 'UGxx'. Updated applicable modules. WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 2 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Figure Index ................................................................................................................................................. 4 1 Introduction .......................................................................................................................................... 5 2 Tool Package ........................................................................................................................................ 6 2.1. File List .................................................................................................................................... 6 3 Parameters of DownloadTool ............................................................................................................. 7 4 How to Use the Tool ............................................................................................................................ 8 4.1. Run DownloadTool .................................................................................................................. 8 4.2. Uninstall cdc-acm Driver ......................................................................................................... 8 CQouneficdteenl tial 4.3. Operating Procedure...............................................................................................................9 WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 3 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide Figure Index FIGURE 1: RUN PROGRAM............................................................................................................................... 9 FIGURE 2: SYNCHRONIZE DEVICE ................................................................................................................. 9 FIGURE 3: DOWNLOAD 'PSI.FLS' FILES ....................................................................................................... 10 FIGURE 4: DOWNLOAD 'SLB.FLS' FILES ...................................................................................................... 10 FIGURE 5: DOWNLOAD 'AENEAS.FLS' FILES .............................................................................................. 10 FIGURE 6: DOWNLOAD 'MOD_6255.FLS' FILES ...........................................................................................11 FIGURE 7: DOWNLOAD SUCCESSFULLY ......................................................................................................11 CQouneficdteenl tial WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 4 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide 1 Introduction This document mainly introduces how to use 'DownloadTool' tool to upgrade the module’s firmware in Linux system. This document is applicable to UGxx modules. CQouneficdteenl tial WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 5 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide 2 Tool Package The tool package includes an executable file and a dynamic-link library file. 2.1. File List The files in tool package are shown as below:  DownloadTool l  libDownloadTool.so te NOTE c l The 'DownloadTool' will run as soon as it finds the required libraries. For example, if the libraries and the ue tia executable file './DownloadTool –library=./libDownloadTool.so' are located in the same folder, the tool will CQonfiden run. WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 6 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide 3 Parameters of DownloadTool DownloadTool program can specify the operating parameters in the command line, and the detailed parameters are illustrated as below: Table 1: Description of Command Parameters Number 1 2 3 4 Parameter Optional/ Non-optional l --trace-file Optional cte l --library Optional ue tia -- baudrate Optional CQonfiden --sys-version Optional Description When a downloading goes wrong and you need help from an Intel Mobile Communications (IMC) supporter, please provide this option and an argument. This will save a trace log for IMC team to examine. The default value is trace.log. An alternative library used to download, and it can be specified in this argument. If the application is not located in the library, this option might be useful. This argument determines the baudrate to be used during the downloading process. The maximum baudrate is 921600. In most 'fls' files, the code section has a structure telling which versions to be used to regenerate the entire system. WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 7 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide 4 How to Use the Tool This chapter mainly introduces the procedure of upgrading the module firmware by DownloadTool through the USB port. Before using DownloadTool, please ensure that USB driver of the module has been installed successfully in your system first. NOTE You must get the permission from Quectel technical support to run DownloadTool. ctel l 4.1. Run DownloadTool ue tia If you don't provide the right arguments to the DownloadTool application, you will see the following information: Q n Usage:DownloadTool [options] fide This means that you must provide file(s) to download. n 4.2. Uninstall cdc-acm Driver Co Each time when you run the DownloadTool, you have to uninstall cdc-acm driver first, otherwise downloading will be failed. You can uninstall the driver by the following command: sudo rmmod cdc-acm WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 8 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide 4.3. Operating Procedure Put the DownloadTool and files need to be upgraded into a directory of the HOST. For example, the current directory is 'workplace', and files include 'psi.fls', 'slb.fls', 'AENEAS_FW.fls' and 'MOD_6255.fls', you should move them to the 'workplace' directory first, and then run 'DownloadTool' tool. cd workspace ./DownloadTool --library=./libDownloadTool.so AENEAS_FW.fls MOD_6255.fls psi.fls slb.fls The following figures show the entire upgrading process: uectel tial Figure 1: Run Program Q en NOTE Confid When the DownloadTool has run, please reboot your module. Figure 2: Synchronize Device WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 9 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide Figure 3: Download 'psi.fls' Files CQouneficdteenl tial Figure4:Download'slb.fls'Files Figure 5: Download 'AENEAS.fls' Files WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 10 / 11 UMTS/HSPA Module Series WCDMA UGxx DownloadTool Linux User Guide Figure 6: Download 'MOD_6255.fls' FIles CQouneficdteenl tial Figure7:DownloadSuccessfully WCDMA_UGxx_DownloadTool_Linux_User_Guide Confidential / Released 11 / 11

GNSS 天线应用指导 GNSS 模块系列 版本：1.0 日期：2024-03-28 状态：受控文件 GNSS 天线应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上 提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 48 GNSS 天线应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 48 GNSS 天线应用指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 请确保产品的使用符合国家和行业基础标准、安全标准和环境保护标准的要求，并 符合国家和特定场所对产品使用的具体规定。 请确保终端产品远离易燃易爆品。在极端供电和任何有潜在爆炸危险的（如靠近加 油站、油库、化工厂或爆炸作业场所）环境下使用电子产品可能存在安全隐患。 必须为产品提供稳定可靠的电源，并确保所有接线符合相关安全和防火法规。 在产品安装和使用过程中，必须小心处理以避免因为静电而对产品造成损坏。 上海移远通信技术股份有限公司 3 / 48 关于文档 文档信息 标题 副标题 文档类型 文档状态 GNSS 天线应用指导 GNSS 模块系列 应用指导 受控文件 修订历史 版本 1.0 日期 描述 2023-06-21 文档创建 2024-03-28 受控版本 GNSS 天线应用指导 上海移远通信技术股份有限公司 4 / 48 GNSS 天线应用指导 目录 安全须知 ........................................................................................................................................................ 3 关于文档 ........................................................................................................................................................ 4 目录 ............................................................................................................................................................... 5 表格索引 ........................................................................................................................................................ 7 图片索引 ........................................................................................................................................................ 8 1 介绍 ........................................................................................................................................................ 9 2 GNSS 天线基础知识 ............................................................................................................................ 10 2.1. 无源天线和有源天线 ................................................................................................................ 10 2.2. GNSS 天线主要参数................................................................................................................ 12 2.2.1. 工作频段 ......................................................................................................................... 12 2.2.2. 总辐射效率 ..................................................................................................................... 12 2.2.3. 增益 ................................................................................................................................ 13 2.2.4. 方向图和波瓣宽度 .......................................................................................................... 13 2.2.5. 极化和轴比 ..................................................................................................................... 13 2.2.6. 相位中心稳定性 .............................................................................................................. 14 2.3. 天线类型和特点 ....................................................................................................................... 14 2.3.1. 陶瓷 Patch 天线.............................................................................................................. 14 2.3.2. 螺旋天线 ......................................................................................................................... 16 2.3.3. Chip 天线........................................................................................................................ 17 2.3.4. 平面倒 F 天线 ................................................................................................................. 18 3 选择适合实际应用场景的最佳天线....................................................................................................... 19 3.1. 有源天线或无源天线 ................................................................................................................ 19 3.2. 陶瓷 Patch 天线或螺旋天线..................................................................................................... 19 3.3. Chip 天线或平面倒 F 天线 ....................................................................................................... 19 3.4. RTK 应用中天线性能指标建议 ................................................................................................ 20 4 天线设计注意事项 ................................................................................................................................ 21 4.1. 有源天线和无源天线的电路设计要求 ...................................................................................... 21 4.2. 陶瓷 Patch 天线 ....................................................................................................................... 21 4.2.1. 地平面............................................................................................................................. 21 4.2.2. PCB 上的天线位置 ......................................................................................................... 23 4.2.3. 天线朝向和周围环境....................................................................................................... 24 4.2.4. 陶瓷 Patch 天线馈点....................................................................................................... 24 4.3. 螺旋天线 .................................................................................................................................. 25 4.4. Chip 天线和平面倒 F 天线 ....................................................................................................... 26 4.5. 天线匹配和 ESD 问题.............................................................................................................. 28 4.6. 双天线系统 .............................................................................................................................. 28 5 干扰 ...................................................................................................................................................... 30 5.1. 干扰源...................................................................................................................................... 30 5.2. 常见的干扰器件和电路 ............................................................................................................ 30 上海移远通信技术股份有限公司 5 / 48 GNSS 天线应用指导 5.3. 无线通信系统共存应用 ............................................................................................................ 32 5.3.1. 带内干扰 ......................................................................................................................... 32 5.3.2. 带外干扰 ......................................................................................................................... 33 5.3.3. 抗干扰设计 ..................................................................................................................... 34 6 天线放置和固定 .................................................................................................................................... 35 6.1. 天线放置 .................................................................................................................................. 35 6.2. 天线固定 .................................................................................................................................. 37 7 移远通信天线型号推荐 ......................................................................................................................... 38 7.1. 内置陶瓷天线 ........................................................................................................................... 38 7.2. 带有连接线的无源陶瓷天线 ..................................................................................................... 40 7.3. 带有连接线的有源陶瓷天线 ..................................................................................................... 42 7.4. 外部有源天线 ........................................................................................................................... 44 7.5. 其他天线 .................................................................................................................................. 45 8 附录 术语缩写...................................................................................................................................... 47 上海移远通信技术股份有限公司 6 / 48 GNSS 天线应用指导 表格索引 表 1：GNSS 频段和中心频率（单位：MHz） ........................................................................................... 12 表 2：RTK 应用中天线性能指标建议 ......................................................................................................... 20 表 3：互调失真产物（IMD）...................................................................................................................... 33 表 4：内置陶瓷天线.................................................................................................................................... 39 表 5：带有连接线的无源陶瓷天线.............................................................................................................. 41 表 6：带有连接线的有源陶瓷天线.............................................................................................................. 42 表 7：外部有源天线.................................................................................................................................... 44 表 8：其他天线 ........................................................................................................................................... 45 表 9：术语缩写 ........................................................................................................................................... 47 上海移远通信技术股份有限公司 7 / 48 GNSS 天线应用指导 图片索引 图 1：无源天线和有源天线的内部架构 ...................................................................................................... 10 图 2：支持 L5 频段的 Chip 天线辐射方向图............................................................................................... 13 图 3：物理中心和相位中心......................................................................................................................... 14 图 4：陶瓷 Patch 天线的 2D 方向图........................................................................................................... 15 图 5：陶瓷 Patch 天线的 3D 方向图........................................................................................................... 15 图 6：GNSS 四臂螺旋天线 ........................................................................................................................ 16 图 7：螺旋天线的 2D 方向图...................................................................................................................... 16 图 8：螺旋天线的 3D 方向图...................................................................................................................... 17 图 9：Chip 天线.......................................................................................................................................... 17 图 10：PIFA 天线的典型结构 ..................................................................................................................... 18 图 11：30 mm × 30 mm 地平面上的陶瓷 Patch 天线 ................................................................................ 22 图 12：不同地平面尺寸下天线的中心频率................................................................................................. 22 图 13：不同地平面尺寸下天线的增益 ........................................................................................................ 23 图 14：不同天线位置（A、B 和 C）.......................................................................................................... 23 图 15：天线与高金属器件之间的推荐距离................................................................................................. 24 图 16：自由空间中的螺旋天线轴比............................................................................................................ 25 图 17：放置在 30 cm × 30 cm 金属板上的螺旋天线轴比........................................................................... 26 图 18：Chip 天线 YC0013AA 的参考 PCB 设计（单位：mm） ................................................................ 27 图 19：天线参考设计.................................................................................................................................. 28 图 20：双天线系统 ..................................................................................................................................... 29 图 21：干扰信号走线的屏蔽....................................................................................................................... 31 图 22：GND 设计 ....................................................................................................................................... 31 图 23：电容和工作温度 .............................................................................................................................. 32 图 24：GPS L1 带内干扰频谱 .................................................................................................................... 33 图 25：GPS L1 带外干扰频谱 .................................................................................................................... 34 图 26：干扰源及其路径 .............................................................................................................................. 34 图 27：建筑物屋顶场的天线位置 ............................................................................................................... 35 图 28：汽车应用中的天线位置 ................................................................................................................... 36 图 29：两轮车应用中的天线位置 ............................................................................................................... 37 图 30：用于天线固定的硅胶推荐 ............................................................................................................... 37 图 31：内置陶瓷天线.................................................................................................................................. 38 图 32：带有连接线的无源陶瓷天线............................................................................................................ 40 图 33：带有连接线的有源陶瓷天线............................................................................................................ 42 图 34：外部有源天线.................................................................................................................................. 44 图 35：其他天线 ......................................................................................................................................... 45 上海移远通信技术股份有限公司 8 / 48 GNSS 天线应用指导 1 介绍 移远通信 GNSS 模块被广泛应用于全球各类行业的众多产品中。由于不同产品的应用场景不同，因此 需要根据实际的应用场景来评估 GNSS 天线的选型和应用。本文档主要介绍 GNSS 天线的基础知识、天线 放置和固定以及移远通信天线型号推荐。另外，本文档在针对新项目设计时，也提出了一些 GNSS 天线选 型和应用方面需要考虑的因素。 上海移远通信技术股份有限公司 9 / 48 GNSS 天线应用指导 2 GNSS 天线基础知识 因 GNSS 信号到达地球表面时，信号强度会非常微弱，通常会低于 GNSS 接收机的热噪声基底，因此， 天线在 GNSS 系统中发挥着重要的作用。合适且性能良好的 GNSS 天线可以提供良好的载噪比（C/N0）并 能接收更多的卫星。 2.1. 无源天线和有源天线 无源天线通常只包含辐射单元，在无供电的情况下可以正常工作。有源天线增加了 LNA、SAW 滤波器 和其他器件，如焊接在无源辐射单元馈点附近的同向双工器。LNA（低噪声放大器）需要供电才能正常工 作，一般是通过同轴射频线内芯路径为 LNA 供电。LNA 可以降低整个系统的总噪声系数，以获得更好的 C/N0 和灵敏度，特别是在天线和模块之间的损耗较大的情况下。 下图为无源天线和有源天线内部架构的示例。 Passive Antenna Active Antenna RF/OUT Single-band Passive Antenna L1 Antenna L5 Antenna SAW Diplexer RF/OUT Dual-band Passive Antenna SAW Filter LNA RF/OUT Single-band Active Antenna with Front SAW L1 Antenna L5 Antenna SAW Filter LNA SAW Filter LNA SAW Diplexer Dual-band Active Antenna with Front SAW RF/OUT 图 1：无源天线和有源天线的内部架构 上海移远通信技术股份有限公司 10 / 48 GNSS 天线应用指导 C/N0 是 GNSS 接收机的重要性能指标，其定义为：在 1 Hz 带宽内接收调制载波信号功率与接收噪声 功率的比值。 C/N0 的计算公式如下： 'Power of GNSS signal'是指 GNSS 信号强度。在实际环境中，到达地表的 GNSS 信号强度约为 -130 dBm。'Thermal Noise'指热噪声的功率谱密度，和环境温度有关，常温下（290 K）对应的热噪声 约为-174 dBm/Hz。'System NF'指系统噪声系数。为了提高 GNSS 信号的 C/N0，可以增加一个 LNA 来减少系统的噪声系数。 系统噪声系数是系统噪声因子 F 的 dB 形式： 系统级联噪声公式如下： 上式中，'F1'是第一级噪声，'G1'是第一级增益，'F2'是第二级噪声，'G2'是第二级增益。 该公式表明，LNA 的增益可以补偿 LNA 链路后面的噪声系数。在这种情况下，'系统 NF'主要取决于第 一级 LNA 之前由各器件和走线的插损引起的噪声，以及 LNA 自身的噪声。这就解释了天线馈线过长、插损 过大时需要使用有源天线的原因：有源天线的 LNA 可以减少 C/N0 的下降。 然而，增益过大可能导致 LNA 饱和或者系统的灵敏度恶化。需要注意的是，不同的模块有不同的总增 益要求，因此在使用有源天线时，可以按照硬件设计手册中给出的具体要求进行设计。整个天线的总增益 等于内部 LNA 增益减去天线内部电缆和组件的总插入损耗。有源天线内部 LNA 的供电需求，会增加系统的 功耗；另外，还需注意天线的工作电压范围。 为了提高抗干扰能力，大多数有源天线内部有声表面波滤波器（SAW），以阻挡带外的强信号，如 LTE 传输的信号。另一方面，在复杂的通信系统中，LNA 很容易产生带内互调信号，建议在 LNA 之前使用 SAW 滤波器以减小带外信号的功率，从而降低互调产物的功率，这有助于减轻干扰并保持整体信号质量。 上海移远通信技术股份有限公司 11 / 48 GNSS 天线应用指导 2.2. GNSS 天线主要参数 天线的主要参数包括工作频段、总辐射效率、增益、辐射方向图、轴比、波瓣宽度和相位中心稳定性。 硬件设计手册中会列出相关参数的推荐值，但不是强制要求。实际应用时需要通过实际测试来确定天线是 否满足需求。 2.2.1. 工作频段 通常将天线的工作频率定义为驻波比小于 2.5 时对应的频率范围。GNSS 天线必须在所需的 GNSS 频 段范围内工作。下表列出了部分 GNSS 星系对应的频段和中心频率。 表 1：GNSS 频段和中心频率（单位：MHz） 星系 GNSS 频段和中心频率（单位：MHz） GPS L1: 1575.42 L2C: 1227.6 L5: 1176.45 - - - GLONASS L1: 1602 L2: 1246 L3: 1202.025 - - - Galileo E1: 1575.42 E5a: 1176.45 E5b: 1207.14 E6: 1278.75 - - BDS B1I: 1561.098 B1C: 1575.42 B2a: 1176.45 B2b: 1207.14 B2I: 1207.14 B3I: 1268.52 QZSS L1: 1575.42 L2C: 1227.6 L5: 1176.45 L6: 1278.75 - - NavIC L5: 1176.45 - - - - - L band 1525–1559 - - - - - 2.2.2. 总辐射效率 辐射效率是指天线辐射的总功率与天线接收的净功率之比。当能量馈送到天线连接器时，由于阻抗失 配，一些能量会被反射和损失。总辐射效率是指天线辐射的总功率与馈送到天线连接器功率之比。例如， 如果馈送到天线连接器的功率为 100，在天线连接器处反射的功率是 10，最终辐射功率为 50。那么，净功 率是 90，辐射效率为 50 / 90，总辐射效率为 50 / 100。 总辐射效率是用标准微波暗室测试的，并受辐射贴片的结构和材料、接地面的大小以及周围环境等因 素的影响。这些因素很复杂，需要由天线厂家进行评估。 天线总辐射效率会影响接收机的 C/N0 值，从而影响接收机的定位精度。通常，对于支持 GNSS 星系 L1 频段的陶瓷 Patch 天线来说，天线尺寸为 25 mm ×25 mm 时，天线总辐射效率可以轻松超过 60 %，尺 寸为 18 mm × 18 mm 时，天线总辐射效率可以轻松超过 40 %。 上海移远通信技术股份有限公司 12 / 48 GNSS 天线应用指导 2.2.3. 增益 无源天线的增益是该天线在特定方向上实际产生的辐射强度与理想的各向同性辐射天线的辐射强度之 比。无源天线的增益可以用来衡量天线在特定方向上发送和接收信号的能力。天线的增益会影响接收机的 C/N0 值。 无源天线的增益参数可以用单位 dBi 和 dBd 表示。这两种单位的参考标准不同，前者是基于理想的全 向点源天线作为参考标准，后者是基于偶极子天线作为参考标准，通常情况下，0 dBd = 2.15 dBi。 有源天线的增益包括内部 LNA 的增益。LNA 的增益是指输出功率与输入功率之比，一般用对数表示， 单位为 dB。 2.2.4. 方向图和波瓣宽度 GNSS 天线应具有低水平的方向性，以覆盖天空中尽可能多的卫星。下图为支持 L5 频段 Chip 天线的 辐射方向图。全向方向图可以提供更好的健壮性。 图 2：支持 L5 频段的 Chip 天线辐射方向图 波瓣宽度是天线辐射方向图的参数之一。我们一般使用半功率波瓣宽度（HPBW）来表示定向天线、 陶瓷 Patch 天线等可以接收不同仰角卫星信号的能力。半功率波瓣宽度是指辐射方向图的辐射强度从主波 瓣的峰值下降到 50 %（3 dB）时所形成的夹角。通常，建议 HPBW 在 90°到 120°之间。波瓣宽度过大可 能会导致多径抑制性能的恶化。天线的辐射方向图和波瓣宽度均会影响接收机可视卫星的数量，从而影响 定位精度。 2.2.5. 极化和轴比 GNSS 信号都是右旋圆极化的。对于线极化天线，在接收 GNSS 信号时，由于极化损耗，会产生约 3 dB 的衰减。 上海移远通信技术股份有限公司 13 / 48 GNSS 天线应用指导 轴比是用来表示天线圆极化纯度的参数。对于圆极化天线，轴比随仰角的变化而变化。通常，在天顶 方向的轴比可小于 1 dB，但是在低仰角区域很难保持良好的轴比。因此，建议在工作带宽范围内，天顶的 轴比要小于 3 dB。天线的轴比会影响接收机的 C/N0 值。 右旋圆极化天线只能接收右旋圆极化波，不能接收左旋圆极化波。当右旋圆极化波入射到对称的目标 上时，例如平面、球体，反射波将变成左旋圆极化波。根据该特性，使用右旋圆极化天线可以抑制多径效 应。 2.2.6. 相位中心稳定性 天线的相位中心稳定性会影响接收机的定位精度。当要求到高精度定位时，例如厘米级定位，相位中 心稳定性是关键因素。 天线所辐射出的电磁波在远离天线一定的距离后，其等相位面会近似为一个球面，该球面的球心即为 该天线的相位中心。天线的相位中心被视为所有电磁波汇聚或发射的几何点。在 GNSS 测量过程中，所得 到的位置观测值都是以 GNSS 天线的相位中心位置为准的。相位中心通常不在物理意义上的中心位置。因 此，这个微小的误差可能会影响最终的定位精度。 下图显示了相位中心偏移和相位中心变化。对于要求厘米级定位的应用，相位中心偏移和相位中心变 化应小于20 mm。 图 3：物理中心和相位中心 2.3. 天线类型和特点 2.3.1. 陶瓷 Patch 天线 由于良好的 RHCP 性能、较高的总辐射效率和较低的成本，陶瓷 Patch 天线是 GNSS 应用中最常用的 天线类型。 上海移远通信技术股份有限公司 14 / 48 GNSS 天线应用指导 下图分别为陶瓷 Patch 天线 2D 和 3D 的辐射方向图，该天线向上的正方向的增益最大，反向辐射很弱。 图 4：陶瓷 Patch 天线的 2D 方向图 图 5：陶瓷 Patch 天线的 3D 方向图 陶瓷 Patch 天线的性能与天线尺寸和地平面大小密切相关。对于 70 mm × 70 mm 的地平面，尺寸为 25 mm × 25 mm × 4 mm 的陶瓷天线，总辐射效率可轻松达到 70 %。 陶瓷Patch天线有着各种尺寸，从10 mm × 10 mm到36 mm × 36 mm不等。因此，此类天线易于集成 到各类GNSS设备中。但为了保证天线性能，不建议使用小于18 mm × 18 mm的陶瓷Patch天线。 上海移远通信技术股份有限公司 15 / 48 GNSS 天线应用指导 2.3.2. 螺旋天线 螺旋天线是由一根或多根导线绕成螺旋形状的天线，最常见的类型是四臂螺旋天线。与陶瓷 Patch 天 线相比，螺旋天线具有更好的半功率波瓣宽度（HPBW）。如果螺旋体内部填充的是空气，则每根导线的 长度应等于信号波长的四分之一或者等于其整数倍。在高介电常数的陶瓷基板上印刷螺旋臂可以减小天线 的尺寸。 图 6：GNSS 四臂螺旋天线 下图分别为螺旋天线 2D 和 3D 的辐射方向图，该类天线具有很好的半功率波瓣宽度（HPBW），向上 的正方向的增益最大，反向辐射很弱。 图 7：螺旋天线的 2D 方向图 上海移远通信技术股份有限公司 16 / 48 GNSS 天线应用指导 图 8：螺旋天线的 3D 方向图 2.3.3. Chip 天线 由于 Chip 天线的尺寸非常小，可以在空间有限的情况下使用。Chip 天线下图所示。 图 9：Chip 天线 Chip 天线需要在 PCB 上面净空，便于充分优化，从而获得更好的带宽和总辐射效率。但其线性极化特 性使其在接收 GNSS 信号时会产生极化损耗。同时，Chip 天线对在 PCB 上 SMD 的位置、净空区域的尺 寸以及周围环境都有严格的要求。通常，天线制造商会评估和优化 PCB 整个设备结构，以防止频率偏移和 干扰。当设备的电路板空间有限时，尺寸极小的 Chip 天线是一个好的选择。 上海移远通信技术股份有限公司 17 / 48 GNSS 天线应用指导 2.3.4. 平面倒 F 天线 下图是平面倒 F 天线（PIFA 天线）的典型结构，整个天线的右视图像个倒写的英文字母 F。由于平面 倒 F 天线易集成到小型设备中，因此通常用于手持设备。PIFA 天线的带宽比 Chip 天线更宽，且具有全向 方向图。从顶部贴片位置到地平面的距离往往是限制 PIFA 天线性能的因素。 图 10：PIFA 天线的典型结构 当设备电路板上没有足够空间放置天线时，可以使用安装在塑料外壳上的 PIFA 天线。但其线性极化特 性使其在接收 RHCP GNSS 信号时会造成极化损耗。在使用 PIFA 天线时，由于对周围环境过于敏感，天 线厂家必须进行充分的评估，从而达到最佳的性能。 上海移远通信技术股份有限公司 18 / 48 GNSS 天线应用指导 3 选择适合实际应用场景的最佳天线 3.1. 有源天线或无源天线 当天线和模块之间的射频线较长，比如在射频线长度大于 1 m 或者损耗大于 1 dB 的应用场景，建议使 用有源天线。另外，有源天线也经常用于 LG69T 系列等噪声系数较高的模块。对于 LNA 放置在第一级的 模块，例如 LC79H，采用有源天线时的 C/N0 不一定优于采用无源天线时的 C/N0。 3.2. 陶瓷 Patch 天线或螺旋天线 当天线要求安装在平面上时，建议选用陶瓷 Patch 天线，它可以在保证良好的增益、总辐射效率和轴 比的前提下实现小尺寸和低成本要求。在使用陶瓷 Patch 天线时，为了接收尽可能多的卫星，天线正面必 须指向天空，但因此，陶瓷 Patch 天线很难在手持设备上使用。陶瓷 Patch 天线的性能与天线尺寸和地平 面大小密切相关。 螺旋天线具有良好的轴比，在无地平面的情况下，在水平方向上具有全向的辐射方向图。因此，虽然 螺旋天线通常比陶瓷 Patch 天线高度更高、价格更昂贵，但在不能提供地平面的工作环境中，螺旋天线可 以提供良好且稳定的接收性能。综上，螺旋天线更加适合无地平面的应用场景；但需要注意，当螺旋天线 安装在金属表面时，其轴比会恶化。 3.3. Chip 天线或平面倒 F 天线 Chip 天线和平面倒 F 天线可以使用在一些特定的应用场景中，比如可穿戴设备、手机等。这些设备通 常内部空间通常十分有限，且需要全向方向图。 当设备的电路板空间有限时，尺寸极小的 Chip 天线是不错的选择。若当设备电路板上没有足够的空间 放置天线时，则可以考虑使用能够安装在塑料外壳上的平面倒 F 天线，但这两类天线的线极化特性在接收 RHCP GNSS 信号时会造成极化损耗。此外，Chip 天线或平面倒 F 天线对周围环境十分敏感；因此，在使 用这两种天线时，天线制造商必须进行充分评估，以达到最佳性能。 上海移远通信技术股份有限公司 19 / 48 GNSS 天线应用指导 3.4. RTK 应用中天线性能指标建议 如果是在 RTK 应用场景中，建议天线性能满足以下指标： 表 2：RTK 应用中天线性能指标建议 天线参数 要求 极化 增益 驻波比 轴比 总辐射效率 相位中心偏移 相位中心变化 馈点 1 仰角 90° 仰角 60° 天线尺寸 1 右旋圆极化（RHCP） ≥ 3 dBi（顶点） ≤ 2 ≤ 3 dB ≤ 6 dB > 60 % ≤ 20 mm ≤ 20 mm 双馈或四馈 双层陶瓷片结构： 下层陶瓷片：≥ 35 mm × 35 mm × 4 mm 上层陶瓷片：≥ 25 mm × 25 mm × 4 mm 1 选用陶瓷 Patch 天线时建议满足该指标。 上海移远通信技术股份有限公司 20 / 48 GNSS 天线应用指导 4 天线设计注意事项 设备外壳、内部器件可能会影响天线性能，因此在设计、调试天线时，需要在整机状态下进行。 4.1. 有源天线和无源天线的电路设计要求 根据选用的 GNSS 模块以及具体的应用场景，在确定使用有源天线还是无源天线后，建议遵循以下设 计规则： ⚫ 选用有源天线时，必须使用 SAW 前置于 LNA 的有源天线，不可使用 LNA 在前的有源天线，以降 低带外干扰对 GNSS 模块性能的影响。 ⚫ 选用无源天线时，如果设备工作在复杂的电磁环境下，为了降低带外信号对 GNSS 模块的影响， 应遵循相应的 GNSS 模块硬件设计文档，在天线射频电路的设计中加入带通滤波电路。在实际布 局中，这部分电路应放置在靠近模块 RF_IN 引脚的位置。 ⚫ 选用无源天线但在天线和 GNSS 模块之间增加了 LNA 电路时，必须在 LNA 前面增加带通滤波电 路。 4.2. 陶瓷 Patch 天线 在使用陶瓷 Patch 天线时，需要关注天线的地平面、摆放位置、天线朝向和周围环境，这四个方面都 会影响陶瓷 Patch 天线的性能。请联系天线厂家进行充分评估，以获得最佳性能。 4.2.1. 地平面 地平面的尺寸会影响陶瓷 Patch 天线的中心频率和增益等参数。 下图是一款放在 30 mm × 30 mm 地平面上的陶瓷 Patch 天线，该天线的中心频率是 1575.42 MHz。 上海移远通信技术股份有限公司 21 / 48 GNSS 天线应用指导 图 11：30 mm × 30 mm 地平面上的陶瓷 Patch 天线 在陶瓷天线不变的情况下，随着地平面尺寸的增大，天线的中心频率向更高的频率移动，如下图所示。 图 12：不同地平面尺寸下天线的中心频率 在陶瓷天线不变的情况下，当地平面的尺寸在 30 mm ×30 mm 和 110 mm ×110 mm 之间时，天线的 增益随着地平面尺寸的增大先减小，再增大，再减小，如下图所示。 上海移远通信技术股份有限公司 22 / 48 GNSS 天线应用指导 dBi(Gain) 图 13：不同地平面尺寸下天线的增益 4.2.2. PCB 上的天线位置 天线的摆放位置会影响陶瓷 Patch 天线的驻波比和增益等参数。 常见的摆放位置如下图所示（A：PCB 中心位置；B：PCB 边角位置；C：PCB 边缘中间位置）。 图 14：不同天线位置（A、B 和 C） 对于有些天线来说，放置在位置 A 时，驻波比和增益可以达到最优；但是，有些天线放置在位置 B 或 者位置 C，可以达到最优性能。建议在设计产品时，联系天线厂家进评估和仿真，以选取最佳的摆放位置。 上海移远通信技术股份有限公司 23 / 48 GNSS 天线应用指导 4.2.3. 天线朝向和周围环境 陶瓷 Patch 天线的辐射特性还取决于天线的朝向以及周围的环境，例如，天线附近的金属器件。在设 计中，建议遵循以下规则： ⚫ 确保天线正面指向天空。如果天线倾斜放置，在部分场景下，即使搜星能力和 C/N0 值很好，也可 能因受到多径效应的影响，导致模块的定位精度变差。 ⚫ 保持贴片天线与其他高金属器件的距离至少 10 mm。否则，天线性能会受到影响。 Mother Board 图 15：天线与高金属器件之间的推荐距离 ⚫ 器件外壳应采用非金属材料制作，尤其是天线区域周围的外壳。天线与外壳的最小距离要求为 3 mm。 4.2.4. 陶瓷 Patch 天线馈点 常见的陶瓷天线有单馈、双馈、四馈： ⚫ 单馈陶瓷天线常用作单频天线：仅有一个馈针。 ⚫ 双馈陶瓷天线常用作双频天线：一个馈针连接高频部分，另外一个馈针连接低频部分。 ⚫ 四馈陶瓷天线常用作高精度定位应用场景：两个馈针连接高频部分，另外两个馈针连接低频部分。 四馈陶瓷天线可以获得更好的轴比和相位中心稳定性，从而提高模块的定位精度。 上海移远通信技术股份有限公司 24 / 48 GNSS 天线应用指导 4.3. 螺旋天线 在不能提供地平面的工作环境中，螺旋天线可以提供良好、稳定的接收性能；然而，需要注意，当螺 旋天线安装在金属表面时，其轴比会恶化。对比下面 2 个图可以看出，当螺旋天线放置在 30 cm × 30 cm 的金属板上时，1575 MHz（白线）的轴比明显恶化。 当螺旋天线需要安装在金属平面的上方时，必须严格按照天线厂家的要求设计产品布局。 图 16：自由空间中的螺旋天线轴比 上海移远通信技术股份有限公司 25 / 48 GNSS 天线应用指导 图 17：放置在 30 cm × 30 cm 金属板上的螺旋天线轴比 4.4. Chip 天线和平面倒 F 天线 当产品内部空间十分有限时，Chip 天线和平面倒 F 天线是很好的选择，但这两款天线对在 PCB 上的 摆放位置、净空区域尺寸以及周围环境都有严格的要求。 需要注意的是，当模块的射频输入引脚有电时，由于 PIFA 天线内部存在短路顶针，PIFA 天线不能直 接连接到模块上，必须增加隔直电容。 下图是移远通信的一款 Chip 天线（型号为 YC0013AA），天线规格书中对于电路板尺寸、天线摆放位 置、净空区域尺寸都有明确的要求。 上海移远通信技术股份有限公司 26 / 48 GNSS 天线应用指导 图 18：Chip 天线 YC0013AA 的参考 PCB 设计（单位：mm） 上海移远通信技术股份有限公司 27 / 48 GNSS 天线应用指导 4.5. 天线匹配和 ESD 问题 设计电路板时，需要考虑天线匹配和 ESD 问题，建议按下图进行设计。 Antenna Π Matching Circuit Module R1 RF_IN D1 0R TVS C1 NM C2 NM 图 19：天线参考设计 C1、R1 和 C2 组成预留的 π 型匹配电路，用于优化天线的输入阻抗。默认情况下，R1 为 0 Ω，C1 和 C2 不贴。D1 是一个防静电（ESD）保护装置，用于防止射频信号输入受到 ESD 的干扰。D1 的结电容不 能超过 0.6 pF，推荐使用一个瞬态电压二极管。射频线的阻抗应控制在 50 Ω，且布线尽可能短。 4.6. 双天线系统 由于应用场景的差异，有时一款产品需要支持内置天线和外置有源天线，例如，在空旷环境时，使用 内置天线；在有遮挡物的环境下，使用外置有源天线，通过射频同轴线，将天线放置在信号较好的地方。 此时，两个天线需要实现自动切换的功能，便于安装和使用。 下图是双天线系统实现自动切换天线的功能框图，这里需要使用射频单刀双掷开关（SPDT）来实现射 频链路的选择，以决定 GNSS 信号通过哪一个天线到达 GNSS 模块。 上海移远通信技术股份有限公司 28 / 48 D 1 TVS C1 NM C2 NM External Active Antenna Internal Antenna D2 TVS L1 68nH RF1 RF2 SPDT RF Logic and Supply VControl VDD Active Antenna Detection Short-circuit Detection and Protection Circuit SPDT Control Circuit GNSS 天线应用指导 П Matching Circuit R1 0R Module RF_IN 图 20：双天线系统 当使用双天线系统时，需要注意以下问题： ⚫ 大部分 SPDT 的三个射频信号口是带电的，需要避免短路到地，建议使用隔直电容。 ⚫ 使用 SPDT 时，需要关注规格书中的逻辑控制说明：注意确认当控制引脚为高电平或者低电平时， SPDT 内部分别连接的是哪条射频通路。同时，确认控制引脚高电平和低电平具体的电压范围。 ⚫ 系统中需要设计有源天线短路检测和保护电路，避免损坏 GNSS 模块和设备。 ⚫ 由于天线检测电路需要连接射频通路，为避免增加射频损耗，需要在电路中使用一颗感值至少为 68 nH 的电感，并将电感靠近天线端的焊盘搭在射频线上。 ⚫ 有的模块内部含有天线检测和保护电路，无需外加检测和保护电路，可根据具体模块设计双天线系 统。 上海移远通信技术股份有限公司 29 / 48 GNSS 天线应用指导 5 干扰 由于 GNSS 信号通常非常微弱，GNSS 接收机很容易受到周围环境的干扰。 5.1. 干扰源 在 GNSS 模块实际工作的环境中，主要有以下两种干扰源： ⚫ DC-DC 等供电网络器件、时钟晶体、摄像头电路等常见的干扰器件和电路。 ⚫ 其他无线通信系统传输的射频信号，比如蜂窝通信系统、Wi-Fi、蓝牙。 5.2. 常见的干扰器件和电路 有的电子器件和电路在工作的过程中，很容易产生各个频率的干扰信号，影响 GNSS 模块的性能，在 产品设计初期就需要充分评估，尽可能地规避干扰问题。 在设计过程中，需要关注以下几个方面： ⚫ 尽可能将 DC-DC 转换器、微控制器、晶体、LCM、摄像头等高速器件及接口置于 GNSS 模块和天 线所在母板的反面，并使其尽量远离模块和天线，最好是处于模块和天线的对角位置。 ⚫ 确保干扰信号（来自 USB、LCM、摄像头、晶体等）的走线尽可能短、位于被地平面屏蔽的内层。 相同层或者相邻层的走线避免近距离平行，而且周边使用地孔屏蔽。使走线及其过孔远离模块和天 线。 上海移远通信技术股份有限公司 30 / 48 GNSS 天线应用指导 图 21：干扰信号走线的屏蔽 ⚫ 建议在 DC-DC 转换器的输入和输出端口预留串位和并位，便于使用磁珠和去耦电容优化干扰问题。 ⚫ 如果摄像头等电路使用排线连接主板，建议使用带有屏蔽功能的线缆，避免摄像头电路的干扰信号 通过排线向外辐射。 ⚫ 确保模块的 GND 引脚和 PCB 板的 GND 充分接触，且接地线尽可能短。 下图中的三个黄色引脚是模块的 GND。不推荐使用左侧图的 GND，建议按照右侧图在蓝色部分增加 GND 和地孔。 GND Not Recommended GND Recommended 图 22：GND 设计 ⚫ 使用去耦电容时，需要保证接地点与主地充分接触；也需要关注电容的工作温度区间，由于使用介 电材料的差异，有些系列的电容并不能支持-40 °C，例如下图中的 HG、SL、Z5U、Y5V 等系列就 不能用于-40 °C 的环境。 上海移远通信技术股份有限公司 31 / 48 GNSS 天线应用指导 图 23：电容和工作温度 ⚫ 通过屏蔽罩将干扰信号限制在特定区域内也是一个很好的措施。屏蔽罩上面的孔和槽都会影响屏蔽 性能，甚至可能导致屏蔽罩成为辐射干扰信号的天线；使用屏蔽罩时需要保证屏蔽罩密闭，并且充 分连接到地。 ⚫ 建议将 DC-DC 转换器、微控制器、晶体等常见干扰器件和电路放到屏蔽罩内部。 ⚫ 建议使用洋白铜材质的屏蔽罩，厚度不小于 0.2 mm。 5.3. 无线通信系统共存应用 由于 GNSS 信号通常非常微弱，GNSS 接收机很容易受到周围环境的干扰。根据 3GPP 规范，蜂窝终 端在 GSM 频段最多可以传输 33 dBm 的信号，在 WCDMA 和 LTE 频段大约可以传输 24 dBm 的信号，而 5G 频段最大发射功率可能达到 26 dBm 左右。因此，必须对 GNSS 接收机与其他无线通信系统共存进行优 化，以避免 GNSS 性能严重受损。 在复杂的通信环境中，干扰信号可能来自于带内信号或带外信号。据此，可将干扰分为两种类型：带 内干扰和带外干扰。本章节将详细介绍这两种干扰，并提出降低干扰信号影响、确保 GNSS 接收机抗干扰 能力的建议。 5.3.1. 带内干扰 带内干扰指干扰信号的频率处于 GNSS 工作带宽之内。例如，GPS L1 的中心频点为 1575.42 MHz， 带宽为 2.046 MHz。如下图所示，此时干扰信号的频率处于 GPS 工作带宽之内，且干扰信号的功率高于实 际接收 GPS 信号的功率值。 上海移远通信技术股份有限公司 32 / 48 Power [dBm] 0 GPS operation GPS carrier frequency bands 1575.42 MHz Interference signal GNSS 天线应用指导 -110 1525 1550 1575 1600 1625 Frequency [MHz] 图 24：GPS L1 带内干扰频谱 最常见的带内干扰通常来自于以下因素： ⚫ 由晶体、高速信号线、单片机、开关电源等引起的谐波； ⚫ 不同通信系统的互调。 在与蜂窝通信模块的共存应用中，一些频率的组合会产生互调失真，互调失真产物的频率也有可能落 在 GPS 的工作带宽之内。常见的频率组合如下表所示。表中列出了两种带外信号互调或 LTE Band 13 的 二次谐波可能产生的一些带内干扰。 表 3：互调失真产物（IMD） 信号源 F1 GSM850/Band 5 Band 1 DCS1800/Band 3 PCS1900/Band 2 LTE Band 13 信号源 F2 IM 计算 互调失真产物 Wi-Fi 2.4 GHz F2 (2412 MHz) - F1 (837 MHz) n78 F2 (3500 MHz) - F1 (1925 MHz) PCS1900/Band 2 2 × F1 (1712.6 MHz) - F2 (1850.2 MHz) Wi-Fi 5 GHz F2 (5280 MHz) - 2 × F1 (1852 MHz) - 2 × F1 (786.9 MHz) 2 阶互调（IMD2）= 1575 MHz 2 阶互调（IMD2）= 1575 MHz 3 阶互调（IMD3）= 1575 MHz 3 阶互调（IMD3）= 1576 MHz 2 次谐波（IMD2） = 1573.8 MHz 5.3.2. 带外干扰 带外干扰指干扰信号的频率处于 GNSS 工作带宽之外。其他通信系统传输的强信号流入 GNSS 接收端， 可能会导致 GNSS 接收机饱和，从而使其性能大大下降，如下图所示。在实际应用中，常见的强干扰信号 来源于无线通信模块，例如，GSM、3G、LTE、5G、Wi-Fi、蓝牙等。 上海移远通信技术股份有限公司 33 / 48 GNSS 天线应用指导 Power [dBm] 0 -110 GSM850 GSM900 GPS carrier frequency 1575.42 MHz DCS1800 PCS1900 GPS 带宽 Wi-Fi 2.4 GHz 0 500 1000 2000 2500 图 25：GPS L1 带外干扰频谱 Frequency [MHz] 5.3.3. 抗干扰设计 可采用以下几种方式来减少干扰信号的影响，从而确保 GNSS 接收机的抗干扰能力： ⚫ 使 GNSS 天线远离干扰源； ⚫ 在 GNSS 模块前添加一个带通滤波器； ⚫ 采用屏蔽罩和多层板，确保充分接地； ⚫ 优化 PCB 和整个设备的摆件和布局。 下图说明了干扰源及其可能的干扰路径。在复杂的通信系统中，干扰源通常有射频功率放大器、单片 机、晶体等。这些设备应该远离 GNSS 接收机或 GNSS 模块。特别是对于功率放大器，应采用屏蔽，以防 止强信号干扰。蜂窝天线应远离 GNSS 接收天线放置，以保证足够的隔离（一般建议隔离度至少为 20 dB）。 以 DCS1800 为例，DCS1800 的最大传输功率约为 30 dBm。经过 20 dB 的衰减后，GNSS 天线接收到的 信号将在 10 dBm 左右，这对于 GNSS 模块来说仍然过高。为消除干扰，可在 GNSS 模块前添加一个抑制 能力约 40 dB 的 GNSS 带通滤波器，将带外信号衰减到-30 dBm。 10 dBm Isolation = 20 dB Rejection = 40 dB DCS1800 30 dBm Shielding -30 dBm GNSS Receiver RCFelPluolwaerr Amplifier MCU Crystal 上海移远通信技术股份有限公司 图 26：干扰源及其路径 34 / 48 GNSS 天线应用指导 6 天线放置和固定 6.1. 天线放置 天线安装的周围环境会影响天线的接收性能和可见卫星，从而影响 GNSS 接收机的定位精度。可以通 过调整天线的位置和朝向来获取更多可见卫星。例如，选择远离障碍物和干扰的位置，将陶瓷 Patch 天线 水平放置，保持辐射面朝向天空。 如果将 GNSS 天线放置在建筑物的屋顶，如下图所示，那么图中位置 1 是理想的放置位置。如果天线 不能放置在位置 1，也可放置于位置 2，但可见卫星和信号强度会受到影响，从而影响接收机的性能。不推 荐将天线放置在位置 3。 Position 1: Ideal position 1 Position 2: Alternative position Probably affects the satellite visibility and signal strength 2 Position 3: Not recommended 3 图 27：建筑物屋顶场的天线位置 上海移远通信技术股份有限公司 35 / 48 GNSS 天线应用指导 在汽车应用中，下图中的位置 1 和位置 2 是 GNSS 天线的理想放置位置。如果天线不能放置在位置 1 或位置 2，也可放置在车顶和玻璃下方的位置 3 或位置 4，但可见卫星和信号强度会受到影响，并且玻璃上 不得使用含有金属材质的保护膜，否则 GNSS 信号接收会受到干扰。 Positions 1 and 2: Ideal positions 1 2 Positions 3 and 4: Alternative positions Probably affects the satellite visibility and signal strength 4 3 图 28：汽车应用中的天线位置 在两轮滑板车和两轮电动车的应用场景中，下图中的位置 1 是理想放置位置。如果天线不能放置在位 置 1，也可放置于位置 2 和位置 3，但可见卫星和信号强度会受到影响。 上海移远通信技术股份有限公司 36 / 48 Position 1: Ideal position 1 GNSS 天线应用指导 Positions 2 and 3: Alternative positions Probably affects the satellite visibility and signal strength 2 3 图 29：两轮车应用中的天线位置 6.2. 天线固定 在某些应用场景下，为了防止天线因剧烈振动而脱落，需要在陶瓷天线周围涂上硅胶，以提高可靠性。 推荐使用品牌 Kafuter，型号为 K704 的硅胶。 图 30：用于天线固定的硅胶推荐 上海移远通信技术股份有限公司 37 / 48 GNSS 天线应用指导 7 移远通信天线型号推荐 需要注意的是，不同的模块有不同的要求，可以按照硬件设计文档中的具体要求进行选型。另外，移 远通信可以提供各种类型和尺寸的 GNSS 天线，也可以根据需求提供定制服务。如果有任何疑问，请联系 移远通信技术支持（support@quectel.com）。 可根据需求从以下型号中选择合适的天线。 7.1. 内置陶瓷天线 • YFGC010WWA • 10 × 10 × 4 mm • YFGC015WWA • 15 × 15 × 4 mm • YFGC018WWA • 18 × 18 × 4 mm • YFGC025WWC • 25 × 25 × 4 mm Better • YFGC035WWA • 35 × 35 × 4 mm • YFGC225WWA • 25 × 25 × 4 mm + 18 × 18 × 4 mm • YFGC233WWA • 33 × 33 × 4 mm + 25 × 25 × 4 mm • YFGC235WWA • 35 × 35 × 6 mm + 28 × 28 × 4 mm • YFGC238WWA • 38 × 38 × 6 mm + 28 × 28 × 4 mm • YFGC245WWB • 45 × 45 × 8 mm + 40 × 40 × 4 mm 图 31：内置陶瓷天线 上海移远通信技术股份有限公司 38 / 48 表 4：内置陶瓷天线 天线型号 YFGC010WWA YFGC015WWA YFGC018WWA YFGC025WWC YFGC035WWA YFGC225WWA YFGC233WWA YFGC235WWA 星系和频段 GPS：L1 Galileo：E1 BDS：B1C QZSS：L1 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 GPS：L1、L5 Galileo：E1、E5a BDS：B1C、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 上海移远通信技术股份有限公司 GNSS 天线应用指导 39 / 48 天线型号 YFGC238WWA YFGC245WWB 星系和频段 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 7.2. 带有连接线的无源陶瓷天线 GNSS 天线应用指导 Better 图 32：带有连接线的无源陶瓷天线 上海移远通信技术股份有限公司 40 / 48 表 5：带有连接线的无源陶瓷天线 天线型号 YCGO004AA YCGO005AA YCGO006AA YCGO007AA YG0030AA YYL02A0AA 星系和频段 GPS：L1 Galileo：E1 BDS：B1C QZSS：L1 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C QZSS：L1 GPS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 GPS：L1、L5 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GNSS 天线应用指导 上海移远通信技术股份有限公司 41 / 48 7.3. 带有连接线的有源陶瓷天线 GNSS 天线应用指导 • YFGA010E3AM • 10 × 10 × 4 mm • YFGA015E3AM • 15 × 15 × 4 mm • YFGA018E3AM • 18 × 18 × 4 mm • YFGA025E3CM • 25 × 25 × 4 mm Better • YFGA225E3AM • 25 × 25 × 4 mm + 18 × 18 × 4 mm • YFGA235E3AM • 35 × 35 × 6 mm + 28 × 28 × 4 mm • YFGC007E3A • 38 × 38 × 6 mm + 25 × 25 × 4 mm • YFGA245E3AM • 45 × 45 × 6 mm + 40 × 40 × 4 mm 图 33：带有连接线的有源陶瓷天线 表 6：带有连接线的有源陶瓷天线 天线型号 YFGA010E3AM YFGA015E3AM YFGA018E3AM 星系和频段 GPS：L1 Galileo：E1 BDS：B1C QZSS：L1 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C QZSS：L1 GPS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 内部架构 SAW + LNA SAW + LNA SAW + LNA LNA 增益 17 ±3 dB 17 ±3 dB 17 ±3 dB 上海移远通信技术股份有限公司 42 / 48 天线型号 YFGA025E3CM YFGA225E3AM YFGA235E3AM YFGC007E3A YFGA245E3AM 星系和频段 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 内部架构 SAW + LNA SAW + LNA SAW + LNA SAW + LNA SAW + LNA GNSS 天线应用指导 LNA 增益 17 ±3 dB 17 ±3 dB 17 ±3 dB 17 ±3 dB 17 ±3 dB 上海移远通信技术股份有限公司 43 / 48 7.4. 外部有源天线 GNSS 天线应用指导 • YEGB000Q1C • 45 × 36 × 15.8 mm • YEGN001Q1A • 53 ×48 ×20 mm 图 34：外部有源天线 • YEGD006U1A • 90 × 85 × 25.8 mm 表 7：外部有源天线 天线型号 YEGB000Q1C YEGN001Q1A YEGD006U1A 星系和频段 内部架构 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C QZSS：L1 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L2C、L5 GLONASS：L1、L2、L3 Galileo：E1、E5a、E5b、E6 BDS：B1C、B1I、B2a、B2b、B2I、B3I QZSS：L1、L2C、L5、L6 NavIC：L5 L band SAW + LNA SAW + LNA SAW + LNA LNA 增益 21 ±3 dB 21 ±3 dB 30 ±3 dB 上海移远通信技术股份有限公司 44 / 48 7.5. 其他天线 GNSS 天线应用指导 • YEGT000W8A • YEGM013AA 图 35：其他天线 • YEGN007AA • YEGN007BA • YEGN009AA • YEGN009BA 表 8：其他天线 天线型号 YEGT000W8A YEGM013AA YEGN007AA YEGN007BA 星系和频段 内部架构 GPS：L1、L5 GLONASS：L1 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L2C、L5 GLONASS：L1、L2、L3 Galileo：E1、E5a、E5b、E6 BDS：B1C、B1I、B2a、B2b、B2I、B3I QZSS：L1、L2C、L5、L6 NavIC：L5 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 GPS：L1 GLONASS：L1 Galileo：E1 BDS：B1C、B1I QZSS：L1 SAW + LNA SAW + LNA SAW + LNA SAW + LNA LNA 增益 28 ±2 dB 40 ±2 dB 17 ±3 dB 28 ±3 dB 上海移远通信技术股份有限公司 45 / 48 GNSS 天线应用指导 天线型号 YEGN009AA YEGN009BA 星系和频段 GPS：L1、L5 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 GPS：L1、L5 Galileo：E1、E5a BDS：B1C、B1I、B2a QZSS：L1、L5 NavIC：L5 内部架构 LNA 增益 介质滤波器 + LNA 17 ±3 dB 介质滤波器 + LNA 28 ±3 dB 备注 如需了解本章所推荐天线的详细信息，可参考对应天线的数据手册或联系移远通信技术支持 （support@quectel.com）。 上海移远通信技术股份有限公司 46 / 48 GNSS 天线应用指导 8 附录 术语缩写 表 9：术语缩写 缩写 英文全称 3GPP 3rd Generation Partnership Project BDS BeiDou Navigation Satellite System C/N0 DC Carrier-to-noise Ratio Direct Current DC-DC Direct Current to Direct Current DCS1800 Digital Cellular System at 1800 MHz ESD Electrostatic Discharge Galileo Galileo Satellite Navigation System (EU) GLONASS Global Navigation Satellite System (Russia) GND Ground GNSS Global Navigation Satellite System GPS Global Positioning System GSM Global System for Mobile Communications HPBW Half-power Beamwidth IM Inter-Modulation IMD Intermodulation Distortion LCM 'LCD Module'/Liquid Crystal Monitor LNA Low-noise Amplifier LTE Long-term Evolution 中文全称 第三代合作伙伴计划 北斗卫星导航系统（中国） 载噪比 直流电 直流转直流电源 1800 MHz 的数字蜂窝系统 静电释放 伽利略卫星导航系统（欧盟） 格洛纳斯全球导航卫星系统（俄罗斯） 地 全球导航卫星系统 全球定位系统 全球移动通信系统 半功率波瓣宽度 互调 互调失真 液晶显示模块 低噪声放大器 长期演进技术 上海移远通信技术股份有限公司 47 / 48 缩写 NF PCB PCO PCV PIFA QZSS RF RHCP RTK SAW SMD SPDT USB VSWR WCDMA Wi-Fi 英文全称 Noise Figure Printed Circuit Board Phase Center Offset Phase Center Variation Planar Inverted F-shaped Antenna Quasi-zenith Satellite System Radio Frequency Right Hand Circular Polarization Real-Time Kinematic Surface Acoustic Wave Surface Mount Device Single-Pole Double-Throw Universal Serial Bus Voltage Standing Wave Ratio Wideband Code Division Multiple Access Wireless Fidelity GNSS 天线应用指导 中文全称 噪声系数 印刷电路板 相位中心偏移 相位中心变化 平面倒 F 天线 准天顶卫星系统（日本） 射频 右旋圆极化 载波相位差分技术 表面声波 表面贴装器件 单刀双掷 通用串行总线 电压驻波比 宽带码分多址 无线保真（技术） 上海移远通信技术股份有限公司 48 / 48

EC2x&EG2x&EG9x&EM05 系列 终端设备开发注意事项 LTE Standard 模块系列 版本：1.0 日期：2024-04-26 状态：受控文件 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相关 资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此类 受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。移 远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许可。 为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对于任 何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通信有权 追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特定 用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵犯 任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬软 件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产的 陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 文档历史 修订记录 版本 1.0 日期 2024-04-15 2024-04-26 作者 变更表述 Arvin HUANG 文档创建 Arvin HUANG 受控版本 上海移远通信技术股份有限公司 3 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 注意事项 ................................................................................................................................................ 7 2.1. 软件版本 ..................................................................................................................................... 7 2.2. 看门狗逻辑设计 .......................................................................................................................... 7 2.3. 关键文件和配置管理................................................................................................................... 7 2.4. 操作存储介质.............................................................................................................................. 7 2.5. 操作 AT 命令............................................................................................................................... 8 2.6. 网络异常时的建议操作流程........................................................................................................ 8 2.7. DFOTA ....................................................................................................................................... 8 2.8. Secure Boot ............................................................................................................................... 8 2.9. 锁网功能 ..................................................................................................................................... 8 2.10. 整机性能保障.............................................................................................................................. 9 3 附录 参考文档与术语缩写 .................................................................................................................. 10 上海移远通信技术股份有限公司 4 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：参考文档 ........................................................................................................................................... 10 表 3：术语缩写 ........................................................................................................................................... 10 上海移远通信技术股份有限公司 5 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 1 引言 本文档介绍了用户使用移远通信 EC2x、EG2x、EG9x 和 EM05 系列模块开发终端设备时的注意事项。 在终端设备开发过程中，如遇问题，可参考此文档检查是否有相同或者相似问题的解决方案，以便快 速解决问题，避免在开发或商用中产生严重问题，提高开发效率。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG2x EG9x - 模块 EC20-CE EC21 系列 EC25 系列 EG21-G EG25-G EG21-GL EG25-GL EG91 系列 EG95 系列 EM05 系列 上海移远通信技术股份有限公司 6 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 2 注意事项 在终端设备开发过程中，建议用户仔细阅读以下操作注意事项。由于篇幅所限，此章节不会详细描述 原因和可能的后果。如有任何疑问，请联系移远通信技术支持获取更详细的解释。本章节提及的 AT 命令详 情，请参考文档 [1]或咨询移远通信技术支持。 2.1. 软件版本 不支持跨基线更新软件版本。例如，版本 EG25GLXXR07XXXX 中 R07 为基线信息，移远通信出厂的 该版本软件的模块，不支持更新软件至非 R07 的软件版本。 在量产下单时，用户需备注调试正常的软件版本号，避免出现跨基线升级的情况。 2.2. 看门狗逻辑设计 建议在产品设计中引入外部 MCU 看门狗，以监控模块的运行状态，避免其在某些不可预知的场景下， 长时间处于不能正常运行的状态。当检测到模块无法正常运行时，会触发重启操作。 2.3. 关键文件和配置管理 建议在产品程序设计中，对一些关键文件和配置进行管理。在设备升级或重启时，应检查配置是否匹 配预期配置，若不匹配，则需重新进行配置。对于存放在模块文件系统的重要文件（如证书、QuecOpen App 和关键配置文件等），在用户设备出厂时以及应用程序端执行存储操作后，用户必须进行文件系统备份。 2.4. 操作存储介质 以下操作会对 Flash 存储器进行擦写（Erase/Write）操作，为了延长 Flash 使用寿命，应避免频繁触 发下述操作。无论设备处在何种场景下，请勿无限制循环以下操作，建议每天执行总数不超过 30 次。 上海移远通信技术股份有限公司 7 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 ⚫ 开关机 ⚫ 切换执行 AT+CFUN=0、AT+CFUN=1 和 AT+CFUN=4 ⚫ 切换(U)SIM 卡 ⚫ 重复执行设置 NVM 的命令 2.5. 操作 AT 命令 请勿采用多线程的方式向模块发送 AT 命令，需使用单线程或队列的方式向模块发送 AT 命令。在收到 前一条 AT 响应之前，请勿发送下一条 AT 命令。 2.6. 网络异常时的建议操作流程 模块开机后如果不能正常注册网络，建议按照以下流程执行： 如果首次网络注册失败，建议等待 2 分钟进行搜网。如果网络无法注册，则切换执行 AT+CFUN=4 和 AT+CFUN=1。如果仍然不能正常注册网络，建议第二次等待 4 分钟（以此类推，第三次等待 8 分钟，第四 次等待 16 分钟，第五次等待 32 分钟）后再次尝试切换执行 AT+CFUN=4 和 AT+CFUN=1。如果连续五次 执行 AT+CFUN 命令，仍不能正常注册网络，为了保护模块 Flash 存储器，应设置 AT+CFUN=0，或将模 块断电。 2.7. DFOTA 模块支持固件空中差分升级（DFOTA）功能，此功能可以实现模块差分包的无线升级或降级。DFOTA 升级过程中需要确保模块供电稳定。为了方便解决项目过程中出现的软件问题以及版本更新需求，建议用 户产品保留支持 OTA 升级功能。请联系移远通信技术支持申请调试和量产的差分升级包。 2.8. Secure Boot Secure Boot 功能的启用只允许在产线上进行，不支持通过 OTA 升级或 AT 命令启用。 2.9. 锁网功能 锁网和锁小区的 AT 命令（例如 AT+QNWLOCK）仅可用于调试，不可用于商用。 上海移远通信技术股份有限公司 8 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 2.10. 整机性能保障 为了确保产品在商用时性能最优，建议在商用前做整机射频性能测试。 上海移远通信技术股份有限公司 9 / 10 EC2x&EG2x&EG9x&EM05 系列终端设备开发注意事项 3 附录 参考文档与术语缩写 表 2：参考文档 文档名称 [1] Quectel_EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 表 3：术语缩写 缩写 App DFOTA MCU NVM OTA (U)SIM 英文全称 Application Delta Firmware Upgrade Over-The-Air Microcontroller Unit Non-Volatile Memory Over-the-air programming (Universal) Subscriber Identity Module 中文全称 应用程序 固件空中差分升级 微型控制单元 非易失性存储器 空中编程 （通用）用户识别模块 上海移远通信技术股份有限公司 10 / 10

LC29H 系列 SPI 应用指导 GNSS 模块系列 版本：1.0 日期：2024-04-24 状态：受控文件 LC29H 系列 SPI 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 32 LC29H 系列 SPI 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 32 LC29H 系列 SPI 应用指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 LC29H 系列 SPI 应用指导 GNSS 模块系列 SPI 应用指导 受控文件 修订历史 版本 1.0 日期 2023-09-05 2024-04-24 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 32 LC29H 系列 SPI 应用指导 目录 关于文档 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................4 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 引言.....................................................................................................................................................7 2 模块 SPI 接口特性 ...............................................................................................................................8 2.1. 主机与模块连接 ........................................................................................................................8 2.2. 模块 SPI 读/写时序 ...................................................................................................................8 2.3. 模块 SPI 接口时序图.................................................................................................................9 3 模块 SPI 规范 ....................................................................................................................................10 3.1. 模块 SPI 寄存器 ......................................................................................................................10 3.2. 模块 SPI 命令和使用...............................................................................................................10 3.2.1. 模块 SPI 命令...............................................................................................................10 3.2.2. 模块 SPI 命令使用方法 ................................................................................................ 11 3.2.2.1. PWON_CMD 和 PWOFF_CMD ........................................................................ 11 3.2.2.2. CFG_RD_CMD 和 CFG_WR_CMD ..................................................................12 3.2.2.3. 其他命令............................................................................................................12 3.3. 模块 SPI 状态标志 ..................................................................................................................13 4 数据的读取和写入 .............................................................................................................................14 4.1. 读取数据 .................................................................................................................................15 4.2. 写入数据 .................................................................................................................................17 5 SPI 读/写流程示例.............................................................................................................................19 6 SPI 读/写数据示例代码......................................................................................................................21 7 参考文档及术语缩写..........................................................................................................................32 上海移远通信技术股份有限公司 4 / 32 LC29H 系列 SPI 应用指导 表格索引 表 1：支持 SPI 的模块和软件版本............................................................................................................. 7 表 2：模块 SPI 接口特性 ........................................................................................................................... 9 表 3：模块 SPI 寄存器............................................................................................................................. 10 表 4：模块 SPI 命令 ................................................................................................................................ 10 表 5：模块 SPI 状态标志 ......................................................................................................................... 13 表 6：参考文档........................................................................................................................................ 32 表 7：术语缩写........................................................................................................................................ 32 上海移远通信技术股份有限公司 5 / 32 LC29H 系列 SPI 应用指导 图片索引 图 1：SPI 主机与模块连接 ........................................................................................................................ 8 图 2：模块 SPI 读/写时序 .......................................................................................................................... 9 图 3：模块 SPI 接口时序图........................................................................................................................ 9 图 4：主机发送 PWON_CMD 或 PWOFF_CMD ......................................................................................11 图 5：主机发送 CFG_RD_CMD 或 CFG_WR_CMD ............................................................................... 12 图 6：主机发送其他模块 SPI 命令........................................................................................................... 12 图 7：模块 SPI 读写流程 ......................................................................................................................... 14 图 8：主机读取数据步骤 1-a) .................................................................................................................. 15 图 9：主机读取数据步骤 1-b) .................................................................................................................. 15 图 10：主机读取数据步骤 1-c)................................................................................................................. 15 图 11：主机读取数据步骤 1-d)................................................................................................................. 15 图 12：主机读取数据步骤 2-a) ................................................................................................................ 16 图 13：主机读取数据步骤 2-b) ................................................................................................................ 16 图 14：主机读取数据步骤 2-c)................................................................................................................. 16 图 15：主机读取数据步骤 2-d) ................................................................................................................ 16 图 16：主机写入数据步骤 1-a) ................................................................................................................ 17 图 17：主机写入数据步骤 1-b) ................................................................................................................ 17 图 18：主机写入数据步骤 1-c)................................................................................................................. 17 图 19：主机写入数据步骤 1-d) ................................................................................................................ 17 图 20：主机写入数据步骤 2-a) ................................................................................................................ 17 图 21：主机写入数据步骤 2-b) ................................................................................................................ 18 图 22：主机写入数据步骤 2-c)................................................................................................................. 18 图 23：主机写入数据步骤 2-d) ................................................................................................................ 18 上海移远通信技术股份有限公司 6 / 32 LC29H 系列 SPI 应用指导 1 引言 本文档概述了 LC29H 系列模块的 SPI 功能及其用法。与主机（客户端 MCU）通信时，模块始终作为 从设备运行。主机可通过 SPI 总线读取或写入任何消息。为使能 SPI 接口，需要在上电时将 D_SEL1 引脚 拉高、D_SEL2 引脚拉低，详情参考文档 [1] 硬件设计手册。有关主机可通过 SPI 功能读写的消息详情， 例如 NMEA 和 RTCM 消息，请参考文档 [2] 协议规范。 模块的 SPI 接口特性如下： ⚫ 从机模式； ⚫ 最大时钟频率为 48 MHz； ⚫ 数据传输格式为低位在前； ⚫ SPI 引脚：SPI_CS、SPI_CLK、SPI_MOSI、SPI_MISO； ⚫ SPI 工作模式为 Mode 0（CPOL = 0，CPHA = 0）。 表 1：支持 SPI 的模块和软件版本 模块系列 型号 LC29H (AA) LC29H 系列 LC29H (BA) LC29H (CA) LC29H (DA) 起始软件版本 ⚫ LC29HAANR11A01S ⚫ LC29HBANR11A01S_CSA2 ⚫ LC29HBANR11A01S_CSA4 ⚫ LC29HCANR11A01S_DSA2 ⚫ LC29HCANR01A03S_DSA4 ⚫ LC29HDANR11A01S_RSA 上海移远通信技术股份有限公司 7 / 32 LC29H 系列 SPI 应用指导 2 模块 SPI 接口特性 2.1. 主机与模块连接 SPI 接口使用 4 条线与主机通信：SPI_CS、SPI_CLK、SPI_MOSI 和 SPI_MISO。 主机（主） CS SCK MOSI MISO 模块（从） SPI_CS SPI_CLK SPI_MOSI SPI_MISO 图 1：SPI 主机与模块连接 SPI_CS：片选，由主机控制，拉低后使能传输，在传输完成后拉高。 SPI_CLK：串行时钟，由主机控制。 SPI_MOSI：主机输出，从机输入。 SPI_MISO：主机输入，从机输出。 备注 SPI 接口与 I2C、UART1 引脚复用，不可与 I2C、UART1 同时使用。详情请参考文档 [1] 硬件设计手册。 2.2. 模块 SPI 读/写时序 模块 SPI 工作模式为 Mode 0（CPOL = 0，CPHA = 0），即 SPI_CLK 的空闲电平为低电平，从 SPI_CLK 的第一个边沿开始采集数据。SPI_CLK 为低电平时，SPI_MOSI 和 SPI_MISO 数据发生变化，并在 SPI_CLK 的上升沿被采集。SPI_CLK 为高电平时，数据不会发生变化。 上海移远通信技术股份有限公司 8 / 32 SPI_CS SPI_CLK SPI_MOSI LSB SPI_MISO LSB LC29H 系列 SPI 应用指导 MSB MSB 图 2：模块 SPI 读/写时序 2.3. 模块 SPI 接口时序图 模块 SPI 在典型温度（25 ºC）下的工作特性如图 3：模块 SPI 接口时序图和表 2：模块 SPI 接口特性 所示： SPI_CS SPI_CLK SPI_MOSI SPI_MISO Tcs_setup Tsck_period Bit 0 Bit 0 Tsi_setup Tsi_hold Tso_d Bit 1 Bit 1 Tcs_hold 图 3：模块 SPI 接口时序图 表 2：模块 SPI 接口特性 信号线 参数 SPI_CS Tcs_setup Tcs_hold SPI_CLK Tsck_period SPI_MOSI Tsi_setup Tsi_hold SPI_MISO Tso_d 描述 片选建立时间 片选保持时间 串行时钟周期 SPI 从机数据输入有效时间 SPI 从机数据输入保持时间 SPI 从机数据输出延迟时间 最小值 9.6 28.8 19.2 4.8 4.8 0.0 最大值 15.0 单位 ns ns ns ns ns ns 上海移远通信技术股份有限公司 9 / 32 LC29H 系列 SPI 应用指导 3 模块 SPI 规范 本章介绍模 SPI 接口的寄存器、命令和状态标志。 3.1. 模块 SPI 寄存器 模块 SPI 的寄存器地址如下表所示。 表 3：模块 SPI 寄存器 寄存器名称 SLAVE_TX_LEN_REG SLAVE_TX_BUF_REG SLAVE_RX_LEN_REG SLAVE_RX_BUF_REG 寄存器地址 0x00000008 0x00002000 0x00000004 0x00001000 描述 模块 SPI 发送缓冲区有效数据长度寄存器 模块 SPI 发送缓冲区寄存器 模块 SPI 接收缓冲区可用长度寄存器 模块 SPI 接收缓冲区寄存器 3.2. 模块 SPI 命令和使用 3.2.1. 模块 SPI 命令 模块 SPI 命令如下表所示。 表 4：模块 SPI 命令 命令名称 CFG_RD_CMD RD_CMD CFG_WR_CMD 命令值 0x0A 0x81 0x0C 上海移远通信技术股份有限公司 描述 用于配置待读取数据的寄存器地址以及数据长度。 用于读取数据。 用于配置待写入数据的寄存器地址以及数据长度。 10 / 32 LC29H 系列 SPI 应用指导 命令名称 WR_CMD RS_CMD WS_CMD PWON_CMD PWOFF_CMD 命令值 0x0E 0x06 0x08 0x04 0x02 描述 用于写入数据。 用于读取模块 SPI 状态标志。 用于清除模块 SPI 读/写错误标志。 用于启用模块 SPI。 用于关闭模块 SPI。 备注 每次重启或复位模块后都需要发送 PWON_CMD 指令。 3.2.2. 模块 SPI 命令使用方法 模块 SPI 命令的使用可分为如下三种情况： ⚫ PWON_CMD 和 PWOFF_CMD，主机仅发送命令，无数据域或数据； ⚫ CFG_RD_CMD 和 CFG_WR_CMD，主机发送命令和数据域； ⚫ 其他命令，即 RD_CMD、WR_CMD、RS_CMD 和 WS_CMD，主机发送命令和数据。 3.2.2.1. PWON_CMD 和 PWOFF_CMD 主机仅发送 PWON_CMD 或 PWOFF_CMD 命令，无数据域或数据。 SPI_CS SPI_CLK SPI_MOSI SPI_MISO ... PWON_CMD或PWOFF_CMD 无效数据 图 4：主机发送 PWON_CMD 或 PWOFF_CMD 上海移远通信技术股份有限公司 11 / 32 LC29H 系列 SPI 应用指导 3.2.2.2. CFG_RD_CMD 和 CFG_WR_CMD 主机发送 CFG_RD_CMD 或 CFG_WR_CMD 命令和数据域。数据域包括 4 字节模块 SPI 寄存器地址 和用户待读/写的 4 字节数据长度。 SPI_CS SPI_CLK SPI_MOSI SPI_MISO ... CFG_RD_CMD或CFG_WR_CMD 无效数据 ... 模块SPI寄存器 无效数据 ... 用户读/写的数据长度 无效数据 图 5：主机发送 CFG_RD_CMD 或 CFG_WR_CMD 备注 由于长度是从 SPI 寄存器地址开始偏移，因此发送的数据长度需要减去 1。 3.2.2.3. 其他命令 主机发送其他命令和数据。 SPI_CS SPI_CLK SPI_MOSI SPI_MISO ... 其他命令，即RD_CMD、WR_CMD、 RS_CMD或WS_CMD 无效数据 ... 数据 1） 数据 图 6：主机发送其他模块 SPI 命令 备注 1） 若通过 SPI_MOSI 发送的命令为 WR_CMD 或 WS_CMD，则此处的数据为用户发送的数据；若通过 SPI_MOSI 发送的命令为 RD_CMD 或 RS_CMD，则此处的数据为无效数据。 上海移远通信技术股份有限公司 12 / 32 LC29H 系列 SPI 应用指导 3.3. 模块 SPI 状态标志 模块 SPI 状态标志如下表所示。 表 5：模块 SPI 状态标志 状态标志名称 STA_SLV_ON STA_TXRX_FIFO_RDY STA_RD_ERR STA_WR_ERR STA_RDWR_FINISH 状态标志值 0x01 0x04 0x08 0x10 0x20 描述 模块 SPI 开机标志。 模块 SPI 发送/接收缓冲区（FIFO）就绪标志。 模块 SPI 读取错误标志。 模块 SPI 写入错误标志。 模块 SPI 读/写完成标志。 上海移远通信技术股份有限公司 13 / 32 LC29H 系列 SPI 应用指导 4 数据的读取和写入 本章详细介绍主机如何通过 SPI 总线读写数据，以及读写过程中使用的寄存器、命令和状态标志。 开始 发送PWON_CMD 否 是 N 检查超过100次? 发送RS_CMD 读取状态标志 1） 否 检查 STA_SLV_ON 是否置位? 是 发送 CFG_RD_CMD或 CFG_WR_CMD 是 检查超过100次? 否 发送RS_CMD 读取状态标志 1） 否 检查 STA_TXRX_FIFO_RDY 是否置位? 是 发送 RD_CMD或 WR_CMD， 读或写数据 发送RS_CMD 读取状态标志 1） 发送PWOFF_CMD和 PWON_CMD，复位模 块SPI 发送WS_CMD，清除 错误标志 检查 STA_RD_ERR 或 是 STA_WR_ERR 是否置位? 否 否 是 检查超过100次? 否 检查 STA_RDWR_FINISH 是否置位? 是 结束 图 7：模块 SPI 读写流程 上海移远通信技术股份有限公司 14 / 32 备注 1) 每次发送 RS_CMD，都需要延时 1 ms。 LC29H 系列 SPI 应用指导 4.1. 读取数据 主机读取数据流程如下。 步骤1 读取模块 SPI 发送数据缓冲区的有效数据长度。 a) 主机发送 CFG_RD_CMD、SLAVE_TX_LEN_REG 和 0x00000004 - 1，共 9 个字节。 主机 模块 CFG_RD_CMD SLAVE_TX_LEN_REG 无效数据 0x00000003 图 8：主机读取数据步骤 1-a) b) 主机发送 RS_CMD，检查 STA_TXRX_FIFO_RDY 标志是否置位。 主机 模块 RS_CMD 1 字节无效数据 1 字节无效数据 状态标志数据（包含 STA_TXRX_FIFO_RDY） 图 9：主机读取数据步骤 1-b) c) 主机发送 RD_CMD，读取 4 字节的模块 SPI 发送缓冲区有效数据长度 1）。 主机 模块 RD_CMD 1 字节无效数据 4 字节无效数据 模块 SPI 发送缓冲区有效数据长度 1） 图 10：主机读取数据步骤 1-c) d) 主机发送 RS_CMD，检查 STA_RDWR_FINISH 标志是否置位。 主机 模块 RS_CMD 1 字节无效数据 1 字节无效数据 状态标志数据（包含 STA_RDWR_FINISH） 图 11：主机读取数据步骤 1-d) 上海移远通信技术股份有限公司 15 / 32 LC29H 系列 SPI 应用指导 步骤2 读取模块 SPI 的发送缓冲区数据。 a) 主机发送 CFG_RD_CMD、SLAVE_TX_BUF_REG 和 data_read_len 2） - 1，共 9 个字节。 主机 模块 CFG_RD_CMD SLAVE_TX_BUF_REG data_read_len 2） - 1 无效数据 图 12：主机读取数据步骤 2-a) b) 主机发送 RS_CMD，检查 STA_TXRX_FIFO_RDY 标志是否置位。 主机 模块 RS_CMD 1 字节无效数据 1 字节无效数据 状态标志数据（包含 STA_TXRX_FIFO_RDY） 图 13：主机读取数据步骤 2-b) c) 主机发送 RD_CMD，同时接收数据。 主机 模块 RD_CMD 1 字节无效数据 data_read_len 2) 字节无效数据 数据（data_read_len 2）个字节） 图 14：主机读取数据步骤 2-c) d) 主机发送 RS_CMD，检查 STA_RDWR_FINISH 标志是否置位。 主机 模块 RS_CMD 1 字节无效数据 1 字节无效数据 状态标志数据（包含 STA_RDWR_FINISH） 图 15：主机读取数据步骤 2-d) 备注 1. 1） 如果在步骤 1 中读取到的 SPI 发送缓冲区有效数据长度为 0，表示模块此时无数据输出，需重新 执行步骤 1-a)。 2. 2） 无符号整型数据 data_read_len 是主机设置的接收数据长度。若在步骤 1 读取到的 SPI 发送缓冲 区数据长度大于 data_read_len，可重复执行步骤 2，直至所有数据读取完毕。主机实际读取的数据 总长度不可超过 SPI 发送缓冲区有效数据长度，否则通过步骤 2 无法读取 STA_TXRX_FIFO_RDY 置位的状态标志数据。 3. 若主机未及时读取模块 SPI 发送缓冲区数据，发送缓冲区将被填满，使模块 SPI 发送缓冲区进入休 眠状态。可通过 SPI 接口向模块发送任意数据唤醒 SPI 发送缓冲区，详见第 4.2 章 写入数据。 4. 模块以小端格式传输数据。 上海移远通信技术股份有限公司 16 / 32 LC29H 系列 SPI 应用指导 4.2. 写入数据 主机可以通过 SPI 总线向模块发送消息。消息详情请见文档 [2] 协议规范。主机写入数据的步骤如下。 步骤1 读取模块 SPI 接收数据缓冲区的可用长度。 a) 主机发送 CFG_RD_CMD、SLAVE_RX_LEN_REG 和 0x00000004 - 1，共 9 个字节。 主机 模块 CFG_RD_CMD SLAVE_RX_LEN_REG 无效数据 0x00000003 图 16：主机写入数据步骤 1-a) b) 主机发送 RS_CMD，检查 STA_TXRX_FIFO_RDY 标志是否置位。 主机 模块 RS_CMD 1 字节无效数据 1 字节无效数据 状态标志数据（包含 STA_TXRX_FIFO_RDY） 图 17：主机写入数据步骤 1-b) c) 主机发送 RD_CMD，读取 4 字节的模块 SPI 接收缓冲区可用长度 1）。 主机 模块 RD_CMD 1 字节无效数据 4 字节无效数据 SPI 接收缓冲区的可用长度 1） 图 18：主机写入数据步骤 1-c) d) 主机发送 RS_CMD，检查 STA_RDWR_FINISH 标志是否置位。 主机 模块 RS_CMD 1 字节无效数据 1 字节无效数据 状态标志数据（包含 STA_RDWR_FINISH） 图 19：主机写入数据步骤 1-d) 步骤2 向模块 SPI 接收缓冲区写入数据。 a) 主机发送 CFG_WR_CMD、SLAVE_RX_BUF_REG 和 data_written_len 2） - 1，共 9 个字节。 主机 模块 CFG_WR_CMD SLAVE_RX_BUF_REG 无效数据 data_written_len 2） - 1 图 20：主机写入数据步骤 2-a) 上海移远通信技术股份有限公司 17 / 32 LC29H 系列 SPI 应用指导 b) 主机发送 RS_CMD，检查 STA_TXRX_FIFO_RDY 标志是否置位。 主机 模块 RS_CMD 1 字节无效数据 1 字节无效数据 状态标志数据（包含 STA_TXRX_FIFO_RDY） 图 21：主机写入数据步骤 2-b) c) 主机发送 WR_CMD 和 data_written_len 2）字节数据。 主机 模块 WR_CMD 待写入的数据（data_written_len 2）个字节） 无效数据 图 22：主机写入数据步骤 2-c) d) 主机发送 RS_CMD，检查 STA_RDWR_FINISH 标志是否置位。 主机 模块 RS_CMD 1 字节无效数据 1 字节无效数据 状态标志数据（包含 STA_RDWR_FINISH） 图 23：主机写入数据步骤 2-d) 备注 1. 1） 模块 SPI 接收缓冲区的可用长度表示主机一次可写入数据的最大长度。若主机待写入数据长度超 过该值，需将数据拆分后多次发送。 2. 2） 无符号整型变量 data_written_len 是主机待写入数据的长度。 3. 模块以小端格式传输数据。 上海移远通信技术股份有限公司 18 / 32 LC29H 系列 SPI 应用指导 5 SPI 读/写流程示例 以 LC29H (BA)为例，通过 SPI 接口读取 NMEA 消息与写入数据的示例如下，其中 XX 代表无效数据。 //确保模块 SPI 可用。 //主机发送 PWON_CMD。 04 //主机发送 RS_CMD。 06 XX //模块响应包含 STA_SLV_ON 的状态标志数据。 XX 03 //读取数据。 //步骤 1-a)：主机发送 CFG_RD_CMD、SLAVE_TX_LEN_REG 和减 1 后的数据长度。 0A 08 00 00 00 03 00 00 00 //步骤 1-b)：主机发送 RS_CMD。 06 XX //模块响应包含 STA_TXRX_FIFO_RDY 的状态标志数据。 XX 07 //步骤 1-c)：主机发送 RD_CMD。 81 XX XX XX XX //模块响应当前发送缓冲区的有效数据长度。 XX F0 04 00 00 //步骤 1-d)：主机发送 RS_CMD。 06 XX //模块响应包含 STA_RDWR_FINISH 的状态标志数据。 XX 27 //步骤 2-a)：主机发送 CFG_RD_CMD、SLAVE_TX_BUF_REG 和减 1 后的待读取数据长度（详见第 3.2.2.2 章 CFG_RD_CMD 和 CFG_WR_CMD）。 0A 00 20 00 00 EF 04 00 00 //步骤 2-b)：主机发送 RS_CMD。 06 XX //模块响应包含 STA_TXRX_FIFO_RDY 的状态标志数据。 XX 07 //步骤 2-c)：主机发送 RD_CMD。 81 XX XX XX XX … XX XX //模块响应 NMEA 数据。 XX 24 50 51 54 … 0D 0A //步骤 2-d)：主机发送 RS_CMD。 上海移远通信技术股份有限公司 19 / 32 LC29H 系列 SPI 应用指导 06 XX //模块响应包含 STA_RDWR_FINISH 的状态标志数据。 XX 27 //写入数据$PQTMVERNO*58rn。 //步骤 1-a)：主机发送 CFG_RD_CMD、SLAVE_RX_LEN_REG 和减 1 后的数据长度。 0A 04 00 00 00 03 00 00 00 //步骤 1-b)：主机发送 RS_CMD。 06 XX //模块响应包含 STA_TXRX_FIFO_RDY 的状态标志数据。 XX 07 //步骤 1-c)：主机发送 RD_CMD。 81 XX XX XX XX //模块响应当前接收缓冲区的可用长度。 XX 00 01 00 00 //步骤 1-d)：主机发送 RS_CMD。 06 XX //模块响应包含 STA_RDWR_FINISH 的状态标志数据。 XX 27 //步骤 2-a)：主机发送 CFG_WR_CMD、SLAVE_RX_BUF_REG 和减 1 后的待写入数据长度（详见第 3.2.2.2 章 CFG_RD_CMD 和 CFG_WR_CMD）。 0C 00 10 00 00 0E 00 00 00 //步骤 2-b)：主机发送 RS_CMD。 06 XX //模块响应包含 STA_TXRX_FIFO_RDY 的状态标志数据。 XX 07 //步骤 2-c)：主机发送 WR_CMD 和待写入的数据$PQTMVERNO*58rn。 0E 24 50 51 54 4D 56 45 52 4E 4F 2A 35 38 0D 0A //步骤 2-d)：主机发送 RS_CMD。 06 XX //模块响应包含 STA_RDWR_FINISH 的状态标志数据。 XX 27 上海移远通信技术股份有限公司 20 / 32 LC29H 系列 SPI 应用指导 6 SPI 读/写数据示例代码 从 SPI 缓冲区读取数据和向 SPI 缓冲区写入数据的示例代码如下： #define MAX_ERROR_NUMBER 100 #define FAIL_MAX_TIME 5 #define SPI_MAX_BUFF_LENGTH 0x1000 #define CFG_RD_CMD #define RD_CMD #define CFG_WR_CMD #define WR_CMD #define RS_CMD #define WS_CMD #define PWON_CMD #define PWOFF_CMD 0x0A 0x81 0x0C 0x0E 0x06 0x08 0x04 0x02 #define SLAVE_TX_LEN_REG #define SLAVE_TX_BUF_REG 0x08 0x2000 #define SLAVE_RX_LEN_REG #define SLAVE_RX_BUF_REG 0x04 0x1000 #define SPIS_STA_SLV_ON_OFFSET #define SPIS_STA_SLV_ON (0) (0x1<<SPIS_STA_SLV_ON_OFFSET) #define SPIS_STA_TXRX_FIFO_RDY_OFFSET #define SPIS_STA_TXRX_FIFO_RDY (2) (0x1<<SPIS_STA_TXRX_FIFO_RDY_OFFSET) #define SPIS_STA_RD_ERR_OFFSET #define SPIS_STA_RD_ERR (3) (0x1<<SPIS_STA_RD_ERR_OFFSET) #define SPIS_STA_WR_ERR_OFFSET #define SPIS_STA_WR_ERR (4) (0x1<<SPIS_STA_WR_ERR_OFFSET) #define SPIS_STA_RDWR_FINISH_OFFSET #define SPIS_STA_RDWR_FINISH (5) (0x1<<SPIS_STA_RDWR_FINISH_OFFSET) 上海移远通信技术股份有限公司 21 / 32 LC29H 系列 SPI 应用指导 #define Ql_SPI_SlavePowerOn() Ql_SPI_Write_Power_Cmd(PWON_CMD) #define Ql_SPI_SlavePowerOff() Ql_SPI_Write_Power_Cmd(PWOFF_CMD) #define QL_SPI_Reset() Ql_SPI_SlavePowerOff(); Ql_SPI_SlavePowerOn() #define Is_SPI_Slave_Error_Status(Status) ((Status == SPIS_STA_TXRX_FIFO_RDY) || (Status == SPIS_STA_RDWR_FINISH) && (Status == SPIS_STA_SLV_ON)) typedef enum { STATUS_OK, STATUS_ERROR, } Ql_Host_Status_TypeDef; typedef struct { uint16_t ReceiveLength; uint16_t SendLength; uint8_t* SendData; uint8_t* ReceiveBuffer; } Ql_SPI_Send_Receive_TypeDef; uint8_t Ql_SPI_RecvBuffer[SPI_MAX_BUFF_LENGTH+1]; uint8_t Ql_SPI_SendBuffer[SPI_MAX_BUFF_LENGTH+1]; void Ql_SPI_Write_Power_Cmd(uint8_t Cmd); static Ql_Host_Status_TypeDef Ql_SPI_Power_State(uint32_t BitMask, uint32_t BitValue, uint32_t RetryCounter) { uint8_t status_cmd[2] = {RS_CMD,0x00}; uint8_t status = 0; uint8_t status_receive[2] = {0}; uint8_t clear_cmd_buf[2] = {0}; uint8_t temp_cmd = PWOFF_CMD; uint8_t recv_buf[2] = {0}; Ql_SPI_Send_Receive_TypeDef spi_send_and_receive_config = {0}; for(int i = 0; i < RetryCounter; i ++) { status_receive[1] = 0; spi_send_and_receive_config.ReceiveLength = 2; spi_send_and_receive_config.SendLength = 1; spi_send_and_receive_config.SendData = status_cmd; spi_send_and_receive_config.ReceiveBuffer = status_receive; 上海移远通信技术股份有限公司 22 / 32 LC29H 系列 SPI 应用指导 HAL_SPI_WriteRead(spi_send_and_receive_config.SendData, spi_send_and_receive_config.ReceiveBuffer, spi_send_and_receive_config.ReceiveLength); status = status_receive[1]; if (status != 0xff) { if (status & (SPIS_STA_RD_ERR|SPIS_STA_WR_ERR)) { clear_cmd_buf[0] = WS_CMD; clear_cmd_buf[1] = status; HAL_SPI_WriteRead(clear_cmd_buf, status_receive, 2); return STATUS_ERROR; } else if ((BitMask & status)== BitValue) { return STATUS_OK; } else { return STATUS_ERROR; } } } return STATUS_ERROR; } void Ql_SPI_Write_Power_Cmd(uint8_t Cmd) { uint8_t temp_cmd = Cmd; uint8_t recv_buf[2] = {0}; switch(temp_cmd) { case PWON_CMD: { while(1) { HAL_SPI_WriteRead(&temp_cmd, recv_buf, 1); if (STATUS_OK == Ql_SPI_Power_State(SPIS_STA_SLV_ON, SPIS_STA_SLV_ON, MAX_ERROR_NUMBER)) { break; } } } 上海移远通信技术股份有限公司 23 / 32 LC29H 系列 SPI 应用指导 break; case PWOFF_CMD: { while(1) { HAL_SPI_WriteRead(&temp_cmd, recv_buf, 1); if (STATUS_OK == Ql_SPI_Ql_SPI_Power_State(SPIS_STA_SLV_ON, 0, MAX_ERROR_NUMBER)) { break; } } } break; } } static Ql_Host_Status_TypeDef Ql_SPI_Query_Slave_Status(uint32_t BitMask, uint32_t BitValue, uint32_t RetryCounter) { uint8_t status_cmd[2] = {RS_CMD,0x00}; uint8_t status = 0; uint8_t status_receive[2] = {0}; uint8_t clear_cmd_buf[2] = {0}; Ql_SPI_Send_Receive_TypeDef spi_send_and_receive_config = {0}; for(int i = 0; i < RetryCounter; i ++) { HAL_Delay(1); status_receive[1] = 0; spi_send_and_receive_config.ReceiveLength = 2; spi_send_and_receive_config.SendLength = 1; spi_send_and_receive_config.SendData = status_cmd; spi_send_and_receive_config.ReceiveBuffer = status_receive; HAL_SPI_WriteRead(spi_send_and_receive_config.SendData, spi_send_and_receive_config.ReceiveBuffer, spi_send_and_receive_config.ReceiveLength); status = status_receive[1]; if (status != 0xff) { if (status & (SPIS_STA_RD_ERR|SPIS_STA_WR_ERR)) { clear_cmd_buf[0]= WS_CMD; clear_cmd_buf[1] = status; HAL_SPI_WriteRead(clear_cmd_buf, status_receive, 2); 上海移远通信技术股份有限公司 24 / 32 LC29H 系列 SPI 应用指导 if(BitMask != SPIS_STA_TXRX_FIFO_RDY) { QL_SPI_Reset(); HAL_Delay(1); } return STATUS_ERROR; } else if((BitMask & status)== BitValue) { return STATUS_OK; } else if (Is_SPI_Slave_Error_Status(BitMask)) { QL_SPI_Reset(); return STATUS_ERROR; } } else { return STATUS_ERROR; } } return STATUS_ERROR; } uint8_t Ql_SPI_WriteAndRead(uint32_t Offset, uint8_t *Buffer, uint32_t *Length) { uint8_t cfg_cmd[9] = {0}; uint8_t recv_cmd[9] = {0}; uint32_t receive_reg_value = 0; uint32_t temp_offset = Offset; Ql_SPI_Send_Receive_TypeDef spi_send_and_receive_config = {0}; uint32_t temp_length = 0; uint32_t total_length = 0; uint8_t fail_counter = 0; static uint8_t temp_host_mux_send_buf[4+1] = {0}; static uint8_t temp_host_mux_receive_buf[4+1] = {0}; _restart: temp_length = 4; cfg_cmd[0] = CFG_RD_CMD; cfg_cmd[1] = Offset & 0xff; cfg_cmd[2] = (Offset >> 8) & 0xff; cfg_cmd[3] = (Offset >> 16) & 0xff; 上海移远通信技术股份有限公司 25 / 32 LC29H 系列 SPI 应用指导 cfg_cmd[4] = (Offset >> 24) & 0xff; cfg_cmd[5] = (temp_length - 1) & 0xff; cfg_cmd[6] = ((temp_length - 1) >> 8) & 0xff; cfg_cmd[7] = ((temp_length - 1) >> 16) & 0xff; cfg_cmd[8] = ((temp_length - 1) >> 24) & 0xff; HAL_SPI_WriteRead(cfg_cmd,recv_cmd,9); if(Ql_SPI_Query_Slave_Status(SPIS_STA_TXRX_FIFO_RDY, SPIS_STA_TXRX_FIFO_RDY, MAX_ERROR_NUMBER) == STATUS_ERROR) { if(fail_counter >= FAIL_MAX_TIME) { fail_counter = 0; return STATUS_ERROR; } fail_counter ++; goto _restart; } else { fail_counter = 0; } switch(temp_offset) { case SLAVE_TX_LEN_REG://Host read { temp_host_mux_send_buf[0] = RD_CMD; spi_send_and_receive_config.ReceiveLength = 4+1; spi_send_and_receive_config.SendLength = 1; spi_send_and_receive_config.SendData = temp_host_mux_send_buf; spi_send_and_receive_config.ReceiveBuffer = temp_host_mux_receive_buf; HAL_SPI_WriteRead(spi_send_and_receive_config.SendData, spi_send_and_receive_config.ReceiveBuffer, spi_send_and_receive_config.ReceiveLength); if(Ql_SPI_Query_Slave_Status(SPIS_STA_RDWR_FINISH, SPIS_STA_RDWR_FINISH, MAX_ERROR_NUMBER) == STATUS_ERROR) { if(fail_counter >= FAIL_MAX_TIME) { fail_counter = 0; return STATUS_ERROR; } fail_counter ++; 上海移远通信技术股份有限公司 26 / 32 LC29H 系列 SPI 应用指导 goto _restart; } else { fail_counter = 0; } receive_reg_value = temp_host_mux_receive_buf[1] | (temp_host_mux_receive_buf[2]<<8) | (temp_host_mux_receive_buf[3]<<16)| (temp_host_mux_receive_buf[4]< SPI_MAX_BUFF_LENGTH) { total_length = receive_reg_value; receive_reg_value = SPI_MAX_BUFF_LENGTH; } if(receive_reg_value==0) { *Length = receive_reg_value; return STATUS_OK; } temp_length = receive_reg_value; Offset = SLAVE_TX_BUF_REG; cfg_cmd[0] = CFG_RD_CMD; cfg_cmd[1] = Offset & 0xff; cfg_cmd[2] = (Offset >> 8) & 0xff; cfg_cmd[3] = (Offset >> 16) & 0xff; cfg_cmd[4] = (Offset >> 24) & 0xff; cfg_cmd[5] = (temp_length - 1) & 0xff; cfg_cmd[6] = ((temp_length - 1) >> 8) & 0xff; cfg_cmd[7] = ((temp_length - 1) >> 16) & 0xff; cfg_cmd[8] = ((temp_length - 1) >> 24) & 0xff; HAL_SPI_WriteRead(cfg_cmd, recv_cmd, 9); if(Ql_SPI_Query_Slave_Status(SPIS_STA_TXRX_FIFO_RDY, SPIS_STA_TXRX_FIFO_RDY, MAX_ERROR_NUMBER) == STATUS_ERROR) { if(fail_counter >= FAIL_MAX_TIME) { fail_counter = 0; return STATUS_ERROR; } fail_counter ++; goto _restart; } 上海移远通信技术股份有限公司 27 / 32 LC29H 系列 SPI 应用指导 else { fail_counter = 0; } Ql_SPI_SendBuffer[0] = RD_CMD; spi_send_and_receive_config.ReceiveLength = temp_length+1; spi_send_and_receive_config.SendLength = 1; spi_send_and_receive_config.SendData = Ql_SPI_SendBuffer; spi_send_and_receive_config.ReceiveBuffer = Buffer; HAL_SPI_WriteRead(spi_send_and_receive_config.SendData, spi_send_and_receive_config.ReceiveBuffer, spi_send_and_receive_config.ReceiveLength); if(Ql_SPI_Query_Slave_Status(SPIS_STA_RDWR_FINISH, SPIS_STA_RDWR_FINISH, MAX_ERROR_NUMBER) == STATUS_ERROR) { if(fail_counter >= FAIL_MAX_TIME) { fail_counter = 0; return STATUS_ERROR; } fail_counter ++; goto _restart; } else { fail_counter = 0; } *Length = receive_reg_value; return STATUS_OK; } break; case SLAVE_RX_LEN_REG://Host send { temp_host_mux_send_buf[0] = RD_CMD; spi_send_and_receive_config.ReceiveLength = 4+1; spi_send_and_receive_config.SendLength = 1; spi_send_and_receive_config.SendData = temp_host_mux_send_buf; spi_send_and_receive_config.ReceiveBuffer = temp_host_mux_receive_buf; HAL_SPI_WriteRead(spi_send_and_receive_config.SendData, spi_send_and_receive_config.ReceiveBuffer, spi_send_and_receive_config.ReceiveLength); if(Ql_SPI_Query_Slave_Status(SPIS_STA_RDWR_FINISH, 上海移远通信技术股份有限公司 28 / 32 LC29H 系列 SPI 应用指导 SPIS_STA_RDWR_FINISH, MAX_ERROR_NUMBER) == STATUS_ERROR) { if(fail_counter >= FAIL_MAX_TIME) { fail_counter = 0; return STATUS_ERROR; } fail_counter ++; goto _restart; } else { fail_counter = 0; } receive_reg_value = temp_host_mux_receive_buf[1] | (temp_host_mux_receive_buf[2]<<8) | (temp_host_mux_receive_buf[3]<<16)| (temp_host_mux_receive_buf[4]< *Length) { receive_reg_value = *Length; } if(receive_reg_value == 0) { return STATUS_OK; } temp_length = receive_reg_value; Offset = SLAVE_RX_BUF_REG; cfg_cmd[0] = CFG_WR_CMD; cfg_cmd[1] = Offset & 0xff; cfg_cmd[2] = (Offset >> 8) & 0xff; cfg_cmd[3] = (Offset >> 16) & 0xff; cfg_cmd[4] = (Offset >> 24) & 0xff; cfg_cmd[5] = (temp_length - 1) & 0xff; cfg_cmd[6] = ((temp_length - 1) >> 8) & 0xff; cfg_cmd[7] = ((temp_length - 1) >> 16) & 0xff; cfg_cmd[8] = ((temp_length - 1) >> 24) & 0xff; HAL_SPI_WriteRead(cfg_cmd, recv_cmd, 9); if(Ql_SPI_Query_Slave_Status(SPIS_STA_TXRX_FIFO_RDY, SPIS_STA_TXRX_FIFO_RDY, MAX_ERROR_NUMBER) == STATUS_ERROR) 上海移远通信技术股份有限公司 29 / 32 LC29H 系列 SPI 应用指导 { if(fail_counter >= FAIL_MAX_TIME) { fail_counter = 0; return STATUS_ERROR; } fail_counter++; goto _restart; } else { fail_counter = 0; } Ql_SPI_SendBuffer[0] = WR_CMD; memcpy(&Ql_SPI_SendBuffer[1], Buffer, receive_reg_value); HAL_SPI_WriteRead(Ql_SPI_SendBuffer, Ql_SPI_RecvBuffer, receive_reg_value+1); memset(Ql_SPI_RecvBuffer, 0, receive_reg_value+1); if(Ql_SPI_Query_Slave_Status(SPIS_STA_RDWR_FINISH, SPIS_STA_RDWR_FINISH, MAX_ERROR_NUMBER) == STATUS_ERROR) { if(fail_counter >= FAIL_MAX_TIME) { fail_counter = 0; return STATUS_ERROR; } fail_counter ++; goto _restart; } else { fail_counter = 0; } *Length = receive_reg_value; return STATUS_OK; } break; default: { // No Code } break; 上海移远通信技术股份有限公司 30 / 32 LC29H 系列 SPI 应用指导 } return STATUS_ERROR; } uint8_t Ql_SPI_Write_Data(uint8_t* DataBuffer,uint32_t Length) { uint8_t result = 0; Ql_SPI_SlavePowerOn(); HAL_Delay(2); result = Ql_SPI_WriteAndRead(SLAVE_RX_LEN_REG,DataBuffer,&Length); return result; } uint8_t Ql_SPI_Read_Data(uint8_t* DataBuffer,uint32_t* Length) { uint8_t result = 0; Ql_SPI_SlavePowerOn(); HAL_Delay(2); result = Ql_SPI_WriteAndRead(SLAVE_TX_LEN_REG,DataBuffer,Length); return result; } 上海移远通信技术股份有限公司 31 / 32 LC29H 系列 SPI 应用指导 7 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_LC29H 系列_硬件设计手册 [2] Quectel_LC29H 系列&LC79H(AL)_GNSS_协议规范 表 7：术语缩写 缩写 英文全称 中文全称 CLK Serial Clock 串行时钟 CPHA Clock Phase 时钟相位 CPOL Clock Polarity 时钟极性 CS Chip Select 片选 FIFO First In First Out 先进先出 GNSS Global Navigation Satellite System 全球导航卫星系统 LSB Least Significant Bit 最低有效位 MCU Microcontroller Unit 微型控制单元 MISO Master In Slave Out 主机输入从机输出 MOSI Master Out Slave In 主机输出从机输入 MSB NMEA SPI Most Significant Bit 最高有效位 NMEA (National Marine Electronics NMEA（美国国家海洋电子协会）0183 接口 Association) 0183 Interface Standard 标准 Serial Peripheral Interface 串行外设接口 上海移远通信技术股份有限公司 32 / 32

EG060V-EA FOTA 应用指导 LTE-A 模块系列 版本：1.0 日期：2023-06-06 状态：受控文件 EG060V-EA FOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 18 EG060V-EA FOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 18 EG060V-EA FOTA 应用指导 文档历史 修订记录 版本 日期 - 2023-03-24 1.0 2023-06-06 作者 Gale GAO/ Paddy LI/ Ethan BI Gale GAO 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 18 EG060V-EA FOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 FOTA 相关 AT 命令详解 ....................................................................................................................... 8 2.1. AT 命令说明................................................................................................................................ 8 2.1.1. 定义 ................................................................................................................................. 8 2.1.2. AT 命令语句 .................................................................................................................... 8 2.2. AT 示例声明................................................................................................................................ 9 2.3. FOTA 相关 AT 命令详解 ............................................................................................................. 9 2.3.1. AT+QFOTADL= 目标固件包存储至 HTTP(S)服务器时升级固件........... 9 2.3.2. AT+QFOTADL= 目标固件包存储至本地文件系统时升级固件 .................11 2.3.3. AT+QFOTASTA 查询 FOTA 升级进度 ........................................................................ 12 2.3.4. AT+QCFG='FOTA' FOTA 相关通用设置.................................................................... 13 3 系统分区 .............................................................................................................................................. 15 3.1. 分区 .......................................................................................................................................... 15 3.2. A/B 系统 ................................................................................................................................... 16 4 错误码 ................................................................................................................................................. 17 5 附录 术语缩写..................................................................................................................................... 18 上海移远通信技术股份有限公司 4 / 18 EG060V-EA FOTA 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 8 表 2：关键分区列表.................................................................................................................................... 15 表 3：错误码............................................................................................................................................... 17 表 4：术语缩写 ........................................................................................................................................... 18 上海移远通信技术股份有限公司 5 / 18 EG060V-EA FOTA 应用指导 图片索引 图 1：A/B 系统 ........................................................................................................................................... 16 上海移远通信技术股份有限公司 6 / 18 EG060V-EA FOTA 应用指导 1 引言 FOTA（Firmware Upgrade Over the Air）指的是远程将固件升级到新版本或将固件恢复到旧版本。 本文档介绍了如何使用 AT 命令在移远通信 EG060V-EA 模块上进行 FOTA 升级，并介绍了升级过程中 所涉及的系统分区。 备注 若需要获取固件包，请联系移远通信技术支持。 上海移远通信技术股份有限公司 7 / 18 EG060V-EA FOTA 应用指导 2 FOTA 相关 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 18 EG060V-EA FOTA 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. FOTA 相关 AT 命令详解 2.3.1. AT+QFOTADL= 目标固件包存储至 HTTP(S)服务器时升级固件 如 果 目 标 固 件 包 存 储 在 HTTP(S) 服 务 器 上 ， 插 入 (U)SIM 卡 并 注 册 到 网 络 后 ， 执 行 AT+QFOTADL=触发固件升级。升级完成后，模块默认自动重启。 AT+QFOTADL= 目标固件包存储至 HTTP(S)服务器时升级固件 设置命令 响应 AT+QFOTADL= OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若有任何错误： ERROR 或 +QIND: 'FOTA','END', 300 毫秒 - 参数 字符串类型。该 URL 应以'http://'或'https://'开头，例如： 'http://:/'。 字符串类型。HTTP(S)服务器的 IP 地址或域名。 整型。HTTP(S)服务器端口。范围：1~65535； 上海移远通信技术股份有限公司 9 / 18 EG060V-EA FOTA 应用指导 默认值：80。 字符串类型。HTTP(S)服务器上目标固件包的文 件名。 整型。升级进度百分比。 整型。指示升级结果的 CURL 状态码。 0 其他值 升级成功 错误码。详见第 1 章 整型。错误码。详见第 1 章。 举例 // 通过地址为'http://220.180.239.212:8051/quectel_skylark_pm801_AB_OTA_IMG'的 HTTP(S)服务器升 级固件 AT+QFOTADL='http://220.180.239.212:8051/quectel_skylark_pm801_AB_OTA_IMG' OK QIND: 'FOTA','START' //开始升级固件 +QIND: 'FOTA','UPDATING',11 +QIND: 'FOTA','UPDATING',23 +QIND: 'FOTA','UPDATING',35 +QIND: 'FOTA','UPDATING',47 +QIND: 'FOTA','UPDATING',59 +QIND: 'FOTA','UPDATING',71 +QIND: 'FOTA','UPDATING',83 +QIND: 'FOTA','UPDATING',95 +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //固件升级成功 上海移远通信技术股份有限公司 10 / 18 EG060V-EA FOTA 应用指导 2.3.2. AT+QFOTADL= 目标固件包存储至本地文件系统时升级固件 若固件包存储在模块的本地文件系统中，执行 AT+QFOTADL=触发固件升级。升级完成 后，模块默认自动重启。 AT+QFOTADL= 目标固件包存储至本地文件系统时升级固件 设置命令 响应 AT+QFOTADL= OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若有任何错误： ERROR 或 +QIND: 'FOTA','END', 300 毫秒 - 参数 字符串类型。存储在本地文件系统的目标固件包路径。最大长度：90；单位：字节。 整型。升级进度百分比。 整型。指示升级结果的 CURL 状态码。 0 升级成功 其他值 错误码。详见第 1 章 整型。错误码。详见第 1 章。 备注 由于受模块可用 flash 空间的限制，目前不推荐使用此方法。 上海移远通信技术股份有限公司 11 / 18 举例 //目标固件包存储至本地文件系统时升级固件 AT+QFOTADL='/quectel_skylark_pm801_AB_OTA_IMG' OK +QIND: 'FOTA','START' //开始升级固件 +QIND: 'FOTA','UPDATING',11 +QIND: 'FOTA','UPDATING',23 +QIND: 'FOTA','UPDATING',35 +QIND: 'FOTA','UPDATING',47 +QIND: 'FOTA','UPDATING',59 +QIND: 'FOTA','UPDATING',71 +QIND: 'FOTA','UPDATING',83 +QIND: 'FOTA','UPDATING',95 +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //升级成功 EG060V-EA FOTA 应用指导 2.3.3. AT+QFOTASTA 查询 FOTA 升级进度 该命令以百分比的形式查询 FOTA 升级进度。在执行 AT+QCFG='FOTA',,0 禁用 FOTA URC 上报后可以使用该命令。 AT+QFOTASTA 查询 FOTA 升级进度 查询命令 响应 AT+QFOTASTA? +QFOTASTA: OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 - 上海移远通信技术股份有限公司 12 / 18 参数 整型。升级进度百分比。 EG060V-EA FOTA 应用指导 2.3.4. AT+QCFG='FOTA' FOTA 相关通用设置 该命令控制模块重启和 URC 上报。 AT+QCFG='FOTA' FOTA 相关通用设置 设置命令 AT+QCFG='FOTA'[,,] 响应 若省略可选参数，查询 FOTA 相关通用设置： +QCFG: 'fota',, 若指定可选参数，设置模块是否重启和 URC 是否上报： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。设置固件升级成功后是否重启模块。 0 不重启 1 重启 整型。是否开启 URC 上报升级进度百分比。 0 关闭 1 开启 上海移远通信技术股份有限公司 13 / 18 EG060V-EA FOTA 应用指导 举例 AT+QCFG='FOTA' +QCFG: 'fota',1,1 //查询 FOTA 相关通用设置 OK AT+QCFG='FOTA',0,0 //关闭 URC 上报和模块自动升级。 OK AT+QFOTADL='/quectel_skylark_pm801_AB_OTA_IMG' OK +QIND: 'FOTA','START' +QIND: 'FOTA','END',0 //升级成功，模块不重启。 上海移远通信技术股份有限公司 14 / 18 EG060V-EA FOTA 应用指导 3 系统分区 3.1. 分区 EG060V-EA 是双系统模块。与以恢复模式实现的单系统模块上的 FOTA 相比，双系统模块上的 FOTA 具有以下优势： 1. 双系统模块上的 FOTA 更安全，因为有关键分区的副本。 2. 升级过程中不影响其他业务的进行。 3. 从 HTTP(S)服务器下载固件的同时可直接写入 Flash 固件，不占用 Flash 内存空间。 表 2：关键分区列表 分区名称 用途 读取&写入 bootloader OBM image 原始分区 cp_reliabledata ap_reliabledata cp_reliabledata _backup ap_reliabledata _backup 存储 CP 所需的数据：频段、 IMEI、MEP、协议配置参数、 原始分区 射频校准参数等。 存储 AP 所需的数据：SN、音 原始分区 频校准参数等。 存储 CP 所需数据的备份分区： 频段、IMEI、MEP、协议配置 原始分区 参数、射频校准参数等。 存储 AP 所需数据的备份分区： 原始分区 SN、音频校准参数等。 cpimage-a cp/msa/rf 原始分区 cpimage-b u-boot-a cp/msa/rf U-BOOT 原始分区 原始分区 大小 256 KB 128 KB 128 KB 128 KB 128 KB 15 MB 15 MB 768 KB 镜像文件 tim_nezha3.bin TLoader_NAND.bin CP_ReliableData.bin AP_ReliableData.bin CP_ReliableData.bin AP_ReliableData.bin ARBEL_LWG.bin MSA_LWG.bin RFPLUGIN_CA_LWG.bin ARBEL_LWG.bin MSA_LWG.bin RFPLUGIN_CA_LWG.bin u-boot.bin 上海移远通信技术股份有限公司 15 / 18 u-boot-b kernel-a kernel-b rootfs-a rootfs-b oem_data rootfs_data dtim-a dtim-b U-BOOT 内核镜像 内核镜像 根文件系统 根文件系统 ubifs ubifs dtim dtim EG060V-EA FOTA 应用指导 原始分区 原始分区 原始分区 仅可读 (squashfs) 仅可读 (squashfs) 可读写 (ubifs) 可读写 (ubifs) 原始分区 原始分区 768 KB 5 MB 5 MB u-boot.bin zImage zImage 20 MB root.squashfs 20 MB root.squashfs 12 MB oem_data.ubi 24.75 MB - 256 KB 256 KB DTim.Primary DTim.Ppsetting Dtim.Recovery 3.2. A/B 系统 FOTA 升级过程中，仅升级 dtim、CP 镜像、uboot、kernel 和 rootfs。模块的每个系统上都有这些分区 的副本，如下图所示。若其中一个系统出现异常，模块将自动切换到另一个系统以确保正常运行。 A系统 OBM BootLoader B系统 dtim cp uboot kernel Rootfs (仅可 读) dtim cp uboot kernel Rootfs (仅可 读) rootfs_data ubifs, rw 图 1：A/B 系统 oem_data ubifs, rw 上海移远通信技术股份有限公司 16 / 18 EG060V-EA FOTA 应用指导 4 错误码 表 3：错误码 错误码 0 1 2 3 4 5 英文描述 中文描述 successful FOTA FOTA 操作成功 Upgrade file does not exist 升级文件不存在 Fail to open upgrade file 打开升级文件失败 Obtain upgrade file times out 获取升级文件超时 URL name error (when upgrading via URL 名称错误（目标固件包存储至 HTTP(S) HTTP(S) server) 服务器时升级固件） Upgrade file size error 升级文件大小错误 备注 若返回的错误码上表中未列举，请参考 CURL 标准库的错误码定义。 上海移远通信技术股份有限公司 17 / 18 EG060V-EA FOTA 应用指导 5 附录 术语缩写 表 4：术语缩写 术语 AP CP CURL FOTA HTTP(S) IMEI MEP OBM OEM RF SN TA URL 英文全称 Application Processor Communication Processor Command Line Uniform Resource Locator Firmware Upgrade Over-The-Air Hyper Text Transport Protocol (Secure) International Mobile Equipment Identity Mobile Equipment Personalization OEM Boot Module Original Equipment Manufacturer Radio Frequency Serial Number Terminal Adapter Uniform Resource Locator 中文全称 应用处理器 通信处理器 命令行统一资源定位符 空中固件升级 超文本传输协议(安全) 国际移动设备标识 移动设备个性化设置 OEM 启动模块 原始设备制造商 射频 系列号 终端适配器 统一资源定位符 上海移远通信技术股份有限公司 18 / 18

EP06&EG06&EM06 系列 UAC 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-12-12 状态：受控文件 EP06&EG06&EM06 系列 UAC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 EP06&EG06&EM06 系列 UAC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 15 EP06&EG06&EM06 系列 UAC 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2022-09-22 Shaun DUAN 文档创建 1.0 2022-12-12 Shaun DUAN 受控版本 上海移远通信技术股份有限公司 3 / 15 EP06&EG06&EM06 系列 UAC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. UAC 功能简介 ............................................................................................................................ 7 1.1.1. USB 声卡驱动.................................................................................................................. 7 1.1.2. PCM 数据转发和语音通话............................................................................................... 8 2 AT 命令详解 .......................................................................................................................................... 9 2.1. AT 命令语句................................................................................................................................ 9 2.1.1. 定义 ................................................................................................................................. 9 2.1.2. AT 命令语句..................................................................................................................... 9 2.2. AT 示例声明.............................................................................................................................. 10 2.3. AT+QCFG='usbcfg' 配置 USB 复合功能 .............................................................................. 10 2.4. AT+QPCMV 启用/禁用语音数据转发功能 ..............................................................................11 3 UAC 功能测试 ..................................................................................................................................... 13 3.1. 测试步骤 ................................................................................................................................... 13 3.2. 测试语音链路............................................................................................................................ 13 3.2.1. Windows 侧 ................................................................................................................... 13 3.2.2. Linux 侧 ......................................................................................................................... 14 4 附录 术语缩写..................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 EP06&EG06&EM06 系列 UAC 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 9 表 2：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 EP06&EG06&EM06 系列 UAC 应用指导 图片索引 图 1：语音数据流示意图 .............................................................................................................................. 7 图 2：加载 USB 声卡.................................................................................................................................... 8 图 3：选择声卡 ........................................................................................................................................... 13 图 4：工具 Audacity ................................................................................................................................... 14 上海移远通信技术股份有限公司 6 / 15 EP06&EG06&EM06 系列 UAC 应用指导 1 引言 本文档介绍移远通信 EG06 系列、EM06 系列和 EP06 系列模块的 UAC 功能，包含 AT 命令、设计方 案及功能测试。 1.1. UAC 功能简介 UAC（USB Audio Class 1.0）是 USB 规范中的音频协议类。该功能由三个部分组成，分别为 UAC 驱 动、PCM 数据转发和语音通话。在 UAC 模式下，模块被识别为主机设备中的 USB 声卡。标准的第三方音 频库（如 alsa-lib）可用于在 Linux 侧录制或者播放音频数据，某些第三方工具（如 Audacity）也可用于在 Windows 上录制或播放音频数据。 在语音呼叫状态下，模块通过空中接口获取语音数据。DSP 将数据解码为语音 PCM 流，然后通过 USB总线将 PCM 流传输到主机设备。因此，主机设备中的音频应用可以通过 USB 声卡获得 PCM 数 据，并传输到扬声器。相反的，主机设备可以将通过麦克风获取的语音数据编码为 PCM 流，并播放到 USB 声卡中，模块将 PCM 数据经过 DSP 编码后发送到空中接口。 主机 Windows/Linux 录制 播放 模块 UAC USB UAC 语音 转发 语音 服务 RF 手机 麦克 风 扬声 器 下行链路音频数据 上行链路音频数据 图 1：语音数据流示意图 1.1.1. USB 声卡驱动 UAC 功能的实现需要主机侧支持 UAC 驱动。移远通信不提供主机侧的 UAC 驱动，请自行开发。模块 开启 UAC 后，主机侧会自动加载 USB 声卡。一般情况下，Windows 10 系统包含 USB 声卡驱动，用户可 自行安装使用。 上海移远通信技术股份有限公司 7 / 15 以 EM06 系列模块为例，Windows 侧显示如下： EP06&EG06&EM06 系列 UAC 应用指导 图 2：加载 USB 声卡 Linux 系统显示如下： #aplay -l **** List of PLAYBACK Hardware Devices **** card 1: EM06E [EM06E], device 0: USB Audio [USB Audio] Subdevices: 1/1 Subdevice #0: subdevice #0 1.1.2. PCM 数据转发和语音通话 使能 UAC 功能后，模块在主机端会被识别为 USB 声卡设备，主机端可以使用 alsa-lib 等第三方库进行 音频数据的录音或者播放。基于 USB 驱动的语音通话，主机端可以捕获下行语音链路的音频数据或者播放 音频数据到上行语音链路，即可在主机端进行二次开发，在主机端上实现语音通话功能。 上海移远通信技术股份有限公司 8 / 15 EP06&EG06&EM06 系列 UAC 应用指导 2 AT 命令详解 2.1. AT 命令语句 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 15 EP06&EG06&EM06 系列 UAC 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QCFG='usbcfg' 配置 USB 复合功能 该命令用于配置模块的 USB 复合功能。 AT+QCFG='usbcfg' 配置 USB 复合功能 设置命令 AT+QCFG='usbcfg'[,,,,,,,, ,] 响应 若省略可选参数，查询当前配置： +QCFG: 'usbcfg',,,,,,,,, OK 最大响应时间 特性说明 若指定可选参数，配置 USB 复合功能： OK 或者 ERROR 300 毫秒 该命令重启后生效； 自动保存参数配置。 参数 十六进制整型。USB 设备的供应商 ID。最大值：0xFFFF。 十六进制整型。USB 设备的产品 ID。最大值：0xFFFF。 整型。USB DIAG 端口状态。 0 禁用 1 启用 整型。USB NMEA 端口状态。 0 禁用 1 启用 整型。USB AT 端口状态。 0 禁用 1 启用 整型。USB Modem 端口状态。 上海移远通信技术股份有限公司 10 / 15 0 禁用 1 启用 整型。USB 网络设备状态。 0 禁用 1 启用 整型。USB ADB 设备状态。 0 禁用 1 启用 整型。UAC 状态。 0 禁用 1 启用 EP06&EG06&EM06 系列 UAC 应用指导 2.4. AT+QPCMV 启用/禁用语音数据转发功能 该命令用于启用或禁用语音数据转发功能。启用该功能后，拨打电话时，来自对方的语音数据将被模 块解码为 PCM 数据，然后通过已设置的 USB 端口输出到设备。同时，设备将 PCM 数据写入 USB 端口， 数据将通过网络传输到呼叫设备的另一端。当呼叫结束时，没有任何数据要输出，输入的数据无效。 AT+QPCMV 启用/禁用语音数据转发功能 测试命令 AT+QPCMV=? 响应 +QPCMV: (支持的列表),(支持的列表) 查询命令 AT+QPCMV? OK 响应 +QPCMV: [,] 设置命令 AT+QPCMV=[,] 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。启用或禁用语音数据转发功能。 0 禁用 1 启用 整型。配置 PCM 数据传输的端口。 上海移远通信技术股份有限公司 11 / 15 EP06&EG06&EM06 系列 UAC 应用指导 2 UAC 模式，将模块作为 USB 声卡使用 备注 使用语音数据转发功能，必须先开启 UAC 功能。 上海移远通信技术股份有限公司 12 / 15 EP06&EG06&EM06 系列 UAC 应用指导 3 UAC 功能测试 本章节主要介绍 UAC 功能的测试步骤和方法。 3.1. 测试步骤 步骤1： 执行 AT+QCFG='usbcfg'，查询模块的 VID 和 PID。 步骤2： 执行 AT+QCFG='usbcfg',,,1,1,1,1,1,0,1 开启 UAC 功能； 步骤3： 重启模块。 步骤4： 观察主机的 USB 声卡是否加载完成。 步骤5： 执行 AT+QPCMV=1,2 启用 UAC 模式； 步骤6： 执行 ATD;（表示电话号码），开始拨打电话。 步骤7： 借助主机侧的工具，以及对端的听筒和麦克风，观察上下行语音链路是否正常，测试方法参 考第 3.2 章。 3.2. 测试语音链路 Windows 和 Linux 侧需要借助不同的工具测试语音链路是否正常。使用模块打通电话时，待接通被叫 手机后，按照下述方式，分别测试 Windows 和 Linux 的语音链路。 3.2.1. Windows 侧 步骤1： 选择声卡。 上海移远通信技术股份有限公司 图 3：选择声卡 13 / 15 EP06&EG06&EM06 系列 UAC 应用指导 步骤2： 使用工具 Audacity 进行语音的录音和播放。使用 Audacity 可以录入下行链路的语音，然后使 用 Audacity 的播放功能，将录入的下行链路音频播放到上行链路。如果手机扬声器播放的音 频与麦克风采集的音频一致，则通过测试。工具 Audacity 如下图所示： 图 4：工具 Audacity 3.2.2. Linux 侧 在 Linux 侧，可以使用 aplay 或者 arecord 工具测试录音和播音功能。首先查看用于播放或录音的 PCM 设备。执行如下命令： # ls /dev/snd/ by-id by-path controlC1 pcmC1D0c pcmC1D0p seq # cat /proc/asound/pcm 01-00: USB Audio : USB Audio : playback 1 : capture 1 timer 从命令的返回值可以得知，用于录音的设备为 pcmC1D0c，用于播放音频的设备为 pcmC1D0p。 步骤1： 使用 arecord 录入下行语音数据到 test.wav 文件中，执行命令如下： arecord test.wav -D hw:1,0 -f S16_LE 步骤2： 使用 aplay 播放 test.wav 到上行链路中，执行命令如下： aplay test.wav -D hw:1,0 -r 8000 如果手机端的扬声器播放的音频与麦克风采集的音频一致，则通过测试。 上海移远通信技术股份有限公司 14 / 15 EP06&EG06&EM06 系列 UAC 应用指导 4 附录 术语缩写 表 2：术语缩写 术语 ADB DSP NMEA PCM PID TA UAC USB VID 英文全称 Android Debug Bridge Digital Signal Processing NMEA (National Marine Electronics Association) 0183 Interface Standard Pulse Code Modulation Product ID Terminal Adapter USB Audio Class Universal Serial Bus Vendor ID 中文全称 安卓调试桥 数字信号处理技术 NMEA （ 美 国 国 家 海 洋 电 子 协 会 ） 0183 接口标准 脉冲编码调制 产品标识符 终端适配器 USB 音频子类 通用串行总线 供应商标识符 上海移远通信技术股份有限公司 15 / 15

EP06&EG06&EM06 系列 SAR 功率回退应用指导 LTE-A 模块系列 版本：1.0 日期：2022-11-22 状态：受控文件 EP06&EG06&EM06 系列 SAR 功率回退应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 文档历史 修订记录 版本 1.0 日期 2022-09-28 2022-11-22 作者 Kevin LI Kevin LI 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 AT 命令详解 ........................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句 ..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. 功率回退 AT 命令详解 ................................................................................................................. 8 2.3.1. AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 ............................................ 8 2.3.2. AT+QCFG='sarcfg' 设置 WCDMA/LTE 频段的 SAR 功率回退值 ................................. 9 3 示例 ...................................................................................................................................................... 12 4 附录 术语缩写...................................................................................................................................... 13 上海移远通信技术股份有限公司 4 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：术语缩写 ........................................................................................................................................... 13 上海移远通信技术股份有限公司 5 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 1 引言 本文档介绍了如何通过 AT 命令在 WCDMA/LTE 网络下实现 LTE-A EP06、EG06 和 EM06 系列模块的 功率回退功能。 上海移远通信技术股份有限公司 6 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见，也不 代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或连续 性。 2.3. 功率回退 AT 命令详解 2.3.1. AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 该命令用于设置 WCDMA/LTE 网络下 SAR 功率回退等级。 AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 测试命令 AT+QSAR=? 响应 +QSAR: (支持的范围),(支持的列表) 查询命令 AT+QSAR? OK 或者 ERROR 响应 +QSAR: 设置命令 AT+QSAR=[,] 最大响应时间 特性说明 OK 或者 ERROR 响应 OK 或者 ERROR 500 毫秒 该命令立即生效； 决定功率回退后参数配置是否保存。 参数 整型。WCDMA/LTE 网络下 SAR 功率回退等级。范围：0~8。 0 禁用功率回退功能 1–8 WCDMA/LTE 网络下功率回退等级 level1~level8。 整型。是否将参数配置保存至 NVM。 上海移远通信技术股份有限公司 8 / 13 0 不保存 1 保存 EP06&EG06&EM06 系列 SAR 功率回退应用指导 2.3.2. AT+QCFG='sarcfg' 设置 WCDMA/LTE 频段的 SAR 功率回退值 该命令用于设置 WCDMA/LTE 频段的 SAR 功率回退值。 AT+QCFG='sarcfg' 设置 WCDMA/LTE 频段的 SAR 功率回退值 设置命令 AT+QCFG='sarcfg'[,[,,,]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'sarcfg','lte_wcdma',,, … OK 若省略、和，则查询指定 RAT 的当前配置： [+QCFG: 'sarcfg','lte_wcdma',,, […]] OK 若省略可选参数，则设置 WCDMA/LTE 频段的 SAR 发送功率： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 字符串类型。无线接入技术。 'lte_wcdma' LTE 和 WCDMA 'lte' LTE 'wcdma' WCDMA 整型。最大 SAR 等级对应的功率回退值。该值应该被设置为 10 的倍数。范围： 60~300。单位：0.1 dBm。 整型。相邻 SAR 等级（level1~level8）之间的功率回退差值。该值应该被设置为 10 的倍数且小于。单位：0.1 dBm。 上海移远通信技术股份有限公司 9 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 Backoff level(n) = Backoff level(n-1) - 整型。具体参数值参考。 字符串类型。对应的 WCDMA/LTE 支持的频段。 WCDMA: 1 WCDMA B1 2 WCDMA B2 3 WCDMA B3 4 WCDMA B4 5 WCDMA B5 8 WCDMA B8 9 WCDMA B9 11 WCDMA B11 19 WCDMA B19 LTE: 1 LTE B1 2 LTE B2 3 LTE B3 4 LTE B4 5 LTE B5 6 LTE B6 7 LTE B7 8 LTE B8 9 LTE B9 10 LTE B10 11 LTE B11 12 LTE B12 13 LTE B13 14 LTE B14 17 LTE B17 18 LTE B18 19 LTE B19 20 LTE B20 21 LTE B21 23 LTE B23 25 LTE B25 26 LTE B26 27 LTE B27 28 LTE B28 30 LTE B30 34 LTE B34 38 LTE B38 39 LTE B39 40 LTE B40 41 LTE B41 上海移远通信技术股份有限公司 10 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 42 LTE B42 43 LTE B43 66 LTE B66 备注 1. Backoff level(n) 是 level(n) 的 SAR 功率回退值。n 的取值范围为 2~8。 2. 当-*level(n)<0 时，Backoff level(n)等于 Backoff 。 level(n-1) 3. 在 LTE 和 WCDMA 网络下，Backoff 到 level(1) Backoff level(8)分别对应 230 到 160。 = 230， = 10。单位：0.1dBm。 4. 所有模块均不支持 WCDMA B9、B11 和 LTE B6、B9、B10、B11、B14、B17、B21、B23、B27、 B34、B39、B42、B43 频段。 上海移远通信技术股份有限公司 11 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 3 示例 //查询 LTE 频段的功率回退值 AT+QCFG='sarcfg','lte' +QCFG: 'sarcfg','lte_wcdma',LTE B1,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B2,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B4,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B5,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B8,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B9,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B12,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B13,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B14,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B18,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B19,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B20,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B25,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B26,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B30,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B38,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B38K,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B39,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B40B,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B41B,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B41C,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B66,230,10 OK //设置 LTE 频段的 SAR 功率回退值 AT+QCFG='sarcfg','lte',230,10,1 OK //设置 SAR 功率回退等级为 1 AT+QSAR=1 OK 上海移远通信技术股份有限公司 12 / 13 EP06&EG06&EM06 系列 SAR 功率回退应用指导 4 附录 术语缩写 表 2：术语缩写 缩写 LTE NVM RAT SAR TA WCDMA 英文全称 Long Term Evolution Non-Volatile Memory Radio Access Technology Specific Absorption Rate Terminal Adapter Wideband Code Division Multiple Access 中文全称 长期演进 非易失性存储器 无线接入技术 比吸收率 终端适配器 宽带码分多址 上海移远通信技术股份有限公司 13 / 13

EM12&EG12&EG18 系列 UAC 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-12-12 状态：受控文件 EM12&EG12&EG18 系列 UAC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 EM12&EG12&EG18 系列 UAC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 15 EM12&EG12&EG18 系列 UAC 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2022-09-22 Shaun DUAN 文档创建 1.0 2022-12-12 Shaun DUAN 受控版本 上海移远通信技术股份有限公司 3 / 15 EM12&EG12&EG18 系列 UAC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. UAC 功能简介 ............................................................................................................................ 7 1.1.1. USB 声卡驱动.................................................................................................................. 7 1.1.2. PCM 数据转发和语音通话............................................................................................... 8 2 AT 命令详解 .......................................................................................................................................... 9 2.1. AT 命令说明................................................................................................................................ 9 2.1.1. 定义 ................................................................................................................................. 9 2.1.2. AT 命令语句 .................................................................................................................... 9 2.2. AT 示例声明.............................................................................................................................. 10 2.3. AT+QCFG='usbcfg' 配置 USB 复合功能 .............................................................................. 10 2.4. AT+QPCMV 启用/禁用语音数据转发功能 ..............................................................................11 3 UAC 功能测试 ..................................................................................................................................... 13 3.1. 测试步骤 ................................................................................................................................... 13 3.2. 测试语音链路............................................................................................................................ 13 3.2.1. Windows 侧 ................................................................................................................... 13 3.2.2. Linux 侧 ......................................................................................................................... 14 4 附录 术语缩写..................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 EM12&EG12&EG18 系列 UAC 应用指导 表格索引 表 4：AT 命令类型........................................................................................................................................ 9 表 2：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 EM12&EG12&EG18 系列 UAC 应用指导 图片索引 图 1：语音数据流示意图 .............................................................................................................................. 7 图 2：加载 USB 声卡.................................................................................................................................... 8 图 3：选择声卡 ........................................................................................................................................... 13 图 4：工具 Audacity ................................................................................................................................... 14 上海移远通信技术股份有限公司 6 / 15 EM12&EG12&EG18 系列 UAC 应用指导 1 引言 本文档介绍移远通信 EG12 系列、EG18 系列和 EM12-G 模块的 UAC 功能，包含 AT 命令、设计方案 及功能测试。 1.1. UAC 功能简介 UAC（USB Audio Class 1.0）是 USB 规范中的音频协议类。该功能由三个部分组成，分别为 UAC 驱 动、PCM 数据转发和语音通话。在 UAC 模式下，模块被识别为主机设备中的 USB 声卡。标准的第三方音 频库（如 alsa-lib）可用于在 Linux 侧录制或者播放音频数据，某些第三方工具（Audacity）如也可用于在 Windows 上录制或播放音频数据。 在语音呼叫状态下，模块通过空中接口获取语音数据。DSP 将数据解码为语音 PCM 流，然后通过 USB总线将 PCM 流传输到主机设备。因此，主机设备中的音频应用可以通过 USB 声卡获得 PCM 数 据，并传输到扬声器。相反的，主机设备可以将通过麦克风获取的语音数据编码为 PCM 流，并播放到 USB 声卡中，模块将 PCM 数据经过 DSP 编码后发送到空中接口。 主机 Windows/Linux 录制 播放 模块 UAC USB UAC 语音 转发 语音 服务 RF 手机 麦克 风 扬声 器 下行链路音频数据 上行链路音频数据 图 1：语音数据流示意图 1.1.1. USB 声卡驱动 UAC 功能的实现需要主机侧支持 UAC 驱动。移远通信不提供主机侧的 UAC 驱动，请自行开发。模块 开启 UAC 后，主机侧会自动加载 USB 声卡。一般情况下，Windows 10 系统包含 USB 声卡驱动，用户可 自行安装使用。 上海移远通信技术股份有限公司 7 / 15 以 EG18-EA 模块为例，Windows 侧显示如下： EM12&EG12&EG18 系列 UAC 应用指导 图 2：加载 USB 声卡 Linux 系统显示如下： $ aplay -l **** List of PLAYBACK Hardware Devices **** card 1: EG18EA [EG18-EA], device 0: USB Audio [USB Audio] Subdevices: 0/1 Subdevice #0: subdevice #0 1.1.2. PCM 数据转发和语音通话 使能 UAC 功能后，模块在主机端会被识别为 USB 声卡设备，主机端可以使用 alsa-lib 等第三方库进行 音频数据的录音或者播放。基于 USB 声卡驱动的语音通话，主机端可以捕获下行语音链路的音频数据或者 播放音频数据到上行语音链路，即可在主机端进行二次开发，在主机端上实现语音通话功能。 上海移远通信技术股份有限公司 8 / 15 EM12&EG12&EG18 系列 UAC 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ 回车符。 ⚫ 换行符。 ⚫ 参数名称。实际命令行中不包含尖括号。 ⚫ […] 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 ⚫ 下划线 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 15 EM12&EG12&EG18 系列 UAC 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见，也不 代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或连续 性。 2.3. AT+QCFG='usbcfg' 配置 USB 复合功能 该命令用于配置模块的 USB 复合功能。 AT+QCFG='usbcfg' 配置 USB 复合功能 设置命令 AT+QCFG='usbcfg'[,,,,,,,, ,] 响应 若省略可选参数，查询当前配置： +QCFG: 'usbcfg',,,,,,,,, OK 最大响应时间 特性说明 若指定可选参数，配置 USB 复合功能： OK 或者 ERROR 300 毫秒 该命令重启后生效； 自动保存参数配置。 参数 十六进制整型。USB 设备的供应商 ID。最大值：0xFFFF。 十六进制整型。USB 设备的产品 ID。最大值：0xFFFF。 整型。USB DIAG 端口状态。 0 禁用 1 启用 整型。USB NMEA 端口状态。 0 禁用 1 启用 整型。USB AT 端口状态。 0 禁用 1 启用 整型。USB Modem 端口状态。 0 禁用 上海移远通信技术股份有限公司 10 / 15 1 启用 整型。USB 网络设备状态。 0 禁用 1 启用 整型。USB ADB 设备状态。 0 禁用 1 启用 整型。UAC 状态。 0 禁用 1 启用 EM12&EG12&EG18 系列 UAC 应用指导 2.4. AT+QPCMV 启用/禁用语音数据转发功能 该命令用于启用或禁用语音数据转发功能。启用该功能后，拨打电话时，来自对方的语音数据将被模 块解码为 PCM 数据，然后通过已设置的 USB 端口输出到设备。同时，设备将 PCM 数据写入 USB 端口， 数据将通过网络传输到呼叫设备的另一端。当呼叫结束时，没有任何数据要输出，输入的数据无效。 AT+QPCMV 启用/禁用语音数据转发功能 测试命令 AT+QPCMV=? 响应 +QPCMV: (支持的列表),(支持的列表) 查询命令 AT+QPCMV? OK 响应 +QPCMV: [,] 设置命令 AT+QPCMV=[,] 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。启用或禁用语音数据转发功能。 0 禁用 1 启用 整型。配置 PCM 数据传输的端口。 2 UAC 模式，将模块作为 USB 声卡使用 上海移远通信技术股份有限公司 11 / 15 备注 使用语音数据转发功能，必须先开启 UAC 功能。 EM12&EG12&EG18 系列 UAC 应用指导 上海移远通信技术股份有限公司 12 / 15 EM12&EG12&EG18 系列 UAC 应用指导 3 UAC 功能测试 本章节主要介绍 UAC 功能的测试步骤和方法。 3.1. 测试步骤 步骤1： 执行 AT+QCFG='usbcfg'，查询模块的 VID 和 PID。 步骤2： 执行 AT+QCFG='usbcfg',,,1,1,1,1,1,0,1 开启 UAC 功能； 步骤3： 重启模块。 步骤4： 观察主机的 USB 声卡是否加载完成。 步骤5： 执行 AT+QPCMV=1,2 启用 UAC 模式； 步骤6： 执行 ATD;（表示电话号码），开始拨打电话。 步骤7： 借助主机侧的工具，以及对端的扬声器和麦克风，观察上下行语音链路是否正常，测试方法 参 考第 3.2 章。 3.2. 测试语音链路 Windows 和 Linux 侧需要借助不同的工具测试语音链路是否正常。使用模块打通电话时，待接通被叫 手机后，按照下述方式，分别测试 Windows 和 Linux 的语音链路。 3.2.1. Windows 侧 步骤1： 选择声卡。 上海移远通信技术股份有限公司 图 3：选择声卡 13 / 15 EM12&EG12&EG18 系列 UAC 应用指导 步骤2： 使用工具 Audacity 进行语音的录音和播放。使用 Audacity 可以录入下行链路的语音，然后使 用 Audacity 的播放功能，将录入的下行链路音频播放到上行链路。如果手机扬声器播放的音 频与麦克风采集的音频一致，则通过测试。工具 Audacity 如下图所示： 图 4：工具 Audacity 3.2.2. Linux 侧 在 Linux 侧，可以使用 aplay 或者 arecord 工具测试录音和播音功能。首先查看用于播放或录音的 PCM 设备。执行如下命令： # ls /dev/snd/ by-id by-path controlC1 pcmC1D0c pcmC1D0p seq # cat /proc/asound/pcm 01-00: USB Audio : USB Audio : playback 1 : capture 1 timer 从命令的返回值可以得知，用于录音的设备为 pcmC1D0c，用于播放音频的设备为 pcmC1D0p。 步骤1： 使用 arecord 录入下行语音数据到 test.wav 文件中，执行命令如下： arecord test.wav -D hw:1,0 -f S16_LE 步骤2： 使用 aplay 播放 test.wav 到上行链路中，执行命令如下： aplay test.wav -D hw:1,0 -r 8000 如果手机端的扬声器播放的音频与麦克风采集的音频一致，则通过测试。 上海移远通信技术股份有限公司 14 / 15 EM12&EG12&EG18 系列 UAC 应用指导 4 附录 术语缩写 表 2：术语缩写 术语 ADB DSP NMEA PCM PID TA UAC USB VID 英文全称 Android Debug Bridge Digital Signal Processing NMEA (National Marine Electronics Association) 0183 Interface Standard Pulse Code Modulation Product ID Terminal Adapter USB Audio Class Universal Serial Bus Vendor ID 中文全称 安卓调试桥 数字信号处理技术 NMEA （ 美 国 国 家 海 洋 电 子 协 会 ） 0183 接口标准 脉冲编码调制 产品标识符 终端适配器 USB 音频子类 通用串行总线 供应商标识符 上海移远通信技术股份有限公司 15 / 15

EM12&EG12&EG18 系列 SAR 功率回退应用指导 LTE-A 模块系列 版本：1.0 日期：2022-11-22 状态：受控文件 EM12&EG12&EG18 系列 SAR 功率回退应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 文档历史 修订记录 版本 1.0 日期 2022-09-28 2022-11-22 作者 Kevin LI Kevin LI 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 AT 命令详解 ........................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句 ..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. SAR 功率回退 AT 命令详解......................................................................................................... 8 2.3.1. AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 ............................................ 8 2.3.2. AT+QCFG='sarcfg' 设置 WCDMA/LTE 频段的 SAR 功率回退值 ................................. 9 3 示例 ...................................................................................................................................................... 12 4 附录 术语缩写...................................................................................................................................... 13 上海移远通信技术股份有限公司 4 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：术语缩写 ........................................................................................................................................... 13 上海移远通信技术股份有限公司 5 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 1 引言 本文档介绍了如何通过 AT 命令在 WCDMA/LTE 网络下实现 LTE-A 模块 EG12 系列、EG18 系列和 EM12-G 的 SAR 功率回退功能。 上海移远通信技术股份有限公司 6 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见，也不 代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或连续 性。 2.3. SAR 功率回退 AT 命令详解 2.3.1. AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 该命令用于设置 WCDMA/LTE 网络下 SAR 功率回退等级。 AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 测试命令 AT+QSAR=? 响应 +QSAR: (支持的范围),(支持的列表) 查询命令 AT+QSAR? OK 或者 ERROR 响应 +QSAR: 设置命令 AT+QSAR=[,] 最大响应时间 特性说明 OK 或者 ERROR 响应 OK 或者 ERROR 500 毫秒 该命令立即生效； 决定功率回退后参数配置是否保存。 参数 整型。WCDMA/LTE 网络下 SAR 功率回退等级。范围：0~8。 0 禁用功率回退功能 1–8 WCDMA/LTE 网络下功率回退等级 level1~level8。 整型。是否将参数配置保存至 NVM。 上海移远通信技术股份有限公司 8 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 0 不保存 1 保存 2.3.2. AT+QCFG='sarcfg' 设置 WCDMA/LTE 频段的 SAR 功率回退值 该命令用于设置 WCDMA/LTE 频段的 SAR 功率回退值。 AT+QCFG='sarcfg' 设置 WCDMA/LTE 频段的 SAR 功率回退值 设置命令 AT+QCFG='sarcfg'[,[,,,]] 响应 若省略可选参数，则查询当前配置： +QCFG: 'sarcfg','lte_wcdma',,, … OK 若省略、和，则查询指定 RAT 的当前配置： [+QCFG: 'sarcfg','lte_wcdma',,, […]] OK 若指定任意可选参数，则设置 WCDMA/LTE 频段的 SAR 功率回 退值： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 字符串类型。无线接入技术。 'lte_wcdma' WCDMA 和 LTE 'lte' LTE 'wcdma' WCDMA 整型。最大 SAR 等级对应的功率回退值。该值应该被设置为 10 的倍数。范围： 60~300。单位：0.1 dBm。 整型。相邻 SAR 等级（level1~level8）之间的功率回退差值。该值应该被设置为 10 的倍数且小于。单位：0.1 dBm。 上海移远通信技术股份有限公司 9 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 Backoff level(n) = Backoff level(n-1) - 整型。具体参数值参考。 字符串类型。对应的 WCDMA/LTE 支持的频段。 WCDMA: 1 WCDMA B1 2 WCDMA B2 3 WCDMA B3 4 WCDMA B4 5 WCDMA B5 8 WCDMA B8 9 WCDMA B9 11 WCDMA B11 19 WCDMA B19 LTE: 1 LTE B1 2 LTE B2 3 LTE B3 4 LTE B4 5 LTE B5 6 LTE B6 7 LTE B7 8 LTE B8 9 LTE B9 10 LTE B10 11 LTE B11 12 LTE B12 13 LTE B13 14 LTE B14 17 LTE B17 18 LTE B18 19 LTE B19 20 LTE B20 21 LTE B21 23 LTE B23 25 LTE B25 26 LTE B26 27 LTE B27 28 LTE B28 30 LTE B30 34 LTE B34 38 LTE B38 39 LTE B39 40 LTE B40 41 LTE B41 上海移远通信技术股份有限公司 10 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 42 LTE B42 43 LTE B43 66 LTE B66 备注 1. Backoff level(n) 是 level(n) 的 SAR 功率回退值。n 的取值范围为 2~8。 2. 当 - × level(n) < 0 时，Backoff level(n)等于 Backoff 。 level(n-1) 3. 在 LTE 和 WCDMA 网络下，默认 Backoff 到 level(1) Backoff level(8)分别对应 230 到 160。 = 230， = 10。单位：0.1dBm。 4. 所有模块均不支持 WCDMA B11 和 LTE B6、B10、B11、B23、B27、B34、B42、B43、B66 频段。 上海移远通信技术股份有限公司 11 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 3 示例 //查询 LTE 频段的功率回退值 AT+QCFG='sarcfg','lte' +QCFG: 'sarcfg','lte_wcdma',LTE B1,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B2,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B4,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B5,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B8,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B9,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B12,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B13,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B14,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B18,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B19,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B20,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B25,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B26,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B30,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B38,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B38K,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B39,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B40B,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B41B,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B41C,230,10 +QCFG: 'sarcfg','lte_wcdma',LTE B66,230,10 OK //设置 LTE 频段的 SAR 功率回退值 AT+QCFG='sarcfg','lte',230,10,1 OK //设置 SAR 功率回退等级为 1 AT+QSAR=1 OK 上海移远通信技术股份有限公司 12 / 13 EM12&EG12&EG18 系列 SAR 功率回退应用指导 4 附录 术语缩写 表 2：术语缩写 缩写 DSI LTE NVM RAT SAR TA WCDMA 英文全称 Device State Index Long Term Evolution Non-Volatile Memory Radio Access Technology Specific Absorption Rate Terminal Adapter Wideband Code Division Multiple Access 中文全称 设备状态索引 长期演进 非易失性存储器 无线接入技术 比吸收率 终端适配器 宽带码分多址 上海移远通信技术股份有限公司 13 / 13

EG512R&EM12xR&EM160R 系列 UAC 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-12-12 状态：受控文件 EG512R&EM12xR&EM160R 系列 UAC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同 时，您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分 析、评估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同 意，尽管移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在 '可用'基础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文 档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问 性、安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2022-09-22 Shaun DUAN 文档创建 1.0 2022-12-12 Shaun DUAN 受控版本 上海移远通信技术股份有限公司 3 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 1.2. UAC 功能简介 ............................................................................................................................ 7 1.2.1. USB 声卡驱动.................................................................................................................. 8 1.2.2. PCM 数据转发和语音通话............................................................................................... 9 2 AT 命令详解 ........................................................................................................................................ 10 2.1. AT 命令说明.............................................................................................................................. 10 2.1.1. 定义 ............................................................................................................................... 10 2.1.2. AT 命令语句................................................................................................................... 10 2.2. AT 示例声明...............................................................................................................................11 2.3. AT+QCFG='usbcfg' 配置 USB 复合功能.................................................................................11 2.4. AT+QPCMV 启用/禁用语音数据转发功能............................................................................... 12 3 UAC 功能测试 ..................................................................................................................................... 13 3.1. 测试步骤 ................................................................................................................................... 13 3.2. 测试语音链路............................................................................................................................ 13 3.2.1. Windows 侧 ................................................................................................................... 13 3.2.2. Linux 侧 ......................................................................................................................... 14 4 附录 术语缩写...................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型...................................................................................................................................... 10 表 3：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 图片索引 图 1：语音数据流示意图 .............................................................................................................................. 8 图 2：加载 USB 声卡.................................................................................................................................... 8 图 3：选择声卡 ........................................................................................................................................... 13 图 4：工具 Audacity ................................................................................................................................... 14 上海移远通信技术股份有限公司 6 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 1 引言 本文档介绍移远通信 EG512R-EA、EM120R-GL、EM121R-GL 和 EM160R-GL 模块的 UAC 功能， 包含 AT 命令、设计方案及功能测试。 1.1. 适用模块 表 1：适用模块 适用模块 EG512R EM12xR EM160R EG512R-EA EM120R-GL EM121R-GL EM160R-GL 1.2. UAC 功能简介 UAC（USB Audio Class 1.0）是 USB 规范中的音频协议类。该功能由三个部分组成，分别为 UAC 驱动、PCM 数据转发和语音通话。在 UAC 模式下，模块被识别为主机设备中的 USB 声卡。标准的第三 方音频库（如 alsa-lib）可用于在 Linux 侧录制或者播放音频数据，某些第三方工具（如 Audacity）也可用 于在 Windows 上录制或播放音频数据。 在语音呼叫状态下，模块通过空中接口获取语音数据。DSP 将数据解码为语音 PCM 流，然后通过 USB 总线将 PCM 流传输到主机设备。因此，主机设备中的音频应用可以通过 USB 声卡获得 PCM 数 据，并传输到扬声器。相反的，主机设备可以将通过麦克风获取的语音数据编码为 PCM 流，并播放到 USB 声卡中，模块将PCM 数据经过 DSP 编码后发送到空中接口。 上海移远通信技术股份有限公司 7 / 15 主机 Windows/Linux 录制 播放 EG512R&EM12xR&EM160R 系列 UAC 应用指导 模块 UAC USB UAC 语音 转发 语音 服务 RF 手机 麦克 风 扬声 器 下行链路音频数据 上行链路音频数据 图 1：语音数据流示意图 1.2.1. USB 声卡驱动 UAC 功能的实现需要主机侧支持 UAC 驱动。移远通信不提供主机侧的 UAC 驱动，请自行开发。模 块开启 UAC 后，主机侧会自动加载 USB 声卡。一般情况下，Windows 10 系统包含 USB 声卡驱动，用户 可自行安装使用。 以 EG512R-EA 模块为例，Windows 侧显示如下： 图 2：加载 USB 声卡 上海移远通信技术股份有限公司 8 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 Linux 系统显示如下： $ aplay -l **** List of PLAYBACK Hardware Devices **** card 1: EG512REA [EG512R-EA], device 0: USB Audio [USB Audio] Subdevices: 0/1 Subdevice #0: subdevice #0 1.2.2. PCM 数据转发和语音通话 使能 UAC 功能后，模块在主机端会被识别为 USB 声卡设备，主机端可以使用 alsa-lib 等第三方库进 行音频数据的录音或者播放。基于 USB 驱动的语音通话，主机端可以捕获下行语音链路的音频数据或者 播放音频数据到上行语音链路，即可在主机端进行二次开发，在主机端上实现语音通话功能。 上海移远通信技术股份有限公司 9 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说 明，配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意 见，也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接 关系或连续性。 2.3. AT+QCFG='usbcfg' 配置 USB 复合功能 该命令用于配置模块的 USB 复合功能。 AT+QCFG='usbcfg' 配置 USB 复合功能 设置命令 AT+QCFG='usbcfg'[,,,,,,,, ,] 响应 若省略可选参数，查询当前配置： +QCFG: 'usbcfg',,,,,,,,, OK 最大响应时间 特性说明 若指定可选参数，配置 USB 复合功能： OK 或者 ERROR 300 毫秒 该命令重启后生效； 自动保存参数配置。 参数 十六进制整型。USB 设备的供应商 ID。最大值：0xFFFF。 十六进制整型。USB 设备的产品 ID。最大值：0xFFFF。 整型。USB DIAG 端口状态。 0 禁用 1 启用 整型。USB NMEA 端口状态。 0 禁用 1 启用 整型。USB AT 端口状态。 0 禁用 1 启用 整型。USB Modem 端口状态。 0 禁用 1 启用 整型。USB 网络设备状态。 0 禁用 上海移远通信技术股份有限公司 11 / 15 1 启用 整型。USB ADB 设备状态。 0 禁用 1 启用 整型。UAC 状态。 0 禁用 1 启用 EG512R&EM12xR&EM160R 系列 UAC 应用指导 2.4. AT+QPCMV 启用/禁用语音数据转发功能 该命令用于启用或禁用语音数据转发功能。启用该功能后，拨打电话时，来自对方的语音数据将被模 块解码为 PCM 数据，然后通过已设置的 USB 端口输出到设备。同时，设备将 PCM 数据写入 USB 端 口，数据将通过网络传输到呼叫设备的另一端。当呼叫结束时，没有任何数据要输出，输入的数据无效。 AT+QPCMV 启用/禁用语音数据转发功能 测试命令 AT+QPCMV=? 响应 +QPCMV: (支持的列表),(支持的列表) 查询命令 AT+QPCMV? OK 响应 +QPCMV: [,] 设置命令 AT+QPCMV=[,] 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。启用或禁用语音数据转发功能。 0 禁用 1 启用 整型。配置 PCM 数据传输的端口。 2 UAC 模式，将模块作为 USB 声卡使用 备注 使用语音数据转发功能，必须先开启 UAC 功能。 上海移远通信技术股份有限公司 12 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 3 UAC 功能测试 本章节主要介绍 UAC 功能的测试步骤和方法。 3.1. 测试步骤 步骤1： 执行 AT+QCFG='usbcfg'，查询模块的 VID 和 PID。 步骤2： 执行 AT+QCFG='usbcfg',,,1,1,1,1,1,0,1 开启 UAC 功能； 步骤3： 重启模块。 步骤4： 观察主机的 USB 声卡是否加载完成。 步骤5： 执行 AT+QPCMV=1,2 启用 UAC 模式； 步骤6： 执行 ATD;（表示电话号码），开始拨打电话。 步骤7： 借助主机侧的工具，以及对端的扬声器和麦克风，观察上下行语音链路是否正常，测试方法 参 考第 3.2 章。 3.2. 测试语音链路 Windows 和 Linux 侧需要借助不同的工具测试语音链路是否正常。使用模块打通电话时，待接通被叫 手机后，按照下述方式，分别测试 Windows 和 Linux 的语音链路。 3.2.1. Windows 侧 步骤1： 选择声卡。 上海移远通信技术股份有限公司 图 3：选择声卡 13 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 步骤2： 使用工具 Audacity 进行语音的录音和播放。使用 Audacity 可以录入下行链路的语音，然后 使用 Audacity 的播放功能，将录入的下行链路音频播放到上行链路。如果手机扬声器播放的 音频与麦克风采集的音频一致，则通过测试。工具 Audacity 如下图所示： 图 4：工具 Audacity 3.2.2. Linux 侧 在 Linux 侧，可以使用 aplay 或者 arecord 工具测试录音和播音功能。首先查看用于播放或录音的 PCM 设备。执行如下命令： # ls /dev/snd/ by-id by-path controlC1 pcmC1D0c pcmC1D0p seq timer # cat /proc/asound/pcm 01-00: USB Audio : USB Audio : playback 1 : capture 1 从命令的返回值可以得知，用于录音的设备为 pcmC1D0c，用于播放音频的设备为 pcmC1D0p。 步骤1： 使用 arecord 录入下行语音数据到 test.wav 文件中，执行命令如下： arecord test.wav -D hw:1,0 -f S16_LE 步骤2： 使用 aplay 播放 test.wav 到上行链路中，执行命令如下： aplay test.wav -D hw:1,0 -r 8000 如果手机端的扬声器播放的音频与麦克风采集的音频一致，则通过测试。 上海移远通信技术股份有限公司 14 / 15 EG512R&EM12xR&EM160R 系列 UAC 应用指导 4 附录 术语缩写 表 3：术语缩写 术语 ADB DSP NMEA PCM PID TA UAC USB VID 英文全称 Android Debug Bridge Digital Signal Processing NMEA (National Marine Electronics Association) 0183 Interface Standard Pulse Code Modulation Product ID Terminal Adapter USB Audio Class Universal Serial Bus Vendor ID 中文全称 安卓调试桥 数字信号处理技术 NMEA （ 美 国 国 家 海 洋 电 子 协 会 ） 0183 接口标准 脉冲编码调制 产品标识符 终端适配器 USB 音频子类 通用串行总线 供应商标识符 上海移远通信技术股份有限公司 15 / 15

EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 LTE-A 模块系列 版本：1.0 日期：2022-11-22 状态：受控文件 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 文档历史 修订记录 版本 1.0 日期 2022-09-28 2022-11-22 作者 Kevin LI Kevin LI 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 2 AT 命令详解 ........................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句 ..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. SAR 功率回退 AT 命令详解......................................................................................................... 8 2.3.1. AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 ............................................ 8 2.3.2. AT+QCFG='SAR_DSI' 设置 WCDMA/LTE 频段的 SAR 功率回退值 ........................... 9 3 示例 ...................................................................................................................................................... 12 4 附录 术语缩写...................................................................................................................................... 13 上海移远通信技术股份有限公司 4 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 7 表 3：术语缩写 ........................................................................................................................................... 13 上海移远通信技术股份有限公司 5 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 1 引言 本文档介绍了如何通过 AT 命令在 WCDMA/LTE 网络下实现移远通信 LTE-A EG060K 系列、EG065K 系列、EG120K 系列、EM120K-GL 和 EM060K 系列模块的功率回退功能。 1.1. 适用模块 表 1：适用模块 模块系列 EG06xK Ex120K EM060K 模块 EG060K 系列 EG065K 系列 EG120K 系列 EM120K-GL EM060K 系列 上海移远通信技术股份有限公司 6 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见，也不 代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或连续 性。 2.3. SAR 功率回退 AT 命令详解 2.3.1. AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 该命令用于设置 WCDMA/LTE 网络下 SAR 功率回退等级。 AT+QSAR 设置 WCDMA/LTE 网络下 SAR 功率回退等级 测试命令 AT+QSAR=? 响应 +QSAR: (支持的范围),(支持的列表) 查询命令 AT+QSAR? OK 或者 ERROR 响应 +QSAR: 设置命令 AT+QSAR=[,] 最大响应时间 特性说明 OK 或者 ERROR 响应 OK 或者 ERROR 500 毫秒 该命令立即生效； 决定功率回退后参数配置是否保存。 参数 整型。WCDMA/LTE 网络下 SAR 功率回退等级。范围：0~8。 0 禁用功率回退功能 1–8 WCDMA/LTE 网络下功率回退等级。对应设备状态索引 1~8（参考第 2.3.2 章）。 整型。是否将参数配置保存至 NVM。 0 不保存 上海移远通信技术股份有限公司 8 / 13 1 保存 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 2.3.2. AT+QCFG='SAR_DSI' 设置 WCDMA/LTE 频段的 SAR 功率回退值 该命令用于设置 WCDMA/LTE 频段的 SAR 功率回退值。 AT+QCFG='SAR_DSI' 设置 WCDMA/LTE 频段的 SAR 功率回退值 设置命令 AT+QCFG='SAR_DSI',[,,,,,,,,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'SAR_DSI',,,,,,,,,, … OK 最大响应时间 特性说明 若指定可选参数，设置 WCDMA/LTE 频段的 SAR 功率回退值： OK 或者 ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 字符串类型。无线接入技术。 'lte_wcdma' LTE 和 WCDMA 'lte' LTE 'wcdma' WCDMA 整型。具体参数值参考。 字符串类型。对应的 LTE/WCDMA 频段。 WCDMA: 1 WCDMA B1 2 WCDMA B2 3 WCDMA B3 4 WCDMA B4 5 WCDMA B5 8 WCDMA B8 9 WCDMA B9 11 WCDMA B11 上海移远通信技术股份有限公司 9 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 19 LTE: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 17 18 19 20 21 23 25 26 27 28 30 34 38 39 40 41 42 43 46 47 48 66 WCDMA B19 LTE B1 LTE B2 LTE B3 LTE B4 LTE B5 LTE B6 LTE B7 LTE B8 LTE B9 LTE B10 LTE B11 LTE B12 LTE B13 LTE B14 LTE B17 LTE B18 LTE B19 LTE B20 LTE B21 LTE B23 LTE B25 LTE B26 LTE B27 LTE B28 LTE B28B LTE B30 LTE B34 LTE B38 LTE B38K LTE B39 LTE B40 LTE B40B LTE B41 LTE B41B LTE B41C LTE B42 LTE B43 LTE B46 LTE B47 LTE B48 LTE B66 上海移远通信技术股份有限公司 10 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 71 LTE B71 LTE B71B 250 LTE B250 整型。DSI1（设备状态索引号 1）对应的功率回退值。该值应该被设置为 10 的倍数。 范围：60~300；默认值：230；单位：0.1 dBm。 整型。DSI2（设备状态索引号 2）对应的功率回退值。该值应该被设置为 10 的倍数。 范围：60~300；默认值：220；单位：0.1 dBm。 整型。DSI3（设备状态索引号 3）对应的功率回退值。该值应该被设置为 10 的倍数。 范围：60~300；默认值：210；单位：0.1 dBm。 整型。DSI4（设备状态索引号 4）对应的功率回退值。该值应该被设置为 10 的倍数。 范围：60~300；默认值：200；单位：0.1 dBm。 整型。DSI5（设备状态索引号 5）对应的功率回退值。该值应该被设置为 10 的倍数。 范围：60~300；默认值：190；单位：0.1 dBm。 整型。DSI6（设备状态索引号 6）对应的功率回退值。该值应该被设置为 10 的倍数。 范围：60~300；默认值：180；单位：0.1 dBm。 整型。DSI7（设备状态索引号 7）对应的功率回退值。该值应该被设置为 10 的倍数。 范围：60~300；默认值：170；单位：0.1 dBm。 整型。DSI8（设备状态索引号 8）对应的功率回退值。该值应该被设置为 10 的倍数。 范围：60~300；默认值：160；单位：0.1 dBm。 备注 所有模块均不支持 WCDMA B9、B11 和 LTE B6、B9、B10、B11、B21、B23、B27、B46、B47、B250 频段。 上海移远通信技术股份有限公司 11 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 3 示例 //查询 WCDMA/LTE 频段的功率回退值 AT+QCFG='SAR_DSI','lte_wcdma' +QCFG: 'SAR_DSI','lte_wcdma',LTE B1,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B3,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B5,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B7,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B8,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B20,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B28,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B38,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B40,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',LTE B41,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',WCDMA B1,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',WCDMA B3,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',WCDMA B5,200,110,230,230,230,230,230,230 +QCFG: 'SAR_DSI','lte_wcdma',WCDMA B8,200,110,230,230,230,230,230,230 OK //设置 LTE B1 的 SAR 功率回退值 AT+QCFG='SAR_DSI','lte',1,200,110,200,240,230,190,230,230 OK //设置 SAR 功率回退等级为 1 AT+QSAR=1 OK 上海移远通信技术股份有限公司 12 / 13 EG06xK&Ex120K&EM060K 系列 SAR 功率回退应用指导 4 附录 术语缩写 表 3：术语缩写 缩写 DSI LTE NVM RAT SAR TA WCDMA 英文全称 Device State Index Long Term Evolution Non-Volatile Memory Radio Access Technology Specific Absorption Rate Terminal Adapter Wideband Code Division Multiple Access 中文全称 设备状态索引 长期演进 非易失性存储器 无线接入技术 比吸收率 终端适配器 宽带码分多址 上海移远通信技术股份有限公司 13 / 13

RGx00U&RM500U 系列 双卡双待应用指导 5G 模块系列 版本：1.0 日期：2024-04-18 状态：受控文件 RGx00U&RM500U 系列双卡双待应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 13 RGx00U&RM500U 系列双卡双待应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 13 RGx00U&RM500U 系列双卡双待应用指导 文档历史 修订记录 版本 1.0 日期 2023-10-24 2024-04-18 作者 Polo YE Polo YE 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 13 RGx00U&RM500U 系列双卡双待应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 双卡双待使用介绍 .................................................................................................................................. 7 3 双卡双待使用示例 .................................................................................................................................. 8 3.1. (U)SIM 卡切换 PDP 拨号方案 ..................................................................................................... 8 3.2. PDP 激活/去激活示例.................................................................................................................. 8 3.2.1. 方案一............................................................................................................................... 8 3.2.2. 方案二............................................................................................................................. 10 4 附录 参考文档及术语缩写 ................................................................................................................... 13 上海移远通信技术股份有限公司 4 / 13 RGx00U&RM500U 系列双卡双待应用指导 表格索引 表 1：(U)SIM 卡槽与通道映射表.................................................................................................................. 7 表 2：参考文档 ........................................................................................................................................... 13 表 3：术语缩写 ........................................................................................................................................... 13 上海移远通信技术股份有限公司 5 / 13 RGx00U&RM500U 系列双卡双待应用指导 1 引言 移远通信 5G RG200U 系列、RG500U 系列和 RM500U 系列模块支持双卡双待功能。模块设计了 AT 通道和 Modem 通道，本文档主要介绍如何操作(U)SIM 卡 1 和(U)SIM 卡 2 查询注网信息和进行 PDP 拨号 等功能。 备注 1. 因为模块仅使用一套射频，所以模块只支持双卡双待单通，不支持两张(U)SIM 卡同时进行数据业务， 即一张(U)SIM 卡在通话时，另一张(U)SIM 卡无法进行数据或语音业务，但(U)SIM 卡 1 和(U)SIM 卡 2 可时分复用。 2. 双卡双待功能需要固件支持，模块不支持通过 AT 命令打开或关闭双卡双待功能。 上海移远通信技术股份有限公司 6 / 13 RGx00U&RM500U 系列双卡双待应用指导 2 双卡双待使用介绍 双卡双待功能不支持通过 AT 命令开启或关闭。对于需要区分不同(U)SIM 卡的 AT 命令，Linux 系统主 控可以参考下述映射表（表 1）的对应关系打开相应的设备节点发送 AT 命令；Windows 系统主控需要驱动 支持双 AT 和 Modem 口，并使用对应的通道发送 AT 命令。有关 AT 命令的详解，请参考文档 [1]。 表 1：(U)SIM 卡槽与通道映射表 (U)SIM 卡槽 (U)SIM 卡 1 (U)SIM 卡 2 AT 口 /dev/ttyUSB2 /dev/ttyUSB5 Modem 口 /dev/ttyUSB3 /dev/ttyUSB6 上海移远通信技术股份有限公司 7 / 13 RGx00U&RM500U 系列双卡双待应用指导 3 双卡双待使用示例 此章节以激活 PDP 进行拨号为例，介绍模块如何使用双(U)SIM 卡进行相关业务。由于模块只支持双 卡双待单通，因此不能同时使用两张(U)SIM 卡进行数据业务。(U)SIM 卡 1 和(U)SIM 卡 2 不能使用同一路 PDP 同时拨号。 3.1. (U)SIM 卡切换 PDP 拨号方案 (U)SIM 卡 1 拨号后切换到(U)SIM 卡 2 进行拨号，可通过如下两种方案： 方案一：两张(U)SIM 卡使用同一路 PDP 进行拨号。 此方案的优点是步骤少，操作相对简单。但由于切换到另一张(U)SIM 卡进行 PDP 拨号前需要先断开 当前(U)SIM 卡的 PDP 拨号，因此切换花费的时间较长，适用于对切换场景没有时长要求的场景。 方案二：两张(U)SIM 卡使用不同路 PDP 进行拨号。 (U)SIM 卡 1 使用第一路 PDP 拨号，(U)SIM 卡 2 使用第二路 PDP 拨号，该场景下可以先进行双卡拨 号，拨号成功后，上位机建立起两路网卡。在需要切换使用两张(U)SIM 卡时，上位机通过切换目标卡槽的 数据通路和将对应网卡添加到路由表的默认路由中实现切换(U)SIM 卡进行数据业务。 方案二相对方案一对上位机操作要求较高，用户操作较为复杂，但由于两张(U)SIM 卡在进行切换前已 完成 PDP 拨号，因此切换花费的时间很短，适用于对切换时长要求高的场景。 3.2. PDP 激活/去激活示例 3.2.1. 方案一 //(U)SIM 卡 1 AT 口或 modem 口 AT+COPS? +COPS: 0,0,'CHN-UNICOM',11 OK AT+CGDCONT? 上海移远通信技术股份有限公司 //查询(U)SIM 卡 1 的注网信息 //查询(U)SIM 卡 1 的 APN 信息 8 / 13 RGx00U&RM500U 系列双卡双待应用指导 +CGDCONT: 1,'IPV4V6','3gnet','0.0.0.0',0,0,0,0,,,,,,0,,,0,,0,0,0,0 +CGDCONT: 11,'IPV4V6','ims','0.0.0.0',0,0,0,0,,,,,,0,,,0,,0,0,0,0 OK AT+QENG='servingcell' //查询(U)SIM 卡 1 的服务小区信息 +QENG:'servingcell','NOCONN','NR5G-SA','TDD',460,01,6909DB083,747,690E0F,633984,78,10 0,-73,-3,17,0,43,1 OK AT+QNETDEVCTL=1,1,1 OK //(U)SIM 卡 1 使用第一路 PDP 激活拨号 +QNETDEVSTATUS: 1,1,'IPV4V6',0 //(U)SIM 卡 1 使用第一路 PDP 激活拨号成功 AT+QNETDEVSTATUS=1 //查询(U)SIM 卡 1 的第一路网卡状态 +QNETDEVSTATUS: 10.248.13.149,255.255.255.0,10.248.13.1,,218.104.78.2,58.242.2.2,2408:8444:0580:273d:0000:0000: 0000:0001,,,,2408:8000:c000:0000:0000:0000:0000:8888,2408:8000:c004:0000:0000:0000:0000:888 8 OK AT+QNETDEVCTL=1,2,0 OK +QNETDEVSTATUS: 1,0,'IPV4V6',0 AT+QNETDEVSTATUS=1 +CME ERROR: 3 //(U)SIM 卡 2 AT 口或 modem 口 AT+COPS? +COPS: 0,0,'CHINA MOBILE',7 //(U)SIM 卡 1 的第一路 PDP 去激活 //(U)SIM 卡 1 的第一路 PDP 已去激活 //查询去激活后(U)SIM 卡 1 的第一路网卡状态 //查询(U)SIM 卡 2 的注网信息 OK AT+CGDCONT? //查询(U)SIM 卡 2 的 APN 信息 +CGDCONT: 1,'IPV4V6','cmnet','0.0.0.0',0,0,0,0,,,,,,0,,,0,,0,0,0,0 +CGDCONT: 11,'IPV4V6','ims','0.0.0.0',0,0,0,2,,,,,,0,,,0,,0,0,0,0 OK AT+QENG='servingcell' //查询(U)SIM 卡 2 的服务小区信息 +QENG: 'servingcell','NOCONN','LTE','TDD',460,00,F2D4A52,214,38950,40,5,5,550B,-97,-5,-73,9,0,0,28 OK AT+QNETDEVCTL=1,1,1 OK //(U)SIM 卡 2 使用第一路 PDP 激活拨号 上海移远通信技术股份有限公司 9 / 13 RGx00U&RM500U 系列双卡双待应用指导 +QNETDEVSTATUS: 1,1,'IPV4V6',0 //(U)SIM 卡 2 的第一路 PDP 已激活 AT+QNETDEVSTATUS=1 +QNETDEVSTATUS: 10.201.48.42,255.255.255.0,10.201.48.1,,211.138.180.4,211.138.180.5,2409:8930:04a3:5627:721a:23 14:0a99:e7c9,,,,2409:8030:2000:0000:0000:0000:0000:0003,2409:8030:2000:0000:0000:0000:0000: 0004 OK AT+QNETDEVCTL=1,2,0 OK //(U)SIM 卡 2 的第一路 PDP 去激活 +QNETDEVSTATUS: 1,0,'IPV4V6',0 AT+QNETDEVSTATUS=1 +CME ERROR: 3 //(U)SIM 卡 2 的第一路 PDP 已去激活 3.2.2. 方案二 //进行 USB 多网卡配置 AT+QCFG='nat',0 OK AT+QCFG='usbnet',5 OK AT+QCFG='multiusbnet',2,0 OK //重启模块使配置生效 //(U)SIM 卡 1 AT 口或 modem 口 AT+COPS? +COPS: 0,0,'CHN-UNICOM',11 //配置拨号模式为网卡模式 //配置网卡拨号方式及驱动类型为 NCM //开启 NCM 网卡多路拨号。 //查询(U)SIM 卡 1 的注网信息 OK AT+QENG='servingcell' //查询(U)SIM 卡 1 的服务小区信息 +QENG: 'servingcell','NOCONN','NR5G-SA','TDD',460,01,6909DB083,747,690E0F,633984,78,100,-73,-3, 17,0,43,1 OK AT+QNETDEVCTL=1,1,1 OK //(U)SIM 卡 1 使用第一路 PDP 激活拨号 +QNETDEVSTATUS: 1,1,'IPV4V6',0 AT+QNETDEVSTATUS=1 //(U)SIM 卡 1 使用第一路 PDP 激活拨号成功 //查询(U)SIM 卡 1 的第一路网卡状态 上海移远通信技术股份有限公司 10 / 13 RGx00U&RM500U 系列双卡双待应用指导 +QNETDEVSTATUS: 10.163.150.149,255.255.255.0,10.163.150.1,,218.104.78.2,58.242.2.2,2408:8444:0580:273d:0000:00 00:0000:0001,,,,2408:8000:c000:0000:0000:0000:0000:8888,2408:8000:c004:0000:0000:0000:0000: 8888 OK //(U)SIM 卡 2 AT 口或 modem 口 AT+COPS? +COPS: 0,0,'CHINA MOBILE',7 //查询(U)SIM 卡 2 的注网信息 OK AT+QENG='servingcell' //查询(U)SIM 卡 2 的服务小区信息 +QENG: 'servingcell','NOCONN','LTE','TDD',460,00,F2D4A52,214,38950,40,5,5,550B,-97,-5,-73,9,0,0,28 OK AT+QNETDEVCTL=2,1,1 OK //(U)SIM 卡 2 使用第二路 PDP 激活拨号 +QNETDEVSTATUS: 2,1,'IPV4V6',0 //(U)SIM 卡 2 的第二路 PDP 已激活 AT+QNETDEVSTATUS=2 //查询(U)SIM 卡 2 的第二路网卡状态 +QNETDEVSTATUS:10.213.36.7,255.255.255.0,10.213.36.1,,218.104.78.2,58.242.2.2,2409:8930:04a 3:5627:721a:2314:0a99:e7c9,,,,2409:8030:2000:0000:0000:0000:0000:0003,2409:8030:2000:0000:0 000:0000:0000:0004 OK 上述操作完成后，在上位机执行 ifconfig 查看当前网卡的 IP 地址。如下图所示，上位机建立了两路网 卡拨号。 上海移远通信技术股份有限公司 11 / 13 RGx00U&RM500U 系列双卡双待应用指导 如果需要使用(U)SIM 卡 1 进行数据业务，上位机可通过/dev/ttyUSB2 节点发送 AT+QCFG='datasim' （详见文档 [1]）至 modem 切换目标卡槽的数据通路。同时检查上位机的默认路由与(U)SIM 卡 1 拨号建 立的网卡是否对应。如果是对应的，上位机可以直接进行数据业务；如果不是对应的，则需要先执行 route del defalut 删除默认路由，再执行 route add default gw 10.163.150.1 添加默认路由。 如果需要使用(U)SIM 卡 2 进行数据业务，上位机可通过/dev/ttyUSB5 节点发送 AT+QCFG='datasim' （详见文档 [1]）至 modem 切换目标卡槽的数据通路。同时检查上位机的默认路由与(U)SIM 卡 2 拨号建 立的网卡是否对应。如果是对应的，上位机可以直接进行数据业务；如果不是对应的，则需要先执行 route del defalut 删除默认路由，再执行 route add default gw 10.213.36.1 添加默认路由。 上海移远通信技术股份有限公司 12 / 13 RGx00U&RM500U 系列双卡双待应用指导 4 附录 参考文档及术语缩写 表2：参考文档 文档名称 [1] Quectel_RGx00U&RM500U 系列_AT 命令手册 表3：术语缩写 缩写 英文全称 APN IP LTE Access Point Name Internet Protocol Long-Term Evolution PDP RF Packet Data Protocol Radio Frequency (U)SIM (Universal) Subscriber Identity Module 中文全称 接入点名称 互联网协议 长期演进 分组数据协议 射频 （全球）用户身份模块 上海移远通信技术股份有限公司 13 / 13

ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 LTE Standard 模块系列 版本：1.0 日期：2022-08-02 状态：受控文件 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 文档历史 修订记录 版本 1.0 日期 2022-03-08 2022-08-02 作者 Ford ZHANG Ford ZHANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 2 相关 AT 命令 .......................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句 ..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. AT 命令详解................................................................................................................................. 8 2.3.1. AT+QWIFISCAN 设置 Wi-Fi Scan 参数......................................................................... 8 3 附录 术语缩写...................................................................................................................................... 11 上海移远通信技术股份有限公司 4 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 7 表 3：术语缩写 ............................................................................................................................................11 上海移远通信技术股份有限公司 5 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 1 引言 本文档介绍了 Wi-Fi Scan 功能相关的 AT 命令。本文档主要适用于移远通信 ECx00M-CN、EC200x 系 列、EC600N-CN 和 EG91xN 系列模块。 1.1. 适用模块 表 1：适用模块 模块系列 ECx00M EC200x EC600N EG91xN 模块 EC200M-CN EC600M-CN EC800M-CN EC200S 系列 EC200N-CN EC600N-CN EG912N-EN EG915N 系列 上海移远通信技术股份有限公司 6 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 2 相关 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QWIFISCAN 设置 Wi-Fi Scan 参数 该命令用于设置 Wi-Fi Scan 参数。 AT+QWIFISCAN 设置 Wi-Fi Scan 参数 测试命令 AT+QWIFISCAN=? 响应 +QWIFISCAN: (支持的范围),(支持的范 围),(支持的范围),(支持的范围),(支持的列表) 查询命令 AT+QWIFISCAN? OK 响应 +QWIFISCAN: ,,,, 设置命令 AT+QWIFISCAN[=[,[,[,[,]]]]] OK 响应 若参数配置成功，则上报扫描结果： OK +QWIFISCAN: ,,,, OK 若无 Wi-Fi 热点： OK +QWIFISCAN:TIMEOUT 若设置参数取值不在支持的范围内： +CME ERROR: 50 若设置参数个数大于 5： 上海移远通信技术股份有限公司 8 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 最大响应时间 特性说明 ERROR 13秒 该命令立即生效； 参数配置不保存。 参数 整型。扫描超时时间。如超过时间没有扫描结果，则会报错。范围：4000~255000； 默认值：12000；单位：毫秒。 整型。Wi-Fi Scan 的轮数。范围：1~3；默认值：1。 整型。期望扫描到的 Wi-Fi 热点个数。范围：4~10；默认值：5。 整型。Wi-Fi Scan 的 RRC 轮询超时时间。范围：0~255；默认值：5；单位：秒。 整型。Wi-Fi Scan 优先参数。 0 数据优先 1 Wi-Fi Scan 优先 Wi-Fi 热点加密方法。该参数暂不支持，固定值为'-'。 接入 Wi-Fi 热点的名称。该参数暂不支持，固定值为'-'。 整型。Wi-Fi 热点的信号强度。单位：dBm。 字符串类型。Wi-Fi 热点信号的 MAC 地址。 整型。Wi-Fi 热点使用的信道。范围：1~13。 备注 1. 参数、、、、省略时为默认值。 2. 参数指定上报 MAC 地址的数量。例如： 1) 设置 Wi-Fi Scan 的轮数为 1，期望扫描到的 Wi-Fi 热点个数为 5，如扫描到 5 个以上 MAC 地 址，则只上报 5 个 MAC 地址。如扫描到的 MAC 地址少于 5 个，则会上报此时扫描到的全部 MAC 地址。 2) 设置 Wi-Fi Scan 的轮数为 3，期望扫描到的 Wi-Fi 热点个数为 10，如第一轮扫描到 10 个或更 多 MAC 地址，则会上报 10 个 MAC 地址，且不再进行第二、三轮扫描。如第一轮扫描到 5 个 MAC 地址，扫描将继续；第二轮扫描到 3 个 MAC 地址，扫描依然继续；第三轮扫描到 6 个 MAC 地址，则会报告 3 轮扫描结果（5 + 3 + 6）个 MAC 地址；如第一轮和第二轮扫描到的总 数超过 10 个 MAC 地址，则不会进行第三轮扫描。如果有重复的 MAC 地址，将会减去重复的 数据。 举例 AT+QWIFISCAN OK +QWIFISCAN: (-,-,-30,'1C:20:DB:8D:D7:80',1) 上海移远通信技术股份有限公司 9 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 +QWIFISCAN: (-,-,-30,'1C:20:DB:8D:D7:81',1) +QWIFISCAN: (-,-,-55,'1C:20:DB:8D:C2:81',1) +QWIFISCAN: (-,-,-61,'44:00:4D:D5:26:01',1) +QWIFISCAN: (-,-,-68,'A4:00:E2:EF:F8:80',1) OK AT+QWIFISCAN=12000,1,6,5,0 OK +QWIFISCAN: (-,-,-35,'1C:20:DB:8D:D7:80',1) +QWIFISCAN: (-,-,-35,'1C:20:DB:8D:D7:81',1) +QWIFISCAN: (-,-,-58,'60:38:E0:C5:A6:49',6) +QWIFISCAN: (-,-,-63,'A4:00:E2:EF:F8:81',1) +QWIFISCAN: (-,-,-66,'44:00:4D:D5:26:00',1) +QWIFISCAN: (-,-,-70,'44:00:4D:D5:23:60',6) OK //无 Wi-Fi 热点情况下进行扫描 AT+QWIFISCAN OK +QWIFISCAN:TIMEOUT 上海移远通信技术股份有限公司 10 / 11 ECx00M&EC200x&EC600N&EG91xN 系列 Wi-Fi Scan 应用指导 3 附录 术语缩写 表 3：术语缩写 缩写 MAC RRC RSSI 英文全称 Medium Access Control Radio Resource Control Received Signal Strength Indicator 中文全称 媒体访问控制 无线资源控制 接收信号强度指示 上海移远通信技术股份有限公司 11 / 11

LTE Standard(A)系列 FILE 应用指导 LTE Standard 模块系列 版本：1.4 日期：2023-04-21 状态：受控文件 LTE Standard(A)系列 FILE 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 27 LTE Standard(A)系列 FILE 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 27 LTE Standard(A)系列 FILE 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 1.4 日期 2020-08-20 2021-04-09 2022-02-25 2022-07-25 2023-04-21 作者 变更表述 Wayne WEI 初始版本 Wayne WEI 增加文档适用模块 EC200N-CN 和 EC600N-CN。 Wayne WEI Chaim QIAN Amos YAO 1. 增 加 文 档 适 用 模 块 EC200A 系 列 、 EC800N-CN 和 EG915N-EU。 2. 删除 EG912Y-CN 模块。 1. 新增适用模块 EC200M-CN、EC600M-CN、EC800M-CN、 EG912N-EN 和 EG915N-LA。 2. 删除适用模块 EC200T 系列。 3. 更新 SD 卡支持模块为 EC200A 系列（第 1 章）。 1. 新增适用模块 EG810M-CN 和 EG950A-EL；删除适用模 块 EC600S-CN。 2. 新增 EG950A-EL 模块支持 SD 卡备注信息（第 1 章）。 上海移远通信技术股份有限公司 3 / 27 LTE Standard(A)系列 FILE 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ................................................................................................................................. 6 1.2. FILE AT 命令使用流程............................................................................................................ 7 1.3. 数据模式说明 .......................................................................................................................... 8 2 FILE AT 命令详解 ................................................................................................................................. 9 2.1. AT 命令说明............................................................................................................................ 9 2.1.1. 定义 ................................................................................................................................. 9 2.1.2. AT 命令语句 .................................................................................................................... 9 2.2. AT 示例声明.......................................................................................................................... 10 2.3. AT 命令详解.......................................................................................................................... 10 2.3.1. AT+QFLDS 获取存储媒介空间信息............................................................................ 10 2.3.2. AT+QFLST 列出存储媒介中的文件信息..................................................................... 11 2.3.3. AT+QFDEL 删除存储媒介中的文件............................................................................ 13 2.3.4. AT+QFUPL 上传文件到存储媒介 ............................................................................... 14 2.3.5. AT+QFDWL 下载存储媒介中的文件........................................................................... 15 2.3.6. AT+QFOPEN 打开文件 .............................................................................................. 16 2.3.7. AT+QFREAD 读取文件 .............................................................................................. 17 2.3.8. AT+QFWRITE 写入数据至文件.................................................................................. 18 2.3.9. AT+QFSEEK 设置文件指针位置 ................................................................................ 19 2.3.10. AT+QFPOSITION 获取文件指针偏移量 ..................................................................... 20 2.3.11. AT+QFCLOSE 关闭文件 ............................................................................................ 21 3 举例 ..................................................................................................................................................... 22 3.1. 上传或下载文件 .................................................................................................................... 22 3.1.1. 上传文件 ........................................................................................................................ 22 3.1.1.1. 无 ACK 模式.......................................................................................................... 22 3.1.1.2. ACK 模式 .............................................................................................................. 22 3.1.2. 下载文件 ........................................................................................................................ 23 3.2. 写入和读取文件 .................................................................................................................... 23 3.2.1. 写入和读取 UFS 文件 .................................................................................................... 23 3.2.2. 写入和读取 SD 文件 ...................................................................................................... 24 4 错误代码 .............................................................................................................................................. 25 5 附录 术语缩写..................................................................................................................................... 27 上海移远通信技术股份有限公司 4 / 27 LTE Standard(A)系列 FILE 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 9 表 3：错误代码列表.................................................................................................................................... 25 表 4：术语缩写 ........................................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 27 LTE Standard(A)系列 FILE 应用指导 1 引言 本文档主要介绍了与 LTE Standard(A)系列模块相关的 AT 命令，这些命令可以指导用户在不同的物理 存储媒介上进行文件操作。 LTE Standard(A)系列模块支持的物理存储媒介如下： ⚫ UFS：用户文件存储目录。Flash 文件系统上的一个特殊目录。 ⚫ SD：SD 卡目录。（仅 EC200A 系列和 EG950A-EL 支持）。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N-CN EC200S 系列 EC600M-CN EC600N-CN EC800M-CN EC800N-CN EG810M-CN EG912N-EN EG912Y-EU EG915N 系列 EG950A-EL 上海移远通信技术股份有限公司 6 / 27 LTE Standard(A)系列 FILE 应用指导 备注 1. 文件名称表示存储位置。若文件名以 UFS:开头，则表示文件被存储在 UFS 中；若文件名以 SD:开 头，则表示文件被存储在 SD 卡中；若文件名无前缀，也表示文件被存储在 UFS 中。 2. LTE Standard(A)系列模块暂不支持物理存储媒介 RAM:随机存取存储器。 1.2. FILE AT 命令使用流程 用户可以参照以下步骤在存储媒介中创建，读取和写入文件： 第一步，通过 AT+QFUPL 上传文件至存储媒介，然后执行 AT+QFDWL 通过串行接口输出或下载文 件。 第二步，使用 AT+QFOPEN 打开文件后，可写入或读取此文件，直到文件被 AT+QFCLOSE 关闭。 ⚫ 使用 AT+QFOPEN 打开文件时，可以通过参数将文件设置为覆盖模式，只读模式或其他 模式（有关更多信息，可参考第 2.3.6 章）。打开文件后，会分配，之后可 以通过操作文件。 ⚫ 文件打开后，可从当前文件位置通过 AT+QFWRITE 写入数据至文件，通过 AT+QFREAD 读取文 件数据。 ⚫ 用户可通过 AT+QFSEEK 设置文件位置，执行 AT+QFPOSITION 查询当前文件位置。 ⚫ AT+QFCLOSE 用来关闭文件，文件关闭后，就无效了。 用户可以通过以下几个命令管理存储媒介中的文件： 1. AT+QFLDS：获取存储媒介空间信息。 2. AT+QFLST：列出存储媒介中的文件信息。 3. AT+QFDEL：删除存储媒介中的文件。 上海移远通信技术股份有限公司 7 / 27 LTE Standard(A)系列 FILE 应用指导 1.3. 数据模式说明 LTE Standard(A)系列模块的 COM 口有两种工作模式，一是 AT 命令模式，另一种为数据模式。AT 命 令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。 用户可以通过输入+++或拉高 DTR（需先设置 AT&D1）使 COM 口退出数据模式。为防止+++被误认 为是数据，用户在使用 COM 口之前应遵循以下标准： ⚫ 输入+++前 1 秒内不能输入其它任何数据。 ⚫ 必须在 1 秒内输入+++，并且不能输入其它任何数据。 ⚫ 输入+++后 1 秒内不能输入其它任何数据。 执行 AT+QFUPL、AT+QFDWL、AT+QFREAD 或 AT+QFWRITE 后，COM 口会进入数据模式。如 果用户通过+++或拉高 DTR 退出数据模式，在退出之前，会中断这些命令的执行。在这种情况下，COM 口 无法通过执行 ATO 重新进入数据模式。 上海移远通信技术股份有限公司 8 / 27 LTE Standard(A)系列 FILE 应用指导 2 FILE AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 27 LTE Standard(A)系列 FILE 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QFLDS 获取存储媒介空间信息 该命令用于获取指定存储媒介的空间信息。 AT+QFLDS 获取存储媒介空间信息 测试命令 AT+QFLDS=? 设置命令 AT+QFLDS= 响应 OK 响应 +QFLDS: , OK 执行命令 AT+QFLDS 若发生任何与 ME 功能有关的错误： +CME ERROR: 响应 返回 UFS 空间信息： +QFLDS: , 最大响应时间 特性说明 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。存储媒介类型。 'UFS' UFS 'SD' SD 卡 上海移远通信技术股份有限公司 10 / 27 LTE Standard(A)系列 FILE 应用指导 整型。的可用空间。 整型。的总空间。 整型。UFS 中所有文件大小。单位：字节。 整型。UFS 中的文件数量。 错误码。详情可参考第 4 章。 举例 AT+QFLDS='UFS' +QFLDS: 578847,917503 OK AT+QFLDS='SD' +QFLDS: 251920384,253132800 OK //查询 UFS 空间信息。 //查询 SD 卡空间信息。 2.3.2. AT+QFLST 列出存储媒介中的文件信息 该命令用于列出指定存储媒介中的单个或所有文件信息。 AT+QFLST 列出存储媒介中的文件信息 测试命令 AT+QFLST=? 设置命令 AT+QFLST= 响应 OK 响应 +QFLST: , [+QFLST: , […]] OK 执行命令 AT+QFLST 若发生任何与 ME 功能有关的错误： +CME ERROR: 响应 返回存储在 UFS 中所有文件的空间信息： +QFLST: , [+QFLST: , […]] OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 上海移远通信技术股份有限公司 11 / 27 LTE Standard(A)系列 FILE 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。列出的文件类型。 '*' 列出 UFS 中所有文件 '' 列出 UFS 中指定文件 'SD:*' 列出 SD 卡中所有文件 'SD:' 列出 SD 卡中指定文件 字符串类型。文件名称。 整型。文件大小。单位：字节。 错误码。详情可参考第 4 章。 举例 AT+QFLST='*' +QFLST: 'UFS:1k.txt',1024 +QFLST: 'UFS:2k.txt',2048 +QFLST: 'UFS:3k.txt',3072 OK AT+QFLST='SD:*' +QFLST: 'SD:1k.txt',1024 +QFLST: 'SD:10K.txt',10240 +QFLST: 'SD:100k.txt',102400 OK //列出 UFS 中所有文件。 //列出 SD 卡中所有文件。 备注 AT+QFLST 用于查询当前存储在 flash 中的文件的实际大小。使用 AT+QFWRITE 写入数据，若 AT+QFLST 无法直接查询文件大小，需要 AT+QFCLOSE 执行关闭文件后，再使用该命令查询文件大小。 上海移远通信技术股份有限公司 12 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.3. AT+QFDEL 删除存储媒介中的文件 该命令用于删除指定存储媒介中的单个或所有文件。 AT+QFDEL 删除存储媒介中的文件 测试命令 AT+QFDEL=? 响应 +QFDEL: 设置命令 AT+QFDEL= OK 响应 OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。删除的文件名称。最大长度为 80 字节。 '*' 删除 UFS 中所有文件（不删除目录） '' 删除 UFS 中指定的文件 'SD:*' 删除 SD 卡中所有文件（不删除目录） 'SD:' 删除 SD 卡中指定的文件 错误码。详情可参考第 4 章。 举例 AT+QFDEL='*' OK AT+QFDEL='UFS:1.txt' OK AT+QFDEL='SD:*' OK //删除 UFS 中所有文件（不删除目录）。 //删除 UFS 中的 1.txt 这个文件。 //删除 SD 卡中所有文件（不删除目录）。 上海移远通信技术股份有限公司 13 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.4. AT+QFUPL 上传文件到存储媒介 该命令用于上传文件到存储媒介，若上传的文件与存储媒介中的文件同名，则会上报错误。 执行设置命令并返回 CONNECT 后，模块会切换为数据模式。当上传的文件大小达到，或 达到时间内无数据输入，模块会自动退出数据模式。数据传输期间，用户可以通过执行+++或拉 高 DTR 使之退出数据模式，更多相关信息，可参考第 1.3 章。 AT+QFUPL 上传文件到存储媒介 测试命令 AT+QFUPL=? 响应 +QFUPL: [,(1-)[,(支持的范 围)[,(支持的列表)]]] 设置命令 AT+QFUPL=[,[, [,]]] OK 响应 CONNECT TA 切换为数据模式（即透传模式），可输入二进制文件数据。 当输入数据的总大小达到（单位：字节）时，TA 将 切换回命令模式： +QFUPL: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 参数 整型。的可用空间。有关详细信息，可参考第 2.3.1 章。 字符串类型。上传文件的名称。最大长度为 80 字节。 '' 上传至 UFS 中的文件名称 'SD:' 上传至 SD 卡中的文件名称 整型。预计上传的文件大小。默认值：10240；单位：字节。 整型。实际上传的文件大小。单位：字节。 整型。通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒；范围：1~65535。 整型。是否使用 ACK 模式。 0 默认关闭 ACK 模式 1 开启 ACK 模式 上海移远通信技术股份有限公司 14 / 27 LTE Standard(A)系列 FILE 应用指导 整型。上传数据的校验和。 错误码。详情可参考第 4 章。 备注 1. 推荐使用 DOS 8.3 文件名格式。 2. 是基于异或的 16 位校验和。 如果字符数为奇数，则将最后一个字符设置为高 8 位，将低 8 位设置为 0，然后使用 XOR 运算符计 算校验和。+++序列可使 TA 结束命令并切换到命令模式。之前上传的数据将保留在文件中。 3. 执行命令时，必须在返回 CONNECT 后输入数据。 4. 在硬件流控制不起作用时，ACK 模式可避免在上传大文件时数据丢失。ACK 模式的工作原理如下： 1）运行 AT+QFUPL=,,,1 启用 ACK 模式。 2）模块输出 CONNECT。 3）MCU 发送 1 KB 字节数据，模块响应 A。 4）MCU 接收 A，然后发送下一个 1 KB 字节数据。 5）重复第 3）和 4）步骤，直到传输完成。 2.3.5. AT+QFDWL 下载存储媒介中的文件 该命令用于从存储媒介中下载指定的文件。 AT+QFDWL 下载存储媒介中的文件 测试命令 AT+QFDWL=? 响应 +QFDWL: 设置命令 AT+QFDWL= OK 响应 CONNECT TA 切换为数据模式，可输出文件二进制数据。文件读取完后， TA 将切换回命令模式： +QFDWL: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 15 / 27 LTE Standard(A)系列 FILE 应用指导 参数 字符串类型。下载文件的名称。最大长度为 80 个字节。 '' 下载的 UFS 文件名称 'SD: ' 下载的 SD 文件名称 整型。已下载数据的大小。 整型。已下载数据的校验和。 错误码。详情可参考第 4 章。 备注 1. +++序列会使 TA 结束命令并切换到命令模式。 2. 是基于异或的 16 位校验和。 2.3.6. AT+QFOPEN 打开文件 该命令用于打开文件并获取命令中使用的文件句柄，相关命令如 AT+QFREAD、AT+QFWRITE、 AT+QFSEEK、AT+QFPOSITION 和 AT+QFCLOSE。 AT+QFOPEN 打开文件 测试命令 AT+QFOPEN=? 响应 +QFOPEN: [,(支持的范围)] 查询命令 AT+QFOPEN? OK 响应 +QFOPEN: ,, [+QFOPEN: ,, […]] 设置命令 AT+QFOPEN=[,] OK 响应 +QFOPEN: OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 16 / 27 LTE Standard(A)系列 FILE 应用指导 参数 字符串类型。打开的文件名称。最大长度为 80 字节。 '' 打开的 UFS 文件名称 'SD: ' 打开的 SD 文件名称 整型。文件句柄。数据类型为 4 字节。 整型。文件的打开模式。 0 若文件不存在，则会创建一个新文件；若文件存在，则直接打开文件。两种情 况中的文件皆可读写 1 若文件不存在，则会创建一个新文件；若文件存在，则清除并覆盖文件。两种 情况中的文件皆可读写 2 若文件存在，则作为只读文件直接打开；若文件不存在，则响应错误 错误码。详情可参考第 4 章。 备注 若文件存储在 SD 卡中，获取的默认从 20 开始以 1 依次递增。 2.3.7. AT+QFREAD 读取文件 该命令用于读取由文件句柄指定的文件数据。数据从文件指针的当前位置开始读取，文件指针属于文件 句柄。 AT+QFREAD 读取文件 测试命令 AT+QFREAD=? 响应 +QFREAD: [,] 设置命令 AT+QFREAD=[, ] OK 响应 CONNECT TA 切换到数据模式，当数据总大小超过（单位：字节） 时，TA 将切换回命令模式： OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 17 / 27 参数 LTE Standard(A)系列 FILE 应用指导 整型。需要操作的文件句柄。 整型。预计读取的文件长度，默认为文件长度。 整型。实际读取的文件长度。 错误码。详情可参考第 4 章。 2.3.8. AT+QFWRITE 写入数据至文件 该命令用于将数据写入到文件。数据从文件指针的当前位置开始写入，文件指针属于文件句柄。 AT+QFWRITE 写入数据至文件 测试命令 AT+QFWRITE=? 响应 +QFWRITE: [,[,]] 设置命令 AT+QFWRITE=[,[,]] OK 响应 CONNECT TA 切换到数据模式。当写入数据的总大小超过（单 位：字节）或写入时间超过，TA 将切换回命令模式： +QFWRITE: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。预计写入文件的长度，默认长度为 10 KB。此参数的最大值由 AT+QFUPL 的决定。 整型。通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒。 整型。实际写入数据的长度。 整型。文件总长度。 错误码。详情可参考第 4 章。 上海移远通信技术股份有限公司 18 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.9. AT+QFSEEK 设置文件指针位置 该 命 令 用 于 设 置 文 件 指 针 到 指 定 的 位 置 ， 可 以 决 定 这 些 命 令 的 初 始 位 置 ， 如 AT+QFREAD 、 AT+QFWRITE 和 AT+QFPOSITION。 AT+QFSEEK 设置文件指针位置 测试命令 AT+QFSEEK=? 响应 +QFSEEK: ,[,] 设置命令 AT+QFSEEK=,[, ] OK 响应 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。文件指针移动的字节数。 整型。文件指针移动模式。 0 文件初始位置 1 文件指针当前位置 2 文件最终位置 错误码。详情可参考第 4 章。 备注 1. 若为 0 且超过文件大小，执行此命令会返回 ERROR。 2. 若为 1 且总文件大小和当前位置的文件指针超过文件大小，执行此命令会返回 ERROR。 2. 若为 2，文件句柄将向前移动。 上海移远通信技术股份有限公司 19 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.10. AT+QFPOSITION 获取文件指针偏移量 该命令用于从文件初始位置获取文件指针的偏移量。 AT+QFPOSITION 获取文件指针偏移量 测试命令 AT+QFPOSITION=? 响应 +QFPOSITION: 设置命令 AT+QFPOSITION= OK 响应 +QFPOSITION: OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。从初始位置起文件指针的偏移量。 错误码。详情可参考第 4 章。 上海移远通信技术股份有限公司 20 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.11. AT+QFCLOSE 关闭文件 该命令用于关闭文件或结束对文件的操作。关闭文件后，文件句柄会被释放。除非通过 AT+QFOPEN 再次打开文件，否则不可再次使用文件句柄。 AT+QFCLOSE 关闭文件 测试命令 AT+QFCLOSE=? 响应 +QFCLOSE: 设置命令 AT+QFCLOSE= OK 响应 OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 错误码。详情可参考第 4 章。 上海移远通信技术股份有限公司 21 / 27 LTE Standard(A)系列 FILE 应用指导 3 举例 3.1. 上传或下载文件 3.1.1. 上传文件 3.1.1.1. 无 ACK 模式 AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK //上传 test1.txt 文本文件到 UFS。 3.1.1.2. ACK 模式 ACK 模式下传输数据更可靠。在无硬件流控情况下传输大文件时，推荐开启 ACK 模式避免数据丢失。 有关 ACK 模式的详细信息，可参考 AT+QFUPL。 AT+QFUPL='test.txt',3000,5,1 CONNECT A A +QFUPL: 3000,B34A //上传文本文件 test.txt 到 UFS。 //接收 1024 字节数据后，模块会响应 A。然后输入下一个 1024 字节数据。 OK 上海移远通信技术股份有限公司 22 / 27 3.1.2. 下载文件 AT+QFDWL='test.txt' CONNECT +QFDWL: 10,613e OK LTE Standard(A)系列 FILE 应用指导 //从 UFS 中下载文本文件 test.txt。 //获取已下载数据的字节数与校验和值。 3.2. 写入和读取文件 3.2.1. 写入和读取 UFS 文件 AT+QFOPEN='test.txt',1 +QFOPEN: 1 OK AT+QFWRITE=1,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=1,0,0 OK AT+QFREAD=1,10 CONNECT OK AT+QFCLOSE=1 OK //打开文件获取文件指针。 //将 10 个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取数据。 //关闭文件。 上海移远通信技术股份有限公司 23 / 27 3.2.2. 写入和读取 SD 文件 AT+QFOPEN='SD:1.txt',1 +QFOPEN: 20 OK AT+QFWRITE=20,1024 CONNECT +QFWRITE: 1024,1024 OK AT+QFSEEK=20,0,0 OK AT+QFREAD=20,1024 CONNECT OK AT+QFCLOSE=20 OK LTE Standard(A)系列 FILE 应用指导 //打开文件获取文件指针。 //将 10 个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取数据。 //关闭文件。 上海移远通信技术股份有限公司 24 / 27 LTE Standard(A)系列 FILE 应用指导 4 错误代码 表示与本文档适用模块的文件操作有关的错误码，详细信息可参考下表。 表 3：错误代码列表 错误码 400 401 402 403 405 406 407 409 410 411 413 414 416 417 418 419 420 英文含义 中文含义 Invalid input value 输入值无效 Larger than the size of the file 文件过大 Read zero byte 读取 0 字节 Drive full 驱动器已满 File not found 未发现文件 Invalid file name 无效文件名 File already exists 文件已存在 Fail to write the file 写入文件失败 Fail to open the file 打开文件失败 Fail to read the file 读取文件失败 Reach the max. number of files allowed to be opened 达到允许打开的最大文件数 The file read-only 文件仅可读 Invalid file descriptor 无效文件描述符 Fail to list the file 列举文件失败 Fail to delete the file 删除文件失败 Fail to get disk info 获取磁盘信息失败 No space 空间不足 上海移远通信技术股份有限公司 25 / 27 421 Time out 423 File too large 425 Invalid parameter 426 File already opened LTE Standard(A)系列 FILE 应用指导 超时 文件过大 无效参数 文件已打开 上海移远通信技术股份有限公司 26 / 27 LTE Standard(A)系列 FILE 应用指导 5 附录 术语缩写 表 4：术语缩写 缩写 ACK COM DOS DTR ME RAM SD TA UART UFS USB XOR 英文全称 中文全称 Acknowledgement 确认字符 Communication Port 串行通讯端口 Disk Operating System 磁盘操作系统 Data Terminal Ready 数据终端就绪 Mobile Equipment 移动设备 Random Access Memory 随机存储器 Secure Digital 安全数字存储器 Terminal Adapter 终端适配器 Universal Asynchronous Receiver- 通用异步收发传输器 Transmitter User File Storage 用户文件存储 Universal Serial Bus 通用串行总线 Exclusive OR 异或 上海移远通信技术股份有限公司 27 / 27

LTE Standard(A)系列 FILE 应用指导 LTE Standard 模块系列 版本：1.4 日期：2023-04-21 状态：受控文件 LTE Standard(A)系列 FILE 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 27 LTE Standard(A)系列 FILE 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 27 LTE Standard(A)系列 FILE 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 1.4 日期 2020-08-20 2021-04-09 2022-02-25 2022-07-25 2023-04-21 作者 变更表述 Wayne WEI 初始版本 Wayne WEI 增加文档适用模块 EC200N-CN 和 EC600N-CN。 Wayne WEI Chaim QIAN Amos YAO 1. 增 加 文 档 适 用 模 块 EC200A 系 列 、 EC800N-CN 和 EG915N-EU。 2. 删除 EG912Y-CN 模块。 1. 新增适用模块 EC200M-CN、EC600M-CN、EC800M-CN、 EG912N-EN 和 EG915N-LA。 2. 删除适用模块 EC200T 系列。 3. 更新 SD 卡支持模块为 EC200A 系列（第 1 章）。 1. 新增适用模块 EG810M-CN 和 EG950A-EL；删除适用模 块 EC600S-CN。 2. 新增 EG950A-EL 模块支持 SD 卡备注信息（第 1 章）。 上海移远通信技术股份有限公司 3 / 27 LTE Standard(A)系列 FILE 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ................................................................................................................................. 6 1.2. FILE AT 命令使用流程............................................................................................................ 7 1.3. 数据模式说明 .......................................................................................................................... 8 2 FILE AT 命令详解 ................................................................................................................................. 9 2.1. AT 命令说明............................................................................................................................ 9 2.1.1. 定义 ................................................................................................................................. 9 2.1.2. AT 命令语句 .................................................................................................................... 9 2.2. AT 示例声明.......................................................................................................................... 10 2.3. AT 命令详解.......................................................................................................................... 10 2.3.1. AT+QFLDS 获取存储媒介空间信息............................................................................ 10 2.3.2. AT+QFLST 列出存储媒介中的文件信息..................................................................... 11 2.3.3. AT+QFDEL 删除存储媒介中的文件............................................................................ 13 2.3.4. AT+QFUPL 上传文件到存储媒介 ............................................................................... 14 2.3.5. AT+QFDWL 下载存储媒介中的文件........................................................................... 15 2.3.6. AT+QFOPEN 打开文件 .............................................................................................. 16 2.3.7. AT+QFREAD 读取文件 .............................................................................................. 17 2.3.8. AT+QFWRITE 写入数据至文件.................................................................................. 18 2.3.9. AT+QFSEEK 设置文件指针位置 ................................................................................ 19 2.3.10. AT+QFPOSITION 获取文件指针偏移量 ..................................................................... 20 2.3.11. AT+QFCLOSE 关闭文件 ............................................................................................ 21 3 举例 ..................................................................................................................................................... 22 3.1. 上传或下载文件 .................................................................................................................... 22 3.1.1. 上传文件 ........................................................................................................................ 22 3.1.1.1. 无 ACK 模式.......................................................................................................... 22 3.1.1.2. ACK 模式 .............................................................................................................. 22 3.1.2. 下载文件 ........................................................................................................................ 23 3.2. 写入和读取文件 .................................................................................................................... 23 3.2.1. 写入和读取 UFS 文件 .................................................................................................... 23 3.2.2. 写入和读取 SD 文件 ...................................................................................................... 24 4 错误代码 .............................................................................................................................................. 25 5 附录 术语缩写..................................................................................................................................... 27 上海移远通信技术股份有限公司 4 / 27 LTE Standard(A)系列 FILE 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 9 表 3：错误代码列表.................................................................................................................................... 25 表 4：术语缩写 ........................................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 27 LTE Standard(A)系列 FILE 应用指导 1 引言 本文档主要介绍了与 LTE Standard(A)系列模块相关的 AT 命令，这些命令可以指导用户在不同的物理 存储媒介上进行文件操作。 LTE Standard(A)系列模块支持的物理存储媒介如下： ⚫ UFS：用户文件存储目录。Flash 文件系统上的一个特殊目录。 ⚫ SD：SD 卡目录。（仅 EC200A 系列和 EG950A-EL 支持）。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N-CN EC200S 系列 EC600M-CN EC600N-CN EC800M-CN EC800N-CN EG810M-CN EG912N-EN EG912Y-EU EG915N 系列 EG950A-EL 上海移远通信技术股份有限公司 6 / 27 LTE Standard(A)系列 FILE 应用指导 备注 1. 文件名称表示存储位置。若文件名以 UFS:开头，则表示文件被存储在 UFS 中；若文件名以 SD:开 头，则表示文件被存储在 SD 卡中；若文件名无前缀，也表示文件被存储在 UFS 中。 2. LTE Standard(A)系列模块暂不支持物理存储媒介 RAM:随机存取存储器。 1.2. FILE AT 命令使用流程 用户可以参照以下步骤在存储媒介中创建，读取和写入文件： 第一步，通过 AT+QFUPL 上传文件至存储媒介，然后执行 AT+QFDWL 通过串行接口输出或下载文 件。 第二步，使用 AT+QFOPEN 打开文件后，可写入或读取此文件，直到文件被 AT+QFCLOSE 关闭。 ⚫ 使用 AT+QFOPEN 打开文件时，可以通过参数将文件设置为覆盖模式，只读模式或其他 模式（有关更多信息，可参考第 2.3.6 章）。打开文件后，会分配，之后可 以通过操作文件。 ⚫ 文件打开后，可从当前文件位置通过 AT+QFWRITE 写入数据至文件，通过 AT+QFREAD 读取文 件数据。 ⚫ 用户可通过 AT+QFSEEK 设置文件位置，执行 AT+QFPOSITION 查询当前文件位置。 ⚫ AT+QFCLOSE 用来关闭文件，文件关闭后，就无效了。 用户可以通过以下几个命令管理存储媒介中的文件： 1. AT+QFLDS：获取存储媒介空间信息。 2. AT+QFLST：列出存储媒介中的文件信息。 3. AT+QFDEL：删除存储媒介中的文件。 上海移远通信技术股份有限公司 7 / 27 LTE Standard(A)系列 FILE 应用指导 1.3. 数据模式说明 LTE Standard(A)系列模块的 COM 口有两种工作模式，一是 AT 命令模式，另一种为数据模式。AT 命 令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。 用户可以通过输入+++或拉高 DTR（需先设置 AT&D1）使 COM 口退出数据模式。为防止+++被误认 为是数据，用户在使用 COM 口之前应遵循以下标准： ⚫ 输入+++前 1 秒内不能输入其它任何数据。 ⚫ 必须在 1 秒内输入+++，并且不能输入其它任何数据。 ⚫ 输入+++后 1 秒内不能输入其它任何数据。 执行 AT+QFUPL、AT+QFDWL、AT+QFREAD 或 AT+QFWRITE 后，COM 口会进入数据模式。如 果用户通过+++或拉高 DTR 退出数据模式，在退出之前，会中断这些命令的执行。在这种情况下，COM 口 无法通过执行 ATO 重新进入数据模式。 上海移远通信技术股份有限公司 8 / 27 LTE Standard(A)系列 FILE 应用指导 2 FILE AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 27 LTE Standard(A)系列 FILE 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QFLDS 获取存储媒介空间信息 该命令用于获取指定存储媒介的空间信息。 AT+QFLDS 获取存储媒介空间信息 测试命令 AT+QFLDS=? 设置命令 AT+QFLDS= 响应 OK 响应 +QFLDS: , OK 执行命令 AT+QFLDS 若发生任何与 ME 功能有关的错误： +CME ERROR: 响应 返回 UFS 空间信息： +QFLDS: , 最大响应时间 特性说明 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。存储媒介类型。 'UFS' UFS 'SD' SD 卡 上海移远通信技术股份有限公司 10 / 27 LTE Standard(A)系列 FILE 应用指导 整型。的可用空间。 整型。的总空间。 整型。UFS 中所有文件大小。单位：字节。 整型。UFS 中的文件数量。 错误码。详情可参考第 4 章。 举例 AT+QFLDS='UFS' +QFLDS: 578847,917503 OK AT+QFLDS='SD' +QFLDS: 251920384,253132800 OK //查询 UFS 空间信息。 //查询 SD 卡空间信息。 2.3.2. AT+QFLST 列出存储媒介中的文件信息 该命令用于列出指定存储媒介中的单个或所有文件信息。 AT+QFLST 列出存储媒介中的文件信息 测试命令 AT+QFLST=? 设置命令 AT+QFLST= 响应 OK 响应 +QFLST: , [+QFLST: , […]] OK 执行命令 AT+QFLST 若发生任何与 ME 功能有关的错误： +CME ERROR: 响应 返回存储在 UFS 中所有文件的空间信息： +QFLST: , [+QFLST: , […]] OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 上海移远通信技术股份有限公司 11 / 27 LTE Standard(A)系列 FILE 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。列出的文件类型。 '*' 列出 UFS 中所有文件 '' 列出 UFS 中指定文件 'SD:*' 列出 SD 卡中所有文件 'SD:' 列出 SD 卡中指定文件 字符串类型。文件名称。 整型。文件大小。单位：字节。 错误码。详情可参考第 4 章。 举例 AT+QFLST='*' +QFLST: 'UFS:1k.txt',1024 +QFLST: 'UFS:2k.txt',2048 +QFLST: 'UFS:3k.txt',3072 OK AT+QFLST='SD:*' +QFLST: 'SD:1k.txt',1024 +QFLST: 'SD:10K.txt',10240 +QFLST: 'SD:100k.txt',102400 OK //列出 UFS 中所有文件。 //列出 SD 卡中所有文件。 备注 AT+QFLST 用于查询当前存储在 flash 中的文件的实际大小。使用 AT+QFWRITE 写入数据，若 AT+QFLST 无法直接查询文件大小，需要 AT+QFCLOSE 执行关闭文件后，再使用该命令查询文件大小。 上海移远通信技术股份有限公司 12 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.3. AT+QFDEL 删除存储媒介中的文件 该命令用于删除指定存储媒介中的单个或所有文件。 AT+QFDEL 删除存储媒介中的文件 测试命令 AT+QFDEL=? 响应 +QFDEL: 设置命令 AT+QFDEL= OK 响应 OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。删除的文件名称。最大长度为 80 字节。 '*' 删除 UFS 中所有文件（不删除目录） '' 删除 UFS 中指定的文件 'SD:*' 删除 SD 卡中所有文件（不删除目录） 'SD:' 删除 SD 卡中指定的文件 错误码。详情可参考第 4 章。 举例 AT+QFDEL='*' OK AT+QFDEL='UFS:1.txt' OK AT+QFDEL='SD:*' OK //删除 UFS 中所有文件（不删除目录）。 //删除 UFS 中的 1.txt 这个文件。 //删除 SD 卡中所有文件（不删除目录）。 上海移远通信技术股份有限公司 13 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.4. AT+QFUPL 上传文件到存储媒介 该命令用于上传文件到存储媒介，若上传的文件与存储媒介中的文件同名，则会上报错误。 执行设置命令并返回 CONNECT 后，模块会切换为数据模式。当上传的文件大小达到，或 达到时间内无数据输入，模块会自动退出数据模式。数据传输期间，用户可以通过执行+++或拉 高 DTR 使之退出数据模式，更多相关信息，可参考第 1.3 章。 AT+QFUPL 上传文件到存储媒介 测试命令 AT+QFUPL=? 响应 +QFUPL: [,(1-)[,(支持的范 围)[,(支持的列表)]]] 设置命令 AT+QFUPL=[,[, [,]]] OK 响应 CONNECT TA 切换为数据模式（即透传模式），可输入二进制文件数据。 当输入数据的总大小达到（单位：字节）时，TA 将 切换回命令模式： +QFUPL: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 参数 整型。的可用空间。有关详细信息，可参考第 2.3.1 章。 字符串类型。上传文件的名称。最大长度为 80 字节。 '' 上传至 UFS 中的文件名称 'SD:' 上传至 SD 卡中的文件名称 整型。预计上传的文件大小。默认值：10240；单位：字节。 整型。实际上传的文件大小。单位：字节。 整型。通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒；范围：1~65535。 整型。是否使用 ACK 模式。 0 默认关闭 ACK 模式 1 开启 ACK 模式 上海移远通信技术股份有限公司 14 / 27 LTE Standard(A)系列 FILE 应用指导 整型。上传数据的校验和。 错误码。详情可参考第 4 章。 备注 1. 推荐使用 DOS 8.3 文件名格式。 2. 是基于异或的 16 位校验和。 如果字符数为奇数，则将最后一个字符设置为高 8 位，将低 8 位设置为 0，然后使用 XOR 运算符计 算校验和。+++序列可使 TA 结束命令并切换到命令模式。之前上传的数据将保留在文件中。 3. 执行命令时，必须在返回 CONNECT 后输入数据。 4. 在硬件流控制不起作用时，ACK 模式可避免在上传大文件时数据丢失。ACK 模式的工作原理如下： 1）运行 AT+QFUPL=,,,1 启用 ACK 模式。 2）模块输出 CONNECT。 3）MCU 发送 1 KB 字节数据，模块响应 A。 4）MCU 接收 A，然后发送下一个 1 KB 字节数据。 5）重复第 3）和 4）步骤，直到传输完成。 2.3.5. AT+QFDWL 下载存储媒介中的文件 该命令用于从存储媒介中下载指定的文件。 AT+QFDWL 下载存储媒介中的文件 测试命令 AT+QFDWL=? 响应 +QFDWL: 设置命令 AT+QFDWL= OK 响应 CONNECT TA 切换为数据模式，可输出文件二进制数据。文件读取完后， TA 将切换回命令模式： +QFDWL: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 15 / 27 LTE Standard(A)系列 FILE 应用指导 参数 字符串类型。下载文件的名称。最大长度为 80 个字节。 '' 下载的 UFS 文件名称 'SD: ' 下载的 SD 文件名称 整型。已下载数据的大小。 整型。已下载数据的校验和。 错误码。详情可参考第 4 章。 备注 1. +++序列会使 TA 结束命令并切换到命令模式。 2. 是基于异或的 16 位校验和。 2.3.6. AT+QFOPEN 打开文件 该命令用于打开文件并获取命令中使用的文件句柄，相关命令如 AT+QFREAD、AT+QFWRITE、 AT+QFSEEK、AT+QFPOSITION 和 AT+QFCLOSE。 AT+QFOPEN 打开文件 测试命令 AT+QFOPEN=? 响应 +QFOPEN: [,(支持的范围)] 查询命令 AT+QFOPEN? OK 响应 +QFOPEN: ,, [+QFOPEN: ,, […]] 设置命令 AT+QFOPEN=[,] OK 响应 +QFOPEN: OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 16 / 27 LTE Standard(A)系列 FILE 应用指导 参数 字符串类型。打开的文件名称。最大长度为 80 字节。 '' 打开的 UFS 文件名称 'SD: ' 打开的 SD 文件名称 整型。文件句柄。数据类型为 4 字节。 整型。文件的打开模式。 0 若文件不存在，则会创建一个新文件；若文件存在，则直接打开文件。两种情 况中的文件皆可读写 1 若文件不存在，则会创建一个新文件；若文件存在，则清除并覆盖文件。两种 情况中的文件皆可读写 2 若文件存在，则作为只读文件直接打开；若文件不存在，则响应错误 错误码。详情可参考第 4 章。 备注 若文件存储在 SD 卡中，获取的默认从 20 开始以 1 依次递增。 2.3.7. AT+QFREAD 读取文件 该命令用于读取由文件句柄指定的文件数据。数据从文件指针的当前位置开始读取，文件指针属于文件 句柄。 AT+QFREAD 读取文件 测试命令 AT+QFREAD=? 响应 +QFREAD: [,] 设置命令 AT+QFREAD=[, ] OK 响应 CONNECT TA 切换到数据模式，当数据总大小超过（单位：字节） 时，TA 将切换回命令模式： OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 17 / 27 参数 LTE Standard(A)系列 FILE 应用指导 整型。需要操作的文件句柄。 整型。预计读取的文件长度，默认为文件长度。 整型。实际读取的文件长度。 错误码。详情可参考第 4 章。 2.3.8. AT+QFWRITE 写入数据至文件 该命令用于将数据写入到文件。数据从文件指针的当前位置开始写入，文件指针属于文件句柄。 AT+QFWRITE 写入数据至文件 测试命令 AT+QFWRITE=? 响应 +QFWRITE: [,[,]] 设置命令 AT+QFWRITE=[,[,]] OK 响应 CONNECT TA 切换到数据模式。当写入数据的总大小超过（单 位：字节）或写入时间超过，TA 将切换回命令模式： +QFWRITE: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。预计写入文件的长度，默认长度为 10 KB。此参数的最大值由 AT+QFUPL 的决定。 整型。通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒。 整型。实际写入数据的长度。 整型。文件总长度。 错误码。详情可参考第 4 章。 上海移远通信技术股份有限公司 18 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.9. AT+QFSEEK 设置文件指针位置 该 命 令 用 于 设 置 文 件 指 针 到 指 定 的 位 置 ， 可 以 决 定 这 些 命 令 的 初 始 位 置 ， 如 AT+QFREAD 、 AT+QFWRITE 和 AT+QFPOSITION。 AT+QFSEEK 设置文件指针位置 测试命令 AT+QFSEEK=? 响应 +QFSEEK: ,[,] 设置命令 AT+QFSEEK=,[, ] OK 响应 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。文件指针移动的字节数。 整型。文件指针移动模式。 0 文件初始位置 1 文件指针当前位置 2 文件最终位置 错误码。详情可参考第 4 章。 备注 1. 若为 0 且超过文件大小，执行此命令会返回 ERROR。 2. 若为 1 且总文件大小和当前位置的文件指针超过文件大小，执行此命令会返回 ERROR。 2. 若为 2，文件句柄将向前移动。 上海移远通信技术股份有限公司 19 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.10. AT+QFPOSITION 获取文件指针偏移量 该命令用于从文件初始位置获取文件指针的偏移量。 AT+QFPOSITION 获取文件指针偏移量 测试命令 AT+QFPOSITION=? 响应 +QFPOSITION: 设置命令 AT+QFPOSITION= OK 响应 +QFPOSITION: OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。从初始位置起文件指针的偏移量。 错误码。详情可参考第 4 章。 上海移远通信技术股份有限公司 20 / 27 LTE Standard(A)系列 FILE 应用指导 2.3.11. AT+QFCLOSE 关闭文件 该命令用于关闭文件或结束对文件的操作。关闭文件后，文件句柄会被释放。除非通过 AT+QFOPEN 再次打开文件，否则不可再次使用文件句柄。 AT+QFCLOSE 关闭文件 测试命令 AT+QFCLOSE=? 响应 +QFCLOSE: 设置命令 AT+QFCLOSE= OK 响应 OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 错误码。详情可参考第 4 章。 上海移远通信技术股份有限公司 21 / 27 LTE Standard(A)系列 FILE 应用指导 3 举例 3.1. 上传或下载文件 3.1.1. 上传文件 3.1.1.1. 无 ACK 模式 AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK //上传 test1.txt 文本文件到 UFS。 3.1.1.2. ACK 模式 ACK 模式下传输数据更可靠。在无硬件流控情况下传输大文件时，推荐开启 ACK 模式避免数据丢失。 有关 ACK 模式的详细信息，可参考 AT+QFUPL。 AT+QFUPL='test.txt',3000,5,1 CONNECT A A +QFUPL: 3000,B34A //上传文本文件 test.txt 到 UFS。 //接收 1024 字节数据后，模块会响应 A。然后输入下一个 1024 字节数据。 OK 上海移远通信技术股份有限公司 22 / 27 3.1.2. 下载文件 AT+QFDWL='test.txt' CONNECT +QFDWL: 10,613e OK LTE Standard(A)系列 FILE 应用指导 //从 UFS 中下载文本文件 test.txt。 //获取已下载数据的字节数与校验和值。 3.2. 写入和读取文件 3.2.1. 写入和读取 UFS 文件 AT+QFOPEN='test.txt',1 +QFOPEN: 1 OK AT+QFWRITE=1,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=1,0,0 OK AT+QFREAD=1,10 CONNECT OK AT+QFCLOSE=1 OK //打开文件获取文件指针。 //将 10 个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取数据。 //关闭文件。 上海移远通信技术股份有限公司 23 / 27 3.2.2. 写入和读取 SD 文件 AT+QFOPEN='SD:1.txt',1 +QFOPEN: 20 OK AT+QFWRITE=20,1024 CONNECT +QFWRITE: 1024,1024 OK AT+QFSEEK=20,0,0 OK AT+QFREAD=20,1024 CONNECT OK AT+QFCLOSE=20 OK LTE Standard(A)系列 FILE 应用指导 //打开文件获取文件指针。 //将 10 个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取数据。 //关闭文件。 上海移远通信技术股份有限公司 24 / 27 LTE Standard(A)系列 FILE 应用指导 4 错误代码 表示与本文档适用模块的文件操作有关的错误码，详细信息可参考下表。 表 3：错误代码列表 错误码 400 401 402 403 405 406 407 409 410 411 413 414 416 417 418 419 420 英文含义 中文含义 Invalid input value 输入值无效 Larger than the size of the file 文件过大 Read zero byte 读取 0 字节 Drive full 驱动器已满 File not found 未发现文件 Invalid file name 无效文件名 File already exists 文件已存在 Fail to write the file 写入文件失败 Fail to open the file 打开文件失败 Fail to read the file 读取文件失败 Reach the max. number of files allowed to be opened 达到允许打开的最大文件数 The file read-only 文件仅可读 Invalid file descriptor 无效文件描述符 Fail to list the file 列举文件失败 Fail to delete the file 删除文件失败 Fail to get disk info 获取磁盘信息失败 No space 空间不足 上海移远通信技术股份有限公司 25 / 27 421 Time out 423 File too large 425 Invalid parameter 426 File already opened LTE Standard(A)系列 FILE 应用指导 超时 文件过大 无效参数 文件已打开 上海移远通信技术股份有限公司 26 / 27 LTE Standard(A)系列 FILE 应用指导 5 附录 术语缩写 表 4：术语缩写 缩写 ACK COM DOS DTR ME RAM SD TA UART UFS USB XOR 英文全称 中文全称 Acknowledgement 确认字符 Communication Port 串行通讯端口 Disk Operating System 磁盘操作系统 Data Terminal Ready 数据终端就绪 Mobile Equipment 移动设备 Random Access Memory 随机存储器 Secure Digital 安全数字存储器 Terminal Adapter 终端适配器 Universal Asynchronous Receiver- 通用异步收发传输器 Transmitter User File Storage 用户文件存储 Universal Serial Bus 通用串行总线 Exclusive OR 异或 上海移远通信技术股份有限公司 27 / 27

LC260Z (00)&LC760Z&LC29Y (单频 RTK) 固件升级指导 GNSS 模块系列 版本：1.1 日期：2024-04-17 状态：受控文件 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 关于文档 文档信息 标题 副标题 文档类别 文档状态 LC260Z (00)&LC760Z&LC29Y (单频 RTK)固件升级指导 GNSS 模块系列 固件升级指导 受控文件 修订记录 版本 1.0 日期 2023-06-07 2024-02-27 1.1 2024-04-17 变更表述 文档创建 受控版本 1. 新增 LC29Y (单频 RTK)及其固件升级相关信息。 2. 新增固件升级流程结束后可通过相关语句查询固件版本以确认固件升 级流程是否成功执行的信息（第 1、4.5、5、6.2 和 6.3 章）。 上海移远通信技术股份有限公司 3 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 目录 关于文档 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 2 固件升级基本信息 ................................................................................................................................. 9 2.1. 固件包 ..................................................................................................................................... 9 2.2. MD5 校验 ................................................................................................................................ 9 2.3. 升级相关二进制协议 ............................................................................................................. 10 2.3.1. 二进制协议消息结构...................................................................................................... 10 2.3.2. 应答消息 ........................................................................................................................ 12 2.3.2.1. ACK-NAK (0x05 0x00).......................................................................................... 12 2.3.2.2. ACK-ACK (0x05 0x01).......................................................................................... 13 2.3.3. 正常升级模式下固件升级相关命令 ................................................................................ 14 2.3.3.1. CFG-PRT (0x06 0x00).......................................................................................... 14 2.3.3.2. CFG-FWUP (0x06 0x50) ...................................................................................... 15 2.3.4. Boot 下载模式下固件升级相关命令............................................................................... 16 2.3.4.1. BOOT3-RFF-SET (0xF4 0x00)............................................................................. 16 2.3.4.2. BOOT3-UART-SET (0xF4 0x03) .......................................................................... 17 2.3.4.3. BOOT2-SPIFLSINFO-POLL (0xF4 0x07) ............................................................ 18 2.3.4.4. BOOT3-FLSEARSE-SET (0xF4 0x08)................................................................. 19 2.3.4.5. BOOT2-SPIFLS-WRSR-SET (0xF4 0x13)........................................................... 20 2.3.4.6. BOOT2-FWPG-SET (0xF4 0x05)......................................................................... 20 2.4. Ymodem 传输协议................................................................................................................ 22 2.4.1. Ymodem 协议结构......................................................................................................... 22 2.4.2. Ymodem 协议常量......................................................................................................... 23 2.4.3. Ymodem 传输流程......................................................................................................... 24 3 正常升级模式下固件升级流程 ............................................................................................................. 25 3.1. 修改波特率............................................................................................................................ 26 3.2. 进入正常升级模式................................................................................................................. 26 3.3. 发送 SOH 包 ......................................................................................................................... 26 3.4. 发送 STX 包 .......................................................................................................................... 27 3.5. 发送 EOT 和空 SOH 包......................................................................................................... 28 4 Boot 下载模式下固件升级流程 ........................................................................................................... 30 4.1. 进入 Boot 下载模式............................................................................................................... 31 4.2. 修改波特率............................................................................................................................ 31 4.3. 设置 Flash 状态寄存器.......................................................................................................... 31 4.4. 发送固件包............................................................................................................................ 32 4.5. 重启模块 ............................................................................................................................... 33 上海移远通信技术股份有限公司 4 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 5 固件升级示例....................................................................................................................................... 34 5.1. 正常升级模式下升级固件...................................................................................................... 34 5.1.1. LC260Z (00)和 LC760Z 固件升级示例.......................................................................... 34 5.1.2. LC29Y (单频 RTK)固件升级示例................................................................................... 35 5.2. Boot 下载模式下升级固件..................................................................................................... 37 5.2.1. LC260Z (00)和 LC760Z 固件升级示例.......................................................................... 37 5.2.2. LC29Y (单频 RTK)固件升级示例................................................................................... 38 6 使用 QGNSS 工具升级固件示例......................................................................................................... 39 6.1. 升级模式 ............................................................................................................................... 39 6.2. 正常升级模式下固件升级流程 .............................................................................................. 39 6.3. Boot 下载模式下固件升级流程 ............................................................................................. 43 7 附录 A 参考文档及术语缩写 ............................................................................................................... 46 8 附录 B 特殊符号 ................................................................................................................................. 47 上海移远通信技术股份有限公司 5 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 表格索引 表 1：数据类型 ........................................................................................................................................... 10 表 2：二进制协议消息结构..........................................................................................................................11 表 3：ACK-NAK 有效载荷.......................................................................................................................... 13 表 4：ACK-ACK 有效载荷.......................................................................................................................... 13 表 5：CFG-PRT 有效载荷.......................................................................................................................... 14 表 6：升级模式有效载荷 ............................................................................................................................ 15 表 7：BOOT3-RFF-SET 载荷 .................................................................................................................... 16 表 8：BOOT3-UART-SET 载荷.................................................................................................................. 17 表 9：Flash 状态载荷 ................................................................................................................................. 18 表 10：BOOT3-FLSEARSE-SET 载荷 ...................................................................................................... 19 表 11：BOOT2-SPIFLS-WRSR-SET 载荷................................................................................................. 20 表 12：BOOT2-FWPG-SET 载荷 .............................................................................................................. 21 表 13：Ymodem 协议结构 ......................................................................................................................... 22 表 14：常量列表 ......................................................................................................................................... 23 表 15：SOH 数据包载荷 ............................................................................................................................ 27 表 16：升级模式说明.................................................................................................................................. 39 表 17：参考文档 ......................................................................................................................................... 46 表 18：术语和缩写 ..................................................................................................................................... 46 表 19：特殊符号 ......................................................................................................................................... 47 上海移远通信技术股份有限公司 6 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 图片索引 图 1：固件升级连接图 .................................................................................................................................. 8 图 2：解压缩固件结构 .................................................................................................................................. 9 图 3：二进制协议消息结构......................................................................................................................... 10 图 4：Ymodem 协议结构 ........................................................................................................................... 22 图 5：正常升级模式下升级流程图.............................................................................................................. 25 图 6：发送 SOH 包流程图 .......................................................................................................................... 27 图 7：发送 STX、EOT 和空 SOH 包流程图............................................................................................... 29 图 8：Boot 下载模式升级流程图 ................................................................................................................ 30 图 9：发送固件 ........................................................................................................................................... 33 图 10：设备管理器 ..................................................................................................................................... 40 图 11：设备信息 ......................................................................................................................................... 41 图 12：固件下载 ......................................................................................................................................... 41 图 13：加载固件 ......................................................................................................................................... 42 图 14：选择升级固件包 .............................................................................................................................. 42 图 15：等待升级完成.................................................................................................................................. 42 图 16：升级完成 ......................................................................................................................................... 43 图 17：加载固件 ......................................................................................................................................... 44 图 18：选择升级固件包 .............................................................................................................................. 44 图 19：等待升级完成.................................................................................................................................. 44 图 20：升级完成 ......................................................................................................................................... 45 上海移远通信技术股份有限公司 7 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 1 引言 本文档介绍了移远通信 LC260Z (00)、LC760Z 和 LC29Y (单频 RTK) GNSS 模块的固件升级操作步 骤。主机和模块可以通过 UART 接口进行通信，并将固件升级并下载到模块中。 模块可在 2 种模式下进行固件升级：正常升级模式和 Boot 下载模式。正常升级模式下进行固件升级时， 主机和模块仅通过 UART 连接即可完成通信和固件升级流程。若模块在正常升级模式下升级失败，则只能 通过 Boot 下载模式升级固件。进入 Boot 下载模式需要通过主机对模块的 BOOT 引脚进行上拉或下拉，然 后再复位模块。如需了解模块如何进入 Boot 下载模式，详情可参考第 4.1 章 进入 Boot 下载模式。主机和 GNSS 模块的连接如下图所示。 主机 UART BOOT GNSS模块 图 1：固件升级连接图 备注 1. 若固件升级失败或用户停止固件升级流程，此时模块内没有可运行的固件，模块必须进入 Boot 下 载模式重新开始固件升级流程，直到升级成功。 2. 固件升级结束后，可通过以下方式查询固件版本信息，来判断固件版本是否和目标固件版本一致， 进而确认是否升级成功： ⚫ LC260Z (00)和 LC760Z：执行$PQTMVERNO*58 来查询固件版本信息。 ⚫ LC29Y (单频 RTK)：每次开机后会自动输出固件版本信息或执行$PQTMVERNO*58 来查询固 件版本信息。 3. 有关$PQTMVERNO*58 命令详情，请参考对应模块的协议文档。 上海移远通信技术股份有限公司 8 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 2 固件升级基本信息 2.1. 固件包 用于升级的固件包是一个.cyfm 文件，该文件是通过 Gzip 压缩的固件。使用固件时，需要先解压缩文 件并检查 MD5 校验结果。可以使用 7-zip 等常用解压工具解压.cyfm 文件。解压缩.cyfm 文件后，会得到一 个没有任何扩展名的文件。关于 MD5 校验详情请参考第 2.2 章 MD5 校验。解压后的固件结构如下图所示： 0x00000000: First 16 Bytes, MD5 Checksum 0x00000010: Firmware Binary Image 0x00000020: Firmware Binary Image ... ... : Firmware Binary Image 图 2：解压缩固件结构 2.2. MD5 校验 MD5 为信息摘要算法 5（Message Digest Algorithm 5），用于验证文件完整性。MD5 算法能够将任意 长度的数据转化为 128 位的哈希值，即 16 个字节的 MD5 校验结果，通常表示为 32 个十六进制数字。这 个哈希值在理想情况下对于不同的输入数据应该是唯一的，而且即使输入数据只有微小的改动，其生成的 哈希值也会发生明显变化。 从图 2：解压缩固件结构可以看到，解压缩后的固件前 16 个字节是基于固件数据计算出的 MD5 校验 结果。用户可使用 MD5 算法计算出固件数据的 MD5 校验结果（计算时不包含前 16 个字节），然后再和固 件中已有的 MD5 校验结果（固件前 16 个字节）比较，如果相同则说明固件包数据完好，可以用于固件升 级。 上海移远通信技术股份有限公司 9 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 备注 若 MD5 校验结果不正确，请先确认文件是否损坏、校验算法是否正确；若仍无法解决，请联系移远通信 技术支持（support@quectel.com）。 2.3. 升级相关二进制协议 2.3.1. 二进制协议消息结构 固件升级过程中使用的命令需要按照二进制协议进行封装，二进制协议消息结构如下图所示。 固定为0xF1 0xD9 1个字节 1个字节 2个字节 2个字节 Header Message Group ID Message Sub ID Length 校验和计算的范围 Payload Checksum (CHK1, CHK2) 图 3：二进制协议消息结构 表 1：数据类型 数据类型 uint8_t int8_t uint16_t uint32_t int32_t 大小（字节） 描述 十进制取值范围：0 至 255。 1 十六进制取值范围：0x00 至 0xFF。 例如：如果使用 28，在二进制协议中为 1C。 十进制取值范围：-128 至 127。 1 十六进制取值范围：0x00 至 0xFF。 例如：如果使用-127，在二进制协议中是 81。 十进制取值范围：0 至 65535。 2 十六进制取值范围：0x0000 至 0xFFFF。 例如：如果使用 28，二进制协议为 1C 00。 十进制取值范围：0 至 4294967295。 4 十六进制取值范围：0x00000000 至 0xFFFFFFFF。 例如：如果使用 12624961，二进制协议为 41 A4 C0 00。 4 十进制取值范围：-2147483648 至 2147483647。 上海移远通信技术股份有限公司 10 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 数据类型 float32_t uint8_t[N] 大小（字节） 描述 十六进制取值范围：0x0000000 至 0xFFFFFFFF。 例如：如果使用-2147483647，二进制协议为 01 00 00 80。 十进制取值范围：-3.4E38 至 3.4E38。 4 十六进制取值范围：0x0000000 至 0xFFFFFFFF。 例如：如果使用 1.57077157497406，二进制协议为 0B 0F C9 3F。 多个 uint8_t 组合。 N 每一个成员的取值范围和 uint8_t 一致。 备注 所有整数直接按照补码计算规则进行编码在二进制协议中按照小端格式传输；对于浮点数，需要根据 IEEE 754 标准进行编码在二进制协议中按照小端格式传输。 表 2：二进制协议消息结构 字段 数据类型 描述 Header uint8_t[2] 二进制协议帧头，2 个字节：0xF1, 0xD9。 Message Group ID uint8_t 消息组 ID。 Message Sub ID Length Payload Checksum uint8_t uint16_t 消息子 ID。 Payload 字段长度，2 个字节。不包括 Header、Message Group ID、 Message Sub ID 和 Checksum (CHK1, CHK2) 字 段 的 长 度 。 若 Payload 字段无实际数据，则 Payload 字段长度为零。 uint8_t[N] 消息有效载荷，字节数可变。 uint8_t[2] 校验和（CHK1 和 CHK2），2 个字节。使用 8 位 Fletcher 算法的 16 位 校验和。校验值从 Message Group ID 的起始字节到 Payload 内容的 最后一个字节计算的。 校验和示例代码： //pData is the data array whose checksum needs to be calculated: uint16_t Ql_Check_Quectel (const unsigned char *pData, unsigned int Length) { uint8_t chk1 = 0; uint8_t chk2 = 0; unsigned int i = 0; if((NULL == pData) || (Length < 4)) 上海移远通信技术股份有限公司 11 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 { return 0; } for(i = 2; i < Length; i++) { chk1 = chk1 + pData[i]; chk2 = chk2 + chk1; } chk1 = chk1 & 0xFF; chk2 = chk2 & 0xFF; return (chk1 | (chk2 << 8 )); } //The generated checksum consists of two bytes, represented as {chk1, chk2}. 备注 二进制消息采用小端格式进行传输。 2.3.2. 应答消息 2.3.2.1. ACK-NAK (0x05 0x00) 否定消息，若固件升级相关命令无效或执行失败，模块将响应此消息。 类型： 输出 结构： Header Message Group ID 0xF1 0xD9 0x05 Message Sub ID 0x00 Length 0x02 0x00 Payload Checksum 见表 3：ACK-NAK 有效载荷。 CHK1 CHK2 上海移远通信技术股份有限公司 12 / 47 表 3：ACK-NAK 有效载荷 字节偏移 数据类型 0 uint8_t 1 uint8_t LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 名称 Message Group ID Message Sub ID 单位 - 描述 固件升级相关命令的消息组 ID。 固件升级相关命令的消息子 ID。 示例： //设置 UART 接口波特率为 1000000 bps： F1 D9 06 00 08 00 00 00 00 00 40 42 0F 00 9F 7C //UART1 接口不支持 1000000 bps，模块响应 ACK-NAK 表明消息组 ID 为 0x06、消息子 ID 为 0x00 的命 令无效： F1 D9 05 00 02 00 06 00 0D 32 2.3.2.2. ACK-ACK (0x05 0x01) 确认消息，若固件升级相关命令有效或执行成功，模块将响应此消息。 类型： 输出 结构： Header Message Group ID 0xF1 0xD9 0x05 Message Sub ID 0x01 Length 0x02 0x00 Payload Checksum 见表 4：ACK-ACK 有效载荷。 CHK1 CHK2 表 4：ACK-ACK 有效载荷 字节偏移 数据类型 名称 单位 描述 0 uint8_t Message Group ID - 固件升级相关命令的消息组 ID 1 uint8_t Message Sub ID - 固件升级相关命令的消息子 ID 上海移远通信技术股份有限公司 13 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 示例： //设置 UART 接口波特率为 115200 bps： F1 D9 06 00 08 00 00 00 00 00 00 C2 01 00 D1 E0 //UART 接口支持 115200 bps，模块响应 ACK-ACK 表明消息组 ID 为 0x06、消息子 ID 为 0x00 的命令执 行成功： F1 D9 05 01 02 00 06 00 0E 37 2.3.3. 正常升级模式下固件升级相关命令 2.3.3.1. CFG-PRT (0x06 0x00) 配置 UART 接口及波特率。 类型： 设置 结构： Header Message Group ID 0xF1 0xD9 0x06 Message Sub ID 0x00 Length 0x08 0x00 Payload Checksum 见表 5：CFG-PRT 有效载荷。 CHK1 CHK2 表 5：CFG-PRT 有效载荷 字节偏移 数据类型 名称 0 uint8_t PortID 1 uint8_t[3] Res 4 uint32_t Baudrate 单位 - bps 描述 接口标识号。 ⚫ LC260Z (00)：0x00 = UART1 ⚫ LC760Z：0x00 = UART1 ⚫ LC29Y (单频 RTK)：0x00 = UART1 预留。固定为 0。 可设置的波特率（小端格式）。 ⚫ LC260Z (00)和 LC760Z： 9600 19200 38400 57600 115200 230400 上海移远通信技术股份有限公司 14 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 字节偏移 数据类型 名称 单位 描述 460800 ⚫ LC29Y (单频 RTK)： 115200 230400 460800 示例： //设置 UART1 接口波特率为 115200 bps： F1 D9 06 00 08 00 00 00 00 00 00 C2 01 00 D1 E0 /模块响应 ACK-ACK 表明波特率设置成功： F1 D9 05 01 02 00 06 00 0E 37 2.3.3.2. CFG-FWUP (0x06 0x50) 进入正常升级模式，模块使用 Ymodem 协议开始固件升级，如需了解 Ymodem 协议结构，可参考 第 2.4 章 Ymodem 传输协议。 类型： 命令 结构： Header Message Group ID 0xF1 0xD9 0x06 Message Sub ID 0x50 Length 0x01 0x00 Payload Checksum 见表 6：升级模式有效载 荷。 CHK1 CHK2 表 6：升级模式有效载荷 字节偏移 数据类型 名称 0 uint8_t 升级模式 单位 - 描述 0x01：LC260Z (00)和 LC760Z 固件升级。 0x10：LC29Y (单频 RTK)固件升级。 上海移远通信技术股份有限公司 15 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 结果： ⚫ 若命令执行成功，模块将响应 ACK-ACK，表示当前固件失效，并切换到固件升级模式，直到下载并验 证新固件： F1 D9 05 01 02 00 06 50 5E 87 ⚫ 若命令执行失败，模块将响应 ACK-NAK，表示如果模块出现错误，主机将取消固件升级： F1 D9 05 00 02 00 06 50 5D 82 示例： //LC260Z (00)和 LC760Z 进入正常升级模式进行固件升级： F1 D9 06 50 01 00 01 58 62 //命令执行成功，模块响应 ACK-ACK： F1 D9 05 01 02 00 06 50 5E 87 2.3.4. Boot 下载模式下固件升级相关命令 2.3.4.1. BOOT3-RFF-SET (0xF4 0x00) 设置参考时钟频率和波特率（仅 LC260Z (00)和 LC760Z 支持此命令）。 类型: 设置 结构: Header Message Group ID 0xF1 0xD9 0xF4 Message Length Sub ID 0x00 0x08 0x00 Payload Checksum 见表 7：BOOT3-RFF-SET 载荷。 CHK1 CHK2 表 7：BOOT3-RFF-SET 载荷 字节偏移 数据类型 名称 0 uint32_t RefFreqe 4 uint32_t Baudrate 上海移远通信技术股份有限公司 单位 - bps 描述 参考时钟频率。 默认值：0x018CBA80（即 26000000 Hz） 可设置的波特率（小端格式）。 9600 19200 38400 16 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 字节偏移 数据类型 名称 单位 描述 57600 115200 230400 460800 示例： //设置时钟参考频率为 26000000 Hz、波特率为 460800 bps： F1 D9 F4 00 08 00 80 BA 8C 01 00 08 07 00 D2 49 //模块响应 ACK-ACK 表明时钟参考频率和波特率设置成功： F1 D9 05 01 02 00 F4 00 FC 13 2.3.4.2. BOOT3-UART-SET (0xF4 0x03) 设置 UART 接口波特率（仅 LC29Y (单频 RTK)支持此命令）。 类型: 设置 结构: Header Message Message Length Group ID Sub ID 0xF1 0xD9 0xF4 0x03 0x08 0x00 Payload Checksum 见表 8：BOOT3-UART-SET 载 荷。 CHK1 CHK2 表 8：BOOT3-UART-SET 载荷 字节偏移 数据类型 名称 0 uint32_t Baudrate 4 uint32_t 预留位 单位 bps - 描述 可设置的波特率（小端格式）。 115200 230400 460800 预留位，没有实际含义，可以和波特率相同。 上海移远通信技术股份有限公司 17 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 示例： //设置 UART 接口波特率为 460800 bps： F1 D9 F4 03 08 00 00 08 07 00 00 08 07 00 1D 69 //模块响应 ACK-ACK 表明波特率设置成功： F1 D9 05 01 02 00 F4 03 FF 16 2.3.4.3. BOOT2-SPIFLSINFO-POLL (0xF4 0x07) 查询 Flash 状态（仅 LC260Z (00)和 LC760Z 支持此命令）。 类型： 命令 结构： Header Message Group ID 0xF1 0xD9 0xF4 Message Sub Length ID 0x07 0x01 0x00 Payload 0x02 Checksum CHK1 CHK2 返回结果结构： Header Message Group ID 0xF1 0xD9 0xF4 Message Sub ID 0x07 Length 0x04 0x00 Payload Checksum 见表 9：Flash 状态载荷 CHK1 CHK2 表 9：Flash 状态载荷 字节偏移 数据类型 名称 0 uint32_t Flash_Status 单位 - 描述 Flash 状态（小端格式）。 0x210E0A00：禁用写保护 0x210E4A08：使能写保护 上海移远通信技术股份有限公司 18 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 示例： //查询 Flash 状态： F1 D9 F4 07 01 00 02 FE E5 //返回的 Flash 状态为禁用写保护（小端格式）： F1 D9 F4 07 04 00 00 0A 0E 21 38 44 2.3.4.4. BOOT3-FLSEARSE-SET (0xF4 0x08) 设置 Flash 状态寄存器（仅 LC29Y (单频 RTK)支持此命令）。 类型： 设置 结构： Header Message Message Length Group ID Sub ID 0xF1 0xD9 0xF4 0x08 0x04 0x00 Payload Checksum 见 表 10 ： BOOT3-FLSEARSE- SET 载荷。 CHK1 CHK2 表 10：BOOT3-FLSEARSE-SET 载荷 字节偏移 数据类型 名称 单位 0 uint32_t Address - 描述 设置 Flash 状态寄存器： 前 2 个字节是 0x8000，用于写入内部 Flash 状态 （即禁用写保护）；后 2 个字节是数据。 示例： //主机发送 BOOT3-FLSEARSE-SET 命令设置 Flash 状态寄存器（禁用写保护）： F1 D9 F4 08 04 00 00 02 00 80 82 76 //命令执行成功，模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 08 04 1B 上海移远通信技术股份有限公司 19 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 2.3.4.5. BOOT2-SPIFLS-WRSR-SET (0xF4 0x13) 设置 Flash 状态寄存器（仅 LC260Z (00)和 LC760Z 支持此命令）。 类型： 设置 结构： Header Message Message Length Group ID Sub ID 0xF1 0xD9 0xF4 0x13 0x05 0x00 Payload Checksum 见 表 11 ： BOOT2-SPIFLS- WRSR-SET 载荷。 CHK1 CHK2 表 11：BOOT2-SPIFLS-WRSR-SET 载荷 字节偏移 数据类型 名称 0 uint8_t Flash_Type 1 uint8_t Flash_SR0 2 uint8_t Flash_SR1 3 uint8_t Flash_SR2 4 uint8_t Flash_SR3 单位 描述 Flash 类型。 - 0x00 = 内部 Flash - 状态字节 0，通常为 0x00。 - 状态字节 1，默认值：0x02（禁用写保护）。 - 状态字节 2，通常为 0x00。 - 状态字节 3，通常为 0x00。 示例： //设置内部 Flash 寄存器状态为禁用写保护： F1 D9 F4 13 05 00 00 00 02 00 00 0E 55 //命令执行成功，模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 13 0F 26 2.3.4.6. BOOT2-FWPG-SET (0xF4 0x05) 在 Boot 下载模式下发送固件。 类型： 命令 上海移远通信技术股份有限公司 20 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 结构： Header Message Message Length Group ID Sub ID 0xF1 0xD9 0xF4 0x05 可变长度 Payload Checksum 见表 12：BOOT2-FWPG-SET 载荷。 CHK1 CHK2 表 12：BOOT2-FWPG-SET 载荷 字节偏移 数据类型 名称 0 uint32_t Address 4 uint16_t Number 6 至 1029 uint8_t[N] Data 单位 描述 数据引导的地址。 - ⚫ LC260Z (00)和 LC760Z 地址：0x90000000 ⚫ LC29Y (单频 RTK)地址：0x00100000 - 报文号，从 0 开始。 下载的数据（每个固件包推荐长度为 1024 字节）。 - 发送的第一个固件包一般为空固件包，用于擦除 Flash；故在第一个空固件包中，Data 字段需省略。 示例： LC260Z (00)和 LC760Z： //主机发送第一个空固件包来擦除 Flash： F1 D9 F4 05 06 00 00 00 00 90 00 00 8F 95 //命令执行成功，模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //主机发送第二个固件包： F1 D9 F4 05 06 04 00 04 00 90 01 00 FF FF FF FF FF FF… FF FF FF FF 98 C7 //命令执行成功，模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 LC29Y (单频 RTK)： //主机发送一个空数据包来命令擦除 Flash： F1 D9 F4 05 06 00 00 00 10 00 00 00 0F 25 //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //主机发送第二个固件包： F1 D9 F4 05 06 04 00 04 10 00 01 00 00 5E 06 00 … 4F 8F BF F3 01 0F //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 上海移远通信技术股份有限公司 21 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 2.4. Ymodem 传输协议 本章节介绍模块在正常升级模式下升级固件所使用的 Ymodem 协议。 Ymodem 协议是一种文件传输协议，适用于使用较大数据块的传输，进而让此类数据传输更加高效。 Ymodem 协议支持的数据包长度为 128 字节或 1024 字节。 2.4.1. Ymodem 协议结构 1字节 1字节 1字节 2字节 Header Packet Number ~(Packet Number) Payload 校验和计算的范围 Checksum (CHK1, CHK2) 图 4：Ymodem 协议结构 表 13：Ymodem 协议结构 字段 Header Packet Number 描述 Ymodem 协议的帧头（SOH 或 STX，第一个数据包为 SOH，后面的数据包则 为 STX），SOH 和 STX 详情见表 14：常量列表。 数据包的编号，从 0x00 开始。 ~(Packet Number) 数据包编号的取反。当数据包编号为 0x00 时，取反为 0xFF。 Payload 数据包的载荷，128 字节或 1024 字节。 Checksum 2 字节校验和（CHK1 和 CHK2），应用 16 位校验和算法。 上海移远通信技术股份有限公司 22 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 校验和示例代码： uint16_t Ql_Calculate_YModem_Crc16(uint8_t *ptr, int count) { uint32_t crc, i; crc = 0; while(--count >= 0) { crc = crc ^ (int)*ptr++ << 8; for (i = 0; i < 8; ++i) if (crc & 0x8000) crc = crc << 1 ^ 0x1021; else crc = crc << 1; } return(crc & 0xFFFF); } 2.4.2. Ymodem 协议常量 下表定义了 Ymodem 协议中所使用的常量。 表 14：常量列表 名称 值 SOH 0x01 STX 0x02 EOT 0x04 ACK 0x06 NAK 0x15 CAN 0x18 C 0x43 描述 数据块起始字符，负载长度为 128 字节。 文本内容开始，负载长度为 1024 字节。 传输结束。 确认应答。 否定应答。 取消传输。 等待。 上海移远通信技术股份有限公司 23 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 2.4.3. Ymodem 传输流程 Ymodem 传输流程可参考以下内容： 0. 1. 2. 3. …… …… …… N-1. N. 文件名（）长度为 128 字节。在主机收到 C（等待指令）之后，开始固件升级。主机首次 会发送一个 133 字节（为 1 个字节、和均为 2 个字节）的 SOH 包；而在固件 下载过程中的分包大小（STX 包）为 1029 字节（为 1 个字节、为 1024 字节、 和均为 2 个字节）。 上海移远通信技术股份有限公司 24 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 3 正常升级模式下固件升级流程 本章节重点介绍模块在正常升级模式下进行固件升级的流程，如下图所示： 可选 项 Ymode m协议 开始 解压 缩.cyfm文件 并检查MD5校验 和 否 MD5校验 和是否 正确? 是 主机 发送CFG-PRT命令 修改波 特率 否 主机 是否收 到ACK-ACK? 是 主机 发送CFG-FWUP命令 进入正 常升级 模式 否 主机 是否收 到ACK-ACK? 是 否 主机 是否收 到字符C? 是 主机 按照Ymode m协议 发送SOH包 否 主机 是否收 到ACK和C? 是 主机 按照Ymode m协议 发送STX包 否 主机 是否收 到ACK? 是 否 主机 是否发 送所有STX包? 是 主机 发送EOT和空SOH包 主机 是否收 到2次 否 A CK 和C以及 5次C AN 是 结束 主机 退出升 级程序 升级 失败，模块 需要进 入 Boo t下载 模式重 新升级 固件 。 图 5：正常升级模式下升级流程图 上海移远通信技术股份有限公司 25 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 备注 1. 有关解压缩.cyfm 文件和检查 MD5 校验结果详情可参考第 2.1 章 固件包和第 2.2 章 MD5 校验。 2. 主机发送 EOT 和空 SOH 包后，模块会先响应 2 次 ACK 和 C，再响应 5 次 CAN，详情可参考 第 5.1 章 正常升级模式下升级固件。 3.1. 修改波特率 模块与主机连接后，主机发送 CFG-PRT 给模块，将波特率修改为 460800 bps。命令执行成功后，模 块将响应 ACK-ACK 表明波特率修改成功。此项为可选步骤，使用默认波特率也可以正常升级固件。 3.2. 进入正常升级模式 修改波特率后，主机向模块发送 CFG-FWUP，使模块进入正常升级模式并启动固件升级。若模块在 3 秒内未响应 ACK-ACK，则表明该流程失败。 3.3. 发送 SOH 包 模块收到固件升级命令后，将进入正常升级模式。然后，主机启动软件程序，通过 Ymodem 协议下载 固件到模块中。 首先，模块在 60 秒内连续发送 C 启动文件传输。C 表示模块正在等待接收数据。一旦主机接收到 C， 则会构建一个 SOH 数据包并将发送给模块。模块接收到 SOH 数据包后，返回 ACK，表示模块成功接收到 数据包，然后模块响应 C。如果模块在 60 秒内没有收到 SOH 数据包，则返回 5 次 CAN，表示取消传输， 模块需进入 Boot 下载模式进行固件升级。 SOH 数据包含文件名和文件长度（字节)，格式如下： SOH 数据包格式 Header Packet Number ~(Packet Number) Payload（128字节） 0x01 0x00 0xFF 见表 15：SOH 数据包载荷。 Checksum CHK1 CHK2 上海移远通信技术股份有限公司 26 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 表 15：SOH 数据包载荷 字节偏移 名称 0 Filename N + 1 - N + 2 Filesize N + M + 2 - 描述 传输的文件名字符串，字符串长度为 N 字节。 0x00（文件名字符串结束字符，1 字节）。 表示传输的文件大小的字符串，字符串长度为 M 字节。 剩余长度填充（128 - M - N - 1）个 0x00。 发送SOH数据包的流程图如下： 主机 模块 模块连续发送字符C 如果主机60秒内没收到字符C，则升级失败 主机发送SOH数据包 如果模块60秒内没收到SOH数据包，则会 响应5次CAN，表示升级失败。 模块响应ACK和字符C 发送SOH数据包成功 图 6：发送 SOH 包流程图 最大60秒 最大60秒 3.4. 发送 STX 包 模块成功接收到 SOH 数据包后，将响应 ACK 和 C。一旦主机接收到 C，则会构建 STX 数据包并发送 给模块。模块接收到 STX 数据包后，响应 ACK 表示模块成功接收到数据包。如果主机在 3 秒内未收到 ACK，将响应 5 次 CAN 表示升级失败；那么，模块需进入 Boot 下载模式进行固件升级。如果主机在 3 秒 内接收到 ACK，主机和模块将重复此过程，直到所有固件数据包被完全发送。一个 STX 数据包的载荷包含 固件的 1024 字节。若最后一个 STX 数据包的数据长度小于 1024 字节，则需填充 0x1A 或 0xFF。发送 STX 包流程图详见图 7：发送 STX、EOT 和空 SOH 包流程图。 上海移远通信技术股份有限公司 27 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 STX 包格式 Header 0x02 Packet Number ~(Packet Number) Payload（1024字节） 0x01 0xFE 传输的数据内容 Checksum CHK1 CHK2 3.5. 发送 EOT 和空 SOH 包 主机成功发送所有 STX 数据包后，向模块发送 EOT 和空 SOH 数据包。模块会响应 2 次 ACK 和 C， 再响应 5 次 CAN，如果 60 秒内主机没收到模块发送的响应，则表示升级失败，需要使用 Boot 下载模式升 级。如果主机在 60 秒内收到响应，则模块会自动重启，然后正常输出 NMEA 消息，表示固件升级成功。 空 SOH 包格式如下表： 空 SOH 数据包格式 Header 0x01 Packet Number ~(Packet Number) Payload（128字节） 0x00 0xFF 0x00 0x00 ... 0x00 Checksum CHK1 CHK2 上海移远通信技术股份有限公司 28 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 发送STX、EOT和空SOH包的流程如下： 主机 模块 如果主机3秒内未收到ACK，将响 应5次CAN表示升级失败。 主机发送第一个STX数据包 模块响应ACK 最大3秒 主机发送第二个STX数据包 模块响应ACK ··· 最大3秒 主机发送最后一个STX数据包 模块响应ACK 主机发送EOT和空SOH数据包 如果主机60秒内未收到模块响应的2次ACK和C 以及5次CAN，则表示升级失败。 模块响应2次ACK和C以及5次CAN 发送成功 最大3秒 最大60秒 图 7：发送 STX、EOT 和空 SOH 包流程图 上海移远通信技术股份有限公司 29 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 4 Boot 下载模式下固件升级流程 本章节主要介绍模块在 Boot 下载模式下进行固件升级的流程，如下图所示： 仅LC260Z (00)和 LC 760 Z支持 开始 解压 缩.cyfm文件 并检查MD5校验 和 否 MD5校验 和是否 正确？ 是 使模 块进入Boot下载 模式 主机 发送BOOT3-RFF-SET或BOOT3-UARTSET命令 设置波 特率为 460 800 bps 否 主机 是否收 到ACK-ACK？ 是 主机 发送BOOT2-SPIFLS INFO-POLL查 询Flash状态 否 主机 是否收 到Flash状态？ 是 主机 发送BOOT2-SPIFLS-WRSR-SET或 BOOT3-FLSEARSE-SET设置Flash状态 寄存 器 否 主机 是否收 到ACK-ACK？ 是 主机 发送BOOT2-FWPG-SET传输 固件 否 主机 是否收 到ACK-ACK？ 是 否 主机 是否发 送完所 有固件 ？ 是 硬件 重启 结束 主机 退出固 件升级 升级 失败，模块 需进入 Boo t下载 模式重 新升级 固件 图 8：Boot 下载模式升级流程图 上海移远通信技术股份有限公司 30 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 备注 有关解压缩文件和检查 MD5 校验结果详情可参考第 2.1 章 固件包和第 2.2 章 MD5 校验。 4.1. 进入 Boot 下载模式 模块进入 Boot 下载模式方式如下，如需了解更多信息，可参考文档 [1]、[2]和[3] 硬件设计手册。 ⚫ LC260Z (00)：在模块启动或复位（RESET_N 由低电平变为高电平）时保持该引脚为高电平约 50 ms，模块进入 Boot 下载模式。 ⚫ LC760Z：在模块启动或复位（RESET_N 由低电平变为高电平）时保持该引脚为低电平约 50 ms， 模块进入 Boot 下载模式。 ⚫ LC29Y (单频 RTK)：在模块启动或复位（RESET_N 由低电平变为高电平）时保持该引脚为低电 平约 50 ms，模块进入 Boot 下载模式。 4.2. 修改波特率 模块与主机连接后，主机会发送 BOOT3-RFF-SET 或者 BOOT3-UART-SET 命令给模块，推荐通过该 命令将波特率修改为 460800 bps。模块响应 ACK-ACK 表明波特率修改成功。 4.3. 设置 Flash 状态寄存器 设置 Flash 状态寄存器时，不同模块设置流程和使用的命令有所差异： ⚫ LC260Z (00)和 LC760Z：主机发送 BOOT2-SPIFLSINFO-POLL 命令来查询 Flash 状态，模块响 应 ACK-ACK，然后再发送 BOOT2-SPIFLS-WRSR-SET 命令来设置 Flash 状态寄存器，模块响 应 ACK-ACK。 ⚫ LC29Y (单频 RTK)：主机发送 BOOT3-FLSEARSE-SET 命令来设置 Flash 状态寄存器，模块响 应 ACK-ACK 上海移远通信技术股份有限公司 31 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 4.4. 发送固件包 模块发送固件包流程如下： ⚫ LC260Z (00)和 LC760Z： 主机发送 BOOT2-FWPG-SET 消息下载固件包到指定地址。固件在 Flash 中从 0x90000000 开始。首 先，主机需在 0x90000000 处发送一个空数据包。然后，主机在 0x90000400 发送第二个固件包并在 0x90000800 发送第三个固件包，直到发送完最后一个固件包。如果最后一个固件包的长度小于 1024 字节， 则该固件包长度为实际固件数据的长度，无需添加任何字符将其拓展至 1024 字节。主机发送完最后一个固 件包后，需要在 0x90000000 处再次发送第一个固件包来补充原来的空数据包。主机每次发送固件包后，模 块均会响应 ACK 表示已成功接收到固件包；若模块在 3 秒内未响应 ACK，则表示固件包接收失败，模块 需进入 Boot 下载模式重新升级固件；若响应 ACK-NAK，则表示发送错误，需重新发送。 ⚫ LC29Y (单频 RTK)： 主机发送 BOOT2-FWPG-SET 消息下载固件包到指定地址。固件在 Flash 中从 0x00100000 开始。首 先，主机需在 0x00100000 处发送一个空数据包。然后，主机在 0x00100400 发送第二个固件包并在 0x00100800 发送第三个固件包，直到发送完最后一个固件包。如果最后一个固件包的长度小于 1024 字节， 则该固件包长度为实际固件数据的长度，无需添加任何字符将其拓展至 1024 字节。主机发送完最后一个固 件包后，需要在 0x00100000 处再次发送第一个固件包来补充原来的空数据包。主机每次发送固件包后，模 块均会响应 ACK 表示已成功接收到固件包；若模块在 3 秒内未响应 ACK，则表示固件包接收失败，模块 需进入 Boot 下载模式重新升级固件；若响应 ACK-NAK，则表示发送错误，需重新发送。 上海移远通信技术股份有限公司 32 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 主机 如果响应ACK-NAK，则发送错误， 需要重新发送。 主机发送空固件包 如果模块在3秒内没有响应则升级失败。 模块响应ACK-ACK 模块 最大3秒 主机发送第二个固件包 如果模块在3秒内没有响应则升级失败。 模块响应ACK-ACK 最大3秒 ··· 主机发送最后一个固件包 如果模块在3秒内没有响应则升级失败。 模块响应ACK-ACK 最大3秒 主机发送第一个固件包 如果模块在3秒内没有响应则升级失败。 模块响应ACK-ACK 最大3秒 发送固件包成功 图 9：发送固件 4.5. 重启模块 硬件重启模块，使模块退出 Boot 下载模式并进入正常工作状态，模块正常输出 NMEA 语句。此时可以 通过查询模块的固件版本信息来确认是否升级到目标固件，进而确认是否升级成功。 上海移远通信技术股份有限公司 33 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 5 固件升级示例 5.1. 正常升级模式下升级固件 5.1.1. LC260Z (00)和 LC760Z 固件升级示例 LC260Z (00)和 LC760Z 在正常升级模式下进行固件升级示例如下： //模块正常输出 NMEA 语句（$GNRMC, 012445.000...）： 24 47 4E 52 4D 43 2C 30 31 32 34 34 35 2E 30 30 30… //主机发送 CFG-PRT 命令修改波特率为 460800 bps： F1 D9 06 00 08 00 00 00 00 00 00 08 07 00 1D BE //模块响应 ACK-ACK 表明波特率修改成功： F1 D9 05 01 02 00 06 00 0E 37 //主机发送 CFG-FWUP 命令： F1 D9 06 50 01 00 01 58 62 //模块响应 ACK-ACK： F1 D9 05 01 02 00 06 50 5E 87 //模块响应 C： 43 //主机发送第一个 SOH 包（128 + 5 字节）： 01 00 FF 48 44 38 31 32 30 2E 31 31 35 32 30 30 2E 39 39 … //模块响应 ACK： 06 //模块响应字符 C： 43 //主机发送第一个 STX 包（1024 + 5 字节）： 02 01 FE 55 55 EF BE 6E 93 52 36 00 00 00 00 00 20 00 00 … //模块响应 ACK： 06 //主机发送第二个 STX 包（1024 + 5 字节）： 02 02 FD FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF ... //模块响应 ACK： 06 … //主机发送最后一个 STX 包（1024 + 5 字节）： 02 77 88 00 00 00 00 00 00 00 00 01 01 00 00 C7 71 2C 00 ... 上海移远通信技术股份有限公司 34 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 //模块响应 ACK： 06 //主机发送 EOT： 04 //主机发送空 SOH 包（128 + 5 字节）： 01 00 FF 00 00 00 00 00 00 00 00 00 00 00 00 00… //模块响应 ACK： 06 //模块响应字符 C： 43 //模块响应 ACK： 06 //模块响应字符 C： 43 //模块响应 5 次 CAN： 18 18 18 18 18 //模块自动重启并恢复默认波特率且正常输出 NMEA 语句（即$GNTXT,02…）： 24 47 4E 54 58 54 2C 30 32… //查询固件版本信息（$PQTMVERNO*58）： 24 50 51 54 4D 56 45 52 4E 4F 2A 35 38 0D 0A //模块返回固件版本信息（$PQTMVERNO,LC760ZAANR01A02,2023/12/21,11:30:00*4E）： 24 50 51 54 4D 56 45 52 4E 4F 2C 4C 43 37 36 30 5A 41 41 4E 52 30 31 41 30 32 2C 32 30 32 33 2F 31 32 2F 32 31 2C 31 31 3A 33 30 3A 30 30 2A 34 45 5.1.2. LC29Y (单频 RTK)固件升级示例 LC29Y (单频 RTK)在正常升级模式下进行固件升级示例如下： //模块正常输出 NMEA 语句（$GNRMC, 012445.000...）： 24 47 4E 52 4D 43 2C 30 31 32 34 34 35 2E 30 30 30… //主机发送 CFG-PRT 命令修改波特率为 460800 bps： F1 D9 06 00 08 00 00 00 00 00 00 08 07 00 1D BE //模块响应 ACK-ACK 表明波特率修改成功： F1 D9 05 01 02 00 06 00 0E 37 //主机发送 CFG-FWUP 命令： F1 D9 06 50 01 00 10 67 71 //模块响应 ACK-ACK： F1 D9 05 01 02 00 06 50 5E 87 //模块响应 C： 43 //主机发送第一个 SOH 包（128 + 5 字节）： 01 00 FF 4C 43 32 36 30 59 30 31 41 41 4E 52 30 31 41 30… //模块响应 ACK： 上海移远通信技术股份有限公司 35 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 06 //模块响应字符 C： 43 //主机发送第一个 STX 包（1024 + 5 字节）： 02 01 FE 55 55 EF BE 59 E9 47 8C 00 00 00 00 00 04 … //模块响应 ACK： 06 //主机发送第二个 STX 包（1024 + 5 字节）： 02 02 FD 00 5E 06 00 F5 08 10 00 8F 05 04 00 01 01 ... //模块响应 ACK： 06 … //主机发送最后一个 STX 包（1024 + 5 字节）： 02 7B 84 F0 28 1A F1 04 1A 16 0C 5A EC 34 5A F2 08 0B 10 E8 6E 3C CA E8 D3 01 1D 1A 1A 1A ... //模块响应 ACK： 06 //主机发送 EOT： 04 //主机发送空 SOH 包（128 + 5 字节）： 01 00 FF 00 00 00 00 00 00 00 00 00 00 00 00 00… //模块响应 ACK： 06 //模块响应字符 C： 43 //模块响应 ACK： 06 //模块响应字符 C： 43 //模块响应 5 次 CAN： 18 18 18 18 18 // 模 块 自 动 重 启 并 恢 复 默 认 波 特 率 且 正 常 输 出 NMEA 语 句 （ 即 当 前 固 件 版 本 信 息 ： $PQTMVER,1,MODULE,LC29YIANR01A01_RQN,2023/11/20,09:40:39*42）： 24 50 51 54 4D 56 45 52 2C 31 2C 4D 4F 44 55 4C 45 2C 4C 43 32 39 59 49 41 4E 52 30 31 41 30 31 5F 52 51 4E 2C 32 30 32 33 2F 31 31 2F 32 30 2C 30 39 3A 34 30 3A 33 39 2A 34 32 上海移远通信技术股份有限公司 36 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 5.2. Boot 下载模式下升级固件 5.2.1. LC260Z (00)和 LC760Z 固件升级示例 LC260Z (00)和 LC760Z 在 Boot 下载模式下进行固件升级示例如下： //模块进入 BOOT 模式： //主机发送 BOOT3-RFF-SET 命令将波特率修改为 460800 bps： F1 D9 F4 00 08 00 80 BA 8C 01 00 08 07 00 D2 49 //模块响应 ACK-ACK 表明波特率修改成功： F1 D9 05 01 02 00 F4 00 FC 13 //主机发送 BOOT2-SPIFLSINFO-POLL 命令来查询 Flash 状态： F1 D9 F4 07 01 00 02 FE E5 //Flash 状态为禁用写保护（小端格式）： F1 D9 F4 07 04 00 00 0A 0E 21 38 44 //主机发送 BOOT2-SPIFLS-WRSR-SET 命令设置 Flash 状态寄存器： F1 D9 F4 13 05 00 00 00 02 00 00 0E 55 //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 13 0F 26 //主机通过 BOOT2-FWPG-SET 命令发送第一个空包来擦除 Flash： F1 D9 F4 05 06 00 00 00 00 90 00 00 8F 95 //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //主机通过 BOOT2-FWPG-SET 消息发送第二个固件包： F1 D9 F4 05 06 04 00 00 04 00 90 01 00 FF FF FF FF FF FF FF FF FF FF… //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //主机通过 BOOT2-FWPG-SET 消息发送第三个固件包： F1 D9 F4 05 06 04 00 00 08 00 90 02 00 FF FF FF FF FF FF FF FF FF FF… //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 … //主机通过 BOOT2-FWPG-SET 信息发送最后一个固件包： F1 D9 F4 05 4A 03 00 D4 05 90 75 01 C7 71 04 00 60 80 00 00… //模块返回 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //主机通过 BOOT2-FWPG-SET 消息发送第一个固件包来补充原来的空数据包： F1 D9 F4 05 06 04 00 00 00 90 75 01 55 55 EF BE 0C D3 89 … //模块返回 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //通过硬件复位重启模块后，模块正常输出 NMEA 语句（即$GNTXT,02…）： 24 47 4E 54 58 54 2C 30 32… //查询固件版本信息（$PQTMVERNO*58）： 24 50 51 54 4D 56 45 52 4E 4F 2A 35 38 0D 0A 上海移远通信技术股份有限公司 37 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 //模块返回固件版本信息（$PQTMVERNO,LC760ZAANR01A02,2023/12/21,11:30:00*4E）： 24 50 51 54 4D 56 45 52 4E 4F 2C 4C 43 37 36 30 5A 41 41 4E 52 30 31 41 30 32 2C 32 30 32 33 2F 31 32 2F 32 31 2C 31 31 3A 33 30 3A 30 30 2A 34 45 5.2.2. LC29Y (单频 RTK)固件升级示例 LC29Y (单频 RTK)在 Boot 下载模式下进行固件升级示例如下： //模块进入 BOOT 模式： //主机发送 BOOT3-UART-SET 命令将波特率修改为 460800 bps： F1 D9 F4 03 08 00 00 08 07 00 00 08 07 00 1D 69 //模块响应 ACK-ACK 表明波特率修改成功： F1 D9 05 01 02 00 F4 03 FF 16 //主机发送 BOOT3-FLSEARSE-SET 命令设置 Flash 状态寄存器： F1 D9 F4 08 04 00 00 02 00 80 82 76 //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 08 04 1B //主机发送一个空数据包并使用 BOOT2-FWPG-SET 命令擦除 Flash： F1 D9 F4 05 06 00 00 00 10 00 00 00 0F 25 //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //主机通过 BOOT2-FWPG-SET 命令发送第二个固件包： F1 D9 F4 05 06 04 00 04 10 00 01 00 00 5E 06 00 … 4F 8F BF F3 01 0F //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //主机通过 BOOT2-FWPG-SET 命令发送第三个固件包： F1 D9 F4 05 06 04 00 08 10 00 02 00 6F 8F 54 F0 … 52 1C D2 B2 C2 F1 //模块响应 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 … //主机通过 BOOT2-FWPG-SET 信息发送最后一个固件包： F1 D9 F4 05 1E 00 00 E8 15 00 7A 01 F0 28 1A F1 … E8 6E 3C CA E8 D3 01 1D 10 ED //模块返回 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 //主机通过 BOOT2-FWPG-SET 消息发送第一个固件包来补充原来的空数据包： F1 D9 F4 05 06 04 00 00 10 00 7B 01 55 55 EF BE …00 00 00 00 00 00 00 00 00 67 24 //模块返回 ACK-ACK： F1 D9 05 01 02 00 F4 05 01 18 // 通 过 硬 件 复 位 重 启 模 块 后 ， 模 块 正 常 输 出 NMEA 语 句 （ 即 当 前 固 件 版 本 信 息 ： $PQTMVER,1,MODULE,LC29YIANR01A01_RQN,2023/11/20,09:40:39*42）： 24 50 51 54 4D 56 45 52 2C 31 2C 4D 4F 44 55 4C 45 2C 4C 43 32 39 59 49 41 4E 52 30 31 41 30 31 5F 52 51 4E 2C 32 30 32 33 2F 31 31 2F 32 30 2C 30 39 3A 34 30 3A 33 39 2A 34 32 上海移远通信技术股份有限公司 38 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 6 使用 QGNSS 工具升级固件示例 本章节主要介绍 QGNSS 工具 2 种升级模式，以及通过 QGNSS 工具对模块进行固件升级流程。 6.1. 升级模式 QGNSS 工具中默认包含下列升级模式，详细信息列举如下： 表 16：升级模式说明 升级模式 Download （Boot 下载模式） Upgrade （正常升级模式） 适用场景 Bootloader 使用 Upgrade 模式升级失败时，需采用 Download 模式升级模块的 APP 固件。 保留 在此模式下升级固件，需重启模块。 升级模块的 APP 固件。 在此模式下升级固件，无需重启模块。 保留 配置信息 擦除 擦除 许可证信息 保留 保留 6.2. 正常升级模式下固件升级流程 本章节以 LC760Z 为例，介绍如何使用移远通信 EVB 并通过 QGNSS 工具在正常升级模式下对模块进 行固件升级。 注意： 升级固件前，请确保 EVB 已连接 PC 并正常上电。正常连接并上电后，可在'设备管理器'中查看模 块所使用的端口，如下图所示： 上海移远通信技术股份有限公司 39 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 图 10：设备管理器 正常升级模式下固件升级步骤如下： 步骤 1 打开 QGNSS 工具后，点击 进入'Device Information'窗口。详见图 11：设备信息。 步骤 2 选择待升级模块的型号。 步骤 3 选择对应的端口号。 步骤 4 选择通信波特率，默认波特率：115200 bps。 步骤 5 点击'OK'。 上海移远通信技术股份有限公司 40 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 图 11：设备信息 步骤 6 点击工具栏中的'Tools'，详见图 12：固件下载。 步骤 7 点击'Tools'下拉菜单中的'Firmware Download'，打开固件下载界面。 图 12：固件下载 步骤 8 在新窗口中点击 选择在正常升级模式下升级固件，详见图 13：加载固件。关于升级模式 说明，详见表 16：升级模式说明。 步骤 9 点击 选择升级使用的固件包，固件包名称后缀为.cyfm，详见图 14：选择升级固件包。 步骤 10 点击 开始固件升级。 上海移远通信技术股份有限公司 41 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 图 13：加载固件 步骤 11 等待升级完成。 图 14：选择升级固件包 图 15：等待升级完成 上海移远通信技术股份有限公司 42 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 步骤 12 升级完成，模块自动重启后，使用$PQTMVERNO*58来查询固件版本信息，若模块响应 $PQTMVERNO,LC760ZAANR01A02,2023/12/21,11:30:00*4E，和下图中的固件版本信息 一致，则固件升级成功。 图 16：升级完成 6.3. Boot 下载模式下固件升级流程 本章节以 LC760Z 为例，介绍如何使用移远通信 EVB 并通过 QGNSS 工具在 Boot 下载模式下对模块 进行固件升级。 注意： 1. 升级固件前，请确保 EVB 板已连接 PC 并正常上电。正常连接并上电后，可在'设备管理器'中 查看模块所使用的端口，详见图 10：设备管理器。 2. Boot 下载模式下的固件升级流程步骤 1 至步骤 7 和正常模式下的固件升级流程完全相同，详请可 参考第 6.2 章 正常升级模式下固件升级流程。 Boot 下载模式下固件升级差异步骤如下： 步骤 8 在新窗口中点击 选择在 Boot 下载模式下升级固件，详见图 17：加载固件。关于升级模 式说明，详见表 16：升级模式说明。 步骤 9 点击 选择升级使用的固件包 固件包名称后缀为.cyfm，详见图 18：选择升级固件包。 步骤 10 点击 开始固件升级。 上海移远通信技术股份有限公司 43 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 图 17：加载固件 步骤 11 等待升级完成。 图 18：选择升级固件包 图 19：等待升级完成 上海移远通信技术股份有限公司 44 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 步骤 12 升级完成，通过硬件复位重启模块后，使用$PQTMVERNO*58来查询固件版本信息，若模块响 应$PQTMVERNO,LC760ZAANR01A02,2023/12/21,11:30:00*4E，和下图中的固件版本信息 一致，则固件升级成功。 图 20：升级完成 上海移远通信技术股份有限公司 45 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 7 附录 A 参考文档及术语缩写 表 17：参考文档 文档名称 [1] Quectel_LC260Z 系列_硬件设计手册 [2] Quectel_LC760Z_硬件设计手册 [3] Quectel_LC29Y(单频 RTK)_硬件设计手册 表 18：术语和缩写 缩写 ACK APP CAN CRC EOT GNSS MD5 MSB NAK SOH SPI STX UART 英文全称 Acknowledgement Application Program Cancel Cyclic Redundancy Check End of Transmission Global Navigation Satellite System Message Digest Algorithm 5 Most Significant Bit Negative Acknowledgement Start of Header Serial Peripheral Interface Start of Text Universal Asynchronous Receiver/Transmitter 中文全称 确认应答 应用程序 取消 校验和 传输结束。 全球卫星导航系统 信息摘要算法 5 最高有效位 否认应答。 数据头开始 串行外设接口 文本内容开始 通用异步接收/发送器 上海移远通信技术股份有限公司 46 / 47 LC260Z(00)&LC760Z&LC29Y(单频 RTK)固件升级指导 8 附录 B 特殊符号 表 19：特殊符号 特殊符号 下划线 ~ 描述 参数的默认设置。 按位取反。 上海移远通信技术股份有限公司 47 / 47

LC79D (C) DR Application Note GNSS Module Series Version: 1.0 Date: 2022-04-26 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LC79D(C)_DR_Application_Note 1 / 22 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. LC79D(C)_DR_Application_Note 2 / 22 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LC79D (C) DR Application Note GNSS Module Series Application Note Released Revision History Version Date Description - 2022-03-17 Creation of the document 1.0 2022-04-26 First official release LC79D(C)_DR_Application_Note 3 / 22 GNSS Module Series Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 2 Configuration........................................................................................................................................ 7 2.1. Orientation................................................................................................................................... 7 2.2. IMU Mounting.............................................................................................................................. 9 2.3. Calibration ................................................................................................................................. 10 3 Messages ............................................................................................................................................ 11 3.1. PQTM Messages ...................................................................................................................... 11 3.1.1. PQTMINS ....................................................................................................................... 11 3.1.2. PQTMIMU ...................................................................................................................... 12 3.1.3. PQTMGPS ..................................................................................................................... 13 3.1.4. PQTMIMUTYPE ............................................................................................................. 14 3.1.5. PQTMRESETINSCFG ................................................................................................... 14 3.1.6. PQTMSETINSMSG........................................................................................................ 15 3.1.7. PQTMGETINSMSG ....................................................................................................... 16 3.1.8. PQTMSETINSPROFILE ................................................................................................ 16 3.1.9. PQTMGETINSPROFILE ................................................................................................ 17 3.1.10. PQTMSETMETERSPERTICK ....................................................................................... 18 3.1.11. PQTMGETMETERSPERTICK....................................................................................... 19 3.1.12. PQTMSETORIENTATION.............................................................................................. 19 3.1.13. PQTMGETORIENTATION ............................................................................................. 20 4 Appendix References ........................................................................................................................ 22 LC79D(C)_DR_Application_Note 4 / 22 GNSS Module Series Figure Index Figure 1: Reference Frame .......................................................................................................................... 7 Figure 2: IMU Orientation ............................................................................................................................. 7 Figure 3: IMU Installation Example 1 ........................................................................................................... 8 Figure 4: IMU Installation Example 2 ........................................................................................................... 8 Figure 5: Yaw Angle ..................................................................................................................................... 9 Figure 6: Pitch and Roll Angles .................................................................................................................. 10 LC79D(C)_DR_Application_Note 5 / 22 GNSS Module Series 1 Introduction This document describes the dead reckoning (DR) feature, and related IMU mounting, calibration, and messages of Quectel LC79D (C) module. Since there is no IMU in LC79D (C) module, you need to connect an IMU to the module via I2C interface. LC79D (C) supports the following IMUs: ⚫ LSM6DSR ⚫ ICM40608 ⚫ BMI160 ⚫ ICM42670 LC79D(C)_DR_Application_Note 6 / 22 GNSS Module Series 2 Configuration This chapter outlines how to configure the module’s DR function, including orientation, mounting and calibration on LSM6DSR as a reference example. 2.1. Orientation The definitions of the reference frame are shown below. The X-axis represents the vehicle forward direction, the positive direction of Y-axis is pointing to the right side of the vehicle, and the positive direction of Z-axis is pointing downwards. Z Figure 1: Reference Frame IMU orientation is shown below: Z Figure 2: IMU Orientation LC79D(C)_DR_Application_Note 7 / 22 GNSS Module Series Some IMU installation examples are shown below: If the IMU is installed as that in the figure below, the positive direction of X-axis is inverted, the positive direction of Y-axis is the same as that in the reference frame, and the direction of Z-axis is also inverted compared to the reference frame. Therefore, the IMU axes with respect to the fixed reference frame should be configured as $PQTMSETORIENTATION,-XY-Z*7B, in which the is set as -XY-Z. Z Y X Figure 3: IMU Installation Example 1 If the IMU is installed as in the figure below, the X-axis is inverted to the direction of Y-axis of the reference frame, the Y-axis is inverted to the direction of the X-axis of the reference frame, and Z-axis is inverted to the direction of the Z-axis of reference frame. Therefore, the IMU axes with respect to the fixed reference frame should be configured as $PQTMSETORIENTATION,-Y-X-Z*56, in which the is set as -Y-X-Z. Z X Y Figure 4: IMU Installation Example 2 LC79D(C)_DR_Application_Note 8 / 22 GNSS Module Series NOTE Save the orientation configurations to flash with $PQTMSAVEPAR*5A and restart the module. See document [1] for details. 2.2. IMU Mounting When mounting the IMU on the vehicle, you need to keep the yaw, pitch and roll angles within 5 degrees of the reference frame. Forward α Figure 5: Yaw Angle LC79D(C)_DR_Application_Note 9 / 22 Forward GNSS Module Series β Figure 6: Pitch and Roll Angles When mounting the IMU, make sure that -5°≤ α ≤ 5°, -5°≤ β ≤ 5°. 2.3. Calibration DR calibration steps: Step 1: Fix the module and IMU on the vehicle frame. No matter how small the displacement, rotation or tilt of the IMU, it can cause performance issues and/or invalid calibration. Step 2: Calibration should be performed under good GNSS signal and clear sky conditions. Step 3: Power up the module, then start the vehicle on a flat surface and keep it still for at least 30 s. Step 4: Drive the vehicle under good GNSS signal conditions. The module will start self-calibration, which can be completed in a few minutes. Step 5: The calibration process ends when the of $PQTMINS message indicates a combination solution (GNSS + DR). See Chapter 3.1.1 for details about the message. LC79D(C)_DR_Application_Note 10 / 22 GNSS Module Series 3 Messages 3.1. PQTM Messages This chapter outlines the PQTM messages (proprietary NMEA messages defined by Quectel) supported by Quectel LC79D (C) module, see document [1] for details. 3.1.1. PQTMINS This message outputs navigation results. Type: Output. Synopsis: $PQTMINS,,,,,,,,,,,* Parameter: Field Format Unit Numeric ms Numeric - Numeric Numeric Numeric Numeric Degree Degree Meter m/s Description Milliseconds since power-on. 32-bit unsigned integer. Position solution type. 0 = DR not ready. Roll and Pitch ready. 1 = GNSS, Roll, Pitch and Relative Heading ready. DR not ready. 2 = GNSS + DR mode. DR calibrated. 3 = DR only mode. Latitude Longitude Height Northward velocity LC79D(C)_DR_Application_Note 11 / 22 GNSS Module Series Numeric Numeric Numeric Numeric Numeric m/s m/s Degree Degree Degree Eastward velocity Downward velocity Roll angle Pitch angle Heading angle Example: $PQTMINS,42529,1,31.822038000,117.115182800,67.681000,,,,-0.392663,1.300793,0.030088*4D NOTE All angles are scaled from -180.0 to 179.9 with a wrap-around to 0.0 at +180.0. -180.0 = South, 180.0/0.0 = North, +90.0 = East, and -90.0 = West. 3.1.2. PQTMIMU This message outputs the IMU raw data: acceleration, angular rate and hardware wheel ticks. Type: Output. Synopsis: $PQTMIMU,,,,,,,,< TickCount>,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit ms g g g deg/s deg/s Description Milliseconds since turn-on. 32-bit unsigned integer. Acceleration in X-axis direction. Acceleration in Y-axis direction. Acceleration in Z-axis direction. Angular rate in X-axis direction. Angular rate in Y-axis direction. LC79D(C)_DR_Application_Note 12 / 22 GNSS Module Series Numeric Numeric Numeric deg/s ms Angular rate in Z-axis direction. Cumulative ticks. Last tick timestamp. Example: $PQTMIMU,42634,-0.006832,-0.022814,1.014552,0.315000,-0.402500,-0.332500,0,0*55 3.1.3. PQTMGPS This message outputs the GNSS positioning status. Type: Output. Synopsis: $PQTMGPS,,,,,,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit ms Second Degree Degree Meter Meter m/s Degree Meter - Description Milliseconds since turn-on. 32-bit unsigned integer. Time of week. Latitude. Longitude. Earth ellipsoid surface. Altitude above mean-sea-level (geoid). Ground speed (two-dimensional). Heading of vehicle (two-dimensional). Estimated horizontal accuracy. Horizontal dilution of precision. Position (3D) dilution of precision. LC79D(C)_DR_Application_Note 13 / 22 GNSS Module Series Numeric - Numeric - Fix type. 0 = No fix. 2 = 2D fix. 3 = 3D fix. Number of navigation satellites. Example: $PQTMGPS,671335,463792.000,31.822084600,117.115221100,59.4260,63.0420,0.0270,-171.7101,5.9 890,1.3300,2.1100,3,18,*75 3.1.4. PQTMIMUTYPE This message outputs the IMU type (only once after booting). Type: Output. Synopsis: $PQTMIMUTYPE,* Parameter: Field Format Numeric Unit Description IMU type. 0 = None. 1 = LSM6DSR 2 = ICM40608 3 = BMI160 4 = ICM42670 Example: $PQTMIMUTYPE,1*4C 3.1.5. PQTMRESETINSCFG This message resets all INS functionalities to factory default settings. Type: Command. LC79D(C)_DR_Application_Note 14 / 22 Synopsis: $PQTMRESETINSCFG* Parameter: None. Result: ⚫ If successful, the module returns: $PQTMRESETINSCFGOK*5F ⚫ If failed, the module returns: $PQTMRESETINSCFGERROR*03 Example: $PQTMRESETINSCFG*5B $PQTMRESETINSCFGOK*5F GNSS Module Series 3.1.6. PQTMSETINSMSG This message sets the $PQTMINS and $PQTMIMU message rates. Type: Set. Synopsis: $PQTMSETINSMSG,,,* Parameter: Field Format Unit Numeric - Numeric - Numeric Hz Description 0 = Disable $PQTMINS message 1 = Enable $PQTMINS message 0 = Disable $PQTMIMU message 1 = Enable $PQTMIMU message Output rate. 100: Maximum output rate. It can reach about 70 Hz at 460800 bps and depends on CPU loading. 20: 20 Hz 10: 10 Hz LC79D(C)_DR_Application_Note 15 / 22 Result: ⚫ If successful, the module returns: $PQTMSETINSMSGOK*53 ⚫ If failed, the module returns: $PQTMRESETINSCFGERROR*03 Example: $PQTMSETINSMSG,0,0,0*4B $PQTMSETINSMSGOK*53 GNSS Module Series 3.1.7. PQTMGETINSMSG This message gets the current $PQTMINS and $PQTMIMU message rate configuration. Type: Get. Synopsis: $PQTMGETINSMSG* Parameter: None. Result: Return the current configuration. $PQTMINSMSG,,,* Example: $PQTMGETINSMSG*43 $PQTMINSMSG,0,0,100*08 3.1.8. PQTMSETINSPROFILE This message sets the INS operation type. Type: Set. LC79D(C)_DR_Application_Note 16 / 22 GNSS Module Series Synopsis: $PQTMSETINSPROFILE,,,* Parameter: Field Format Unit Numeric - Numeric - Numeric - Description Vehicle type. 2: 2-Wheel Vehicle 4: 4-Wheel Vehicle Odometer (Wheel tick) input type. 0: No Odometer 1: Hardware Input. 2: Serial Input. Whether seed solution is used. 0: No Seed Solution Used 1: Seed Solution NOTE Even if the input type is configured as 1 or 2, it will automatically detect whether there is actual input. Result: ⚫ If successful, the module returns: $PQTMSETINSPROFILEOK*41 ⚫ If failed, the module returns: $PQTMSETINSPROFILEERROR*1D Example: $PQTMSETINSPROFILE,2,1,0*5A $PQTMSETINSPROFILEOK*41 3.1.9. PQTMGETINSPROFILE This message gets the INS operation type. Type: Get. LC79D(C)_DR_Application_Note 17 / 22 GNSS Module Series Synopsis: $PQTMGETINSPROFILE* Parameter: None. Result: Return the current configuration. $PQTMINSPROFILE,,,* Example: $PQTMGETINSPROFILE*51 $PQTMINSPROFILE,2,1,0*18 3.1.10. PQTMSETMETERSPERTICK This message sets the calibration of meters per tick. Type: Set. Synopsis: $PQTMSETMETERSPERTICK,* Parameter: Field Format Numeric Unit Meter Description Value in meters per tick. Result: ⚫ If successful, the module returns: $PQTMSETMETERSPERTICKOK*14 ⚫ If failed, the module returns: $PQTMSETMETERSPERTICKERROR*48 Example: $PQTMSETMETERSPERTICK,0.02*20 $PQTMSETMETERSPERTICKOK*14 LC79D(C)_DR_Application_Note 18 / 22 GNSS Module Series 3.1.11. PQTMGETMETERSPERTICK This command returns the current calibration of meters per tick, the status and types of calibration automatic, manual (fixed), or no calibration. Type: Get. Synopsis: $PQTMGETMETERSPERTICK* Parameter: None. Result: Return the current calibration of meters per tick: $PQTMMETERSPERTICK,,* Field Format Numeric Numeric Unit Meter Description Wheel tick calibration type. 0: Uncalibrated 1: Auto-calibrated 2: Manual (Fixed) calibration Calibration value of meters per tick. Example: $PQTMGETMETERSPERTICK*04 $PQTMMETERSPERTICK,2,0.0200000*4C 3.1.12. PQTMSETORIENTATION This message sets the IMU axes with respect to the fixed reference frame. For more information about how to configure orientation, see Chapter 2.1. Type: Set. LC79D(C)_DR_Application_Note 19 / 22 GNSS Module Series Synopsis: $PQTMSETORIENTATION,* Parameter: Field Format Unit String - Description String representing the X, Y, and Z axis of body frame in the reference frame. A leading '-' represents the body axis pointing in direction opposite to reference axis. Result: ⚫ If successful, the module returns: $PQTMSETORIENTATIONOK*08 ⚫ If failed, the module returns: $PQTMSETORIENTATIONERROR*54 Example: $PQTMSETORIENTATION,XYZ*7B $PQTMSETORIENTATIONOK*08 3.1.13. PQTMGETORIENTATION This message gets the IMU axes with respect to the fixed reference frame. For more information about how to configure the orientation, see Chapter 2.1. Type: Get. Synopsis: $PQTMSETORIENTATION* Parameter: None. Result: Return the current orientation configuration. $PQTMORIENTATION,* LC79D(C)_DR_Application_Note 20 / 22 Example: $PQTMGETORIENTATION*18 $PQTMORIENTATION,-Y-X-Z*14 GNSS Module Series LC79D(C)_DR_Application_Note 21 / 22 GNSS Module Series 4 Appendix References Table 11: Related Document Document Name [1] Quectel_LC79D(C)_Protocol_Specification Table 2: Terms and Abbreviations Abbreviation DR GNSS GPS HDOP IMU INS NMEA PDOP Description Dead Reckoning Global Navigation Satellite System Global Positioning System Horizontal Dilution of Precision Inertial Measurement Unit Inertial Navigation System NMEA (National Marine Electronics Association) 0183 Interface Standard Position Dilution of Precision LC79D(C)_DR_Application_Note 22 / 22

LC79D (A) AGNSS Application Note GNSS Module Series Rev. LC79D(A)_AGNSS_Application_Note_V1.0 Date: 2020-07-03 Status: Released www.quectel.com GNSS Module Series LC79D (A) AGNSS Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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 WITHOUT PERMISSION ARE FORBIDDEN. 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. 2020. All rights reserved. LC79D(A)_AGNSS_Application_Note 1 / 25 GNSS Module Series LC79D (A) AGNSS Application Note About the Document Revision History Version Date Author Description 1.0 2020-07-03 Jenn XIANG Initial LC79D(A)_AGNSS_Application_Note 2 / 25 GNSS Module Series LC79D (A) AGNSS Application Note Contents About the Document .................................................................................................................................. 2 Contents ...................................................................................................................................................... 3 Table Index.................................................................................................................................................. 4 Figure Index ................................................................................................................................................ 5 1 Introduction ......................................................................................................................................... 6 2 AGNSS Implementation...................................................................................................................... 7 2.1. NMEA Commands for AGNSS Implementation ......................................................................... 7 2.1.1. $PQSTARTGNSS ........................................................................................................... 7 2.1.2. $PQSTOPGNSS ............................................................................................................. 8 2.1.3. $PQSETASSPOS ........................................................................................................... 8 2.1.4. $PQSETASSTIME .......................................................................................................... 9 2.1.5. $PQSETASSGNSS ....................................................................................................... 10 2.1.6. $PQLTODOWNLOAD ................................................................................................... 12 2.2. Sending LTO Data to the Module............................................................................................. 12 2.2.1. Download LTO File from Server.................................................................................... 12 2.2.2. Send LTO Data to the Module....................................................................................... 13 2.2.2.1. Enter LTO Data Downloading Mode .................................................................. 15 2.2.2.2. Send LTO File Information to Module ................................................................ 15 2.2.2.3. Erase LTO Data Area ......................................................................................... 17 2.2.2.4. Send LTO Data to Module.................................................................................. 17 2.2.2.5. Perform CRC32 Verification ............................................................................... 17 3 AGNSS Testing Procedure .............................................................................................................. 18 3.1. Prerequisites ............................................................................................................................ 18 3.2. Procedure................................................................................................................................. 19 3.3. Results ..................................................................................................................................... 24 4 Appendix A References.................................................................................................................... 25 LC79D(A)_AGNSS_Application_Note 3 / 25 GNSS Module Series LC79D (A) AGNSS Application Note Table Index Table 1: The List of NMEA Proprietary Commands for AGNSS Implementation......................................... 7 Table 2: File Information’s Format.............................................................................................................. 16 Table 3: List of Constants ........................................................................................................................... 16 Table 4: Related Documents ...................................................................................................................... 25 Table 5: Terms and Abbreviations .............................................................................................................. 25 LC79D(A)_AGNSS_Application_Note 4 / 25 GNSS Module Series LC79D (A) AGNSS Application Note Figure Index Figure 1: Flowchart for Sending LTO Data to the Module ......................................................................... 14 Figure 2: Example Procedure for Sending LTO Data to the Module ......................................................... 15 LC79D(A)_AGNSS_Application_Note 5 / 25 GNSS Module Series LC79D (A) AGNSS Application Note 1 Introduction The LC79D (A) GNSS module supports AGNSS feature that significantly reduces the module’s TTFF, especially in lower signal conditions. To implement AGNSS feature, the module should get the assistance data including the current time, rough position, and LTO data. Consult the following document to find out how to send the assistance data to the module. The list of all NMEA commands that are used by AGNSS feature is also given for your reference. Before using the AGNSS feature, make sure to verify that everything is correctly set. For more information on testing the module, see the chapter AGNSS Testing Procedure. LC79D(A)_AGNSS_Application_Note 6 / 25 GNSS Module Series LC79D (A) AGNSS Application Note 2 AGNSS Implementation The chapter introduces the AGNSS implementation on LC79D (A) GNSS module, which includes the list of NMEA proprietary commands and the procedure for sending LTO data to the module. 2.1. NMEA Commands for AGNSS Implementation The LC79D(A) module can be controlled and configured through NMEA proprietary commands defined by Quectel (PQ commands). Table 1: The List of NMEA Proprietary Commands for AGNSS Implementation Command Description $PQSTARTGNSS Start the GNSS engine $PQSTOPGNSS Stop the GNSS engine $PQSETASSPOS Send the assistance position to the module $PQSETASSTIME Send the assistance time to the module $PQSETASSGNSS Send the assistance position and time to the module $PQLTODOWNLOAD Set the module into LTO-data downloading mode 2.1.1. $PQSTARTGNSS The $PQSTARTGNSS command starts the GNSS engine. Synopsis: $PQSTARTGNSS* Arguments: None. LC79D(A)_AGNSS_Application_Note 7 / 25 GNSS Module Series LC79D (A) AGNSS Application Note Results:  In case of no error, the GNSS engine is started with the following message: $PQSTARTGNSSOK*4C  In case of any errors, the returned message is: $PQSTARTGNSSERROR*10 Example: $PQSTARTGNSS*48 $PQSTARTGNSSOK*4C 2.1.2. $PQSTOPGNSS The $PQSTOPGNSS command stops the GNSS engine. Synopsis: $PQSTOPGNSS* Arguments: None. Results:  In case of no error, the GNSS engine is stopped with the following message: $PQSTOPGNSSOK*14  In case of any errors, the returned message is: $PQSTOPGNSSERROR*48 Example: $PQSTOPGNSS*10 $PQSTOPGNSSOK*14 2.1.3. $PQSETASSPOS The $PQSETASSPOS command sends the assistance position to the module. LC79D(A)_AGNSS_Application_Note 8 / 25 GNSS Module Series LC79D (A) AGNSS Application Note Synopsis: $PQSETASSPOS,,,[,,]* Arguments: Parameter lat lon alt hor_acc ver_acc checksum Format DD.DDDDDD DDD.DDDDDD Decimal dddd.d-Decimal dddd.d-Decimal Hexadecimal, 2 digits Description Latitude (-90 to 90 degrees) Longitude (-180 to 180 degrees) Altitude in meters. Optional. Horizontal accuracy Optional. Vertical accuracy Checksum of the message bytes between but not including the $ and * characters Results:  In case of no error, the returned message is: $PQSETASSPOSOK*4A  In case any errors, the returned message is: $PQSETASSPOSERROR*16 Example: $PQSETASSPOS,31.786545,112.455235,12.2*40 $PQSETASSPOSOK*4A NOTES 1. The GNSS engine must be stopped before sending the assistance position. 2. The overall accuracy of the assistance position must be within 30 km range. 2.1.4. $PQSETASSTIME The $PQSETASSTIME command sends the assistance time to the module in the UTC format. The time must be after May 2019. Synopsis: $PQSETASSTIME,,,,,,* LC79D(A)_AGNSS_Application_Note 9 / 25 GNSS Module Series LC79D (A) AGNSS Application Note Arguments: Parameter year month day hour min sec checksum Format Integer Integer Integer Integer Integer Integer Hexadecimal, 2 digits Description Year (2019–…) Month (01–12) Day of month (01–31) Hour (00–23) Minute (00–59) Second (00–59) Checksum of the message bytes between but not including the $ and * characters Results:  In case of no error, the returned message is: $PQSETASSTIMEOK*13  In case of any errors, the returned message is: $PQSETASSTIMEERROR*4F Example: $PQSETASSTIME,2019,06,06,18,20,32*17 $PQSETASSTIMEOK*13 NOTES 1. The GNSS engine must be stopped before sending the assistance time. 2. The overall accuracy of the assistance time must be lower than 3 seconds. 2.1.5. $PQSETASSGNSS The $PQSETASSGNSS command sends the assistance location and the assistance time in the UTC format to the module. The time must be after May 2019. Synopsis: $PQSETASSGNSS,,,,,,,,,*< LF> LC79D(A)_AGNSS_Application_Note 10 / 25 GNSS Module Series LC79D (A) AGNSS Application Note Arguments: Parameter lat lon alt year month day hour min sec checksum Format DD.DDDDDD DDD.DDDDDD Decimal Integer Integer Integer Integer Integer Integer Hexadecimal, 2 digits Description Latitude (-90 to 90 degrees) Longitude (-180 to 180 degrees) Altitude in meters Year (2019–…) Month (01–12) Day of month (01–31) Hour (00–23) Minute (00–59) Second (00–9) Checksum of the message bytes between but not including the $ and * characters Results:  In case of no error, the returned message is: $PQSETASSGNSSOK*0F  In case of any errors, the returned message is: $PQSETASSGNSSERROR*53 Example: $PQSETASSGNSS,31.786545,112.455235,12.2,2019,06,06,18,20,32*05 $PQSETASSGNSSOK*0F NOTES 1. The GNSS engine must be stopped before sending the assistance position and time. 2. The accuracy of the assistance position must be lower than 30 kilometers and the accuracy of assistance time must be less than 3 seconds. LC79D(A)_AGNSS_Application_Note 11 / 25 GNSS Module Series LC79D (A) AGNSS Application Note 2.1.6. $PQLTODOWNLOAD The $PQLTODOWNLOAD command stops the GNSS engine and sets the module into LTO-data downloading mode, so that it is ready for receiving the data sent from the host side. Synopsis: $PQLTODOWNLOAD* Arguments: None. Results:  In case of no error, the returned message is: $PQLTODOWNLOADOK*46  In case of any errors, the returned message is: $PQLTODOWNLOADERROR*1A Example: $PQLTODOWNLOAD*42 $PQLTODOWNLOADOK*46 2.2. Sending LTO Data to the Module 2.2.1. Download LTO File from Server Before sending LTO data to the module, the host has to download the LTO file. The LTO file can be downloaded from Quectel AGNSS server, and it’s valid up to 7 days. Quectel AGNSS server: ftp://agnss.queclocator.com Quectel AGNSS server supports the download of LTO files that have 2, 4 or 7-day validity. The LTO files have the 'lto2_xday.dat' naming structure, where the x refers to the days of validity and can be each one of the following options: 2, 4 or 7. LC79D(A)_AGNSS_Application_Note 12 / 25 GNSS Module Series LC79D (A) AGNSS Application Note NOTES 1. Quectel AGNSS server is free of charge and there is no SLA while using the server. However, to access and use the Quectel AGNSS server, customers must have an account. Contact Quectel’s Technical Support team (support@quectel.com) to apply for the account. 2. Customers must create their own server’s instance and download the LTO files to their own server instances. 2.2.2. Send LTO Data to the Module The following chart illustrates the procedure for sending LTO data to the module. NOTE In addition to transferring the LTO data to the module directly through the host, the LTO file can also be uploaded to the module with a QGNSS tool. For details, see Chapter 3. For more information on the QGNSS tool, see document [2]. LC79D(A)_AGNSS_Application_Note 13 / 25 GNSS Module Series LC79D (A) AGNSS Application Note Host sends command to start LTO data downloading procedure N Response is OK? Y Module enters LTO data downloading mode. Host sends LTO file information frame to the module. LTO file Information N received OK? Y Module sends 'LTO_ACK' Module is erasing flash LTO data area. Module erases flash with N success? Y Module sends 'LTO_ACK' HOST sends LTO data to the module. N Transfer complete? Y Module calculates CRC and compares it with the value received in LTO information frame by the HOST. N CRC passed? Y Module sends 'LTO_ACK' Module sends 'LTO_NACK' Module exits LTO download mode. Figure 1: Flowchart for Sending LTO Data to the Module LC79D(A)_AGNSS_Application_Note 14 / 25 GNSS Module Series LC79D (A) AGNSS Application Note HOST LC79D Send command to LC79D Send LTO file info to LC79D (see the example) $PQLTODOWNLOAD*42 $PQLTODOWNLOADOK*46 AA 01 01 08 4D A4 01 00 4E 6E 07 E6 21 55 CC CC Packet1 LC79D receives it with success LC79D responds with 'ACK' LC79D responds with 'ACK' if flash is erased CC Send LTO data to LC79D, 16KB for each packet, except the last one Packet2 CC ... PacketN LC79D responds with 'ACK' for each packet it successfully receives CC CC LC79D sends 'ACK' if CRC verification is OK. Figure 2: Example Procedure for Sending LTO Data to the Module 2.2.2.1. Enter LTO Data Downloading Mode $PQLTODOWNLOAD command starts the LTO data downloading procedure. If the module receives this command successfully, it enters the LTO data downloading mode. Example: $PQLTODOWNLOAD*42 $PQLTODOWNLOADOK*46 2.2.2.2. Send LTO File Information to Module Before sending LTO data to the module, the host must send the LTO file information to the module. The file information includes the file size and CRC32 value. The following illustrates the format of file LC79D(A)_AGNSS_Application_Note 15 / 25 information frames: GNSS Module Series LC79D (A) AGNSS Application Note Table 2: File Information’s Format File Information Frame Format Header 0xAA Class 0x01 ID 0x01 Length 0x08 LTO File Size 4 Bytes LTO File CRC32 4 Bytes Checksum Trailer 1 Byte 0x55 Description Fixed as 0xAA Fixed as 0x01 Fixed as 0x01 Payload length (LTO File Size field and LTO File CRC32 field) Byte size of LTO file: 4 bytes; use little-endian mode This is the CRC32 code calculated first on the LTO file size field and then over the entire LTO file payload: 4 bytes in little-endian mode Use XOR to calculate LTO File Size field and LTO File CRC32 field Fixed as 0x55 If the module receives the file information frames successfully, the module returns LTO_ACK; otherwise, LTO_NACK is sent. Table 3: List of Constants Constant’s Name LTO_ACK LTO_NACK Constant’s Value 0xCC 0xDD Example: //In Hex mode AA 01 01 08 4D A4 01 00 4E 6E 07 E6 21 55 //The host sends LTO file information frames to the module CC //The module receives the frames successfully LC79D(A)_AGNSS_Application_Note 16 / 25 GNSS Module Series LC79D (A) AGNSS Application Note 2.2.2.3. Erase LTO Data Area After the module has received LTO file information frames and returned LTO_ACK, the module erases the LTO data area in flash. After the flash erasure process is finished, LTO_ACK is returned once again. 2.2.2.4. Send LTO Data to Module When the previous step is completed, the host can send LTO data to the module, which saves the LTO data to flash. The host must split the LTO data into N chunks of 16 KB. The last chunk size should be equal to the remaining bytes, which means that its size might be less than 16 KB. Each data chunk is acknowledged with LTO_ACK response from the module. If there is any error, LTO_NACK is returned. 2.2.2.5. Perform CRC32 Verification After LTO data sending, the module performs CRC32 verification on the LTO data received from the host. If the verification is passed, the module returns LTO_ACK to the host; otherwise, LTO_NACK is returned. LC79D(A)_AGNSS_Application_Note 17 / 25 GNSS Module Series LC79D (A) AGNSS Application Note 3 AGNSS Testing Procedure This chapter illustrates how to test the AGNSS feature by using the Quectel’s QGNSS tool. The QGNSS tool is a Quectel’s tool used for testing GNSS features. The QGNSS runs on Windows OS only and is compatible with Windows 7 and later versions of Windows. The procedure described in this chapter is a general one and is relevant even if you use a different tool or have a Linux or Mac OS machine. 3.1. Prerequisites Before testing the AGNSS function, make sure that you have done the following: 1) You have connected LC79D (A) EVB with your computer. 2) You have installed the QGNSS tool 1) and have set the corresponding serial port number, baud rate 2), and the module’s model. 3) You have created the account for Quectel AGNSS Server 3), and you have connected the AGNSS Server to the QGNSS tool. To better see the effect of AGNSS feature on TTFF value, you could first get a fix without using AGNSS feature. After the testing procedure, you can compare the TTFF results. NOTES 1. 1) For more information on how to install and set up QGNSS, see document [2]. 2. 2) The default baud rate of the LC79D module is 115200 bps. 3. 3) Contact Quectel’s Technical Support (support@quectel.com) for information on how to get access to Quectel AGNSS Server. LC79D(A)_AGNSS_Application_Note 18 / 25 GNSS Module Series LC79D (A) AGNSS Application Note 3.2. Procedure To test the AGNSS function in a cold start session with the QGNSS tool 1), do the following: 1) Send the LTO data to the module. 2) Send $PQCOLD command to the module to perform a cold start. 3) Send $PQSTOPGNSS command to the module to stop the GNSS engine. 4) Send the assistance position and time to the module with $PQSETASSGNSS command 2), or with $PQSETASSPOS and $PQSETASSTIME commands 3). 5) Send $PQSTARTGNSS command to the module to start the GNSS engine 4). NOTES 1. 1) The QGNSS tool only supports the download of LTO files that have 4-day validity. If you need the LTO file with 2 or 7-day validity, or you don’t want to use the QGNSS tool, you can send the LTO file and LTO data directly to the module with PQ commands. For details, see Chapter 2.2. 2. 2) It is recommended to use $PQSETASSGNSS command to inject the position and time at the same time. 3. 3) If you use $PQSETASSPOS and $PQSETASSTIME commands, inject first the position with $PQSETASSPOS command, and then inject time with $PQSETASSTIME command. 4. 4) It is important to start the GNSS engine immediately after you set the assistance position and time. Example: 1. Send the LTO data to the module. a) Run the QGNSS tool. b) In the main interface, click 'Windows -> Download (LTO)' to enter the Download window. c) Click the 'Download LTO' button to download the LTO file to your computer. The file size and CRC information are shown in the corresponding fields. d) Click the 'Load' button to upload the LTO data and then click 'Start'. The QGNSS sends both the LTO file and LTO data to the module. e) When the transfer is successfully finished ('Status' bar is 100% green), close the window. LC79D(A)_AGNSS_Application_Note 19 / 25 GNSS Module Series LC79D (A) AGNSS Application Note 2. Go to the 'PortInfo' window and perform a cold start. $PQCOLD*05 //Module’s response $GNRMC,000001.00,V,,,,,,,020712,,,N,V*1E $GNGGA,000001.00,,,,,0,00,99.0,,M,,M,,*49 $GNGLL,,,,,000001.00,V,N*55 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,1*03 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,2*00 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,3*01 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,4*06 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,5*07 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,6*04 $GNVTG,,T,,M,,N,,K,N*32 … 3. Stop the GNSS engine: $PQSTOPGNSS*10 //Module’s response $PQSTOPGNSSOK*14 4. Inject the module’s position and current time information: $PQSETASSGNSS,31.821730,117.114608,0,2020,6,29,12,32,20*1A //module’s response $PQSETASSGNSSOK*0F 5. Start the GNSS engine: $PQSTARTGNSS*48 LC79D(A)_AGNSS_Application_Note 20 / 25 GNSS Module Series LC79D (A) AGNSS Application Note //Module’s response $PQSTARTGNSSOK*4C $GNRMC,123224.11,V,,,,,,,290620,,,N,V*12 // 1st second $GNGGA,123224.11,,,,,0,00,99.0,,M,,M,,*4C $GNGLL,,,,,123224.11,V,N*50 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,1*03 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,2*00 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,3*01 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,4*06 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,5*07 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,6*04 $GNVTG,,T,,M,,N,,K,N*32 $GNRMC,123225.11,V,,,,,,,290620,,,N,V*13 // 2nd second $GNGGA,123225.11,,,,,0,00,99.0,,M,,M,,*4D $GNGLL,,,,,123225.11,V,N*51 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,1*03 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,2*00 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,3*01 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,4*06 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,5*07 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,6*04 $GNVTG,,T,,M,,N,,K,N*32 $GNRMC,123225.30,V,,,,,,,290620,,,N,V*10 // 3rd second $GNGGA,123225.30,,,,,0,00,99.0,,M,,M,,*4E $GNGLL,,,,,123225.30,V,N*52 $GPGSV,1,1,01,10,01,291,33,1*5F $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,1*03 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,2*00 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,3*01 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,4*06 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,5*07 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,6*04 $GNVTG,,T,,M,,N,,K,N*32 $GNRMC,123226.11,V,,,,,,,290620,,,N,V*10 // 4th second $GNGGA,123226.11,,,,,0,00,99.0,,M,,M,,*4E $GNGLL,,,,,123226.11,V,N*52 $GPGSV,2,1,05,10,01,291,35,18,57,308,35,20,27,306,41,21,19,318,31,1*6C $GPGSV,2,2,05,29,21,219,39,1*59 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,1*03 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,2*00 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,3*01 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,4*06 LC79D(A)_AGNSS_Application_Note 21 / 25 GNSS Module Series LC79D (A) AGNSS Application Note $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,5*07 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,6*04 $GNVTG,,T,,M,,N,,K,N*32 $GNRMC,123227.11,V,,,,,,,290620,,,N,V*11 // 5th second $GNGGA,123227.11,,,,,0,00,99.0,,M,,M,,*4F $GNGLL,,,,,123227.11,V,N*53 $GPGSV,2,1,05,10,01,291,35,18,57,308,37,20,27,306,44,21,19,318,33,1*69 $GPGSV,2,2,05,29,21,219,42,1*55 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,1*03 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,2*00 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,3*01 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,4*06 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,5*07 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,6*04 $GNVTG,,T,,M,,N,,K,N*32 $GNRMC,123228.11,V,,,,,,,290620,,,N,V*1E // 6th second $GNGGA,123228.11,,,,,0,00,99.0,,M,,M,,*40 $GNGLL,,,,,123228.11,V,N*5C $GPGSV,2,1,08,05,,,14,10,01,291,34,13,,,20,15,69,005,22,1*6C $GPGSV,2,2,08,18,57,308,37,20,27,306,44,21,19,318,34,29,21,219,42,1*68 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,1*03 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,2*00 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,3*01 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,4*06 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,5*07 $GNGSA,A,1,,,,,,,,,,,,,99.0,99.0,99.0,6*04 $GNVTG,,T,,M,,N,,K,N*32 // Get a fix in the 7th second. $GNRMC,123229.11,A,3149.305975,N,11706.914899,E,0.0,,290620,,,A,V*15 $GNGGA,123229.11,3149.305975,N,11706.914899,E,1,10,1.8,53.6,M,-3.6,M,,*5C $GNGLL,3149.305975,N,11706.914899,E,123229.11,A,A*79 $GPGSV,2,1,08,05,25,090,15,10,01,291,34,13,,,22,15,69,005,24,1*57 $GPGSV,2,2,08,18,57,308,36,20,27,306,45,21,19,318,35,29,21,219,42,1*69 $GLGSV,1,1,04,87,08,335,41,85,36,198,31,71,48,330,36,72,19,279,42,1*79 $GQGSV,2,1,03,01,65,059,21,02,25,136,21,1*6A $GNGSA,A,3,10,15,18,20,21,29,,,,,,,2.4,1.8,1.7,1*3E $GNGSA,A,3,71,72,85,87,,,,,,,,,2.4,1.8,1.7,2*3A $GNGSA,A,3,,,,,,,,,,,,,2.4,1.8,1.7,3*3A $GNGSA,A,3,,,,,,,,,,,,,2.4,1.8,1.7,4*3D $GNGSA,A,3,,,,,,,,,,,,,2.4,1.8,1.7,5*3C $GNGSA,A,3,,,,,,,,,,,,,2.4,1.8,1.7,6*3F $GNVTG,,T,,M,0.0,N,0.0,K,A*3D $GNRMC,123230.11,A,3149.305882,N,11706.914849,E,0.0,,290620,,,A,V*19 $GNGGA,123230.11,3149.305882,N,11706.914849,E,1,12,1.8,68.6,M,-3.6,M,,*5A LC79D(A)_AGNSS_Application_Note 22 / 25 GNSS Module Series LC79D (A) AGNSS Application Note $GNGLL,3149.305882,N,11706.914849,E,123230.11,A,A*75 $GPGSV,2,1,08,05,25,090,14,10,01,291,33,13,42,039,24,15,69,005,24,1*6B $GPGSV,2,2,08,18,57,308,36,20,27,306,45,21,19,318,34,29,21,219,42,1*68 $GLGSV,1,1,04,87,08,335,44,85,36,198,30,71,48,330,35,72,19,279,47,1*7B $GBGSV,2,1,05,206,77,276,38,209,51,240,31,211,35,210,35,213,81,287,38,1*79 $GBGSV,2,2,05,216,72,266,41,1*74 $GQGSV,2,1,04,01,,,22,02,25,136,21,03,22,175,22,1*61 $GNGSA,A,3,10,13,18,20,21,,,,,,,,2.4,1.8,1.7,1*33 $GNGSA,A,3,71,72,87,,,,,,,,,,2.4,1.8,1.7,2*37 $GNGSA,A,3,,,,,,,,,,,,,2.4,1.8,1.7,3*3A $GNGSA,A,3,206,209,213,216,,,,,,,,,2.4,1.8,1.7,4*37 $GNGSA,A,3,,,,,,,,,,,,,2.4,1.8,1.7,5*3C $GNGSA,A,3,,,,,,,,,,,,,2.4,1.8,1.7,6*3F $GNVTG,,T,,M,0.0,N,0.0,K,A*3D $GNRMC,123231.11,A,3149.305310,N,11706.915521,E,0.0,,290620,,,A,V*1A $GNGGA,123231.11,3149.305310,N,11706.915521,E,1,12,2.1,65.6,M,-3.6,M,,*5E $GNGLL,3149.305310,N,11706.915521,E,123231.11,A,A*76 $GPGSV,2,1,08,05,25,090,14,10,01,291,33,13,42,039,24,15,69,005,25,1*6A $GPGSV,2,2,08,18,57,308,35,20,27,306,45,21,19,318,33,29,21,219,42,1*6C $GLGSV,1,1,04,87,08,335,44,85,36,198,28,71,48,330,33,72,19,279,47,1*74 $GBGSV,2,1,06,206,77,276,38,209,51,240,30,211,35,210,36,213,81,287,38,1*78 $GBGSV,2,2,06,214,54,321,29,216,72,266,41,1*7A $GQGSV,2,1,04,01,65,059,23,02,25,136,20,03,22,175,22,1*5E $GNGSA,A,3,10,18,20,21,,,,,,,,,2.7,2.1,1.6,1*39 $GNGSA,A,3,72,87,,,,,,,,,,,2.7,2.1,1.6,2*39 $GNGSA,A,3,,,,,,,,,,,,,2.7,2.1,1.6,3*32 $GNGSA,A,3,206,209,211,213,214,216,,,,,,,2.7,2.1,1.6,4*3A $GNGSA,A,3,,,,,,,,,,,,,2.7,2.1,1.6,5*34 $GNGSA,A,3,,,,,,,,,,,,,2.7,2.1,1.6,6*37 $GNVTG,,T,,M,0.0,N,0.0,K,A*3D $GNRMC,123232.11,A,3149.304881,N,11706.916022,E,0.0,,290620,,,A,V*1E $GNGGA,123232.11,3149.304881,N,11706.916022,E,1,12,2.1,66.6,M,-3.6,M,,*59 $GNGLL,3149.304881,N,11706.916022,E,123232.11,A,A*72 $GPGSV,3,1,09,05,25,090,13,10,01,291,34,13,42,039,25,15,69,005,25,1*6B $GPGSV,3,2,09,18,57,308,34,20,27,306,45,21,19,318,33,29,21,219,42,1*6D $GLGSV,2,1,05,73,19,137,22,87,08,335,44,85,36,198,26,71,48,330,34,1*74 $GLGSV,2,2,05,72,19,279,46,1*4E $GBGSV,2,1,06,206,77,276,38,209,51,240,30,211,35,210,36,213,81,287,38,1*78 $GBGSV,2,2,06,214,54,321,29,216,72,266,41,1*7A $GQGSV,2,1,04,01,,,23,02,25,136,20,03,22,175,21,1*62 $GNGSA,A,3,10,18,20,21,,,,,,,,,2.7,2.1,1.6,1*39 $GNGSA,A,3,72,87,,,,,,,,,,,2.7,2.1,1.6,2*39 $GNGSA,A,3,,,,,,,,,,,,,2.7,2.1,1.6,3*32 $GNGSA,A,3,206,209,211,213,214,216,,,,,,,2.7,2.1,1.6,4*3A LC79D(A)_AGNSS_Application_Note 23 / 25 $GNGSA,A,3,,,,,,,,,,,,,2.7,2.1,1.6,5*34 $GNGSA,A,3,,,,,,,,,,,,,2.7,2.1,1.6,6*37 $GNVTG,,T,,M,0.0,N,0.0,K,A*3D GNSS Module Series LC79D (A) AGNSS Application Note 3.3. Results When the GNSS engine is started, the module will try to get a fix. Without the AGNSS feature, the module gets a fix in about 30 seconds after a cold start. With the AGNSS feature enabled, the module gets a fix in about 10 seconds or less. In this example, the TTFF is 7s. As NMEA messages (RMC, GGA, GSV, GSA, VTG, and so on) are output every second, by counting the number of RMC or GGA for example, you can calculate how many seconds have passed before getting a first fix. If you have previously got a fix without an AGNSS feature, you can now compare the results. If everything went well, the TTFF value should be significantly reduced. LC79D(A)_AGNSS_Application_Note 24 / 25 GNSS Module Series LC79D (A) AGNSS Application Note 4 Appendix A References Table 4: Related Documents SN Document Name [1] LC79D(A)_GNSS_Protocol_Specification [2] Quectel_LC79D_QGNSS_User_Guide Remark LC79D (A) GNSS Protocol Specification QGNSS Tool User Guide Table 5: Terms and Abbreviations Abbreviation AGNSS FTP GNSS HEX LTO NMEA SLA TTFF UART UTC Description Assisted GNSS File Transfer Protocol Global Navigation Satellite System Hexadecimal Long Term Orbit National Marine Electronics Association Software License Agreement Time to First Fix Universal Asynchronous Receiver/Transmitter Universal Time Coordinated LC79D(A)_AGNSS_Application_Note 25 / 25

L8x&LC86x Series Difference Introduction GNSS Module Series Version: 1.1 Date: 2023-11-06 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. L8x&LC86x_Series_Difference_Introduction 1 / 50 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. L8x&LC86x_Series_Difference_Introduction 2 / 50 GNSS Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service, or repair of any terminal or mobile incorporating the module. Manufacturers of the terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all product manuals. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Ensure that the product may be used in the country and the required environment, as well as that it conforms to the local safety and environmental regulations. Keep away from explosive and flammable materials. The use of electronic products in extreme power supply conditions and locations with potentially explosive atmospheres may cause fire and explosion accidents. The product must be powered by a stable voltage source, and the wiring shall conform to security precautions and fire prevention regulations. Proper ESD handling procedures must be followed throughout the mounting, handling and operation of any devices and equipment that incorporate the module to avoid ESD damages. L8x&LC86x_Series_Difference_Introduction 3 / 50 GNSS Module Series About the Document Document Information Title L8x&LC86x Series Difference Introduction Subtitle GNSS Module Series Document Type Difference Introduction Document Status Released Revision History Version Date Description - 2022-08-23 Creation of the document 1.0 2022-09-02 First official release 1. Added the LC86G (PA) variant and updated the default constellations of LC86G (AA, AB, LA). 2. Added the summary for hardware and software differences (Chapter 2). 3. Added the voltage range of L80, L80-R, L86, LC86L series and LC86G (AA, AB, LA) and updated the power consumption, cold start and warm start of TTFF (without AGNSS) for LC86G (AA, AB, LA) (Table 3 and Table 4). 4. Updated the pins of LC86G series as below (Figure 2, Table 5 and 1.1 2023-11-06 Table 9): Updated the pin 7 from AP_REQ to RESERVED; Updated the pin 8 from TXD_DBG to AADET_N; Updated the pin 9 from RXD_DBG to RESERVED; Updated the pin 11 from RESERVED to EX_ANT. 5. Updated the RESET_N circuit of LC86G series (Figure 7). 6. Updated the weight of LC86G (AA, AB, LA) (Table 8). 7. Added the note to explain the details on BDS frequency bands supported by LC86G (LA, PA) (Chapter 4.1). L8x&LC86x_Series_Difference_Introduction 4 / 50 Version Date GNSS Module Series Description 8. Added default constellations information for the modules (Table 11). 9. Added the chapter of UART baud rates (Chapter 4.2). 10. Added ZDA, GNS, GST, GRS and RLM for LC86G series (Table 14). 11. Updated the PMTK and PAIR messages of the module (Table 17). 12. Updated the chapter of PQ messages to the chapters of PQ Versus PQTM Messages and PQ versus PAIR messages (Chapters 4.4.3 and 4.4.4). L8x&LC86x_Series_Difference_Introduction 5 / 50 GNSS Module Series Contents Safety Information....................................................................................................................................... 3 About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 6 Table Index................................................................................................................................................... 7 Figure Index ................................................................................................................................................. 8 1 Introduction .......................................................................................................................................... 9 1.1. Applicable Modules ................................................................................................................... 9 1.2. Special Mark ............................................................................................................................ 10 2 Summary ............................................................................................................................................. 11 2.1 Summary of Hardware Difference........................................................................................... 11 2.2 Summary of Software Difference ............................................................................................ 12 3 Hardware Differences ........................................................................................................................ 13 3.1. Feature Comparison................................................................................................................ 13 3.2. Module View ............................................................................................................................ 18 3.3. Pin Comparison ....................................................................................................................... 19 3.4. V_BCKP Power Supply ........................................................................................................... 21 3.5. VCC Power Supply.................................................................................................................. 21 3.6. TIMER Versus FORCE_ON Versus WAKEUP ....................................................................... 22 3.7. RESET_N ................................................................................................................................ 22 3.8. Mechanical Comparison.......................................................................................................... 24 3.9. Electrical Compatibility ............................................................................................................ 27 4 Software Difference ........................................................................................................................... 28 4.1. Constellations.......................................................................................................................... 28 4.2. UART Baud Rates ................................................................................................................... 30 4.3. AGNSS .................................................................................................................................... 31 4.4. NMEA Protocol Differences..................................................................................................... 31 4.4.1. Standard NMEA Message Differences........................................................................... 31 4.4.1.1. RMC................................................................................................................ 33 4.4.1.2. GGA ................................................................................................................ 34 4.4.1.3. GSV ................................................................................................................ 36 4.4.1.4. GSA ................................................................................................................ 37 4.4.1.5. VTG................................................................................................................. 38 4.4.1.6. GLL ................................................................................................................. 39 4.4.2. PMTK Versus PAIR Messages ...................................................................................... 40 4.4.3. PQ Versus PQTM Messages ......................................................................................... 44 4.4.4. PQ Versus PAIR Messages ........................................................................................... 45 5 Appendix A References..................................................................................................................... 47 6 Appendix B GNSS Numbering.......................................................................................................... 50 L8x&LC86x_Series_Difference_Introduction 6 / 50 GNSS Module Series Table Index Table 1: Applicable Modules ........................................................................................................................ 9 Table 2: Special Mark ................................................................................................................................. 10 Table 3: Feature Comparison of Single-Constellation Modules and LC86G Series.................................. 13 Table 4: Feature Comparison of Multi-Constellation Modules and LC86G Series .................................... 15 Table 5: Pin Comparison ............................................................................................................................ 20 Table 6: L80, L80-R and L86 Mechanical Comparison.............................................................................. 24 Table 7: LC86L Series and LC86G Series Mechanical Comparison ......................................................... 26 Table 8: Weight Specification ..................................................................................................................... 27 Table 9: Voltage Tolerance Comparison..................................................................................................... 27 Table 10: Supported Constellations ........................................................................................................... 28 Table 11: Supported Constellation Combinations ...................................................................................... 28 Table 12: Supported UART Baud Rates by Default ................................................................................... 30 Table 13: Supported AGNSS...................................................................................................................... 31 Table 14: Supported NMEA Messages ...................................................................................................... 31 Table 15: Difference on NMEA Talker ID.................................................................................................... 32 Table 16: Talker ID of Position Fixed for L86 ............................................................................................. 32 Table 17: Differences between PMTK and PAIR Messages...................................................................... 40 Table 18: Differences Between PQ and PQTM Messages........................................................................ 44 Table 19: Differences Between PQ and PAIR Messages .......................................................................... 45 Table 20: Related Documents .................................................................................................................... 47 Table 21: Terms and Abbreviations ............................................................................................................ 47 Table 22: GNSS Constellations Information .............................................................................................. 50 L8x&LC86x_Series_Difference_Introduction 7 / 50 GNSS Module Series Figure Index Figure 1: Module View ............................................................................................................................... 18 Figure 2: L80, L80-R, L86, LC86L Series and LC86G Series Pin Assignment......................................... 19 Figure 3: Decoupling Components for V_BCKP Power Supply ................................................................ 21 Figure 4: Decoupling Components for VCC Power Supply ....................................................................... 21 Figure 5: TIMER, FORCE_ON and WAKEUP Control Circuits ................................................................. 22 Figure 6: RESET_N Reference Circuit for All Modules ............................................................................. 23 Figure 7: RESET_N Reference Circuit for LC86G Series ......................................................................... 23 L8x&LC86x_Series_Difference_Introduction 8 / 50 GNSS Module Series 1 Introduction This document compares Quectel L80, L80-R, L86, LC86L series, and LC86G series GNSS modules. It provides a brief summary of their most relevant features and characteristics. The intention of this document is to simplify the migration to the new Quectel LC86G series GNSS module. For more information, contact your local FAE. 1.1. Applicable Modules Table 1: Applicable Modules Module Series - LC86L Series LC86G Series Model L80 L80-R L86 LC86L (A) LC86L (B) LC86L (C) LC86G (AA) LC86G (AB) LC86G (LA) LC86G (PA) L8x&LC86x_Series_Difference_Introduction 9 / 50 GNSS Module Series Based on the latest enhanced chipset, LC86G series includes 4 variants whose pins, reference designs and software protocols are identical. Differences between versions are listed below: LC86G (AA): LC86G (AA) has 16.0 mm × 16.0 mm × 6.95 mm patch antenna, which supports GPS + Galileo + BDS by default. LC86G (AB): LC86G (AB) has 16.0 mm × 16.0 mm × 6.95 mm patch antenna, which supports GPS + GLONASS + Galileo by default. LC86G (LA): LC86G (LA) has 18.4 mm × 18.4 mm × 6.95 mm patch antenna, which supports GPS + GLONASS + Galileo + BDS + QZSS by default. LC86G (PA): LC86G (PA) has 16.0 mm × 16.0 mm × 6.95 mm patch antenna, which supports GPS + GLONASS + Galileo + BDS + QZSS by default. 1.2. Special Mark Table 2: Special Mark Mark ● Definition The symbol indicates that a function or technology is supported by the module(s). L8x&LC86x_Series_Difference_Introduction 10 / 50 GNSS Module Series 2 Summary 2.1 Summary of Hardware Difference The main hardware differences between the L80, L80-R, L86, LC86L series and LC86G series are: 1. Power supply range (There are slight differences in the power supply range.): ⚫ VCC and V_BCKP power supply: All modules have the same typical voltage but different voltage ranges. ⚫ I/O power supply: Typical 2.8 V for L80, L80-R, L86 and LC86L series, while following VCC for LC86G series. 2. Footprint difference: The LC86G series has 24 more LGA ground pins than the L80, L80-R, L86 and LC86L series, which increase the module reliability. 3. Pin differences: ⚫ Pin 7: ➢ RESERVED pin for L80-R and LC86G series; ➢ TIMER pin for L80 which is used to control the on-off of the module’s main power supply; ➢ FORCE_ON and WAKEUP for L86 and LC86L series respectively which are used to wake up the module from Backup mode. ⚫ Pin 8: ➢ RESERVED pin for L80-R; ➢ AADET_N pin for L80, L86, LC86L series and LC86G series as external active antenna open circuit status indication. In addition, keep the pin of LC86G series at low level to switch to the external passive antenna. ⚫ Pin 11: ➢ RESERVED pin for L80-R; ➢ EX_ANT pin for L80, L86, LC86L series and LC86G series as external antenna input interface. For more information, see document [1], [2], [3], [4] and [5] hardware designs. L8x&LC86x_Series_Difference_Introduction 11 / 50 GNSS Module Series 2.2 Summary of Software Difference The main software differences between the L80, L80-R, L86, LC86L series and LC86G series are: ⚫ The default constellation combinations of them are different. ⚫ The default baud rate of them are different. ⚫ AGNSS implementation modes and interface protocols are different. ⚫ Different proprietary messages make the related configuration commands incompatible. L8x&LC86x_Series_Difference_Introduction 12 / 50 GNSS Module Series 3 Hardware Differences 3.1. Feature Comparison Table 3: Feature Comparison of Single-Constellation Modules and LC86G Series Feature L80 L80-R LC86G (LA) LC86G (AA) LC86G (AB) LC86G (PA) GNSS Receiver Type Single Band Single Band Constellations GPS/QZSS Number of Concurrent Satellite Constellations SBAS (WAAS, EGNOS, MSAS, GAGAN) Memory Type 1 + QZSS Supported Flash GPS/QZSS 1 + QZSS Flash Power Consumption Constellations GPS Acquisition 25 mA GPS 25 mA Single Band GPS/QZSS, GLONASS, Galileo, BDS 4 + QZSS Single Band GPS/QZSS, Galileo, BDS 3 + QZSS Single Band GPS/QZSS, GLONASS, Galileo 3 + QZSS Single Band GPS/QZSS, GLONASS, Galileo, BDS 4 + QZSS Supported Supported Supported Supported Flash Flash Flash GPS + GLONASS + GPS + Galileo + GPS + GLONASS + Galileo + BDS + QZSS BDS Galileo 34 mA 30 mA 33 mA Flash GPS + GLONASS + Galileo + BDS + QZSS 11 mA L8x&LC86x_Series_Difference_Introduction 13 / 50 Feature L80 Tracking 20 mA Backup mode 7 μA Acquisition -148 dBm Sensitivity Reacquisition -160 dBm Tracking -165 dBm Cold start 35 s TTFF Warm start 30 s (without AGNSS) Hot start 1 s TTFF (with EASY) TTFF (with Flash EPO) Additional LNA Cold start Warm start Hot start Cold start 15 s 5 s 1 s 5 s Supported Oscillator Horizontal Position Accuracy (CEP 50) Velocity Accuracy Integrated 2.5 m 0.1 m/s L80-R 20 mA 7 μA -148 dBm -160 dBm -165 dBm 35 s 30 s 1 s 15 s 5 s 1 s Supported Integrated 2.5 m 0.1 m/s LC86G (LA) 34 mA 13 μA -147 dBm -160 dBm -166 dBm 30 s 25 s 1 s 12 s 2 s 1 s 5 s Supported Integrated 1.5 m 0.1 m/s LC86G (AA) 30 mA 13 μA -147 dBm -160 dBm -166 dBm 30 s 28 s 1 s 12 s 2 s 1 s 5 s Supported Integrated 1.5 m 0.1 m/s GNSS Module Series LC86G (AB) 33 mA 13 μA -147 dBm -160 dBm -166 dBm 30 s 28 s 1 s 12 s 2 s 1 s 5 s Supported Integrated 1.5 m 0.1 m/s LC86G (PA) 11 mA 13 μA -147 dBm -160 dBm -166 dBm 30 s 28 s 1 s 12 s 2 s 1 s 5 s Supported Integrated 1.5 m 0.1 m/s L8x&LC86x_Series_Difference_Introduction 14 / 50 Feature Acceleration Accuracy Operating Temperature Default Baud Rate VCC Power Supply V_BCKP Power Supply I/O Voltage 1 Requires External Components L80 L80-R LC86G (LA) 0.1 m/s2 0.1 m/s2 0.1 m/s2 -40 °C +85 °C to -40 °C to +85 °C -40 °C to +85 °C 9600 bps 9600 bps 115200 bps 2.8–4.3 V 2.8–4.3 V 2.55–3.6 V 2.0–4.3 V 2.0–4.3 V 1.65–3.6 V 2.8 V 2.8 V VCC - - - GNSS Module Series LC86G (AA) 0.1 m/s2 -40 °C to +85 °C 115200 bps 2.55–3.6 V 1.65–3.6 V VCC - LC86G (AB) 0.1 m/s2 -40 °C to +85 °C 115200 bps 2.55–3.6 V 1.65–3.6 V VCC - LC86G (PA) 0.1 m/s2 -40 °C to +85 °C 115200 bps 2.55–3.6 V 1.65–3.6 V VCC - Table 4: Feature Comparison of Multi-Constellation Modules and LC86G Series Feature GNSS Receiver Type Constellations Number of Concurrent Satellite Constellations SBAS L86 Single Band GPS/QZSS, GLONASS, Galileo, BDS 4 + QZSS LC86L (A) LC86L (B) LC86L (C) LC86G (LA) LC86G (AA) LC86G (AB) LC86G (PA) Single Band Single Band Single Band Single Band GPS/QZSS, GLONASS, BDS GPS/QZSS, GLONASS, BDS GPS/QZSS, GLONASS, Galileo, BDS GPS/QZSS, GLONASS, Galileo, BDS Single Band GPS/QZSS, Galileo, BDS Single Band GPS/QZSS, GLONASS, Galileo 3 + QZSS 3 + QZSS 4 + QZSS 4 + QZSS 3 + QZSS 3 + QZSS Single Band GPS/QZSS, GLONASS, Galileo, BDS 4 + QZSS WAAS, EGNOS, MSAS, GAGAN 1 For L80 and L80-R modules, the I/O voltage is 2.8 V but they could handle up to 3.1 V. See documents [1] and [2] hardware designs for more information about I/O voltage. It’s suggested to use resistors in series for all I/O lines. L8x&LC86x_Series_Difference_Introduction 15 / 50 GNSS Module Series Feature L86 LC86L (A) LC86L (B) LC86L (C) LC86G (LA) LC86G (AA) LC86G (AB) LC86G (PA) Memory Type Power Consumption Flash GPS Constellations GLONASS Acquisition 30 mA Flash Flash Flash Flash Flash + GPS + GPS + BDS GLONASS GPS + G3 2 + BDS + G2 2 + BDS GLONASS QZSS 32 mA 33 mA 32 mA 34 mA 30 mA Tracking 26 mA 31 mA 30 mA 30 mA 34 mA 30 mA Flash G3 2 33 mA 33 mA Flash G3 2 + BDS + QZSS 11 mA 11 mA Backup mode 7 μA 6 μA 6 μA 7 μA 13 μA 13 μA 13 μA 13 μA Acquisition -149 dBm -148 dBm -148 dBm -148 dBm -147 dBm -147 dBm -147 dBm -147 dBm Sensitivity Reacquisition -161 dBm -161 dBm -161 dBm -162 dBm -160 dBm -160 dBm -160 dBm -160 dBm Tracking -167 dBm -166 dBm -166 dBm -166 dBm -166 dBm -166 dBm -166 dBm -166 dBm Cold start 35 s TTFF Warm start 30 s (without AGNSS) Hot start 1 s 35 s 35 s 35 s 30 s 30 s 30 s 30 s 30 s 30 s 30 s 25 s 28 s 28 s 28 s 2 s 2 s 2 s 1 s 1 s 1 s 1 s TTFF (with EASY) Cold start 15 s Warm start 5 s Hot start 1 s TTFF Cold start 5 s (with Flash EPO) 15 s 15 s 15 s 12 s 12 s 12 s 12 s 5 s 5 s 5 s 2 s 2 s 2 s 2 s 2s 2 s 2 s 1 s 1 s 1 s 1 s 4 s 4 s 4 s 5 s 5 s 5 s 5 s 2 G3 is GPS + GLONASS + Galileo; G2 is GPS + Galileo. L8x&LC86x_Series_Difference_Introduction 16 / 50 GNSS Module Series Feature Additional LNA Oscillator Horizontal Position Accuracy (CEP50) Velocity Accuracy Acceleration Accuracy Operating Temperature Default Baud Rate VCC Power Supply V_BCKP Power Supply I/O Voltage 3 Requires External Components L86 Supported Integrated LC86L (A) Supported Integrated LC86L (B) Supported Integrated LC86L (C) Supported Integrated LC86G (LA) Supported Integrated LC86G (AA) LC86G (AB) LC86G (PA) Supported Supported Supported Integrated Integrated Integrated 2.5 m 2.5 m 2.5 m 2.5 m 1.5 m 1.5 m 1.5 m 1.5 m 0.1 m/s 0.1 m/s 0.1 m/s2 0.1 m/s2 -40 °C to -40 °C to +85 °C +85 °C 9600 bps 9600 bps 2.8–4.3 V 2.8–4.3 V 2.0–4.3 V 1.5–4.3 V 2.8 V 2.8 V - - 0.1 m/s 0.1 m/s2 -40 °C to +85 °C 9600 bps 2.8–4.3 V 1.5–4.3 V 2.8 V - 0.1 m/s 0.1 m/s2 -40 °C to +85 °C 9600 bps 2.8–4.3 V 1.5–4.3 V 2.8 V - 0.1 m/s 0.1 m/s2 -40 °C to +85 °C 115200 bps 2.55–3.6 V 1.65–3.6 V VCC - 0.1 m/s 0.1 m/s2 -40 °C to +85 °C 115200 bps 2.55–3.6 V 1.65–3.6 V VCC - 0.1 m/s 0.1 m/s2 -40°C to +85 °C 115200 bps 2.55–3.6 V 1.65–3.6 V VCC - 0.1 m/s 0.1 m/s2 -40°C to +85 °C 115200 bps 2.55–3.6 V 1.65–3.6 V VCC - 3 For L86 and LC86L modules, the I/O voltage is 2.8 V but could handle up to 3.1 V. See documents [3] and [4] hardware designs for more information about I/O voltage. It’s suggested to use resistors in series for all I/O lines. L8x&LC86x_Series_Difference_Introduction 17 / 50 GNSS Module Series 3.2. Module View The footprint of L80, L80-R, L86 and LC86L series is compatible and interchangeable with LC86G series. LC86G series has extra 24 GND pins, which can be left unconnected when replacing a compatible module on the same PCB. You should modify your PCB design since these additional ground pins provide enhanced mechanical stability for module applications in harsh and high vibration environments. L80-R Figure 1: Module View L8x&LC86x_Series_Difference_Introduction 18 / 50 3.3. Pin Comparison GNSS Module Series RXD 1 TXD 2 GND 3 VCC 4 V_BCKP 5 1PPS 6 13 14 15 16 17 18 19 20 21 22 23 LC86G 24 25 (Top View) 26 27 28 29 30 31 32 33 34 35 36 12 GND 11 EX_ANT 10 RESET_N 9 RESERVED 8 AADET_N 7 RESERVED RXD RXD1 RXD1 RXD1 1 TXD TXD1 TXD1 TXD1 2 GND GND GND GND 3 VCC VCC VCC VCC 4 V_BCKP V_BCKP V_BCKP V_BCKP 5 1PPS 1PPS 1PPS 1PPS 6 LC86L L86 L80-R L80 Top View 12 GND GND GND 11 EX_ANT RESERVED EX_ANT GND EX_ANT 10 RESET RESET RESET RESET_N 9 NC NC NC RESERVED 8 AADET_N RESERVED AADET_N AADET_N 7 TIMER RESERVED FORCE_ON WAKEUP IO POWER GND SYSTEM ANT RESERVED Figure 2: L80, L80-R, L86, LC86L Series and LC86G Series Pin Assignment L8x&LC86x_Series_Difference_Introduction 19 / 50 Table 5: Pin Comparison Pin 1 2 3 4 5 6 7 8 9 10 11 12 13–36 L80 RXD1 TXD1 GND VCC V_BCKP 1PPS TIMER AADET_N NC RESET EX_ANT GND - L80-R RXD1 TXD1 GND VCC V_BCKP 1PPS RESERVED RESERVED NC RESET RESERVED GND - GNSS Module Series L86 RXD1 TXD1 GND VCC V_BCKP 1PPS FORCE_ON AADET_N NC RESET EX_ANT GND - LC86L Series RXD TXD GND VCC V_BCKP 1PPS WAKEUP AADET_N RESERVED RESET_N EX_ANT GND - LC86G Series RXD TXD GND VCC V_BCKP 1PPS RESERVED AADET_N RESERVED RESET_N EX_ANT GND GND NOTE 1. For details on pin assignment and description of the dedicated module, see documents [1], [2], [3], [4] and [5] hardware designs. 2. The pin differences among the modules are indicated in red. L8x&LC86x_Series_Difference_Introduction 20 / 50 GNSS Module Series 3.4. V_BCKP Power Supply The same backup power supply can be applied to all modules. To ensure the correct power-up sequence, the backup unit should start up no later than the PMU. Hence, the V_BCKP must be powered simultaneously with the VCC or before it. 3.3 V Always 1K on Power Rechargeable Backup Battery Module V_BCKP Backup Domain TVS 4.7 μF 100 nF 33 pF Figure 3: Decoupling Components for V_BCKP Power Supply The V_BCKP must be connected to power supply at startup, and it should always be powered if hot (warm) start is needed. For more information on power-up sequence, see documents [1], [2], [3], [4] and [5] hardware designs for the dedicated module. 3.5. VCC Power Supply Please apply the same filter to all GNSS modules. A Zener will protect module input from voltage peaks and surges. Capacitors should be placed close to the module to filter out all unwanted frequencies on the supply line. VCC_MODULE_3.3V VCC Module 33 pF 100 nF 10 μF Figure 4: Decoupling Components for VCC Power Supply L8x&LC86x_Series_Difference_Introduction 21 / 50 GNSS Module Series 3.6. TIMER Versus FORCE_ON Versus WAKEUP L80 module uses TIMER (pin 7) signal to control an external power switch for low power operation. L86 and LC86L series use the signal from the host (FORCE_ON/WAKEUP) to put the integrated power switch to ON position. LC86G series has no pin to control power switch. L86 Module LC86L Module Figure 5: TIMER, FORCE_ON and WAKEUP Control Circuits 3.7. RESET_N RESET_N is used to reset the modules from an unknown state. We have seen numerous customer designs without protection against power surges or undervoltage protection, designs not allowed for power switching, or designs with inadequate decoupling, etc. Therefore, it is strongly recommended to include the reset functionality in your design. The reset function is implemented the same way for all modules. Inside the module, it is pulled up with a 10 kΩ resistor to an internal voltage domain. Therefore, it cannot be driven by a host directly and a transistor or FET circuit is needed. L8x&LC86x_Series_Difference_Introduction 22 / 50 GNSS Module Series Figure 6: RESET_N Reference Circuit for All Modules In addition, LC86G series module has internal pull-up on RESET_N pin which can be connected to an isolated diode. The pin can also be connected to the GPIOX of the MCU through a 0 Ω resistor (R1) or a triode (Q1) which is not mounted by default. Therefore, reference circuit presented in figure above is applied to all modules, whereas the circuit presented on figure below applies only to LC86G series. MCU GPIOX Module 1.8 V 10K R1 RESET_N 0R Q1 IC NM Figure 7: RESET_N Reference Circuit for LC86G Series L8x&LC86x_Series_Difference_Introduction 23 / 50 GNSS Module Series 3.8. Mechanical Comparison The following tables present the mechanical differences between the modules. For more information, please refer to their hardware design documents. Table 6: L80, L80-R and L86 Mechanical Comparison Mechanical Characteristics L80/L80-R L86 Footprint L8x&LC86x_Series_Difference_Introduction 24 / 50 Mechanical Characteristics GNSS Module Series Drawing Length Width Height 16 mm 16 mm 6.95 mm L8x&LC86x_Series_Difference_Introduction 18.4 mm 18.4 mm 6.95 mm 25 / 50 Table 7: LC86L Series and LC86G Series Mechanical Comparison LC86L Series Mechanical Characteristics LC86G (AA, AB, LA, PA) GNSS Module Series Footprint Drawing LC86G (AA, AB, PA) LC86G (LA) Pin 1 Pin 1 Length Width Height 16 mm 16 mm 6.95 mm L8x&LC86x_Series_Difference_Introduction 16 mm 16 mm 6.95 mm 18.4 mm 18.4 mm 6.95 mm 26 / 50 GNSS Module Series Table 8: Weight Specification L80/L80-R/LC86L Module L86 LC86G (AA, AB, PA) LC86G (LA) Series Weight (g) 6.0 7.6 5.9 8.0 3.9. Electrical Compatibility Voltage levels of L8x series and LC86x series are fully compatible. LC86G series has the I/O’s at the power supply level, which will simplify communication circuits and reduce an LDO in the BOM. Table 9: Voltage Tolerance Comparison Voltage Level 4 VCC V_BCKP RESET_N 5 RXD TXD EX_ANT TIMER FORCE_ON/ WAKEUP 1PPS AADET_N L80 2.8–4.3 V 2–4.3 V -0.3–0.8 V 2.8 V 2.8 V VCC 1.1–3.1 V 2.8 V 2.8 V L80-R 2.8–4.3 V 2–4.3 V -0.3–0.8 V 2.8 V 2.8 V 2.8 V - L86 2.8–4.3 V 2–4.3 V -0.3–0.7 V 2.8 V 2.8 V VCC 2.8 V 2.8 V 2.8 V LC86L Series 2.8–4.3 V 1.5–4.3 V -0.3–0.7 V 2.8 V 2.8 V VCC - LC86G Series 2.55–3.6 V 1.65–3.6 V -0.3–0.45 V VCC VCC VCC - 2.8 V - 2.8 V 2.8 V VCC VCC 4 For L80, L80-R, L86, and LC86L, the I/O voltage is 2.8 V, but they could handle up to 3.1 V, see documents [1], [2], [3] and [4] hardware designs. It’s suggested to use resistors in series for all I/O lines. 5 RESET_N is internally pulled up and requires an external transistor driver. L8x&LC86x_Series_Difference_Introduction 27 / 50 GNSS Module Series 4 Software Difference 4.1. Constellations Table 10: Supported Constellations System L80 L80-R L86 LC86L (A, B) LC86L (C) LC86G (LA, PA) LC86G (AA) LC86G (AB) GPS ● ● ● ● ● ● ● ● GLONASS - - ● ● ● ● - ● Galileo - - ● - ● ● ● ● BDS - - ● ● ● ● ● - QZSS ● ● ● ● ● ● ● ● SBAS ● - ● ● ● ● ● ● NOTE 1. LC86G (PA) supports BDS B1I and B1C by default. 2. LC86G (LA) supports BDS B1I by default and it can support BDS B1I and B1C by executing the relevant command. Table 11: Supported Constellation Combinations Module L80/L80-R L86 Combinations ⚫ GPS ⚫ GPS + QZSS (Default) ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + BDS ⚫ GPS + BDS + QZSS ⚫ GPS + GLONASS L8x&LC86x_Series_Difference_Introduction 28 / 50 GNSS Module Series Module LC86L (A) LC86L (B) LC86L (C) LC86G (LA, PA) LC86G (AA) Combinations ⚫ GPS + GLONASS + QZSS (Default) ⚫ GPS + GLONASS + Galileo ⚫ GPS + GLONASS + Galileo + QZSS ⚫ GPS + Galileo ⚫ GPS + Galileo + QZSS ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + BDS ⚫ GPS + BDS + QZSS ⚫ GPS + GLONASS (Default) ⚫ GPS + GLONASS + QZSS ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + BDS (Default) ⚫ GPS + BDS + QZSS ⚫ GPS + GLONASS ⚫ GPS + GLONASS + QZSS ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + BDS ⚫ GPS + BDS + QZSS ⚫ GPS + GLONASS ⚫ GPS + GLONASS + QZSS (Default) ⚫ GPS + GLONASS + Galileo ⚫ GPS + GLONASS + Galileo + QZSS ⚫ GPS + Galileo ⚫ GPS + Galileo + QZSS ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + BDS ⚫ GPS + BDS + QZSS ⚫ GPS + GLONASS ⚫ GPS + GLONASS + QZSS ⚫ GPS + GLONASS + Galileo + BDS ⚫ GPS + GLONASS + Galileo + BDS + QZSS (Default) ⚫ GPS + Galileo ⚫ GPS + Galileo + QZSS ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + BDS ⚫ GPS + BDS + QZSS ⚫ GPS + Galileo L8x&LC86x_Series_Difference_Introduction 29 / 50 Module LC86G (AB) Combinations ⚫ GPS + Galileo + QZSS ⚫ GPS + Galileo + BDS (Default) ⚫ GPS + Galileo + BDS + QZSS ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + GLONASS ⚫ GPS + GLONASS + QZSS ⚫ GPS + GLONASS + Galileo (Default) ⚫ GPS + GLONASS + Galileo + QZSS ⚫ GPS + Galileo ⚫ GPS + Galileo + QZSS 4.2. UART Baud Rates Table 12: Supported UART Baud Rates by Default AGNSS L80 L80-R L86 LC86L (A) LC86L (B) LC86L (C) LC86G Series Band Rate 9600 bps 9600 bps 9600 bps 9600 bps 115200 bps 115200 bps 115200 bps GNSS Module Series L8x&LC86x_Series_Difference_Introduction 30 / 50 4.3. AGNSS Table 13: Supported AGNSS AGNSS L80 EASY ● Flash EPO ● Host EPO ● L80-R ● ● GNSS Module Series L86 LC86L Series LC86G Series ● ● ● ● ● ● ● ● ● 4.4. NMEA Protocol Differences 4.4.1. Standard NMEA Message Differences ⚫ L80, L86, LC86L series and LC86G series are compatible with NMEA 0183 V4.10 protocol. ⚫ L80-R is compatible with NMEA 0183 V3.01 protocol. Table 14: Supported NMEA Messages Message L80 RMC ● GGA ● GSV ● GSA ● VTG ● GLL ● TXT ● GBS - DTM ● ZDA - GNS - L80-R ● ● ● ● ● ● - L86 LC86L Series LC86G Series ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● - ● ● - ● ● - - - ● - - ● L8x&LC86x_Series_Difference_Introduction 31 / 50 Message L80 GST - GRS - RLM - L80-R - GNSS Module Series L86 LC86L Series LC86G Series - - ● - - ● - - ● NOTE The modules support the same NMEA sentence format. Table 15: Difference on NMEA Talker ID GNSS Constellation Configuration TalkerID (NMEA 0183 V3.01) L80-R TalkerID (NMEA 0183 V4.10) L80 L86/LC86L Series LC86G Series GPS GP GP GP GP GLONASS - GL GL Galileo - GA GA BDS - BD GB QZSS GP GP GP GP Combination of Multiple Satellite GP GP GN GN Systems On L86, the Talker ID of position fixed is shown in the table below. The Talker ID is always GP if the position is not fixed. Table 16: Talker ID of Position Fixed for L86 Constellation Combinations GPS + GLONASS GPS + BDS GPS + Galileo RMC GN GP GN GGA GP GP GP GSA GN GP GN GLL GN GP GN VTG GP GP GP L8x&LC86x_Series_Difference_Introduction 32 / 50 Constellation Combinations GPS + GLONASS + Galileo RMC GN GGA GP GNSS Module Series GSA GN GLL GN VTG GP 4.4.1.1. RMC Recommended Minimum Specific GNSS Data. Time, date, position, course, and speed data provided by a GNSS receiver. Type: Output Synopsis: $RMC,,,,,,,,,,,,,* Parameter: Field $ RMC Format character String, 2 characters String, 3 characters hhmmss.sss Character ddmm.mmmmmm Character dddmm.mmmmmm Character Numeric Note - - - - L80, L80-R, and L86: Default length of minute decimal fraction is 4 digits. LC86L series and LC86G series: Default length of minute decimal fraction is 6 digits. L80, L80-R, and L86: Default length of minute decimal fraction is 4 digits. LC86L series and LC86G series: Default length of minute decimal fraction is 6 digits. - - L8x&LC86x_Series_Difference_Introduction 33 / 50 Field Format Numeric ddmmyy Character Character Hexadecimal Character GNSS Module Series Note L80-R: This field does not exist. - 4.4.1.2. GGA Global Positioning System Fix Data. Time, position, and fix-related data for a GNSS receiver. Type: Output Synopsis: $GGA,,,,,,,,,,M,,M,,* Parameter: Field $ GGA Format character String, 2 characters String, 3 characters hhmmss.sss ddmm.mmmmmm Note - - - L80, L80-R, and L86: Default length of minute decimal fraction is 4 digits. LC86L series and LC86G series: Default length of minute decimal fraction is 6 digits. L8x&LC86x_Series_Difference_Introduction 34 / 50 Field Format Character dddmm.mmmmmm 1) Character Numeric, 1 digit Numeric, 2 digits Numeric Numeric M Character Numeric M Character Hexadecimal Character GNSS Module Series Note L80, L80-R, and L86: Default length of minute decimal fraction is 4 digits. LC86L series and LC86G series: Default length of minute decimal fraction is 6 digits. - - - L80, L80-R, and L86: Default length of decimal fraction is 1 digit. LC86L series and LC86G series: Default length of decimal fraction is 3 digits. L80, L80-R, and L86: Default length of decimal fraction is 1 digit. LC86L series and LC86G series: Default length of decimal fraction is 3 digits. - - - - - NOTE 1. The NMEA 0183 specification indicates that the GGA message is GPS specific. However, when the receiver is configured for multi-constellations, the content of GGA message will be generated from the multi-constellation solution. 2. 1) According to the NMEA 0183 specification, the number of satellites in use is between 00 and 12. However, in the multi-constellation solution, the number of satellites in use may exceed 12. L8x&LC86x_Series_Difference_Introduction 35 / 50 GNSS Module Series 4.4.1.3. GSV GNSS Satellites in View. The GSV sentence provides the number of satellites in view (SV), satellite ID numbers, elevation, azimuth, and SNR value, and it contains maximum four satellites per transmission. Therefore, it may take several sentences to get complete information. The total number of sentences being transmitted and the sentence number are indicated in the first two data fields. Type: Output Synopsis: $GSV,,,{,,,,}, * Parameter: Field $ GSV Format character String, 2 characters String, 3 characters Numeric Numeric Numeric Start of repeat block. Repeat times: 1–4. Numeric Numeric Numeric Numeric End of repeat block. Numeric Hexadecimal Note L80-R: Number of messages. Range: 1–3. L80, L86, LC86L series, and LC86G series: Number of messages. Range: 1–9. - - L80-R: This field does not exist. - L8x&LC86x_Series_Difference_Introduction 36 / 50 Field Format Character Note - GNSS Module Series NOTE GN cannot be used for GSV sentences. If satellites of multiple constellations are in view, use separate GSV sentences with the corresponding for each constellation. 4.4.1.4. GSA GNSS DOP and Active Satellites. GNSS receiver operating mode, satellites used in the navigation solution reported by the GGA sentence, and DOP values. Type: Output Synopsis: $GSA,,{,},,,* Parameter: Field $ Format character String, 2 characters GSA String, 3 characters Character Numeric Start of repeat block. Repeat times: 12. Numeric End of repeat block. Numeric Note L80 and L80-R: Always 'GP'. L86, LC86L series, and LC86G series: See Table 15: Difference on NMEA Talker ID - - - L8x&LC86x_Series_Difference_Introduction 37 / 50 Field Format Numeric Numeric Numeric Hexadecimal Character GNSS Module Series Note L80-R: This field does not exist. - NOTE 1. L80, L80-R, L86, LC86L series: If less than 12 satellites are used for navigation, the remaining fields are left empty. If more than 12 satellites are used for navigation, only the IDs of the first 12 are output. 2. LC86G series: None of the above restrictions apply. 4.4.1.5. VTG Course Over Ground & Ground Speed. The actual course and speed relative to the ground. Type: Output Synopsis: $VTG,,T,,M,,N,,K,* Parameter: Field $ VTG Format character String, 2 characters String, 3 characters Numeric Note - - L80-R: Default length of minute decimal fraction is 1 digit. L80, L86, LC86L series and LC86G series: Default length of minute decimal fraction is 2 digits. L8x&LC86x_Series_Difference_Introduction 38 / 50 Field T M Format Character Numeric Character Numeric N Character Numeric K Character Character Hexadecimal Character GNSS Module Series Note - - L80-R: Default length of minute decimal fraction is 1 digit. L80, L86, LC86L series, and LC86G series: Default length of minute decimal fraction is 2 digits. L80-R: Default length of minute decimal fraction is 1 digit. L80, L86, LC86L series, and LC86G series: Default length of minute decimal fraction is 2 digits. - - - - 4.4.1.6. GLL Geographic Position – Latitude/Longitude. Latitude and longitude of the GNSS receiver position, the time of position fix and status. Type: Output Synopsis: $GLL,,,,,,,* L8x&LC86x_Series_Difference_Introduction 39 / 50 Parameter: Field $ GLL Format character String, 2 characters String, 3 characters ddmm.mmmmmm Character dddmm.mmmmmm Character hhmmss.sss Character Character Hexadecimal Character GNSS Module Series Note L80, L86, and L80-R: Default length of minute decimal fraction is 4 digits. LC86L series and LC86G series: Default length of minute decimal fraction is 6 digits. L80, L86, and L80-R: Default length of minute decimal fraction is 4 digits. LC86L series and LC86G series: Default length of minute decimal fraction is 6 digits. - 4.4.2. PMTK Versus PAIR Messages PMTK messages are supported by Quectel L80, L80-R, L86, and LC86L series. PAIR messages are supported by LC86G series. Table 17: Differences between PMTK and PAIR Messages L80 PMTK001 L80-R PMTK001 L86 PMTK001 LC86L Series PMTK001 LC86G Series Description PAIR001 Acknowledges message. - - - - PAIR002 Powers on the GNSS system. L8x&LC86x_Series_Difference_Introduction 40 / 50 GNSS Module Series LC86L LC86G L80 L80-R L86 Description Series Series - - - - PAIR003 Powers off the GNSS system. PMTK161 PMTK161 PMTK161 PMTK161 - Enables/disables Standby mode. PMTK101 PMTK101 PMTK101 PMTK101 PAIR004 Performs a hot start. PMTK102 PMTK102 PMTK102 PMTK102 PAIR005 Performs a warm start. PMTK103 PMTK104 PMTK010 PMTK011 PMTK220 PMTK314 PMTK414 PMTK514 PMTK351 PMTK352 PMTK386 - PMTK103 PMTK104 PMTK010 PMTK011 PMTK220 PMTK500 PMTK400 PMTK314 PMTK414 PMTK514 - PMTK386 - PMTK103 PMTK104 PMTK010 PMTK011 PMTK220 - PMTK306 - PMTK314 PMTK414 PMTK514 PMTK351 PMTK352 PMTK353 PMTK386 PMTK311 PMTK103 PMTK104 PMTK010 PMTK011 PMTK220 - PMTK306 - PMTK314 PMTK414 PMTK514 PQTM351 PMTK352 PMTK353 PMTK386 PMTK311 PAIR006 PAIR007 PAIR010 PAIR011 PAIR050 PAIR051 PAIR058 PAIR059 PAIR062 PAIR063 PAIR066 PAIR067 PAIR070 PAIR071 PAIR072 Performs a cold start. Performs a cold start and clears system and user configurations at the start. Notifies the expiration of GNSS aiding data stored on the module. Automatically outputs text message when the modules are powered up. Sets position fix interval. Gets the position fix interval. Sets the minimum SNR of satellites in use. Gets the minimum SNR of satellites in use. Sets the output rate of standard NMEA sentence. Gets the output rate of standard NMEA sentence. Sets the GNSS search mode. Gets the GNSS search mode. Sets the static navigation speed threshold. Gets the static navigation speed threshold. Sets satellite elevation mask. - - - - PAIR073 Gets satellite elevation mask. PMTK286 PMTK286 PMTK286 PMTK286 PAIR074 Enables/disables AIC function. L8x&LC86x_Series_Difference_Introduction 41 / 50 GNSS Module Series LC86L LC86G L80 L80-R L86 Description Series Series - - - - PAIR075 Queries AIC function. PMTK886 PMTK886 PMTK886 PMTK886 PAIR080 Sets navigation mode. - PMTK838 PMTK301 PMTK401 PMTK501 PMTK313 PMTK413 PMTK513 - - PMTK301 PMTK401 PMTK501 - - PMTK301 PMTK401 PMTK501 PMTK313 PMTK413 PMTK513 - - -PMTK301 PMTK401 PMTK501 PMTK313 PMTK413 PMTK513 - PAIR081 PAIR086 PAIR087 PAIR098 PAIR099 PAIR154 PAIR155 PAIR158 PAIR159 PAIR382 PAIR391 PAIR400 PAIR401 PAIR410 PAIR411 PAIR432 Gets navigation mode. Enables/disables debug log output in binary format. Queries the debug log output setting. Sets the decimal places for the position displayed in NMEA. Gets the decimal places for the position displayed in NMEA. Enables/disables outputting of RLM message at 1 Hz Queries RLM message output setting. Enables/disables tracking of BDS B1C satellite band. Queries tracking of BDS B1C band status. Enables/disables system sleep status locking. Enables/disables jamming detection. Sets the source mode of DGPS correction data. Queries the setting of DGPS mode. Enables/disables the searching of SBAS satellites. Queries the status of SBAS satellite search. Sets RTCM output mode. - - - - PAIR433 Queries RTCM output mode. Enables/disables outputting - - - - PAIR434 stationary antenna reference in RTCM format. L8x&LC86x_Series_Difference_Introduction 42 / 50 GNSS Module Series L80 - - PMTK869 PMTK225 PMTK225 PMTK285 PMTK185 L80-R - - PMTK869 PMTK285 - L86 - - PMTK869 PMTK225 PMTK225 PMTK285 PMTK185 LC86L Series - - PMTK869 PMTK225 PMTK225 PMTK285 PMTK185 LC86G Series PAIR435 PAIR436 PAIR437 Description Queries the setting of stationary antenna reference point. Enables/disables outputting satellite ephemeris information in RTCM format. Queries the status of outputting satellite ephemeris. PAIR490 Enables/disables EASY function. PAIR491 PAIR511 PAIR513 Queries the status of EASY function. Saves current navigation data from RTC RAM to flash. Saves the current configurations from RTC RAM to flash. PAIR650 Puts the module to Backup mode. PAIR680 PAIR681 PAIR690 PAIR691 PAIR730 Enables/disables GPS Low Power (GLP) mode Queries GPS Low Power (GLP) mode setting. Sets the modules to Periodic mode for power saving. Queries Periodic Power Saving m ode configurations. Enables/disables Fitness Low Power (FLP) mode. PAIR731 Queries FLP mode setting. PAIR732 PAIR733 Enables/disables adaptive low power (ALP) mode. Queries adaptive low-power (ALP) mode configuration setting. PAIR752 Sets PPS configurations. PAIR864 PAIR865 Sets the baud rate of UART interface. Gets the baud rate of UART interface. PAIR900 Stops or starts LOCUS data logging. L8x&LC86x_Series_Difference_Introduction 43 / 50 L80 L80-R PMTK183 - - - - - PMTK184 - - - PMTK622 - - - GNSS Module Series L86 PMTK183 - LC86L Series PMTK183 - LC86G Series PAIR901 PAIR903 PAIR905 Description Queries the LOCUS logging status. PAIR902 Sets LOCUS saving mode. PMTK184 - PMTK184 - PAIR904 Sets LOCUS mode threshold. Erases the LOCUS logger flash PAIR906 data. PAIR907 Saves current fix data in flash. PMTK622 - PMTK622 - PAIR908 Dumps LOCUS Data Queries total number of recorded PAIR909 LOCUS data NOTE The default configurations of the modules are different, and you need to check the protocol document for detailed command introduction. See documents [6], [7] and [8] protocol specifications for details. 4.4.3. PQ Versus PQTM Messages PQ messages are supported by Quectel L80, L86, and LC86L series. PQTM message are supported by Quectel LC86G series. Table 18: Differences Between PQ and PQTM Messages L80 PQEPE PQ1PPS PQTXT PQECEF L86 PQEPE PQ1PPS PQTXT PQECEF LC86L Series LC86G Series Description PQEPE PQ1PPS PQTXT PQECEF PQTMEPE EPE message outputting. PQTMCFGMSGR ATE PQTMCFGPPS PQTMANTENNA STATUS - Configures message output rate on the current port. Sets the type and pulse width of 1PPS output. Antenna detection feature Enables/disables ECEFPOSVEL message outputting. L8x&LC86x_Series_Difference_Introduction 44 / 50 GNSS Module Series L80 L86 LC86L Series LC86G Series Description ECEFPOSVE ECEFPOSV ECEFPOSVE - L EL L This message is automatically output when PQECEF is enabled. PQODO PQODO PQODO PQTMODO Starts/stops odometer reading. PQPZ90 PQVEL PQGEO - PQPZ90 PQVEL PQGEO - PQPZ90 PQVEL PQGEO - - PQGBS PQGBS PQVERNO PQVERNO PQVERNO - - - - - - - - - - - - Enables/disables switching from - WGS84 to PZ-90.11. Enables/disables PQVEL - message outputting. PQTMCFGGEOF Configures Geo-fence ENCE parameters. PQTMGEOFENC Outputs the geofences status. ESTATUS Enables/disables the outputting of the GBS sentence used to - support receiver autonomous integrity monitoring (RAIM). PQTMVERNO Queries the information about firmware version. Saves the configurations set via PQTMSAVEPAR $PQTM commands to NVM. PQTMREATOREP Restores all parameters set via AR $PQTM to default values. PQTMCFGANTE Configures the antenna working NNA mode. PQTMPVT Outputs the PVT (GNSS only) result. 4.4.4. PQ Versus PAIR Messages PQ messages are supported by Quectel L80, L86, and LC86L series. PAIR messages are supported by Quectel LC86G series. Table 19: Differences Between PQ and PAIR Messages L80 L86 LC86L Series LC86G Series PQBAUD PQFLP PQBAUD PQBAUD - - PAIR864 PAIR730 PAIR731 Description Sets NMEA port default baud rate. Sets the modules to FLP mode and gets whether the FLP mode L8x&LC86x_Series_Difference_Introduction 45 / 50 GNSS Module Series L80 PQJAM - L86 LC86L Series LC86G Series PQGLP PQGLP PQJAM PQJAM PQRLM PQRLM PQPREC PQPREC PAIR680 PAIR681 PAIR391 PAIR154 PAIR098 PAIR099 Description is enabled. Sets the modules to GLP mode and gets whether the GLP mode is enabled. Enables/disables detection function. jamming Enables/disables the return link message outputting. Sets/Gets NMEA position shown digit mode. NOTE Among LC86L (A), LC86L (B) and LC86L (C), only LC86L (C) supports PQRLM. L8x&LC86x_Series_Difference_Introduction 46 / 50 GNSS Module Series 5 Appendix A References Table 20: Related Documents Document Name [1] Quectel_L80_Hardware_Design [2] Quectel_L80-R_Hardware_Design [3] Quectel_L86_Hardware_Design [4] Quectel_LC86L_Hardware_Design [5] Quectel_LC86G_Series_Hardware_Deisgn [6] Quectel_Lx0&Lx6&LC86L&LG77L_GNSS_Protocol_Specification [7] Quectel_L80-R_GPS_Protocol_Specification [8] Quectel_LC26G&LC26G-T&LC76G&LC86G_Series_GNSS_Protocol_Specification Table 21: Terms and Abbreviations Abbreviation AGNSS AIC BDS BOM bps CEP COGM COGT Description Assisted GNSS (Global Navigation Satellite System) Active Interference Cancellation BDS Satellite Navigation System Bill of Materials bit(s) per second Circular Error Probable Course over Ground (in Magnetic North Course Direction) Course over Ground (in True North Course Direction) L8x&LC86x_Series_Difference_Introduction 47 / 50 Abbreviation DGPS DTM EASY EGNOS EPO ESD FET GAGAN Galileo GBS GGA GLL GLONASS GNSS GPS GSA GSV HDOP I/O LDO LNA MSAS NMEA PMU 1PPS QZSS GNSS Module Series Description Differential Global Positioning System Datum Reference Embedded Assist System European Geostationary Navigation Overlay Service Extended Prediction Orbit Electrostatic Discharge Field Effect Transistor GPS Aided Geo Augmented Navigation Galileo Satellite Navigation System (EU) GNSS Satellite Fault Detection Global Positioning System Fix Data Geographic Position - Latitude and Longitude Global Navigation Satellite System (Russia) Global Navigation Satellite System Global Positioning System GNSS DOP and Active Satellites GNSS Satellites in View Horizontal Dilution of Precision Input/Output Low-dropout Regulator Low-Noise Amplifier Multi-functional Satellite Augmentation System (Japan) NMEA (National Marine Electronics Association) 0183 Interface Standard Power Management Unit One Pulse Per Second Quasi-Zenith Satellite System L8x&LC86x_Series_Difference_Introduction 48 / 50 Abbreviation RF RMC RTC RXD SBAS SNR SOG TBD TTFF TXD TXT UART UTC VCC VTG WAAS WGS84 Description Radio Frequency Recommended Minimum Specific GNSS Data Real-Time Clock Receive Data (Pin) Satellite-Based Augmentation System Signal to Noise Ratio Speed over Ground To Be Determined Time to First Fix Transmit Data (Pin) Text Transmission Universal Asynchronous Receiver/Transmitter Coordinated Universal Time Supply Voltage Course Over Ground & Ground Speed Wide Area Augmentation System World Geodetic System 1984 GNSS Module Series L8x&LC86x_Series_Difference_Introduction 49 / 50 GNSS Module Series 6 Appendix B GNSS Numbering Table 22: GNSS Constellations Information GNSS Type GPS GLONASS Galileo System ID 1 2 3 Satellite ID 1–32 65–96 1–36 BDS 4 1–63 QZSS 5 SBAS - 193–199 33–64 Signal ID 1 = L1 C/A 1 = G1 C/A 7 = E1 1 = B1I 3 = B1C 1 = L1 C/A - NOTE This GNSS Numbering is only applicable to LC86G series and may vary depending on modules. For more information, see GNSS protocol specification document for the dedicated module. L8x&LC86x_Series_Difference_Introduction 50 / 50

LC760Z&L76-L&L76-LB 软件差异说明 GNSS 模块系列 版本：1.0 日期：2024-03-28 状态：受控文件 LC760Z&L76-L&L76-LB 软件差异说明 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 23 LC760Z&L76-L&L76-LB 软件差异说明 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最 大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 23 LC760Z&L76-L&L76-LB 软件差异说明 关于文档 文档信息 标题 副标题 文档类型 文档状态 LC760Z&L76-L&L76-LB 软件差异说明 GNSS 模块系列 差异说明 受控文件 修订历史 版本 1.0 日期 描述 2023-11-29 文档创建 2024-03-28 受控版本 上海移远通信技术股份有限公司 3 / 23 LC760Z&L76-L&L76-LB 软件差异说明 目录 关于文档 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 特殊符号 .................................................................................................................................... 6 2 差异概述 ................................................................................................................................................. 7 3 差异说明 ................................................................................................................................................. 8 3.1. 默认配置 .................................................................................................................................... 8 3.2. 星系 ........................................................................................................................................... 8 3.3. UART 波特率 ........................................................................................................................... 10 3.4. PPS ......................................................................................................................................... 10 3.5. AGNSS .................................................................................................................................... 11 3.6. 协议 ......................................................................................................................................... 11 3.6.1. NMEA 标准语句.............................................................................................................. 11 3.6.1.1. TalkerID ............................................................................................................ 11 3.6.1.2. 标准语句类型 .................................................................................................. 12 3.6.1.2.1. RMC 语句差异 ......................................................................................... 13 3.6.1.2.2. GGA 语句差异 ......................................................................................... 14 3.6.1.2.3. GLL 语句差异 .......................................................................................... 15 3.6.1.2.4. ZDA 语句、GRS 语句和 GST 语句.......................................................... 16 3.6.1.2.5. GBS 语句和 DTM 语句 ............................................................................ 16 3.6.2. 专有语句 ......................................................................................................................... 16 3.7. 支持功能 .................................................................................................................................. 19 3.8. 固件升级 .................................................................................................................................. 21 4 附录 参考文档及术语缩写 .................................................................................................................... 22 上海移远通信技术股份有限公司 4 / 23 LC760Z&L76-L&L76-LB 软件差异说明 表格索引 表 1：特殊符号 ............................................................................................................................................. 6 表 2：默认配置及支持功能差异 ................................................................................................................... 8 表 3：支持的所有星系组合........................................................................................................................... 8 表 4：支持的 PPS 配置 .............................................................................................................................. 10 表 5：支持的 AGNSS 功能..........................................................................................................................11 表 6：支持的协议 ........................................................................................................................................11 表 7：NMEA TalkerID 的差异 ..................................................................................................................... 12 表 8：支持的 NMEA 标准语句.................................................................................................................... 12 表 9：PQTM 和 PQ 语句差异 ..................................................................................................................... 16 表 10：Binary 和 PMTK 语句差异 .............................................................................................................. 17 表 11：支持功能差异 .................................................................................................................................. 19 表 12：参考文档 ......................................................................................................................................... 22 表 13：术语缩写 ......................................................................................................................................... 22 上海移远通信技术股份有限公司 5 / 23 LC760Z&L76-L&L76-LB 软件差异说明 1 引言 本文档提供了移远通信 LC760Z、L76-L 和 L76-LB 模块的差异对比，简要总结了不同模块之间的特性 和特征，旨在帮助用户从 L76-L 和 L76-LB 向 LC760Z 模块的迁移。如需了解更多信息，请联系移远通信技 术支持（support@quectel.com）。 备注 文档中红色字体为 LC760Z、L76-L 和 L76-LB 模块间的主要差异。 1.1. 特殊符号 表 1：特殊符号 标记  定义 该符号表示模块支持该项功能或技术。 上海移远通信技术股份有限公司 6 / 23 LC760Z&L76-L&L76-LB 软件差异说明 2 差异概述 移远通信 LC760Z 模块基本兼容 L76-L 和 L76-LB 模块，本章节简要介绍了三者软件上的差异。 LC760Z、L76-L 和 L76-LB 主要软件差异如下： ⚫ LC760Z 支持的 NMEA 语句遵循 NMEA 0183 V4.11 协议版本，L76-L 和 L76-LB 支持的 NMEA 语 句遵循 NMEA 0183 V4.10 协议版本。L76-L 和 L76-LB 支持的专有协议信息比 LC760Z 多。 ⚫ LC760Z 支持的卫星系统组合比 L76-L 和 L76-LB 多，详见表 3：支持的所有星系组合。 上海移远通信技术股份有限公司 7 / 23 LC760Z&L76-L&L76-LB 软件差异说明 3 差异说明 3.1. 默认配置 默认配置的差异点如下表： 表 2：默认配置及支持功能差异 字段 LC760Z L76-L L76-LB 默认波特率 115200 bps 9600 bps 9600 bps 默认星系 GPS + GLONASS + Galileo + QZSS 或 GPS + GLONASS + GPS + GLONASS + QZSS GPS + Galileo + BDS + QZSS QZSS 或 GPS + BDS + QZSS 备注 1. LC760Z 不能同时接收 GLONASS 和 BDS 卫星信号。如果需要从支持 GLONASS 卫星信号的星系配 置和支持 BDS 卫星信号的星系配置间进行切换，则需要更新固件版本，详情请联系移远通信技术支持 （support@quectel.com）。 2. L76-LB 有 2 种固件版本，不同的固件版本支持的默认星系不同。如需了解更多详情，详情请联系移远 通信技术支持（support@quectel.com）。 3.2. 星系 表 3：支持的所有星系组合 模块 支持的所有星系 LC760Z GPS、GLONASS、Galileo 和 QZSS 支持的所有星系组合 ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + GLONASS ⚫ GPS + GLONASS + QZSS ⚫ GPS + Galileo ⚫ GPS + Galileo + QZSS 上海移远通信技术股份有限公司 8 / 23 LC760Z&L76-L&L76-LB 软件差异说明 模块 L76-L L76-LB 支持的所有星系 支持的所有星系组合 ⚫ GPS + GLONASS + Galileo ⚫ GPS + GLONASS + Galileo + QZSS（默认） ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + BDS GPS、Galileo、BDS 和 QZSS ⚫ GPS + BDS + QZSS ⚫ GPS + Galileo ⚫ GPS + Galileo + QZSS ⚫ GPS + Galileo + BDS ⚫ GPS + Galileo + BDS + QZSS（默认） ⚫ GPS ⚫ GPS + QZSS ⚫ GPS + GLONASS ⚫ GPS + Galileo GPS、GLONASS、BDS、Galileo 和 QZSS ⚫ ⚫ GPS + BDS GPS + GLONASS + QZSS（默认） ⚫ GPS + Galileo + QZSS ⚫ GPS + BDS + QZSS ⚫ GPS + GLONASS + Galileo ⚫ GPS + GLONASS + Galileo + QZSS ⚫ GPS GPS、GLONASS、BDS 和 QZSS ⚫ GPS + QZSS ⚫ GPS + GLONASS ⚫ GPS + BDS ⚫ GPS + GLONASS + QZSS（默认）或 GPS + BDS + QZSS（默认） 备注 1. LC760Z 不能同时接收 GLONASS 和 BDS 卫星信号。如果需要从支持 GLONASS 卫星信号的星系配 置和支持 BDS 卫星信号的星系配置间进行切换，则需要更新固件版本，详情请联系移远通信技术支 持（support@quectel.com）。 2. L76-LB 有 2 种固件版本，不同的固件版本支持的默认星系不同。如需了解更多详情，请联系移远通信 技术支持（support@quectel.com）。 3. LC760Z 的 GPS 周有效期是 2019 年 4 月至 2038 年 11 月，L76-L 和 L76-LB 的 GPS 周有效期是 2014 年 12 月至 2034 年 8 月。 上海移远通信技术股份有限公司 9 / 23 LC760Z&L76-L&L76-LB 软件差异说明 3.3. UART 波特率 LC760Z 支持的 UART 波特率和 L76-L 和 L76-LB 数量一致，但是 LC760Z 可用波特率频率更高，二者 支持的波特率如下： ⚫ LC760Z：9600 bps、19200 bps、38400 bps、57600 bps、115200 bps、230400 bps 和 460800 bps。 ⚫ L76-L 和 L76-LB ：4800 bps、9600 bps、14400 bps、19200 bps、38400 bps、57600 bps 和 115200 bps。 3.4. PPS LC760Z 支持的 PPS 配置项比 L76-L 和 L76-LB 多，二者支持的 PPS 配置项如下： 表 4：支持的 PPS 配置 PPS 配置 脉宽 配置项 - LC760Z ● 周期 - ● 偏移 - ● 极性 - ● 工作模式 第一次定位后 - 仅 3D 定位后 ● 仅 2D/3D 定位后 - 一直输出 - L76-L/L76-LB ● ● ● ● ● ● 上海移远通信技术股份有限公司 10 / 23 3.5. AGNSS LC760Z&L76-L&L76-LB 软件差异说明 表 5：支持的 AGNSS 功能 AGNSS LC760Z L76-L/L76-LB 星历文件 AID-PEPH-GPS EASY & EPO 有效期 2 小时（在线） EASY：6 小时（在线） 1~2 天（离线，目前服务器最多可下载 7 天） EPO：3、7、14 天（离线） 备注 有关 AGNSS 的详细操作，详情请参考文档 [1]和[2] application notes。 3.6. 协议 LC760Z、L76-L 和 L76-LB 模块支持以下协议： 表 6：支持的协议 协议 类型 NMEA 0183 Binary 输出、ASCII、标准 输入/输出、ASCII、专有 输入/输出、二进制、专有 LC760Z NMEA 0183 V4.11 PQTM ● L76-L/L76-LB NMEA 0183 V4.10 PMTK 和 PQ - 3.6.1. NMEA 标准语句 3.6.1.1. TalkerID LC760Z 支持 NMEA 0183 V4.11 协议版本，而 L76-L 和 L76-LB 支持 NMEA 0183 V4.10 协议版本。 NMEA 0183 V4.11 和 NMEA 0183 V4.10 协议版本中 TalkerID 差异如下： 上海移远通信技术股份有限公司 11 / 23 LC760Z&L76-L&L76-LB 软件差异说明 表 7：NMEA TalkerID 的差异 GNSS 星系配置 TalkerID (NMEA 0183 V4.10) GPS GP GLONASS GL Galileo GA BDS BD QZSS 多卫星系统组合 GP GP（未定位时） GN（定位时） TalkerID (NMEA 0183 V4.11) GP GL GA GB GQ GN 3.6.1.2. 标准语句类型 LC760Z、L76-L 和 L76-LB 均支持 NMEA 标准语句输出。二者支持的 NMEA 标准语句类型如下： 表 8：支持的 NMEA 标准语句 NMEA 标准语句 RMC GGA GSV GSA VTG GLL ZDA GRS GST GBS DTM LC760Z ● ● ● ● ● ● ● ● ● - L76-L/L76-LB ● ● ● ● ● ● - ● ● 上海移远通信技术股份有限公司 12 / 23 LC760Z&L76-L&L76-LB 软件差异说明 关于 LC760Z、L76-L 和 L76-LB 支持的 NMEA 标准语句类型，详情请参考文档 [3]和[4] 协议规范。 3.6.1.2.1. RMC 语句差异 RMC 表示推荐的最少专用 GNSS 数据。本语句包含 GNSS 接收机提供的时间、日期、位置、航向和 速度数据。 类型： 输出 格式： $RMC,,,,,,,,,,,,,* 参数： 字段 $ RMC 格式 字符 字符串，2 位 字符串，3 位 hhmmss.sss 字符 ddmm.mmmmmm 字符 dddmm.mmmmmm 字符 十进制 十进制 ddmmyy - 描述 LC760Z 和 L76-LB: 十进制小数部分默认保留 6 位。 L76-L：十进制小数部分默认保留 4 位 LC760Z 和 L76-LB: 十进制小数部分默认保留 6 位。 L76-L：十进制小数部分默认保留 4 位 - 上海移远通信技术股份有限公司 13 / 23 字段 格式 字符 字符 十六进制 字符 描述 - LC760Z&L76-L&L76-LB 软件差异说明 3.6.1.2.2. GGA 语句差异 GGA 提供全球定位系统定位数据。本语句包含 GNSS 接收机提供的时间、位置和定位相关数据。 类型： 输出 格式： $GGA,,,,,,,,,,M,,M,,* 参数： 位置 $ GGA 格式 字符 String, 2 characters String, 3 characters hhmmss.sss ddmm.mmmmmm Character dddmm.mmmmmm Character 差异 - - - LC760Z 和 L76-LB: 十进制小数部分默认保留 6 位。 L76-L：十进制小数部分默认保留 4 位 LC760Z 和 L76-LB: 十进制小数部分默认保留 6 位。 L76-L：十进制小数部分默认保留 4 位 - 上海移远通信技术股份有限公司 14 / 23 位置 1) M M 格式 Numeric, 1 digit Numeric, 2 digits Numeric Numeric Character Numeric Character Hexadecimal Character LC760Z&L76-L&L76-LB 软件差异说明 差异 LC760Z 和 L76-L：十进制小数部分默认保留 1 位。 L76-LB： 十进制小数部分默认保留 3 位。 LC760Z 和 L76-L：十进制小数部分默认保留 1 位。 L76-LB： 十进制小数部分默认保留 3 位。 - 3.6.1.2.3. GLL 语句差异 GLL 表示地理位置—纬度和经度。本语句包含接收机的纬度与经度、定位时间和状态。 类型： 输出 格式： $GLL,,,,,,,* 参数： 位置 $ GLL 格式 字符 String, 2 characters String, 3 characters 差异 - 上海移远通信技术股份有限公司 15 / 23 位置 格式 ddmm.mmmmmm Character dddmm.mmmmmm Character Numeric, 3 digits Character Character Hexadecimal Character LC760Z&L76-L&L76-LB 软件差异说明 差异 LC760Z 和 L76-LB: 十进制小数部分默认保留 6 位。 L76-L：十进制小数部分默认保留 4 位 LC760Z 和 L76-LB: 十进制小数部分默认保留 6 位。 L76-L：十进制小数部分默认保留 4 位 - 3.6.1.2.4. ZDA 语句、GRS 语句和 GST 语句 仅LC760Z支持ZDA, GRS和GST标准NMEA语句输出，相关语句详情请参考文档 [3]和[4] 协议规范。 3.6.1.2.5. GBS 语句和 DTM 语句 仅L76-L和L76-LB支持GBS和DTM标准NMEA语句输出，相关语句详情参考文档 [3]和[4] 协议规范。 3.6.2. 专有语句 LC760Z 支持 PQTM 和 Binary 语句；L76-L 和 L76-LB 支持 PMTK 和 PQ 语句。 表 9：PQTM 和 PQ 语句差异 LC760Z PQTMVERNO PQTMCFGMSGRATE PQTMANTENNASTATUS PQTMCFGODO PQTMRESETODO L76-L/L76-LB 描述 PQVERNO 查询固件版本信息。 - 设置/查询当前接口的语句输出速率。 PQODO 输出天线状态。 PQTMCFGODO：配置里程计功能。 PQTMRESETODO：重置里程计的累计里程。 上海移远通信技术股份有限公司 16 / 23 LC760Z&L76-L&L76-LB 软件差异说明 LC760Z PQTMODO L76-L/L76-LB PQTMEPE PQEPE PQTMCFGGEOFENCE PQGEO PQTMGEOFENCESTATUS PQTMJAMMING PQTMJAMMINGSTATUS PQJAM - PQBAUD 描述 PQTMODO：输出里程计信息。 PQODO：开启/关闭里程计读取。 PQTMEPE：输出预估的定位误差。 PQEPE：开启/关闭 PQEPE 信息输出。 PQTMCFGGEOFENCE：配置/查询地理围栏功能。 PQTMGEOFENCESTATUS：输出地理围栏状态。 PQGEO：配置/查询/输出地理围栏功能。 PQTMJAMMING：配置/查询干扰检测状态。 PQTMJAMMINGSTATUS：输出干扰检测状态。 PQJAM：配置/查询/输出干扰检测功能。 配置 NMEA 语句输出端口默认波特率。 - PQ1PPS 设置 1PPS 输出类型和秒脉冲宽度。 - PQFLP 设置模块进入/退出 FLP 模式或查询模块的工作模式。 - PQTXT 开启/关闭 GPTXT 信息输出。 PQECEF PQECEF：开启/关闭 ECEFPOSVEL 信息输出。 - ECEFPOSVEL ECEFPOSVEL：自动输出 ECEFPOSVEL 信息。 - PQPZ90 开启/关闭 WGS84 转换 PZ-90.11. - PQGLP 设置模块进入/退出 GLP 模式或查询 GLP 模式是否开启。 - PQVEL 开启/关闭 PQVEL 信息输出。 PQTMCFGNMEADP PQPREC 设置/查询 NMEA 语句参数小数点后位数。 - PQGBS 开启/关闭 PQGBS 信息输出。 - PQRLM 开启/关闭反馈链接信息输出。 表 10：Binary 和 PMTK 语句差异 LC760Z ACK-ACK ACK-NAK CFG-PRT L76-L/L76-LB 描述 PMTK001 PMTK251 ACK-ACK：对有效或可识别消息的响应。 ACK-NAK：对无效或无法识别消息的响应。 PMTK001：对其他 PMTK 命令的响应，通知主机接收机是否成功 接收数据包。 CFG-PRT：配置/查询 UART 串口号和对应波特率。 PMTK251：设置 UART 接口波特率。 上海移远通信技术股份有限公司 17 / 23 LC760Z&L76-L&L76-LB 软件差异说明 LC760Z CFG-MSG CFG-PPS CFG-CFG L76-L/L76-LB 描述 PMTK314 PMTK414 PMTK514 PMTK255 PMTK256 PMTK285 CFG-MSG：设置/查询消息输出速率。 PMTK314：设置 NMEA 语句输出速率。 PMTK414：查询当前 NMEA 语句输出速率。 PMTK514：PMTK_API_Q_NMEA_OUTPUT 的响应。 CFG-PPS：设置 PPS。 PMTK255：开启/关闭 PPS 基于 NMEA 定位输出功能。 PMTK256：开启/关闭授时产品模式。 PMTK285：设置 PPS 类型。 - 清除/保存当前配置。 CFG-DOP CFG-ELEV PMTK311 CFG-NAVSAT PMTK353 PMTK313 PMTK413 PMTK513 PMTK351 PMTK352 PMTK301 PMTK401 PMTK501 CFG-SIMPLERST PMTK101 PMTK102 PMTK103 PMTK104 CFG-PWRCTL PMTK220 CFG-SPDHOLD PMTK386 CFG-SLEEP PMTK161 CFG-EPHSAVE - PMTK010 设置/查询 PDOP 阈值。 CFG-ELEV：设置/查询导航卫星的仰角阈值。 PMTK311：设置卫星的仰角阈值。 CFG-NAVSAT：设置/查询卫星系统使能状态。 PMTK353：配置模块的搜星系统。 PMTK313：开启/关闭 SBAS 卫星接收。 PMTK413：查询 SBAS 的配置。 PMTK513：PMTK_API_Q_SBAS_ENABLED 的响应。 PMTK351：开启/关闭 QZSS 语句格式。 PMTK352：开启/关闭 QZSS 功能。 PMTK301：配置 DGPS 差分数据的模式。 PMTK401：查询 DGPS 模式设置。 PMTK501：PMTK_API_Q_DGPS_MODE 的响应。 CFG-SIMPLERST：启动/关闭/复位 GNSS 引擎。 PMTK101：执行热启动。 PMTK102：执行温启动。 PMTK103：执行冷启动。 PMTK104：执行完全冷启动。 CFG-PWRCTL：设置/查询模块功率控制模式和定位频率。 PMTK220：设置定位间隔。 CFG-SPDHOLD：设置/查询静态导航速度阈值。 PMTK386：设置静态导航速度阈值。 CFG-SLEEP：设置 GNSS 模块进入休眠状态（低功耗模式）及休 眠时间。 PMTK161：设置模块进入 Standby 低功耗模式。 开启/关闭星历存储自动存储至 Flash 中或查询当前的星历存储设 置。 模块上电时自动输出系统信息。 - PMTK011 模块上电时自动输出文本信息。 上海移远通信技术股份有限公司 18 / 23 LC760Z&L76-L&L76-LB 软件差异说明 LC760Z - - L76-L/L76-LB 描述 PMTK183 PMTK184 PMTK185 PMTK183：查询 LOCUS 日志记录状态。 PMTK184：擦除 Flash 记录。 PMTK185：开启/关闭 LOCUS 功能或者 PMTK223 配置 DEE 的参数。 PMTK225 设置模块为 Periodic 模式。 PMTK286 开启/关闭 AIC 功能。 PMTK306 PMTK605 PMTK705 PMTK622 配置卫星最小的 SNR 值。 PMTK605：查询固件版本信息。 PMTK705：输出固件版本信息。 转储 Flash 中的 LOCUS 数据。 PMTK838 开启/关闭干扰检测功能。 PMTK869 开启/关闭 EASY 功能或查询 EASY 功能是否开启。 PMTK875 开启/关闭闰秒显示语句输出或查询闰秒显示语句输出是否开启。 PMTK886 设置导航模式。 PMTKSPF 输出干扰检测状态信息。 备注 有关 LC760Z、L76-L 和 L76-LB 支持的专有语句，详情请参考文档 [3]和[4] 协议规范。 3.7. 支持功能 支持功能的差异点详情见下表： 表 11：支持功能差异 字段 冷启动/热启动/温启动 定位间隔 LC760Z L76-L/L76-LB 差异 ● ● - ● ● LC760Z：200~1000 毫秒。 上海移远通信技术股份有限公司 19 / 23 LC760Z&L76-L&L76-LB 软件差异说明 字段 LC760Z L76-L/L76-LB 差异 L76-L 和 L76-LB：100~1000 毫秒。 低功耗模式 ● ● GNSS 星系搜索模式 配置/查询 UART 波特率 配置 PPS 配置/查询 SBAS 状态 ● ● ● ● ● ● ● ● LC760Z：Standby 模式和 Backup 模式。 L76-L：Standby 模式、Backup 模式、Periodic 模式、AlwaysLocate 模式和 GLP 模式。 L76-LB：Standby 模式、Backup 模式、 Periodic 模式和 GLP 模式。 - 有关模块支持的波特率，详情请参考第 3.3 章 UART 波特率。 有关模块支持的 PPS 配置项，详情请参考 第 3.4 章 PPS。 - 配置/查询 NMEA 语句输出频率 ● ● - 配置/查询静态导航速度阈值 ● ● - 查询固件版本信息 ● ● - 配置/输出干扰检测功能 ● ● - 配置/输出地理围栏功能 ● ● - 配置/查询 PDOP 阈值 ● - - 配置/输出天线状态 ● - - 配置/输出里程计功能 ● ● - 配置 FLP/GLP 模式 - ● - 配置/输出 GPTXT 信息 - ● - 配置/输出 ECEFPOSVEL 信息 - ● - 配置 WGS84 转换 PZ-90.11. - ● - 配置/输出 PQVEL/PQGBS - ● - 配置/输出反馈链接信息 - ● - 配置/查询 LOCUS/EASY 功能 - ● - 配置导航模式功能 - ● - 上海移远通信技术股份有限公司 20 / 23 LC760Z&L76-L&L76-LB 软件差异说明 字段 配置/输出闰秒显示信息 配置 DEE 功能 配置 AIC 功能 LC760Z L76-L/L76-LB 差异 - ● - - ● - - ● - 备注 有关 LC760Z、L76-L 和 L76-LB 支持的专有语句，详情请参考文档 [3]和[4] 协议规范。 3.8. 固件升级 LC760Z、L76-L 和 L76-LB 的固件升级流程有差异，详见文档 [5]和[6] 固件升级。 上海移远通信技术股份有限公司 21 / 23 LC760Z&L76-L&L76-LB 软件差异说明 4 附录 参考文档及术语缩写 表 12：参考文档 文档名称 [1] Quectel_LC260Z(00)&LC760Z_AGNSS_Application_Note [2] Quectel_Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note [3] Quectel_LC260Z(00)&LC760Z_GNSS_协议规范 [4] Quectel_LG77L(C)&Lx0&Lx6&LC86L_Series_GNSS_Protocol_Specification [5] Quectel_LC260Z(00)&LC760Z_固件升级指导 [6] Quectel_Lx6&LC86L&LG77L_固件升级指导 表 13：术语缩写 缩写 英文全称 中文全称 1PPS One Pulse Per Second AGNSS Assisted GNSS (Global Navigation Satellite System) ANT Antenna BDS BeiDou Navigation Satellite System COG Course over Ground Galileo Galileo Satellite Navigation System (EU) GLONASS Global Navigation Satellite System (Russia) GNSS Global Navigation Satellite System GPS Global Positioning System GSA GNSS DOP and Active Satellites 每秒一个脉冲 辅助 GNSS 定位功能 天线 北斗卫星导航系统 对地航向 伽利略卫星导航系统（欧盟） 格洛纳斯导航卫星系统（俄罗斯） 全球导航卫星系统 全球定位系统 GNSS DOP 值和可用卫星 上海移远通信技术股份有限公司 22 / 23 LC760Z&L76-L&L76-LB 软件差异说明 缩写 GSV HDOP NMEA PDOP PGKC PQ PQTM QZSS RMC RTC SBAS SOG UART UTC VTG 英文全称 中文全称 GNSS Satellites in View 可见 GNSS 卫星 Horizontal Dilution of Precision 水平精度因子 NMEA (National Marine Electronics Association) 0183 NMEA（美国国家海洋电子协会） Interface Standard 0183 接口标准 Position Dilution of Precision 位置精度因子 Proprietary Protocol Defined by the Chipset Supplier 芯片供应商专有协议 Quectel Proprietary Protocol 移远通信专有协议 Quectel Proprietary Protocol 移远通信专有协议 Quasi-zenith Satellite System 准天顶卫星系统（日本） Recommended Minimum Specific GNSS Data 推荐最小特定 GNSS 语句 Real-time Clock 实时时钟 Satellite-based Augmentation System 星基增强系统 Speed over Ground 对地航速 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Coordinated Universal Time 协调世界时 Course Over Ground & Ground Speed 地面航向和速度 上海移远通信技术股份有限公司 23 / 23

EC200U 系列&EG912U-GL GNSS 应用指导 LTE Standard 模块系列 版本：1.2 日期：2024-01-09 状态：受控文件 EC200U 系列&EG912U-GL GNSS 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上 提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 日期 2020-12-17 2021-05-13 2022-08-23 2024-01-09 作者 变更表述 Lambert ZHAO 文档创建 Lambert ZHAO Tyler LI Reilly NIAN 受控版本 1. 删 除 适 用 模 块 EC600U 系 列 、 EG500U-CN 和 EG700U-CN ； 新 增 适 用 模 块 EC200U-AU 和 EG912U-GL； 2. 新增 AT 命令的最大响应时间； 3. 更新 BDS NMEA 语句的前缀（第 1.3 章）； 4. 更 新 AT+QGPSCFG='beidounmeatype' 命 令 中 参数取值对应的 NMEA 语句 类型及默认值（第 2.3.1.6 章）； 5. 更新模块支持的 GNSS 卫星导航系统（第 2.3.1.8 章）； 6. 新 增 AT+QGPSCFG='beidounmeaformat' （ 第 2.3.1.10 章）； 7. 新增 AT+QGPSCFG='apflash'（第 2.3.1.11 章）； 8. 扩展 AT+QAGPSCFG 支持配置 IP 类型和 APN（第 2.3.8 章）。 新增有关文件系统中预置文件不可随意删除的备注（第 1 章）。 上海移远通信技术股份有限公司 3 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 1.2. 打开/关闭 GNSS 步骤 ................................................................................................................. 7 1.3. 支持的 NMEA 语句类型............................................................................................................... 8 2 GNSS AT 命令 ....................................................................................................................................... 9 2.1. AT 命令说明................................................................................................................................. 9 2.1.1. 定义 .................................................................................................................................. 9 2.1.2. AT 命令语句...................................................................................................................... 9 2.2. AT 示例声明................................................................................................................................. 9 2.3. AT 命令详解............................................................................................................................... 10 2.3.1. AT+QGPSCFG 配置 GNSS......................................................................................... 10 2.3.1.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口....................................... 10 2.3.1.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 ............................................................................................................................. 11 2.3.1.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型................ 12 2.3.1.4. AT+QGPSCFG='glonassnmeatype' 配置 GLONASS NMEA 语句的输出类型13 2.3.1.5. AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 ....... 14 2.3.1.6. AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型........... 14 2.3.1.7. AT+QGPSCFG='gnssnmeatype' 配置多系统混合定位 NMEA 语句的输出类型 ………………………………………………………………………………… ……….15 2.3.1.8. AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统...................... 16 2.3.1.9. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 ........................................ 17 2.3.1.10. AT+QGPSCFG='beidounmeaformat' 配置 BDS NMEA 语句的前缀............... 18 2.3.1.11. AT+QGPSCFG='apflash' 启用/禁用 AP Flash 快速热启动功能 ...................... 19 2.3.2. AT+QGPSDEL 删除辅助数据 ...................................................................................... 19 2.3.3. AT+QGPS 打开 GNSS ................................................................................................ 20 2.3.4. AT+QGPSEND 关闭 GNSS......................................................................................... 21 2.3.5. AT+QGPSLOC 获取定位信息...................................................................................... 22 2.3.6. AT+QGPSGNMEA 获取指定的 NMEA 语句................................................................ 24 2.3.7. AT+QAGPS 启用/禁用 AGPS...................................................................................... 26 2.3.8. AT+QAGPSCFG 配置 AGPS 相关参数 ....................................................................... 26 2.3.9. AT+QGPSINFO 查看 GNSS 版本信息 ........................................................................ 28 3 示例 ...................................................................................................................................................... 29 3.1. 打开与关闭 GNSS ..................................................................................................................... 29 3.2. 参数的应用........................................................................................................... 29 3.3. GNSS 休眠模式......................................................................................................................... 30 3.4. AGPS 功能应用......................................................................................................................... 30 上海移远通信技术股份有限公司 4 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 4 错误码 .................................................................................................................................................. 31 5 附录 参考文档及术语缩写 ................................................................................................................... 32 上海移远通信技术股份有限公司 5 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型........................................................................................................................................ 9 表 3：错误码列表 ....................................................................................................................................... 31 表 4：参考文档 ........................................................................................................................................... 32 表 5：术语缩写 ........................................................................................................................................... 32 上海移远通信技术股份有限公司 6 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 1 引言 移远通信 EC200U 系列和 EG912U-GL 模块内部集成 GNSS 引擎，支持 GPS、BDS、Galileo 和 GLONASS 进行多系统混合定位（详情请参考第 2.3.1.8 章），为客户提供快速、准确的高性能定位体验。 GNSS 功能使 EC200U 系列和 EG912U-GL 模块广泛应用于如下领域：逐行导航、资产跟踪、穿戴设备、 车辆和人员追踪等。 1.1. 适用模块 表 1：适用模块 模块系列 EC200U EG912U 模块 EC200U-AU EC200U-CN EC200U-EU EG912U-GL 备注 1. EC200U 系列和 EG912U-GL 模块的 GNSS 功能可选，请咨询移远通信技术支持了解当前使用的模 块型号是否支持 GNSS。 2. 存在文件系统中的 GNSS、蓝牙和 TTS 等功能的预置文件不可随意删除。 1.2. 打开/关闭 GNSS 步骤 模块的 GNSS 引擎支持位置计算功能，且无需网络协助。打开/关闭 GNSS 的步骤如下： 步骤 1：通过 AT+QGPSCFG 配置 GNSS 参数。 步骤 2：通过 AT+QGPS 打开 GNSS。 步骤 3：打开 GNSS，且定位成功后，可通过以下三种方式获取定位信息： 上海移远通信技术股份有限公司 7 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 1) NMEA 语句默认输出至 USB NMEA 端口，可以通过读取该端口获取 NMEA 语句。 2) 通过 AT+QGPSLOC 可直接获取定位信息，例如纬度、经度、高度、GNSS 定位模式、 时间、卫星数量等。 3) 通过设置 AT+QGPSCFG='nmeasrc',1 启用通过 AT+QGPSGNMEA 获取指定的 NMEA 语句；如果设置 AT+QGPSCFG='nmeasrc',0，则不能通过 AT+QGPSGNMEA 获取指 定的 NMEA 语句。 步骤 4：执行 AT+QGPSEND 关闭 GNSS。 1.3. 支持的 NMEA 语句类型 模块默认支持的 NMEA 语句与 NMEA 0183 协议兼容。另外，可以通过 5 种前缀区分不同卫星系统的 NMEA 语句，如下所示： GPS NMEA 语句的前缀为'GP'，如下所示： ⚫ GPGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GPRMC - 推荐的最少专用 GNSS 数据 ⚫ GPGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ GPGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GPVTG - 矢量跟踪与对地速度 BDS NMEA 语 句 的 前 缀 为 ' PQ ' 或 ' GB ' 或 ' BD ' ， 可 通 过 AT+QGPSCFG='beidounmeaformat'配置 BDS NMEA 语句前缀。以'PQ'为例，如下所示： ⚫ PQGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ PQGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ PQGGA - 全球定位系统定位数据，如时间、定位等 ⚫ PQRMC - 推荐的最少专用 GNSS 数据 ⚫ PQVTG - 矢量跟踪与对地速度 混合定位 NMEA 语句的前缀为'GN'，如下所示： ⚫ GNGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GNGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GNRMC - 推荐的最少专用 GNSS 数据 ⚫ GNVTG - 矢量跟踪与对地速度 GLONASS NMEA 语句的前缀为'GL'，如下所示： ⚫ GLGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 Galileo NMEA 语句的前缀为'GA'，如下所示： ⚫ GAGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 上海移远通信技术股份有限公司 8 / 33 2 GNSS AT 命令 EC200U 系列&EG912U-GL GNSS 应用指导 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 9 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 2.3. AT 命令详解 2.3.1. AT+QGPSCFG 配置 GNSS 该命令用于查询和配置 GNSS 不同的设置，包括 NMEA 语句输出端口、NMEA 语句的输出类型等。 AT+QGPSCFG 配置 GNSS 测试命令 AT+QGPSCFG=? 响应 +QGPSCFG: 'outport',(支持的列表) +QGPSCFG: 'nmeasrc',(支持的列表) +QGPSCFG: 'gpsnmeatype',(支持的 列表) +QGPSCFG: 'glonassnmeatype',(支持的 列表) +QGPSCFG: 'galileonmeatype',( 支 持 的 列表) +QGPSCFG: 'beidounmeatype',( 支 持 的 列表) +QGPSCFG: 'gnssnmeatype',( 支 持 的 列表) +QGPSCFG: 'gnssconfig',(支持的列表) +QGPSCFG: 'autogps',(支持的列表) +QGPSCFG: 'beidounmeaformat',( 支 持 的 范围) +QGPSCFG: 'apflash',(支持的列表) 最大响应时间 特性说明 OK 300 毫秒 / 2.3.1.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 该命令用于配置 NMEA 语句输出端口。 AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 设置命令 AT+QGPSCFG='outport'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'outport', OK 上海移远通信技术股份有限公司 10 / 33 最大响应时间 特性说明 EC200U 系列&EG912U-GL GNSS 应用指导 若指定可选参数，则配置 NMEA 语句输出端口： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。配置 NMEA 语句输出端口。 'none' 关闭 NMEA 语句输出 'uart1' 通过 UART1 口输出 'uart2' 通过 UART2 口输出 'usbat' 通过 USB AT 口输出 'usbmodem' 通过 USB Modem 口输出 'usbnmea' 通过 USB NMEA 口输出 操作错误码。详细信息可参考第 4 章。 2.3.1.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 该命令用于启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 设置命令 AT+QGPSCFG='nmeasrc'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'nmeasrc', OK 若指定可选参数，则配置是否启用通过 AT+QGPSGNMEA 获 取 NMEA 语句： OK 或者 ERROR 若错误与 ME 功能相关 +CME ERROR: 上海移远通信技术股份有限公司 11 / 33 最大响应时间 特性说明 EC200U 系列&EG912U-GL GNSS 应用指导 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。若使能，则可通过 AT+QGPSGNMEA 获取 NMEA 语句。使能后，执行 AT+QGPSGNMEA，NMEA 语句将以命令返回值的形式通过 AT 口输出。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 2.3.1.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 该命令用于配置 GPS NMEA 语句的输出类型。 AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='gpsnmeatype'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gpsnmeatype', OK 若指定可选参数，则配置 GPS NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。异或运算格式的 GPS NMEA 语句类型输出设置。 0 禁用 1 GPGGA 2 GPRMC 上海移远通信技术股份有限公司 12 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 4 GPGSV 8 GPGSA 16 GPVTG 31 输出全部 5 种类型语句。 操作错误码。详细信息可参考第 4 章。 2.3.1.4. AT+QGPSCFG='glonassnmeatype' 配置 GLONASS NMEA 语句的输出类型 该命令用于配置 GLONASS NMEA 语句的输出类型。 AT+QGPSCFG='glonassnmeatype' 配置 GLONASS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='glonassnmeatype' [,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'glonassnmeatype', OK 若指定可选参数，则配置 GLONASS NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。异或运算格式的 GLONASS NMEA 语句类型输出设置。 0 禁用 1 GLGSV 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 13 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 2.3.1.5. AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 该命令用于配置 Galileo NMEA 语句的输出类型。 AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 设置命令 AT+QGPSCFG='galileonmeatype'[,< Galileo_NMEA_type>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'galileonmeatype', OK 若指定可选参数，则配置 Galileo NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。异或运算格式的 Galileo NMEA 语句类型输出设置。 0 禁用 1 GAGSV 操作错误码。详细信息可参考第 4 章。 2.3.1.6. AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型 该命令用于配置 BDS NMEA 语句的输出类型。 AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='beidounmeatype'[,< BeiDou_NMEA_type>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'beidounmeatype', OK 若指定可选参数，则配置 BDS NMEA 语句的输出类型： 上海移远通信技术股份有限公司 14 / 33 最大响应时间 特性说明 参数 EC200U 系列&EG912U-GL GNSS 应用指导 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 整型。异或运算格式的 BDS NMEA 语句类型输出设置。 0 禁用 1 PQGSA 2 PQGSV 4 PQGGA 8 PQRMC 16 PQVTG 31 输出全部 5 种类型语句 操作错误码。详细信息可参考第 4 章。 2.3.1.7. AT+QGPSCFG='gnssnmeatype' 配置多系统混合定位 NMEA 语句的输出类型 该命令用于配置多系统混合定位 NMEA 语句的输出类型。 AT+QGPSCFG='gnssnmeatype' 配置多系统混合定位 NMEA 语句的输出类型 设置命令 AT+QGPSCFG='gnssnmeatype'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gnssnmeatype', OK 若指定可选参数，则配置多系统混合定位 NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 15 / 33 特性说明 参数 EC200U 系列&EG912U-GL GNSS 应用指导 该命令重启后生效； 参数配置自动保存。 整型。异或运算格式的多系统混合定位 NMEA 语句类型输出设置。 0 禁用 1 GNGGA 2 GNRMC 4 GNGSA 8 GNVTG 15 输出全部 4 种类型语句 操作错误码。详细信息可参考第 4 章。 2.3.1.8. AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统 该命令用于配置模块支持的 GNSS 卫星导航系统。 AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统 设置命令 AT+QGPSCFG='gnssconfig'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gnssconfig', OK 若指定可选参数，则配置支持的 GNSS 卫星导航系统： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关，则返回： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。支持的 GNSS 卫星导航系统。 0 单 GPS 3 GPS + GLONASS + Galileo 混合定位 上海移远通信技术股份有限公司 16 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 4 GPS + GLONASS 混合定位 5 GPS + BDS 混合定位（当模块为 EC200U-CN 时） GPS + BDS + Galileo 混合定位（当模块为 EC200U-AU、EC200U-EU 或 EG912U-GL 时） 6 GPS + Galileo 混合定位 7 单 BDS 操作错误码。详细信息可参考第 4 章。 2.3.1.9. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 该命令用于配置模块启动时，是否自动启动 GNSS。 AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 设置命令 AT+QGPSCFG='autogps'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'autogps', OK 若指定可选参数，则配置是否启用 GNSS 自启动： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。启用/禁用 GNSS 自启动。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 17 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 2.3.1.10. AT+QGPSCFG='beidounmeaformat' 配置 BDS NMEA 语句的前缀 该命令用于配置 BDS NMEA 语句的前缀。 AT+QGPSCFG='beidounmeaformat' 配置 BDS NMEA 语句的前缀 设置命令 AT+QGPSCFG='beidounmeaformat'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'beidounmeaformat', OK 若指定可选参数，则配置 BDS NMEA 语句的前缀： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。BDS NMEA 语句的前缀。 0 PQ 1 GB 2 BD 操作错误码。详细信息可参考第 4 章。 备注 若=0，输出的 PQGSV 语句末尾处会增加 system ID（NMEA 协议定义的 GNSS 系统 ID）信息。 上海移远通信技术股份有限公司 18 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 2.3.1.11. AT+QGPSCFG='apflash' 启用/禁用 AP Flash 快速热启动功能 该命令用于启用/禁用 GNSS 的 AP Flash 快速热启动功能。 AT+QGPSCFG='apflash' 启用/禁用 AP Flash 快速热启动功能 设置命令 AT+QGPSCFG='apflash'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'apflash', OK 若指定可选参数，则启用/禁用 AP Flash 快速热启动功能： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用/禁用 GNSS 的 AP Flash 快速热启动功能。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 2.3.2. AT+QGPSDEL 删除辅助数据 该命令用于删除辅助数据，以便进行 GNSS 冷启动、热启动和温启动操作，且仅可在 GNSS 打开时执 行该命令。 AT+QGPSDEL 删除辅助数据 测试命令 AT+QGPSDEL=? 响应 +QGPSDEL: (支持的范围) 设置命令 AT+QGPSDEL= OK 响应 OK 上海移远通信技术股份有限公司 19 / 33 最大响应时间 特性说明 EC200U 系列&EG912U-GL GNSS 应用指导 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。待删除的 GNSS 辅助数据类型。 0 删除所有辅助数据。开启 GNSS 后，强制冷启动。 1 不删除数据。开启 GNSS 后，条件允许时进行热启动。 2 删除部分相关数据。开启 GNSS 后，条件允许时进行温启动。 操作错误码。详细信息可参考第 4 章。 2.3.3. AT+QGPS 打开 GNSS 该命令用于打开 GNSS 或者唤醒 GNSS 功能。当为 0，GNSS 引擎将持续定位，可通过 AT+QGPSEND 终止 GNSS 会话；当不为 0，且实际定位次数达到指定值时，GNSS 引擎将 自动停止；若实际定位次数未达到指定值，也可通过 AT+QGPSEND 终止 GNSS 会话。 AT+QGPS 打开 GNSS 测试命令 AT+QGPS=? 响应 +QGPS: ( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) OK 查询命令 查询当前 GNSS 会话状态 AT+QGPS? 响应 +QGPS: OK 设置命令 响应 AT+QGPS=[,[,[,[,< 或者 fix_rate>]]]] ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 20 / 33 特性说明 EC200U 系列&EG912U-GL GNSS 应用指导 / 参数 整型。GNSS 状态。 0 GNSS 关闭 1 GNSS 打开 整型。GNSS 工作模式。 1 独立模式 整型。最长定位时间，包括测量 GNSS 伪距期间的反应时间、GPS 卫星搜索的时间上 限、解调星历数据的时间以及计算位置的时间。范围：1~255；默认值：30；单位：秒。 整型。定位精度阈值。范围：0~1000；默认值：50；单位：米。 整型。定位次数。范围：0~1000；默认值：0。 0 表示持续定位；其他值表示实际定位次数。 整型。定位的时间间隔。范围：1~65535；默认值：1；单位：秒。 操作错误码。详细信息可参考第 4 章。 备注 执行 AT+QGPS=1 打开 GNSS，且 AP 侧 log 输出'GNSS Open Success'才表示 GNSS 已完全启动， 此时方可进行其他 GNSS 相关操作。 2.3.4. AT+QGPSEND 关闭 GNSS 该命令用于关闭 GNSS 功能。通过 AT+QGPS=1 打开 GNSS 且为 0，GNSS 引擎将持续 定位，可通过该命令强制终止 GNSS 会话，此时 GNSS 引擎掉电并停止定位。若此时 AP Flash 功能已使 能生效，则在 2 小时内执行 AT+QGPS=1 打开 GNSS 并唤醒 GNSS 引擎，GNSS 引擎默认执行热启动。 AT+QGPSEND 关闭 GNSS 测试命令 AT+QGPSEND=? 查询命令 AT+QGPSEND? 执行命令 终止 GNSS 会话 AT+QGPSEND 响应 OK 或者 ERROR 响应 OK 或者 ERROR 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 21 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 操作错误码。详细信息可参考第 4 章。 2.3.5. AT+QGPSLOC 获取定位信息 该命令用于获取定位信息。执行该命令前，必须通过 AT+QGPS 打开 GNSS。如果定位失败，将根据 对应情况返回+CME ERROR: 。 AT+QGPSLOC 获取定位信息 测试命令 AT+QGPSLOC=? 响应 +QGPSLOC: ,,,,,,< COG>,,,, 设置命令 AT+QGPSLOC= OK 响应 +QGPSLOC: ,,,,,,< COG>,,,, OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。纬度和经度显示格式。 0 ,格式：ddmm.mmmmN/S,dddmm.mmmmE/W 1 ,格式：ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W 上海移远通信技术股份有限公司 22 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 2 ,格式：(-)dd.ddddd,(-)ddd.ddddd 字符串类型。UTC 时间。格式：hhmmss.sss（引自 GPGGA 语句）。 字符串类型。纬度。 如果为 0： 格式：ddmm.mmmmN/S（引自 GPGGA 语句） dd 度。范围：00~89 mm.mmmm 分。范围：00.0000~59.9999 N/S 北纬/南纬 如果为 1： 格式：ddmm.mmmmmm,N/S（引自 GPGGA 语句） dd 度。范围：00~89 mm.mmmmmm 分。范围：00.000000~59.999999 N/S 北纬/南纬 如果为 2： 格式：(-)dd.ddddd（引自 GPGGA 语句） dd.ddddd 度。范围：-89.99999~89.99999 - 南纬 字符串类型。经度。 如果为 0： 格式：dddmm.mmmmE/W（引自 GPGGA 语句） ddd 度。范围：000~179 mm.mmmm 分。范围：00.0000~59.9999 E/W 东经/西经 如果为 1： 格式：dddmm.mmmmmm,E/W（引自 GPGGA 语句） ddd 度。范围：000~179 mm.mmmmmm 分。范围：00.000000~59.999999 E/W 东经/西经 如果为 2： 格式：(-)ddd.ddddd（引自 GPGGA 语句） ddd.ddddd 度。范围：-179.99999~179.99999 - 西经 水平精度因子。范围：0.5~99.9（引自 GPGGA 语句）。 天线的海拔高度。精确到小数点后一位。单位：米（引自 GPGGA 语句）。 整型。GNSS 定位模式（引自 GPGSA 语句）。 2 2D 定位 3 3D 定位 字符串类型。以真北参考基准的对地航向。 格式：ddd.mm（引自 GPVTG 语句）。 ddd 度。范围：000~359 mm 分。范围：00~59 上海移远通信技术股份有限公司 23 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 对地速度。精确到小数点后一位。单位：千米/时（引自 GPVTG 语句）。 对地速度。精确到小数点后一位。单位：节（引自 GPVTG 语句）。 UTC 日期。格式：ddmmyy（引自 GPRMC 语句）。 dd 日 mm 月 yy 年 卫星数量。固定两位数，前导位数不足则补 0（引自 GPGGA 语句）。 操作错误码。详细信息可参考第 4 章。 2.3.6. AT+QGPSGNMEA 获取指定的 NMEA 语句 该命令用于获取指定的 NMEA 语句。使用该命令前，必须先通过 AT+QGPS 打开 GNSS，并将 设置为 1，然后通过 AT+QGPSGNMEA 获取指定的 NMEA 语句。 用 户 可 以 通 过 AT+QGPSCFG='gpsnmeatype',0 、 AT+QGPSCFG='glonassnmeatype',0 、 AT+QGPSCFG='galileonmeatype',0 、 AT+QGPSCFG='beidounmeatype',0 和 AT+QGPSCFG='gnssnmeatype',0 禁用语句输出，即不再输出更新的语句，保存的是 GNSS 激活后禁用 语句输出前已获取的 NMEA 语句。如果保存的 NMEA 语句包含 AT+QGPSGNMEA 指定的语句类型，就依 然可通过 AT+QGPSGNMEA 获取指定的 NMEA 语句。 AT+QGPSGNMEA 获取指定的 NMEA 语句 测试命令 AT+QGPSGNMEA=? 响应 +QGPSGNMEA: (支持的列表) 设置命令 查询 GGA 语句 AT+QGPSGNMEA='GGA' OK 响应 [+QGPSGNMEA: ] OK 设置命令 查询 RMC 语句 AT+QGPSGNMEA='RMC' 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] OK 设置命令 查询 GSV 语句 AT+QGPSGNMEA='GSV' 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] OK 上海移远通信技术股份有限公司 24 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 设置命令 查询 GSA 语句 AT+QGPSGNMEA='GSA' 设置命令 查询 VTG 语句 AT+QGPSGNMEA='VTG' 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] OK 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。NMEA 语句类型。 'GGA' GGA 语句 'RMC' RMC 语句 'GSV' GSV 语句 'GSA' GSA 语句 'VTG' VTG 语句 字符串类型。GGA 语句。 字符串类型。RMC 语句。 字符串类型。GSV 语句。 字符串类型。GSA 语句。 字符串类型。VTG 语句。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 25 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 2.3.7. AT+QAGPS 启用/禁用 AGPS 该命令用于启用/禁用 GNSS 的 AGPS 功能。 AT+QAGPS 启用/禁用 AGPS 测试命令 AT+QAGPS=? 响应 +QAGPS: (支持的列表) 查询命令 查询当前 AGPS 是否开启 AT+QAGPS? 设置命令 设置启用或禁用 AGPS 功能 AT+QAGPS= 最大响应时间 特性说明 OK 响应 +QAGPS: OK 响应 OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用/禁用 GNSS 的 AGPS 功能。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 2.3.8. AT+QAGPSCFG 配置 AGPS 相关参数 该命令用于配置 AGPS 的参数。 AT+QAGPSCFG 配置 AGPS 相关参数 测试命令 AT+QAGPSCFG=? 响应 +QAGPSCFG: ( 支 持 的 范 围 ),,,,,( 支 持 的 范围), 查询命令 OK 响应 上海移远通信技术股份有限公司 26 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 AT+QAGPSCFG? +QAGPSCFG: ,,,,,, OK 设置命令 响应 AT+QAGPSCFG=[,[, OK [,[,[,>[,]]]]]] 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置自动保存。 参数 整型。PDP 索引。范围：1~7；默认值：1。 字符串类型。AGPS 服务器地址。 默认值：'http://quectel-api1.rx-networks.cn/rxn-api/locationApi/rtcm'。 字符串类型。用户名。默认值：'wLgWwv6JQt'；最大长度：30 字节。 字符串类型。客户标识。默认值：'Quectel'。 字符串类型。密码。默认值：'aFltUERDZzZxeTY5cEp2eA=='；最大长度：30 字节。 整型。IP 类型。 0 指定 PDP 上下文上次激活时设置的 IP 类型 1 IPv4 2 IPv6 3 IPv4v6 注：若指定 PDP 上下文未曾被激活，则默认值为 1。 字符串类型。接入点名称。默认值：'NULL'；最大长度：99 字节。 操作错误码。详细信息可参考第 4 章。 备注 启用 AGPS 功能后，指定的 PDP 上下文将可能被去激活。因此，AGPS 功能不可与其他应用 同时共用同一个 PDP 上下文，否则可能导致网络应用异常断开，需要重新拨号。 上海移远通信技术股份有限公司 27 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 2.3.9. AT+QGPSINFO 查看 GNSS 版本信息 该命令用于查看 GNSS 的版本信息。 AT+QGPSINFO 查看 GNSS 版本信息 测试命令 AT+QGPSINFO=? 查询命令 AT+QGPSINFO? 执行命令 AT+QGPSINFO 响应 OK 响应 OK 响应 +QGPSINFO: OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。GNSS 的版本信息。 操作错误码。详细信息可参考第 4 章。 举例 AT+QGPSINFO //查询 GNSS 版本信息。 +QGPSINFO: UC6226,G1B1,V1.0,R3.0.0Build1500,080101800600 OK 上海移远通信技术股份有限公司 28 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 3 示例 3.1. 打开与关闭 GNSS 该示例使用默认参数来打开 GNSS。打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。通过 AT+QGPSEND 可关闭 GNSS。 AT+QGPS=1 //打开 GNSS。 OK //打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。 AT+QGPSLOC=0 //获取定位信息。 +QGPSLOC: 061951.000,3150.7223N,11711.9293E,0.7,62.2,2,000.00,0.0,0.0,110513,09 OK AT+QGPSEND OK //关闭 GNSS。 3.2. 参数的应用 打开 GNSS 并将设为 1 后，可以直接通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc',1 //将设为 1，使能通过 AT+QGPSGNMEA 获取 NMEA 语句。 OK AT+QGPSGNMEA='GGA' //获取 GGA 语句。 +QGPSGNMEA: $GNGGA,074113.00,3148.57843,N,11718.02170,E,1,18,1.17,22.3,M,,M,,*68 OK AT+QGPSCFG='nmeasrc',0 //将设为 0，禁用通过 AT+QGPSGNMEA 获取 NMEA 语句。 OK AT+QGPSGNMEA='GGA' //获取 GGA 语句。 +CME ERROR: 507 //禁用通过 AT+QGPSGNMEA 获取 NMEA 语句，因此无法获取 GGA 语句。 上海移远通信技术股份有限公司 29 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 3.3. GNSS 休眠模式 模块上电并打开 GNSS 之后，在不断电重启的情况下发送 AT+QGPSEND 使 GNSS 引擎掉电关闭、 停止定位降低流耗。若此时 AP Flash 功能已使能生效，则在 2 个小时内通过 AT+QGPS=1 打开 GNSS 引 擎会进行 AP Flash 热启动，从而实现快速定位。 AT+QGPS=1 //打开 GNSS。 OK AT+QGPSEND OK //在不断电重启的情况下关闭 GNSS。此时 GNSS 引擎掉电并停止定位，但是星历数据保存。 AT+QGPSLOC=0 //获取定位信息。 +CMS ERROR: 505 //此时 GNSS 功能无法使用。 AT+QGPS=1 //若 AP Flash 功能已使能生效，2 小时内重新开启 GNSS，GNSS 引擎执 行热启动。 OK AT+QGPSLOC=0 //获取定位信息。 +QGPSLOC: 121251.000,2301.4623N,11314.4612E,0.8,141.6,3,000.00,0.5,0.3,020321,20 OK 3.4. AGPS 功能应用 AT+QAGPSCFG 用于配置 AGPS 的相关参数；AT+QAGPS=1 启用 AGPS 功能。在联网正常以及 AGPS 的相关参数配置正确的前提下，每次模块开机并打开 GNSS 后均能自动获取星历数据，实现快速定位。 AT+QAGPSCFG=1,'http://quectel-api1.rx-networks.cn/rxn-api/locationApi/rtcm','wLgWwv6JQt',' Quectel','aFltUERDZzZxeTY5cEp2eA==',1,'ctnet' //配置 AGPS 的相关参数。 OK AT+QAGPS=1 //开启 AGPS 功能。 OK AT+QGPS=1 //打开 GNSS。 OK AT+QFLST='*' +QFLST: 'UFS:agps.txt',5020 //有关该命令的详情请参考文档 [1]。 //下载的星历数据，有效时间为 2 小时，2 小时 之后需重新连接服务器下载。 OK 上海移远通信技术股份有限公司 30 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 4 错误码 表示与 GNSS 操作相关的错误，详细的参数值，见下表。 表 3：错误码列表 501 502 503 504 505 506 507 508 512 513 514 515 516 517 549 错误码 Invalid parameter(s) Operation not supported GNSS subsystem busy Session is ongoing Session not active Operation timeout Function not enabled Time information error Validity time is out of range Internal resource error GNSS locked End by E911 Not fixed now CMUX port is not opened Unknown error 中文解释 无效参数 操作不支持 GNSS 子系统繁忙 会话仍在进行 会话未激活 操作超时 功能未使能 时间信息错误 过了有效期 内部资源错误 GNSS 锁住 由 E911 结束 当前未定位 CMUX 端口未打开 未知错误 上海移远通信技术股份有限公司 31 / 33 EC200U 系列&EG912U-GL GNSS 应用指导 5 附录 参考文档及术语缩写 表 4：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_FILE_应用指导 表 5：术语缩写 缩写 AGPS APN BDS CMUX DOP Galileo GGA GLONASS GNSS GPS GSA GSV IP IPv4 英文全称 中文全称 Assisted GPS (Global Positioning System) 辅助全球定位系统 Access Point Name 接入点名称 BeiDou Navigation Satellite System 北斗卫星导航系统 Connection Multiplexing 连接（串口）多路复用 Dilution of Precision 精度因子 Galileo Satellite Navigation System 伽利略卫星导航系统 Global Positioning System Fix Data 全球定位系统定位数据 Global Navigation Satellite System 格洛纳斯卫星导航系统 Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 GPS DOP and Active Satellites GNSS 精度因子（DOP）与有效卫星 GNSS Satellites in View 可视的 GNSS 卫星 Internet Protocol 网际互连协议 Internet Protocol version 4 第 4 版互联网协议 上海移远通信技术股份有限公司 32 / 33 IPv6 ME NMEA NVRAM RMC UART URL USB UTC VTG EC200U 系列&EG912U-GL GNSS 应用指导 Internet Protocol version 6 Mobile Equipment NMEA (National Marine Electronics Association) 0183 Interface Standard Non-Volatile Random Access Memory Recommended Minimum Specific GNSS Data Universal Asynchronous Receiver & Transmitter Uniform Resource Locator Universal Serial Bus Coordinated Universal Time Course Over Ground and Ground Speed 第 6 版互联网协议 移动设备 NMEA（美国国家海洋电子协会）0183 接 口标准 非易失性随机访问存储器 推荐的最少专用 GNSS 数据 通用异步收发传输器 资源定位符 通用串行总线 协调世界时 地面速度信息 上海移远通信技术股份有限公司 33 / 33

EC200D&ECx00G&ECx00U 系列 双卡双待应用指导 LTE Standard 模块系列 版本：1.1 日期：2022-07-13 状态：受控文件 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2021-07-10 2021-08-16 2022-07-13 作者 Braden HE Braden HE Braden HE 变更表述 文档创建 受控版本 1. 新 增 适 用 模 块 EC200D-CN 、 EC600G-CN 和 EC800G-CN（第 1.1 章）。 2. 更新 AT+QDSREG、AT+QDSGREG 和 AT+QDSOPS 的 参 数 的 取 值 范 围 为 0~7 （第 2.3.5、2.3.6、2.3.9 章）。 3. 新增 EC200D-CN、EC600G-CN 和 EC800G-CN 模块支 持的网络信息（第 2.3.5、 2.3.6、2.3.9 章）。 4. 更新 AT+QDSQ 的参数的取值；新增参数 、 和 （第 2.3.8 章）。 5. 更 新 不 同 服 务 模 式 对 应 的 信 号 强 度 类 型 及 相 关 备 注 （第 2.3.8 章）。 6. 新增 EC200D-CN 和 EC200U 系列模块支持(U)SIM2 热 插拔检测功能的备注（第 3.2.4 章）。 7. 新增 EC600G-CN 和 EC800G-CN 模块不支持拨打和接 听电话功能的备注（第 3.4.1、3.4.2 章）。 上海移远通信技术股份有限公司 3 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 2 双卡双待相关 AT 命令............................................................................................................................ 8 2.1. AT 命令说明 ................................................................................................................................ 8 2.1.1. 定义 .................................................................................................................................. 8 2.1.2. AT 命令语句 ..................................................................................................................... 8 2.2. AT 示例声明 ................................................................................................................................ 9 2.3. AT 命令详解 ................................................................................................................................ 9 2.3.1. AT+QDSIM 选择(U)SIM 卡............................................................................................ 9 2.3.2. AT+QDSIMI 查询双(U)SIM 卡的 IMSI ......................................................................... 10 2.3.3. AT+QDSCCID 查询双(U)SIM 卡的 ICCID................................................................... 11 2.3.4. AT+QDSPIN 查询双(U)SIM 卡状态............................................................................. 12 2.3.5. AT+QDSREG 查询双(U)SIM 卡 CS 域网络注册状态 .................................................. 13 2.3.6. AT+QDSGREG 查询双(U)SIM 卡的 PS 域网络注册状态............................................ 15 2.3.7. AT+QDSEREG 查询双(U)SIM 卡的 EPS 网络注册状态 ............................................. 17 2.3.8. AT+QDSQ 查询双(U)SIM 卡的信号强度 ..................................................................... 19 2.3.9. AT+QDSOPS 查询双(U)SIM 卡的运营商 .................................................................... 21 2.4. URC 说明 .................................................................................................................................. 22 3 示例 ...................................................................................................................................................... 24 3.1. 开机初始化 ................................................................................................................................ 24 3.2. (U)SIM 卡应用 ........................................................................................................................... 25 3.2.1. 查询 IMSI........................................................................................................................ 25 3.2.2. 查询 ICCID ..................................................................................................................... 26 3.2.3. 查询(U)SIM 卡状态 ......................................................................................................... 26 3.2.4. (U)SIM 卡检测 ................................................................................................................ 27 3.3. 网络服务应用............................................................................................................................. 27 3.3.1. 网络注册状态查询 .......................................................................................................... 27 3.3.2. 网络注册状态上报 .......................................................................................................... 28 3.3.3. 信号强度 ......................................................................................................................... 29 3.3.4. 网络制式选择与运营商查询 ............................................................................................ 29 3.4. 电话 ........................................................................................................................................... 30 3.4.1. 拨打电话 ......................................................................................................................... 30 3.4.2. 接听电话 ......................................................................................................................... 31 3.5. 短信 ........................................................................................................................................... 31 3.5.1. 发送短信 ......................................................................................................................... 31 3.5.2. 读短信............................................................................................................................. 32 3.6. 场景配置和 PDP 激活/去激活.................................................................................................... 33 上海移远通信技术股份有限公司 4 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 3.7. TCP 应用 ................................................................................................................................... 34 3.7.1. 创建 TCP 连接................................................................................................................ 34 3.7.2. 发送数据 ......................................................................................................................... 35 3.7.3. 接收数据 ......................................................................................................................... 35 3.7.4. 断开连接 ......................................................................................................................... 36 3.8. PPP 拨号 ................................................................................................................................... 37 3.9. ECM/RNDIS 网卡应用............................................................................................................... 37 4 附录 参考文档及术语缩写 ................................................................................................................... 38 上海移远通信技术股份有限公司 5 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型 ....................................................................................................................................... 8 表 3：不同服务模式对应的信号强度类型................................................................................................... 20 表 4：URC 列表 ......................................................................................................................................... 22 表 5：参考文档 ........................................................................................................................................... 38 表 6：术语缩写 ........................................................................................................................................... 38 上海移远通信技术股份有限公司 6 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 1 引言 本文档主要介绍如何使用移远通信 LTE Standard EC200D-CN、ECx00G 和 ECx00U 系列模块的双卡 双待（Dual SIM Dual Standby）功能。具备该功能的模块可同时识别两张(U)SIM 卡，每张(U)SIM 卡可各 自独立地进行找网、小区搜索、监测寻呼信息、小区重选、网络附着和激活等业务，并可通过切换 Modem 协议栈实现双卡同时进行数据业务。但由于模块只使用一套射频和基带，所以实现的是单通功能，即一张 (U)SIM 卡在通话时，另一张(U)SIM 卡无法进行数据或语音业务。 1.1. 适用模块 表 1：适用模块 模块系列 EC200D ECx00G ECx00U 模块 EC200D-CN EC600G-CN EC800G-CN EC200U 系列 EC600U 系列 备注 上述适用模块均支持 2 个(U)SIM 接口，但 ECx00G 和 ECx00U 系列模块的(U)SIM2 为可选功能，且支持 单(U)SIM 卡与双(U)SIM 卡的软件版本不同。若需使用 ECx00G 和 ECx00U 系列模块双卡双待功能，请联 系移远通信技术支持获取支持双卡双待的软件版本。 上海移远通信技术股份有限公司 7 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 2 双卡双待相关 AT 命令 本章节主要描述和双卡双待相关的 AT 命令。 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QDSIM 选择(U)SIM 卡 该命令用于选择当前场景所使用的(U)SIM 卡。 AT+QDSIM 选择(U)SIM 卡 测试命令 AT+QDSIM=? 响应 +QDSIM: (支持的列表) 查询命令 AT+QDSIM? OK 响应 +QDSIM: 设置命令 AT+QDSIM= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。(U)SIM 卡 ID。 0 (U)SIM 卡 1（以下简称 SIM1） 1 (U)SIM 卡 2（以下简称 SIM2） 错误码。请参考文档 [1]。 上海移远通信技术股份有限公司 9 / 40 举例 AT+QDSIM=0 OK AT+QDSIM? +QDSIM: 0 OK EC200D&ECx00G&ECx00U 系列双卡双待应用指导 //选择 SIM1 //查询当前使用的(U)SIM 卡 2.3.2. AT+QDSIMI 查询双(U)SIM 卡的 IMSI 该命令用于查询双(U)SIM 卡的国际移动用户识别码（IMSI）。IMSI 允许 TE 识别 MT 中的(U)SIM 卡 或 UICC（GSM 或者(U)SIM）中的活动应用程序。 AT+QDSIMI 查询双(U)SIM 卡的 IMSI 测试命令 响应 AT+QDSIMI=? 查询命令 OK 响应 AT+QDSIMI? +QDSIMI: , +QDSIMI: , OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。(U)SIM 卡 ID。 0 SIM1 1 SIM2 无双引号的字符串类型。国际移动用户识别码。 错误码。请参考文档 [1]。 上海移远通信技术股份有限公司 10 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 举例 AT+QDSIMI? +QDSIMI: 0,460016085318106 +QDSIMI: 1,460027156528504 //查询 SIM1 和 SIM2 的 IMSI OK 2.3.3. AT+QDSCCID 查询双(U)SIM 卡的 ICCID 该命令用于查询双(U)SIM 卡的集成电路卡识别码（ICCID）。 AT+QDSCCID 查询双(U)SIM 卡的 ICCID 测试命令 响应 AT+QDSCCID=? 查询命令 OK 响应 AT+QDSCCID? +QDSCCID: , +QDSCCID: , OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。(U)SIM 卡 ID。 0 SIM1 1 SIM2 无双引号的字符串。集成电路卡识别码。 错误码。请参考文档 [1]。 举例 AT+QDSCCID? //查询 SIM1 和 SIM2 的 ICCID +QDSCCID: 0,89860118830003741022 +QDSCCID: 1,898600E1122115658504 OK 上海移远通信技术股份有限公司 11 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 2.3.4. AT+QDSPIN 查询双(U)SIM 卡状态 该命令用于查询双(U)SIM 卡的状态，以确认 MT 在操作前是否需要输入密码；密码可为(U)SIM PIN、 (U)SIM PUK 等。 AT+QDSPIN 查询双(U)SIM 卡状态 测试命令 响应 AT+QDSPIN=? 查询命令 OK 响应 AT+QDSPIN? +QDSPIN: , +QDSPIN: , OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 10 秒 / 参数 整型。(U)SIM 卡 ID。 0 SIM1 1 SIM2 无双引号的字符串类型。需要的密码类型。 READY MT（(U)SIM 卡）为就绪状态，无需输入密码。 SIM PIN MT（(U)SIM 卡）为锁定状态，等待输入 PIN 码。 SIM PUK MT（(U)SIM 卡）为锁定状态，等待输入 PUK 码。 SIM PIN2 MT（(U)SIM 卡）为锁定状态，等待输入 PIN2 码。 SIM PUK2 MT（(U)SIM 卡）为锁定状态，等待输入 PUK2 码。 错误码。请参考文档 [1]。 举例 AT+QDSPIN? +QDSPIN: 0,READY +QDSPIN: 1,SIM PIN OK AT+QDSIM=1 //查询 SIM1 和 SIM2 状态 //SIM1 为就绪状态，无需输入密码 //SIM2 为锁定状态，等待输入 PIN 码 //选择 SIM2 上海移远通信技术股份有限公司 12 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 OK AT+CPIN='1234' OK +CPINDS: READY AT+QDSPIN? +QDSPIN: 0,READY +QDSPIN: 1,READY OK //输入 PIN //URC 上报 SIM2 为就绪状态 //查询 SIM1 和 SIM2 状态 备注 关于 AT+CPIN 的详细信息，请参考文档 [1]。 2.3.5. AT+QDSREG 查询双(U)SIM 卡 CS 域网络注册状态 该命令用于查询双(U)SIM 卡的 CS 域注册状态和结果码显示状态。 AT+QDSREG 查询双(U)SIM 卡的 CS 域网络注册状态 测试命令 响应 AT+QDSREG=? 查询命令 OK 响应 AT+QDSREG? +QDSREG: ,,[,,[,]] +QDSREG: ,,[,,[,]] OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。(U)SIM 卡 ID。 0 SIM1 1 SIM2 整型。启用/禁用网络注册相关 URC。 上海移远通信技术股份有限公司 13 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 0 禁用网络注册 URC 1 启用网络注册 URC： +CREG: SIM1 CS 域网络注册 URC +CREGDS: SIM2 CS 域网络注册 URC 2 启用带有位置信息的网络注册 URC： +CREG: [,,[,]] SIM1 带有位置信息的 CS 域网络注册 URC +CREGDS: [,,[,]] SIM2 带有位置信息的 CS 域网络注册 URC 整型。网络注册状态。 0 未注册，ME 当前未搜索要注册的运营商。 1 已注册，归属地网络。 2 未注册，ME 正在搜索要注册的运营商。 3 注册被拒绝。 4 未知状态。 5 已注册，漫游网络。 字符串类型。十六进制格式的两字节位置区号。 字符串类型。十六进制格式的 16 位（GSM）或 28 位（LTE）小区 ID。 整型。选择的访问技术。 0 GSM 1 GSM Compact 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA 和 HSUPA 7 E-UTRAN 错误码。请参考文档 [1]。 举例 AT+QDSREG? +QDSREG: 0,0,1 +QDSREG: 1,0,1 OK AT+QDSIM=0 OK AT+CREG=2 OK AT+QDSIM=1 OK AT+CREG=2 OK //查询 SIM1 和 SIM2 的 CS 域网络注册状态 //选择 SIM1 //SIM1 启用带有位置信息的 CS 域网络注册 URC //选择 SIM2 //SIM2 启用带有位置信息的 CS 域网络注册 URC 上海移远通信技术股份有限公司 14 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 +CREG: 1,'550B','0D89',0 +CREGDS: 1,'550B','0D8A',0 AT+QDSREG? +QDSREG: 0,2,1,'550B','0D89',0 +QDSREG: 1,2,1,'550B','0D8A',0 OK //URC 上报 SIM1 已经注册到网络 //URC 上报 SIM2 已经注册到网络 //查询 SIM1 和 SIM2 CS 域网络注册状态 备注 1. 关于 AT+CREG 的详细信息，请参考文档 [1]。 2. EC200U-CN 模块对 GSM 网络支持状态为可选，EC600U-CN 模块不支持 GSM 网络。 3. EC200D-CN 模块不支持 GSM 网络，支持 WCDMA 和 LTE 网络。 4. EC600G-CN 和 EC800G-CN 模块不支持 GSM 网络，仅支持 LTE 网络。 2.3.6. AT+QDSGREG 查询双(U)SIM 卡的 PS 域网络注册状态 该命令用于查询双(U)SIM 卡的 PS 域网络注册状态和结果码显示状态。 AT+QDSGREG 查询双(U)SIM 卡的 PS 域网络注册状态 测试命令 响应 AT+QDSGREG=? 查询命令 OK 响应 AT+QDSGREG? +QDSGREG: ,,[,,[,]] +QDSGREG: ,,[,,[,]] OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。(U)SIM 卡 ID。 0 SIM1 上海移远通信技术股份有限公司 15 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 1 SIM2 整型。启用/禁用网络注册相关 URC。 0 禁用网络注册 URC 1 启用网络注册 URC： +CGREG: SIM1 PS 域网络注册 URC +CGREGDS: SIM2 PS 域网络注册 URC 2 启用带有位置信息的网络注册 URC： +CGREG: [,,[,]] SIM1 带有位置信息的 PS 域网 络注册 URC +CGREGDS: [,,[,]] SIM2 带有位置信息的 PS 域网 络注册 URC 整型。网络注册状态。 0 未注册，ME 当前未搜索要注册的运营商。 1 已注册，归属地网络。 2 未注册，ME 正在搜索要注册的运营商。 3 注册被拒绝。 4 未知状态。 5 已注册，漫游网络。 字符串类型。十六进制格式的两字节位置区号。 字符串类型。十六进制格式的 16 位（GSM）或 28 位（LTE）小区 ID。 整型。选择的访问技术。 0 GSM 1 GSM Compact 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA 和 HSUPA 7 E-UTRAN 错误码。请参考文档 [1]。 举例 AT+QDSGREG? +QDSGREG: 0,0,1 +QDSGREG: 1,0,1 OK AT+QDSIM=0 OK AT+CGREG=2 OK AT+QDSIM=1 OK //查询 SIM1 和 SIM2 PS 域注册状态 //选择 SIM1 //SIM1 启动带有位置信息的 PS 域网络注册 URC //选择 SIM2 上海移远通信技术股份有限公司 16 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 AT+CGREG=2 OK //SIM2 启动带有位置信息的 PS 域网络注册 URC +CGREG: 1,'DE10','5A29C0B',7 //URC 上报 SIM1 已经注册到网络 +CGREGDS: 1,'550B','F2D4A44',7 AT+QDSREG? +QDSGREG: 0,2,1,'DE10','5A29C0B',7 +QDSGREG: 1,2,1,'550B','F2D4A44',7 //URC 上报 SIM2 已经注册到网络 //查询 SIM1 和 SIM2 PS 域网络注册状态 OK 备注 1. 关于 AT+CGREG 的详细信息，请参考文档 [1]。 2. EC200U-CN 模块对 GSM 网络支持状态为可选，EC600U-CN 模块不支持 GSM 网络。 3. EC200D-CN 模块不支持 GSM 网络，支持 WCDMA 和 LTE 网络。 4. EC600G-CN 和 EC800G-CN 模块不支持 GSM 网络，仅支持 LTE 网络。 2.3.7. AT+QDSEREG 查询双(U)SIM 卡的 EPS 网络注册状态 该命令用于查询双(U)SIM 卡的 EPS 网络注册状态和结果码显示状态。 AT+QDSEREG 查询双(U)SIM 卡的 EPS 网络注册状态 测试命令 响应 AT+QDSEREG=? 查询命令 OK 响应 AT+QDSEREG? +QDSEREG: ,,[,,[,]] +QDSEREG: ,,[,,[,]] OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 17 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 参数 整型。(U)SIM 卡 ID。 0 SIM1 1 SIM2 整型。启用/禁用网络注册相关 URC。 0 禁用网络注册 URC 1 启用网络注册 URC： +CEREG: SIM1 EPS 网络注册 URC +CEREGDS: SIM2 EPS 网络注册 URC 2 启用带有位置信息的网络注册 URC： +CEREG: [,,[,]] SIM1 带有位置信息的 EPS 网络 注册 URC +CEREGDS: [,,[,]] SIM2 带有位置信息的 EPS 网络 注册 URC 整型。网络注册状态。 0 未注册，ME 当前未搜索要注册的运营商。 1 已注册，归属地网络。 2 未注册，ME 正在搜索要注册的运营商。 3 注册被拒绝。 4 未知状态。 5 已注册，漫游网络。 字符串类型。十六进制格式的两字节位置区号。 字符串类型。十六进制格式的 28 位（LTE）小区 ID。 整型。选择的访问技术。 7 E-UTRAN 错误码。请参考文档 [1]。 举例 AT+QDSIM=0 OK AT+CEREG=2 OK AT+QDSIM=1 OK AT+CEREG=2 OK //选择 SIM1 //SIM1 启动带有位置信息的 EPS 网络注册 URC //选择 SIM2 //SIM2 启动带有位置信息的 EPS 网络注册 URC +CEREG: 1,'DE10','5A29C0B',7 //URC 上报 SIM1 已经注册到网络 +CEREGDS: 1,'550B','F2D4A44',7 AT+QDSEREG? +QDSEREG: 0,2,1,'DE10','5A29C0B',7 //URC 上报 SIM2 已经注册到网络 //查询 SIM1 和 SIM2 EPS 网络注册状态 上海移远通信技术股份有限公司 18 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 +QDSEREG: 1,2,1,'550B','F2D4A44',7 OK 备注 关于 AT+CEREG 的详细信息，请参考文档 [1]。 2.3.8. AT+QDSQ 查询双(U)SIM 卡的信号强度 该命令用于查询双(U)SIM 卡当前服务网络的信号强度。如果 MT 在不同的服务模式下注册多个网络， 则可以查询每种模式下网络的信号强度。无论 MT 是否注册了网络，用户都可以运行此命令来查询信号强 度，如果 MT 已注网，可以执行 AT+QCSQ=1 使 MT 主动上报检测到的信号强度。如果 MT 未使用任何服 务网络或服务模式不确定，则将返回'NOSERVICE'作为查询结果。 AT+QDSQ 查询双(U)SIM 卡的信号强度 测试命令 响应 AT+QDSQ=? 查询命令 OK 响应 AT+QDSQ? +QDSQ: ,[,[,[,[,]]]] +QDSQ: ,[,[,[,[,]]]] OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。(U)SIM 卡 ID。 0 SIM1 1 SIM2 字符串类型。当前服务模式。 'NOSERVICE' NOSERVICE 模式 'GSM' GSM/GPRS/EDGE 模式 上海移远通信技术股份有限公司 19 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 'WCDMA' WCDMA/HSDPA/HSPA 模式 'LTE' LTE 模式 表示不同服务模式对应的信号强度类型，见表 3。 整型。GSM 网络下的接收信号强度指示；单位：dBm。 整型。WCDMA 网络下的接收信号强度指示。单位：dBm。 整型。WCDMA 网络下的参考信号接收功率。单位：dBm 整型。WCDMA 网络下的下行载波干扰比。单位：dBm。 整型。GSM 网络下的接收信号强度指示；单位：dBm。 整型。LTE 网络下的接收信号强度指示；单位：dBm。 整型。LTE 网络下的参考信号接收功率；单位：dBm。 整型。LTE 网络下的信号与干扰加噪声比；单位：dB。 整型。LTE 网络下的参考信号接收质量；单位：dB。 错误码。请参考文档 [1]。 表 3：不同服务模式对应的信号强度类型 'NOSERVICE' 'GSM' 'WCDMA' 'LTE' 举例 AT+QDSQ? +QDSQ: 0,'LTE',-55,-86,89,-12 +QDSQ: 1,'LTE',-54,-76,113,-4 OK AT+QDSIM=1 OK AT+QCFG='nwscanmode',1 OK AT+QDSQ? +QDSQ: 0,'LTE',-61,-91,82,-11 +QDSQ: 1,'GSM',-72 OK //查询 SIM1 和 SIM2 的信号强度 //选择 SIM2 //将 SIM2 配置仅使用 GSM 网络 //查询 SIM1 和 SIM2 的信号强度 上海移远通信技术股份有限公司 20 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 备注 1. 关于 AT+QCFG='nwscanmode'的详细信息，请参考文档 [1]。 2. 除 EC200D-CN 模块外，其他模块均返回的绝对值。 2.3.9. AT+QDSOPS 查询双(U)SIM 卡的运营商 该命令用于查询双(U)SIM 卡当前注册的运营商及网络制式。如果未选择任何运营商，则不会返回 、和。 AT+QDSOPS 查询双(U)SIM 卡的运营商 测试命令 AT+QDSOPS=? 查询命令 AT+QDSOPS? 响应 OK 响应 AT+QDSOPS: ,[,[,][, ]] AT+QDSOPS: ,[,[,][, ]] OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 180 秒，取决于网络状态 / 参数 整型。(U)SIM 卡 ID。 0 SIM1 1 SIM2 运营商。表示该参数的格式。 整型。 0 自动搜网 1 手动搜网 2 手动注销网络 4 手动和自动搜网的组合模式 整型。的格式。 0 字符串格式，运营商全称，最多 16 个字符。 上海移远通信技术股份有限公司 21 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 1 字符串格式，运营商简称，最多 16 个字符。 2 数字格式，GSM 位置区域识别号码。 整型。选择的访问技术。 0 GSM 1 GSM Compact 2 UTRAN 3 GSM W/EGPRS 4 UTRAN W/HSDPA 5 UTRAN W/HSUPA 6 UTRAN W/HSDPA 和 HSUPA 7 E-UTRAN 错误码。请参考文档 [1]。 举例 AT+QDSOPS? //查询 SIM1 和 SIM2 的运营商 +QDSOPS: 0,0,0,'CHN-UNICOM',7 +QDSOPS: 1,0,0,'CHINA MOBILE',7 OK 备注 1. EC200U-CN 模块对 GSM 网络支持状态为可选，EC600U-CN 模块不支持 GSM 网络。 2. EC200D-CN 模块不支持 GSM 网络，支持 WCDMA 和 LTE 网络。 3. EC600G-CN 和 EC800G-CN 模块不支持 GSM 网络，仅支持 LTE 网络。 2.4. URC 说明 关于双卡双待版本的 URC 规则如下：SIM1 相关的 URC 使用标准 URC 格式，可参考文档 [1]。SIM2 相关的 URC 均添加后缀'DS'，相关 URC 如表 3 所示。 表 4：URC 列表 类型 SIM1 URC +CFUN: SIM +CPIN: +QUSIM: SIM2 URC +CFUNDS: +CPINDS: +QUSIMDS: 描述 ME 功能模式上报 (U)SIM 卡状态上报 (U)SIM 卡类型上报 上海移远通信技术股份有限公司 22 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 SMS CALL Network NITZ +QIND: PB DONE +QINDDS: PB DONE +QSIMSTAT: +QSIMSTATDS: +CDS: +CDSDS: +CMTI: +CMTIDS: +CMT: +CMTDS: +QIND: SMS DONE +QINDDS: SMS DONE +QINDDS: +QIND: 'SMSFULL','SM' 'SMSFULL','SM' NO CARRIER NO CARRIER DS RING RING DS +CRING: +CRINGDS: +CCWA: +CCWADS: +COLP: +COLPDS: +CLIP: +CREG: +CGREG: +CEREG: +QCSQ: +CTZV: +CTZE: +CLIPDS: +CREGDS: +CGREGDS: +CEREGDS: +QCSQDS: +CTZVDS: +CTZEDS: 电话簿初始化完成 (U)SIM 卡插拔状态上报 收到新 CDS 并直接输出 收到新短信并保存至内存 收到新短信并直接输出 SMS 初始化完成 短信存储已满 电话挂断或建立连接失败 来电提醒 通过非请求结果码而非正常 RING 向 TE 指示来电 呼叫等待 发起语音呼叫时，被叫线路（号 码）识别显示 被叫指示 ME CS 域网络注册状态上报 ME PS 网络注册状态上报 ME EPS 网络注册状态上报 信号质量上报 时区上报 扩展时区上报 上海移远通信技术股份有限公司 23 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 3 示例 此章节介绍模块开机后如何初始化双(U)SIM 卡以及如何使用双(U)SIM 卡进行相关业务，如(U)SIM 卡 信息查询、网络状态查询、拨打电话、接听电话、短信、场景配置和 PDP 激活、TCP 应用、PPP 拨号、 ECM/RNDIS 应用。 3.1. 开机初始化 开机后模块自动检测卡槽，初始化插入的 2 张(U)SIM 卡。当初始化完成后，模块将自动注册网络。正 常开机 URC 会按照如下步骤上报。 RDY +CFUN: 1 //SIM1 的功能模式上报 +CPIN: READY //SIM1 的状态上报 +QUSIM: 1 +CFUNDS: 1 //SIM2 的功能模式上报 +CPINDS: READY //SIM2 的状态上报 +QUSIMDS: 1 +QINDDS: SMS DONE //SIM2 的 SMS 初始化完成 +QINDDS: PB DONE //SIM2 的电话簿初始化完成 +QIND: SMS DONE //SIM1 的 SMS 初始化完成 +QIND: PB DONE AT+QDSREG? +QDSREG: 0,0,1 +QDSREG: 1,0,1 //SIM1 的电话簿初始化完成 //查询 SIM1 和 SIM2 的 CS 域网络注册状态 //SIM1 和 SIM2 均已注册网络 OK 上海移远通信技术股份有限公司 24 / 40 AT+QDSGREG? +QDSGREG: 0,0,1 +QDSGREG: 1,0,1 OK AT+QDSEREG? +QDSEREG: 0,0,1 +QDSEREG: 1,0,1 OK EC200D&ECx00G&ECx00U 系列双卡双待应用指导 //查询 SIM1 和 SIM2 的 PS 域网络注册状态 //SIM1 和 SIM2 均已注册网络 //查询 SIM1 和 SIM2 EPS 网络注册状态 // SIM1 和 SIM2 均已注册网络 3.2. (U)SIM 卡应用 3.2.1. 查询 IMSI AT+QDSIM=0 OK AT+CIMI 460027156528504 OK AT+QDSIM=1 OK AT+CIMI 460016085318106 OK AT+QDSIMI? +QDSIMI: 0,460027156528504 +QDSIMI: 1,460016085318106 OK //选择 SIM1 //查询 SIM1 的 IMSI 号 //选择 SIM2 //查询 SIM2 的 IMSI 号 //同时查询 SIM1 和 SIM2 的 IMSI 号 备注 关于 AT+CIMI 的详细信息，请参考文档 [1]。 上海移远通信技术股份有限公司 25 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 3.2.2. 查询 ICCID AT+QDSIM=0 OK AT+QCCID +QCCID: 898600E1122115658504 //选择 SIM1 //查询 SIM1 的 ICCID 号 OK AT+QDSIM=1 OK AT+QCCID +QCCID: 89860118830003741022 //选择 SIM2 //查询 SIM2 的 ICCID 号 OK AT+QDSCCID? //同时查询 SIM1 和 SIM2 的 ICCID 号 +QDSCCID: 0,898600E1122115658504 +QDSCCID: 1,89860118830003741022 OK 备注 关于 AT+QCCID 的详细信息，请参考文档 [1]。 3.2.3. 查询(U)SIM 卡状态 AT+QDSPIN? +QDSPIN: 0,SIM PIN +QDSPIN: 1,READY //查询 SIM1 和 SIM2 状态 //SIM1 为锁定状态，等待输入 PIN 码 //SIM2 为就绪状态，无需输入密码 OK AT+QDSIM=0 OK AT+CPIN='1234' OK //选择 SIM1 //输入 PIN 码 +CPIN: READY +QUSIM: 1 +QIND: SMS DONE 上海移远通信技术股份有限公司 26 / 40 +QIND: PB DONE AT+QDSPIN? +QDSPIN: 0,READY +QDSPIN: 1,READY OK EC200D&ECx00G&ECx00U 系列双卡双待应用指导 //查询 SIM1 和 SIM2 状态 //SIM1 和 SIM2 均为就绪状态 3.2.4. (U)SIM 卡检测 AT+QSIMDET=1,0 OK //拔出卡槽 1 中的(U)SIM 卡 +CPIN: NOT READY //启用(U)SIM 卡热插拔功能 //插入卡槽 1 中的(U)SIM 卡 +CPIN: READY //拔出卡槽 2 中的(U)SIM 卡 +CPINDS: NOT READY //插入卡槽 2 中的(U)SIM 卡 +CPINDS: READY 备注 1. 关于 AT+QSIMDET 的详细信息，请参考文档 [1]。 2. 仅 EC200D-CN 和 EC200U 系列模块支持(U)SIM2 热插拔检测功能。 3.3. 网络服务应用 3.3.1. 网络注册状态查询 AT+QDSIM=0 OK AT+CREG? +CREG: 0,1 //选择 SIM1 //查询 SIM1 的 CS 域网络注册状态 OK AT+CGREG? +CGREG: 0,1 //查询 SIM1 的 PS 域网络注册状态 上海移远通信技术股份有限公司 27 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 OK AT+CEREG? +CEREG: 0,1 OK AT+QDSREG? +QDSREG: 0,0,1 +QDSREG: 1,0,1 OK AT+QDSGREG? +QDSGREG: 0,0,1 +QDSGREG: 1,0,1 OK AT+QDSEREG? +QDSEREG: 0,0,1 +QDSEREG: 1,0,1 OK //查询 SIM1 的 EPS 网络注册状态 //查询 SIM1 和 SIM2 的 CS 域网络注册状态 //查询 SIM1 和 SIM2 的 PS 域网络注册状态 //查询 SIM1 和 SIM2 的 EPS 网络注册状态 3.3.2. 网络注册状态上报 AT+QDSIM=0 OK AT+CEREG=1 OK AT+QDSIM=1 OK AT+CEREG=1 OK //选择 SIM1 //启用 SIM1 上报 EPS 网络注册 URC //选择 SIM2 //启用 SIM2 上报 EPS 网络注册 URC +CEREG: 0 +CEREG: 1 +CEREGDS: 0 +CEREGDS: 1 上海移远通信技术股份有限公司 28 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 3.3.3. 信号强度 AT+QDSQ? +QDSQ: 0,'LTE',-56,-81,85,-6 +QDSQ: 1,'LTE',-57,-83,83,-7 OK AT+QDSIM=0 OK AT+QCSQ +QCSQ: 'LTE',-56,-81,85,-6 OK AT+QDSIM=1 OK AT+QCSQ +QCSQ: 'LTE',-57,-81,86,-5 OK //查询 SIM1 和 SIM2 的信号强度 //选择 SIM1 //查询 SIM1 的信号强度 //选择 SIM2 //查询 SIM2 的信号强度 备注 关于 AT+QCSQ 的详细信息，请参考文档 [1]。 3.3.4. 网络制式选择与运营商查询 AT+QDSIM=0 OK AT+QCFG='nwscanmode',1 OK AT+COPS? +COPS: 0,0,'CHINA MOBILE',0 //选择 SIM1 //将 SIM1 设置为仅使用 GSM 网络 //查询 SIM1 的运营商 OK AT+QDSOPS? //查询 SIM1 和 SIM2 的运营商 +QDSOPS: 0,0,0,'CHINA MOBILE',0 +QDSOPS: 1,0,0,'CHN-UNICOM',7 OK 上海移远通信技术股份有限公司 29 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 备注 关于 AT+COPS 的详细信息，请参考文档 [1]。 3.4. 电话 3.4.1. 拨打电话 AT+QDSIM=0 OK AT+CREG? +CREG: 0,1 OK ATD10086; OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 OK ATH OK AT+QDSIM=1 OK AT+CREG? +CREG: 0,1 OK ATD10086; OK AT+CLCC +CLCC: 1,0,0,0,0,'10086',129 OK ATH OK //选择 SIM1 //查询 SIM1 的 CS 域网络注册状态 //使用 SIM1 拨打电话 //查询当前所有呼叫 //挂断电话 //选择 SIM2 //查询 SIM2 的 CS 域网络注册状态 //使用 SIM2 拨打电话 //查询当前所有呼叫 //挂断电话 备注 1. 关于 ATD、AT+CLCC 和 ATH 的详细信息，请参考文档 [1]。 2. EC600G-CN 和 EC800G-CN 模块不支持拨打电话的功能。 上海移远通信技术股份有限公司 30 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 3.4.2. 接听电话 AT+QDSIM? +QDSIM: 0 //查询当前使用的(U)SIM 卡 //当前使用的是 SIM1 OK RING DS ATA +CME ERROR: 3 //SIM2 来电 //接听电话 //在 SIM1 场景下接听失败 RING DS AT+QDSIM=1 //选择 SIM2 OK ATA //接听电话 OK AT+CLCC //查询当前所有呼叫 +CLCC: 1,1,0,0,0,'18924012349',129 OK NO CARRIER DS //对端挂断 备注 1. 关于 ATA 和+CME ERROR 的详细信息，请参考文档 [1]。 2. EC600G-CN 和 EC800G-CN 模块不支持接听电话的功能。 3.5. 短信 3.5.1. 发送短信 AT+QDSIM=0 OK AT+CREG? +CREG: 0,1 OK AT+CSCS='GSM' OK AT+CMGF=1 上海移远通信技术股份有限公司 //选择 SIM1 //查询 SIM1 的 CS 域网络注册状态 //设置 TE 输入字符集格式为 GSM 格式 //选择文本模式 31 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 OK AT+CMGS='15212786473' >Hello SIM1 +CMGS: 11 OK +CMTIDS: 'ME',7 AT+QDSIM=1 OK AT+CREG? +CREG: 0,1 OK AT+CMGF=1 OK AT+CMGS='18225658934' >Hello SIM2 +CMGS: 54 OK +CMTI: 'ME',9 //发送短消息到 SIM2 //输入短消息内容，Ctrl+Z 发送，ESC 退出发送 //SIM2 接收到短消息并存储在 ME 中 //选择 SIM2 //查询 SIM2 的 CS 域网络注册状态 //选择文本模式 //发送短消息到 SIM1 //输入短消息内容，Ctrl+Z 发送，ESC 退出发送 //SIM1 接收到短消息并存储在 ME 中 备注 关于 AT+CSCS、AT+CMGF 和 AT+CMGS 的详细信息，请参考文档 [1]。 3.5.2. 读短信 +CMTIDS: 'ME',0 AT+QDSIM? +QDSIM: 0 OK AT+CMGR=0 OK AT+QDSIM=1 OK AT+CPMS? +CPMS: 'ME',1,100,'ME',1,100,'ME',1,100 //SIM2 收到短消息 //查询当前使用的(U)SIM 卡 //查询当前使用的是 SIM1 //读取短消息 //SIM1 未接收到短消息 //选择 SIM2 //查询短消息存储 上海移远通信技术股份有限公司 32 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 OK AT+CMGF? +CMGF: 1 //查询短消息模式 OK AT+CMGR=0 //读取短信 +CMGR: 'REC UNREAD','13929101640',,'2021/04/08,14:15:39+32' Hello SIM2 OK 备注 关于 AT+CMGR、AT+CPMS 和 AT+CMGF 的详细信息，请参考文档 [1]。 3.6. 场景配置和 PDP 激活/去激活 AT+QDSIM=0 OK AT+QICSGP=1,1,'CMNET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.33.194.2' OK AT+QIDEACT=1 OK AT+QDSIM=1 OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.201.2.70' OK //选择 SIM1 //配置 SIM1 的第一路 PDP 的 IP 类型和 APN //激活 SIM1 的第一路 PDP //查询 SIM1 的所有被激活的 PDP 与 IP 地址 //去激活 SIM1 的第一路 PDP //选择 SIM2 //配置 SIM2 的第一路 PDP 的 IP 类型和 APN //激活 SIM2 的第一路 PDP，可与 SIM1 的第一路 PDP 同时存在 //查询 SIM2 的所有被激活的 PDP 与 IP 地址 上海移远通信技术股份有限公司 33 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 AT+QIDEACT=1 OK //去激活 SIM2 的第一路 PDP 备注 关于 AT+QICSGP、AT+QIACT 和 AT+QIDEACT 的详细信息，请参考文档 [2]。 3.7. TCP 应用 3.7.1. 创建 TCP 连接 AT+QDSIM=0 OK AT+QIOPEN=1,0,'TCP','220.180.239.212',8024,0,0 OK //选择 SIM1 //AT+QIACT 激活 SIM1 的第一路 PDP 后，使用 Socket 0 创建 TCP 客户端并进 入缓存模式 +QIOPEN: 0,0 //TCP 客户端连接成功 AT+QISTATE=1,0 //查询 Socket 0 的连接状态 +QISTATE: 0,'TCP','220.180.239.212',8024,0,2,1,0,0,'uart1' OK AT+QDSIM=1 OK AT+QIOPEN=1,1,'TCP','220.180.239.212',8024,0,0 OK //选择 SIM2 //AT+QIACT 激活 SIM2 的第一路 PDP 后，使用 Socket 1 创建 TCP 客户端并进 入缓存模式 +QIOPEN: 1,0 //TCP 客户端连接成功 AT+QISTATE=1,1 //查询 Socket 1 的连接状态 +QISTATE: 1,'TCP','220.180.239.212',8024,0,2,1,1,0,'uart1' OK 备注 关于 AT+QIOPEN 和 AT+QISTATE 的详细信息，请参考文档 [2]。 上海移远通信技术股份有限公司 34 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 3.7.2. 发送数据 AT+QDSIM=0 OK AT+QISEND=0 > SIM1 TEST SEND OK AT+QISEND=0,10 > SIM1 TEST1 SEND OK AT+QISEND=0,0 +QISEND: 19,19,0 OK AT+QDSIM=1 OK AT+QISEND=1,9 > SIM2 TEST SEND OK AT+QISEND=1,0 +QISEND: 9,9,0 OK //选择 SIM1 //Socket 0 发送可变长度数据 //输入内容，Ctrl+Z 发送，ESC 退出发送 //Socket 0 发送固定长度数据，长度为 10 字节 //查询 Socket 0 发送的数据长度 //选择 SIM2 //Socket 1 发送固定长度数据，长度为 9 字节 //输入内容，Ctrl+Z 发送，ESC 退出发送 //查询 Socket 1 发送的数据长度 备注 关于 AT+QISEND 的详细信息，请参考文档 [2]。 3.7.3. 接收数据 +QIURC: 'recv',0 AT+QIRD=0,1500 +QIRD: 17 SIM1 SCOKET0 TEST OK +QIURC: 'recv',1 AT+QIRD=1,1500 +QIRD: 17 SIM2 SCOKET1 TEST //SIM1 的 Socket 0 接收到数据，上报 URC //读取 Socket 0 数据，字节长度为 1500 字节 //实际接收数据长度为 17 字节 //SIM2 的 Socket 1 接收到数据，上报 URC //读取 Socket 1 数据，字节长度为 1500 字节 上海移远通信技术股份有限公司 35 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 OK AT+QIRD=1,1500 +QIRD: 0 OK AT+QIRD=0,0 +QIRD: 17,17,0 OK AT+QIRD=1,0 +QIRD: 17,17,0 OK //读取 Socket 1 数据，字节长度为 1500 字节 //缓存里无数据 //查询 Socket 0 接收数据总长度，包含已读和未读数据 //查询 Socket 1 接收数据总长度，包含已读和未读数据 备注 关于 AT+QIRD 的详细信息，请参考文档 [2]。 3.7.4. 断开连接 AT+QDSIM=0 OK AT+QISTATE? +QISTATE: 0,'TCP','220.180.239.212',8024,0,2,1,0,0,'uart1' //选择 SIM1 //查询 SIM1 下所有 Socket 连接状态 //Socket 0 是 TCP 客户端已连接状态 OK AT+QICLOSE=0 OK AT+QDSIM=1 OK AT+QISTATE? +QISTATE: 1,'TCP','220.180.239.212',8024,0,2,1,1,0,'uart1' //断开 Socket 0 的连接 //选择 SIM2 //查询 SIM2 下所有 Socket 连接状态 //Socket 1 是 TCP 客户端已连接状态 OK AT+QICLOSE=1 OK //断开 Socket 1 的连接 备注 关于 AT+QICLOSE 的详细信息，请参考文档 [2]。 上海移远通信技术股份有限公司 36 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 3.8. PPP 拨号 AT+QDSIM=1 OK AT+CGREG? +CGREG: 0,1 //选择 SIM2 //查询 SIM2 的 PS 域网络注册状态 OK AT+CGDCONT=1,'IP','CMNET' //设置 PDP 上下文 OK ATD*99# //拨号建立连接，启动 PPP CONNECT //进入数据模式，开始 PPP 帧交互流程 7E FF 7D 23 C0 21 7D 21 7D 21 7D 20 7D 2A 7D 22 ...... 备注 关于 PPP 拨号的详细信息，请参考文档 [3]；关于 AT+CGDCONT 的详细信息，请参考文档 [1]。 3.9. ECM/RNDIS 网卡应用 AT+QCFG='usbnet',3 OK //重启 AT+QDSIM=1 OK AT+CGREG? +CGREG: 0,1 //切换到 RNDIS 网卡模式，重启生效 //选择 SIM2 //查询 SIM2 的 PS 域网络注册状态 OK AT+QNETDEVCTL=3,1,1 OK //开启网卡自动拨号，使用 SIM2 的第一路 PDP 并开启 URC 上报 +QNETDEVSTATUS: 1 AT+QNETDEVCTL=0 OK //网卡成功绑定到 PDP //解除绑定，关闭网卡 备注 关于 AT+QNETDEVCTL 的详细信息，请参考文档 [1]。 上海移远通信技术股份有限公司 37 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 4 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_AT 命令手册 [2] Quectel_LTE_Standard(U)系列_TCP(IP)_应用指导 [3] Quectel_LTE_Standard(U)系列_PPP_应用指导 表 6：术语缩写 缩写 英文全称 中文全称 APN Access Point Name 接入点名称 CS Circuit Switched 电路交换 ECM Ethernet Networking Control Model 以太网控制模型 EDGE Enhanced Data Rates for GSM Evolution 增强型数据速率 GSM 演进技术 EGPRS Enhanced General Packet Radio Service 增强通用分组无线业务 EPS Evolved Packet System 演进型分组系统 E-UTRAN Evolved Universal Terrestrial Radio Access Network 演进型通用陆地无线接入网 GPRS General Packet Radio Service 通用分组无线业务 GSM Global System for Mobile Communications 全球移动通信系统 HSDPA High Speed Downlink Packet Access 高速下行分组接入技术 HSUPA High Speed Uplink Packet Access 高速上行链路分组接入 ICCID Integrated Circuit Card Identifier 集成电路卡识别码 上海移远通信技术股份有限公司 38 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 ID IMSI IP LTE ME MT NITZ PDP PIN PLMN PPP PS PUK RF RNDIS RSRP RSRQ RSSI SIM SINR SMS TA TCP TE UART Identifier 标识符 International Mobile Subscriber Identity 国际移动用户识别码 Internet Protocol 互联网协议 Long-Term Evolution 长期演进 Mobile Equipment 移动设备 Mobile Terminal 移动终端 Network Identity and Time Zone / Network Informed 网络标识和时区 Time Zone Packet Data Protocol 分组数据协议 Personal Identification Number 个人识别号 Public Land Mobile Network 公共陆地移动网络 Point-to-Point Protocol 点对点协议 Packet Switch 分组交换 PIN Unlock Key 个人识别密码解锁码 Radio Frequency 射频 Remote Network Driver Interface Specification 远端网络驱动接口协议 Reference Signal Received Power 参考信号接收功率 Reference Signal Received Quality 参考信号接收质量 Received Signal Strength Indication 接收信号强度指示 Subscriber Identity Module 用户身份识别模块 Signal to Interference plus Noise Ratio 信号与干扰加噪声比 Short Message Service 短消息业务 Terminal Adapter 终端适配器 Transmission Control Protocol 传输控制协议 Terminal Equipment 终端设备 Universal Asynchronous Receiver& Transmitter 通用异步收发器 上海移远通信技术股份有限公司 39 / 40 EC200D&ECx00G&ECx00U 系列双卡双待应用指导 UE UICC URC USB (U)SIM User Equipment Universal Integrated Circuit Card Unsolicited Result Code Universal Serial Bus (Universal) Subscriber Identity Module 用户设备 通用集成电路卡 非请求结果码 通用串行总线 （全球）用户身份模块 上海移远通信技术股份有限公司 40 / 40

EC2x&EC200x&EC600S 系列 增强型休眠模式应用指导 LTE Standard 模块系列 版本：1.0 日期：2020-09-30 状态：受控文件 www.quectel.com EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 文档历史 修订记录 版本 1.0 日期 2020-09-18 2020-09-30 作者 钱立超/许真真/ 谭翠/张志强/ 吴昭伟 钱立超/许真真/ 谭翠/张志强/ 吴昭伟 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 介绍 ....................................................................................................................................................... 6 2 相关 AT 命令 ......................................................................................................................................... 7 2.1. AT 命令语句................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 命令详解................................................................................................................................ 8 2.2.1. AT+QSCLKEX ................................................................................................................. 8 3 应用场景测试及注意事项 ...................................................................................................................... 9 3.1. 测试步骤 ..................................................................................................................................... 9 3.2. 测试数据 ..................................................................................................................................... 9 3.3. 测试示例 ....................................................................................................................................11 3.3.1. EC2x 系列不同休眠模式下平均耗流数据对比图 ........................................................... 12 3.3.2. EC200T 系列不同休眠模式下平均耗流数据对比图....................................................... 14 3.3.3. EC200S 系列不同休眠模式下平均耗流数据对比图 ...................................................... 16 3.3.4. EC600S-CN 不同休眠模式下平均耗流数据对比图 ....................................................... 18 3.3.5. 模块不同休眠模式下平均耗流数据对比......................................................................... 20 3.4. 测试结论 ................................................................................................................................... 20 3.5. 注意事项 ................................................................................................................................... 20 4 附录 参考文档和术语缩写 .................................................................................................................. 21 上海移远通信技术股份有限公司 3 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 表格索引 表 1：AT 命令及响应类型............................................................................................................................. 7 表 2：EC2x 系列不同休眠模式下平均耗流数据对比.................................................................................... 9 表 3：EC200T 系列不同休眠模式下平均耗流数据对比 ............................................................................. 10 表 4：EC200S 系列不同休眠模式下平均耗流数据对比 ............................................................................. 10 表 5：EC600S-CN 不同休眠模式下平均耗流数据对比...............................................................................11 表 6：模块不同休眠模式下平均耗流数据对比............................................................................................ 20 表 7：参考文档 ........................................................................................................................................... 21 表 8：术语缩写 ........................................................................................................................................... 21 上海移远通信技术股份有限公司 4 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 图片索引 图 1：EC2x 系列普通休眠模式下平均耗流 ................................................................................................ 12 图 2：EC2x 系列增强型休眠模式下平均耗流............................................................................................. 13 图 3：EC200T 系列普通休眠模式下平均耗流............................................................................................ 14 图 4：EC200T 系列增强型休眠模式下平均耗流 ........................................................................................ 15 图 5：EC200S 系列普通休眠模式下平均耗流............................................................................................ 16 图 6：EC200S 系列增强型休眠模式下平均耗流 ........................................................................................ 17 图 7：EC600S-CN 系列普通休眠模式下平均耗流 ..................................................................................... 18 图 8：EC600S-CN 增强型休眠模式下平均耗流......................................................................................... 19 上海移远通信技术股份有限公司 5 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 1 介绍 本文档主要介绍了在 LTE/WCDMA 网络环境下 EC2x 系列、EC200x 系列和 EC600S-CN 模块增强 型休眠模式的应用指导，包括相关 AT 命令的介绍、应用场景中模块在普通休眠模式及增强型休眠模式下 平均耗流测试数据的对比及注意事项。 增强型休眠模式即模块发送数据后可快速休眠。其与普通休眠模式（通过 AT+QSCLK 控制，关于该 AT 命令的详细信息，请参考文档 [1]或[2]）的区别主要体现在数据收发有间隔的场景下，在数据收发完 成后，增强型休眠模式能够快速的进入休眠状态，从而降低整体平均耗流。 本文档的适用模块为：  EC2x 系列：EC20 R2.1、EC20-CN  EC200T 系列  EC200S 系列  EC600S-CN 上海移远通信技术股份有限公司 6 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 2 相关 AT 命令 2.1. AT 命令语句 2.1.1. 定义  回车符。  换行符。  参数名称。实际命令行中不包含尖括号。  […] 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。  下划线 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 7 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 2.2. AT 命令详解 2.2.1. AT+QSCLKEX 该命令用于控制是否启用增强型休眠模式。 AT+QSCLKEX 测试命令 AT+QSCLKEX=? 响应 +QSCLKEX: (支持的范围),(支持的 范围),(支持的 retry_time 范围) 设置命令 AT+QSCLKEX=[,[,]] 查询命令 AT+QSCLKEX? OK 响应 OK 若有任何错误： ERROR 响应 +QSCLKEX: ,, 最大响应时间 特性说明 OK 300 毫秒 该命令立即生效； 参数配置不保存 参数 整型。禁用/启用增强型休眠模式 0 禁用增强型休眠模式 1 启用增强型休眠模式 整型。模块发送完数据后进入休眠状态的时间。范围：1~50。单位：秒。 整型。若遇到异常情况恢复增强型休眠模式的时间。范围：1~600。单位：分钟。 上海移远通信技术股份有限公司 8 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 3 应用场景测试及注意事项 本章节主要描述和展示了应用场景中模块在普通休眠模式及增强型休眠模式下平均耗流测试的步骤、 数据对比、示例、结论及注意事项，供客户参考。 3.1. 测试步骤 测试场景： 建立 TCP 长连接，每间隔 60 秒向服务器发送 100 字节数据。 需统计数据项：  测试时长  普通休眠模式和增强型休眠模式下进入低功耗模式的平均时长  发送一包数据到进入低功耗模式并等待一定时间的过程（如下测试步骤第 3~4 步）的平均耗流。 测试步骤： 1. EC2x系列、EC200x系列和EC600S-CN模块分别执行如下命令启用增强型休眠模式： EC2x系列：AT+QSCLKEX=1,2,10 EC200x系列和EC600S-CN：AT+QSCLKEX=1,1,10 2. 执行AT+QIOPEN建立TCP连接； 3. 执行AT+QISEND发送一包数据（100字节）； 4. 拉高DTR进入低功耗模式，等待60秒钟（统计平均耗流）； 5. 拉低DTR唤醒模块； 6. 循环第 3~5 步骤（共 12 小时）。 3.2. 测试数据 表 2：EC2x 系列不同休眠模式下平均耗流数据对比 运营商/制式 普通休眠模式/ 增强型休眠模式 时长（小时） 进入低功耗平均时长（秒） 平均耗流（毫安） 普通休眠模式 12 12.6 移动 LTE 增强型休眠模式 12 2.2 85.60 17.50 上海移远通信技术股份有限公司 9 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 普通休眠模式 12 11.2 联通 LTE 增强型休眠模式 12 2.1 普通休眠模式 12 11.3 电信 LTE 增强型休眠模式 12 2.2 普通休眠模式 12 11.1 联通 WCDMA 增强型休眠模式 12 2.1 84.30 12.80 83.80 13.20 83.50 15.30 表 3：EC200T 系列不同休眠模式下平均耗流数据对比 运营商/制式 普通休眠模式/ 增强型休眠模式 时长（小时） 进入低功耗平均时长（秒） 平均耗流（毫安） 普通休眠模式 12 7.2 移动 LTE 增强型休眠模式 12 1.4 33.33 12.34 普通休眠模式 12 13.1 联通 LTE 增强型休眠模式 12 1.3 44.59 12.10 普通休眠模式 12 7.2 电信 LTE 增强型休眠模式 12 1.3 33.46 12.23 普通休眠模式 12 7.4 联通 WCDMA 增强型休眠模式 12 2.4 54.16 21.75 表 4：EC200S 系列不同休眠模式下平均耗流数据对比 运营商/制式 移动 LTE 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 时长（小时） 进入低功耗平均时长（秒） 平均耗流（毫安） 2 24.7 2 1.7 18.65 5.15 普通休眠模式 2 22.2 联通 LTE 增强型休眠模式 2 1.3 27.01 5.18 普通休眠模式 2 12.4 电信 LTE 增强型休眠模式 2 1.8 16.12 5.1 上海移远通信技术股份有限公司 10 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 表 5：EC600S-CN 不同休眠模式下平均耗流数据对比 运营商/制式 普通休眠模式/ 增强型休眠模式 时长（小时） 进入低功耗平均时长（秒） 平均耗流（毫安） 普通休眠模式 2 10.0 移动 LTE 增强型休眠模式 2 2.1 16.13 5.82 普通休眠模式 2 20.0 联通 LTE 增强型休眠模式 2 1.8 26.94 6.38 普通休眠模式 2 6.0 电信 LTE 增强型休眠模式 2 1.6 10.06 6.69 3.3. 测试示例 本章节主要展示了 EC2x 系列、EC200x 系列和 EC600S-CN 模块分别在普通休眠模式和增强型休眠模 式下的平均耗流对比图，仅为较优测试场景下的测试示例。 测试场景：  EC2x 系列、EC200x 系列和 EC600S-CN 模块均配置 AT+QSCLKEX=1,1,10 启用增强型休眠功 能；  插入联通卡并注册 LTE Band 3；  RSRP 为-85（可通过 AT+QENG='servingcell'查询。关于该 AT 命令的详细信息，请参考 文档 [3]。）  EC2x 系列、EC200x 系列和 EC600S-CN 模块分别执行如下命令配置 1 分钟心跳包： EC2x 系列：AT+QICFG='send/auto',0,60,'0123456789'。关于该 AT 命令的详细信息，请参考 文档 [4]。 EC200x 系列和 EC600S-CN：AT+QICFG='tcp/keepalive',1,60,30,3。关于该 AT 命令的详细信 息，请参考文档 [5]。  模块和服务器之间建立 TCP 长连接；  测试时长：0.5 小时。 上海移远通信技术股份有限公司 11 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 3.3.1. EC2x 系列不同休眠模式下平均耗流数据对比图  普通休眠模式 图 1：EC2x 系列普通休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 10 秒，之后进入休眠状态，平均耗流为 28.18 毫安。 上海移远通信技术股份有限公司 12 / 21  增强型休眠 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 图 2：EC2x 系列增强型休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 2 秒，之后进入休眠状态，平均耗流为 8.08 毫安。 对比如上耗流图，在增强型休眠模式下模块在收发数据后能够快速进入休眠状态，从而降低平均耗流。 上海移远通信技术股份有限公司 13 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 3.3.2. EC200T 系列不同休眠模式下平均耗流数据对比图  普通休眠 图 3：EC200T 系列普通休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 10 秒，之后进入休眠状态，平均耗流为 54.16 毫安。 上海移远通信技术股份有限公司 14 / 21  增强型休眠 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 图 4：EC200T 系列增强型休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 1 秒，之后进入休眠状态，平均耗流为 10.21 毫安。 对比如上耗流图，在增强型休眠模式下模块在接收数据后能够快速进入休眠状态，从而降低平均耗流。 上海移远通信技术股份有限公司 15 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 3.3.3. EC200S 系列不同休眠模式下平均耗流数据对比图  普通型休眠 图 5：EC200S 系列普通休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 20 秒，之后进入休眠状态，平均耗流为 24.48 毫安。 上海移远通信技术股份有限公司 16 / 21  增强型休眠 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 图 6：EC200S 系列增强型休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 2 秒，之后进入休眠状态，平均耗流为 4.77 毫安。 对比如上耗流图，在增强型休眠模式下模块在接收数据后能够快速进入休眠状态，从而降低平均耗流。 上海移远通信技术股份有限公司 17 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 3.3.4. EC600S-CN 不同休眠模式下平均耗流数据对比图  普通型休眠 图 7：EC600S-CN 系列普通休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 20 秒，之后进入休眠状态，平均耗流为 27.23 毫安。 上海移远通信技术股份有限公司 18 / 21  增强型休眠 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 图 8：EC600S-CN 增强型休眠模式下平均耗流 如上图所示，模块收数据后，波峰电流时长约为 2 秒，之后进入休眠状态，平均耗流为 4.79 毫安。 对比如上耗流图，在增强型休眠模式下模块在接收数据后能够快速进入休眠状态，从而降低平均耗流。 上海移远通信技术股份有限公司 19 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 3.3.5. 模块不同休眠模式下平均耗流数据对比 表 6：模块不同休眠模式下平均耗流数据对比 运营商/制式 模块 普通休眠模式/ 增强型休眠模式 EC2x 系列 普通休眠模式 增强型休眠模式 联通 LTE EC200T 系列 EC200S 系列 普通休眠模式 增强型休眠模式 普通休眠模式 增强型休眠模式 EC600S-CN 普通休眠模式 增强型休眠模式 时长（小时） 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 平均耗流（毫安） 28.18 8.08 54.16 10.21 24.48 4.77 27.23 4.79 3.4. 测试结论 通过对模块在增强型休眠模式启用前后平均耗流数据的对比可见，增强型休眠模式下对降低功耗效果 明显。 3.5. 注意事项 增强型休眠模式启用后，在用户发起数据交互时，会给基站产生额外的信令负担，所以可能存在终端 被网络侧惩罚不能上线的情况。但目前基站对这些信令交互没有明确的限制，同时模块也针对可能出现的 惩罚场景做了限制。 上海移远通信技术股份有限公司 20 / 21 EC2x&EC200x&EC600S 系列增强型休眠模式应用指导 4 附录 参考文档和术语缩写 表 7：参考文档 序号 文档名称 备注 [1] Quectel_EC20_R2.1_AT_Commands_Manual EC20 R2.1 AT 命令手册 [2] Quectel_EC200T 系列_AT_Commands_Manual EC200T 系列 AT 命令手册 Quectel_EC2x&EG9x&EM05_QuecCell_ [3] AT_Commands_Manual 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列的 QuecCell AT 命令手册 Quectel_EC2x&EG9x&EG2x-G&EM05 系列 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 [4] _TCP(IP)_应用指导 EM05 系列的 TCP(IP)应用指导 Quectel_EC200x&EG912Y&EC600S 系列 [5] _TCP(IP)_应用指导 适用于 EC200x 系列、EG912Y 系列、 EC600S-CN 的 TCP(IP)应用指导 表 8：术语缩写 缩写 DTR IP LTE RSRP TCP WCDMA 英文全称 Data Terminal Ready Internet Protocol Long Term Evolution Reference signal received power Transmission Control Protocol Wideband Code Division Multiple Access 中文全称 数据终端就绪 互联网协议 长期演进 参考信号接收功率 传输控制协议 宽带码分多址 上海移远通信技术股份有限公司 21 / 21

L89&L26-DR&L26-P&L26-T AGNSS Application Note GNSS Module Series Rev. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note_V1.0 Date: 2020-03-17 Status: Released www.quectel.com GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2020. All rights reserved. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 1 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note About the Document Revision History Version 1.0 Date 2020-03-17 Author Berton PENG Description Initial L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 2 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Contents About the Document .................................................................................................................................. 2 Contents ...................................................................................................................................................... 3 Table Index.................................................................................................................................................. 4 1 Introduction ......................................................................................................................................... 5 1.1. Self-Trained Assisted GPS (STAGPS™) ................................................................................... 5 1.2. Real-Time AGNSS (RT-AGNSS) ............................................................................................... 5 2 STAGPS™ Procedure ......................................................................................................................... 7 2.1. STAGPS™ Autonomous Procedure .......................................................................................... 7 2.2. NMEA Commands for STAGPS™ ............................................................................................. 8 2.2.1. $PSTMCFGAGPS........................................................................................................... 8 2.2.2. $PSTMSTAGPSONOFF ................................................................................................. 9 2.2.3. $PSTMSTAGPSINVALIDATE ......................................................................................... 9 2.2.4. $PSTMGETAGPSSTATUS ........................................................................................... 10 3 RT-AGNSS Procedure ...................................................................................................................... 11 3.1. Real-time Assistance Data Uploading Procedure.....................................................................11 3.2. NMEA Commands for RT-AGNSS........................................................................................... 12 3.2.1. $PSTMINITGPS ............................................................................................................ 12 3.2.2. $PSTMINITTIME ........................................................................................................... 13 3.2.3. $PSTMEPHEM ............................................................................................................. 14 3.2.4. $PSTMALMANAC ......................................................................................................... 27 3.3. Real-Time AGNSS Testing Procedure ..................................................................................... 33 3.3.1. Simple COLD Start Test ................................................................................................ 34 3.3.2. Simple WARM Start Test ............................................................................................... 34 4 Appendix A References.................................................................................................................... 35 L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 3 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Table Index Table 1: NMEA Commands List for STAGPS™ ........................................................................................... 8 Table 2: NMEA Commands List for RT-AGNSS ........................................................................................ 12 Table 3: Encoding for GPS Ephemeris ...................................................................................................... 15 Table 4: Encoding for GLONASS Ephemeris ............................................................................................ 17 Table 5: Encoding for Galileo Ephemeris................................................................................................... 20 Table 6: Encoding for BeiDou Ephemeris .................................................................................................. 23 Table 7: Encoding for GPS Almanac .......................................................................................................... 27 Table 8: Encoding for GLONASS Almanac ................................................................................................ 29 Table 9: Encoding for Galileo Almanac ...................................................................................................... 30 Table 10: Encoding for BeiDou Almanac.................................................................................................... 32 Table 11: Related Documents .................................................................................................................... 35 Table 12: Terms and Abbreviations ............................................................................................................ 35 L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 4 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 1 Introduction This document mainly introduces the AGNSS function of Quectel GNSS modules, and describes the operation mechanism and procedures of this function. The main purpose of AGNSS is to improve TTFF of the modules. The modules which support this feature are: ⚫ L89 ⚫ L26-DR ⚫ L26-P ⚫ L26-T 1.1. Self-Trained Assisted GPS (STAGPS™) L89, L26-DR, L26-P and L26-T are able to provide predicted ephemerides to the GNSS engine in a time frame less than the usual time (about 30 seconds) needed to download real ephemeris from the sky. This reduces considerably the time till the module gain fix especially in dense urban canyon environments. The STAGPS™ provides the predicted ephemeris for each satellite. The autonomous solution uses the past real ephemeris (downloaded from the sky and stored in its internal database) to extrapolate the parameters of future ephemeris (up to 5 days of prediction). For these reasons, the STAGPS™ autonomous performances (in terms of position accuracy using predicted ephemeris) are strictly dependent on the real ephemeris database content. During normal use of STAGPS™ autonomous, the system automatically uploads the real ephemeris into its database as soon as new ephemerides are downloaded from the sky, which means the global content of the real ephemeris input database is determined by the history of device running periods in the past. 1.2. Real-Time AGNSS (RT-AGNSS) The Real-Time AGNSS is able to provide the approximate current time, the ephemerides, the almanacs and optionally the approximate position to the GNSS engine in a time frame less than the usual time (about 30 seconds) needed to download real ephemeris from the sky. This information is delivered from the host side to the module side. This reduces considerably the time to get fix especially in critical L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 5 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note environments where the ephemeris download time could be very long. Real-Time AGNSS requires a network connection to download assistance data from the server. The assistance data includes the current time (if not available, from instance, from RTC), the ephemerides, the almanacs and optionally the approximate position. All the assistance data can be injected into the device backup memory with NMEA commands. The following chapters of this document describe those NMEA commands which support Real-Time AGNSS, including the testing procedures to simulate different working scenarios. The NMEA commands and the testing procedures described in this document work for GPS and GLONASS, Galileo and BeiDou. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 6 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 2 STAGPS™ Procedure 2.1. STAGPS™ Autonomous Procedure The main feature introduced by a GNSS device with STAGPS™ capability is the ephemeris availability as soon as the device is turned on (and also GPS fix availability), even if the device is used in critical environments where the ephemeris downloading from the sky is difficult (e.g. urban canyon, low signal strengths, etc.). The STAGPS™ engine uses the old real ephemeris that is stored in its internal database to predict the future ephemeris. Having device ON with visible sky, the internal database is continuously updated with new ephemeris, predictions are updated as well and the expiration time of the prediction is moved forward. If the ephemeris database is not updated (e.g. the update is disabled), the predictions can be used for some days (usually 3 days) in the future and then they expire. The expiration time and the accuracy of GPS position based on predicted ephemeris rely on the real ephemeris (number of ephemeris per satellite and time distance between the ephemeris) used for prediction. The most important and useful test to measure the STAGPS™ performance is the WARM start (device is restarted clearing the real ephemeris stored in the GPS backup memory), as manifested by the steps below. Under this condition, a device without STAGPS™ capability usually gets the fix in a time longer than 18 seconds, while the device with STAGPS™ capability will get the fix in the typical time of HOT start conditions. 1. Enable the Assisted GPS and save the configuration through reset. Once saved, the configurations will persist even after a power cycling. Therefore, this step is generally performed only once. $PSTMCFGAGPS,1 $PSTMSAVEPAR $PSTMSRR 2. Enable STAGPS™ function. //Enable the Assisted GPS //Save the configuration //Reset the system $PSTMSTAGPSONOFF,1 //Enable the STAGPS™ function 3. Wait for STAGPS™ processing to complete. Then, query STAGPS™ processing status. When the status is 0, the STAGPS™ processing is completed. $PSTMGETAGPSSTATUS //Query the status of STAGPS™ L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 7 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 2.2. NMEA Commands for STAGPS™ Table 1: NMEA Commands List for STAGPS™ Command $PSTMCFGAGPS $PSTMSTAGPSONOFF $PSTMSTAGPSINVALIDATE $PSTMGETAGPSSTATUS Description Enable/disable the Assisted GPS. Turn on/off the STAGPS™ engine. Clear the data stored in the STAGPS™ internal database. Return the status of the STAGPS™ internal processing. NOTE The string * is optional when inputting commands. 2.2.1. $PSTMCFGAGPS This command configures the Assisted GPS. The setting can only take effect by issuing the saving command (i.e. $PSTMSAVEPAR) and, then, resetting the system (through $PSTMSRR). Once saved, the configurations will persist even after a power cycling. Synopsis: $PSTMCFGAGPS,* Arguments: Parameter en_agps checksum Format Decimal Hexadecimal, 2 digits Description Enable/disable AGPS engine 0 = AGPS disabled (default) 1 = AGPS enabled Checksum of the message bytes between but not including the $ and * characters Results: ⚫ If no error occurs, the following message will be returned: $PSTMCFGAGPSOK* L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 8 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note ⚫ If there is any error, the following message will be returned: $PSTMCFGAGPSERROR* 2.2.2. $PSTMSTAGPSONOFF Turn on/off the STAGPS™ engine. Synopsis: $PSTMSTAGPSONOFF,* Arguments: Parameter param checksum Format Decimal, 1 digit Hexadecimal, 2 digits Description ON/OFF status of the STAGPS™ engine: 0 = The STAGPS™ engine is suspended. 1 = The STAGPS™ engine is started Checksum of the message bytes between but not including the $ and * characters Results: ⚫ If no error occurs, the following messages will be returned: $PSTMPOLSTARTED*08 Or //The engine is started. $PSTMPOLSUSPENDED*02 //The engine is suspended. ⚫ If there is any error, the following message will be returned: $PSTMPOLONOFFERROR*5f 2.2.3. $PSTMSTAGPSINVALIDATE Clear the data stored in the STAGPS™ internal database. Synopsis: $PSTMSTAGPSINVALIDATE,* L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 9 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Arguments: Parameter param checksum Format Decimal, 1 digit Hexadecimal, 2 digits Description The database should be erased: 1 = Clear the real ephemeris database (only autonomous). Checksum of the message bytes between but not including the $ and * characters Results: ⚫ If no error occurs, the following message will be returned: $PSTMSTAGPSINVALIDATEOK,1*00 ⚫ If there is any error, the following message will be returned: $PSTMSTAGPSINVALIDATEERROR*41 2.2.4. $PSTMGETAGPSSTATUS Return the status of the STAGPS™ internal processing. Synopsis: $PSTMGETAGPSSTATUS* Arguments: None Results: The system sends back the STAGPS™ status in the following message: $PSTMAGPSSTATUS,* The parameters included in the result above are listed below: Parameter status checksum Format Decimal, 1 digit Hexadecimal, 2 digits Description 0 = The STAGPS™ processing is completed. Any number different from zero means that the STAGPS™ processing is ongoing and so the ephemeris prediction data has not been completely generated. Checksum of the message bytes between but not including the $ and * characters L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 10 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 3 RT-AGNSS Procedure 3.1. Real-time Assistance Data Uploading Procedure The Real-Time AGNSS performances depend on the availability of a network connection in order to download assistance data, which include: ⚫ the current time (if not available, from instance, from RTC) ⚫ the ephemerides ⚫ the almanacs ⚫ the approximate position (optional) The procedure is as follows: 1. Once those data have been downloaded from the server, the first thing to do is to inject the current time into the device (if the device has no RTC, or if it is set to a wrong time). This can be done either by using the $PSTMINITTIME command or, if also the approximate position is available, both current time and position can be injected by using the $PSTMINITGPS command. 2. Then the ephemerides can be injected into the device by using the $PSTMEPHEM command for each satellite (between two consecutive commands there must be at least a 20-millisecond delay). 3. After injecting ephemerides, the almanacs can be injected into the device by the $PSTMALMANAC command for each satellite (between two consecutive commands there must be at least a 20-millisecond delay). 4. Now the device is capable of achieving the fix very quickly, if enough satellites are in view. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 11 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 3.2. NMEA Commands for RT-AGNSS Table 2: NMEA Commands List for RT-AGNSS Command $PSTMINITGPS $PSTMINITTIME $PSTMEPHEM $PSTMALMANAC Description Initialize GPS position and time. Initialize GPS time. Set ephemeris data. Set almanac data. NOTE The string * is optional when inputting commands. 3.2.1. $PSTMINITGPS Initialize position and GPS time using UTC format. This command must be issued after a cold reset otherwise the execution will fail. The date issued with parameters Day, Month and Year must be after January 2018. Synopsis: $PSTMINITGPS,,,,,,,,,,,* Arguments: Parameter Lat LatRef Lon LonRef Format DDMM.MMM N or S DDDMM.MMM E or W Description Latitude (Degree-Minute.Minute decimals) Latitude direction N = North S = South Longitude (Degree-Minute.Minute decimals) Longitude Direction E = East W = West L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 12 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Alt Day Month Year Hour Minute Second checksum dddd – Decimal, 4 digits D – Decimal, 2 digits MM – Decimal, 2 digits YYYY – Decimal, 4 digits HH – Decimal, 2 digits MM – Decimal, 2 digits SS – Decimal, 2 digits Hexadecimal, 2 digits Altitude in meters (-1500 to 100000) Day of month (01 to 31) Month (01 to 12) Year (2018 to …) Hour (00 to 23) Minute (00 to 59) Second (00 to 59) Checksum of the message bytes between but not including the $ and * characters Results: ⚫ If no error occurs, the GNSS receiver’s position and time will be initialized and the following message will be returned: $PSTMINITGPSOK* ⚫ In case of errors, the following message is returned: $PSTMINITGPSERROR* Example: $PSTMINITGPS,4811.365,N,01164.123,E,0530,23,02,2018,09,44,12 NOTES 1. The error between input time and real time should be less than 3 seconds. GPS time = UTC time + Leap second. In 2019, Leap second = 18s. 2. The error between input position and real position should be less than 30 kilometers. 3.2.2. $PSTMINITTIME Initialize GPS time using UTC format. The date issued with parameters Day, Month and Year must be after January 2018. Synopsis: $PSTMINITTIME,,,,,,* L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 13 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Arguments: Parameter Day Month Year Hour Minute Second checksum Format DD – Decimal, 2 digits M – Decimal, 2 digits YYYY – Decimal, 4 digits HH – Decimal, 2 digits MM – Decimal, 2 digits SS – Decimal, 2 digits Hexadecimal, 2 digits Description Day of month (01 to 31) Month (01 to 12) Year (2018 to …) Hour (00 to 23) Minute (00 to 59) Second (00 to 59) Checksum of the message bytes between but not including the $ and * characters Results: ⚫ If no error occurs, the time will be initialized and the following message will be returned: $PSTMINITTIMEOK* ⚫ In case of errors, the following message is returned: $PSTMINITTIMEERROR* Example: $PSTMINITTIME,23,02,2018,09,44,12 NOTE The error between inputted GPS time and real GPS time should be less than 3 seconds. GPS time = UTC time + Leap second. In 2019, Leap second = 18s. 3.2.3. $PSTMEPHEM Load ephemeris data. This command allows the user to load the ephemeris data into the backup memory. Synopsis: $PSTMEPHEM,,,* L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 14 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Arguments: Parameter Format sat_id Decimal, up to 3 digits ephem_data_size Decimal, 2 digits ephem_data Hexadecimal checksum Hexadecimal, 2 digits Description Satellite PRN Size expressed in byte of the ephemeris data field. Ephemeris data string Checksum of the message bytes between but not including the $ and * characters The encoding of the ephem_data field is described in the following tables. Table 3: Encoding for GPS Ephemeris Bits Structure Member 16 week 16 toe 16 toc 8 iode1 8 iode2 10 iodec 14 i_dot 8 reserved 24 omega_dot 8 reserved 16 crs 16 crc 16 cus 16 cuc 16 cis 16 cic Description Week number of the Issue of Data. Time of week for ephemeris epoch. Time of week for clock epoch Issue of data 1. Issue of data 2. Issue of data clock. Rate of inclination angle. Rate of right ascension. Must be 0. Amplitude of the sine harmonic correction to the orbit radius. Amplitude of the cosine harmonic correction to the orbit radius. Amplitude of the sine harmonic correction to the argument of latitude. Amplitude of the cosine harmonic correction to the argument of latitude. Amplitude of the sine harmonic correction to the angle of inclination. Amplitude of the cosine harmonic correction to the angle of inclination. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 15 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 16 motion_difference 16 reserved 32 inclination 32 e 32 root_A 32 mean_anomaly 32 omega_zero 32 perigee 8 time_group_delay 8 af2 16 af1 22 af0 1 reserved 1 reserved 1 reserved 1 available 1 health 1 reserved 4 accuracy Mean motion difference from computed value Must be 0. Inclination angle at reference time. Eccentricity. Square root of major axis. Mean anomaly at reference time. Longitude of ascending node of orbit plane at weekly epoch. Argument of perigee. Estimated group delay differential. Second order clock correction. First order clock correction. Constant clock correction. Reserved for use by GNSS library – must be 1 Reserved for use by GNSS library – must be 1 Reserved for use by GNSS library – must be 1 Contains 1 if ephemeris is available, 0 if not. Contains 1 if the satellite is unhealthy, 0 if healthy. Must be 0. Accuracy. The GPS encoding above can be represented in C language with the following structure: typedef struct gps_ephemeris_s { unsigned int week : 16 unsigned int toe : 16; unsigned int toc : 16; unsigned int iode1 : 8; unsigned int iode2 : 8; unsigned int iodc : 10; unsigned int i_dot : 14; unsigned int spare1 : 8; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 16 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note unsigned int omega_dot : unsigned int reserved1 : unsigned int reserved2 : unsigned int crs : unsigned int crc : unsigned int cus : unsigned int cuc : unsigned int cis : unsigned int cic : unsigned int motion_difference : unsigned int reserved3 : unsigned int spare3 : unsigned int inclination : unsigned int eccentricity : unsigned int root_a : unsigned int mean_anomaly : unsigned int omega_zero : unsigned int perigee : unsigned int time_group_delay : unsigned int af2 : unsigned int af1 : unsigned int af0 : unsigned int reserved4 : unsigned int reserved5 : unsigned int reserved6 : unsigned int available : unsigned int health : unsigned int reserved7 : unsigned int accuracy : } gps_ephemeris_t; 24; 2; // must be 0 6; // must be 0 16; 16; 16; 16; 16; 16; 16; 10; // must be 0 6; 32; 32; 32; 32; 32; 32; 8; 8; 16; 22; 1; // must be 1 1; // must be 1 1; // must be 1 1; 1; 1; // must be 0 4; Table 4: Encoding for GLONASS Ephemeris Bits Structure Member Description 16 week Week number of the Issue of Data. 16 toe Time of week for ephemeris epoch. 4 toe_lsb 11 NA 7 tb Time of week for ephemeris epoch (LSB). Calendar day number within the four-year period since the beginning of last leap year (almanac). Time of ephemeris index. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 17 / 35 2 M 2 P1 1 P3 1 P2 1 P4 2 KP 1 reserved 27 xn 5 xn_dot_dot 24 xn_dot 5 n 3 Bn 27 yn 5 yn_dot_dot 24 yn_dot 8 age_h 27 zn 5 zn_dot_dot 24 zn_dot 8 reserved 11 gamma_n 5 E_n 4 freq_id 12 reserved 22 tau_n 10 reserved 32 tau_c GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Type of satellite: 00=GLONASS 01=GLONASS-M Time interval between two adjacent tb parameters. Number of satellites for which almanac is transmitted within this frame 0=4 1=5. Flag of oddness ('1') or evenness ('0') of the value of tb Flag to show that ephemeris parameters are present. Notification on forthcoming leap second correction of UTC. / Satellite PZ-90 x coordinate at epoch tb. Satellite PZ-90 x velocity at epoch tb. Satellite PZ-90 x acceleration component at epoch tb. Slot number (1 to 24). Healthy flags. Satellite PZ-90 y coordinate at epoch tb. Satellite PZ-90 y acceleration component at epoch tb. Satellite PZ-90 y velocity at epoch tb. Age of predicted ephemeris (Unit: hours). Satellite PZ-90 z coordinate at epoch tb. Satellite PZ-90 z acceleration component at epoch tb. Satellite PZ-90 z velocity at epoch tb. Must be 0. Satellite clock frequency drift at epoch tb. Age of the ephemeris information. Frequency ID / Satellite clock correction at epoch tb. Must be 0. GLONASS to UTC(SU) time correction. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 18 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 22 tau_GPS 10 reserved 11 NT 5 N4 12 tk 4 FT 32 reserved 5 m_available 1 nvm_reliable 26 spare 25 reserved 1 available 1 health 1 reserved 4 reserved GLONASS to GPS system time correction. / Calendar day number of ephemeris within the four-year period since the beginning of last leap year. Four-year interval number starting from 1996. Satellite time referenced to the beginning of the frame. Predicted satellite user range accuracy at time tb / Must be 0x1F. Must be 1. / / Contains 1 if ephemeris is available, 0 if not. Contains 1 if the satellite is unhealthy, 0 if healthy. Must be 0. / The GLONASS encoding above can be represented in C language with the following structure: typedef struct glonass_ephemris_s { unsigned int week : 16; unsigned int toe : 16; unsigned int toe_lsb : 4; unsigned int NA : 11; unsigned int tb : 7; unsigned int M : 2; unsigned int P1 : 2; unsigned int P3 : 1; unsigned int P2 : 1; unsigned int P4 : 1; unsigned int KP : 2; unsigned int spare0 : 1; unsigned int xn : 27; unsigned int xn_dot_dot : 5; unsigned int xn_dot : 24; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 19 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note unsigned int n : unsigned int Bn : unsigned int yn : unsigned int yn_dot_dot : unsigned int yn_dot : unsigned int spare4 : unsigned int zn : unsigned int zn_dot_dot : unsigned int zn_dot : unsigned int reserved1 : unsigned int reserved2 : unsigned int gamma_n : unsigned int E_n : unsigned int freq_id : unsigned int spare3 : unsigned int tau_n : unsigned int reserved3 : unsigned int tau_c : unsigned int tau_GPS : unsigned int spare5 : unsigned int NT : unsigned int N4 : unsigned int tk : unsigned int FT : unsigned int spare7 : unsigned int m_available : unsigned int nvm_reliable : unsigned int spare8 : unsigned int spare9 : unsigned int available : unsigned int health : unsigned int reserved4 : unsigned int spare10 : } glonass_ephemeris_t; 5; 3; 27; 5; 24; 8; 27; 5; 24; 2; // must be 0 6; // must be 0 11; 5; 4; 12; 22; 10; // must be 0 32; 22; 10; 11; 5; 12; 4; 32; 5; 1; 26; 25; 1; 1; 1; // must be 0 4; Table 5: Encoding for Galileo Ephemeris Bits Structure Member Description 16 week Week number of the Issue of Data. 14 toe Time of week for ephemeris epoch. 2 reserved / L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 20 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 16 toc Time of week for clock epoch. 10 iod_nav Issue of data. 8 SISA Signal In Space Accuracy. 10 reserved Must be 0. 10 BGD_E1_E5a E1-E5a Broadcast Group Delay. 10 BGD_E1_E5b E1-E5b Broadcast Group Delay. 2 E1BHS E1-B Signal Health Status. 32 inclination Inclination angle at reference time 32 eccentricity Eccentricity. 32 root_a Square root of major axis. 32 mean_anomaly Mean anomaly at reference time. 32 omega_zero Longitude of ascending node of orbit plane at weekly epoch. 32 perigee Argument of perigee. 14 i_dot Rate of inclination angle. 1 available Contains 1 if ephemeris is available, 0 if not. 1 health Contains 1 if the satellite is unhealthy, 0 if healthy. 16 motion_difference Mean motion difference from computed value. 16 crs Amplitude of the sine harmonic correction to the orbit radius. 16 crc Amplitude of the cosine harmonic correction to the orbit radius. 16 cus Amplitude of the sine harmonic correction to the argument of latitude. 16 cuc Amplitude of the cosine harmonic correction to the argument of latitude. 16 cis Amplitude of the sine harmonic correction to the angle of inclination. 16 cic Amplitude of the cosine harmonic correction to the angle of inclination. 24 omega_dot Rate of right ascension. 6 SVID Satellite Identification. 1 E1BDVS E1-B Data Validity Status. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 21 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 1 reserved 8 reserved 16 reserved 6 af2 21 af1 5 word_available 31 af0 1 reserved 6 reserved 26 reserved 1 reserved Must be 0. Must be 0. Must be 0. Second order clock correction. First order clock correction. Must be 0x1F. Constant clock correction. / Must be 0. Reserved for use by GNSS library – must be 1. Must be 0. The Galileo encoding above can be represented in C language with the following structure: typedef struct galileo_ephemeris_s { unsigned int week : unsigned int toe : unsigned int reserved1 : unsigned int toc : unsigned int iod_nav : unsigned int SISA : unsigned int reserved2 : unsigned int BGD_E1_E5a : unsigned int BGD_E1_E5b : unsigned int E1BHS : unsigned int inclination : unsigned int eccentricity : unsigned int root_a : unsigned int mean_anomaly : unsigned int omega_zero : unsigned int perigee : unsigned int i_dot : unsigned int available : unsigned int health : unsigned int motion_difference : unsigned int crs : 16; 14; 2; // must be 0 14; 10; 8; 10; // must be 0 10; 10; 2; 32; 32; 32; 32; 32; 32; 14; 1; 1; 16; 16; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 22 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note unsigned int crc : unsigned int cus : unsigned int cuc : unsigned int cis : unsigned int cic : unsigned int omega_dot : unsigned int SVID : unsigned int E1BDVS : unsigned int reserved3 : unsigned int af2 : unsigned int af1 : unsigned int word_available : unsigned int af0 : unsigned int spare0 : unsigned int reserved4 : unsigned int spare1 : } galileo_ephemeris_t; 16; 16; 16; 16; 16; 24; 6; 1; 1; // must be 0 6; 21; 5; 31; 1; 6; // must be 0 26; Table 6: Encoding for BeiDou Ephemeris Bits Structure Member 32 inclination 32 eccentricity 32 root_a 32 mean_anomaly 32 omega_zero 32 perigee 17 toe 10 time_group_delay 5 aode 24 omega_dot 8 A0 24 af0 8 A1 Description Inclination angle at reference time. Eccentricity. Square root of major axis. Mean anomaly at reference time. Longitude of ascending node of orbit plane at weekly epoch. Argument of perigee. Time of week for ephemeris epoch. Estimated group delay differential. Issue of data, ephemeris. Rate of right ascension. Ionospheric Delay Model Parameter α0 Constant clock correction. Ionospheric Delay Model Parameter α1 L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 23 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 20 sow 11 af2 1 is_geo 22 af1 10 subframe_avail 16 motion_difference 8 A2 8 A3 18 crs 8 B2 4 urai 2 reserved 18 crc 8 B3 5 aodc 1 spare 18 cus 14 i_dot 18 cuc 8 B0 6 spare 18 cis 8 B1 6 reserved 18 cic 1 nvm_reliable Seconds of week Second order clock correction. 1 for Geostationary satellites, otherwise 0 First order clock correction. Must be 0x3FF. Mean motion difference from computed value. Ionospheric Delay Model Parameter α2 Ionospheric Delay Model Parameter α3 Amplitude of the sine harmonic correction to the orbit radius. Ionospheric Delay Model Parameter β2. User range accuracy index. Must be 0. Amplitude of the cosine harmonic correction to the orbit radius. Ionospheric Delay Model Parameter β3 Issue of data, clock / Amplitude of the sine harmonic correction to the argument of latitude. Rate of inclination angle. Amplitude of the cosine harmonic correction to the argument of latitude. Ionospheric Delay Model Parameter β0. / Amplitude of the sine harmonic correction to the angle of inclination. Ionospheric Delay Model Parameter β1 Must be 0. Amplitude of the cosine harmonic correction to the angle of inclination. Must be 1. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 24 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 11 reserved 2 spare 17 toc 13 week 1 available 1 health Must be 0. / Time of week for clock epoch Week number of the Issue of Data Contains 1 if ephemeris is available, 0 if not. Contains 1 if the satellite is unhealthy, 0 if healthy. The BeiDou encoding above can be represented in C language with the following structure: typedef struct beidou_ephemeris_s { unsigned int inclination : 32; unsigned int eccentricity : 32; unsigned int root_a : 32; unsigned int mean_anomaly : 32; unsigned int omega_zero : 32; unsigned int perigee : 32; unsigned int toe : 17; unsigned int time_group_delay : 10; unsigned int aode : 5; unsigned int omega_dot : 24; unsigned int A0 : 8; unsigned int af0 : 24; unsigned int A1 : 8; unsigned int sow : 20; unsigned int af2 : 11; unsigned int is_geo : 1; unsigned int af1 : 22; unsigned int subframe_avail : 10; unsigned int motion_difference : 16; unsigned int A2 : 8; unsigned int A3 : 8; unsigned int crs : 18; unsigned int B2 : 8; unsigned int urai : 4; unsigned int reserved1 : 2; unsigned int crc : 18; unsigned int B3 : 8; unsigned int aodc : 5; unsigned int spare0 : 1; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 25 / 35 unsigned int cus : unsigned int i_dot : unsigned int cuc : unsigned int B0 : unsigned int spare1 : unsigned int cis : unsigned int B1 : unsigned int reserved2 : unsigned int cic : unsigned int nvm_reliable : unsigned int reserved3 : unsigned int reserved4 : unsigned int spare4 : unsigned int toc : unsigned int week : unsigned int available : unsigned int health : } beidou_ephemeris_t; GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 18; 14; 18; 8; 6; 18; 8; 6; 18; 1; 1; 10; 2; 17; 13; 1; 1; NOTES 1. A little-endian architecture has been assumed. For example, in the case of GPS PRN #1 ephemeris where week number is 1831 (= 0x0727) and toe is 15750 (= 0x3D86), the NMEA command string will begin with $PSTMEPHEM,1,64,2707863d…. 2. For the scale of data in the table for each constellation, please refer to respective ICDs. 3. The $PSTMDUMPEPHEMS command can be used to verify if an ephemeris, which has been injected using the $PSTMEPHEM command, has been correctly sent. Results: ⚫ The ephemeris data string is decoded and stored into the backup memory. ⚫ If more than one ephemeris is uploaded for each satellite, the oldest ephemeris will be overwritten. ⚫ No message will be sent as reply. ⚫ If more than one $PSTMEPHEM command needs to be issued between two consecutive commands, there must be at least a 20-millisecond delay. C Language Sample Code: The following example shows how to use the above structures. The example below is given for GPS ephemeris, but it also applies to GLOANSS, Galileo and BeiDou with very few changes. void convert_gps_eph(int sat_id, gps_ephemeris_t *ephem_ptr, char nmea_output[512]) { unsigned char* eph_ptr = (unsigned char*)(ephem_ptr); int index, index2; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 26 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note index = sprintf((char *)nmea_output,'$PSTMEPHEM,%i,%i,', sat_id, sizeof(gps_ephemeris_t)); for (index2 = 0; index2 < sizeof(gps_ephemeris_t); index2++) { index += sprintf((char *)(nmea_output + index),'x',eph_ptr[index2]); } } NOTE The $PSTMDUMPEPHEMS command can be used to verify if an ephemeris, which has been injected using the $PSTMEPHEM command, has been correctly sent. 3.2.4. $PSTMALMANAC Load almanacs data. This command allows the user to load the almanacs data into the backup memory. Synopsis: $PSTMALMANAC,,,,…..,* Arguments: Parameter sat_id N byte1 byteN checksum Format Decimal, 2 digits Decimal, 1 digit Hexadecimal, 2 digits Hexadecimal, 2 digits Hexadecimal, 2 digits Description Satellite number Number of the almanac data bytes First byte of the almanac data Last byte of the almanac data Checksum of the message bytes between but not including the $ and * characters The N Bytes that are in the parameters are the dump of a structure that contains all the information of the almanac. Data formats are constellation-dependent, which are listed in the following tables. Table 7: Encoding for GPS Almanac Bits Structure Member 8 satid 16 week Description The satellite number. The week number for the epoch L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 27 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 8 toa 16 e 16 delta_i 16 omega_dot 24 root_A 24 omega_zero 24 perigee 24 mean_anomaly 11 af0 11 af1 1 health 1 available Reference time almanac. Eccentricity. Rate of inclination angle. Rate of right ascension. Square root of semi-major axis. Longitude of ascending node of orbit plane at weekly epoch. Argument of perigee. Mean anomaly at reference time. Constant clock correction. First order clock correction. Contains 1 if the satellite is unhealthy 0 if healthy. Contains 1 if almanac is available 0 if not. The GPS encoding above can be represented in C language with the following structure: typedef struct gps_almanac_s { unsigned int satid : 8; unsigned int week : 16; unsigned int toa : 8; unsigned int eccentricity : 16; unsigned int delta_i : 16; unsigned int omega_dot : 16; unsigned int root_a : 24; unsigned int omega_zero : 24; unsigned int perigee : 24; unsigned int mean_anomaly : 24; unsigned int af0 : 11; unsigned int af1 : 11; unsigned int health : 1; unsigned int available : 1; unsigned int spare0 : 32; unsigned int spare1 : 32; } gps_almanac_t; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 28 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Table 8: Encoding for GLONASS Almanac Bits Structure Member 8 satid 16 week 8 toa 5 n_A 5 H_n_A 2 M_n_A 10 tau_n_A 15 epsilon_n_A 21 t_lambda_n_A 21 lambda_n_A 18 delta_i_n_A 7 delta_T_n_dot_A 22 delta_T_n_A 16 omega_n_A 1 health 1 available 32 Tau_c 11 NA 5 N4 16 Spare Description The satellite number. The week number for the epoch Reference time almanac. Slot number (1 to 24). Carrier frequency channel number. Type of satellite 00=GLONASS 01=GLONASS-M. Satellite clock correction. Eccentricity. Time of the first ascending node passage. Longitude of ascending node of orbit plane at almanac epoch. Inclination angle correction to nominal value. Draconian period rate of change. Draconian period correction. Argument of perigee. Contains 1 if the satellite is unhealthy 0 if healthy. Contains 1 if almanac is available 0 if not. / / / / The GLONASS encoding above can be represented in C language with the following structure: typedef struct glonass_almanac_s { unsigned int satid : 8; unsigned int week : 16; unsigned int toa : 20; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 29 / 35 unsigned int n_A : 5; unsigned int H_n_A : 5; unsigned int M_n_A : 2; unsigned int tau_n_A : 10; unsigned int epsilon_n_A : 15; unsigned int t_lambda_n_A : 21; unsigned int lambda_n_A : 21; unsigned int delta_i_n_A : 18; unsigned int delta_T_n_dot_A : 7; unsigned int delta_T_n_A : 22; unsigned int omega_n_A : 16; unsigned int health : 1; unsigned int available : 1; unsigned int tau_c : 32; unsigned int NA : 11; unsigned int N4 : 5; unsigned int spare0 : 16; } glonass_almanac_t; GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Table 9: Encoding for Galileo Almanac Bits Structure Member 16 satid 6 svid 16 week 20 toa 13 delta_a 11 e 16 perigee 11 delta_i 16 omega_zero 11 omega_dot 16 mean_anomaly 16 af0 Description The satellite number. Space Vehicle Identification. The week number for the epoch Reference time almanac. Delta of semi-major axis. Eccentricity. Argument of perigee. Rate of inclination angle. Longitude of ascending node of orbit plane at weekly epoch. Rate of right ascension. Mean anomaly at reference time. Constant clock correction. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 30 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 13 af1 2 E5b_HS 2 E1B_HS 4 ioda_1 4 ioda_2 1 health 2 reserved 1 health 1 available First order clock correction. E5 Signal Health Status E1-B Signal Health Status Issue of data Almanac 1 Issue of data Almanac 2 Contains 1 if the satellite is unhealthy 0 if healthy. Reserved for use by GNSS library. Contains 1 if the satellite is unhealthy, 0 if healthy Contains 1 if almanac is available 0 if not. The Galileo encoding above can be represented in C language with the following structure: typedef struct galileo_almanac_s { unsigned int satid : 16; unsigned int svid : 6; unsigned int week : 16; unsigned int toa : 20; unsigned int delta_a : 13; unsigned int eccentricity : 11; unsigned int perigee : 16; unsigned int delta_i : 11; unsigned int omega_zero : 16; unsigned int omega_dot : 11; unsigned int mean_anomaly : 16; unsigned int af0 : 16; unsigned int af1 : 13; unsigned int E5b_HS : 2; unsigned int E1B_HS : 2; unsigned int ioda_1 : 4; unsigned int ioda_2 : 4; unsigned int word_available : 2; unsigned int health : 1; unsigned int available : 1; unsigned int spare0 : 2; unsigned int spare1 : 32; unsigned int spare2 : 32; } galileo_almanac_t; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 31 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note Table 10: Encoding for BeiDou Almanac Bits Structure Member 8 satid 16 week 8 toa 17 eccentricity 11 af0 1 is_geo 3 spare0 17 omega_dot 11 af1 4 spare1 24 root_a 24 omega_zero 24 perigee 24 mean_anomaly 16 delta_i 1 health 1 available 14 spare2 Description The satellite number. The week number for the epoch. Reference time almanac. Eccentricity. Constant clock correction. Contains 1 if it is a geostationary satellite. Spare. Rate of right ascension. First order clock correction. Spare. Square root of semi-major axis. Longitude of ascending node of orbit plane at weekly epoch. Argument of perigee. Mean anomaly at reference time. Rate of inclination angle. Contains 1 if the satellite is unhealthy 0 if healthy. Contains 1 if almanac is available 0 if not. Spare. The BeiDou encoding above can be represented in C language with the following structure: typedef struct compass_almanac_s { unsigned int satid : 8; unsigned int week : 16; unsigned int toa : 8; unsigned int eccentricity : 17; unsigned int af0 : 11; unsigned int is_geo : 1; L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 32 / 35 unsigned int spare0 : 3; unsigned int omega_dot : 17; unsigned int af1 : 11; unsigned int spare1 : 4; unsigned int root_a : 24; unsigned int omega_zero : 24; unsigned int perigee : 24; unsigned int mean_anomaly : 24; unsigned int delta_i : 16; unsigned int health : 1; unsigned int available : 1; unsigned int spare2 : 14; } compass_almanac_t; GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note NOTES 1. A little-endian architecture has been assumed. 2. For the scale of data in the table for each constellation, please refer to respective ICDs. 3. The $PSTMDUMPALMANAC command can be used to verify if an almanac, which has been injected using the $PSTMALMANAC command, has been correctly sent. Results: ⚫ The almanac will be stored into backup memory. ⚫ No message will be sent as reply. Example: $PSTMALMANAC,12,32,0c1a06907c1a971160fd0800fa0da141ae9f0600d912e90075669700490f8000 *75 3.3. Real-Time AGNSS Testing Procedure The main feature introduced by a GNSS device with Real-Time AGNSS capability is the ephemeris availability (and also GNSS fix availability) as soon as the device downloads the assistance data from the network, even if the device is used in critical environments where the ephemeris downloading from the sky is difficult (e.g. urban canyon, low signal strengths, etc.). The procedures for both COLD and WARM start tests are reported in this section. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 33 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 3.3.1. Simple COLD Start Test By the standard NMEA command $PSTMCOLD, the device is restarted in COLD start conditions, then the assistance data will be downloaded from the real time server and sent to the device. The procedure is described below: ⚫ Assistance data are downloaded from the server. ⚫ The current time is injected into the device by the $PSTMINITTIME command. ⚫ In the case that the approximate position is also available, both current time and the position can be injected into the device by the $PSTMINITGPS command instead. ⚫ Then, the ephemeris data (downloaded from the real time server) are injected into the device by using $PSTMEPHEM command for each satellite. ⚫ Then, the almanacs data (downloaded from the real time server) are injected into the device by using $PSTMALMANAC command for each satellite. Now the time to first fix (TTFF) and the position accuracy are evaluated - the first fix should be achieved shortly after the injection of the ephemeris data. This test can be performed several times in order to get a good statistical result. 3.3.2. Simple WARM Start Test By the standard NMEA command $PSTMWARM, the device is restarted in WARM start conditions, then ephemeris data will be downloaded from the real time server and injected into the device by using the $PSTMEPHEM command (in the WARM start condition, the device is supposed to have already downloaded the time and the almanacs from the sky). Now the TTFF and the position accuracy are evaluated - the first fix should be achieved shortly after the injection of the ephemeris data. This test can be performed several times in order to have a good statistical result. L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 34 / 35 GNSS Module Series L89&L26-DR&L26-P&L26-T AGNSS Application Note 4 Appendix A References Table 11: Related Documents SN Document Name [1] Quectel_L26-DR_GNSS_Protocol_Specification [2] Quectel_L26-T&L26-P_GNSS_Protocol_Specification [3] Quectel_L89_GNSS_Protocol_Specification Remark L26-DR GNSS protocol specification GNSS protocol specification of L26-T and L26-P modules L89 GNSS Protocol Specification Table 12: Terms and Abbreviations Abbreviation AGNSS GNSS GPS ICD LSB NMEA PRN TTFF UTC Description Assisted GNSS Global Navigation Satellite System. Global Positioning System Interface Control Document Least Significant Bit National Marine Electronics Association Pseudorandom Noise Time To First Fix Universal Time Coordinated L89&L26-DR&L26-P&L26-T_AGNSS_Application_Note 35 / 35

RGx00U&RM500U 系列 FTP(S)应用指导 5G 模块系列 版本：1.0 日期：2023-07-31 状态：受控文件 RGx00U&RM500U 系列 FTP(S)应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 文档历史 修订记录 版本 1.0 日期 作者 2023-06-07 Wayen XU 2023-07-31 Wayen XU 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 FTP(S)命令使用流程............................................................................................................................. 7 3 AT 命令详解 .......................................................................................................................................... 8 3.1. AT 命令说明 ............................................................................................................................... 8 3.1.1. 定义 ................................................................................................................................. 8 3.1.2. AT 命令语句 .................................................................................................................... 8 3.2. AT 示例声明 ............................................................................................................................... 9 3.3. AT+QFTPCFG 配置 FTP(S)服务器参数 ................................................................................. 9 3.4. AT+QFTPOPEN 登录 FTP(S)服务器 .................................................................................... 10 3.5. AT+QFTPGET 从 FTP(S)服务器下载文件 ............................................................................ 11 3.6. AT+QFTPCLOSE 退出 FTP(S)服务器 .................................................................................. 12 4 举例 ..................................................................................................................................................... 13 5 附录 参考文档及术语缩写 .................................................................................................................. 14 上海移远通信技术股份有限公司 4 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 表格索引 表 1：AT 命令类型 ....................................................................................................................................... 8 表 2：参考文档 ........................................................................................................................................... 14 表 3：术语缩写 ........................................................................................................................................... 14 上海移远通信技术股份有限公司 5 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 1 引言 移远通信移远通信 5G RG200U 系列、RG500U 系列和 RM500U 系列模块支持 FTP 和 FTPS 文件传 输协议（下文简称'FTP(S)'）。 FTP（File Transfer Protocol，文件传输协议）是一种标准的网络协议，用于在计算机网络上的客户端 和服务器之间传输计算机文件，具有很高的传输速率。 FTPS（FTP over SSL 或 FTP Secure）是一种对常用的文件传输协议（FTP）添加传输层安全（TLS） 和安全套接层（SSL）加密协议支持的扩展协议。 本文档主要介绍如何通过 AT 命令应用移远通信 5G RG200U 系列、RG500U 系列和 RM500U 系列模 块的 FTP(S)功能。 上海移远通信技术股份有限公司 6 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 2 FTP(S)命令使用流程 RG200U 系列、RG500U 系列和 RM500U 系列模块支持 FTP(S)协议，因此 FTP(S)服务器上的文件可 以通过 FTP(S)相关 AT 命令进行操作。FTP(S)相关 AT 命令使用流程如下： 第一步：配置和激活 PDP 上下文。 1. 使用 AT+QICSGP 配置 PDP 上下文的、、和其他参数。有关 AT 命令的详细信息，请参考文档 [1]。 2. 通过 AT+QIACT 激活 PDP 上下文。有关 AT 命令的详细信息，请参考文档 [1]。 第二步：配置 FTP(S)服务器参数，包括用户账号和文件类型。 1. 通过 AT+QFTPCFG='account',,配置账号信息。 2. 通过 AT+QFTPCFG='filetype',配置文件类型。在 FTP(S)服务器和客户端间传输的 文件类型可以是二进制数据或 ASCII 数据。 第三步：登录 FTP(S)服务器。 通 过 AT+QFTPOPEN=, 登 录 FTP(S) 服 务 器 ， 命 令 执 行 后 ， 若 响 应 URC +QFTPOPEN: 0,0，表示操作成功。注意 FTPS 和 FTP 的端口不同。FTPS 服务器的端口取决 于 FTPS 服务器提供商，通常为 990；FTP 服务器端口默认值通常为 21。 第四步：文件下载。 通过 AT+QFTPGET 从 FTP(S)服务器下载文件。文件数据内容将在 COM 口输出。 第五步：关闭和 FTP(S)服务器的连接。 通过 AT+QFTPCLOSE 关闭和 FTP(S)服务器的连接。 第六步：去激活 PDP 上下文。 通过 AT+QIDEACT=去激活 PDP 上下文。有关 AT 命令的详细信息，请参考文档 [1]。 备注 登录 FTP(S)服务器后，如果长时间没有进行文件下载操作，服务器会断开连接，此时再进行文件下载操 作会报错。可以先通过 AT+QFTPCLOSE 退出 FTP(S)服务器，再通过 AT+QFTPOPEN 登录 FTP(S)服 务器，进行文件下载操作。 上海移远通信技术股份有限公司 7 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 3 AT 命令详解 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT+QFTPCFG 配置 FTP(S)服务器参数 该命令用于配置FTP(S)服务器参数，包括用户账号和文件类型。 AT+QFTPCFG 配置 FTP(S)服务器参数 测试命令 AT+QFTPCFG=? 响应 +QFTPCFG: 'account',, +QFTPCFG: 'filetype',(支持的列表) 设置命令 AT+QFTPCFG='account'[,,] OK 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'account',, OK 若指定可选参数，则设置用户账号： OK 设置命令 AT+QFTPCFG='filetype'[,] 若有任何错误： +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'filetype', OK 若指定可选参数，则设置文件类型： OK 最大响应时间 若有任何错误： +CME ERROR: 300毫秒 上海移远通信技术股份有限公司 9 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型。鉴权用户名。最大长度：255；单位：字节。 字符串类型。鉴权密码。最大长度：255；单位：字节。 整型。文件类型。 0 二进制 1 ASCII 整型。错误码。详见文档 [2]。 3.4. AT+QFTPOPEN 登录 FTP(S)服务器 该命令用于登录 FTP(S)服务器。执行该命令前，需先通过 AT+QIACT 激活 PDP 上下文。 AT+QFTPOPEN 登录 FTP(S)服务器 测试命令 AT+QFTPOPEN=? 响应 +QFTPOPEN: ,(支持的范围) 设置命令 AT+QFTPOPEN=[,] OK 响应 OK 最大响应时间 特性说明 若有任何问题： +CME ERROR: 125 秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器 IP 地址或域名。最大长度：200；单位：字节。 整型。FTP(S)服务器端口。默认值：21。范围：1~65535。 整型。错误码。详见文档 [2]。 上海移远通信技术股份有限公司 10 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 备注 FTPS 和 FTP 服务器端口不同，FTPS 服务器的端口取决于 FTPS 服务器提供商，通常为 990； FTP 服务器端口默认值通常为 21。 举例 AT+QFTPOPEN='101.95.183.122',21 OK AT+QFTPOPEN='quectel.3322.org',990 OK //登录 FTP 服务器。 //登录 FTPS 服务器。 3.5. AT+QFTPGET 从 FTP(S)服务器下载文件 该命令用于从 FTP(S)服务器下载文件。通过设置 AT+QFTPGET='filename','COM:'，文件数据可从 COM 口输出。 AT+QFTPGET 从 FTP(S)服务器下载文件 测试命令 AT+QFTPGET=? 响应 +QFTPGET: ,,, 设置命令 AT+QFTPGET=,[,[,]] OK 响应 CONNECT OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器文件名称。最大长度：255；单位：字节。 字符串类型。本地文件名称。最大长度：60；单位：字节。该参数取值只能是'COM:'， 当参数取值为'COM:'时，将在 COM 口输出数据。 上海移远通信技术股份有限公司 11 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 整型。要下载的文件的起始位置。默认值：0；单位：字节。 整型。下载的数据长度。若指定该参数，模块将输出字节至 COM 口。 如果还有数据未下载，可以再次执行 AT+QFTPGET，从剩余数据的处开 始下载数据。单位：字节。 整型。错误码。详见文档 [2]。 备注 1. 和暂时无效。 2. 若省略和，将从 FTP(S)服务器下载整个文件。 3.6. AT+QFTPCLOSE 退出 FTP(S)服务器 该命令用于退出 FTP(S)服务器。 AT+QFTPCLOSE 退出 FTP(S)服务器 测试命令 AT+QFTPCLOSE=? 执行命令 AT+QFTPCLOSE 响应 OK 响应 OK 最大响应时间 特性说明 若有任何问题： +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 参数 整型。错误码。详见文档 [2]。 上海移远通信技术股份有限公司 12 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 4 举例 //第一步：配置和激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',0 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //设置 PDP 上下文为 1，中国联通 APN 为'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK //第二步：配置用户账号和文件类型。 AT+QFTPCFG='account','test','test' OK AT+QFTPCFG='filetype',1 OK //第三步：登录FTP服务器。 AT+QFTPOPEN='quectel.3322.org',21 OK //第四步：文件下载 AT+QFTPGET='RUOXINHAO.txt','COM:' CONNECT OK //设置用户名和密码。 //设置文件类型为ASCII。 //从 FTP 服务器上面下载 RUOXINHAO.txt 并从 COM 输 出文件数据。 //第五步：关闭 FTP 服务器的连接 AT+QFTPCLOSE OK //第六步：去激活 PDP 上下文 AT+QIDEACT=1 OK //退出 FTP(S)服务器 //去激活 PDP 上下文 1 上海移远通信技术股份有限公司 13 / 14 RGx00U&RM500U 系列 FTP(S)应用指导 5 附录 参考文档及术语缩写 表 2：参考文档 文档名称 [1] Quectel_RGx00U&RM500U 系列_TCP(IP)_应用指导 [2] Quectel_RGx00U&RM500U 系列_AT 命令手册 表 3：术语缩写 缩写 APN ASCII FTP FTPS ID IP PDP 英文全称 中文全称 Access Point Name 接入点名称 American Standard Code for Information Interchange 美国信息交换标准代码 File Transfer Protocol FTP-SSL: FTP over SSL / FTP Secure Mostly refers to Identifier in terms of software 文件传输协议 对常用的文件传输协议（FTP） 添加传输层安全（TLS）和安全 套接层（SSL）加密协议支持的 扩展协议 软件中多数指'标识符' Internet Protocol 互联网协议 Packet Data Protocol 分组数据协议 上海移远通信技术股份有限公司 14 / 14

EC25-AF 安全功能应用指导 LTE Standard 模块系列 版本：1.0 日期：2024-02-06 状态：受控版本 EC25-AF 安全功能应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 20 EC25-AF 安全功能应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 20 EC25-AF 安全功能应用指导 文档历史 修订记录 版本 1.0 日期 2024-02-02 2024-02-06 作者 Shaun DUAN Jayde TONG Shaun DUAN Jayde TONG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 20 EC25-AF 安全功能应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 安全功能概述......................................................................................................................................... 7 2.1. 安全启动 ..................................................................................................................................... 7 2.2. 安全调试 ..................................................................................................................................... 7 3 AT 命令详解 .......................................................................................................................................... 9 3.1. 定义 ............................................................................................................................................ 9 3.2. AT 命令语句 ............................................................................................................................... 9 3.3. AT 示例声明 ............................................................................................................................. 10 3.4. AT+QSECCFG 配置安全功能 ............................................................................................... 10 3.4.1. AT+QSECCFG='dbg_pwd' 配置安全密码和授权安全调试功能 ................................ 10 3.4.2. AT+QSECCFG='dm_log_ctl' 配置或查询 DM Log 输出状态 .................................... 11 3.4.3. AT+QSECCFG='dump_ctl' 配置或查询 Dump Log 输出状态 ................................... 12 3.4.4. AT+QSECCFG='adb_auth' ADB 授权....................................................................... 13 3.4.5. AT+QSECCFG='secboot' 查询安全启动信息 ........................................................... 14 4 示例 ..................................................................................................................................................... 15 4.1. 启用安全调试功能 .................................................................................................................... 15 4.2. 禁用安全调试功能 .................................................................................................................... 17 5 常见问题解答....................................................................................................................................... 19 6 附录 参考文档和术语缩写 .................................................................................................................. 20 上海移远通信技术股份有限公司 4 / 20 EC25-AF 安全功能应用指导 表格索引 表 1：AT 命令类型 ....................................................................................................................................... 9 表 2：参考文档 ........................................................................................................................................... 20 表 3：术语缩写 ........................................................................................................................................... 20 上海移远通信技术股份有限公司 5 / 20 EC25-AF 安全功能应用指导 1 引言 随着全球物联网行业安全形势日益严峻，移远通信长期以来始终聚焦终端产品视角，不断探索行业最 优方案，并精心打造了一系列安全机制和安全功能，旨在确保模块的安全性和可靠性，并有效降低用户可 能遇到的安全风险或合规风险。 本文档介绍了移远通信 EC25-AF 模块的安全功能，包括安全启动、安全调试以及相关 AT 命令的使用 方法。 上海移远通信技术股份有限公司 6 / 20 EC25-AF 安全功能应用指导 2 安全功能概述 2.1. 安全启动 安全启动（Secure Boot）是建立在可信平台上的启动序列，旨在验证软件程序的真实性和完整性。在 安全启动中，每个加载和执行的软件镜像都必须经过先前验证过的软件程序的验证。具体而言，它用于实 现以下目标： ⚫ 确保仅加载和执行模块中已经鉴权成功的软件镜像； ⚫ 防止任何未经授权或恶意修改的软件程序在模块中运行。 以前，用户只能使用私钥对移远通信的固件进行签名，并在用户终端产线启用安全启动功能。如今， 移远通信提供了替代性方案。该方案默认安全固件由移远通信的私钥签名，用户可以根据采购编码选择在 移远通信产线启用模块的安全启动功能。用户可通过 AT 命令验证是否已启用安全启动功能，详情请参考第 3.4.5 章。 若使用标准解决方案，建议在移远通信产线启用安全启动功能，以提高模块的安全性能。若使用 QuecOpen 方案，用户须使用自己的私钥对移远通信固件和 QuecOpen 应用程序进行签名，并在用户终端 产线启用安全启动功能。 2.2. 安全调试 安全调试（Secure Debugging）指用户必须经过授权，才能控制模块的调试功能。在没有任何限制的 情况下，公开调试功能可能会导致模块或设备的关键信息被泄漏，而安全调试功能可以在模块商业化后有 效减少关键信息泄漏的风险。 安全调试功能包括 DM Log、RAM Dump Log、ADB 调试和 Linux 控制台功能。 ⚫ DM Log 功能默认启用，用户可以使用 QLog 工具抓取 Log。 ⚫ RAM Dump Log 功能默认禁用。启用后，用户可以使用 QLog 工具抓取 Log。 ⚫ ADB 调试功能默认禁用。用户需要鉴权密码来打开 ADB 端口并使用 ADB 命令，鉴权密码为移远 通信提供的动态密码。 ⚫ Linux 控制台的鉴权也需要移远通信提供的动态密码。 上海移远通信技术股份有限公司 7 / 20 EC25-AF 安全功能应用指导 安全调试引入了基于调试功能开关的安全密码鉴权解决方案。用户可以设置、删除或验证安全密码。 如需启用安全调试功能，用户首先需要设置安全密码（移远通信模块默认出厂不带密码）。设置密码 后，必须输入正确的密码以授权启用安全调试功能。随后，可以通过相应的控制命令启用或禁用安全调试 功能。请注意，移远通信安全固件已引入一组新控制命令（详见第 3.4.2、3.4.3 和 3.4.4 章），当启用安全 调试时，之前的控制命令 1)不再生效。 备注 1. 对于 ADB 调试和 Linux 控制台功能，即使用户设置了安全密码，仍需要移远通信提供鉴权密码进行 二次验证。请联系移远通信技术支持获取相关密码。 2. 1) 请联系移远通信技术支持获取之前的控制命令集详细信息。 上海移远通信技术股份有限公司 8 / 20 EC25-AF 安全功能应用指导 3 AT 命令详解 3.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 20 EC25-AF 安全功能应用指导 3.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.4. AT+QSECCFG 配置安全功能 该命令用于配置安全功能或查询当前安全功能配置。 AT+QSECCFG 配置安全功能 测试命令 AT+QSECCFG=? 响应 +QSECCFG: 'dbg_pwd',(支持的范围),, +QSECCFG: 'dm_log_ctl',(支持的列表) +QSECCFG: 'dump_ctl',(支持的列表) +QSECCFG: 'adb_auth', +QSECCFG: 'secboot' 最大响应时间 特性说明 OK 300 毫秒 / 3.4.1. AT+QSECCFG='dbg_pwd' 配置安全密码和授权安全调试功能 该命令用于配置或删除安全密码、授权或取消授权安全调试功能。 AT+QSECCFG='dbg_pwd' 配置安全密码和授权安全调试功能 设置命令 AT+QSECCFG='dbg_pwd'[, ,[,]] 响应 若=0，指定。若与模块当前的安全密码相同， 则删除安全密码（可省略）： OK 若=1，指定和，则创建或更改安全密码： OK 若=2，指定，则输入正确的密码以授权启用安全调试功 能： OK 上海移远通信技术股份有限公司 10 / 20 EC25-AF 安全功能应用指导 最大响应时间 特性说明 若=3，指定，则输入正确的密码以授权禁用安全调试功 能： OK 若省略、和，则查询安全密码配置和安全调试 功能的授权状态： +QSECCFG: 'dbg_pwd',, OK 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。安全调试功能模式选择。 0 删除安全密码 1 设置安全密码 2 授权启用安全调试功能 3 授权禁用安全调试功能 字符串类型。当前安全密码。长度：8 字节。 字符串类型。新安全密码。长度：8 字节。 整型。安全密码配置状态。 0 未配置安全密码 1 已配置安全密码 整型。安全调试功能的授权状态。 0 未授权 1 已授权 3.4.2. AT+QSECCFG='dm_log_ctl' 配置或查询 DM Log 输出状态 该命令用于配置或查询 DM Log 的输出状态。 AT+QSECCFG='dm_log_ctl' 配置或查询 DM Log 输出状态 设置命令 AT+QSECCFG='dm_log_ctl '[,] 响应 若省略可选参数，则查询当前配置： +QSECCFG: 'dm_log_ctl', OK 上海移远通信技术股份有限公司 11 / 20 EC25-AF 安全功能应用指导 最大响应时间 特性说明 若指定可选参数，则配置 DM Log 的输出状态： OK 若有任何错误： ERROR 300 毫秒 该命令重启生效； 参数配置自动保存。 参数 整型。设置 DM Log 的输出状态。 0 禁用 DM Log 输出 1 启用 DM Log 输出 整型。DM Log 的输出状态。 0 DM Log 输出已禁用 1 DM Log 输出已启用 3.4.3. AT+QSECCFG='dump_ctl' 配置或查询 RAM Dump Log 输出状态 该命令用于配置或查询 RAM Dump Log 的输出状态。 AT+QSECCFG='dump_ctl' 配置或查询 RAM Dump Log 输出状态 设置命令 AT+QSECCFG='dump_ctl'[, ] 响应 若省略可选参数，则查询当前配置： +QSECCFG: 'dump_ctl', OK 若指定可选参数，则设置 RAM Dump Log 的输出状态： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 12 / 20 参数 整型。设置 RAM Dump Log 的输出状态。 0 禁用 RAM Dump Log 输出 1 启用 RAM Dump Log 输出 整型。RAM Dump Log 的输出状态。 0 RAM Dump Log 输出已禁用 1 RAM Dump Log 输出已启用 EC25-AF 安全功能应用指导 3.4.4. AT+QSECCFG='adb_auth' ADB 授权 该命令用于 ADB 授权。 AT+QSECCFG='adb_auth' ADB 授权 设置命令 AT+QSECCFG='adb_auth'[, ] 响应 若省略可选参数，则查询加密的密码密文： +QSECCFG: 'adb_auth', OK 若指定可选参数，则将解密的密码明文发送至模块： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。解密后的密码明文。密码为随机数，长度固定为 16 字节。 字符串类型。加密后的密码密文。密码为随机数，长度固定为 344 字节。 上海移远通信技术股份有限公司 13 / 20 EC25-AF 安全功能应用指导 3.4.5. AT+QSECCFG='secboot' 查询安全启动信息 该命令用于查询安全启动的相关信息，包括启用状态、模块序列号和存储的根证书哈希值。 AT+QSECCFG='secboot' 查询安全启动信息 设置命令 响应 AT+QSECCFG='secboot' +QSECCFG: 'status', +QSECCFG: 'serial_num', +QSECCFG: 'root_hash', OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。安全启动状态。 0 禁用 1 启用 十六进制字符串类型。模块序列号。 十六进制字符串类型。存储在模块中的根证书的哈希值。 上海移远通信技术股份有限公司 14 / 20 EC25-AF 安全功能应用指导 4 示例 4.1. 启用安全调试功能 //查询安全密码配置状态和安全调试功能的授权状态。 AT+QSECCFG='dbg_pwd' +QSECCFG: 'dbg_pwd',0,0 OK //创建安全密码。 AT+QSECCFG='dbg_pwd',1,'','1234QUEc' OK //查询安全密码配置状态和安全调试功能的授权状态。 AT+QSECCFG='dbg_pwd' +QSECCFG: 'dbg_pwd',1,0 OK //更新安全密码。 AT+QSECCFG='dbg_pwd',1,'1234QUEc','QUEc1234' OK //授权启用安全调试功能。 AT+QSECCFG='dbg_pwd',2,'QUEc1234' OK //查询安全密码配置状态和安全调试功能的授权状态。 AT+QSECCFG='dbg_pwd' +QSECCFG: 'dbg_pwd',1,1 OK //启用 DM Log 输出。 AT+QSECCFG='dm_log_ctl',1 OK 上海移远通信技术股份有限公司 15 / 20 EC25-AF 安全功能应用指导 //查询 DM Log 输出状态。 AT+QSECCFG='dm_log_ctl' +QSECCFG: 'dm_log_ctl',1 OK //禁用 DM Log 输出。 AT+QSECCFG='dm_log_ctl',0 OK //启用 RAM Dump Log 输出。 AT+QSECCFG='dump_ctl',1 OK //查询 RAM Dump Log 输出状态。 AT+QSECCFG='dump_ctl' +QSECCFG: 'dump_ctl',1 OK //关闭 RAM Dump Log 输出。 AT+QSECCFG='dump_ctl',0 OK //查询加密的密码密文。 AT+QSECCFG='adb_auth' +QSECCFG: 'adb_auth','OhcwQYud+/1inxRvlzErGxV1+HXUH7c0TAxzpl7W5y6RdlV1bLXbxIZtUa cX3S1ugEMQeY1umpD3KtuyycJJrhd7sqvTk6E19/7y33VekYzQ3EnpHavtz+Pd3huK3VeV6dc38OR aSNRYRXrz7T/juHkNYDpZHqv8KyF1wkxHmnsG8sFTC+db4kjJYKoYycutfWXEIZobQOrCFve3cMI mIsNgEgsaU6U7LFfOeVezLEGOSXFVU5wWgMargcje/cBDgyDO2EIr6Oy6cO+283sGYx0+uvuNmP sompvRZ6XoP0TF+Gsty2zErcsCTSSKlpPWE7lEAsHx9efYS0XTxSpZvg==' OK //ADB 授权。 AT+QSECCFG='adb_auth','056c9c994197ee33' OK //查询 VID、PID 和端口设置。 AT+QCFG='usbcfg' +QCFG: 'usbcfg',0x2C7C,0x0125,1,1,1,1,1,0,0 //ADB 端口未打开。 OK 上海移远通信技术股份有限公司 16 / 20 EC25-AF 安全功能应用指导 //打开 ADB 端口。 AT+QCFG='usbcfg',0x2C7C,0x0125,1,1,1,1,1,1,0 OK //查询安全启动相关信息。 AT+QSECCFG='secboot' +QSECCFG: 'status',1 +QSECCFG: 'serial_num','0xda491416' +QSECCFG: 'root_hash','c8fb13a8d3d59e6b463981a0c198bcec9009dda66b2b5b6e036557244fc8 1d1b6c6da3c8f2ed5a155933ba0aca04b35e' OK 备注 1. 有关 AT+QCFG='usbcfg'的详细信息，请参考文档 [1]。 2. 启用安全调试功能后，通过 login: root 接口登录 Linux 控制台。模块将上报如下提示信息。 PiQZaUjUhr+m+Qilsl1txs3toGQz8RN0QXbdI6jQHvUX0VSM5I2bnOoRdxfyWlTpY1DWl4M5G9tiX5qbq tC8EINEgpgTHYJiAfG5Ncd/7PksVlZcMD5RpaAiFY9tTSrWhOC3ANBETCSslCIs4qmJpH/a3eoLN9R8 e8hqoGBql7XMFfKUAYRNBeFe1ebTl2dQ9a+xbFVKe1Tk/f03kNPnh0ztWaH0AB4LVPEZt1r7v3XMfdl pQ+OFZDSbOkLFDIrgpjoHcTOdQcCZFlKbn/4vDM7tSMaqJMTMUQVtGyKAIVHcC82t1ha11xS8EIa5 HcWSTodWMsNQyun61LTRuaBAXw== Password: ~ # ~ # 4.2. 禁用安全调试功能 //查询安全密码配置状态和安全调试功能的授权状态。 AT+QSECCFG='dbg_pwd' +QSECCFG: 'dbg_pwd',0,0 OK //创建安全密码。 AT+QSECCFG='dbg_pwd',1,'','1234QUEc' OK //查询安全密码配置状态和安全调试功能的授权状态。 AT+QSECCFG='dbg_pwd' +QSECCFG: 'dbg_pwd',1,0 上海移远通信技术股份有限公司 17 / 20 EC25-AF 安全功能应用指导 OK //更新安全密码。 AT+QSECCFG='dbg_pwd',1,'1234QUEc','QUEc1234' OK //授权禁用安全调试功能。 AT+QSECCFG='dbg_pwd',3,'QUEc1234' OK //查询安全密码配置状态和安全调试的授权状态。 AT+QSECCFG='dbg_pwd' +QSECCFG: 'dbg_pwd',1,0 OK //启用 DM Log 输出。 AT+QSECCFG='dm_log_ctl',1 ERROR //启用 RAM Dump Log 输出。 AT+QSECCFG='dump_ctl',1 ERROR AT+QSECCFG='adb_auth' ERROR //查询 VID、PID 和端口设置。 AT+QCFG='usbcfg' +QCFG: 'usbcfg',0x2C7C,0x0125,1,1,1,1,1,0,0 //ADB 端口未打开。 OK //打开 ADB 端口。 AT+QCFG='usbcfg',0x2C7C,0x0125,1,1,1,1,1,1,0 ERROR 备注 禁用安全调试功能后，通过 login: root 接口登录 Linux 控制台。模块将上报如下提示信息： ERROR: Authorization failure 上海移远通信技术股份有限公司 18 / 20 EC25-AF 安全功能应用指导 5 常见问题 1. 启用安全启动功能后，还能禁用该功能吗？ 不能。安全启动功能的启用基于硬件 eFuse，因此启用后无法撤销或恢复。 2. 如果镜像验证失败会发生什么？ 模块会进入紧急下载模式。 3. 安全启动功能是否会对镜像进行加密或解密？ 不会，安全启动功能仅验证镜像的完整性和真实性。 4. 安全启动功能是否会增加启动时间？ 验证时间非常短，对启动时间的影响几乎可以忽略不计。 5. 启用安全启动功能后，RAM Dump Log 被禁用。如何启用 RAM Dump Log 功能？ 对于使用移远通信证书的模块，用户需要向移远通信技术支持提供模块的序列号。移远通信技术支持 会提供安全调试策略文件，以帮助用户启用 RAM Dump Log 功能。 上海移远通信技术股份有限公司 19 / 20 EC25-AF 安全功能应用指导 6 附录 参考文档和术语缩写 表 2：参考文档 文档名称 [1] Quectel_EC2x&EG2x&EG9x&EM05_Series_QCFG_AT_Commands_Manual 表 3：术语缩写 缩写 英文全称 ADB Android Debug Bridge DM Diagnostic Monitor IoT Internet of Things PID Product ID RAM VID Random Access Memory Vendor ID 中文全称 安卓调试桥 诊断监控器 物联网 产品 ID 随机存取存储器 供应商 ID 上海移远通信技术股份有限公司 20 / 20

RGx00U&RM500U 系列 5G LAN 拨号应用指导 5G 模块系列 版本：1.0 日期：2024-02-05 状态：受控文件 RGx00U&RM500U 系列 5G LAN 拨号应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 文档历史 修订记录 版本 日期 - 2022-10-14 1.0 2024-02-05 作者 Francis HUAN John ZHAI 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 5G LAN 概述......................................................................................................................................... 8 2.1. 功能场景 ..................................................................................................................................... 8 2.2. 5G LAN 优势 .............................................................................................................................. 9 3 5G LAN 拨号流程................................................................................................................................ 11 3.1. 环境准备 ....................................................................................................................................11 3.2. 配置 Ethernet PDN 会话类型（5G LAN DNN 接入网络）........................................................11 3.3. 拨号 .......................................................................................................................................... 12 3.4. 测试 .......................................................................................................................................... 12 4 示例 ..................................................................................................................................................... 13 4.1. 单路拨号 ................................................................................................................................... 13 4.2. 多路拨号 ................................................................................................................................... 13 5 附录 参考文档及术语缩写 .................................................................................................................. 14 上海移远通信技术股份有限公司 4 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 表格索引 表 1：参考文档 ........................................................................................................................................... 14 表 2：术语缩写 ........................................................................................................................................... 14 上海移远通信技术股份有限公司 5 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 图片索引 图 1：5G LAN 组网架构 ............................................................................................................................... 8 图 2：网络侧组图 ......................................................................................................................................... 9 图 3：未使用 5G LAN 时的组网架构............................................................................................................ 9 图 4：使用 5G LAN 时的组网架构.............................................................................................................. 10 图 5：确认网络环境.....................................................................................................................................11 上海移远通信技术股份有限公司 6 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 1 引言 5G LAN 技术是由 3GPP 标准在 R16 阶段定义的新特性。5G LAN 是基于 5G 终端接入能力和 5G 网络 提供的私有移动 LAN 服务，通过为企业的终端建'群'并绕经业务服务器为群内终端提供终端互通或终端 隔离等灵活的通信服务。LAN 内可以支持基于 IP 或 Ethernet 的点对点、点对多点的通信模式。 本文档主要介绍如何使用 RG200U 系列、RG500U 系列和 RM500U 系列模块进行 5G LAN 拨号。 备注 RG200U 系列、RG500U 系列和 RM500U 系列模块仅部分型号支持 5G LAN 拨号功能，详情请咨询移远 通信技术支持。 上海移远通信技术股份有限公司 7 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 2 5G LAN 概述 2.1. 功能场景 5G LAN 支持二层组网，不同的 UPF 进行 5G LAN 组网后，相互之间可直接进行通信。5G LAN 可实 现如下组网架构： 图 1：5G LAN 组网架构 完成 5G LAN 组网后，可实现如下功能： 1. 同一 UPF 下的两个 UE 可以直接进行二层交互。 2. 不同 UPF 可以通过 N19 直接进行交互。 3. 不处于同一个 5G LAN 用户组的 UE 不能相互通信，如上图 UE31 不可访问其他 5G LAN 用户组。 4. 企业可自主分配 IP，如上图园区 1 所示，企业可自主搭建 DHCP 服务器以分配 IP。 上海移远通信技术股份有限公司 8 / 15 网络侧组网如下： RGx00U&RM500U 系列 5G LAN 拨号应用指导 图 2：网络侧组图 由上图可见，两个不同的 UPF 可以通过 N19 接口连接，处于这两个 UPF 下的 UE 可以进行二层通信。 2.2. 5G LAN 优势 未使用 5G LAN 时，不同的 UE 使用默认 IP 拨号后，需通过中心服务器进行数据交换以实现通信， 导致网络部署和维护的成本偏高。未使用 5G LAN 的组网架构如下图所示： 5G MES 终端：触摸屏/Linux 操作系统 /集成 5G 模块/LAC 软件脚本 图 3：未使用 5G LAN 时的组网架构 上海移远通信技术股份有限公司 9 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 业务痛点： 1. 网络调整数据配置修改量大； 2. 网络调整需终端厂家开发适配； 3. 网络调整需终端、应用、企业多方协同，部署难度大。 使用 5G LAN 时，不同 UE 终端可以直接进行二层数据交换，无需部署企业 CE。 使用 5G LAN 时的组网架构如下图所示： 5G MES 终端：触摸屏/Linux 操作系统 /集成 5G 模块 图 4：使用 5G LAN 时的组网架构 使用 5G LAN 时的优势如下： 1. 在工业互联网中降低建网成本，无需额外建立隧道设备； 2. 支持二层组网，可以使用工业协议报文； 3. 降低延迟和网络负荷。 上海移远通信技术股份有限公司 10 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 3 5G LAN 拨号流程 3.1. 环境准备 1. 首先需确保终端环境（包括模块和网络）支持 5G LAN。 2. 通过 logel 工具抓取网络相关 Log，查看当前网络环境是否支持 5G LAN。如下图所示，若显示 is_enable:0，则表示当前网络环境不支持 5G LAN，此时需更换为支持 5G LAN 的网络环境（可 咨询运营商）；若显示 is_enable:1，则表示当前网络环境支持 5G LAN。 图 5：确认网络环境 备注 Log 抓取的详细信息，可参考文档 [1]。 3.2. 配置 Ethernet PDN 会话类型（5G LAN DNN 接入网络） 使用 AT+CGDCONT=,,（例如 AT+CGDCONT=1,'Ethernet','quectel'） 配置 APN。其中，为 PDP 上下文 ID（即第几路拨号）；为指定分组数据协议类型，此处 固定设置为'Ethernet'；为接入点名称，用户根据实际使用的网络配置设置该参数。 备注 1. 若 配 置 IP PDU 会 话 类 型 （ 非 5G LAN DNN 入 网 ） ， 可 使 用 AT+CGDCONT=,,,,, （ 例 如 AT+CGDCONT=1,'IP','APN','',0,0）配置 APN。其中，为 PDP 上下文 ID（即第几路拨号） 为指定分组数据协议类型，可设置为'IP'、'IPV6'和'IPV4V6'；为接入点名称， 用户根据实际使用的网络配置设置该参数，IP 类型的 APN 和 Ethernet 类型的 APN 不同； 控制 PDP 数据是否需要压缩；控制 PDP 头部数据压缩。 上海移远通信技术股份有限公司 11 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 2. 关于 AT+CGDCONT 的详细信息，请参考文档 [2]。 3.3. 拨号 步骤一：模块默认禁用 5G LAN 拨号功能，需使用 AT+QCFG='5glan',,启用该功能。 其中，为 PDP 上下文 ID（即第几路拨号），表示启用或禁用 5G LAN 功能。如 需测试多路拨号功能，则依次使用 AT+QCFG='5glan',,配置不同的并启 用 5G LAN 功能。 必须在进行拨号前执行 AT+QCFG='5glan'启用 5G LAN 功能。此命令立即生效且参数配置自 动保存，因此只需配置一次即可。 步骤二：执行 AT+QNETDEVCTL 进行拨号。 备注 1. 如需配置多路 5G LAN 拨号或一路 5G LAN 与一个 IP 的组合拨号方式，配置方法与多路拨号相同， 确保 AT+CGDCONT 和 AT+QCFG='5glan'中配置正确的 IP 或者 5G LAN 类型即可。 2. 配置 Ethernet PDN 会话类型或 IP PDU 会话类型后，均可执行 AT+QNETDEVCTL 进行拨号。 3. 关于 AT+QCFG='5glan'和 AT+QNETDEVCTL 的详细信息，请参考文档 [2]。 3.4. 测试 进行 5G LAN 拨号后，可进行 ping 包测试，确认设备是否可以互通。本章节以模块与 PC 直连为例， 介绍如何进行 ping 包测试。 由于 5G LAN 的网络环境属于局域网，在模块上进行 5G LAN Ethernet PDN 会话类型拨号后，若 5G LAN 组网中无 DHCP 服务器，则进行 ping 包测试前，需先手动设置 PC 的 IP 地址，才能使模块和同一网 络下其他终端互通。设置方法如下： 步骤一：拨号后，进入'Windows 设置'→'网络和 Internet'→'更改适配器选项'； 步骤二：右键单击拨号后对应的以太网，选择'属性'→'Internet 协议版本 4（TCP/IPv4）'，点击 '属性'，在'常规'页签下选择'使用下面的 IP 地址(S)'； 步骤三：修改 IP 地址（IP 地址修改为与核心网服务器处于同一网段的 IP 地址，例如：服务器 IP 地址 是 192.168.9.100，则 PC 端的 IP 地址可设置为 192.168.9.20），然后点击'确定'保存配置。 配置 IP 地址后，在 PC 上 ping 连 5G LAN 网络中的另一台设备 IP 地址，若成功获取回复消息，则 表示模块成功加入 5G LAN 网络，可与同一网络下其他终端可互通。 上海移远通信技术股份有限公司 12 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 4 示例 4.1. 单路拨号 AT+CGDCONT=5,'ETHERNET','zte2.5gzx.sh',,,,,,,,,,,,,,1,'01.A70002' OK AT+QCFG='5glan',5,1 OK AT+QNETDEVCTL=5,1,1 OK //定义PDP上下文。 //启用 5G LAN 功能。 //进行网卡拨号。 4.2. 多路拨号 AT+QCFG='nat',0 OK AT+QCFG='multiusbnet',2 OK //手动重启模块 AT+QCFG='5glan',1,1 OK AT+CGDCONT=1,'Ethernet','apneth',,,,,,,,,,,,,,1,'01.A70002' OK AT+CGDCONT=2,'IP','apnip',,,,,,,,,,,,,,1,'01.A70002' OK AT+QNETDEVCTL=1,1,1 OK AT+QNETDEVCTL=2,1,1 OK //配置网卡拨号模式为网卡模式。 //配置 NCM 网卡两路拨号。 //第一路拨号启用 5G LAN，第二路拨 号为普通拨号，无需配置。 //定义第一路拨号 PDP 上下文。 //定义第二路拨号 PDP 上下文。 //进行第一路网卡拨号。 //进行第二路网卡拨号。 上海移远通信技术股份有限公司 13 / 15 RGx00U&RM500U 系列 5G LAN 拨号应用指导 5 附录 参考文档及术语缩写 表 1：参考文档 文档名称 [1] Quectel_RGx00U&RM500U 系列_Log 抓取指导 [2] Quectel_RGx00U&RM500U 系列_AT 命令手册 表 2：术语缩写 缩写 3GPP 5GC APN CE DHCP DNN ID IP IPv4 L2TP LAC LAN LNS 英文全称 3rd Generation Partnership Project 5GCore Access Point Name Customer Edge Dynamic Host Configuration Protocol Deep Neural Networks Identifier Internet Protocol Internet Protocol version 4 Layer 2 Tunneling Protocol Local Area Connection Local Area Network L2TP Network Server 中文全称 第三代合作伙伴计划 5 G 核心网 接入点名称 用户边缘设备 动态主机设置协议 深度神经网络 标识符 网际互连协议 第 4 版互联网协议 二层隧道协议 本地区域连接 局域网 L2TP 网络服务器 上海移远通信技术股份有限公司 14 / 15 LSW MAC MES PC PDN PDP PDU TCP UE UPF RGx00U&RM500U 系列 5G LAN 拨号应用指导 LAN Switch Medium Access Control Manufacturing Execution System Personal Computer Packet Data Network Packet Data Protocol Packet Data Unit Transmission Control Protocol User Equipment User Plane Function 局域网交换机 媒体访问控制 制造执行系统 个人电脑 分组数据网络 分组数据协议 分组数据单元 传输控制协议 用户设备 用户平面功能 上海移远通信技术股份有限公司 15 / 15

LTE Standard(A)系列 音频应用指导 LTE Standard 模块系列 版本：1.1 日期：2022-02-25 状态：受控文件 LTE Standard(A)系列音频应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 39 LTE Standard(A)系列音频应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 39 LTE Standard(A)系列音频应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2021-03-02 2021-04-15 作者 Egan LI Egan LI 2022-02-25 Egan LI 变更表述 文档创建 受控版本 1. 增 加 文 档 适 用 模 块 EC200A 系 列 、 EC800N-CN 和 EG915N-EU。 2. 删除 EG912Y-CN 模块。 3. 删除 AT+VTD。 4. 更新 AT+QDAI 命令、、和 参数描述（第 2.6 章节）。 5. 更新 AT+QLTONE 命令参数取值范围（第 2.21 章节）。 上海移远通信技术股份有限公司 3 / 39 LTE Standard(A)系列音频应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块..................................................................................................................................... 6 1.2. 特殊符号..................................................................................................................................... 7 1.3. AT 命令语句 ............................................................................................................................... 7 1.3.1. 定义 .................................................................................................................................. 7 1.3.2. AT 命令语句 ..................................................................................................................... 7 1.4. AT 示例声明 ............................................................................................................................... 8 2 AT 命令描述 ........................................................................................................................................... 9 2.1. AT+CLVL 扬声器音量选择....................................................................................................... 9 2.2. AT+QAUDSW 选择 Codec.................................................................................................... 10 2.3. AT+QAUDLOOP 启用/禁用音频循环测试 ............................................................................. 11 2.4. AT+VTS 生成 DTMF 音 ......................................................................................................... 12 2.5. AT+QAUDMOD 设置音频模式 .............................................................................................. 13 2.6. AT+QDAI 配置数字音频接口 ................................................................................................. 13 2.7. AT+QSIDET 设置当前模式的侧音增益 ................................................................................. 16 2.8. AT+QMIC 设置麦克风的上行增益 ......................................................................................... 16 2.9. AT+QIIC 通过 IIC 接口配置 Codec........................................................................................ 17 2.10. AT+QTTS 播放文本............................................................................................................... 18 2.11. AT+QTTSETUP 配置 TTS 参数 ............................................................................................ 20 2.12. AT+QWTTS 播放或发送文本到对端 ..................................................................................... 21 2.13. AT+QAUDRD 录制媒体文件 ................................................................................................. 23 2.14. AT+QAUDPLAY 播放媒体文件.............................................................................................. 25 2.15. AT+QAUDSTOP 停止播放媒体文件 ..................................................................................... 26 2.16. AT+QTONEDET 启用/禁用 DTMF 检测 ................................................................................ 27 2.17. AT+QAUDUPDATE 更新 NVM 文件参数 .............................................................................. 28 2.18. AT+QPSND 播放音频文件 .................................................................................................... 29 2.19. AT+QLDTMF 播放本地 DTMF .............................................................................................. 30 2.20. AT+QWDTMF 播放/发送 DTMF 音到对端 ............................................................................ 32 2.21. AT+QLTONE 播放本地定制音调 ........................................................................................... 33 2.22. AT+QAUDHSDET 控制耳麦探测和耳机功能 ........................................................................ 35 2.23. AT+QDTMFVOL 设置本地音调的音量 .................................................................................. 36 3 错误码................................................................................................................................................... 37 4 附录 参考文档和术语缩写 ................................................................................................................... 38 上海移远通信技术股份有限公司 4 / 39 LTE Standard(A)系列音频应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：特殊符号 ............................................................................................................................................. 7 表 3：AT 命令类型........................................................................................................................................ 7 表 4：URC +QAUDRIND: 0,关于的说明 ........................................................................... 24 表 5：+CME ERROR: ...................................................................................................................... 37 表 6：参考文档 ........................................................................................................................................... 38 表 7：术语缩写 ........................................................................................................................................... 38 上海移远通信技术股份有限公司 5 / 39 LTE Standard(A)系列音频应用指导 1 引言 本文档介绍移远通信 LTE Standard(A)系列模块音频功能相关的 AT 命令。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200T 系列 EC200S 系列 EC200A 系列 EC200N-CN EC600S-CN EC600N-CN EC800N-CN EG912Y-EU EG915N-EU 上海移远通信技术股份有限公司 6 / 39 1.2. 特殊符号 LTE Standard(A)系列音频应用指导 表 2：特殊符号 符号 * 定义 若无特别说明，模块功能、特性、接口、引脚名称、AT 命令或参数后所标记的星号（*）表 示该功能、特性、接口、引脚、AT 命令或参数正在开发中，因此暂不支持；模块子型号后所 标记的星号（*）表示该子型号暂无样品。 1.3. AT 命令语句 1.3.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.3.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 3：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 39 LTE Standard(A)系列音频应用指导 1.4. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 8 / 39 LTE Standard(A)系列音频应用指导 2 AT 命令描述 2.1. AT+CLVL 扬声器音量选择 该命令用于选择 MT 内部扬声器的音量等级。 AT+CLVL 扬声器音量等级选择 测试命令 AT+CLVL=? 响应 +CLVL: (支持的范围) 查询命令 AT+CLVL? OK 响应 +CLVL: 设置命令 AT+CLVL= OK 或者 ERROR 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。生产商特定范围的扬声器音量级别（最小值代表最低的音量级别）。范围：0~5； 默认值：3。 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 9 / 39 LTE Standard(A)系列音频应用指导 2.2. AT+QAUDSW 选择 Codec 该命令用于选择使用内部 codec 或外部 codec。 AT+QAUDSW 选择 Codec 测试命令 AT+QAUDSW=? 响应 +QAUDSW: (支持的列表) 查询命令 AT+QAUDSW? OK 响应 +QAUDSW: 设置命令 AT+QAUDSW= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。 0 外部 codec 1 内部 codec 错误码。详情请参考第 3 章。 备注 1. 默认 codec 由 PMIC 芯片型号决定：默认 PM802 使用外部 codec，默认 PM813 使用内部 codec。 2. EC200T 系列模块不支持该命令。 上海移远通信技术股份有限公司 10 / 39 LTE Standard(A)系列音频应用指导 2.3. AT+QAUDLOOP 启用/禁用音频循环测试 该命令用于启用或禁用音频循环测试。 AT+QAUDLOOP 启用/禁用音频循环测试 测试命令 AT+QAUDLOOP=? 响应 +QAUDLOOP: (支持的列表) 查询命令 AT+QAUDLOOP? OK 响应 +QAUDLOOP: 设置命令 AT+QAUDLOOP= 最大响应时间 特性说明 OK Response OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用/禁用音频循环测试。 0 禁用音频循环测试 1 启用音频循环测试 备注 音频循环的音量取决于 AT+QSIDET（第 2.7 章），默认音量为 48168。 上海移远通信技术股份有限公司 11 / 39 LTE Standard(A)系列音频应用指导 2.4. AT+VTS 生成 DTMF 音 该命令用于发送 ASCII 字符，使 MSC 将 DTMF 音发送到对端。该命令只能在语音呼叫中使用。 AT+VTS 生成 DTMF 音 测试命令 AT+VTS=? 响应 +VTS: (支持的列表),(支持的范 围) 设置命令 AT+VTS=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 取决于和的长度 / 参数 字符串类型。ASCII 字符集 0-9、#、*、A、B、C、D、E、F 需加上引号（'...'）。 整型。每个 DTMF 音的持续时间（以 10 毫秒为单位）的公差。范围：100~1000；默 认值：300。 如果持续时间小于网络指定的最短时间，则实际持续时间为网络指定的时间。若省略 此参数，则 AT+VTD 指定该参数的值。 错误码。详情请参考第 3 章。 举例 ATD12345678900; OK AT+VTS='1' OK AT+VTS='1234567890A' OK //拨号 //对端能够听到 DTMF 音 //一次发送多个 DTMF 音 上海移远通信技术股份有限公司 12 / 39 LTE Standard(A)系列音频应用指导 2.5. AT+QAUDMOD 设置音频模式 该命令用于设置连接设备所需的音频模式。 AT+QAUDMOD 设置音频模式 测试命令 AT+QAUDMOD=? 响应 +QAUDMOD: (支持的范围) 查询命令 AT+QAUDMOD? OK 响应 +QAUDMOD: 设置命令 AT+QAUDMOD= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。当前的音频模式。 0 手机的回声消除、噪声抑制、数字增益和校准参数 1 耳机的回声消除、噪声抑制、数字增益和校准参数 2 扬声器的回声消除、噪声抑制、数字增益和校准参数 错误码。详情请参考第 3 章。 2.6. AT+QDAI 配置数字音频接口 该命令用于配置数字音频接口。 AT+QDAI 配置数字音频接口 测试命令 AT+QDAI=? 响应 +QDAI: ( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 上海移远通信技术股份有限公司 13 / 39 LTE Standard(A)系列音频应用指导 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范 围),(支持的列表),(支持的列表),(支持 的范围) 查询命令 AT+QDAI? OK 响应 +QDAI: [,,,,,,,] 设置命令 AT+QDAI=[,,,[,[,[,,]]]] OK 响应 OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 该命令重启后生效； 参数配置自动保存。 参数 整型。 1 数字 PCM 音频输出。用户可自定义 PCM 格式。在设置主模式、短同步、时 钟频率为 2048 kHz、16 位线性数据格式、8 kHz 采样率的情况下，模块可直 接使用默认设置。 2 模拟音频输出。外部 codec 芯片 NAU8810 与 PCM 接口连接并可通过 IIC 进 行配置。 3 模拟音频输出。外部 codec 芯片 ALC5616 与 PCM 接口连接并可通过 IIC 进 行配置。 5 模拟音频输出。外部 codec 芯片 TLV320AIC3104 与 PCM 接口连接并可通过 IIC 进行配置（暂不支持）。 整型。 0 主模式 1 从模式（暂不支持） 整型。 0 主模式（短同步） 1 辅模式（长同步）（暂不支持） 整型。时钟频率。 0 128 kHz（暂不支持） 1 256 kHz 2 512 kHz 3 1024 kHz 4 2048 kHz 5 4096 kHz 上海移远通信技术股份有限公司 14 / 39 LTE Standard(A)系列音频应用指导 整型。数据格式。 0 16 位线性格式 1 8 比特 a-law 格式（暂不支持） 2 8 比特 u-law 格式（暂不支持） 整型。 0 8 kHz 1 16 kHz 整型。 1 使用的时隙的总数 整型。使用第几个时隙。范围：1~16（暂不支持）。 备注 1. 4096 kHz 时钟频率仅适用于 16 kHz 采样率。 2. 每帧位数 = /。例如，若为 2048 kHz 且为 8 kHz，每帧位数为 256。每帧位数应大于 16。 3. 若选择从模式，应向模块提供主模式和同步时钟。 4. 若选择推荐的 codec 且需要使用 16 kHz 采样率，需输入值。当前仅 ALC5616 支持 16 kHz (AT+QDAI=3,0,0,5,0,1,1,1)。 举例 AT+QDAI=? //测试命令 +QDAI: (1-3,5),(0,1),(0,1),(0-5),(0-2),(0,1),(1),(1-16) OK AT+QDAI? +QDAI: 1,0,0,4,0,0,1,1 //查询当前接口配置 OK AT+QDAI=1,0,0,4,0,0,1,1 OK //将数字 PCM 音频输出设置为主模式、短同步、8 kHz 采样率和 2048 kHz 时钟频率，采样位深为 16bit，使用的时间间隙数量为 1，并且使用第一 个时间间隙。 上海移远通信技术股份有限公司 15 / 39 LTE Standard(A)系列音频应用指导 2.7. AT+QSIDET 设置当前模式的侧音增益 该命令用于设置当前模式的侧音增益。 AT+QSIDET 设置当前模式的侧音增益 测试命令 AT+QSIDET=? 响应 +QSIDET: (支持的范围) 查询命令 AT+QSIDET? OK 响应 +QSIDET: 设置命令 AT+QSIDET= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。当前模式的侧音增益。范围：0~65535。不同音频模式下默认值可能不同。 备注 此命令仅在 AT+QAUDLOOP 禁用音频循环测试后才有效。 2.8. AT+QMIC 设置麦克风的上行增益 该命令用于设置麦克风的上行增益。 AT+QMIC 设置麦克风的上行增益 测试命令 AT+QMIC=? 响应 +QMIC: (支持的范围),(支持的范围) OK 上海移远通信技术股份有限公司 16 / 39 LTE Standard(A)系列音频应用指导 查询命令 AT+QMIC? 设置命令 AT+QMIC=[,] 最大响应时间 特性说明 响应 +QMIC: , OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。上行 codec 增益。范围：0~65535。不同音频模式下默认值可能不同。 整型。上行数字增益。范围：0~65535。不同音频模式下默认值可能不同。 2.9. AT+QIIC 通过 IIC 接口配置 Codec 该命令用于通过 IIC 接口配置 codec。 AT+QIIC 通过 IIC 接口配置 Codec 测试命令 AT+QIIC=? 响应 +QIIC: (支持的 列表 ),(支持的 列表 ),(支持 的 列表),(支持的列表),(支持的列表) 设置命令 AT+QIIC=,,,[,] OK 响应 如果=0，则指定可选参数： OK 如果=1，则省略可选参数： +QIIC: 最大响应时间 特性说明 OK 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 17 / 39 LTE Standard(A)系列音频应用指导 参数 整型。 0 设置命令 1 查询命令 十六进制整型。十六进制加前缀'0x'。 0-0xFF 7 位字节从机设备地址。（当前支持：NAU8810 地址：0x1A；ALC5616 地址： 0x1B） 十六进制整型。十六进制加前缀'0x'。 0-0xFF 寄存器地址 十六进制整型。十六进制加前缀'0x'。 2 写入字节 十六进制整型。 0-0xFFFF 数据值 备注 为从设备的地址（7 位字节，不包括读取或写入字节），可在设备数据表上找到相关信息。 举例 AT+QIIC=0,0x1B,0x00,2,0x0000 OK AT+QIIC=1,0x1B,0x00,2 +QIIC: 0x0000 OK //写入寄存器位置的 2 字节寄存器内容：从机地址：0x1B；寄存器 地址：0x00；写入值：0x0000。 //读取寄存器位置的 2 字节寄存器内容：从机地址：0x1B；寄存器 地址：0x00。 2.10. AT+QTTS 播放文本 该命令用于播放文本。 AT+QTTS 播放文本 测试命令 AT+QTTS=? 查询命令 响应 +QTTS: (支持的范围), OK 响应 上海移远通信技术股份有限公司 18 / 39 LTE Standard(A)系列音频应用指导 AT+QTTS? 设置命令 AT+QTTS=[,] 最大响应时间 特性说明 +QTTS: OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 文本播放完成时： +QTTS: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。开始或停止播放，指示格式。范围：0~2。 0 停止播放，可省略 1 开始播放，使用 UCS2 编码 2 开始播放，是字符串类型，通常是 ASCII 字符，中文使用 GBK 编码 字符串类型。待播放文本。文本格式取决于。最大长度：548 字节。 整型。TTS 播放器状态。 0 空闲 1 繁忙 错误码。详情请参考第 3 章。 备注 1. 模块支持在无通话状态下执行 AT+QTTS（第 2.10 章）或 AT+QWTTS（第 2.12 章）播放 TTS。 2. 通话时 TTS 播放会被中断。 3. 模块支持 TTS 和音频播放，但不支持同时播放。 举例 AT+QTTS=? +QTTS: (0-2), //测试命令 OK AT+QTTS=1,'6B228FCE4F7F752879FB8FDC6A215757'//播放 UCS2 字符串文本 上海移远通信技术股份有限公司 19 / 39 OK +QTTS: 0 AT+QTTS=2,'hello world,你好' OK +QTTS: 0 AT+QTTS=0 OK LTE Standard(A)系列音频应用指导 //播放 ASCII 字符串文本 //停止播放 2.11. AT+QTTSETUP 配置 TTS 参数 该命令用于设置 TTS 速度或调节音量。 AT+QTTSETUP 配置 TTS 参数 测试命令 AT+QTTSETUP=? 响应 +QTTSETUP: (支持的列表),(支持的列表),(支持 的范围) 查询命令 AT+QTTSETUP? 设置命令 AT+QTTSETUP=,[,] OK 响应 OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。设置或查询参数值。 1 设置 2 查询 整型。 1 速度 上海移远通信技术股份有限公司 20 / 39 LTE Standard(A)系列音频应用指导 2 音量 整型。速度或音量值。 如=2，查询命令中省略。 速度 范围：-32768~32767；正常速度：0；默认值：0。 音量 范围：-32768~32767；默认值：0。 错误码。详情请参考第 3章。 举例 AT+QTTSETUP=? +QTTSETUP: (1,2),(1,2),(-32768-32767) OK AT+QTTSETUP=1,2,0 OK //测试命令 //设置音量为 0 2.12. AT+QWTTS 播放或发送文本到对端 该命令用于在通话时向对端播放或者发送文本。 AT+QWTTS 播放或发送文本到对端 测试命令 AT+QWTTS=? 响应 +QWTTS: (支持的列表),(支持的列表),(支 持的范围), 查询命令 AT+QWTTS? OK 响应 +QWTTS: 设置命令 AT+QWTTS=,,[,] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 文本播放完成时： +QWTTS: 0 300 毫秒 上海移远通信技术股份有限公司 21 / 39 LTE Standard(A)系列音频应用指导 特性说明 / 参数 整型。静音或取消静音上行链路。 0 静音 1 取消静音 整型。静音或取消静音下行链路。 0 静音 1 取消静音 整型。开始或停止播放并指定格式。 0 开始播放，可忽略 1 开始播放，使用 UCS2 编码 2 开始播放，是字符型，通常是 ASCII 字符，中文使用 GBK 编码 整型。待播放文本。文本格式取决于。最大长度：548 字节。 整型。TTS 播放器状态。 0 空闲 1 繁忙 错误码。详情请参考第 3 章。 备注 1. +QWTTS: 4111 表示 TTS 播放被来电中断。 2. +CME ERROR: 903 表示在无通话状态下播放 TTS。 3. 将上行链路和下行链路静音后，在通话状态下播放 TTS 上报+CME ERROR: 903。 4. 若和为无效值，上报+CME ERROR: 902。 5. 模块支持文本字符播放，最大长度为 548 字节。 6. 当播放字符为空时，上报+CME ERROR: 902。 举例 AT+QWTTS=? +QWTTS:(0,1),(0,1),(0-2), //测试命令 OK AT+QWTTS=1,1,1,'6B228FCE4F7F752879FB8FDC6A215757' OK //通话时播放 UCS2 字符串并发送至对 端 +QWTTS: 0 AT+QWTTS=1,0,2,'hello world,你好' //通话时播放 ASCII 字符串并发送至远 端 上海移远通信技术股份有限公司 22 / 39 OK +QWTTS: 0 AT+QWTTS=1,0,0 OK LTE Standard(A)系列音频应用指导 //文本播放完成 //结束播放 2.13. AT+QAUDRD 录制媒体文件 该命令用于在语音通话时对上行或下行语音进行录音，或录制空闲状态下的本地麦克风的语音并将其 保存成文件。 AT+QAUDRD 录制媒体文件 测试命令 AT+QAUDRD=? 响应 +QAUDRD: ( 支 持 的 列 表 ),,( 支 持 的 列表),(支持的列表) 查询命令 AT+QAUDRD? OK 响应 +QAUDRD: 设置命令 AT+QAUDRD=[, [,[,]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。 0 模块不在录音状态 1 模块在录音状态 整型。 0 停止录音 1 开始录音 字符串类型。录音文件名称。 上海移远通信技术股份有限公司 23 / 39 LTE Standard(A)系列音频应用指导 整型。文件格式。 13 WAV_PCM16 格式 整型。上行链路或下行链路录音* 0 上行链路录音 1 下行链路录音 错误码。详情请参考第 3 章。 备注 1. 是用于保存录音文件的路径，默认路径是/data/ufs。 2. 模块支持录制WAV_PCM16格式且后缀为'.wav'的音频文件。 3. 若录音文件的名称和格式与已存在的文件相同，或发生未知错误，模块上报+QAUDRIND: 0,1。 4. 若当前录制被其他音频任务中断，模块上报+QAUDRIND: 0,6。 5. 若录制空间不足，模块上报+QAUDRIND: 0,3。 6. 模块支持录制上行或下行链路音频数据，但不支持同时录音。 7. 若文件格式与文件扩展名不一致，该命令报错。 表 4：URC +QAUDRIND: 0,关于的说明 0 1 3 6 说明 保留 未知错误 无录音空间 被其他音频任务中断 举例 AT+QAUDRD=1,'A.wav',13,0 OK AT+QAUDRD=0 OK //录制上行链路声音，并以 WAV 格式保存到 UFS //停止录音 上海移远通信技术股份有限公司 24 / 39 LTE Standard(A)系列音频应用指导 2.14. AT+QAUDPLAY 播放媒体文件 该命令用于播放本地媒体文件。 AT+QAUDPLAY 播放媒体文件 测试命令 AT+QAUDPLAY=? 响应 +QAUDPLAY: ,(支持的列表) 查询命令 AT+QAUDPLAY? OK 响应 +QAUDPLAY: 设置命令 AT+QAUDPLAY=, OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放完成时返回： +QAUDPLAY: 0 300 毫秒 / 参数 整型。模块状态。 0 模块不在播放媒体文件 1 模块正在播放媒体文件 字符串类型。本地媒体文件名称，包括文件路径、文件名称和文件后缀。文件路径必 须是 UFS。默认文件路径是/data/ufs。 整型。播放文件一次或重复播放。 0 只播放一次 1 重复播放 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 25 / 39 LTE Standard(A)系列音频应用指导 备注 1. 若发生未知错误，模块上报+QAUDPIND: 0,1。 2. 若当前播放被其他音频任务中断，模块上报+QAUDPIND: 0,6。 3. 该命令只支持播放 WAV 格式的音频；没有 WAV 数据头的文件会播放失败并上报+ CME ERROR: 902。 4. 电话铃声响起时，媒体文件播放被中断。 5. 若和是无效值，模块上报+CME ERROR: 902；若本地媒体文件不存在，上报 +CME ERROR: 903。 6. 关于 URC +QAUDRIND: 0,中的更多信息，请参考表 4。 举例 AT+QAUDPLAY='A.mp3',0 OK +QAUDPLAY: 0 AT+QAUDPLAY='A.mp3',1 OK +QAUDPLAY: 0 //播放保存在 UFS 的 mp3 文件一次 //重复播放保存在 UFS 的 mp3 文件 2.15. AT+QAUDSTOP 停止播放媒体文件 该命令用于停止播放媒体文件。 AT+QAUDSTOP 停止播放媒体文件 测试命令 AT+QAUDSTOP=? 执行命令 AT+QAUDSTOP 响应 OK 响应 OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 26 / 39 LTE Standard(A)系列音频应用指导 2.16. AT+QTONEDET 启用/禁用 DTMF 检测 该命令用于启用或禁用 DTMF 检测。若启用此功能，对端发送的 DTMF 音会被检测并上报到指定的串 口。 AT+QTONEDET 启用/禁用 DTMF 检测 测试命令 AT+QTONEDET=? 响应 +QTONEDET: (支持的列表) 查询命令 AT+QTONEDET? OK 响应 +QTONEDET: 设置命令 AT+QTONEDET= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 / 参数 整型。启用或禁用 DTMF 检测。 0 禁用 1 启用 备注 DTMF 字符-ASCII： DTMF 0 1 2 3 4 5 6 7 E ASCII 48 49 50 51 52 53 54 55 69 DTMF 8 9 A B C D * # F ASCII 56 57 65 66 67 68 42 35 70 上海移远通信技术股份有限公司 27 / 39 LTE Standard(A)系列音频应用指导 2.17. AT+QAUDUPDATE 更新 NVM 文件参数 该命令用于更新 NVM 音频文件参数。 AT+QAUDUPDATE 更新 NVM 文件参数 测试命令 AT+QAUDUPDATE=? 响应 +QAUDUPDATE: (支持的列表),(支持的范围) 查询命令 AT+QAUDUPDATE? 设置命令 AT+QAUDUPDATE=[,] OK 响应 OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。 0 更新参数 1 保留值 整型。NVM 文件名称。 0 audio_config.nvm 1 audio_gain.nvm 2 audio_ve.nvm 备注 1. 更新文件参数前，必须先通过 AT+QFUPL 将 NVM 文件上传至文件系统。关于 AT+QFUPL 的更多信 息，请参考文档 [1]。 2. EC200T 和 EC200A 系列模块不支持该命令。 举例 AT+QFUPL='audio_config.nvm',298 OK //上传 298 B 校准文件 上海移远通信技术股份有限公司 28 / 39 AT+QAUDUPDATE=0,0 OK LTE Standard(A)系列音频应用指导 //更新 audio_config.nvm 参数 2.18. AT+QPSND 播放音频文件 该命令用于播放本地音频文件。 AT+QPSND 播放音频文件 测试命令 AT+QPSND=? 响应 +QPSND: ( 支 持 的 列 表 ),,( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表) 查询命令 AT+QPSND? OK 响应 +QPSND: 设置命令 AT+QPSND=,,< repeat>[,[,]] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放完成时： +QPSND: 0 300 毫秒 / 参数 整型。 0 模块不在播放文件 1 模块正在播放文件 整型。 0 停止播放 1 开始播放 字符串类型。本地音频文件名称，包括文件路径、文件名称和文件后缀。默认路径是 上海移远通信技术股份有限公司 29 / 39 /data/ufs 目录。 整型。文件播放一次或重复播放。 0 只播放一次 1 重复播放 整型。静音或取消静音上行链路。 0 静音 1 取消静音 静音或取消静音下行链路。 0 静音 1 取消静音 错误码。详情请参考第 3 章。 备注 模块仅支持单声道 WAV 格式和 mp3 格式。 LTE Standard(A)系列音频应用指导 举例 AT+QPSND=1,'A.wav',0 OK +QPSND: 0 AT+QPSND=1,'A.wav',0,1,1 OK +QPSND: 0 //播放保存在 UFS 的 WAV 格式文件 //通话过程中向对端播放 WAV 格式文件 2.19. AT+QLDTMF 播放本地 DTMF 该命令用于播放本地 DTMF 字符串，字符串最大长度为 20 字符。此命令也可用于停止播放 DTMF 字 符串。 AT+QLDTMF 播放本地 DTMF 测试命令 AT+QLDTMF=? 响应 +QLDTMF: (支持的范围),(支持的列表) 设置命令 AT+QLDTMF=,[,< y>] OK 响应 OK 或者 上海移远通信技术股份有限公司 30 / 39 LTE Standard(A)系列音频应用指导 执行命令 AT+QLDTMF 最大响应时间 特性说明 ERROR 若错误与 ME 功能相关： +CME ERROR: 播放完成时： +QLDTMF:5 响应 OK 300 毫秒 / 参数 整型。每个 DTMF 的播放时间和静音时间。范围：1~1000；单位：0.01 秒（=1 时）；0.1 秒（未设置时）。 字符串类型。最大长度：20 字符；逗号隔开；DTMF 格式：0~9、*、#、A~F；需加 上引号（'...'）。 整型。若省略，的单位是 0.1 秒；若=1，的单位是 0.01 秒。 错误码。详情请参考第 3 章。 举例 AT+QLDTMF=? +QLDTMF: (1-1000),(0-9,*,#,A-F) OK AT+QLDTMF=2,'A,B,1,2,#' OK AT+QLDTMF OK //测试命令 //播放 A、B、1、2、#，播放时间和静音时间均为 200 毫秒 //停止播放 上海移远通信技术股份有限公司 31 / 39 LTE Standard(A)系列音频应用指导 2.20. AT+QWDTMF 播放/发送 DTMF 音到对端 该命令用于播放或发送 DTMF 音到对端。 AT+QWDTMF 播放/发送 DTMF 音到对端 测试命令 AT+QWDTMF=? 响应 +QWDTMF: ( 支 持 的 范 围 ),( 支 持 的 范 围),(支持的列表),(支持的范围) 设置命令 AT+QWDTMF=,,< DTMF_string>, OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 设置命令 AT+QWDTMF=,,< value> 播放完成时返回： +QWDTMF: 5 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 执行命令 AT+QWDTMF 最大响应时间 特性说明 播放完成时返回： +QWDTMF: 5 响应 若省略可选参数，则停止播放 DTMF： OK 300 毫秒 / 参数 整型。静音或取消静音上行链路。 0 静音 1-7 取消静音（暂不支持设置音量等级） 上海移远通信技术股份有限公司 32 / 39 LTE Standard(A)系列音频应用指导 整型。静音或取消静音下行链路。 0 静音 1-7 取消静音（暂不支持设置音量等级） 字符串类型。最大长度：64 字符；逗号隔开；DTMF 格式：0~9、*、#、A~F，需 加双引号（'...'）。 播放和静音的持续时间。范围：500~1000；单位：毫秒。 字符串类型。DTMF 音、播放时间和静音时间的组合，用逗号隔开。 DTMF 音 范围：0~9、*、#、A~F（两 DTMF 音之间不需要逗号）；最大长度： 64 字符。 播放时间 范围：100~1000；单位：毫秒。 静音时间 范围：100~1000；单位：毫秒。 例如'AB,500,500,DCD,100,1000'表示 AB 音、播放 500 毫秒、静音 500 毫秒；DCD 音、播放 100 毫秒、静音 1000 毫秒。 举例 AT+QWDTMF=? +QWDTMF: (0,1),(0,1),(0-9,*,#,A-F),(500-1000) OK AT+QWDTMF=1,0,'AB,1000,500,DCD,100,1000' OK AT+QWDTMF OK AT+QWDTMF=1,0,'1,2,3,A,B',500 OK //测试命令 //播放 AB DTMF，播放 1000 毫秒，静音500 毫秒；播放 DCD DTMF，播放 100 毫秒，静音 1000 毫秒 //停止播放 //播放 123AB DTMF，播放时间 500 毫秒，静 音时间 500 毫秒 2.21. AT+QLTONE 播放本地定制音调 该命令用于播放本地定制音调。 AT+QLTONE 播放本地定制音调 测试命令 AT+QLTONE=? 响应 +QLTONE: ( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的范围),(支持的范围),(支 持的范围) OK 上海移远通信技术股份有限公司 33 / 39 LTE Standard(A)系列音频应用指导 设置命令 AT+QLTONE=[,, ,,] 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 执行命令 AT+QLTONE 最大响应时间 特性说明 播放完成时返回： +QLTONE: 0 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。 0 停止播放 1 开始播放 整型。音调频率。范围：100~3500；单位：赫兹。 整型。音调的播放时间。范围：0~1000；单位：毫秒。 整型。音调的静音时间。范围：0~1000；单位：毫秒。 整型。音调的总时长。范围：0~15300000；单位：毫秒。 错误码。详情请参考第 3 章。 举例 AT+QLTONE=? //测试命令 +QLTONE: (0,1),(100-4000),(0-1000),(0-1000),(0-15300000) OK AT+QLTONE=1,1000,200,300,3000 OK //播放 1000 赫兹音调，播放时间 200 毫秒，静音时间 300 毫秒， 总时长 3000 毫秒 +QLTONE: 0 AT+QLTONE=0 OK AT+QLTONE //停止播放 //停止播放 上海移远通信技术股份有限公司 34 / 39 LTE Standard(A)系列音频应用指导 OK 2.22. AT+QAUDHSDET 控制耳麦探测和耳机功能 该命令用于启用或禁用耳麦机探测功能同时关闭或开启耳机。 AT+QAUDHSDET 控制耳麦探测和耳机功能 测试命令 AT+QAUDHSDET=? 响应 +QAUDHSDET: (支持的列表),(支持的列表) 查询命令 AT+QAUDHSDET? OK 响应 +QAUDHSDET: , 设置命令 AT+QAUDHSDET=, OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。启用或禁用耳麦探测功能。 0 禁用 1 启用 整型。 0 正常打开耳机 1 正常关闭耳机 错误码。详情请参考第 3 章。 备注 1. 该命令只适用于内部 codec，在执行此命令前请先切换成内部 codec。 2. EC200T 和 EC200A 系列模块不支持该命令。 上海移远通信技术股份有限公司 35 / 39 LTE Standard(A)系列音频应用指导 2.23. AT+QDTMFVOL 设置本地音调的音量 该命令用于设置本地音调的音量。 AT+QDTMFVOL 设置本地音调的音量 测试命令 AT+QDTMFVOL=? 响应 +QDTMFVOL: (支持的范围) 查询命令 AT+QDTMFVOL? OK 响应 +QDTMFVOL: 设置命令 AT+ QDTMFVOL= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。音量等级。范围：0~10（最小值代表最低的音量级别）。 备注 EC200A 系列模块不支持该命令。 上海移远通信技术股份有限公司 36 / 39 LTE Standard(A)系列音频应用指导 3 错误码 表 5：+CME ERROR: 错误码 901 902 903 904 英文含义 Audio unknown error Audio invalid parameters Audio operation not supported Audio device busy 中文含义 未知音频错误 音频参数无效 不支持该音频操作 音频设备繁忙 上海移远通信技术股份有限公司 37 / 39 LTE Standard(A)系列音频应用指导 4 附录 参考文档和术语缩写 表 6：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_FILE_应用指导 表 7：术语缩写 缩写 ASCII DCD DTMF GBK IIC ME MIC MSC NVM PCM PMIC TA TTS UCS 英文全称 American Standard Code for Information Interchange Data Carrier Detection Dual Tone Multiple Frequency Chinese Internal Code Specification Inter-Integrated Circuit Mobile Equipment Microphone Mobile Switching Center Non-Volatile Memory Pulse Code Modulation Power Management Integrated Circuit Terminal Adapter Text To Speech Universal Character Set 中文全称 美国信息交换标准码 数据载波检测 双音多频 汉字内码扩展规范 集成电路总线 移动设备 麦克风 移动交换中心 非易失性存储器 脉冲编码调制 电源管理集成电路 终端适配器 从文本到语音 通用字符集 上海移远通信技术股份有限公司 38 / 39 UFS URC User File System Unsolicited Result Code LTE Standard(A)系列音频应用指导 用户文件系统 非请求结果码 上海移远通信技术股份有限公司 39 / 39

LTE Standard(A)系列 增强型休眠模式应用指导 LTE Standard 模块系列 版本：1.4 日期：2024-01-11 状态：受控文件 LTE Standard(A)系列增强型休眠模式应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同 时，您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分 析、评估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同 意，尽管移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在 '可用'基础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文 档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 26 LTE Standard(A)系列增强型休眠模式应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问 性、安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 26 LTE Standard(A)系列增强型休眠模式应用指导 文档历史 修订记录 版本 1.0 日期 作者 2020-09-18 2020-09-30 Chaim QIAN/ Bubles TAN/ Abbott ZHANG Chaim QIAN/ Bubles TAN/ Abbott ZHANG 1.1 2022-05-27 Chaim QIAN 1.2 2023-02-22 Chaim QIAN 1.3 2023-05-04 Chaim QIAN 1.4 2024-01-11 Chaim QIAN 变更表述 文档创建 受控版本 1. 新 增 适 用 模 块 EC200A 系 列 、 EC200N-CN 、 EC600N-CN 、 EC800N-CN 、 EG912Y-EU 和 EG915N-EU。 2. 删除适用模块 EC200T 系列。 3. 更新测试示例中的模块为 EC200A 系列和 EC600N- CN（第 3.3 章）。 1. 更新适用模块： ⚫ 新 增 适 用 模 块 EC200M-CN 、 EC600M-CN 、 EC800M-CN 和 EG912N-EN。 ⚫ 更新 EG915N-EU 为 EG915N 系列。 ⚫ 删除 EC600S-CN。 2. 更新的参数取值范围。 3. 更新 EC600N-CN 在不同休眠模式下的平均耗流说明 （第 3.2 章、第 3.3.3 章和第 3.4 章）。 4. 更新测试示例的注意事项（第 3.5 章）。 1. 新增适用模块 EG810M-CN 和 EG950A-EL。 2. 新增 EG950A-EL 模块的测试示例（第 3 章）。 1. 更新适用模块： ⚫ 新增 EC600K-CN、EC800K 系列和 EG800K 系 列。 ⚫ 更新 EC200N-CN 为 EC200N 系列。 ⚫ 更新 EG950A-EL 为 EG950A 系列。 ⚫ 更新 EC600M-CN 为 EC600M 系列。 上海移远通信技术股份有限公司 3 / 26 LTE Standard(A)系列增强型休眠模式应用指导 ⚫ 更新 EG810M-CN 为 EG810M 系列。 2. 更新测试步骤 6 所需时间（第 3.1.3 章）。 3. 新增 EC600K-CN 不同休眠模式下的耗流数据和对比 图（表 7 和第 3.3.5 章）。 上海移远通信技术股份有限公司 4 / 26 LTE Standard(A)系列增强型休眠模式应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 1.1. 适用模块 ..................................................................................................................................... 8 2 AT 命令详解 ........................................................................................................................................ 10 2.1. AT 命令说明.............................................................................................................................. 10 2.1.1. 定义 ............................................................................................................................... 10 2.1.2. AT 命令语句................................................................................................................... 10 2.2. AT 示例声明...............................................................................................................................11 2.3. AT 命令详解...............................................................................................................................11 2.3.1. AT+QSCLKEX 启用/禁用增强型休眠模式.....................................................................11 3 测试及注意事项 ................................................................................................................................... 12 3.1. 测试步骤 ................................................................................................................................... 12 3.1.1. 测试场景 ........................................................................................................................ 12 3.1.2. 需统计数据项................................................................................................................. 12 3.1.3. 测试步骤 ........................................................................................................................ 12 3.2. 测试数据 ................................................................................................................................... 13 3.3. 测试示例 ................................................................................................................................... 15 3.3.1. EC200A 系列在不同休眠模式下平均耗流数据对比图 ................................................... 15 3.3.2. EC600M 系列在不同休眠模式下平均耗流数据对比图 .................................................. 17 3.3.3. EC600N-CN 在不同休眠模式下平均耗流数据对比图.................................................... 19 3.3.4. EG950A 系列在不同休眠模式下平均耗流数据对比图................................................... 21 3.3.5. EC600K-CN 在不同休眠模式下平均耗流对比图 ........................................................... 23 3.3.6. 模块在不同休眠模式下平均耗流数据对比 ..................................................................... 25 3.4. 测试结论 ................................................................................................................................... 25 3.5. 注意事项 ................................................................................................................................... 25 4 附录 参考文档及术语缩写 ................................................................................................................... 26 上海移远通信技术股份有限公司 5 / 26 LTE Standard(A)系列增强型休眠模式应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 8 表 2：AT 命令类型...................................................................................................................................... 10 表 3：EC200A 系列在不同休眠模式下平均耗流数据对比 ......................................................................... 13 表 4：EC600M 系列在不同休眠模式下平均耗流数据对比......................................................................... 13 表 5：EC600N-CN 在不同休眠模式下平均耗流数据对比 .......................................................................... 13 表 6：EG950A 系列在不同休眠模式下平均耗流数据对比 ......................................................................... 14 表 7：EC600K-CN 在不同休眠模式下平均耗流数据对比 .......................................................................... 14 表 8：模块在不同休眠模式下平均耗流数据对比........................................................................................ 25 表 9：参考文档 ........................................................................................................................................... 26 表 10：术语缩写 ......................................................................................................................................... 26 上海移远通信技术股份有限公司 6 / 26 LTE Standard(A)系列增强型休眠模式应用指导 图片索引 图 1：EC200A 系列在普通休眠模式下的平均耗流 .................................................................................... 15 图 2：EC200A 系列在增强型休眠模式下的平均耗流................................................................................. 16 图 3：EC600M 系列在普通休眠模式下的平均耗流.................................................................................... 17 图 4：EC600M 系列在增强型休眠模式下的平均耗流 ................................................................................ 18 图 5：EC600N-CN 在普通休眠模式下的平均耗流 ..................................................................................... 19 图 6：EC600N-CN 在增强型休眠模式下的平均耗流 ................................................................................. 20 图 7：EG950A 系列在普通休眠模式下的平均耗流 .................................................................................... 21 图 8：EG950A 系列在增强型休眠模式下的平均耗流................................................................................. 22 图 9：EC600K-CN 在普通休眠模式下的平均耗流 ..................................................................................... 23 图 10：EC600K-CN 在增强型休眠模式下的平均耗流................................................................................ 24 上海移远通信技术股份有限公司 7 / 26 LTE Standard(A)系列增强型休眠模式应用指导 1 引言 本文档介绍了 LTE Standard(A)系列模块增强型休眠模式的应用指导，包括相关 AT 命令的介绍、应用 场景中模块在普通休眠模式及增强型休眠模式下平均耗流测试数据的对比及注意事项。 增强型休眠模式即模块发送数据后可快速休眠。其与普通休眠模式（通过 AT+QSCLK 控制，关于该 AT 命令的详细信息，请参考文档 [1]）的区别主要体现在数据收发有间隔的场景下，在数据收发完成后， 增强型休眠模式能够快速的进入休眠状态，从而降低整体平均耗流。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N 系列 EC200S 系列 EC600M 系列 EC600N-CN EC600K-CN EC800M-CN EC800N-CN EC800K 系列 EG800K 系列 EG810M 系列 EG912N-EN EG912Y-EU 上海移远通信技术股份有限公司 8 / 26 EG915N 系列 EG950A 系列 LTE Standard(A)系列增强型休眠模式应用指导 上海移远通信技术股份有限公司 9 / 26 LTE Standard(A)系列增强型休眠模式应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说 明，配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 26 LTE Standard(A)系列增强型休眠模式应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意 见，也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接 关系或连续性。 2.3. AT 命令详解 2.3.1. AT+QSCLKEX 启用/禁用增强型休眠模式 该命令用于启用或禁用增强型休眠模式。 AT+QSCLKEX 启用/禁用增强型休眠模式 测试命令 AT+QSCLKEX=? 响应 +QSCLKEX: (支持的列表),(支持的 范围),(支持的 retry_time 范围) 查询命令 AT+QSCLKEX? OK 响应 +QSCLKEX: ,, 设置命令 AT+QSCLKEX=[,[,]] 最大响应时间 特性说明 OK 响应 OK 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。禁用或启用增强型休眠模式。 0 禁用 1 启用 整型。模块发送完数据后进入休眠状态的时间。范围：1~50；单位：秒。 整型。出现网络异常情况时，恢复增强型休眠模式的时间。 范围：0~600；单位：分钟。 上海移远通信技术股份有限公司 11 / 26 LTE Standard(A)系列增强型休眠模式应用指导 3 测试及注意事项 本章节以 EC200A 系列、EC600M 系列、EC600N-CN、EG950A 系列和 EC600K-CN 模块为例，主 要描述和展示了在应用场景中，模块在普通休眠模式及增强型休眠模式下测试平均耗流的步骤、数据对 比、示例、结论及注意事项，供用户参考（测试结果受业务场景、网络信号质量、运营商配置等影响）。 3.1. 测试步骤 3.1.1. 测试场景 建立 TCP 长连接，每间隔 60 秒向服务器发送 100 字节数据。 3.1.2. 需统计数据项 ⚫ 测试时长。 ⚫ 普通休眠模式和增强型休眠模式下进入低功耗模式的平均时长。 ⚫ 发送一包数据到进入低功耗模式并等待一定时间的过程（如下测试步骤 3~步骤 4）的平均耗流。 3.1.3. 测试步骤 步骤1： 执行 AT+QSCLKEX=1,1,10 启用增强型休眠模式。 步骤2： 执行 AT+QIOPEN（关于该 AT 命令详情，请参考文档 [2]）建立 TCP 连接。 步骤3： 执行 AT+QISEND（关于该 AT 命令详情，请参考文档 [2]）发送一包数据（100 字节）。 步骤4： 拉高 DTR 进入低功耗模式，等待 60 秒钟（统计平均耗流）。 步骤5： 拉低 DTR 唤醒模块。 步骤6： 循环步骤 3~步骤 5（共 0.5 小时）。 上海移远通信技术股份有限公司 12 / 26 3.2. 测试数据 LTE Standard(A)系列增强型休眠模式应用指导 表 3：EC200A 系列在不同休眠模式下平均耗流数据对比 运营商/制式 移动 LTE 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 进入低功耗平均时长 时长（小时） （秒） 12 10.75 12 4.57 普通休眠模式 12 5.93 联通 LTE 增强型休眠模式 12 2.64 电信 LTE 普通休眠模式 12 增强型休眠模式 12 10.75 3.28 平均耗流 （毫安） 14.51 6.06 9.45 5.05 13.56 5.05 表 4：EC600M 系列在不同休眠模式下平均耗流数据对比 运营商/制式 移动 LTE 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 进入低功耗平均时长 时长（小时） （秒） 12 11.35 12 2.94 普通休眠模式 12 联通 LTE 增强型休眠模式 12 11.35 2.61 普通休眠模式 12 电信 LTE 增强型休眠模式 12 10.81 3.24 平均耗流 （毫安） 10.59 6.59 14.85 5.13 5.26 4.74 表 5：EC600N-CN 在不同休眠模式下平均耗流数据对比 运营商/制式 移动 LTE 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 进入低功耗平均时长 时长（小时） （秒） 12 10.75 12 4.57 联通 LTE 普通休眠模式 12 10.83 平均耗流 （毫安） 14.51 6.06 15.68 上海移远通信技术股份有限公司 13 / 26 增强型休眠模式 12 普通休眠模式 12 电信 LTE 增强型休眠模式 12 LTE Standard(A)系列增强型休眠模式应用指导 2.46 5.62 10.83 5.49 2.71 5.06 表 6：EG950A 系列在不同休眠模式下平均耗流数据对比 运营商/制式 移动 LTE 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 时长（小时） 进入低功耗平均时长 （秒） 12 20.04 12 3.25 普通休眠模式 12 联通 LTE 增强型休眠模式 12 11.29 2.71 普通休眠模式 12 电信 LTE 增强型休眠模式 12 12.46 3.25 平均耗流 （毫安） 9.44 6.29 20.06 6.43 19.73 6.95 表 7：EC600K-CN 在不同休眠模式下平均耗流数据对比 运营商/制式 移动 LTE 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 时长（小时） 进入低功耗平均时长 （秒） 12 10.46 12 2.59 普通休眠模式 12 联通 LTE 增强型休眠模式 12 11.45 3.21 普通休眠模式 12 电信 LTE 增强型休眠模式 12 11.05 2.37 平均耗流 （毫安） 3.86 3.05 4.51 4.11 4.60 4.22 上海移远通信技术股份有限公司 14 / 26 LTE Standard(A)系列增强型休眠模式应用指导 3.3. 测试示例 本章节主要展示了 EC200A 系列、EC600M 系列、EC600N-CN、EG950A 系列和 EC600K-CN 模块 分别在普通休眠模式和增强型休眠模式下的平均耗流对比图，仅为较优测试场景下的测试示例。 测试场景如下所示： ⚫ EC200A 系 列 、 EC600M 系 列 、 EC600N-CN 、 EG950A 系 列 和 EC600K-CN 模 块 均 配 置 AT+QSCLKEX=1,1,10 启用增强型休眠功能。 ⚫ 插入联通卡并注册 LTE Band 3。 ⚫ RSRP 为-85。（可通过 AT+QENG='servingcell'查询，详情请参考文档 [3]。） ⚫ 模块和服务器之间建立 TCP 长连接。 ⚫ 测试时长：0.5 小时。 3.3.1. EC200A 系列在不同休眠模式下平均耗流数据对比图 ⚫ 普通休眠模式 图 1：EC200A 系列在普通休眠模式下的平均耗流 上海移远通信技术股份有限公司 15 / 26 LTE Standard(A)系列增强型休眠模式应用指导 如上图所示，模块接收数据后，波峰电流时长约为 11.35 秒，之后进入休眠状态，平均耗流为 13.57 毫安。 ⚫ 增强型休眠 图 2：EC200A 系列在增强型休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 2.70 秒，之后进入休眠状态，平均耗流为 5.05 毫安。 对比图 1 和图 2，在增强型休眠模式下模块在收发数据后能够快速进入休眠状态，从而降低平均耗 流。 上海移远通信技术股份有限公司 16 / 26 LTE Standard(A)系列增强型休眠模式应用指导 3.3.2. EC600M 系列在不同休眠模式下平均耗流数据对比图 ⚫ 普通休眠模式 图 3：EC600M 系列在普通休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 11.35 秒，之后进入休眠状态，平均耗流为 10.59 毫安。 上海移远通信技术股份有限公司 17 / 26 ⚫ 增强型休眠 LTE Standard(A)系列增强型休眠模式应用指导 图 4：EC600M 系列在增强型休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 2.94 秒，之后进入休眠状态，平均耗流为 6.59 毫安。 对比图 3 和图 4，在增强型休眠模式下模块在接收数据后能够快速进入休眠状态，从而降低平均耗 流。 上海移远通信技术股份有限公司 18 / 26 LTE Standard(A)系列增强型休眠模式应用指导 3.3.3. EC600N-CN 在不同休眠模式下平均耗流数据对比图 ⚫ 普通休眠模式 图 5：EC600N-CN 在普通休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 10.83 秒，之后进入休眠状态，平均耗流为 15.68 毫安。 上海移远通信技术股份有限公司 19 / 26 ⚫ 增强型休眠 LTE Standard(A)系列增强型休眠模式应用指导 图 6：EC600N-CN 在增强型休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 2.46 秒，之后进入休眠状态，平均耗流为 5.62 毫安。 对比图 5 和图 6，在增强型休眠模式下模块在接收数据后能够快速进入休眠状态，从而降低平均耗 流。 上海移远通信技术股份有限公司 20 / 26 LTE Standard(A)系列增强型休眠模式应用指导 3.3.4. EG950A 系列在不同休眠模式下平均耗流数据对比图 ⚫ 普通休眠模式 图 7：EG950A 系列在普通休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 12.46 秒，之后进入休眠状态，平均耗流为 19.73 毫安。 上海移远通信技术股份有限公司 21 / 26 ⚫ 增强型休眠 LTE Standard(A)系列增强型休眠模式应用指导 图 8：EG950A 系列在增强型休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 3.25 秒，之后进入休眠状态，平均耗流为 6.95 毫安。 对比图 7 和图 8，在增强型休眠模式下模块在接收数据后能够快速进入休眠状态，从而降低平均耗 流。 上海移远通信技术股份有限公司 22 / 26 LTE Standard(A)系列增强型休眠模式应用指导 3.3.5. EC600K-CN 在不同休眠模式下平均耗流对比图 ⚫ 普通休眠模式 图 9：EC600K-CN 在普通休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 12.24 秒，之后进入休眠状态，平均耗流为 4.77 毫 安。 上海移远通信技术股份有限公司 23 / 26 ⚫ 增强型休眠 LTE Standard(A)系列增强型休眠模式应用指导 图 10：EC600K-CN 在增强型休眠模式下的平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 3.21 秒，之后进入休眠状态，平均耗流为 4.11 毫 安。 对比图 9 和图 10，在增强型休眠模式下模块在接收数据后能够快速进入休眠状态，从而降低平均耗 流。 上海移远通信技术股份有限公司 24 / 26 LTE Standard(A)系列增强型休眠模式应用指导 3.3.6. 模块在不同休眠模式下平均耗流数据对比 表 8：模块在不同休眠模式下平均耗流数据对比 运营商/制式 模块 EC200A 系列 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 EC600M 系列 普通休眠模式 增强型休眠模式 联通 LTE EC600N-CN 普通休眠模式 增强型休眠模式 EG950A 系列 普通休眠模式 增强型休眠模式 EC600K-CN 普通休眠模式 增强型休眠模式 时长（小时） 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 平均耗流（毫安） 13.57 5.05 10.59 6.59 15.68 5.62 19.73 6.95 4.76 4.48 3.4. 测试结论 通过对模块在增强型休眠模式启用前后平均耗流数据的对比可见，在大部分场景下，增强型休眠模式 下对降低功耗效果明显。 3.5. 注意事项 启用增强型休眠模式后，当用户发起数据交互时，会给基站带来额外的信令负担，因此可能会出现终 端收到网络侧惩罚而无法上线的情况。该功能默认关闭，客户使用前需自行评估风险。 上海移远通信技术股份有限公司 25 / 26 LTE Standard(A)系列增强型休眠模式应用指导 4 附录 参考文档及术语缩写 表 9：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_AT 命令手册 [2] Quectel_LTE_Standard(A)系列_TCP(IP)_应用指导 [3] Quectel_LTE_Standard(A)系列_QuecCell_应用指导 表 10：术语缩写 缩写 DTR IP LTE RSRP TCP WCDMA 英文全称 Data Terminal Ready Internet Protocol Long Term Evolution Reference signal received power Transmission Control Protocol Wideband Code Division Multiple Access 中文全称 数据终端就绪 互联网协议 长期演进 参考信号接收功率 传输控制协议 宽带码分多址 上海移远通信技术股份有限公司 26 / 26

LTE Standard(A)系列 低功耗模式应用指导 LTE Standard 模块系列 版本：1.0 日期：2023-10-18 状态：受控文件 LTE Standard(A)系列低功耗模式应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 16 LTE Standard(A)系列低功耗模式应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 16 LTE Standard(A)系列低功耗模式应用指导 文档历史 修订记录 版本 1.0 日期 2022-03-14 2023-10-18 作者 Evin ZHU/ Chaim QIAN Evin ZHU/ Chaim QIAN 变更表述 文档创建 初始版本 上海移远通信技术股份有限公司 3 / 16 LTE Standard(A)系列低功耗模式应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图表索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 2 相关硬件接口.......................................................................................................................................... 9 2.1. 通信接口 ...................................................................................................................................... 9 2.2. 电源管理引脚............................................................................................................................... 9 3 URC 介绍 ............................................................................................................................................. 10 3.1. URC 上报端口设置.................................................................................................................... 10 3.2. URC 事件上报管理.................................................................................................................... 10 4 低功耗方案实施 .................................................................................................................................... 11 4.1. 基于 UART 实施的低功耗方案 .................................................................................................. 11 4.1.1. 硬件连接 ......................................................................................................................... 11 4.1.2. 软件初始化 ..................................................................................................................... 12 4.1.3. 实施方法 ......................................................................................................................... 12 4.2. 基于 USB Suspend/Resume 实施的低功耗方案....................................................................... 13 4.2.1. 硬件连接 ......................................................................................................................... 13 4.2.2. 软件初始化 ..................................................................................................................... 13 4.2.3. 实施方法 ......................................................................................................................... 13 5 软件机制 ............................................................................................................................................... 14 5.1. 模块睡眠原理............................................................................................................................. 14 5.2. 模块睡眠流程............................................................................................................................. 14 5.3. USB 睡眠原理............................................................................................................................ 15 5.4. 唤醒主机 .................................................................................................................................... 15 5.4.1. 主机唤醒事件.................................................................................................................. 15 5.4.2. 主机唤醒事件配置 .......................................................................................................... 15 5.5. 唤醒模块 .................................................................................................................................... 15 6 附录 参考文档及术语缩写 ................................................................................................................... 16 上海移远通信技术股份有限公司 4 / 16 LTE Standard(A)系列低功耗模式应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：电源管理引脚...................................................................................................................................... 9 表 3：参考文档 ........................................................................................................................................... 16 表 4：术语缩写 ........................................................................................................................................... 16 上海移远通信技术股份有限公司 5 / 16 LTE Standard(A)系列低功耗模式应用指导 图表索引 图 1：基于 UART 的低功耗方案连接示意图 .............................................................................................. 11 图 2：基于 USB Suspend/Resume 的低功耗方案连接示意图................................................................... 13 图 3：模块睡眠流程.................................................................................................................................... 14 上海移远通信技术股份有限公司 6 / 16 1 引言 在嵌入式应用中，产品的功耗越来越受到用户的重视，其对于电池供电的设备尤为重要。降低产品功 耗，延长电池的使用寿命，即可降低产品的运营成本，提高产品的市场竞争力。移远通信模块产品的功耗 最小化需要从软件和硬件设计两方面入手，本文档重点介绍如何通过软件设计实现功耗最小化。 本文介绍了 LTE Standard(A)系列模块的外围硬件接口、URC、低功耗实施方案以及模块睡眠与唤醒 的软件机制。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N 系列 EC200S 系列 EC600M-CN EC600N-CN EC600K-CN EC800M-CN EC800N-CN EC800K 系列 EG800K 系列 EG810M-CN 上海移远通信技术股份有限公司 7 / 16 EG912N-EN EG912Y-EU EG915N 系列 EG950A 系列 LTE Standard(A)系列低功耗模式应用指导 上海移远通信技术股份有限公司 8 / 16 LTE Standard(A)系列低功耗模式应用指导 2 相关硬件接口 2.1. 通信接口 模块和主机系统之间主要通过 USB 和 UART（串口）进行通信。 2.2. 电源管理引脚 模块面向主机系统还提供了其他功能引脚用于实现电源管理。 表 2：电源管理引脚 引脚名称 输入/输出 MAIN_DTR IN MAIN_RI OUT 描述 用于主机唤醒睡眠状态下的模块或允许模块进入睡眠。其中，MAIN_DTR 为 高电平时，主机允许模块进入睡眠。当模块处于睡眠状态时，拉低 MAIN_DTR 会唤醒模块。 用于模块通知主机当前有 URC 事件需要上报。当模块没有 URC 上报时， MAIN_RI 保持高电平输出；当模块有 URC 上报时，MAIN_RI 会输出一个低 脉冲，此时若主机处于睡眠状态，主机将会被唤醒并接受处理上报的 URC。 备注 1. MAIN_DTR 为高电平时，模块是否真正进入睡眠还取决于其他条件是否满足。若 MAIN_DTR 为低电 平则模块无法进入睡眠。 2. URC 可以通过 UART 接口上报，当有 URC 上报时，MAIN_RI 引脚会产生低脉冲通知主机，随后输 出 URC 内容。 3. 指定模块的接口和引脚信息请参考该模块的硬件设计手册。 上海移远通信技术股份有限公司 9 / 16 LTE Standard(A)系列低功耗模式应用指导 3 URC 介绍 在模块与主机的交互中，模块不仅响应主机的请求，还主动通知主机外部事件，例如来电、短信等。 通常，模块主动上报的信息称为 URC。 模块对 URC 的处理体现在两个方面：主动向系统上报事件信息和在 MAIN_RI 引脚上产生低脉冲。 MAIN_RI 引脚能够在主机系统进入睡眠后以脉冲的形式通知主机系统主动事件的到来。由于模块支持多种 不同类型的 URC，频繁的 URC 上报会导致主机系统频繁地从睡眠中唤醒，从而可能降低整机状态和提高 功耗。为了避免频繁的 URC 上报，主机系统需要根据自身的业务情况选择需要上报的 URC。 3.1. URC 上报端口设置 通常情况下，模块和主机系统间只通过 UART 或 USB 中的一种接口进行通信，所以模块端的 URC 也 只在这两种接口间选择一个进行上报。 用户可以通过执行 AT+QURCCFG 配置模块端 URC 上报的端口。有关命令详情，请参考文档 [1]。 3.2. URC 事件上报管理 模块支持多种 URC，如网络状态类 URC 用于向主机端上报模块当前的网络状态，短信类 URC 用于向 主机端上报新短信的到来以及电话类 URC 用于向主机上报来电状态等。 大多数 URC 的上报可通过 AT+QINDCFG 开启或关闭。因此，主机系统可以根据自身的需要，在不同 的系统状态下，有选择地打开或关闭 URC 上报。例如： ⚫ 当主机系统第一次开机时，开启网络、短信和电话相关的 URC。 ⚫ 当主机系统将要进入睡眠时，可以禁止部分与网络相关的 URC 上报，只允许短信与电话相关的 URC 上报。 如上，在保证系统自身业务的同时，也提高了整机系统的电源管理效率。 备注 关于如何通过 AT+QINDCFG 设置 URC 上报，请参考文档 [1]。 上海移远通信技术股份有限公司 10 / 16 LTE Standard(A)系列低功耗模式应用指导 4 低功耗方案实施 4.1. 基于 UART 实施的低功耗方案 主机通过 UART 与模块通信，本章节将描述该类低功耗方案的具体实施方法。 4.1.1. 硬件连接 ⚫ 主机与模块进行 UART 连接。 ⚫ 主机 I/O 连接模块的 MAIN_RI 引脚，主机连接的引脚需支持中断唤醒功能。 ⚫ 主机 I/O 连接模块的 MAIN_DTR 引脚。 MCU/ARM VDD_EXT 4.7K 1nF TXD RXD RTS CTS GPIO EINT GPIO GND 1nF 10K VCC_MCU 4.7K VDD_EXT 10K VDD_EXT Module MAIN_RXD MAIN_TXD MAIN_RTS MAIN_CTS MAIN_DTR MAIN_RI MAIN_DCD GND 图 1：基于 UART 的低功耗方案连接示意图 UART 是模块与主机之间进行通信的重要通道，主机通过复用 UART 中的 DTR 为普通的 GPIO 功能， 能够控制模块睡眠，进而对模块进行电源管理。主机 DTR 输出为高时，将允许模块进入睡眠；主机 DTR 输出为低时，若模块处于唤醒状态则不会进入睡眠，若模块处在睡眠状态则会被唤醒。 备注 虚线部分的输入和输出电路设计可参考实线部分，同时需注意连接方向。 上海移远通信技术股份有限公司 11 / 16 LTE Standard(A)系列低功耗模式应用指导 4.1.2. 软件初始化 ⚫ AT+QSCLK=1 通过控制变量设置允许模块进入睡眠状态（模块是否真正进入睡眠还取决于其他条件是否满足）。 有关命令详情，请参考文档 [1]。 ⚫ AT+QURCCFG='urcport','uart1' 将模块主动事件指定在 UART 口上报。有关命令详情，请参考文档 [1]。 4.1.3. 实施方法 ⚫ 模块进入睡眠状态： 主机端拉高模块的 MAIN_DTR 引脚控制模块进入睡眠状态。 ⚫ 模块从睡眠状态中唤醒： 主机端拉低模块的 MAIN_DTR 引脚控制模块退出睡眠状态。 ⚫ 模块唤醒主机： 当模块有主动事件数据需要上报时，模块的 MAIN_RI 引脚上会产生低脉冲（脉冲持续时间默认为 120 ms）用于通知主机主动上报事件的到来。主机系统在睡眠状态下，需要保证能够被模块上的 MAIN_RI 引脚的电平变化唤醒。 上海移远通信技术股份有限公司 12 / 16 LTE Standard(A)系列低功耗模式应用指导 4.2. 基于 USB Suspend/Resume 实施的低功耗方案 当设备实施此低功耗方案时，要求主机支持 USB Suspend/Resume 功能。本章节将描述该类低功耗方 案的具体实施方法。 4.2.1. 硬件连接 主机通过 USB 接口与模块通信，如下图所示。 Minimize these stubs Test Points Module VDD R1 NM_0R R2 NM_0R USB_VBUS USB_DM USB_DP GND L1 Close to Module ESD Array MCU USB_DM USB_DP GND 图 2：基于 USB Suspend/Resume 的低功耗方案连接示意图 4.2.2. 软件初始化 ⚫ AT+QSCLK=1 通过控制变量设置允许模块进入睡眠状态（模块是否真正进入睡眠还取决于其他条件是否满足）。 有关命令详情，请参考文档 [1]。 4.2.3. 实施方法 ⚫ 模块进入睡眠状态： 主机系统进入睡眠状态时，USB 被挂起。 ⚫ 模块退出睡眠状态： 主机通过 USB Resume 唤醒功能对模块进行 USB 唤醒动作。 上海移远通信技术股份有限公司 13 / 16 LTE Standard(A)系列低功耗模式应用指导 5 软件机制 5.1. 模块睡眠原理 模块内部有一个较低优先级的 Sleep 任务，负责检测模块是否能够进入睡眠模式。睡眠控制变量 （AT+QSCLK）和模块内部其他的任务（RF、USB、UART 等）一起，向 Sleep 任务投票决定模块能否进 入睡眠模式。只有当睡眠控制变量与其他任务均同意模块进入睡眠时，Sleep 任务才会被执行，模块进入睡 眠模式。 备注 模块进入睡眠模式后，RF 任务并不会被关闭，模块处于 DRX 模式下。DRX 是一种节省终端功耗的工作 模式，其基本原理是让模块周期性地进入睡眠状态。 5.2. 模块睡眠流程 业务任务启动 Sleep 任务启动 QSCLK、USB、 UART、RF 等 投票 投票统计 否 睡眠控制变量和其他任务 是否同意睡眠 是 模块进入睡眠 Sleep 任务 图 3：模块睡眠流程 上海移远通信技术股份有限公司 14 / 16 LTE Standard(A)系列低功耗模式应用指导 5.3. USB 睡眠原理 USB 正常通信状态下，Hub 或 HCD 中的 Root Hub 会周期性地发送 SOF 包（全速 USB 每隔 1 ms 发 送一个，高速 USB 每隔 125 μs 发送一个），此时，模块的 USB 会反对模块进入睡眠模式。 依照 USB 标准协议中对 Suspend 的描述，当主机系统把 Hub 或 Root Hub 中与 USB 设备附着的端口 设置成 Suspend 模式后，Hub 或 Root Hub 会终止 SOF 包的发送，USB 总线会进入 Suspend 状态。在这 之后，模块的 USB 会进入 Suspend 模式，并同意模块进入睡眠状态。 备注 1. 针对不同的主机操作系统，移远通信均提供了模块的 USB Suspend 功能，可以在主机系统端实现控 制模块 USB 进入 Suspend 模式。 2. 若用户使用自己研发的 USB 驱动，应注意驱动需要同时支持 Global Suspend 和 Selective Suspend。 5.4. 唤醒主机 5.4.1. 主机唤醒事件 主机唤醒事件是指在主机睡眠状态下，模块主动上报给主机并唤醒主机的特定模块事件。主机唤醒事 件也称之为 URC。详情请参考第 3 章。 5.4.2. 主机唤醒事件配置 主机可以通过 AT+QURCCFG 配置 URC 上报的端口，如 UART 或者是 USB AT 端口。具体实施方案 下，主机可以根据自身实际的硬件连接方式，将 URC 设定在指定的端口上报。默认情况下，URC 被指定 在 USB AT 口上报。 5.5. 唤醒模块 主机唤醒模块主要通过拉低 MAIN_DTR 引脚和 USB 唤醒，详情请参考第 4.1.3 章和第 4.2.3 章。 上海移远通信技术股份有限公司 15 / 16 LTE Standard(A)系列低功耗模式应用指导 6 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_AT 命令手册 表 4：术语缩写 缩写 DRX DTR HCD I/O PDCCH RF RI SOF UART UE URC USB 英文全称 中文全称 Discontinuous Reception 非连续接收 Data Terminal Ready 数据终端就绪 Host Controller Driver 主机控制器驱动 Input/Output 中央处理器 Physical Downlink Control Channel 物理下行控制信道 Radio Frequency 射频 Ring Indicator 响铃侦测 Start-of-Frame 起始帧信号 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 User Equipment 用户设备 Unsolicited Result Codes 非请求结果码 Universal Serial Bus 通用串行总线 上海移远通信技术股份有限公司 16 / 16

LTE Standard(A)系列 USB 描述符介绍 LTE Standard 模块系列 版本：1.2 日期：2023-04-28 状态：受控文件 LTE Standard(A)系列 USB 描述符介绍 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 24 LTE Standard(A)系列 USB 描述符介绍 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 24 LTE Standard(A)系列 USB 描述符介绍 文档历史 修订记录 版本 日期 作者 - 2022-01-04 Ford ZHANG 1.0 2022-02-14 Ford ZHANG 1.1 2022-08-17 Ford ZHANG 1.2 2023-04-28 Ford ZHANG 变更表述 文档创建 受控版本 更新适用模块： ⚫ 新 增 EC200M-CN 、 EC600M-CN 、 EC800M-CN 和 EG912N-EN。 ⚫ 更新 EG915N-EU 为 EG915N 系列。 ⚫ 删除 EC200T 系列。 更新适用模块： ⚫ 新增 EG810M-CN 和 EG950A-EL。 ⚫ 删除 EC600S-CN。 上海移远通信技术股份有限公司 3 / 24 LTE Standard(A)系列 USB 描述符介绍 目录 文档历史 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................4 表格索引 ..................................................................................................................................................... 5 1 引言.....................................................................................................................................................6 1.1. 适用模块 ...................................................................................................................................6 2 概览.....................................................................................................................................................7 3 USB 描述符.........................................................................................................................................9 3.1. 设备描述符 ...............................................................................................................................9 3.2. 配置描述符 ............................................................................................................................. 11 3.3. 接口描述符 .............................................................................................................................12 3.3.1. 接口 0（ECM 接口） ...................................................................................................12 3.3.1.1. 端点描述符 1 .................................................................................................... 12 3.3.2. 接口 1（ECM 接口） ...................................................................................................13 3.3.2.1. 端点描述符 1 .................................................................................................... 14 3.3.2.2. 端点描述符 2 .................................................................................................... 15 3.3.3. 接口 2（移动诊断接口） ..............................................................................................15 3.3.3.1. 端点描述符 1 .................................................................................................... 16 3.3.3.2. 端点描述符 2 .................................................................................................... 17 3.3.4. 接口 3（AT 接口） .......................................................................................................18 3.3.4.1. 端点描述符 1 .................................................................................................... 18 3.3.4.2. 端点描述符 2 .................................................................................................... 19 3.3.4.3. 端点描述符 3 .................................................................................................... 20 3.3.5. 接口 4（Modem 接口） ...............................................................................................21 3.3.5.1. 端点描述符 1 .................................................................................................... 21 3.3.5.2. 端点描述符 2 .................................................................................................... 22 3.3.5.3. 端点描述符 3 .................................................................................................... 23 4 附录 术语缩写...................................................................................................................................24 上海移远通信技术股份有限公司 4 / 24 LTE Standard(A)系列 USB 描述符介绍 表格索引 表 1：适用模块.......................................................................................................................................... 6 表 2：USB 描述符概述 .............................................................................................................................. 7 表 3：接口介绍.......................................................................................................................................... 7 表 4：设备描述符 ...................................................................................................................................... 9 表 5：USB 配置描述符 .............................................................................................................................11 表 6：接口 0 的接口描述符...................................................................................................................... 12 表 7：接口 0 的端点描述符 1 ................................................................................................................... 12 表 8：接口 1 的接口描述符...................................................................................................................... 13 表 9：接口 1 的端点描述符 1 ................................................................................................................... 14 表 10：接口 1 的端点描述符 2 ................................................................................................................. 15 表 11：接口 2 的接口描述符 .................................................................................................................... 15 表 12：接口 2 的端点描述符 1 ................................................................................................................. 16 表 13：接口 2 的端点描述符 2 ................................................................................................................. 17 表 14：接口 3 的接口描述符.................................................................................................................... 18 表 15：接口 3 的端点描述符 1 ................................................................................................................. 18 表 16：接口 3 的端点描述符 2 ................................................................................................................. 19 表 17：接口 3 的端点描述符 3 ................................................................................................................. 20 表 18：接口 4 的接口描述符.................................................................................................................... 21 表 19：接口 4 的端点描述符 1 ................................................................................................................. 21 表 20：接口 4 的端点描述符 2 ................................................................................................................. 22 表 21：接口 4 的端点描述符 3 ................................................................................................................. 23 表 22：术语缩写...................................................................................................................................... 24 上海移远通信技术股份有限公司 5 / 24 LTE Standard(A)系列 USB 描述符介绍 1 引言 本文档主要介绍了移远通信信 LTE Standard(A)系列模块的 USB 描述符。Host 通过各种描述符来识别 USB 设备（模块），包括设备描述符、配置描述符、接口描述符、端点描述符和字符串描述符（可选）。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N-CN EC200S 系列 EC600M-CN EC600N-CN EC800M-CN EC800N-CN EG810M-CN EG912N-EN EG912Y-EU EG915N 系列 EG950A-EL 上海移远通信技术股份有限公司 6 / 24 LTE Standard(A)系列 USB 描述符介绍 2 概览 USB 描述符的概述如下表。 表 2：USB 描述符概述 USB 描述符 作用 备注 设备描述符 配置描述符 接口描述符 端点描述符 字符串描述符 （可选） 描述 USB 设备的通用信息，包括所 有的设备配置，例如 USB 设备使用 的 USB 协议版本号、设备类型以及 设备的其他参数信息。 描述特定 USB 设备的配置信息，例 如支持的接口数量、供电方式等。 描述一个配置下的特定接口 描述 USB 端点的一般信息 保存一些供应商名称、产品序列号 等文本信息 一台设备只有一个设备描述符 一台设备可以有多个配置描述符。一个配置所支持 的接口数由配置描述符的 bNumInterfaces 决定。 当一个配置支持多个接口，那一个接口下的所有端 点描述符经常是作为一个配置描述符下的一部分返 回 。 接 口 描 述 符 不 能 使 用 GetDescriptor() 或 SetDescriptor()请求直接访问。 USB 设备中的每个端点均有各自的端点描述符，其 数量由接口描述符的 bNumEndpoint 决定。 ⚫ 字符串描述符由 3 三个字段按照固定的顺序组 成，该描述符的总长度不是固定的，长度随字 符串的数量和信息的长度而变化。 ⚫ 可选。如果不支持字符串描述符，其设备、配 置、接口描述符内的所有字符串描述符索引都 必须为 0。 Host 连接 LTE Standard(A)系列模块时，模块默认显示 5 个接口。所有支持的 USB 接口具有不同的功 能，详见下表。 表 3：接口介绍 接口号 接口名称 0 ECM 接口 描述 用于 ECM 配置管理。 端点地址： EC200A 系 列 /EC200M-CN/EC200N-CN/EC200S 系 列 /EC600MCN/EC600N-CN/EC800M-CN/EC800N-CN/EG810M-CN/EG912N- 上海移远通信技术股份有限公司 7 / 24 LTE Standard(A)系列 USB 描述符介绍 EN/EG912Y-EU/EG915N 系列/EG950A-EL：0x87。 1 ECM 接口 用于 ECM 数据通信 2 移动诊断接口 诊断端口 3 AT 接口 用于 AT 命令传输 4 Modem 接口 用于 PPP 连接 有关各接口的接口描述符，请参考第 3.3 章。 上海移远通信技术股份有限公司 8 / 24 LTE Standard(A)系列 USB 描述符介绍 3 USB 描述符 LTE Standard(A)系列模块为 USB 复合通信设备。待模块 USB 驱动安装到 Windows 或 Linux 操作系 统后，操作系统自动读取模块的设备描述符以及配置描述符，同时根据配置描述符下的接口描述符创建指 定接口。 本章节主要介绍了 LTE Standard(A)系列模块的设备描述符、配置描述符、接口描述符以及端点描述 符（字符串描述符客户无需使用）。 备注 1. 若配置网卡拨号方式为 ECM，Linux 系统自动读取描述符信息，但 Windows 系统需先安装 ECM 驱 动后方可实现自动读取。 2. 若配置网卡拨号方式为 RNDIS，Linux 系统和 Windows 系统均可自动读取描述符。 3.1. 设备描述符 本章节介绍 LTE Standard(A)系列模块的 USB 设备描述符。 表 4：设备描述符 参数名称 bLength bDescriptorType bcdUSB bDeviceClass bDeviceSubClass bDeviceProtocol 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 18 1 设备适用的 USB 协议版本 512 设备类型代码 239 设备子类型代码，由设备类型代 码分配 2 协议代码 1 值 十六进制 描述 0x12 18 字节 0x01 0x0200 0xEF 设备描述符 USB 2.0 版本 239 0x2 2 0x1 IAD – 接 口 关 上海移远通信技术股份有限公司 9 / 24 LTE Standard(A)系列 USB 描述符介绍 端点 0 最大分组大小。 bMaxPacketSize0 单位：字节。 64 idVendor 供应商ID 11388 idProduct bcdDevice iManufacturer iProduct iSerialNumber bNumConfigurations 产品ID EC200A系列/ EG950A-EL EC200M-CN/ EC200N-CN/ EC200S系列/ EC600M-CN/ EC600N-CN/ EC800M-CN/ EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU（R03）/ EG915N 系列 24581 24578 EG912Y-EU（R01） 24577 设备出厂编码 792 厂商字符串描述符索引 1 产品字符串描述符索引 2 设备序列号字符串描述符索引 3 设备的配置描述符的个数 1 联描述符 0x40 0x2C7C 0x6005 0x6002 0x6001 0x0318 0x01 0x02 0x03 0x01 64字节 上海移远通信 技术股份有限 公司 EC200A/ EG950A EC200M/ EC200N/ EC200S/ EC600M/ EC600N/ EC800M/ EC800N/ EG810M/ EG912N/ EG912Y/ EG915N EG912Y 792 'Android' 'Android' 随机字符串 1 上海移远通信技术股份有限公司 10 / 24 LTE Standard(A)系列 USB 描述符介绍 3.2. 配置描述符 本章节介绍了 LTE Standard(A)系列模块的 USB 配置描述符。 表 5：USB 配置描述符 参数名称 bLength bDescriptorType wTotalLength bNumInterface bConfigurationValue iConfiguration bmAttributes bmAttributes.Reserved D7 bmAttributes.SelfPowered D6 bmAttributes.RemoteWakeup D5 bmAttributes.Reserved D4..0 bMaxPower 参数解释 值 十进制 十六进制 描述符大小。 单位：字节。 9 0x09 描述符类型 2 该配置返回的数据总长度。 单位：字节。 209 0x02 0x00D1 该配置支持的接口数 5 配置值。仅在设备驱动的系统 软件部分需要时使用。 1 描述该配置描述符的字符串描 述符索引 0 USB 设备特性 224 bmAttributes 的 第 7 个 字 节 为 预留 1 是 否 通 过 USB_VBUS 给 USB 设备供电 1 0x05 0x01 0x00 0xE0 0x01 0x01 远程唤醒 1 0x01 bmAttributes 的 第 4 个 字 节 为 预留 0 USB设备全功能运行时该配置 需要消耗的电流。 250 单位：2 mA。 0x00 0xFA 描述 9 字节 配置描述符 209 字节 5 个接口 配置 1 0 224 1 是 是 0 500 mA 上海移远通信技术股份有限公司 11 / 24 LTE Standard(A)系列 USB 描述符介绍 3.3. 接口描述符 本章节介绍了 LTE Standard(A)系列模块的 USB 接口描述符。 3.3.1. 接口 0（ECM 接口） 表 6：接口 0 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 0 用来识别同一个接口的不同 接口描述符 0 接口使用的端点数 1 接口类型代码 2 接口子类型代码 6 接口协议代码 0 接口字符串描述符的索引 5 值 十六进制 描述 0x09 9 字节 0x04 0x00 接口描述符 0 0x00 0 0x01 0x02 0x06 0x00 0x05 1 个端点 通信以及CDC控制 以太网控制模型 无类型特定协议 字符串描述符5 3.3.1.1. 端点描述符 1 表 7：接口 0 的端点描述符 1 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 值 十进制 十六进制 描述 7 0x07 7 字节 5 0x05 端点描述符 上海移远通信技术股份有限公司 12 / 24 LTE Standard(A)系列 USB 描述符介绍 bEndpointAddress bmAttributes wMaxPacketSize bInterval EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 端点地址 EC800M-CN/ 135 EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 3 本端点可接收或发送最大分组 包大小。单位：字节。 64 数据传输中断发生时，轮询数据 传送端点的时间间隔。 16 单位：毫秒。 0x87 Direction = IN EndpointID = 7 0x03 TransferType = Interrupt 0x0040 64 字节 0x10 16毫秒 3.3.2. 接口 1（ECM 接口） 表 8：接口 1 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 1 用来识别同一个接口的不同接 口描述符 1 接口使用的端点数 2 接口类型代码 10 接口子类型代码 0 接口协议代码 0 值 十六进制 描述 0x09 9 字节 0x04 0x01 接口描述符 1 0x01 1 0x02 0x0A 2 个端点 CDC - 数据 0x00 0 0x00 0 上海移远通信技术股份有限公司 13 / 24 iInterface LTE Standard(A)系列 USB 描述符介绍 接口字符串描述符的索引 0 0x00 0 3.3.2.1. 端点描述符 1 表 9：接口 1 的端点描述符 1 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 十进制 十六进制 描述符大小。 单位：字节。 7 0x07 描述符类型 5 0x05 端点地址 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ EC800M-CN/ EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 131 0x83 端点传输类型，2-bitmap。 2 0x02 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 0x0200 0x00 值 描述 7 字节 端点描述符 Direction = IN EndpointID = 3 TransferType = Bulk 512 字节 0 上海移远通信技术股份有限公司 14 / 24 LTE Standard(A)系列 USB 描述符介绍 3.3.2.2. 端点描述符 2 表 10：接口 1 的端点描述符 2 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 十进制 十六进制 描述符大小。 单位：字节。 7 0x07 描述符类型 5 0x05 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 端点地址 EC800M-CN/ 12 0x0C EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 2 0x02 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 0x0200 0x00 值 描述 7 字节 端点描述符 Direction = OUT EndpointID = 12 TransferType = Bulk 512 字节 0 3.3.3. 接口 2（移动诊断接口） 表 11：接口 2 的接口描述符 参数名称 bLength 参数解释 描述符大小。 单位：字节。 十进制 9 值 十六进制 0x09 描述 9 字节 上海移远通信技术股份有限公司 15 / 24 LTE Standard(A)系列 USB 描述符介绍 bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 描述符类型 4 接口编号 2 用来识别同一个接口的不同 接口描述符 0 接口使用的端点数 2 接口类型代码 255 接口子类型代码 0x00 接口协议代码 0x00 接口字符串描述符的索引 8 0x04 0x02 0x00 0x02 0xFF 0 0 0x08 接口描述符 2 0 2 个端点 特定供应商 0x00 0x00 字符串描述符8 3.3.3.1. 端点描述符 1 表 12：接口 2 的端点描述符 1 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize 参数解释 十进制 描述符大小。 单位：字节。 7 描述符类型 5 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 端点地址 EC800M-CN/ 130 EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 值 十六进制 描述 0x07 7 字节 0x05 端点描述符 0x82 Direction = IN EndpointID = 2 0x02 0x0200 TransferType = Bulk 512 字节 上海移远通信技术股份有限公司 16 / 24 bInterval LTE Standard(A)系列 USB 描述符介绍 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 0x00 0 3.3.3.2. 端点描述符 2 表 13：接口 2 的端点描述符 2 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 十进制 描述符大小。 单位：字节。 7 描述符类型 5 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 端点地址 EC800M-CN/ 11 EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 端点描述符 0x0B Direction = OUT EndpointID = 11 0x02 0x0200 TransferType = Bulk 512 字节 0x00 0 上海移远通信技术股份有限公司 17 / 24 LTE Standard(A)系列 USB 描述符介绍 3.3.4. 接口 3（AT 接口） 表 14：接口 3 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 3 用来识别同一个接口的不同 接口描述符 0 接口使用的端点数 3 接口类型代码 255 接口子类型代码 0 接口协议代码 0 接口字符串描述符的索引 11 值 十六进制 描述 0x09 9 字节 0x04 0x03 接口描述符 3 0x00 0 0x03 0xFF 0x00 0x00 0x0B 3 个端点 255 0 0 字符串描述符11 3.3.4.1. 端点描述符 1 表 15：接口 3 的端点描述符 1 参数名称 参数解释 bLength bDescriptorType bEndpointAddress 描述符大小。 单位：字节。 描述符类型 端点地址 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 值 十进制 十六进制 描述 7 0x07 7 字节 5 0x05 端点描述符 137 0x89 Direction = IN EndpointID = 9 上海移远通信技术股份有限公司 18 / 24 LTE Standard(A)系列 USB 描述符介绍 bmAttributes wMaxPacketSize bInterval EC800M-CN/ EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 3 本端点可接收或发送最大分组 包大小。单位：字节。 64 数据传输中断发生时，轮询数据 传送端点的时间间隔。 16 单位：毫秒。 0x03 0x0040 TransferType = Interrupt 64 字节 0x10 16毫秒 3.3.4.2. 端点描述符 2 表 16：接口 3 的端点描述符 2 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize 参数解释 十进制 描述符大小。 单位：字节。 7 描述符类型 5 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 端点地址 EC800M-CN/ 134 EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 值 十六进制 描述 0x07 7 字节 0x05 端点描述符 0x86 Direction = IN EndpointID = 6 0x02 0x0200 TransferType = Bulk 512 字节 上海移远通信技术股份有限公司 19 / 24 bInterval LTE Standard(A)系列 USB 描述符介绍 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 0x00 0 3.3.4.3. 端点描述符 3 表 17：接口 3 的端点描述符 3 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 十进制 描述符大小。 单位：字节。 7 描述符类型 5 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 端点地址 EC800M-CN/ 15 EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 端点描述符 0x0F Direction = OUT EndpointID = 15 0x02 0x0200 TransferType = Bulk 512 字节 0x00 0 上海移远通信技术股份有限公司 20 / 24 LTE Standard(A)系列 USB 描述符介绍 3.3.5. 接口 4（Modem 接口） 表 18：接口 4 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 4 用来识别同一个接口的不同 接口描述符 0 接口使用的端点数 3 接口类型代码 255 接口子类型代码 0 接口协议代码 0 接口字符串描述符的索引 11 值 十六进制 描述 0x09 9 字节 0x04 0x04 接口描述符 4 0x00 0 0x03 0xFF 0x00 0x00 0x0B 3 个端点 特定供应商 0 0 字符串描述符11 3.3.5.1. 端点描述符 1 表 19：接口 4 的端点描述符 1 参数名称 参数解释 bLength bDescriptorType bEndpointAddress 描述符大小。 单位：字节。 描述符类型 端点地址 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 值 十进制 十六进制 描述 7 0x07 7 字节 5 0x05 端点描述符 136 0x88 Direction = IN EndpointID = 8 上海移远通信技术股份有限公司 21 / 24 LTE Standard(A)系列 USB 描述符介绍 bmAttributes wMaxPacketSize bInterval EC800M-CN/ EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 3 本端点可接收或发送最大分组 包大小。单位：字节。 64 数据传输中断发生时，轮询数据 传送端点的时间间隔。 16 单位：毫秒。 0x03 0x0040 TransferType = Interrupt 64 字节 0x10 16毫秒 3.3.5.2. 端点描述符 2 表 20：接口 4 的端点描述符 2 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize 参数解释 十进制 描述符大小。 单位：字节。 7 描述符类型 5 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 端点地址 EC800M-CN/ 129 EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 值 十六进制 描述 0x07 7 字节 0x05 端点描述符 0x81 Direction = IN EndpointID = 1 0x02 0x0200 TransferType = Bulk 512 字节 上海移远通信技术股份有限公司 22 / 24 bInterval LTE Standard(A)系列 USB 描述符介绍 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 0x00 0 单位：毫秒。 3.3.5.3. 端点描述符 3 表 21：接口 4 的端点描述符 3 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 十进制 描述符大小。 单位：字节。 7 描述符类型 5 EC200A 系列/ EC200M-CN/ EC200N-CN/ EC200S 系列/ EC600M-CN/ EC600N-CN/ 端点地址 EC800M-CN/ 10 EC800N-CN/ EG810M-CN/ EG912N-EN/ EG912Y-EU/ EG915N 系列/ EG950A-EL 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 端点描述符 0x0A Direction = OUT EndpointID = 10 0x02 TransferType = Bulk 0x0200 512 字节 0x00 0 上海移远通信技术股份有限公司 23 / 24 LTE Standard(A)系列 USB 描述符介绍 4 附录 术语缩写 表 22：术语缩写 缩写 CDC ECM IAD PPP USB 英文全称 Communications Device Class Ethernet Networking Control Model Interface Association Descriptor Point to Point Protocol Universal Serial Bus 中文全称 USB 通信设备类 以太网控制模型 接口关联描述符 点对点协议 通用串行总线 上海移远通信技术股份有限公司 24 / 24

LTE Standard(A)系列 SSL 应用指导 LTE Standard 模块系列 版本：1.2 日期：2022-08-05 状态：受控文件 LTE Standard(A)系列 SSL 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 33 LTE Standard(A)系列 SSL 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 33 LTE Standard(A)系列 SSL 应用指导 文档历史 修订记录 版本 1.0 日期 2020-08-31 2021-04-16 1.1 2022-03-02 1.2 2022-08-05 作者 Luffy LIU Luffy LIU Luffy LIU/ Larson LI Luffy LIU/ Larson LI 变更表述 文档创建 受控版本 1. 增加文档适用模块 EC200A 系列、EC800N-CN 和 EG915N-EU。 2. 删除 EG912Y-CN 模块。 1. 新 增 适 用 模 块 EC200M-CN 、 EC600M-CN 、 EC800M-CN、EG915N-LA 和 EG912N-EN。 2. 删除适用模块 EC200T 系列。 上海移远通信技术股份有限公司 3 / 33 LTE Standard(A)系列 SSL 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 1.2. SSL 版本和加密套件 ................................................................................................................... 8 1.3. SSL 功能使用流程..................................................................................................................... 10 1.4. 数据访问模式说明 ..................................................................................................................... 10 1.5. 证书有效性验证 ......................................................................................................................... 11 1.6. 服务器名称指示 ......................................................................................................................... 11 2 SSL AT 命令详解 ................................................................................................................................. 12 2.1. AT 命令说明............................................................................................................................... 12 2.1.1. 定义 ................................................................................................................................ 12 2.1.2. AT 命令语句.................................................................................................................... 12 2.1.3. AT 示例声明.................................................................................................................... 13 2.2. SSL 相关 AT 命令描述............................................................................................................... 13 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 ...................................................................... 13 2.2.2. AT+QSSLOPEN 打开 SSL Socket 连接远程服务器.................................................... 19 2.2.3. AT+QSSLSEND 通过 SSL 连接发送数据.................................................................... 21 2.2.4. AT+QSSLRECV 通过 SSL 连接接收数据.................................................................... 22 2.2.5. AT+QSSLCLOSE 关闭 SSL 连接 ................................................................................ 23 2.2.6. AT+QSSLSTATE 查询 Socket 连接状态...................................................................... 23 2.3. URC 详解 .................................................................................................................................. 25 2.3.1. +QSSLURC: 'recv' 通知主机接收数据........................................................................ 25 2.3.2. +QSSLURC: 'closed' 通知异常断开连接 .................................................................... 25 3 举例 ...................................................................................................................................................... 26 3.1. 配置并激活 PDP 上下文 ............................................................................................................ 26 3.1.1. 配置 PDP 上下文 ............................................................................................................ 26 3.1.2. 激活 PDP 上下文 ............................................................................................................ 26 3.1.3. 去激活 PDP 上下文 ........................................................................................................ 26 3.2. 配置 SSL 上下文........................................................................................................................ 26 3.3. SSL 客户端在缓存模式下工作................................................................................................... 27 3.3.1. 建立 SSL 连接并进入缓存模式....................................................................................... 27 3.3.2. 缓存模式下发送数据....................................................................................................... 27 3.3.2.1. 发送不定长数据..................................................................................................... 27 3.3.2.2. 发送定长数据 ........................................................................................................ 27 3.3.3. 缓存模式下接收数据....................................................................................................... 27 3.3.4. 关闭 SSL 连接 ................................................................................................................ 28 3.4. SSL 客户端在直吐模式下工作................................................................................................... 28 3.4.1. 建立 SSL 连接并进入直吐模式....................................................................................... 28 上海移远通信技术股份有限公司 4 / 33 LTE Standard(A)系列 SSL 应用指导 3.4.2. 直吐模式下发送数据....................................................................................................... 28 3.4.3. 直吐模式下接收数据....................................................................................................... 29 3.4.4. 关闭 SSL 连接 ................................................................................................................ 29 3.5. SSL 客户端在透传模式下工作................................................................................................... 29 3.5.1. 建立 SSL 连接并在透传模式下发送数据 ........................................................................ 29 3.5.2. 建立 SSL 连接并在透传模式下接收数据 ........................................................................ 29 3.5.3. 关闭 SSL 连接 ................................................................................................................ 29 4 SSL 连接失败原因的排查..................................................................................................................... 30 5 结果码 .................................................................................................................................................. 31 6 附录 参考文档及术语缩写 ................................................................................................................... 33 上海移远通信技术股份有限公司 5 / 33 LTE Standard(A)系列 SSL 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：SSL 版本 ............................................................................................................................................ 8 表 3：支持的 SSL 加密套件 ......................................................................................................................... 8 表 4：AT 命令类型...................................................................................................................................... 12 表 5：结果码............................................................................................................................................... 31 表 6：参考文档 ........................................................................................................................................... 33 表 7：术语缩写 ........................................................................................................................................... 33 上海移远通信技术股份有限公司 6 / 33 LTE Standard(A)系列 SSL 应用指导 1 引言 本文档介绍如何使用移远通信 LTE Standard(A)系列模块的 SSL 功能。 SSL（Secure Sockets Layer，安全套接层）是为网络通信提供安全及数据完整性的一种安全协议。 为确保通信的私密性，在某些情况下，服务器和客户端之间的通信应采用加密方式，以防止在通信过 程中数据被窃听、篡改或伪造。SSL 功能可以满足上述要求。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N-CN EC200S 系列 EC600M-CN EC600N-CN EC600S-CN EC800M-CN EC800N-CN EG912N-EN EG912Y-EU EG915N 系列 上海移远通信技术股份有限公司 7 / 33 LTE Standard(A)系列 SSL 应用指导 1.2. SSL 版本和加密套件 下表为移远通信 LTE Standard(A)系列模块支持的 SSL 版本。 表 2：SSL 版本 SSL 版本 SSL 3.0 TLS 1.2 TLS 1.1 TLS 1.0 下表为移远通信 LTE Standard(A)系列模块支持的 SSL 加密套件。默认支持所有加密套件。有关加密 套件的详细说明，请参考 RFC 2246-The TLS Protocol Version 1.0。 表 3：支持的 SSL 加密套件 加密套件代码 0X0035 0X002F 0X0005 0X0004 0X000A 0X003D 0XC002 0XC003 0XC004 0XC005 0XC007 0XC008 加密套件名称 TLS_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA256 TLS_ECDH_ECDSA_WITH_RC4_128_SHA TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA TLS_ECDHE_ECDSA_WITH_RC4_128_SHA TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 上海移远通信技术股份有限公司 8 / 33 0XC009 0XC00A 0XC011 0XC012 0XC013 0XC014 0xC00C 0XC00D 0XC00E 0XC00F 0XC023 0xC024 0xC025 0xC026 0XC027 0XC028 0xC029 0XC02A 0XC02F 0XC030 0XFFFF LTE Standard(A)系列 SSL 应用指导 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA TLS_ECDHE_RSA_WITH_RC4_128_SHA TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA TLS_ECDH_RSA_WITH_RC4_128_SHA TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA TLS_ECDH_RSA_WITH_AES_128_CBC_SHA TLS_ECDH_RSA_WITH_AES_256_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 支持以上所有加密套件 上海移远通信技术股份有限公司 9 / 33 LTE Standard(A)系列 SSL 应用指导 1.3. SSL 功能使用流程 步骤 1: 通过 AT+QICSGP 配置 PDP 上下文的、、和其他参数。详 细信息请参考文档 [1]。 步骤 2: 通过 AT+QIACT 激活 PDP 上下文。成功激活上下文后，可通过 AT+QIACT?查询分配的 IP 地址。详细信息请参考文档 [1]。 步骤 3: 通过 AT+QSSLCFG 配置指定 SSL 上下文的 SSL 版本、加密套件、受信任 CA 证书路径及身 份验证模式。 步骤 4: 通过 AT+QSSLOPEN 打开 SSL socket 连接远程服务器。 步骤 5: SSL 连接成功建立后，将通过该连接收发数据。每个模式下数据收发的详情请参考第 1.4 章。 步骤 6: 通过 AT+QSSLCLOSE 关闭 SSL 连接。 步骤 7: 通过 AT+QIDEACT 去激活 PDP 上下文。详细信息请参考文档 [1]。 1.4. 数据访问模式说明 SSL 连接支持以下 3 种数据访问模式： ⚫ 缓存模式 ⚫ 直吐模式 ⚫ 透传模式 当使用 AT+QSSLOPEN 打开 SSL 连接时，可以通过来指定数据访问模式；SSL 连 接成功创建后，可以通过 AT+QISWTMD 切换数据访问模式。关于 AT+QISWTMD 的详细信息，可参考文 档 [1]。 1. 缓存模式下，可以通过 AT+QSSLSEND 发送数据。从网络接收数据时，模块将上报 URC： +QSSLURC: 'recv',，之后用户可以通过 AT+QSSLRECV 来读取缓存数据。 2. 直吐模式下，可以通过 AT+QSSLSEND 发送数据。从网络接收数据时，数据会以如下格式直接输 出 到 UART/ USB modem/ USB AT 口 ： +QSSLURC: 'recv',,。 3. 透传模式下，相应端口会进入独占模式，从网络接收到的数据会从 COM 口直接输出。+++或者 DTR（需先执行 AT&D1）可用于退出透传模式。若服务器异常断开 SSL 连接，将上报结果码 NO CARRIER。关于 AT&D 的详细信息，可参考文档 [3]。 上海移远通信技术股份有限公司 10 / 33 LTE Standard(A)系列 SSL 应用指导 ⚫ 退出透传模式 用户可以通过+++或者 DTR（需先执行 AT&D1）两种方式退出透传模式，为了防止+++被当成数据发 送，实际操作过程中必须注意以下几点： 1） +++输入前 1 秒或更长时间内不能输入其它任何数据； 2） 必须在 1 秒内输入+++，并且不能输入其它任何数据； 3） +++输入后 1 秒内不能输入其它任何数据； 4） 通过+++或者 DTR（需先执行 AT&D1）方式使模块退出透传模式，直到模块返回 OK。 ⚫ 切换到透传模式 1） 通过执行 AT+QISWTMD：执行命令时，指定为 2，返回 CONNECT，表示成功 切换到透传模式。 2） 通过执行 ATO：退出透传模式后，可通过 ATO 再切换回至透传模式；若返回 CONNECT，则表示 成功切换至透传模式。若连接访问模式前模块未进入过透传模式，执行 ATO 则会返回 NO CARRIER。关于 ATO 的详细信息，可参考文档 [3]。 1.5. 证书有效性验证 检查证书是否在有效期内，必须对证书进行解析，并将本地时间与证书的'不早于'时间和'不晚于' 时间相比较。如果本地时间早于'不早于'的时间或晚于'不晚于'的时间，则证书将被视为已过期。 若需要进行证书有效性验证（通过 AT+QSSLCFG 设置=0），为避免验证失败，应使 用 AT+CCLK 将模块本地时间配置在证书有效期内。关于 AT+CCLK 的详细信息，可参考文档 [3]。 1.6. 服务器名称指示 客户端期望 SNI（服务器名称指示）提供服务器主机名称信息，以增强与基于单个 IP 地址的多个虚拟 服务器的安全连接。该功能仅适用于 TLS 协议。 上海移远通信技术股份有限公司 11 / 33 LTE Standard(A)系列 SSL 应用指导 2 SSL AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 4：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 12 / 33 LTE Standard(A)系列 SSL 应用指导 2.1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.2. SSL 相关 AT 命令描述 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 该命令用于配置 SSL 上下文的 SSL 版本、加密套件、受信任 CA 证书路径、身份验证模式、客户端证 书和客户端密钥路径等 SSL 配置。这些参数将在握手过程中使用。 是 SSL 上下文的索引。模块最多支持 6 个 SSL 上下文。可以基于一个 SSL 上下文建立 多个 SSL 连接。SSL 版本和加密套件的设置存储在 SSL 上下文中，并将应用于与该 SSL 上下文关联的新 SSL 连接。 AT+QSSLCFG 配置 SSL 上下文的参数 测试命令 AT+QSSLCFG=? 响应 +QSSLCFG: 'sslversion',(支持的范围),(支持 的范围) +QSSLCFG: 'ciphersuite',(支持的范围),(支持 的列表) +QSSLCFG: 'cacert',(支持的范围), +QSSLCFG: 'cacertex',(支持的范围), +QSSLCFG: 'clientcert',(支持的范围), +QSSLCFG: 'clientkey',(支持的范围), +QSSLCFG: 'seclevel',(支持的范围),(支持的 范围) +QSSLCFG: 'ignorelocaltime',(支持的范围), (支持的列表) +QSSLCFG: 'negotiatetime',(支持的范围), (支持的范围) +QSSLCFG: 'sni',(支持的范围),(支持的 列表) +QSSLCFG: 'closetimemode',(支持的范围), (支持的列表) +QSSLCFG: 'ignoremulticertchainverify',(支持的范围),(支持的列表) +QSSLCFG: 'ignoreinvalidcertsign',(支持的 范围),(支持的列表) +QSSLCFG: 'session_cache',(支持的范围), (支持的列表) 设置命令 配置指定 SSL 上下文的 SSL 版本： AT+QSSLCFG='sslversion',[,] OK 响应 若省略可选参数，则查询指定 SSL 上下文的 SSL 版本： +QSSLCFG: 'sslversion',, OK 设置命令 配置指定 SSL 上下文的加密套件： AT+QSSLCFG='ciphersuite',[,] 若指定可选参数，则配置指定 SSL 上下文的 SSL 版本： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的加密套件： +QSSLCFG: 'ciphersuite',, OK 设置命令 配置指定 SSL 上下文的受信任 CA 证书 路径： AT+QSSLCFG='cacert', [,] 若指定可选参数，则配置指定 SSL 指定上下文的加密套件： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的受信任 CA 证书路 径： +QSSLCFG: 'cacert',, OK 设置命令 配置指定 SSL 上下文的受信任 CA 证书 路径： AT+QSSLCFG='cacertex'[,[,]] 若指定可选参数，则配置指定 SSL 上下文的受信任 CA 证书路 径： OK 或者 ERROR 响应 若省略全部可选参数，则查询全部 SSL 上下文的受信任 CA 证 书路径： +QSSLCFG: 'cacertex',0, ….. 上海移远通信技术股份有限公司 14 / 33 LTE Standard(A)系列 SSL 应用指导 +QSSLCFG: 'cacertex',5, OK 若只省略，则查询指定 SSL 上下文的受信任 CA 证书路径： +QSSLCFG: 'cacertex',, OK 若指定全部可选参数，则配置指定 SSL 上下文的受信任 CA 证 书路径： OK 或者 ERROR 设置命令 响应 配置指定 SSL 上下文的客户端证书路径： 若省略可选参数，则查询指定 SSL 上下文的客户端证书路径： AT+QSSLCFG='clientcert',<SSL_ctx +QSSLCFG:'clientcert',, ID>[,] OK 设置命令 配置指定 SSL 上下文的客户端密钥： AT+QSSLCFG='clientkey',[,] 若指定可选参数，则配置指定 SSL 上下文的客户端证书路径： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的客户端密钥： +QSSLCFG: 'clientkey',, OK 设置命令 配置指定 SSL 上下文的身份验证模式： AT+QSSLCFG='seclevel',[,] 若指定可选参数，则配置指定 SSL 上下文的客户端密钥： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的身份验证模式： +QSSLCFG: 'seclevel',, OK 若省略可选参数，则配置指定 SSL 上下文的身份验证模式： OK 或者 上海移远通信技术股份有限公司 15 / 33 LTE Standard(A)系列 SSL 应用指导 ERROR 设置命令 响应 配置指定 SSL 上下文是否忽略证书有效 若省略可选参数，则查询指定 SSL 上下文是否忽略证书有效性 性验证： 验证： AT+QSSLCFG='ignorelocaltime',<S +QSSLCFG: 'ignorelocaltime',,[,] e> OK 设置命令 配置指定 SSL 上下文在 SSL 协商阶段的 最大超时时间： AT+QSSLCFG='negotiatetime',[,] 若指定可选参数，则配置指定 SSL 上下文是否忽略证书有效性 验证： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文在 SSL 协商阶段的最 大超时时间： +QSSLCFG: 'negotiatetime',, OK 若指定可选参数，则配置指定 SSL 上下文在 SSL 协商阶段的最 大超时时间： OK 或者 设置命令 ERROR 响应 打开或关闭指定 SSL 上下文的服务器名 若省略可选参数，则查询指定 SSL 上下文是否打开服务器名称 称指示功能： 指示功能： AT+QSSLCFG='sni',[,< +QSSLCFG: 'sni',, SNI>] OK 设置命令 启用或禁用指定 SSL 上下文的关闭 SSL 连接的延迟时间： AT+QSSLCFG='closetimemode',[,] 若指定可选参数，则打开或关闭指定 SSL 上下文的服务器名称 指示功能： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文是否启用延迟时间： +QSSLCFG: 'closetimemode',, 上海移远通信技术股份有限公司 16 / 33 LTE Standard(A)系列 SSL 应用指导 OK 若指定可选参数，则启用或禁用指定 SSL 上下文的 SSL 关闭延 迟时间： OK 或者 设置命令 ERROR 响应 配置指定 SSL 上下文是否忽略多级证书 若省略可选参数，则查询指定 SSL 上下文是否忽略多级证书链 链验证： 验证： AT+QSSLCFG='ignoremulticertchain +QSSLCFG: 'ignoremulticertchainverify',,<i verify',[, ertchain_verify>] OK 若指定可选参数，则配置指定 SSL 上下文是否忽略多级证书链 验证： OK 或者 设置命令 ERROR 响应 配置指定 SSL 上下文是否忽略无效证书 若省略可选参数，则查询指定 SSL 上下文是否忽略无效证书签 签名： 名： +QSSLCFG='ignoreinvalidcertsign', +QSSLCFG: 'ignoreinvalidcertsign',,<ignor [, gn>] OK 若省略可选参数，则配置指定 SSL 上下文是否忽略无效证书签 名： OK 或者 设置命令 ERROR 响应 打开或关闭指定 SSL 上下文的会话恢复 若省略可选参数，则查询指定 SSL 上下文是否打开会话恢复功 功能： 能： AT+QSSLCFG='session_cache',<SS +QSSLCFG: 'session_cache',,[,] che_enable> OK 若指定可选参数，则打开或关闭指定 SSL 上下文的会话恢复功 能： OK 上海移远通信技术股份有限公司 17 / 33 LTE Standard(A)系列 SSL 应用指导 最大响应时间 特性说明 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。SSL 上下文标识符。范围：0~5。 整型。SSL 版本。 0 SSL 3.0 1 TLS 1.0 2 TLS 1.1 3 TLS 1.2 4 全部 十六进制数值。SSL 加密套件。 0X0035 TLS_RSA_WITH_AES_256_CBC_SHA 0X002F TLS_RSA_WITH_AES_128_CBC_SHA 0X0005 TLS_RSA_WITH_RC4_128_SHA 0X0004 TLS_RSA_WITH_RC4_128_MD5 0X000A TLS_RSA_WITH_3DES_EDE_CBC_SHA 0X003D TLS_RSA_WITH_AES_256_CBC_SHA256 0XC002 TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0XC003 TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0XC004 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0XC005 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0XC007 TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0XC008 TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0XC009 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0XC00A TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0XC011 TLS_ECDHE_RSA_WITH_RC4_128_SHA 0XC012 TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0XC013 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0XC014 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC00C TLS_ECDH_RSA_WITH_RC4_128_SHA 0XC00D TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0XC00E TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0XC00F TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0XC023 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC024 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC025 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC026 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0XC027 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 上海移远通信技术股份有限公司 18 / 33 LTE Standard(A)系列 SSL 应用指导 0XC028 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC029 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0XC02A TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0XC02F TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0XC030 MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0XFFFF 支持所有加密套件 整型。是否忽略证书有效性验证。 0 不忽略 1 忽略 字符串类型。受信任 CA 证书路径。 字符串类型。客户端证书路径。 字符串类型。客户端密钥路径。 字符串类型。身份验证模式。 0 无身份验证模式 1 进行服务器身份验证 2 如果远程服务器要求，则进行服务器和客户端身份验证 整型。表示 SSL 协商阶段的最大超时时间。范围：10~300；默认值： 300；单位：秒。 整型。打开或关闭服务器名称指示功能。 0 关闭 1 打开 整型。启用或禁用关闭 SSL 连接的延迟。 0 禁用，此时关闭延迟时间的单位为秒 1 启用，此时 SSL 关闭延迟时间的单位为毫秒 整型。表示是否忽略多级证书链验证。 0 不忽略 1 忽略 整型。表示是否忽略无效证书签名。 0 不忽略 1 忽略 整型。打开或关闭 SSL 会话恢复功能。 0 关闭 1 打开 2.2.2. AT+QSSLOPEN 打开 SSL Socket 连接远程服务器 该命令用于建立 SSL 连接，即打开 SSL socket 连接远程服务器。在模块和网络协商期间， AT+QSSLCFG 将用于握手过程中的参数配置。与网络成功握手后，模块可以通过此 SSL 连接发送或接收 数据，还可以基于一个 SSL 上下文建立多个 SSL 连接。 根据第 1.2 章中的步骤，需先执行 AT+QIACT 以激活 PDP 上下文，然后执行 AT+QSSLOPEN。等待 指定的时间（可参考下面的最大响应时间）后将输出 URC +QSSLOPEN: ,。如果在此期 间未收到 URC 响应，则可以使用 AT+QSSLCLOSE 关闭 SSL 连接。 上海移远通信技术股份有限公司 19 / 33 LTE Standard(A)系列 SSL 应用指导 AT+QSSLOPEN 打开 SSL Socket 连接远程服务器 测试命令 AT+QSSLOPEN=? 响应 +QSSLOPEN: (支持的范围),(支持的范围),(支持的范围),,[,(支持的范围)] 设置命令 AT+QSSLOPEN=,,,,[,] OK 响应 若=2 并且成功建立 SSL 连接： CONNECT 若有任何错误： ERROR 若=0/1： OK +QSSLOPEN: , 当=0，表示成功打开 SSL socket；否则，表示打开 SSL socket 失败： 最大响应时间 特性说明 若有任何错误： ERROR 最大网络响应时间为 150 秒，需再加上配置 的时间 / 参数 整型。PDP 上下文标识符。范围：1~15。 整型。SSL 上下文标识符。范围：0~5。 整型。Socket 索引。范围：0~11。 字符串类型。远程服务器地址。 整型。远程服务器监听端口。 整型。表示 SSL 连接的数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 整型。操作结果码。详细信息请参考第 5 章。 整型。表示 SSL 协商阶段的最大超时时间。范围：10~300；默认值：300；单位： 秒。 上海移远通信技术股份有限公司 20 / 33 LTE Standard(A)系列 SSL 应用指导 2.2.3. AT+QSSLSEND 通过 SSL 连接发送数据 建立 SSL 连接后，模块可以通过该连接发送数据。 AT+QSSLSEND 通过 SSL 连接发送数据 测试命令 AT+QSSLSEND=? 响应 +QSSLSEND: (支持的范围)[,(支持的 范围)] 设置命令 发送不定长数据 AT+QSSLSEND= OK 响应 > 响应>后，输入要发送的数据。点击 CTRL+Z 发送，点击 ESC 取消操作。 若已建立 SSL 连接且数据发送成功： SEND OK 若已建立 SSL 连接但缓存已满： SEND FAIL 设置命令 发送定长数据 AT+QSSLSEND=, 若 SSL 连接未建立、异常断开或参数错误： ERROR 响应 > 响应>后，输入要发送的数据，直至数据长度达到 配置的长度。 若已建立 SSL 连接且数据发送成功： SEND OK 若已建立 SSL 连接但缓存已满： SEND FAIL 最大响应时间 特性说明 若 SSL 连接未建立、异常断开或参数错误： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 21 / 33 LTE Standard(A)系列 SSL 应用指导 参数 整型。Socket 索引。范围：0~11。 整型。发送数据的长度。范围：1~1460；单位：字节。 备注 发送的数据包括定长数据和不定长数据，最大长度都为 1460 个字节。 2.2.4. AT+QSSLRECV 通过 SSL 连接接收数据 当 SSL 连接的数据访问模式为缓存模式时，模块收到网络发送的数据时将上报 URC +QSSLURC: 'recv',。可以通过 AT+QSSLRECV 读取缓存的数据。 AT+QSSLRECV 通过 SSL 连接接收数据 测试命令 AT+QSSLRECV=? 响应 +QSSLRECV: (支持的范围),(支持的范 围) 设置命令 AT+QSSLRECV=, OK 响应 若指定 Socket 连接接收到数据： +QSSLRECV: OK 若缓冲区为空： +QSSLRECV: 0 OK 最大响应时间 特性说明 若 SSL 连接未建立、异常断开或参数错误： ERROR 300 毫秒 / 参数 整型。Socket 索引。范围：0~11。 整型。需读取数据的最大长度。范围：0~1500；单位：字节；默认值：1500。 整型。通过 AT+QSSLRECV 读取的数据实际长度。单位：字节。 上海移远通信技术股份有限公司 22 / 33 LTE Standard(A)系列 SSL 应用指导 字符串类型。实际读取的数据。单位：字节。 2.2.5. AT+QSSLCLOSE 关闭 SSL 连接 该命令用于关闭 SSL 连接。如果基于同一 SSL 上下文的所有 SSL 连接都已关闭，则模块将释放 SSL 上下文。 AT+QSSLCLOSE 关闭 SSL 连接 测试命令 AT+QSSLCLOSE=? 响应 +QSSLCLOSE: (支持的范围),(支持的范围) 设置命令 AT+QSSLCLOSE=[,] OK 响应 如果 SSL 连接成功关闭： OK 最大响应时间 特性说明 若发生任何错误： ERROR 取决于配置的时间 该命令立即生效； 参数配置不保存。 参数 整型。Socket 索引。范围：0~11。 整型。AT+QSSLCLOSE 执行的超时时间。范围：0~65535；默认值：10。0 表示 立 即 执 行 该 命 令 。 的 单 位 取 决 于 AT+QSSLCFG='closetimemode' 的 配 置 ， 若 =0 ， 则 的单位为秒；若=1，则的 单位为毫秒。 2.2.6. AT+QSSLSTATE 查询 Socket 连接状态 该命令用于查询 Socket 连接状态，且仅能查询 SSL 连接状态。 AT+QSSLSTATE 查询 Socket 连接状态 测试命令 响应 AT+QSSLSTATE=? 设置命令 OK 响应 AT+QSSLSTATE= +QSSLSTATE: ,'SSLClient',,,,,,,,, OK 响应 (+QSSLSTATE: ,'SSLClient',,,,,,,,,)的列表 OK 300 毫秒 / 参数 整型。Socket 索引。范围：0~11。 字符串类型。远程服务器地址。 整型。远程服务器端口。范围：0~65535。 整型。本地端口。范围：0~65535。 整型。SSL 连接状态。 0 'Initial' 连接尚未建立 1 'Opening' 2 'Connected' 客户端正在连接 客户端连接已建立 4 'Closing' 连接正在关闭 整型。PDP 上下文标识符。范围：1~15。 整型。此参数为预留参数。 整型。表示 SSL 连接的数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 字符串类型。Socket 服务的 COM 口。 'usbmodem' USB modem port 'usbat' USB AT port 'uart1' UART port 1 'cmux1' MUX port 1 'cmux2' MUX port 2 'cmux3' 'cmux4' MUX port 3 MUX port 4。 整型。SSL 上下文标识符。范围：0~5。 上海移远通信技术股份有限公司 24 / 33 LTE Standard(A)系列 SSL 应用指导 2.3. URC 详解 2.3.1. +QSSLURC: 'recv' 通知主机接收数据 该 URC 用于通知主机读取从对端接收的数据。 +QSSLURC: 'recv' 通知主机接收数据 +QSSLURC: 'recv', +QSSLURC: 'recv',, 缓存模式下接收数据时上报的 URC。SSL 数据可通过 AT+QSSLRECV 接收。 直吐模式下接收数据时上报的 URC。 参数 整型。Socket 索引。范围：0~11。 整型。实际接收的数据长度。单位：字节。 需读取的数据。单位：字节。 2.3.2. +QSSLURC: 'closed' 通知异常断开连接 该 URC 用于通知主机连接已断开。断开连接可能由多种原因引起，例如网络关闭连接或 GPRS PDP 被去激活，指定 Socket 的 SSL 连接状态可能为'closing'，此时需执行 AT+QSSLCLOSE=将 SSL 连接状态改为'initial'。 +QSSLURC: 'closed' 通知异常断开连接 +QSSLURC: 'closed', 基于指定 Socket 的 SSL 连接已关闭。 参数 整型。Socket 标识符。范围：0~11。 上海移远通信技术股份有限公司 25 / 33 LTE Standard(A)系列 SSL 应用指导 3 举例 3.1. 配置并激活 PDP 上下文 3.1.1. 配置 PDP 上下文 AT+QICSGP=1,1,'UNINET','','',1 OK //配置上下文为 1。'UNINET'表示中国联通。 3.1.2. 激活 PDP 上下文 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK //激活上下文为 1。 //激活成功。 //查询上下文状态。 3.1.3. 去激活 PDP 上下文 AT+QIDEACT=1 OK //去激活上下文 1。 //去激活成功。 3.2. 配置 SSL 上下文 AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0X0035 OK AT+QSSLCFG='seclevel',1,1 OK //设置 SSL 上下文标识符和 SSL 版本都为 1。 //设置 SSL 上下文标识符为 1，SSL 加密套件为 TLS_RSA_WITH_AES_256_CBC_SHA。 //设置 SSL 上下文标识符为 1，身份验证模式为进行服务器 身份验证。 上海移远通信技术股份有限公司 26 / 33 LTE Standard(A)系列 SSL 应用指导 AT+QSSLCFG='cacert',1,'UFS:cacert.pem' //设置 SSL 上下文标识符为 1，受信任 CA 证书路径为 UFS:cacert.pem。 OK 3.3. SSL 客户端在缓存模式下工作 3.3.1. 建立 SSL 连接并进入缓存模式 AT+QSSLOPEN=1,1,4,'220.180.239.212',8010,0 OK +QSSLOPEN: 4,0 //成功建立 SSL 连接。 AT+QSSLSTATE //查询所有 SSL 连接的状态。 +QSSLSTATE: 4,'SSLClient','220.180.239.212',8010,65344,2,1,4,0,'usbmodem',1 OK 3.3.2. 缓存模式下发送数据 3.3.2.1. 发送不定长数据 AT+QSSLSEND=4 > Test data from SSL SEND OK //发送不定长数据。 3.3.2.2. 发送定长数据 AT+QSSLSEND=4,18 > Test data from SSL SEND OK 3.3.3. 缓存模式下接收数据 +QSSLURC: 'recv',4 AT+QSSLRECV=4,1500 上海移远通信技术股份有限公司 //发送数据且数据长度为 18 个字节。 //Socket 4（ = 4）接收到数据。 //读取数据。需读取数据的长度为 1500 个字节。 27 / 33 +QSSLRECV: 18 Test data from SSL OK AT+QSSLRECV=4,1500 +QSSLRECV: 0 OK 3.3.4. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK LTE Standard(A)系列 SSL 应用指导 //实际读取数据长度为18个字节。 //缓冲区无数据。 //关闭 SSL 连接（ = 4）。取决于网络，最大响应时间 为 10 秒。 3.4. SSL 客户端在直吐模式下工作 3.4.1. 建立 SSL 连接并进入直吐模式 AT+QSSLOPEN=1,1,4,'220.180.239.212',8011,1 OK +QSSLOPEN: 4,0 //成功建立 SSL 连接。 AT+QSSLSTATE //查询所有 SSL 连接的状态。 +QSSLSTATE: 4,'SSLClient','220.180.239.212',8011,65047,2,1,4,1,'usbmodem',1 OK 3.4.2. 直吐模式下发送数据 AT+QSSLSEND=4 > Test data from SSL SEND OK AT+QSSLSEND=4,18 > Test data from SSL SEND OK //发送不定长数据。 //发送数据且数据长度为 18 个字节。 上海移远通信技术股份有限公司 28 / 33 3.4.3. 直吐模式下接收数据 +QSSLURC: 'recv',4,18 Test data from SSL 3.4.4. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK LTE Standard(A)系列 SSL 应用指导 //关闭 SSL 连接（ = 4）。取决于网络， 最大响应时间为 10 秒。 3.5. SSL 客户端在透传模式下工作 3.5.1. 建立 SSL 连接并在透传模式下发送数据 AT+QSSLOPEN= 1,1,4,'220.180.239.212',8011,2 //建立 SSL 连接。 CONNECT //进入透传模式。 //客户端直接通过 COM 端口向网络发送数据。（该举 例中数据不可见） OK //+++或者 DTR（需先执行 AT&D1）可用于退出透 传模式。若服务器异常断开 SSL 连接，将上报结 果码 NO CARRIER。 3.5.2. 建立 SSL 连接并在透传模式下接收数据 AT+QSSLOPEN=1,1,4,'220.180.239.212',8011,2 CONNECT OK //建立 SSL 连接。 //进入透传模式。 //客户端正在读取数据。 //通过+++或者 DTR（需先执行 AT&D1）退出透传 模式。若服务器断开 SSL 连接，将上报结果码 NO CARRIER。 3.5.3. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK //关闭 SSL 连接（ = 4）。取决于网络， 最大响应时间为 10 秒。 上海移远通信技术股份有限公司 29 / 33 LTE Standard(A)系列 SSL 应用指导 4 SSL 连接失败原因的排查 若 SSL 连接打开失败，请进行以下排查： 1. 通过 AT+QIACT?查询指定 PDP 上下文的状态，检查指定 PDP 上下文是否已被激活。 2. 由于无效的 DNS 服务器无法将域名转换为 IP 地址，若远程服务器地址为域名，还请通过 AT+QIDNSCFG=检查 DNS 服务器地址是否有效。关于 AT+QIDNSCFG 的详细信息， 可参考文档 [1]。 3. 通过 AT+QSSLCFG 检查 SSL 配置，尤其是 SSL 版本及加密套件，以确保服务器端可以支持。若 =1/2，则需通过 AT+QFUPL 上传受信任 CA 证书。若服务器配置了'SSLVerifyClient required'，则需通过 AT+QFUPL 上传客户端证书和客户端密钥。关于证书有效性验证的更多细节， 请参考第 1.5 章。关于 AT+QFUPL 详细信息，可参考文档 [2]。 上海移远通信技术股份有限公司 30 / 33 LTE Standard(A)系列 SSL 应用指导 5 结果码 如果在执行 SSL 相关 AT 命令后返回 ERROR，都可以通过 AT+QIGETERROR 查询错误的详细信息， 但需注意 AT+QIGETERROR 仅返回最后一个 SSL 命令的错误代码。关于 AT+QIGETERROR 的详情请参 考文档 [1]。 表 5：结果码 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 结果码 Operation successful Unknown error Operation blocked Invalid parameter Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy 描述 操作成功 未知错误 操作被阻止 无效参数 内存不足 创建Socket失败 不支持该操作 Socket绑定失败 Socket监听失败 Socket写入失败 Socket读取失败 Socket接受失败 打开PDP上下文失败 关闭PDP上下文失败 Socket标识已被使用 DNS业务繁忙 上海移远通信技术股份有限公司 31 / 33 LTE Standard(A)系列 SSL 应用指导 565 DNS parse failed DNS解析失败 566 Socket connection failed Socket连接失败 567 Socket has been closed Socket已关闭 568 Operation busy 操作繁忙 569 Operation timeout 操作超时 570 PDP context break down PDP上下文崩溃 571 Cancel send 取消发送 572 Operation not allowed 不允许操作 573 APN not configured 未配置APN 574 Port busy 端口繁忙 上海移远通信技术股份有限公司 32 / 33 LTE Standard(A)系列 SSL 应用指导 6 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_TCP(IP)_应用指导 [2] Quectel_LTE_Standard(A)系列_FILE_应用指导 [3] Quectel_LTE_Standard(A)系列_AT 命令手册 表 7：术语缩写 缩写 APN CA CR DNS DTR LF PDP SNI SSL TCP/IP TLS UART UFS URC USB 英文全称 Access Point Name Certificate Authority Carriage Return Domain Name Server Data Terminal Ready Line Feed Packet Data Protocol Server Name Indication Security Socket Layer Transmission Control Protocol/Internet Protocol Transport Layer Security Universal Asynchronous Receiver/Transmitter Universal Flash Storage Unsolicited Result Code Universal Serial Bus 中文全称 接入点名称 证书授权 回车符 域名服务器 数据终端就绪 换行符 分组数据协议 服务器名称指示 安全套接层协议 传输控制协议/网际协议 安全传输层协议 通用异步收发机 通用闪存存储 非请求结果码 通用串行总线 上海移远通信技术股份有限公司 33 / 33

LTE Standard(A)系列 RF FTM 应用指导 LTE Standard 模块系列 版本：1.2 日期：2022-06-21 状态：受控文件 LTE Standard(A)系列 RF FTM 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 17 LTE Standard(A)系列 RF FTM 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 17 LTE Standard(A)系列 RF FTM 应用指导 文档历史 修订记录 版本 日期 作者 - 2020-06-24 Wayne WEI 1.0 2020-06-24 Wayne WEI 1.1 2021-04-16 Wayne WEI 1.2 2022-06-21 Ford ZHANG 变更表述 文档创建 受控版本 1. 新 增 适 用 模 块 ： EC200S 系 列 、 EC200N-CN 、 EC600S-CN、EC600N-CN 和 EG912Y 系列 2. 新增支持的 WCDMA 和 LTE 频段（第 2.3.2 章和第 2.3.3 章） 1. 新增适用模块 EC200A 系列、EC800N-CN 和 EG915N 系列。 2. 删除适用模块 EC200T 系列。 3. 更新参数描述（第 2.3.2、2.3.3 章）。 4. 新增 EC200A 系列模块的强发强收测试示例（第 3 章）。 5. 新增参数解释及错误码描述（第 2.3、4 章）。 上海移远通信技术股份有限公司 3 / 17 LTE Standard(A)系列 RF FTM 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 2 AT 命令详解 ........................................................................................................................................... 7 2.1. AT 命令说明 ................................................................................................................................ 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句..................................................................................................................... 7 2.2. AT 示例声明 ................................................................................................................................ 8 2.3. RF FTM AT 命令详解 .................................................................................................................. 8 2.3.1. AT+QRFTESTMODE 进入/退出 FTM 模式 ................................................................... 8 2.3.2. AT+QRXFTM FTM 模式下强收 ..................................................................................... 9 2.3.3. AT+QRFTEST FTM 模式下强发.................................................................................. 11 3 示例 ...................................................................................................................................................... 14 3.1. FTM 模式下强收........................................................................................................................ 14 3.2. FTM 模式下强发........................................................................................................................ 15 4 错误码 .................................................................................................................................................. 16 5 附录 术语缩写...................................................................................................................................... 17 上海移远通信技术股份有限公司 4 / 17 LTE Standard(A)系列 RF FTM 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 7 表 3：错误码............................................................................................................................................... 16 表 4：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 5 / 17 LTE Standard(A)系列 RF FTM 应用指导 1 引言 移远通信 LTE Standard(A)系列模块支持强发和强收功能。本文档主要介绍相关 AT 命令，以及如何在 FTM（工厂测试模式）下测试该功能，以便进行射频校准。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200S 系列 EC200A 系列 EC200N-CN EC600S-CN EC600N-CN EC800N-CN EG912Y-EU EG915N 系列 备注 不同模块型号需要根据其硬件实际支持的频段进行强收强发测试。 上海移远通信技术股份有限公司 6 / 17 LTE Standard(A)系列 RF FTM 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 17 LTE Standard(A)系列 RF FTM 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. RF FTM AT 命令详解 2.3.1. AT+QRFTESTMODE 进入/退出 FTM 模式 该命令用于设置模块进入/退出 FTM 模式。 AT+QRFTESTMODE 进入/退出 FTM 模式 测试命令 AT+QRFTESTMODE=? 响应 +QRFTESTMODE: (支持的列表) 查询命令 AT+QRFTESTMODE? OK 响应 +QRFTESTMODE: 设置命令 AT+QRFTESTMODE= OK 响应 OK 若有任何错误： ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。进入/退出 FTM 模式。 0 退出 FTM 模式 1 进入 FTM 模式 整型。错误码。详见第 4 章。 上海移远通信技术股份有限公司 8 / 17 LTE Standard(A)系列 RF FTM 应用指导 2.3.2. AT+QRXFTM FTM 模式下强收 该命令用于模块在 FTM 模式下进行强收。 AT+QRXFTM FTM 模式下强收 测试命令 AT+QRXFTM=? 设置命令 GSM AT+QRXFTM=,,, 响应 OK 响应 +QRXFTM: OK 若有任何错误： ERROR 设置命令 WCDMA AT+QRXFTM=,,, 若错误与 ME 功能相关： +CME ERROR: 响应 +QRXFTM: OK 若有任何错误： ERROR 设置命令 LTE AT+QRXFTM=,,, 若错误与 ME 功能相关： +CME ERROR: 响应 +QRXFTM: , OK 若有任何错误： ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 9 / 17 参数 LTE Standard(A)系列 RF FTM 应用指导 字符串类型。GSM/WCDMA/LTE 各网络制式下支持的频段。范围及对应频点如 参数解释中所示。 整型。支持的下行信道频点范围。GSM/WCDMA/LTE 各网络制式下支持的频段及 对应的下行信道频点范围如下： GSM 频段 下行信道频点范围 'GSM850' 128~251 'GSM900' 0~124, 975~1023 'GSM1800' 512~885 'GSM1900' 512~810 WCDMA 频段 'WCDMA BAND1' 'WCDMA BAND2' 'WCDMA BAND3' 'WCDMA BAND4' 'WCDMA BAND5' 'WCDMA BAND6' 'WCDMA BAND7' 'WCDMA BAND8' 'WCDMA BAND9' 下行信道频点范围 10562~10838 9662~9938 1162~1513 1537~1738 4357~4458 4387~4413 2237~2563 2937~3088 9237~9387 LTE 频段 'LTE BAND1' 'LTE BAND2' 'LTE BAND3' 'LTE BAND4' 'LTE BAND5' 'LTE BAND7' 'LTE BAND8' 'LTE BAND17' 'LTE BAND20' 'LTE BAND28' 'LTE BAND31' 'LTE BAND33' 'LTE BAND34' 'LTE BAND38' 'LTE BAND39' 'LTE BAND40' 'LTE BAND41' 'LTE BAND65' 'LTE BAND66' 'LTE BAND72' 下行信道频点范围 0~599 600~1199 1200~1949 1950~2399 2400~2649 2750~3449 3450~3799 5730~5849 6150~6449 9210~9659 9870~9919 36000~36199 36200~36349 37750~38249 38250~38649 38650~39649 39650~41589 65536~66435 66436~67335 68936~68985 上海移远通信技术股份有限公司 10 / 17 LTE Standard(A)系列 RF FTM 应用指导 字符串类型。在 FTM 模式下打开/关闭强收。 'on' 在 FTM 模式下打开强收 'off' 在 FTM 模式下关闭强收 整型。GSM 接收功率增益指数。范围：0~1023，建议将其设置为 200~700。 整型。WCDMA 接收功率增益指数。范围：0~2047，建议将其设置为 1600（不包 括 EC200A 系列）；范围：0~19，建议将其设置为 18（EC200A 系列）。 整型。LTE 期望接收功率。范围：0~100。该值同仪器设置信号强度的绝对值相等。 单位：dBm。 整型。接收信号强度值。仅用于 GSM 和 WCDMA 制式。 整型。主集接收信号强度值。仅用于 LTE 制式。 整型。分集接收信号强度值。仅用于 LTE 制式。 整型。错误码。详见第 4 章。 备注 1. 测试过程中如需切换制式，请先设置='off'退出当前网络制式。详情可参考第 3.1 章。 2. 强收测试时测试仪器发送给模块的信号强度值范围在-85 dBm 至-55 dBm 之间，信号强度过大或过 小都会导致测试结果不准。因此，实际测试时，值应设置为 55 至 85 之间。 2.3.3. AT+QRFTEST FTM 模式下强发 该设置命令用于模块在 FTM 模式下进行强发。 AT+QRFTEST FTM 模式下强发 测试命令 AT+QRFTEST=? 设置命令 GSM AT+QRFTEST=,,, 响应 OK 响应 OK 若有任何错误： ERROR 设置命令 WCDMA AT+QRFTEST=,,, 若错误与 ME 功能相关： +CME ERROR: 响应 OK 若有任何错误： ERROR 若错误与 ME 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 11 / 17 LTE Standard(A)系列 RF FTM 应用指导 设置命令 LTE AT+QRFTEST=,,, 响应 OK 若有任何错误： ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。GSM/WCDMA/LTE 各网络制式下支持的频段。范围及对应频点如 参数解释中所示。 整型。支持的上行信道频点范围。 GSM/WCDMA/LTE 各网络制式下支持的频段及 对应的上行信道频点范围如下： GSM 频段 上行信道频点范围 'GSM850' 128~251 'GSM900' 0~124, 975~1023 'GSM1800' 512~885 'GSM1900' 512~810 WCDMA 频段 'WCDMA BAND1' 'WCDMA BAND2' 'WCDMA BAND3' 'WCDMA BAND4' 'WCDMA BAND5' 'WCDMA BAND6' 'WCDMA BAND7' 'WCDMA BAND8' 'WCDMA BAND9' 上行信道频点范围 9612~9888 9262~9538 937~1288 1312~1513 4132~4233 4162~4188 2012~2338 2712~2863 8763~8912 LTE 频段 'LTE BAND1' 'LTE BAND2' 'LTE BAND3' 'LTE BAND4' 'LTE BAND5' 'LTE BAND7' 'LTE BAND8' 上行信道频点范围 18000~18599 18600~19199 19200~19949 19950~20399 20400~20649 20750~21449 21450~21799 上海移远通信技术股份有限公司 12 / 17 LTE Standard(A)系列 RF FTM 应用指导 'LTE BAND17' 23730~23849 'LTE BAND20' 24150~24449 'LTE BAND28' 27210~27659 'LTE BAND31' 27760~27809 'LTE BAND33' 36000~36199 'LTE BAND34' 36200~36349 'LTE BAND38' 37750~38249 'LTE BAND39' 38250~38649 'LTE BAND40' 38650~39649 'LTE BAND41' 39650~41589 'LTE BAND65' 131072~131971 'LTE BAND66' 131972~132671 'LTE BAND72' 133472~133521 字符串类型。在 FTM 模式下打开/关闭强发。 'on' 在 FTM 模式下打开强发 'off' 在 FTM 模式下关闭强发 整型。GSM 发送功率增益指数。范围：0~1023，建议将其设置为 200~700。 整型。WCDMA 发送功率增益指数。范围：0~2047，建议将其设置为 1600（不包 括 EC200A 系列）；范围：0~19，建议将其设置为 18（EC200A 系列）。 整型。LTE 发送功率增益指数。范围：0~2047，建议将其设置为 2000。 整型。错误码。详见第 4 章。 备注 测试过程中如需切换制式，请先设置='off'退出当前网络制式。详情请参考第 3.2 章。 上海移远通信技术股份有限公司 13 / 17 LTE Standard(A)系列 RF FTM 应用指导 3 示例 3.1. FTM 模式下强收 //GSM&WCDMA&LTE 强收测试流程。 AT+QRFTESTMODE? +QRFTESTMODE: 0 //查询当前是否进入 FTM 模式。 OK AT+QRFTESTMODE=1 OK AT+QRXFTM='GSM900',62,'on',200 +QRXFTM: -80 //进入 FTM 模式。 //测试 EGSM900 下行信道频点 62。 OK AT+QRXFTM='GSM900',62,'off',200 //关闭 GSM 强收测试。 OK AT+QRXFTM='WCDMA BAND1',10700,'on',1600 //测试 WCDMA B1 下行信道频点 10700。 +QRXFTM: -80 OK AT+QRXFTM='WCDMA BAND1',10700,'off',1600 //关闭 WCDMA 强收测试。 OK AT+QRXFTM='WCDMA BAND1',10700,'on',18 //使用 EC200A 系列模块测试 WCDMA B1 下行信道 频点 10700。 +QRXFTM: -80 OK AT+QRXFTM='WCDMA BAND1',10700,'off',18 OK AT+QRXFTM='LTE BAND1',300,'on',75 +QRXFTM: -75,-80 //关闭 EC200A 系列模块的 WCDMA 强收测试。 //测试 LTE B1 下行信道频点 300。 //主集接收信号强度值和分集接收信号强度值。 OK AT+QRXFTM='LTE BAND1',300,'off',75 OK //关闭 LTE 强收测试。 上海移远通信技术股份有限公司 14 / 17 AT+QRFTESTMODE=0 OK LTE Standard(A)系列 RF FTM 应用指导 //退出 FTM 模式。 3.2. FTM 模式下强发 //GSM&WCDMA&LTE 强发测试流程。 AT+QRFTESTMODE? +QRFTESTMODE: 0 //查询当前是否进入 FTM 模式。 OK AT+QRFTESTMODE=1 //进入 FTM 模式。 OK AT+QRFTEST='GSM900',62,'on',200 //测试 EGSM900 上行信道频点 62。 OK AT+QRFTEST='GSM900',62,'off',200 //关闭 GSM 强发测试。 OK AT+QRFTEST='WCDMA BAND1',9750,'on',1600 //测试 WCDMA B1 上行信道频点 9750。 OK AT+QRFTEST='WCDMA BAND1',9750,'off',1600 //关闭 WCDMA 强发测试。 OK AT+QRFTEST='WCDMA BAND1',9750,'on',18 //使用 EC200A 系列模块测试 WCDMA B1 上行信道 频点 9750。 OK AT+QRFTEST='WCDMA BAND1',9750,'off',18 //关闭 EC200A 系列模块的 WCDMA 强发测试。 OK AT+QRFTEST='LTE BAND1',18300,'on',2000 //测试 LTE B1 上行信道频点 18300。 OK AT+QRFTEST='LTE BAND1',18300,'off',2000 //关闭 LTE 强发测试。 OK AT+QRFTESTMODE=0 //退出 FTM 模式。 OK 备注 执行 AT+QRFTESTMODE=0 退出 FTM 后，至少需要间隔 3 秒才能执行 AT+QRFTESTMODE=1 再次 进入 FTM 模式。如果间隔时间过短可能导致 AT 命令返回 ERROR。建议用户进行强收/强发测试时，完 成所有需要测试的频段后再退出 FTM。 上海移远通信技术股份有限公司 15 / 17 LTE Standard(A)系列 RF FTM 应用指导 4 错误码 表示与移动设备或网络有关的错误码，详细信息可参考下表。 表 3：错误码 4 50 300 英文含义 Operation not supported Invalid parameter ME failure 中文含义 操作不支持 无效参数 ME 错误 上海移远通信技术股份有限公司 16 / 17 LTE Standard(A)系列 RF FTM 应用指导 5 附录 术语缩写 表 4：术语缩写 缩写 FTM GSM LTE RF RSSI RX TX WCDMA 英文全称 中文全称 Factory Test Mode 工厂测试模式 Global System for Mobile Communications 全球移动通信系统 Long Term Evolution 长期演进 Radio Frequency 射频 Received Signal Strength Indication 接收的信号强度指示 Receive 接收 Transmit 发送 Wideband Code Division Multiple Access 宽带码分多址 上海移远通信技术股份有限公司 17 / 17

LTE Standard(A)系列 QuecCell 应用指导 LTE Standard 模块系列 版本：1.4 日期：2023-12-20 状态：受控文件 LTE Standard(A)系列 QuecCell 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 18 LTE Standard(A)系列 QuecCell 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 18 LTE Standard(A)系列 QuecCell 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 1.4 日期 作者 2021-02-25 Isaac SHI 2021-05-13 Isaac SHI 2022-02-25 Isaac SHI 2022-08-31 Isaac SHI 2023-04-10 Sawyer HE 2023-12-20 Sawyer HE 变更表述 文档创建 受控版本 1. 新 增 适 用 模 块 ： EC200A 系 列 、 EC800N-CN 和 EG915N-EU。 2. 更新 AT+QENG 中、、、 、 、 及 描 述 ， 更 新 GSM 参 数 为 （第 2.3 章）。 3. 新增 AT+QCELL（第 2.4 章）。 更新适用模块： 新 增 EC200M-CN 、 EC600M-CN 、 EC800M-CN 和 EG912N-EN； 更新 EG915N-EU 为 EG915N 系列； 删除 EC200T 系列。 1. 新增适用模块 EG810M-CN 和 EG950A-EL；删除适用 模块 EC600S-CN。 2. 新增 AT+QENG='neighbourcell'中的无效值备 注和 SIB 消息解析失败的备注（第 2.3 章）。 3. 新增 EG950A-EL 模块不支持 GSM 网络制式的备注（第 2.3 章 & 第 2.4 章）。 更新适用模块： ⚫ 新增 EC600K-CN 和 EC800K 系列； ⚫ 更新 EC200N-CN 为 EC200N 系列； ⚫ 更新 EG950A-EL 为 EG950A 系列。 上海移远通信技术股份有限公司 3 / 18 LTE Standard(A)系列 QuecCell 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明 ............................................................................................................................... 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 示例声明 ............................................................................................................................... 8 2.3. AT+QENG 获取主服务小区和邻区信息................................................................................... 8 2.4. AT+QCELL 获取服务小区和邻区信息 ................................................................................... 14 3 附录 术语缩写..................................................................................................................................... 17 上海移远通信技术股份有限公司 4 / 18 LTE Standard(A)系列 QuecCell 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 7 表 3：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 5 / 18 LTE Standard(A)系列 QuecCell 应用指导 1 引言 本文档详细介绍了在移远通信 LTE Standard(A)系列模块 QuecCell 相关的 AT 命令。 QuecCell 是嵌入到模块中的一项功能，可用于扫描基站的详细信息。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N 系列 EC200S 系列 EC600M-CN EC600N-CN EC600K-CN EC800M-CN EC800N-CN EC800K 系列 EG810M-CN EG912N-EN EG912Y-EU EG915N 系列 EG950A 系列 上海移远通信技术股份有限公司 6 / 18 LTE Standard(A)系列 QuecCell 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 18 LTE Standard(A)系列 QuecCell 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QENG 获取主服务小区和邻区信息 该命令用于获取主服务小区和邻区信息。 AT+QENG 获取主服务小区和邻区信息 测试命令 AT+QENG=? 响应 +QENG: (支持的列表) 设置命令 AT+QENG='servingcell' OK 响应 LTE 网络制式： +QENG: 'servingcell',,'LTE',,,< MNC>,,,,,,,,,,< RSSI>,, OK WCDMA 网络制式： +QENG: 'servingcell',,'WCDMA',,,,,,,,,< ecno>,-,-,-,-,- OK GSM 网络制式： +QENG: 'servingcell',,'GSM',,,,,,,,,,,,,,,-,-,-, -,-,-,-,-,-,'-' 设置命令 AT+QENG='neighbourcell' OK 响应 LTE 网络制式： [+QENG: 'neighbourcell intra','LTE',,, 上海移远通信技术股份有限公司 8 / 18 上海移远通信技术股份有限公司 LTE Standard(A)系列 QuecCell 应用指导 ,,-,-,,,,, […]] [+QENG: 'neighbourcell inter','LTE',,, ,,-,-,,,, […]] [+QENG: 'neighbourcell','GSM',,,,,,,,, […]] [+QENG: 'neighbourcell','WCDMA',,,,,,,, […]] OK WCDMA 网络制式： [+QENG: 'neighbourcell','WCDMA',,,,,,,-, […]] [+QENG: 'neighbourcell','GSM',,,, […]] [+QENG: 'neighbourcell','LTE',,,,, […]] OK GSM 网络制式： [+QENG: 'neighbourcell','GSM',,,, ,,,,,,, […]] [+QENG: 'neighbourcell','WCDMA',,, , […]] [+QENG: 'neighbourcell','LTE',,,, […]] OK 9 / 18 设置命令 AT+QENG='3gcomm' 最大响应时间 特性说明 LTE Standard(A)系列 QuecCell 应用指导 响应 仅用于 WCDMA 网络制式下获取 3G 小区公共项，包括 3G 服 务小区信息、3G 邻区和 2G 邻区信息。 WCDMA 服务小区信息： [+QENG: '3gcomm',,,,, ,,,,,,,,-,[…]] WCDMA 服务小区的 3G 邻区信息： [+QENG: '3gcomm',,,-,-,-,-,,,,,,, […]] WCDMA 服务小区的 2G 邻区信息： [+QENG: '3gcomm',,,,,,, […]] OK 300 毫秒 / 参数 字符串类型。不同类型的小区信息。 'servingcell' 2G/3G/4G 服务小区信息 'neighbourcell' 2G/3G/4G 邻区信息 '3gcomm' WCDMA 网络制式下的 3G 服务小区信息/2G 邻区信息/3G 邻区信息 字符串类型。UE 状态。 'SEARCH' UE 正在搜网，但尚未发现合适的 2G/3G/4G 小区 'LIMSRV' UE 驻留在小区中，但尚未在网络上注册 'NOCONN' UE 驻留在小区中并已在网络上注册，并且处于空闲模式 'CONNECT' UE 驻留在小区中并已在网络上注册，并且正在进行通话 字符串类型。接入制式。包括'2G'、'3G'和'4G'。 字符串类型。通信模式。 'TDD' 时分双工模式 'FDD' 频分双工模式 整型。移动设备国家代码（PLMN 的第一部分）。 整型。移动设备网络代码（PLMN 的第二部分）。 十六进制格式。小区 ID。该参数确定 16 位（GSM）、28 位（UMTS）或 32 位（LTE）小区 ID。范围：0~0xFFFFFFFF。 上海移远通信技术股份有限公司 10 / 18 LTE Standard(A)系列 QuecCell 应用指导 整型。物理小区识别码。范围：0~503。 整型。E-UTRA 绝对射频信道号。范围：0~65535（如支持扩展频段，该参 数扩展频段取值范围为 65536~70645）。 整型。E-UTRA 频段（参考 3GPP 36.101）。 整型。上行带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 整型。下行带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 十六进制格式。跟踪区域码。范围：0~0xFFFFFFFF。（参考 3GPP 23.003 第 19.4.2.3 章） 整型。参考信号接收功率。单位：dBm。（参考 3GPP 36.214 第 5.1.1 章） 整型。参考信号接收质量。单位：dB。（参考 3GPP 36.214 第 5.1.3 章） 整型。接收信号强度指示。单位：dBm。 整型。信号与干扰加噪声比。范围：-20~30；单位：dB。 整型。小区选择接收电平值。单位：dB。（参考 3GPP 25.304/3GPP 36.304） 十六进制格式。两字节的扫描小区的位置区码（例如 00C1 等于十进制的 193）。范围：0~0xFFFF。 整型。UTRA 绝对射频频道号。范围：712~10838。 整型。主扰码。范围：0~511。 整型。路由区号。范围：0~255。 整型。接收信号码功率。 整型。EC/NO 是每个 PN 芯片的接收能量与总接收功率谱密度的比值，与信 道有关。单位：dB。 整型。基站识别码。范围：0~63。 整型。绝对射频信道号。范围：0~1023。 整型。GSM 频段。 0 DCS1800 1 PCS1900 2 GSM900 '-' 其他 GSM 频段 整型。小区接收电平值。范围：0~63；单位：dB。该参数值减去 111，可换 算为以 dBm 为单位的取值。（参考 3GPP 25.304） 整型。发射功率。 整型。最低接入电平。 上海移远通信技术股份有限公司 11 / 18 LTE Standard(A)系列 QuecCell 应用指导 整型。非连续接收的周期长度。 整型。选择小区时的参考标准。 整型。小区重选时的参考标准。 整型。当前小区是否支持 GPRS。 0 不支持 GPRS 1 支持 GPRS 整型。小区重选优先级。范围：0~7。 整型。用于控制非同频搜索的阈值。 整型。当向较低优先级 RAT/频率重新选择时，UE 在服务小区上使用的 阈值。单位：dB。 整型。同频小区重选的测量触发门限。 整型。低优先级小区重选阈值。评估的低优先级小区的合适接收电平值必须 大于该值。范围：0~31；单位：2 dB。 整型。高优先级小区重选阈值。评估的高优先级小区的合适接收电平值必须 大于该值。范围：0~31；单位：2 dB。 整型。高优先级层的重选阈值。 整型。低优先级层的重选阈值。 整型。指定是否使用特定的网络色码报告邻区的位掩码。 整型。CPICH/PCCPCH 接收信号码功率。RSCP 在 UMTS FDD/TDD 消息 中以-120 dBm 至-25 dBm 范围内的整数形式发送。根据 3GPP 25.133，该 值被编码为-5 至 99 之间的整数。 整型。公共导频信道每个 PN 芯片的接收能量与 UE 天线连接器处的总接收 功率谱密度的比值。 整型。小区选择接受质量。仅对 FDD 有效。单位：dB。 整型。3G 邻区设置。 0/2 同步邻区集 1 活跃邻区集 3 异步邻区集 整型。RAT 间重选邻区的小区等级。 整型。GPRS 信号电平阈值标准。 整型。小区排队标准参数。用于在相同优先级的小区中选择小区。 备注 1. 如果返回'-'或-，则表明该参数在当前条件下无效。 2. 2G 邻区仅在空闲模式下可见。 3. 当的返回值为 65535 时，表示该参数取值为无效值。 4. 当的返回值为 255 时，表示该参数取值为无效值。 5. 模块未成功解析邻区 SIB 消息（包含 AT+QENG='neighbourcell'部分参数）时，未成功解析的参 数取值为无效值。 6. EG950A 系列模块不支持 GSM 网络制式。 上海移远通信技术股份有限公司 12 / 18 LTE Standard(A)系列 QuecCell 应用指导 举例 AT+QENG='servingcell' +QENG: 'servingcell','SEARCH' OK AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','LTE','FDD',460,01,5A29C0B,465,1650,3,5,5,DE10,-69,-5,-65,21, 51 OK AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','WCDMA',460,01,D5D5,8054BBF,10633,457,10,-72,-5,-,-,-,-,- OK AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','GSM',460,00,550B,D89,35,59,2,-82,0,8,0,21,131,1,-,-,-,-,-,-,-,-, -,'-' OK AT+QENG='neighbourcell' +QENG: 'neighbourcell inter','LTE',38950,65535,-140,-20,-,-,0,24,24,6 +QENG: 'neighbourcell inter','LTE',36275,65535,-140,-20,-,-,0,24,24,5 +QENG: 'neighbourcell inter','LTE',37900,65535,-140,-20,-,-,0,24,24,5 +QENG: 'neighbourcell inter','LTE',38098,65535,-140,-20,-,-,0,24,24,5 +QENG: 'neighbourcell inter','LTE',38400,65535,-140,-20,-,-,0,24,24,3 +QENG: 'neighbourcell','GSM',616,0,0,0,0,0,255,0,0 +QENG: 'neighbourcell','GSM',612,0,0,0,0,0,255,0,0 +QENG: 'neighbourcell','GSM',64,0,0,0,0,0,255,0,0 +QENG: 'neighbourcell','GSM',63,0,0,0,0,0,255,0,0 OK AT+QENG='neighbourcell' +QENG: 'neighbourcell','WCDMA',10633,-18,459,-32768,-32768,0,-,-115 +QENG: 'neighbourcell','WCDMA',10633,-18,462,-32768,-32768,0,-,-115 +QENG: 'neighbourcell','WCDMA',10633,-18,319,-32768,-32768,0,-,-115 +QENG: 'neighbourcell','WCDMA',10633,-18,307,-32768,-32768,0,-,-115 +QENG: 'neighbourcell','WCDMA',10633,-18,146,-32768,-32768,0,-,-115 +QENG: 'neighbourcell','WCDMA',10633,-18,145,-32768,-32768,0,-,-115 +QENG: 'neighbourcell','WCDMA',10633,-18,334,-32768,-32768,0,-,-115 OK AT+QENG='3gcomm' +QENG: '3gcomm','servingcell','3G','NOCONN',460,01,D5D5,8054BBF,10633,457,-61,-71, -3,-,- 上海移远通信技术股份有限公司 13 / 18 LTE Standard(A)系列 QuecCell 应用指导 +QENG: '3gcomm','neighbourcell','3G',-,-,-,-,10633,145,-85,-85,-17,-17,-115 OK 2.4. AT+QCELL 获取服务小区和邻区信息 该命令用于获取服务小区和邻区信息。 AT+QCELL 获取服务小区和邻区信息 测试命令 响应 AT+QCELL=? 查询命令 AT+QCELL? OK 响应 LTE 网络制式： +QCELL: 'servingcell','LTE',,,,,, [+QCELL: 'neighbourcell intra','LTE',,,< TAC>,,, […]] [+QCELL: 'neighbourcell inter','LTE',,,< TAC>,,, […]] [+QCELL: 'neighbourcell','WCDMA',,,,,, […]] [+QCELL: 'neighbourcell','GSM',,,,,, […]] WCDMA 网络制式： +QCELL: 'servingcell','WCDMA',,,,,, [+QCELL: 'neighbourcell','WCDMA',,,,,, […]] [+QCELL: 'neighbourcell intra','LTE',,,< TAC>,,, […]] [+QCELL: 'neighbourcell inter','LTE',,,< TAC>,,, […]] [+QCELL: 'neighbourcell','GSM',,,,,, 上海移远通信技术股份有限公司 14 / 18 LTE Standard(A)系列 QuecCell 应用指导 最大响应时间 特性说明 […]] GSM 网络制式： +QCELL: 'servingcell','GSM',,,,,, [+QCELL: 'neighbourcell','GSM',,,,,, […]] [+QCELL: 'neighbourcell','WCDMA',,,,,, […]] [+QCELL: 'neighbourcell intra','LTE',,,< TAC>,,, […]] [+QCELL: 'neighbourcell inter','LTE',,,< TAC>,,, […]] OK 300 毫秒 / 参数 整型。移动设备国家代码（PLMN 的第一部分）。 整型。移动设备网络代码（PLMN 的第二部分）。 十六进制格式。两字节的扫描小区的位置区码（例如 00C1 等于十进制的 193）。范围： 0~0xffff。 十六进制格式。跟踪区域码。范围：0~0xffffffff。（参考 3GPP 23.003 第 19.4.2.3 章） 十六进制格式。小区 ID。该参数确定 16 位（GSM）、28 位（UMTS）或 32 位（LTE） 小区 ID。范围：0~0xffffffff。 整型。基站识别码。范围：0~63。 整型。主扰码。范围：0~511。 整型。物理小区识别码。范围：0~503。 整型。小区接收电平值。范围：0~63；单位：dB。（参考 3GPP 25.304） 备注 1. 该命令仅可在未插入(U)SIM 卡时或插入(U)SIM 卡时的空闲模式下执行；建议在未插入(U)SIM 卡时 使用。 2. EG950A 系列模块不支持 GSM 网络制式。 上海移远通信技术股份有限公司 15 / 18 LTE Standard(A)系列 QuecCell 应用指导 举例 AT+QCELL? //获取服务小区和邻区信息。 +QCELL: 'servingcell','LTE',460,00,550b,d6b5c0,123,36 +QCELL: 'neighbourcell inter','LTE',460,00,550b,5e05e2a,20,12 +QCELL: 'neighbourcell inter','LTE',460,00,550b,5c4ef29,121,25 +QCELL: 'neighbourcell','GSM',460,00,550b,d89,35,46 +QCELL: 'neighbourcell','GSM',460,00,550b,34b8,10,45 OK 上海移远通信技术股份有限公司 16 / 18 LTE Standard(A)系列 QuecCell 应用指导 3 附录 术语缩写 表 3：术语缩写 缩写 3GPP ARFCN BSIC CPICH DL DRX EARFCN E-UTRA FDD GPRS GSM LAC LTE MCC MNC NCC PCCPCH PCI 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 Absolute Radio-Frequency Channel Number 绝对射频信道号 Base Station Identity Code 基站识别码 Common Pilot Channel 公共导频信道 Downlink 下行链路 Discontinuous Reception 非连续接收 E-UTRA Absolute Radio Frequency Channel Number Evolved Universal Terrestrial Radio Access Network E-UTRA 绝对射频信道号 演进型通用陆地无线接入网（4G 网络接入网部分） Frequency Division Duplex 频分双工 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Location Area Code 位置区码 Long Term Evolution 长期演进 Mobile Country Code 移动设备国家代码 Mobile Network Code 移动设备网络代码 Network Color Code 网络色码 Physical Common Control Physical Channel 主公共控制物理信道 Physical Cell Identity 物理小区识别码 上海移远通信技术股份有限公司 17 / 18 PLMN PSC RAC RAT RSCP RSRP RSRQ RSSI RX SIB SINR TA TAC TDD TX UARFCN UE UL UMTS UTRA WCDMA LTE Standard(A)系列 QuecCell 应用指导 Public Land Mobile Network Primary Scrambling Code Routing Area Code Radio Access Technology Received Signal Code Power Reference Signal Received Power Reference Signal Received Quality Received Signal Strength Indicator Receive System Information Block Signal to Interference plus Noise Ratio Terminal Adapter Tracking Area Code Time Division Duplex Transmit UTRA Absolute RF Channel Number User Equipment Uplink Universal Mobile Telecommunications System UMTS Terrestrial Radio Access Wideband Code Division Multiple Access 公共陆地移动网络 主扰码 路由区号 无线接入技术 接收信号码功率 参考信号接收功率 参考信号接收质量 接收信号强度指示 接收 系统信息块 信号与干扰加噪声比 终端适配器 跟踪区域码 时分双工 发送 UTRA 绝对射频频道号 用户设备 上行链路 通用移动通信系统 UMTS 地面无线接入 宽带码分多址 上海移远通信技术股份有限公司 18 / 18

LTE Standard(A)系列 PPP 应用指导 LTE Standard 模块系列 版本：1.5 日期：2023-09-25 状态：受控文件 LTE Standard(A)系列 PPP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 28 LTE Standard(A)系列 PPP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 28 LTE Standard(A)系列 PPP 应用指导 文档历史 修订记录 版本 日期 作者 1.0 2020-07-31 Chaim QIAN 1.1 2021-04-02 Chaim QIAN 1.2 2022-02-25 Chaim QIAN 1.3 2022-09-22 Chaim QIAN 1.4 2023-05-16 Chaim QIAN 1.5 2023-09-25 Chaim QIAN 变更表述 初始版本 1. 新 增 适 用 模 块 EC200N-CN 、 EC600S-CN 和 EC600N-CN。 2. 修改 ATO 返回值为 CONNECT（第 4.1.2.1 章）。 更新适用模块： ⚫ 新增 EC200A 系列、EC800N-CN 和 EG915N-EU。 ⚫ 删除 EG912Y-CN。 更新适用模块： ⚫ 新 增 EC200M-CN 、 EC600M-CN 、 EC800M-CN 和 EG912N-EN。 ⚫ 更新 EG915N-EU 为 EG915N 系列。 ⚫ 删除 EC200T 系列。 1. 更新适用模块： ⚫ 新增 EG810M-CN 和 EG950A 系列。 ⚫ 删除 EC600S-CN。 2. 更新 PPP 设置流程图中的模块示意图（第 3.1 章）。 1. 更新适用模块： ⚫ 新增 EC600K-CN、EC800K 系列和 EG800K 系列。 ⚫ 更新 EC200N-CN 为 EC200N 系列。 ⚫ 更新 EG810M-CN 为 EG810M 系列。 2. 新增不同 Flash 大小的模块型号对 PPP 功能支持情况有所 不同的备注（第 1.1 章）。 3. 删除模块注册 CDMA 网络备注（第 3.2 章）。 上海移远通信技术股份有限公司 3 / 28 LTE Standard(A)系列 PPP 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 2 PPP 应用模式........................................................................................................................................ 9 3 PPP 设置 ............................................................................................................................................. 10 3.1. PPP 设置流程........................................................................................................................... 10 3.2. PPP 设置流程建议 ....................................................................................................................11 4 PPP 连接模式...................................................................................................................................... 13 4.1. 数据模式和命令模式................................................................................................................. 13 4.1.1. 从数据模式切换到命令模式 ........................................................................................... 13 4.1.1.1. 更改 DTR 电平切换为命令模式 .......................................................................... 13 4.1.1.2. 使用+++切换至命令模式 .................................................................................... 13 4.1.2. 从命令模式切换到数据模式 ........................................................................................... 14 4.1.2.1. 使用 ATO 切换到数据模式.................................................................................. 14 4.2. 数据模式下处理 URC ............................................................................................................... 14 4.3. 数据载波检测（DCD）模式 ..................................................................................................... 14 5 终止 PPP 连接..................................................................................................................................... 15 6 PPP 拨号操作...................................................................................................................................... 16 6.1. 准备工作 ................................................................................................................................... 16 6.2. Windows 10 系统下的 PPP 拨号.............................................................................................. 16 6.2.1. 调制解调器配置 ............................................................................................................. 16 6.2.1.1. 添加新的调制解调器........................................................................................... 16 6.2.1.2. 配置调制解调器驱动........................................................................................... 20 6.2.2. 拨号上网网络配置 ......................................................................................................... 22 6.2.2.1. 创建新的网络连接 .............................................................................................. 22 6.2.2.2. 配置连接 ............................................................................................................. 24 6.2.2.3. 配置拨号工具...................................................................................................... 25 6.2.2.4. 建立拨号上网连接 .............................................................................................. 26 7 附录 参考文档及术语缩写 .................................................................................................................. 27 上海移远通信技术股份有限公司 4 / 28 LTE Standard(A)系列 PPP 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：参考文档 ........................................................................................................................................... 27 表 3：术语缩写 ........................................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 28 LTE Standard(A)系列 PPP 应用指导 图片索引 图 1：PPP 应用模式..................................................................................................................................... 9 图 2：PPP 设置流程................................................................................................................................... 10 图 3：PPP 设置推荐流程图.........................................................................................................................11 图 4：查找电话和调制解调器 ..................................................................................................................... 17 图 5：添加新的调制解调器......................................................................................................................... 18 图 6：选择调制解调器类型......................................................................................................................... 19 图 7：选择端口 ........................................................................................................................................... 19 图 8：安装新调制解调器成功 ..................................................................................................................... 20 图 9：配置调制解调器驱动......................................................................................................................... 21 图 10：设置新的连接或网络....................................................................................................................... 22 图 11：设置新连接...................................................................................................................................... 23 图 12：配置连接 ......................................................................................................................................... 24 图 13：配置拨号上网工具 .......................................................................................................................... 25 图 14：正在连接到拨号连接....................................................................................................................... 26 图 15：拨号连接成功.................................................................................................................................. 26 上海移远通信技术股份有限公司 6 / 28 LTE Standard(A)系列 PPP 应用指导 1 引言 本文档介绍了移远通信 LTE Standard(A)系列模块的 PPP 功能，包括 PPP 应用模式、设置步骤、连接 模式、终止步骤和拨号示例等。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N 系列 EC200S 系列 EC600K-CN EC600M-CN EC600N-CN EC800K 系列 EC800M-CN EC800N-CN EG800K 系列 EG810M 系列 EG912N-EN EG912Y-EU 上海移远通信技术股份有限公司 7 / 28 LTE Standard(A)系列 PPP 应用指导 EG915N 系列 EG950A 系列 备注 受限于模块 Flash 存储空间大小，不同型号的模块对于 PPP 功能支持有所差异，详情请咨询移远通信技 术支持。 上海移远通信技术股份有限公司 8 / 28 LTE Standard(A)系列 PPP 应用指导 2 PPP 应用模式 PPP（点对点协议）的使用方法如下图所示，UART 端口或 USB 端口均可用于 PPP 连接。模块为应 用程序提供 PPP 服务器，应用程序端为模块提供 PPP 客户端。同时，应用程序端必须提供 TCP/IP、 HTTP(S)等协议。当建立 PPP 连接时，来自应用程序端的 IP 报文数据流将通过模块传输到网络。 大多数标准操作系统（例如 Windows 系统、Unix/Linux 系统）都有 PPP 协议栈。针对无可用应用程 序进行 PPP 连接的操作系统，需先开发适用的应用软件。 Application IP PPP UART TXD RXD CTS RTS DTR DCD RING USB USB_DM USB_DP USB_GN USB_VBUS 应用程序端 IP RELAY PPP TXD RXD CTS RTS DTR DCD RING UART Radio Bearer USB_DM USB_DP USB_GND USB_VBUS USB 模块端 图 1：PPP 应用模式 上海移远通信技术股份有限公司 9 / 28 LTE Standard(A)系列 PPP 应用指导 3 PPP 设置 3.1. PPP 设置流程 模块注册网络后，需通过 AT+CGDCONT 为 PPP 设置 APN，并通过 ATD*99#启动 PPP。执行 ATD*99#后，模块将进入 PPP 帧交互流程，该流程基于标准 PPP 进行。模块数据包交互说明如下图所 示。如需获取有关标准 PPP 的详细信息，可参考 RFC 1661。 图 2：PPP 设置流程 上海移远通信技术股份有限公司 10 / 28 3.2. PPP 设置流程建议 LTE Standard(A)系列 PPP 应用指导 建议 开关 机方式 ： 有关 各适用 模块建 议的开 关机方 式详细 信息 ，可参 考各适 用模块 的硬件 设计手 册文 档。 查询 (U)SIM卡状态： A T+C PIN。如果 执行A T+C PIN?后20 秒 内没有检测到 (U)SIM卡，重启模块。 网络： 1. 当AT+CREG=?返回1或5时，表示模 块已 在网络 上注册 。 2. 如果模块在60秒内无法注册网络，请 重启 模块。 PS网络： 1. 当AT+CGREG返回1或5时，表示模 块已 在PS上注 册。 2. 注册PS后无需等待60秒即可进入下一 步。 模块 上电 1. TE与 TA同步。 2. 执行AT+IPR=xxx&W，设置并保存波特率. 若使用 USB modem口，可省略此操作。 如果 (U)SIM卡在20秒内未就绪， 则退 出PPP拨号 。 AT+CPIN? 是 查询(U)SIM 卡状 态 (U)SIM卡准 备就绪 如果 模块在 60 秒内 无法注 册 网络 ，则退 出PPP拨号 AT+CREG? 查 询网 络状态 60 秒内 注册网 络 AT+CGREG? 查 询 PS网络 否 Connect_Count < 5 APN 配置： 1. APN 必须由 AT+CGDCONT配置。 2. 当AT+CGDCONT返回错误时，执行 A T+C GA CT?查询 当前上 下文是 否已被 激活。 1. 通过 AT+CGDCONT设置APN 2. 通过 ATD*99#开始PPP拨号 Connect_Count++ 数据包交互 数据 包互 动： 1. 通过+++退出数据包交互过程。 2.当PPP连接 终止时 ，模块 将上报 N O CARRIER。 LCP协商： 1. 若使用UART，请确保MCU与模块之 间的 波特率 相同。 AUTH 协商： 1. 确保AUTH的类型为PAP（0xc023） 与C HAP（0xc22 3）其中 之一。 IPCP 协商： 1. 检查MCU是否获取合法的IP和DNS 地址。 2. 检查DNS MCU的数量是否与MCU请 求的 数量一 致。 3. 如果TA和TE之间的IPCP协商未在90 秒内 完成，终止 PPP连接 ，并重 试PPP 设置。 异常 处理 ： 1. 检查PPP终止请求数据包是否正确。 2. 若上述步骤未生效，重启模块。 IPCP协商 开始时 ， 启动 定时器 返回 CONNECT LCP 协商 OK AUTH 协商 OK 异常 处理 否 Send Count < 5 IPCP 协商 是 否 OK 90 秒内 成功进 行 IPCP协商 MCU 向 否 PPP发送 Terminate- Request数 据包 MCU 在3秒内接 是 收PPP Terminate- R equ est数据 包 Send Count++ 是 MCU已获取IP 和 否 DNS 是 数据 传输 图 3：PPP 设置推荐流程图 上海移远通信技术股份有限公司 11 / 28 LTE Standard(A)系列 PPP 应用指导 模块上电时，如果使用主串口，通过执行 AT+IPR=xxx;&W 设置波特率。执行 ATD*99#设置 PPP 之 前 ， 必须 通过 AT+CPIN? 检 查 (U)SIM 卡 的状 态。 当 (U)SIM 卡 准 备就 绪时 ， 请通过 AT+CREG?和 AT+CGREG?定期检查网络注册状态，直到网络准备就绪。 备注 1. 重启模块后，请确保 MCU 和模块同步成功。MCU 每隔 100 毫秒会向模块发送 AT直至 收到模块上报的 OK。如果使用主串口，MCU 会在成功同步波特率后通过执行 AT+IPR=xxx;&W 来 设置并保存波特率。 2. 输入下一个 AT 命令之前，MCU 需等待前一个 AT 命令的响应（如响应 OK，CME error，CMS error）。 若 60 秒内无响应，可重启模块。 3. 强烈建议不要频繁开启或关闭模块。如果连续 3 次拨号重试失败，则可立即进行第 1 次关闭或打开 （重置）模块。重置后，若拨号重试仍失败，则需等待 10 分钟后进行第 2 次重置模块，30 分钟后 进行第 3 次重置模块，一小时后进行第 4 次重置模块。 4. 如果在建立 PPP 连接后 MCU 未能将数据传输到网络，请检查 PPP 的配置和网络状态并重启模块。 上海移远通信技术股份有限公司 12 / 28 LTE Standard(A)系列 PPP 应用指导 4 PPP 连接模式 4.1. 数据模式和命令模式 模块通过 USB/UART 端口与应用程序进行信息通信（含 AT 命令和数据信息）。USB/UART 端口有两 种工作模式：数据模式和命令模式。 在建立 PPP 之前，端口处于命令模式，模块可在该状态下执行 AT 命令。当 PPP 协商开始时，端口将 进入数据模式，并在建立 PPP 连接时保持为数据模式；若未成功建立 PPP 连接，端口将处于命令模式。 在数据模式下，模块无法执行 AT 命令。 LTE Standard(A)系列模块均提供了在数据模式与命令模式之间切换的便捷方法。 4.1.1. 从数据模式切换到命令模式 4.1.1.1. 更改 DTR 电平切换为命令模式 当已建立 PPP 连接且 USB/UART 端口处于数据模式时，将 DTR 电平从低电平变为高电平即可从数据 模式切换至命令模式（需先执行 AT&D1）。切换成功后，模块将返回 OK。 4.1.1.2. 使用+++切换至命令模式 在 PPP 连接成功建立后使用+++，也可将 USB/UART 端口从数据模式切换至命令模式。为防止+++转 义序列被误解为数据，应遵循以下要求： 1) 输入+++前至少一秒内不可输入任何字符。 2) 1 秒内输入+++，在此期间不可输入任何其他字符。 3) 输入+++后 1 秒内不可输入任何字符。 当接收到+++时，USB/UART 端口将从数据模式切换到命令模式，模块将返回 OK。 上海移远通信技术股份有限公司 13 / 28 LTE Standard(A)系列 PPP 应用指导 备注 请在完成 PPP 协商后执行上述操作，否则上述操作将终止 PPP 协商并且 USB/UART 端口将退出数据模 式。完成 PPP 协商后，当 USB/UART 端口切换到命令模式时，输入的数据被当成 AT 指令，模块保持 PPP 连接状态。 4.1.2. 从命令模式切换到数据模式 4.1.2.1. 使用 ATO 切换到数据模式 当保持 PPP 连接状态时，USB/UART 端口处于命令模式，执行命令 ATO 后，即可进入数据模式。 举例 //当保持 PPP 连接状态时，USB/UART 端口处于命令模式。 ATO CONNECT //表示 TA 已进入数据模式，从 USB/UART 端口输入的所有数据将被视为 PPP 帧。 4.2. 数据模式下处理 URC 处于 PPP 连接状态下，数据模式下的来电和短信 URC 不会上报至 PPP 拨号端口，但模块的 RI 引脚 电平将从高电平变为低电平并持续 120 毫秒作为来电和短信 URC 上报的指示。MCU 可以根据 RI 引脚状态 将端口切换至命令模式以处理来电或短信。切换到命令模式后，如果仍然有来电或短信，将向 PPP 拨号端 口上报 URC。 4.3. 数据载波检测（DCD）模式 DCD 模式由 AT&C 决定。如果执行 AT&C0，DCD 引脚将不用于指示数据载波状态。而执行 AT&C1， DCD 引脚将用于指示数据载波状态。当有数据载波或开始 PPP 协商时，DCD 引脚将保持低电平状态，反 之则保持高电平状态。 备注 将模块的 USB/UART 端口从数据模式切换到命令模式（使用+++）时，DCD 状态保持不变。 上海移远通信技术股份有限公司 14 / 28 LTE Standard(A)系列 PPP 应用指导 5 终止 PPP 连接 终止 PPP 拨号连接有如下两种方式： 1. 通过 LCP Terminate-Request 消息终止 PPP 连接。推荐使用该方法终止 PPP 连接。 2. TA 也可通过更改 DTR 电平终止 PPP 连接。可先通过 AT&D2 设置 DTR 功能，将 DTR 电平从低 电平更改为高电平，数据连接将自动终止。PPP 连接完全终止后，USB/UART 端口将进入命令模 式。举例如下： //USB/UART 端口处于命令模式。 AT&D2 OK 备注 1. PPP 终止流程须在数据模式下进行操作。 2. PPP 终止流程可在 PPP 设置阶段或连接过程中随时进行。 上海移远通信技术股份有限公司 15 / 28 LTE Standard(A)系列 PPP 应用指导 6 PPP 拨号操作 本章节将分别介绍如何在 Windows 10 系统中建立 PPP 连接。有关 Linux 端的详细操作，请参考 文档 [1]。 6.1. 准备工作 在 Windows 系统中建立 PPP 拨号连接之前，必须完成以下步骤： 1. 如果(U)SIM 卡 PIN 已锁定，请将模块连接到 PC 并输入 PIN 码。 2. 确保(U)SIM 卡能够成功注册 GPRS 网络。 6.2. Windows 10 系统下的 PPP 拨号 6.2.1. 调制解调器配置 6.2.1.1. 添加新的调制解调器 如果没有安装'标准 19200 bps 调制解调器'，则需要在控制面板的调制解调器中添加新的标准调制解 调器。 上海移远通信技术股份有限公司 16 / 28 LTE Standard(A)系列 PPP 应用指导 步骤一：在主界面搜索'电话'，当出现'电话和调制解调器'时，点击进入，如下图所示。 图 4：查找电话和调制解调器 上海移远通信技术股份有限公司 17 / 28 LTE Standard(A)系列 PPP 应用指导 步骤二：双击'电话和调制解调器'选项，选择'调制解调器'→'添加(D)…'，添加新的调制解 调器，如下图所示。 图 5：添加新的调制解调器 上海移远通信技术股份有限公司 18 / 28 LTE Standard(A)系列 PPP 应用指导 步骤三：按照屏幕所示说明安装新的调制解调器：选择'标准 19200 bps 调制解调器'并选定将要安 装的端口（如'COM10'）；单击'下一步(N)'按钮，直到配置完成。有关详细信息，可参 考下图。 图 6：选择调制解调器类型 上海移远通信技术股份有限公司 图 7：选择端口 19 / 28 LTE Standard(A)系列 PPP 应用指导 图 8：安装新调制解调器成功 6.2.1.2. 配置调制解调器驱动 选择已安装的'标准 19200 bps 调制解调器'，单击'属性(P)'按钮。进入界面后，选择'调制解调 器'项，将'最大端口速度(M)'修改为'115200'（默认值）。单击'高级'项，配置'额外设置'，输 入 AT+CGDCONT=1,'IP','CMNET'。如下图所示。 上海移远通信技术股份有限公司 20 / 28 LTE Standard(A)系列 PPP 应用指导 图 9：配置调制解调器驱动 备注 上述示例中，AT+CGDCONT=1,'IP','CMNET'预定义了 PDP 上下文，其中 CID 为 1，PDP 类型为 IP， APN 为 CMNET。CMNET 为网络运营商中国移动的 APN，该 APN 应替换为网络运营商定义的值。 上海移远通信技术股份有限公司 21 / 28 LTE Standard(A)系列 PPP 应用指导 6.2.2. 拨号上网网络配置 6.2.2.1. 创建新的网络连接 步骤一：打开'控制面板'并点击'网络和 Internet'，点击'网络和共享中心'，最后点击'设置 新的连接或网络'，如下图所示。 图 10：设置新的连接或网络 上海移远通信技术股份有限公司 22 / 28 LTE Standard(A)系列 PPP 应用指导 步骤二：选择'连接到 Internet'，点击'下一步(N)'；点击'设置新连接(S)'后点击'拨号(D)' 进行连接，如下图所示。 图 11：设置新连接 上海移远通信技术股份有限公司 23 / 28 LTE Standard(A)系列 PPP 应用指导 6.2.2.2. 配置连接 在'拨打电话号码(D)'中输入字符（例如*99#），并点击'连接(C)'，如下图所示。 图 12：配置连接 上海移远通信技术股份有限公司 24 / 28 LTE Standard(A)系列 PPP 应用指导 6.2.2.3. 配置拨号工具 在窗口中的'拨号(I)'中输入字符（例如*99#），单击'属性(O)'按钮，配置'标准 19200 bps 调制 解调器（COM10）'。然后在'最高速度(bps)(M)'的下拉列表中选择'115200'。单击'确定'按钮完 成配置。有关详细信息。可参考下图。 图 13：配置拨号上网工具 上海移远通信技术股份有限公司 25 / 28 LTE Standard(A)系列 PPP 应用指导 6.2.2.4. 建立拨号上网连接 配置完成后单击'拨号(D)'按钮，界面将弹出提示框'正在验证用户名和密码'，弹出框快速弹出 '已连接'时表示拨号连接。连接状态界面图如下图所示。 图 14：正在连接到拨号连接 图 15：拨号连接成功 上海移远通信技术股份有限公司 26 / 28 LTE Standard(A)系列 PPP 应用指导 7 附录 参考文档及术语缩写 表 2：参考文档 文档名称 [1] Quectel_UMTS_LTE_5G_Linux_USB_Driver_用户指导 表 3：术语缩写 缩写 APN CHAP DCD DNS DTR GPRS GSM IP IPCP LCP MCU MS PAP PDP PIN 英文全称 中文全称 Access Point Name 接入点名称 Challenge Handshake Authentication Protocol 询问握手认证协议 Data Carrier Detection 数据载波检测 Domain Name Server 域名系统 Data Terminal Ready 数据终端就绪 General Packet Radio Service 通用分组无线业务 Global System of Mobile Communication 全球移动通信系统 Internet Protocol 网络协议 IP Control Protocol IP 控制协议 Link Control Protocol 链路控制协议 Micro Control Unit 微控制单元 Mobile Station 移动台 Password Authentication Protocol 密码认证协议 Packet Data Protocol 分组数据协议 Personal Identification Number 个人识别号码 上海移远通信技术股份有限公司 27 / 28 LTE Standard(A)系列 PPP 应用指导 PPP RI TA TE UART (U)SIM Point-to-Point Protocol 点对点协议 Ring Indicator 振铃指示器 Terminal Adapter 终端适配器 Terminal Equipment 终端设备 Universal Asynchronous Receiver Transmitter 通用异步收发传输器 (Universal) Subscriber Identity Module （通用）用户识别模块 上海移远通信技术股份有限公司 28 / 28

LTE Standard(A)系列 MUX 应用指导 LTE Standard 模块系列 版本：1.3 日期：2023-07-12 状态：受控文件 LTE Standard(A)系列 MUX 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 31 LTE Standard(A)系列 MUX 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 31 LTE Standard(A)系列 MUX 应用指导 文档历史 修订记录 版本 日期 - 2021-04-25 1.0 2021-05-21 作者 Evin ZHU Evin ZHU 1.1 2022-02-28 Evin ZHU 1.2 2022-10-31 Evin ZHU Sawyer HE/ 1.3 2023-07-12 Evin ZHU 变更表述 文档创建 受控版本 1. 增 加 文 档 适 用 模 块 EC200A 系 列 、 EC800N-CN 和 EG915N-EU。 2. 更新 AT+CMUX 中的默认值和单位。 1. 更新适用模块： 新增适用模块 EC200M-CN、EC600M-CN、EC800M-CN 和 EG912N-EN； 更新 EG915N-EU 为 EG915N 系列； 删除适用模块 EC200T 系列，EC600S-CN。 2. 新增备注：Flash 大小为 4 MB 的 EC200M-CN、EC600MCN 和 EC800M-CN 模块不支持 MUX 功能（第 1.1 章）。 3. 更新 AT+CMUX 的功能描述（第 3.3 章）。 1. 更新适用模块： ⚫ 新增 EG810M-CN 和 EG950A 系列。 ⚫ 更新 EC200N-CN 为 EC200N 系列。 2. 更新不同 Flash 大小的模块对于 MUX 功能支持情况的 备注（第 1.1 章）。 3. 更新 AT+CMUX 中的取值范围（第 3.3 章）。 上海移远通信技术股份有限公司 3 / 31 LTE Standard(A)系列 MUX 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 1.1. 适用模块 ..................................................................................................................................... 8 2 移远通信多路复用系统概况................................................................................................................. 10 3 MUX AT 命令详解 ............................................................................................................................... 11 3.1. AT 命令说明...............................................................................................................................11 3.1.1. 定义 ................................................................................................................................11 3.1.2. AT 命令语句....................................................................................................................11 3.2. AT 示例声明...............................................................................................................................11 3.3. AT+CMUX 多路复用模式....................................................................................................... 12 4 MUX 协议 ............................................................................................................................................ 14 4.1. 帧结构....................................................................................................................................... 14 4.1.1. 标记序列域 .................................................................................................................... 14 4.1.2. 地址域............................................................................................................................ 14 4.1.2.1 DLCI ................................................................................................................... 14 4.1.2.2 C/R ..................................................................................................................... 15 4.1.2.3 EA....................................................................................................................... 15 4.1.3. 控制域............................................................................................................................ 15 4.1.4. 长度域............................................................................................................................ 16 4.1.5. 信息域............................................................................................................................ 16 4.1.6. FCS 域........................................................................................................................... 17 4.2. 帧类型....................................................................................................................................... 17 4.2.1. SABM ............................................................................................................................ 17 4.2.2. UA.................................................................................................................................. 17 4.2.3. DM ................................................................................................................................. 17 4.2.4. DISC .............................................................................................................................. 17 4.2.5. UIH ................................................................................................................................ 18 4.3. MUX 控制通道 .......................................................................................................................... 18 4.3.1. 消息格式 ........................................................................................................................ 18 4.3.1.1 类型域................................................................................................................. 18 4.3.1.2 长度域................................................................................................................. 19 4.3.1.3 值域 .................................................................................................................... 19 4.3.2. 消息类型与操作 ............................................................................................................. 19 4.3.2.1 关闭 MUX（CLD）............................................................................................. 19 4.3.2.2 流控开启命令（FCon）...................................................................................... 19 4.3.2.3 流控关闭命令（FCoff）...................................................................................... 20 4.3.2.4 Modem 状态命令（MSC）................................................................................. 20 上海移远通信技术股份有限公司 4 / 31 LTE Standard(A)系列 MUX 应用指导 4.4. 步骤 .......................................................................................................................................... 23 4.4.1. 建立 DLC ....................................................................................................................... 23 4.4.2. 释放 DLC ....................................................................................................................... 23 4.4.3. 信息传输 ........................................................................................................................ 23 4.4.3.1 信息数据 ............................................................................................................. 23 4.4.4. 超时因素考虑................................................................................................................. 24 4.4.5. 流控 ............................................................................................................................... 24 5 示例 ..................................................................................................................................................... 25 5.1. 帧结构示例 ............................................................................................................................... 25 5.2. 建立通道 ................................................................................................................................... 26 5.3. 帧传输....................................................................................................................................... 27 5.4. 流控 .......................................................................................................................................... 28 5.5. 关闭 MUX ................................................................................................................................. 29 6 附录 参考文档及术语缩写 .................................................................................................................. 30 上海移远通信技术股份有限公司 5 / 31 LTE Standard(A)系列 MUX 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 8 表 2：AT 命令类型.......................................................................................................................................11 表 3：MUX 帧结构...................................................................................................................................... 14 表 4：地址域............................................................................................................................................... 14 表 5：C/R 位用法 ....................................................................................................................................... 15 表 6：编写控制域 ....................................................................................................................................... 15 表 7：长度域结构 ....................................................................................................................................... 16 表 8：消息格式 ........................................................................................................................................... 18 表 9：消息格式 – 类型域 .......................................................................................................................... 18 表 10：消息格式 – 长度域 ........................................................................................................................ 19 表 11：MUX 关闭消息 – 类型域格式 ........................................................................................................ 19 表 12：流控开启命令 – 类型域格式.......................................................................................................... 20 表 13：流控关闭命令 – 类型域格式.......................................................................................................... 20 表 14：Modem 状态命令............................................................................................................................ 20 表 15：Modem 状态命令 – 命令域格式 .................................................................................................... 21 表 16：地址域格式 ..................................................................................................................................... 21 表 17：控制信号字节格式 .......................................................................................................................... 21 表 18：接收方从控制信号字节进行映射 .................................................................................................... 22 表 19：发送方从控制信号字节进行映射 .................................................................................................... 22 表 20：参考文档 ......................................................................................................................................... 30 表 21：术语缩写 ......................................................................................................................................... 30 上海移远通信技术股份有限公司 6 / 31 LTE Standard(A)系列 MUX 应用指导 图片索引 图 1：MUX 架构 ......................................................................................................................................... 10 图 2：UA 帧（响应） ................................................................................................................................. 17 上海移远通信技术股份有限公司 7 / 31 LTE Standard(A)系列 MUX 应用指导 1 引言 本 文 介 绍 了 UE 和 TE 之 间 移 远 通 信 MUX （ 多 路 复 用 ） 协 议 ， 并 提 供 了 如 何 在 移 远 通 信 LTE Standard(A)系列模块上使用 MUX 功能的示例。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N 系列 EC200S 系列 EC600M-CN EC600N-CN EC800M-CN EC800N-CN EG810M-CN EG912N-EN EG912Y-EU EG915N 系列 EG950A 系列 上海移远通信技术股份有限公司 8 / 31 LTE Standard(A)系列 MUX 应用指导 备注 受限于模块 Flash 存储空间大小，不同型号的模块对于 MUX 功能支持有所差异，详情请咨询移远通信技 术支持。 上海移远通信技术股份有限公司 9 / 31 LTE Standard(A)系列 MUX 应用指导 2 移远通信多路复用系统概况 多路复用协议通过单个物理端口在 TE 和 UE 之间传输数据流，提供了一种数据流传输机制。移远通信 多路复用系统可以在一个物理端口上创建 4 个虚拟通道，同时传输多个数据流，且均支持 SMS 和 PPP 拨 号等。 应用程序的数据都打包在由数据和协议字段组成的不同的帧中，数据和协议字段指明了通道号、信息长 度、FCS 等。作为数据流，帧可以通过串口进行传输。到达另一方后，数据由多路复用协议栈解压为四个 数据流，并传输到应用程序。除了传输数据信息外，也能传输控制信息。 TE 和 UE 之间的每个通道，称为 DLC（数据链路连接），DLC 先后相互独立地建立起来。 TE UE 应用 应用 任务 DLC1 DLC2 DLC3 DLC4 DLC1 DLC2 DLC3 DLC4 MMUUXXD驱ri动ver DMSUMXUDXr任ive务r 物理 层 Multi DATA 图 1：MUX 架构 物理 层 上海移远通信技术股份有限公司 10 / 31 LTE Standard(A)系列 MUX 应用指导 3 MUX AT 命令详解 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 11 / 31 LTE Standard(A)系列 MUX 应用指导 3.3. AT+CMUX 多路复用模式 该命令用于启用多路复用协议控制通道并设置控制通道的参数。 AT+CMUX 多路复用模式 测试命令 AT+CMUX=? 响应 +CMUX: ( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围),(支持的范围),(支持的 范围),(支持的范围) 查询命令 AT+CMUX? OK 响应 +CMUX: [,[,[,[, [,[,[,[,]]]]]]]] 设置命令 AT+CMUX=[,[,[,[,[,[,[,[,]]]]]]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若参数与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。多路复用模式。 0 基本模式 整型。定义了多路复用控制通道的建立方式。多路复用建立后可以以不同的方式建 立虚拟通道。在没有协商虚拟通道配置的情况下，应根据控制通道来建立 虚拟通道。 0 仅使用UIH帧 1 仅使用UI帧（预留值） 2 仅使用 I 帧（预留值） 整型。物理串口的传输速率。 1 9600 bps 2 19200 bps 3 38400 bps 上海移远通信技术股份有限公司 12 / 31 LTE Standard(A)系列 MUX 应用指导 4 57600 bps 5 115200 bps 6 230400 bps 7 460800 bps 8 921600 bps 整型。最大帧尺寸。范围：1~2048；默认值：127；单位：字节。 整型。确认时间，即 UE 采取其他操作之前等待确认的时间（例如传输帧）。范围： 1~255；默认值：10；单位：10 毫秒。 整型。最大重传次数。范围：0~100；默认值：3。 整型。多路复用控制通道的响应时间。范围：2~255；默认值：30；单位：10 毫秒。 需大于。 整型。多路复用控制通道的响应时间。范围：1~255；默认值：10；单位：秒。（暂 不支持） 整型。窗口大小。定义了一个 DLC 能解析的最大的 I 帧的数目。（暂不支持） 错误码。详情请参考文档 [1]。 举例 AT+CMUX=0 OK AT+CMUX? +CMUX: 0,0,5,127,10,3,30,10,2 OK 备注 由于模块仅在 UART1 上支持多路复用功能，因此只能在 UART1 上执行 AT+CMUX。 上海移远通信技术股份有限公司 13 / 31 LTE Standard(A)系列 MUX 应用指导 4 MUX 协议 本章节主要介绍 MUX 协议的技术详情。 4.1. 帧结构 TE 与 UE 之间的所有信息均以帧的形式进行传递。 表 3：MUX 帧结构 开始标记 1 字节 地址 1 字节 控制 1 字节 长度 1~2 字节 信息 FCS 长度不确定 1 字节 结束标记 1 字节 4.1.1. 标记序列域 每个帧以标记序列字节（0xF9）开始和结束。 4.1.2. 地址域 地址域由一个字节组成，包含数据链路连接标识符（DLCI），C/R 位和地址域扩展位（EA）。如下表所 示。 表 4：地址域 第1位 EA 第2位 C/R 第3位 第4位 第5位 第6位 DLCI 第7位 第8位 4.1.2.1 DLCI DLCI 定义了 TE 和 UE 之间的虚拟通道，支持多个 DLCI，但数量以实际需求为准。DLCI 为动态分配。 上海移远通信技术股份有限公司 14 / 31 LTE Standard(A)系列 MUX 应用指导 4.1.2.2 C/R C/R（命令/响应）位定义帧为命令或响应。TE 将 C/R 位设置为 1 的命令发送给 UE，UE 响应时，将 命令中的 C/R 位设置为 1。UE 发送 C/R 位设置为 0 的命令，TE 响应时，将命令中的 C/R 位设置为 0。 表 5：C/R 位用法 命令/响应 命令 响应 方向 TE → UE UE → TE UE → TE TE → UE C/R 值 1 0 1 0 4.1.2.3 EA EA 位扩展了地址域的范围。当字节中的 EA 位设置为 1 时，表示本字节为地址域的最后一个字节。当 EA 位设置为 0 时，表示后续还有一个字节。 备注 当前仅支持 EA 为 1。 4.1.3. 控制域 控制域定义了帧的类型。帧类型详情请参考第 4.2 章。 表 6：编写控制域 帧类型 SABM（设置异步平衡模式） UA（未编号确认） DM（断连模式） DISC（断开连接） UIH（带帧头校验未编号的控制帧） 十六进制（P/F=0） 1 2 3 4 5 6 7 8 0x2F 1 1 1 1 P/F 1 0 0 0x63 1 1 0 0 P/F 1 1 0 0x0F 1 1 1 1 P/F 0 0 0 0x43 1 1 0 0 P/F 0 1 0 0xEF 1 1 1 1 P/F 1 1 1 上海移远通信技术股份有限公司 15 / 31 LTE Standard(A)系列 MUX 应用指导 UI（全部校验未编号的控制帧） 0x03 1 1 0 0 P/F 0 0 0 P/F 为轮询/结束位。一方的轮询（P）位设置为 1 时，表示向对方请求（轮询）响应或一系列的响应。 一方的结束（F）位设置为 1 时，是指向请求（轮询）命令发送响应帧。 轮询/结束（P/F）位应在命令帧和响应帧中使用。（命令帧中，P/F 位是指 P 位；在响应帧中，指 F 位。） ⚫ 一方发送消息帧时，P/F 设置为 0。 ⚫ 当一方从 DLCI 0 接收到 P/F 设置为 1 的消息帧时，将优先响应，并设置响应帧的 P/F 为 1。 ⚫ 一方发送控制帧时，P/F 设置为 1。 ⚫ 当一方通过 DLCI 0 以外的 DLC 发送 UIH 帧时，P/F 设置为 0。 ⚫ 仅处理 P/F 为 1 的 SABM 和 DISC 帧。 4.1.4. 长度域 表 7：长度域结构 第1位 EA 第2位 L1 第3位 L2 第4位 L3 第5位 L4 第6位 L5 第7位 L6 第8位 L7 L1 至 L7 位表示信息域中如下数据域的长度小于 128 字节。 第1位 0 第2位 L1 第3位 L2 第4位 L3 第5位 L4 第6位 L5 第7位 L6 第8位 L7 第1位 L8 第2位 L9 第3位 L10 第4位 L11 第5位 L12 第6位 L13 第7位 L14 第8位 L15 EA 位可用于扩展长度域范围。当一个字节中的 EA 位设置为 1 时，表示该字节是长度域的最后一个字 节。EA 位设置为 0 时，表示后续还有一个字节，此时长度域的总长度为 15 位。 4.1.5. 信息域 信息域为帧的有效负载，信息域携带用户数据和集成层信息。该域是八位字节结构，并以 UIH 帧形式 显示。 上海移远通信技术股份有限公司 16 / 31 LTE Standard(A)系列 MUX 应用指导 4.1.6. FCS 域 UIH 帧中，信息域的内容不在 FCS 中计算。FCS 仅根据地址、控制和长度域的内容进行计算。因此， 仅传送到正确 DLCI 上的内容受到保护，信息不受保护。 4.2. 帧类型 4.2.1. SABM SABM 为命令帧，用于在 TE 和 UE 之间建立 DLC。 4.2.2. UA UA 帧为 SABM 或 DISC 帧的响应帧，如下图所示： UE 移远通信 多路复用协议 SABM（建立 DLCI 1） UA（响应） DISC（关闭 DLCI 1） TE 客户端接收器 UA（响应） 图 2：UA 帧（响应） 4.2.3. DM DM 响应帧上报断开逻辑数据链路的状态。断连模式下，接收终止断连模式的 SABM 命令后，才会接 受命令。断连模式下接收到 DISC 命令后，才会发送 DM 响应。 4.2.4. DISC DISC 为命令帧，用于关闭 DLC。执行该命令之前，接收端必须发送 UA 响应来确认 DISC 命令已接 收。详情请参考图 2。 上海移远通信技术股份有限公司 17 / 31 4.2.5. UIH UIH 命令/响应可在两端发送用户数据。 LTE Standard(A)系列 MUX 应用指导 4.3. MUX 控制通道 启动 TE 和 UE 的通信时，将使用 DLCI 0 建立控制通道。该通道用于在两个 MUX 之间传送信息。 MUX 控制通道可用于建立 DLC、启动省电模式、从省电状态中唤醒以及实现流控制机制。 4.3.1. 消息格式 所有 UIH 帧均通过控制通道进行传输，其类型、长度和值的格式如下： 表 8：消息格式 类型 长度 值1 值2 … 表中的每一格表示每个域的最小单位字段。 值N 4.3.1.1 类型域 第一个类型域字节格式如下： 表 9：消息格式 – 类型域 第1位 第2位 第3位 EA C/R T1 第4位 T2 第5位 T3 第6位 T4 第7位 T5 第8位 T6 EA 位为扩展位，在最后一个字节中设置为 1。非最后一个字节中，EA 设置为 0。在移远通信 MUX 系 统中，仅传输一个字节，因此 EA 始终设置为 1。 C/R 位表示该消息为命令或响应。 T 位表示类型编码。每个命令均有独特的位序列模式。因此，单字节类型域可以编码 63 种不同的消息 类型。本文档中仅定义了单字节消息类型。 上海移远通信技术股份有限公司 18 / 31 4.3.1.2 长度域 长度域字节结构如下： LTE Standard(A)系列 MUX 应用指导 表 10：消息格式 – 长度域 第1位 第2位 第3位 EA L1 L2 第4位 L3 第5位 L4 第6位 L6 第7位 L6 第8位 L7 EA 位为扩展位，在最后一个字节中设置为 1。非最后一个字节中，EA 设置为 0。在移远通信 MUX 系 统中，仅传输一个字节，因此 EA 始终设置为 1。 L 位定义了后续值字节的数量。L1 为 LSB，L7 为 MSB；因此最多可以发送 127 个值字节的消息。 4.3.1.3 值域 每种信息类型的值字节的内容定义，详情请参考第 4.3.2 章。 4.3.2. 消息类型与操作 4.3.2.1 关闭 MUX（CLD） MUX 关闭命令用于将链路重置为正常的 AT 命令模式，而无需多路复用。MUX 关闭消息使用以下类型 域字节： 表 11：MUX 关闭消息 – 类型域格式 第1位 第2位 第3位 第4位 EA C/R 0 0 第5位 0 长度字节包含值 0，且无值（Value）字节。 第6位 0 第7位 1 第8位 1 4.3.2.2 流控开启命令（FCon） 软件流控命令用于处理聚集的流。任意一方能够接收新信息时，都会发送 FCon 命令。 长度字节包含值 0，且无值字节。类型域字节格式如下： 上海移远通信技术股份有限公司 19 / 31 LTE Standard(A)系列 MUX 应用指导 表 12：流控开启命令 – 类型域格式 第1位 第2位 第3位 EA C/R 0 第4位 0 第5位 0 第6位 1 第7位 0 第8位 1 4.3.2.3 流控关闭命令（FCoff） 流控命令用于处理聚集的流。任意一方无法接收信息时，会发送 FCoff 命令。不允许对方通过控制通道 （DLCI = 0）以外的通道发送帧。 长度字节包含值 0，并且没有值字节。类型域字节格式如下： 表 13：流控关闭命令 – 类型域格式 第1位 第2位 第3位 EA C/R 0 第4位 0 第5位 0 第6位 1 第7位 1 第8位 0 4.3.2.4 Modem 状态命令（MSC） MSC 命令用于向一个数据流中传送 V.24 控制信号。MSC 有一个强制的控制信号字节和一个可选的中 断信号字节。该命令仅在选择基本模式下适用。 建立 DLC 后，请在发送用户数据之前发送此命令。 表 14：Modem 状态命令 命令 长度 DLCI V.24 信号 中断信号 长度字节包含值 2 或值 3，并且有 2 或 3 个值字节。 DTE 和 DCE 通过此命令互相通知对方当前 V.24 控制信号的状态。MSC 的长度为 4 或 5 字节，具体 取决于中断信号。 备注 暂不支持发送中断信号。 上海移远通信技术股份有限公司 20 / 31 命令域字节格式如下： LTE Standard(A)系列 MUX 应用指导 表 15：Modem 状态命令 – 命令域格式 第1位 第2位 第3位 第4位 EA C/R 0 0 第5位 0 第6位 1 第7位 1 第8位 1 C/R 位指示该 Modem 状态是 Modem 状态命令还是 Modem 状态响应。 每次信号更改，DTE 或 DCE 都会发送该命令以指示每个信号的当前状态。DTE 或 DCE 收到 Modem 状态命令后会发送响应。表 18 和表 19 分别给出了接收方和发送方的 V.24 信号到控制信号字节中的位的映 射。 MSC 命令中，发送方发送的是自己的 V.24 信号的状态；但是在响应中，返回的是复制的从命令帧接收 到的 V.24 信号。 DLCI 域表示该命令应用的 DLC。第 2 位始终设置为 1，EA 位的具体设置请参考第 4.1.2.3 章中的说 明。 表 16：地址域格式 第1位 第2位 EA 1 第3位 第4位 第5位 第6位 DLCI 第7位 第8位 DLCI 域后的域为控制信号域，该域按照下表格式的信号状态显示出来。其他情况下，使用扩展位可以 添加其他字节。目前已定义可选的第二个字节，用于处理中断信号的传输。 表 17：控制信号字节格式 位序号 信号 第1位 EA 第2位 FC 第3位 RTC 第4位 RTR 第5位 第6位 第7位 预留（0） 预留（0） IC 第8位 DV 控制信号字节说明： ⚫ 第 1 位：在序列的最后一个字节中，EA 设置为 1；非最后一个字节中，EA 设置为 0。在移远通信 MUX 系统中，仅传输一个字节，因此 EA 始终设置为 1。 ⚫ 第 2 位：流控（FC）。设置为 1 表示无法接受数据帧。 ⚫ 第 3 位：准备通信（RTC）。设置为 1 表示设备准备好发送数据。 ⚫ 第 4 位：准备接收（RTR）。设置为 1 表示设备准备好接收数据。 上海移远通信技术股份有限公司 21 / 31 LTE Standard(A)系列 MUX 应用指导 ⚫ 第 5 位：预留位。发送者将其设置为 0，接收者将其忽略。 ⚫ 第 6 位：预留位。发送者将其设置为 0，接收者将其忽略。 ⚫ 第 7 位：来电指示符（IC）。设置为 1 表示来电。 ⚫ 第 8 位：数据有效（DV）。设置为 1 表示正在发送有效数据。 根据以下两表，控制信号字节可映射到 V.24 信号： 表 18：接收方从控制信号字节进行映射 控制信号字节 位序号、名称 3, RTC 4, RTR 7, IC 8, DV DTE 接收 信号 DSR CTS RI DCD V.24 电路 107 106 125 109 DCE 接收 信号 DTR RFR 忽略 忽略 V.24 电路 108/2 133 - 备注 电路 133、RFR（准备接收）通常分配给连接器引脚，该引脚也可用于电路 105、RTS（准备发送）。 表 19：发送方从控制信号字节进行映射 控制信号字节 位序号、名称 3, RTC 4, RTR 7, IC 8, DV DTE 发送 信号 DTR RFR 总为 0 总为 1 V.24 电路 108/2 133 - DCE 发送 信号 DSR CTS RI DCD V.24 电路 107 106 125 109 备注 电路 133、RFR（准备接收）通常分配给连接器引脚，该引脚也可用于电路 105、RTS（准备发送）。 上海移远通信技术股份有限公司 22 / 31 LTE Standard(A)系列 MUX 应用指导 如果一方由于流控无法发送帧，但希望停止接受其他帧，仍可以通过发送不包含用户数据的帧（即仅包 含控制信号字节和可选的中断信号字节）以控制信号流。 4.4. 步骤 4.4.1. 建立 DLC 多数情况下，DLC 链路由 TE 建立，然而，协议上是对等的，UE 也可以建立 DLC，但本文档不再介绍 UE 端建立 DLC 时 TE 的上一层所采取的操作。 建立 DLC 的过程如下：首先发起方发送 P 位为 1 的 SABM 帧。地址域包含与所需连接关联的 DLCI 值。如果响应方准备好建立连接，将响应 F 位为 1 的 UA 帧。如果响应方没有准备好，或不愿意建立 DLC， 会响应 F 位为 1 的 DM 帧。 一旦 DLC 建立成功，对于指定的 DLC，双方都处于连接状态，此时可以开始传输数据。 如果在时间内没有收到 UA 或 DM 响应，发起方可以重发 SABM。该操作可以一直重复，直到得 到响应，或者上层采取了其他措施。 如果没有协商流程，DLC 参数为默认值。 4.4.2. 释放 DLC 双方都可以通过发送 P 位为 1 的 DISC 帧，来释放 DLC 链路。另一方回应 F 位为 1 的 UA 帧来发出 DLC 释放的确认信号。释放成功后，DLC 就进入了断开状态。 如果收到 DISC 命令时，发现已处于断开状态，则会发送 DM 作为回应。 如果时间内没有收到 UA 或 DM 响应，发起方可以重发 DISC。该操作可以一直重复，直到得到响 应，或者上层采取了其他措施。 4.4.3. 信息传输 4.4.3.1 信息数据 在移远通信 MUX 系统中，信息使用 UIH 帧进行传递，因此需确保支持 UIH 帧。如差错恢复机制中存 在的信息延迟无法接受，可以使用 UIH 进行传递，比如音频数据传输。 发送者从集成层获取特定 DLC 的信息，并将其放置在传输帧的信息域中。一旦正确接收到 UIH 帧，其 信息域的内容就会传递到集成层。 发起方发送的帧的 C/R 位设置为 1，响应方发送的帧的 C/R 位设置为 0。双方都要把 P 位设置为 0。 C/R 详情请参考第 4.1.2.2 章。 上海移远通信技术股份有限公司 23 / 31 LTE Standard(A)系列 MUX 应用指导 UIH 帧中信息域的最大长度在 AT+CMUX 的中定义。 4.4.4. 超时因素考虑 为了检测无回应或回应丢失的情况，双方都应提供一个响应超时参数（）。超时后，应该启动错误 恢复流程。 为了解决争夺情况，双方的超时参数设置的时长最好不要相等。 一方传输一帧后，等待回应时，超时参数应该启动；收到回应后，则停止计时。如果在超时时间内发送 了需要确认的其他帧，则必须重启超时参数。 如果响应超时，则可以（重新）发送 P 位为 1 的命令，重新启动响应超时参数。 4.4.5. 流控 移远通信 MUX 系统支持软件流控机制。软件流控由 3GPP TS 27.010 中 MSC、FCoff 和 FCon 消息 帧实现。 拒绝接受帧时，TE 会将 V.24 控制信号中的 FC 位设置为 1 以向 UE 发送 MSC 消息；将 FC 位设置为 0 以通知 UE 恢复接收帧。接收 MSC 时，UE 会发出响应，表示数据传输已恢复。 拒绝接受除 DLCI 0 上的控制消息以外的任何内容时，TE 会向 UE 发送 FCoff 命令。此时，UE 将停止 通过除控制通道之外的其他数据通道发送帧，因此控制通道处于激活状态并可以自由发送控制消息。TE 可 以向 UE 发送 FCon 命令以恢复传输。UE 收到 FCoff 或 FCon 命令时，将向 TE 返回响应。 MSC 和 FCon 之间的区别在于：前者仅控制一个数据通道，后者控制除控制通道以外的其他数据通道。 上海移远通信技术股份有限公司 24 / 31 LTE Standard(A)系列 MUX 应用指导 5 示例 5.1. 帧结构示例 示例 1： 开始标记 F9 帧头 地址域 03 DLCI 0 控制域 3F SABM 帧 此示例为打开 DLCI 0 的 SABM 帧。 长度域 01 0，无信息域 FCS 1C 结束标记 F9 帧尾 示例 2： 开始标记 F9 帧头 地址域 05 DLCI 1 控制域 EF UIH 帧 长度域 09 4 该示例为传输 AT 命令字符串'ATI'的 UIH 帧。 信息域 41 54 49 0D AT 命令字符串 'ATI' FCS 结束标记 58 F9 帧尾 示例 3： 开始标记 F9 帧头 地址域 01 DLCI 0 控制域 EF UIH 帧 长度域 0B 5 信息域 FCS 结束标记 E3 07 07 0D 01 79 MSC 消息， 长度 3 字节 F9 帧尾 该示例为 UIH 帧中携带的 MSC 消息，用于发送 V2.4 信号 0x0D。 上海移远通信技术股份有限公司 25 / 31 5.2. 建立通道 LTE Standard(A)系列 MUX 应用指导 步骤 1：启动 MUX 序号 步骤 数据方向 TE 通过 AT 命令启用 UE MUX 功能 TE → UE 1 UE 发送消息 TE ← UE 十六进制 备注 61 74 2B 63 6D 75 78 3D 30 0D 0D 0A 4F 4B 0D 0A 0D 0A 61 74 2B 63 6D 75 78 3D 30 0D 0D 0A 4F 4B 0D 0A 0D 0A AT+CMUX=0 AT+CMUX=0 OK 步骤 2：建立 DLCI 0 序号 步骤 数据方向 TE 通过发送 SABM 帧请求 建立控制通道 DLCI 0 TE → UE 1 UE 在收到 SABM 帧后回复 UA 响应，并接受创建 DLCI 0 TE ← UE 十六进制 F9 03 3F 01 1C F9 F9 03 73 01 D7 F9 备注 SABM 帧 UA 帧 步骤 3：建立 DLCI 1~4 序号 步骤 数据方向 TE 通过发送 SABM 帧请求 建立 DLCI 1 TE → UE 1 UE 在收到 SABM 时回复 DM 响应，但拒绝创建 DLCI 1 TE ← UE TE 通过发送 SABM 帧请求 建立 DLCI 1 TE → UE UE 在收到 SABM 时回复 UA 响应并接受创建 DLCI 1 TE ← UE UE 发送 MSC 消息帧 2 UE 发送 OK TE ← UE TE ← UE TE 发送 MSC 消息帧 TE → UE UE 回复响应 TE ← UE 十六进制 F9 07 3F 01 DE F9 备注 F9 07 1F 01 F4 F9 F9 07 3F 01 DE F9 F9 07 73 01 15 F9 F9 01 EF 0B E3 07 07 0D 01 79 F9 F9 05 EF 0D 0D 0A 4F 4B 0D 0A 5F F9 F9 01 EF 0B E3 07 07 0D 01 79 F9 F9 01 EF 0B E1 07 07 0D 01 79 F9 上海移远通信技术股份有限公司 26 / 31 LTE Standard(A)系列 MUX 应用指导 TE 通过发送 SABM 帧请求 建立 DLCI 2 UE 在收到 SABM 时回复 UA 响应并接受创建 DLCI 2 TE → UE TE ← UE 3 UE 发送 MSC 消息帧 TE ← UE TE 发送 MSC 消息帧 TE → UE UE 回复响应 TE ← UE DLCI 3 和 DLCI 4 的建立方 4 法同上 至此，已经形成了 4 个通道， 5 移远通信 MUX 系统可以正 常运行。 F9 0B 3F 01 59 F9 F9 0B 73 01 92 F9 F9 01 EF 0B E3 07 0B 0D 01 79 F9 F9 01 EF 0B E3 07 0B 0D 01 79 F9 F9 01 EF 0B E1 07 0B 0D 01 79 F9 该示例为 UIH 帧中携带的 MSC 消息，用于发送 V2.4 信号 0x0D。 5.3. 帧传输 建立控制通道和数据通道后，TE 和 UE 可以通过 UIH 帧相互发送数据。 帧传输： 序号 步骤 数据方向 TE 在 DLCI 1 上发送 AT 命 令字符串'ATI' TE → UE 1 UE 在 DLCI 1 上回复响应 TE ← UE TE 在 DLCI 2 上发送 AT 命 2 令字符串'ATI' TE → UE 上海移远通信技术股份有限公司 十六进制 备注 F9 05 EF 09 41 54 49 0D 58 F9 UIH 帧 F9 05 EF 09 41 54 49 0D 58 F9 F9 05 EF 9B 0D 0A 53 49 4D 43 4F 4D 5F 4C 74 64 0D 0A 53 49 4D 43 4F 4D 5F 53 49 4D 33 30 30 0D 0A 52 65 76 69 73 69 6F 6E 3A 53 49 4D 33 30 30 4D 33 32 28 53 50 41 4E 53 49 4F 4E 29 5F 56 31 30 2E 30 2E 38 5F 42 55 49 4C 44 30 33 0D 0A 0D 0A 47 F9 F9 05 EF 09 4F 4B 0D 0A 58 F9 UIH 帧 F9 09 EF 07 41 54 0D 35 F9 UIH 帧 27 / 31 UE 在 DLCI 2 上回复响应 TE ← UE DLCI 3 和 DLCI 4 上的帧 3 传输同上 LTE Standard(A)系列 MUX 应用指导 F9 09 EF 07 41 54 0D 35 F9 F9 09 EF 0D 0D 0A 4F 4B 0D UIH 帧 0A D8 F9 5.4. 流控 流控： 序号 1 2 3 4 5 6 步骤 数据方向 UE 在控制通道 DLCI 0 上发送 FC 位为 1 的 MSC 消息，表示拒绝接 TE ← UE 受 DLCI 1 上的所有内容 UE 在控制通道 DLCI 0 上发送 FC 位为 0 的 MSC 消息，表示 DLCI TE ← UE 0 数据传输已恢复 TE 在控制通道 DLCI 0 上发送 FC 位为 1 的 MSC 消息，表示拒绝接 TE → UE 受 DLCI 1 上的所有内容 TE 在控制通道 DLCI 0 上发送 FC 位为 0 的 MSC 消息，表示 DLCI TE → UE 1 数据传输已恢复 TE 在 DLCI 0 上发送 FCoff 消息， 表示拒绝接收除 DLCI 0 之外的所 TE → UE 有 DLC 上的内容 TE 通过 DLCI 0 发送 FCon 消息， 表示数据传输已恢复 TE → UE 十六进制 备注 F9 01 EF 0B E3 07 07 8F 01 79 F9 F9 01 EF 0B E3 07 07 8D 01 79 F9 F9 01 EF 0B E3 07 07 8F 01 79 F9 F9 01 EF 0B E3 07 07 8D 01 79 F9 F9 01 EF 05 63 01 93 F9 F9 01 EF 05 A3 01 93 F9 上海移远通信技术股份有限公司 28 / 31 5.5. 关闭 MUX 关闭流程： 序号 步骤 数据方向 TE 发送 DISC 帧以请求关闭 TE → UE 1 DLCI 1 UE 回复 UA 帧以接受请求 TE ← UE TE 发送 DISC 帧以请求关闭 TE → UE 2 DLCI 2 UE 回复 UA 帧以接受请求 TE ← UE TE 发送 DISC 帧以请求关闭 TE → UE 3 DLCI 3 UE 回复 UA 帧以接受请求 TE ← UE TE 发送 DISC 帧以请求关闭 TE → UE 4 DLCI 4 UE 回复 UA 帧以接受请求 TE ← UE TE 发送 CLD 消息帧以请求关闭 DLCI 0 上的 MUX TE → UE 5 UE 确认 CLD 消息以接受请求 TE ← UE 6 至此，已关闭 MUX LTE Standard(A)系列 MUX 应用指导 十六进制 备注 F9 07 53 01 3F F9 F9 07 73 01 15 F9 F9 0B 53 01 B8 F9 F9 0B 73 01 92 F9 F9 0F 53 01 7A F9 F9 0F 73 01 50 F9 F9 13 53 01 77 F9 F9 13 73 01 5D F9 F9 03 EF 05 C3 01 F2 F9 F9 03 EF 05 C1 01 F2 F9 上海移远通信技术股份有限公司 29 / 31 LTE Standard(A)系列 MUX 应用指导 6 附录 参考文档及术语缩写 表 20：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_AT 命令手册 表 21：术语缩写 缩写 C/R CLD DCE DISC DLC DLCI DM DTE DV FC FCoff FCon FCS IC 英文全称 中文全称 Command/Response 命令/响应 Multiplexer Close Down 关闭多路复用 Data Communications Equipment 数据通信设备 Disconnect 断开连接 Data Link Connection 数据链路连接 Data Link Connection Identifier 数据链路连接标识 Disconnected Mode 断连模式 Data Terminal Equipment (typically computer, 数据终端设备 MCU, external controller) Data Valid 数据有效 Flow Control 流控 Flow Control Off Command 流控关闭命令 Flow Control On Command 流控开启命令 Frame Check Sequence 帧校验序列 Incoming Call Indicator 来电指示符 上海移远通信技术股份有限公司 30 / 31 ME MSC MUX PSC RFR RTC RTR RTS SABM TE UA UE UI UIH LTE Standard(A)系列 MUX 应用指导 Mobile Equipment 移动设备 Modem Status Command Modem 状态命令 Multiplexer 多路复用 Power Saving Control 省电控制 Ready for Receiving 准备接收 Ready to Communicate 准备通信 Ready to Receive 准备接收 Ready to Send 准备发送 Set Asynchronous Balanced Mode 设置异步平衡模式 Terminal Equipment 终端设备 Unnumbered Acknowledgement 未编号确认 User Equipment 用户设备 Unnumbered Information 全部校验未编号的控制帧 Unnumbered Information with Header Check 带帧头校验未编号的控制帧 上海移远通信技术股份有限公司 31 / 31

LTE Standard(A)系列 IMS XML 应用指导 LTE Standard 模块系列 版本：1.0 日期：2023-09-01 状态：受控文件 LTE Standard(A)系列 IMS XML 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为用户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持用户的产品设计。用户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 22 LTE Standard(A)系列 IMS XML 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 22 LTE Standard(A)系列 IMS XML 应用指导 文档历史 修订记录 版本 1.0 日期 2022-10-13 2023-09-01 作者 Evin ZHU Evin ZHU 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 22 LTE Standard(A)系列 IMS XML 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 1.2. IMS XML 介绍 ............................................................................................................................. 7 1.2.1. IMS XML 文件结构 ........................................................................................................... 7 1.2.2. IMS XML 修改方法 ........................................................................................................... 8 1.3. IMS XML 更新流程 .................................................................................................................... 10 2 IMS XML 相关 AT 命令 ........................................................................................................................ 13 2.1. AT 命令说明 .............................................................................................................................. 13 2.1.1. 定义 ................................................................................................................................ 13 2.1.2. AT 命令语句.................................................................................................................... 13 2.2. AT 示例声明 .............................................................................................................................. 14 2.3. AT+QIMSXML 设置/查询 IMS XML 文件 ................................................................................. 14 2.3.1. AT+QIMSXML='FORCEUPDATE' 强制更新为客户自定义配置的 IMS XML 文件 ...... 14 2.3.2. AT+QIMSXML='DEFAULT' 强制更新为默认配置的 IMS XML 文件 ............................ 15 2.3.3. AT+QIMSXML='VERSION' 查询 IMS XML 文件版本 .................................................. 15 3 示例 ...................................................................................................................................................... 16 3.1. XML 文件示例............................................................................................................................ 16 3.2. IMS XML 更新方式 .................................................................................................................... 17 3.2.1. FILE 方式更新 IMS XML................................................................................................. 17 3.2.2. FTP 方式更新 IMS XML ................................................................................................. 18 3.2.3. HTTP 方式更新 IMS XML............................................................................................... 19 4 附录 参考文档及术语缩写 .................................................................................................................... 21 上海移远通信技术股份有限公司 4 / 22 LTE Standard(A)系列 IMS XML 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令及响应类型........................................................................................................................... 13 表 3：参考文档 ........................................................................................................................................... 21 表 4：术语缩写 ........................................................................................................................................... 21 上海移远通信技术股份有限公司 5 / 22 LTE Standard(A)系列 IMS XML 应用指导 1 引言 移远通信 LTE Standard(A)系列模块支持 VoLTE 功能。VoLTE 功能实现需要激活 IMS PDN 以及 IMS 注册携带运营商规定的相关参数，IMS 相关参数存储在 IMS XML 配置文件中。由于全球运营商的 IMS 相 关参数具有较大差异，每个运营商需要一个 IMS XML 配置项。受模块存储空间限制，无法实现集成所有 运营商的 IMS 配置。LTE Standard(A)系列模块支持用户自定义 IMS 服务接口的 XML 配置文件，根据实 际场景配置 IMS XML，以满足不同运营商对 VoLTE 的需求。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A系列 EC200M-CN EC200N系列 EC200S系列 EC600M-CN EC600N-CN EC800M-CN EC800N-CN EG810M-CN EG912N-EN EG912Y-EU EG915N系列 EG950A系列 上海移远通信技术股份有限公司 6 / 22 LTE Standard(A)系列 IMS XML 应用指导 备注 受限于模块 Flash 存储空间大小，不同型号的模块对于 IMS XML 自定义配置功能支持有所差异，详情 请咨询移远通信技术支持。 1.2. IMS XML 介绍 IMS XML 文件是 IMS 网络中使用的专用配置文件。它们包含了 IMS 功能所需的参数配置项，使运营 商可以根据其特定的网络要求来定制和提供 IMS 服务。 1.2.1. IMS XML 文件结构 1. IMS XML 文件结构示例如下： cucc …… 2. IMS XML 文件支持的元素基本格式以及特性： 1) 基本格式： 元素。例如： cucc 2) 特性： ⚫ 属性元素可以互相嵌套，例如：cucc， 该元素既可以作为 operator 的元素，也可包含一个 name 属性，其对应的元素内容为 cucc。 ⚫ IMS XML 文件第一行开头为固定格式，用于表示 XML 版本号和编码。例如：，表示 XML 文件的版本为 1.0，编码格式为 UTF-8。 上海移远通信技术股份有限公司 7 / 22 LTE Standard(A)系列 IMS XML 应用指导 ⚫ IMS XML 文件需要一个元素作为根元素，例如： …… ⚫ XML 文件严格区分大小写且元素名称不能相同，而 IMS XML 文件不区分大小写且可以使 用相同元素名称。 1.2.2. IMS XML 修改方法 用 户 拿到 IMS XML 示例 文 件 后， 需 按照 实 际情 况 修 改三 个 属性 ，即 oem version 、 user user_info 和 operator。 1. oem version：IMS XML 文件版本号。范围：1~65535。更新 IMS XML 时会检测此属性配置项。 若未配置该属性值，更新 IMS XML 时会报错。例如，当 IMS XML 文件版本号为 3 时，则： 2. user user_info：用户使用 IMS XML 标识配置CUSTOMER，若没有该属性标识，更新 IMS XML 时会报错。例如，用户 IMS XML 文件添加标识后： 3. operator：根据该属性包含的运营商 PLMN，查找模块注网过程中 IMS 注册需要的对应配置项参 数。 1) operator 属性如下： ⚫ id：运营商英文缩写。 ⚫ c：运营商 PLMN。该配置较为关键，用于 IMS 注册时，根据注网 PLMN 匹配 IMS XML 文件对应的运营商 operator 配置项。例如，中国联通 operator XML 属性： 2) operator 包含的元素不同，配置项采用键值（Key/Value）对的方式，共分为 3 种类型： ⚫ 字符串型： PS_ONLY ⚫ 布尔型： ⚫ 整型： 上海移远通信技术股份有限公司 8 / 22 LTE Standard(A)系列 IMS XML 应用指导 3) operator 包含的元素需要的主要配置项如下所示，若运营商配置与默认值相同，则无需配置： ⚫ KEY_IMS_OPERATOR：字符串类型。IMS 运营商名称，与 id 相同。默认值：CMCC。 ⚫ KEY_XCAP_PDP_APN：字符串类型。补充业务 XCAP 使用的 APN 名称。默认值： CMNET。 ⚫ KEY_IMS_PDP_TYPE：字符串类型。IMS PDP 承载的 IP 类型，由运营商确定。默认 值：IPv4v6。 ⚫ KEY_IMS_PDP_APN：字符串类型。IMS 承载 APN，由运营商确定。默认值：IMS。 ⚫ KEY_MTU_SIZE：整型。MTU 大小，由 3GPP IMS 数据包的 MTU（最大传输单元） 确定。实际数据大小大于该值，则使用 TCP 传输，否则选择 UDP 传输。若 IMS 仅支持 UDP 传输，则设置为最大值。范围：0–65535；默认值：1350。 ⚫ KEY_IP_PACKET_SIZE：整型。IMS 信令 IP 分片包大小，由运营商确定。若超出阈值， 网络可能丢弃该数据包。范围：0–65535；默认值：1200。 ⚫ KEY_SIP_TIMER_TRING：整型。IMS 被叫时，从发送 180 Ringing 开始计时，到 CALL 建立等待最大时间。默认值：60000；单位：ms。 ⚫ KEY_SIP_TIMER_TRINGBACK：整型。IMS 主叫时，从收到 180 Ringing 开始计时， 到 CALL 建立等待最大时间。默认值：60000；单位：ms。 ⚫ KEY_SIP_TIMER_RING_INTERVALL：整型。IMS CALL 被叫时，RING URC 上报时 间间隔。默认值：5000；单位 ms。 ⚫ KEY_SMS_CLASS0_STORAGE_ENABLE：布尔型。使能 CLASS0&MT=1 条件下收 到短信以+CMTI 或者+CMT 形式上报。默认值：TRUE。 运营商示例如下： ⚫ 中国联通： cucc 3gnet 备注 若运营商 VoLTE IMS 有其他特定配置项参数不在上述列举元素中，请联系移远通信技术支持协助添 加，并沟通确定相关的配置参数。 上海移远通信技术股份有限公司 9 / 22 1.3. IMS XML 更新流程 N LTE Standard(A)系列 IMS XML 应用指导 AT+Q FL ST='Settings_ prefere nce s.xml' UFS是否 存在 Settings_preferen ce s. x ml 文件 ？ N FTP /HTTP /FIL E AT+Q FDEL= 'Settings_ Y prefere nce s.xml' 删除 已存在 的 Settings_ prefere nce s.xml 下载 Settings_preferen ce s .xml到文 件系统 AT+Q IMSXML= 'FORCE UP DA TE' 检测 Settings_preferen ce s.xml CUS TO ME R标识、oem version是否 存在？ Y 使用 Settings_preferen ce s .xml更新IMS XML 返回 ER R OR N IMS XML更新 完成? Y 返回 OK 执行 AT +C F U N= 1, 1 重启 模块 结束 图 1：IMS XML 更新流程 上海移远通信技术股份有限公司 10 / 22 LTE Standard(A)系列 IMS XML 应用指导 LTE Standard(A)系列模块支持通过 FILE、FTP 和 HTTP 三种方式上传 XML 文件到文件系统 UFS 中， 通过相关的 AT 命令将文件系统中的 XML 文件更新到 IMS XML 存储区域中。详细步骤如下所示： 步骤1： 上传 XML 文件到文件系统 UFS 中 1) 执 行 AT+QFLST='Settings_preferences.xml' 查 询 文 件 系 统 中 是 否 存 在 Settings_preferences.xml 文 件 。 若 存 在 ， 则 返 回 文 件 大 小 ， 然 后 通 过 AT+QFDEL='Settings_preferences.xml' 删 除 该 文 件 ； 若 不 存 在 ， 则 返 回 +CME ERROR: 400。详细信息可参考文档 [1]。 2) XML 文件不存在或删除后，上传新的用户 XML 文件到文件系统 UFS 中 ⚫ FILE 方式上传 XML 文件： 执行 AT+QFUPL=[,[,[,]]]，通过 FILE 方式 上传 XML 文件到文件系统中，详细信息可参考文档 [1]。 ⚫ FTP 方式下载 XML 文件： 执行 AT+QFTPGET=,[,[,]]，通过 FTP 方式下载 XML 文件到文件系统中，FTP 下载流程以及相关 AT 命令详细信息可参考 文档 [2]。 ⚫ HTTP 方式下载 XML 文件： 执行 AT+QHTTPREADFILE=[,]，通过 HTTP 方式下载 XML 文 件到文件系统中，HTTP 下载流程以及相关 AT 命令详细信息可参考文档 [3]。 步骤2： 更新 XML 文件 通过 AT+QIMSXML='FORCEUPDATE'将文件系统中的 Settings_preferences.xml 文件强 制更新到 IMS XML 存储区域。 步骤3： 确认是否更新成功 若 AT+QIMSXML='FORCEUPDATE'返回 OK，则执行 AT+QIMSXML='VERSION'查询 IMS XML 版本以确定是否更新成功。执行 AT+CFUN=1,1 重启模块，更新后的 IMS XML 文 件才会生效。 上海移远通信技术股份有限公司 11 / 22 LTE Standard(A)系列 IMS XML 应用指导 备注 1. 若文件系统中 Settings_preferences.xml 文件没有包含 CUSTOMER 配置或 oem version 为非法 值，均会报错，则更新 XML 文件失败。 2. 执行 AT+QIMSXML='DEFAULT'会恢复 IMS XML 文件的出厂默认配置，用户配置参数会丢失。 3. 若模块受到干扰等导致 IMS XML 文件损坏，且 IMS XML 文件无法自动恢复，模块会默认使用出厂 配置的 XML 文件。 4. 执行 AT+QIMSXML='FORCEUPDATE'、AT+QIMSXML='DEFAULT'更新 IMS XML 时，在返 回 OK 或者 ERROR 前，禁止断电关机；否则会出现 IMS XML 文件异常且无法自动恢复，模块会 默认使用出厂配置。 上海移远通信技术股份有限公司 12 / 22 LTE Standard(A)系列 IMS XML 应用指导 2 IMS XML 相关 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了， 仅显示命令和响应。 表 2：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 13 / 22 LTE Standard(A)系列 IMS XML 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系 或连续性。 2.3. AT+QIMSXML 设置/查询 IMS XML 文件 AT+QIMSXML 设置/查询 IMS XML 文件 测试命令 AT+QIMSXML=? 响应 +QIMSXML: 'FORCEUPDATE' +QIMSXML: 'DEFAULT' +QIMSXML: 'VERSION' 最大响应时间 OK 300 毫秒 2.3.1. AT+QIMSXML='FORCEUPDATE' 强制更新为客户自定义配置的 IMS XML 文件 AT+QIMSXML='FORCEUPDATE' 强制更新为客户自定义配置的 IMS XML 文件 设置命令 AT+QIMSXML='FORCEUPDATE' 响应 OK 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效。 上海移远通信技术股份有限公司 14 / 22 LTE Standard(A)系列 IMS XML 应用指导 2.3.2. AT+QIMSXML='DEFAULT' 强制更新为默认配置的 IMS XML 文件 AT+QIMSXML='DEFAULT' 强制更新为默认配置的 IMS XML 文件 设置命令 AT+QIMSXML='DEFAULT' 响应 OK 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效。 2.3.3. AT+QIMSXML='VERSION' 查询 IMS XML 文件版本 AT+QIMSXML='VERSION' 查询 IMS XML 文件版本 设置命令 AT+QIMSXML='VERSION' 响应 +QIMSXML: 'VERSION', OK 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效。 参数 整型。IMS XML 文件版本号。范围：1~65535。 上海移远通信技术股份有限公司 15 / 22 LTE Standard(A)系列 IMS XML 应用指导 3 示例 3.1. XML 文件示例 示例包含中国移动、中国电信、中国联通及意大利 TIM 运营商 VoLTE 配置： cmcc sip:mmtel@conffactory.ims.mnc000.mcc460.3gppnetwork.org ctcc ctnet cucc 3gnet 上海移远通信技术股份有限公司 16 / 22 LTE Standard(A)系列 IMS XML 应用指导 TIM_IT xcap.tim.it mtasxdms IPv4 3.2. IMS XML 更新方式 3.2.1. FILE 方式更新 IMS XML LTE Standard(A)系列模块支持通过 FILE 方式上传 XML 文件到文件系统 UFS 中，通过相关的 AT 命 令将文件系统中的 XML 文件更新到 IMS XML 存储区域中。详细信息，请参考第 1.3 章。 AT+QFLST='Settings_preferences.xml' +QFLST: 'UFS:Settings_preferences.xml',1411 //UFS 中有 Settings_preferences.xml 文件，文件 大小为 1411 字节。 OK AT+QFDEL='UFS:Settings_preferences.xml' //删除 UFS 中的 Settings_preferences.xml 文件。 OK AT+QFUPL='Settings_preferences.xml',1676,1 //上传新的用户 XML 文件，文件大小为 1676 字节。 CONNECT +QFUPL: 1676,4d0b OK AT+QIMSXML='VERSION' +QIMSXML: 'VERSION',5 //查询 IMS XML 文件版本。 OK AT+QIMSXML='FORCEUPDATE' AT+QIMSXML='VERSION' +QIMSXML: 'VERSION',6 //强制更新为客户自定义配置的 IMS XML 文件。 //更新完成后，查询当前 IMS XML 文件版本。 OK 上海移远通信技术股份有限公司 17 / 22 LTE Standard(A)系列 IMS XML 应用指导 3.2.2. FTP 方式更新 IMS XML LTE Standard(A)系列模块支持通过 FTP 方式上传 XML 文件到文件系统 UFS 中，通过相关的 AT 命 令将文件系统中的 XML 文件更新到 IMS XML 存储区域中。详细信息，请参考第 1.3 章。 AT+QFLST='Settings_preferences.xml' +QFLST: 'UFS:Settings_preferences.xml',1411 //UFS 中有 Settings_preferences.xml 文件，文件 大小为 1411 字节。 OK AT+QFDEL='UFS:Settings_preferences.xml' //删除 UFS 中的 Settings_preferences.xml 文件。 OK //FTP 相关设置 AT+QICSGP=1,1,'UNINET','','',1 // 设 置 PDP 上 下 文 为 1 ， 中 国 联 通 APN 为 'UNINET'。 OK AT+QIACT=1 //激活 PDP 上下文 1。 OK //激活成功。 AT+QIACT? //查询 PDP 上下文状态。 +QIACT: 1,1,1,'10.7.157.1' OK AT+QFTPCFG='contextid',1 //设置 PDP 上下文为 1（须先激活 PDP 上下文 ID）。 OK AT+QFTPCFG='account','test','test' //设置用户名和密码。 OK AT+QFTPCFG='filetype',1 //设置文件类型为 ASCII。 OK AT+QFTPCFG='transmode',1 //设置为被动传输方式。 OK AT+QFTPCFG='rsptimeout',90 //设置最大响应时间（默认为 90 秒）。 OK AT+QFTPOPEN='220.180.239.212',8309 //登录 FTP 服务器。 OK +QFTPOPEN: 0,0 //从 FTP(S)服务器下载 XML 文件 AT+QFTPGET='evin_test/Settings_preferences.xml','UFS:Settings_preferences.xml' OK +QFTPGET: 0,1676 AT+QIMSXML='VERSION' +QIMSXML: 'VERSION',5 //文件下载成功，文件大小为 1676 字节。 //查询 IMS XML 文件版本。 OK AT+QIMSXML='FORCEUPDATE' //强制更新为客户自定义配置的 IMS XML 文件。 上海移远通信技术股份有限公司 18 / 22 OK AT+QIMSXML='VERSION' +QIMSXML: 'VERSION',6 OK LTE Standard(A)系列 IMS XML 应用指导 //更新完成后，查询当前 IMS XML 文件版本。 3.2.3. HTTP 方式更新 IMS XML LTE Standard(A)系列模块支持通过 HTTP 方式上传 XML 文件到文件系统 UFS 中，通过相关的 AT 命 令将文件系统中的 XML 文件更新到 IMS XML 存储区域中。详细信息，请参考第 1.3 章。 AT+QFLST='Settings_preferences.xml' +QFLST: 'UFS:Settings_preferences.xml',1411 //UFS 中有 Settings_preferences.xml 文件，文件 大小为 1411 字节。 OK AT+QFDEL='UFS:Settings_preferences.xml' OK //HTTP 相关设置 AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //删除 UFS 中的 Settings_preferences.xml 文件。 // 设 置 PDP 上 下 文 为 1 ， 中 国 联 通 APN 为 'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPURL=54,80 //设置要访问的 URL 长度及超时时间。 CONNECT http://11.31.84.134:8300/test/Settings_preferences.xml //输入长度为 54 个字节的 URL（此 URL 仅为 示例，请根据实际情况输入正确的 URL）。 OK AT+QHTTPGET=80 //发送 HTTP GET 请求，最大响应时间为 80 秒。 OK +QHTTPGET: 0,200,1676 //若 HTTP 响应头信息中包括 CONTENT-LENGTH， 则将上报信息。 AT+QHTTPREADFILE='UFS: Settings_preferences.xml',80 //通过文件读取 HTTP(S)服务器响 OK 应信息。 +QHTTPREADFILE: 0 AT+QIMSXML='VERSION' +QIMSXML: 'VERSION',5 //成功储存 HTTP 响应头信息和响应体。 //查询 IMS XML 文件版本。 上海移远通信技术股份有限公司 19 / 22 LTE Standard(A)系列 IMS XML 应用指导 OK AT+QIMSXML='FORCEUPDATE' OK AT+QIMSXML='VERSION' +QIMSXML: 'VERSION',6 OK //强制更新为客户自定义配置的 IMS XML 文件。 //更新完成后，查询当前 IMS XML 文件版本。 备注 有关 AT+QICSGP 和 AT+QIACT 详情，请参考文档 [4]。 上海移远通信技术股份有限公司 20 / 22 LTE Standard(A)系列 IMS XML 应用指导 4 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_FILE_应用指导 [2] Quectel_LTE_Standard(A)系列_FTP(S)_应用指导 [3] Quectel_LTE_Standard(A)系列_HTTP(S)_应用指导 [4] Quectel_LTE_Standard(A)系列_TCP(IP)_应用指导 表 4：术语缩写 缩写 英文全称 APN CUCC FTP HTTP ID IMS OEM PDN PDP PLMN PS TCP Access Point Name China Unicom Communications Corporation File Transfer Protocol Hypertext Transfer Protocol Identifier IP Multimedia Subsystem Original Equipment Manufacturer Public Data Network Packet Data Protocol Public Land Mobile Network Packet Switch Transmission Control Protocol 中文全称 接入点名称 中国联通 文件传输协议 超文本传输协议 标识符 IP 多媒体系统 原始设备制造商 公用数据网 分组报文协议 公共陆地移动网 分组交换 传输控制协议 上海移远通信技术股份有限公司 21 / 22 UDP UFS VoLTE XCAP XML User Datagram Protocol UNIX File System Voice over Long-Term Evolution XML Configuration Access Protocol Extensible Markup Language LTE Standard(A)系列 IMS XML 应用指导 用户数据报协议 UNIX 文件系统 长期演进语音承载 XML 配置访问协议 可扩展标记语言 上海移远通信技术股份有限公司 22 / 22

LTE Standard(A)系列 FTP(S)应用指导 LTE Standard 模块系列 版本：1.3 日期：2023-04-10 状态：受控文件 LTE Standard(A)系列 FTP(S)应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 49 LTE Standard(A)系列 FTP(S)应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 49 LTE Standard(A)系列 FTP(S)应用指导 文档历史 修订记录 版本 1.0 日期 2021-04-21 2021-05-13 作者 Carson LIU Carson LIU 1.1 2022-02-25 Carson LIU 1.2 2022-07-25 Carson LIU 1.3 2023-04-10 Carson LIU 变更表述 文档创建 受控版本 1. 新 增 适 用 模块 EC200A 系 列 、 EC800N-CN 和 EG915N-EU。 2. 删除 EG912Y-CN 模块。 3. LTE Standard(A)系列模块暂不支持物理存储媒介 RAM，删除相关内容。 4. 新增命令 AT+QFTPCFG='restenable'[,]（第 2.1 章）。 1. 新 增 适 用 模 块 EC200M-CN 、 EC600M-CN 、 EC800M-CN、EG915N-LA 和 EG912N-EN。 2. 删除适用模块 EC200T 系列。 1. 新增适用模块 EG810M-CN 和 EG950A-EL。 2. 删除适用模块 EC600S-CN。 上海移远通信技术股份有限公司 3 / 49 LTE Standard(A)系列 FTP(S)应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 1.2. AT 命令说明................................................................................................................................ 8 1.2.1. 定义 ................................................................................................................................. 8 1.2.2. AT 命令语句..................................................................................................................... 8 1.3. AT 示例声明................................................................................................................................ 9 1.4. FTP(S)命令使用流程 .................................................................................................................. 9 1.5. 数据模式说明............................................................................................................................ 10 2 FTP(S) AT 命令详解 ........................................................................................................................... 11 2.1. AT+QFTPCFG 配置 FTP(S)服务器参数.................................................................................11 2.2. AT+QFTPOPEN 登录 FTP(S)服务器 .................................................................................... 15 2.3. AT+QFTPCWD 配置 FTP(S)服务器当前目录 ....................................................................... 16 2.4. AT+QFTPPWD 获取 FTP(S)服务器当前目录........................................................................ 17 2.5. AT+QFTPPUT 上传文件至 FTP(S)服务器............................................................................. 18 2.6. AT+QFTPGET 从 FTP(S)服务器下载文件 ............................................................................ 20 2.7. AT+QFTPSIZE 获取 FTP(S)服务器文件大小 ........................................................................ 22 2.8. AT+QFTPDEL 删除 FTP(S)服务器文件................................................................................. 23 2.9. AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 ........................................................................ 24 2.10. AT+QFTPRMDIR 删除 FTP(S)服务器文件夹........................................................................ 24 2.11. AT+QFTPLIST 获取 FTP(S)服务器目录内容......................................................................... 25 2.12. AT+QFTPNLST 获取 FTP(S)服务器目录文件名 ................................................................... 27 2.13. AT+QFTPMLSD 获取标准化文件和目录信息........................................................................ 28 2.14. AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 .............................................................. 30 2.15. AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹...................................................... 31 2.16. AT+QFTPLEN 获取传输数据长度 ......................................................................................... 31 2.17. AT+QFTPSTAT 获取 FTP(S)服务器状态............................................................................... 32 2.18. AT+QFTPCLOSE 退出 FTP(S)服务器 .................................................................................. 33 3 举例 ..................................................................................................................................................... 34 3.1. 登录 FTP 服务器....................................................................................................................... 34 3.2. 登录 FTPS 服务器 .................................................................................................................... 35 3.3. 文件夹操作 ............................................................................................................................... 36 3.4. 文件操作 ................................................................................................................................... 36 3.5. 获取文件信息或文件名 ............................................................................................................. 37 3.6. 上传文件至 FTP(S)服务器........................................................................................................ 38 3.7. 从 FTP(S)服务器下载文件........................................................................................................ 40 3.8. 退出 FTP(S)服务器................................................................................................................... 42 4 常见问题处理....................................................................................................................................... 43 上海移远通信技术股份有限公司 4 / 49 LTE Standard(A)系列 FTP(S)应用指导 4.1. FTP(S) AT 命令执行失败.......................................................................................................... 43 4.2. PDP 激活失败........................................................................................................................... 43 4.3. DNS 解析失败 .......................................................................................................................... 43 4.4. FTP(S)服务器响应错误 ............................................................................................................ 44 5 错误码 ................................................................................................................................................. 45 6 FTP(S)协议错误码 .............................................................................................................................. 47 7 附录 参考文档及术语缩写 .................................................................................................................. 48 上海移远通信技术股份有限公司 5 / 49 LTE Standard(A)系列 FTP(S)应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型........................................................................................................................................ 8 表 3：错误码列表 ....................................................................................................................................... 45 表 4：FTP(S)协议错误码列表 .................................................................................................................... 47 表 5：参考文档 ........................................................................................................................................... 48 表 6：术语缩写 ........................................................................................................................................... 48 上海移远通信技术股份有限公司 6 / 49 LTE Standard(A)系列 FTP(S)应用指导 1 引言 移远通信 LTE Standard(A)系列模块支持 FTP 和 FTPS 文件传输协议（下文简称'FTP(S)'）。 FTP（File Transfer Protocol，文件传输协议）是一种标准的网络协议，用于在计算机网络上的客户端 和服务器之间传输计算机文件，具有很高的传输速率。 FTPS（FTP over SSL 或 FTP Secure）是一种对常用的文件传输协议（FTP）添加传输层安全（TLS） 和安全套接层（SSL）加密协议支持的扩展协议。 本文档主要介绍如何通过 AT 命令应用如下移远通信模块的 FTP(S)功能。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 上海移远通信技术股份有限公司 模块 EC200A 系列 EC200M-CN EC200N-CN EC200S 系列 EC600M-CN EC600N-CN EC800M-CN EC800N-CN EG810M-CN EG912N-EN EG912Y-EU EG915N 系列 7 / 49 LTE Standard(A)系列 FTP(S)应用指导 EG950A-EL 备注 针对不同 OC 或不同容量的 Flash，模块对 FTP(S) 功能支持有差异，具体可以参考对应版本的 RN 功能 列表。 1.2. AT 命令说明 1.2.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 49 LTE Standard(A)系列 FTP(S)应用指导 1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系 或连续性。 1.4. FTP(S)命令使用流程 LTE Standard(A)系列模块支持 FTP(S)协议，因此 FTP(S)服务器上的文件和目录可以通过 FTP(S)相 关 AT 命令进行操作。FTP(S)相关 AT 命令使用流程如下： 第一步：配置和激活 PDP 上下文。 1. 使用 AT+QICSGP 配置 PDP 上下文的、、和其他参数，详细 信息可参考文档 [1]。可通过 AT+CGQMIN、AT+CGEQMIN、AT+CGQREQ 和 AT+CGEQREQ 更新 QoS 设置，详细信息可参考文档 [2]； 2. 通过 AT+QIACT 激活 PDP 上下文，详细信息可参考文档 [1]； 3. 通过 AT+QFTPCFG='contextid',配置 FTP(S) PDP 上下文 ID。需提前激活 PDP 上 下文。 第二步：配置用户账号和 FTP(S)服务器。 1. 通过 AT+QFTPCFG='account',,配置账号信息； 2. 通过 AT+QFTPCFG='filetype',配置文件类型。在 FTP(S)服务器和客户端间传输的 文件类型可以是二进制数据或 ASCII 数据； 3. 通过 AT+QFTPCFG='transmode',配置传输模式，即在 FTP(S)服务器端口或客户 端 端 口 监 听 数 据 连 接 。 请 注 意 ， 因 为 FTPS 当 前 不 支 持 主 动 模 式 ， 必 须 设 置 AT+QFTPCFG='transmode',1 后才能进行 FTPS 操作； 4. 通过 AT+QFTPCFG='rsptimeout',配置命令的最大响应时间； 5. 若模块作为 FTPS 客户端，需执行如下命令： 1） 执行 AT+QFTPCFG='ssltype',1； 2） 执行 AT+QFTPCFG='SSL_ctxID',设置 SSL 上下文 ID； 3） AT+QSSLCFG 配置所指定的，详细信息可参考文档 [3]。 第三步：登录 FTP(S)服务器。 通 过 AT+QFTPOPEN=, 登 录 FTP(S) 服 务 器 ， 命 令 执 行 后 ， 若 响 应 URC +QFTPOPEN: 0,0，表示操作成功。注意 FTPS 和 FTP 端口不同。FTPS 服务器的端口取决于 FTPS 服务器提供商，通常为 990。 第四步：文件操作。 1. 通过 AT+QFTPCWD 设置当前目录； 2. 上传文件至 FTP(S)服务器； 1） 通过 AT+QFUPL 可以将文件上传至 UFS 或 SD 卡，再通过 AT+QFTPPUT 将文件上传至 上海移远通信技术股份有限公司 9 / 49 LTE Standard(A)系列 FTP(S)应用指导 FTP(S)服务器。文件上传成功后，可通过 AT+QFDEL 将其删除。详细信息可参考文档 [4]； 2） 在 COM 口通过 AT+QFTPPUT 将文件上传至 FTP(S)服务器。执行+++可结束文件上传。 3. 通过 AT+QFTPGET 从 FTP(S)服务器下载文件。文件将在 COM 口输出或被保存至 UFS 或 SD 卡。若 COM 口输出文件，模块将进入数据模式； 4. 通过 AT+QFTPSIZE 获取 FTP(S)服务器文件大小； 5. 通过 AT+QFTPLEN 获取 FTP(S)服务器和客户端之间传输的数据长度； 6. 通过 AT+QFTPDEL 删除 FTP(S)服务器文件； 7. 通过 AT+QFTPRENAME 重命名 FTP(S)服务器文件。 第五步：FTP(S)服务器目录操作。 1. 通过 AT+QFTPCWD 设置当前目录； 2. 通过 AT+QFTPMKDIR 创建文件夹； 3. 通过 AT+QFTPLIST 列出目录内容； 4. 通过 AT+QFTPNLST 列出目录文件名； 5. 通过 AT+QFTPRENAME 重命名文件或文件夹； 6. 通过 AT+QFTPRMDIR 删除文件夹； 7. 通过 AT+QFTPMLSD 列出标准文件和目录信息； 8. 通过 AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间。 第六步：关闭和 FTP(S)服务器的连接。 通过 AT+QFTPCLOSE 关闭和 FTP(S)服务器的连接，命令执行后，若响应 URC +QFTPCLOSE: 0,0， 表明操作成功，即可重复上述第三步至第六步。 第七步：去激活 PDP 上下文。 通过 AT+QIDEACT=去激活 PDP 上下文，详细信息可参考文档 [1]。 1.5. 数据模式说明 LTE Standard(A)系列模块的 COM 口有两种工作模式：一种是 AT 命令模式，另一种是数据模式。在 AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；在数据模式下，则被认为是数据。 用户可以通过输入+++或拉高 DTR（需先设置 AT&D1）使 COM 口退出数据模式。为防止+++被误认 为是数据，在使用 COM 口之前应遵循以下标准： ⚫ +++输入前 1 秒内不能输入其它任何数据。 ⚫ 必须在 1 秒内输入+++，并且不能输入其它任何数据。 ⚫ +++输入后 1 秒内不能输入其它任何数据。 在 COM 口执行 AT+QFTPPUT、AT+QFTPGET、AT+QFTPLIST 和 AT+QFTPNLST 时，若本地文件 路径为'COM:'，数据将从 COM 口接收和输出，COM 口会进入数据模式。用户可使用+++或拉高 DTR 退 出数据模式。此外，执行 AT+QFTPGET、AT+QFTPLIST 和 AT+QFTPNLST 后，可使用 ATO 重新进入数 据模式。但执行 AT+QFTPPUT 后，使用 ATO 不能再次进入数据模式。 上海移远通信技术股份有限公司 10 / 49 LTE Standard(A)系列 FTP(S)应用指导 2 FTP(S) AT 命令详解 2.1. AT+QFTPCFG 配置 FTP(S)服务器参数 该命令用于配置 FTP(S)服务器参数，包括用户账号、文件类型、传输模式和上下文 ID 等。设置命令省 略可省参数时，将查询当前配置。 AT+QFTPCFG 配置 FTP(S)服务器参数 测试命令 响应 AT+QFTPCFG=? +QFTPCFG: 'account',, +QFTPCFG: 'filetype',(支持的列表) +QFTPCFG: 'transmode',(支持的列表) +QFTPCFG: 'contextid',(支持的范围) +QFTPCFG: 'rsptimeout',(支持的范围) +QFTPCFG: 'ssltype',(支持的范围) +QFTPCFG: 'SSL_ctxID',(支持的范围) +QFTPCFG: 'data_address',(支持的范围),(支持的范围) +QFTPCFG: 'restenable',(支持的范围) +QFTPCFG: 'cache',(支持的范围) 设置命令 AT+QFTPCFG='account'[,,] OK 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'account',, OK 设置命令 AT+QFTPCFG='filetype'[, ] 若指定可选参数，则设置用户账号： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'filetype', OK 上海移远通信技术股份有限公司 11 / 49 LTE Standard(A)系列 FTP(S)应用指导 设置命令 AT+QFTPCFG='transmode'[,] 若指定可选参数，则设置文件类型： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'transmode', OK 设置命令 AT+QFTPCFG='contextid'[,] 若指定可选参数，则设置在 FTP 服务器端口还是在客户端端口 监听数据连接： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'contextid', OK 设置命令 AT+QFTPCFG='rsptimeout'[,] 若指定可选参数，则设置上下文 ID： OK 或者 ERROR 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'rsptimeout', OK 设置命令 AT+QFTPCFG='ssltype'[,] 若指定可选参数，则设置响应超时时间： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'ssltype', OK 上海移远通信技术股份有限公司 12 / 49 LTE Standard(A)系列 FTP(S)应用指导 设置命令 AT+QFTPCFG='SSL_ctxID'[,] 若指定可选参数，则设置 SSL 类型： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'SSL_ctxID', OK 设置命令 AT+QFTPCFG='data_address'[,[,]] 若指定可选参数，则设置 SSL 上下文 ID： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： 1) 若为 2： +QFTPCFG: 'data_address',, OK 2) 若不为 2： +QFTPCFG: 'data_address', OK 设置命令 AT+QFTPCFG='restenable'[,] 若指定任意参数，设置数据连接地址： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'restenable', OK 设置命令 AT+QFTPCFG='cache'[,] 若指定可选参数，设置关闭数据会话的方式： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'cache', 上海移远通信技术股份有限公司 13 / 49 LTE Standard(A)系列 FTP(S)应用指导 最大响应时间 特性说明 OK 若指定任意参数，设置 WM 大小和类型： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。鉴权用户名。最大长度为 255 字节。 字符串类型。鉴权密码。最大长度为 255 字节。 整型。传输数据类型。 0 二进制 1 ASCII 整型。在 FTP 服务器端口还是在客户端端口监听数据连接。 0 主动模式，在客户端端口监听来自 FTP 服务器的数据连接 1 被动模式，在 FTP 服务器端口监听来自客户端的数据连接 整型。PDP 上下文 ID。范围：1~15；默认值：1。使用 AT+QFTPOPEN 前，应先通过 AT+QIACT 激活 PDP 上下文。 整型。范围：20~180；默认值：90；单位：秒。 一般除 AT+QFTPPUT/QFTPGET/QFTPLST/QFTPNLST 外，执行其他命令响应 OK 前 ， 该 参 数 值 为 +QFTPXXX: xx,xx 的 最 大 响 应 时 间 。 该 参 数 对 于 AT+QFTPPUT/QFTPGET/QFTPLST/QFTPNLST 的含义如下： 1） 发送命令后，未响应 CONNECT 前，该参数值表示 CONNECT 的最大响应时间。 2） 模块进入数据模式后，该参数值表示接收或发送两个数据包之间的最大间隔时间。 3） 当不为'COM:'时，该参数值表示接收或发送两个数据包之间的最大 间隔时间。 整型。模块用作 FTP 客户端或 FTPS 客户端。 0 FTP 客户端 1 FTPS 隐式加密 2 FTPS 显式加密 整型。SSL 上下文 ID。范围：0~5；默认值：0。用户可以通过 AT+QSSLCFG 配置 SSL 参数。 整型。FTP(S)数据连接地址选择。 0 使用服务器分配的地址 1 使用 FTP(S)控制会话地址 2 优先使用 FTP(S)控制会话地址。若连接失败，将切换为服务器分配的地址 整型。当 FTP(S)控制会话地址连接失败时，切换服务器分配的地址所需时间。 仅当为 2 时有效。范围：15~50；默认值：25；单位： 上海移远通信技术股份有限公司 14 / 49 LTE Standard(A)系列 FTP(S)应用指导 秒。 整型。关闭数据会话的方式。 0 采用挥手的方式关闭数据会话 1 采用发送 RST 包的方式关闭数据会话 整型。WM 大小和类型。 0 默认模式，缓存 64 KB 1 快速模式，缓存 128 KB 2 慢速模式，缓存 128 KB，断点下载 错误码。详细信息可参考第 5 章。 备注 由于 FTPS 当前不支持主动模式，操作 FTPS 时，必须将设置为 1。 2.2. AT+QFTPOPEN 登录 FTP(S)服务器 该命令用于登录 FTP(S 服务器。执行该命令前，需先通过 AT+QIACT 激活 PDP 上下文。+QFTPOPEN: ,表示 AT+QFTPOPEN 的操作结果，应在 AT+QFTPCFG 配置的时间内 输出。 AT+QFTPOPEN 登录 FTP(S)服务器 测试命令 响应 AT+QFTPOPEN=? +QFTPOPEN: , 设置命令 AT+QFTPOPEN=[, ] 最大响应时间 特性说明 OK 响应 OK +QFTPOPEN: , 或者 +CME ERROR: 125 秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器 IP 地址和域名。最大长度为 255 字节。 整型。FTP(S)服务器端口。默认值：21。范围：1~65535。 上海移远通信技术股份有限公司 15 / 49 LTE Standard(A)系列 FTP(S)应用指导 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 AT+QFTPOPEN='101.95.183.122',21 OK +QFTPOPEN: 0,0 AT+QFTPOPEN='quectel.3322.org',990 OK +QFTPOPEN: 0,0 //登录 FTP 服务器。 //登录 FTPS 服务器。 备注 注意 FTPS 和 FTP 服务器端口不同，FTPS 服务器的端口取决于 FTPS 服务器提供商，通常为 990。 2.3. AT+QFTPCWD 配置 FTP(S)服务器当前目录 该命令用于配置 FTP(S)服务器当前目录。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPCWD: ,。所有文件和目录均可在当前目录中进行操作。 AT+QFTPCWD 配置 FTP(S)服务器当前目录 测试命令 响应 AT+QFTPCWD=? +QFTPCWD: 设置命令 AT+QFTPCWD= OK 响应 OK 最大响应时间 特性说明 +QFTPCWD: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 16 / 49 LTE Standard(A)系列 FTP(S)应用指导 参数 字符串类型。FTP(S)服务器目录路径。最大长度为 128 字节。根路径为'/'。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.4. AT+QFTPPWD 获取 FTP(S)服务器当前目录 该命令用于获取 FTP(S)服务器当前目录。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPCWD: ,。 AT+QFTPPWD 获取 FTP(S)服务器当前目录 测试命令 响应 AT+QFTPPWD=? 执行命令 OK 响应 AT+QFTPPWD OK 若当前目录获取成功： +QFTPPWD: 0, 最大响应时间 特性说明 若当前目录获取失败： +QFTPPWD: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器目录路径。最大长度为 255 字节。根路径为'/'。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 17 / 49 LTE Standard(A)系列 FTP(S)应用指导 2.5. AT+QFTPPUT 上传文件至 FTP(S)服务器 该命令用于上传文件至 FTP(S)服务器。若通过 COM 口上传文件，模块将进入数据模式。使用+++可 终止文件上传。本地文件，例如 UFS 或 SD 文件，可上传至 FTP(S)服务器。通过 AT+QFUPL 可以将文件 上传至 UFS 或 SD 卡，再通过 AT+QFTPPUT 将其上传至 FTP(S)服务器。文件上传成功后，即可使用 AT+QFDEL 删除文件。详细信息可参考文档 [4]。 用于将文件从指定位置上传。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应+QFTPPUT: ,。若不为'COM:'，执行该命令 后，将先响应 OK，数据传输完成后再响应+QFTPPUT: 0,。 若模块进入数据模式或不为'COM:'，AT+QFTPCFG 配置的则表示接收或发 送两包数据之间的最大时间间隔。 AT+QFTPPUT 上传文件至 FTP(S)服务器 测试命令 响应 AT+QFTPPUT=? +QFTPPUT: ,,,, 设置命令 当为'COM:' AT+QFTPPUT=,[,[,,]] OK 响应 CONNECT OK 若文件上传成功： +QFTPPUT: 0, 设置命令 当不为'COM:' AT+QFTPPUT=,[,] 若文件上传失败： +QFTPPUT: , 或者 +CME ERROR: 响应 OK 若文件上传成功： +QFTPPUT: 0, 若文件上传失败： +QFTPPUT: , 或者 +CME ERROR: 上海移远通信技术股份有限公司 18 / 49 LTE Standard(A)系列 FTP(S)应用指导 最大响应时间 特性说明 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 字符串类型。本地文件名称。最大长度为 255 字节。若该值为'COM:'，将在 COM 口输出数据。否则，数据将被保存至 UFS 或 SD 卡。文件上传成功后，可通过 AT+QFDEL 删除。 整 型 。 上 传 文 件 的 起 始 位 置 。 默 认 值 ： 0 。 若 指 定 和 ， 则 表示继续上传到同一文件的数据位置。单位：字节。 整型。上传的数据长度。仅当为'COM:'时有效。当通过 COM 口上传 的数据长度达到时，模块将退出数据模式。单位：字节。 整型。上传的数据是否是最后一包。仅当为'COM:'时有效。 0 不是最后一包数据。当数据长度达到，模块将退出数据模式并响 应+QFTPPUT: 0,。此时，请勿断开数据连接，因为剩余的数据 需要上传到 FTP 上的同一文件 1 最后一包数据。当数据长度达到，模块将退出数据模式，此时可 关闭数据连接，将响应+QFTPPUT: 0, 整型。成功传输数据的长度。单位：字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 备注 若省略和，将上传所有数据至 FTP(S)服务器。 举例 //通过 COM 口将文件上传到 FTP(S)服务器。 AT+QFTPPUT='test.txt','COM:',0 CONNECT OK //在FTP(S)服务器上将所有数据保存为test.txt。 +QFTPPUT: 0,1000 //通过COM口分两次将文件上传至FTP(S)服务器，每次上传1024字节。 上海移远通信技术股份有限公司 19 / 49 AT+QFTPPUT='test.txt','COM:',0,1024,0 CONNECT OK +QFTPPUT: 0,1024 AT+QFTPPUT='test.txt','COM:',1024,1024,1 CONNECT OK +QFTPPUT: 0,1024 LTE Standard(A)系列 FTP(S)应用指导 //非test.txt文件最后1024字节数据。 //数据长度达到1024字节。 //test.txt文件最后1024字节数据。 //数据长度达到1024字节。 2.6. AT+QFTPGET 从 FTP(S)服务器下载文件 该命令用于从 FTP(S)服务器下载文件。通过设置 AT+QFTPGET='filename','COM:'文件可从 COM 口输出。模块从服务器接收数据时将进入数据模式。数据传输完成后，模块将自动退出数据模式并输出+Q FTPGET: 0,。通过 AT+QFTPGET='filename','UFS:localname'或 AT+QFTPGET='file name','SD:localname'可将文件保存至 UFS 或 SD。文件传输成功后，模块将响应+QFTPGET: 0,。 若为'COM:'，应在 AT+QFTPCFG 配置的时间内响应 CONNECT；若 不为'COM:'，将先响应 OK，数据传输完成后才会响应+QFTPGET: 0,。 若模块进入数据模式或不为'COM:'，AT+QFTPCFG 配置的则表示接收或发 送两包数据之间的最大时间间隔。 AT+QFTPGET 从 FTP(S)服务器下载文件 测试命令 响应 AT+QFTPGET=? +QFTPGET: ,,, 设置命令 当为'COM:' AT+QFTPGET=,[,[,]] OK 响应 CONNECT OK 若文件下载成功： +QFTPGET: 0, 若文件下载失败： 上海移远通信技术股份有限公司 20 / 49 LTE Standard(A)系列 FTP(S)应用指导 设置命令 当不为'COM:' AT+QFTPGET=,[,] +QFTPGET: , 或者 +CME ERROR: 响应 OK 若文件下载成功： +QFTPGET: 0, 最大响应时间 特性说明 若文件下载失败： +QFTPGET: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 字符串类型。本地文件名称。最大长度为 255 字节。若该值为'COM:'，将在 COM 口 输出数据。否则，数据将被保存至 UFS 或 SD 卡。建议将其保存在 UFS 或 SD 卡。之 后可通过 AT+QFREAD 读取文件。详细信息可参考文档 [4]。 整型。要上传的文件的起始位置。默认值：0；单位：字节。 整型。下载的数据长度。仅当为'COM:'时有效。若指定该参数，模块将 输出字节至 COM 口并退出数据模式。若有剩余数据，则可以通过同一 AT 命令从处下载数据。默认值：0；单位：字节。 整型。成功传输数据的长度。单位：字节。若传输数据少于，表示成 功传输整个文件。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。详 细信息可参考第 6 章。若为 0，则无效。 备注 当为'COM:'时，若省略和，将从 FTP(S)服务器下载整个文件。 举例 //通过COM口下载文件。 AT+QFTPGET='test.txt','COM:',0 上海移远通信技术股份有限公司 //从FTP(S)服务器下载整个文件。 21 / 49 LTE Standard(A)系列 FTP(S)应用指导 CONNECT OK +QFTPGET: 0,1000 //下载文件，通过COM口分两次输出数据，每次500字节。 AT+QFTPGET='test.txt','COM:',0,500 CONNECT OK //test.txt文件大小为1000字节数据，首次下载500字节。 +QFTPGET: 0,500 AT+QFTPGET='test.txt','COM:',500,500 CONNECT OK //下载剩余500字节。 +QFTPGET: 0,500 2.7. AT+QFTPSIZE 获取 FTP(S)服务器文件大小 该命令用于获取 FTP(S)服务器文件大小。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPSIZE: 0,或+QFTPSIZE: ,，否则应断开 FTP(S)连接， 并去激活后重新激活网络。 AT+QFTPSIZE 获取 FTP(S)服务器文件大小 测试命令 响应 AT+QFTPSIZE=? +QFTPSIZE: 设置命令 AT+QFTPSIZE= OK 响应 OK 若文件大小获取成功： +QFTPSIZE: 0, 若文件大小获取失败： +QFTPSIZE: , 或者 +CME ERROR: 上海移远通信技术股份有限公司 22 / 49 最大响应时间 特性说明 参数 LTE Standard(A)系列 FTP(S)应用指导 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 整型。FTP(S)服务器文件大小。单位：字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供 参考。详细信息可参考第 6 章。若为 0，则无效。 2.8. AT+QFTPDEL 删除 FTP(S)服务器文件 该命令用于删除指定 FTP(S)服务器文件。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPDEL: ,，否则应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPDEL 删除 FTP(S)服务器文件 测试命令 响应 AT+QFTPDEL=? +QFTPDEL: 设置命令 AT+QFTPDEL= OK 响应 OK 最大响应时间 特性说明 +QFTPDEL: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 23 / 49 LTE Standard(A)系列 FTP(S)应用指导 2.9. AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 该命令用于在 FTP(S)服务器创建文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPMKDIR: ,，否则应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 测试命令 响应 AT+QFTPMKDIR=? +QFTPMKDIR: 设置命令 AT+QFTPMKDIR= OK 响应 OK 最大响应时间 特性说明 +QFTPMKDIR: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.10. AT+QFTPRMDIR 删除 FTP(S)服务器文件夹 该命令用于在 FTP(S)服务器删除指定文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPRMDIR: ,，否则应断开 FTP(S)连接，并去激活后重 新激活网络。 AT+QFTPRMDIR 删除 FTP(S)服务器文件夹 测试命令 响应 AT+QFTPRMDIR=? +QFTPRMDIR: 设置命令 AT+QFTPRMDIR= OK 响应 OK 上海移远通信技术股份有限公司 24 / 49 LTE Standard(A)系列 FTP(S)应用指导 最大响应时间 特性说明 +QFTPRMDIR: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参 考。详细信息可参考第 6 章。若为 0，则无效。 2.11. AT+QFTPLIST 获取 FTP(S)服务器目录内容 该命令用于获取 FTP(S)服务器目录内容。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，服务器目录内容传输 完成后响应+QFTPLIST: 0,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接 收或发送两包数据之间的最大时间间隔。 AT+QFTPLIST 获取 FTP(S)服务器目录内容 测试命令 响应 AT+QFTPLIST=? +QFTPLIST: , 设置命令 当为'COM:' AT+QFTPLIST=[,] OK 响应 CONNECT OK 若获取服务器目录内容获取成功： +QFTPLIST: 0, 若获取服务器目录内容获取失败： +QFTPLIST: , 或者 上海移远通信技术股份有限公司 25 / 49 LTE Standard(A)系列 FTP(S)应用指导 +CME ERROR: 设置命令 当不为'COM:' AT+QFTPLIST=, 响应 OK 若获取服务器目录内容获取成功： +QFTPLIST: 0, 最大响应时间 特性说明 若获取服务器目录内容获取失败： +QFTPLIST: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'，将获 取由 AT+QFTPCWD 配置的当前目录内容。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 255 字节。默认 值：'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 UFS 或 SD 卡。之后可通过 AT+QFREAD 读取文件，详细信息可参考文档 [4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 //在FTP(S)服务器上获取当前目录的内容，并通过COM口输出数据。 AT+QFTPLIST='.' CONNECT OK +QFTPLIST: 0,1000 上海移远通信技术股份有限公司 26 / 49 LTE Standard(A)系列 FTP(S)应用指导 2.12. AT+QFTPNLST 获取 FTP(S)服务器目录文件名 该命令用于获取 FTP(S)服务器目录文件名。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，文件名称传输完成后 响应+QFTPNLST: 0,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接收 或发送两包数据之间的最大时间间隔。 AT+QFTPNLIST 测试命令 AT+QFTPNLST=? 获取 FTP(S)服务器目录文件名 响应 +QFTPNLST: , 设置命令 当为'COM:' AT+QFTPNLST=[,] OK 响应 CONNECT OK 若文件名获取成功： +QFTPNLST: 0, 设置命令 当不为'COM:' AT+QFTPNLST=, 若文件名获取失败： +QFTPNLST: , 或者 +CME ERROR: 响应 OK +QFTPNLST: 0, 或者 +CME ERROR: 最大响应时间 特性说明 若获取文件名出错： +QFTPNLST: , 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 27 / 49 LTE Standard(A)系列 FTP(S)应用指导 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'，将获 取由 AT+QFTPCWD 配置的当前目录的文件名。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 255 字节。默认 值：'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 UFS 或 SD 卡。之后可通过 AT+QFREAD 读取文件，详细信息可参考文档 [4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 //在FTP(S)服务器上获取当前目录文件名，并通过COM口输出数据。 AT+QFTPNLST='.' CONNECT OK +QFTPNLST: 0,1000 2.13. AT+QFTPMLSD 获取标准化文件和目录信息 该命令用于获取标准化文件和目录信息。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，标准化文件和目录信 息传输完成后响应+QFTPMLSD: 0,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接收 或发送两包数据之间的最大时间间隔。 AT+QFTPMLSD 获取标准化文件和目录信息 测试命令 响应 AT+QFTPMLSD=? +QFTPMLSD: , 设置命令 当为'COM:' AT+QFTPMLSD=[,] OK 响应 CONNECT OK 上海移远通信技术股份有限公司 28 / 49 LTE Standard(A)系列 FTP(S)应用指导 若标准化文件和目录信息获取成功： +QFTPMLSD: 0, 设置命令 当不为'COM:' AT+QFTPMLSD=, 若标准化文件和目录信息获取失败： +QFTPMLSD: , 或者 +CME ERROR: 响应 OK 若标准化文件和目录信息获取成功： +QFTPMLSD: 0, 最大响应时间 特性说明 若标准化文件和目录信息获取失败： +QFTPMLSD: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'，将获 取由 AT+QFTPCWD 配置的标准化文件和目录信息。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 255 字节。默认 值：'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 UFS 或 SD 卡。之后可通过 AT+QFREAD 读取文件，详细信息可参考文档 [4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参 考。详细信息可参考第 6 章。若为 0，则无效。 举例 //在FTP(S)服务器上获取标准化文件和目录信息，并通过COM口输出数据。 AT+QFTPMLSD='.' CONNECT OK +QFTPMLSD: 0,1000 上海移远通信技术股份有限公司 29 / 49 LTE Standard(A)系列 FTP(S)应用指导 2.14. AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 该命令用于获取 FTP(S)服务器文件修改时间。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPMDTM: 0,或+QFTPMDTM: ,。否则 应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 测试命令 响应 AT+QFTPMDTM=? +QFTPMDTM: 设置命令 AT+QFTPMDTM= OK 响应 OK 若获取成功： +QFTPMDTM: 0, 最大响应时间 特性说明 若获取失败： +QFTPMDTM: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件名。最大长度为 255 字节。 字 符 串 类 型 。 FTP(S) 服 务 器 文 件 修 改 时 间 。 格 式 为 'YYYYMMDDHHMMSS' 或 'YYYYMMDDHHMMSS.NNN'。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 30 / 49 LTE Standard(A)系列 FTP(S)应用指导 2.15. AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹 该命令用于重命名 FTP(S)服务器文件或文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPRENAME: ,。否则应断开 FTP(S)连接，并去激活后 重新激活网络。 AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹 测试命令 响应 AT+QFTPRENAME=? +QFTPRENAME: , 设置命令 AT+QFTPRENAME=, 最大响应时间 特性说明 OK 响应 OK +QFTPRENAME: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器旧文件名或旧文件夹名称。最大长度为 255 字节。 字符串类型。FTP(S)服务器新文件名或新文件夹名称。最大长度为 255 字节。 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.16. AT+QFTPLEN 获取传输数据长度 该命令用于获取 FTP(S)服务器传输数据长度。 AT+QFTPLEN 获取传输数据长度 测试命令 响应 AT+QFTPLEN=? 执行命令 OK 响应 AT+QFTPLEN OK +QFTPLEN: 0, 上海移远通信技术股份有限公司 31 / 49 最大响应时间 特性说明 LTE Standard(A)系列 FTP(S)应用指导 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 整 型 。 FTP(S) 服 务 器 传 输 数 据 长 度 。 执 行 AT+QFTPPUT 、 AT+QFTPGET 、 AT+QFTPNLST 或 AT+QFTPLIST 时，可使用 AT+QFTPLEN 查询传输数据长度。单 位：字节。 错误码。详细信息可参考第 5 章。 2.17. AT+QFTPSTAT 获取 FTP(S)服务器状态 该命令用于获取 FTP(S)服务器状态。 AT+QFTPSTAT 获取 FTP(S)服务器状态 测试命令 响应 AT+QFTPSTAT=? 执行命令 OK 响应 AT+QFTPSTAT OK 最大响应时间 特性说明 +QFTPSTAT: 0, 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 整型。当前 FTP(S)服务器状态。 0 正在开启 FTP(S)服务器 1 FTP(S)服务器开启并处于空闲状态 2 FTP(S)服务器正在传输数据 3 正在关闭 FTP(S)服务器 4 FTP(S)服务器已关闭 错误码。详细信息可参考第 5 章。 上海移远通信技术股份有限公司 32 / 49 LTE Standard(A)系列 FTP(S)应用指导 2.18. AT+QFTPCLOSE 退出 FTP(S)服务器 该命令用于退出 FTP(S)服务器。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的时间 内响应+QFTPCLOSE: ,。否则应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPCLOSE 退出 FTP(S)服务器 测试命令 响应 AT+QFTPCLOSE=? 执行命令 OK 响应 AT+QFTPCLOSE OK 最大响应时间 特性说明 +QFTPCLOSE: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 错误码。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 33 / 49 LTE Standard(A)系列 FTP(S)应用指导 3 举例 3.1. 登录 FTP 服务器 //第一步：配置和激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK AT+QFTPCFG='contextid',1 OK //第二步：配置用户账号和传输设置。 AT+QFTPCFG='account','test','test' OK AT+QFTPCFG='filetype',1 OK AT+QFTPCFG='transmode',1 OK AT+QFTPCFG='rsptimeout',90 OK //第三步：登录FTP服务器。 AT+QFTPOPEN='220.180.239.212',8309 OK +QFTPOPEN: 0,0 //设置 PDP 上下文为 1，中国联通 APN 为'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 //设置PDP上下文为1。必须先激活PDP上下文ID。 //设置用户名和密码。 //设置文件类型为ASCII。 //设置为被动传输方式。 //设置最大响应时间（默认为90秒）。 上海移远通信技术股份有限公司 34 / 49 LTE Standard(A)系列 FTP(S)应用指导 3.2. 登录 FTPS 服务器 //第一步：配置和激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //设置 PDP 上下文为 1，中国联通 APN 为'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QFTPCFG='contextid',1 OK //设置 PDP 上下文为 1。必须先激活 PDP 上下文 ID。 //第二步：配置用户账号和传输设置。 AT+QFTPCFG='account','test','test' //设置用户名和密码。 OK AT+QFTPCFG='filetype',1 OK AT+QFTPCFG='transmode',1 OK AT+QFTPCFG='rsptimeout',90 OK //设置文件类型为 ASCII。 //设置被动传输方式。 //设置最大响应时间（默认为 90 秒）。 //第三步：配置 FTPS。 AT+QFTPCFG='ssltype',1 //设置 SSL 类型为 1，模块作为 FTPS 客户端。 OK AT+QFTPCFG='sslctxid',1 OK AT+QSSLCFG='ciphersuite',1,0xffff OK AT+QSSLCFG='seclevel',1,0 OK AT+QSSLCFG='sslversion',1,1 OK //设置 SSL 上下文为 1。 //设置 SSL 加密套件类型为 0xffff，支持所有加密套件类型。 //设置 SSL 安全类型为 0，即不需要 SSL CA 证书。 //设置 SSL 版本为 1，表示 TLS1.0。 //第四步：登录 FTPS 服务器。 AT+QFTPOPEN='quectel.3322.org',990 OK +QFTPOPEN: 0,0 上海移远通信技术股份有限公司 35 / 49 3.3. 文件夹操作 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPPWD OK +QFTPPWD: 0,/ AT+QFTPMKDIR='TEST' OK +QFTPMKDIR: 0,0 AT+QFTPRENAME='TEST','TEST_NEW' OK +QFTPRENAME: 0,0 AT+QFTPRMDIR='TEST_NEW' OK +QFTPRMDIR: 0,0 LTE Standard(A)系列 FTP(S)应用指导 //设置当前目录。 //查询当前目录。 //在 FTP(S)服务器创建名为 TEST 的文件夹。 //重命名文件夹为 TEST_NEW。 //删除文件夹 TEST_NEW。 3.4. 文件操作 AT+QFTPCWD='/' OK //设置当前目录。 +QFTPCWD: 0,0 AT+QFTPPWD OK //查询当前目录。 +QFTPPWD: 0,'/' AT+QFTPSIZE='test_my1.txt' OK //查询 FTP(S)服务器 test_my1.txt 文件大小。 +QFTPSIZE:0, 1000 AT+QFTPRENAME='test_my1.txt','test_new.txt' OK //重命名文件为 test_new.txt。 上海移远通信技术股份有限公司 36 / 49 +QFTPRENAME: 0,0 AT+QFTPMDTM='test_new.txt' OK +QFTPMDTM: 0,'20140708110039' AT+QFTPDEL='test_new.txt' OK +QFTPDEL: 0,0 LTE Standard(A)系列 FTP(S)应用指导 //获取 FTP(S)服务器上的 test_new.txt 文件修 改时间。 //删除 FTP(S)服务器上的 test_new.txt 文件。 3.5. 获取文件信息或文件名 AT+QFTPCWD='/' OK //设置当前目录。 +QFTPCWD: 0,0 AT+QFTPLIST='.' CONNECT OK //获取当前目录的内容，并通过 COM 口输出数据。 +QFTPLIST: 0,1000 AT+QFTPLIST='TEST_2','COM:' CONNECT OK //获取 TEST_2 文件内容，并通过 COM 口输出数据。 +QFTPLIST: 0,1000 AT+QFTPNLST='.' CONNECT OK //获取当前目录的文件名，并通过 COM 口输出数据。 +QFTPNLST: 0,1000 AT+QFTPNLST='TEST_2','COM:' CONNECT OK //获取 TEST_2 文件名称，并通过 COM 口输出数据。 +QFTPNLST: 0,1000 AT+QFTPMLSD='.' //获取当前目录的标准化文件和目录信息，并通过 COM 口输出数 上海移远通信技术股份有限公司 37 / 49 LTE Standard(A)系列 FTP(S)应用指导 CONNECT OK 据。 +QFTPMLSD: 0,1000 AT+QFTPMLSD='TEST_2','COM:' CONNECT OK //获取 TEST_2 的标准化文件和目录信息，并通过 COM 口输出数 据。 +QFTPMLSD: 0,1000 3.6. 上传文件至 FTP(S)服务器 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPSTAT +QFTPSTAT: 0,1 OK //通过COM口上传文件。 AT+QFTPPUT='test_my1.txt','COM:',0 CONNECT OK +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 上海移远通信技术股份有限公司 //所有数据在FTP(S)服务器上被保存为 test_my1.txt。 38 / 49 LTE Standard(A)系列 FTP(S)应用指导 //通过COM口上传文件，起始位置为1000。 AT+QFTPPUT='test_my1.txt','COM:',1000 CONNECT OK //所有数据在FTP(S)服务器上被保存为 test_my1.txt。 +QFTPPUT: 0,500 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1500 //方案1：通过COM口上传两次文件至FTP(S)服务器，每次上传1024字节数据。 AT+QFTPPUT='test_my1.txt','COM:',0,1024,0 CONNECT OK //非test_my1.txt最后一包1024字节数据。 //数据长度达到1024字节。 +QFTPPUT: 0,1024 AT+QFTPPUT='test_my1.txt','COM: ',1024,1024,1 CONNECT OK //test_my1.txt最后一包1024字节数据。 //数据长度达到1024字节。 +QFTPPUT: 0,1024 //方案2：从UFS上传文件至FTP(S)服务器。 AT+QFUPL='UFS:test_ufs.txt',1000,300,1 CONNECT +QFUPL: 1000,707 //上传文件至UFS，文件被保存为test_ufs.txt。 文件大小为1000字节。超时时间为300秒。设置 为ACK模式。详细信息可参考文档 [4]。 OK AT+QFLST='UFS:*' +QFLST: 'UFS:test_ufs.txt',1000 OK AT+QFTPPUT='test_my1.txt','UFS:test_ufs.txt',0 OK //上传UFS:test_ufs.txt至FTP(S)服务器，并将其 保存为test_my1.txt。 上海移远通信技术股份有限公司 39 / 49 LTE Standard(A)系列 FTP(S)应用指导 +QFTPPUT: 0,1000 //方案3：从SD上传文件至FTP(S)服务器。 AT+QFUPL='SD:test_sd.txt',1000,300,1 CONNECT +QFUPL: 1000,707 OK AT+QFLST=SD:*' +QFLST: 'SD:test_sd.txt',1000 OK AT+QFTPPUT='test_my1.txt','SD:test_sd.txt',0 OK +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 //上传文件至SD，文件被保存为test_sd.txt。文 件大小为1000字节。超时时间为300秒。设置为 ACK模式。详细信息可参考文档 [4]。 //上传SD:test_sd.txt至FTP(S)服务器，并将其 保存为test_my1.txt。 3.7. 从 FTP(S)服务器下载文件 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 //方案 1：直接通过 COM 口输出下载数据。 //从 FTP(S)服务器下载文件，并通过 COM 输出数据。 AT+QFTPGET='test_my.txt','COM:' CONNECT 上海移远通信技术股份有限公司 40 / 49 LTE Standard(A)系列 FTP(S)应用指导 OK +QFTPGET: 0,1000 //下载文件，通过COM口分两次输出数据，每次500字节。 AT+QFTPGET='test.txt','COM:',0,500 CONNECT OK //test.txt文件大小为1000字节数据，首次下载500字 节。 +QFTPGET: 0,500 AT+QFTPGET='test.txt','COM:',500,500 CONNECT OK //下载剩余500字节。 +QFTPGET: 0,500 //方案 2：保存下载数据至 UFS。 //从 FTP(S)服务器下载文件并将其保存至 UFS。 AT+QFTPGET='test_my1.txt','UFS:test.txt' OK //下载文件并将其保存至 UFS，命名为 test.txt。 +QFTPGET: 0,1000 AT+QFLST='UFS:*' +QFLST: UFS:test.txt,1000 OK //从 FTP(S)服务器下载文件并将其保存至 UFS，起始位置为 450。 AT+QFTPGET='test_my1.txt','UFS:test1.txt',450 //下载文件并将其保存至 UFS，命名为 test.txt。 OK +QFTPGET: 0,550 //方案 3：保存下载数据至 SD 卡。 //从 FTP(S)服务器下载文件并将其保存至 SD 卡。 AT+QFTPGET='test_my1.txt','SD:test.txt' OK //下载文件并将其保存至 SD 卡，命名为 test.txt。 +QFTPGET: 0,1000 上海移远通信技术股份有限公司 41 / 49 LTE Standard(A)系列 FTP(S)应用指导 AT+QFLST='SD:*' +QFLST: SD:test.txt,1000 OK //从 FTP(S)服务器下载文件并将其保存至 SD 卡，起始位置为 450。 AT+QFTPGET='test_my1.txt','SD:test1.txt',450 //下载文件并将其保存至 SD 卡，命名为 test.txt。 OK +QFTPGET: 0,550 AT+QFTPLEN OK +QFTPLEN: 0,550 AT+QFLST='SD:*' +QFLST: SD:test.txt,1000 +QFLST: SD:test1.txt,550 OK 3.8. 退出 FTP(S)服务器 AT+QFTPCLOSE OK +QFTPCLOSE: 0,0 AT+QIDEACT=1 OK //退出FTP(S)服务器。 //去激活为FTP(S)激活的PDP上下文。 上海移远通信技术股份有限公司 42 / 49 LTE Standard(A)系列 FTP(S)应用指导 4 常见问题处理 4.1. FTP(S) AT 命令执行失败 执行 FTP(S) AT 命令后，若返回 ERROR，请检查是否插入了(U)SIM 卡，并注意执行 AT+CPIN?后是 否返回了+CPIN: READY。 4.2. PDP 激活失败 若使用 AT+QIACT 激活 PDP 失败，请检查以下配置： 1. 通过 AT+CGATT?查询是否已经附着 PS 域。若未附着 PS 域，请先执行 AT+CGATT=1 附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保已注册了 PS 域。 3. 通过 AT+QICSGP 查询 PDP 上下文参数，并确保已设置了指定 PDP 上下文的 APN。 4. 确保 PPP 未使用指定的 PDP 上下文 ID，AT+CGACT 也未激活指定的 PDP 上下文 ID。 5. 根据 3GPP 规范，模块仅支持同时激活三个 PDP 上下文，因此激活 PDP 上下文的数量必须不超 过 3。 若上述配置无误，但依然无法通过 AT+QIACT 成功激活 PDP 上下文，请重启模块。重启模块后，请 至少检查三次上述配置，每次间隔 10 分钟，以避免频繁重启模块。 4.3. DNS 解析失败 执行 AT+QFTPOPEN 后，若返回+QFTPOPEN: 604,0，请检查以下配置： 1. 确认 FTP(S)服务器域名有效。 2. 通过 AT+QIACT?查询 PDP 上下文状态，确保成功激活了指定的 PDP 上下文。 上海移远通信技术股份有限公司 43 / 49 LTE Standard(A)系列 FTP(S)应用指导 4.4. FTP(S)服务器响应错误 若+QFTPXX: ,中的不为 0，表示 FTP(S)服务器响应的错误 码。 用户可根据协议错误码检查 FTP(S)服务器响应的错误码。例如：若为 530（未登录）， 表明或密码可能错误；若为 550（请求失败：文件不可用）， 表明文件或目录不存在。详细信息可参考 RFC959。 上海移远通信技术股份有限公司 44 / 49 LTE Standard(A)系列 FTP(S)应用指导 5 错误码 表示与移动设备或网络有关的错误码。相关详细信息参见下表。 表 3：错误码列表 0 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 英文含义 Operation successful Unknown error FTP(S) server blocked FTP(S) server busy DNS parse failed Network error Control connection closed. Data connection closed Socket closed by peer Timeout error Invalid parameter Failed to open file File position invalid File error Service not available, closing control connection Open data connection failed Connection closed; transfer aborted Requested file action not taken 中文含义 操作成功 未知错误 FTP(S)服务器不可用 FTP(S)服务器繁忙 DNS 解析错误 网络错误 控制连接关闭 数据连接关闭 对端关闭 Socket 超时错误 无效参数 文件打开失败 文件位置无效 文件错误 服务不可用，关闭控制连接 数据连接打开失败 连接关闭，传输中止 文件操作请求失败 上海移远通信技术股份有限公司 45 / 49 LTE Standard(A)系列 FTP(S)应用指导 618 Requested action aborted: local error in processing 请求中止：本地错误处理中 619 Requested action not taken: insufficient system 请求失败：系统空间不足 storage 620 Syntax error, command unrecognized 语句错误，无法命令识别 621 Syntax error in parameters or arguments 语句错误，参数出错 622 Command not implemented 未执行命令 623 Bad sequence of commands 命令顺序有误 624 Command parameter not implemented 未输入命令参数 625 Not logged in 未登录 626 Need account for storing files 需要能存储文件的账号 627 Requested action not taken 请求失败 628 Requested action aborted: page type unknown 请求中止：未知网页类型 629 Requested file action aborted 文件操作请求失败 631 SSL authentication failed SSL 鉴权失败 上海移远通信技术股份有限公司 46 / 49 LTE Standard(A)系列 FTP(S)应用指导 6 FTP(S)协议错误码 协议错误码表示 FTP(S)服务器响应的错误码。详细信息可参考 RFC959。下表描述 了部分常见错误码。 表 4：FTP(S)协议错误码列表 英文含义 Service not available, closing control 421 connection 425 Open data connection failed 426 Connection closed; transfer aborted 450 Requested file action not taken Requested action aborted: local error in 451 processing Requested action not taken: insufficient 452 system storage 500 Syntax error, command unrecognized 501 Syntax error in parameters or arguments 502 Command not implemented 503 Bad sequence of commands 504 Command parameter not implemented 530 Not logged in 532 Need account for storing files Requested action not taken: file 550 unavailable Requested action aborted: page type 551 unknown Requested file action aborted: exceeded 552 storage allocation Requested action not taken: file name not 553 allowed 中文含义 服务不可用，关闭控制连接 打开数据连接失败 连接关闭；传输中止 文件操作请求失败 请求中间：本地错误处理中 请求失败：系统空间不足 语句错误，无法命令识别 参数语句错误 未执行命令 命令顺序有误 未输入参数 未登录 需要能存储文件的账号 请求失败：文件不可用 请求中止：未知网页类型 文件操作请求中止：存储空间分配过 量 请求失败：不允许的文件名 上海移远通信技术股份有限公司 47 / 49 LTE Standard(A)系列 FTP(S)应用指导 7 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_TCP(IP)_应用指导 [2] Quectel_LTE_Standard(A)系列_AT 命令手册 [3] Quectel_LTE_Standard(A)系列_SSL_应用指导 [4] Quectel_LTE_Standard(A)系列_FILE_应用指导 表 6：术语缩写 缩写 ACK APN ASCII DNS DTR FTP FTPS IP PDP PPP 英文全称 中文全称 Acknowledgement 确认消息 Access Point Name 接入点名称 American Standard Code for Information Interchange 美国信息交换标准代码 Domain Name Server 域名服务器 Data Terminal Ready 数据终端就绪 File Transfer Protocol FTP over SSL/FTP Secure Internet Protocol 文件传输协议 对常用的文件传输协议（FTP） 添加传输层安全（TLS）和安全 套接层（SSL）加密协议支持的 扩展协议 互联网协议 Packet Data Protocol 分组数据协议 Point-to-Point Protocol 点对点协议 上海移远通信技术股份有限公司 48 / 49 PS QoS RAM SD SSL TLS UFS URC (U)SIM WM Packet Switching Quality of Service Random Access Memory Secure Digital Secure Sockets Layer Transport Layer Security Universal Flash Storage Unsolicited Result Code (Universal) Subscriber Identity Module Watermark LTE Standard(A)系列 FTP(S)应用指导 分组交换 服务质量 随机存储器 安全数字存储器 安全套接层 安全传输层协议 通用闪存存储 非请求结果码 （通用）用户身份识别模块 一种衡量 Event Time 进展的机制 上海移远通信技术股份有限公司 49 / 49

LTE Standard(A)系列 DFOTA 应用指导 LTE Standard 模块系列 版本：1.3 日期：2022-06-16 状态：受控文件 LTE Standard(A)系列 DFOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 28 LTE Standard(A)系列 DFOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 28 LTE Standard(A)系列 DFOTA 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 1.0 2020-06-10 Ramos ZHANG/ 初始版本 Galen ZHOU 1. 更新 EC200S 系列、EC600S-CN 和 EG912Y 系列模块的 固件升级方式为 DFOTA。 2. 增加适用模块 EC600S-CN。 1.1 2020-10-27 Ramos ZHANG 3. 更新 AT+QFOTADL 的说明，仅适用 于移远通信 EC200T 系列模块（第 3.2.1 章）。 4. 新增备注 2（第 3.2.1.3 章）。 1. 增加适用模块 EC200N-CN 和 EC600N-CN。 2. 增加 AT 命令中 URL 地址最大长度的说明以及不同 flash 1.2 2021-04-19 Evan MENG 版本的 URC 上报差异说明（第 3.3.1 章）。 3. 更新参数 AT+QFOTADL 的说明。 4. 增加 8M 和 16M flash 版本固件升级差异说明（第 4 章）。 5. 更新结果码表格（第 5.4 章）。 1. 增加适用模块 EC200A 系列、EC800N-CN 和 EG915N 系 列。 1.3 2022-06-16 Amos YAO 2. 删除适用模块 EG912Y-CN 和 EC200T 系列。 3. 更新 8 MB 版本的固件差分包后缀校验机制备注说明（第 4.1 章）。 上海移远通信技术股份有限公司 3 / 28 LTE Standard(A)系列 DFOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 2 DFOTA 固件升级流程 ........................................................................................................................... 8 2.1. 获取差分固件包 .......................................................................................................................... 9 2.2. 存储差分固件包至 FTP/HTTP(S)服务器或外部 MCU ................................................................ 9 2.3. 执行 AT 命令升级固件 ................................................................................................................ 9 3 DFOTA 相关 AT 命令详解 .................................................................................................................. 10 3.1. AT 命令说明.............................................................................................................................. 10 3.1.1. 定义 ............................................................................................................................... 10 3.1.2. AT 命令语句................................................................................................................... 10 3.2. AT 示例声明...............................................................................................................................11 3.3. AT 命令详解...............................................................................................................................11 3.3.1. AT+QFOTADL 使能 DFOTA 固件升级.........................................................................11 3.3.1.1. AT+QFOTADL= 差分固件包存储至 FTP 服务器时升级固件........... 12 3.3.1.2. AT+QFOTADL= 差分固件包存储至 HTTP(S)服务器时升级固件.. 14 3.3.1.3. AT+QFOTADL='FILE:' 差分固件包存储至外部 MCU 时升级固件 ........ 16 3.3.1.4. AT+QFOTADL='FILE:', 外部 MCU 采用本地 File 的方式通过不支持硬 件流控的串口升级固件 ........................................................................................... 18 4 不同 Flash 版本固件升级差异............................................................................................................. 19 4.1. 差分固件包制作差异................................................................................................................. 19 4.2. URC 上报差异 .......................................................................................................................... 20 4.3. 升级过程差异............................................................................................................................ 21 4.4. 升级命令差异............................................................................................................................ 22 5 结果码 ................................................................................................................................................. 23 5.1. 结果码一览表 .......................................................................................................... 23 5.2. 结果码一览表 ....................................................................................................... 25 5.3. 结果码一览表 ............................................................................................................ 26 5.4. 结果码一览表 ................................................................................................................... 27 6 附录 参考文档和术语缩写 .................................................................................................................. 28 上海移远通信技术股份有限公司 4 / 28 LTE Standard(A)系列 DFOTA 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型...................................................................................................................................... 10 表 3：值描述 ............................................................................................................................. 23 表 4：值描述 .......................................................................................................................... 25 表 5：值描述 ............................................................................................................................... 26 表 6：值描述...................................................................................................................................... 27 表 7：参考文档 ........................................................................................................................................... 28 表 8：术语缩写 ........................................................................................................................................... 28 上海移远通信技术股份有限公司 5 / 28 LTE Standard(A)系列 DFOTA 应用指导 图片索引 图 1：DFOTA 固件升级流程......................................................................................................................... 8 图 2：8 MB 版本的差分固件包 ................................................................................................................... 19 图 3：8 MB 版本升级进度 URC ................................................................................................................. 20 图 4：16 MB 版本固件包下载进度 URC .................................................................................................... 21 图 5：16 MB 版本固件包升级进度 URC .................................................................................................... 21 上海移远通信技术股份有限公司 6 / 28 LTE Standard(A)系列 DFOTA 应用指导 1 引言 移远通信 LTE Standard(A)系列模块支持固件空中差分升级（DFOTA）功能，此功能可以实现模块差 分包的无线升级或降级。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200S 系列 EC200A 系列 EC200N-CN EC600S-CN EC600N-CN EC800N-CN EG912Y-EU EG915N 系列 上海移远通信技术股份有限公司 7 / 28 LTE Standard(A)系列 DFOTA 应用指导 2 DFOTA 固件升级流程 下图阐述了 DFOTA 升级固件的流程。 2. 将差分固件包放在 FTP/HTTP(S)服务器上 FTP/HTTP(S) 服务器 1. 获取差分固件包 LTE/WCDMA/GSM/ GPRS (FTP/(HTTP(S)) 4. 通过LTE/WCDMA/GSM/GPRS 网络从FTP/HTTP(S)服务器自动下 载差分固件包 外部 MCU 3. 执行AT+QFOTADL命令 移远通信 模块 5. 自动升级模块 固件 图 1：DFOTA 固件升级流程 如上图所示，用户仅需操作如下步骤即可通过 DFOTA 升级固件： 第一步：从移远通信或代理商获取差分固件包； 第二步：将差分固件包放到 FTP/HTTP(S)服务器或者外部 MCU； 第三步：执行 AT+QFOTADL； 第四步：模块将自动通过 LTE/WCDMA/GSM/GPRS 网络从 FTP/HTTP(S)服务器下载差分固件包或者 从外部 MCU 处接收差分固件包； 第五步：自动升级模块固件。 上海移远通信技术股份有限公司 8 / 28 LTE Standard(A)系列 DFOTA 应用指导 备注 DFOTA 升级过程中，必须确保模块已通电，否则可能导致 DFOTA 升级失败且无法还原。 2.1. 获取差分固件包 升级之前，用户需先通过 ATI 获取原固件版本，同时需确认目标固件版本；之后将原版本和目标版本 信息发送给移远通信或代理商以获取相应的差分固件包。 2.2. 存储差分固件包至 FTP/HTTP(S)服务器或外部 MCU 差分固件包存储至 FTP/HTTP(S)服务器的步骤如下： 第一步：用户需自建 FTP/HTTP(S)服务器以便 DFOTA 功能的使用（移远通信不提供该服务器）。 第二步：完成服务器建立之后，需将差分固件包存储至服务器并记录下存储路径。 差分固件包存储至外部 MCU 的路径由用户自行决定。 2.3. 执行 AT 命令升级固件 差分固件包存放至 FTP/HTTP(S)服务器或外部 MCU 后，执行 AT+QFOTADL，随后模块将从 FTP/HTTP(S)服务器下载差分固件包或者从外部 MCU 处接收差分固件包，最后进行固件升级。更多详细信 息，请参考第 3 章。 上海移远通信技术股份有限公司 9 / 28 LTE Standard(A)系列 DFOTA 应用指导 3 DFOTA 相关 AT 命令详解 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 28 LTE Standard(A)系列 DFOTA 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT 命令详解 3.3.1. AT+QFOTADL 使能 DFOTA 固件升级 该命令用于使能模块通过 DFOTA 自动进行固件升级。详细信息请参考第 3.3.1.1 章~第 3.3.1.4 章。 若差分固件包存储在 FTP/HTTP(S)服务器时，执行此命令后，模块将自动从 FTP/HTTP(S)服务器下载 差分固件包；下载完成后，模块会自动升级固件；固件升级成功后，模块会自动重启。 若差分固件包存储在外部 MCU 且 MCU 支持硬件流控时，该命令执行成功后，模块通过主串口或 USB AT 口从外部 MCU 处接收差分固件包，然后自动升级固件。 若外部 MCU 只有串口且不支持硬件流控，则执行该命令后也可使能协议下载模式，从而通过 DFOTA 进行固件升级。 AT+QFOTADL 使能 DFOTA 固件升级 测试命令 AT+QFOTADL=? 响应 +QFOTADL: ,( 支 持 的 列 表 ),( 支 持 的 列表),(支持的列 表) OK 特性说明 / 参数 字符串类型。存储至 FTP 服务器、HTTP(S)服务器或外部 MCU 上差分固 件包的 URL。最大长度：255 字节。详细内容请参考第 3.3.1.1 章~第 3.3.1.4 章。 整型。成功下载差分固件包后的升级模式。 0 成功下载差分固件包后，先重启模块再升级固件 1 成功下载差分固件包后立即升级固件 整型。下载进度 URC。最后一条 URC 表示下载完成。例如：若设置为 50， 则会上报 50 条下载进度 URC，其中第 25 条 URC 表示下载完成一半，第 上海移远通信技术股份有限公司 11 / 28 LTE Standard(A)系列 DFOTA 应用指导 50 条 URC 表示下载完成。 0 禁止上报下载进度 URC 5~100 下载进度 URC 的最大上报条数 整型。升级进度 URC。最后一条 URC 表示升级完成。例如：若设置为 50， 则会上报 50 条升级进度 URC，其中第 25 条 URC 表示升级完成一半，第 50 条 URC 表示升级完成。 0 禁止上报升级进度 URC 5~100 升级进度 URC 的最大上报条数 备注 1. Flash 大小为 8 MB 的模块进行差分升级时，存储在 FTP/HTTP(S)服务器上的 URL 地址最大长度为 128 个字符。有关 8 MB 版本和 16 MB 版本的区分方法请参考第 4 章。 2. 不同 flash 版本的模块在升级过程中 URC 上报有差异的，详情请参考第 4.2 章。 3.3.1.1. AT+QFOTADL= 差分固件包存储至 FTP 服务器时升级固件 若差分固件包储存至 FTP 服务器，执行 AT+QFOTADL=使能模块通过 DFOTA 自动进行 固件升级。命令执行成功后，模块将自动从 FTP 服务器下载差分固件包，并自动进行固件升级。 AT+QFOTADL= 差分固件包存储至 FTP 服务器时升级固件 设置命令 响应 AT+QFOTADL=[,[,[,]]] OK +QIND: 'FOTA','FTPSTART' [+QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', …] +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','START' [+QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ...] +QIND: 'FOTA','END', 特性说明 若有任何错误： ERROR / 参数 字符串类型。差分固件包存储至 FTP 服务器上的 URL 地址。该地址以'FTP://'开 上海移远通信技术股份有限公司 12 / 28 LTE Standard(A)系列 DFOTA 应用指导 头，例如：'FTP://:@:/'。最大长度：255 字节。 字符串类型。用于鉴权的用户名。最大长度：50 字节。 字符串类型。用于鉴权的密码。最大长度：50 字节。 字符串类型。FTP 服务器的 IP 地址或域名。最大长度：50 字节。 整型。FTP 服务器端口。范围：1~65535；默认值：21。 字符串类型。FTP 服务器上差分固件包的文件名。最大长度：50 字节。目前仅支 持根目录存储。 整型。成功下载差分固件包后的升级模式。 0 成功下载差分固件包后，先重启模块再升级固件 1 成功下载差分固件包后立即升级固件 整型。下载进度 URC。最后一条 URC 表示下载完成。例如：若设置为 50， 则会上报 50 条下载进度 URC，其中第 25 条 URC 表示下载完成一半，第 50 条 URC 表示下载完成。 0 禁止上报下载进度 URC 5~100 下载进度 URC 的最大上报条数 整型。升级进度 URC。最后一条 URC 表示升级完成。例如：若设置为 50， 则会上报 50 条升级进度 URC，其中第 25 条 URC 表示升级完成一半，第 50 条 URC 表示升级完成。 0 禁止上报升级进度 URC 5~100 升级进度 URC 的最大上报条数 整型。FTP 结果码。0 表示下载成功。详细信息请参考第 5.1 章。 整型。下载或升级进度。 结果码。详细信息请参考第 5.4 章。 举例 //当差分固件包存储在 FTP 服务器时，升级固件。 //FTP 服务器地址为'FTP://test:test@124.74.41.170:21/EC200ACNHAR01A02M16.bin'。 //配置 PDP 上下文，该示例中使用 PDP 上下文 ID 为 2，详情请参考文档 [1]。 AT+QICSGP=2,1,'cmnet','','',1 //配置 PDP 上下文 ID 为 2，APN 为'cmnet'（表示中国移动），用 户名和密码为空，鉴权类型为 PAP。 OK AT+QCFG='fota/cid',2 //设置 PDP 上下文 ID 为 2。 OK AT+QIACT=2 //激活 PDP 上下文。 OK //执行 AT+QFOTADL 使能通过 DFOTA 自动升级固件，随后模块会自动下载差分固件包并自动升级固件。 AT+QFOTADL='FTP://test:test@124.74.41.170:21/EC200ACNHAR01A02M16.bin',1,50 OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','DOWNLOADING',1 +QIND: 'FOTA','DOWNLOADING',2 上海移远通信技术股份有限公司 13 / 28 LTE Standard(A)系列 DFOTA 应用指导 ... +QIND: 'FOTA',' DOWNLOADING',50 +QIND: 'FOTA','FTPEND',0 //从 FTP 服务器下载差分固件包成功。 //下载完成后模块会自动重启进入升级模式，然后通过 DFOTA 进行固件升级。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //固件升级成功。 3.3.1.2. AT+QFOTADL= 差分固件包存储至 HTTP(S)服务器时升级固件 若差分固件包储存至 HTTP(S)服务器，执行 AT+QFOTADL=使能模块通过 DFOTA 自动 进行固件升级。命令执行成功后，模块将自动从 HTTP(S)服务器下载差分固件包，并自动进行固件升级。 AT+QFOTADL= 差分固件包存储至 HTTP(S)服务器时升级固件 设置命令 响应 AT+QFOTADL=[,[,[,< update_URC_max>]]] OK +QIND: 'FOTA','HTTPSTART' [+QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', …] +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' [+QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ...] +QIND: 'FOTA','END', 特性说明 若有任何错误： ERROR / 参数 字符串类型。差分固件包存储至 HTTP(S)服务器上的 URL 地址。该地址 以'http://'或'https://'开头，例如：'http://:/'。最大长度：255 字节。 字符串类型。HTTP(S)服务器的 IP 地址或域名。 整型。HTTP(S)服务器端口。范围：1~65535；默认值：80。 字符串类型。HTTP(S)服务器上差分固件包的文件名。 上海移远通信技术股份有限公司 14 / 28 LTE Standard(A)系列 DFOTA 应用指导 整型。成功下载差分固件包后的升级模式。 0 成功下载差分固件包后，先重启模块再升级固件 1 成功下载差分固件包后立即升级固件 整型。下载进度 URC。最后一条 URC 表示下载完成。例如：若设置为 50，则会上报 50 条下载进度 URC，其中第 25 条 URC 表示下载完成一 半，第 50 条 URC 表示下载完成。 0 禁止上报下载进度 URC 5~100 下载进度 URC 的最大上报条数 整型。升级进度 URC。最后一条 URC 表示升级完成。例如：若设置为 50，则会上报 50 条升级进度 URC，其中第 25 条 URC 表示升级完成一 半，第 50 条 URC 表示升级完成。 0 禁止上报升级进度 URC 5~100 升级进度 URC 的最大上报条数 整型。HTTP(S)结果码。0 表示下载成功。详细信息请参考第 5.2 章。 整型。下载或升级进度。 结果码。详细信息请参考第 5.4 章。 举例 //当差分固件包存储在 HTTP(S)服务器时，升级固件。 //HTTP(S)服务器地址为'http://www.quectel.com:100/EC200ACNHAR01A02M16.bin'。 //配置 PDP 上下文，该示例中使用 PDP 上下文 ID 为 2，详情请参考文档 [1]。 AT+QICSGP=2,1,'cmnet','','',1 //配置 PDP 上下文 ID 为 2，APN 为'cmnet'（表示中国移动），用 户名和密码为空，鉴权类型为 PAP。 OK AT+QCFG='fota/cid',2 //设置 PDP 上下文 ID 为 2。 OK AT+QIACT=2 //激活 PDP 上下文。 OK //执行 AT+QFOTADL 使能通过 DFOTA 自动升级固件，随后模块会自动下载差分固件包并自动升级固件。 AT+QFOTADL='http://www.quectel.com:100/EC200ACNHAR01A02M16.bin',1,50 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING',1 +QIND: 'FOTA','DOWNLOADING',2 ... +QIND: 'FOTA','DOWNLOADING',50 +QIND: 'FOTA','HTTPEND',0 //从 HTTP(S)服务器下载差分固件包成功。 //下载完成后模块会自动重启进入升级模式，然后通过 DFOTA 进行固件升级。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 上海移远通信技术股份有限公司 15 / 28 +QIND: 'FOTA','END',0 LTE Standard(A)系列 DFOTA 应用指导 //固件升级成功。 3.3.1.3. AT+QFOTADL='FILE:' 差分固件包存储至外部 MCU 时升级固件 若差分固件包存储在外部 MCU 且 MCU 支持硬件流控，执行 AT+QFOTADL='FILE:'进行固 件升级。命令执行成功后，模块通过主串口或 USB AT 口从外部 MCU 处接收差分固件包，然后自动升级固 件。不同的 Flash 大小的模块对该命令的适用情况有区别，详情请参考第 4.4 章。 执行 AT+QFOTADL='FILE:'前，需设置硬件流控。若未设置，主机发送固件包的速度将受 限（对于 NOR Flash 模块，速度将限制到 15 KB/s）。同时，每次发送固件包需控制在 32 个字节内。 若使用主串口，升级固件时需按照如下步骤进行： 步骤 1：MCU 打开串口工具，选择主串口并设置硬件流控； 步骤 2：发送 AT+IFC=2,2，打开模块的硬件流控； 步骤 3：从外部 MCU 上选择差分固件包； 步骤 4：发送 AT+QFOTADL='FILE:'[,[,[,< update_URC_max>]]]； 步骤 5：发送差分固件包至模块。 若使用移远通信 USB AT 口，升级固件时需按照如下步骤进行： 步骤 1：选择、打开移远通信 USB AT 口并设置硬件流控； 步骤 2：发送 AT+QCFG='usbifc',2,2，打开模块的硬件流控； 步骤 3：从外部 MCU 上选择差分固件包； 步骤 4：发送 AT+QFOTADL='FILE:'[,[,[,< update_URC_max>]]]； 步骤 5：发送差分固件包至模块。 AT+QFOTADL='FILE:' 差分固件包存储至外部 MCU 时升级固件 测试命令 响应 AT+QFOTADL='FILE:'[,[,[ ,]]] OK +QIND: 'FOTA','FILESTART' [+QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', …] +QIND: 'FOTA','FILEEND', +QIND: 'FOTA','START' [+QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ...] +QIND: 'FOTA','END', 上海移远通信技术股份有限公司 16 / 28 特性说明 LTE Standard(A)系列 DFOTA 应用指导 若有任何错误： ERROR / 参数 整型。差分固件包长度。单位：字节。 整型。文件结果码。0 表示下载成功。详细信息请参考第 5.3 章。 整型。下载或升级进度。 结果码。详细信息请参考第 5.4 章。 整型。成功下载差分固件包后的升级模式。 0 成功下载差分固件包后，先重启模块再升级固件 1 成功下载差分固件包后立即升级固件 整型。下载进度 URC。最后一条 URC 表示下载完成。例如：若设置为 50， 则会上报 50 条下载进度 URC，其中第 25 条 URC 表示下载完成一半，第 50 条 URC 表示下载完成。 0 禁止上报下载进度 URC 5~100 下载进度 URC 的最大上报条数 整型。升级进度 URC。最后一条 URC 表示升级完成。例如：若设置为 50， 则会上报 50 条升级进度 URC，其中第 25 条 URC 表示升级完成一半，第 50 条 URC 表示升级完成。 0 禁止上报升级进度 URC 5~100 升级进度 URC 的最大上报条数 备注 若外部 MCU 通过 USB AT 口接收 URC，建议禁用 USB 挂起功能以避免丢失进度 URC。 举例 //当差分固件包存储在外部 MCU 时，升级固件。 AT+QCFG='usbifc',2,2 //打开硬件流控。 OK AT+QCFG='usbifc' +QCFG: 'usbifc',2,2 OK AT+QFOTADL='FILE:4884688',1,50 OK //差分固件包长度为 4884688 字节。 +QIND: 'FOTA','FILESTART' //等待外部 MCU 通过串口工具发送差分固件包至模块。 上海移远通信技术股份有限公司 17 / 28 LTE Standard(A)系列 DFOTA 应用指导 +QIND: 'FOTA','DOWNLOADING',1 +QIND: 'FOTA','DOWNLOADING',2 ... +QIND: 'FOTA','DOWNLOADING',50 +QIND: 'FOTA','FILEEND',0 //下载成功后立即通过 DFOTA 进行固件升级。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //固件升级成功。 3.3.1.4. AT+QFOTADL='FILE:', 外部 MCU 采用本地 File 的方式通过不支持硬件流控的 串口升级固件 若外部 MCU 只有串口且不支持硬件流控，执行该命令使能协议下载模式（本地 File 的一种特殊方式）， 从而通过 DFOTA 进行固件升级。有关协议下载模式的详细信息，请联系移远通信技术支持。不同的 Flash 大小的模块对该命令的适用情况有区别，详情请参考第 4.4 章。 AT+QFOTADL='FILE:', 外部 MCU 采用本地 File 的方式通过不支持硬件流 控的串口升级固件 设置命令 响应 AT+QFOTADL='FILE:', 010003 特性说明 若有任何错误： ERROR / 参数 整型。差分固件包的长度。 整型。 2 使能协议下载模式进行 DFOTA 固件升级 上海移远通信技术股份有限公司 18 / 28 LTE Standard(A)系列 DFOTA 应用指导 4 不同 Flash 版本固件升级差异 移远通信 LTE Standard(A)系列模块根据 Flash 大小分为 8 MB 版本和 16 MB 版本。8 MB 版本和 16 MB 版本的模块都仅支持差分升级。 Flash 大小差异可通过固件版本包名称进行区分，8 MB 版本的固件包名称以'M08'结尾，16 MB 版 本的固件包名称以'M16'结尾。例如：EC200ACNHAR01A02M16 对应的模块 Flash 大小为 16 MB； EC200SCNLAR01A01M08 对应的模块 Flash 大小为 8 MB。 本章节介绍 Flash 大小为 8 MB 及 16 MB 的模块在差分固件包制作、URC 上报、升级过程和升级命令 上的差异。 备注 本章节所提及的'差分固件包名称'不包含文件扩展名。 4.1. 差分固件包制作差异 ⚫ 8 MB 版本差分固件包 8 MB 版本的差分固件包分成两个差分固件包，两个差分固件包名称相同，但两个差分固件包的扩展名 分别为'.mini_1'和'.mini_2'。示例如下： 图 2：8 MB 版本的差分固件包 上海移远通信技术股份有限公司 19 / 28 LTE Standard(A)系列 DFOTA 应用指导 ⚫ 16 MB 版本差分固件包 16 MB版本的差分固件包不分开打包，只需保证差分固件包的扩展名不为'.mini'即可。 备注 1. 8 MB 版本固件差分升级过程中，输入扩展名为'.mini_1'的差分固件包名称，下载并升级完成后， 模块会自动下载扩展名为'.mini_2'的差分固件包。因此制作差分包时，两个差分固件包名称需要 相同。 2. 8 MB 版本具备固件差分包后缀校验机制，因此必须保证差分固件包的扩展名的完整性。 4.2. URC 上报差异 ⚫ 8 MB 版本 URC 上报 8 MB 版本的模块进行差分升级时，只上报差分包升级进度 URC，最大上报数量使用默认值，不支持 通过 AT+QFOTADL 设置。上报的升级进度 URC 中，前 60 %为扩展名为'.mini_1'的固件包的升级进度 URC，后 40 %为扩展名为'.mini_2'的固件包的升级进度 URC 。示例如下： 图 3：8 MB 版本升级进度 URC ⚫ 16 MB 版本 URC 上报 16 MB 版本的模块进行差分升级时， 支持通过 AT+QFOTADL 设置固件包下载进度 URC；但升级进 度 URC 的最大上报数量使用默认值，不支持通过 AT+QFOTADL 设置。示例如下： 上海移远通信技术股份有限公司 20 / 28 LTE Standard(A)系列 DFOTA 应用指导 图 4：16 MB 版本固件包下载进度 URC 图 5：16 MB 版本固件包升级进度 URC 4.3. 升级过程差异 ⚫ 8 MB 版本固件升级流程 1. 执行 AT+QFOTADL，模块自动重启进入下载模式，开始下载扩展名为'.mini_1'的差分固件包， 下载完成后模块自动重启进入升级模式，开始升级扩展名为'.mini_1'的差分固件包。 2. 扩展名为'.mini_1'的差分固件包升级完成后，模块自动重启仍进入下载模式，开始下载扩展名 为'.mini_2'的差分固件包，下载完成后再升级扩展名为'.mini_2'的差分固件包。 3. 扩展名为'.mini_2'的差分固件包升级完成后，模块自动重启进入正常模式。 ⚫ 16 MB 版本固件升级流程 1. 执行 AT+QFOTADL，模块开始下载差分固件包。 2. 差分固件包下载完成后模块自动重启进入升级模式，然后通过 DFOTA 进行固件升级。 3. 升级完成后模块自动重启进入正常模式。 上海移远通信技术股份有限公司 21 / 28 LTE Standard(A)系列 DFOTA 应用指导 备注 1. 执行 AT+QFOTADL，8 MB 版本模块自动重启进入下载模式，只有当扩展名为'.mini_1'和'.mini_2' 的差分固件包都下载升级完成后，模块才能进入正常模式，否则会一直处于下载模式，且只保留注网 相关及支持差分固件包的下载和升级功能。因此，进行差分升级前用户需仔细检查上传服务器的差 分固件包名称和路径是否正确。 2. 若差分固件包出现错误，可将错误的差分固件包删除，然后将正确的差分固件包重新上传至 FTP/HTTP(S)服务器或存储至外部 MCU，在下载模式下再次执行 AT+QFOTADL 继续进行固件升级。 3. 固件升级过程中，模块会经历多次的重启，因此需要注意是否有异常发生，例如 USB 掉口等。 4.4. 升级命令差异 ⚫ 8 MB 版本固件升级命令 执行 AT+QFOTADL 进行固件差分升级时，8 MB 版本的模块只支持差分固件包存储在 FTP/HTTP(S) 服务器上进行固件升级，即支持 AT+QFOTADL=和 AT+QFOTADL=，不支持 差 分 包 存 储 在 外 部 MCU 上 进 行 差 分 升 级 ， 即 不 支 持 AT+QFOTADL='FILE:' 和 AT+QFOTADL='FILE:',。 ⚫ 16 MB 版本固件升级命令 16 MB 版本的模块进行固件差分升级时，支持通过 AT+QFOTADL=、AT+QFOTADL=< HTTP_URL>、AT+QFOTADL='FILE:'和 AT+QFOTADL='FILE:',进行固件升级。 上海移远通信技术股份有限公司 22 / 28 LTE Standard(A)系列 DFOTA 应用指导 5 结果码 本章介绍了与移动设备和网络相关的结果码。有关，，和的详 细信息，请参考以下子章节。另外，8 MB 版本的模块不支持下载进度 URC 的上报，所以下载过程中没有 结果码。 5.1. 结果码一览表 结果码的详细信息列举如下： 表 3：值描述 值 0 601 602 603 604 605 606 607 608 609 610 611 描述 FTP 下载成功 FTP 未知错误 FTP 服务受阻 FTP 服务忙 DNS 解析失败 网络错误 控制连接关闭 数据连接关闭 对方关闭 Socket 超时错误 无效参数 文件打开失败 上海移远通信技术股份有限公司 23 / 28 LTE Standard(A)系列 DFOTA 应用指导 612 文件路径错误 613 文件错误 614 服务不可用，正在关闭控制连接 615 打开数据连接失败 616 连接关闭，传输中止 617 未请求文件 618 请求操作中止：处理时发生本地错误 619 请求操作未执行：系统内存不足 620 语法错误，命令未识别 621 参数语法错误 622 命令未实施 623 命令坏顺序 624 命令参数未实施 625 登录 FTP 失败 626 存储文件需账号 627 请求操作未执行 628 请求操作中止：页面类型未知 629 请求文件操作中止 上海移远通信技术股份有限公司 24 / 28 LTE Standard(A)系列 DFOTA 应用指导 5.2. 结果码一览表 结果码的详细信息列举如下： 表 4：值描述 值 0 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 描述 HTTP(S) 下载成功 HTTP(S) 未知错误 HTTP(S) 超时 HTTP(S) 忙 HTTP(S) UART 忙 HTTP(S) 未获取/发送请求 HTTP(S) 网络繁忙 HTTP(S) 网络打开失败 HTTP(S) 网络未配置 HTTP(S) 网络被去激活 HTTP(S) 网络错误 HTTP(S) URL 错误 HTTP(S) URL 空 HTTP(S) IP 地址错误 HTTP(S) DNS 错误 HTTP(S) Socket 创建错误 HTTP(S) Socket 连接错误 HTTP(S) Socket 读取错误 HTTP(S) Socket 写入错误 HTTP(S) Socket 关闭 上海移远通信技术股份有限公司 25 / 28 LTE Standard(A)系列 DFOTA 应用指导 720 HTTP(S) 数据编码错误 721 HTTP(S) 数据解码错误 722 HTTP(S) 读取超时 723 HTTP(S) 响应失败 724 来电繁忙 725 语音通话繁忙 726 输入超时 727 等待数据超时 728 等待 HTTP(S) 响应超时 729 分配内存失败 730 无效参数 5.3. 结果码一览表 结果码的详细信息列举如下： 表 5：值描述 值 0 500 描述 文件下载成功 文件下载错误 上海移远通信技术股份有限公司 26 / 28 5.4. 结果码一览表 结果码的详细信息列举如下： 表 6：值描述 值 0 504 505 506 507 552 553 描述 DFOTA 升级成功 DFOTA 升级失败 DFOTA 包校验出错 DFOTA 固件 MD5 检查错误 DFOTA 包版本不匹配 DFOTA 包项目名不匹配 DFOTA 包基线名不匹配 LTE Standard(A)系列 DFOTA 应用指导 上海移远通信技术股份有限公司 27 / 28 LTE Standard(A)系列 DFOTA 应用指导 6 附录 参考文档和术语缩写 表 7：参考文档 文件名称 [1] Quectel_LTE_Standard(A)系列_TCP(IP)_应用指导 表 8：术语缩写 缩写 APN DFOTA FTP GSM GPRS HTTP HTTPS IP LTE MCU PAP PDP URL WCDMA 英文全称 Access Point Name Delta Firmware Over-The-Air File Transfer Protocol Global System for Mobile Communications General Packet Radio Service Hyper Text Transfer Protocol Hyper Text Transfer Protocol Secure Internet Protocol Long Term Evolution Microcontroller Unit Password Authentication Protocol Packet Data Protocol Uniform Resource Locator Wideband Code Division Multiple Access 中文全称 接入点名称 固件空中差分升级 文件传输协议 全球移动通信系统 通用无线分组业务 超文本传输协议 超文本传输安全协议 网际互连协议 长期演进 微型控制单元 口令验证协议 分组数据协议 统一资源定位符 宽带码分多址 上海移远通信技术股份有限公司 28 / 28

EC200A 系列 SLIC 应用指导 LTE Standard 模块系列 版本：1.0 日期：2022-09-30 状态：受控文件 EC200A 系列 SLIC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 EC200A 系列 SLIC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 15 文档历史 修订记录 版本 日期 作者 - 2022-04-24 Amos YAO 1.0 2022-09-30 Amos YAO 变更表述 文档创建 受控版本 EC200A 系列 SLIC 应用指导 上海移远通信技术股份有限公司 3 / 15 EC200A 系列 SLIC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................ 8 2.3. AT+QSLIC 启用/禁用 SLIC...................................................................................................... 8 3 设计方案 .............................................................................................................................................. 10 3.1. 设计框图 ................................................................................................................................... 10 3.1.1. Modem 侧.......................................................................................................................11 3.1.2. AP 侧 ..............................................................................................................................11 3.2. SLIC 主要功能 ...........................................................................................................................11 3.2.1. 语音数据传输和控制.......................................................................................................11 3.2.2. 话机控制 .........................................................................................................................11 3.2.3. 呼叫状态控制................................................................................................................. 12 4 SLIC 功能列表..................................................................................................................................... 13 5 附录 参考文档及术语缩写 .................................................................................................................. 15 上海移远通信技术股份有限公司 4 / 15 EC200A 系列 SLIC 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：SLIC 功能列表 .................................................................................................................................. 13 表 3：参考文档 ........................................................................................................................................... 15 表 4：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 EC200A 系列 SLIC 应用指导 1 引言 本文档介绍如何使用移远通信 LTE Standard EC200A 系列模块的 SLIC 功能，包括相关 AT 命令、设 计方案和功能介绍。 上海移远通信技术股份有限公司 6 / 15 EC200A 系列 SLIC 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 15 EC200A 系列 SLIC 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QSLIC 启用/禁用 SLIC 该命令用于启用/禁用 SLIC。 AT+QSLIC 启用/禁用 SLIC 测试命令 AT+QSLIC=? 查询命令 AT+QSLIC? 设置命令 AT+QSLIC=, 最大响应时间 特性说明 响应 +QSLIC: (支持的列表),(支持的范围) OK 响应 +QSLIC: [,] OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用 SLIC。 0 禁用 1 启用 整型。设置 SLIC 类型。 0 预留 1 LE9641 2 SI32185 3 LE9643 上海移远通信技术股份有限公司 8 / 15 举例 AT+QSLIC=? +QSLIC: (0,1),(0-3) OK AT+QSLIC=0,3 OK AT+QSLIC=1,3 OK AT+QSLIC? +QSLIC: 1,3 OK EC200A 系列 SLIC 应用指导 //测试命令。 //禁用 SLIC。 //启用 SLIC 并设置 SLIC 平台类型为 LE9643。 //查询当前配置。 上海移远通信技术股份有限公司 9 / 15 EC200A 系列 SLIC 应用指导 3 设计方案 3.1. 设计框图 EC200A系列模块的SLIC功能软件框架设计如下图所示： VoLTE Service & CS Voice Service Audio Voice Core Services QMI SLIC APP Voice Server PCM Call Manager DSCI AT AT^DSCI ATA/ATD/ AT+CHLD/ AT+VTS... control Driver PCM SPI SLIC RJ11 图 1：SLIC 功能设计框图 Control path Data path 上海移远通信技术股份有限公司 10 / 15 EC200A 系列 SLIC 应用指导 3.1.1. Modem 侧 模块在 Modem 侧提供了一系列用于实现呼叫功能的 AT 命令，包括接听（ATA）、挂断（ATH）、呼叫 状态上报（AT^DSCI）、呼叫保持和多方通话（AT+CHLD）等。这些命令直接控制 Modem 侧的呼叫相关 业务，有关 AT 命令的详细信息，请参考文档 [1]。 3.1.2. AP 侧 移远通信基于上述 AT 命令在模块的 AP 侧开发了 SLIC 应用程序和 Voice Server 应用程序。 SLIC 应用程序支持以下功能：通过电话状态机和 AT 命令进行 Modem 侧的呼叫状态控制、通过 SPI 与 SLIC 设备进行交互、获取话机的操作和控制话机的线路状态。 Voice Server 应用程序支持以下功能：控制语音链路的开关和语音数据传输，控制 PCM 时钟的开关， 提供本地铃声方案，输出不同国家或地区的标准的忙音、呼叫等待音和结束音等。 3.2. SLIC 主要功能 SLIC 主要支持三部分功能：语音数据传输和控制、话机控制和呼叫状态控制。 3.2.1. 语音数据传输和控制 基于 VoLTE 协议栈和音频管理组件，模块能够实现基于 SLIC 设备的语音通话和控制功能。 模块能将下行链路的语音数据通过声卡传输到 SLIC 芯片，SLIC 芯片将语音数据解码为模拟信号，通 过 RJ11 将信号传输给话机，话机通过扬声器播放声音。同时，话机的麦克风采集到的语音模拟信号会传输 到 SLIC 芯片，SLIC 芯片将模拟信号编码为数字信号，即语音数据，然后通过声卡传输到上行语音链路中。 3.2.2. 话机控制 话机支持的操作有：按 DTMF 按键、摘机（Off-Hook）、挂机（On-Hook）、按闪断键（Flash Button）。 当话机进行以上操作时，SLIC 芯片通过 RJ11 获取话机信号，并分析话机的动作，写入 SLIC 芯片的寄存 器中，模块通过 SPI 驱动读取 SLIC 芯片的相关寄存器，从而获得话机的操作；同时，模块也可以通过 SPI 驱动配置 SLIC 寄存器，让 SLIC 芯片产生信号给话机，让话机实现振铃、来电显示等功能。 上海移远通信技术股份有限公司 11 / 15 EC200A 系列 SLIC 应用指导 3.2.3. 呼叫状态控制 基于 VoLTE 协议栈，执行 AT^DSCI=1 后，Modem 侧能够将呼叫状态主动上报到 SMD 通道，AP 侧 的 SLIC 应用程序通过 SMD 通道获取呼叫状态。同时，AP 侧的 SLIC 应用程序可以通过 SMD 通道向 Modem 侧发送 AT 命令，实现接听（ATA）、挂断（ATH）、呼叫保持和多方通话（AT+CHLD）等功能。 上海移远通信技术股份有限公司 12 / 15 EC200A 系列 SLIC 应用指导 4 SLIC 功能列表 本章节介绍 EC200A 系列模块的 SLIC 详细功能。 表 2：SLIC 功能列表 功能 电源管理 摘机（Off-Hook） 挂机（On-Hook） 拨号 来电显示 振铃 来电接听 建立通话 带外 DTMF 切换通话（呼叫保持） 多方通话（电话会议） 功能详解 1. 启用 SLIC 后，话机上电，话机屏幕点亮。 2. 禁用 SLIC 后，话机掉电，话机屏幕关闭。 话机挂机状态下，无来电，话机摘机后播放拨号音。 1. 通话中挂机，可以挂断当前通话。 2. 拨号中挂机，可以终止拨号，并清空已拨号码。 挂机状态下，摘机听到拨号音后，按下 DTMF 键，拨号音停止。然后依次 按下期望拨出的号码，当最后一个按键按下后，等待 5 秒，拨出电话。 话机挂机状态下，有来电时，话机屏幕上显示来电号码。 话机挂机状态下，有来电时，话机振铃，提醒来电。 1. 话机挂机状态下，有来电时，话机摘机后即可接听。 2. 通话状态下，有来电时，通过闪断键保持当前通话并接听新的来电。 1. 拨号完毕后，话机实现语音通话。 2. 来电接听后，话机实现语音通话。 通话状态下，话机按下'0'~'9'、'#'、'*'等按键后，可以发送对应 的信令。 1. 话机作主叫时：话机与一方（例如 A）通话，话机按下 Flash 键，约 4 秒后，A 将保持呼叫等待状态，话机再次响起拨号音。再次拨号呼 叫另一方（例如 B），话机可以与 B 通话，再次按下 Flash 键后，能够 保持与 B 的通话，切换到与 A 的通话。重复按下 Flash 键，能够切换 A 与 B 之间的通话。 2. 话机作被叫时：话机与一方（例如 A）通话时，另一方（例如 B）呼 入，话机按下 Flash 按键后，按下按键'0'，将拒接 B。话机按下 Flash 键后，按下按键'1'，将接听 B 并保持与 A 的通话。重复按下 Flash+1 按键，能够切换 A 与 B 之间的通话。 1. 话机与一方（例如 A）通话，话机按下 Flash 键，约 4 秒后，A 将保 持呼叫等待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B）， 话机可以与 B 通话，按下 Flash 键后约 500 毫秒~2 秒内，按下按键 '3'，能够合并通话，此时实现与 A 和 B 的三方通话。 上海移远通信技术股份有限公司 13 / 15 拨号音 忙音 等待音 结束音 EC200A 系列 SLIC 应用指导 2. 如需继续增加通话，请继续以下步骤： 1） 再次按下 Flash 键后，保持与 A 和 B 的合并通话，话机再次响 起拨号音； 2） 再次拨号呼叫另一方（例如 C），话机可与 C 通话，按下 Flash 键 后，能够保持与 C 的通话，切换到与 A 和 B 的合并通话。重复按 下 Flash 键，能够在与 A 和 B 的合并通话和与 C 通话之间进行切 换。 3） 按下 Flash 键后约 500 毫秒~2 秒内，按下按键'3'，能够合并通 话，此时实现与 A、B 和 C 进行四方通话。 3. 如果需要继续增加通话，重复步骤 1）~ 3）即可，最多可支持七方通 话(包含模块一方)。 挂机状态下，无来电，摘机后话机播放拨号音。 模块发起呼叫，对方拒接，话机播放忙音（或运营商的铃音）。 模块正在通话中，第三方呼叫模块，话机播放等待音（或运营商的铃音）。 模块正在通话中，对方挂断电话，话机播放结束音。 备注 通过免提拨打电话时，对端挂断后，需要再次按下免提键，将话机恢复为挂机状态。 上海移远通信技术股份有限公司 14 / 15 EC200A 系列 SLIC 应用指导 5 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_AT 命令手册 表 4：术语缩写 术语 AP CS DTMF PCM QMI SLIC SMD SPI TA VoLTE 英文全称 Application Processor Circuit Switched Dual-Tone Multifrequency Pulse Code Modulation Qualcomm Message Interface Subscriber Line Interface Circuit Shared Memory Driver Serial Peripheral Interface Terminal Adapter Voice over Long-Term Evolution 中文全称 应用处理器 电路交换 双音多频 脉冲编码调制 高通信息接口 用户线路接口电路 共享内存驱动 串行外设接口 终端适配器 长期演进语音承载 上海移远通信技术股份有限公司 15 / 15

LTE Standard(U)系列 固件下载指导 LTE Standard 模块系列 版本：1.3 日期：2024-04-23 状态：受控文件 LTE Standard(U)系列固件下载指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 14 LTE Standard(U)系列固件下载指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 14 LTE Standard(U)系列固件下载指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2020-10-29 Jensen FANG 文档创建 1.0 2021-08-09 Jensen FANG 受控版本 1.1 2022-11-09 Mahat XU 1. 新增适用模块 EC200D-CN、EC200G-CN、EC600G-CN、 EC800G-CN、EG700G-CN 和 EG912U-GL 模块。 2. 更新模块下载过固件端口图（第 2.2 章）。 3. 新增 EC200D-CN 模块不支持串口下载固件的备注（第 2.3 章）。 1.2 2023-06-07 Mahat XU 1. 更新适用模块： ⚫ 新增适用模块 EG800G 系列 ⚫ 更改 EC200D-CN 为 EC200D 系列 ⚫ 更改 EC600G-CN 为 EC600G 系列 2. 更新 ECx00G/EGx00G 系列模块下载过固件端口图（图 4）。 3. 删除 ECx00G-CN 和 EG700G-CN 仅部分软件版本支持 USB Modem 口的备注。 更新适用模块： 1.3 2024-04-23 Kevin WANG ⚫ 更新 EG912U-GL 为 EG912U 系列； ⚫ 新增 EG915G-EU。 上海移远通信技术股份有限公司 3 / 14 LTE Standard(U)系列固件下载指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 2 固件下载 ................................................................................................................................................. 8 2.1. 驱动安装 ...................................................................................................................................... 8 2.2. 端口配置 ...................................................................................................................................... 8 2.3. 固件下载 .................................................................................................................................... 10 3 附录 术语缩写...................................................................................................................................... 14 上海移远通信技术股份有限公司 4 / 14 LTE Standard(U)系列固件下载指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：术语缩写 ........................................................................................................................................... 14 上海移远通信技术股份有限公司 5 / 14 LTE Standard(U)系列固件下载指导 图片索引 图 1：模块未下载过固件端口查看................................................................................................................ 8 图 2：模块下载过固件端口查看（ECx00U/EGx00U/EG91xU 系列模块） ................................................. 9 图 3：模块下载过固件端口查看（EC200D 系列模块）............................................................................... 9 图 4：模块下载过固件端口查看（ECx00G/EGx00G 系列模块）.............................................................. 10 图 5：UpgradeDownload 固件下载工具..................................................................................................... 10 图 6：UpgradeDownload 参数配置.............................................................................................................11 图 7：固件下载完成后是否自动重启模块................................................................................................... 12 图 8：固件下载状态.................................................................................................................................... 12 图 9：打开固件下载端口失败 ..................................................................................................................... 13 图 10：固件下载完成.................................................................................................................................. 13 图 11：固件下载完成后自动重启模块 ........................................................................................................ 13 上海移远通信技术股份有限公司 6 / 14 LTE Standard(U)系列固件下载指导 1 引言 本文档主要介绍移远通信 LTE Standard(U)系列模块的固件下载方法。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U 系列 EG915G-EU EG915U 系列 上海移远通信技术股份有限公司 7 / 14 LTE Standard(U)系列固件下载指导 2 固件下载 2.1. 驱动安装 在进行固件下载之前，需要安装设备驱动。解压 USB 驱动包后根据 USB 驱动包中的安装说明进行安 装即可。 备注 请联系移远通信技术支持（support@quectel.com）获取最新版本驱动。 2.2. 端口配置 驱动安装完成后，通过 USB 连接模块至上位机。 ⚫ 若模块未下载过固件，则开机后模块进入下载模式，在上位机设备管理器可查看端口如图 1 所示。 ⚫ 若模块下载过固件，则开机后，上位机设备管理器中可查看端口如图 2、图 3 和图 4 所示。此时： (1) 发送 AT+QDOWNLOAD 重启模块并进入下载模式。 (2) 亦可短接模块 USB_BOOT 和 VDD_EXT 引脚，重启模块并进入强制下载模式，此时可查看端 口如下图所示。注意 USB_BOOT 引脚需串联 4.7 kΩ 电阻再短接到 VDD_EXT 引脚，同时增 加 TVS 管保护，具体可参考各模块的硬件设计手册文档。 图 1：模块未下载过固件端口查看 上海移远通信技术股份有限公司 8 / 14 LTE Standard(U)系列固件下载指导 图 2：模块下载过固件端口查看（ECx00U/EGx00U/EG91xU 系列模块） 图 3：模块下载过固件端口查看（EC200D 系列模块） 上海移远通信技术股份有限公司 9 / 14 LTE Standard(U)系列固件下载指导 图 4：模块下载过固件端口查看（ECx00G/EGx00G/EG915G-EU 系列模块） 2.3. 固件下载 本 文 档 以 固 件 下 载 工 具 UpgradeDownload_R24.0.0003.7z 为 例 ， 解 压 后 运 行 Bin 目 录 下 的 UpgradeDownload.exe 固件下载程序，进入 UpgradeDownload 工具烧录界面。 8915DM_cat1:8910 MODULE (PACKAGE SIZE = 5.331 MB) 按钮 1：加载固件 pac 文件 按钮 2：设置固件下载配置参数 按钮 3：开始下载固件 图 5：UpgradeDownload 固件下载工具 备注 请联系移远通信技术支持（support@quectel.com）获取最新版本固件下载工具。 1. 点击主界面的按钮 2 按需配置参数，例如配置波特率（仅针对物理串口）。 上海移远通信技术股份有限公司 10 / 14 LTE Standard(U)系列固件下载指导 图 6：UpgradeDownload 参数配置 备注 EC200D 系列模块不支持串口下载固件，无需配置波特率，可直接进入下一步骤。 在 Options 界面配置固件下载完成后是否自动重启模块。若需要重启模块，'End of download'项勾 选'Reset to Normal'后，点击'OK'完成配置。 上海移远通信技术股份有限公司 11 / 14 LTE Standard(U)系列固件下载指导 图 7：固件下载完成后是否自动重启模块 2. 如图 5 所示，点击加载固件 pac 文件按钮（按钮 1）选择目标目录中需要下载的固件.pac 文件，加 载完成后将在 UpgradeDownload 工具栏中部显示固件包的基本信息。 3. 点击开始下载固件按钮（按钮 3），若模块处于下载模式，则进入固件下载状态，如下图所示， Port 49 正处于下载中。 8915DM_cat1:8910 MODULE (PACKAGE SIZE = 5.331 MB) 上海移远通信技术股份有限公司 图 8：固件下载状态 12 / 14 LTE Standard(U)系列固件下载指导 若模块不处于下载模式，点击开始下载固件按钮（按钮 3）后会提示打开固件下载端口失败，如下图所 示。此时需要根据第 2.2 章 使模块进入下载模式。 8915DM_cat1:8910 MODULE (PACKAGE SIZE = 5.331 MB) 图 9：打开固件下载端口失败 4. 固件下载完成后，工具界面的对应端口会提示'Passed'，如下图所示。 8915DM_cat1:8910 MODULE (PACKAGE SIZE = 5.331 MB) 图 10：固件下载完成 若配置为固件下载完成后自动重启模块，工具界面的对应端口会提示'Ready'，如下图所示。 8915DM_cat1:8910 MODULE (PACKAGE SIZE = 5.331 MB) 图 11：固件下载完成后自动重启模块 上海移远通信技术股份有限公司 13 / 14 LTE Standard(U)系列固件下载指导 3 附录 术语缩写 表 2：术语缩写 缩写 APP IoT SDK USB 英文全称 Application Internet of Things Software Development Kit Universal Serial Bus 中文全称 应用程序 物联网 软件开发工具包 通用串行总线 上海移远通信技术股份有限公司 14 / 14

LTE Standard(U)系列 RF FTM 应用指导 LTE Standard 模块系列 版本：1.4 日期：2024-04-23 状态：受控文件 LTE Standard(U)系列 RF FTM 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 18 LTE Standard(U)系列 RF FTM 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 18 LTE Standard(U)系列 RF FTM 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 1.4 日期 2021-04-20 2021-04-30 2021-08-20 作者 JoJo YAN JoJo YAN JoJo YAN 2022-10-31 Mahat XU 2023-04-24 JoJo YAN/ Mahat XU 2024-04-23 Kevin WANG 变更表述 文档创建 受控版本 增加适用模块 EG915U 系列。 1. 增加适用模块 EC200D 系列、EC200G-CN、EC600GCN、EC800G-CN、EG700G-CN 和 EG912U-GL 模块 及相关信息。 2. 增加命令的最大响应时间（第 2.3 章）。 3. 增加 EC200D 系列支持的 WCDMA 制式及信道频点范 围；补充 LTE 频段及信道频点范围（第 2.3.2 & 2.3.3 章）。 4. 更新 AT+QRXFTM 命令：更新参数最大 值；增加参数和（第 2.3.2 章）。 5. 更新 AT+ QRFTEST 命令：增加参数（第 2.3.3 章）。 6. 增加错误码（第 4 章）。 1. 更新适用模块（第 1.1 章）： ⚫ 增加适用模块 EG800G 系列； ⚫ 更新 EC600G-CN 为 EC600G 系列。 2. 删 除 LTE 制 式 下 EC200G-CN 、 EC600G-CN 、 EC800G-CN 和 EG700G-CN 模 块 支 持 的 最大值为-15 dBm 的备注（第 2.3.2 章）。 3. 更新参数释义（第 2.3.2 & 2.3.3 章）。 更新适用模块： ⚫ 更新 EG912U-GL 为 EG912U 系列； ⚫ 新增 EG915G-EU。 上海移远通信技术股份有限公司 3 / 18 LTE Standard(U)系列 RF FTM 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明 ............................................................................................................................... 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 示例声明 ............................................................................................................................... 8 2.3. AT 命令详解 ............................................................................................................................... 8 2.3.1. AT+QRFTESTMODE 进入/退出 FTM 模式 .................................................................. 8 2.3.2. AT+QRXFTM FTM 模式下强收 .................................................................................... 9 2.3.3. AT+QRFTEST FTM 模式下强发................................................................................. 11 3 举例 ..................................................................................................................................................... 15 3.1. 强收命令 ................................................................................................................................... 15 3.2. 强发命令 ................................................................................................................................... 16 4 错误码 ................................................................................................................................................. 17 5 附录 术语缩写..................................................................................................................................... 18 上海移远通信技术股份有限公司 4 / 18 LTE Standard(U)系列 RF FTM 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 7 表 3：错误码............................................................................................................................................... 17 表 4：术语缩写 ........................................................................................................................................... 18 上海移远通信技术股份有限公司 5 / 18 LTE Standard(U)系列 RF FTM 应用指导 1 引言 本文档主要介绍移远通信 LTE Standard(U)系列模块的强发和强收 AT 命令，使用这些命令可在 FTM （工厂测试模式）下测试模块的强发和强收性能。 备注 不同模块型号需要根据其硬件实际支持的频段进行强收强发测试。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700G-CN EG700U-CN EG800G 系列 EG912U 系列 EG915G-EU EG915U 系列 上海移远通信技术股份有限公司 6 / 18 LTE Standard(U)系列 RF FTM 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 18 LTE Standard(U)系列 RF FTM 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QRFTESTMODE 进入/退出 FTM 模式 该命令用于设置模块进入或退出 FTM 模式。 AT+QRFTESTMODE 进入/退出 FTM 模式 测试命令 AT+QRFTESTMODE=? 响应 +QRFTESTMODE: (支持的列表) 查询命令 AT+QRFTESTMODE? OK 响应 +QRFTESTMODE: 设置命令 AT+QRFTESTMODE= OK 响应 OK 若有任何错误： ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 15 秒 该命令立即生效； 参数配置不保存。 参数 整型。进入/退出 FTM 模式。 0 退出 FTM 模式 1 进入 FTM 模式 整型。错误码；详见第 4 章。 上海移远通信技术股份有限公司 8 / 18 LTE Standard(U)系列 RF FTM 应用指导 2.3.2. AT+QRXFTM FTM 模式下强收 该命令用于模块在 FTM 模式下进行强收。 AT+QRXFTM FTM 模式下强收 测试命令 AT+QRXFTM=? 响应 +QRXFTM: ,,,< RX_power>,(支持的列表),[,] 设置命令 WCDMA AT+QRXFTM=,,, ,[,] OK 响应 +QRXFTM: [,] OK 若有任何错误： ERROR 设置命令 GSM AT+QRXFTM=,,, , 若错误与 ME 功能相关： +CME ERROR: 响应 +QRXFTM: OK 若有任何错误： ERROR 设置命令 LTE AT+QRXFTM=,,, ,[,][,] 若错误与 ME 功能相关： +CME ERROR: 响应 +QRXFTM: [,] OK 若有任何错误： ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 9 / 18 LTE Standard(U)系列 RF FTM 应用指导 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型。GSM/WCDMA/LTE 各网络制式下支持的频段。范围及对应频点如 参数解释中所示。 整型。支持的下行信道频点范围。GSM/WCDMA/LTE 各网络制式下支持的频段及 对应的下行信道频点范围如下： GSM 频段 下行信道频点范围 'GSM850' 128~251 'GSM900' 0~124, 975~1023 'GSM1800' 512~885 'GSM1900' 512~810 WCDMA 频段 'WCDMA BAND1' 'WCDMA BAND5' 'WCDMA BAND8' 下行信道频点范围 10562~10838 4357~4458 2937~3088 LTE 频段 下行信道频点范围 'LTE BAND1' 0~599 'LTE BAND2' 600~1199 'LTE BAND3' 1200~1949 'LTE BAND4' 1950~2399 'LTE BAND5' 2400~2649 'LTE BAND7' 2750~3449 'LTE BAND8' 3450~3799 'LTE BAND12' 5010~5179 'LTE BAND13' 5180~5279 'LTE BAND17' 5730~5849 'LTE BAND18' 5850~5999 'LTE BAND19' 6000~6149 'LTE BAND20' 6150~6449 'LTE BAND26' 8690~9039 'LTE BAND28' 9210~9659 'LTE BAND34' 36200~36349 'LTE BAND38' 37750~38249 'LTE BAND39' 38250~38649 'LTE BAND40' 38650~39649 'LTE BAND41' 40040~41439/39650~41589 1) 'LTE BAND66' 66436~67135 字符串类型。打开/关闭 FTM 模式下强收。 'on' 打开 FTM 模式下强收 上海移远通信技术股份有限公司 10 / 18 LTE Standard(U)系列 RF FTM 应用指导 'off' 关闭 FTM 模式下强收 整型。预期接收功率。单位：dBm。LTE 制式下，最大值为-25 dBm。 对于 EC200D 系列模块，该参数无效，可以设置为任意值。 整型。发送模式。对于 EC200D 系列模块，该参数设置为 1 或 2 时，均为 continues 模式（连续发送）。 1 burst 模式（发送一次） 2 continues 模式（连续发送） 整型。带宽。范围：0~5。仅在 LTE 制式下设置。省略时使用默认值。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 整型。调制波类型。省略时使用默认值。该参数仅 EC200D 系列模块支持。 0 QPSK 1 CW 整型。主集接收信号强度值。单位：dBm。 整型。分集接收信号强度值。单位：dBm。仅 EC200D 系列模块支持分集信号强度。 整型。错误码；详见第 4 章。 备注 1. 测试过程中如需切换制式，请先设置='off'退出当前网络制式。详细信息可参考第 3.1 章。 2. 各个型号具体支持的网络制式及对应频段，请参考对应型号的模块产品规格书。 3. 1) 除 EC200D 系列模块外，目前，对于型号后缀为-CN 的模块，LTE B41 对应的范 围为 40040~41439；对于型号后缀为-AU、-GL、-CE 和-EU 的模块，LTE B41 对应的 范围为 39650~41589。EC200D 系列模块 LTE B41 对应的范围为 39650~41589。 详细信息，可联系移远通信技术支持。 4. LTE 制式下进行强收时，若使用 CW 波，射频仪器上设置的信道频点需要比该命令设置的信道频点 偏移+0.5 MHz；若使用 ARB 模式，则不需要偏移。 5. EC200D 系列模块支持主集和分集接收信号强度，返回 2 个 RSSI 值，为主集接收 信号强度，为分集接收信号强度。WCDMA 制式下分集天线信号强度无需关注。其 他适用模块不支持 LTE 分集，设置命令返回以'-'显示。 2.3.3. AT+QRFTEST FTM 模式下强发 该设置命令用于模块在 FTM 模式下进行强发。 AT+QRFTEST FTM 模式下强发 测试命令 AT+QRFTEST=? 响应 +QRXFTM: ,,,,(支持的列表),[,] 设置命令 WCDMA AT+QRFTEST=,, ,,[,] OK 响应 OK 若有任何错误： ERROR 设置命令 GSM AT+QRFTEST=,, ,, 若错误与 ME 功能相关： +CME ERROR: 响应 OK 若有任何错误： ERROR 设置命令 LTE AT+QRFTEST=,, ,,[,][,] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 若有任何错误： ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。GSM/WCDMA/LTE 各网络制式下支持的频段。范围及对应频点如 参数解释中所示。 整型。支持的上行信道频点范围。GSM/WCDMA/LTE 各网络制式下支持的频段及 对应的上行信道频点范围如下： GSM 频段 上行信道频点范围 'GSM850' 128~251 'GSM900' 0~124, 975~1023 'GSM1800' 512~885 'GSM1900' 512~810 上海移远通信技术股份有限公司 12 / 18 LTE Standard(U)系列 RF FTM 应用指导 WCDMA 频段 'WCDMA BAND1' 'WCDMA BAND5' 'WCDMA BAND8' 上行信道频点范围 9612~9888 4132~4233 2712~2863 LTE 频段 上行信道频点范围 'LTE BAND1' 18000~18599 'LTE BAND2' 18600~19199 'LTE BAND3' 19200~19949 'LTE BAND4' 19500~20399 'LTE BAND5' 20400~20649 'LTE BAND7' 20750~21449 'LTE BAND8' 21450~21799 'LTE BAND12' 23010~23179 'LTE BAND13' 213180~23279 'LTE BAND17' 23730~23849 'LTE BAND18' 23850~23999 'LTE BAND19' 24000~24149 'LTE BAND20' 24150~24449 'LTE BAND26' 26690~27039 'LTE BAND28' 27210~27659 'LTE BAND34' 36200~36349 'LTE BAND38' 37750~38249 'LTE BAND39' 38250~38649 'LTE BAND40' 38650~39649 'LTE BAND41' 40040~41439/39650~41589 2) 'LTE BAND66' 131972~132671 字符串类型。打开/关闭 FTM 模式下强发。 'on' 打开 FTM 模式下强发 'off' 关闭 FTM 模式下强发 整型。 ⚫ 除 EC200D 系列外： GSM 下，表示 PCL 的功率等级。GSM850/EGSM900 频段下的范围为 5~19； DCS1800/PCS1900 频段下的范围为 0~15。 LTE 下，表示发送功率。范围：23 ~ -43；单位：dBm。 ⚫ EC200D 系列： 表示发射功率。 LTE 制式下，参数值无限制，但通常情况下，该值不会超过 30 dBm。 WCDMA 制式下，参数值范围为 0~23，单位：dBm。 整型。发送模式。对于 EC200D 系列模块，该参数设置为 1 或 2 时，均为 continues 模式（连续发送）。 1 burst 模式（发送一次） 2 continues 模式（连续发送） 整型。带宽。范围：0~5。仅在 LTE 制式下设置。省略时使用默认值。 上海移远通信技术股份有限公司 13 / 18 LTE Standard(U)系列 RF FTM 应用指导 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 整型。调制波类型。省略时使用默认值。该参数仅适用于 EC200D 系列模块。 0 QPSK 1 CW 整型。错误码；详见第 4 章。 备注 1. 测试过程中如需切换制式，请先设置='off'退出当前网络制式。详细信息可参考第 3.2 章。 2. 各个型号具体支持的网络制式及对应频段，请参考对应型号的模块产品规格书。 3. 2) 除 EC200D 系列模块外，目前，对于型号后缀为-CN 的模块，LTE B41 对应的范 围为 40040~41439；对于型号后缀为-AU、-EU、-CE 和-GL 的模块，LTE B41 对应的 范围为 39650~41589。EC200D 系列模块 LTE B41 对应的范围为 39650~41589。详 细信息，可联系移远通信技术支持。 4. 在 LTE 下强发时，若设置为 burst 模式，射频仪器需配置为 IF power 模式。推荐将 设置为 continues 模式。 5. EC200D 系列模块在 LTE-TDD 频段进行强发时，仅支持 20 %上行帧占比。 上海移远通信技术股份有限公司 14 / 18 LTE Standard(U)系列 RF FTM 应用指导 3 举例 3.1. 强收命令 //GSM & WCDMA & LTE 强收综合测试流程 AT+QRFTESTMODE? +QRFTESTMODE: 0 //查询当前是否进入 FTM 模式。 OK AT+QRFTESTMODE=1 OK AT+QRXFTM='GSM900',62,'on',-90,1 +QRXFTM: -91 //进入 FTM 模式。 //测试 GSM900 下行信道频点 62。 OK AT+QRXFTM='GSM900',62,'off',-90,1 OK AT+QRXFTM='LTE BAND1',300,'on',-80,1,3 +QRXFTM: -80,- //关闭 GSM 强收测试。 //测试 LTE B1 下行信道频点 300。 //接收信号强度值。 OK AT+QRXFTM='WCDMA BAND1',10580,'on',-80,1 //测试 WCDMA B1 下行信道频点 10580。 +QRXFTM: -80,-112 //接收信号强度值。 OK AT+QRXFTM='WCDMA BAND1',10580,'off',-80,1 //关闭 WCDMA 强收测试。 OK AT+QRXFTM='LTE BAND1',300,'on',-80,1,3 //测试 LTE B1 下行信道频点 300（EC200D 系列）。 +QRXFTM: -80,-98 //接收信号强度值。 OK AT+QRXFTM='LTE BAND1',300,'off',-80,1,3 OK AT+QRFTESTMODE=0 OK //关闭 LTE 强收测试。 //关闭强收测试并退出 FTM 模式。 上海移远通信技术股份有限公司 15 / 18 LTE Standard(U)系列 RF FTM 应用指导 3.2. 强发命令 //GSM & WCDMA & LTE 强发综合测试流程。 AT+QRFTESTMODE? +QRFTESTMODE: 0 //查询当前是否进入 FTM 模式。 OK AT+QRFTESTMODE=1 //进入 FTM 模式。 OK AT+QRFTEST='GSM900',62,'on',5,1 //测试 GSM900 上行信道频点 62。 OK AT+QRFTEST='GSM900',62,'off',5,1 //关闭 GSM 强发测试。 OK AT+QRFTEST='WCDMA BAND1',9612,'on',20,1 //测试 WCDMA B1 上行信道频点 9612。 OK AT+QRFTEST='WCDMA BAND1',9612,'off',20,1 //关闭 WCDMA 强发测试。 OK AT+QRFTEST='LTE BAND1',18300,'on',23,2,3 //测试 LTE B1 上行信道频点 18300。 OK AT+QRFTEST='LTE BAND1',18300,'off',23,2,3 //关闭 LTE 强发测试。 OK AT+QRFTESTMODE=0 //关闭强发测试并退出 FTM 模式。 OK 上海移远通信技术股份有限公司 16 / 18 LTE Standard(U)系列 RF FTM 应用指导 4 错误码 表示与移动设备或网络有关的错误码，详细信息可参考下表。 表 3：错误码 4 50 53 英文含义 Operation not supported Execute fail Invalid parameter 中文含义 操作不支持 执行失败 无效参数 上海移远通信技术股份有限公司 17 / 18 LTE Standard(U)系列 RF FTM 应用指导 5 附录 术语缩写 表 4：术语缩写 缩写 ARB CW FDD FTM GSM LTE RF RSSI Rx TDD Tx WCDMA QPSK 英文全称 中文全称 Adaptive Rate Based 基于自适应速度 Continuous Wave 连续波 Frequency Division Duplexing 频分双工 Factory Test Mode 工厂测试模式 Global System for Mobile Communications 全球移动通信系统 Long Term Evolution 长期演进 Radio Frequency 射频 Received Signal Strength Indication 接收的信号强度指示 Receive 接收 Time Division Duplexing 时分双工 Transmit 发送 Wideband Code Division Multiple Access 宽带码分多址 Quadrature Phase Shift Keying 正交相移键控 上海移远通信技术股份有限公司 18 / 18

LTE Standard(U)系列 QuecCell 应用指导 LTE Standard 模块系列 版本：1.6 日期：2024-04-16 状态：受控文件 LTE Standard(U)系列 QuecCell 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 17 LTE Standard(U)系列 QuecCell 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 17 LTE Standard(U)系列 QuecCell 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2021-03-10 2021-06-24 2021-08-17 1.2 2022-03-28 1.3 2022-07-15 1.4 2023-04-28 1.5 2023-08-18 1.6 2024-04-16 作者 Marvin NING Marvin NING Marvin NING Joe TU Marvin NING Joe TU/ Marvin NING Joe TU/ Marvin NING Kevin WANG 变更表述 文档创建 受控版本 增加适用模块 EG915U 系列。 1. 增加 AT+QENG='neighbourcell'命令中 LTE 异 频邻区信息的响应（第 2.3.1 章）。 2. 更新举例（第 2.3.1 章）。 1. 增加适用模块 EC600G-CN 和 EC800G-CN。 2. 增加 AT+QCELLINFO 命令中 LTE 网络制式的响 应（第 2.3.2 章）。 3. 新增模块支持的网络制式相关备注（第 2.3.1、 2.3.2 章）。 1. 增加适用模块 EC200D 系列、EC200G-CN、 EG700G-CN、EG800G-CN 和 EG912U-GL。 2. 增加 AT+QENG 命令中仅 EC200D 系列模块支 持的 WCDMA 网络制式下主服务小区和邻区信 息的响应及相关备注（第 2.3.1 章）。 3. 增 加 EC200D 系 列 模 块 暂 不 支 持 AT+QCELLINFO 的备注（第 2.3.2 章）。 1. 更新 EC600G-CN 为 EC600G 系列。 2. 更新 EG800G-CN 为 EG800G 系列。 更新适用模块： ⚫ 更新 EG912U-GL 为 EG912U 系列； ⚫ 新增 EG915G-EU。 上海移远通信技术股份有限公司 3 / 17 LTE Standard(U)系列 QuecCell 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明 ............................................................................................................................... 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 示例声明 ............................................................................................................................... 8 2.3. AT 命令描述 ............................................................................................................................... 8 2.3.1. AT+QENG 获取主服务小区和邻区信息........................................................................ 8 2.3.2. AT+QCELLINFO 获取服务小区和邻区信息 ............................................................... 12 3 附录 参考文档及术语缩写 .................................................................................................................. 16 上海移远通信技术股份有限公司 4 / 17 LTE Standard(U)系列 QuecCell 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 7 表 3：参考文档 ........................................................................................................................................... 16 表 4：术语缩写 ........................................................................................................................................... 16 上海移远通信技术股份有限公司 5 / 17 LTE Standard(U)系列 QuecCell 应用指导 1 引言 本文档详细介绍了移远通信 LTE Standard(U)系列模块 QuecCell 功能相关的 AT 命令。 QuecCell 是嵌入到移远通信模块中的一项功能，可用于扫描基站的详细信息。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U 系列 EG915G-EU EG915U 系列 上海移远通信技术股份有限公司 6 / 17 LTE Standard(U)系列 QuecCell 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 17 LTE Standard(U)系列 QuecCell 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令描述 2.3.1. AT+QENG 获取主服务小区和邻区信息 该命令用于获取主服务小区和邻区信息。 AT+QENG 获取主服务小区和邻区信息 测试命令 AT+QENG=? 响应 +QENG: (支持的列表) 设置命令 AT+QENG='servingcell' OK 响应 GSM 网络制式： +QENG: 'servingcell',,'GSM',,,,,,,,, ,,,,,,< TCH>,,,,,,,,, OK WCDMA 网络制式： +QENG: 'servingcell',,'WCDMA',,,,,,,,,< ecno>,-,-,-,-,- OK LTE 网络制式： +QENG: 'servingcell',,'LTE',,,,,,,,,,,,,,, OK 上海移远通信技术股份有限公司 8 / 17 设置命令 AT+QENG='neighbourcell' 最大响应时间 特性说明 LTE Standard(U)系列 QuecCell 应用指导 响应 GSM 网络制式： [+QENG: 'neighbourcell','GSM',,,, ,,,,,,, […]] OK WCDMA 网络制式： [+QENG: 'neighbourcell','WCDMA',,-,,,,-,-,[…]] OK LTE 网络制式： [+QENG: 'neighbourcell intra','LTE',,, ,,,,,,,, […]] [+QENG: 'neighbourcell inter','LTE',,, ,,,,,,, […]] OK 由网络决定 / 参数 字符串类型。不同类型的小区信息。 'servingcell' GSM/WCDMA/LTE 主服务小区信息 'neighbourcell' GSM/WCDMA/LTE 邻区信息 字符串类型。UE 状态。 'SEARCH' UE 正在搜网，但尚未发现合适的 GSM/WCDMA/LTE 小区。 'LIMSRV' UE 驻留在小区中，但尚未在网络上注册。 'NOCONN' UE 驻留在小区中并已在网络上注册，并且处于空闲模式。 'CONNECT' UE 驻留在小区中并已在网络上注册，并且正在进行通话。 整型。移动设备国家代码（PLMN 的第一部分）。 整型。移动设备网络代码（PLMN 的第二部分）。 上海移远通信技术股份有限公司 9 / 17 LTE Standard(U)系列 QuecCell 应用指导 两字节的十六进制格式。扫描小区的位置区域码（例如 00C1 等于十进制的 193）。范围：0~0xFFFF。 十六进制格式。小区 ID。该参数确定 16 位（GSM）或 28 位（LTE）小区 ID。范围：0~0xFFFFFFF。 整型。基站识别码。范围：0~63。 整型。绝对射频信道号。范围：0~1023。 整型。GSM 频段。 0 DCS1800 1 PCS1900 2 GSM900 '-' 其他 GSM 频段 整型。小区接收电平值（参考 3GPP 25.304）。范围：0~63；单位：dB。 该参数值减去 111，可换算为以 dBm 为单位的取值。 整型。移动台在控制信道的最大传输功率。 整型。最低接入电平。 整型。非连续接收的周期长度。 整型。选择小区时的参考标准。 整型。小区重选时的参考标准。 当前小区是否支持 GPRS。该参数暂时无效，固定值为'-'。 业务信道。该参数暂时无效，固定值为'-'。 时隙编号。该参数暂时无效，固定值为'-'。 整型。基站的时间提前量。范围：0~63。 整型。移动分配指针偏移。范围：0~63；长度：6 位。 整型。跳频序列号。范围：0~63；长度：6 位。 整型。非连续发射时的接收电平。范围：0~63。 整型。满功率发射时的接收电平。范围：0~63。 整型。非连续发射时的接收质量。范围：0~7。 整型。满功率发射时的接收质量。范围：0~7。 语音通话中的信道模式。该参数暂时无效，固定值为'-'。 整型。UTRA 绝对射频频道号。范围：712~10838。 整型。主扰码。范围：0~511。 整型。路由区号。范围：0~255。 整型。接收信号码功率。 整型。EC/NO 是每个 PN 芯片的接收能量与总接收功率谱密度的比值，与 信道有关。单位：dB。 字符串类型。通信模式。 'TDD' 时分双工模式 'FDD' 频分双工模式 整型。物理小区标识。范围：0~503。 整型。E-UTRA 绝对射频信道号。范围：9~65535。 整型。E-UTRA 频段（参考 3GPP 36.101）。 整型。上行带宽。 0 1.4 MHz 1 3 MHz 上海移远通信技术股份有限公司 10 / 17 LTE Standard(U)系列 QuecCell 应用指导 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 整型。下行带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 十六进制格式。跟踪区域码（参考 3GPP 23.003 第 19.4.2.3 章）。 范围：0~0xFFFF。 整型。参考信号接收功率。单位：dBm（参考 3GPP 36.214 第 5.1.1 章）。 整型。参考信号接收质量。单位：dB（参考 3GPP 36.214 第 5.1.3 章）。 整型。接收信号强度指示。单位：dBm。 整型。信噪比。实际 SINR 值转换公式为：Y = X / 2 - 23.5。 X 通过 AT+QENG 查询的值；范围：7~107。 Y 转换后的实际 LTE SINR 值；范围：-20~30；单位：dB。 整型。小区选择接收电平值（参考 3GPP 25.304/3GPP 36.304）。 单位：dB。 整型。GPRS 信号电平阈值标准。该参数暂时无效。 整型。小区排队标准参数。用于在相同优先级的小区中选择小区。该参数暂 时无效。 小区重选优先级。该参数暂时无效，固定值为'-'。 用于控制非同频搜索的阈值。该参数暂时无效，固定值为'-'。 当向较低优先级 RAT/频率重新选择时，UE 在服务小区上使用的 阈值。单位：dB。该参数暂时无效，固定值为'-'。 同频小区重选的测量触发门限。该参数暂时无效，固定值为'-'。 整型。低优先级小区重选阈值。评估的低优先级小区的合适接收电平值必须 大于该值。该参数暂时无效，固定值为'-'。 整型。高优先级小区重选阈值。评估的高优先级小区的合适接收电平值必须 大于该值。该参数暂时无效，固定值为'-'。 备注 1. 如果返回'-'或-，则表明该参数在当前条件下无效。 2. GSM 邻区仅在空闲模式下可见。 3. 仅 EC200D 系列模块支持 WCDMA 网络制式。有关模块支持的网络制式的详细信息，请参考相关模 块产品规格书或咨询移远通信技术支持。 4. EC200D 系列模块不支持。 上海移远通信技术股份有限公司 11 / 17 LTE Standard(U)系列 QuecCell 应用指导 举例 AT+QENG='servingcell' +QENG: 'servingcell','SEARCH' OK AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','LTE','FDD',460,01,5A23565,255,3745,8,3,3,DE10,-90,-16,-60,4 2,25 OK AT+QENG='neighbourcell' +QENG: 'neighbourcell intra','LTE',3745,337,-90,-15,-,-,31,-,-,-,+QENG: 'neighbourcell intra','LTE',3745,338,-91,-15,-,-,36,-,-,-,+QENG: 'neighbourcell intra','LTE',3745,369,-94,-17,-,-,25,-,-,-,+QENG: 'neighbourcell inter','LTE',1850,378,-71,-7,-,-,56,-,-,+QENG: 'neighbourcell inter','LTE',100,376,-107,-10,-,-,20,-,-,+QENG: 'neighbourcell inter','LTE',100,377,-111,-14,-,-,16,-,-,- OK 2.3.2. AT+QCELLINFO 获取服务小区和邻区信息 该命令用于获取服务小区和邻区信息。 AT+QCELLINFO 获取服务小区和邻区信息 测试命令 AT+QCELLINFO=? 响应 +QCELLINFO: (支持的列表),(支持的范 围),(支持的范围), 查询命令 AT+QCELLINFO? OK 响应 GSM 网络制式： [+QCELLINFO: ,'GSM',,,,,,,,,-,-,[…]] OK LTE 网络制式： [+QCELLINFO: ,'LTE',,,,,,,,,,,[,,,,,]] 上海移远通信技术股份有限公司 12 / 17 LTE Standard(U)系列 QuecCell 应用指导 […]] 设置命令 AT+QCELLINFO=[, ][,][,] OK 响应 若不等于255且命令执行成功： OK 若等于255且命令执行成功： +QCELLINFO: [,][,][,] 最大响应时间 特性说明 OK 由网络决定 该命令立即生效； 参数配置不保存。 参数 整型。 0 同步模式。当收到 AT+QCELLINFO?命令时，可能需要几秒钟来处理命令指示， 然后响应。 1 定时模式。缓存的小区信息会定时刷新，AT+QCELLINFO?命令将从缓存中获 取小区信息并立即响应。 2 异步模式。AT+QCELLINFO?命令立即响应OK，且小区信息会以URC的方式 输出如下： 1) GSM网络制式： +QCELLINFO: ,'GSM',,,,,,,, 2) LTE网络制式： +QCELLINFO: ,'LTE',,,,,,,,, 3 同步模式。与为0时的同步模式相比，以更省功耗的方式获取服务小区 信息。 4 定时模式。与为 1 时的定时模式相比，以更省功耗的方式获取服务小 区信息。 255 查询模式。仅用于设置命令。 整型。刷新缓存的服务小区信息的时间。范围：5~65535；默认值：5；单位：秒。 整型。刷新缓存的邻区信息的时间。范围：5~65535；默认值：5；单位：秒。 若省略该参数，则刷新缓存邻区信息的时间与相同。 整型。定时刷新模式下，是否允许在睡眠时自动刷新小区信息。 0 允许 1 禁止 若省略该参数，表示在定时刷新模式下允许睡眠时自动刷新小区信息。 上海移远通信技术股份有限公司 13 / 17 LTE Standard(U)系列 QuecCell 应用指导 字符串类型。不同类型的小区信息。 'servingcell' GSM/LTE 服务小区信息 'neighbourcell' GSM/LTE邻区信息 整型。移动设备国家代码（PLMN 的第一部分）。 整型。移动设备网络代码（PLMN 的第二部分）。 两字节的十六进制格式。扫描小区的位置区域码（例如 00C1 等于十进制的 193）。 范围：0~0xFFFF。 十六进制格式。跟踪区域码（参考 3GPP 23.003 第 19.4.2.3 章）。范围：0~0xFFFF。 十六进制格式。小区 ID。该参数确定 16 位（GSM）或 28 位（LTE）小区 ID。 范围：0~0xFFFFFFF。 整型。基站识别码。范围：0~63。 整型。物理小区标识。范围：0~503。 整型。小区接收电平值（参考 3GPP 25.304）。范围：0~63；单位：dB。 整型。接收功率。单位：dBm。 整型。绝对射频信道号。范围：0~1023。 整型。E-UTRA绝对射频信道号。 整型。参考信号接收功率。单位：dBm（参考 3GPP 36.214 第 5.1.1 章）。 整型。接收信号强度指示。单位：dBm。 整型。信噪比。实际 SINR 值转换公式为：Y = X / 2 - 23.5。 X 通过 AT+QCELLINFO 查询的值；范围：7~107。 Y 转换后的实际 LTE SINR 值，范围：-20~30；单位：dB。 整型。参考信号接收质量。单位：dB（参考 3GPP 36.214 第 5.1.3 章）。 整型。E-UTRA 频段（参考 3GPP 36.101）。 整型。上行带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 字符串类型。通信模式。 'TDD' 时分双工模式 'FDD' 频分双工模式 字符串类型。UE 状态。 'SEARCH' UE 正在搜网，但尚未发现合适的 GSM/LTE 小区。 'LIMSRV' UE 驻留在小区中，但尚未在网络上注册。 'NOCONN' UE 驻留在小区中并已在网络上注册，并且处于空闲模式。 'CONNECT' UE 驻留在小区中并已在网络上注册，并且正在进行通话。 备注 1. 如果返回'-'或-，则表明该参数在当前条件下无效。 2. 仅当为 1 时，参数才生效。若不为 1，则省略参数，并且默认 参数值为 5。 上海移远通信技术股份有限公司 14 / 17 LTE Standard(U)系列 QuecCell 应用指导 3. 默 认 不 输 出 ,,,,, 通 过 执 行 AT+QCFG='qcellinfo/fmt',1 即可使能输出。关于 AT+QCFG='qcellinfo/fmt',1 的详情，请参考 文档 [1]。 4. 模块支持的网络制式请参考相关模块产品规格书或咨询移远通信技术支持。 5. EC200D 系列模块暂不支持该命令。 举例 AT+QCELLINFO=1,10 OK AT+QCELLINFO=255 +QCELLINFO: 1,10,10,0 //定时模式且每 10 秒更新一次小区信息。 //查询当前配置。 //设置命令中省略参数和，则 与时间相同，默认为 0。 OK AT+QCELLINFO? +QCELLINFO: 'servingcell','LTE',460,00,268a,6e68c49,316,37,179,38950,-90,-55,42 +QCELLINFO: 'neighbourcell','LTE',460,00,268a,8dff3c2,222,49,-,40936,-,-,+QCELLINFO: 'neighbourcell','LTE',460,00,268a,6e66141,101,43,-,40936,-,-,+QCELLINFO: 'neighbourcell','LTE',460,00,268a,8abc585,321,53,-,38544,-,-,+QCELLINFO: 'neighbourcell','LTE',460,00,268a,8abc584,322,51,-,38400,-,-,+QCELLINFO: 'neighbourcell','LTE',460,00,268a,8abc58e,322,52,-,38544,-,-,- OK 上海移远通信技术股份有限公司 15 / 17 LTE Standard(U)系列 QuecCell 应用指导 3 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_AT 命令手册 表 4：术语缩写 缩写 3GPP ARFCN BSIC CCH DCS DL DRX EARFCN E-UTRA FDD GPRS GSM LAC LTE 英文全称 中文全称 The 3rd Generation Partnership Project 第三代合作伙伴计划 Absolute Radio Frequency Channel Number 绝对射频信道号 Base Station Identification Code 基站识别码 Control Channel 控制信道 Distributed Control System 分散控制系统 Downlink 下行链路 Discontinuous Reception 非连续接收 E-UTRA Absolute Radio Frequency Channel E-UTRA 绝对射频信道号 Number Evolved-Universal Terrestrial Radio Access 演进的通用陆地无线接入 Frequency Division Duplex 频分双工 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Location Area Code 位置区码 Long Term Evolution 长期演进 上海移远通信技术股份有限公司 16 / 17 MAIO MCC MNC MS PCI PCS PLMN PSC RAC RSCP RSRP RSRQ RSSI RX SINR TA TAC TCH TDD TX UARFCN UE UL UTRA WCDMA LTE Standard(U)系列 QuecCell 应用指导 Mobile Allocation Index Offset 移动分配指针偏移 Mobile Country Code 移动国家码 Mobile Network Code 移动网络码 Mobile Station 移动基站 Physical Cell Identity 物理小区识别码 Personal Communications Service 个人通讯服务 Public Land Mobile Network 公共陆地移动网 Primary Scrambling Code 主扰码 Routing Area Code 路由区号 Receive Signal Channel Power 接收信号码功率 Reference Signal Receiving Power 参考信号接收功率 Reference Signal Received Quality 参考信号接收质量 Received Signal Strength Indicator 接收信号强度指示 Receive 接收 Signal to Interference plus Noise Ratio 信号与干扰加噪声比 Terminal Adapter 终端适配器 Tracking Area Code 跟踪区域码 Traffic Channel 业务信道 Time Division Duplex 时分双工 Transmit 发送 UTRA Absolute Radio Frequency Channel UTRA 绝对射频频道号 Number User Equipment 用户设备 Uplink 上行链路 UMTS Terrestrial Radio Access UMTS 地面无线接入 Wideband Code Division Multiple Access 宽带码分多址 上海移远通信技术股份有限公司 17 / 17

LTE Standard(U)系列 PPP 应用指导 LTE Standard 模块系列 版本：1.4 日期：2024-04-08 状态：受控文件 LTE Standard(U)系列 PPP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 27 LTE Standard(U)系列 PPP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 27 LTE Standard(U)系列 PPP 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2021-04-16 Baron ZHENG 文档创建 1.0 2021-05-10 Baron ZHENG 受控版本 1.1 2021-08-17 Baron ZHENG 增加适用模块 EG915U 系列。 1.2 2022-06-21 Baron ZHENG/ 增加适用模块 EC200D-CN、EC600G-CN 和 EC800G-CN。 Joe TU 更新适用模块： ⚫ 新 增 EC200G-CN 、 EG700G-CN 、 EG800G 系 列 和 Baron ZHENG/ 1.3 2023-06-26 EG912U-GL； Joe TU ⚫ 更新 EC200D-CN 为 EC200D 系列； ⚫ 更新 EC600G-CN 为 EC600G 系列。 更新适用模块： 1.4 2024-04-08 Kevin WANG ⚫ 更新 EG912U-GL 为 EG912U 系列； ⚫ 新增 EG915G-EU。 上海移远通信技术股份有限公司 3 / 27 LTE Standard(U)系列 PPP 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 2 PPP 应用模式........................................................................................................................................ 8 3 PPP 设置 ............................................................................................................................................... 9 3.1. PPP 设置流程............................................................................................................................. 9 3.2. PPP 设置流程建议 ................................................................................................................... 10 4 PPP 连接模式...................................................................................................................................... 12 4.1. 数据模式和命令模式................................................................................................................. 12 4.1.1. 从数据模式切换到命令模式 ........................................................................................... 12 4.1.1.1. 更改 DTR 电平切换为命令模式 .......................................................................... 12 4.1.1.2. 使用+++切换至命令模式 .................................................................................... 12 4.1.2. 从命令模式切换到数据模式 ........................................................................................... 13 4.1.2.1. 使用 ATO 切换到数据模式.................................................................................. 13 4.2. 数据模式下处理 URC ............................................................................................................... 13 4.3. 数据载波检测（DCD）模式 ..................................................................................................... 13 5 终止 PPP 连接..................................................................................................................................... 14 6 PPP 拨号操作...................................................................................................................................... 15 6.1. 准备工作 ................................................................................................................................... 15 6.2. Windows 10 系统下的 PPP 拨号.............................................................................................. 15 6.2.1. 调制解调器配置 ............................................................................................................. 15 6.2.1.1. 添加新的调制解调器........................................................................................... 15 6.2.1.2. 配置调制解调器驱动........................................................................................... 19 6.2.2. 拨号上网网络配置 ......................................................................................................... 21 6.2.2.1. 创建新的网络连接 .............................................................................................. 21 6.2.2.2. 配置连接 ............................................................................................................. 23 6.2.2.3. 配置拨号工具...................................................................................................... 24 6.2.2.4. 建立拨号上网连接 .............................................................................................. 25 7 附录 参考文档及术语缩写 .................................................................................................................. 26 上海移远通信技术股份有限公司 4 / 27 LTE Standard(U)系列 PPP 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：参考文档 ........................................................................................................................................... 26 表 3：术语缩写 ........................................................................................................................................... 26 上海移远通信技术股份有限公司 5 / 27 LTE Standard(U)系列 PPP 应用指导 图片索引 图 1：PPP 应用模式..................................................................................................................................... 8 图 2：PPP 设置流程..................................................................................................................................... 9 图 3：PPP 设置推荐流程图........................................................................................................................ 10 图 4：查找电话和调制解调器 ..................................................................................................................... 16 图 5：添加新的调制解调器......................................................................................................................... 17 图 6：选择调制解调器类型......................................................................................................................... 18 图 7：选择端口 ........................................................................................................................................... 18 图 8：安装新调制解调器成功 ..................................................................................................................... 19 图 9：配置调制解调器驱动......................................................................................................................... 20 图 10：设置新的连接或网络....................................................................................................................... 21 图 11：设置新连接...................................................................................................................................... 22 图 12：配置连接 ......................................................................................................................................... 23 图 13：配置拨号上网工具 .......................................................................................................................... 24 图 14：正在连接到拨号连接....................................................................................................................... 25 图 15：拨号连接成功.................................................................................................................................. 25 上海移远通信技术股份有限公司 6 / 27 LTE Standard(U)系列 PPP 应用指导 1 引言 本文档简要介绍了移远通信 LTE Standard(U)系列模块的 PPP 功能，包括 PPP 应用模式、设置步骤、 连接模式、终止步骤和拨号示例等。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U 系列 EG915G-EU EG915U 系列 上海移远通信技术股份有限公司 7 / 27 LTE Standard(U)系列 PPP 应用指导 2 PPP 应用模式 PPP（点对点协议）的使用方法如下图所示，UART 端口或 USB 端口均可用于 PPP 连接。模块为应 用程序提供 PPP 服务器，应用程序端为模块提供 PPP 客户端。同时，应用程序端必须提供 TCP/IP、 HTTP(S)等协议。当建立 PPP 连接时，来自应用程序端的 IP 报文数据流将通过模块传输到网络。 大多数标准操作系统（例如 Windows 系统、Unix/Linux 系统）都有 PPP 协议栈。针对无可用应用程 序进行 PPP 连接的操作系统，需先开发适用的应用软件。 Application IP PPP UART TXD RXD CTS RTS DTR DCD RING USB USB_DM USB_DP USB_GN USB_VBUS 应用程序端 IP RELAY PPP TXD RXD CTS RTS DTR DCD RING UART Radio Bearer USB_DM USB_DP USB_GND USB_VBUS USB 模块端 图 1：PPP 应用模式 上海移远通信技术股份有限公司 8 / 27 LTE Standard(U)系列 PPP 应用指导 3 PPP 设置 3.1. PPP 设置流程 模块注册网络后，需通过 AT+CGDCONT 为 PPP 设置 APN，并通过 ATD*99#启动 PPP。执行 ATD*99#后，模块将进入 PPP 帧交互流程，该流程基于标准 PPP 进行。模块数据包交互说明如下图所 示。如需获取有关标准 PPP 的详细信息，可参考 RFC 1661。 TE MT AT+CGREG? +CGREG:0,1 AT+CGDCONT=1,'IP','CMNET' OK ATD*99# CONNECT 7E FF 7D 23 C0 21 7D 21 7D …… 图 2：PPP 设置流程 上海移远通信技术股份有限公司 9 / 27 3.2. PPP 设置流程建议 LTE Standard(U)系列 PPP 应用指导 建议 开关 机方式 ： 有关 各适用 模块建 议的开 关机方 式详细 信息 ，可参 考各适 用模块 的硬件 设计手 册文 档。 查询 (U)SIM卡状态： A T+C PIN。如果 执行A T+C PIN?后20 秒 内没有检测到 (U)SIM卡，重启模块。 网络： 1. 当AT+CREG=?返回1或5时，表示模 块已 在网络 上注册 。 2. 如果模块在60秒内无法注册网络，请 重启 模块。 PS网络： 1. 当AT+CGREG返回1或5时，表示模 块已 在PS上注 册。 2. 注册PS后无需等待60秒即可进入下一 步。 模块 上电 1. TE与 TA同步。 2. 执行AT+IPR=xxx;&W，设置并保存波特率. 若使 用USB modem口，可省略此操作。 如果 (U)SIM卡在20秒内未就绪， 则退 出PPP拨号 。 AT+CPIN? 是 查询(U)SIM 卡状 态 (U)SIM卡准 备就绪 如果 模块在 60 秒内 无法注 册 网络 ，则退 出PPP拨号 AT+CREG? 查 询网 络状态 60 秒内 注册网 络 AT+CGREG? 查 询 PS网络 否 Connect_Count < 5 APN 配置： 1. APN 必须由 AT+CGDCONT配置。 2. 当AT+CGDCONT返回错误时，执行 A T+C GA CT?查询 当前上 下文是 否已被 激活。 1. 通过 AT+CGDCONT设置APN 2. 通过 ATD*99#开始PPP拨号 Connect_Count++ 数据包交互 数据 包互 动： 1. 通过+++退出数据包交互过程。 2.当PPP连接 终止时 ，模块 将上报 N O CARRIER。 LCP协商： 1. 若使用UART，请确保MCU与模块之 间的 波特率 相同。 AUTH 协商： 1. 确保AUTH的类型为PAP（0xc023） 与C HAP（0x c22 3）其中 之一。 IPCP 协商： 1. 检查MCU是否获取合法的IP和DNS 地址。 2. 检查DNS MCU的数量是否与MCU请 求的 数量一 致。 3. 如果TA和TE之间的IPCP协商未在90 秒内 完成，终止 PPP连接 ，并重 试PPP 设置。 异常 处理 ： 1. 检查PPP终止请求数据包是否正确。 2. 若上述步骤未生效，重启模块。 IPCP协商 开始时 ， 启动 定时器 返回 CONNECT LCP 协商 OK AUTH 协商 OK 异常 处理 否 Send Count < 5 IPCP 协商 是 否 OK 90 秒内 成功进 行 IPCP协商 MCU 向 否 PPP发送 Terminate- Request数 据包 MCU 在3秒内接 收PPP Terminate- 是 R equ es t数据 包 Send Count++ 是 MCU已获取IP 和 否 DNS 是 数据 传输 图 3：PPP 设置推荐流程图 上海移远通信技术股份有限公司 10 / 27 LTE Standard(U)系列 PPP 应用指导 模块上电时，如果使用主串口，通过执行 AT+IPR=xxx;&W 设置波特率。执行 ATD*99#设置 PPP 之 前 ， 必须 通过 AT+CPIN? 检 查 (U)SIM 卡 的状 态。 当 (U)SIM 卡 准 备就 绪时 ， 请通过 AT+CREG?和 AT+CGREG?定期检查网络注册状态，直到网络准备就绪。 备注 1. 重启模块后，请确保 MCU 和模块同步成功。MCU 每隔 100 毫秒会向模块发送 AT直至 收到模块上报的 OK。如果使用主串口，MCU 会在成功同步波特率后通过执行 AT+IPR=xxx;&W 来 设置并保存波特率。 2. 输入下一个 AT 命令之前，MCU 需等待前一个 AT 命令的响应（如响应 OK、CME ERROR 和 CMS ERROR 等）。若 60 秒内无响应，可重启模块。 3. 强烈建议不要频繁开启或关闭模块。如果连续 3 次拨号重试失败，则可立即进行第 1 次关闭/打开（重 置）模块。重置后，若拨号重试仍失败，则需等待 10 分钟后进行第 2 次重置模块，30 分钟后进行 第 3 次重置模块，一小时后进行第 4 次重置模块。 4. 如果在建立 PPP 连接后 MCU 未能将数据传输到网络，请检查 PPP 的配置和网络状态并重启模块。 上海移远通信技术股份有限公司 11 / 27 LTE Standard(U)系列 PPP 应用指导 4 PPP 连接模式 4.1. 数据模式和命令模式 模块通过 USB/UART 端口与应用程序进行信息通信（含 AT 命令和数据信息）。USB/UART 端口有两 种工作模式：数据模式和命令模式。 在建立 PPP 之前，端口处于命令模式，模块可在该状态下执行 AT 命令。当 PPP 协商开始时，端口将 进入数据模式，并在建立 PPP 连接时保持为数据模式；若未成功建立 PPP 连接，端口将处于命令模式。 在数据模式下，模块无法执行 AT 命令。 LTE Standard(U)系列模块均提供了在数据模式与命令模式之间切换的便捷方法。 4.1.1. 从数据模式切换到命令模式 4.1.1.1. 更改 DTR 电平切换为命令模式 当已建立 PPP 连接且 USB/UART 端口处于数据模式时，将 DTR 电平从低电平变为高电平即可从数据 模式切换至命令模式（需先执行 AT&D1）。切换成功后，模块将返回 OK。 4.1.1.2. 使用+++切换至命令模式 在 PPP 连接成功建立后使用+++，也可将 USB/UART 端口从数据模式切换至命令模式。为防止+++转 义序列被误解为数据，应遵循以下要求： 1) 输入+++前至少 1 秒内不可输入任何字符。 2) 1 秒内输入+++，在此期间不可输入任何其他字符。 3) 输入+++后 1 秒内不可输入任何字符。 当接收到+++时，USB/UART 端口将从数据模式切换到命令模式，模块将返回 OK。 上海移远通信技术股份有限公司 12 / 27 LTE Standard(U)系列 PPP 应用指导 备注 请在完成 PPP 协商后执行上述操作，否则上述操作将终止 PPP 协商并且 USB/UART 端口将退出数据模 式。完成 PPP 协商后，当 USB/UART 端口切换到命令模式时，输入的数据被当成 AT 指令，模块保持 PPP 连接状态。 4.1.2. 从命令模式切换到数据模式 4.1.2.1. 使用 ATO 切换到数据模式 当保持 PPP 连接状态时，USB/UART 端口处于命令模式，执行命令 ATO 后，即可进入数据模式。 举例 //当保持 PPP 连接状态时，USB/UART 端口处于命令模式。 ATO CONNECT //表示 TA 已进入数据模式，从 USB/UART 端口输入的所有数据将被视为 PPP 帧。 4.2. 数据模式下处理 URC 处于 PPP 连接状态下，数据模式下的来电和短信 URC 不会上报至 PPP 拨号端口，但模块的 RI 引脚 电平将从高电平变为低电平并持续 120 毫秒作为来电和短信 URC 上报的指示。MCU 可以根据 RI 引脚状态 将端口切换至命令模式以处理来电或短信。切换到命令模式后，如果仍然有来电或短信，将向 PPP 拨号端 口上报 URC。 4.3. 数据载波检测（DCD）模式 DCD 模式由 AT&C 决定。如果执行 AT&C0，DCD 引脚将不用于指示数据载波状态。而执行 AT&C1， DCD 引脚将用于指示数据载波状态。当有数据载波或开始 PPP 协商时，DCD 引脚将保持低电平状态，反 之则保持高电平状态。 备注 将模块的 USB/UART 端口从数据模式切换到命令模式（使用+++）时，DCD 状态保持不变。 上海移远通信技术股份有限公司 13 / 27 LTE Standard(U)系列 PPP 应用指导 5 终止 PPP 连接 终止 PPP 拨号连接有如下两种方式： 1. 通过 LCP Terminate-Request 消息终止 PPP 连接。推荐使用该方法终止 PPP 连接。 2. TA 也可通过更改 DTR 电平终止 PPP 连接。可先通过 AT&D2 设置 DTR 功能，将 DTR 电平从低 电平更改为高电平，数据连接将自动终止。PPP 连接完全终止后，USB/UART 端口将进入命令模 式。举例如下： //USB/UART 端口处于命令模式。 AT&D2 OK 备注 1. PPP 终止流程须在数据模式下进行操作。 2. PPP 终止流程可在 PPP 设置阶段或连接过程中随时进行。 上海移远通信技术股份有限公司 14 / 27 LTE Standard(U)系列 PPP 应用指导 6 PPP 拨号操作 本章节将分别介绍如何在 Windows 10 系统中建立 PPP 连接。有关 Linux 端的详细操作，请参考 文档 [14]。 6.1. 准备工作 在 Windows 系统中建立 PPP 拨号连接之前，必须完成以下步骤。 1. 如果(U)SIM 卡 PIN 已锁定，请将模块连接到 PC 并输入 PIN 码。 2. 确保(U)SIM 卡能够成功注册 GPRS 网络。 6.2. Windows 10 系统下的 PPP 拨号 6.2.1. 调制解调器配置 6.2.1.1. 添加新的调制解调器 如果没有安装'标准 19200 bps 调制解调器'，则需要在控制面板的调制解调器中添加新的标准调制解 调器。 上海移远通信技术股份有限公司 15 / 27 LTE Standard(U)系列 PPP 应用指导 步骤一：在主界面搜索'电话'，当出现'电话和调制解调器'时，点击进入，如下图所示。 图 4：查找电话和调制解调器 上海移远通信技术股份有限公司 16 / 27 LTE Standard(U)系列 PPP 应用指导 步骤二：双击'电话和调制解调器'选项，选择'调制解调器'→'添加(D)…'，添加新的调制解 调器，如下图所示。 图 5：添加新的调制解调器 上海移远通信技术股份有限公司 17 / 27 LTE Standard(U)系列 PPP 应用指导 步骤三：按照屏幕所示说明安装新的调制解调器：选择'标准 19200 bps 调制解调器'并选定将要安 装的端口（如'COM10'）；单击'下一步(N)'按钮，直到配置完成。有关详细信息，可参考下图。 图 6：选择调制解调器类型 上海移远通信技术股份有限公司 图 7：选择端口 18 / 27 LTE Standard(U)系列 PPP 应用指导 图 8：安装新调制解调器成功 6.2.1.2. 配置调制解调器驱动 选择已安装的'标准 19200 bps 调制解调器'，单击'属性(P)'按钮。进入界面后，选择'调制解调 器'项，将'最大端口速度(M)'修改为'115200'（默认值）。单击'高级'项，配置'额外设置'，输 入 AT+CGDCONT=1,'IP','CMNET'。如下图所示。 上海移远通信技术股份有限公司 19 / 27 LTE Standard(U)系列 PPP 应用指导 图 9：配置调制解调器驱动 备注 上述示例中，AT+CGDCONT=1,'IP','CMNET'预定义了 PDP 上下文，其中 CID 为 1，PDP 类型为 IP， APN 为 CMNET。CMNET 为网络运营商中国移动的 APN，该 APN 应替换为网络运营商定义的值。 上海移远通信技术股份有限公司 20 / 27 LTE Standard(U)系列 PPP 应用指导 6.2.2. 拨号上网网络配置 6.2.2.1. 创建新的网络连接 步骤一：打开'控制面板'并点击'网络和 Internet'，点击'网络和共享中心'，最后点击'设置 新的连接或网络'，如下图所示。 图 10：设置新的连接或网络 上海移远通信技术股份有限公司 21 / 27 LTE Standard(U)系列 PPP 应用指导 步骤二：选择'连接到 Internet'，点击'下一步(N)'；点击'设置新连接(S)'后点击'拨号(D)' 进行连接，如下图所示。 图 11：设置新连接 上海移远通信技术股份有限公司 22 / 27 LTE Standard(U)系列 PPP 应用指导 6.2.2.2. 配置连接 在'拨打电话号码(D)'中输入数字（例如*99#），并点击'连接(C)'，如下图所示。 图 12：配置连接 上海移远通信技术股份有限公司 23 / 27 LTE Standard(U)系列 PPP 应用指导 6.2.2.3. 配置拨号工具 在窗口中的'拨号(I)'中输入数字（例如*99#），单击'属性(O)'按钮，配置'标准 19200 bps 调制 解调器（COM10）'。然后在'最高速度(bps)(M)'的下拉列表中选择'115200'。单击'确定'按钮完 成配置。有关详细信息。可参考下图。 图 13：配置拨号上网工具 上海移远通信技术股份有限公司 24 / 27 LTE Standard(U)系列 PPP 应用指导 6.2.2.4. 建立拨号上网连接 配置完成后单击'拨号(D)'按钮，界面将弹出提示框'正在验证用户名和密码'，弹出框快速弹出 '已连接'时表示拨号连接。连接状态界面图如下图所示。 图 14：正在连接到拨号连接 图 15：拨号连接成功 上海移远通信技术股份有限公司 25 / 27 LTE Standard(U)系列 PPP 应用指导 7 附录 参考文档及术语缩写 表 2：参考文档 文档名称 [1] Quectel_EC200D 系列_硬件设计手册 [2] Quectel_EC200G-CN_硬件设计手册 [3] Quectel_EC600G 系列_硬件设计手册 [4] Quectel_EC800G-CN_硬件设计手册 [5] Quectel_EC200U 系列_硬件设计手册 [6] Quectel_EC600U 系列_硬件设计手册 [7] Quectel_EG500U-CN_硬件设计手册 [8] Quectel_EG700U-CN_硬件设计手册 [9] Quectel_EG700G-CN_硬件设计手册 [10] Quectel_EG800G 系列_硬件设计手册 [11] Quectel_EG912U 系列_硬件设计手册 [12] Quectel_EG915G-EU_硬件设计手册 [13] Quectel_EG915U 系列_硬件设计手册 [14] Quectel_LTE&5G_Linux_USB_Driver_User_Guide 表 3：术语缩写 缩写 APN CHAP 英文全称 中文全称 Access Point Name 接入点名称 Challenge Handshake Authentication Protocol 询问握手认证协议 上海移远通信技术股份有限公司 26 / 27 LTE Standard(U)系列 PPP 应用指导 DCD DNS DTR GPRS GSM IP IPCP LCP MCU MS PAP PC PDP PIN PPP RI TA TE UART USB (U)SIM Data Carrier Detection 数据载波检测 Domain Name Server 域名系统 Data Terminal Ready 数据终端就绪 General Packet Radio Service 通用分组无线业务 Global System of Mobile Communication 全球移动通信系统 Internet Protocol 网络协议 IP Control Protocol IP 控制协议 Link Control Protocol 链路控制协议 Micro Control Unit 微控制单元 Mobile Station 移动台 Password Authentication Protocol 密码认证协议 Personal Computer 个人电脑 Packet Data Protocol 分组数据协议 Personal Identification Number 个人识别号码 Point-to-Point Protocol 点对点协议 Ring Indicator 振铃指示器 Terminal Adapter 终端适配器 Terminal Equipment 终端设备 Universal Asynchronous Receiver Transmitter 通用异步收发传输器 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module （通用）用户识别卡 上海移远通信技术股份有限公司 27 / 27

LTE Standard(U)系列 MUX 应用指导 LTE Standard 模块系列 版本：1.4 日期：2024-04-29 状态：受控文件 LTE Standard(U)系列 MUX 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 30 LTE Standard(U)系列 MUX 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 30 LTE Standard(U)系列 MUX 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2021-04-27 Joe TU 文档创建 1.0 2021-06-09 Joe TU 受控版本 1.1 2021-08-20 Joe TU 增加适用模块 EG915U 系列。 1.2 2022-08-23 Joe TU 增 加 适 用 模 块 EC200D-CN 、 EC600G-CN 、 EC800G-CN 、 EG700G-CN 和 EG912U-GL。 1.3 2023-04-09 Joe TU 增加适用模块 EC200D 系列、EC200G-CN、EC600G 系列、 EG800G 系列。 更新适用模块： 1.4 2024-04-29 Kevin WANG ⚫ 更新 EG912U-GL 为 EG912U 系列； ⚫ 新增 EG915G-EU。 上海移远通信技术股份有限公司 3 / 30 LTE Standard(U)系列 MUX 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 1.1. 适用模块 ..................................................................................................................................... 8 2 MUX 协议概述....................................................................................................................................... 9 3 MUX AT 命令详解 ............................................................................................................................... 10 3.1. AT 命令说明.............................................................................................................................. 10 3.1.1. 定义 ............................................................................................................................... 10 3.1.2. AT 命令语句................................................................................................................... 10 3.2. AT 示例声明...............................................................................................................................11 3.3. AT+CMUX 多路复用模式........................................................................................................11 4 MUX 协议 ............................................................................................................................................ 13 4.1. 帧结构....................................................................................................................................... 13 4.1.1. 标记序列域 .................................................................................................................... 13 4.1.2. 地址域............................................................................................................................ 13 4.1.2.1. DLCI ................................................................................................................... 14 4.1.2.2. C/R ..................................................................................................................... 14 4.1.2.3. EA....................................................................................................................... 14 4.1.3. 控制域............................................................................................................................ 15 4.1.4. 长度域............................................................................................................................ 15 4.1.5. 信息域............................................................................................................................ 16 4.1.6. FCS 域........................................................................................................................... 16 4.2. 帧类型....................................................................................................................................... 16 4.2.1. SABM ............................................................................................................................ 16 4.2.2. UA.................................................................................................................................. 17 4.2.3. DM ................................................................................................................................. 17 4.2.4. DISC .............................................................................................................................. 17 4.2.5. UIH ................................................................................................................................ 17 4.3. UIH MUX 控制消息................................................................................................................... 18 4.3.1. UIH MUX 控制消息格式 ................................................................................................ 18 4.3.1.1. 类型域................................................................................................................. 18 4.3.1.2. 长度域................................................................................................................. 19 4.3.1.3. 值域 .................................................................................................................... 19 4.3.2. 关闭 MUX 通道（CLD）................................................................................................ 19 4.3.3. 测试命令（Test） .......................................................................................................... 20 4.4. UIH 数据通道............................................................................................................................ 20 4.5. 步骤 .......................................................................................................................................... 20 4.5.1. MUX 功能启用 ............................................................................................................... 20 上海移远通信技术股份有限公司 4 / 30 LTE Standard(U)系列 MUX 应用指导 4.5.2. 4.5.3. 4.5.4. 4.5.5. 建立 DLC 通道............................................................................................................... 21 传输数据 ........................................................................................................................ 22 释放 DLC ....................................................................................................................... 22 关闭 MUX ...................................................................................................................... 23 5 示例 ..................................................................................................................................................... 24 5.1. 帧结构示例 ............................................................................................................................... 24 5.2. 建立通道 ................................................................................................................................... 25 5.3. 传输数据 ................................................................................................................................... 26 5.4. 同步与失去同步 ........................................................................................................................ 26 5.5. 关闭 MUX ................................................................................................................................. 28 6 附录 参考文档及术语缩写 .................................................................................................................. 29 上海移远通信技术股份有限公司 5 / 30 LTE Standard(U)系列 MUX 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 8 表 2：AT 命令及响应类型........................................................................................................................... 10 表 3：MUX 帧结构...................................................................................................................................... 13 表 4：地址域............................................................................................................................................... 13 表 5：虚拟通道 ........................................................................................................................................... 14 表 6：C/R 位用法 ....................................................................................................................................... 14 表 7：编写控制域 ....................................................................................................................................... 15 表 8：长度域结构 ....................................................................................................................................... 15 表 9：UIH MUX 控制消息格式 ................................................................................................................... 18 表 10：UIH MUX 控制消息信息域.............................................................................................................. 18 表 11：消息格式 - 类型域 ......................................................................................................................... 18 表 12：消息格式 - 长度域 ......................................................................................................................... 19 表 13：MUX 关闭消息 - 类型域格式......................................................................................................... 19 表 14：测试命令 - 类型域格式.................................................................................................................. 20 表 15：UIH 数据帧结构 .............................................................................................................................. 20 表 16：参考文档 ......................................................................................................................................... 29 表 17：术语缩写 ......................................................................................................................................... 29 上海移远通信技术股份有限公司 6 / 30 LTE Standard(U)系列 MUX 应用指导 图片索引 图 1：MUX 架构 ........................................................................................................................................... 9 图 2：UA 帧（响应） ................................................................................................................................. 17 图 3：MUX 功能启用 .................................................................................................................................. 21 图 4：建立 DLC 通道.................................................................................................................................. 21 图 5：数据传输 ........................................................................................................................................... 22 图 6：释放 DLC .......................................................................................................................................... 22 图 7：关闭 MUX ......................................................................................................................................... 23 上海移远通信技术股份有限公司 7 / 30 LTE Standard(U)系列 MUX 应用指导 1 引言 本文介绍了 UE 和 TE 之间移远通信 MUX（多路复用）协议，并提供了如何在移远通信 LTE Standard(U) 系列模块上使用 MUX 功能的示例。 1.1. 适用模块 表 1：适用模块 模块系列 ECx00G ECx00U EGx00U EGx00G EG91xU - 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U 系列 EG915U 系列 EG915G-EU 上海移远通信技术股份有限公司 8 / 30 LTE Standard(U)系列 MUX 应用指导 2 MUX 协议概述 多路复用协议通过单个物理端口在 TE 和 UE 之间传输数据流，提供了一种数据流传输机制。移远通信 多路复用系统可以在一个物理端口上创建 4 个虚拟通道，以同时传输多个数据流，能在单个物理通信通道 之上虚拟出四个并行的逻辑通信通道，且均支持 SMS 和 PPP 拨号等。 应用程序的数据都打包在由数据和协议字段组成的不同的帧中，数据和协议字段指明了通道号、信息 长度、FCS 等。作为数据流，帧可以通过串口进行传输。到达另一方后，数据由多路复用协议栈解压为四 个数据流，并传输到应用程序。除了传输数据信息外，也能传输控制信息。 TE 和 UE 之间的每个通道，称为 DLC（数据链路连接），DLC 先后相互独立地建立起来。 TE UE 应用 应用 任务 DLC1 DLC2 DLC3 DLC4 DLC1 DLC2 DLC3 DLC4 MMUUXXD驱ri动ver DMSUMXUDXr任ive务r 物理 层 Multi DATA 图 1：MUX 架构 物理 层 上海移远通信技术股份有限公司 9 / 30 LTE Standard(U)系列 MUX 应用指导 3 MUX AT 命令详解 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 30 LTE Standard(U)系列 MUX 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT+CMUX 多路复用模式 该命令用于启用或禁用多路复用协议控制通道并设置控制通道的参数。 AT+CMUX 多路复用模式 测试命令 AT+CMUX=? 响应 +CMUX: ( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围),(支持的范围),(支持的 范围),(支持的范围) 查询命令 AT+CMUX? OK 响应 +CMUX: [,[,[,[, [,[,[,[,]]]]]]]] 设置命令 AT+CMUX=[,[,[,[,[,[,[,[,]]]]]]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若参数与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。多路复用模式。 0 基本模式 整型。定义了多路复用控制通道的建立方式。多路复用建立后可以以不同的方式建 上海移远通信技术股份有限公司 11 / 30 LTE Standard(U)系列 MUX 应用指导 立虚拟通道。没有协商虚拟通道配置的情况下，应根据控制通道来建立虚 拟通道。 0 仅使用UIH帧 整型。物理串口的传输速率（暂不支持）。 1 9600 比特/秒 2 19200 比特/秒 3 38400 比特/秒 4 57600 比特/秒 5 115200 比特/秒 6 230400 比特/秒 7 460800 比特/秒 8 912600 比特/秒 整型。最大帧长。范围：1~2048；默认值：31。 整型。确认时间，即 UE 采取其他操作之前等待确认的时间（例如传输帧）。范围： 1~255；默认值：10；单位：10 毫秒。 整型。最大重传次数。范围：0~100；默认值：3。 整型。多路复用控制通道的响应时间。范围：2~255；默认值：30；单位：10 毫秒。 值需大于。 整型。唤醒的响应时间。范围：1~255；默认值：10；单位：秒。 整型。窗口大小。定义了一个 DLC 能解析的最大的 I 帧的数目。范围 1~7；默认值： 2。（暂不支持） 错误码。详情请参考文档 [1]。 举例 AT+CMUX=? +CMUX: (0),(0),(1-8),(1-2048),(1-255),(0-100),(2-255),(1-255),(1-7) OK AT+CMUX? +CMUX: 0,0,5,31,10,3,30,10,2 OK AT+CMUX=0 OK 上海移远通信技术股份有限公司 12 / 30 LTE Standard(U)系列 MUX 应用指导 4 MUX 协议 本章节主要介绍 MUX 协议的技术详情。 4.1. 帧结构 TE 与 UE 之间传输的所有信息均以帧的形式进行传递。 表 3：MUX 帧结构 标记 1 字节 地址 1 字节 控制 1 字节 长度 1~2 字节 信息 FCS 长度不确定 1 字节 标记 1 字节 4.1.1. 标记序列域 每个帧以标记序列字节（0xF9）开始和结束。 4.1.2. 地址域 地址域由一个字节组成，包含数据链路连接标识符（DLCI），C/R 位和地址域扩展位如下表所示。 表 4：地址域 第1位 EA 第2位 C/R 第3位 第4位 第5位 第6位 DLCI 第7位 第8位 上海移远通信技术股份有限公司 13 / 30 LTE Standard(U)系列 MUX 应用指导 4.1.2.1. DLCI DLCI 定义了 TE 和 UE 之间的虚拟通道，端口分配如下： 表 5：虚拟通道 DLCI 0 1 2 3 4 虚拟通道 预留，用于控制通道 虚拟通道 1 虚拟通道 2 虚拟通道 3 虚拟通道 4 4.1.2.2. C/R C/R 字段用于指示该帧是命令帧（command）还是响应帧（response）。当 TE 发起一条命令帧时， C/R 为 1，UE 响应该帧的时候 C/R 依然为 1。当 UE 发起一条命令帧时，C/R 为 0，TE 响应该帧时 C/R 为 0。 表 6：C/R 位用法 命令/响应 命令 响应 方向 TE → UE UE → TE UE → TE TE → UE C/R 值 1 0 1 0 对于 UIH 帧来说，TE 端发送的 C/R 应当为 1，UE 端发送的 C/R 应当为 0。 4.1.2.3. EA EA 位拓展了地址域的范围。为 1 表示该字节为地址域的最后一个字节。为 0 表示后续还有一个字节。 上海移远通信技术股份有限公司 14 / 30 备注 当前仅支持 EA 为 1。 LTE Standard(U)系列 MUX 应用指导 4.1.3. 控制域 控制域定义了帧的类型。有关帧类型的详细信息，详见第 4.2 章。 表 7：编写控制域 帧类型 十六进制（P/F=0） 1 2 3 4 5 6 7 8 备注 SABM（设置异步平衡模式） 0x2F 1 1 1 1 P/F 1 0 0 UA（未编号确认） 0x63 1 1 0 0 P/F 1 1 0 DM（断连模式） 0x0F 1 1 1 1 P/F 0 0 0 DISC（断开连接） 0x43 1 1 0 0 P/F 0 1 0 UIH（未编号的带校验头的信息） 0xEF 1 1 1 1 P/F 1 1 1 UI（未编号信息） 0x03 1 1 0 0 P/F 0 0 0 可选 控制域的第五位是 P/F 位，即轮询/终止位（Poll/Final）。该位具有双重作用，只有在设置为 1 时才具 有意义。在命令帧中，该位为轮询位，设置为 1 表示向对端请求响应；在响应帧中，该位为终止位，设置 为 1 表示本帧是轮询帧请求的响应帧。 对于 UIH 帧，P/F 位应当设置为 0。 4.1.4. 长度域 表 8：长度域结构 第1位 EA 第2位 L1 第3位 L2 第4位 L3 第5位 L4 第6位 L5 第7位 L6 第8位 L7 L1 至 L7 位表示后续数据字段的长度，默认最长为 31 字节，可以使用 EA 位进行扩展。EA 位为 1 表 示该字节是长度域的最后一个字节，为 0 表示后续还有一个字节。此时长度域有 15 个有效位，即 L1 至 L15。 上海移远通信技术股份有限公司 15 / 30 LTE Standard(U)系列 MUX 应用指导 第1位 0 第2位 L1 第3位 L2 第4位 L3 第5位 L4 第6位 L5 第7位 L6 第8位 L7 第1位 L8 第2位 L9 第3位 L10 第4位 L11 第5位 L12 第6位 L13 第7位 L14 第8位 L15 备注 即使该字节后的数据为空，长度域也应该保留。 4.1.5. 信息域 信息域仅在控制域为 UIH 时有效。 4.1.6. FCS 域 FCS 域采用 CRC 校验，校验的字段包括地址、控制、长度和信息域。UIH 帧比较特殊，只校验地址、 控制和长度这三个域，也就是说不对信息域进行校验。校验算法请参考 3GPP TS 27.010 V13.0.0 的 B1-B3 获取详细信息。 4.2. 帧类型 4.2.1. SABM SABM 为命令帧，用于在 TE 和 UE 之间建立 DLC。TE 端发起该命令，UE 使用 UA 帧响应该命令。 上海移远通信技术股份有限公司 16 / 30 4.2.2. UA UA 帧为 SABM 或 DISC 帧的响应帧，如下图所示： LTE Standard(U)系列 MUX 应用指导 UE 移远通信 多路复用协议 SABM（建立 DLC 1） UA（响应） DISC（关闭 DLC 1） TE 客户端接收器 UA（响应） 图 2：UA 帧（响应） 4.2.3. DM DM 响应帧上报一方逻辑上从数据链路上断开的状态。链路断开后，将接收不到任何命令，直到收到 SABM 重新建立通道位置。如果在链路断开状态，收到 DISC 命令后，就会发送 DM 响应。 4.2.4. DISC DISC 为命令帧，用于关闭指定的 DLC 通道。当通过 DISC 命令关闭 DLCI 0 通道时，所有已经建立的 DLC 通道都会被关闭，恢复到正常的 AT 命令模式。接收一端，使用 UA 帧进行应答，作为对收到 DISC 命 令的确认。 4.2.5. UIH UIH 帧用于传输数据或者 UIH MUX 控制消息，通过地址域来进行区分。如果地址域设置为 DLCI 0， 则表示本帧用于传输 UIH 控制消息；否则则表示本帧传输数据。UIH 帧不校验信息域。 上海移远通信技术股份有限公司 17 / 30 LTE Standard(U)系列 MUX 应用指导 4.3. UIH MUX 控制消息 UIH MUX 控制消息通过 DLCI 0 通道传输，消息应当成对存在，即一个命令消息与对应的响应消息， 命令与响应根据下述类型域的 C/R 位进行判定。所有的消息遵循如下格式。 4.3.1. UIH MUX 控制消息格式 UIH MUX 控制消息格式如下： 表 9：UIH MUX 控制消息格式 标记 地址 控制 1 字节 1 字节 1 字节 长度 1/2 字节 信息 FCS 整数个字节 1 字节 标记 1 字节 表 10：UIH MUX 控制消息信息域 类型 长度 值1 值2 … 值N 表格中的每个字段最小为一个字节，类型和长度存在 EA 位，可能存在多个字节。 4.3.1.1. 类型域 类型域字节格式如下： 表 11：消息格式 - 类型域 第1位 第2位 第3位 EA C/R T1 第4位 T2 第5位 T3 第6位 T4 第7位 T5 第8位 T6 EA 位：扩展位，1 表示本字节是最后一个字节。在移远通信 MUX 系统中，仅传输一个字节，因此 EA 始终设置为 1。 C/R：表示该消息为命令或响应帧。CR 位为 1 表示命令消息，CR 位为 0 表示响应消息。 T1~T6：控制消息类型，每一个值标识一个唯一的消息类型，因此一个字节最多可以标识 63 个不同消 息。 上海移远通信技术股份有限公司 18 / 30 LTE Standard(U)系列 MUX 应用指导 备注 当一个 UIH 帧在 DLCI 0 通道时，存在两个 C/R 位。地址域中的 C/R 位的设置详见第 4.1.2 章。 4.3.1.2. 长度域 长度域字节结构如下： 表 12：消息格式 - 长度域 第1位 第2位 第3位 EA L1 L2 第4位 L3 第5位 L4 第6位 L6 EA：扩展位，1 表示本字节是最后一个字节。其他字节该位为 0。 L1~L7：定义了后续值域的长度。L1 为最低有效位（LSB）。 第7位 L6 第8位 L7 4.3.1.3. 值域 每种信息类型的值字节的内容定义详见第 4.3.2 章。 4.3.2. 关闭 MUX 通道（CLD） MUX 的 CLD 命令用于将链路重置为正常的 AT 命令模式。类型域字节： 表 13：MUX 关闭消息 - 类型域格式 第1位 第2位 第3位 第4位 EA C/R 0 0 长度域包含 0 值，且无值域。 第5位 0 第6位 0 第7位 1 第8位 1 上海移远通信技术股份有限公司 19 / 30 LTE Standard(U)系列 MUX 应用指导 4.3.3. 测试命令（Test） 测试命令用于测试 TE 和 UE 的链接。类型域字节的格式如下： 表 14：测试命令 - 类型域格式 第1位 第2位 第3位 EA C/R 0 第4位 0 第5位 0 第6位 1 第7位 0 长度字节指示后续值域的长度，值域内容任意，对端应返回相同的内容。 第8位 0 4.4. UIH 数据通道 用户数据通过 DLCI 1~DLCI 4 通道传输，帧格式如下： 表 15：UIH 数据帧结构 标记 1 字节 地址 1 字节 控制 1 字节 长度 1/2 字节 信息 FCS 整数个字节 1 字节 其中信息域用于传输用户数据，FCS 仅校验地址、控制和长度域。 F 标记 1 字节 4.5. 步骤 4.5.1. MUX 功能启用 MUX 功能的启用需要在一个实际的物理 AT 通道上向 UE 发送 AT+CMUX 来触发。如果需要切换速率， 模块主串口通道的速率需要先通过 AT+IPR 进行修改。有关 AT 命令的详细信息，详见文档 [1]。 上海移远通信技术股份有限公司 20 / 30 LTE Standard(U)系列 MUX 应用指导 TE UE AT+IPR= OK AT+CMUX=0 OK 图 3：MUX 功能启用 4.5.2. 建立 DLC 通道 当前模块支持一路控制通道（DLCI 0）及 4 路有效的 DLC 常规通道。 使用 SABM 建立 DLC 通道。当通过执行 AT+CMUX 的设置命令进入 MUX 后，首先通过发送 SABM 帧建立 MUX 控制通道（DLCI 0），UE 会通过 UA 消息响应该消息。后续同样通过发送 SABM 帧来建立其 他的 DLC 通道。 TE UE SABM(0) UA(0) SABM(1) UA(1) SABM(...) UA(...) SABM(4) UA(4) 图 4：建立 DLC 通道 上海移远通信技术股份有限公司 21 / 30 LTE Standard(U)系列 MUX 应用指导 4.5.3. 传输数据 当 DLC 连接建立后，通过 UIH 数据通道传输用户数据。 TE UE DLC1 UIH('AT') DLC1 UIH('OK') 图 5：数据传输 4.5.4. 释放 DLC 通过 DISC 命令释放指定的 DLC 通道，UE 端通过 UA 响应该命令。 TE UE DISC (1) UA(1) 图 6：释放 DLC 备注 在 DLCI 0 通道发送 DISC 命令等效于发送 CLD 命令，详见第 4.5.5 章。 上海移远通信技术股份有限公司 22 / 30 LTE Standard(U)系列 MUX 应用指导 4.5.5. 关闭 MUX 通过 CLD 命令关闭 MUX 功能，使串口恢复到正常的 AT 通道。 TE UE CLD CLD resp 图 7：关闭 MUX 上海移远通信技术股份有限公司 23 / 30 LTE Standard(U)系列 MUX 应用指导 5 示例 5.1. 帧结构示例 示例 1：打开 DLCI 0 的 SABM 帧 标记 地址域 控制域 F9 帧头 03 DLCI 0 3F SABM 帧 长度域 01 0，无信息域 FCS 1C 校验 标记 F9 帧尾 示例 2：打开 DLCI 1 的 SABM 帧 标记 地址域 控制域 F9 帧头 03 DLCI 1 3F SABM 帧 长度域 01 0，无信息域 FCS 1C 校验 标记 F9 帧尾 示例 3：UIH 帧在 DLCI 1 通道传输 AT 命令字符串 'ATI' 标记 地址域 控制域 长度域 信息域 F9 帧头 07 DLCI 1 EF 09 UIH 帧 4 41 54 49 0D AT 命令字符串 'ATI' FCS 标记 39 F9 帧尾 上海移远通信技术股份有限公司 24 / 30 5.2. 建立通道 LTE Standard(U)系列 MUX 应用指导 步骤 1：启动 MUX 序号 步骤 数据方向 TE 通过 AT 命令启 1 用 UE MUX 功能 TE → UE UE 回复消息 TE ← UE 十六进制 备注 AT+CMUX=0 41 54 2B 43 4D 55 58 3D 30 0D 0D 0A 4F 4B 0D 0A OK 步骤 2：建立 DLCI 0 通道 序号 步骤 TE 通过发送 SABM 帧请 1 求建立控制通道 DLCI 0 UE 通过 UA 回复消息 数据方向 TE → UE TE ← UE 十六进制 F9 03 3F 01 1C F9 F9 03 73 01 D7 F9 备注 SABM 帧 UA 帧 步骤 3：建立 DLCI 1~4 序号 1 2 3 步骤 数据方向 TE 通过发送 SABM 帧请求 建立 DLCI 1 TE → UE UE 通过 UA 回复消息 TE ← UE TE 通过发送 SABM 帧请求 建立 DLCI 2 TE → UE UE 通过 UA 回复消息 TE ← UE DLCI 3 和 DLCI 4 的建立方 法同上（DLCI 1 或 DLCI 2） 十六进制 F9 07 3F 01 DE F9 F9 07 73 01 15 F9 F9 0B 3F 01 59 F9 F9 0B 73 01 92 F9 备注 SABM 帧 UA 帧 SABM 帧 UA 帧 上海移远通信技术股份有限公司 25 / 30 LTE Standard(U)系列 MUX 应用指导 5.3. 传输数据 建立控制通道和数据通道后，TE 和 UE 可以通过 UIH 帧相互发送数据。 帧传输： 序号 步骤 数据方向 TE 在 DLCI 1 发送 AT 命令字符 串'ATI' TE → UE 1 UE 在 DLCI 1 上回复响应 TE ← UE TE 在 DLCI 2 发送 AT 命令字符 串'ATI' TE → UE 2 UE 在 DLCI 2 上回复响应 TE ← UE DLCI 3 和 DLCI 4 上的帧传输同 3 上（DLCI 1 或 DLCI 2） 十六进制 备注 F9 07 EF 09 41 54 49 0D 39 F9 F9 05 EF 09 41 54 49 0D 58 F9 F9 05 EF 3F 0D 0A 51 75 65 63 74 65 6C 0D 0A 45 43 32 30 30 55 0D 0A 52 65 76 69 73 69 6F 6E 3A 20 45 43 98 F9 F9 05 EF 39 32 30 30 55 43 4E 41 41 52 30 32 41 30 31 4D 30 38 5F 42 45 54 41 30 33 32 32 0D 0A 7C F9 F9 05 EF 0D 0D 0A 4F 4B 0D 0A 5F F9 F9 0B EF 07 41 54 0D 54 F9 F9 09 EF 07 41 54 0D 35 F9 F9 09 EF 0D 0D 0A 4F 4B 0D 0A D8 F9 UIH 帧 UIH 帧 UIH 帧 UIH 帧 5.4. 同步与失去同步 DLC 通道中的数据需要符合 MUX 协议格式，当通道中的数据不符合协议格式时，通道可能会失去同 步，此时再向通道发送任意数据都不会响应。当通道失去同步时，通道中会逐渐累积数据，当数据量达到 一定数量后，通道会清理堵塞数据，使通道重新畅通，之后可以正常通讯。 上海移远通信技术股份有限公司 26 / 30 同步与失去同步步骤： 序号 步骤 数据方向 TE 在 DLCI 1 通道发送 AT 命令 字符串'ATI' TE → UE 1 UE 在 DLCI 1 通道返回响应消息 TE ← UE TE 发送无序数据 2 TE → UE 之后发送任意数据 UE 均无响应， 此时所有 DLC 通道均被堵塞 TE 在 DLCI 1 通道持续发送 AT 命令字符串'ATI' TE → UE 3 当堵塞数据被清理后，可以正常 使用 TE ← UE LTE Standard(U)系列 MUX 应用指导 十六进制 备注 F9 07 EF 09 41 54 49 0D 39 F9 F9 05 EF 09 41 54 49 0D 58 F9 F9 05 EF 3F 0D 0A 51 75 65 63 74 65 6C 0D 0A 45 43 32 30 30 55 0D 0A 52 65 76 69 73 69 6F 6E 3A 20 45 43 98 F9 F9 05 EF 39 32 30 30 55 43 4E 41 41 52 30 32 41 30 31 4D 30 38 5F 42 45 54 41 30 33 32 32 0D 0A 7C F9 F9 05 EF 0D 0D 0A 4F 4B 0D 0A 5F F9 UIH 帧 UIH 帧 12 F9 12 12 12 F9 F9 F9 07 EF 09 41 54 49 0D 39 F9 F9 05 EF 09 41 54 49 0D 58 F9 F9 05 EF 3F 0D 0A 51 75 65 63 74 65 6C 0D 0A 45 43 32 30 30 55 0D 0A 52 65 76 69 73 69 6F 6E 3A 20 45 43 98 F9 F9 05 EF 39 32 30 30 55 43 4E 41 41 52 30 32 41 30 31 4D 30 38 5F 42 45 54 41 30 33 32 32 0D 0A 7C F9 F9 05 EF 0D 0D 0A 4F 4B 0D 0A 5F F9 上海移远通信技术股份有限公司 27 / 30 5.5. 关闭 MUX LTE Standard(U)系列 MUX 应用指导 关闭流程： 序号 步骤 数据方向 TE 发送 DISC 请求关闭 DLCI 1 1 UE 回复消息 TE → UE TE ← UE TE 发送 DISC 请求关闭 DLCI 2 2 UE 回复消息 TE → UE TE ← UE TE 发送 DISC 请求关闭 DLCI 3 3 UE 回复 UA 帧以接受请求 TE → UE TE ← UE TE 发送 DISC 帧以请求关闭 DLCI 4 TE → UE 4 UE 回复 UA 帧以接受请求 TE ← UE TE 发 送 CLD 消息帧以请求关 闭 DLCI 0 上的 MUX TE → UE 5 UE 回复消息 TE ← UE 十六进制 备注 F9 07 53 01 3F F9 DISC 帧 F9 07 73 01 15 F9 UA 帧 F9 0B 53 01 B8 F9 DISC 帧 F9 0B 73 01 92 F9 UA 帧 F9 0F 53 01 7A F9 DISC 帧 F9 0F 73 01 50 F9 UA 帧 F9 13 53 01 77 F9 DISC 帧 F9 13 73 01 5D F9 UA 帧 F9 03 EF 05 C3 01 F2 F9 F9 01 EF 05 C1 01 93 F9 UIH 控制消息帧 UIH 控制消息帧 上海移远通信技术股份有限公司 28 / 30 LTE Standard(U)系列 MUX 应用指导 6 附录 参考文档及术语缩写 表 16：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_AT 命令手册 表 17：术语缩写 缩写 CLD C/R CRC DCE DISC DLC DLCI DM EA FCS ME MUX P/F PPP SABM 英文全称 Multiplexer Close Down Command/Response Cyclic Redundancy Check Data Communications Equipment Disconnect Data Link Connection Data Link Connection Identifier Disconnected Mode Extended Address Frame Check Sequence Mobile Equipment Multiplexer Poll/Final Point-to-Point Protocol Set Asynchronous Balanced Mode 上海移远通信技术股份有限公司 中文全称 关闭多路复用 命令/响应 循环冗余校验 数据通信设备 断开 数据链路连接 数据链路连接标识 断开模式 扩展地址 帧校验序列 移动设备 多路复用 轮询/终止位 点到点协议 设置异步平衡模式 29 / 30 SMS TA TE UA UE UI UIH LTE Standard(U)系列 MUX 应用指导 Short Message Service 短消息业务 Terminal Adapter 终端适配器 Terminal Equipment 终端设备 Unnumbered Acknowledgement 未编号确认 User Equipment 用户设备 Unnumbered Information 未编号的信息 Unnumbered Information with Header Check 未编号的带校验头的信息 上海移远通信技术股份有限公司 30 / 30

LTE Standard(U)系列 MQTT 应用指导 LTE Standard 模块系列 版本：1.2 日期：2023-03-21 状态：受控文件 LTE Standard(U)系列 MQTT 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上 提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 33 LTE Standard(U)系列 MQTT 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 33 LTE Standard(U)系列 MQTT 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2021-04-09 Fei XUE 文档创建 1.0 2021-05-24 Fei XUE 受控版本 1.1 2021-08-20 Fei XUE 增加适用模块 EG915U 系列。 1. 新增适用模块 EC200D 系列、EC200G-CN、EC600G-CN、 EC800G-CN、EG700G-CN、EG800G 系列和 EG912U-GL。 Fei XUE/ 1.2 2023-03-21 2. 新增在 VoLTE 下的取值情况说明（第 3.3.1 章）。 Harold WANG 3. 新增 AT+QMTCFG='onenet'命令说明备注（第 3.3.1 章）。 4. 新增 Socket 主动、被动关闭命令说明备注（第 3.3.5 章）。 上海移远通信技术股份有限公司 3 / 33 LTE Standard(U)系列 MQTT 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 MQTT 数据交互..................................................................................................................................... 7 3 MQTT 相关 AT 命令.............................................................................................................................. 8 3.1. AT 命令说明 ............................................................................................................................... 8 3.1.1. 定义 ................................................................................................................................. 8 3.1.2. AT 命令语句 .................................................................................................................... 8 3.2. AT 示例声明 ............................................................................................................................... 9 3.3. MQTT 相关 AT 命令描述 ............................................................................................................ 9 3.3.1. AT+QMTCFG 配置 MQTT 可选参数............................................................................. 9 3.3.2. AT+QMTOPEN 打开 MQTT 客户端网络 .................................................................... 16 3.3.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 .................................................................. 17 3.3.4. AT+QMTCONN 连接客户端到 MQTT 服务器............................................................. 18 3.3.5. AT+QMTDISC 客户端断开与 MQTT 服务器的连接.................................................... 20 3.3.6. AT+QMTSUB 订阅主题 .............................................................................................. 20 3.3.7. AT+QMTUNS 退订主题 .............................................................................................. 22 3.3.8. AT+QMTPUBEX 发布消息 ......................................................................................... 23 3.3.9. AT+QMTRECV 读取缓存区消息................................................................................. 25 4 MQTT 相关 URC ................................................................................................................................. 26 4.1. +QMTSTAT MQTT 链路层状态变化的 URC.......................................................................... 26 4.2. +QMTRECV 当客户端接收到 MQTT 服务器发送的数据包时上报的 URC............................ 28 4.3. +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC ........................................................ 28 5 举例 ..................................................................................................................................................... 29 5.1. 无 SSL 的 MQTT 操作举例....................................................................................................... 29 5.2. 含 SSL 的 MQTT 操作举例....................................................................................................... 31 6 附录 参考文档及术语缩写 .................................................................................................................. 33 上海移远通信技术股份有限公司 4 / 33 LTE Standard(U)系列 MQTT 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 8 表 3：MQTT 相关的 URC........................................................................................................................... 26 表 4：URC 中的错误码 .............................................................................................................................. 27 表 5：参考文档 ........................................................................................................................................... 33 表 6：术语缩写 ........................................................................................................................................... 33 上海移远通信技术股份有限公司 5 / 33 LTE Standard(U)系列 MQTT 应用指导 1 引言 移远通信 LTE Standard(U)系列模块支持 MQTT 功能。MQTT 是基于代理的发布/订阅模式通讯协议， 具有开放、简单、轻量和易于实现等特点。MQTT 最大优点在于，可以以极少的代码和有限的网络带宽， 为远程设备连接提供实时可靠的消息服务。 本文档主要介绍如何通过 AT 命令应用如下移远通信模块的 MQTT 功能。 1.1. 适用模块 表 1：适用模块 模块系列 EC200D ECx00G ECx00U EGx00U EGx00G EG91xU 模块 EC200D-CN EC200D-EU EC200G-CN EC600G-CN EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U-GL EG915U 系列 上海移远通信技术股份有限公司 6 / 33 LTE Standard(U)系列 MQTT 应用指导 2 MQTT 数据交互 本章节主要介绍 MQTT 功能的数据交互机制。 MCU 模块 链路层 MQTT服务器 接收URC格式的 PUBLISH消息 AT+QMTCFG= will ,, AT+QMTCFG= timeout ,, AT+QMTOPEN=, , OK +QMTOPEN: , AT+QMTCONN AT+QMTCONN=,, OK +QMTCONN: ,[,] TCP-REQ TCP established CONN-REQ Start timer T1, T2 CONN ACK-IND Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK 发送链接数据包 服务器收到连接数据包并返回ACK AT+QMT SUB AT+QMTSUB=,... OK +QMTSUB:,,[,] SUB-REQ (msgId) Start timer T1 SUB ACK-IND (msgId) Stop T1 or handle Excep2 发送订阅数据包 服务器收到订阅数据包并返回ACK AT+QMT UN S AT+QMTUNS=,... OK UNS-REQ (msgId) Start timer T1 +QMTUNS: ,,[,] AT+QMTPUBEX=,,=0, ,, OK UNS ACK-IND (msgId) Stop T1 or handle Excep2 PUB-REQ AT+QMTPUBEX AT+QMTPUBEX=,,=1, (=1) ,, OK PUB-REQ (msgId) Start timer T1 +QMTPUBEX: ,,[,] PUB ACK-IND (msgId) Stop T1 or handle Excep2 发送退订数据包 服务器收到退订数据包并返回ACK 发送发布数据包 发送发布数据包 服务器收到发送数据包并返回ACK AT+QMTPUBEX AT+QMTPUBEX=,,=2, (=2) ,, OK PUB-REQ (msgId) Start timer T1 PUB REC-IND (msgId) Stop T1 or handle Excep2 PUB REL-REQ (msgId) Start timer T1 +QMTPUBEX: ,,[,] PUB COMP-IND (msgId) Stop T1 or handle Excep2 发送发布数据包 服务器收到发布数据包 发送释放发布数据包 服务器收到释放发布数据包 T1是数据包重传超 时时间 T2是保活定时器 在T2时间段内若没 有数据相关消息， 客户端将发送 PINGREQ数据包 Excep1： 断开TCP连接 Excep2： 重发数据包直到 达到允许上限。 可通过命令 AT+QMTCFG设 置重传次数。 通过命令 AT+QMTCFG配置是 否上报超时信息 Receive +QMTRECV: ,,, PUB-IND (msgId) PUB ACK/REC-REQ (msgId) Reply accor.d.i.ng to AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , DISC-REQ TCP-REQ TCP disconnected 服务器收到发送数据包 发送发布答复数据包 发送断开连接数据包 TCP断开..连. 接请求 注意： 指的是可选参数。更多关于 可选参数的详细信息，请参考第3.3章 AT命令对应的描述。 图 1：MQTT 数据交互机制 上海移远通信技术股份有限公司 7 / 33 LTE Standard(U)系列 MQTT 应用指导 3 MQTT 相关 AT 命令 本章节主要介绍操作 MQTT 功能的相关 AT 命令。 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为的响应。在本文档中表现命令和响应的表格中，省略了，仅显 示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 33 LTE Standard(U)系列 MQTT 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. MQTT 相关 AT 命令描述 3.3.1. AT+QMTCFG 配置 MQTT 可选参数 该命令用于配置 MQTT 的参数。 AT+QMTCFG 配置 MQTT 可选参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'version',( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'pdpcid',( 支 持 的 范 围 ),( 支 持 的 范围) +QMTCFG: 'ssl',( 支 持 的 范 围 ),( 支 持 的 列表),(支持的范围) +QMTCFG: 'keepalive',(支持的范围),(支持的 范围) +QMTCFG: 'session',( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'timeout',( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'will',( 支 持 的 范 围 ),( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 列表),'willtopic','willmessage' +QMTCFG: 'willex',( 支 持 的 范 围 ),( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 列表),'willtopic',(支持的范围) +QMTCFG: 'recv/mode',(支持的范围),(支持的 列表),(支持的列表) +QMTCFG: 'qmtping',( 支 持 的 范 围 ),( 支 持 的 范围) +QMTCFG: 'send/mode',(支持的范围),(支持的 列表) +QMTCFG: 'aliauth',( 支 持 的 范 围 ),'product key','device name','device secret' 上海移远通信技术股份有限公司 9 / 33 LTE Standard(U)系列 MQTT 应用指导 设置命令 配置 MQTT 协议版本 AT+QMTCFG='version', [,] +QMTCFG: 'onenet',( 支 持 的 范 围 ),'product id','access key' +QMTCFG: 'dataformat',(支持的范围),(支持的 列表),(支持的列表) +QMTCFG: 'view/mode',(支持的范围),(支持的 列表) +QMTCFG: 'edit/timeout',(支持的范围),(支持 的列表),(支持的范围) OK 响应 若省略可选参数，则查询当前 MQTT 协议版本： +QMTCFG: 'version', OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 协议版本： OK 设置命令 配置 MQTT 客户端待使用的 PDP AT+QMTCFG='pdpcid',[ ,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 MQTT 客户端使用的 PDP： +QMTCFG: 'pdpcid', OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 客户端待使 用的 PDP： OK 设置命令 配置 MQTT SSL 模式和 SSL 上下文索引 AT+QMTCFG='ssl',[,[,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 MQTT SSL 模式以及 SSL 上下 文索引配置情况： +QMTCFG: 'ssl',[,] OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT SSL 模式和 SSL 上下文索引： OK 若出现任何错误： 上海移远通信技术股份有限公司 10 / 33 LTE Standard(U)系列 MQTT 应用指导 ERROR 设置命令 配置保活时间 AT+QMTCFG='keepalive',[,] 响应 若省略可选参数，则查询当前保活时间： +QMTCFG: 'keepalive', OK 若指定可选参数且 MQTT 连接未创建，配置保活时间： OK 设置命令 配置会话类型 AT+QMTCFG='session', [,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前会话类型： +QMTCFG: 'session', OK 若指定可选参数且 MQTT 连接未创建，配置会话类型： OK 若出现任何错误： ERROR 设置命令 配置消息传输超时时间 响应 若省略可选参数，则查询当前设置的消息传输超时时间： AT+QMTCFG='timeout', +QMTCFG: 'timeout',,,<time [,,, out_notice>] OK 若指定可选参数且 MQTT 连接未创建，配置消息传输超时时间： OK 设置命令 配置 Will 信息 AT+QMTCFG='will',[,[,,,,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 Will 配置信息： +QMTCFG: 'will',[,,,,] OK 若指定可选参数且 MQTT 连接未创建，配置 Will 信息： 上海移远通信技术股份有限公司 11 / 33 LTE Standard(U)系列 MQTT 应用指导 OK 设置命令 配置 Will 信息 AT+QMTCFG='willex',[, [,,,< willtopic>,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 Will 配置信息： +QMTCFG: 'willex',[,,,< willtopic>,] OK 若指定可选参数，配置 Will 信息： > 输入 Will 消息；若数据长度大于，则超出 长度的数据将会被舍弃。 OK 设置命令 配置服务器数据的接收模式 AT+QMTCFG='recv/mode',[,[,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 MQTT 数据接收模式： +QMTCFG: 'recv/mode',, OK 若指定可选参数且 MQTT 连接未创建，配置服务器数据的接收 模式： OK 设置命令 配置 MQTT 心跳间隔 AT+QMTCFG='qmtping',[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 MQTT 的心跳间隔： +QMTCFG: 'qmtping', 若指定可选参数且 MQTT 连接未创建，配置 MQTT 心跳间隔： OK 设置命令 配置 MQTT 消息的发送格式 AT+QMTCFG='send/mode',<client_i 若出现任何错误： ERROR 响应 若省略可选参数，则查询 MQTT 消息的发送格式： +QMTCFG: 'send/mode', 上海移远通信技术股份有限公司 12 / 33 LTE Standard(U)系列 MQTT 应用指导 dx>[,] OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 消息的发送 格式： OK 若出现任何错误： ERROR 设置命令 配置阿里云设备信息 响应 若省略可选参数，则查询当前阿里云设备信息： AT+QMTCFG='aliauth', +QMTCFG: 'aliauth',,,<de [,,, vice secret>] OK 若指定可选参数且 MQTT 连接未创建，配置阿里云设备信息： OK 设置命令 配置中国移动 OneNET 平台的设备信息 AT+QMTCFG='onenet',[ ,,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前中国移动 OneNET 平台的设备信 息： +QMTCFG: 'onenet',, OK 若指定可选参数且 MQTT 连接未创建，配置中国移动 OneNET 平台的设备信息： OK 设置命令 配置 MQTT 数据格式 AT+QMTCFG='dataformat',[,,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 MQTT 数据格式： +QMTCFG: 'dataformat',, OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 数据格式： OK 若出现任何错误： 上海移远通信技术股份有限公司 13 / 33 LTE Standard(U)系列 MQTT 应用指导 ERROR 设置命令 配置透传模式下 MQTT 数据的回显模式 AT+QMTCFG='view/mode',[,] 响应 若省略可选参数，则查询当前透传模式下 MQTT 数据的回显模 式： +QMTCFG: 'view/mode', OK 若指定可选参数且 MQTT 连接未创建，配置透传模式下 MQTT 数据的回显模式： OK 设置命令 配置消息编辑超时时间 AT+QMTCFG='edit/timeout',[,,[]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前消息编辑超时时间： +QMTCFG: 'edit/timeout',[,] OK 若指定可选参数且 MQTT 连接未创建，配置消息编辑超时时间： OK 最大响应时间 特性说明 若出现任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。MQTT 协议版本。 3 MQTT 协议 V3.1 4 MQTT 协议 V3.1.1 整型。MQTT 客户端待使用 PDP。参数范围为 1~7， 若同时支持 VoLTE， 则参数范围为 1~5；默认值：1。 整型。配置 Will Flag。 0 无需配置 Will Flag 1 需要配置 Will Flag 整型。发送消息时的 QoS 级别。 上海移远通信技术股份有限公司 14 / 33 LTE Standard(U)系列 MQTT 应用指导 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。Will Retain 标记只适用于 PUBLISH 消息。 0 当客户端发布一条 PUBLISH 消息到服务器，消息成功发送到当前订阅 者后，服务器不保留该消息 1 当客户端发布一条 PUBLISH 消息到服务器，消息成功发送到当前订阅 者后，服务器保留该消息 字符串类型。Will Topic 名称。长度范围：1~256 字节。 字符串类型。当客户端意外断开后，该参数定义需要发布到 Will Topic 的消 息内容。 整型。 0 表示清空 1~256 表示 Will 消息的长度；单位：字节。 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。 整型。数据包传输超时后重发次数。范围：0~10；默认值：3。 整型。传输数据包时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器必须存储该客户端的订阅消息（仅当服务 器支持存储会话信息操作时有效） 1 服务器必须删除之前保留的客户端任何消息，此连接状态为'Clean' 整型。 0 表示不断开客户端连接 1~3600 保活时间；默认值：120；单位：秒。该参数定义从客户端接收消 息的最大间隔时间，若在 1.5 倍的时间内，服务器未从 客户端收到消息，则默认客户端发送了 DISCONNECT 消息，因此服务器 会断开客户端连接。 整型。配置 MQTT SSL 模式。 0 使用普通 TCP 连接 1 使用 SSL TCP 安全连接 整型。SSL 上下文索引。范围：0~5。 整型。配置 MQTT 消息接收模式。 0 从服务器接收的 MQTT 消息以 URC 的形式上报 1 从服务器接收的 MQTT 消息不以 URC 的形式上报 整型。配置 URC 中是否包含从服务器接收的 MQTT 消息长度。 0 不包含 1 包含 字符串类型。阿里云发布的产品密钥。 字符串类型。阿里云发布的设备名称。 字符串类型。阿里云发布的设备校验凭证。 整型。心跳间隔时间。范围：5~60；默认值：5；单位：秒。 上海移远通信技术股份有限公司 15 / 33 LTE Standard(U)系列 MQTT 应用指导 整型。MQTT 消息发送格式。 0 字符串 1 十六进制 字符串类型。中国移动 OneNET 平台产品概况页面中的产品 ID。 字符串类型。中国移动 OneNET 平台设备详情里的 Key。 整型。MQTT 消息接收格式。 0 字符串 1 十六进制 整型。透传模式下是否启用 MQTT 数据的回显模式。 0 关闭 1 开启 整型。发布消息时，编辑消息超时是否自动退出编辑模式。 0 禁用 1 使能 整型。发布消息时，编辑消息的超时时间。范围：1~180；单位：秒。进入 编辑模式时，未输入或者输入的数据长度未达到设定值，超过 后会自动退出编辑模式，并上报 ERROR。 备注 1. 若 =1 ， 那 么 必 须 指 定 、 、 和 ， 若 不为 1，以上参数会被省略。 2. 若 MQTT 连接配置为 SSL 模式，则必须指定。另外，客户需要使用 AT+QSSLCFG 配置 SSL 版本、加密套件、安全等级、CA 证书、客户端证书和客户端密钥，并忽略 RTC 时间，这 些在 MQTT SSL 握手过程中都会使用到。详细信息请参考文档 [1]。 3. 请确保数据在传输过程中不能超出最大响应时间。 4. AT+QMTCFG='aliauth'只用于阿里云，若已经配置，则可以省略 AT+QMTCONN 中的 和。 5. AT+QMTCFG='onenet' 只 用 于 OneNET 平 台 ， 如 OneNET 设 备 信 息 已 配 置 ， 则 可 以 省 略 AT+QMTCONN 中的和。 3.3.2. AT+QMTOPEN 打开 MQTT 客户端网络 该命令用于为 MQTT 客户端打开网络。 AT+QMTOPEN 打开 MQTT 客户端网络 测试命令 AT+QMTOPEN=? 响应 +QMTOPEN: (支持的范围),'hostname',(支持 的范围) 查询命令 OK 响应 上海移远通信技术股份有限公司 16 / 33 LTE Standard(U)系列 MQTT 应用指导 AT+QMTOPEN? [+QMTOPEN: ,,] OK 设置命令 AT+QMTOPEN=,, 若出现任何错误： ERROR 响应 OK +QMTOPEN: , 最大响应时间 特性说明 若出现任何错误： ERROR 120 秒，受网络状态影响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 字符串类型。服务器地址，可以是 IP 地址或者域名。最大长度：100 字节。 整型。服务器端口。范围：1~65535。 整型。命令执行结果。 -1 打开网络失败 0 打开网络成功 1 参数错误 2 MQTT 标识符被占用 3 激活 PDP 失败 4 域名解析失败 5 网络断开导致错误 3.3.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 该命令用于关闭 MQTT 客户端网络。 AT+QMTCLOSE 关闭 MQTT 客户端网络 测试命令 AT+QMTCLOSE=? 响应 +QMTCLOSE: (支持的范围) 设置命令 AT+QMTCLOSE= OK 响应 OK 上海移远通信技术股份有限公司 17 / 33 LTE Standard(U)系列 MQTT 应用指导 最大响应时间 特性说明 +QMTCLOSE: , 若出现任何错误： ERROR 30 秒 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。命令执行结果。 -1 关闭网络失败 0 关闭网络成功 3.3.4. AT+QMTCONN 连接客户端到 MQTT 服务器 客户端请求连接 MQTT 服务器时使用该命令。当客户端创建和服务器之间的 TCP/IP Socket 连接时， 必须使用 CONNECT 流创建一个协议层会话。 AT+QMTCONN 连接客户端到 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: (支持的范围),'clientid','userna me','password' 查询命令 AT+QMTCONN? OK 响应 [+QMTCONN: ,] OK 设置命令 AT+QMTCONN=,[,,] 若出现任何错误： ERROR 响应 OK +QMTCONN: ,[,] 若出现任何错误： ERROR 上海移远通信技术股份有限公司 18 / 33 LTE Standard(U)系列 MQTT 应用指导 最大响应时间 特性说明 值（默认 5 秒），受网络状态影响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 字符串类型。客户端标识符。 字符串类型。客户端用户名，可用于授权。 字符串类型。客户端用户名对应的密码，可用于授权。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 初始化 2 MQTT 正在连接 3 MQTT 已经连接成功 4 MQTT 正在断开连接 整型。连接状态返回码。 0 接受连接 1 拒绝连接：不接受的协议版本 2 拒绝连接：标识符被拒绝 3 拒绝连接：服务器不可用 4 拒绝连接：错误的用户名或密码 5 拒绝连接：未授权 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT +QMTCFG='timeout',[,,,]配置超时时间。 备注 若某一个客户端 ID 已经连接服务器端，另一个客户端使用相同 ID 重新连接，服务器必须断开原来的客户 端连接，而后才能进行新客户端的 CONNECT 流。 上海移远通信技术股份有限公司 19 / 33 LTE Standard(U)系列 MQTT 应用指导 3.3.5. AT+QMTDISC 客户端断开与 MQTT 服务器的连接 当客户端请求断开与 MQTT 服务器的连接时使用该命令。客户端发送 DISCONNECT 消息到服务器表 示即将与服务器断开 TCP/IP 连接。 AT+QMTDISC 客户端断开与 MQTT 服务器的连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的范围) 设置命令 AT+QMTDISC= OK 响应 OK +QMTDISC: , 最大响应时间 特性说明 若出现任何错误： ERROR 30 秒 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。命令执行结果。 -1 断开连接失败 0 断开连接成功 备注 发送 AT+QMTDISC 会关闭 Socket。若服务器不响应，则执行 QMTCLOSE，主动关闭 Socket。 3.3.6. AT+QMTSUB 订阅主题 该命令用于订阅一个或多个主题。客户端发送 SUBSCRIBE 消息向服务器订阅一个或多个主题，当订 阅主题发布消息时，服务器会把这些消息作为 PUBLISH 消息传输到客户端。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: (支持的范围),,'topic',(支持 的列表)[,'topic',(支持的列表)…] 上海移远通信技术股份有限公司 20 / 33 LTE Standard(U)系列 MQTT 应用指导 设置命令 AT+QMTSUB=, ,,[,, …] OK 响应 OK +QMTSUB: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR ×（默认 15 秒），受网络状态影 响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包标识符。范围：0~65535。 字符串类型。客户端订阅或者退订的主题。 整型。客户端发布消息的 QoS 等级。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK（当=0 时发布了数据，则无需 ACK） 1 数据包重传 2 数据包发送失败 整型。 若=0，则作为已确认 QoS 等级的矢量； 若=1，则表示数据包重传次数； 若=2，则不显示。 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTC FG='timeout',[,,,]配置 超时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 备注 只有在固定报头中的 QoS 位显示 QoS 等级是 1 或者 2 的消息中才会有消息标识符，在特定通信方向中 的一组飞行消息中必须唯一。一般来说该参数值根据消息数逐一增加，但实际情况无此要求。 上海移远通信技术股份有限公司 21 / 33 LTE Standard(U)系列 MQTT 应用指导 3.3.7. AT+QMTUNS 退订主题 该命令用于退订一个或者多个主题。客户端向服务器发送 UNSUBSCRIBE 消息退订确定的主题。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: ( 支 持 的 范 围),,'topic'[,'topic'…] 设置命令 AT+QMTUNS=, ,[,…] OK 响应 OK +QMTUNS: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR ×（默认 15 秒），受网络状态影 响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包标识符。范围：0~65535。 字符串类型。客户端想要订阅或者退订的主题。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。 若=0，则作为已确认 QoS 等级的矢量； 若=1，则表示数据包重传次数； 若=2，则不显示。 数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTCFG='ti meout',[,,,]配置超时时 间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 上海移远通信技术股份有限公司 22 / 33 LTE Standard(U)系列 MQTT 应用指导 3.3.8. AT+QMTPUBEX 发布消息 客户端通过该命令可以发布定长消息到服务器，再由服务器分配到感兴趣的订阅者。每一个 PUBLISH 消息都关联一个主题名称，若一个客户端订阅了一个或者多个主题，当订阅主题发布消息时，服务器会把 这些消息作为 PUBLISH 消息传输到客户端。 AT+QMTPUBEX 发布消息 测试命令 AT+QMTPUBEX=? 响应 +QMTPUBEX: (支持的范围),,(支持的 范围),(支持的列表),'topic','length' 设置命令 AT+QMTPUBEX=,,,,, OK 响应 > 响应>后，输入需要发送的数据，若数据实际长度大于， 多出的字节会被删除 OK +QMTPUBEX: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR × （默认 15 秒），受网络状态 影响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包消息标识符。范围：0~65535。只有当=0 时，该参数值为 0。 整型。客户端想要发布消息时的 QoS 等级。 0 最多发送一次 1 最少发送一次 2 只发送一次 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 不保存 1 保存 字符串类型。待发布主题。 整型。待发布消息数据长度。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK（当=0 时发布了数据，则无需 ACK） 1 数据包重传 上海移远通信技术股份有限公司 23 / 33 LTE Standard(U)系列 MQTT 应用指导 2 数据包发送失败 整型。 若=1，则表示数据包重传次数； 若=0 或者 2，则不显示此参数。 整型。数据传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTCFG ='timeout',[,,,]配置超 时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 备注 1. 若该命令执行成功并响应 OK，客户端可以继续发布新的数据包。传输数据包的最大数量不能大于滑 动窗口的大小（滑动窗口的大小为 5），否则会返回 ERROR。 2. 该命令执行后，客户端可发送数据即负载信息。每次输入数据的最大长度为 1500 字节。 3. 发布者可以发布 PUBLISH 消息到服务器，服务器也可以发布 PUBLISH 消息到订阅者。当服务器发 布消息到订阅者时，会返回 URC 通知客户端主机读取 MQTT 服务器发送的数据：+QMTRECV: ,,[,],，关于 URC 描述的详细信息，请 参考第 4.2 章。 上海移远通信技术股份有限公司 24 / 33 LTE Standard(U)系列 MQTT 应用指导 3.3.9. AT+QMTRECV 读取缓存区消息 该命令用于从存储缓存中读取消息，服务器上报消息时都会存储到这个缓存中。 AT+QMTRECV 读取缓存区消息 测试命令 AT+QMTRECV=? 查询命令 AT+QMTRECV? 响应 OK 响应 +QMTRECV: ,,, ,, OK 设置命令 AT+QMTRECV=[,] 若无 MQTT 连接： OK 响应 [+QMTRECV: ,,[,], […]] OK 最大响应时间 特性说明 若无 MQTT 连接： ERROR / / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。表示缓存中是否存有消息，缓存中最多可存储 5 条信息，因此最多同时上报 5 条 URC。 0 缓存中没有数据 1 缓存中有数据 整型。表示每条接收数据的序号。范围：0~4。 整型。数据包消息标识符。范围：0~65535，只有当=0 时，此参数可为 0。 字符串类型。缓存区消息主题。 整型。负载信息的长度。 字符串类型。主题名相关的负载信息。 上海移远通信技术股份有限公司 25 / 33 LTE Standard(U)系列 MQTT 应用指导 4 MQTT 相关 URC 本章节主要描述 MQTT 相关的 URC。 表 3：MQTT 相关的 URC 序号 URC 格式 描述 [1] +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 连接并上报 URC。 +QMTRECV: ,,[,], 包。 [3] +QMTRECV: , 当从 MQTT 服务器接收的消息存储到缓存 时上报 URC。 [4] +QMTPING: , 当 MQTT 链层状态变化时，客户端会关闭 MQTT 连接并上报此 URC。 4.1. +QMTSTAT MQTT 链路层状态变化的 URC 此 URC 以+QMTSTAT:开头，当 MQTT 链路层状态发生变化就会上报该 URC。 +QMTSTAT MQTT 链路层状态变化的 URC +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 连接并上报 URC。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。错误代码。详细信息请参考下表。 上海移远通信技术股份有限公司 26 / 33 LTE Standard(U)系列 MQTT 应用指导 表 4：URC 中的错误码 描述 解决方法 1 连接被服务器断开或者重置 执行 AT+QMTOPEN 重建 MQTT 连接 2 发送 PINGREQ 包超时或者失败 首先反激活 PDP，然后再激活 PDP 并重建 MQTT 连接。 3 发送 CONNECT 包超时或者失败 1. 查看输入的用户名和密码是否正确。 2. 确保客户端 ID 未被占用。 3. 重 建 MQTT 连接 ， 并 尝试 再 次 发 送 CONNECT 包到服务器。 1. 查看输入的用户名和密码是否正确。 4 接收 CONNACK 包超时或者失败 2. 确保客户端 ID 未被占用。 3. 重 建 MQTT 连接 ， 并 尝试 再 次 发 送 CONNECT 包到服务器。 5 客户端向服务器发送 DISCONNECT 包，但 正常流程。 是服务器主动断开 MQTT 连接 因为发送数据包总是失败，客户端主动断开 1. 确保数据正确。 6 MQTT 连接 2. 可能因为网络拥堵或者其他错误，尝试 重建 MQTT 连接。 7 链路不工作或者服务器不可用 确保当前链路或者服务器可用。 8 客户端主动断开 MQTT 连接 尝试重建连接。 9~255 预留 上海移远通信技术股份有限公司 27 / 33 LTE Standard(U)系列 MQTT 应用指导 4.2. +QMTRECV 当客户端接收到 MQTT 服务器发送的数据包时上报的 URC 此 URC 以+QMTRECV:开头，主要为当客户端接收到 MQTT 服务器发送的数据包时上报的 URC。 +QMTRECV 当客户端接收到 MQTT 服务器发送的数据包时上报的 URC +QMTRECV: ,,[,], +QMTRECV: , 通知 Host 读取 MQTT 服务器发送的数据包。 当从 MQTT 服务器接收的消息存储到缓存时上报 URC。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包的消息标识符。范围：0~65535。 字符串类型。从 MQTT 服务器接收的主题。 整型。负载信息的长度。 字符串类型。主题名称相关的负载。 整型。表示每条接收数据的序号。范围：0~4。 4.3. +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC 此 URC 以+QMTPING:开头，若服务器未在 1.5 倍保活时间内接收到客户端的消息，则相当于客户端 发送了 DISCONNECT 消息，服务器会断开与客户端的连接，此时会上报该 URC。 +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC +QMTPING: , 当 MQTT 链层状态变化时，客户端会关闭 MQTT 连接并上报 此 URC。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。Ping 状态的结果。 1 失败 上海移远通信技术股份有限公司 28 / 33 LTE Standard(U)系列 MQTT 应用指导 5 举例 本章节主要提供举例用于解释如何使用 MQTT 相关命令。 5.1. 无 SSL 的 MQTT 操作举例 //配置接收模式 AT+QMTCFG='recv/mode',0,0,1 OK //配置阿里云设备信息 AT+QMTCFG='aliauth',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAazZ' OK AT+QMTOPEN=? +QMTOPEN: (0-5),'hostname',(1-65535) OK //MQTT 客户端打开网络 AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK +QMTOPEN: 0,0 AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 //MQTT 客户端成功打开网络 OK AT+QMTCONN=? +QMTCONN: (0-5),'clientid','username','password' OK //客户端连接 MQTT 服务器 //若已连接阿里云，可使用命令 AT+QMTCFG='aliauth'提前配置设备信息，之后可省略和 。 AT+QMTCONN=0,'clientExample' OK +QMTCONN: 0,0,0 AT+QMTSUB=? //客户端成功连接到 MQTT 服务器 上海移远通信技术股份有限公司 29 / 33 LTE Standard(U)系列 MQTT 应用指导 +QMTSUB: (0-5),, list of ['topic',qos] OK //订阅主题 AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //如果客户端订阅'topic/example'，而其他设备将同一主题发布到服务器，模块会上报如下信息： +QMTRECV: 0,0, 'topic/example',36,'This is the payload related to topic' //退订主题 AT+QMTUNS=0,2,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUBEX=? +QMTPUBEX: (0-5),,(0-2),(0,1),'topic','length' OK //响应>后，输入并发送 This is test data, hello MQTT.，数据最大长度是 1500 字节，多出的部分会被忽略。 AT+QMTPUBEX=0,0,0,0,'topic/pub',30 >This is test data, hello MQTT. OK +QMTPUBEX: 0,0,0 //若客户端订阅了名为'topic/pub'的主题，且其他设备向服务器发布了相同主题，模块会上报如下信息： +QMTRECV: 0,0,'topic/pub',30,This is test data, hello MQTT. //断开客户端在 MQTT 服务器的连接 AT+QMTDISC=0 OK +QMTDISC: 0,0 //连接断开成功 上海移远通信技术股份有限公司 30 / 33 LTE Standard(U)系列 MQTT 应用指导 5.2. 含 SSL 的 MQTT 操作举例 //配置接收模式 AT+QMTCFG='recv/mode',0,0,1 OK //配置 MQTT 会话为 SSL 模式 AT+QMTCFG='SSL',0,1,2 OK //若 SSL 授权方式为 server authentication，则存储 CA 证书到 UFS。 AT+QFUPL='UFS:cacert.pem',1758,100 //AT+QFUPL 命令请参考文档 [1]。 CONNECT +QFUPL: 1758,384a OK //若 SSL 授权方式为 server authentication，则存储 CC 证书到 UFS。 AT+QFUPL='UFS:client.pem',1220,100 CONNECT +QFUPL: 1220,2d53 OK //若 SSL 授权方式为 server authentication，则存储 CK 证书到 UFS。 AT+QFUPL='UFS:user_key.pem',1679,100 CONNECT +QFUPL: 1679,335f OK //配置 CA 证书 AT+QSSLCFG='cacert',2,'UFS:cacert.pem' OK //配置 CC 证书 AT+QSSLCFG='clientcert',2,'UFS:client.pem' OK //配置 CK 证书 AT+QSSLCFG='clientkey',2,'UFS:user_key.pem' OK //配置 SSL 参数 AT+QSSLCFG='seclevel',2,2 OK AT+QSSLCFG='sslversion',2,4 //SSL 授权方式：server authentication //SSL 授权版本 上海移远通信技术股份有限公司 31 / 33 LTE Standard(U)系列 MQTT 应用指导 OK AT+QSSLCFG='ciphersuite',2,0xFFFF //加密套件 OK AT+QSSLCFG='ignorelocaltime',2,1 //忽略授权时间 OK //开始 MQTT SSL 连接 AT+QMTOPEN=0,'a1zgnxur10j8ux.iot.us-east-1.amazonaws.com',8883 OK +QMTOPEN: 0,0 //连接 MQTT 服务器 AT+QMTCONN=0,'M26_0206' OK +QMTCONN: 0,0,0 //订阅主题 AT+QMTSUB=0,1,'$aws/things/M26_0206/shadow/update/accepted',1 OK +QMTSUB: 0,1,0,1 //发布消息 AT+QMTPUBEX=0,1,1,0,'$aws/things/M26_0206/shadow/update/accepted',32 >This is publish data from client OK +QMTPUBEX: 0,1,0 //若客户端订阅了名为'$aws/things/M26_0206/shadow/update/accepted'的主题，且其他设备发布了相同 主题的消息到服务器，模块会上报如下信息： +QMTRECV: 0,1,'$aws/things/M26_0206/shadow/update/accepted',32,'This is publish data from client' //客户端断开 MQTT 服务器 AT+QMTDISC=0 OK +QMTDISC: 0,0 上海移远通信技术股份有限公司 32 / 33 LTE Standard(U)系列 MQTT 应用指导 6 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_SSL_应用指导 表 6：术语缩写 缩写 ACK CA MQTT PDP QoS RTC SSL TCP UFS URC 英文全称 Acknowledgement Certificate Authority Message Queuing Telemetry Transport Packet Data Protocol Quality of Service Real-Time Clock Secure Sockets Layer Transmission Control Protocol User File System Unsolicited Result Code 中文全称 确认消息 证书授权中心 消息队列遥测传输 分组数据协议 服务质量 实时时钟 安全套接层 传输控制协议 用户文件系统 非请求结果码 上海移远通信技术股份有限公司 33 / 33

LTE Standard(U)系列 HTTP(S)应用指导 LTE Standard 模块系列 版本：1.4 日期：2024-04-29 状态：受控文件 LTE Standard(U)系列 HTTP(S)应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 47 LTE Standard(U)系列 HTTP(S)应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 47 LTE Standard(U)系列 HTTP(S)应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 1.4 日期 2021-04-28 2020-05-06 2021-08-20 2023-03-07 2023-09-11 2024-04-29 作者 变更表述 Herry GENG 文档创建 Herry GENG 受控版本 Herry GENG Larson LI Lambert ZHAO Kevin WANG 增加适用模块 EG915U 系列。 1. 新 增 适 用 模 块 EC200D 系 列 、 EC200G-CN 、 EC600G-CN 、 EC800G-CN 、 EG700G-CN 和 EG912U-GL。 2. 新增 AT+QHTTPCFG 中参数针对不同模 块的取值情况说明； 更新 AT+QHTTPCFG 中参数的取值范 围（第 2.3.1 章）。 3. 更新 AT+QHTTPURL 中参数的取值范 围（第 2.3.2 章）。 4. 更新 AT+QHTTPGET 中参数的取值范 围（第 2.3.3 章）。 1. 更新适用模块： ⚫ 新增 EG800G 系列； ⚫ 更新 EC600G-CN 为 EC600G 系列。 2. 更新+QHTTPCFG: 'form/data'参数（第 2.3.1 章）。 更新适用模块： ⚫ 更新 EG912U-GL 为 EG912U 系列； ⚫ 新增 EG915G-EU。 上海移远通信技术股份有限公司 3 / 47 LTE Standard(U)系列 HTTP(S)应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块.......................................................................................................................................... 7 1.2. HTTP(S)命令使用流程 .................................................................................................................... 8 1.3. HTTP(S)请求头信息说明 ................................................................................................................ 8 1.3.1. 自定义 HTTP(S)请求头信息 ............................................................................................. 8 1.3.2. 输出 HTTP(S)响应头信息................................................................................................. 9 1.4. 数据模式说明 .................................................................................................................................. 9 2 HTTP(S) AT 命令详解.......................................................................................................................... 10 2.1. AT 命令说明 .................................................................................................................................. 10 2.1.1. 定义 ................................................................................................................................ 10 2.1.2. AT 命令语句 ................................................................................................................... 10 2.2. AT 示例声明 .................................................................................................................................. 11 2.3. AT 命令详解 .................................................................................................................................. 11 2.3.1. AT+QHTTPCFG 配置 HTTP(S)服务器参数 ................................................................ 11 2.3.2. AT+QHTTPURL 设置 HTTP(S)服务器 URL................................................................ 15 2.3.3. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器.................................................... 16 2.3.4. AT+QHTTPGETEX 发送范围 GET 请求到 HTTP(S)服务器 ....................................... 18 2.3.5. AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 ................... 19 2.3.6. AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 ........................ 21 2.3.7. AT+QHTTPPUT 通过 UART/USB 发送 PUT 请求到 HTTP(S)服务器 ........................ 22 2.3.8. AT+QHTTPPUTFILE 通过文件发送 PUT 请求到 HTTP(S)服务器.............................. 24 2.3.9. AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 ........................... 25 2.3.10. AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 ................................ 26 2.3.11. AT+QHTTPSTOP 取消 HTTP(S)请求 ......................................................................... 27 3 举例 ...................................................................................................................................................... 28 3.1. 访问 HTTP 服务器......................................................................................................................... 28 3.1.1. 发送 HTTP GET 请求并读取响应信息............................................................................ 28 3.1.2. 发送 HTTP POST 请求并读取响应信息 ......................................................................... 29 3.1.2.1. 通过 UART/USB 获取 POST 请求体....................................................................... 29 3.1.2.2. 从文件系统获取 POST 请求体 ................................................................................ 30 3.1.3. 发送 HTTP PUT 请求并读取响应信息............................................................................ 31 3.1.3.1. 通过 UART/USB 获取 PUT 请求体 ......................................................................... 31 3.1.3.2. 从文件系统获取 PUT 请求体................................................................................... 32 3.2. 访问 HTTPS 服务器 ...................................................................................................................... 33 3.2.1. 发送 HTTPS GET 请求并读取响应信息 ......................................................................... 33 3.2.2. 发送 HTTPS POST 请求并读取响应信息....................................................................... 35 3.2.2.1. 从 UART/USB 获取 POST 请求体 .......................................................................... 35 上海移远通信技术股份有限公司 4 / 47 LTE Standard(U)系列 HTTP(S)应用指导 3.2.2.2. 从文件系统获取 POST 请求体 ................................................................................ 36 3.2.3. 发送 HTTPS PUT 请求并读取响应信息 ......................................................................... 37 3.2.3.1. 从 UART/USB 获取 PUT 请求体 ............................................................................. 37 3.2.3.2. 从文件系统获取 PUT 请求体................................................................................... 39 4 常见问题处理........................................................................................................................................ 41 4.1. HTTP(S) AT 命令执行失败 ........................................................................................................... 41 4.2. PDP 激活失败 ............................................................................................................................... 41 4.3. DNS 解析失败 ............................................................................................................................... 41 4.4. 数据模式进入失败 ......................................................................................................................... 42 4.5. GET/POST/PUT 请求发送失败..................................................................................................... 42 4.6. 响应信息读取失败 ......................................................................................................................... 42 5 错误代码 ............................................................................................................................................... 43 6 HTTP(S)响应错误代码 ......................................................................................................................... 45 7 附录 参考文档和术语缩写 ................................................................................................................... 46 上海移远通信技术股份有限公司 5 / 47 LTE Standard(U)系列 HTTP(S)应用指导 表格索引 表 1：适用模块 .................................................................................................................................................... 7 表 2：AT 命令类型............................................................................................................................................. 10 表 3：错误代码列表 ........................................................................................................................................... 43 表 4：HTTP(S)响应代码列表............................................................................................................................. 45 表 5：参考文档 .................................................................................................................................................. 46 表 6：术语缩写 .................................................................................................................................................. 46 上海移远通信技术股份有限公司 6 / 47 LTE Standard(U)系列 HTTP(S)应用指导 1 引言 移远通信 LTE Standard(U)系列模块为 HTTP(S)服务器提供 HTTP(S)应用程序。 HTTP（HyperText Transfer Protocol，超文本传输协议）是一种用于分布式、协作式和超媒体信息系 统的应用层协议。 HTTPS（HyperText Transfer Protocol Secure，超文本传输安全协议）是一种通过计算机网络进行安 全通信的传输协议。HTTPS 经由 HTTP 进行通信，但利用 SSL/TLS 来加密数据包。HTTPS 开发的主要目 的，是提供对网站服务器的身份认证，保护交换资料的隐私与完整性。 本文档主要介绍了与 HTTP(S)相关的 AT 命令。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN 上海移远通信技术股份有限公司 7 / 47 EG800G 系列 EG912U 系列 EG915G-EU EG915U 系列 LTE Standard(U)系列 HTTP(S)应用指导 1.2. HTTP(S)命令使用流程 通过模块 TCP/IP AT 命令，可配置 PDP 上下文，激活/去激活上下文以及查询 PDP 上下文状态。通过 模块的 HTTP(S) AT 命令，可以发送 HTTP(S) GET/POST/PUT 请求到 HTTP(S)服务器，并读取来自 HTTP(S)服务器的响应结果。大致流程如下： 第一步，使用 AT+QICSGP 配置 PDP 上下文的、、和其他参数，详 情请参考文档 [1]。 第二步，通过 AT+QIACT 激活 PDP 上下文后，可使用 AT+QIACT?查询已分配的 IP 地址，详情请参 考文档 [1]。 第三步，通过 AT+QHTTPCFG 配置 PDP 和 SSL 上下文 ID。 第四步，通过 AT+QSSLCFG 配置 SSL 上下文参数，详情请参考文档 [2]。 第五步，通过 AT+QHTTPURL 设置 HTTP(S) URL。 第六步，发送 HTTP(S)请求。AT+QHTTPGET 用于发送 HTTP(S) GET 请求，AT+QHTTPGETEX 用 于发送 HTTP(S)范围 GET 请求。AT+QHTTPPOST 或 AT+QHTTPPOSTFILE 用于发送 HTTP(S) POST 请求。AT+QHTTPPUT 或 AT+QHTTPPUTFILE 用于发送 HTTP(S) PUT 请求。 第七步，通过 AT+QHTTPREAD 或 AT+QHTTPREADFILE 读取 HTTP(S)响应信息。 第八步，通过 AT+QIDEACT 去激活 PDP 上下文，详情请参考文档 [1]。 1.3. HTTP(S)请求头信息说明 1.3.1. 自定义 HTTP(S)请求头信息 模块自动填补 HTTP(S)请求头信息，用户可通过 AT+QHTTPCFG 将配置为 1 自定 义 HTTP(S)请求头信息，但需遵循以下标准： 上海移远通信技术股份有限公司 8 / 47 LTE Standard(U)系列 HTTP(S)应用指导 ⚫ 遵循 HTTP(S)请求头信息语句规范。 ⚫ HTTP(S)请求行中的 URI 值和 Host:请求头信息必须与 AT+QHTTPURL 配置的 URL 一致。 ⚫ HTTP(S)请求头信息必须以结尾。 以下为标准 HTTP(S) POST 请求头信息示例： POST /processorder.php HTTP/1.1 Host: 220.180.239.212:8011 Accept: */* User-Agent: QUECTEL_MODULE Connection: Keep-Alive Content-Type: application/x-www-form-urlencoded Content-Length: 48 Message=1111&Appleqty=2222&Orangeqty=3333&find=1 1.3.2. 输出 HTTP(S)响应头信息 模块不自动输出 HTTP(S)响应头信息，可通过 AT+QHTTPCFG 将配置为 1 获取 HTTP(S)响应头信息，然后执行 AT+QHTTPREAD 或 AT+QHTTPREADFILE，HTTP(S)响应头信息将以 HTTP(S)响应体形式输出。 1.4. 数据模式说明 模块的 COM 口有两种工作模式，一是 AT 命令模式，另一种是数据模式。AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。 用户可以通过+++或者DTR（需先设置AT&D1）两种方式退出数据模式，为了防止+++被当成数据发送， 实际操作时必须遵循以下标准： ⚫ +++输入前 1 秒内不能输入其它任何数据。 ⚫ 必须在 1 秒内输入+++，并且不能输入其它任何数据。 ⚫ +++输入后 1 秒内不能输入其它任何数据。 通过执行 AT+QHTTPURL、AT+QHTTPPOST、AT+QHTTPPUT 和 AT+QHTTPREAD 可使 COM 口 进入数据模式，但在这些命令响应之前，若通过+++或拉高 DTR 退出数据模式，会中断这些命令的执行。 在这种情况下，无法通过执行 ATO 命令使 COM 口重新进入数据模式。 上海移远通信技术股份有限公司 9 / 47 LTE Standard(U)系列 HTTP(S)应用指导 2 HTTP(S) AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中变现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 47 LTE Standard(U)系列 HTTP(S)应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QHTTPCFG 配置 HTTP(S)服务器参数 该命令用于配置 HTTP(S)服务器参数，包括配置 PDP 上下文 ID，自定义 HTTP(S)请求头信息，输出 HTTP(S)响应头信息和查询 SSL 设置。若执行设置命令时只保留一个参数，表示查询当前配置。 AT+QHTTPCFG 配置 HTTP(S)服务器参数 测试命令 AT+QHTTPCFG=? 响应 +QHTTPCFG: 'contextid',(支持的范围) +QHTTPCFG: 'requestheader',(支持的 列表) +QHTTPCFG: 'responseheader',(支持的列表) +QHTTPCFG: 'sslctxid',(支持的范围) +QHTTPCFG: 'contenttype',(支持的范围) +QHTTPCFG: 'rspout/auto',(支持的列表) +QHTTPCFG: 'closed/ind',(支持的列表) +QHTTPCFG: 'url', +QHTTPCFG: 'header', +QHTTPCFG: 'auth', +QHTTPCFG: 'form/data',,, +QHTTPCFG: 'reset' 设置命令 AT+QHTTPCFG='contextid'[,] OK 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'contextid', OK 若指定可选参数，设置 PDP 上下文 ID： OK 上海移远通信技术股份有限公司 11 / 47 LTE Standard(U)系列 HTTP(S)应用指导 设置命令 AT+QHTTPCFG='requestheader'[,] 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'requestheader', OK 设置命令 AT+QHTTPCFG='responseheader'[, ] 若指定可选参数，则禁用或启用自定义 HTTP(S)请求头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'responseheader', OK 设置命令 AT+QHTTPCFG='sslctxid'[,] 若指定可选参数，则禁用或启用输出 HTTP(S)响应头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'sslctxid', OK 设置命令 AT+QHTTPCFG='contenttype'[,] 若指定可选参数，则设置 HTTP(S)的 SSL 上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'contenttype', OK 若指定可选参数，设置 HTTP(S)体的数据类型： OK 或者 +CME ERROR: 上海移远通信技术股份有限公司 12 / 47 LTE Standard(U)系列 HTTP(S)应用指导 设置命令 AT+QHTTPCFG='rspout/auto'[,] 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'rspout/auto', OK 设置命令 AT+QHTTPCFG='closed/ind'[,] 若指定可选参数，则禁用或启用自动输出 HTTP(S)响应头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'closed/ind', OK 设置命令 AT+QHTTPCFG='url'[,] 若指定可选参数，则禁用或启用上报 HTTP(S)会话关闭标识： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'url', OK 设置命令 AT+QHTTPCFG='header'[,] 若指定可选参数，则设置 HTTP(S)的 URL： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'header', […] OK 若指定可选参数，则设置 HTTP(S)请求头部行/头部字段名： OK 或者 +CME ERROR: 设置命令 响应 AT+QHTTPCFG='auth'[, 若省略可选参数，则查询当前配置： 上海移远通信技术股份有限公司 13 / 47 LTE Standard(U)系列 HTTP(S)应用指导 ] +QHTTPCFG: 'auth', OK 设置命令 AT+QHTTPCFG='form/data'[,[,[,]]] 若指定可选参数，则设置用户名及密码： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'form/data',,, […] OK 设置命令 AT+QHTTPCFG='reset' 查询命令 AT+QHTTPCFG? 若指定任意可选参数，则设置 HTTP(S) form-data 的配置参数： OK 或者 +CME ERROR: 响应 OK 或者 +CME ERROR: 响应 +QHTTPCFG: 'contextid', +QHTTPCFG: 'requestheader', +QHTTPCFG: 'responseheader', +QHTTPCFG: 'sslctxid', +QHTTPCFG: 'contenttype', +QHTTPCFG: 'rspout/auto', +QHTTPCFG: 'closed/ind', +QHTTPCFG: 'url', +QHTTPCFG: 'auth', 最大响应时间 特性说明 OK / 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 14 / 47 LTE Standard(U)系列 HTTP(S)应用指导 参数 整型。PDP 上下文 ID。范围：1~11（EC200D 系列、EG800G 系列和 EG915G-EU）或 1~7（其他模块）；默认值：1。 整型。禁用或启用自定义 HTTP(S)请求头信息。 0 禁用 1 启用 整型。禁用或启用输出 HTTP(S)响应头信息。 0 禁用 1 启用 整型。HTTP(S)的 SSL 上下文 ID。范围：0~5；默认值：1。可通过 AT+QSSLCFG 配置 SSL 参数，详情请参考文档 [2]。 整型。HTTP(S)体的数据类型。 0 application/x-www-form-urlencoded 1 text/plain 2 application/octet-stream 3 multipart/form-data 4 application/json 5 image/jpeg 整型。禁用或启用自动输出 HTTP(S)响应头信息。若启用自动输出 HTTP(S) 响应头信息，AT+QHTTPREAD 和 AT+QHTTPREADFILE 会执行失败。 0 禁用 1 启用 整型。禁用或启用上报 HTTP(S)会话关闭标识。 0 禁用 1 启用 字符串类型。HTTP(S)的 URL。 字符串类型。HTTP(S)请求头部行/头部字段名，如：'Content-type: text/plain' 或'Content-type'。 字符串类型。用户名及密码。格式为：'username:password'。 字符串类型。form-data 的 name 值。 字符串类型。form-data 的 filename 值。 字符串类型。form-data 的 content-type 值。 错误代码。详情请参考第 5 章。 2.3.2. AT+QHTTPURL 设置 HTTP(S)服务器 URL HTTP(S)服务器的 URL 必须以 http://或 https://开头，表示访问 HTTP 或 HTTPS 服务器。 AT+QHTTPURL 设置 HTTP(S)服务器 URL 测试命令 AT+QHTTPURL=? 响应 +QHTTPURL: (支持的范围),(支持的范围) 上海移远通信技术股份有限公司 15 / 47 LTE Standard(U)系列 HTTP(S)应用指导 OK 设置命令 AT+QHTTPURL=[,] 响应 若参数格式正确，且不发送 HTTP(S) GET/POST/PUT 请求： CONNECT TA 切换到透传模式（即数据模式），即可输入 URL。当输入 数据的总大小达到，TA 将切换回命令模式并上 报以下结果： OK 若 输 入 时 间 达 到 ， 但 接 收 的 URL 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +CME ERROR: 查询命令 AT+QHTTPURL? 若参数格式不正确或发生其他错误： +CME ERROR: 响应 [+QHTTPURL: ] 最大响应时间 特性说明 OK 取决于 该命令立即生效； 参数配置不保存。 参数 整型。URL 长度。范围：7~2048；单位：字节。 整型。URL 的最大输入时间。范围：1~65535；默认值：60；单位：秒。 错误代码。详情请参考第 5 章。 2.3.3. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器 根 据 在 AT+QHTTPCFG='requestheader'[,] 命 令 中 配 置 的 参 数 ， AT+QHTTPGET 设 置 命 令 有 两 种 形 式 。 若 为 1 ， 发 送 AT+QHTTPGET 后，若 125 秒内输出 CONNECT，则表示 HTTP(S)服务器连接成功；若 125 秒内未上报 CONNECT，将输出+CME ERROR: 。 发送 AT+QHTTPGET 设置命令后，上报 OK 后，需要等待一段时间（参考最大响应时间）才会输出 URC +QHTTPGET: [,[,]]。 上海移远通信技术股份有限公司 16 / 47 LTE Standard(U)系列 HTTP(S)应用指导 +QHTTPGET: [,[,]] 中 ， 仅 当 为 0 时 ， 才 上 报 。若 HTTP(S)响应头信息包括 Content-Length，将上报信息。 AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器 测试命令 AT+QHTTPGET=? 响应 +QHTTPGET: (支持的范围),(支持的范围),(支持的范围) OK 设置命令 若为 0（禁用自定义 HTTP(S)请求头信息） 响应 若参数格式正确且无其他错误发生： OK AT+QHTTPGET[=] 模块收到来自 HTTP(S)服务器的响应后，将上报以下 URC： +QHTTPGET: [,[,]] 设置命令 若为 1（启用自定义 HTTP(S)请求头信息） AT+QHTTPGET=,[,] 若参数格式不正确或有其他错误发生： +CME ERROR: 响应 若 HTTP(S)服务器连接成功： CONNECT TA 切换到透传模式（即数据模式），即可输入 HTTP(S) GET 请求头信息。当输入数据的总大小达到，TA 将 切换回命令模式并上报以下结果： OK 模块收到来自 HTTP(S)服务器的响应后，将上报以下 URC： +QHTTPGET: [,[,]] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +QHTTPGET: 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 取决于 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 17 / 47 LTE Standard(U)系列 HTTP(S)应用指导 参数 整型。范围：1~65535；默认值：60；单位：秒。上报 OK 后，此参数为 HTTP(S) GET 响应+QHTTPGET: [,[,]]的最大响应 时间。 整型。HTTP(S)请求信息的长度，包括 HTTP(S)请求头信息和 HTTP(S)请求体。 范围：1~2048；单位：字节。 整 型 。 HTTP(S) 请 求 信 息 的 最 大 输 入 时 间 。 范 围 ： 1~65535 ； 默 认 值 ： 60 ； 单位：秒。 HTTP(S)服务器响应代码。详情请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。 0 禁用 1 启用 整型。HTTP(S)响应体长度。单位：字节。 错误代码。详情请参考第 5 章。 2.3.4. AT+QHTTPGETEX 发送范围 GET 请求到 HTTP(S)服务器 与读取文件类似，MCU 可以通过 AT+QHTTPGETEX 从 HTTP(S)服务器获取指定位置和指定长度的 数据，仅在 AT+QHTTPCFG='requestheader',0 时，方可执行该命令。之后，HTTP(S)服务器将始终以 206 代码响应范围 GET 请求。 AT+QHTTPGETEX 发送范围 GET 请求到 HTTP(S)服务器 测试命令 AT+QHTTPGETEX=? 响应 +QHTTPGETEX: (支持的范围),, 设置命令 AT+QHTTPGETEX=,, OK 响应 若参数格式正确且无其他错误发生： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPGET: [,[,]] 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 取决于 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 18 / 47 LTE Standard(U)系列 HTTP(S)应用指导 参数 整型。范围：1~65535；默认值：60；单位：秒。上报 OK 后，此参数为 HTTP(S) GET 响应+QHTTPGET: [,[,]]的最大响应 时间。 整型。HTTP(S)客户端需要 GET 数据的初始位置。 整型。HTTP(S)客户端需要 GET 数据的长度。 HTTP(S)服务器响应代码。详情请参考第 6 章。 整型。HTTP(S)响应体长度。单位：字节。 错误代码。详情请参考第 5 章。 2.3.5. AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 该 命 令 可 用 来 通 过 UART/USB 发 送 POST 请 求 到 HTTP(S) 服 务 器 。 根 据 在 AT+QHTTPCFG='requestheader'[,] 命 令 中 配 置 的 ， AT+QHTTPPOST 设置命令有两种形式。若为 0，则通过 UART/USB 口输入 POST 请 求体；若为 1，则通过 UART/USB 口输入 POST 请求头信息和 POST 请求体。 发送 AT+QHTTPPOST 后，若 125 秒内返回 CONNECT，则表示 HTTP(S)服务器连接成功；若 125 秒内未返回 CONNECT，将输出+CME ERROR: 。 上 报 OK 后 ， 需 要 等 待 一 段 时 间 （ 参 考 最 大 响 应 时 间 ） 才 会 输 出 URC +QHTTPPOST: [,[,]]。 AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPOST=? 响应 +QHTTPPOST: (支持的范围),(支持的范围),(支持的范围) OK 设置命令 若为 0（禁用自定义 HTTP(S)请求头信息） AT+QHTTPPOST=[,,] 响应 若参数格式正确，HTTP(S)服务器连接成功且 HTTP(S)请求头 信息发送完成： CONNECT TA 切换到透传模式（即数据模式），即可输入 HTTP(S) POST 请求体。当输入数据总大小达到，TA 将切换回 命令模式并上报以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPOST: [,[,]] 上海移远通信技术股份有限公司 19 / 47 LTE Standard(U)系列 HTTP(S)应用指导 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +QHTTPPOST: 若参数格式不正确或有其他错误发生： +CME ERROR: 设置命令 若为 1（启用自定义 HTTP(S)请求头信息） AT+QHTTPPOST=[,,] 响应 若参数格式正确且 HTTP(S)服务器连接成功： CONNECT TA 切换到透传模式（即数据模式），即可输入 HTTP(S) POST 请求体和 HTTP(S) POST 请求头信息。当输入数据总大小达 到，TA 将切换回命令模式并上报以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPOST: [,[,]] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +QHTTPPOST: 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 取决于网络和 该命令立即生效； 参数配置不保存。 参数 整型。若为 0，表示 POST 请求体长度；若 为 1，表示 HTTP(S)请求信息的长度，包括 HTTP(S) POST 请求头信息和 HTTP(S) POST 请求体。范围：1~1024000；单位：字节。 整型。POST 请求体或 HTTP(S)请求信息的最大输入时间。范围：1~65535； 默认值：60；单位：秒。 整型。范围：1~65535；默认值：60；单位：秒。上报 OK 后，此参数为 HTTP(S) POST 响应+QHTTPPOST: [,[,]]的最 大输出时间。 HTTP(S)服务器响应代码。详情请请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。 0 禁用 1 启用 上海移远通信技术股份有限公司 20 / 47 LTE Standard(U)系列 HTTP(S)应用指导 整型。HTTP(S)响应体长度。单位：字节。 错误代码。详情请参考第 5 章。 2.3.6. AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 该 命 令 可 用 来 通 过 文 件 发 送 POST 请 求 到 HTTP(S) 服 务 器 。 根 据 在 AT+QHTTPCFG='requestheader'[,] 命 令 中 配 置 的 ， AT+QHTTPPOSTFILE 操作的文件有两种形式。若为 0，文件系统的文件将为 POST 请求体；若为 1，文件系统的文件将为 POST 请求头信息和 POST 请求体。 执行 AT+QHTTPPOSFILE 后，模块会上报 URC +QHTTPPOSTFILE: [,[,]]表示命令执行结果。仅当为 0 时，才上报。 上 报 OK 后 ， 需 要 等 待 一 段 时 间 （ 参 考 最 大 响 应 时 间 ） 才 会 输 出 URC +QHTTPPOSTFILE: [,[,]]信息。 AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPOSTFILE=? 设置命令 AT+QHTTPPOSTFILE=[, ,] 响应 +QHTTPPOSTFILE: ,(支持的范围), (支持的范围) OK 响应 若参数格式正确且 HTTP(S)服务器连接成功： OK 当模块收到来自 HTTP(S)服务器响应后： +QHTTPPOSTFILE: [,[,]] 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 取决于 该命令立即生效； 参数配置不保存。 参数 字符串类型。文件名称。最大长度为 132 字节。 整型。范围：1~65535；默认值：60；单位：秒。上报 OK 后，此参数为 HTTP(S) POST 响应+QHTTPPOSTFILE: [,[,]] 的最大输出时间。 上海移远通信技术股份有限公司 21 / 47 LTE Standard(U)系列 HTTP(S)应用指导 HTTP(S)服务器响应代码。详情请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。若为 1，指定的 文件必须包含 HTTP(S)请求头信息。 0 禁用 1 启用 整型。HTTP(S)响应体长度。单位：字节。 整型。HTTP(S)发送文件的模式。 0 直接发送文件内容 1 记录保存文件，暂不发送，等待和=2 时配置的文件一起发送 2 发送文件，连同=1 时保存的文件一起发送（只支持两个文件 一起发送） 错误代码。详情请参考第 5 章。 2.3.7. AT+QHTTPPUT 通过 UART/USB 发送 PUT 请求到 HTTP(S)服务器 该 命 令 可 用 来 通 过 UART/USB 发 送 PUT 请 求 到 HTTP(S) 服 务 器 。 根 据 在 AT+QHTTPCFG='requestheader'[,] 命 令 中 配 置 的 ， AT+QHTTPPOST 设置命令有两种形式。若为 0，则通过 UART/USB 口输入 PUT 请求 体；若为 1，则通过 UART/USB 口输入 PUT 请求头信息和 PUT 请求体。 发送 AT+QHTTPPUT 后，若 125 秒内返回 CONNECT，则表示 HTTP(S)服务器连接成功；若 125 秒 内未返回 CONNECT，将输出+CME ERROR: 。 上 报 OK 后 ， 需 要 等 待 一 段 时 间 （ 参 考 最 大 响 应 时 间 ） 才 会 输 出 URC +QHTTPPUT: [,[,]]。 AT+QHTTPPUT 通过 UART/USB 发送 PUT 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPUT=? 响应 +QHTTPPUT: (支持的范围),(支持的范围),(支持的范围) OK 设置命令 若为 0（禁用自定义 HTTP(S)请求头信息） AT+QHTTPPUT=[,,] 响应 若参数格式正确，HTTP(S)服务器连接成功且 HTTP(S)请求头 信息发送完成： CONNECT TA 切换到透传模式（即数据模式），即可输入 HTTP(S) PUT 请求体。当输入数据总大小达到，TA 将返回命 令模式并上报以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： 上海移远通信技术股份有限公司 22 / 47 LTE Standard(U)系列 HTTP(S)应用指导 +QHTTPPUT: [,[,]] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将返回命令模式并上报以下结果： +QHTTPPUT: 若参数格式不正确或有其他错误发生： +CME ERROR: 设置命令 若为 1（启用自定义 HTTP(S)请求头信息） AT+QHTTPPUT=[,,] 响应 若参数格式正确且 HTTP(S)服务器连接成功： CONNECT TA 切换到透传模式（即数据模式），即可输入 HTTP(S) PUT 请求体和 HTTP(S) PUT 请求头信息。当输入数据总大小达到 ，TA 将切换回命令模式并上报以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPUT: [,[,]] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +QHTTPPUT: 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 取决于网络和 该命令立即生效； 参数配置不保存。 参数 整型。若为 0，表示 PUT 请求体长度；若 为 1，表示 HTTP(S)请求信息的长度，包括 HTTP(S) PUT 请求头信息和 HTTP(S) PUT 请求体。范围：1~1024000；单位：字节。 整型。PUT 请求体或 HTTP(S)请求信息的最大输入时间。范围：1~65535； 默认值：60；单位：秒。 整型。范围：1~65535；默认值：60；单位：秒。上报 OK 后，此参数 HTTP (S)PUT 响应+QHTTPPUT: [,[,]]的 最大输出时间。 HTTP(S)服务器响应代码。详情请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。 上海移远通信技术股份有限公司 23 / 47 LTE Standard(U)系列 HTTP(S)应用指导 0 禁用 1 启用 整型。HTTP(S)响应体长度。单位：字节。 错误代码。详情请参考第 5 章。 2.3.8. AT+QHTTPPUTFILE 通过文件发送 PUT 请求到 HTTP(S)服务器 该命令可用于通过文件发送 PUT 请求到 HTTP(S)服务器。根据在 AT+QHTTPCFG='requestheader '[,]命令中配置的，AT+QHTTPPUTFILE 操作的文件有两种形式。 若为 0，文件系统的文件将为 PUT 请求体；若为 1，文件系统的文 件将为 PUT 请求头信息和 PUT 请求体。 执行 AT+QHTTPPUTFILE 后，模块会上报 URC +QHTTPPUTFILE: [,[,]]表示命令执行结果。仅当为 0 时，才上报。 上 报 OK 后 ， 需 要 等 待 一 段 时 间 （ 参 考 最 大 响 应 时 间 ） 才 会 输 出 URC +QHTTPPUTFILE: [,[,]]信息。 AT+QHTTPPUTFILE 通过文件发送 PUT 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPUTFILE=? 设置命令 AT+QHTTPPUTFILE=[,,] 响应 +QHTTPPUTFILE: ,(支持的范围),(支 持的范围) OK 响应 若参数格式正确且 HTTP(S)服务器连接成功： OK 当模块收到来自 HTTP(S)服务器响应后： +QHTTPPUTFILE: [,[,]] 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 取决于 该命令立即生效； 参数配置不保存。 参数 字符串类型。文件名称。最大长度为 132 字节。 整型。范围：1~65535；默认值：60；单位：秒。上报 OK 后，此参数为 HTTP(S) 上海移远通信技术股份有限公司 24 / 47 LTE Standard(U)系列 HTTP(S)应用指导 PUT 响应+QHTTPPUTFILE: [,[,]]的最大 输出时间。 HTTP(S)服务器响应代码。详情请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。若为 1，指定 的文件必须包含 HTTP(S)请求头信息。 0 禁用 1 启用 整型。HTTP(S)响应体长度。单位：字节。 整型。HTTP(S)发送文件的模式。 0 直接发送文件内容 1 记录保存文件，暂不发送，等待和=2 时配置的文件一起发送 2 发送文件，连同=1 时保存的文件一起发送（只支持两个文件 一起发送） 错误代码。详情请参考第 5 章。 2.3.9. AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 发送 HTTP(S) GET/POST/PUT 请求后，可使用 AT+QHTTPREAD 通过 UART/USB 端口从 HTTP(S) 服务器读取 HTTP(S)响应信息。必须接收+QHTTPGET: [,[,]]、+ QHTTPPOST: [,[,]]或+QHTTPPOSTFILE: [,[,]]信息后才能执行 AT+QHTTPREAD。 AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 测试命令 AT+QHTTPREAD=? 响应 +QHTTPREAD: (支持的范围) 设置命令 AT+QHTTPREAD[=] OK 响应 若参数格式正确： CONNECT OK 当响应信息读取完成或两个数据包接收间隔时间达到 ： +QHTTPREAD: 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: / 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 25 / 47 参数 LTE Standard(U)系列 HTTP(S)应用指导 整 型 。 接 收 两 个 数 据 包 之 间 的 最 大 间 隔 时 间 。 范 围 ： 1~65535 ； 默 认 值 ： 60 ； 单位：秒。 错误代码。详情请参考第 5 章。 2.3.10. AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 发送 HTTP(S) GET/POST 请求后，可以使用 AT+QHTTPREADFILE 通过文件从 HTTP(S)服务器读 取 HTTP(S)响应信息，必须接收+QHTTPGET: [,[,]]、+QHTTPP OST: [,[,]]或+QHTTPPOSTFILE: [,[,]]信息后才能执行 AT+QHTTPREADFILE。 AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 测试命令 AT+QHTTPREADFILE=? 响应 +QHTTPREADFILE: ,(支持的范围) 设置命令 AT+QHTTPREADFILE=[, ] OK 响应 若参数格式正确： OK 当响应信息读取完成或两个数据包接收间隔时间达到 ： +QHTTPREADFILE: 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 取决于 该命令立即生效； 参数配置不保存。 参数 整型。接收两个数据包之间的最大间隔时间。范围：1~65535；默认值：60； 单位：秒。 字符串类型。文件名称。最大长度为 132 字节。 错误代码。详情请参考第 5 章。 上海移远通信技术股份有限公司 26 / 47 LTE Standard(U)系列 HTTP(S)应用指导 2.3.11. AT+QHTTPSTOP 取消 HTTP(S)请求 MCU 可通过该命令取消 HTTP(S) GET/POST/PUT 请求，断开与 HTTP(S)的会话连接。 AT+QHTTPSTOP 取消 HTTP(S)请求 测试命令 AT+QHTTPSTOP=? 执行命令 AT+QHTTPSTOP 响应 OK 响应 若参数格式正确且无其他错误发生： OK 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 10 秒 该命令立即生效； 参数配置不保存。 参数 错误代码。详情请参考第 5 章。 上海移远通信技术股份有限公司 27 / 47 LTE Standard(U)系列 HTTP(S)应用指导 3 举例 3.1. 访问 HTTP 服务器 3.1.1. 发送 HTTP GET 请求并读取响应信息 以下举例说明如何发送 HTTP GET 请求，启用 HTTP 响应头信息输出以及读取 HTTP GET 响应。 //发送 HTTP GET 响应示例 AT+QHTTPCFG='contextid',1 //配置PDP上下文ID为1。 OK AT+QHTTPCFG='responseheader',1 //启用输出 HTTP 响应头信息。 OK AT+QIACT? //查询 PDP 上下文状态。 OK AT+QICSGP=1,1,'UNINET','','',1 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 OK AT+QIACT=1 //激活 PDP 上下文 1。 OK //激活成功。 AT+QIACT? //查询 PDP 上下文状态。 +QIACT: 1,1,1,'10.7.157.1' OK AT+QHTTPURL=23,80 CONNECT HTTP://www.sina.com.cn/ OK AT+QHTTPGET=80 OK //设置要访问的 URL，设置超时时间为 80 秒。 //输入长度为 23 个字节的 URL。（此 URL 仅为示例。请根据实 际情况输入正确的 URL。） //发送 HTTP GET 请求，最大响应时间为 80 秒。 +QHTTPGET: 0,200,601710 //读取 HTTP GET 响应信息示例 // 若 HTTP 响 应 头 信 息 中 包 括 Content-Length ， 则 将 上 报 信息。 //方法 1：读取 HTTP 响应信息并通过 UART 口将其输出。 上海移远通信技术股份有限公司 28 / 47 LTE Standard(U)系列 HTTP(S)应用指导 AT+QHTTPREAD=80 //读取 HTTP 响应信息并通过 UART 口将其输出。HTTP 会话关 闭的最长等待时间为 80 秒。 CONNECT HTTP/1.1 200 OK //HTTP 响应头信息和响应体。 Server: nginx Date: Tue, 12 Sep 2017 05:57:29 GMT Content-Type: text/html Content-Length: 601710 Connection: close Last-Modified: Tue, 12 Sep 2017 05:54:48 GMT Vary: Accept-Encoding Expires: Tue, 12 Sep 2017 05:58:28 GMT Cache-Control: max-age=60 X-Powered-By: shci_v1.03 Age: 1 …… //此处响应信息省略。 OK +QHTTPREAD: 0 //成功读取 HTTP 响应头信息和响应体。 //方法 2：读取 HTTP 响应信息并将其储存到 UFS 文件中。 AT+QHTTPREADFILE='UFS:1.txt',80 OK //读取 HTTP 响应头信息和响应体并将其储存到 UFS:1.txt。 HTTP 会话关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //成功储存 HTTP 响应头信息和响应体。 3.1.2. 发送 HTTP POST 请求并读取响应信息 3.1.2.1. 通过 UART/USB 获取 POST 请求体 以下举例说明如何发送 HTTP POST 请求，通过 UART 口读取 POST 请求体以及如何读取 HTTP POST 响应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 上海移远通信技术股份有限公司 29 / 47 LTE Standard(U)系列 HTTP(S)应用指导 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPURL=59,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。 （此 URL 仅为示例，请根据实际 情况输入正确的 URL。） OK AT+QHTTPPOST=20,80,80 //发送 HTTP POST 请求，通过 UART 获取 POST 请求体。POST 请求体的最大输入时间和响应时间皆为 80 秒。 CONNECT Message=HelloQuectel //输入长度为 20 个字节的 POST 请求体。（此 POST 请求体仅 为示例，请根据实际情况输入正确的 POST 请求体。） OK +QHTTPPOST: 0,200,177 // 若 HTTP 响 应 头 信 息 包 含 Content-Length ， 则 将 上 报 AT+QHTTPREAD=80 信息。 //读取 HTTP 响应信息并通过 UART 口将其输出。HTTP 会话关 闭的最长等待时间为 80 秒。 CONNECT Message='HelloQuectel' ASCII:72 101 108 108 111 81 117 101 99 116 101 108 //输出 HTTP 响应信息。 OK +QHTTPREAD: 0 //成功输出 HTTP 响应信息 3.1.2.2. 从文件系统获取 POST 请求体 以下举例说明如何发送 HTTP POST 请求，通过文件系统读取 POST 请求体，以及将 HTTP POST 响 应储存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 上海移远通信技术股份有限公司 30 / 47 LTE Standard(U)系列 HTTP(S)应用指导 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPURL=59,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。 （此 URL 仅为示例，请根据实际 情况输入正确的 URL。） OK //来自 UFS 文件的 POST 请求信息，读取 HTTP 响应信息并将其储存到 UFS 文件中。 AT+QHTTPPOSTFILE='UFS:2.txt',80 //发送 HTTP POST 请求，从 UFS:2.txt 中获取 POST 请求体， 最大响应时间为 80 秒。 OK +QHTTPPOSTFILE: 0,200,177 AT+QHTTPREADFILE='UFS:3.txt',80 OK //HTTP POST 请 求 发 送 成 功 后 ， 方 可 执 行 AT+QHTTPREADFILE。 //读取 HTTP 响应信息并将其储存到 UFS:3.txt。HTTP 会话关 闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTP 响应信息储存成功。 3.1.3. 发送 HTTP PUT 请求并读取响应信息 3.1.3.1. 通过 UART/USB 获取 PUT 请求体 以下举例说明如何发送 HTTP PUT 请求，通过 UART 口读取 PUT 请求体以及如何读取 HTTP PUT 响 应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 上海移远通信技术股份有限公司 31 / 47 LTE Standard(U)系列 HTTP(S)应用指导 OK AT+QHTTPURL=59,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。 （此 URL 仅为示例，请根据实际 情况输入正确的 URL。） OK AT+QHTTPPUT=20,80,80 //发送 HTTP PUT 请求，通过 UART 获取 PUT 请求体。PUT 请 求体的最大输入时间和响应时间皆为 80 秒。 CONNECT Message=HelloQuectel //输入长度为 20 个字节的 PUT 请求体。（此 PUT 请求体仅为 示例，请根据实际情况输入正确的 PUT 请求体。） OK +QHTTPPUT: 0,200,177 // 若 HTTP 响 应 头 信 息 包 含 Content-Length ， 则 将 上 报 信息。 AT+QHTTPREAD=80 //读取 HTTP 响应信息并通过 UART 口将其输出。HTTP 会话关 闭的最长等待时间为 80 秒。 CONNECT Message='HelloQuectel' ASCII:72 101 108 108 111 81 117 101 99 116 101 108 //输出 HTTP 响应信息。 OK +QHTTPREAD: 0 //成功输出 HTTP 响应信息。 3.1.3.2. 从文件系统获取 PUT 请求体 以下举例说明如何发送 HTTP PUT 请求，通过文件系统读取 PUT 请求体，以及将 HTTP PUT 响应储 存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK 上海移远通信技术股份有限公司 32 / 47 LTE Standard(U)系列 HTTP(S)应用指导 AT+QHTTPURL=59,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。 （此 URL 仅为示例，请根据实际 情况输入正确的 URL。） OK //来自 UFS 文件的 PUT 请求信息，读取 HTTP 响应信息并将其储存到 UFS 文件中。 AT+QHTTPPUTFILE='UFS:2.txt',80 //发送 HTTP PUT 请求，从 UFS:2.txt 中获取 PUT 请求体，最 大响应时间为 80 秒。 OK +QHTTPPUTFILE: 0,200,177 AT+QHTTPREADFILE='UFS:3.txt',80 OK //HTTP PUT 请 求 发 送 成 功 后 ， 方 可 执 行 AT+QHTTPREADFILE。 //读取 HTTP 响应信息并将其储存到 UFS:3.txt。HTTP 会话关 闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTP 响应信息储存成功。 3.2. 访问 HTTPS 服务器 3.2.1. 发送 HTTPS GET 请求并读取响应信息 以下举例说明如何发送 HTTPS GET 请求，启用 HTTPS 响应头信息输出以及如何读取 HTTPS GET 响应信息。 //发送HTTPS GET请求示例 AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='responseheader',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //配置PDP上下文ID为1。 //启用输出 HTTPS 响应头信息。 //查询 PDP 上下文状态。 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设 置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID 为 1。 上海移远通信技术股份有限公司 33 / 47 LTE Standard(U)系列 HTTP(S)应用指导 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,0 //设置 SSL 验证级别为 0，表示无身份验证模式。 OK AT+QHTTPURL=22,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT https://www.alipay.com //输入长度为 22 个字节的 URL。（此 URL 仅为示例，请根据 实际情况输入正确的 URL。） OK AT+QHTTPGET=80 //发送 HTTPS GET 请求，最大响应时间为 80 秒。 OK +QHTTPGET: 0,200,21472 //读取 HTTPS 响应信息示例 // 若 HTTPS 响 应 头 信 息 包 含 Content-Length ， 则 将 上 报 信息。 //方法 1：读取 HTTPS 响应信息并将其通过 UART 输出。 AT+QHTTPREAD=80 //读取 HTTPS 响应信息并将其通过 UART 输出。HTTP 会 CONNECT 话关闭的最长等待时间为 80 秒。 //HTTPS 响应头信息和响应体。 HTTP/1.1 200 OK Server: Tengine/2.1.0 Date: Tue, 12 Sep 2017 05:54:34 GMT Content-Type: text/html; charset=utf-8 Content-Length: 21451 Connection: keep-alive …… //此处响应信息省略。 OK +QHTTPREAD: 0 //HTTPS 响应头信息和响应体读取成功。 //方法 2：读取 HTTPS 响应信息并将其储存到 UFS 文件中。 AT+QHTTPREADFILE='UFS:4.txt',80 OK //读取 HTTPS 响应头信息和响应体并将其储存在 UFS:4.txt。 HTTP 会话关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTPS 响应头信息和响应体储存成功。 上海移远通信技术股份有限公司 34 / 47 LTE Standard(U)系列 HTTP(S)应用指导 3.2.2. 发送 HTTPS POST 请求并读取响应信息 3.2.2.1. 从 UART/USB 获取 POST 请求体 以下举例说明如何发送 HTTPS POST 请求，通过 UART 读取 POST 请求体以及如何读取 HTTPS POST 响应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设 置 AT+CFUN=1,1 使配置生效。 //仅返回 OK 表示无被激活的 PDP 上下文。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID 为 1。 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证书，客户端证书和客户端私钥。 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' OK AT+QHTTPURL=45,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT HTTPs://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示 例，请根据实际情况输入正确的 URL。） OK AT+QHTTPPOST=48,80,80 //发送 HTTPS POST 请求，通过 UART 获取 POST 请求体。POST 请求体的最大输入时间和响应时间为 80 秒。 CONNECT Message=1111&Appleqty=2222&Orangeqty=3333&find=1 //输入长度为 48 个字节的 POST 请求体。 上海移远通信技术股份有限公司 35 / 47 LTE Standard(U)系列 HTTP(S)应用指导 （此 POST 请求体仅为示例，请根据实际情 况输入正确的 POST 请求体。） OK +QHTTPPOST: 0,200,285 // 若 HTTPS 响 应 头 信 息 包 含 Content-Length ， 则 将 上 报 信息。 AT+QHTTPREAD=80 //读取 HTTPS 响应信息并将其通过 UART 输出。HTTP 会话关闭 的最长等待时间为 80 秒。 CONNECT //HTTPS 响应信息读取成功。 Quectel's Auto Parts - Order Results Quectel's Auto Parts Order Results Order processed at 02:49, 27th DecemberYour order is as follows: 1111 message2222 apple3333 orange OK +QHTTPREAD: 0 //HTTPS 响应信息输出成功。 3.2.2.2. 从文件系统获取 POST 请求体 以下举例说明如何发送 HTTPS POST 请求，从文件系统读取 POST 请求体以及如何将 HTTPS POST 响应信息储存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 OK //设置 SSL 上下文 ID 为 1。 上海移远通信技术股份有限公司 36 / 47 LTE Standard(U)系列 HTTP(S)应用指导 AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证 书，客户端证书和客户端私钥。 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' OK AT+QHTTPURL=45,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT https://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示例， 请根据实际情况输入正确的 URL。） OK //POST 请求信息来自 UFS 文件，读取 HTTPS 响应信息并将其储存在 UFS 文件中。 AT+QHTTPPOSTFILE='UFS:5.txt',80 //发送 HTTPS POST 请求，从 UFS:5.txt 获取 POST 请求体， 最大响应时间为 80 秒。 OK +QHTTPPOSTFILE: 0,200,177 AT+QHTTPREADFILE='UFS:6.txt',80 OK //HTTPS POST 请 求 发 送 成 功 后 ， 方 可 执 行 AT+QHTTPREADFILE。 //读取 HTTPS 响应信息并将其储存在 UFS:6.txt'。HTTP 会话 关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTPS 响应信息储存成功。 3.2.3. 发送 HTTPS PUT 请求并读取响应信息 3.2.3.1. 从 UART/USB 获取 PUT 请求体 以下举例说明如何发送 HTTPS PUT 请求，通过 UART 读取 PUT 请求体以及如何读取 HTTPS PUT 响 应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设 上海移远通信技术股份有限公司 37 / 47 LTE Standard(U)系列 HTTP(S)应用指导 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' 置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID 为 1。 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证书，客户端证书和客户端私钥。 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' OK AT+QHTTPURL=45,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT HTTPs://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示 例，请根据实际情况输入正确的 URL。） OK AT+QHTTPPUT=48,80,80 //发送 HTTPS PUT 请求，通过 UART 获取 PUT 请求体。PUT 请求 体的最大输入时间和响应时间为 80 秒。 CONNECT Message=1111&Appleqty=2222&Orangeqty=3333&find=1 //输入长度为 48 个字节的 PUT 请求体。（此 PUT 请求体仅为示例，请根据实际情况输入 正确的 PUT 请求体。） OK +QHTTPPUT: 0,200,285 // 若 HTTPS 响 应 头 信 息 包 含 Content-Length ， 则 将 上 报 信息。 AT+QHTTPREAD=80 //读取 HTTPS 响应信息并将其通过 UART 输出。HTTP 会话关闭 的最长等待时间为 80 秒。 CONNECT //HTTPS 响应信息读取成功。 Quectel's Auto Parts - Order Results 上海移远通信技术股份有限公司 38 / 47 LTE Standard(U)系列 HTTP(S)应用指导 Quectel's Auto Parts Order Results Order processed at 02:49, 27th DecemberYour order is as follows: 1111 message2222 apple3333 orange OK +QHTTPREAD: 0 //HTTPS 响应信息输出成功。 3.2.3.2. 从文件系统获取 PUT 请求体 以下举例说明如何发送 HTTPS PUT 请求，从文件系统读取 PUT 请求体以及如何将 HTTPS PUT 响应 信息储存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //仅返回 OK 表示无被激活的 PDP 上下文。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID 为 1。 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证 书，客户端证书和客户端私钥。 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' 上海移远通信技术股份有限公司 39 / 47 LTE Standard(U)系列 HTTP(S)应用指导 OK AT+QHTTPURL=45,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT https://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示例， 请根据实际情况输入正确的 URL。） OK //PUT 请求信息来自 UFS 文件，读取 HTTPS 响应信息并将其储存在 UFS 文件中。 AT+QHTTPPUTFILE='UFS:5.txt',80 //发送 HTTPS PUT 请求，从 UFS:5.txt 获取 PUT 请求体， 最 大响应时间为 80 秒。 OK +QHTTPPUTFILE: 0,200,177 AT+QHTTPREADFILE='UFS:6.txt',80 OK //HTTPS PUT 请 求 发 送 成 功 后 ， 方 可 执 行 AT+QHTTPREADFILE。 //读取 HTTPS 响应信息并将其储存在 UFS:6.txt'。HTTP 会话 关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTPS 响应信息储存成功。 上海移远通信技术股份有限公司 40 / 47 LTE Standard(U)系列 HTTP(S)应用指导 4 常见问题处理 4.1. HTTP(S) AT 命令执行失败 执行 HTTP(S) AT 命令后，若返回+CME ERROR: ，请检查是否插入了(U)SIM 卡，并注意执行 AT+CPIN?后是否返回了+CPIN: READY。 4.2. PDP 激活失败 若使用 AT+QIACT 激活 PDP 失败，请检查以下配置： 1. 查询是否通过 AT+CGATT?附着了 PS 域。若未附着 PS 域，请先执行 AT+CGATT=1 附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保已注册了 PS 域。 3. 通过 AT+QICSGP 查询 PDP 上下文参数，并确保已设置了指定 PDP 上下文的 APN。 4. 确保指定 PDP 上下文 ID 既不被 PPP 使用，也不通过 AT+CGACT 激活。 若上述配置无误，使用 AT+QIACT 激活 PDP 上下文仍失败，请重启模块。重启模块后，请至少检查 三次上述提及的配置，每次间隔 10 分钟，以避免频繁重启模块。 4.3. DNS 解析失败 执 行 AT+QHTTPGET 、 AT+QHTTPPOST 、 AT+QHTTPPOSTFILE 、 AT+QHTTPPUT 和 AT+QHTTPPUTFILE 后，若返回+CME ERROR: 714（714：HTTP(S) DNS 错误），请检查以下配置： 1. 确认 HTTP(S)服务器域名有效。 2. 通过 AT+QIACT?查询 PDP 上下文状态，确保成功激活了指定的 PDP 上下文。 3. 通过 AT+QIDNSCFG 查询 DNS 服务器地址，确保 DNS 服务器的地址不是'0.0.0.0'。 若 DNS 服务器的地址为'0.0.0.0'，有两种解决方法： 1. 通过 AT+QIDNSCFG 重新分配一个有效 DNS 服务器地址。 2. 通过 AT+QIDEACT 去激活 PDP 上下文，通过 AT+QIACT 重新激活 PDP 上下文。 上海移远通信技术股份有限公司 41 / 47 LTE Standard(U)系列 HTTP(S)应用指导 4.4. 数据模式进入失败 执 行 AT+QHTTPURL 、 AT+QHTTPGET 、 AT+QHTTPPOST 、 AT+QHTTPPOSTFILE 、 AT+QHTTPPUT、AT+QHTTPPUTFILE 和 AT+QHTTPREAD 后，若返回+CME ERROR: 704（704： HTTP(S) UART 繁忙），请检查数据模式下是否存在其他端口，由于模块仅支持一个端口处于数据模式， 若存在其他端口，请退出其他端口数据模式后重新执行这些命令。 4.5. GET/POST/PUT 请求发送失败 若 执 行 AT+QHTTPGET 、 AT+QHTTPGETEX 、 AT+QHTTPPOST 、 AT+QHTTPPOSTFILE 、 AT+QHTTPPUT 和 AT+QHTTPPUTFILE 失败，请检查以下配置： 1. 确保通过 AT+QHTTPURL 输入的 URL 有效且可以访问。 2. 确保指定服务器支持 GET/POST/PUT 相关命令。 3. 确保 PDP 上下文已激活。 若上述配置无误，通过 AT+QHTTPGET、AT+QHTTPPOST、AT+QHTTPPOSTFILE、AT+QHTTPPUT 和 AT+QHTTPPUTFILE 发送 GET/POST/PUT 请求仍失败，请通过 AT+QIDEACT 去激活 PDP 上下文， 并通过 AT+QIACT 重新激活 PDP 上下文。若激活 PDP 上下文失败，详情请参考第 4.2 章解决此问题。 4.6. 响应信息读取失败 通过 AT+QHTTPREAD 和 AT+QHTTPREADFILE 读取响应信息之前，首先要执行 AT+QHTTPGET、 AT+QHTTPPOST、AT+QHTTPPOSTFILE、AT+QHTTPPUT 和 AT+QHTTPPUTFILE 并接收到以下 URC： +QHTTPGET: [,[,]] +QHTTPPOST: [,[,]] +QHTTPPOSTFILE: [,[,]] +QHTTPPUT: [,[,]] +QHTTPPUTFILE: [,[,]] 执行 AT+QHTTTPREAD 和 AT+QHTTPREADFILE 时，若发生错误，如上报+CME ERROR: 717（717： HTTP(S) socket 读取错误），请通过 AT+QHTTPGET、AT+QHTTPPOST、AT+QHTTPPOSTFILE、 AT+QHTTPPUT 和 AT+QHTTPPUTFILE 向 HTTP(S)服务器重新发送 HTTP(S) GET/POST/PUT 请求；若 请求仍发送失败，请参考第 4.5 章解决此问题。 上海移远通信技术股份有限公司 42 / 47 LTE Standard(U)系列 HTTP(S)应用指导 5 错误代码 表示与移动设备或网络有关的错误代码。相关详细信息参考下表。 表 3：错误代码列表 错误代码 0 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 英文描述 Operation successful HTTP(S) unknown error HTTP(S) timeout HTTP(S) busy HTTP(S) UART busy HTTP(S) no GET/POST requests HTTP(S) network busy HTTP(S) network open failed HTTP(S) network no configuration HTTP(S) network deactivated HTTP(S) network error HTTP(S) URL error HTTP(S) empty URL HTTP(S) IP address error HTTP(S) DNS error HTTP(S) socket create error HTTP(S) socket connect error HTTP(S) socket read error 中文描述 操作成功 HTTP(S)未知错误 HTTP(S)超时 HTTP(S)繁忙 HTTP(S)UART 繁忙 HTTP(S)无 GET/POST/PUT 请求 HTTP(S)网络繁忙 HTTP(S)网络连接失败 HTTP(S)网络未配置 去激活 HTTP(S)网络 HTTP(S)网络错误 HTTP(S) URL 错误 HTTP(S)空 URL HTTP(S) IP 地址错误 HTTP(S) DNS 错误 HTTP(S) socket 创建错误 HTTP(S) socket 连接错误 HTTP(S) socket 读取错误 上海移远通信技术股份有限公司 43 / 47 LTE Standard(U)系列 HTTP(S)应用指导 718 HTTP(S) socket write error HTTP(S) socket 写入错误 719 HTTP(S) socket closed HTTP(S) socket 关闭 720 HTTP(S) data encode error HTTP(S)数据编码错误 721 HTTP(S) data decode error HTTP(S)数据解码错误 722 HTTP(S) read timeout HTTP(S)读取超时 723 HTTP(S) response failed HTTP(S)响应失败 724 Incoming call busy 来电忙 725 Voice call busy 语音通话忙 726 Input timeout 输入超时 727 Wait data timeout 数据等待超时 728 Wait HTTP(S) response timeout HTTP(S)等待响应超时 729 Memory allocation failed 内存分配不足 730 Invalid parameter 无效参数 731 Wondblock 被阻塞 732 SSL Handshake Failed SSL 握手失败 上海移远通信技术股份有限公司 44 / 47 LTE Standard(U)系列 HTTP(S)应用指导 6 HTTP(S)响应错误代码 表示 HTTP(S)服务器响应代码。相关详细信息参见下表。 表 4：HTTP(S)响应代码列表 响应代码 200 206 403 404 409 411 500 英文描述 OK Partial Content Forbidden Not found Conflict Length required Internal server error 中文描述 成功 部分内容 禁止 未发现 冲突 需输入长度 内部服务器错误 上海移远通信技术股份有限公司 45 / 47 LTE Standard(U)系列 HTTP(S)应用指导 7 附录 参考文档和术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_TCP(IP)_应用指导 [2] Quectel_LTE_Standard(U)系列_SSL_应用指导 表 6：术语缩写 缩写 APN CA DNS DTR HTTP HTTPS ID IP LTE MCU PDP PPP PS SSL 英文全称 Access Point Name Certification Authority Domain Name Server Data Terminal Ready Hypertext Transfer Protocol Hypertext Transfer Protocol Secure Identification Internet Protocol Long-Term Evolution Microprogrammed Control Unit Packet Data Protocol Point-to-Point Protocol Packet Switch Security Socket Layer 中文全称 接入点名称 数字证书认证系统 域名服务器 数据终端就绪 超文本传输协议 超文本传输安全协议 身份识别 网际互连协议 长期演进 微程序控制器 分组数据协议 点对点协议 分组交换 安全 Socket 层 上海移远通信技术股份有限公司 46 / 47 TA UART URI URL URC USB (U)SIM UFS LTE Standard(U)系列 HTTP(S)应用指导 Terminal Adapter Universal Asynchronous Receiver/Transmitter Uniform Resource Identifier 终端适配器 通用异步收发传输器 统一资源标示符 Uniform Resource Locator 统一资源定位符 Unsolicited Result Code 未经请求的结果代码 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module （通用）用户身份识别模块 UNIX File System UNIX 文件系统 上海移远通信技术股份有限公司 47 / 47

LTE Standard(U)系列 FTP(S)应用指导 LTE Standard 模块系列 版本：1.3 日期：2023-08-22 状态：受控文件 LTE Standard(U)系列 FTP(S)应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 51 LTE Standard(U)系列 FTP(S)应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 51 LTE Standard(U)系列 FTP(S)应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2020-05-28 Kruskal ZHU 文档创建 1.0 2020-06-08 Kruskal ZHU 受控版本 1.1 2021-08-17 Kruskal ZHU 增加适用模块 EG915U 系列。 1. 增加适用模块 EC200D 系列、EC200G-CN、EC600G-CN、 EC800G-CN、EG700G-CN 和 EG912U-GL。 2. 增加 AT+QFTPCFG='cache_size'命令（第 2.1 章）。 1.2 2023-01-12 Kruskal ZHU 3. 增加在不同模块下的取值情况说明（第 2.1 章）。 4. 增 加 取 值 为 2 时 ， 必 须 同 时 设 置 的说明（第 2.1 章）。 1. 更新适用模块： ⚫ 新增 EG800G 系列； 1.3 2023-08-22 Kruskal ZHU ⚫ 更新 EC600G-CN 为 EC600G 系列。 2. 更新和参数的取值范围（第 2.5 章 & 第 2.6 章）。 上海移远通信技术股份有限公司 3 / 51 LTE Standard(U)系列 FTP(S)应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 1.2. AT 命令说明................................................................................................................................ 8 1.2.1. 定义 ................................................................................................................................. 8 1.2.2. AT 命令语句..................................................................................................................... 8 1.3. AT 示例声明................................................................................................................................ 8 1.4. FTP(S)命令使用流程 .................................................................................................................. 9 1.5. 数据模式说明............................................................................................................................ 10 2 FTP(S) AT 命令详解 ........................................................................................................................... 11 2.1. AT+QFTPCFG 配置 FTP(S)服务器参数.................................................................................11 2.2. AT+QFTPOPEN 登录 FTP(S)服务器 .................................................................................... 15 2.3. AT+QFTPCWD 配置 FTP(S)服务器当前目录 ....................................................................... 16 2.4. AT+QFTPPWD 获取 FTP(S)服务器当前目录........................................................................ 17 2.5. AT+QFTPPUT 上传文件至 FTP(S)服务器............................................................................. 17 2.6. AT+QFTPGET 从 FTP(S)服务器下载文件 ............................................................................ 20 2.7. AT+QFTPSIZE 获取 FTP(S)服务器文件大小 ........................................................................ 23 2.8. AT+QFTPDEL 删除 FTP(S)服务器文件................................................................................. 24 2.9. AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 ........................................................................ 24 2.10. AT+QFTPRMDIR 删除 FTP(S)服务器文件夹........................................................................ 25 2.11. AT+QFTPLIST 获取 FTP(S)服务器目录内容......................................................................... 26 2.12. AT+QFTPNLST 获取 FTP(S)服务器目录文件名 ................................................................... 28 2.13. AT+QFTPMLSD 获取标准化文件和目录信息........................................................................ 29 2.14. AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 .............................................................. 31 2.15. AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹...................................................... 32 2.16. AT+QFTPLEN 获取传输数据长度 ......................................................................................... 33 2.17. AT+QFTPSTAT 获取 FTP(S)服务器状态............................................................................... 34 2.18. AT+QFTPCLOSE 退出 FTP(S)服务器 .................................................................................. 34 3 举例 ..................................................................................................................................................... 36 3.1. 登录 FTP 服务器....................................................................................................................... 36 3.2. 登录 FTPS 服务器 .................................................................................................................... 36 3.3. 文件夹操作 ............................................................................................................................... 37 3.4. 文件操作 ................................................................................................................................... 38 3.5. 获取文件信息或文件名 ............................................................................................................. 39 3.6. 上传文件至 FTP(S)服务器........................................................................................................ 40 3.7. 从 FTP(S)服务器下载文件........................................................................................................ 42 3.8. 退出 FTP(S)服务器................................................................................................................... 44 上海移远通信技术股份有限公司 4 / 51 LTE Standard(U)系列 FTP(S)应用指导 4 常见问题处理....................................................................................................................................... 45 4.1. FTP(S) AT 命令执行失败.......................................................................................................... 45 4.2. PDP 激活失败........................................................................................................................... 45 4.3. DNS 解析失败 .......................................................................................................................... 45 4.4. FTP(S)服务器响应错误 ............................................................................................................ 46 5 错误码 ................................................................................................................................................. 47 6 FTP(S)协议错误码 .............................................................................................................................. 49 7 附录 参考文档和术语缩写 .................................................................................................................. 50 上海移远通信技术股份有限公司 5 / 51 LTE Standard(U)系列 FTP(S)应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型........................................................................................................................................ 8 表 3：错误码列表 ....................................................................................................................................... 47 表 4：FTP(S)协议错误码列表 .................................................................................................................... 49 表 5：参考文档 ........................................................................................................................................... 50 表 6：术语缩写 ........................................................................................................................................... 50 上海移远通信技术股份有限公司 6 / 51 LTE Standard(U)系列 FTP(S)应用指导 1 引言 移远通信 LTE Standard(U)系列模块支持 FTP 和 FTPS 文件传输协议（下文简称'FTP(S)'）。 FTP（File Transfer Protocol，文件传输协议）是一种标准的网络协议，用于在计算机网络上的客户端 和服务器之间传输计算机文件，具有很高的传输速率。 FTPS（FTP over SSL 或 FTP Secure）是一种对常用的文件传输协议（FTP）添加传输层安全（TLS） 和安全套接层（SSL）加密协议支持的扩展协议。 本文档主要介绍如何通过 AT 命令应用如下移远通信模块的 FTP(S)功能。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 上海移远通信技术股份有限公司 7 / 51 EG912U-GL EG915U 系列 LTE Standard(U)系列 FTP(S)应用指导 1.2. AT 命令说明 1.2.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 8 / 51 LTE Standard(U)系列 FTP(S)应用指导 1.4. FTP(S)命令使用流程 LTE Standard(U)系列模块支持 FTP(S)协议，因此 FTP(S)服务器上的文件和目录可以通过 FTP(S)相 关 AT 命令进行操作。FTP(S)相关 AT 命令使用流程如下： 第一步：配置和激活 PDP 上下文。 1. 使用 AT+QICSGP 配置 PDP 上下文的、、和其他参数，详细信 息可参考文档 [1]。可通过 AT+CGQMIN 和 AT+CGQREQ 更新 QoS 设置，详细信息可参考文档 [1]； 2. 通过 AT+QIACT 激活 PDP 上下文，详细信息可参考文档 [1]； 3. 通过 AT+QFTPCFG='contextid',配置 FTP(S) PDP 上下文 ID。需提前激活 PDP 上 下文。 第二步：配置用户账号和 FTP(S)服务器。 1. 通过 AT+QFTPCFG='account',,配置账号信息； 2. 通过 AT+QFTPCFG='filetype',配置文件类型。在 FTP(S)服务器和客户端间传输的 文件类型可以是二进制数据或 ASCII 数据； 3. 通过 AT+QFTPCFG='transmode',配置传输模式，即在 FTP(S)服务器端口或客户 端 端 口 监 听 数 据 连 接 。 请 注 意 ， 因 为 FTPS 当 前 不 支 持 主 动 模 式 ， 必 须 设 置 AT+QFTPCFG='transmode',1 后才能进行 FTPS 操作； 4. 通过 AT+QFTPCFG='rsptimeout',配置命令的最大响应时间； 5. 若模块作为 FTPS 客户端，需执行如下命令： 1） 执行 AT+QFTPCFG='ssltype',1 2） 执行 AT+QFTPCFG='sslctxid',设置 3） AT+QSSLCFG 配置所指定的。详细信息可参考文档 [3]。 第三步：登录 FTP(S)服务器。 通 过 AT+QFTPOPEN=, 登 录 FTP(S) 服 务 器 ， 命 令 执 行 后 ， 若 响 应 URC +QFTPOPEN: 0,0，表示操作成功。注意 FTPS 和 FTP 端口不同。FTPS 服务器的端口取决于 FTPS 服务 器提供商，通常为 990。 第四步：文件操作。 1. 通过 AT+QFTPCWD 设置当前目录； 2. 上传文件至 FTP(S)服务器； 1） 通过 AT+QFUPL 可以将文件上传至 UFS 或 SD 卡，再通过 AT+QFTPPUT 将文件上传至 FTP(S)服务器。文件上传成功后，可通过 AT+QFDEL 将其删除。详细信息可参考文档 [4]； 2） 在 COM 口通过 AT+QFTPPUT 将文件上传至 FTP(S)服务器。执行+++可结束文件上传。 3. 通过 AT+QFTPGET 从 FTP(S)服务器下载文件。文件将在 COM 口输出或被保存至 UFS 或 SD 卡。 若 COM 口输出文件，模块将进入数据模式； 4. 通过 AT+QFTPSIZE 获取 FTP(S)服务器文件大小； 5. 通过 AT+QFTPLEN 获取 FTP(S)服务器和客户端之间传输的数据长度； 上海移远通信技术股份有限公司 9 / 51 LTE Standard(U)系列 FTP(S)应用指导 6. 通过 AT+QFTPDEL 删除 FTP(S)服务器文件； 7. 通过 AT+QFTPRENAME 重命名 FTP(S)服务器文件。 第五步：FTP(S)服务器目录操作。 1. 通过 AT+QFTPCWD 设置当前目录； 2. 通过 AT+QFTPMKDIR 创建文件夹； 3. 通过 AT+QFTPLIST 列出目录内容； 4. 通过 AT+QFTPNLST 列出目录文件名； 5. 通过 AT+QFTPRENAME 重命名文件或文件夹； 6. 通过 AT+QFTPRMDIR 删除文件夹； 7. 通过 AT+QFTPMLSD 列出标准文件和目录信息； 8. 通过 AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间。 第六步：关闭和 FTP(S)服务器的连接。 通过 AT+QFTPCLOSE 关闭和 FTP(S)服务器的连接，命令执行后，若响应 URC +QFTPCLOSE: 0,0， 表明操作成功，即可重复上述第三步至第六步。 第七步：去激活 PDP 上下文。 通过 AT+QIDEACT=去激活 PDP 上下文，详细信息可参考文档 [1]。 1.5. 数据模式说明 LTE Standard(U)系列模块的 COM 口有两种工作模式：一种是 AT 命令模式，另一种是数据模式。在 AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；在数据模式下，则被认为是数据。 用户可以通过输入+++或拉高 DTR（需先设置 AT&D1）使 COM 口退出数据模式。为防止+++被误认 为是数据，在使用 COM 口之前应遵循以下标准： ⚫ +++输入前 1 秒内不能输入其它任何数据。 ⚫ 必须在 1 秒内输入+++，并且不能输入其它任何数据。 ⚫ +++输入后 1 秒内不能输入其它任何数据。 在 COM 口执行 AT+QFTPPUT、AT+QFTPGET、AT+QFTPLIST 和 AT+QFTPNLST 时，若本地文件 路径为'COM:'，数据将从 COM 口接收和输出，COM 口会进入数据模式。用户可使用+++或拉高 DTR 退 出数据模式。此外，执行 AT+QFTPGET、AT+QFTPLIST 和 AT+QFTPNLST 后，可使用 ATO 重新进入数 据模式。但执行 AT+QFTPPUT 后，使用 ATO 不能再次进入数据模式。 上海移远通信技术股份有限公司 10 / 51 LTE Standard(U)系列 FTP(S)应用指导 2 FTP(S) AT 命令详解 2.1. AT+QFTPCFG 配置 FTP(S)服务器参数 该命令用于配置 FTP(S)服务器参数，包括用户账号、文件类型、传输模式和上下文 ID 等。设置命令 省略可选参数时，将查询当前配置。 AT+QFTPCFG 配置 FTP(S)服务器参数 测试命令 响应 AT+QFTPCFG=? +QFTPCFG: 'account',, +QFTPCFG: 'filetype',(支持的列表) +QFTPCFG: 'transmode',(支持的列表) +QFTPCFG: 'contextid',(支持的范围) +QFTPCFG: 'rsptimeout',(支持的范围) +QFTPCFG: 'ssltype',(支持的范围) +QFTPCFG: 'sslctxid',(支持的范围) +QFTPCFG: 'data_address',( 支 持 的 范围),(支持的范围) +QFTPCFG: 'cache_size',(支持的列表),(支 持的列表) 设置命令 AT+QFTPCFG='account'[,,] OK 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'account',, OK 设置命令 AT+QFTPCFG='filetype'[, ] 若指定可选参数，则设置用户账号： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'filetype', OK 上海移远通信技术股份有限公司 11 / 51 LTE Standard(U)系列 FTP(S)应用指导 设置命令 AT+QFTPCFG='transmode'[,] 若指定可选参数，则设置文件类型： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'transmode', OK 设置命令 AT+QFTPCFG='contextid'[,] 若指定可选参数，则设置传输模式： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'contextid', OK 设置命令 AT+QFTPCFG='rsptimeout'[,] 若指定可选参数，则设置上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'rsptimeout', OK 设置命令 AT+QFTPCFG='ssltype'[,] 若指定可选参数，则设置响应超时时间： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'ssltype', OK 若指定可选参数，则设置 SSL 类型： OK 或者 上海移远通信技术股份有限公司 12 / 51 LTE Standard(U)系列 FTP(S)应用指导 +CME ERROR: 设置命令 AT+QFTPCFG='sslctxid'[,] 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'sslctxid', OK 设置命令 AT+QFTPCFG='data_address'[,[,]] 若指定可选参数，则设置 SSL 上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： 1) 若为 2： +QFTPCFG: 'data_address',, OK 2) 若不为 2： +QFTPCFG: 'data_address', OK 设置命令 AT+QFTPCFG='cache_size'[,[,]] 若指定任意可选参数，设置数据连接地址： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'cache_size',, OK 最大响应时间 特性说明 若指定任意可选参数，则设置 FTP(S)的缓存大小及是否启用 FTP(S)缓存阈值功能： OK 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 13 / 51 LTE Standard(U)系列 FTP(S)应用指导 参数 字符串类型。鉴权用户名。最大长度为 255 字节。 字符串类型。鉴权密码。最大长度为 255 字节。 整型。传输数据类型。 0 二进制 1 ASCII 整型。在 FTP(S)服务器端口还是客户端端口上监听数据连接。 0 主动模式，在客户端端口监听来自 FTP 服务器的数据连接。 1 被动模式，在 FTP 服务器端口监听来自客户端的数据连接。 整型。PDP 上下文 ID。EC200D 和 EG800G 系列模块，该参数范围为 1~11； 其他模块，该参数范围为 1~7。默认值：1。使用 AT+QFTPOPEN 前，应先通 过 AT+QIACT 激活 PDP 上下文。详细信息可参考文档 [1]。 整型。范围：20~180；默认值：90；单位：秒。 一般除 AT+QFTPPUT/QFTPGET/QFTPLST/QFTPNLST 外，执行其他命令 响应 OK 前，该参数值为+QFTPXXX: xx,xx 的最大响应时间。该参数对于 AT+QFTPPUT/QFTPGET/QFTPLST/QFTPNLST 的含义如下： 1) 发送命令后，未响应 CONNECT 前，该参数值表示 CONNECT 的最大响 应时间。 2) 模块进入数据模式后，该参数值表示接收或发送两个数据包之间的最大间 隔时间。 3) 当不为'COM:'时，该参数值表示接收或发送两个数据包之 间的最大间隔时间。 整型。模块用作 FTP 客户端或 FTPS 客户端。 0 FTP 客户端 1 FTPS 隐式加密 2 FTPS 显式加密 整型。SSL 上下文 ID。范围：0~5；默认值：0。用户可以通过 AT+QSSLCFG 配置 SSL 参数。详细信息可参考文档 [3]。 整型。FTP(S)数据连接地址选择。 0 使用服务器分配的地址 1 使用 FTP(S)控制会话地址 2 优先使用 FTP(S)控制会话地址。若连接失败，将切换为服务器分配的地 址。配置该数据连接方式时，必须同时设置。 整型。当 FTP(S)控制会话地址连接失败时，切换服务器分配的地址所需时间。 仅当为 2 时有效。范围：15~50；默认值：25；单位： 秒。 整型。FTP(S)数据缓存大小。范围：0，65535~512000。0 表示关闭缓存功能。 整型。启用/禁用 FTP(S)数据缓存阈值功能。 0 禁用 1 启用 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 上海移远通信技术股份有限公司 14 / 51 LTE Standard(U)系列 FTP(S)应用指导 备注 由于 FTPS 当前不支持主动模式，操作 FTPS 时，必须将设置为 1。 2.2. AT+QFTPOPEN 登录 FTP(S)服务器 该命令用于登录 FTP(S 服务器。执行该命令前，需先通过 AT+QIACT 激活 PDP 上下文。+QFTPOPEN: ,表示 AT+QFTPOPEN 的操作结果，应在 AT+QFTPCFG 配置的时间内 输出。 AT+QFTPOPEN 登录 FTP(S)服务器 测试命令 响应 AT+QFTPOPEN=? +QFTPOPEN: , 设置命令 AT+QFTPOPEN=[,] OK 响应 OK 最大响应时间 特性说明 +QFTPOPEN: , 或者 +CME ERROR: 125 秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器 IP 地址和域名。最大长度为 200 字节。 整型。FTP(S)服务器端口。范围：1~65535；默认值：21。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 AT+QFTPOPEN='101.95.183.122',21 OK +QFTPOPEN: 0,0 AT+QFTPOPEN='quectel.3322.org',990 //登录 FTP 服务器。 //登录 FTPS 服务器。 上海移远通信技术股份有限公司 15 / 51 LTE Standard(U)系列 FTP(S)应用指导 OK +QFTPOPEN: 0,0 备注 注意 FTPS 和 FTP 服务器端口不同，FTPS 服务器的端口取决于 FTPS 服务器提供商，通常为 990。 2.3. AT+QFTPCWD 配置 FTP(S)服务器当前目录 该命令用于配置 FTP(S)服务器当前目录。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPCWD: ,。所有文件和目录均可在当前目录中进行操 作。 AT+QFTPCWD 配置 FTP(S)服务器当前目录 测试命令 响应 AT+QFTPCWD=? +QFTPCWD: 设置命令 AT+QFTPCWD= OK 响应 OK 最大响应时间 特性说明 +QFTPCWD: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器目录路径。最大长度为 255 字节。根路径为'/'。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 16 / 51 LTE Standard(U)系列 FTP(S)应用指导 2.4. AT+QFTPPWD 获取 FTP(S)服务器当前目录 该命令用于获取 FTP(S)服务器当前目录。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPPWD: 0,或者+QFTPPWD: ,。 AT+QFTPPWD 获取 FTP(S)服务器当前目录 测试命令 响应 AT+QFTPPWD=? 执行命令 OK 响应 AT+QFTPPWD OK 若当前目录获取成功： +QFTPPWD: 0, 最大响应时间 特性说明 若当前目录获取失败： +QFTPPWD: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器目录路径。最大长度为 255 字节。根路径为'/'。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.5. AT+QFTPPUT 上传文件至 FTP(S)服务器 该命令用于上传文件至 FTP(S)服务器。若通过 COM 口上传文件，模块将进入数据模式。使用+++可 终止文件上传。本地文件，例如 UFS 或 SD 文件，可上传至 FTP(S)服务器。通过 AT+QFUPL 可以将文件 上传至 UFS 或 SD 卡，再通过 AT+QFTPPUT 将其上传至 FTP(S)服务器。文件上传成功后，即可使用 AT+QFDEL 删除本地文件。详细信息可参考文档 [4]。 用于将文件从指定位置上传。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT。若不为'COM:'，执行该命令后，将先响应 OK，数据传 输完成后再响应+QFTPPUT: 0,或者+QFTPPUT: ,。 上海移远通信技术股份有限公司 17 / 51 LTE Standard(U)系列 FTP(S)应用指导 若模块进入数据模式或不为'COM:'，AT+QFTPCFG 配置的则表示接收或发 送两包数据之间的最大时间间隔。 AT+QFTPPUT 上传文件至 FTP(S)服务器 测试命令 响应 AT+QFTPPUT=? +QFTPPUT: ,,,, 设置命令 当为'COM:' AT+QFTPPUT=,[,[,,]] OK 响应 CONNECT OK 若文件上传成功： +QFTPPUT: 0, 若文件上传失败： +QFTPPUT: , 设置命令 当不为'COM:' AT+QFTPPUT=,[,] 或者 +CME ERROR: 响应 OK 若文件上传成功： +QFTPPUT: 0, 若文件上传失败： +QFTPPUT: , 最大响应时间 特性说明 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 18 / 51 LTE Standard(U)系列 FTP(S)应用指导 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 字符串类型。本地文件名称。最大长度为 63 字节。若该值为'COM:'，将 COM 口输入的文件上传至 FTP 服务器。否则，将指定的文件上传至 FTP 服务器。详细信息可参考文档 [4]。 整型。上传文件的起始位置。范围：0~4294967295。默认值：0。若指定 和，则表示继续上传到同一文件的数据位置。 整型。上传的数据长度。仅当为'COM:'时有效。当通过 COM 口上 传的数据长度达到时，模块将退出数据模式。范围：1~4294967295。 单位：字节。 整型。上传的数据是否是最后一包。仅当为'COM:'时有效。 0 不是最后一包数据。当数据长度达到，模块将退出数据模式并响 应+QFTPPUT: 0,。此时，请勿断开数据连接，因为剩余的数据 需要上传到 FTP 上的同一文件。 1 最后一包数据。当数据长度达到，模块将退出数据模式，此时可 关闭数据连接，将响应+QFTPPUT: 0,。 整型。成功传输数据的长度。单位：字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 备注 若省略和，将上传所有数据至 FTP(S)服务器。 举例 //通过 COM 口将文件上传到 FTP(S)服务器。 AT+QFTPPUT='test.txt','COM:',0 CONNECT OK //在 FTP(S)服务器上将所有数据保存为 test.txt。 +QFTPPUT: 0,1000 //通过 COM 口分两次将文件上传至 FTP(S)服务器，每次上传 1024 字节。 AT+QFTPPUT='test.txt','COM:',0,1024,0 //非 test.txt 文件最后 1024 字节数据。 CONNECT OK //数据长度达到 1024 字节。 +QFTPPUT: 0,1024 上海移远通信技术股份有限公司 19 / 51 LTE Standard(U)系列 FTP(S)应用指导 AT+QFTPPUT='test.txt','COM:',1024,1024,1 CONNECT OK +QFTPPUT: 0,1024 //上传文件至 UFS。 AT+QFUPL='UFS:test1.txt',1000,300,1 CONNECT +QFUPL: 1000,707 OK AT+QFLST='UFS:*' +QFLST: 'UFS:test1.txt',1000 OK AT+QFTPPUT='test.txt','UFS:test1.txt',0 OK +QFTPPUT: 0,1000 AT+QFDEL='UFS:test1.txt' OK //test.txt 文件最后 1024 字节数据。 //数据长度达到 1024 字节。 //上传文件至 UFS，该文件被保存为 test1.txt。文件 大小为 1000 字节。超时时间为 300 秒，处于 ACK 模式。详细信息可参考文档 [4]。 //上传 UFS:test1.txt 文件至 FTP(S)服务器，文件在 FTP(S)服务器上被保存为 test.txt。 2.6. AT+QFTPGET 从 FTP(S)服务器下载文件 该命令用于从 FTP(S)服务器下载文件。通过设置 AT+QFTPGET='filename','COM:'文件可从 COM 口输出。模块从服务器接收数据时将进入数据模式。数据传输完成后，模块将自动退出数据模式并输出 +QFTPGET: 0, 。 通 过 AT+QFTPGET='filename','UFS:localname' 或 AT+QFTPGET='filename','SD:localname'可将文件保存至 UFS 或 SD 卡。文件传输成功后，模块将响 应+QFTPGET: 0,。 若为'COM:'，应在 AT+QFTPCFG 配置的时间内响应 CONNECT；若 不为'COM:'，将先响应 OK，数据传输完成后才会响应+QFTPGET: 0,或者 +QFTPGET: ,。 若模块进入数据模式或不为'COM:'，AT+QFTPCFG 配置的则表示接收或发 送两包数据之间的最大时间间隔。 上海移远通信技术股份有限公司 20 / 51 LTE Standard(U)系列 FTP(S)应用指导 AT+QFTPGET 从 FTP(S)服务器下载文件 测试命令 响应 AT+QFTPGET=? +QFTPGET: ,,, 设置命令 当为'COM:' AT+QFTPGET=,[,[,]] OK 响应 CONNECT OK 若文件下载成功： +QFTPGET: 0, 若文件下载失败： +QFTPGET: , 设置命令 当不为'COM:' AT+QFTPGET=,[,] 或者 +CME ERROR: 响应 OK 若文件下载成功： +QFTPGET: 0, 若文件下载失败： +QFTPGET: , 最大响应时间 特性说明 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 字符串类型。本地文件名称。最大长度为 63 字节。若该值为'COM:'，将在 COM 口输 出数据。否则，数据将被保存至 UFS 或 SD 卡。建议将其保存在 UFS 或 SD 卡。之后 可通过 AT+QFREAD 读取文件。详情参见文档 [4]。 整型。要上传的文件的起始位置。范围：0~4294967295；默认值：0；单位：字节。 整型。下载的数据长度。仅当为'COM:'时有效。若指定该参数，模块 上海移远通信技术股份有限公司 21 / 51 LTE Standard(U)系列 FTP(S)应用指导 将输出字节至 COM 口并退出数据模式。若有剩余数据，则可以通过 同一 AT 命令从处下载数据。范围：1~4294967295；单位：字节。 整型。成功传输数据的长度。单位：字节。若传输数据少于，表示成 功传输整个文件。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 备注 当为'COM:'时，若省略和，将从 FTP(S)服务器下载整个文 件。 举例 //通过 COM 口下载文件。 AT+QFTPGET='test.txt','COM:',0 CONNECT OK //从 FTP(S)服务器下载整个文件。 +QFTPGET: 0,1000 //下载文件，通过 COM 口分两次输出数据，每次 500 字节。 AT+QFTPGET='test.txt','COM:',0,500 //test.txt 文件大小为 1000 字节数据，首次下载 500 字节。 CONNECT OK +QFTPGET: 0,500 AT+QFTPGET='test.txt','COM:',500,500 CONNECT OK //下载剩余 500 字节。 +QFTPGET: 0,500 //下载文件并保存至 UFS。 AT+QFTPGET='test.txt','UFS:test2.txt',0 OK +QFTPGET: 0,1000 AT+QFLST='UFS:*' +QFLST: 'UFS:test2.txt',1000 上海移远通信技术股份有限公司 22 / 51 LTE Standard(U)系列 FTP(S)应用指导 OK 2.7. AT+QFTPSIZE 获取 FTP(S)服务器文件大小 该命令用于获取 FTP(S)服务器文件大小。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPSIZE: 0,或者+QFTPSIZE: ,，否则应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPSIZE 获取 FTP(S)服务器文件大小 测试命令 响应 AT+QFTPSIZE=? +QFTPSIZE: 设置命令 AT+QFTPSIZE= OK 响应 OK 若文件大小获取成功： +QFTPSIZE: 0, 若文件大小获取失败： +QFTPSIZE: , 最大响应时间 特性说明 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 整型。FTP(S)服务器文件大小。单位：字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供 参考。详细信息可参考第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 23 / 51 LTE Standard(U)系列 FTP(S)应用指导 2.8. AT+QFTPDEL 删除 FTP(S)服务器文件 该命令用于删除指定 FTP(S)服务器文件。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPDEL: ,，否则应断开 FTP(S)连接，并去激活后重新 激活网络。 AT+QFTPDEL 删除 FTP(S)服务器文件 测试命令 响应 AT+QFTPDEL=? +QFTPDEL: 设置命令 AT+QFTPDEL= OK 响应 OK 最大响应时间 特性说明 +QFTPDEL: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.9. AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 该命令用于在 FTP(S)服务器创建文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPMKDIR: ,，否则应断开 FTP(S)连接，并去激活后重 新激活网络。 AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 测试命令 响应 AT+QFTPMKDIR=? +QFTPMKDIR: OK 上海移远通信技术股份有限公司 24 / 51 设置命令 AT+QFTPMKDIR= 最大响应时间 特性说明 LTE Standard(U)系列 FTP(S)应用指导 响应 OK +QFTPMKDIR: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.10. AT+QFTPRMDIR 删除 FTP(S)服务器文件夹 该命令用于在 FTP(S)服务器删除指定文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPRMDIR: ,，否则应断开 FTP(S)连接，并去激活后重 新激活网络。 AT+QFTPRMDIR 删除 FTP(S)服务器文件夹 测试命令 响应 AT+QFTPRMDIR=? +QFTPRMDIR: 设置命令 AT+QFTPRMDIR= OK 响应 OK 最大响应时间 特性说明 +QFTPRMDIR: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 上海移远通信技术股份有限公司 25 / 51 LTE Standard(U)系列 FTP(S)应用指导 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参 考。详细信息可参考第 6 章。若为 0，则无效。 2.11. AT+QFTPLIST 获取 FTP(S)服务器目录内容 该命令用于获取 FTP(S)服务器目录内容。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，服务器目录内容传输 完成后响应+QFTPLIST: 0,或者+QFTPLIST: ,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接收 或发送两包数据之间的最大时间间隔。 AT+QFTPLIST 获取 FTP(S)服务器目录内容 测试命令 响应 AT+QFTPLIST=? +QFTPLIST: , 设置命令 当为'COM:' AT+QFTPLIST=[,] OK 响应 CONNECT OK 若获取服务器目录内容获取成功： +QFTPLIST: 0, 若获取服务器目录内容获取失败： +QFTPLIST: , 设置命令 当不为'COM:' AT+QFTPLIST=, 或者 +CME ERROR: 响应 OK 若获取服务器目录内容获取成功： +QFTPLIST: 0, 若获取服务器目录内容获取失败： +QFTPLIST: , 上海移远通信技术股份有限公司 26 / 51 LTE Standard(U)系列 FTP(S)应用指导 最大响应时间 特性说明 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'，将获 取由 AT+QFTPCWD 配置的当前目录内容。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 63 字节。默认值 为'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 UFS 或 SD。之后可通过 AT+QFREAD 读取文件，详请参见文档 [4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 //在 FTP(S)服务器上获取当前目录的内容，并通过 COM 口输出数据。 AT+QFTPLIST='.' CONNECT OK +QFTPLIST: 0,1000 //获取 FTP(S)服务器上指定目录的内容并将其保存到 UFS。 AT+QFTPLIST='TESTDIR','UFS:test2.txt' OK +QFTPLIST: 0,1000 AT+QFLST='UFS:*' +QFLST: 'UFS:test2.txt',1000 OK 上海移远通信技术股份有限公司 27 / 51 LTE Standard(U)系列 FTP(S)应用指导 2.12. AT+QFTPNLST 获取 FTP(S)服务器目录文件名 该命令用于获取 FTP(S)服务器目录文件名。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，文件名称传输完成后 响应+QFTPNLST: 0,或者+QFTPNLST: ,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接收 或发送两包数据之间的最大时间间隔。 AT+QFTPNLIST 获取 FTP(S)服务器目录文件名 测试命令 响应 AT+QFTPNLST=? +QFTPNLST: , 设置命令 当为'COM:' AT+QFTPNLST=[, ] OK 响应 CONNECT OK 若文件名获取成功： +QFTPNLST: 0, 若文件名获取失败： +QFTPNLST: , 设置命令 当不为'COM:' AT+QFTPNLST=, 或者 +CME ERROR: 响应 OK 若文件名获取成功： +QFTPNLST: 0, 若获取文件名失败： +QFTPNLST: , 最大响应时间 特性说明 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 28 / 51 LTE Standard(U)系列 FTP(S)应用指导 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'，将获取 由 AT+QFTPCWD 配置的当前目录的文件名。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 63 字节。默认值 为'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 UFS 或 SD。之后可通过 AT+QFREAD 读取文件，详请参见文档 [4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 //在 FTP(S)服务器上获取当前目录文件名，并通过 COM 口输出数据。 AT+QFTPNLST='.' CONNECT OK +QFTPNLST: 0,1000 //获取 FTP(S)服务器上指定目录文件名并将其保存到 UFS。 AT+QFTPNLST='TESTDIR','UFS:test2.txt' OK +QFTPNLST: 0,1000 AT+QFLST='UFS:*' +QFLST: 'UFS:test2.txt',1000 OK 2.13. AT+QFTPMLSD 获取标准化文件和目录信息 该命令用于获取标准化文件和目录信息。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，标准化文件和目录信 息传输完成后响应+QFTPMLSD: 0,或者+QFTPMLSD: ,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接收 或发送两包数据之间的最大时间间隔。 上海移远通信技术股份有限公司 29 / 51 LTE Standard(U)系列 FTP(S)应用指导 AT+QFTPMLSD 获取标准化文件和目录信息 测试命令 响应 AT+QFTPMLSD=? +QFTPMLSD: , 设置命令 当为'COM:' AT+QFTPMLSD=[,] OK 响应 CONNECT OK 若标准化文件和目录信息获取成功： +QFTPMLSD: 0, 若标准化文件和目录信息获取失败： +QFTPMLSD: , 设置命令 当不为'COM:' AT+QFTPMLSD=, 或者 +CME ERROR: 响应 OK 若标准化文件和目录信息获取成功： +QFTPMLSD: 0, 若标准化文件和目录信息获取失败： +QFTPMLSD: , 最大响应时间 特性说明 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'，将获取 由 AT+QFTPCWD 配置的标准化文件和目录信息。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 63 字节。默认值 为'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 UFS 或 SD。之后可通过 AT+QFREAD 读取文件，详请参见文档 [4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 上海移远通信技术股份有限公司 30 / 51 LTE Standard(U)系列 FTP(S)应用指导 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 //在 FTP(S)服务器上获取标准化文件和目录信息，并通过 COM 口输出数据。 AT+QFTPMLSD='.' CONNECT OK +QFTPMLSD: 0,1000 //获取 FTP(S)服务器上标准化文件和目录信息并将其保存到 UFS。 AT+QFTPMLSD='TESTDIR','UFS:test2.txt' OK +QFTPMLSD: 0,1000 AT+QFLST='UFS:*' +QFLST: 'UFS:test2.txt',1000 OK 2.14. AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 该命令用于获取 FTP(S)服务器文件修改时间。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPMDTM: 0,或者+QFTPMDTM: ,。否 则应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 测试命令 响应 AT+QFTPMDTM=? +QFTPMDTM: 设置命令 AT+QFTPMDTM= OK 响应 OK 若获取成功： +QFTPMDTM: 0, 若获取失败： +QFTPMDTM: , 上海移远通信技术股份有限公司 31 / 51 最大响应时间 特性说明 LTE Standard(U)系列 FTP(S)应用指导 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件名。最大长度为 255 字节。 字 符 串 类 型 。 FTP(S) 服 务 器 文 件 修 改 时 间 。 格 式 为 'YYYYMMDDHHMMSS' 或 'YYYYMMDDHHMMSS.NNN'。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.15. AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹 该命令用于重命名 FTP(S)服务器文件或文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPRENAME: ,。否则应断开 FTP(S)连接，并去激活后 重新激活网络。 AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹 测试命令 响应 AT+QFTPRENAME=? +QFTPRENAME: , 设置命令 AT+QFTPRENAME=, 最大响应时间 特性说明 OK 响应 OK +QFTPRENAME: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 上海移远通信技术股份有限公司 32 / 51 LTE Standard(U)系列 FTP(S)应用指导 参数 字符串类型。FTP(S)服务器旧文件名或旧文件夹名称。最大长度为 255 字节。 字符串类型。FTP(S)服务器新文件名或新文件夹名称。最大长度为 255 字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.16. AT+QFTPLEN 获取传输数据长度 该命令用于获取 FTP(S)服务器传输数据长度。 AT+QFTPLEN 获取传输数据长度 测试命令 响应 AT+QFTPLEN=? 执行命令 OK 响应 AT+QFTPLEN OK 最大响应时间 特性说明 +QFTPLEN: 0, 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 整 型 。 FTP(S) 服 务 器 传 输 数 据 长 度 。 执 行 AT+QFTPPUT 、 AT+QFTPGET 、 AT+QFTPNLST 或 AT+QFTPLIST 命令时，可使用 AT+QFTPLEN 查询传输数据长度。 单位：字节。 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 上海移远通信技术股份有限公司 33 / 51 LTE Standard(U)系列 FTP(S)应用指导 2.17. AT+QFTPSTAT 获取 FTP(S)服务器状态 该命令用于获取 FTP(S)服务器状态。 AT+QFTPSTAT 获取 FTP(S)服务器状态 测试命令 响应 AT+QFTPSTAT=? 执行命令 OK 响应 AT+QFTPSTAT OK 最大响应时间 特性说明 +QFTPSTAT: 0, 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 整型。当前 FTP(S)服务器状态。 0 正在开启 FTP(S)服务器 1 FTP(S)服务器开启并处于空闲状态 2 FTP(S)服务器正在传输数据 3 正在关闭 FTP(S)服务器 4 FTP(S)服务器已关闭 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 2.18. AT+QFTPCLOSE 退出 FTP(S)服务器 该命令用于退出 FTP(S)服务器。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的时间 内响应+QFTPCLOSE: ,。否则应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPCLOSE 退出 FTP(S)服务器 测试命令 响应 AT+QFTPCLOSE=? 执行命令 OK 响应 AT+QFTPCLOSE OK +QFTPCLOSE: , 或者 上海移远通信技术股份有限公司 34 / 51 LTE Standard(U)系列 FTP(S)应用指导 最大响应时间 特性说明 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效； 参数配置不保存。 参数 0 表示操作成功，其他值表示错误。详细信息可参考第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 35 / 51 LTE Standard(U)系列 FTP(S)应用指导 3 举例 3.1. 登录 FTP 服务器 //第一步：配置和激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK AT+QFTPCFG='contextid',1 OK //第二步：配置用户账号和传输设置。 AT+QFTPCFG='account','test','test' OK AT+QFTPCFG='filetype',1 OK AT+QFTPCFG='transmode',1 OK AT+QFTPCFG='rsptimeout',90 OK //第三步：登录 FTP 服务器。 AT+QFTPOPEN='quectel.3322.org',21 OK +QFTPOPEN: 0,0 //设置 PDP 上下文为 1，中国联通 APN 为'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 //设置 PDP 上下文为 1。必须先激活 PDP 上下文 ID。 //设置用户名和密码。 //设置文件类型为 ASCII。 //设置为被动传输方式。 //设置最大响应时间（默认为 90 秒）。 3.2. 登录 FTPS 服务器 //第一步：配置和激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',1 OK 上海移远通信技术股份有限公司 //设置 PDP 上下文为 1，中国联通 APN 为'UNINET'。 36 / 51 LTE Standard(U)系列 FTP(S)应用指导 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QFTPCFG='contextid',1 OK //第二步：配置用户账号和传输设置。 AT+QFTPCFG='account','test','test' OK AT+QFTPCFG='filetype',1 OK AT+QFTPCFG='transmode',1 OK AT+QFTPCFG='rsptimeout',90 OK //第三步：配置 FTPS。 AT+QFTPCFG='ssltype',1 OK AT+QFTPCFG='sslctxid',1 OK AT+QSSLCFG='ciphersuite',1,0xffff OK AT+QSSLCFG='seclevel',1,0 OK AT+QSSLCFG='sslversion',1,1 OK //第四步：登录 FTPS 服务器。 AT+QFTPOPEN='quectel.3322.org',990 OK //设置 PDP 上下文为 1。必须先激活 PDP 上下文 ID。 //设置用户名和密码。 //设置文件类型为 ASCII。 //设置被动传输方式。 //设置最大响应时间（默认为 90 秒）。 //设置 SSL 类型为 1，模块作为 FTPS 客户端。 //设置 SSL 上下文为 1。 //设置 SSL 加密套件类型为 0xffff，支持所有加密套件类型。 //设置 SSL 安全类型为 0，即不需要 SSL CA 证书。 //设置 SSL 版本为 1，表示 TLS1.0。 +QFTPOPEN: 0,0 3.3. 文件夹操作 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPPWD OK +QFTPPWD: 0,/ 上海移远通信技术股份有限公司 //设置当前目录。 //查询当前目录。 37 / 51 AT+QFTPMKDIR='TEST' OK +QFTPMKDIR: 0,0 AT+QFTPRENAME='TEST','TEST_NEW' OK +QFTPRENAME: 0,0 AT+QFTPRMDIR='TEST_NEW' OK +QFTPRMDIR: 0,0 LTE Standard(U)系列 FTP(S)应用指导 //在 FTP(S)服务器创建名为 TEST 的文件夹。 //重命名文件夹为 TEST_NEW。 //删除文件夹 TEST_NEW。 3.4. 文件操作 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPPWD OK +QFTPPWD: 0,'/' AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE:0, 1000 AT+QFTPRENAME='test_my1.txt','test_new.txt' OK +QFTPRENAME: 0,0 AT+QFTPMDTM='test_new.txt' OK +QFTPMDTM: 0,'20140708110039' AT+QFTPDEL='test_new.txt' OK +QFTPDEL: 0,0 //设置当前目录。 //查询当前目录。 //查询 FTP(S)服务器 test_my1.txt 文件大小。 //重命名文件为 test_new.txt。 //获取 FTP(S)服务器上的 test_new.txt 文件修 改时间。 //删除 FTP(S)服务器上的 test_new.txt 文件。 上海移远通信技术股份有限公司 38 / 51 LTE Standard(U)系列 FTP(S)应用指导 3.5. 获取文件信息或文件名 AT+QFTPCWD='/' OK //设置当前目录。 +QFTPCWD: 0,0 AT+QFTPLIST='.' CONNECT OK //获取当前目录的内容，并通过 COM 口输出数据。 +QFTPLIST: 0,1000 AT+QFTPLIST='.','UFS:list.txt' OK //获取当前目录的内容，并通过 UFS:list.txt 输出数据。 +QFTPLIST: 0,1000 AT+QFTPLIST='TEST_2','COM:' CONNECT OK //获取 TEST_2 文件内容，并通过 COM 口输出数据。 +QFTPLIST: 0,1000 AT+QFTPNLST='.' CONNECT OK //获取当前目录的文件名，并通过 COM 口输出数据。 +QFTPNLST: 0,1000 AT+QFTPNLST='.','UFS:nlst.txt' OK //获取当前目录的文件名，并通过 UFS:nlst.txt 输出数据。 +QFTPNLST: 0,1000 AT+QFTPNLST='TEST_2','COM:' CONNECT OK //获取 TEST_2 文件名称，并通过 COM 口输出数据。 +QFTPNLST: 0,1000 AT+QFTPMLSD='.' CONNECT OK //获取当前目录的标准化文件和目录信息，并通过 COM 口输 出数据。 上海移远通信技术股份有限公司 39 / 51 LTE Standard(U)系列 FTP(S)应用指导 +QFTPMLSD: 0,1000 AT+QFTPMLSD='.','UFS:nlst.txt' OK //获取当前目录的标准化文件和目录信息，并通过 UFS:nlst.txt 输出数据。 +QFTPMLSD: 0,1000 AT+QFTPMLSD='TEST_2','COM:' CONNECT OK //获取 TEST_2 的标准化文件和目录信息，并通过 COM 口输出 数据。 +QFTPMLSD: 0,1000 3.6. 上传文件至 FTP(S)服务器 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPSTAT +QFTPSTAT: 0,1 OK //通过 COM 口上传文件 AT+QFTPPUT='test_my1.txt','COM:',0 CONNECT OK //所有数据在 FTP(S)服务器上被保存为 test_my1.txt。 +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 //通过 COM 口上传文件，起始位置为 1000。 上海移远通信技术股份有限公司 40 / 51 LTE Standard(U)系列 FTP(S)应用指导 AT+QFTPPUT='test_my1.txt','COM:',1000 CONNECT OK //所有数据在 FTP(S)服务器上被保存为 test_my1.txt。 +QFTPPUT: 0,500 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1500 //方案 1：通过 COM 口上传两次文件至 FTP(S)服务器，每次上传 1024 字节数据。 AT+QFTPPUT='test_my1.txt','COM:',0,1024,0 //非 test_my1.txt 最后一包 1024 字节数据。 CONNECT OK //数据长度达到 1024 字节。 +QFTPPUT: 0,1024 AT+QFTPPUT='test_my1.txt','COM:',1024,1024,1 CONNECT OK //test_my1.txt 最后一包 1024 字节数据 //数据长度达到 1024 字节。 +QFTPPUT: 0,1024 //方案 2：从 UFS 上传文件至 FTP(S)服务器。 AT+QFUPL='UFS:test_ufs.txt',1000,300,1 CONNECT +QFUPL: 1000,707 //上传文件至 UFS，文件被保存为 test_ufs.txt。文 件大小为 1000 字节。超时时间为 300 秒。设置 为 ACK 模式。详细信息可参考文档 [4]。 OK AT+QFLST='UFS:*' +QFLST: 'UFS:test_ufs.txt',1000 OK AT+QFTPPUT='test_my1.txt','UFS:test_ufs.txt',0 OK //上传 UFS:test_ufs.txt 至 FTP(S)服务器，并将其 保存为 test_my1.txt。 +QFTPPUT: 0,1000 AT+QFDEL='UFS:test_ufs.txt' OK //删除本地 UFS 文件。 上海移远通信技术股份有限公司 41 / 51 LTE Standard(U)系列 FTP(S)应用指导 //方案 3：从 SD 卡上传文件至 FTP(S)服务器。 AT+QFUPL='SD:test_sd.txt',1000,300,1 CONNECT +QFUPL: 1000,707 //上传文件至 SD 卡，文件被保存为 test_sd.txt。 文件大小为 1000 字节。超时时间为 300 秒。设 置为 ACK 模式。详细信息可参考文档 [4]。 OK AT+QFLST=SD:*' +QFLST: 'SD:test_sd.txt',1000 OK AT+QFTPPUT='test_my1.txt','SD:test_sd.txt',0 OK //上传 SD:test_sd.txt 至 FTP(S)服务器，并将其 保存为 test_my1.txt。 +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 AT+QFDEL='SD:test_sd.txt' OK //删除本地 SD 卡文件。 3.7. 从 FTP(S)服务器下载文件 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 //方案 1：直接通过 COM 口输出下载数据。 //从 FTP(S)服务器下载文件，并通过 COM 输出数据。 AT+QFTPGET='test_my.txt','COM:' CONNECT OK 上海移远通信技术股份有限公司 42 / 51 LTE Standard(U)系列 FTP(S)应用指导 +QFTPGET: 0,1000 //下载文件，通过 COM 口分两次输出数据，每次 500 字节。 AT+QFTPGET='test.txt','COM:',0,500 //test.txt 文件大小为 1000 字节数据，首次下载 500 字节。 CONNECT OK +QFTPGET: 0,500 AT+QFTPGET='test.txt','COM:',500,500 CONNECT OK //下载剩余 500 字节。 +QFTPGET: 0,500 //方案 2：保存下载数据至 UFS。 //从 FTP(S)服务器下载文件并将其保存至 UFS。 AT+QFTPGET='test_my1.txt','UFS:test.txt' OK //下载文件并将其保存至 UFS，命名为 test.txt。 +QFTPGET: 0,1000 AT+QFLST='UFS:*' +QFLST: UFS:test.txt,1000 OK //从 FTP(S)服务器下载文件并将其保存至 UFS，起始位置为 450。 AT+QFTPGET='test_my1.txt','UFS:test1.txt',450 //下载文件并将其保存至 UFS，命名为 test.txt。 OK +QFTPGET: 0,550 AT+QFLST='UFS:*' +QFLST: UFS:test.txt,1000 +QFLST: UFS:test1.txt,550 //查询 UFS 内存储的文件及文件大小。 OK //方案 3：保存下载数据至 SD 卡。 //从 FTP(S)服务器下载文件并将其保存至 SD 卡。 AT+QFTPGET='test_my1.txt','SD:test.txt' OK //下载文件并将其保存至 SD 卡，命名为 test.txt。 +QFTPGET: 0,1000 AT+QFLST='SD:*' +QFLST: SD:test.txt,1000 上海移远通信技术股份有限公司 43 / 51 LTE Standard(U)系列 FTP(S)应用指导 OK //从 FTP(S)服务器下载文件并将其保存至 SD 卡，起始位置为 450。 AT+QFTPGET='test_my1.txt','SD:test1.txt',450 //下载文件并将其保存至 SD 卡，命名为 test.txt。 OK +QFTPGET: 0,550 AT+QFTPLEN OK +QFTPLEN: 0,550 AT+QFLST='SD:*' +QFLST: SD:test.txt,1000 +QFLST: SD:test1.txt,550 //查询 SD 卡内存储的文件及文件大小。 OK 3.8. 退出 FTP(S)服务器 AT+QFTPCLOSE OK +QFTPCLOSE: 0,0 AT+QIDEACT=1 OK //退出 FTP(S)服务器。 //去激活为 FTP(S)激活的 PDP 上下文。 上海移远通信技术股份有限公司 44 / 51 LTE Standard(U)系列 FTP(S)应用指导 4 常见问题处理 4.1. FTP(S) AT 命令执行失败 执行 FTP(S) AT 命令后，若返回 ERROR，请检查是否插入了(U)SIM 卡，并注意执行 AT+CPIN?后是 否返回了+CPIN: READY。 4.2. PDP 激活失败 若使用 AT+QIACT 激活 PDP 失败，请检查以下配置： 1. 通过 AT+CGATT?查询是否已经附着 PS 域。若未附着 PS 域，请先执行 AT+CGATT=1 命令附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保已注册了 PS 域。 3. 通过 AT+QICSGP 命令查询 PDP 上下文参数，并确保已设置了指定 PDP 上下文的 APN。 4. 确保 PPP 未使用指定的 PDP 上下文 ID，AT+CGACT 也未激活指定的 PDP 上下文 ID。 5. 模块在 VoLTE 功能下，最大可激活 5 路 PDP 场景；在非 VoLTE 功能下，最大可激活 7 路 PDP 场景，PDP 场景激活的个数取决于 SIM 卡。 若上述配置无误，但依然无法通过 AT+QIACT 成功激活 PDP 上下文，请重启模块。重启模块后，请 至少检查三次上述配置，每次间隔 10 分钟，以避免频繁重启模块。 4.3. DNS 解析失败 执行 AT+QFTPOPEN 后，若返回+QFTPOPEN: 604,0，请检查以下配置： 1. 确认 FTP(S)服务器域名有效。 2. 通过 AT+QIACT?查询 PDP 上下文状态，确保成功激活了指定的 PDP 上下文。 上海移远通信技术股份有限公司 45 / 51 LTE Standard(U)系列 FTP(S)应用指导 4.4. FTP(S)服务器响应错误 若+QFTPXX: ,中的不为 0，则该参数表示 FTP(S)服务器响 应的错误码。 用户可根据协议错误码检查 FTP(S)服务器响应的错误码。例如，若为 530（未登录）， 则表明或密码可能错误；若为 550（请求失败：文件不可用）， 则表明文件或目录不存在。详细信息可参考 RFC959。 上海移远通信技术股份有限公司 46 / 51 LTE Standard(U)系列 FTP(S)应用指导 5 错误码 表示与移动设备或网络有关的错误代码。相关详细信息参见下表。 表 3：错误码列表 错误码 0 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 英文含义 Operation successful Unknown error FTP(S) server blocked FTP(S) server busy DNS parse failed Network error Control connection closed. Data connection closed Socket closed by peer Timeout error Invalid parameter Failed to open file File position invalid File error Service not available, closing control connection Open data connection failed Connection closed; transfer aborted 中文含义 操作成功 未知错误 FTP(S)服务器不可用 FTP(S)服务器繁忙 DNS 解析错误 网络错误 控制连接关闭 数据连接关闭 对端关闭 Socket 超时错误 无效参数 文件打开失败 文件位置无效 文件错误 服务不可用，关闭控制连接 数据连接打开失败 连接关闭，传输中止 上海移远通信技术股份有限公司 47 / 51 LTE Standard(U)系列 FTP(S)应用指导 617 Requested file action not taken 文件操作请求失败 618 Requested action aborted: local 请求中止：本地错误处理中 error in processing 619 Requested action not taken: 请求失败：系统空间不足 insufficient system storage 620 Syntax error, command 语句错误，无法命令识别 unrecognized 621 Syntax error in parameters or 语句错误，参数出错 arguments 622 Command not implemented 未执行命令 623 Bad sequence of commands 命令顺序有误 624 Command parameter not 未输入命令参数 implemented 625 Not logged in 未登录 626 Need account for storing files 需要能存储文件的账号 627 Requested action not taken 请求失败 628 Requested action aborted: 请求中止：未知网页类型 page type unknown 629 Requested file action aborted 文件操作请求失败 630 Requested file name invalid 请求的文件名无效 631 SSL authentication failed SSL 鉴权失败 632 Source IP address for 用于传输的源 IP 地址无法使用 transmission cannot use 633 Send data failed 发送数据失败 634 Receive data failed 接收数据失败 上海移远通信技术股份有限公司 48 / 51 LTE Standard(U)系列 FTP(S)应用指导 6 FTP(S)协议错误码 协议错误码表示 FTP(S)服务器响应的错误码。详细信息可参考 RFC959。下表描述 了部分常见错误码。 表 4：FTP(S)协议错误码列表 英文含义 Service not available, closing control 421 connection 425 Open data connection failed 中文含义 服务不可用，关闭控制连接 打开数据连接失败 426 Connection closed; transfer aborted 连接关闭；传输中止 450 Requested file action not taken 文件操作请求失败 451 Requested action aborted: local error in 请求中间：本地错误处理中 processing 452 Requested action not taken: insufficient 请求失败：系统空间不足 system storage 500 Syntax error, command unrecognized 语句错误，无法命令识别 501 Syntax error in parameters or arguments 参数语句错误 502 Command not implemented 未执行命令 503 Bad sequence of commands 命令顺序有误 504 Command parameter not implemented 未输入参数 530 Not logged in 未登录 532 Need account for storing files 需要能存储文件的账号 550 Requested action not taken: file 请求失败：文件不可用 unavailable 551 Requested action aborted: page type 请求中止：未知网页类型 unknown 552 Requested file action aborted: exceeded 文件操作请求中止：存储空间分配过量 storage allocation 553 Requested action not taken: file name not 请求失败：不允许的文件名 allowed 上海移远通信技术股份有限公司 49 / 51 LTE Standard(U)系列 FTP(S)应用指导 7 附录 参考文档和术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_TCP(IP)_应用指导 [2] Quectel_LTE_Standard(U)系列_AT 命令手册 [3] Quectel_LTE_Standard(U)系列_SSL_应用指导 [4] Quectel_LTE_Standard(U)系列_FILE_应用指导 表 6：术语缩写 缩写 ACK APN ASCII DNS DTR FTP FTPS ID IP PDP 英文全称 中文全称 Acknowledgement 确认消息 Access Point Name 接入点名称 American Standard Code for Information Interchange 美国信息交换标准代码 Domain Name Server 域名服务器 Data Terminal Ready 数据终端就绪 File Transfer Protocol FTP over SSL/FTP Secure Identifier 文件传输协议 对常用的文件传输协议（FTP） 添加传输层安全（TLS）和安全 套接层（SSL）加密协议支持的 扩展协议 标识符 Internet Protocol 互联网协议 Packet Data Protocol 分组数据协议 上海移远通信技术股份有限公司 50 / 51 PPP PS QoS SD SSL TLS UFS URC (U)SIM VoLTE Point-to-Point Protocol Packet Switching Quality of Service Secure Digital Secure Sockets Layer Transport Layer Security Universal Flash Storage Unsolicited Result Code (Universal) Subscriber Identity Module Voice over Long-Term Evolution LTE Standard(U)系列 FTP(S)应用指导 点对点协议 数据转换 服务质量 安全数码卡 安全套接层 安全传输层协议 通用闪存存储 未经请求的结果码 全球用户识别卡 长期演进语音承载 上海移远通信技术股份有限公司 51 / 51

LTE Standard(U)系列 FOTA 应用指导 LTE Standard 模块系列 版本：1.3 日期：2023-06-21 状态：受控文件 LTE Standard(U)系列 FOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 26 LTE Standard(U)系列 FOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 26 LTE Standard(U)系列 FOTA 应用指导 文档历史 修订记录 版本 日期 作者 - 2020-12-21 Fei XUE 1.0 2021-03-04 Fei XUE 1.1 2021-11-08 Fei XUE 1.2 2022-11-28 Mahat XU 1.3 2023-06-21 Loft XU 变更表述 文档创建 受控版本 1. 新增适用模块 EG915U 系列； 2. 新增目标固件包存储在外部 MCU 的描述（第 2 章）； 3. 新增配置目标固件包存放在模块的存储媒介（第 2.3 章）； 4. 新增 AT 命令的最大响应时间； 5. 更新错误码（第 4 章）。 1. 新增适用模块 EC200D 系列、EC200G-CN、EC600G-CN、 EC800G-CN、EG700G-CN 和 EG912U-GL。 2. 新增 EC200D 系列模块暂不支持 AT+QCFG='fota/path'的备 注； 新增 EC200D 系列模块暂不支持将升级固件放置在外置 Flash 的备注（第 2.3 章）。 3. 新增 EC200D 系列模块暂不支持 AT+QCFG='fota/cid'配置 PDP 上下文 ID 的备注（第 3.3.1.1 章）。 1. 更新适用模块： 新增 EG800G 系列； 更新 EC600G-CN 为 EC600G 系列。 2. 删除 EC200D 系列模块暂不支持 AT+QCFG='fota/path'的备 注（第 2.3 章）。 3. 新增模块暂不支持通过 USB AT 口上报升级进度 URC 的备注 （第 3.3.1 章）。 4. 删除 EC200D 系列模块暂不支持 AT+QCFG='fota/cid'配置 PDP 上下文 ID 的备注。 5. 新增 FILE 值描述（表 6）。 上海移远通信技术股份有限公司 3 / 26 LTE Standard(U)系列 FOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 FOTA 固件升级流程.............................................................................................................................. 7 2.1. 获取目标固件包 .......................................................................................................................... 8 2.2. 存储目标固件包至 FTP/HTTP(S)服务器或外部 MCU ................................................................ 8 2.3. 配置目标固件包存放在模块的存储媒介...................................................................................... 8 2.4. 执行 AT 命令升级固件 ................................................................................................................ 9 3 FOTA 相关 AT 命令详解 ..................................................................................................................... 10 3.1. AT 命令语句.............................................................................................................................. 10 3.1.1. 定义 ............................................................................................................................... 10 3.1.2. AT 命令语句................................................................................................................... 10 3.2. AT 示例声明...............................................................................................................................11 3.3. AT 命令详解...............................................................................................................................11 3.3.1. AT+QFOTADL 通过 FOTA 升级固件 ...........................................................................11 3.3.1.1. AT+QFOTADL= 目标固件包存储至 FTP 服务器时升级固件........... 12 3.3.1.2. AT+QFOTADL= 目标固件包存储至 HTTP(S)服务器时升级固件 . 14 3.3.1.3. AT+QFOTADL='FILE:' 目标固件包存储至外部 MCU 时升级固件........ 16 4 错误码 ................................................................................................................................................. 19 5 附录 参考文档及术语缩写 .................................................................................................................. 25 上海移远通信技术股份有限公司 4 / 26 LTE Standard(U)系列 FOTA 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型...................................................................................................................................... 10 表 3：FOTA 值描述............................................................................................................................ 19 表 4：FTP 值描述 .............................................................................................................................. 20 表 5：HTTP(S) 值描述 ...................................................................................................................... 22 表 6：FILE 值描述 ............................................................................................................................. 22 表 7：数据拨号值描述 ....................................................................................................................... 23 表 8：参考文档 ........................................................................................................................................... 25 表 9：术语缩写 ........................................................................................................................................... 25 上海移远通信技术股份有限公司 5 / 26 LTE Standard(U)系列 FOTA 应用指导 1 引言 移远通信 LTE Standard(U)系列模块支持空中固件升级（FOTA）功能，此功能可以实现模块固件包的 无线升级或降级。 1.1. 适用模块 表 1：适用模块 模块系列 ECx00G ECx00U EGx00G EGx00U EG91xU 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG700G-CN EG800G 系列 EG500U-CN EG700U-CN EG912U-GL EG915U 系列 上海移远通信技术股份有限公司 6 / 26 LTE Standard(U)系列 FOTA 应用指导 2 FOTA 固件升级流程 下图阐述了 FOTA 升级固件的流程。 2. 将目标固件包放在FTP/HTTP(S) 服务 器或外 部MC U FTP/HTTP(S) 服务 器 1. 获取目标固件包 LT E/W CD MA/GSM (FTP/HTTP(S)) 4. 通过LTE/WCDMA/GSM网 络从 FTP/H TTP(S)服务 器自 动下 载目标 固件包 ，或从 外 部MC U处接 收目标 固件包 外部 MCU 3. 执行AT+QFOTADL命令 移远通信 模块 5. 自动升级模块 固件 图 1：FOTA 固件升级流程 如上图所示，客户仅需操作如下步骤即可通过 FOTA 升级固件： 第一步：从移远通信获取目标固件包； 第二步：将目标固件包放到 FTP/HTTP(S)服务器或者外部 MCU； 第三步：执行 AT+QFOTADL； 第四步：执行 AT+QFOTADL 后，模块将自动通过 LTE/WCDMA/GSM 网络从 FTP/HTTP(S)服务器下 载目标固件包或从外部 MCU 处接收目标固件包； 第五步：模块固件自动升级。 上海移远通信技术股份有限公司 7 / 26 LTE Standard(U)系列 FOTA 应用指导 备注 FOTA 升级过程中，必须确保模块已通电，否则可能导致 FOTA 升级失败且无法还原。 2.1. 获取目标固件包 升级之前，客户需先通过 ATI 获取当前固件版本，同时确认目标固件版本；然后将当前版本和目标版 本信息发送给移远通信或模块代理商以获取相应的目标固件包。 2.2. 存储目标固件包至 FTP/HTTP(S)服务器或外部 MCU 目标固件包存储至 FTP/HTTP(S)服务器的步骤如下： 第一步：客户搭建 FTP/HTTP(S)服务器以便使用 FOTA 功能（移远通信不提供该服务器）。 第二步：服务器搭建完成后，将目标固件包存储至服务器并记录存储路径。 目标固件包存储至外部 MCU 的路径由用户自行决定。 2.3. 配置目标固件包存放在模块的存储媒介 用户可以通过执行 AT+QCFG='fota/path'配置目标固件包存放在模块的存储媒介。该命令的参数配置 不保存，只作用于当前的 FOTA 升级。当 FOTA 升级完成或失败后，目标固件包在模块的存储媒介将恢复 为默认值：'UFS'。命令详情请参考文档 [1]。 当存储媒介为内置 Flash 和外置 Flash 时，存储路径支持设置子目录；当存储媒介为 SD 卡时，存储路 径只支持设置根目录。如果用户需更改目标固件包存放在模块的存储媒介，需要先执行 AT+QCFG='fota/path'配置存储媒介，再使用 AT+QFOTADL 命令。 备注 1. 有关适用模块存储媒介的支持情况，请参考文档 [2]。 2. EC200D 系列模块暂不支持将升级固件放置在外置 Flash。 上海移远通信技术股份有限公司 8 / 26 LTE Standard(U)系列 FOTA 应用指导 2.4. 执行 AT 命令升级固件 目标固件包存放至 FTP/HTTP(S)服务器或外部 MCU 后，执行 AT+QFOTADL，模块将从 FTP/HTTP(S) 服务器下载目标固件包或从外部 MCU 处接收目标固件包，并自动升级固件。详情请参考第 3.3.1 章。 上海移远通信技术股份有限公司 9 / 26 LTE Standard(U)系列 FOTA 应用指导 3 FOTA 相关 AT 命令详解 3.1. AT 命令语句 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 26 LTE Standard(U)系列 FOTA 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT 命令详解 3.3.1. AT+QFOTADL 通过 FOTA 升级固件 该命令用于使能模块通过 FOTA 自动进行固件升级。执行该命令前需确定目标固件包的存储媒介，存 储媒介默认为 UFS。若客户不使用默认存储媒介，则需参考第 2.3 章所述内容，配置固件包存储媒介。 执行此命令后，模块将自动从 FTP/HTTP(S)服务器下载目标固件包；下载完成后，模块会自动升级固 件。固件升级成功后，模块会自动重启。 若目标固件包储存在外部 MCU，该命令执行成功后，模块通过主串口或 USB AT 口从外部 MCU 处接 收固件包，然后自动升级固件。 AT+QFOTADL 通过 FOTA 升级固件 测试命令 AT+QFOTADL=? 响应 +QFOTADL: ,( 支 持 的 列 表 ),( 支 持 的 列表),(支持的列 表) 最大响应时间 特性说明 OK 40 毫秒 / 参数 字符串类型。存储至 FTP/HTTP(S)服务器或外部 MCU 目标固件包的 URL。 最大长度：255 字节。详情请参考第 3.3.1.1 章 ~ 3.3.1.3 章。 整型。成功下载目标固件包后的升级模式。 0 成功下载目标固件包后，先手动重启模块再自动升级固件 1 成功下载目标固件包后自动升级固件 整型。下载进度 URC。最后一条 URC 表示下载完成。例如：若设置为 50， 则会上报 50 条下载进度 URC，其中第 25 条 URC 表示下载完成一半，第 50 条 URC 表示下载完成。 上海移远通信技术股份有限公司 11 / 26 LTE Standard(U)系列 FOTA 应用指导 0 禁止上报下载进度 URC 5~100 下载进度 URC 的最大上报条数 整型。升级进度 URC。最后一条 URC 表示升级完成。例如：若设置为 50， 则会上报 50 条升级进度 URC，其中第 25 条 URC 表示升级完成一半，第 50 条 URC 表示升级完成。 0 禁止上报升级进度 URC 5~100 升级进度 URC 的最大上报条数 备注 模块暂不支持通过 USB AT 口上报升级进度 URC。 3.3.1.1. AT+QFOTADL= 目标固件包存储至 FTP 服务器时升级固件 该命令用于当目标固件包储存至 FTP 服务器时，使能模块通过 FOTA 自动进行固件升级。命令执行成 功后，模块将自动从 FTP 服务器下载目标固件包，并自动进行固件升级。 AT+QFOTADL= 目标固件包存储至 FTP 服务器时升级固件 设置命令 AT+QFOTADL=[,[,[,]]] 响应 OK +QIND: 'FOTA','FTPSTART' [+QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', …] +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','START' [+QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ...] +QIND: 'FOTA','END', 最大响应时间 特性说明 若有任何错误： ERROR 40 毫秒 / 上海移远通信技术股份有限公司 12 / 26 LTE Standard(U)系列 FOTA 应用指导 参数 字符串类型。最大长度：255 字节。该 URL 应以'FTP://'开头，例如： 'FTP://:@:/'。 字符串类型。用于鉴权的用户名。最大长度：50 字节。 字符串类型。用于鉴权的密码。最大长度：50 字节。 字符串类型。FTP 服务器的 IP 地址或域名。最大长度：50 字节。 整型。FTP 服务器端口。范围：1~65535；默认值：21。 字符串类型。FTP 服务器上目标固件包的文件名。最大长度：50 字节。目前 仅支持根目录存储。 整型。成功下载目标固件包后的升级模式。 0 成功下载目标固件包后，先手动重启模块再自动升级固件 1 成功下载目标固件包后自动升级固件 整型。下载进度 URC。最后一条 URC 表示下载完成。例如：若设置为 50， 则会上报 50 条下载进度 URC，其中第 25 条 URC 表示下载完成一半，第 50 条 URC 表示下载完成。 0 禁止上报下载进度 URC 5~100 下载进度 URC 的最大上报条数 整型。升级进度 URC。最后一条 URC 表示升级完成。例如：若设置为 50， 则会上报 50 条升级进度 URC，其中第 25 条 URC 表示升级完成一半，第 50 条 URC 表示升级完成。 0 禁止上报升级进度 URC 5~100 升级进度 URC 的最大上报条数 整型。下载或升级进度。 整型。0 表示成功，其他值表示错误。详情请参考第 4 章。 举例 //当目标固件包存储在 FTP 服务器时升级固件。 //FTP 服务器地址为'FTP://test:test@124.74.41.170:21/EC200UCNTCNMAR02A02M16.pack'。 //配置 PDP 上下文，该示例中使用 PDP 上下文 ID 为 2，详情请参考文档 [1]和文档 [3]。 AT+QICSGP=2,1,'cmnet','','',1 //配置 PDP 上下文 ID 为 2，APN 为'cmnet'（表示中国移动）， 用户名和密码为空，鉴权类型为 PAP。 OK AT+QCFG='fota/cid',2 //配置 PDP 上下文 ID 为 2。 OK //执行 AT+QFOTADL 使能通过 FOTA 自动升级固件，随后模块会自动下载目标固件包，并自动升级固件。 AT+QFOTADL='FTP://test:test@124.74.41.170:21/EC200UCNTCNMAR02A02M16.pack',1,50,100 OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','DOWNLOADING',2 +QIND: 'FOTA','DOWNLOADING',4 ... 上海移远通信技术股份有限公司 13 / 26 +QIND: 'FOTA','DOWNLOADING',100 +QIND: 'FOTA','FTPEND',0 //从 FTP 服务器下载目标固件包成功。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //固件升级成功。 LTE Standard(U)系列 FOTA 应用指导 3.3.1.2. AT+QFOTADL= 目标固件包存储至 HTTP(S)服务器时升级固件 该命令用于当目标固件包储存至 HTTP(S)服务器时，使能模块通过 FOTA 自动进行固件升级。命令执 行成功后，模块将自动从 HTTP(S)服务器下载目标固件包，并自动进行固件升级。 AT+QFOTADL= 目标固件包存储至 HTTP(S)服务器时升级固件 设置命令 AT+QFOTADL=[,[,[,< update_URC_max>]]] 响应 OK +QIND: 'FOTA','HTTPSTART' [+QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', …] +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' [+QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ...] +QIND: 'FOTA','END', 最大响应时间 特性说明 若有任何错误： ERROR 40 毫秒 / 参数 字符串类型。最大长度：255 字节。该 URL 应以'http://'或'https://'开头，例 如：'http://:/'。 字符串类型。HTTP(S)服务器的 IP 地址或域名。最大长度：50 字节。 整型。HTTP(S)服务器端口。范围：1~65535；默认值：80。 上海移远通信技术股份有限公司 14 / 26 LTE Standard(U)系列 FOTA 应用指导 字符串类型。HTTP(S)服务器上目标固件包的文件名。最大长度：50 字节。 整型。成功下载目标固件包后的升级模式。 0 成功下载目标固件包后，先手动重启模块再自动升级固件 1 成功下载目标固件包后自动升级固件 整型。下载进度 URC。最后一条 URC 表示下载完成。例如：若设置为 50， 则会上报 50 条下载进度 URC，其中第 25 条 URC 表示下载完成一半，第 50 条 URC 表示下载完成。 0 禁止上报下载进度 URC 5~100 下载进度 URC 的最大上报条数 整型。升级进度 URC。最后一条 URC 表示升级完成。例如：若设置为 50， 则会上报 50 条升级进度 URC，其中第 25 条 URC 表示升级完成一半，第 50 条 URC 表示升级完成。 0 禁止上报升级进度 URC 5~100 升级进度 URC 的最大上报条数 整型。下载或升级进度。 整型。0 表示成功，其他值表示错误。详情请参考第 4 章。 举例 //当目标固件包存储在 HTTP(S)服务器时升级固件。 //HTTP(S)服务器地址为'http://www.quectel.com:100/EC200UCNTCNMAR02A02M16.pack'。 //配置 PDP 上下文，该示例中使用 PDP 上下文 ID 为 2，详情请参考文档 [1]和文档 [3]。 AT+QICSGP=2,1,'cmnet','','',1 //配置 PDP 上下文 ID 为 2，APN 为'cmnet'（表示中国移动）， 用户名和密码为空，鉴权类型为 PAP。 OK AT+QCFG='fota/cid',2 //配置 PDP 上下文 ID 为 2。 OK //执行 AT+QFOTADL 使能通过 FOTA 自动升级固件，随后模块会自动下载目标固件包并自动升级固件。 AT+QFOTADL='http://www.quectel.com:100/EC200UCNTCNMAR02A02M16.pack',1,50,100 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING',2 +QIND: 'FOTA','DOWNLOADING',4 ... +QIND: 'FOTA','DOWNLOADING',100 +QIND: 'FOTA','HTTPEND',0 //从 HTTP(S)服务器下载目标固件包成功。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //固件升级成功。 上海移远通信技术股份有限公司 15 / 26 LTE Standard(U)系列 FOTA 应用指导 3.3.1.3. AT+QFOTADL='FILE:' 目标固件包存储至外部 MCU 时升级固件 该命令用于当目标固件包储存至外部 MCU 时进行固件升级。命令执行成功后，模块通过串口工具从外 部 MCU 处接收目标固件包，然后自动升级固件。 若客户使用主串口，执行 AT+QFOTADL='FILE:'前，用户需设置硬件流控。若未设置，主 机发送目标固件包的速度将受限。因此，建议每次发送目标固件包的长度控制在 32 个字节内。升级固件时 需按照如下步骤进行： 步骤 1：打开串口工具，选择主串口并设置硬件流控； 步骤 2：发送 AT+IFC=2,2 打开模块硬件流控； 步骤 3：从外部 MCU 上选择目标固件包； 步骤 4：执行 AT+QFOTADL='FILE:'[,[,[,]]]； 步骤 5：发送目标固件包至模块。 若客户使用 USB AT 口，升级固件时需按照如下步骤进行： 步骤 1：打开串口工具，选择 USB AT 口； 步骤 2：从外部 MCU 上选择目标固件包； 步骤 3：执行 AT+QFOTADL='FILE:'[,[,[,]]]； 步骤 4：发送目标固件包至模块。 AT+QFOTADL='FILE:' 目标固件包存储至外部 MCU 时升级固件 设置命令 响应 AT+QFOTADL='FILE:'[,[,[ ,]]] OK +QIND: 'FOTA','FILESTART' [+QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', …] +QIND: 'FOTA','FILEEND', +QIND: 'FOTA','START' [+QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ...] +QIND: 'FOTA','END', 最大响应时间 特性说明 若有任何错误： ERROR 40 毫秒 / 上海移远通信技术股份有限公司 16 / 26 LTE Standard(U)系列 FOTA 应用指导 参数 整型。目标固件包长度。单位：字节。 整型。成功下载目标固件包后的升级模式。 0 成功下载目标固件包后，先手动重启模块再自动升级固件 1 成功下载目标固件包后自动升级固件 整型。下载进度 URC。最后一条 URC 表示下载完成。例如：若设置为 50， 则会上报 50 条下载进度 URC，其中第 25 条 URC 表示下载完成一半，第 50 条 URC 表示下载完成。 0 禁止上报下载进度 URC 5~100 下载进度 URC 的最大上报条数 整型。升级进度 URC。最后一条 URC 表示升级完成。例如：若设置为 50， 则会上报 50 条升级进度 URC，其中第 25 条 URC 表示升级完成一半，第 50 条 URC 表示升级完成。 0 禁止上报升级进度 URC 5~100 升级进度 URC 的最大上报条数 整型。下载或升级进度。 整型。0 表示成功，其他值表示错误。详情请参考第 4 章。 备注 发送目标固件包之前，客户需先选择目标固件包以获取目标固件包的长度（即的取值），并通 过 AT+QFOTADL='FILE:'将目标固件包长度发送给模块，以判断模块是否有足够的存储空间。 举例 //当目标固件包存储至外部 MCU 时，采用 File 方式通过 USB AT 口升级固件。 AT+QFOTADL='FILE:1200',1,50,100 //目标固件包长度为 1200 字节。 OK +QIND: 'FOTA','FILESTART' //等待外部 MCU 通过串口工具发送目标固件包至模块。 +QIND: 'FOTA','DOWNLOADING',2 +QIND: 'FOTA','DOWNLOADING',4 ... +QIND: 'FOTA','DOWNLOADING',100 +QIND: 'FOTA','FILEEND',0 //下载成功后立即通过 FOTA 进行固件升级。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 上海移远通信技术股份有限公司 17 / 26 +QIND: 'FOTA','END',0 LTE Standard(U)系列 FOTA 应用指导 //固件升级成功。 上海移远通信技术股份有限公司 18 / 26 LTE Standard(U)系列 FOTA 应用指导 4 错误码 本章介绍了与移动设备和网络相关的错误码。 若调用 FOTA 功能时发生错误，错误码如下表所示： 表 3：FOTA 值描述 0 500 502 510 547 549 550 551 552 553 554 555 556 557 558 559 中文描述 FOTA 操作成功 FOTA 失败 FOTA 异常错误 FOTA 升级包校验或设置标志位失败 FOTA 升级包校验错误 FOTA 总线繁忙错误 FOTA 空指针 FOTA 参数无效 FOTA 输入 pack 包路径无效 FOTA NVM 重置 FOTA 更新包路径信息错误 FOTA NVM 保存 FOTA 更新包路径信息失败 FOTA NVM 删除 FOTA 更新包路径信息失败 FOTA NVM 读取 FOTA 更新包路径信息失败 FOTA 更新包路径字符串长度错误 FOTA 线程创建失败 FOTA 重复运行 上海移远通信技术股份有限公司 19 / 26 LTE Standard(U)系列 FOTA 应用指导 560 FOTA 下载模式不支持 561 FOTA URL 输入错误 562 FOTA FTP 句柄创建失败 563 FOTA FTP Curl 初始化失败 564 FOTA 文件下载模式中下载超出设置的大小 565 FOTA 文件下载模式中的定时器创建失败 566 FOTA 文件下载模式中定时器开始失败 567 FOTA 文件下载模式中下载超时 568 FOTA HTTP 的信号量创建失败 569 FOTA HTTP 请求包设置错误 570 FOTA HTTP Socket 异常 571 FOTA HTTP 操作异常 从 FTP 服务器下载目标固件包时发生错误，错误码如下表所示： 表 4：FTP 值描述 0 601 602 603 604 605 606 607 608 中文描述 FTP 下载成功且校验成功 FTP 未知错误 FTP 服务受阻 FTP 服务忙 DNS 解析失败 网络错误 控制连接关闭 数据连接关闭 对端关闭 Socket 上海移远通信技术股份有限公司 20 / 26 LTE Standard(U)系列 FOTA 应用指导 609 超时错误 610 无效参数 611 文件打开失败 612 文件路径错误 613 文件错误 614 服务不可用，正在关闭控制连接 615 打开数据连接失败 616 连接关闭，传输中止 617 文件操作请求失败 618 请求中止：处理时发生本地错误 619 请求失败：系统内存不足 620 语法错误，命令未识别 621 参数语法错误 622 未执行命令 623 命令顺序有误 624 未输入命令参数 625 登录 FTP 失败 626 存储文件需账号 627 请求操作未执行 628 请求中止：未知网页类型 629 请求文件操作中止 630 请求的文件名无效 631 SSL 鉴权失败 上海移远通信技术股份有限公司 21 / 26 LTE Standard(U)系列 FOTA 应用指导 从 HTTP(S)服务器下载目标固件包时发生错误，错误码如下表所示： 表 5：HTTP(S) 值描述 0 701 702 703 714 716 729 730 731 中文描述 HTTP(S)下载成功且校验成功 HTTP(S)未知错误 HTTP(S)超时 HTTP(S)繁忙 DNS 解析错误 HTTP(S) socket 连接错误 HTTP(S)内存分配错误 无效参数 HTTP(S)操作未处理完 从外部 MCU 下载目标固件包时发生错误，错误码如下表所示： 表 6：FILE 值描述 400 401 402 403 405 406 407 409 中文描述 输入值无效 文件过大 读取 0 字节 驱动器已满 未发现文件 无效文件名 文件已存在 写入文件失败 上海移远通信技术股份有限公司 22 / 26 LTE Standard(U)系列 FOTA 应用指导 410 打开文件失败 411 读取文件失败 413 达到允许打开的最大文件数 414 文件仅可读 415 获取文件大小失败 416 无效文件描述符 417 列举文件失败 418 删除文件失败 419 获取磁盘信息失败 420 空间不足 421 超时 423 文件过大 425 无效参数 426 文件已打开 若通过 FOTA 升级固件时出现数据拨号相关错误，错误码如下表所示： 表 7：数据拨号值描述 1 2 3 4 5 6 7 中文描述 数据拨号异常 内存地址为空 无效参数 网络注册超时失败 CFW 激活状态获取错误 重复激活 重复释放 上海移远通信技术股份有限公司 23 / 26 LTE Standard(U)系列 FOTA 应用指导 8 CFW PDP 的上下文设置错误 9 CFW PDP 的上下文获取错误 10 CS Call 错误 11 CFW CFUN 获取错误 12 CFUN 禁止失败 13 网络状态获取失败 14 数据拨号无法注册 15 数据拨号没有内存 16 CFW Attach 状态获取失败 17 信号量创建错误 18 信号量超时错误 19 CFW Attach 请求错误 20 CFW 激活请求错误 21 数据拨号激活失败 22 CFW 释放请求失败 上海移远通信技术股份有限公司 24 / 26 LTE Standard(U)系列 FOTA 应用指导 5 附录 参考文档及术语缩写 表 8：参考文档 文件名称 [1] Quectel_LTE_Standard(U)系列_AT 命令手册 [2] Quectel_LTE_Standard(U)系列_FILE_应用指导 [3] Quectel_LTE_Standard(U)系列_TCP(IP)_应用指导 表 9：术语缩写 缩写 CFW CS DNS FOTA FTP GSM HTTP HTTPS LTE MCU NVM PDP SD 英文全称 Communication Framework Circuit Switch Domain Name Server Firmware Upgrade Over-The-Air File Transfer Protocol Global System for Mobile Communications Hyper Text Transfer Protocol Hyper Text Transfer Protocol Secure Long Term Evolution Microcontroller Unit Non-Volatile Memory Packet Data Protocol Secure Digital 中文全称 通信框架 电路交换 域名系统（服务）协议 空中固件升级 文件传输协议 全球移动通信系统 超文本传输协议 超文本传输安全协议 长期演进 微型控制单元 非易失性存储器 分组数据协议 安全数字 上海移远通信技术股份有限公司 25 / 26 UART UFS URC URL USB LTE Standard(U)系列 FOTA 应用指导 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 User File System 用户文件系统 Unsolicited Result Code 非请求结果码 Uniform Resource Locator 统一资源定位符 Universal Serial Bus 通用串行总线 上海移远通信技术股份有限公司 26 / 26

LTE Standard(U)系列 FILE 应用指导 LTE Standard 模块系列 版本：1.5 日期：2023-12-20 状态：受控文件 LTE Standard(U)系列 FILE 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 29 LTE Standard(U)系列 FILE 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 29 LTE Standard(U)系列 FILE 应用指导 文档历史 修订记录 版本 1.0 日期 2020-06-30 2021-07-22 作者 Burols WANG/ Herry GEMG Burols WANG/ Herry GENG 1.1 2021-09-01 Herry GENG 1.2 2021-09-09 Herry GENG 1.3 2022-09-19 Mahat XU Kevin WANG/ 1.4 2023-06-19 Mahat XU 1.5 2023-12-20 Reilly NIAN 变更表述 文档创建 受控版本 1. 新增适用模块 EG915U 系列。 2. 新增暂不支持的物理存储媒介 SD:和 EFS:的相关 模块型号的备注（第 1 章）。 3. 更新 AT+QFLDS 命令的存储媒介类型，增加不支 持 SFS:的备注（第 2.3.1 章）。 4. 更新参数解释。 5. 新增的最大长度值。 删除备注：EC200U 系列模块暂不支持物理存储媒介 SD: SD 卡（第 1 章）。 1. 新 增 适 用 模 块 EC200D-CN 、 EC200G-CN 、 EC600G-CN 、 EC800G-CN 、 EG700G-CN 和 EG912U-GL 模块。 2. 增加 EC200D-CN 模块暂不支持物理存储媒介 SFS 和 EFS 的备注（第 1 章）。 1. 更新适用模块： ⚫ 新增 EG800G 系列； ⚫ 更新 EC200D-CN 为 EC200D 系列； ⚫ 更新 EC600G-CN 为 EC600G 系列。 2. 更新模块支持物理存储媒介的备注（第 1 章）。 新增有关文件系统中预置文件不可随意删除的备注（第 1 章）。 上海移远通信技术股份有限公司 3 / 29 LTE Standard(U)系列 FILE 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 1.2. FILE AT 命令使用流程 ................................................................................................................ 7 1.3. 数据模式说明............................................................................................................................... 8 2 FILE AT 命令详解 .................................................................................................................................. 9 2.1. AT 命令说明 ................................................................................................................................ 9 2.1.1. 定义 .................................................................................................................................. 9 2.1.2. AT 命令语句 ..................................................................................................................... 9 2.2. AT 示例声明 .............................................................................................................................. 10 2.3. AT 命令详解 .............................................................................................................................. 10 2.3.1. AT+QFLDS 获取存储媒介空间信息............................................................................. 10 2.3.2. AT+QFLST 列出存储媒介中的文件信息...................................................................... 11 2.3.3. AT+QFDEL 删除存储媒介中的文件............................................................................. 13 2.3.4. AT+QFUPL 上传文件到存储媒介 ................................................................................ 14 2.3.5. AT+QFDWL 下载存储媒介中的文件............................................................................ 16 2.3.6. AT+QFOPEN 打开文件 ............................................................................................... 17 2.3.7. AT+QFREAD 读取文件 ............................................................................................... 18 2.3.8. AT+QFWRITE 写入数据至文件................................................................................... 19 2.3.9. AT+QFSEEK 设置文件指针位置 ................................................................................. 20 2.3.10. AT+QFPOSITION 获取文件指针偏移量 ...................................................................... 21 2.3.11. AT+QFCLOSE 关闭文件 ............................................................................................. 21 2.3.12. AT+QFMKDIR 创建目录.............................................................................................. 22 2.3.13. AT+QFRMDIR 删除目录.............................................................................................. 23 3 举例 ...................................................................................................................................................... 24 3.1. 上传或下载文件 ......................................................................................................................... 24 3.1.1. 上传文件 ......................................................................................................................... 24 3.1.1.1. 无 ACK 模式 ....................................................................................................... 24 3.1.1.2. ACK 模式 ............................................................................................................ 24 3.1.2. 下载文件 ......................................................................................................................... 25 3.2. 写入和读取文件 ......................................................................................................................... 25 3.2.1. 写入和读取 UFS 文件 ..................................................................................................... 25 3.2.2. 写入和读取 SD 文件 ....................................................................................................... 26 3.2.3. 创建目录 ......................................................................................................................... 26 3.2.4. 删除目录 ......................................................................................................................... 26 4 错误码 .................................................................................................................................................. 27 5 附录 术语缩写...................................................................................................................................... 29 上海移远通信技术股份有限公司 4 / 29 LTE Standard(U)系列 FILE 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 9 表 3：错误码............................................................................................................................................... 27 表 4：术语缩写 ........................................................................................................................................... 29 上海移远通信技术股份有限公司 5 / 29 LTE Standard(U)系列 FILE 应用指导 1 引言 本文档主要介绍了与 LTE Standard(U)系列模块相关的 AT 命令，这些命令可以指导用户在不同的物理 存储媒介上进行文件操作。 LTE Standard(U)系列模块支持的物理存储媒介如下： ⚫ UFS: 主分区。用于存放用户的普通文件。 ⚫ SFS: 加密文件目录。与 UFS 共分区，用于存放用户加密文件。 ⚫ EFS: 外部 Flash 文件系统分区。 ⚫ SD: SD 卡分区。 备注 1. 文件名称表示存储位置。若文件名以 UFS:开头，则表示文件被存储在 UFS 中；若文件名以 SD:开头， 则表示文件被存储在 SD 卡中；若文件名无前缀，也表示文件被存储在 UFS 中。 2. EC600U 系列、EG912U-GL 和 EG915U 系列模块暂不支持物理存储媒介 SD: SD 卡和 EFS: 外部 Flash 文件系统。 3. EC200D 系列模块暂不支持物理存储媒介 EFS: 外部 Flash 文件系统分区。 4. 存在文件系统中的 GNSS、蓝牙和 TTS 等功能的预置文件不可随意删除。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 上海移远通信技术股份有限公司 6 / 29 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U-GL EG915U 系列 LTE Standard(U)系列 FILE 应用指导 1.2. FILE AT 命令使用流程 用户可以参照以下步骤在存储媒介中创建，读取和写入文件： 1. 通过 AT+QFUPL 上传文件至存储媒介，然后执行 AT+QFDWL 通过串行接口输出/下载文件。 2. 使用 AT+QFOPEN 打开文件后，可写入或读取此文件，直到文件被 AT+QFCLOSE 关闭。 ⚫ 使用 AT+QFOPEN 打开文件时，可以通过参数将文件设置为覆盖模式，只读模式或其他 模式（有关更多信息，可参考第 2.3.6 章）。打开文件后，会分配，之后可 以通过操作文件。 ⚫ 文件打开后，可从当前文件位置通过 AT+QFWRITE 写入数据至文件，通过 AT+QFREAD 读取文 件数据。 ⚫ 用户可通过 AT+QFSEEK 设置文件位置，执行 AT+QFPOSITION 查询当前文件位置。 ⚫ AT+QFCLOSE 用来关闭文件，文件关闭后，就无效了。 用户可以通过以下几个命令管理存储媒介中的文件： 1. AT+QFLDS: 获取存储媒介空间信息。 2. AT+QFLST: 列出存储媒介中的文件信息。 3. AT+QFDEL: 删除存储媒介中的文件。 备注 AT+QFOPEN 执行后获取的文件句柄，在使用完成后要及时用 AT+QFCLOSE 关闭，否则会造成句柄泄 露。 上海移远通信技术股份有限公司 7 / 29 LTE Standard(U)系列 FILE 应用指导 1.3. 数据模式说明 LTE Standard(U)系列模块的 COM 口有两种工作模式，一是 AT 命令模式，另一种为数据模式。AT 命 令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。 用户可以通过输入+++或拉高 DTR（需先设置 AT&D1）使 COM 口退出数据模式。为防止+++被误认 为是数据，用户在使用 COM 口之前应遵循以下标准： 1) 输入+++前 1 秒内不能输入其它任何数据。 2) 必须在 1 秒内输入+++，并且不能输入其它任何数据。 3) 输入+++后 1 秒内不能输入其它任何数据。 执行 AT+QFUPL、AT+QFDWL、AT+QFREAD 或 AT+QFWRITE 后，COM 口会进入数据模式。如 果用户通过+++或拉高 DTR 退出数据模式，在退出之前，会中断这些命令的执行。在这种情况下，COM 口 无法通过执行 ATO 重新进入数据模式。 上海移远通信技术股份有限公司 8 / 29 LTE Standard(U)系列 FILE 应用指导 2 FILE AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 29 LTE Standard(U)系列 FILE 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QFLDS 获取存储媒介空间信息 该命令用于获取指定存储媒介的空间信息。 AT+QFLDS 获取存储媒介空间信息 测试命令 AT+QFLDS=? 设置命令 AT+QFLDS= 响应 OK 响应 +QFLDS: , OK 执行命令 AT+QFLDS 若发生任何与 ME 功能有关的错误： +CME ERROR: 响应 返回 UFS 空间信息： +QFLDS: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。存储媒介类型。 'UFS' UFS 'EFS' 外部 Flash 上海移远通信技术股份有限公司 10 / 29 LTE Standard(U)系列 FILE 应用指导 'SD' SD 卡 整型。的可用空间。 整型。的总空间。 整型。UFS 中所有文件大小。单位：字节。 整型。UFS 中的文件数量。 与 ME 功能有关的错误码。详见第 4 章。 举例 AT+QFLDS='UFS' +QFLDS: 578847,917503 OK AT+QFLDS='SD' +QFLDS: 251920384,253132800 OK //查询 UFS 空间信息。 //查询 SD 卡空间信息。 备注 此命令不支持获取 SFS:目录下的空间信息。 2.3.2. AT+QFLST 列出存储媒介中的文件信息 该命令列出指定存储媒介中的单个或所有文件信息。 AT+QFLST 列出存储媒介中的文件信息 测试命令 AT+QFLST=? 设置命令 AT+QFLST= 响应 OK 响应 +QFLST: , [+QFLST: , […]] OK 执行命令 AT+QFLST 若发生任何与 ME 功能有关的错误： +CME ERROR: 响应 返回存储在 UFS 中所有文件的空间信息： +QFLST: , [+QFLST: , 上海移远通信技术股份有限公司 11 / 29 LTE Standard(U)系列 FILE 应用指导 最大响应时间 特性说明 […]] OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。列出的文件类型。 '*' 列出 UFS 中所有文件 '' 列出 UFS 中指定文件 'UFS:*' 列出 UFS 中所有文件 'UFS:' 列出 UFS 中指定文件 'SFS:*' 列出 SFS 中所有文件 'SFS:' 列出 SFS 中指定文件 'EFS:*' 列出 EFS 中所有文件 'EFS:' 列出 EFS 中指定文件 'SD:*' 列出 SD 卡中所有文件 'SD:' 列出 SD 卡中指定文件 字符串类型。文件名称。 整型。文件大小。单位：字节。 与 ME 功能有关的错误码。详见第 4 章。 举例 AT+QFLST='*' +QFLST: 'UFS:1k.txt',1024 +QFLST: 'UFS:2k.txt',2048 +QFLST: 'UFS:3k.txt',3072 OK AT+QFLST='SD:*' +QFLST: 'SD:1k.txt',1024 +QFLST: 'SD:10k.txt',10240 +QFLST: 'SD:100k.txt',102400 OK //列出 UFS 中所有文件。 //列出 SD 卡中所有文件。 上海移远通信技术股份有限公司 12 / 29 LTE Standard(U)系列 FILE 应用指导 备注 AT+QFLST 用于查询当前存储在 Flash 中的文件的实际大小。使用 AT+QFWRITE 写入数据，若 AT+QFLST 无法直接查询文件大小，需要 AT+QFCLOSE 执行关闭文件后，再使用该命令查询文件大小。 2.3.3. AT+QFDEL 删除存储媒介中的文件 该命令用于删除指定存储媒介中的单个或所有文件。 AT+QFDEL 删除存储媒介中的文件 测试命令 AT+QFDEL=? 响应 +QFDEL: 设置命令 AT+QFDEL= OK 响应 OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。删除的文件名称。可包含文件路径（即目录名）和文件名。其 中文件路径最大长度为 58 字节，文件名最大长度为 63 字节。 '*' 删除 UFS 中所有文件（不删除目录） '' 删除 UFS 中指定的文件 'UFS:*' 删除 UFS 中所有文件（不删除目录） 'UFS:' 删除 UFS 中指定的文件 'SFS:*' 删除 SFS 中所有文件（不删除目录） 'SFS:' 删除 SFS 中指定的文件 'EFS:*' 删除 EFS 中所有文件（不删除目录） 'EFS:' 删除 EFS 中指定的文件 'SD:*' 删除 SD 卡中所有文件（不删除目录） 'SD:' 删除 SD 卡中指定的文件 与 ME 功能相关的错误码。详见第 4 章。 上海移远通信技术股份有限公司 13 / 29 LTE Standard(U)系列 FILE 应用指导 举例 AT+QFDEL='*' OK AT+QFDEL='UFS:1.txt' OK AT+QFDEL='SD:*' OK //删除 UFS 中所有文件（不删除目录）。 //删除 UFS 中的 1.txt 这个文件。 //删除 SD 卡中所有文件（不删除目录）。 2.3.4. AT+QFUPL 上传文件到存储媒介 该命令用于上传文件到存储媒介，若上传的文件与存储媒介中的文件同名，则会上报错误。如果输入 的文件名包含路径，并且如果此路径不存在，则会在支持的根目录下创建此目录（例如 UFS:目录下），并 将文件上传至此目录下。 执行设置命令并返回 CONNECT 后，模块会切换为数据模式。当上传的文件大小达到，或 达到时间内无数据输入，模块会自动退出数据模式。数据传输期间，用户可以通过输入+++或拉 高 DTR 使之退出数据模式，更多相关信息，可参考第 1.3 章。 AT+QFUPL 上传文件到存储媒介 测试命令 AT+QFUPL=? 响应 +QFUPL: [,(1-)[,(支持的范 围)[,(支持的列表)]]] 设置命令 AT+QFUPL=[,[, [,]]] OK 响应 CONNECT TA 切换为数据模式（即透传模式），可输入二进制文件数据。 当输入数据的总大小达到（单位：字节）时，TA 将 切换回命令模式： +QFUPL: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 14 / 29 LTE Standard(U)系列 FILE 应用指导 参数 整型。的可用空间。有关详细信息，可参考第 2.3.1 章中的 AT+QFLDS 命令。 字符串类型。上传文件的名称。可包含文件路径（即目录名）和文件名。其 中文件路径最大长度为 58 字节，文件名最大长度为 63 字节。 '' 上传至 UFS 中的文件名称 'UFS:' 上传至 UFS 中的文件名称 'SFS:' 上传至 SFS 中的文件名称 'EFS:' 上传至 EFS 中的文件名称 'SD:' 上传至 SD 卡中的文件名称 整型。预计上传的文件大小。默认值：10240；单位：字节。 整型。实际上传的文件大小。单位：字节。 整型。通过 USB/UART 输入数据的等待时间。范围：1~65535；默认值：5；单位：秒。 整型。是否使用 ACK 模式。 0 关闭 ACK 模式 1 开启 ACK 模式 整型。上传数据的校验和。 与 ME 功能相关的错误码。详见第 4 章。 备注 1. 推荐使用 DOS 8.3 文件名格式。 2. 是基于异或的 16 位校验和。 如果字符数为奇数，则将最后一个字符设置为高 8 位，将低 8 位设置为 0，然后使用 XOR 运算符计 算校验和。+++序列可使 TA 结束命令并切换到命令模式。之前上传的数据将保留在文件中。 3. 执行命令时，必须在返回 CONNECT 后输入数据。 4. 在硬件流控制不起作用时，ACK 模式可避免在上传大文件时数据丢失。ACK 模式的工作原理如下： 1）运行 AT+QFUPL=,,,1 启用 ACK 模式。 2）模块输出 CONNECT。 3）MCU 发送 1 KB 字节数据，模块响应一个 A。 4）MCU 接收 A，然后发送下一个 1 KB 字节数据。 5）重复第 3）和 4）步骤，直到传输完成。 上海移远通信技术股份有限公司 15 / 29 LTE Standard(U)系列 FILE 应用指导 2.3.5. AT+QFDWL 下载存储媒介中的文件 该命令用于从存储媒介中下载指定的文件。 AT+QFDWL 下载存储媒介中的文件 测试命令 AT+QFDWL=? 响应 +QFDWL: 设置命令 AT+QFDWL= OK 响应 CONNECT TA 切换为数据模式，可输出文件二进制数据。文件读取完后， TA 将切换回命令模式： +QFDWL: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。下载文件的名称。可包含文件路径（即目录名）和文件名。 其中文件路径最大长度为 58 字节，文件名最大长度为 63 字节。 '' 下载的 UFS 文件名称 'UFS:' 下载的 UFS 文件名称 'SFS:' 下载的 SFS 文件名称 'EFS:' 下载的 EFS 文件名称 'SD:' 下载的 SD 卡文件名称 整型。已下载数据的大小。 整型。已下载数据的校验和。 与 ME 功能相关的错误码。详见第 4 章。 备注 1. +++序列会使 TA 结束命令并切换到命令模式。 2. 是基于异或的 16 位校验和。 3. 此命令不回显 SFS:目录下的文件内容，只能看到文件大小和校验和。 上海移远通信技术股份有限公司 16 / 29 LTE Standard(U)系列 FILE 应用指导 2.3.6. AT+QFOPEN 打开文件 该命令用于打开文件并获取命令中使用的文件句柄，相关命令如 AT+QFREAD、AT+QFWRITE、 AT+QFSEEK、AT+QFPOSITION 和 AT+QFCLOSE。 AT+QFOPEN 打开文件 测试命令 AT+QFOPEN=? 响应 +QFOPEN: [,(支持的范围)] 查询命令 AT+QFOPEN? OK 响应 +QFOPEN: ,, [+QFOPEN: ,, […]] 设置命令 AT+QFOPEN=[,] OK 响应 +QFOPEN: OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。打开的文件名称。可包含文件路径（即目录名）和文件名。 其中文件路径最大长度为 58 字节，文件名最大长度为 63 字节。 '' 打开的 UFS 文件名称 'UFS:' 打开的 UFS 文件名称 'EFS:' 打开的 EFS 文件名称 'SD:' 打开的 SD 卡文件名称 整型。文件句柄。 整型。文件的打开模式。 0 若文件不存在，则会创建一个新文件；若文件存在，则直接打开文件。两种情 况中的文件皆可读写。 1 若文件不存在，则会创建一个新文件；若文件存在，则清除并覆盖文件。两种 情况中的文件皆可读写。 2 若文件存在，则打开文件，且文件只可读；若文件不存在，则响应错误。 上海移远通信技术股份有限公司 17 / 29 LTE Standard(U)系列 FILE 应用指导 与 ME 功能相关的错误码。详见第 4 章。 备注 此命令不支持打开 SFS:目录下的文件。 2.3.7. AT+QFREAD 读取文件 该命令用于读取由文件句柄指定的文件数据。数据从文件指针的当前位置开始读取，文件指针属于文 件句柄。 AT+QFREAD 读取文件 测试命令 AT+QFREAD=? 响应 +QFREAD: [,] 设置命令 AT+QFREAD=[, ] OK 响应 CONNECT TA 切换到数据模式，当数据总大小超过时，TA 将切 换回命令模式： OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。预计读取的文件长度。默认长度为 10 KB，若文件长度不足 10 KB，则读取 文件的实际长度。单位：字节。 整型。实际读取的文件长度。单位：字节。 与 ME 功能相关的错误码。详见第 4 章。 上海移远通信技术股份有限公司 18 / 29 LTE Standard(U)系列 FILE 应用指导 2.3.8. AT+QFWRITE 写入数据至文件 该命令可将数据写入到文件。数据从文件指针的当前位置开始写入，文件指针属于文件句柄。 AT+QFWRITE 写入数据至文件 测试命令 AT+QFWRITE=? 响应 +QFWRITE: [,[,]] 设置命令 AT+QFWRITE=[,[,]] OK 响应 CONNECT TA 切换到数据模式。当写入数据的总大小超过或写 入时间超过，TA 将切换回命令模式： +QFWRITE: , OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。预计写入文件的长度。默认长度为 10 KB，此参数的最大值由 AT+QFUPL 的决定。 整型。通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒。 整型。实际写入数据的长度。单位：字节。 整型。文件总长度。单位：字节。 与 ME 功能相关的错误码。详见第 4 章。 上海移远通信技术股份有限公司 19 / 29 LTE Standard(U)系列 FILE 应用指导 2.3.9. AT+QFSEEK 设置文件指针位置 该命令可设置文件指针到指定的位置。 AT+QFSEEK 设置文件指针位置 测试命令 AT+QFSEEK=? 响应 +QFSEEK: ,[,] 设置命令 AT+QFSEEK=,[, ] OK 响应 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。文件指针移动的字节数。 整型。文件指针移动模式。 0 文件初始位置向后移动 1 文件指针当前位置向后移动 2 文件结尾位置向前移动 与 ME 功能相关的错误码。详见第 4 章。 备注 若设置的最终指针位置超过文件范围，执行此命令会返回 ERROR。 上海移远通信技术股份有限公司 20 / 29 LTE Standard(U)系列 FILE 应用指导 2.3.10. AT+QFPOSITION 获取文件指针偏移量 该命令可从文件初始位置获取文件指针的偏移量。 AT+QFPOSITION 获取文件指针偏移量 测试命令 AT+QFPOSITION=? 响应 +QFPOSITION: 设置命令 AT+QFPOSITION= OK 响应 +QFPOSITION: OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。从初始位置起文件指针的偏移量。 与 ME 功能相关的错误码。详见第 4 章。 2.3.11. AT+QFCLOSE 关闭文件 该命令用于关闭文件或结束对文件的操作。关闭文件后，文件句柄会被释放。除非通过 AT+QFOPEN 再次打开文件，否则不可再次使用文件句柄。 AT+QFCLOSE 关闭文件 测试命令 AT+QFCLOSE=? 响应 +QFCLOSE: 设置命令 AT+QFCLOSE= OK 响应 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 上海移远通信技术股份有限公司 21 / 29 LTE Standard(U)系列 FILE 应用指导 最大响应时间 特性说明 参数 300 毫秒 该命令立即生效； 参数配置不保存。 整型。需要操作的文件句柄。 与 ME 功能相关的错误码。详见第 4 章。 2.3.12. AT+QFMKDIR 创建目录 该命令用于创建目录，暂时只支持创建到二级目录（即只允许在支持的目录下创建一个目录，不支持 二级目录下创建目录）。 AT+QFMKDIR 创建目录 测试命令 AT+QFMKDIR=? 响应 +QFMKDIR: 设置命令 AT+QFMKDIR= OK 响应 OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。创建的目录路径。 字符串类型。需要创建的目录名。最大长度为 58 字节。 '' 在 UFS 中创建的目录名 'UFS:' 在 UFS 中创建的目录名 'SFS:' 在 SFS 中创建的目录名 'EFS:' 在 EFS 中创建的目录名 'SD:' 在 SD 卡中创建的目录名 与 ME 功能相关的错误码。详见第 4 章。 上海移远通信技术股份有限公司 22 / 29 LTE Standard(U)系列 FILE 应用指导 2.3.13. AT+QFRMDIR 删除目录 该命令用于删除目录，有两种模式。模式一为若目录中存在文件，此命令不执行删除操作，会返回相 应的错误码；若目录中不存在文件，则会进行删除目录操作。模式二为若目录中存在文件，会进行删除目 录和目录内文件的操作，执行成功返回 OK，失败返回相应错误码。 AT+QFRMDIR 删除目录 测试命令 AT+QFRMDIR=? 响应 +QFRMDIR: ,(支持的列表) 设置命令 AT+QFRMDIR=[,] OK 响应 OK 最大响应时间 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。删除的目录路径。 整型。删除模式。 0 若目录下存在文件则不进行删除操作，会返回错误码；若目录中不存在文件， 则会直接删除目录。 1 目录下存在文件，删除目录和目录内文件。 与 ME 功能相关的错误码。详见第 4 章。 上海移远通信技术股份有限公司 23 / 29 LTE Standard(U)系列 FILE 应用指导 3 举例 3.1. 上传或下载文件 3.1.1. 上传文件 3.1.1.1. 无 ACK 模式 AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK AT+QFUPL='dir1/test1.txt',10 CONNECT +QFUPL: 10,3938 OK //上传 test1.txt 文本文件到 UFS。 //在 UFS 下创建 dir1 目录，并且将 test1.txt 上传到此目录下。 3.1.1.2. ACK 模式 ACK 模式下传输数据更可靠。在无硬件流控情况下传输大文件时，推荐开启 ACK 模式避免数据丢失。 有关 ACK 模式的详细信息，可参考 AT+QFUPL 命令。 AT+QFUPL='5K.txt',5120,30,1 CONNECT AAAAA +QFUPL: 5120,5e0e //上传文本文件 5K.txt 文件到 UFS，开启 ACK 模式输入数据等待 时间为 30 s。 //每次上传 1 KB 字节数据模块会响应一个 A，上传 5 KB 字节模块 会响应 5 个 A。 //总共上传成功 5120 字节数据，校验和为 5e0e。 OK //返回成功。 上海移远通信技术股份有限公司 24 / 29 3.1.2. 下载文件 AT+QFDWL='10.txt' CONNECT 1234567890 +QFDWL: 10,3938 OK 3.2. 写入和读取文件 3.2.1. 写入和读取 UFS 文件 AT+QFOPEN='ufs.txt' +QFOPEN: 1028 OK AT+QFWRITE=1028,10,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=1028,0,0 OK AT+QFREAD=1028,10 CONNECT 10 OK AT+QFCLOSE=1028 OK LTE Standard(U)系列 FILE 应用指导 //从 UFS 中下载文本文件 10.txt。 //文件内容。 //获取已下载数据的字节数和校验和。 //打开文件获取文件指针。 //将 10 个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取数据。 //读取字节数 10 字节。 //关闭文件。 上海移远通信技术股份有限公司 25 / 29 3.2.2. 写入和读取 SD 文件 AT+QFOPEN='SD:1.txt',1 +QFOPEN: 20 OK AT+QFWRITE=20,1024 CONNECT +QFWRITE: 1024,1024 OK AT+QFSEEK=20,0,0 OK AT+QFREAD=20,1024 CONNECT OK AT+QFCLOSE=20 OK 3.2.3. 创建目录 AT+QFMKDIR='UFS:dir1' OK AT+QFMKDIR='dir2' OK 3.2.4. 删除目录 AT+QFLST='dir1' +QFLST: 'dir1/upl1.txt',10 +QFLST: 'dir1/upl2.txt',10 OK AT+QFLST='dir2' +QFLST: 'dir2/upl2.txt',10 OK AT+QFRMDIR='dir1' +CME ERROR: 418 AT+QFRMDIR='dir1',1 OK 上海移远通信技术股份有限公司 LTE Standard(U)系列 FILE 应用指导 //打开文件获取文件指针。 //将 1024 个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取数据。 //关闭文件。 //在 UFS 中创建目录 dir1。 //在 UFS 中创建目录 dir2。 //列出 UFS 中指定的 dir1 文件。 //列出 UFS 中指定的 dir2 文件。 //删除 UFS 中的目录 dir1。 //目录 dir1 不为空，返回错误码。 //删除 UFS 中的目录 dir1。 26 / 29 LTE Standard(U)系列 FILE 应用指导 4 错误码 表示与移动设备或网络有关的错误码，详细信息可参考下表。下表中的错误码与本文档适用模块 的文件操作有关。 表 3：错误码 错误码 400 401 402 403 405 406 407 409 410 411 413 414 415 416 417 418 419 英文含义 Invalid input value Larger than the size of the file Read zero byte Drive full File not found Invalid file name File already exists Fail to write the file Fail to open the file Fail to read the file Reach the max number of files allowed to be opened The file read-only Get file size failed Invalid file descriptor Fail to list the file Fail to delete the file Fail to get disk info 中文含义 输入值无效 文件过大 读取 0 字节 驱动器已满 未发现文件 无效文件名 文件已存在 写入文件失败 打开文件失败 读取文件失败 达到允许打开的最大文件数 文件仅可读 获取文件大小失败 无效文件描述符 列举文件失败 删除文件失败 获取磁盘信息失败 上海移远通信技术股份有限公司 27 / 29 LTE Standard(U)系列 FILE 应用指导 420 No space 空间不足 421 Time out 超时 423 File too large 文件过大 425 Invalid parameter 无效参数 426 File already opened 文件已打开 上海移远通信技术股份有限公司 28 / 29 LTE Standard(U)系列 FILE 应用指导 5 附录 术语缩写 表 4：术语缩写 缩写 ACK COM DOS DTR EFS GNSS ME RAM SD SFS TA TTS UART UFS USB XOR 英文全称 中文全称 Acknowledgement 确认字符 Communication Port 串行通讯端口 Disk Operating System 磁盘操作系统 Data Terminal Ready 数据终端就绪 Embedded File System 嵌入式文件系统 Global Navigation Satellite System 全球导航卫星系统 Mobile Equipment 移动设备 Random Access Memory 随机存储器 Secure Digital 安全数字存储器 Security File System 安全文件系统 Terminal Adapter 终端适配器 Text to Speech Universal Asynchronous Receiver-Transmitter User File Storage 语音合成/文字转语音 通用异步收发传输器 用户文件存储 Universal Serial Bus 通用串行总线 Exclusive OR 异或 上海移远通信技术股份有限公司 29 / 29

LTE Standard(U)系列 eDRX 应用指导 LTE Standard 模块系列 版本：1.2 日期：2024-04-08 状态：受控文件 LTE Standard(U)系列 eDRX 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 21 LTE Standard(U)系列 eDRX 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 21 LTE Standard(U)系列 eDRX 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 日期 作者 2023-06-13 Marvin NING 2023-06-30 Marvin NING 2023-09-01 Marvin NING 2024-04-08 Kevin WANG 变更表述 文档创建 受控版本 1. 更新 AT+CEDRXS?命令响应格式（第 3.3.1 章）。 2. 新增'常见问题'章节（第 4 章）。 更新适用模块： ⚫ 更新 EG912U-GL 为 EG912U 系列； ⚫ 新增 EG915G-EU。 上海移远通信技术股份有限公司 3 / 21 LTE Standard(U)系列 eDRX 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 eDRX 功能介绍 ..................................................................................................................................... 7 3 eDRX AT 命令....................................................................................................................................... 8 3.1. AT 命令说明................................................................................................................................ 8 3.1.1. 定义 ................................................................................................................................. 8 3.1.2. AT 命令语句..................................................................................................................... 8 3.2. AT 示例声明................................................................................................................................ 9 3.3. AT 命令详解................................................................................................................................ 9 3.3.1. AT+CEDRXS eDRX 设置 ............................................................................................. 9 3.3.2. AT+QPTWEDRXS 设置 PTW 值和 eDRX.................................................................. 12 3.3.3. AT+CEDRXRDP 读取动态参数 .................................................................................. 15 4 常见问题 .............................................................................................................................................. 18 5 错误代码 .............................................................................................................................................. 19 6 附录 参考文档和术语缩写 .................................................................................................................. 21 上海移远通信技术股份有限公司 4 / 21 LTE Standard(U)系列 eDRX 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 8 表 3：+CME ERROR: 错误码描述 .................................................................................................... 19 表 4：参考文档 ........................................................................................................................................... 21 表 5：术语缩写 ........................................................................................................................................... 21 上海移远通信技术股份有限公司 5 / 21 LTE Standard(U)系列 eDRX 应用指导 1 引言 本文档介绍空闲状态下的扩展非连续接收（eDRX）功能，并说明如何使用移远通信 LTE Standard(U) 系列模块的 eDRX 功能。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U 系列 EG915G-EU EG915U 系列 备注 本文档不适用于 EC200D 系列模块。 上海移远通信技术股份有限公司 6 / 21 LTE Standard(U)系列 eDRX 应用指导 2 eDRX 功能介绍 eDRX 在 3GPP Release 13 中引入，是 DRX 功能的扩展，DRX 功能用于降低物联网设备功耗，DRX 机制是设备处于睡眠状态后，以固定时间间隔将其唤醒，接收下行链路数据。eDRX 的基本原理是延长空 闲模式 DRX 周期，使设备在更长的时间内保持低功耗状态。 应用程序若要使用 eDRX 功能，需要考虑移动终端服务或数据传输的具体操作，尤其是移动终端数据 的延迟容限。网络端应用可能会发送移动终端数据、SMS 或设备触发，且需注意 eDRX 已经设置生效。只 有所有移动终端通讯的延迟都可以接受时，才应设置 eDRX。1) eDRX 参数包括 PTW（寻呼时间窗口）和 eDRX 周期。UE 应在附加请求或跟踪区域更新请求消息中 设置所需的 eDRX 参数 IE，指示 UE 支持空闲 eDRX 功能。若网络支持 eDRX 功能，它会将附加接受或跟 踪 区 域 更 新 接 受 消 息 中 的 相 应 eDRX 参 数 值 发 送 到 UE 。 E-UTRAN 网 络 系 统 信 息 中 应 包 含 'eDRX-Allowed-r13 'IE，否则应视为不支持 eDRX 功能。 PTW eDRX周期 DRX周期 解码寻呼消息 连接 模式 图 1: 功能概览 备注 1. 1) 摘自 3GPP TS 23.682 技术规范。有关 eDRX 模式的详细信息，参考 3GPP TS 23.682, clause 4.5.13 Extended idle mode DRX。 2. PTW 并非通过接收 RRC 释放来启动，而是从下一个 PO（寻呼场合）启动。关于如何计算 PO，主 要由 UE_ID（IMSI）决定。有关更多详细信息，请参考 3GPP TS36.304, clause 7 Paging。 上海移远通信技术股份有限公司 7 / 21 LTE Standard(U)系列 eDRX 应用指导 3 eDRX AT 命令 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 21 LTE Standard(U)系列 eDRX 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT 命令详解 3.3.1. AT+CEDRXS eDRX 设置 该命令用于设置 UE 的 eDRX 参数，即设置 UE 是否使用 eDRX 以及指定接入技术请求的 eDRX 值。 当=2 且网络提供的 eDRX 参数发生变化时，该设置命令还可用于控制 URC +CEDRXP: [,[,[,]]]的上 报。 AT+CEDRXS=3 为命令的特殊形式。此形式将会禁用 eDRX 且之前通过 AT+CEDRXS 所配置的所有 参数都将被清除，或者被设置为默认值（若有）。 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的范围),(支持的列表),(支持 的列表) 查询命令 AT+CEDRXS? OK 响应 +CEDRXS: [,] [+CEDRXS: [,] [...]] 设置命令 AT+CEDRXS=[,[,]] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 响应 OK 若有任何错误： ERROR 300 毫秒 该命令立即生效； 该配置自动保存。 / 上海移远通信技术股份有限公司 9 / 21 LTE Standard(U)系列 eDRX 应用指导 参数 整型。启用或禁用 UE 的 eDRX。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并上报如下 URC： +CEDRXP: [,[,[,]]] 3 禁用 eDRX 并删除 eDRX 的所有参数配置，或若 eDRX 参数本身有默认值， 则重置为默认值 整型。接入技术类型。 0 接入技术未使用 eDRX，该参数值仅在 URC 中使用 4 E-UTRAN（WB-S1 模式） 字符串类型。半字节（4 位）格式。UE 请求的 eDRX 周期。 位数 描述 4 3 2 1 E-UTRAN eDRX 周期 0 0 0 0 5.12 秒 0 0 0 1 10.24 秒 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 0 61.44 秒 0 1 0 1 81.92 秒 0 1 1 0 102.4 秒 0 1 1 1 122.88 秒 1 0 0 0 143.36 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。半字节（4 位）格式。网络下发的 eDRX 周期。 位数 描述 4 3 2 1 E-UTRAN eDRX 周期 0 0 0 0 5.12 秒 0 0 0 1 10.24 秒 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 0 61.44 秒 0 1 0 1 81.92 秒 0 1 1 0 102.4 秒 0 1 1 1 122.88 秒 1 0 0 0 143.36 秒 1 0 0 1 163.84 秒 上海移远通信技术股份有限公司 10 / 21 LTE Standard(U)系列 eDRX 应用指导 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。半字节（4 位）格式。网络下发的 PTW。 位数 描述 4 3 2 1 PTW 长度 0 0 0 0 1.28 秒 0 0 0 1 2.56 秒 0 0 1 0 3.84 秒 0 0 1 1 5.12 秒 0 1 0 0 6.4 秒 0 1 0 1 7.68 秒 0 1 1 0 8.96 秒 0 1 1 1 10.24 秒 1 0 0 0 11.52 秒 1 0 0 1 12.8 秒 1 0 1 0 14.08 秒 1 0 1 1 15.36 秒 1 1 0 0 16.64 秒 1 1 0 1 17.92 秒 1 1 1 0 19.20 秒 1 1 1 1 20.48 秒 举例 AT+CEDRXS=1,4,'0000' OK AT+CEDRXS=0,4 OK AT+CEDRXS=2,4,'0000' OK +CEDRXP: 4,'0000','0000','0000' //设置请求的 eDRX 周期为 5.12 秒。 //禁用 eDRX 功能。 //设置请求的 eDRX 周期为 5.12 秒，并上报 URC。 //网络接受 eDRX 参数。 上海移远通信技术股份有限公司 11 / 21 LTE Standard(U)系列 eDRX 应用指导 3.3.2. AT+QPTWEDRXS 设置 PTW 值和 eDRX 该命令用于设置 UE 的 PTW 值和 eDRX 参数，即 UE 是否启用 PTW 和 eDRX，以及每个指定接入技 术所请求的 PTW 和 eDRX 周期。 当为 2，且网络下发的 PTW 和 eDRX 参数发生变化时，该命令控制 URC +QPTWEDRXP: [,[,[,[,]]]]的上报。 AT+QPTWEDRXS=3 为命令的特殊形式。该形式会禁用 PTW 和 eDRX，且之前通过 AT+QPTWEDR XS 所配置的所有参数都将被清除，或者被设置为默认值（若有）。 AT+QPTWEDRXS 设置 PTW 值和 eDRX 测试命令 AT+QPTWEDRXS=? 响应 +QPTWEDRXS: (支持的范围),(支持的列表),(支持的 范围),(支持的范围) 查询命令 AT+QPTWEDRXS? OK 响应 +QPTWEDRXS: [,,[,[,]]] […] OK 或者 ERROR 设置命令 AT+QPTWEDRXS=[,[, [,]]] 若有错误与ME功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 若有错误与ME功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 该配置自动保存。 上海移远通信技术股份有限公司 12 / 21 LTE Standard(U)系列 eDRX 应用指导 参数 整型。启用或禁用 UE 请求的 PTW 和 eDRX。此参数适用于所有指定类型的 接入技术，即的最新设置将对所有指定的 AT+QNWINFO 返回的 值生效。有关 AT+QNWINFO 的详细信息，请参考文档 [1]。 0 禁用请求的 PTW 和 eDRX 1 启用请求的 PTW 和 eDRX 2 启用请求的 PTW 和 eDRX，并上报如下 URC： +QPTWEDRXP: [,[, [,[,]]]] 3 禁用 eDRX 并删除 eDRX 的所有参数配置，或若 eDRX 参数本身有默认 值，则重置为默认值 整型。接入技术类型。 0 接入技术未使用 eDRX，该参数值仅在 URC 中使用 4 E-UTRAN（WB-S1 模式） 字符串类型。半字节（4 位）格式。UE 请求的 PTW。 位数 描述 4 3 2 1 PTW 长度 0 0 0 0 1.28 秒 0 0 0 1 2.56 秒 0 0 1 0 3.84 秒 0 0 1 1 5.12 秒 0 1 0 0 6.4 秒 0 1 0 1 7.68 秒 0 1 1 0 8.96 秒 0 1 1 1 10.24 秒 1 0 0 0 11.52 秒 1 0 0 1 12.8 秒 1 0 1 0 14.08 秒 1 0 1 1 15.36 秒 1 1 0 0 16.64 秒 1 1 0 1 17.92 秒 1 1 1 0 19.20 秒 1 1 1 1 20.48 秒 字符串类型。半字节（4 位）格式。UE 请求的 eDRX 周期。 位数 描述 4 3 2 1 E-UTRAN eDRX 周期 0 0 0 0 5.12 秒 0 0 0 1 10.24 秒 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 0 61.44 秒 0 1 0 1 81.92 秒 上海移远通信技术股份有限公司 13 / 21 LTE Standard(U)系列 eDRX 应用指导 0 1 1 0 102.4 秒 0 1 1 1 122.88 秒 1 0 0 0 143.36 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。半字节（4 位）格式。网络下发的 eDRX 周期。 位数 描述 4 3 2 1 E-UTRAN eDRX 周期 0 0 0 0 5.12 秒 0 0 0 1 10.24 秒 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 0 61.44 秒 0 1 0 1 81.92 秒 0 1 1 0 102.4 秒 0 1 1 1 122.88 秒 1 0 0 0 143.36 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。半字节（4 位）格式。网络下发的 PTW。 位数 描述 4 3 2 1 PTW 长度 0 0 0 0 1.28 秒 0 0 0 1 2.56 秒 0 0 1 0 3.84 秒 0 0 1 1 5.12 秒 0 1 0 0 6.4 秒 0 1 0 1 7.68 秒 0 1 1 0 8.96 秒 0 1 1 1 10.24 秒 1 0 0 0 11.52 秒 1 0 0 1 12.8 秒 1 0 1 0 14.08 秒 1 0 1 1 15.36 秒 上海移远通信技术股份有限公司 14 / 21 1 1 0 0 1 1 0 1 1 1 1 0 1 1 1 1 错误码。详见第 4 章。 LTE Standard(U)系列 eDRX 应用指导 16.64 秒 17.92 秒 19.20 秒 20.48 秒 3.3.3. AT+CEDRXRDP 读取动态参数 若 MS 注册的小区使用了 eDRX，则执行命令返回+CEDRXRDP: [,[,[,]]]。 AT+CEDRXRDP 读取动态参数 测试命令 响应 AT+CEDRXRDP=? 执行命令 OK 响应 AT+CEDRXRDP +CEDRXRDP: [,[,[,]]] 最大响应时间 特性说明 参考 3GPP TS 27.007 OK 300 毫秒 / / 参数 整型。接入技术类型。 0 接入技术未使用 eDRX。该参数值仅在 URC 中使用 4 E-UTRAN (WB-S1 模式) 字符串类型。半字节（4 位）格式。UE 请求的 eDRX 周期。 位数 描述 4 3 2 1 E-UTRAN eDRX 周期 0 0 0 0 5.12 秒 0 0 0 1 10.24 秒 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 0 61.44 秒 0 1 0 1 81.92 秒 0 1 1 0 102.4 秒 0 1 1 1 122.88 秒 1 0 0 0 143.36 秒 1 0 0 1 163.84 秒 上海移远通信技术股份有限公司 15 / 21 LTE Standard(U)系列 eDRX 应用指导 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。半字节（4 位）格式。网络下发的 eDRX 周期。 位数 描述 4 3 2 1 E-UTRAN eDRX 周期 0 0 0 0 5.12 秒 0 0 0 1 10.24 秒 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 0 61.44 秒 0 1 0 1 81.92 秒 0 1 1 0 102.4 秒 0 1 1 1 122.88 秒 1 0 0 0 143.36 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。半字节（4 位）格式。网络下发的 PTW。 位数 描述 4 3 2 1 PTW 长度 0 0 0 0 1.28 秒 0 0 0 1 2.56 秒 0 0 1 0 3.84 秒 0 0 1 1 5.12 秒 0 1 0 0 6.4 秒 0 1 0 1 7.68 秒 0 1 1 0 8.96 秒 0 1 1 1 10.24 秒 1 0 0 0 11.52 秒 1 0 0 1 12.8 秒 1 0 1 0 14.08 秒 1 0 1 1 15.36 秒 1 1 0 0 16.64 秒 1 1 0 1 17.92 秒 1 1 1 0 19.20 秒 1 1 1 1 20.48 秒 上海移远通信技术股份有限公司 16 / 21 LTE Standard(U)系列 eDRX 应用指导 举例 AT+CEDRXS=1,4,'0000' OK AT+CEDRXRDP +CEDRXRDP: 4,'0000','0000','0000' //设置请求的 eDRX 周期为 5.12 秒。 //网络接受 eDRX 配置。 OK AT+CEDRXS=0,4 OK AT+CEDRXRDP +CEDRXRDP: 0 //禁用 eDRX 功能。 //接入技术未使用 eDRX。 OK 上海移远通信技术股份有限公司 17 / 21 LTE Standard(U)系列 eDRX 应用指导 4 常见问题 本章节主要描述启用 eDRX 功能时常见的问题及其相关解答。 1. Q：模块是否可以在未启用 PSM 的情况下使用 eDRX 功能？ A：可以。 2. Q：eDRX 是否会导致下行数据延迟？ A：会导致下行数据延迟。启用 eDRX 功能后，模块只会在寻呼窗口期间（PTW）接受网络下发 的下行数据。网络在 eDRX 空闲状态下不发送下行数据。 3. Q：为什么即使模块请求了 eDRX 值并且网络分配了 eDRX 值，但模块仍无法使用 eDRX 功能？ A：只有在网络下发的系统消息中包含'eDRX-Allowed-r13 '才表示网络支持 eDRX，否 则表示网络不支持 eDRX 功能。如下图所示： 上海移远通信技术股份有限公司 18 / 21 LTE Standard(U)系列 eDRX 应用指导 5 错误代码 最终结果码+CME ERROR: 表示和移动设备或者网络相关的错误。操作类似于 ERROR 结果码。 同一命令行中未执行任一命令，则不会返回 ERROR 或 OK 结果码。 值常用于普通消息命令。下表列举了部分通用或 GPRS 相关 ERROR 码，此表不包含 GSM 规范中描 述的 GSM 协议错误相关错误码。 表 3：+CME ERROR: 错误码描述 错误码 0 1 2 3 4 5 6 7 10 11 12 13 14 15 16 17 18 英文含义 Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy SIM wrong Incorrect password SIM PIN2 required SIM PUK2 required 中文含义 拨打电话失败 电话未连接 保留电话适配器连接 操作不允许 操作不支持 需要 PH SIM 卡 PIN 码 需要 PH FSIM 卡 PIN 码 需要 PH FSIM 卡 PUK 码 未插入 SIM 卡 需要 SIM 卡 PIN 码 需要 SIM 卡 PUK 码 SIM 卡失败 SIM 卡忙 SIM 卡错误 密码不正确 需要 SIM 卡 PIN2 码 需要 SIM 卡 PUK2 码 上海移远通信技术股份有限公司 19 / 21 LTE Standard(U)系列 eDRX 应用指导 20 Memory full 内存已满 21 Invalid index 无效索引 22 Not found 未发现 23 Memory failure 内存不足 24 Text string too long 文本字符过长 25 Invalid characters in text string 无效文本字符 26 Dial string too long 拨号字符过长 27 Invalid characters in dial string 无效拨号字符 30 No network service 无网络服务 31 Network timeout 网络超时 32 Network not allowed - emergency calls only 网络不允许-仅支持紧急通话 40 Network personalization PIN required 需要网络个性化 PIN 41 Network personalization PUK required 需要网络个性化 PUK 42 Network subset personalization PIN required 需要网络子集个性化 PIN 43 Network subset personalization PUK required 需要网络子集个性化 PUK 44 Service provider personalization PIN required 需要网络服务商个性化 PIN 45 Service provider personalization PUK required 需要网络服务商个性化 PUK 46 Corporate personalization PIN required 需要企业个性化 PIN 47 Corporate personalization PUK required 需要企业个性化 PUK 901 Audio unknown error 音频未知错误 902 Audio invalid parameters 音频无效参数 903 Audio operation not supported 音频操作不支持 904 Audio device busy 音频设备忙 上海移远通信技术股份有限公司 20 / 21 LTE Standard(U)系列 eDRX 应用指导 6 附录 参考文档和术语缩写 表 4：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_AT 命令手册 表 5：术语缩写 缩写 3GPP DRX eDRX E-UTRAN IE IMSI IoT MS PIN PO PSM PTW RRC SMS UE URC 英文全称 3rd Generation Partnership Project Discontinuous Reception Extended Discontinuous Reception Evolved Universal Terrestrial Radio Access Network Item Element International Mobile Subscriber Identity Internet of Things Mobile Station Personal Identification Number Paging Occasion Power Saving Mode Paging Time Window Radio Resource Control Short Message Service User Equipment Unsolicited Result Code 中文全称 第三代合作伙伴计划 非连续接收 扩展非连续接收 演进的通用陆基无线接入网 项目元素 国际移动用户识别码 物联网 移动台 个人识别码 寻呼场合 省电模式 寻呼时间窗口 无线资源控制 短消息业务 用户设备 非请求结果码 上海移远通信技术股份有限公司 21 / 21

LTE Standard(U)系列 TCP/IP 应用指导 LTE Standard 模块系列 版本：1.2 日期：2023-01-16 状态：受控文件 LTE Standard(U)系列 TCP/IP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 59 LTE Standard(U)系列 TCP/IP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 59 LTE Standard(U)系列 TCP/IP 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 日期 2021-05-19 2021-06-15 2021-08-17 2023-01-16 作者 变更表述 Herry GENG 文档创建 Herry GENG 受控版本 Herry GENG Fawei ZHOU/ Kruskal ZHU 增加适用模块 EG915U 系列。 1. 增 加 适 用 模 块 EC200D 系 列 、 EC200G-CN 、 EC600G-CN 、 EC800G-CN 、 EG700G-CN 和 EG912U-GL。 2. 更新 TCP/IP AT 命令使用流程图（第 1.3 章）。 3. 更新范围说明（第 2.3 章和第 2.4.5 章）。 4. 增加如下命令（第 2.3.1 章）： AT+QICFG='tcp/serveropt' AT+QICFG='send/buffersize' AT+QICFG='tcp/inactivetm' 5. 增 加 AT+QICFG='send/auto' 命 令 的 参数（第 2.3.1 章）。 6. 增加参数取值 3（PAP_CHAP），仅 EC200D 系列模块支持。（第 2.3.2 章）。 7. 更新 AT+QIRD 命令参数（第 2.3.11 章）。 8. 更新 AT+QISENDEX 设置命令描述（第 2.3.12 章）。 9. 增加 AT+QISENDHEX（第 2.3.13 章）。 上海移远通信技术股份有限公司 3 / 59 LTE Standard(U)系列 TCP/IP 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 1.2. 数据访问模式说明 ....................................................................................................................... 8 1.3. TCP/IP 使用 TCP/IP AT 命令的流程 ........................................................................................... 9 2 TCP/IP AT 命令详解 ............................................................................................................................ 11 2.1. AT 命令说明 .............................................................................................................................. 11 2.1.1. 定义 ................................................................................................................................ 11 2.1.2. AT 命令语句 ................................................................................................................... 11 2.2. AT 示例声明 .............................................................................................................................. 12 2.3. AT 命令详解 .............................................................................................................................. 12 2.3.1. AT+QICFG 配置可选参数............................................................................................ 12 2.3.2. AT+QICSGP 配置 TCP/IP 场景参数............................................................................ 21 2.3.3. AT+QIACT 激活 PDP 上下文 ...................................................................................... 22 2.3.4. AT+QIDEACT 去激活 PDP 上下文.............................................................................. 23 2.3.5. AT+QIACTEX 异步激活 PDP 上下文 .......................................................................... 24 2.3.6. AT+QIDEACTEX 异步去激活 PDP 上下文.................................................................. 25 2.3.7. AT+QIOPEN 打开 Socket 服务 ................................................................................... 26 2.3.8. AT+QICLOSE 关闭 Socket 服务 ................................................................................. 28 2.3.9. AT+QISTATE 查询 Socket 服务状态........................................................................... 29 2.3.10. AT+QISEND 发送数据................................................................................................. 31 2.3.11. AT+QIRD 读取收到的 TCP/IP 数据 ............................................................................. 33 2.3.12. AT+QISENDEX 发送十六进制字符串数据 .................................................................. 35 2.3.13. AT+QISENDHEX 发送十六进制字符串数据扩展命令 ................................................. 36 2.3.14. AT+QISWTMD 切换数据访问模式 .............................................................................. 38 2.3.15. AT+QPING 进行远程服务器 Ping 操作 ....................................................................... 39 2.3.16. AT+QNTP 使用 NTP 服务器同步本地时间.................................................................. 40 2.3.17. AT+QIDNSCFG 配置 DNS 服务器地址....................................................................... 41 2.3.18. AT+QIDNSGIP 用域名获取 IP 地址............................................................................. 42 2.3.19. AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 ............................................... 43 2.3.20. AT+QIGETERROR 查询上一个 AT 命令错误代码 ...................................................... 44 2.4. URC 说明 .................................................................................................................................. 44 2.4.1. +QIURC: 'closed' 连接断开通知 ................................................................................. 44 2.4.2. +QIURC: 'recv' 数据接收通知..................................................................................... 45 2.4.3. +QIURC: 'incoming full' 客户端连接已满通知 ............................................................ 45 2.4.4. +QIURC: 'incoming' 客户端连接通知 ......................................................................... 46 2.4.5. +QIURC: 'pdpdeact' PDP 去激活通知........................................................................ 46 3 示例 ...................................................................................................................................................... 47 上海移远通信技术股份有限公司 4 / 59 LTE Standard(U)系列 TCP/IP 应用指导 3.1. 场景配置和激活 ......................................................................................................................... 47 3.1.1. 场景配置 ......................................................................................................................... 47 3.1.2. 场景激活 ......................................................................................................................... 47 3.1.3. 场景去激活 ..................................................................................................................... 47 3.1.4. 设置异步/同步激活或去激活操作.................................................................................... 47 3.2. TCP 客户端在缓存模式下工作 .................................................................................................. 49 3.2.1. 创建 TCP 客户端连接并进入缓存模式 ........................................................................... 49 3.2.2. Buffer 模式下发送数据 ................................................................................................... 49 3.2.3. Buffer 模式下从远程服务器接收数据.............................................................................. 50 3.2.4. 断开连接 ......................................................................................................................... 50 3.3. TCP 客户端在透传模式下工作 .................................................................................................. 50 3.3.1. 创建 TCP 客户端连接并进入透传模式 ........................................................................... 50 3.3.2. 透传模式下发送数据....................................................................................................... 51 3.3.3. 透传模式接收远程器端数据 ............................................................................................ 51 3.3.4. 断开 TCP 客户端连接 ..................................................................................................... 51 3.4. TCP 客户端在直吐模式下工作 .................................................................................................. 51 3.4.1. 创建 TCP 客户端连接并进入直吐模式 ........................................................................... 51 3.4.2. 直吐模式下发送数据....................................................................................................... 51 3.4.3. 直吐模式下接收远程服务器端数据 ................................................................................. 52 3.4.4. 断开 TCP 用户端连接 ..................................................................................................... 52 3.5. TCP 服务器在缓存模式下工作 .................................................................................................. 52 3.5.1. 启动 TCP 服务器 ............................................................................................................ 52 3.5.2. 接受客户端的连接请求 ................................................................................................... 53 3.5.3. 接收的客户端数据 .......................................................................................................... 53 3.5.4. 断开 TCP 服务器连接 ..................................................................................................... 53 3.6. UDP 服务示例 ........................................................................................................................... 53 3.6.1. 打开 UDP 服务 ............................................................................................................... 53 3.6.2. 向服务器发送 UDP 数据................................................................................................. 54 3.6.3. 接收远程端数据 .............................................................................................................. 54 3.6.4. 关闭 UDP 服务 ............................................................................................................... 54 3.7. PING.......................................................................................................................................... 55 3.8. 同步本地时间............................................................................................................................. 55 3.9. 获取上一个错误代码示例 .......................................................................................................... 55 4 错误代码 ............................................................................................................................................... 56 5 附录 参考文档及术语缩写 ................................................................................................................... 58 上海移远通信技术股份有限公司 5 / 59 LTE Standard(U)系列 TCP/IP 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型 ..................................................................................................................................... 11 表 3：错误代码列表.................................................................................................................................... 56 表 4：参考文档 ........................................................................................................................................... 58 表 5：术语缩写 ........................................................................................................................................... 58 上海移远通信技术股份有限公司 6 / 59 LTE Standard(U)系列 TCP/IP 应用指导 1 引言 移远通信 LTE Standard(U)系列模块内置 TCP/IP 协议栈，Host 可以直接通过 AT 命令访问网络；这大 大降低模块对 PPP 和外部 TCP/IP 协议栈的依赖性，从而降低终端设计的成本。 LTE Standard(U)系列模块可提供 TCP 客户端、UDP 客户端、TCP 服务器和 UDP 服务器等 Socket 服务。 1.1. 适用模块 表 1：适用模块 模块系列 EC200D ECx00G ECx00U EGx00U EG700G EG91xU 模块 EC200D 系列 EC200G-CN EC600G-CN EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG912U-GL EG915U 系列 上海移远通信技术股份有限公司 7 / 59 LTE Standard(U)系列 TCP/IP 应用指导 1.2. 数据访问模式说明 LTE Standard(U)系列模块支持以下 3 种数据访问模式： 1. 缓存模式； 2. 直吐模式； 3. 透传模式。 当使用 AT+QIOPEN 打开 Socket 服务时，可以通过来指定 Socket 的数据访问模式； 当 Socket 服务成功打开后，可以通过 AT+QISWTMD 切换数据访问模式。 1. 缓存模式下，可以通过 AT+QISEND 发送数据。从网络接收数据时，模块会缓存所接收的数据， 并直接上报 URC +QIURC: 'recv',，之后用户可以通过 AT+QIRD 来读取缓存数据。 2. 直吐模式下，可以通过 AT+QISEND 发送数据。从网络接收数据时，数据会以如下格式直接输出 到 COM 口：+QIURC: 'recv',,。 3. 透传模式下，相对应的串口（比如 UART 口、USB Modem 口等）会进入独占模式，通过 COM 口接收的数据会直接发送到网络端，从网络接收到的数据会从 COM 口直接输出。+++可以用来退 出透传模式：当输入+++返回 OK 后，访问模式就会切换到缓存模式，如需切换回透传模式，可使 用 AT+QISWTMD。 ⚫ 退出透传模式 用户可以通过+++或者 DTR（需先设置 AT&D1）两种方式退出透传模式，为了防止+++被当成数据发 送，实际操作时必须遵循以下步骤： 1） +++输入前 1 秒或更长时间内不能输入其它任何数据； 2） 必须在 1 秒内输入+++，并且不能输入其它任何数据； 3） +++输入后 1 秒内不能输入其它任何数据； 4） 通过+++或者 DTR（设置 AT&D1）方式使模块退出透传模式，直到模块返回 OK；此时模块成功退 出透传模式。 ⚫ 切换到透传模式 1） 通过执行 AT+QISWTMD：执行此命令时，指定为 2；若返回 CONNECT，则表 示成功切换至透传模式。 2） 通过 ATO 方式：退出透传模式后，可通过 ATO 再切换回至透传模式；若返回 CONNECT，则表示 成功切换至透传模式。若模块之前未曾进入过透传模式，执行 ATO 则会返回 NO CARRIER。 备注 1. 在缓存模式下，如果缓存不为空，直到通过 AT+QIRD 读取缓存里面所有接收的数据后，模块才会 上报一个新的 URC。 2. 在透传模式下，不可执行 AT 命令。若因网络错误或者其他原因导致 Socket 连接断开，模块会上报 上海移远通信技术股份有限公司 8 / 59 LTE Standard(U)系列 TCP/IP 应用指导 NO CARRIER，并退出透传模式，在这种情况下可以执行 AT+QICLOSE 来关闭 Socket 服务。 1.3. TCP/IP 使用 TCP/IP AT 命令的流程 通过 TCP/IP AT 命令，Host 可以配置、激活/去激活 PDP 上下文、打开/关闭 Socket 服务，并通过 Socket 服务发送/接收数据。TCP/IP AT 命令的使用流程如下图所示： 上海移远通信技术股份有限公司 9 / 59 LTE Standard(U)系列 TCP/IP 应用指导 建议开关机流程： 1.关机：发送AT+QPOWD，等待12秒以 上，直接断电。 2. 开机：先使Power Key按键处于低电平 状态，等待2秒后，再拉高Power Key 查询(U)SIM卡状态： 执行AT+CPIN，如果20秒后命令 'AT+CPIN'无法识别(U)SIM卡状态，建议 重启模块 PS 业务： 1. 当 AT+CGREG?/AT+CEREG? 结果中 的等于 1 或者5，表示模块已在 UMTS/LTE网络注册上PS业务 2. 等待60秒后，不管是否注册上PS业务， 都进入下一个流程 配置PDP Context激活参数： 1. 通过 AT+QICSGP 命令配置APN， User Name，Password 和Auth Type 2. 通过 AT+CGQMIN/AT+CGEQMIN/ AT+CGQREQ/AT+CGEQREQ 配置 QoS 参数 给模块上电并开机 发送AT命令并等待响应结果OK 通过AT+CPIN?命令 查询(U)SIM卡状态 如果在20秒内无法识别 (U)SIM状态，建议重启模块 识别(U)SIM卡 60秒内通过 AT+CGREG?/AT+CEREG?命 令查询PS业务的状态 如果获取 PS 状态失败，建议 重新配置 PDP 上下文，然后 执行 AT+CFUN=0 和 AT+CFUN=1。 如果仍然获 取失败，建议重启模块。 通过如下AT命令来配置PDP场景和QoS 参数:AT+QICSGP/AT+CGQREQ/ AT+CGEQREQ/AT+CGQMIN/ AT+CGEQMIN 激活PDP Context： 1. 通过 AT+QIACT= 激活PDP Context 2. 通过 AT+QIACT? 查询PDP Context IP地址 注意事项： a) 以上命令必须按顺序执行 b) 如果等待150秒后，AT+QIACT 没有响应，建议重启模块. c) 如果连续3次反激活PDP Context 失败，建议重启模块 3. 反激活PDP Context：如果等待 40s后AT+QIDEACT没有响应，建 议重启模块 如果等待 40秒,没有响 应，建议重启 模块 PDP Context 反 激活成功 通过 AT+QIACT= 和AT+QIACT命令激活指定 的PDP Context 1. 如果等待150秒后，没有收到 结果，建议重启模块. 2. 如果连续3次反激活PDP context失败，建议重启模块 PDP Context 激活失败 PDP Context激活成功 通过AT+QIDE ACT=命令反 激活指定的PDP Context 通过AT+QIOPEN命令 打开连接 1. 连续5次打开连接失败 2. 150秒内无响应 +QIOPEN:, 打开连接： 1. 如果等待150秒，没有收到AT+QIOPEN的响应，请关闭 连接。 通过AT+QISEND=命令 2.如果连续5次打开连接失败，先反激活PDP Context，然后 发送数据 重新激活PDP Context并再次打开连接。 在收到ACK 90 秒后 通过AT+QISEND= TCP连接的维护和检测： 1. 通过 AT+QISEND=[,] 发送数据。 建议定期向远程端发送小数据包以维护和检测TCP连接。 ,0命令查询 发送的数据是否成功被接 收 2. 通过 AT+QISEND=,0 查询ACK的发送。 如果在2分钟后（每5秒查询一次，一共查询24次），对方没有收到数据， 说明TCP连接可能出现异常，请执行AT+QICLOSE命令关闭这个TCP连 90秒内未收到ACK 接，然后通过AT+QIOPEN重新建立TCP连接。 通过 AT+QICLOSE OK = 关闭连接 如果等待10秒，无响应，建议重启 模块 注意事项： 1. 请注意必须接收到上一个AT命令的执行结果后（例如：OK/+CME ERROR/CMS ERROR），才能执行下一个AT命令。一般情况下，如果在60秒内 没有收到AT命令执行结果，建议重启模块。 2. 若150秒内未收到AT+QIACT响应，10秒内未收到AT+QICLOSE响应，40秒内未收到AT+QIDEACT响应，建议重启模块。 3. 不建议频繁重启模块。如果因为执行AT命令连续3次重启模块失败，此后第一次可立即重启，然后等待10分钟，再进行第二次重启，如果仍重启失 败，建议等待30分钟，再进行第三次重启，以此类推，逐渐增大重启的时间间隔。 图 1：TCP/IP AT 命令使用流程图 上海移远通信技术股份有限公司 10 / 59 LTE Standard(U)系列 TCP/IP 应用指导 2 TCP/IP AT 命令详解 本章节主要描述和 TCP/IP 相关的 AT 命令。 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 11 / 59 LTE Standard(U)系列 TCP/IP 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QICFG 配置可选参数 该命令用于配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应 +QICFG: 'transpktsize',(支持的范围) +QICFG: 'transwaittm',(支持的范围) +QICFG: 'dataformat',(支持的列表), (支持的列表) +QICFG: 'viewmode',(支持的列表) +QICFG: 'udp/sendmode',(支持的列表) +QICFG: 'udp/readmode',(支持的列表) +QICFG: 'tcp/accept',(支持的列表) +QICFG: 'passiveclosed',(支持的列表) +QICFG: 'tcp/twrecycle',(支持的列表) +QICFG: 'close/mode',(支持的列表) +QICFG: 'pdp/retry',(支持的列表),(支持的列表),(支持的范围),(支持的范 围) +QICFG: 'recvind',(支持的列表) +QICFG: 'sendinfo',(支持的列表) +QICFG: 'tcp/keepalive',(支持的列表),(支持的范围),(支持的范围),(支持的范围) +QICFG: 'tcp/retranscfg',(支持的范围),(支持 的范围) +QICFG: 'send/auto',(支持的范围),(支持的范围),,(支持的范围) +QICFG: 'recv/ignore',(支持的范围), +QICFG: 'formatcfg',(支持的列表) +QICFG: 'qisend/timeout',(支持的范围) 上海移远通信技术股份有限公司 12 / 59 LTE Standard(U)系列 TCP/IP 应用指导 +QICFG: 'tcp/serveropt',( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范围) +QICFG: 'send/buffersize',(支持的范围) +QICFG: 'tcp/inactivetm',(支持的范围) 设置命令 设置待发数据最大长度： AT+QICFG='transpktsize'[,] OK 响应 若省略可选参数，则查询当前配置： +QICFG: 'transpktsize', OK 若指定可选参数，则设置待发数据最大长度： OK 设置命令 设置透传模式等待时间： AT+QICFG='transwaittm'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'transwaittm', OK 若指定可选参数，则设置等待时间： OK 若出现任何错误： 设置命令 ERROR 响应 设置收发数据格式（仅限非透传模式）： 若省略可选参数，则查询当前配置： AT+QICFG='dataformat'[,<send_da +QICFG: 'dataformat',,,] rmat> OK 若指定可选参数，则设置收发数据格式： OK 设置命令 设置已接收数据的输出格式（仅限非透 传模式）： 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'viewmode', 上海移远通信技术股份有限公司 13 / 59 LTE Standard(U)系列 TCP/IP 应用指导 AT+QICFG='viewmode'[,] OK 若指定可选参数，则设置已接收数据的输出格式： OK 设置命令 设置 UDP 数据的发送模式： AT+QICFG='udp/sendmode'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'udp/sendmode', OK 若指定可选参数，则设置 UDP 数据的发送模式： OK 设置命令 设置 UDP 数据的读取模式： AT+QICFG='udp/readmode'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'udp/readmode', OK 若指定可选参数，则设置 UDP 数据的读取模式： OK 设置命令 启用或禁用自动接收来自客户端的 TCP 连接： AT+QICFG='tcp/accept'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/accept', OK 若指定可选参数，则设置启用或禁用自动接收来自客户端的 TC P 连接： OK 若出现任何错误： 设置命令 ERROR 响应 设 置 是 否 在 服 务 器 关 闭 时 被 动 关 闭 若省略可选参数，则查询当前配置： 上海移远通信技术股份有限公司 14 / 59 LTE Standard(U)系列 TCP/IP 应用指导 TCP 连接： +QICFG: 'passiveclosed', AT+QICFG='passiveclosed'[,] OK 若指定可选参数，则设置是否在服务器关闭时被动关闭 TCP 连 接： OK 设置命令 设置启用或禁用断开连接时快速释放 PCB： AT+QICFG='tcp/twrecycle'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/twrecycle', OK 若指定可选参数，则设置启用或禁用断开连接时快速释放 PCB： OK 设置命令 启 用 或 禁 用 以 URC 形 式 显 示 AT+QICLOSE 返回信息： AT+QICFG='close/mode'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'close/mode', OK 若指定可选参数，则设置启用或禁用以 URC 形式显示 AT+QIC LOSE 返回信息： OK 若出现任何错误： 设置命令 ERROR 响应 设置 PDP 激活或去激活重试次数和时 若省略可选参数，则查询当前配置： 间： +QICFG: 'pdp/retry',,,,<re AT+QICFG='pdp/retry', try_time> ,[,, ] OK 若指定可选参数，则配置 PDP 激活或去激活重试次数和时间： OK 若出现任何错误： 上海移远通信技术股份有限公司 15 / 59 LTE Standard(U)系列 TCP/IP 应用指导 ERROR 设置命令 设置在缓存模式下，模块接收到数据后 上报的 URC 是否显示数据长度： AT+QICFG='recvind'[,] 响应 若省略可选参数，则查询当前配置： [+QICFG: 'recvind',] OK 若指定可选参数，则设置接收到数据后上报的 URC 是否显示数 据长度： OK 设置命令 启 用 或 禁 用 以 URC 形 式 显 示 AT+QISEND 、 AT+QISENDEX 和 AT+QISENDHEX 返回信息： AT+QICFG='sendinfo'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'sendinfo', OK 若 指 定 可 选 参 数 ， 则 设 置 启 用 或 禁 用 以 URC 形 式 显 示 AT+QISEND 或 AT+QISENDEX 返回信息： OK 若出现任何错误： 设置命令 ERROR 响应 设置是否发送 TCP 保活信息： 若省略可选参数，则查询当前配置： AT+QICFG='tcp/keepalive',<enabl +QICFG: 'tcp/keepalive',,,[,,,, obe_cnt>] OK 若指定可选参数，则设置是否发送 TCP 保活信息： OK 设置命令 设置 TCP 重传参数： AT+QICFG='tcp/retranscfg'[,[,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/retranscfg',, OK 上海移远通信技术股份有限公司 16 / 59 LTE Standard(U)系列 TCP/IP 应用指导 若指定可选参数，则设置 TCP 重传参数： OK 若出现任何错误： ERROR 设置命令 配置在指定通道发送指定数据： 响应 若省略可选参数，则查询当前配置： AT+QICFG='send/auto',<connectID +QICFG: 'send/auto',,,, >[,[,][,<send_a uto_format >]] OK 若指定可选参数，则配置在指定通道定时发送指定数据： OK 若出现任何错误： 设置命令 ERROR 响应 配置忽略指定通道接收到的特定数据： 若省略可选参数，则查询当前配置： AT+QICFG='recv/ignore',<connectI +QICFG: 'recv/ignore',, D>[,] OK 若指定可选参数，则配置忽略指定通道接收到的特定数据： OK 若出现任何错误： 设置命令 ERROR 响应 设置 AT+QISEND 进入透传模式时'>' 若省略可选参数，则查询当前配置： 的格式： +QICFG: 'formatcfg', AT+QICFG='formatcfg'[,] OK 若指定可选参数，则设置 AT+QISEND 进入透传模式时'>'的格 式： OK 设置命令 设置 AT+QISEND 进入透传模式时，无 数据输入的超时时间： 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'qisend/timeout', 上海移远通信技术股份有限公司 17 / 59 LTE Standard(U)系列 TCP/IP 应用指导 AT+QICFG='qisend/timeout'[,] OK 若指定可选参数，则设置 AT+QISEND 进入透传模式时，无数据 输入的超时时间： OK 设置命令 设置 PDP 上下文后台自动保活功能： AT+QICFG='tcp/serveropt',[,][,,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/serveropt',,,, OK 若指定可选参数，则配置指定 PDP 上下文保活时间： OK 设置命令 设置单次发送数据的最大长度： AT+QICFG='send/buffersize'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'send/buffersize', OK 若指定可选参数，则设置单次发送数据的最大长度： OK 设置命令 设置 TCP 不活动时间： AT+QICFG='tcp/inactivetm'[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/inactivetm', OK 若指定可选参数，则设置 TCP 不活动时间： OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 18 / 59 LTE Standard(U)系列 TCP/IP 应用指导 最大响应时间 特性说明 / 该命令立即生效； 参数配置不保存。 参数 整型。待发数据包字节最大长度。范围：1~1460；默认值：1024；单位：字节。 整型。在透传模式下，若从端口接收的数据长度小于指定长度， 超出指定时间后数据可直接发送。范围：0~20；默认值：2； 单位：毫秒。 整型。发送数据格式。当设置为十六进制模式时，不需要带 0x 前缀，模块会 自动将两个字节拼成一个 ASCII 码。 0 文本模式 1 十六进制模式 整型。接收数据格式。当设置为十六进制模式时，不需要带 0x 前缀，模块会 自动将两个字节拼成一个 ASCII 码。 0 文本模式 1 十六进制模式 整型。接收数据的输出方式。 0 data headerrndata. 1 data header,data. 整型。 0 禁用块模式 1 启用流模式 整型。启用或禁用自动接受来自客户端的 TCP 连接。 0 禁用 1 启用 整型。启用或禁用 TCP 连接在服务器关闭后自动断开。 0 禁用 1 启用 整型。启用或禁用断开连接时快速释放 PCB。 0 禁用 1 启用 整型。启用或禁用以 URC 形式显示 AT+QICLOSE 返回信息。 0 禁用 1 启用 整型。设置 PDP 激活或去激活模式。 0 去激活模式 1 激活模式 整型。设置网络制式类型。 0 4G 模式 1 2G 模式 整型。重试次数。范围：2~4；默认值：4。注意如果配置为 4 则实际执行激活 上海移远通信技术股份有限公司 19 / 59 LTE Standard(U)系列 TCP/IP 应用指导 或去激活次数为 5 次。 整型。单次执行激活或去激活的最大时间。单位：秒。 2G：激活配置范围：5~30；默认值：10。去激活配置范围：2~8；默认值：5。 4G：激活配置范围：5~8；默认值：8。去激活配置范围：2~6；默认值：6。 整型。在缓存模式下，启用或禁用模块在接收到数据后上报的 URC 中显示数 据长度。 0 禁用 1 启用 整 型 。 启 用 或 禁 用 以 URC 形 式 显 示 AT+QISEND 、 AT+QISENDEX 和 AT+QISENDHEX 返回信息。 0 禁用 1 启用 整型。启用或禁用发送 TCP 保活信息。 0 禁用 1 启用 整型。触发保活循环时间。范围：1~1800；单位：秒。 整型。在循环时间内发送数据包间隔时间。范围：25~100；单位：秒。 整型。在循环时间内发送数据包的次数。范围：3~10。 整型。TCP 重传次数。范围 3~12；默认值：8；单位：次。 整型。TCP 重传周期。范围 5~60；默认值：6；单位：秒。 整型。Socket ID。范围：0~11。 整型。配置指定通道定时发送指定数据的周期。范围：20~65535；单位：秒。 字符串类型。十六进制的发送数据类型。最大长度：400 字节。 整型。设置输入的数据类型。 0 输入 ASCII 十六进制数据，将转换为字符串 1 输入十六进制数据，将直接作为字符串数据处理 2 输入字符串数据 字符串类型。十六进制的接收数据类型。最大长度：400 字节。 整型。设置 AT+QISEND 后的提示符格式。S3、S4 为 ATS3、ATS4 的配置值。 0 'S3S4>' 1 'S3S4>S3S4' 整型。AT+QISEND 的输入超时时间。范围：0~120；默认值：5；单位：秒。 整型。服务器配置选项。 1 PDP 激活场景保活功能 整型。禁用或使能对应指定的功能。 0 禁用 1 使能 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围： 1~11。 整型。保活时间。范围：1~1800；默认值：300；单位：秒。 整型。单次发送数据的长度。范围：1460~10240；默认值：1460；单位：字 节。 整型。TCP 不活动时间。范围：0-65535；默认值：90；单位：秒。 上海移远通信技术股份有限公司 20 / 59 LTE Standard(U)系列 TCP/IP 应用指导 2.3.2. AT+QICSGP 配置 TCP/IP 场景参数 该命令用于配置、和以及其他 TCP/IP 场景参数。QoS 配置需通过 AT+CGQMIN 与 AT+CGQREQ。有关所述 AT 命令的详情，请参考文档 [1]。 AT+QICSGP 配置 TCP/IP 场景参数 测试命令 AT+QICSGP=? 响应 +QICSGP: (支持的范围),(支持的范围),,,,(支持的范围) 设置命令 查询指定场景配置： AT+QICSGP= OK 响应 +QICSGP: ,,,, OK 设置命令 配置指定场景： AT+QICSGP=[,,[,,)[,]]] 响应 OK 若出现任何错误： ERROR 最大响应时间 / 特性说明 该命令立即生效； 参数配置自动保存。 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型。接入点名称。 字符串类型。用户名。最大长度：127 字节。 字符串类型。密码。最大长度：127 字节。 整型。APN 鉴权方式。 0 None 1 PAP 2 CHAP 3 PAP_CHAP （仅 EC200D 系列模块支持） 上海移远通信技术股份有限公司 21 / 59 举例 AT+QICSGP=1 +QICSGP: 1,'','','',0 OK AT+QICSGP=1,1,'UNINET','','',1 OK LTE Standard(U)系列 TCP/IP 应用指导 //查询场景 1 配置。 //配置场景 1，APN 配置为'UNINET'（中国联通）。 2.3.3. AT+QIACT 激活 PDP 上下文 在用 AT+QIACT 激活 PDP 上下文前，需要使用 AT+QICSGP 配置场景。场景激活后，可以通过 AT+QIACT?查询 IP 地址。 禁用或不支持 VoLTE 时，取值为 1~7，最大可激活 7 个 PDP 上下文；启用 VoLTE 时， 取值为 1~5，最大可激活 5 个 PDP 上下文。EC200D 系列模块禁用或不支持 VoLTE 时， 取值为 1~11，最大可激活 11 个 PDP 上下文；启用 VoLTE 时，取值为 1~9，最 大可激活 9 个 PDP 上下文。实际能激活的 PDP 上下文个数取决于(U)SIM 卡。受网络状态影响，执行 AT+QIACT 后，等待返回结果 OK 或者 ERROR 的最大时间为 150 秒，最大超时返回时间可以通过 AT+QICFG='pdp/retry',,[,,]配置，在结果尚未返回之前， 不允许执行任何 AT 命令。 AT+QIACT 激活 PDP 上下文 测试命令 AT+QIACT=? 响应 +QIACT: (支持的范围) 查询命令 AT+QIACT? OK 响应 返回当前所有被激活的场景与 IP 地址： +QIACT: 1,,[,][,] ... +QIACT: 7,,[,][,] 设置命令 激活指定 PDP 上下文： AT+QIACT= 最大响应时间 OK 响应 OK 若出现任何错误： ERROR 受网络状态影响，最大响应时间 150 秒。 上海移远通信技术股份有限公司 22 / 59 LTE Standard(U)系列 TCP/IP 应用指导 特性说明 / 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 整型。场景状态。 0 去激活 1 激活 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型。场景激活后的本地 IPv4 地址。 字符串类型。场景激活后的本地 IPv6 地址。 备注 EC200D 系列模块开启 VoLTE 功能后，的范围为 1~9。其他模块开启 VoLTE 功能后， 的范围为 1~5。 2.3.4. AT+QIDEACT 去激活 PDP 上下文 该命令用于去激活特定场景，断开在这个场景内建立的所有 TCP/IP 连接。受网络状态影响，执行 AT+QIDEACT 后，等待返回结果 OK 或者 ERROR 的最大时间为 40 秒。最大超时返回时间可以通过 AT+QICFG='pdp/retry',,[,,]配置，在结果尚未返回之前， 无法执行任何 AT 命令。 AT+QIDEACT 去激活 PDP 上下文 测试命令 AT+QIDEACT=? 响应 +QIDEACT: (支持的范围) 设置命令 去激活指定 PDP 上下文： AT+QIDEACT= 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 受网络状态影响，最大响应时间 40 秒。 / 上海移远通信技术股份有限公司 23 / 59 参数 LTE Standard(U)系列 TCP/IP 应用指导 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 2.3.5. AT+QIACTEX 异步激活 PDP 上下文 使用此命令前，需要使用 AT+QICSGP 来配置场景。场景激活后，可以通过 AT+QIACTEX?来查询 IP 地址。 禁用或不支持 VoLTE 时，取值为 1~7，最大可激活 7 个 PDP 上下文；启用 VoLTE 时， 取值为 1~5，最大可激活 5 个 PDP 上下文。EC200D 系列模块禁用或不支持 VoLTE 时， 取值为 1~11，最大可激活 11 个 PDP 上下文；启用 VoLTE 时，取值为 1~9，最 大可激活 9 个 PDP 上下文。实际能激活的 PDP 上下文个数取决于(U)SIM 卡。执行 AT+QIACTEX 后，立 即返回结果 OK 或者 ERROR，URC +QIACTEX 会显示 PDP 上下文激活结果；受网络状态影响，最大 URC 返回时间可以通过 AT+QICFG='pdp/retry',,[,,]配置。 AT+QIACTEX 异步激活 PDP 上下文 测试命令 AT+QIACTEX=? 响应 +QIACTEX: ( 支 持 的 范 围 ),( 支 持 的 列表) 查询命令 AT+QIACTEX? OK 响应 返回当前所有被激活的场景与 IP 地址： +QIACTEX: 1,,[,][,] ... +QIACTEX: 7,,[,][,] 设置命令 AT+QIACTEX=[,] OK 响应 若=0，激活指定场景： OK +QIACTEX: , 若=1，激活指定场景： OK +QIACTEX: ,[,[,][,] 上海移远通信技术股份有限公司 24 / 59 LTE Standard(U)系列 TCP/IP 应用指导 最大响应时间 特性说明 若出现任何错误： ERROR 受网络状态影响，最大响应时间 150 秒。 / 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 整型。是否显示 IP 地址及类型。 0 关闭 1 开启 整型。场景状态。 0 被去激活 1 被激活 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型。场景激活后的本地 IPv4 地址。 字符串类型。场景激活后的本地 IPv6 地址。 错误码。请参考第 4 章。 2.3.6. AT+QIDEACTEX 异步去激活 PDP 上下文 该命令用于异步去激活特定场景，断开在此场景内建立的所有 TCP/IP 连接。执行 AT+QIDEACTEX 后，立即返回结果 OK 或者 ERROR，URC +QIDEACTEX 会显示 PDP 上下文去激活结果，受网络状态影 响，可通过 AT+QICFG='pdp/retry',,[,,]配置最大 URC 返 回时间。 AT+QIDEACTEX 异步去激活 PDP 上下文 测试命令 AT+QIDEACTEX=? 响应 +QIDEACTEX: (支持的范围) 设置命令 AT+QIDEACTEX= OK 响应 OK +QIDEACTEX=, 若出现任何错误： 上海移远通信技术股份有限公司 25 / 59 LTE Standard(U)系列 TCP/IP 应用指导 最大响应时间 特性说明 ERROR 受网络状态影响，最大响应时间 40 秒。 / 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 错误码。请参考第 4 章。 2.3.7. AT+QIOPEN 打开 Socket 服务 该命令用于打开 Socket 服务。服务类型可通过指定，数据访问模式（缓存模式，直吐 模式和透传模式）可通过配置，URC +QIOPEN 将指示 Socket 服务是否成功打开。 1. 如果的服务类型是'TCP LISTENER'，那么模块作为 TCP 服务器使用。接受一个 新的 TCP 连接后，模块会自动指定一个并上报 URC +QIURC: 'incoming',,,,；其中范围为 0~11；所述新连接 的请求类型为'TCP INCOMING'，它的值和'TCP LISTENER'的该参数值一样。 2. 如果的服务类型是'UDP SERVICE'，则可通过向远程 IP 收发 UDP 数据。 ⚫ 发送数据：执行 AT+QISEND=,,,。 ⚫ 在直吐模式下接收数据：模块会上报 URC +QIURC: 'recv',,,,。 ⚫ 在缓存模式下接收数据：模块会上报 URC +QIURC: 'recv',，然后用户可通过 AT+QIRD=[,]读取数据。 3. 等待+QIOPEN: ,输出，建议等待 150 秒；如果 150 秒内未接收到该 URC，则 需通过 AT+QICLOSE 来关闭 Socket，同时也可以配置来控制等待时间。 AT+QIOPEN 打开 Socket 服务 测试命令 AT+QIOPEN=? 响应 +QIOPEN: (支持的范围),(支持的 范围),'TCP/UDP/TCP LISTENER/UDP SERVICE','/',,,(支 持的范围),(支持的 范围),(支持的范围) OK 上海移远通信技术股份有限公司 26 / 59 LTE Standard(U)系列 TCP/IP 应用指导 设置命令 AT+QIOPEN=,,,'/',[,[,[,[,]]]] 响应 如果数据访问模式是透传模式（=2）并且成 功打开服务： CONNECT 若出现任何错误： ERROR 可以通过 AT+QIGETERROR 获悉错误描述。 如果数据访问模式是缓存模式（=0）或者直 吐模式（=1）： OK +QIOPEN: , 最大响应时间 特性说明 当服务成功打开，是 0，其他情况下不是 0。 受网络状态影响，最大响应时间 150 秒。 / 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 整型。Socket ID。范围：0~11。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'UDP SERVICE' 建立 UDP 服务 字符串类型。 如 果 是 'TCP' 或 'UDP', 则 为 远 程 服 务 器 的 IP 地 址 ， 例 如 220.180.239.212。 如果是'TCP LISTENER'或'UDP SERVICE'，请输入 127.0.0.1。 字符串类型。远程服务器的域名地址。 整型。远程服务器端口。范围：0~65535。仅当是'TCP'或'UDP' 时才有效。 整型。本地端口。范围：0~65535。 如果是'TCP LISTENER'或'UDP SERVICE'，该参数必须指定。 如果是'TCP'或'UDP'，且=0，那么将会自动分 配 本地端口；否则本地端口会被指定。 整型。Socket 服务的数据访问模式。 0 缓存模式 1 直吐模式 上海移远通信技术股份有限公司 27 / 59 LTE Standard(U)系列 TCP/IP 应用指导 2 透传模式 整型。范围：0~11；仅在为'TCP LISTENER'时生效，可以控制 client 连接的最大数量。默认值：11。 整型。范围 10~150；单位：秒。 错误码。请参考第 4 章。 2.3.8. AT+QICLOSE 关闭 Socket 服务 该命令用于关闭特定的 Socket 服务。受网络状态影响，执行 AT+QICLOSE 后，等待返回结果 OK 或 者 ERROR 的最大时间为 10 秒（此为默认值，可以通过来修改）。在结果尚未返回之前，无法 执行任何 AT 命令。 AT+QICLOSE 关闭 Socket 服务 测试命令 AT+QICLOSE=? 响应 +QICLOSE: (支持的范围),(支持的范 围) OK 设置命令 AT+QICLOSE=[,] 响应 （1）若=0： 关闭成功： OK 关闭失败： ERROR （2）若=1： 关闭成功： OK +QIURC: 'closed', 最大响应时间 特性说明 关闭失败： ERROR 默认 10 秒，取决于取值。 / 参数 整型。Socket ID。范围：0~11。 整型。输出响应结果的超时时间值。若未在时间范围内接收到其他客户端的 上海移远通信技术股份有限公司 28 / 59 LTE Standard(U)系列 TCP/IP 应用指导 FIN ACK，模块会强制关闭 Socket。范围：0~65535；默认值：10；单位：秒。 整型。设置是否以 URC 形式显示 AT+QICLOSE 返回信息。 0 禁用 1 启用 2.3.9. AT+QISTATE 查询 Socket 服务状态 该命令用于查询 Socket 服务状态。若为 0，则返回在特定场景下现存所有 Socket 服务 的状态；若为 1，则返回特定 Socket 服务的状态。 AT+QISTATE 查询 Socket 服务状态 测试命令 AT+QISTATE=? 响应 OK 查询/执行命令 AT+QISTATE?或 AT+QISTATE 响应 返回现存所有连接状态： +QISTATE: ,,,< remote_port>,,,,< serverID>,, […] OK 设置命令 若=0，查询特定场景下的 连接状态： AT+QISTATE=, 响应 返回特定场景下现存所有连接的状态： +QISTATE: ,,,< remote_port>,,,,< serverID>,, […] 设置命令 若=1，查询特定 Socket 服务连接状态： AT+QISTATE=, 最大响应时间 OK 响应 +QISTATE: ,,,< remote_port>,,,,< serverID>,, OK / 特性说明 / 参数 整型。查询类型。 上海移远通信技术股份有限公司 29 / 59 LTE Standard(U)系列 TCP/IP 应用指导 0 查询特定场景下所有 Socket 服务的连接状态 1 查询特定 Socket 服务连接状态 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 整型。Socket ID。范围：0~11。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'TCP INCOMING' 建立 TCP 服务器接受的 TCP 连接 'UDP SERVICE' 建立 UDP 服务 'UDP INCOMING' 建立 UDP 服务器接受的 UDP 连接 字符串类型。IP 地址。 若为'TCP'或'UDP'，则指远程服务器 IP 地址 若为'TCP LISTENER'或'UDP SERVICE'，则指本地 IP 地址 若为'TCP INCOMING'或'UDP INCOMING'，则指远程客户端 IP 地址 整型。远程端口。 若为'TCP'或'UDP'，则指远程服务器端口 若为'TCP LISTENER'或'UDP SERVICE'，则端口无效 若为'TCP INCOMING'或'UDP INCOMING'，则指远程客户端端口 整型。本地端口。 若为 0，本地端口自动分配 整型。Socket 服务状态。 0 'Initial'：尚未建立连接 1 'Opening'：客户端正在连接或者服务器正尝试监听 2 'Connected'：客户端连接已建立 3 'Listening'：服务器正在监听 4 'Closing'：连接断开 整型。只有当是'TCP INCOMING'时才有效。代表哪个服务 器接受了这个 TCP 连接，这个参数值和该服务器'TCP LISTENER'的值一 样。 整型。数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 字符串类型。Socket 服务的 COM 口。 'usbmodem' USB modem port 'usbat' USB AT port 'uart1' UART port 1 'cmux1' MUX port 1 'cmux2' MUX port 2 'cmux3' MUX port 3 'cmux4' MUX port 4 上海移远通信技术股份有限公司 30 / 59 LTE Standard(U)系列 TCP/IP 应用指导 2.3.10. AT+QISEND 发送数据 若特定 Socket 服务的数据访问模式是缓存模式（当=0 时）或者直吐模式（当 =1 时），可以通过 AT+QISEND 发送数据。若成功发送数据到模块，则返回 SEND OK， 否则返回 SEND FAIL 或 ERROR。SEND FAIL 表示发送缓存已满，可以尝试重新发送数据；ERROR 表 示在发送数据过程中遇到错误，请延迟一段时间后再次发送数据，发送数据的最大长度为 1460 字节；SEND OK 并不表示数据已经成功发送到服务器，可以通过 AT+QISEND=,0 查询数据是否已经发送 到服务器。 AT+QISEND 发送数据 测试命令 AT+QISEND=? 响应 +QISEND: (支持的范围),(支持的范围) OK 设置命令 当 为 'TCP' 、 'UDP' 、 'TCP INCOMING'或'UDP INCOMING' 时，发送不定长数据： AT+QISEND= 响应 > 响应>后，输入需要发送的数据；按'Ctrl'+'Z'发送数据， 按'Esc'取消发送。 1. 若=0： 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立、异常断开或者参数不正确： ERROR 2. 若=1： 若连接已经建立： +QISEND: ,, OK 若连接未建立、异常断开或者参数不正确： ERROR 设置命令 当 为 'TCP' 、 'UDP' 、 'TCP INCOMING'或'UDP INCOMING' 时，发送定长数据： AT+QISEND=, 响应 > 后，输入长度等于的数据。 1. 若=0： 上海移远通信技术股份有限公司 31 / 59 LTE Standard(U)系列 TCP/IP 应用指导 gth> 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 2. 若=1： 若连接已经建立： +QISEND: ,, OK 若连接未建立、异常断开或者参数不正确： ERROR 设置命令 若='UDP SERVICE'： AT+QISEND=,,, 响应 该命令可用来发送固定字节长度数据到特定的远程 IP 地址和 远程端口，必须是'UDP SERVICE'。 > 响应 > 后，输入长度等于的数据。 若连接已经建立且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 设置命令 若=0，查询发送数据： AT+QISEND=,0 若连接未建立，异常断开或者参数不正确： ERROR 响应 若指定连接存在： +QISEND: ,, OK 最大响应时间 特性说明 若出现任何错误： ERROR / / 上海移远通信技术股份有限公司 32 / 59 LTE Standard(U)系列 TCP/IP 应用指导 参数 整型。Socket ID。范围：0~11。 整型。发送数据字节长度。范围：0~1460；单位：字节。 整型。禁用/启用 AT+QISEND 返回信息 URC。 0 禁用 1 启用 字符串类型。远程 IP 地址（必须是点分十进制格式）。只有当为'UDP SERVICE'才有效。 整型。远程端口。只有当为'UDP SERVICE'才有效。 整型。发送数据总长度。单位：字节。 整型。收到数据总长度。单位：字节。 整型。未收到数据总长度。单位：字节。 整型。发送状态。 0 发送数据到 Socket 缓冲区成功 1 接收缓冲区满，发送失败 整型。当前缓冲区中的空闲空间。范围：0~10240；单位：字节。 错误码。请参考第 4 章。 2.3.11. AT+QIRD 读取收到的 TCP/IP 数据 在缓存模式下，模块收到数据后会先缓存数据并上报+QIURC: 'recv',，之后可通过 AT+QIRD 读取所述数据。 缓存中仍有数据时，模块若再次接收到数据，将不会再上报 URC；直到缓存中所有数据均被读取，才 会上报新的 URC。 AT+QIRD 读取收到的 TCP/IP 数据 测试命令 AT+QIRD=? 响应 +QIRD: (支持的范围),(支持的范 围) OK 设置命令 当 为 'TCP' 、 'UDP' 、 'TCP INCOMING'、'UDP INCOMING' 时： 响应 若特定连接收到数据： +QIRD: AT+QIRD=[,] OK 若无数据： +QIRD: 0 上海移远通信技术股份有限公司 33 / 59 LTE Standard(U)系列 TCP/IP 应用指导 OK 设置命令 当为'UDP SERVICE' 时： AT+QIRD=[,] 若连接不存在： ERROR 响应 若数据存在： +QIRD: ,,, OK 若无数据： +QIRD: 0 OK 若连接不存在： ERROR 设置命令 当=0，查询读取的数据长 度： AT+QIRD=,0 响应 若指定连接存在： +QIRD: ,, OK 最大响应时间 特性说明 若出现任何错误： ERROR / / 参数 整型。Socket ID。范围：0~11。 整型。待读取数据的最大长度。范围：0~1500；单位：字节。 整型。实际接收数据的长度。单位：字节。 字符串类型。远程 IP 地址。只有当为'UDP SERVICE'时才有 效。 整型。远程端口。范围：1~65535。只有为'UDP SERVICE'才 有效。 字符串类型。读取的数据。单位：字节。 整型。已接收数据的总长度。单位：字节。 整型。已读取数据的长度。单位：字节。 上海移远通信技术股份有限公司 34 / 59 LTE Standard(U)系列 TCP/IP 应用指导 整型。未读取数据的长度。单位：字节。 2.3.12. AT+QISENDEX 发送十六进制字符串数据 该命令用于发送十六进制字符串数据，仅在为'TCP'、'UDP'、'TCP INCOMING'、'UDP INCOMING'类型时适用，不适用于'UDP SERVICE'和'TCP LISTENER'两种 Socket 服务类型。 AT+QISENDEX 发送十六进制字符串数据 测试命令 AT+QISENDEX=? 响应 +QISENDEX: (支持的范围), OK 设置命令 AT+QISENDEX=,< hex_string> 响应 1. 若=0： 若数据发送成功： SEND OK 若发送缓存已满： SEND FAIL 若连接不存在： ERROR 2. 若=1： 若连接已经建立： +QISENDEX: ,, OK 最大响应时间 特性说明 若连接未建立、异常断开或者参数不正确： ERROR / / 参数 整型。Socket ID。范围：0~11。 字符串类型。十六进制字符串数据。最大长度：512 字节。 整型。禁用/启用 AT+QISENDEX 返回信息 URC。 0 禁用 1 启用 上海移远通信技术股份有限公司 35 / 59 LTE Standard(U)系列 TCP/IP 应用指导 整型。发送状态。 0 发送数据到 Socket 缓冲区成功 1 接收缓冲区满，发送失败 整型。当前缓冲区中的空闲空间。范围：0~10240；单位：字节。 2.3.13. AT+QISENDHEX 发送十六进制字符串数据扩展命令 该命令用于发送十六进制字符串数据，仅在为'TCP'、'UDP'、'TCP INCOMING'、'UDP INCOMING'类型时适用，不适用于'UDP SERVICE'和'TCP LISTENER'两种 Socket 服务类型。 若 特 定 Socket 服 务 的 数 据 访 问 模 式 是 缓 存 模 式 （ =0 ） 或 者 直 吐 模 式 （=1），可以通过 AT+QISENDHEX 发送数据。若成功发送数据到模块，则返回 SEND OK， 否则返回 SEND FAIL 或 ERROR。SEND FAIL 表示发送缓存已满，可以尝试重新发送数据；ERROR 表 示在发送数据过程中遇到错误，请延迟一段时间后再次发送数据，发送数据的最大长度为 1460 字节；SEND OK 并 不 表 示 数 据 已 经 成 功 发 送 到 服 务 器 ， 如 需 查 询 数 据 是 否 已 经 发 送 到 服 务 器 ， 可 以 通 过 AT+QISENDHEX=,0 查询数据是否已经发送到服务器。 AT+QISENDHEX 发送十六进制字符串数据扩展命令 测试命令 AT+QISENDHEX=? 响应 +QISENDHEX: ( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围),) 设置命令 发送不定长数据： AT+QISENDHEX= OK 响应 > 响应>后，输入需要发送的数据；按'Ctrl'+'Z'发送数据， 按'Esc'取消发送。 1. 若=0： 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 2. 若=1： 若连接已经建立： +QISEND: ,, 上海移远通信技术股份有限公司 36 / 59 LTE Standard(U)系列 TCP/IP 应用指导 OK 设置命令 发送定长数据： AT+QISENDHEX=, 若连接未建立、异常断开或者参数不正确： ERROR 响应 > 响应>后，输入长度等于 × 2 的数据。 1. 若=0： 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 2. 若=1： 若连接已经建立： +QISEND: ,, OK 设置命令 分段发送定长数据内容： AT+QISENDHEX=,[,][,] 若连接未建立、异常断开或者参数不正确： ERROR 响应 若连接已经建立，但累计发送的实际数据量（即 ） 未 达 到 发 送 数 据 的 总 长 度 （ 即 ）： +QISENDHEX: ,, OK 若连接已经建立，且成功发送： +QISENDHEX:,, OK 若连接建立，但发送缓存已满，或连接未建立，异常断开或参 数不正确： 上海移远通信技术股份有限公司 37 / 59 最大响应时间 特性说明 ERROR / / LTE Standard(U)系列 TCP/IP 应用指导 参数 整型。Socket ID 号。范围：0~11。 整型。禁用/启用 AT+QISENDHEX 返回信息 URC。 0 禁用 1 启用 整型。发送状态。 0 发送数据到 Socket 缓冲区成功 1 接收缓冲区满，发送失败 整型。发送数据的总长度。范围：0~10240，0 用于查询数据是否已经发送到服 务器；单位：字节。 整型。当前发送的长度。范围：2~1460，且必须为偶数。单位： 字符（两位字符等于的一个字节长度）。 整型。当前累计发送至缓存的实际数据长度。值为累计的 / 2。 单位：字节。 字符串类型。必须为 0-F 格式的十六进制字符串数据。 整型。当前缓冲区中的空闲空间。范围：0~10240；单位：字节。 备注 若当前返回的等于，则下次执行时从 0 开始计数，内部处理机制会等待输入的数据达到长度后再送入内部缓存。注意 TCP 分段 大小为建立连接时双方协商的 MSS 值，通常此值为 1460。如果超过协商大小，TCP 协 议栈依然会将数据分段发送。 2.3.14. AT+QISWTMD 切换数据访问模式 该命令用于切换数据访问模式：缓存模式、直吐模式和透传模式。建立 Socket 服务时，可以通过 AT+QIOPEN 的来指定数据访问模式，Socket 服务打开以后，可以通过 AT+QISWTMD 来切换模式。 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应 +QISWTMD: (支持的范围),(支持的范围) 上海移远通信技术股份有限公司 38 / 59 LTE Standard(U)系列 TCP/IP 应用指导 OK 设置命令 AT+QISWTMD=, 响应 若=0 或 1 且数据访问模式切换成功： OK 若=2，且数据访问模式切换成功，模块会进 入透传模式： CONNECT 最大响应时间 特性说明 若出现任何错误： ERROR / 该命令立即生效； 参数配置不保存。 参数 整型。Socket ID。范围：0~11。 整型。连接数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 2.3.15. AT+QPING 进行远程服务器 Ping 操作 该命令用于检测 Host 网络协议可达性。在使用 Ping 工具前，Host 应首先通过 AT+QIACT 激活 对应的场景，在期间内返回结果，默认值是 4 秒。 AT+QPING 进行远程服务器 Ping 操作 测试命令 AT+QPING=? 响应 +QPING: (支持的范围),,(支持的范围),(支持的范围) OK 设置命令 AT+QPING=,[,[,]] 响应 若远程服务器 Ping 操作成功： OK +QPING: ,,,, … 上海移远通信技术股份有限公司 39 / 59 最大响应时间 特性说明 LTE Standard(U)系列 TCP/IP 应用指导 +QPING: ,,,,,, 若出现任何错误： ERROR / / 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 字符串类型。Host 地址，格式为域名或点分十进制 IP 地址。 整型。设置每个 Ping 请求回应等待的最大时间。范围：1-255；默认值：4；单位：秒。 整型。设置 Ping 请求最大次数。范围：1~10；默认值：4。 整型。每个 Ping 请求结果。 0 从服务器接收到 Ping 响应，其后紧跟,,,, 其他值 错误码，请参考第 4 章 字符串类型。远程服务器 IP 地址。格式为点分十进制 IP。 整型。发送 Ping 请求字节长度。单位：字节。 整型。发送 Ping 请求后等待响应时间。范围：1~255；单位：毫秒。 整型。Ping 请求回应数据包 TTL 值。范围：1~255。 整型。该命令执行后最终结果。 0 正常结束，成功激活场景并找到 Host，此情况下其后紧跟,,,,,, 其他值 错误码，请参考第 4 章 整型。Ping 请求发送次数。 整型。得到响应的 Ping 请求个数。 整型。超时的 Ping 请求个数。 整型。最小响应时间。单位：毫秒。 整型。最大响应时间。单位：毫秒。 整型。平均响应时间。单位：毫秒。 2.3.16. AT+QNTP 使用 NTP 服务器同步本地时间 该命令用于通过 NTP 服务器同步本地时间到 UTC 时间，在同步之前，Host 需通过 AT+QIACT 来激活 对应的场景。受网络状态影响，等待返回结果最多需要 125 秒。 AT+QNTP 使用 NTP 服务器同步本地时间 测试命令 AT+QNTP=? 响应 +QNTP: ( 支 持 的 范 围 ),,( 支 持 的 范 围),(支持的列表),(支持的范围),(支持的 上海移远通信技术股份有限公司 40 / 59 LTE Standard(U)系列 TCP/IP 应用指导 范围) 查询命令 AT+QNTP? OK 响应 若在同步时间过程中： +QNTP: , 设置命令 AT+QNTP=, [,[,[,[,]]]] OK 响应 若 NTP 服务器同步本地时间成功： OK +QNTP: , 最大响应时间 特性说明 若出现任何错误： ERROR 受网络状态影响且与，有关，最大 响应时间 700 秒。 该命令立即生效； 参数配置不保存。 参数 整型。PDP上下文ID。范围：1~7。若当前使用模块为EC200D系列，范围：1~11。 字符串类型。NTP服务器地址。 整型。NTP服务器端口。范围：1~65535；默认值：123。 整型。是否自动设置同步时间到本地时间。 0 不设置 1 设置 整型。请求超时重试次数。范围：1~10；默认值：3。 整型。请求超时时间。范围：5~60；默认值：15；单位：秒。 错误码。请参考第 4章。 字符串类型。从NTP服务器上同步的时间。 格式为YYYY/MM/DD,hh:mm:sszz。zz的范围：-48~+56。 2.3.17. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置 DNS 服务器地址。在配置 DNS 地址之前，Host 需通过 AT+QIACT 来激活 对应的场景。 AT+QIDNSCFG 配置 DNS 服务器地址 测试命令 AT+QIDNSCFG=? 响应 +QIDNSCFG: (支持的范围),, 设置命令 AT+QIDNSCFG=[,[,]] OK 响应 若省略可选参数，则查询指定 PDP 上下文的当前 DNS 服务器地址： +QIDNSCFG: ,, OK 若指定任意可选参数，则设置指定 PDP 上下文的主要 DNS 服务器 地址和次要 DNS 服务器地址： OK 最大响应时间 特性说明 若出现任何错误： ERROR / 该命令立即生效； 参数配置不保存。 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 字符串类型。主要 DNS 服务器地址。 字符串类型。次要 DNS 服务器地址。 2.3.18. AT+QIDNSGIP 用域名获取 IP 地址 查询 DNS 之前，Host 需通过 AT+QIACT 来激活对应的场景。受网络状态影响，等待返 回响应结果最多需要 60 秒。 .AT+QIDNSGIP 测试命令 AT+QIDNSGIP=? 用域名获取 IP 地址 响应 +QIDNSGIP: (支持的范围), 设置命令 AT+QIDNSGIP=, OK 响应 OK 若出现任何错误： ERROR 以 URC 格式返回结果 上海移远通信技术股份有限公司 42 / 59 最大响应时间 特性说明 LTE Standard(U)系列 TCP/IP 应用指导 +QIURC: 'dnsgip',,, [... +QIURC: 'dnsgip',] 受网络状态影响，最大响应时间 60 秒。 / 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 字符串类型。域名。 错误码。请参考第 4 章。 整型。对应的 IP 地址数量。 整型。DNS 的 TTL 值。范围：1~255。 字符串类型。IP 地址。 2.3.19. AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 该命令用于控制是否回显 AT+QISEND 要发送的数据，即是否回显输入的待发送数据。 AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 测试命令 AT+QISDE=? 响应 +QISDE: (支持的列表) 查询命令 AT+QISDE? OK 响应 +QISDE: 设置命令 AT+QISDE= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR / 该命令立即生效； 参数配置不保存。 参数 整型。是否回显 AT+QISEND 要发送的数据。 上海移远通信技术股份有限公司 43 / 59 0 不回显 1 回显 LTE Standard(U)系列 TCP/IP 应用指导 2.3.20. AT+QIGETERROR 查询上一个 AT 命令错误代码 若 执 行 TCP/IP 命 令 后 返 回 ERROR ， 错 误 详 情 可 通 过 AT+QIGETERROR 查 询 。 需 注 意 AT+QIGETERROR 只返回上一个 TCP/IP AT 命令错误代码。 AT+QIGETERROR 查询上一个 AT 命令错误代码 测试命令 AT+QIGETERROR=? 执行命令 AT+QIGETERROR 响应 OK 响应 +QIGETERROR: , OK 最大响应时间 / 特性说明 / 参数 错误码。请参考第 4 章。 字符串类型。指示详细错误信息。请参考第 4 章。 2.4. URC 说明 TCP/IP AT 命令的 URC 统一以+QIURC:形式上报 Host，涉及数据接收、连接断开和接入等。在 URC 的前后均有，本文里均不显示。 2.4.1. +QIURC: 'closed' 连接断开通知 当 TCP Socket 服务连接被远程客户端断开或者因为网络异常导致断开，模块将上报该 URC，同时该 Socket 将处于'Closing'状态（=4），调用 AT+QICLOSE=后 Socket 服务可 恢复成'Initial'状态。 +QIURC: 'closed' 连接断开通知 +QIURC: 'closed', Socket 服务连接被断开 上海移远通信技术股份有限公司 44 / 59 参数 整型。Socket ID。范围：0~11。 LTE Standard(U)系列 TCP/IP 应用指导 2.4.2. +QIURC: 'recv' 数据接收通知 在缓存模式或者直吐模式下，模块接收到数据后会上报 URC 通知 Host。 ⚫ 缓存模式下：URC 格式为+QIURC: 'recv',；URC 上报后，Host 可通过 AT+QIRD 读取数据。请注意，如果缓存不为空且模块再次接收数据的情况下，只有当 Host 通过 AT+QIRD 读取所有接收的数据后，模块才会上报新的 URC。 ⚫ 直吐模式下：接收的数据会直接从 COM 端输出。 +QIURC: 'recv' 数据接收通知 +QIURC: 'recv', 在缓存模式下，模块接收到数据会上报该 URC，Host 可通过 AT+QIRD 获取数据。 +QIURC: 'recv',, 在直吐模式下，当为'TCP'、'UDP'、'UDP INCOMING'或'TCP INCOMING'时，模块接收到数据会上报该 URC。 +QIURC: 'recv',,<curre 在直吐模式下，当='UDP SERVICE'时，模块 ntrecvlength>,, 参数 整型。Socket ID。范围：0~11。 整型。实际接收数据的长度。范围：1~1500；单位：字节。 字符串类型。远程 IP 地址。 整型。远程端口。范围：1~65535。 字符串类型。接收的数据。 2.4.3. +QIURC: 'incoming full' 客户端连接已满通知 如果客户端连接已达限额，或者已经没有 Socket 系统资源可供分配，有新的客户端连接请求时模块会 上报 URC：+QIURC: 'incoming full'。 +QIURC: 'incoming full' 客户端连接已满通知 +QIURC: 'incoming full' 客户端连接请求已满 上海移远通信技术股份有限公司 45 / 59 LTE Standard(U)系列 TCP/IP 应用指导 2.4.4. +QIURC: 'incoming' 客户端连接通知 如果为'TCP LISTENER'，当一个远程客户端连接到这个服务器时，Host 会给新连接 自动分配一个空闲的，的范围是 0~11。此时模块会上报该 URC。新连接的 是'TCP INCOMING'，是缓存模式。 +QIURC: 'incoming' 客户端连接通知 +QIURC: 'incoming',,,, 接受了一个新的连接请求时，分配给新连接的以及新连接的和将通过 该 URC 上报。 参数 整型。模块自动为客户端连接指定分配的 Socket 服务。范围：0~11。 整 型 。 接 受 客 户 端 连 接 的 服 务 器 。 服 务 器 的 是 'TCP LISTENER'，监听 Socket ID 是。 字符串类型。客户端连接的远程 IP 地址。 整型。客户端连接的远程端口。范围：1~65535。 2.4.5. +QIURC: 'pdpdeact' PDP 去激活通知 PDP 可以被网络去激活。PDP 被去激活以后，模块会上报该 URC 通知 Host，Host 需执行 AT+QIDEACT 去激活场景并重置所有连接。 +QIURC: 'pdpdeact' PDP 去激活通知 +QIURC: 'pdpdeact', 表示场景被去激活 参数 整型。PDP 上下文 ID。范围：1~7。若当前使用模块为 EC200D 系列，范围：1~11。 上海移远通信技术股份有限公司 46 / 59 LTE Standard(U)系列 TCP/IP 应用指导 3 示例 3.1. 场景配置和激活 3.1.1. 场景配置 AT+QICSGP=1,1,'UNINET','','',1 OK //配置场景 1，APN 配置为'UNINET'（中国联通）。 3.1.2. 场景激活 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK //激活场景 1，受网络状态影响，最大响应时间为 150 秒。 //场景激活成功。 //查询场景状态。 3.1.3. 场景去激活 AT+QIDEACT=1 OK //去激活场景 1。 //场景去激活成功，受网络状态影响，最大响应时间为 40 秒。 3.1.4. 设置异步/同步激活或去激活操作 AT+QICFG='pdp/retry',0,0 +QICFG: 'pdp/retry',0,0,4,6 //查询 4G 模式下去激活次数和单次执行的最大时间。 OK AT+QICFG='pdp/retry',0,1 +QICFG: 'pdp/retry',0,1,4,5 //查询 2G 模式下去激活次数和单次执行的最大时间。 OK 上海移远通信技术股份有限公司 47 / 59 AT+QICFG='pdp/retry',1,0 +QICFG: 'pdp/retry',1,0,4,8 OK AT+QICFG='pdp/retry',1,1 +QICFG: 'pdp/retry',1,1,4,10 OK AT+QICFG='pdp/retry',0,0,2,6 OK AT+QICFG='pdp/retry',0,1,2,6 OK AT+QICFG='pdp/retry',1,0,4,6 OK AT+QICFG='pdp/retry',1,1,4,6 OK AT+QICSGP=1,1,'CMNET' OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.171.134.243' OK AT+QIDEACT=1 OK AT+QIACTEX=1 OK +QIACTEX: 1,0 AT+QIACTEX? +QIACTEX: 1,1,1,'10.183.232.187' OK AT+QIDEACTEX=1 OK +QIDEACTEX: 1,0 AT+QIACTEX=1,1 OK +QIACTEX: 1,0,1,'10.176.245.213' AT+QIDEACTEX=1 OK LTE Standard(U)系列 TCP/IP 应用指导 //查询 4G 模式下激活次数和单次执行的最大时间。 //查询 2G 模式下激活次数和单次执行的最大时间。 //配置 4G 去激活重试次数 2，单次时间 6 秒，总时间 18 秒。 //配置 2G 去激活重试次数 2，单次时间 6 秒，总时间 18 秒。 //配置 4G 去激活重试次数 4，单次时间 6 秒，总时间 30 秒。 //配置 2G 去激活重试次数 4，单次时间 6 秒，总时间 30 秒。 //配置场景 1 IP 类型为 IPv4，APN 为 CMNET。 //执行同步场景激活命令。 //查询场景激活状态。 //执行同步去激活场景命令。 //执行异步场景激活命令。 //查询场景激活状态。 //执行异步去激活场景命令。 //执行异步场景激活命令，并配置显示 IP 模式。 //执行异步去激活场景命令。 上海移远通信技术股份有限公司 48 / 59 LTE Standard(U)系列 TCP/IP 应用指导 +QIDEACTEX: 1,0 AT+QICSGP=1,3,'CMNET' //配置场景 1 IP 类型为 IPv4v6，APN 为 CMNET。 OK AT+QIACT=1 //执行同步场景激活命令。 OK AT+QIACT? //查询场景激活状态。 +QIACT: 1,1,1,'10.171.134.243','240E:459:40D:A39::1' OK 3.2. TCP 客户端在缓存模式下工作 3.2.1. 创建 TCP 客户端连接并进入缓存模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,0 OK // 场 景 是 1 ， 为 0 。 在 执 行 AT+QIOPEN 之前，Host 需要使用 AT+QIACT 激活场景。 +QIOPEN: 0,0 //TCP 客户端连接成功，等待 URC：+QIOPE N: ,响应建议等待 150 秒。 若 150 秒内未收到 URC 响应，Host 可以使用 AT+QISTATE=1,0 AT+QICLOSE 断开 Socket。 //检查连接状态是否为 0。 +QISTATE: 0,'TCP','220.180.239.212',8009,65514,2,1,0,0,'usbmodem' OK 3.2.2. Buffer 模式下发送数据 AT+QISEND=0 > test1 SEND OK AT+QISEND=0,4 > test SEND OK AT+QISEND=0,0 +QISEND: 9,9,0 //发送可变长度数据。 //输入数据后，按'Ctrl'+'Z'发送数据 //SEND OK 不能代表数据已经成功发送到服务器。Host 可以通 过 AT+QISEND=0,0 来查询数据是否到达服务器。 //发送固定长度数据，字节长度为 4 字节。 //查询发送数据长度。 上海移远通信技术股份有限公司 49 / 59 LTE Standard(U)系列 TCP/IP 应用指导 OK AT+QISENDEX=0,'3132333435' SEND OK AT+QISEND=0,0 +QISEND: 14,14,0 OK //发送十六进制字符串数据。 //查询发送数据长度，已确认数据长度和未确认数据长度。 3.2.3. Buffer 模式下从远程服务器接收数据 +QIURC: 'recv',0 AT+QIRD=0,1500 +QIRD: 14 test1 //为 0 时接收的数据。 //读取数据，字节长度为 1500 字节。 //实际接收数据长度为 14 字节。 OK AT+QIRD=0,1500 +QIRD: 0 //缓存里无数据。 OK AT+QIRD=0,0 +QIRD: 14,14,0 //查询接收数据总长度，包含已读和未读数据。 OK 3.2.4. 断开连接 AT+QICLOSE=0 OK //断开为 0 的连接。受网络状态影响，最大响应时间是 10 秒。 3.3. TCP 客户端在透传模式下工作 3.3.1. 创建 TCP 客户端连接并进入透传模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,2 //场景为 1，为 0。执行 AT+QIOPEN 之前，Host 需使用 AT+QIACT 来激活场景。 CONNECT //连接成功，等待 URC 响应结果 CONNECT 建议 等待 150 秒。若 150 秒内 URC 无响应，Host 可 通过 AT+QICLOSE 断开 Socket 连接。 上海移远通信技术股份有限公司 50 / 59 LTE Standard(U)系列 TCP/IP 应用指导 3.3.2. 透传模式下发送数据 3.3.3. 透传模式接收远程器端数据 Test 1 3.3.4. 断开 TCP 客户端连接 AT+QICLOSE=0 OK //所有从网络接收的数据都会通过 COM 端口直接输 出。 // 使 用 +++ 退 出 透 传 模 式 后 ， Host 可 以 通 过 AT+QICLOSE 断开 TCP 连接。受网络状态影响，最 大响应时间是 10 秒。 3.4. TCP 客户端在直吐模式下工作 3.4.1. 创建 TCP 客户端连接并进入直吐模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,1 //场景为 1，为 0。执行 AT+QIOPEN 之前，Host 需使用 AT+QIACT 来激活场景。 OK +QIOPEN: 0,0 //连接成功，等待 URC： +QIOPEN: ,响应建议等待 150 秒，若 150 秒内未 响应，Host 可通过 AT+QICLOSE 断开 Socket。 AT+QISTATE=1,0 //查询的连接状态是否为 0。 +QISTATE: 0,'TCP','220.180.239.212',8009,65344,2,1,0,1,'usbmodem' OK 3.4.2. 直吐模式下发送数据 AT+QISEND=0 > test1 //发送长度可变数据。 //输入数据后，按'Ctrl'+'Z'发送数据 上海移远通信技术股份有限公司 51 / 59 SEND OK AT+QISEND=0,5 > test2 SEND OK AT+QISEND=0,0 +QISEND: 10,10,0 OK LTE Standard(U)系列 TCP/IP 应用指导 //SEND OK 不能代表数据已经成功发送到服务器，Host 可 通过 AT+QISEND=0,0 查询数据是否达到服务器。 //发送固定长度数据，长度为 5 字节。 //长度达到 5 字节后自动发送 //查询发送数据长度，已确认数据长度和未确认数据长度。 3.4.3. 直吐模式下接收远程服务器端数据 +QIURC: 'recv',0,4 test //接收远程服务器端数据。 3.4.4. 断开 TCP 用户端连接 AT+QICLOSE=0 OK //断开为 0 的连接。受网络状态影响，最大 响应时间为 10 秒。 3.5. TCP 服务器在缓存模式下工作 3.5.1. 启动 TCP 服务器 AT+QIOPEN=1,1,'TCP LISTENER','127.0.0.1',0,2020,0 OK // 场 景 为 1 ， 为 1 。 执 行 AT+QIOPEN 之 前 ， Host 需 通 过 AT+QIACT 来激活场景。 +QIOPEN: 1,0 //TCP 服务器启动成功。 AT+QISTATE=0,1 //查询连接状态是否为 1。 +QISTATE: 1,'TCP LISTENER','10.7.157.1',0,2020,3,1,1,0,'usbmodem' OK 上海移远通信技术股份有限公司 52 / 59 LTE Standard(U)系列 TCP/IP 应用指导 3.5.2. 接受客户端的连接请求 +QIURC: 'incoming',11,1,'172.31.242.222',54091 //接受一个 TCP 连接，为 'TCP incoming'，为 11。 3.5.3. 接收的客户端数据 +QIURC: 'recv',11 AT+QIRD=11,1500 +QIRD: 4 test OK AT+QIRD=11,1500 +QIRD: 0 OK AT+QIRD=11,0 +QIRD: 4,4,0 OK //从远程客户端连接接收的数据。 //读取客户端连接接收的数据。 //实际数据长度为 4 字节。 //缓存无数据。 //查询接收数据总长度，包含已读和未读数据。 3.5.4. 断开 TCP 服务器连接 AT+QICLOSE=11 OK AT+QICLOSE=1 OK //断开客户端连接，受网络状态影响最大响应时间 10 秒。 //关闭 TCP 服务器监听。 3.6. UDP 服务示例 3.6.1. 打开 UDP 服务 AT+QIOPEN=1,2,'UDP SERVICE','127.0.0.1',0,3030,0 // 打 开 UDP 服 务 ， 为 2 ， 为 1，执行 AT+QIOPEN 之前， Host 需通过 AT+QIACT 来激活场景。 OK 上海移远通信技术股份有限公司 53 / 59 LTE Standard(U)系列 TCP/IP 应用指导 +QIOPEN: 2,0 //成功打开 UDP 服务。 AT+QISTATE=0,1 //查询的连接状态是否为 1。 +QISTATE: 2,'UDP SERVICE','10.7.157.1',0,3030,2,1,2,0,'usbmodem' OK 3.6.2. 向服务器发送 UDP 数据 AT+QISEND=2,10,'10.7.89.10',6969 >1234567890 SEND OK //向远程端发送字节长度为 10 字节的数据，远程 端 IP 地址是 10.7.89.10，端口是 6969。 3.6.3. 接收远程端数据 +QIURC: 'recv',2 AT+QIRD=2 +QIRD: 4,'10.7.76.34',7687 AAAA OK AT+QIRD=2 +QIRD: 0 OK AT+QISEND=2,10,'10.7.76.34',7687 >1234567890 SEND OK //接收远程端数据。 //读取 UDP 数据。可输出一整个 UDP 数据包，无 需指定读取长度。 //数据长度为 4，远程 IP 地址 10.7.76.34，远程端 口是 7687。 //读取数据。 //缓存无数据。 //向远程端发送数据，远程端 IP 地址为 10.7.76.34， 远程端口是 7687。 3.6.4. 关闭 UDP 服务 AT+QICLOSE=2 OK //关闭服务。 上海移远通信技术股份有限公司 54 / 59 3.7. PING AT+QPING=1,'www.baidu.com' OK +QPING: 0,'61.135.169.125',32,192,255 +QPING: 0,'61.135.169.125',32,240,255 +QPING: 0,'61.135.169.125',32,241,255 +QPING: 0,'61.135.169.125',32,479,255 +QPING: 0,4,4,0,192,479,287 LTE Standard(U)系列 TCP/IP 应用指导 //在场景 1 中 Ping www.baidu.com，在 Ping 目标 IP 地址前，Host 需通过 AT+QIACT 来激活场景。 3.8. 同步本地时间 AT+QNTP=1,'202.112.10.36',123 OK +QNTP: 0,'2019/09/09,01:32:42+32' AT+CCLK? +CCLK: '19/09/09,01:32:52+32' OK //使用 NTP 服务器'202.112.10.36:123'同步时间，同步 时间之前，Host 需要通过 AT+QIACT 来激活场景。 3.9. 获取上一个错误代码示例 AT+QIOPEN=1,'TCP','220.180.239.212',8009,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552,invalid parameters //开启Socket服务，省略了。 OK 上海移远通信技术股份有限公司 55 / 59 LTE Standard(U)系列 TCP/IP 应用指导 4 错误代码 当 TCP/IP 的 AT 命令返回 ERROR 时，具体的错误类型可以通过 AT+QIGETERROR 来查询。需注意 AT+QIGETERROR 查询的是上一个 TCP/IP AT 命令的错误代码。 表 3：错误代码列表 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 英文含义 Operation success Unknown error Operation blocked Invalid parameters Memory not enough Socket creation failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed PDP context opening failed PDP context closure failed Socket identity has been used DNS busy DNS parse failed 中文含义 操作成功 未知错误 操作受阻 无效参数 内存不足 创建Socket失败 操作不支持 Socket绑定失败 Socket监听失败 Socket写入失败 Socket读取失败 Socket接受失败 打开PDP上下文失败 关闭PDP上下文失败 Socket标识被占用 DNS忙碌 DNS解析失败 上海移远通信技术股份有限公司 56 / 59 566 Socket connect failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel sending 572 Operation not allowed 573 APN not configured 574 Port busy LTE Standard(U)系列 TCP/IP 应用指导 Socket连接失败 Socket被关闭 操作忙碌 操作超时 PDP上下文出现故障 取消发送 操作不允许 APN未配置 端口忙碌 上海移远通信技术股份有限公司 57 / 59 LTE Standard(U)系列 TCP/IP 应用指导 5 附录 参考文档及术语缩写 表 4：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_AT 命令手册 表 5：术语缩写 缩写 3GPP ACK APN ASCII CHAP CS DNS FIN ID IP MSS NTP PAP PCB PDP 英文全称 中文全称 The 3rd Generation Partnership Project 第三代合作伙伴计划 Acknowledgement 确认字符 Access Point Name 接入点名称 American Standard Code for Information Interchange 美国信息交换标准代码 Challenge Handshake Authentication Protocol 挑战握手认证协议 Circuit Switching 电路交换 Domain Name Server 域名系统协议 Finish 完成 Identifier 标识符 Internet Protocol 互联网协议 Maximum Segment Size 最大报文段长度 Network Time Protocol 网络时间协议 Password Authentication Protocol 密码认证协议 Printed Circuit Board 印刷电路板 Packet Data Protocol 分组数据协议 上海移远通信技术股份有限公司 58 / 59 LTE Standard(U)系列 TCP/IP 应用指导 PPP PS QoS TCP TTL UART UDP URC USB (U)SIM UTC VoLTE Point-to-Point Protocol Packet Switch Quality of Service Transmission Control Protocol Time to Live. Universal Asynchronous Receiver&Transmitter User Datagram Protocol Unsolicited Result Code Universal Serial Bus (Universal) Subscriber Identity Module Coordinated Universal Time Voice (voice calls) over LTE 点对点协议 分组交换 服务质量 传输控制协议 生存时间 通用异步收发器 用户数据包协议 非请求结果码 通用串行总线 （全球）用户身份识别模块 协调世界时 长期演进语音承载 上海移远通信技术股份有限公司 59 / 59

ECx00U&EGx00U&EG915U 系列音频应用指导 LTE Standard 模块系列 版本：1.2 日期：2022-03-10 状态：受控文件 ECx00U&EGx00U&EG915U 系列音频应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 日期 2021-04-08 2021-05-08 2021-09-01 2022-03-10 作者 变更表述 Kevin WANG 文档创建 Kevin WANG Kevin WANG Evan MENG 受控版本 1. 增加适用模块：EG915U 系列。 2. 更新音频通道相关描述（第 1.2 章）。 3. 更新设置音频模式相关参数描述（第 2.3.6 章）。 4. 增加 AT+QWTTS（第 2.3.9 章）。 5. 增加 AT+QICMIC（第 2.3.13 章）。 6. 增加 AT+QICSIDET（第 2.3.14 章）。 7. 更新错误码描述（第 3 章）。 1. 更新适用模块支持的音频通道（表 2）。 2. 更新 AT+QAUDRD 中的描述（第 2.3.3 章）。 3. 增加 AT+QAUDSTOP（第 2.3.6 章）。 4. 更新 AT+QIIC 中的描述（第 2.3.8 章）。 5. 增加 AT+QLDTMF（第 2.3.16 章）。 6. 增加 AT+QWDTMF（第 2.3.17 章）。 7. 增加 AT+QLTONE（第 2.3.18 章）。 8. 增加 AT+QLTONEX（第 2.3.19 章）。 9. 增加 AT+QTONEDET（第 2.3.20 章）。 上海移远通信技术股份有限公司 3 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块..................................................................................................................................... 6 1.2. 音频通道..................................................................................................................................... 7 2 音频 AT 命令详解................................................................................................................................... 8 2.1. AT 命令说明 ............................................................................................................................... 8 2.1.1. 定义 .................................................................................................................................. 8 2.1.2. AT 命令语句 ..................................................................................................................... 8 2.2. AT 示例声明 ............................................................................................................................... 9 2.3. AT 命令详解 ............................................................................................................................... 9 2.3.1. AT+CLVL 扬声器音量等级选择...................................................................................... 9 2.3.2. AT+QAUDLOOP 控制音频循环测试 ........................................................................... 10 2.3.3. AT+QAUDRD 录制音频文件 ....................................................................................... 10 2.3.4. AT+QPSND 播放音频文件至远端或近端 .................................................................... 12 2.3.5. AT+QAUDPLAY 播放本地音频文件至近端 ................................................................. 14 2.3.6. AT+QAUDSTOP 停止播放媒体文件 ............................................................................. 15 2.3.7. AT+QAUDMOD 设置音频模式 .................................................................................... 15 2.3.8. AT+QIIC 读写 IIC......................................................................................................... 16 2.3.9. AT+QTTS 播放文本..................................................................................................... 18 2.3.10. AT+QWTTS 向远端播放或发送文本 ........................................................................... 19 2.3.11. AT+QTTSETUP 配置 TTS 参数 .................................................................................. 21 2.3.12. AT+QAUDPASW 切换音频 PA 类型............................................................................ 22 2.3.13. AT+QAUDSW 切换 Codec .......................................................................................... 23 2.3.14. AT+QICMIC 设置麦克风的上行增益 ........................................................................... 24 2.3.15. AT+QICSIDET 设置当前模式的侧音增益.................................................................... 24 2.3.16. AT+QLDTMF 播放/停止播放本地 DTMF..................................................................... 25 2.3.17. AT+QWDTMF 向远端播放/发送 DTMF 音................................................................... 26 2.3.18. AT+QLTONE 播放本地定制音调 ................................................................................. 28 2.3.19. AT+QLTONEX 播放本地定制音调............................................................................... 29 2.3.20. AT+QTONEDET 启用/禁用 DTMF 检测 ...................................................................... 30 3 错误码 .................................................................................................................................................. 32 4 附录 术语缩写...................................................................................................................................... 33 上海移远通信技术股份有限公司 4 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：模块支持的音频通道........................................................................................................................... 7 表 3：AT 命令类型........................................................................................................................................ 8 表 4：URC +QAUDRIND: 0,中的描述 ............................................................................... 12 表 5：+CME ERROR: ...................................................................................................................... 32 表 6：术语缩写 ........................................................................................................................................... 33 上海移远通信技术股份有限公司 5 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 1 引言 本文档主要介绍移远通信 LTE Standard ECx00U 系列、EGx00U 和 EG915U 系列模块音频功能的相 关 AT 命令。 1.1. 适用模块 表 1：适用模块 模块系列 模块 ECx00U EC200U 系列 EC600U 系列 EGx00U EG500U-CN EG700U-CN EG915U EG915U 系列 型号 EC200U-CN EC200U-EU EC600U-CN EC600U-EU EG500U-CN EG700U-CN EG915U-CN EG915U-EU EG915U-LA 备注 仅 EC200U-CN、EC600U-CN、EG500U-CN、EG700U-CN 和 EG915U-CN 模块支持 TTS 功能。 上海移远通信技术股份有限公司 6 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 1.2. 音频通道 音频通道可使用 AT+QAUDMOD 命令来切换，详情请参考第 2.3.7 章。 表 2：模块支持的音频通道 模块 EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG915U 系列 支持的音频通道 扬声器、麦克风 扬声器、麦克风、耳机、听筒 扬声器、耳机、麦克风 扬声器 麦克风、听筒 上海移远通信技术股份有限公司 7 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 2 音频 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 3：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+CLVL 扬声器音量等级选择 该命令用于选择 MT 内部扬声器的音量等级。 AT+CLVL 扬声器音量等级选择 测试命令 AT+CLVL=? 响应 +CLVL: (支持的范围) 查询命令 AT+CLVL? OK 响应 +CLVL: 设置命令 AT+CLVL= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与ME功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。出厂特定范围的音量级别（最小值代表最低的音量级别）。范围：0~5；默认值：3。 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 9 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 2.3.2. AT+QAUDLOOP 控制音频循环测试 该命令用于启用或者禁用音频循环测试。 AT+QAUDLOOP 控制音频循环测试 测试命令 AT+QAUDLOOP=? 响应 +QAUDLOOP: (支持的列表) 查询命令 AT+QAUDLOOP? OK 响应 +QAUDLOOP: 设置命令 AT+QAUDLOOP= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与ME功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用音频循环测试。 0 禁用 1 启用 错误码。详情请参考第 3 章。 2.3.3. AT+QAUDRD 录制音频文件 该命令用于录制语音通话期间的上行或下行音频，或在空闲状态下从本地麦克风录制音频并将其保存 到文件中。 AT+QAUDRD 录制音频文件 测试命令 AT+QAUDRD=? 响应 +QAUDRD: ( 支 持 的 列 表 ),,( 支 持 的 列表),(支持的列表) OK 上海移远通信技术股份有限公司 10 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 查询命令 AT+QAUDRD? 响应 +QAUDRD: 设置命令 AT+QAUDRD=[,[,[,]]] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。模块状态。 0 模块不在录制音频中 1 模块录制音频中 整型。停止或开始录制。 0 停止录制 1 开始录制 字符串类型。录制的音频文件的名称。包括文件路径、文件名和文件后缀。默认的存储 路径是 UFS:。 整型。文件格式。由文件后缀指定。 13 WAV_PCM16 整型。录制上行/下行音频。 0 录制上行音频。 1 录制下行音频。 错误码。详情请参考第 3 章。 备注 1. 若录制文件的名称和格式与现有文件的名称和格式相同，或发生未知错误，模块将上报 URC +QAUDRIND: 0,1。 2. 若当前录制被其他音频任务中断，模块将上报 URC +QAUDRIND: 0,6。 3. 若录制空间不足，模块将上报 URC +QAUDRIND: 0,3。 4. 模块支持录制上行和下行音频数据，但不支持同时录制。 5. 在非通话模式下禁止录制下行音频，在通话模式下禁止录制上行音频。 上海移远通信技术股份有限公司 11 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 表 4：URC +QAUDRIND: 0,中的描述 0 1 3 6 含义 已保存 未知错误 无录制空间 被其他音频任务中断 举例 AT+QAUDRD=1,'A.wav',13,0 OK AT+QAUDRD=0 OK AT+QAUDRD=1,'B.wav',13,1 OK AT+QAUDRD=0 OK //以 WAV 格式录制上行音频，并将其存储在 UFS:中。 //停止录制。 //通话过程中以 WAV 格式录制下行音频，并将其存储在 UFS:中。 //停止录制。 2.3.4. AT+QPSND 播放音频文件至远端或近端 该命令用于播放本地音频文件至远端或近端。 AT+QPSND 播放音频文件至远端或近端 测试命令 AT+QPSND=? 响应 +QPSND: ( 支 持 的 列 表 ),,( 支 持 的 列 表 ),( 支 持 的 列 表 ),( 支 持 的 列 表) 查询命令 AT+QPSND? OK 响应 +QPSND: 设置命令 AT+QPSND=,,[,[,]] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： 上海移远通信技术股份有限公司 12 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 最大响应时间 特性说明 +CME ERROR: 播放结束后： +QPSND: 0 300 毫秒 / 参数 整型。模块状态。 0 模块不在播放中 1 模块播放中 整型。停止或开始播放。 0 停止播放 1 开始播放 字符串类型。播放的本地音频文件的名称，包括文件路径、文件名和文件后缀。默认路 径为 UFS:。 整型。是否重复播放。 0 仅播放一次 1 重复播放 整型。上行音频是否静音。 0 静音 1 未静音 整型。下行音频是否静音。 0 静音 1 未静音 错误码。详情请参考第 3 章。 备注 1. 在播放上行音频时，模块仅支持 8 kHz 线性、单声道播放格式。 2. 在通话模式下禁止播放下行音频，在非通话模式下禁止播放上行音频。 3. 不支持同时将和设置为 0 或 1。 举例 AT+QPSND=1,'A.wav',0,0,1 OK +QPSND: 0 AT+QPSND=1,'A.wav',0,1,0 OK //播放存储在 UFS:中的.wav 文件一次。 //通话过程中向远端播放一次.wav 文件。 上海移远通信技术股份有限公司 13 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 +QPSND: 0 2.3.5. AT+QAUDPLAY 播放本地音频文件至近端 该命令用于播放本地音频文件至近端。 AT+QAUDPLAY 播放本地音频文件至近端 测试命令 AT+QAUDPLAY=? 响应 +QAUDPLAY: ,(支持的列表) 查询命令 AT+QAUDPLAY? OK 响应 +QAUDPLAY: 设置命令 AT+QAUDPLAY=, OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放结束后： +QAUDPLAY: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。模块状态。 0 模块不在播放音频中 1 模块播放音频中 字符串类型。播放的音频文件的名称，包括文件路径，文件名和文件后缀。文件路径必 须为 UFS:。 整型。是否重复播放。 0 仅播放一次 1 重复播放 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 14 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 备注 1. 若发生未知错误，模块将上报 URC +QAUDPIND: 0,1。 2. 若当前播放被其他音频任务中断，模块将上报 URC +QAUDPIND: 0,6。 2.3.6. AT+QAUDSTOP 停止播放媒体文件 该命令用于停止播放媒体文件。 AT+QAUDSTOP 停止播放媒体文件 测试命令 AT+QAUDSTOP=? 执行命令 AT+QAUDSTOP 响应 OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 错误码。详情请参考第 3 章。 2.3.7. AT+QAUDMOD 设置音频模式 该设置命令用于设置连接设备所需的音频模式。 AT+QAUDMOD 设置音频模式 测试命令 AT+QAUDMOD=? 响应 +QAUDMOD: (支持的范围) 查询命令 AT+QAUDMOD? OK 响应 +QAUDMOD: 设置命令 OK 响应 上海移远通信技术股份有限公司 15 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 AT+QAUDMOD= 最大响应时间 特性说明 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在下一次声音动作时生效； 参数配置不保存。 参数 整型。当前配置的音频模式。 0 话柄 1 耳机 2 扬声器 错误码。详情请参考第 3 章。 备注 不同模式下的回声消除、噪声抑制、数字增益和校准等参数不一样。 2.3.8. AT+QIIC 读写 IIC 该命令用于从外围设备读取或写入 IIC 寄存器。 AT+QIIC 读写 IIC 测试命令 AT+QIIC=? 响应 +QIIC: (支持的列表),(支持的列表),(支持的范围),(支持的列表),(支持的范围) 设置命令 AT+QIIC=,,,[,] OK 响应 若=0，则指定可选参数： OK 或者 ERROR 若=1，则省略可选参数： +QIIC: 上海移远通信技术股份有限公司 16 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 最大响应时间 特性说明 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。设置命令或查询命令。 0 设置命令 1 查询命令 十六进制整型。7 位从设备地址。范围：0~0xFF。当前仅支持 ALC5616 设备地址 0x1B 及 NAU88C10 设备地址 0x1A。 十六进制整型。寄存器地址。范围：0~0xFFFF。 整型。 1 读/写一个字节 2 读/写两个字节 十六进制整型。写入值。范围：0~0xFFFF。 错误码。详情请参考第 3 章。 举例 AT+QIIC=1,0x1B,0x27,1 +QIIC: 0x21 //读取寄存器位置的 1 字节寄存器内容：从机地址：0x1B；寄存器地址： 0x27。 OK AT+QIIC=0,0x1B,0x27,1,0x21 //写入寄存器位置的 1 字节寄存器内容：从机地址：0x1B；寄存器地址： 0x27；写入值：0x21。 OK 上海移远通信技术股份有限公司 17 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 2.3.9. AT+QTTS 播放文本 该命令用于播放文本。 AT+QTTS 播放文本 测试命令 AT+QTTS=? 查询命令 AT+QTTS? 设置命令 AT+QTTS=[,] 最大响应时间 特性说明 响应 +QTTS: (支持的范围), OK 响应 +QTTS: OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 文本播放完成时： +QTTS: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。开始或停止播放，指示格式。范围：0~2。 0 停止播放，可省略 1 开始播放，使用 UCS2 编码 2 开始播放，是字符型，通常是 ASCII 字符，中文使用 GBK 编码 字符串类型。待播放文本。文本格式取决于。最大长度：548 字节。 整型。TTS 播放器状态。 0 空闲 1 繁忙 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 18 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 备注 1. 模块支持在无通话状态下执行此命令播放文本。 2. 通话时文本播放会被中断。 3. 模块支持文本和音频播放，但不支持同时播放。 举例 AT+QTTS=? +QTTS: (0-2), //测试命令。 OK AT+QTTS=1,'6B228FCE4F7F752879FB8FDC6A215757'//播放 UCS2 字符串文本。 OK +QTTS: 0 AT+QTTS=2,'hello world,你好' OK //播放 ASCII 字符串文本。 +QTTS: 0 AT+QTTS=0 OK //停止播放。 2.3.10. AT+QWTTS 向远端播放或发送文本 该命令用于在通话时向远端播放或发送文本。 AT+QWTTS 向远端播放或发送文本 测试命令 AT+QWTTS=? 响应 +QWTTS: (支持的列表),(支持的列表),(支 持的范围), 查询命令 AT+QWTTS? OK 响应 +QWTTS: 设置命令 AT+QWTTS=,,[,] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： 上海移远通信技术股份有限公司 19 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 最大响应时间 特性说明 +CME ERROR: 文本播放完成时： +QWTTS: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。取消静音上行链路。 1 取消静音 整型。静音下行链路。 0 静音 整型。开始或停止播放并指定格式。 0 停止播放，可忽略 1 开始播放，使用 UCS2 编码 2 开始播放，是字符型，通常是 ASCII 字符，中文使用 GBK 编码 整型。待播放文本。文本格式取决于。最大长度：548 字节。 整型。TTS 播放器状态。 0 空闲 1 繁忙 错误码。详情请参考第 3 章。 备注 +QWTTS: 4111 表示 TTS 播放被来电中断。 举例 AT+QWTTS=? +QWTTS: (1),(0),(0-2), //测试命令。 OK AT+QWTTS=1,0,1,'6B228FCE4F7F752879FB8FDC6A215757' //通话时播放 UCS2 字符串并发送至远 端。 OK +QWTTS: 0 AT+QWTTS=1,0,2,'hello world,你好' OK //通话时播放 ASCII 字符串并发送至远端。 上海移远通信技术股份有限公司 20 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 +QWTTS: 0 AT+QWTTS=1,0,0 OK //文本播放完成。 //停止播放。 2.3.11. AT+QTTSETUP 配置 TTS 参数 该命令用于设置 TTS 速度或调节音量。 AT+QTTSETUP 配置 TTS 参数 测试命令 AT+QTTSETUP=? 响应 +QTTSETUP: (支持的列表),(支持的列表),(支持 的范围) 查询命令 AT+QTTSETUP? 设置命令 AT+QTTSETUP=,[,] OK 响应 OK 响应 若=1，则指定可选参数： OK 或者 ERROR 若=2，则省略可选参数： +QTTSETUP: 2,, OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。设置命令或查询命令。 1 设置命令 2 查询命令 整型。速度或音量。 1 速度 上海移远通信技术股份有限公司 21 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 2 音量 整型。速度或音量值。 如=2，设置命令中省略，表示查询当前速度或音量。 速度 范围：-32768~32767；默认值：0。 音量 范围：-32768~32767；默认值：0。 错误码。详情请参考第3章。 举例 AT+QTTSETUP=? +QTTSETUP: (1,2),(1,2),(-32768-32767) OK AT+QTTSETUP=1,2,0 OK //测试命令。 //设置音量为 0。 2.3.12. AT+QAUDPASW 切换音频 PA 类型 该命令用于切换音频 PA 类型。 AT+QAUDPASW 切换音频 PA 类型 测试命令 AT+QAUDPASW=? 响应 +QAUDPASW: (支持的列表) 查询命令 AT+QAUDPASW? OK 响应 +QAUDPASW: 设置命令 AT+QAUDPASW= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 22 / 33 参数 整型。PA 类型。 0 AB 类 1 D类 错误码。详情请参考第 3 章。 ECx00U&EGx00U&EG915U 系列音频应用指导 2.3.13. AT+QAUDSW 切换 Codec 该命令用于切换内置或外部 codec。 AT+QAUDSW 切换 Codec 测试命令 AT+QAUDSW=? 响应 +QAUDSW: (支持的列表) 查询命令 AT+QAUDSW? OK 响应 +QAUDSW: 设置命令 AT+QAUDSW= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。外部或内置 codec。 0 外部 codec 1 内置 codec 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 23 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 2.3.14. AT+QICMIC 设置麦克风的上行增益 该命令用于设置麦克风的上行增益。 AT+ QICMIC 设置麦克风的上行增益 测试命令 AT+QICMIC=? 响应 +QICMIC: (支持的范围),(支持的范围) 查询命令 AT+QICMIC? OK 响应 +QICMIC: , 设置命令 AT+QICMIC=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在下次通话时生效； 参数配置不保存。 参数 整型。上行模拟增益。范围：0~7。不同音频模式下默认值可能不同。 整型。上行数字增益。范围：0~15。不同音频模式下默认值可能不同。 错误码。详情请参考第 3 章。 2.3.15. AT+QICSIDET 设置当前模式的侧音增益 该命令用于设置当前模式的侧音增益。 AT+QICSIDET 设置当前模式的侧音增益 测试命令 AT+QICSIDET=? 响应 +QICSIDET: (支持的范围) 查询命令 AT+QICSIDET? OK 响应 +QICSIDET: 上海移远通信技术股份有限公司 24 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 设置命令 AT+QICSIDET= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在下次通话时生效； 参数配置不保存。 参数 整型。当前模式的侧音增益。范围：0~15。不同音频模式下默认值可能不同。 错误码。详情请参考第 3 章。 备注 此命令仅在使用 AT+QAUDLOOP（请参考第 2.3.2 章）禁用音频循环测试后才有效。 2.3.16. AT+QLDTMF 播放/停止播放本地 DTMF 该命令用于播放或停止播放本地 DTMF 字符串。 AT+QLDTMF 播放/停止播放本地 DTMF 测试命令 AT+QLDTMF=? 响应 +QLDTMF: (支持的范围),(支持的列表) 设置命令 AT+QLDTMF=,[,< y>] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 播放完成时： +QLDTMF: 5 上海移远通信技术股份有限公司 25 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 执行命令 AT+QLDTMF 最大响应时间 特性说明 响应 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。每个 DTMF 的播放时间和静音时间。范围：1~1000；单位：0.01 秒（=1 时）；0.1 秒（未设置时） 字符串类型。DTMF 字符串。逗号隔开。最大长度：39 字符（包含逗号）；DTMF 格 式：0~9、*、#、A~D；需加双引号（'...'）。 整型。控制参数的时间单位。若省略，的单位是 0.1 秒；若=1， 的单位是 0.01 秒。 错误码。详情请参考第 3 章。 举例 AT+QLDTMF=? +QLDTMF: (1-1000),(0-9,*,#,A-D) OK AT+QLDTMF=2,'A,B,1,2,#' OK AT+QLDTMF OK //测试命令。 //播放 A、B、1、2、#，播放时间和静音时间均为 200 毫秒。 //停止播放。 2.3.17. AT+QWDTMF 向远端播放/发送 DTMF 音 该命令用于向远端播放或发送 DTMF 音。 AT+QWDTMF 向远端播放/发送 DTMF 音 测试命令 AT+QWDTMF=? 响应 +QWDTMF: ( 支 持 的 列 表 ),( 支 持 的 列 表),(支持的列表),(支持的范围) 设置命令 AT+QWDTMF=,,< DTMF_string>, OK 响应 OK 或者 上海移远通信技术股份有限公司 26 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 ERROR 若错误与 ME 功能相关： +CME ERROR: 设置命令 AT+QWDTMF=,,< value> 播放完成时返回： +QWDTMF: 5 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 执行命令 AT+QWDTMF 最大响应时间 特性说明 播放完成时返回： +QWDTMF: 5 响应 OK 300 毫秒 / 参数 整型。取消静音上行链路。 1 取消静音上行链路 整型。静音下行链路。 0 静音下行链路 字符串类型。DTMF 音。逗号隔开。最大长度：39 字符（包含逗号）；DTMF 格式：0~9、*、#、A~D；需加双引号（'...'）。 播放和静音的持续时间。范围：500~1000；单位：毫秒。 字符串类型。DTMF 音、播放时间和静音时间的组合，用逗号隔开。 DTMF 音 范围：0~9、*、#、A~D（两个 DTMF 音之间不需要逗号）。 播放时间 范围：100~1000；单位：毫秒。 静音时间 范围：100~1000；单位：毫秒。 例如，'AB,500,500,DCD,100,1000'表示 AB 音、播放 500 毫秒、静音 500 毫秒； DCD 音、播放 100 毫秒、静音 1000 毫秒。 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 27 / 33 举例 AT+QWDTMF=? +QWDTMF: (1),(0),(0-9,*,#,A-D),(500-1000) OK AT+QWDTMF=1,0,'1,2,3,A,B',500 OK AT+QWDTMF OK ECx00U&EGx00U&EG915U 系列音频应用指导 //测试命令。 //播放 1、2、3、A、B，播放时间 500 毫秒， 静音时间 500 毫秒。 //停止播放。 2.3.18. AT+QLTONE 播放本地定制音调 该命令用于播放本地定制音调。 AT+QLTONE 播放本地定制音调 测试命令 AT+QLTONE=? 响应 +QLTONE: ( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的范围),(支持的范围),(支 持的范围) 设置命令 AT+QLTONE=[,, ,,] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放完成时返回： +QLTONE: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。停止或开始播放。 0 停止播放 1 开始播放 整型。音调频率。范围：50~3500；单位：赫兹。 上海移远通信技术股份有限公司 28 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 整型。音调的播放时间。范围：1~1000；单位：毫秒。 整型。音调的静音时间。范围：1~1000；单位：毫秒。 整型。音调的总时长。范围：1~15300000；单位：毫秒。 错误码。详情请参考第 3 章。 举例 AT+QLTONE=? //测试命令。 +QLTONE: (0,1),(50-3500),(1-1000),(1-1000),(1-15300000) OK AT+QLTONE=1,1000,200,300,3000 OK //播放 1000 赫兹音调，播放时间 200 毫秒，静音时间 300 毫秒， 总时长 3000 毫秒。 +QLTONE: 0 AT+QLTONE=0 OK //停止播放。 2.3.19. AT+QLTONEX 播放本地定制音调 该命令用于播放本地定制音调。 AT+QLTONEX 播放本地定制音调 测试命令 AT+QLTONEX=? 响应 +QLTONEX: ( 支 持 的 列 表 ),,( 支 持 的 范围) 设置命令 AT+QLTONEX=[,, ] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放完成时返回： +QLTONEX: 0 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 29 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 参数 整型。停止或开始播放。 0 停止播放 1 开始播放 字符串类型。待播放音调配置。格式为： ',,,,' 整型。待播放音调的最低频率。范围：50~3500；单位：赫兹。 整型。待播放音调的最高频率。范围：50~3500；单位：赫兹。 整型。音调的播放时间。范围：1~1000；单位：毫秒。 整型。音调的静音时间。范围：1~1000；单位：毫秒。 整型。待播放音调编号。范围：0~4。 整型。音调的总时长。范围：10~65535；单位：毫秒。 错误码。详情请参考第 3 章。 举例 AT+QLTONEX=? +QLTONEX: (0,1),,(10-65535) OK AT+QLTONEX=1,'500,1000,400,400,1','300,800,600,600,0',4000 //播放 500~1000 赫兹音调，播放时间 400 毫秒，静音时间 400 毫秒；播放 300~800 赫兹音调，播放时间 600 毫秒，静音时间 600 毫秒；循环播放，直到总时间达到 4000 毫秒。 OK +QLTONEX: 0 AT+QLTONEX=0 OK //停止播放。 2.3.20. AT+QTONEDET 启用/禁用 DTMF 检测 该命令用于启用或禁用 DTMF 检测。若启用此功能，远端发送的 DTMF 音会被检测并上报到指定的串 口。 AT+QTONEDET 启用/禁用 DTMF 检测 测试命令 AT+QTONEDET=? 响应 +QTONEDET: (支持的列表) 查询命令 AT+QTONEDET? OK 响应 +QTONEDET: 上海移远通信技术股份有限公司 30 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 设置命令 AT+QTONEDET= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用 DTMF 检测。 0 禁用 1 启用 错误码。详情请参考第 3 章。 备注 DTMF 字符-ASCII： DTMF 0 1 2 3 4 5 6 7 ASCII 48 49 50 51 52 53 54 55 DTMF 8 9 A B C D * # ASCII 56 57 65 66 67 68 42 35 上海移远通信技术股份有限公司 31 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 3 错误码 表 5：+CME ERROR: 错误码 901 英文含义 Audio unknown error 902 Audio invalid parameters 903 Audio operation not supported 904 Audio device busy 中文含义 未知音频错误 音频参数和无效，或播放 字符为空 在无通话状态下播放 TTS，不支持该音频操作 音频设备繁忙 上海移远通信技术股份有限公司 32 / 33 ECx00U&EGx00U&EG915U 系列音频应用指导 4 附录 术语缩写 表 6：术语缩写 缩写 ASCII GBK IIC ME MIC MSC MT PA PCM TA TTS UFS URC 英文全称 中文全称 American Standard Code for Information Interchange 美国信息交换标准码 Chinese Internal Code Specification 汉字内码扩展规范 Inter-Integrated Circuit 集成电路总线 Mobile Equipment 移动设备 Microphone 麦克风 Mobile Switching Center 移动交换中心 Mobile Termination 移动终端 Power Amplifier 功率放大器 Pulse Code Modulation 脉冲编码调制 Terminal Adapter 终端适配器 Text To Speech 从文本到语音 User File System 用户文件系统 Unsolicited Result Code 非请求结果码 上海移远通信技术股份有限公司 33 / 33

LTE Standard(U)系列 低功耗模式应用指导 LTE Standard 模块系列 版本：2.1 日期：2024-04-26 状态：受控文件 LTE Standard(U)系列低功耗模式应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 27 LTE Standard(U)系列低功耗模式应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 27 LTE Standard(U)系列低功耗模式应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2021-04-18 Marvin NING 文档创建 1.0 2021-05-31 Marvin NING 受控版本 1.1 2021-08-20 Marvin NING 增加适用模块 EG915U 系列。 2.0 2022-02-22 Felix LIN 2.1 2024-04-26 Felix LIN 1. 更新引言内容描述（第 1 章）。 2. 新增启用/禁用普通模式休眠和 PSM 模式下的休眠的 AT 命令 （第 2.3.1 章）。 3. 新增关于低功耗模式和增强型休眠模式的 AT 命令设置对模块 状态改变的备注和启用增强型休眠模式的 AT 命令示例（第 2.3.2 章）。 4. 新增在增强型休眠模式下 PSM 流程的应用场景测试及注意事 项（第 3.2 章）。 1. 增加适用模块 EC200G-CN、EC600G 系列、EG700G-CN、 EC800G-CN、EG800G 系列、EG912U 系列和 EG915G-EU。 2. 新增普通休眠模式、增强型休眠模式和 PSM 模式相关备注 （第 1 章）。 3. 更新查看网络下发定时器的查看方式和模块在 PSM 模式下被 唤醒的方式（第 2.3.1 章）。 4. 拓 展 AT+QSCLKEX 命 令 功 能 并 新 增 和 默认值信息（第 2.3.2 章）。 5. 新增 AT+QNWCFG='psm/timer'和 AT+QCFG='psmwakeup/ pin'（第 2.3.3 和 2.3.4 章）。 6. 新增耗流数据说明备注（第 3 章）。 7. 更新注意事项（第 3.1.5 和 3.2.5 章）。 上海移远通信技术股份有限公司 3 / 27 LTE Standard(U)系列低功耗模式应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 2 相关 AT 命令 ......................................................................................................................................... 9 2.1. AT 命令说明................................................................................................................................ 9 2.1.1. 定义 ................................................................................................................................. 9 2.1.2. AT 命令语句..................................................................................................................... 9 2.2. AT 示例声明.............................................................................................................................. 10 2.3. AT 命令详解.............................................................................................................................. 10 2.3.1. AT+QSCLK 启用/禁用普通休眠模式和 PSM 模式 ...................................................... 10 2.3.2. AT+QSCLKEX 启用/禁用增强型休眠模式 .................................................................. 13 2.3.3. AT+QNWCFG='psm/timer' 获取网络下发的 PSM 相关定时器参数 .......................... 14 2.3.4. AT+QCFG='psmwakeup/pin' 配置 PSM 休眠唤醒引脚 ............................................. 16 3 应用场景测试及注意事项 .................................................................................................................... 18 3.1. 普通休眠模式和增强型休眠模式 .............................................................................................. 18 3.1.1. 测试步骤 ........................................................................................................................ 18 3.1.1.1. 测试场景 ............................................................................................................. 18 3.1.1.2. 需统计数据项...................................................................................................... 18 3.1.1.3. 测试步骤 ............................................................................................................. 18 3.1.2. 测试数据 ........................................................................................................................ 19 3.1.3. 测试示例 ........................................................................................................................ 19 3.1.3.1. EC200U 系列不同休眠模式下平均耗流数据对比图 ........................................... 20 3.1.3.2. EC600U 系列不同休眠模式下平均耗流数据对比图 ........................................... 22 3.1.3.3. 模块不同休眠模式下平均耗流数据对比.............................................................. 23 3.1.4. 测试结论 ........................................................................................................................ 24 3.1.5. 注意事项 ........................................................................................................................ 24 3.2. PSM 模式 ................................................................................................................................. 24 3.2.1. 测试步骤 ........................................................................................................................ 24 3.2.1.1. 测试场景 ............................................................................................................. 24 3.2.1.2. 需统计数据项...................................................................................................... 24 3.2.1.3. 测试步骤 ............................................................................................................. 25 3.2.2. 测试数据 ........................................................................................................................ 25 3.2.3. 测试示例 ........................................................................................................................ 26 3.2.4. 测试结论 ........................................................................................................................ 26 3.2.5. 注意事项 ........................................................................................................................ 26 4 附录 参考文档和术语缩写 .................................................................................................................. 27 上海移远通信技术股份有限公司 4 / 27 LTE Standard(U)系列低功耗模式应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型........................................................................................................................................ 9 表 3：EC200U 系列不同休眠模式下平均耗流数据对比............................................................................. 19 表 4：EC600U 系列不同休眠模式下平均耗流数据对比............................................................................. 19 表 5：模块不同休眠模式下平均耗流数据对比............................................................................................ 23 表 6：EC600U 系列 PSM 模式下唤醒的平均耗流数据 .............................................................................. 25 表 7：参考文档 ........................................................................................................................................... 27 表 8：术语缩写 ........................................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 27 LTE Standard(U)系列低功耗模式应用指导 图片索引 图 1：EC200U 系列普通休眠模式下平均耗流 ........................................................................................... 20 图 2：EC200U 系列增强型休眠模式下平均耗流........................................................................................ 21 图 3：EC600U 系列普通休眠模式下平均耗流 ........................................................................................... 22 图 4：EC600U 系列增强型休眠模式下平均耗流........................................................................................ 23 图 5：EC600U 系列 PSM 模式下唤醒的平均耗流 ..................................................................................... 26 上海移远通信技术股份有限公司 6 / 27 LTE Standard(U)系列低功耗模式应用指导 1 引言 本文档主要介绍了在 LTE 网络制式下 LTE Standard(U)系列模块低功耗模式的应用指导，包括相关 AT 命令的介绍、应用场景中模块在不同休眠模式下平均耗流测试数据的对比及注意事项。 低功耗模式即低功耗休眠，包括普通休眠模式、增强型休眠模式和 PSM 模式。 普通休眠（通过 AT+QSCLK 控制，关于该 AT 命令的详细信息，请参考第 2.3.1 章）可由引脚控制进 入，亦可在数据收发完成后进入，可降低整体平均耗流。 增强型休眠模式即模块收发数据后可快速休眠。其与普通休眠模式的区别主要体现在数据收发有时间 间隔的场景下，在数据收发完成后，处于增强型休眠模式的模块能够更快进入休眠状态，从而降低整体平 均耗流。 PSM 模式即超低功耗休眠模式。其与普通休眠模式的区别体现在 PSM 模式功耗更低，相当于模块已 经关机，仅保留默认承载用以开机快速驻网。 备注 模块处于普通休眠模式或增强型休眠模式时可以进入PSM模式。使能PSM模式后，如果没有配置模块 进入增强型休眠模式，则进入PSM模式前，模块会先处于普通休眠模式。 1.1. 适用模块 表 1：适用模块 模块系列 ECx00G ECx00U 模块 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 上海移远通信技术股份有限公司 7 / 27 EGx00U EGx00G EG91xU EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG915G-EU EG912U 系列 EG915U 系列 LTE Standard(U)系列低功耗模式应用指导 上海移远通信技术股份有限公司 8 / 27 LTE Standard(U)系列低功耗模式应用指导 2 相关 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 27 LTE Standard(U)系列低功耗模式应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QSCLK 启用/禁用普通休眠模式和 PSM 模式 该命令用于控制模块是否进入普通休眠模式和 PSM 模式。 AT+QSCLK 启用/禁用普通休眠模式和 PSM 模式 测试命令 AT+QSCLK=? 响应 +QSCLK: (支持的范围),(支持的范 围),, 查询命令 AT+QSCLK? OK 响应 +QSCLK: [,[,, ]] 设置命令 AT+QSCLK=[,[,[,]]] 最大响应时间 特性说明 OK 响应 OK 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用/禁用普通休眠模式和 PSM 模式。 0 禁用普通模式休眠和 PSM。 1 启用普通休眠模式。由 DTR 和 WAKEUP_IN 引脚控制模块进入普通休 眠模式。若 DTR 和 WAKEUP_IN 引脚均为高电平时，模块将直接进入 普通休眠模式；若 DTR 或 WAKEUP_IN 任一引脚被拉低，则模块无法 进入普通休眠模式。 上海移远通信技术股份有限公司 10 / 27 LTE Standard(U)系列低功耗模式应用指导 2 启用普通休眠模式。若串口在时间内无数据交互，模块将 进入普通休眠模式；若有数据交互则唤醒模块。 3 启用 PSM 模式。模块需重新驻网，PSM 模式才能生效。 整型。串口无数据交互后进入低功耗模式的时间。范围：1~255；默认值：5； 单位：秒。 该参数仅在=2 或 3 时可进行配置。若该参数省略，则参数值默认为 5 秒。 通常情况下，该参数掉电不保存；若在=3 时配置，则在进入 PSM 模式 前该参数配置会保存，模块唤醒后依然有效。 字符串类型。该参数仅在=3 时可进行配置，在进入 PSM 模式前该参数 配置会保存，模块唤醒后依然有效。 TAU 周期请求定时器（T3412）的值。该值指定为由模块向网络上报的 T3412 参考值。当启用 PSM 模式时，模块会上报该值。若(U)SIM 卡与网络支持 PSM 模式，则由网络侧决定是否使用参考值进行下发，模块无法预知网络行为。 TAU 周期请求定时器（T3412）的值按照 GPRS Timer 3（octet 3）格式以一 个字节的形式按位编码（如'01000111'代表 70 小时）。该值的编码格式及 范围根据 3GPP TS 24.008 中 Table 10.5.163a/3GPP TS 24.008 的 GPRS Timer 3 value 定义。该定时器介绍可参考 3GPP TS 24.301 的第 10.2 章。 若默认值无法获取，则由模块指定。 GPRS Timer 3 value (octet 3) Bit 5 至 Bit 1 表示二进制编码的定时器值； Bit 6 至 Bit 8 定义的 GPRS 定时器值的单位如下： Bits 8 7 6 0 0 0 该值以 10 分钟的倍数递增 0 0 1 该值以 1 小时的倍数递增 0 1 0 该值以 10 小时的倍数递增 0 1 1 该值以 2 秒的倍数递增 1 0 0 该值以 30 秒的倍数递增 1 0 1 该值以 1 分钟的倍数递增 1 1 0 该值以 320 小时的倍数递增（详情请参考 3GPP TS 24.008 中的 Table 10.5.163a/3GPP TS 24.008） 1 1 1 该值表示定时器已停用（详情请参考 3GPP TS 24.008 中的 Table 10.5.163a/3GPP TS 24.008） 字符串类型。该参数仅在=3 时可进行配置。在进入 PSM 模式前该参数 配置会保存，模块唤醒后依然有效。 激活定时器（T3324）的值。该值指定为由模块向网络上报的 T3324 参考值。 当启用 PSM 模式时，模块会上报该值。若(U)SIM 卡与网络支持 PSM 模式， 则由网络侧决定是否使用参考值进行下发，模块无法预知网络行为。 激活定时器的值按照 GPRS Timer 2（octet 2）格式以一个字节的形式按位编 上海移远通信技术股份有限公司 11 / 27 LTE Standard(U)系列低功耗模式应用指导 码（如'00100100'代表 4 分钟）。该值的编码格式及范围根据 3GPP TS 24.008 中 Table 10.5.172/3GPP TS 24.008 的 GPRS Timer 2 value 定义。 该定时器介绍可参考 3GPP TS 24.008 的第 11.2.2.章。若默认值无法获取， 则由模块指定。 GPRS Timer 2 value (octet 2) Bit 5 至 Bit 1 表示二进制编码的定时器值； Bit 6 至 Bit 8 定义的 GPRS 定时器值的单位如下： Bits 8 7 6 0 0 0 该值以 2 秒的倍数递增 0 0 1 该值以 1 分钟的倍数递增 0 1 0 该值以 10 小时的倍数递增 1 1 1 该值表示定时器已停用 在此版本的协议中，其他值应解释为以 1 分钟的倍数递增。 备注 1. 启用低功耗模式时，控制模块进入低功耗的方式相互独立，即的取值互不包含，需要独立配置。 2. 普通休眠模式下，主串口可以通过AT命令唤醒。 3. 普通休眠模式下，若主串口流控未开启，则不可直接通过主串口发送较大数据（超过127个字节） 至模块。发送较大数据前，模块需先退出低功耗模式，否则可能出现数据丢失的情况。 4. 通过AT+QSCLK?查询到的参数值和为模块上报的定时器 的参考值。网络下发的定时器值可以通过AT+QNWCFG='psm/timer'进行获取。 5. 模块在PSM模式下可通过以下情况被唤醒： 1) 拉高中断唤醒引脚PSM_EXT_INT（仅EC600U系列和EC600G系列模块支持）或PSM_EINT （仅EG915G-EU和EG915U系列模块支持）； 2) TAU周期请求定时器（T3412）唤醒； 3) RTC时钟唤醒； 4) 拉低PWRKEY唤醒； 5) 用户配置的中断唤醒引脚唤醒（仅ECx00G系列、EGx00G系列和EG915G-EU模块支持）。 6. 部分模块型号没有WAKEUP_IN引脚，具体以对应模块的硬件设计手册为准。 上海移远通信技术股份有限公司 12 / 27 LTE Standard(U)系列低功耗模式应用指导 举例 AT+QSCLK=? +QSCLK: (0-3),(1-255),, OK AT+QSCLK=3,1,'00100001','00000001' OK AT+QSCLK? +QSCLK: 3,1,'00100001','00000001' //串口无数据交互 1 秒后模块进入普通休眠模式，将 T3412 定时器设置为 1 小时，T3324 定时器设置为 2 秒。 OK 2.3.2. AT+QSCLKEX 启用/禁用增强型休眠模式 该命令用于启用或禁用增强型休眠模式。若在禁用低功耗模式（+QSCLK: 0）时启用增强型休眠模式 （AT+QSCLKEX=1），AT+QSCLK 中的参数会自动设置为 1，此时模块默认处于由引脚控制的普通休 眠模式（+QSCLK: 1）。若需要修改模块的低功耗状态，可执行 AT+QSCLK=[,[,[,]]]。 AT+QSCLKEX 启用/禁用增强型休眠模式 测试命令 AT+QSCLKEX=? 响应 +QSCLKEX: (支持的列表),(支持的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 列 表) 查询命令 AT+QSCLKEX? OK 响应 +QSCLKEX: ,,, 设置命令 AT+QSCLKEX=[,[,[,]]] 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 13 / 27 参数 LTE Standard(U)系列低功耗模式应用指导 整型。禁用/启用增强型休眠模式。 0 禁用 1 启用 整型。模块发送完数据后进入休眠状态的时间。范围：1~50；默认值：3；单位：秒。 整型。遇到异常情况恢复增强型休眠模式的时间。范围：1~600；默认值：30；单位： 分钟。该参数暂无意义，可配置 1~600 之间的任意值，无实际作用。 整型。使能增强型休眠后执行 TAU 上报的类型。 1 联合跟踪区/位置区更新 3 周期性更新 备注 启用增强型休眠模式后，无论模块处于任何状态下再次禁用增强型休眠模式，模块状态均会被切换为禁 用低功耗状态（+QSCLK: 0）。 举例 AT+QSCLKEX=? +QSCLKEX: (0,1),(1-50),(1-600),(1,3) OK AT+QSCLKEX=1,1,30 OK AT+QSCLKEX? +QSCLKEX: 1,1,30,3 OK 2.3.3. AT+QNWCFG='psm/timer' 获取网络下发的 PSM 相关定时器参数 该命令用于获取网络下发的 PSM 相关定时器参数。 AT+QNWCFG='psm/timer' 测试命令 AT+QNWCFG=? 获取网络下发的 PSM 相关定时器参数 响应 +QNWCFG: 'psm/timer',,,, ... OK 上海移远通信技术股份有限公司 14 / 27 执行命令 AT+QNWCFG='psm/timer' 最大响应时间 特性说明 LTE Standard(U)系列低功耗模式应用指导 响应 +QNWCFG: 'psm/timer',,,, OK 或 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。网络下发的 TAU 周期性定时器（T3412）的值。单位：毫秒。 整型。TAU 周期性定时器（T3412）到期的值。该值为 0 时，模块将发 起周期性 TAU。单位：毫秒。 整型。网络下发的激活定时器（T3324）的值。该值仅在网络支持 PSM 模式时可获取。单位：毫秒。 整型。激活定时器（T3324）到期的值。该值仅在网络支持 PSM 模式 时可获取。该值为 0 时，模块将进入 PSM 模式。单位：毫秒。 错误码。详情参见文档 [1]中的错误码汇总章节。 备注 参数仅在使能PSM模式（AT+QSCLK=3）后，且RRC处于释放状态时，会进 行计时。 举例 AT+QNWCFG='psm/timer' +QNWCFG: 'psm/timer',3240000,2060143,0,0 //网络或(U)SIM 卡不支持 PSM 模式。 OK AT+QNWCFG='psm/timer' +QNWCFG: 'psm/timer',3240000,3219848,2000,2000 //网络或(U)SIM 卡支持 PSM 模式。 OK 上海移远通信技术股份有限公司 15 / 27 LTE Standard(U)系列低功耗模式应用指导 2.3.4. AT+QCFG='psmwakeup/pin' 配置 PSM 休眠唤醒引脚 该命令用于配置 PSM 休眠唤醒引脚。 AT+QCFG='psmwakeup/pin' 测试命令 AT+QCFG=? 配置 PSM 休眠唤醒引脚 响应 +QCFG: 'psmwakeup/pin',(支持的列表),(支 持的列表) ... 执行命令 AT+QCFG='psmwakeup/pin'[,,[ ]] OK 响应 若省略可选参数，则返回 PSM 休眠唤醒引脚配置： +QCFG: 'psmwakeup/pin',, OK 若指定可选参数，则配置 PSM 休眠唤醒引脚： OK 或 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 十六进制类型。该值指定是否使能 GPIO0~GPIO7 引脚的 PSM 休眠唤 醒功能。 例：0x05 = 0x1 (GPIO0) + 0x4 (GPIO2)使能 GPIO0 和 GPIO2 的 PSM 休眠唤醒功能。 0 关闭 0x1 使能 GPIO0 的 PSM 休眠唤醒功能 0x2 使能 GPIO1 的 PSM 休眠唤醒功能 0x4 使能 GPIO2 的 PSM 休眠唤醒功能 0x8 使能 GPIO3 的 PSM 休眠唤醒功能 0x10 使能 GPIO4 的 PSM 休眠唤醒功能 0x20 使能 GPIO5 的 PSM 休眠唤醒功能 0x40 使能 GPIO6 的 PSM 休眠唤醒功能 0x80 使能 GPIO7 的 PSM 休眠唤醒功能 上海移远通信技术股份有限公司 16 / 27 LTE Standard(U)系列低功耗模式应用指导 十六进制类型。该值指定 GPIO0~GPIO7 的 PSM 休眠唤醒电平。 例：0x05 = 0x1 (高电平) + 0x4 (高电平)配置 GPIO0 和 GPIO2 的 PSM 休眠唤醒电平。该值与一起使用才会生效。默认均为高电平 唤醒。 0 低电平唤醒 1 高电平唤醒 错误码。详情参见文档 [1]中的错误码汇总章节。 备注 1. 仅ECx00G、EGx00G系列和EG915G-EU模块支持该命令。 2. 该中断唤醒引脚配置与模块运行的GPIO配置不会相互影响，但会受到外部硬件电路影响。 3. 若省略，将使用默认值或上一次的配置。 举例 AT+QCFG='psmwakeup/pin' +QCFG: 'psmwakeup/pin',0x0,0xff OK AT+QCFG='psmwakeup/pin',0x8,0xff OK //打开 GPIO3 引脚的 PSM 休眠唤醒功能，高电平唤醒。 上海移远通信技术股份有限公司 17 / 27 LTE Standard(U)系列低功耗模式应用指导 3 应用场景测试及注意事项 本章节（以 EC200U 系列和 EC600U 系列模块为例）主要描述和展示了应用场景中，模块在普通休眠 模式、PSM 模式及增强型休眠模式下平均耗流测试的步骤、数据对比、示例、结论及注意事项，供用户参 考。 备注 本章节示例中涉及到的耗流数据，各模块子型号间可能会存在差异，具体以实测为准。 3.1. 普通休眠模式和增强型休眠模式 3.1.1. 测试步骤 3.1.1.1. 测试场景 建立 TCP 长连接，每间隔 60 秒向服务器发送 100 字节数据。 3.1.1.2. 需统计数据项 ⚫ 测试时长 ⚫ 普通休眠模式和增强型休眠模式下进入低功耗模式的平均时长 ⚫ 发送一包数据到进入低功耗模式并等待一定时间的过程中（如下测试步骤 3~步骤 4）的平均耗流。 3.1.1.3. 测试步骤 步骤1： 执行AT+QSCLKEX=1,2,10启用增强型休眠模式； 步骤2： 执行AT+QIOPEN（关于该AT命令的详细信息，请参考文档 [2]）建立TCP连接； 步骤3： 执行AT+QISEND（关于该AT命令的详细信息，请参考文档 [2]）发送一包数据（100字节）； 步骤4： 拉高DTR进入低功耗模式，等待60秒钟（统计平均耗流）； 步骤5： 拉低DTR唤醒模块； 步骤6： 循环步骤 3~步骤 5（共 0.5 小时）。 上海移远通信技术股份有限公司 18 / 27 LTE Standard(U)系列低功耗模式应用指导 3.1.2. 测试数据 表 3：EC200U 系列不同休眠模式下平均耗流数据对比 运营商/制式 移动 LTE 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 测试时长 （小时） 0.5 0.5 普通休眠模式 0.5 联通 LTE 增强型休眠模式 0.5 普通休眠模式 0.5 电信 LTE 增强型休眠模式 0.5 进入低功耗平均时长（秒） 平均耗流（毫安） 10.2 17.41 2.5 6.60 20.2 31.87 2.1 5.84 5.8 11.24 3.0 7.26 表 4：EC600U 系列不同休眠模式下平均耗流数据对比 运营商/制式 移动 LTE 普通休眠模式/ 增强型休眠模式 普通休眠模式 增强型休眠模式 测试时长 （小时） 0.5 0.5 普通休眠模式 0.5 联通 LTE 增强型休眠模式 0.5 普通休眠模式 0.5 电信 LTE 增强型休眠模式 0.5 进入低功耗平均时长（秒） 平均耗流（毫安） 10.3 16.36 2.4 5.13 20.1 30.99 2.1 4.75 5.9 10.59 3.1 6.63 3.1.3. 测试示例 本章节主要展示了 EC200U 系列、EC600U 系列模块分别在普通休眠模式和增强型休眠模式下的平均 耗流对比图，仅为较优测试场景下的测试示例。 测试场景： ⚫ EC200U 系列和 EC600U 模块均配置 AT+QSCLKEX=1,2,10 启用增强型休眠功能； ⚫ 插入联通卡并注册 LTE Band 3； ⚫ 模块和服务器之间建立 TCP 长连接； ⚫ 测试时长：0.5 小时。 上海移远通信技术股份有限公司 19 / 27 LTE Standard(U)系列低功耗模式应用指导 3.1.3.1. EC200U 系列不同休眠模式下平均耗流数据对比图 ⚫ 普通休眠模式 图 1：EC200U 系列普通休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 20 秒，之后进入休眠状态，60 秒内平均耗流为 29.92 毫安。 上海移远通信技术股份有限公司 20 / 27 ⚫ 增强型休眠模式 LTE Standard(U)系列低功耗模式应用指导 图 2：EC200U 系列增强型休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 2 秒，之后进入休眠状态，60 秒内平均耗流为 5.63 毫安。 对比图 1 和图 2，在增强型休眠模式下模块在收发数据后能够快速进入休眠状态，从而降低平均耗流。 上海移远通信技术股份有限公司 21 / 27 LTE Standard(U)系列低功耗模式应用指导 3.1.3.2. EC600U 系列不同休眠模式下平均耗流数据对比图 ⚫ 普通休眠模式 图 3：EC600U 系列普通休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 20 秒，之后进入休眠状态，60 秒内平均耗流为 32.08 毫安。 上海移远通信技术股份有限公司 22 / 27 ⚫ 增强型休眠模式 LTE Standard(U)系列低功耗模式应用指导 图 4：EC600U 系列增强型休眠模式下平均耗流 如上图所示，模块接收数据后，波峰电流时长约为 2 秒，之后进入休眠状态，60 秒内平均耗流为 4.72 毫安。 对比图 3 和图 4，在增强型休眠模式下模块在接收数据后能够快速进入休眠状态，从而降低平均耗流。 3.1.3.3. 模块不同休眠模式下平均耗流数据对比 表 5：模块不同休眠模式下平均耗流数据对比 运营商/制式 模块 普通休眠模式/ 增强型休眠模式 联通 LTE EC200U 系列 EC600U 系列 普通休眠模式 增强型休眠模式 普通休眠模式 增强型休眠模式 时长（小时） 0.5 0.5 0.5 0.5 平均耗流（毫安） 31.867 5.844 30.985 4.747 上海移远通信技术股份有限公司 23 / 27 LTE Standard(U)系列低功耗模式应用指导 3.1.4. 测试结论 通过对模块在增强型休眠模式启用前后平均耗流数据的对比可见，增强型休眠模式下降低功耗效果明 显。 3.1.5. 注意事项 启用增强型休眠模式后，当用户发起数据交互时，会给基站带来额外的信令负担，因此可能会出现终 端收到网络侧惩罚而无法上线的情况。该功能默认关闭，客户使用前需自行评估风险。 3.2. PSM 模式 本章节（以 EC600U 系列模块为例）主要描述和展示了从增强型休眠模式下进 PSM 的时间、平均耗 流以及耗电量。 3.2.1. 测试步骤 3.2.1.1. 测试场景 从 PSM 模式中唤醒模块后，建立 TCP 短连接，向服务器发送 20 字节数据，此后等待模块重新进入 PSM 模式。 前置条件： 1. 将耗流板连接电源适配器和 N6705C 耗流设备； 2. 将耗流板与 USB 断开连接； 3. 模块使用联通物联网卡； 4. 网络环境：网络下发的 T3324 定时器为 2 秒。 3.2.1.2. 需统计数据项 ⚫ 进入 PSM 模式后的平均耗流； ⚫ 普通休眠模式和增强型休眠模式下进入低功耗的平均时间； ⚫ 统计下列场景的持续时间、平均耗流以及耗电量： a) 模块初始化 b) 模块驻网 c) 模块数据收发 d) 模块 T3324 等待阶段 ⚫ 模块在整个 PSM 流程中的耗流图。 上海移远通信技术股份有限公司 24 / 27 LTE Standard(U)系列低功耗模式应用指导 3.2.1.3. 测试步骤 步骤 1： 执行 AT+CFUN=4（关于该 AT 命令的详细信息，请参考文档 [2] ）进入飞行模式； 步骤 2： 执行 AT+QSCLKEX=1,1,30 启用增强型休眠模式； 步骤 3： 执行 AT+QSCLK=3,1,'00100001','00000001'启用 PSM 模式，其中 T3412 定时器上报时 长为 1 小时，T3324 定时器上报时长为 2 秒（具体定时器介绍请参考第 2.3.1 章），串口无数 据交互 1 秒后模块进入休眠模式； 步骤 4： 执行 AT+CFUN=1 退出飞行模式； 步骤 5： 完成上述配置后，模块在驻网成功的情况下，无任何数据交互动作后会自动进入 PSM 模式。 （若无网络数据交互会触发 T3324 定时器；若无串口数据交互会触发配置） 待模块的休眠灯，网络状态灯均熄灭则说明模块已进入 PSM 模式； 步骤 6： 模块进入 PSM 模式后，手动将 PSM_EXT_INT 引脚上拉到 1.8 V，确认模块唤醒后，可继续 执行下述操作； 步骤 7： 执行 AT+QIOPEN（关于该 AT 命令的详细信息，请参考文档 [2]）建立 TCP 短连接； 步骤 8： 执行 AT+QISEND（关于该 AT 命令的详细信息，请参考文档 [2]）发送一包数据（20 字节）； 步骤 9： 由于启用了增强型休眠模式，且设置的本地 RRC 释放时间为 1 秒，此时网络 RRC 会快速释 放。在 AT+QISEND 发送完毕，网络快速释放 RRC 后，模块根据网络下发的 T3324 定时器 时长开始计时。待计时结束，模块会重新进入 PSM 模式； 步骤 10：步骤 6~步骤 9 为一次唤醒周期。可选取任意一次唤醒周期进行数据统计。 3.2.2. 测试数据 表 6：EC600U 系列 PSM 模式下唤醒的平均耗流数据 模式 PSM 休眠 模块初始化 + 等待数据包 驻网 数据收发 + RRC 释放 IDLE PSM 休眠 总计 持续时间（s） 2.288 0.371 1.535 2.142 6.336 平均耗流（mA） 0.004 31.552 61.989 79.582 5.543 0.004 36.152 耗电量（μAh） 20.053 6.388 33.933 3.298 63.628 上海移远通信技术股份有限公司 25 / 27 3.2.3. 测试示例 LTE Standard(U)系列低功耗模式应用指导 图 5：EC600U 系列 PSM 模式下唤醒的平均耗流 3.2.4. 测试结论 模块从增强型休眠模式下进入 PSM 总共经过 4 个阶段，分别是：模块的初始化、模块驻网、模块发送 TCP 数据及等待模块进入 PSM 模式。 ⚫ 模块的初始化持续时间为 2.288 s，平均耗流为 31.552 mA，耗电量为 20.053 μAh； ⚫ 模块驻网持续时间为 0.371 s，平均耗流为 61.989 mA，耗电量为 6.388 μAh； ⚫ 模块发送 TCP 数据持续时间为 1.535 s，平均耗流为 79.582 mA，耗电量为 33.933 μAh； ⚫ T3324 定时器等待模块进入 PSM 模式的持续时间为 2.142 s，平均耗流为 5.543 mA，耗电量为 3.298 μAh；当模块再次进入 PSM 模式后，平均耗流维持在 5 μA 以内，比较稳定。 通过如上可见，模块从 PSM 模式被唤醒到再次进入 PSM 模式总耗时为 6.336 s，平均耗流为 36.152 mA，耗电量为 63.628 μAh。 3.2.5. 注意事项 启用增强型休眠模式后，当用户发起数据交互时，会给基站带来额外的信令负担，因此可能会出现终 端收到网络侧惩罚而无法上线的情况。该功能默认关闭，客户使用前需自行评估风险。 PSM 模式启用后，模块会上报 T3412 定时器和 T3324 定时器的值作为参考。若运营商支持 PSM 模式， 则由网络决定是否采用上报的值下发到模块，模块无法预知网络行为。若网络下发的 T3412 定时器的值与 T3324 定时器的值之间的差值小于 5 分钟，则模块不会进入 PSM 模式。也就是说，尽管模块上报的 T3412 定时器的值与 T3324 定时器的值之间的差值大于 5 分钟，但网络下发的 T3412 定时器的值与 T3324 定时 器的值之间的差值小于 5 分钟，模块也不会进入 PSM 模式。 上海移远通信技术股份有限公司 26 / 27 LTE Standard(U)系列低功耗模式应用指导 4 附录 参考文档和术语缩写 表 7：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_AT 命令手册 [2] Quectel_LTE Standard(U)系列_TCP(IP)_应用指导 表 8：术语缩写 缩写 DTR IP LTE PSM RRC TA TAU TCP USB 英文全称 Data Terminal Ready Internet Protocol Long Term Evolution Power Saving Mode Radio Resource Control Terminal Adapter Tracking Area Update Transmission Control Protocol Universal Serial Bus 中文全称 数据终端就绪 网际互连协议 长期演进 节能模式 无线资源控制协议 终端适配器 跟踪区更新 传输控制协议 通用串行总线 上海移远通信技术股份有限公司 27 / 27

ECx00U&EG915U 系列 双卡单待应用指导 LTE Standard 模块系列 版本：1.0 日期：2022-07-20 状态：受控文件 ECx00U&EG915U 系列双卡单待应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 14 ECx00U&EG915U 系列双卡单待应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 14 ECx00U&EG915U 系列双卡单待应用指导 文档历史 修订记录 版本 1.0 日期 2022-01-28 2022-07-20 作者 Joe TU Joe TU 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 14 ECx00U&EG915U 系列双卡单待应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明 ............................................................................................................................... 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句.................................................................................................................... 7 2.2. AT 示例声明 ............................................................................................................................... 8 2.3. AT 命令详解 ............................................................................................................................... 8 2.3.1. AT+QDSIMCFG='dsss' 启用或禁用双卡单待 ............................................................. 8 2.3.2. AT+QDSIM 选择(U)SIM 卡........................................................................................... 9 3 举例 ..................................................................................................................................................... 11 3.1. 启用双卡单待功能 .................................................................................................................... 11 3.2. 双卡切换 ................................................................................................................................... 12 3.3. (U)SIM 卡初始化 ...................................................................................................................... 12 3.4. (U)SIM 卡应用 .......................................................................................................................... 13 4 附录 参考文档及术语缩写 .................................................................................................................. 14 上海移远通信技术股份有限公司 4 / 14 ECx00U&EG915U 系列双卡单待应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 7 表 3：参考文档 ........................................................................................................................................... 14 表 4：术语缩写 ........................................................................................................................................... 14 上海移远通信技术股份有限公司 5 / 14 ECx00U&EG915U 系列双卡单待应用指导 1 引言 本文档主要介绍如何使用移远通信 LTE Standard ECx00U 系列和 EG915U 系列模块的双卡单待（Dual SIM Single Standby）功能。具备该功能的模块可切换使用两张(U)SIM 卡，但是任意时刻都只允许一张 (U)SIM 卡处于待机状态，另一张卡处于关闭状态。 1.1. 适用模块 表 1：适用模块 模块系列 ECx00U EG915U 模块 EC200U 系列 EC600U 系列 EG915U 系列 上海移远通信技术股份有限公司 6 / 14 ECx00U&EG915U 系列双卡单待应用指导 2 AT 命令详解 本章节主要描述和双卡单待相关 AT 命令。 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 14 ECx00U&EG915U 系列双卡单待应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QDSIMCFG='dsss' 启用或禁用双卡单待 该命令用于启用或禁用双卡单待功能。EC200U 系列和 EC600U 系列(U)SIM2 接口的部分引脚默认复 用为其他功能，使用此命令启用双卡单待功能后，上述模块(U)SIM2 接口部分引脚复用成的其他功能将失 效。详情请参考文档 [1]和[2]。 AT+QDSIMCFG='dsss' 启用或禁用双卡单待 设置命令 AT+QDSIMCFG='dsss'[,] 响应 若省略可选参数，则查询当前配置： +QDSIMCFG: 'dsss', OK 若指定可选参数，则启用或禁用双卡单待： OK 最大响应时间 特性说明 若出现任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。启用/禁用双卡单待功能。 0 禁用 1 启用 上海移远通信技术股份有限公司 8 / 14 ECx00U&EG915U 系列双卡单待应用指导 备注 EC200U 系列和 EC600U 系列默认支持单卡单待功能，若需使用双卡单待功能，需先使用此命令启用双 卡单待功能后并重置模块；而 EG915U 系列模块默认支持双卡单待功能，不支持通过此命令启用/禁用双 卡单待功能。 举例 AT+QDSIMCFG='dsss',1 OK AT+QDSIMCFG='dsss' +QDSIMCFG: 'dsss',1 OK //启用双卡单待功能 //查询是否启用双卡单待功能 2.3.2. AT+QDSIM 选择(U)SIM 卡 该命令用于配置双卡单待所使用的(U)SIM 卡。 AT+QDSIM 选择(U)SIM 卡 测试命令 AT+QDSIM=? 响应 +QDSIM: (支持的列表) 查询命令 AT+QDSIM? OK 响应 +QDSIM: 设置命令 AT+QDSIM= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若出现任何错误： +CME ERROR: 10 秒 该命令立即生效； 参数配置自动保存。 上海移远通信技术股份有限公司 9 / 14 ECx00U&EG915U 系列双卡单待应用指导 参数 整型。(U)SIM 卡 ID。 0 (U)SIM 卡 1（以下简称 SIM1） 1 (U)SIM 卡 2（以下简称 SIM2） 错误码。请参考文档 [3]。 举例 AT+QDSIM=0 OK AT+QDSIM? +QDSIM: 0 OK //选择 SIM1 //查询当前使用的(U)SIM 卡 备注 1. AT+QDSIM 命令同时适用于双卡双待和双卡单待，但有以下区别： ⚫ 对于双卡双待来说，该命令的配置仅限于当前的 AT 通道，且参数配置不保存； ⚫ 对于双卡单待来说，该命令的配置会作用于全部 AT 通道，参数配置自动保存。 2. EG915U 系列模块参数取值除了支持 0 和 1 外，还支持 10 和 11，但用于其他功能，使用 双卡单待功能时，请忽略这两个取值。 3. 针对不同软件版本，该命令的生效方式不同，详情请参见对应模块的版本变更说明。 4. 关于双卡双待的详细信息，请参考文档 [4]。 上海移远通信技术股份有限公司 10 / 14 ECx00U&EG915U 系列双卡单待应用指导 3 举例 本章主要介绍如何通过双卡单待功能来切换(U)SIM 卡，进而进行(U)SIM 卡切换后的相关业务。 3.1. 启用双卡单待功能 EC200U 和 EC600U 系列模块需要先启用双卡单待功能并重置模块，然后方可进行(U)SIM 卡切换。 AT+QDSIMCFG='dsss' +QDSIMCFG: 'dsss',0 OK AT+QDSIMCFG='dsss',1 OK AT+CFUN=1,1 OK AT+QDSIMCFG='dsss' +QDSIMCFG: 'dsss',1 OK //查询当前双卡单待是否启用 //启用双卡单待功能 //复位模块以重置(U)SIM 卡引脚功能 //查询当前双卡单待是否启用 备注 AT+CFUN 命令详情，请参考文档 [3]。 上海移远通信技术股份有限公司 11 / 14 3.2. 双卡切换 AT+QDSIM? +QDSIM: 0 OK AT+QDSIM=1 OK AT+QDSIM? +QDSIM: 1 OK ECx00U&EG915U 系列双卡单待应用指导 //查询当前使用的(U)SIM 卡 //选择 SIM2 //查询当前使用的(U)SIM 卡 3.3. (U)SIM 卡初始化 切卡后会自动进行(U)SIM 卡的初始化。 +CPIN: READY +QUSIM: 1 +QIND: SMS DONE +QIND: PB DONE //(U)SIM 卡的状态上报 //(U)SIM 卡的 SMS 初始化完成 //(U)SIM 卡的电话簿初始化完成 上海移远通信技术股份有限公司 12 / 14 ECx00U&EG915U 系列双卡单待应用指导 3.4. (U)SIM 卡应用 成功切换(U)SIM 卡后，双卡单待的相关应用和单卡的应用相同，这里以 AT+CIMI 功能为例。 AT+QDSIM? +QDSIM: 0 OK AT+CIMI 460010154043866 OK AT+QDSIM=1 OK AT+CIMI 460028055174284 OK //查询当前使用的(U)SIM 卡 //查询 MT 中的(U)SIM 卡的 IMSI //选择 SIM2 //查询 MT 中的(U)SIM 卡的 IMSI 备注 AT+CIMI 命令详情，请参考文档 [3]。 上海移远通信技术股份有限公司 13 / 14 ECx00U&EG915U 系列双卡单待应用指导 4 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_EC200U 系列_硬件设计手册 [2] Quectel_EC600U 系列_硬件设计手册 [3] Quectel_LTE_Standard(U)系列_AT 命令手册 [4] Quectel_ EC200D&ECx00G&ECx00U 系列_双卡双待_应用指导 表 4：术语缩写 缩写 英文全称 DSDS Dual SIM Dual Standby DSSS Dual SIM Single Standby I/O Input/Output IMSI International Mobile Subscriber Identity MT Mobile Terminal PHB Phone Book SIM Subscriber Identity Module SMS Short Message Service (U)SIM (Universal) Subscriber Identity Module 中文全称 双卡双待 双卡单待 输入/输出 国际移动用户识别码 移动终端 电话簿 用户身份识别模块 短信息服务 （全球）用户身份模块 上海移远通信技术股份有限公司 14 / 14

LG69T (AA, AJ) IMU 独立解决方案应用指导 GNSS 模块系列 版本：1.0 日期：2024-01-19 状态：受控文件 LG69T(AA,AJ) IMU 独立解决方案应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 LG69T (AA, AJ) IMU 独立解决方案应用指导 GNSS 模块系列 应用指导 受控文件 修订历史 版本 1.0 日期 2023-09-27 2024-01-19 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 目录 关于文档 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 2 模块 IMU 简介 ....................................................................................................................................... 9 2.1. 模块 I2C 接口简介 ...................................................................................................................... 9 2.2. IMU 器件特性说明 .................................................................................................................... 10 2.2.1. 力学特性 ........................................................................................................................ 10 2.2.2. 温度传感器特性 ............................................................................................................. 10 2.3. 主要寄存器说明 ........................................................................................................................ 10 2.3.1. WHO_AM_I (0x0F)........................................................................................................ 10 2.3.2. CTRL1_XL (0x10) ..........................................................................................................11 2.3.3. CTRL2_G (0x11) ........................................................................................................... 12 2.3.4. CTRL3_C (0x12) ........................................................................................................... 13 2.3.5. CTRL4_C (0x13) ........................................................................................................... 14 2.3.6. CTRL6_G (0x15) ........................................................................................................... 14 2.3.7. 输出寄存器 (0x20~0x2D).............................................................................................. 15 2.3.7.1. OUT_TEMP_L (0x20), OUT_TEMP_H (0x21)................................................... 15 2.3.7.2. OUTX_L_G (0x22), OUTX_H_G (0x23) ............................................................ 16 2.3.7.3. OUTY_L_G (0x24), OUTY_H_G (0x25) ............................................................ 16 2.3.7.4. OUTZ_L_G (0x26), OUTZ_H_G (0x27)............................................................. 16 2.3.7.5. OUTX_L_A (0x28), OUTX_H_A (0x29) ............................................................. 17 2.3.7.6. OUTY_L_A (0x2A), OUTY_H_A (0x2B)............................................................. 17 2.3.7.7. OUTZ_L_A (0x2C), OUTZ_H_A (0x2D)............................................................. 18 3 I2C 方式配置模块 IMU ........................................................................................................................ 19 3.1. I2C 总线介绍 ............................................................................................................................ 19 3.1.1. 起始信号和停止信号...................................................................................................... 19 3.1.2. 数据传输及应答 ............................................................................................................. 19 3.1.3. 通信 ............................................................................................................................... 20 3.1.4. 通信地址 ........................................................................................................................ 21 3.2. I2C 操作时序图......................................................................................................................... 21 3.2.1. 写入数据时序................................................................................................................. 21 3.2.2. 读取数据时序................................................................................................................. 22 3.3. 配置流程 ................................................................................................................................... 23 3.3.1. I2C 总线推荐配置 .......................................................................................................... 23 3.3.2. IMU 寄存器推荐配置 ..................................................................................................... 24 4 伪代码示例 .......................................................................................................................................... 26 4.1. 初始化 I2C ................................................................................................................................ 26 上海移远通信技术股份有限公司 4 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 4.2. 初始化 IMU ............................................................................................................................... 27 4.3. 读取 IMU 数据 .......................................................................................................................... 28 4.4. 写入 IMU 数据 .......................................................................................................................... 29 4.5. 数据转换 ................................................................................................................................... 30 4.5.1. 温度数据转换................................................................................................................. 30 4.5.2. 加速度计数据转换 ......................................................................................................... 31 4.5.3. 陀螺仪数据转换 ............................................................................................................. 31 5 附录 A 参考文档及术语缩写 .............................................................................................................. 33 6 附录 B 特殊符号 ................................................................................................................................ 34 上海移远通信技术股份有限公司 5 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 表格索引 表 1：力学特性 ........................................................................................................................................... 10 表 2：温度传感器特性 ................................................................................................................................ 10 表 3：CTRL1_XL 参数说明 .........................................................................................................................11 表 4：CTRL2_G 参数说明.......................................................................................................................... 12 表 5：CTRL3_C 参数说明.......................................................................................................................... 13 表 6：CTRL4_C 参数说明.......................................................................................................................... 14 表 7：CTRL6_G 参数说明.......................................................................................................................... 14 表 8：陀螺仪 LPF1 带宽（单位：HZ）...................................................................................................... 15 表 9：参考文档 ........................................................................................................................................... 33 表 10：术语缩写 ......................................................................................................................................... 33 表 11：特殊符号 ......................................................................................................................................... 34 上海移远通信技术股份有限公司 6 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 图片索引 图 1：I2C 接口连接示意图 ........................................................................................................................... 9 图 2：起始信号和停止信号图 ..................................................................................................................... 19 图 3：I2C 总线的应答................................................................................................................................. 20 图 4：I2C 数据传输完成 ............................................................................................................................. 20 图 5：写入数据时序图 ................................................................................................................................ 21 图 6：读取数据时序图 ................................................................................................................................ 22 图 7：主机 I2C 初始化配置流程 ................................................................................................................. 23 图 8：从机 IMU 配置流程 ........................................................................................................................... 24 上海移远通信技术股份有限公司 7 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 1 引言 本文档主要介绍 LG69T (AA, AJ)模块中 IMU 的功能和用法，以提供 LG69T (AA, AJ)模块 IMU 独立解 决方案。以下简称为模块 IMU。 模块 IMU 包括以下功能： ⚫ 支持输出三轴加速度计和三轴陀螺仪数据以及温度数据 ⚫ 加速度计满量程范围：±16g（g为重力加速度） ⚫ 陀螺仪满量程范围：±125 dps至±4000 dps ⚫ 具有3 KB的数据缓存 ⚫ 支持通过I2C接口进行数据传输 上海移远通信技术股份有限公司 8 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 2 模块 IMU 简介 本章节主要介绍模块的 I2C 接口、IMU 器件相关特性和主要寄存器。 2.1. 模块 I2C 接口简介 模块 IMU 主要通过 LG69T (AA, AJ)的 I2C 接口进行数据传输，I2C 接口特性如下： ⚫ 支持标准模式（100 kbps）模式（400 kbps） ⚫ 仅支持从机模式 ⚫ 支持 7-bit 地址，默认从地址：11010100b MCU I2C_S DA I2C_S CL GND V CC R1 R2 Module GNSS I2C_S DA _S ENS OR IMU I2C_S CL _S ENS OR GND 图 1：I2C 接口连接示意图 备注 上图仅供参考。有关 LG69T (AA, AJ)模块 I2C 接口的引脚定义、接口特性和参考电路，详情请参考 文档 [1]和 [2] hardware designs。 上海移远通信技术股份有限公司 9 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 2.2. IMU 器件特性说明 2.2.1. 力学特性 表 1：力学特性 特性 灵敏度 LA_So 加速度灵敏度 G_So 角速度灵敏度 量程 @LA_FS = ±2g @LA_FS = ±4g @LA_FS = ±8g @LA_FS = ±16g @G_FS = ±125 dps @G_FS = ±250 dps @G_FS = ±500 dps @G_FS = ±1000 dps @G_FS = ±2000 dps @G_FS = ±4000 dps 典型值 0.061 0.122 0.244 0.488 4.37 8.75 17.5 35.0 70.0 140.0 单位 mg/LSB mdps/LSB 2.2.2. 温度传感器特性 表 2：温度传感器特性 特性 TODR TSen 参数 温度刷新率 温度灵敏度 典型值 52 256 单位 Hz LSB/°C 2.3. 主要寄存器说明 本章节对模块 IMU 常用的主要寄存器做介绍说明。 2.3.1. WHO_AM_I (0x0F) 该寄存器（R）用来判断 IMU 型号，其值固定为 0x6B。 上海移远通信技术股份有限公司 10 / 34 WHO_AM_I 寄存器 Bit 7 0 Bit 6 1 LG69T(AA,AJ) IMU 独立解决方案应用指导 Bit 5 1 Bit 4 0 Bit 3 1 Bit 2 0 Bit 1 1 Bit 0 1 2.3.2. CTRL1_XL (0x10) 该寄存器（R/W）用来配置三轴加速度计参数。 CTRL1_XL 寄存器 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 ODR_XL3 ODR_XL2 ODR_XL1 ODR_XL0 FS1_XL1 Bit 2 Bit 1 Bit 0 FS1_XL0 LPF2_XL_EN 0 表 3：CTRL1_XL 参数说明 参数 ODR_XL [3:0] FS [1:0]_XL LPF2_XL_EN 描述 加速度计 ODR。 0000：断电 0001：12.5 Hz 0010：26 Hz 0011：52 Hz 0100：104 Hz 0101：208 Hz 0110：417 Hz 0111：833 Hz 1000：1667 Hz 1001：3333 Hz 1010：6667 Hz 注：不允许将 ODR_XL [3:0]（即 Bit 7~4）设置为 1011 或 11xx。 加速度计量程选择，g 为重力加速度。 00：2g 01：16g 10：4g 11：8g 加速度计高分辨率选择。 0：一阶数字滤波 1：二阶低通滤波 上海移远通信技术股份有限公司 11 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 2.3.3. CTRL2_G (0x11) 该寄存器（R/W）用来配置三轴陀螺仪参数。 CTRL2_G 寄存器 Bit 7 Bit 6 ODR_G3 ODR_G2 Bit 5 ODR_G1 Bit 4 ODR_G0 Bit 3 Bit 2 FS1_G FS0_G Bit 1 FS_125 Bit 0 FS_4000 表 4：CTRL2_G 参数说明 参数 ODR_G [3:0] FS [1:0]_G FS_125 FS_4000 描述 陀螺仪 ODR。 0000：断电 0001：12.5 Hz 0010：26 Hz 0011：52 Hz 0100：104 Hz 0101：208 Hz 0110：417 Hz 0111：833 Hz 1000：1667 Hz 1001：3333 Hz 1010：6667 Hz 注：不允许将 ODR_G [3:0]（即 Bit 7~4）设置为 1011 或 11xx。 陀螺仪量程。 00：250 dps 01：500 dps 10：1000 dps 11：2000 dps 最小量程。 0：FS 通过 FS[1:0]_G 选择 1：FS 设置为 125 dps 最大量程。 0：FS 通过 FS[1:0]_G 或者 FS_125 选择 1：FS 设置为 4000 dps 上海移远通信技术股份有限公司 12 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 备注 1. 当 FS_4000 设置为 1 时，FS_4000 设置生效，FS_125 与 FS [1:0]_G 设置不生效。 2. 当 FS_4000 设置为 0 时： 1) 若 FS_125 设置为 1，则 FS_125 设置生效，FS [1:0]_G 设置不生效。 2) 若 FS_125 设置为 0，则 FS [1:0]_G 设置生效。 2.3.4. CTRL3_C (0x12) 该寄存器（R/W）为控制寄存器 3。 CTRL3_C 寄存器 Bit 7 BOOT Bit 6 BDU Bit 5 0 Bit 4 0 Bit 3 0 Bit 2 IF_INC Bit 1 0 Bit 0 SW_RESET 表 5：CTRL3_C 参数说明 参数 BOOT BDU IF_INC SW_RESET 描述 重新启动内存内容。 0：正常模式 1：重新启动内存内容 注：加速度计必须开启，即 CTRL1_XL 的 ODR_XL [3:0]不为 0，详情请参考 第 2.3.2 章 CTRL1_XL (0x10)。BOOT（Bit 7）配置成 1 生效后，会自动更新为 0。 数据块更新。 0：持续更新 1：在读取 MSB 和 LSB 之前，不会更新输出寄存器 在串行接口（I2C）以寄存器地址自动递增的形式进行多字节访问。 0：禁用 1：启用 软件重置。 0：不复位设备 1：复位 注：SW_RESET（即 Bit 0）配置成 1 生效后，会自动更新为 0。 上海移远通信技术股份有限公司 13 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 2.3.5. CTRL4_C (0x13) 该寄存器（R/W）为控制寄存器 4。 CTRL4_C 寄存器 Bit 7 0 Bit 6 SLEEP_G Bit 5 0 Bit 4 0 Bit 3 0 Bit 2 Bit 1 Bit 0 I2C_disable LPF1_SEL_G 0 表 6：CTRL4_C 参数说明 参数 SLEEP_G I2C_disable LPF1_SEL_G 描述 陀螺仪睡眠模式。 0：禁用 1：启用 启用/禁用 I2C 接口。 0：启用 1：禁用 启用/禁用陀螺仪低通滤波（LPF1）。带宽可以通过在 CTRL6_G 的 FTYPE [2:0]设置。 0：禁用 1：启用 2.3.6. CTRL6_G (0x15) 该寄存器（R/W）为控制寄存器 6。 CTRL6_G 寄存器 Bit 7 0 Bit 6 0 Bit 5 0 Bit 4 0 Bit 3 0 Bit 2 FTYPE_2 Bit 1 Bit 0 FTYPE_1 FTYPE_0 表 7：CTRL6_G 参数说明 参数 FTYPE [2:0] 描述 陀螺仪低通滤波器（LPF1）带宽。 可选择的带宽值，参考表 8：陀螺仪 LPF1 带宽。 上海移远通信技术股份有限公司 14 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 表 8：陀螺仪 LPF1 带宽（单位：Hz） FTYPE [2:0] 12.5 Hz 26 Hz 52 Hz 104 Hz 208 Hz 417 Hz 833 Hz 1.67 kHz 3.33 kHz 6.67 kHz 000 4.3 8.3 16.7 33 67 133 222 274 292 297 001 4.3 8.3 16.7 33 67 128 186 212 220 223 010 4.3 8.3 16.7 33 67 112 140 150 153 154 011 4.3 8.3 16.7 33 67 134 260 390 451 470 100 4.3 8.3 16.7 34 62 86 96 99 - - 101 4.3 8.3 16.9 31 43 48 49 50 - - 110 4.3 8.3 13.4 19 23 24.6 25 25 - - 111 4.3 8.3 9.8 11.6 12.2 12.6 12.6 12.6 - - 2.3.7. 输出寄存器 (0x20~0x2D) 本章介绍模块 IMU 的主要输出寄存器，寄存器 L 表示低位数据，寄存器 H 表示高位数据。无实际物理 意义，需要转换使用。具体转换方式，参考第 4.5 章 数据转换。 2.3.7.1. OUT_TEMP_L (0x20), OUT_TEMP_H (0x21) 温度数据输出寄存器(R)，由寄存器 L 和寄存器 H 组合的二进制补码表示。 OUT_TEMP_L (0x20) Bit 7 Temp7 Bit 6 Temp6 Bit 5 Temp5 Bit 4 Bit 3 Temp4 Temp3 Bit 2 Temp2 Bit 1 Temp1 OUT_TEMP_H (0x21) Bit 15 Temp15 Bit 14 Bit 13 Temp14 Temp13 Bit 12 Bit 11 Temp12 Temp11 Bit 10 Temp10 Bit 9 Temp9 Bit 0 Temp0 Bit 8 Temp8 上海移远通信技术股份有限公司 15 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 2.3.7.2. OUTX_L_G (0x22), OUTX_H_G (0x23) 角速率传感器俯仰轴(X)角速率输出寄存器(R)，由寄存器 L 和寄存器 H 组合的二进制补码表示。 OUTX_L_G (0x22) Bit 7 D7 Bit 6 D6 Bit 5 D5 Bit 4 D4 Bit 3 D3 Bit 2 D2 Bit 1 D1 Bit 0 D0 OUTX_H_G (0x23) Bit 15 D15 Bit 14 D14 Bit 13 D13 Bit 12 D12 Bit 11 D11 Bit 10 D10 Bit 9 D9 Bit 8 D8 2.3.7.3. OUTY_L_G (0x24), OUTY_H_G (0x25) 角速率传感器横滚轴(Y)角速率输出寄存器(R)，由寄存器 L 和寄存器 H 组合的二进制补码表示。 OUTY_L_G (0x24) Bit 7 D7 Bit 6 D6 Bit 5 D5 Bit 4 D4 Bit 3 D3 Bit 2 D2 Bit 1 D1 Bit 0 D0 OUTY_L_G (0x25) Bit 15 D15 Bit 14 D14 Bit 13 D13 Bit 12 D12 Bit 11 D11 Bit 10 D10 Bit 9 D9 Bit 8 D8 2.3.7.4. OUTZ_L_G (0x26), OUTZ_H_G (0x27) 角速率传感器偏航轴(Z)角速率输出寄存器(R)，由寄存器 L 和寄存器 H 组合的二进制补码表示。 OUTZ_L_G (0x26) Bit 7 D7 Bit 6 D6 Bit 5 D5 Bit 4 D4 Bit 3 D3 Bit 2 D2 Bit 1 D1 Bit 0 D0 上海移远通信技术股份有限公司 16 / 34 OUTZ_H_G (0x27) Bit 15 D15 Bit 14 D14 Bit 13 D13 Bit 12 D12 LG69T(AA,AJ) IMU 独立解决方案应用指导 Bit 11 D11 Bit 10 D10 Bit 9 D9 Bit 8 D8 2.3.7.5. OUTX_L_A (0x28), OUTX_H_A (0x29) 线性加速度传感器 X 轴输出寄存器(R)，由寄存器 L 和寄存器 H 组合的二进制补码表示。 OUTX_L_A (0x28) Bit 7 D7 Bit 6 D6 Bit 5 D5 Bit 4 D4 Bit 3 D3 Bit 2 D2 Bit 1 D1 Bit 0 D0 OUTX_H_A (0x29) Bit 15 D15 Bit 14 D14 Bit 13 D13 Bit 12 D12 Bit 11 D11 Bit 10 D10 Bit 9 D9 Bit 8 D8 2.3.7.6. OUTY_L_A (0x2A), OUTY_H_A (0x2B) 线性加速度传感器 Y 轴输出寄存器(R)，由寄存器 L 和寄存器 H 组合的二进制补码表示。 OUTY_L_A (0x2A) Bit 7 D7 Bit 6 D6 Bit 5 D5 Bit 4 D4 Bit 3 D3 Bit 2 D2 Bit 1 D1 Bit 0 D0 OUTY_H_A (0x2B) Bit 15 D15 Bit 14 D14 Bit 13 D13 Bit 12 D12 Bit 11 D11 Bit 10 D10 Bit 9 D9 Bit 8 D8 上海移远通信技术股份有限公司 17 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 2.3.7.7. OUTZ_L_A (0x2C), OUTZ_H_A (0x2D) 线性加速度传感器 Z 轴输出寄存器(R)，由寄存器 L 和寄存器 H 组合的二进制补码表示。 OUTZ_L_A (0x2C) Bit 7 D7 Bit 6 D6 Bit 5 D5 Bit 4 D4 Bit 3 D3 Bit 2 D2 Bit 1 D1 Bit 0 D0 OUTZ_H_A (0x2D) Bit 15 D15 Bit 14 D14 Bit 13 D13 Bit 12 D12 Bit 11 D11 Bit 10 D10 Bit 9 D9 Bit 8 D8 上海移远通信技术股份有限公司 18 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 3 I2C 方式配置模块 IMU 3.1. I2C 总线介绍 3.1.1. 起始信号和停止信号 主机发送起始信号（S）后，总线任务启动。起始信号（S）指 SDA 信号线由高电平到低电平的跳变， 同时 SCL 信号线保持在高电平。在主机通过总线发送停止信号（P）之前，总线被视为一直处于忙碌状态。 停止信号（P）指 SDA 信号线由低电平到高电平的跳变，且 SCL 保持在高电平。此外，如果主机重复产生 起始信号（S），则表示总线一直保持忙碌状态。 SCL SDA S START Signal P STOP Signal 图 2：起始信号和停止信号图 3.1.2. 数据传输及应答 I2C 数据字节定义为 8 位长度。每次传输可以发送的字节数量不受限制，但不能超过 I2C 缓冲区大小。 传输的每个字节后面必须跟随一个应答信号（ACK）。应答信号（ACK）的时钟由主机生成。从机下拉 SDA 信号线，使其在应答时钟脉冲为高电平周期时保持低电平，从而产生实际的应答信号（ACK）。 如果从机处于忙碌状态，需要完成当前处理的任务之后才能发送或接收下一个数据字节，这时可以将 SCL 保持低电平，迫使主机进入等待状态。当从机准备好接收下一个数据字节并释放时钟线，数据传输恢 复正常。 上海移远通信技术股份有限公司 19 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 SCL from Master 1 SDA from Master SDA from Slave S START Signal 2 8 9 Clock Pulse for Acknowledgement Negative Acknowledgement Acknowledgement 图 3：I2C 总线的应答 3.1.3. 通信 通过产生起始信号（S）建立通信后，主机发送一个 7 位的从机地址（0xD4）和一个第 8 位读/写位。 读/写位决定主机接收从机发送的数据还是向从机写入数据，如果该位为 0，则主机向从机写入数据；如果 该位为 1，则主机读取从机的数据。 数据传输以高位（MSB）在前，然后主机释放 SDA 信号线并等待从机发出的应答信号（ACK）。传输 的每个字节后面必须跟随一个应答位。从机拉低 SDA 信号线，使其在 SCL 信号线为高电平周期内保持低 电平，从而产生应答信号（ACK）。 主机通过生成停止信号（P）终止数据传输，从而释放通信线。然而，主机可以生成重复的起始信号（S）， 并可以在未发送停止信号（P）的情况下寻址另一个从机。除起始和停止信号外，SDA 信号线上的电平变 化应发生 SCL 信号线为低电平期间。 SCL 1 - 7 8 9 1 - 7 8 9 1 - 7 8 9 SDA ADDRESS R/W ACK DATA ACK S START Signal 图 4：I2C 数据传输完成 DATA ACK P STOP Signal 上海移远通信技术股份有限公司 20 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 3.1.4. 通信地址 模块 IMU 做为从机的地址为 0xD4 (1101010xb, x=0 (W) or 1 (R))。 3.2. I2C 操作时序图 3.2.1. 写入数据时序 将数据写入 I2C 从机的时序图如下所示。 S T A R T SDA M S B W R DEVICE I ADDRESS T - 0xD4 E ONE BYTE OF WORD SUB ADDRESS LR A A S/ C C BW K K DATA n S T O P N A C K DUMMY WRITE 图 5：写入数据时序图 向模块写入数据前，主机先发送一个开始信号（S），接着发送 I2C 从机地址（0xD4）和一个写入位（W）， 在第 9 个时钟周期（时钟为高电平），从机产生应答信号（ACK）回应主机。然后主机发送从机子地址（寄 存器地址），从机产生应答信号（ACK）回应主机后，主机将数据传输到总线上，每传输 8 位，从机就响应 并产生应答信号（ACK），表明已经收到数据。如果产生一个应答信号（ACK），表示从机已经接收到数据 并准备接受下一字节数据。如果产生一个非应答信号（NACK），表示从机不再接受数据。主机应该通过发 送一个停止信号（P）来终止传输。 上海移远通信技术股份有限公司 21 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 3.2.2. 读取数据时序 从 I2C 从机读取数据的时序图如下所示。 S T A R T SDA M S B W R DEVICE I ADDRESS T - 0xD4 E S T A ONE BYTE OF WORD R ADDRESS - 0x20 T LR A A S/ C C BW K K DEVICE ADDRESS - 0xD4 R E A D A C K DATA n DUMMY WRITE 图 6：读取数据时序图 S T O P N A C K 读取从机数据前，主机先发送一个起始信号（S），接着发送 I2C 从机地址（0xD4）和一个写入位（W）， 从机给出应答信号（ACK）表示已经被主机正确寻址，最后主机发送固定字节（从机的输出寄存器地址）。 接收到从机返回的应答信号（ACK）后，主机再次发送起始信号（S）、从机地址（0xD4）和一个读取位（R）。 之后从机会向主机发送应答信号（ACK）和数据。从机发送 8 位数据之后，如果主机发送应答信号（ACK）， 从机将继续发送 8 位数据，以此往复，实现多字节读取。如主机发送非应答信号（NACK）和一个停止信号 （P），表示通信过程结束。非应答信号（NACK）指 SDA 信号线在第 9 个时钟周期保持高电平 上海移远通信技术股份有限公司 22 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 3.3. 配置流程 模块 IMU 支持通过 I2C 接口传输数据，本章详细介绍了 I2C 的配置流程。 3.3.1. I2C 总线推荐配置 本例程使用型号为 STM32H7 的 MCU 作为主机，STM32H7 在 I2C 总线上的配置操作如下图所示： 开始 配置I2C速率 配置MCU进行7位寻址 关闭广播呼叫模式 关闭时钟拉伸模式 I2C根据以上配置初始化 否 是否成功 是 开启模拟滤波器 配置数字滤波器系数(0x00) 结束 图 7：主机 I2C 初始化配置流程 备注 1. 由于本例程中使用 MCU 作为主机，因此无需要配置从机相关参数。 2. 上述流程仅做参考，具体配置请参考第 4 章 伪代码示例。 上海移远通信技术股份有限公司 23 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 3.3.2. IMU 寄存器推荐配置 本例程使用模块 IMU 作为从机，模块 IMU 的寄存器配置流程如下图所示： 开始 使用WHO_AM_I (0x0F) 确认 IMU型号 配置CTRL1_XL (0x10)三轴加 速度计控制寄存器 配置CTRL2_G (0x11)三轴陀螺 仪控制寄存器 配置CTRL3_C (0x12)控制寄存 器3 配置CTRL4_C (0x13)寄存器4 配置CTRL6_G (0x15)寄存器6 结束 图 8：从机 IMU 配置流程 操作步骤： 步骤 1 使用 WHO_AM_I (0x0F)寄存器判断 IMU 型号，可根据返回值判断 IMU 型号（返回值为 0x6B）， 详情请参考第 2.3.1 章 WHO_AM_I (0x0F)。 步骤 2 配置 CTRL1_XL (0x10)寄存器值为 0x4A，即 ODR_XL 为 104 Hz，FS_XL 为±4g， LPF2_XL_EN 为 1，详情请参考第 2.3.2 章 CTRL1_XL (0x10)。 步骤 3 配置 CTRL2_G (0x11)寄存器值为 0x42，即 ODR_G 为 104 Hz，FS_125 为 125 dps，详情 请参考第 2.3.3 章 CTRL2_G (0x11)。 步骤 4 配置 CTRL3_C (0x12)寄存器值为 0x04，即 IF_INC 为 1，在串行接口（I2C）以寄存器地址 自动递增的形式进行多字节访问，详情请参考第 2.3.4 章 CTRL3_C (0x12)。 上海移远通信技术股份有限公司 24 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 步骤 5 配置 CTRL4_C (0x13)寄存器值为 0x02，即 LPF1_SEL_G 为 1，启用陀螺仪低通滤波（LPF1）， 详情请参考第 2.3.5 章 CTRL4_C (0x13)。 步骤 6 配置 CTRL6_G (0x15)寄存器值为 0x01，即 FTYPE 为 001，对应陀螺仪低通滤波器（LPF1） 带宽，详情请参考第 2.3.6 章 CTRL6_G (0x15)。 备注 1. 建议对配置结果进行校验，可根据读写 IMU 函数的返回值进行判断，详情请参考第 4.3 章 读取 IMU 数据和第 4.4 章 写入 IMU 数据。 2. 由于温度输出寄存器、三轴加速度计输出寄存器和三轴陀螺仪输出寄存器的内存地址是连续的（0x20 到 0x2D），因此输出寄存器无需配置即可一次性读取所有关键数据（如温度，三轴加速度，三轴陀螺 仪数据），详情请参考第 2.3.7 章 输出寄存器 (0x20~0x2D)。 3. 上述流程仅做参考，实际流程及读/写 IMU 数据，详情请参考第 4 章 伪代码示例。 上海移远通信技术股份有限公司 25 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 4 伪代码示例 本章主要展示 I2C 接口和模块 IMU 数据交互过程的伪代码，具体参数解释说明参考 STM32H7 的官方 HAL 库，具体版本为：STM32H7xx HAL Driver version number V1.6.0。 4.1. 初始化 I2C ⚫ 函数 bool Ql_I2C_Open(void) { HI2Cx.Instance = I2Cx; HI2Cx.Init.Timing = 0x00B03FDB; HI2Cx.Init.OwnAddress1 = 0; HI2Cx.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; HI2Cx.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE; HI2Cx.Init.OwnAddress2 = 0; HI2Cx.Init.OwnAddress2Masks = I2C_OA2_NOMASK; HI2Cx.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; HI2Cx.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE; if(HAL_OK != HAL_I2C_Init(&HI2Cx)) { return false; } /* Configure Analogue filter */ if(HAL_OK != HAL_I2CEx_ConfigAnalogFilter(&HI2Cx, I2C_ANALOGFILTER_ENABLE)) { return false; } /* Configure Digital filter */ if(HAL_OK != HAL_I2CEx_ConfigDigitalFilter(&HI2Cx, 0)) { return false; } return true; 上海移远通信技术股份有限公司 26 / 34 } ⚫ 返回值 1 函数执行成功 0 函数执行失败 LG69T(AA,AJ) IMU 独立解决方案应用指导 4.2. 初始化 IMU ⚫ 函数 bool Ql_ACC_GYRO_Init(void) { unsigned char rx_buff[1] = {0}; unsigned char tx_reg_value = 0; Ql_I2C_Open();// I2C needs to be opened before initializing the IMU /* Read the IMU model and determine whether it is a given IMU model */ if(true != Ql_I2C_Read(SLAVE_ADDRESS, WHO_AM_I, &rx_buff[0], 1, 100)) { return false; } if(WHO_AM_I_Value != rx_buff[0]) //0x6B is the return value of WHO_AM_I register { return false; } /* Config CTRL1_XL*/ tx_reg_value = 0x4A; // ODR = 104Hz, FS = +-4g, LPF2_EN if(true != Ql_I2C_Write(SLAVE_ADDRESS, CTRL1_XL, &tx_reg_value, 1, 100)) { return false; } /* Config CTRL2_G */ tx_reg_value = 0x42; // ODR = 104Hz, FS = 125dps if(true != Ql_I2C_Write(SLAVE_ADDRESS, CTRL2_G, &tx_reg_value, 1, 100)) { return false; } /* Config CTRL3_C */ 上海移远通信技术股份有限公司 27 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 tx_reg_value = 0x04; // IF_INC = 1; if(true != Ql_I2C_Write(SLAVE_ADDRESS, CTRL3_C, &tx_reg_value, 1, 100)) { return false; } /* Config CTRL4_C 4*/ tx_reg_value = 0x02; // LPF1_EN if(true != Ql_I2C_Write(SLAVE_ADDRESS, CTRL4_C, &tx_reg_value, 1, 100)) { return false; } /* Config CTRL6_G*/ tx_reg_value = 0x01; // FTYPE=001 if(true != Ql_I2C_Write(SLAVE_ADDRESS, CTRL6_G, &tx_reg_value, 1, 100)) { return false; } return true; } ⚫ 返回值 1 函数执行成功 0 函数执行失败 4.3. 读取 IMU 数据 ⚫ 函数 bool Ql_I2C_Read(uint8_t SLA_Addr, uint8_t Reg, uint8_t *pData, uint32_t Size, uint32_t Timeout) { if(HAL_OK == HAL_I2C_Mem_Read(&HI2Cx, SLA_Addr, Reg, I2C_MEMADD_SIZE_8BIT, pData, Size, Timeout)) { return true; } else { return false; } } 上海移远通信技术股份有限公司 28 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 ⚫ 参数 SLA_Addr： [In] I2C 的从机地址，即 IMU 的地址(0xD4)。 Reg： [In] IMU 的输出寄存器地址，即开始读取数据的地址(0x20)。 pData： [Out] 数据存放的起始地址。 Size： [In] 读取的数据大小，单位：字节。 Timeout： [In] 超时时间，单位：毫秒。 ⚫ 返回值 1 函数执行成功 0 函数执行失败 4.4. 写入 IMU 数据 ⚫ 函数 bool Ql_I2C_Write(uint8_t SLA_Addr, uint8_t Reg, uint8_t *pData, uint32_t Size, uint32_t Timeout) { if(HAL_OK == HAL_I2C_Mem_Write(&HI2Cx, SLA_Addr, Reg, I2C_MEMADD_SIZE_8BIT, pData, Size, Timeout)) { return true; } else { return false; } } ⚫ 参数 SLA_Addr： [In] I2C 的从机地址，即 IMU 的地址(0xD4)。 上海移远通信技术股份有限公司 29 / 34 Reg： [In] IMU 的控制寄存器地址。 pData： [Out] 写入的数据。 Size： [In] 写入数据的大小，单位：字节。 Timeout： [In] 超时时间，单位：毫秒。 ⚫ 返回值 1 函数执行成功 0 函数执行失败 LG69T(AA,AJ) IMU 独立解决方案应用指导 4.5. 数据转换 模块 IMU 的输出寄存器为无实际物理意义，需要对第 2.3.7 章 输出寄存器 (0x20~0x2D)。的数据进行 转换，从而得到可以理解的物理意义，比如数值的大小和单位。 4.5.1. 温度数据转换 ⚫ 函数 double Ql_Senor_Raw_To_Temperature(uint16_t raw_data) { double result = raw_data;// binary raw data if ((raw_data & 0x8000) == 0x8000) { result = (-1.0f) * ((uint16_t)(~raw_data) + 1); } result = result / 256.0f + 25; return result; } ⚫ 参数 raw_data： [In] 温度输出寄存器内的原始二进制补码数据。 上海移远通信技术股份有限公司 30 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 ⚫ 返回值 具有物理意义温度的数据 4.5.2. 加速度计数据转换 ⚫ 函数 double Ql_Senor_Raw_To_ACC(uint16_t raw_data) { double result = raw_data; // binary raw data if ((raw_data & 0x8000) == 0x8000) { result = (-1.0f) * ((uint16_t)(~raw_data) + 1); } return result * 0.122f / 1000.0f;// Please select the corresponding sensitivity according to the //measuring range. } ⚫ 参数 raw_data： [In] 加速度输出寄存器内的原始二进制补码数据。 ⚫ 返回值 具有物理意义三轴加速度的数据 4.5.3. 陀螺仪数据转换 ⚫ 函数 double Ql_Senor_Raw_To_Gyro(uint16_t raw_data) { double result = raw_data; // binary raw data if ((raw_data & 0x8000) == 0x8000) { result = (-1.0f) * ((uint16_t)(~raw_data) + 1); } return result * 4.37f / 1000.0f; // Please select the corresponding sensitivity according to the // measuring range. } 上海移远通信技术股份有限公司 31 / 34 ⚫ 参数 raw_data： [In] 陀螺仪输出寄存器内的原始二进制补码数据。 ⚫ 返回值 具有物理意义陀螺仪的数据 LG69T(AA,AJ) IMU 独立解决方案应用指导 上海移远通信技术股份有限公司 32 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 5 附录 A 参考文档及术语缩写 表 9：参考文档 文档名称 [1] Quectel_LG69T(AA,AD,AF)_Hardware_Design [2] Quectel_LG69T(AI,AJ,AR)_Hardware_Design 表 10：术语缩写 缩写 ACK FS I2C IMU LPF LSB MCU NACK ODR SAD SCL SDA 英文全称 Acknowledgement Full Scale Inter-integrated Circuit Inertial Measurement Unit Low-pass Filter Least Significant Bit Microcontroller Unit Negative Acknowledgement Output Data Rate Slave Address Serial Clock Serial Data 中文全称 应答 满量程 集成电路总线 惯性测量单元 低通滤波 最低有效位 微程序控制器 非应答 输出数据速率 从机地址 串行时钟 串行数据 上海移远通信技术股份有限公司 33 / 34 LG69T(AA,AJ) IMU 独立解决方案应用指导 6 附录 B 特殊符号 表 11：特殊符号 特殊符号 下划线 描述 参数的默认设置 上海移远通信技术股份有限公司 34 / 34

L76 Series&L96 GNSS Raw Measurements Application Note GNSS Module Series Version: 1.0 Date: 2024-01-19 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 1 / 34 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2024. All rights reserved. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 2 / 34 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status L76 Series&L96 GNSS Raw Measurements Application Note GNSS Module Series Application Note Released Revision History Version Date - 2022-07-11 1.0 2024-01-19 Description Creation of the document First official release L76_Series&L96_GNSS_Raw_Measurements_Application_Note 3 / 34 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index .................................................................................................................................................. 5 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 2 Raw Data-Related Message ............................................................................................................... 8 2.1. PQRAW .................................................................................................................................. 8 3 Raw Measurement Messages .......................................................................................................... 10 3.1. PMTKCHL ............................................................................................................................ 10 3.2. PMTKGRP ............................................................................................................................ 12 3.3. PMTKVNED.......................................................................................................................... 13 4 Ephemeris and Almanac Messages ............................................................................................... 15 4.1. PMTK473: GPS Ephemeris Request ................................................................................... 16 4.2. PMTK710: Response to GPS Ephemeris Request ............................................................. 16 4.3. PMTK474: GPS Almanac Request ...................................................................................... 17 4.4. PMTK711: Response to GPS Almanac Request ................................................................. 18 4.5. PMTK477: GLONASS Ephemeris........................................................................................ 19 4.5.1. Poll Request .................................................................................................................. 19 4.5.2. Response ...................................................................................................................... 19 4.6. PMTK478: GLONASS Almanac ........................................................................................... 21 4.6.1. Poll Request .................................................................................................................. 21 4.6.2. Response ...................................................................................................................... 22 4.7. PMTK493: BDS Ephemeris.................................................................................................. 23 4.7.1. Poll Request .................................................................................................................. 23 4.7.2. Response ...................................................................................................................... 24 4.8. PMTK494: BDS Almanac ..................................................................................................... 25 4.8.1. Poll Request .................................................................................................................. 25 4.8.2. Response ...................................................................................................................... 26 4.9. PMTK668: GPS Ephemeris Parameters.............................................................................. 26 4.9.1. Poll Request .................................................................................................................. 26 4.9.2. Response ...................................................................................................................... 27 4.10. PMTK669 BDS: Ephemeris Parameters .............................................................................. 29 4.10.1. Poll Request.................................................................................................................. 29 4.10.2. Response ...................................................................................................................... 29 5 Appendix A References .................................................................................................................... 32 6 Appendix B Special Characters ...................................................................................................... 34 L76_Series&L96_GNSS_Raw_Measurements_Application_Note 4 / 34 GNSS Module Series Table Index Table 1: List of GNSS Raw Measurement Messages................................................................................ 10 Table 2: List of GNSS Ephemeris and Almanac Messages....................................................................... 15 Table 3: Related Documents ...................................................................................................................... 32 Table 4: Terms and Abbreviations .............................................................................................................. 32 Table 5: Special Characters ....................................................................................................................... 34 L76_Series&L96_GNSS_Raw_Measurements_Application_Note 5 / 34 GNSS Module Series Figure Index Figure 1: GLONASS Ephemeris Raw Data ............................................................................................... 20 Figure 2: GLONASS Almanac Raw Data................................................................................................... 22 Figure 3: Bit Allocation for 150 MSBs of Page 1 of Subframe 1 in Format D2.......................................... 24 Figure 4: GEO Satellite Ephemeris Corresponding to Each Page ............................................................ 25 L76_Series&L96_GNSS_Raw_Measurements_Application_Note 6 / 34 GNSS Module Series 1 Introduction This document outlines the constellation raw measurement data and ephemeris/almanac information. The messages mentioned in this document complies to NMEA format. For more information, see document [1] protocol specification. This document is applicable to the following Quectel modules: ⚫ L76 ⚫ L76-L ⚫ L76-LB ⚫ L96 NOTE Quectel assumes no responsibility if commands other than the ones listed herein are used. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 7 / 34 GNSS Module Series 2 Raw Data-Related Message 2.1. PQRAW Enables/disables standard NMEA message or raw data output. Type: Set/Get Synopsis: //Set: $PQRAW,W,,* //Get: $PQRAW,R* Parameter: Field Format Unit Numeric - Numeric - Description Enable/disable standard NMEA message output. 0 = Disable. 1 = Enable. Enable/disable standard raw data output. 0 = Disable. 1 = Enable. Result: ⚫ If successful, the module returns: //Set: $PQRAW,W,OK* //Get: PQRAW,R,,* L76_Series&L96_GNSS_Raw_Measurements_Application_Note 8 / 34 ⚫ If failed, the module returns: $PQRAW,W,ERROR* Example: //Successful setting: $PQRAW,W,0,1*3F $PQRAW,W,OK*16 //Unsuccessful setting: $PQRAW,W,0,2*3C $PQRAW,W,ERROR*4A //Get: $PQRAW,R*3B $PQRAW,R,0,1*3A GNSS Module Series L76_Series&L96_GNSS_Raw_Measurements_Application_Note 9 / 34 GNSS Module Series 3 Raw Measurement Messages The GNSS raw data messages listed in this chapter provide the GPS/GLONASS/Galileo/BDS raw data to external Kalman filters. Table 1: List of GNSS Raw Measurement Messages Message $PMTKCHL $PMTKGRP Type Output Output Description Provides raw measurement information for each channel of GPS, GLONASS, Galileo and BDS constellations. Provides the group message include GPS/receiver time information. $PMTKVNED Output Provides the GPS/receiver velocity information. 3.1. PMTKCHL Provides raw measurement information for each channel of GPS, GLONASS, Galileo and BDS constellations. Type: Output Synopsis: $PMTKCHL,,,,,,,< SNR>,,,,,,,,,,* Parameter: Field Format Numeric Unit Description System ID: 0 = GPS 1 = GLONASS 2 = BDS L76_Series&L96_GNSS_Raw_Measurements_Application_Note 10 / 34 GNSS Module Series Field Format Unit Description 3 = Galileo Numeric - Satellite ID. Numeric Numeric Numeric Numeric Numeric Numeric Meter Raw pseudorange measurements. Cycle Raw carrier phase measurements synchronized to GPS time. If the carrier phase is unlocked, the value will be 0.000. Hz Doppler measurements. dB-Hz Incremented at every cycle slip on this satellite. Range: 0–999. SNR (C/N0). Range: 00–99. Null while not tracking. Meter ECEF coordinate system (X axis) Numeric Meter ECEF coordinate system (Y axis) Numeric Meter Numeric - Hexadecimal - Numeric Meter Numeric - Numeric - ECEF coordinate system (Z axis) GLONASS satellite frequency channel number. This item is only valid for GLONASS. The frequency channel number (K) equals this item minus eight. IODE is for GPS/BDS. tb is for GLONASS, null when system ID is Galileo. ⚫ IODE for GPS: Range: 0x00–0xFF. No IODE: Null ⚫ IODE for BDS: Range: 0x00–0x1F. No IODE: Null Ionosphere correction value. Ionosphere source. 0 = None 1 = Broadcast 2 = SBAS GPS + BDS data synchronization status. 0 = None 1 = Bit synchronization. 2 = Subframe synchronization. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 11 / 34 GNSS Module Series Field Format Numeric Numeric Unit Description 3 = Exact synchronization (Measurement is usable). - Satellite code phase. Pseudorange source. - 0 = From ephemeris 1 = From almanac Example: $PMTKCHL,0,016,23394543.67,4992.633,-176.5,0,39,-25781982.00,1761937.12,6862459.50,00,4B,0.00, 0,3,263.317932,0*20 NOTE Carrier phase raw measurements of Geostationary Earth Orbit (GEO) in BDS system are not supported. In such a case, and will be 0.000 and 999. 3.2. PMTKGRP Provides the group message include GPS/receiver time information. Type: Output Synopsis: $PMTKGRP,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Unit Description Millisecond Second Week Local receiver time tick. Range: 0–4294967295 (2^32-1). GPS time of week. Range: 0.000–00604800.000. GPS Week number. Range: 0–9999. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 12 / 34 GNSS Module Series Field Format Unit Numeric - Numeric Second Numeric Meter Numeric Meter Numeric Meter Numeric - Description Clock status. 0 = No clock 1 = RTC 2 = Synchronized to GPS 3 = From GPS fix The difference between GPS and UTC. Clock bias. Clock offset between GPS clock and GLONASS clock. Clock offset between GPS clock and BDS clock. Time of week (TOW) accuracy. 0 = TOW accuracy exceeds 1 ms. 1 = TOW accuracy is within 1 ms. Example: $PMTKGRP,34995,00408979.000,1776,3,16,-76792,0,56,1*6D 3.3. PMTKVNED Provides the GPS/receiver velocity information. Type: Output Synopsis: $PMTKVNED,,,,,,* Parameter: Field Format Unit Description Local receiver time tick. Numeric Millisecond Range: 0–4294967295 (2^32-1). Numeric m/s North velocity. Numeric m/s East velocity. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 13 / 34 GNSS Module Series Field Format Unit Numeric m/s Numeric m/s Numeric m/s Description Up velocity. Horizontal ground speed. Object speed, including horizontal and vertical speeds. Example: $PMTKVNED,109057,10.00,20.00,0.00,0.00,0.00*0C L76_Series&L96_GNSS_Raw_Measurements_Application_Note 14 / 34 GNSS Module Series 4 Ephemeris and Almanac Messages Table 2: List of GNSS Ephemeris and Almanac Messages Message $PMTK473 $PMTK710 $PMTK474 $PMTK711 $PMTK477 $PMTK478 $PMTK493 $PMTK494 $PMTK668 $PMTK669 Type Description Command Output Command Output Command/Output Command/Output Command/Output Command/Output Command/Output Command/Output Requests the ephemeris data of a single GPS satellite. Response to $PMTK473, returning the requested ephemeris data for the specified GPS satellite. Requests the almanac data of a single GPS satellite. Response to $PMTK474, returning the requested almanac data for the specified GPS satellite. Requests the ephemeris data of a single GLONASS satellite/ Responds to GLONASS ephemeris data request. Requests the almanac data of a single GLONASS satellite/ Responds to GLONASS almanac data request. Requests the ephemeris data of a single BDS satellite/ Responds to BDS ephemeris data request. Requests the almanac data of a single BDS satellite/Responds to BDS almanac data request. Requests the GPS ephemeris data parameters/Responds to GPS ephemeris data parameter request. Requests the BDS ephemeris data parameters/Responds to BDS ephemeris data parameter request. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 15 / 34 GNSS Module Series 4.1. PMTK473: GPS Ephemeris Request Requests the ephemeris data of a single GPS satellite. For response message, see Chapter 4.2 PMTK710: Response to GPS Ephemeris Request. Type: Command Synopsis: $PMTK473,* Parameter: Field Format Unit Numeric - Description GPS satellite ID for ephemeris data. NOTE If the module does not have the ephemeris data of the specified GPS satellite, it will return $PMTK001,473,2*31 to indicate the $PMTK473 message execution failure. Example: $PMTK473,1*2F $PMTK710,01,0D5000,74F54E,9E2E5F,DADC08,6D7E0C,411DE2,00FFA3,D14BBE,41F667,2BCE30, B3BA58,F76904,F35233,0F25A1,0D0F30,1DE27D,FFD19B,E6C751,001C27,EABAAA,1F6F1F,0B6DEA ,FFA906,41015D*1C 4.2. PMTK710: Response to GPS Ephemeris Request Responds to $PMTK473, returning the requested ephemeris data for the specified GPS satellite. It returns the most recently processed GPS ephemeris sub-frame data block, consisting of 8 words from the GPS navigation message sub-frames 1, 2 and 3 (24 words in total) following the HOW (Handover Word). The data excludes the 6 most significant parity bits. For detailed information, see the GPS Interface Control Document (ICD). Type: Output L76_Series&L96_GNSS_Raw_Measurements_Application_Note 16 / 34 GNSS Module Series Synopsis: $PMTK710,,,…,< Data23>* Parameter: Field Format Unit Hexadecimal - … Hexadecimal - Description GPS satellite ID. GPS ephemeris data words. Example: $PMTK473,1*2F $PMTK710,01,0D5000,74F54E,9E2E5F,DADC08,6D7E0C,411DE2,00FFA3,D14BBE,41F667,2BCE30, B3BA58,F76904,F35233,0F25A1,0D0F30,1DE27D,FFD19B,E6C751,001C27,EABAAA,1F6F1F,0B6DEA ,FFA906,41015D*1C 4.3. PMTK474: GPS Almanac Request Requests the almanac data of a single GPS satellite. For response message, see Chapter 4.4 PMTK711: Response to GPS Almanac Request. Type: Command Synopsis: $PMTK474,* Parameter: Field Format Unit Numeric - Description GPS satellite ID for almanac data. NOTE If the module does not have the almanac data of the specific GPS satellite, it will return $PMTK001,474,2*36 to indicate the $PMTK474 message execution failure. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 17 / 34 GNSS Module Series Example: $PMTK474,1*28 $PMTK711,01,0835,414F51,4E1846,FD4E00,A10CA9,9BD650,1F1676,C3F101,D1FFA1*45 4.4. PMTK711: Response to GPS Almanac Request Responds to $PMTK474, returning the requested almanac data for the specified GPS satellite. It returns the most recently processed GPS almanac sub-frame data block, consisting of the almanac reference GPS week, and the 8 words following the HOW (Handover Word) from the GPS navigation message, either pages 1 to 24 of sub-frame 4 or pages 2 to 10 of sub-frame 5. The data excludes the 6 most significant parity bits. For detailed information, see the GPS ICD. Type: Output Synopsis: $PMTK711,,,,…,< Data7>* Parameter: Field Format Hexadecimal Hexadecimal … Hexadecimal Unit Week - Description GPS satellite ID. GPS week number. GPS ephemeris data words. Example: $PMTK474,14*1C $PMTK711,0E,0898,4E0CAF,7B06F8,FD4D00,A10CCC,4E8750,7B0333,C2F828,F3FFFD*4F L76_Series&L96_GNSS_Raw_Measurements_Application_Note 18 / 34 GNSS Module Series 4.5. PMTK477: GLONASS Ephemeris 4.5.1. Poll Request Requests the ephemeris data of a single GLONASS satellite. Type: Command Synopsis: $PMTK477,* Parameter: Field Format Numeric Unit Description GLONASS satellite ID for ephemeris data. Range: 1–24. - Note: is different from GSV/GSA message. If the satellite ID in GSV/GSA messages is used, it should be minus 64. NOTE If the module does not have the ephemeris data of the specified GLONASS satellite, it will return $PMTK001,477,2*35 to indicate the $PMTK477 message execution failure. Example: $PMTK477,20*18 $PMTK477,14,951F898C,3104034D,00000005,11AA4E13,20AAA097,00000015,8260CD08,061FD474, 00000040,02658FD1,59ACA000,00000004,23800068,E0000003,00000063,4F531686,A*74 4.5.2. Response Responds to GLONASS ephemeris data request. It returns the most recently processed GLONASS ephemeris sub-frame data block. Type: Output L76_Series&L96_GNSS_Raw_Measurements_Application_Note 19 / 34 GNSS Module Series Synopsis: $PMTK477,,,…,,,* Parameter: Field Format Description Hexadecimal GLONASS satellite ID. … Hexadecimal Hexadecimal Hexadecimal GLONASS ephemeris data words. GPS time when this ephemeris message is saved. Starting from January 6, 1980. Unit: Second. GLONASS channel number plus 8. The structure of GLONASS ephemeris raw data is illustrated below. For more details, see GLONASS ICD. bit 71 bit 0 String 1 String 2 String 3 String 4 String 5 Figure 1: GLONASS Ephemeris Raw Data Structure Introduction: Each field contains 32-bit data, every 3 fields make up a string. to make up string 1, contains bit 0–31 of string 1, contains bit 32–63 of string 1, contains bit 64–71 of string 1. (The last 8-bit of is valid.) to make up string 2, contains bit 0–31 of string 2, contains bit 32–63 of string 2, contains bit 64–71 of string 2. (The last 8-bit of is valid.) … to make up string 5, contains bit 0–31 of string 5, contains bit 32–63 of string 5, contains bit 64–71 of string 5. (The last 8-bit of is valid.) L76_Series&L96_GNSS_Raw_Measurements_Application_Note 20 / 34 GNSS Module Series Example: $PMTK477,06,06A6C7DD,C411177E,00000006,093985C3,E0897A34,00000016,81153FC2,06347F63, 00000080,02603419,72E06000,0000008B,8380005C,E0000000,0000000C,4BBF053E,4*79 The bit 71–0 of string 1 is 06 C411177E 06A6C7DD. The bit 71–0 of string 2 is 16 E0897A34 093985C3. The bit 71–0 of string 3 is 80 06347F63 81153FC2. The bit 71–0 of string 4 is 8B 72E06000 02603419. The bit 71–0 of string 5 is 0C E0000000 8380005C. 4.6. PMTK478: GLONASS Almanac 4.6.1. Poll Request Requests the almanac data of a single GLONASS satellite. Type: Command Synopsis: $PMTK478,* Parameter: Field Format Numeric Unit Description GLONASS satellite ID for almanac data. Range: 1–24. - Note: is different from GSV/GSA message. If the satellite ID in GSV/GSA messages is used, it should be minus 64. NOTE If the module does not have the almanac data of the specified GLONASS satellite, it will return $PMTK001,478,2*3A to indicate the $PMTK478 message execution failure. Example: $PMTK478,22*15 $PMTK478,16,21F70953,0B3492D8,000000B6,97FB82BA,7300F746,00000007*6A L76_Series&L96_GNSS_Raw_Measurements_Application_Note 21 / 34 GNSS Module Series 4.6.2. Response Responds to GLONASS almanac data request. It returns the most recently processed GLONASS almanac sub-frame data block. Type: Output Synopsis: $PMTK478,,,…,* Parameter: Field Format Unit Hexadecimal - … Hexadecimal - Description GLONASS satellite ID. GLONASS almanac data words. The structure of GLONASS almanac raw data is illustrated below. For more details, see GLONASS ICD. bit 71 bit 0 String 1 String 2 Figure 2: GLONASS Almanac Raw Data Structure Introduction: Each field contains 32-bit data, every 3 fields make up a string. to make up string 1, contains bit 0–31 of string 1, contains bit 32–63 of string 1, contains bit 64–71 of string 1. (The last 8-bit of is valid.) to make up string 2, contains bit 0–31 of string 2, contains bit 32–63 of string 2, contains bit 64–71 of string 2. (The last 8-bit of is valid.) Example: $PMTK478,16,21F70953,0B3492D8,000000B6,97FB82BA,7300F746,00000007*6A The bit 71–0 of string 1 is B6 0B3492D8 21F70953. The bit 71–0 of string 2 is 07 7300F746 97FB82BA. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 22 / 34 GNSS Module Series 4.7. PMTK493: BDS Ephemeris 4.7.1. Poll Request Requests the ephemeris data of a single BDS satellite. Type: Command Synopsis: $PMTK493,* Parameter: Field Format Unit Numeric - Description BDS satellite ID for ephemeris data. NOTE If the module does not have the ephemeris data of the specified BDS satellite, it will return $PMTK001,493,2*3F to indicate the $PMTK493 message execution failure. Example: $PMTK493,2*22 $PMTK493,02,3BD20500,907702C4,15,4EDB2107,817FBA46,55,00000000,17BDDB00,D5,00804BE4 ,6B428B56,55,D0F906E4,001C28FF,55,2B2B57CA,FFC34BAE,55,477900F3,117A8078,55,90876103, 5FFF8542,95,9A11F056,F55447FC,55,AA0A3DB0,AAAAAAAA,AA*65 $PMTK493,6*26 $PMTK493,06,B44740E2,48174008,FB5018F6,D2370702,609F3011,2C001141,05A60188,B48740E2, FDAF4A20,3B4A311E,7AC50469,7E2915CA,43EBCFCF,0011A72B,B4C740E2,3431EC39,FCD78D4A ,E0D1FFD3,BB7F0201,D192C3E7,4616B84B*47 L76_Series&L96_GNSS_Raw_Measurements_Application_Note 23 / 34 GNSS Module Series 4.7.2. Response Responds to BDS ephemeris data request. It returns the most recently processed BDS ephemeris sub-frame data block. For MEO/IGSO satellites, the data consists of 7 words from the BDS navigation message sub-frames 1, 2 and 3 (21 words in total). For GEO satellites, the data is extracted from pages 1–10 of sub-frame 1 following the Pnum1 (see Figure 3: Bit Allocation for 150 MSBs of Page 1 of Subframe 1 in Format D2 for details). All parity-bits from the navigation message have been removed. Type: Output Synopsis: //MEO/IGSO satellites $PMTK493,,,…,* //GEO satellites $PMTK493,,,,,…,,,* Parameter: Field Format Unit <SatID Hexadecimal - … Hexadecimal - Hexadecimal - Hexadecimal - Hexadecimal - Description BDS satellite ID. BDS ephemeris data words. The first 32 bits of page N data. The second 32 bits of page N data. The third 8 bits of page N data. For details on the structure of BDS ephemeris raw data for MEO/IGSO satellites and GEO Satellites, see BDS ICD. Below is a brief illustration on the data structure for GEO satellites: Figure 3: Bit Allocation for 150 MSBs of Page 1 of Subframe 1 in Format D2 L76_Series&L96_GNSS_Raw_Measurements_Application_Note 24 / 34 GNSS Module Series Page1 Page2 Page10 $PMTK493,02,3BD20500,907702C4,15,4EDB2107,817FBA46,55, ,AA0A3DB0,AAAAAAAA,AA*65 Figure 4: GEO Satellite Ephemeris Corresponding to Each Page 4.8. PMTK494: BDS Almanac 4.8.1. Poll Request Requests the almanac data of a single BDS satellite. Type: Command Synopsis: $PMTK494,* Parameter: Field Format Numeric Description BDS satellite ID for almanac data. NOTE If the module does not have the almanac data of the specified BDS satellite, it will return $PMTK001,494,2*38 to indicate the $PMTK494 message execution failure. Example: $PMTK494,2*25 $PMTK494,02,02E8,B10741E2,AD2B0B80,EB9BFC6B,1A409522,9823A008,B3E1FE00,E1A822ED*65 $PMTK494,6*21 $PMTK494,06,02E8,B24741E2,A52BABAC,FF8F0000,62E2F88C,9FCB1138,8D9722FD,CDA2B5FC* 61 L76_Series&L96_GNSS_Raw_Measurements_Application_Note 25 / 34 GNSS Module Series 4.8.2. Response Responds to BDS almanac data request. It returns the most recently processed BDS almanac sub-frame data block, namely, the almanac reference BDS week, followed by the 7 words from the BDS navigation message broadcasted on pages 1 to 24 of sub-frame 4 and pages 1 to 6 of sub-frame 5 for MEO/IGSO satellites and broadcasted on pages 35 to 36 of sub-frame 5 for GEO satellites. All parity bits have been removed. Type: Output Synopsis: $PMTK494,,,,…,* Parameter: Field Format Description Hexadecimal BDS satellite ID. Hexadecimal BDS week number. … Hexadecimal BDS almanac data words. NOTE For details on the structure of BDS almanac raw data for MEO/IGSO satellites and GEO Satellites, see BDS ICD. 4.9. PMTK668: GPS Ephemeris Parameters 4.9.1. Poll Request Requests the GPS ephemeris data parameters. Type: Command Synopsis: $PMTK668,* L76_Series&L96_GNSS_Raw_Measurements_Application_Note 26 / 34 Parameter: Field Format Numeric Description GPS satellite ID. GNSS Module Series NOTE If the module does not have the parameters of the specified GPS satellite, it will return $PMTK668,,0*. Example: $PMTK668,1*27 $PMTK668,1,1077,0,87,65,7650,0,-93,-765201,65,-2457,11214,817085016,-2199,83055155,3877,2701 987632,7650,-47,-1679374511,28,669694634,8047,520842730,-22266,12,0*08 4.9.2. Response Responds to GPS ephemeris data parameter request. It returns the GPS ephemeris data parameters. Type: Output Synopsis: $PMTK668,,,,,,,,,,,,,,,,,< √A >,,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit Week 2-43 π/sec 24 sec Description GPS satellite ID. GPS week number. User range accuracy index. Rate of Inclination Angle. Issue of data, ephemeris. Time of clock. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 27 / 34 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Unit 2-55 sec/sec2 2-43 sec/sec 2-31 sec - Numeric Numeric Numeric Numeric Numeric 2-5 meter 2-43 π/sec 2-31 π 2-29 rad 2-33 Numeric Numeric Numeric Numeric 2-29 rad 2-19 meter1/2 24 sec 2-29 rad Numeric 2-31 π Numeric Numeric Numeric Numeric Numeric Numeric Numeric 2-29 rad 2-31 π 2-5 meter 2-31 π 2-43 π/sec 2-31 sec - Description Drift Rate Correction Coefficient. Space Vehicle (SV) Clock Drift Correction Coefficient. SV Clock Bias Correction Coefficient. Issue of Data, Clock. Amplitude of the Sine Harmonic Correction Term to the Orbit Radius. Mean Motion Difference from Computed Value. Mean Anomaly at Reference Time. Amplitude of Cosine Harmonic Correction Term to the Argument of Latitude. Eccentricity. Amplitude of Sine Harmonic Correction Term to the Argument of Latitude. Square Root of the Semi-Major Axis. Time of Ephemeris. Amplitude of the Cosine Harmonic Correction Term to the Angle of Inclination. Longitude of Ascending Node of Orbit Plane at Weekly Epoch. Amplitude of the Sine Harmonic Correction Term to the Angle of Inclination. Inclination angle at reference time. Amplitude of the Cosine Harmonic Correction Term to the Orbit Radius. Argument of Perigee. Rate of right ascension. Group Delay Differential. SV health status. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 28 / 34 4.10. PMTK669 BDS: Ephemeris Parameters 4.10.1. Poll Request Requests the BDS ephemeris data parameters. Type: Command Synopsis: $PMTK669,* Parameter: Field Format Numeric Description BDS satellite ID. GNSS Module Series NOTE If the module does not have the parameters of the specified BDS satellite, it will return $PMTK669,,0*. Example: $PMTK669,1*26 $PMTK669,1,1077,0,-816,2,16200,0,40730,-5227056,0,-15255,21444,-564748513,-17301,4677831,-5582, 3404452729,16200,369,172423346,155,60460899,5163,-13124251,-18181,-5,0*01 4.10.2. Response Responds to BDS ephemeris data parameter request. It returns the BDS ephemeris data parameters. Type: Output Synopsis: $PMTK669,,,,,,,,,,,,,, ,,,,,,,,,,,,,* L76_Series&L96_GNSS_Raw_Measurements_Application_Note 29 / 34 Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric GNSS Module Series Unit - Week 2-43 π/sec 23 sec 2-66 sec/sec2 2-50 sec/sec 2-33 sec 2-6 meter 2-43 π/sec 2-31 π 2-31 rad 2-33 2-31 rad 2-19 meter1/2 23 sec 2-31 rad 2-31 π 2-31 rad Description BDS satellite ID. GPS week number. Note: is the GPS week number in both $PMTK668 and $PMTK669 output messages. User range accuracy index Rate of inclination angle. Issue of data, ephemeris. Time of clock. Drift Rate Correction Coefficient. Space Vehicle (SV) Clock Drift Correction Coefficient. SV Clock Bias Correction Coefficient. Issue of Data, Clock. Amplitude of the Sine Harmonic Correction Term to the Orbit Radius. Mean Motion Difference from Computed Value. Mean Anomaly at Reference Time. Amplitude of Cosine Harmonic Correction Term to the Argument of Latitude. Eccentricity. Amplitude of Sine Harmonic Correction Term to the Argument of Latitude. Square Root of the Semi-Major Axis. Time of Ephemeris. Amplitude of the Cosine Harmonic Correction Term to the Angle of Inclination. Longitude of ascending node of orbital of plane computed according to reference time. Amplitude of the Sine Harmonic Correction Term to the Angle of Inclination. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 30 / 34 Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit 2-31 π 2-6 meter 2-31 π 2-43 π/sec 0.1ns - GNSS Module Series Description Inclination angle at reference time. Amplitude of the Cosine Harmonic Correction Term to the Orbit Radius. Argument of Perigee. Rate of right ascension. Group Delay Differential. SV health status. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 31 / 34 GNSS Module Series 5 Appendix A References Table 3: Related Documents Document Name [1] Quectel_Lx0&Lx6&LC86L&LG77L_GNSS_Protocol_Specification Table 4: Terms and Abbreviations Abbreviation Description ECEF Earth-Centered, Earth-Fixed GEO Geostationary Earth Orbit GLONASS Global Satellite Navigation System (Russian) GNSS Global Navigation Satellite System GPS Global Positioning System HOW Hand-Over Word ICD Interface Control Document IGSO Inclined Geosynchronous Orbit IODE Issue of Data (Ephemeris) MEO Medium Earth Orbit NMEA National Marine Electronics Association PRN Pseudo Random Noise RTC Real Time Clock SBAS Satellite-Based Augmentation System SNR Signal-to-Noise Ratio L76_Series&L96_GNSS_Raw_Measurements_Application_Note 32 / 34 Abbreviation SV TOW UTC Description Space Vehicle Time of Week Coordinated Universal Time GNSS Module Series L76_Series&L96_GNSS_Raw_Measurements_Application_Note 33 / 34 GNSS Module Series 6 Appendix B Special Characters Table 5: Special Characters Special Character [...] {…} Underline Definition Carriage return character. Line feed character. Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. L76_Series&L96_GNSS_Raw_Measurements_Application_Note 34 / 34

LTE Standard(U)系列 SMTP 应用指导 LTE Standard 模块系列 版本：1.0 日期：2023-12-25 状态：受控文件 LTE Standard(U)系列 SMTP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 32 LTE Standard(U)系列 SMTP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 32 LTE Standard(U)系列 SMTP 应用指导 文档历史 修订记录 版本 1.0 日期 2022-11-29 2023-12-25 作者 Kruskal ZHU Kruskal ZHU 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 32 LTE Standard(U)系列 SMTP 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 1.2. SSL 类型介绍 ............................................................................................................................. 7 1.3. 发送邮件的流程 .......................................................................................................................... 7 1.4. 数据模式说明.............................................................................................................................. 8 2 AT 命令详解 .......................................................................................................................................... 9 2.1. AT 命令说明 ............................................................................................................................... 9 2.1.1 定义 ................................................................................................................................. 9 2.1.2 AT 命令语句 .................................................................................................................... 9 2.2. AT 示例声明 ............................................................................................................................. 10 2.3. SMTP AT 命令详解 .................................................................................................................. 10 2.3.1 AT+QSMTPCFG 配置 SMTP 服务器参数 .................................................................. 10 2.3.2 AT+QSMTPDST 添加或删除收件人........................................................................... 13 2.3.3 AT+QSMTPSUB 编辑邮件主题.................................................................................. 14 2.3.4 AT+QSMTPBODY 编辑邮件正文 ............................................................................... 15 2.3.5 AT+QSMTPATT 添加或删除邮件附件........................................................................ 17 2.3.6 AT+QSMTPCLR 清除邮件内容 .................................................................................. 19 2.3.7 AT+QSMTPPUT 发送邮件 ......................................................................................... 20 3 示例 ..................................................................................................................................................... 21 3.1. 发送无 SSL 邮件....................................................................................................................... 21 3.2. 发送 SSL 邮件 .......................................................................................................................... 23 3.3. 发送 STARTTLS 邮件 .............................................................................................................. 23 4 错误处理 .............................................................................................................................................. 25 4.1. 执行 SMTP AT 命令失败 .......................................................................................................... 25 4.2. PDP 激活失败........................................................................................................................... 25 4.3. DNS 解析失败 .......................................................................................................................... 25 4.4. AT+QSMTPPUT 错误响应 ....................................................................................................... 25 5 错误码 ................................................................................................................................................. 27 6 SMTP 协议错误代码 ........................................................................................................................... 29 7 附录 参考文档和术语缩写 .................................................................................................................. 31 上海移远通信技术股份有限公司 4 / 32 LTE Standard(U)系列 SMTP 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 9 表 3：错误码汇总 ....................................................................................................................................... 27 表 4：SMTP 协议错误码汇总 ..................................................................................................................... 29 表 5：参考文档 ........................................................................................................................................... 31 表 6：术语缩写 ........................................................................................................................................... 31 上海移远通信技术股份有限公司 5 / 32 LTE Standard(U)系列 SMTP 应用指导 1 引言 移远通信 LTE Standard(U)系列模块提供 SMTP 接口，可用于从客户开发的应用程序发送电子邮件。 该文档为 SMTP 定义的所有 AT 命令的参考指导。 1.1. 适用模块 表 1：适用模块 模块系列 - ECx00G ECx00U EGx00U EG91xU 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG800G 系列 EG912U-GL EG915U 系列 备注 1. SMTP 功能对于 EC200U-CN、EC600G-CN 和 EC800G-CN 模块可选，详情请联系移远通信技术 支持。 2. 本文档不适用于 EG700G-CN 模块。 上海移远通信技术股份有限公司 6 / 32 LTE Standard(U)系列 SMTP 应用指导 1.2. SSL 类型介绍 SMTP 客户端与 SMTP 服务器之间共有三种连接方式： ⚫ 无 SSL ⚫ SSL ⚫ STARTTLS 一些 SMTP 服务器不支持无 SSL 连接方式，而一些 SMTP 服务器则支持以上三种连接方式。可根据 邮件服务商选择连接方式。 以上三种连接方式可以通过设置 AT+QSMTPCFG='ssltype'中的进行修改。 1. 若为 0，表示'无 SSL'连接方式。在此情况下，SSL 功能无法使用，邮件在非安全 连接情况下发送。SMTP 服务器端口取决于邮件服务商，通常为端口 25。 2. 若为 1，表示'SSL'连接方式。在此情况下，邮件通过 SSL/TLS 加密的 SMTP 的 方式进行发送。SMTP 服务器端口取决于邮件服务商，通常为端口 465 或 587。 3. 若为 2，表示'STARTTLS'连接方式。在此情况下，可以通过 STARTTLS 功能将 常规的不安全连接升级为安全连接，从而发送邮件。SMTP 服务器端口取决于邮件服务商，通常为 端口 25、465 或 587。 1.3. 发送邮件的流程 LTE Standard (U)系列模块支持 SMTP，因此用户可以通过模块 SMTP AT 命令发送邮件。大致流程如 下： 步骤 1：配置并激活 PDP 上下文。 1) 通过 AT+QICSGP 配置 PDP 上下文的、、及其他相关参数。详 情请参考文档 [1]。 若 QoS 设置需要更新，可通过 AT+CGQMIN、AT+CGEQMIN、AT+CGQREQ 和 AT+CGEQREQ 进行配置。详情请参考文档 [2]。 2) 通过 AT+QIACT 激活 PDP 上下文。 3) 通过 AT+QSMTPCFG='contextid',配置 SMTP 的 PDP 上下文 ID。 步骤 2：配置 SMTP 服务器与用户账户。 1) 通 过 AT+QSMTPCFG='ssltype', 配 置 SSL 类 型 。 若 为 SSL 或 STARTTLS ， 可 通 过 AT+QSMTPCFG='sslctxid', 选 择 SSL 上 下 文 ， 并 通 过 AT+QSSLCFG='ciphersuite',,配置 。 详 情请 参考 文档 [3]。 2) 通过 AT+QSMTPCFG='smtpserver',,配置 SMTP 服务器。和 取决于邮件服务商。 上海移远通信技术股份有限公司 7 / 32 LTE Standard(U)系列 SMTP 应用指导 3) 通过 AT+QSMTPCFG='account',,配置用户名和密码。 4) 通过 AT+QSMTPCFG='sender',,配置发件人姓名和邮箱地址。 步骤 3：编辑邮件内容。 1) 通过 AT+QSMTPDST 配置收件人。 2) 通过 AT+QSMTPSUB 配置邮件主题。 3) 通过 AT+QSMTPBODY 配置邮件正文。 4) 通过 AT+QSMTPATT 添加附件。附件可以为 UFS 或 SD 文件，且文件可以通过 AT+QFUPL 上 传至 UFS 或 SD 卡。邮件发送成功后，可以通过 AT+QFDEL 删除文件。详情可参考文档 [4]。 步骤 4：发送邮件。 通过 AT+QSMTPPUT 发送邮件。发送邮件所需时间取决于附件大小和网络状态。当发送动作结束后， 将会上报+QSMTPPUT: ,。 步骤 5：清除邮件内容。 用户可以通过执行 AT+QSMTPCLR 清除步骤 3 配置的邮件内容，通过执行 AT+QFDEL 删除附件。 有关 AT 命令的详细请，请参考文档 [4]。然后重复步骤 3 和步骤 4。若用户需要修改 SMTP 服务器和用户 信息，需重复如上步骤 2 至步骤 4。 若邮件长时间（例如 30 分钟或更长时间）未成功发送，用户可以通过执行 AT+QIDEACT= 去激活 PDP 上下文。详情请参考文档 [1]。 1.4. 数据模式说明 LTE Standard (U)系列模块的 COM 端口有两种工作模式：AT 命令模式、数据模式。AT 命令模式下， 通过 COM 端口输入的数据会被当成 AT 命令；而在数据模式下，则输入的数据即被当成数据。 ⚫ 退出数据模式 输入+++或上拉 DTR（需先执行 AT&D1）可以使模块退出数据模式。为防止模块将+++误认为数据， 必须遵循以下几点： 1) 输入+++之前，请勿在 1 秒或更长时间内输入任何数据。 2) 必须在 1 秒内输入+++，且不可输入其他数据。 3) 输入+++后的 1 秒内不可输入任何数据。 ⚫ 进入数据模式 执行 AT+QSMTPBODY 时，COM 端口将进入数据模式，此时，所有输入的数据将成为邮件的正文。 若输入的数据长度达到或时长达到，端口将自动退出数据模式。若输入的数 据长度小于，在达到时长之前，通过输入+++或拉高 DTR 电平以完成正文编 辑。在这种情况下，COM 端口无法通过执行 ATO 重新进入数据模式。 上海移远通信技术股份有限公司 8 / 32 LTE Standard(U)系列 SMTP 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2 AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 32 LTE Standard(U)系列 SMTP 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. SMTP AT 命令详解 2.3.1 AT+QSMTPCFG 配置 SMTP 服务器参数 该命令用于配置 SMTP 服务器参数。 AT+QSMTPCFG 配置 SMTP 服务器参数 测试命令 AT+QSMTPCFG=? 响应 +QSMTPCFG: 'account',, +QSMTPCFG: 'sender',, +QSMTPCFG: 'smtpserver',, +QSMTPCFG: 'contextid',(支持的范围) +QSMTPCFG: 'sslctxid',(支持的范围) +QSMTPCFG: 'ssltype',(支持的范围) +QSMTPCFG: 'bodyoriginal',(支持的列表) +QSMTPCFG: 'addrseparator',(支持的 列表) 设置命令 AT+QSMTPCFG='account'[,,] OK 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'account',, OK 设置命令 AT+QSMTPCFG='sender'[,,] 若指定可选参数，则设置用户账号： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'sender',, OK 上海移远通信技术股份有限公司 10 / 32 LTE Standard(U)系列 SMTP 应用指导 设置命令 AT+QSMTPCFG='smtpserver'[,,] 若指定可选参数，则设置发件人信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'smtpserver',, OK 设置命令 AT+QSMTPCFG='contextid'[,] 若指定可选参数，则设置 SMTP 服务器： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'contextid', OK 设置命令 AT+QSMTPCFG='sslctxid'[,] 若指定可选参数，则设置 PDP 上下文： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'sslctxid', OK 设置命令 AT+QSMTPCFG='ssltype'[,] 若指定可选参数，则设置 SSL 上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'ssltype', OK 若指定可选参数，则设置 SSL 类型： OK 或者 上海移远通信技术股份有限公司 11 / 32 LTE Standard(U)系列 SMTP 应用指导 +CME ERROR: 设置命令 AT+QSMTPCFG='bodyoriginal'[,] 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'bodyoriginal', OK 设置命令 AT+QSMTPCFG='addrseparator'[,< addr_separator>] 若指定可选参数，则设置是否使能发送无字符集的 SMTP 正 文： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'addrseparator', 最大响应时间 特性说明 OK 若指定可选参数，则设置多目标邮箱地址的分隔符类型： OK 或者 +CME ERROR: 300 毫秒 该命令立即生效； 不保存参数配置。 参数 字符串类型。身份验证用户名。最大长度为 50 字节。 字符串类型。身份验证密码。最大长度为 50 字节。 字符串类型。发件人的邮箱地址。最大长度为 50 字节。 字符串类型。发件人姓名。最大长度为 50 字节。 字符串类型。SMTP 服务器的 IP 地址或域名。最大长度为 50 字节。 整型。SMTP 服务器端口。范围：1~65535。默认值：25。端口号可能会根据 SMTP 服务器的不同而变化。详细信息请咨询对应的邮件服务商。 整型。PDP 上下文 ID。ECx00G、ECx00U、EGx00U、EG800G 系列和 EG91xU 系 列模块取值范围为 1~7；EC200D 系列模块取值范围为 1~11。默认值：1。请在发送邮件前通过执行 AT+QIACT 激活 PDP 上下文 ID。详情 请参考文档 [1]。 整型。用于 SMTP 的 SSL 上下文 ID。范围：0~5。默认值：1。请通过 AT+QSSLCFG 配置 SSL 上下文参数。详情请参考文档 [3]。 上海移远通信技术股份有限公司 12 / 32 LTE Standard(U)系列 SMTP 应用指导 整型。SSL 类型。因为有些 SMTP 服务器不支持无 SSL 状态下发送邮件，请根据邮 件服务商选择 SSL 类型。 0 无 SSL 1 SSL 2 STARTTLS 整型。是否使能发送无字符集的 SMTP 正文。 0 禁用发送无字符集的 SMTP 正文 1 使能发送无字符集的 SMTP 正文且发送原始 SMTP 正文 整型。设置多目标邮箱地址的分隔符类型。 0 使用','进行分隔 1 使用';'进行分隔 错误码。详情请参考第 5 章。 2.3.2 AT+QSMTPDST 添加或删除收件人 该命令用于添加或删除收件人。收件人最大数量为 20，其中数量包括抄送及密件抄送收件人。 AT+QSMTPDST 添加或删除收件人 测试命令 AT+QSMTPDST=? 响应 +QSMTPDST: ( 支 持 的 mode> 列 表 ),( 支 持 的 范 围), 查询命令 AT+QSMTPDST? OK 响应 [+QSMTPDST: ,] [...] OK 设置命令 AT+QSMTPDST=[,[,]] 响应 格式正确且未发送邮件： OK 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 不保存参数配置。 参数 整型。添加或者删除收件人。 0 删除。 上海移远通信技术股份有限公司 13 / 32 LTE Standard(U)系列 SMTP 应用指导 1 添加。此时，需指定和。 整型。收件人类型。 1 所有收件人 2 抄送收件人 3 密件抄送收件人 字符串类型。收件人的邮箱地址。最大长度为 50 字节。 错误码。详情请参考第 5 章。 举例 //添加收件人 AT+QSMTPDST=1,1,'quectel_test@aol.com' OK AT+QSMTPDST=1,2,'quectel_test@21cn.com' OK AT+QSMTPDST? +QSMTPDST: 1,'quectel_test@aol.com' +QSMTPDST: 2,'quectel_test@21cn.com' OK //删除所有收件人。 AT+QSMTPDST=0 OK AT+QSMTPDST? OK //添加所有收件人。 //添加抄送收件人。 //删除所有收件人。 2.3.3 AT+QSMTPSUB 编辑邮件主题 该命令用于编辑邮件主题。如果不是 ASCII，输入的数据应为原始主题的十六进制字符串。 AT+QSMTPSUB 编辑邮件主题 测试命令 AT+QSMTPSUB=? 响应 +QSMTPSUB: (支持的范围), 查询命令 AT+QSMTPSUB? OK 响应 +QSMTPSUB: , 设置命令 AT+QSMTPSUB=, OK 响应 OK 或者 上海移远通信技术股份有限公司 14 / 32 LTE Standard(U)系列 SMTP 应用指导 最大响应时间 特性说明 +CME ERROR: 300 毫秒 / 参数 整型。主题的字符集。 0 ASCII 1 UTF-8 2 GB2312 3 BIG5 字符串类型。邮件主题。若为 0，该字符串为邮件的主题；若不为 0，该参数将转化为十六进制字符串格式，例如，'41'表示十六进制中的'0x41'。 若字符集为 ASCII，的长度为 0~100 字符。若字符集不是 ASCII， 的长度为偶数，最大长度为 200 字符。 错误码。详情请参考第 5 章。 举例 //添加邮件的主题，且为 ASCII。 AT+QSMTPSUB=0,'TEST SMTP' OK AT+QSMTPSUB? +QSMTPSUB: 0,'TEST SMTP' //编辑主题且字符集为 ASCII。 //查询邮件主题。 OK //添加邮件的主题且为 UTF-8。'7465737420534D5450'为'TEST SMTP'的十六进制字符串。 AT+QSMTPSUB=1,'7465737420534D5450' //编辑主题且字符集为 UTF-8。 OK AT+QSMTPSUB? //查询邮件主题。 +QSMTPSUB: 1,'7465737420534D5450' OK 2.3.4 AT+QSMTPBODY 编辑邮件正文 该命令用于编辑邮件正文。执行 AT+QSMTPBODY=,[,]时， 模块将进入数据模式。此时输入的所有数据均为邮件正文。若输入的数据长度达到或时长 达到 ，模块将 自动退出数据 模式。 若 输入的数据长 度小于 ， 请在到 达 之前，通过输入+++或拉高 DTR 电平以完成正文编辑。邮件正文的最大长度为 10 千字节。 正文实际长度为输入的数据长度。 上海移远通信技术股份有限公司 15 / 32 LTE Standard(U)系列 SMTP 应用指导 AT+QSMTPBODY 编辑邮件正文 测试命令 AT+QSMTPBODY=? 响应 +QSMTPBODY: (支持的范围),(支持的范围),(支持的范围) OK 查询命令 响应 AT+QSMTPBODY? OK 设置命令 AT+QSMTPBODY=,[,] 响应 格式正确且未发送邮件，模块将进入数据模式： CONNECT +QSMTPBODY: OK 最大响应时间 特性说明 若出现任何错误： +CME ERROR: 取决于 / 参数 整型。主题的字符集。 0 ASCII 1 UTF-8 2 GB2312 3 BIG5 整型。指定的正文长度。若输入数据的长度小于指定值，请执行+++退 出数据模式。邮件正文的实际长度为输入的数据长度。范围：1~10240。单位：字节。 整型。输入正文的实际长度。单位：字节。 整型。从 COM 端口上传邮件正文的最大时间。范围：1~65535。默认值：90。单位： 秒。 错误码。详情请参考第 5 章。 举例 //编辑邮件正文，正文长度为100字节。 AT+QSMTPBODY=0,100,120 //编辑邮件正文。主题字符集为 ASCII。最大输入长度为 100 字 节，且从 COM 端口上传邮件正文的最大时间为 120 秒。 上海移远通信技术股份有限公司 16 / 32 LTE Standard(U)系列 SMTP 应用指导 CONNECT +QSMTPBODY: 100 //输入100字符的数据。 OK //若实际输入长度小于指定长度，请输入+++可以完成正文编辑。 AT+QSMTPBODY=0,100,120 //编辑邮件正文。主题字符集为 ASCII。最大输入长度为 100 字 节，且最大输入时间为 120 秒。 CONNECT //输入+++。 +QSMTPBODY: 90 OK //若实际输入长度小于指定长度，且超过了最大输入时间，模块将会自动停止输入正文。 AT+QSMTPBODY=0,100,120 //编辑邮件正文。主题字符集为ASCII。最大输入长度为100字节， 且最大输入时间为120秒。 CONNECT //120秒后。 +QSMTPBODY: 90 OK 2.3.5 AT+QSMTPATT 添加或删除邮件附件 通过 AT+QSMTPATT=1 可以添加邮件附件。添加附件时，应指定邮件索引。不同附件的文件索引各 不相同。附件的最大数量为 10。 附件可为 UFS 或 SD 文件。用户可以通过 AT+QFUPL 将文件上传至 UFS 或 SD 卡。邮件成功发送 后，UFS 或 SD 卡内的文件可通过 AT+QFDEL 删除。有关 AT 命令的详情，请参考文档 [4]。邮件服务商 可能会对单个文件的大小及文件的总大小有一定限制。 AT+QSMTPATT=0 用于删除所有附件。 AT+QSMTPATT 添加或删除邮件附件 测试命令 AT+QSMTPATT=? 响应 +QSMTPATT: (支持的列表),(支持的范 围), 查询命令 AT+QSMTPATT? OK 响应 [+QSMTPATT: ,,] 上海移远通信技术股份有限公司 17 / 32 LTE Standard(U)系列 SMTP 应用指导 [...] 设置命令 AT+QSMTPATT=[,[,]] 最大响应时间 特性说明 OK 响应 OK 或者 +CME ERROR: 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。添加或删除附件。 0 删除。 1 添加。此时，需指定和。 整型。附件索引。范围：1~10。 字符串类型。待添加的附件的文件名称。最大长度为 50 字节。 整型。附件大小。单位：字节。 错误码。详情请参考第 5 章。 举例 //请从 UFS 添加附件。邮件发出后，上传至 UFS 的文件可以通过 AT+QFDEL 删除。详细示例如下： AT+QFUPL='test.txt',200,300,1 //将文件上传至 UFS。文件被另存为'test.txt'，文件最大长 度为 200 字节。300 表示超时时间（单位：秒），1 表示 ACK 模式。详细信息可参考文档 [4]。 CONNECT +QFUPL: 200,707 OK AT+QFLST='*' +QFLST: 'test.txt',200 OK AT+QSMTPATT=1,1,'test.txt' OK AT+QSMTPATT? +QSMTPATT: 1,'test.txt',200 //添加邮件附件，附件文件索引为 1。 //查询附件。 OK 上海移远通信技术股份有限公司 18 / 32 //删除所有附件。 AT+QSMTPATT=0 OK AT+QSMTPATT? OK LTE Standard(U)系列 SMTP 应用指导 //删除邮件所有的附件。 //查询附件。 2.3.6 AT+QSMTPCLR 清除邮件内容 该命令用于清除所有 AT+QSMTPDST、AT+QSMTPSUB、AT+QSMTPBODY 和 AT+QSMTPATT 的 配置。 AT+QSMTPCLR 清除邮件内容 测试命令 AT+QSMTPCLR=? 执行命令 AT+QSMTPCLR 最大响应时间 特性说明 响应 OK 响应 OK 或者 +CME ERROR: 300 毫秒 / 参数 错误码。详情请参考第 5 章。 举例 AT+QSMTPCLR OK AT+QSMTPDST? OK AT+QSMTPSUB? +QSMTPSUB: 0,'' OK AT+QSMTPATT? OK //清除邮件的收件人、主题、正文和附件。 //查询邮件的收件人。 //查询邮件的主题。 //查询邮件附件。 上海移远通信技术股份有限公司 19 / 32 LTE Standard(U)系列 SMTP 应用指导 2.3.7 AT+QSMTPPUT 发送邮件 将邮件完全发送出去可能需要一些时间，主要取决于附件大小和网络状况。在收到表示邮件发送结束的 URC +QSMTPPUT: , 前 ， 请 勿 重 复 发 送 邮 件 。 若 不 为 0 ， 可 直 接 执行 AT+QSMTPPUT=重新发送邮件。 AT+QSMTPPUT 发送邮件 测试命令 AT+QSMTPPUT=? 响应 +QSMTPPUT: (支持的范围) 设置命令 AT+QSMTPPUT= OK 响应 格式正确且未发送邮件： OK +QSMTPPUT: , 最大响应时间 特性说明 若出现任何错误： +CME ERROR: 取决于 / 参数 整型。发送邮件的最大时间。范围：60~65535；单位：秒。 错误码。详情请参考第 5 章。 整型。表示从 SMTP 中定义的 SMTP 服务器的原始错误码。详情请参考第 6 章。仅 供参考。0 表示邮件发送成功。 举例 AT+QSMTPPUT=300 OK +QSMTPPUT: 0,0 //发送邮件的最大时间为 300 秒。 //邮件发送成功。 上海移远通信技术股份有限公司 20 / 32 LTE Standard(U)系列 SMTP 应用指导 3 示例 3.1. 发送无 SSL 邮件 发送无 SSL 邮件表示禁用 SSL 功能，且邮件将在不安全连接的情况下发送出去，例如： //步骤 1：配置并激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //配置为 PDP 上下文 1。APN 为'UNINET'， 表示中国联通。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QSMTPCFG='contextid',1 //将PDP上下文ID设置为1。首先PDP上下文ID 需激活。 OK //步骤2：配置SMTP服务器和用户账号。 AT+QSMTPCFG='ssltype',0 //将SSL类型设置为'无SSL'。该情况下， SSL功能无法使用，且邮件将在不安全连接的 情况下发送。 AT+QSMTPCFG='smtpserver','smtp.163.com',25 //设置 IP 地址或域名以及 SMTP 服务器端口。 SMTP 服务器端口取决于邮件服务商。 OK AT+QSMTPCFG='account','sishen664551','wq664551' //设置用户名和密码。 OK AT+QSMTPCFG='sender','sishen664551','sishen664551@163.com' //设置发件人姓名和地址。邮件 接收后将显示发件人姓名。 OK //步骤3：编辑邮件内容。. AT+QSMTPDST=1,1,'quectel_test@163.com' //添加收件人，收件人类型为所有收件人。 OK AT+QSMTPDST=1,2,'quectel_test@21cn.com' //添加收件人，收件人类型为抄送的收件人。 OK AT+QSMTPDST? 上海移远通信技术股份有限公司 21 / 32 +QSMTPDST: 1,'quectel_test@163.com' +QSMTPDST: 2,'quectel_test@21cn.com' OK AT+QSMTPSUB=0,'TEST SMTP' OK AT+QSMTPSUB? +QSMTPSUB: 0,'TEST SMTP' OK AT+QSMTPBODY=0,100,120 CONNECT +QSMTPBODY: 100 OK AT+QFUPL='smtp1.txt',100,200,1 CONNECT +QFUPL: 100,707 OK AT+QFLST='*' +QFLST: 'smtp1.txt',100 OK AT+QSMTPATT=1,1,'smtp1.txt' OK AT+QSMTPATT? +QSMTPATT: 1,'smtp1.txt',100 OK //步骤4：发送邮件。 AT+QSMTPPUT=300 OK //可能需要几分钟时间。 +QSMTPPUT: 0,0 //步骤5：清除邮件内容并去激活PDP上下文。 AT+QSMTPCLR OK AT+QFDEL='smtp.txt' OK LTE Standard(U)系列 SMTP 应用指导 //编辑主题，主题的字符集为 ASCII。 //查询邮件主题。 //编辑邮件正文。主题的字符集为ASCII。最大输入 长度为100字节，且最大输入时间为120秒。 //将文件上传至 UFS。文件被另存为'smtp1.txt'， 文件最大长度为 100 字节。200 表示超时时间（单 位：秒），1 表示 ACK 模式。详情请参考文档 [4]。 //添加邮件附件，附件文件索引为 1 //查询附件。 //发送邮件，最大发送时间为 300 秒。 //邮件发送成功。 //清除邮件的收件人、主题、正文和附件。 //清除附件文件。 上海移远通信技术股份有限公司 22 / 32 LTE Standard(U)系列 SMTP 应用指导 //重复步骤3和步骤4，重新发送邮件。也可以重复步骤2至步骤4重新发送邮件。 AT+QIDEACT=1 //去激活PDP上下文。 OK 3.2. 发送 SSL 邮件 发送 SSL 的邮件表示邮件通过 SSL/TLS 加密的 SMTP 的方式进行发送。SMTP 服务器端口取决于邮 件服务商，通常为端口 465 或 587。与无 SSL 相比，SSL 方式发送邮件还需要配置 SMTP 服务器和用户账 号。 //配置 SSL 类型。 AT+QSMTPCFG='ssltype',1 //将 SSL 类型设置为 1，表示通过 SSL 方式发送邮件。 OK AT+QSMTPCFG='sslctxid',1 //为SMTP选择SSL上下文1。 OK AT+QSSLCFG='ciphersuite',1,0xffff //将SSL密码套件类型配置为0xffff，表示支持所有加密套件 类型。 OK AT+QSSLCFG='seclevel',1,0 //将 SSL 安全等级设置为 0，表示不需要 SSL CA 证书。 OK AT+QSSLCFG='sslversion',1,1 //将 SSL 版本配置为 1，表示 TLS1.0。 OK //配置SMTP服务器。 AT+QSMTPCFG='smtpserver','smtp.163.com',25 //设置 SMTP 服务器地址和端口。 OK //由于SMTP服务器的不同，账号信息各不相同，示例如下。 AT+QSMTPCFG='account','sishen664551','wq664551' //设置用户名及密码。 OK AT+QSMTPCFG='sender','sishen664551','sishen664551@163.com' //设置发件人姓名及地址。 OK 3.3. 发送 STARTTLS 邮件 发送 STARTTLS 邮件表示通过 STARTTLS 功能将常规的不安全连接升级为安全连接，从而发送邮件。 在此情况下，需要配置 SMTP 服务器和用户账号。SMTP 服务器端口取决于邮件服务商，通常为端口 25、 465 或 587。 上海移远通信技术股份有限公司 23 / 32 LTE Standard(U)系列 SMTP 应用指导 //配置SSL类型。 AT+QSMTPCFG='ssltype',2 //将SSL类型设置为2，表示将通过STARTTLS发送邮件。 OK AT+QSMTPCFG='sslctxid',1 //为SMTP选择SSL上下文1。 OK AT+QSSLCFG='ciphersuite',1,0xffff //将SSL密码套件类型配置为0xffff，表示支持所有密码套 件类型。 OK AT+QSSLCFG='seclevel',1,0 //将SSL安全等级设置为0，表示不需要SSL CA证书。 OK AT+QSSLCFG='sslversion',1,1 //将SSL版本配置为1，表示TLS1.0。 OK //配置SMTP服务器。 AT+QSMTPCFG='smtpserver','smtp.163.com',25 //设置SMTP服务器地址和端口。 OK //由于SMTP服务器的不同，账号信息各不相同，示例如下。 AT+QSMTPCFG='account','sishen664551','wq664551' //设置用户名及密码。 OK AT+QSMTPCFG='sender','sishen664551','sishen664551@163.com' //设置发件人姓名及地址。 OK 上海移远通信技术股份有限公司 24 / 32 LTE Standard(U)系列 SMTP 应用指导 4 错误处理 4.1. 执行 SMTP AT 命令失败 执行 SMTP AT 命令时，若收到模块返回的 ERROR，请检查是否已经插入(U)SIM 卡，并检查执行 AT+CPIN?时是否返回+CPIN: READY。若未返回+CPIN: READY，表示(U)SIM 卡未就绪。 4.2. PDP 激活失败 若通过 AT+QIACT 激活 PDP 上下文失败，请检查如下配置： 1. 通过 AT+CGATT?查询是否已附着 PS 域。若没有，请执行 AT+CGATT=1 附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保已注册 PS 域。 3. 通过 AT+QICSGP=查询 PDP 上下文参数，并确保已设置指定 PDP 上下文的 APN。 4. 确保 PPP 未使用指定的 PDP 上下文 ID，AT+CGACT 也未激活指定的 PDP 上下文 ID。 如果以上所有配置均正确，但依然无法通过 AT+QIACT 成功激活 PDP 上下文，请重启模块。重启模 块后，请对上述配置进行至少三次检查，每次检查间隔为 10 分钟，以避免频繁重启模块。 4.3. DNS 解析失败 执行 AT+QSMTPPUT 时，如果返回+QSMTPPUT: 653,0，请检查如下两处： 1. 确保 SMTP 服务器的域名有效。 2. 通过 AT+QIACT?查询 PDP 上下文的状态并确保指定的 PDP 上下文已成功激活。 4.4. AT+QSMTPPUT 错误响应 执行 AT+QSMTPPUT 后将返回+QSMTPPUT: ,。 上海移远通信技术股份有限公司 25 / 32 LTE Standard(U)系列 SMTP 应用指导 若不为 0，则表示发送失败。请重新发送邮件。若重新发送不成功，请通过 AT+QIDEACT 去激 活 PDP 上下文，并通过 AT+QIACT 重新激活 PDP 上下文以解决此问题。若激活 PDP 上下文失败，可参 考第 4.2 章以解决该问题。 若不为 0，则表示为 SMTP 服务器回复的错误代码。请根据协议 错误代码检查错误原因。例如，若为 535（身份验证失败），则表明或 可能是错误的。若为 530（拒绝访问），则表示邮件发送频率过高且 SMTP 服务器拒绝发布邮件。更多详细信息，请参考 RFC2821（简单邮件传输协议）。 上海移远通信技术股份有限公司 26 / 32 LTE Standard(U)系列 SMTP 应用指导 5 错误码 错误码表示与移动设备或网络相关的错误，错误码信息如下表所示。 表 3：错误码汇总 0 651 652 653 654 655 656 657 658 659 660 661 662 663 664 错误码 释义 successful operation 操作成功 Unknown error 未知错误 SMTP server is busy, such as uploading the SMTP 服务器正忙，例如上传邮件正文或发 body or sending an email. 送邮件。 Failed to get IP address according to the domain name. 无法根据域名获取 IP 地址。 Network error, such as failed to activate GPRS/CSD context, failed to establish the TCP connection with the SMTP server or failed to send an email to the SMTP server, 网络错误，例如无法激活 GPRS/CSD 上下文， 无法与 SMTP 服务器建立 TCP 连接或无法向 SMTP 服务器发送邮件等。 etc. Unsupported authentication type 不支持的身份验证类型 Connection for the SMTP server is closed by peer. SMTP 服务器的连接被对端关闭。 GPRS/CSD context is deactivated. GPRS/CSD 上下文去激活 Timeout 超时 No recipient for the SMTP server SMTP 服务器无收件人 Failed to send an email 发送邮件失败 Failed to open a file 打开文件失败 Insufficient memory for the attachment 内存不足 Failed to save the attachment 保存附件失败 Incorrect input parameter 输入参数错误 上海移远通信技术股份有限公司 27 / 32 LTE Standard(U)系列 SMTP 应用指导 665 SSL authentication failed SSL 验证失败 666 Service not available, closing transmission 服务不可用，正在关闭传输信道 channel 667 Requested mail action not taken: mailbox 未执行请求的邮件操作：邮箱不可用 unavailable 668 Requested action aborted: local error in 请求的操作已中止：处理中发生本地错误 processing 669 Requested action not taken: insufficient 未采取要求的操作：系统存储空间不足 system storage 670 Syntax error, command unrecognized 语法错误，命令无法识别 671 Syntax error in parameters or arguments 参数语法错误 672 Command not implemented 命令未实现 673 Bad sequence of commands 命令顺序错误 674 Command parameter not implemented 命令参数未实现 does not accept mail (see 675 RFC1846) 不接受邮件（请参考 RFC1846） 676 Access denied 拒绝访问 677 Authentication failed 验证失败 Requested action not taken: mailbox 678 unavailable 未执行请求的操作：邮箱不可用 679 User not local; please try 用户不在本地；请尝试 680 Requested mail action aborted: exceeded 请求的邮件操作中止：超出了分配存储 storage allocation 681 Requested action not taken: mailbox name 未采取请求的操作：不允许使用邮箱名称 not allowed 682 Transaction failed 交易失败 上海移远通信技术股份有限公司 28 / 32 LTE Standard(U)系列 SMTP 应用指导 6 SMTP 协议错误代码 协议错误代码表示 SMTP 服务器回复的错误。可参考 RFC2821（简单邮件传输协 议）。下表描述了有关协议错误码的详细信息。 表 4：SMTP 协议错误码汇总 错误代码 释义 421 Service not available, closing 服务不可用，正在关闭传输信道 transmission channel 450 Requested mail action not taken: 未执行请求的邮件操作：邮箱不可用 mailbox unavailable 451 Requested action aborted: local error in 请求的操作已中止：处理中发生本地错误 processing 452 Requested action not taken: insufficient 未采取要求的操作：系统存储空间不足 system storage 500 Syntax error, command unrecognized 语法错误，命令无法识别 501 Syntax error in parameters or 参数语法错误 arguments 502 Command not implemented 命令未实现 503 Bad sequence of commands 命令顺序错误 504 Command parameter not implemented 命令参数未实现 does not accept mail (see 不 接 受 邮 件 （ 请 参 考 521 RFC1846) RFC1846） 530 Access denied 拒绝访问 535 Authentication failed 验证失败 550 Requested action not taken: mailbox 未执行请求的操作：邮箱不可用 unavailable 551 User not local; please try <forward- 用户不在本地；请尝试 path> 552 Requested mail action aborted: 请求的邮件操作中止：超出了分配存储 exceeded storage allocation 上海移远通信技术股份有限公司 29 / 32 LTE Standard(U)系列 SMTP 应用指导 553 Requested action not taken: mailbox 未采取请求的操作：不允许使用邮箱名称 name not allowed 554 Transaction failed 交易失败 上海移远通信技术股份有限公司 30 / 32 LTE Standard(U)系列 SMTP 应用指导 7 附录 参考文档和术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(U)_TCP(IP)_应用指导 [2] Quectel_LTE_Standard(U)_AT_命令手册 [3] Quectel_LTE_Standard(U)_SSL_应用指导 [4] Quectel_LTE_Standard(U)系列_FILE_应用指导 表 6：术语缩写 缩写词 英文全称 ACK CSD DNS DTR GPRS PDP PPP PS QoS SD SMTP SSL Acknowledgement Circuit Switched Data Domain Name Server Data Terminal Ready General Packet Radio Service Packet Data Protocol Point-to-Point Protocol Packet Switch Quality of Service Secure Digital Simple Mail Transfer Protocol Security Socket Layer 中文全称 确认 电路交换数据业务 域名系统 数据终端就绪 通用无线分组业务 分组报文协议 点对点协议 分组交换 服务质量 安全数码 简单邮件传输协议 安全套接层 上海移远通信技术股份有限公司 31 / 32 LTE Standard(U)系列 SMTP 应用指导 TA TCP TLS UFS (U)SIM Terminal Adapter Transmission Control Protocol Transport Layer Security Universal Flash Storage (Universal) Subscriber Identity Module 终端适配器 传输控制协议 传输层安全（协议） 通用闪存存储 通用用户识别模块 上海移远通信技术股份有限公司 32 / 32

RGx00U&RM500U 系列 分区备份还原机制介绍 5G 模块系列 版本：1.0 日期：2023-12-25 状态：受控文件 RGx00U&RM500U 系列分区备份还原机制介绍 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 文档历史 修订记录 版本 1.0 日期 2023-11-21 2023-12-25 作者 Luke LIU Luke LIU 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 备份还原机制......................................................................................................................................... 8 2.1. nr_fixnv*和 nr_runtimenv*分区 ............................................................................................... 8 2.1.1. 分区备份 .......................................................................................................................... 8 2.1.2. 分区还原 .......................................................................................................................... 9 2.1.2.1. nr_fixnv*分区还原 ................................................................................................... 9 2.1.2.2. nr_runtimenv*分区还原......................................................................................... 10 2.2. userdata 和 data 分区 ............................................................................................................11 3 分区还原验证....................................................................................................................................... 12 3.1. nr_runtimenv1 分区 .............................................................................................................. 12 3.2. data 分区............................................................................................................................... 13 3.3. userdata 分区........................................................................................................................ 15 4 相关 AT 命令详解 ................................................................................................................................ 17 4.1. AT 命令说明 .......................................................................................................................... 17 4.1.1. 定义 ............................................................................................................................... 17 4.1.2. AT 命令语句................................................................................................................... 17 4.2. AT 示例声明 .......................................................................................................................... 18 4.3. AT+QPRTPARA 查询分区还原次数 ................................................................................... 18 5 附录 参考文档及术语缩写 .................................................................................................................. 19 上海移远通信技术股份有限公司 4 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 表格索引 表 1：备份还原涉及的主要分区 ................................................................................................................... 8 表 2：AT 命令类型 ..................................................................................................................................... 17 表 3：参考文档 ........................................................................................................................................... 19 表 4：术语缩写 ........................................................................................................................................... 19 上海移远通信技术股份有限公司 5 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 图片索引 图 1：nr_fixnv*分区还原............................................................................................................................... 9 图 2：nr_runtimenv*分区还原 .................................................................................................................... 10 图 3：userdata 和 data 分区还原 ................................................................................................................11 图 4：擦除 nr_runtimenv1 分区并重启模块................................................................................................ 12 图 5：查询 nr_runtimenv1 分区还原次数 ................................................................................................... 13 图 6：查询 nr_runtimenv1 分区是否已加载................................................................................................ 13 图 7：擦除 data 分区并重启模块................................................................................................................ 14 图 8：查询 data 分区还原次数 ................................................................................................................... 14 图 9：查询 data 分区是否已加载................................................................................................................ 15 图 10：擦除 userdata 分区并重启模块....................................................................................................... 15 图 11：查询 userdata 分区还原次数........................................................................................................... 16 图 12：查询 userdata 分区是否已加载....................................................................................................... 16 上海移远通信技术股份有限公司 6 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 1 引言 文件系统损坏，主要是由于 NAND 擦写过程中模块断电，导致文件系统关键数据结构丢失，从而导致 文件系统损坏，模块无法正常运行。移远通信 5G RG200U 系列、RG500U 系列和 RM500U 系列模块针对 文件系统的读写分区设计备份还原机制（或者损坏后格式化为默认值），以确保整个软件系统的稳定性。 本文档介绍移远通信 RG200U 系列、RG500U 系列和 RM500U 系列的分区备份还原机制及分区备份 还原验证步骤。进行分区备份还原操作后，分区恢复，模块正常工作且可以成功连接网络。 上海移远通信技术股份有限公司 7 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 2 备份还原机制 备份还原涉及的主要分区如下所示。 表 1：备份还原涉及的主要分区 分区名称 分区大小 数据类型 nr_fixnv1 8 M nr_fixnv2 8 M nr_runtimenv1 8 M nr_runtimenv2 8 M userdata 40 M data 14 M RAW（可读可写） RAW（可读可写） RAW（可读可写） RAW（可读可写） ubifs（可读可写） ubifs（可读可写） 备注 NV 相关的信息 与 nr_fixnv1 互为备份 存储设备运行时使用的 NV 数据 与 nr_runtimenv1 互为备份 存储设备运行时的配置数据 与 userdata 分区互为备份 2.1. nr_fixnv*和 nr_runtimenv*分区 2.1.1. 分区备份 nr_fixnv*和 nr_runtimenv*分区用于存储 NV 和 RF 配置等重要数据。出厂调校时，nr_fixnv*和 nr_runtimenv*分区已为相互备份的状态，无需用户手动备份。 ⚫ nr_fixnv1 与 nr_fixnv2 互为备份，任意一分区损坏将通过另一个分区还原，设备升级时将基于配置 保留 nr_fixnv1 中的部分设置。 ⚫ nr_runtimenv1 与 nr_runtimenv2 互为备份。nr_runtimenv1 分区是设备运行时使用的 NV 数据存 储分区，初始数据从 nr_fixnv1 而来，后续对 NV 的设置只会对 nr_runtimenv*分区产生影响，不会 改动 nr_fixnv*分区。 ⚫ nr_runtimenv1 的初始数据从 nr_fixnv1 中获取。 上海移远通信技术股份有限公司 8 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 备注 nr_fixnv*表示 nr_fixnv1 和 nr_fixnv2；nr_runtimenv*表示 nr_runtimenv1 和 nr_runtimenv2。 2.1.2. 分区还原 2.1.2.1. nr_fixnv*分区还原 模块 启动 校验nr_fixnv1分区 设置 nr _fixn v1还原 标记 N 分区 完好 Y 校验nr_fixnv2分区 设置 nr _fixn v2还原 标记 N 分区 完好 Y 判断 还原标 记 无还 原标记 nr _fixn v1还原 标记 nr _fixn v2还原 标记 nr _fixn v1还原 标记 nr _fixn v2还原 标记 图 1：nr_fixnv*分区还原 检查OK 从nr_fixnv2还原 校验nr_runtimefixn*分 区 从nr_fixnv1还原 模块 启动失 败 上海移远通信技术股份有限公司 9 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 2.1.2.2. nr_runtimenv*分区还原 校验nr_runtimefixnv分区 设置nr_runtimenv1还 原标 记 N 设置nr_runtimenv2还 原标 记 N 校验nr_runtimenv1分区 N 分区 完好 Y 与nr_fixnv内 容一 致 N Y 校验nr_runtimenv2分区 Y 分区 完好 Y 与nr_fixnv内 容一 致 Y 判断 还原标 记 无还 原标记 检查OK nr _ru ntimen v2还原 标记 从nr_runtimenv1还原 nr_runtimenv1还原标记 从nr_runtimenv2还原 nr _ru ntimen v1还原 标记 nr _ru ntimen v2还原 标记 从nr _fixn v分区 还原 图 2：nr_runtimenv*分区还原 烧写nr_runtimenv1、 nr_runtimenv2到 nr_fixnv 模块 启动 上海移远通信技术股份有限公司 10 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 2.2. userdata 和 data 分区 userdata 和 data 分区互为备份，每次开机模块会自动同步两个分区内容，以确保数据保持一致，任意 一分区损坏将通过另一个分区还原。若两个分区均损坏，分区数据将还原为默认配置。默认还原配置在模块 出厂时已设置。 模块 启动 检查data分区 是否 损坏 N Y 检查userdata分区 是否 损坏 格式 化成默 认配置 ，设 Y 置还 原标记 N 同步userdata/data分区 数据 检查userdata分区 是否 损坏 Y 格式 化us er da ta 分区 ， 同步 da ta分区 数据到 user da ta 分区 ，设置 还 原标 记 N 格式 化da ta分区 ，同步 user da ta 分区 数据到 da ta分区 ，设置 还原标 记 系统 运行 图 3：userdata 和 data 分区还原 上海移远通信技术股份有限公司 11 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 3 分区还原验证 本章节以 nr_runtimenv1、data 分区和 userdata 分区为例，介绍分区还原的验证步骤。 3.1. nr_runtimenv1 分区 步骤一 执行 AT+QPRTPARA=4（详见第 4.3 章）查看 nr_runtimenv1 分区还原次数。 步骤二 打开 QCOM 工具（有关该工具使用详情，请参考文档 [2]），执行 AT+QADBKEY?获取模块 的 chip_uid 后，联系移远通信技术支持获取对应的密码，获取密码后再使用密码执行 AT+QADBKEY=。 步骤三 执行 AT+QCFG='usbcfg',0x2c7c,0x0900,1,1,1,1,1,1,1 配置 USB 端口，开启模块 ADB 功 能，然后重启模块使配置生效。有关该命令详情，请参考文档 [1]。 步骤四 执行如下命令进入 bootloader 模式。 adb -s 0123456789ABCDEF reboot bootloader 步骤五 执行如下命令擦除 nr_runtimenv1 分区。 fastboot erase nr_runtimenv1 步骤六 执行如下命令重启模块。 fastboot reboot 图 4：擦除 nr_runtimenv1 分区并重启模块 上海移远通信技术股份有限公司 12 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 步骤七 再次执行 AT+QPRTPARA=4 查看 nr_runtimenv1 分区还原次数。 图 5：查询 nr_runtimenv1 分区还原次数 如上图所示，若命令返回的第 4 个参数数值在步骤一返回的数值的基础上增加 1， 则表示 nr_runtimenv1 分区已经还原一次。 在模块上操作拨号入网，然后再执行 adb shell ls -l /dev/ubi0_nr_runtimenv1 查询 nr_runtimenv1 分 区是否加载成功，若命令返回下图所示的第 2 行信息，则表示 nr_runtimenv1 分区已成功加载。 图 6：查询 nr_runtimenv1 分区是否已加载 3.2. data 分区 步骤一 执行 AT+QPRTPARA=4（详见第 4.3 章）查询 data 分区还原次数。 步骤二 参考第 3.1 章的步骤二和步骤三开启模块的 ADB 功能。 步骤三 执行如下命令进入 bootloader 模式。 adb -s 0123456789ABCDEF reboot bootloader 上海移远通信技术股份有限公司 13 / 19 步骤四 执行如下命令擦除 data 分区。 fastboot erase data 步骤五 执行如下命令重启模块。 fastboot reboot RGx00U&RM500U 系列分区备份还原机制介绍 图 7：擦除 data 分区并重启模块 步骤六 再次执行 AT+QPRTPARA=4 查询 data 分区还原次数。 图 8：查询 data 分区还原次数 如上图所示，若命令返回的第 6 个参数数值在步骤一返回的数值的基础上增加 1， 则表示 data 分区已经还原一次。 上海移远通信技术股份有限公司 14 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 在模块上操作拨号入网，然后再执行 adb shell ls -l /dev/ubi0_data 查询 data 分区是否加载成功，若 命令返回如下图所示的第 2 行信息，则表示 data 分区已成功加载。 图 9：查询 data 分区是否已加载 3.3. userdata 分区 步骤一 执行 AT+QPRTPARA=4（详见第 4.3 章）查询 userdata 分区还原次数。 步骤二 参考第 3.1 章的步骤一和步骤二开启模块的 ADB 功能。 步骤三 执行如下命令进入 bootloader 模式。 adb -s 0123456789ABCDEF reboot bootloader 步骤四 执行如下命令擦除 userdata 分区。 fastboot erase userdata 步骤五 执行如下命令重启模块。 fastboot reboot 图 10：擦除 userdata 分区并重启模块 上海移远通信技术股份有限公司 15 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 步骤六 再次执行 AT+QPRTPARA=4 查询 userdata 分区还原次数。 图 11：查询 userdata 分区还原次数 如上图所示，若命令返回的第 7 个参数数值在步骤一返回的数值的基础上增加 1，则表示 userdata 分区已经还原一次。 在模块上操作拨号入网，然后再执行 adb shell ls -l /dev/ubi0_userdara 查询 userdata 分区是否加 载成功，若命令返回如下图所示的第 2 行信息，则表示 userdata 分区已成功加载。 图 12：查询 userdata 分区是否已加载 上海移远通信技术股份有限公司 16 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 4 相关 AT 命令详解 4.1. AT 命令说明 4.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 4.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 17 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 4.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 4.3. AT+QPRTPARA 查询分区还原次数 该命令用于查询分区还原次数。 AT+QPRTPARA 查询分区还原次数 设置命令 AT+QPRTPARA= 响应 +QPRTPARA: ,,,,,, OK 最大响应时间 特性说明 若有任何错误： ERROR 30 秒 - 参数 整型。 4 查询各分区的还原次数 整型。备份状态。 0 未备份 1 已备份 整型。nr_fixnv1 分区的还原次数。最小值：0。 整型。nr_fixnv2 分区的还原次数。最小值：0。 整型。nr_runtimenv1 分区的还原次数。最小值：1。 整型。nr_runtimenv2 分区的还原次数。最小值：1。 整型。data 分区的还原次数。最小值：0。 整型。userdata 分区的还原次数。最小值：0。 上海移远通信技术股份有限公司 18 / 19 RGx00U&RM500U 系列分区备份还原机制介绍 5 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_RGx00U&RM500U 系列_AT 命令手册 [2] Quectel_QCOM_User_Guide 表 4：术语缩写 缩写 ADB NAND NV RF 英文全称 Android Debug Bridge NON-AND Non-volatile Radio Frequency 中文全称 安卓调试桥 与非 非易失性 射频 上海移远通信技术股份有限公司 19 / 19

LC29H 系列&LC79H (AL) I2C 应用指导 GNSS 模块系列 版本：1.0 日期：2023-12-05 状态：受控文件 LC29H 系列&LC79H (AL) I2C 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 LC29H 系列&LC79H (AL) I2C 应用指导 GNSS 模块系列 I2C 应用指导 受控文件 修订历史 版本 1.0 日期 2023-03-31 2023-12-05 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 目录 关于文档 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................4 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 引言.....................................................................................................................................................7 2 I2C 通信协议 .......................................................................................................................................8 2.1. 起始信号和停止信号 ..........................................................................................................8 2.2. 数据传输及应答 .................................................................................................................8 2.3. 通信 ...................................................................................................................................9 2.4. 写入数据时序...................................................................................................................10 2.5. 读取数据时序...................................................................................................................10 3 I2C 读写操作 .....................................................................................................................................11 3.1. 主机读取数据流程............................................................................................................ 11 3.2. 主机写入数据流程............................................................................................................15 4 I2C 多从机读写操作 ..........................................................................................................................18 5 I2C 读/写示例 ....................................................................................................................................22 6 主机读写 I2C 的示例代码 ..................................................................................................................23 7 附录 参考文档及术语缩写.................................................................................................................30 上海移远通信技术股份有限公司 4 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 表格索引 表 1：适用模块.......................................................................................................................................... 7 表 2：参考文档........................................................................................................................................ 30 表 3：术语缩写........................................................................................................................................ 30 上海移远通信技术股份有限公司 5 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 图片索引 图 1：起始信号和停止信号 ........................................................................................................................ 8 图 2：I2C 总线应答 ................................................................................................................................... 9 图 3：I2C 数据传输 ................................................................................................................................... 9 图 4：写入数据时序图 ............................................................................................................................. 10 图 5：读取数据时序图 ............................................................................................................................. 10 图 6：主机读取数据步骤 1....................................................................................................................... 12 图 7：主机读取数据步骤 2....................................................................................................................... 13 图 8：主机读取数据流程图 ...................................................................................................................... 14 图 9：主机写入数据步骤 1....................................................................................................................... 15 图 10：主机写入数据步骤 2..................................................................................................................... 16 图 11：主机写入数据流程图 .................................................................................................................... 17 图 12：多从机环境 I2C 总线操作流程...................................................................................................... 18 图 13：多从机环境 I2C 总线流程示例 1................................................................................................... 19 图 14：多从机环境 I2C 总线错误流程...................................................................................................... 20 图 15：多从机环境 I2C 总线流程示例 2................................................................................................... 21 上海移远通信技术股份有限公司 6 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 1 引言 本文档介绍 LC29H 系列和 LC79H (AL)模块的 I2C 功能及使用方法。与主机（客户端 MCU）通信时， 模块始终作为从机运行。主机可以通过 I2C 总线读取/写入数据。 模块的 I2C 接口有如下特性： ⚫ 支持从机模式。 ⚫ 支持标准模式（100 kbps）和快速模式（400 kbps）。 ⚫ 7 位寻址；共有 3 个设备地址，读写配置指令地址为 0x50，读取数据地址 0x54，写入数据地址 0x58。 ⚫ 支持发送和接收不定长度的数据。 ⚫ I2C 引脚：I2C_SDA 和 I2C_SCL。 本文档主要介绍主机如何通过 I2C 总线对从机进行读写操作，包括 I2C 通信协议、读写流程、示例和 示例代码等。 表 1：适用模块 模块系列 LC29H LC79H 型号 LC29H (AA) LC29H (BA) LC29H (BS) LC29H (CA) LC29H (DA) LC79H (AL) 上海移远通信技术股份有限公司 7 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 2 I2C 通信协议 2.1. 起始信号和停止信号 主机发送起始信号（S）后，总线任务启动。起始信号指 SDA 信号线由高电平到低电平的跳变，同时 SCL 信号线保持在高电平（见下图）。在主机通过总线发送停止信号（P）之前，总线被视为一直处于忙碌 状态。停止信号（P）指 SDA 信号线由低电平到高电平的跳变，且 SCL 保持在高电平（见下图）。此外， 如果重复产生起始信号而非停止信号，总线将保持忙碌状态。 SCL SDA S 起始信号 图 1：起始信号和停止信号 P 停止信号 2.2. 数据传输及应答 I2C 数据字节定义为 8 位长度。每次传输可以发送的字节数量不受限制。传输的每个字节后面必须有一 个应答信号。应答信号的时钟由主机产生。接收机下拉 SDA 信号线，使其在应答时钟脉冲为高电平周期内 保持低电平，从而产生应答信号（ACK）。若接收机上拉 SDA 信号线，使其在应答时钟脉冲为高电平周期 内保持高电平，则产生非应答信号（NAK）。 如果从机处于忙碌状态，需要完成当前处理的任务之后才能发送或接收下一字节数据，从机可将 SCL 保持低电平，迫使主机进入等待状态。当从机恢复为空闲状态并释放时钟线，数据传输恢复正常。 上海移远通信技术股份有限公司 8 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 主机时钟线（SCL） 数据发送（SDA） 1 2 数据接收（SDA） 起始信号 图 2：I2C 总线应答 8 9 应答信号响应的时钟脉冲 NAK ACK 2.3. 通信 通过产生起始信号（S）建立通信后，主机发送一个 7 位的从地址和一个读/写位（第 8 位）。读/写位决 定主机接收从机发送的数据或向从机写入数据，如果该位为 0，则主机向从主机写入数据；如果该位为 1， 则主机读取从机的数据。数据通过 SDA 信号线传输，首先以最高有效位（MSB）传输数据。随后，主机释 放 SDA 信号线并等待从机发出的应答信号（ACK）。从机必须拉低 SDA 信号线，使其在 SCL 信号线为高 电平周期内保持低电平，在每个传输字节后返回应答位。主机通过生成停止信号（P）终止数据传输，从而 释放通信线。主机可以生成重复的起始信号（S），且可以在未发送停止信号（P）的情况下寻址另一个从机。 除起始和停止信号外，SDA 信号线的电平变化均应发生在 SCL 信号线为低电平期间。 SCL 1-7 8 9 1 - 8 9 SDA 地址 读写位 ACK S 起始信号 数据 ACK 图 3：I2C 数据传输 1 - 8 9 数据 ACK P 停止信号 上海移远通信技术股份有限公司 9 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 2.4. 写入数据时序 将数据写入 I2C 从机的时序图如下所示。 起 始 信 号 从机地址 （0xA0） 写 SDA MSB LSB 读ACK 写 位 数据 停 止 信 号 ACK 图 4：写入数据时序图 向模块写入数据前，主机先发送开始信号，随后发送从机地址和一个写入位，在第 9 个时钟周期（时 钟为高电平）时，从机应答主机。然后，主机将数据传输到总线上，每传输 8 位，从机响应一个 ACK，表 示已经收到数据。即，如果产生一个 ACK 位，表示从机已经接收到数据并准备接收下一字节数据；如果产 生一个 NAK 位，表示从机不再接收数据，主机应通过发送停止信号（P）来终止数据传输。 2.5. 读取数据时序 从 I2C 从机读取数据的时序图如下所示。 起 始 信 号 从机地址 读 （0xA9） SDA MSB LSB 读ACK 写 位 数据 ... ACK 图 5：读取数据时序图 停 止 信 号 数据 NAK 读取从机数据前，主机发送起始信号、从机地址和一个读取位。随后，从机向主机发送 ACK 信号和数 据。如主机发送非应答信号（NAK）和一个停止位，则通信结束。上图为多字节数据读取时序。 上海移远通信技术股份有限公司 10 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 3 I2C 读写操作 本章详细介绍主机如何通过 I2C 总线读和写消息。消息详情请参考文档 [1] 协议规范。 从机处理输入数据所需的时间为 10 ms，因此两条输入消息之间的间隔不可小于 10 ms。 3.1. 主机读取数据流程 主机读取数据的流程如下： 步骤1 主机读取模块 I2C 发送缓冲区的数据长度。 a) 主机向模块发送读取配置指令。 ⚫ 先发送 7 位设备地址 0x50 与写位。 ⚫ 以小端字节序依次发送两个 4 字节数据：0xAA510008 和 0x00000004。 b) 主机读取模块 I2C 发送缓冲区的数据长度。 ⚫ 先发送 7 位设备地址 0x54 与读位。 ⚫ 从模块缓冲区获取数据长度。 上海移远通信技术股份有限公司 11 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 数据（占8字节） 设备地址与 写位 0xAA510008 0x00000004 起 主机 始 信 (0x50<<1) & 0xFE 号 0x08 0x00 0x51 0xAA 0x04 0x00 0x00 停 止 0x00 信 号 模块 A A A A A A A A A C C C C C C C C C K K K K K K K K K 设备地址与 读位 数据长度（占4字节） 主机 起 始 (0x54<<1 ) 信 | 0x01 号 A A A C C C K K K 模块 A C 数据1 K 数据2 数据3 数据4 停 止 NAK 信 号 图 6：主机读取数据步骤 1 步骤2 主机读取长度为 data_read_len 1)字节的数据。 a) 主机向模块发送读取配置指令。 ⚫ 先发送 7 位设备地址 0x50 与写位。 ⚫ 以小端字节序依次发送两个 4 字节数据：0xAA512000 和 data_read_len 1)。 b) 主机读取 data_read_len 1)字节数据。 ⚫ 先发送 7 位设备地址 0x54 与读位。 ⚫ 接收 data_read_len 1)字节数据。 上海移远通信技术股份有限公司 12 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 数据（占8字节） 设备地址与 写位 起 主机 始 信 号 (0x50<<1) & 0xFE 0x00 0xAA512000 0x20 0x51 0xAA data_read_len（例如200字节） 0xC8 0x00 0x00 停 止 0x00 信 号 模块 A A A A A A A A A C C C C C C C C C K K K K K K K K K 设备地址与 读位 起 主机 始 信 (0x54<<1) | 0x01 号 数据（占data_read_len字节） A A A C C C K K K 模块 A C 数据1 K 数据2 数据3 停 A 止 C NAK 信 K 号 数据N 图 7：主机读取数据步骤 2 备注 1. 1) 无符号整型 data_read_len 是主机接收的数据长度。data_read_len 应小于或等于步骤 1 中获取 的数据长度。若从模块 I2C 发送缓冲区中读取的数据长度大于 data_read_len，可重复执行步骤 2， 直至所有数据读取完毕。主机实际读取的数据总长度不可超过步骤 1 中获取的数据长度。 2. 若主机未及时读取数据，模块的 I2C 发送缓冲区将会填满，使 I2C 进入休眠状态。可通过 I2C 对模块 发送任意数据将其唤醒。 3. 模块以小端字节序传输数据。 上海移远通信技术股份有限公司 13 / 30 主机 LC29H 系列&LC79H (AL) I2C 应用指导 模块 若接收数据长 度为0，需再 次读取该值 延时 1) 模块地址：0x50和写位 发送两个4字节数据：0xAA510008 和 0x00000004 延时 1) 模块地址：0x54和读位 接收数据长度 延时 1) 模块地址：0x50和写位 发送两个4字节数据：0xAA512000 和 data_read_len 延时 1) 模块地址：0x54和读位 接收数据（长度为 data_read_len 字节） 备注 1) 延时约为 10 ms。 图 8：主机读取数据流程图 上海移远通信技术股份有限公司 14 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 3.2. 主机写入数据流程 主机写入数据流程如下： 步骤1 主机读取模块 I2C 接收缓冲区的可用长度。 a) 主机向模块发送读取配置指令。 ⚫ 先发送 7 位设备地址 0x50 与写位。 ⚫ 以小端字节序依次发送两个 4 字节数据：0xAA510004 和 0x00000004。 b) 主机读取模块 I2C 接收缓冲区的可用长度。 ⚫ 先发送 7 位设备地址 0x54 与读位。 ⚫ 读取接收缓冲区可用长度。 数据（占8字节） 设备地址与 写位 主机 起 始 (0x50<<1) 信 & 0xFE 号 0x04 0xAA510004 0x00 0x51 0xAA 0x04 0x00000004 0x00 0x00 停 止 0x00 信 号 模块 A A A A A A A A A C C C C C C C C C K K K K K K K K K 主机 设备地址与 读位 起 始 (0x54<<1) 信 | 0x01 号 A 模块 C K 数据1 模块I2C接收缓冲区可用长度（占4字节） A A A C C C K K K 数据2 数据3 数据4 停 止 NAK 信 号 图 9：主机写入数据步骤 1 步骤2 主机写入 data_written_len 1)字节的数据。 a) 主机向模块发送写入配置指令。 ⚫ 先发送 7 位设备地址 0x50 与写位。 ⚫ 以小端字节序依次发送两个 4 字节数据：0xAA531000 和 data_written_len 1)。 上海移远通信技术股份有限公司 15 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 b) 主机写入 data_written_len 1)字节数据。 ⚫ 先发送 7 位设备地址 0x58 与写位。 ⚫ 写入 data_written_len 1)字节数据。 数据（占8字节） 0xAA531000 data_written_len（例如30字节） 设备地址与写位 起 主机 始 (0x50<<1) 信 & 0xFE 号 0x00 0x10 0x53 0xAA 0x1E 0x00 0x00 停 止 0x00 信 号 A A A A A A A A A 模块 ACKC C C C C C C C C K K K K K K K K K 数据（占data_written_len字节） 设备地址与写位 起 主机 始 (0x58<<1) 信 & 0xFE 号 数据1 数据2 数据3 A A A A 模块 C C C C K K K K 停 数据N 止 信 号 A A C C K K 图 10：主机写入数据步骤 2 备注 1. 1) 无符号整型 data_written_len 是主机发送的数据长度。 2. 模块 I2C 接收缓冲区可用长度为主机一次可写入数据的最大长度。若待发送数据长度大于该值，需将 数据拆分后多次发送。 3. 模块以小端字节序传输数据。 上海移远通信技术股份有限公司 16 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 主机 模块 延时 1) 设备地址0x50和写位 发送两个4字节数据：0xAA510004 和 0x00000004 延时 1) 设备地址0x54和读位 接收 模块I2C接收 缓冲区 可用大 小 延时 1) 设备地址0x50和写位 发送两个4字节数据：0xAA531000 和 data_written_len 延时 1) 设备地址0x58和写位 写入数据（data_written_len 字节） 备注 1) 延时约为 10 ms。 图 11：主机写入数据流程图 上海移远通信技术股份有限公司 17 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 4 I2C 多从机读写操作 若 I2C 总线上有多个从设备，主机读取模块数据时需注意： 1. 为确保 I2C 总线的正确通信，在向 GNSS 模块和其他从设备读取/写入数据时应遵循特定的顺序。 如果主机需在操作 GNSS 模块之前操作其他 I2C 设备，主机应先发送 7 位设备地址（0x50），然 后按照第 3.1 章 主机读取数据流程的步骤 1-a）~步骤 2-b）或第 3.2 章 主机写入数据流程的步骤 1-a）~步骤 2-b）执行读写步骤，否则 I2C 总线上会产生 NAK 信号。 主机 操作其他I2C设备 向GNSS模块发送7位从机地址（0x50），不 发送数据 步骤1-a）：向模块发送读取配置指令 步骤1-b）：读取模块I2C发送缓冲区数据长度 或模块I2C接收缓冲区可用长度 步骤2-a）：向模块发送读/写配置指令 主机 操作其他I2C设备 步骤1-a）：向模块发送读取配置指令 步骤1-b）：读取模块I2C发送缓冲区数据长 度或模块I2C接收缓冲区可用长度 执行步骤1-b）时， 将产生NAK信号 步骤2-a）：向模块发送读/写配置指令 步骤2-b）：读取/写入数据 步骤2-b）：读取/写入数据 正确流程 × 错误流程 图 12：多从机环境 I2C 总线操作流程 上海移远通信技术股份有限公司 18 / 30 正确流程示例 LC29H 系列&LC79H (AL) I2C 应用指导 错误流程示例 图 13：多从机环境 I2C 总线流程示例 1 2. 主机不可在与 GNSS 模块传输数据时操作其他 I2C 设备。 上海移远通信技术股份有限公司 19 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 主机 向GN SS 模块 发送 7位从 机地 址（0x50）， 不 发送数据 操作 其他 I2C设备 步骤1-a）：向模块发送读取配置指令 不可 在向 GN SS 模块 发送 7位 从机地址（0x50）至步骤2-b) 期间操作其他I2C设备 操作 其他 I2C设备 步骤1-b）：读取模块I2C发送缓冲区数据长度 或模块I2C接收缓冲区可用长度 操作其他I2C设备 步骤2-a）：发送读/写配置指令 操作其他I2C设备 步骤2-b）：读取/写入数据 图 14：多从机环境 I2C 总线错误流程 上海移远通信技术股份有限公司 20 / 30 正确流程示例 LC29H 系列&LC79H (AL) I2C 应用指导 错误流程示例 图 15：多从机环境 I2C 总线流程示例 2 上海移远通信技术股份有限公司 21 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 5 I2C 读/写示例 以 LC29H (BA)模块为例，通过 I2C 接口读取 NMEA 数据与写入数据的流程如下。 //读取数据。 //步骤 1-a：主机向模块发送读取配置指令。 A0 08 00 51 AA 04 00 00 00 //步骤 1-b：主机读取模块 I2C 发送缓冲区数据长度。如果读取到 0 则重新执行上一步。 A9 FC 09 00 00 //步骤 2-a：主机向模块发送读取配置指令，配置读取数据的长度为 0x00000400。 A0 00 20 51 AA 00 04 00 00 //步骤 2-b：主机读取 NMEA 数据，长度为 0x00000400。 A9 24 50 51 54 4D 56 45 52 2C 4D 4F 44 55 4C 45 5F…… //步骤 2-a：主机向模块发送读取配置指令，配置读取数据的长度为 0x00000400。 A0 00 20 51 AA 00 04 00 00 //步骤 2-b：主机读取 NMEA 数据，长度为 0x00000400。 A9 43 0D 0A 24 47 4E 56 54 47 2C 2C 54 2C 2C 4D 2C…… //步骤 2-a：主机向模块发送读取配置指令，配置读取数据的长度为 0x000001FC。 A0 00 20 51 AA FC 01 00 00 //步骤 2-b：主机读取 NMEA 数据，长度为 0x000001FC。 A9 42 47 53 56 2C 31 2C 31 2C 30 30 2C 35 2A 37 32…… //以 15 字节消息$PQTMVERNO*58rn 为例写入数据。 //步骤 1-a：主机向模块发送读取配置指令。 A0 04 00 51 AA 04 00 00 00 //步骤 1-b：主机获取模块 I2C 接收缓冲区的可用长度。可用长度 0x00000003 小于待发送消息的长度 0x0000000F，需拆分后发送。 A9 03 00 00 00 //步骤 2-a：主机发送写入配置指令，配置写入长度为 0x00000003。 A0 00 10 53 AA 03 00 00 00 //步骤 2-b：主机将数据写入模块，先写入'$PQ'。 B0 24 50 51 //步骤 1-a：主机向模块发送读取配置指令。 A0 04 00 51 AA 04 00 00 00 //步骤 1-b：主机获取模块 I2C 接收缓冲区的可用长度。 A9 FD F0 00 00 //步骤 2-a：主机发送写入配置指令，配置写入长度为 0x0000000C。 A0 00 10 53 AA 0C 00 00 00 //步骤 2-b：主机将数据写入模块，即写入'TMVERNO*58rn'。 B0 54 4D 56 45 52 4E 4F 2A 35 38 0D 0A 上海移远通信技术股份有限公司 22 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 6 主机读写 I2C 的示例代码 从模块 I2C 发送缓冲区读取数据和向模块 I2C 接收缓冲区发送数据的示例代码如下。 #define QUECTEL_I2C_SLAVE_CR_CMD 0xaa51 #define QUECTEL_I2C_SLAVE_CW_CMD 0xaa53 #define QUECTEL_I2C_SLAVE_CMD_LEN #define QUECTEL_I2C_SLAVE_TX_LEN_REG_OFFSET #define QUECTEL_I2C_SLAVE_TX_BUF_REG_OFFSET 8 0x08 0x2000 #define QUECTEL_I2C_SLAVE_RX_LEN_REG_OFFSET #define QUECTEL_I2C_SLAVE_RX_BUF_REG_OFFSET 0x04 0x1000 #define QUECTEL_I2C_SLAVE_ADDRESS_CR_OR_CW #define QUECTEL_I2C_SLAVE_ADDRESS_R #define QUECTEL_I2C_SLAVE_ADDRESS_W 0x50 0x54 0x58 #define MAX_ERROR_NUMBER #define MAX_I2C_BUFFER 20 1024 typedef enum { I2C_ACK = 0, I2C_NACK = 1 }I2c_Resp_FlagStatus; typedef enum { DEV_REP_SUCCESS = 0, DEV_REP_ERROR = 1 }Dev_Resp_FlagStatus; I2c_Resp_FlagStatus I2c_Master_Receive(uint8_t addr, uint8_t *Data, uint16_t Length) { mcu_i2c_start(); mcu_i2c_send_byte(addr|0x01); if(mcu_i2c_wait_ack() != I2C_ACK) { mcu_i2c_stop(); return I2C_NACK; 上海移远通信技术股份有限公司 23 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 } for(int i = 0; i < Length; i++) { *(Data + i) = mcu_i2c_receive_byte(); if(i != (Length - 1)) { mcu_i2c_ack(); } } mcu_i2c_no_ack(); mcu_i2c_stop(); return I2C_ACK; } I2c_Resp_FlagStatus I2c_Master_Transmit(uint8_t addr, uint8_t *Data, uint8_t Length) { uint8_t i = 0; uint8_t flag=0; mcu_i2c_start(); mcu_i2c_send_byte(addr); if(mcu_i2c_wait_ack() == I2C_NACK) { mcu_i2c_stop(); return I2C_NACK; } for(i = 0; i < Length; i++) { mcu_i2c_send_byte(*(Data+i)); if(mcu_i2c_wait_ack() == I2C_NACK) { mcu_i2c_stop(); return I2C_NACK; } } mcu_i2c_stop(); return I2C_ACK; } Dev_Resp_FlagStatus Quectel_Dev_Receive(uint8_t* pData, uint16_t maxLength, uint16_t* pRecLength) { uint32_t request_cmd[2]; uint16_t* pRxLength = pRecLength; uint8_t* pBuff = pData; 上海移远通信技术股份有限公司 24 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 uint8_t i2c_master_receive_error_counter = 0; I2c_Resp_FlagStatus status; //step 1_a request_cmd[0] = (uint32_t)((uint32_t)(QUECTEL_I2C_SLAVE_CR_CMD << 16) | QUECTEL_I2C_SLAVE_TX_LEN_REG_OFFSET); request_cmd[1] = 4; i2c_master_receive_error_counter = 0; while(1) { delay_ms(10); status = I2c_Master_Transmit(QUECTEL_I2C_SLAVE_ADDRESS_CR_OR_CW << 1, (uint8_t *)request_cmd, QUECTEL_I2C_SLAVE_CMD_LEN); if(status == I2C_ACK) { break; } i2c_master_receive_error_counter++; if(i2c_master_receive_error_counter > MAX_ERROR_NUMBER) { return DEV_REP_ERROR; } } //step 1_b i2c_master_receive_error_counter = 0; while(1) { delay_ms(10); status = I2c_Master_Receive(QUECTEL_I2C_SLAVE_ADDRESS_R << 1, (uint8_t*)pRxLength, 4); if(status == I2C_ACK) { break; } i2c_master_receive_error_counter++; if(i2c_master_receive_error_counter > MAX_ERROR_NUMBER) { return DEV_REP_ERROR; } } 上海移远通信技术股份有限公司 25 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 if(*pRxLength == 0) { return DEV_REP_ERROR; } if(*pRxLength > MAX_I2C_BUFFER) { *pRxLength = MAX_I2C_BUFFER; } //step 2_a request_cmd[0] = (uint32_t)(QUECTEL_I2C_SLAVE_CR_CMD << 16) | QUECTEL_I2C_SLAVE_TX_BUF_REG_OFFSET; request_cmd[1] = *pRxLength; i2c_master_receive_error_counter = 0; while(1) { delay_ms(10); status = I2c_Master_Transmit(QUECTEL_I2C_SLAVE_ADDRESS_CR_OR_CW << 1, (uint8_t *)request_cmd, QUECTEL_I2C_SLAVE_CMD_LEN); if(status == I2C_ACK) { break; } i2c_master_receive_error_counter++; if(i2c_master_receive_error_counter > MAX_ERROR_NUMBER) { *pRxLength = 0; return DEV_REP_ERROR; } } //step 2_b i2c_master_receive_error_counter = 0; while(1) { delay_ms(10); status = I2c_Master_Receive(QUECTEL_I2C_SLAVE_ADDRESS_R << 1, pBuff, *pRxLength); if(status == I2C_ACK) { return DEV_REP_SUCCESS; 上海移远通信技术股份有限公司 26 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 } i2c_master_receive_error_counter++; if(i2c_master_receive_error_counter > MAX_ERROR_NUMBER) { *pRxLength = 0; return DEV_REP_ERROR; } } return DEV_REP_SUCCESS; } Dev_Resp_FlagStatus Quectel_Dev_Transmit(uint8_t *pData, uint16_t dataLength) { uint32_t request_cmd[2]; uint16_t rxBuffLength = 0; uint8_t i2c_master_receive_error_counter = 0; I2c_Resp_FlagStatus status; //step 1_a request_cmd[0] = (uint32_t)((QUECTEL_I2C_SLAVE_CR_CMD << 16) | QUECTEL_I2C_SLAVE_RX_LEN_REG_OFFSET); request_cmd[1] = 4; i2c_master_receive_error_counter = 0; while(1) { delay_ms(10); status = I2c_Master_Transmit(QUECTEL_I2C_SLAVE_ADDRESS_CR_OR_CW << 1, (uint8_t *)request_cmd, QUECTEL_I2C_SLAVE_CMD_LEN); if(status == I2C_ACK) { break; } i2c_master_receive_error_counter++; if(i2c_master_receive_error_counter > MAX_ERROR_NUMBER) { return DEV_REP_ERROR; } } 上海移远通信技术股份有限公司 27 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 //step 1_b i2c_master_receive_error_counter = 0; while(1) { delay_ms(10); status = I2c_Master_Receive(QUECTEL_I2C_SLAVE_ADDRESS_R << 1, (uint8_t*)&rxBuffLength, 4); if(status == I2C_ACK) { break; } i2c_master_receive_error_counter++; if(i2c_master_receive_error_counter > MAX_ERROR_NUMBER) { return DEV_REP_ERROR; } } if(dataLength > rxBuffLength) { return DEV_REP_ERROR; } //step 2_a request_cmd[0] = (uint32_t)(QUECTEL_I2C_SLAVE_CW_CMD << 16) | QUECTEL_I2C_SLAVE_RX_BUF_REG_OFFSET; request_cmd[1] = dataLength; i2c_master_receive_error_counter = 0; while(1) { delay_ms(10); status = I2c_Master_Transmit(QUECTEL_I2C_SLAVE_ADDRESS_CR_OR_CW << 1, (uint8_t *)request_cmd, QUECTEL_I2C_SLAVE_CMD_LEN); if(status == I2C_ACK) { break; } i2c_master_receive_error_counter++; if(i2c_master_receive_error_counter > MAX_ERROR_NUMBER) { return DEV_REP_ERROR; } 上海移远通信技术股份有限公司 28 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 } //step 2_b i2c_master_receive_error_counter = 0; while(1) { delay_ms(10); status = I2c_Master_Transmit(QUECTEL_I2C_SLAVE_ADDRESS_W << 1, pData, dataLength); if(status == I2C_ACK) { return DEV_REP_SUCCESS; } i2c_master_receive_error_counter++; if(i2c_master_receive_error_counter > MAX_ERROR_NUMBER) { return DEV_REP_ERROR; } } return DEV_REP_SUCCESS; } 上海移远通信技术股份有限公司 29 / 30 LC29H 系列&LC79H (AL) I2C 应用指导 7 附录 参考文档及术语缩写 表 2：参考文档 文档名称 [1] Quectel_LC29H 系列&LC79H(AL)_GNSS_协议规范 表 3：术语缩写 缩写 英文全称 ACK Acknowledge GNSS Global Navigation Satellite System I2C Inter-integrated Circuit LSB Least Significant Bit MCU Microcontroller Unit MSB Most Significant Bit NAK/NACK Negative Acknowledgement NMEA NMEA (National Marine Electronics Association) 0183 Interface Standard SCL Serial Clock SDA Serial Data 中文全称 应答信号 全球导航卫星系统 集成电路总线 最低有效位 微型控制单元 最高有效位 非应答信号 NMEA（美国国家海洋电子协会）0183 接口标准 串行时钟 串行数据 上海移远通信技术股份有限公司 30 / 30

LC29D DR&RTK(2) Application Note GNSS Module Series Version: 1.0 Date: 2021-06-21 Status: Released GNSS Module Series Our aim is to provide customers with timely and comprehensive service. For any assistance, contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, visit: http://www.quectel.com/support/technical.htm Or send an 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 the use of or reliance upon the information. All information supplied herein is subject to change without prior notice. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without prior written consent by Quectel. Quectel reserves the right to take legal action for any noncompliance with the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information. LC29D_DR&RTK(2)_Application_Note 1 / 27 GNSS Module Series Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission is forbidden. 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. 2021. All rights reserved. LC29D_DR&RTK(2)_Application_Note 2 / 27 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LC29D DR&RTK(2) Application Note GNSS Module Series Application Note Released Revision History Version Date - 2021-06-21 1.0 2021-06-21 Description Creation of the document First official release. LC29D_DR&RTK(2)_Application_Note 3 / 27 GNSS Module Series Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 2 Configuration........................................................................................................................................ 8 2.1. Orientation................................................................................................................................... 8 2.2. Mounting...................................................................................................................................... 8 2.3. DR Calibration........................................................................................................................... 10 2.4. RTCM Input ............................................................................................................................... 10 3 Messages ............................................................................................................................................ 11 3.1. PQTM Messages ...................................................................................................................... 11 3.1.1. PQTMSOL...................................................................................................................... 11 3.1.2. PQTMALT....................................................................................................................... 14 3.1.3. PQTMGNSSFIX ............................................................................................................. 15 3.1.4. PQTMMEAS................................................................................................................... 16 3.1.5. PQTMSF ........................................................................................................................ 16 3.1.6. PQTMSNR,21 ................................................................................................................ 16 3.1.7. PQTMSNR,23 ................................................................................................................ 17 3.1.8. PQTMSRAW .................................................................................................................. 18 3.1.9. PQTMEND ..................................................................................................................... 19 3.1.10. PQTMSETDRMODE...................................................................................................... 20 3.1.11. PQTMGETDRMODE ..................................................................................................... 21 3.1.12. PQTMSETNMEAMSGMASK ......................................................................................... 21 3.1.13. PQTMGETNMEAMSGMASK ........................................................................................ 22 3.1.14. PQTMVEHMSG ............................................................................................................. 23 3.1.14.1. Vehicle Speed Message ( = 1)............................................................. 24 3.1.14.2. Vehicle Wheel Tick Message ( = 2) ..................................................... 25 3.1.15. PQTMSAVEPAR ............................................................................................................ 25 3.1.16. PQTMRESTOREPAR .................................................................................................... 26 4 Appendix A References..................................................................................................................... 27 LC29D_DR&RTK(2)_Application_Note 4 / 27 GNSS Module Series Table Index Table 1: Supported RTCM Input Messages ............................................................................................... 10 Table 2: Related Documents ...................................................................................................................... 27 Table 3: Terms and Abbreviations .............................................................................................................. 27 LC29D_DR&RTK(2)_Application_Note 5 / 27 GNSS Module Series Figure Index Figure 1: Module Orientation........................................................................................................................ 8 Figure 2: Yaw Angle ..................................................................................................................................... 9 Figure 3: Pitch and Roll Angles .................................................................................................................... 9 LC29D_DR&RTK(2)_Application_Note 6 / 27 GNSS Module Series 1 Introduction The dead reckoning (DR) and real-time kinematic (RTK) features, mounting, calibration, and messages related to DR and RTK of Quectel LC29D module are described in this document. This document is applicable to the following variants of Quectel LC29D module: ⚫ LC29D (E) ⚫ LC29D (F) LC29D_DR&RTK(2)_Application_Note 7 / 27 2 Configuration 2.1. Orientation The orientation of the module is shown below: GNSS Module Series Z Figure 1: Module Orientation 2.2. Mounting LC29D supports free-mounting feature, which means that the device incorporating Quectel LC29D module can be mounted on a vehicle in any orientation, but one axis must be in line with the forward direction of the vehicle and another axis perpendicular to the ground. LC29D_DR&RTK(2)_Application_Note 8 / 27 Forward α GNSS Module Series Figure 2: Yaw Angle Forward β Figure 3: Pitch and Roll Angles When mounting the Quectel LC29D module, make sure that -15°≤ β ≤ 15°. There is no restriction on yaw angle (0°≤ α ≤ 360°). LC29D_DR&RTK(2)_Application_Note 9 / 27 GNSS Module Series 2.3. DR Calibration DR calibration steps: Step 1: Fix the module on the vehicle frame. Any displacement, turn or tilt of the device, however small, will cause performance issues and/or void calibration. Step 2: Calibration should be performed under good GNSS signal and clear sky conditions. Step 3: Power up the module, then start the vehicle on a plain surface and keep it still for at least 30 s. Step 4: Start driving the vehicle under good GNSS signal conditions. The module will start self-calibration, which would be completed in a few minutes. Step 5: The calibration process ends when the of $PQTMSOL message indicates a combined solution. See Chapter 3.1.1 for details about the message. 2.4. RTCM Input Quectel LC29D (E) module supports the RTCM version 3.3 input messages listed in table below. Table 1: Supported RTCM Input Messages Message Type 1005 1006 1074 1124 Description Stationary RTK Reference Station ARP Stationary RTK Reference Station ARP with Antenna Height GPS MSM4 BeiDou MSM4 ⚫NOTE Quectel LC29D (F) module does not support RTCM input messages. LC29D_DR&RTK(2)_Application_Note 10 / 27 GNSS Module Series 3 Messages 3.1. PQTM Messages This chapter introduces the PQTM messages (proprietary NMEA messages defined by Quectel) supported by Quectel LC29D (E, F) module. 3.1.1. PQTMSOL This message outputs navigation results. Type: Output. Synopsis: $PQTMSOL,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit Year Month Day Hour Minute Description Fixed as 1. UTC Year. UTC Month. UTC Day. UTC Hour. UTC Minute. LC29D_DR&RTK(2)_Application_Note 11 / 27 GNSS Module Series Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric ms ms Week ms - Degree Degree cm cm cm/s cm/s cm/s cm/s cm Degree Degree Degree - UTC Millisecond. Milliseconds since power on. 32-bit unsigned integer. GPS week number, including rollover. Time of week. Navigation mode. 0 = No navigation. Bit 0: Reserved. Bit 1: GNSS only. Bit 2: DR only. Bit 3: Combined solution (GNSS + DR). Bit 4-8: Reserved. Bit 9: Odometer (Wheel Tick) in use. Bit 10,11: Reserved. Bit 12: DGNSS (Not include satellite-based correction source). Bit 13: RTK in use, fixed. Bit 14: RTK in use, float. Bit 15–31: Reserved. Latitude. Scaled by 10^7. Longitude. Scaled by 10^7. Ellipsoidal height. Height above mean sea level. Northward velocity. Eastward velocity. Downward velocity. Speed over ground. Traveled distance since power on. Roll, scaled by 100. Pitch, scaled by 100. Heading, scaled by 100. Motion status. 0 = Unknow. Bit 0: Stationary. LC29D_DR&RTK(2)_Application_Note 12 / 27 GNSS Module Series Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric cm cm cm cm/s cm/s cm/s Degree Degree Degree Degree Degree Degree - Second - - Bit 1: In moving. Bit 2: Dramatic accelerating or decelerating. Bit 3: Sharp turning. Bit 4: Falling or flip over. Bit 5: Collision. Bit 6–31: Reserved. Reserved. Uncertainty of position in northward direction. Uncertainty of position in eastward direction. Uncertainty of position in downward direction. Northward velocity uncertainty. Eastward velocity uncertainty. Downward velocity uncertainty. Roll uncertainty, scaled by 100. Pitch uncertainty, scaled by 100. Yaw uncertainty, scaled by 100. Roll angle misalignment, scaled by 100. Pitch angle misalignment, scaled by 100. Yaw angle misalignment, scaled by 100. Reference Station ID. Only supported in RTK mode. Seconds since last differential correction. Only supported in RTK mode. Reserved. Only available for RTK mode. Reserved. Only available for RTK mode. Example: //DR only mode: $PQTMSOL,1,2021,1,19,12,1,58000,743400,2141,216136000,2,318220478,1171152086,5223,5584,-1, 0,1,1,1482,-791,614,0,0,5000,311,311,440,100,100,282,13,10,10,0,0,0*6B //DR + RTK mode: $PQTMSOL,1,2021,3,5,11,35,30000,14699500,2147,473748000,16386,318220502,1171152312,5203,5 565,0,0,0,0,0,-19,-66,0,0,5000,277,293,413,200,200,565,10,10,10,0,0,0,1941,1,13,2*50 LC29D_DR&RTK(2)_Application_Note 13 / 27 GNSS Module Series 3.1.2. PQTMALT This message outputs attitude status. Type: Output. Synopsis: $PQTMALT,,,,,,,,,,* Parameter: Field Format Unit Numeric - Numeric - Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric m/s2 deg/s deg/s deg/s deg/s m/s2 m/s2 m/s2 Description Fixed as 1. Alert. 0 = No alert. Bit 0: Dramatic accelerating. Threshold: > 2.5 m/s2. Bit 1: Dramatic decelerating. Threshold: < -4.5 m/s2. Bit 2: Sharp turning. Threshold: > 45 deg/s. Bit 3–31: Reserved. Peak acceleration, scaled by 100. Peak angular velocity, scaled by 10. X-axis angular velocity of gyroscope, scaled by 10. Y-axis angular velocity of gyroscope, scaled by 10. Z-axis angular velocity of gyroscope, scaled by 10. X-axis acceleration of accelerometer, scaled by 100. Y-axis acceleration of accelerometer, scaled by 100. Z-axis acceleration of accelerometer, scaled by 100. Example: $PQTMALT,1,0,0.40,0.24,0.13,0.13,0.16,24.86,19.67,-980.61*6F LC29D_DR&RTK(2)_Application_Note 14 / 27 GNSS Module Series 3.1.3. PQTMGNSSFIX This message outputs the positioning information in GNSS only mode. Type: Output. Synopsis: $PQTMGNSSFIX,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Year Month Day Hour Minute Second Week ms Degree Degree cm cm/s Degree cm Description Fixed as 6. UTC Year. UTC Month. UTC Day. UTC Hour. UTC Minute. UTC Second. GPS week number, including rollover. Time of week. Number of satellites in use. Latitude. Scaled by 10^7. Longitude. Scaled by 10^7. Ellipsoidal height. Speed over ground. Heading. Scaled by 100. Horizontal accuracy. LC29D_DR&RTK(2)_Application_Note 15 / 27 GNSS Module Series Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric - cm/s cm/s cm/s cm cm/s cm cm cm cm/s cm/s cm/s Seconds cm - Northward velocity. Eastward velocity. Downward velocity. Clock bias. Clock drift. Uncertainty of position in northward direction. Uncertainty of position in eastward direction. Uncertainty of position in downward direction. Northward velocity uncertainty. Eastward velocity uncertainty. Downward velocity uncertainty. Leap seconds. Reserved. Height above mean sea level. Reserved. Example: $PQTMGNSSFIX,6,2021,6,14,7,26,54,2162,113232000,26,318222148,1171152179,5846,1,18069,354,0 ,0,0,19,3,250,250,1096,12,12,12,18,0,6208,1*6D 3.1.4. PQTMMEAS This message outputs information for Quectel’s internal debugging purpose only. 3.1.5. PQTMSF This message outputs information for Quectel’s internal debugging purpose only. 3.1.6. PQTMSNR,21 This message outputs sensor data. LC29D_DR&RTK(2)_Application_Note 16 / 27 GNSS Module Series Type: Output. Synopsis: $PQTMSNR,21,[,,,,,,< Y_ACC>,,,]* Parameter: Field Format Unit Description Numeric - Repeat number of data set. Start of repeat block. Repeat times: 0–. Numeric ms Milliseconds since power on. 32-bit unsigned integer. Numeric Deg/s X-axis angular velocity of gyroscope, scaled by 1000. Numeric Deg/s Y-axis angular velocity of gyroscope, scaled by 1000. Numeric Deg/s Z-axis angular velocity of gyroscope, scaled by 1000. Numeric m/s2 X-axis acceleration of accelerometer, scaled by 1000. Numeric m/s2 Y-axis acceleration of accelerometer, scaled by 1000. Numeric m/s2 Z-axis acceleration of accelerometer, scaled by 1000. Numeric m/s Numeric - End of repeat block. Vehicle speed, scaled by 100. 0 = Forward 1 = Reverse Example: $PQTMSNR,21,10,742500,461,-696,-358,1053,-1385,9744,0,0,742600,455,-696,-363,1050,-1388,9744, 0,0,742700,468,-700,-337,1053,-1389,9745,0,0,742800,458,-693,-341,1051,-1386,9745,0,0,742900,427 ,-705,-349,1053,-1385,9745,0,0,743000,446,-685,-355,1051,-1388,9745,0,0,743100,448,-675,-345,1051 ,-1387,9744,0,0,743200,443,-682,-332,1053,-1388,9745,0,0,743300,444,-700,-339,1050,-1389,9745,0,0 ,743400,472,-684,-355,1051,-1387,9745,0,0*5E 3.1.7. PQTMSNR,23 This message outputs sensor data. LC29D_DR&RTK(2)_Application_Note 17 / 27 GNSS Module Series Type: Output. Synopsis: $PQTMSNR,23,,,,,,< Y_ACC>,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit ms Deg/s Deg/s Deg/s m/s2 m/s2 m/s2 Description Milliseconds since power on. 32-bit unsigned integer. X-axis angular velocity of gyroscope, scaled by 1000. Y-axis angular velocity of gyroscope, scaled by 1000. Z-axis angular velocity of gyroscope, scaled by 1000. X-axis acceleration of accelerometer, scaled by 1000. Y-axis acceleration of accelerometer, scaled by 1000. Z-axis acceleration of accelerometer, scaled by 1000. Example: $PQTMSNR,23,3100,399,-519,-454,466,-511,9906*45 $PQTMSNR,23,3200,394,-500,-471,470,-509,9902*4E 3.1.8. PQTMSRAW This message outputs filtered and bias compensated sensor data. Type: Output. Synopsis: $PQTMSRAW,,[,,,,,, ,]* LC29D_DR&RTK(2)_Application_Note 18 / 27 GNSS Module Series Parameter: Field Format Unit Description Numeric - Fixed as 53. Numeric - Repeat number of data set. Start of repeat block. Repeat times: 0–. Numeric ms Milliseconds since power on. 32-bit unsigned integer. Numeric Deg/s X-axis angular velocity of gyroscope. Numeric Deg/s Y-axis angular velocity of gyroscope. Numeric Deg/s Z-axis angular velocity of gyroscope. Numeric m/s2 X-axis acceleration of accelerometer. Numeric m/s2 Y-axis acceleration of accelerometer. Numeric m/s2 Z-axis acceleration of accelerometer. End of repeat block. Example: $PQTMSRAW,53,10,742500,0.015,0.009,0.012,1.044,1.330,-9.666,742600,0.009,0.009,0.017,1.041,1.3 33,-9.666,742700,0.022,0.013,-0.009,1.044,1.334,-9.667,742800,0.012,0.006,-0.005,1.042,1.331,-9.667 ,742900,-0.019,0.018,0.003,1.044,1.330,-9.667,743000,0.000,-0.002,0.009,1.042,1.333,-9.667,743100,0 .002,-0.012,-0.001,1.042,1.332,-9.666,743200,-0.003,-0.005,-0.014,1.044,1.333,-9.667,743300,-0.002,0. 013,-0.007,1.041,1.334,-9.667,743400,0.026,-0.003,0.009,1.042,1.332,-9.667*0B 3.1.9. PQTMEND This message outputs the end of an epoch. Type: Output. Synopsis: $PQTMEND,,* LC29D_DR&RTK(2)_Application_Note 19 / 27 Parameter: Field Format Unit Numeric - Numeric - Example: $PQTMEND,255,255*57 Description Fixed as 255. Fixed as 255. GNSS Module Series 3.1.10. PQTMSETDRMODE This message sets the vehicle information input method for DR mode. Type: Set. Synopsis: $PQTMSETDRMODE,* Parameter: Field Format Numeric Unit Description 0 = No vehicle information input. UDR mode. 2 = Input vehicle speed or wheel tick through UART. 3 = Input vehicle information through hardware wheel tick interface (default). Result: If successful, the module returns: $PQTMSETDRMODEOK*4B If failed, the module returns: $PQTMSETDRMODEERROR*17 Example: $PQTMSETDRMODE,2*51 $PQTMSETDRMODEOK*4B LC29D_DR&RTK(2)_Application_Note 20 / 27 GNSS Module Series 3.1.11. PQTMGETDRMODE This message gets the vehicle information input method for DR mode. Type: Get. Synopsis: $PQTMGETDRMODE* Result: If successful, the module returns: $PQTMDRMODE,* Field Format Numeric Unit Description 0 = No vehicle information input. UDR mode. - 2 = Input vehicle speed or wheel tick through UART. 3 = Input vehicle information through hardware wheel tick interface. If failed, the module returns: $PQTMGETDRMODEERROR*03 Example: $PQTMGETDRMODE*5B $PQTMDRMODE,2*13 3.1.12. PQTMSETNMEAMSGMASK This message sets the NMEA message mask. Type: Set. Synopsis: $PQTMSETNMEAMSGMASK,* LC29D_DR&RTK(2)_Application_Note 21 / 27 GNSS Module Series Parameter: Field Format Unit Hexadecimal - Description Message mask. Setting a bit to 0 disables the message output. Setting a bit to 1 enables the message output. Bit 31: Reserved Bit 30: PQTMVEHMSG Bit 29: PQTMSOL Bit 28: PQTMSNR,21 Bit 27: PQTMSNR,23 Bit 26: PQTMSRAW,53 Bit 25: PQTMGNSSFIX,6 Bit 24: PQTMEND Bit 23: PQTMMEAS,3 Bit 22: PQTMMEAS,4 Bit 21: PQTMMEAS,9 Bit 20: PQTMSF Bit 19: PQTMALT Bit 18–0: Reserved Result: If successful, the module returns: $PQTMSETNMEAMSGMASKOK*14 If failed, the module returns: $PQTMSETNMEAMSGMASKERROR*48 Example: $PQTMSETNMEAMSGMASK,0x7FF00000*73 $PQTMSETNMEAMSGMASKOK*14 3.1.13. PQTMGETNMEAMSGMASK This message gets the NMEA message mask. Type: Get. Synopsis: $PQTMGETNMEAMSGMASK* LC29D_DR&RTK(2)_Application_Note 22 / 27 GNSS Module Series Parameter: None. Result: If successful, the module returns: $PQTMNMEAMSGMASK,* Field Format Unit Hexadecimal - If failed, the module returns: $PQTMGETNMEAMSGMASKERROR*5C Example: $PQTMGETNMEAMSGMASK*04 $PQTMNMEAMSGMASK,0x3FF00000*35 Description Message mask. Setting a bit to 0 disables the message output. Setting a bit to 1 enables the message output. Bit 31: Reserved Bit 30: PQTMVEHMSG Bit 29: PQTMSOL Bit 28: PQTMSNR,21 Bit 27: PQTMSNR,23 Bit 26: PQTMSRAW,53 Bit 25: PQTMGNSSFIX,6 Bit 24: PQTMEND Bit 23: PQTMMEAS,3 Bit 22: PQTMMEAS,4 Bit 21: PQTMMEAS,9 Bit 20: PQTMSF Bit 19: PQTMALT Bit 18–0: Reserved 3.1.14. PQTMVEHMSG This message inputs/outputs vehicle infomation. Type: Output/Input. LC29D_DR&RTK(2)_Application_Note 23 / 27 GNSS Module Series Synopsis: $PQTMVEHMSG,,,[,]* Parameter: Field Format Unit Numeric - Numeric ms - - Description Message ID. 1 = Input/Output vehicle speed 2 = Input/Output vehicle wheel tick Milliseconds since power on. 32-bit unsigned integer. While inputting vehicle information, keep this field as 0. This field varies with the message ID. See Chapter 3.1.14.1 and Chapter 3.1.14.2 for details. 3.1.14.1. Vehicle Speed Message ( = 1) Type: Input/Output Synopsis: $PQTMVEHMSG,1,,* Parameter: Field Format Unit Numeric ms Numeric m/s Description Milliseconds since power on. 32-bit unsigned integer. While inputting vehicle speed, keep this field as 0. Vehicle speed. A minus value indicates reverse speed. Range: -100 to 100. Example: $PQTMVEHMSG,1,0,3.6*1C $PQTMVEHMSG,1,3748292,3.600000*2D NOTE Make sure the input rate is at least 10 Hz. LC29D_DR&RTK(2)_Application_Note 24 / 27 GNSS Module Series 3.1.14.2. Vehicle Wheel Tick Message ( = 2) Type: Input/Output Synopsis: $PQTMVEHMSG,2,,,* Parameter: Field Format Numeric Numeric Numeric Unit Description Milliseconds since power on. 32-bit unsigned integer. ms While inputting cumulative wheel ticks, keep this field as 0. - Cumulative wheel ticks Forward/Reverse indicator. 0 = Invalid state 1 = Forward 2 = Reverse Example: //Input cumulative wheel ticks $PQTMVEHMSG,2,0,20,1*2B //Result: output cumulative wheel ticks with timestamp $PQTMVEHMSG,2,86500631,20,1*14 NOTE Make sure the input rate is at least 10 Hz. 3.1.15. PQTMSAVEPAR This message saves command settings to the NVM. Type: Command. Synopsis: $PQTMSAVEPAR* LC29D_DR&RTK(2)_Application_Note 25 / 27 Parameter: None. Result: If successful, the module returns: $PQTMSAVEPAROK*5E If failed, the module returns: $PQTMSAVEPARERROR*02 Example: $PQTMSAVEPAR*5A $PQTMSAVEPAROK*5E 3.1.16. PQTMRESTOREPAR This message restores all command settings to default values. Type: Command. Synopsis: $PQTMRESTOREPAR* Parameter: None. Result: If successful, the module returns: $PQTMRESTOREPAROK*17 If failed, the module returns: $PQTMRESTOREPARERROR*4B Example: $PQTMRESTOREPAR*13 $PQTMRESTOREPAROK*17 LC29D_DR&RTK(2)_Application_Note GNSS Module Series 26 / 27 GNSS Module Series 4 Appendix A References Table 2: Related Documents Document Name [1] Quectel_LC29D_Protocol_Specification [2] Quectel_LC29D_Hardware_Design Table 3: Terms and Abbreviations Abbreviation ARP DR GNSS MSM4 NMEA NVM PQTM RTCM RTK UART UDR UTC Description Antenna Reference Point Dead Reckoning Global Navigation Satellite System Type 4 Multiple Signal Messages NMEA (National Marine Electronics Association) 0183 Interface Standard Non-Volatile Memory Proprietary Quectel Message Radio Technical Commission for Maritime Services Real Time Kinematic Universal Asynchronous Receiver/Transmitter Untethered Dead Reckoning Coordinated Universal Time LC29D_DR&RTK(2)_Application_Note 27 / 27

EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 LTE Standard 模块系列 版本：1.1 日期：2023-11-16 状态：受控文件 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 作者 2020-04-22 Chavis CHEN/ Domingo DENG/ Larson LI 2023-11-16 Mario CHEN / Chavis CHEN/ Domingo DENG/ Larson LI 变更表述 文档创建 1. 新增适用模块 EG21-GL 和 EG25-GL； 更新 EC20 R2.1 为 EC20-CE； 删除适用模块 EP200F-CE（第 1 章）。 2. 更新 AT+QMTCFG=?命令的功能配置响应； 更新 AT+QMTCFG='aliauth',[,,,]参数名称 （第 3.2.1 章）。 3. AT+QMTCFG 新增以下子命令（第 3.2.1 章）： ⚫ AT+QMTCFG='send/mode',[,] ⚫ AT+QMTCFG='hwauth',[,,] ⚫ AT+QMTCFG='hwprodid',[,,,] ⚫ AT+QMTCFG='protocol/check',[,] 4. 新增以下命令生效和参数保存机制的说明（第 3.2 章）： ⚫ AT+QMTOPEN ⚫ AT+QMTCLOSE ⚫ AT+QMTCONN ⚫ AT+QMTDISC ⚫ AT+QMTSUB ⚫ AT+QMTUNS ⚫ AT+QMTPUBEX ⚫ AT+QMTRECV 5. 更新 AT+QMTDISC 中参数取值及相关备注 （第 3.2.5 章）。 上海移远通信技术股份有限公司 3 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 6. 新增 AT+QMTPUB（第 3.2.9 章）。 7. 新增 AT+QMTRECV 最大响应时间（第 3.2.10 章）。 8. 更新 AT+QMTDISC 举例（第 5 章）。 上海移远通信技术股份有限公司 4 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 5 表格索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 MQTT 数据交互..................................................................................................................................... 8 3 MQTT 相关 AT 命令.............................................................................................................................. 9 3.1. AT 命令语句................................................................................................................................ 9 3.1.1. 定义 ................................................................................................................................. 9 3.1.2. AT 命令语句..................................................................................................................... 9 3.2. MQTT 相关 AT 命令描述 .......................................................................................................... 10 3.2.1. AT+QMTCFG 配置 MQTT 可选参数........................................................................... 10 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 .................................................................... 17 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 .................................................................. 18 3.2.4. AT+QMTCONN 连接客户端到 MQTT 服务器............................................................. 18 3.2.5. AT+QMTDISC 客户端断开与 MQTT 服务器的连接.................................................... 20 3.2.6. AT+QMTSUB 订阅主题 .............................................................................................. 21 3.2.7. AT+QMTUNS 退订主题 .............................................................................................. 22 3.2.8. AT+QMTPUBEX 发布消息（数据模式） ................................................................... 23 3.2.9. AT+QMTPUB 发布消息（命令模式） ........................................................................ 24 3.2.10. AT+QMTRECV 从缓存中读取消息 ............................................................................. 26 4 MQTT 相关 URC ................................................................................................................................. 27 4.1. +QMTSTAT MQTT 链路层状态变化的 URC.......................................................................... 27 4.2. +QMTRECV 通知 Host 读取 MQTT 数据包的 URC .............................................................. 28 4.3. +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC ........................................................ 29 5 举例 ..................................................................................................................................................... 30 5.1. 无 SSL 的 MQTT 操作举例....................................................................................................... 30 5.2. 含 SSL 的 MQTT 操作举例....................................................................................................... 32 6 附录 参考文档及术语缩写 .................................................................................................................. 35 上海移远通信技术股份有限公司 5 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令及响应类型............................................................................................................................. 9 表 3：MQTT 相关的 URC........................................................................................................................... 27 表 4：URC 中的错误码 .............................................................................................................................. 28 表 5：参考文档 ........................................................................................................................................... 35 表 6：术语缩写 ........................................................................................................................................... 35 上海移远通信技术股份有限公司 6 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 1 引言 MQTT 是基于代理的发布/订阅模式通讯协议，具有开放、简单、轻量和易于实现的特点。MQTT 最大 优点在于，可以以极少的代码和有限的网络带宽，为连接远程设备提供实时可靠的消息服务。 该文档主要介绍如何通过 AT 命令使用移远通信 EC2x、EG2x、EG9x 和 EM05 系列模块的 MQTT 功 能。 本文档主要适用于以下移远通信模块： 表 1：适用模块 模块系列 EC2x EG2x EG9x - 模块 EC21 系列 EC25 系列 EC20-CE EC20-CN EG21-G EG25-G EG21-GL EG25-GL EG91 系列 EG95 系列 EM05 系列 上海移远通信技术股份有限公司 7 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 2 MQTT 数据交互 本章节主要介绍 MQTT 功能的数据交互机制。 MCU Modem Link layer MQTT Server 接收URC格式的 PUBLISH消息 AT+QMTCFG='will',, AT+QMTCFG='timeout',, AT+QMTOPEN=,'', OK TCP-REQ +QMTOPEN: , AT+QMTCONN AT+QMTCONN=,'', OK +QMTCONN: ,[,] TCP established CONN-REQ Start timer T1, T2 CONN ACK-IND Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK Send connect packet Receive connect ACK packet AT+QMTSUB AT+QMTSUB=,,... OK +QMTSUB:,,[,] SUB-REQ () Start timer T1 SUB ACK-IND () Stop T1 or handle Excep2 Send subscribe packet Receive subscribe ACK packet AT+QMTUNS AT+QMTUNS=,,... OK UNS-REQ () Start timer T1 +QMTUNS: ,,[,] AT+QMTPUBEX=,,=0,,'', OK UNS ACK-IND () Stop T1 or handle Excep2 PUB-REQ AT+QMTPUBEX AT+QMTPUBEX=,,=1,<ret (=1) ain>,'', OK PUB-REQ () Start timer T1 PUB ACK-IND () +QMTPUBEX: ,,[,] Stop T1 or handle Excep2 Send unsubscribe packet Receive unsubscribe ACK packet Send publish packet Send publish packet Receive publish ACK packet AT+QMTPUBEX AT+QMTPUBEX=,,=2,<ret (=2) ain>,'', OK PUB-REQ () Start timer T1 PUB REC-IND () Stop T1 or handle Excep2 PUB REL-REQ () Start timer T1 PUB COMP-IND () +QMTPUBEX: ,,[,] Stop T1 or handle Excep2 Send publish packet Receive publish receive packet Send publish release packet Receive publish complete packet T1是数据包重传超 时时间 T2是保活定时器 在T2时间段内若没 有数据相关消息， 客户端将发送 PINGREQ数据包 Excep1： 断开TCP连接 Excep2： 重发数据包直到 达到允许上限。 可通过命令 AT+QMTCFG设 置重传次数。 通过命令 AT+QMTCFG配置是 否上报超时信息 Receive PUB-IND () +QMTRECV: ,,'','' PUB ACK/REC-REQ () Reply accor.d..ing to AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , DISC-REQ TCP-REQ TCP disconnected Receive publish packet Send publish reply packet Send disconnect packet TCP discon..n. ect request 注意： 指的是可选参数。更多 关于可选参数的详细信息，请参考 第 3.2.1章 AT命令对应的描述。 图 1：MQTT 数据交互机制 上海移远通信技术股份有限公司 8 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 3 MQTT 相关 AT 命令 本章节主要介绍 MQTT 功能的相关 AT 命令。 3.1. AT 命令语句 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了， 仅显示命令和响应。 表 2：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 3.2. MQTT 相关 AT 命令描述 3.2.1. AT+QMTCFG 配置 MQTT 可选参数 该命令用于配置 MQTT 的可选参数。 AT+QMTCFG 配置 MQTT 可选参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'version',(支持的范围),(支持的 列表) +QMTCFG: 'pdpcid',(支持的范围),(支持的 范围) +QMTCFG: 'ssl',(支持的范围),(支持的列表),(支持的范围) +QMTCFG: 'keepalive',(支持的范围),(支持的范围) +QMTCFG: 'session',(支持的范围),(支持的列表) +QMTCFG: 'timeout',(支持的范围),(支持的范围),(支持的范围),(支持的列表) +QMTCFG: 'will',(支持的范围),(支持的 列表),(支持的范围),(支持的列表),'willt opic','willmessage' +QMTCFG: 'willex',( 支 持 的 范 围 ),( 支 持 的 列表),(支持的范围),(支持的列 表),'willtopic',(支持的范围) +QMTCFG: 'recv/mode',(支持的范围),(支持的< msg_recv_mode>列表),(支持的列表) +QMTCFG: 'send/mode',(支持的范围),(支持的< msg_send_mode>列表) +QMTCFG: 'aliauth',(支持的范围),'product key ','device name','device secret' +QMTCFG: 'hwauth',(支持的范围),'device id',' device secret' +QMTCFG: 'hwprodid',(支持的范围),'product i d','product secret','nodeid' +QMTCFG: 'qmtping',(支持的范围),(支持的范围) +QMTCFG: 'protocol/check',(支持的范围),(支持 的列表) OK 上海移远通信技术股份有限公司 10 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 设置命令 配置 MQTT 协议版本 AT+QMTCFG='version',[,] 响应 若省略，则查询 MQTT 协议版本： +QMTCFG: 'version', OK 设置命令 配置 MQTT 客户端待使用的 PDP AT+QMTCFG='pdpcid',[,] 若指定且 MQTT 连接未创建，配置 MQTT 协议版本： OK 或者 ERROR 响应 若省略，则查询当前 MQTT 客户端使用的 PDP： +QMTCFG: 'pdpcid', OK 设置命令 配置 Will 信息 AT+QMTCFG='will',[, [,, ,,]] 若指定且 MQTT 连接未创建，配置 MQTT 客户端使用的 PDP： OK 或者 ERROR 响应 若省略、、、和 ，则查询当前 Will 配置信息： +QMTCFG: 'will',[,,,,] OK 设置命令 配置 Will 信息 AT+QMTCFG='willex',[,,,,,] 若指定、、、和 且 MQTT 连接未创建，配置 Will 信息： OK 或者 ERROR 响应 若省略、、、和 ，则查询当前 Will 配置信息： +QMTCFG: 'willex',,[,,,] OK 若指定、、、和 ，配置 Will 信息： 上海移远通信技术股份有限公司 11 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 设置命令 配置消息传输超时时间 AT+QMTCFG='timeout',[,,,< timeout_notice>] > 输入 Will 消息，若数据长度大于，则发送前面长度等于 的数据。 OK 或者 ERROR 响应 若省略、和，则 查询当前设置的消息传输超时时间： +QMTCFG: 'timeout',,, OK 设置命令 配置会话类型 AT+QMTCFG='session',[,] 若 指 定 、和 且 MQTT 连接未创建，配置消息传输的超时时间： OK 或者 ERROR 响应 若省略，则查询当前会话类型： +QMTCFG: 'session', OK 设置命令 配置保活时间 AT+QMTCFG='keepalive',[,] 若指定且 MQTT 连接未创建，配置会话类型： OK 或者 ERROR 响应 若省略，则查询当前保活时间： +QMTCFG: 'keepalive', OK 设置命令 配置 MQTT SSL 模式和 SSL 上下文 索引 AT+QMTCFG='ssl',[,< SSL_enable>,] 若指定且 MQTT 连接未创建，配置保活时间： OK 或者 ERROR 响应 若 省 略 和， 则查 询当 前 MQTT SSL 模式以及 SSL 上下文索引配置： +QMTCFG: 'ssl',[,] 上海移远通信技术股份有限公司 12 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 OK 设置命令 配置服务器数据的接收模式 AT+QMTCFG='recv/mode',[,[,]] 若指定和且 MQTT 连接未创建， 配置 MQTT SSL 模式以及 SSL 上下文索引： OK 或者 ERROR 响应 若省略和，则查询当前 MQTT 数据接收模式： +QMTCFG: 'recv/mode',, OK 设置命令 配置客户端数据的发送模式 AT+QMTCFG='send/mode',[,] 若指定和且 MQTT 连接 未创建，配置数据接收模式： OK 或者 ERROR 响应 若省略，则查询当前 MQTT 数据发送模式： +QMTCFG: 'send/mode', OK 设置命令 配置阿里云设备信息 AT+QMTCFG='aliauth',[,,,] 若指定且 MQTT 连接未创建，配置数据发送 模式： OK 或者 ERROR 响应 若省略、和，则查询设备信息： +QMTCFG: 'aliauth',,, OK 若指定、和且 MQTT 连接未创建，配置 Alibaba 设备信息： OK 或者 ERROR 上海移远通信技术股份有限公司 13 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 设置命令 配置华为云设备信息 AT+QMTCFG='hwauth',[,,] 响应 若省略和，则查询设备信息： +QMTCFG: 'hwauth',, OK 若指定和，且 MQTT 连接未创 建，配置华为云设备信息： OK 或者 ERROR 设置命令 配置华为云产品信息 AT+QMTCFG='hwprodid',<client_ 响应 若省略,和，则查询产 品信息： idx>[,,<product_secr +QMTCFG: 'hwprodid',,,,] odeid> OK 设置命令 设置 MQTT 因心跳超时而关闭连接的 最大保留时间 AT+QMTCFG='qmtping',[,] 若指定,和，且 MQTT 连接未创建，配置华为云产品信息： OK 或者 ERROR 响应 若省略，则查询当前配置： +QMTCFG: 'qmtping', OK 设置命令 设置 MQTT 协议检查 AT+QMTCFG='protocol/check',[,] 若指定且 MQTT 连接未建立，配置 MQTT 因 心跳超时而关闭连接的最大保留时间： OK 或者 ERROR 响应 若省略，则查询当前配置： +QMTCFG: 'protocol/check',, OK 若指定，且 MQTT 连接未创建，配置 协议检查功能： 上海移远通信技术股份有限公司 14 / 35 最大响应时间 特性说明 参数 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 整型。MQTT 客户端标识符。范围：0~5。 整型。MQTT 协议版本。 3 MQTT 协议 V3.1 4 MQTT 协议 V3.1.1 整型。MQTT 客户端待使用 PDP。范围：1~16；默认值：1。 整型。配置 Will flag。 0 无需配置 Will flag 1 需要配置 Will flag 整型。发送消息时的 QoS 级别。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。Will retain 标记只适用于 PUBLISH 消息。 0 当客户端发布一条 PUBLISH 消息到服务器，消息成功发送到当前订阅 者后，服务器不保留该消息 1 当客户端发布一条 PUBLISH 消息到服务器，消息成功发送到当前订阅 者后，服务器保留该消息 字符串型。Will Topic 名称。最大长度：256 字节。 字符串型。当客户端意外断开以后，该参数定义需要发布到 Will Topic 的消 息内容。最大长度：256 字节。 整型。Will 消息的长度。范围：0~256。 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。 整型。数据包传输超时后重发次数。范围：0~10；默认值：3。 整型。传输数据包时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器必须存储该客户端的订阅消息 1 服务器必须删除之前保留的客户端任何消息，此连接状态为'clean' 整型。保活时间。范围：0~3600；默认值：120；单位：秒。该参数定义从 客户端接收消息的最大间隔时间，在 1.5 倍的设置时间内，若服务器未从客 户端收到消息，则默认客户端发送了 DISCONNECT 消息，因此服务器会 断开客户端连接。 上海移远通信技术股份有限公司 15 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 0 表示不断开客户端连接 整型。配置 MQTT SSL 模式。 0 使用普通 TCP 连接 1 使用 SSL TCP 安全连接 整型。SSL 上下文索引。范围：0~5。 整型。配置 MQTT 消息接收模式。 0 从服务器接收的 MQTT 消息以 URC 的形式上报 1 从服务器接收的 MQTT 消息不以 URC 的形式上报 整型。配置 URC 中是否包含从服务器接收的 MQTT 消息长度。 0 不包含 1 包含 整型。配置 MQTT 消息发送模式。 0 发送到服务器的 MQTT 消息以 URC 的形式上报 1 发送到服务器的 MQTT 消息不以 URC 的形式上报 字符串型。阿里云发布的产品密钥。 字符串型。阿里云发布的设备名称。 字符串型。阿里云发布的设备校验凭证。 字符串型。华为云发布的设备名称。 字符串型。华为云发布的设备密钥。 字符串型。华为云发布的产品名称。 字符串型。华为云发布的产品密钥。 字符串型。华为云发布的产品设备识别码。 整型。MQTT 因心跳超时而关闭连接的最大保留时间。范围：5~60；默认 值：5；单位：秒。 整型。配置 MQTT 协议检查模式。 0 不检查协议 1 检查协议 备注 1. 若=1，那么必须指定，，和，否则以上 参数会被省略。 2. 只有当服务器支持存储会话操作时，=0 才有效。 3. 若 MQTT 连接配置为 SSL 模式，必须指定。另外，客户需要使用 AT+QSSLCFG 配 置 SSL 版本、加密套件、安全等级、CA 证书、客户端证书和客户端密钥，并忽略 RTC 时间，这些 在 MQTT SSL 握手过程中都会使用到。 4. 请确保数据在传输过程中不能超时。 5. AT+QMTCFG='aliauth'只用于阿里云，若已经配置，可以省略 AT+QMTCONN 中的 和。 上海移远通信技术股份有限公司 16 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 该命令用于为 MQTT 客户端打开网络。 AT+QMTOPEN 测试命令 AT+QMTOPEN=? 打开 MQTT 客户端网络 响应 +QMTOPEN: (支持的范围),'host_name',(支持 的范围) 查询命令 AT+QMTOPEN? OK 响应 [+QMTOPEN: ,,] 设置命令 AT+QMTOPEN=,, 最大响应时间 特性说明 OK 或者 ERROR 响应 OK +QMTOPEN: , 或者 ERROR 120 秒，受网络状态影响 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 字符串型。服务器地址，可以是 IP 地址或者域名。最大长度：100 字节。 整型。服务器端口。范围：1~65535。 整型。命令执行结果。 -1 打开网络失败 0 打开网络成功 1 参数错误 2 MQTT 标识符被占用 3 激活 PDP 失败 4 域名解析失败 5 网络断开导致错误 上海移远通信技术股份有限公司 17 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 该命令用于关闭 MQTT 客户端网络。 AT+QMTCLOSE 测试命令 AT+QMTCLOSE=? 关闭 MQTT 客户端网络 响应 +QMTCLOSE: (支持的范围) 设置命令 AT+QMTCLOSE= OK 响应 OK 最大响应时间 特性说明 +QMTCLOSE: , 或者 ERROR 30 秒 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。命令执行结果。 -1 关闭网络失败 0 关闭网络成功 3.2.4. AT+QMTCONN 连接客户端到 MQTT 服务器 当客户端请求连接 MQTT 服务器时使用该命令。当客户端创建和服务器之间的 TCP/IP Socket 连接时， 必须使用 CONNECT 流创建一个协议层会话。 AT+QMTCONN 连接客户端到 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: ( 支 持 的 范 围),'clientid','username','password' 查询命令 AT+QMTCONN? OK 响应 [+QMTCONN: ,] OK 或者 上海移远通信技术股份有限公司 18 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 ERROR 设置命令 AT+QMTCONN=,[,,] 响应 OK +QMTCONN: ,[,] 或者 ERROR 最大响应时间 参数值（默认 5 秒），受网络状态影响 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 字符串型。客户端标识符。 字符串型。客户端用户名，可用于授权。 字符串型。客户端用户名对应的密码，可用于授权。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 初始化 2 MQTT 正在连接 3 MQTT 已经连接成功 4 MQTT 正在断开连接 整型。连接状态返回码。 0 接受连接 1 拒绝连接：不接受的协议版本 2 拒绝连接：标识符被拒绝 3 拒绝连接：服务器不可用 4 拒绝连接：错误的用户名或密码 5 拒绝连接：未授权 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通 AT+QMTCFG ='timeout',[,,<retry_times,]配置超时 时间。 备注 若某一个客户端 ID 已经连接服务器端，另一个客户端使用相同 ID 重新连接，服务器必须断开原来的客户 端连接，而后才能进行新客户端的 CONNECT 流。 上海移远通信技术股份有限公司 19 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 3.2.5. AT+QMTDISC 客户端断开与 MQTT 服务器的连接 当客户端请求断开与 MQTT 服务器的连接时使用该命令。客户端发送 DISCONNECT 消息到服务器表 示即将与服务器断开 TCP/IP 连接。 AT+QMTDISC MQTT 服务器断开与客户端连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的范围) 设置命令 AT+QMTDISC= OK 响应 OK 最大响应时间 特性说明 +QMTDISC: , 或者 ERROR 30 秒 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。命令执行结果。 0 发送断开连接请求成功 2 发送断开连接请求失败 备注 当为 0，表示 DISCONNECT 消息已经成功发送到网络中，MQTT 连接准备关闭。此时会出现以 下两种情况： 1. 如 果 服 务 器 响 应 断 开 连 接 请 求 ， 并 且 成 功 断 开 连 接 ， 则 上 报 URC +QMTSTAT: ,，并且为 5。 2. 如果服务器未响应断开连接请求，则执行 AT+QMCLOSE 断开 MQTT 连接。 上海移远通信技术股份有限公司 20 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 3.2.6. AT+QMTSUB 订阅主题 该命令用于订阅一个或多个主题。客户端发送 SUBSCRIBE 消息向服务器订阅一个或多个主题，当订 阅主题发布消息时，服务器会把这些消息作为 PUBLISH 消息传输到客户端。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: ( 支 持 的 范 围 ),,list of ['topic',qos] 设置命令 AT+QMTSUB=, ,,[,, …] 最大响应时间 特性说明 OK 响应 OK +QMTSUB: ,,[,] 或者 ERROR ×（默认 15 秒），受网络状态影 响 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包标识符。范围：1~65535。 字符串型。客户端订阅或者退订的主题。 整型。客户端发布消息的 QoS 等级。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。 若=0，则作为已确认 QoS 等级的矢量； 若=1，则表示数据包重传次数； 若=2，则不显示。 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTCFG='timeout',[,,,]配置超时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 上海移远通信技术股份有限公司 21 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 备注 只有在固定报头中的 QoS 位显示 QoS 等级是 1 或者 2 的消息中才显示参数，在特定通信方向 中的一组飞行消息中必须唯一。一般来说该参数值根据消息数逐一增加，但实际情况无此要求。 3.2.7. AT+QMTUNS 退订主题 该命令用于退订一个或者多个主题。客户端向服务器发送 UNSUBSCRIBE 消息退订确定的主题。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: ( 支 持 的 范 围 ),,list of ['topic'] 设置命令 AT+QMTUNS=, ,[,…] 最大响应时间 特性说明 OK 响应 OK +QMTUNS: ,,[,] 或者 ERROR ×（默认 15 秒），受网络状态影 响 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包标识符。范围：1~65535。 字符串型。客户端想要订阅或者退订的主题。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。 若=0，则作为已确认 QoS 等级的矢量； 若=1，则表示数据包重传次数； 若=2，则不显示。 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTCFG='timeout',[,,,]配置超时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 上海移远通信技术股份有限公司 22 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 3.2.8. AT+QMTPUBEX 发布消息（数据模式） 客户端通过该命令可以发布定长消息到服务器，再由服务器分配到感兴趣的订阅者。每一个 PUBLISH 消息都关联一个主题名称，若一个客户端订阅了一个或者多个主题，当订阅主题发布消息时，服务器会把 这些消息作为 PUBLISH 消息传输到客户端。 AT+QMTPUBEX 发布消息（数据模式） 测试命令 AT+QMTPUBEX=? 响应 +QMTPUBEX: (支持的范围),,(支持的 范围),(支持的列表),'topic','length' 设置命令 OK 响应 AT+QMTPUBEX=, d>,,,,<msg_len 输入需要发送的数据，若数据实际长度大于， gth> 多出来的字节会被删除。 OK 最大响应时间 特性说明 +QMTPUBEX: ,,[,] 或者 ERROR × （默认 15 秒），受网络状态 影响 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包消息标识符。范围：0~65535；只有当=0 时；该参数值为 0。 整型。客户端想要发布消息时的 QoS 等级。 0 最多发送一次 1 最少发送一次 2 只发送一次 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 不保存 1 保存 字符串型。待发布主题。 整型。待发布消息数据长度。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK（当=0 时发布了数据，则无需 ACK） 1 数据包重传 2 数据包发送失败 上海移远通信技术股份有限公司 23 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 整型。 若=1，则表示数据包重传次数； 若=0 或者 2，则不显示此参数。 整型。数据传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTCFG ='timeout',[,,,]配置超 时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 备注 1. 若该命令执行成功并响应 OK，客户端可以继续发布新的数据包。传输数据包的最大数量不能大于滑 动窗口的大小（滑动窗口的大小为 5），否则会返回 ERROR。 2. 该命令执行后，客户端可发送数据即负载信息。每次输入数据的最大长度为 1500 字节。 3. 发布者可以发布 PUBLISH 消息到服务器，服务器也可以发布 PUBLISH 消息到订阅者。当服务器发 布 消 息 到 订 阅 者 时 ， 会 返 回 URC 通 知 host 读 取 MQTT 服 务 器 发 送 的 数 据 ： +QMTRECV: ,,[,],，关于 URC 描述的详细信息，请 参考第 4.2 章。 3.2.9. AT+QMTPUB 发布消息（命令模式） 客户端通过该命令可以发布指定消息或任意长度消息到服务器，再由服务器分配到感兴趣的订阅者。 每一个 PUBLISH 消息都关联一个主题名称，若一个客户端订阅了一个或者多个主题，当订阅主题发布消息 时，服务器会把这些消息作为 PUBLISH 消息传输到客户端。 AT+QMTPUB 发布消息（命令模式） 测试命令 AT+QMTPUB=? 响应 +QMTPUB: ( 支 持 的 范 围 ),,( 支 持 的 范围),(支持的列表),'topic' 设置命令 AT+QMTPUB=,, ,,[,] OK 响应 若省略： > 输入需要发送的数据 OK +QMTPUB: ,,[,] 或者 ERROR 若指定： OK 上海移远通信技术股份有限公司 24 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 最大响应时间 特性说明 +QMTPUB: ,,[,] 或者 ERROR × （默认 15 秒），受网络状态 影响 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包消息标识符。范围：0~65535；只有当=0 时，该参数值为 0。 整型。客户端想要发布消息时的 QoS 等级。 0 最多发送一次 1 最少发送一次 2 只发送一次 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 不保存 1 保存 字符串型。待发布主题。 字符串型。待发布的消息。最大长度为 1500 字节。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK（当=0 时发布数据，则无需 ACK） 1 数据包重传 2 数据包发送失败 整型。 若=1，则表示数据包重传次数； 若=0 或者 2，则不显示此参数。 整型。数据传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTCFG ='timeout',[,,,]配置超 时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 备注 1. 若省略，该命令执行成功并响应 OK 后，客户端可以继续发送新的数据包。传输数据包 的最大数量不能大于滑动窗口的大小（滑动窗口的大小为 5），否则会返回 ERROR。 2. 该命令执行后，客户端可发送数据即负载信息。每次输入数据的最大长度为 1500 字节。 3. 发布者可以发布 PUBLISH 消息到服务器，服务器也可以发布 PUBLISH 消息到订阅者。当服务器发 布 消 息 到 订 阅 者 时 ， 会 返 回 URC 通 知 host 读 取 MQTT 服 务 器 发 送 的 数 据 ： +QMTRECV: ,,[,],。关于 URC 描述的详细信息，请参考 第 4.2 章。 上海移远通信技术股份有限公司 25 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 3.2.10. AT+QMTRECV 从缓存中读取消息 该命令用于从存储缓存中读取消息，服务器上报消息时都会存储到这个缓存中。 AT+QMTRECV 从缓存中读取消息 测试命令 响应 AT+QMTRECV=? 查询命令 OK 响应 AT+QMTRECV? +QMTRECV: ,,,,, OK 设置命令 AT+QMTRECV=[,] 若无 MQTT 连接： OK 响应 [(+QMTRECV: ,,[,],列表)] OK 最大响应时间 特性说明 若无 MQTT 连接： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。表示缓存中是否存有消息，缓存中最多可存储 5 条信息，因此最多同时上报 5 条 URC。 0 缓存中没有数据 1 缓存中有数据 整型。表示每条接收数据的序号。范围：0~4。 整型。数据包消息标识符。范围：0~65535，只有当=0 时，此参数可为 0。 字符串型。待发布的主题。 整型。负载信息的长度。 字符串型。主题名相关的负载信息。 上海移远通信技术股份有限公司 26 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 4 MQTT 相关 URC 本章节主要描述 MQTT 相关的 URC。 表 3：MQTT 相关的 URC 序号 URC 格式 描述 [1] +QMTSTAT: , 当 MQTT 链 路层 状 态改变 ， 客 户端 会 断开 MQTT 连接并上报 URC。 +QMTRECV: ,,[, 当客户端接收到 MQTT 服务器的数据包会上报 [2] ], URC。 [3] +QMTRECV: , 当从 MQTT 服务器接收的消息存储到缓存时上 报 URC。 [4] +QMTPING: , 当 MQTT 链 层状 态 变化时 ， 客 户端 会 关闭 MQTT 连接并上报此 URC。 4.1. +QMTSTAT MQTT 链路层状态变化的 URC 此 URC 以+QMTSTAT:开头，当 MQTT 链路层状态发生变化就会上报该 URC。 +QMTSTAT MQTT 链路层状态变化的 URC +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 连接并上报 URC。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。错误代码。详细信息请参考表 4。 上海移远通信技术股份有限公司 27 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 表 4：URC 中的错误码 1 2 3 4 5 6 7 描述 解决方法 连接被服务器断开或者重置 发送 PINGREQ 包超时或者失败 发送 CONNECT 包超时或者失败 接收 CONNACK 包超时或者失败 客户端向服务器发送 DISCONNECT 包，但是 服务器主动断开 MQTT 连接 因为发送数据包总是失败，客户端主动断开 MQTT 连接 执行命令 AT+QMTOPEN 重建 MQTT 连 接。 首先反激活 PDP，然后再激活 PDP 并重 建 MQTT 连接。 1. 查看输入的用户名和密码是否正确。 2. 确保客户端 ID 未被占用。 3. 重建 MQTT 连接，并尝试再次发送 CONNECT 包到服务器。 1. 查看输入的用户名和密码是否正确。 2. 确保客户端 ID 未被占用。 3. 重建 MQTT 连接，并尝试再次发送 CONNECT 包到服务器。 正常流程。 1. 确保数据正确。 2. 可能因为网络拥堵或者其他错误，尝 试重建 MQTT 连接。 链路不工作或者服务器不可用 确保当前链路或者服务器可用。 8 客户端主动断开 MQTT 连接 尝试重建连接。 9~255 留作将来使用 4.2. +QMTRECV 通知 Host 读取 MQTT 数据包的 URC 此 URC 以+QMTRECV:开头，主要用于通知 Host 读取 MQTT 服务器发送的数据包。 +QMTRECV 通知 Host 读取 MQTT 数据包的 URC +QMTRECV: ,,[,], +QMTRECV: , 通知 Host 读取 MQTT 服务器发送的数据包。 当从 MQTT 服务器接收的消息存储到缓存时上报 URC。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包的消息标识符。 上海移远通信技术股份有限公司 28 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 字符串型。从 MQTT 服务器接收的主题。 整型。负载信息的长度。 字符串型。主题名称相关的负载。 整型。表示每条接收数据的序号。范围：0~4。 4.3. +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC 此 URC 以+QMTPING:开头，若服务器未在 1.5 倍保活时间内接收到客户端的消息，则相当于客户端 发送了 DISCONNECT 消息，服务器会断开与客户端的连接，此时会上报该 URC。 +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC +QMTPING: , 当 MQTT 链层状态变化时，客户端会关闭 MQTT 连接并上报 此 URC。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。Ping 状态的结果。 1 失败 上海移远通信技术股份有限公司 29 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 5 举例 本章节主要提供举例用于解释如何使用 MQTT 相关命令。 5.1. 无 SSL 的 MQTT 操作举例 //配置接收模式 AT+QMTCFG='recv/mode',0,0,1 OK //配置阿里云设备信息 AT+QMTCFG='aliauth',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAazZ' OK AT+QMTOPEN=? +QMTOPEN: (0-5),'host_name',(1-65535) OK //MQTT 客户端打开网络 AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK +QMTOPEN: 0,0 //MQTT 客户端成功打开网络 AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK AT+QMTCONN=? +QMTCONN: (0-5),'clientid','username','password' OK //客户端连接 MQTT 服务器 //若已连接阿里云，可使用命令 AT+QMTCFG='aliauth'提前配置设备信息，之后可缺省参数 和。 AT+QMTCONN=0,'clientExample' OK 上海移远通信技术股份有限公司 30 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 +QMTCONN: 0,0,0 //客户端成功连接到 MQTT 服务器 AT+QMTSUB=? +QMTSUB: (0-5),, list of ['topic',qos] OK //订阅主题 AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //如果客户端订阅某个主题，而其他设备将同一主题发布到服务器，模块会上报如下信息： +QMTRECV: 0,0, 'topic/example',36,'This is the payload related to topic' //退订主题 AT+QMTUNS=0,2,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUBEX=? +QMTPUBEX: (0-5),,(0-2),(0,1),'topic','length' OK //响应>后，输入并发送 This is test data, hello MQTT.，数据最大长度是 1500 字节，多出的部分会被忽略。 AT+QMTPUBEX=0,0,0,0,'topic/pub',30 >This is test data, hello MQTT. OK +QMTPUBEX: 0,0,0 //若客户端订阅了名为'topic/pub'的主题，且其他设备向服务器发布了相同主题，模块会上报如下信息： +QMTRECV: 0,0,'topic/pub',30,This is test data, hello MQTT. //断开客户端在 MQTT 服务器的连接 AT+QMTDISC=0 OK 上海移远通信技术股份有限公司 31 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 +QMTDISC: 0,0 //断开连接请求发送成功 //之后分两种情况： //服务器响应断开请求 +QMTSTAT: 0,5 //服务器未响应断开请求，模块调用 AT+QMCLOSE 命令 AT+QMTCLOSE=0 OK +QMTCLOSE: 0,0 5.2. 含 SSL 的 MQTT 操作举例 有关 AT+QFUPL 和 SSL 相关命令，请参考文档 [1]和[2]。 //配置接收模式 AT+QMTCFG='recv/mode',0,0,1 OK //配置 MQTT 会话为 SSL 模式 AT+QMTCFG='ssl',0,1,2 OK //若 SSL 授权方式为 server authentication，则存储 CA 证书到 RAM。 AT+QFUPL='RAM:cacert.pem',1758,100 CONNECT +QFUPL: 1758,384a OK //若 SSL 授权方式为 server authentication，则存储 CC 证书到 RAM。 AT+QFUPL='RAM:client.pem',1220,100 CONNECT +QFUPL: 1220,2d53 OK //若 SSL 授权方式为 server authentication，则存储 CK 证书到 RAM。 AT+QFUPL='RAM:user_key.pem',1679,100 上海移远通信技术股份有限公司 32 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 CONNECT +QFUPL: 1679,335f OK //配置 CA 证书 AT+QSSLCFG='cacert',2,'RAM:cacert.pem' OK //配置 CC 证书 AT+QSSLCFG='clientcert',2,'RAM:client.pem' OK //配置 CK 证书 AT+QSSLCFG='clientkey',2,'RAM:user_key.pem' OK //配置 SSL 参数 AT+QSSLCFG='seclevel',2,2 OK AT+QSSLCFG='sslversion',2,4 OK AT+QSSLCFG='ciphersuite',2,0xFFFF OK AT+QSSLCFG='ignorelocaltime',2,1 OK //SSL 授权方式：server authentication //SSL 授权版本 //加密套件 //忽略授权时间 //开始 MQTT SSL 连接 AT+QMTOPEN=0,'a1zgnxur10j8ux.iot.us-east-1.amazonaws.com',8883 OK +QMTOPEN: 0,0 //连接 MQTT 服务器 AT+QMTCONN=0,'M26_0206' OK +QMTCONN: 0,0,0 //订阅主题 AT+QMTSUB=0,1,'$aws/things/M26_0206/shadow/update/accepted',1 OK 上海移远通信技术股份有限公司 33 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 +QMTSUB: 0,1,0,1 //发布消息 AT+QMTPUBEX=0,1,1,0,'$aws/things/M26_0206/shadow/update/accepted',32 >This is publish data from client OK +QMTPUBEX: 0,1,0 //若客户端订阅了名为'$aws/things/M26_0206/shadow/update/accepted'的主题，且其他设备发布了相同 主题的消息到服务器，模块会上报如下信息： +QMTRECV: 0,1,'$aws/things/M26_0206/shadow/update/accepted',32,'This is publish data from client' //客户端断开 MQTT 服务器 AT+QMTDISC=0 OK +QMTDISC: 0,0 //之后分两种情况： //服务器响应断开请求 +QMTSTAT: 0,5 //服务器未响应断开请求，模块调用 AT+QMCLOSE 命令 AT+QMTCLOSE=0 OK +QMTCLOSE: 0,0 上海移远通信技术股份有限公司 34 / 35 EC2x&EG2x&EG9x&EM05 系列 MQTT 应用指导 6 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_EC2x&EG2x&EG9x&EM05 系列_FILE_应用指导 [2] Quectel_EC2x&EG2x&EG9x&EM05 系列_SSL_应用指导 表 6：术语缩写 缩写 ACK MQTT QoS RAM SSL TCP URC 英文全称 Acknowledgement Message Queuing Telemetry Transport Quality of Service Random Access Memory Secure Sockets Layer Transmission Control Protocol Unsolicited Result Code 中文全称 确认消息 消息队列遥测传输 服务质量 随机存取存储器 安全套接层协议 传输控制协议 非请求结果码 上海移远通信技术股份有限公司 35 / 35

RGx00U&RM500U 系列 RF FTM 应用指导 5G 模块系列 版本：1.0 日期：2023-11-09 状态：受控文件 RGx00U&RM500U 系列 RF FTM 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http：//www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http：//www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上 提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 文档历史 修订记录 版本 1.0 日期 2022-09-09 2023-11-09 作者 Xudong MAO Lenz ZHANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令详解................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................ 8 2.3. AT 命令详解................................................................................................................................ 8 2.3.1. AT+QRFTEST FTM 模式下 WCDMA/LTE/5G 射频测试 .............................................. 8 2.3.2. 强收测试 CMW500 配置................................................................................................ 14 3 举例 ..................................................................................................................................................... 15 4 附录 术语缩写..................................................................................................................................... 17 上海移远通信技术股份有限公司 4 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：5G 频段强收/强发信道分布表........................................................................................................... 10 表 3：LTE 频段强收/强发信道分布表..........................................................................................................11 表 4：WCDMA 频段强收/强发信道分布表 ................................................................................................. 13 表 5：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 5 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 1 引言 移远通信 5G RG200U 系列、RG500U 系列和 RM500U 系列模块支持强发和强收功能。本文档主要介 绍相关 AT 命令，以及如何在 FTM（工厂测试模式）下测试该功能，以便进行射频校准。 上海移远通信技术股份有限公司 6 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 2 AT 命令详解 2.1. AT 命令详解 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系 或连续性。 2.3. AT 命令详解 2.3.1. AT+QRFTEST FTM 模式下 WCDMA/LTE/5G 射频测试 AT+QRFTEST FTM 模式下 WCDMA/LTE/5G 射频测试 测试命令 AT+QRFTEST=? 响应 +QRFTEST: 'rx',,,,,, +QRFTEST: 'tx',,,,,, +QRFTEST: 'mode',(支持的列表) 设置命令 查询/设置 FTM 模式 AT+QRFTEST='mode'[,] OK 响应 若省略，查询当前配置： +QRFTEST: OK 若指定可选参数，则设置 FTM 模式： OK 若有任何错误： ERROR 设置命令 FTM 模式下强收测试 响应 +QRFTEST: rssi[0] = , rssi[1] = , rssi[2] = - AT+QRFTEST='rx',,,<b , rssi[3] = w>,,, 若有任何错误： ERROR 设置命令 FTM 模式下强发测试 AT+QRFTEST='tx',,,,,,[,] ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。射频测试模式。 0 Online 模式 1 FTM 模式 整型。WCDMA/LTE/5G 配置。 0 WCDMA 1 LTE 2 5G 整型。WCDMA/LTE/5G 频段。 1 5G n1/LTE B1/WCDMA B1 2 5G n2/LTE B2/WCDMA B2 3 5G n3/LTE B3/WCDMA B3 4 LTE B4/WCDMA B4 5 5G n5/LTE B5/WCDMA B5 6 LTE B6/WCDMA B6 7 5G n7/LTE B7/WCDMA B7 8 5G n8/LTE B8/WCDMA B8 9 LTE B9/WCDMA B9 10 LTE B10/WCDMA B10 11 LTE B11/WCDMA B11 …… 19 LTE B19/WCDMA B19 20 5G n20/LTE B20 28 5G n28/LTE B28 …… 整型。WCDMA/LTE/5G 带宽。单位：MHz。 0 1.4 1 3 2 5 3 10 4 15 5 20 6 40（只适用于 5G） 8 80（只适用于 5G） 10 100（只适用于 5G） 上海移远通信技术股份有限公司 9 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 整型。强收/强发信道。分别参见表 2、表 3 和表 4。 整型。接收天线类型。（暂不支持） 0 PRX 1 DRX 整型。Rx AGC 期望值，即仪表端设置的功率。单位：dBm。（暂不支持） 整型。天线的接收信号强度指示值。 整型。是否启用强发功能。 0 禁用 1 启用 整型。收发器输出增益。该参数值与实际强发功率呈正相关。单位：dBm。建议设 置值：23。 整型。天线配置。该参数仅在 5G 网络下配置，LTE 和 WCDMA 网络下均省略。 0 主路天线 1 辅路天线 备注 1. 关于取值中网络制式与对应的频段，请参考表 2、表 3 和表 4。 2. 每进行一种网络制式（LTE/WCDMA/5G）的强发/强收测试后，需要执行 AT+QRFTEST='mode',0 退 出 FTM 模式再执行 AT+QRFTEST='mode',1 重新进入 FTM 模式，才能进行下一种网络模式的强发 /强收测试。 3. 强发测试时，若要切换频段，需要先将设置为 0 禁用强发功能，再重新进行参数配置。 4. 不同模块返回的 RSSI 值对应的天线口是不同的。有关 RSSI 返回值与对应天线口的关系，请参考相应 模块的硬件设计手册。 5. 强发/强收的 Demo 测试数据可联系移远通信技术支持获取。 表 2：5G 频段强收/强发信道分布表 5G 频段 n1 强收信道范围 最小值~最大值 422000~434000 n2 386000~398000 n3 361000~376000 n5 173800~178800 n7 524000~538000 n8 185000~192000 n20 158200~164200 强发信道范围 最小值~最大值 384000~396000 370000~382000 342000~357000 164800~169800 500000~514000 176000~183000 166400~172400 上海移远通信技术股份有限公司 10 / 17 n28 151600~160600 n38 514000~524000 n41 499200~537999 n50 286400~303400 n51 285400~286400 n66 422000~440000 n70 399000~404000 n71 123400~130400 n74 295000~303600 n75 286400~303400 n76 285400~286400 n77 620000~680000 n78 620000~653333 n79 693334~733333 表 3：LTE 频段强收/强发信道分布表 LTE 频段 LTE B1 强收信道范围 最小值~默认值~最大值 0~300~599 LTE B2 600~900~1199 LTE B3 1200~1575~1949 LTE B4 1950~2175~2399 LTE B5 2400~2525~2649 LTE B6 2650~2700~2749 LTE B7 2750~3100~3449 LTE B8 3450~3625~3799 上海移远通信技术股份有限公司 RGx00U&RM500U 系列 RF FTM 应用指导 140600~149600 514000~524000 499200~537999 286400~303400 285400~286400 342000~356000 339000~342000 132600~139600 285400~294000 620000~680000 620000~653333 693334~733333 强发信道范围 最小值~默认值~最大值 18000~18300~18599 18600~18900~19199 19200~19575~19949 19950~20175~20339 20400~20525~20649 20650~20700~20749 20750~21100~21449 21450~21625~21799 11 / 17 LTE B9 LTE B10 LTE B11 LTE B12 LTE B13 LTE B14 LTE B17 LTE B18 LTE B19 LTE B20 LTE B21 LTE B22 LTE B23 LTE B24 LTE B25 LTE B26 LTE B27 LTE B28 LTE B29 LTE B30 LTE B31 LTE B32 LTE B33 LTE B34 LTE B35 3800~3975~4149 4150~4450~4749 4750~4850~4949 5000~5095~5179 5180~5230~5279 5280~5330~5379 5730~5790~5849 5850~5925~5999 6000~6075~6149 6150~6300~6449 6450~6525~6599 6600~7000~7399 7500~7600~7699 7700~7870~8039 8040~8365~8689 8690~8865~9039 9040~9125~9209 9210~9435~9659 9660~9715~9769 9770~9820~9869 9870~9895~9919 9920~10140~10359 36000~36100~36199 36200~36275~36349 36350~36650~36949 上海移远通信技术股份有限公司 RGx00U&RM500U 系列 RF FTM 应用指导 21800~21975~22149 22150~22450~22749 22750~22850~22949 23000~23095~23179 23180~23230~23279 23280~23330~23379 23730~23790~23849 23850~23925~23999 24000~24075~24149 24150~24300~24449 24450~24525~24599 24600~25000~25399 25500~25600~25699 25700~25870~26039 26040~26365~26689 26690~26865~27039 27040~27125~27209 27210~27435~27659 27660~27710~27759 27760~27785~27809 25700~25870~26039 36000~36100~36199 36200~36275~36349 36350~36650~36949 12 / 17 LTE B36 LTE B37 LTE B38 LTE B39 LTE B40 LTE B41 LTE B42 LTE B43 LTE B46 LTE B47 LTE B48 LTE B66 LTE B71 36950~37250~37549 37550~37650~37749 37750~38000~38249 38250~38450~38649 38650~39150~39649 39650~40620~41589 41590~42590~43589 43590~44590~45589 46790~50665~54539 54540~54885~55239 55240~55940~56739 66436~66886~67335 68586~68761~68935 RGx00U&RM500U 系列 RF FTM 应用指导 36950~37250~37549 37550~37650~37749 37750~38000~38249 38250~38450~38649 38650~39150~39649 39650~40620~41589 41590~42590~43589 43590~44590~45589 46790~50665~54539 54540~54885~55239 55240~55940~56739 131972~132322~132671 133122~133297~133471 表 4：WCDMA 频段强收/强发信道分布表 WCDMA 频段 WCDMA B1 强收信道范围 最小值~默认值~最大值 10562~10700~10838 WCDMA B2 9662~9800~9938 WCDMA B3 1162~1338~1513 WCDMA B4 1537~1638~1738 WCDMA B5 4357~4408~4458 WCDMA B6 4387~4400~4413 WCDMA B7 2237~2400~2563 WCDMA B8 2937~3012~3088 WCDMA B9 9237~9312~9387 强发信道范围 最小值~默认值~最大值 9612~9750~9888 9262~9400~9538 937~1112~1288 1312~1412~1513 4132~4182~4233 4162~4175~4188 2012~2175~2338 2712~2788~2863 8762~8837~8912 上海移远通信技术股份有限公司 13 / 17 WCDMA B10 WCDMA B11 WCDMA B19 3112~3250~3388 3712~3762~3812 712~738~763 RGx00U&RM500U 系列 RF FTM 应用指导 2887~3025~3163 3487~3537~3587 312~338~363 2.3.2. 强收测试 CMW500 配置 发出连续波的信号源可用作下行 CW 信号。若将 CMW500 用作信号源，需作如下配置： 线损补偿 接收信号频偏500 kHz 设置接收信号的功率 将信号模式设置为连续波（CW） 图 1：射频测试 CMW500 配置 上海移远通信技术股份有限公司 14 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 3 举例 AT+QRFTEST=? +QRFTEST: 'rx',,,,,, +QRFTEST: 'tx',,,,,, +QRFTEST: 'mode',(0,1) OK //FTM 模式下强收测试 AT+QRFTEST='mode' +QRFTEST: 0 //查询 FTM 状态 OK AT+QRFTEST='mode',1 //进入 FTM 模式 OK AT+QRFTEST='rx',1,41,3,40620,0,-600 //进行 LTE B41 强收测试 +QRFTEST: rssi[0] = -17608, rssi[1] = -8901, rssi[2] = -120, rssi[3] = -120 OK AT+QRFTEST='mode',0 //退出 FTM 模式 OK //FTM 模式下强发测试 AT+QRFTEST='mode' //查询 FTM 状态 +QRFTEST: 0 OK AT+QRFTEST='mode',1 OK AT+QRFTEST='tx',1,41,3,40620,1,23 OK AT+QRFTEST='tx',1,41,3,40620,0,23 OK //进入 FTM 模式 //进行 LTE B41 强发测试 //关闭 LTE B41 强发测试 AT+QRFTEST='tx',1,20,3,24300,1,23 OK AT+QRFTEST='tx',1,20,3,24300,0,23 OK AT+QRFTEST='mode',0 OK AT+QRFTEST='mode' //进行 LTE B20 强发测试 //关闭 LTE B20 强发测试 //退出 FTM 模式 //查询 FTM 状态 上海移远通信技术股份有限公司 15 / 17 +QRFTEST: 0 OK AT+QRFTEST='mode',1 OK AT+QRFTEST='tx',2,41,6,518601,1,23,0 OK AT+QRFTEST='tx',2,41,6,518601,0,23,0 OK AT+QRFTEST='tx',2,41,6,518601,1,23,1 OK AT+QRFTEST='tx',2,41,6,518601,0,23,1 OK AT+QRFTEST='mode',0 OK RGx00U&RM500U 系列 RF FTM 应用指导 //进入 FTM 模式 //进行 5G n41 主路强发测试 //关闭 5G n41 主路强发测试 //进行 5G n41 辅路强发测试 //关闭 5G n41 辅路强发测试 //退出 FTM 模式 上海移远通信技术股份有限公司 16 / 17 RGx00U&RM500U 系列 RF FTM 应用指导 4 附录 术语缩写 表 5：术语缩写 缩写 AGC CW DRX FTM LTE PRX RF RSSI RX TX WCDMA 英文全称 Automatic Gain Control Continuous Wave Diversity Receive Factory Test Mode Long Term Evolution Primary Receive Radio Frequency Received Signal Strength Indication Receive Transmit Wideband Code Division Multiple Access 中文全称 自动增益控制 连续波 分集接收 工厂测试模式 长期演进 主集接收 射频 接收的信号强度指示 接收 发射 宽带码分多址 上海移远通信技术股份有限公司 17 / 17

LTE Standard (U)系列 STK 应用指导 LTE Standard 模块系列 版本：1.0 日期：2023-11-06 状态：受控文件 LTE Standard Module Series 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 LTE Standard (U)系列_STK_应用指导 1 / 33 LTE Standard Module Series 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. LTE Standard (U)系列_STK_应用指导 2 / 33 LTE Standard Module Series 文档历史 修订记录 版本 1.0 日期 2023-08-23 2023-11-06 作者 Joe TU Joe TU 变更表述 文档创建 受控版本 LTE Standard (U)系列_STK_应用指导 3 / 33 LTE Standard Module Series 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 1.2. AT 命令说明................................................................................................................................. 7 1.2.1. 定义 .................................................................................................................................. 7 1.2.2. AT 命令语句 ..................................................................................................................... 7 1.3. AT 示例声明................................................................................................................................. 7 1.4. STK AT 命令使用步骤 ................................................................................................................. 8 1.5. STK 状态 ..................................................................................................................................... 8 1.6. 主动式命令响应 ........................................................................................................................... 8 1.7. STK 字符集.................................................................................................................................. 9 2 STK AT 命令详解................................................................................................................................. 10 2.1. AT+QSTK 启用/禁用 STK 功能............................................................................................... 10 2.2. AT+QSTKPD 获取终端配置信息 ............................................................................................ 11 2.3. AT+QSTKSTATE 查询 STK 状态............................................................................................ 12 2.4. AT+QSTKGI 获取主动式命令信息.......................................................................................... 12 2.5. AT+QSTKRSP STK 响应........................................................................................................ 13 2.6. URC 总结 .................................................................................................................................. 14 2.6.1. 主动式命令上报 .............................................................................................................. 14 2.6.2. 主动式命令结束 .............................................................................................................. 14 2.6.3. (U)SIM 卡丢失 ................................................................................................................ 15 2.6.4. 超时响应 ......................................................................................................................... 15 2.7. 主动式命令详情 ....................................................................................................... 15 2.7.1. Play Tone (32) ................................................................................................................ 16 2.7.2. Display Text (33)............................................................................................................. 17 2.7.3. Get Inkey (34)................................................................................................................. 19 2.7.4. Get Input (35) ................................................................................................................. 20 2.7.5. Select Item (36) .............................................................................................................. 22 2.7.6. Set up Menu (37) ........................................................................................................... 24 2.7.7. Set up Idle Mode Text (40) ............................................................................................. 26 2.7.8. Language Notification (53) ............................................................................................. 27 3 STK AT 命令示例................................................................................................................................. 29 3.1. 启用 STK 功能并设置菜单......................................................................................................... 29 3.2. 选择菜单 .................................................................................................................................... 30 3.3. STK 会话终止和超时响应.......................................................................................................... 31 3.4. 禁用 STK 功能 ........................................................................................................................... 32 4 附录 参考文档及术语缩写 ................................................................................................................... 33 LTE Standard (U)系列_STK_应用指导 4 / 33 LTE Standard Module Series 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 7 表 3：主动式命令响应 .................................................................................................................................. 8 表 4：主动式命令类型（参考 3GPP TS 11.14 第 13.4 章） ...................................................................... 15 表 5：参考文档 ........................................................................................................................................... 33 表 6：术语缩写 ........................................................................................................................................... 33 LTE Standard (U)系列_STK_应用指导 5 / 33 LTE Standard Module Series 1 引言 移远通信 LTE Standard (U)系列模块提供支持(U)SIM 应用工具包（STK）的 AT 命令。本文档介绍 (U)SIM 应用工具包定义的所有 AT 命令。 1.1. 适用模块 表 1：适用模块 模块系列 ECx00G ECx00U EGx00U EGx00G EG91xU 模块 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U-GL EG915U 系列 备注 本文档不适用于 EC200D 系列模块。 LTE Standard (U)系列_STK_应用指导 6 / 33 LTE Standard Module Series 1.2. AT 命令说明 1.2.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 LTE Standard (U)系列_STK_应用指导 7 / 33 LTE Standard Module Series 1.4. STK AT 命令使用步骤 步骤 1：打开模块，执行 AT+QSTK=1[,]启用 STK 功能，然后重启模块。 步骤 2：根据 URC，执行 AT+QSTKGI 查询主动式命令信息，执行 AT+QSTKRSP 响应 STK 主动式命令。 当上报+QSTKURC: 253 时，用户可执行 AT+QSTKRSP=253,,选择菜单项。 用户也可通过执行 AT+QSTKRSP=254 终止 STK 会话。 步骤 3：执行 AT+QSTK=0 禁用 STK 功能，然后重启模块。 1.5. STK 状态 STK 有三种状态：自动响应状态、终端响应状态和等待状态。详情参考第 2.3 章。STK 的状态转换如 下图所示。 自动响应状态 执行AT+QSTK=1[,] 并重启模块 执行AT+QSTK=0并重启模块 AT+QSTKRSP=,[…] 终端响应状态 +QSTKURC: 等待状态 图 1：STK 状态转换 1.6. 主动式命令响应 禁用 STK 功能后，模块将自动响应主动式命令。启用 STK 功能后，用户应响应主动式命令（参考第 2.7 章）。若用户在一段时间未响应主动式命令，将上报超时响应 URC，模块将自动响应主动式命令。 表 3：主动式命令响应 主动式命令 PLAY TONE (32) DISPLAY TEXT (33) GET INKEY (34) GET INPUT (35) 自动响应 48 0 48 48 用户响应 0, 4, 16, 32, 48 0, 4, 16, 17, 18, 32, 48 0, 4, 16, 17, 18, 19, 32, 48 0, 4, 16, 17, 18, 19, 32, 48 LTE Standard (U)系列_STK_应用指导 8 / 33 SELECT ITEM (36) 48 SET UP MENU (37) 0 SET UP IDLE MODE TEXT (40) 0 LANGUAGE NOTIFICATION (53) 0 LTE Standard Module Series 0, 4, 16, 17, 18, 19, 32, 48 0, 4, 32, 48 0, 4, 32, 48 0 1.7. STK 字符集 STK AT 命令接口支持以下字符集： ⚫ GSM 字符集（默认） ⚫ UCS-2 字符集 可通过 AT+QSTK=[,]（参考第 2.1 章）配置字符集，配置后生效。字符集影响 STK AT 命令输入参数和输出信息。若 UCS-2 字符无法转换为 GSM 字符，则将转换为 0x20（空格）。 LTE Standard (U)系列_STK_应用指导 9 / 33 LTE Standard Module Series 2 STK AT 命令详解 2.1. AT+QSTK 启用/禁用 STK 功能 AT+QSTK 启用/禁用 STK 功能 测试命令 AT+QSTK=? 响应 +QSTK: (支持的列表),(支持的列表),(支 持的范围) 查询命令 AT+QSTK? OK 响应 +QSTK: ,, OK 或者 ERROR 若错误与ME功能相关： +CME ERROR: 设置命令 响应 AT+QSTK=[,[,]] 或者 ERROR 最大响应时间 特性说明 若错误与ME功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 LTE Standard (U)系列_STK_应用指导 10 / 33 LTE Standard Module Series 参数 整型。启用或禁用STK功能。 0 禁用 1 启用 整型。字符集编码。 0 GSM字符集 1 UCS-2字符集 整型。响应超时。范围：1~65535；默认值：300；单位：秒。 错误码。详情参考文档 [1]。 举例 AT+QSTK=? +QSTK: (0,1),(0,1),(1-65535) OK AT+QSTK? +QSTK: 0,0,300 OK 2.2. AT+QSTKPD 获取终端配置信息 该命令用于获取终端配置信息。配置信息请参考 ETSI TS 102 223。 AT+QSTKPD 获取终端配置信息 测试命令 AT+QSTKPD=? 查询命令 AT+QSTKPD? 响应 OK 响应 +QSTKPD: OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / LTE Standard (U)系列_STK_应用指导 11 / 33 参数 十六进制字符串。STK 配置信息。 错误码。详情参考文档 [1]。 LTE Standard Module Series 2.3. AT+QSTKSTATE 查询 STK 状态 执行 AT+QSTKGI 或 AT+QSTKRSP 命令时，需参考的值。当为 0 或 2 时，省略 。 当为 253 时，表示 STK 会话已结束。此时，无法通过 AT+QSTKGI=获取 STK 主 动 式 命 令 信 息 ， 也 无 需 通 过 AT+QSTKRSP 响 应 主 动 式 命 令 。 但 可 执 行 AT+QSTKRSP=253,,选择菜单项并开启 STK 会话。 AT+QSTKSTATE 查询 STK 状态 测试命令 AT+QSTKSTATE=? 响应 +QSTKSTATE: (支持的范围),(支持的列 表) 查询命令 AT+QSTKSTATE? OK 响应 +QSTKSTATE: [,] 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。STK 状态。 0 自动响应状态 1 终端响应状态 2 等待状态 整型。命令类型。范围：32~37、40、53、253。详情参考表 4。 2.4. AT+QSTKGI 获取主动式命令信息 上报 URC +QSTKURC: 时，可执行 AT+QSTKGI=获取 STK 主动式命令信息。 LTE Standard (U)系列_STK_应用指导 12 / 33 LTE Standard Module Series AT+QSTKGI 获取主动式命令信息 测试命令 AT+QSTKGI=? 响应 +QSTKGI: (支持的的列表) 设置命令 AT+QSTKGI= 最大响应时间 特性说明 OK 响应因而异。详情参考第 2.7 章。 300 毫秒 / 参数 整型。主动式命令类型。范围：32~37、40、53。详情参考表 4。 2.5. AT+QSTKRSP STK 响应 收到 URC +QSTKURC: 后，可执行 AT+QSTKGI=获取相关信息，并通过 AT+QSTKRSP 响应命令。 执行 AT+QSTKRSP=253,,选择菜单项，该命令仅在收到+QSTKURC: 253 后使用。 执行 AT+QSTKRSP=254 终止 STK 会话，会话结束后将上报+QSTKURC: 253。 AT+QSTKRSP STK 响应 测试命令 AT+QSTKRSP=? 响应 +QSTKRSP: (支持的列表) 设置命令 选择菜单项 AT+QSTKRSP=253,, OK 响应 OK 或者 ERROR 错误与 ME 功能相关： ME ERROR: 设置命令 终止当前 STK 会话 AT+QSTKRSP=254 响应 OK 或者 ERROR LTE Standard (U)系列_STK_应用指导 13 / 33 最大响应时间 特性说明 参数 10 秒 / LTE Standard Module Series 整型。命令类型。范围：32~37、40、53、253、254。详情参考表 4。 整型。命令结果。 0 触发 modem 以选择菜单 19 用户所需的帮助信息 整型。菜单项 ID。范围：1~255。 错误码。详情参考文档 [1]。 2.6. URC 总结 STK 的 URC 以+QSTKURC: 的类型上报给主机，包含主动式命令上报、主动式命令结束 URC、(U)SIM 卡丢失和超时响应。 2.6.1. 主动式命令上报 若 STK 会话未结束，将上报主动式命令 URC，表示用户通过 AT+QSTKGI=获取主动式命 令信息，并通过 AT+QSTKRSP 响应主动式命令。 主动式命令上报 +QSTKURC: 主动式命令。 参数 整型。主动式命令类型。范围：32~37、40、53。详情参考表 4。 2.6.2. 主动式命令结束 STK 会话结束后，将上报 URC +QSTKURC: 253。此时，用户无法通过 AT+QSTKGI=获 取 STK 主 动 式 命 令 信 息 ， 也 无 需 通 过 AT+QSTKRSP 响 应 主 动 式 命 令 。 但 可 执 行 AT+QSTKRSP=253,,选择菜单项。 主动式命令结束 +QSTKURC: 253 表示主动式命令结束。 LTE Standard (U)系列_STK_应用指导 14 / 33 LTE Standard Module Series 2.6.3. (U)SIM 卡丢失 (U)SIM 卡丢失时，将上报(U)SIM 卡丢失 URC。例如，(U)SIM 卡拔出或 AT+CFUN 由 1 变为 0。 (U)SIM 卡丢失 +QSTKURC: 254 表示(U)SIM 卡丢失。 2.6.4. 超时响应 若用户在一段时间内没有响应主动式命令，将上报超时响应 URC，模块将自动响应主动式命令。 超时响应 +QSTKURC: 255, 表示超时响应。 参数 整型。主动式命令类型。取值：32~37、40、53。详情参考表 4。 2.7. 主动式命令详情 在响应主动式命令之前，用户可多次获取主动式命令信息。 表 4：主动式命令类型（参考 3GPP TS 11.14 第 13.4 章） 32 33 34 35 36 37 40 名称 Play tone（播放音） Display text（显示文本） Get inkey（获取秘钥） Get input（获取输入） Select item（选择选项） Set up menu（设置菜单） Set up idle mode text（设置空闲模式文本） LTE Standard (U)系列_STK_应用指导 15 / 33 LTE Standard Module Series 53 Language notification（语言通知） 备注 请注意的取值在 3GPP TS 11.14 文档中是以十六进制的方式体现的。 2.7.1. Play Tone (32) 收 到 +QSTKURC: 32 后 ， 用 户 可 执 行 AT+QSTKGI=32 获 取 主 动 式 命 令 信 息 ， 再 通 过 AT+QSTKRSP=32,[,]响应主动式命令。 Play Tone (32) 设置命令 AT+QSTKGI=32 响应 +QSTKGI: 32,,,,,,, OK 或者 ERROR 设置命令 AT+QSTKRSP=32,[,] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 参数 RFU。 字符串类型。文本。 整型。UE 生成的音调。01~08 是标准管理音调，16~18 是 UE 专有音调。 01 拨号音 02 用户正忙音 03 拥塞音 04 无线电路径确认音 05 无线电路径不可用音/通话中断音 06 错误/特殊信息音 LTE Standard (U)系列_STK_应用指导 16 / 33 LTE Standard Module Series 07 呼叫等待音 08 振铃音 16 一般蜂鸣音 17 肯定确认音 18 否定确认音/错误音 整型。持续时间的单位。 0 分钟 1 秒钟 2 十分之一秒 整型。音调持续时间。范围：1~255。 整型。图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图标才 与文本确定值一起显示 Bit 2–8 RFU 整型。图标 ID。 0 无图标 1~255 图标 ID 整型。命令结果码。 0 命令执行成功，用户接受呼叫请求 4 命令执行成功，但无法显示请求的图标 16 用户结束主动式(U)SIM 会话 32 UE 当前无法处理命令 48 命令超出 UE 处理范围 整型。可选附加命令状态。取值请参考 ETSI TS 102 223。范围：0~255。 错误码。详情参考文档 [1]。 备注 若返回'-'或-，表示参数在当前条件下无效。详情可参考第 3 章。 2.7.2. Display Text (33) 收 到 +QSTKURC: 33 后 ， 用 户 可 执 行 AT+QSTKGI=33 获 取 主 动 式 命 令 信 息 ， 再 通 过 AT+QSTKRSP=33,[,]响应主动式命令。 LTE Standard (U)系列_STK_应用指导 17 / 33 LTE Standard Module Series Display Text (33) 设置命令 AT+QSTKGI=33 响应 +QSTKGI: 33,,,,, OK 或者 ERROR 设置命令 AT+QSTKRSP=33,[,] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 参数 整型。显示文本命令详细信息。范围：0~255。 Bit 1 0 普通优先级 1 高优先级 Bit 2–7 RFU Bit 8 0 延迟后清除消息 1 等待用户清除消息 字符串类型。文本。 整型。及时响应。 0 文本从屏幕上清除时发送终端响应 1 立即发送终端响应并持续显示文本，直到发生以下事件之一： ⚫ 收到包含显示数据的后续主动式命令 ⚫ 通知的短暂延迟已过期 ⚫ 用户干预 ⚫ 发生更高优先级的事件，如移动终端呼叫 整型。图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图 标才与文本确定值一起显示 Bit 2–8 RFU 整型。图标 ID。 0 无图标 1~255 图标 ID LTE Standard (U)系列_STK_应用指导 18 / 33 LTE Standard Module Series 整型。命令结果码。 0 命令执行成功，用户接受呼叫请求 4 命令执行成功，但无法显示请求的图标 16 用户结束主动式(U)SIM 会话 17 用户请求在主动(U)SIM 会话中后移 18 用户无响应 32 UE 当前无法处理命令 48 命令超出 UE 处理范围 整型。可选附加命令状态。取值请参考 ETSI TS 102 223。范围：0~255。 错误码。详情参考文档 [1]。 备注 若返回'-'或-，表示参数在当前条件下无效。详情可参考第 3 章。 2.7.3. Get Inkey (34) 收 到 +QSTKURC: 34 后 ， 用 户 可 执 行 AT+QSTKGI=34 获 取 主 动 式 命 令 信 息 ， 再 通 过 AT+QSTKRSP=34,,[,]响应主动式命令。 Get Inkey (34) 设置命令 AT+QSTKGI=34 响应 +QSTKGI: 34,,,, OK 或者 ERROR 设置命令 AT+QSTKRSP=34,,[,] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: LTE Standard (U)系列_STK_应用指导 19 / 33 LTE Standard Module Series 参数 整型。获取输入按键命令详细信息。范围：0~255。 Bit 1 0 仅数字 1 字母集 Bit 2 0 短信默认字符集（GSM 字符集） 1 UCS-2 字符集 Bit 3 0 启用由 Bit 1 和 Bit 2 定义的字符集 1 禁用由 Bit 1 和 Bit 2 定义的字符集，并请求'Yes/No'响应 Bit 4–7 RFU Bit 8 0 无可用的帮助信息 1 有可用的帮助信息 字符串类型。文本。 整型。图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图 标才与文本确定值一起显示 Bit 2–8 RFU 整型。图标 ID。 0 无图标 1~255 图标 ID 整型。命令结果码。 0 命令执行成功，用户接受呼叫请求 4 命令执行成功，但无法显示请求的图标 16 用户结束主动式(U)SIM 会话 17 用户请求在主动式(U)SIM 会话中后移 18 用户无响应 19 用户需要帮助信息 32 UE 当前无法处理命令 48 命令超出 UE 处理范围 字符串类型。输入字符串。 整型。可选附加命令状态。取值请参考 ETSI TS 102 223。范围：0~255。 错误码。详情参考文档 [1]。 备注 若返回'-'或-，表示参数在当前条件下无效。详情可参考第 3 章。 2.7.4. Get Input (35) 收 到 +QSTKURC: 35 后 ， 用 户 可 执 行 AT+QSTKGI=35 获 取 主 动 式 命 令 信 息 ， 再 通 过 AT+QSTKRSP=35,,[,]响应主动式命令。详情参考第 3.3 章。 LTE Standard (U)系列_STK_应用指导 20 / 33 LTE Standard Module Series Get Input (35) 设置命令 AT+QSTKGI=35 响应 +QSTKGI: 35,,,,,,, OK 或者 ERROR 设置命令 AT+QSTKRSP=35,,[,] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 参数 整型。获取输入命令详细信息。范围：0~255。 Bit 1 0 仅数字 1 字母集 Bit 2 0 短信默认字符集（GSM 字符集） 1 UCS-2 字符集 Bit 3 0 ME 可能会在显示屏上回显用户输入 1 不得以任何方式透露用户输入 Bit 4 0 解压缩格式的用户输入 1 短信打包格式的用户输入 Bit 5–7 RFU Bit 8 0 无可用的帮助信息 1 有可用的帮助信息 字符串类型。文本。 整型。用户输入的最小长度。 整型。用户输入的最大长度。 字符串类型。默认输入文本。 整型。图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图 标才与文本确定值一起显示 Bit 2–8 RFU 整型。图标 ID。 LTE Standard (U)系列_STK_应用指导 21 / 33 LTE Standard Module Series 0 无图标 1~255 图标 ID 整型。命令结果码。 0 命令执行成功，用户接受呼叫请求 4 命令执行成功，但无法显示请求的图标 16 用户结束主动式(U)SIM 会话 17 用户请求在主动式(U)SIM 会话中后移 18 用户无响应 19 用户需要帮助信息 32 UE 当前无法处理命令 48 命令超出 UE 处理范围 字符串类型。输入字符串。 整型。可选附加命令状态。取值请参考 ETSI TS 102 223。范围：0~255。 错误码。详情参考文档 [1]。 备注 若返回'-'或-，表示参数在当前条件下无效。详情可参考第 3 章。 2.7.5. Select Item (36) 收 到 +QSTKURC: 36 后 ， 用 户 可 执 行 AT+QSTKGI=36 获 取 主 动 式 命 令 信 息 ， 再 通 过 AT+QSTKRSP=36,,[,]响应主动式命令。 Select Item (36) 设置命令 AT+QSTKGI=36 响应 第一行输出的响应： +QSTKGI: 36,,,,< default_itemID>,,,, 有个重复的行，这里只列出其中一行： +QSTKGI: 36,,,, OK 或者 ERROR 设置命令 若错误与 ME 功能相关： +CME ERROR: 响应 LTE Standard (U)系列_STK_应用指导 22 / 33 LTE Standard Module Series AT+QSTKRSP=36,, [,] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 参数 整型。所选项命令的详细信息。 Bit 1 Bit 2 Bit 3 0 未指定显示类型 1 显示类型在 bit 2 中指定 0 若 bit 1=1，显示数据值的选择 1 若 bit 1=1，显示导航项的选择 0 无选择偏好 1 优先使用软键选择 Bit 4–7 RFU Bit 8 0 无可用的帮助信息 1 有可用的帮助信息 整型。列表中的项数。 字符串类型。标题。 整型。默认选项 ID。 0 无默认选项 1~255 默认选项 ID 整型。显示选项图标。 0 无图标 1 显示图标 整型。项目图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图 标才与文本确定值一起显示 Bit 2–8 RFU 整型。标题图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图 标才与文本确定值一起显示 Bit 2–8 RFU 整型。标题图标 ID。 0 无图标 1~255 图标 ID 整型。项目标识符。 字符串类型。项目文本。 整型。执行菜单项时发出的下一个主动式命令类型。 整型。项目图标 ID。 LTE Standard (U)系列_STK_应用指导 23 / 33 LTE Standard Module Series 0 无图标 1~255 图标 ID 整型。命令结果码。 0 命令执行成功，用户接受呼叫请求 4 命令执行成功，但无法显示请求的图标 16 用户结束主动式(U)SIM 会话 17 用户请求在主动式(U)SIM 会话中后移 18 用户无响应 19 用户需要帮助信息 32 UE 当前无法处理命令 48 命令超出 UE 处理范围 整型。可选附加命令状态。取值请参考 ETSI TS 102 223。范围：0~255。 错误码。详情参考文档 [1]。 备注 若返回'-'或-，表示参数在当前条件下无效。详情可参考第 3 章。 2.7.6. Set up Menu (37) 收 到 +QSTKURC: 37 后 ， 用 户 可 通 过 AT+QSTKGI=37 获 取 主 动 式 命 令 信 息 ， 再 通 过 AT+QSTKRSP=37,[,]响应主动式命令。详情参考第 3.1 章。此后，用户可以随 时通过 AT+QSTKGI=37 获取主菜单。 Set up Menu (37) 设置命令 AT+QSTKGI=37 响应 第一行输出的响应： +QSTKGI: 37,,,,,,, 有个重复的行，这里只列出其中一行： +QSTKGI: 37,,,, OK 或者 ERROR 设置命令 若错误与 ME 功能相关： +CME ERROR: 响应 LTE Standard (U)系列_STK_应用指导 24 / 33 LTE Standard Module Series AT+QSTKRSP=37,[,] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 参数 整型。设置菜单命令的详细信息。 Bit 1 0 无选择偏好 1 优先使用软键选择 Bit 2–7 RFU Bit 8 0 无可用的帮助信息 1 有可用的帮助信息 整型。列表中的项数。 字符串类型。标题。 整型。显示选项图标。 0 无图标 1 显示图标 整型。项目图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图 标才与文本确定值一起显示 Bit 2–8 RFU 整型。标题图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图 标才与文本确定值一起显示 Bit 2–8 RFU 整型。标题图标 ID。 0 无图标 1~255 图标 ID 整型。项目标识符。 字符串类型。项目文本。 整型。执行菜单项时发出的下一个主动式命令类型。 整型。项目图标 ID。 0 无图标 1~255 图标 ID 整型。命令结果码。 0 命令执行成功，用户接受呼叫请求 4 命令执行成功，但无法显示请求的图标 32 UE 当前无法处理命令 48 命令超出 UE 处理范围 LTE Standard (U)系列_STK_应用指导 25 / 33 LTE Standard Module Series 整型。可选附加命令状态。取值请参考 ETSI TS 102 223。范围：0~255。 错误码。详情参考文档 [1]。 备注 若返回'-'或-，表示参数在当前条件下无效。详情可参考第 3 章。 2.7.7. Set up Idle Mode Text (40) 收 到 +QSTKURC: 40 后 ， 用 户 可 通 过 AT+QSTKGI=40 获 取 主 动 式 命 令 信 息 ， 再 通 过 AT+QSTKRSP=40,[,]响应主动式命令。此命令提供文本，并且在显示处于空闲 状态时，TE 可以选择性地显示一个图标。 Set up Idle Mode Text (40) 设置命令 AT+QSTKGI=40 响应 第一行输出的响应： +QSTKGI: 40,,,, OK 或者 ERROR 设置命令 AT+QSTKRSP=40,[,] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 参数 RFU。 字符串类型。TE 处于空闲模式时显示的文本。 整型。图标修饰符。 Bit 1 0 图标意义明确，可替代文本 1 图标意义不明确，仅当关联的图标 ID 不为 0（图标存在）时，图 标才与文本确定值一起显示 Bit 2–8 RFU LTE Standard (U)系列_STK_应用指导 26 / 33 LTE Standard Module Series 整型。图标 ID。 0 无图标 1~255 图标 ID 整型。命令结果码。 0 命令执行成功，用户接受呼叫请求 4 命令执行成功，但无法显示请求的图标 32 UE 当前无法处理命令 48 命令超出 UE 处理范围 整型。可选附加命令状态。取值请参考 ETSI TS 102 223。范围：0~255。 错误码。详情参考文档 [1]。 备注 若返回'-'或-，表示参数在当前条件下无效。详情可参考第 3 章。 2.7.8. Language Notification (53) 收 到 +QSTKURC: 53 后 ， 用 户 可 通 过 AT+QSTKGI=53 获 取 主 动 式 命 令 信 息 ， 再 通 过 AT+QSTKRSP=53,[,]响应主动式命令。 Language Notification (53) 设置命令 AT+QSTKGI=53 响应 第一行输出的响应： +QSTKGI: 53,, OK 或者 ERROR 设置命令 AT+QSTKRSP=53,[,] 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: LTE Standard (U)系列_STK_应用指导 27 / 33 LTE Standard Module Series 参数 整型。语言通知命令的详细信息。 Bit 1 0 非特定语言通知 1 特定语言通知 Bit 2–8 RFU 字符串类型。语言代码字符串。由一对字母数字字符组成，在 ISO 639 中定义。 每个字母数字字符使用 3GPP TS 23.038 中定义的 SMS 默认的 7 位编码字母 集编码。 整型。命令结果码。 0 命令执行成功，用户已接受呼叫请求 整型。可选附加命令状态。取值请参考 ETSI TS 102 223。范围：0~255。 错误码。详情参考文档 [1]。 备注 若返回'-'或-，表示参数在当前条件下无效。详情可参考第 3 章。 LTE Standard (U)系列_STK_应用指导 28 / 33 LTE Standard Module Series 3 STK AT 命令示例 3.1. 启用 STK 功能并设置菜单 1. 打开模块并启用 STK 功能。 AT+QSTK=1,1 OK //启用 STK 功能。 2. 重启模块后，将收到第一个主动式命令的 URC，如下所示： +QSTKURC: 37 3. 请求菜单参数信息，并响应菜单设置的主动式命令。 AT+QSTKGI=37 //获取菜单设置的主动式命令信息。 +QSTKGI: 37,0,9,'005500530049004D53615E947528',-,-,-,- +QSTKGI: 37,25,'7CBE54C163A88350',-,- +QSTKGI: 37,33,'6C83901A884C8BC1',-,- +QSTKGI: 37,54,'624B673A84254E1A5385',-,- +QSTKGI: 37,96,'6C8353C28003',-,- +QSTKGI: 37,98,'727960E0793C5305',-,- +QSTKGI: 37,100,'6C8377E597F3',-,- +QSTKGI: 37,102,'6C8373AF7403',-,- +QSTKGI: 37,104,'6C835A314E50',-,- +QSTKGI: 37,105,'8BA48BC152A9624B',-,- OK AT+QSTKRSP=37,0 OK //响应菜单设置的主动式命令。 +QSTKURC: 253 //主动式会话已结束。 LTE Standard (U)系列_STK_应用指导 29 / 33 LTE Standard Module Series 3.2. 选择菜单 1. 选择菜单项 AT+QSTKRSP=253,0,25 OK //选择菜单项，ID 为 25。 2. 选择选项 +QSTKURC: 36 //选择项主动式命令通知。 AT+QSTKGI=36 //获取所选项主动式命令信息。 +QSTKGI: 36,0,9,'7CBE54C163A88350',-,-,-,-,- +QSTKGI: 36,1,'53057F574E078C61',-,- +QSTKGI: 36,2,'5E7D9ED851B77B118BDD',-,- +QSTKGI: 36,3,'59296C14988462A5',-,- +QSTKGI: 36,4,'65B095FB805A7126',-,- +QSTKGI: 36,5,'4F53575B5FEB8BAF',-,- +QSTKGI: 36,6,'4EB24EB25B9D8D1D',-,- +QSTKGI: 36,7,'65C56E38653B7565',-,- +QSTKGI: 36,8,'822A73ED67E58BE2',-,- +QSTKGI: 36,255,'4E0B4E009875',-,- OK AT+QSTKRSP=36,0,1 OK //响应所选项的主动式命令，选项（ID 为 1）被选中。 +QSTKURC: 36 //选择项主动式命令通知。 AT+QSTKGI=36 +QSTKGI: 36,0,3,'',-,-,-,-,+QSTKGI: 36,1,'5B9A5236',-,+QSTKGI: 36,2,'53D66D88',-,+QSTKGI: 36,3,'4E1A52A14ECB7ECD',-,- OK AT+QSTKRSP=36,0,3 //响应所选项的主动式命令，选项（ID 为 3）被选中。 +QSTKURC: 33 //显示文本主动式命令通知。 AT+QSTKGI=33 +QSTKGI: 33,1,'77ED4FE153D190016210529FFF01',-,-,- OK LTE Standard (U)系列_STK_应用指导 30 / 33 LTE Standard Module Series 3.3. STK 会话终止和超时响应 1. 终止 STK 会话 AT+QSTKRSP=253,0,25 OK //选择菜单项，ID 为 25。 +QSTKURC: 36 //选择项主动式命令通知。 AT+QSTKGI=36 //获取所选项的主动式命令信息。 +QSTKGI: 36,0,9,'7CBE54C163A88350',-,-,-,-,- +QSTKGI: 36,1,'53057F574E078C61',-,- +QSTKGI: 36,2,'5E7D9ED851B77B118BDD',-,- +QSTKGI: 36,3,'59296C14988462A5',-,- +QSTKGI: 36,4,'65B095FB805A7126',-,- +QSTKGI: 36,5,'4F53575B5FEB8BAF',-,- +QSTKGI: 36,6,'4EB24EB25B9D8D1D',-,- +QSTKGI: 36,7,'65C56E38653B7565',-,- +QSTKGI: 36,8,'822A73ED67E58BE2',-,- +QSTKGI: 36,255,'4E0B4E009875',-,- OK AT+QSTKRSP=254 OK //终止 STK 会话。 +QSTKURC: 253 //主动式会话已结束。 2. STK 会话超时响应 AT+QSTKRSP=253,0,25 OK //选择菜单项，ID 为 25。 +QSTKURC: 36 AT+QSTKGI=36 //选择项主动式命令通知。 //获取所选项的主动式命令信息。 +QSTKGI: 36,0,9,'7CBE54C163A88350',-,-,-,-,- +QSTKGI: 36,1,'53057F574E078C61',-,- +QSTKGI: 36,2,'5E7D9ED851B77B118BDD',-,- +QSTKGI: 36,3,'59296C14988462A5',-,- +QSTKGI: 36,4,'65B095FB805A7126',-,- +QSTKGI: 36,5,'4F53575B5FEB8BAF',-,- +QSTKGI: 36,6,'4EB24EB25B9D8D1D',-,- +QSTKGI: 36,7,'65C56E38653B7565',-,- +QSTKGI: 36,8,'822A73ED67E58BE2',-,- +QSTKGI: 36,255,'4E0B4E009875',-,- LTE Standard (U)系列_STK_应用指导 31 / 33 OK +QSTKURC: 255,36 +QSTKURC: 253 LTE Standard Module Series //STK 会话超时响应。 //主动式会话已结束，并进入主菜单（不同的(U)SIM 卡可能具 有不同的表现）。 3.4. 禁用 STK 功能 禁用 STK 功能后，应重新启动模块。 AT+QSTK=0 OK //禁用 STK 功能。 LTE Standard (U)系列_STK_应用指导 32 / 33 LTE Standard Module Series 4 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_AT 命令手册 表 6：术语缩写 缩写 ME TA MS DTE STK URC SMS RFU 英文全称 Mobile Equipment Terminal Adapter Mobile Station Data Terminal Equipment SIM Application Toolkit Unsolicited Result Code Short Message Service Reserved for Future Use 中文全称 移动设备 终端适配器 移动台 数据终端设备 (U)SIM 应用工具包 非请求结果码 短消息服务 保留备用 LTE Standard (U)系列_STK_应用指导 33 / 33

LTE Standard(A)系列 TCP/IP 应用指导 LTE Standard 模块系列 版本：1.6 日期：2023-10-30 状态：受控文件 LTE Standard(A)系列 TCP/IP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 56 LTE Standard(A)系列 TCP/IP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 56 LTE Standard(A)系列 TCP/IP 应用指导 文档历史 修订记录 版本 1.0 日期 2019-10-28 作者 Larson LI 1.1 2019-10-30 Larson LI 1.2 2020-07-24 Larson LI 1.3 2021-04-20 Larson LI 1.4 2022-03-02 Larson LI 变更表述 初始版本 1. 更新参数 APN 鉴权方式取值含义 （第 2.1.1 章） 2. 更新参数取值范围（第 2.1.4 章、第 2.1.6 章和第 2.1.12 章） 1. 增加文档适用模块 EG912Y 系列和 EC200S-CN 2. 更新 AT+QICFG='tcp/keepalive'中的取 值范围（第 2.2.15 章） 3. 新增如下 AT 命令： ⚫ AT+QICFG='viewmode' ⚫ AT+QICFG='passiveclosed' ⚫ AT+QICFG='recvind' ⚫ AT+QICFG='tcp/accetp' 1. 增加文档适用模块 EC200N-CN 和 EC600N-CN 2. 更新参数取值范围（第 2.3.1 章） 3. 新增如下 AT 命令（第 2.3.15 章）： ⚫ AT+QICFG='tcp/retranscfg' ⚫ AT+QICFG='send/buffersize' ⚫ AT+QICFG='send/auto' ⚫ AT+QICFG='recv/ignore' ⚫ AT+QICFG='formatcfg' ⚫ AT+QICFG='qisend/timeout' ⚫ AT+QICFG='close/mode' 1. 增加文档适用模块 EC200A 系列、EC800N-CN 和 EG915N-EU。 2. 删除 EG912Y-CN 模块。 3. 新增设置命令 AT+QICFG='TCP/SendMode' （第 2.3.1 章）。 上海移远通信技术股份有限公司 3 / 56 LTE Standard(A)系列 TCP/IP 应用指导 1. 更新适用模块： ⚫ 新增 EC200M-CN、EC600M-CN、EC800M-CN、 EG810M-CN 和 EG912N-EN； ⚫ 更新 EG915N-EU 为 EG915N 系列； ⚫ 删除 EC200T 系列和 EC600S-CN。 1.5 2023-01-11 Larson LI 2. 删除 TCP/IP AT 命令使用流程图中的 AT+CREG?命 令（第 1.2 章）。 3. 新增如下 AT 命令（第 2.3.1 章）： ⚫ AT+QICFG='sendinfo' ⚫ AT+QICFG='pdp/retry'。 1. 更新适用模块： ⚫ 新增 EC600K-CN、EC800K 系列、EG800K 系 列和 EG950A 系列； ⚫ 更新 EC200N-CN 为 EC200N 系列。 2. 新增 AT+QICFG='wakeup/data'和 URC +QIURC: 'wakeup/data'（第 2.3.1 章和第 2.4.6 章）。 1.6 2023-10-23 Fawei ZHOU 3. 新增 AT+QICFG='send/auto' 的 和 参数（第 2.3.1 章）。 4. 新增 AT+QICFG='recv/ignore' 的 参数（第 2.3.1 章）。 5. 新增 AT+QICFG 相关备注（第 2.3.1 章）。 6. 新增 TCP 可选项配置示例（第 3.10 章）。 上海移远通信技术股份有限公司 4 / 56 LTE Standard(A)系列 TCP/IP 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 5 表格索引 ........................................................................................................................................................ 7 1 引言 ........................................................................................................................................................ 8 1.1. 适用模块 ...................................................................................................................................... 8 1.2. 使用 TCP/IP AT 命令的流程........................................................................................................ 9 1.3. 数据访问模式说明 ..................................................................................................................... 11 2 TCP/IP AT 命令详解 ............................................................................................................................ 13 2.1. AT 命令说明 .............................................................................................................................. 13 2.1.1. 定义 ................................................................................................................................ 13 2.1.2. AT 命令语句 ................................................................................................................... 13 2.2. AT 示例声明 .............................................................................................................................. 14 2.3. AT 命令说明 .............................................................................................................................. 14 2.3.1. AT+QICFG 配置可选参数............................................................................................ 14 2.3.2. AT+QICSGP 配置 TCP/IP 场景参数............................................................................ 22 2.3.3. AT+QIACT 激活 PDP 场景 .......................................................................................... 24 2.3.4. AT+QIDEACT 去激活 PDP 场景 ................................................................................. 25 2.3.5. AT+QIOPEN 打开 Socket 服务 ................................................................................... 25 2.3.6. AT+QICLOSE 关闭 Socket 服务 ................................................................................. 27 2.3.7. AT+QISTATE 查询 Socket 服务状态........................................................................... 28 2.3.8. AT+QISEND 发送数据................................................................................................. 30 2.3.9. AT+QIRD 读取收到的 TCP/IP 数据 ............................................................................. 32 2.3.10. AT+QISENDEX 发送 16 进制字符串数据.................................................................... 34 2.3.11. AT+QISWTMD 切换数据访问模式 .............................................................................. 35 2.3.12. AT+QPING 进行远程服务器 Ping 操作 ....................................................................... 35 2.3.13. AT+QNTP 使用 NTP 服务器同步本地时间.................................................................. 37 2.3.14. AT+QIDNSCFG 配置 DNS 服务器地址....................................................................... 38 2.3.15. AT+QIDNSGIP 用域名获取 IP 地址............................................................................. 38 2.3.16. AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 ............................................... 39 2.3.17. AT+QIGETERROR 查询上一个 AT 命令错误代码 ...................................................... 40 2.4. URC 说明 .................................................................................................................................. 40 2.4.1. +QIURC: 'closed' 连接断开通知 ................................................................................. 41 2.4.2. +QIURC: 'recv' 数据接收通知..................................................................................... 41 2.4.3. +QIURC: 'incoming full' 客户端连接已满通知 ............................................................ 42 2.4.4. +QIURC: 'incoming' 客户端连接通知 ......................................................................... 42 2.4.5. +QIURC: 'pdpdeact' PDP 去激活通知........................................................................ 42 2.4.6. +QIURC: 'wakeup/data' 唤醒报文数据接收通知 ........................................................ 43 3 示例 ...................................................................................................................................................... 44 3.1. 场景配置和激活 ......................................................................................................................... 44 3.1.1. 场景配置 ......................................................................................................................... 44 上海移远通信技术股份有限公司 5 / 56 LTE Standard(A)系列 TCP/IP 应用指导 3.1.2. 场景激活 ......................................................................................................................... 44 3.1.3. 场景去激活 ..................................................................................................................... 44 3.2. TCP 客户端在缓存模式下工作 .................................................................................................. 44 3.2.1. 创建 TCP 客户端连接并进入缓存模式 ........................................................................... 44 3.2.2. Buffer 模式下发送数据 ................................................................................................... 45 3.2.3. Buffer 模式下从远程服务器接收数据.............................................................................. 45 3.2.4. 断开连接 ......................................................................................................................... 46 3.3. TCP 客户端在透传模式下工作 .................................................................................................. 46 3.3.1. 创建 TCP 客户端连接并进入透传模式 ........................................................................... 46 3.3.2. 透传模式下发送数据....................................................................................................... 46 3.3.3. 透传模式接收远程器端数据 ............................................................................................ 46 3.3.4. 断开 TCP 客户端连接 ..................................................................................................... 46 3.4. TCP 客户端在直吐模式下工作 .................................................................................................. 47 3.4.1. 创建 TCP 客户端连接并进入直吐模式 ........................................................................... 47 3.4.2. 直吐模式下发送数据....................................................................................................... 47 3.4.3. 直吐模式下接收远程服务器端数据 ................................................................................. 47 3.4.4. 断开 TCP 用户端连接 ..................................................................................................... 47 3.5. TCP 服务器在缓存模式下工作 .................................................................................................. 48 3.5.1. 启动 TCP 服务器 ............................................................................................................ 48 3.5.2. 接受客户端的连接请求 ................................................................................................... 48 3.5.3. 接收的客户端数据 .......................................................................................................... 48 3.5.4. 断开 TCP 服务器连接 ..................................................................................................... 49 3.6. UDP 服务示例 ........................................................................................................................... 49 3.6.1. 打开 UDP 服务 ............................................................................................................... 49 3.6.2. 向服务器发送 UDP 数据................................................................................................. 49 3.6.3. 接收远程端数据 .............................................................................................................. 50 3.6.4. 关闭 UDP 服务 ............................................................................................................... 50 3.7. PING.......................................................................................................................................... 50 3.8. 同步本地时间............................................................................................................................. 51 3.9. 获取上一个错误代码示例 .......................................................................................................... 51 3.10. TCP 可选配置项示例................................................................................................................. 51 4 错误代码 ............................................................................................................................................... 53 5 附录 参考文档及术语缩写 ................................................................................................................... 55 上海移远通信技术股份有限公司 6 / 56 LTE Standard(A)系列 TCP/IP 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 8 表 2：AT 命令类型 ..................................................................................................................................... 13 表 3：错误代码列表.................................................................................................................................... 53 表 4：参考文档 ........................................................................................................................................... 55 表 5：术语缩写 ........................................................................................................................................... 55 上海移远通信技术股份有限公司 7 / 56 LTE Standard(A)系列 TCP/IP 应用指导 1 引言 移远通信 LTE Standard(A)系列模块内置 TCP/IP 协议栈，Host 可以直接通过 AT 命令访问网络；这极 大降低了模块对 PPP 和外部 TCP/IP 协议栈的依赖性，从而降低终端设计的成本。 LTE Standard(A)系列模块可提供 TCP 客户端、UDP 客户端、TCP 服务器和 UDP 服务器等 Socket 服务。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 上海移远通信技术股份有限公司 模块 EC200A 系列 EC200M-CN EC200N 系列 EC200S 系列 EC600M-CN EC600N-CN EC600K-CN EC800M-CN EC800N-CN EC800K 系列 EG800K 系列 EG810M-CN EG912N-EN 8 / 56 LTE Standard(A)系列 TCP/IP 应用指导 EG912Y-EU EG915N 系列 EG950A 系列 1.2. 使用 TCP/IP AT 命令的流程 通过 TCP/IP AT 命令，Host 可以配置 PDP 场景、激活/去激活 PDP 场景、打开/关闭 Socket 服务，并 通过 Socket 服务发送/接收数据。TCP/IP AT 命令的使用流程如下图所示： 上海移远通信技术股份有限公司 9 / 56 LTE Standard(A)系列 TCP/IP 应用指导 建议开关机流程： 1.关机：发送AT+QPOWD，等待12 s以 上，直接断电。 2. 开机：先使Power Key按键处于低电平 状态，等待2 s后，再拉高Power Key 查询(U)SIM卡状态： 执行AT+CPIN，如果20 s后命令 'AT+CPIN'无法识别(U)SIM卡状态，建议 重启模块 PS 业务： 1. 当 AT+CGREG?/AT+CEREG? 结果中 的等于 1 或者5，表示模块已在 UMTS/LTE网络注册上PS业务 2. 等待60 s后，不管是否注册上PS业务， 都进入下一个流程 配置PDP Context激活参数： 1. 通过 AT+QICSGP 命令配置APN， User Name，Password 和Auth Type 2. 通过 AT+CGQMIN/AT+CGEQMIN/ AT+CGQREQ/AT+CGEQREQ 配置 QoS 参数 给模块上电并开机 发送AT命令并等待响应结果OK 通过AT+CPIN?命令 查询(U)SIM卡状态 如果在20 s内无法识别 (U)SIM状态，建议重启模块 识别(U)SIM卡 60 s内通过 AT+CGREG?/AT+CEREG?命 令查询PS业务的状态 如果获取 PS 状态失败，建议 重新配置 PDP 上下文，然后 执行 AT+CFUN=0 和 AT+CFUN=1。 如果仍然获 取失败，建议重启模块。 通过如下AT命令来配置PDP场景和QoS 参数:AT+QICSGP/AT+CGQREQ/ AT+CGEQREQ/AT+CGQMIN/ AT+CGEQMIN 激活PDP Context： 1. 通过 AT+QIACT= 激活PDP Context 2. 通过 AT+QIACT? 查询PDP Context IP地址 注意事项： a) 以上命令必须按顺序执行 b) 如果等待150 s后，AT+QIACT 没有响应，建议重启模块. c) 如果连续3次反激活PDP Context 失败，建议重启模块 3. 反激活PDP Context：如果等待 40s后AT+QIDEACT没有响应，建 议重启模块 如果等待 40 s,没有响 应，建议重启 模块 PDP Context 反 激活成功 通过 AT+QIACT= 和AT+QIACT命令激活指定 的PDP Context 1. 如果等待150 s后，没有收到 结果，建议重启模块. 2. 如果连续3次反激活PDP context失败，建议重启模块 PDP Context激 活失败 PDP Context激活成功 通过AT+QIDE ACT=反激活 指定的PDP Context 通过AT+QIOPEN命令 打开连接 1. 连续5次打开连接失败 2. 150 s内无响应 +QIOPEN:, 打开连接： 1. 如果等待150 s，没有收到AT+QIOPEN的响应，请关闭 连接。 2.如果连续5次打开连接失败，先反激活PDP Context，然后 重新激活PDP Context并再次打开连接。 通过AT+QISEND=命令 发送数据 在收到ACK 90 s 后 TCP连接的维护和检测： 1. 通过 AT+QISEND=[,] 发送数据。 建议定期向远程端发送小数据包以维护和检测TCP连接。 2. 通过 AT+QISEND=,0 查询ACK的发送。 如果在2分钟后（每5 s查询一次，一共查询24次），对方没有收到数据， 说明TCP连接可能出现异常，请执行AT+QICLOSE命令关闭这个TCP连 接，然后通过AT+QIOPEN重新建立TCP连接。 通过AT+QISEND= ,0查询发送的 数据是否成功被接收 90 s内未收到ACK 通过 AT+QICLOSE OK = 关闭连接 如果等待10 s，无响应，建议重启 模块 注意事项： 1.请注意必须接收到上一个AT命令的执行结果后（例如：OK/CME ERROR/CMS ERROR），才能执行下一个AT命令。一般情况下，如果在 60 s内 没有收到AT命令执行结果，建议重启模块。 2.若150 s内未收到AT+QIACT响应，10 s内未收到AT+QICLOSE响应，40 s内未收到AT+QIDEACT响应，建议重启模块。 3.不建议频繁重启模块。如果因为执行AT命令连续3次重启模块失败，此后第一次可立即重启，然后等待10分钟，再进行第二次重启，如果仍重启失 败，建议等待30分钟，再进行第三次重启，以此类推，逐渐增大重启的时间间隔。 图 1：TCP/IP AT 命令使用流程图 上海移远通信技术股份有限公司 10 / 56 LTE Standard(A)系列 TCP/IP 应用指导 1.3. 数据访问模式说明 LTE Standard(A)系列模块支持以下 3 种数据访问模式： ⚫ 缓存模式 ⚫ 直吐模式 ⚫ 透传模式 当使用 AT+QIOPEN 打开 Socket 服务时，可以通过来指定 Socket 的数据访问模式； 当 Socket 服务成功打开后，可以通过 AT+QISWTMD 切换数据访问模式。 1. 缓存模式下，可以通过 AT+QISEND 发送数据。从网络接收数据时，模块会缓存所接收的数据， 并直接上报 URC +QIURC: 'recv',，之后用户可以通过 AT+QIRD 来读取缓存数据。 2. 直吐模式下，可以通过 AT+QISEND 发送数据。从网络接收数据时，数据会以如下格式直接输出 到 COM 口：+QIURC: 'recv',,或+QIURC: 'recv',,,,。 3. 透传模式下，相对应的串口（比如 UART 口、USB Modem 口等）会进入独占模式，通过 COM 口接收的数据会直接发送到网络端，从网络接收到的数据会从 COM 口直接输出。+++可以用来退 出透传模式：当输入+++返回 OK 后，访问模式就会切换到缓存模式，如需切换回透传模式，可使 用 AT+QISWTMD。 ⚫ 退出透传模式 用户可以通过+++或者 DTR（需先设置 AT&D1）两种方式退出透传模式，为了防止+++被当成数据发 送，实际操作时必须遵循以下步骤： 1） +++输入前 1 秒或更长时间内不能输入其它任何数据； 2） 必须在 1 秒内输入+++，并且不能输入其它任何数据； 3） +++输入后 1 秒内不能输入其它任何数据； 4） 通过+++或者 DTR（设置 AT&D1）方式使模块退出透传模式，直到模块返回 OK；此时模块成功退 出透传模式。 ⚫ 切换到透传模式 1） 通过执行 AT+QISWTMD：执行此命令时，指定为 2；若返回 CONNECT，则表 示成功切换至透传模式。 2） 通过 ATO 方式：退出透传模式后，可通过 ATO 再切换回至透传模式；若返回 CONNECT，则表示 成功切换至透传模式。若模块之前未曾进入过透传模式，执行 ATO 则会返回 NO CARRIER。 上海移远通信技术股份有限公司 11 / 56 LTE Standard(A)系列 TCP/IP 应用指导 备注 1. 在缓存模式下，如果缓存不为空，直到通过 AT+QIRD 读取缓存里面所有接收的数据后，模块才会 上报一个新的 URC。 2. 在透传模式下，不可执行 AT 命令。若因网络错误或者其他原因导致 Socket 连接断开，模块会上报 NO CARRIER，并退出透传模式，在这种情况下可以执行 AT+QICLOSE 来关闭 Socket 服务。 上海移远通信技术股份有限公司 12 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2 TCP/IP AT 命令详解 本章节主要描述和 TCP/IP 相关的 AT 命令。 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 13 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令说明 2.3.1. AT+QICFG 配置可选参数 该命令用于配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应 +QICFG: 'transpktsize',(支持的范围) +QICFG: 'transwaittm',(支持的范围) +QICFG: 'dataformat',(支持的列表),(支 持的列表) +QICFG: 'viewmode',(支持的列表) +QICFG: 'passiveclosed',(支持的列表) +QICFG: 'udp/readmode',(支持的列表) +QICFG: 'udp/sendmode',(支持的列表) +QICFG: 'tcp/keepalive',(支持的列表),(支持的范围),(支持的范围),(支持的 范围) +QICFG: 'recvind',(支持的列表) +QICFG: 'tcp/retranscfg',(支持的范围),(支持 的范围) +QICFG: 'tcp/accept',(支持的列表) +QICFG: 'send/buffersize',(支持的范围) +QICFG: 'send/auto',(支持的范围),(支持的范围),(发送的数据),(支持的 范围),(支持的范围) +QICFG: 'recv/ignore',(支持的范围),(过滤的数据),(支持的范围) +QICFG: 'formatcfg',(支持的范围) +QICFG: 'qisend/timeout',(支持的范围) +QICFG: 'close/mode',(支持的范围) +QICFG: 'sendinfo',(支持的列表) +QICFG: 'TCP/SendMode',(支持的列表) +QICFG: 'pdp/retry',(支持的列表),(支持的列表),(支持的范围),(支持的范围) +QICFG: 'wakeup/data',( 支 持 的 范 围),,(支持的范围) 设置命令 设置待发数据最大长度 AT+QICFG='transpktsize'[,] OK 响应 若省略可选参数，则查询当前配置： +QICFG: 'transpktsize', OK 若指定可选参数，则设置待发数据最大长度： OK 如有错误： 设置命令 ERROR 响应 设置透传模式下，自动发送数据前的 若省略可选参数，则查询当前配置： 等待时间 +QICFG: 'transwaittm', AT+QICFG='transwaittm'[,] OK 若指定可选参数，则设置透传模式下，自动发送数据前的等待时间： OK 如有错误： 设置命令 ERROR 响应 设置收发数据格式（仅限非透传模式） 若省略可选参数，则查询当前配置： AT+QICFG='dataformat'[,<send_ +QICFG: 'dataformat',,, t>] OK 若指定可选参数，则设置收发数据格式： OK 设置命令 设置已接收数据的输出格式（仅限非 透传模式） AT+QICFG='viewmode'[,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'viewmode', OK 上海移远通信技术股份有限公司 15 / 56 LTE Standard(A)系列 TCP/IP 应用指导 若指定可选参数，则设置已接收数据的输出格式： OK 设置命令 设置是否在服务器关闭时被动关闭 TCP 连接 AT+QICFG='passiveclosed'[,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'passiveclosed', OK 若指定可选参数，则设置是否在服务器关闭时被动关闭 TCP 连接： OK 设置命令 设置 UDP 数据的读取模式 AT+QICFG='udp/readmode'[,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'udp/readmode', OK 若指定可选参数，则设置 UDP 数据的读取模式： OK 设置命令 设置 UDP 数据的发送模式 AT+QICFG='udp/sendmode'[,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'udp/sendmode', OK 若指定可选参数，则设置 UDP 数据的发送模式： OK 设置命令 设置是否发送 TCP 保活信息 AT+QICFG='tcp/keepalive'[,[,,, ]] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/keepalive',[,,,] 上海移远通信技术股份有限公司 16 / 56 LTE Standard(A)系列 TCP/IP 应用指导 OK 若指定可选参数，则设置是否发送 TCP 保活信息： OK 如有错误： 设置命令 ERROR 响应 设置在缓存模式下，模块接收到数据 若省略可选参数，则查询当前配置： 后上报的 URC 是否显示数据长度 +QICFG: 'recvind', AT+QICFG='recvind'[,] OK 若指定可选参数，则设置接收到数据后上报的 URC 是否显示数据 长度： OK 设置命令 设置重传次数和重传间隔 AT+QICFG='tcp/retranscfg'[,,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/retranscfg',, OK 若指定可选参数，则设置重传次数和重传间隔： OK 设置命令 启用或禁用自动接收来自客户端的 TCP 连接 AT+QICFG='tcp/accept'[,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'tcp/accept', OK 若指定可选参数，则设置是否自动接收来自客户端的 TCP 连接： OK 设置命令 设置单次发送数据的最大长度 AT+QICFG='send/buffersize'[,<b 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'send/buffersize', 上海移远通信技术股份有限公司 17 / 56 LTE Standard(A)系列 TCP/IP 应用指导 uffer_size>] OK 若指定可选参数，则设置单次发送数据的最大长度： OK 设置命令 设置周期性发送心跳包数据 AT+QICFG='send/auto',[,[,][,< data_format>][,]] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'send/auto',,,,, OK 若指定可选参数，则设置发送心跳包的周期和数据： OK 设置命令 设置过滤指定数据 AT+QICFG='recv/ignore',[,][,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'recv/ignore',[,][,] OK 若指定可选参数，则设置要过滤的数据： OK 设置命令 设置发送 AT+QISEND 命令返回>的 格式 AT+QICFG='formatcfg'[, ] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'formatcfg', OK 若指定可选参数，则设置>输出格式： OK 如有错误： ERROR 上海移远通信技术股份有限公司 18 / 56 LTE Standard(A)系列 TCP/IP 应用指导 设置命令 设置发送 AT+QISEND 命令的最大响 应时间 AT+QICFG='qisend/timeout'[,] 响应 若省略可选参数，则查询当前配置： +QICFG: 'qisend/timeout', OK 若指定可选参数，则设置输出>后的超时时间： OK 设置命令 设置异步断开 TCP 连接 AT+QICFG='close/mode'[,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'close/mode', OK 若指定可选参数，则设置异步断开 TCP 连接： OK 如有错误： ERROR 设置命令 启 用 或 禁 用 以 URC 形 式 显 示 AT+QISEND 或 AT+QISENDEX 返回 信息 响应 若省略可选参数，则查询当前配置： +QICFG: 'sendinfo', AT+QICFG='sendinfo'[,] 若 指 定 可 选 参 数 ， 则 设 置 启 用 或 禁 用 以 URC 形 式 显 示 AT+QISEND 或 AT+QISENDEX 返回信息： OK 设置命令 设置 SEND OK 返回模式 AT+QICFG='TCP/SendMode'[,] 如有错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'TCP/SendMode', OK 若指定可选参数，则设置 SEND OK 返回模式： OK 如有错误： 上海移远通信技术股份有限公司 19 / 56 LTE Standard(A)系列 TCP/IP 应用指导 ERROR 设置命令 设置 PDP 激活或去激活重试次数和时 间 AT+QICFG='pdp/retry',,[,,] 响应 若省略可选参数，则查询当前配置： +QICFG: 'pdp/retry',,,, OK 若指定可选参数，则设置 PDP 激活或去激活重试次数和时间： OK 设置命令 设置唤醒报文数据 AT+QICFG='wakeup/data',[,[,]] 如有错误： ERROR 响应 若省略可选参数，且之前未配置过，则查询当前配 置： +QICFG: 'wakeup/data',,,0 OK 若省略可选参数，但之前已配置过，则查询当前配 置： +QICFG: 'wakeup/data',,, OK 若指定可选参数，则设置唤醒报文数据： OK 最大响应时间 特性说明 如有错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。透传模式下，待发数据包最大长度。范围：1~1460；默认值：1024； 单位：字节。 整型。透传模式下，待发数据小于时，自动发送数据前的等待 时间。范围：0~20；默认值：2；单位：100 毫秒。 上海移远通信技术股份有限公司 20 / 56 LTE Standard(A)系列 TCP/IP 应用指导 整型。发送数据格式。当设置为 16 进制模式时，不需要带 0x 前缀，模块会自 动将两个字节拼成一个 ASCII 码。 0 文本模式 1 十六进制模式 整型。接收数据格式。当设置为 16 进制模式时，不需要带 0x 前缀，模块会自 动将两个字节拼成一个 ASCII 码。 0 文本模式 1 十六进制模式 整型。 0 接收数据的输出方式：data headerrndata. 1 接收数据的输出方式：data header,data. 整型。启用或禁用 TCP 连接在服务器关闭后自动断开。 0 禁用 1 启用 整型。 0 禁用块模式 1 启用流模式 整型。启用或禁用发送 TCP 保活信息。 0 禁用 1 启用 整型。触发保活循环时间。范围：1~1800；单位：秒。 整型。在循环时间内发送数据包间隔时间。范围：25~100；单位：秒。 整型。在循环时间内发送数据包的次数。范围：3~10。 整型。在缓存模式下，启用或禁用在 TCP/IP 缓冲区模式下接收数据后上报的 URC 中显示的数据长度。 0 禁用 1 启用 整型。在循环时间内重连次数。范围：3~12。 整型。在循环时间内重连间隔。范围：5~1000；单位：毫秒。 整型。 0 禁用自动接受来自客户端的 TCP 连接 1 启用自动接受来自客户端的 TCP 连接 整型。一次最大发送的字节数。范围：1460~10240。 整型。Socket 连接号。范围：0~11。 整型。设置发送心跳包的时间周期。范围：20~86400；单位：秒。 字符串类型。发送心跳包内容。 字符串类型。过滤数据内容。 整型。控制>的输出格式。 0 0D0A> 1 0D0A>0D0A 整型。发送数据超时时间。范围 0~120；单位：秒。 整型。启用或禁用异步断开 TCP 连接。 0 禁用 1 启用 上海移远通信技术股份有限公司 21 / 56 LTE Standard(A)系列 TCP/IP 应用指导 整型。启用或禁用以 URC 形式显示 AT+QISEND 或 AT+QISENDEX 返回信 息。 0 禁用 1 启用 整型。SEND OK 返回模式。 0 发送数据后立即返回 SEND OK 1 收到服务器 ACK 后返回 SEND OK 2 收到服务器 ACK 后返回,SEND OK 3 收到服务器 ACK 后上报+QIURC: SEND OK 4 收到服务器 ACK 后上报+QIURC: ,SEND OK 整型。设置 PDP 激活或去激活模式。 0 去激活模式 1 激活模式 整型。设置网络制式类型。 0 4G 模式 1 2G 模式 整型。重试次数。范围：2~4；默认值：4。 实际执行激活或去激活的次数=的取值+1。 整型。单次执行激活或去激活的最大时间。单位：秒。 字符串类型。唤醒报文数据。 整型。输入的报文数据类型。 0 输入的数据为十六进制 ASCII 码（自动转换为十六进制字符串处理） 1 输入的数据为十六进制字符串 2 输入的数据为字符串 整型。重试次数。范围：0~10。 备注 1. 若配置为 2，即输入的数据为字符串类型，则需注意字符串数据中不能包含特殊字符 （如 ASCII 特殊控制字符和转义字符等），否则需配置为 0 或 1。 2. AT+QICFG='wakeup/data'配置完指定的数据后，服务器下发的其他数据均会被丢弃，仅当报文数 据被唤醒时或者网络发生异常事件时，才会通知 MCU 唤醒。 2.3.2. AT+QICSGP 配置 TCP/IP 场景参数 该命令用于配置、和以及其他 TCP/IP 场景参数。QoS 配置需通过 AT+CGQMIN、AT+CGEQMIN、AT+CGQREQ 和 AT+CGEQREQ；有关所述 AT 命令的详情，请参考 文档 [1]。 AT+QICSGP 配置 TCP/IP 场景参数 测试命令 AT+QICSGP=? 响应 +QICSGP: (支持的范围),(支持的范围),,,,(支持的范围),(支持的列表) 设置命令 查询指定场景配置 AT+QICSGP= OK 响应 +QICSGP: ,,,, OK 设置命令 配置指定场景 AT+QICSGP=[,,[,,)[,[,]]]] 响应 OK 如有错误： ERROR 最大响应时间 / 特性说明 该命令立即生效； 参数配置自动保存。 参数 整型。场景 ID。范围：1~15。 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型。接入点名称。 字符串类型。用户名。最大长度：127 字节。 字符串类型。密码。最大长度：127 字节。 整型。APN 鉴权方式。 0 None 1 PAP 2 CHAP 3 PAP 或 CHAP 整型。是否在 CDMA 网络下保存和。 0 不保存 1 保存 举例 AT+QICSGP=1 +QICSGP: 1,'','','',0 //查询场景 1 配置。 上海移远通信技术股份有限公司 23 / 56 OK AT+QICSGP=1,1,'UNINET','','',1 OK LTE Standard(A)系列 TCP/IP 应用指导 //配置场景 1，APN 配置为'UNINET'（中国联通）。 2.3.3. AT+QIACT 激活 PDP 场景 在用 AT+QIACT 激活 PDP 场景前，需要使用 AT+QICSGP 配置场景。场景激活后，可以通过 AT+QIACT? 查询 IP 地址。 虽然的范围为 1~15，但是模块最多仅可同时激活 3 路 PDP 场景。受网络状态影响，执行 AT+QIACT 后，等待返回结果 OK 或者 ERROR 的最大时间为 150 秒，在结果尚未返回之前，无法执行任 何 AT 命令。 AT+QIACT 激活 PDP 场景 测试命令 AT+QIACT=? 响应 +QIACT: (支持的范围) 查询命令 AT+QIACT? OK 响应 返回当前所有被激活的场景与 IP 地址： +QIACT: 1,,, ..... +QIACT: 15,,, 设置命令 AT+QIACT= OK 响应 激活指定场景： OK 最大响应时间 特性说明 如有错误： ERROR 受网络状态影响，最大响应时间 150 秒。 / 参数 整型。场景 ID。范围：1~15。 整型。场景状态。 0 去激活 上海移远通信技术股份有限公司 24 / 56 LTE Standard(A)系列 TCP/IP 应用指导 1 激活 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型。场景激活后的本地 IP 地址。 2.3.4. AT+QIDEACT 去激活 PDP 场景 该命令用于去激活特定场景，断开在这个场景内建立的所有 TCP/IP 连接。受网络状态影响，执行 AT+QIDEACT 后，等待返回结果 OK 或者 ERROR 的最大时间为 40 秒。在结果尚未返回之前，无法执行 任何 AT 命令。 AT+QIDEACT 去激活 PDP 场景 测试命令 AT+QIDEACT=? 响应 +QIDEACT: (支持的范围) 设置命令 激活指定 PDP 场景 AT+QIDEACT= 最大响应时间 特性说明 OK 响应 OK 如有错误： ERROR 受网络状态影响，最大响应时间 40 秒。 / 参数 整型。场景 ID。范围：1~15。 2.3.5. AT+QIOPEN 打开 Socket 服务 该命令用于打开 Socket 服务。服务类型可通过指定，数据访问模式（缓存模式，直吐 模式和透传模式）可通过配置，URC +QIOPEN 将指示 Socket 服务是否成功打开。 1. 如果是'TCP LISTENER'，那么模块作为 TCP 服务器使用。接受一个新的 TCP 连 接 后 ， 模 块 会 自 动 指 定 一 个 并 上 报 URC +QIURC: 'incoming',,,,；其中范围为 0~11；所述新连接的请求类型为'TCP INCOMING'，它的值和'TCP LISTENER' 的该参数值一样。 上海移远通信技术股份有限公司 25 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2. 如果是'UDP SERVICE'，则可通过向远程 IP 收发 UDP 数据。 ⚫ 发送数据：执行 AT+QISEND=,,,。 ⚫ 在 直 吐 模 式 下 接 收 数 据 ： 模 块 会 上 报 URC +QIURC: 'recv',,,,。 ⚫ 在缓存模式下接收数据：模块会上报 URC +QIURC: 'recv',，然后用户可通过 AT+QIRD=读取数据。 3. 等待+QIOPEN: ,输出，建议等待 150 秒；如果 150 秒内未接收到该 URC，则 需通过 AT+QICLOSE 来关闭 Socket。 AT+QIOPEN 打开 Socket 服务 测试命令 AT+QIOPEN=? 响应 +QIOPEN: (支持的范围),(支持的 范围),'TCP/UDP/TCP LISTENER/UDP SERVICE','/',,,(支 持的范围) OK 设置命令 AT+QIOPEN=,,,'/',[,[,]] 响应 如果数据访问模式是透传模式（=2）并且成 功打开服务： CONNECT 如有错误： ERROR 可以通过 AT+QIGETERROR 获悉错误描述。 如果数据访问模式是缓存模式（=0）或者直 吐模式（=1）： OK +QIOPEN: , 最大响应时间 特性说明 当服务成功打开，是 0，其他情况下不是 0。 受网络状态影响，最大响应时间 150 秒。 / 参数 整型。场景 ID。范围：1~15。 整型。Socket 连接号。范围：0~11。 字符串类型。Socket 服务类型。 上海移远通信技术股份有限公司 26 / 56 LTE Standard(A)系列 TCP/IP 应用指导 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'UDP SERVICE' 建立 UDP 服务 字符串类型。 如 果 是 'TCP' 或 者 'UDP', 则 为 远 程 服 务 器 的 IP 地 址 ， 例 如 220.180.239.212。 如果是'TCP LISTENER'或者'UDP SERVICE'，请输入 127.0.0.1。 字符串类型。远程服务器的域名地址。 整型。远程服务器端口。范围：0~65535。仅当是'TCP'或者'UDP' 时才有效。 整型。本地端口。范围：0~65535。 如果是'TCP LISTENER'或者'UDPSERVICE'，该参数必须指定。 如果是'TCP'或者'UDP'，且是 0，那么将会自动分 配本地端口；否则本地端口会被指定。 整型。Socket 服务的数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 错误码。请参考第 4 章。 2.3.6. AT+QICLOSE 关闭 Socket 服务 该命令用于关闭特定的 Socket 服务。受网络状态影响，执行 AT+QICLOSE 后，等待返回结果 OK 或 者 ERROR 的最大时间为 10 秒（此为默认值，可以通过来修改）。在结果尚未返回之前，无法 执行任何 AT 命令。 AT+QICLOSE 关闭 Socket 服务 测试命令 AT+QICLOSE=? 响应 +QICLOSE: (支持的范围),(支持的范 围) OK 设置命令 AT+QICLOSE=[,] 响应 关闭成功： OK 最大响应时间 特性说明 关闭失败： ERROR 默认 10 秒，取决于取值 / 上海移远通信技术股份有限公司 27 / 56 LTE Standard(A)系列 TCP/IP 应用指导 参数 整型。Socket 连接号。范围：0~11。 整型。输出响应结果的超时时间值。若未在时间范围内接收到其他客户端的 FIN ACK，模块会强制关闭 Socket。范围：0~65535；默认值：10；单位：秒。 2.3.7. AT+QISTATE 查询 Socket 服务状态 该命令用于查询 Socket 服务状态。若为 0，则返回在特定场景下现存所有 Socket 服务 的状态；若为 1，则返回特定 Socket 服务的状态。 AT+QISTATE 查询 Socket 服务状态 测试命令 AT+QISTATE=? 查询/执行命令 AT+QISTATE?或 AT+QISTATE 响应 OK 响应 返回现存所有连接状态： +QISTATE: ,,,< remote_port>,,,,< serverID>,, … 设置命令 若为 0，查询特定场景下 的连接状态 AT+QISTATE=, OK 响应 返回特定场景下现存所有连接的状态： +QISTATE: ,,,< remote_port>,,,,< serverID>,, … OK 设置命令 若为 1，查询特定 Socket 服务连接状态 AT+QISTATE=, 响应 +QISTATE: ,,,< remote_port>,,,,< serverID>,, OK 最大响应时间 300 毫秒 特性说明 / 上海移远通信技术股份有限公司 28 / 56 LTE Standard(A)系列 TCP/IP 应用指导 参数 整型。查询类型。 0 查询特定场景下所有 Socket 服务的连接状态 1 查询特定 Socket 服务连接状态 整型。场景 ID。范围：1~15。 整型。Socket 连接号。范围：0~11。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'TCP INCOMING' 建立 TCP 服务器接受的 TCP 连接 'UDP SERVICE' 建立 UDP 服务 字符串类型。IP 地址。 若='TCP'或'UDP'，则指远程服务器 IP 地址 若='TCP LISTENER'或'UDP SERVICE'，则指本地 IP 地址 若='TCP INCOMING'，则指远程客户端 IP 地址 整型。远程端口号。 若='TCP'或'UDP'，则指远程服务器端口 若='TCP LISTENER'或'UDP SERVICE'，则端口无效 若='TCP INCOMING'，则指远程客户端端口 整型。本地端口号。 若为 0，本地端口自动分配。 整型。Socket 服务状态。 0 'Initial'：尚未建立连接 1 'Opening'：客户端正在连接或者服务器正尝试监听 2 'Connected'：客户端连接已建立 3 'Listening'：服务器正在监听 4 'Closing'：连接断开 整型。仅在为'TCP INCOMING'时才有效。代表哪个服务 器接受了这个 TCP 连接，这个参数值和该服务器'TCP LISTENER'的值 一样。 整型。数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 字符串类型。Socket 服务的 COM 口。 'usbmodem' USB modem port 'usbat' USB AT port 'uart1' UART port 1 'cmux1' MUX port 1 'cmux2' MUX port 2 'cmux3' MUX port 3 'cmux4' MUX port 4 上海移远通信技术股份有限公司 29 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2.3.8. AT+QISEND 发送数据 若 特 定 Socket 服 务 的 数 据 访 问 模 式 是 缓 存 模 式 （ =0 ） 或 者 直 吐 模 式 （=1），可通过 AT+QISEND 发送数据。若成功发送数据到模块，则返回 SEND OK， 否则返回 SEND FAIL 或 ERROR。 ⚫ SEND FAIL 表示发送缓存已满，可以尝试重新发送数据； ⚫ ERROR 表示在发送数据过程中遇到错误，请延迟一段时间后再次发送数据，发送数据的最大长度 为 1460 字节； ⚫ SEND OK 并不表示数据已经成功发送至服务器，可通过 AT+QISEND=,0 查询数据 是否已经发送至服务器。 AT+QISEND 发送数据 测试命令 AT+QISEND=? 响应 +QISEND: (支持的范围),(支持的范围) OK 设置命令 若='TCP'、'UDP'或者' TCP INCOMING'，发送不定长数据 AT+QISEND= 响应 > 响应 > 后，输入需要发送的数据；按 Ctrl + Z 发送数据，按 Esc 取消发送。 （1）若=0： 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立、异常断开或者参数不正确： ERROR （2）若=1： 若连接已经建立： +QISEND: ,, OK 若连接未建立、异常断开或者参数不正确： ERROR 设置命令 若='TCP'，'UDP'或'T CP INCOMING'，发送定长数据 响应 > 响应 > 后，输入长度等于的数据。 上海移远通信技术股份有限公司 30 / 56 LTE Standard(A)系列 TCP/IP 应用指导 AT+QISEND=, （1）若=0： 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR （2）=1： 若连接已经建立： +QISEND: ,, OK 若连接未建立、异常断开或者参数不正确： ERROR 设置命令 若='UDP SERVICE' AT+QISEND=,,, 响应 该命令可用来发送固定字节长度数据到特定的远程 IP 地址和 远程端口，必须是'UDP SERVICE'。 > 响应 > 后，输入长度等于的数据。 若连接已经建立且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 设置命令 当为 0，可查询发送数据 AT+QISEND=,0 响应 若指定连接存在： +QISEND: ,, OK 最大响应时间 特性说明 如有错误： ERROR / / 上海移远通信技术股份有限公司 31 / 56 LTE Standard(A)系列 TCP/IP 应用指导 参数 整型。Socket 连接号。范围：0~11。 整型。发送数据字节长度。范围：0~1460；单位：字节。 整型。设置是否以 URC 形式显示 AT+QISEND 指令执行信息。 0 禁用 1 启用 整型。 0 发送数据到套接字缓冲区成功 1 接收缓冲区满，发送失败 整型。当前缓冲区中的空闲空间。范围：0~10240；单位：字节。 字符串类型。远程 IP 地址（必须是点分十进制格式）。只有当为 'UDP SERVICE'才有效。 整型。远程端口。只有当为'UDP SERVICE'才有效。 整型。发送数据总长度。单位：字节。 整型。收到数据总长度。单位：字节。 整型。未收到数据总长度。单位：字节。 2.3.9. AT+QIRD 读取收到的 TCP/IP 数据 在缓存模式下，模块收到数据后会先缓存数据并上报+QIURC: 'recv',，之后可通过 AT+QIRD 读取所述数据。 缓存中仍有数据时，模块若再次接收到数据，将不会再上报 URC；直到缓存中所有数据均被读取，才会上 报新的 URC。 AT+QIRD 读取收到的 TCP/IP 数据 测试命令 AT+QIRD=? 响应 +QIRD: (支持的范围),(支持的范 围) 设置命令 当为 'TCP'/'UDP'/'TCP INCOMING' AT+QIRD=[,] OK 响应 若特定连接收到数据： +QIRD: OK 若无数据： +QIRD: 0 OK 上海移远通信技术股份有限公司 32 / 56 LTE Standard(A)系列 TCP/IP 应用指导 设置命令 当为'UDP SERVICE' AT+QIRD= 若连接不存在： ERROR 响应 若数据存在： +QIRD: ,, OK 若无数据： +QIRD: 0 OK 若连接不存在： ERROR 设置命令 响应 当为 0，查询读取的数据 若指定连接存在： AT+QIRD=,0 +QIRD: ,, 最大响应时间 特性说明 OK 如有错误： ERROR / / 参数 整型。Socket 连接号。范围：0~11。 整型。待读取数据的最大长度。范围：0~1500；单位：字节。 整型。实际接收数据的长度。单位：字节。 字符串类型。远程 IP 地址。只有当为'UDP SERVICE'时才有 效。 整型。远程端口。只有为'UDP SERVICE'才有效。 整型。读取的数据。单位：字节。 整型。已接收数据的总长度。单位：字节。 整型。已读取数据的长度。单位：字节。 整型。未读取数据的长度。单位：字节。 上海移远通信技术股份有限公司 33 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2.3.10. AT+QISENDEX 发送 16 进制字符串数据 该命令用于发送 16 进制字符串数据，不适用于'UDP SERVICE'和'TCP LISTENER'两种 Socket 服务 类型。 AT+QISENDEX 发送 16 进制字符串数据 测试命令 AT+QISENDEX=? 响应 +QISENDEX: (支持的范围), OK 设置命令 AT+QISENDEX=,< hex_string> 响应 （1）若=0： 若数据发送成功： SEND OK 若发送缓存已满： SEND FAIL 若连接不存在： ERROR （2）若=1： 若连接已经建立： +QISENDEX: ,, OK 最大响应时间 特性说明 若连接未建立、异常断开或者参数不正确： ERROR / / 参数 整型。Socket 连接号。范围：0~11。 整型。设置是否以 URC 形式显示 AT+QISEND 指令执行信息。 0 禁用 1 启用 整型。 0 发送数据到套接字缓冲区成功 1 接收缓冲区满，发送失败 上海移远通信技术股份有限公司 34 / 56 LTE Standard(A)系列 TCP/IP 应用指导 整型。当前缓冲区中的空闲空间。范围：0~10240；单位：字节。 字符串类型。16 进制字符串数据。最大长度：512 字节。 2.3.11. AT+QISWTMD 切换数据访问模式 该命令用于切换数据访问模式：缓存模式、直吐模式和透传模式。建立 Socket 服务时，可以通过 AT+QIOPEN 的来指定数据访问模式，Socket 服务打开以后，可以通过 AT+QISWTMD 来切换模式。 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应 +QISWTMD: (支持的范围),(支持的范围) OK 设置命令 AT+QISWTMD=, 响应 若=0 或 1 且数据访问模式切换成功： OK 若=2 且数据访问模式切换成功，模块会进入 数据模式： CONNECT 最大响应时间 特性说明 如有错误： ERROR / 该命令立即生效； 参数配置不保存。 参数 整型。Socket 连接号。范围：0~11。 整型。连接数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 2.3.12. AT+QPING 进行远程服务器 Ping 操作 该命令用于检测 Host 网络协议可达性。在使用 Ping 工具前，Host 应首先通过 AT+QIACT 激活 对应的场景，在期间内返回结果，默认值是 4 秒。 上海移远通信技术股份有限公司 35 / 56 LTE Standard(A)系列 TCP/IP 应用指导 AT+QPING 进行远程服务器 Ping 操作 测试命令 AT+QPING=? 响应 +QPING: (支持的范围),,(支持的范围),(支持的范围) OK 设置命令 AT+QPING=,[,[,]] 响应 若远程服务器 Ping 操作成功： OK +QPING: [,,,,] […] +QPING: [,,,,,,] 最大响应时间 特性说明 如有错误： ERROR / / 参数 整型。场景 ID。范围：1~15。 字符串类型。Host 地址，格式为域名或点分十进制 IP 地址。 整型。设置每个 Ping 请求回应等待最大时间。范围：1~255；默认值：4；单位：秒。 整型。设置 Ping 请求最大次数。范围：1~10；默认值：4。 整型。每个 Ping 请求结果。 0 从服务器接收到 Ping 响应，紧跟,,,,。 其他值 请参考第 4 章。 字符串类型。远程服务器 IP 地址。格式为点分十进制 IP。 整型。发送 Ping 请求字节长度。单位：字节。 整型。发送 Ping 请求后等待响应时间。单位：毫秒。 整型。Ping 请求回应数据包 TTL 值。 整型。该命令执行后最终结果。 0 正常结束，成功激活场景并找到 Host，此情况下紧跟,,,, ,, 其他值 错误码，请参考第 4 章。 整型。Ping 请求发送次数。 整型。得到响应的 Ping 请求个数。 整型。超时的 Ping 请求个数。 整型。最小响应时间。单位：毫秒。 上海移远通信技术股份有限公司 36 / 56 整型。最大响应时间。单位：毫秒。 整型。平均响应时间。单位：毫秒。 LTE Standard(A)系列 TCP/IP 应用指导 2.3.13. AT+QNTP 使用 NTP 服务器同步本地时间 该命令用于通过 NTP 服务器同步本地时间到 UTC 时间，在同步之前，Host 需通过 AT+QIACT 来激活 对应的场景。受网络状态影响，等待返回结果最多需要 125 秒。 AT+QNTP 使用 NTP 服务器同步本地时间 测试命令 AT+QNTP=? 响应 +QNTP: ( 支 持 的 范 围 ),,( 支 持 的 范 围),(支持的列表) 查询命令 AT+QNTP? OK 响应 若在同步时间过程中： +QNTP: , 设置命令 AT+QNTP=, [,[,]] OK 响应 同步成功： OK +QNTP: , 最大响应时间 特性说明 如有错误： ERROR 受网络状态影响，最大响应时间 125 秒。 该命令立即生效； 参数配置不保存。 参数 整型。场景ID。范围：1~15。 字符串类型。NTP服务器地址。 整型。NTP服务器端口。范围：1~65535。 整型。是否自动设置同步时间到本地时间。 0 不设置 1 设置 错误码。请参考第 4章。 字符串类型。从NTP服务器上同步的时间。 格式为YYYY/MM/DD,hh:mm:sszz，zz的范围：-48 ~ +56。 上海移远通信技术股份有限公司 37 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2.3.14. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置 DNS 服务器地址。在配置 DNS 地址之前，Host 需通过 AT+QIACT 来激活 对应的场景。 AT+QIDNSCFG 配置 DNS 服务器地址 测试命令 AT+QIDNSCFG=? 响应： +QIDNSCFG: (支持的范围),, 设置命令 AT+QIDNSCFG=[,[,]] OK 响应： 若省略可选参数，则查询指定 PDP 场景的当前 DNS 服务器地址： +QIDNSCFG: ,, OK 若指定任意可选参数，则设置指定 PDP 场景的主要 DNS 服务器地 址和次要 DNS 服务器地址： OK 最大响应时间 特性说明 如有错误： ERROR / 该命令立即生效； 参数配置不保存。 参数 整型。PDP 场景 ID。范围：1~15。 字符串类型。主要 DNS 服务器地址。 字符串类型。次要 DNS 服务器地址。 2.3.15. AT+QIDNSGIP 用域名获取 IP 地址 查询 DNS 之前，Host 需通过 AT+QIACT 来激活对应的场景。受网络状态影响，等待返 回响应结果最多需要 60 秒。 .AT+QIDNSGIP 测试命令 AT+QIDNSGIP=? 用域名获取 IP 地址 响应： +QIDNSGIP: (支持的范围), 上海移远通信技术股份有限公司 38 / 56 LTE Standard(A)系列 TCP/IP 应用指导 OK 设置命令 AT+QIDNSGIP=, 响应： OK 如有错误： ERROR 最大响应时间 特性说明 以 URC 格式返回结果 +QIURC: 'dnsgip',,, [..... +QIURC: 'dnsgip',] 受网络状态影响，最大响应时间 60 秒。 / 参数 整型。PDP 场景 ID。范围：1~15。 字符串类型。域名。 错误码。请参考第 4 章。 整型。对应的 IP 地址数。 整型。DNS 的 TTL 值。单位：秒。 字符串类型。IP 地址。 2.3.16. AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 该命令用于控制是否回显 AT+QISEND 要发送的数据，即是否回显输入的待发送数据。 AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 测试命令 AT+QISDE=? 响应： +QISDE: (支持的列表) 查询命令 AT+QISDE? OK 响应： +QISDE: 设置命令 AT+QISDE= OK 响应： OK 如有错误： ERROR 上海移远通信技术股份有限公司 39 / 56 LTE Standard(A)系列 TCP/IP 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。是否回显 AT+QISEND 要发送的数据。 0 不回显 1 回显 2.3.17. AT+QIGETERROR 查询上一个 AT 命令错误代码 若 执 行 TCP/IP 命 令 后 返 回 ERROR ， 错 误 详 情 可 通 过 AT+QIGETERROR 查 询 。 需 注 意 AT+QIGETERROR 只返回上一个 TCP/IP AT 命令错误代码。 AT+QIGETERROR 查询上一个 AT 命令错误代码 测试命令 AT+QIGETERROR=? 执行命令 AT+QIGETERROR 响应： OK 响应： +QIGETERROR: , 最大响应时间 特性说明 OK 300 毫秒 / 参数 错误码。请参考第 4 章。 字符串类型。指示详细错误信息。请参考第 4 章。 2.4. URC 说明 TCP/IP AT 命令的 URC 统一以+QIURC:形式上报 Host，涉及数据接收、连接断开和接入等。在 URC 的前后均有，本文里均不显示。 上海移远通信技术股份有限公司 40 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2.4.1. +QIURC: 'closed' 连接断开通知 当 TCP Socket 服务连接被远程客户端断开或者因为网络异常导致断开，模块将上报该 URC，同时该 Socket 将处于'Closing'状态（=4），调用 AT+QICLOSE=后 Socket 服务可 恢复成'Initial'状态。 +QIURC: 'closed' 连接断开通知 +QIURC: 'closed', Socket 服务连接被断开 参数 整型。Socket 连接号。范围：0~11。 2.4.2. +QIURC: 'recv' 数据接收通知 在缓存模式或者直吐模式下，模块接收到数据后会上报 URC 通知 Host。 ⚫ 缓存模式下：URC 格式为+QIURC: 'recv',；URC 上报后，Host 可通过 AT+QIRD 读取数据。请注意，如果缓存不为空且模块再次接收数据的情况下，只有当 Host 通过 AT+QIRD 读取所有接收的数据后，模块才会上报新的 URC。 ⚫ 直吐模式下：接收的数据会直接从 COM 端输出。 +QIURC: 'recv' 数据接收通知 +QIURC: 'recv', 在缓存模式下，模块接收到数据会上报该 URC，Host 可通过 AT+QIRD 获取数据。 +QIURC: 'recv',,<curre 在 直 吐 模 式 下 ， 当 ='TCP' 、 'UDP' 或 'TCP ntrecvlength> INCOMING'时，模块接收到数据会上报该 URC。 +QIURC: 'recv',,<curre 在直吐模式下，当='UDP SERVICE'时，模块 ntrecvlength>,, 参数 整型。Socket 连接号。范围：0~11。 整型。实际接收数据的长度。 字符串类型。远程 IP 地址。 整型。远程端口。 整型。读取的数据。单位：字节。 上海移远通信技术股份有限公司 41 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2.4.3. +QIURC: 'incoming full' 客户端连接已满通知 如果客户端连接已达限额，或者已经没有 Socket 系统资源可供分配，有新的客户端连接请求时模块会 上报 URC：+QIURC: 'incoming full'。 +QIURC: 'incoming full' 客户端连接已满通知 +QIURC: 'incoming full' 客户端连接请求已满 2.4.4. +QIURC: 'incoming' 客户端连接通知 如果为'TCP LISTENER'，当一个远程客户端连接到这个服务器时，Host 会给新连接 自动分配一个空闲的，其中范围是 0~11。此时模块会上报该 URC。新连接的 是'TCP INCOMING'，是缓存模式。 +QIURC: 'incoming' 客户端连接通知 +QIURC: 'incoming',,< serverID>,, 接受了一个新的连接请求时，分配给新连接的以及新连接的和将通过 该 URC 上报。 参数 整型。模块自动为客户端连接指定分配的 Socket 服务。范围：0~11。 整 型 。 接 受 客 户 端 连 接 的 服 务 器 。 服 务 器 的 是 'TCP LISTENER'，监听 Socket ID 是。 字符串类型。客户端连接的远程 IP 地址。 整型。客户端连接的远程端口。 2.4.5. +QIURC: 'pdpdeact' PDP 去激活通知 PDP 可以被网络去激活。PDP 被去激活以后，模块会上报该 URC 通知 Host，Host 需执行 AT+QIDEACT 去激活场景并重置所有连接。 +QIURC: 'pdpdeact' PDP 去激活通知 +QIURC: 'pdpdeact', 表示场景被去激活 参数 整型。场景 ID。范围：1~15。 上海移远通信技术股份有限公司 42 / 56 LTE Standard(A)系列 TCP/IP 应用指导 2.4.6. +QIURC: 'wakeup/data' 唤醒报文数据接收通知 模块收到服务器下发的唤醒报文数据时，上报该 URC。 +QIURC: 'wakeup/data' 唤醒报文数据接收通知 +QIURC: 'wakeup/data', 表示服务器端下发唤醒数据。 参数 整型。场景 ID。范围：1~11。 上海移远通信技术股份有限公司 43 / 56 LTE Standard(A)系列 TCP/IP 应用指导 3 示例 3.1. 场景配置和激活 3.1.1. 场景配置 AT+QICSGP=1,1,'UNINET','','',1 OK //配置场景 1，APN 配置为'UNINET'（中国联通）。 3.1.2. 场景激活 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK //激活场景 1，受网络状态影响，最大响应时间为 150 秒。 //场景激活成功。 //查询场景状态。 3.1.3. 场景去激活 AT+QIDEACT=1 OK //去激活场景 1。 //场景去激活成功，受网络状态影响，最大响应时间为 40 秒。 3.2. TCP 客户端在缓存模式下工作 3.2.1. 创建 TCP 客户端连接并进入缓存模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,0 OK // 场 景 是 1 ， 为 0 。 在 执 行 AT+QIOPEN 之前，Host 需要使用 AT+QIACT 激活场景。 上海移远通信技术股份有限公司 44 / 56 LTE Standard(A)系列 TCP/IP 应用指导 +QIOPEN: 0,0 //TCP 客户端连接成功，等待 URC：+QIOPE N: ,响应建议等待 150 秒。 若 150 秒内未收到 URC 响应，Host 可以使用 AT+QICLOSE 断开 Socket。 AT+QISTATE=1,0 //检查连接状态是否为 0。 +QISTATE: 0,'TCP','220.180.239.212',8009,65514,2,1,0,0,'usbmodem' OK 3.2.2. Buffer 模式下发送数据 AT+QISEND=0 > test1 SEND OK AT+QISEND=0,4 > test SEND OK AT+QISEND=0,0 +QISEND: 9,9,0 OK AT+QISENDEX=0,'3132333435' SEND OK AT+QISEND=0,0 +QISEND: 14,14,0 OK //发送可变长度数据。 //SEND OK 不能代表数据已经成功发送到服务器。Host 可以通 过 AT+QISEND=0,0 来查询数据是否到达服务器。 //发送固定长度数据，字节长度为 4 字节。 //查询发送数据长度。 //发送 16 进制字符串数据。 //查询发送数据长度，已确认数据长度和未确认数据长度。 3.2.3. Buffer 模式下从远程服务器接收数据 +QIURC: 'recv',0 AT+QIRD=0,1500 +QIRD: 14 test1 // 为 0 接收的数据。 //读取数据，字节长度为 1500 字节。 //实际接收数据长度为 14 字节。 OK AT+QIRD=0,1500 +QIRD: 0 //缓存里无数据。 OK AT+QIRD=0,0 //查询接收数据总长度，包含已读和未读数据。 上海移远通信技术股份有限公司 45 / 56 +QIRD: 14,14,0 OK 3.2.4. 断开连接 AT+QICLOSE=0 OK LTE Standard(A)系列 TCP/IP 应用指导 //断开为 0 的连接。受网络状态影响，最大响应时间是 10 秒。 3.3. TCP 客户端在透传模式下工作 3.3.1. 创建 TCP 客户端连接并进入透传模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,2 //场景为 1，为 0。执行 AT+QIOPEN 之前，Host 需使用 AT+QIACT 来激活场景。 CONNECT //连接成功，等待 URC 响应结果 CONNECT 建议 等待 150 秒。若 150 秒内 URC 无响应，Host 可 通过 AT+QICLOSE 断开 Socket 连接。 3.3.2. 透传模式下发送数据 3.3.3. 透传模式接收远程器端数据 Test 1 //所有从网络接收的数据都会通过 COM 端口直接输出。 3.3.4. 断开 TCP 客户端连接 AT+QICLOSE=0 OK //使用+++退出透传模式后，Host 可以通过 AT+QICLOSE 断开 TCP 连接。受网络状态影响，最大响应时间是 10 秒。 上海移远通信技术股份有限公司 46 / 56 LTE Standard(A)系列 TCP/IP 应用指导 3.4. TCP 客户端在直吐模式下工作 3.4.1. 创建 TCP 客户端连接并进入直吐模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,1 //场景为 1，为 0。执行 AT+QIOPEN 之前，Host 需使用 AT+QIACT 来激活场景。 OK +QIOPEN: 0,0 //连接成功，等待 URC： +QIOPEN: ,响应建议等待 150 秒，若 150 秒内未响 应，Host 可通过 AT+QICLOSE 断开 Socket。 AT+QISTATE=1,0 //查询的连接状态是否为 0。 +QISTATE: 0,'TCP','220.180.239.212',8009,65344,2,1,0,1,'usbmodem' OK 3.4.2. 直吐模式下发送数据 AT+QISEND=0 > test1 SEND OK AT+QISEND=0,5 > test2 SEND OK AT+QISEND=0,0 +QISEND: 10,10,0 OK //发送长度可变数据。 //SEND OK 不能代表数据已经成功发送至服务器，Host 可通过 AT+QISEND=0,0 查询数据是否达到服务器。 //发送固定长度数据，长度为 5 字节。 //查询发送数据长度，已确认数据长度和未确认数据长度。 3.4.3. 直吐模式下接收远程服务器端数据 +QIURC: 'recv',0,4 test //接收远程服务器端数据。 3.4.4. 断开 TCP 用户端连接 AT+QICLOSE=0 OK //断开为 0 的连接。受网络状态影响，最大 响应时间为 10 秒。 上海移远通信技术股份有限公司 47 / 56 LTE Standard(A)系列 TCP/IP 应用指导 3.5. TCP 服务器在缓存模式下工作 3.5.1. 启动 TCP 服务器 AT+QIOPEN=1,1,'TCP LISTENER','127.0.0.1',0,2020,0 // 场 景 为 1 ， 为 1 。 执 行 AT+QIOPEN 之前，Host 需通过 AT+QIACT 来激活场景。 OK +QIOPEN: 1,0 AT+QISTATE=0,1 //TCP 服务器启动成功。 //查询连接状态是否为 1。 +QISTATE: 1,'TCP LISTENER','10.7.157.1',0,2020,3,1,1,0,'usbmodem' OK 3.5.2. 接受客户端的连接请求 +QIURC: 'incoming',11,1,'172.31.242.222',54091 //接受一个 TCP 连接，为'TCP incoming'，为 11。 3.5.3. 接收的客户端数据 +QIURC: 'recv',11 AT+QIRD=11,1500 +QIRD: 4 test OK AT+QIRD=11,1500 +QIRD: 0 OK AT+QIRD=11,0 +QIRD: 4,4,0 OK //从远程客户端连接接收的数据。 //读取客户端连接接收的数据。 //实际数据长度为 4 字节。 //缓存无数据。 //查询接收数据总长度，包含已读和未读数据。 上海移远通信技术股份有限公司 48 / 56 3.5.4. 断开 TCP 服务器连接 AT+QICLOSE=11 OK AT+QICLOSE=1 OK LTE Standard(A)系列 TCP/IP 应用指导 //断开客户端连接，受网络状态影响最大响应时间 10 秒。 //关闭 TCP 服务器监听。 3.6. UDP 服务示例 3.6.1. 打开 UDP 服务 AT+QIOPEN=1,2,'UDP SERVICE','127.0.0.1',0,3030,0 // 打 开 UDP 服 务 ， 为 2 ， 为 1，执行 AT+QIOPEN 之前， Host 需通过 AT+QIACT 来激活场景。 OK +QIOPEN: 2,0 //成功打开 UDP 服务。 AT+QISTATE=0,1 //查询的连接状态是否为 1。 +QISTATE: 2,'UDP SERVICE','10.7.157.1',0,3030,2,1,2,0,'usbmodem' OK 3.6.2. 向服务器发送 UDP 数据 AT+QISEND=2,10,'10.7.89.10',6969 >1234567890 SEND OK //向远程端发送字节长度为 10 字节的数据，远程 端 IP 地址是 10.7.89.10，端口是 6969。 上海移远通信技术股份有限公司 49 / 56 3.6.3. 接收远程端数据 +QIURC: 'recv',2 AT+QIRD=2 +QIRD: 4,'10.7.76.34',7687 AAAA OK AT+QIRD=2 +QIRD: 0 OK AT+QISEND=2,10,'10.7.76.34',7687 >1234567890 SEND OK 3.6.4. 关闭 UDP 服务 AT+QICLOSE=2 OK LTE Standard(A)系列 TCP/IP 应用指导 //接收远程端数据。 //读取 UDP 数据。可输出一整个 UDP 数据包，无 需指定读取长度。 //数据长度为 4，远程 IP 地址 10.7.76.34，远程端 口是 7687。 //读取数据。 //缓存无数据。 //向远程端发送数据，远程端 IP 地址为 10.7.76.34， 远程端口是 7687。 //关闭服务。 3.7. PING AT+QPING=1,'www.baidu.com' OK +QPING: 0,'61.135.169.125',32,192,255 +QPING: 0,'61.135.169.125',32,240,255 +QPING: 0,'61.135.169.125',32,241,255 +QPING: 0,'61.135.169.125',32,479,255 +QPING: 0,4,4,0,192,479,288 //在场景 1 中 Ping www.baidu.com，在 Ping 目标 IP 地址前，Host 需通过 AT+QIACT 来激活场景。 上海移远通信技术股份有限公司 50 / 56 3.8. 同步本地时间 AT+QNTP=1,'202.112.10.36',123 OK +QNTP: 0,'2019/09/09,01:32:42+32' AT+CCLK? +CCLK: '19/09/09,01:32:52+32' OK LTE Standard(A)系列 TCP/IP 应用指导 //使用 NTP 服务器'202.112.10.36:123'同步时间，同步 时间之前，Host 需要通过 AT+QIACT 来激活场景。 3.9. 获取上一个错误代码示例 AT+QIOPEN=1,'TCP','220.180.239.212',8009,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552,invalid parameters //开启Socket服务，省略了。 OK 3.10. TCP 可选配置项示例 //配置唤醒报文数据 AT+QICFG='wakeup/data',1 +QICFG: 'wakeup/data',1,'',0 //查询当前配置。 OK AT+QICFG='wakeup/data',1,'5155454377616b657570' //配置唤醒报文数据。 OK AT+QICFG='wakeup/data',1 //查询当前唤醒报文数据。 +QICFG: 'wakeup/data',1,'5155454377616b657570',0 OK AT+QICFG='wakeup/data',1,'' OK AT+QICFG='wakeup/data',1 //清除，关闭唤醒功能。 //关闭唤醒功能后，查询当前配置。 上海移远通信技术股份有限公司 51 / 56 LTE Standard(A)系列 TCP/IP 应用指导 +QICFG: 'wakeup/data',1,'',0 OK AT+QICFG='wakeup/data',1,'quec wakeup',2 OK //配置唤醒报文数据为字符串类型。 //设置周期性发送心跳包数据 AT+QICFG='send/auto',0,30,'313233343536',0,0 //配置周期性发送心跳包数据为十六进制 ASCII 码。 OK AT+QICFG='send/auto',0 //查询当前配置。 +QICFG: 'send/auto',0,30,'123456',0,0 OK AT+QICFG='send/auto',0,30,'hi quectel',2,0 OK AT+QICFG='send/auto',0 +QICFG: 'send/auto',0,30,'hi quectel',2,0 //配置发送心跳包数据为字符串类型。 //查询当前配置。 OK //设置过滤指定数据 AT+QICFG='recv/ignore',0,'313233343536',0 OK AT+QICFG='recv/ignore',0 +QICFG: 'recv/ignore',0,'123456',0 //配置过滤数据为十六进制 ASCII 码。 //查询当前配置。 OK AT+QICFG='recv/ignore',0,'313233343536',1 OK AT+QICFG='recv/ignore',0 +QICFG: 'recv/ignore',0,'313233343536',1 //配置过滤数据为十六进制字符串。 //查询当前配置。 OK 上海移远通信技术股份有限公司 52 / 56 LTE Standard(A)系列 TCP/IP 应用指导 4 错误代码 当 TCP/IP 的 AT 命令返回 ERROR 时，具体的错误类型可以通过 AT+QIGETERROR 来查询。需注意 AT+QIGETERROR 查询的是上一个 TCP/IP AT 命令的错误代码。 表 3：错误代码列表 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 Operation success Unknown error Operation blocked Invalid parameters Memory not enough Socket creation failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed PDP context opening failed PDP context closure failed Socket identity has been used DNS busy DNS parse failed 中文含义 操作成功 未知错误 操作受阻 无效参数 内存不足 创建Socket失败 操作不支持 Socket绑定失败 Socket监听失败 Socket写入失败 Socket读取失败 Socket接受失败 打开PDP场景失败 关闭PDP场景失败 Socket标识被占用 DNS忙碌 DNS解析失败 上海移远通信技术股份有限公司 53 / 56 566 Socket connect failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel sending 572 Operation not allowed 573 APN not configured 574 Port busy LTE Standard(A)系列 TCP/IP 应用指导 Socket连接失败 Socket被关闭 操作忙碌 操作超时 PDP场景出现故障 取消发送 操作不允许 APN未配置 端口忙碌 上海移远通信技术股份有限公司 54 / 56 LTE Standard(A)系列 TCP/IP 应用指导 5 附录 参考文档及术语缩写 表 4：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_AT 命令手册 表 5：术语缩写 缩写 3GPP ACK APN ASCII CHAP CS DNS FIN ID IP NTP NV PAP PDP PPP 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 Acknowledgement 确认字符 Access Point Name 接入点名称 American Standard Code for Information Interchange 美国信息交换标准代码 Challenge Handshake Authentication Protocol 挑战握手认证协议 Circuit Switching 电路交换 Domain Name System 域名系统 Finish 完成 Mostly refers to Identifier in terms of software 软件中多数指'标识符' Internet Protocol 互联网协议 Network Time Protocol 网络时间协议 Non-Volatile 非易失 Password Authentication Protocol 密码认证协议 Packet Data Protocol 分组数据协议 Point-to-Point Protocol 点对点协议 上海移远通信技术股份有限公司 55 / 56 LTE Standard(A)系列 TCP/IP 应用指导 PS QoS TCP TTL UART UDP URC USB (U)SIM UTC Packet Switching Quality of Service Transmission Control Protocol Time to Live Universal Asynchronous Receiver& Transmitter User Datagram Protocol Unsolicited Result Code Universal Serial Bus (Universal) Subscriber Identity Module Coordinated Universal Time 分组交换 服务质量 传输控制协议 生存时间 通用异步收发器 用户数据包协议 非请求结果码 通用串行总线 （通用）用户身份模块 协调世界时 上海移远通信技术股份有限公司 56 / 56

EC200G-CN&EG800G-CN GNSS 应用指导 LTE Standard 模块系列 版本：1.0 日期：2023-10-27 状态：受控文件 EC200G-CN&EG800G-CN GNSS 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上 提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 文档历史 修订记录 版本 1.0 日期 2023-07-14 2023-10-27 作者 Arvin XU/ Felix LIN Arvin XU/ Felix LIN 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 打开/关闭 GNSS 步骤 ................................................................................................................. 6 1.2. 支持的 NMEA 语句类型............................................................................................................... 7 2 GNSS AT 命令 ....................................................................................................................................... 8 2.1. AT 命令说明................................................................................................................................. 8 2.1.1. 定义 .................................................................................................................................. 8 2.1.2. AT 命令语句...................................................................................................................... 8 2.2. AT 示例声明................................................................................................................................. 9 2.3. AT 命令详解................................................................................................................................. 9 2.3.1. AT+QGPSCFG 配置 GNSS........................................................................................... 9 2.3.1.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口....................................... 10 2.3.1.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 ............................................................................................................................. 11 2.3.1.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型................ 11 2.3.1.4. AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型........... 12 2.3.1.5. AT+QGPSCFG='gnssnmeatype' 配置多系统混合定位 NMEA 语句输出类型. 13 2.3.1.6. AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统...................... 14 2.3.1.7. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 ........................................ 15 2.3.1.8. AT+QGPSCFG='beidounmeaformat' 配置 BDS NMEA 语句的 Talker ID....... 16 2.3.1.9. AT+QGPSCFG='urc' 使能/关闭 GNSS 的 URC 上报 ...................................... 17 2.3.2. AT+QGPSDEL 删除辅助数据 ...................................................................................... 18 2.3.3. AT+QGPS 打开 GNSS ................................................................................................ 19 2.3.4. AT+QGPSEND 关闭 GNSS......................................................................................... 20 2.3.5. AT+QGPSLOC 获取定位信息...................................................................................... 21 2.3.6. AT+QGPSGNMEA 获取指定的 NMEA 语句................................................................ 23 2.3.7. AT+QAGPS 启用/禁用 AGPS...................................................................................... 25 2.3.8. AT+QAGPSCFG 配置 AGPS 相关参数 ....................................................................... 25 2.3.9. AT+QGPSINFO 查看 GNSS 版本信息 ........................................................................ 27 3 示例 ...................................................................................................................................................... 28 3.1. 打开与关闭 GNSS ..................................................................................................................... 28 3.2. 参数的应用........................................................................................................... 28 3.3. GNSS 休眠模式......................................................................................................................... 29 3.4. Firmware 的 URC 上报.............................................................................................................. 29 3.5. AGPS 功能的 URC 上报............................................................................................................ 30 4 错误码 .................................................................................................................................................. 31 5 附录 术语缩写...................................................................................................................................... 33 上海移远通信技术股份有限公司 4 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 8 表 2：错误码列表 ....................................................................................................................................... 31 表 3：firmware 的 URC 错误代码列表 ....................................................................................................... 32 表 4：AGPS 的 URC 错误代码列表 ........................................................................................................... 32 表 5：术语缩写 ........................................................................................................................................... 33 上海移远通信技术股份有限公司 5 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 1 引言 移远通信EC200G-CN和EG800G-CN模块内部集成GNSS引擎，支持GPS、BDS和QZSS星系，能够 为客户提供快速、准确的高性能定位。GNSS功能使模块能够广泛应用于逐行导航、资产跟踪、穿戴设备、 车辆和人员追踪等领域。 备注 EC200G-CN 和 EG800G-CN 模块的 GNSS 功能可选，请咨询移远通信技术支持获取当前使用的模块型 号是否支持 GNSS。 1.1. 打开/关闭 GNSS 步骤 EC200G-CN 和 EG800G-CN 模块的 GNSS 支持位置计算功能，且无需网络协助。打开或关闭 GNSS 的步骤如下： 步骤 1：通过 AT+QGPSCFG 配置 GNSS 参数。 步骤 2：通过 AT+QGPS 打开 GNSS。 步骤 3：GNSS 定位成功后，可通过以下三种方式获取定位信息： 1) NMEA 语句默认输出至'usbnmea'端口，可以通过读取该端口获取 NMEA 语句。 2) 通过 AT+QGPSLOC 可直接获取定位信息，例如纬度、经度、高度、GNSS 定位模式、 时间、卫星数量等。 3) 通过设置 AT+QGPSCFG='nmeasrc',1，启用通过 AT+QGPSGNMEA 获取指定的 NMEA 语句；如果设置 AT+QGPSCFG='nmeasrc',0，则不能通过 AT+QGPSGNMEA 获取指定的 NMEA 语句。 步骤 4：执行 AT+QGPSEND 关闭 GNSS。 上海移远通信技术股份有限公司 6 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 1.2. 支持的 NMEA 语句类型 模块默认支持的 NMEA 语句与 NMEA 0183 协议兼容。另外，可以通过不同的 Talker ID 去区分不同卫 星系统输出的 NMEA 语句，如下所示： GPS 和 QZSS NMEA 语句的 Talker ID 为'GP'，如下所示： ⚫ GPGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GPRMC - 推荐的最小具体 GNSS 数据 ⚫ GPGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ GPGSA – 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GPVTG - 矢量跟踪与对地速度 ⚫ GPGLL - 地理定位信息（经/纬度） BDS NMEA 语 句 的 Talker ID 为 ' PQ ' 或 ' GB ' 或 ' BD ' ， 可 通 过 AT+QGPSCFG='beidounmeaformat'配置 BDS NMEA 语句 Talker ID。以'PQ'为例，如下所示： ⚫ PQGGA - 全球定位系统定位数据，如时间、定位等 ⚫ PQRMC - 推荐的最小具体 GNSS 数据 ⚫ PQGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ PQGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ PQVTG - 矢量跟踪与对地速度 ⚫ PQGLL - 地理定位信息（经/纬度） 混合定位 NMEA 语句的 Talker ID 为'GN'，如下所示： ⚫ GNGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GNRMC - 推荐的最小具体 GNSS 数据 ⚫ GNGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GNVTG - 矢量跟踪与对地速度 ⚫ GNGLL - 地理定位信息（经/纬度） 备注 若打开或关闭 GPS 星系，则 QZSS 星系也将会默认被打开或关闭。 上海移远通信技术股份有限公司 7 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2 GNSS AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QGPSCFG 配置 GNSS 该命令用于查询和配置 GNSS 不同的设置，包括 NMEA 语句输出端口、NMEA 语句的输出类型等。 AT+QGPSCFG 配置 GNSS 测试命令 AT+QGPSCFG=? 响应 +QGPSCFG: 'outport',(支持的列表) +QGPSCFG: 'nmeasrc',(支持的列表) +QGPSCFG: 'gpsnmeatype',(支持的 列表) +QGPSCFG: 'beidounmeatype',(支持的列表) +QGPSCFG: 'gnssnmeatype',(支持的列表) +QGPSCFG: 'gnssconfig',(支持的范围) +QGPSCFG: 'autogps',(支持的列表) +QGPSCFG: 'beidounmeaformat',(支持的范围) +QGPSCFG: 'urc',(支持的列表) 最大响应时间 特性说明 OK 300毫秒 / 上海移远通信技术股份有限公司 9 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2.3.1.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 该命令用于配置 NMEA 语句输出端口。 AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 设置命令 AT+QGPSCFG='outport'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'outport', 最大响应时间 特性说明 OK 若指定可选参数，则配置NMEA语句输出端口： OK 或者 ERROR 若错误与ME功能相关： +CME ERROR: 300毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。配置NMEA语句输出端口。 'none' 关闭NMEA语句输出 'uart1' 通过UART1输出 'uart3'/'uart5' 通过辅助UART输出 UART3适用于EG800G-CN模块 UART5适用于EC200G-CN模块 'usbat' 通过USB AT口输出 'usbmodem' 通过USB Modem口输出 'usbnmea' 通过USB NMEA口输出 操作错误码。详细信息可参考第 4章。 上海移远通信技术股份有限公司 10 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2.3.1.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 该命令用于启用或禁用通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 设置命令 AT+QGPSCFG='nmeasrc'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'nmeasrc', OK 若指定可选参数，则配置是否启用通过AT+QGPSGNMEA获取 NMEA语句： OK 或者 ERROR 最大响应时间 特性说明 若错误与ME功能相关 +CME ERROR: 300毫秒 该命令立即生效； 参数配置自动保存。 参数 整 型 。 启 用 或 禁 用 通 过 AT+QGPSGNMEA 获 取 NMEA 语 句 。 使 能 后 ， 执 行 AT+QGPSGNMEA，NMEA语句将以命令返回值的形式通过AT口输出。 0 禁用 1 启用 操作错误码。详细信息可参考第 4章。 2.3.1.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 该命令用于配置 GPS NMEA 语句的输出类型。 AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='gpsnmeatype'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gpsnmeatype', OK 上海移远通信技术股份有限公司 11 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 最大响应时间 特性说明 若指定可选参数，则配置 GPS NMEA 语句的输出类型： OK 或者 ERROR 若错误与ME功能相关： +CME ERROR: 300毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。设置输出的GPS NMEA语句类型。取值为异或运算格式。 0 禁用 1 GPGGA 2 GPRMC 4 GPGSV 8 GPGSA 16 GPVTG 31 输出以上全部5种类型语句 32 GPGLL 63 输出全部6种类型语句 操作错误码。详细信息可参考第 4章。 2.3.1.4. AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型 该命令用于配置 BDS NMEA 语句的输出类型。 AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='beidounmeatype'[,< BeiDou_NMEA_type>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'beidounmeatype', OK 若指定可选参数，则配置BDS NMEA语句的输出类型： OK 或者 ERROR 上海移远通信技术股份有限公司 12 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 最大响应时间 特性说明 参数 若错误与ME功能相关： +CME ERROR: 300毫秒 该命令重启后生效； 参数配置自动保存。 整型。设置输出的BDS NMEA语句类型。取值为异或运算格式。 0 禁用 1 PQGSA 2 PQGSV 4 PQGGA 8 PQRMC 16 PQVTG 31 输出以上全部5种类型语句 32 PQGLL 63 输出全部6种类型语句 操作错误码。详细信息可参考第 4章。 2.3.1.5. AT+QGPSCFG='gnssnmeatype' 配置多系统混合定位 NMEA 语句输出类型 该命令用于配置多系统混合定位 NMEA 语句输出类型。 AT+QGPSCFG='gnssnmeatype' 配置多系统混合定位 NMEA 语句输出类型 设置命令 AT+QGPSCFG='gnssnmeatype'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gnssnmeatype', OK 若指定可选参数，则配置多系统混合定位NMEA语句的输出类型： OK 或者 ERROR 最大响应时间 若错误与ME功能相关： +CME ERROR: 300毫秒 上海移远通信技术股份有限公司 13 / 34 特性说明 参数 EC200G-CN&EG800G-CN GNSS 应用指导 该命令重启后生效； 参数配置自动保存。 整型。设置输出的多系统混合定位NMEA语句类型。取值为异或运算格式。 0 禁用 1 GNGGA 2 GNRMC 4 GNGSA 8 GNVTG 15 输出以上全部4种类型语句 16 GNGLL 31 输出全部5种类型语句 操作错误码。详细信息可参考第 4 章。 2.3.1.6. AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统 该命令用于配置模块支持的 GNSS 卫星导航系统。 AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统 设置命令 AT+QGPSCFG='gnssconfig'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gnssconfig', 最大响应时间 特性说明 OK 若指定可选参数，则配置支持的 GNSS 卫星导航系统： OK 或者 ERROR 若错误与ME功能相关，则返回： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 14 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 参数 整型。支持的GNSS卫星导航系统。 0 单GPS 1 GPS + BDS + Galileo + GLONASS混合定位（不支持） 2 GPS + BDS + GLONASS混合定位（不支持） 3 GPS + GLONASS + Galileo 混合定位（不支持） 4 GPS + GLONASS 混合定位（不支持） 5 GPS + BDS + Galileo混合定位 6 GPS + Galileo混合定位（不支持） 7 单BDS 操作错误码。详细信息可参考第 4章。 备注 1. 若打开或关闭 GPS 星系，则 QZSS 星系也将会默认被打开或关闭。 2. 若模块支持的 GNSS 卫星导航系统为混合定位，则输出的 GGA 语句、RMC 语句、GSA 语句、VTG 语句和 GLL 语句的 Talker ID 均为'GN'，GSV 语句的 Talker ID 由支持的系统决定。例如，若模 块支持的 GNSS 卫星导航系统为 GPS + BDS + QZSS 混合定位，则可输出的 NMEA 语句为 GNGGA、GNRMC、GNGSA、GNVTG、GNGLL、GPGSV 和 GQGSV。 3. EC200G-CN 和 EG800G-CN 模块固件当前仅支持 GPS、BDS 和 QZSS 星系，因此上述命令中， 模块仅支持 GPS（含 QZSS）和 BDS 相关导航系统配置和语句输出类型。因此，若=5 则表示模块使用 GPS + BDS + QZSS 混合定位。 2.3.1.7. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 该命令用于配置模块启动时，是否自动启动 GNSS。 AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 设置命令 AT+QGPSCFG='autogps'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'autogps', OK 若指定可选参数，则配置是否启用GNSS自启动： OK 或者 ERROR 若错误与ME功能相关： +CME ERROR: 上海移远通信技术股份有限公司 15 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 最大响应时间 特性说明 300毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。启用或禁用GNSS自启动。 0 禁用 1 启用 操作错误码。详细信息可参考第 4章。 2.3.1.8. AT+QGPSCFG='beidounmeaformat' 配置 BDS NMEA 语句的 Talker ID 该命令用于配置 BDS NMEA 语句的 Talker ID。 AT+QGPSCFG='beidounmeaformat' 配置 BDS NMEA 语句的 Talker ID 设置命令 AT+QGPSCFG='beidounmeaformat'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'beidounmeaformat', OK 若指定可选参数，则配置BDS NMEA语句的Talker ID： OK 或者 ERROR 最大响应时间 特性说明 若错误与ME功能相关： +CME ERROR: 300毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。BDS NMEA语句的Talker ID。 0 PQ 1 GB 2 BD 操作错误码。详细信息可参考第 4章。 上海移远通信技术股份有限公司 16 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 备注 若=0，输出的 PQGSV 语句末尾处会增加 system ID（NMEA 协议定义的 GNSS 系统 ID）信息。 2.3.1.9. AT+QGPSCFG='urc' 使能/关闭 GNSS 的 URC 上报 该命令用于使能或关闭 GNSS 的 URC 上报。 AT+QGPSCFG='urc' 使能/关闭 GNSS 的 URC 上报 设置命令 AT+QGPSCFG='urc'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'urc', OK 若指定可选参数，则使能或关闭GNSS的URC上报： OK 或者 ERROR 最大响应时间 特性说明 若错误与ME功能相关： +CME ERROR: 300毫秒 / 参数 十六进制数。使能或关闭 GNSS 的 URC 上报。URC 上报格式为： +QGPS: 'firmware',,[] 或 +QGPS: 'agps',,[] 或 +QGPS: 'mode',（不支持） 其状态码含义见 firmware/AGPS 的 URC 错误代码列表（第 4 章）。 0 关闭所有 GNSS 的 URC 上报 0x1 使能 firmware 的 URC 上报 0x4 使能 AGPS 的 URC 上报 0x8 使能 GNSS 冷/热/温启动的 URC 上报（不支持） 0x9 使能 firmware 和 GNSS 冷/热/温启动的 URC 上报 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 17 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 备注 EC200G-CN 和 EG800G-CN 模块不支持上报+QGPS: 'mode',（GNSS 冷/热/温启动相关 URC），故若将设置为 0x8，模块不会上报 GNSS 冷/热/温启动的 URC；若将设置 为 0x09，模块仅上报 firmware 相关 URC。 2.3.2. AT+QGPSDEL 删除辅助数据 该命令用于删除辅助数据，以便进行 GNSS 引擎冷启动、热启动和温启动操作，且仅可在 GNSS 引擎 打开时执行。 AT+QGPSDEL 删除辅助数据 测试命令 AT+QGPSDEL=? 响应 +QGPSDEL: (支持的范围) 设置命令 AT+QGPSDEL= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。待删除的GNSS辅助数据类型。 0 删除所有辅助数据。开启GNSS后，强制冷启动。 1 不删除数据。开启GNSS后，条件允许时进行热启动。 2 删除部分相关数据。开启GNSS后，条件允许时进行温启动。 操作错误码。详细信息可参考第 4章。 上海移远通信技术股份有限公司 18 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2.3.3. AT+QGPS 打开 GNSS 该命令用于打开 GNSS 或者唤醒 GNSS 功能。当为 0，GNSS 引擎将持续定位，可通过 AT+QGPSEND 终止 GNSS 会话；当不为 0，且实际定位次数达到指定值时，GNSS 引擎将 自动停止；若实际定位次数未达到指定值，也可通过 AT+QGPSEND 终止 GNSS 会话。 AT+QGPS 打开 GNSS 测试命令 AT+QGPS=? 响应 +QGPS: ( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) 查询命令 查询当前 GNSS 会话状态 AT+QGPS? 设置命令 AT+QGPS=[,[,[,[,< fix_rate>]]]] OK 响应 +QGPS: OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 2000 毫秒 / 参数 整型。GNSS状态。 0 GNSS关闭 1 GNSS打开 整型。GNSS工作模式。 0 关闭GNSS 1 独立模式 整型。最长定位时间，包括测量GNSS伪距期间的反应时间、GPS卫星搜索的时间上限、 解调星历数据的时间以及计算位置的时间。范围：1~255；默认值：30；单位：秒。 整型。定位精度阈值。范围：0~1000；默认值：50；单位：米。 整型。定位次数。范围：0~1000。 0 持续定位 其他值 实际定位次数 上海移远通信技术股份有限公司 19 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 整型。定位的时间间隔。范围：1~65535；默认值：1；单位：秒。 操作错误码。详细信息可参考第 4章。 备注 执行 AT+QGPS=1 打开 GNSS，NMEA 语句输出端口有 NMEA 语句输出才表示 GNSS 已完全启动，此 时方可进行其他 GNSS 相关操作。 2.3.4. AT+QGPSEND 关闭 GNSS 该命令用于关闭 GNSS 功能。通过 AT+QGPS=1 打开 GNSS 且为 0，GNSS 引擎将持续 定位，可通过该命令强制终止 GNSS 会话，此时 GNSS 引擎掉电并停止定位。若在 2 小时内执行 AT+QGPS=1 打开 GNSS 并唤醒 GNSS 引擎，GNSS 引擎默认执行热启动。 AT+QGPSEND 关闭 GNSS 测试命令 AT+QGPSEND=? 查询命令 AT+QGPSEND? 执行命令 终止 GNSS 会话 AT+QGPSEND 响应 OK 或者 ERROR 响应 OK 或者 ERROR 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 2000 毫秒 / 参数 操作错误码。详细信息可参考第 4章。 上海移远通信技术股份有限公司 20 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2.3.5. AT+QGPSLOC 获取定位信息 该命令用于获取定位信息。执行该命令前，必须通过 AT+QGPS 打开 GNSS。如果定位失败，将根据 对应情况返回+CME ERROR: 。 AT+QGPSLOC 获取定位信息 测试命令 AT+QGPSLOC=? 响应 +QGPSLOC: ,,,,,,,,,, 设置命令 AT+QGPSLOC= OK 响应 +QGPSLOC: ,,,,,,,,,, OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。纬度和经度显示格式。 0 ,格式：ddmm.mmmmN/S,dddmm.mmmmE/W 1 ,格式：ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W 2 ,格式：(-)dd.ddddd,(-)ddd.ddddd 字符串类型。UTC时间。格式：hhmmss.sss（引自GPGGA语句）。 字符串类型。纬度。 如果为0： 格式：ddmm.mmmmN/S（引自GPGGA语句） dd 度。范围：00~89 mm.mmmm 分。范围：00.0000~59.9999 N/S 北纬/南纬 如果为 1： 格式：ddmm.mmmmmm,N/S（引自GPGGA语句） dd 度。范围：00~89 mm.mmmmmm 分。范围：00.000000~59.999999 N/S 北纬/南纬 上海移远通信技术股份有限公司 21 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 如果为 2： 格式：(-)dd.ddddd（引自GPGGA语句） dd.ddddd 度。范围：-89.99999~89.99999 - 南纬 字符串类型。经度。 如果为 0： 格式：dddmm.mmmmE/W（引自 GPGGA 语句） ddd 度。范围：000~179 mm.mmmm 分。范围：00.0000~59.9999 E/W 东经/西经 如果为 1： 格式：dddmm.mmmmmm,E/W（引自 GPGGA 语句） ddd 度。范围：000~179 mm.mmmmmm 分。范围：00.000000~59.999999 E/W 东经/西经 如果为 2： 格式：(-)ddd.ddddd（引自 GPGGA 语句） ddd.ddddd 度。范围：-179.99999~179.99999 - 西经 水平精度因子。范围：0.5~99.9（引自GPGGA语句）。 天线的海拔高度。精确到小数点后一位。单位：米（引自GPGGA语句）。 整型。GNSS定位模式（引自GAGSA/GPGSA语句）。 2 2D定位 3 3D定位 字符串类型。以真北参考基准的对地航向。 格式：ddd.mm（引自GPVTG语句）。 ddd 度。范围：000~359 mm 分。范围：00~59 对地速度。精确到小数点后一位。单位：千米/时（引自GPVTG语句）。 对地速度。精确到小数点后一位。单位：节（引自GPVTG语句）。 UTC日期。格式：ddmmyy（引自GPRMC语句）。 dd 日 mm 月 yy 年 卫星数量。固定两位数，前导位数不足则补0（引自GPGGA语句）。 操作错误码。详细信息可参考第 4章。 上海移远通信技术股份有限公司 22 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2.3.6. AT+QGPSGNMEA 获取指定的 NMEA 语句 该命令用于获取指定的 NMEA 语句。使用该命令前，必须先通过 AT+QGPS 打开 GNSS，并将 AT+QGPSCFG='nmeasrc'[,] 中 的 参 数 设 置 为 1 ， 然 后 通 过 AT+QGPSGNMEA 获取指定的 NMEA 语句。 用户可以通过 AT+QGPSCFG='gpsnmeatype',0 和 AT+QGPSCFG='beidounmeatype',0 禁用语句 输出，即不再输出更新的语句，保存的是 GNSS 激活后禁用语句输出前已获取的 NMEA 语句。如果保存的 NMEA 语句包含 AT+QGPSGNMEA 指定的语句类型，就依然可通过 AT+QGPSGNMEA 获取指定的 NMEA 语句。 AT+QGPSGNMEA 获取指定的 NMEA 语句 测试命令 AT+QGPSGNMEA=? 响应 +QGPSGNMEA: (支持的列表) 设置命令 查询 GGA 语句 AT+QGPSGNMEA='GGA' OK 响应 [+QGPSGNMEA: ] OK 设置命令 查询 RMC 语句 AT+QGPSGNMEA='RMC' 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] OK 设置命令 查询 GSV 语句 AT+QGPSGNMEA='GSV' 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] OK 设置命令 查询 GSA 语句 AT+QGPSGNMEA='GSA' 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] OK 若错误与 ME 功能相关： 上海移远通信技术股份有限公司 23 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 设置命令 查询 VTG 语句 AT+QGPSGNMEA='VTG' 设置命令 查询 GLL 语句 AT+QGPSGNMEA='GLL' 最大响应时间 特性说明 +CME ERROR: 响应 [+QGPSGNMEA: ] OK 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。NMEA 语句类型。 'GGA' GGA 语句 'RMC' RMC 语句 'GSV' GSV 语句 'GSA' GSA 语句 'VTG' VTG 语句 'GLL' GLL 语句 字符串类型。GGA语句。 字符串类型。RMC语句。 字符串类型。GSV语句。 字符串类型。GSA语句。 字符串类型。VTG语句。 字符串类型。GLL语句。 操作错误码。详细信息可参考第 4章。 上海移远通信技术股份有限公司 24 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2.3.7. AT+QAGPS 启用/禁用 AGPS 该命令用于启用或禁用 GNSS 的 AGPS 功能。 AT+QAGPS 启用/禁用 AGPS 测试命令 AT+QAGPS=? 响应 +QAGPS: (支持的列表) 查询命令 查询当前AGPS是否开启 AT+QAGPS? 设置命令 设置启用或禁用 AGPS 功能 AT+QAGPS= 最大响应时间 特性说明 OK 响应 +QAGPS: OK 响应 OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用 GNSS 的 AGPS 功能。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 2.3.8. AT+QAGPSCFG 配置 AGPS 相关参数 该命令用于配置 AGPS 的参数。 AT+QAGPSCFG 配置 AGPS 相关参数 测试命令 AT+QAGPSCFG=? 响应 +QAGPSCFG: (支持的范围),,,< modelID>,,(支持的范围), 查询命令 AT+QAGPSCFG? OK 响应 +QAGPSCFG: ,,,,,, OK 设置命令 响应 AT+QAGPSCFG=[,[, [,[,[,>[,]]]]]] OK 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置自动保存。 参数 整型。PDP 索引。范围：1~7；默认值：1。 字符串类型。AGPS服务器地址。 字符串类型。用户名。最大长度：30字节。 字符串类型。客户标识。 字符串类型。密码。最大长度：30字节。 整型。IP 类型。 0 指定 PDP 上下文上次激活时设置的 IP 类型 1 IPv4 2 IPv6 3 IPv4v6 注：若指定 PDP 上下文未曾被激活，则默认值为 1。 字符串类型。接入点名称。默认值：'NULL'；最大长度：99字节。 操作错误码。详细信息可参考第 4 章。 备注 启用 AGPS 功能后，指定的 PDP 上下文将可能被去激活。因此，AGPS 功能不可与其他应用 同时共用同一个 PDP 上下文，否则可能导致网络应用异常断开，需要重新拨号。 上海移远通信技术股份有限公司 26 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 2.3.9. AT+QGPSINFO 查看 GNSS 版本信息 该命令用于查看 GNSS 的版本信息。 AT+QGPSINFO 查看 GNSS 版本信息 测试命令 AT+QGPSINFO=? 查询命令 AT+QGPSINFO? 执行命令 AT+QGPSINFO 响应 OK 响应 OK 响应 +QGPSINFO: OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。GNSS的版本信息。 操作错误码。详细信息可参考第 4章。 上海移远通信技术股份有限公司 27 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 3 示例 3.1. 打开与关闭 GNSS 该示例使用默认参数来打开 GNSS。打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。通过 AT+QGPSEND 可关闭 GNSS。 AT+QGPS=1 OK //打开 GNSS。 //firmware 的 URC 上报。 +QGPS: 'firmware',0,0 //打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。 AT+QGPSLOC=0 //获取定位信息。 +QGPSLOC: 061951.000,3150.7223N,11711.9293E,0.7,62.2,2,000.00,0.0,0.0,110513,09 OK AT+QGPSEND OK //关闭 GNSS。 3.2. 参数的应用 打开 GNSS 并将设为 1 后，可以直接通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc',1 //将设为 1，使能通过 AT+QGPSGNMEA 获取 NMEA 语句。 OK AT+QGPSGNMEA='GGA' //获取 GGA 语句。 +QGPSGNMEA: $GPGGA,091717.000,3149.306063,N,11706.933160,E,1,11,1.152,92.614,M,0,M,,*44 OK AT+QGPSCFG='nmeasrc',0 //将设为 0，禁用通过 AT+QGPSGNMEA 获取 NMEA 语句。 OK AT+QGPSGNMEA='GGA' //获取 GGA 语句。 +CME ERROR: 507 //禁用通过 AT+QGPSGNMEA 获取 NMEA 语句，因此无法获取 GGA 语句。 上海移远通信技术股份有限公司 28 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 3.3. GNSS 休眠模式 模块上电并打开 GNSS 之后，在不断电重启的情况下发送 AT+QGPSEND 使 GNSS 引擎掉电关闭、 停止定位降低流耗。在 2 个小时内通过 AT+QGPS=1 打开 GNSS 引擎会进行热启动，从而实现快速定位。 AT+QGPS=1 //打开 GNSS。 OK AT+QGPSEND OK //在不断电重启的情况下关闭 GNSS。此时 GNSS 引擎掉电并停止定位，但是星历数据保存。 AT+QGPSLOC=0 //获取定位信息。 +CMS ERROR: 505 //此时 GNSS 功能无法使用。 AT+QGPS=1 //2 小时内重新开启 GNSS，GNSS 引擎执行热启动。 OK AT+QGPSLOC=0 //获取定位信息。 +QGPSLOC: 121251.000,2301.4623N,11314.4612E,0.8,141.6,3,000.00,0.5,0.3,020321,20 OK 3.4. Firmware 的 URC 上报 AT+QGPSCFG='urc' +QGPSCFG: 'urc',0x9 OK AT+QGPS=1 OK +QGPS: 'firmware',0,0 //firmware 的 URC 上报功能默认开启。 //打开 GNSS。 //Firmware 加载成功 URC。 备注 EC200G-CN 和 EG800G-CN 模块不支持上报+QGPS: 'mode',（GNSS 冷/热/温启动相关 URC），故为默认配置（=0x09）时，模块仅上报 firmware 相关 URC。 上海移远通信技术股份有限公司 29 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 3.5. AGPS 功能的 URC 上报 AT+QAGPSCFG 用于配置 AGPS 的相关参数；AT+QAGPS=1 启用 AGPS 功能。在联网正常以及 AGPS 的相关参数配置正确的前提下，模块在每次开机并打开 GNSS 后均能自动获取星历数据，实现快速定位。 AT+QAGPS=1 OK AT+QGPSCFG='urc',0x4 OK AT+QGPS=1 OK //开启 AGPS 功能。 //使能 AGPS 的 URC 上报功能。 //打开 GNSS。 +QGPS: 'agps',0,0 AT+CFUN=0 OK AT+QGPSEND OK AT+QGPS=1 OK //AGPS 文件下载应用成功 //设置飞行模式 //关闭 GNSS //打开 GNSS +QGPS: 'agps',0,3 //AGPS 文件下载异常，异常原因为 SIM 卡状态错误（处于 AT+CFUN=0 状态） 上海移远通信技术股份有限公司 30 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 4 错误码 表示与 GNSS 操作相关的错误，详细的参数值，见下表。 表 2：错误码列表 501 502 503 504 505 506 507 508 512 513 514 515 516 517 549 错误代码 Invalid parameter(s) Operation not supported GNSS subsystem busy Session is ongoing Session not active Operation timeout Function not enabled Time information error Validity time is out of range Internal resource error GNSS locked End by E911 Not fixed now CMUX port is not opened Unknown error 中文解释 无效参数 操作不支持 GNSS 子系统繁忙 会话仍在进行 会话未激活 操作超时 功能未使能 时间信息错误 已过有效期 内部资源错误 GNSS 锁住 由 E911 结束 当前未定位 CMUX 端口未打开 未知错误 上海移远通信技术股份有限公司 31 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 表 3：firmware 的 URC 错误代码列表 0 0 0 0 0 0 1 2 3 4 错误代码 / Other error File transferred error File does not exist File verified error 中文解释 firmware 加载成功 其他错误 文件传输错误 文件不存在 文件校验失败 表 4：AGPS 的 URC 错误代码列表 0 0 0 0 0 0 0 0 1 2 3 4 5 6 错误代码 / Other error File transfer error Sim status error Network not registered error Data call error Socket error 中文解释 AGPS 文件下载应用成功 其他错误 文件传输错误 SIM 卡状态错误 网络未注册 拨号激活错误 Socket 连接错误 上海移远通信技术股份有限公司 32 / 34 EC200G-CN&EG800G-CN GNSS 应用指导 5 附录 术语缩写 表 5：术语缩写 缩写 AGPS APN BDS CMUX DOP Galileo GGA GLONASS GNSS GPS 英文全称 Assisted GPS (Global Positioning System) Access Point Name BeiDou Navigation Satellite System Connection Multiplexing Dilution of Precision Galileo Satellite Navigation System Global Positioning System Fix Data Global Navigation Satellite System Global Navigation Satellite System Global Positioning System GSA GPS DOP and Active Satellites GSV HDOP IP IPv4 IPv6 ME NMEA GNSS Satellites in View Horizontal Dilution of Precision Internet Protocol Internet Protocol version 4 Internet Protocol version 6 Mobile Equipment NMEA (National Marine Electronics Association) 0183 Interface Standard 中文全称 辅助全球定位系统 接入点名称 北斗卫星导航系统 连接（串口）多路复用 精度因子 伽利略卫星导航系统 全球定位系统定位数据 格洛纳斯卫星导航系统 全球导航卫星系统 全球定位系统 GNSS 精度因子（DOP）与有效 卫星 可视的 GNSS 卫星 水平精度因子 互联网协议 第四版互联网协议 第六版互联网协议 移动设备 NMEA（美国国家海洋电子协会） 0183 接口标准 上海移远通信技术股份有限公司 33 / 34 NVRAM RF RMC UART URL USB UTC VTG EC200G-CN&EG800G-CN GNSS 应用指导 Non-Volatile Random Access Memory Radio Frequency Recommended Minimum Specific GNSS Data Universal Asynchronous Receiver & Transmitter Uniform Resource Locator Universal Serial Bus Coordinated Universal Time Course Over Ground and Ground Speed 非易失性随机存取存储器 射频 推荐的最少专用 GNSS 数据 通用费同步收发传输器 统一资源定位符 通用串行总线 协调世界时 地面速度信息 上海移远通信技术股份有限公司 34 / 34

LTE Standard(A)系列 HTTP(S)应用指导 LTE Standard 模块系列 版本：1.5 日期：2023-10-26 状态：受控文件 LTE Standard(A)系列 HTTP(S)应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 40 LTE Standard(A)系列 HTTP(S)应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 40 LTE Standard(A)系列 HTTP(S)应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-10-30 2020-11-30 2021-04-13 作者 Luffy LIU Luffy LIU Luffy LIU 1.2 2022-03-02 Larson LI 1.3 2022-07-25 Larson LI 1.4 2023-04-25 Larson LI 1.5 2023-10-26 Fawei ZHOU 变更表述 文档创建 受控版本 1. 增加文档适用模块 EC200N-CN 和 EC600N-CN。 2. 更新举例（第 3 章）。 1. 增加文档适用模块 EC200A 系列、EC800N-CN 和 EG915N-EU。 2. 删除 EG912Y-CN 模块。 3. 新 增 命 令 AT+QHTTPCFG: 'reqheader/add',,和 AT+QHTTPCFG: 'reqheader/add',,（第2.3.1章）。 4. 更新 AT+QHTTPCFG='closed/ind'的参 数解释（第 2.3.1 章）。 1. 新 增 适 用 模 块 EC200M-CN 、 EC600M-CN 、 EC800M-CN、EG915N-LA 和 EG912N-EN。 2. 删除适用模块 EC200T 系列。 3. 新 增 参 数 的 数 据 类 型 'application/json'和'image/jpeg'（第 2.3.1 章）。 更新适用模块： ⚫ 新增 EG810M-CN 和 EG950A-EL； ⚫ 删除 EC600S-CN。 1. 更新适用模块： ⚫ 新增适用模块 EC600K-CN、EC800K 系列和 EG800K 系列； ⚫ 更新 EC200N-CN 为 EC200N 系列； ⚫ 更新 EC600M-CN 为 EC600M 系列； ⚫ 更新 EG810M-CN 为 EG810M 系列； ⚫ 更新 EG950A-EL 为 EG950A 系列。 上海移远通信技术股份有限公司 3 / 40 LTE Standard(A)系列 HTTP(S)应用指导 2. 新增不同 Flash 大小的模块型号对 HTTP(S)功能支持 情况有所不同的备注（第 1.1 章）。 上海移远通信技术股份有限公司 4 / 40 LTE Standard(A)系列 HTTP(S)应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 5 表格索引 ........................................................................................................................................................ 7 1 引言 ........................................................................................................................................................ 8 1.1. 适用模块 ...................................................................................................................................... 8 1.2. HTTP(S)命令使用流程 ................................................................................................................ 9 1.3. HTTP(S)请求头信息说明........................................................................................................... 10 1.3.1. 自定义 HTTP(S)请求头信息 ........................................................................................... 10 1.3.2. 输出 HTTP(S)响应头信息............................................................................................... 10 1.4. 数据模式说明............................................................................................................................. 10 2 HTTP(S) AT 命令详解.......................................................................................................................... 11 2.1. AT 命令说明 .............................................................................................................................. 11 2.1.1. 定义 ................................................................................................................................ 11 2.1.2. AT 命令语句 ................................................................................................................... 11 2.2. AT 示例声明 .............................................................................................................................. 12 2.3. AT 命令详解 .............................................................................................................................. 12 2.3.1. AT+QHTTPCFG 配置 HTTP(S)服务器参数 ................................................................ 12 2.3.2. AT+QHTTPURL 设置 HTTP(S)服务器 URL................................................................ 16 2.3.3. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器.................................................... 17 2.3.4. AT+QHTTPGETEX 发送范围 GET 请求到 HTTP(S)服务器 ....................................... 18 2.3.5. AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 ................... 19 2.3.6. AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 ........................ 21 2.3.7. AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 ........................... 22 2.3.8. AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 ................................ 23 2.3.9. AT+QHTTPSTOP 取消 HTTP(S)请求 ......................................................................... 24 3 举例 ...................................................................................................................................................... 25 3.1. 访问 HTTP 服务器 ..................................................................................................................... 25 3.1.1. 发送 HTTP GET 请求并读取响应信息............................................................................ 25 3.1.2. 发送 HTTP POST 请求并读取响应信息 ......................................................................... 26 3.1.2.1. 通过 UART/USB 获取 POST 请求体 .................................................................. 26 3.1.2.2. 从文件系统获取 POST 请求体 ........................................................................... 27 3.2. 访问 HTTPS 服务器................................................................................................................... 28 3.2.1. 发送 HTTPS GET 请求并读取响应信息 ......................................................................... 28 3.2.2. 发送 HTTPS POST 请求并读取响应信息....................................................................... 30 3.2.2.1. 从 UART/USB 获取 POST 请求体...................................................................... 30 3.2.2.2. 从文件系统获取 POST 请求体 ........................................................................... 32 4 常见问题处理........................................................................................................................................ 34 4.1. HTTP(S) AT 命令执行失败........................................................................................................ 34 4.2. PDP 激活失败............................................................................................................................ 34 上海移远通信技术股份有限公司 5 / 40 LTE Standard(A)系列 HTTP(S)应用指导 4.3. DNS 解析失败 ........................................................................................................................... 34 4.4. 数据模式进入失败 ..................................................................................................................... 35 4.5. GET/POST 请求发送失败 ......................................................................................................... 35 4.6. 响应信息读取失败 ..................................................................................................................... 35 5 错误代码 ............................................................................................................................................... 36 6 HTTP(S)响应错误代码 ......................................................................................................................... 38 7 附录 参考文档及术语缩写 ................................................................................................................... 39 上海移远通信技术股份有限公司 6 / 40 LTE Standard(A)系列 HTTP(S)应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 8 表 2：AT 命令类型 ..................................................................................................................................... 11 表 3：错误代码列表.................................................................................................................................... 36 表 4：HTTP(S)响应代码列表 ..................................................................................................................... 38 表 5：参考文档 ........................................................................................................................................... 39 表 6：术语缩写 ........................................................................................................................................... 39 上海移远通信技术股份有限公司 7 / 40 LTE Standard(A)系列 HTTP(S)应用指导 1 引言 移远通信 LTE Standard(A)系列模块为 HTTP(S)服务器提供 HTTP(S)应用程序。 HTTP（HyperText Transfer Protocol，超文本传输协议）是一种用于分布式、协作式和超媒体信息系 统的应用层协议。 HTTPS（HyperText Transfer Protocol Secure，超文本传输安全协议）是一种通过计算机网络进行安 全通信的传输协议。HTTPS 经由 HTTP 进行通信，但利用 SSL/TLS 来加密数据包。HTTPS 开发的主要目 的，是提供对网站服务器的身份认证，保护交换资料的隐私与完整性。 本文档主要介绍了与 HTTP(S)相关的 AT 命令。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N 系列 EC200S 系列 EC600M 系列 EC600N-CN EC600K-CN EC800M-CN EC800N-CN EC800K 系列 EG800K 系列 EG810M 系列 上海移远通信技术股份有限公司 8 / 40 LTE Standard(A)系列 HTTP(S)应用指导 EG912N-EN EG912Y-EU EG915N 系列 EG950A 系列 备注 受限于模块 Flash 存储空间大小，不同型号的模块对于 HTTP(S)功能支持有所差异，详情请咨询移远通 信技术支持。 1.2. HTTP(S)命令使用流程 通过 LTE Standard(A)系列模块的 TCP/IP AT 命令，可配置 PDP 上下文，激活或去激活上下文以及查 询 PDP 上下文状态。通过 LTE Standard(A)系列模块的 HTTP(S) AT 命令，可以发送 HTTP(S) GET/POST 请求到 HTTP(S)服务器，并读取来自 HTTP(S)服务器的响应结果。大致流程如下： 第一步，使用 AT+QICSGP 配置 PDP 上下文的、、和其他参数，详 细信息请参考文档 [1]。 第二步，通过 AT+QIACT 激活 PDP 上下文后，使用 AT+QIACT?查询已分配的 IP 地址，参考文档 [1]。 第三步，通过 AT+QHTTPCFG 配置 PDP 和 SSL 上下文 ID。 第四步，通过 AT+QSSLCFG 配置 SSL 上下文参数，参考文档 [2]。 第五步，通过 AT+QHTTPURL 设置 HTTP(S) URL。 第六步，发送 HTTP(S)请求。AT+QHTTPGET 用于发送 HTTP(S) GET 请求，AT+QHTTPGETEX 用 于发送 HTTP(S)范围 GET 请求。AT+QHTTPPOST 或 AT+QHTTPPOSTFILE 用于发送 HTTP(S) POST 请求。 第七步，通过 AT+QHTTPREAD 或 AT+QHTTPREADFILE 读取 HTTP(S)响应信息。 第八步，通过 AT+QIDEACT 去激活 PDP 上下文，参考文档 [1]。 上海移远通信技术股份有限公司 9 / 40 LTE Standard(A)系列 HTTP(S)应用指导 1.3. HTTP(S)请求头信息说明 1.3.1. 自定义 HTTP(S)请求头信息 模块自动填补 HTTP(S)请求头信息，用户可通过 AT+QHTTPCFG 将配置为 1 自定 义 HTTP(S)请求头信息，但需遵循以下标准： ⚫ 遵循 HTTP(S)请求头信息语句规范。 ⚫ HTTP(S)请求行中的 URI 值和 Host:请求头信息必须与 AT+QHTTPURL 配置的 URL 一致。 ⚫ HTTP(S)请求头信息必须以结尾。 以下为标准 HTTP(S) POST 请求头信息示例： POST /processorder.php HTTP/1.1 Host: 220.180.239.212:8011 Accept: */* User-Agent: QUECTEL_MODULE Connection: Keep-Alive Content-Type: application/x-www-form-urlencoded Content-Length: 48 Message=1111&Appleqty=2222&Orangeqty=3333&find=1 1.3.2. 输出 HTTP(S)响应头信息 模块不自动输出 HTTP(S)响应头信息，可通过 AT+QHTTPCFG 将配置为 1 获取 HTTP(S)响应头信息，然后执行 AT+QHTTPREAD 或 AT+QHTTPREADFILE，HTTP(S)响应头信息将以 HTTP(S)响应体形式输出。 1.4. 数据模式说明 LTE Standard(A)系列模块的 COM 口有两种工作模式，一是 AT 命令模式，另一种是数据模式。AT 命 令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。 用户可以通过+++或者DTR（需先设置AT&D1）两种方式退出数据模式，为了防止+++被当成数据发送， 实际操作时必须遵循以下标准： ⚫ +++输入前/后 1 秒内不能输入其它任何数据。 ⚫ 必须在 1 秒内输入+++，并且不能输入其它任何数据。 通过执行 AT+QHTTPURL、AT+QHTTPPOST 和 AT+QHTTPREAD 可使 COM 口进入数据模式，但 在这些命令响应之前，若通过+++或拉高 DTR 退出数据模式，会中断这些命令的执行。在这种情况下，无 法通过执行 ATO 使 COM 口重新进入数据模式。 上海移远通信技术股份有限公司 10 / 40 LTE Standard(A)系列 HTTP(S)应用指导 2 HTTP(S) AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 11 / 40 LTE Standard(A)系列 HTTP(S)应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QHTTPCFG 配置 HTTP(S)服务器参数 该命令用于配置 HTTP(S)服务器参数，包括配置 PDP 上下文 ID，自定义 HTTP(S)请求头信息，输出 HTTP(S)响应头信息和查询 SSL 设置。若执行设置命令时只保留一个参数，表示查询当前配置。 AT+QHTTPCFG 配置 HTTP(S)服务器参数 测试命令 AT+QHTTPCFG=? 响应 +QHTTPCFG: 'contextid',(支持的范围) +QHTTPCFG: 'requestheader',(支持的 列表) +QHTTPCFG: 'responseheader',(支持的列表) +QHTTPCFG: 'sslctxid',(支持的范围) +QHTTPCFG: 'contenttype',(支持的范围) +QHTTPCFG: 'rspout/auto',(支持的列表) +QHTTPCFG: 'closed/ind',(支持的列表) +QHTTPCFG: 'reqheader/add',, +QHTTPCFG: 'reqheader/remove', 查询命令 AT+QHTTPCFG? OK 响应 +QHTTPCFG: 'contextid', +QHTTPCFG: 'requestheader', +QHTTPCFG: 'responseheader', +QHTTPCFG: 'sslctxid', +QHTTPCFG: 'contenttype', +QHTTPCFG: 'rspout/auto', +QHTTPCFG: 'closed/ind', +QHTTPCFG: 'reqheader/add',[,:,...] +QHTTPCFG: 'reqheader/remove',[,,...] 上海移远通信技术股份有限公司 12 / 40 LTE Standard(A)系列 HTTP(S)应用指导 设置命令 AT+QHTTPCFG='contextid'[,] OK 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'contextid', OK 设置命令 AT+QHTTPCFG='requestheader'[,] 若指定可选参数，则配置 PDP 上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'requestheader', OK 设置命令 AT+QHTTPCFG='responseheader'[, ] 若指定可选参数，则禁用或启用自定义 HTTP(S)请求头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'responseheader', OK 设置命令 AT+QHTTPCFG='sslctxid'[,] 若指定可选参数，则禁用或启用输出 HTTP(S)响应头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，查询当前配置： +QHTTPCFG: 'sslctxid', OK 若指定可选参数，则配置用于 HTTP(S)的 SSL 上下文 ID： OK 或者 +CME ERROR: 上海移远通信技术股份有限公司 13 / 40 LTE Standard(A)系列 HTTP(S)应用指导 设置命令 AT+QHTTPCFG='contenttype'[,] 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'contenttype', OK 设置命令 AT+QHTTPCFG='rspout/auto'[,] 若指定可选参数，则配置 HTTP(S)体的数据类型： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'rspout/auto', OK 设置命令 AT+QHTTPCFG='closed/ind'[,] 若指定可选参数，则禁用或启用自动输出 HTTP(S)响应头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，查询当前配置： +QHTTPCFG: 'closed/ind', OK 设置命令 AT+QHTTPCFG='reqheader/add'[,< header_name>[,]] 若指定可选参数，则禁用或启用上报 HTTP(S)会话关闭 URC +QHTTPURC: 'closed'： OK 或者 +CME ERROR: 响应 若省略全部可选参数，则查询当前增加的自定义报文头： +QHTTPCFG: 'reqheader/add',[,:,...] OK 若 省 略 可 选 参 数 ， 则 查 询 报 文 头 的属性值： +QHTTPCFG: 'reqheader/add',: 上海移远通信技术股份有限公司 14 / 40 LTE Standard(A)系列 HTTP(S)应用指导 OK 或者 +CME ERROR: 设置命令 AT+QHTTPCFG='reqheader/remove ', 最大响应时间 特性说明 若指定可选参数，则设置自定义报文头： OK 或者 +CME ERROR: 响应 OK 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。PDP 上下文 ID。范围：1~15；默认值：1。 整型。禁用或启用自定义 HTTP(S)请求头信息。 0 禁用 1 启用 整型。禁用或启用输出 HTTP(S)响应头信息。 0 禁用 1 启用 整型。HTTP(S)的 SSL 上下文 ID。范围：0~5；默认值：1。通过 AT+QSSLCFG 配置 SSL 参数，参考文档 [2]。 整型。HTTP(S)体的数据类型。 0 'application/x-www-form-urlencoded' 1 'text/plain' 2 'application/octet-stream' 3 'multipart/form-data' 4 'application/json' 5 'image/jpeg' 整型。禁用或启用自动输出 HTTP(S)响应头信息。若启用自动输出 HTTP(S) 响应头信息，AT+QHTTPREAD 和 AT+QHTTPREADFILE 会执行失败。 0 禁用 1 启用 整型。禁用或启用上报 HTTP(S)会话关闭 URC +QHTTPURC: 'closed'。 0 禁用 1 启用 字符串类型。自定义报文头名称。 上海移远通信技术股份有限公司 15 / 40 LTE Standard(A)系列 HTTP(S)应用指导 字符串类型。自定义报文头内容。 整型。添加的自定义报文头数量。默认值：0。 错误码。详细信息请参考第 5 章。 2.3.2. AT+QHTTPURL 设置 HTTP(S)服务器 URL HTTP(S)服务器的 URL 必须以 http://或 https://开头，表示访问 HTTP 或 HTTPS 服务器。 AT+QHTTPURL 设置 HTTP(S)服务器 URL 测试命令 AT+QHTTPURL=? 响应 +QHTTPURL: ( 支 持 的 范 围 ),( 支 持 的 范围) 查询命令 AT+QHTTPURL? OK 响应 [+QHTTPURL: ] OK 设置命令 AT+QHTTPURL=[,] 响应 若参数格式正确，且不发送 HTTP(S) GET/POST 请求： CONNECT TA 切换到透传模式，即可输入 URL。当输入数据的总大小达 到，TA 将切换回命令模式并上报以下结果： OK 若 输 入 时 间 达 到 ， 但 接 收 的 URL 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +CME ERROR: 最大响应时间 特性说明 若参数格式不正确或发生其他错误： +CME ERROR: 取决于 该命令立即生效； 参数配置不保存。 参数 整型。URL 长度。范围：1~2048；单位：字节。 整型。URL 的最大输入时间。范围：1~65535；默认值：60；单位：秒。 错误码。详细信息请参考第 5 章。 上海移远通信技术股份有限公司 16 / 40 LTE Standard(A)系列 HTTP(S)应用指导 2.3.3. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器 根 据 在 AT+QHTTPCFG='requestheader'[,] 中 配 置 的 ， AT+QHTTPGET 设置命令有两种形式。若为 1，发送 AT+QHTTPGET 后，若 125 秒 内输出 CONNECT，则表示 HTTP(S)服务器连接成功；若 125 秒内未上报 CONNECT，将输出+CME ERROR: 。 发送 AT+QHTTPGET 上报 OK 后，需要等待一段时间（参考最大响应时间）才会输出 URC +QHTTPGET: ,[,]。 +QHTTPGET: ,[,] 中 ， 仅 当 为 0 时 ， 才 上 报 。若 HTTP(S)响应头信息包括 CONTENT-LENGTH，将上报信息。 AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器 测试命令 AT+QHTTPGET=? 响应 +QHTTPGET: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) OK 设置命令 若为 0（禁用自定义 HTTP(S)请求头信息） AT+QHTTPGET[=] 响应 若参数格式正确且无其他错误发生： OK 模块收到来自 HTTP(S)服务器的响应后，将上报以下 URC： +QHTTPGET: ,[,] 设置命令 若为 1（启用自定义 HTTP(S)请求头信息） AT+QHTTPGET=,[,] 若参数格式不正确或有其他错误发生： +CME ERROR: 响应 若 HTTP(S)服务器连接成功： CONNECT TA 切换到透传模式，即可输入 HTTP(S) GET 请求头信息。当 输入数据的总大小达到，TA 将切换回命令模式 并上报以下结果： OK 模块收到来自 HTTP(S)服务器的响应后，将上报以下 URC： +QHTTPGET: ,[,] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +QHTTPGET: 上海移远通信技术股份有限公司 17 / 40 LTE Standard(A)系列 HTTP(S)应用指导 最大响应时间 特性说明 若参数格式不正确或发生其他错误： +CME ERROR: 取决于 该命令立即生效； 参数配置不保存。 参数 整 型 。 上 报 OK 后 ， 此 参 数 可 用 来 配 置 HTTP(S) GET 响 应 +QHTTPGET: ,[,]的最大响应时间。范围：1~65535；默 认值：60；单位：秒。 整型。HTTP(S)请求信息的长度，包括 HTTP(S)请求头信息和 HTTP(S)请求体。 范围：1~2048；单位：字节。 整型。HTTP(S)请求信息的最大输入时间。范围：1~65535；默认值：60；单位： 秒。 整型。HTTP(S)回复码。详细信息请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。 0 禁用 1 启用 整型。HTTP(S)响应体长度。单位：字节。 错误码。详细信息请参考第 5 章。 2.3.4. AT+QHTTPGETEX 发送范围 GET 请求到 HTTP(S)服务器 与读取文件类似，MCU 可以通过 AT+QHTTPGETEX 从 HTTP(S)服务器获取指定位置和指定长度的 数据，仅在 AT+QHTTPCFG='requestheader',0 时，方可执行该命令。之后，HTTP(S)服务器将始终以 206 代码响应范围 GET 请求。 AT+QHTTPGETEX 发送范围 GET 请求到 HTTP(S)服务器 测试命令 AT+QHTTPGETEX=? 响应 +QHTTPGETEX: (支持的范围),, 设置命令 AT+QHTTPGETEX=,, OK 响应 若参数格式正确且无其他错误发生： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPGET: ,[,] 上海移远通信技术股份有限公司 18 / 40 LTE Standard(A)系列 HTTP(S)应用指导 最大响应时间 特性说明 若参数格式不正确或发生其他错误： +CME ERROR: 取决于 / 参数 整 型 。 上 报 OK 后 ， 此 参 数 可 用 来 配 置 HTTP(S) GET 响 应 +QHTTPGET: ,[,]的最大响应时间。范围：1~65535；默 认值：60；单位：秒。 整型。HTTP(S)客户端需要 GET 数据的初始位置。 整型。HTTP(S)客户端需要 GET 数据的长度。 整型。HTTP(S)回复码。详细信息请参考第 6 章。 整型。HTTP(S)响应体长度。单位：字节。 错误码。详细信息请参考第 5 章。 2.3.5. AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 该 命 令 用 于 通 过 UART/USB 发 送 HTTP(S) POST 请 求 到 HTTP(S) 服 务 器 。 根 据 在 AT+QHTTPCFG='requestheader'[,] 中 配 置 的 ， AT+QHTTPPOST 设置命令有两种形式。若为 0，则通过 UART/USB 口输入 POST 请 求体；若为 1，则通过 UART/USB 口输入 POST 请求头信息和 POST 请求体。 发送 AT+QHTTPPOST 后，若 125 秒内返回 CONNECT，则表示 HTTP(S)服务器连接成功；若 125 秒内未返回 CONNECT，将输出+CME ERROR: 。 上 报 OK 后 ， 需 要 等 待 一 段 时 间 （ 参 考 最 大 响 应 时 间 ） 才 会 输 出 URC +QHTTPPOST: ,[,]。 AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPOST=? 响应 +QHTTPPOST: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) OK 设置命令 若为 0（禁用自定义 HTTP(S)请求头信息） AT+QHTTPPOST=[,,] 响应 若参数格式正确，HTTP(S)服务器连接成功且 HTTP(S)请求头 信息发送完成： CONNECT 上海移远通信技术股份有限公司 19 / 40 LTE Standard(A)系列 HTTP(S)应用指导 TA 切换到透传模式，即可输入 HTTP(S) POST 请求体。当输 入数据总大小达到，TA 将切换回命令模式并上 报以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPOST: ,[,] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +QHTTPPOST: 若参数格式不正确或有其他错误发生： +CME ERROR: 设置命令 若为 1（启用自定义 HTTP(S)请求头信息） AT+QHTTPPOST=[,,] 响应 若参数格式正确且 HTTP(S)服务器连接成功： CONNECT TA 切换到透传模式，即可输入 HTTP(S) POST 请求体和 HTTP(S) POST 请 求 头 信 息 。 当 输 入 数 据 总 大 小 达 到 ，TA 将切换回命令模式并上报以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPOST: ,[,] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +QHTTPPOST: 最大响应时间 特性说明 若参数格式不正确或发生其他错误： +CME ERROR: 取决于网络和 / 参数 整 型 。 若 为 0 ， 表 示 POST 请 求 体 长 度 ； 若 为 1，表示 HTTP(S)请求信息的长度，包括 HTTP(S) POST 请求头信息和 HTTP(S) POST 请求体。范围：1~1024000；单位：字节。 整型。POST 请求体或 HTTP(S)请求信息的最大输入时间。范围：1~65535； 默认值：60；单位：秒。 上海移远通信技术股份有限公司 20 / 40 LTE Standard(A)系列 HTTP(S)应用指导 整型。上报 OK 后，此参数可用来配置 HTTP(S) POST 响应+QHTTPPOST: ,[,]的最大输出时间。范围：1~65535； 默认值：60；单位：秒。 整型。HTTP(S)回复码。详细信息请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。 0 禁用 1 启用 整型。HTTP(S)响应体长度。单位：字节。 错误码。详细信息请参考第 5 章。 2.3.6. AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 该命令用于通过文件发送 POST 请求到 HTTP(S)服务器。根据在 AT+QHTTPCFG='requestheader' [,]中配置的，AT+QHTTPPOSTFILE 操作的文件有两种形式。若为 0，文件系统的文件将为 POST 请求体；若为 1，文件系统的文件 将为 POST 请求头信息和 POST 请求体信息。 执行 AT+QHTTPPOSFILE 后，模块会上报 URC +QHTTPPOSTFILE: ,[,]表示命令执行结果。仅当为 0 时，才上报。 上 报 OK 后 ， 需 要 等 待 一 段 时 间 （ 参 考 最 大 响 应 时 间 ） 才 会 输 出 URC +QHTTPPOSTFILE: ,[,]信息。 AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPOSTFILE=? 设置命令 AT+QHTTPPOSTFILE=[, ,] （若为 1，指定的文 件必须包含 HTTP(S)请求头信息。） 响应 +QHTTPPOSTFILE: ,( 支 持 的 范 围),(支持的范围) OK 响应 若参数格式正确且 HTTP(S)服务器连接成功： OK 当模块收到来自 HTTP(S)服务器响应后： +QHTTPPOSTFILE: ,[,] 最大响应时间 特性说明 若参数格式不正确或发生其他错误： +CME ERROR: 取决于 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 21 / 40 参数 LTE Standard(A)系列 HTTP(S)应用指导 字符串类型。文件名称。最大长度为 80 字节。 整型。上报 OK 后，此参数可用来配置 HTTP(S) POST 响应+QHTTPPOST FILE: ,[,]的最大输出时间。范围：1 ~65535；默认值：60；单位：秒。 整型。HTTP(S)回复码。详细信息请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。 0 禁用 1 启用 整型。HTTP(S)响应体长度。单位：字节。 整型。HTTP(S)发送文件的模式。 0 直接发送文件内容 1 记录保存文件，暂不发送，等待和=2 时配置的文件一起发 送 2 发送文件，连同=1 时保存的文件一起发送（只支持两个文 件一起发送） 错误码。详细信息请参考第 5 章。 2.3.7. AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 发送 HTTP(S) GET/POST 请求后，可使用 AT+QHTTPREAD 通过 UART/USB 端口从 HTTP(S)服务 器读取 HTTP(S)响应信息。必须接收+QHTTPGET: ,[,]、+QHTT PPOST: ,[,]或+QHTTPPOSTFILE: ,[,]信息后才能执行 AT+QHTTPREAD。 AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 测试命令 AT+QHTTPREAD=? 响应 +QHTTPREAD: (支持的范围) 设置命令 AT+QHTTPREAD[=] OK 响应 若参数格式正确： CONNECT OK 当响应信息读取完成或两个数据包接收间隔时间达到 ： +QHTTPREAD: 若参数格式不正确或发生其他错误： +CME ERROR: 上海移远通信技术股份有限公司 22 / 40 LTE Standard(A)系列 HTTP(S)应用指导 最大响应时间 特性说明 取决于 / 参数 整型。接收两个数据包之间的最大间隔时间。范围：1~65535；默认值：60；单位：秒。 错误码。详细信息请参考第 5 章。 2.3.8. AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 发送 HTTP(S) GET/POST 请求后，可以使用 AT+QHTTPREADFILE 通过文件从 HTTP(S)服务器读 取 HTTP(S)响应信息，必须接收+QHTTPGET: ,[,]、+QHTTPPO ST: ,[,]或+QHTTPPOSTFILE: ,[,]信息后才能执行 AT+QHTTPREADFILE。 AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 测试命令 AT+QHTTPREADFILE=? 响应 +QHTTPREADFILE: ,(支持的范围) 设置命令 AT+QHTTPREADFILE=[, ] OK 响应 若参数格式正确： OK 当 body 读 取 完 成 或 两 个 数 据 包 接 收 间 隔 时 间 达 到 ：+QHTTPREADFILE: 最大响应时间 特性说明 若参数格式不正确或发生其他错误： +CME ERROR: 取决于 / 参数 整型。接收两个数据包之间的最大间隔时间。范围：1~65535；默认值：60； 单位：秒。 字符串类型。文件名称。最大长度为 80 字节。 错误码。详细信息请参考第 5 章。 上海移远通信技术股份有限公司 23 / 40 LTE Standard(A)系列 HTTP(S)应用指导 2.3.9. AT+QHTTPSTOP 取消 HTTP(S)请求 MCU 可通过该命令取消 HTTP(S) GET/POST 请求，断开与 HTTP(S)的会话连接。 AT+QHTTPSTOP 取消 HTTP(S)请求 测试命令 AT+QHTTPSTOP=? 执行命令 AT+QHTTPSTOP 响应 OK 响应 若参数格式正确且无其他错误发生： OK 最大响应时间 特性说明 若参数格式不正确或发生其他错误： +CME ERROR: 10 秒 / 参数 错误码。详细信息请参考第 5 章。 上海移远通信技术股份有限公司 24 / 40 LTE Standard(A)系列 HTTP(S)应用指导 3 举例 3.1. 访问 HTTP 服务器 3.1.1. 发送 HTTP GET 请求并读取响应信息 以下举例说明如何发送 HTTP GET 请求，启用 HTTP 响应头信息输出以及读取 HTTP GET 响应。 //发送 HTTP GET 响应示例。 AT+QHTTPCFG='contextid',1 //配置PDP上下文ID为1。 OK AT+QHTTPCFG='responseheader',1 //启用输出 HTTP 响应头信息。 OK AT+QIACT? //查询 PDP 上下文状态。 OK AT+QICSGP=1,1,'UNINET','','',1 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 OK AT+QIACT? //查询 PDP 上下文状态。 +QIACT: 1,1,1,'10.7.157.1' OK //第一路 PDP 默认激活，若查询显示未激活，可通过执行 AT+QIACT=1 激活。 AT+QIACT=1 //激活 PDP 上下文 1。 OK AT+QHTTPURL=23,80 //激活成功。 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT HTTP://www.sina.com.cn/ //输入长度为 23 个字节的 URL。（此 URL 仅为示例。请根据实际 情况输入正确的 URL。） OK AT+QHTTPGET=80 //发送 HTTP GET 请求，最大响应时间为 80 秒。 OK +QHTTPGET: 0,200,601710 //读取 HTTP GET 响应信息示例。 //若 HTTP 响应头信息中包括 CONTENT-LENGTH，则将上报 信息。 //方法 1：读取 HTTP 响应信息并通过 UART 口将其输出。 上海移远通信技术股份有限公司 25 / 40 LTE Standard(A)系列 HTTP(S)应用指导 AT+QHTTPREAD=80 //读取 HTTP 响应信息并通过 UART 口将其输出。HTTP 会话关 闭的最长等待时间为 80 秒。 CONNECT HTTP/1.1 200 OK //HTTP 响应头信息和响应体。 Server: nginx Date: Tue, 12 Sep 2017 05:57:29 GMT Content-Type: text/html Content-Length: 601710 Connection: close Last-Modified: Tue, 12 Sep 2017 05:54:48 GMT Vary: Accept-Encoding Expires: Tue, 12 Sep 2017 05:58:28 GMT Cache-Control: max-age=60 X-Powered-By: shci_v1.03 Age: 1 …… //此处响应信息省略。 OK +QHTTPREAD: 0 //成功读取 HTTP 响应头信息和响应体。 //方法 2：读取 HTTP 响应信息并将其储存到 UFS 文件中。 AT+QHTTPREADFILE='UFS:1.txt',80 OK //读取 HTTP 响应头信息和响应体并将其储存到 UFS:1.txt。 HTTP 会话关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //成功储存 HTTP 响应头信息和响应体。 3.1.2. 发送 HTTP POST 请求并读取响应信息 3.1.2.1. 通过 UART/USB 获取 POST 请求体 以下举例说明如何发送 HTTP POST 请求，通过 UART 口读取 POST 请求体以及如何读取 HTTP POST 响应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 上海移远通信技术股份有限公司 26 / 40 LTE Standard(A)系列 HTTP(S)应用指导 AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //查询 PDP 上下文状态。 OK //第一路 PDP 默认激活，若查询显示未激活，可通过执行 AT+QIACT=1 激活。 AT+QIACT=1 //激活 PDP 上下文 1。 OK //激活成功。 AT+QHTTPURL=59,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。 （此 URL 仅为示例，请根据实际 情况输入正确的 URL。） OK AT+QHTTPPOST=20,80,80 //发送 HTTP POST 请求，通过 UART 获取 POST 请求体。POST 请求体的最大输入时间和响应时间皆为 80 秒。 CONNECT Message=HelloQuectel //输入长度为 20 个字节的 POST 请求体。（此 POST 请求体仅 为示例，请根据实际情况输入正确的 POST 请求体。） OK +QHTTPPOST: 0,200,177 //若 HTTP 响应头信息包含 CONTENT-LENGTH，则将上报 信息。 AT+QHTTPREAD=80 //读取 HTTP 响应信息并通过 UART 口将其输出。HTTP 会话关 闭的最长等待时间为 80 秒。 CONNECT Message='HelloQuectel' ASCII:72 101 108 108 111 81 117 101 99 116 101 108 //输出 HTTP 响应信息。 OK +QHTTPREAD: 0 //成功输出 HTTP 响应信息。 3.1.2.2. 从文件系统获取 POST 请求体 以下举例说明如何发送 HTTP POST 请求，通过文件系统读取 POST 请求体，以及将 HTTP POST 响 应储存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 上海移远通信技术股份有限公司 27 / 40 LTE Standard(A)系列 HTTP(S)应用指导 AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //查询 PDP 上下文状态。 OK //第一路 PDP 默认激活，若查询显示未激活，可通过执行 AT+QIACT=1 激活。 AT+QIACT=1 //激活 PDP 上下文 1。 OK //激活成功。 AT+QHTTPURL=59,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。 （此 URL 仅为示例，请根据实际 情况输入正确的 URL。） OK //来自 UFS 文件的 POST 请求信息，读取 HTTP 响应信息并将其储存到 UFS 文件中。 AT+QHTTPPOSTFILE='UFS:2.txt',80 //发送 HTTP POST 请求，从 UFS:2.txt 中获取 POST 请求体， 最大响应时间为 80 秒。 OK +QHTTPPOSTFILE: 0,200,177 AT+QHTTPREADFILE='UFS:3.txt',80 OK //HTTP POST 请 求 发 送 成 功 后 ， 方 可 执 行 AT+QHTTPREADFILE。 //读取 HTTP 响应信息并将其储存到 UFS:3.txt。HTTP 会话关 闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTP 响应信息储存成功。 3.2. 访问 HTTPS 服务器 3.2.1. 发送 HTTPS GET 请求并读取响应信息 以下举例说明如何发送 HTTPS GET 请求，启用 HTTPS 响应头信息输出以及如何读取 HTTPS GET 响应信息。 //发送HTTPS GET请求示例 AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='responseheader',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK //配置PDP上下文ID为1。 //启用输出 HTTPS 响应头信息。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设 置 AT+CFUN=1,1 使配置生效。 上海移远通信技术股份有限公司 28 / 40 LTE Standard(A)系列 HTTP(S)应用指导 AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //查询 PDP 上下文状态。 OK //第一路 PDP 默认激活，若查询显示未激活，可通过执行 AT+QIACT=1 激活。 AT+QIACT=1 //激活 PDP 上下文 1。 OK //激活成功。 AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID 为 1。 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,0 //设置 SSL 验证级别为 0，表示无身份验证模式。 OK AT+QHTTPURL=22,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT https://www.alipay.com //输入长度为 22 个字节的 URL。（此 URL 仅为示例，请根据实 际情况输入正确的 URL。） OK AT+QHTTPGET=80 //发送 HTTPS GET 请求，最大响应时间为 80 秒。 OK +QHTTPGET: 0,200,21472 //读取 HTTPS 响应信息示例。 //若 HTTPS 响应头信息包含 CONTENT-LENGTH，则将上报 信息。 //方法 1：读取 HTTPS 响应信息并将其通过 UART 输出。 AT+QHTTPREAD=80 //读取 HTTPS 响应信息并将其通过 UART 输出。HTTP 会 话关闭的最长等待时间为 80 秒。 CONNECT //HTTPS 响应头信息和响应体。 HTTP/1.1 200 OK Server: Tengine/2.1.0 Date: Tue, 12 Sep 2017 05:54:34 GMT Content-Type: text/html; charset=utf-8 Content-Length: 21451 Connection: keep-alive …… //此处响应信息省略。 OK +QHTTPREAD: 0 //HTTPS 响应头信息和响应体读取成功。 上海移远通信技术股份有限公司 29 / 40 LTE Standard(A)系列 HTTP(S)应用指导 //方法 2：读取 HTTPS 响应信息并将其储存到 UFS 文件中。 AT+QHTTPREADFILE='UFS:4.txt',80 OK //读取 HTTPS 响应头信息和响应体并将其储存在 UFS:4.txt。 HTTP 会话关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTPS 响应头信息和响应体储存成功。 3.2.2. 发送 HTTPS POST 请求并读取响应信息 3.2.2.1. 从 UART/USB 获取 POST 请求体 以下举例说明如何发送 HTTPS POST 请求，通过 UART 读取 POST 请求体以及如何读取 HTTPS POST 响应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设 置 AT+CFUN=1,1 使配置生效。 //查询 PDP 上下文状态。 OK //第一路 PDP 默认激活，若查询显示未激活，可通过执行 AT+QIACT=1 激活。 AT+QIACT=1 //激活 PDP 上下文 1。 OK //激活成功。 AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID 为 1。 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证书，客户端证书和客户端私钥。 OK AT+QFUPL='cacert.pem' //上传 CA 证书至 UFS。 CONNECT +QFUPL:1216,7648 上海移远通信技术股份有限公司 30 / 40 LTE Standard(A)系列 HTTP(S)应用指导 OK AT+QFUPL='clientcert.pem' CONNECT +QFUPL:1216,5558 //上传客户端证书至 UFS。 OK AT+QFUPL='clientkey.pem' CONNECT +QFUPL:1706,538 //上传客户端私钥至 UFS。 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' OK AT+QHTTPURL=45,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT HTTPs://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。 （此 URL 仅为示例， 请根据实际情况输入正确的 URL。） OK AT+QHTTPPOST=48,80,80 //发送 HTTPS POST 请求，通过 UART 获取 POST 请求体。POST 请求体的最大输入时间和响应时间为 80 秒。 CONNECT Message=1111&Appleqty=2222&Orangeqty=3333&find=1 //输入长度为 48 个字节的 POST 请求体。 （此 POST 请求体仅为示例，请根据实际情 况输入正确的 POST 请求体。） OK +QHTTPPOST: 0,200,285 //若 HTTPS 响应头信息包含 CONTENT-LENGTH，则将上报 信息。 AT+QHTTPREAD=80 //读取 HTTPS 响应信息并将其通过 UART 输出。HTTP 会话关闭 的最长等待时间为 80 秒。 CONNECT //HTTPS 响应信息读取成功。 Quectel's Auto Parts - Order Results 上海移远通信技术股份有限公司 31 / 40 LTE Standard(A)系列 HTTP(S)应用指导 Quectel's Auto Parts Order Results Order processed at 02:49, 27th DecemberYour order is as follows: 1111 message2222 apple3333 orange OK +QHTTPREAD: 0 //HTTPS 响应信息输出成功。 3.2.2.2. 从文件系统获取 POST 请求体 以下举例说明如何发送 HTTPS POST 请求，从文件系统读取 POST 请求体以及如何将 HTTPS POST 响应信息储存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //查询 PDP 上下文状态。 OK //第一路 PDP 默认激活，若查询显示未激活，可通过执行 AT+QIACT=1 激活。 AT+QIACT=1 //激活 PDP 上下文 1。 OK //激活成功。 AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID 为 1。 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证 书，客户端证书和客户端私钥。 OK AT+QFUPL='cacert.pem' //上传 CA 证书至 UFS。 CONNECT +QFUPL:1216,7648 OK 上海移远通信技术股份有限公司 32 / 40 LTE Standard(A)系列 HTTP(S)应用指导 AT+QFUPL='clientcert.pem' CONNECT +QFUPL:1216,5558 OK //上传客户端证书至 UFS。 AT+QFUPL='clientkey.pem' CONNECT +QFUPL:1706,538 OK //上传客户端私钥至 UFS。 AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' OK AT+QHTTPURL=45,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT https://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示例， 请根据实际情况输入正确的 URL。） OK //POST 请求信息来自 UFS 文件，读取 HTTPS 响应信息并将其储存在 UFS 文件中。 AT+QHTTPPOSTFILE='UFS:5.txt',80 //发送 HTTPS POST 请求，从 UFS:5.txt 获取 POST 请求体， 最大响应时间为 80 秒。 OK +QHTTPPOSTFILE: 0,200,177 AT+QHTTPREADFILE='UFS:6.txt',80 OK //HTTPS POST 请 求 发 送 成 功 后 ， 方 可 执 行 AT+QHTTPREADFILE。 //读取 HTTPS 响应信息并将其储存在 UFS:6.txt'。HTTP 会话 关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTPS 响应信息储存成功。 上海移远通信技术股份有限公司 33 / 40 LTE Standard(A)系列 HTTP(S)应用指导 4 常见问题处理 4.1. HTTP(S) AT 命令执行失败 执行 HTTP(S) AT 命令后，若返回+CME ERROR: ，请检查是否插入了(U)SIM 卡，并注意执行 AT+CPIN?后是否返回了+CPIN: READY。 4.2. PDP 激活失败 若使用 AT+QIACT 激活 PDP 失败，请检查以下配置： 1. 查询是否通过 AT+CGATT?附着了 PS 域。若未附着 PS 域，请先执行 AT+CGATT=1 附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保已注册了 PS 域。 3. 通过 AT+QICSGP 查询 PDP 上下文参数，并确保已设置了指定 PDP 上下文的 APN。 4. 确保指定 PDP 上下文 ID 既不被 PPP 使用，也不通过 AT+CGACT 激活。 5. 根据 3GPP 规范，模块仅支持同时激活三个 PDP 上下文，因此激活 PDP 上下文的数量必须小于 3。 若上述配置无误，使用 AT+QIACT 激活 PDP 上下文仍失败，请重启模块。重启模块后，请至少检查 三次上述提及的配置，每次间隔 10 分钟，以避免频繁重启模块。 4.3. DNS 解析失败 执行 AT+QHTTPGET、AT+QHTTPPOST 和 AT+QHTTPPOSTFILE 后，若返回+CME ERROR: 714 （714：HTTP(S) DNS 错误），请检查以下配置： 1. 确认 HTTP(S)服务器域名有效。 2. 通过 AT+QIACT?查询 PDP 上下文状态，确保成功激活了指定的 PDP 上下文。 3. 通过 AT+QIDNSCFG 查询 DNS 服务器地址，确保 DNS 服务器的地址不是'0.0.0.0'。 上海移远通信技术股份有限公司 34 / 40 LTE Standard(A)系列 HTTP(S)应用指导 若 DNS 服务器的地址为'0.0.0.0'，有两种解决方法： 1. 通过 AT+QIDNSCFG 重新分配一个有效 DNS 服务器地址。 2. 通过 AT+QIDEACT 去激活 PDP 上下文，通过 AT+QIACT 重新激活 PDP 上下文。 4.4. 数据模式进入失败 执行 AT+QHTTPURL、AT+QHTTPGET、AT+QHTTPPOST 和 AT+QHTTPREAD 后，若返回+CME ERROR: 704（704：HTTP(S) UART 繁忙），请检查数据模式下是否存在其他端口，由于模块仅支持一个 端口处于数据模式，若存在其他端口，请退出其他端口数据模式后重新执行这些命令。 4.5. GET/POST 请求发送失败 若执行 AT+QHTTPGET、AT+QHTTPGETEX、AT+QHTTPPOST 和 AT+QHTTPPOSTFILE 失败， 请检查以下配置： 1. 确保通过 AT+QHTTPURL 输入的 URL 有效且可以访问。 2. 确保指定服务器支持 GET/POST 相关命令。 3. 确保 PDP 上下文已激活。 若上述配置无误，通过 AT+QHTTPGET、AT+QHTTPPOST 和 AT+QHTTPPOSTFILE 发送 GET/POST 请求仍失败，请通过 AT+QIDEACT 去激活 PDP 上下文，并通过 AT+QIACT 重新激活 PDP 上下文。若激 活 PDP 上下文失败，详细信息请参考第 4.2 章解决此问题。 4.6. 响应信息读取失败 通过 AT+QHTTPREAD 和 AT+QHTTPREADFILE 读取响应信息之前，首先要执行 AT+QHTTPGET、 AT+QHTTPPOST 和 AT+QHTTPPOSTFILE，之后将上报以下 URC： +QHTTPGET: ,[,] +QHTTPPOST: ,[,] +QHTTPPOSTFILE: ,[,] 执行 AT+QHTTTPREAD 和 AT+QHTTPREADFILE 时，若发生错误，如上报+CME ERROR: 717（717： HTTP(S) socket 读取错误），请通过 AT+QHTTPGET、AT+QHTTPPOST 和 AT+QHTTPPOSTFILE 向 HTTP(S)服务器重新发送 HTTP(S) GET/POST 请求；若请求仍发送失败，详细信息请参考第 4.5 章解决此 问题。 上海移远通信技术股份有限公司 35 / 40 LTE Standard(A)系列 HTTP(S)应用指导 5 错误代码 表示与移动设备或网络有关的错误代码。相关详细信息参见下表。 表 3：错误代码列表 错误代码 0 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 英文描述 Operation successful HTTP(S) unknown error HTTP(S) timeout HTTP(S) busy HTTP(S) UART busy HTTP(S) no GET/POST requests HTTP(S) network busy HTTP(S) network open failed HTTP(S) network no configuration HTTP(S) network deactivated HTTP(S) network error HTTP(S) URL error HTTP(S) empty URL HTTP(S) IP address error HTTP(S) DNS error HTTP(S) socket create error HTTP(S) socket connect error HTTP(S) socket read error 中文描述 操作成功 HTTP(S)未知错误 HTTP(S)超时 HTTP(S)繁忙 HTTP(S) UART 繁忙 HTTP(S)无 GET/POST 请求 HTTP(S)网络繁忙 HTTP(S)网络连接失败 HTTP(S)网络未配置 去激活 HTTP(S)网络 HTTP(S)网络错误 HTTP(S) URL 错误 HTTP(S)空 URL HTTP(S) IP 地址错误 HTTP(S) DNS 错误 HTTP(S) socket 创建错误 HTTP(S) socket 连接错误 HTTP(S) socket 读取错误 上海移远通信技术股份有限公司 36 / 40 LTE Standard(A)系列 HTTP(S)应用指导 718 HTTP(S) socket write error HTTP(S) socket 写入错误 719 HTTP(S) socket closed HTTP(S) socket 关闭 720 HTTP(S) data encode error HTTP(S)数据编码错误 721 HTTP(S) data decode error HTTP(S)数据解码错误 722 HTTP(S) read timeout HTTP(S)读取超时 723 HTTP(S) response failed HTTP(S)响应失败 724 Incoming call busy 来电忙 725 Voice call busy 语音通话忙 726 Input timeout 输入超时 727 Wait data timeout 数据等待超时 728 Wait HTTP(S) response timeout HTTP(S)等待响应超时 729 Memory allocation failed 内存分配不足 730 Invalid parameter 无效参数 上海移远通信技术股份有限公司 37 / 40 LTE Standard(A)系列 HTTP(S)应用指导 6 HTTP(S)响应错误代码 表示 HTTP(S)服务器响应代码。相关详细信息参见下表。 表 4：HTTP(S)响应代码列表 响应代码 200 403 404 409 411 500 英文描述 OK Forbidden Not found Conflict Length required Internal server error 中文描述 成功 禁止 未发现 冲突 需输入长度 内部服务器错误 上海移远通信技术股份有限公司 38 / 40 LTE Standard(A)系列 HTTP(S)应用指导 7 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_TCP(IP)_应用指导 [2] Quectel_LTE_Standard(A)系列_SSL_应用指导 [3] Quectel_LTE_Standard(A)系列_AT 命令手册 表 6：术语缩写 缩写 DNS DTR HTTP HTTPS ID PDP PPP PS SSL UART URI URL 英文全称 Domain Name Server Data Terminal Ready Hypertext Transfer Protocol Hypertext Transfer Protocol Secure Identification Packet Data Protocol Point-to-Point Protocol Packet Switch Security Socket Layer Universal Asynchronous Receiver/Transmitter Uniform Resource Identifier Uniform Resource Locator 中文全称 域名服务器 数据终端就绪 超文本传输协议 超文本传输安全协议 身份识别 分组数据协议 点对点协议 分组交换 安全 Socket 层 通用异步收发传输器 统一资源标示符 统一资源定位符 上海移远通信技术股份有限公司 39 / 40 URC USB (U)SIM UFS LTE Standard(A)系列 HTTP(S)应用指导 Unsolicited Result Code 未经请求的结果代码 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module （通用）用户身份识别模块 UNIX File System UNIX 文件系统 上海移远通信技术股份有限公司 40 / 40

LTE Standard(A)系列 MQTT 应用指导 LTE Standard 模块系列 版本：1.4 日期：2023-10-25 状态：受控文件 LTE Standard(A)系列 MQTT 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 36 LTE Standard(A)系列 MQTT 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 36 LTE Standard(A)系列 MQTT 应用指导 文档历史 修订记录 版本 日期 - 2020-08-12 1.0 2020-08-12 1.1 2021-04-15 1.2 2022-03-02 1.3 2022-07-25 1.4 2023-10-25 作者 Luffy LIU/ Larson LI Luffy LIU/ Larson LI Luffy LIU/ Larson LI Luffy LIU/ Larson LI Luffy LIU/ Larson LI Fawei ZHOU 变更表述 文档创建 受控版本 1. 增加文档适用模块 EC200N-CN 和 EC600N-CN。 2. 增加设置命令 AT+QMTCFG='edit/timeout', [,,]（第 3.3.1 章节）。 1. 增 加 文 档 适 用 模 块 EC200A 系 列 、 EC800N-CN 和 EG915N-EU。 2. 删除 EG912Y-CN 模块。 1. 新 增 适 用 模 块 EC200M-CN 、 EC600M-CN 、 EC800M-CN、EG915N-LA 和 EG912N-EN。 2. 删除适用模块 EC200T 系列。 1. 更新适用模块： ⚫ 新增 EC600K-CN、EC800K 系列、EG800K 系列、 EG810M 系列和 EG950A 系列。 ⚫ 删除 EOL 项目 EC600S-CN。 ⚫ 更新 EC200N-CN 为 EC200N 系列 2. 新增不同 Flash 大小的模块型号对 MQTT 功能支持情况 有所不同的备注（第 1.1 章）。 3. 新增不同模块型号对于 SSL 认证功能支持情况可选的备 注（第 3.3.1 和 5.2 章） 4. 更新 AT+QMTCFG='qmtping'命令描述及参数解释并新 增 AT+QMTCFG='protocol/check'命令（第 3.3.1 章）。 上海移远通信技术股份有限公司 3 / 36 LTE Standard(A)系列 MQTT 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 MQTT 数据交互..................................................................................................................................... 8 3 MQTT 相关 AT 命令 .............................................................................................................................. 9 3.1. AT 命令说明................................................................................................................................ 9 3.1.1. 定义 ................................................................................................................................. 9 3.1.2. AT 命令语句..................................................................................................................... 9 3.2. AT 示例声明.............................................................................................................................. 10 3.3. MQTT 相关 AT 命令描述 .......................................................................................................... 10 3.3.1. AT+QMTCFG 配置 MQTT 可选参数........................................................................... 10 3.3.2. AT+QMTOPEN 打开 MQTT 客户端网络 .................................................................... 19 3.3.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 .................................................................. 20 3.3.4. AT+QMTCONN 连接客户端到 MQTT 服务器............................................................. 20 3.3.5. AT+QMTDISC 客户端断开与 MQTT 服务器的连接.................................................... 22 3.3.6. AT+QMTSUB 订阅主题 .............................................................................................. 22 3.3.7. AT+QMTUNS 退订主题 .............................................................................................. 24 3.3.8. AT+QMTPUBEX 发布消息 ......................................................................................... 25 3.3.9. AT+QMTRECV 从缓存中读取消息 ............................................................................. 26 4 MQTT 相关 URC ................................................................................................................................. 28 4.1. +QMTSTAT MQTT 链路层状态变化的 URC.......................................................................... 28 4.2. +QMTRECV 通知 Host 读取 MQTT 数据包的 URC .............................................................. 29 4.3. +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC ........................................................ 30 5 举例 ..................................................................................................................................................... 31 5.1. 无 SSL 的 MQTT 操作举例....................................................................................................... 31 5.2. 含 SSL 的 MQTT 操作举例....................................................................................................... 33 6 附录 参考文档及术语缩写 .................................................................................................................. 36 上海移远通信技术股份有限公司 4 / 36 LTE Standard(A)系列 MQTT 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 9 表 3：MQTT 相关的 URC........................................................................................................................... 28 表 4：URC 中的错误码 .............................................................................................................................. 29 表 5：参考文档 ........................................................................................................................................... 36 表 6：术语缩写 ........................................................................................................................................... 36 上海移远通信技术股份有限公司 5 / 36 LTE Standard(A)系列 MQTT 应用指导 1 引言 移远通信 LTE Standard(A)系列模块支持 MQTT 功能。MQTT 是基于代理的发布/订阅模式通讯协议， 具有开放、简单、轻量和易于实现等特点。MQTT 最大优点在于，可以以极少的代码和有限的网络带宽， 为远程设备连接提供实时可靠的消息服务。 本文档主要介绍如何通过 AT 命令应用如下移远通信模块的 MQTT 功能。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(A) 模块 EC200A 系列 EC200M-CN EC200N 系列 EC200S 系列 EC600K-CN EC600M-CN EC600N-CN EC800K 系列 EC800M-CN EC800N-CN EG800K 系列 EG810M 系列 EG912N-EN EG912Y-EU 上海移远通信技术股份有限公司 6 / 36 LTE Standard(A)系列 MQTT 应用指导 EG915N 系列 EG950A 系列 备注 受限于模块 Flash 存储空间大小，不同型号的模块对于 MQTT 功能支持有所差异，详情请咨询移远通信 技术支持。 上海移远通信技术股份有限公司 7 / 36 LTE Standard(A)系列 MQTT 应用指导 2 MQTT 数据交互 本章节主要介绍 MQTT 功能的数据交互机制。 MCU 模块 链路层 MQTT服务器 接收URC格式的 PUBLISH消息 AT+QMTCFG='will',, AT+QMTCFG='timeout',, AT+QMTOPEN=,'', OK +QMTOPEN: , AT+QMTCONN AT+QMTCONN=,, OK +QMTCONN: ,[,] TCP-REQ TCP established CONN-REQ Start timer T1, T2 CONN ACK-IND Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK 发送链接数据包 服务器收到连接数据包并返回ACK AT+QMTSUB AT+QMTSUB=,... OK +QMTSUB:,,[,] SUB-REQ (msgId) Start timer T1 SUB ACK-IND (msgId) Stop T1 or handle Excep2 AT+QMTUNS AT+QMTUNS=,... OK UNS-REQ (msgId) Start timer T1 +QMTUNS: ,,[,] AT+QMTPUBEX=,,=0, ,, OK UNS ACK-IND (msgId) Stop T1 or handle Excep2 PUB-REQ AT+QMTPUBEX AT+QMTPUBEX=,,=1, (=1) ,, OK PUB-REQ (msgId) Start timer T1 +QMTPUBEX: ,,[,] PUB ACK-IND (msgId) Stop T1 or handle Excep2 AT+QMTPUBEX AT+QMTPUBEX=,,=2, (=2) ,, OK PUB-REQ (msgId) Start timer T1 PUB REC-IND (msgId) Stop T1 or handle Excep2 PUB REL-REQ (msgId) Start timer T1 +QMTPUBEX: ,,[,] PUB COMP-IND (msgId) Stop T1 or handle Excep2 发送订阅数据包 服务器收到订阅数据包并返回ACK 发送退订数据包 服务器收到退订数据包并返回ACK 发送发布数据包 发送发布数据包 服务器收到发送数据包并返回ACK 发送发布数据包 服务器收到发布数据包 发送释放发布数据包 服务器收到释放发布数据包 T1是数据包重传超 时时间 T2是保活定时器 在T2时间段内若没 有数据相关消息， 客户端将发送 PINGREQ数据包 Excep1： 断开TCP连接 Excep2： 重发数据包直到 达到允许上限。 可通过命令 AT+QMTCFG设 置重传次数。 通过命令 AT+QMTCFG配置是 否上报超时信息 Receive +QMTRECV: ,,, PUB-IND (msgId) PUB ACK/REC-REQ (msgId) Reply accor.d..ing to AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , DISC-REQ TCP-REQ TCP disconnected 服务器收到发送数据包 发送发布答复数据包 发送断开连接数据包 TCP断开..连. 接请求 注意： 指的是可选参数。更多关于 可选参数的详细信息，请参考第3.2章 AT命令对应的描述。 图 1：MQTT 数据交互机制 上海移远通信技术股份有限公司 8 / 36 LTE Standard(A)系列 MQTT 应用指导 3 MQTT 相关 AT 命令 本章节主要介绍操作 MQTT 功能的相关 AT 命令。 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 36 LTE Standard(A)系列 MQTT 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. MQTT 相关 AT 命令描述 3.3.1. AT+QMTCFG 配置 MQTT 可选参数 该命令用于配置 MQTT 的可选参数。 AT+QMTCFG 配置 MQTT 可选参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'version',( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'pdpcid',( 支 持 的 范 围 ),( 支 持 的 范围) +QMTCFG: 'ssl',( 支 持 的 范 围 ),( 支 持 的 列表),(支持的范围) +QMTCFG: 'keepalive',(支持的范围),(支持的 范围) +QMTCFG: 'session',( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'timeout',( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 列表) +QMTCFG: 'will',( 支 持 的 范 围 ),( 支 持 的 列表),(支持的范围),(支持的 列表),'willtopic','willmessage' +QMTCFG: 'willex',( 支 持 的 范 围 ),( 支 持 的 列表),(支持的范围),(支持的 列表),'willtopic',(支持的范围) +QMTCFG: 'recv/mode',(支持的范围),(支持的 列表),(支持的列表) +QMTCFG: 'aliauth',( 支 持 的 范 围 ),'product key','device name','device secret' +QMTCFG: 'qmtping',( 支 持 的 范 围 ),( 支 持 的 范围) +QMTCFG: 'send/mode',(支持的范围),(支持的 列表) 上海移远通信技术股份有限公司 10 / 36 LTE Standard(A)系列 MQTT 应用指导 +QMTCFG: 'onenet',( 支 持 的 范 围 ),'product id','access key' +QMTCFG: 'hwauth',(支 持 的 范 围 ),'product id','device secret' +QMTCFG: 'hwprodid',(支持的范围),'product id','product secret','nodeid' +QMTCFG: 'dataformat',(支持的范围),(支持的 列表),(支持的列表) +QMTCFG: 'view/mode',(支持的范围),(支持的 列表) +QMTCFG: 'edit/timeout',(支持的范围),(支持 的列表),(支持的范围) +QMTCFG: 'protocol/check',(支持的范围),(支 持的列表) 设置命令 配置 MQTT 协议版本 AT+QMTCFG='version', [,] OK 响应 若省略可选参数，则查询 MQTT 协议版本： +QMTCFG: 'version', OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 协议版本： OK 设置命令 配置 MQTT 客户端待使用的 PDP AT+QMTCFG='pdpcid',[ ,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 MQTT 客户端使用的 PDP： +QMTCFG: 'pdpcid', OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 客户端待使 用的 PDP： OK 设置命令 配置 MQTT SSL 模式和 SSL 上下文索引 AT+QMTCFG='ssl',[,[,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 MQTT SSL 模式以及 SSL 上下 文索引配置情况： +QMTCFG: 'ssl',[,] 上海移远通信技术股份有限公司 11 / 36 LTE Standard(A)系列 MQTT 应用指导 OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT SSL 模式和 SSL 上下文索引： OK 设置命令 配置保活时间 AT+QMTCFG='keepalive',[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前保活时间： +QMTCFG: 'keepalive', OK 若指定可选参数且 MQTT 连接未创建，配置保活时间： OK 设置命令 配置会话类型 AT+QMTCFG='session', [,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前会话类型： +QMTCFG: 'session', OK 若指定可选参数且 MQTT 连接未创建，配置会话类型： OK 若出现任何错误： ERROR 设置命令 配置消息传输超时时间 响应 若省略可选参数，则查询当前设置的消息传输超时时间： AT+QMTCFG='timeout', +QMTCFG: 'timeout',,,<time [,,, out_notice>] OK 若指定可选参数且 MQTT 连接未创建，配置消息传输超时时间： OK 设置命令 配置 Will 信息 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 Will 配置信息： 上海移远通信技术股份有限公司 12 / 36 LTE Standard(A)系列 MQTT 应用指导 AT+QMTCFG='will',[,[,,,,]] +QMTCFG: 'will',[,,,,] OK 若指定可选参数且 MQTT 连接未创建，配置 Will 信息： OK 设置命令 配置 Will 信息 AT+QMTCFG='willex',[, [,,,< willtopic>,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 Will 配置信息： +QMTCFG: 'willex',[,,,< willtopic>,] OK 若指定可选参数，配置 Will 信息： > 输入 Will 消息；若数据长度大于，则发送前面长度 等于的数据。 OK 设置命令 配置服务器数据的接收模式 AT+QMTCFG='recv/mode',[,[,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前 MQTT 数据接收模式： +QMTCFG: 'recv/mode',, OK 若指定可选参数且 MQTT 连接未创建，配置服务器数据的接收 模式： OK 若出现任何错误： 设置命令 ERROR 响应 配置阿里云设备信息 若省略可选参数，则查询设备信息： AT+QMTCFG='aliauth',[ +QMTCFG: 'aliauth',,,<dev ,, name>,] OK 上海移远通信技术股份有限公司 13 / 36 LTE Standard(A)系列 MQTT 应用指导 若指定可选参数且 MQTT 连接未创建，配置阿里云设备信息： OK 设置命令 配置心跳超时上报+QMTCLOSE 最大间 隔时间 AT+QMTCFG='qmtping',[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询心跳超时上报+QMTCLOSE 最大间隔 时间： +QMTCFG: 'qmtping', OK 若指定可选参数且 MQTT 连接未创建，配置心跳超时上报 +QMTCLOSE 最大间隔时间： OK 设置命令 配置 MQTT 消息的发送格式 AT+QMTCFG='send/mode',[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'send/mode', OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 消息的发送 模式： OK 设置命令 配置中国移动 OneNET 平台的设备信息 AT+QMTCFG='onenet',[ ,,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'onenet',, OK 若指定可选参数且 MQTT 连接未创建，配置中国移动 OneNET 平台的设备信息： OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 14 / 36 LTE Standard(A)系列 MQTT 应用指导 设置命令 配置华为 IoT 平台的设备信息 AT+QMTCFG='hwauth', [,,] 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'hwauth',,[,] OK 若指定可选参数且 MQTT 连接未创建，配置华为 IoT 平台的设 备信息： OK 设置命令 配置华为 IoT 平台的设备信息 AT+QMTCFG='hwprodid',[,,,< nodeid>] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'hwprodid',,,< nodeid>[,] OK 若指定可选参数且 MQTT 连接未创建，配置华为 IoT 平台的设 备信息： OK 设置命令 配置 MQTT 数据格式 AT+QMTCFG='dataformat',[,,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'dataformat',, OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 数据格式： OK 设置命令 配置透传模式下 MQTT 数据的回显模式 AT+QMTCFG='view/mode',[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'view/mode', OK 若指定可选参数且 MQTT 连接未创建，配置透传模式下 MQTT 上海移远通信技术股份有限公司 15 / 36 LTE Standard(A)系列 MQTT 应用指导 数据的回显模式： OK 设置命令 配置 MQTT 输入数据超时时间 AT+QMTCFG='edit/timeout',[,,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QMTCFG: 'edit/timeout',[,] OK 若指定可选参数且 MQTT 连接未创建，配置 MQTT 输入数据 超时时间： OK 设置命令 设置 MQTT 协议检查 AT+QMTCFG='protocol/check',[,] 若出现任何错误： ERROR 响应 若省略，则查询当前配置： +QMTCFG: 'protocol/check',, OK 最大响应时间 特性说明 若指定可选参数且 MQTT 连接未创建，配置协议检查功能： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。MQTT 协议版本。 3 MQTT 协议 v3.1 4 MQTT 协议 v3.1.1 整型。MQTT 客户端待使用 PDP。范围：1~15；默认值：1。 整型。配置 Will Flag。 0 无需配置 Will Flag 1 需要配置 Will Flag 上海移远通信技术股份有限公司 16 / 36 LTE Standard(A)系列 MQTT 应用指导 整型。发送消息时的 QoS 级别。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。Will Retain 标记只适用于 PUBLISH 消息。 0 当客户端发布一条 PUBLISH 消息到服务器，消息成功发送到当前订阅 者后，服务器不保留该消息 1 当客户端发布一条 PUBLISH 消息到服务器，消息成功发送到当前订阅 者后，服务器保留该消息 字符串类型。Will topic 名称。长度范围：1~256 字节。 字符串类型。当客户端意外断开后，该参数定义需要发布到 Will Topic 的消 息内容。长度范围：0~256 字节。 整型。Will 消息的长度。范围：0~256。 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。 整型。数据包传输超时后重发次数。范围：0~10；默认值：3。 整型。传输数据包时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器必须存储该客户端的订阅消息 1 服务器必须删除之前保留的客户端任何消息，此连接状态为'Clean' 整型。保活时间。范围：0~3600；默认值：120；单位：秒。该参数定义从 客户端接收消息的最大间隔时间，在 1.5 倍的设置时间内，若服务器未从客 户端收到消息（交互数据和保活包），则默认客户端发送了 DISCONNECT 消息，因此服务器会断开客户端连接。 0 表示不断开客户端连接 整型。配置 MQTT SSL 模式。 0 使用普通 TCP 连接 1 使用 SSL TCP 安全连接 整型。SSL 上下文索引。范围：0~5。 整型。配置 MQTT 消息接收模式。 0 从服务器接收的 MQTT 消息以 URC 的形式上报 1 从服务器接收的 MQTT 消息不以 URC 的形式上报 整型。配置 URC 中是否包含从服务器接收的 MQTT 消息长度。 0 不包含 1 包含 字符串类型。阿里云发布的产品密钥。 字符串类型。阿里云发布的设备名称。 字符串类型。阿里云/华为平台发布的设备校验凭证。 整型。心跳超时上报+QMTCLOSE 最大间隔时间。范围：5~60；默认值： 5；单位：秒。 整型。MQTT 消息发送格式。 0 字符串 上海移远通信技术股份有限公司 17 / 36 LTE Standard(A)系列 MQTT 应用指导 1 十六进制 字符串类型。中国移动 OneNET 平台/华为 IoT 平台发布的产品 ID。 字符串类型。中国移动 OneNET 平台/华为 IoT 平台发布的产品密钥。 整型。设备连接到华为 IoT 平台时，是否使能时间戳检验。 0 禁止 1 使能 字符串类型。华为平台发布的产品校验凭证。 字符串类型。设备标识码，设备标识码唯一标识物理设备。 整型。MQTT 消息接收格式。 0 字符串 1 十六进制 整型。透传模式下 MQTT 数据的回显模式。 0 不回显 1 回显 整型。配置 MQTT 输入数据超时是否退出。 0 禁用 1 使能 整型。MQTT 输入数据超时时间。范围 1~120；单位：秒。 整型。配置 MQTT 协议检查模式。 0 不检查协议 1 检查协议 备注 1. 若 =1 ， 那 么 必 须 指 定 、 、 和 ； 若 不为 1，以上参数会被省略。 2. 只有当服务器支持存储会话信息操作时，=0 才有效。 3. 若 MQTT 连接配置为 SSL 模式，则必须指定。另外，客户需要使用 AT+QSSLCFG 配置 SSL 版本、加密套件、安全等级、CA 证书、客户端证书和客户端密钥，并忽略 RTC 时间，这 些在 MQTT SSL 握手过程中都会使用到（不同模块型号对 SSL 认证功能情况可选，详情请联系移远 通信技术支持）。 4. 请确保数据在传输过程中不能超时。 5. AT+QMTCFG='aliauth'只用于阿里云，若已经配置，则可以省略 AT+QMTCONN 中的 和。 上海移远通信技术股份有限公司 18 / 36 LTE Standard(A)系列 MQTT 应用指导 3.3.2. AT+QMTOPEN 打开 MQTT 客户端网络 该命令用于为 MQTT 客户端打开网络。 AT+QMTOPEN 测试命令 AT+QMTOPEN=? 打开 MQTT 客户端网络 响应 +QMTOPEN: (支持的范围),'hostname',(支持 的范围) 查询命令 AT+QMTOPEN? OK 响应 [+QMTOPEN: ,,] OK 设置命令 AT+QMTOPEN=,, 若出现任何错误： ERROR 响应 OK +QMTOPEN: , 最大响应时间 特性说明 若出现任何错误： ERROR 120 秒，受网络状态影响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 字符串类型。服务器地址，可以是 IP 地址或者域名。最大长度：100 字节。 整型。服务器端口。范围：1~65535。 整型。命令执行结果。 -1 打开网络失败 0 打开网络成功 1 参数错误 2 MQTT 标识符被占用 3 激活 PDP 失败 4 域名解析失败 5 网络断开导致错误 上海移远通信技术股份有限公司 19 / 36 LTE Standard(A)系列 MQTT 应用指导 3.3.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 该命令用于关闭 MQTT 客户端网络。 AT+QMTCLOSE 关闭 MQTT 客户端网络 测试命令 响应 AT+QMTCLOSE=? +QMTCLOSE: (支持的范围) 设置命令 AT+QMTCLOSE= OK 响应 OK +QMTCLOSE: , 最大响应时间 特性说明 若出现任何错误： ERROR 30 秒 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。命令执行结果。 -1 关闭网络失败 0 关闭网络成功 3.3.4. AT+QMTCONN 连接客户端到 MQTT 服务器 客户端请求连接 MQTT 服务器时使用该命令。当客户端创建和服务器之间的 TCP/IP Socket 连接时， 必须使用 CONNECT 流创建一个协议层会话。 AT+QMTCONN 连接客户端到 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: (支持的范围),'clientid','userna me','password' 查询命令 AT+QMTCONN? OK 响应 [+QMTCONN: ,] OK 上海移远通信技术股份有限公司 20 / 36 LTE Standard(A)系列 MQTT 应用指导 设置命令 AT+QMTCONN=,[,,] 若出现任何错误： ERROR 响应 OK +QMTCONN: ,[,] 最大响应时间 特性说明 若出现任何错误： ERROR 值（默认 5 秒），受网络状态影响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 字符串类型。客户端标识符。 字符串类型。客户端用户名，可用于授权。 字符串类型。客户端用户名对应的密码，可用于授权。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 初始化 2 MQTT 正在连接 3 MQTT 已经连接成功 4 MQTT 正在断开连接 整型。连接状态返回码。 0 接受连接 1 拒绝连接：不接受的协议版本 2 拒绝连接：标识符被拒绝 3 拒绝连接：服务器不可用 4 拒绝连接：错误的用户名或密码 5 拒绝连接：未授权 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT +QMTCFG='timeout',[,,,]配置超时时间。 上海移远通信技术股份有限公司 21 / 36 LTE Standard(A)系列 MQTT 应用指导 备注 若某一个客户端 ID 已经连接服务器端，另一个客户端使用相同 ID 重新连接，服务器必须断开原来的客户 端连接，而后才能进行新客户端的 CONNECT 流。 3.3.5. AT+QMTDISC 客户端断开与 MQTT 服务器的连接 当客户端请求断开与 MQTT 服务器的连接时使用该命令。客户端发送 DISCONNECT 消息到服务器表 示即将与服务器断开 TCP/IP 连接。 AT+QMTDISC 客户端断开与 MQTT 服务器的连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的范围) 设置命令 AT+QMTDISC= OK 响应 OK +QMTDISC: , 最大响应时间 特性说明 若出现任何错误： ERROR 30 秒 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。命令执行结果。 -1 断开连接失败 0 断开连接成功 3.3.6. AT+QMTSUB 订阅主题 该命令用于订阅一个或多个主题。客户端发送 SUBSCRIBE 消息向服务器订阅一个或多个主题，当订 阅主题发布消息时，服务器会把这些消息作为 PUBLISH 消息传输到客户端。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: ( 支 持 的 范 围 ),,list of ['topic',qos] 上海移远通信技术股份有限公司 22 / 36 LTE Standard(A)系列 MQTT 应用指导 设置命令 AT+QMTSUB=, ,,[,, …] OK 响应 OK +QMTSUB: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR ×（默认 15 秒），受网络状态影 响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包标识符。范围：1~65535。 字符串类型。客户端订阅或者退订的主题。 整型。客户端发布消息的 QoS 等级。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。 若=0，则作为已确认 QoS 等级的矢量； 若=1，则表示数据包重传次数； 若=2，则不显示。 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTC FG='timeout',[,,,]配置 超时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 备注 只有在固定报头中的 QoS 位显示 QoS 等级是 1 或者 2 的消息中才显示，在特定通信方向中的 一组飞行消息中必须唯一。一般来说该参数值根据消息数逐一增加，但实际情况无此要求。 上海移远通信技术股份有限公司 23 / 36 LTE Standard(A)系列 MQTT 应用指导 3.3.7. AT+QMTUNS 退订主题 该命令用于退订一个或者多个主题。客户端向服务器发送 UNSUBSCRIBE 消息退订确定的主题。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: ( 支 持 的 范 围 ),,list of ['topic'] 设置命令 AT+QMTUNS=, ,[,…] OK 响应 OK +QMTUNS: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR ×（默认 15 秒），受网络状态影 响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包标识符。范围：1~65535。 字符串类型。客户端想要订阅或者退订的主题。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。 若=0，则作为已确认 QoS 等级的矢量； 若=1，则表示数据包重传次数； 若=2，则不显示。 数据包传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTCFG='ti meout',[,,,]配置超 时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 上海移远通信技术股份有限公司 24 / 36 LTE Standard(A)系列 MQTT 应用指导 3.3.8. AT+QMTPUBEX 发布消息 客户端通过该命令可以发布定长消息到服务器，再由服务器分配到感兴趣的订阅者。每一个 PUBLISH 消息都关联一个主题名称，若一个客户端订阅了一个或者多个主题，当订阅主题发布消息时，服务器会把 这些消息作为 PUBLISH 消息传输到客户端。 AT+QMTPUBEX 发布消息 测试命令 AT+QMTPUBEX=? 响应 +QMTPUBEX: (支持的范围),,(支持的 范围),(支持的列表),'topic','length' OK 设置命令 响应 AT+QMTPUBEX=, d>,,,, 响 应 > 后 ， 输 入 需 要 发 送 的 数 据 ， 若 数 据 实 际 长 度 大 于 ，多出来的字节会被删除 OK +QMTPUBEX: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR × （默认 15 秒），受网络状态 影响 / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包消息标识符。范围：0~65535。只有当=0 时，该参数值为 0。 整型。客户端想要发布消息时的 QoS 等级。 0 最多发送一次 1 最少发送一次 2 只发送一次 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 不保存 1 保存 字符串类型。待发布主题。 整型。待发布消息数据长度。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK（当=0 时发布了数据，则无需 ACK） 1 数据包重传 上海移远通信技术股份有限公司 25 / 36 LTE Standard(A)系列 MQTT 应用指导 2 数据包发送失败 整型。 若=1，则表示数据包重传次数； 若=0 或者 2，则不显示此参数。 整型。数据传输超时时间。范围：1~60；默认值：5；单位：秒。可通过 AT+QMTCFG ='timeout',[,,,]配置超 时时间。 整型。数据包传输失败后重试次数。范围：0~10；默认值：3。 备注 1. 若该命令执行成功并响应 OK，客户端可以继续发布新的数据包。传输数据包的最大数量不能大于滑 动窗口的大小（滑动窗口的大小为 5），否则会返回 ERROR。 2. 该命令执行后，客户端可发送数据即负载信息。每次输入数据的最大长度为 1500 字节。 3. 发布者可以发布 PUBLISH 消息到服务器，服务器也可以发布 PUBLISH 消息到订阅者。当服务器发 布 消 息到 订阅 者时 ，会返 回 URC 通知 Host 读 取 MQTT 服务 器发 送的 数 据： +QMTRECV: ,,[,],，关于 URC 描述的详细信息，请参 考第 4.2 章。 3.3.9. AT+QMTRECV 从缓存中读取消息 该命令用于从存储缓存中读取消息，服务器上报消息时都会存储到这个缓存中。 AT+QMTRECV 从缓存中读取消息 测试命令 AT+QMTRECV=? 查询命令 AT+QMTRECV? 响应 OK 响应 +QMTRECV: ,,,,, OK 设置命令 AT+QMTRECV=[,] 若无 MQTT 连接： OK 响应 [+QMTRECV: ,,[,], […]] OK 上海移远通信技术股份有限公司 26 / 36 LTE Standard(A)系列 MQTT 应用指导 最大响应时间 特性说明 若无 MQTT 连接： ERROR / / 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。表示缓存中是否存有消息，缓存中最多可存储 5 条信息，因此最多同时上报 5 条 URC。 0 缓存中没有数据 1 缓存中有数据 整型。表示每条接收数据的序号。范围：0~4。 整型。数据包消息标识符。范围：0~65535，只有当=0 时，此参数可为 0。 字符串类型。待发布的主题。 整型。负载信息的长度。 字符串类型。主题名相关的负载信息。 上海移远通信技术股份有限公司 27 / 36 LTE Standard(A)系列 MQTT 应用指导 4 MQTT 相关 URC 本章节主要描述 MQTT 相关的 URC。 表 3：MQTT 相关的 URC 序号 URC 格式 描述 [1] +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 连接并上报 URC。 +QMTRECV: ,,[,], 上报 URC。 [3] +QMTRECV: , 当从 MQTT 服务器接收的消息存储到缓存 时上报 URC。 [4] +QMTPING: , 当 MQTT 链层状态变化时，客户端会关闭 MQTT 连接并上报此 URC。 4.1. +QMTSTAT MQTT 链路层状态变化的 URC 此 URC 以+QMTSTAT:开头，当 MQTT 链路层状态发生变化就会上报该 URC。 +QMTSTAT MQTT 链路层状态变化的 URC +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 连接并上报 URC。 参数 整型。MQTT 客户端标识符。范围：0~5。 错误代码。详细信息请参考下表。 上海移远通信技术股份有限公司 28 / 36 LTE Standard(A)系列 MQTT 应用指导 表 4：URC 中的错误码 描述 解决方法 1 连接被服务器断开或者重置 执行 AT+QMTOPEN 重建 MQTT 连接。 2 发送 PINGREQ 包超时或者失败 首先反激活 PDP，然后再激活 PDP 并重建 MQTT 连接。 3 发送 CONNECT 包超时或者失败 1. 查看输入的用户名和密码是否正确。 2. 确保客户端 ID 未被占用。 3. 重 建 MQTT 连接 ， 并 尝试 再 次 发 送 CONNECT 包到服务器。 1. 查看输入的用户名和密码是否正确。 4 接收 CONNACK 包超时或者失败 2. 确保客户端 ID 未被占用。 3. 重 建 MQTT 连接 ， 并 尝试 再 次 发 送 CONNECT 包到服务器。 5 客户端向服务器发送 DISCONNECT 包，但 正常流程。 是服务器主动断开 MQTT 连接 因为发送数据包总是失败，客户端主动断开 1. 确保数据正确。 6 MQTT 连接 2. 可能因为网络拥堵或者其他错误，尝试 重建 MQTT 连接。 7 链路不工作或者服务器不可用 确保当前链路或者服务器可用。 8 客户端主动断开 MQTT 连接 尝试重建连接。 9~255 留作将来使用 4.2. +QMTRECV 通知 Host 读取 MQTT 数据包的 URC 此 URC 以+QMTRECV:开头，主要用于通知 Host 读取 MQTT 服务器发送的数据包。 +QMTRECV 通知 Host 读取 MQTT 数据包的 URC +QMTRECV: ,,[,], +QMTRECV: ,[,] 上海移远通信技术股份有限公司 29 / 36 参数 LTE Standard(A)系列 MQTT 应用指导 整型。MQTT 客户端标识符。范围：0~5。 整型。数据包的消息标识符。 字符串类型。从 MQTT 服务器接收的主题。 整型。负载信息的长度。 字符串类型。主题名称相关的负载。 整型。表示每条接收数据的序号。范围：0~4。 4.3. +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC 此 URC 以+QMTPING:开头，若服务器未在 1.5 倍保活时间内接收到客户端的消息，则相当于客户端 发送了 DISCONNECT 消息，服务器会断开与客户端的连接，此时会上报该 URC。 +QMTPING 通知 MQTT 保活时间内 Ping 状态的 URC +QMTPING: , 当 MQTT 链层状态变化时，客户端会关闭 MQTT 连接并上报 此 URC。 参数 整型。MQTT 客户端标识符。范围：0~5。 整型。Ping 状态的结果。 1 失败 上海移远通信技术股份有限公司 30 / 36 LTE Standard(A)系列 MQTT 应用指导 5 举例 本章节主要提供举例用于解释如何使用 MQTT 相关命令。 5.1. 无 SSL 的 MQTT 操作举例 //配置接收模式。 AT+QMTCFG='recv/mode',0,0,1 OK //配置阿里云设备信息。 AT+QMTCFG='aliauth',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAazZ' OK AT+QMTOPEN=? +QMTOPEN: (0-5),'hostname',(1-65535) OK //MQTT 客户端打开网络。 AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK +QMTOPEN: 0,0 AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 //MQTT 客户端成功打开网络。 OK AT+QMTCONN=? +QMTCONN: (0-5),'clientid','username','password' OK //客户端连接 MQTT 服务器。 //若已连接阿里云，可使用 AT+QMTCFG='aliauth'提前配置设备信息，之后可省略和 。 AT+QMTCONN=0,'clientExample' OK 上海移远通信技术股份有限公司 31 / 36 LTE Standard(A)系列 MQTT 应用指导 +QMTCONN: 0,0,0 AT+QMTSUB=? +QMTSUB: (0-5),,list of ['topic',qos] //客户端成功连接到 MQTT 服务器。 OK //订阅主题。 AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //如果客户端订阅某个主题，而其他设备将同一主题发布到服务器，模块会上报如下信息： +QMTRECV: 0,0,'topic/example',36,'This is the payload related to topic' //退订主题。 AT+QMTUNS=0,2,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUBEX=? +QMTPUBEX: (0-5),,(0-2),(0,1),'topic','length' OK //响应>后，输入并发送 This is test data, hello MQTT.，数据最大长度是 1500 字节，多出的部分会被忽略。 AT+QMTPUBEX=0,0,0,0,'topic/pub',30 >This is test data, hello MQTT. OK +QMTPUBEX: 0,0,0 //若客户端订阅了名为'topic/pub'的主题，且其他设备向服务器发布了相同主题，模块会上报如下信息： +QMTRECV: 0,0,'topic/pub',30,This is test data, hello MQTT. //断开客户端在 MQTT 服务器的连接。 AT+QMTDISC=0 OK +QMTDISC: 0,0 //连接断开成功。 上海移远通信技术股份有限公司 32 / 36 LTE Standard(A)系列 MQTT 应用指导 5.2. 含 SSL 的 MQTT 操作举例 有关 SSL 相关的命令详情请参考文档 [1]和[2]。 //配置接收模式。 AT+QMTCFG='recv/mode',0,0,1 OK //配置 MQTT 会话为 SSL 模式。 AT+QMTCFG='SSL',0,1,2 OK //若 SSL 授权方式为 server authentication，则存储 CA 证书到 UFS。 AT+QFUPL='UFS:cacert.pem',1758,100 CONNECT +QFUPL: 1758,384a OK //若 SSL 授权方式为 server authentication，则存储 CC 证书到 UFS。 AT+QFUPL='UFS:client.pem',1220,100 CONNECT +QFUPL: 1220,2d53 OK //若 SSL 授权方式为 server authentication，则存储 CK 证书到 UFS。 AT+QFUPL='UFS:user_key.pem',1679,100 CONNECT +QFUPL: 1679,335f OK //配置 CA 证书。 AT+QSSLCFG='cacert',2,'UFS:cacert.pem' OK //配置 CC 证书。 AT+QSSLCFG='clientcert',2,'UFS:client.pem' OK 上海移远通信技术股份有限公司 33 / 36 LTE Standard(A)系列 MQTT 应用指导 //配置 CK 证书。 AT+QSSLCFG='clientkey',2,'UFS:user_key.pem' OK //配置 SSL 参数。 AT+QSSLCFG='seclevel',2,2 OK AT+QSSLCFG='sslversion',2,4 OK AT+QSSLCFG='ciphersuite',2,0xFFFF OK AT+QSSLCFG='ignorelocaltime',2,1 OK //SSL 授权方式：server authentication。 //SSL 授权版本。 //加密套件。 //忽略授权时间。 //开始 MQTT SSL 连接。 AT+QMTOPEN=0,'a1zgnxur10j8ux.iot.us-east-1.amazonaws.com',8883 OK +QMTOPEN: 0,0 //连接 MQTT 服务器。 AT+QMTCONN=0,'M26_0206' OK +QMTCONN: 0,0,0 //订阅主题。 AT+QMTSUB=0,1,'$aws/things/M26_0206/shadow/update/accepted',1 OK +QMTSUB: 0,1,0,1 //发布消息。 AT+QMTPUBEX=0,1,1,0,'$aws/things/M26_0206/shadow/update/accepted',32 >This is publish data from client OK +QMTPUBEX: 0,1,0 //若客户端订阅了名为'$aws/things/M26_0206/shadow/update/accepted'的主题，且其他设备发布了相同 主题的消息到服务器，模块会上报如下信息： +QMTRECV: 0,1,'$aws/things/M26_0206/shadow/update/accepted',32,'This is publish data from client' 上海移远通信技术股份有限公司 34 / 36 LTE Standard(A)系列 MQTT 应用指导 //客户端断开 MQTT 服务器。 AT+QMTDISC=0 OK +QMTDISC: 0,0 备注 不同模块型号对 SSL 认证功能情况可选，详情请联系移远通信技术支持。 上海移远通信技术股份有限公司 35 / 36 LTE Standard(A)系列 MQTT 应用指导 6 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_SSL_应用指导 [2] Quectel_LTE_EG950A 系列_SSL_应用指导 表 6：术语缩写 缩写 ACK CA IP MQTT PDP QoS RTC SSL TCP UFS URC 英文全称 Acknowledgement Certificate Authority Internet Protocol Message Queuing Telemetry Transport Packet Data Protocol Quality of Service Real-Time Clock Secure Sockets Layer Transmission Control Protocol User File System Unsolicited Result Code 中文全称 确认消息 证书授权中心 网际互连协议 消息队列遥测传输 分组数据协议 服务质量 实时时钟 安全套接层 传输控制协议 用户文件系统 非请求结果码 上海移远通信技术股份有限公司 36 / 36

EC200x&EC600N 系列 UAC 应用指导 LTE Standard 模块系列 版本：1.1 日期：2023-10-19 状态：受控文件 EC200x&EC600N 系列 UAC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 19 EC200x&EC600N 系列 UAC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 19 EC200x&EC600N 系列 UAC 应用指导 文档历史 修订记录 版本 1.0 日期 2022-03-30 2022-04-24 作者 August YANG August YANG 1.1 2023-10-19 Amos YAO 变更表述 文档创建 受控版本 1. 更新 EC200N-CN 为 EC200N 系列。 2. 新增如下 AT 命令： ⚫ AT+QAUDCFG='uactxsamp'（第 2.5 章） ⚫ AT+QAUDCFG='uacrxsamp'（第 2.6 章） 上海移远通信技术股份有限公司 3 / 19 EC200x&EC600N 系列 UAC 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 2 AT 命令详解 ........................................................................................................................................... 8 2.1. AT 命令说明................................................................................................................................. 8 2.1.1. 定义 .................................................................................................................................. 8 2.1.2. AT 命令语句...................................................................................................................... 8 2.2. AT 示例声明................................................................................................................................. 9 2.3. AT+QAUDCFG='uacmode' 启用/禁用 UAC 功能 .................................................................... 9 2.4. AT+QAUDCFG='uactype' 设置 UAC 功能模式 ..................................................................... 10 2.5. AT+QAUDCFG='uactxsamp' 设置 UAC TX 采样率 .............................................................. 11 2.6. AT+QAUDCFG='uacrxsamp' 设置 UAC RX 采样率.............................................................. 12 3 UAC 功能测试 ...................................................................................................................................... 14 3.1. Windows 侧 UAC 功能测试 ....................................................................................................... 14 3.2. Linux 侧 UAC 功能测试 ............................................................................................................. 15 4 附录 参考文档及术语缩写 ................................................................................................................... 19 上海移远通信技术股份有限公司 4 / 19 EC200x&EC600N 系列 UAC 应用指导 表格索引 表 1：AT 命令及响应类型............................................................................................................................. 8 表 2：参考文档 ........................................................................................................................................... 19 表 3：术语缩写 ........................................................................................................................................... 19 上海移远通信技术股份有限公司 5 / 19 EC200x&EC600N 系列 UAC 应用指导 图片索引 图 1：设备管理器 ....................................................................................................................................... 14 图 2：音频输入和输出 ................................................................................................................................ 14 图 3：重启 UAC 链路流程 .......................................................................................................................... 15 图 4：声音设备 ........................................................................................................................................... 16 图 5：切换声音设备.................................................................................................................................... 17 上海移远通信技术股份有限公司 6 / 19 EC200x&EC600N 系列 UAC 应用指导 1 引言 本文档介绍如何使用移远通信 LTE Standard EC200A 系列、EC200N 系列和 EC600N-CN 模块的 UAC 功能。 UAC（USB Audio Class）是 USB 规范中的音频协议类。在 UAC 模式下，模块被识别为主机设备中的 USB 声卡，并且'UAC 接口'设备出现在主机设备管理器中。标准的第三方音频库（如 alsa-lib）可用于 在 Linux 设备（主机设备）上运行音频应用程序，某些第三方工具也可用于在 Windows 设备上播放/记录应 用程序。 备注 EC200x 系列和 EC600N-CN 模块的 UAC 功能可选，请咨询移远通信技术支持获取当前使用的模块型号 是否支持 UAC。 上海移远通信技术股份有限公司 7 / 19 EC200x&EC600N 系列 UAC 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 1：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 19 EC200x&EC600N 系列 UAC 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QAUDCFG='uacmode' 启用/禁用 UAC 功能 该命令用于启用或禁用 UAC 功能。 AT+QAUDCFG='uacmode' 启用/禁用 UAC 功能 测试命令 AT+QAUDCFG=? 响应 … +QAUDCFG: 'uacmode',(支持的列表) … 设置命令 AT+QAUDCFG='uacmode'[,] OK 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'uacmode', OK 若指定可选参数，则启用或禁用 UAC 功能： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存。 参数 整型。启用/禁用 UAC 功能。 0 禁用 1 启用 错误码。 上海移远通信技术股份有限公司 9 / 19 902 音频参数无效 EC200x&EC600N 系列 UAC 应用指导 备注 发送设置命令启用或禁用 UAC 功能后，查询当前配置会返回当前设置的值，但该命令在模块重启后方可 生效。 2.4. AT+QAUDCFG='uactype' 设置 UAC 功能模式 该命令用于设置 UAC 功能模式。 AT+QAUDCFG='uactype' 设置 UAC 功能模式 测试命令 AT+QAUDCFG=? 响应 … +QAUDCFG: 'uactype',(支持的范围) … 设置命令 AT+QAUDCFG='uactype'[,] OK 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'uactype', OK 若指定可选参数，则设置 UAC 功能模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启或重启 UAC 链路后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 10 / 19 EC200x&EC600N 系列 UAC 应用指导 参数 整型。UAC 功能模式。 0 近端模式（模块本地同上位机进行 UAC 通信） 1 远端模式（通话中对端同上位机进行 UAC 通信） 2 近/远端模式（暂仅 EC200N 系列和 EC600N-CN 支持） 错误码。 902 音频参数无效 备注 重启 UAC 链路的方法为：断开上位机与模块的 UAC 连接并重新连接以重新初始化 UAC 功能。 2.5. AT+QAUDCFG='uactxsamp' 设置 UAC TX 采样率 该命令用于设置 UAC TX 采样率。 AT+QAUDCFG='uactxsamp' 设置 UAC TX 采样率 测试命令 AT+QAUDCFG=? 响应 … +QAUDCFG: 'uactxsamp',(支持的列表) … 设置命令 AT+QAUDCFG='uactxsamp'[,] OK 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'uactxsamp', OK 若指定可选参数，则设置 UAC TX 采样率： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 11 / 19 参数 整型。UAC TX 的采样率。单位：Hz。 8000 UAC TX 采样率为 8000 Hz 16000 UAC TX 采样率为 16000 Hz EC200x&EC600N 系列 UAC 应用指导 备注 1. 设置命令中配置完成后，查询当前配置会返回当前设置的值，但该命令在模块重启后方可 生效。 2. 当前仅 EC200A 系列模块支持该命令。 2.6. AT+QAUDCFG='uacrxsamp' 设置 UAC RX 采样率 该命令用于设置 UAC RX 采样率。 AT+QAUDCFG='uacrxsamp' 设置 UAC RX 采样率 测试命令 AT+QAUDCFG=? 响应 … +QAUDCFG: 'uacrxsamp',(支持的列表) … 设置命令 AT+QAUDCFG='uacrxsamp'[,] OK 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'uacrxsamp', OK 若指定该参数，则设置 UAC RX 采样率： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 12 / 19 参数 UAC RX 的采样率。单位：Hz。 8000 UAC RX 采样率为 8000 Hz 16000 UAC RX 采样率为 16000 Hz EC200x&EC600N 系列 UAC 应用指导 备注 1. 设置命令中配置完成后，查询当前配置会返回当前设置的值，但该命令在模块重启后方可 生效。 2. 当前仅 EC200A 系列模块支持该命令。 上海移远通信技术股份有限公司 13 / 19 EC200x&EC600N 系列 UAC 应用指导 3 UAC 功能测试 本章节主要介绍 UAC 功能的测试步骤。 3.1. Windows 侧 UAC 功能测试 步骤1： 给未启用 UAC 功能的模块上电，打开上位机（以 PC 为例）的设备管理器，查看'音频输入 和输出'选项，可以查看到仅有 PC 自带的音频设备。 图 1：设备管理器 步骤2： 执 行 AT+QAUDCFG='uacmode',1 以 启 用 UAC 功 能 ， 设 置 后 执 行 AT+QAUDCFG='uacmode'查询设置结果，返回+QAUDCFG: 'uacmode',1 后重启模块。 步骤3： 模块重启后，再次查看 PC 的设备管理器中的'音频输入和输出'选项，可以看到新增一组音 频输入与输出设备（即 UAC 设备），如下图所示，即成功启用 UAC 功能。 图 2：音频输入和输出 步骤4： 修改 PC 端默认使用的音频设备为新增的这组 UAC 设备。选中后，在 PC 端播放音频，若 设置为 0（近端模式），则模块端可以播放出 PC 上播放的音频；若设置为 1 （远端模式），则 PC 端播放的音频会被传输到同模块正在进行通话的对端播放（如未在 通话中，则无法播放）；录音同理。 上海移远通信技术股份有限公司 14 / 19 EC200x&EC600N 系列 UAC 应用指导 步骤5： 若 在 步 骤 4 设 置 UAC 为 近 端 模 式 ， 需 执 行 AT+QAUDCFG='uactype',1 后 再 执 行 AT+QAUDCFG='uactype'确认切换为远端模式。设置成功后需要在 PC 端切换一次输出设 备，即切换 UAC 设备为其他设备（此处以 PC 音频设备为例），之后再次更新为 UAC 设备， 即可完成重启 UAC 链路，使该命令生效（或者在切换为远端模式后重启模块使命令生效）， 操作如下图所示： 图 3：重启 UAC 链路流程 步骤6： 经过上述操作后，使用模块同其他设备进行通话，则 PC 端播放的音频会被传输到同模块正在 进行通话的对端播放；录音同理。 3.2. Linux 侧 UAC 功能测试 步骤1： 给 模 块 上 电 ， 执 行 AT+QAUDCFG='uacmode',1 启 用 UAC 功 能 。 以 下 步 骤 以 使 用 AT+QAUDCFG='uactype',1 设置 UAC 功能模式为远端模式为例（设置为近端模式的步骤与 设置为远端模式相同）。 步骤2： 执行 aplay 播放一个 WAV 音频文件，确认 PC 端正常播放该 WAV 文件（即 PC 端的扬 声器有声）。若不能正常播放，后续步骤将无法进行。 步骤3： 确认 Ubuntu 的声音设备中，是否出现带'Andriod'字样的设备。测试模块的 UAC 功能时， 将'Output Device'和'Input Device'都选为'Analog xxx-Android'，即 UAC 设备。 上海移远通信技术股份有限公司 15 / 19 EC200x&EC600N 系列 UAC 应用指导 图 4：声音设备 步骤4： 执行 aplay -l 或 arecord -l 查看模块的 UAC 设备信息。 上海移远通信技术股份有限公司 16 / 19 EC200x&EC600N 系列 UAC 应用指导 步骤 5：执行 aplay 或者 arecord 后，执行 ATD 发起呼叫，测试 UAC 功能。有关 ATD 的详细信息， 请参考文档 [1]。 若执行 aplay 时出现'audio open error'的提示，需要切换 Ubuntu 的声音设备设置，将'Output Device'和'Input Device'都选为'Built-in Audio'，不要使用 UAC 设备。 图 5：切换声音设备 执行 aplay 和 arecord，确认返回正确后，再执行 ATD 发起呼叫，如下图所示。 通话的对端即可以听到 PC 端播放的 WAV 文件的声音，PC 端录制通话的对端传过来的声音存为 3.wav 文件。在本地设备播放 3.wav 文件，确认音频内容是否正确（是否与通话的对端的音频一致）。 上海移远通信技术股份有限公司 17 / 19 EC200x&EC600N 系列 UAC 应用指导 上海移远通信技术股份有限公司 18 / 19 EC200x&EC600N 系列 UAC 应用指导 4 附录 参考文档及术语缩写 表 2：参考文档 文档名称 [1] Quectel_LTE_Standard(A)系列_AT 命令手册 表 3：术语缩写 缩写 DSP PC PCM RX TA TX UAC USB 英文全称 Digital Signal Processing Personal Computer Pulse Code Modulation Receive Terminal Adapter Transmit USB Audio Class Universal Serial Bus 中文全称 数字信号处理技术 个人计算机 脉冲编码调制 接收 终端适配器 发送 USB 音频类 通用串行总线 上海移远通信技术股份有限公司 19 / 19

EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 LTE-A 模块系列 版本：1.0 日期：2023-10-16 状态：受控文件 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提供 给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通信 有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 文档历史 修订记录 版本 1.0 日期 作者 2021-12-15 Kevin LI 2023-10-16 Kevin LI 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................ 7 定义 ................................................................................................................................. 7 AT 命令语句..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................ 8 2.3. RF FTM AT 命令详解 ................................................................................................................. 8 AT+QRFTEST FTM 模式下强收强发测试 .................................................................... 8 强收测试 CMW500 配置................................................................................................ 13 示例 ..................................................................................................................................................... 14 附录 术语缩写..................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 7 表 3：LTE/WCDMA 频段 RX/TX 信道分布................................................................................................. 10 表 4：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 引言 移远通信 LTE-A 模块系列支持强发和强收功能。本文档主要介绍相关 AT 命令，以及如何在 FTM（工 厂测试模式）下测试该功能，以便进行射频校准。 1.1. 适用模块 表 1：适用模块 模块系列 EM12xR - 模块 EM120R-GL EM121R-GL EM160R-GL EG512R-EA 上海移远通信技术股份有限公司 6 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 AT 命令详解 2.1. AT 命令说明 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中变现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 AT+QRFTEST FTM 模式下射频测试 AT+QRFTEST FTM 模式下射频测试 测试命令 响应 AT+QRFTEST=? +QRFTEST: 'rx',,,,,, +QRFTEST: 'tx',,,,,, +QRFTEST: 'mode',(支持的列表) 设置命令 查询/设置 FTM 模式 AT+QRFTEST='mode'[,] OK 响应 若省略可选参数，则查询当前配置： +QRFTEST: OK 若指定可选参数，则设置 FTM 模式： OK 设置命令 FTM 模式下强收测试 AT+QRFTEST='rx',,, ,,, 设置命令 FTM 模式下强发测试 AT+QRFTEST='tx',,, ,,,<tx_p 若有任何错误： ERROR 响应 +QRFTEST: 'rx',, OK 若有任何错误： ERROR 响应 OK 或者 ERROR 上海移远通信技术股份有限公司 8 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 ower> 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。射频测试模式。 0 Online 模式 1 FTM 模式 整型。LTE/WCDMA 配置。 0 WCDMA 1 LTE 整型。LTE/WCDMA 频段。 1 LTE B1/WCDMA B1 2 LTE B2/WCDMA B2 3 LTE B3/WCDMA B3 4 LTE B4/WCDMA B4 5 LTE B5/WCDMA B5 6 LTE B6/WCDMA B6 7 LTE B7/WCDMA B7 8 LTE B8/WCDMA B8 9 LTE B9/WCDMA B9 10 LTE B10/WCDMA B10 11 LTE B11/WCDMA B11 ...... 19 LTE B19/WCDMA B19 20 LTE B20 28 LTE B28 ...... 整型。LTE/WCDMA 带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 6 40 MHz 整型。RX/TX 信道。详情请参考表 3。 整型。接收天线索引。 0 PRX 1 DRX 整型。期望接收到的 RX AGC 的值。该值需设置为仪表端发送的信号强度（dBm） 上海移远通信技术股份有限公司 9 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 x 10，若仪表端设置的发送信号强度值为-60 dBm，则该参数设置为-600。 整型。RX AGC 的测试值。单位：dBm。 整型。测试增益，该值为/10。单位：dBm。 整型。使能/禁用 TX。 0 禁用 1 使能 整型。收发器输出增益。该参数值与实际强发功率呈正相关。最大值为 100。 表 3：LTE/WCDMA 频段 RX/TX 信道分布 LTE/WCDMA 频段 LTE B1 RX 信道范围 最小值~中间值~最大值 0~300~599 LTE B2 600~900~1199 LTE B3 1200~1575~1949 LTE B4 1950~2175~2399 LTE B5 2400~2525~2649 LTE B6 2650~2700~2749 LTE B7 2750~3100~3449 LTE B8 3450~3625~3799 LTE B9 3800~3975~4149 LTE B10 4150~4450~4749 LTE B11 4750~4850~4949 LTE B12 5000~5095~5179 LTE B13 5180~5230~5279 LTE B14 5280~5330~5379 LTE B17 5730~5790~5849 LTE B18 5850~5925~5999 LTE B19 6000~6075~6149 LTE B20 6150~6300~6449 TX 信道范围 最小值~中间值~最大值 18000~18300~18599 18600~18900~19199 19200~19575~19949 19950~20175~20339 20400~20525~20649 20650~20700~20749 20750~21100~21449 21450~21625~21799 21800~21975~22149 22150~22450~22749 22750~22850~22949 23000~23095~23179 23180~23230~23279 23280~23330~23379 23730~23790~23849 23850~23925~23999 24000~24075~24149 24150~24300~24449 上海移远通信技术股份有限公司 10 / 15 LTE B21 LTE B22 LTE B23 LTE B24 LTE B25 LTE B26 LTE B27 LTE B28 LTE B29 LTE B30 LTE B31 LTE B32 LTE B33 LTE B34 LTE B35 LTE B36 LTE B37 LTE B38 LTE B39 LTE B40 LTE B41 LTE B42 LTE B43 LTE B46 LTE B47 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 6450~6525~6599 6600~7000~7399 7500~7600~7699 7700~7870~8039 8040~8365~8689 8690~8865~9039 9040~9125~9209 9210~9435~9659 9660~9715~9769 9770~9820~9869 9870~9895~9919 9920~10140~10359 36000~36100~36199 36200~36275~36349 36350~36650~36949 36950~37250~37549 37550~37650~37749 37750~38000~38249 38250~38450~38649 38650~39150~39649 39650~40620~41589 41590~42590~43589 43590~44590~45589 46790~50665~54539 54540~54885~55239 24450~24525~24599 24600~25000~25399 25500~25600~25699 25700~25870~26039 26040~26365~26689 26690~26865~27039 27040~27125~27209 27210~27435~27659 NA 27660~27710~27759 27760~27785~27809 NA 36000~36100~36199 36200~36275~36349 36350~36650~36949 36950~37250~37549 37550~37650~37749 37750~38000~38249 38250~38450~38649 38650~39150~39649 39650~40620~41589 41590~42590~43589 43590~44590~45589 46790~50665~54539 54540~54885~55239 上海移远通信技术股份有限公司 11 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 LTE B48 LTE B66 LTE B71 WCDMA B1 WCDMA B2 WCDMA B3 WCDMA B4 WCDMA B5 WCDMA B6 WCDMA B7 WCDMA B8 WCDMA B9 WCDMA B10 WCDMA B11 WCDMA B19 55240~55940~56739 66436~66886~67335 68586~68761~68935 10562~10700~10838 9662~9800~9938 1162~1338~1513 1537~1638~1738 4357~4408~4458 4387~4400~4413 2237~2400~2563 2937~3012~3088 9237~9312~9387 3112~3250~3388 3712~3762~3812 712~738~763 55240~55940~56739 131972~132322~132671 133122~133297~133471 9612~9750~9888 9262~9400~9538 937~1112~1288 1312~1412~1513 4132~4182~4233 4162~4175~4188 2012~2175~2338 2712~2788~2863 8762~8837~8912 2887~3025~3163 3487~3537~3587 312~338~363 备注 1. 每进行一种网络制式（LTE/WCDMA）的 RF 测试后，需要执行 AT+QRFTEST='mode',0 退出 FTM 模式并手动重启模块，才能进行下一种网络模式的 RF 测试。 2. FTM 模式下的 RF 测试为非信令测试，测试期间禁止插入 SIM 卡。 上海移远通信技术股份有限公司 12 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 强收测试 CMW500 配置 发出连续波的信号源可用作下行 CW 信号。若将 CMW500 用作信号源，需作如下配置： 线损补偿 接收信号频偏500 kHz 设置接收信号的功率 将信号模式设置为连续波（CW） 图 1: CMW500 配置 上海移远通信技术股份有限公司 13 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 示例 AT+QRFTEST=? +QRFTEST: 'rx',,,,,, +QRFTEST: 'tx',,,,,, +QRFTEST: 'mode',(0,1) OK //FTM 模式下 WCDMA 射频测试 AT+QRFTEST='mode',1 OK AT+QRFTEST='rx',0,1,2,10700,0,-600 +QRFTEST: 'rx',-1011,-101 OK AT+QRFTEST='rx',0,1,2,10700,1,-600 +QRFTEST: 'rx',-997,99 OK AT+QRFTEST='mode',0 OK //手动重启模块 //FTM 模式下 LTE 射频测试 AT+QRFTEST='mode',1 OK AT+QRFTEST='rx',1,1,3,300,0,-600 +QRFTEST: 'rx',-867,-86 OK AT+QRFTEST='rx',1,1,3,300,1,-600 +QRFTEST: 'rx',-946,-94 OK AT+QRFTEST='tx',1,1,3,18300,1,50 OK AT+QRFTEST='mode',0 OK 上海移远通信技术股份有限公司 14 / 15 EG512R&EM12xR&EM160R 系列 RF FTM 应用指导 附录 术语缩写 表 4：术语缩写 缩写 AGC CW DRX FTM LTE PRX RF RX TX WCDMA 英文全称 Automatic Gain Control Continuous Wave Discontinuous Reception Factory Test Mode Long Term Evolution Primary Receive Radio Frequency Receive Transmit Wideband Code Division Multiple Access 中文全称 自动增益控制 连续波 不连续接收 工厂测试模式 长期演进 主集接收 射频 接收 发射 宽带码分多址移动通信系统 上海移远通信技术股份有限公司 15 / 15

EM12&EG12&EG18 系列 RF FTM 应用指导 LTE-A 模块系列 版本：1.0 日期：2023-10-12 状态：受控文件 EM12&EG12&EG18 系列 RF FTM 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 文档历史 修订记录 版本 1.0 日期 作者 2023-07-10 Kevin LI 2023-10-12 Kevin LI 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 RF FTM AT 命令详解............................................................................................................................ 7 2.1. AT 命令说明................................................................................................................................ 7 定义 ................................................................................................................................. 7 AT 命令语句..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................ 8 2.3. AT 命令详解................................................................................................................................ 8 AT+QRFTEST FTM 模式下 LTE 强收强发测试 ............................................................ 8 示例 ..................................................................................................................................................... 13 附录 术语缩写..................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：LTE 频段 RX/TX 信道分布................................................................................................................ 10 表 3：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 1 引言 移远通信 LTE-A 模块系列支持强发和强收功能。本文档主要介绍相关 AT 命令，以及如何在 FTM（工 厂测试模式）下测试该功能，以便进行射频校准。 适用模块如下： ⚫ EM12-G ⚫ EG12 系列 ⚫ EG18 系列 上海移远通信技术股份有限公司 6 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 2 RF FTM AT 命令详解 2.1. AT 命令说明 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中变现命令和响应的表格中，省略了，仅 显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 AT+QRFTEST FTM 模式下 LTE 强收强发测试 AT+QRFTEST FTM 模式下 LTE 强收强发测试 测试命令 响应 AT+QRFTEST=? +QRFTEST: 'rx',,,,, +QRFTEST: 'tx',,,,,,,, +QRFTEST: 'mode',(支持的列表) 设置命令 查询/设置 FTM 模式 AT+QRFTEST='mode'[,] OK 响应 若省略可选参数，则查询当前配置： +QRFTEST: OK 若指定可选参数，则设置 FTM 模式： OK 设置命令 FTM 模式下强收测试 AT+QRFTEST='rx',,,< channel>,, 若有任何错误： ERROR 响应 +QRFTEST: ,,,, OK 设置命令 FTM 模式下强发测试 若有任何错误： ERROR 响应 OK 上海移远通信技术股份有限公司 8 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 AT+QRFTEST='tx',,,< channel>,,[, ,,] 或者 ERROR 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。射频测试模式。 0 Online 模式 1 FTM 模式 整型。LTE 频段。 1 LTE B1 2 LTE B2 … … 42 LTE B42 43 LTE B43 44 LTE B44 48 LTE B48 66 LTE B66 71 LTE B71 整型。LTE 带宽。 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz 6 40 MHz 整型。RX/TX 信道。详情请参考表 2。 整型。接收天线索引。 0 PRX 1 DRX 2 RX2 3 RX3 整型。期望接收到的 RX AGC 的值。该值需设置为仪表端发送的信号强度（dBm） x 10，若仪表端设置的发送信号强度值为-60 dBm，则该参数设置为-600。 整型。RX AGC 的测试值。单位：dBm。 整型。LNA 增益状态。范围 0~7。 整型。预估的灵敏度。单位：dBm。 上海移远通信技术股份有限公司 9 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 整型。载波噪声比。该值为载波噪声比（db）× 10。 整型。峰值频率。单位：Hz。 整型。使能/禁用 TX。 0 禁用 1 使能 整型。强发功率。单位：dBm × 10。 整型。LTE RB 的起始位置。最小值为 0；最大值比 LTE 频段支持的 RB 数少 1。 整型。LTE RB 的数量。最小值为 1；最大值为 LTE 频段分配的 RB 数与 的差值。 整型。TX 波形。 0 QPSK 1 16 QAM 2 64 QAM 3 256 QAM 表 2：LTE 频段 RX/TX 信道分布 LTE 频段 LTE B1 RX 信道 最小值~中间值~最大值 0~300~599 LTE B2 600~900~1199 LTE B3 1200~1575~1949 LTE B4 1950~2175~2399 LTE B5 2400~2525~2649 LTE B6 2650~2700~2749 LTE B7 2750~3100~3449 LTE B8 3450~3625~3799 LTE B9 3800~3975~4149 LTE B10 4150~4450~4749 LTE B11 4750~4850~4949 LTE B12 5000~5095~5179 LTE B13 5180~5230~5279 LTE B14 5280~5330~5379 TX 信道 最小值~中间值~最大值 18000~18300~18599 18600~18900~19199 19200~19575~19949 19950~20175~20339 20400~20525~20649 20650~20700~20749 20750~21100~21449 21450~21625~21799 21800~21975~22149 22150~22450~22749 22750~22850~22949 23000~23095~23179 23180~23230~23279 23280~23330~23379 上海移远通信技术股份有限公司 10 / 15 LTE B17 LTE B18 LTE B19 LTE B20 LTE B21 LTE B22 LTE B23 LTE B24 LTE B25 LTE B26 LTE B27 LTE B28 LTE B30 LTE B31 LTE B33 LTE B34 LTE B35 LTE B36 LTE B37 LTE B38 LTE B39 LTE B40 LTE B41 LTE B42 LTE B43 5730~5790~5849 5850~5925~5999 6000~6075~6149 6150~6300~6449 6450~6525~6599 6600~7000~7399 7500~7600~7699 7700~7870~8039 8040~8365~8689 8690~8865~9039 9040~9125~9209 9210~9435~9659 9770~9820~9869 9870~9895~9919 36000~36100~36199 36200~36275~36349 36350~36650~36949 36950~37250~37549 37550~37650~37749 37750~38000~38249 38250~38450~38649 38650~39150~39649 39650~40620~41589 41590~42590~43589 43590~44590~45589 上海移远通信技术股份有限公司 EM12&EG12&EG18 系列 RF FTM 应用指导 23730~23790~23849 23850~23925~23999 24000~24075~24149 24150~24300~24449 24450~24525~24599 24600~25000~25399 25500~25600~25699 25700~25870~26039 26040~26365~26689 26690~26865~27039 27040~27125~27209 27210~27435~27659 27660~27710~27759 27760~27785~27809 36000~36100~36199 36200~36275~36349 36350~36650~36949 36950~37250~37549 37550~37650~37749 37750~38000~38249 38250~38450~38649 38650~39150~39649 39650~40620~41589 41590~42590~43589 43590~44590~45589 11 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 LTE B48 LTE B66 LTE B71 55240~55940~56739 66436~66886~67335 68586~68761~68935 55240~55940~56739 131972~132322~132671 133122~133297~133471 备注 1. 进行 RX/TX 测试前，需先执行 AT+QRFTEST='mode',1 使模块进入 FTM 模式；测试完成后，需 要执行 AT+QRFTEST='mode',0 使模块退出 FTM 模式；所有 RX/TX 测试结束后需手动重启模 块。 2. FTM 模式下的 RF 测试为非信令测试，测试期间禁止插入 SIM 卡。 3. 若需要进行多频段或多通道的 RX/TX 测试，建议 RX 和 TX 分开测试，并在切换 RX 和 TX 测试前 手动重启模块。 4. 对于某频段/信道的 TX 测试，在设置为 1 使能 TX 功能并测试强发功率之后，需要先 设置为 0 关闭该频段/信道的 TX 功能，再进行其它测试。 上海移远通信技术股份有限公司 12 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 3 示例 AT+QRFTEST=? +QRFTEST: 'rx',,,,, +QRFTEST: 'tx',,,,,,,, +QRFTEST: 'mode',(0,1) OK AT+QRFTEST='mode',1 OK AT+QRFTEST='mode' +QRFTEST: 1 OK AT+QRFTEST='rx',3,3,1575,0,-600 +QRFTEST: -60.5,1,-46.57,-14.42,859708 OK AT+QRFTEST='tx',3,3,19575,1,150 OK AT+QRFTEST='tx',3,3,19575,0,150 OK AT+QRFTEST='rx',42,3,42590,0,-50 +QRFTEST: -61.7,7,-73.83,-12.16,5469340 OK AT+QRFTEST='tx',42,3,42590,1,150 OK //推荐测试流程： //进入 FTM 模式 AT+QRFTEST='mode',1 OK //测试所有需要的 TX 频段（请注意在测试下一个频段之前需要禁用当前频段）： AT+QRFTEST='tx',2,3,18900,1,150 OK AT+QRFTEST='tx',2,3,18900,0,150 上海移远通信技术股份有限公司 13 / 15 OK AT+QRFTEST='tx',5,3,20525,1,150 OK AT+QRFTEST='tx',5,3,20525,0,150 OK …… //退出 FTM 模式 AT+QRFTEST='mode',0 OK //手动重启模块 //进入 FTM 模式 AT+QRFTEST='mode',1 OK //测试所有需要的 RX 频段 AT+QRFTEST='rx',2,3,900,0,-600 +QRFTEST: -59.9,1,-98.38,37.38,2002144 OK AT+QRFTEST='rx',5,3,2525,0,-600 +QRFTEST: -62.2,1,-44.85,-16.14,1701260 OK …… //退出 FTM 模式 AT+QRFTEST='mode',0 OK //手动重启模块以进行下一步 EM12&EG12&EG18 系列 RF FTM 应用指导 上海移远通信技术股份有限公司 14 / 15 EM12&EG12&EG18 系列 RF FTM 应用指导 4 附录 术语缩写 表 3：术语缩写 缩写 AGC DRX FTM LNA LTE PRX QAM QPSK RB RF RX TX 英文全称 Automatic Gain Control Discontinuous Reception Factory Test Mode Low Noise Amplifier Long Term Evolution Primary Receive Quadrature Amplitude Modulation Quadrature Phase Shift Keying Resource Block Radio Frequency Receive Transmit 中文全称 自动增益控制 不连续接收 工厂测试模式 低噪声放大器 长期演进 主集接收 正交调幅 正交移相键控 资源块 射频 接收 发射 上海移远通信技术股份有限公司 15 / 15

ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 LTE Standard 模块系列 版本：1.1 日期：2024-04-12 状态：受控文件 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2023-07-21 2023-10-11 2024-04-12 作者 Sum LI Sum LI Kevin WANG 变更表述 文档创建 受控版本 1. 新增适用模块 EG915G-EU。 2. 删除 AT+QWTTS 命令。 上海移远通信技术股份有限公司 3 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块..................................................................................................................................... 6 2 AT 命令详解 ........................................................................................................................................... 7 2.1. AT 命令说明 ............................................................................................................................... 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句 ..................................................................................................................... 7 2.2. AT 示例声明 ............................................................................................................................... 8 2.3. AT 命令详解 ............................................................................................................................... 8 2.3.1. AT+QAUDSW 切换编解码器......................................................................................... 8 2.3.2. AT+CLVL 扬声器音量等级选择...................................................................................... 9 2.3.3. AT+QAUDPLAY 播放本地音频文件至近端 ................................................................. 10 2.3.4. AT+QAUDPLAYEX 播放本地音频文件至近端 ............................................................ 11 2.3.5. AT+QAUDSTOP 停止播放媒体文件............................................................................ 12 2.3.6. AT+QAUDCFG='extpa' PA 引脚配置 ......................................................................... 12 2.3.7. AT+QTTS 播放文本..................................................................................................... 13 2.3.8. AT+QTTSETUP 配置 TTS 参数 .................................................................................. 15 3 错误码 .................................................................................................................................................. 17 4 附录 参考文档及术语缩写 ................................................................................................................... 18 上海移远通信技术股份有限公司 4 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 7 表 3：+CME ERROR: ...................................................................................................................... 17 表 4：参考文档 ........................................................................................................................................... 18 表 5：术语缩写 ........................................................................................................................................... 18 上海移远通信技术股份有限公司 5 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 1 引言 本文档主要介绍移远通信 ECx00G 系列、EGx00G 系列和 EG915G-EU 模块支持的 PWM 音频相关的 AT 命令集。 1.1. 适用模块 表 1：适用模块 模块系列 ECx00G EGx00G - 模块 EC200G-CN EC600G 系列 EC800G-CN EG700G-CN EG800G 系列 EG915G-EU 备注 以上模块的 PWM 音频和 TTS 功能可选，请咨询移远通信技术支持以了解当前使用的模块型号是否支持 PWM 音频和 TTS 功能。 上海移远通信技术股份有限公司 6 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QAUDSW 切换编解码器 该命令用于切换内置编解码器、外部编解码器或 PWM 软件解码器。 AT+QAUDSW 切换编解码器 测试命令 AT+QAUDSW=? 响应 +QAUDSW: (支持的范围) 查询命令 AT+QAUDSW? OK 响应 +QAUDSW: 设置命令 AT+QAUDSW= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。 0 外部编解码器 1 内置编解码器 2 PWM 软件解码器 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 8 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 备注 默认值取决于模块实际支持的编码器类型，若模块支持内置编解码器，默认值为 1；若模块不支 持内置编解码器但支持外置编解码器，默认值为 0；若模块仅支持 PWM 软件解码器，默认值为 2。如需了解模块实际支持的解码器类型，请联系移远通信技术支持。 2.3.2. AT+CLVL 扬声器音量等级选择 该命令用于选择 MT 内部扬声器的音量等级。音量等级范围：0~5。 AT+CLVL 扬声器音量等级选择 测试命令 AT+CLVL=? 响应 +CLVL: (支持的范围) 查询命令 AT+CLVL? OK 响应 +CLVL: 设置命令 AT+CLVL= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 参考 3GPP TS 27.007 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。出厂特定范围的音量级别（最小值代表最低的音量级别）。范围：0~5；默认值：3。 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 9 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 2.3.3. AT+QAUDPLAY 播放本地音频文件至近端 该命令用于播放一个本地音频文件至近端。文件格式支持 WAV、PCM 和 MP3，不支持 AMR 和 AWB。 AT+QAUDPLAY 播放本地音频文件至近端 测试命令 AT+QAUDPLAY=? 响应 +QAUDPLAY: ,(支持的列表) 查询命令 AT+QAUDPLAY? OK 响应 +QAUDPLAY: 设置命令 AT+QAUDPLAY=, OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放结束后： +QAUDPLAY: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。模块状态。 0 模块未在播放音频 1 模块播放音频中 字符串类型。播放的音频文件的名称，包括文件路径、文件名和文件后缀。具体文件路 径请参考文档 [1]中支持的文件路径。 整型。是否重复播放。 0 仅播放一次 1 重复播放 错误码。详情请参考第 3 章。 上海移远通信技术股份有限公司 10 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 备注 1. 若发生未知错误，模块将上报 URC +QAUDPIND: 0,1。 2. 若当前播放被其他音频任务中断，模块将上报 URC +QAUDPIND: 0,6。 2.3.4. AT+QAUDPLAYEX 播放本地音频文件至近端 该命令用于播放一个或多个本地音频文件至近端。文件格式支持 WAV、PCM 和 MP3，不支持 AMR 和 AWB。 AT+QAUDPLAYEX 播放本地音频文件至近端 测试命令 AT+QAUDPLAYEX=? 响应 +QAUDPLAYEX: (支持的列表),[,,...] 查询命令 AT+QAUDPLAYEX? OK 响应 +QAUDPLAYEX: 设置命令 AT+QAUDPLAYEX=[,,...] OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 特性说明 播放结束后： +QAUDPLAY: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。模块状态。 0 模块未在播放音频 1 模块播放音频中 整型。控制操作。 0 停止播放 1 开始播放 上海移远通信技术股份有限公司 11 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 字符串类型。播放的音频文件的名称，包括文件路径、文件名和文件后缀。具体文件路 径请参考文档 [1]中支持的文件路径。 错误码。详情请参考第 3 章。 备注 1. 若发生未知错误，模块将上报 URC +QAUDPIND: 0,1。 2. 若当前播放被其他音频任务中断，模块将上报 URC +QAUDPIND: 0,6。 2.3.5. AT+QAUDSTOP 停止播放媒体文件 该命令用于停止播放媒体文件。 AT+QAUDSTOP 停止播放媒体文件 测试命令 AT+QAUDSTOP=? 执行命令 AT+QAUDSTOP 响应 OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 错误码。详情请参考第 3 章。 2.3.6. AT+QAUDCFG='extpa' PA 引脚配置 该命令用于配置模块的 PA 引脚。 AT+QAUDCFG='extpa' 测试命令 AT+QAUDCFG=? PA 引脚配置 响应 +QAUDCFG: 'extpa',(支持的列表),,(支持的 列表) OK 上海移远通信技术股份有限公司 12 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 设置命令 AT+QAUDCFG='extpa'[,,,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'extpa',,, OK 若指定可选参数，则配置 PA 引脚： OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: / 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用模块在播放时使用 PA 引脚。 0 禁用 1 启用 整型。模块的引脚号。选择的引脚需要支持配置成 GPIO 功能，否则会报错。 整型。PA 引脚有效时的电平。 0 低电平 1 高电平 错误码。详情请参考第 3 章。 2.3.7. AT+QTTS 播放文本 该命令用于播放文本。 AT+QTTS 播放文本 测试命令 AT+QTTS=? 查询命令 AT+QTTS? 设置命令 AT+QTTS=[,] 响应 +QTTS: (支持的范围), OK 响应 +QTTS: OK 响应 OK 或者 上海移远通信技术股份有限公司 13 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 最大响应时间 特性说明 ERROR 若错误与 ME 功能相关： +CME ERROR: 文本播放完成时： +QTTS: 0 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。开始或停止播放并指定格式。范围：0~2。 0 停止播放，可省略 1 开始播放，使用 UCS2 编码 2 开始播放，是字符型，通常是 ASCII 字符，中文使用 GBK 编码 字符串类型。待播放文本。文本格式取决于。最大长度：548 字节。 整型。TTS 播放器状态。 0 空闲 1 繁忙 错误码。详情请参考第 3 章。 备注 1. 模块支持在无通话状态下执行 AT+QTTS 播放文本。 2. 通话时文本播放会被中断。 3. 模块支持文本和音频播放，但不支持同时播放。 举例 AT+QTTS=? +QTTS: (0-2), //测试命令。 OK AT+QTTS=1,'6B228FCE4F7F752879FB8FDC6A215757'//播放 UCS2 字符串文本。 OK +QTTS: 0 AT+QTTS=2,'hello world,你好' OK //播放 ASCII 字符串文本。 上海移远通信技术股份有限公司 14 / 18 +QTTS: 0 AT+QTTS=0 OK ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 //停止播放。 2.3.8. AT+QTTSETUP 配置 TTS 参数 该命令用于设置 TTS 速度或调节音量。 AT+QTTSETUP 配置 TTS 参数 测试命令 AT+QTTSETUP=? 响应 +QTTSETUP: (支持的列表),(支持的列表),(支持 的范围) 查询命令 AT+QTTSETUP? 设置命令 AT+QTTSETUP=,[,] OK 响应 OK 响应 若=1，则指定可选参数： OK 或者 ERROR 若=2，则省略可选参数： +QTTSETUP: 2,, OK 或 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。设置命令或查询命令。 1 设置命令 2 查询命令 整型。速度或音量。 1 速度 2 音量 上海移远通信技术股份有限公司 15 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 整型。速度或音量值。 如=2，设置命令中省略，表示查询当前速度或音量。 速度 范围：-32768~32767；正常速度：0；默认值：0。 音量 范围：-32768~32767；默认值：0。 错误码。详情请参考第 3 章。 举例 AT+QTTSETUP=? +QTTSETUP: (1,2),(1,2),(-32768-32767) OK AT+QTTSETUP=1,2,0 OK //测试命令。 //设置音量为 0。 上海移远通信技术股份有限公司 16 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 3 错误码 表 3：+CME ERROR: 错误码 901 902 903 904 905 919 920 英文含义 Unknown audio error Invalid audio parameters Unsupported audio operation Audio device busy Audio file does not exist Audio initialization incomplete Audio file error 中文含义 未知音频错误 音频无效参数 音频操作不支持 音频设备忙 音频文件不存在 音频功能未初始化完毕 音频文件错误 上海移远通信技术股份有限公司 17 / 18 ECx00G&EGx00G&EG915G 系列 PWM 音频应用指导 4 附录 参考文档及术语缩写 表 4：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_FILE_应用指导 表 5：术语缩写 缩写 ASCII GBK IIC ME MIC MSC MT PA PCM PWM TA TTS UFS URC 英文全称 中文全称 American Standard Code for Information Interchange 美国信息交换标准码 Chinese Internal Code Specification 汉字内码扩展规范 Inter-Integrated Circuit 集成电路总线 Mobile Equipment 移动设备 Microphone 麦克风 Mobile Switching Center 移动交换中心 Mobile Termination 移动终端 Power Amplifier 功率放大器 Pulse Code Modulation 脉冲编码调制 Pulse Width Modulation 脉冲宽度调制 Terminal Adapter 终端适配器 Text To Speech 从文本到语音 User File System 用户文件系统 Unsolicited Result Code 非请求结果码 上海移远通信技术股份有限公司 18 / 18

LC29H (AA,BS)&LC79H (AL) EASY&EPOC 差异说明 GNSS 模块系列 版本：1.0 日期：2023-09-22 状态：受控文件 M10_ATC Confidential / Released 1 / 10 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 关于文档 文档信息 标题 副标题 文档类型 文档状态 LC29H (AA,BS)&LC79H (AL) EASY&EPOC 差异说明 GNSS 模块系列 差异说明 受控文件 修订历史 版本 1.0 日期 2023-05-24 2023-09-22 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 目录 关于文档 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................4 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 引言.....................................................................................................................................................7 1.1. EASY 概述................................................................................................................................7 1.2. EPOC 概述 ...............................................................................................................................8 2 差异...................................................................................................................................................10 3 消息...................................................................................................................................................11 3.1. EASY 相关消息....................................................................................................................... 11 3.1.1. PAIR490: PAIR_EASY_ENABLE ................................................................................. 11 3.1.2. PAIR491: PAIR_EASY_GET_STATUS ........................................................................12 3.2. EPOC 相关消息 ......................................................................................................................13 3.2.1. PAIR496: PAIR_EPOC_ENABLE ................................................................................13 3.2.2. PAIR498: PAIR_EPOC_SET_CONFIG........................................................................14 3.2.3. PAIR507: PAIR_EPOC_CLEAR_DATA........................................................................14 3.2.4. PAIR508: PAIR_EPOC_GET_STATUS........................................................................15 3.2.5. PAIR509: PAIR_EPOC_GET_PREDICTION_STATUS ...............................................16 3.3. EASY&EPOC 相关消息 ..........................................................................................................17 3.3.1. PAIR511: PAIR_NVRAM_SAVE_NAVIGATION_DATA ................................................17 3.3.2. PAIR512: PAIR_NVRAM_CLEAR_NAVIGATION_DATA .............................................18 3.3.3. PAIR513: PAIR_NVRAM_SAVE_SETTING .................................................................19 4 应用...................................................................................................................................................21 4.1. EASY 应用..............................................................................................................................21 4.2. EPOC 应用 .............................................................................................................................22 5 附录 A 参考文档及术语缩写 .............................................................................................................25 6 附录 B 特殊符号 ...............................................................................................................................26 上海移远通信技术股份有限公司 4 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 表格索引 表 1：适用模块.......................................................................................................................................... 7 表 2：EASY 与 EPOC 功能差异 .............................................................................................................. 10 表 3：EASY 与 EPOC 消息差异 .............................................................................................................. 10 表 4：参考文档........................................................................................................................................ 25 表 5：术语缩写........................................................................................................................................ 25 表 6：特殊符号........................................................................................................................................ 26 上海移远通信技术股份有限公司 5 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 图片索引 图 1：EASY 运行机制 ............................................................................................................................... 8 图 2：EPOC 运行机制............................................................................................................................... 9 图 3：EASY 推荐流程 ............................................................................................................................. 21 图 4：EPOC 推荐流程............................................................................................................................. 23 上海移远通信技术股份有限公司 6 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 1 引言 移远通信 LC29H (AA, BS)和 LC79H (AL)模块支持 EASY（Embedded Assist System，嵌入式辅助系 统）或 EPOC（Enhanced Prediction Orbit on Chip，增强型芯片预测轨道）功能，可显著提高模块的 TTFF。 由于技术更新，EASY 功能已升级为 EPOC 功能，模块的后续固件版本将不再支持 EASY 功能。 本文档主要介绍 LC29H (AA, BS)和 LC79H (AL)模块 EASY 和 EPOC 功能的差异，以及 EASY 与 EPOC 功能的应用方法。支持的模块型号如下： 表 1：适用模块 模块系列 型号 LC29H LC29H (AA) LC29H (BS) LC79H LC79H (AL) 适用模块的其他软件版本 软件版本 LC29HAANR11A01S 及此前版本 LC29HBSNR11A01S 及此前版本 LC79HALNR11A01S 及此前版本 功能 EASY EPOC 1.1. EASY 概述 EASY 技术用于提升模块的 TTFF 性能。作为模块的内置功能，EASY 根据接收到的星历数据进行卫星 轨道预测。因此，模块无需外部网络连接。当模块接收到新的广播星历时，EASY 功能将自动激活，对未来 3 天的卫星轨道进行预测。当完成所有可用卫星的 3 天轨道预测后，EASY 功能将转为待机状态。 EASY 仅支持 GPS。下图展示了如何激活 EASY 功能，以及模块如何在空闲时间（即未处理其他内部 任务时）利用 EASY 进行卫星轨道预测。当模块无法连接网络、不能通过服务器获取预测数据时，EASY 辅 助数据可用于替代 EPO（Extended Prediction Orbit，扩展预测轨道）辅助数据。 上海移远通信技术股份有限公司 7 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 模块处理时间 第一天 TTFF 第二天，第三天， GPS + EASY GPS + EASY + EASY 辅助数据 GPS + GPS + EASY + EASY EASY + EASY 辅助数据 辅助数据 GPS + EASY + EASY 辅助数据 TTFF 30秒 5秒 利用空闲时间计 接收到新的星 算卫星轨道数据 历数据，重新 开始预测 利用空闲时间预 测卫星轨道数据 接收到新的星 历数据，重新 开始预测 图 1：EASY 运行机制 1.2. EPOC 概述 EPOC 也是模块的内置功能，其利用接收到的广播星历预测 GNSS 卫星轨道，从而提高 TTFF 性能。 当因外部网络无法连接而导致 EPO 辅助数据丢失时，EPOC 辅助数据可用作另一种 AGNSS 技术来加速 TTFF。 EPOC 的运行机制如下图所示。第 1 天，在无 EPOC 辅助数据的情况下，TTFF 大约为 30 秒。一旦接 收到广播星历数据，EPOC 自动启动对当前可用卫星未来 3 天的轨道预测。在随后的 72 小时内，EPOC 加 速 TTFF 并确保精确定位。完成基于所有可用广播星历的轨道预测后，EPOC 转为待机状态，直到模块获 取新的广播星历数据。 EPOC 支持三种星系配置：仅 GPS、GPS + Galileo 和 GPS + BDS（MEO 和 IGSO）。在每种配置 中，模块可以接收和处理来自多达 40 颗卫星的数据。如果启用 EPOC 功能时未打开相应的星系，则不会预 测该星系的卫星轨道。 上海移远通信技术股份有限公司 8 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 模块处理时间 第一天 TTFF 第二天，第三天， GPS + EPOC GPS + EPOC + EPOC 辅助数据 GPS + EPOC + EPOC 辅助数据 GPS + EPOC + EPOC 辅助数据 GPS + EPOC + EPOC 辅助数据 TTFF 30秒 5秒 利用空闲时间计 接收到新的星 算卫星轨道数据 历数据，重新 开始预测 利用空闲时间预 测卫星轨道数据 接收到新的星 历数据，重新 开始预测 图 2：EPOC 运行机制 上海移远通信技术股份有限公司 9 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 2 差异 EPOC 和 EASY 均可用于预测未来 3 天的卫星轨道。二者的主要区别为： ⚫ EASY 仅支持 GPS，而 EPOC 支持 GPS、Galileo 和 BDS； ⚫ EASY 支持将 1、2 或 3 天的预测数据存储到 RTC RAM，而 EPOC 仅支持存储 3 天的预测数据； ⚫ EPOC 使用的命令/消息多于 EASY。 表 2：EASY 与 EPOC 功能差异 功能 自动存储到 RTC RAM 的预测数据天数 支持的星系配置 EASY 1、2 或 3 天 GPS EPOC 3天 GPS GPS + Galileo GPS + BDS（MEO 和 IGSO） 表 3：EASY 与 EPOC 消息差异 功能 启用或禁用 EASY/EPOC 配置星系 清除 NVM 中的数据 查询 EASY/EPOC 功能状态 查询预测状态 将当前导航数据从 RTC RAM 保存到 NVM 清除 RTC RAM 和 NVM 中的导航数据 将当前配置从 RTC RAM 保存到 NVM EASY $PAIR490 $PAIR491 $PAIR491 $PAIR511 $PAIR512 $PAIR513 EPOC $PAIR496 $PAIR498 $PAIR507 $PAIR508 $PAIR509 $PAIR511 $PAIR512 $PAIR513 上海移远通信技术股份有限公司 10 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 3 消息 本章介绍 EASY/EPOC 相关的 PAIR 消息（由芯片供应商定义的专有 NMEA 消息）。 PAIR 消息格式： $PAIR[,] ：每个 PAIR 消息的标识符，为 000 到 999 的三字节字符串。 ：该字段可以省略，也可通过数据字段分隔符','分隔多个字段。不同的命令对应不同的数据。详 情如下。 3.1. EASY 相关消息 3.1.1. PAIR490: PAIR_EASY_ENABLE 启用或禁用 EASY 功能。 类型： 设置 格式： $PAIR490,* 参数： 字段 格式 十进制 单位 - 描述 EASY 功能设置。 0 = 禁用 1 = 启用 结果： 返回$PAIR001 消息。有关$PAIR001 的详细信息，请参考文档 [1]或 [2] 协议规范。 上海移远通信技术股份有限公司 11 / 26 示例： $PAIR490,1*2A $PAIR001,490,0*36 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 3.1.2. PAIR491: PAIR_EASY_GET_STATUS 查询 EASY 功能状态和预测状态（即 EASY 数据扩展状态）。 类型： 查询 格式： $PAIR491* 参数： 无 结果： 返回$PAIR001 消息和查询结果。有关$PAIR001 的详细信息，请参考文档 [1]或 [2] 协议规范。 查询结果消息格式： $PAIR491,,* 结果中包含的参数： 字段 格式 单位 十进制 - 十进制 - 描述 EASY 功能设置。 0 = 禁用 1 = 启用 EASY 数据扩展状态。 0 = 未完成 1 = 完成 1 天扩展 2 = 完成 2 天扩展 3 = 完成 3 天扩展 上海移远通信技术股份有限公司 12 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 示例： $PAIR491*36 $PAIR001,491,0*37 $PAIR491,1,0*37 备注 若 EASY 功能被禁用，则执行此命令后将只返回的值。 3.2. EPOC 相关消息 3.2.1. PAIR496: PAIR_EPOC_ENABLE 用或禁用 EPOC 功能。 类型： 设置 格式： $PAIR496,* 参数： 字段 格式 十进制 单位 - 描述 EPOC 功能设置。 0 = 禁用 1 = 启用 结果： 返回$PAIR001 消息。有关$PAIR001 的详细信息，请参考文档 [1]或[2] 协议规范。 示例： $PAIR496,1*2C $PAIR001,496,0*30 上海移远通信技术股份有限公司 13 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 3.2.2. PAIR498: PAIR_EPOC_SET_CONFIG 配置 EPOC 星系。 类型： 设置 格式： $PAIR498,* 参数： 字段 格式 十进制 单位 - 描述 EPOC 星系配置。默认配置：GPS。 Bit 0 = GPS Bit 1 = Galileo Bit 2 = BDS 结果： 返回$PAIR001 消息。有关$PAIR001 的详细信息，请参考文档 [1]或[2] 协议规范。 示例： $PAIR498,1*22 $PAIR001,498,0*3E 备注 用十进制值表示。支持的星系组合为仅 GPS、GPS + Galileo 和 GPS + BDS。 3.2.3. PAIR507: PAIR_EPOC_CLEAR_DATA 清除 NVM 中的所有 EPOC 数据。 类型： 命令 上海移远通信技术股份有限公司 14 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 格式： $PAIR507* 参数： 无 结果： 返回$PAIR001 消息。有关$PAIR001 的详细信息，请参考文档 [1]或[2] 协议规范。 示例： $PAIR507*38 $PAIR001,507,0*39 3.2.4. PAIR508: PAIR_EPOC_GET_STATUS 查询 EPOC 功能状态和星系配置。 类型： 查询 格式： $PAIR508* 参数： 无 结果： 返回$PAIR001 消息和查询结果。有关$PAIR001 的详细信息，请参考文档 [1]或[2] 协议规范。 查询结果消息格式： $PAIR508,,* 上海移远通信技术股份有限公司 15 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 结果中包含的参数： 字段 格式 单位 十进制 - 十进制 - 描述 EPOC 功能设置。 0 = 禁用 1 = 启用 EPOC 星系配置。 Bit 0 = GPS Bit 1 = Galileo Bit 2 = BDS 示例： $PAIR508*37 $PAIR001,508,0*36 $PAIR508,1,1*37 3.2.5. PAIR509: PAIR_EPOC_GET_PREDICTION_STATUS 查询 EPOC 预测状态。 类型： 查询 格式： $PAIR509,* 参数： 字段 格式 十进制 单位 - 描述 EPOC 星系配置。 Bit 0 = GPS Bit 1 = Galileo Bit 2 = BDS 结果： 返回$PAIR001 消息和查询结果。有关$PAIR001 的详细信息，请参考文档 [1]或[2] 协议规范。 上海移远通信技术股份有限公司 16 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 查询结果消息格式： $PAIR509,,,* 结果中包含的参数： 字段 格式 单位 十进制 - 十进制 - 十六进制 - 描述 预测状态。 1 = 正在进行预测 2 = 所有接收的星历数据都已用于预测 3 = 无有效星历数据 EPOC 星系配置。 Bit 0 = GPS Bit 1 = Galileo Bit 2 = BDS 可用卫星掩码。位编号代表卫星 ID，指定位为'1'时 表示对应卫星的轨道预测已完成。 示例： $PAIR509,1*2B $PAIR001,509,0*37 $PAIR509,2,1,00000000000D2D2C*6A 备注 ：卫星编号采用位格式。例如，00000000000D2D2C 表示卫星 3、4、6、9、11、12、 14、17、19 和 20 已经完成了 3 天的轨道预测。 3.3. EASY&EPOC 相关消息 3.3.1. PAIR511: PAIR_NVRAM_SAVE_NAVIGATION_DATA 将当前导航数据从 RTC RAM 保存到 NVM。 类型： 命令 上海移远通信技术股份有限公司 17 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 格式： $PAIR511* 参数： 无 结果： 返回$PAIR001 消息。有关$PAIR001 的详细信息，请参考文档 [1]或[2] 协议规范。 示例： //如果定位频率为 1 Hz $PAIR511*3F $PAIR001,511,0*3E //如果定位频率大于 1 Hz $PAIR382,1*2E $PAIR001,382,0*32 $PAIR003*39 $PAIR001,003,0*38 $PAIR511*3F $PAIR001,511,0*3E $PAIR002*38 $PAIR001,002,0*39 备注 1. 如果模块断电后备份域无法通电，则每次修改参数后都需要发送$PAIR511 命令。 2. 当定位频率大于 1 Hz 时，依次发送$PAIR382,1*2E 和$PAIR003*39 关闭 GNSS 系统电源后，方可 发送该命令。发送$PAIR511*3F 后，通过$PAIR002*38 重新给模块供电。定位频率低于 1 Hz 时无 此限制。 3.3.2. PAIR512: PAIR_NVRAM_CLEAR_NAVIGATION_DATA 清除 RTC RAM 和 NVM 中的导航数据。 类型： 命令 上海移远通信技术股份有限公司 18 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 格式： $PAIR512* 参数： 无 结果： 返回$PAIR001 消息。有关$PAIR001 的详细信息，请参考文档 [1]或[2] 协议规范。 示例： $PAIR512*3C $PAIR001,512,0*3D 3.3.3. PAIR513: PAIR_NVRAM_SAVE_SETTING 将当前配置从 RTC RAM 保存到 NVM。 类型： 命令 格式： $PAIR513* 参数： 无 结果： 返回$PAIR001 消息。有关$PAIR001 的详细信息，请参考文档 [1]或[2] 协议规范。 示例： //如果定位频率为 1 Hz $PAIR513*3D $PAIR001,513,0*3C //如果定位频率大于 1 Hz 上海移远通信技术股份有限公司 19 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 $PAIR382,1*2E $PAIR001,382,0*32 $PAIR003*39 $PAIR001,003,0*38 $PAIR513*3D $PAIR001,513,0*3C $PAIR002*38 $PAIR001,002,0*39 备注 1. 如果模块断电后备份域无法通电，则每次修改参数后都需要发送$PAIR511 命令。 2. 当定位频率大于 1 Hz 时，依次发送$PAIR382,1*2E 和$PAIR003*39 关闭 GNSS 系统电源后，方可 发送该命令。发送$PAIR513*3D 后，通过$PAIR002*38 重新给模块供电。定位频率低于 1 Hz 时无 此限制。 上海移远通信技术股份有限公司 20 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 4 应用 EASY 和 EPOC 功能的使用步骤相似，详情如下。 4.1. EASY 应用 EASY 的推荐使用流程如下图所示： 开始 使用EASY功能？ 是 启用EASY 否 禁用EASY 查询EASY状态 否 查询EASY状态 否 否 启用EASY成功？ 是 禁用EASY成功？ 预测完成？ 是 结束 是 图 3：EASY 推荐流程 上海移远通信技术股份有限公司 21 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 示例： 1. 启用 EASY 功能 //启用 EASY： $PAIR490,1*2A $PAIR001,490,0*36 //查询 EASY 状态： $PAIR491*36 $PAIR001,491,0*37 $PAIR491,1,0*37 2. 禁用 EASY 功能 //禁用 EASY： $PAIR490,0*2B $PAIR001,490,0*36 //查询 EASY 状态： $PAIR491*36 $PAIR001,491,0*37 $PAIR491,0,0*36 备注 EASY 默认启用，因此'启用 EASY'为可选步骤。 4.2. EPOC 应用 EPOC 的推荐使用流程如下图所示： 上海移远通信技术股份有限公司 22 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 开始 使用EPOC功能？ 是 配置星系？ 否 是 配置星系 否 查询EPOC星 系配置 否 配置成功？ 是 启用EPOC 否 查询EPOC状态 禁用EPOC 查询EPOC状态 否 启用EPOC成功？ 是 查询EPOC预 测状态 否 预测完成？ 是 结束 禁用EPOC成功？ 是 图 4：EPOC 推荐流程 上海移远通信技术股份有限公司 23 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 示例： 1. 启用 EPOC 功能 //配置 EPOC 星系： $PAIR498,1*22 $PAIR001,498,0*3E //查询 EPOC 星系配置： $PAIR508*37 $PAIR001,508,0*36 $PAIR508,0,1*36 //启用 EPOC： $PAIR496,1*2C $PAIR001,496,0*30 //查询 EPOC 状态： $PAIR508*37 $PAIR001,508,0*36 $PAIR508,1,1*37 //查询 EPOC 预测状态： $PAIR509,1*2B $PAIR001,509,0*37 $PAIR509,2,1,00000000000D2D2C*6A 2. 禁用 EPOC 功能 //禁用 EPOC： $PAIR496,0*2D $PAIR001,496,0*30 //查询 EPOC 状态： $PAIR508*37 $PAIR001,508,0*36 $PAIR508,0,1*36 备注 EPOC 默认启用，因此'启用 EPOC'为可选步骤。 上海移远通信技术股份有限公司 24 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 5 附录 A 参考文档及术语缩写 表 4：参考文档 文档名称 [1] Quectel_LC29H(BS)_GNSS_协议规范 [2] Quectel_LC29H 系列&LC79H(AL)_GNSS_协议规范 表 5：术语缩写 缩写 EASY EPO EPOC GNSS IGSO MEO NVM TTFF 英文全称 Embedded Assist System Extended Prediction Orbit Enhanced Prediction Orbit on Chip Global Navigation Satellite System Inclined Geosynchronous Orbit Medium Earth Orbit Non-Volatile Memory Time to First Fix 中文全称 嵌入式辅助系统 扩展预测轨道 增强型芯片预测轨道 全球导航卫星系统 倾斜地球同步轨道 中地球轨道 非易失性存储器 首次定位时间 上海移远通信技术股份有限公司 25 / 26 LC29H(AA,BS)&LC79H(AL) EASY&EPOC 差异说明 6 附录 B 特殊符号 表 6：特殊符号 特殊符号 […] {…} 下划线 描述 回车符 换行符 参数名称（实际命令行中不包含尖括号） 可选参数（实际命令行中不包含中括号） 循环参数（实际命令行中不包含大括号） 参数的默认设置 上海移远通信技术股份有限公司 26 / 26

LTE Standard(U)系列 SSL 应用指导 LTE Standard 模块系列 版本：1.3 日期：2023-09-15 状态：受控文件 LTE Standard(U)系列 SSL 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 36 LTE Standard(U)系列 SSL 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 36 LTE Standard(U)系列 SSL 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 日期 2021-05-19 2021-07-19 2021-08-17 2022-08-03 2023-09-15 作者 变更表述 Kruskal ZHU 文档创建 Kruskal ZHU 受控版本 Kruskal ZHU Larson LI Kruskal ZHU 增加适用模块 EG915U 系列。 1. 增 加 适 用 模 块 EG912U-GL 、 EC200D-CN 、 EC600G-CN、EG700G-CN 和 EC800G-CN； 2. 增加 AT+QSSLCFG='session_cache'命令； 3. 删除 AT+QSSLCFG='cacertex'命令； 4. 补充 AT+QSSLOPEN 和 AT+QSSLSTATE 命令中参 数取值范围对于 EC200D-CN 模块的适 用说明。 1. 更新适用模块 EC200D-CN 为 EC200D 系列、更新适 用模块 EC600G-CN 为 EC600G 系列；增加适用模块 EC200G-CN 和 EG800G 系列； 2. 新增 AT+QSSLCFG='dtlsversion'命令（第 2.2.1 章）； 3. 新 增 AT+QSSLRECV=,0 设 置 命 令 （ 第 2.2.4 章）。 上海移远通信技术股份有限公司 3 / 36 LTE Standard(U)系列 SSL 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 1.2. SSL 版本和加密套件 ................................................................................................................... 8 1.3. SSL 功能使用流程..................................................................................................................... 10 1.4. 数据访问模式说明 ..................................................................................................................... 10 1.5. 证书有效期验证 ......................................................................................................................... 11 1.6. 服务器名称指示 ......................................................................................................................... 11 2 SSL AT 命令详解 ................................................................................................................................ 12 2.1. AT 命令说明............................................................................................................................... 12 2.1.1. 定义 ................................................................................................................................ 12 2.1.2. AT 命令语句 ................................................................................................................... 12 2.1.3. AT 示例声明.................................................................................................................... 13 2.2. SSL 相关 AT 命令描述............................................................................................................... 13 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 ...................................................................... 13 2.2.2. AT+QSSLOPEN 打开 SSL Socket 连接远程服务器.................................................... 20 2.2.3. AT+QSSLSEND 通过 SSL 连接发送数据.................................................................... 22 2.2.4. AT+QSSLRECV 通过 SSL 连接接收数据.................................................................... 23 2.2.5. AT+QSSLCLOSE 关闭 SSL 连接 ................................................................................ 24 2.2.6. AT+QSSLSTATE 查询 Socket 连接状态..................................................................... 25 2.3. URC 详解 .................................................................................................................................. 26 2.3.1. +QSSLURC: 'recv' 通知主机接收数据........................................................................ 26 2.3.2. +QSSLURC: 'closed' 通知异常断开连接 .................................................................... 26 3 举例 ...................................................................................................................................................... 27 3.1. 配置并激活 PDP 上下文 ............................................................................................................ 27 3.1.1. 配置 PDP 上下文 ............................................................................................................ 27 3.1.2. 激活 PDP 上下文 ............................................................................................................ 27 3.1.3. 去激活 PDP 上下文 ........................................................................................................ 27 3.2. 配置 SSL 上下文........................................................................................................................ 27 3.3. SSL 客户端在缓存模式下工作................................................................................................... 28 3.3.1. 建立 SSL 连接并进入缓存模式....................................................................................... 28 3.3.2. 缓存模式下发送数据....................................................................................................... 28 3.3.2.1. 发送不定长数据..................................................................................................... 28 3.3.2.2. 发送定长数据 ........................................................................................................ 28 3.3.3. 缓存模式下接收数据....................................................................................................... 29 3.3.4. 关闭 SSL 连接 ................................................................................................................ 29 3.4. SSL 客户端在直吐模式下工作................................................................................................... 29 3.4.1. 建立 SSL 连接并进入直吐模式....................................................................................... 29 上海移远通信技术股份有限公司 4 / 36 LTE Standard(U)系列 SSL 应用指导 3.4.2. 直吐模式下发送数据....................................................................................................... 29 3.4.3. 直吐模式下接收数据....................................................................................................... 30 3.4.4. 关闭 SSL 连接 ................................................................................................................ 30 3.5. SSL 客户端在透传模式下工作................................................................................................... 30 3.5.1. 建立 SSL 连接并在透传模式下发送数据 ........................................................................ 30 3.5.2. 建立 SSL 连接并在透传模式下接收数据 ........................................................................ 30 3.5.3. 关闭 SSL 连接 ................................................................................................................ 31 4 SSL 连接失败原因的排查..................................................................................................................... 32 5 错误代码 ............................................................................................................................................... 33 6 附录 参考文档和术语缩写 ................................................................................................................... 35 上海移远通信技术股份有限公司 5 / 36 LTE Standard(U)系列 SSL 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：SSL 版本 ............................................................................................................................................ 8 表 3：支持的 SSL 加密套件 ......................................................................................................................... 8 表 4：AT 命令类型...................................................................................................................................... 12 表 5：错误代码 ........................................................................................................................................... 33 表 6：参考文档 ........................................................................................................................................... 35 表 7：术语缩写 ........................................................................................................................................... 35 上海移远通信技术股份有限公司 6 / 36 LTE Standard(U)系列 SSL 应用指导 1 引言 本文档介绍如何使用移远通信 LTE Standard(U)系列模块的 SSL 功能。 SSL（Secure Sockets Layer，安全套接层）是为网络通信提供安全及数据完整性的一种安全协议。 为确保通信的私密性，在某些情况下，服务器和客户端之间的通信应采用加密方式，以防止在通信过 程中数据被窃听、篡改或伪造。SSL 功能可以满足上述要求。 1.1. 适用模块 表 1：适用模块 模块系列 EGx00G ECx00G ECx00U EGx00U EG91xU 模块 EC200D 系列 EG700G-CN EG800G 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG915U 系列 EG912U-GL 上海移远通信技术股份有限公司 7 / 36 LTE Standard(U)系列 SSL 应用指导 1.2. SSL 版本和加密套件 下表为移远通信 LTE Standard(U)系列模块支持的 SSL 版本。 表 2：SSL 版本 SSL 版本 SSL 3.0 TLS 1.2 TLS 1.1 TLS 1.0 移远通信 LTE Standard(U)系列模块支持下表所列的 SSL 加密套件，默认支持所有加密套件。有关加 密套件的详细说明，请参考 RFC 2246-The TLS Protocol Version 1.0。 表 3：支持的 SSL 加密套件 加密套件代码 0X0035 0X002F 0X0005 0X0004 0X000A 0X003D 0XC002 0XC003 0XC004 0XC005 加密套件名称 TLS_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA256 TLS_ECDH_ECDSA_WITH_RC4_128_SHA TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 上海移远通信技术股份有限公司 8 / 36 0XC007 0XC008 0XC009 0XC00A 0XC011 0XC012 0XC013 0XC014 0xC00C 0XC00D 0XC00E 0XC00F 0XC023 0xC024 0xC025 0xC026 0XC027 0XC028 0xC029 0XC02A 0XC02F 0XC030 0XFFFF LTE Standard(U)系列 SSL 应用指导 TLS_ECDHE_ECDSA_WITH_RC4_128_SHA TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA TLS_ECDHE_RSA_WITH_RC4_128_SHA TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA TLS_ECDH_RSA_WITH_RC4_128_SHA TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA TLS_ECDH_RSA_WITH_AES_128_CBC_SHA TLS_ECDH_RSA_WITH_AES_256_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 支持以上所有加密套件 上海移远通信技术股份有限公司 9 / 36 LTE Standard(U)系列 SSL 应用指导 1.3. SSL 功能使用流程 步骤 1: 通过 AT+QICSGP 配置 PDP 上下文的、、和其他参数。详细信 息可参考文档 [1]。 步骤 2: 通过 AT+QIACT 激活 PDP 上下文。成功激活上下文后，可通过 AT+QIACT?查询分配的 IP 地址。 详细信息可参考文档 [1]。 步骤 3: 通过 AT+QSSLCFG 配置指定 SSL 上下文的 SSL 版本、加密套件、受信任 CA 证书路径、身份验 证模式、客户端证书路径、客户端密钥路径等 SSL 配置。 步骤 4: 通过 AT+QSSLOPEN 打开 SSL socket 连接远程服务器。 步骤 5: SSL 连接成功建立后，将通过该连接收发数据。每个模式下数据的收发详情，可参考第 1.4 章。 步骤 6: 通过 AT+QSSLCLOSE 关闭 SSL 连接。 步骤 7: 通过 AT+QIDEACT 去激活 PDP 上下文。详细信息请参考文档 [1]。 1.4. 数据访问模式说明 SSL 连接支持以下 3 种数据访问模式： ⚫ 缓存模式 ⚫ 直吐模式 ⚫ 透传模式 当通过 AT+QSSLOPEN 打开 SSL 连接时，可以通过来指定数据访问模式；SSL 连 接成功创建后，可通过 AT+QISWTMD 切换数据访问模式。关于 AT+QISWTMD 详细信息，请参考文档 [1]。 1. 缓存模式下，可以通过 AT+QSSLSEND 发送数据。从网络接收数据时，模块将上报 URC：+QSSLURC: 'recv',，之后用户可以通过 AT+QSSLRECV 来读取缓存数据。 2. 直吐模式下，可以通过 AT+QSSLSEND 发送数据。从网络接收数据时，数据会以如下格式直接输出到 UART/USB modem/USB AT 口：+QSSLURC: 'recv',, 。 3. 透传模式下，相应端口会进入独占模式；从网络接收到的数据会从 COM 口直接输出。+++或者 DTR（需 先执行 AT&D1）可用于退出透传模式。若服务器异常断开 SSL 连接，将上报结果码 NO CARRIER。 关于 AT&D 的详细信息，可参考文档 [3]。 上海移远通信技术股份有限公司 10 / 36 LTE Standard(U)系列 SSL 应用指导 ⚫ 退出透传模式 用户可以通过+++或者 DTR（需先执行 AT&D1）两种方式退出透传模式，为了防止+++被当成数据发 送，实际操作过程中必须注意以下几点： 1） +++输入前 1 秒或更长时间内不能输入其它任何数据； 2） 必须在 1 秒内输入+++，并且不能输入其它任何数据； 3） +++输入后 1 秒内不能输入其它任何数据； 4） 通过+++或者 DTR（需先执行 AT&D1）方式使模块退出透传模式，直到模块返回 OK。 ⚫ 切换到透传模式 1） 通过执行 AT+QISWTMD：执行命令时，指定为 2，返回 CONNECT，表示成功 切换到透传模式。 2） 通过执行 ATO：退出透传模式后，可通过 ATO 再切换回至透传模式；若返回 CONNECT，则表 示成功切换到透传模式。若连接访问模式前模块未进入过透传模式，那么执行 ATO 会返回 NO CARRIER。关于 ATO 的详细信息，可参考文档 [3]。 1.5. 证书有效期验证 检查证书是否在有效期内，必须对证书进行解析，并将本地时间与证书的'不早于'时间和'不晚于'时间 相比较。如果本地时间早于'不早于'的时间或晚于'不晚于'的时间，则证书将被视为已过期。 若需要进行证书有效期验证（通过 AT+QSSLCFG 设置=0），为避免验证失败，应使 用 AT+CCLK 将模块本地时间配置在证书有效期内。关于 AT+CCLK 的详细信息，可参考文档 [3]。 1.6. 服务器名称指示 客户端期望 SNI（服务器名称指示）提供服务器主机名称信息，以增强与基于单个 IP 地址的多个虚拟 服务器的安全连接。该功能仅适用于 TLS 协议。 上海移远通信技术股份有限公司 11 / 36 LTE Standard(U)系列 SSL 应用指导 2 SSL AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 4：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 12 / 36 LTE Standard(U)系列 SSL 应用指导 2.1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.2. SSL 相关 AT 命令描述 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 该命令用于配置 SSL 上下文的 SSL 版本、加密套件、受信任 CA 证书路径、身份验证模式、客户端证 书、客户端密钥路径等 SSL 配置。这些参数将在握手过程中使用。 是 SSL 上下文的索引。模块最多支持 6 个 SSL 上下文。可以基于一个 SSL 上下文建立 多个 SSL 连接。SSL 版本和加密套件的设置存储在 SSL 上下文中，并将应用于与该 SSL 上下文关联的新 SSL 连接。 AT+QSSLCFG 配置 SSL 上下文参数 测试命令 AT+QSSLCFG=? 响应 +QSSLCFG: 'sslversion',(支持的范 围),(支持的范围) +QSSLCFG: 'dtls',(支持的范围),(支持 的列表) +QSSLCFG: 'ciphersuite',(支持的范 围),(支持的列表) +QSSLCFG: 'seclevel',(支持的范围), (支持的范围) +QSSLCFG: 'cacert',(支持的范围), +QSSLCFG: 'clientcert',(支持的范 围), +QSSLCFG: 'clientkey',(支持的范 围), +QSSLCFG: 'sni',(支持的范围),(支持 的列表) +QSSLCFG: 'ignorelocaltime',(支持的范围),(支持的列表) +QSSLCFG: 'negotiatetime',(支持的 范围),(支持的范围) +QSSLCFG: 'ignoreinvalidcertsign',(支持的范围),(支持的列 表) 上海移远通信技术股份有限公司 13 / 36 LTE Standard(U)系列 SSL 应用指导 +QSSLCFG: 'ignorecertitem',(支持的范围),(支持的范围) +QSSLCFG: 'ignoremulticertchainverify',(支持的 范围),(支持的列表) +QSSLCFG: 'session_cache',(支持的范围),(支持的列表) +QSSLCFG: 'dtlsversion',(支持的范 围),(支持的列表) 设置命令 配置指定 SSL 上下文的 SSL 版本： AT+QSSLCFG='sslversion',[,< SSL_version>] OK 响应 若省略可选参数，则查询指定 SSL 上下文的 SSL 版本： +QSSLCFG: 'sslversion',, OK 设置命令 打开/关闭指定 SSL 上下文的 DTLS 功能： AT+QSSLCFG='dtls',[,] 若指定可选参数，则配置指定 SSL 上下文的 SSL 版本： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文是否打开 DTLS 功能： +QSSLCFG: 'dtls',, OK 设置命令 配置指定 SSL 上下文的加密套件： AT+QSSLCFG='ciphersuite',[, ] 若指定可选参数，则打开/关闭指定 SSL 上下文的 DTL S 功能： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的加密套件： +QSSLCFG: 'ciphersuite',, OK 若指定可选参数，则配置指定 SSL 指定上下文的加密 套件： OK 上海移远通信技术股份有限公司 14 / 36 LTE Standard(U)系列 SSL 应用指导 设置命令 配置指定 SSL 上下文的身份验证模式： AT+QSSLCFG='seclevel',[,] 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的身份验证 模式： +QSSLCFG: 'seclevel',, OK 设置命令 配置指定 SSL 上下文的受信任 CA 证书路径： AT+QSSLCFG='cacert',[,] 若指定可选参数，则配置指定 SSL 上下文的身份验证 模式： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文已配置的受 信任 CA 证书路径： +QSSLCFG: 'cacert',, OK 设置命令 配置指定 SSL 上下文的客户端证书路径： AT+QSSLCFG='clientcert',[,] 若指定可选参数，则配置指定 SSL 上下文的受信任 CA 证书路径： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的客户端证 书路径： +QSSLCFG: 'clientcert',, OK 设置命令 配置指定 SSL 上下文的客户端密钥： AT+QSSLCFG='clientkey',[,] 若指定可选参数，则配置指定 SSL 上下文的客户端证 书路径： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的客户端密 钥： +QSSLCFG: 'clientkey',, 上海移远通信技术股份有限公司 15 / 36 LTE Standard(U)系列 SSL 应用指导 OK 若指定可选参数，则配置指定 SSL 上下文的客户端密 钥： OK 或者 ERROR 设置命令 响应 打开/关闭指定 SSL 上下文的服务器名称指示功 若省略可选参数，则查询指定 SSL 上下文是否打开服 能： 务器名称指示功能： AT+QSSLCFG='sni',[,] +QSSLCFG: 'sni',, OK 若指定可选参数，则打开/关闭指定 SSL 上下文的服务 器名称指示功能： OK 或者 设置命令 ERROR 响应 配置指定 SSL 上下文是否忽略证书有效期验证： 若省略可选参数，则查询指定 SSL 上下文是否忽略证 AT+QSSLCFG='ignorelocaltime',[,] +QSSLCFG: 'ignorelocaltime',, OK 若指定可选参数，则配置指定 SSL 上下文是否忽略证 书有效期验证： OK 或者 设置命令 ERROR 响应 配置指定 SSL 上下文在 SSL 协商阶段的最大超 若省略可选参数，则查询指定 SSL 上下文在 SSL 协商 时时间： 阶段的最大超时时间： AT+QSSLCFG='negotiatetime',<SSL_ctxI +QSSLCFG: 'negotiatetime',,[,] iate_time> OK 若指定可选参数，则配置指定 SSL 上下文在 SSL 协商 阶段的最大超时时间： OK 上海移远通信技术股份有限公司 16 / 36 LTE Standard(U)系列 SSL 应用指导 设置命令 配置指定 SSL 上下文是否忽略无效证书签名： AT+QSSLCFG='ignoreinvalidcertsign',[,] 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文是否忽略无 效证书签名： +QSSLCFG: 'ignoreinvalidcertsign',, OK 设置命令 客户端是否忽略对服务器发送的证书所指定的某 一项或多项检查： AT+QSSLCFG='ignorecertitem',[,] 若指定可选参数，则配置指定 SSL 上下文是否忽略无 效证书签名： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文是否忽略对 服务器发送的证书所指定的某一项或多项检查功能： +QSSLCFG: 'ignorecertitem',, OK 若指定可选参数，则配置指定 SSL 上下文是否忽略对 服务器发送的证书所指定的某一项或多项检查： OK 或者 ERROR 设置命令 响应 配置指定 SSL 上下文是否忽略多级证书链验证： 若省略可选参数，则查询指定 SSL 上下文是否忽略多 AT+QSSLCFG='ignoremulticertchainverify', 级证书链验证： [,<ignore_multicertchain_verif +QSSLCFG: 'ignoremulticertchainverify ',] ctxID>, OK 设置命令 使能或禁用指定 SSL 上下文会话缓存功能： AT+QSSLCFG='session_cache',[,] +QSSLCFG: 'session_cache',, OK 设置命令 设置指定 SSL 上下文 DTLS 协议版本： AT+QSSLCFG='dtlsversion',[, ] 若指定可选参数，则使能或禁用指定 SSL 上下文的 SSL 会话缓存功能： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文配置的 DTLS 版本： +QSSLCFG: 'dtlsversion',, OK 最大响应时间 特性说明 若指定可选参数，则配置指定 SSL 上下文的 DTLS 版 本： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。SSL 上下文标识符。范围：0~5。 整型。SSL 版本。 0 SSL 3.0 1 TLS 1.0 2 TLS 1.1 3 TLS 1.2 4 全部 整型。打开/关闭 DTLS 功能。 0 关闭 1 打开 十六进制数值。SSL 加密套件。 0X0035 TLS_RSA_WITH_AES_256_CBC_SHA 0X002F TLS_RSA_WITH_AES_128_CBC_SHA 0X0005 TLS_RSA_WITH_RC4_128_SHA 上海移远通信技术股份有限公司 18 / 36 LTE Standard(U)系列 SSL 应用指导 0X0004 TLS_RSA_WITH_RC4_128_MD5 0X000A TLS_RSA_WITH_3DES_EDE_CBC_SHA 0X003D TLS_RSA_WITH_AES_256_CBC_SHA256 0XC002 TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0XC003 TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0XC004 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0XC005 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0XC007 TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0XC008 TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0XC009 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0XC00A TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0XC011 TLS_ECDHE_RSA_WITH_RC4_128_SHA 0XC012 TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0XC013 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0XC014 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC00C TLS_ECDH_RSA_WITH_RC4_128_SHA 0XC00D TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0XC00E TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0XC00F TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0XC023 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC024 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC025 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC026 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0XC027 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0XC028 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC029 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0XC02A TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0XC02F TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0XC030 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0XFFFF 支持所有加密套件 整型。身份验证模式。 0 无身份验证模式 1 进行服务器身份验证 2 如果远程服务器要求，则进行服务器和客户端身份验证 字符串类型。受信任 CA 证书路径。 字符串类型。客户端证书路径。 字符串类型。客户端密钥路径。 整型。打开/关闭服务器名称指示功能。 0 关闭 1 打开 整型。是否忽略证书有效期验证。 0 不忽略 1 忽略 整型。SSL 协商阶段的最大超时时间。范围：10~300；默认值：300；单位：秒。 上海移远通信技术股份有限公司 19 / 36 LTE Standard(U)系列 SSL 应用指导 整型。表示是否忽略无效证书签名。 0 不忽略 1 忽略 整型。客户端是否忽略对服务器发送的证书所指定的某一项或多项检查。 忽略多项检查项时，参数则累计取值。 0 不忽略证书任何检查项的检查 1 忽略证书有效期验证 4 忽略证书 CN 与预期的 CN 不匹配 8 忽略证书未由受信任的 CA 正确签名 256 忽略某些其他原因（用于验证回调的原因） 2048 忽略 Usage 与 keyUsage 扩展名不匹配 4096 忽略 Usage 与 extendedKeyUsage 扩展名不匹配 8192 忽略 Usage 与 nsCertType 扩展名不匹配 32768 忽略证书用不可接受的公钥算法（例如 RSA，ECDSA）签名 65536 忽略证书用不可接受的密钥签名 1048575 忽略证书所有检查项，即忽略证书检查 整型。表示是否忽略多级证书链验证。 0 不忽略 1 忽略 整型。使能或禁用 SSL 会话缓存功能。 0 禁用 1 使能 整型。DTLS 版本。 0 DTLS 1.0 1 DTLS 1.2 2.2.2. AT+QSSLOPEN 打开 SSL Socket 连接远程服务器 该命令用于建立 SSL 连接，即打开 SSL socket 连接远程服务器。在模块和网络协商期间， AT+QSSLCFG 将用于握手过程中的参数配置。与网络成功握手后，模块可以通过此 SSL 连接发送或接收 数据，还可以基于一个 SSL 上下文建立多个 SSL 连接。 根据第 1.3 章中的步骤，需先执行 AT+QIACT 以激活 PDP 上下文，然后执行 AT+QSSLOPEN。等待 指定的时间（可参考下面的最大响应时间）后将输出 URC +QSSLOPEN: ,。如果在此期 间未收到 URC 响应，则可以使用 AT+QSSLCLOSE 关闭 SSL 连接。 AT+QSSLOPEN 打开 SSL Socket 连接远程服务器 测试命令 AT+QSSLOPEN=? 响应 +QSSLOPEN: ( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),,[,( 支 持 的 范围)] OK 上海移远通信技术股份有限公司 20 / 36 LTE Standard(U)系列 SSL 应用指导 设置命令 AT+QSSLOPEN=,,,,[,] 响应 若=2 并且成功建立 SSL 连接： CONNECT 若有任何错误： ERROR 若=0/1： OK +QSSLOPEN: , 当=0，表示成功打开 SSL socket；否则，表示打开 SSL socket 失败。 最大响应时间 特性说明 若有任何错误： ERROR 最大网络响应时间为 150 秒，需再加上配置 的时间 该命令立即生效； 参数配置不保存。 参数 整型。上下文标识符。 EC200D 系列、EG800G 系列和 EC200G-CN 模块，该参数范围为 1~11。 其他适用模块，该参数范围为 1~7。 整型。SSL 上下文标识符。范围：0~5。 整型。Socket 索引。范围：0~11。 字符串类型。远程服务器地址。 整型。远程服务器监听端口。 整型。表示 SSL 连接的数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 整型。操作错误码。详细信息可参考第 5 章。 整型。SSL 协商阶段的最大超时时间。范围：10~300；默认值：300；单位：秒。 上海移远通信技术股份有限公司 21 / 36 LTE Standard(U)系列 SSL 应用指导 2.2.3. AT+QSSLSEND 通过 SSL 连接发送数据 建立 SSL 连接后，模块可以通过该连接发送数据。 AT+QSSLSEND 通过 SSL 连接发送数据 测试命令 AT+QSSLSEND=? 响应 +QSSLSEND: (支持的范围)[,(支持的范 围)] 设置命令 发送不定长数据 AT+QSSLSEND= OK 响应 > 响应>后，输入要发送的数据。点击 CTRL+Z 发送，点击 ESC 取消操作。 若已建立 SSL 连接且数据发送成功： SEND OK 若已建立 SSL 连接但缓存已满： SEND FAIL 设置命令 发送定长数据 AT+QSSLSEND=, 若 SSL 连接未建立、异常断开或参数错误： ERROR 响应 > 响应>后，输入要发送的数据，直至数据长度达到 配置的长度。 若已建立 SSL 连接且数据发送成功： SEND OK 若已建立 SSL 连接但缓存已满： SEND FAIL 最大响应时间 特性说明 若 SSL 连接未建立、异常断开或参数错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 22 / 36 LTE Standard(U)系列 SSL 应用指导 参数 整型。Socket 索引。范围：0~11。 整型。发送数据的长度。范围：1~1460；单位：字节。 备注 发送的数据包括定长数据和不定长数据，最大长度都为 1460 个字节。 2.2.4. AT+QSSLRECV 通过 SSL 连接接收数据 当 SSL 连接的数据访问模式为缓存模式时，模块收到网络发送的数据时将上报 URC +QSSLURC: 'recv',。可以通过 AT+QSSLRECV 读取缓存的数据。 AT+QSSLRECV 通过 SSL 连接接收数据 测试命令 AT+QSSLRECV=? 响应 +QSSLRECV: (支持的范围),(支持的范 围) 设置命令 AT+QSSLRECV=, OK 响应 若指定 Socket 连接接收到数据： +QSSLRECV: OK 若缓冲区为空： +QSSLRECV: 0 OK 设置命令 当=0，查询读取的数据长 度： AT+QSSLRECV=,0 若 SSL 连接未建立、异常断开或参数错误： ERROR 响应 若指定连接存在： +QSSLRECV: ,, OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 23 / 36 LTE Standard(U)系列 SSL 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。Socket 索引。范围：0~11。 整型。需读取数据的长度。范围：0~1500；单位：字节。 整型。通过 AT+QSSLRECV 读取数据的实际长度。单位：字节。 实际读取的数据。单位：字节。 整型。已接收数据的总长度。单位：字节。 整型。已读取数据的长度。单位：字节。 整型。未读取数据的长度。单位：字节。 2.2.5. AT+QSSLCLOSE 关闭 SSL 连接 该命令用于关闭 SSL 连接。如果基于同一 SSL 上下文的所有 SSL 连接都已关闭，则模块将释放 SSL 上下文。 AT+QSSLCLOSE 关闭 SSL 连接 测试命令 AT+QSSLCLOSE=? 响应 +QSSLCLOSE: (支持的范围),(支持的范围) 设置命令 AT+QSSLCLOSE=[,] OK 响应 如果 SSL 连接成功关闭： OK 最大响应时间 特性说明 若发生任何错误： ERROR 取决于配置的时间 该命令立即生效； 参数配置不保存。 参数 整型。Socket 索引。范围：0~11。 整型。AT+QSSLCLOSE 执行的超时时间。范围：0~65535；默认值：10；单位：秒。 0 表示立即执行该命令。 上海移远通信技术股份有限公司 24 / 36 LTE Standard(U)系列 SSL 应用指导 2.2.6. AT+QSSLSTATE 查询 Socket 连接状态 该命令用于查询 Socket 连接状态，且仅能查询 SSL 连接状态。 AT+QSSLSTATE 查询 Socket 连接状态 测试命令 响应 AT+QSSLSTATE=? 设置命令 OK 响应 AT+QSSLSTATE= +QSSLSTATE: ,'SSLClient',,,,,, ,,, 执行命令 AT+QSSLSTATE OK 响应 (+QSSLSTATE: ,'SSLClient',,,,,, ,,,)的 列表 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。上下文标识符。 EC200D 系列、EG800G 系列和 EC200G-CN 模块，该参数范围为 1~11。 其他适用模块，该参数范围为 1~7。 整型。Socket 索引。范围：0~11。 字符串类型。远程服务器地址。 整型。远程服务器端口。范围：0~65535。 整型。本地端口。范围：0~65535。 整型。SSL 连接状态。 0 连接尚未建立 1 客户端正在连接 2 客户端连接已建立 4 连接正在关闭 整型。此参数为预留参数。 整型。表示 SSL 连接的数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 上海移远通信技术股份有限公司 25 / 36 LTE Standard(U)系列 SSL 应用指导 字符串类型。COM 端口。 整型。SSL 上下文标识符。范围：0~5。 2.3. URC 详解 2.3.1. +QSSLURC: 'recv' 通知主机接收数据 该 URC 用于通知主机读取从服务器接收的数据。 +QSSLURC: 'recv' 通知主机接收数据 +QSSLURC: 'recv', 缓存模式下接收数据时上报的 URC。缓存的数据可通过 AT+QSSLRECV 读取。 +QSSLURC: 'recv',, 参数 整型。Socket 索引。范围：0~11。 整型。实际接收的数据长度。单位：字节。 需读取的数据。单位：字节。 2.3.2. +QSSLURC: 'closed' 通知异常断开连接 该 URC 用于通知主机连接已断开。断开连接可能由多种原因引起，例如网络关闭连接或 GPRS PDP 被去激活，指定 Socket 的 SSL 连接状态可能为'closing'，此时需执行 AT+QSSLCLOSE=将 SSL 连接状态改为'initial'。 +QSSLURC: 'closed' 通知异常断开连接 +QSSLURC: 'closed', 基于指定 Socket 的 SSL 连接已关闭。 参数 整型。Socket 标识符。范围：0~11。 上海移远通信技术股份有限公司 26 / 36 LTE Standard(U)系列 SSL 应用指导 3 举例 3.1. 配置并激活 PDP 上下文 3.1.1. 配置 PDP 上下文 AT+QICSGP=1,1,'UNINET','','',1 OK //配置上下文为 1。'UNINET'表示中国联通。 3.1.2. 激活 PDP 上下文 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK //激活上下文为 1。 //激活成功。 //查询上下文状态。 3.1.3. 去激活 PDP 上下文 AT+QIDEACT=1 OK //去激活上下文 1。 //去激活成功。 3.2. 配置 SSL 上下文 AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0X0035 OK AT+QSSLCFG='seclevel',1,1 OK //设置 SSL 上下文标识符和 SSL 版本均为 1。 //设置 SSL 上下文标识符为 1，SSL 加密套件为 TLS_RSA_WITH_AES_256_CBC_SHA。 //设置 SSL 上下文标识符为 1，身份验证模式为进行服务器 身份验证。 上海移远通信技术股份有限公司 27 / 36 LTE Standard(U)系列 SSL 应用指导 AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK //设置 SSL 上下文标识符为 1，受信任 CA 证书路径为 UFS:cacert.pem。 3.3. SSL 客户端在缓存模式下工作 3.3.1. 建立 SSL 连接并进入缓存模式 AT+QSSLOPEN=1,1,4,'220.180.239.212',8010,0 OK +QSSLOPEN: 4,0 //成功建立 SSL 连接。 AT+QSSLSTATE //查询所有 SSL 连接的状态。 +QSSLSTATE: 4,'SSLClient','220.180.239.212',8010,65344,2,1,4,0,'usbmodem',1 OK 3.3.2. 缓存模式下发送数据 3.3.2.1. 发送不定长数据 AT+QSSLSEND=4 > Test data from SSL SEND OK //发送定不定长数据。 3.3.2.2. 发送定长数据 AT+QSSLSEND=4,18 > Test data from SSL SEND OK //发送定长数据且数据长度为 18 个字节。 上海移远通信技术股份有限公司 28 / 36 3.3.3. 缓存模式下接收数据 +QSSLURC: 'recv',4 AT+QSSLRECV=4,1500 +QSSLRECV: 18 Test data from SSL OK AT+QSSLRECV=4,1500 +QSSLRECV: 0 OK 3.3.4. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK LTE Standard(U)系列 SSL 应用指导 //Socket 4（=4）接收到数据。 //读取数据。需读取数据的长度为 1500 个字节。 //实际接收数据长度为18个字节。 //缓冲区无数据。 //关闭 SSL 连接（=4）。取决于网络，最大响应时间 为 10 秒。 3.4. SSL 客户端在直吐模式下工作 3.4.1. 建立 SSL 连接并进入直吐模式 AT+QSSLOPEN=1,1,4,'220.180.239.212',8011,1 OK +QSSLOPEN: 4,0 AT+QSSLSTATE //成功建立 SSL 连接。 //查询所有 SSL 连接的状态。 +QSSLSTATE: 4,'SSLClient','220.180.239.212',8011,65047,2,1,4,1,'usbmodem',1 OK 3.4.2. 直吐模式下发送数据 AT+QSSLSEND=4 > Test data from SSL SEND OK AT+QSSLSEND=4,18 //发送不定长数据。 //发送数据且数据长度为 18 个字节。 上海移远通信技术股份有限公司 29 / 36 > Test data from SSL SEND OK 3.4.3. 直吐模式下接收数据 +QSSLURC: 'recv',4,18 Test data from SSL 3.4.4. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK LTE Standard(U)系列 SSL 应用指导 //关闭 SSL 连接（=4）。取决于网络，最大响应时间 为 10 秒。 3.5. SSL 客户端在透传模式下工作 3.5.1. 建立 SSL 连接并在透传模式下发送数据 AT+QSSLOPEN=1,1,4,'220.180.239.212',8011,2 CONNECT OK //建立 SSL 连接。 //进入透传模式。 //客户端直接通过 COM 端口向网络发送数据（该举 例中数据不可见）。 //+++或者 DTR（需先执行 AT&D1）可用于退出透 传模式。若服务器异常断开 SSL 连接，将上报结 果码 NO CARRIER。 3.5.2. 建立 SSL 连接并在透传模式下接收数据 AT+QSSLOPEN=1,1,4,'220.180.239.212',8011,2 CONNECT OK //建立 SSL 连接。 //进入透传模式。 //客户端正在读取数据。 //通过+++或者 DTR（需先执行 AT&D1）退出透传 模式。若服务器断开 SSL 连接，将上报结果码 NO CARRIER。 上海移远通信技术股份有限公司 30 / 36 3.5.3. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK LTE Standard(U)系列 SSL 应用指导 //关闭 SSL 连接（=4）。取决于网络， 最大响应时间为 10 秒。 上海移远通信技术股份有限公司 31 / 36 LTE Standard(U)系列 SSL 应用指导 4 SSL 连接失败原因的排查 若 SSL 连接打开失败，请进行以下排查： 1. 通过 AT+QIACT?查询指定 PDP 上下文的状态，检查指定 PDP 上下文是否已被激活。 2. 由于无效的 DNS 服务器无法将域名转换为 IP 地址，若远程服务器地址为域名，还请通过 AT+QIDNSCFG=检查 DNS 服务器地址是否有效。关于 AT+QIDNSCFG 的详细信息， 可参考文档 [1]。 3. 通过 AT+QSSLCFG 检查 SSL 配置，尤其是 SSL 版本及加密套件，以确保服务器端可以支持。 若=1/2，则需通过 AT+QFUPL 上传受信任 CA 证书。若服务器配置了'SSLVerifyClient required'，则需通过 AT+QFUPL 上传客户端证书和客户端密钥。关于证书有效期验证的详情，请 参考第 1.5 章。关于 AT+QFUPL 的详细信息，可参考文档 [2]。 上海移远通信技术股份有限公司 32 / 36 LTE Standard(U)系列 SSL 应用指导 5 错误代码 如果在执行 SSL 相关 AT 命令后返回 ERROR 或 URC 错误码，都可以通过 AT+QIGETERROR 查询 错 误 的 详 细 信 息 。 但 需 注 意 AT+QIGETERROR 仅 返 回 最 后 一 个 SSL 命 令 的 错 误 代 码 。 关 于 AT+QIGETERROR 的详情请参考文档 [1]。 表 5：错误代码 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 错误代码 Operation successful Unknown error Operation blocked Invalid parameter Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy 释义 操作成功 未知错误 操作被阻塞 无效参数 内存不足 创建Socket失败 不支持该操作 Socket绑定失败 Socket监听失败 Socket写入失败 Socket读取失败 Socket接受失败 打开PDP上下文失败 关闭PDP上下文失败 Socket标识已被使用 DNS业务繁忙 上海移远通信技术股份有限公司 33 / 36 LTE Standard(U)系列 SSL 应用指导 565 DNS parse failed DNS解析失败 566 Socket connection failed Socket连接失败 567 Socket has been closed Socket已关闭 568 Operation busy 操作繁忙 569 Operation timeout 操作超时 570 PDP context break down PDP上下文崩溃 571 Cancel send 取消发送 572 Operation not allowed 不允许操作 573 APN not configured 未配置APN 574 Port busy 端口繁忙 579 SSL handshake fail SSL握手失败 上海移远通信技术股份有限公司 34 / 36 LTE Standard(U)系列 SSL 应用指导 6 附录 参考文档和术语缩写 表 6：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_TCP(IP)_应用指导 [2] Quectel_LTE_Standard(U)系列_FILE_应用指导 [3] Quectel_LTE_Standard(U)系列_AT 命令手册 表 7：术语缩写 缩写 APN CA CR CMUX CN DNS DTR DTLS GPRS LF PDP PK PSK 英文全称 Access Point Name Certificate Authority Carriage Return Connection Multiplexing Common Name Domain Name Server Data Terminal Ready Datagram Transport Layer Security General Packet Radio Service Line Feed Packet Data Protocol Public Key Pre-Shared Key 中文全称 接入点名称 证书授权 回车符 连接（串口）多路复用 公用名 域名服务器 数据终端就绪 数据包传输层安全协议 通用分组无线业务 换行符 分组数据协议 公钥 预共享密钥 上海移远通信技术股份有限公司 35 / 36 SNI SSL TCP/IP TLS UART UFS URC USB LTE Standard(U)系列 SSL 应用指导 Server Name Indication Security Socket Layer Transmission Control Protocol/Internet Protocol Transport Layer Security Universal Asynchronous Receiver/Transmitter Universal Flash Storage Unsolicited Result Code Universal Serial Bus 服务器名称指示 安全套接层协议 传输控制协议/网际协议 安全传输层协议 通用异步收发机 通用闪存存储 非请求结果码 通用串行总线 上海移远通信技术股份有限公司 36 / 36

LTE Standard(U)系列 MMS 应用指导 LTE Standard 模块系列 版本：1.2 日期：2023-09-12 状态：受控文件 LTE Standard(U)系列 MMS 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 上海移远通信技术股份有限公司 1 / 27 LTE Standard(U)系列 MMS 应用指导 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 27 LTE Standard(U)系列 MMS 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 日期 2021-08-14 2021-11-15 2022-08-11 2023-09-12 作者 变更表述 Lambert ZHAO 文档创建 Lambert ZHAO Lambert ZHAO Lambert ZHAO 受控版本 增加适用模块 EC200D-CN、EC600G-CN、EC800G-CN 和 EG912U-GL。 1. 增加适用模块 EC200G-CN 和 EG800G-CN；更新适 用模块 EC200D-CN 和 EC600G-CN 为 EC200D 系 列和EC600G 系列。 2. 更新 MMS 功能可选备注（第 1.1 章）。 3. 更新 SD 卡功能可选备注（第 1.2 和 2.3.2 章）。 4. 更新范围说明（第 2.3.1 章） 上海移远通信技术股份有限公司 3 / 27 LTE Standard(U)系列 MMS 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 1.2. 发送 MMS 消息操作流程 ............................................................................................................. 7 2 MMS AT 命令详解.................................................................................................................................. 8 2.1. AT 命令说明................................................................................................................................. 8 2.1.1. 定义 .................................................................................................................................. 8 2.1.2. AT 命令语句...................................................................................................................... 8 2.2. AT 示例声明................................................................................................................................. 9 2.3. AT 命令详解................................................................................................................................. 9 2.3.1. AT+QMMSCFG 配置 MMS 的参数................................................................................ 9 2.3.2. AT+QMMSEDIT 编辑 MMS 消息 ................................................................................. 12 2.3.3. AT+QMMSEND 发送 MMS 消息 ................................................................................. 14 3 举例 ...................................................................................................................................................... 16 3.1. 添加收件人 ................................................................................................................................ 16 3.2. 添加抄送收件人或密件抄送收件人............................................................................................ 16 3.3. 编辑 MMS 消息标题 .................................................................................................................. 17 3.4. 添加附件 .................................................................................................................................... 17 3.5. 清除 MMS 消息的所有内容 ....................................................................................................... 19 3.6. 发送 MMS 消息操作流程 ........................................................................................................... 19 4 异常处理 ............................................................................................................................................... 23 4.1. 执行 MMS AT 命令失败 ............................................................................................................. 23 4.2. PDP 激活失败............................................................................................................................ 23 4.3. AT+QMMSEND 的错误响应...................................................................................................... 23 5 错误码 .................................................................................................................................................. 24 6 HTTP(S)响应码 .................................................................................................................................... 26 7 附录 参考文档和术语缩写 ................................................................................................................... 27 上海移远通信技术股份有限公司 4 / 27 LTE Standard(U)系列 MMS 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 8 表 3：错误码............................................................................................................................................... 24 表 4：HTTP(S)响应码 ................................................................................................................................ 26 表 5：参考文档 ........................................................................................................................................... 27 表 6：术语缩写 ........................................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 27 LTE Standard(U)系列 MMS 应用指导 1 引言 移远通信 LTE Standard(U)系列模块提供 MMS 应用程序接口，用于发送包括多媒体对象（图像、音频 和富文本等）在内的消息。本文档为 MMS 定义的所有 AT 命令的应用指导。 1.1. 适用模块 表 1：适用模块 模块系列 - ECx00G ECx00U EGx00U EG91xU 模块 EC200D 系列 EC200G-CN EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG800G-CN EG912U-GL EG915U 系列 备注 ECx00G 系列模块 MMS 功能可选，详情请咨询移远通信技术支持。 上海移远通信技术股份有限公司 6 / 27 LTE Standard(U)系列 MMS 应用指导 1.2. 发送 MMS 消息操作流程 步骤一：配置并激活 PDP 上下文。 1） 通过 AT+QICSGP 配置、、和 PDP 上下文的其他参数。 详情请参考文档 [1]。如需更新 QoS 设置，请通过 AT+CGQMIN 和 AT+CGQREQ 对其 进行配置。详情请参考文档 [2]。 2） 通过 AT+QIACT 激活 PDP 上下文。 3） 通过 AT+QMMSCFG='contextid',配置 MMS 的 PDP 上下文 ID。 步骤二：配置 MMSC 的 URL 和代理。 1) 通过 AT+QMMSCFG='mmsc',配置 MMSC 的 URL。 2) 通过 AT+QMMSCFG='proxy',,配置 MMSC 的代理。 3) 通过 AT+QMMSCFG='sendparam',,,,,,< class>配置发送 MMS 需使用的参数。 步骤三：编辑 MMS 消息。 1） 通过 AT+QMMSEDIT=1,1,添加收件人地址。 2） 通过 AT+QMMSEDIT=2,1,添加抄送收件人地址。 3） 通过 AT+QMMSEDIT=3,1,添加密件抄送收件人地址。 4） 通 过 AT+QMMSEDIT=4,1, 编 辑 标 题 前 ， 需 先 通 过 AT+QMMSCFG='character',指定标题的字符集。 5） 通过 AT+QMMSEDIT=5,1,添加附件。附件可以是 UFS、SFS、EFS、或 SD 文件。可通过 AT+QFUPL 将文件上传到 UFS、SFS、EFS、或 SD 卡。命令详情请参考 文档 [3]。如果附件是文本文件，则字符集应由 AT+QMMSCFG='character', 指定。 步骤四：通过 AT+QMMSEND=发送 MMS 消息，成功发送 MMS 消息可能需要一些时间。 步骤五：通过 AT+QMMSEDIT=0 清除 MMS 消息的内容，并通过 AT+QFDEL 删除附件。详情请参考 文档 [3]。 如再次发送 MMS 消息至同一收件人，可重复步骤四和步骤五；如发送 MMS 消息至其他收件人，可重 复步骤二至步骤五。 备注 1. 不同模块实际支持的存储媒介（文件类型）有所差异，详细信息请参考文档 [3]。 2. ECx00G 系列模块 SD 卡功能可选，详情请咨询移远通信技术支持。 上海移远通信技术股份有限公司 7 / 27 LTE Standard(U)系列 MMS 应用指导 2 MMS AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。本文档表现命令和响应的表格中，省略了，仅显示 命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 27 LTE Standard(U)系列 MMS 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QMMSCFG 配置 MMS 的参数 该命令用于配置 PDP 上下文 ID、MMSC、代理、字符类型以及其他 MMS 参数。 AT+QMMSCFG 配置 MMS 的参数 测试命令 AT+QMMSCFG=? 响应 +QMMSCFG: 'contextid',(支持的范围) +QMMSCFG: 'mmsc', +QMMSCFG: 'proxy',,(支持的范 围) +QMMSCFG: 'character',(支持的列表) +QMMSCFG: 'sendparam'[,( 支 持 的 范 围),(支持的范围),(支持的列表),(支持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范围)] +QMMSCFG: 'supportfield',(支持的列表) 查询命令 AT+QMMSCFG? 设置命令 AT+QMMSCFG='contextid'[,] OK 响应 OK 响应 若省略可选参数，则查询当前配置： +QMMSCFG: 'contextid', 设置命令 AT+QMMSCFG='mmsc'[,] OK 若指定可选参数，则设置 MMS 的 PDP 上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： 上海移远通信技术股份有限公司 9 / 27 LTE Standard(U)系列 MMS 应用指导 +QMMSCFG: 'mmsc', OK 若指定可选参数，则设置 MMSC 的 URL： OK 设置命令 AT+QMMSCFG='proxy'[,,] 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMMSCFG: 'proxy',, OK 若指定可选参数，则配置代理网关和端口： OK 设置命令 AT+QMMSCFG='character'[,] 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMMSCFG: 'character', OK 若指定可选参数，则设置字符类型： OK 设置命令 AT+QMMSCFG='sendparam'[,,, ,,,] 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMMSCFG: 'sendparam',,,,, , OK 若指定可选参数，则设置 sendparam 属性： OK 或者 +CME ERROR: 上海移远通信技术股份有限公司 10 / 27 LTE Standard(U)系列 MMS 应用指导 设置命令 AT+QMMSCFG='supportfield'[,] 最大响应时间 特性说明 响应 若省略可选参数，则查询当前配置： +QMMSCFG: 'supportfield', OK 若指定可选参数，则设置 supportfield 属性： OK 或者 +CME ERROR: 300 毫秒 该命令立即生效 参数配置不保存 参数 整型。表示 PDP 上下文 ID。范围：1~7；默认值：1。若当前使用模块为 EC200D 系列， 范围：1~11。 字符串类型。表示 MMSC 的地址。URL 的最大长度为 248 个字节。 字符串类型。表示 MMS 代理的 IP 地址。网关的最大长度为 248 个字节。 整型。表示 MMS 代理端口。范围：1~65535；默认值：80。 字符串类型。字符集的类型。 'ASCII' US-ASCII 字符集 'UTF8' UTF8 字符集 'UCS2' ISO-10646-UCS-2 字符集，需指定大端顺序 'GBK' GBK 字符集 整型。MMS 消息的有效期。 0 1 小时 1 12 小时 2 24 小时 3 2天 4 1周 5 一直有效 6 取决于网络配置 整型。MMS 消息的优先级。 0 低 1 正常 2 高 3 取决于网络配置 整型。是否提供报告。 0 不提供 1 提供 上海移远通信技术股份有限公司 11 / 27 LTE Standard(U)系列 MMS 应用指导 整型。是否读取报告。 0 不读取 1 读取 整型。是否隐藏地址。 0 隐藏所有地址 1 显示所有地址，包括密件抄送地址 2 取决于网络配置 整型。MMS 消息的类别。 0 个人类 1 广告类 2 信息类 3 自动 4 取决于网络配置 整型。是否添加 MMS x-up-calling-id 的头选项。 0 不添加 1 添加 操作的错误码。请参考第 5 章。 2.3.2. AT+QMMSEDIT 编辑 MMS 消息 该命令用于添加收件人地址、编辑标题并添加 MMS 消息的附件。标题或文本文件的字符集需先由 AT+ QMMSCFG='character',设置。例如，如文本文件的内容使用 UTF8 字符集，则必须先执行 AT+QMMSCFG='character','UTF8'。 AT+QMMSEDIT 编辑 MMS 消息 测试命令 AT+QMMSEDIT=? 响应 +QMMSEDIT: ( 支 持 的 范 围 ) ( 支 持 的 列表), 查询命令 AT+QMMSEDIT? 设置命令 AT+QMMSEDIT=[,[,]] OK 响应 OK 响应 1) 若省略可选参数： 当不为 0 或 4 时，表示查询的 指定设置： [+QMMSEDIT: ,]列表 OK 或者 +CME ERROR: 当=4 时，表示查询的指定设置： 上海移远通信技术股份有限公司 12 / 27 LTE Standard(U)系列 MMS 应用指导 最大响应时间 特性说明 [+QMMSEDIT: ,,] 列表 OK 或者 +CME ERROR: 当=0 时，删除有关 MMS 消息的所有内容： OK 或者 +CME ERROR: 2) 若指定任意可选参数： 当=0 时，需省略， 表示删除的指定设置： OK 或者 +CME ERROR: 当=1 时，不可省 略，表示设置的指定设置： OK 或者 +CME ERROR: 300 毫秒 该命令立即生效 参数配置不保存 参数 整型。操作功能。 0 删除所有 1 添加收件人 2 添加抄送收件人 3 添加密件抄送收件人 4 添加标题 5 添加文件作为附件 整型。使能/关闭功能。 0 删除的指定设置 1 设置的指定设置 上海移远通信技术股份有限公司 13 / 27 LTE Standard(U)系列 MMS 应用指导 字符串类型。字符集的类型。 'ASCII' US-ASCII 字符集 'UTF8' UTF8 字符集 'UCS2' ISO-10646-UCS-2 字符集，需要指定大端顺序 'GBK' GBK 字符集 字符串类型。 如果=1、2 或 3，则为收件人。收件人、抄送收件人和密件抄送收 件人的最大数量为 6；最大长度为 128 个字节。 如果=4，则为标题。标题的最大长度为 256 个字节。 如果=5，则为附件的文件名。如果文件名以'UFS'、'SFS'、'EFS'、 或'SD'开头，则表示文件分别来自'UFS'、'SFS'、'EFS'、或'SD'卡。文件名 的最大长度为 128 个字节，最大附件数为 12，附件总大小由运营商限制。 操作的错误码。请参考第 5 章。 备注 1. 不同模块实际支持的存储媒介（文件类型）有所差异，详细信息请参考文档 [3]。 2. ECx00G 系列模块 SD 卡功能可选，详情请咨询移远通信技术支持。 2.3.3. AT+QMMSEND 发送 MMS 消息 该命令用于发送 MMS 消息。在返回+QMMSEND: ,[,]之前，客户不得重新 执行 AT+QMMSEND。当达到时，如果 MMS 消息的发送过程尚未完成，则 MMS 发送将被中断。 AT+QMMSEND 发送 MMS 消息 测试命令 AT+QMMSEND=? 响应 +QMMSEND: (支持的范围) 查询命令 AT+QMMSEND? 设置命令 AT+QMMSEND= OK 响应 OK 响应 OK 最大响应时间 特性说明 +QMMSEND: ,[,] 或者 +CME ERROR: 300 毫秒 该命令立即生效 参数配置不保存 上海移远通信技术股份有限公司 14 / 27 LTE Standard(U)系列 MMS 应用指导 参数 整型。发送 MMS 消息的最长时间。范围：1~65535；单位：秒。 整型。HTTP(S)的响应码，仅供参考。例如，200 表示 HTTP(S)成功发布数据，详情请 参考第 6 章。 字符串类型。MMS 消息发送失败时，来自 MMSC 的响应字符串，仅供参考。 为 0 表示 MMS 消息发送成功。否则，表示操作错误码。详情请参考第 5 章。 上海移远通信技术股份有限公司 15 / 27 LTE Standard(U)系列 MMS 应用指导 3 举例 3.1. 添加收件人 //添加电话号码或电子邮件地址作为收件人。收件人的最大数量为 6。 AT+QMMSEDIT=1,1,'13856122546' //将电话号码添加为收件人。 OK AT+QMMSEDIT=1,1,'recipient .test@quectel.com' OK AT+QMMSEDIT=1 +QMMSEDIT: 1,'13856122546' +QMMSEDIT: 1,'recipient.test@quectel.com' //将电子邮件地址添加为收件人。 //查询收件人地址。 OK //通过执行 AT+QMMSEDIT=1,0 删除收件人。 AT+QMMSEDIT=1,0 OK AT+QMMSEDIT=1 OK //删除收件人。 //查询收件人地址。 3.2. 添加抄送收件人或密件抄送收件人 //添加抄送收件人与添加密件收件人操作不同。对于抄送收件人，值为 2。对于密件抄送收件人， 值为 3。 AT+QMMSEDIT=2,1,'13856122546' //将电话号码添加为抄送收件人。 OK AT+QMMSEDIT=2 //查询抄送收件人地址。 +QMMSEDIT: 2,'13856122546' OK 通过执行 AT+QMMSEDIT=2,0 删除收件人。 AT+QMMSEDIT=2,0 OK AT+QMMSEDIT=2 //删除抄送收件人。 //查询抄送收件人地址。 上海移远通信技术股份有限公司 16 / 27 LTE Standard(U)系列 MMS 应用指导 OK 3.3. 编辑 MMS 消息标题 //标题的字符集由 AT+QMMSCFG='character',设置。如果为 ASCII，则添加如下标 题： AT+QMMSCFG='character','ASCII' //将标题的字符集设置为'ASCII'。 OK AT+QMMSEDIT=4,1,'test EC200U mms' //编辑 MMS 消息的标题。 OK AT+QMMSEDIT=4 //查询MMS消息的标题。 +QMMSEDIT: 4,'ASCII','test EC200U mms' OK //如果不是 ASCII，则输入数据应为十六进制字符串。 AT+QMMSCFG='character', 'UTF8' //将字符集设置为'UTF8'。 OK AT+QMMSEDIT=4,1,'7465737420454332303055206D6D73' //编辑MMS消息标题。 OK '7465737420454332303055206D6D73' 为UTF8字符集文本内容'test EC200U mms'的十六进制字符串。 AT+QMMSEDIT=4 //查询MMS消息的标题。 +QMMSEDIT: 4,'UTF8','7465737420454332303055206D6D73' OK //通过执行 AT+QMMSEDIT=4,0 删除标题 AT+QMMSEDIT=4,0 OK AT+QMMSEDIT=4 //删除 MMS 消息的标题。 //查询MMS消息的标题。 OK 3.4. 添加附件 //客户可以为 MMS 邮件添加附件。附件可以是 UFS、SFS、EFS、或 SD 文件。不同模块实际支持的存储 媒介（文件类型）有所差异，详细信息请参考文档 [3]。附件的最大数为 12，文件名的最大长度为 128 字 节。附件总大小可能会受到运营商的限制。在下面的示例中，附件是一个 UFS 文本文件： AT+QFUPL='UFS:test_mms.txt',100,200,1 //将文件上传到UFS。该文件将另存为test_mms.txt， 文件最大为100字节。200表示上传文件的等待时间，1 表示开启ACK模式，详情请参考文档 [3] 。 上海移远通信技术股份有限公司 17 / 27 LTE Standard(U)系列 MMS 应用指导 CONNECT +QFUPL: 100,612c OK AT+QFLST='UFS:*' +QFLST: 'UFS:test_mms.txt',100 //查询UFS的文件列表。 OK AT+QMMSCFG='character','ASCII' OK AT+QMMSEDIT=5,1,'UFS:test_mms.txt' OK AT+QMMSEDIT=5 +QMMSEDIT: 5,'UFS:test_mms.txt' //将 UFS: test_mms.txt 的字符集设置为 ASCII。 //添加 MMS 消息的附件。 //查询附件 OK //在以下示例中，附件是 UFS JPG 文件： AT+QFUPL='UFS:test_pic.jpg',200,300,1 CONNECT +QFUPL: 200,0000 //将文件上传到UFS。该文件将另存为test_pic.jpg，文件最 大为200个字节。300表示上传文件的等待时间，1表示开 启ACK模式。详情请参考文档 [3]。 OK AT+QFLST='UFS:*' +QFLST: 'UFS:test_mms.txt',100 +QFLST: 'UFS:test_pic.jpg',200 //查询UFS的文件列表。 OK AT+QMMSEDIT=5,1,'UFS:test_pic.jpg' OK AT+QMMSEDIT=5 +QMMSEDIT: 5,'UFS:test_mms.txt' +QMMSEDIT: 5,'UFS:test_pic.jpg' //UFS: test_pic.jpg 不是文本文件。无需指定字符集。 //查询附件。 OK //通过执行 AT+QMMSEDIT=5,0 删除附件。 AT+QMMSEDIT=5,0 //删除 MMS 消息的附件。所有附件将被删除。 OK AT+QMMSEDIT=5 //查询附件。 OK //成功发送 MMS 消息后，UFS 文件应通过 AT+QFDEL 删除。 AT+QFDEL='UFS:test_mms.txt' //删除 UFS 文件。 上海移远通信技术股份有限公司 18 / 27 OK AT+QFDEL='UFS:test_pic.jpg' OK AT+QFLST='UFS:*' OK LTE Standard(U)系列 MMS 应用指导 //删除 UFS 文件。 //查询UFS的文件列表。 3.5. 清除 MMS 消息的所有内容 //通过 AT+QMMSEDIT=0 删除 MMS 信息的内容、收件人、抄送收件人、密件抄送收件人、标题和附件。 AT+QMMSEDIT=0 //清除 MMS 消息的所有内容。 OK AT+QMMSEDIT=1 //查询收件人。 OK AT+QMMSEDIT=2 //查询抄送收件人。 OK AT+QMMSEDIT=3 //查询密件抄送收件人。 OK AT+QMMSEDIT=4 //查询MMS消息的标题。 OK AT+QMMSEDIT=5 //查询附件。 OK 3.6. 发送 MMS 消息操作流程 //步骤一：配置和激活 PDP 上下文 ID AT+QICSGP=1,1,'UNIWAP','' ,'',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK AT+QMMSCFG='contextid',1 OK AT+QMMSCFG='contextid' +QMMSCFG: 'contextid',1 //配置 PDP 上下文 1，中国联通的 APN 为 'UNIWAP'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文的状态。 //将PDP上下文ID设置为1。必须先激活PDP上下文 ID。 //查询PDP上下文ID。 上海移远通信技术股份有限公司 19 / 27 LTE Standard(U)系列 MMS 应用指导 OK //步骤 2：配置 MMSC 的 URL 和代理 AT+QMMSCFG='mmsc','mmsc.myuni.com' OK AT+QMMSCFG='mmsc' +QMMSCFG: 'mmsc','http://mmsc.myuni.com' //配置 MMSC 的 URL。'mmsc.myuni.com'适用 于中国联通。 //查询MMSC的URL。 OK AT+QMMSCFG='proxy','10.0.0.172',80 OK AT+QMMSCFG='proxy' +QMMSCFG: 'proxy','10.0.0.172',80 //配置 MMSC 的代理地址和端口。 '10.0.0.172:80'适用于中国联通。 //查询 MMSC 的代理地址和端口。 OK //步骤 3：配置发送 MMS 需使用的参数 AT+QMMSCFG='sendparam',6,2,0,0,2,4 OK AT+QMMSCFG='sendparam' +QMMSCFG: 'sendparam',6,2,0,0,2,4 //配置参数。 //查询配置参数。 OK //步骤 4：编辑 MMS 消息。 AT+QMMSEDIT=1,1,'13856122546' OK AT+QMMSEDIT=2,1,'copy.test@quectel.com' OK AT+QMMSEDIT=3,1,'secret.test@quectel.com' OK AT+QMMSEDIT=1 +QMMSEDIT: 1,'13856122546' //将电话号码添加为收件人。 //添加抄送收件人电子邮件地址。 //添加密件抄送收件人电子邮件地址。 //查询收件人地址。 OK AT+QMMSEDIT=2 +QMMSEDIT: 2,'copy.test@quectel.com' //查询抄送收件人地址。 OK AT+QMMSEDIT=3 +QMMSEDIT: 3,'secret.test@quectel.com' //查询密件抄送收件人地址。 OK AT+QMMSCFG='character','ASCII' OK //将字符类型配置为 ASCII 标题。 上海移远通信技术股份有限公司 20 / 27 LTE Standard(U)系列 MMS 应用指导 AT+QMMSEDIT=4,1,'test EC200U mms' OK AT+QMMSEDIT=4 +QMMSEDIT: 4,'ASCII','test EC200U mms' //编辑 MMS 消息的标题。 //查询MMS消息的标题。 OK //添加附件 AT+QFUPL='UFS:test.txt',100,300,1 CONNECT +QFUPL: 100,612c //将文件上传到UFS。该文件将另存为test.txt，文件 最大为100个字节。300表示上传文件的等待时间， 1表示开启ACK模式。详情请参考文档 [3]。 OK AT+QFLST='UFS:*' +QFLST: 'UFS:test.txt',100 //查询UFS的文件列表。 OK AT+QMMSCFG='character','ASCII' OK AT+QMMSEDIT=5,1,'UFS:test.txt' OK AT+QMMSEDIT=5 +QMMSEDIT: 5,'UFS:test.txt' //将 UFS:test.txt 的字符类型配置为 ASCII。 //添加 MMS 消息的附件。test.txt 是一个 UFS 文件。 //查询附件。 OK AT+QFUPL='UFS:test_pic.jpg',200,300,1 CONNECT +QFUPL: 200,0000 //将文件上传到UFS。该文件将另存为test_pic.jpg， 文件最大为200个字节。300表示上传文件的等待时 间，1表示开启ACK模式。详情请参考文档 [3]。 OK AT+QFLST='UFS:*' +QFLST: 'UFS:test.txt',100 +QFLST: 'UFS:test_pic.jpg',200 //查询UFS的文件列表。 OK AT+QMMSEDIT=5,1,'UFS:test_pic.jpg' OK AT+QMMSEDIT=5 +QMMSEDIT: 5,'UFS:test.txt' +QMMSEDIT: 5,'UFS:test_pic.jpg' //UFS:test_pic.jpg 不是文本文件。无需指定字符集。 //查询附件。 上海移远通信技术股份有限公司 21 / 27 OK //步骤五：发送MMS消息 AT+QMMSEND=100 OK +QMMSEND: 0,200 //步骤六：清除MMS消息的内容。 AT+QMMSEDIT=0 OK AT+QFDEL='UFS:test.txt' OK AT+QFDEL='UFS:test_pic.jpg' OK LTE Standard(U)系列 MMS 应用指导 //发送 MMS 消息。 //表示发送MMS消息的结果。 //清除 MMS 消息的内容。 //删除UFS文件。 //删除UFS文件。 上海移远通信技术股份有限公司 22 / 27 LTE Standard(U)系列 MMS 应用指导 4 异常处理 4.1. 执行 MMS AT 命令失败 在执行 MMS AT 命令时，如果从模块收到响应 ERROR，请检查是否已插入(U)SIM 卡，并且在执行 AT+CPIN?时是否返回了+CPIN：READY。 4.2. PDP 激活失败 如果通过 AT+QIACT 激活 PDP 上下文失败，请检查以下配置： 1. 通过 AT+CGATT ?查询是否 PS 域已附着。如果没有，请执行 AT+CGATT=1 附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保 PS 域已注册。 3. 通过 AT+QICSGP 查询 PDP 上下文参数，并确保已设置指定 PDP 上下文的 APN。 4. 确保指定的 PDP 上下文 ID 既不被 PPP 使用，也不被 AT+CGACT 激活。 5. 确保激活的 PDP 上下文数量符合要求。模块支持单(U)SIM 卡时，若启用 VoLTE 功能，最多可激 活 5 路 PDP 上下文；若禁用或不支持 VoLTE 功能，最多可激活 7 路 PDP 上下文。实际能激活的 PDP 上下文个数取决于(U)SIM 卡数量。 如果以上所有配置均正确，但是通过 AT+QIACT 激活 PDP 上下文仍然失败，请重新启动模块以解决 此问题。重新启动模块后，请检查上述配置至少三次，每次检查间隔为 10 分钟，以避免频繁重启模块。 4.3. AT+QMMSEND 的错误响应 执行 AT+QMMSEND 后将返回+QMMSEND: ,[,]。如果不为 0，则表 示 MMS 消息发送失败，请重新发送。如果重新发送仍失败，请通过 AT+QIDEACT 去激活 PDP 上下文， 然后通过 AT+QIACT 重新激活，然后再次发送 MMS 消息。 上海移远通信技术股份有限公司 23 / 27 LTE Standard(U)系列 MMS 应用指导 5 错误码 错误码表示与移动设备或网络有关的错误码。下表描述了有关的详细信息。 表 3：错误码 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 英文含义 Unknown error URL length error URL error Invalid proxy type Proxy address error Invalid parameter Recipient address full CC recipient address full BCC recipient address full Attachments full File error No recipient File not found MMS busy Server response failed Invalid report of HTTP(S) post Error response of HTTP(S) post PDP activation failed 中文含义 未知错误 URL 长度错误 URL 错误 无效代理类型 代理地址错误 无效参数 收件人地址已满 抄送收件人地址已满 密送收件人地址已满 附件已满 文件错误 无收件人 未发现文件 MMS 忙 服务器响应失败 无效 HTTP(S) post 上报 HTTP(S) post 响应错误 PDP 激活失败 上海移远通信技术股份有限公司 24 / 27 LTE Standard(U)系列 MMS 应用指导 769 PDP deactivated PDP 去激活 770 Failed to create socket 套接字创建失败 771 Failed to connect socket 套接字连接失败 772 Failed to read socket 套接字读取失败 773 Failed to write socket 套接字写入失败 774 Socket closed 套接字关闭 775 Timeout 超时 776 Encode data error 编码数据错误 777 HTTP(S) decode data error HTTP(S)编码数据错误 778 OUT_OF_MEM 内存不足 上海移远通信技术股份有限公司 25 / 27 LTE Standard(U)系列 MMS 应用指导 6 HTTP(S)响应码 HTTP(S)协议响应码表示 MMSC 的响应。有关详情，请参阅 RFC2616（超文本传输协议 -HTTP/1.1）。下表描述了有关的详细信息。 表 4：HTTP(S)响应码 200 400 403 404 409 411 500 502 英文含义 OK Bad request Forbidden Not found Conflict Length required Internal server error Bad gate way 中文含义 执行成功 请求失败 禁止访问 未发现 冲突 需要输入长度 内部服务器错误 网关错误 上海移远通信技术股份有限公司 26 / 27 LTE Standard(U)系列 MMS 应用指导 7 附录 参考文档和术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard(U)系列_TCP(IP)_应用指导 [2] Quectel_LTE_Standard(U)系列_AT 命令手册 [3] Quectel_LTE_Standard(U)系列_FILE_应用指导 表 6：术语缩写 缩写 APN BCC CC HTTP MMS MMSC PDP QoS SD TA UFS URL 英文全称 中文全称 Access Point Name 接入点名称 Blind Carbon Copy 密件抄送 Carbon Copy 抄送 Hypertext Transfer Protocol 超文本传输协议 Multimedia Messaging Service 多媒体信息服务（彩信） Multimedia Messaging Service Center 多媒体信息服务中心 Packet Data Protocol 分组数据协议 Quality of Service 服务质量 Secure Digital 安全数字 Terminal Adapter 终端适配器 User File Storage 用户文件存储 Uniform Resource Locator 统一资源定位符 上海移远通信技术股份有限公司 27 / 27

LG69T (AM,AP) DR&RTK Application Note GNSS Module Series Version: 1.0 Date: 2023-08-10 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LC69T(AM,AP)_DR&RTK_Application_Note 1 / 31 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved LC69T(AM,AP)_DR&RTK_Application_Note 2 / 31 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LG69T (AM,AP) DR&RTK Application Note GNSS Module Series Application Note Released Revision History Version 1.0.0 Date 2023-06-12 2023-08-10 Description Creation of the document First official release LC69T(AM,AP)_DR&RTK_Application_Note 3 / 31 GNSS Module Series Contents About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 6 Figure Index ................................................................................................................................................. 7 1 Introduction .......................................................................................................................................... 8 1.1. Overview on DR .......................................................................................................................... 8 1.2. Overview on RTK ........................................................................................................................ 9 2 Configuration...................................................................................................................................... 10 2.1. DR Configuration....................................................................................................................... 10 2.1.1. Orientation...................................................................................................................... 10 2.1.2. Mounting......................................................................................................................... 11 2.1.3. DR Calibration ................................................................................................................ 12 3 RTK Input ............................................................................................................................................ 14 4 PQTM Messages................................................................................................................................. 15 4.1. PQTMPVT ................................................................................................................................. 15 4.2. PQTMDRPVA............................................................................................................................ 17 4.3. PQTMSENMSG ........................................................................................................................ 19 4.3.1. When = 2 ...................................................................................................... 20 4.4. PQTMVEHMSG ........................................................................................................................ 21 4.4.1. When = 1.................................................................................................... 21 4.5. PQTMCFGCAN......................................................................................................................... 22 4.6. PQTMCFGCANFILTER ............................................................................................................ 23 4.7. PQTMCFGVEHDBC ................................................................................................................. 25 4.8. PQTMCFGVEHRVAL................................................................................................................ 27 4.9. PQTMCFGLA............................................................................................................................ 28 5 Appendix A References..................................................................................................................... 30 6 Appendix B Special Characters ....................................................................................................... 32 LC69T(AM,AP)_DR&RTK_Application_Note 4 / 31 GNSS Module Series Table Index Table 1: Supported RTCM Input Messages ............................................................................................... 14 Table 2: Error Code .................................................................................................................................... 15 Table 3: Related Documents ...................................................................................................................... 30 Table 4: Terms and Abbreviations .............................................................................................................. 30 Table 5: Special Characters ....................................................................................................................... 32 LC69T(AM,AP)_DR&RTK_Application_Note 5 / 31 GNSS Module Series Figure Index Figure 1: Four-Wheel Vehicle....................................................................................................................... 8 Figure 2: RTK Schematic Diagram .............................................................................................................. 9 Figure 3: Reference Frame ........................................................................................................................ 10 Figure 4: IMU Reference Frame .................................................................................................................11 Figure 5: Installation Yaw Angle ..................................................................................................................11 Figure 6: Installation Pitch Angle................................................................................................................ 12 Figure 7: Installation Roll Angle.................................................................................................................. 12 LC69T(AM,AP)_DR&RTK_Application_Note 6 / 31 GNSS Module Series 1 Introduction This document describes the dead reckoning (DR) and real-time kinematic (RTK) features, including orientation, mounting, calibration, and messages related to DR and RTK of Quectel LG69T (AM) and LG69T (AP). The supported features on each module are as follows: ⚫ LG69T (AM) supports RTK only. ⚫ LG69T (AP) supports DR and RTK. The modules are recommended for use in four-wheel vehicle. Figure 1: Four-Wheel Vehicle 1.1. Overview on DR Quectel LG69T (AP) supports the ADR mode, where the module utilizes speed data from the vehicle and the onboard 6-axis sensor to enhance accuracy in environments without GNSS coverage. The module obtains vehicle speed data through CAN interface, supporting receiving data that conforms to ISO11898-1 standard. The vehicle speed requirement includes a minimum injection frequency of 10 Hz, delay below 10 ms, and speed RMS below 0.5 m/s. LC69T(AM,AP)_DR&RTK_Application_Note 7 / 31 GNSS Module Series 1.2. Overview on RTK Quectel offers high-precision RTK positioning products that support multiple GNSS constellations and frequencies, enabling centimeter-level accuracy. RTK (Real Time Kinematic) is a real-time differential GPS (RTDGPS) technology based on carrier phase observations. It consists of three components: a base station (which may be an actual satellite receiver or a virtual reference station (VRS), differential correction data link, and rover. The base station continuously observes GNSS satellites, and transmits its observation data and station information to the rover in real-time through a data transmission network. While receiving GNSS satellite signals, the rover uses the data transmitted by the base station through wireless receiving equipment to calculate its three-dimensional coordinates in real-time relative to the base station, using the principle of relative positioning. Base Station Rover Figure 2: RTK Schematic Diagram LC69T(AM,AP)_DR&RTK_Application_Note 8 / 31 GNSS Module Series 2 Configuration 2.1. DR Configuration 2.1.1. Orientation The LG69T (AP) modules are specifically designed for use in four-wheel vehicles. Module with GNSS and motion sensor ICs must be firmly and securely fixed to vehicle body. No relative movement is allowed between vehicle and device, and maximum isolation from both shock and vibration must be provided. Manually holding the board is not accepted. The recommended installation method is to firmly screw the device down to the vehicle frame. Mounting location should allow easy access to power supply and GNSS antenna, while avoiding exposure to excessive heat. The reference frame axes definitions are as follows: ⚫ The X-axis points towards the right side of the vehicle. ⚫ The Y-axis points towards the front of the vehicle. ⚫ The Z-axis points upwards from the vehicle. Z Y Figure 3: Reference Frame LC69T(AM,AP)_DR&RTK_Application_Note 9 / 31 The IMU reference frame of the module is shown below: Z GNSS Module Series Figure 4: IMU Reference Frame 2.1.2. Mounting When mounting the Quectel LG69T (AP) module on the vehicle: 1) Firmly attach LG69T (AP) to the vehicle body, preferably as close to the center of the rear wheel as possible. 2) The default installation of LG69T (AP) should be horizontal, aligning the X/Y axis of the module with the X/Y axis of the vehicle body as closely as possible, and ensuring the misalignment angles (α, β, γ) are less than 10°. 3) Avoid misalignment angles (α, β, γ) greater than 30°. X Y Figure 5: Installation Yaw Angle LC69T(AM,AP)_DR&RTK_Application_Note 10 / 31 GNSS Module Series Y β -β Figure 6: Installation Pitch Angle γ -γ Figure 7: Installation Roll Angle NOTE Firmly affix the module to the vehicle body. Select a structurally sound location that is not prone to flexing. 2.1.3. DR Calibration To ensure accurate functioning of the dead reckoning functionality, the module requires calibration. Follow the steps below for DR calibration: Step 1: Fix the module on the vehicle frame firmly. Any displacement, rotation or tilt of the device relative to the vehicle plane, however small, may cause performance issues and/or void calibration. Step 2: Calibration should be performed under good GNSS signal and clear sky conditions. Step 3: Power up the module, then start the vehicle on a plain surface. LC69T(AM,AP)_DR&RTK_Application_Note 11 / 31 GNSS Module Series Step 4: Drive at a speed of more than 2.5 m/s, and preferably perform at least 1 turning movement. Then, the module will start self-calibration, which will be completed in 2 minutes. Step 5: Once the calibration process is completed, the module immediately outputs the $PQTMDRPVA message. See Chapter 4.2 PQTMDRPVA for details about the message. After the calibration, there is no limit to driving trajectory and driving dynamics, and you can perform verification tests in the following scenarios: 1) Open sky area, urban main road (good satellite signal). 2) Urban tunnels (absence of satellite signal). 3) Urban viaduct (weak satellite signal). 4) Underground vehicle park (absence of satellite signal). 5) Areas surrounded with dense buildings (multi-path in urban canyon). 6) City boulevards (weak satellite signal). 7) High-rise dense area (severe urban canyon multipath). NOTE 1. $PQTMDRPVA is only output when calibration process is completed. 2. The standard NMEA message has a fixed output frequency of 1 Hz, however the GGA, RMC, GST and VTG output frequency will shift to 10 Hz after the DR calibration procedure is completed. The combination of $PQTMCFGFIXRATE and $PQTMCFGMSGRATE can be used to configure the output frequency of standard NMEA message. For more details about these commands, see document [1] protocol specification. LC69T(AM,AP)_DR&RTK_Application_Note 12 / 31 GNSS Module Series 3 RTK Input Quectel LG69T (AM) and LG69T (AP) modules support the RTCM 10403.3 input messages listed in table below. Table 1: Supported RTCM Input Messages Message Type 1005 1006 1074 1077 1094 1097 1114 1117 1124 1127 Description Stationary RTK Reference Station ARP Stationary RTK Reference Station ARP with Antenna Height GPS MSM4 GPS MSM7 Galileo MSM4 Galileo MSM7 QZSS MSM4 QZSS MSM7 BDS MSM4 BDS MSM7 LC69T(AM,AP)_DR&RTK_Application_Note 13 / 31 GNSS Module Series 4 PQTM Messages This chapter outlines the PQTM messages (proprietary NMEA messages defined by Quectel) for DR function, which are supported by LG69T (AP). Table 2: Error Code Field Format Unit Numeric - Description Error code. 1 = Invalid parameters. 2 = Failed execution. 4.1. PQTMPVT Outputs the PVT (GNSS-only) result. Type: Output Synopsis: $PQTMPVT,,,,,,,,,,< Lon>,,,,,,,,,* Parameter: Field Format Numeric Numeric yyyymmdd Unit Description Message version. - 1 = Version 1 (Always 1 for this version.) Millisecond Time of week. UTC date. yyyy: Year mm: Month dd: Day of month LC69T(AM,AP)_DR&RTK_Application_Note 14 / 31 GNSS Module Series Field Format Unit hhmmss.sss - Numeric - Numeric - Numeric Numeric Second Numeric Degree Numeric Degree Numeric Meter Numeric Meter Description UTC time. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds GPS quality indicator. 0 = Fix not available or invalid. 1 = GPS SPS mode, fix valid. 2 = Differential GPS, SPS mode, or Satellite Based Augmentation. System (SBAS), fix valid. 3 = GPS PPS mode, fix valid. 4 = Real Time Kinematic (RTK) System used in RTK mode with fixed integers. 5 = Float RTK. Satellite system used in RTK mode, floating integers. 6 = Estimated (DR) mode. Note that this field is the same as in GGA. Fix mode. 0 = No fix. 1 = Reserved. 2 = 2D fix. 3 = 3D fix. Number of satellites in use. Leap seconds. Note that this field is empty in case of an invalid value. Latitude. Note that this field is empty in case of an invalid value. Longitude. Note that this field is empty in case of an invalid value. Altitude above mean-sea-level. Note that this field is empty in case of an invalid value. Geoidal separation (the difference between the WGS84 earth ellipsoid surface and the mean-sea-level surface). Note that this field is empty in case of an invalid value. LC69T(AM,AP)_DR&RTK_Application_Note 15 / 31 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit m/s m/s m/s m/s Degree - Description North velocity. Note that this field is empty in case of an invalid value. East velocity. Note that this field is empty in case of an invalid value. Down velocity. Note that this field is empty in case of an invalid value. Ground speed. Note that this field is empty in case of an invalid value. Heading. Note that this field is empty in case of an invalid value. Range: 0.00–360.00 Horizontal dilution of precision. Note that the value is 99.99 in case of an invalid value. Position (3D) dilution of precision. Note that the value is 99.99 in case of an invalid value. Example: //No fix. $PQTMPVT,1,1000,20221225,163355.000,0,0,00,,,,,,,,,,,99.99,99.99*49 //3D fix. $PQTMPVT,1,31075000,20221225,083737.000,4,3,09,18,31.12738291,117.26372910,34.212,5.267,3.2 12,2.928,0.238,4.346,34.12,2.16,4.38*65 4.2. PQTMDRPVA Outputs the DR position, velocity and attitude. Type: Output LC69T(AM,AP)_DR&RTK_Application_Note 16 / 31 GNSS Module Series Synopsis: $PQTMDRPVA,,,,,,,,,,,< VelD>,,,* Parameter: Field Format Numeric Numeric hhmmss.sss Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Millisecond - - Degree Degree Meter Meter m/s m/s m/s m/s Degree Description Message version. 1 = Version 1 (Always 1 for this version.) Milliseconds since module startup. 32-bit unsigned integer. UTC time. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds Solution type. 0 = No fix. 1 = GNSS only. 2 = GNSS + DR. 3 = DR only. Latitude. Note that this field is empty in case of an invalid value. Longitude. Note that this field is empty in case of an invalid value. Altitude above mean-sea-level. Note that this field is empty in case of an invalid value. Geoidal separation (the difference between the WGS84 earth ellipsoid surface and the mean-sea-level surface). Note that this field is empty in case of an invalid value. North velocity. Note that this field is empty in case of an invalid value. East velocity. Note that this field is empty in case of an invalid value. Down velocity. Note that this field is empty in case of an invalid value. Ground speed. Note that this field is empty in case of an invalid value. Roll angle. Note that this field is empty in case of an invalid value. Range: -180.000000 to 180.000000 LC69T(AM,AP)_DR&RTK_Application_Note 17 / 31 GNSS Module Series Field Format Numeric Numeric Unit Degree Degree Description Pitch angle. Note that this field is empty in case of an invalid value. Range: -90.000000 to 90.000000 Heading. Note that this field is empty in case of an invalid value. Range: 0.000000–360.000000 Example: //No fix: $PQTMDRPVA,1,1000,163355.000,0,,,,,,,,,,,*7C //GNSS + DR fix: $PQTMDRPVA,1,75000,083737.000,2,31.12738291,117.26372910,34.212,5.267,3.212,2.928,0.238,4.3 46,0.392663,1.300793,0.030088*5E 4.3. PQTMSENMSG Outputs sensor information. Type: Output Synopsis: $PQTMSENMSG,,[,,…,]* Parameter: Field Format Unit Numeric - to Numeric Numeric - Description Message version. 2 = IMU sensor data. See Figure 4: IMU Reference Frame. Timestamp since power-on. 32-bit unsigned integer. Sensor information. See Chapter 4.3.1 When = 2. LC69T(AM,AP)_DR&RTK_Application_Note 18 / 31 GNSS Module Series 4.3.1. When = 2 This message is used to output the IMU raw data, these values are read directly from the IMU without any filtering. Refer to IMU reference frame. Synopsis: $PQTMSENMSG,2,,,,,,< IMU_ACC_X>,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Description Timestamp since power-on. 32-bit unsigned - integer. °C IMU temperature dps IMU X-axis raw gyroscope value dps IMU Y-axis raw gyroscope value dps IMU Z-axis raw gyroscope value g IMU X-axis raw accelerometer value g IMU Y-axis raw accelerometer value g IMU Z-axis raw accelerometer value Example: $PQTMSENMSG,2,2248864,36.70,0.6118,-0.4064,-0.5419,0.0132,-0.0151,1.0045*34 NOTE 1. $PQTMCFGMSGRATE can be used to enable or disable $PQTMSENMSG message output. For more details about this command, see document [1] protocol specification. //Enable $PQTMSENMSG command: $PQTMCFGMSGRATE,W,PQTMSENMSG,100,2*4C $PQTMCFGMSGRATE,OK*29 //Disable $PQTMSENMSG command: $PQTMCFGMSGRATE,W,PQTMSENMSG,0,2*4D $PQTMCFGMSGRATE,OK*29 LC69T(AM,AP)_DR&RTK_Application_Note 19 / 31 GNSS Module Series 4.4. PQTMVEHMSG Outputs vehicle information. Type: Output Synopsis: $PQTMVEHMSG,,[,,…,]* Parameter: Field Format Unit Numeric - Numeric - to Numeric - Description Message type: 1 = Outputs vehicle speed (in m/s) information via UART interface Timestamp since power-on. 32-bit unsigned integer. This field varies with the message type. See Chapter 4.4.1 When = 1. 4.4.1. When = 1 Synopsis: $PQTMVEHMSG,1,,* Parameter: Field Format Numeric Numeric Unit Description Millisecond Timestamp since power-on. 32-bit unsigned integer. m/s Vehicle speed. Range: -100 to 100. Example: $PQTMVEHMSG,1,3748292,3.6*1D LC69T(AM,AP)_DR&RTK_Application_Note 20 / 31 GNSS Module Series NOTE 1. $PQTMCFGMSGRATE can be used to enable or disable $PQTMVEHMSG message output. For more details about this command, see document [1] protocol specification. //Enable $PQTMVEHMSG command: $PQTMCFGMSGRATE,W,PQTMVEHMSG,1,1*4C $PQTMCFGMSGRATE,OK*29 //Disable $PQTMVEHMSG command: $PQTMCFGMSGRATE,W,PQTMVEHMSG,0,1*4D $PQTMCFGMSGRATE,OK*29 4.5. PQTMCFGCAN Configures CAN interface and baud rate. Type: Set/Get Synopsis: //Set: $PQTMCFGCAN,W,,,,,* //Get: $PQTMCFGCAN,R,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description CAN interface index. - 0 = CAN Enable/disable CAN interface. - 0 = Disable 1 = Enable Frame format of CAN interface. 0 = Classic CAN 1 = CAN FD without bitrate switching 2 = CAN FD with bitrate switching bps Nominal baud rate of CAN interface. LC69T(AM,AP)_DR&RTK_Application_Note 21 / 31 GNSS Module Series Field Format Numeric Unit Description Data baud rate of CAN interface. Note: This field is only valid in CAN FD frame bps format. It can be set to 0 in classic CAN frame format. Result: ⚫ If successful, the module returns: //Set: $PQTMCFGCAN,OK*74 //Get: $PQTMCFGCAN,OK,,,,,*< CR> ⚫ If failed, the module returns: $PQTMCFGCAN,ERROR,* For details about , see Table 2: Error Code. Example: //Sets the CAN interface $PQTMCFGCAN,W,0,1,0,500000,0*45 $PQTMCFGCAN,OK*3E //Gets the configuration of CAN interface $PQTMCFGCAN,R,0*74 $PQTMCFGCAN,OK,0,1,0,500000,0*16 4.6. PQTMCFGCANFILTER Configures the CAN filter. The module only receives messages that match the filtering rules. Type: Set/Get Synopsis: //Set: $PQTMCFGCANFILTER,W,,,,,,,* LC69T(AM,AP)_DR&RTK_Application_Note 22 / 31 GNSS Module Series //Get: $PQTMCFGCANFILTER,R,,* Parameter: Field Format Unit Numeric - Numeric - Numeric - Numeric - Numeric - Hexadecimal - Hexadecimal - Description CAN interface index. 0 = CAN Filter index. 0 = Filter 0 1 = Filter 1 Enable/disable filter. 0 = Disable 1 = Enable Filter type. 0 = Range filter 1 = Dual ID filter 2 = Mask filter Identifier type. 0 = Standard ID 1 = Extended ID Filter identification 1. Range: 0–0x7FF, if is Standard ID Range: 0–0x1FFFFFFF, if is Extended ID Filter identification 2. Range: 0–0x7FF, if is Standard ID Range: 0–0x1FFFFFFF, if is Extended ID Result: ⚫ If successful, the module returns: //Set: $PQTMCFGCANFILTER,OK*3E //Get: $PQTMCFGCANFILTER,OK,,,,,,,* ⚫ If failed, the module returns: $PQTMCFGCANFILTER,ERROR,* For details about , see Table 2: Error Code. LC69T(AM,AP)_DR&RTK_Application_Note 23 / 31 Example: //Sets the CAN filter 0. $PQTMCFGCANFILTER,W,0,0,1,0,0,3E9,1F5*7D $PQTMCFGCANFILTER,OK*3E //Gets the configuration of CAN filter 0 $PQTMCFGCANFILTER,R,0,0*68 $PQTMCFGCANFILTER,OK,0,0,1,1,0,3E9,1F5*2F GNSS Module Series NOTE If the filter type is mask filter ( = 2): ⚫ is the filter ID, and is the mask. ⚫ If a mask bit is set to 1, the corresponding ID bit will be compared with the value of the filter ID bit; and if it matches then the message will be accepted, otherwise the message will be rejected. 4.7. PQTMCFGVEHDBC Configure the vehicle Database for CAN (DBC). Type: Set/Get Synopsis: //Set: $PQTMCFGVEHDBC,W,,,,,,,,,,* //Get: $PQTMCFGVEHDBC,R,* Parameter: Field Format Numeric Numeric Numeric Unit - Description DBC index. 0 = Vehicle speed DBC 1 = Vehicle gear DBC CAN message ID. Start bit of data. LC69T(AM,AP)_DR&RTK_Application_Note 24 / 31 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit - - - Description Bit size of data. Byte order. 0 = Motorola mode (Big endian) 1 = Intel mode (Litter endian) Value type. Not support, always 0 Factor of value. Offset of value. Minimal value. Maximum value. Result: ⚫ If successful, the module returns: //Set: $PQTMCFGVEHDBC,OK*6C //Get: $PQTMCFGVEHDBC,OK,,,,,,,,< Offset>,,* ⚫ If failed, the module returns: $PQTMCFGVEHDBC,ERROR,* For details about , see Table 2: Error Code. Example: //Sets the vehicle speed DBC $PQTMCFGVEHDBC,W,0,3E9,8,16,0,0,0.015625,0,0,300*57 $PQTMCFGVEHDBC,OK*6C //Gets the configuration of vehicle speed DBC $PQTMCFGVEHDBC,R,0*26 $PQTMCFGVEHDBC,OK,0,3E9,8,16,0,0,0.015625,0.000000,0.000000,300.000000*2A LC69T(AM,AP)_DR&RTK_Application_Note 25 / 31 GNSS Module Series 4.8. PQTMCFGVEHRVAL Configures the vehicle reverse gear value based on CAN forward/backward information. Type: Set/Get Synopsis: //Set: $PQTMCFGVEHRVAL,W,* //Get: $PQTMCFGVEHRVAL,R* Parameter: Field Format Numeric Unit Description Vehicle reverse gear value. Range: 0–255 Result: ⚫ If successful, the module returns: //Set: $PQTMCFGVEHRVAL,OK*20 //Get: $PQTMCFGVEHRVAL,OK,* ⚫ If failed, the module returns: $PQTMCFGVEHRVAL,ERROR,* For details about , see Table 2: Error Code. Example: //Set: $PQTMCFGVEHRVAL,W,2*6D $PQTMCFGVEHRVAL,OK*20 //Get: $PQTMCFGVEHRVAL,R*76 $PQTMCFGVEHRVAL,OK,2*3E LC69T(AM,AP)_DR&RTK_Application_Note 26 / 31 GNSS Module Series 4.9. PQTMCFGLA Configures the lever arm. Type: Set/Get Synopsis: //Set: $PQTMCFGLA,W,,,,* //Get: $PQTMCFGLA,R,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit - Meter Meter Meter Description Type of lever arm. 1 = IMU to antenna 1 lever arm. 3 = IMU to user lever arm. Lever arm of X axis. Lever arm of Y axis. Lever arm of Z axis. Result: ⚫ If successful, the module returns: //Set: $PQTMCFGLA,OK* //Get: $PQTMCFGLA,OK,,,,* ⚫ If failed, the module returns: $PQTMCFGLA,ERROR,* For details about , see Table 2: Error Code. Example: $PQTMCFGLA,W,1,0.212,0.514,0.113*31 $PQTMCFGLA,OK*7F LC69T(AM,AP)_DR&RTK_Application_Note 27 / 31 GNSS Module Series NOTE After issuing this command, the module must be restarted for the command to take effect. LC69T(AM,AP)_DR&RTK_Application_Note 28 / 31 GNSS Module Series 5 Appendix A References Table 3: Related Documents Document Name [1] Quectel_LG69T(AM,AP)_GNSS_Protocol_Specification Table 4: Terms and Abbreviations Abbreviation 2D 3D Description 2 Dimension 3 Dimension ADR ARP CAN Automotive Dead Reckoning Antenna Reference Point Controller Area Network CAN FD BDS DBC CAN with Flexible Data rate BeiDou Navigation Satellite System Database for CAN DR GNSS GGA Dead Reckoning Global Navigation Satellite System Global Positioning System Fix Data GPS IMU MSM Global Positioning System Inertial Measurement Unit Multiple Signal Message NMEA NMEA (National Marine Electronics Association) 0183 Interface Standard LC69T(AM,AP)_DR&RTK_Application_Note 29 / 31 Abbreviation PPS PQTM QZSS RMS RTCM RTDGPS RTK SPS UART UTC VRS WGS84 GNSS Module Series Description Pulse Per Second Proprietary Protocol of Quectel Quasi-Zenith Satellite System Root mean square Radio Technical Commission for Maritime Services Real Time Differential Global Positioning System Real-Time Kinematic Standard Positioning Service Universal Asynchronous Receiver/Transmitter Coordinated Universal Time Virtual Reference Station World Geodetic System 1984 LC69T(AM,AP)_DR&RTK_Application_Note 30 / 31 GNSS Module Series 6 Appendix B Special Characters Table 5: Special Characters Special Character […] {…} Underline Description Carriage return character. Line feed character. Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. LC69T(AM,AP)_DR&RTK_Application_Note 31 / 31

LG69T (AM,AP) Moving Base Application Note GNSS Module Series Version: 1.0 Date: 2023-08-02 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LG69T(AM,AP)_Moving_Base_Application_Note 1 / 26 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. LG69T(AM,AP)_Moving_Base_Application_Note 2 / 26 GNSS Module Series Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service, or repair of any terminal or mobile incorporating the module. Manufacturers of the terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all product manuals. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Ensure that the product may be used in the country and the required environment, as well as that it conforms to the local safety and environmental regulations. Keep away from explosive and flammable materials. The use of electronic products in extreme power supply conditions and locations with potentially explosive atmospheres may cause fire and explosion accidents. The product must be powered by a stable voltage source, and the wiring shall conform to security precautions and fire prevention regulations. Proper ESD handling procedures must be followed throughout the mounting, handling and operation of any devices and equipment that incorporate the module to avoid ESD damages. LG69T(AM,AP)_Moving_Base_Application_Note 3 / 26 GNSS Module Series About the Document Document Information Title LG69T (AM,AP) Moving Base Application Note Subtitle GNSS Module Series Document Type Application Note Document Status Released Revision History Version Date Description - 2023-04-24 Creation of the document 1.0 2023-08-02 First official release LG69T(AM,AP)_Moving_Base_Application_Note 4 / 26 GNSS Module Series Contents Safety Information....................................................................................................................................... 3 About the Document ................................................................................................................................... 4 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 6 Figure Index ................................................................................................................................................. 7 1 Introduction .......................................................................................................................................... 8 2 Hardware Design.................................................................................................................................. 9 2.1. Application Interfaces .............................................................................................................. 11 2.1.1. UART Interfaces............................................................................................................. 11 2.1.2. RESET_N....................................................................................................................... 12 2.1.3. SLAVE_RESET_EN....................................................................................................... 13 2.1.4. BOOT ............................................................................................................................. 13 2.1.5. SLAVE_BOOT_EN ........................................................................................................ 14 3 System Construction......................................................................................................................... 15 3.1. Precautions for GNSS Antenna Mounting .............................................................................. 15 3.1.1. Antenna Mounting Method ............................................................................................. 15 3.1.2. Recommended Mounting for GNSS Antennas .............................................................. 16 4 Reference Frame ................................................................................................................................ 17 4.1. Local Cartesian Coordinate System (ENU) ............................................................................ 17 4.2. Vehicle Frame ......................................................................................................................... 18 5 Angle Definition.................................................................................................................................. 19 5.1. Heading ................................................................................................................................... 19 5.2. Pitch......................................................................................................................................... 20 5.3. Roll .......................................................................................................................................... 21 6 Configuration...................................................................................................................................... 22 7 Moving Base Related Message ........................................................................................................ 23 7.1. PQTMTAR Message ............................................................................................................... 23 8 Appendix A References..................................................................................................................... 25 9 Appendix B Special Characters ....................................................................................................... 26 LG69T(AM,AP)_Moving_Base_Application_Note 5 / 26 GNSS Module Series Table Index Table 1: Function Differences for LG69T (AP) Pins in Different Applications ............................................. 9 Table 2: Related Documents...................................................................................................................... 25 Table 3: Terms and Abbreviations ............................................................................................................. 25 Table 4: Special Characters ....................................................................................................................... 26 LG69T(AM,AP)_Moving_Base_Application_Note 6 / 26 GNSS Module Series Figure Index Figure 1: Schematic Diagram of Connection Between Base and Rover................................................... 10 Figure 2: Reference Design of UART1 Interface on Base......................................................................... 11 Figure 3: Reference Design of UART2 Interface on Rover ....................................................................... 12 Figure 4: Reference OC Circuit for Base’s RESET_N............................................................................... 12 Figure 5: Reference OC Circuit for Rover’s RESET_N ............................................................................. 12 Figure 6: Reference Control Circuit for Base’s BOOT ............................................................................... 13 Figure 7: Reference Control Circuit for Rover’s BOOT ............................................................................. 13 Figure 8: Antenna Mounting Top View....................................................................................................... 15 Figure 9: Antenna Mounting (Same Reference Ground Plane) ................................................................ 15 Figure 10: Antenna Mounting – Vehicle..................................................................................................... 16 Figure 11: ENU Coordinate System........................................................................................................... 17 Figure 12: Vehicle Frame ........................................................................................................................... 18 Figure 13: Heading Angle .......................................................................................................................... 19 Figure 14: Pitch Angle ................................................................................................................................ 20 Figure 15: Roll Angle.................................................................................................................................. 21 LG69T(AM,AP)_Moving_Base_Application_Note 7 / 26 GNSS Module Series 1 Introduction This document presents the software and hardware designs of the LG69T (AM) and the LG69T (AP) modules for the use in the Moving Base application. LG69T (AM) supports dual-band precision RTK technology to calculate the heading angle and attitude information and transmit the calculation results to LG69T (AP). LG69T (AP) integrates a 6-axis IMU and supports dual-band precision RTK technology and DR algorithm to output high precision position, heading and attitude information. RTK technology includes the rover and the base. The base sends a continuous differential correction data stream to the rover via a communication link. In standard RTK mode, the base remains static in a known position, while the rover module can move. However, in Moving Base mode, both the base and the rover can move, making it suitable for use in vehicles. To enable the Moving Base function, both the LG69T (AM) and the LG69T (AP) modules must be installed on the same carrier platform. The cm-level accuracy vector between two antennas can be computed via the Moving Base function. This allows for outputting orientation when static on startup and requires no horizontal motion usually required by GNSS to provide Heading. The absolute position accuracy is limited by the positioning mode of the moving base receiver. If the base receiver is in single (autonomous) mode, this will be m-level accuracy. Should cm-level accuracy be required, the moving base also needs to receive RTK corrections from a static base or RTK network. The terms 'base', 'rover,' 'baseline', and 'heading' are used to describe the functionality of the Moving Base. ⚫ Base: Receiver that transmits the different correction data stream. ⚫ Rover: Receiver that receives the different correction data stream. ⚫ Baseline: Vector connecting the base antenna to the rover antenna. The Moving Base function supports baseline lengths varying from 0.3 m to 1.4 m. ⚫ Heading: Angle from true north to baseline measured in a clockwise direction. NOTE LG69T(AM) with firmware version LG69TAMNR01A03S_RQN and LG69T(AP) with firmware version LG69TAPNR01A01S, as well as their later versions, support the Moving Base function. LG69T(AM,AP)_Moving_Base_Application_Note 8 / 26 GNSS Module Series 2 Hardware Design For LG69T (AM) and LG69T (AP) modules, the LG69T (AP) can be used as the base, while the LG69T (AM) can be used as the rover. The base communicates with the MCU via its UART1, while the rover communicates with the base’s UART2 via its UART2. The following schematic diagram illustrates the specific connection configuration: In the Moving Base application, certain pins (pins 16, 17, 28 and 29) function configurations of the LG69T (AP) module are different from those in the general application, as shown in below. Table 1: Function Differences for LG69T (AP) Pins in Different Applications Pin No. General Application Moving Base Application 16 RESERVED SLAVE_BOOT_EN: Controls the BOOT of the rover 17 RESERVED SLAVE_RESET_EN: Controls the RESET_N of the rover 28 RESERVED TXD3: Debugging data 29 RESERVED RXD3: Debugging data LG69T(AM,AP)_Moving_Base_Application_Note 9 / 26 GNSS Module Series External Corrections NMEA + Fused Heading GPIO_X GPIO_X GPIO_X MCU_TXD MCU_RXD RESERVED 54 1PPS 53 RESERVED 52 RESERVED 51 BOOT 50 RESET_N 49 GND 48 RESERVED 47 RESERVED 46 RESERVED 45 RESERVED 44 RXD1 43 TXD1 42 RESERVED 54 1PPS 53 RESERVED 52 RESERVED 51 BOOT 50 RESET_N 49 GND 48 RESERVED 47 RESERVED 46 RESERVED 45 RESERVED 44 RXD1 43 TXD1 42 Antenna Circuit Antenna Status Detection Circuit 1 GND 2 RF_IN 3 GND 4 ANT_DET 5 ANT_OFF 6 ANT_SHORT 7 VDD_RF 8 RESERVED 9 RESERVED 10 RESERVED 11 RESERVED 12 GND 13 RESERVED 14 GND LG69T (AP) (Base) GND 41 RESERVED 40 RESERVED 39 RESERVED 38 GND 37 V_BCKP 36 RESERVED 35 VCC 34 VCC 33 GND 32 RESERVED 31 RESERVED 30 RXD3 29 TXD3 28 V_BCKP VCC_3.3V MCU Antenna Circuit Antenna Status Detection Circuit 1 GND 2 RF_IN 3 GND 4 ANT_DET 5 ANT_OFF 6 ANT_SHORT 7 VDD_RF 8 RESERVED 9 RESERVED 10 RESERVED 11 RESERVED 12 GND 13 RESERVED 14 GND LG69T (AM) (Rover) GND 41 RESERVED 40 RESERVED 39 RESERVED 38 GND 37 V_BCKP 36 RESERVED 35 VCC 34 VCC 33 GND 32 RESERVED 31 RESERVED 30 RESERVED 29 RESERVED 28 15 RESERVED 16 RESERVED 17 RESERVED 18 RESERVED 19 RESERVED 20 RTK_IND 21 RESERVED 22 RESERVED 23 RESERVED 24 RESERVED 25 RESERVED 26 RXD2 27 TXD2 15 RESERVED 16 SLAVE_BOOT_EN 17 SLAVE_RESET_EN 18 RESERVED 19 RESERVED 20 RTK_IND 21 RESERVED 22 WHEEL_TICK 23 FWD 24 CAN_RX 25 CAN_TX 26 RXD2 27 TXD2 GPIO_X GPIO_X GPIO_X V_BCKP VCC_3.3V I/O POWER GND SYSTEM ANT RESERVED Derived Heading Local Corrections Figure 1: Schematic Diagram of Connection Between Base and Rover LG69T(AM,AP)_Moving_Base_Application_Note Direct Connection Indirect Connection 10 / 26 GNSS Module Series ⚫ External Corrections: The external corrections can be from the VRS service provider. The MCU obtains the RTCM corrections from the VRS service and then sends them to the base (LG69T (AP) module) to realize the RTK positioning function. ⚫ Local Corrections: The local corrections are provided by the base and transmitted to the rover (LG69T (AM) module) via UART2 interface to calculate the heading information. ⚫ Derived Heading: The rover (LG69T (AM) module) calculates the heading information and sends it back to the base (LG69T (AP) module), and the base (LG69T (AP) module) reprocesses the heading information, and finally outputs the fused heading information. ⚫ NMEA + Fused Heading: The base (LG69T (AP) module) can pass through the heading information from the rover (LG69T (AM) module), so the MCU only needs to be connected with the base (LG69T (AP) module) to obtain the positioning data (NMEA) and heading information at the same time. NOTE 1. The modules operate at an I/O voltage of 3.3 V. If the I/O voltage of the MCU differs from this value, a level-shifting circuit must be used. 2. It is recommended to use an OC drive circuit for the RESET_N pin. For more information, see Chapter 2.1.2 RESET_N. 3. It is recommended to use a boot control circuit for the BOOT pin. For more information, see Chapter 2.1.4 BOOT. 2.1. Application Interfaces 2.1.1. UART Interfaces The UART1 on the base is connected to MCU, as shown below: MCU MCU_TXD MCU_RXD GND LG69T (AP) (Base) TXD1 RXD1 GND Figure 2: Reference Design of UART1 Interface on Base The UART2 on the rover is connected to the UART2 on the base, as shown below: LG69T(AM,AP)_Moving_Base_Application_Note 11 / 26 LG69T (AP) (Base) TXD2 RXD2 GND GNSS Module Series LG69T (AM) (Rover) TXD2 RXD2 GND Figure 3: Reference Design of UART2 Interface on Rover 2.1.2. RESET_N RESET_N is an input pin. The base can be reset by driving the RESET_N pin low for at least 100 ms and then releasing it. To control the RESET_N pin of the base, it is recommended to connect it to the GPIO of the MCU through an OC driver circuit. The circuit should be designed as shown below. MCU_GPIO Input pulse RESET_N (Base) Figure 4: Reference OC Circuit for Base’s RESET_N The RESET_N pin of the rover is connected with the SLAVE_RESET_EN pin of the base via an OC driver circuit for upgrading, as shown below: SLAVE_RESET_EN Input pulse RESET_N (Rover) Figure 5: Reference OC Circuit for Rover’s RESET_N LG69T(AM,AP)_Moving_Base_Application_Note 12 / 26 GNSS Module Series 2.1.3. SLAVE_RESET_EN The SLAVE_RESET_EN pin of the base, which is active high, is used to control the RESET_N pin of the rover via an OC driver circuit. For more information about the OC driver circuit, see Figure 5: Reference OC Circuit for Rover’s RESET_N. The RESET_N of the base is pulled down via the GPIO of the MCU to complete the base’s upgrading. When upgrading the rover, the SLAVE_RESET_EN is automatically pulled up, which enables the OC driver circuit and drives low the RESET_N pin of the rover, causing the rover to reset and enter upgrade mode. 2.1.4. BOOT BOOT is used to set the base to Boot download mode. It is pulled down internally by default. If the pin is pulled up with a 100 Ω resistor to the VCC for 50 ms during startup, the base enters Boot download mode. During startup, the BOOT pin voltage level is checked to determine the base’s operating mode. The base’s BOOT pin is connected to the GPIO of the MCU. It is recommended to use a boot control circuit to control the BOOT pin. V CC_3.3V 10K M CU_GP IO 47K 100R BOOT (Base) Figure 6: Reference Control Circuit for Base’s BOOT The rover’s BOOT pin is connected to the SLAVE_BOOT_EN pin of the base via a 0 Ω resistor for downloading. The circuit is illustrated in the figure below: S LA VE _B OO T_E N 0R BOOT (Rover) Figure 7: Reference Control Circuit for Rover’s BOOT LG69T(AM,AP)_Moving_Base_Application_Note 13 / 26 GNSS Module Series 2.1.5. SLAVE_BOOT_EN The SLAVE_BOOT_EN pin of the base, which is active high, is used to control the BOOT pin of the rover via a 0 Ω resistor. For more information about the BOOT control circuit, see Figure 6: Reference Control Circuit for Base’s BOOT. When the rover downloads the firmware, the SLAVE_BOOT_EN and SLAVE_RESET_EN are automatically pulled up, which in turn pulls up the BOOT of the rover. Meanwhile, the RESET_N of the rover is released automatically after being pulled down for at least 100 ms, which puts it to Boot download mode, allowing the firmware to be downloaded. LG69T(AM,AP)_Moving_Base_Application_Note 14 / 26 GNSS Module Series 3 System Construction This chapter provides system-level recommendations for using the base and rover to develop high-performance Moving Base solutions. 3.1. Precautions for GNSS Antenna Mounting 3.1.1. Antenna Mounting Method In practical applications, it is important to fix GNSS antennas during mounting, as shown in the following figure. The vector from the base antenna to the rover antenna is called the baseline. Its minimum length is 0.3 m. Base Anetnna Rover Antenna Figure 8: Antenna Mounting Top View If the orientation test is carried out on the same device, ensure to use two identical GNSS antennas and place them on the same reference ground plane (with the same ground plane size, shape, angle of the horizontal plane). However, the use of a helix antenna does not require ground planes. Base Antenna Rover Antenna Figure 9: Antenna Mounting (Same Reference Ground Plane) LG69T(AM,AP)_Moving_Base_Application_Note 15 / 26 GNSS Module Series 3.1.2. Recommended Mounting for GNSS Antennas Pay attention to the mounting positions for GNSS antennas. For a vehicle, apply GNSS antennas in the same plane and unstructured environment. Figure 10: Antenna Mounting – Vehicle NOTE For recommended antenna selection and design, see document [1] GNSS antenna selection guidance or contact Quectel Technical Support (support@quectel.com). LG69T(AM,AP)_Moving_Base_Application_Note 16 / 26 GNSS Module Series 4 Reference Frame 4.1. Local Cartesian Coordinate System (ENU) Local cartesian coordinate system is a right-handed rectangular coordinate system where the coordinate origin is located at the station center. In the Moving Base application, the phase center of the base antenna is considered the station center, and the heading angle is referenced to this coordinate system. Sky (U) R Rover Antenna B Base Antenna Figure 11: ENU Coordinate System East (E) LG69T(AM,AP)_Moving_Base_Application_Note 17 / 26 GNSS Module Series 4.2. Vehicle Frame The vehicle frame is a 3D frame, as shown in the figure below, and the pitch and roll angles are referenced to this coordinate system. ⚫ The X-axis points towards the right of the vehicle. ⚫ The Y-axis points towards the front of the vehicle. ⚫ The Z-axis points towards the top of the vehicle. Z Y Figure 12: Vehicle Frame LG69T(AM,AP)_Moving_Base_Application_Note 18 / 26 GNSS Module Series 5 Angle Definition This chapter provides the definitions of the heading, pitch and roll angles in the LG69T (AM) and LG69T (AP) Moving Base applications. 5.1. Heading The heading angle in the dual antenna setup is referenced to the local cartesian coordinate system (ENU). It is defined as the angle between the projection of the baseline vector (i.e., the vector connecting the base antenna and rover antenna) on the horizontal plane and the true north (i.e., N-axis) with the effective range of [0,360). For details about the heading angle output, see Chapter 7.1 PQTMTAR Message. The heading angle plane diagram (with north and east directions as reference planes) is illustrated below: North (N) Rover Antenna R Base Antenna B Figure 13: Heading Angle East (E) NOTE This heading angle is derived using dual antenna orientation, and it is different from the heading angle output in RMC message. LG69T(AM,AP)_Moving_Base_Application_Note 19 / 26 GNSS Module Series 5.2. Pitch The pitch angle references vehicle frame. It is the angle between the Y-axis of the vehicle and the horizontal plane, with a range of [-90,+90]. Positive values correspond to upward pitch, while negative values correspond to downward pitch. For details about the pitch angle output, see Chapter 7.1 PQTMTAR Message. The pitch angle diagram is illustrated below: Positive Rotation Pitch Figure 14: Pitch Angle LG69T(AM,AP)_Moving_Base_Application_Note 20 / 26 GNSS Module Series 5.3. Roll The roll angle is referenced to vehicle frame, and is measured between the X-axis of the vehicle and the horizontal plane. Its effective range is [-180,+180], where right is positive and left is negative (when viewed from the rear of the vehicle). For details about roll angle output, see Chapter 7.1 PQTMTAR Message. The roll angle diagram is illustrated below: Positive Rotation Roll Figure 15: Roll Angle LG69T(AM,AP)_Moving_Base_Application_Note 21 / 26 GNSS Module Series 6 Configuration The LG69T (AM) and LG69T (AP) do not require any special configuration for Moving Base application. As long as they are properly connected as shown in Figure 1: Schematic Diagram of Connection Between Base and Rover, LG69T (AP) automatically identifies itself as the base, and LG69T (AM) automatically identifies itself as the rover. The attitude information is provided by $PQTMTAR message on the base, which is enabled by default, see Chapter 7.1 PQTMTAR Message for details. $PQTMTAR message can be enabled/disabled by $PQTMCFGMSGRATE, see document [2] protocol specification for details. LG69T(AM,AP)_Moving_Base_Application_Note 22 / 26 GNSS Module Series 7 Moving Base Related Message 7.1. PQTMTAR Message Outputs the UTC and attitude of the module (base). This message can be enabled or disabled by $PQTMCFGMSGRATE command. Type: Output Synopsis: $PQTMTAR,,,,,,,,,,,,* Parameter: Field Format Unit Numeric - hhmmss.sss - Numeric - Numeric Numeric Meter Degree Description Message version. 1 = Version 1 (Always 1 for this message version.) UTC time. hh: Hours (00–23) mm: Minutes (00–59) ss: Seconds (00–59) sss: Decimal fraction of seconds GPS quality indicator: 0 = Fix not available or invalid 1 = GPS SPS mode 2 = Differential GPS, SPS mode 4 = Real Time Kinematic (RTK) mode 5 = Float RTK mode 6 = Estimated (dead reckoning) mode Reserved. Always null. Base line length. Pitch angle. Range: -90.000000 to 90.000000. LG69T(AM,AP)_Moving_Base_Application_Note 23 / 26 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit Degree Degree Degree Degree Degree - Description Note that this field is empty in case of an invalid value. Roll angle. Range: -180.000000 to 180.000000. Note that this field is empty in case of an invalid value. Heading angle. Range: 0.000000 to 359.999999. Note that this field is empty in case of an invalid value. Vehicle pitch accuracy. Note that this field is empty in case of an invalid value. Vehicle roll accuracy. Note that this field is empty in case of an invalid value. Vehicle heading accuracy. Note that this field is empty in case of an invalid value. Number of satellites used in heading solution. Example: $PQTMTAR,1,165034.000,4,,0.860,1.124780,,50.968541,0.254125,,0.012547,21*59 NOTE This message can be enabled or disabled by $PQTMCFGMSGRATE command, see document [2] protocol specification for details. //Enabled $PQTMTAR message: $PQTMCFGMSGRATE,W,PQTMTAR,1,1*09 $PQTMCFGMSGRATE,OK*29 //Disabled $PQTMTAR message: $PQTMCFGMSGRATE,W,PQTMTAR,0,1*08 $PQTMCFGMSGRATE,OK*29 LG69T(AM,AP)_Moving_Base_Application_Note 24 / 26 GNSS Module Series 8 Appendix A References Table 2: Related Documents Document Name [1] Quectel_GNSS_Antenna_Selection_Guidance [2] Quectel_LG69T(AM,AP)_GNSS_Protocol_Specification Table 3: Terms and Abbreviations Abbreviation DR Description Dead Reckoning ENU GNSS East North Up (navigational coordinate system) Global Navigation Satellite System I/O MCU NMEA Input/Output Microcontroller Unit/Microprogrammed Control Unit National Marine Electronics Association RF RMC RTK Radio Frequency Recommended Minimum Specific GNSS Data Real-Time Kinematic RXD TXD Receive Data (Pin) Transmit Data (Pin) UART UTC Universal Asynchronous Receiver/Transmitter Coordinated Universal Time VRS Virtual Reference Station LG69T(AM,AP)_Moving_Base_Application_Note 25 / 26 GNSS Module Series 9 Appendix B Special Characters Table 4: Special Characters Special Character […] {…} Underline Description Carriage return character. Line feed character. Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. LG69T(AM,AP)_Moving_Base_Application_Note 26 / 26

LC29H (BA,CA,DA,EA) DR&RTK 应用指导 GNSS 模块系列 版本：1.0 日期：2023-07-28 状态：受控文件 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 文档历史 文档信息 标题 副标题 文档类别 文档状态 LC29H (BA,CA,DA,EA) DR&RTK 应用指导 GNSS 模块系列 应用指导 受控文件 修订记录 版本 1.0 日期 2023-07-15 2023-07-28 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 目录 文档历史 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................4 表格索引 ..................................................................................................................................................... 6 图片索引 ..................................................................................................................................................... 7 1 引言.....................................................................................................................................................8 1.1. DR 概述 ....................................................................................................................................8 2 配置.....................................................................................................................................................9 2.1. DR 配置 ....................................................................................................................................9 2.1.1. 方向 ...............................................................................................................................9 2.1.2. 安装 .............................................................................................................................10 2.1.3. DR 校准 .......................................................................................................................12 2.2. RTK 配置 ................................................................................................................................14 2.2.1. RTCM 输入 ..................................................................................................................14 3 DR 相关消息......................................................................................................................................15 3.1. PQTM 消息 .............................................................................................................................15 3.1.1. PQTMDRCAL ..............................................................................................................15 3.1.2. PQTMIMUTYPE ..........................................................................................................16 3.1.3. PQTMVEHMSG...........................................................................................................17 3.1.3.1. = 1 .................................................................................................17 3.1.3.2. = 2 .................................................................................................18 3.1.3.3. = 3 .................................................................................................19 3.1.3.4. = 4 .................................................................................................20 3.1.4. PQTMSAVEPAR ..........................................................................................................21 3.1.5. PQTMRESTOREPAR ..................................................................................................21 3.1.6. PQTMINS ....................................................................................................................22 3.1.7. PQTMIMU....................................................................................................................23 3.1.8. PQTMGPS...................................................................................................................24 3.1.9. PQTMCFGEINSMSG ..................................................................................................26 3.1.10. PQTMVEHMOT ...........................................................................................................27 3.1.11. PQTMSENMSG...........................................................................................................28 3.1.11.1. = 4....................................................................................................28 3.1.12. PQTMCFGDRRTD ......................................................................................................29 3.1.13. PQTMCFGIMUTC .......................................................................................................30 3.1.14. PQTMDRPVA ..............................................................................................................32 3.1.15. PQTMCFGDRHOT ......................................................................................................33 3.1.16. PQTMCFGDR..............................................................................................................35 3.2. PAIR 消息 ...............................................................................................................................36 3.2.1. 数据包类型：6010 PAIR_CUSTOM_SET_MSG_OUTPUT .........................................36 3.2.2. 数据包类型：6011 PAIR_CUSTOM_GET_MSG_OUTPUT .........................................37 上海移远通信技术股份有限公司 4 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 4 附录 A 参考文档及术语缩写 .............................................................................................................39 5 附录 B 特殊符号 ...............................................................................................................................41 上海移远通信技术股份有限公司 5 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 表格索引 表 1：支持的 RTCM 输入消息 ................................................................................................................. 14 表 2：错误码 ........................................................................................................................................... 15 表 3：参考文档........................................................................................................................................ 39 表 4：术语缩写........................................................................................................................................ 39 表 5：特殊符号........................................................................................................................................ 41 上海移远通信技术股份有限公司 6 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 图片索引 图 1：参考系 ............................................................................................................................................. 9 图 2：模块方向........................................................................................................................................ 10 图 3：模块与四轮车安装图 .......................................................................................................................11 图 4：模块与两轮车安装图 ...................................................................................................................... 12 上海移远通信技术股份有限公司 7 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 1 引言 本文档介绍了移远通信 LC29H (BA)、LC29H (CA)、LC29H (DA)和 LC29H (EA)模块的航位推算（DR） 和/或实时动态（RTK）载波相位差分定位功能，主要包括如何进行 DR 和 RTK 配置以及与 DR 相关的语句。 各模块支持的功能如下： ⚫ LC29H (BA)支持 DR 和 RTK。 ⚫ LC29H (CA)仅支持 DR。 ⚫ LC29H (DA)仅支持 RTK（输出频率：1 Hz）。 ⚫ LC29H (EA)仅支持 RTK（输出频率：1 Hz、2 Hz、5 Hz、10 Hz，默认为 10 Hz）。 1.1. DR 概述 LC29H (BA)和 C29H (CA)支持两种 DR 模式：ADR（Automotive Dead Reckoning）和 UDR（Untethered Dead Reckoning）。在 ADR 模式下，模块基于来自车辆的速度数据以及自身的 6 轴传感器，可在无 GNSS 覆盖的环境中提高精度。UDR 模式不需要速度数据。如果模块上电时没有注入速度数据，固件会自动切换 到 UDR 模式。 模块通过 wheel tick 或直接输出的车辆速度（单位：m/s）获取车速数据。 ⚫ wheel tick 注入方式有两种： 1) 通过 WHEELTICK 引脚注入（详见文档 [1] 硬件设计），每脉冲最大距离增量为 0.05 m； 2) 通过 UART 接口的累计 wheel tick 注入（详见第 3.1.3.2 章 = 2），最小注入频率 为 10 Hz，每脉冲最大距离增量为 0.05 m。 ⚫ 直接车速输出仅可通过 UART 接口注入，注入频率最低为 20 Hz，注入速度与实际速度最大误差 为 0.1 m/s。 驾驶过程中，任何中断都将影响模块性能，因此确保稳定的车速注入至关重要。 上海移远通信技术股份有限公司 8 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 2 配置 2.1. DR 配置 本章介绍 LC29H (BA)和 LC29H (CA)模块 DR 功能的配置方法，包括方向、安装和校准。 2.1.1. 方向 LC29H (BA)和 LC29H (CA)模块可应用于两轮或四轮车辆。模块集成了 IMU 和 GNSS 芯片，需将已安 装模块的设备牢固地固定在车身上。车辆和设备之间不可存在相对运动，且必须最大程度地采取冲击或振 动隔离措施。不可用于手持场景。为保证良好安装，最佳方法是通过螺丝将设备固定在车架上。安装位置 应便于连接电源和 GNSS 天线，且不应暴露在过热的环境中。 参考系定义如下： ⚫ X 轴指向车辆右侧。 ⚫ Y 轴指向车辆前方。 ⚫ Z 轴指向车顶。 X Y 图 1：参考系 Z 上海移远通信技术股份有限公司 9 / 41 模块方向如下图所示： LC29H(BA,CA,DA,EA) DR&RTK 应用指导 Z 偏航 俯仰 X Y 横滚 图 2：模块方向 备注 将装有模块的装置牢固地固定在车身上，应选择不易弯曲（如车辆底盘的弯曲变形）、结构稳固的位置。 2.1.2. 安装 LC29H (BA)和 LC29H (CA)模块没有安装方向和角度限制。支持自动估算杆臂，无需额外设置杆臂。 参考模型如下： 上海移远通信技术股份有限公司 10 / 41 X Y LC29H(BA,CA,DA,EA) DR&RTK 应用指导 Y Z Z 图 3：模块与四轮车安装图 上海移远通信技术股份有限公司 11 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 X Y X Z Z Y 图 4：模块与两轮车安装图 2.1.3. DR 校准 在使用 DR 功能前，需要对模块进行校准。 DR 校准步骤如下： 步骤1： 将装有模块的设备牢固地固定在车架上。任何相对于车辆平面的位移、旋转或倾斜，都可能 导致模块性能下降和/或无效校准。 上海移远通信技术股份有限公司 12 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 步骤2： 须在良好的 GNSS 信号及天空晴朗的情况下进行校准。 步骤3： 给模块上电，然后在平坦的地面上启动车辆。 步骤4： 以高于 2 m/s 的速度行驶，做 3、4 个转弯动作后，模块将开始自校准，自校准大约需要 3 分 钟完成。 步骤5： 当$PQTMDRCAL 中值为 2（DR 完全校准）时，校准结束。有关该语句的详细信 息，请参考第 3.1.1 章 PQTMDRCAL。 校准后，车辆行驶方式和行驶动态场景无限制。可参考以下场景进行验证测试： 1) 开阔天空区，城市主干道（C/N0 值大于 30 dB-Hz，卫星数大于 12 颗）。 2) 隧道（无可见卫星条件下）。 3) 高架桥下（弱卫星信号条件下）。 4) 地下停车场（无卫星信号条件下）。 5) 周围建筑物密集的地区（多径信号、天空视野有限场景）。 6) 城市林荫大道（弱卫星信号条件下）。 7) 城市峡谷（多径效应情况严重，天空视野有限场景）。 备注 1. 如将车辆的速度传感器连接到模块，请确保速度传感器精度至少为 0.05 m/tick。 2. 模块在以下场景会退出 GNSS + DR 或 DR only 模式： ⚫ ADR 模式下 5 s 内无速度数据注入； ⚫ 搬运场景； ⚫ 高速电梯场景； ⚫ IMU 数据中断； ⚫ 进入隧道或地下车库前未完全校准； ⚫ 在 没 有 GNSS 信 号 的 环 境 中 ， 超 过 设 定 的 接 收 机 运 行 时 间 或 距 离 （ 详 见 第 3.1.12 章 PQTMCFGDRRTD）。 上海移远通信技术股份有限公司 13 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 2.2. RTK 配置 2.2.1. RTCM 输入 移远通信 LC29H (BA)、LC29H (DA)和 LC29H (EA)模块支持下表所列的 RTCM 10403.3 输入消息。 表 1：支持的 RTCM 输入消息 语句类型 描述 1005 静态 RTK 参考站 ARP 1006 带天线高度的静态 RTK 参考站 ARP 1074 GPS MSM4 1075 GPS MSM5 1077 GPS MSM7 1084 GLONASS MSM4 1085 GLONASS MSM5 1087 GLONASS MSM7 1094 Galileo MSM4 1095 Galileo MSM5 1097 Galileo MSM7 1114 QZSS MSM4 1115 QZSS MSM5 1117 QZSS MSM7 1124 BDS MSM4 1125 BDS MSM5 1127 BDS MSM7 上海移远通信技术股份有限公司 14 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 3 DR 相关消息 3.1. PQTM 消息 本章概述了移远通信 LC29H (BA)和 LC29H(CA)模块支持的 DR 相关 PQTM 消息（由移远通信定义的 NMEA 专有语句）。 表 2：错误码 字段 格式 十进制 单位 - 描述 错误码。 1 = 参数无效 2 = 执行失败 3.1.1. PQTMDRCAL 指示 DR 校准状态。 类型： 输出 格式： $PQTMDRCAL,,,* 参数： 字段 格式 十进制 单位 - 十进制 - 描述 消息版本。 1 = 版本 1（此版本始终为 1） DR 校准状态。 0 = 未校准 1 = DR 轻校准 上海移远通信技术股份有限公司 15 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 字段 格式 单位 十进制 - 示例： $PQTMDRCAL,1,0,1*5C 描述 2 = DR 完全校准 导航类型。 0 = 未定位 1 = GNSS only 定位 2 = DR only 定位 3 = DR 融合定位（GNSS + DR） 3.1.2. PQTMIMUTYPE 每次开机后输出一次 IMU 类型。 类型： 输出 格式： $PQTMIMUTYPE,,* 参数： 字段 格式 十进制 单位 - 十进制 - 描述 消息版本。 1 = 版本 1（此版本始终为 1） IMU 类型。 0 = IMU 错误 1 = LSM6DSR 2 = ICM-40608 3 = BMI160 4 = ICM-42670-P 示例： $PQTMIMUTYPE,1,2*52 上海移远通信技术股份有限公司 16 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 3.1.3. PQTMVEHMSG 输入/输出车辆信息。 类型： 输入/输出 格式： $PQTMVEHMSG,,,[,,…,]* 参数： 字段 格式 单位 十进制 - 十进制 ms to 十进制 - 描述 通过 UART 接口输入/输出的消息类型。 1 = 车速（单位：m/s） 2 = 累计 wheel tick 3 = 四个车轮的速度（单位：m/s） 4 = 四个车轮的累计 wheel tick 上电后的时间戳，32 位无符号整数。 当此消息为输入类型时，该字段始终为 0。 车辆信息。该字段因消息类型而异。详见第 3.1.3.1 章 = 1 至第 3.1.3.4 章 = 4。 备注 对于使用专用于两轮车软件版本的 LC29H (BA)和 LC29H (CA)模块，仅可为 2。相关软件版 本的详细信息，请联系移远通信技术支持（support@quectel.com）。 3.1.3.1. = 1 格式： $PQTMVEHMSG,1,,* 参数： 字段 格式 十进制 单位 ms 描述 上电后的时间戳，32 位无符号整数。 上海移远通信技术股份有限公司 17 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 字段 格式 单位 十进制 m/s 描述 当此消息为输入类型时，该字段始终为 0。 速度。范围：-100~100。 结果： 返回带有时间戳的输入车速： $PQTMVEHMSG,1,,* 示例： //输入： $PQTMVEHMSG,1,0,3.6*1C //输出： $PQTMVEHMSG,1,3748292,3.6*1D 3.1.3.2. = 2 格式： $PQTMVEHMSG,2,,,* 参数： 字段 格式 十进制 十进制 单位 ms tick 十进制 - 描述 上电后的时间戳，32 位无符号整数。 当此消息为输入类型时，该字段始终为 0。 累计 wheel tick。 前进/后退指示。 0 = 无效状态 1 = 前进 2 = 后退 结果： 返回带有时间戳的、输入累计 wheel tick： $PQTMVEHMSG,2,,,* 上海移远通信技术股份有限公司 18 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 示例： //输入： $PQTMVEHMSG,2,0,100,1*18 //输出： $PQTMVEHMSG,2,153954,100,1*27 备注 1. 通过 UART 接口输入累计 wheel tick 时，需确保输入频率至少为 10 Hz。 2. 对于使用专用于两轮车软件版本的 LC29H (BA)和 LC29H (CA)模块： 1) 保持为 1； 2) 不返回$PQTMVEHMSG 消息，但可在$PQTMIMU 消息中查看输入的值。 有关软件版本的详细信息，请联系移远通信技术支持（support@quectel.com）。 3.1.3.3. = 3 格式： $PQTMVEHMSG,3,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 单位 ms m/s m/s m/s m/s 描述 上电后的时间戳，32 位无符号整数。 当此消息为输入类型时，该字段始终为 0。 左前轮转速。范围：-100~100。 右前轮转速。范围：-100~100。 左后轮转速。范围：-100~100。 右后轮转速。范围：-100~100。 结果： 返回带有时间戳的、四个车轮的输入速度： $PQTMVEHMSG,3,,,,,* 上海移远通信技术股份有限公司 19 / 41 示例： //输入： $PQTMVEHMSG,3,0,3.6,3.6,3.6,3.6*19 //输出： $PQTMVEHMSG,3,3748292,3.6,3.6,3.6,3.6*18 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 3.1.3.4. = 4 格式： $PQTMVEHMSG,4,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 单位 ms tick tick tick tick 十进制 - 描述 上电后的时间戳，32 位无符号整数。 当此消息为输入类型时，该字段始终为 0。 左前轮 tick 计数。 右前轮 tick 计数。 左后轮 tick 计数。 右后轮 tick 计数。 前进/后退指示。 0 = 无效状态 1 = 前进 2 = 后退 结果： 返回带有时间戳的、四个车轮的输入累计 wheel tick： $PQTMVEHMSG,4,,,,,* 示例： //输入： $PQTMVEHMSG,4,0,100,100,100,100,1*03 上海移远通信技术股份有限公司 20 / 41 //输出： $PQTMVEHMSG,4,153954,100,100,100,100,1*3C LC29H(BA,CA,DA,EA) DR&RTK 应用指导 3.1.4. PQTMSAVEPAR 保存通过$PQTM 命令或$PAIR6010 命令设置的配置到 NVM 中。执行此命令后需重启模块。 类型： 命令 格式： $PQTMSAVEPAR* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMSAVEPAR,OK* ⚫ 如果失败，模块返回： $PQTMSAVEPAR,ERROR,* 有关的详细信息，见表 2：错误码。 示例： $PQTMSAVEPAR*5A $PQTMSAVEPAR,OK*72 3.1.5. PQTMRESTOREPAR 将所有 DR 相关配置恢复为默认值。执行此命令后需重启模块。 类型： 命令 上海移远通信技术股份有限公司 21 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 格式： $PQTMRESTOREPAR* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMRESTOREPAR,OK* ⚫ 如果失败，模块返回： $PQTMRESTOREPAR,ERROR,* 有关的详细信息，见表 2：错误码。 示例： $PQTMRESTOREPAR*13 $PQTMRESTOREPAR,OK*3B 3.1.6. PQTMINS 输出导航结果。 类型： 输出 格式： $PQTMINS,,,,,,,,,,,* 参数： 字段 格式 十进制 十进制 单位 ms - 描述 上电后的时间戳，32 位无符号整数。 解算类型。 0 = DR 未就绪，横滚与俯仰已就绪。 上海移远通信技术股份有限公司 22 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 字段 格式 单位 十进制 deg 十进制 deg 十进制 m 十进制 m/s 十进制 m/s 十进制 m/s 十进制 deg 十进制 deg 十进制 deg 描述 1 = DR 未就绪，GNSS、横滚、俯仰和相对航向已就绪。 2 = GNSS + DR 模式，DR 已校准。 3 = DR only 模式。 纬度。 经度。 高度。 北向速度。 东向速度。 向心速度。 横滚角。 俯仰角。 偏航角。 示例： $PQTMINS,240951,1,31.82222216,117.11578436,62.555605,-0.004233,0.005535,-0.004011,0.00,0.00, 127.41*40 备注 1. 范围为-180.00~180.00，范围为-90.00~90.00。 2. 范围为-180.00~179.99，在+180.00 处环绕到 0.00。 -180.00/+180.00 = 南，0.00 = 北，+90.00 = 东，-90.00 = 西。 3. 此消息仅适用于 LC29H (BA) 和 LC29H (CA)两轮车专用软件版本。有关软件版本的详细信息，请联 系移远通信技术支持（support@quectel.com）。 3.1.7. PQTMIMU 输出 IMU 原始数据，包括加速度、角速率和硬件 wheel tick。这些值应与车辆参考系相匹配，详见图 1： 参考系。 类型： 输出 上海移远通信技术股份有限公司 23 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 格式： $PQTMIMU,,,,,,,,< WheelTickCNT>,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 ms m/s^2 m/s^2 m/s^2 deg/s deg/s deg/s tick ms 描述 上电后的时间戳，32 位无符号整数。 X 轴方向的加速度。 Y 轴方向的加速度。 Z 轴方向的加速度。 X 轴方向的角速率。 Y 轴方向的角速率。 Z 轴方向的角速率。 累计 wheel tick。 最后 wheel tick 时间戳。 示例： $PQTMIMU,45454,-1.356730,-0.210568,9.757930,0.564879,0.549612,-0.412209,0,0*77 备注 此消息仅适用于 LC29H (BA) 和 LC29H (CA)两轮车专用软件版本。有关软件版本的详细信息，请联系移 远通信技术支持（support@quectel.com）。 3.1.8. PQTMGPS 输出 GNSS only 模式下的位置信息。 类型： 输出 上海移远通信技术股份有限公司 24 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 格式： $PQTMGPS,,,,,,,,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 ms s deg deg deg m/s deg m - - 描述 上电后的时间戳，32 位无符号整数。 周内秒。 纬度。 经度。 海拔。 对地速度（二维）。 车辆的航向（二维）。 水平精度估计。 水平精度因子。 位置精度因子。 导航中使用的卫星数。 定位模式。 0 = 未定位 2 = 2D 定位 3 = 3D 定位 示例： $PQTMGPS,86139,94183,31.82218794,117.11579022,65.755080,0.027,94.68,2.533952,0.555471,0.88 6183,29,3*6B 备注 1. 范围为-180.00~179.99，在+180.00 处环绕到 0.00。 -180.00/+180.00 = 南，0.00 = 北，+90.00 = 东，-90.00 = 西。 2. 此消息仅适用于 LC29H (BA)和 LC29H (CA)两轮车专用软件版本，有关软件版本的详细信息，请联 系移远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 25 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 3.1.9. PQTMCFGEINSMSG 设置/查询$PQTMINS、$PQTMIMU 和$PQTMGPS 语句配置。 类型： 设置/查询 格式： //设置语句配置： $PQTMCFGEINSMSG,,,,,* //查询语句配置： $PQTMCFGEINSMSG,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 单位 描述 设置/查询语句配置。 - 0 = 查询 1 = 设置 启用/禁用$PQTMINS 语句输出。 - 0 = 禁用 1 = 启用 启用/禁用$PQTMIMU 语句输出。 - 0 = 禁用 1 = 启用 启用/禁用$PQTMGPS 语句输出。 - 0 = 禁用 1 = 启用 设置$PQTMINS、$PQTMIMU 或$PQTMGPS 消息的输出频率。 可设置为 1、2、4、5、10、20、50 或 100。对于$PQTMGPS， Hz 输出频率固定为 1 Hz。对于$PQTMINS，当大于 10 时， 消息将以 10 Hz 输出。 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGEINSMSGOK*16 //查询： $PQTMCFGEINSMSG,,,,,* 上海移远通信技术股份有限公司 26 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 ⚫ 如果失败，模块返回： $PQTMCFGEINSMSGERROR*4A 示例： //设置语句配置： $PQTMCFGEINSMSG,1,1,1,1,10*3F $PQTMCFGEINSMSGOK*16 //查询语句配置： $PQTMCFGEINSMSG,0*0E $PQTMEINSMSG,0,1,1,1,10*3E 备注 1. 完成配置后，需发送$PQTMSAVEPAR*5A 并重启模块，$PQTMCFGEINSMSG 命令方可生效。 2. 此消息仅适用于 LC29H (BA)和 LC29H (CA)两轮车专用软件版本。有关软件版本的详细信息，请联 系移远通信技术支持（support@quectel.com）。 3.1.10. PQTMVEHMOT 输出 DR 校准后的车辆运动信息。 类型： 输出 格式： $PQTMVEHMOT,,,* 参数： 字段 格式 十进制 十进制 十进制 单位 m/s2 deg/s 描述 语句版本。 1 = 版本 1（此版本始终为 1） 车辆的峰值加速度。 车辆的峰值角速率。 上海移远通信技术股份有限公司 27 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 示例： $PQTMVEHMOT,1,0.288124,0.159930*0A 备注 此消息仅适用于 LC29H (BA)和 LC29H (CA)四轮车专用软件版本。有关软件版本的详细信息，请联系移 远通信技术支持（support@quectel.com）。 3.1.11. PQTMSENMSG 输出传感器信息。 类型： 输出 格式： $PQTMSENMSG,,,[,,…,]* 参数： 字段 格式 十进制 十进制 to 十进制 单位 ms - 描述 语句版本。 4 = 匹配车辆参考系的 IMU 传感器数据。详见图 1：参考系。 上电后的时间戳，32 位无符号整数。 传感器信息。详见第 3.1.11.1 章 = 4。 3.1.11.1. = 4 格式： $PQTMSENMSG,4,,,,,,< IMU_ACC_X>,,* 上海移远通信技术股份有限公司 28 / 41 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 ms °C dps dps dps g g g LC29H(BA,CA,DA,EA) DR&RTK 应用指导 描述 上电后的时间戳，32 位无符号整数。 IMU 温度。 IMU X 轴陀螺仪值。 IMU Y 轴陀螺仪值。 IMU Z 轴陀螺仪值。 IMU X 轴加速度计值。 IMU Y 轴加速度计值。 IMU Z 轴加速度计值。 示例： $PQTMSENMSG,4,1977253,29.830917,1.727613,0.015743,0.804347,-0.250096,-0.467039,10.444151* 24 备注 此消息仅适用于 LC29H (BA) 和 LC29H (CA)四轮车专用软件版本。有关软件版本的详细信息，请联系移 远通信技术支持（support@quectel.com）。 3.1.12. PQTMCFGDRRTD 设置/查询 DR only 模式下的 DR 运行时间和距离。如果接收机的运行时间或距离超过设定值，接收机 将退出 DR only 模式。 类型： 设置/查询 格式： //设置： $PQTMCFGDRRTD,W,,* //查询： $PQTMCFGDRRTD,R* 上海移远通信技术股份有限公司 29 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 参数： 字段 格式 十进制 十进制 单位 s m 描述 DR 运行时间。 0 = 无限制 DR 运行距离。 0 = 无限制 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGDRRTD,OK* //查询： $PQTMCFGDRRTD,OK,,* ⚫ 如果失败，模块返回： $PQTMCFGDRRTD,ERROR,* 有关的详细信息，见表 2：错误码。 示例： //设置： $PQTMCFGDRRTD,W,600,10000*72 $PQTMCFGDRRTD,OK*26 //查询： $PQTMCFGDRRTD,R*70 $PQTMCFGDRRTD,OK,600,10000*21 3.1.13. PQTMCFGIMUTC 设置/查询 IMU 温度补偿功能。 类型： 设置/查询 格式： //设置： $PQTMCFGIMUTC,W,* 上海移远通信技术股份有限公司 30 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 //查询： $PQTMCFGIMUTC,R* 参数： 字段 格式 十进制 单位 - 描述 IMU 温度补偿功能的状态。 0 = 禁用 1 = 启用 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGIMUTC,OK* //查询： $PQTMCFGIMUTC,OK,* ⚫ 如果失败，模块返回： $PQTMCFGIMUTC,ERROR,* 有关的详细信息，见表 2：错误码。 示例： //启用温度补偿功能： $PQTMCFGIMUTC,W,1*7A $PQTMCFGIMUTC,OK*34 //查询温度补偿状态： $PQTMCFGIMUTC,R*62 $PQTMCFGIMUTC,OK,1*29 备注 此消息仅适用于 LC29H (BA)和 LC29H (CA)四轮车专用软件版本。有关软件版本的详细信息，请联系移 远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 31 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 3.1.14. PQTMDRPVA 输出 DR 位置、速度和姿态。 类型： 输出 格式： $PQTMDRPVA,,,,,,,,,,,< VelD>,,,* 参数： 字段 格式 单位 十进制 - 十进制 ms hhmmss.sss - 十进制 - 十进制 deg 十进制 deg 十进制 m 十进制 m 十进制 m/s 十进制 m/s 描述 语句版本。 1 = 版本 1（此版本始终为 1） 上电后的时间戳，32 位无符号整数。 UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（(00~59） sss：秒的十进制小数 解算类型。 0 = 未定位 1 = GNSS only 2 = 融合（GNSS + DR） 3 = DR only 纬度。 数据无效时，此字段为空。 经度。 数据无效时，此字段为空。 平均海平面以上海拔。 数据无效时，此字段为空。 大地水准面差距（WGS84 基准面与平均海平面之间的差值）。 数据无效时，此字段为空。 北向速度。 数据无效时，此字段为空。 东向速度。 数据无效时，此字段为空。 上海移远通信技术股份有限公司 32 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 字段 格式 十进制 十进制 十进制 十进制 十进制 单位 m/s m/s deg deg deg 描述 向心速度。 数据无效时，此字段为空。 对地速度。 数据无效时，此字段为空。 横滚角。 数据无效时，此字段为空。 范围：-180.000000~180.000000。 俯仰角。 数据无效时，此字段为空。 范围：-90.000000 至 90.000000。 航向角。 数据无效时，此字段为空。 范围：0.000000~360.000000。 示例： //未定位： $PQTMDRPVA,1,1000,163355.000,0,,,,,,,,,,,*7C //GNSS + DR 定位： $PQTMDRPVA,1,75000,083737.000,2,31.12738291,117.26372910,34.212,5.267,3.212,2.928,0.238,4.3 46,0.392663,1.300793,0.030088*5E 备注 此消息仅适用于 LC29H (BA)和 LC29H (CA)四轮车专用软件版本。有关软件版本的详细信息，请联系移 远通信技术支持（support@quectel.com）。 3.1.15. PQTMCFGDRHOT 设置/查询 DR 热启动功能。 类型： 设置/查询 格式： //设置： $PQTMCFGDRHOT,W,* 上海移远通信技术股份有限公司 33 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 //查询： $PQTMCFGDRHOT,R* 参数： 字段 格式 单位 十进制 - 描述 启用/禁用 DR 热启动模式。 0 = 禁用。每次上电后需重新校准 DR。 1 = 启用。每次上电后无需重新校准 DR，无信号情况下，模块上电 后立刻输出位置信息。 2 = 启用。每次上电后无需重新校准 DR，但在无信号情况下，模块 上电后不输出位置信息。 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGDRHOT,OK* //查询： $PQTMCFGDRHOT,OK,* ⚫ 如果失败，模块返回： $PQTMCFGDRHOT,ERROR,* 有关的详细信息，见表 2：错误码。 示例： //设置： $PQTMCFGDRHOT,W,1*79 $PQTMCFGDRHOT,OK*37 //查询 $PQTMCFGDRHOT,R*61 $PQTMCFGDRHOT,OK,1*2A 备注 此消息仅适用于 LC29H (BA)和 LC29H (CA)四轮车专用软件版本。有关软件版本的详细信息，请联系移 远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 34 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 3.1.16. PQTMCFGDR 设置/查询 DR 状态。 类型： 设置/查询 格式： //设置： $PQTMCFGDR,W,* //查询： $PQTMCFGDR,R* 参数： 字段 格式 十进制 单位 - 描述 启用/禁用 DR 功能。 0 = 禁用 1 = 启用 结果： ⚫ 如果成功，模块返回： //设置： $PQTMCFGDR,OK* //查询： $PQTMCFGDR,OK,* ⚫ 如果失败，模块返回： $PQTMCFGDR,ERROR,* 有关的详细信息，见表 2：错误码。 示例： //设置： $PQTMCFGDR,W,1*2A $PQTMCFGDR,OK*64 //查询： 上海移远通信技术股份有限公司 35 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 $PQTMCFGDR,R*32 $PQTMCFGDR,OK,1*79 备注 此消息仅适用于 LC29H (BA)和 LC29H (CA)四轮车专用软件版本。有关软件版本的详细信息，请联系移 远通信技术支持（support@quectel.com）。 3.2. PAIR 消息 本章概述了 DR 相关的 PAIR 消息（由芯片组供应商定义的 NMEA 专有语句）。'P'表示专有语句， 'AIR'表示芯片组供应商定义的命令。 3.2.1. 数据包类型：6010 PAIR_CUSTOM_SET_MSG_OUTPUT 启 用 / 禁 用 $PQTMVEHMSG 、 $PQTMSENMSG 、 $PQTMDRCAL 、 $PQTMIMUTYPE 和 $PQTMVEHMOT 消息的输出。 类型： 设置 格式： $PAIR6010,,* 参数： 字段 格式 单位 十进制 - 十进制 - 描述 语句类型。 -1 = 将以下所有语句类型的输出状态重置为默认值 0 = $PQTMVEHMSG（默认禁用） 1 = $PQTMSENMSG（默认禁用） 2 = $PQTMDRCAL（默认禁用） 3 = $PQTMIMUTYPE（默认启用） 4 = $PQTMVEHMOT（默认禁用） 语句输出状态。 0 = 禁用 1 = 启用 上海移远通信技术股份有限公司 36 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 结果： 返回$PAIR001 消息。详见文档 [2] 协议规范。 示例： $PAIR6010,0,1*0C $PAIR001,6010,0*0C 备注 1. 完成配置后，需发送$PQTMSAVEPAR*5A 并重启模块，$PAIR6010 命令方可生效。 2. $PQTMVEHMSG 和$PQTMSENMSG 的输出频率为 10 Hz。$PQTMDRCAL 和$PQTMVEHMOT 的 输出频率取决于定位频率。$PQTMIMUTYPE 仅在每次模块启动后输出一次。 3.2.2. 数据包类型：6011 PAIR_CUSTOM_GET_MSG_OUTPUT 查 询 是 否 启 用 $PQTMVEHMSG 、 $PQTMSENMSG 、 $PQTMDRCAL 、 $PQTMIMUTYPE 和 $PQTMVEHMOT 语句输出。 类型： 查询 格式： $PAIR6011,* 参数： 字段 格式 单位 十进制 - 描述 语句类型。 0 = $PQTMVEHMSG 1 = $PQTMSENMSG 2 = $PQTMDRCAL 3 = $PQTMIMUTYPE 4 = $PQTMVEHMOT 结果： 返回$PAIR001 消息和查询结果。有关$PAIR001 消息，详见文档 [2] 协议规范。 上海移远通信技术股份有限公司 37 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 查询结果消息格式： $PAIR6011,,* 结果中包含的参数： 字段 格式 单位 十进制 - 十进制 - 描述 语句类型。 0 = $PQTMVEHMSG 1 = $PQTMSENMSG 2 = $PQTMDRCAL 3 = $PQTMIMUTYPE 4 = $PQTMVEHMOT 语句输出状态。 0 = 禁用 1 = 启用 示例： $PAIR6011,1*11 $PAIR001,6011,0*0D $PAIR6011,1,0*0D 备注 此消息仅适用于 LC29H (BA)和 LC29H (CA)四轮车专用软件版本。有关软件版本的详细信息，请联系移 远通信技术支持（support@quectel.com）。 上海移远通信技术股份有限公司 38 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 4 附录 A 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_LC29H 系列_硬件设计手册 [2] Quectel_LC29H 系列&LC79H(AL)_GNSS_协议规范 表 4：术语缩写 缩写 英文全称 中文全称 ARP BDS DR Galileo GLONASS C/N0 GNSS GPS IMU MSM NMEA PQTM QZSS Antenna Reference Point 天线参考点 BeiDou Navigation Satellite System 北斗卫星导航系统 Dead Reckoning 航位推算 Galileo Satellite Navigation System (EU) 伽利略卫星导航系统（欧盟） Global Navigation Satellite System (Russia) 格洛纳斯导航卫星系统（俄罗斯） Carrier-to-Noise-Density Ratio 载噪比 Global Navigation Satellite System 全球卫星导航系统 Global Positioning System 全球定位系统 Inertial Measurement Unit 惯性测量单元 Multiple Signal Message 多信号消息 NMEA (National Marine Electronics NMEA（国家海洋电子协会）0183 接 Association) 0183 Interface Standard 口标准 Proprietary Protocol of Quectel 移远专有协议 Quasi-Zenith Satellite System 准天顶卫星系统 上海移远通信技术股份有限公司 39 / 41 缩写 RTCM RTK LC29H(BA,CA,DA,EA) DR&RTK 应用指导 英文全称 中文全称 Radio Technical Commission for Maritime 海事无线电技术委员会 Services Real-Time Kinematic 实时动态测量 上海移远通信技术股份有限公司 40 / 41 LC29H(BA,CA,DA,EA) DR&RTK 应用指导 5 附录 B 特殊符号 表 5：特殊符号 特殊符号 […] {…} 下划线 描述 回车符 换行符 参数名称（实际命令行中不包含尖括号） 可选参数（实际命令行中不包含中括号） 循环参数（实际命令行中不包含大括号） 参数的默认设置 上海移远通信技术股份有限公司 41 / 41

LC29H (EA) Moving Base 应用指导 GNSS 模块系列 版本：1.0 日期：2023-07-20 状态：受控文件 LC29H(EA) Moving Base 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 26 LC29H(EA) Moving Base 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 26 LC29H(EA) Moving Base 应用指导 安全须知 为确保个人安全并保护产品和工作环境免遭潜在损坏，请遵循如下安全须知。产品制造商需要将下列 安全须知传达给终端用户，并将所述安全须知体现在终端产品的用户手册中。移远通信不会对用户因未遵 循所述安全规则或错误使用产品而产生的后果承担任何责任。 请确保产品的使用符合国家和行业基础标准、安全标准和环境保护标准的要求，并 符合国家和特定场所对产品使用的具体规定。 请确保终端产品远离易燃易爆品。在极端供电和任何有潜在爆炸危险的（如靠近加 油站、油库、化工厂或爆炸作业场所）环境下使用电子产品可能存在安全隐患。 必须为产品提供稳定可靠的电源，并确保所有接线符合相关安全和防火法规。 在产品安装和使用过程中，必须小心处理以避免因为静电而对产品造成损坏。 上海移远通信技术股份有限公司 3 / 26 LC29H(EA) Moving Base 应用指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 LC29H (EA) Moving Base 应用指导 GNSS 模块系列 应用指导 受控文件 修订历史 版本 1.0 日期 描述 2023-03-30 文档创建 2023-07-20 受控版本 上海移远通信技术股份有限公司 4 / 26 LC29H(EA) Moving Base 应用指导 目录 安全须知 ........................................................................................................................................................ 3 关于文档 ........................................................................................................................................................ 4 目录 ............................................................................................................................................................... 5 表格索引 ........................................................................................................................................................ 6 图片索引 ........................................................................................................................................................ 7 1 引言 ........................................................................................................................................................ 8 2 硬件设计 ................................................................................................................................................. 9 2.1. 应用接口 .................................................................................................................................. 11 2.1.1. UART 接口 ..................................................................................................................... 11 2.1.2. WAKEUP........................................................................................................................ 11 2.1.3. RESET_N....................................................................................................................... 12 2.1.4. RESET_CTL................................................................................................................... 13 3 系统搭建 ............................................................................................................................................... 14 3.1. GNSS 天线安装注意事项 ........................................................................................................ 14 3.1.1. 天线安装方式.................................................................................................................. 14 3.1.2. 天线的推荐安装 .............................................................................................................. 15 4 参考坐标框架........................................................................................................................................ 17 4.1. 站心坐标系（ENU）................................................................................................................ 17 5 角度定义 ............................................................................................................................................... 18 5.1. 航向角（Heading） ................................................................................................................. 18 5.2. 俯仰角（Pitch） ...................................................................................................................... 19 6 软件配置 ............................................................................................................................................... 21 7 Moving Base 相关消息 ....................................................................................................................... 22 7.1. PQTMCFGMSGRATE 消息 .................................................................................................... 22 7.2. PQTMTAR 消息....................................................................................................................... 23 8 附录 A 参考文档及术语缩写................................................................................................................ 25 9 附录 B 特殊符号 .................................................................................................................................. 26 上海移远通信技术股份有限公司 5 / 26 LC29H(EA) Moving Base 应用指导 表格索引 表 1：不同应用场景下 LC29H (EA)引脚功能配置差异 ................................................................................ 9 表 2：错误码............................................................................................................................................... 23 表 3：参考文档 ........................................................................................................................................... 25 表 4：术语缩写 ........................................................................................................................................... 25 表 5：特殊符号 ........................................................................................................................................... 26 上海移远通信技术股份有限公司 6 / 26 LC29H(EA) Moving Base 应用指导 图片索引 图 1：基站与移动站连接示意图 ................................................................................................................. 10 图 2：基站 UART1 接口参考设计............................................................................................................... 11 图 3：移动站 UART1 接口参考设计 ........................................................................................................... 11 图 4：进入/退出 Backup 模式时序 ............................................................................................................. 12 图 5：基站复位 OC 参考电路 ..................................................................................................................... 13 图 6：天线安装俯视图 ................................................................................................................................ 14 图 7：天线安装（同一参考地平面） .......................................................................................................... 14 图 8：天线安装 – 无人机 .......................................................................................................................... 15 图 9：天线安装 – 割草机 .......................................................................................................................... 15 图 10：天线安装 – 车辆 ............................................................................................................................ 16 图 11：站心坐标系 ..................................................................................................................................... 17 图 12：航向角和俯仰角 .............................................................................................................................. 18 图 13：航向角............................................................................................................................................. 19 图 14：俯仰角............................................................................................................................................. 20 上海移远通信技术股份有限公司 7 / 26 LC29H(EA) Moving Base 应用指导 1 引言 本文档主要介绍 LC29H (EA)双模块在 Moving Base 应用中的软、硬件设计。LC29H (EA)支持多频段 RTK 技术，可输出高精度的位置、航向和姿态信息。RTK 技术包含移动站和基站，基站通过通信链路持续 向移动站发送差分校准数据流。在标准 RTK 模式下，基站在已知位置保持静止，而移动站可移动。而在 Moving Base RTK 模式下，基站和移动站均可移动，因此该模式适用于无人机、割草机及汽车等应用场景。 为实现 Moving Base 功能，两个 LC29H (EA)模块须安装在同一载体平台上。 '基站'、'移动站'、'基线'和'航向角'用于描述 Moving Base 功能。 ⚫ 基站：发送差分校准数据流。 ⚫ 移动站：接收差分校准数据流。 ⚫ 基线：由基站天线指向移动站天线的矢量。LC29H (EA) Moving Base 功能支持的基线长度范围为 0.2~5 米。 ⚫ 航向角：以顺时针方向旋转、从正北到基线的夹角。 上海移远通信技术股份有限公司 8 / 26 LC29H(EA) Moving Base 应用指导 2 硬件设计 移远通信 LC29H (EA)双模块搭配使用时，一个作为基站，另一个作为移动站，二者可从连接方式上进 行区分。其中，基站通过 UART1 接口和 MCU 通信，而移动站通过 UART1 接口与基站的 UART2 通信， 具体连接如图 1：基站与移动站连接示意图所示。 在 Moving Base 应用场景下，LC29H (EA)模块的部分引脚功能配置（引脚 5、6 及 15~19）与在一般 应用场景下存在差异，如下表所示。 表 1：不同应用场景下 LC29H (EA)引脚功能配置差异 引脚号 一般应用场景（单模块） 引脚功能 Moving Base 应用场景（双模块） 5 D_SEL1：UART1/I2C/SPI 接口选择 RESERVED 6 D_SEL2：UART1/I2C/SPI 接口选择 RESERVED 15 TXD2：UART2 发送数据 RESERVED 16 RXD2：UART2 接收数据 RESERVED 17 WI：报警指示 RESET_CTL：控制移动站的 RESET_N 18 I2C_SDA/SPI_CS：I2C 串行数据/SPI 片选信号 TXD2：UART2 发送数据 19 I2C_SCL/SPI_CLK：I2C 串行时钟/SPI 时钟信号 RXD2：UART2 接收数据 上海移远通信技术股份有限公司 9 / 26 LC29H(EA) Moving Base 应用指导 外部校正数据 NMEA + Heading（专有语句） MCU_RXD MCU_TXD GPIO_X GPIO_X GPIO_X MCU 天线电路 1 WAKEUP GND 24 2 RESERVED VCC 23 3 1PPS V_BCKP 22 4 RESERVED RXD1 21 5 RESERVED TXD1 20 6 RESERVED LC29H (EA) 7 VDD_EXT （基站） RXD2 19 TXD2 18 8 RESET_N 9 VDD_RF 10 GND 11 RF_IN 12 GND RESET_CTL 17 RESERVED 16 RESERVED 15 ANT_ON 14 GND 13 VCC_3.3 V_Base V_BCKP_3.3 V_Base Heading 本地校正数据 GPIO_X GPIO_X 1 WAKEUP GND 24 2 RESERVED VCC 23 3 1PPS V_BCKP 22 4 RESERVED RXD1 21 5 RESERVED TXD1 20 6 RESERVED LC29H (EA) 7 VDD_EXT （移动 站） RXD2 19 TXD2 18 VCC_3.3 V_Rover V_BCKP_3.3 V_Rover 天线电路 8 RESET_N 9 VDD_RF 10 GND 11 RF_IN 12 GND RESET_CTL 17 RESERVED 16 RESERVED 15 ANT_ON 14 GND 13 I/O PO WER GND SY STEM ANT RESERVED 直连 非直连 图 1：基站与移动站连接示意图 ⚫ 外部校正数据：外部校正数据可以来自于 VRS 供应商。用户 MCU 将获取自 VRS 服务的 RTCM 校正数据发送至基站，基站可以实现 RTK 定位功能。 ⚫ 本地校正数据：本地校正数据由基站提供，通过其 UART2 接口传输到移动站，用于移动站计算航 向。 ⚫ Heading：航向数据由移动站计算得出、并回传到基站，最终由基站输出航向数据。 ⚫ NMEA + Heading（专有语句）：定位数据（NMEA 标准语句）和航向数据（专有语句）由基站传 输到用户 MCU，MCU 需要和基站连接。 上海移远通信技术股份有限公司 10 / 26 LC29H(EA) Moving Base 应用指导 备注 1. 模块 I/O 电压为 2.8 V，如果 MCU 的 I/O 电压与模块不同，须使用电平转换电路。 2. 针对基站的 RESET_N 引脚，建议使用 OC 驱动电路，详情请参考第 2.1.3 章 RESET_N。 2.1. 应用接口 2.1.1. UART 接口 基站的 UART1 接口与 MCU 的连接示意图如下所示： MCU MCU_TXD MCU_RXD GND LC29H (EA) （基站） TXD1 RXD1 GND 图 2：基站 UART1 接口参考设计 移动站 UART1 接口与基站 UART2 接口的连接示意图如下所示： LC29H (EA) （基站） TXD2 RXD2 GND LC29H (EA) （移动站） TXD1 RXD1 GND 图 3：移动站 UART1 接口参考设计 2.1.2. WAKEUP 对功耗比较敏感的应用，模块可提供 Backup 模式以减少功耗。将 WAKEUP 引脚拉至高电平至少 10 毫秒可将模块从 Backup 模式中唤醒。在进入 Backup 模式前，保持该引脚断开或者低电平。WAKEUP 引 脚已在模块内部下拉，属于备份域。如不使用，请保持该引脚不连接。 上海移远通信技术股份有限公司 11 / 26 LC29H(EA) Moving Base 应用指导 基站可通过 UART 接口将从 MCU 端接收到的指令同步传输到移动站。因此，MCU 通过该接口发送命 令到基站来使基站和移动站同时进入 Backup 模式。 ⚫ 进入 Backup 模式： 步骤 1： 通过发送$PAIR650 命令，依次关闭内部主电源。有关命令详情，请参考文档 [1] 协议规范。 步骤 2： 断开 VCC 电源并保持 V_BCKP 正常供电。 ⚫ 退出 Backup 模式： 步骤 1： 重新给 VCC 上电。 步骤 2： 拉高 WAKEUP 引脚至少 10 毫秒。 V_BCKP Enter Backup mode Low power consumption Exit Backup mode VCC below 100 mV 1 s WAKEUP 10 ms UART Valid Continuous mode Send command Invalid Valid Backup mode Continuous mode Cut off VCC Restore VCC Pull WAKEUP high 备注 图 4：进入/退出 Backup 模式时序 WAKEUP 内部有 47 kΩ 下拉电阻。MCU 端连接该引脚的 GPIO 需要支持推挽输出。 2.1.3. RESET_N RESET_N 为输入引脚。拉低该引脚至少 100 毫秒后再释放，可使模块复位。 基站 RESET_N 引脚与 MCU 的 GPIO 控制引脚连接，建议使用如下所示 OC 驱动电路来实现复位控制。 上海移远通信技术股份有限公司 12 / 26 Input pulse LC29H(EA) Moving Base 应用指导 RESET_N 图 5：基站复位 OC 参考电路 移动站 RESET_N 引脚与基站的 RESET_CTL 引脚通过 0 Ω 电阻串联，便于一体化升级。 2.1.4. RESET_CTL 基站 RESET_CTL 引脚用于控制移动站的 RESET_N，便于一体化升级。通过 MCU 的 GPIO 控制引 脚将基站的 RESET_N 拉低，完成基站升级后，RESET_CTL 自动被拉低，从而拉低移动站的 RESET_N， 完成移动站的升级。RESET_CTL 引脚默认状态为 2.8 V 高电平，低电平有效。 移动站该引脚悬空。 上海移远通信技术股份有限公司 13 / 26 LC29H(EA) Moving Base 应用指导 3 系统搭建 本章主要介绍如何使用 LC29H (EA)双模块接收机来实现高性能 Moving Base 的系统级建议。 3.1. GNSS 天线安装注意事项 3.1.1. 天线安装方式 在实际应用中，GNSS 天线安装需固定，如下图所示。其中，由基站天线指向移动站天线的矢量称为 '基线'。'基线'的最短长度为 0.2 米。 基站天线 移动站天线 图 6：天线安装俯视图 如果在同一设备上进行定向测试，需使用两个型号相同的 GNSS 天线，且放置在相同的参考地平面上 （即地平面的大小、形状和水平面的角度保持一致）。模块使用螺旋天线时，则无需考虑地平面，因为螺 旋天线的安装无需参考地平面。 基站天线 移动站天线 图 7：天线安装（同一参考地平面） 上海移远通信技术股份有限公司 14 / 26 LC29H(EA) Moving Base 应用指导 3.1.2. 天线的推荐安装 GNSS 天线的推荐安装取决于应用场景。在无人机上使用时，应确保 GNSS 天线置于无人机的顶部， 避免天线被遮挡和电机干扰。 图 8：天线安装 – 无人机 在割草机上使用时，应确保 GNSS 天线在开阔、无结构遮挡的环境中应用。 图 9：天线安装 – 割草机 上海移远通信技术股份有限公司 15 / 26 LC29H(EA) Moving Base 应用指导 在车辆上使用时，应确保 GNSS 天线在同平面、无结构遮挡的环境中应用。 图 10：天线安装 – 车辆 备注 移 远 通 信 可 提 供 相 关 天 线 选 型 ， 详 情 可 参 考 文 档 [2] 天 线 选 型 指 导 或 联 系 移 远 通 信 技 术 支 持 （support@quectel.com）。 上海移远通信技术股份有限公司 16 / 26 LC29H(EA) Moving Base 应用指导 4 参考坐标框架 4.1. 站心坐标系（ENU） 站心坐标系是以站心为坐标原点的右手直角坐标系。在 Moving Base 应用中，站心是基站天线的相位 中心，移动站输出的航向角和俯仰角参考此站心坐标系。 天（U） R 移动站天线 B 基站天线 图 11：站心坐标系 东（E） 上海移远通信技术股份有限公司 17 / 26 LC29H(EA) Moving Base 应用指导 5 角度定义 本章详细介绍了 LC29H (EA) Moving Base 应用的航向角和俯仰角。 航向 角（H ead ing ） 基站天线 B R 俯仰 角（Pitch ） 移动站天线 翻滚 角（R oll ） 图 12：航向角和俯仰角 备注 LC29H (EA) Moving Base 应用不支持翻滚角。 5.1. 航向角（Heading） 双天线定向装置的航向角参考站心坐标系（ENU）。航向角指基线向量（基站指向移动站）在水平面 上的投影与正北方向（N 轴）的夹角，有效范围是[0,360)。航向角的输出详情，请参考第 7.2 章 PQTMTAR 消息。 航向角（以北、东方向作为参考平面）示意图如下： 上海移远通信技术股份有限公司 18 / 26 北（N） LC29H(EA) Moving Base 应用指导 移动站天线 R 东（E） 基站天线 B 图 13：航向角 备注 该航向角指使用双天线定向的航向角，不同于 RMC 语句中输出的航向角。 5.2. 俯仰角（Pitch） 双天线定向的俯仰角参考站心坐标系（ENU），指基线向量（基站指向移动站）与水平面的夹角，有 效范围是[-90,+90]，向上为正，向下为负。俯仰角的输出详情，请参考第 7.2 章 PQTMTAR 消息。 俯仰角示意图如下： 上海移远通信技术股份有限公司 19 / 26 天（U） LC29H(EA) Moving Base 应用指导 R 移动站天线 水平面 B 基站天线 图 14：俯仰角 上海移远通信技术股份有限公司 20 / 26 LC29H(EA) Moving Base 应用指导 6 软件配置 一般来说，当两个 LC29H (EA)模块按照连接示意图（图 1：基站与移动站连接示意图）正确连接后， 对于 Moving Base 应用无需再做特殊配置，系统会自动识别移动站或基准站。 航向和姿态信息由移动站的$PQTMTAR 消息输出。使用$PQTMCFGMSGRATE 命令（请参考第 7.1 章 PQTMCFGMSGRATE 消息）来启用$PQTMTAR（详情请参考第 7.2 章 PQTMTAR 消息）消息。 示例： //设置启用$PQTMTAR 消息： $PQTMCFGMSGRATE,W,PQTMTAR,1,1*09 $PQTMCFGMSGRATE,OK*29 上海移远通信技术股份有限公司 21 / 26 LC29H(EA) Moving Base 应用指导 7 Moving Base 相关消息 7.1. PQTMCFGMSGRATE 消息 配置当前端口上的消息输出频率。 类型： 设置/获取 格式： //设置： $PQTMCFGMSGRATE,W,,,* //获取： $PQTMCFGMSGRATE,R,,* 参数： 字段 格式 字符串 十进制 十进制 单位 - 描述 配置消息名称。 消息输出频率。 0 = 禁用输出。 1 = 每定位一次输出一次。 消息版本。 结果： ⚫ 如果成功，模块返回： //对设置命令的响应： $PQTMCFGMSGRATE,OK* //对获取命令的响应： $PQTMCFGMSGRATE,OK,,,* 上海移远通信技术股份有限公司 22 / 26 LC29H(EA) Moving Base 应用指导 ⚫ 如果失败，模块返回： $PQTMCFGMSGRATE,ERROR,* 关于，详见表 2：错误码。 表 2：错误码 字段 格式 十进制 单位 - 描述 错误码。 1 = 无效参数 2 = 执行失败 示例： //设置启用$PQTMTAR 消息： $PQTMCFGMSGRATE,W,PQTMTAR,1,1*09 $PQTMCFGMSGRATE,OK*29 备注 设置命令将在发送$PQTMSAVEPAR*5A（详见文档 [1] 协议规范）并重置模块后生效。 7.2. PQTMTAR 消息 输出模块（移动站）UTC 时间和姿态。此消息可由$PQTMCFGMSGRATE 命令启用或禁用。 类型： 输出 格式： $PQTMTAR,,,,,,,,,,< Res3>,,* 上海移远通信技术股份有限公司 23 / 26 LC29H(EA) Moving Base 应用指导 参数： 字段 格式 十进制 单位 - hhmmss.sss - 十进制 - - - 十进制 米 十进制 度 十进制 度 十进制 度 十进制 度 十进制 度 十进制 度 十进制 - 描述 消息版本。 1 = 版本 1（此消息版本固定为 1） UTC 时间。 hh：小时（00~23） mm：分钟（00~59） ss：秒（(00~59） sss：秒的十进制小数 GNSS 定向状态指示。 0 = 定向不可用或无效 1 = 单点模式 2 = 差分模式 4 = 固定解模式 5 = 浮点解模式 预留。固定为空。 基线长度。 载体俯仰角。范围：-90.000000~90.000000。 数据无效时，此字段为空。 预留。固定为空。 载体航向角。范围：0.000000~359.999999。 数据无效时，此字段为空。 载体俯仰角精度。 数据无效时，此字段为空。 预留。固定为空。 载体航向角精度。 数据无效时，此字段为空。 使用的卫星数。 示例： $PQTMTAR,1,165034.000,4,,0.860,1.124780,,50.968541,0.254125,,0.012547,21*59 上海移远通信技术股份有限公司 24 / 26 LC29H(EA) Moving Base 应用指导 8 附录 A 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_LC29H 系列&LC79H(AL)_GNSS_协议规范 [2] Quectel_GNSS_天线选型指导 表 4：术语缩写 缩写 英文全称 中文全称 ENU GNSS I/O MCU RF RMC RTK RXD TXD UART UTC VRS East North Up 站心地平直角坐标系 Global Navigation Satellite System 全球导航卫星系统 Input/Output 输入/输出 Microcontroller Unit/Microprogrammed Control Unit 微型控制单元/微程序控制器 Radio Frequency 射频 Recommended Minimum Specific GNSS Data 推荐的最少专用 GNSS 数据 Real-Time Kinematic 载波相位差分技术 Receiver Data (Pin) 数据接收（引脚） Transmit Data (Pin) 发送数据（引脚） Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Coordinated Universal Time 协调世界时 Virtual Reference Station 虚拟参考站 上海移远通信技术股份有限公司 25 / 26 LC29H(EA) Moving Base 应用指导 9 附录 B 特殊符号 表 5：特殊符号 特殊符号 [...] {…} 下划线 描述 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 消息的可选字段。方括号不会出现在消息中。 循环参数。实际命令行中不包含方括号。 参数的默认设置。 上海移远通信技术股份有限公司 26 / 26

EC2x&EG2x&EG9x Series Secure Boot Application Note LTE Standard Module Series Version: 1.0 Date: 2023-06-30 Status: Released EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 0 / 19 LTE Standard Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 1 / 19 LTE Standard Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 2 / 19 LTE Standard Module Series About the Document Revision History Version 1.0 Date 2023-05-16 2023-06-30 Author Eve HU/ Damon LI Eve HU/ Damon LI Description Creation of the document First official release EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 3 / 19 LTE Standard Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 1.1. Applicable Module...................................................................................................................... 7 2 Secure Boot Overview ........................................................................................................................ 8 2.1. Definition .................................................................................................................................... 8 2.2. Flow Chart .................................................................................................................................. 8 3 Secure Boot Enabling Procedures.................................................................................................. 10 3.1. Certificate Chain Generation.................................................................................................... 10 3.1.1. Environment Preparation .............................................................................................. 10 3.1.2. Certificate and Keys Generation ................................................................................... 10 3.1.3. Certificate and Key Replacement ................................................................................. 11 3.2. QFPROM Configurations ......................................................................................................... 11 3.2.1. Parameter Configuration ............................................................................................... 11 3.2.2. sec.dat File Generation ................................................................................................. 12 3.3. Image Signing .......................................................................................................................... 13 3.3.1. Modules with Flash Memory in 128 M .......................................................................... 13 3.3.2. Modules with Flash Memory in 256 M or 512 M ........................................................... 14 3.4. Secure Firmware Downloading................................................................................................ 15 4 FAQs................................................................................................................................................... 17 4.1. Do I Need to Execute Certificate Chain Repeatedly ............................................................... 17 4.2. Do I Need to Generate sec.dat Repeatedly............................................................................. 17 4.3. Can Unsigned Firmware Run on Module ................................................................................ 17 4.4. Can Original Firmware Be Downloaded After Enabling Secure Boot ..................................... 17 4.5. How to Perform Verification After Enabling Secure Boot ........................................................ 17 4.6. Does Secure Boot Still Work After Erasing sec Partition ........................................................ 18 5 Appendix References ....................................................................................................................... 19 EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 4 / 19 LTE Standard Module Series Table Index Table 1: Applicable Module .......................................................................................................................... 7 Table 2: Terms and Abbreviations ............................................................................................................. 19 EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 5 / 19 LTE Standard Module Series Figure Index Figure 1: Secure Boot Flow Chart................................................................................................................ 8 Figure 2: Generate Certificates and Keys.................................................................................................. 10 Figure 3: Certificates and Keys .................................................................................................................. 11 Figure 4: Configure QFPROM Parameter.................................................................................................. 12 Figure 5: sec.dat File.................................................................................................................................. 12 Figure 6: Prepare Images to Be Signed..................................................................................................... 13 Figure 7: Sign Images ................................................................................................................................ 13 Figure 8: Signed Images List ..................................................................................................................... 14 Figure 9: Prepare Images to Be Signed..................................................................................................... 14 Figure 10: Sign Images .............................................................................................................................. 14 Figure 11: Signed Images List ................................................................................................................... 15 Figure 12: Firmware Package with sec.dat File......................................................................................... 15 EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 6 / 19 LTE Standard Module Series 1 Introduction This document explains how to enable Secure Boot on Quectel EC2x family, EG2x family and EG9x family modules. 1.1. Applicable Module Table 1: Applicable Module Module Family EC2x EG2x EG9x Module EC20-CE EC21 Series EC25 Series EG21-G EG25-G EG21-GL EG25-GL EG91 Series EG95 Series 1NOTE This document is applicable to the above modules and their QuecOpen® solutions. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 7 / 19 LTE Standard Module Series 2 Secure Boot Overview 2.1. Definition Secure Boot refers to the secure bootup sequence that establishes a trusted platform by incorporating signature verification. It ensures that only authorized software is executed during the boot process. Secure Boot system incorporates signature verification to each stage of the module booting process to prevent the execution of any unauthorized or maliciously modified software on the module. 2.2. Flow Chart Figure 1: Secure Boot Flow Chart EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 8 / 19 LTE Standard Module Series 2NOTE According to the image signature format, Secure Boot is divided into two parts: ⚫ Classic Secure Boot mechanism that does not support signing HLOS (Kernel and FS) images. ⚫ Aboot (Bootloader) authentication with the authentication of Kernel (mdm9607-perf-boot.img). The public key certificate used for authentication is stored in the aboot file. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 9 / 19 LTE Standard Module Series 3 Secure Boot Enabling Procedures 3.1. Certificate Chain Generation 3.1.1. Environment Preparation 1. Software environment: Ubuntu system, Python 2.7, OpenSSL 1.0.2 or later versions. 2. Contact Quectel Technical Support for the corresponding tool installation packages gencerts.zip for generating certificates and keys as well as ql_9207_nork_mro_SecBootTools_Release_v1.2m.tar.gz used for generating signed images. 3.1.2. Certificate and Keys Generation To generate the certificates and keys: Step 1: Open Ubuntu terminal window and unzip gencerts.zip Step 2: Execute ./genCerts.sh to generate certificates and keys. Figure 2: Generate Certificates and Keys EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 10 / 19 LTE Standard Module Series If the command is executed successfully, the generated certificates and keys will be stored under the /certs of gencerts.zip directory. Figure 3: Certificates and Keys 3.1.3. Certificate and Key Replacement To replace the certificates and keys: Step 1: Unzip the ql_9207_nork_mro_SecBootTools_Release_v1.2m.tar.gz tool package. Step 2: Copy the newly generated oem_rootca.key, oem_rootca.cer, oem_attestationca.key and oem_attestationca.cer files to the ql_9207_nork_mro_SecBootTools_Release_v1.2m/cert directory to replace the existing files in the directory with the newly copied files. 3.2. QFPROM Configurations QFPROM, which stores configurations related to chip authentication in Non-Volatile ROM, can achieve the safe environment required by Secure Boot. This chapter provides an overview of the parameter configurations that must be set before signing images. 3.2.1. Parameter Configuration To configure the parameters: Step 1: Open the 9607_fuseblower_USER.xml file in the common/sectools/config/9607 directory of ql_9207_nork_mro_SecBootTools_Release_v1.2m package. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 11 / 19 LTE Standard Module Series Step 2: Locate the root_cert_hash parameter within the file and replace the existing value with the new value. Note that the other option values typically remain at their default settings. Figure 4: Configure QFPROM Parameter 3NOTE The value of root_cert_hash is obtained by signing oem_rootca.cer file with SHA256 algorithm. To obtain the value, execute sha256sum oem_rootca.cer in Ubuntu terminal window. 3.2.2. sec.dat File Generation Execute genSecdat.sh in Ubuntu terminal window to generate sec.dat. The file will be stored in the output/SecDat of ql_9207_nork_mro_SecBootTools_Release_v1.2m directory. Figure 5: sec.dat File EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 12 / 19 LTE Standard Module Series 3.3. Image Signing 3.3.1. Modules with Flash Memory in 128 M 1. Unzip the latest firmware package, replace all images to be signed in the of ql_9207_nork_mro_SecBootTools_Release_v1.2m/firmwares directory with the signed versions: Figure 6: Prepare Images to Be Signed 2. Copy ql-rootfs.tar.gz file from the secboot folder in the firmware package to the ql_9207_nork_mro_SecBootTools_Release_v1.2m/firmwares directory. 3. Follow the instructions in the README file of ql_9207_nork_mro_SecBootTools_Release_v1.2m to create a Docker environment. Run the signImage.sh script of ql_9207_nork_mro_SecBootTools_Release_v1.2m in the newly created Docker environment to sign the images. Figure 7: Sign Images 4. The signed images will be stored in ql_9207_nork_mro_SecBootTools_Release_v1.2m/output/SignImg. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 13 / 19 LTE Standard Module Series Figure 8: Signed Images List 1NOTE When you copy the singed images from the SignImg folder to the update directory in the firmware package, you also need to copy the mdm9607-sysfs.ubi in the ql-rootfs folder. 3.3.2. Modules with Flash Memory in 256 M or 512 M 1. Unzip the latest firmware package, and replace all images to be signed in the ql_9207_nork_mro_SecBootTools_Release_v1.2m/firmwares directory with the signed ones: Figure 9: Prepare Images to Be Signed 2. Follow the instructions in the README file of ql_9207_nork_mro_SecBootTools_Release_v1.2m to create a Docker environment. Run the signImage.sh script of ql_9207_nork_mro_SecBootTools_Release_v1.2m in the newly created Docker environment to sign the images. Figure 10: Sign Images EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 14 / 19 LTE Standard Module Series 3. The signed images will be stored in ql_9207_nork_mro_SecBootTools_Release_v1.2m/output/SignImg. Figure 11: Signed Images List 3.4. Secure Firmware Downloading 1. The generated firmware package includes the signed images and sec.dat, as shown below. Among them, the sec.dat, patition.mbn and partion_nand.xml files are used to enable Secure Boot without signed images. Figure 12: Firmware Package with sec.dat File 2. Download the firmware package without sec.dat to verify if the module can be booted normally. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 15 / 19 LTE Standard Module Series 3. Once the module is booted successfully, download sec.dat separately. Before downloading, you must modify rawprogram_nand_p2K_b128K_update.xml file (for modules with 128 M or 256 M flash memory) or rawprogram_nand_p4K_b256K_update.xml (for modules with 512 M flash memory) in the update/firehouse/ directory of the firmware package to support downloading the sec partition. Contact Quectel Technical Support for the rawprogram_nand_p2K_b128K_update.xml or rawprogram_nand_p4K_b256K_update.xml file. 2NOTE Secure Boot must be enabled during the module production stage. Enabling Secure Boot after upgrading the module to a version that supports Secure Boot is strictly prohibited, as it may result in abnormal functioning and irrecoverable issues. No configuration, such as SIMLock configuration, should be performed before enabling Secure Boot. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 16 / 19 LTE Standard Module Series 4 FAQs 4.1. Do I Need to Execute Certificate Chain Repeatedly If the keys and certificates remain unchanged, there is no need to execute certificate chain repeatedly. The certificate chain only needs to be generated once. For subsequent firmware upgrades, you only need to re-sign the images (see Chapter 3.3 for details). 4.2. Do I Need to Generate sec.dat Repeatedly If the module model and root certificate remain unchanged, there is no need to re-generate sec.dat. 4.3. Can Unsigned Firmware Run on Module Before enabling Secure Boot, unsigned firmware can run on the module. However, once Secure Boot is enabled, unsigned firmware cannot run on the module. 4.4. Can Original Firmware Be Downloaded After Enabling Secure Boot You can only download the original firmware with fastboot method. 4.5. How to Perform Verification After Enabling Secure Boot Perform verification by downloading the original incorrectly signed firmware. Once Secure Boot is enabled, firmware that is not properly signed cannot be downloaded. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 17 / 19 LTE Standard Module Series 4.6. Does Secure Boot Still Work After Erasing sec Partition Erasing sec partition does not affect the functionality of Secure Boot. EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 18 / 19 LTE Standard Module Series 5 Appendix References Table 2: Terms and Abbreviations Abbreviation HLOS IoT QFPROM ROM Description High Level Operating System Internet of Things Qualcomm Fuse Programmable Read Only Memory Read Only Memory EC2x&EG2x&EG9x_Series_Secure_Boot_Application_Note 19 / 19

LC02H&LC29H&LC79H 系列 AGNSS 应用指导 GNSS 模块系列 版本：1.0 日期：2023-06-29 状态：受控文件 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 文档历史 文档信息 标题 副标题 文档类别 文档状态 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 GNSS 模块系列 应用指导 受控文件 修订记录 版本 1.0 日期 2023-04-14 2023-06-29 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 1.1. Host EPO 和 Flash EPO 的区别 ................................................................................................ 9 1.2. AGNSS 要求............................................................................................................................. 10 2 EPO 文件下载 ..................................................................................................................................... 11 2.1. 从服务器下载 EPO 文件............................................................................................................11 2.2. EPO 文件格式 .......................................................................................................................... 12 2.2.1. EPO 文件格式—单 GPS................................................................................................ 13 2.2.2. EPO 文件格式：单 BDS/单 Galileo............................................................................... 14 2.2.3. EPO 文件格式：GPS + GLONASS .............................................................................. 16 2.3. EPO 文件类型 .......................................................................................................................... 16 2.4. EPO 文件下载流程 ................................................................................................................... 17 2.5. EPO 文件有效期....................................................................................................................... 18 3 AGNSS 实现方法 ................................................................................................................................ 20 3.1. Flash EPO 实现 AGNSS .......................................................................................................... 20 3.1.1. 二进制协议 .................................................................................................................... 20 3.1.2. EPO 数据传输协议 ........................................................................................................ 22 3.1.2.1 EPO 数据传输协议的伪代码............................................................................... 22 3.1.3. Flash EPO 流程............................................................................................................. 26 3.2. Host EPO 实现 AGNSS ........................................................................................................... 27 3.2.1. Host EPO 的推荐流程 ................................................................................................... 27 3.2.2. 发送 EPO 的示例代码.................................................................................................... 28 4 AGNSS 相关消息 ................................................................................................................................ 31 4.1. PAIR001 PAIR_ACK ................................................................................................................ 31 4.2. PAIR010 PAIR_REQUEST_AIDING........................................................................................ 32 4.3. PAIR470 PAIR_EPO_GET_STATUS ....................................................................................... 33 4.4. PAIR471 PAIR_EPO_SET_DATA ............................................................................................ 34 4.5. PAIR472 PAIR_EPO_ERASE_FLASH_DATA ......................................................................... 35 4.6. PAIR590 PAIR_TIME_SET_REF_UTC ................................................................................... 36 4.7. PAIR600 PAIR_LOC_SET_REF .............................................................................................. 37 5 使用 QGNSS 下载 EPO 数据 .............................................................................................................. 39 5.1. 使用 QGNSS 下载 Flash EPO ................................................................................................. 39 5.2. 使用 QGNSS 下载 Host EPO................................................................................................... 40 6 AGNSS 实现示例 ................................................................................................................................ 42 6.1. Flash EPO 实现 AGNSS .......................................................................................................... 42 6.2. Host EPO 实现 AGNSS ........................................................................................................... 43 上海移远通信技术股份有限公司 4 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 7 附录 A 参考文档及术语缩写 .............................................................................................................. 45 8 附录 B 特殊符号 ................................................................................................................................. 47 上海移远通信技术股份有限公司 5 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 8 表 2：Host EPO 和 Flash EPO 的区别 ........................................................................................................ 9 表 3：AGNSS 相关命令 ............................................................................................................................. 10 表 4：下载 EPO 文件的 URL.......................................................................................................................11 表 5：EPO 数据的 SVID 范围 .................................................................................................................... 12 表 6：EPO 文件类型 .................................................................................................................................. 16 表 7：二进制协议字段说明......................................................................................................................... 21 表 8：二进制格式起始消息......................................................................................................................... 21 表 9：二进制格式 EPO 数据消息 ............................................................................................................... 21 表 10：二进制格式结束消息....................................................................................................................... 21 表 11：参考文档 ......................................................................................................................................... 45 表 12：术语和缩写 ..................................................................................................................................... 45 表 13：特殊符号 ......................................................................................................................................... 47 上海移远通信技术股份有限公司 6 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 图片索引 图 1：EPO 文件格式（单 GPS）............................................................................................................... 13 图 2：EPO 文件的几段格式 ....................................................................................................................... 13 图 3：EPO 文件格式（单 BDS/单 Galileo） .............................................................................................. 14 图 4：Galileo EPO 数据头.......................................................................................................................... 15 图 5：BDS EPO 数据头 ............................................................................................................................. 15 图 6：EPO 文件格式（GPS + GLONASS）.............................................................................................. 16 图 7：EPO 文件相关下载流程.................................................................................................................... 17 图 8：二进制协议消息结构......................................................................................................................... 20 图 9：Flash EPO 的 AGNSS 流程 ............................................................................................................. 26 图 10：Host EPO 的建议流程 .................................................................................................................... 28 图 11：用于设置 Flash EPO 的 QGNSS 界面............................................................................................ 39 图 12：下载 Flash EPO 文件 ..................................................................................................................... 40 图 13：用于设置 Host EPO 的 QGNSS 界面 ............................................................................................. 41 图 14：下载 Host EPO 文件....................................................................................................................... 41 上海移远通信技术股份有限公司 7 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 1 引言 移远通信 GNSS 模块支持 EPO AGNSS 功能，此功能可缩短接收机首次定位时间。本文档主要介绍 EPO 文件下载、AGNSS 实现、AGNSS 相关的 PAIR 命令以及如何通过 QGNSS 工具下载 EPO 数据。 表 1：适用模块 模块系列 LC02H LC29H LC79H 型号 LC02H (BC) LC29H (AA) LC29H (BA) LC29H (BS) LC29H (CA) LC29H (DA) LC29H (EA) LC79H (AL) 上海移远通信技术股份有限公司 8 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 1.1. Host EPO 和 Flash EPO 的区别 Host EPO 和 Flash EPO 都可以缩短 GNSS 接收机的首次定位时间，但它们之间的差异使其各自适用 于不同的应用场景。 Host EPO（也称为实时 AGNSS）允许接收机在 RAM 中存储最多 6 小时的辅助数据，通过第 4 章 AGNSS 相关消息中列出的 NMEA PAIR 命令，可将这些辅助数据发送到接收机。对于 Host EPO，因数据 保存在 RAM 区，在重启模块之后数据将丢失，所以需要在每次开机后重新注入。 Flash EPO 允许接收机在 Flash 中存储 3 天、7 天或 14 天的辅助数据，这些辅助数据通过二进制协议 发送到接收机。Flash EPO 使接收机能够在信息过期之前重复使用存储在 Flash 中的所有辅助信息。EPO 文件的有效期见第 2.5 章 EPO 文件有效期。 表 2：Host EPO 和 Flash EPO 的区别 类型 存储空间 存储容量 协议 Flash EPO Flash 3 天、7 天或 14 天的辅助数据 二进制协议 Host EPO RAM 6 小时的辅助数据 NMEA 协议 备注 单 GPS EPO 文件和 GPS + GLONASS EPO 文件的 EPO 数据能在 Flash 中保存的时间最长为 14 天，单 Galileo EPO 文件最长保存时间为 7 天，单 BDS EPO 文件最长保存时间为 3 天。如果发送 30 天的单 GPS EPO 文件或 GPS + GLONASS EPO 文件，则只会存储前 14 天的 EPO 数据。 上海移远通信技术股份有限公司 9 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 1.2. AGNSS 要求 主机需要向 GNSS 接收机提供参考时间、参考位置和 EPO 数据。主机提供的信息必须满足以下要 求，以便 GNSS 接收机更好地使用 EPO 数据： ⚫ 参考时间与实际时间误差应在 3 秒内，且必须为 UTC 时间。 ⚫ 参考位置与接收机实际位置的误差应在 30 公里以内。请注意，如果接收机的天空视野有限，则需 要提高参考位置的精度。 ⚫ EPO 数据需有效。 通过注入辅助数据，可以缩短接收机的首次定位时间。接收机可以使用任一种辅助数据（参考时间、 参考位置和 EPO 数据），但三种辅助数据都不是必需的，只有当所有的辅助数据都注入时，才能达到最佳 AGNSS 效果。禁止使用过期或无效的数据，否则可能会导致更长的 TTFF。 主机可以通过下表中列出的消息将参考时间、参考位置和 EPO 数据发送到 GNSS 接收机。有关这些 消息的详情，请参阅第 4 章 AGNSS 相关消息。 表 3：AGNSS 相关命令 数据包类型 $PAIR471 $PAIR590 $PAIR600 数据内容 单颗卫星的 GPS/GLONASS/Galileo/BDS EPO 数据 参考 UTC 时间 参考位置 上海移远通信技术股份有限公司 10 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 2 EPO 文件下载 移远通信不提供任何有关 EPO 文件的服务级别协议。用户需要自行下载 EPO 数据到服务器并发送到 设备，同时要确保 EPO 数据的可用性。 2.1. 从服务器下载 EPO 文件 表 4：下载 EPO 文件的 URL EPO 类型 统一 QEPO 统一 QEPO 统一 QEPO 统一 QEPO EPO EPO EPO EPO GNSS 类型 EPO 文件 URL 文件名称 GPS only GPS + GLONASS BDS only Galileo only GPS only GPS + GLONASS BDS only Galileo only http://wpepodownload.mediatek.co m/QGPS.DAT?vendorinfo http://wpepodownload.mediatek.co m/QG_R.DAT?vendorinfo http://wpepodownload.mediatek.co m/QBD2.DAT?vendorinfo http://wpepodownload.mediatek.co m/QGA.DAT?vendorinfo http://wpepodownload.mediatek.co m/EPO_GPS_3_X.DAT?vendorinfo http://wpepodownload.mediatek.co m/EPO_GR_3_X.DAT?vendorinfo http://wpepodownload.mediatek.co m/EPO_BDS_3.DAT?vendorinfo http://wpepodownload.mediatek.co m/EPO_GAL_X.DAT?vendorinfo 单个名称: QGPS.DAT 单个名称: QG_R.DAT 单个名称: QBD2.DAT 单个名称: QGA.DAT X = 1~10 EPO_GPS_3_1.DAT 至 EPO_GPS_3_10.DAT X = 1~10 EPO_GR_3_1.DAT 至 EPO_GR_3_10.DAT EPO_BDS_3.DAT X = 3或7 EPO_GAL_3.DAT 或 EPO_GAL_7.DAT 上海移远通信技术股份有限公司 11 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 以下是完整的 URL 示例： http://wpepodownload.mediatek.com/QGPS.DAT?vendor=AAA&project=BBB&device_id=CCC ⚫ 查询字符串以'？'开头，以'&'分隔。 ⚫ 'vendor'和'project'（示例中的 AAA 和 BBB）的值由移远通信发布。请联系移远通信技术支 持获取该值。 'device_id'（示例中的 CCC）的值由客户指定，必须保证每台设备唯一。如果设备有 IMEI，则推荐 使用 IMEI。 备注 1. 最多有 10 个文件，因为仅 GPS 或 GPS + GLONASS EPO 文件可能包含最多 30 天的预测。30 天 EPO 分割如下： _1，第 1 天到第 3 天， _2，第 4 到 6 天， …… _10，第 28 至 30 天。 2. 主机使用同一个'device_id'，每天访问 AGNSS 服务器的次数不应超过 20 次，否则将访问失败。 2.2. EPO 文件格式 本章主要介绍 EPO 文件的格式。 不同星系 EPO 文件的 SVID 号如下所示。 表 5：EPO 数据的 SVID 范围 GNSS 类型 GPS GLONASS Galileo BDS PRN 1~32 1~24 1~36 1~54, 55~63 EPO 数据 SVID 1~32 65~88 101~136 201~254, 190~198 上海移远通信技术股份有限公司 12 / 47 2.2.1. EPO 文件格式：单 GPS LC02H&LC29H&LC79H 系列 AGNSS 应用指导 第1天 第2天 ... 第7天 ... 第29天 第30天 EPO格式（1天） 片段 UTC 片段1 0:00-6:00 片段2 6:00-12:00 片段3 12:00-18:00 片段4 18:00-24:00 EPO格式（1个片段） SV1 SV2 ... SV31 SV32 EPO格式（1颗卫星） 数据 GPS_时 SYSID 字节偏移 0[LSB]~2[MSB] 3 数据 ... 字节偏移 ... ... 4~7 ... 64~67 ... 8~11 校验和 68~71 图 1：EPO 文件格式（单 GPS） GPS_秒 = GPS_时 × 3600 GPS_周 = GPS_秒 / 604800 GPS 周内秒 = GPS_秒 % 604800 EPO 文件包含 GPS 时间（GPS_周、GPS_时和 GPS_秒）。GPS 时间的最大单位是 GPS 周，大约从 1980 年 1 月 5 日到 6 日凌晨开始计算。 下图说明了 EPO 文件的几个片段的格式。 SAT 数据 SAT 数据 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 EPO 数据集 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 EPO 数据集 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 EPO 数据集 图 2：EPO 文件的几段格式 上海移远通信技术股份有限公司 13 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 EPO 文件的基本单位是 SAT 数据，每个 SAT 数据的大小为 72 字节。一个 EPO 数据集包含 32 个 SAT 数据，所以一个 EPO 数据集大小为 2304 字节。每个 EPO 文件包含多个 EPO 数据集，因此文件大小必须 是 2304 字节的倍数。EPO 数据集的有效期为 6 小时，因此，1 天内包含 4 个 EPO 数据集。 2.2.2. EPO 文件格式：单 BDS/单 Galileo 单 Galileo EPO 数据由 72 字节的数据头和 3 天或 7 天的基本 EPO 数据组成。单 BDS EPO 数据仅由 72 字节的数据头和 3 天的基本 EPO 数据组成。两者都没有固定大小。 数据头 72字节 第1天 EPO格式（1天） 片段 UTC 第2天 第3天 ... 第7天 片段1 0:00-6:00 片段2 6:00-12:00 片段3 12:00-18:00 片段4 18:00-24:00 EPO格式（1个片段） SV SV ... SV SV EPO格式（1颗卫星） 数据 GPS_时 SYSID 字节偏移 0[LSB]~2[MSB] 3 数据 ... 字节偏移 ... ... 4~7 ... 64~67 ... 8~11 校验和 68~71 图 3：EPO 文件格式（单 BDS/单 Galileo） 72 字节的数据头包含用于计算 SV 的可用位掩码。当 SV 可用位掩码位置为 1 时，表示卫星可用，所 在位数表示 SV。 可参考图 4：Galileo EPO 数据头方式解析 Galileo EPO 文件数据。 ⚫ Galileo 的 SYSID：FE。 ⚫ SV 可用位掩码：09 67 94 5D DF。 ⚫ 可用 SV 总数：22。 ⚫ 可用的 SV：1、2、3、4、5、7、8、9、11、12、13、15、19、21、24、25、26、27、30、31、 33、36。 上海移远通信技术股份有限公司 14 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 数据 *** SYSID SV 有效位掩码 （低字节） 字节偏移 0~2 3 4[LSB]~7[MSB] 示例 FE DF 5D 94 67 数据 字节偏移 SV 有效位掩码 （高字节） 16[LSB]~19[MSB] 示例 09 00 00 00 *** 20~23 *** 8~11 *** 24~27 *** 12~15 *** 18~31 图 4：Galileo EPO 数据头 可参考图 5：BDS EPO 数据头方式解析 BDS EPO 文件数据。 ⚫ BDS 的 SYSID：FF。 ⚫ SV 可用位掩码：3F FF BF FC 3F FF。 ⚫ 可用 SV 总数：41。 ⚫ 可用 SV：1、2、3、4、5、6、7、8、9、10、11、12、13、14、19、20、21、22、23、24、25、 26、27、28、29、30、32、33、34、35、36、37、38、39、40、41、42、43、44、45、46。 数据 *** SYSID SV 有效位掩码 （低字节） 字节偏移 0~2 3 4[LSB]~7[MSB] 示例 FF FF 3F FC BF *** 8~11 *** 12~15 数据 字节偏移 SV 有效位掩码 （高字节） 16[LSB]~19[MSB] 示例 FF 3F 00 00 *** 20~23 *** 24~27 *** 18~31 图 5：BDS EPO 数据头 上海移远通信技术股份有限公司 15 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 2.2.3. EPO 文件格式：GPS + GLONASS SAT 数据 SAT 数据 1 2 1 2 31 32 65 66 31 32 65 66 87 88 87 88 1 2 31 32 65 66 87 88 GPS EPO 数据集 GLONASS EPO 数据集 图 6：EPO 文件格式（GPS + GLONASS） EPO 文件的基本单位是 SAT 数据，每个 SAT 数据的大小为 72 字节。在 GPS + GLONASS EPO 文件 中，一个 EPO 数据集包含 56 个 SAT 数据，所以 EPO 数据集大小为 4032 字节。每个 EPO 文件包含多个 EPO 数据集。因此文件大小必须是 4032 字节的倍数。EPO 数据集的有效期为 6 小时，因此，一天会有 4 个 EPO 数据集。 2.3. EPO 文件类型 EPO 数据可以以文件形式下载。可以根据数据连接的可用性和应用中存储空间情况选择最合适的文件 类型进行下载。请参考表 4：下载 EPO 文件的 URL 和表 6：EPO 文件类型选择要下载的文件类型。 表 6：EPO 文件类型 EPO 类型 GNSS 类型 EPO 单 GPS EPO 单 Galileo 描述 3~14 天的预测轨道（星历）。 分成 5 个文件，每个文件包含 3 天的信息。 3 天或 7 天预测轨道（星历）。 上海移远通信技术股份有限公司 16 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 EPO 类型 EPO EPO 统一 QEPO 统一 QEPO 统一 QEPO GNSS 类型 描述 单 BDS 3 天的预测轨道（星历）。 GPS + GLONASS 单 GPS GPS + GLONASS 单 BDS 或单 Galileo 3~14 天的预测轨道（星历）。 分成 5 个文件，每个文件包含 3 天的信息。 6 小时的预测轨道（星历）。 单个文件包含最新可用的 GPS EPO 数据。 6 小时的预测轨道（星历）。 单个文件包含最新可用的 GPS + GLONASS EPO 数据。 6 小时的预测轨道（星历）。 单个文件包含最新可用的 BDS 或 Galileo EPO 数据。 2.4. EPO 文件下载流程 设置定时以检查EPO有 效性 到达定时时间 GNSS接收机上电 EPO文件过期 1) 下载3天的EPO文件备 份 验证下载的数据 2) 是否有有效的EPO 是 文件？ 3) 否 下载统一QEPO文件 EPO 使用备份文件辅助 验证下载的数据 完成定位 备份已验证的EPO文件 完成定位 图 7：EPO 文件相关下载流程 备注 1. 1) 用户必须知道当前的 UTC 时间才能下载有效的 EPO 文件。 2. 2) 发送$PAIR470 命令检查数据是否正确。 上海移远通信技术股份有限公司 17 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 3. 3) 如果设备长时间断电，flash 中存储的 EPO 文件可能会过期。 2.5. EPO 文件有效期 EPO 文件有效期与当前 UTC 时间有关。EPO 文件的有效期可以从 EPO 文件的最后一段中得到。参考 图 1：EPO 文件格式（单 GPS）或如何计算 EPO 文件有效期的示例（GPS_时 + 6）。需要提前 12 小时 下载 EPO 文件。以下代码显示了 UTC 时间和 GPS 时间之间的转换。 void utc_to_gpstime(kal_uint32 year, //Input year kal_uint8 mon, //Input month: 1~12 kal_uint8 day, //Input day: 1~31 kal_uint8 hour, //Input hour: 0~23 kal_uint8 min, //Input minute: 0~59 kal_uint8 sec, //Input second: 0~59 kal_int32* wn, //Output GPS week number double* tow) //Output GPS time of week { kal_int32 iYearsElapsed; //Elapsed years since 1980 kal_int32 iDaysElapsed; //Elapsed days since Jan 5/Jan 6, 1980 kal_int32 iLeapDays; //Leap days since Jan 5/Jan 6, 1980 kal_int32 i; //Number of days at the start of each month (ignore leap years). kal_uint16 doy[12] = {0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334}; iYearsElapsed = year - 1980; i = 0; iLeapDays = 0; while (i <= iYearsElapsed) { if ((i % 100) == 20) { if ((i % 400) == 20) { iLeapDays++; } } else if ((i % 4) == 0) { iLeapDays++; } i++; } /* iLeapDays = iYearsElapsed / 4 + 1; */. if ((iYearsElapsed % 100) == 20) { if (((iYearsElapsed % 400) == 20) && (mon <= 2)) { iLeapDays--; } } 上海移远通信技术股份有限公司 18 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 else if (((iYearsElapsed % 4) == 0) && (mon <= 2)) { iLeapDays--; } iDaysElapsed = iYearsElapsed * 365 + doy[mon - 1] + day + iLeapDays - 6; //Convert time to GPS weeks and seconds. *wn = iDaysElapsed / 7; *tow = (double)(iDaysElapsed % 7) * 86400 + hour * 3600 + min * 60 + sec; } 上海移远通信技术股份有限公司 19 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 3 AGNSS 实现方法 本章介绍两种 AGNSS 实现方法：Host EPO 和 Flash EPO。 ⚫ 使用 Host EPO 实现 AGNSS 主机通过 NMEA PAIR 命令（例如$PAIR471）向 GNSS 接收机发送 EPO 数据。 ⚫ 使用 Flash EPO 实现 AGNSS EPO 数据通过二进制协议下载到 GNSS 接收机的 Flash 中。 Flash EPO 比 Host EPO 保留数据的时间更长。 3.1. Flash EPO 实现 AGNSS Flash EPO 可以在 Flash 中存储长达 14 天的 EPO 辅助数据，这使接收机能够使用自启动时间以来的 可用数据。Flash EPO 使用二进制协议进行通信。因此，应以下文所述二进制格式将辅助数据下载到 GNSS 接收机。详见第 3.1.2 章 EPO 数据传输协议和第 3.1.3 章 Flash EPO 流程。 3.1.1. 二进制协议 帧头，固定为0x04 0x24 2字节 消息 ID 2字节消息长度 1字节 校验 帧尾，固定为 0xAA 0x44 帧头 消息ID 长度 有效载荷 校验和计算范围 校验和 帧尾 图 8：二进制协议消息结构 上海移远通信技术股份有限公司 20 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 表 7：二进制协议字段说明 字段 帧头 消息 ID 长度 有效载荷 校验和 帧尾 长度（字节） 2 2 2 可变 1 2 描述 固定为 0x2404。 小端。 消息 ID。 有效载荷的长度。单位：字节。 默认数据包大小：72 字节。 小端。 待传输的有效内容。 校验和是消息中帧头和校验和之间（不包括帧头和校验和）的所有字 节的 8 位异或校验码。 固定为 0x44AA。 小端。 EPO二进制格式分为起始消息、EPO数据消息和结束消息。 表 8：二进制格式起始消息 帧头 消息 ID 长度 0x04 0x24 0xB0 0x04 1 2 字节 2 字节 2 字节 有效荷载 ‘G’ – GPS ‘R’ – GLONASS ‘E’ – Galileo ‘C’ – BDS 1 字节 校验和 0x** 1 字节 帧尾 0xAA 0x44 2 字节 表 9：二进制格式 EPO 数据消息 帧头 0x04 0x24 2 字节 消息 ID 0xB1 0x04 2 字节 长度 72 2 字节 有效荷载 EPO 数据 72 字节 校验和 0x** 1 字节 帧尾 0xAA 0x44 2 字节 表 10：二进制格式结束消息 帧头 消息 ID 长度 0x04 0x24 0xB2 0x04 1 上海移远通信技术股份有限公司 有效荷载 ‘G’ – GPS ‘R’ – GLONASS 校验和 0x** 帧尾 0xAA 0x44 21 / 47 帧头 2 字节 消息 ID 长度 2 字节 2 字节 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 有效荷载 ‘E’ – Galileo ‘C’ – BDS 1 字节 校验和 1 字节 帧尾 2 字节 3.1.2. EPO 数据传输协议 当传输辅助数据时，主机先发送起始消息包，然后将 EPO 数据拆分成数据包发送，最后发送结束消息 包。主机在将 EPO 数据传输到 GNSS 接收机时应遵循 EPO 数据传输协议。 3.1.2.1 EPO 数据传输协议的伪代码 GPS + GLONASS 的 EPO 数据传输过程的伪码如下，仅供参考： #define GNSS_APP_BINARY_BINARY_PREAMBLE1 #define GNSS_APP_BINARY_BINARY_PREAMBLE2 #define GNSS_APP_BINARY_BINARY_ENDWORD1 #define GNSS_APP_BINARY_BINARY_ENDWORD2 (0x04) (0x24) (0xAA) (0x44) #define GNSS_APP_BINARY_BINARY_PREAMBLE_SIZE (2) #define GNSS_APP_BINARY_BINARY_CHECKSUM_SIZE (1) #define GNSS_APP_BINARY_BINARY_ENDWORD_SIZE (2) #define GNSS_APP_BINARY_BINARY_CONTROL_SIZE (GNSS_APP_BINARY_BINARY_PREAMBLE_SIZE + GNSS_APP_BINARY_BINARY_CHECKSUM_SIZE + GNSS_APP_BINARY_BINARY_ENDWORD_SIZE) #define GNSS_APP_BINARY_BINARY_MESSAGE_ID_SIZE (2) #define GNSS_APP_BINARY_BINARY_PAYLOAD_LENGTH_SIZE (2) #define GNSS_APP_BINARY_BINARY_PAYLOAD_HEADER_SIZE (GNSS_APP_BINARY_BINARY_MESSAGE_ID_SIZE + GNSS_APP_BINARY_BINARY_PAYLOAD_LENGTH_SIZE) #define GNSS_APP_BINARY_BINARY_MAX_DATA_SIZE (512) #define GNSS_APP_BINARY_BINARY_MAX_PAYLOAD_DATA_SIZE (GNSS_APP_BINARY_BINARY_MAX_DATA_SIZE - GNSS_APP_BINARY_BINARY_CONTROL_SIZE - GNSS_APP_BINARY_BINARY_PAYLOAD_HEADER_SIZE) typedef enum gnss_app_binary_binary_decode_results { GNSS_APP_BINARY_BINARY_DECODE_SUCCESS = 0, GNSS_APP_BINARY_BINARY_DECODE_WRONG_PARAMETER = -1, 上海移远通信技术股份有限公司 22 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 GNSS_APP_BINARY_BINARY_DECODE_WRONG_PREAMBLE = -2, GNSS_APP_BINARY_BINARY_DECODE_WRONG_CHECKSUM = -3, GNSS_APP_BINARY_BINARY_DECODE_WRONG_ENDWORD = -4, }gnss_app_binary_binary_decode_results_t; typedef struct gnss_app_binary_binary_payload { uint16_t message_id; uint16_t data_size; /* actual size of data in payload data buffer */ uint8_t data[GNSS_APP_BINARY_BINARY_MAX_PAYLOAD_DATA_SIZE]; }gnss_app_binary_binary_payload_t; uint8_t gnss_app_binary_calculate_binary_checksum(const gnss_app_binary_binary_payload_t* const payload) { uint8_t checksum = 0; uint8_t* pheader = NULL; uint8_t* pdata = NULL; uint16_t i; if (NULL == payload) { return 0; } /* The checksum is the 8-bit exclusive OR of all bytes in the payload. */ pheader = (uint8_t*)payload; for (i = 0; i < GNSS_APP_BINARY_BINARY_PAYLOAD_HEADER_SIZE; i++) { checksum ^= *pheader; pheader++; } pdata = (uint8_t*)payload->data; for (i = 0; i < payload->data_size; i++) { checksum ^= *pdata; pdata++; } return checksum; } int16_t gnss_app_binary_encode_binary_packet(uint8_t* const buffer, uint16_t max_buffer_size, const gnss_app_binary_binary_payload_t* const payload) { uint8_t* pbyte; uint16_t required_length; if (NULL == buffer || payload == NULL) { return -1; } required_length = payload->data_size + GNSS_APP_BINARY_BINARY_CONTROL_SIZE + GNSS_APP_BINARY_BINARY_PAYLOAD_HEADER_SIZE; 上海移远通信技术股份有限公司 23 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 if (max_buffer_size < required_length) { return -1; } memset((void*)buffer, 0, max_buffer_size); buffer[0] = GNSS_APP_BINARY_BINARY_PREAMBLE1; buffer[1] = GNSS_APP_BINARY_BINARY_PREAMBLE2; pbyte = &buffer[2]; memcpy(pbyte, payload, GNSS_APP_BINARY_BINARY_PAYLOAD_HEADER_SIZE); pbyte += GNSS_APP_BINARY_BINARY_PAYLOAD_HEADER_SIZE; memcpy(pbyte, payload->data, payload->data_size); pbyte += payload->data_size; *pbyte++ = gnss_app_binary_calculate_binary_checksum(payload); *pbyte++ = GNSS_APP_BINARY_BINARY_ENDWORD1; *pbyte = GNSS_APP_BINARY_BINARY_ENDWORD2; return required_length; } FILE* gnss_epo_file = NULL; #define GNSS_MAX_EPO_NUMBER (37) #define GNSS_MAX_RECORD_SIZE (72) static uint32_t gnss_epo_sv_buf[(GNSS_MAX_EPO_NUMBER * GNSS_MAX_RECORD_SIZE) / sizeof(uint32_t)]; int16_t gnss_epo_encode_binary(uint16_t msg_id, char* buffer, uint16_t buffer_size, char* data_input, int32_t data_length) { gnss_app_binary_binary_payload_t payload; int16_t binary_message_length; memset((void*)&payload, 0, sizeof(gnss_app_binary_binary_payload_t)); payload.message_id = msg_id; payload.data_size = (uint16_t)data_length; memcpy(payload.data, data_input, sizeof(uint8_t) * data_length); binary_message_length = gnss_app_binary_encode_binary_packet(buffer, buffer_size, &payload); return binary_message_length; } void gnss_epo_binary_demo() { gnss_app_binary_data_t data; gnss_app_binary_data_result_t result = { 0 }; uint32_t* epobuf; int32_t i; char buffer[500]; uint16_t length = 0; int32_t buffer_size = 0; uint8_t segment = 0; 上海移远通信技术股份有限公司 24 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 uint8_t curr_sys_type = 'G'; //type is the GPS gnss_epo_file = fopen('EPO_GR_3_1.DAT', 'rb'); length = gnss_epo_encode_binary(1200, buffer, 512, &curr_sys_type, 1); gnss_app_uart_send_data(buffer, length); memset(&gnss_epo_sv_buf, 0, sizeof(gnss_epo_sv_buf)); while (gnss_epo_read_data(&gnss_epo_sv_buf, 32 * GNSS_MAX_RECORD_SIZE, segment * (32 + 24) * GNSS_MAX_RECORD_SIZE)) { segment++; for (i = 0; i < 32; i++) { epobuf = (uint32_t*)(gnss_epo_sv_buf + ((i * GNSS_MAX_RECORD_SIZE) / 4)); length = gnss_epo_encode_binary(1201, buffer, 512, (char*)epobuf, GNSS_MAX_RECORD_SIZE); gnss_app_uart_send_data(buffer, length); } memset(&gnss_epo_sv_buf, 0, sizeof(gnss_epo_sv_buf)); } length = gnss_epo_encode_binary(1202, buffer, 512, &curr_sys_type, 1); gnss_app_uart_send_data(buffer, length); curr_sys_type = 'R'; //type is the GLONASS length = gnss_epo_encode_binary(1200, buffer, 512, &curr_sys_type, 1); gnss_app_uart_send_data(&data, &result); memset(&gnss_epo_sv_buf, 0, sizeof(gnss_epo_sv_buf)); segment = 0; while (gnss_epo_read_data(&gnss_epo_sv_buf, 37 * GNSS_MAX_RECORD_SIZE, (segment * (32 + 24) * GNSS_MAX_RECORD_SIZE) + (32 * GNSS_MAX_RECORD_SIZE))) { segment++; for (i = 0; i < 24; i++) { epobuf = (uint32_t*)(gnss_epo_sv_buf + ((i * GNSS_MAX_RECORD_SIZE) / 4)); length = gnss_epo_encode_binary(1201, buffer, 512, (char*)epobuf, GNSS_MAX_RECORD_SIZE); gnss_app_uart_send_data(buffer, length); } memset(&gnss_epo_sv_buf, 0, sizeof(gnss_epo_sv_buf)); } length = gnss_epo_encode_binary(1202, buffer, 512, &curr_sys_type, 1); gnss_app_uart_send_data(buffer, length); fclose(gnss_epo_file); } 上海移远通信技术股份有限公司 25 / 47 3.1.3. Flash EPO 流程 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 GNSS上电 是否有EPO文件 是 EPO文件是否已过期 否 发送参考时间 否 是 擦除EPO文件 使用二进制协议下载EPO文件 验证下载的数据 重启GNSS 发送参考位置 完成定位 图 9：Flash EPO 的 AGNSS 流程 1. GNSS 模块上电； 2. 用$PAIR470 命令检查 GNSS 模块 Flash 中是否有 EPO 数据； 3. 如果 Flash 中包含 EPO 数据，继续下一步检查数据有效性。否则，下载 EPO 数据到 GNSS 模块 并验证下载的数据，然后重启 GNSS 模块并执行步骤 5； 4. 检查 GNSS 模块 Flash 中的 EPO 文件是否过期； 5. 如果 EPO 文件仍然有效，转到步骤 6。否则，使用$PAIR472 命令擦除过期的 EPO 文件，并下载 新的 EPO 文件； 6. 使用$PAIR590 命令将参考时间发送到 GNSS 模块； 7. 使用$PAIR600 命令将参考位置发送到 GNSS 模块； 8. 等待 GNSS 模块定位。 上海移远通信技术股份有限公司 26 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 3.2. Host EPO 实现 AGNSS Host EPO 是更为简单的基于文本的 AGNSS 实现方式，它使接收机能够执行快速启动，每次启动时必 须将辅助数据发送到接收机。使用 Host EPO 时，接收机只能接收到 6 小时内有效的 1 块辅助数据。 实现 Host EPO 只需用到数个 PAIR 语句，整个数据传输可以在 NMEA 模式下进行。$PAIR471、 $PAIR590 和$PAIR600 的详细信息，请见第 4 章 AGNSS 相关消息。 3.2.1. Host EPO 的推荐流程 模块上电后，当辅助数据和星历均无效时，将发送辅助请求通知其存储的 GNSS 辅助数据已失效。因 此，如果模块没有上报辅助请求，建议主机收到系统启动报文后，通过发送$PAIR470 来判断辅助数据是否 过期。主机应按图 10：Host EPO 的建议流程所示的顺序发送辅助数据： Host EPO 推荐流程： 1. GNSS 模块启动； 2. 主机发送参考时间； 3. 主机发送参考位置； 4. 主机发送 EPO 数据。 参考时间、参考位置和 EPO 数据必须符合第 1.2 章 AGNSS 要求中列出的要求。 备注 确保主机在发送每一段 EPO 数据之后都能接收到模块返回的$PAIR001 语句。 上海移远通信技术股份有限公司 27 / 47 GNSS接收机 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 Host EPO顺序 主机 GNSS模块上电 启动消息 辅助数据（时间） PAIR001 (ACK) 辅助数据（位置） PAIR001 (ACK) 循环 [重复直到所有 EPO 数据发送完成] EPO 辅助数据片段 001 PAIR001 (ACK) EPO辅助数据片段 002 PAIR001 (ACK) 主机需要等待ACK包 图 10：Host EPO 的建议流程 3.2.2. 发送 EPO 的示例代码 以下是向模块发送一段 EPO 数据的参考代码。它说明了如何为 GNSS 接收机构建 PAIR 消息。本例中 不包括参考时间和参考位置的 PAIR 消息。 #define GNSS_GLONASS_EPO_BASE_ID (64) #define GNSS_GALILEO_EPO_BASE_ID (100) #define GNSS_BDS_EPO_BASE_ID (200) #define MNL_SERVICE_MAX_COMMAND_LEN (352) #define EPO_DEMO_RECORD_SIZE (72) typedef enum{ EPO_DEMO_MODE_GPS, EPO_DEMO_MODE_GLONASS, 上海移远通信技术股份有限公司 28 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 EPO_DEMO_MODE_GALILEO, EPO_DEMO_MODE_BEIDOU }epo_demo_mode_t; int32_t epo_demo_get_sv_prn(int32_t type, uint8_t *data) { int32_t sv_id, sv_prn = 0; sv_id = data[3]; switch(type) { case EPO_DEMO_MODE_GPS: sv_prn = sv_id; break; case EPO_DEMO_MODE_GLONASS: sv_prn = sv_id - GNSS_GLONASS_EPO_BASE_ID; break; case EPO_DEMO_MODE_GALILEO: if(sv_id == 255) { sv_prn = 255; } else { sv_prn = sv_id - GNSS_GALILEO_EPO_BASE_ID; } break; case EPO_DEMO_MODE_BDS: if(sv_id == 255) { sv_prn = 255; } else { sv_prn = sv_id - GNSS_BDS_EPO_BASE_ID; } break; default: sv_prn = 0; } return sv_prn; } void epo_demo_send_data(epo_demo_epo_data_t *data_p, int32_t data_num, int32_t type){ char temp_buffer[MNL_SERVICE_MAX_COMMAND_LEN] = {0}; uint8_t data_buffer[EPO_DEMO_RECORD_SIZE] = {0}; int32_t i; int32_t sv_prn = 0; for(i = 0; i < data_num; i++) { 上海移远通信技术股份有限公司 29 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 unsigned int *epobuf = (unsigned int *)data_buffer; epo_demo_epo_fread(data_p, data_buffer, EPO_DEMO_RECORD_SIZE); sv_prn = epo_demo_get_sv_prn(type, data_buffer); sprintf((char *) temp_buffer, '471,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X', (unsigned int)type, (unsigned int)sv_prn, epobuf[0], epobuf[1], epobuf[2], epobuf[3], epobuf[4], epobuf[5], epobuf[6], epobuf[7], epobuf[8], epobuf[9], epobuf[10], epobuf[11], epobuf[12], epobuf[13], epobuf[14], epobuf[15], epobuf[16], epobuf[17]); gnss_app_send_command_ex(temp_buffer); memset(temp_buffer, 0, MNL_SERVICE_MAX_COMMAND_LEN); } } 上海移远通信技术股份有限公司 30 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 4 AGNSS 相关消息 4.1. PAIR001 PAIR_ACK 确认 PAIR 命令。模块返回$PAIR001，通知发送方其已收到数据包。 类型： 输出 格式： $PAIR001,,* 参数： 字段 格式 十进制 十进制 单位 - - 描述 待确认的命令类型。 0 = 命令已成功发送。 1 = 正在处理命令，请等待结果。 2 = 命令发送失败。 3 = 不支持。 4 = 命令参数错误，如超出范围、某些参数丢失或校验和错误。 5 = MNL 服务忙。 示例： $PAIR001,0,3*38 上海移远通信技术股份有限公司 31 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 4.2. PAIR010 PAIR_REQUEST_AIDING 通知模块中存储的 GNSS 辅助数据已到期。该信息在模块上电时自动输出。 类型： 输出 格式： $PAIR010,,,,* 参数： 字段 格式 十进制 单位 - 十进制 - 十进制 周 十进制 秒 描述 待更新的数据类型。 0 = EPO 数据 1 = 时间 2 = 位置 所需的 GNSS 数据类型。 0 = GPS 数据 1 = GLONASS 数据 2 = Galileo 数据 3 = BDS 数据 周数（自适应周翻转）。 周内秒。 示例： //主机在收到模块输出此消息时发送 GPS EPO 数据： $PAIR010,0,0,2044,369413*33 //主机在收到模块输出此消息时发送参考时间： $PAIR010,1,-1*16 //主机在收到模块输出此消息时发送参考位置： $PAIR010,2,-1*15 备注 GNSS 模块自动输出此消息，请勿手动向模块发送此消息。 上海移远通信技术股份有限公司 32 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 4.3. PAIR470 PAIR_EPO_GET_STATUS 查询存储在 GNSS 芯片中的 EPO 数据的状态。 类型： 命令 格式： $PAIR470,* 参数： 字段 格式 单位 十进制 - 描述 GNSS 系统 ID。 0 = GPS 1 = GLONASS 2 = Galileo 3 = BDS 结果： 返回$PAIR001 消息和查询结果。 查询结果消息格式： $PAIR470,,,,,,,,,,* 参数： 字段 格式 单位 十进制 - 十进制 十进制 - 描述 GNSS 系统 ID。 0 = GPS 1 = GLONASS 2 = Galileo 3 = BDS 存储在 GNSS 芯片中的 EPO 数据集总数。 设置存储在 Flash 中的第一个 EPO 数据集的 GPS 周数。 上海移远通信技术股份有限公司 33 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 - 描述 设置存储在 Flash 中的第一个 EPO 数据集的 GPS 周内秒。 设置存储在 Flash 中的最后一个 EPO 数据集的 GPS 周数。 设置存储在 Flash 中的最后一个 EPO 数据集的 GPS 周内秒。 目前正在使用的第一个 EPO 数据集的 GPS 周数。 目前正在使用的第一个 EPO 数据集的 GPS 周内秒。 目前正在使用的最后第一个 EPO 数据集的 GPS 周数。 目前正在使用的最后第一个 EPO 数据集的 GPS 周内秒。 示例： $PAIR470,0*25 $PAIR001,470,0*38 $PAIR470,0,1,2098,194400,2098,216000,2098,194400,2098,216000*38 4.4. PAIR471 PAIR_EPO_SET_DATA 发送包含单颗卫星的 EPO 数据的数据包。 类型： 输入 格式： $PAIR471,,,,...,* 参数： 字段 格式 十进制 单位 描述 GNSS 系统 ID。 0 = GPS - 1 = GLONASS 2 = Galileo 3 = BDS 上海移远通信技术股份有限公司 34 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 字段 格式 十六进制 - 单位 描述 正在发送 EPO 数据的卫星的 PRN 编号。 GPS 范围：1~32。 GLONASS 范围：1~24。 - Galileo 范围：1~30。 BDS 范围：1~37。 特殊 255：BDS IONO 数据。 特殊 254：Galileo IONO 数据。 - 一个 EPO 段数据的 18 个字（LSB 优先）（共 72 个字节）。 结果： 返回$PAIR001 消息。 示例： $PAIR471,1,16,56056272,F2BC0244,4F19AE34,F95C534D,FAE67014,4F19AF6B,F96749BD,9F341F2 D,6F4EA9F,77DB4710,66ADAC2,9ADF3B01,8CC8B19C,29D2D20C,FC5B2E94,1000001C,11005000, 748B45F4*0A $PAIR001,471,0*39 4.5. PAIR472 PAIR_EPO_ERASE_FLASH_DATA 擦除存储在 Flash 中的 EPO 数据。 类型： 命令 格式： $PAIR472* 参数： 无 结果： 返回$PAIR001 消息。 上海移远通信技术股份有限公司 35 / 47 示例： $PAIR472*3B $PAIR001,472,0*3A LC02H&LC29H&LC79H 系列 AGNSS 应用指导 4.6. PAIR590 PAIR_TIME_SET_REF_UTC 发送参考 UTC 时间到 GNSS 芯片以获得更快的首次定位时间。由于时区偏移，应避免使用当地时间。 要获取更快的首次定位时间，参考时间应与实际时间的误差应在 3 秒内，并且必须为 UTC 时间。 类型： 输入 格式： $PAIR590,,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 单位 年 月 日 时 分 秒 描述 UTC 年；最小值：1980。 UTC 月；范围：1~12。 UTC 日；范围：1~31。 UTC 时；范围：0~23。 UTC 分；范围：0~59。 UTC 秒；范围：0~59。 结果： 返回$PAIR001 消息。 示例： $PAIR590,2023,3,29,9,0,58*09 $PAIR001,590,0*37 上海移远通信技术股份有限公司 36 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 4.7. PAIR600 PAIR_LOC_SET_REF 发送参考位置到 GNSS 芯片以获得更快的首次定位时间。参考位置与接收机实际位置的误差应在 30 公里以内。请注意，如果接收机的天空视野有限，则需要提高参考位置的精度。 类型： 输入 格式： $PAIR600,,,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 度 度 米 米 米 度 米 描述 参考纬度。范围：-90 至 90。-：南；+：北。 建议用保留小数点后 6 位的浮点数表示。 参考经度。范围：-180 至 180。-：西；+：东。 建议用保留小数点后 6 位的浮点数表示。 参考高度。 长半轴 RMS 精度。 短半轴 RMS 精度。 方位角。 垂直 RMS 精度。 结果： 返回$PAIR001 消息。 示例： $PAIR600,24.772816,121.022636,175.0,50.0,50.0,0.0,100.0*06 $PAIR001,600,0*3D 上海移远通信技术股份有限公司 37 / 47 备注 每次 GNSS 模块重启后都需要发送该命令。 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 上海移远通信技术股份有限公司 38 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 5 使用 QGNSS 下载 EPO 数据 本章介绍如何通过 QGNSS 工具下载 EPO 数据。有关 QGNSS 的详细信息，请联系移远通信技术支持。 5.1. 使用 QGNSS 下载 Flash EPO 使用 QGNSS 工具下载 Flash EPO 的步骤： 1. 运行 QGNSS 工具； 2. 在主界面，点击'AGNSS'→'Assistant GNSS Offline'，如下图： 图 11：用于设置 Flash EPO 的 QGNSS 界面 3. 下载 EPO 文件到模块。 a) 点击'Connect'按钮连接FTP服务器； b) 选择EPO文件； c) 点击'Download selected file'按钮下载EPO文件到电脑； d) 选择星系类型； 上海移远通信技术股份有限公司 39 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 e) 点击'…'按钮选择EPO文件； f) 点击'Download'按钮下载EPO文件到模块。 图 12：下载 Flash EPO 文件 5.2. 使用 QGNSS 下载 Host EPO 使用QGNSS工具下载Host EPO的步骤： 1. 运行 QGNSS 工具； 2. 在主界面，点击'AGNSS' → 'Assistant GNSS Online'，如下图： 上海移远通信技术股份有限公司 40 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 图 13：用于设置 Host EPO 的 QGNSS 界面 3. 配置参数 a) 选择'Use Current Position'使用当前位置； b) 选择'Use Current UTC'使用当前 UTC 时间； c) 点击'Transfer'下载 Host EPO 文件至模块。 图 14：下载 Host EPO 文件 上海移远通信技术股份有限公司 41 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 6 AGNSS 实现示例 本章举例说明如何将 EPO 文件下载到模块。 6.1. Flash EPO 实现 AGNSS 蓝色加粗：发送数据 黑色加粗：ACK 信息 //主机发送$PAIR472*3B 擦除 Flash 中存储的 EPO 数据： $PAIR472*3B //模块返回$PAIR001 消息： $PAIR001,472,0*3A //主机以十六进制格式发送 EPO 起始消息： 04 24 B0 04 01 00 52 E7 AA 44 //模块返回 ACK 消息： 04 24 E8 03 04 00 B0 04 00 00 5B AA 44 //主机以十六进制格式发送 EPO 数据： 04 24 B1 04 48 00 BF 96 05 41 6E 3A 74 05 C3 21……. AA 44 //模块返回 ACK 消息： 04 24 E8 03 04 00 B1 04 00 00 5A AA 44 //主机以十六进制格式发送 EPO 数据： 04 24 B1 04 48 00 BF 96 05 42 09 3A 74 0C CA 77……. AA 44 //模块返回 ACK 消息： 04 24 E8 03 04 00 B1 04 00 00 5A AA 44 …… //主机以十六进制格式发送 EPO 结束数据： 04 24 B2 04 01 00 52 E5 AA 44 上海移远通信技术股份有限公司 42 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 //模块返回 ACK 消息： 04 24 E8 03 04 00 B2 04 00 00 59 AA 44 //主机查询 GNSS 芯片中存储的 EPO 数据状态： $PAIR470,0*25 //模块返回$PAIR001 和$PAIR470 消息： $PAIR001,470,0*38 $PAIR470,0,1,2098,194400,2098,216000,2098,194400,2098,216000*38 6.2. Host EPO 实现 AGNSS 蓝色加粗：发送数据 黑色加粗：ACK 信息 //主机发送命令$PAIR002 为 GNSS 系统上电（详情见文档 [1] 协议规范）： $PAIR002*38 //模块返回$PAIR001 消息： $PAIR001,002,0*39 //模块自动输出$PAIR010 消息： $PAIR010,1,-1*16 $PAIR010,2,-1*15 //主机发送参考 UTC 时间命令$PAIR590： $PAIR590,2023,3,29,9,0,58*09 //模块返回$PAIR001 消息： $PAIR001,590,0*37 //主机发送参考位置命令$PAIR600： $PAIR600,31.822203,117.115219,175.0,50.0,50.0,0.0,100.0*0F //模块返回$PAIR001 消息： $PAIR001,600,0*3D //主机发送 EPO 数据： $PAIR471,0,1,10596C0,A174051A,1B2EDE67,9F0BB6,17C37A4,1B2EDE22,F85B368E,845FB0C9,6F 18C40,23557111,2A4CBD5,A60348AB,FEF7E24,2F236B88,2439FDC6,1000001C,0,4860BF93*44 //模块返回$PAIR001 消息： $PAIR001,471,0*39 上海移远通信技术股份有限公司 43 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 //主机发送 EPO 数据： $PAIR471,0,2,20596C0,F0740341,1B2EEE36,5F3FAA,17E07E6,1B2E1100,F8C1048F,84A50985,6F1B D33,29192005,D651ED6,A600506D,256C95F,20430E67,C36C910D,1000001C,0,FAC0DA552A 33 43 0D 0A*3C //模块返回$PAIR001 消息： $PAIR001,471,0*39 …… //主机发送 EPO 数据： $PAIR471,0,7,70596C0,377403C2,1B2E41F1,F757006,C57EB,1B2EBF14,F89F543F,8986E880,6F1E6 93,DC3908E,DA7BB7,A603A757,8FBA37BF,21C8A8F0,A2247EAD,1000001C,22000000,DDACBBB6 *0B //模块返回$PAIR001 消息： $PAIR001,471,0*39 上海移远通信技术股份有限公司 44 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 7 附录 A 参考文档及术语缩写 表 11：参考文档 文档名称 [1] Quectel_LC29H 系列&LC79H(AL)_GNSS_协议规范 表 12：术语和缩写 缩写 英文全称 中文全称 ACK AGNSS EPO Acknowledgement 确认消息 Assisted GNSS (Global Navigation Satellite 辅助全球导航卫星系统 System) Extended Prediction Orbit 扩展轨道预测 GLONASS GNSS Global Navigation Satellite System (Russia) Global Navigation Satellite System 格洛纳斯导航卫星系统（俄罗斯） 全球导航卫星系统 GPS Global Positioning System 全球定位系统 LSB MSB IMEI Least Significant Bit Most Significant Bit International Mobile Equipment Identity 最低有效位 最高有效位 国际移动设备标识 IONO MNL Ionospheric MTK Navigation Lib 电离层 MTK 导航库 RAM Random Access Memory 随机存取存储器 SYSID SV System Identification Satellite in View 系统标识符 可视卫星 上海移远通信技术股份有限公司 45 / 47 缩写 SVID TOW UART UTC URL LC02H&LC29H&LC79H 系列 AGNSS 应用指导 英文全称 中文全称 Satellite in View Identification 可视卫星标识符 Time of Week 周内时间 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Coordinated Universal Time 协调世界时 Uniform Resource Locator 统一资源定位器 上海移远通信技术股份有限公司 46 / 47 LC02H&LC29H&LC79H 系列 AGNSS 应用指导 8 附录 B 特殊符号 表 13：特殊符号 特殊符号 [...] {…} 下划线 定义 回车符 换行符 参数名称（实际命令中不包含尖括号） 可选参数（实际命令中不包含方括号） 循环参数（实际命令中不包含大括号） 参数的默认设置 上海移远通信技术股份有限公司 47 / 47

EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 LTE-A 模块系列 版本：1.1 日期：2023-12-27 状态：受控文件 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 文档历史 修订记录 版本 日期 作者 - 2023-03-21 Monan TIAN 1.0 2023-05-18 Monan TIAN 1.1 2023-12-27 Shengya HUANG 变更表述 文档创建 受控版本 新增关于切换通路 AT 命令 AT+QFOTAPID 的备注 （第 3.3.3 章）。 上海移远通信技术股份有限公司 3 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 FOTA 固件升级流程.............................................................................................................................. 7 2.1. 获取升级包 ................................................................................................................................. 8 2.2. 将升级包存储至 FTP/HTTP(S)服务器........................................................................................ 8 2.3. 执行 AT 命令升级固件 ................................................................................................................ 8 3 FOTA 相关 AT 命令详解 ....................................................................................................................... 9 3.1. AT 命令语句................................................................................................................................ 9 3.1.1. 定义 ................................................................................................................................. 9 3.1.2. AT 命令语句 .................................................................................................................... 9 3.2. AT 示例声明.............................................................................................................................. 10 3.3. AT+QFOTADL 进行 FOTA 固件升级 ..................................................................................... 10 3.3.1. AT+QFOTADL= 通过 FTP 服务器进行固件升级 .................................... 10 3.3.2. AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级........................... 12 3.3.3. AT+QFOTADL= 通过本地系统进行固件升级.......................................... 13 4 异常情况处理及注意事项 .................................................................................................................... 15 4.1. 异常情况处理............................................................................................................................ 15 4.2. 注意事项 ................................................................................................................................... 15 5 错误码 ................................................................................................................................................. 17 6 附录 参考文档及术语缩写 .................................................................................................................. 19 上海移远通信技术股份有限公司 4 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 9 表 3：值描述 ............................................................................................................................. 17 表 4：值描述 .......................................................................................................................... 17 表 5：值描述...................................................................................................................................... 17 表 6：参考文档 ........................................................................................................................................... 19 表 7：术语缩写 ........................................................................................................................................... 19 上海移远通信技术股份有限公司 5 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 1 引言 移远通信 LTE-A EG060K 系列、EG065K 系列、EG120K 系列、EM120K-GL 和 EM060K 系列模块支 持固件空中升级（FOTA）功能，用于更新 modem、system、boot、sbl、tz 等分区的固件。 基于此功能，用户通过升级包即可实现固件升级或降级。升级包仅包含当前固件版本和目标固件版本 之间的差异，因此数据传输量大大降低、传输时间大大缩短。 1.1. 适用模块 表 1：适用模块 模块系列 EG06xK Ex120K - 模块 EG060K 系列 EG065K 系列 EG120K 系列 EM120K-GL EM060K 系列 上海移远通信技术股份有限公司 6 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 2 FOTA 固件升级流程 下图阐述了升级包储存在 FTP/HTTP(S)服务器上时，通过 FOTA 升级固件的流程。 2. 将升级包放在FTP/HTTP(S)服 务器 上。 FTP/HTTP(S) 服务 器 1. 获取升级包。 LT E/W CD MA/ (FTP/HTTP(S)) 4. 通过LTE/WCDMA网络从 FTP/H TTP(S)服务 器自动 下载 升级 包。 外部 MCU 3. 执行AT+QFOTADL 移远通信 模块 5. 自动升级模块 固件。 图 1：FOTA 固件升级流程 如上图所示，当升级包存储在 FTP/HTTP(S)服务器时需通过如下步骤进行固件升级： 步骤一： 步骤二： 步骤三： 步骤四： 步骤五： 从移远通信获取升级包； 将升级包存储到 FTP/HTTP(S)服务器； 执行 AT+QFOTADL； 模块通过 LTE/WCDMA 网络自动从 FTP/HTTP(S)服务器下载升级包或者模块系统本地直 接升级； 自动升级固件。 上海移远通信技术股份有限公司 7 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 2.1. 获取升级包 升级之前，客户需先通过 ATI 获取原固件版本，同时需明确目标固件版本；之后将原版本和目标版本 信息发送给移远通信或代理商以获取相应的升级包。 2.2. 将升级包存储至 FTP/HTTP(S)服务器 步骤一：客户需自建 FTP/HTTP(S)服务器以便使用 FOTA 功能（移远通信不提供此服务器）。 步骤二：完成服务器建立之后，需将升级包存储至服务器并记录下路径。 2.3. 执行 AT 命令升级固件 升级包存放至 FTP/HTTP(S)服务器后，执行 AT+QFOTADL，随后模块将从 FTP/HTTP(S)服务器下载 升级包并自动升级固件。有关 AT 命令的详细信息，请参考第 3 章。 备注 除通过 FTP/HTTP(S)服务器进行固件升级外，模块也支持通过本地系统进行固件升级。有关通过本地系 统进行固件升级的详细信息，请参考第 3.3.3 章。 上海移远通信技术股份有限公司 8 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 3 FOTA 相关 AT 命令详解 3.1. AT 命令语句 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT+QFOTADL 进行 FOTA 固件升级 该命令用于开启 FOTA 自动固件升级。升级包被储存至 FTP/HTTP(S)服务器或者本地文件系统中后， 用户可执行相应的命令使能模块通过 FOTA 自动进行固件升级。成功下载升级包后，模块将自动重启并进 行固件升级。 AT+QFOTADL 进行 FOTA 固件升级 测试命令 AT+QFOTADL=? 响应 OK 最大响应时间 300 毫秒 3.3.1. AT+QFOTADL= 通过 FTP 服务器进行固件升级 若升级包存储至 FTP 服务器上，执行 AT+QFOTADL=使能模块通过 FOTA 自动进行固件 升级。命令执行成功后，模块将自动从 FTP 服务器下载升级包，完成后模块将自动重启并进行固件升级。 AT+QFOTADL= 通过 FTP 服务器进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 - 上海移远通信技术股份有限公司 10 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 参数 字 符 串 类 型 。 升 级包 存储 至 FTP 服务 器 上 的 URL 地 址 ，以 'ftp://'开 头 ， 例 如 ： 'ftp://:@:/'。 最大长度：512；单位：字节。 字符串类型。FTP 登录的用户名身份认证。 字符串类型。FTP 登录的密码身份认证。 字符串类型。FTP 服务器地址。 整型。FTP 服务器端口。范围：1~65535。默认值：21。 字符串类型。升级包在服务器中的路径名称。 整型。FTP 错误码。 0 从 FTP 服务器下载升级包成功 其他 从 FTP 服务器下载升级包失败。详细信息请参考第 5 章。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 举例 //当升级包存储在 FTP 服务器后，升级固件。例如服务器地址为：'ftp://test:test@124.74.41.170:21/Jun/ update-v12-to-v13.zip'。执行如下命令将会使能自动通过 FOTA 进行固件升级，模块将开始下载目标固件 版本并自动进行固件升级。 AT+QFOTADL='ftp://test:test@124.74.41.170:21/Jun/update-v12-to-v13.zip' OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND',0 //成功完成从 FTP 服务器下载升级包。 //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',20 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 上海移远通信技术股份有限公司 11 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 3.3.2. AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级 若升级包存储在 HTTP(S)服务器上，执行 AT+QFOTADL=使能模块通过 FOTA 自动进 行固件升级。命令执行成功后，模块将自动从 HTTP(S)服务器下载升级包，完成后模块将自动重启并进行 固件升级。 AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 - 参数 字符串类型。升级包存储至 HTTP(S)服务器上的 URL 地址，以'http(s)://'开头， 例如：'http(s)://:/'。 最大长度：512；单位：字节。 字符串类型。HTTP(S)服务器 IP 地址或域名。 整型。HTTP(S)服务器端口。范围：1~65535。默认值：80。 字符串类型。升级包在服务器中的路径名称。 整型。HTTP(S)错误码。 0 从 HTTP(S)服务器下载升级包成功 其他 从 HTTP(S)服务器下载升级包失败。详细信息请参考第 5 章。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 上海移远通信技术股份有限公司 12 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 举例 //当升级包存储在 HTTP(S)服务器后，升级固件。例如服务器地址为：'http://www.quectel.com:100/updat e.zip'。执行如下命令将会使能自动通过 FOTA 进行固件升级，模块将开始下载固件版本并自动进行固件 升级。 AT+QFOTADL='http://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND',0 //从 HTTP 服务器下载升级包完成。 //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 3.3.3. AT+QFOTADL= 通过本地系统进行固件升级 若升级包已经存储至本地文件系统，执行 AT+QFOTADL=使能模块通过 FOTA 自动进行 固件升级。命令执行成功后，模块将自动从本地系统下载升级包，完成后模块将自动重启并进行固件升级。 AT+QFOTADL= 通过本地系统进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 - 上海移远通信技术股份有限公司 13 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 参数 字符串类型。升级包存储至本地文件系统上的路径，UFS 里以'cache/ufs/'开头。 最大长度：512；单位：字节。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 备注 1. 使用该命令前，需要确保升级包已经存储至模块中。用户可以通过 AT+QFUPL 上传升级包。有关 AT+QFUPL 的使用方法，请参考文档 [1]。 2. FOTA 升级时默认使用第一路 APN 进行数据拨号。若上位机已经使用第一路 APN 进行拨号，则模块 无法同时使用该路 APN 进行数据拨号，因此上位机需要断开该路数据连接或者使用 AT+QFOTAPID 切换通道，然后再进行 FOTA 升级。 3. 若进行 Verizon 运营商认证使用第一路 APN 进行拨号，建议使用 AT+QFOTAPID 切换通道后再进行 FOTA 升级。 4. 有关 AT+QFOTAPID 的详细信息，请咨询移远通信技术支持。 举例 //升级存储在系统本地的升级包。 AT+QFOTADL='/cache/ufs/update-v13-to-v12.zip' OK //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 上海移远通信技术股份有限公司 14 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 4 异常情况处理及注意事项 4.1. 异常情况处理 为了提高升级成功率，模块会在开始升级前设置升级标记，当升级出现报错时，模块会自动重启，检 查到升级标记后继续尝试升级。如果连续五次均升级失败，则认为本次升级彻底失败，模块会删除标记， 退出升级并尝试正常启动。相关升级界面如下所示： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',20 +QIND: 'FOTA','END', … //模块自动重启后 … +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',20 +QIND: 'FOTA','UPDATING',30 ... +QIND: 'FOTA','END',0 备注 连续升级五次的限制仅在升级报错时有效，异常断电时不限制升级次数。若模块升级过程中遇到异常断 电时，重启模块后同样也能继续升级。升级成功后同样会删除升级标记。 4.2. 注意事项 1. 执行 AT+QFOTADL 后，上位机收到 URC +QIND: 'FOTA','START'表示升级开始，接收到 URC +QIND: 'FOTA','END',0 表示升级结束。升级结束后，模块将自动重启并进入正常模式。升级过 程中请勿关闭模块。 2. 升级过程中，若上位机 4 分钟内未收到任何 URC，可重启模块。 3. 建议上位机设置一个标志，用于标记固件升级任务，并在升级成功后将其清除。 上海移远通信技术股份有限公司 15 / 19 备注 建议 FOTA 升级过程中不要断电。 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 上海移远通信技术股份有限公司 16 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 5 错误码 本章介绍与移远通信模块或网络相关的错误码。有关、和的详细信息， 请参阅下表。 表 3：值描述 数值型 0 601 字符型 中文含义 Downloaded the firmware package from 从 FTP 服务器下载升级包成功 the FTP server successfully FTP unknown error FTP 未知错误 表 4：值描述 数值型 0 701 字符型 中文含义 Downloaded the firmware package from 从 HTTP(S)服务器下载升级包成功 the HTTP(S) server successfully Failed to download the firmware package 从 HTTP(S)服务器下载升级包失败 from the HTTP(S) server 表 5：值描述 数值型 0 502 504 505 510 字符型 中文含义 Upgraded the firmware successfully 固件升级成功 The upgrade process exits due to some 未知错误或某些异常导致退出升级 unknown errors or exceptions. The 程序。系统将重试 5 次。 system will retry five times. Incorrect zip format zip 包格式错误 The project or the version of the package does not match The firmware package file does not match the source package file of the module, 该项目或软件包版本不匹配 升级包文件与模块源文件不匹配，需 检查升级包是否错误。 上海移远通信技术股份有限公司 17 / 19 511 520~530 540~546 550 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 and needs to be checked if it is wrong. The file system has no enough space for 升级空间不足错误 upgrade. Firmware upgrading failed. The module 固件更新失败。模块重启并重新升级 will reboot and retry to upgrade the 直至升级成功 firmware until the upgrade is successful. The firmware package is too large. 固件包过大 上海移远通信技术股份有限公司 18 / 19 EG06xK&Ex120K&EM060K 系列 FOTA 应用指导 6 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_EG06xK&Ex120K&EM060K 系列_FILE_应用指导 表 7：术语缩写 术语 FOTA FTP GPRS GSM HTTP(S) IP LTE MCU TA UFS URC URL USB WCDMA 英文全称 中文全称 Firmware Upgrade Over-The-Air 固件空中升级 File Transfer Protocol 文件传输协议 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Hypertext Transfer Protocol (Secure/over Secure 超文本传输（安全）协议 Socket Layer) Internet Protocol 网络协议 (Long-Term Evolution) a 4G mobile communications 长期演进 standard Microcontroller Unit 微控制单元 Terminal Adapter 终端适配器 User File System 用户文件系统 Unsolicited Result Code 非请求结果码 Uniform Resource Locator 统一资源定位符 Universal Serial Bus 通用串行总线 Wideband Code Division Multiple Access 宽带码分多址 上海移远通信技术股份有限公司 19 / 19

EG512R&EM12xR&EM160R 系列 FOTA 应用指导 LTE-A 模块系列 版本：1.1 日期：2023-12-27 状态：受控文件 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2023-03-21 Monan TIAN 文档创建 1.0 2023-05-18 Monan TIAN 受控版本 新增关于切换通路 AT 命令 AT+QFOTAPID 的备注 1.1 2023-12-27 Shengya HUANG （第 3.3.3 章）。 上海移远通信技术股份有限公司 3 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 FOTA 固件升级流程.............................................................................................................................. 7 2.1. 获取升级包 ................................................................................................................................. 8 2.2. 将升级包存储至 FTP/HTTP(S)服务器........................................................................................ 8 2.3. 执行 AT 命令升级固件 ................................................................................................................ 8 3 FOTA 相关 AT 命令详解 ....................................................................................................................... 9 3.1. AT 命令语句................................................................................................................................ 9 3.1.1. 定义 ................................................................................................................................. 9 3.1.2. AT 命令语句 .................................................................................................................... 9 3.2. AT 示例声明.............................................................................................................................. 10 3.3. AT+QFOTADL 进行 FOTA 固件升级 ..................................................................................... 10 3.3.1. AT+QFOTADL= 通过 FTP 服务器进行固件升级 .................................... 10 3.3.2. AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级........................... 12 3.3.3. AT+QFOTADL= 通过本地系统进行固件升级.......................................... 13 4 异常情况处理及注意事项 .................................................................................................................... 15 4.1. 异常情况处理............................................................................................................................ 15 4.2. 注意事项 ................................................................................................................................... 15 5 错误码 ................................................................................................................................................. 17 6 附录 参考文档及术语缩写 .................................................................................................................. 19 上海移远通信技术股份有限公司 4 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 9 表 3：值描述 ............................................................................................................................. 17 表 4：值描述 .......................................................................................................................... 17 表 5：值描述...................................................................................................................................... 17 表 6：参考文档 ........................................................................................................................................... 19 表 7：术语缩写 ........................................................................................................................................... 19 上海移远通信技术股份有限公司 5 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 1 引言 移远通信 LTE-A EG512R-EA、EM120R-GL、EM121R-GL 和 EM160R-GL 系列模块支持固件空中固 件升级（FOTA）功能，用于更新 modem、system、boot、sbl、tz 等分区的固件。 基于此功能，用户通过升级包即可实现固件升级或降级。升级包仅包含当前固件版本和目标固件版本 之间的差异，因此数据传输量大大降低、传输时间大大缩短。 1.1. 适用模块 表 1：适用模块 模块系列 EM12xR - 模块 EG512R-EA EM120R-GL EM121R-GL EM160R-GL 上海移远通信技术股份有限公司 6 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 2 FOTA 固件升级流程 下图阐述了升级包储存在 FTP/HTTP(S)服务器上时，通过 FOTA 升级固件的流程。 2. 将升级包放在FTP/HTTP(S)服 务器 上。 FTP/HTTP(S) 服务 器 1. 获取升级包。 LT E/W CD MA/ (FTP/HTTP(S)) 4. 通过LTE/WCDMA网络从 FTP/H TTP(S)服务 器自动 下载 升级 包。 外部 MCU 3. 执行AT+QFOTADL 移远通信 模块 5. 自动升级模块 固件。 图 1：FOTA 固件升级流程 如上图所示，当升级包存储在 FTP/HTTP(S)服务器时需通过如下步骤进行固件升级： 步骤一： 步骤二： 步骤三： 步骤四： 步骤五： 从移远通信获取升级包； 将升级包存储到 FTP/HTTP(S)服务器； 执行 AT+QFOTADL； 模块通过 LTE/WCDMA 网络自动从 FTP/HTTP(S)服务器下载升级包或者模块系统本地直 接升级； 自动升级固件。 上海移远通信技术股份有限公司 7 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 2.1. 获取升级包 升级之前，客户需先通过 ATI 获取原固件版本，同时需明确目标固件版本；之后将原版本和目标版本 信息发送给移远通信或代理商以获取相应的升级包。 2.2. 将升级包存储至 FTP/HTTP(S)服务器 步骤一：客户需自建 FTP/HTTP(S)服务器以便使用 FOTA 功能（移远通信不提供此服务器）。 步骤二：完成服务器建立之后，需将升级包存储至服务器并记录下路径。 2.3. 执行 AT 命令升级固件 升级包存放至 FTP/HTTP(S)服务器后，执行 AT+QFOTADL，随后模块将从 FTP/HTTP(S)服务器下载 升级包并自动升级固件。有关 AT 命令的详细信息，请参考第 3 章。 备注 除通过 FTP/HTTP(S)服务器升级固件外，模块也支持通过本地系统升级固件。有关通过本地系统进行固 件升级的详细信息，请参考第 3.3.3 章。 上海移远通信技术股份有限公司 8 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 3 FOTA 相关 AT 命令详解 3.1. AT 命令语句 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT+QFOTADL 进行 FOTA 固件升级 该命令用于开启 FOTA 自动固件升级。升级包被储存至 FTP/HTTP(S)服务器或者本地文件系统中后， 用户可执行相应的命令使能模块通过 FOTA 自动进行固件升级。成功下载升级包后，模块将自动重启并进 行固件升级。 AT+QFOTADL 进行 FOTA 固件升级 测试命令 AT+QFOTADL=? 响应 OK 最大响应时间 300 毫秒 3.3.1. AT+QFOTADL= 通过 FTP 服务器进行固件升级 若升级包存储至 FTP 服务器上，执行 AT+QFOTADL=使能模块通过 FOTA 自动进行固件 升级。命令执行成功后，模块将自动从 FTP 服务器下载升级包，完成后模块将自动重启并进行固件升级。 AT+QFOTADL= 通过 FTP 服务器进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 - 上海移远通信技术股份有限公司 10 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 参数 字 符 串 类 型 。 升 级包 存储 至 FTP 服务 器 上 的 URL 地 址 ，以 'ftp://'开 头 ， 例 如 ： 'ftp://:@:/'。 最大长度为 512：单位：字节。 字符串类型。FTP 登录的用户名身份认证。 字符串类型。FTP 登录的密码身份认证。 字符串类型。FTP 服务器 IP 地址。 整型。FTP 服务器端口。范围：1~65535。默认值：21。 字符串类型。升级包在服务器中的路径名称。 整型。FTP 错误码。 0 从 FTP 服务器下载升级包成功 其他 从 FTP 服务器下载升级包失败。详细信息请参考第 5 章。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 举例 //当升级包存储在 FTP 服务器后，升级固件。例如服务器地址为：'ftp://test:test@124.74.41.170:21/Jun/ update-v12-to-v13.zip'。执行如下命令将会使能自动通过 FOTA 进行固件升级，模块将开始下载目标固件 版本并自动进行固件升级。 AT+QFOTADL='ftp://test:test@124.74.41.170:21/Jun/update-v12-to-v13.zip' OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND',0 //成功完成从 FTP 服务器下载升级包。 //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',20 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 上海移远通信技术股份有限公司 11 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 3.3.2. AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级 若升级包存储在 HTTP(S)服务器上，执行 AT+QFOTADL=使能模块通过 FOTA 自动进 行固件升级。命令执行成功后，模块将自动从 HTTP(S)服务器下载升级包，完成后模块将自动重启并进行 固件升级。 AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 - 参数 字符串类型。升级包存储至 HTTP(S)服务器上的 URL 地址，以'http(s)://'开头， 例如：'http(s)://:/'。 最大长度：512；单位：字节。 字符串类型。HTTP(S)服务器 IP 地址或域名。 整型。HTTP(S)服务器端口。范围：1~65535。默认值：80。 字符串类型。升级包在服务器中的路径名称。 整型。HTTP(S)错误码。 0 从 HTTP(S)服务器下载升级包成功 其他 从 HTTP(S)服务器下载升级包失败。详细信息请参考第 5 章。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 上海移远通信技术股份有限公司 12 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 举例 //当升级包存储在 HTTP(S)服务器后，升级固件。例如服务器地址为：'http://www.quectel.com:100/updat e.zip'。执行如下命令将会使能自动通过 FOTA 进行固件升级，模块将开始下载固件版本并自动进行固件 升级。 AT+QFOTADL='http://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND',0 //从 HTTP 服务器下载升级包完成。 //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 3.3.3. AT+QFOTADL= 通过本地系统进行固件升级 若升级包已经存储至本地文件系统，执行 AT+QFOTADL=使能模块通过 FOTA 自动进行 固件升级。命令执行成功后，模块将自动从本地系统下载升级包，完成后模块将自动重启并进行固件升级。 AT+QFOTADL= 通过本地系统进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 - 上海移远通信技术股份有限公司 13 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 参数 字符串类型。升级包存储至本地文件系统上的路径，UFS 里以'cache/ufs/'开头。 最大长度：512；单位：字节。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 备注 1. 使用该命令前，需要确保升级包已经存储至模块中。用户可以通过 AT+QFUPL 上传升级包。有关 AT+QFUPL 的使用方法，请参考文档 [1]。 2. FOTA 升级时默认使用第一路 APN 进行数据拨号。若上位机已经使用第一路 APN 进行拨号，则模块 无法同时使用该路 APN 进行数据拨号，因此上位机需要断开该路数据连接或者使用 AT+QFOTAPID 切换通道，然后再进行 FOTA 升级。 3. 若进行 Verizon 运营商认证使用第一路 APN 进行拨号，建议使用 AT+QFOTAPID 切换通道后再进行 FOTA 升级。 4. 有关 AT+QFOTAPID 的详细信息，请咨询移远通信技术支持。 举例 //升级存储在系统本地的升级包。 AT+QFOTADL='/cache/ufs/update-v13-to-v12.zip' OK //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 上海移远通信技术股份有限公司 14 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 4 异常情况处理及注意事项 4.1. 异常情况处理 为了提高升级成功率，模块会在开始升级前设置升级标记，当升级出现报错时，模块会自动重启，检 查到升级标记后继续尝试升级。如果连续五次均升级失败，则认为本次升级彻底失败，模块会删除标记， 退出升级并尝试正常启动。相关升级界面如下所示： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',20 +QIND: 'FOTA','END', … //模块自动重启后 … +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',20 +QIND: 'FOTA','UPDATING',30 ... +QIND: 'FOTA','END',0 备注 连续升级五次的限制仅在升级报错时有效，异常断电时不限制升级次数。若模块升级过程中遇到异常断 电时，重启模块后同样也能继续升级。升级成功后同样会删除升级标记。 4.2. 注意事项 1. 执行 AT+QFOTADL 后，上位机收到 URC +QIND: 'FOTA','START'表示升级开始，接收到 URC +QIND: 'FOTA','END',0 表示升级结束。升级结束后，模块将自动重启并进入正常模式。升级过 程中请勿关闭模块。 2. 升级过程中，若上位机 4 分钟内未收到任何 URC，可重启模块。 3. 建议上位机设置一个标志，用于标记固件升级任务，并在升级成功后将其清除。 上海移远通信技术股份有限公司 15 / 19 备注 建议 FOTA 升级过程中不要断电。 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 上海移远通信技术股份有限公司 16 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 5 错误码 本章介绍与移远通信模块或网络相关的错误码。有关、和的详细信息， 请参阅下表。 表 3：值描述 数值型 0 601 字符型 中文含义 Downloaded the firmware package from 从 FTP 服务器下载升级包成功 the FTP server successfully FTP unknown error FTP 未知错误 表 4：值描述 数值型 0 701 字符型 中文含义 Downloaded the firmware package from 从 HTTP(S)服务器下载升级包成功 the HTTP(S) server successfully Failed to download the firmware package 从 HTTP(S)服务器下载升级包失败 from the HTTP(S) server 表 5：值描述 数值型 0 502 504 505 510 字符型 中文含义 Upgraded the firmware successfully 固件升级成功 The upgrade process exits due to some 未知错误或某些异常导致退出升级 unknown errors or exceptions. The 程序。系统将重试 5 次。 system will retry five times. Incorrect zip format zip 包格式错误 The project or the version of the package does not match The firmware package file does not match the source package file of the module, 该项目或软件包版本不匹配 升级包文件与模块源文件不匹配，需 检查升级包是否错误 上海移远通信技术股份有限公司 17 / 19 511 520~530 540~546 550 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 and needs to be checked if it is wrong. The file system has no enough space for 升级空间不足错误 upgrade. Firmware upgrading failed. The module 固件更新失败。模块重启并重新升级 will reboot and retry to upgrade the 直至升级成功 firmware until the upgrade is successful. The firmware package is too large. 固件包过大 上海移远通信技术股份有限公司 18 / 19 EG512R&EM12xR&EM160R 系列 FOTA 应用指导 6 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_EG512R&EM12xR&EM160R 系列_FILE_应用指导 表 7：术语缩写 术语 FOTA FTP GPRS GSM HTTP(S) IP LTE MCU TA UFS URC URL USB WCDMA 英文全称 中文全称 Firmware Upgrade Over-The-Air 固件空中升级 File Transfer Protocol 文件传输协议 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Hypertext Transfer Protocol (Secure/over Secure 超文本传输（安全）协议 Socket Layer) Internet Protocol 网络协议 (Long-Term Evolution) a 4G mobile communications 长期演进 standard Microcontroller Unit 微控制单元 Terminal Adapter 终端适配器 User File System 用户文件系统 Unsolicited Result Code 非请求结果码 Uniform Resource Locator 统一资源定位符 Universal Serial Bus 通用串行总线 Wideband Code Division Multiple Access 宽带码分多址 上海移远通信技术股份有限公司 19 / 19

EM12&EG12&EG18 系列 FOTA 应用指导 LTE-A 模块系列 版本：1.0 日期：2023-05-18 状态：受控文件 EM12&EG12&EG18 系列 FOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2023-03-21 Monan TIAN 文档创建 1.0 2023-05-18 Monan TIAN 受控版本 上海移远通信技术股份有限公司 3 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 FOTA 固件升级流程.............................................................................................................................. 7 2.1. 获取升级包 ................................................................................................................................. 8 2.2. 将升级包存储至 FTP/HTTP(S)服务器........................................................................................ 8 2.3. 执行 AT 命令升级固件 ................................................................................................................ 8 3 FOTA 相关 AT 命令详解 ....................................................................................................................... 9 3.1. AT 命令语句................................................................................................................................ 9 3.1.1. 定义 ................................................................................................................................. 9 3.1.2. AT 命令语句 .................................................................................................................... 9 3.2. AT 示例声明.............................................................................................................................. 10 3.3. AT+QFOTADL 进行 FOTA 固件升级 ..................................................................................... 10 3.3.1. AT+QFOTADL= 通过 FTP 服务器进行固件升级 .................................... 10 3.3.2. AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级........................... 12 3.3.3. AT+QFOTADL= 通过本地系统进行固件升级.......................................... 13 4 异常情况处理及注意事项 .................................................................................................................... 15 4.1. 异常情况处理............................................................................................................................ 15 4.2. 注意事项 ................................................................................................................................... 15 5 错误码 ................................................................................................................................................. 17 6 附录 参考文档及术语缩写 .................................................................................................................. 19 上海移远通信技术股份有限公司 4 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 9 表 2：值描述 ............................................................................................................................. 17 表 3：值描述 .......................................................................................................................... 17 表 4：值描述...................................................................................................................................... 17 表 5：参考文档 ........................................................................................................................................... 19 表 6：术语缩写 ........................................................................................................................................... 19 上海移远通信技术股份有限公司 5 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 1 引言 移远通信 LTE-A EM12-G、EG12 和 EG18 系列模块支持固件空中升级（FOTA）功能，用于更新 modem、 system 和 boot 分区的固件。 基于此功能，用户通过升级包即可实现固件升级或降级。升级包仅包含当前固件版本和目标固件版本 之间的差异，因此数据传输量大大降低、传输时间大大缩短。 上海移远通信技术股份有限公司 6 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 2 FOTA 固件升级流程 下图阐述了升级包储存在 FTP/HTTP(S)服务器上时，通过 FOTA 升级固件的流程。 2. 将升级包放在FTP/HTTP(S)服 务器 上。 FTP/HTTP(S) 服务 器 1. 获取升级包。 LT E/W CD MA/ (FTP/HTTP(S)) 4. 通过LTE/WCDMA网络从 FTP/H TTP(S)服务 器自动 下载 升级 包。 外部 MCU 3. 执行AT+QFOTADL 移远通信 模块 5. 自动升级模块 固件。 图 1：FOTA 固件升级流程 如上图所示，当升级包存储在 FTP/HTTP(S)服务器时需通过如下步骤进行固件升级： 步骤一： 从移远通信获取升级包； 步骤二：将升级包存储到 FTP/HTTP(S)服务器； 步骤三：执行 AT+QFOTADL； 步骤四：模块通过 LTE/WCDMA 网络自动从 FTP/HTTP(S)服务器下载升级包或者模块系统本地直 接升级； 步骤五： 自动升级固件。 上海移远通信技术股份有限公司 7 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 2.1. 获取升级包 升级之前，客户需先通过 ATI 获取原固件版本，同时需明确目标固件版本；之后将原版本和目标版本 信息发送给移远通信或代理商以获取相应的升级包。 2.2. 将升级包存储至 FTP/HTTP(S)服务器 步骤一：客户需自建 FTP/HTTP(S)服务器以便使用 FOTA 功能（移远通信不提供此服务器）。 步骤二： 完成服务器建立之后，需将升级包存储至服务器并记录下路径。 2.3. 执行 AT 命令升级固件 升级包存放至 FTP/HTTP(S)服务器后，执行 AT+QFOTADL，随后模块将从 FTP/HTTP(S)服务器下载 升级包并自动升级固件。有关 AT 命令的详细信息，请参考第 3 章。 备注 除通过 FTP/HTTP(S)服务器升级固件外，模块也支持通过本地系统升级固件。有关通过本地系统进行固 件升级的详细信息，请参考第 3.3.3 章。 上海移远通信技术股份有限公司 8 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 3 FOTA 相关 AT 命令详解 3.1. AT 命令语句 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT+QFOTADL 进行 FOTA 固件升级 该命令用于开启 FOTA 自动固件升级。升级包被储存至 FTP/HTTP(S)服务器或者本地文件系统中后， 用户可执行相应的命令使能模块通过 FOTA 自动进行固件升级。成功下载升级包后，模块将自动进行固件 升级并重启。 AT+QFOTADL 进行 FOTA 固件升级 测试命令 AT+QFOTADL=? 响应 OK 最大响应时间 300 毫秒 3.3.1. AT+QFOTADL= 通过 FTP 服务器进行固件升级 若升级包存储至 FTP 服务器上，执行 AT+QFOTADL=使能模块通过 FOTA 自动进行固件 升级。命令执行成功后，模块将自动从 FTP 服务器下载升级包，并自动进行固件升级。 AT+QFOTADL= 通过 FTP 服务器进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 10 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 参数 字 符 串 类 型 。 升 级 包 存储 至 FTP 服 务器 上 的 URL 地 址 ， 以 'ftp://'开 头 ， 例 如 ： 'ftp://:@:/'。 最大长度：512 字节。 字符串类型。FTP 登录的用户名身份认证。 字符串类型。FTP 登录的密码身份认证。 字符串类型。FTP 服务器地址。 整型。FTP 服务器端口。范围：1~65535。默认值：21。 字符串类型。升级包在服务器中的路径名称。 整型。FTP 错误码。 0 从 FTP 服务器下载升级包成功 其他 从 FTP 服务器下载升级包失败。详细信息请参考第 5 章。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 举例 //当升级包存储在 FTP 服务器后，升级固件。例如服务器地址为：'ftp://test:test@124.74.41.170:21/Jun/ update-v12-to-v13.zip'。执行如下命令将会使能自动通过 FOTA 进行固件升级，模块将开始下载目标固件 版本并自动进行固件升级。 AT+QFOTADL='ftp://test:test@124.74.41.170:21/Jun/update-v12-to-v13.zip' OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND',0 //成功完成从 FTP 服务器下载升级包。 //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',20 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 上海移远通信技术股份有限公司 11 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 3.3.2. AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级 若升级包存储在 HTTP(S)服务器上，执行 AT+QFOTADL=使能模块通过 FOTA 自动进 行固件升级。命令执行成功后，模块将自动从 HTTP(S)服务器下载升级包，并自动进行固件升级。 AT+QFOTADL= 通过 HTTP(S)服务器进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 / 参数 字符串类型。升级包存储至 HTTP(S)服务器上的 URL 地址，以'http(s)://'开头， 例如：'http(s)://:/'。 最大长度：512 字节。 字符串类型。HTTP(S)服务器 IP 地址或域名。 整型。HTTP(S)服务器端口。范围：1~65535。默认值：80。 字符串类型。升级包在服务器中的路径名称。 整型。HTTP(S)错误码。 0 从 HTTP(S)服务器下载升级包成功 其他 从 HTTP(S)服务器下载升级包失败。详细信息请参考第 5 章。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 上海移远通信技术股份有限公司 12 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 举例 //当升级包存储在 HTTP(S)服务器后，升级固件。例如服务器地址为：'http://www.quectel.com:100/updat e.zip'。执行如下命令将会使能自动通过 FOTA 进行固件升级，模块将开始下载固件版本并自动进行固件 升级。 AT+QFOTADL='http://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND',0 //从 HTTP 服务器下载升级包完成。 //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 3.3.3. AT+QFOTADL= 通过本地系统进行固件升级 若升级包已经存储至本地文件系统，执行 AT+QFOTADL=使能模块通过 FOTA 自动进行 固件升级。命令执行成功后，模块将自动从本地系统下载升级包，并自动进行固件升级。 AT+QFOTADL= 通过本地系统进行固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 13 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 参数 字符串类型。升级包存储至本地文件系统上的路径，UFS 里以'cache/ufs/'开头。 最大长度：512 字节。 整型。固件包升级百分比。范围：0~100。 整型。升级错误码。 0 固件升级成功 其他 固件升级失败。详细信息请参考第 5 章。 备注 1. 使用该命令前，需要确保升级包已经存储至模块中。用户可以通过 AT+QFUPL 上传升级包。有关 AT+QFUPL 的使用方法，请参考文档 [1]。 2. FOTA 升级时默认使用第一路 APN 进行数据拨号。若上位机已经使用第一路 APN 进行拨号，则模块 无法同时使用该路 APN 进行数据拨号，因此上位机需要断开该路数据连接，模块会自动拨号进行 FOTA 升级。 3. 若进行 Verizon 运营商认证使用第一路 APN 进行拨号，建议使用 AT 命令切换通道进行 FOTA 升级。 有关切换通道的方法，详情请咨询移远通信技术支持。 举例 //升级存储在系统本地的升级包。 AT+QFOTADL='/cache/ufs/update-v13-to-v12.zip' OK //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。重启 模块后，会在 90 秒之内上报 URC。若未上报，表示发生未知错误。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启，完成 FOTA 升级。 上海移远通信技术股份有限公司 14 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 4 异常情况处理及注意事项 4.1. 异常情况处理 为了提高升级成功率，模块会在开始升级前设置升级标记，当升级出现报错时，模块会自动重启，检 查到升级标记后继续尝试升级。如果连续五次均升级失败，则认为本次升级彻底失败，模块会删除标记， 退出升级并尝试正常启动。相关升级界面如下所示： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',20 +QIND: 'FOTA','END', … //模块自动重启后 … +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',20 +QIND: 'FOTA','UPDATING',30 ... +QIND: 'FOTA','END',0 备注 连续升级五次的限制仅在升级报错时有效，异常断电时不限制升级次数。若模块升级过程中遇到异常断 电时，重启模块后同样也能继续升级。升级成功后同样会删除升级标记。 4.2. 注意事项 1. 执行 AT+QFOTADL 后，上位机收到 URC +QIND: 'FOTA','START'表示升级开始，接收到 URC +QIND: 'FOTA','END',0 表示升级结束。升级结束后，模块将自动重启并进入正常模式。升级过 程中请勿关闭模块。 2. 升级过程中，若上位机 4 分钟内未收到任何 URC，可重启模块。 3. 建议上位机设置一个标志，用于标记固件升级任务，并在升级成功后将其清除。 上海移远通信技术股份有限公司 15 / 19 备注 建议 FOTA 升级过程中不要断电。 EM12&EG12&EG18 系列 FOTA 应用指导 上海移远通信技术股份有限公司 16 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 5 错误码 本章介绍与移远通信模块或网络相关的错误码。有关、和的详细信息， 请参阅下表。 表 2：值描述 数值型 0 601 字符型 中文含义 Downloaded the firmware package from 从 FTP 服务器下载升级包成功 the FTP server successfully FTP unknown error FTP 未知错误 表 3：值描述 数值型 0 701 字符型 中文含义 Downloaded the firmware package from 从 HTTP(S)服务器下载升级包成功 the HTTP(S) server successfully Failed to download the firmware package 从 HTTP(S)服务器下载升级包失败 from the HTTP(S) server 表 4：值描述 数值型 0 502 504 505 510 字符型 中文含义 Upgraded the firmware successfully 固件升级成功 The upgrade process exits due to some 未知错误或某些异常导致退出升级 unknown errors or exceptions. The 程序。系统将重试 5 次 system will retry five times. Incorrect zip format zip 包格式错误 The project or the version of the package does not match The firmware package file does not match the source package file of the module, 该项目或软件包版本不匹配 升级包文件与模块源文件不匹配，需 检查升级包是否错误 上海移远通信技术股份有限公司 17 / 19 511 520~530 540~546 550 EM12&EG12&EG18 系列 FOTA 应用指导 and needs to be checked if it is wrong. The file system has no enough space for 升级空间不足错误 upgrade. Firmware upgrading failed. The module 固件更新失败。模块重启并重新升级 will reboot and retry to upgrade the 直至升级成功 firmware until the upgrade is successful. The firmware package is too large. 固件包过大 上海移远通信技术股份有限公司 18 / 19 EM12&EG12&EG18 系列 FOTA 应用指导 6 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_EM12&EG12&EG18 系列_FILE_应用指导 表 6：术语缩写 术语 FOTA FTP GPRS GSM HTTP(S) IP LTE MCU TA UFS URC URL USB WCDMA 英文全称 中文全称 Firmware Upgrade Over-The-Air 固件空中升级 File Transfer Protocol 文件传输协议 General Packet Radio Service 通用分组无线业务 Global System for Mobile Communications 全球移动通信系统 Hypertext Transfer Protocol (Secure/over Secure 超文本传输（安全）协议 Socket Layer) Internet Protocol 网络协议 (Long-Term Evolution) a 4G mobile communications 长期演进 standard Microcontroller Unit 微控制单元 Terminal Adapter 终端适配器 User File System 用户文件系统 Unsolicited Result Code 非请求结果码 Uniform Resource Locator 统一资源定位符 Universal Serial Bus 通用串行总线 Wideband Code Division Multiple Access 宽带码分多址 上海移远通信技术股份有限公司 19 / 19

EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 LTE-A 模块系列 版本：1.0 日期：2023-05-23 状态：受控文件 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 文档历史 修订记录 版本 1.0 日期 2023-03-08 2023-05-23 作者 Jacque YI/ Noah DENG Jacque YI/ Noah DENG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 LwM2M 相关的 AT 命令描述 ................................................................................................................ 7 2.1. AT 命令说明................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................ 8 2.3. AT 命令描述................................................................................................................................ 8 2.3.1. AT+QLWCFG 配置 LwM2M 的可选参数....................................................................... 8 2.3.2. AT+QLWREG 向 LwM2M 服务器发送注册请求 ......................................................... 13 2.3.3. AT+QLWUPDATE 向 LwM2M 服务器发送更新请求................................................... 14 2.3.4. AT+QLWDEREG 向 LwM2M 服务器发送注销请求 .................................................... 14 3 LwM2M 相关的 URC........................................................................................................................... 15 3.1. +QLWURC: 'pdp active' PDP 激活结果指示 ........................................................................ 15 3.2. +QLWURC: 'initial' 初始化结果指示 ..................................................................................... 15 3.3. +QLWURC: 'dtls' DTLS 单向认证结果指示 .......................................................................... 16 3.4. +QLWURC: 'dns' DNS 解析结果指示................................................................................... 16 3.5. +QLWURC: 'bootstraping' Bootstrap 服务器运行指示 ......................................................... 17 3.6. +QLWURC: 'bootstrap' Bootstrap 服务器运行结果指示....................................................... 17 3.7. +QLWURC: 'registering' 开始注册的指示............................................................................. 18 3.8. +QLWURC: 'ready' 注册结果指示 ........................................................................................ 18 3.9. +QLWURC: 'update' 更新结果指示 ...................................................................................... 18 3.10. +QLWURC: 'deregister' 注销结果指示 ................................................................................. 19 4 举例 ..................................................................................................................................................... 20 4.1. 登录 Verizon LwM2M 测试服务器 ............................................................................................ 20 4.2. 使用测试模式登录 Verizon LwM2M 测试服务器 ...................................................................... 21 5 附录 参考文档及术语缩写 .................................................................................................................. 22 上海移远通信技术股份有限公司 4 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 7 表 3：参考文档 ........................................................................................................................................... 22 表 4：术语缩写 ........................................................................................................................................... 22 上海移远通信技术股份有限公司 5 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 1 引言 LwM2M（OMA 轻量级 M2M）是一种为传感器网络和 M2M 环境需求而设计的设备管理协议。LwM2M 协议专为远程管理 M2M 设备和相关服务启用而设计，具有基于 REST 的现代体系结构设计，定义了可扩展 的资源和数据模型，并构建在 CoAP 协议的高效安全数据传输标准之上。 本文档主要介绍如何通过 AT 命令使用移远通信 EG06xK、Ex120K 和 EM060K 系列模块的 LwM2M 协 议功能。 1.1. 适用模块 表 1：适用模块 模块系列 EG06xK Ex120K - 模块 EG065K 系列 EG060K 系列 EM120K-GL EG120K 系列 EM060K 系列 上海移远通信技术股份有限公司 6 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 2 LwM2M 相关的 AT 命令描述 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅显示 命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令描述 2.3.1. AT+QLWCFG 配置 LwM2M 的可选参数 该命令用于配置 LwM2M 的可选参数。 AT+QLWCFG 配置 LwM2M 的可选参数 测试命令 AT+QLWCFG=? 响应 +QLWCFG: 'security',( 支 持 的 范 围 ),( 支 持 的 范围),,(支持的列表),(支持的 列表),, +QLWCFG: 'server',( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 列表),(支持的列表) +QLWCFG: 'epname/mode',(支持的列表) +QLWCFG: 'urc',(支持的列表) +QLWCFG: 'lwm2m_enable',(支持的范围),(支持 的列表) +QLWCFG: 'hostdevice',,,,,,, +QLWCFG: 'reset' +QLWCFG: 'nettype',(支持的范围) +QLWCFG: 'testmode', 设置命令 查询或设置 LwM2M 安全对象资源 AT+QLWCFG='security'[,[,,,,[,,< psk_key>]]] OK 响应 若省略可选参数，则查询当前配置： +QLWCFG: 'security',,,,, OK 若仅指定，省略其他可选参数，则删除指定 上海移远通信技术股份有限公司 8 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 的 LwM2M 安全对象资源： OK 若指定和其他任意可选参数，则设置 LwM2M 安全对 象资源： OK 若有任何错误： ERROR 设置命令 响应 查询或设置 LwM2M 服务器对象资源 若省略可选参数，则查询当前配置： AT+QLWCFG='server'[,<serverID +QLWCFG: 'server',,,,< >,[,[,,,, od_max>[,[,[,]]]]]] OK 若仅指定，省略其他可选参数，则删除指定 的 LwM2M 服务器对象资源： OK 若指定和其他任意可选参数，则设置 LwM2M 服务器 对象资源： OK 设置命令 查询或设置端点名称的模式 AT+QLWCFG='epname/mode'[,< mode>] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QLWCFG: 'epname/mode', OK 若指定可选参数，则设置端点名称模式： OK 设置命令 查询或设置 LwM2M URC 的使能情况 AT+QLWCFG='urc'[, ] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QLWCFG: 'urc', OK 若指定可选参数，则设置是否使能 LwM2M URC 上报： 上海移远通信技术股份有限公司 9 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 OK 设置命令 查询或设置是否使能一个或所有运营 商网络下的 LwM2M 客户端自启动 AT+QLWCFG='lwm2m_enable'[,< operatorID>[,]] 若有任何错误： ERROR 响应 若省略可选参数，则查询使能 LwM2M 客户端开机自启动的所有运 营商编号： +QLWCFG: 'lwm2m_enable', [+QLWCFG: 'lwm2m_enable',] […] OK 若仅指定，则查询指定运营商网络下的 LwM2M 客 户端是否开机自启动： +QLWCFG: 'lwm2m_enable', OK 若指定可选参数，则设置是否使能一个或所有运营商网络下的 LwM2M 客户端自启动： OK 设置命令 查询或设置上位机设备信息 AT+QLWCFG='hostdevice'[,[,[,[, [,[,[,]]]]]]]] 若有任何错误： ERROR 响应 非 Verizon 网络下，若省略可选参数，则查询当前配置： +QLWCFG: 'hostdevice',,,, Verizon 网络下，若省略可选参数，则查询当前配置： +QLWCFG: 'hostdevice',,,,,,, OK 非 Verizon 网络下，若省略、和 ，指定其他可选参数，则设置上位机设备信息： OK Verizon 网络下，若指定可选参数，则设置上位机设备信息： OK 上海移远通信技术股份有限公司 10 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 设置命令 擦除 LwM2M 客户端运行记录 AT+QLWCFG='reset' 设置命令 查询或设置 LwM2M 客户端的网络类 型 AT+QLWCFG='nettype'[,] 若有任何错误： ERROR 响应 OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QLWCFG: 'nettype', OK 若指定可选参数，则设置网络类型： OK 设置命令 设置测试模式 AT+QLWCFG='testmode'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QLWCFG: 'testmode', OK 若指定可选参数，则设置测试模式： OK 最大响应时间 特性说明 若有任何错误： ERROR 150 毫秒 该命令立即生效； 除外其他配置自动保存。 参数 整型。服务器类型。 0 Bootstrap 服务器 1 DM 服务器 2 Diagnostics 服务器 3 Repository 服务器 整型。服务器 ID。自定义参数。范围：1~65534。 100 Verizon 网络下的 Bootstrap 服务器 101 Verizon 网络下的 Diagnostics 服务器 102 Verizon 网络下的 DM 服务器 上海移远通信技术股份有限公司 11 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 1000 Verizon 网络下的 Repository 服务器 其他值 其他指定的服务器 ID 字 符 串 类 型 。 服 务 器 地 址 ， 格 式 为 'address:port' ， 例 如 ： 'coaps://boot.lwm2m.vzwdm.com:5684'。 整型。Bootstrap 服务器标识，用于选择是否连接 Bootstrap 服务器。 0 无需连接 Bootstrap 服务器（仅当≠0 时生效） 1 连接 Bootstrap 服务器（仅当=0 时生效） 整型。加密方式。 0 预共享密钥模式 3 无加密模式 字符串类型。预共享密钥 ID，仅当=0 时生效。 十六进制字符串类型。预共享密钥，仅当=0 时生效。 整型。服务器接收心跳包的生命周期。范围：1~86400；默认值：60； 单位：秒。 整型。最小响应周期。范围：1~86400；默认值：1；单位：秒。 整型。最大响应周期。范围：1~86400；默认值：60；单位：秒。 整型。断开与 LwM2M 服务器的连接后到下一次连接的时间间隔。范围： 1~86400。默认值：86400；单位：秒。 整型。是否保存服务器信息。 0 不保存 1 保存 字符串类型。用于连接 LwM2M 服务器的绑定模式。 'U' UDP 'UQ' 队列模式下的 UDP 'S' SMS 'SQ' 队列模式下的 SMS 'US' UDP 和 SMS 'UQS' 队列模式下的 UDP 和 SMS 整型。端点名称格式。 3 端点名称格式：urn:imei:xxxxx 6 端点名称格式：urn:imei-msisdn:xxxxx-xxx 7 端点名称格式：urn:imei-imsi:xxxxx-xxx 8 中国移动设备管理端点名称 整型。是否启用 LwM2M URC 上报。 0 禁用 LwM2M URC 上报 1 启用 LwM2M URC 上报 整型。运营商类型。 0 所有运营商 1 其他运营商或无 SIM 卡插入 2 Verizon 3 AT&T 4 CMCC 5 DoCoMo 上海移远通信技术股份有限公司 12 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 6 Sprint 7 T-Mobile 8 Rogers 9 Bell 10 Telus 11 SoftBank 12 KDDI 13 Rakuten 14 Telstra 15 Deutsche Telekom 16 SK Telecom 17 Korea Telecom 18 LGU+ 整型。针对指定运营商，LwM2M 功能是否自启动。 0 模块重新上电后，LwM2M 客户端不会自启动 1 模块重新上电后，LwM2M 客户端会自启动 字符串类型。上位机设备的唯一识别码。 字符串类型。上位机设备的制造商名称。 字符串类型。上位机设备型号。 字符串类型。上位机设备软件版本号。 字符串类型。上位机设备固件版本号。 字符串类型。上位机设备硬件版本号。 整型。从 1970 年 1 月 1 日 00：00：00 到最近一次固件或软件更新时间的秒 数。如果没有可用的时间戳，则返回 0。 整型。网络类型。 0 非 Verizon 或 AT&T 网络 1 Verizon 2 AT&T 字符串类型。引导服务器 URL。如果为'0'，表示 清除所有已配置的 URL，使用默认的商用服务器 URL。 2.3.2. AT+QLWREG 向 LwM2M 服务器发送注册请求 该命令用于向 LwM2M 服务器发送注册请求。 AT+QLWREG 向 LwM2M 服务器发送注册请求 测试命令 响应 AT+QLWREG=? 执行命令 OK 响应 AT+QLWREG OK 或者 ERROR 上海移远通信技术股份有限公司 13 / 23 最大响应时间 特性说明 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 150 毫秒 / 2.3.3. AT+QLWUPDATE 向 LwM2M 服务器发送更新请求 该命令用于向 LwM2M 服务器发送更新请求。 AT+QLWUPDATE 向 LwM2M 服务器发送更新请求 测试命令 响应 AT+QLWUPDATE=? 设置命令 OK 响应 AT+QLWUPDATE= OK 或者 ERROR 最大响应时间 150 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。服务器 ID。不包含引导服务器（Bootstrap）。 0 所有服务器 101 Verizon 网络下的 Diagnostics 服务器 102 Verizon 网络下的 DM 服务器 1000 Verizon 网络下的 Repository 服务器 其他值 其他指定的服务器 ID 2.3.4. AT+QLWDEREG 向 LwM2M 服务器发送注销请求 该命令用于向 LwM2M 服务器发送注销请求。 AT+QLWDEREG 向 LwM2M 服务器发送注销请求 测试命令 响应 AT+QLWDEREG=? 执行命令 OK 响应 AT+QLWDEREG OK 或者 ERROR 最大响应时间 150 毫秒 特性说明 / 上海移远通信技术股份有限公司 14 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 3 LwM2M 相关的 URC 此章节主要描述了和 LwM2M 相关的 URC。 3.1. +QLWURC: 'pdp active' PDP 激活结果指示 该 URC 用于上报 PDP 的激活结果。在向 LwM2M 服务器发送注册请求之前，用户应先使用 AT+CGACT 激活 PDP。有关 AT+CGACT 的详细信息，请参考文档 [1]。 +QLWURC: 'pdp active' PDP 激活结果指示 +QLWURC: 'pdp active',, 该 URC 用于上报 PDP 的激活结果。 参数 字符串类型。PDP 的激活结果。 'successfully' 成功 'failed' 失败 字符串类型。APN 名称。 3.2. +QLWURC: 'initial' 初始化结果指示 该 URC 用于上报客户端和 LwM2M 服务器之间连接的初始化结果。 +QLWURC: 'initial' 初始化结果指示 +QLWURC: 'initial',, 该 URC 用于上报连接初始化的结果。 参数 字符串类型。初始化结果。 'successfully' 成功 'failed' 失败 整型。服务器 ID。 上海移远通信技术股份有限公司 15 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 100 101 102 1000 其他值 Verizon 网络下的 Bootstrap 服务器 Verizon 网络下的 Diagnostics 服务器 Verizon 网络下的 DM 服务器 Verizon 网络下的 Repository 服务器 其他指定的服务器 ID 3.3. +QLWURC: 'dtls' DTLS 单向认证结果指示 该 URC 用于当握手协商加密时上报 DTLS 的单向认证结果。 +QLWURC: 'dtls' DTLS 单向认证结果指示 +QLWURC: 'dtls',, 该 URC 用于上报 DTLS 的单向认证结果。 Parameter 字符串类型。DTLS 的单向认证结果。 'successfully' 成功 'failed' 失败 整型。服务器 ID。 100 Verizon 网络下的 Bootstrap 服务器 101 Verizon 网络下的 Diagnostics 服务器 102 Verizon 网络下的 DM 服务器 1000 Verizon 网络下的 Repository 服务器 其他值 其他指定的服务器 ID 3.4. +QLWURC: 'dns' DNS 解析结果指示 该 URC 用于上报 DNS 解析结果。 +QLWURC: 'dns' DNS 解析结果指示 +QLWURC: 'dns',, 该 URC 用于上报 DNS 解析结果。 Parameter 字符串类型。DNS 解析结果。 'successfully' 成功 'failed' 失败 上海移远通信技术股份有限公司 16 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 整型。服务器 ID。 100 Verizon 网络下的 Bootstrap 服务器 101 Verizon 网络下的 Diagnostics 服务器 102 Verizon 网络下的 DM 服务器 1000 Verizon 网络下的 Repository 服务器 其他值 其他指定的服务器 ID 3.5. +QLWURC: 'bootstraping' Bootstrap 服务器运行指示 该 URC 用于上报 Bootstrap 服务器正在运行。 +QLWURC: 'bootstraping' Bootstrap 服务器运行指示 +QLWURC: 'bootstraping' 该 URC 用于上报 Bootstrap 服务器正在运行。 3.6. +QLWURC: 'bootstrap' Bootstrap 服务器运行结果指示 该 URC 用于上报 Bootstrap 服务器的运行结果。 +QLWURC: 'bootstrap' Bootstrap 服务器运行结果指示 +QLWURC: 'bootstrap',, 该 URC 用于上报 Bootstrap 服务器的运行结果。 参数 字符串类型。Bootstrap 服务器的运行结果。 'successfully' 成功 'failed' 失败 整型。服务器 ID。 100 Verizon 网络下的 Bootstrap 服务器 其他值 其他指定的服务器 ID 上海移远通信技术股份有限公司 17 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 3.7. +QLWURC: 'registering' 开始注册的指示 当客户端注册 LwM2M 服务器时，将上报此 URC 以指示开始注册的状态。 +QLWURC: 'registering' 开始注册的指示 +QLWURC: 'registering' 该 URC 用于上报客户端正在注册 LwM2M 服务器。 3.8. +QLWURC: 'ready' 注册结果指示 在向 LwM2M 服务器发送注册请求后，将上报此 URC 以指示注册结果。 +QLWURC: 'ready' 注册结果指示 +QLWURC: 'ready',, 此 URC 用于上报注册结果。 参数 字符串类型。注册结果。 'successfully' 成功 'failed' 失败 整型。服务器 ID。不包含引导服务器（Bootstrap）。 101 Verizon 网络下的 Diagnostics 服务器 102 Verizon 网络下的 DM 服务器 1000 Verizon 网络下的 Repository 服务器 其他值 其他指定的服务器 ID 3.9. +QLWURC: 'update' 更新结果指示 在向 LwM2M 服务器发送更新请求后，将上报此 URC 以指示更新结果。 +QLWURC: 'update' 更新结果指示 +QLWURC: 'update',, 此 URC 用于上报更新结果。 参数 字符串类型。更新结果。 'successfully' 成功 上海移远通信技术股份有限公司 18 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 'failed' 失败 整型。服务器 ID。不包含引导服务器（Bootstrap）。 101 Verizon 网络下的 Diagnostics 服务器 102 Verizon 网络下的 DM 服务器 1000 Verizon 网络下的 Repository 服务器 其他值 其他指定的服务器 ID 3.10. +QLWURC: 'deregister' 注销结果指示 当向 LwM2M 服务器发送注销请求后，将上报此 URC 以指示注销结果。 +QLWURC: 'deregister' 注销结果指示 +QLWURC: 'deregister', 此 URC 用于上报注销结果。 参数 整型。服务器 ID。不包含引导服务器（Bootstrap）。 101 Verizon 网络下的 Diagnostics 服务器 102 Verizon 网络下的 DM 服务器 1000 Verizon 网络下的 Repository 服务器 其他值 其他指定的服务器 ID 上海移远通信技术股份有限公司 19 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 4 举例 本章通过举例说明 LwM2M 相关 AT 命令的使用方法。请先插入并启用 SIM 卡后再开始以下测试。对 于本文档中提到但没有详细描述的一些 AT 命令，用户可以通过查看文档 [1]了解更多的 AT 命令信息和用 法。 4.1. 登录 Verizon LwM2M 测试服务器 AT+QLWDEREG //向 LwM2M 服务器发送注销请求。 OK AT+QLWCFG='reset' //擦除 LwM2M 客户端运行记录。 OK AT+QLWCFG='security' //查询 LwM2M 安全对象资源。 +QLWCFG: 'security',0,100,'coaps://boot.lwm2m.vzwdm.com:5684',1,0 +QLWCFG: 'security',2,101,'coaps://diag.lwm2m.vzwdm.com:5684',0,0 OK AT+QLWCFG='security',0 //删除 Bootstrap 服务器的属性数据。 OK AT+QLWCFG='security' //查询当前配置。 +QLWCFG: 'security',2,101,'coaps://diag.lwm2m.vzwdm.com:5684',0,0 OK AT+GSN 865814040000216 //查询当前设备的国际移动设备识别码。 OK AT+CNUM //读取(U)SIM 卡中所有本机号码记录。 +CNUM: 'Line 1','+15404498889',145 OK AT+QLWCFG='security',0,100,'coaps://xvzwcdpii.xdev.motive.com:5684',1,0,'urn:imei-msisdn:8 65814040000216-5404498889','d6160c2e7c90399ee7d207a22611e3d3a87241b0462976b935341d00 0a91e747' //设置 Bootstrap 服务器的属性数据。 OK AT+QLWCFG='security' //查询当前设置。 +QLWCFG: 'security',0,100,'coaps://xvzwcdpii.xdev.motive.com:5684',1,0 上海移远通信技术股份有限公司 20 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 +QLWCFG: 'security',2,101,'coaps://diag.lwm2m.vzwdm.com:5684',0,0 OK AT+CFUN=1,1 OK //设置重置设备后将设备切换为全功能模式。 +QLWURC: 'pdp active','successfully','VZWADMIN' +QLWURC: 'dns','successfully',100 +QLWURC: 'dtls','successfully',100 +QLWURC: 'bootstraping' +QLWURC: 'bootstrap','successfully',100 +QLWURC: 'dns','successfully',102 +QLWURC: 'dns','successfully',101 +QLWURC: 'dtls','successfully',102 +QLWURC: 'ready','successfully',102 +QLWURC: 'pdp active','successfully','VZWINTERNET' +QLWURC: 'dns','successfully',1000 +QLWURC: 'update','successfully',102 +QLWURC: 'dtls','successfully',101 +QLWURC: 'dtls','successfully',1000 +QLWURC: 'ready','successfully',101 +QLWURC: 'ready','successfully',1000 OK 4.2. 使用测试模式登录 Verizon LwM2M 测试服务器 AT+QLWDEREG //向 LwM2M 服务器发送注销请求。 OK AT+QLWCFG='testmode','0' //清除所有已配置的 URL。 OK AT+QLWCFG='testmode','coaps://xvzwcdpii.xdev.motive.com:5684' // 配 置 模 块 连 接 到 的 Bootstrap 服务器的 URL。 OK AT+CFUN=1,1 OK //设置重置设备后将设备切换为全功能模式。 上海移远通信技术股份有限公司 21 / 23 EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 5 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_EG06xK&Ex120K&EM060K_Series_AT_Commands_Manual 表 4：术语缩写 缩写 APN AT&T CMCC CoAP DM DNS DTLS ID LTE LwM2M M2M PDP PSK REST SKT SMS 英文描述 Access Point Name American Telephone & Telegraph China Mobile Communications Corporation Constrained Application Protocol Device Management Domain Name Server Datagram Transport Layer Security Identifier Long Term Evolution Lightweight Machine to Machine Machine to Machine Packet Data Protocol Pre-Shared Key Representational State Transfer SK Telecom Short Message Service 中文描述 接入点名称 美国电话电报公司 中国移动通信集团有限公司 受限的应用层协议 设备管理 域名系统（服务）协议 数据包传输层安全协议 标识符 长期演进 轻量化 M2M（协议） 机器对机器 分组数据协议 预共享密钥 表述性状态转移 韩国 SK 电讯 短消息业务 上海移远通信技术股份有限公司 22 / 23 SSID TA UDP URC URL VZW EG06xK&Ex120K&EM060K 系列 LwM2M 应用指导 Service Set Identifier Terminal Adapter User Datagram Protocol Unsolicited Result Code Uniform Resource Locator Verizon Wireless 服务集标识符 终端适配器 基于 UDP 的数据传输协议 非请求结果码 统一资源定位符 威瑞森无线公司 上海移远通信技术股份有限公司 23 / 23

EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 LTE Standard 模块系列 版本：1.1 日期：2023-10-16 状态：受控文件 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 文档历史 修订记录 版本 日期 作者 1.0 2020-04-30 Chaim QIAN 1.1 2023-10-16 Mount ZHONG 变更表述 初始版本 1. 更新适用模块： ⚫ 更新 EC20 R2.1 为 EC20-CE。 ⚫ 新增 EG21-GL 和 EG25-GL。 ⚫ 删除 EP200F-CE。 2. 更新备注信息（第 3.2 章节）。 3. 删除 Windows 8 系统下的 PPP 拨号流程（第 6.2 章 节）。 4. 更新配置拨号工具步骤（第 6.2.2.3 章节）。 5. 增加 Linux 系统下的 PPP 拨号流程（第 6.3 章）。 上海移远通信技术股份有限公司 3 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 2 PPP 应用模式........................................................................................................................................ 8 3 PPP 设置 ............................................................................................................................................... 9 3.1. PPP 设置流程............................................................................................................................. 9 3.2. PPP 设置流程建议 ................................................................................................................... 10 4 PPP 连接模式...................................................................................................................................... 12 4.1. 数据模式和命令模式................................................................................................................. 12 4.1.1. 从数据模式切换到命令模式 ........................................................................................... 12 4.1.1.1. 更改 DTR 电平切换至命令模式 .......................................................................... 12 4.1.1.2. 使用+++切换至命令模式 .................................................................................... 12 4.1.2. 从命令模式切换到数据模式 ........................................................................................... 13 4.1.2.1. 使用 ATO 切换至数据模式.................................................................................. 13 4.2. 数据模式下处理 URC ............................................................................................................... 13 4.3. 数据载波检测（DCD）模式 ..................................................................................................... 13 5 终止 PPP 连接..................................................................................................................................... 14 6 PPP 拨号操作...................................................................................................................................... 15 6.1. 准备工作 ................................................................................................................................... 15 6.2. Windows 10 系统下的 PPP 拨号.............................................................................................. 15 6.2.1. 调制解调器配置 ............................................................................................................. 15 6.2.1.1. 添加新的调制解调器........................................................................................... 15 6.2.1.2. 配置调制解调器驱动........................................................................................... 20 6.2.2. 拨号上网网络配置 ......................................................................................................... 21 6.2.2.1. 创建新的网络连接 .............................................................................................. 21 6.2.2.2. 配置连接 ............................................................................................................. 23 6.2.2.3. 配置拨号工具...................................................................................................... 24 6.2.2.4. 建立拨号上网连接 .............................................................................................. 25 6.3. Linux 系统下的 PPP 拨号......................................................................................................... 26 6.3.1. Linux 拨号基本流程 ....................................................................................................... 26 6.3.1.1. pppd 命令拨号 .................................................................................................... 26 6.3.1.2. quectel-pppd.sh 脚本拨号 .................................................................................. 30 6.3.1.3. 挂断 PPP 拨号 .................................................................................................... 31 6.3.2. PPP 脚本拨号具体流程 ................................................................................................. 32 7 附录 术语缩写..................................................................................................................................... 33 上海移远通信技术股份有限公司 4 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：术语缩写 ........................................................................................................................................... 33 上海移远通信技术股份有限公司 5 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 图片索引 图 1：PPP 应用模式..................................................................................................................................... 8 图 2：PPP 设置流程..................................................................................................................................... 9 图 3：PPP 设置推荐流程图........................................................................................................................ 10 图 4：查找电话和调制解调器（Windows 10 系统）.................................................................................. 16 图 5：添加新的调制解调器（Windows 10 系统） ..................................................................................... 17 图 6：选择调制解调器类型（Windows 10 系统） ..................................................................................... 18 图 7：选择端口（Windows 10 系统）........................................................................................................ 19 图 8：安装新调制解调器成功（Windows 10 系统）.................................................................................. 19 图 9：配置调制解调器驱动（Windows 10 系统） ..................................................................................... 20 图 10：设置新的连接或网络（Windows 10 系统） ................................................................................... 21 图 11：设置新连接（Windows 10 系统） .................................................................................................. 22 图 12：配置连接（Windows 10 系统）...................................................................................................... 23 图 13：配置拨号上网工具（Windows 10 系统） ....................................................................................... 24 图 14：正在连接到拨号连接（Windows 10 系统） ................................................................................... 25 图 15：拨号连接成功（Windows 10 系统） .............................................................................................. 25 图 16：拨号流程图（Linux 系统） ............................................................................................................. 26 图 17：修改用户配置.................................................................................................................................. 27 图 18：修改 APN........................................................................................................................................ 27 图 19：启动 PPP 拨号（1） ...................................................................................................................... 28 图 20：启动 PPP 拨号（2） ...................................................................................................................... 28 图 21：查看网卡信息.................................................................................................................................. 29 图 22：查看路由信息.................................................................................................................................. 29 图 23：查看 DNS 信息 ............................................................................................................................... 29 图 24：检查网络连通.................................................................................................................................. 30 图 25：shell_PPP 拨号 .............................................................................................................................. 30 图 26：shell 脚本参数................................................................................................................................. 30 图 27：PPP 脚本拨号具体流程 .................................................................................................................. 32 上海移远通信技术股份有限公司 6 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 1 引言 本文档简要介绍了移远通信 EC2X、EG2X、EG9X 和 EM05 系列模块的 PPP 功能，包括应用模式、 PPP 设置步骤、PPP 连接模式、PPP 终止步骤和 PPP 拨号示例等。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG2x EG9x - 模块 EC20-CE EC20-CN EC21 系列 EC25 系列 EG21-G EG25-G EG21-GL EG25-GL EG91 系列 EG95 系列 EM05 系列 上海移远通信技术股份有限公司 7 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 2 PPP 应用模式 PPP（点对点协议）的使用方法如下图所示，UART 端口或 USB 端口均可用于 PPP 连接。模块为应 用程序提供 PPP 服务器，应用程序端为模块提供 PPP 客户端。同时，应用程序端必须提供 TCP/IP、 HTTP(S)等协议。当建立 PPP 连接时，来自应用程序端的 IP 报文数据流将通过模块传输到网络。 大多数标准操作系统（例如 Windows 系统、Unix/Linux 系统）都有 PPP 协议栈。针对无可用应用程 序进行 PPP 连接的操作系统，需先开发适用的应用软件。 Application IP PPP UART TXD RXD CTS RTS DTR DCD RING USB USB_DM USB_DP USB_GN USB_VBUS 应用程序端 IP RELAY PPP TXD RXD CTS RTS DTR DCD RING UART Radio Bearer USB_DM USB_DP USB_GND USB_VBUS USB 模块端 图 1：PPP 应用模式 上海移远通信技术股份有限公司 8 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 3 PPP 设置 3.1. PPP 设置流程 模块注册网络后，请通过 AT+CGDCONT 命令为 PPP 设置 APN，并通过 ATD*99#命令启动 PPP。执 行 ATD*99#命令后，模块将进入 PPP 帧交互流程，该流程基于标准 PPP 进行。模块数据包交互说明如下 图所示。如需获取有关标准 PPP 的详细信息，请参考 RFC 1661。 TE MT AT+CGREG? +CGREG:0,1 AT+CGDCONT=1,'IP','CMNET' OK ATD*99# CONNECT 7E FF 7D 23 C0 21 7D 21 7D …… 图 2：PPP 设置流程 上海移远通信技术股份有限公司 9 / 33 3.2. PPP 设置流程建议 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 模块 上电 建议 开关 机方式 ： 1. 关机：拉低电源键。当 STATUS 引 脚拉 低1秒时 ，切断 电源。 2. 开机：电源键拉低 1秒。 3. 完成开关机后再拉高电源键。 1. TE与 TA同步。 2. 执行AT+IPR=xxx&W，设置并保存波特率. 若使用 USB modem 口，可省略此操作。 否 查询 (U)SIM卡状态： A T+C PIN。如果 执行A T+C PIN?后20 秒内没有检测到 (U)SIM卡，重启模 块。 网络： 1.当AT + CREG=?返回1或5时，表示 模块 已在网 络上注 册。 2.如果 模块在 60 秒内 无法注 册网络 ，请 重启 模块。 PS网络： 1. 当AT + CGREG返回1或5时，表示 模块 已在PS上注 册。 2. 注册PS后无需等待60秒即可进入下 一步。 如果 (U)SIM卡在20秒内未就绪， 则退 出PPP拨号 。 AT+CPIN? 是 查询(U)SIM 卡状 态 (U)SIM卡准 备就绪 如果 模块在 60 秒内 无法注 册 网络 ，则退 出PPP拨号 AT+CREG? 查 询网 络状态 60 秒内 注册网 络 AT+CGREG? 查 询 PS网络 Connect_Count< 5 APN 配置： 1. APN 必须由 AT+CGDCONT配置。 2. 当AT + CGDCONT返回错误时，执 行A T+C GA CT ?查询 当前上 下文是 否 已被 激活。 1. 通过 AT+CGDCONT设置APN 2. 通过 ATD*99#开始PPP拨号 Connect_Count++ 数据包交互 数据 包互 动： 1. 通过+++退出数据包交互过程。 2.当PPP连接 终止时 ，模块 将上报 N O CARRIER。 LCP协商： 若使 用U ART，请确 保MC U与模 块之 间的 波特率 相同。 AUTH 协商： 确保 AU TH的类 型为PAP（0x c02 3） 与C HAP（0x c22 3）其中 之一。 IPCP 协商： 1. 检查MCU是否获取合法的IP和DNS 地址。 2.检查DNS MCU的数量是否与MCU请 求的 数量一 致。 3.如果 TA和TE之间 的IPCP协商 未在90 秒内 完成，终止 PPP连接 ，并重 试 PPP设置。 异常 处理 ： 1. 检查PPP终止请求数据包是否正 确。 2. 若上述步骤未生效，重启模块。 IPCP协商 开始时 ， 启动 定时器 返回 CONNECT LCP 协商 OK AUTH 协商 OK 异常 处理 否 发送 Count<5 IPCP 协商 是 否 OK 90 秒内 成功进 行 IPCP协商 MCU 向 否 PPP发送 Terminate- Request数 据包 MCU 在3秒内接 收PPP Terminate- 是 R equ est数据 包 发送 Count++ 是 MCU已获取IP 和 否 DNS 是 数据 传输 图 3：PPP 设置推荐流程图 上海移远通信技术股份有限公司 10 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 模块上电时，如果使用主串口，则通过执行 AT+IPR=xxx;&W 命令设置波特率。执行 ATD*99#命令设 置 PPP 之前，必须通过 AT+CPIN?命令检查(U)SIM 卡的状态。当(U)SIM 卡准备就绪时，请通过 AT+CREG?和 AT+CGREG?命令定期检查网络注册状态，直到网络准备就绪。 备注 1. 重启模块后，请确保 MCU 和模块同步成功。MCU 每隔 100 毫秒会向模块发送 AT直至 收到模块上报的 OK。如果使用主串口，MCU 会在成功同步波特率后通过执行 AT+IPR=xxx;&W 命 令来设置并保存波特率。 2. 输入下一个 AT 命令之前，MCU 需等待前一个 AT 命令的响应（如响应 OK，CME error，CMS error）。 若 60 秒内无响应，可重启模块。 3. 强烈建议不要频繁开启或关闭模块。如果连续 3 次拨号重试失败，则第 4 次可以立即关闭/打开（重 置）模块。如果第 4 次拨号重试仍失败，则需等待 10 分钟后第 5 次重置模块，30 分钟后第 6 次重 置模块，一小时后第 7 次重置模块。 4. 如果在建立 PPP 连接后 MCU 未能将数据传输到网络，请检查 PPP 的配置和网络状态并重启模块。 5. 如果模块已注册 CDMA 网络，请勿使用 ATD#777 命令设置 PPP，应使用 ATD*99#命令进行设置。 上海移远通信技术股份有限公司 11 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 4 PPP 连接模式 4.1. 数据模式和命令模式 模块通过 USB/UART 端口与应用程序进行信息通信（含 AT 命令和数据信息）。USB/UART 端口有两 种工作模式：数据模式和命令模式。 在建立 PPP 之前，端口处于命令模式，模块可在该状态下执行 AT 命令。当 PPP 协商开始时，端口将 进入数据模式，并在建立 PPP 连接时保持为数据模式；若未成功建立 PPP 连接，端口将处于命令模式。 在数据模式下，模块无法执行 AT 命令。 适用于本文档的移远通信 EC2X、EG2X、EG9X 和 EM05 系列模块均提供了在数据模式与命令模式之 间切换的便捷方法。 4.1.1. 从数据模式切换到命令模式 4.1.1.1. 更改 DTR 电平切换至命令模式 当已建立 PPP 连接且 USB/UART 端口处于数据模式时，将 DTR 电平从低电平变为高电平即可从数据 模式切换至命令模式（需先执行 AT&D1 命令）。切换成功后，模块将返回 OK。 4.1.1.2. 使用+++切换至命令模式 在 PPP 连接成功建立后使用+++，也可将 USB/UART 端口从数据模式切换至命令模式。为防止+++转 义序列被误解为数据，应遵循以下要求： 1. 输入+++前一秒内不可输入任何字符。 2. 1 秒内输入+++，在此期间不可输入任何其他字符。 3. 输入+++后 1 秒内不可输入任何字符。 当接收到+++时，USB/UART 端口将从数据模式切换到命令模式，模块将返回 OK。 上海移远通信技术股份有限公司 12 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 备注 请在完成 PPP 协商后执行上述操作，否则上述操作将终止 PPP 协商并且 USB/UART 端口将退出数据模 式。完成 PPP 协商后，当 USB/UART 端口切换到命令模式时，输入的数据被当成 AT 命令，模块保持 PPP 连接状态。 4.1.2. 从命令模式切换到数据模式 4.1.2.1. 使用 ATO 切换至数据模式 当保持 PPP 连接状态时，USB/UART 端口处于命令模式，执行命令 ATO 后，即可进入数据模式。 举例如下： //当保持 PPP 连接状态时，USB/UART 端口处于命令模式。 ATO CONNECT //表示 TA 已进入数据模式，从 USB/UART 端口输入的所有数据 将被视为 PPP 帧。 4.2. 数据模式下处理 URC 处于 PPP 连接状态下，数据模式下的来电和短信 URC 不会上报至 PPP 拨号端口，但模块的 RI 引脚 电平将从高电平变为低电平并持续 120 毫秒作为来电和短信 URC 上报的指示。MCU 可以根据 RI 引脚状态 将端口切换至命令模式以处理来电或短信。切换到命令模式后，如果仍然有来电或短信，将向 PPP 拨号端 口上报 URC。 4.3. 数据载波检测（DCD）模式 DCD 模式由 AT&C 命令决定。如果执行 AT&C0 命令，DCD 引脚不指示数据载波状态。而执行 AT&C1 命令，DCD 引脚将用于指示数据载波状态。当有数据载波或开始 PPP 协商时，DCD 引脚将保持低电平状 态，反之则保持高电平状态。 备注 将模块的 USB/UART 端口从数据模式切换到命令模式（使用+++）时，DCD 状态保持不变。 上海移远通信技术股份有限公司 13 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 5 终止 PPP 连接 终止 PPP 拨号连接有如下两种方式： 1. 通过 LCP Terminate-Request 消息终止 PPP 连接。推荐使用该方法终止 PPP 连接。 2. TA 也可通过更改 DTR 电平终止 PPP 连接。请先通过 AT&D2 命令设置 DTR 功能，将 DTR 电平 从低电平更改为高电平，数据连接将自动终止。PPP 连接完全终止后，USB/UART 端口将进入命 令模式。 举例如下： //USB/UART 端口处于命令模式。 AT&D2 OK 备注 1. PPP 终止流程须在数据模式下进行操作。 2. PPP 终止流程可在 PPP 设置阶段或连接过程中随时进行。 上海移远通信技术股份有限公司 14 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 6 PPP 拨号操作 本章将分别介绍如何在 Windows 10 和 Linux 系统中建立 PPP 连接。 6.1. 准备工作 在 Windows 系统中建立 PPP 拨号连接之前，必须完成以下步骤。 1. 如果(U)SIM 卡 PIN 已锁定，请将模块连接到 PC 并输入 PIN 码。 2. 确保(U)SIM 卡能够成功注册 GPRS 网络。 6.2. Windows 10 系统下的 PPP 拨号 6.2.1. 调制解调器配置 6.2.1.1. 添加新的调制解调器 如果没有安装'标准 19200 bps 调制解调器'，则需要在控制面板的调制解调器中添加新的标准调制解 调器。 步骤1： 在主界面搜索'电话'，当出现'电话和调制解调器'时，点击进入'电话和调制解调器'， 如下图所示。 上海移远通信技术股份有限公司 15 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 图 4：查找电话和调制解调器（Windows 10 系统） 上海移远通信技术股份有限公司 16 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 步骤2： 双击'电话和调制解调器'选项，选择'调制解调器'→'添加(D)…'，添加新的调制解调 器，如下图所示。 图 5：添加新的调制解调器（Windows 10 系统） 上海移远通信技术股份有限公司 17 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 步骤3： 按照屏幕所示说明安装新的调制解调器： 1. 选择'标准 19200 bps 调制解调器'并选定将要安装的端口（如'COM10'）； 2. 单击'下一步(N)'按钮，直到配置完成。 有关详细信息，请参参考下图。 图 6：选择调制解调器类型（Windows 10 系统） 上海移远通信技术股份有限公司 18 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 图 7：选择端口（Windows 10 系统） 图 8：安装新调制解调器成功（Windows 10 系统） 上海移远通信技术股份有限公司 19 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 6.2.1.2. 配置调制解调器驱动 1. 选择已安装的'标准 19200 bps 调制解调器'，单击'属性(P)'按钮。 2. 进入界面后，选择'调制调节器'标题，将'最大端口速度(M)'修改为'115200'（默认值）。 3. 单击'高级'标题，配置'额外设置'，输入命令 AT+CGDCONT=1,'IP','CMNET'。 如下图所示。 图 9：配置调制解调器驱动（Windows 10 系统） 上海移远通信技术股份有限公司 20 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 备注 上述示例中，AT+CGDCONT=1,'IP','CMNET'命令预定义了 PDP 上下文，其中 CID 为 1，PDP 类型为 IP，APN 为 CMNET。CMNET 为网络运营商中国移动的 APN，该 APN 应替换为网络运营商定义的值。 6.2.2. 拨号上网网络配置 6.2.2.1. 创建新的网络连接 步骤1： 打开'控制面板'并点击'网络和 Internet'，然后点击'设置新的连接或网络'，如下图所示。 图 10：设置新的连接或网络（Windows 10 系统） 上海移远通信技术股份有限公司 21 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 步骤2： 选择'连接到 Internet'，点击'下一步(N)'；点击'设置新连接(S)'后点击'拨号(D)' 进行连接，如下图所示。 图 11：设置新连接（Windows 10 系统） 上海移远通信技术股份有限公司 22 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 6.2.2.2. 配置连接 在'拨打电话号码(D)'中输入数字（例如*99#），并点击'连接(C)'，如下图所示。 图 12：配置连接（Windows 10 系统） 上海移远通信技术股份有限公司 23 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 6.2.2.3. 配置拨号工具 1. 在窗口中的'拨号(I)'中输入数字（例如*99#）。 2. 单击'属性(O)'按钮，配置'标准 19200 bps 调制解调器（COM10）'。 3. 最后在'最高速度(bps)(M)'的下拉列表中选择'115200'。 4. 单击'确定'按钮完成配置。 5. 单击'拨号(D)'按钮来发起 ppp 拨号。 有关详细信息，请参考下图。 图 13：配置拨号上网工具（Windows 10 系统） 上海移远通信技术股份有限公司 24 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 6.2.2.4. 建立拨号上网连接 界面将弹出提示框'正在验证用户名和密码'，弹出框快速弹出'已连接'时表示拨号连接成功。有 关连接状态信息，请参考下图。 图 14：正在连接到拨号连接（Windows 10 系统） 图 15：拨号连接成功（Windows 10 系统） 上海移远通信技术股份有限公司 25 / 33 6.3. Linux 系统下的 PPP 拨号 6.3.1. Linux 拨号基本流程 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 开始 启动模块并驻网 移植chat脚本到 Linux上 启动拨号 执行拨号脚本 执行 失败 拨号成功 执行Ping测试网络 结束 重启模块 再次执行脚本 图 16：拨号流程图（Linux 系统） 6.3.1.1. pppd 命令拨号 chat 脚本和 options 脚本与 PPP 连接关系密切。其中，chat 脚本用于与模块进行 AT 呼叫和控制；而 options 脚本用于配置 PPP，设置 PPP 连接。 Quectel 提供的脚本： ⚫ chat 脚本：quectel-chat-connect 和 quectel-chat-disconnect。 ⚫ options 脚本：quectel-ppp。 上海移远通信技术股份有限公司 26 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 执行步骤： 步骤1： 准备脚本。 ~$ tar -zxvf xxxx.tar.gz ~$ cd /xxx/ ~$ dos2unix * 步骤2： 将 PPP 脚本拷贝到/etc/ppp/peers/。 ~$ cp quectel-chat-connect quectel-chat-disconnect quectel-ppp /etc/ppp/peers/ 步骤3： 修改脚本文件。 ~$ vi quectel-ppp # Modem path 修改为：/dev/ttyUSB3 115200 # user name and passwd 可取默认值 步骤4： 修改 APN。 ~$ vi quectel-chat-connect # 修改 APN 信息 图 17：修改用户配置 步骤5： 启动PPP拨号。 ~$ pppd call quectel-ppp & 图 18：修改 APN 上海移远通信技术股份有限公司 27 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 图 19：启动 PPP 拨号（1） 图 20：启动 PPP 拨号（2） 上海移远通信技术股份有限公司 28 / 33 步骤6： 查看网卡信息。 ~$ ifconfig ppp0 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 步骤7： 查看路由信息。 ~$ route -n 图 21：查看网卡信息 步骤8： 查看 DNS 信息。 ~$ cat /etc/resolv.conf 图 22：查看路由信息 步骤9： 查看网络连接状态。 ~$ ping www.baidu.com 图 23：查看 DNS 信息 上海移远通信技术股份有限公司 29 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 图 24：检查网络连通 6.3.1.2. quectel-pppd.sh 脚本拨号 shell 脚本拨号原理和上述 pppd 命令拨号一致，都是通过向 modem 侧发送 AT 命令进行 PPP 拨号， 拨号成功后的验证步骤与上述 pppd 命令拨号的验证步骤一致。 启动拨号步骤： ~$ ./quectel-pppd.sh /dev/ttyUSB3 cmnet test test ATD*99***2# 图 25：shell_PPP 拨号 图 26：shell 脚本参数 其中 QL_PDP、QL_IP、QL_APN 可通过 AT+CGDCONT=$QL_PDP,'$QL_IP','$QL_APN',,0,0 进 行设置，以在 PPP 拨号中修改或者新建一路 APN，QL_PDP 可通过 ATD*99***$QL_PDP 进行设置，以指 定使用哪一路通道进行拨号。 上海移远通信技术股份有限公司 30 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 6.3.1.3. 挂断 PPP 拨号 ⚫ pppd 命令挂断。 ~$ sudo killall pppd ⚫ 执行脚本挂断。 ~$ sudo ./quectel-ppp-kill ⚫ AT 命令挂断。 ~$ sudo minicom -D /dev/ttyUSB2 ~$ AT&D2 挂断拨号后，需要重启模块，否则会导致下次拨号失败。 上海移远通信技术股份有限公司 31 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 6.3.2. PPP 脚本拨号具体流程 否 脚本 不存在 进程 退出 开始 读取 ql_ppp 脚本 运行 pppd 收到 如下字 符串 脚本 自动退 出 脚本 存在 是 连接 Quec tel脚本 配置 USB端口 /dev/ttyU SB3 1152 00 配置 用户名 和 密码 ： user test pass word tes t 异常 判断 ABOR T BUSY ABOR T 'N O CARR IER' ABOR T 'N O D IALT ON E' ABOR T ERROR ABOR T 'N O AN SWER' 发送 AT命令 进行 拨号 Connec t: ppp0 /dev/ttyU SB3 驱动 在内核 创建 接口 并使 用接口 ppp0 L CP协商 CH AP 认证 N CP协议 d e b ug 打印调试信息 n o d et a ch dump n o au t h u se r pass word 不需要手机进行身份验证 用户名 用户密码 r e mo te n a me Modem：/dev/ttyU SB3 发送AT命令的串口 asy nc map 0 lc p-echo-fai lure 4 lc p-echo-interv al 30 n o vj ipc p-acc ept-local ipc p-acc ept -remote ipparam 3g ppp n o ip d ef a u lt d e fa u lt r ou t e u se p e e rd n s nocc p n o ip x 发送 AT(期待 返回OK ) 发送 d (ATE 0) (期待 返回OK ) 发送 (ATI ;+CSUB ;+CSQ;+CPIN ?; +COPS ?;+CG REG?;&D2) 查询 网络状 态，并结 束上次 的链路 发送 (AT+CG DCON T=1,'IP','3g net',,0,0) 配置 网络APN 发送 (ATD *99#) 启动 ppp拨号 返回 CON NECT ，脚本 建立链 路完成 发送 [L CP ConfR eq id=0x1 < mag ic 0x5fee 29b6> < pcomp > ] rcv d [L CP ConfAc k id=0x1 < pcomp > < acc omp>] rcv d [L CP ConfR eq id=0x0 < mag ic 0xa3310 ae6> < acc omp>] 发送 [L CP ConfAc k id=0x0 < mag ic 0xa3310 ae6> < acc omp>] rcv d [CH AP Chal lenge i d=0x1 , name = ' UM TS_CH AP _SRVR'] 发送 [CH AP Response i d=0x1 , name = ' tes t'] rcv d [CH AP Succ es s id=0x1 ''] CH AP authentic ati on succ eeded 协商 内容包 括工作 方式是 SP（Single -link PPP）还是 MP（Multilink PPP）、 最大 接收单 元MRU（Maximum Receive Unit）、 验证 方式和 魔术字 （magic number）等选 项。LCP协商 成功后 进 入Opened状态 ，表示 底层链 路已经 建 立。 P AP和CHAP通常 被用在 PPP 封装 的串行 线路 上的身 份认证 阶段，提供 安全性 认证 。 PAP 身份 验证方 式下账 号和密 码在网 络 中明 文传输 ，CHAP身份 验证方 式下密 码加 密传输 。 IPCP 控制 协议 发送 [IPCP ConfReq i d=0x1 < msdns1 0 .0.0.0> < ms -dns2 0 .0.0.0>] 请求 地址 rcv d [IPCP ConfN ak i d=0x1 < ms-dns2 202 .103 .225 .68 >] 发送 [IPCP ConfReq i d=0x2 < ms-dns2 202 .103 .225 .68 >] IPCP 控制 协议 主要 是负 责完 成IP网络 层 协议 通信 所 需配 置参 数的 选 项协 商 的 。 IPCP 在运 行的 过程 当中 ，主要 是 完 成点 对点 通 信设 备的 两端 动 态的 协 商IP地址 。 整个 ppp链路 建立 成功 结束 local I P address 10.145.17.65 分配 本地IP 地址 primary DN S addres s 202.103.224.68 sec ondary D NS address 202.103.225.68 分配 DN S地址 Sc ri pt /etc /ppp/ip-up s tarted (pid 2615 ) Sc ri pt /etc /ppp/ip-up finished (pid 2615 ), status = 0x0 启动 IP 进程 进入联 网状态 图 27：PPP 脚本拨号具体流程 上海移远通信技术股份有限公司 32 / 33 EC2x&EG2x&EG9x&EM05 系列 PPP 应用指导 7 附录 术语缩写 表 2：术语缩写 缩写 APN CHAP DCD DNS DTR GPRS GSM IP IPCP LCP MCU MS PAP PDP PIN PPP RI TA TE UART (U)SIM 英文全称 中文全称 Access Point Name 接入点名称 Challenge Handshake Authentication Protocol 询问握手认证协议 Data Carrier Detection 数据载波检测 Domain Name Server 域名系统 Data Terminal Ready 数据终端就绪 General Packet Radio Service 通用分组无线业务 Global System of Mobile Communication 全球移动通信系统 Internet Protocol 网络协议 IP Control Protocol IP 控制协议 Link Control Protocol 链路控制协议 Micro Control Unit 微控制单元 Mobile Station 移动台 Password Authentication Protocol 密码认证协议 Packet Data Protocol 分组数据协议 Personal Identification Number 个人识别号码 Point-to-Point Protocol 点对点协议 Ring Indicator 振铃指示器 Terminal Adapter 终端适配器 Terminal Equipment 终端设备 Universal Asynchronous Receiver Transmitter 通用异步收发传输器 (Universal) Subscriber Identity Module （全球）用户识别卡 上海移远通信技术股份有限公司 33 / 33

LTE Standard(U)系列 摄像头应用指导 LTE Standard 模块系列 版本：1.4 日期：2023-08-25 状态：受控文件 LTE Standard(U)系列摄像头应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 13 LTE Standard(U)系列摄像头应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 13 LTE Standard(U)系列摄像头应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 日期 2021-06-03 2021-07-27 2021-08-17 2022-09-07 1.3 2023-05-10 1.4 2023-08-25 作者 Evan MENG Evan MENG Evan MENG Evan MENG Sum LI Sum LI 变更表述 文档创建 受控版本 增加适用模块 EG915U 系列。 增加适用模块 EC600G-CN 和 EC800G-CN。 1. 更新 EC600G-CN 模块为 EC600G 系列。 2. 增加适用模块 EG700G-CN、EG800G 系列 和 EG912U-GL。 3. 增加解码结果 URC 中参数的取值 （第 2.3.2.1 章）。 更新 AT+QCAMOPEN 命令（第 2.3.1 章）。 上海移远通信技术股份有限公司 3 / 13 LTE Standard(U)系列摄像头应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 2 摄像头 AT 命令详解 ............................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句...................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. AT 命令详解................................................................................................................................. 8 2.3.1. AT+QCAMOPEN 打开摄像头功能................................................................................. 8 2.3.2. AT+QCAMIDFY 开始/停止解码 ..................................................................................... 9 2.3.2.1. 解码结果 URC ....................................................................................................... 9 2.3.3. AT+QCAMCLOSE 关闭摄像头功能............................................................................. 10 2.3.4. AT+QCAMAPPVER 读取解码库版本信息 ................................................................... 11 2.3.5. AT+QAUTHCODE 解码库授权码信息读写.................................................................. 11 3 错误码 .................................................................................................................................................. 13 上海移远通信技术股份有限公司 4 / 13 LTE Standard(U)系列摄像头应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型........................................................................................................................................ 7 表 3：错误码描述 ....................................................................................................................................... 13 上海移远通信技术股份有限公司 5 / 13 LTE Standard(U)系列摄像头应用指导 1 引言 本文档主要介绍移远通信 LTE Standard(U)系列模块摄像头功能相关 AT 命令及参数详解。 1.1. 适用模块 表 1：适用模块 模块系列 LTE Standard(U) 模块 EC600G 系列 EC800G-CN EC200U 系列 EC600U 系列 EG500U-CN EG700U-CN EG700G-CN EG800G 系列 EG912U-GL EG915U 系列 备注 EG700G-CN 模块的摄像头为可选功能，详情请联系移远技术支持。 上海移远通信技术股份有限公司 6 / 13 LTE Standard(U)系列摄像头应用指导 2 摄像头 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应命令，并返回有关其参数的类 型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 13 LTE Standard(U)系列摄像头应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QCAMOPEN 打开摄像头功能 AT+QCAMOPEN 打开摄像头功能 测试命令 AT+QCAMOPEN=? 响应 +QCAMOPEN: (支持的范围),(支持的范围) 设置命令 AT+QCAMOPEN=,[,, ] 最大响应时间 特性说明 OK 响应 OK 若错误与 ME 功能相关： +CME ERROR: 500 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。图像高度。范围：50~480；单位：像素。 整型。图像宽度。范围：50~640；单位：像素。 整型。摄像头的接口类型。配置该参数时，前面需要携带一个空参数。 0 MIPI 1 SPI 整型。错误码。详情请参考第 3 章。 备注 1. 如果没有识别到摄像头，该命令将返回错误码 7300。 2. 若模块所有功能都支持，则分配给摄像头的空间将受限，此时摄像头所支持的图像高度范围为 50~240，宽度范围为 50~320。 上海移远通信技术股份有限公司 8 / 13 LTE Standard(U)系列摄像头应用指导 2.3.2. AT+QCAMIDFY 开始/停止解码 AT+QCAMIDFY 开始/停止解码 测试命令 AT+QCAMIDFY=? 响应 +QCAMIDFY: (支持的列表),(支持的范围) 设置命令 AT+QCAMIDFY=[,] OK 响应 OK 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。开始或停止解码。 0 停止解码 1 开始解码 整型。设置解码的次数；解码次数达到设置值就会停止解码。范围：0~255；默认 值：0（表示一直进行解码）。 整型。错误码。详情请参考第 3 章。 2.3.2.1. 解码结果 URC 解码结果 URC +QCAMPRES: ,,, 上报解码结果 参数 整型。解码结果。 0 成功 1 无解码库 其他 失败 整型。解析的一维码或者二维码类型。不同的解码库输出的解码类型不同。 0 CODE39（一维码） 上海移远通信技术股份有限公司 9 / 13 LTE Standard(U)系列摄像头应用指导 1 CODE128（一维码） 2 CODE_QR（二维码） 0xff 代表未知类型 整型。解码结果数据的长度。单位：字节。 解码数据。输出结果与解码库有关。 举例 AT+QCAMOPEN=480,640 OK AT+QCAMIDFY=1 OK +QCAMPRES: 0,1,6,456789 2.3.3. AT+QCAMCLOSE 关闭摄像头功能 AT+QCAMCLOSE 关闭摄像头功能 测试命令 响应 AT+QCAMCLOSE=? 执行命令 OK 响应 AT+QCAMCLOSE OK 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 举例 AT+QCAMOPEN=240,320 OK AT+QCAMIDFY=1 OK +QCAMPRES: 0,1,6,456789 AT+QCAMCLOSE OK 上海移远通信技术股份有限公司 10 / 13 LTE Standard(U)系列摄像头应用指导 2.3.4. AT+QCAMAPPVER 读取解码库版本信息 AT+QCAMAPPVER 读取解码库版本信息 测试命令 响应 AT+QCAMAPPVER=? OK 执行命令 响应 AT+QCAMAPPVER +QCAMAPPVER: 最大响应时间 特性说明 OK 300 毫秒 该命令立即生效； 参数配置不保存。 参数 解码库的版本信息。 2.3.5. AT+QAUTHCODE 解码库授权码信息读写 该命令用于写入和读取解码库的授权码信息。在运行解码库时，解码库会读取授权码信息进行校验， 校验通过，才会输出完整的解码结果。 AT+QAUTHCODE 解码库授权码信息读写 测试命令 AT+QAUTHCODE=? 响应 +QAUTHCODE: ( 支 持 的 列 表 ),( 支 持 的 范 围), 设置命令 AT+QAUTHCODE=,[,] OK 响应 若=1 且省略，读取解码库授权码信息： +QAUTHCODE: OK 若=2 且指定，写入解码库授权码信息： +QAUTHCODE: OK 若错误与 ME 功能相关： 上海移远通信技术股份有限公司 11 / 13 LTE Standard(U)系列摄像头应用指导 +CME ERROR: 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。 1 读取授权码信息 2 写入授权码信息 整型。读取或写入授权码数据的长度。范围：0~108；单位：字节。 字符串类型。授权码信息。 整型。错误码。详情请参考第 3 章。 举例 AT+QAUTHCODE=2,20,'1234567890asdfghjk#l' +QAUTHCODE: '1234567890asdfghjk#l' OK AT+QAUTHCODE=1,20 +QAUTHCODE: '1234567890asdfghjk#l' OK 上海移远通信技术股份有限公司 12 / 13 3 错误码 表 3：错误码描述 7100 7200 7300 7400 描述 未知错误 参数错误 初始化错误 解码错误 LTE Standard(U)系列摄像头应用指导 上海移远通信技术股份有限公司 13 / 13

EG06xK&Ex120K&EM060K 系列 软件热管理指导 LTE-A 模块系列 版本：1.0 日期：2023-03-28 状态：受控文件 EG06xK&Ex120K&EM060K 系列软件热管理指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 文档历史 修订记录 版本 1.0 日期 2021-06-10 2023-03-28 作者 Zilean CHEN Aydan DING 变更表述 文档创建 受控文件 上海移远通信技术股份有限公司 3 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 2 AT 命令详解 ........................................................................................................................................... 7 2.1. AT 命令语句................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句...................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. AT+QTEMP 获取温度值 ........................................................................................................... 8 2.4. AT+QCFG='thermal/modem' 设置 PA 热管理等级.................................................................. 9 2.5. AT+QCFG='thermal/mdm' 设置 MDM 热管理机制................................................................ 10 3 软件热管理机制 .................................................................................................................................... 12 3.1. PA 热管理机制........................................................................................................................... 12 3.1.1. 限制上行数据传输速率 ................................................................................................... 12 3.1.2. 限制传输功率.................................................................................................................. 13 3.2. MDM 热管理机制....................................................................................................................... 15 3.2.1. 限制下行数据传输速率 ................................................................................................... 15 3.2.2. 进入限制服务模式 .......................................................................................................... 15 3.3. 模块重启 .................................................................................................................................... 15 4 附录 术语缩写...................................................................................................................................... 16 上海移远通信技术股份有限公司 4 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令及响应类型............................................................................................................................. 7 表 3：软件热管理机制 ................................................................................................................................ 12 表 4：上行数据传输限制目标速率等级 ...................................................................................................... 12 表 5：传输功率回退信息 ............................................................................................................................ 14 表 6：术语缩写 ........................................................................................................................................... 16 上海移远通信技术股份有限公司 5 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 1 引言 本文档主要介绍了移远通信 LTE-A 模块 EG060K 系列、EG065K 系列、EG120K 系列、EM120K-GL 和 EM060K 系列模块的软件热管理机制及相关的 AT 命令。当温度满足指定条件时，即可通过对应的软件 热管理机制对模块进行冷却降温。 1.1. 适用模块 表 1：适用模块 模块系列 EG06xK Ex120K - 模块 EG060K 系列 EG065K 系列 EG120K 系列 EM120K-GL EM060K 系列 上海移远通信技术股份有限公司 6 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 2 AT 命令详解 2.1. AT 命令语句 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QTEMP 获取温度值 该命令用于查询模块的温度值。 AT+QTEMP 获取温度值 测试命令 AT+QTEMP=? 执行命令 AT+QTEMP 最大响应时间 特性说明 响应 OK 响应 +QTEMP:, … OK 300 毫秒 / 参数 字符串类型。传感器类型。 'aoss-0-usr' 'q6-usr' 常开子系统单元 DSP 处理器 'ipa-usr' 'cpuss-usr' IP 加速器单元 ARM 处理器 'mdm-usr', Modem 处理器核 'xo-therm-usr', XO 'case-therm-usr' BB 芯片 'pa-therm1-usr' PA 1 'pa-therm2-usr' PA 2 整型。温度值。单位：ºC。 备注 EG065K 系列模块无传感器'pa-therm2-usr'。 上海移远通信技术股份有限公司 8 / 16 举例 AT+QTEMP +QTEMP: 'aoss-0-usr',33 +QTEMP: 'q6-usr',34 +QTEMP: 'ipa-usr',34 +QTEMP: 'cpuss-usr',34 +QTEMP: 'mdm-usr',34 +QTEMP: 'xo-therm-usr',32 +QTEMP: 'case-therm-usr',32 +QTEMP: 'pa-therm1-usr',31 +QTEMP: 'pa-therm2-usr',32 OK EG06xK&Ex120K&EM060K 系列软件热管理指导 2.4. AT+QCFG='thermal/modem' 设置 PA 热管理等级 该命令用于查询和配置 PA 热管理机制（包括限制上行数据传输速率和限制传输功率）的温度阈值。 AT+QCFG='thermal/modem' 设置 PA 热管理机制 设置命令 AT+QCFG='thermal/modem'[,, ,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'thermal/modem',1,, +QCFG: 'thermal/modem',2,, OK 若指定可选参数，则设置软件热管理等级： OK 最大响应时间 若有任何错误： ERRORERROR 300 毫秒 上海移远通信技术股份有限公司 9 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 特性说明 该命令重启后生效； 参数配置自动保存。 参数 整型。PA 软件热管理等级。每种等级对应一组和。 1 Level 1，表示降低上行数据传输速率（详见第 3.1.1 章） 2 Level 2，表示在 Level 1 的基础上，同步降低传输功率（详见第 3.1.2 章） 整型。触发温度阈值。当模块温度达到值时，将会触发对应等级（）的软件热 管理机制。推荐温度范围：0~115000；单位：0.001 ºC。 当=1，表示触发降低上行数据传输速率的温度阈值。默认值：100000。 当=2，表示触发降低 PA 功率的温度阈值。默认值：105000。默认值：105000。 整型。终止温度阈值。当温度下降到值时，对应等级（）的热管理机制将会 终止。推荐温度范围：0~115000；单位：0.001 ºC。 当=1，表示终止降低上行数据传输速率的温度阈值。默 认值：95000。 当=2，表示终止降低传输功率的温度阈值。默认值：100000。 举例 AT+QCFG='thermal/modem' +QCFG: 'thermal/modem',1,100000,95000 +QCFG: 'thermal/modem',2,105000,100000 OK //查询当前设置的温度阈值。 2.5. AT+QCFG='thermal/mdm' 设置 MDM 热管理等级 该命令用于查询和配置 MDM 热管理机制（包括限制下行数据传输速率和限制服务）的温度阈值。 AT+QCFG='thermal/mdm' 设置 MDM 的温升处理等级 设置命令 AT+QCFG='thermal/mdm'[,, ,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'thermal/mdm',1,, +QCFG: 'thermal/mdm',2,, OK 若指定可选参数，则设置软件热管理等级： OK 如有任何错误： 上海移远通信技术股份有限公司 10 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 最大响应时间 特性说明 ERROR 300 毫秒 该命令在模块重启后生效； 参数设置自动保存。 参数 整型。 MDM 的软件热管理等级。每种等级对应一组和。 1 Level 1，表示限制下行数据传输速率。（详见第 3.2.1 章） 2 Level 3，表示限制服务模式。该模式下，模块无法进行数据传输，只可以进行紧急电话 业务。（详见第 3.2.2 章） 整型。触发温度阈值。当模块温度达到值时，将会触发对应等级（）的软件热 管理机制。范围：0~120000；单位：0.001 ºC。 当=1，表示 Level 1 的温度阈值。默认值：100000。 当=2，表示进入限制服务模式的温度阈值。默认值：115000。 整型。终止温度阈值。当温度下降到值时，对应等级（）的热管理机制将会 终止。范围：0~120000；单位：0.001 ºC。 当=1，表示终止 Level 1 的温度阈值。默认值：95000。 当=2，表示终止限制服务模式的温度阈值。默认值：110000。 举例 AT+QCFG='thermal/mdm',2,105000,98000 OK AT+QCFG='thermal/mdm' +QCFG: 'thermal/mdm',1,100000,97000 //Level 3 通过限制服务模式的方式降低温度。若温度达 到 105 ºC 则模块会断网，只能拨打紧急电话；当温度 降至 98ºC 时，则恢复数据传输，从而终止 Level 3。 //查询 Modem 的热管理等级。 +QCFG: 'thermal/mdm',2,105000,98000 OK 上海移远通信技术股份有限公司 11 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 3 软件热管理机制 表 3：软件热管理机制 温升处理机制 PA MDM 温升处理等级 传感器 Level 1 pa-therm1-usr 限制上行数据 传输速率 mdm-usr 限制下行数据 传输速率 Level 2 限制 PA 传输 功率（MTPL） - Level 3 限制服务 3.1. PA 热管理机制 3.1.1. 限制上行数据传输速率 通过限制上行数据传输速率可减轻硬件（如 CPU、PA 等）的工作负载，以达到降温目的。但是，在模 块以低数据传输速率或无数据传输状态运行时，降温效果可能不明显。 通过执行 AT+QCFG='thermal/modem',1,,，模块可基于指定的温度阈值，在一定周期内 以不同的目标速率等级（target_rate[#]）限制上行数据传输速率。上行数据传输目标速率等级详情如下表 所示： 表 4：上行数据传输限制目标速率等级 目标速率等级 target_rate[0] target_rate[1] target_rate[2] target_rate[3] target_rate[4] target_rate[5] 最大上行数据传输速率 150 Mbps 100 Mbps 75 Mbps 50 Mbps 40 Mbps 25 Mbps 备注 检测周期：3 秒 目标速率等级数量（num_states）：13 个 默认等级（default_state）：target_rate[8] 上海移远通信技术股份有限公司 12 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 target_rate[6] target_rate[7] target_rate[8] target_rate[9] target_rate[10] target_rate[11] target_rate[12] 10 Mbps 5 Mbps 1 Mbps 1 Mbps 1 Mbps 1 Mbps 1 Mbps 备注 1. 上表所示的上行目标速率等级是模块启用软件热管理机制自动配置的默认值。实际测试时每个模块 表现可能不同，主要受模块自身的状态、散热、周围环境的影响。 2. 当在 CMW500 仪器进行测试时，必须使用非 PLMN 为 001-01 的 SIM 卡，软件热管理机制才能生 效。 以 AT+QCFG='thermal/modem',1,100000,95000 为例（触发温度阈值为 100 °C，终止温度阈值为 95 °C），热管理机制如下： 1. 模块传感器'pa-therm1-usr'温度升至 100 ºC（触发温度阈值）。 2. 模 块 进 入 Level 1 并 自 动 将 上 行 数 据 传 输 速 率 限 制 在 1 Mbps （ 即 默 认 目 标 速 率 等 级 target_rate[8]）。 3. 经过一个 3 秒的周期后，若温度降至 95 °C（终止温度阈值）以下，则终止上行数据传输速率限制。 若温度仍然高于 95 °C，限制目标速率将维持在 1 Mbps（目标速率等级升至 target_rate[9]）。 4. 模块每 3 秒检测一次温度，若温度持续高于 95 °C，目标速率等级会逐级增加，直到达到 target_rate[12]。目标速率将保持在 1 Mbps，直到温度降至 95 °C 以下后，传输速率将逐级恢复 至 150 Mbps（target_rate[0]）。 3.1.2. 限制传输功率 通过限制传输功率可以降低 PA 的工作负载。但是，实网下传输功率由网络配置，在信号不太差的情况 下，传输功率一般不高，通过限制传输功率进行降温的效果并不明显；另外，当实际传输功率受限，且低 于网络配置的传输功率时，可能会造成网络无法接收模块发送的信号或信号解码失败，进而导致数传性能 下降。 通过执行 AT+QCFG='thermal/modem',2,,，模块可基于设置的温度阈值，在一定周期内 根据特定功率回退值对功率进行限制。传输功率回退参数信息如下表所示： 上海移远通信技术股份有限公司 13 / 16 表 5：传输功率回退信息 参数类别 基准功率回退 最大功率回退 非回退持续时间 回退持续时间 回退持续周期 参数名称 P_backoff Max_backoff T_up T_down Step_timer EG06xK&Ex120K&EM060K 系列软件热管理指导 参数值 5 dBm 13 dBm 50 毫秒 50 毫秒 15 秒 备注 功率回退依次为：5 dBm、10 dBm、13 dBm、13 dBm、13 dBm、…… 以正常功率为 21 dBm 为例，触发后功 率依次为：16 dBm、11 dBm、8 dBm、 8 dBm、8 dBm、…… 图 1：功率回退示意图 以 AT+QCFG='thermal/modem',2,105000,100000（触发温度阈值为 105 °C，终止温度阈值为 100 °C）及正常功率为 21 dBm 为例，热管理机制将按如下描述执行： 1. 模块传感器'pa-therm1-usr'温度升至 105 ºC（触发温度阈值）。 2. 模块进入 Level 2、启动并保持 5 dBm 的功率回退（即传输功率降至 16 dBm）50 毫秒（T_up）； 之后恢复至 21 dBm，持续 50 毫秒（T_down）；之后再降低至 16 dBm，持续 50 毫秒；如此往复， 持续 15 秒，即为一个功率回退周期（Step_timer）。 3. 经过一个 15 秒的周期后，若温度降至 100 °C（终止温度阈值）以下，则终止传输功率限制；若 温度仍然高于 100 °C，功率回退值将升至 10 dBm，传输功率按 50 毫秒间隔在 21 dBm 和 11 dBm 交替。 4. 10 dBm 的功率回退持续 15 秒，之后若温度降至 100 °C 以下，则终止传输功率限制；若温度仍然 高于 100 °C，功率回退值将升至 13 dBm。 5. 13 dBm 的功率回退持续 15 秒，之后若温度降至 100 °C 以下，则终止传输功率限制；若温度仍高 于 100 °C，功率回退值将会一直保持为 13 dBm，直到温度降至 100 °C 以下后终止传输功率限制。 上海移远通信技术股份有限公司 14 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 备注 当温升处理机制进入 Level 2 时，Level 1 仍然有效。 3.2. MDM 热管理机制 3.2.1. 限制下行数据传输速率 当传感器'mdm-usr'温度升至触发温度阈值 100 ºC 时，模块会触发限制下行数据传输速率的机制，通 过减少 SCC、降低射频功耗来降低温度。温度降至终止温度阈值 95 ºC 以下时，退出该机制。 此热管理机制说明如下： ⚫ 模块接收天线从 4RX 模式回退至 2RX 模式。 ⚫ 模块向网络上报一个 CQI 0（表示下线辅小区）。 备注 若模块的接收天线配置为 2RX，则触发该机制时不再回退接收天线数量。 3.2.2. 进入限制服务模式 当传感器'mdm-usr'温度升至触发温度阈值 115 ºC 时，模块会进入限制服务模式，停止除紧急电话之 外的所有服务，以保护硬件，避免高温损坏。温度降至终止温度阈值 105 ºC 以下时，退出限制服务模式。 3.3. 模块重启 当模块温度达到 120 ºC 时，模块将自动重启以保护硬件。 该机制无法手动关闭，也不可手动更改温度配置。 上海移远通信技术股份有限公司 15 / 16 EG06xK&Ex120K&EM060K 系列软件热管理指导 4 附录 术语缩写 表 6：术语缩写 缩写 ARM BB CA CC CPU DSP IP MDM MTPL PA RX TA XO 英文全称 Advanced RISC Machine Baseband Carrier Aggregation Component Carrier Central Processing Unit Digital Signal Processor Internet Protocol Modem Maximum Transmit Power Limit Power Amplifier Receive Terminal Adapter Crystal Oscillator 中文全称 RISC 微处理器 基带 载波聚合 分量载波 中央处理器 数字信号处理器 网际互连协议 调制解调器 最大传输功率限制 功率放大器 接收 终端适配器 晶体振荡器 上海移远通信技术股份有限公司 16 / 16

LG69T (AA,AD,AF,AI,AJ,AM,AP,AR) AGNSS 应用指导 GNSS 模块系列 版本：1.0 日期：2024-04-19 状态：受控文件 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 LG69T (AA,AD,AF,AI,AJ,AM,AP,AR) AGNSS 应用指导 GNSS 模块系列 应用指导 受控版本 修订历史 版本 1.0 日期 2024-02-23 2024-04-19 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 目录 关于文档 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 AGNSS 相关消息 .................................................................................................................................. 8 2.1. PSTM 消息 ................................................................................................................................. 8 2.1.1. $PSTMINITGPS .............................................................................................................. 8 2.1.2. $PSTMINITTIME ........................................................................................................... 10 2.1.3. $PSTMEPHEM ..............................................................................................................11 2.2. RTCM 消息............................................................................................................................... 19 2.2.1. RTCM 协议消息结构 ..................................................................................................... 19 2.2.2. INITTIME ....................................................................................................................... 20 2.2.3. Ephemeris ..................................................................................................................... 20 3 AGNSS 功能测试流程......................................................................................................................... 22 3.1. 使用 NMEA 消息的测试流程 .................................................................................................... 22 3.1.1. 测试条件 ........................................................................................................................ 22 3.1.2. 通过发送 NMEA 命令测试 AGNSS 功能的流程 ............................................................ 23 3.1.3. 使用 QGNSS 工具测试 AGNSS 功能的简化流程.......................................................... 24 3.1.4. 测试结果 ........................................................................................................................ 25 3.2. 使用 RTCM 消息的测试流程 .................................................................................................... 25 3.2.1. 测试流程 ........................................................................................................................ 26 3.2.2. 测试结果 ........................................................................................................................ 27 4 附录 A 参考文档及术语缩写............................................................................................................... 28 5 附录 B 特殊字符 ................................................................................................................................. 30 上海移远通信技术股份有限公司 4 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 表格索引 表 1：GPS 星历数据格式 ............................................................................................................................11 表 2：GLONASS 星历数据格式 ................................................................................................................. 13 表 3：Galileo 星历数据格式 ....................................................................................................................... 15 表 4：BDS 星历数据格式 ........................................................................................................................... 17 表 5：支持的标准 RTCM 星历消息 ............................................................................................................ 21 表 6：参考文档 ........................................................................................................................................... 28 表 7：术语缩写 ........................................................................................................................................... 28 表 8：特殊字符 ........................................................................................................................................... 30 上海移远通信技术股份有限公司 5 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 图片索引 图 1：RTCM 协议消息的结构..................................................................................................................... 19 图 2：通过 QGNSS 工具简化的测试流程 .................................................................................................. 24 图 3：通过 QGNSS 工具测试 AGNSS 功能的日志.................................................................................... 25 上海移远通信技术股份有限公司 6 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 1 引言 LG69T (AA, AD, AF, AI, AJ, AM, AP, AR) GNSS 模块支持 AGNSS 功能，可显著降低模块的 TTFF，特 别是在信号不佳的应用场景中。相较于从天空中的卫星信号中获取星历和粗略时间等数据，AGNSS 功能可 使用外部数据源，从而使 GNSS 接收机能够在更短的时间内获取相关信息。基于此，GNSS 接收机能更少 的依赖信号接收质量来获取数据。除星历和时间信息外，AGNSS 功能还可以将粗略位置信息传递给模块， 从而进一步降低 GNSS 接收机的定位时间。 本文档介绍了不同工作场景下 AGNSS 测试流程以及 AGNSS 功能相关的 NMEA 和 RTCM 消息。 AGNSS 的性能需依靠可用网络来下载辅助数据，数据包括： ⚫ 当前时间 ⚫ 粗略位置（可选） ⚫ 星历 备注 1. 在信号覆盖范围较小或无信号的环境中，AGNSS功能会受到影响。 2. AGNSS功能需要以GPS时间格式输入时间，请使用相关网络应用程序确定当前GPS时间或将UTC 时间转换为GPS时间。二者间的换算：GPS时间 = UTC时间 + 闰秒。 上海移远通信技术股份有限公司 7 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 2 AGNSS 相关消息 LG69T (AA, AD, AF, AI, AJ, AM, AP, AR)模块，可以通过芯片供应商定义的 PSTM 消息（NMEA 专有 消息）和 RTCM 消息来实现和配置 AGNSS 功能。不同模块支持的消息类型如下： ⚫ LG69T (AD, AF)：支持通过 PSTM 消息配置 AGNSS 功能。 ⚫ LG69T (AA, AD, AI, AJ, AM, AP, AR)：支持通过 RTCM 消息配置 AGNSS 功能。 2.1. PSTM 消息 2.1.1. $PSTMINITGPS 以 UTC 格式初始化 GNSS 接收机的 GPS 位置和时间。该命令必须在冷启动后发出，否则 AGNSS 初 始化将失败。使用、和参数设置的日期必须为当前的日/月/年。 类型： 输入 格式： $PSTMINITGPS,,,,,,,,,,, * 参数： 字段 格式 ddmm.mmm 字符 单位 - 描述 纬度。 dd：度（00~90） mm：分（00~59） mmm：分的十进制小数 纬度方向。 N= 北 S= 南 上海移远通信技术股份有限公司 8 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 字段 格式 dddmm.mmm 字符 十进制 dd mm yyyy hh mm ss 单位 - 米 - 描述 经度。 dd：度（000~180） mm：分（00~59） mmm：分的十进制小数 经度方向。 E= 西 W= 东 海拔高度。范围：-1500~99999。 日，范围：01~31。 月，范围：01~12。 年，最小值：2015。 时，范围：00~23。 分，范围：00~59。 秒，范围：00~59。 结果： ⚫ 如果成功，则模块返回： $PSTMINITGPSOK* ⚫ 如果失败，则模块返回 $PSTMINITGPSERROR* 示例： $PSTMINITGPS,3149.121,N,11707.883,E,0530,05,08,2022,09,44,12*5E $PSTMINITGPSOK*40 备注 1. 输入的GPS时间与当前GPS时间的偏差应小于3秒。 GPS时间 = UTC时间 + 闰秒。例如，2024年，闰秒 = 18秒。 2. 输入位置与实际位置的偏差应小于30公里。 上海移远通信技术股份有限公司 9 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 2.1.2. $PSTMINITTIME 以 UTC 格式初始化 GNSS 接收机的 GPS 时间。使用、和参数设置的日期必 须为当前的日/月/年。 类型： 输入 格式： $PSTMINITTIME,,,,,,* 参数： 字段 格式 dd mm yyyy hh mm ss 单位 - 描述 日，范围：01~31。 月，范围：01~12。 年，最小值：2015。 时，范围：00~23。 分，范围：00~59。 秒，范围：00~59。 结果： ⚫ 如果成功，则模块返回： $PSTMINITTIMEOK* ⚫ 如果失败，则模块返回： $PSTMINITTIMEERROR* 示例： $PSTMINITTIME,05,08,2022,09,44,12*10 $PSTMINITTIMEOK*11 上海移远通信技术股份有限公司 10 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 备注 输入的GPS时间与当前GPS时间的偏差应小于3秒。 GPS时间 = UTC时间 + 闰秒。例如，2024年，闰秒 = 18秒。 2.1.3. $PSTMEPHEM 将星历数据加载到备份内存中。 类型： 输入 格式： $PSTMEPHEM,,,* 参数： 字段 格式 十进制 十进制 十六进制 单位 - 描述 卫星 ID。 星历数据字节数。 星历数据。 星历数据是包含所有星历信息的结构转储。星历数据格式取决于星系。详细信息请参考下表。 表 1：GPS 星历数据格式 位 结构成员 16 week 16 toe 16 toc 8 iode1 8 iode2 10 iodc 描述 数据发布的周数。 星历纪元的星期时间。 时钟纪元的星期时间。 发布的数据 1。 发布的数据 2。 发布的数据时钟。 上海移远通信技术股份有限公司 11 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 位 结构成员 描述 14 i_dot 倾斜角速率。 8 reserved - 24 omega_dot 赤经率。 8 reserved 必须为 0。 16 crs 轨道半径正弦谐波校正幅度。 16 crc 轨道半径余弦谐波校正幅度。 16 cus 对纬度参数正弦谐波校正幅度。 16 cuc 对纬度参数余弦谐波校正幅度。 16 cis 对倾角正弦谐波校正幅度。 16 cic 对倾角余弦谐波校正幅度。 16 motion_difference 与计算值的平均运动差。 16 reserved 必须为 0。 32 inclination 参考时间的轨道倾斜角。 32 e 离心率。 32 root_A 长半轴的平方根。 32 mean_anomaly 参考时间的平均偏离角度。 32 omega_zero 周历元轨道平面升交点的经度。 32 perigee 近地点幅角。 8 time_group_delay 预估的整体延迟偏差。 8 af2 二阶时钟校正。 16 af1 一阶时钟校正。 22 af0 恒定时钟校正。 1 reserved 预留供 GNSS 库使用 — 必须为 1。 1 reserved 预留供 GNSS 库使用 — 必须为 1。 1 reserved 预留供 GNSS 库使用 — 必须为 1。 上海移远通信技术股份有限公司 12 / 30 位 结构成员 1 available 1 health 1 reserved 4 accuracy LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 描述 星历表是否可用。 0 = 不可用 1 = 可用 卫星健康状态。 0 = 健康 1 = 不健康 必须为 0。 准确性。 表 2：GLONASS 星历数据格式 位 结构成员 16 week 16 toe 4 toe_lsb 11 NA 7 tb 2 M 2 P1 1 P3 1 P2 1 P4 2 KP 描述 数据发布的周数。 星历纪元的星期时间。 星历纪元（LSB）的星期时间。 自上一个闰年（年历）开始以来的四年期日历天数。 时间星历索引。 卫星类型。 00 = GLONASS 01 = GLONASS-M 两个相邻 tb 参数之间的时间间隔。 此帧内传输年历的卫星数量。 0 = 4 颗卫星 1 = 5 颗卫星 tb 值的奇数（'1'）或偶数（'0'）标识。 显示星历参数存在的标识。 即将到来的 UTC 闰秒修正通知。 1 Reserved 27 xn 5 xn_dot_dot 24 xn_dot 卫星 PZ-90 在 tb 纪元的 X 坐标。 卫星 PZ-90 在 tb 纪元 X 坐标加速度分量。 卫星 PZ-90 在 tb 纪元 X 坐标速度分量。 上海移远通信技术股份有限公司 13 / 30 位 结构成员 5 n 3 Bn 27 yn 5 yn_dot_dot 24 yn_dot 8 age_h 27 zn 5 zn_dot_dot 24 zn_dot 8 reserved 11 gamma_n 5 E_n 4 freq_id 12 reversed 22 tau_n 10 reserved 32 tau_c 22 tau_gps 10 reserved 11 NT 5 N4 12 tk 4 FT 32 reserved 5 m_available LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 描述 槽位号（1~24）。 健康标识。 卫星 PZ-90 在 tb 纪元的 Y 坐标。 卫星 PZ-90 在 tb 纪元 Y 坐标加速度分量。 卫星 PZ-90 在 tb 纪元 Y 坐标速度分量。 预测星历的年龄（小时）。 卫星 PZ-90 在 tb 纪元的 Z 坐标。 卫星 PZ-90 在 tb 纪元 Z 坐标加速度分量。 卫星 PZ-90 在 tb 纪元 Z 坐标速度分量。 必须为 0。 tb 历元卫星时钟频率漂移。 星历信息时代。 频率 ID。 tb 历元卫星时钟校正。 必须为 0。 GLONASS 转化为 UTC（SU）时间校正。 GLONASS 转化为 GPS 系统时间校正。 自上一次闰年开始以来四年期星历表日历天数。 从 1996 年开始的四年期编号。 卫星时间参考帧的开头。 时间 tb 时预测的卫星用户范围精度。 必须为 0x1F。 上海移远通信技术股份有限公司 14 / 30 位 结构成员 1 nvm_reliable 26 spare 25 reserved 1 available 1 health 1 reserved 4 reserved LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 描述 必须为 1。 - 星历表是否可用。 0 = 不可用 1 = 可用 卫星是否健康。 0 = 健康 1 = 不健康 必须为 0。 - 表 3：Galileo 星历数据格式 位 结构成员 16 week 16 toe 2 reserved 16 toc 10 iod_nav 8 SISA 10 reserved 10 BGD_E1_E5a 10 BGD_E1_E5b 2 E1BHS 32 inclination 32 eccentricity 32 root_a 描述 数据发布的周数。 星历纪元的星期时间。 时钟纪元的星期时间。 数据发布。 空间信号精度。 必须为 0。 E1-E5a 广播组延时。 E1-E5b 广播组延时。 E1-B 信号健康状态。 参考时间的倾斜角。 离心率。 长半轴的平方根。 上海移远通信技术股份有限公司 15 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 位 结构成员 描述 32 mean_anomaly 参考时间的平均偏离角度。 32 omega_zero 周历元轨道平面升交点的经度。 32 perigee 近地点幅角。 14 i_dot 倾角速率。 1 available 1 health 星历表是否可用。 0 = 不可用 1 = 可用 卫星是否健康。 0 = 健康 1 = 不健康 16 motion_difference 与计算值的平均运动差。 16 crs 轨道半径正弦谐波修正幅度。 16 crc 轨道半径余弦谐波校正幅度。 16 cus 对纬度参数正弦谐波校正幅度。 16 cuc 对纬度参数余弦谐波校正幅度。 16 cis 对倾角正弦谐波校正幅度。 16 cic 对倾角余弦谐波校正幅度。 24 omega_dot 赤经率。 6 SVID 空间飞行器标识。 1 E1BDVS E1-B 数据有效性状态。 1 reserved 必须为 0。 8 reserved 必须为 0。 16 reserved 必须为 0。 6 af2 二阶时钟校正。 21 af1 一阶时钟校正。 5 word_available 必须为 0x1F。 31 af0 恒定时钟校正。 上海移远通信技术股份有限公司 16 / 30 位 结构成员 1 reserved 6 reserved 26 reserved 1 reserved LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 描述 必须为 0。 预留供 GNSS 库使用 — 必须为 1。 必须为 0。 表 4：BDS 星历数据格式 位 结构成员 描述 32 inclination 参考时间的倾斜角。 32 eccentricity 离心率。 32 root_a 长半轴的平方根。 32 mean_anomaly 参考时间的平均偏离角度。 32 omega_zero 周历元轨道平面升交点的经度。 32 perigee 近地点幅角。 17 toe 星历纪元的星期时间。 10 time_group_delay 预估的整体延迟偏差。 5 aode 星历数据龄期。 24 omega_dot 赤经率。 8 A0 电离层延迟模型参数 α0。 24 af0 持续时钟校正。 8 A1 电离层延迟模型参数 α1。 20 sow 周内秒 11 af2 二阶时钟校正。 1 is_geo 对地静止卫星为 1，否则为 0。 22 af1 一阶时钟校正。 10 subframe_avail 必须为 0x3FF。 上海移远通信技术股份有限公司 17 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 位 结构成员 描述 16 motion_difference 与计算值的平均运动差。 8 A2 电离层延迟模型参数 α2。 8 A3 18 crs 电离层延迟模型参数 α3。 正弦谐波对轨道半径的修正幅度。 8 B2 电离层延迟模型参数 β2。 4 urai 用户距离精度指标。 2 reserved 18 crc 必须为 0。 余弦谐波对轨道半径的修正幅度。 8 B3 电离层延迟模型参数 β3。 5 aodc 发布数据，时钟。 1 spare - 18 cus 正弦谐波对纬度参数的修正幅度。 14 i_dot 倾斜角速率。 18 cuc 8 B0 对纬度参数的余弦谐波校正的振幅。 电离层延迟模型参数 β0。 6 spare - 18 cis 正弦谐波对倾斜角的修正幅度。 8 B1 电离层延迟模型参数 β1。 6 reserved 必须为 0。 18 cic 对倾斜角进行余弦谐波校正的振幅。 1 nvm_reliable 必须为 1。 11 reserved 必须为 0。 2 spare - 17 toc 时钟纪元的星期时间。 13 week 数据发布的周数。 上海移远通信技术股份有限公司 18 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 位 结构成员 1 available 1 health 描述 星历表是否可用。 0 = 不可用 1 = 可用 卫星是否健康。 0 = 健康 1 = 不健康 示例： $PSTMEPHEM,12,64,0f06bc34bc3437373790f40045a7ff00fcf5d522480b4bf71b00fbff893100009612 6f271f869101c3870ca107afce79a763e13e360a1ce8e7003100380ff903*36 备注 1. AGNSS不支持北斗GEO卫星星历信息注入。 2. 为了获得更好的性能，建议首先注入GPS星历信息。 3. 不建议单独注入伽利略卫星信息。 2.2. RTCM 消息 2.2.1. RTCM 协议消息结构 8位, 固定为 11010011 6位, 固定为 000000 10位 可变大小 24位 前导码 预留 长度 数据内容 校验和计算的范围 图 1：RTCM 协议消息结构 校验 上海移远通信技术股份有限公司 19 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 2.2.2. INITTIME 使用 UTC 格式初始化 GPS 时间。 数据名称 Message Number Subtype ID Response ID Day Month Year Hour Minute Second DF DF002 DF02P DF53P - 类型 uint12 uint8 uint10 uint5 uint4 uint12 uint5 uint6 uint6 备注 999（私有协议专用消息号）。 子消息类型 ID = 12。INITTIME。 响应 ID 用于识别请求响应的输入消息。 日，范围：01~31。 月，范围：01~12。 年，最小值：2015 年。 时，范围：00~23。 分，范围：00~59。 秒，范围：00~59。 结果： ⚫ LG69T (AA, AD, AI, AJ, AR)：模块返回 RESP 消息，详情请参考文档 [1] protocol specification。 ⚫ LG69T (AM, AP)：模块无响应消息。 备注 输入的GPS时间与当前GPS时间的偏差应小于3秒。 GPS时间 = UTC时间 + 闰秒。例如，2024年，闰秒 = 18秒。 2.2.3. Ephemeris 下表列出了 AGNSS 支持的 RTCM 消息。如需了解更多信息，请参考 RTCM Standard 10403.3 Differential GNSS (Global Navigation Satellite Systems) Services - Version 3 协议。该协议用于传输 GNSS 原始测量数据，可从 https://www.rtcm.org/获取。 上海移远通信技术股份有限公司 20 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 表 5：支持的标准 RTCM 星历消息 消息类型 1019 1020 1042 1044 1046 模式 输入/输出 输入/输出 输入/输出 输入/输出 输入/输出 消息名称 GPS 星历数据 GLONASS 星历数据 BDS 卫星星历数据 QZSS 星历数据 Galileo I/NAV 星历数据 备注 仅LG69T (AI)支持1020消息。 上海移远通信技术股份有限公司 21 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 3 AGNSS 功能测试流程 本章节主要介绍如何使用 NMEA 和 RTCM 消息测试 AGNSS 功能。 3.1. 使用 NMEA 消息的测试流程 冷启动测试流程如下。本流程仅适用于 LG69T (AD, AF)模块。 3.1.1. 测试条件 在测试 AGNSS 功能之前，请确保： 1. 将 LG69T (AD, AF) EVB 连接到计算机。 2. 下载 QGNSS 上位机软件工具，设置对应的端口号、波特率和模块型号。 3. 创建移远通信 AGNSS 服务器 1)账户，即可通过 QGNSS 工具连接 AGNSS 服务器。 为了凸显 AGNSS 功能对 TTFF 值的影响，可以先在不使用 AGNSS 功能的情况下获取定位；待本测 试流程结束后，可以将所得的 TTFF 结果和未使用 AGNSS 功能时获取的定位结果进行对比。 备注 1. 如需了解如何访问移远通信AGNSS服务器，请联系移远通信技术支持（support@quectel.com）。 2. 如需了解QGNSS工具的详细信息，请参考文档 [2] QGNSS user guide。 上海移远通信技术股份有限公司 22 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 3.1.2. 通过发送 NMEA 命令测试 AGNSS 功能的流程 通过发送 NMEA 命令在冷启动中测试 AGNSS 功能的步骤如下： 1. 从服务器下载辅助数据。 2. 发送$PSTMCOLD 至模块执行冷启动。详细内容请参考文档 [1] protocol specification 和[3] 协议 规范。 3. 发送$PSTMINITTIME 至模块以注入辅助时间。 4. 如果粗略位置信息可用，则可发送$PSTMINITGPS 命令来代替步骤 3 中的$PSTMINITTIME 来注 入辅助位置和辅助时间。此步骤为可选步骤。 5. 发送$PSTMEPHEM 至模块以注入每颗卫星的星历数据。 示例： //冷启动： $PSTMCOLD,15*36 等待 1000 毫秒 //注入时间： $PSTMINITTIME,15,06,2022,12,24,40*14 等待 500 毫秒 //注入星历： $PSTMEPHEM,1,64,a608964b964b34343458ef004ca4ff0078f5df2e8b01fdf62f00f1ff942d00006cb83f 281c0d260682520da17c9b130143906c5b593089250b00bbffcb2acb03*0A 等待 20 毫秒 //注入星历： $PSTMEPHEM,2,64,a608964b964b3d3d3d90f000489eff00fef59030dcff41f7bcff69ff64340000bac25a 276683720a77720da1a923d3071802af57b8b364c6da0003001e9dea03*58 等待 20 毫秒 …. //模块在第 9 秒定位：. $GNRMC,,V,,,,,,,,,,N,V*37 //第 1 秒 $GNRMC,052520.810,V,0000.000000,N,00000.000000,E,,,120822,,,N,V*10 //第 2 秒 $GNRMC,052521.000,V,0000.000000,N,00000.000000,E,,,120822,,,N,V*18 //第 3 秒 $GNRMC,052522.000,V,0000.000000,N,00000.000000,E,,,120822,,,N,V*1B //第 4 秒 $GNRMC,052523.000,V,0000.000000,N,00000.000000,E,,,120822,,,N,V*1A //第 5 秒 $GNRMC,052524.000,V,0000.000000,N,00000.000000,E,,,120822,,,N,V*1D //第 6 秒 $GNRMC,052525.000,V,0000.000000,N,00000.000000,E,,,120822,,,N,V*1C //第 7 秒 $GNRMC,052545.410,V,3149.325478,N,11706.980321,E,,,120822,,,N,V*1F //第 8 秒 $GNRMC,052545.990,A,3149.324898,N,11706.978994,E,0.026,0.00,120822,,,A,C*23 //第 9 秒 上海移远通信技术股份有限公司 23 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 备注 1. 为了获得良好的统计结果，可多次执行该测试流程。 2. 示例中展现的等待时间仅供参考。 3.1.3. 使用 QGNSS 工具测试 AGNSS 功能的简化流程 使用 QGNSS 测试 AGNSS 功能的步骤如下： 1. 运行 QGNSS 工具。 2. 在主界面点击'AGNSS'->'Assistant GNSS Online'，进入下载窗口。 3. 点击'Connect'按钮连接 FTP 服务器并选择星历文件。 4. 单击'Download selected file'按钮将星历文件下载至计算机。 5. 单击'Select file'按钮，选择下载到计算机上的星历文件，然后单击'Using UTC time'、'Use Current Position'、'Cold start'、'Position'和'AGNSS Data'。 6. 单击'Reset and Transfer'按钮将星历文件发送至模块。 图 2：使用 QGNSS 工具测试 AGNSS 功能的简化流程 上海移远通信技术股份有限公司 24 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 图 3：使用 QGNSS 工具测试 AGNSS 功能的日志 3.1.4. 测试结果 当 GNSS 引擎启动时，模块将尝试获取定位。 如果未启用 AGNSS 功能，模块会在冷启动后约 36 秒内获得定位（取决于信号接收质量）。如果启用 AGNSS 功能，模块将在大约 10 秒或更短的时间内获得定位（取决于信号接收质量）。 3.2. 使用 RTCM 消息的测试流程 冷启动中测试 AGNSS 功能流程如下。基于 RTCM 消息的星历数据需是二进制。为了便于理解，下面 的示例中使用了解析的十六进制数据。 本流程适用于 LG69T (AA, AD, AI, AJ, AM, AP, AR)模块。 上海移远通信技术股份有限公司 25 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 3.2.1. 测试流程 在冷启动中测试 AGNSS 功能： 1. 从服务器下载辅助数据。 2. 向模块发送冷启动命令（RESTART 或 PQTMCOLD）1），执行冷启动。有关 RESTART 和 PQTMCOLD 命令的详细信息，请参考文档 [1] protocol specification 和[3] 协议规范。 3. 向模块发送专有 RTCM 命令（INITTIME）以注入辅助时间。 4. 向模块发送标准 RTCM 命令（1019、1020、1042、1044、1046）以注入每个星座的星历数据。 示例： //冷启动： D3 00 07 3E 71 00 00 00 00 F0 47 9E EE 等待 1000 毫秒 //注入时间： D3 00 09 3E 70 C0 33 AE FC D0 00 00 23 56 F9 D3 00 06 3E 71 30 30 00 00 24 06 88 等待 500 毫秒 //注入星历： D3 00 3D 3F B3 4A C0 44 B6 35 72 42 00 00 40 2E E1 58 35 FD 7A 2B E8 34 06 A9 64 FD AB 03 2C 03 39 16 B4 A1 0D 76 21 72 42 FF D2 97 0B 44 09 FF F1 27 7C D6 E3 15 E9 25 6D 1B 10 FF AB 59 E8 02 14 23 B2 等待 15 毫秒 //注入星历： D3 00 3D 3F B0 8A C0 41 D5 09 72 41 00 00 08 AA BF 7C 09 08 6C 34 4C EC 68 E7 60 07 97 0A 39 53 AF 04 6F A1 16 F6 5B 72 41 FF 8B 38 FA 9D C2 00 19 27 5B C0 12 2B 3C C6 E6 30 0B FF A0 80 DB 02 F4 70 F5 等待 15 毫秒 …. 备注 1. 1）对于LG69T (AA, AD, AI, AJ, AR)，使用RESTART命令执行冷启动。对于LG69T (AM, AP)，使用 $PQTMCOLD命令执行冷启动。 2. 示例中展现的等待时间仅供参考。 上海移远通信技术股份有限公司 26 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 3.2.2. 测试结果 当 GNSS 引擎启动时，模块将尝试获取定位。 如果未启用 AGNSS 功能，模块会在冷启动后约 36 秒内获得定位（取决于信号接收质量）。如果启用 AGNSS 功能，模块将在大约 10 秒或更短的时间内获得定位（取决于信号接收质量）。 上海移远通信技术股份有限公司 27 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 4 附录 A 参考文档及术语缩写 表 6：参考文档 文件名称 [1] Quectel_LG69T(AA,AD,AF,AI,AJ,AR)_GNSS_Protocol_Specification [2] Quectel_QGNSS_User_Guide [3] Quectel_LG69T(AM,AP)_GNSS_协议规范 表 7：术语缩写 缩写 英文全称 中文全称 AGNSS BDS EVB Galileo GEO GLONASS GNSS GPS LSB I/NAV QZSS RTCM Assisted GNSS 辅助卫星导航 Beidou Navigation Satellite System 北斗卫星导航系统 Evaluation Board 评估板 Galileo Satellite Navigation System (EU) 伽利略卫星导航系统（欧盟） Geostationary Orbit Satellite 地球同步轨道卫星 Global Navigation Satellite System (Russia) 格洛纳斯卫星导航系统（俄罗斯） Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 Least Significant Bit 最低有效位 Integrity Navigation 完整的导航 Quasi-Zenith Satellite System 准天顶卫星系统（日本） Radio Technical Commission for Maritime 海事无线电技术委员会 Services 上海移远通信技术股份有限公司 28 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 缩写 TTFF UTC UTC (SU) 英文全称 中文全称 Time to First Fix 首次定位时间 Universal Time Coordinated 协调世界时间 Universal Time Coordinated of Russia UTC (SU) 俄罗斯协调世界时间 UTC (SU) 上海移远通信技术股份有限公司 29 / 30 LG69T(AA,AD,AF,AI,AJ,AM,AP,AR)AGNSS 应用指导 5 附录 B 特殊字符 表 8：特殊字符 特殊符号 [...] {…} Underline 描述 回车字符 换行字符 参数名称。尖括号不会出现在消息中。 消息的可选字段。方括号不会出现在消息中。 消息的重复字段。大括号不会出现在消息中。 参数的默认设置。 上海移远通信技术股份有限公司 30 / 30

EG060K&EG120K 系列 UAC 应用指导 LTE-A 模块系列 版本：1.0 日期：2023-01-05 状态：受控文件 EG060K&EG120K 系列 UAC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 EG060K&EG120K 系列 UAC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 15 EG060K&EG120K 系列 UAC 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2022-09-07 Shaun DUAN 文档创建 1.0 2023-01-05 Shaun DUAN 受控版本 上海移远通信技术股份有限公司 3 / 15 EG060K&EG120K 系列 UAC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. UAC 功能简介 ............................................................................................................................ 7 1.1.1. USB 声卡驱动.................................................................................................................. 7 1.1.2. PCM 数据转发和语音通话............................................................................................... 8 2 AT 命令详解 .......................................................................................................................................... 9 2.1. AT 命令语句................................................................................................................................ 9 2.1.1. 定义 ................................................................................................................................. 9 2.1.2. AT 命令语句..................................................................................................................... 9 2.2. AT 示例声明.............................................................................................................................. 10 2.3. AT+QCFG='usbcfg' 配置 USB 复合功能 .............................................................................. 10 2.4. AT+QPCMV 启用/禁用语音数据转发功能 ..............................................................................11 3 UAC 功能测试 ..................................................................................................................................... 13 3.1. 测试步骤 ................................................................................................................................... 13 3.2. 测试语音链路............................................................................................................................ 13 3.2.1. Windows 侧 ................................................................................................................... 13 3.2.2. Linux 侧 ......................................................................................................................... 14 4 附录 术语缩写..................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 EG060K&EG120K 系列 UAC 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 9 表 2：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 EG060K&EG120K 系列 UAC 应用指导 图片索引 图 1：语音数据流示意图 .............................................................................................................................. 7 图 2：加载 USB 声卡.................................................................................................................................... 8 图 3：选择声卡 ........................................................................................................................................... 13 图 4：工具 Audacity ................................................................................................................................... 14 上海移远通信技术股份有限公司 6 / 15 EG060K&EG120K 系列 UAC 应用指导 1 引言 本文档介绍移远通信 EG060K 和 EG120K 系列模块的 UAC 功能，包含 AT 命令、设计方案及功能测试。 1.1. UAC 功能简介 UAC（USB Audio Class 1.0）是 USB 规范中的音频协议类。该功能由三个部分组成，分别为 UAC 驱 动、PCM 数据转发和语音通话。在 UAC 模式下，模块被识别为主机设备中的 USB 声卡。标准的第三方音 频库（如 alsa-lib）可用于在 Linux 侧录制或者播放音频数据，某些第三方工具（如 Audacity）也可用于在 Windows 上录制或播放音频数据。 在语音呼叫状态下，模块通过空中接口获取语音数据。DSP 将数据解码为语音 PCM 流，然后通过 USB 总线将 PCM 流传输到主机设备。因此，主机设备中的音频应用可以通过 USB 声卡获得 PCM 数据，并传 输到扬声器。相反的，主机设备可以将通过麦克风获取的语音数据编码为 PCM 流，并播放到 USB 声卡中， 模块将 PCM 数据经过 DSP 编码后发送到空中接口。 主机 Windows/Linux 录制 播放 模块 UAC USB UAC 语音 转发 语音 服务 RF 手机 麦克 风 扬声 器 下行链路音频数据 上行链路音频数据 图 1：语音数据流示意图 1.1.1. USB 声卡驱动 UAC 功能的实现需要主机侧支持 UAC 驱动。移远通信不提供主机侧的 UAC 驱动，请自行开发。模块 开启 UAC 后，主机侧会自动加载 USB 声卡。一般情况下，Windows 10 系统包含 USB 声卡驱动，用户可 自行安装使用。 以 EG120K-EA 模块为例，Windows 侧显示如下： 上海移远通信技术股份有限公司 7 / 15 EG060K&EG120K 系列 UAC 应用指导 Linux 系统显示如下： 图 2：加载 USB 声卡 1.1.2. PCM 数据转发和语音通话 使能 UAC 功能后，模块在主机端会被识别为 USB 声卡设备，主机端可以使用 alsa-lib 等第三方库进行 音频数据的录音或者播放。基于 USB 驱动的语音通话，主机端可以捕获下行语音链路的音频数据或者播放 音频数据到上行语音链路，即可在主机端进行二次开发，在主机端上实现语音通话功能。 上海移远通信技术股份有限公司 8 / 15 EG060K&EG120K 系列 UAC 应用指导 2 AT 命令详解 2.1. AT 命令语句 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 15 EG060K&EG120K 系列 UAC 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QCFG='usbcfg' 配置 USB 复合功能 该命令用于配置模块的 USB 复合功能。 AT+QCFG='usbcfg' 配置 USB 复合功能 设置命令 AT+QCFG='usbcfg'[,,,,,,,, ,] 响应 若省略可选参数，查询当前配置： +QCFG: 'usbcfg',,,,,,,,, OK 最大响应时间 特性说明 若指定可选参数，配置 USB 复合功能： OK 或者 ERROR 300 毫秒 该命令重启后生效； 自动保存参数配置。 参数 十六进制整型。USB 设备的供应商 ID。最大值：0xFFFF。 十六进制整型。USB 设备的产品 ID。最大值：0xFFFF。 整型。USB DIAG 端口状态。 0 禁用 1 启用 整型。USB NMEA 端口状态。 0 禁用 1 启用 整型。USB AT 端口状态。 0 禁用 1 启用 整型。USB Modem 端口状态。 0 禁用 上海移远通信技术股份有限公司 10 / 15 1 启用 整型。USB 网络设备状态。 0 禁用 1 启用 整型。USB ADB 设备状态。 0 禁用 1 启用 整型。UAC 状态。 0 禁用 1 启用 EG060K&EG120K 系列 UAC 应用指导 2.4. AT+QPCMV 启用/禁用语音数据转发功能 该命令用于启用/禁用语音数据转发功能。启用该功能后，拨打电话时，来自对方的语音数据将被模块 解码为 PCM 数据，然后通过已设置的 USB 端口输出到设备。同时，设备将 PCM 数据写入 USB 端口，数 据将通过网络传输到呼叫设备的另一端。当呼叫结束时，没有任何数据要输出，输入的数据无效。 AT+QPCMV 启用/禁用语音数据转发功能 测试命令 AT+QPCMV=? 响应 +QPCMV: (支持的列表),(支持的列表) 查询命令 AT+QPCMV? OK 响应 +QPCMV: [,] 设置命令 AT+QPCMV=[,] 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 不保存参数配置。 参数 整型。启用/禁用语音数据转发功能。 0 禁用 1 启用 整型。配置 PCM 数据传输的端口/声卡。 0 USB NMEA 端口。USB NMEA 在主机设备的设备节点一般为/dev/ttyUSB1 上海移远通信技术股份有限公司 11 / 15 EG060K&EG120K 系列 UAC 应用指导 2 UAC 模式，将模块作为 USB 声卡使用 备注 使用语音数据转发功能，必须先开启 UAC 功能。 上海移远通信技术股份有限公司 12 / 15 EG060K&EG120K 系列 UAC 应用指导 3 UAC 功能测试 本章节主要介绍 UAC 功能的测试步骤和方法。 3.1. 测试步骤 步骤1： 执行 AT+QCFG='usbcfg'，查询模块的 VID 和 PID。 步骤2： 执行 AT+QCFG='usbcfg',,,1,1,1,1,1,0,1 开启 UAC 功能。 步骤3： 重启模块。 步骤4： 观察主机的 USB 声卡是否加载完成。 步骤5： 执行 AT+QPCMV=1,2 启用 UAC 模式。 步骤6： 执行 ATD;（表示电话号码），开始拨打电话。 步骤7： 借助主机侧的工具，以及对端的听筒和麦克风，观察上下行语音链路是否正常，测试方法参 考第 3.2 章。 3.2. 测试语音链路 Windows 和 Linux 侧需要借助不同的工具测试语音链路是否正常。使用模块打通电话时，待接通被叫 手机后，按照下述方式，分别测试 Windows 和 Linux 的语音链路。 3.2.1. Windows 侧 步骤1： 选择声卡。 图 3：选择声卡 上海移远通信技术股份有限公司 13 / 15 EG060K&EG120K 系列 UAC 应用指导 步骤2： 使用工具 Audacity 进行语音的录音和播放。使用 Audacity 可以录入下行链路的语音，然后使 用 Audacity 的播放功能，将录入的下行链路音频播放到上行链路。如果手机扬声器播放的音 频与麦克风采集的音频一致，则通过测试。工具 Audacity 如下图所示： 图 4：工具 Audacity 3.2.2. Linux 侧 在 Linux 侧，可以使用 aplay 或者 arecord 工具测试录音和播音功能。首先查看用于播放或录音的 PCM 设备。执行如下命令： # ls /dev/snd/ by-id by-path controlC1 pcmC1D0c pcmC1D0p seq # cat /proc/asound/pcm 01-00: USB Audio : USB Audio : playback 1 : capture 1 timer 从命令的返回值可以得知，用于录音的设备为 pcmC1D0c，用于播放音频的设备为 pcmC1D0p。 步骤1： 使用 arecord 录入下行语音数据到 test.wav 文件中，执行命令如下： arecord test.wav -D hw:1,0 -f S16_LE 步骤2： 使用 aplay 播放 test.wav 到上行链路中，执行命令如下： aplay test.wav -D hw:1,0 -r 8000 如果手机端的扬声器播放的音频与麦克风采集的音频一致，则通过测试。 上海移远通信技术股份有限公司 14 / 15 EG060K&EG120K 系列 UAC 应用指导 4 附录 术语缩写 表 2：术语缩写 术语 ADB DSP NMEA PCM PID TA UAC USB VID 英文全称 Android Debug Bridge Digital Signal Processing NMEA (National Marine Electronics Association) 0183 Interface Standard Pulse Code Modulation Product ID Terminal Adapter USB Audio Class Universal Serial Bus Vendor ID 中文全称 安卓调试桥 数字信号处理技术 NMEA （ 美 国 国 家 海 洋 电 子 协 会 ） 0183 接口标准 脉冲编码调制 产品标识符 终端适配器 USB 音频子类 通用串行总线 供应商标识符 上海移远通信技术股份有限公司 15 / 15

BC28-CNV&BC95-CNV 数据传输速率统计指导 NB-IoT 模块系列 版本：1.0 日期：2022-12-26 状态：受控文件 BC28-CNV&BC95-CNV 数据传输速率统计指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 文档历史 修订记录 版本 1.0 日期 2022-10-27 2022-12-26 作者 Abel ZHOU/ Lewis LIU Abel ZHOU/ Lewis LIU 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 2 前期准备 ................................................................................................................................................. 8 2.1. 硬件准备 ...................................................................................................................................... 8 2.2. 软件准备 ...................................................................................................................................... 8 2.3. 波特率设置 .................................................................................................................................. 9 2.4. 预配置........................................................................................................................................ 10 2.5. 检查无线环境............................................................................................................................. 11 3 发送上行数据........................................................................................................................................ 12 3.1. 创建 Socket ............................................................................................................................... 12 3.2. 发送数据 .................................................................................................................................... 12 4 发送下行数据........................................................................................................................................ 15 4.1. 设置 UDP 服务器....................................................................................................................... 15 4.2. 向 UDP 服务器发送数据............................................................................................................ 15 4.3. 发送数据 .................................................................................................................................... 16 5 速率统计 ............................................................................................................................................... 17 6 附录 参考文档及术语缩写 ................................................................................................................... 20 上海移远通信技术股份有限公司 4 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 表格索引 表 1：参考文档 ........................................................................................................................................... 20 表 2：术语缩写 ........................................................................................................................................... 20 上海移远通信技术股份有限公司 5 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 图片索引 图 1：波特率设置 ......................................................................................................................................... 9 图 2：AT+NCONFIG?命令查询结果 .......................................................................................................... 10 图 3：AT+NUESTATS 命令查询结果 ..........................................................................................................11 图 4：上行 UDP 数据配置 .......................................................................................................................... 14 图 5：QServer 配置.................................................................................................................................... 15 图 6：QServer 下行 UDP 数据配置............................................................................................................ 16 图 7：速率指标查看.................................................................................................................................... 17 图 8：速率指标导出.................................................................................................................................... 18 图 9：勾选'After Filtering' .......................................................................................................................... 18 图 10：速率统计 ......................................................................................................................................... 19 上海移远通信技术股份有限公司 6 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 1 引言 本文档主要介绍 BC28-CNV 和 BC95-CNV 数据传输速率统计方法。 备注 本文中涉及到的 AT 命令使用详情，请参考文档 [1]。 上海移远通信技术股份有限公司 7 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 2 前期准备 本章节介绍速率测试前的相关准备工作。 2.1. 硬件准备 ⚫ BC28-CNV 和 BC95-CNV 模块。 ⚫ 移远通信 BC28-CNV 和 BC95-CNV TE-B 或用户根据移远通信提供的 TE-B 原理图自制的 TE-B 底板。 ⚫ 带以太网接口的 PC。 备注 如需获取上述硬件相关工具，请联系移远通信技术支持。 2.2. 软件准备 ⚫ 支持 BC28-CNV 和 BC95-CNV TE-B 的软件工具 DebugKits 及 DB 文件。 ⚫ QServer 工具。 备注 如需获取上述软件相关工具，请联系移远通信技术支持。 上海移远通信技术股份有限公司 8 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 2.3. 波特率设置 波特率设置步骤如下： 步骤 1： 打开 QCOM 工具，点击'Open Port'打开端口。 步骤 2： 执行 AT+NATSPEED=921600,30,1（设置 AT 口波特率为 921600）。 步骤 3： 点击'Close Port'关闭端口，切换 QCOM 工具上的波特率为 921600。之后，再打开端口。 步骤 4： 同步波特率（发送任意 AT 命令，待返回 OK 即可）。 备注 波特率影响 UDP 灌包速率。测试峰值速率时，建议按上述步骤将波特率设置为 921600。 图 1：波特率设置 上海移远通信技术股份有限公司 9 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 2.4. 预配置 测试峰值速率时，要求进行如下配置： ⚫ AT+NCONFIG=RELEASE_VERSION,14 ⚫ AT+NCONFIG=NB_CATEGORY,2 ⚫ AT+NCONFIG=TWO_HARQ,TRUE 配置后，可通过 AT+NCONFIG?命令查询配置是否成功，如下图所示。 图 2：AT+NCONFIG?命令查询结果 上海移远通信技术股份有限公司 10 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 2.5. 检查无线环境 执行 AT+NUESTATS 命令确认信号质量，查看频点、小区 ID、RSRP、SINR 等无线网络相关信息。 测试峰值速率时，要求在信号强度尽可能高的场景进行测试。 图 3：AT+NUESTATS 命令查询结果 备注 上图中，信号功率（Signal power）和信噪比（SNR）实际值为查询出的值除以 10。 上海移远通信技术股份有限公司 11 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 3 发送上行数据 3.1. 创建 Socket 执行 AT+NSOCR=DGRAM,17,7888 创建 Socket，此时设置为 DGRAM，表示 Socket 类型为 UDP；设置为 17，表示 UDP 协议。 举例 AT+NSOCR=DGRAM,17,7888 0 OK 备注 建议使用 UDP Socket 进行速率测试，本文将使用 UDP Socket 提供测试指导。 3.2. 发送数据 执行 AT+NSOST=,,,,命令发送数据，其中： ⚫ 设置为 Server 地址：本例中为：220.180.239.212； ⚫ 设置为目标端口号，本例中为：8058； ⚫ 字节数为 1024（对应 2048 个字符）。 举例 AT+NSOST=0,220.180.239.212,8058,1024,aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 上海移远通信技术股份有限公司 12 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaa 0,1024 OK 上海移远通信技术股份有限公司 13 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 QCOM 工具中，将'Run Times'设置为 1000，将'Delay Time(mS)'设置为 30。然后点击'Run' 按钮，自动将数据发送到服务器，如下图所示。 图 4：上行 UDP 数据配置 ⚫NOTE 220.180.239.212 是 QServer 的 IP 地址，如需使用 QServer，请联系移远通信技术支持启动服务器。 上海移远通信技术股份有限公司 14 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 4 发送下行数据 4.1. 设置 UDP 服务器 使用 QServer 作为 UDP 服务器，点击'Config'→'Option'设置服务器 IP 地址和端口，之后点击 'OK'。设置完成后，点击'Start Server'打开 UDP 服务器。 图 5：QServer 配置 4.2. 向 UDP 服务器发送数据 向 UDP 服务器发送数据以建立连接。 上海移远通信技术股份有限公司 15 / 20 举例 AT+NSOCR=DGRAM,17,7888 0 OK AT+NSOST=0,220.180.239.212,8058,2,aaa 0,2 OK BC28-CNV&BC95-CNV 数据传输速率统计指导 //创建 Socket //向服务器发送 UDP 数据 4.3. 发送数据 QServer 窗口，勾选左侧窗口复选框，将'Interval(mS)'设置为 100，将'Run Times'设置为 500， 输入 1024 字节数据后，点击'Auto Send'，向模块发送下行数据。 图 6：QServer 下行 UDP 数据配置 上海移远通信技术股份有限公司 16 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 5 速率统计 步骤 1： 通过 DebugKit 工具打开日志文件： 使用关键字'PROTO_UE_STATS_TPUT_BLER_REPORT'过滤日志并将'src'和'rate' 显示到'Message'列表中。 图 7：速率指标查看 上海移远通信技术股份有限公司 17 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 步骤 2： 在'Message'列表中选择一条记录并单击鼠标右键，然后单击'Export All...'，选择数据 文件格式为.csv，并勾选'After Filtering'后导出速率指标。 图 8：速率指标导出 图 9：勾选'After Filtering' 上海移远通信技术股份有限公司 18 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 步骤 3： 打开导出的.csv 文件，筛选'MAC_UL'或'MAC_DL'，即可统计出速率，速率单位是比特 每秒（bps）。 图 10：速率统计 上海移远通信技术股份有限公司 19 / 20 BC28-CNV&BC95-CNV 数据传输速率统计指导 6 附录 参考文档及术语缩写 表 1：参考文档 文档名称 [1] Quectel_BC28-CNV&BC95-CNV_AT 命令手册 表 2：术语缩写 缩写 DB DL ID IP PC RSRP SINR TCP UDP UL 英文全称 Database Downlink Identifier Internet Protocol Personal Computer Reference Signal Received Power Signal to Interference plus Noise Ratio Transmission Control Protocol User Datagram Protocol Uplink 中文全称 数据库 下行 标识符 网络协议 个人电脑 参考信号接收功率 信号与干扰加噪声比 传输控制协议 用户数据报协议 上行 上海移远通信技术股份有限公司 20 / 20

EC2x&EG2x&EG9x&EM05 系列软 件热管理指导 LTE Standard 模块系列 版本：1.0 日期：2022-11-22 状态：受控文件 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 文档历史 修订记录 版本 1.0 日期 2021-11-17 2022-11-22 作者 Colin CUI Colin CUI 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 2 AT 命令详解 ........................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句...................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. AT+QTEMP 查询温度值 ........................................................................................................... 8 2.4. AT+QCFG='thermal/modem' 设置温升处理机制..................................................................... 9 2.5. AT+QCFG='thermal/txpwrlmt' 控制传输功率 ........................................................................ 10 2.6. AT+QCFG='thermal/limit_rates' 启用/禁用软件热管理机制 ................................................. 11 3 温升处理机制........................................................................................................................................ 13 3.1 限制数据传输速率 ..................................................................................................................... 13 3.1.1. 限制上行数据传输速率 ................................................................................................... 13 3.1.2. 限制下行数据传输速率 ................................................................................................... 14 3.2. 限制 PA 功率.............................................................................................................................. 15 3.3. 进入限制服务模式 ..................................................................................................................... 15 3.4. 重启模块 .................................................................................................................................... 16 4 附录 术语缩写...................................................................................................................................... 17 上海移远通信技术股份有限公司 4 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令及响应类型............................................................................................................................. 7 表 3：上行速率限制等级 ............................................................................................................................ 13 表 4：限制下行速率的 PUCCH 周期 .......................................................................................................... 14 表 5：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 5 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 1 引言 本文档主要介绍了移远通信 LTE Standard EC2x、EG9x、EG2x 和 EM05 系列模块的软件温升处理机 制及相关的 AT 命令。当温度满足指定条件时，即可通过对应的温升处理机制对模块进行冷却降温。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG9x EG2x EM05 模块 EC25 系列 EC21 系列 EC20-CE EC20-CN EG95 系列 EG91 系列 EG25-G EG25-GL EG21-G EG21-GL EM05 系列 上海移远通信技术股份有限公司 6 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QTEMP 查询温度值 该命令用于获取模块的温度值。 AT+QTEMP 查询温度值 测试命令 AT+QTEMP=? 执行命令 AT+QTEMP 最大响应时间 特性说明 响应 OK 响应 +QTEMP: ,, OK 或者 ERROR 300 毫秒 / 参数 整型。基带温度值。单位：摄氏度。 整型。XO 温度值。单位：摄氏度。 整型。PA 温度值。单位：摄氏度。 举例 AT+QTEMP +QTEMP: 30,28,27 OK //查询模块温度值 上海移远通信技术股份有限公司 8 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 2.4. AT+QCFG='thermal/modem' 设置温升处理机制 该命令用于设置温升处理机制。配置的机制将基于 AT+QTEMP 查询到的最高温度值触发。 AT+QCFG='thermal/modem' 设置温升处理机制 设置命令 AT+QCFG='thermal/modem'[,, ,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'thermal/modem',1,, +QCFG: 'thermal/modem',2,, +QCFG: 'thermal/modem',3,, OK 最大响应时间 特性说明 若指定可选参数，则设置温升处理等级： OK 或者 ERROR 300 毫秒 该命令重启后生效。 参数配置自动保存。 参数 整型。温升处理等级。每种温升处理等级对应一组和。 1 Level 1，表示限制上行数据传输速率（详见第 3.1.1 章） 2 Level 2，表示在 Level 1 的基础上限制下行传输速率（详见第 3.1.2 章） 3 Level 3，表示限制服务模式。该模式下，模块无法进行数据传输，只可以进行紧急电话 业务（详见第 3.3 章） 整型。触发温度阈值。当模块温度达到值时，将会触发对应等级（）的温升处 理机制。单位：0.001 °C。 当=1，表示触发降低上行速率的温度阈值。默认值：100000。 当=2，表示触发降低下行速率的温度阈值。默认值：105000。 当=3，表示进入限制服务模式的温度阈值。默认值：115000。 整型。终止温度阈值。当温度下降到值时，对应等级（）的温升处理机制将会终 止。单位：0.001 °C。 当=1，表示终止降低上行速率的温度阈值。默认值：95000。 当=2，表示终止降低下行速率的温度阈值。默认值：100000。 当=3，表示终止限制服务模式的温度阈值。默认值：105000。 上海移远通信技术股份有限公司 9 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 举例 AT+QCFG='thermal/modem',1,100000,95000 //Level 1 通过限制上行速率的方式降低温度。若温度达 到 100 ºC 则限制上行速率；当温度降至 95 ºC 时，则 终止降低上行速率的温度阈值，从而终止 Level 1。 OK AT+QCFG='thermal/modem' //查询模块的温升处理等级。 +QCFG: 'thermal/modem',1,100000,95000 +QCFG: 'thermal/modem',2,105000,100000 +QCFG: 'thermal/modem',3,115000,105000 OK 2.5. AT+QCFG='thermal/txpwrlmt' 控制传输功率 该命令用于控制传输功率。 AT+QCFG='thermal/txpwrlmt' 控制传输功率 设置命令 AT+QCFG='thermal/txpwrlmt'[,,,,,,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'thermal/txpwrlmt',,,,,, OK 最大响应时间 特性说明 若指定可选参数，则控制传输功率： OK 或者 ERROR 300 毫秒 该命令重启后生效。 参数配置自动保存。 参数 整型。表示是否控制传输功率。 0 关闭 1 开启 整型。温度传感器 ID，与 AT+QTEMP 返回的传感器温度值对应。 2 基带温度传感器（不建议修改该默认值） 5 PA 温度传感器 上海移远通信技术股份有限公司 10 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 7 XO 温度传感器 整型。控制传输功率的温度阈值。范围：-150~150。默认值：105。单位：°C。 整型。温度检测周期。范围：1000~360000。默认值：1000（不建议修改该默认 值）。单位：毫秒。 整型。触发限制传输功率检测阈值的次数。范围：1~10000。默认值：3（不建议 修改该默认值）。 整型。触发恢复传输功率检测阈值的次数。范围：1~10000。默认值：10（不建 议修改该默认值）。 举例 AT+QCFG='thermal/txpwrlmt',1,2,105,1000,3,10 OK AT+QCFG='thermal/txpwrlmt' +QCFG: 'thermal/txpwrlmt',1,2,105,1000,3,10 OK //开启传输功率控制。 //查询传输功率配置。 2.6. AT+QCFG='thermal/limit_rates' 启用/禁用软件热管理机制 该命令用于启用/禁用软件热管理机制。 AT+QCFG='thermal/limit_rates' 启用/禁用软件热管理机制 设置命令 AT+QCFG='thermal/limit_rates'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'thermal/limit_rates', OK 最大响应时间 特性说明 若指定可选参数，则启用/禁用软件热管理机制： OK 或者 ERROR 300 毫秒 该命令重启后生效。 参数配置自动保存。 上海移远通信技术股份有限公司 11 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 参数 整型。启用/禁用软件热管理机制。 0 禁用 1 基于 AT+QCFG='thermal/modem'和 AT+QCFG='thermal/txpwrlmt'默认值自动配 置软件热管理机制 举例 AT+QCFG='thermal/limit_rates' +QCFG: 'thermal/limit_rates',0 OK AT+QCFG='thermal/limit_rates',1 OK //查询软件热管理机制状态。 //开启软件热管理机制。 备注 为保证模块的可靠性和稳定性，模块正常运行时不建议关闭热管理机制。 上海移远通信技术股份有限公司 12 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 3 温升处理机制 3.1 限制数据传输速率 通过限制数据传输速率可以减少 CPU 和 PA 等组件的工作负载以达到降温目的，然而，通过限制数据 传输速率的方式降温的缺点是在无数据传输或者数据传输速率较低时，降温效果并不明显。 AT+QCFG='thermal/modem',1,,通过控制模块上行传输速率进行降温；AT+QCFG='the rmal/modem',2,,用于通过控制模块下行传输速率将模块温度限制在某个温度阈值。 3.1.1. 限制上行数据传输速率 当模块进入 Level 1 时，模块的最大传输速率将配置为 40 Mbit/秒（target_rate[1]）。温度传感器的监 测周期默认为 3 秒。若 3 秒后模块依然处于 Level 1（或温度上升进入 Level 2），传输速率将降至 20 Mbit/ 秒（target_rate[2]），以此类推，每 3 秒检测一次温度，若温度仍高于终止温度阈值，传输速率等级会逐 级上升直至降为 4 Mbit/秒（target_rate[9]）。待模块降温直至低于终止温度阈值后，传输速率将逐级恢复 至 50 Mbit/秒（target_rate[0]）。 表 3：上行速率限制等级 参数类别 参数 ID 上行传输速率等级数量 num_states 进入 Level 1 后的初始上行传输速率阈值 default_state target_rate[0] target_rate[1] 传输速率等级 target_rate[2] target_rate[3] target_rate[4] target_rate[5] 参数值（十进制） 10 target_rate[1] 50 Mbit/秒 40 Mbit/秒 20 Mbit/秒 10 Mbit/秒 8 Mbit/秒 7 Mbit/秒 上海移远通信技术股份有限公司 13 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 target_rate[6] target_rate[7] target_rate[8] target_rate[9] 6 Mbit/秒 6 Mbit/秒 4 Mbit/秒 4 Mbit/秒 备注 1. 上表所示的上行速率限制等级是模块启用软件热管理机制自动配置的默认值。实际测试时每个模块 表现不一样，主要受模块自身的状态、散热、周围环境的影响。 2. 当在 CMW500 仪器进行测试时，必须使用非 00101 的白卡，软件热管理机制才能生效。 3.1.2. 限制下行数据传输速率 PUCCH 周期为 200 毫秒（开启 + 关闭时间）。PUCCH 开启时，ACK/NACK 在 PUCCH 中发送； PUCCH 关闭时，ACK/NACK 不在 PUCCH 中发送。进入 Level 2 后，下行速率限制的默认周期为 State 3 （开启 100 毫秒、关闭 100 毫秒）。若随后模块温度在 Level 2 保持 10 秒，下行速率限制的周期将会限制 在 State 2（开启 80 毫秒、关闭 120 毫秒），以此类推，每 10 秒检测一次温度，若温度仍高于终止温度阈 值，state 等级将会逐级下降，直至降至 State 0（开启 30 毫秒、关闭 170 毫秒）。待模块降温低于终止温 度阈值后，state 等级将逐级恢复，直至下行速率恢复正常，详见下表说明。 表 4：限制下行速率的 PUCCH 周期 参数 PUCCH 周期 状态数量 默认状态等级 基于 CPU 流控的默认状态 State 0（timer [0]） State 1（timer [1]） State 2（timer [2]） State 3（timer [3]） State 4（timer [4]） 参数值 200 毫秒 6 3 3 开启 30 毫秒、关闭 170 毫秒 开启 60 毫秒、关闭 140 毫秒 开启 80 毫秒、关闭 120 毫秒 开启 100 毫秒、关闭 100 毫秒 开启 120 毫秒、关闭 80 毫秒 上海移远通信技术股份有限公司 14 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 State 5（timer [5]） 状态步进计时器 基于 CPU 流控的默认状态 开启 140 毫秒、关闭 60 毫秒 10000 毫秒 400 备注 1. 模块无法直接控制下行速率，而是通过不响应无线协议栈层的网络 ACK 来强制网络限制下行速率。 因此，需要模块端和网络侧协议的支持，但是传输速率阈值不可控。 2. 模块进入 Level 2 后，Level 1 将同时生效，即模块将会同时限制上行数据传输速率和下行数据传输 速率。 3.2. 限制 PA 功率 限制 PA 功率可以有效减轻 PA 工作负载。然而，场测时的传输功率是由网络决定的。通常情况下，网 络信号不太差时，传输功率相对不高，因此此时通过限制传输功率进行降温的结果并不明显。 当实际传输功率受限且低于网络配置的传输功率时，网络无法接收到模块发送的信号或者无法解码信 号，导致数据传输性能大大降低。 传输功率影响着功耗和 PA 发热程度，限制发射功率理论上可以降低模块温度。传输功率控制等级可以 分为 0~7 八个等级，分别对应 22~15 dBm 不等的最大传输功率。 以 AT+QCFG='thermal/txpwrlmt',1,2,105,1000,3,10 为例，该命令表示使能控制传输功率后，每隔 1 秒（1000 毫秒）检测一次模块当前的温度，连续检测 3 次，若持续 3 秒高于 105 ºC 则将模块的最高发 射功率降低 1 dBm，以此类推，直至降低至最低发射功率 15 dBm；同时，若连续 10 次（连续 10 秒）检 测到模块当前温度低于 105 ºC，则最大功率提高 1 dBm，以此类推，直至提高至最高发射功率 22 dBm。 3.3. 进入限制服务模式 进入限制服务模式后，模块会停止除紧急电话之外所有服务，以保护硬件，避免高温损坏。 模块会根据 AT+QCFG='thermal/mdm',3,,设置的温度阈值进入限制服务模式，通过限制 服务的方式降低温度。 以 AT+QCFG='thermal/modem',3,115000,105000 为例，当模块温度值达到 115 ºC 时，模块将进入 Level 3，此时，模块只能拨打紧急电话，不能使用其他功能。 上海移远通信技术股份有限公司 15 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 备注 执行 Level 3 的温升处理机制之后，只有模块的温度低于终止 Level 1 的温度阈值以下，模块才能重新工 作。 3.4. 重启模块 当模块温度达到 120 ºC 左右时，模块将自动重启以保护硬件。该机制和温度阈值均不可由用户配置。 上海移远通信技术股份有限公司 16 / 17 EC2x&EG2x&EG9x&EM05 系列软件热管理指导 4 附录 术语缩写 表 5：术语缩写 缩写 ACK CPU LTE NACK PA PUSCH TA UL XO 英文全称 Acknowledgement Central Processing Unit Long-Term Evolution Negative Acknowledgement Power Amplifier Physical Uplink Shared Channel Terminal Adapter Uplink Crystal Oscillator 中文全称 确认消息 中央处理器 长期演进 否定消息 功率放大器 物理上行共享信道 终端适配器 上行链路 晶体振荡器 上海移远通信技术股份有限公司 17 / 17

EM12&EG12&EG18 系列 FILE 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-10-10 状态：受控文件 EM12&EG12&EG18 系列 FILE 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 26 EM12&EG12&EG18 系列 FILE 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 26 EM12&EG12&EG18 系列 FILE 应用指导 文档历史 修订记录 版本 1.0 日期 2022-09-09 2022-10-10 作者 Monan TIAN Monan TIAN 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 26 EM12&EG12&EG18 系列 FILE 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. FILE AT 命令使用流程 ................................................................................................................ 6 1.2. 数据模式说明...............................................................................................................................7 2 FILE AT 命令详解 ..................................................................................................................................8 2.1. AT 命令说明 ................................................................................................................................8 2.1.1. 定义 .................................................................................................................................. 8 2.1.2. AT 命令语句 .....................................................................................................................8 2.2. AT 示例声明 ................................................................................................................................9 2.3. AT 命令详解 ................................................................................................................................9 2.3.1. AT+QFLDS 获取存储媒介空间信息............................................................................... 9 2.3.2. AT+QFLST 列出存储媒介中的文件信息...................................................................... 10 2.3.3. AT+QFDEL 删除存储媒介中的文件............................................................................. 12 2.3.4. AT+QFUPL 上传文件到存储媒介 ................................................................................ 13 2.3.5. AT+QFDWL 下载存储媒介中的文件............................................................................ 14 2.3.6. AT+QFOPEN 打开文件 ............................................................................................... 15 2.3.7. AT+QFREAD 读取文件 ............................................................................................... 16 2.3.8. AT+QFWRITE 写入数据至文件................................................................................... 17 2.3.9. AT+QFSEEK 设置文件指针位置 ................................................................................. 18 2.3.10. AT+QFPOSITION 获取文件指针偏移量 ...................................................................... 19 2.3.11. AT+QFCLOSE 关闭文件 ............................................................................................. 19 3 举例 ...................................................................................................................................................... 21 3.1. 上传或下载文件 ......................................................................................................................... 21 3.1.1. 上传文件 ......................................................................................................................... 21 3.1.1.1. 无 ACK 模式 ....................................................................................................... 21 3.1.1.2. ACK 模式 ............................................................................................................ 21 3.1.2. 下载文件 ......................................................................................................................... 22 3.2. 写入和读取文件 ......................................................................................................................... 22 3.2.1. 写入和读取 UFS 文件 ..................................................................................................... 22 3.2.2. 写入和读取 SD 文件 ....................................................................................................... 22 4 错误码 .................................................................................................................................................. 24 5 附录 术语缩写......................................................................................................................................26 上海移远通信技术股份有限公司 4 / 26 EM12&EG12&EG18 系列 FILE 应用指导 表格索引 表 1：AT 命令类型 ....................................................................................................................................... 8 表 2：错误代码列表.................................................................................................................................... 24 表 3：术语缩写 ........................................................................................................................................... 26 上海移远通信技术股份有限公司 5 / 26 EM12&EG12&EG18 系列 FILE 应用指导 1 引言 移远通信 LTE-A 模块 EM12-G、EG12 和 EG18 系列支持通过 AT 命令操作不同物理存储媒介的文件， 本文档为用于操作文件的 AT 命令应用指导。 模块支持的物理存储媒介如下：  UFS: 用户文件存储目录，它是闪存文件系统上的一个特殊目录。  SD: SD 卡目录。 备注 1. 命令参数 （文件名称）包含存储位置。若以'UFS:'为前缀或无前缀，则表示文件被存 储在 UFS 中；若以'SD:'为前缀，则表示文件被存储在 SD 卡中。 2. 适用模块中，EM12-G 模块均不支持 SD 存储媒介。 1.1. FILE AT 命令使用流程 用户可以参照以下步骤在存储媒介中上传/下载、打开/创建、及读取/写入文件： 1. 通过 AT+QFUPL 上传文件至存储媒介，然后执行 AT+QFDWL 通过串行接口输出/下载文件。 2. 使用 AT+QFOPEN 打开文件后，可写入或读取此文件，直到文件被 AT+QFCLOSE 关闭。  使用 AT+QFOPEN 打开文件时，可以通过参数将文件设置为覆盖模式、只读模式或 其他模式（有关更多信息，可参考第 2.3.6 章）。打开文件后，会分配， 之后可以通过操作文件。  文 件 打 开 后 ， 可 从 当 前 文 件 指 针 位 置 通 过 AT+QFWRITE 写 入 数 据 至 文 件 ， 或 通 过 AT+QFREAD 读取文件数据。  用户可通过 AT+QFSEEK 设置文件指针位置，或执行 AT+QFPOSITION 查询当前文件指针 位置。  AT+QFCLOSE 用来关闭文件，文件关闭后，失效。 用户可以通过以下几个命令管理存储媒介中的文件： 1. AT+QFLDS 获取存储媒介空间信息。 2. AT+QFLST 列出存储媒介中的文件信息。 上海移远通信技术股份有限公司 6 / 26 EM12&EG12&EG18 系列 FILE 应用指导 3. AT+QFDEL 删除存储媒介中的文件。 备注 AT+QFOPEN 执行后获取的文件句柄，在使用完成后要及时用 AT+QFCLOSE 关闭，否则会造成句柄泄 露。 1.2. 数据模式说明 模块的 COM 口有两种工作模式，一是 AT 命令模式，另一种为数据模式。AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。  进入数据模式 执行 AT+QFUPL、AT+QFDWL、AT+QFREAD 或 AT+QFWRITE 后，模块响应 CONNECT， COM 口进入数据模式。或执行 ATO 重新进入数据模式。  退出数据模式 用户可以通过输入+++使 COM 口退出数据模式。在退出数据模式及返回响应之前，模块会中断进 入数据模式命令的执行，在此情况下，COM 口无法通过执行 ATO 重新进入数据模式。 为防止+++被误认为是数据，用户应遵循以下要求： 1. 输入+++前 1 秒内不能输入其它任何数据； 2. 必须在 1 秒内输入+++，并且不能输入其它任何数据。 3. 输入+++后，等待模块响应 OK。响应 OK 表示 COM 口退出数据模式。 上海移远通信技术股份有限公司 7 / 26 EM12&EG12&EG18 系列 FILE 应用指导 2 FILE AT 命令详解 2.1. AT 命令说明 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 26 EM12&EG12&EG18 系列 FILE 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QFLDS 获取存储媒介空间信息 该命令用于获取指定存储媒介的空间信息。 AT+QFLDS 获取存储媒介空间信息 测试命令 AT+QFLDS=? 设置命令 AT+QFLDS= 响应 OK 响应 +QFLDS: , OK 执行命令 AT+QFLDS 若有任何错误： +CME ERROR: 响应 返回 UFS 空间信息： +QFLDS: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。存储媒介类型。 'UFS' UFS 'SD' SD 卡 上海移远通信技术股份有限公司 9 / 26 EM12&EG12&EG18 系列 FILE 应用指导 整型。的可用空间。单位：字节。 整型。的总空间。单位：字节。 整型。UFS 中所有文件大小。单位：字节。 整型。UFS 中的文件数量。 整型。错误码。详见第 4 章。 举例 AT+QFLDS='UFS' +QFLDS: 578847,917503 OK AT+QFLDS='SD' +QFLDS: 251920384,253132800 OK //查询 UFS 的空间信息。 //查询 SD 卡的空间信息。 2.3.2. AT+QFLST 列出存储媒介中的文件信息 该命令列出指定存储媒介中的单个或所有文件信息。 AT+QFLST 列出存储媒介中的文件信息 测试命令 AT+QFLST=? 设置命令 AT+QFLST= 响应 OK 响应 +QFLST: , [+QFLST: , […]] OK 执行命令 AT+QFLST 若有任何错误： +CME ERROR: 响应 返回存储在 UFS 中所有文件的空间信息： +QFLST: , [+QFLST: , […]] OK 若有任何错误： +CME ERROR: 上海移远通信技术股份有限公司 10 / 26 EM12&EG12&EG18 系列 FILE 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。列出文件的名称类型。最大长度为 80 字节。 '*' 列出 UFS 中所有文件 '' 列出 UFS 中指定的文件 'UFS:*' 列出 UFS 中所有文件 'UFS:' 列出 UFS 中指定的文件 'SD:*' 列出 SD 卡中所有文件 'SD:' 列出 SD 卡中指定的文件 字符串类型。文件的具体名称。 整型。文件大小。单位：字节。 整型。错误码。详见第 4 章。 举例 AT+QFLST='*' +QFLST: 'UFS:1k.txt',1024 +QFLST: 'UFS:2k.txt',2048 +QFLST: 'UFS:3k.txt',3072 OK AT+QFLST='SD:*' +QFLST: 'SD:1k.txt',1024 +QFLST: 'SD:10k.txt',10240 +QFLST: 'SD:100k.txt',102400 OK //列出 UFS 中的所有文件。 //列出 SD 卡中的所有文件。 备注 AT+QFLST 用于查询当前存储在 Flash 中的文件的实际大小。当使用 AT+QFWRITE 写入数据后，若执 行 AT+QFLST 查询不成功，使用 AT+QFCLOSE 关闭当前文件后再次查询。 上海移远通信技术股份有限公司 11 / 26 EM12&EG12&EG18 系列 FILE 应用指导 2.3.3. AT+QFDEL 删除存储媒介中的文件 该命令用于删除指定存储媒介中的单个或所有文件。 AT+QFDEL 删除存储媒介中的文件 测试命令 AT+QFDEL=? 响应 +QFDEL: 设置命令 AT+QFDEL= OK 响应 OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。将删除文件的名称类型。最大长度为 80 字节。 '*' 删除 UFS 中所有文件（不删除目录） '' 删除 UFS 中指定的文件 'UFS:*' 删除 UFS 中所有文件（不删除目录） 'UFS:' 删除 UFS 中指定的文件 'SD:*' 删除 SD 卡中所有文件（不删除目录） 'SD:' 删除 SD 卡中指定的文件 字符串类型。文件的具体名称。 整型。错误码。详见第 4 章。 举例 AT+QFDEL='*' OK AT+QFDEL='UFS:1.txt' OK AT+QFDEL='SD:*' OK //删除 UFS 中所有文件（不删除目录）。 //删除 UFS 中的 1.txt 文件。 //删除 SD 卡中所有文件（不删除目录）。 上海移远通信技术股份有限公司 12 / 26 EM12&EG12&EG18 系列 FILE 应用指导 2.3.4. AT+QFUPL 上传文件到存储媒介 该命令用于上传文件到存储媒介，若上传的文件与存储媒介中的文件同名，则会上报错误。 当上传的文件大小达到，或无数据输入的时间达到，模块会自动退出数据模式。 数据传输期间，用户可以通过输入+++使之退出数据模式，更多相关信息，可参考第 1.2 章。 有 关 该 命 令 的 Linux 用 例 ， 请 参 考 quec_upload.zip 包 ； 有 关 用 例 的 使 用 方 法 介 绍 ， 请 参 考 quec_upload.zip 中的 Readme 文件。请联系移远通信技术支持获取 quec_upload.zip 包。 AT+QFUPL 上传文件到存储媒介 测试命令 AT+QFUPL=? 响应 +QFUPL: ,(1-),(支持的范 围),(支持的列表) OK 设置命令 AT+QFUPL=[,[, [,]]] 响应 CONNECT TA 切换为数据模式（即透传模式），可输入二进制文件数据。 当输入数据的总大小达到或 TA 接收到+++时，TA 将切换回命令模式： +QFUPL: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。的可用空间。有关的详细信息，请参考第 2.3.1 章。 字符串类型。上传文件的名称类型。最大长度为 80 字节。 '' 上传至 UFS 中的文件 'UFS:' 上传至 UFS 中的文件 'SD:' 上传至 SD 卡中的文件 字符串类型。文件的具体名称。 整型。预计上传的文件大小。默认值：10240；单位：字节。该参数最大值应不超过 。 整型。实际上传的文件大小。单位：字节。 上海移远通信技术股份有限公司 13 / 26 EM12&EG12&EG18 系列 FILE 应用指导 整型。通过 USB/UART 输入数据的等待时间。范围：1~65535；默认值：5；单位：秒。 整型。是否使用 ACK 模式。 0 关闭 ACK 模式 1 开启 ACK 模式 整型。上传数据的校验和。 整型。错误码。详见第 4 章。 备注 1. 推荐使用 DOS 8.3 文件名格式。 2. 是基于异或的 16 位校验和。 如果字节数为奇数，则最后一个字节设置为高 8 位，低 8 位设置为 0，然后使用 XOR 运算符计算校 验和。+++可使 TA 结束数据传输并切换到命令模式。之前上传的数据将保留在文件中。 3. 执行命令时，必须在返回 CONNECT 后输入数据。 4. 在硬件流控制不起作用时，ACK 模式可避免在上传大文件时数据丢失。ACK 模式的工作原理如下： 1) 运行 AT+QFUPL=,,,1 启用 ACK 模式。 2) 模块输出 CONNECT。 3) MCU 发送 1 KB 数据，模块响应一个 A。 4) MCU 接收 A，然后发送下一个 1 KB 数据。 5) 重复第 3) 和 4) 步骤，直到传输完成。 有关 ACK 模式的示例，详见第 3.1.1.2 章。 2.3.5. AT+QFDWL 下载存储媒介中的文件 该命令用于从存储媒介中下载指定的文件。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFDWL 下载存储媒介中的文件 测试命令 AT+QFDWL=? 响应 +QFDWL: 设置命令 AT+QFDWL= OK 响应 CONNECT TA 切换为数据模式，可输出文件二进制数据。文件下载完成或 TA 接收到+++时，TA 将切换回命令模式： +QFDWL: , OK 若有任何错误： +CME ERROR: 上海移远通信技术股份有限公司 14 / 26 EM12&EG12&EG18 系列 FILE 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。下载文件的名称类型。最大长度为 80 个字节。 '' 下载的 UFS 文件 'UFS:' 下载的 UFS 文件 'SD:' 下载的 SD 卡文件 字符串类型。文件的具体名称。 整型。已下载数据的大小。 整型。已下载数据的校验和。 整型。错误码。详见第 4 章。 备注 1. +++序列会使 TA 结束命令并切换到命令模式。 2. 是基于异或的 16 位校验和。 2.3.6. AT+QFOPEN 打开文件 该命令用于打开文件并获取命令中使用的文件句柄，相关命令为 AT+QFREAD、AT+QFWRITE、 AT+QFSEEK、AT+QFPOSITION 和 AT+QFCLOSE。 AT+QFOPEN 打开文件 测试命令 AT+QFOPEN=? 响应 +QFOPEN: ,(支持的范围) 查询命令 AT+QFOPEN? OK 响应 +QFOPEN: ,, [+QFOPEN: ,, […]] 设置命令 AT+QFOPEN=[,] OK 响应 +QFOPEN: OK 上海移远通信技术股份有限公司 15 / 26 最大响应时间 特性说明 EM12&EG12&EG18 系列 FILE 应用指导 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。打开的文件名称。最大长度为 80 字节。 '' 打开的 UFS 文件 'UFS:' 打开的 UFS 文件 'SD:' 打开的 SD 卡文件 字符串类型。文件的具体名称。 整型。文件句柄。 整型。文件的打开模式。 0 若文件不存在，则会创建一个新文件；若文件存在，则直接打开文件。两种情 况中的文件皆可读写。 1 若文件不存在，则会创建一个新文件；若文件存在，则清除并覆盖文件。两种 情况中的文件皆可读写。 2 若文件不存在，则响应错误；若文件存在，则作为只读文件直接打开。 整型。错误码。详见第 4 章。 2.3.7. AT+QFREAD 读取文件 该命令用于读取由文件句柄指定的文件数据。数据从文件指针的当前位置开始读取，文件指针属于文 件句柄。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFREAD 读取文件 测试命令 AT+QFREAD=? 响应 +QFREAD: , 设置命令 AT+QFREAD=[,] OK 响应 CONNECT TA 切换到数据模式，当数据总大小超过或 TA 接收 到+++时，TA 将切换回命令模式： OK 若有任何错误： 上海移远通信技术股份有限公司 16 / 26 最大响应时间 特性说明 EM12&EG12&EG18 系列 FILE 应用指导 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。预计读取的文件长度。默认长度为 10 KB，若文件长度不足 10 KB，则读取 文件的实际长度。单位：字节。 整型。实际读取的文件长度。单位：字节。 整型。错误码。详见第 4 章。 2.3.8. AT+QFWRITE 写入数据至文件 该命令可将数据写入到文件。数据从文件指针的当前位置开始写入，文件指针属于文件句柄。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFWRITE 写入数据至文件 测试命令 AT+QFWRITE=? 响应 +QFWRITE: ,, 设置命令 AT+QFWRITE=[,[,]] OK 响应 CONNECT TA 切换到数据模式。当写入数据的总大小超过、TA 接收到+++或写入时间超过，TA 将切换回命令模式： +QFWRITE: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 17 / 26 EM12&EG12&EG18 系列 FILE 应用指导 参数 整型。需要操作的文件句柄。 整型。预计写入文件的长度。默认长度为 10 KB，此参数的最大值由 AT+QFUPL 的决定。单位：字节。 整型。通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒。 整型。实际写入数据的长度。单位：字节。 整型。文件总长度。单位：字节。 整型。错误码。详见第 4 章。 2.3.9. AT+QFSEEK 设置文件指针位置 该 命 令 可 设 置 文 件 指 针 到 指 定 的 位 置 ， 相 关 命 令 为 AT+QFREAD 、 AT+QFWRITE 和 AT+QFPOSITION。 AT+QFSEEK 设置文件指针位置 测试命令 AT+QFSEEK=? 响应 +QFSEEK: ,, 设置命令 AT+QFSEEK=,[, ] OK 响应 OK 若有任何错误： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。文件指针移动的字节数。 整型。文件指针移动模式。 0 文件初始位置向后移动 1 文件指针当前位置向后移动 2 文件结尾位置向前移动 整型。错误码。详见第 4 章。 上海移远通信技术股份有限公司 18 / 26 EM12&EG12&EG18 系列 FILE 应用指导 备注 若设置的最终指针位置超过文件范围，执行此命令会返回 ERROR。 2.3.10. AT+QFPOSITION 获取文件指针偏移量 该命令可从文件初始位置获取文件指针的偏移量。 AT+QFPOSITION 获取文件指针偏移量 测试命令 AT+QFPOSITION=? 响应 +QFPOSITION: 设置命令 AT+QFPOSITION= OK 响应 +QFPOSITION: OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。从初始位置起文件指针的偏移量。 整型。错误码。详见第 4 章。 2.3.11. AT+QFCLOSE 关闭文件 该命令用于关闭文件或结束对文件的操作。关闭文件后，文件句柄会被释放。除非通过 AT+QFOPEN 再次打开文件，否则不可再次使用文件句柄。 AT+QFCLOSE 关闭文件 测试命令 AT+QFCLOSE=? 响应 +QFCLOSE: OK 上海移远通信技术股份有限公司 19 / 26 EM12&EG12&EG18 系列 FILE 应用指导 设置命令 AT+QFCLOSE= 最大响应时间 特性说明 响应 OK 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。错误码。详见第 4 章。 上海移远通信技术股份有限公司 20 / 26 EM12&EG12&EG18 系列 FILE 应用指导 3 举例 3.1. 上传或下载文件 3.1.1. 上传文件 3.1.1.1. 无 ACK 模式 AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK //上传文本文件 test1.txt 到 UFS。 //数据模式下输入二进制文件数据。 3.1.1.2. ACK 模式 ACK 模式下传输数据更可靠。在无硬件流控情况下传输大文件时，推荐开启 ACK 模式避免数据丢失。 有关 ACK 模式的详细信息，可参考 AT+QFUPL 命令。 AT+QFUPL='test.txt',3000,5,1 CONNECT A A +QFUPL: 3000,B34A //上传文本文件 test.txt 到 UFS。 //数据模式下输入 1024 字节二进制文件数据。 //在 MCU 发送 1024 字节数据后，模块会响应一个 A，然后 发送下一个 1024 字节数据。 //数据模式下输入 1024 字节二进制文件数据。 //数据模式下输入剩余二进制文件数据。 OK 上海移远通信技术股份有限公司 21 / 26 3.1.2. 下载文件 AT+QFDWL='test.txt' CONNECT +QFDWL: 10,613e OK EM12&EG12&EG18 系列 FILE 应用指导 //从 UFS 中下载文本文件 test.txt。 //数据模式下输出文件数据。 //获取已下载数据的字节数和校验和。 3.2. 写入和读取文件 3.2.1. 写入和读取 UFS 文件 AT+QFOPEN='test.txt',1 +QFOPEN: 3023 OK AT+QFWRITE=3023,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=3023,0,0 OK AT+QFREAD=3023,10 CONNECT 10 OK AT+QFCLOSE=3023 OK 3.2.2. 写入和读取 SD 文件 AT+QFOPEN='SD:1.txt',1 +QFOPEN: 3024 OK AT+QFWRITE=3024,1024 CONNECT //打开文件获取文件句柄。 //将 10 个字节写入文件。 //数据模式下写入文件数据。 //返回实际写入的字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取 10 个字节文件数据。 //数据模式下输出读取数据。 //关闭文件。 //打开文件获取文件句柄。 //将 1024 个字节写入文件。 //数据模式下写入数据。 上海移远通信技术股份有限公司 22 / 26 +QFWRITE: 1024,1024 OK AT+QFSEEK=3024,0,0 OK AT+QFREAD=3024,1024 CONNECT 1024 OK AT+QFCLOSE=3024 OK EM12&EG12&EG18 系列 FILE 应用指导 //返回实际写入的字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取 1024 个字节文件数据。 //数据模式下输出读取数据。 //关闭文件。 上海移远通信技术股份有限公司 23 / 26 EM12&EG12&EG18 系列 FILE 应用指导 4 错误码 表示与移动设备有关的错误码，详细信息可参考下表。下表中的错误码与本文档适用模块的文件 操作有关。 表 2：错误代码列表 错误码 400 401 402 403 405 406 407 409 410 411 413 414 416 417 418 419 420 英文含义 Invalid input value Larger than the size of the file Zero-byte read Drive full File not found Invalid file name File already exists Failed to write to the file Failed to open the file Failed to read the file Reached the max. number of files allowed to be opened Read-only file Invalid file descriptor Failed to list the file Failed to delete the file Failed to get disk info No space 中文含义 输入值无效 文件过大 读取 0 字节 驱动器已满 未发现文件 无效文件名 文件已存在 写入文件失败 打开文件失败 读取文件失败 达到允许打开的最大文件数 文件仅可读 无效文件描述符 列举文件失败 删除文件失败 获取磁盘信息失败 空间不足 上海移远通信技术股份有限公司 24 / 26 EM12&EG12&EG18 系列 FILE 应用指导 421 Time out 超时 423 File too large 文件过大 425 Invalid parameter 无效参数 426 File already opened 文件已打开 上海移远通信技术股份有限公司 25 / 26 EM12&EG12&EG18 系列 FILE 应用指导 5 附录 术语缩写 表 3：术语缩写 缩写 ACK COM DOS ME SD TA UART UFS USB XOR 英文全称 Acknowledgement Communication Port Disk Operating System Mobile Equipment Secure Digital Terminal Adapter Universal Asynchronous Receiver-Transmitter User File Storage Universal Serial Bus Exclusive OR 中文全称 确认消息 串行通讯端口 磁盘操作系统 移动设备 安全数字存储器 终端适配器 通用异步收发传输器 用户文件存储 通用串行总线 异或 上海移远通信技术股份有限公司 26 / 26

EG512R&EM12xR&EM160R 系列 FILE 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-10-10 状态：受控文件 EG512R&EM12xR&EM160R 系列 FILE 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 文档历史 修订记录 版本 1.0 日期 2022-09-09 2022-10-10 作者 Monan TIAN Monan TIAN 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 1.2. FILE AT 命令使用流程 ................................................................................................................ 7 1.3. 数据模式说明...............................................................................................................................7 2 FILE AT 命令详解 ..................................................................................................................................9 2.1. AT 命令说明 ................................................................................................................................9 2.1.1. 定义 .................................................................................................................................. 9 2.1.2. AT 命令语句 .....................................................................................................................9 2.2. AT 示例声明 ..............................................................................................................................10 2.3. AT 命令详解 ..............................................................................................................................10 2.3.1. AT+QFLDS 获取存储媒介空间信息............................................................................. 10 2.3.2. AT+QFLST 列出存储媒介中的文件信息...................................................................... 11 2.3.3. AT+QFDEL 删除存储媒介中的文件............................................................................. 13 2.3.4. AT+QFUPL 上传文件到存储媒介 ................................................................................ 14 2.3.5. AT+QFDWL 下载存储媒介中的文件............................................................................ 15 2.3.6. AT+QFOPEN 打开文件 ............................................................................................... 16 2.3.7. AT+QFREAD 读取文件 ............................................................................................... 17 2.3.8. AT+QFWRITE 写入数据至文件................................................................................... 18 2.3.9. AT+QFSEEK 设置文件指针位置 ................................................................................. 19 2.3.10. AT+QFPOSITION 获取文件指针偏移量 ...................................................................... 20 2.3.11. AT+QFCLOSE 关闭文件 ............................................................................................. 20 3 举例 ...................................................................................................................................................... 22 3.1. 上传或下载文件 ......................................................................................................................... 22 3.1.1. 上传文件 ......................................................................................................................... 22 3.1.1.1. 无 ACK 模式 ....................................................................................................... 22 3.1.1.2. ACK 模式 ............................................................................................................ 22 3.1.2. 下载文件 ......................................................................................................................... 23 3.2. 写入和读取文件 ......................................................................................................................... 23 3.2.1. 写入和读取 UFS 文件 ..................................................................................................... 23 3.2.2. 写入和读取 SD 文件 ....................................................................................................... 23 4 错误码 .................................................................................................................................................. 25 5 附录 术语缩写......................................................................................................................................27 上海移远通信技术股份有限公司 4 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 9 表 3：错误代码列表.................................................................................................................................... 25 表 4：术语缩写 ........................................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 1 引言 移远通信 LTE-A 模块 EG512R-EA、EM120R-GL、EM121R-GL 和 EM160R-GL 支持通过 AT 命令操 作不同物理存储媒介的文件，本文档为用于操作文件的 AT 命令应用指导。 模块支持的物理存储媒介如下：  UFS: 用户文件存储目录，它是闪存文件系统上的一个特殊目录。  SD: SD 卡目录。 备注 1. 命令参数 （文件名称）包含存储位置。若以'UFS:'为前缀或无前缀，则表示文件被存 储在 UFS 中；若以'SD:'为前缀，则表示文件被存储在 SD 卡中。 2. 适用模块中，EM120R-GL、EM121R-GL 和 EM160R-GL 模块均不支持 SD 存储媒介。 1.1. 适用模块 表 1：适用模块 适用模块 EG512R EM12xR EM160R EG512R-EA EM120R-GL EM121R-GL EM160R-GL 上海移远通信技术股份有限公司 6 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 1.2. FILE AT 命令使用流程 用户可以参照以下步骤在存储媒介中上传/下载、打开/创建、及读取/写入文件： 1. 通过 AT+QFUPL 上传文件至存储媒介，然后执行 AT+QFDWL 通过串行接口输出/下载文件。 2. 使用 AT+QFOPEN 打开文件后，可写入或读取此文件，直到文件被 AT+QFCLOSE 关闭。  使用 AT+QFOPEN 打开文件时，可以通过参数将文件设置为覆盖模式、只读模式或 其他模式（有关更多信息，可参考第 2.3.6 章）。打开文件后，会分配， 之后可以通过操作文件。  文 件 打 开 后 ， 可 从 当 前 文 件 指 针 位 置 通 过 AT+QFWRITE 写 入 数 据 至 文 件 ， 或 通 过 AT+QFREAD 读取文件数据。  用户可通过 AT+QFSEEK 设置文件指针位置，或执行 AT+QFPOSITION 查询当前文件指针 位置。  AT+QFCLOSE 用来关闭文件，文件关闭后，失效。 用户可以通过以下几个命令管理存储媒介中的文件： 1. AT+QFLDS 获取存储媒介空间信息。 2. AT+QFLST 列出存储媒介中的文件信息。 3. AT+QFDEL 删除存储媒介中的文件。 备注 AT+QFOPEN 执行后获取的文件句柄，在使用完成后要及时用 AT+QFCLOSE 关闭，否则会造成句柄泄 露。 1.3. 数据模式说明 模块的 COM 口有两种工作模式，一是 AT 命令模式，另一种为数据模式。AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。  进入数据模式 执行 AT+QFUPL、AT+QFDWL、AT+QFREAD 或 AT+QFWRITE 后，模块响应 CONNECT， COM 口进入数据模式。或执行 ATO 重新进入数据模式。 上海移远通信技术股份有限公司 7 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导  退出数据模式 用户可以通过输入+++使 COM 口退出数据模式。在退出数据模式及返回响应之前，模块会中断进 入数据模式命令的执行，在此情况下，COM 口无法通过执行 ATO 重新进入数据模式。 为防止+++被误认为是数据，用户应遵循以下要求： 1. 输入+++前 1 秒内不能输入其它任何数据； 2. 必须在 1 秒内输入+++，并且不能输入其它任何数据。 3. 输入+++后，等待模块响应 OK。响应 OK 表示 COM 口退出数据模式。 上海移远通信技术股份有限公司 8 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 2 FILE AT 命令详解 2.1. AT 命令说明 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QFLDS 获取存储媒介空间信息 该命令用于获取指定存储媒介的空间信息。 AT+QFLDS 获取存储媒介空间信息 测试命令 AT+QFLDS=? 设置命令 AT+QFLDS= 响应 OK 响应 +QFLDS: , OK 执行命令 AT+QFLDS 若有任何错误： +CME ERROR: 响应 返回 UFS 空间信息： +QFLDS: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。存储媒介类型。 'UFS' UFS 'SD' SD 卡 上海移远通信技术股份有限公司 10 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 整型。的可用空间。单位：字节。 整型。的总空间。单位：字节。 整型。UFS 中所有文件大小。单位：字节。 整型。UFS 中的文件数量。 整型。错误码。详见第 4 章。 举例 AT+QFLDS='UFS' +QFLDS: 578847,917503 OK AT+QFLDS='SD' +QFLDS: 251920384,253132800 OK //查询 UFS 的空间信息。 //查询 SD 卡的空间信息。 2.3.2. AT+QFLST 列出存储媒介中的文件信息 该命令列出指定存储媒介中的单个或所有文件信息。 AT+QFLST 列出存储媒介中的文件信息 测试命令 AT+QFLST=? 设置命令 AT+QFLST= 响应 OK 响应 +QFLST: , [+QFLST: , […]] OK 执行命令 AT+QFLST 若有任何错误： +CME ERROR: 响应 返回存储在 UFS 中所有文件的空间信息： +QFLST: , [+QFLST: , […]] OK 若有任何错误： +CME ERROR: 上海移远通信技术股份有限公司 11 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。列出文件的名称类型。最大长度为 80 字节。 '*' 列出 UFS 中所有文件 '' 列出 UFS 中指定的文件 'UFS:*' 列出 UFS 中所有文件 'UFS:' 列出 UFS 中指定的文件 'SD:*' 列出 SD 卡中所有文件 'SD:' 列出 SD 卡中指定的文件 字符串类型。文件的具体名称。 整型。文件大小。单位：字节。 整型。错误码。详见第 4 章。 举例 AT+QFLST='*' +QFLST: 'UFS:1k.txt',1024 +QFLST: 'UFS:2k.txt',2048 +QFLST: 'UFS:3k.txt',3072 OK AT+QFLST='SD:*' +QFLST: 'SD:1k.txt',1024 +QFLST: 'SD:10k.txt',10240 +QFLST: 'SD:100k.txt',102400 OK //列出 UFS 中的所有文件。 //列出 SD 卡中的所有文件。 备注 AT+QFLST 用于查询当前存储在 Flash 中的文件的实际大小。当使用 AT+QFWRITE 写入数据后，若执 行 AT+QFLST 查询不成功，使用 AT+QFCLOSE 关闭当前文件后再次查询。 上海移远通信技术股份有限公司 12 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 2.3.3. AT+QFDEL 删除存储媒介中的文件 该命令用于删除指定存储媒介中的单个或所有文件。 AT+QFDEL 删除存储媒介中的文件 测试命令 AT+QFDEL=? 响应 +QFDEL: 设置命令 AT+QFDEL= OK 响应 OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。将删除文件的名称类型。最大长度为 80 字节。 '*' 删除 UFS 中所有文件（不删除目录） '' 删除 UFS 中指定的文件 'UFS:*' 删除 UFS 中所有文件（不删除目录） 'UFS:' 删除 UFS 中指定的文件 'SD:*' 删除 SD 卡中所有文件（不删除目录） 'SD:' 删除 SD 卡中指定的文件 字符串类型。文件的具体名称。 整型。错误码。详见第 4 章。 举例 AT+QFDEL='*' OK AT+QFDEL='UFS:1.txt' OK AT+QFDEL='SD:*' OK //删除 UFS 中所有文件（不删除目录）。 //删除 UFS 中的 1.txt 文件。 //删除 SD 卡中所有文件（不删除目录）。 上海移远通信技术股份有限公司 13 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 2.3.4. AT+QFUPL 上传文件到存储媒介 该命令用于上传文件到存储媒介，若上传的文件与存储媒介中的文件同名，则会上报错误。 当上传的文件大小达到，或无数据输入的时间达到，模块会自动退出数据模式。 数据传输期间，用户可以通过输入+++使之退出数据模式，更多相关信息，可参考第 1.3 章。 有 关 该 命 令 的 Linux 用 例 ， 请 参 考 quec_upload.zip 包 ； 有 关 用 例 的 使 用 方 法 介 绍 ， 请 参 考 quec_upload.zip 中的 Readme 文件。请联系移远通信技术支持获取 quec_upload.zip 包。 AT+QFUPL 上传文件到存储媒介 测试命令 AT+QFUPL=? 响应 +QFUPL: ,(1-),(支持的范 围),(支持的列表) OK 设置命令 AT+QFUPL=[,[, [,]]] 响应 CONNECT TA 切换为数据模式（即透传模式），可输入二进制文件数据。 当输入数据的总大小达到或 TA 接收到+++时，TA 将切换回命令模式： +QFUPL: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。的可用空间。有关的详细信息，请参考第 2.3.1 章。 字符串类型。上传文件的名称类型。最大长度为 80 字节。 '' 上传至 UFS 中的文件 'UFS:' 上传至 UFS 中的文件 'SD:' 上传至 SD 卡中的文件 字符串类型。文件的具体名称。 整型。预计上传的文件大小。默认值：10240；单位：字节。该参数最大值应不超过 。 整型。实际上传的文件大小。单位：字节。 上海移远通信技术股份有限公司 14 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 整型。通过 USB/UART 输入数据的等待时间。范围：1~65535；默认值：5；单位：秒。 整型。是否使用 ACK 模式。 0 关闭 ACK 模式 1 开启 ACK 模式 整型。上传数据的校验和。 整型。错误码。详见第 4 章。 备注 1. 推荐使用 DOS 8.3 文件名格式。 2. 是基于异或的 16 位校验和。 如果字节数为奇数，则最后一个字节设置为高 8 位，低 8 位设置为 0，然后使用 XOR 运算符计算校 验和。+++可使 TA 结束数据传输并切换到命令模式。之前上传的数据将保留在文件中。 3. 执行命令时，必须在返回 CONNECT 后输入数据。 4. 在硬件流控制不起作用时，ACK 模式可避免在上传大文件时数据丢失。ACK 模式的工作原理如下： 1) 运行 AT+QFUPL=,,,1 启用 ACK 模式。 2) 模块输出 CONNECT。 3) MCU 发送 1 KB 数据，模块响应一个 A。 4) MCU 接收 A，然后发送下一个 1 KB 数据。 5) 重复第 3) 和 4) 步骤，直到传输完成。 有关 ACK 模式的示例，详见第 3.1.1.2 章。 2.3.5. AT+QFDWL 下载存储媒介中的文件 该命令用于从存储媒介中下载指定的文件。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFDWL 下载存储媒介中的文件 测试命令 AT+QFDWL=? 响应 +QFDWL: 设置命令 AT+QFDWL= OK 响应 CONNECT TA 切换为数据模式，可输出文件二进制数据。文件下载完成或 TA 接收到+++时，TA 将切换回命令模式： +QFDWL: , OK 若有任何错误： +CME ERROR: 上海移远通信技术股份有限公司 15 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。下载文件的名称类型。最大长度为 80 个字节。 '' 下载的 UFS 文件 'UFS:' 下载的 UFS 文件 'SD:' 下载的 SD 卡文件 字符串类型。文件的具体名称。 整型。已下载数据的大小。 整型。已下载数据的校验和。 整型。错误码。详见第 4 章。 备注 1. +++序列会使 TA 结束命令并切换到命令模式。 2. 是基于异或的 16 位校验和。 2.3.6. AT+QFOPEN 打开文件 该命令用于打开文件并获取命令中使用的文件句柄，相关命令为 AT+QFREAD、AT+QFWRITE、 AT+QFSEEK、AT+QFPOSITION 和 AT+QFCLOSE。 AT+QFOPEN 打开文件 测试命令 AT+QFOPEN=? 响应 +QFOPEN: ,(支持的范围) 查询命令 AT+QFOPEN? OK 响应 +QFOPEN: ,, [+QFOPEN: ,, […]] 设置命令 AT+QFOPEN=[,] OK 响应 +QFOPEN: OK 上海移远通信技术股份有限公司 16 / 27 最大响应时间 特性说明 EG512R&EM12xR&EM160R 系列 FILE 应用指导 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。打开的文件名称。最大长度为 80 字节。 '' 打开的 UFS 文件 'UFS:' 打开的 UFS 文件 'SD:' 打开的 SD 卡文件 字符串类型。文件的具体名称。 整型。文件句柄。 整型。文件的打开模式。 0 若文件不存在，则会创建一个新文件；若文件存在，则直接打开文件。两种情 况中的文件皆可读写。 1 若文件不存在，则会创建一个新文件；若文件存在，则清除并覆盖文件。两种 情况中的文件皆可读写。 2 若文件不存在，则响应错误；若文件存在，则作为只读文件直接打开。 整型。错误码。详见第 4 章。 2.3.7. AT+QFREAD 读取文件 该命令用于读取由文件句柄指定的文件数据。数据从文件指针的当前位置开始读取，文件指针属于文 件句柄。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFREAD 读取文件 测试命令 AT+QFREAD=? 响应 +QFREAD: , 设置命令 AT+QFREAD=[,] OK 响应 CONNECT TA 切换到数据模式，当数据总大小超过或 TA 接收 到+++时，TA 将切换回命令模式： OK 若有任何错误： 上海移远通信技术股份有限公司 17 / 27 最大响应时间 特性说明 EG512R&EM12xR&EM160R 系列 FILE 应用指导 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。预计读取的文件长度。默认长度为 10 KB，若文件长度不足 10 KB，则读取 文件的实际长度。单位：字节。 整型。实际读取的文件长度。单位：字节。 整型。错误码。详见第 4 章。 2.3.8. AT+QFWRITE 写入数据至文件 该命令可将数据写入到文件。数据从文件指针的当前位置开始写入，文件指针属于文件句柄。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFWRITE 写入数据至文件 测试命令 AT+QFWRITE=? 响应 +QFWRITE: ,, 设置命令 AT+QFWRITE=[,[,]] OK 响应 CONNECT TA 切换到数据模式。当写入数据的总大小超过、TA 接收到+++或写入时间超过，TA 将切换回命令模式： +QFWRITE: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 18 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 参数 整型。需要操作的文件句柄。 整型。预计写入文件的长度。默认长度为 10 KB，此参数的最大值由 AT+QFUPL 的决定。单位：字节。 整型。通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒。 整型。实际写入数据的长度。单位：字节。 整型。文件总长度。单位：字节。 整型。错误码。详见第 4 章。 2.3.9. AT+QFSEEK 设置文件指针位置 该 命 令 可 设 置 文 件 指 针 到 指 定 的 位 置 ， 相 关 命 令 为 AT+QFREAD 、 AT+QFWRITE 和 AT+QFPOSITION。 AT+QFSEEK 设置文件指针位置 测试命令 AT+QFSEEK=? 响应 +QFSEEK: ,, 设置命令 AT+QFSEEK=,[, ] OK 响应 OK 若有任何错误： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。文件指针移动的字节数。 整型。文件指针移动模式。 0 文件初始位置向后移动 1 文件指针当前位置向后移动 2 文件结尾位置向前移动 整型。错误码。详见第 4 章。 上海移远通信技术股份有限公司 19 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 备注 若设置的最终指针位置超过文件范围，执行此命令会返回 ERROR。 2.3.10. AT+QFPOSITION 获取文件指针偏移量 该命令可从文件初始位置获取文件指针的偏移量。 AT+QFPOSITION 获取文件指针偏移量 测试命令 AT+QFPOSITION=? 响应 +QFPOSITION: 设置命令 AT+QFPOSITION= OK 响应 +QFPOSITION: OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。从初始位置起文件指针的偏移量。 整型。错误码。详见第 4 章。 2.3.11. AT+QFCLOSE 关闭文件 该命令用于关闭文件或结束对文件的操作。关闭文件后，文件句柄会被释放。除非通过 AT+QFOPEN 再次打开文件，否则不可再次使用文件句柄。 AT+QFCLOSE 关闭文件 测试命令 AT+QFCLOSE=? 响应 +QFCLOSE: OK 上海移远通信技术股份有限公司 20 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 设置命令 AT+QFCLOSE= 最大响应时间 特性说明 响应 OK 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。错误码。详见第 4 章。 上海移远通信技术股份有限公司 21 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 3 举例 3.1. 上传或下载文件 3.1.1. 上传文件 3.1.1.1. 无 ACK 模式 AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK //上传文本文件 test1.txt 到 UFS。 //数据模式下输入二进制文件数据。 3.1.1.2. ACK 模式 ACK 模式下传输数据更可靠。在无硬件流控情况下传输大文件时，推荐开启 ACK 模式避免数据丢失。 有关 ACK 模式的详细信息，可参考 AT+QFUPL 命令。 AT+QFUPL='test.txt',3000,5,1 CONNECT A A +QFUPL: 3000,B34A //上传文本文件 test.txt 到 UFS。 //数据模式下输入 1024 字节二进制文件数据。 //在 MCU 发送 1024 字节数据后，模块会响应一个 A，然后 发送下一个 1024 字节数据。 //数据模式下输入 1024 字节二进制文件数据。 //数据模式下输入剩余二进制文件数据。 OK 上海移远通信技术股份有限公司 22 / 27 3.1.2. 下载文件 AT+QFDWL='test.txt' CONNECT +QFDWL: 10,613e OK EG512R&EM12xR&EM160R 系列 FILE 应用指导 //从 UFS 中下载文本文件 test.txt。 //数据模式下输出文件数据。 //获取已下载数据的字节数和校验和。 3.2. 写入和读取文件 3.2.1. 写入和读取 UFS 文件 AT+QFOPEN='test.txt',1 +QFOPEN: 3023 OK AT+QFWRITE=3023,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=3023,0,0 OK AT+QFREAD=3023,10 CONNECT 10 OK AT+QFCLOSE=3023 OK 3.2.2. 写入和读取 SD 文件 AT+QFOPEN='SD:1.txt',1 +QFOPEN: 3024 OK AT+QFWRITE=3024,1024 CONNECT //打开文件获取文件句柄。 //将 10 个字节写入文件。 //数据模式下写入文件数据。 //返回实际写入的字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取 10 个字节文件数据。 //数据模式下输出读取数据。 //关闭文件。 //打开文件获取文件句柄。 //将 1024 个字节写入文件。 //数据模式下写入数据。 上海移远通信技术股份有限公司 23 / 27 +QFWRITE: 1024,1024 OK AT+QFSEEK=3024,0,0 OK AT+QFREAD=3024,1024 CONNECT 1024 OK AT+QFCLOSE=3024 OK EG512R&EM12xR&EM160R 系列 FILE 应用指导 //返回实际写入的字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取 1024 个字节文件数据。 //数据模式下输出读取数据。 //关闭文件。 上海移远通信技术股份有限公司 24 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 4 错误码 表示与移动设备有关的错误码，详细信息可参考下表。下表中的错误码与本文档适用模块的文件 操作有关。 表 3：错误代码列表 错误码 400 401 402 403 405 406 407 409 410 411 413 414 416 417 418 419 420 英文含义 Invalid input value Larger than the size of the file Zero-byte read Drive full File not found Invalid file name File already exists Failed to write to the file Failed to open the file Failed to read the file Reached the max. number of files allowed to be opened Read-only file Invalid file descriptor Failed to list the file Failed to delete the file Failed to get disk info No space 中文含义 输入值无效 文件过大 读取 0 字节 驱动器已满 未发现文件 无效文件名 文件已存在 写入文件失败 打开文件失败 读取文件失败 达到允许打开的最大文件数 文件仅可读 无效文件描述符 列举文件失败 删除文件失败 获取磁盘信息失败 空间不足 上海移远通信技术股份有限公司 25 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 421 Time out 超时 423 File too large 文件过大 425 Invalid parameter 无效参数 426 File already opened 文件已打开 上海移远通信技术股份有限公司 26 / 27 EG512R&EM12xR&EM160R 系列 FILE 应用指导 5 附录 术语缩写 表 4：术语缩写 缩写 ACK COM DOS ME SD TA UART UFS USB XOR 英文全称 Acknowledgement Communication Port Disk Operating System Mobile Equipment Secure Digital Terminal Adapter Universal Asynchronous Receiver-Transmitter User File Storage Universal Serial Bus Exclusive OR 中文全称 确认消息 串行通讯端口 磁盘操作系统 移动设备 安全数字存储器 终端适配器 通用异步收发传输器 用户文件存储 通用串行总线 异或 上海移远通信技术股份有限公司 27 / 27

EG06xK&Ex120K&EM060K 系列 FILE 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-10-10 状态：受控文件 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 文档历史 修订记录 版本 1.0 日期 2022-09-09 2022-10-10 作者 Monan TIAN Monan TIAN 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 1.2. FILE AT 命令使用流程 ................................................................................................................ 7 1.3. 数据模式说明...............................................................................................................................7 2 FILE AT 命令详解 ..................................................................................................................................9 2.1. AT 命令说明 ................................................................................................................................9 2.1.1. 定义 .................................................................................................................................. 9 2.1.2. AT 命令语句 .....................................................................................................................9 2.2. AT 示例声明 ..............................................................................................................................10 2.3. AT 命令详解 ..............................................................................................................................10 2.3.1. AT+QFLDS 获取存储媒介空间信息............................................................................. 10 2.3.2. AT+QFLST 列出存储媒介中的文件信息...................................................................... 11 2.3.3. AT+QFDEL 删除存储媒介中的文件............................................................................. 13 2.3.4. AT+QFUPL 上传文件到存储媒介 ................................................................................ 14 2.3.5. AT+QFDWL 下载存储媒介中的文件............................................................................ 15 2.3.6. AT+QFOPEN 打开文件 ............................................................................................... 16 2.3.7. AT+QFREAD 读取文件 ............................................................................................... 17 2.3.8. AT+QFWRITE 写入数据至文件................................................................................... 18 2.3.9. AT+QFSEEK 设置文件指针位置 ................................................................................. 19 2.3.10. AT+QFPOSITION 获取文件指针偏移量 ...................................................................... 20 2.3.11. AT+QFCLOSE 关闭文件 ............................................................................................. 20 3 举例 ...................................................................................................................................................... 22 3.1. 上传或下载文件 ......................................................................................................................... 22 3.1.1. 上传文件 ......................................................................................................................... 22 3.1.1.1. 无 ACK 模式 ....................................................................................................... 22 3.1.1.2. ACK 模式 ............................................................................................................ 22 3.1.2. 下载文件 ......................................................................................................................... 23 3.2. 写入和读取文件 ......................................................................................................................... 23 3.2.1. 写入和读取 UFS 文件 ..................................................................................................... 23 3.2.2. 写入和读取 SD 文件 ....................................................................................................... 23 4 错误码 .................................................................................................................................................. 25 5 附录 术语缩写......................................................................................................................................27 上海移远通信技术股份有限公司 4 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令类型 ....................................................................................................................................... 9 表 3：错误代码列表.................................................................................................................................... 25 表 4：术语缩写 ........................................................................................................................................... 27 上海移远通信技术股份有限公司 5 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 1 引言 移远通信 LTE-A 模块 EG060K 系列、EG065K 系列、EG120K 系列、EM120K-GL 和 EM060K 系列支 持通过 AT 命令操作不同物理存储媒介的文件，本文档为用于操作文件的 AT 命令应用指导。 模块支持的物理存储媒介如下：  UFS: 用户文件存储目录，它是闪存文件系统上的一个特殊目录。  SD: SD 卡目录。 备注 1. 命令参数 （文件名称）包含存储位置。若以'UFS:'为前缀或无前缀，则表示文件被存 储在 UFS 中；若以'SD:'为前缀，则表示文件被存储在 SD 卡中。 2. 适用模块中，EM120K-GL 和 EM060K 系列模块均不支持 SD 存储媒介。 1.1. 适用模块 表 1：适用模块 适用模块 EG06xK Ex120K EM060K EG060K 系列 EG065K 系列 EG120K 系列 EM120K-GL EM060K 系列 上海移远通信技术股份有限公司 6 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 1.2. FILE AT 命令使用流程 用户可以参照以下步骤在存储媒介中上传/下载、打开/创建、及读取/写入文件： 1. 通过 AT+QFUPL 上传文件至存储媒介，然后执行 AT+QFDWL 通过串行接口输出/下载文件。 2. 使用 AT+QFOPEN 打开文件后，可写入或读取此文件，直到文件被 AT+QFCLOSE 关闭。  使用 AT+QFOPEN 打开文件时，可以通过参数将文件设置为覆盖模式、只读模式或 其他模式（有关更多信息，可参考第 2.3.6 章）。打开文件后，会分配， 之后可以通过操作文件。  文 件 打 开 后 ， 可 从 当 前 文 件 指 针 位 置 通 过 AT+QFWRITE 写 入 数 据 至 文 件 ， 或 通 过 AT+QFREAD 读取文件数据。  用户可通过 AT+QFSEEK 设置文件指针位置，或执行 AT+QFPOSITION 查询当前文件指针 位置。  AT+QFCLOSE 用来关闭文件，文件关闭后，失效。 用户可以通过以下几个命令管理存储媒介中的文件： 1. AT+QFLDS 获取存储媒介空间信息。 2. AT+QFLST 列出存储媒介中的文件信息。 3. AT+QFDEL 删除存储媒介中的文件。 备注 AT+QFOPEN 执行后获取的文件句柄，在使用完成后要及时用 AT+QFCLOSE 关闭，否则会造成句柄泄 露。 1.3. 数据模式说明 模块的 COM 口有两种工作模式，一是 AT 命令模式，另一种为数据模式。AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。  进入数据模式 执行 AT+QFUPL、AT+QFDWL、AT+QFREAD 或 AT+QFWRITE 后，模块响应 CONNECT， COM 口进入数据模式。或执行 ATO 重新进入数据模式。 上海移远通信技术股份有限公司 7 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导  退出数据模式 用户可以通过输入+++使 COM 口退出数据模式。在退出数据模式及返回响应之前，模块会中断进 入数据模式命令的执行，在此情况下，COM 口无法通过执行 ATO 重新进入数据模式。 为防止+++被误认为是数据，用户应遵循以下要求： 1. 输入+++前 1 秒内不能输入其它任何数据； 2. 必须在 1 秒内输入+++，并且不能输入其它任何数据。 3. 输入+++后，等待模块响应 OK。响应 OK 表示 COM 口退出数据模式。 上海移远通信技术股份有限公司 8 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 2 FILE AT 命令详解 2.1. AT 命令说明 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QFLDS 获取存储媒介空间信息 该命令用于获取指定存储媒介的空间信息。 AT+QFLDS 获取存储媒介空间信息 测试命令 AT+QFLDS=? 设置命令 AT+QFLDS= 响应 OK 响应 +QFLDS: , OK 执行命令 AT+QFLDS 若有任何错误： +CME ERROR: 响应 返回 UFS 空间信息： +QFLDS: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。存储媒介类型。 'UFS' UFS 'SD' SD 卡 上海移远通信技术股份有限公司 10 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 整型。的可用空间。单位：字节。 整型。的总空间。单位：字节。 整型。UFS 中所有文件大小。单位：字节。 整型。UFS 中的文件数量。 整型。错误码。详见第 4 章。 举例 AT+QFLDS='UFS' +QFLDS: 578847,917503 OK AT+QFLDS='SD' +QFLDS: 251920384,253132800 OK //查询 UFS 的空间信息。 //查询 SD 卡的空间信息。 2.3.2. AT+QFLST 列出存储媒介中的文件信息 该命令列出指定存储媒介中的单个或所有文件信息。 AT+QFLST 列出存储媒介中的文件信息 测试命令 AT+QFLST=? 设置命令 AT+QFLST= 响应 OK 响应 +QFLST: , [+QFLST: , […]] OK 执行命令 AT+QFLST 若有任何错误： +CME ERROR: 响应 返回存储在 UFS 中所有文件的空间信息： +QFLST: , [+QFLST: , […]] OK 若有任何错误： +CME ERROR: 上海移远通信技术股份有限公司 11 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。列出文件的名称类型。最大长度为 80 字节。 '*' 列出 UFS 中所有文件 '' 列出 UFS 中指定的文件 'UFS:*' 列出 UFS 中所有文件 'UFS:' 列出 UFS 中指定的文件 'SD:*' 列出 SD 卡中所有文件 'SD:' 列出 SD 卡中指定的文件 字符串类型。文件的具体名称。 整型。文件大小。单位：字节。 整型。错误码。详见第 4 章。 举例 AT+QFLST='*' +QFLST: 'UFS:1k.txt',1024 +QFLST: 'UFS:2k.txt',2048 +QFLST: 'UFS:3k.txt',3072 OK AT+QFLST='SD:*' +QFLST: 'SD:1k.txt',1024 +QFLST: 'SD:10k.txt',10240 +QFLST: 'SD:100k.txt',102400 OK //列出 UFS 中的所有文件。 //列出 SD 卡中的所有文件。 备注 AT+QFLST 用于查询当前存储在 Flash 中的文件的实际大小。当使用 AT+QFWRITE 写入数据后，若执 行 AT+QFLST 查询不成功，使用 AT+QFCLOSE 关闭当前文件后再次查询。 上海移远通信技术股份有限公司 12 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 2.3.3. AT+QFDEL 删除存储媒介中的文件 该命令用于删除指定存储媒介中的单个或所有文件。 AT+QFDEL 删除存储媒介中的文件 测试命令 AT+QFDEL=? 响应 +QFDEL: 设置命令 AT+QFDEL= OK 响应 OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。将删除文件的名称类型。最大长度为 80 字节。 '*' 删除 UFS 中所有文件（不删除目录） '' 删除 UFS 中指定的文件 'UFS:*' 删除 UFS 中所有文件（不删除目录） 'UFS:' 删除 UFS 中指定的文件 'SD:*' 删除 SD 卡中所有文件（不删除目录） 'SD:' 删除 SD 卡中指定的文件 字符串类型。文件的具体名称。 整型。错误码。详见第 4 章。 举例 AT+QFDEL='*' OK AT+QFDEL='UFS:1.txt' OK AT+QFDEL='SD:*' OK //删除 UFS 中所有文件（不删除目录）。 //删除 UFS 中的 1.txt 文件。 //删除 SD 卡中所有文件（不删除目录）。 上海移远通信技术股份有限公司 13 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 2.3.4. AT+QFUPL 上传文件到存储媒介 该命令用于上传文件到存储媒介，若上传的文件与存储媒介中的文件同名，则会上报错误。 当上传的文件大小达到，或无数据输入的时间达到，模块会自动退出数据模式。 数据传输期间，用户可以通过输入+++使之退出数据模式，更多相关信息，可参考第 1.3 章。 有 关 该 命 令 的 Linux 用 例 ， 请 参 考 quec_upload.zip 包 ； 有 关 用 例 的 使 用 方 法 介 绍 ， 请 参 考 quec_upload.zip 中的 Readme 文件。请联系移远通信技术支持获取 quec_upload.zip 包。 AT+QFUPL 上传文件到存储媒介 测试命令 AT+QFUPL=? 响应 +QFUPL: ,(1-),(支持的范 围),(支持的列表) OK 设置命令 AT+QFUPL=[,[, [,]]] 响应 CONNECT TA 切换为数据模式（即透传模式），可输入二进制文件数据。 当输入数据的总大小达到或 TA 接收到+++时，TA 将切换回命令模式： +QFUPL: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。的可用空间。有关的详细信息，请参考第 2.3.1 章。 字符串类型。上传文件的名称类型。最大长度为 80 字节。 '' 上传至 UFS 中的文件 'UFS:' 上传至 UFS 中的文件 'SD:' 上传至 SD 卡中的文件 字符串类型。文件的具体名称。 整型。预计上传的文件大小。默认值：10240；单位：字节。该参数最大值应不超过 。 整型。实际上传的文件大小。单位：字节。 上海移远通信技术股份有限公司 14 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 整型。通过 USB/UART 输入数据的等待时间。范围：1~65535；默认值：5；单位：秒。 整型。是否使用 ACK 模式。 0 关闭 ACK 模式 1 开启 ACK 模式 整型。上传数据的校验和。 整型。错误码。详见第 4 章。 备注 1. 推荐使用 DOS 8.3 文件名格式。 2. 是基于异或的 16 位校验和。 如果字节数为奇数，则最后一个字节设置为高 8 位，低 8 位设置为 0，然后使用 XOR 运算符计算校 验和。+++可使 TA 结束数据传输并切换到命令模式。之前上传的数据将保留在文件中。 3. 执行命令时，必须在返回 CONNECT 后输入数据。 4. 在硬件流控制不起作用时，ACK 模式可避免在上传大文件时数据丢失。ACK 模式的工作原理如下： 1) 运行 AT+QFUPL=,,,1 启用 ACK 模式。 2) 模块输出 CONNECT。 3) MCU 发送 1 KB 数据，模块响应一个 A。 4) MCU 接收 A，然后发送下一个 1 KB 数据。 5) 重复第 3) 和 4) 步骤，直到传输完成。 有关 ACK 模式的示例，详见第 3.1.1.2 章。 2.3.5. AT+QFDWL 下载存储媒介中的文件 该命令用于从存储媒介中下载指定的文件。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFDWL 下载存储媒介中的文件 测试命令 AT+QFDWL=? 响应 +QFDWL: 设置命令 AT+QFDWL= OK 响应 CONNECT TA 切换为数据模式，可输出文件二进制数据。文件下载完成或 TA 接收到+++时，TA 将切换回命令模式： +QFDWL: , OK 若有任何错误： +CME ERROR: 上海移远通信技术股份有限公司 15 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。下载文件的名称类型。最大长度为 80 个字节。 '' 下载的 UFS 文件 'UFS:' 下载的 UFS 文件 'SD:' 下载的 SD 卡文件 字符串类型。文件的具体名称。 整型。已下载数据的大小。 整型。已下载数据的校验和。 整型。错误码。详见第 4 章。 备注 1. +++序列会使 TA 结束命令并切换到命令模式。 2. 是基于异或的 16 位校验和。 2.3.6. AT+QFOPEN 打开文件 该命令用于打开文件并获取命令中使用的文件句柄，相关命令为 AT+QFREAD、AT+QFWRITE、 AT+QFSEEK、AT+QFPOSITION 和 AT+QFCLOSE。 AT+QFOPEN 打开文件 测试命令 AT+QFOPEN=? 响应 +QFOPEN: ,(支持的范围) 查询命令 AT+QFOPEN? OK 响应 +QFOPEN: ,, [+QFOPEN: ,, […]] 设置命令 AT+QFOPEN=[,] OK 响应 +QFOPEN: OK 上海移远通信技术股份有限公司 16 / 27 最大响应时间 特性说明 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。打开的文件名称。最大长度为 80 字节。 '' 打开的 UFS 文件 'UFS:' 打开的 UFS 文件 'SD:' 打开的 SD 卡文件 字符串类型。文件的具体名称。 整型。文件句柄。 整型。文件的打开模式。 0 若文件不存在，则会创建一个新文件；若文件存在，则直接打开文件。两种情 况中的文件皆可读写。 1 若文件不存在，则会创建一个新文件；若文件存在，则清除并覆盖文件。两种 情况中的文件皆可读写。 2 若文件不存在，则响应错误；若文件存在，则作为只读文件直接打开。 整型。错误码。详见第 4 章。 2.3.7. AT+QFREAD 读取文件 该命令用于读取由文件句柄指定的文件数据。数据从文件指针的当前位置开始读取，文件指针属于文 件句柄。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFREAD 读取文件 测试命令 AT+QFREAD=? 响应 +QFREAD: , 设置命令 AT+QFREAD=[,] OK 响应 CONNECT TA 切换到数据模式，当数据总大小超过或 TA 接收 到+++时，TA 将切换回命令模式： OK 若有任何错误： 上海移远通信技术股份有限公司 17 / 27 最大响应时间 特性说明 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。预计读取的文件长度。默认长度为 10 KB，若文件长度不足 10 KB，则读取 文件的实际长度。单位：字节。 整型。实际读取的文件长度。单位：字节。 整型。错误码。详见第 4 章。 2.3.8. AT+QFWRITE 写入数据至文件 该命令可将数据写入到文件。数据从文件指针的当前位置开始写入，文件指针属于文件句柄。 有关该命令的 Linux 用例，请参考 AT+QFUPL 的 Linux 用例。 AT+QFWRITE 写入数据至文件 测试命令 AT+QFWRITE=? 响应 +QFWRITE: ,, 设置命令 AT+QFWRITE=[,[,]] OK 响应 CONNECT TA 切换到数据模式。当写入数据的总大小超过、TA 接收到+++或写入时间超过，TA 将切换回命令模式： +QFWRITE: , OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 18 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 参数 整型。需要操作的文件句柄。 整型。预计写入文件的长度。默认长度为 10 KB，此参数的最大值由 AT+QFUPL 的决定。单位：字节。 整型。通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒。 整型。实际写入数据的长度。单位：字节。 整型。文件总长度。单位：字节。 整型。错误码。详见第 4 章。 2.3.9. AT+QFSEEK 设置文件指针位置 该 命 令 可 设 置 文 件 指 针 到 指 定 的 位 置 ， 相 关 命 令 为 AT+QFREAD 、 AT+QFWRITE 和 AT+QFPOSITION。 AT+QFSEEK 设置文件指针位置 测试命令 AT+QFSEEK=? 响应 +QFSEEK: ,, 设置命令 AT+QFSEEK=,[, ] OK 响应 OK 若有任何错误： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。文件指针移动的字节数。 整型。文件指针移动模式。 0 文件初始位置向后移动 1 文件指针当前位置向后移动 2 文件结尾位置向前移动 整型。错误码。详见第 4 章。 上海移远通信技术股份有限公司 19 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 备注 若设置的最终指针位置超过文件范围，执行此命令会返回 ERROR。 2.3.10. AT+QFPOSITION 获取文件指针偏移量 该命令可从文件初始位置获取文件指针的偏移量。 AT+QFPOSITION 获取文件指针偏移量 测试命令 AT+QFPOSITION=? 响应 +QFPOSITION: 设置命令 AT+QFPOSITION= OK 响应 +QFPOSITION: OK 最大响应时间 特性说明 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。从初始位置起文件指针的偏移量。 整型。错误码。详见第 4 章。 2.3.11. AT+QFCLOSE 关闭文件 该命令用于关闭文件或结束对文件的操作。关闭文件后，文件句柄会被释放。除非通过 AT+QFOPEN 再次打开文件，否则不可再次使用文件句柄。 AT+QFCLOSE 关闭文件 测试命令 AT+QFCLOSE=? 响应 +QFCLOSE: OK 上海移远通信技术股份有限公司 20 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 设置命令 AT+QFCLOSE= 最大响应时间 特性说明 响应 OK 若有任何错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。需要操作的文件句柄。 整型。错误码。详见第 4 章。 上海移远通信技术股份有限公司 21 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 3 举例 3.1. 上传或下载文件 3.1.1. 上传文件 3.1.1.1. 无 ACK 模式 AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK //上传文本文件 test1.txt 到 UFS。 //数据模式下输入二进制文件数据。 3.1.1.2. ACK 模式 ACK 模式下传输数据更可靠。在无硬件流控情况下传输大文件时，推荐开启 ACK 模式避免数据丢失。 有关 ACK 模式的详细信息，可参考 AT+QFUPL 命令。 AT+QFUPL='test.txt',3000,5,1 CONNECT A A +QFUPL: 3000,B34A //上传文本文件 test.txt 到 UFS。 //数据模式下输入 1024 字节二进制文件数据。 //在 MCU 发送 1024 字节数据后，模块会响应一个 A，然后 发送下一个 1024 字节数据。 //数据模式下输入 1024 字节二进制文件数据。 //数据模式下输入剩余二进制文件数据。 OK 上海移远通信技术股份有限公司 22 / 27 3.1.2. 下载文件 AT+QFDWL='test.txt' CONNECT +QFDWL: 10,613e OK EG06xK&Ex120K&EM060K 系列 FILE 应用指导 //从 UFS 中下载文本文件 test.txt。 //数据模式下输出文件数据。 //获取已下载数据的字节数和校验和。 3.2. 写入和读取文件 3.2.1. 写入和读取 UFS 文件 AT+QFOPEN='test.txt',1 +QFOPEN: 3023 OK AT+QFWRITE=3023,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=3023,0,0 OK AT+QFREAD=3023,10 CONNECT 10 OK AT+QFCLOSE=3023 OK 3.2.2. 写入和读取 SD 文件 AT+QFOPEN='SD:1.txt',1 +QFOPEN: 3024 OK AT+QFWRITE=3024,1024 CONNECT //打开文件获取文件句柄。 //将 10 个字节写入文件。 //数据模式下写入文件数据。 //返回实际写入的字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取 10 个字节文件数据。 //数据模式下输出读取数据。 //关闭文件。 //打开文件获取文件句柄。 //将 1024 个字节写入文件。 //数据模式下写入数据。 上海移远通信技术股份有限公司 23 / 27 +QFWRITE: 1024,1024 OK AT+QFSEEK=3024,0,0 OK AT+QFREAD=3024,1024 CONNECT 1024 OK AT+QFCLOSE=3024 OK EG06xK&Ex120K&EM060K 系列 FILE 应用指导 //返回实际写入的字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取 1024 个字节文件数据。 //数据模式下输出读取数据。 //关闭文件。 上海移远通信技术股份有限公司 24 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 4 错误码 表示与移动设备有关的错误码，详细信息可参考下表。下表中的错误码与本文档适用模块的文件 操作有关。 表 3：错误代码列表 错误码 400 401 402 403 405 406 407 409 410 411 413 414 416 417 418 419 420 英文含义 Invalid input value Larger than the size of the file Zero-byte read Drive full File not found Invalid file name File already exists Failed to write to the file Failed to open the file Failed to read the file Reached the max. number of files allowed to be opened Read-only file Invalid file descriptor Failed to list the file Failed to delete the file Failed to get disk info No space 中文含义 输入值无效 文件过大 读取 0 字节 驱动器已满 未发现文件 无效文件名 文件已存在 写入文件失败 打开文件失败 读取文件失败 达到允许打开的最大文件数 文件仅可读 无效文件描述符 列举文件失败 删除文件失败 获取磁盘信息失败 空间不足 上海移远通信技术股份有限公司 25 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 421 Time out 超时 423 File too large 文件过大 425 Invalid parameter 无效参数 426 File already opened 文件已打开 上海移远通信技术股份有限公司 26 / 27 EG06xK&Ex120K&EM060K 系列 FILE 应用指导 5 附录 术语缩写 表 4：术语缩写 缩写 ACK COM DOS ME SD TA UART UFS USB XOR 英文全称 Acknowledgement Communication Port Disk Operating System Mobile Equipment Secure Digital Terminal Adapter Universal Asynchronous Receiver-Transmitter User File Storage Universal Serial Bus Exclusive OR 中文全称 确认消息 串行通讯端口 磁盘操作系统 移动设备 安全数字存储器 终端适配器 通用异步收发传输器 用户文件存储 通用串行总线 异或 上海移远通信技术股份有限公司 27 / 27

BG95&BG77&BG600L Series Voice Application Note LPWA Module Series Version: 1.0 Date: 2022-09-30 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_Voice_Application_Note 1 / 43 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Series_Voice_Application_Note 2 / 43 LPWA Module Series About the Document Revision History Version 1.0 Date 2022-06-01 2022-09-30 Author Nora HE Nora HE Description Creation of the document First official release BG95&BG77&BG600L_Series_Voice_Application_Note 3 / 43 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 Introduction ......................................................................................................................................... 8 1.1. Applicable Modules and Supported Voice Feature ................................................................... 8 2 General Overview of IMS and VoLTE................................................................................................ 9 2.1. Introduction to IMS Features...................................................................................................... 9 2.1.1. Supported Features ........................................................................................................ 9 2.1.2. Features Not Supported.................................................................................................. 9 2.2. Introduction to VoLTE Call Flow............................................................................................... 10 2.2.1. Prerequisite for VoLTE Call ........................................................................................... 10 2.2.2. Process of VoLTE Call .................................................................................................. 10 3 AT Command Introduction .............................................................................................................. 12 3.1. AT Command Introduction ....................................................................................................... 12 3.1.1. Definitions...................................................................................................................... 12 3.1.2. AT Command Syntax .................................................................................................... 12 3.1.3. Declaration of AT Command Examples ........................................................................ 13 4 AT Command Description................................................................................................................ 14 4.1. AT+QCFG='ims' Query IMS Registration State ................................................................... 14 4.2. ATD Originate a Call.............................................................................................................. 15 4.3. ATA Answer an Incoming Call ............................................................................................... 17 4.4. ATH Disconnect Existing Connection.................................................................................... 18 4.5. AT+CVHU Voice Call Hang Up Control................................................................................. 19 4.6. AT+CLCC List Current Calls of ME ....................................................................................... 20 4.7. AT+CHUP Hang up a Call ..................................................................................................... 21 4.8. AT+QIIC Read/ Write Codec Through IIC ............................................................................. 22 4.9. AT+QDAI Configure Digital Audio Interface .......................................................................... 23 4.10. AT+CLVL Configure Loudspeaker Volume............................................................................ 24 4.11. AT+CMUT Muting Control ..................................................................................................... 25 4.12. AT+QPCMCFG Configure PCM Interface............................................................................. 26 4.13. AT+QLDTMF Play Local DTMF ............................................................................................ 28 4.14. AT+VTS DTMF and Tone Generation ................................................................................... 29 4.15. AT+QTONEDET Enable/Disable DTMF Detection ............................................................... 30 4.16. AT+QAUDLOOP Enable/Disable Audio Loop Test ............................................................... 31 4.17. AT+QINDCFG Configure URC Indication ............................................................................. 32 5 Description of URCs ......................................................................................................................... 35 5.1. RING URC ............................................................................................................................... 35 5.2. Alert URC ................................................................................................................................. 35 BG95&BG77&BG600L_Series_Voice_Application_Note 4 / 43 LPWA Module Series 6 Issue Analysis ................................................................................................................................... 36 6.1. Direction-Related Problem Analysis ........................................................................................ 37 6.2. Protocol-Related Problem Analysis ......................................................................................... 37 6.2.1. VoLTE Issue Analysis .................................................................................................... 38 6.2.2. CS-Voice over GSM Issue Analysis .............................................................................. 38 7 Appendix A References.................................................................................................................... 40 8 Appendix B Summary of CME ERROR Codes............................................................................... 42 BG95&BG77&BG600L_Series_Voice_Application_Note 5 / 43 LPWA Module Series Table Index Table 1: Applicable Modules and Supported Voice Feature ....................................................................... 8 Table 2: Types of AT Commands .............................................................................................................. 12 Table 3: Related Document........................................................................................................................ 40 Table 4: Terms and Abbreviations .............................................................................................................. 40 Table 5: Different Coding Schemes of +CME ERROR: ................................................................... 42 BG95&BG77&BG600L_Series_Voice_Application_Note 6 / 43 LPWA Module Series Figure Index Figure 1: VoLTE Call Flow...........................................................................................................................11 Figure 2: Data Path of AFE Loopback ....................................................................................................... 31 Figure 3: Voice Flow................................................................................................................................... 36 Figure 4: Poor Network Condition in VoLTE .............................................................................................. 38 Figure 5: Poor Channel Condition in CS-Voice (1) .................................................................................... 39 Figure 6: Poor Channel Condition in CS-Voice (2) .................................................................................... 39 BG95&BG77&BG600L_Series_Voice_Application_Note 7 / 43 LPWA Module Series 1 Introduction This document introduces the application of VoLTE and describes the related AT commands of VoLTE, CS voice over GSM (2G) and audio services on Quectel BG95 series, BG77 and BG600L-M3 modules. 1.1. Applicable Modules and Supported Voice Feature Table 1: Applicable Modules and Supported Voice Feature Module Series Module BG95-M1 Supported Network Cat M1 only Supported Voice Feature VoLTE BG95-M2 Cat M1/Cat NB2 VoLTE BG95 BG95-M3 Cat M1/Cat NB2/EGPRS VoLTE/CS voice BG95-M5 Cat M1/Cat NB2/EGPRS, Power Class 3 VoLTE/CS voice BG95-M6 Cat M1/Cat NB2, Power Class 3 VoLTE BG77 BG77 Cat M1/Cat NB2 VoLTE BG600L BG600L-M3 Cat M1/Cat NB2/EGPRS VoLTE/CS voice BG95&BG77&BG600L_Series_Voice_Application_Note 8 / 43 LPWA Module Series 2 General Overview of IMS and VoLTE 2.1. Introduction to IMS Features The IP Multimedia Subsystem (IMS) is an architectural framework for delivering IP multimedia services. 2.1.1. Supported Features The following features are supported in IMS: ⚫ LTE RAT ⚫ Power-saving mode ⚫ IMS registration with or without IPsec ⚫ Single VoLTE call ⚫ SIP forking (up to seven dialogs) ⚫ Audio codecs: AMR-NB, DTMF ⚫ QoS and preconditions ⚫ SMS over IMS in 3GPP format only 2.1.2. Features Not Supported The following features are currently not supported in IMS: ⚫ Emergency call ⚫ Multi-call, such as conference call, call transfer and call pulling ⚫ SRVCC and CSFB ⚫ Audio codecs: EVS, AMR-WB, and G.711 ⚫ VoLTE for internet-connected endpoint (VICE) ⚫ DAN ⚫ Video call, RTT, and TTY ⚫ MWI ⚫ IWLAN ⚫ RCS or Presence BG95&BG77&BG600L_Series_Voice_Application_Note 9 / 43 LPWA Module Series 2.2. Introduction to VoLTE Call Flow VoLTE (Voice over Long-Term Evolution) is based on the IP Multimedia Subsystem (IMS) network, and uses special configuration files for the control and media planes. This enables voice services (at the control and media levels) to be transmitted as data streams over LTE data bearer networks. VoLTE initialization procedures are required before a VoLTE session is established. 2.2.1. Prerequisite for VoLTE Call 1. Attach to LTE network and select domain (all call flows assume voice over IMS). 2. Establish IMS PDN connection and SIP QoS flow. QCI = 5 is used for SIP signaling on IMS default bearer. 3. Complete IMS registration and subscription with IMS CN. IMS feature tags for available services are MMTel IMS Communication Services Identifier (ICSI). 2.2.2. Process of VoLTE Call The steps to establish a VoLTE session with a remote party are as follows. 1. Attach to LTE network and select domain. 2. Establish IMS PDN connection and SIP QoS flow. 3. Complete IMS registration and subscription. 4. Establish IMS session. ⚫ Transmit information by SIP signaling. ⚫ Negotiate codec with SDP. 5. Establish VoLTE QoS call flow. ⚫ Implement network-initiated QoS procedure. 6. Propose ROHC negotiation. 7. Transmit full-duplex VoLTE data between UE and E-UTRA(N). ⚫ This data is routed from the E-UTRA(N) by the packet data core network to the remote party involved in the call. ⚫ Each voice frame is generated by the vocoder and carried as the payload in RTP. ⚫ RTP packets are encapsulated in UDP packets and carried over IP. 8. Terminate IMS session. ⚫ Transmit information by SIP signaling. ⚫ Release and clean up existing VoLTE call(s). 9. Release VoLTE QoS flow. ⚫ Release network-dependent QoS procedure. 10. Terminate VoLTE feature. BG95&BG77&BG600L_Series_Voice_Application_Note 10 / 43 UE E-UTRA(N)/ PDN LTE attachment + domain selection IMS PDN connection + SIP Qos flow IMS registration and subscription {Call setup IMS session establishment VoLTE Qos flow establishment ROHC negotiation VoLTE data IMS session termination VoLTE QoS flow release IMS de-registration LPWA Module Series IM/ CN VoLTE feature initialization procedures VoLTE session procedures } May be simultaneous VoLTE feature termination procedure Figure 1: VoLTE Call Flow BG95&BG77&BG600L_Series_Voice_Application_Note 11 / 43 LPWA Module Series 3 AT Command Introduction 3.1. AT Command Introduction 3.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_Voice_Application_Note 12 / 43 LPWA Module Series 3.1.3. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. BG95&BG77&BG600L_Series_Voice_Application_Note 13 / 43 LPWA Module Series 4 AT Command Description This chapter introduces the voice and audio related AT commands supported by the modules, including the functions, usages and the scope of AT commands. For some AT commands or URCs mentioned but not described in detail in this chapter, unless otherwise specified, see document [1] for more information and usage. 4.1. AT+QCFG='ims' Query IMS Registration State This command queries the module's IMS registration state. VoLTE state indicates IMS registration state, that is, VoLTE is ready indicates IMS feature is enabled. AT+QCFG='ims' Query IMS Registration State Write Command AT+QCFG='ims' Response +QCFG: 'ims', OK Or ERROR Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: 300 ms - Parameter Integer type. VoLTE state. 0 VoLTE is not ready 1 VoLTE is ready Error code. See Chapter 8 for details. Example AT+QCFG='ims' +QCFG: 'ims',1 BG95&BG77&BG600L_Series_Voice_Application_Note 14 / 43 OK NOTE This command is valid only on the firmware version supporting VoLTE. LPWA Module Series 4.2. ATD Originate a Call This command sets up outgoing voice or data call. ATD Originate a Call Execution Command ATD[][;] Response If no dial tone and ATX2 or ATX4 is set: NO DIAL TONE If busy and ATX3 or ATX4 is set: BUSY If a call connection cannot be established: NO CARRIER If a call connection is established successfully and a non-voice call is to be set up: CONNECT TA switches to data mode. is output only when is greater than 0 in ATX parameter setting. When TA returns to command mode after call release: OK Maximum Response Time Characteristics If a call connection is established successfully and a voice call is set up: OK Or ERROR 5 s, determined by the network (AT+COLP=0). - BG95&BG77&BG600L_Series_Voice_Application_Note 15 / 43 LPWA Module Series Reference V.25ter Parameter String of dialing strings and optional V.25ter modifiers. Dialing strings: 0-9, *, #, +, A, B, C Following V.25ter, optional modifiers ,(comma), T, P, !, W, @ are ignored. String of GSM modifiers: I Activates CLIR (Disable presentation of calling number to called party). i Deactivates CLIR (Enable presentation of calling number to called party). G Activates closed user group invocation for this call only. g Deactivates closed user group invocation for this call only. It is required when setting up a voice call. After the call, TA will return to command state. Example ATD10086; OK //Dial a number. NOTE 1. This command may be aborted generally by receiving an ATH command or a character during execution. It cannot be aborted during some connection establishments such as handshaking. 2. Parameters I and i can be omitted only when there is no * or # code in the dial string. 3. See ATX for details about setting result codes and call monitoring parameters. 4. For voice calls, if dialing with ATD, TA returns OK immediately either after the dialing is completed or the call is established. Otherwise, TA returns BUSY, NO DIAL TONE, or NO CARRIER. 5. Use ATD during an active voice call: ⚫ When a user originates a second voice call while there is already an active voice call, the first call will be automatically put on hold. ⚫ The current states of all calls can be easily checked at any time by AT+CLCC. See Chapter 4.6 for details. 6. Currently, supplementary services, such as COLP, CLIR or closed user group, are not supported. BG95&BG77&BG600L_Series_Voice_Application_Note 16 / 43 LPWA Module Series 4.3. ATA Answer a Call This command connects the module to an incoming voice or data call indicated by a RING URC. ATA Answer a Call Execution Command ATA Response TA sends off-hook to the remote station. In case of data call, if successfully connected: CONNECT And TA switches to data mode. Note: is output only when is greater than 0 in ATX parameter setting. When TA returns to command mode after call release: OK In case of voice call, if successfully connected: OK If no connection: NO CARRIER Or ERROR Maximum Response Time Characteristics Reference V.25ter If there is any error related to ME functionality: +CME ERROR: 90 s, determined by the network. - Parameter Error code. See Chapter 8 for details. Example RING OK ATA OK //Ring tone. //Answer the call. BG95&BG77&BG600L_Series_Voice_Application_Note 17 / 43 LPWA Module Series NOTE 1. Any additional commands on the same command line are ignored. 2. This command may be aborted generally by receiving a character during execution. It cannot be aborted during some connection establishments such as handshaking. 3. See also ATX. 4.4. ATH Disconnect Existing Connection This command disconnects and terminates existing data call or voice call. AT+CHUP is also used to disconnect voice call. See Chapter 4.7 for details. ATH Disconnect Existing Connection Execution Command ATH[] Response OK Or ERROR Maximum Response Time Characteristics Reference V.25ter If there is any error related to ME functionality: +CME ERROR: 90 s, determined by the network. - Parameter Integer type. 0 Disconnect and terminate existing call from command line. Error code. See Chapter 8 for details. Example RING OK ATH OK //Ring tone. //When AT+CVHU=0, hang up the call. BG95&BG77&BG600L_Series_Voice_Application_Note 18 / 43 LPWA Module Series 4.5. AT+CVHU Voice Call Hang Up Control This command controls whether ATH can be used to disconnect the voice call. AT+CVHU Voice Call Hang Up Control Test Command AT+CVHU=? Response +CVHU: (list of supported s) Read Command AT+CVHU? OK Response +CVHU: Write Command AT+CVHU= OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. 0 ATH can be used to disconnect the voice call. 1 ATH is ignored with the response OK returned only. Error code. See Chapter 8 for details. BG95&BG77&BG600L_Series_Voice_Application_Note 19 / 43 LPWA Module Series 4.6. AT+CLCC List Current Calls of ME The Execution Command returns the list of all voice calls of ME. If the command is executed successfully, but no call exists, then only OK is sent to TE. AT+CLCC List Current Calls of ME Test Command AT+CLCC=? Execution Command AT+CLCC Response OK Response TA returns the list of all current calls of ME. If the command is executed successfully, but no calls exists, then only OK is sent to TE. [+CLCC: ,,,,[,,[,< alpha>]]] [+CLCC: ,,,,[,,[,< alpha>]]] [...] OK Or ERROR Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: 300 ms - Parameter Integer type. Call identification number (starting with 1). See 3GPP TS 22.030 subclause 6.5.5.1 for details. Integer type. 0 Mobile originated (MO) call 1 Mobile terminated (MT) call Integer type. Call state. 0 Active 1 Held 2 Dialing (MO call) 3 Alerting (MO call) 4 Incoming (MT call) 5 Waiting (MT call) Integer type. Bearer/teleservice. 0 Voice BG95&BG77&BG600L_Series_Voice_Application_Note 20 / 43 LPWA Module Series 1 Data 2 Fax Integer type. 0 Call is not one of the multiparty (conference) call parties 1 Call is one of the multiparty (conference) call parties String type. Phone number in format specified by . Integer type. Address type in octet format (See 3GPP TS 24.008 subclause 10.5.4.7 for details). Usually, it has three values: 129 Unknown type 145 International type (contains character '+') 161 National type Alphanumeric representation of corresponding to the entry found in phonebook. Error code. See Chapter 8 for details. Example ATD10086; //Dial a number. OK AT+CLCC +CLCC: 2,0,0,0,0,'10086',129 //Dial a number, and the call has been answered. OK 4.7. AT+CHUP Hang up a Call This command cancels any voice call in the state of Active, Waiting or Held. To cancel data call, use ATH. See Chapter 4.4 for details. AT+CHUP Hang up a Call Test Command AT+CHUP=? Execution Command AT+CHUP Response OK Response OK Or ERROR Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: 90 s, determined by the network. - BG95&BG77&BG600L_Series_Voice_Application_Note 21 / 43 Reference 3GPP 27.007 Parameter Error code. See Chapter 8 for details. Example RING AT+CHUP OK //Ring tone. //Hang up the call. LPWA Module Series 4.8. AT+QIIC Read/ Write Codec Through IIC This command reads and writes the codec through the IIC interface. AT+QIIC Read/ Write Codec Through IIC Test Command AT+QIIC=? Response +QIIC: (list of supported s),(range of supported s),(range of supported s),(list of supported s),(range of supported s) Write Command AT+QIIC=,,,[,] OK Response If =0, all configuration parameters are specified: OK If =1, is omitted: +QIIC: Maximum Response Time Characteristics OK Or ERROR 300 ms The command takes effect immediately. The configurations are not saved. BG95&BG77&BG600L_Series_Voice_Application_Note 22 / 43 LPWA Module Series Parameter Integer type. 0 Write codec through IIC 1 Read codec through IIC Hexadecimal integer type with prefix '0x'. 7-bit slave device address (address of ALC5616: 0x1B; address of NAU8814, NAU88C10: 0x1A, TLV320AIC3104: 0x18 and MAX9860: 0x10). Range: 0–0xFF. Hexadecimal integer type with prefix '0x'. Register address. Range: 0–0xFF. Integer type. Length of the read or write byte(s). Value: 1, 2. Hexadecimal integer type with prefix '0x'. Data value. Range: 0–0xFFFF. Example AT+QIIC=1,0x1B,0x00,2 +QIIC: 0x0021 //Read register value; slave device address: 0x1B; register address: 0x00; read two bytes. OK AT+QIIC=0,0x1B,0x00,2,0x0000 OK //Write register value; slave device address: 0x1B; register address: 0x00; write two bytes; data value: 0x0000. NOTE is 7-bit slave device address (read or write bit not included), which can be found in the device datasheet. 4.9. AT+QDAI Configure Digital Audio Interface This command configures the digital audio interface. AT+QDAI Configure Digital Audio Interface Test Command AT+QDAI=? Response +QDAI: (list of supported s) Read Command AT+QDAI? OK Response +QDAI: OK BG95&BG77&BG600L_Series_Voice_Application_Note 23 / 43 LPWA Module Series Write Command AT+QDAI= Maximum Response Time Characteristics Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Analog input and output (for audio codec NAU88C10) 1 Analog input and output (for audio codec NAU8814) 2 Analog input and output (for audio codec ALC5616) 3 Analog input and output (for audio codec TLV320AIC3104) 4 Analog input and output (for audio codec MAX9860) 99 Close all external codecs. Example AT+QDAI=? +QDAI: (0-4,99) OK AT+QDAI? +QDAI: 1 OK AT+QDAI=2 OK //Query the current interface configuration. //Set the analog output to ALC5616. 4.10. AT+CLVL Configure Loudspeaker Volume This command configures the volume of the internal loudspeaker of the MT. AT+CLVL Configure Loudspeaker Volume Test Command AT+CLVL=? Response +CLVL: (range of supported s) Read Command OK Response BG95&BG77&BG600L_Series_Voice_Application_Note 24 / 43 LPWA Module Series AT+CLVL? Write Command AT+CLVL= Maximum Response Time Characteristics +CLVL: OK Response OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Volume level with manufacturer specific range (Smallest value represents the lowest sound level). Range: 0–5. Default value: 3. Example AT+CLVL=? +CLVL: (0-5) OK AT+CLVL? +CLVL: 3 OK AT+CLVL=2 OK //Query the current volume level. //Set the volume level to 2. 4.11. AT+CMUT Muting Control This command enables or disables muting in the Tx/Rx direction during a voice call. AT+CMUT Muting Control Test Command AT+CMUT=? Response +CMUT: (list of supported s),(list of supported s) Write Command OK Response BG95&BG77&BG600L_Series_Voice_Application_Note 25 / 43 LPWA Module Series AT+CMUT=, Maximum Response Time Characteristics OK Or ERROR 300 ms The command takes effect immediately. The configurations are not saved and must be set during the call. Parameter Integer type. 0 Tx direction 1 Rx direction Integer type 0 Mute off 1 Mute on Example AT+CMUT=? +CMUT: (0,1),(0,1) OK AT+CMUT=1,1 OK //Mute on in Rx direction. 4.12. AT+QPCMCFG Configure PCM Interface This command configures the PCM interface. AT+QPCMCFG Configure PCM Interface Test Command AT+QPCMCFG=? Response +QPCMCFG: (list of supported s),(range of supported s),(range of supported s),(list of supported s) Read Command AT+QPCMCFG? OK Response +QPCMCFG: ,,, BG95&BG77&BG600L_Series_Voice_Application_Note 26 / 43 LPWA Module Series OK Write Command AT+QPCMCFG=,,, Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect after re-running voice call. The configurations are saved automatically. Parameter Integer type. 0 Short frame sync 1 Long frame sync Integer type. Bits width per frame. 0 8 bits (not supported currently) 1 16 bits (not supported currently) 2 32 bits 3 64 bits 4 128 bits 5 256 bits Integer type. Quant type in PCM format. 0 A-law no padding 1 Mu-law no padding 2 linear no padding (supported only) 3 A-law padding 4 Mu-law padding 5 linear padding Integer type. 1 16-bit PCM (supported only) 2 24-bit PCM 4 32-bit PCM Example AT+QPCMCFG=? +QLDTMF: (0,1),(0-5),(0-5),(1,2,4) OK AT+QPCMCFG=1,5,2,1 OK //Configure the PCM interface. BG95&BG77&BG600L_Series_Voice_Application_Note 27 / 43 LPWA Module Series NOTE Default: 2.048 MHz BCLK, 8 KHz (supported only) sampling rate, audio PCM only in master mode. 4.13. AT+QLDTMF Play Local DTMF This command plays a local DTMF tone. AT+QLDTMF Play Local DTMF Test Command AT+QLDTMF=? Response +QLDTMF: (list of supported s),(range of supported s),(range of supported s) Write Command AT+QLDTMF=, , OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configurations are not saved. Parameter String type. DTMF character. Range: 0–9, A–D, *, #. Integer type. DTMF tone play time duration. Range: 0–65535. Integer type. DTMF tone play volume gain. Range: 0–65535. Example AT+QLDTMF=? +QLDTMF: (0-9,A-D,*,#),(0-65535),(0-65535) OK AT+QLDTMF=2,200,200 OK //Play '2' DTMF tone whose volume gain is 200 for 200 ms. BG95&BG77&BG600L_Series_Voice_Application_Note 28 / 43 LPWA Module Series 4.14. AT+VTS DTMF and Tone Generation This command sends ASCII characters which cause MSC to transmit DTMF tones to a remote subscriber. This command can only be executed in a voice call. AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (list of supported s) Execution Command AT+VTS= OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP 27.007 If there is an error related to ME functionality: +CME ERROR: 300 ms - Parameter String type. DTMF character. Range: 0–9, A–D. *, #. Error code. See Chapter 8 for details. Example ATD12345678900; OK //Call connects. AT+VTS=1 OK //Dial. //The remote caller can hear the DTMF tone. NOTE This command cannot send multiple tones at one time. BG95&BG77&BG600L_Series_Voice_Application_Note 29 / 43 LPWA Module Series 4.15. AT+QTONEDET Enable/Disable DTMF Detection This command enables or disables DTMF detection during CS voice or VoLTE call. If this function is enabled, DTMF tones sent by the other side are detected and reported on the assigned serial port. AT+QTONEDET Enable/Disable DTMF Detection Test Command AT+QTONEDET=? Response +QTONEDET: (list of supported s) Read Command AT+QTONEDET? OK Response +QTONEDET: Write Command AT+QTONEDET= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Enable or disable DTMF detection. 0 Disable 1 Enable Example AT+QTONEDET=? +QTONEDET: (0,1) OK AT+QTONEDET=1 OK //Enable DTMF detection. BG95&BG77&BG600L_Series_Voice_Application_Note 30 / 43 NOTE DTMF characters - ASCII DTMF 0 1 2 3 4 5 6 7 ASCII 48 49 50 51 52 53 54 55 DTMF 8 9 A B C D * # LPWA Module Series ASCII 56 57 65 66 67 68 42 35 4.16. AT+QAUDLOOP Enable/Disable Audio Loop Test This command enables or disables the audio loop test. AFE loopback is supported to verify the audio hardware connection, as shown in the following figure. TX AFE RX Codec Microphone Speaker Figure 2: Data Path of AFE Loopback AT+QAUDLOOP Enable/Disable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (list of supporteds) OK BG95&BG77&BG600L_Series_Voice_Application_Note 31 / 43 LPWA Module Series Write Command AT+QAUDLOOP= Maximum Response Time Characteristics Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Enable or disable audio loop test. 0 Disable audio loop test 1 Enable audio loop test Example AT+QAUDLOOP=1 //Enable audio loop test, talk into the microphone, and the earphones can hear you. OK 4.17. AT+QINDCFG Configure URC Indication This command configures the URC indication. AT+QINDCFG Configure URC Indication Test command AT+QINDCFG=? Response +QINDCFG: 'all',(list of supported s),(list of supported s) +QINDCFG: 'csq',(list of supported s),(list of supported s) +QINDCFG: 'smsfull',(list of supported s),(list of supported s) +QINDCFG: 'ring',(list of supported s),(list of supported s) +QINDCFG: 'smsincoming',(list of supported s),(list of supported s) +QINDCFG: 'ccinfo',(list of supported s),(list of supported s) Write command OK Response BG95&BG77&BG600L_Series_Voice_Application_Note 32 / 43 LPWA Module Series AT+QINDCFG=[,[,]] If the optional parameters are omitted, query the current configuration: +QINDCFG: , OK If the optional parameters are specified, configure the URC indication: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. determines whether the configuration is saved. Parameter String type. URC type. 'all' Main switch of all URCs. default value is 1 (ON). 'csq' Indication of signal strength and signal channel bit error rate change. default value is 0 (OFF). If it is 1, +QIND: 'csq',, is reported. 'smsfull' Indication of full SMS storage. default value is 0. If it is 0, +QIND: 'smsfull', is reported. 'ring' Indication of 'RING'. default value is 1. 'smsincoming' Indication of Incoming message. default value is 1. Related URCs include +CMTI, +CMT, +CDS. 'ccinfo' Indication of voice call state change. default value is 0. If it is 1, the URC indication is enabled and +QIND: 'ccinfo',,,,,, ,[,] is reported (see Chapter 4.6 for details about the parameters). Integer type. URC indication is ON or OFF. 0 OFF 1 ON Integer type. Whether to save the configuration into NVRAM. 0 Not save 1 Save BG95&BG77&BG600L_Series_Voice_Application_Note 33 / 43 Example AT+QINDCFG=? +QINDCFG: 'all',(0,1),(0,1) +QINDCFG: 'csq',(0,1),(0,1) +QINDCFG: 'smsfull',(0,1),(0,1) +QINDCFG: 'ring',(0,1),(0,1) +QINDCFG: 'smsincoming',(0,1),(0,1) +QINDCFG: 'ccinfo',(0,1),(0,1) OK AT+QINDCFG='ring',0 OK AT+QINDCFG='ccinfo',1 OK //Disable RING URC report. //Enable ccinfo URC report. LPWA Module Series BG95&BG77&BG600L_Series_Voice_Application_Note 34 / 43 LPWA Module Series 5 Description of URCs 5.1. RING URC The RING URC indicates an incoming call signal from network. RING URC RING An incoming call. 5.2. Alert URC When you make a call by executing ATD, there will be a RING URC in the remote terminal. In the local terminal, we can get an Alert URC returned instead of RBT (RING BACK TONE). Alert URC +ALERTING: ,, Peer side is ringing. Parameter Integer type. Call ID. Call identification number as described in 3GPP TS 22.030. String type. Phone number. Integer type. Type of phone number. 129 Unknown type 145 International type (contains character '+') 161 National type Example ATD505010000000045; //Dial a number. OK //Alert URC +ALERTING: 3,505010000000045,129 //Peer side is ringing. ATH OK BG95&BG77&BG600L_Series_Voice_Application_Note 35 / 43 LPWA Module Series 6 Issue Analysis If an outgoing call fails, check whether the wrong number is dialed first, and then check whether IMS is registered successfully. If the two mentioned preconditions are correct, further analyze the phonetic problems. Before analyzing, make certain the direction that whether it is an uplink problem or a downlink problem. After identifying the direction, pinpoint the type of the problem, such as intermittence, noise, silence, howling, etc. TX VOC Uplink Path ADC Microphone Downlink Path DAC Codec (Control Volume, Audio Stream Path) Module ADSP (Control Volume, Echo Cancellation, Noise Suppression, Mixer by acdb File) Speaker RX VOC Network Figure 3: Voice Flow Factors Affecting Voice Quality: ⚫ Network condition: if the test is conducted in a weak-signal area. ⚫ Channel condition: if the test is conducted in a fading/poor channel or if the channel condition results in CRC errors. ⚫ ADSP processing: if ADSP parameters are set wrongly. ⚫ Packet loss/miss: if the packet is lost in the network or the packet is missed in the system. ⚫ Codec: if an incorrect codec type is selected or a wrong registration parameter (see AT+QDAI, AT+QIIC and 3GPP TS 26.103) is configured. ⚫ PCM interface: if unsuitable parameters (see AT+QPCMCFG) with a selected codec are configured. NOTE BG95 series, BG77 and BG600L-M3 modules do not support adjusting ADSP parameters in real time BG95&BG77&BG600L_Series_Voice_Application_Note 36 / 43 by AT command. LPWA Module Series 6.1. Direction-Related Problem Analysis Making it clear whether the problem occurred on the uplink or downlink side, on the home side or peer side, is the key step to solving the problem. Uplink: If the TX VOC itself has any problem, there is no need to analyze the problem from the perspective of the protocol. If the TX VOC sounds good but the downlink sounds bad on the other end, it is necessary to capture the logs on both sides of the calling and called parties. This scenario can be regarded as the most complex one because there may be a problem with the callee on the remote party, or may be a problem with the local caller. Therefore, we need to compare the logs of both sides and analyze the logs together. Downlink: If the RX VOC itself sounds good but the subsequent PCM sounds bad, there is no need to analyze the problem from the perspective of the protocol. You only need to check whether the Codec and PCM are configured correctly. The RX VOC problem is the most common voice problem. Generally, it is necessary to start from the access layer and make a comprehensive analysis based on the current network coverage, wireless environment, signal-to-noise ratio, bit error rate and other factors. In fact, the vast majority of such problems are caused by poor network coverage. NOTE Be careful when capturing logs. First, select a dedicated audio log mask to capture the log before calling. Then, keep talking for about a minute. Last, hang up. 6.2. Protocol-Related Problem Analysis Voice analysis of common protocols is point-to-point analysis. That is, the time point at which the voice is faulty must be determined in the voice file generated by playback. By observing SNR and RSRP methods to measure the wireless environment at that time. When RSRP is lower than -95 dBm, the wireless environment is considered to be average, and when RSRP is lower than -105 dBm, the wireless environment is considered to be very poor. RxQual represents a bit error rate level, which is a very valid statistic for SNR. Generally, if RxQual is greater than 4 or CRC is 'Fail', or SNR is less than 0, it is difficult to ensure the voice quality. BG95&BG77&BG600L_Series_Voice_Application_Note 37 / 43 LPWA Module Series 6.2.1. VoLTE Issue Analysis From the image below, we can see that the current network condition is very poor because RSRP is less than -105 dBm, which may affect voice quality. Generally, it is not ideal for users to dial in the circumstance. Figure 4: Poor Network Condition in VoLTE 6.2.2. CS-Voice over GSM Issue Analysis From the images below, we can see that RxQual is 7 (greater than 4) in Figure 5 and CRC is 'Fail' in Figure 6. All these data represent the poor channel condition under GSM network, under which circumstances users may hear discontinuous sounds when making a call. BG95&BG77&BG600L_Series_Voice_Application_Note 38 / 43 LPWA Module Series Figure 5: Poor Channel Condition in CS-Voice (1) Figure 6: Poor Channel Condition in CS-Voice (2) BG95&BG77&BG600L_Series_Voice_Application_Note 39 / 43 LPWA Module Series 7 Appendix A References Table 3: Related Document Document Name [1] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual Table 4: Terms and Abbreviations Abbreviation ADSP AMR-NB AMR-WB CLIR COLP CRC CSFB DAN DTMF EVS E-UTRA(N) G.711 IMS IPsec IWLAN Description Audio Digital Signal Processor Adaptive Multi-rate Narrow Band Adaptive Multi-rate Wide Band Calling Line Identification Restriction Connected Line Identification Presentation Cyclic Redundancy Check Circuit Switched Fallback Domain Availability Notification Dual-tone multi-frequency Enhance Voice Services Evolved Universal Terrestrial Radio Access (Network) ITU-T Standard Pulse Code Modulation (PCM) of Voice Frequencies IP Multimedia Subsystem Internet Protocol Security Industrial Wireless LAN BG95&BG77&BG600L_Series_Voice_Application_Note 40 / 43 MO MSC MT MWI PDN PCM QCI QoS RAT RCS ROHC RTP RTT SDP SMS SIP SRVCC TTY UDP VICE VoLTE LPWA Module Series Mobile Originated Mobile-services Switching Centre Mobile Terminated Message Waiting Indicator Packet Data Network Pulse Code Modulation QoS Class Identifier Quality of Service Radio Access Technology Rich Communication Suite Robust Header Compression Real-time Transport Protocol Real-Time Text Session Description Protocol Short Message Service Session Initiation Protocol Single Radio Voice Call Continuity Teletypewriter User Datagram Protocol VoLTE for Internet-connected Endpoint Voice over LTE BG95&BG77&BG600L_Series_Voice_Application_Note 41 / 43 LPWA Module Series 8 Appendix B Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation of +CME ERROR: final result code is similar to the regular ERROR result code: if +CME ERROR: is the result code for any of the commands in a command line, none of the following commands in the same command line is executed (neither ERROR nor OK result code shall be returned as a result of a completed command line execution). The format of can be either numeric or verbose. This is set with AT+CMEE. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. Table 5: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 10 11 12 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required BG95&BG77&BG600L_Series_Voice_Application_Note 42 / 43 LPWA Module Series 13 (U)SIM failure 14 (U)SIM busy 15 (U)SIM wrong 16 Incorrect password 17 (U)SIM PIN2 required 18 (U)SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required BG95&BG77&BG600L_Series_Voice_Application_Note 43 / 43

BG95&BG77&BG600L Series MQTT-SN Application Note LPWA Module Series Version: 1.0 Date: 2022-11-17 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 1 / 28 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 2 / 28 LPWA Module Series About the Document Revision History Version Date Author Description - 2021-10-13 Terrence YANG Creation of the document 1.0 2022-11-17 Terrence YANG First official release BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 3 / 28 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 2 MQTT-SN Data Interaction ................................................................................................................. 7 3 MQTT-SN Related AT Commands ..................................................................................................... 8 3.1. AT Command Syntax ................................................................................................................. 8 3.1.1. Definitions........................................................................................................................ 8 3.1.2. AT Command Syntax ...................................................................................................... 8 3.2. Declaration of AT Command Examples ..................................................................................... 9 3.3. Description of MQTT-SN Related AT Commands ..................................................................... 9 3.3.1. AT+QMTSNCFG Configure Optional Parameters of MQTT-SN.................................. 9 3.3.2. AT+QMTSNOPEN Open a Network for MQTT-SN Client.......................................... 13 3.3.3. AT+QMTSNCLOSE Close a Network for MQTT-SN Client ....................................... 14 3.3.4. AT+QMTSNSUB Subscribe to Topics ........................................................................ 14 3.3.5. AT+QMTSNUNS Unsubscribe from Topics................................................................ 16 3.3.6. AT+QMTSNREG Request Topic ID............................................................................ 17 3.3.7. AT+QMTSNPUB Publish Messages .......................................................................... 18 3.3.8. AT+QMTSNWILLUPD Update Will Topic or Will Message ........................................ 20 3.3.9. AT+QMTSNSLEEP Configure the Current State of the Module ................................ 21 4 MQTT-SN Related URCs................................................................................................................... 23 4.1. +QMTSNSTAT URC to Indicate State Change in MQTT-SN Link Layer.............................. 23 4.2. +QMTSNRECV URC to Inform the Host to Read MQTT-SN Packet Data .......................... 25 5 Example ............................................................................................................................................. 26 5.1. Example of MQTT-SN Operation............................................................................................. 26 6 Appendix A References.................................................................................................................... 28 BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 4 / 28 LPWA Module Series Table Index Table 1: Types of At Commands .......................................................................................................................... 8 Table 2: MQTT-SN Related URCs ..................................................................................................................... 23 Table 3: Error Codes of the URC ....................................................................................................................... 24 Table 4: Terms and Abbreviations...................................................................................................................... 28 BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 5 / 28 LPWA Module Series 1 Introduction MQTT-SN is a publish/subscribe messaging protocol for wireless sensor networks (WSNs), with the aim of extending the MQTT protocol beyond the reach of TCP/IP infrastructure for sensor and actuator solutions. This document mainly introduces how to use the MQTT-SN function of Quectel BG95 series, BG77 and BG600L-M3 modules through AT commands. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 6 / 28 LPWA Module Series 2 MQTT-SN Data Interaction This chapter gives the data interaction mechanism of MQTT-SN function. MCU Modem Link layer MQTT-SN Gateway AT+QMTSNCFG='will',,[…] AT+QMTSNCFG='timeout',,[…] AT+QMTSNOPEN AT+QMTSNOPEN=,,, OK +QMTSNOPEN: , AT+QMTSNREG AT+QMTSNREG=,, OK +QMTSNREG: ,, CONN-REQ Start timer T1, T2 Will flag=1 CONN ACK-IND Stop T1 or handle Excep1 Send connect packet Receive willtopic request packet Send willtopic packet Receive willmessage request packet Send willmessage packet Receive connect ACK packet REG-REQ (msgID) Start timer T1 REG ACK-IND (msgID) Stop T1 or handle Excep2 +QMTSNREG: tcpidx,1,msgId Send resister packet Receive register ACK packet AT+QMTSNSUB AT+QMTSNSUB=,,, SUB-REQ (msgID) OK Start timer T1 +QMTSNSUB: ,,[,] SUB ACK-IND (msgID) Stop T1 or handle Excep2 +QMTSNSUB: idx,1,msgId Send subscribe packet Receive subscribe ACK packet AT+QMTSNUNS AT+QMTSNUNS=,, OK +QMTSNUNS: ,, AT+QMTSNPUB=,,=0,< retain>, OK AT+QMTSNPUB AT+QMTSNPUB=,,=1,< (=1) retain>, OK +QMTSNPUB: ,,[,] UNS-REQ (msgID) Start timer T1 UNS ACK-IND (msgID) Stop T1 or handle Excep2 +QMTSNUNS: idx,1,msgId Send unsubscribe packet Receive unsubscribe ACK packet PUB-REQ Send publish packet PUB-REQ (msgID) Start timer T1 PUB ACK-IND (msgID) Stop T1 or handle Excep2 +QMTPUB: idx,1,msgId Send publish packet Receive publish ACK packet AT+QMTSNPUB AT+QMTSNPUB=,,=2,< (=2) retain>, OK +QMTSNPUB: ,,[,] PUB-REQ (msgID) Start timer T1 +QMTSNPUB: idx,1,msgId Send publish packet PUB REC-IND (msgID) Receive publish receive packet Stop T1 or handle Excep2 PUB REL-REQ (msgID) Start timer T1 PUB COMP-IND (msgID) +QMTSNPUBREL: idx,1,msgId Send publish release packet Receive publish complete packet Stop T1 or handle Excep2 Receive Receive PUBLISH message in the form of URC. +QMTSNRECV: ,,, AT+QMTSNCLOSE AT+QMTSNCLOSE= OK +QMTSNCLOSE: , PUB-IND (msgID) PUB ACK/REC-REQ (msgID) Reply accor.d..ing to DISC-REQ Disconnect Receive publish packet Send publish reply packet Send disconnect request Disconnect T1 is packet transmission timeout. T2 is keep alive timer. In the absence of a data-related message during the T2 time period, the client will send PINGREQ packet. Excep1: Close UDP connection. Excep2: Resend packets unless the maximum retry times is reached. Retry times is set by AT+QMTSNCFG. Whether the timeout information is reported can be configured by AT+QMTSNCFG. Figure 1: MQTT-SN Data Interaction Diagram BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 7 / 28 LPWA Module Series 3 MQTT-SN Related AT Commands This chapter presents the AT commands for operating MQTT-SN function. 3.1. AT Command Syntax 3.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 1: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 8 / 28 LPWA Module Series 3.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 3.3. Description of MQTT-SN Related AT Commands 3.3.1. AT+QMTSNCFG Configure Optional Parameters of MQTT-SN This command configures optional parameters of MQTT-SN. AT+QMTSNCFG Configure Optional Parameters of MQTT-SN Test Command AT+QMTSNCFG=? Response +QMTSNCFG: 'pdpcid',(range of supported s), (range of supported s) +QMTSNCFG: 'keepalive',(range of supported s),(range of supported s) +QMTSNCFG: 'session',(range of supported s),(list of supported s) +QMTSNCFG: 'timeout',(range of supported s),(range of supported s),(range of supported s),(list of supported s) +QMTSNCFG: 'dtls',(range of supported s),(list of supported s),(range of supported s) +QMTSNCFG: 'will',(range of supported s),(list of supporteds),(range of supporteds),(list of supported s),, Write Command Query/set the PDP to be used by the MQTT-SN client AT+QMTSNCFG='pdpcid',[,] OK Response If the optional parameter is omitted, query the PDP used by the MQTT-SN client: +QMTSNCFG: 'pdpcid', OK BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 9 / 28 LPWA Module Series If the optional parameter is specified, set the PDP to be used by the MQTT-SN client: OK Write Command Query/set the keep-alive time AT+QMTSNCFG='keepalive',[,] If there is any error: ERROR Response If the optional parameter is omitted, query the keep-alive time: +QMTSNCFG: 'keepalive', OK If the optional parameter is specified, set the keep-alive time: OK Write Command Query/set the session type AT+QMTSNCFG='session',[,] If there is any error: ERROR Response If the optional parameter is omitted, query the session type: +QMTSNCFG: 'session', OK If the optional parameter is specified, set the session type: OK Write Command Query/set timeout of message delivery AT+QMTSNCFG='timeout',[,[,][,]] If there is any error: ERROR Response If the optional parameters are omitted, query the timeout of message delivery: +QMTSNCFG: 'timeout',,, OK If any of the optional parameters is specified, set the timeout of message delivery: OK Write Command Query/set DTLS security mode of If there is any error: ERROR Response If the optional parameters are omitted, query DTLS security BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 10 / 28 LPWA Module Series MQTT-SN client: AT+QMTSNCFG='dtls',[,,] mode of MQTT-SN client: +QMTSNCFG: 'dtls',, OK If the optional parameters are specified, set DTLS security mode for MQTT-SN client: OK Write Command Query/set Will information AT+QMTSNCFG='will',[,[,,,,]] If there is any error: ERROR Response If the optional parameters are omitted, query the Will information: +QMTSNCFG: 'will',[,,,,] OK If any of the optional parameters is specified, set the Will information: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. The PDP to be used by the MQTT-SN client. Range: 1–16. Default value: 1. Integer type. Keep-alive time. Range: 0–3600. Default value: 120. Unit: second. It defines the maximum interval time for messages received from a client. If the server does not receive a message from the client within 1.5 times of the keepalive time period, it disconnects the client as if the client has sent a DISCONNECT message. Integer type. Session type. 0 The server must store the subscriptions of the client after it is disconnected 1 The server must discard any previously maintained information about the client and treat the connection as 'clean' BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 11 / 28 LPWA Module Series Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. Integer type. Whether to report timeout message when transmitting packet. 0 Not report 1 Report Integer type. MQTT-SN SSL mode. 0 Use normal UDP connection for MQTT-SN client 1 Use DTLS security connection for MQTT-SN client Integer type. DTLS context identifier. Range: 0–5. Integer type. Will flag configuration. 0 Ignore the Will flag configuration 1 Require the Will flag configuration Integer type. Quality of service for message delivery. 0 At most once 1 At least once 2 Exactly once Integer type. Will retain flag only used on PUBLISH messages. 0 When a client sends a PUBLISH message to a server, the server will not retain the message after it has been delivered to the current subscribers 1 When a client sends a PUBLISH message to a server, the server will retain the message after it has been delivered to the current subscribers String type. Will topic. The maximum length is 255 bytes. String type. Define the content of the message that is published to the will topic if the client is unexpectedly disconnected. It can be zero-length message. The maximum length is 255 bytes. NOTE 1. If =1, then , , and must be specified. Otherwise, they will be omitted. 2. =0 is only effective when the server supports the operation. 3. It is crucial to ensure the message delivery does not time out while the message is still being sent. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 12 / 28 LPWA Module Series 3.3.2. AT+QMTSNOPEN Open a Network for MQTT-SN Client This command opens a network and sends CONNECT message for MQTT-SN client. AT+QMTSNOPEN Open a Network for MQTT-SN Client Test Command AT+QMTSNOPEN=? Response +QMTSNOPEN: (range of supported s),,(range of supported s), Read Command AT+QMTSNOPEN? OK Response [+QMTSNOPEN: ,,,] Write Command AT+QMTSNOPEN=,,, OK Response OK +QMTSNOPEN: , Maximum Response Time Characteristics If there is any error: ERROR (5 s by default), determined by network - Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. String type. The address of the MQTT-SN gateway. It could be an IP address or a domain name. The maximum size is 255 bytes. Integer type. The port of the MQTT-SN gateway. Range: 0–65535. String type. The client identifier. The maximum size is 255 bytes. Integer type. Current state of the specified MQTT-SN client. 0 Idle state 1 MQTT-SN client is connecting 2 MQTT-SN client is connected 3 MQTT-SN client is disconnecting Integer type. Result of the command execution. -1 Failed to open network 0 Network opened successfully 1 Wrong parameter 2 MQTT-SN client identifier is occupied BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 13 / 28 LPWA Module Series 3 Failed to activate PDP 4 Failed to parse domain name 5 Network connection error Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. 3.3.3. AT+QMTSNCLOSE Close a Network for MQTT-SN Client This command closes a network and sends DISCONNECT message for MQTT-SN client. AT+QMTSNCLOSE Close a Network for MQTT-SN Client Test Command AT+QMTSNCLOSE=? Response +QMTSNCLOSE: (range of supported s) Write Command AT+QMTSNCLOSE= OK Response OK +QMTSNCLOSE: , Maximum Response Time Characteristics If there is any error: ERROR (5 s by default), determined by network - Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. Result of the command execution. -1 Failed to close network 0 Network closed successfully 2 Failed to send DISCONNECT packet Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. 3.3.4. AT+QMTSNSUB Subscribe to Topics This command subscribes to a certain topic. A SUBSCRIBE message is sent by a client to register an interest in a topic with the server. Messages published to the topic are delivered from the server to the client as PUBLISH messages. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 14 / 28 LPWA Module Series AT+QMTSNSUB Subscribe to Topics Test Command AT+QMTSNSUB=? Response +QMTSNSUB: (range of supported s),(range of supported s),,(range of supported s) Write Command AT+QMTSNSUB=,,, OK Response OK +QMTSNSUB: ,, Maximum Response Time Characteristics If there is any error: ERROR × (15 s by default), determined by network - Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. Message identifier of packet. Range: 1–65535. String type. The topic that the client wants to subscribe to. The maximum size is 255 bytes. Integer type. The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once Integer type. Result of the command execution. 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. NOTE The is only present in messages where the QoS bits in the fixed header indicate QoS level 1 or 2. It must be unique amongst the set of 'inflight' messages in a particular direction of communication. It typically increases by exactly one from one message to the next, but is not required BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 15 / 28 to do so. LPWA Module Series 3.3.5. AT+QMTSNUNS Unsubscribe from Topics This command unsubscribes from a named topic. An UNSUBSCRIBE message is sent by the client to the gateway to unsubscribe from a named topic. AT+QMTSNUNS Unsubscribe from Topics Test Command AT+QMTSNUNS=? Response +QMTSNUNS: (range of supported s),(range of supported s), Write Command AT+QMTSNUNS=,, OK Response OK +QMTSNUNS: ,, Maximum Response Time Characteristics If there is any error: ERROR × (15 s by default), determined by network - Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. Message identifier of packet. Range: 1–65535. String type. The topic that the client wants to unsubscribe from. The maximum size is 255 bytes. Integer type. Result of the command execution. 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 16 / 28 LPWA Module Series 3.3.6. AT+QMTSNREG Request Topic ID This command requests a topic ID from the MQTT-SN gateway when sending a topic name. AT+QMTSNREG Request Topic ID Test Command AT+QMTSNREG=? Response +QMTSNREG: (range of supported s),(range of supported s), Read Command AT+QMTSNREG? OK Response [+QMTSNREG: ,, [...]] Write Command AT+QMTSNREG=,, OK Response OK +QMTSNREG: ,, Maximum Response Time Characteristics If there is any error: ERROR (5 s by default), determined by network - Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. Message identifier of packet. Range: 0–65535. String type. The topic that the client subscribed to. The maximum size is 255 bytes Integer type. The value of topic ID that shall be used in the PUBLISH message. Range: 0–65535. Integer type. Result of the command execution. 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 17 / 28 LPWA Module Series 3.3.7. AT+QMTSNPUB Publish Messages This command publishes messages by a client to a server for distribution to interested subscribers. Each PUBLISH message is associated with a topic name. AT+QMTSNREG or AT+QMTSNSUB should be executed with associated topic name before the message can be published. AT+QMTSNPUB Publish Messages Test Command AT+QMTSNPUB=? Response +QMTSNPUB: (range of supported s),(range of supported s),(range of supported s),(list of supported s),,(range of supported s) Write Command AT+QMTSNPUB=,,,, OK Response > After '>' is responded, input the data to be sent. Tap 'CTRL + Z' to send, and tap 'ESC' to cancel the operation. OK +QMTSNPUB: ,,[,] Write Command AT+QMTSNPUB=,,,,, If there is any error: ERROR Response > After '>' is responded, input the data to be sent. The number of bytes of inputted data must be equal to . OK +QMTSNPUB: ,,[,] Maximum Response Time Characteristics If there is any error: ERROR × (15 s by default), determined by network - Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. Message identifier of packet. Range: 0–65535. It will be 0 only when =0. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 18 / 28 LPWA Module Series Integer type. The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once Integer type. Whether or not the server will retain the message after it has been delivered to the current subscribers. 0 Not retain 1 Retain String type. Topic that needs to be published. The maximum size is 255 bytes. Integer type. Length of message to be published. Range: 1–1024. Unit: byte. Integer type. Result of the command execution. 0 Sent packet successfully and received ACK from server (message that published when =0 does not require ACK) 1 Packet retransmission 2 Failed to send packet If is 1, it means the times of packet retransmission. If is 0 or 2, it will not be presented. Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. NOTES 1. After executing this command, the client is ready to send data, which will be sent as payload. The maximum length of the input data is 1024 bytes at a time and tap Ctrl + Z to send the data. 2. PUBLISH messages can be sent either from a publisher to the server, or from the server to a subscriber. When a server publishes messages to a subscriber, the following URC will be returned to notify the host to read the received data that is reported from MQTT-SN gateway: +QMTSNRECV: ,,,. For more details about the URC description, please refer to Chapter 4.2. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 19 / 28 LPWA Module Series 3.3.8. AT+QMTSNWILLUPD Update Will Topic or Will Message This command updates Will topic or Will message stored in gateway/server. If is 2, Will topic and Will message stored in gateway/server will be deleted. AT+QMTSNWILLUPD Update Will Topic or Will Message Test Command AT+QMTSNWILLUPD=? Response +QMTSNWILLUPD: (range of supported s), (range of supported s),(range of supported s),(list of supported s),/ Write Command AT+QMTSNWILLUPD=,< mode>,[,,/] OK Response OK +QMTSNWILLUPD: , Maximum Response Time Characteristics If there is an error: ERROR (5 s by default), determined by network - Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. Update or delete Will topic or/and Will message. 0 Update Will topic 1 Update Will message 2 Delete Will topic and Will message Integer type. Quality of service for message delivery. 0 At most once 1 At least once 2 Exactly once Integer type. The will retain flag is only used on PUBLISH messages. 0 When a client sends a PUBLISH message to a server, the server will not hold on to the message after it has been delivered to the current subscribers 1 When a client sends a PUBLISH message to a server, the server should hold on to the message after it has been delivered to the current subscribers String type. Will topic. The maximum length is 255 bytes. String type. The Will message defines the content of the message that is published to the will topic if the client is unexpectedly disconnected. It can be a BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 20 / 28 LPWA Module Series zero-length message. The maximum length is 255 bytes. Integer type. Result of the command execution. 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet 3 Request rejected from server Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. 3.3.9. AT+QMTSNSLEEP Configure the Current State of the Module This command configures the current state of the module and notifies the gateway that the client enters asleep, awake, or active state. AT+QMTSNSLEEP Configure the Current Status of the Module Test Command AT+QMTSNSLEEP=? Response +QMTSNSLEEP: (range of supported s),(range of supported s),(range of supported s) Write Command AT+QMTSNSLEEP=,[,] OK Response OK +QMTSNSLEEP: , Maximum Response Time Characteristics If there is an error: ERROR (5 s by default), determined by network - Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. The current state of the module. 0 Asleep state 1 Awake state 2 Active state Integer type. Sleep duration. It is only valid when is 0. Range: 900–64800. Unit: second. Integer type. Result of the command execution. 0 Sent packet successfully and received ACK from server BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 21 / 28 LPWA Module Series 1 Packet retransmission 2 Failed to send packet Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 22 / 28 LPWA Module Series 4 MQTT-SN Related URCs This chapter gives MQTT-SN related URCs and their descriptions. Table 2: MQTT-SN Related URCs SN URC Format Description When the state of MQTT-SN link layer is [1] +QMTSNSTAT: , changed, the client will close the MQTT-SN connection and report the URC. +QMTSNRECV: ,,, packet data from MQTT-SN gateway. 4.1. +QMTSNSTAT URC to Indicate State Change in MQTT-SN Link Layer The URC begins with +QMTSNSTAT:. It will be reported when there is a change in the state of MQTT-SN link layer. +QMTSNSTAT URC to Indicate State Change in MQTT-SN Link Layer +QMTSNSTAT: , will close the MQTT-SN connection and report the URC. Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Error codes. Please refer to the table below for details. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 23 / 28 LPWA Module Series Table 3: Error Codes of the URC 1 2 3 4 5 6 7 8-255 Description How to do The connection is closed or reset by a peer. Sending PINGREQ packet timed out or failed. Sending CONNECT packet timed out or failed. Receiving CONNACK packet timed out or failed. The client sends DISCONNECT packet to sever and the server is initiative to close MQTT-SN connection. The client is initiative to close MQTT-SN connection due to packet sending failure all the time. The link is not alive or the server is unavailable. Execute AT+QMTSNOPEN and reopen MQTT-SN connection. Deactivate PDP first, and then active PDP and reopen MQTT-SN connection. 1. Check whether the inputted user name and password are correct. 2. Make sure the client ID is not used. 3. Reopen MQTT-SN connection and try to send CONNECT packet to server again. 1. Check whether the inputted user name and password are correct. 2. Make sure the client ID is not used. 3. Reopen MQTT-SN connection and try to send CONNECT packet to server again. This is a normal process. 1. Make sure the data is correct. 2. Try to reopen MQTT-SN connection since there may be network congestion or an error. Make sure the link is alive or the server is available currently. Reserved for future use. - BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 24 / 28 LPWA Module Series 4.2. +QMTSNRECV URC to Inform the Host to Read MQTT-SN Packet Data The URC begins with +QMTSNRECV:. It is mainly used to inform the host to read the received MQTT-SN packet data that is reported from MQTT-SN gateway. +QMTSNRECV URC to Inform the Host to Read MQTT-SN Packet Data +QMTSNRECV: ,,, MQTT-SN gateway. Parameter Integer type. MQTT-SN socket identifier. Range: 0–5. Integer type. The message identifier of packet. Range: 0–65535. String type. The topic that received from MQTT-SN gateway. The maximum size is 255 bytes. String type. The payload that relates to the topic name. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 25 / 28 LPWA Module Series 5 Example This chapter gives the examples to explain how to use MQTT-SN related AT commands. 5.1. Example of MQTT-SN Operation //Open a network for MQTT-SN client. AT+QMTSNOPEN=0,'220.180.239.212',8027,'clientid' OK +QMTSNOPEN: 0,0 //Opened the MQTT-SN client network successfully. AT+QMTSNOPEN? +QMTSNOPEN: 0,'220.180.239.212',8027,2 OK AT+QMTSNREG=0,1,'topic/example' OK +QMTSNREG: 0,1,0 AT+QMTSNREG=0,1,'topic/pub' OK +QMTSNREG: 0,1,0 AT+QMTSNSUB=? +QMTSNSUB: (0-5),(1-65535),,(0-2) OK //Subscribe to topics. AT+QMTSNSUB=0,1,'topic/example',2 OK +QMTSNSUB: 0,1,0 AT+QMTSNSUB=0,1,'topic/pub',0 OK +QMTSNSUB: 0,1,0 BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 26 / 28 LPWA Module Series //If a client subscribes to a topic and other devices publish message related to the same topic to the server, the module reports the following information. +QMTSNRECV: 0,0,'topic/example','This is the payload related to topic' //Unsubscribe from topics. AT+QMTSNUNS=0,2,'topic/example' OK +QMTSNUNS: 0,2,0 AT+QMTSNPUB=? +QMTSNPUB: (0-5),(0-65535),(0-2),(0,1),,(1-1024) OK //Publish messages. AT+QMTSNPUB=0,0,0,0,'topic/pub' >This is test data, hello MQTT-SN. //After receiving >, input data This is test data, hello MQTT-SN. and then send it. The maximum length of the data is 1024 bytes and the data that beyond 1024 bytes will be omitted. After inputting data, tap Ctrl + Z to send. OK +QMTSNPUB: 0,0,0 //If a client subscribes to a topic named 'topic/pub' and other devices publish the same topic to the server, the module will report the following information. +QMTSNRECV: 0,0,'topic/pub','This is test data, hello MQTT-SN.' //Disconnect a client from MQTT-SN gateway. AT+QMTSNCLOSE=0 OK +QMTSNCLOSE: 0,0 //Connection closed successfully. BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 27 / 28 LPWA Module Series 6 Appendix A References Table 4: Terms and Abbreviations Abbreviation ACK DTLS IP LPWA MQTT MQTT-SN PDP QoS RAM SSL TCP UDP URC WSN Description Acknowledgement Datagram Transport Layer Security Internet Protocol Low Power Wide Area Message Queuing Telemetry Transport MQTT For Sensor Networks Packet Data Protocol Quality of Service Random Access Memory Security Socket Layer Transmission Control Protocol User Datagram Protocol Unsolicited Result Code Wireless Sensor Networks BG95&BG77&BG600L_Series_MQTT-SN_Application_Note 28 / 28

BG95&BG77&BG600L Series Voice Application Note LPWA Module Series Version: 1.0 Date: 2022-09-30 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_Voice_Application_Note 1 / 43 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Series_Voice_Application_Note 2 / 43 LPWA Module Series About the Document Revision History Version 1.0 Date 2022-06-01 2022-09-30 Author Nora HE Nora HE Description Creation of the document First official release BG95&BG77&BG600L_Series_Voice_Application_Note 3 / 43 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 Introduction ......................................................................................................................................... 8 1.1. Applicable Modules and Supported Voice Feature ................................................................... 8 2 General Overview of IMS and VoLTE................................................................................................ 9 2.1. Introduction to IMS Features...................................................................................................... 9 2.1.1. Supported Features ........................................................................................................ 9 2.1.2. Features Not Supported.................................................................................................. 9 2.2. Introduction to VoLTE Call Flow............................................................................................... 10 2.2.1. Prerequisite for VoLTE Call ........................................................................................... 10 2.2.2. Process of VoLTE Call .................................................................................................. 10 3 AT Command Introduction .............................................................................................................. 12 3.1. AT Command Introduction ....................................................................................................... 12 3.1.1. Definitions...................................................................................................................... 12 3.1.2. AT Command Syntax .................................................................................................... 12 3.1.3. Declaration of AT Command Examples ........................................................................ 13 4 AT Command Description................................................................................................................ 14 4.1. AT+QCFG='ims' Query IMS Registration State ................................................................... 14 4.2. ATD Originate a Call.............................................................................................................. 15 4.3. ATA Answer an Incoming Call ............................................................................................... 17 4.4. ATH Disconnect Existing Connection.................................................................................... 18 4.5. AT+CVHU Voice Call Hang Up Control................................................................................. 19 4.6. AT+CLCC List Current Calls of ME ....................................................................................... 20 4.7. AT+CHUP Hang up a Call ..................................................................................................... 21 4.8. AT+QIIC Read/ Write Codec Through IIC ............................................................................. 22 4.9. AT+QDAI Configure Digital Audio Interface .......................................................................... 23 4.10. AT+CLVL Configure Loudspeaker Volume............................................................................ 24 4.11. AT+CMUT Muting Control ..................................................................................................... 25 4.12. AT+QPCMCFG Configure PCM Interface............................................................................. 26 4.13. AT+QLDTMF Play Local DTMF ............................................................................................ 28 4.14. AT+VTS DTMF and Tone Generation ................................................................................... 29 4.15. AT+QTONEDET Enable/Disable DTMF Detection ............................................................... 30 4.16. AT+QAUDLOOP Enable/Disable Audio Loop Test ............................................................... 31 4.17. AT+QINDCFG Configure URC Indication ............................................................................. 32 5 Description of URCs ......................................................................................................................... 35 5.1. RING URC ............................................................................................................................... 35 5.2. Alert URC ................................................................................................................................. 35 BG95&BG77&BG600L_Series_Voice_Application_Note 4 / 43 LPWA Module Series 6 Issue Analysis ................................................................................................................................... 36 6.1. Direction-Related Problem Analysis ........................................................................................ 37 6.2. Protocol-Related Problem Analysis ......................................................................................... 37 6.2.1. VoLTE Issue Analysis .................................................................................................... 38 6.2.2. CS-Voice over GSM Issue Analysis .............................................................................. 38 7 Appendix A References.................................................................................................................... 40 8 Appendix B Summary of CME ERROR Codes............................................................................... 42 BG95&BG77&BG600L_Series_Voice_Application_Note 5 / 43 LPWA Module Series Table Index Table 1: Applicable Modules and Supported Voice Feature ....................................................................... 8 Table 2: Types of AT Commands .............................................................................................................. 12 Table 3: Related Document........................................................................................................................ 40 Table 4: Terms and Abbreviations .............................................................................................................. 40 Table 5: Different Coding Schemes of +CME ERROR: ................................................................... 42 BG95&BG77&BG600L_Series_Voice_Application_Note 6 / 43 LPWA Module Series Figure Index Figure 1: VoLTE Call Flow...........................................................................................................................11 Figure 2: Data Path of AFE Loopback ....................................................................................................... 31 Figure 3: Voice Flow................................................................................................................................... 36 Figure 4: Poor Network Condition in VoLTE .............................................................................................. 38 Figure 5: Poor Channel Condition in CS-Voice (1) .................................................................................... 39 Figure 6: Poor Channel Condition in CS-Voice (2) .................................................................................... 39 BG95&BG77&BG600L_Series_Voice_Application_Note 7 / 43 LPWA Module Series 1 Introduction This document introduces the application of VoLTE and describes the related AT commands of VoLTE, CS voice over GSM (2G) and audio services on Quectel BG95 series, BG77 and BG600L-M3 modules. 1.1. Applicable Modules and Supported Voice Feature Table 1: Applicable Modules and Supported Voice Feature Module Series Module BG95-M1 Supported Network Cat M1 only Supported Voice Feature VoLTE BG95-M2 Cat M1/Cat NB2 VoLTE BG95 BG95-M3 Cat M1/Cat NB2/EGPRS VoLTE/CS voice BG95-M5 Cat M1/Cat NB2/EGPRS, Power Class 3 VoLTE/CS voice BG95-M6 Cat M1/Cat NB2, Power Class 3 VoLTE BG77 BG77 Cat M1/Cat NB2 VoLTE BG600L BG600L-M3 Cat M1/Cat NB2/EGPRS VoLTE/CS voice BG95&BG77&BG600L_Series_Voice_Application_Note 8 / 43 LPWA Module Series 2 General Overview of IMS and VoLTE 2.1. Introduction to IMS Features The IP Multimedia Subsystem (IMS) is an architectural framework for delivering IP multimedia services. 2.1.1. Supported Features The following features are supported in IMS: ⚫ LTE RAT ⚫ Power-saving mode ⚫ IMS registration with or without IPsec ⚫ Single VoLTE call ⚫ SIP forking (up to seven dialogs) ⚫ Audio codecs: AMR-NB, DTMF ⚫ QoS and preconditions ⚫ SMS over IMS in 3GPP format only 2.1.2. Features Not Supported The following features are currently not supported in IMS: ⚫ Emergency call ⚫ Multi-call, such as conference call, call transfer and call pulling ⚫ SRVCC and CSFB ⚫ Audio codecs: EVS, AMR-WB, and G.711 ⚫ VoLTE for internet-connected endpoint (VICE) ⚫ DAN ⚫ Video call, RTT, and TTY ⚫ MWI ⚫ IWLAN ⚫ RCS or Presence BG95&BG77&BG600L_Series_Voice_Application_Note 9 / 43 LPWA Module Series 2.2. Introduction to VoLTE Call Flow VoLTE (Voice over Long-Term Evolution) is based on the IP Multimedia Subsystem (IMS) network, and uses special configuration files for the control and media planes. This enables voice services (at the control and media levels) to be transmitted as data streams over LTE data bearer networks. VoLTE initialization procedures are required before a VoLTE session is established. 2.2.1. Prerequisite for VoLTE Call 1. Attach to LTE network and select domain (all call flows assume voice over IMS). 2. Establish IMS PDN connection and SIP QoS flow. QCI = 5 is used for SIP signaling on IMS default bearer. 3. Complete IMS registration and subscription with IMS CN. IMS feature tags for available services are MMTel IMS Communication Services Identifier (ICSI). 2.2.2. Process of VoLTE Call The steps to establish a VoLTE session with a remote party are as follows. 1. Attach to LTE network and select domain. 2. Establish IMS PDN connection and SIP QoS flow. 3. Complete IMS registration and subscription. 4. Establish IMS session. ⚫ Transmit information by SIP signaling. ⚫ Negotiate codec with SDP. 5. Establish VoLTE QoS call flow. ⚫ Implement network-initiated QoS procedure. 6. Propose ROHC negotiation. 7. Transmit full-duplex VoLTE data between UE and E-UTRA(N). ⚫ This data is routed from the E-UTRA(N) by the packet data core network to the remote party involved in the call. ⚫ Each voice frame is generated by the vocoder and carried as the payload in RTP. ⚫ RTP packets are encapsulated in UDP packets and carried over IP. 8. Terminate IMS session. ⚫ Transmit information by SIP signaling. ⚫ Release and clean up existing VoLTE call(s). 9. Release VoLTE QoS flow. ⚫ Release network-dependent QoS procedure. 10. Terminate VoLTE feature. BG95&BG77&BG600L_Series_Voice_Application_Note 10 / 43 UE E-UTRA(N)/ PDN LTE attachment + domain selection IMS PDN connection + SIP Qos flow IMS registration and subscription {Call setup IMS session establishment VoLTE Qos flow establishment ROHC negotiation VoLTE data IMS session termination VoLTE QoS flow release IMS de-registration LPWA Module Series IM/ CN VoLTE feature initialization procedures VoLTE session procedures } May be simultaneous VoLTE feature termination procedure Figure 1: VoLTE Call Flow BG95&BG77&BG600L_Series_Voice_Application_Note 11 / 43 LPWA Module Series 3 AT Command Introduction 3.1. AT Command Introduction 3.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_Voice_Application_Note 12 / 43 LPWA Module Series 3.1.3. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. BG95&BG77&BG600L_Series_Voice_Application_Note 13 / 43 LPWA Module Series 4 AT Command Description This chapter introduces the voice and audio related AT commands supported by the modules, including the functions, usages and the scope of AT commands. For some AT commands or URCs mentioned but not described in detail in this chapter, unless otherwise specified, see document [1] for more information and usage. 4.1. AT+QCFG='ims' Query IMS Registration State This command queries the module's IMS registration state. VoLTE state indicates IMS registration state, that is, VoLTE is ready indicates IMS feature is enabled. AT+QCFG='ims' Query IMS Registration State Write Command AT+QCFG='ims' Response +QCFG: 'ims', OK Or ERROR Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: 300 ms - Parameter Integer type. VoLTE state. 0 VoLTE is not ready 1 VoLTE is ready Error code. See Chapter 8 for details. Example AT+QCFG='ims' +QCFG: 'ims',1 BG95&BG77&BG600L_Series_Voice_Application_Note 14 / 43 OK NOTE This command is valid only on the firmware version supporting VoLTE. LPWA Module Series 4.2. ATD Originate a Call This command sets up outgoing voice or data call. ATD Originate a Call Execution Command ATD[][;] Response If no dial tone and ATX2 or ATX4 is set: NO DIAL TONE If busy and ATX3 or ATX4 is set: BUSY If a call connection cannot be established: NO CARRIER If a call connection is established successfully and a non-voice call is to be set up: CONNECT TA switches to data mode. is output only when is greater than 0 in ATX parameter setting. When TA returns to command mode after call release: OK Maximum Response Time Characteristics If a call connection is established successfully and a voice call is set up: OK Or ERROR 5 s, determined by the network (AT+COLP=0). - BG95&BG77&BG600L_Series_Voice_Application_Note 15 / 43 LPWA Module Series Reference V.25ter Parameter String of dialing strings and optional V.25ter modifiers. Dialing strings: 0-9, *, #, +, A, B, C Following V.25ter, optional modifiers ,(comma), T, P, !, W, @ are ignored. String of GSM modifiers: I Activates CLIR (Disable presentation of calling number to called party). i Deactivates CLIR (Enable presentation of calling number to called party). G Activates closed user group invocation for this call only. g Deactivates closed user group invocation for this call only. It is required when setting up a voice call. After the call, TA will return to command state. Example ATD10086; OK //Dial a number. NOTE 1. This command may be aborted generally by receiving an ATH command or a character during execution. It cannot be aborted during some connection establishments such as handshaking. 2. Parameters I and i can be omitted only when there is no * or # code in the dial string. 3. See ATX for details about setting result codes and call monitoring parameters. 4. For voice calls, if dialing with ATD, TA returns OK immediately either after the dialing is completed or the call is established. Otherwise, TA returns BUSY, NO DIAL TONE, or NO CARRIER. 5. Use ATD during an active voice call: ⚫ When a user originates a second voice call while there is already an active voice call, the first call will be automatically put on hold. ⚫ The current states of all calls can be easily checked at any time by AT+CLCC. See Chapter 4.6 for details. 6. Currently, supplementary services, such as COLP, CLIR or closed user group, are not supported. BG95&BG77&BG600L_Series_Voice_Application_Note 16 / 43 LPWA Module Series 4.3. ATA Answer a Call This command connects the module to an incoming voice or data call indicated by a RING URC. ATA Answer a Call Execution Command ATA Response TA sends off-hook to the remote station. In case of data call, if successfully connected: CONNECT And TA switches to data mode. Note: is output only when is greater than 0 in ATX parameter setting. When TA returns to command mode after call release: OK In case of voice call, if successfully connected: OK If no connection: NO CARRIER Or ERROR Maximum Response Time Characteristics Reference V.25ter If there is any error related to ME functionality: +CME ERROR: 90 s, determined by the network. - Parameter Error code. See Chapter 8 for details. Example RING OK ATA OK //Ring tone. //Answer the call. BG95&BG77&BG600L_Series_Voice_Application_Note 17 / 43 LPWA Module Series NOTE 1. Any additional commands on the same command line are ignored. 2. This command may be aborted generally by receiving a character during execution. It cannot be aborted during some connection establishments such as handshaking. 3. See also ATX. 4.4. ATH Disconnect Existing Connection This command disconnects and terminates existing data call or voice call. AT+CHUP is also used to disconnect voice call. See Chapter 4.7 for details. ATH Disconnect Existing Connection Execution Command ATH[] Response OK Or ERROR Maximum Response Time Characteristics Reference V.25ter If there is any error related to ME functionality: +CME ERROR: 90 s, determined by the network. - Parameter Integer type. 0 Disconnect and terminate existing call from command line. Error code. See Chapter 8 for details. Example RING OK ATH OK //Ring tone. //When AT+CVHU=0, hang up the call. BG95&BG77&BG600L_Series_Voice_Application_Note 18 / 43 LPWA Module Series 4.5. AT+CVHU Voice Call Hang Up Control This command controls whether ATH can be used to disconnect the voice call. AT+CVHU Voice Call Hang Up Control Test Command AT+CVHU=? Response +CVHU: (list of supported s) Read Command AT+CVHU? OK Response +CVHU: Write Command AT+CVHU= OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP TS 27.007 If there is an error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. 0 ATH can be used to disconnect the voice call. 1 ATH is ignored with the response OK returned only. Error code. See Chapter 8 for details. BG95&BG77&BG600L_Series_Voice_Application_Note 19 / 43 LPWA Module Series 4.6. AT+CLCC List Current Calls of ME The Execution Command returns the list of all voice calls of ME. If the command is executed successfully, but no call exists, then only OK is sent to TE. AT+CLCC List Current Calls of ME Test Command AT+CLCC=? Execution Command AT+CLCC Response OK Response TA returns the list of all current calls of ME. If the command is executed successfully, but no calls exists, then only OK is sent to TE. [+CLCC: ,,,,[,,[,< alpha>]]] [+CLCC: ,,,,[,,[,< alpha>]]] [...] OK Or ERROR Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: 300 ms - Parameter Integer type. Call identification number (starting with 1). See 3GPP TS 22.030 subclause 6.5.5.1 for details. Integer type. 0 Mobile originated (MO) call 1 Mobile terminated (MT) call Integer type. Call state. 0 Active 1 Held 2 Dialing (MO call) 3 Alerting (MO call) 4 Incoming (MT call) 5 Waiting (MT call) Integer type. Bearer/teleservice. 0 Voice BG95&BG77&BG600L_Series_Voice_Application_Note 20 / 43 LPWA Module Series 1 Data 2 Fax Integer type. 0 Call is not one of the multiparty (conference) call parties 1 Call is one of the multiparty (conference) call parties String type. Phone number in format specified by . Integer type. Address type in octet format (See 3GPP TS 24.008 subclause 10.5.4.7 for details). Usually, it has three values: 129 Unknown type 145 International type (contains character '+') 161 National type Alphanumeric representation of corresponding to the entry found in phonebook. Error code. See Chapter 8 for details. Example ATD10086; //Dial a number. OK AT+CLCC +CLCC: 2,0,0,0,0,'10086',129 //Dial a number, and the call has been answered. OK 4.7. AT+CHUP Hang up a Call This command cancels any voice call in the state of Active, Waiting or Held. To cancel data call, use ATH. See Chapter 4.4 for details. AT+CHUP Hang up a Call Test Command AT+CHUP=? Execution Command AT+CHUP Response OK Response OK Or ERROR Maximum Response Time Characteristics If there is an error related to ME functionality: +CME ERROR: 90 s, determined by the network. - BG95&BG77&BG600L_Series_Voice_Application_Note 21 / 43 Reference 3GPP 27.007 Parameter Error code. See Chapter 8 for details. Example RING AT+CHUP OK //Ring tone. //Hang up the call. LPWA Module Series 4.8. AT+QIIC Read/ Write Codec Through IIC This command reads and writes the codec through the IIC interface. AT+QIIC Read/ Write Codec Through IIC Test Command AT+QIIC=? Response +QIIC: (list of supported s),(range of supported s),(range of supported s),(list of supported s),(range of supported s) Write Command AT+QIIC=,,,[,] OK Response If =0, all configuration parameters are specified: OK If =1, is omitted: +QIIC: Maximum Response Time Characteristics OK Or ERROR 300 ms The command takes effect immediately. The configurations are not saved. BG95&BG77&BG600L_Series_Voice_Application_Note 22 / 43 LPWA Module Series Parameter Integer type. 0 Write codec through IIC 1 Read codec through IIC Hexadecimal integer type with prefix '0x'. 7-bit slave device address (address of ALC5616: 0x1B; address of NAU8814, NAU88C10: 0x1A, TLV320AIC3104: 0x18 and MAX9860: 0x10). Range: 0–0xFF. Hexadecimal integer type with prefix '0x'. Register address. Range: 0–0xFF. Integer type. Length of the read or write byte(s). Value: 1, 2. Hexadecimal integer type with prefix '0x'. Data value. Range: 0–0xFFFF. Example AT+QIIC=1,0x1B,0x00,2 +QIIC: 0x0021 //Read register value; slave device address: 0x1B; register address: 0x00; read two bytes. OK AT+QIIC=0,0x1B,0x00,2,0x0000 OK //Write register value; slave device address: 0x1B; register address: 0x00; write two bytes; data value: 0x0000. NOTE is 7-bit slave device address (read or write bit not included), which can be found in the device datasheet. 4.9. AT+QDAI Configure Digital Audio Interface This command configures the digital audio interface. AT+QDAI Configure Digital Audio Interface Test Command AT+QDAI=? Response +QDAI: (list of supported s) Read Command AT+QDAI? OK Response +QDAI: OK BG95&BG77&BG600L_Series_Voice_Application_Note 23 / 43 LPWA Module Series Write Command AT+QDAI= Maximum Response Time Characteristics Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 0 Analog input and output (for audio codec NAU88C10) 1 Analog input and output (for audio codec NAU8814) 2 Analog input and output (for audio codec ALC5616) 3 Analog input and output (for audio codec TLV320AIC3104) 4 Analog input and output (for audio codec MAX9860) 99 Close all external codecs. Example AT+QDAI=? +QDAI: (0-4,99) OK AT+QDAI? +QDAI: 1 OK AT+QDAI=2 OK //Query the current interface configuration. //Set the analog output to ALC5616. 4.10. AT+CLVL Configure Loudspeaker Volume This command configures the volume of the internal loudspeaker of the MT. AT+CLVL Configure Loudspeaker Volume Test Command AT+CLVL=? Response +CLVL: (range of supported s) Read Command OK Response BG95&BG77&BG600L_Series_Voice_Application_Note 24 / 43 LPWA Module Series AT+CLVL? Write Command AT+CLVL= Maximum Response Time Characteristics +CLVL: OK Response OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Volume level with manufacturer specific range (Smallest value represents the lowest sound level). Range: 0–5. Default value: 3. Example AT+CLVL=? +CLVL: (0-5) OK AT+CLVL? +CLVL: 3 OK AT+CLVL=2 OK //Query the current volume level. //Set the volume level to 2. 4.11. AT+CMUT Muting Control This command enables or disables muting in the Tx/Rx direction during a voice call. AT+CMUT Muting Control Test Command AT+CMUT=? Response +CMUT: (list of supported s),(list of supported s) Write Command OK Response BG95&BG77&BG600L_Series_Voice_Application_Note 25 / 43 LPWA Module Series AT+CMUT=, Maximum Response Time Characteristics OK Or ERROR 300 ms The command takes effect immediately. The configurations are not saved and must be set during the call. Parameter Integer type. 0 Tx direction 1 Rx direction Integer type 0 Mute off 1 Mute on Example AT+CMUT=? +CMUT: (0,1),(0,1) OK AT+CMUT=1,1 OK //Mute on in Rx direction. 4.12. AT+QPCMCFG Configure PCM Interface This command configures the PCM interface. AT+QPCMCFG Configure PCM Interface Test Command AT+QPCMCFG=? Response +QPCMCFG: (list of supported s),(range of supported s),(range of supported s),(list of supported s) Read Command AT+QPCMCFG? OK Response +QPCMCFG: ,,, BG95&BG77&BG600L_Series_Voice_Application_Note 26 / 43 LPWA Module Series OK Write Command AT+QPCMCFG=,,, Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect after re-running voice call. The configurations are saved automatically. Parameter Integer type. 0 Short frame sync 1 Long frame sync Integer type. Bits width per frame. 0 8 bits (not supported currently) 1 16 bits (not supported currently) 2 32 bits 3 64 bits 4 128 bits 5 256 bits Integer type. Quant type in PCM format. 0 A-law no padding 1 Mu-law no padding 2 linear no padding (supported only) 3 A-law padding 4 Mu-law padding 5 linear padding Integer type. 1 16-bit PCM (supported only) 2 24-bit PCM 4 32-bit PCM Example AT+QPCMCFG=? +QLDTMF: (0,1),(0-5),(0-5),(1,2,4) OK AT+QPCMCFG=1,5,2,1 OK //Configure the PCM interface. BG95&BG77&BG600L_Series_Voice_Application_Note 27 / 43 LPWA Module Series NOTE Default: 2.048 MHz BCLK, 8 KHz (supported only) sampling rate, audio PCM only in master mode. 4.13. AT+QLDTMF Play Local DTMF This command plays a local DTMF tone. AT+QLDTMF Play Local DTMF Test Command AT+QLDTMF=? Response +QLDTMF: (list of supported s),(range of supported s),(range of supported s) Write Command AT+QLDTMF=, , OK Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configurations are not saved. Parameter String type. DTMF character. Range: 0–9, A–D, *, #. Integer type. DTMF tone play time duration. Range: 0–65535. Integer type. DTMF tone play volume gain. Range: 0–65535. Example AT+QLDTMF=? +QLDTMF: (0-9,A-D,*,#),(0-65535),(0-65535) OK AT+QLDTMF=2,200,200 OK //Play '2' DTMF tone whose volume gain is 200 for 200 ms. BG95&BG77&BG600L_Series_Voice_Application_Note 28 / 43 LPWA Module Series 4.14. AT+VTS DTMF and Tone Generation This command sends ASCII characters which cause MSC to transmit DTMF tones to a remote subscriber. This command can only be executed in a voice call. AT+VTS DTMF and Tone Generation Test Command AT+VTS=? Response +VTS: (list of supported s) Execution Command AT+VTS= OK Response OK Or ERROR Maximum Response Time Characteristics Reference 3GPP 27.007 If there is an error related to ME functionality: +CME ERROR: 300 ms - Parameter String type. DTMF character. Range: 0–9, A–D. *, #. Error code. See Chapter 8 for details. Example ATD12345678900; OK //Call connects. AT+VTS=1 OK //Dial. //The remote caller can hear the DTMF tone. NOTE This command cannot send multiple tones at one time. BG95&BG77&BG600L_Series_Voice_Application_Note 29 / 43 LPWA Module Series 4.15. AT+QTONEDET Enable/Disable DTMF Detection This command enables or disables DTMF detection during CS voice or VoLTE call. If this function is enabled, DTMF tones sent by the other side are detected and reported on the assigned serial port. AT+QTONEDET Enable/Disable DTMF Detection Test Command AT+QTONEDET=? Response +QTONEDET: (list of supported s) Read Command AT+QTONEDET? OK Response +QTONEDET: Write Command AT+QTONEDET= Maximum Response Time Characteristics OK Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Enable or disable DTMF detection. 0 Disable 1 Enable Example AT+QTONEDET=? +QTONEDET: (0,1) OK AT+QTONEDET=1 OK //Enable DTMF detection. BG95&BG77&BG600L_Series_Voice_Application_Note 30 / 43 NOTE DTMF characters - ASCII DTMF 0 1 2 3 4 5 6 7 ASCII 48 49 50 51 52 53 54 55 DTMF 8 9 A B C D * # LPWA Module Series ASCII 56 57 65 66 67 68 42 35 4.16. AT+QAUDLOOP Enable/Disable Audio Loop Test This command enables or disables the audio loop test. AFE loopback is supported to verify the audio hardware connection, as shown in the following figure. TX AFE RX Codec Microphone Speaker Figure 2: Data Path of AFE Loopback AT+QAUDLOOP Enable/Disable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (list of supporteds) OK BG95&BG77&BG600L_Series_Voice_Application_Note 31 / 43 LPWA Module Series Write Command AT+QAUDLOOP= Maximum Response Time Characteristics Response OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Enable or disable audio loop test. 0 Disable audio loop test 1 Enable audio loop test Example AT+QAUDLOOP=1 //Enable audio loop test, talk into the microphone, and the earphones can hear you. OK 4.17. AT+QINDCFG Configure URC Indication This command configures the URC indication. AT+QINDCFG Configure URC Indication Test command AT+QINDCFG=? Response +QINDCFG: 'all',(list of supported s),(list of supported s) +QINDCFG: 'csq',(list of supported s),(list of supported s) +QINDCFG: 'smsfull',(list of supported s),(list of supported s) +QINDCFG: 'ring',(list of supported s),(list of supported s) +QINDCFG: 'smsincoming',(list of supported s),(list of supported s) +QINDCFG: 'ccinfo',(list of supported s),(list of supported s) Write command OK Response BG95&BG77&BG600L_Series_Voice_Application_Note 32 / 43 LPWA Module Series AT+QINDCFG=[,[,]] If the optional parameters are omitted, query the current configuration: +QINDCFG: , OK If the optional parameters are specified, configure the URC indication: OK Or ERROR Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. determines whether the configuration is saved. Parameter String type. URC type. 'all' Main switch of all URCs. default value is 1 (ON). 'csq' Indication of signal strength and signal channel bit error rate change. default value is 0 (OFF). If it is 1, +QIND: 'csq',, is reported. 'smsfull' Indication of full SMS storage. default value is 0. If it is 0, +QIND: 'smsfull', is reported. 'ring' Indication of 'RING'. default value is 1. 'smsincoming' Indication of Incoming message. default value is 1. Related URCs include +CMTI, +CMT, +CDS. 'ccinfo' Indication of voice call state change. default value is 0. If it is 1, the URC indication is enabled and +QIND: 'ccinfo',,,,,, ,[,] is reported (see Chapter 4.6 for details about the parameters). Integer type. URC indication is ON or OFF. 0 OFF 1 ON Integer type. Whether to save the configuration into NVRAM. 0 Not save 1 Save BG95&BG77&BG600L_Series_Voice_Application_Note 33 / 43 Example AT+QINDCFG=? +QINDCFG: 'all',(0,1),(0,1) +QINDCFG: 'csq',(0,1),(0,1) +QINDCFG: 'smsfull',(0,1),(0,1) +QINDCFG: 'ring',(0,1),(0,1) +QINDCFG: 'smsincoming',(0,1),(0,1) +QINDCFG: 'ccinfo',(0,1),(0,1) OK AT+QINDCFG='ring',0 OK AT+QINDCFG='ccinfo',1 OK //Disable RING URC report. //Enable ccinfo URC report. LPWA Module Series BG95&BG77&BG600L_Series_Voice_Application_Note 34 / 43 LPWA Module Series 5 Description of URCs 5.1. RING URC The RING URC indicates an incoming call signal from network. RING URC RING An incoming call. 5.2. Alert URC When you make a call by executing ATD, there will be a RING URC in the remote terminal. In the local terminal, we can get an Alert URC returned instead of RBT (RING BACK TONE). Alert URC +ALERTING: ,, Peer side is ringing. Parameter Integer type. Call ID. Call identification number as described in 3GPP TS 22.030. String type. Phone number. Integer type. Type of phone number. 129 Unknown type 145 International type (contains character '+') 161 National type Example ATD505010000000045; //Dial a number. OK //Alert URC +ALERTING: 3,505010000000045,129 //Peer side is ringing. ATH OK BG95&BG77&BG600L_Series_Voice_Application_Note 35 / 43 LPWA Module Series 6 Issue Analysis If an outgoing call fails, check whether the wrong number is dialed first, and then check whether IMS is registered successfully. If the two mentioned preconditions are correct, further analyze the phonetic problems. Before analyzing, make certain the direction that whether it is an uplink problem or a downlink problem. After identifying the direction, pinpoint the type of the problem, such as intermittence, noise, silence, howling, etc. TX VOC Uplink Path ADC Microphone Downlink Path DAC Codec (Control Volume, Audio Stream Path) Module ADSP (Control Volume, Echo Cancellation, Noise Suppression, Mixer by acdb File) Speaker RX VOC Network Figure 3: Voice Flow Factors Affecting Voice Quality: ⚫ Network condition: if the test is conducted in a weak-signal area. ⚫ Channel condition: if the test is conducted in a fading/poor channel or if the channel condition results in CRC errors. ⚫ ADSP processing: if ADSP parameters are set wrongly. ⚫ Packet loss/miss: if the packet is lost in the network or the packet is missed in the system. ⚫ Codec: if an incorrect codec type is selected or a wrong registration parameter (see AT+QDAI, AT+QIIC and 3GPP TS 26.103) is configured. ⚫ PCM interface: if unsuitable parameters (see AT+QPCMCFG) with a selected codec are configured. NOTE BG95 series, BG77 and BG600L-M3 modules do not support adjusting ADSP parameters in real time BG95&BG77&BG600L_Series_Voice_Application_Note 36 / 43 by AT command. LPWA Module Series 6.1. Direction-Related Problem Analysis Making it clear whether the problem occurred on the uplink or downlink side, on the home side or peer side, is the key step to solving the problem. Uplink: If the TX VOC itself has any problem, there is no need to analyze the problem from the perspective of the protocol. If the TX VOC sounds good but the downlink sounds bad on the other end, it is necessary to capture the logs on both sides of the calling and called parties. This scenario can be regarded as the most complex one because there may be a problem with the callee on the remote party, or may be a problem with the local caller. Therefore, we need to compare the logs of both sides and analyze the logs together. Downlink: If the RX VOC itself sounds good but the subsequent PCM sounds bad, there is no need to analyze the problem from the perspective of the protocol. You only need to check whether the Codec and PCM are configured correctly. The RX VOC problem is the most common voice problem. Generally, it is necessary to start from the access layer and make a comprehensive analysis based on the current network coverage, wireless environment, signal-to-noise ratio, bit error rate and other factors. In fact, the vast majority of such problems are caused by poor network coverage. NOTE Be careful when capturing logs. First, select a dedicated audio log mask to capture the log before calling. Then, keep talking for about a minute. Last, hang up. 6.2. Protocol-Related Problem Analysis Voice analysis of common protocols is point-to-point analysis. That is, the time point at which the voice is faulty must be determined in the voice file generated by playback. By observing SNR and RSRP methods to measure the wireless environment at that time. When RSRP is lower than -95 dBm, the wireless environment is considered to be average, and when RSRP is lower than -105 dBm, the wireless environment is considered to be very poor. RxQual represents a bit error rate level, which is a very valid statistic for SNR. Generally, if RxQual is greater than 4 or CRC is 'Fail', or SNR is less than 0, it is difficult to ensure the voice quality. BG95&BG77&BG600L_Series_Voice_Application_Note 37 / 43 LPWA Module Series 6.2.1. VoLTE Issue Analysis From the image below, we can see that the current network condition is very poor because RSRP is less than -105 dBm, which may affect voice quality. Generally, it is not ideal for users to dial in the circumstance. Figure 4: Poor Network Condition in VoLTE 6.2.2. CS-Voice over GSM Issue Analysis From the images below, we can see that RxQual is 7 (greater than 4) in Figure 5 and CRC is 'Fail' in Figure 6. All these data represent the poor channel condition under GSM network, under which circumstances users may hear discontinuous sounds when making a call. BG95&BG77&BG600L_Series_Voice_Application_Note 38 / 43 LPWA Module Series Figure 5: Poor Channel Condition in CS-Voice (1) Figure 6: Poor Channel Condition in CS-Voice (2) BG95&BG77&BG600L_Series_Voice_Application_Note 39 / 43 LPWA Module Series 7 Appendix A References Table 3: Related Document Document Name [1] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual Table 4: Terms and Abbreviations Abbreviation ADSP AMR-NB AMR-WB CLIR COLP CRC CSFB DAN DTMF EVS E-UTRA(N) G.711 IMS IPsec IWLAN Description Audio Digital Signal Processor Adaptive Multi-rate Narrow Band Adaptive Multi-rate Wide Band Calling Line Identification Restriction Connected Line Identification Presentation Cyclic Redundancy Check Circuit Switched Fallback Domain Availability Notification Dual-tone multi-frequency Enhance Voice Services Evolved Universal Terrestrial Radio Access (Network) ITU-T Standard Pulse Code Modulation (PCM) of Voice Frequencies IP Multimedia Subsystem Internet Protocol Security Industrial Wireless LAN BG95&BG77&BG600L_Series_Voice_Application_Note 40 / 43 MO MSC MT MWI PDN PCM QCI QoS RAT RCS ROHC RTP RTT SDP SMS SIP SRVCC TTY UDP VICE VoLTE LPWA Module Series Mobile Originated Mobile-services Switching Centre Mobile Terminated Message Waiting Indicator Packet Data Network Pulse Code Modulation QoS Class Identifier Quality of Service Radio Access Technology Rich Communication Suite Robust Header Compression Real-time Transport Protocol Real-Time Text Session Description Protocol Short Message Service Session Initiation Protocol Single Radio Voice Call Continuity Teletypewriter User Datagram Protocol VoLTE for Internet-connected Endpoint Voice over LTE BG95&BG77&BG600L_Series_Voice_Application_Note 41 / 43 LPWA Module Series 8 Appendix B Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation of +CME ERROR: final result code is similar to the regular ERROR result code: if +CME ERROR: is the result code for any of the commands in a command line, none of the following commands in the same command line is executed (neither ERROR nor OK result code shall be returned as a result of a completed command line execution). The format of can be either numeric or verbose. This is set with AT+CMEE. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. Table 5: Different Coding Schemes of +CME ERROR: Code of 0 1 2 3 4 5 6 7 10 11 12 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required BG95&BG77&BG600L_Series_Voice_Application_Note 42 / 43 LPWA Module Series 13 (U)SIM failure 14 (U)SIM busy 15 (U)SIM wrong 16 Incorrect password 17 (U)SIM PIN2 required 18 (U)SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required BG95&BG77&BG600L_Series_Voice_Application_Note 43 / 43

EP06&EG06&EM06 系列 数据拨号应用指导 LTE-A 模块系列 版本：1.0 日期：2022-09-17 状态：受控文件 EP06&EG06&EM06 系列数据拨号应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 17 EP06&EG06&EM06 系列数据拨号应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 17 EP06&EG06&EM06 系列数据拨号应用指导 文档历史 修订记录 版本 日期 作者 - 2022-05-13 Ozzy ANG 1.0 2022-09-17 Ozzy ANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 17 EP06&EG06&EM06 系列数据拨号应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 数据拨号类型......................................................................................................................................... 8 2.1. 数据拨号场景分类 ...................................................................................................................... 8 2.2. 数据拨号方式.............................................................................................................................. 9 3 数据拨号步骤....................................................................................................................................... 10 3.1. NDIS 拨号（USB + TE + Windows + QMI） ........................................................................... 10 3.2. QMI_WWAN 拨号（USB + TE + Linux + QMI） ......................................................................11 3.3. GobiNet 拨号（USB + TE + Linux + QMI） ............................................................................ 12 3.4. MBIM 拨号（USB + TE + Linux + MBIM）.............................................................................. 13 3.5. MBIM 拨号（USB + TE + Windows + MBIM）........................................................................ 14 3.6. ECM 拨号（USB + AP + Linux）............................................................................................. 15 3.7. ECM 拨号（USB + AP + Windows）....................................................................................... 15 4 附录 参考文档及术语缩写 .................................................................................................................. 17 上海移远通信技术股份有限公司 4 / 17 EP06&EG06&EM06 系列数据拨号应用指导 表格索引 表 1：拨号条件及对应拨号方式 ................................................................................................................... 9 表 2：参考文档 ........................................................................................................................................... 17 表 3：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 5 / 17 EP06&EG06&EM06 系列数据拨号应用指导 图片索引 图 1：确认驱动安装成功 ............................................................................................................................ 10 图 2：NDIS 拨号（USB + TE + Windows + QMI） ................................................................................... 10 图 3：MBIM 拨号（USB + TE + Windows + MBIM）................................................................................ 14 图 4：ECM 拨号（USB + AP + Windows）............................................................................................... 16 上海移远通信技术股份有限公司 6 / 17 EP06&EG06&EM06 系列数据拨号应用指导 1 引言 移远通信 LTE-A 系列模块 EP06 系列、EG06 系列和 EM06 系列支持数据拨号功能，本文档介绍模块 支持的数据拨号方式以及各数据拨号方式的拨号步骤和注意事项。 上海移远通信技术股份有限公司 7 / 17 EP06&EG06&EM06 系列数据拨号应用指导 2 数据拨号类型 2.1. 数据拨号场景分类 1. 按照数据拨号中主机和模块之间的通信方式分类： 1) QMI 通信类（应用层通信协议） 2) MBIM 通信类（应用层通信协议） 3) 无通信（标准接口底层通信协议：Ethernet、Wi-Fi 等） 2. 按照数据拨号使用的接口种类区分：USB 3. 按照数据拨号中拨号发起者分类： 1) 主机发起 – TE 2) 模块自行发起 – AP 4. 按照数据拨号中主机操作系统分类： 1) Windows 2) Linux（Android） 上海移远通信技术股份有限公司 8 / 17 EP06&EG06&EM06 系列数据拨号应用指导 2.2. 数据拨号方式 根据上述分类，模块支持的数据拨号条件以及对应的拨号方式列举如下： 表 1：拨号条件及对应拨号方式 接口类型 拨号发起者 USB TE USB TE USB TE USB AP USB AP 主机操作系统 Windows Linux Windows/Linux Windows Linux 通信方式 QMI QMI MBIM - 对应拨号方式 NDIS QMI_WWAN/GobiNet MBIM (USB) ECM ECM 备注 1. 对应拨号方式以驱动名称命名。 2. 对应拨号方式的具体拨号步骤，详情见第 3 章。相关 AT 命令请参考文档 [1]，如参考文档未包含， 请联系移远通信技术支持获取相关 AT 命令详情。 上海移远通信技术股份有限公司 9 / 17 EP06&EG06&EM06 系列数据拨号应用指导 3 数据拨号步骤 3.1. NDIS 拨号（USB + TE + Windows + QMI） 1. 主机安装由移远通信提供的 NDIS 驱动 Quectel_Windows_USB_Driver(Q)_For_NDIS。 2. 通过 USB 连接模块至主机。 3. 打开主机'网络适配器'确认如下名称的驱动已加载。 图 1：确认驱动安装成功 4. 点击主机桌面右下角网络图标开始拨号。 图 2：NDIS 拨号（USB + TE + Windows + QMI） 上海移远通信技术股份有限公司 10 / 17 EP06&EG06&EM06 系列数据拨号应用指导 3.2. QMI_WWAN 拨号（USB + TE + Linux + QMI） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) Quectel_Linux&Android_QMI_WWAN_Driver（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod qmi_wwan_q.ko qmap_mode=4 Q map_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 如需使用驱动进行桥接模式（即将拨号桥接到主机下端其他设备，为其他设备提供网络）拨 号，可参考 quectel-CM 工具源码包中 log/目录下的如下示例： log/how_to_use_bridge.txt 单路拨号的桥接 log/how_to_use_bridge_and_QMAP.txt 多路拨号的桥接 4) 使用移远通信模块时，请务必不要使用 Linux 原生驱动（qmi_wwan.ko 和 qcserial.ko 驱动）。 可通过 lsmod 查询当前是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生 驱动。主机连接模块前，需确认已安装由移远通信提供的 qmi_wwan_q.ko、option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： qmi_wwan_q.txt qmi_wwan_q_bridge.txt qmi_wwan_q_qmap=1.txt qmi_wwan_q_qmap=1_bridge.txt qmi_wwan_q_qmap=4.txt qmi_wwan_q_qmap=4_bridge.txt 单路无 QMAP 本地拨号 单路无 QMAP 桥接拨号 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 上海移远通信技术股份有限公司 11 / 17 EP06&EG06&EM06 系列数据拨号应用指导 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 强 制 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1 。 因 此 ， qmi_wwan_q.txt 和 qmi_wwan_q_bridge.txt 在 实 际 使 用 中 等 同 于 qmi_wwan_q_qmap=1.txt 和 qmi_wwan_q_qmap=1_bridge.txt。 3.3. GobiNet 拨号（USB + TE + Linux + QMI） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) Quectel_Linux&Android_GobiNet_Driver（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod GobiNet.ko qmap_mode=4 Q map_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 驱动安装成功后，会覆盖 Linux 原生 GobiNet 驱动。另外，使用移远通信模块时，请务必不 要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前是否已经安装 Linux 原生驱动 （GobiNet + qcserial.ko），若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之前， 需确认已安装由移远通信提供的 GobiNet.ko、option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： gobinet.txt gobinet_bridge.txt 单路无 QMAP 本地拨号 单路无 QMAP 桥接拨号 上海移远通信技术股份有限公司 12 / 17 EP06&EG06&EM06 系列数据拨号应用指导 gobinet_qmap=1.txt gobinet_qmap=1_bridge.txt gobinet_qmap=4.txt gobinet_qmap=4_bridge.txt 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 强 制 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1。因此，gobinet.txt 和 gobinet_bridge.txt 在实际使用中等同于 gobinet_qmap=1.txt 和 gobinet_qmap=1_bridge.txt。 3.4. MBIM 拨号（USB + TE + Linux + MBIM） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) cdc_mbim_drv_Linux（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 mbim_qmap_mode=< 多路拨号路数>，目前模块支持的最大路数为 16,。示例如下： insmod quec_cdc_mbim.ko mbim_qmap_mode=4 3) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前 是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之 前，需确认已经安装由移远通信提供的 quec_cdc_mbim.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 AT+QCFG='usbnet',2 设置模块网卡数据拨号方式为 MBIM 模式。 5. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： cdc_mbim.txt 单路 QMAP 本地拨号 上海移远通信技术股份有限公司 13 / 17 EP06&EG06&EM06 系列数据拨号应用指导 cdc_mbim_vlan.txt 多路 QMAP 本地拨号 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模块强制启用 QMAP 功能，即使加载驱动时未配置 mbim_qmap_mode，运行驱动时将强制打开 mbim_qmap_mode=1。 3.5. MBIM 拨号（USB + TE + Windows + MBIM） 1. 通过 USB 连接模块至主机。 2. 执行 AT+QCFG='usbnet',2 设置模块网卡数据拨号方式为 MBIM 模式。 3. 确认主机 Windows 系统中对该设备加载的驱动为默认 MBIM 驱动。 4. 点击主机桌面右下角网络图标开始拨号。 图 3：MBIM 拨号（USB + TE + Windows + MBIM） 上海移远通信技术股份有限公司 14 / 17 EP06&EG06&EM06 系列数据拨号应用指导 3.6. ECM 拨号（USB + AP + Linux） 1. 联系移远通信技术支持获取如下驱动安装包： Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2. 在主机中集成/编译如上驱动。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询确认 当前是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块 之前，需确认已经安装由移远通信提供的 option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 首次启动模块，通过 AT 口/dev/ttyUSB2（模块的第三个 TTY 口）发送 AT+QCFG='usbnet',1 配 置拨号方式为 ECM。 5. 重启模块。 6. 重启后，主机自动匹配 Linux 原生 ECM 驱动并生成基于 USB 的虚拟以太网接口 usb0。此时模块 自行在内部进行拨号通过 NAT 向主机提供网络。主机只需向 ECM 网卡发送 DHCP 请求 IP 地址即 可。 3.7. ECM 拨号（USB + AP + Windows） 1. 联系移远通信技术支持获取 Windows 平台的 ECM 驱动并安装： Quectel_LTE_Windows_USB_Driver_For_ECM 2. 通过 USB 连接模块至主机。 3. 首次启动模块，通过 AT 口向模块发送 AT+QCFG='usbnet',1 配置拨号方式为 ECM。 4. 重启模块。 5. 确认主机已安装移远通信提供的 ECM 驱动并已为该设备加载 ECM。随后，主机 Windows 系统生 成基于 USB 的虚拟以太网接口，并自动通过 DHCP 获取到 IP 地址。 上海移远通信技术股份有限公司 15 / 17 EP06&EG06&EM06 系列数据拨号应用指导 图 4：ECM 拨号（USB + AP + Windows） 上海移远通信技术股份有限公司 16 / 17 EP06&EG06&EM06 系列数据拨号应用指导 4 附录 参考文档及术语缩写 表 2：参考文档 文档名称 [1] Quectel_EP06&EG06&EM06_AT_Commands_Manual 表 3：术语缩写 缩写 AP DHCP ECM ETH IP MBIM MHI NAT NDIS QMI TE UL AGG USB WLAN WWAN 英文全称 Application Processor Dynamic Host Configuration Protocol Ethernet Control Model Ethernet Internet Protocol Mobile Broadband Interface Model Modem Host Interface Network Address Translation Network Driver Interface Specification Qualcomm Message Interface Terminal Equipment Uplink Aggregation Universal Serial Bus Wireless Local Area Network Wireless Wide Area Network 中文全称 应用处理器 动态主机设置协议 以太网控制模型 以太网 网际互连协议 移动宽带接口模型 调制解调器主机接口 网络地址转换 网络驱动接口规范 高通信息接口 终端设备 上行聚合 通用串行总线 无线局域网 无线广域网 上海移远通信技术股份有限公司 17 / 17

EM12&EG12&EG18 系列 数据拨号应用指导 LTE-A 模块系列 版本：1.0 日期：2022-09-17 状态：受控文件 EM12&EG12&EG18 系列数据拨号应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 17 EM12&EG12&EG18 系列数据拨号应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 17 EM12&EG12&EG18 系列数据拨号应用指导 文档历史 修订记录 版本 日期 作者 - 2022-05-13 Ozzy ANG 1.0 2022-09-17 Ozzy ANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 17 EM12&EG12&EG18 系列数据拨号应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 数据拨号类型......................................................................................................................................... 8 2.1. 数据拨号场景分类 ...................................................................................................................... 8 2.2. 数据拨号方式.............................................................................................................................. 9 3 数据拨号步骤....................................................................................................................................... 10 3.1. NDIS 拨号（USB + TE + Windows + QMI） ........................................................................... 10 3.2. QMI_WWAN 拨号（USB + TE + Linux + QMI） ......................................................................11 3.3. GobiNet 拨号（USB + TE + Linux + QMI） ............................................................................ 12 3.4. MBIM 拨号（USB + TE + Linux + MBIM）.............................................................................. 13 3.5. MBIM 拨号（USB + TE + Windows + MBIM）........................................................................ 14 3.6. ECM 拨号（USB + AP + Linux）............................................................................................. 15 3.7. ECM 拨号（USB + AP + Windows）....................................................................................... 15 4 附录 参考文档及术语缩写 .................................................................................................................. 17 上海移远通信技术股份有限公司 4 / 17 EM12&EG12&EG18 系列数据拨号应用指导 表格索引 表 1：拨号条件及对应拨号方式 ................................................................................................................... 9 表 2：参考文档 ........................................................................................................................................... 17 表 3：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 5 / 17 EM12&EG12&EG18 系列数据拨号应用指导 图片索引 图 1：确认驱动安装成功 ............................................................................................................................ 10 图 2：NDIS 拨号（USB + TE + Windows + QMI） ................................................................................... 10 图 3：MBIM 拨号（USB + TE + Windows + MBIM）................................................................................ 14 图 4：ECM 拨号（USB + AP + Windows）............................................................................................... 16 上海移远通信技术股份有限公司 6 / 17 EM12&EG12&EG18 系列数据拨号应用指导 1 引言 移远通信 LTE-A 模块 EG12 系列、EG18 系列和 EM12-G 支持数据拨号功能，本文档介绍模块支持的 数据拨号方式以及各数据拨号方式的拨号步骤和注意事项。 上海移远通信技术股份有限公司 7 / 17 EM12&EG12&EG18 系列数据拨号应用指导 2 数据拨号类型 2.1. 数据拨号场景分类 1. 按照数据拨号中主机和模块之间的通信方式分类： 1) QMI 通信类（应用层通信协议） 2) MBIM 通信类（应用层通信协议） 3) 无通信（标准接口底层通信协议：Ethernet、Wi-Fi 等） 2. 按照数据拨号使用的接口种类区分：USB 3. 按照数据拨号中拨号发起者分类： 1) 主机发起 – TE 2) 模块自行发起 – AP 4. 按照数据拨号中主机操作系统分类： 1) Windows 2) Linux（Android） 上海移远通信技术股份有限公司 8 / 17 EM12&EG12&EG18 系列数据拨号应用指导 2.2. 数据拨号方式 根据上述第 2.1 章场景分类，模块支持的数据拨号场景以及对应的数据拨号方式列举如下： 表 1：拨号条件及对应拨号方式 接口类型 拨号发起者 USB TE USB TE USB TE USB AP USB AP 主机操作系统 Windows Linux Windows/Linux Windows Linux 通信方式 QMI QMI MBIM - 对应拨号方式 NDIS QMI_WWAN/GobiNet MBIM (USB) ECM ECM 备注 1. 对应拨号方式以驱动名称命名。 2. 对应拨号方式的具体拨号步骤，详情见第 3 章。相关 AT 命令请参考文档 [1]，如参考文档未包含， 请联系移远通信技术支持获取相关 AT 命令详情。 上海移远通信技术股份有限公司 9 / 17 EM12&EG12&EG18 系列数据拨号应用指导 3 数据拨号步骤 3.1. NDIS 拨号（USB + TE + Windows + QMI） 1. 主机安装由移远通信提供的 NDIS 驱动 Quectel_Windows_USB_Driver(Q)_For_NDIS。 2. 通过 USB 连接模块至主机。 3. 打开主机'网络适配器'确认如下名称的驱动已加载。 图 1：确认驱动安装成功 4. 点击主机桌面右下角网络图标开始拨号。 图 2：NDIS 拨号（USB + TE + Windows + QMI） 上海移远通信技术股份有限公司 10 / 17 EM12&EG12&EG18 系列数据拨号应用指导 3.2. QMI_WWAN 拨号（USB + TE + Linux + QMI） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) Quectel_Linux&Android_QMI_WWAN_ Driver（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod qmi_wwan_q.ko qmap_mode=4 qmap_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 如需使用驱动进行桥接模式（即将拨号桥接到主机下端其他设备，为其他设备提供网络）拨 号，可参考 quectel-CM 工具源码包中 log/目录下的如下示例： log/how_to_use_bridge.txt 单路拨号的桥接 log/how_to_use_bridge_and_QMAP.txt 多路拨号的桥接 4) 使用移远通信模块时，请务必不要使用 Linux 原生驱动（qmi_wwan.ko 和 qcserial.ko 驱动）。 可通过 lsmod 查询当前是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生 驱动。主机连接模块前，需确认已安装由移远通信提供的 qmi_wwan_q.ko、option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： qmi_wwan_q.txt qmi_wwan_q_bridge.txt qmi_wwan_q_qmap=1.txt qmi_wwan_q_qmap=1_bridge.txt qmi_wwan_q_qmap=4.txt qmi_wwan_q_qmap=4_bridge.txt 单路无 QMAP 本地拨号 单路无 QMAP 桥接拨号 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 上海移远通信技术股份有限公司 11 / 17 EM12&EG12&EG18 系列数据拨号应用指导 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 默 认 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1 。 因 此 ， qmi_wwan_q.txt 和 qmi_wwan_q_bridge.txt 在 实 际 使 用 中 等 同 于 qmi_wwan_q_qmap=1.txt 和 qmi_wwan_q_qmap=1_bridge.txt。 3.3. GobiNet 拨号（USB + TE + Linux + QMI） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) Quectel_Linux&Android_GobiNet_Driver（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod GobiNet.ko qmap_mode=4 qmap_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 驱动安装成功后，会覆盖 Linux 原生 GobiNet 驱动。另外，使用移远通信模块时，请务必不 要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前是否已经安装 Linux 原生驱动， 若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之前，需确认已安装由移远通信提 供的 GobiNet.ko、option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： gobinet.txt gobinet_bridge.txt 单路无 QMAP 本地拨号 单路无 QMAP 桥接拨号 上海移远通信技术股份有限公司 12 / 17 EM12&EG12&EG18 系列数据拨号应用指导 gobinet_qmap=1.txt gobinet_qmap=1_bridge.txt gobinet_qmap=4.txt gobinet_qmap=4_bridge.txt 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 强 制 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1。因此，gobinet.txt 和 gobinet_bridge.txt 在实际使用中等同于 gobinet_qmap=1.txt 和 gobinet_qmap=1_bridge.txt。 3.4. MBIM 拨号（USB + TE + Linux + MBIM） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) cdc_mbim_drv_Linux（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 mbim_qmap_mode=< 多路拨号路数>，目前模块支持的最大路数为 16,。示例如下： insmod quec_cdc_mbim.ko mbim_qmap_mode=4 3) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前 是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之 前，需确认已经安装由移远通信提供的 quec_cdc_mbim.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 AT+QCFG='usbnet',2 设置模块网卡数据拨号方式为 MBIM 模式。 5. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： 上海移远通信技术股份有限公司 13 / 17 EM12&EG12&EG18 系列数据拨号应用指导 cdc_mbim.txt 单路 QMAP 本地拨号 cdc_mbim_vlan.txt 多路 QMAP 本地拨号 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模块强制启用 QMAP 功能，即使加载驱动时未配置 mbim_qmap_mode，运行驱动时将强制打开 mbim_qmap_mode=1。 3.5. MBIM 拨号（USB + TE + Windows + MBIM） 1. 通过 USB 连接模块至主机。 2. 执行 AT+QCFG='usbnet',2 设置模块网卡数据拨号方式为 MBIM 模式。 3. 确认主机 Windows 系统中对该设备加载的驱动为默认 MBIM 驱动。 4. 点击主机桌面右下角网络图标开始拨号。 图 3：MBIM 拨号（USB + TE + Windows + MBIM） 上海移远通信技术股份有限公司 14 / 17 EM12&EG12&EG18 系列数据拨号应用指导 3.6. ECM 拨号（USB + AP + Linux） 1. 联系移远通信技术支持获取如下驱动安装包： Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2. 在主机中集成/编译如上驱动。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询确认 当前是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块 之前，需确认已经安装由移远通信提供的 option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 首次启动模块，通过 AT 口/dev/ttyUSB2（模块的第三个 TTY 口）发送 AT+QCFG='usbnet',1 配 置网卡数据拨号方式为 ECM。 5. 重启模块。 6. 重启后，主机自动匹配 Linux 原生 ECM 驱动并生成基于 USB 的虚拟以太网接口 usb0。此时模块 自行在内部进行拨号通过 NAT 向主机提供网络。主机只需向 ECM 网卡发送 DHCP 请求 IP 地址即 可。 3.7. ECM 拨号（USB + AP + Windows） 1. 联系移远通信技术支持获取 Windows 平台的 ECM 驱动并安装： Quectel_LTE_Windows_USB_Driver_For_ECM 2. 通过 USB 连接模块至主机。 3. 首次启动模块，通过 AT 口向模块发送 AT+QCFG='usbnet',1 配置网卡数据拨号方式为 ECM。 4. 重启模块。 5. 确认主机已安装移远通信提供的 ECM 驱动并已为该设备加载 ECM。随后，主机 Windows 系统生 成基于 USB 的虚拟以太网接口，并自动通过 DHCP 获取到 IP 地址。 上海移远通信技术股份有限公司 15 / 17 EM12&EG12&EG18 系列数据拨号应用指导 图 4：ECM 拨号（USB + AP + Windows） 上海移远通信技术股份有限公司 16 / 17 EM12&EG12&EG18 系列数据拨号应用指导 4 附录 参考文档及术语缩写 表 2：参考文档 文档名称 [1] Quectel_EM12&EG12&EG18_AT_Commands_Manual 表 3：术语缩写 缩写 AP DHCP ECM ETH IP MBIM MHI NAT NDIS QMI TE UL AGG USB WLAN WWAN 英文全称 Application Processor Dynamic Host Configuration Protocol Ethernet Control Model Ethernet Internet Protocol Mobile Broadband Interface Model Modem Host Interface Network Address Translation Network Driver Interface Specification Qualcomm Message Interface Terminal Equipment Uplink Aggregation Universal Serial Bus Wireless Local Area Network Wireless Wide Area Network 中文全称 应用处理器 动态主机设置协议 以太网控制模型 以太网 网际互连协议 移动宽带接口模型 调制解调器主机接口 网络地址转换 网络驱动接口规范 高通信息接口 终端设备 上行聚合 通用串行总线 无线局域网 无线广域网 上海移远通信技术股份有限公司 17 / 17

EG512R&EM12xR&EM160R 系列 数据拨号应用指导 LTE-A 模块系列 版本：1.0 日期：2022-09-17 状态：受控文件 EG512R&EM12xR&EM160R 系列数据拨号应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 文档历史 修订记录 版本 日期 作者 - 2022-05-13 Ozzy ANG 1.0 2022-09-17 Ozzy ANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 2 数据拨号类型......................................................................................................................................... 8 2.1. 数据拨号场景分类 ...................................................................................................................... 8 2.2. 数据拨号方式.............................................................................................................................. 9 3 数据拨号步骤....................................................................................................................................... 10 3.1. NDIS 拨号（USB + TE + Windows + QMI） ........................................................................... 10 3.2. QMI_WWAN 拨号（USB + TE + Linux + QMI） ......................................................................11 3.3. GobiNet 拨号（USB + TE + Linux + QMI） ............................................................................ 12 3.4. PCIe_MHI_Rmnet 拨号（PCIe + TE + Linux + QMI）............................................................ 13 3.5. MBIM 拨号（USB + TE + Linux + MBIM）.............................................................................. 14 3.6. MBIM 拨号（USB + TE + Windows + MBIM）........................................................................ 15 3.7. MBIM 拨号（PCIe + TE + Windows + MBIM） ....................................................................... 15 3.8. MBIM 拨号（PCIe + TE + Linux + MBIM） ............................................................................. 16 3.9. ECM 拨号（USB + AP + Linux）............................................................................................. 17 3.10. ECM 拨号（USB + AP + Windows）....................................................................................... 18 3.11. QMAP 拨号（RGMII + AP） .................................................................................................... 18 4 附录 参考文档及术语缩写 .................................................................................................................. 20 上海移远通信技术股份有限公司 4 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：拨号条件及对应拨号方式 ................................................................................................................... 9 表 3：参考文档 ........................................................................................................................................... 20 表 4：术语缩写 ........................................................................................................................................... 20 上海移远通信技术股份有限公司 5 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 图片索引 图 1：确认驱动安装成功 ............................................................................................................................ 10 图 2：NDIS 拨号（USB + TE + Windows + QMI） ................................................................................... 10 图 3：MBIM 拨号（USB + TE + Windows + MBIM）................................................................................ 15 图 4：MBIM 拨号（PCIe + TE + Windows + MBIM） ............................................................................... 16 图 5：ECM 拨号（USB + AP + Windows）............................................................................................... 18 上海移远通信技术股份有限公司 6 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 1 引言 移远通信 LTE-A 模块 EG512R-EA、EM120R-GL、EM121R-GL 和 EM160R-GL 模块支持数据拨号功 能，本文档介绍模块支持的数据拨号方式以及各数据拨号方式的拨号步骤和注意事项。 1.1. 适用模块 表 1：适用模块 适用模块 EG512R EM12xR EM160R EG512R-EA EM120R-GL EM121R-GL EM160R-GL 上海移远通信技术股份有限公司 7 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 2 数据拨号类型 2.1. 数据拨号场景分类 1. 按照数据拨号中主机和模块之间的通信方式分类： 1) QMI 通信类（应用层通信协议） 2) MBIM 通信类（应用层通信协议） 3) 无通信（标准接口底层通信协议：Ethernet、Wi-Fi 等） 2. 按照数据拨号使用的接口类型分类： 1) USB 2) PCIe EP（模块为设备端） 3) RGMII 3. 按照数据拨号中拨号发起者分类： 1) 主机发起 – TE 2) 模块自行发起 – AP 4. 按照数据拨号中主机操作系统分类： 1) Windows 2) Linux (Android) 上海移远通信技术股份有限公司 8 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 2.2. 数据拨号方式 根据上述第 2.1 章场景分类，模块支持的数据拨号场景以及对应的数据拨号方式列举如下： 表 2：拨号条件及对应拨号方式 接口类型 拨号发起者 USB TE USB TE USB TE PCIe EP TE PCIe EP TE USB AP USB AP RGMII AP 主机操作系统 Windows Linux Windows/Linux Linux Windows/Linux Windows Linux - 通信方式 QMI QMI MBIM QMI MBIM - 对应拨号方式 NDIS QMI_WWAN/GobiNet MBIM (USB) PCIe_MHI_Rmnet PCIe_MHI_MBIM ECM ECM QMAP 备注 1. 对应拨号方式以驱动名称命名。 2. 除 EG512R-EA 外，适用模块均支持 PCIe EP 但不支持 RGMII；EG512R-EA 支持 RGMII 但不支持 PCIe EP。 3. 对应拨号方式的具体拨号步骤，详情见第 3 章。相关 AT 命令请参考文档 [1]，如参考文档未包含， 请联系移远通信技术支持获取相关 AT 命令详情。 上海移远通信技术股份有限公司 9 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 3 数据拨号步骤 3.1. NDIS 拨号（USB + TE + Windows + QMI） 1. 主机安装由移远通信提供的 NDIS 驱动 Quectel_Windows_USB_Driver(Q)_For_NDIS。 2. 通过 USB 连接模块至主机。 3. 打开主机'网络适配器'查看是否加载如下名称的驱动。 图 1：确认驱动安装成功 4. 点击主机桌面右下角网络图标开始拨号。 图 2：NDIS 拨号（USB + TE + Windows + QMI） 上海移远通信技术股份有限公司 10 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 3.2. QMI_WWAN 拨号（USB + TE + Linux + QMI） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) Quectel_Linux&Android_QMI_WWAN_Driver（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod qmi_wwan_q.ko qmap_mode=4 qmap_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 如需使用驱动进行桥接模式（即将拨号桥接到主机下端其他设备，为其他设备提供网络）拨 号，可参考 quectel-CM 工具源码包中 log/目录下的如下示例： log/how_to_use_bridge.txt 单路拨号的桥接 log/how_to_use_bridge_and_QMAP.txt 多路拨号的桥接 4) 使用移远通信模块时，请务必不要使用 Linux 原生驱动（qmi_wwan.ko 和 qcserial.ko 驱动）。 可通过 lsmod 查询当前是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生 驱动。主机连接模块前，需确认已安装由移远通信提供的 qmi_wwan_q.ko、option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： qmi_wwan_q.txt qmi_wwan_q_bridge.txt qmi_wwan_q_qmap=1.txt qmi_wwan_q_qmap=1_bridge.txt qmi_wwan_q_qmap=4.txt qmi_wwan_q_qmap=4_bridge.txt 单路无 QMAP 本地拨号 单路无 QMAP 桥接拨号 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 上海移远通信技术股份有限公司 11 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 默 认 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1 。 因 此 ， qmi_wwan_q.txt 和 qmi_wwan_q_bridge.txt 在 实 际 使 用 中 等 同 于 qmi_wwan_q_qmap=1.txt 和 qmi_wwan_q_qmap=1_bridge.txt。 3.3. GobiNet 拨号（USB + TE + Linux + QMI） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) Quectel_Linux&Android_GobiNet_Driver（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod GobiNet.ko qmap_mode=4 qmap_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 驱动安装成功后，会覆盖 Linux 原生 GobiNet 驱动。另外，使用移远通信模块时，请务必不 要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前是否已经安装 Linux 原生驱动， 若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之前，需确认已安装由移远通信提 供的 GobiNet.ko、option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： gobinet.txt gobinet_bridge.txt gobinet_qmap=1.txt gobinet_qmap=1_bridge.txt 单路无 QMAP 本地拨号 单路无 QMAP 桥接拨号 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 上海移远通信技术股份有限公司 12 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 gobinet_qmap=4.txt gobinet_qmap=4_bridge.txt 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 默 认 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1。因此，gobinet.txt 和 gobinet_bridge.txt 在实际使用中等同于 gobinet_qmap=1.txt 和 gobinet_qmap=1_bridge.txt。 3.4. PCIe_MHI_Rmnet 拨号（PCIe + TE + Linux + QMI） 该拨号方式使用 PCIe 接口进行数据拨号，此时主机为 PCIe 主控端，模块为 PCIe 设备终端。拨号步 骤如下： 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_PCIE_MHI_Driver（MHI 数据端口驱动） 2) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod pcie_mhi.ko qmap_mode=4 qmap_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 查看主机加载的设备端口，其中/dev/mhi_DUN 为 AT 口。 4) 主机连接模块前，请确认已经安装由移远通信提供的 pcie_mhi.ko 驱动。 3. 通过 PCIe 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： 上海移远通信技术股份有限公司 13 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 pcie_mhi_qmap=1.txt pcie_mhi_qmap=1_bridge.txt pcie_mhi_qmap=4.txt pcie_mhi_qmap=4_bridge.txt 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 默 认 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1。 3.5. MBIM 拨号（USB + TE + Linux + MBIM） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) cdc_mbim_drv_Linux（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 mbim_qmap_mode=< 多路拨号路数>，目前模块支持的最大路数为 16,。示例如下： insmod quec_cdc_mbim.ko mbim_qmap_mode=4 3) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前 是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之 前，需确认已经安装由移远通信提供的 quec_cdc_mbim.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 AT+QCFG='usbnet',2 设置模块网卡拨号方式为 MBIM 模式。 5. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： cdc_mbim.txt 单路 QMAP 本地拨号 cdc_mbim_vlan.txt 多路 QMAP 本地拨号 上海移远通信技术股份有限公司 14 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模块默认启用 QMAP 功能，即使加载驱动时未配置 mbim_qmap_mode，运行驱动时将强制打开 mbim_qmap_mode=1。 3.6. MBIM 拨号（USB + TE + Windows + MBIM） 1. 通过 USB 连接模块至主机。 2. 执行 AT+QCFG='usbnet',2 设置模块网卡拨号方式为 MBIM 模式。 3. 确认主机 Windows 系统中对该设备加载的驱动为默认 MBIM 驱动。 4. 点击主机桌面右下角网络图标开始拨号。 图 3：MBIM 拨号（USB + TE + Windows + MBIM） 3.7. MBIM 拨号（PCIe + TE + Windows + MBIM） 1. 联系移远通信技术支持获取 Windows 驱动 Quectel_sdx55-windows-pcie-driver 并安装。 2. 通过 PCIe 连接模块至主机。 上海移远通信技术股份有限公司 15 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 3. 执行 AT+QCFG='pcie_mbim',1 启用模块 MBIM 模式。 4. 确认主机 Windows 系统对该设备加载的驱动为移远通信提供的驱动。 5. 点击主机桌面右下角网络图标开始拨号。 图 4：MBIM 拨号（PCIe + TE + Windows + MBIM） 3.8. MBIM 拨号（PCIe + TE + Linux + MBIM） 该拨号方式使用 PCIe 接口进行数据拨号，此时主机为 PCIe 主控端，模块为 PCIe 设备终端。拨号步 骤如下： 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_PCIE_MHI_Driver（MHI 数据端口驱动） 2) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 执行命令加载驱动时在命令行加上参数 mhi_mbim_enabled=1 配置驱动在 MBIM 模式下工 作；如需使用驱动进行多路拨号，还可加入参数 qmap_mode=，目前模块支 持的最大路数为 4。示例如下： insmod pcie_mhi.ko mhi_mbim_enabled=1 qmap_mode=4 上海移远通信技术股份有限公司 16 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 qmap_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 查看主机加载的设备端口，其中/dev/mhi_DUN 为 AT 口。 4) 主机连接模块前，请确认已经安装由移远通信提供的 pcie_mhi.ko 驱动。 3. 通过 PCIe 连接模块至主机。 6. 执行 AT+QCFG='pcie_mbim',1 设置模块网卡拨号方式为 MBIM 模式。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： pcie_mhi_mbim.txt 单路 QMAP 本地拨号 pcie_mhi_mbim_qmap=4.txt 多路 QMAP 本地拨号 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 默 认 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1。 3.9. ECM 拨号（USB + AP + Linux） 1. 联系移远通信技术支持获取如下驱动安装包： Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2. 在主机中集成/编译如上驱动。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询确认 当前是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块 之前，需确认已经安装由移远通信提供的 option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 首次启动模块，通过 AT 口/dev/ttyUSB2（模块的第三个 TTY 口）发送 AT+QCFG='usbnet',1 配 置拨号方式为 ECM。 上海移远通信技术股份有限公司 17 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 5. 重启模块。 6. 重启后，主机自动匹配 Linux 原生 ECM 驱动并生成基于 USB 的虚拟以太网接口 usb0。此时模块 自行在内部进行拨号通过 NAT 向主机提供网络。主机只需向 ECM 网卡发送 DHCP 请求 IP 地址即 可。 3.10. ECM 拨号（USB + AP + Windows） 1. 联系移远通信技术支持获取 Windows 平台的 ECM 驱动并安装： Quectel_LTE_Windows_USB_Driver_For_ECM 2. 通过 USB 连接模块至主机。 3. 首次启动模块，通过 AT 口向模块发送 AT+QCFG='usbnet',1 配置拨号方式为 ECM。 4. 重启模块。 5. 确认主机已安装移远通信提供的 ECM 驱动并已为该设备加载 ECM。随后，主机 Windows 系统生 成基于 USB 的虚拟以太网接口，并自动通过 DHCP 获取到 IP 地址。 图 5：ECM 拨号（USB + AP + Windows） 3.11. QMAP 拨号（RGMII + AP） 1. 联系移远通信技术支持获取如下驱动安装包： Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2. 在主机中集成/编译如上驱动。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前 是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之 前，需确认已安装由移远通信提供的 option.ko 驱动。 上海移远通信技术股份有限公司 18 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 3. 启动模块，配置目标接口。 1) 通过 AT+QETH='rgmii'启用 RGMII 网卡。 2) 通过 AT+QMAP 配置启用拨号。如需启用 IP 透传（Passthrough）等功能，均可通过 AT+QMAP 配置。 备注 仅 EG512R-EA 支持 RGMII。 上海移远通信技术股份有限公司 19 / 21 EG512R&EM12xR&EM160R 系列数据拨号应用指导 4 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_EG512R&EM1x0R_Series_AT_Commands_Manual 表 4：术语缩写 缩写 AP DHCP ECM ETH IP MBIM MHI NAT NDIS PCIe EP PCIe RC QMI RGMII TE 英文全称 中文全称 Application Processor 应用处理器 Dynamic Host Configuration Protocol 动态主机设置协议 Ethernet Control Model 以太网控制模型 Ethernet 以太网 Internet Protocol 网际互连协议 Mobile Broadband Interface Model 移动宽带接口模型 Modem Host Interface 调制解调器主机接口 Network Address Translation 网络地址转换 Network Driver Interface Specification 网络驱动接口规范 PCI Express Endpoint Device PCIe 端点 PCI Express Root Complex PCIe 根复合体 Qualcomm Message Interface 高通信息接口 Reduced Gigabit Media Independent Interface 精简千兆位介质独立接口 Terminal Equipment 终端设备 上海移远通信技术股份有限公司 20 / 21 UL AGG USB WLAN WWAN EG512R&EM12xR&EM160R 系列数据拨号应用指导 Uplink Aggregation Universal Serial Bus Wireless Local Area Network Wireless Wide Area Network 上行聚合 通用串行总线 无线局域网 无线广域网 上海移远通信技术股份有限公司 21 / 21

EG06xK&Ex120K&EM060K 系列 数据拨号应用指导 LTE-A 模块系列 版本：1.0 日期：2022-09-17 状态：受控文件 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 文档历史 修订记录 版本 日期 作者 - 2022-05-13 Ozzy ANG 1.0 2022-09-17 Ozzy ANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 2 数据拨号类型......................................................................................................................................... 8 2.1. 数据拨号场景分类 ...................................................................................................................... 8 2.2. 数据拨号方式.............................................................................................................................. 9 3 数据拨号步骤....................................................................................................................................... 10 3.1. NDIS 拨号（USB + TE + Windows + QMI） ........................................................................... 10 3.2. QMI_WWAN 拨号（USB + TE + Linux + QMI） ......................................................................11 3.3. GobiNet 拨号（USB + TE + Linux + QMI） ............................................................................ 12 3.4. MBIM 拨号（USB + TE + Linux + MBIM）.............................................................................. 13 3.5. MBIM 拨号（USB + TE + Windows + MBIM）........................................................................ 14 3.6. ECM 拨号（USB + AP + Linux）............................................................................................. 15 3.7. ECM 拨号（USB + AP + Windows）....................................................................................... 15 3.8. QMAP 拨号（PCIe RC + AP） ................................................................................................ 16 4 附录 参考文档及术语缩写 .................................................................................................................. 17 上海移远通信技术股份有限公司 4 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：拨号条件及对应拨号方式 ................................................................................................................... 9 表 3：参考文档 ........................................................................................................................................... 17 表 4：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 5 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 图片索引 图 1：确认驱动安装成功 ............................................................................................................................ 10 图 2：NDIS 拨号（USB + TE + Windows + QMI） ................................................................................... 10 图 3：MBIM 拨号（USB + TE + Windows + MBIM）................................................................................ 14 图 4：ECM 拨号（USB + AP + Windows）............................................................................................... 16 上海移远通信技术股份有限公司 6 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 1 引言 移远通信 LTE-A 模块 EG060K 系列、EG065K 系列、EG120K 系列、EM120K-GL 和 EM060K 系列支 持数据拨号功能，本文档介绍模块支持的数据拨号方式以及各数据拨号方式的拨号步骤和注意事项。 1.1. 适用模块 表 1：适用模块 适用模块 EG06xK Ex120K EM060K EG060K 系列 EG065K 系列 EG120K 系列 EM120K-GL EM060K 系列 上海移远通信技术股份有限公司 7 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 2 数据拨号类型 2.1. 数据拨号场景分类 1. 按照数据拨号中主机和模块之间的通信方式分类： 1) QMI 通信类（应用层通信协议） 2) MBIM 通信类（应用层通信协议） 3) 无通信（标准接口底层通信协议：Ethernet、Wi-Fi 等） 2. 按照数据拨号使用的接口类型分类： 1) USB 2) PCIe RC（模块为主控端） a) ETH b) WLAN（Wi-Fi） 3. 按照数据拨号中拨号发起者分类： 1) 主机发起 – TE 2) 模块自行发起 – AP 4. 按照数据拨号中主机操作系统分类： 1) Windows 2) Linux (Android) 上海移远通信技术股份有限公司 8 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 2.2. 数据拨号方式 根据上述第 2.1 章场景分类，模块支持的数据拨号场景以及对应的数据拨号方式列举如下： 表 2：拨号条件及对应拨号方式 接口类型 拨号发起者 USB TE USB TE USB TE USB AP USB AP PCIe RC AP 主机操作系统 Windows Linux Windows/Linux Windows Linux - 通信方式 QMI QMI MBIM - 对应拨号方式 NDIS QMI_WWAN/GobiNet MBIM (USB) ECM ECM QMAP 备注 1. 对应拨号方式以驱动名称命名。 2. 对应拨号方式的具体拨号步骤，详情见第 3 章。相关 AT 命令请参考文档 [1]，如参考文档未包含， 请联系移远通信技术支持获取相关 AT 命令详情。 上海移远通信技术股份有限公司 9 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 3 数据拨号步骤 3.1. NDIS 拨号（USB + TE + Windows + QMI） 1. 主机安装由移远通信提供的 NDIS 驱动 Quectel_Windows_USB_Driver(Q)_For_NDIS。 2. 通过 USB 连接模块至主机。 3. 打开主机'网络适配器'查看是否加载如下名称的驱动。 图 1：确认驱动安装成功 4. 点击主机桌面右下角网络图标开始拨号。 图 2：NDIS 拨号（USB + TE + Windows + QMI） 上海移远通信技术股份有限公司 10 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 3.2. QMI_WWAN 拨号（USB + TE + Linux + QMI） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) Quectel_Linux&Android_QMI_WWAN_Driver（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod qmi_wwan_q.ko qmap_mode=4 qmap_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 如需使用驱动进行桥接模式（即将拨号桥接到主机下端其他设备，为其他设备提供网络）拨 号，可参考 quectel-CM 工具源码包中 log/目录下的如下示例： log/how_to_use_bridge.txt 单路拨号的桥接 log/how_to_use_bridge_and_QMAP.txt 多路拨号的桥接 4) 使用移远通信模块时，请务必不要使用 Linux 原生驱动（qmi_wwan.ko 和 qcserial.ko 驱动）。 可通过 lsmod 查询当前是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生 驱动。主机连接模块前，需确认已安装由移远通信提供的 qmi_wwan_q.ko、option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： qmi_wwan_q.txt qmi_wwan_q_bridge.txt qmi_wwan_q_qmap=1.txt qmi_wwan_q_qmap=1_bridge.txt qmi_wwan_q_qmap=4.txt qmi_wwan_q_qmap=4_bridge.txt 单路无 QMAP 本地拨号 单路无 QMAP 桥接拨号 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 上海移远通信技术股份有限公司 11 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 默 认 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1 。 因 此 ， qmi_wwan_q.txt 和 qmi_wwan_q_bridge.txt 在 实 际 使 用 中 等 同 于 qmi_wwan_q_qmap=1.txt 和 qmi_wwan_q_qmap=1_bridge.txt。 3.3. GobiNet 拨号（USB + TE + Linux + QMI） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) Quectel_Linux&Android_GobiNet_Driver（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 qmap_mode=，目前模块支持的最大路数为 4。示例如下： insmod GobiNet.ko qmap_mode=4 qmap_mode=0，表示单独拨号且无 UL AGG qmap_mode=1，表示单路拨号且有 UL AGG qmap_mode=2/3/4，表示多路拨号且有 UL AGG 3) 驱动安装成功后，会覆盖 Linux 原生 GobiNet 驱动。另外，使用移远通信模块时，请务必不 要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前是否已经安装 Linux 原生驱动， 若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之前，需确认已安装由移远通信提 供的 GobiNet.ko、option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： gobinet.txt gobinet_bridge.txt gobinet_qmap=1.txt gobinet_qmap=1_bridge.txt 单路无 QMAP 本地拨号 单路无 QMAP 桥接拨号 单路 QMAP 本地拨号 单路 QMAP 桥接拨号 上海移远通信技术股份有限公司 12 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 gobinet_qmap=4.txt gobinet_qmap=4_bridge.txt 多路 QMAP 本地拨号 多路 QMAP 桥接拨号 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模 块 默 认 启 用 QMAP 功 能 ， 即 使 加 载 驱 动 时 未 配 置 qmap_mode ， 运 行 驱 动 时 将 强 制 打 开 qmap_mode=1。因此，gobinet.txt 和 gobinet_bridge.txt 在实际使用中等同于 gobinet_qmap=1.txt 和 gobinet_qmap=1_bridge.txt。 3.4. MBIM 拨号（USB + TE + Linux + MBIM） 1. 联系移远通信技术支持获取如下驱动和工具安装包： 1) Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2) cdc_mbim_drv_Linux（usbnet 数据端口驱动） 3) QConnectManager_Linux（拨号工具） 2. 在主机中集成/编译如上驱动和工具。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 如需使用驱动进行多路拨号，执行命令加载驱动时在命令行加入参数 mbim_qmap_mode=< 多路拨号路数>，目前模块支持的最大路数为 16,。示例如下： insmod quec_cdc_mbim.ko mbim_qmap_mode=4 3) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前 是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之 前，需确认已经安装由移远通信提供的 quec_cdc_mbim.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 执行 AT+QCFG='usbnet',2 设置模块网卡拨号方式为 MBIM 模式。 5. 执行 quectel-CM 工具开始拨号。 1) 执行 quectel-CM -h 查看 quectel-CM 工具参数使用方式。 2) 可参考 quectel-CM 工具源码包中 log/目录下的如下示例进行拨号： cdc_mbim.txt 单路 QMAP 本地拨号 cdc_mbim_vlan.txt 多路 QMAP 本地拨号 上海移远通信技术股份有限公司 13 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 备注 1. 若模块使用多路拨号，则必须启用模块的 QMAP 功能。 2. 模块默认启用 QMAP 功能，即使加载驱动时未配置 mbim_qmap_mode，运行驱动时将强制打开 mbim_qmap_mode=1。 3.5. MBIM 拨号（USB + TE + Windows + MBIM） 1. 通过 USB 连接模块至主机。 2. 执行 AT+QCFG='usbnet',2 设置模块网卡拨号方式为 MBIM 模式。 3. 确认主机 Windows 系统中对该设备加载的驱动为默认 MBIM 驱动。 4. 点击主机桌面右下角网络图标开始拨号。 图 3：MBIM 拨号（USB + TE + Windows + MBIM） 上海移远通信技术股份有限公司 14 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 3.6. ECM 拨号（USB + AP + Linux） 1. 联系移远通信技术支持获取如下驱动安装包： Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2. 在主机中集成/编译如上驱动。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询确认 当前是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块 之前，需确认已经安装由移远通信提供的 option.ko 驱动。 3. 通过 USB 连接模块至主机。 4. 首次启动模块，通过 AT 口/dev/ttyUSB2（模块的第三个 TTY 口）发送 AT+QCFG='usbnet',1 配 置拨号方式为 ECM。 5. 重启模块。 6. 重启后，主机自动匹配 Linux 原生 ECM 驱动并生成基于 USB 的虚拟以太网接口 usb0。此时模块 自行在内部进行拨号通过 NAT 向主机提供网络。主机只需向 ECM 网卡发送 DHCP 请求 IP 地址即 可。 3.7. ECM 拨号（USB + AP + Windows） 1. 联系移远通信技术支持获取 Windows 平台的 ECM 驱动并安装： Quectel_LTE_Windows_USB_Driver_For_ECM 2. 通过 USB 连接模块至主机。 3. 首次启动模块，通过 AT 口向模块发送 AT+QCFG='usbnet',1 配置拨号方式为 ECM。 4. 重启模块。 5. 确认主机已安装移远通信提供的 ECM 驱动并已为该设备加载 ECM。随后，主机 Windows 系统生 成基于 USB 的虚拟以太网接口，并自动通过 DHCP 获取到 IP 地址。 上海移远通信技术股份有限公司 15 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 图 4：ECM 拨号（USB + AP + Windows） 3.8. QMAP 拨号（PCIe RC + AP） 1. 联系移远通信技术支持获取如下驱动安装包： Quectel_Linux_USB_Serial_Option_Driver（AT、DM 等 TTY 端口驱动） 2. 在主机中集成/编译如上驱动。 驱动安装： 1) 在驱动文件中执行 make install 即可安装。 2) 使用移远通信模块时，请务必不要使用 Linux 原生 qcserial.ko 驱动。可通过 lsmod 查询当前 是否已经安装 Linux 原生驱动，若已安装，需执行 rmmod 卸载原生驱动。主机接入模块之 前，需确认已安装由移远通信提供的 option.ko 驱动。 3. 启动模块，配置目标接口。 1) 通过 AT+QETH='eth_driver'选择对应 PHY 驱动。 2) 通过 AT+QMAP 配置启用拨号。如需启用 IP 透传（Passthrough）等功能，均可通过 AT+QMAP 配置。 上海移远通信技术股份有限公司 16 / 18 EG06xK&Ex120K&EM060K 系列数据拨号应用指导 4 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_EG06xK&Ex120K&EM060K_Series_AT_Commands_Manual 表 4：术语缩写 缩写 AP DHCP ECM ETH IP MBIM MHI NAT NDIS PCIe EP PCIe RC QMI RGMII TE 英文全称 中文全称 Application Processor 应用处理器 Dynamic Host Configuration Protocol 动态主机设置协议 Ethernet Control Model 以太网控制模型 Ethernet 以太网 Internet Protocol 网际互连协议 Mobile Broadband Interface Model 移动宽带接口模型 Modem Host Interface 调制解调器主机接口 Network Address Translation 网络地址转换 Network Driver Interface Specification 网络驱动接口规范 PCI Express Endpoint Device PCIe 端点 PCI Express Root Complex PCIe 根复合体 Qualcomm Message Interface 高通信息接口 Reduced Gigabit Media Independent Interface 精简千兆位介质独立接口 Terminal Equipment 终端设备 上海移远通信技术股份有限公司 17 / 18 UL AGG USB WLAN WWAN EG06xK&Ex120K&EM060K 系列数据拨号应用指导 Uplink Aggregation Universal Serial Bus Wireless Local Area Network Wireless Wide Area Network 上行聚合 通用串行总线 无线局域网 无线广域网 上海移远通信技术股份有限公司 18 / 18

EG060V-EA RF FTM 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-08-22 状态：受控文件 EG060V-EA RF FTM 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上 提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 14 EG060V-EA RF FTM 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 14 EG060V-EA RF FTM 应用指导 文档历史 修订记录 版本 1.0 日期 2022-04-09 2022-08-22 作者 Paddy LI Paddy LI 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 14 EG060V-EA RF FTM 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 AT 命令详解 ........................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句...................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. RF FTM AT 命令详解 .................................................................................................................. 8 2.3.1. AT+QRFTESTMODE 进入/退出 FTM 模式 ................................................................... 8 2.3.2. AT+QRXFTM 在 FTM 模式下强收................................................................................. 9 2.3.3. AT+QRFTEST 在 FTM 模式下强发 ............................................................................. 10 3 示例代码 ............................................................................................................................................... 12 3.1. 在 FTM 模式下强收 ................................................................................................................... 12 3.2. 在 FTM 模式下强发 ................................................................................................................... 12 4 错误码 .................................................................................................................................................. 13 5 附录 术语缩写...................................................................................................................................... 14 上海移远通信技术股份有限公司 4 / 14 EG060V-EA RF FTM 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：LTE 频段强收信道分布表 ................................................................................................................... 9 表 3：LTE 频段强发信道分布表 ..................................................................................................................11 表 4：错误码............................................................................................................................................... 13 表 5：术语缩写 ........................................................................................................................................... 14 上海移远通信技术股份有限公司 5 / 14 EG060V-EA RF FTM 应用指导 1 引言 本文档主要介绍如何通过 AT 命令在 FTM（工厂测试模式）下测试移远通信 EG060V-EA 模块的强发和 强收功能。 上海移远通信技术股份有限公司 6 / 14 EG060V-EA RF FTM 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中变现命令和响应的表格中，省略了， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 14 EG060V-EA RF FTM 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. RF FTM AT 命令详解 2.3.1. AT+QRFTESTMODE 进入/退出 FTM 模式 该命令用于控制模块进入/退出 FTM 模式。 AT+QRFTESTMODE 进入/退出 FTM 模式 测试命令 AT+QRFTESTMODE=? 响应 +QRFTESTMODE: (支持的列表) 查询命令 AT+QRFTESTMODE? OK 响应 +QRFTESTMODE: 设置命令 AT+QRFTESTMODE= 最大响应时间 特性说明 OK 响应 OK 若有任何错误： ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。 0 退出 FTM 模式 1 进入 FTM 模式 整型。错误码。详情请参考第 4 章。 上海移远通信技术股份有限公司 8 / 14 EG060V-EA RF FTM 应用指导 2.3.2. AT+QRXFTM 在 FTM 模式下强收 该命令用于测试模块在 FTM 模式下强收。 AT+QRXFTM 在 FTM 模式下强收 测试命令 响应 AT+QRXFTM=? 设置命令 OK 响应 AT+QRXFTM=, +QRXFTM: , ,,[,] OK 若有任何错误： ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。模块支持的 LTE 频段。详见表 2。 整型。模块支持的 LTE 强收信道号。详见表 2。 字符串类型。开启/关闭 FTM 模式下的强收功能 'on' 开启 'off' 关闭 整型。LNA AGC 的状态，与通过仪器设定的信号强度绝对值有关。 0 仪器设定的信号强度值测量范围为-35 dBm 至-65 dBm 1 仪器设定的信号强度值测量范围为-45 dBm 至-75 dBm 整型。LTE 带宽。默认值为 0。目前仅支持配置为 0。 0 1.4 MHz 整型。主集接收信号强度值，仅 LTE 适用。单位：dBm。 整型。分集接收信号强度值，仅 LTE 适用。单位：dBm。 整型。错误码。详情请参考第 4 章。 表 2：LTE 频段强收信道分布表 LTE 频段 'LTE BAND1' 强收信道号 300 上海移远通信技术股份有限公司 9 / 14 EG060V-EA RF FTM 应用指导 'LTE BAND3' 'LTE BAND5' 'LTE BAND7' 'LTE BAND8' 'LTE BAND20' 'LTE BAND28' 'LTE BAND38' 'LTE BAND40' 'LTE BAND41' 1575 2525 3100 3625 6300 9435 38000 39150 40620 2.3.3. AT+QRFTEST 在 FTM 模式下强发 该命令用于测试模块在 FTM 模式下强发。 AT+QRFTEST 在 FTM 模式下强发 测试命令 响应 AT+QRFTEST=? 设置命令 OK 响应 AT+QRFTEST=,,, OK 若有任何错误： ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。模块支持的 LTE 频段。详见表 3。 整型。模块支持的 LTE 强发信道号。详见表 3。 字符串类型。开启/关闭 FTM 模式下强发功能。 'on' 开启 'off' 关闭 上海移远通信技术股份有限公司 10 / 14 EG060V-EA RF FTM 应用指导 整型。LTE 发送功率增益指数。范围：0~2047，建议将其设置为 1900。 整型。错误码。详情请参考第 4 章。 表 3：LTE 频段强发信道分布表 LTE 频段 'LTE BAND1' 'LTE BAND3' 'LTE BAND5' 'LTE BAND7' 'LTE BAND8' 'LTE BAND20' 'LTE BAND28' 'LTE BAND38' 'LTE BAND40' 'LTE BAND41' 强发信道号 18300 19575 20525 21100 21625 24300 27435 38000 39150 40620 上海移远通信技术股份有限公司 11 / 14 EG060V-EA RF FTM 应用指导 3 示例代码 3.1. 在 FTM 模式下强收 AT+QRFTESTMODE? +QRFTESTMODE: 0 OK AT+QRFTESTMODE=1 OK AT+QRXFTM='LTE BAND1',300,'on',1 +QRXFTM: -75,-80 OK AT+QRXFTM='LTE BAND1',300,'off',1 OK AT+QRFTESTMODE=0 OK //查询当前是否进入 FTM 模式 //进入 FTM 模式 //测试 LTE BAND1 下行频点 300 //关闭 LTE BAND1 强收测试 //退出 FTM 模式 3.2. 在 FTM 模式下强发 AT+QRFTESTMODE? +QRFTESTMODE: 0 //查询当前是否进入 FTM 模式 OK AT+QRFTESTMODE=1 OK AT+QRFTEST='LTE BAND1',18300,'on',2000 OK AT+QRFTEST='LTE BAND1',18300,'off',2000 OK AT+QRFTESTMODE=0 OK //进入 FTM 模式 //测试 LTE BAND1 上行频点 18300 //关闭 LTE 强发测试 //退出 FTM 模式 上海移远通信技术股份有限公司 12 / 14 EG060V-EA RF FTM 应用指导 4 错误码 表示与移动设备有关的错误码，具体描述详见下表。 表 4：错误码 错误码 3 4 16 20 21 22 23 英文含义 Operation not allowed Operation not supported Incorrect password Memory full Invalid index Not found Memory failure 中文含义 操作不允许 操作不支持 密码不正确 内存已满 无效索引 未发现 内存不足 上海移远通信技术股份有限公司 13 / 14 EG060V-EA RF FTM 应用指导 5 附录 术语缩写 表 5：术语缩写 缩写 AGC DRX FTM LNA LTE PRX RF RSSI RX TX 英文全称 Automatic Gain Control Diversity Receive Factory Test Mode Low Noise Amplifier Long Term Evolution Primary Receive Radio Frequency Received Signal Strength Indicator Receive Transmit 中文全称 自动增益控制 分集接收 工厂测试模式 低噪声放大器 长期演进 主集接收 射频 接收信号强度指示 接收 发送 上海移远通信技术股份有限公司 14 / 14

BG95&BG77&BG600L Series GTP Application Note LPWA Module Series Version: 1.0 Date: 2022-07-28 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_GTP_Application_Note 1 / 19 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Series_GTP_Application_Note 2 / 19 LPWA Module Series About the Document Revision History Version Date Author Description - 2022-04-27 Matt YE Creation of the document 1.0 2022-07-28 Matt YE First official release BG95&BG77&BG600L_Series_GTP_Application_Note 3 / 19 LPWA Module Series Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 1.1. GTP Architecture ......................................................................................................................... 7 1.2. Supported GTP Versions ............................................................................................................ 7 1.3. GTP Operation ............................................................................................................................ 8 1.3.1. GTP Operation Flow ........................................................................................................ 8 1.3.2. GNSS Operation Flow with GTP and XTRA .................................................................... 9 2 Description of GNSS AT Commands ............................................................................................... 11 2.1. AT Command Introduction ..................................................................................................... 11 2.1.1. Definitions....................................................................................................................... 11 2.1.2. AT Command Syntax ..................................................................................................... 11 2.2. Declaration of AT Command Examples ................................................................................ 12 2.3. AT Commands Description .................................................................................................... 12 2.3.1. AT+QGPSCFG='gtp_fun' Enable/Disable GTP Feature ............................................ 12 2.3.2. AT+QGPSONE Attempt a Single Position Fix ............................................................ 13 3 Examples ............................................................................................................................................ 16 3.1. GTP Operation .......................................................................................................................... 16 3.2. GNSS Operation with GTP and XTRA ..................................................................................... 16 4 Summary of Error Codes .................................................................................................................. 17 5 Appendix References ........................................................................................................................ 19 BG95&BG77&BG600L_Series_GTP_Application_Note 4 / 19 LPWA Module Series Table Index Table 1: Types of AT Commands ...............................................................................................................11 Table 2: Summary of Error Codes ............................................................................................................. 17 Table 3: Related Document ....................................................................................................................... 19 Table 4: Terms and Abbreviations ............................................................................................................. 19 BG95&BG77&BG600L_Series_GTP_Application_Note 5 / 19 LPWA Module Series Figure Index Figure 1: GTP Architecture........................................................................................................................... 7 Figure 2: GTP Operation Flow (XTRA Disabled) ......................................................................................... 8 Figure 3: GNSS Operation Flow with GTP and XTRA................................................................................. 9 BG95&BG77&BG600L_Series_GTP_Application_Note 6 / 19 LPWA Module Series 1 Introduction Quectel BG95 series, BG77 and BG600L-M3 modules integrate GTP feature with the GNSS engine to ensure better positioning performance. The modules support both GTP 1.0 and GTP 2.0 versions. GTP feature is a cellular positioning technology that is disabled by default. If you want to use it, please confirm whether it is supported in the current area by GTP service provider. NOTE GTP feature is supported only on specified firmware versions of the modules. Please contact Quectel Technical Support (support@quectel.com) for more detailed information. 1.1. GTP Architecture Module GTP request with cell observations Network GTP response with location of cell towers GTP server Figure 1: GTP Architecture 1.2. Supported GTP Versions GTP 1.0 ⚫ Supported RATs: GSM, LTE-M and NB-IoT ⚫ Serving-cell only (a single registered cell ID) ⚫ Performance varies across RATs and operators BG95&BG77&BG600L_Series_GTP_Application_Note 7 / 19 LPWA Module Series GTP 2.0 ⚫ Supported RATs: GSM, LTE-M and NB-IoT ⚫ Multi-cell scan (across RATs and bands) ⚫ Improved accuracy compared to GTP 1.0; uniform performance across RATs and operators 1.3. GTP Operation GTP can be used alone or together with XTRA. XTRA provides predicted orbit data (GNSS assistance data) but does not provide reference position. GTP can provide an initial reference position for improved GNSS TTFF performance (similar to AGPS) compared to TTFF achieved using XTRA only. This improvement is prominent in challenging signal conditions, whereas it may be limited in a strong signal environment. 1.3.1. GTP Operation Flow The following flow is triggered by AT+QGPSONE=1, with XTRA disabled. Module GTP Server Establish a TLS connection A HTTP POST (GTPA Request) B HTTP RESPONSE (GTPA Response) C Close the TLS connection D Figure 2: GTP Operation Flow (XTRA Disabled) A: The module will establish a TLS connection to the GTP server, if the currently observed cell information is not the one that is cached by the module in the last positioning. B: The module initiates a GTPA Request to upload the currently observed cell information, module status, etc. to the GTP server. C: The GTP server responds with a GTPA Response message with location information. D: The module closes the TLS connection. BG95&BG77&BG600L_Series_GTP_Application_Note 8 / 19 LPWA Module Series 1.3.2. GNSS Operation Flow with GTP and XTRA The following flow is triggered by AT+QGPS=1 (see document [1] for details) or AT+QGPSONE=0. Module GTP Server Establish a TLS connection A HTTP POST (GTPA Request) B HTTP RESPONSE (GTPA Response) C Close the TLS connection D HTTP REQUEST E HTTP RESPONSE (XTRA File) F G Inject reference position H Inject XTRA data I GNSS starts positioning XTRA Server Figure 3: GNSS Operation Flow with GTP and XTRA A: The module will establish a TLS connection to the GTP server, if the currently observed cell information is not the one that is cached by the module in the last positioning. B: The module initiates a GTPA Request to upload the currently observed cell information, module status, etc. to the GTP server. C: The GTP server responds with a GTPA Response message with location information. D: The module closes the TLS connection. E: The module requests an XTRA file download. F: The XTRA server responds with XTRA file which includes the current GNSS assistance data. G: The module injects reference position to the GNSS engine. H: The module inject XTRA data to the GNSS engine. I: GNSS starts positioning. BG95&BG77&BG600L_Series_GTP_Application_Note 9 / 19 LPWA Module Series NOTE Make sure that XTRA time is synchronized from network or injected manually before executing AT+QGPS=1 or AT+QGPSONE=0. See document [1] for more detailed information. BG95&BG77&BG600L_Series_GTP_Application_Note 10 / 19 LPWA Module Series 2 Description of GNSS AT Commands 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings , unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 1: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_GTP_Application_Note 11 / 19 LPWA Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about how to use the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples and that they should be executed in a given sequence. 2.3. AT Commands Description 2.3.1. AT+QGPSCFG='gtp_fun' Enable/Disable GTP Feature This command enables or disables GTP feature. AT+QGPSCFG='gtp_fun' Enable/Disable GTP Feature Test Command AT+QGPSCFG=? Response … +QGPSCFG: 'gtp_fun',(list of supported s) ... Write Command AT+QGPSCFG='gtp_fun'[,] OK Response If the optional parameter is omitted, query the current setting: +QGPSCFG: 'gtp_fun', OK If the optional parameter is specified, enable/disable GTP feature: OK Maximum Response Time Characteristics If there is any error: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configurations are saved automatically. Parameter Integer type. Enable/Disable GTP feature. 0 Disable 1 Enable BG95&BG77&BG600L_Series_GTP_Application_Note 12 / 19 Integer type. Error code. See Chapter 3 for details. LPWA Module Series 2.3.2. AT+QGPSONE Attempt a Single Position Fix This command attempts a single position fix and obtains a single location information. Before executing the command, deactivate GNSS, if it is active. AT+QGPSONE Attempt a Single Position Fix Test Command AT+QGPSONE=? Response +QGPSONE: (list of supporteds),(range of supported s),(range of supported s) Write Command AT+QGPSONE=,[,] OK Response OK If the location information is not successfully obtained: +QGPSURC: 'single_shot',,,,, If the location information is successfully obtained: +QGPSURC: 'single_shot',,,,, Maximum Response Time Characteristics If there is any error: +CME ERROR: 300 ms The command takes effect immediately. The configurations are not saved. Parameter Integer type. Requested location mode. URC will be reported once the location information is successfully obtained, or after . 0 Use GNSS for positioning 1 Use GTP for positioning Integer type. Desired accuracy level acceptable for fix computation. URC +QGPSURC: 'single_shot',,,,, will be output when the accuracy of the acquired position is greater than the set threshold or the timeout for single position fix exceeds the value of . When =0: 0 No accuracy threshold BG95&BG77&BG600L_Series_GTP_Application_Note 13 / 19 LPWA Module Series 1 Low accuracy threshold: 1000 m 2 Medium accuracy threshold: 500 m 3 High accuracy threshold: 100 m When =1: 0 No accuracy threshold (GTP 2.0) 1 Low accuracy threshold (GTP 1.0): 1000 m 2 Medium accuracy threshold (GTP 2.0): 500 m 3 High accuracy threshold (GTP 2.0): 100 m Integer type. Timeout of single position fix. Range: 20–600. Default value: 60. Unit: second. String type. Current UTC time. Format: yyyy/mm/dd hh:mm:ss. Float type. Latitude. Format: ±dd.dddddd. Range: -90.000000 – 90.000000 Float type. Longitude. Format: ±ddd.dddddd. Range: -180.000000 – 180.000000 Float type. Height above sea level, correct to one decimal place. Unit: meter. Float type. Positioning accuracy. Unit: meter. Error code. See Chapter 3 for details. NOTE 1. AT+QGPSONE=0, also triggers XTRA file downloading. To use XTRA, make sure that XTRA time is injected first. See document [1] for more information of XTRA. 2. To get location information via GTP, enable GTP feature with AT+QGPSCFG='gtp_fun',1 first. 3. To get location information via GNSS ONLY, disable GTP feature with AT+QGPSCFG='gtp_fun',0. 4. One module only can access to the GTP server up to 255 times per day. 5. If the currently observed cell information is the same one with that cached by the module in the last positioning, the module starts positioning with the cached location information directly, without accessing to GTP server. Deleting the cached information with AT+QGPSDEL=0 can make the module access GTP server, but this will cause GTP failure. In this case, execute AT+CFUN=0 and then AT+CFUN=1 to avoid GTP failure issue. This is usually used for testing. Example AT+QGPSCFG='gtp_fun',1 OK AT+QGPSONE=1,0,60 OK //Enable GTP feature. The command takes effect after the module is rebooted. //Use GTP 2.0 for positioning and no accuracy threshold, and set to 60 seconds. +QGPSURC: 'single_shot',,49.183300,-123.104631,0.0,434.7 AT+QGPSONE=0,3 //Use GNSS for positioning and high accuracy threshold, and default BG95&BG77&BG600L_Series_GTP_Application_Note 14 / 19 LPWA Module Series is 60 seconds. OK +QGPSURC: 'single_shot',2022/02/24 05:50:49,49.187322,-123.108171,1.5,8.0 BG95&BG77&BG600L_Series_GTP_Application_Note 15 / 19 LPWA Module Series 3 Examples 3.1. GTP Operation AT+QGPSCFG='gtp_fun',1 OK AT+QGPSONE=1,1,60 OK //Enable GTP feature. The command takes effect after the module is rebooted. //Use GTP 1.0 for positioning, set a low accuracy threshold of 1000 meters, and set to 60 seconds. +QGPSURC: 'single_shot',,25.076315,121.574840,170.0,513.2 3.2. GNSS Operation with GTP and XTRA AT+QGPSCFG='gtp_fun',1 OK AT+QGPSXTRA=1 OK //Enable GTP feature. The command takes effect after the module is rebooted. //Enable XTRA feature. The command takes effect after the module is rebooted. //Reboot the module. AT+QGPSXTRATIME? +QGPSXTRATIME: '2022/07/22,08:07:59' //If XTRA time is not returned, inject the time manually. OK AT+QGPSONE=0,3,60 OK //Use GNSS for positioning, set a high accuracy threshold of 100 meters, and set to 60 seconds. +QGPSURC: 'XTRA_DL',0 //The XTRA file is downloaded successfully. +QGPSURC: 'single_shot',2022/07/22 08:07:12,25.075385,121.575904,13.8,26.9 BG95&BG77&BG600L_Series_GTP_Application_Note 16 / 19 LPWA Module Series 4 Summary of Error Codes The indicates an error related to the GNSS operation. The details about are presented in the following table. Table 2: Summary of Error Codes 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 Description Invalid parameter Operation is not supported GNSS subsystem is busy Session is ongoing Session is inactive Operation timeout Functionality is disabled Time information error XTRA is disabled XTRA file open failed Bad CRC for XTRA data file Validity time is out of range Internal resource error GNSS locked End by E911 Not fixed now Geo-fence ID does not exist BG95&BG77&BG600L_Series_GTP_Application_Note 17 / 19 LPWA Module Series 518 Sync time failed 519 XTRA file does not exist 520 XTRA file is being downloaded 521 XTRA file is valid 522 GNSS is working 523 Time injection error 524 XTRA file is invalid 525 GTP is disabled 549 Unknown error BG95&BG77&BG600L_Series_GTP_Application_Note 18 / 19 LPWA Module Series 5 Appendix References Table 3: Related Document Document Name [1] Quectel_BG95&BG77&BG600L_Series_GNSS_Application_Note Table 4: Terms and Abbreviations Abbreviation AGPS CRC GNSS GSM GTP GTPA HTTP IoT NB-IoT RAT TLS TTFF URC UTC XTRA Description Assisted Global Positioning System Cyclic Redundancy Check Global Navigation Satellite System Global System for Mobile Communications Global Terrestrial Positioning GTP Assistance Hyper Text Transfer Protocol Internet of Things Narrowband IoT (Internet of Things) Radio Access Technology Transport Layer Security Time to First Fix Unsolicited Result Code Universal Time Coordinated Auxiliary Positioning Technology Provided by Qualcomm BG95&BG77&BG600L_Series_GTP_Application_Note 19 / 19

BC25&BC32 系列 CoAP 应用指导 NB-IoT 模块系列 版本：1.0 日期：2022-08-10 状态：受控文件 BC25&BC32 系列 CoAP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上 提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 30 BC25&BC32 系列 CoAP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 30 BC25&BC32 系列 CoAP 应用指导 文档历史 修订记录 版本 1.0 日期 2022-06-01 2022-08-10 作者 Howie DONG Howie DONG 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 30 BC25&BC32 系列 CoAP 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 CoAP 相关 AT 命令 ............................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................. 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句 ..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................. 8 2.3. AT 命令详解................................................................................................................................. 8 2.3.1. AT+QCOAPCFG 配置 CoAP 客户端的可选参数........................................................... 8 2.3.2. AT+QCOAPOPEN 创建 CoAP 上下文 .......................................................................... 9 2.3.3. AT+QCOAPCLOSE 删除 CoAP 上下文 ...................................................................... 10 2.3.4. AT+QCOAPOPTION 配置 CoAP 消息选项 ................................................................. 11 2.3.5. AT+QCOAPHEAD 配置 CoAP 消息的 Message ID 和 Token ..................................... 14 2.3.6. AT+QCOAPSEND 发送数据........................................................................................ 16 3 CoAP 相关 URC................................................................................................................................... 20 4 示例 ...................................................................................................................................................... 23 4.1. 不使用 DTLS 发送 CoAP 请求到 CoAP 服务器......................................................................... 23 4.2. 使用 DTLS 发送 COAP 请求注册到到 IOT 平台........................................................................ 25 5 结果码 .................................................................................................................................................. 27 6 附录 参考文档及术语缩写 ................................................................................................................... 28 上海移远通信技术股份有限公司 4 / 30 BC25&BC32 系列 CoAP 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：结果码 ................................................................................................................................. 27 表 3：参考文档 ........................................................................................................................................... 28 表 4：术语缩写 ........................................................................................................................................... 28 上海移远通信技术股份有限公司 5 / 30 BC25&BC32 系列 CoAP 应用指导 1 引言 本文主要介绍如何通过 AT 命令使用 BC25 和 BC32 系列模块的 CoAP 协议相关功能。 上海移远通信技术股份有限公司 6 / 30 BC25&BC32 系列 CoAP 应用指导 2 CoAP 相关 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 30 BC25&BC32 系列 CoAP 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系 或连续性。 2.3. AT 命令详解 2.3.1. AT+QCOAPCFG 配置 CoAP 客户端的可选参数 该命令用于配置 CoAP 客户端的可选参数。 AT+QCOAPCFG 配置 CoAP 客户端的可选参数 设置命令 查询/设置指定 CoAP 客户端的 DTLS 模 式。 AT+QCOAPCFG='dtls',[,< 响应 若省略可选参数，则查询当前设置： +QCOAPCFG: 'dtls', DTLS_enable>] OK 若指定可选参数，则设置指定 CoAP 客户端的 DTLS 模式： OK 若发生任何错误： ERROR 设置命令 响应 查询/设置指定 CoAP 客户端的握手 PSK。 若省略可选参数，则查询当前设置： AT+QCOAPCFG='psk',[,<i +QCOAPCFG: 'psk',, dentity>,] OK 若指定可选参数，则设置指定 CoAP 客户端的握手 PSK： OK 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效； 深休眠唤醒后仍有效；不保存到 NVRAM。 上海移远通信技术股份有限公司 8 / 30 BC25&BC32 系列 CoAP 应用指导 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。是否为 CoAP 客户端启用 DTLS 模式。 0 CoAP 客户端使用普通 UDP 连接 1 CoAP 客户端使用 DTLS 连接 十进制字符串类型。PSK 的身份。长度：0~152 字节。 十六进制字符串类型。PSK 的密钥。长度：0~256 字节。 举例 AT+QCOAPCFG='dtls',0,1 OK AT+QCOAPCFG='dtls',0 +QCOAPCFG: 'dtls',1 //对 CoAP 客户端使用 DTLS 连接。 //查询当前 DTLS 配置。 OK //设置指定 CoAP 客户端握手的 PSK。 AT+QCOAPCFG='psk',0,'869154040004132','46694a6871617a3062706d68454c6e4c' OK AT+QCOAPCFG='psk',0 //查询指定 CoAP 客户端握手的 PSK。 +QCOAPCFG: 'psk','869154040004132','46694a6871617a3062706d68454c6e4c' OK 2.3.2. AT+QCOAPOPEN 创建 CoAP 上下文 该命令用于创建 CoAP 上下文。 AT+QCOAPOPEN 测试命令 AT+QCOAPOPEN=? 创建 CoAP 上下文 响应 +QCOAPOPEN: (支持的列表),,(支持 的范围) 查询命令 AT+QCOAPOPEN? OK 响应 [+QCOAPOPEN: ,,,] 设置命令 AT+QCOAPOPEN=,, OK 响应 OK +QCOAPOPEN: , 上海移远通信技术股份有限公司 9 / 30 BC25&BC32 系列 CoAP 应用指导 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效； 深休眠唤醒后仍有效；不保存到 NVRAM。 参数 整型。CoAP 客户端 ID。目前仅支持 0。 字符串类型。CoAP 服务器地址。仅支持 IPv4、IPv6 的 IP 地址，暂不支持域名。 最大长度为 39 个字节。 整型。CoAP 服务器端口。范围：1~65535。 整型。CoAP 客户端的当前状态。 0 空闲状态或连接断开。 1 CoAP 客户端正在打开。 2 CoAP 客户端正在连接到 CoAP 服务器。 3 CoAP 客户端已连接到 CoAP 服务器。 4 CoAP 客户端正在断开与 CoAP 服务器的连接。 整型。命令执行结果，详见第 5 章。 举例 AT+QCOAPOPEN=? +QCOAPOPEN: (0),,(1-65535) OK AT+QCOAPOPEN=0,'220.180.239.212',8032 OK +QCOAPOPEN: 0,0 AT+QCOAPOPEN? +QCOAPOPEN: 0,'220.180.239.212',8032,1 OK //查询相关参数值范围。 //创建一个 CoAP 上下文。 //查询 CoAP 客户端的当前状态。 2.3.3. AT+QCOAPCLOSE 删除 CoAP 上下文 该命令用于删除 CoAP 上下文。 AT+QCOAPCLOSE 测试命令 AT+QCOAPCLOSE=? 删除 CoAP 上下文 响应 +QCOAPCLOSE: (支持的列表) 上海移远通信技术股份有限公司 10 / 30 BC25&BC32 系列 CoAP 应用指导 设置命令 AT+QCOAPCLOSE= 最大响应时间 特性说明 OK 响应 OK +QCOAPCLOSE: , 若发生任何错误： ERROR 300 毫秒 该命令立即生效。 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。命令执行结果，详见第 5 章。 举例 AT+QCOAPCLOSE=? +QCOAPCLOSE: (0) OK AT+QCOAPOPEN=0,'220.180.239.212',8032 OK +QCOAPOPEN: 0,0 AT+QCOAPCLOSE=0 OK +QCOAPCLOSE: 0,0 //查询相关参数值范围。 //创建 CoAP 上下文。 //删除 CoAP 上下文。 2.3.4. AT+QCOAPOPTION 配置 CoAP 消息选项 该命令用于配置 CoAP 消息的选项。 AT+QCOAPOPTION 测试命令 AT+QCOAPOPTION=? 配置 CoAP 消息选项 响应 +QCOAPOPTION: ( 支 持 的 列 表 ),( 支 持 的 列 表 ),,( 支 持 的 范 围),,(支持的列表) 上海移远通信技术股份有限公司 11 / 30 BC25&BC32 系列 CoAP 应用指导 OK 设置命令 若不等于 11 AT+QCOAPOPTION=,,,, 设置命令 若等于 11 AT+QCOAPOPTION=,,,,[,] 响应 OK 若发生任何错误： ERROR 响应 若省略可选参数，则默认以'/'分割 Uri-Path 为多个 CoAP 选项： OK 若指定可选参数，则配置 Uri-Path 消息选项： OK 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效； 深休眠唤醒后无效。 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。用于添加或删除 CoAP 配置选项的选项索引号。目前仅支持 0，即不配 置任何选项索引号。 整型。CoAP 选项名称。详情请参考 RFC 7252 和 RFC 7959。 1 If-Match 3 Uri-Host 4 ETag 5 If-None-Match 6 Observe 8 Location-Path 11 Uri-Path 12 Content-Format 14 Max-Age 15 Uri-Query 17 Accept 20 Location-Query 23 Block2 27 Block1 28 Size2 35 Proxy-Uri 上海移远通信技术股份有限公司 12 / 30 BC25&BC32 系列 CoAP 应用指导 整型。的长度。范围：0~255；单位：字节。 字符串类型。CoAP 选项值。最大长度为 255 字节。详情请参考 RFC 7252 和 RFC 7959。 若为 23 或 27，则需按照公式计算值，该公式需要 输入期望的 block_num、block_more、block_size 值后计算求出。 计 算 公 式 为 ： = (block_num << 4) | (block_more&0x8) | log2(block_size/16)。 若是 12 或 17，那么的值将如下所示： '0' Text-plain '40' Application/link-format '41' Application/xml '42' Application/octet-stream '47' Application/exi '50' Application/json 整型。指示 CoAP 选项值是否分段，仅在=11（选项为 Uri-Path） 时适用。 0 以'/'分割为多段 1 作为一个整体 举例 AT+QCOAPOPTION=? +QCOAPOPTION: (0),(0),,(0-255),,(0,1) OK //配置 CoAP 选项为 11（Uri-path），CoAP 选项值为'/quectel/time'，长度为 13 字节，以'/'分割为多个 CoAP 选项。 AT+QCOAPOPTION=0,0,11,13,'/quectel/time' OK //配置 CoAP 选项为 15（Uri-Query），CoAP 选项值为'ep=86370303'，长度为 11 字节。 AT+QCOAPOPTION=0,0,15,11,'ep=86370303' OK 备注 以下 CoAP 选项参数需要特别关注： 1 (If-Match) 字符串类型 3 (Uri-Host) 字符串类型 长度范围：0~8 长度范围：1~255 上海移远通信技术股份有限公司 13 / 30 4 (ETag) 5 (If-None-Match) 6 (Observe) 8 (Location-Path) 11 (Uri-Path) 14 (Max-Age) 15 (Uri-Query) 20 (Location-Query) 23 (Block2) 27 (Block1) 28 (Size2) 35 (Proxy-Uri) 字符串类型 NULL 整型 字符串类型 字符串类型 整型 字符串类型 字符串类型 整型 整型 整型 字符串类型 BC25&BC32 系列 CoAP 应用指导 长度范围：1~8 只支持0 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：1~255 2.3.5. AT+QCOAPHEAD 配置 CoAP 消息的 Message ID 和 Token 该命令用于配置 CoAP 消息的 Message ID 和 Token。 AT+QCOAPHEAD 配置 COAP 消息的 Message ID 和 Token 测试命令 AT+QCOAPHEAD=? 响应 +QCOAPHEAD: (支持的列表),(支持的范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围), OK 设置命令 AT+QCOAPHEAD=,[,[][,,]] 若发生任何错误： ERROR 响应 OK 若发生任何错误： ERROR 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 14 / 30 BC25&BC32 系列 CoAP 应用指导 特性说明 该命令立即生效； 深休眠唤醒后无效。 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。CoAP 配置 Message ID 和 Token 的模式选择。范围：1~5。 1 随机生成 Message ID 和 Token 值。 2 随机生成 Message ID，不包含 Token 值。 3 仅配置 Message ID，不包含 Token 值。 4 配置 Message ID，随机生成 Token 值。 5 配置 Message ID 和 Token 值。 整型。CoAP 消息 ID，仅在为 3、4 和 5 时适用。范围：0~65535。 整型。Token 值的长度，仅在为 5 时适用。范围：1~8；单位：字节。 十六进制字符串类型。Token 值，仅在为 5 时适用。 举例 AT+QCOAPHEAD=? //查询相关参数值范围。 +QCOAPHEAD: (0),(1-5),(0-65535),(1-8), OK AT+QCOAPHEAD=0,1 OK AT+QCOAPHEAD=0,2 OK AT+QCOAPHEAD=0,3,13940 OK AT+QCOAPHEAD=0,4,13940 OK AT+QCOAPHEAD=0,5,13940,4,'02040608' OK //随机生成 Message ID 和 Token 值。 //随机生成 Message ID，不包含 Token 值。 //仅配置 Message ID 为 13940，不包含 Token 值。 //配置 Message ID 为 13940，随机生成 Token 值。 // 配 置 Message ID 为 13940 ， 配 置 Token 为 '02040608'。 备注 如果不使用此命令，模块默认随机生成 CoAP Message ID 和 Token。 上海移远通信技术股份有限公司 15 / 30 BC25&BC32 系列 CoAP 应用指导 2.3.6. AT+QCOAPSEND 发送数据 该命令用于发送数据到 CoAP 服务器。发送 CON 数据之后，发送结果将自动通知到终端。发送的 CON 数据状态也可以通过终端用 AT+QCOAPSEND=进行查询。 AT+QCOAPSEND 发送数据 测试命令 AT+QCOAPSEND=? 响应 +QCOAPSEND: (支持的列表),(支持的范 围),,(支持的列表),(支持 的范围), 设置命令 AT+QCOAPSEND= OK 响应 +QCOAPSEND: , OK 若发生任何错误： 设置命令 ERROR 响应 AT+QCOAPSEND=,, > 需要输入的数据 , OK 响应 > 后，输入需要发送的数据， 再按下 Ctrl + Z 发送，或按下 Esc 取消操 若发生任何错误： 作。 ERROR 设置命令 响应 AT+QCOAPSEND=,, 如果为 0： ,, OK 响应 > 后，输入需要发送的数据， 如果不为 0： 长度达到值后会自动 响应 发送。 > 需要输入的数据 OK 设置命令 AT+QCOAPSEND=,, ,, , 最大响应时间 若发生任何错误： ERROR 响应 OK 若发生任何错误： ERROR 300 毫秒 特性说明 该命令立即生效。 上海移远通信技术股份有限公司 16 / 30 BC25&BC32 系列 CoAP 应用指导 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。CoAP 协议的消息类型。详情请参考 RFC 7252。 0 需要被确认的请求（CON） 1 不需要被确认的请求（NON） 2 应答消息（ACK） 3 复位消息（RST） CoAP 协议的请求方法。详情请参考 RFC 7252。 1 GET 获取 2 POST 创建 3 PUT 更新 4 DELETE 删除 CoAP 协议的响应码。详情请参考 RFC 7252。 0 空消息 201 2.01，已创建 202 2.02，已删除 203 2.03，有效 204 2.04，已更改 205 2.05，内容 400 4.00，错误请求 401 4.01，未经许可的 402 4.02，错误选项 403 4.03，禁止 404 4.04，未找到 405 4.05，不允许的方式 406 4.06，不接受 412 4.12，前提条件失败 413 4.13，请求的实体太大 415 4.15，不支持的内容格式 500 5.00，内部服务器错误 501 5.01，未实现 502 5.02，错误网关 503 5.03，服务不可用 504 5.04，网关超时 505 5.05，代理不受支持 整型。CoAP 数据包添加选项。目前仅支持 0，即 CoAP 数据包中没有添加任何配 置选项。 整型。输入数据的长度。范围：0~1024；单位：字节。 字符串类型。需要发送的数据。响应>后，输入的数据为文本字符串，否则，为十 六进制格式。 整型。发送的 CON 数据的状态。 0 未发送 1 已发送，等待 CoAP 服务器的响应 上海移远通信技术股份有限公司 17 / 30 BC25&BC32 系列 CoAP 应用指导 2 发送失败 3 超时 4 发送成功 5 获得重置消息 举例 AT+QCOAPSEND=? +QCOAPSEND: (0),(0-3),,(0),(0-1024), OK AT+QCOAPSEND=0 +QCOAPSEND: 0,0 OK AT+QCOAPSEND=0,0,2,0 //发送 CON 类型的 POST 请求到服务器。 > ;rt='oma.lwm2m',,,,,, //响应>之后输入要发送的数据， OK 按下 Ctrl+Z 发送数据。 AT+QCOAPSEND=0 +QCOAPSEND: 0,1 //已发送，等待 CoAP 服务器响应。 OK +QCOAPURC: 0,2,201,26923,132,2,'3132',8,'rd',8,'869619050024212' //接收到服务器的响应。 AT+QCOAPSEND=0 +QCOAPSEND: 0,4 //发送成功。 OK AT+QCOAPSEND=0,0,1,0,127,'683836373732353033303536393638390202000000000000010060B8 07B7C89F893C3AE82E2E9527598E16DAB2CDC5D92B65EE24665F21DA270272DF7DC0BEC89D7 DCDFDF33EC4F22C83D927DF1DD6A84D42EE14510951C31967B1EA7CC6E83C00B9CD410E53D A35F8A76D53DD6CBC9CF0D1246F3F481D7FEE6D0B0000E516' OK +QCOAPURC: 0,2,205,26924,133,6,'514CE1000000',12,'0',14,'196607',133,'This is a test server made with libcoap (see https://libcoap.net)Copyright (C) 2010--2021 Olaf Bergmann and others' //接收到服务器的响应。 AT+QCOAPSEND=0 +QCOAPSEND: 0,4 //发送成功。 OK 上海移远通信技术股份有限公司 18 / 30 BC25&BC32 系列 CoAP 应用指导 备注 1. 指 定 发 送 数 据 时 ， 超 过 1024 字 节 部 分 丢 弃 ， 仅 发 送 1024 字 节 ； 不 指 定 发送数据时，超过 1024 字节，全部丢弃，发送失败。 2. 若需要发送 CON 数据，建议在发送下一个 CON 或 NON 数据之前通过 AT+QCOAPSEND= 命令获取 CON 数据的发送状态。 3. AT+QCOAPSEND=仅用于查询已发送的 CON 数据状态。 4. 数 据 发 送 完 成 后 ， 若 模 块 接 收 到 CoAP 服 务 器 响 应 ， 将 上 报 URC +QCOAPURC: ,,,,[,,][,,[,...]][,,]，详见第 5 章。 上海移远通信技术股份有限公司 19 / 30 BC25&BC32 系列 CoAP 应用指导 3 CoAP 相关 URC 本章介绍了与 CoAP 相关的 URC 及其描述。 +QCOAPURC 通知 TE 响应来自 CoAP 服务器的请求/通知来自 CoAP 服务器的响应 +QCOAPURC: ,,,,[,,] 自 CoAP 服务器的响应 [,,[,...]][,,] 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。CoAP 消息类型。详情请参考 RFC 7252。 0 需要被确认的请求（CON） 1 不需要被确认的请求（NON） 2 应答消息（ACK） 3 复位消息（RST） 整型。CoAP 的请求方法。详情请参考 RFC 7252。 1 GET 获取 2 POST 创建 3 PUT 更新 4 DELETE 删除 整型。CoAP 的响应码。详情请参考 RFC 7252。 0 空消息 201 2.01，已创建 202 2.02，已删除 203 2.03，有效 204 2.04，已更改 205 2.05，内容 400 4.00，错误请求 401 4.01，未经许可的 402 4.02，错误选项 403 4.03，禁止 404 4.04，未找到 405 4.05，不允许的方式 406 4.06，不接受 412 4.12，前提条件失败 413 4.13，请求的实体太大 上海移远通信技术股份有限公司 20 / 30 BC25&BC32 系列 CoAP 应用指导 415 4.15，不支持的内容格式 500 5.00，内部服务器错误 501 5.01，未实现 502 5.02，错误网关 503 5.03，服务不可用 504 5.04，网关超时 505 5.05，代理不受支持 整型。CoAP 消息 ID。范围：0~65535。 整型。范围：0~255。表示是否存在 Data，CoAP 选项的个数，以及是否存在 Token。 0 位 1 表示存在 data，0 表示不存在 data。 1~6 位 将其转换为十进制即表示 CoAP 选项的个数。 7 位 1 表示存在 Token，0 表示不存在 Token。 示例：131 的二进制为 1000 0011 表示存在 Token 和 data 且 CoAP 选项的个 数为 1。 整型。CoAP 服务器 Token 长度。范围：1~8；单位：字节。 十六进制字符串类型。Token 值。 整型。CoAP 选项名称。详情请参考 RFC 7252 和 RFC7959。 1 If-Match 3 Uri-Host 4 ETag 5 If-None-Match 6 Observe 8 Location-Path 11 Uri-Path 12 Content-Format 14 Max-Age 15 Uri-Query 17 Accept 20 Location-Query 23 Block2 27 Block1 28 Size2 35 Proxy-Uri 字符串类型。CoAP 选项值。最大长度为 255 字节。 若为 23 或 27，则需按照公式计算值，计算公式为： = (block_num << 4) | (block_more&0x8) | log2(block_size/16)。 若参数是 12 或 17，那么参数的值将如下所示： '0' Text-plain '40' Application/link-format '41' Application/xml '42' Application/octet-stream '47' Application/exi '50' Application/json 上海移远通信技术股份有限公司 21 / 30 BC25&BC32 系列 CoAP 应用指导 整型。数据长度。单位：字节。 字符串类型。接收的数据。若参数为 12，且参数为 0（'Text-plain'）、41（'Application/xml'）或 50（'Application/json'），参数 格式将是文本字符串，否则，为十六进制格式。 上海移远通信技术股份有限公司 22 / 30 BC25&BC32 系列 CoAP 应用指导 4 示例 4.1. 不使用 DTLS 发送 CoAP 请求到 CoAP 服务器 AT+CGATT? +CGATT: 1 //查询当前 PS 域服务状态。 //PS 域服务状态为已附着。 OK AT+QCOAPOPEN=0,'220.180.239.212',7002 //创建客户端 ID 为 0 的 CoAP 上下文。 OK +QCOAPOPEN: 0,0 //CoAP 上下文创建成功。 AT+QCOAPOPEN? //查询 CoAP 客户端状态。 +QCOAPOPEN: 0,'220.180.239.212',7002,1 //CoAP 客户端正在打开。 OK AT+QCOAPOPTION=0,0,11,5,'/time' OK AT+QCOAPSEND=0,0,1,0,0 OK AT+QCOAPSEND=0 +QCOAPSEND: 0,1 //配置 CoAP 选项为 11（Uri-Path），选项值为'/time'，长度 为 5 字节。 //使用 CON 类型发送 GET 请求并不附带数据到 CoAP 服务端。 //查询 CON 数据发送状态。 //已发送，等待 CoAP 服务器的响应。 OK //接收到 CoAP 服务器的响应后返回该 URC，为 205，为 48626，为 133， 为 6 字节，为'F3BDF01A0000'，为 12 和 14，分别对应 为'0'和'1'，为 15 字节，为'Aug 27 09:01:48'。 +QCOAPURC: 0,2,205,48626,133,6,'F3BDF01A0000',12,'0',14,'1',15,'Aug 27 09:01:48' AT+QCOAPSEND=0 +QCOAPSEND: 0,4 //查询 CON 数据发送状态。 //发送成功。 OK AT+QCOAPHEAD=0,3,5566 //配置 CoAP 消息的 message ID 为 5566，不包含 Token 值。 OK //配置 CoAP 选项为 11（Uri-path），选项值为'/hello'，长度为 6 字节。 上海移远通信技术股份有限公司 23 / 30 BC25&BC32 系列 CoAP 应用指导 AT+QCOAPOPTION=0,0,11,6,'/hello' OK //使用 CON 类型发送 GET 请求且附带长度为 8 字节的数据 01020304 到 CoAP 服务器端。 AT+QCOAPSEND=0,0,1,0,8 > 01020304 OK //接收到 CoAP 服务器的响应后返回该 URC，为 205,为 5566，为 3， 为 12，对应为'0'，为 10 字节，为'HELLOWORLD'。 +QCOAPURC: 0,2,205,5566,3,12,'0',10,'HELLOWORLD' //配置 CoAP 消息 Message ID 为 6677，Token 长度为 4 字节，Token 值为'30323436'。 AT+QCOAPHEAD=0,5,6677,4,'30323436' OK //配置 CoAP 选项为 11（Uri-path），选项值为'/example_data'，长度为 13 字节。 AT+QCOAPOPTION=0,0,11,13,'/example_data' OK //使用 CON 类型发送 GET 请求且附带长度为 4 字节的数据'01020304'到 CoAP 服务端。 AT+QCOAPSEND=0,0,1,0,4,'01020304' OK //接收到 CoAP 服务器的响应后返回该 URC，为 205，为 6677，为 137， 为 4 字节，为'30323436'，为 4、12、23、28，分别对应 为'02'、'0'、'14'和'1500'，为 1024 字节，为'a12345678….y123'。 +QCOAPURC: 0,2,205,6677,133,4,'30323436',4,'02',12,'0',23,'14',28,'1500',1024,'a123456789b 123456789c123456789d123456789e123456789f123456789g123456789h123456789i123456789j123 456789k123456789l123456789m123456789n123456789o123456789p123456789q123456789r12345 6789s123456789t123456789u123456789v123456789w123456789x123456789y123456789z1234567 89a123456789b123456789c123456789d123456789e123456789f123456789g123456789h123456789i 123456789j123456789k123456789l123456789m123456789n123456789o123456789p123456789q12 3456789r123456789s123456789t123456789u123456789v123456789w123456789x123456789y1234 56789z123456789a123456789b123456789c123456789d123456789e123456789f123456789g123456 789h123456789i123456789j123456789k123456789l123456789m123456789n123456789o123456789 p123456789q123456789r123456789s123456789t123456789u123456789v123456789w123456789x1 23456789y123456789z123456789a123456789b123456789c123456789d123456789e123456789f1234 56789g123456789h123456789i123456789j123456789k123456789l123456789m123456789n1234567 89o123456789p123456789q123456789r123456789s123456789t123456789u123456789v123456789 w123456789x123456789y123' AT+QCOAPCLOSE=0 OK //删除 CoAP 上下文。 +QCOAPCLOSE: 0,0 //返回删除 CoAP 上下文状态为删除成功。 上海移远通信技术股份有限公司 24 / 30 BC25&BC32 系列 CoAP 应用指导 4.2. 使用 DTLS 发送 COAP 请求注册到到 IOT 平台 AT+CGATT? +CGATT: 1 //查询命令返回当前 PS 域服务状态。 //PS 域服务状态已附着。 OK AT+QCOAPCFG='dtls',0,1 //CoAP 客户端 ID 为 0 启用 DTLS 模式。 OK //配置 PSK，为'869154040004132'，为'67514b6c5a45334e31576a6d5733387a'。 AT+QCOAPCFG='psk',0,'869154040004132','67514b6c5a45334e31576a6d5733387a' OK AT+QCOAPOPEN=0,'220.180.239.212',7002 //创建客户端 ID 为 0 的 CoAP 上下文。 OK +QCOAPOPEN: 0,0 //配置 CoAP Message ID 为 12345，Token 值为'01020304'，长度为 4 字节。 AT+QCOAPHEAD=0,5,12345,4,'01020304' OK //配置 CoAP 选项为 11 (Uri-Path)，选项值为'rd'，长度为 2 字节。 AT+QCOAPOPTION=0,0,11,2,'rd' OK //配置 CoAP 选项为 12（Content-Format），选项值为'40' （Application/link-format），长度为 2 字节。 AT+QCOAPOPTION=0,0,12,2,'40' OK //配置 CoAP 选项为 15（Uri-Query），选项值为'lwm2m=1.0&ep=869619050023990&b=U&lt=1600'，长 度为 40。多个选项用&连接。 AT+QCOAPOPTION=0,0,15,40,'lwm2m=1.0&ep=869619050023990&b=U&lt=1600' OK AT+QCOAPSEND=0 //查询 CoAP 的 CON 数据发送状态。 +QCOAPSEND: 0,0 //未发送。 OK AT+QCOAPSEND=0,0,2,0 //使用 CON 类型发送 POST 请求到 CoAP 服务器端。 > ;rt='oma.lwm2m';ct=11543,,,,,, OK //接收到 CoAP 服务器的响应后返回该 URC，为 201，为 39928，为 132， 为 8 字节，为 E8532A1373BE54B8，为 8，为'rd'和 '869154040004132'。 +QCOAPURC: 0,2,201,39928,132,4,' E8532A1373BE54B8',8,'rd',8,'869154040004132' //接收到 CoAP 服务器的请求后返回该 URC，为 0（CON 请求），为 1（GET 获取）， 为 41128，为 134，为 8 字节，为 E8532D1363BE54B9， 为 6、11、11，分别对应为'0'、'3'、'0'。 上海移远通信技术股份有限公司 25 / 30 BC25&BC32 系列 CoAP 应用指导 +QCOAPURC: 0,0,1,41128,134,8,'E8532D1363BE54B9',6,'0',11,'3',11,'0' //根据上次请求 URC 内容配置 CoAP 消息为 41128，为 8 字节，为 E8532D1363BE54B9。 AT+QCOAPHEAD=0,5,41128,8,'E8532D1363BE54B9' OK //使用 ACK 类型发送 205 响应码及'AAAA'数据到 IoT 平台。 AT+QCOAPSEND=0,2,205,0 > AAAA OK OK AT+QCOAPCLOSE=0 OK //删除 CoAP 上下文。 +QCOAPCLOSE: 0,0 //CoAP 上下文删除成功。 上海移远通信技术股份有限公司 26 / 30 BC25&BC32 系列 CoAP 应用指导 5 结果码 下表列出了 CoAP 相关命令的执行结果码详情。 表 2：结果码 结果码 0 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 含义 操作成功 参数损坏 操作正在执行 操作不被允许 网络错误 DNS 错误 数据正在发送 Socket 连接错误 内存溢出错误 DTLS 握手失败 CoAP 客户端 ID 复用错误 数据发送失败 上海移远通信技术股份有限公司 27 / 30 BC25&BC32 系列 CoAP 应用指导 6 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_BC25 系列_AT 命令手册 [2] Quectel_BC32_AT 命令手册 表 4：术语缩写 缩写 3GPP ACK CoAP CON DNS DTLS ID loT IP NON OPT PIN PS 英文全称 3rd Generation Partnership Project Acknowledgement Constrained Application Protocol Confirmable Domain Name Server Datagram Transport Layer Security Identification Internet of Things Internet Protocol Non-confirmable Option Personal Identification Number Packet Switch 中文全称 第三代合作伙伴计划 应答消息 受限应用协议 需要应答 域名系统（服务）协议 数据包传输层安全协议 标识符 物联网 国际互联网协议 不需要应答 选项 个人识别号码 分组交换 上海移远通信技术股份有限公司 28 / 29 RST TA TE URC Reset Terminal Adapter Terminal Equipment Unsolicited Result Code BC25&BC32 系列 CoAP 应用指导 复位 终端适配器 终端设备 非请求结果码 上海移远通信技术股份有限公司 29 / 29

BC28-CNV&BC95-CNV CoAP 应用指导 NB-IoT 模块系列 版本：1.1 日期：2022-06-24 状态：受控文件 BC28-CNV&BC95-CNV CoAP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 文档历史 修订记录 版本 1.0 日期 2021-06-28 2021-10-22 作者 Benjamin LU/ Howie DONG Benjamin LU/ Howie DONG 1.1 2022-06-24 Howie DONG 变更表述 文档创建 受控版本 1. 调整参数支持的取值 2. 增加 AT+QCOAPOPTION 命令备注 3. 删除第 4.1 章重复举例 4. 增加发送请求注册到 IoT 平台举例（第 4.2 章） 上海移远通信技术股份有限公司 3 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 目录 文档历史 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................ 4 表格索引 ..................................................................................................................................................... 5 1 引言 ..................................................................................................................................................... 6 2 CoAP 相关 AT 命令............................................................................................................................. 7 2.1. AT 命令说明.............................................................................................................................. 7 2.1.1. 定义 ............................................................................................................................... 7 2.1.2. AT 命令语句 ................................................................................................................... 7 2.2. AT 示例声明.............................................................................................................................. 8 2.3. AT 命令详解.............................................................................................................................. 8 2.3.1. AT+QCOAPOPEN 创建 CoAP 上下文......................................................................... 8 2.3.2. AT+QCOAPCLOSE 删除 CoAP 上下文....................................................................... 9 2.3.3. AT+QCOAPOPTION 配置 CoAP 消息选项................................................................ 10 2.3.4. AT+QCOAPHEAD 配置 CoAP 消息的 Message ID 和 Token .................................... 13 2.3.5. AT+QCOAPSEND 发送数据...................................................................................... 14 3 CoAP 相关 URC................................................................................................................................ 19 4 举例 ................................................................................................................................................... 22 4.1. 发送请求到 CoAP 服务器........................................................................................................ 22 4.2. 发送请求注册到 IoT 平台 ........................................................................................................ 24 5 结果码 ............................................................................................................................................... 26 6 错误码 ............................................................................................................................................... 27 7 附录 参考文档及术语缩写 ................................................................................................................. 28 上海移远通信技术股份有限公司 4 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 表格索引 表 1：AT 命令类型......................................................................................................................................7 表 2：结果码................................................................................................................................26 表 3：通用错误代码（27.007）................................................................................................................27 表 4：参考文档 .........................................................................................................................................28 表 5：术语缩写 .........................................................................................................................................28 上海移远通信技术股份有限公司 5 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 1 引言 本文档主要介绍如何通过 AT 命令使用 BC28-CNV 和 BC95-CNV 模块的 CoAP 协议相关功能。 上海移远通信技术股份有限公司 6 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 2 CoAP 相关 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系 或连续性。 2.3. AT 命令详解 2.3.1. AT+QCOAPOPEN 创建 CoAP 上下文 该命令用于创建 CoAP 上下文。 AT+QCOAPOPEN 测试命令 AT+QCOAPOPEN=? 创建 CoAP 上下文 响应 +QCOAPOPEN: (支持的列表),,(支持 的范围) 查询命令 AT+QCOAPOPEN? OK 响应 [+QCOAPOPEN: ,,,] 设置命令 AT+QCOAPOPEN=,, OK 响应 OK +QCOAPOPEN: , 最大响应时间 特性说明 若发生任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。CoAP 客户端 ID。目前仅支持 0。 字符串类型。CoAP 服务器地址。该参数值仅支持 IPv4 或 IPv6 的 IP 地址，最大长 度为 45 字节。 上海移远通信技术股份有限公司 8 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 整型。CoAP 服务器端口。范围：1~65535。 整型。CoAP 客户端的当前状态。 0 空闲状态或连接断开。 1 CoAP 客户端正在打开。 2 CoAP 客户端正在连接到 CoAP 服务器。 3 CoAP 客户端已连接。 4 CoAP 连接正在断开。 整型。命令执行结果，详见第 5 章。 整型。错误码，详见第 6 章。 举例 AT+QCOAPOPEN=? +QCOAPOPEN: (0),,(1-65535) OK AT+QCOAPOPEN=0,'220.180.239.212',8032 OK +QCOAPOPEN: 0,0 AT+QCOAPOPEN? +QCOAPOPEN: 0,'220.180.239.212',8032,1 OK //查询相关参数值范围。 //创建 CoAP 上下文。 //查询 CoAP 客户端的当前状态。 2.3.2. AT+QCOAPCLOSE 删除 CoAP 上下文 该命令用于删除 CoAP 上下文。 AT+QCOAPCLOSE 测试命令 AT+QCOAPCLOSE=? 删除 CoAP 上下文 响应 +QCOAPCLOSE: (支持的列表) 设置命令 AT+QCOAPCLOSE= OK 响应 OK +QCOAPCLOSE: , 若发生任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 9 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。命令执行结果，详见第 5 章。 整型。错误码，详见第 6 章。 举例 AT+QCOAPCLOSE=? +QCOAPCLOSE: (0) OK AT+QCOAPOPEN=0,'220.180.239.212',8032 OK +QCOAPOPEN: 0,0 AT+QCOAPCLOSE=0 OK +QCOAPCLOSE: 0,0 //查询相关参数值范围。 //创建 CoAP 上下文。 //删除 CoAP 上下文。 2.3.3. AT+QCOAPOPTION 配置 CoAP 消息选项 该命令用于配置 CoAP 消息的选项。 AT+QCOAPOPTION 测试命令 AT+QCOAPOPTION=? 配置 CoAP 消息选项 响应 +QCOAPOPTION: ( 支 持 的 列 表 ),( 支 持 的 列 表 ),,( 支 持 的 范 围),,(支持的列表) 设置命令 若不等于 11 AT+QCOAPOPTION=,,,, OK 响应 OK 若发生任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 10 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 设置命令 若等于 11 AT+QCOAPOPTION=,,,,[,] 响应 OK 若发生任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。用于添加或删除 CoAP 配置选项的选项索引号。目前仅支持 0，即不配 置任何选项索引号。 整型。CoAP 选项名称。详情请参考 RFC 7252 和 RFC 7959。 1 If-Match 3 Uri-Host 4 ETag 5 If-None-Match 6 Observe 8 Location-Path 11 Uri-Path 12 Content-Format 14 Max-Age 15 Uri-Query 17 Accept 20 Location-Query 23 Block2 27 Block1 28 Size2 35 Proxy-Uri 整型。的长度。单位：字节。 CoAP 选项值。最大长度为 255 字节。详情请参考 RFC 7252 和 RFC 7959。 若为 23 或 27，则需按照公式计算值，计算公式为： = (block_num << 4) | (block_more&0x8) | log2(block_size/16)。 若为 12 或 17，则的值将如下所示： '0' Text-plain '40' Application/link-format '41' Application/xml '42' Application/octet-stream 上海移远通信技术股份有限公司 11 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 '47' Application/exi '50' Application/json 整型。仅当为 11 时适用，若省略则默认使用其默认值 0。 0 Uri_path 以'/'分割为多个 CoAP 选项 1 Uri_path 作为一个整体 整型。错误码，详见第 6 章。 举例 AT+QCOAPOPTION=? +QCOAPOPTION: (0),(0),,(0-255),,(0,1) OK //配置 CoAP 选项为 11（Uri-path），选项值为'rd'，长度为 2 字节，以'/'分割为多个 CoAP 选项。 AT+QCOAPOPTION=0,0,11,2,'rd' OK //配置 CoAP 选项为 15（Uri-Query），选项值为'ep=86370303'，长度为 11 字节。 AT+QCOAPOPTION=0,0,15,11,'ep=86370303' OK 以下 CoAP 选项参数需要特别关注： 1 (If-Match) 3 (Uri-Host) 4 (ETag) 5 (If-None-Match) 6 (Observe) 8 (Location-Path) 11 (Uri-Path) 12 (Content-Format) 14 (Max-Age) 15 (Uri-Query) 17 (Content-Format) 字符串类型 字符串类型 字符串类型 NULL 整型 字符串类型 字符串类型 整型 整型 字符串类型 整型 长度范围：0~8 长度范围：1~255 长度范围：1~8 只支持0 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：0~2 长度范围：0~255 长度范围：0~255 长度范围：0~2 上海移远通信技术股份有限公司 12 / 29 20 (Location-Query) 23 (Block2) 27 (Block1) 28 (Size2) 35 (Proxy-Uri) 字符串类型 整型 整型 整型 字符串类型 BC28-CNV&BC95-CNV CoAP 应用指导 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：0~255 长度范围：1~255 备注 当等于 0 时，若为整型参数，此时默认值为 0；若为字符串型参数，默认值为 NULL。 2.3.4. AT+QCOAPHEAD 配置 CoAP 消息的 Message ID 和 Token 该命令用于配置 CoAP 消息的 Message ID 和 Token。 AT+QCOAPHEAD 测试命令 AT+QCOAPHEAD=? 配置 CoAP 消息的 Message ID 和 Token 响应 +QCOAPHEAD: (支持的列表),(支持的范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围), OK 若发生任何错误： ERROR 或者 设置命令 +CME ERROR: 响应 AT+QCOAPHEAD=, [,[][,, ]] OK 若发生任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 13 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。CoAP 配置 Message ID 和 Token 的模式选择。范围：1~5。 1 随机生成 Message ID 和 Token 值。 2 随机生成 Message ID，不包含 Token 值。 3 仅配置 Message ID，不包含 Token 值。 4 配置 Message ID，随机生成 Token 值。 5 配置 Message ID 和 Token 值。 整型。CoAP Message ID，仅当为 3、4 或 5 时适用。范围：0~65535。 整型。Token 的长度，仅当为 5 时适用。范围：1~8；单位：字节。 十六进制字符串类型。Token 值，仅当为 5 时适用。 整型。错误码，详见第 6 章。 示例 AT+QCOAPHEAD=? //查询相关参数值范围。 +QCOAPHEAD: (0),(1-5),(0-65535),(1-8), OK AT+QCOAPHEAD=0,1 //随机生成 Message ID 和 Token 值。 OK AT+QCOAPHEAD=0,2 //随机生成 Message ID，不包含 Token 值。 OK AT+QCOAPHEAD=0,3,13940 //仅配置 Message ID 为 13940，不包含 Token 值。 OK AT+QCOAPHEAD=0,4,13940 //配置 Message ID 为 13940，随机生成 Token 值。 OK AT+QCOAPHEAD=0,5,13940,4,'02040608'//配置 Message ID 为 13940，配置 Token 值为'02040608'。 OK 备注 如果不使用此命令，模块默认随机生成 CoAP Message ID 和 Token。 2.3.5. AT+QCOAPSEND 发送数据 该命令用于发送数据到 CoAP 服务器。发送 CON 数据之后，发送结果将自动通知到终端。发送的 CON 数据状态也可以通过终端用 AT+QCOAPSEND=进行查询。 AT+QCOAPSEND 发送数据 测试命令 AT+QCOAPSEND=? 响应 +QCOAPSEND: (支持的列表),(支持的范 上海移远通信技术股份有限公司 14 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 围),,(支持的列表),(支持 的范围), 设置命令 AT+QCOAPSEND= OK 响应 +QCOAPSEND: , OK 设置命令 AT+QCOAPSEND=,, , 响应>后，输入需要发送的数据， 再按下 Ctrl + Z 发送，或按下 Esc 取消操 作。 设置命令 AT+QCOAPSEND=,, ,, 响应>后，输入需要发送的数据， 长度达到值后会自动 发送。 若发生任何错误： ERROR 或者 +CME ERROR: 响应 > OK 若发生任何错误： ERROR 或者 +CME ERROR: 响应 如果为 0： OK 如果不为 0： > OK 若发生任何错误： ERROR 或者 设置命令 +CME ERROR: 响应 AT+QCOAPSEND=,, ,,, OK 若发生任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 15 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。CoAP 协议的消息类型。详情请参考 RFC 7252。 0 需要被确认的请求（CON） 1 不需要被确认的请求（NON） 2 应答消息（ACK） 3 复位消息（RST） 整型。CoAP 协议的请求方法。详情请参考 RFC 7252。 1 GET 获取 2 POST 创建 3 PUT 更新 4 DELETE 删除 整型。CoAP 协议的响应码。详情请参考 RFC 7252。 0 空消息 201 2.01，已创建 202 2.02，已删除 203 2.03，有效 204 2.04，已更改 205 2.05，内容 400 4.00，错误请求 401 4.01，未经许可 402 4.02，错误选项 403 4.03，禁止 404 4.04，未找到 405 4.05，不允许的方式 406 4.06，不接受 412 4.12，前提条件失败 413 4.13，请求的实体太大 415 4.15，不支持的内容格式 500 5.00，内部服务器错误 501 5.01，未实现 502 5.02，错误网关 503 5.03，服务不可用 504 5.04，网关超时 505 5.05，代理不受支持 整型。CoAP 数据包添加选项。目前仅支持 0，即 CoAP 数据包中没有添加任何配 置选项。 整型。输入数据的长度。范围：0~1024；单位：字节。 字符串类型。需要发送的数据。响应>后输入的数据为文本字符串，否则，为十六 进制格式。 上海移远通信技术股份有限公司 16 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 整型。发送的 CON 数据的状态。 0 未发送 1 已发送，等待 CoAP 服务器的响应 2 发送失败 3 超时 4 发送成功 5 获得重置消息 整型。错误码，详见第 6 章。 举例 AT+QCOAPSEND=? +QCOAPSEND: (0),(0-3),,(0),(0-1024), OK AT+QCOAPSEND=0 +QCOAPSEND: 0,0 OK AT+QCOAPSEND=0,0,2,0 //发送 CON 类型的 POST 请求到服务器。 > //响应>后输入要发送的数据，按下 Ctrl + Z 发送数据。 ;rt='oma.lwm2m',,,,,, OK AT+QCOAPSEND=0 +QCOAPSEND: 0,1 //已发送，等待 CoAP 服务器响应。 OK +QCOAPURC: 0,2,201,26923,132,2,'3132',8,'rd',8,'869619050024212' //接收到服务器的响应。 AT+QCOAPSEND=0 +QCOAPSEND: 0,4 //发送成功。 OK AT+QCOAPSEND=0,0,1,0,127,'683836373732353033303536393638390202000000000000010060B8 07B7C89F893C3AE82E2E9527598E16DAB2CDC5D92B65EE24665F21DA270272DF7DC0BEC89D7 DCDFDF33EC4F22C83D927DF1DD6A84D42EE14510951C31967B1EA7CC6E83C00B9CD410E53D A35F8A76D53DD6CBC9CF0D1246F3F481D7FEE6D0B0000E516' OK +QCOAPURC: 0,2,205,26924,133,6,'514CE1000000',12,'0',14,'196607',133,'This is a test server made with libcoap (see https://libcoap.net)Copyright (C) 2010--2021 Olaf Bergmann and others' //接收到服务器的响应。 AT+QCOAPSEND=0 +QCOAPSEND: 0,4 //发送成功。 上海移远通信技术股份有限公司 17 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 OK 备注 1. 最大长度为 1024 字节，超过 1024 字节的数据将被忽略。 2. 若发送 CON 数据，建议在发送下一个 CON 或 NON 数据之前通过 AT+QCOAPSEND=获 取当前 CON 数据的状态。 3. AT+QCOAPSEND=仅用于查询已发送的 CON 数据状态。 4. 数 据 发 送 完 成 后 ， 若 模 块 接 收 到 CoAP 服 务 器 响 应 后 ， 将 上 报 URC +QCOAPURC: ,,,,[,,][,,[,...]][,,]，详情参见第 3 章。 上海移远通信技术股份有限公司 18 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 3 CoAP 相关 URC 本章介绍了与 CoAP 相关的 URC 及其描述。 +QCOAPURC: 通知 TE 响应来自 CoAP 服务器的请求/通知来自 CoAP 服务器的响应 +QCOAPURC: ,,,,[,,] [,,[,...]][,,] 通知 TE 响应来自 CoAP 服务器的请求或通知来 自 CoAP 服务器的响应 参数 整型。CoAP 客户端 ID。目前仅支持 0。 整型。CoAP 协议消息类型。详情请参考 RFC 7252。 0 需要被确认的请求（CON） 1 不需要被确认的请求（NON） 2 应答消息（ACK） 3 复位消息（RST） 整型。CoAP 协议的请求方法。详情请参考 RFC 7252。 1 GET 获取 2 POST 创建 3 PUT 更新 4 DELETE 删除 整型。CoAP 协议的响应码。详情请参考 RFC 7252。 0 空消息 201 2.01，已创建 202 2.02，已删除 203 2.03，有效 204 2.04，已更改 205 2.05，内容 400 4.00，错误请求 401 4.01，未经许可 402 4.02，错误选项 403 4.03，禁止 404 4.04，未找到 405 4.05，不允许的方式 406 4.06，不接受 上海移远通信技术股份有限公司 19 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 412 4.12，前提条件失败 413 4.13，请求的实体太大 415 4.15，不支持的内容格式 500 5.00，内部服务器错误 501 5.01，未实现 502 5.02，错误网关 503 5.03，服务不可用 504 5.04，网关超时 505 5.05，代理不受支持 整型。CoAP 消息 ID。范围：0~65535。 整型。表示是否存在 Data，Option 选项的个数以及是否存在 Token，详情如下： 0 位 1 表示存在 Data，0 表示不存在 Data。 1~6 位 将其转换为十进制即表示 Option 选项的个数。 7 位 1 表示存在 Token，0 表示不存在 Token。 示例：131 的二进制为 1000 0011，表示存在 Token 和 Data 且 Option 选项个 数为 1。 整型。CoAP 服务器 Token 的长度。范围：1~8；单位：字节。 十六进制字符串类型。Token 值。 整型。CoAP 选项名称。详情请参考 RFC 7252 和 RFC 7959。 1 If-Match 3 Uri-Host 4 ETag 5 If-None-Match 6 Observe 8 Location-Path 11 Uri-Path 12 Content-Format 14 Max-Age 15 Uri-Query 17 Accept 20 Location-Query 23 Block2 27 Block1 28 Size2 35 Proxy-Uri 字符串类型。CoAP 选项值。最大长度为 255 字节。 若为 23 或 27，则需按照公式计算值，计算公式为： = (block_num << 4) | (block_more&0x8) | log2(block_size/16)。 若参数为 12 或 17，则的值将如下所示： '0' Text-plain '40' Application/link-format '41' Application/xml '42' Application/octet-stream 上海移远通信技术股份有限公司 20 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 '47' Application/exi '50' Application/json 整型。数据长度。单位：字节。 字 符 串 类 型 。 接 收 的 数 据 。 若 为 12 ， 且 为 '0' （'text-plain'）、'41'（'application/xml'）或'50'（'application/json'）， 的格式将为文本字符串，否则，为十六进制格式。 上海移远通信技术股份有限公司 21 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 4 举例 4.1. 发送请求到 CoAP 服务器 本章节演示使用 AT 命令发送 CoAP 请求到 CoAP 服务器的流程。 AT+CGATT? +CGATT: 1 //查询当前 PS 域服务状态。 //PS 域服务状态为已附着。 OK AT+QCOAPOPEN=0,'220.180.239.212',7002 OK //创建客户端 ID 为 0 的 CoAP 上下文。 +QCOAPOPEN: 0,0 AT+QCOAPOPEN? +QCOAPOPEN: 0,'220.180.239.212',7002,1 //CoAP 上下文创建成功。 //查询 CoAP 客户端状态。 //CoAP 客户端正在打开。 OK AT+QCOAPOPTION=0,0,11,5,'/time' //配置 CoAP 选项为 11（Uri-path），选项值为'/time'，长度为 5 字节。 OK AT+QCOAPSEND=0,0,1,0,0 //使用 CON 类型发送 GET 获取请求并不附带数据到 CoAP 服务器端。 OK AT+QCOAPSEND=0 //查询 CON 数据发送状态。 +QCOAPSEND: 0,1 //已发送，等待 CoAP 服务器的响应。 OK //接收到 CoAP 服务器的响应后返回该 URC，为 205，为 48626，为 133， 为 6 字节，为'F3BDF01A0000'，为 12 和 14，分别对应 为'0'和'1'，为 15 字节，为'Aug 27 09:01:48'。 +QCOAPURC: 0,2,205,48626,133,6,'F3BDF01A0000',12,'0',14,'1',15,'Aug 27 09:01:48' AT+QCOAPSEND=0 +QCOAPSEND: 0,4 //查询 CON 数据发送状态。 //发送成功。 OK 上海移远通信技术股份有限公司 22 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 AT+QCOAPHEAD=0,3,5566 //配置 CoAP 消息的 Message ID 为 5566，不包含 Token 值。 OK AT+QCOAPOPTION=0,0,11,6,'/hello' //配置 CoAP 选项为 11（Uri-path），选项值为'/hello'，长度为 6 字节。 OK AT+QCOAPSEND=0,0,1,0,8 //使用 CON 类型发送 GET 请求且附带长度为 8 字节的数据 01020304 到 CoAP 服务器端。 > 01020304 OK //接收到 CoAP 服务器的响应后返回该 URC，为 205, 为 5566，为 3， 为 12，对应为'0'，为 10 字节，为'HELLOWORLD'。 +QCOAPURC: 0,2,205,5566,3,12,'0',10,'HELLOWORLD' AT+QCOAPHEAD=0,5,6677,4,'30323436' //配置 CoAP 消息 Message ID 为 6677，Token 长度为 4 字节，Token 值为'30323436'。 OK AT+QCOAPOPTION=0,0,11,13,'/example_data' //配置 CoAP 选项为 11（Uri-path），选项值为'/example_data'，长度为 13 字节。 OK AT+QCOAPSEND=0,0,1,0,4,'01020304' //使用 CON 类型发送 GET 请求且附带长度为 4 字节的数据'01020304'到 CoAP 服务器端。 OK //接收到 CoAP 服务器的响应后返回该 URC，为 205，为 6677，为 137， 为 4 字节，为'30323436'，为 4、12、23、28，分别对应 为'02'、'0'、'14'、'1500'，为 1024 字节，为'a12345678….y123'。 +QCOAPURC: 0,2,205,6677,137,4,'30323436',4,'02',12,'0',23,'14',28,'1500',1024,'a123456789b 123456789c123456789d123456789e123456789f123456789g123456789h123456789i123456789j123 456789k123456789l123456789m123456789n123456789o123456789p123456789q123456789r12345 6789s123456789t123456789u123456789v123456789w123456789x123456789y123456789z1234567 89a123456789b123456789c123456789d123456789e123456789f123456789g123456789h123456789i 123456789j123456789k123456789l123456789m123456789n123456789o123456789p123456789q12 3456789r123456789s123456789t123456789u123456789v123456789w123456789x123456789y1234 56789z123456789a123456789b123456789c123456789d123456789e123456789f123456789g123456 789h123456789i123456789j123456789k123456789l123456789m123456789n123456789o123456789 p123456789q123456789r123456789s123456789t123456789u123456789v123456789w123456789x1 23456789y123456789z123456789a123456789b123456789c123456789d123456789e123456789f1234 56789g123456789h123456789i123456789j123456789k123456789l123456789m123456789n1234567 89o123456789p123456789q123456789r123456789s123456789t123456789u123456789v123456789 w123456789x123456789y123' AT+QCOAPCLOSE=0 //删除 CoAP 上下文。 OK 上海移远通信技术股份有限公司 23 / 29 +QCOAPCLOSE: 0,0 BC28-CNV&BC95-CNV CoAP 应用指导 //CoAP 上下文删除成功。 4.2. 发送请求注册到 IoT 平台 本章节演示使用 AT 命令发送 CoAP 请求注册到 IoT 平台的流程。 AT+CGATT? +CGATT: 1 //查询当前 PS 域服务状态。 //PS 域服务状态为已附着。 OK AT+QCOAPOPEN=0,'220.180.239.212',7002 //创建客户端 ID 为 0 的 CoAP 上下文。 OK +QCOAPOPEN: 0,0 AT+QCOAPOPEN? +QCOAPOPEN: 0,'220.180.239.212',7002,1 //CoAP 上下文创建成功。 //查询 CoAP 客户端状态。 //CoAP 客户端正在打开。 OK AT+QCOAPOPTION=0,0,11,2,'rd',1 节。 //配置 CoAP 选项为 11（Uri-path），选项值为'rd'，长度为 2 字 OK AT+QCOAPOPTION=0,0,12,2,'42' //配置 CoAP 选项为 12（Content-Format），选项值为'42 （Application/octet-stream），长度为 2 字节。 OK AT+QCOAPOPTION=0,0,15,40,'lwm2m=1.0&ep=869619050023990&b=U&lt=1200' //配置 CoAP 选 项为 15（Uri-Query）选项值为'lwm2m=1.0&ep=869619050023990&b=U&lt=1200'，长度为 40 字节。 OK AT+QCOAPSEND=0,0,2,0 //使用 CON 类型发送 POST 请求及指定格式数据到 IoT 平台。 > ;rt='oma.lwm2m',,,,,,,, //输入的数据。 OK //接收到 CoAP 服务器的响应后返回该 URC，为 201，为 46924，为 132， 为 6 字节，为 4DB7D4000000，为 8，对应分别为'rd' 和'869619050023990'。 +QCOAPURC: 0,2,201,46924,132,6,'4DB7D4000000',8,'rd',8,'869619050023990' //接收到 CoAP 服务器的请求后返回该 URC，为 0（CON 请求），为 1（GET 获取）， 为 41128，为 134，为 8 字节，为 E8532D1363BE54B9， 为 6、11、11，分别对应为'0'、'3'、'0'。 +QCOAPURC: 0,0,1,41128,134,8,'E8532D1363BE54B9',6,'0',11,'3',11,'0' //根据上次请求 URC 内容配置 CoAP 消息为 41128，为 8 字节，为 上海移远通信技术股份有限公司 24 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 E8532D1363BE54B9。 AT+QCOAPHEAD=0,5,41128,8,'E8532D1363BE54B9' OK AT+QCOAPSEND=0,2,205,0 //使用 ACK 类型发送 205 响应码及'AAAA'数据到 IoT 平台。 > AAAA OK AT+QCOAPCLOSE=0 //删除 CoAP 上下文。 OK +QCOAPCLOSE: 0,0 //CoAP 上下文删除成功。 上海移远通信技术股份有限公司 25 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 5 结果码 下表列出了 CoAP 相关命令的执行结果码详情。 表 2：结果码 结果码 0 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 含义 操作成功 参数损坏 操作正在执行 操作不被允许 网络错误 DNS 错误 无法激活 PDP 上下文 Socket 连接错误 内存溢出错误 DTLS 握手失败 CoAP 客户端 ID 被占用 数据发送失败 上海移远通信技术股份有限公司 26 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 6 错误码 本章总结了与 BC28-CNV 和 BC95-CNV 模块相关的错误码。 以下两个表中列出的错误码均符合 3GPP 规范。如需查看相关错误码，请参考 3GPP TS 27.007 V13.5.0 子条款 9.2。 表 3：通用错误代码（27.007） 错误码 英文描述 中文描述 3 Operation not allowed 不允许此操作 4 Operation not supported 不支持此操作 23 Memory failure 内存故障 30 No network service 无网络服务 50 Incorrect parameters 参数不正确 51 Command implemented but currently disabled 已执行命令但当前被禁用 52 Command aborted by user 此命令被用户终止 159 Uplink busy/flow control 上行忙碌/流控 备注 AT+CMEE=命令可以使能（=1）或禁用（=0）结果码+CME ERROR: 。当=1 并发 生错误时，将响应结果码+CME ERROR: ；当=0 并发生错误时，仅响应 ERROR。如需了解此 命令的详细内容，请参考文档 [1]。 上海移远通信技术股份有限公司 27 / 29 BC28-CNV&BC95-CNV CoAP 应用指导 7 附录 参考文档及术语缩写 表 4：参考文档 文档名称 [1] Quectel_BC28-CNV&BC95-CNV_AT 命令手册 表 5：术语缩写 缩写 3GPP ACK CoAP DNS DTLS ID loT IP ME OPT PDU PIN PS PUK 英文全称 3rd Generation Partnership Project Acknowledgement Constrained Application Protocol Domain Name Server Datagram Transport Layer Security Identifier Internet of Things Internet Protocol Mobile Equipment Option Protocol Data Unit Personal Identification Number Packet Switched PIN Unlock Key 中文全称 第三代合作伙伴计划 确认消息 受限应用协议 域名系统（服务）协议 数据包传输层安全协议 标识符 物联网 国际互联网协议 移动设备 选项 协议数据单元 个人识别码 分组交换 PIN 解锁码 上海移远通信技术股份有限公司 28 / 29 RST SMS SMSC TA TE URC USIM BC28-CNV&BC95-CNV CoAP 应用指导 Reset Short Message Service Short Message Service Center Terminal Adapter Terminal Equipment Unsolicited Result Code Universal Subscriber Identity Module 复位 短消息服务 短消息服务中心 终端适配器 终端设备 非请求结果码 通用用户身份识别模块 上海移远通信技术股份有限公司 29 / 29

EP06&EG06&EM06 系列 SLIC 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-07-12 状态：受控文件 EP06&EG06&EM06 系列 SLIC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2022-05-23 Shaun DUAN 文档创建 1.0 2022-07-12 Shaun DUAN 受控版本 上海移远通信技术股份有限公司 3 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................ 7 2.3. AT+QSLIC 启用/禁用 SLIC...................................................................................................... 8 3 设计方案 .............................................................................................................................................. 10 3.1. 设计框图 ................................................................................................................................... 10 3.1.1. Modem 侧.......................................................................................................................11 3.1.2. AP 侧 ..............................................................................................................................11 3.2. SLIC 主要功能 ...........................................................................................................................11 3.2.1. 语音数据传输和控制.......................................................................................................11 3.2.2. 话机控制 .........................................................................................................................11 3.2.3. 呼叫状态控制..................................................................................................................11 4 SLIC 功能列表..................................................................................................................................... 12 5 附录 参考文档及术语缩写 .................................................................................................................. 14 上海移远通信技术股份有限公司 4 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：SLIC 功能列表 .................................................................................................................................. 12 表 3：术语缩写 ........................................................................................................................................... 14 上海移远通信技术股份有限公司 5 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 1 引言 本文档介绍如何使用移远通信 EP06、EG06 和 EM06 系列模块的 SLIC 功能，包括相关 AT 命令、设 计方案和功能介绍。 上海移远通信技术股份有限公司 6 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 7 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 2.3. AT+QSLIC 启用/禁用 SLIC 该命令用于启用/禁用 SLIC。 AT+QSLIC 启用/禁用 SLIC 测试命令 AT+QSLIC=? 响应 +QSLIC: (支持的列表),(支持的范围) 查询命令 AT+QSLIC? OK 响应 +QSLIC: [,] 设置命令 AT+QSLIC=, OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用 SLIC。 0 禁用 1 启用 整型。设置 SLIC 类型。 0 预留 1 LE9641（暂不支持） 2 SI32185 3 LE9643 举例 AT+QSLIC=? +QSLIC: (0,1),(0-3) OK AT+QSLIC=0,3 OK AT+QSLIC=1,3 OK //测试命令。 //禁用 SLIC。 //启用 SLIC 并设置 SLIC 平台类型为 LE9643。 上海移远通信技术股份有限公司 8 / 14 AT+QSLIC? +QSLIC: 1,3 OK //查询当前配置。 EP06&EG06&EM06 系列 SLIC 应用指导 上海移远通信技术股份有限公司 9 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 3 设计方案 3.1. 设计框图 模块的 SLIC 功能软件框架设计如下图所示： VoLTE Service & CS Voice Service Audio Voice Core Services QMI SLIC App Voice Server PCM Call Manager DSCI AT AT^DSCI ATA/ ATD/ CHLD/ VTS/... Control Driver PCM SPI SLIC RJ11 图 1：SLIC 功能设计框图 备注 本章节相关 AT 命令详情，请参考模块的 AT 命令手册。 Control Path Data Path 上海移远通信技术股份有限公司 10 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 3.1.1. Modem 侧 模块在 Modem 侧提供了一系列用于实现呼叫功能的 AT 命令，包括发起呼叫（ATD）、接听（ATA）、 挂断（ATH）、呼叫状态上报（AT^DSCI）、多方通话管理（AT+CHLD）、DTMF（AT+VTS）等。这些命令 直接控制 Modem 侧的呼叫相关业务。 3.1.2. AP 侧 移远通信基于上述 AT 命令在模块的 AP 侧开发了 SLIC 应用程序和 Voice Server 应用程序。 SLIC 应用程序支持以下功能：通过电话状态机和 AT 命令进行 Modem 侧的呼叫状态控制、通过 SPI 与 SLIC 设备进行交互、获取话机的操作和控制话机的线路状态。 Voice Server 应用程序支持以下功能：控制语音链路的开关和语音数据传输，控制 PCM 时钟的开关， 提供本地铃声方案，输出不同国家或地区的标准的忙音、呼叫等待音和结束音等。 3.2. SLIC 主要功能 SLIC 主要支持三部分功能：语音数据传输和控制、话机控制和呼叫状态控制。 3.2.1. 语音数据传输和控制 基于 VoLTE 协议栈和音频管理组件，模块能够实现基于语音链路和 SLIC 设备的通话功能。 模块能将下行链路的语音数据通过声卡传输到 SLIC 芯片，SLIC 芯片将语音数据解码为模拟信号，通 过 RJ11 将信号传输给话机，话机通过扬声器播放声音。同时，话机的麦克风采集到的语音模拟信号会传输 到 SLIC 芯片，SLIC 芯片将模拟信号编码为数字信号，即语音数据，然后通过声卡传输到上行语音链路中。 3.2.2. 话机控制 话机支持的操作有：DTMF 按键、摘机（Off-Hook）、挂机（On-Hook）、闪断键（Flash Button）。当 话机进行以上操作时，SLIC 芯片通过 RJ11 获取话机信号，并分析话机的动作，写入 SLIC 芯片的寄存器 中，模块通过 SPI 驱动读取 SLIC 芯片的相关寄存器，从而获得话机的操作；同时，模块也可以通过 SPI 驱动配置 SLIC 寄存器，让 SLIC 芯片产生信号给话机，让话机实现振铃、来电显示等功能。 3.2.3. 呼叫状态控制 基于 VoLTE 协议栈，执行 AT^DSCI=1 后，Modem 侧能够将呼叫状态主动上报到 SMD 通道，AP 侧 的 SLIC 应用程序通过 SMD 通道获取呼叫状态。同时，AP 侧的 SLIC 应用程序可以通过 SMD 通道向 Modem 侧发送 AT 命令，实现接听（ATA）、挂断（ATH）、多方通话管理（AT+CHLD）等功能。 上海移远通信技术股份有限公司 11 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 4 SLIC 功能列表 本章节介绍模块的详细 SLIC 功能。 表 2：SLIC 功能列表 功能 电源管理 摘机（Off-Hook） 挂机（On-Hook） 拨号 来电显示 振铃 来电接听 发起呼叫 带外 DTMF 切换通话（呼叫保持） 三方通话（电话会议） 功能详解 1. 启用 SLIC 后，话机上电，话机屏幕点亮。 2. 禁用 SLIC 后，话机掉电，话机屏幕关闭。 话机挂机状态下，无来电，话机摘机后播放拨号音。 1. 通话中挂机，挂机可以挂断当前通话。 2. 拨号中挂机，挂机可以终止拨号，并清空已拨号码。 挂机状态下，摘机听到拨号音后，按下 DTMF 键，拨号音停止。且依次按 下期望拨出的号码，当最后一个按键按下后，等待 5 秒，拨出电话。 话机挂机状态下，有来电时，话机屏幕上显示来电号码。 话机挂机状态下，有来电时，话机振铃，提醒来电。 话机挂机状态下，有来电时，话机摘机后即可接听。 1. 拨号完毕后，话机实现语音通话。 2. 来电接听后，话机实现语音通话。 通话状态下，话机按下'0'~'9'、'#'、'*' 等按键后，可以发送对应 的信令。 话机与一方（例如 A）通话时，按下 Flash 按键，约 4 秒后，A 将保持呼 叫等待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B），话机可以 与 B 通话，再次按下 Flash 按键后，能够保持与 B 的通话，切换到与 A 的 通话，重复按下 Flash 按键后，能够切换 A 与 B 之间的通话。 1. 话机与一方（例如 A）通话时，按下 Flash 按键，约 4 秒后，A 将保 持呼叫等待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B）， 话机可以与 B 通话，按下 Flash 键后约 500 毫秒~2 秒内，按下按键 '3'，合并通话，此时将实现与 A 和 B 的三方通话。 2. 如需继续增加通话，请继续以下步骤： 1) 再次按下 Flash 按键，保持与 A 和 B 的合并通话，话机再次响起 拨号音。 2) 再次拨号呼叫另一方（例如 C），话机可以与 C 通话，按下 Flash 按键后，能够保持与 C 的通话，切换到与 A 和 B 的合并通话。重 上海移远通信技术股份有限公司 12 / 14 拨号音 忙音 等待音 结束音 EP06&EG06&EM06 系列 SLIC 应用指导 复按下 Flash 键，能够切换 A 和 B 的合并通话与 C 的通话。 3) 按下 Flash 按键后约 500 毫秒~2 秒内，按下按键'3'，能够合并 通话。此时将实现与 A、B 和 C 的四方通话。 3. 如果需要继续增加通话，重复以上步骤 1) ~ 3) 即可，最多可支持七 方通话（含模块一方）的电话会议。 挂机状态下，无来电，摘机后话机播放拨号音。 模块发起呼叫，对方拒接，话机播放忙音（或运营商的铃音）。 模块正在通话中，第三方呼叫模块，话机播放等待音（或运营商的铃音）。 模块正在通话中，对方挂断电话，话机播放结束音。 上海移远通信技术股份有限公司 13 / 14 EP06&EG06&EM06 系列 SLIC 应用指导 5 附录 参考文档及术语缩写 表 3：术语缩写 术语 AP CS DTMF PCM QMI SLIC SMD SPI TA VoLTE 英文全称 Access Point Circuit Switched Dual-Tone Multifrequency Pulse Code Modulation Qualcomm Message Interface Subscriber Line Interface Circuit Shared Memory Driver Serial Peripheral Interface Terminal Adapter Voice over Long-Term Evolution 中文全称 访问接入点 电路交换 双音多频 脉冲编码调制 高通信息接口 用户线路接口电路 共享内存驱动 串行外设接口 终端适配器 长期演进语音承载 上海移远通信技术股份有限公司 14 / 14

EM12&EG12&EG18 系列 SLIC 应用指导 LTE-A 模块系列 版本：1.1 日期：2023-12-19 状态：受控文件 EM12&EG12&EG18 系列 SLIC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2022-05-23 Shaun DUAN 文档创建 1.0 2022-07-12 Shaun DUAN 受控版本 1. 更新文档章节结构。 2. 新增关于 Data + Voice 功能支持要求的备注（第 1 章）。 3. 新增 SLIC 扩展功能列表（第 3 章）。 4. 新增 SLIC 相关 AT 命令（第 4 章）： 1.1 2023-12-19 Jone WANG ⚫ AT+QAUDCFG='slic/AudLoop' ⚫ AT+QAUDCFG='slic/LF_Ring' ⚫ AT+QAUDCFG='slic_IndRep' ⚫ AT+QAUDCFG='slic_cid_cfg' ⚫ AT+QAUDCFG='slic_cid' ⚫ AT+QAUDCFG='slic_hook_time' 上海移远通信技术股份有限公司 3 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 设计方案 ................................................................................................................................................ 7 2.1. 设计框图 ..................................................................................................................................... 7 2.1.1. Modem 侧........................................................................................................................ 8 2.1.2. AP 侧 ............................................................................................................................... 8 2.2. SLIC 主要功能 ............................................................................................................................ 8 2.2.1. 语音数据传输和控制........................................................................................................ 8 2.2.2. 话机控制 .......................................................................................................................... 8 2.2.3. 呼叫状态控制................................................................................................................... 9 3 SLIC 功能列表..................................................................................................................................... 10 4 AT 命令详解 ........................................................................................................................................ 14 4.1. AT 命令说明.............................................................................................................................. 14 4.1.1. 定义 ............................................................................................................................... 14 4.1.2. AT 命令语句 .................................................................................................................. 14 4.2. AT 示例声明.............................................................................................................................. 15 4.3. AT+QSLIC 启用/禁用 SLIC.................................................................................................... 15 4.4. AT+QAUDCFG='slic/AudLoop' 启用/禁用模拟话机的拨号音............................................... 16 4.5. AT+QAUDCFG='slic/LF_Ring' 启用/禁用模拟话机振铃 ....................................................... 17 4.6. AT+QAUDCFG='slic_IndRep' 启用/禁用模拟话机的事件上报功能...................................... 18 4.7. AT+QAUDCFG='slic_cid_cfg' 设置 SLIC 来电显示模式 ...................................................... 19 4.8. AT+QAUDCFG='slic_cid' 配置模拟话机的来电显示 ............................................................ 20 4.9. AT+QAUDCFG='slic_hook_time' 配置模拟话机的摘挂机及闪断键检测时间....................... 21 5 附录 参考文档及术语缩写 .................................................................................................................. 23 上海移远通信技术股份有限公司 4 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 表格索引 表 1：SLIC 基本功能列表........................................................................................................................... 10 表 2：SLIC 扩展功能列表............................................................................................................................11 表 3：AT 命令类型...................................................................................................................................... 14 表 4：术语缩写 ........................................................................................................................................... 23 上海移远通信技术股份有限公司 5 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 1 引言 本文档介绍如何使用移远通信 EM12-G、EG12 和 EG18 系列模块的 SLIC 功能，包括设计方案、功能 介绍和相关 AT 命令。 备注 本文当仅适用于支持 Data + Voice 的模块。模块是否支持 Data + Voice，请参见对应模块的产品规格书。 上海移远通信技术股份有限公司 6 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 2 设计方案 2.1. 设计框图 模块的 SLIC 功能软件框架设计如下图所示： VoLTE Service & CS Voice Service Audio Voice Core Services QMI SLIC App Voice Server PCM Call Manager DSCI AT AT^DSCI ATA/ ATD/ CHLD/ VTS/... Control Driver PCM SPI SLIC RJ11 图 1：SLIC 功能设计框图 备注 本章节相关 AT 命令详情，请参考模块的 AT 命令手册。 Control Path Data Path 上海移远通信技术股份有限公司 7 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 2.1.1. Modem 侧 模块在 Modem 侧提供了一系列用于实现呼叫功能的 AT 命令，包括发起呼叫（ATD）、接听（ATA）、 挂断（ATH）、呼叫状态上报（AT^DSCI）、多方通话管理（AT+CHLD）、DTMF（AT+VTS）等。这些命令 直接控制 Modem 侧的呼叫相关业务。 2.1.2. AP 侧 移远通信基于上述 AT 命令在模块的 AP 侧开发了 SLIC 应用程序和 Voice Server 应用程序。 SLIC 应用程序支持以下功能：通过电话状态机和 AT 命令进行 Modem 侧的呼叫状态控制、通过 SPI 与 SLIC 设备进行交互、获取话机的操作和控制话机的线路状态。 Voice Server 应用程序支持以下功能：控制语音链路的开关和语音数据传输，控制 PCM 时钟的开关， 提供本地铃声方案，输出不同国家或地区的标准的忙音、呼叫等待音和结束音等。 2.2. SLIC 主要功能 SLIC 主要支持三部分功能：语音数据传输和控制、话机控制和呼叫状态控制。 2.2.1. 语音数据传输和控制 基于 VoLTE 协议栈和音频管理组件，模块能够实现基于语音链路和 SLIC 设备的通话功能。 模块能将下行链路的语音数据通过声卡传输到 SLIC 芯片，SLIC 芯片将语音数据解码为模拟信号，通 过 RJ11（电话线）将信号传输给话机，话机通过扬声器播放声音。同时，话机的麦克风采集到的语音模拟 信号会传输到 SLIC 芯片，SLIC 芯片将模拟信号编码为数字信号，即语音数据，然后通过声卡传输到上行 语音链路中。 2.2.2. 话机控制 话机支持的操作有：DTMF 按键、摘机（Off-Hook）、挂机（On-Hook）、闪断键（Flash Button）。当 话机进行以上操作时，SLIC 芯片通过 RJ11 获取话机信号，并分析话机的动作，写入 SLIC 芯片的寄存器 中，模块通过 SPI 驱动读取 SLIC 芯片的相关寄存器，从而获得话机的操作；同时，模块也可以通过 SPI 驱动配置 SLIC 寄存器，让 SLIC 芯片产生信号给话机，让话机实现振铃、来电显示等功能。 上海移远通信技术股份有限公司 8 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 2.2.3. 呼叫状态控制 基于 VoLTE 协议栈，执行 AT^DSCI=1 后，Modem 侧能够将呼叫状态主动上报到 SMD 通道，AP 侧 的 SLIC 应用程序通过 SMD 通道获取呼叫状态。同时，AP 侧的 SLIC 应用程序可以通过 SMD 通道向 Modem 侧发送 AT 命令，实现接听（ATA）、挂断（ATH）、多方通话管理（AT+CHLD）等功能。 上海移远通信技术股份有限公司 9 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 3 SLIC 功能列表 本章节介绍模块的详细 SLIC 功能。其主要为两个部分： 1) 基本功能：介绍 SLIC 基础业务相关的功能。 2) 扩展功能：对 SLIC 基础业务的扩充，增加了 SLIC 的产线辅助验证功能、参数配置功能和语音业 务功能。 表 1：SLIC 基本功能列表 功能 电源管理 摘机（Off-Hook） 挂机（On-Hook） 拨号 来电显示 振铃 来电接听 发起呼叫 带外 DTMF 切换通话（呼叫保持） 三方通话（电话会议） 功能详解 1. 启用 SLIC 后，话机上电，话机屏幕点亮。 2. 禁用 SLIC 后，话机掉电，话机屏幕关闭。 话机挂机状态下，无来电，话机摘机后播放拨号音。 1. 通话中挂机，挂机可以挂断当前通话。 2. 拨号中挂机，挂机可以终止拨号，并清空已拨号码。 挂机状态下，摘机听到拨号音后，按下 DTMF 键，拨号音停止。且依次按 下期望拨出的号码，当最后一个按键按下后，等待 5 秒，拨出电话。 话机挂机状态下，有来电时，话机屏幕上显示来电号码。 话机挂机状态下，有来电时，话机振铃，提醒来电。 话机挂机状态下，有来电时，话机摘机后即可接听。 拨号完毕后，话机实现语音通话。 通话状态下，话机按下'0'~'9'、'#'、'*' 等按键后，可以发送对应 的信令。 话机与一方（例如 A）通话时，按下 Flash 按键，约 4 秒后，A 将保持呼 叫等待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B），话机可以 与 B 通话，再次按下 Flash 按键后，能够保持与 B 的通话，切换到与 A 的 通话，重复按下 Flash 按键后，能够切换 A 与 B 之间的通话。 1. 话机与一方（例如 A）通话时，按下 Flash 按键，约 4 秒后，A 将保 持呼叫等待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B）， 话机可以与 B 通话，按下 Flash 键后约 500 毫秒~2 秒内，按下按键 '3'，合并通话，此时将实现与 A 和 B 的三方通话。 2. 如需继续增加通话，请继续以下步骤： 1) 再次按下 Flash 按键，保持与 A 和 B 的合并通话，话机再次响起 上海移远通信技术股份有限公司 10 / 23 拨号音 忙音 等待音 结束音 EM12&EG12&EG18 系列 SLIC 应用指导 拨号音。 2) 再次拨号呼叫另一方（例如 C），话机可以与 C 通话，按下 Flash 按键后，能够保持与 C 的通话，切换到与 A 和 B 的合并通话。重 复按下 Flash 键，能够切换 A 和 B 的合并通话与 C 的通话。 3) 按下 Flash 按键后约 500 毫秒~2 秒内，按下按键'3'，能够合并 通话。此时将实现与 A、B 和 C 的四方通话。 3. 如果需要继续增加通话，重复以上步骤 1) ~ 3) 即可，最多可支持七 方通话（含模块一方）的电话会议。 挂机状态下，无来电，摘机后话机播放拨号音。 模块发起呼叫，对方拒接，话机播放忙音（或运营商的铃音）。 模块正在通话中，第三方呼叫模块，话机播放等待音（或运营商的铃音）。 模块正在通话中，对方挂断电话，话机播放结束音。 表 2：SLIC 扩展功能列表 扩展功能 产线测试音频回环 功能详解 产品测试功能，无需拨打电话即可测试设备录音、播音功能是否正常。 步骤一：执行 AT+QAUDCFG='slic/AudLoop',1 关闭拨号音； 步骤二：执行 AT+QSIDET=65535 调大侧音增益； 步骤三： 对话柄麦克风说话，声音从听筒传出则表明设备的录/播音功能正常； 步骤四：执行 AT+QAUDCFG='slic/AudLoop',0 开启拨号音。 产线测试振铃 产线测试事件上报 产线测试配置来电显示 模式 备注： 执行步骤一至步骤三完成测试后，需按照步骤四开启拨号音。 产品测试功能，无需来电即可测试设备振铃功能是否正常。 步骤一：执行 AT+QAUDCFG='slic/LF_Ring',1 启用模拟电话振铃； 步骤二：执行 AT+QAUDCFG='slic/LF_Ring',0 禁用模拟电话振铃。 产品测试功能，测试话机事件检测功能是否正常。 步骤一：执行 AT+QAUDCFG='slic_IndRep',1 启用话机事件上报功能； 步骤二：对话机进行摘机、挂机、按 Flash 键、按 0~9、*、#键时，模块 URC 上报当前话机事件； 步骤三：执行 AT+QAUDCFG='slic_IndRep',0 禁用话机事件上报功能。 产品测试功能，设置来电显示的模式，对应 AT+QAUDCFG='slic_cid_cfg' 中的。 - 0：DTMF 模式，显示来电号码 - 1：FSK SDMF 模式，显示来电号码并校准时间 - 2：FSK MDMF 模式，显示来电号码、校准时间并显示来电人名称 - 3：开启语音信箱，校准时间并显示信箱信息 - 4：关闭语音信箱，校准时间并隐藏信箱信息 上海移远通信技术股份有限公司 11 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 步骤一：执行 AT+QAUDCFG='slic_cid_cfg',设置 SLIC 来电显示模 式； 步骤二：执行 AT+QAUDCFG='slic_cid',设置来电显示，使来电显示 模式的设置生效。 产线测试来电显示 产线测试配置摘挂机及 闪断键检测时间 语音信箱 备注： 1. 校准时间功能需连接网络； 2. 如需使用相关来电显示模式，需话机支持相关功能； 3. 产品测试结束后，需先将来电显示模式配置为 4（AT+QAUDCFG='slic_ cid_cfg',4）并执行一次来电显示配置命令（AT+QAUDCFG='slic_cid', ），使设置生效，再将来电显示模式配置为 0、1、2 中所需的一种 （默认为模式 2），恢复产品来电显示功能； 4. 产 品 测 试 来 电 显 示 功 能 时 ， 来 电 显 示 模 式 2 的 来 电 人 名 称 预 置 为 QUECTEL。 产品测试功能，无需来电即可测试设备来电显示功能是否正常。 步骤一：执行模拟话机来电显示 AT+QAUDCFG='slic_cid',； 步骤二： 设备振铃并以当前来电显示模式显示来电信息。 产品测试功能，用于调节 Flash 键和挂机的灵敏度。按下 Flash 键后，SLIC 会 通过按下的时间判断当前操作是 Flash 键还是挂机行为。 通过 AT+QAUDCFG='slic_hook_time'[,,,,,,,,]可 配置检测时间，单位为毫秒。当按下时间在和之间时， 则判断为 Flash 键；当按下时间大于时，则判断为挂机。 步骤一：A 设置无应答呼叫转移号码为语音信箱号码； 步骤二：B 给 A 打电话，A 无应答后，服务器会向 B 播放留言提示音，B 听到 留言提示后可以开始留言； 步骤三：B 留言完毕后，服务器给 A 发短信提示语音信箱有留言，A 会通 过 URC 上报语音信箱相关信息； 步骤四：A 语音信箱有留言时，摘机后会听到语音信箱类型的拨号音提示。若 话机支持，屏幕也会显示信箱信息； 步骤五：A 拨打语音信箱号码，可收听语音信箱留言。 呼叫补充服务 备注： 该功能需运营商支持。 话机摘机状态，按下话机上的相关按键（服务码），会执行对应呼叫补充服务。 1. *31#[number]：未指定电话号码时，设置所有通话均显示主叫号码；指定 电话号码时，呼出该电话且当前通话显示主叫号码。 2. #31#[number]：未指定电话号码时，设置所有通话均不显示主叫号码；指 定电话号码时，呼出电话且当前通话不显示主叫号码。 3. *43#：开启呼叫等待。 4. #43#：关闭呼叫等待。 5. *21*[number]#：设置无条件呼叫转移。 6. #21#：关闭无条件呼叫转移。 7. *61*[number]#：设置无应答呼叫转移。 上海移远通信技术股份有限公司 12 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 快速拨号 8. #61#：关闭无应答呼叫转移。 9. *67*[number]#：设置遇忙呼叫转移。 10. #67#：关闭遇忙呼叫转移。 11. #002#：取消所有呼叫转移。 备注： 1. 该功能需运营商支持。 2. 选项 1 和 2 中指定电话号码时，手动按动按键后，等待 5 秒即表示呼出对 应号码；未指定电话号码时，手动按动按键后，等待 5 秒即表示执行相应 设，设置成功则响提示音一次，设置失败则响提示音三次。 3. 以上选项 3~11，手动按动按键后会立即执行对应配置，设置成功则响提示 音一次，设置失败则响提示音三次。 4. 呼叫补充服务响应时间视网络环境而定，网络环境良好时，立即响应，网 络环境很差时，最长 20 秒超时响应。拨出服务码后，有响应后方可进行其 它操作。 话机处于挂机状态时，摘机听到拨号音后，按下 DTMF 键，拨号音停止。然后 按下期望拨出的号码，最后按下#，即可拨出电话。 备注 1. 通过免提的方式拨打电话时，待对端挂断电话后，需要再次按下免提键将话机恢复为挂机状态。 2. 设置相关来电显示模式需要话机支持相应的功能，若要在 FSK MDMF 模式下显示来电人名称，需预 先设置来电人名称。 3. 最多可支持七方通话（含模块一方）的电话会议。若运营商支持的通话方数量少于七方，则以运营商 支持的最大通话数量为准。 4. 相关 AT 命令详情，详见第 4 章。 上海移远通信技术股份有限公司 13 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 4 AT 命令详解 4.1. AT 命令说明 4.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 4.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 3：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 14 / 23 4.2. AT 示例声明 EM12&EG12&EG18 系列 SLIC 应用指导 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 4.3. AT+QSLIC 启用/禁用 SLIC 该命令用于启用或禁用 SLIC。 AT+QSLIC 启用/禁用 SLIC 测试命令 AT+QSLIC=? 查询命令 AT+QSLIC? 设置命令 AT+QSLIC=, 最大响应时间 特性说明 响应 +QSLIC: (支持的列表),(支持的范围) OK 响应 +QSLIC: [,] OK 响应 OK 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用 SLIC。 0 禁用 1 启用 整型。设置 SLIC 类型。 0 预留 1 LE9641（暂不支持） 2 SI32185 3 LE9643 上海移远通信技术股份有限公司 15 / 23 举例 AT+QSLIC=? +QSLIC: (0,1),(0-3) OK AT+QSLIC=0,3 OK AT+QSLIC=1,3 OK AT+QSLIC? +QSLIC: 1,3 OK EM12&EG12&EG18 系列 SLIC 应用指导 //测试命令。 //禁用 SLIC。 //启用 SLIC 并设置 SLIC 平台类型为 LE9643。 //查询当前配置。 4.4. AT+QAUDCFG='slic/AudLoop' 启用/禁用模拟话机的拨号音 该命令用于启用或禁用模拟话机的拨号音。 AT+QAUDCFG='slic/AudLoop' 启用/禁用模拟话机的拨号音 设置命令 AT+QAUDCFG='slic/AudLoop'[,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic/AudLoop', OK 最大响应时间 特性说明 若指定可选参数，则启用/禁用模拟话机的拨号音： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用模拟话机的拨号音。 0 启用 1 禁用 上海移远通信技术股份有限公司 16 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 备注 1. 拨号音是指模拟话机摘机后、拨号前的提示音，用于提示用户可以进行拨号。 2. 回环音用于测试音频播放和录音功能是否正常。 举例 AT+QAUDCFG='slic/AudLoop',1 OK AT+QAUDCFG='slic/AudLoop' +QAUDCFG: 'slic/AudLoop',1 OK //禁用模拟话机的拨号音 //查询当前配置 4.5. AT+QAUDCFG='slic/LF_Ring' 启用/禁用模拟话机振铃 该命令用于启用或禁用模拟话机振铃。 AT+QAUDCFG='slic/LF_Ring' 启用/禁用模拟话机振铃 设置命令 AT+QAUDCFG='slic/LF_Ring'[,] 响应 若省略可选参数，则查询当前配置： AT+QAUDCFG='slic/LF_Ring', OK 最大响应时间 特性说明 若指定可选参数，则启用/禁用模拟话机振铃： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用/禁用模拟话机振铃。 0 关闭 1 开启 上海移远通信技术股份有限公司 17 / 23 举例 AT+QAUDCFG='slic/LF_Ring',1 OK AT+QAUDCFG='slic/LF_Ring' +QAUDCFG: 'slic/LF_Ring',1 OK EM12&EG12&EG18 系列 SLIC 应用指导 //开启振铃 //查询当前配置 4.6. AT+QAUDCFG='slic_IndRep' 启用/禁用模拟话机的事件上报功能 该命令用于启用或禁用模拟话机的事件上报。 AT+QAUDCFG='slic_IndRep' 开启/关闭模拟话机的事件上报功能 设置命令 AT+QAUDCFG='slic_IndRep'[,] 响应 若省略可选参数，则查询当前配置： AT+QAUDCFG='slic_IndRep', OK 最大响应时间 特性说明 若指定可选参数，则配置 SLIC 模拟话机的事件上报功能： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。开启或关闭 SLIC 模拟话机的事件上报功能。 0 关闭 1 开启 举例 AT+QAUDCFG='slic_IndRep',1 OK AT+QAUDCFG='slic_IndRep' +QAUDCFG: 'slic_IndRep',1 //开启模拟话机的事件上报 //查询当前配置 上海移远通信技术股份有限公司 18 / 23 OK +QIND: 'SLIC Hook off' +QIND: 'SLIC DTMF',1 +QIND: 'SLIC Hook on' EM12&EG12&EG18 系列 SLIC 应用指导 //拿起话柄，收到摘机的 URC 上报。 //按下数字键 1，收到 DTMF 1 的 URC 上报。 //挂起话柄，收到挂机的 URC 上报。 4.7. AT+QAUDCFG='slic_cid_cfg' 设置 SLIC 来电显示模式 该命令用于设置 SLIC 来电显示模式。 AT+QAUDCFG='slic_cid_cfg' 设置 SLIC 来电显示模式 设置命令 AT+QAUDCFG='slic_cid_cfg'[,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic_cid_cfg', OK 最大响应时间 特性说明 若指定可选参数，则配置模拟话机的来电显示方式： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。SLIC 来电显示模式。 0 DTMF 模式 1 FSK SDMF 模式 2 FSK MDMF 模式 3 开启语音信箱 4 关闭语音信箱 备注 此命令设置完成后，需与 AT+QAUDCFG='slic_cid'配合使用。 ⚫ 为 0~2 时，使用 AT+QAUDCFG='slic_cid'将使模拟话机显示来电号码以及产生振铃； 上海移远通信技术股份有限公司 19 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 ⚫ 为 3 时，使用 AT+QAUDCFG='slic_cid'将使模拟话机显示：'信箱'（若话机支持显示语音 信箱功能）； ⚫ 为 4 时，使用 AT+QAUDCFG='slic_cid'将去除模拟话机显示的'信箱'字符（若话机支持 显示语音显示功能）。 举例 AT+QAUDCFG='slic_cid_cfg',2 OK AT+QAUDCFG='slic_cid_cfg' +QAUDCFG: 'slic_cid_cfg',2 OK //配置模拟话机的来电显示方式为 FSK MDMF //查询当前配置 4.8. AT+QAUDCFG='slic_cid' 配置模拟话机的来电显示 该命令用于配置模拟话机的来电显示。 AT+QAUDCFG='slic_cid' 配置模拟话机的来电显示 设置命令 响应 AT+QAUDCFG='slic_cid', OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型。来电显示号码。最大长度：15；单位：字节。 备注 1. 在测试过程中以及在来电显示之前，SLIC 将强制响铃一次。 2. 该命令仅在 SLIC 模拟话机工作时生效。 举例 AT+QAUDCFG='slic_cid','0123456789' OK 上海移远通信技术股份有限公司 20 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 4.9. AT+QAUDCFG='slic_hook_time' 配置模拟话机的摘挂机及闪断键检 测时间 该命令用于配置模拟话机的摘挂机及闪断键检测时间。 AT+QAUDCFG='slic_hook_time' 配置模拟话机的摘挂机及闪断键检测时间 设置命令 AT+QAUDCFG='slic_hook_time'[,,,,,,, ,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic_hook_time',,, ,,,,, OK 最大响应时间 特性说明 若指定可选参数，则配置模拟话机的摘挂机及闪断键检测时 间： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。最小脉冲中断时间。范围：0~2000；单位：毫秒。 整型。最大脉冲中断时间。范围：0~2000；单位：毫秒。 整型。最小脉冲接通时间。范围：0~2000；单位：毫秒。 整型。最大脉冲接通时间。范围：0~2000；单位：毫秒。 整型。最小脉冲间隔时间。范围：0~2000；单位：毫秒。 整型。最小闪断时间。范围：0~2000；单位：毫秒。 整型。最大闪断时间。范围：0~2000；单位：毫秒。 整型。最小话柄检测时间，该值应大于最大闪断时间。范围：0~2000；单位：毫秒。 备注 1. 执行此命令查询模拟话机的摘挂机及闪断键检测时间时，不同 SLIC 默认值可能不同。 2. 建议设置时时间限制符合下列关系： ⚫ < < < < ⚫ < < 上海移远通信技术股份有限公司 21 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 举例 AT+QAUDCFG='slic_hook_time',20,80,20,80,90,100,630,680 OK AT+QAUDCFG='slic_hook_time' +QAUDCFG: 'slic_hook_time',20,80,20,80,90,100,630,680 //设置摘挂机及闪断键检测时间 //查询当前配置 OK 上海移远通信技术股份有限公司 22 / 23 EM12&EG12&EG18 系列 SLIC 应用指导 5 附录 参考文档及术语缩写 表 4：术语缩写 术语 AP CS DTMF FSK MDMF PCM QMI SDMF SLIC SMD SPI TA URC VoLTE 英文全称 Access Point Circuit Switched Dual-Tone Multifrequency Frequency-shift Keying Multiple Data Message Format Pulse Code Modulation Qualcomm Message Interface Single Date Message Format Subscriber Line Interface Circuit Shared Memory Driver Serial Peripheral Interface Terminal Adapter Unsolicited Result Code Voice over Long-Term Evolution 中文全称 访问接入点 电路交换 双音多频 频移键控 复合数据消息格式 脉冲编码调制 高通信息接口 单数据消息格式 用户线路接口电路 共享内存驱动 串行外设接口 终端适配器 非请求结果码 长期演进语音承载 上海移远通信技术股份有限公司 23 / 23

EG512R-EA SLIC 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-07-12 状态：受控文件 EG512R-EA SLIC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 14 EG512R-EA SLIC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 14 文档历史 修订记录 版本 日期 作者 变更表述 - 2022-05-23 Shaun DUAN 文档创建 1.0 2022-07-12 Shaun DUAN 受控版本 EG512R-EA SLIC 应用指导 上海移远通信技术股份有限公司 3 / 14 EG512R-EA SLIC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................ 7 2.3. AT+QSLIC 启用/禁用 SLIC...................................................................................................... 8 3 设计方案 .............................................................................................................................................. 10 3.1. 设计框图 ................................................................................................................................... 10 3.1.1. Modem 侧.......................................................................................................................11 3.1.2. AP 侧 ..............................................................................................................................11 3.2. SLIC 主要功能 ...........................................................................................................................11 3.2.1. 语音数据传输和控制.......................................................................................................11 3.2.2. 话机控制 .........................................................................................................................11 3.2.3. 呼叫状态控制..................................................................................................................11 4 SLIC 功能列表..................................................................................................................................... 12 5 附录 参考文档及术语缩写 .................................................................................................................. 14 上海移远通信技术股份有限公司 4 / 14 EG512R-EA SLIC 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：SLIC 功能列表 .................................................................................................................................. 12 表 3：术语缩写 ........................................................................................................................................... 14 上海移远通信技术股份有限公司 5 / 14 EG512R-EA SLIC 应用指导 1 引言 本文档介绍如何使用移远通信 EG512R-EA 模块的 SLIC 功能，包括相关 AT 命令、设计方案和功能介 绍。 上海移远通信技术股份有限公司 6 / 14 EG512R-EA SLIC 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 7 / 14 EG512R-EA SLIC 应用指导 2.3. AT+QSLIC 启用/禁用 SLIC 该命令用于启用/禁用 SLIC。 AT+QSLIC 启用/禁用 SLIC 测试命令 AT+QSLIC=? 响应 +QSLIC: (支持的列表),(支持的范围) 查询命令 AT+QSLIC? OK 响应 +QSLIC: [,] 设置命令 AT+QSLIC=, OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用 SLIC。 0 禁用 1 启用 整型。设置 SLIC 类型。 0 预留 1 LE9641（暂不支持） 2 SI32185 3 LE9643 举例 AT+QSLIC=? +QSLIC: (0,1),(0-3) OK AT+QSLIC=0,3 OK AT+QSLIC=1,3 OK //测试命令。 //禁用 SLIC。 //启用 SLIC 并设置 SLIC 平台类型为 LE9643。 上海移远通信技术股份有限公司 8 / 14 AT+QSLIC? +QSLIC: 1,3 OK //查询当前配置。 EG512R-EA SLIC 应用指导 上海移远通信技术股份有限公司 9 / 14 EG512R-EA SLIC 应用指导 3 设计方案 3.1. 设计框图 EG512R-EA 模块的 SLIC 功能软件框架设计如下图所示： VoLTE Service & CS Voice Service Audio Voice Core Services QMI SLIC App Voice Server PCM Call Manager DSCI AT AT^DSCI ATA/ ATD/ CHLD/ VTS/... Control Driver PCM SPI SLIC RJ11 图 1：SLIC 功能设计框图 备注 本章节相关 AT 命令详情，请参考模块的 AT 命令手册。 Control Path Data Path 上海移远通信技术股份有限公司 10 / 14 EG512R-EA SLIC 应用指导 3.1.1. Modem 侧 模块在 Modem 侧提供了一系列用于实现呼叫功能的 AT 命令，包括发起呼叫（ATD）、接听（ATA）、 挂断（ATH）、呼叫状态上报（AT^DSCI）、多方通话管理（AT+CHLD）、DTMF（AT+VTS）等。这些命令 直接控制 Modem 侧的呼叫相关业务。 3.1.2. AP 侧 移远通信基于上述 AT 命令在模块的 AP 侧开发了 SLIC 应用程序和 Voice Server 应用程序。 SLIC 应用程序支持以下功能：通过电话状态机和 AT 命令进行 Modem 侧的呼叫状态控制、通过 SPI 与 SLIC 设备进行交互、获取话机的操作和控制话机的线路状态。 Voice Server 应用程序支持以下功能：控制语音链路的开关和语音数据传输，控制 PCM 时钟的开关， 提供本地铃声方案，输出不同国家或地区的标准的忙音、呼叫等待音和结束音等。 3.2. SLIC 主要功能 SLIC 主要支持三部分功能：语音数据传输和控制、话机控制和呼叫状态控制。 3.2.1. 语音数据传输和控制 基于 VoLTE 协议栈和音频管理组件，模块能够实现基于语音链路和 SLIC 设备的通话功能。 模块能将下行链路的语音数据通过声卡传输到 SLIC 芯片，SLIC 芯片将语音数据解码为模拟信号，通 过 RJ11 将信号传输给话机，话机通过扬声器播放声音。同时，话机的麦克风采集到的语音模拟信号会传输 到 SLIC 芯片，SLIC 芯片将模拟信号编码为数字信号，即语音数据，然后通过声卡传输到上行语音链路中。 3.2.2. 话机控制 话机支持的操作有：DTMF 按键、摘机（Off-Hook）、挂机（On-Hook）、闪断键（Flash Button）。当 话机进行以上操作时，SLIC 芯片通过 RJ11 获取话机信号，并分析话机的动作，写入 SLIC 芯片的寄存器 中，模块通过 SPI 驱动读取 SLIC 芯片的相关寄存器，从而获得话机的操作；同时，模块也可以通过 SPI 驱动配置 SLIC 寄存器，让 SLIC 芯片产生信号给话机，让话机实现振铃、来电显示等功能。 3.2.3. 呼叫状态控制 基于 VoLTE 协议栈，执行 AT^DSCI=1 后，Modem 侧能够将呼叫状态主动上报到 SMD 通道，AP 侧 的 SLIC 应用程序通过 SMD 通道获取呼叫状态。同时，AP 侧的 SLIC 应用程序可以通过 SMD 通道向 Modem 侧发送 AT 命令，实现接听（ATA）、挂断（ATH）、多方通话管理（AT+CHLD）等功能。 上海移远通信技术股份有限公司 11 / 14 EG512R-EA SLIC 应用指导 4 SLIC 功能列表 本章节介绍模块的详细 SLIC 功能。 表 2：SLIC 功能列表 功能 电源管理 摘机（Off-Hook） 挂机（On-Hook） 拨号 来电显示 振铃 来电接听 发起呼叫 带外 DTMF 切换通话（呼叫保持） 三方通话（电话会议） 功能详解 1. 启用 SLIC 后，话机上电，话机屏幕点亮。 2. 禁用 SLIC 后，话机掉电，话机屏幕关闭。 话机挂机状态下，无来电，话机摘机后播放拨号音。 1. 通话中挂机，挂机可以挂断当前通话。 2. 拨号中挂机，挂机可以终止拨号，并清空已拨号码。 挂机状态下，摘机听到拨号音后，按下 DTMF 键，拨号音停止。且依次按 下期望拨出的号码，当最后一个按键按下后，等待 5 秒，拨出电话。 话机挂机状态下，有来电时，话机屏幕上显示来电号码。 话机挂机状态下，有来电时，话机振铃，提醒来电。 话机挂机状态下，有来电时，话机摘机后即可接听。 1. 拨号完毕后，话机实现语音通话。 2. 来电接听后，话机实现语音通话。 通话状态下，话机按下'0'~'9'、'#'、'*' 等按键后，可以发送对应 的信令。 话机与一方（例如 A）通话时，按下 Flash 按键，约 4 秒后，A 将保持呼 叫等待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B），话机可以 与 B 通话，再次按下 Flash 按键后，能够保持与 B 的通话，切换到与 A 的 通话，重复按下 Flash 按键后，能够切换 A 与 B 之间的通话。 1. 话机与一方（例如 A）通话时，按下 Flash 按键，约 4 秒后，A 将保 持呼叫等待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B）， 话机可以与 B 通话，按下 Flash 键后约 500 毫秒~2 秒内，按下按键 '3'，合并通话，此时将实现与 A 和 B 的三方通话。 2. 如需继续增加通话，请继续以下步骤： 1) 再次按下 Flash 按键，保持与 A 和 B 的合并通话，话机再次响起 拨号音。 2) 再次拨号呼叫另一方（例如 C），话机可以与 C 通话，按下 Flash 按键后，能够保持与 C 的通话，切换到与 A 和 B 的合并通话。重 上海移远通信技术股份有限公司 12 / 14 拨号音 忙音 等待音 结束音 EG512R-EA SLIC 应用指导 复按下 Flash 键，能够切换 A 和 B 的合并通话与 C 的通话。 3) 按下 Flash 按键后约 500 毫秒~2 秒内，按下按键'3'，能够合并 通话。此时将实现与 A、B 和 C 的四方通话。 3. 如果需要继续增加通话，重复以上步骤 1) ~ 3) 即可，最多可支持七 方通话（含模块一方）的电话会议。 挂机状态下，无来电，摘机后话机播放拨号音。 模块发起呼叫，对方拒接，话机播放忙音（或运营商的铃音）。 模块正在通话中，第三方呼叫模块，话机播放等待音（或运营商的铃音）。 模块正在通话中，对方挂断电话，话机播放结束音。 上海移远通信技术股份有限公司 13 / 14 EG512R-EA SLIC 应用指导 5 附录 参考文档及术语缩写 表 3：术语缩写 术语 AP CS DTMF PCM QMI SLIC SMD SPI TA VoLTE 英文全称 Access Point Circuit Switched Dual-Tone Multifrequency Pulse Code Modulation Qualcomm Message Interface Subscriber Line Interface Circuit Shared Memory Driver Serial Peripheral Interface Terminal Adapter Voice over Long-Term Evolution 中文全称 访问接入点 电路交换 双音多频 脉冲编码调制 高通信息接口 用户线路接口电路 共享内存驱动 串行外设接口 终端适配器 长期演进语音承载 上海移远通信技术股份有限公司 14 / 14

EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 LTE-A 模块系列 版本：1.1 日期：2023-12-21 状态：受控文件 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2022-05-23 Shaun DUAN 文档创建 1.0 2022-07-12 Shaun DUAN 受控版本 1. 更新文档章节结构。 2. 新增适用模块：EG065K 系列、EM120K-GL、EM060K 系列。 3. 新增关于 Data + Voice 功能支持要求的备注（第 1 章）。 4. 新增 SLIC 扩展功能列表（第 3 章）。 5. 新增 SLIC 相关 AT 命令（第 4 章）： 1.1 2023-12-21 Jone WANG ⚫ AT+QAUDCFG='slic/AudLoop' ⚫ AT+QAUDCFG='slic/LF_Ring' ⚫ AT+QAUDCFG='slic_IndRep' ⚫ AT+QAUDCFG='slic_cid_cfg' ⚫ AT+QAUDCFG='slic_cid' ⚫ AT+QAUDCFG='slic_hook_time' 6. 更新 AT+QSLIC 的参数信息（第 4.3 章）。 上海移远通信技术股份有限公司 3 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 设计方案 ................................................................................................................................................ 7 2.1. 设计框图 ..................................................................................................................................... 7 2.1.1. Modem 侧........................................................................................................................ 8 2.1.2. AP 侧 ............................................................................................................................... 8 2.2. SLIC 主要功能 ............................................................................................................................ 8 2.2.1. 语音数据传输和控制........................................................................................................ 8 2.2.2. 话机控制 .......................................................................................................................... 8 2.2.3. 呼叫状态控制................................................................................................................... 8 3 SLIC 功能列表....................................................................................................................................... 9 4 AT 命令详解 ........................................................................................................................................ 13 4.1. AT 命令说明.............................................................................................................................. 13 4.1.1. 定义 ............................................................................................................................... 13 4.1.2. AT 命令语句 .................................................................................................................. 13 4.2. AT 示例声明.............................................................................................................................. 13 4.3. AT+QSLIC 启用/禁用 SLIC.................................................................................................... 14 4.4. AT+QAUDCFG='slic/AudLoop' 启用/禁用模拟话机的拨号音 .............................................. 15 4.5. AT+QAUDCFG='slic/LF_Ring' 启用/禁用模拟话机振铃....................................................... 16 4.6. AT+QAUDCFG='slic_IndRep' 启用/禁用模拟话机的事件上报功能 ..................................... 17 4.7. AT+QAUDCFG='slic_cid_cfg' 设置 SLIC 来电显示模式 ...................................................... 18 4.8. AT+QAUDCFG='slic_cid' 配置模拟话机的来电显示 ............................................................ 19 4.9. AT+QAUDCFG='slic_hook_time' 配置模拟话机的摘挂机及闪断键检测时间 ...................... 20 5 附录 参考文档及术语缩写 .................................................................................................................. 22 上海移远通信技术股份有限公司 4 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：SLIC 基本功能列表............................................................................................................................. 9 表 3：SLIC 扩展功能列表........................................................................................................................... 10 表 4：AT 命令类型...................................................................................................................................... 13 表 5：术语缩写 ........................................................................................................................................... 22 上海移远通信技术股份有限公司 5 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 1 引言 本文档介绍如何使用移远通信 EG06xK、Ex120K 和 EM060K 系列模块的 SLIC 功能，包括设计方案、 功能介绍和相关 AT 命令。 1.1. 适用模块 表 1：适用模块 模块系列 EG06xK Ex120K - 模块 EG060K 系列 EG065K 系列 EM120K-GL EG120K 系列 EM060K 系列 备注 本文档仅适用于支持 Data + Voice 的模块。模块是否支持 Data + Voice，请参见对应模块的产品规格书。 上海移远通信技术股份有限公司 6 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 2 设计方案 2.1. 设计框图 模块的 SLIC 功能软件框架设计如下图所示： VoLTE Service & CS Voice Service Audio Voice Core Services QMI SLIC App Voice Server PCM Call Manager DSCI AT AT^DSCI ATA/ ATD/ CHLD/ VTS/... Control Driver PCM SPI SLIC RJ11 图 1：SLIC 功能设计框图 备注 本章节相关 AT 命令详情，请参考模块的 AT 命令手册。 Control Path Data Path 上海移远通信技术股份有限公司 7 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 2.1.1. Modem 侧 模块在 Modem 侧提供了一系列用于实现呼叫功能的 AT 命令，包括发起呼叫（ATD）、接听（ATA）、 挂断（ATH）、呼叫状态上报（AT^DSCI）、多方通话管理（AT+CHLD）、DTMF（AT+VTS）等。这些命令 直接控制 Modem 侧的呼叫相关业务。 2.1.2. AP 侧 移远通信基于上述 AT 命令在模块的 AP 侧开发了 SLIC 应用程序和 Voice Server 应用程序。 SLIC 应用程序支持以下功能：通过电话状态机和 AT 命令进行 Modem 侧的呼叫状态控制、通过 SPI 与 SLIC 设备进行交互、获取话机的操作和控制话机的线路状态。 Voice Server 应用程序支持以下功能：控制语音链路的开关和语音数据传输，控制 PCM 时钟的开关， 提供本地铃声方案，输出不同国家或地区的标准的忙音、呼叫等待音和结束音等。 2.2. SLIC 主要功能 SLIC 主要支持三部分功能：语音数据传输和控制、话机控制和呼叫状态控制。 2.2.1. 语音数据传输和控制 基于 VoLTE 协议栈和音频管理组件，模块能够实现基于语音链路和 SLIC 设备的通话功能。 模块能将下行链路的语音数据通过声卡传输到 SLIC 芯片，SLIC 芯片将语音数据解码为模拟信号，通 过 RJ11（电话线）将信号传输给话机，话机通过扬声器播放声音。同时，话机的麦克风采集到的语音模拟 信号会传输到 SLIC 芯片，SLIC 芯片将模拟信号编码为数字信号，即语音数据，然后通过声卡传输到上行 语音链路中。 2.2.2. 话机控制 话机支持的操作有：DTMF 按键、摘机（Off-Hook）、挂机（On-Hook）、闪断键（Flash Button）。当 话机进行以上操作时，SLIC 芯片通过 RJ11 获取话机信号，并分析话机的动作，写入 SLIC 芯片的寄存器 中，模块通过 SPI 驱动读取 SLIC 芯片的相关寄存器，从而获得话机的操作；同时，模块也可以通过 SPI 驱动配置 SLIC 寄存器，让 SLIC 芯片产生信号给话机，让话机实现振铃、来电显示等功能。 2.2.3. 呼叫状态控制 基于 VoLTE 协议栈，执行 AT^DSCI=1 后，Modem 侧能够将呼叫状态主动上报到 SMD 通道，AP 侧 的 SLIC 应用程序通过 SMD 通道获取呼叫状态。同时，AP 侧的 SLIC 应用程序可以通过 SMD 通道向 Modem 侧发送 AT 命令，实现接听（ATA）、挂断（ATH）、多方通话管理（AT+CHLD）等功能。 上海移远通信技术股份有限公司 8 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 3 SLIC 功能列表 本章节介绍模块的详细 SLIC 功能。其主要为两个部分： 1) 基本功能：介绍 SLIC 基础业务相关的功能。 2) 扩展功能：对 SLIC 基础业务的扩充，增加了 SLIC 的产线辅助验证功能、参数配置功能和语音业 务功能。 表 2：SLIC 基本功能列表 基本功能 电源管理 摘机（Off-Hook） 挂机（On-Hook） 拨号 来电显示 振铃 来电接听 发起呼叫 带外 DTMF 切换通话（呼叫保持） 三方通话（电话会议） 功能详解 1. 启用 SLIC 后，话机上电，话机屏幕点亮。 2. 禁用 SLIC 后，话机掉电，话机屏幕关闭。 话机挂机状态下，无来电，话机摘机后播放拨号音。 1. 通话中挂机，挂机可以挂断当前通话。 2. 拨号中挂机，挂机可以终止拨号，并清空已拨号码。 挂机状态下，摘机听到拨号音后，按下 DTMF 键，拨号音停止。且依次按下期 望拨出的号码，当最后一个按键按下后，等待 5 秒，拨出电话。 话机挂机状态下，有来电时，话机屏幕上显示来电号码。 话机挂机状态下，有来电时，话机振铃，提醒来电。 话机挂机状态下，有来电时，话机摘机后即可接听。 拨号完毕后，话机实现语音通话。 通话状态下，话机按下'0'~'9'、'#'、'*' 等按键后，可以发送对应的信 令。 话机与一方（例如 A）通话时，按下 Flash 按键，约 4 秒后，A 将保持呼叫等 待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B），话机可以与 B 通话， 再次按下 Flash 按键后，能够保持与 B 的通话，切换到与 A 的通话，重复按下 Flash 按键后，能够切换 A 与 B 之间的通话。 1. 话机与一方（例如 A）通话时，按下 Flash 按键，约 4 秒后，A 将保持呼 叫等待状态，话机再次响起拨号音。拨号呼叫另一方（例如 B），话机可以 与 B 通话，按下 Flash 键后约 500 毫秒~2 秒内，按下按键'3'，合并通 话，此时将实现与 A 和 B 的三方通话。 2. 如需继续增加通话，请继续以下步骤： 1) 再次按下 Flash 按键，保持与 A 和 B 的合并通话，话机再次响起拨号 音。 上海移远通信技术股份有限公司 9 / 22 拨号音 忙音 等待音 结束音 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 2) 再次拨号呼叫另一方（例如 C），话机可以与 C 通话，按下 Flash 按键 后，能够保持与 C 的通话，切换到与 A 和 B 的合并通话。重复按下 Flash 键，能够切换 A 和 B 的合并通话与 C 的通话。 3) 按下 Flash 按键后约 500 毫秒~2 秒内，按下按键'3'，能够合并通话。 此时将实现与 A、B 和 C 的四方通话。 3. 如果需要继续增加通话，重复以上步骤 1) ~ 3) 即可，最多可支持七方通 话（含模块一方）的电话会议。 挂机状态下，无来电，摘机后话机播放拨号音。 模块发起呼叫，对方拒接，话机播放忙音（或运营商的铃音）。 模块正在通话中，第三方呼叫模块，话机播放等待音（或运营商的铃音）。 模块正在通话中，对方挂断电话，话机播放结束音。 表 3：SLIC 扩展功能列表 扩展功能 产线测试音频回环 功能详解 产品测试功能，无需拨打电话即可测试设备录音、播音功能是否正常。 步骤一：执行 AT+QAUDCFG='slic/AudLoop',1 关闭拨号音； 步骤二：执行 AT+QSIDET=65535 调大侧音增益； 步骤三： 对话柄麦克风说话，声音从听筒传出则表明设备的录/播音功能正常； 步骤四：执行 AT+QAUDCFG='slic/AudLoop',0 开启拨号音。 产线测试振铃 产线测试事件上报 产线测试配置来电显示 模式 备注： 执行步骤一至步骤三完成测试后，需按照步骤四开启拨号音。 产品测试功能，无需来电即可测试设备振铃功能是否正常。 步骤一：执行 AT+QAUDCFG='slic/LF_Ring',1 启用模拟电话振铃； 步骤二：执行 AT+QAUDCFG='slic/LF_Ring',0 禁用模拟电话振铃。 产品测试功能，测试话机事件检测功能是否正常。 步骤一：执行 AT+QAUDCFG='slic_IndRep',1 启用话机事件上报功能； 步骤二：对话机进行摘机、挂机、按 Flash 键、按 0~9、*、#键时，模块 URC 上报当前话机事件； 步骤三：执行 AT+QAUDCFG='slic_IndRep',0 禁用话机事件上报功能。 产品测试功能，设置来电显示的模式，对应 AT+QAUDCFG='slic_cid_cfg' 中的。 - 0：DTMF 模式，显示来电号码； - 1：FSK SDMF 模式，显示来电号码并校准时间； - 2：FSK MDMF 模式，显示来电号码、校准时间并显示来电人名称； - 3：开启语音信箱，校准时间并显示信箱信息； - 4：关闭语音信箱，校准时间并隐藏信箱信息。 上海移远通信技术股份有限公司 10 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 步骤一：执行 AT+QAUDCFG='slic_cid_cfg',设置 SLIC 来电显示模 式； 步骤二：执行 AT+QAUDCFG='slic_cid',设置来电显示，使来电显示 模式的设置生效。 产线测试来电显示 产线测试配置摘挂机及 闪断键检测时间 语音信箱 备注： 1. 校准时间功能需连接网络； 2. 如需使用相关来电显示模式，需话机支持相关功能； 3. 产品测试结束后，需先将来电显示模式配置为 4（AT+QAUDCFG='slic_ cid_cfg',4）并执行一次来电显示配置命令（AT+QAUDCFG='slic_cid', ），使设置生效，再将来电显示模式配置为 0、1、2 中所需的一种 （默认为模式 2），恢复产品来电显示功能； 4. 产 品 测 试 来 电 显 示 功 能 时 ， 来 电 显 示 模 式 2 的 来 电 人 名 称 预 置 为 QUECTEL。 产品测试功能，无需来电即可测试设备来电显示功能是否正常。 步骤一：执行模拟话机来电显示 AT+QAUDCFG='slic_cid',； 步骤二： 设备振铃并以当前来电显示模式显示来电信息。 产品测试功能，用于调节 Flash 键和挂机的灵敏度。按下 Flash 键后，SLIC 会 通过按下的时间判断当前操作是 Flash 键还是挂机行为。 通过 AT+QAUDCFG='slic_hook_time'[,,,,,,,,]可 配置检测时间，单位为毫秒。当按下时间在和之间时， 则判断为 Flash 键，当按下时间大于时，则判断为挂机。 步骤一：A 设置无应答呼叫转移号码为语音信箱号码； 步骤二：B 给 A 打电话，A 无应答后，服务器会向 B 播放留言提示音，B 听到 留言提示后可以开始留言； 步骤三：B 留言完毕后，服务器给 A 发短信提示语音信箱有留言，A 会通 过 URC 上报语音信箱相关信息； 步骤四：A 语音信箱有留言时，摘机后会听到语音信箱类型的拨号音提示。若 话机支持，屏幕也会显示信箱信息； 步骤五：A 拨打语音信箱号码，可收听语音信箱留言。 呼叫补充服务 备注： 该功能需运营商支持。 话机摘机状态，按下话机上的相关按键（服务码），会执行对应呼叫补充服务。 1. *31#[number]：未指定电话号码时，设置所有通话均显示主叫号码；指定 电话号码时，呼出该电话且当前通话显示主叫号码。 2. #31#[number]：未指定电话号码时，设置所有通话均不显示主叫号码；指 定电话号码时，呼出电话且当前通话不显示主叫号码。 3. *43#：开启呼叫等待。 4. #43#：关闭呼叫等待。 5. *21*[number]#：设置无条件呼叫转移。 6. #21#：关闭无条件呼叫转移。 7. *61*[number]#：设置无应答呼叫转移。 上海移远通信技术股份有限公司 11 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 快速拨号 8. #61#：关闭无应答呼叫转移。 9. *67*[number]#：设置遇忙呼叫转移。 10. #67#：关闭遇忙呼叫转移。 11. #002#：取消所有呼叫转移。 备注： 1. 该功能需运营商支持。 2. 选项 1 和 2 中指定电话号码时，手动按动按键后，等待 5 秒即表示呼出对 应号码；未指定电话号码时，手动按动按键后，等待 5 秒即表示执行相应 设，设置成功则响提示音一次，设置失败则响提示音三次。 3. 以上选项 3~11，手动按动按键后会立即执行对应配置，设置成功则响提示 音一次，设置失败则响提示音三次。 4. 呼叫补充服务响应时间视网络环境而定，网络环境良好时，立即响应，网 络环境很差时，最长 20 秒超时响应。拨出服务码后，有响应后方可进行其 它操作。 话机处于挂机状态时，摘机听到拨号音后，按下 DTMF 键，拨号音停止。然后 按下期望拨出的号码，最后按下#，即可拨出电话。 备注 1. 通过免提的方式拨打电话时，待对端挂断电话后，需要再次按下免提键将话机恢复为挂机状态。 2. 设置相关来电显示模式需要话机支持相应的功能，若要在 FSK MDMF 模式下显示来电人名称，需预 先设置来电人名称。 3. 最多可支持七方通话（含模块一方）的电话会议。若运营商支持的通话方数量少于七方，则以运营商 支持的最大通话数量为准。 4. 相关 AT 命令详情，详见第 4 章。 上海移远通信技术股份有限公司 12 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 4 AT 命令详解 4.1. AT 命令说明 4.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 4.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 4：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 4.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 13 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 4.3. AT+QSLIC 启用/禁用 SLIC 该命令用于启用或禁用 SLIC。 AT+QSLIC 启用/禁用 SLIC 测试命令 AT+QSLIC=? 响应 +QSLIC: (支持的列表),(支持的范围) 查询命令 AT+QSLIC? OK 响应 +QSLIC: [,] 设置命令 AT+QSLIC=, OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。启用或禁用 SLIC。 0 禁用 1 启用 整型。设置 SLIC 类型。 0 预留 1 LE9641（暂不支持） 2 SI32185 3 LE9643 Inverting Boost 4 LE9643 Buck Boost（暂不支持） 5 SI32178 Buck Boost（暂不支持） 6 DXS101 IB12 举例 AT+QSLIC=? +QSLIC: (0,1),(0-3) OK AT+QSLIC=0,3 //测试命令。 //禁用 SLIC。 上海移远通信技术股份有限公司 14 / 22 OK AT+QSLIC=1,3 OK AT+QSLIC? +QSLIC: 1,3 OK EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 //启用 SLIC 并设置 SLIC 平台类型为 LE9643 Inverting Boost。 //查询当前配置。 4.4. AT+QAUDCFG='slic/AudLoop' 启用/禁用模拟话机的拨号音 该命令用于启用或禁用模拟话机的拨号音。 AT+QAUDCFG='slic/AudLoop' 启用/禁用模拟话机的拨号音 设置命令 AT+QAUDCFG='slic/AudLoop'[,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic/AudLoop', OK 最大响应时间 特性说明 若指定可选参数，则启用/禁用模拟话机的拨号音： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用模拟话机的拨号音。 0 启用 1 禁用 备注 1. 拨号音是指模拟话机摘机后、拨号前的提示音，用于提示用户可以进行拨号。 2. 回环音用于测试音频播放和录音功能是否正常。 举例 上海移远通信技术股份有限公司 15 / 22 AT+QAUDCFG='slic/AudLoop',1 OK AT+QAUDCFG='slic/AudLoop' +QAUDCFG: 'slic/AudLoop',1 OK EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 //禁用模拟话机的拨号音 //查询当前配置 4.5. AT+QAUDCFG='slic/LF_Ring' 启用/禁用模拟话机振铃 该命令用于启用或禁用模拟话机振铃。 AT+QAUDCFG='slic/LF_Ring' 启用/禁用模拟话机振铃 设置命令 AT+QAUDCFG='slic/LF_Ring'[,] 响应 若省略可选参数，则查询当前配置： AT+QAUDCFG='slic/LF_Ring', OK 最大响应时间 特性说明 若指定可选参数，则启用/禁用模拟话机振铃： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用模拟话机振铃。 0 关闭 1 开启 举例 AT+QAUDCFG='slic/LF_Ring',1 OK AT+QAUDCFG='slic/LF_Ring' +QAUDCFG: 'slic/LF_Ring',1 OK //开启振铃 //查询当前配置 上海移远通信技术股份有限公司 16 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 4.6. AT+QAUDCFG='slic_IndRep' 启用/禁用模拟话机的事件上报功能 该命令用于启用或禁用模拟话机的事件上报。 AT+QAUDCFG='slic_IndRep' 开启/关闭模拟话机的事件上报功能 设置命令 AT+QAUDCFG='slic_IndRep'[,] 响应 若省略可选参数，则查询当前配置： AT+QAUDCFG='slic_IndRep', OK 最大响应时间 特性说明 若指定可选参数，则配置模拟话机的事件上报功能： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。开启或关闭模拟话机的事件上报功能。 0 关闭 1 开启 举例 AT+QAUDCFG='slic_IndRep',1 OK AT+QAUDCFG='slic_IndRep' +QAUDCFG: 'slic_IndRep',1 OK +QIND: 'SLIC Hook off' +QIND: 'SLIC DTMF',1 +QIND: 'SLIC Hook on' //开启模拟话机的事件上报 //查询当前配置 //拿起话柄，收到摘机的 URC 上报。 //按下数字键 1，收到 DTMF 1 的 URC 上报。 //挂起话柄，收到挂机的 URC 上报。 上海移远通信技术股份有限公司 17 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 4.7. AT+QAUDCFG='slic_cid_cfg' 设置 SLIC 来电显示模式 该命令用于设置 SLIC 来电显示模式。 AT+QAUDCFG='slic_cid_cfg' 设置 SLIC 来电显示模式 设置命令 AT+QAUDCFG='slic_cid_cfg'[,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic_cid_cfg', OK 最大响应时间 特性说明 若指定可选参数，则配置模拟话机的来电显示方式： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。SLIC 来电显示模式。 0 DTMF 模式 1 FSK SDMF 模式 2 FSK MDMF 模式 3 开启语音信箱 4 关闭语音信箱 备注 此命令设置后，需与 AT+QAUDCFG='slic_cid'配合使用。 ⚫ 为 0~2 时，使用 AT+QAUDCFG='slic_cid'将使模拟话机显示来电号码以及产生振铃； ⚫ 为 3 时，使用 AT+QAUDCFG='slic_cid'将使模拟话机显示：'信箱'（若话机支持显示语音 信箱功能）； ⚫ 为 4 时，使用 AT+QAUDCFG='slic_cid'将去除模拟话机显示的'信箱'字符（若话机支持 显示语音信箱功能）。 上海移远通信技术股份有限公司 18 / 22 举例 AT+QAUDCFG='slic_cid_cfg',2 OK AT+QAUDCFG='slic_cid_cfg' +QAUDCFG: 'slic_cid_cfg',2 OK EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 //配置模拟话机的来电显示方式为 FSK MDMF //查询当前配置 4.8. AT+QAUDCFG='slic_cid' 配置模拟话机的来电显示 该命令用于配置模拟话机的来电显示。 AT+QAUDCFG='slic_cid' 配置模拟话机的来电显示 设置命令 响应 AT+QAUDCFG='slic_cid', OK 或者 ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 字符串类型。来电显示号码。最大长度：15；单位：字节。 备注 1. 在测试过程中以及在来电显示之前，SLIC 将强制响铃一次。 2. 该命令仅在 SLIC 模拟话机工作时生效。 举例 AT+QAUDCFG='slic_cid','0123456789' OK 上海移远通信技术股份有限公司 19 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 4.9. AT+QAUDCFG='slic_hook_time' 配置模拟话机的摘挂机及闪断键检 测时间 该命令用于配置模拟话机的摘挂机及闪断键检测时间。 AT+QAUDCFG='slic_hook_time' 配置模拟话机的摘挂机及闪断键检测时间 设置命令 AT+QAUDCFG='slic_hook_time'[,,,,,,, ,] 响应 若省略可选参数，则查询当前配置： +QAUDCFG: 'slic_hook_time',,, ,,,,, OK 最大响应时间 特性说明 若指定可选参数，则配置模拟话机的摘挂机及闪断键检测时 间： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。最小脉冲中断时间。范围：0~2000；单位：毫秒。 整型。最大脉冲中断时间。范围：0~2000；单位：毫秒。 整型。最小脉冲接通时间。范围：0~2000；单位：毫秒。 整型。最大脉冲接通时间。范围：0~2000；单位：毫秒。 整型。最小脉冲间隔时间。范围：0~2000；单位：毫秒。 整型。最小闪断时间。范围：0~2000；单位：毫秒。 整型。最大闪断时间。范围：0~2000；单位：毫秒。 整型。最小话柄检测时间，该值应大于最大闪断时间。范围：0~2000；单位：毫秒。 备注 1. 执行此命令查询模拟话机的摘挂机及闪断键检测时间时，不同 SLIC 默认值可能不同。 2. 建议设置时时间限制符合下列关系： ⚫ < < < < ⚫ < < 上海移远通信技术股份有限公司 20 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 举例 AT+QAUDCFG='slic_hook_time',20,80,20,80,90,100,630,680 OK AT+QAUDCFG='slic_hook_time' +QAUDCFG: 'slic_hook_time',20,80,20,80,90,100,630,680 //设置摘挂机及闪断键检测时间 //查询当前配置 OK 上海移远通信技术股份有限公司 21 / 22 EG06xK&Ex120K&EM060K 系列 SLIC 应用指导 5 附录 参考文档及术语缩写 表 5：术语缩写 术语 AP CS DTMF FSK MDMF PCM QMI SDMF SLIC SMD SPI TA URC VoLTE 英文全称 Access Point Circuit Switched Dual-Tone Multifrequency Frequency-shift Keying Multiple Data Message Format Pulse Code Modulation Qualcomm Message Interface Single Date Message Format Subscriber Line Interface Circuit Shared Memory Driver Serial Peripheral Interface Terminal Adapter Unsolicited Result Code Voice over Long-Term Evolution 中文全称 访问接入点 电路交换 双音多频 频移键控 复合数据消息格式 脉冲编码调制 高通信息接口 单数据消息格式 用户线路接口电路 共享内存驱动 串行外设接口 终端适配器 非请求结果码 长期演进语音承载 上海移远通信技术股份有限公司 22 / 22

LC29D Series&LC79D (D) AGNSS Application Note GNSS Module Series Version: 1.1 Date: 2022-09-10 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. LC29D_Series&LC79D(D)_AGNSS_Application_Note 1 / 18 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. LC29D_Series&LC79D(D)_AGNSS_Application_Note 2 / 18 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status LC29D Series&LC79D (D) AGNSS Application Note GNSS Module Series Application Note Released Revision History Version 1.0 1.1 Date 2021-08-16 2021-11-01 2022-09-10 Description Creation of the document First official release Added applicable module LC79D (D) LC29D_Series&LC79D(D)_AGNSS_Application_Note 3 / 18 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 2 AGNSS Implementation...................................................................................................................... 7 2.1. Bream Messages for AGNSS Implementation .......................................................................... 7 2.1.1. BRM-AST-LTO (0x13 0x20) ............................................................................................ 7 2.1.2. BRM-AST-REF_LOCATION (0x13 0x40) ....................................................................... 8 2.1.3. BRM-AST-REF_TIME_UTC (0x13 0x40) ....................................................................... 9 2.2. Download LTO File from AGNSS Server ................................................................................. 10 2.3. LTO File Format ........................................................................................................................11 2.4. Send LTO Data to Modules.......................................................................................................11 3 AGNSS Testing Procedures ............................................................................................................ 13 3.1. Prerequisites ............................................................................................................................ 13 3.2. Procedures ............................................................................................................................... 13 3.3. Results ..................................................................................................................................... 17 4 Appendix References ....................................................................................................................... 18 LC29D_Series&LC79D(D)_AGNSS_Application_Note 4 / 18 GNSS Module Series Table Index Table 1: BRM-AST-LTO Message Structure ................................................................................................ 7 Table 2: BRM-AST-LTO Message Content .................................................................................................. 7 Table 3: BRM-AST-REF_LOCATION Message Structure ........................................................................... 8 Table 4: BRM-AST-REF_LOCATION Message Content ............................................................................. 8 Table 5: BRM-AST-REF_TIME_UTC Message Structure ........................................................................... 9 Table 6: BRM-AST-REF_TIME_UTC Message Content ............................................................................. 9 Table 7: Related Documents ...................................................................................................................... 18 Table 8: Terms and Abbreviations .............................................................................................................. 18 LC29D_Series&LC79D(D)_AGNSS_Application_Note 5 / 18 GNSS Module Series 1 Introduction The LC29D series and LC79D (D) GNSS modules support the AGNSS feature that significantly reduces the modules’ TTFF, especially in challenging signal scenarios. To implement the AGNSS feature, the modules should get the assistance data including the current time, rough position, and LTO data. Consult the following chapter to find out how to send the assistance data to the modules. The list of Bream messages used by the AGNSS feature is also provided for your reference. Before using the AGNSS feature, make sure to verify that everything is set up correctly. For more information on testing the modules, see Chapter 3 AGNSS Testing Procedures. LC29D_Series&LC79D(D)_AGNSS_Application_Note 6 / 18 GNSS Module Series 2 AGNSS Implementation This chapter explains AGNSS implementation on the LC29D series and LC79D (D) GNSS modules and the procedure for sending LTO data to the modules. It also includes the list of Bream messages. 2.1. Bream Messages for AGNSS Implementation The LC29D series and LC79D (D) modules can be controlled and configured through Bream input messages defined by the chipset supplier. For details, see document [1] . 2.1.1. BRM-AST-LTO (0x13 0x20) Message for injecting a six-hour Bream LTO page into the GNSS device. You can download the Bream LTO file from Quectel AGNSS server. For details, see Chapter 2.2 Download LTO File from AGNSS Server. Type: Input Table 1: BRM-AST-LTO Message Structure Header Message Group 0xB5 0x62 0x13 Message Number 0x20 Length (Bytes) Content Checksum See Table 2: BRM-AST-LTO 76 CHK1 CHK2 Message Content. Table 2: BRM-AST-LTO Message Content Byte Offset C99 0 uint8_t 1 uint8_t 2 uint8_t Scaling Name Unit - Type - - Version - - SvID - Description Message type (0x00). Message version (0x00). Satellite identifier. LC29D_Series&LC79D(D)_AGNSS_Application_Note 7 / 18 Byte Offset C99 Scaling Name Unit 3 uint8_t - GNSS_ID - 4 uint8_t - Year - 5 uint8_t - Month - 6 uint8_t - Day - 7 uint8_t - Reserved - 8 uint8_t[64] - Data - 72 uint8_t[4] - FCT s GNSS Module Series Description For details, see document [1]. GNSS identifier. For details, see document [1]. Years since 2000. Month (1–12). Day (1–31). Reserved. Assistance data. Full-cycle time (FCT). 2.1.2. BRM-AST-REF_LOCATION (0x13 0x40) Reference position assistance. The message allows the delivery of position-assistance data to the GNSS device. Type: Input Table 3: BRM-AST-REF_LOCATION Message Structure Header Message Group Message Number 0xB5 0x62 0x13 0x40 Length (Bytes) 20 Content See Table 4: BRM-AST-REF_LOCATION Message Content. Checksum CHK1 CHK2 Table 4: BRM-AST-REF_LOCATION Message Content Byte Offset C99 Scaling Name Unit 0 uint8_t - Type - 1 uint8_t - Reserved1 - 2 uint8_t[2] - Reserved2 - Description Message type (0x01). Reserved. Reserved. LC29D_Series&LC79D(D)_AGNSS_Application_Note 8 / 18 GNSS Module Series Byte Offset C99 4 int32_t 8 int32_t 12 int32_t Scaling Name 1e-7 Lat 1e-7 Lon - Alt 16 uint32_t - PosAcc Unit Degree Degree cm cm Description WGS84 latitude. WGS84 longitude. WGS84 altitude. Position accuracy (standard deviation in 3D, both horizontal and vertical). NOTE Supplying position assistance inaccurate by more than the specified position accuracy may lead to substantially degraded receiver performance. 2.1.3. BRM-AST-REF_TIME_UTC (0x13 0x40) Reference time assistance. The message allows the delivery of UTC time assistance to the GNSS device. Type: Input Table 5: BRM-AST-REF_TIME_UTC Message Structure Header 0xB5 0x62 Message Group 0x13 Message Number Length (Bytes) 0x40 24 Content Checksum See Table 6: BRM-AST-REF_TIME_UTC Message Content. CHK1 CHK2 Table 6: BRM-AST-REF_TIME_UTC Message Content Byte Offset C99 0 uint8_t 1 uint8_t 2 uint8_t Scaling Name Unit - Type - - Version - - Reserved1 - 3 int8_t - LeapSecs s Description Message type (0x10). Message version (0x00). Reserved. Number of leap seconds since 1980 (or 0x80 = –128 if unknown). LC29D_Series&LC79D(D)_AGNSS_Application_Note 9 / 18 GNSS Module Series Byte Offset C99 Scaling Name Unit 4 uint16_t - Year - 6 uint8_t - Month - 7 uint8_t - Day - 8 uint8_t - Hour - 9 uint8_t - Minute - 10 uint8_t - Second - 11 uint8_t - Reserved2 - 12 uint32_t - Nano - 16 uint16_t - TAccS s 18 uint8_t[2] - Reserved3 - 20 uint32_t - TAccNs ns Description Year. Month (1–12). Day (1–31). Hour (0–23). Minute (0–59). Seconds (0–59). Reserved. Nanoseconds (0–999,999,999). Seconds part of time accuracy. Reserved. Nanoseconds part of time accuracy (0–999,999,999). NOTE Supplying the time-assistance data surpassing the specified time accuracy may lead to substantially degraded receiver performance. 2.2. Download LTO File from AGNSS Server Before sending LTO data to the modules, the host must download the LTO file. The LTO file can be downloaded from Quectel AGNSS server, and it is valid up to 7 days. Quectel AGNSS server: ftp://agnss.queclocator.com Quectel AGNSS server supports downloading of LTO files with 2 or 7-day validity. The LTO files have the ' ltoXdv5.brm' naming structure, where the X refers to the validity period and can be either of the following options: 2 or 7. LC29D_Series&LC79D(D)_AGNSS_Application_Note 10 / 18 GNSS Module Series NOTE 1. Quectel AGNSS server is free of charge and there is no SLA while using the server. However, you must have an account to access and use the Quectel AGNSS server. Contact Quectel’s Technical Support Team (support@quectel.com) to apply for an account. 2. You must create your own server instance and download the LTO files. 2.3. LTO File Format The LTO file is composed of multiple BRM-AST-LTO messages as can be seen from the following figure. Figure 1: LTO File Format 2.4. Send LTO Data to Modules Before sending LTO data to the modules, the host must read BRM-AST-LTO messages from the LTO file, and check if the time is valid (within 3 hours before or after the current time). Once the validity of time is confirmed, the host sends successive valid BRM-AST-LTO messages to the modules, until the end of LC29D_Series&LC79D(D)_AGNSS_Application_Note 11 / 18 LTO file is reached. Sample code for checking LTO message validity: int64_t time_unix = get_unix_epoch(); int64_t time_diff = FCT+315964800 - time_unix; int64_t time_threshold = 10800; // 3 hours if((time_diff > -time_threshold) && (time_diff < time_threshold)) { // Current BRM-AST-LTO message is valid. } else { // Current BRM-AST-LTO message is not valid. } GNSS Module Series LC29D_Series&LC79D(D)_AGNSS_Application_Note 12 / 18 GNSS Module Series 3 AGNSS Testing Procedures This chapter illustrates how to test the AGNSS feature by using Quectel’s QGNSS tool. For details, see document [2]. 3.1. Prerequisites Before testing the AGNSS function, make sure that you have: 1. connected the LC29D series or LC79D (D) EVB to your computer. 2. downloaded the QGNSS tool and set the corresponding serial port number, baud rate 1), and the module’s model. 3. created the account for Quectel AGNSS server 2), and you are connected to the AGNSS server through the QGNSS tool. To make the effect of the AGNSS feature on TTFF value more noticeable, you could first get a position fix without using the AGNSS feature. After the testing procedure, you can compare the TTFF results. NOTE 1. 1) Default baud rate of the LC29D series and LC79D (D) modules is 115200 bps. 2. 2) Contact Quectel’s Technical Support Team (support@quectel.com) for information on how to get access to Quectel AGNSS server. 3.2. Procedures To test the AGNSS function in a cold start session: 1. Send BRM-STP-RESET command to the module to perform a cold start. For details, see document [1]. 2. Send BRM-AST-REF_LOCATION command to the module to inject the assistance position. 3. Send BRM-AST-REF_TIME_UTC command to the module to inject the assistance time. LC29D_Series&LC79D(D)_AGNSS_Application_Note 13 / 18 GNSS Module Series 4. Send LTO data to the module: 1) Download the LTO file from the AGNSS server. 2) Check BRM-AST-LTO message validity. 3) If messages are valid, send the BRM-AST-LTO messages to the module. Example: 1. Steps on QGNSS tool. a) Run the QGNSS tool. b) In the main interface, click 'AGNSS' -> 'Assistant GNSS Online' to enter the Download window. c) Click the 'Connect' button to connect the FTP server and select the LTO file with 2 or 7-day validity. d) Click the 'Download selected file' button to download the LTO file to your computer. e) Click the 'Select file' button to select the LTO file downloaded to your computer and then click 'Using UTC time', 'Cold start', 'Position' and 'AGNSS Data'. f) Enter latitude and longitude manually. g) Click the 'Reset and Transfer' button to send the LTO file to the module. LC29D_Series&LC79D(D)_AGNSS_Application_Note 14 / 18 GNSS Module Series 2. Detailed commands for each step. a) Host sends a cold start command. B5 62 06 04 04 00 FF FF 02 00 0E 61 // NMEA messages output from the module: $GNGNS,000001.00,,,,,NNNNNN,00,99.0,,,,,V*18 $GNRMC,000001.00,V,,,,,,,010712,,,N,V*1D $GNGNS,000001.00,,,,,NNNNNN,00,99.0,,,,,V*18 $GPGSV,1,1,01,05,,,38,1*6B $GNRMC,000001.00,V,,,,,,,010712,,,N,V*1D $GNGNS,000002.00,,,,,NNNNNN,00,99.0,,,,,V*1B $GPGSV,1,1,01,05,,,38,1*6B $GNRMC,000002.00,V,,,,,,,010712,,,N,V*1E $GNGNS,000003.00,,,,,NNNNNN,00,99.0,,,,,V*1A $GPGSV,1,1,01,05,,,41,1*65 $GNRMC,000003.00,V,,,,,,,010712,,,N,V*1F … LC29D_Series&LC79D(D)_AGNSS_Application_Note 15 / 18 GNSS Module Series b) Host injects the assistance position to the module. B5 62 13 40 14 00 01 00 00 00 8A AF F7 12 C1 5C CE 45 00 00 00 00 00 00 00 00 DA 1A c) Host injects the assistance time to the module. B5 62 13 40 18 00 10 00 00 80 E5 07 09 02 01 25 22 00 00 00 00 00 00 00 00 00 00 00 00 00 3A 88 d) Host injects the LTO data to the module. B5 62 13 20 4C 00 00 00 02 00 15 08 1F 00 00 CC BB 00 DB 60 00 06 1F A0 78 47 DF AE 95 FD FD 18 9C FD DA 39 4D 75 2E 85 AE FD 35 85 5D FB C4 FD 86 D0 CC FF E2 9D 17 17 43 8A D1 49 0D 00 39 09 95 12 22 FC C1 B0 81 B2 E8 FF 00 40 1F D0 D0 4C 59 4E 1C E4 B5 62 13 20 4C 00 00 00 03 00 15 08 1F 00 00 CC BB 00 C0 60 00 0A 1F A0 78 87 D4 84 BB F1 A3 17 93 FB 77 B7 64 D9 FD 80 39 7C A5 08 F9 57 68 22 87 D0 0B C0 E2 1D 63 16 B3 D5 E2 C9 08 40 02 87 67 72 2F ED D5 49 43 9C EA 3F 00 40 1F 4A D0 4C 59 4E C2 DC … // NMEA messages output from the module. $GNGNS,070006.00,,,,,NNNNNN,00,99.0,,,,,V*18 $GPGSV,1,1,01,05,,,38,1*6B $GNRMC,070006.00,V,,,,,,,010921,,,N,V*13 $GNGNS,070007.00,,,,,NNNNNN,00,99.0,,,,,V*19 $GPGSV,1,1,01,05,,,40,1*64 $GNRMC,070007.00,V,,,,,,,010921,,,N,V*12 $GNGNS,070008.00,,,,,NNNNNN,00,99.0,,,,,V*16 $GPGSV,1,1,03,05,,,40,13,,,41,15,,,40,1*61 $GNRMC,070008.00,V,,,,,,,010921,,,N,V*1D $GNGNS,070009.00,,,,,NNNNNN,00,99.0,,,,,V*17 $GPGSV,1,1,04,05,,,40,13,,,41,15,,,43,18,,,40,1*68 $GNRMC,070009.00,V,,,,,,,010921,,,N,V*1C $GNGNS,070010.00,,,,,NNNNNN,00,99.0,,,,,V*1F $GPGSV,2,1,05,05,,,41,13,,,41,15,,,43,18,,,40,1*6B $GPGSV,2,2,05,23,,,37,1*64 $GNRMC,070010.00,V,,,,,,,010921,,,N,V*14 $GNGNS,070011.00,,,,,NNNNNN,00,1.6,,,,,V*29 $GPGSV,2,1,06,05,46,068,41,13,,,42,15,73,348,43,18,48,314,40,1*56 $GPGSV,2,2,06,23,25,301,38,29,27,227,38,1*6F $GNRMC,070011.00,V,,,,,,,010921,,,N,V*15 // 1st second // 2nd second // 3rd second // 4th second // 5th second // 6th second // Module gets a fix in the 7th second. $GNGNS,070012.00,3149.331528,N,11706.913889,E,AANNNN,06,1.4,63.6,-3.3,,,V*09 $GPGSV,2,1,06,05,46,068,40,13,,,42,15,73,348,43,18,48,314,40,1*57 $GPGSV,2,2,06,23,25,301,37,29,27,227,38,1*60 $GLGSV,1,1,01,78,23,082,37,1*49 $GNRMC,070012.00,A,3149.331528,N,11706.913889,E,000.0,,010921,,,E,V*1D $GNGNS,070014.80,3149.333195,N,11706.913018,E,AANNNN,06,1.4,61.8,-3.3,,,V*0B LC29D_Series&LC79D(D)_AGNSS_Application_Note 16 / 18 GNSS Module Series $GPGSV,2,1,06,05,46,068,41,13,,,42,15,73,349,43,18,48,314,41,1*56 $GPGSV,2,2,06,23,25,301,38,29,27,227,39,1*6E $GLGSV,1,1,02,78,23,081,37,70,,,25,1*49 $GNRMC,070014.80,A,3149.333195,N,11706.913018,E,001.0,190.1,010921,,,E,V*35 $GNGNS,070015.79,3149.333138,N,11706.912789,E,AANANN,07,1.1,61.6,-3.3,,,V*00 $GPGSV,2,1,06,05,46,068,41,13,,,42,15,73,349,44,18,48,314,41,1*51 $GPGSV,2,2,06,23,25,301,38,29,27,227,39,1*6E $GLGSV,1,1,01,78,23,081,36,1*4B $GBGSV,1,1,02,206,60,219,36,209,43,217,35,1*77 $GNRMC,070015.79,A,3149.333138,N,11706.912789,E,000.0,,010921,,,E,V*1D 3.3. Results When the GNSS engine is started, the module will try to get a position fix. If the AGNSS feature is not enabled, the module gets a position fix within about 30 seconds of a cold start. If the AGNSS feature is enabled, the module gets a position fix in about 10 seconds or less. LC29D_Series&LC79D(D)_AGNSS_Application_Note 17 / 18 GNSS Module Series 4 Appendix References Table 7: Related Documents Document Name [1] Quectel_LC29D_Series&LC79D(D)_GNSS_Protocol_Specification [2] Quectel_QGNSS_User_Guide Table 8: Terms and Abbreviations Abbreviation AGNSS C99 EVB FCT FTP GNSS LTO SLA TTFF UTC WGS84 Description Assisted GNSS ISO/IEC 9899:1999 - Programming languages - C Evaluation Board Full-Cycle Time File Transfer Protocol Global Navigation Satellite System Long Term Orbit Software License Agreement Time to First Fix Universal Time Coordinated World Geodetic System 1984 LC29D_Series&LC79D(D)_AGNSS_Application_Note 18 / 18

EM12&EG12&EG18 GNSS Application Note LTE-A Module Series Rev. EM12&EG12&EG18_GNSS_Application_Note_V1.0 Date: 2019-10-12 Status: Released www.quectel.com LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. EM12&EG12&EG18_GNSS_Application_Note 1 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note About the Document History Revision Date 1.0 2019-10-12 Author Amos ZHANG/ Leonard LI Description Initial EM12&EG12&EG18_GNSS_Application_Note 2 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. GNSS Turning on/off Procedures ............................................................................................... 6 1.2. NMEA Sentence Types ............................................................................................................... 6 1.3. Introduction of gpsOneXTRA Assistance.................................................................................... 7 2 Description of GNSS AT Commands ................................................................................................. 9 2.1. AT+QGPSCFG GNSS Configurations ..................................................................................... 9 2.1.1. AT+QGPSCFG='outport' Configure NMEA Sentences Output Port .......................... 10 2.1.2. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA........................................................................................................................ 10 2.1.3. AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences.. 11 2.1.4. AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences ..................................................................................................................................... 12 2.1.5. AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences ..................................................................................................................................... 13 2.1.6. AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences ..................................................................................................................................... 14 2.1.7. AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations ................ 15 2.1.8. AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically ................... 15 2.1.9. AT+QGPSCFG='dpoenable' Enable/Disable DPO Mode .......................................... 16 2.1.10. AT+QGPSCFG='plane' Configure Plane Mode Used by MO GPS Session ............. 17 2.1.11. AT+QGPSCFG='suplver' Configure the SUPL Protocol Version ............................... 18 2.1.12. AT+QGPSCFG='lbsapn' Configure LBS APN Profile ................................................ 19 2.1.13. AT+QGPSCFG='agpsposmode' Configure AGPS Positioning Mode........................ 19 2.1.14. AT+QGPSCFG='agnssprotocol' Configure A-GNSS Positioning Protocols .............. 20 2.1.15. AT+QGPSCFG='appidname' Configure AGPS Username and Password................ 21 2.2. AT+QGPSDEL Delete Assistance Data ................................................................................. 22 2.3. AT+QGPS Turn on GNSS ...................................................................................................... 23 2.4. AT+QGPSEND Turn off GNSS .............................................................................................. 24 2.5. AT+QGPSLOC Acquire Positioning Information .................................................................... 24 2.6. AT+QGPSGNMEA Acquire NMEA Sentences....................................................................... 26 2.7. AT+QGPSXTRA Enable/Disable gpsOneXTRA Assistance Function ................................... 28 2.8. AT+QGPSXTRATIME Inject gpsOneXTRA Time................................................................... 28 2.9. AT+QGPSXTRADATA Inject gpsOneXTRA Data File ........................................................... 29 2.10. AT+QGPSSUPLURL Configure SUPL Server URL ........................................................... 30 2.11. AT+QGPSSUPLCA Inject SUPL Certificate ....................................................................... 31 3 Examples ............................................................................................................................................ 32 3.1. Turn on and off the GNSS......................................................................................................... 32 EM12&EG12&EG18_GNSS_Application_Note 3 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 3.2. Application of GNSS ........................................................................................... 32 3.3. Operation Procedures of gpsOneXTRA Assistance Function .................................................. 33 4 Summary of Error Codes .................................................................................................................. 34 5 Appendix A References..................................................................................................................... 35 EM12&EG12&EG18_GNSS_Application_Note 4 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 34 TABLE 2: RELATED DOCUMENTS .................................................................................................................. 35 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 35 EM12&EG12&EG18_GNSS_Application_Note 5 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 1 Introduction Quectel EM12, EG12 and EG18 modules integrate a GNSS engine which supports GPS, BeiDou, Galileo and GLONASS systems and also gpsOneXTRA Assistance technology. The high performance GNSS engine is suitable for various applications where the lowest-cost and accurate positioning is needed, and it supports position tracking without any network assistance. The high-performance GNSS makes EM12, EG12 and EG18 popular in application fields such as turn-by-turn navigation, asset tracking, personnel tracking, location-aware games, as well as home and fleet management. 1.1. GNSS Turning on/off Procedures The GNSS of EM12/EG12/EG18 supports location calculation without any assistance from the network. GNSS turning on/off procedures are shown below: Step 1: Configure GNSS parameters via AT+QGPSCFG. Step 2: Turn on GNSS via AT+QGPS. Step 3: After GNSS is turned on and position is fixed successfully, the positioning information can be obtained in either of the following three ways: 1) NMEA sentences are outputted to 'usbnmea' port by default. Customers can read the port to obtain NMEA sentences. 2) AT+QGPSLOC can be used to obtain positioning information directly, such as latitude, longitude, height, GNSS positioning mode, time, number of satellites, and so on. 3) After enabling via AT+QGPSCFG='nmeasrc',1, customers can acquire the specified NMEA sentence via AT+QGPSGNMEA. If is disabled, this command cannot be used. Step 4: Turn off GNSS via AT+QGPSEND. 1.2. NMEA Sentence Types The NMEA sentences are compatible with NMEA-0183 protocol, and four kinds of prefixes are available to differentiate NMEA sentences of different satellite systems, as illustrated below. EM12&EG12&EG18_GNSS_Application_Note 6 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note For GPS NMEA sentences, the prefix is 'GP', as below:  GPGGA - Global positioning system fix data, such as time, position, etc.  GPRMC - Recommended minimum specific GNSS data  GPGSV - GNSS satellites in view, such as number of satellites in view, satellite ID numbers, etc.  GPGSA - GNSS DOP and active satellites  GPVTG - Course over ground and ground speed For GLONASS NMEA sentences, the prefixes are 'GL' and 'GN', as below:  GLGSV - GNSS satellites in view, such as number of satellites in view, satellite ID numbers, etc.  GNGSA - GNSS DOP and active satellites  GNGNS - GNSS fix data For Galileo NMEA sentences, the prefixes are 'GA', as below:  GAGGA - Global positioning system fix data, such as time, position, etc.  GARMC - Recommended minimum specific GNSS data  GAGSV - GNSS satellites in view, such as number of satellites in view, satellite ID numbers, etc.  GAGSA - GNSS DOP and active satellites  GAVTG - Course over ground and ground speed For BeiDou NMEA sentences, the prefix is 'PQ', as below:  PQGSV - GNSS satellites in view, such as number of satellites in view, satellite ID numbers, etc.  PQGSA - GNSS DOP and active satellites 1.3. Introduction of gpsOneXTRA Assistance gpsOneXTRA Assistance technology enhances the performance of GNSS, and provides simplified GNSS assistance delivery, including ephemeris, almanac, ionosphere, UTC, health and coarse time assistance for GNSS engine. After activating gpsOneXTRA Assistance, the TTFF (Time to First Fix) can be reduced by 18s~30s (or more in harsh environments with weak signals). The assistance data which is obtained from one of the gpsOneXTRA Assistance web servers needs to be updated once a day (or every couple of days). Before using this function, please make sure the valid gpsOneXTRA assistance data is available first. It is necessary to download a new gpsOneXTRA binary file which contains the data from one of the gpsOneXTRA Assistance web servers via URLs listed below.  The files named as xtra2.bin are for GPS+GLONASS. http://xtrapath1.izatcloud.net/xtra2.bin http://xtrapath2.izatcloud.net/xtra2.bin http://xtrapath3.izatcloud.net/xtra2.bin EM12&EG12&EG18_GNSS_Application_Note 7 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note  The files named as xtra3grc.bin are for GPS+GLONASS+BeiDou. http://xtrapath1.izatcloud.net/xtra3grc.bin http://xtrapath2.izatcloud.net/xtra3grc.bin http://xtrapath3.izatcloud.net/xtra3grc.bin http://xtrapath3.izatcloud.net/xtra3grc.bin  The files named as xtra3grcej.bin are for GPS+GLONASS+BeiDou+Galileo. http://xtrapath1.izatcloud.net/xtra3grcej.bin http://xtrapath2.izatcloud.net/xtra3grcej.bin http://xtrapath3.izatcloud.net/xtra3grcej.bin gpsOneXTRA assistance data needs to be updated regularly. The status of gpsOneXTRA data files can be queried via AT+QGPSXTRADATA? before updating. The operation procedures of gpsOneXTRA Assistance function are shown as follows: Step 1: gpsOneXTRA Assistance function is enabled by default. If it is disabled, enable it first via AT+QGPSXTRA=1 Step 2: Query and confirm the current validity of gpsOneXTRA data file via AT+QGPSXTRADATA?. If the data is invalid, perform Step 3~6 then; if the data is valid, turn on GNSS engine according to the procedures described in Chapter 1.1 directly. Step 3: Download file xtra2.bin or xtra3grc.bin to the module via URLs listed above. Step 4: Inject the correct gpsOneXTRA time to GNSS engine via AT+QGPSXTRATIME. Step 5: Inject the valid gpsOneXTRA data file to GNSS engine via AT+QGPSXTRADATA. Step 6: Turn on GNSS engine according to the procedures described in Chapter 1.1. For more detailed information of the AT commands mentioned above, please refer to Chapters 2.7, 2.8 and 2.9. EM12&EG12&EG18_GNSS_Application_Note 8 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 2 Description of GNSS AT Commands 2.1. AT+QGPSCFG GNSS Configurations The command is used to query and configure various GNSS settings, including NMEA sentences output port, output type of NMEA sentences, and more. AT+QGPSCFG GNSS Configurations Test Command AT+QGPSCFG=? Response +QGPSCFG: 'outport',('none','usbnmea','uartdebug') +QGPSCFG: 'nmeasrc',(0,1) +QGPSCFG: 'gpsnmeatype',(0-31) +QGPSCFG: 'glonassnmeatype',(0-7) +QGPSCFG: 'galileonmeatype',(0,31) +QGPSCFG: 'beidounmeatype',(0-3) +QGPSCFG: 'gnssconfig',(0-7) +QGPSCFG: 'autogps',(0,1) +QGPSCFG: 'dpoenable',(0,1) +QGPSCFG: 'plane',(0-2) +QGPSCFG: 'suplver',(1-3) +QGPSCFG: 'lbsapn',(1-31),(1-4), +QGPSCFG: 'agpsposmode',(0-4294967295) +QGPSCFG: 'agnssprotocol',(1-3),(0-65535) +QGPSCFG: 'appidname',, OK Reference EM12&EG12&EG18_GNSS_Application_Note 9 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 2.1.1. AT+QGPSCFG='outport' Configure NMEA Sentences Output Port This command is used to configure NMEA sentences output port. It will take effect immediately. AT+QGPSCFG='outport' Configure NMEA Sentences Output Port Write Command AT+QGPSCFG='outport'[, ] Response When there are two parameters, configure the output port of NMEA sentences: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'outport', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter String type. Configure the output port of NMEA sentences, and the configuration parameter will be automatically saved to NVRAM. 'none' Close NMEA sentence output 'usbnmea' Output via USB NMEA port 'uartdebug' Output via debug UART port Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.1.2. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA The command enables/disables acquisition of NMEA sentences via AT+QGPSGNMEA. It will take effect immediately. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA Write Command Response AT+QGPSCFG='nmeasrc'[,] acquisition of NMEA sentences via AT+QGPSGNMEA: OK EM12&EG12&EG18_GNSS_Application_Note 10 / 36 Reference LTE-A Module Series EM12&EG12&EG18 GNSS Application Note When the second parameter is omitted, query the current setting: +QGPSCFG: 'nmeasrc', OK If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. If enabled, original NMEA sentences can be acquired via AT+QGPSGNMEA, and the configuration parameter will be automatically saved to NVRAM. Meanwhile, sentences are outputted via the same NMEA ports as before. 0 Disable 1 Enable Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.1.3. AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences This command is used to configure which type of GPS NMEA sentence will be output. It will take effect immediately. AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences Write Command AT+QGPSCFG='gpsnmeatype'[,] Response When there are two parameters, configure the output type of GPS NMEA sentences: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'gpsnmeatype', OK If there is any error related to ME functionality: +CME ERROR: EM12&EG12&EG18_GNSS_Application_Note 11 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Reference Parameter Integer type. Output type of GPS NMEA sentences by ORed, and the configuration parameter will be automatically saved to NVRAM. The default value is 31 which means that all the five types of sentences will be outputted. 0 Disable 1 GPGGA 2 GPRMC 4 GPGSV 8 GPGSA 16 GPVTG Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.1.4. AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences This command is used to configure which type of GLONASS NMEA sentence will be output. It will take effect immediately. AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences Write Command Response AT+QGPSCFG='glonassnmeatype'[, When there are two parameters, configure output type of ] GLONASS NMEA sentences: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'glonassnmeatype', OK Reference If there is any error related to ME functionality: +CME ERROR: EM12&EG12&EG18_GNSS_Application_Note 12 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Parameter Integer type. Configure output type of GLONASS NMEA sentences by ORed, and the configuration parameter will be automatically saved to NVRAM. The default value is 0. 0 Disable 1 GLGSV 2 GNGSA 4 GNGNS Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.1.5. AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences This command is used to configure which type of Galileo NMEA sentence will be output. It will take effect immediately. AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences Write Command Response AT+QGPSCFG='galileonmeatype'[,< When there are two parameters, configure output type of Galileo_NMEA_type>] Galileo NMEA sentences: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'galileonmeatype', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Configure output type of Galileo NMEA sentences by ORed, and the configuration parameter will be automatically saved to NVRAM. The default value is 0. 0 Disable 1 GAGGA EM12&EG12&EG18_GNSS_Application_Note 13 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 2 GARMC 4 GAGSV 8 GAGSA 16 GAVTG Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.1.6. AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences This command is used to configure which type of BeiDou NMEA sentence will be output. It will take effect immediately. AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences Write Command Response AT+QGPSCFG='beidounmeatype'[,< When there are two parameters, configure output type of BeiDou_NMEA_type>] BeiDou NMEA sentences: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'beidounmeatype', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Configure output type of BeiDou NMEA sentences via ORed, and the configuration parameter will be automatically saved to NVRAM. The default value is 0. 0 Disable 1 PQGSA 2 PQGSV Integer type. The error code of operation. Please refer to Chapter 4 for details. EM12&EG12&EG18_GNSS_Application_Note 14 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 2.1.7. AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations This command is used to configure the supported GNSS constellations of the module. It will take effect after the module is rebooted. AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations Write Command AT+QGPSCFG='gnssconfig'[,] Response When there are two parameters, configure supported GNSS constellations: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'gnssconfig', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Supported GNSS constellations GPS is always ON 0 GLONASS OFF/BeiDou OFF/Galileo OFF 1 GLONASS ON/BeiDou ON/Galileo ON 2 GLONASS ON/BeiDou ON/Galileo OFF 3 GLONASS ON/BeiDou OFF/Galileo ON 4 GLONASS ON/BeiDou OFF/Galileo OFF 5 GLONASS OFF/BeiDou ON/Galileo ON 6 GLONASS OFF/BeiDou OFF/Galileo ON 7 GLONASS OFF/BeiDou ON/Galileo OFF Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.1.8. AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically This command is used to configure whether to enable GNSS when the module restarts. It will take effect after the module is rebooted. EM12&EG12&EG18_GNSS_Application_Note 15 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically Write Command AT+QGPSCFG='autogps'[,] Response When there are two parameters, configure whether to enable GNSS to run automatically: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'autogps', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Enable/disable GNSS to run automatically after the module is powered on, and the configuration parameter will be automatically saved to NVRAM. 0 Disable GNSS to run automatically 1 Enable GNSS to run automatically Integer type. The error code of operation. Please refer to Chapter 4 for details. NOTE The command is only valid when the GNSS works in stand-alone mode. 2.1.9. AT+QGPSCFG='dpoenable' Enable/Disable DPO Mode This command is used to enable/disable the DPO mode for GNSS. It will take effect after the module is rebooted. AT+QGPSCFG='dpoenable' Enable/Disable DPO Mode Write Command AT+QGPSCFG='dpoenable'[,] Response When there are two parameters, enable/disable the DPO mode: OK EM12&EG12&EG18_GNSS_Application_Note 16 / 36 Reference LTE-A Module Series EM12&EG12&EG18 GNSS Application Note When the second parameter is omitted, query the current setting: +QGPSCFG: 'dpoenable', OK If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Enable/disable DPO. The setting will be automatically saved to NVRAM. 0 Disable DPO 1 Enable DPO Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.1.10. AT+QGPSCFG='plane' Configure Plane Mode Used by MO GPS Session This command is used to configure the plane mode (control plane or user plane) to be used by the Mobile-Originated (MO) GPS session. This command will take effect after the module is rebooted. AT+QGPSCFG='plane' Configure Plane Mode Used by MO GPS Session Write Command AT+QGPSCFG='plane'[,] Response When there are two parameters, the plane mode used by MO GPS session can be configured: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'plane', OK Reference If there is any error related to ME functionality: +CME ERROR: EM12&EG12&EG18_GNSS_Application_Note 17 / 36 Parameter LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Integer type. The plane mode used by MO GPS session. 0 User plane without SSL 1 User plane with SSL 2 Control plane Integer type. The error code of the operation. Please refer to Chapter 4 for details. 2.1.11. AT+QGPSCFG='suplver' Configure the SUPL Protocol Version This command is used to configure the SUPL version in an SI session, and the highest possible SUPL major version used in an NI session. This command will take effect after the module is rebooted. AT+QGPSCFG='suplver' Configure the SUPL Protocol Version Write Command AT+QGPSCFG='suplver'[,] Response When there are two parameters, configure the SUPL protocol version: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'suplver', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. SUPL version. The range is 1-3. 1 SUPL Version 1.0 2 SUPL Version 2.0 3 SUPL Version 2.0.2 Integer type. The error code of the operation. Please refer to Chapter 4 for details. EM12&EG12&EG18_GNSS_Application_Note 18 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 2.1.12. AT+QGPSCFG='lbsapn' Configure LBS APN Profile This command is used to configure LBS APN profile. This command will take effect after the module is rebooted. AT+QGPSCFG='lbsapn' Configure LBS APN Profile Write Command AT+QGPSCFG='lbsapn'[,,,] Response When all parameters are present, configure LBS APN profile: OK When , and are omitted, query the current setting: +QGPSCFG: 'lbsapn',,, OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Serving system on which this APN should be used. The range is 1-31. 1 CDMA 2 HDR 4 GSM 8 WCDMA 16 LTE Integer type. PDP type of the APN profile. 1 IPv4 2 IPv6 3 IPv4v6 4 PPP String type. Access point name. Integer type. The error code of the operation. Please refer to Chapter 4 for details. 2.1.13. AT+QGPSCFG='agpsposmode' Configure AGPS Positioning Mode This command is used to configure the AGPS positioning mode. This command will take effect after the module is rebooted. EM12&EG12&EG18_GNSS_Application_Note 19 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note AT+QGPSCFG='agpsposmode' Configure AGPS Positioning Mode Write Command AT+QGPSCFG='agpsposmode'[,] Response When there are two parameters, configure the AGPS positioning mode: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'agpsposmode', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Configure AGPS positioning mode, and the configuration parameter will be automatically saved to NVRAM. Only bit 16 is relevant to enabling of autonomous fallback for SUPL-MSB. The range is 0-4294967295. Integer type. The error code of the operation. Please refer to Chapter 4 for details. 2.1.14. AT+QGPSCFG='agnssprotocol' Configure A-GNSS Positioning Protocols This command is used to configure A-GPS LPP positioning protocol and A-GLONASS positioning protocol. This command will take effect after the module is rebooted. AT+QGPSCFG='agnssprotocol' Configure A-GNSS Positioning Protocols Write Command AT+QGPSCFG='agnssprotocol'[,,] Response When there are three parameters, configure A-GNSS positioning protocols: OK When the second and the third parameters are omitted, query the current setting: +QGPSCFG: 'agnssprotocol',, EM12&EG12&EG18_GNSS_Application_Note 20 / 36 Reference LTE-A Module Series EM12&EG12&EG18 GNSS Application Note OK If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. A-GPS LPP positioning protocol. 1 User Plane LPP 2 Control Plane LPP 3 User Plane LPP and Control Plane LPP Integer type. A-GLONASS positioning protocol. 1 Control Plane RRLP 2 Control Plane RRC 4 Control Plane LPP 256 User Plane RRLP 1280 User Plane LPP Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.1.15. AT+QGPSCFG='appidname' Configure AGPS Username and Password This command is used to configure AGPS username and password for Verizon. It is valid only under Verizon network. AT+QGPSCFG='appidname' Configure AGPS Username and Password Write Command AT+QGPSCFG='appidname'[,,< password>] Response When all parameters are present, configure AGPS username and password: OK When and are omitted, query the current setting: +QGPSCFG: 'appidname',, OK Reference If there is any error related to ME functionality: +CME ERROR: EM12&EG12&EG18_GNSS_Application_Note 21 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Parameter Username. String type and the maximum length is 15 bytes. The default value is '20000018'. Password. String type and the maximum length is 15 bytes. The default value is 'vlalite'. Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.2. AT+QGPSDEL Delete Assistance Data The command is used to delete assistance data so as to operate cold start, hot start and warm start of GNSS. The command can only be executed when GNSS is turned off. After deleting the assistance data via this command, cold start of GNSS can be enforced via AT+QGPS. Hot/warm start can also be performed if the corresponding conditions are satisfied. AT+QGPSDEL Delete Assistance Data Test Command AT+QGPSDEL=? Response +QGPSDEL: (0-3) Write Command AT+QGPSDEL= OK Response OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. The type of GNSS assistance data to be deleted. 0 Delete all assistance data. Enforce cold start after starting GNSS. 1 Do not delete any data. Perform hot start if the conditions are permitted after starting GNSS. 2 Delete some related data. Perform warm start if the conditions are permitted after starting GNSS. 3 Delete the gpsOneXTRA assistance data injected into GNSS engine. Integer type. The error code of operation. Please refer to Chapter 4 for details. EM12&EG12&EG18_GNSS_Application_Note 22 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 2.3. AT+QGPS Turn on GNSS The command is used to turn on GNSS function. Currently it only supports turning on GNSS in Stand-alone mode (that is, =1). AT+QGPS Turn on GNSS Test Command AT+QGPS=? Response +QGPS: (1-4),(1-255),(1-3),(100-65535) Read Command Read current GNSS state AT+QGPS? Write Command AT+QGPS=[,[,[,]]] OK Response +QGPS: OK Response OK If there is any error related to ME functionality: +CME ERROR: Reference Parameter Integer type. GNSS state 0 GNSS OFF 1 GNSS ON Integer type. GNSS working mode 1 Stand-alone 2 MS-based 3 MS-assisted 4 Speed-optimal Integer type. The maximum positioning time (unit: s), which indicates the response time of GNSS receiver while measuring the GNSS pseudo range and the upper time limit of GNSS satellite searching. It also includes the time for demodulating the ephemeris data and calculating the position. 1-30-255 Maximum positioning time Integer type. Horizontal accuracy level 1 Low accuracy 2 Medium accuracy 3 High accuracy Integer type. The interval time between the first and second time positioning. Unit: ms. EM12&EG12&EG18_GNSS_Application_Note 23 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 1000–65535 Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.4. AT+QGPSEND Turn off GNSS The command is used to turn off GNSS function. AT+QGPSEND Turn off GNSS Test Command AT+QGPSEND=? Execution Command AT+QGPSEND Response OK Response OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.5. AT+QGPSLOC Acquire Positioning Information Before executing the command, GNSS must be turned on via AT+QGPS. If it fails in position fix, +CME ERROR: will be returned to indicate the corresponding situation. AT+QGPSLOC Acquire Positioning Information Test Command AT+QGPSLOC=? Response +QGPSLOC: ,,,,,,,,,, Write Command AT+QGPSLOC= OK Response +QGPSLOC: ,,,,,,,,,, EM12&EG12&EG18_GNSS_Application_Note 24 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Reference OK If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Latitude and longitude display format 0 , format: ddmm.mmmm N/S,dddmm.mmmm E/W 1 , format: ddmm.mmmmmm N/S,dddmm.mmmmmm E/W 2 , format: (-)dd.ddddd,(-)ddd.ddddd UTC time Format: hhmmss.sss (Quoted from GPGGA sentence). Latitude If is 0: Format: ddmm.mmmm N/S (Quoted from GPGGA sentence) dd 00-89 (degree) mm.mmmm 00.0000-59.9999 (minute) N/S North latitude/South latitude If is 1: Format: ddmm.mmmmmm N/S (Quoted from GPGGA sentence) dd 00-89 (degree) mm.mmmmmm 00.000000-59.999999 (minute) N/S North latitude/South latitude If is 2: Format: (-)dd.ddddd (Quoted from GPGGA sentence) dd.ddddd -89.99999-89.99999 (degree) - South latitude Longitude If is 0: Format: dddmm.mmmm E/W (Quoted from GPGGA sentence) ddd 000-179 (degree) mm.mmmm 00.0000-59.9999 (minute) E/W East longitude/West longitude If is 1: Format: dddmm.mmmmmm E/W (Quoted from GPGGA sentence) ddd 000-179 (degree) mm.mmmmmm 00.000000-59.999999 (minute) E/W East longitude/West longitude If is 2: Format: (-)dd.ddddd Quoted from GPGGA sentence) EM12&EG12&EG18_GNSS_Application_Note 25 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note dd.ddddd -179.99999-179.99999 (degree) - West longitude Horizontal precision: 0.5-99.9 (Quoted from GPGGA sentence). The altitude of the antenna away from the sea level (unit: m), accurate to one decimal place (Quoted from GPGGA sentence). GNSS positioning mode (Quoted from GAGSA/GPGSA sentence). 2 2D positioning 3 3D positioning Course Over Ground based on true north. Format: ddd.mm (Quoted from GPVTG sentence). ddd 000-359 (degree) mm 00-59 (minute) Speed over ground. Format: xxxx.x. Unit: km/h. Accurate to one decimal place (Quoted from GPVTG sentence). Speed over ground. Format: xxxx.x. Unit: knots. Accurate to one decimal place (Quoted from GPVTG sentence). UTC time when fixing position. Format: ddmmyy (Quoted from GPRMC sentence). Number of satellites, from 00 (the first 0 should be retained) to 12 (Quoted from GPGGA sentence). Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.6. AT+QGPSGNMEA Acquire NMEA Sentences Before using this command, GNSS must be turned on via AT+QGPS, and set into 1 to enable acquisition of NMEA sentences via AT+QGPSGNMEA. Customers can disable sentences output via AT+QGPSCFG='gpsnmeatype'/'glonassnmeatype'/ 'galileonmeatype'/'beidounmeatype',0. If sentences output is disabled, AT+QGPSGNMEA can still be used to acquire NMEA sentences on condition that the GNSS has already acquired sentences via this command after its activation. And the sentences acquired via the command will be the last ones that have ever been acquired. AT+QGPSGNMEA Acquire NMEA Sentences Test Command AT+QGPSGNMEA=? Response +QGPSGNMEA: ('GGA','RMC','GSV','GSA','VTG','G NS') OK EM12&EG12&EG18_GNSS_Application_Note 26 / 36 Write Command Query GGA sentence AT+QGPSGNMEA='GGA' Write Command Query RMC sentence AT+QGPSGNMEA='RMC' Write Command Query GSV information AT+QGPSGNMEA='GSV' Write Command Query GSA sentence AT+QGPSGNMEA='GSA' Write Command Query VTG sentence AT+QGPSGNMEA='VTG' Write Command Query GNS sentence AT+QGPSGNMEA='GNS' Reference LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Response +QGPSGNMEA: GGA sentence OK If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: RMC sentence OK If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: GSV sentence OK If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: GSA sentence OK If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: VTG sentence OK If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: GNS sentence OK If there is any error related to ME functionality: +CME ERROR: EM12&EG12&EG18_GNSS_Application_Note 27 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Parameter Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.7. AT+QGPSXTRA Enable/Disable gpsOneXTRA Assistance Function This command can be used to enable/disable gpsOneXTRA Assistance function, and it will take effect after the module is rebooted. AT+QGPSXTRA Enable/Disable gpsOneXTRA Assistance Function Test Command AT+QGPSXTRA=? Response +QGPSXTRA: (0,1) Read Command AT+QGPSXTRA? OK Response +QGPSXTRA: Write Command AT+QGPSXTRA= OK Response OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. Enable/disable gpsOneXTRA Assistance function, and the configuration parameter will be automatically saved to NVRAM. 0 Disable gpsOneXTRA Assistance 1 Enable gpsOneXTRA Assistance Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.8. AT+QGPSXTRATIME Inject gpsOneXTRA Time This command can be used to inject gpsOneXTRA time to GNSS engine. Before using it, gpsOneXTRA Assistance function must be enabled via AT+QGPSXTRA=1 command. After activating the function, the GNSS engine will ask for gpsOneXTRA time and assistance data file. Before injecting gpsOneXTRA data EM12&EG12&EG18_GNSS_Application_Note 28 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note file, gpsOneXTRA time must be injected first via this command. AT+QGPSXTRATIME Inject gpsOneXTRA Time Test Command AT+QGPSXTRATIME=? Response +QGPSXTRATIME: , Write Command Inject gpsOneXTRA time AT+QGPSXTRATIME=, Reference OK Response OK If there is any error related to ME functionality: +CME ERROR: Parameter String type. Current UTC time Format: YYYY/MM/DD,hh:mm:ss. e.g. 2019/01/05,08:30:30. Integer type. Uncertainty of time. Unit: ms. Default value: 3500ms. It indicates the time difference between sending a request to the SNTP server and receiving a response from the SNTP server. Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.9. AT+QGPSXTRADATA Inject gpsOneXTRA Data File This command can be used to inject a gpsOneXTRA assistance data file to GNSS engine. Before operating this command, customers must enable gpsOneXTRA, store the valid gpsOneXTRA data file into UFS of the module and inject gpsOneXTRA time to GNSS engine. After operating this command successfully, gpsOneXTRA data file can be deleted from UFS, and customers can query whether the gpsOneXTRA data is injected successfully via AT+QGPSXTRADATA?. AT+QGPSXTRADATA Inject gpsOneXTRA Data File Test Command AT+QGPSXTRADATA=? Response +QGPSXTRADATA: Read Command Query the status of gpsOneXTRA data files AT+QGPSXTRADATA? OK Response +QGPSXTRADATA: , OK EM12&EG12&EG18_GNSS_Application_Note 29 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Write Command Inject gpsOneXTRA data files AT+QGPSXTRADATA= If there is any error related to ME functionality: +CME ERROR: Response OK If there is any error related to ME functionality: +CME ERROR: Reference Parameter String type. Filename of the gpsOneXTRA data file, e.g. xtra2.bin or xtra3grc.bin. Integer type. Valid time of injected gpsOneXTRA data file. Unit: min. 0 No gpsOneXTRA file or the file is overdue 1-10080 Valid time of gpsOneXTRA file String type. Starting time of the valid time of gpsOneXTRA data file Format: YYYY/MM/DD,hh:mm:ss, e.g. 2016/01/03,15:34:50. Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.10. AT+QGPSSUPLURL Configure SUPL Server URL This command is used to configure the SUPL server URL. The parameter configurations will be saved to NVRAM automatically. This command takes effect immediately. AT+QGPSSUPLURL Configure SUPL Server URL Test Command AT+QGPSSUPLURL=? Response +QGPSSUPLURL: Read Command AT+QGPSSUPLURL? OK Response +QGPSSUPLURL: OK Write Command Configure SUPL Server URL AT+QGPSSUPLURL= Response OK If there is any error related to ME functionality: EM12&EG12&EG18_GNSS_Application_Note 30 / 36 Reference LTE-A Module Series EM12&EG12&EG18 GNSS Application Note +CME ERROR: Parameter String type. SUPL server address. The address format is 'URL:port_number' where the 'port number' can be omitted, for example 'supl.server.com', '123.123.123.123', and 'supl.server.com:7275'. When the 'port number' is omitted, the default value (7275) will be used. Integer type. The error code of operation. Please refer to Chapter 4 for details. 2.11. AT+QGPSSUPLCA Inject SUPL Certificate This command can be used to inject SUPL certificate. The certificate file should be input into file system with AT+QFUPL, details of which are provided in Quectel_EM12&EG12&EG18_FILE_Application_Note. The certificate should be obtained from the operator or the server provider. This command takes effect immediately. AT+QGPSSUPLCA Inject SUPL Certificate Test Command AT+QGPSSUPLCA=? Response +QGPSSUPLCA: , Read Command AT+QGPSSUPLCA? Write Command Inject SUPL certificate AT+QGPSSUPLCA=[,] Reference OK Response OK Response OK If there is any error related to ME functionality: +CME ERROR: Parameter String type. Name of the SUPL certificate. Integer type. SUPL certificate ID. Integer type. The error code of operation. Please refer to Chapter 4 for details. EM12&EG12&EG18_GNSS_Application_Note 31 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 3 Examples 3.1. Turn on and off the GNSS Default arguments are used in this example to turn on GNSS. After turning on GNSS, NMEA sentences will be outputted from 'usbnmea' port by default; and GNSS can be turned off via AT+QGPSEND. AT+QGPS=1 OK //Turn on GNSS. //After turning on GNSS, NMEA sentences will be outputted from 'usbnmea' port by default. AT+QGPSLOC? //Obtain positioning information. +QGPSLOC: 061951.0,3150.7223N,11711.9293E,0.7,62.2,2,0.0,0.0,0.0,110513,09 OK AT+QGPSEND OK //Turn off GNSS. 3.2. Application of GNSS When GNSS is turned on and is set to 1, NMEA sentences can be acquired directly via AT+QGPSGNMEA. AT+QGPSCFG='nmeasrc',1 OK //Set to 1 to enable acquisition of NMEA sentences via AT+QGPSGNMEA. AT+QGPSGNMEA='GGA' //Obtain GGA sentence. +QGPSGNMEA: $GPGGA,103647.0,3150.721154,N,11711.925873,E,1,02,4.7,59.8,M,-2.0,M,,*77 OK AT+QGPSCFG='nmeasrc',0 //Set to 0 to disable acquisition of NMEA EM12&EG12&EG18_GNSS_Application_Note 32 / 36 OK AT+QGPSGNMEA='GGA' +CME ERROR: 507 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note sentences via AT+QGPSGNMEA. //Acquisition of NMEA sentences via AT+QGPSGNMEA was disabled, and thus GGA sentences cannot be obtained. 3.3. Operation Procedures of gpsOneXTRA Assistance Function This example shows the operation procedures of gpsOneXTRA Assistance function. AT+QGPSXTRA=1 OK //If gpsOneXTRA Assistance is disabled, enable it first and then perform the following procedures. //The gpsOneXTRA Assistance function is activated immediately. //If gpsOneXTRA data file is valid (query via AT+QGPSXTRADATA?), turn on GNSS engine directly. //If gpsOneXTRA data file is invalid (query via AT+QGPSXTRADATA?), then perform the following procedures. //Customers can download the gpsOneXTRA data file to PC (or MCU) from URL http://xtrapath1.izatcloud.net/xtra2.bin or other URLs listed in Chapter 1.3. AT+QFUPL='UFS:xtra2.bin',59748,60 OK //Select a gpsOneXTRA file and upload it to module via QCOM. For more details about this command and QCOM tool usage and configuration, please refer to document [2]. AT+QGPSXTRATIME='2019/01/05,08:30:30',3500 OK //Inject gpsOneXTRA time to GNSS engine. AT+QGPSXTRADATA='UFS:xtra2.bin' OK //The gpsOneXTRA data file is injected to GNSS engine successfully. AT+QFDEL='UFS:xtra2.bin' OK //Delete gpsOneXTRA data file from UFS. AT+QGPS=1 OK //Turn on GNSS engine. EM12&EG12&EG18_GNSS_Application_Note 33 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 4 Summary of Error Codes The indicates an error related to GNSS operation. The details about are described in the following table. Table 1: Summary of Error Codes 501 502 503 504 505 506 507 508 512 513 514 515 516 517 549 Meaning Invalid parameter(s) Operation not supported GNSS subsystem busy Session is ongoing Session not active Operation timeout Function not enabled Time information error Validity time is out of range Internal resource error GNSS locked End by E911 Not fixed now CMUX port is not opened Unknown error EM12&EG12&EG18_GNSS_Application_Note 34 / 36 LTE-A Module Series EM12&EG12&EG18 GNSS Application Note 5 Appendix A References Table 2: Related Documents SN Document Name Remark Quectel_EM12&EG12&EG18_AT_Commands [1] EM12&EG12&EG18 AT commands manual _Manual Quectel_EM12&EG12&EG18_FILE_ [2] Application_Note EM12&EG12&EG18 FILE application note Table 3: Terms and Abbreviations Abbreviation AGPS APN BeiDou DOP DPO Galileo GGA GLONASS GNS GNSS GPS gpsOneXTRA GSA Description Assisted Global Positioning System Access Point Name BeiDou Navigation Satellite System Dilution of Precision Dynamic Power Optimization Galileo Satellite Navigation System Global Positioning System Fix Data Global Navigation Satellite System Global Network Service Global Navigation Satellite System Global Positioning System An Auxiliary Positioning Technology Provided by Qualcomm GPS DOP and Active Satellites EM12&EG12&EG18_GNSS_Application_Note 35 / 36 GSV LPP MCU ME MS NI NMEA NVRAM PC RAM RMC SI SNR SNTP SSL SUPL TTFF UART UFS URL USB UTC VTG LTE-A Module Series EM12&EG12&EG18 GNSS Application Note Satellites in View LTE Positioning Protocol Micro Control Unit Mobile Equipment Mobile Station Network Initiated National Marine Electronics Association Non-Volatile Random Access Memory Private Computer Random Access Memory Recommended Minimum Navigation Information SET Initiated Signal Noise Ratio Simple Network Time Protocol Secure Sockets Layer Secure User Plane Location Time to First Fix Universal Asynchronous Receiver & Transmitter User File System Uniform Resource Locator Universal Serial Bus Universal Time Code Track Made Good and Ground Speed EM12&EG12&EG18_GNSS_Application_Note 36 / 36

LTE-A(Q) 系列 GNSS 应用指导 LTE-A 模块系列 版本：1.0 日期：2021-11-24 状态：受控文件 LTE-A(Q)系列 GNSS 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同 时，您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分 析、评估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同 意，尽管移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可 用'基础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 46 LTE-A(Q)系列 GNSS 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问 性、安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 2 / 46 LTE-A(Q)系列 GNSS 应用指导 文档历史 修订记录 版本 1.0 日期 2021-11-11 2021-11-24 作者 Remy SHI/ Don XU Remy SHI/ Don XU 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 46 LTE-A(Q)系列 GNSS 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 1.2. 打开/关闭 GNSS 步骤.................................................................................................................. 8 1.3. 支持的 NMEA 语句类型............................................................................................................... 8 1.4. XTRA 辅助技术简介 .................................................................................................................... 9 2 GNSS 相关 AT 命令 ............................................................................................................................. 11 2.1. AT 命令说明............................................................................................................................... 11 2.1.1. 定义 ................................................................................................................................ 11 2.1.2. AT 命令语句.................................................................................................................... 11 2.2. AT 示例声明............................................................................................................................... 12 2.3. AT 命令详解............................................................................................................................... 12 2.3.1. AT+QGPSCFG 配置 GNSS .......................................................................................... 12 2.3.1.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 ....................................... 13 2.3.1.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 ............................................................................................................................ 13 2.3.1.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 ................ 14 2.3.1.4. AT+QGPSCFG='glonassnmeatype' 配置 GLONASS 或 GNSS 组合系统 NMEA 语句输出类型 ........................................................................................................................ 15 2.3.1.5. AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 ........ 16 2.3.1.6. AT+QGPSCFG='beidounmeatype' 配置 BeiDou 和 QZSS NMEA 语句的输出类 型 ............................................................................................................................ 17 2.3.1.7. AT+QGPSCFG='gnssconfig' 配置启用的 GNSS 卫星导航系统 ...................... 19 2.3.1.8. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 ........................................ 20 2.3.1.9. AT+QGPSCFG='dpoenable' 启用/禁用 DPO 模式 .......................................... 21 2.3.1.10. AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 ........................ 21 2.3.1.11. AT+QGPSCFG='suplver' 配置 SUPL 协议版本 ............................................... 22 2.3.1.12. AT+QGPSCFG='lbsapn' 配置 LBS APN.......................................................... 23 2.3.1.13. AT+QGPSCFG='agpsposmode' 配置 AGNSS 定位模式................................. 24 2.3.1.14. AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议................................. 25 2.3.1.15. AT+QGPSCFG='multibandconfig' 配置 GNSS 多频段 .................................... 26 2.3.2. AT+QGPSDEL 删除辅助数据 ....................................................................................... 27 2.3.3. AT+QGPS 打开 GNSS.................................................................................................. 28 2.3.4. AT+QGPSEND 关闭 GNSS .......................................................................................... 30 2.3.5. AT+QGPSLOC 获取定位信息 ....................................................................................... 30 2.3.6. AT+QGPSGNMEA 获取 NMEA 语句 ............................................................................ 32 2.3.7. AT+QGPSXTRA 启用/禁用 XTRA 辅助功能 ................................................................. 34 2.3.8. AT+QGPSXTRATIME 注入 XTRA 时间........................................................................ 35 上海移远通信技术股份有限公司 4 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.9. AT+QGPSXTRADATA 注入 XTRA 数据文件................................................................ 36 2.3.10. AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL ...................................................... 38 2.3.11. AT+QGPSSUPLCA 导入 SUPL 证书............................................................................ 39 3 举例 ...................................................................................................................................................... 40 3.1. 打开与关闭 GNSS ..................................................................................................................... 40 3.2. GNSS 参数的应用 ............................................................................................... 40 3.3. XTRA 辅助功能的操作步骤 ....................................................................................................... 41 3.4. AGNSS 功能的操作步骤 ........................................................................................................... 41 4 错误代码 ............................................................................................................................................... 43 5 附录 参考文档及术语缩写 .................................................................................................................... 44 上海移远通信技术股份有限公司 5 / 46 LTE-A(Q)系列 GNSS 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型 ..................................................................................................................................... 11 表 3：PQGSV 和 PQGSA 语句格式定义.................................................................................................... 18 表 4：错误代码列表.................................................................................................................................... 43 表 5：参考文档 ........................................................................................................................................... 44 表 6：术语缩写 ........................................................................................................................................... 44 上海移远通信技术股份有限公司 6 / 46 LTE-A(Q)系列 GNSS 应用指导 1 引言 移 远 通信 LTE-A(Q)系列模 块 内部 集成 GNSS 引擎 ， 支持 GPS、 BeiDou、 QZSS、 Galileo 和 GLONASS 系统以及 XTRA（即 gpsOneXTRA）辅助技术。高性能 GNSS 引擎适用于各类有低成本、精 确定位需求的应用场景，并支持在无需任何网络协助下进行位置跟踪。这使移远通信 LTE-A(Q)系列模块 广泛应用于如下领域：逐向导航、资产跟踪、人员跟踪、位置感知游戏以及家庭和车队管理。 1.1. 适用模块 表 1：适用模块 模块系列 LTE-A(Q) 模块 EG06 系列 EM06 系列 EP06 系列 EG060K-EA EG120K-EA EM060K-GL EG12 系列 EM12-G EG18 系列 EM120R-GL EM121R-GL EM160R-GL EG512R-EA 上海移远通信技术股份有限公司 7 / 46 LTE-A(Q)系列 GNSS 应用指导 1.2. 打开/关闭 GNSS 步骤 LTE-A(Q)系列模块的 GNSS 支持位置计算功能，且无需网络协助。打开/关闭 GNSS 的步骤如下： 步骤 1：通过 AT+QGPSCFG 配置 GNSS 参数。 步骤 2：通过 AT+QGPS 打开 GNSS。 步骤 3：打开 GNSS，定位成功后，可通过以下三种方式获取定位信息： 1) NMEA 语句默认输出至'usbnmea'端口，可以通过读取该端口获取 NMEA 语句。 2) 通过 AT+QGPSLOC 可直接获取定位信息，例如纬度、经度、高度、GNSS 定位模 式、时间、卫星数量等。 3) 通 过 设 置 AT+QGPSCFG='nmeasrc',1 启 用 通 过 AT+QGPSGNMEA 获 取 指 定 的 NMEA 语 句 。 如 果 设 置 AT+QGPSCFG='nmeasrc',0 ， 则 不 能 通 过 AT+QGPSGNMEA 获取指定的 NMEA 语句。 步骤 4：执行 AT+QGPSEND 关闭 GNSS。 1.3. 支持的 NMEA 语句类型 模块默认支持的 NMEA 语句与 NMEA 0183 协议兼容。可以通过五种前缀区分不同卫星系统的 NMEA 语句，如下所示： GNSS 组合系统 NMEA 语句的前缀为'GN'，如下所示： ⚫ GNGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GNGNS - GNSS 定位数据 GPS NMEA 语句的前缀为'GP'，如下所示： ⚫ GPGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GPRMC - 推荐的最小具体 GNSS 数据 ⚫ GPGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ GPGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GPVTG - 对地航向与对地速度 GLONASS NMEA 语句的前缀为'GL'，如下所示： ⚫ GLGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 Galileo NMEA 语句的前缀为'GA'，如下所示： ⚫ GAGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GARMC - 推荐的最小具体 GNSS 数据 ⚫ GAGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ GAGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 上海移远通信技术股份有限公司 8 / 46 LTE-A(Q)系列 GNSS 应用指导 ⚫ GAVTG - 对地航向与对地速度 BeiDou NMEA 语句的前缀为'PQ'，如下所示： ⚫ PQGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ PQGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 QZSS NMEA 语句的前缀为'PQ'，如下所示： ⚫ PQGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ PQGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 备注 1. LTE-A(Q)系列模块 BeiDou 和 QZSS NMEA 语句的前缀均为'PQ'，是基于 NMEA 0183 V4.10 协议 的拓展语句。 2. 对于 EG06、EM06 和 EP06 系列模块，其 Galileo NMEA 语句仅支持 GAGSV。 1.4. XTRA 辅助技术简介 XTRA 辅助技术能够提高 GNSS 的性能，提供简化的 GNSS 辅助，包括对 GNSS 引擎的星历、年 历、电离层、UTC、健康和粗略时间的辅助。激活 XTRA 辅助后，首次定位时间（TTFF）可减少 18~30 秒（信号弱的恶劣环境下减少更多）。从 XTRA 辅助网络服务器获取的辅助数据需在过期前及时更新。 使用此功能前，首先请确保有效的 XTRA 辅助数据的可用性，需要从如下所列的 URL 地址中下载一 份新的 XTRA 二进制文件，文件中包含某个 XTRA 辅助网络服务器的数据。 ⚫ GPS + GLONASS 系统的数据文件后缀名为'xtra2.bin'： http://xtrapath4.izatcloud.net/xtra2.bin http://xtrapath5.izatcloud.net/xtra2.bin http://xtrapath6.izatcloud.net/xtra2.bin ⚫ GPS + GLONASS + BeiDou 系统的数据文件后缀名为'xtra3grc.bin'： http://xtrapath4.izatcloud.net/xtra3grc.bin http://xtrapath5.izatcloud.net/xtra3grc.bin http://xtrapath6.izatcloud.net/xtra3grc.bin ⚫ GPS + GLONASS + BeiDou + Galileo 系统的数据文件后缀名为'xtra3grcej.bin'： http://xtrapath4.izatcloud.net/xtra3grcej.bin http://xtrapath5.izatcloud.net/xtra3grcej.bin http://xtrapath6.izatcloud.net/xtra3grcej.bin 上海移远通信技术股份有限公司 9 / 46 LTE-A(Q)系列 GNSS 应用指导 备注 本文的适用模块仅部分型号支持后缀名为'xtra3grcej.bin'的 GPS + GLONASS + BeiDou + Galileo 系统 数据文件。详细信息请联系移远通信技术支持。 XTRA 辅助数据需定期更新。在更新 XTRA 辅助数据之前，可通过 AT+QGPSXTRADATA?查询 XTRA 数据文件的状态。 XTRA 辅助功能的操作步骤如下： 步骤 1：对于 EG06、EM06 和 EP06 系列模块，默认禁用 XTRA 辅助功能；其他适用模块，默认启 用 XTRA 辅助功能。若禁用了该功能，可通过 AT+QGPSXTRA=1 开启。 步骤 2：通过 AT+QGPSXTRADATA?查询并确认 XTRA 数据文件当前的有效性。如果数据无效，请 执行步骤 3~步骤 6；如果数据有效，请根据第 1.2 章所述步骤直接打开 GNSS 引擎。 步骤 3：根据上述所列的 URL 地址，将文件名后缀为'xtra2.bin'或'xtra3grc.bin'或'xtra3grcej.bin'的文 件下载到模块。 步骤 4：通过 AT+QGPSXTRATIME 向 GNSS 引擎注入正确的 XTRA 时间。 步骤 5：通过 AT+QGPSXTRADATA 向 GNSS 引擎注入有效的 XTRA 数据文件。 步骤 6：根据第 1.2 章所述步骤打开 GNSS 引擎。 备注 1. 步骤 1 开始之前，需要确保已经关闭 GNSS 引擎。 2. 有关上述 AT 命令的详细信息，可参考第 2.3.7、2.3.8 及 2.3.9 章。 上海移远通信技术股份有限公司 10 / 46 LTE-A(Q)系列 GNSS 应用指导 2 GNSS 相关 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说 明，配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 11 / 46 LTE-A(Q)系列 GNSS 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意 见，也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接 关系或连续性。 2.3. AT 命令详解 2.3.1. AT+QGPSCFG 配置 GNSS 该命令用于查询和配置 GNSS 不同的设置，包括 NMEA 语句输出端口、NMEA 语句的输出类型等。 AT+QGPSCFG 配置 GNSS 测试命令 AT+QGPSCFG=? 响应 +QGPSCFG: 'outport',(支持的列表) +QGPSCFG: 'nmeasrc',(支持的列表) +QGPSCFG: 'gpsnmeatype',(支持的范围) +QGPSCFG: 'glonassnmeatype',(支持的范围) +QGPSCFG: 'galileonmeatype',(支持的范围) +QGPSCFG: 'beidounmeatype',(支持的范围) +QGPSCFG: 'gnssconfig',(支持的范围) +QGPSCFG: 'autogps',(支持的列表) +QGPSCFG: 'dpoenable',(支持的范围) +QGPSCFG: 'plane',(支持的范围) +QGPSCFG: 'suplver',(支持的范围) +QGPSCFG: 'lbsapn',(支持的范围),(支持的范围), +QGPSCFG: 'agpsposmode',(支持的范围) +QGPSCFG: 'agnssprotocol',(支持的范围),(支持的范围) +QGPSCFG：'multibandconfig',(支持的范围) OK 备注 仅部分型号模块支持通过 AT 命令配置 GNSS 多频段。请联系移远通信技术支持获取详细信息。 上海移远通信技术股份有限公司 12 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.1.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 该命令用于配置 NMEA 语句输出端口。 AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 设置命令 AT+QGPSCFG='outport'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'outport', 最大响应时间 特性说明 OK 若指定可选参数，则配置 NMEA 语句输出端口： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 字符串类型。配置 NMEA 语句输出端口。 'none' 关闭 NMEA 语句输出 'usbnmea' 通过 USB NMEA 口输出 'uartdebug' 通过调试串口输出 操作错误码。详细信息可参考第 4 章。 2.3.1.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 该命令用于启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 设置命令 AT+QGPSCFG='nmeasrc'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'nmeasrc', OK 上海移远通信技术股份有限公司 13 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 若指定可选参数，则配置是否启用通过 AT+QGPSGNMEA 获 取 NMEA 语句： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整 型 。 启 用 / 禁 用 通 过 AT+QGPSGNMEA 获 取 NMEA 语 句 。 使 能 后 ， 执 行 AT+QGPSGNMEA，NMEA 语句将以命令返回值的形式通过 AT 口输出。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 2.3.1.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 该命令用于配置 GPS NMEA 语句的输出类型。 AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='gpsnmeatype'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gpsnmeatype', 最大响应时间 OK 若指定可选参数，则配置 GPS NMEA 语句的输出类型： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 14 / 46 LTE-A(Q)系列 GNSS 应用指导 特性说明 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。设置输出的 GPS NMEA 语句类型。取值为异或运算格式。 0 禁用 1 GPGGA 2 GPRMC 4 GPGSV 8 GPGSA 16 GPVTG 31 输出全部 5 种类型语句 操作错误码。详细信息可参考第 4 章。 2.3.1.4. AT+QGPSCFG='glonassnmeatype' 配置 GLONASS 或 GNSS 组合系统 NMEA 语句输出类 型 该命令用于配置 GLONASS 或 GNSS 组合系统 NMEA 语句的输出类型。 AT+QGPSCFG='glonassnmeatype' 配置 GLONASS 或 GNSS 组合系统 NMEA 语句输 出类型 设置命令 AT+QGPSCFG='glonassnmeatype'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'glonassnmeatype', 最大响应时间 特性说明 OK 若指定可选参数，则配置 GLONASS 或 GNSS 组合系统 NMEA 语句的输出类型： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 15 / 46 LTE-A(Q)系列 GNSS 应用指导 参数 整型。设置输出的 GLONASS 或 GNSS 组合系统 NMEA 语句 类型。取值为异或运算格式。 0 禁用 1 GLGSV 2 GNGSA 4 GNGNS 操作错误码。详细信息可参考第 4 章。 2.3.1.5. AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 该命令用于配置 Galileo NMEA 语句的输出类型。 AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 设置命令 AT+QGPSCFG='galileonmeatype'[,< Galileo_NMEA_type>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'galileonmeatype', OK 若指定可选参数，则配置 Galileo NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。设置输出的 Galileo NMEA 语句类型。取值为异或运算格式。 对于 EG06、EM06 和 EP06 系列模块，支持的参数取值如下： 0 禁用 1 GAGSV 对于其他适用模块，支持的参数取值如下： 0 禁用 1 GAGGA 上海移远通信技术股份有限公司 16 / 46 LTE-A(Q)系列 GNSS 应用指导 2 GARMC 4 GAGSV 8 GAGSA 16 GAVTG 操作错误码。详细信息可参考第 4 章。 2.3.1.6. AT+QGPSCFG='beidounmeatype' 配置 BeiDou 和 QZSS NMEA 语句的输出类型 该命令用于配置 BeiDou 和 QZSS NMEA 语句的输出类型。 AT+QGPSCFG='beidounmeatype' 配置 BeiDou 和 QZSS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='beidounmeatype'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'beidounmeatype', 最大响应时间 特性说明 OK 若指定可选参数，则配置 BeiDou 和 QZSS NMEA 语句的输出 类型： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。设置输出的 BeiDou 和 QZSS NMEA 语句类型。取值为异或运算格 式。 0 禁用 1 PQGSA 2 PQGSV 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 17 / 46 LTE-A(Q)系列 GNSS 应用指导 备注 该 命 令 配 置 BeiDou NMEA 语 句 输 出 类 型 时 ， 会 同 时 配 置 QZSS NMEA 语 句 输 出 类 型 ， 如 AT+QGPSCFG='beidounmeatype',1 表 示 同 时 配 置 BeiDou 和 QZSS NMEA 语 句 输 出 类 型 为 PQGSA。 表 3：PQGSV 和 PQGSA 语句格式定义 语句类型 PQGSV PQGSA 格式定义 $PQGSV,,,,,,,,...,, ,,,,* $PQGSA,,,,…,,,,,< SysID>* 参数 语句总条数。范围：1~9。 当前语句编号。范围：1~9。 可见卫星总数。范围：0~36。 卫星识别码。 仰角。最大 90°。 方位角。范围：000°~359°。 信噪比 C/N0。范围：00~99；单位：dB-Hz。不跟踪时为空。 信号识别码。0 表示所有信号。 系统识别码。 4 BeiDou 5 QZSS 校验和。 定位模式一。 M 手动模式，强制 2D 或 3D 定位； A 自动模式，自动切换 2D 或 3D 定位。 定位模式二。 1 未定位； 2 2D 定位； 3 3D 定位。 位置精度因子。 水平精度因子。 垂直精度因子。 上海移远通信技术股份有限公司 18 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.1.7. AT+QGPSCFG='gnssconfig' 配置启用的 GNSS 卫星导航系统 该命令用于配置模块启用的 GNSS 卫星导航系统。 AT+QGPSCFG='gnssconfig' 配置启用的 GNSS 卫星导航系统 设置命令 AT+QGPSCFG='gnssconfig'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gnssconfig', 最大响应时间 特性说明 OK 若省略可选参数，则配置启用的 GNSS 卫星导航系统： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。启用的 GNSS 卫星导航系统。GPS 始终打开。 0 关闭 GLONASS/关闭 BeiDou 和 QZSS/关闭 Galileo 1 打开 GLONASS/打开 BeiDou 和 QZSS/打开 Galileo 2 打开 GLONASS/打开 BeiDou 和 QZSS/关闭 Galileo 3 打开 GLONASS/关闭 BeiDou 和 QZSS/打开 Galileo 4 打开 GLONASS/关闭 BeiDou 和 QZSS/关闭 Galileo 5 关闭 GLONASS/打开 BeiDou 和 QZSS/打开 Galileo 6 关闭 GLONASS/关闭 BeiDou 和 QZSS/打开 Galileo 7 关闭 GLONASS/打开 BeiDou 和 QZSS/关闭 Galileo 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 19 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.1.8. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 该命令用于配置在设备重启时，是否自动运行 GNSS。 AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 设置命令 AT+QGPSCFG='autogps'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'autogps', 最大响应时间 特性说明 OK 若指定可选参数，则配置是否启用 GNSS 自启动： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。模块开机后，启用/禁用 GNSS 自启动。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 备注 GNSS 只能以独立模式自启动。 上海移远通信技术股份有限公司 20 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.1.9. AT+QGPSCFG='dpoenable' 启用/禁用 DPO 模式 该命令用于启用/禁用 DPO 模式。 AT+QGPSCFG='dpoenable' 启用/禁用 DPO 模式 设置命令 AT+QGPSCFG='dpoenable'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'dpoenable', 最大响应时间 特性说明 OK 若指定可选参数，则启用/禁用 DPO 模式： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。启用/禁用 DPO。 0 禁用 DPO 1 使用动态占空比启用 DPO 2 仅在模块未连接外部电源（未依靠电池运行）时，启用 DPO 操作错误码。详细信息可参考第 4 章。 2.3.1.10.AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 该命令用于配置 MO AGPS 会话要使用的平面模式（控制平面或用户平面）。 AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 设置命令 AT+QGPSCFG='plane'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'plane', OK 上海移远通信技术股份有限公司 21 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 若指定可选参数，则配置 MO AGPS 会话使用的平面模式： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。MO AGPS 会话使用的平面模式。 0 无 SSL 的用户平面 1 具有 SSL 的用户平面 2 控制平面 操作错误码。详细信息可参考第 4 章。 2.3.1.11.AT+QGPSCFG='suplver' 配置 SUPL 协议版本 该 命 令 用 于 在 SI（ SET Initiated ， 用 户 发 起 ） 会 话 中 配 置 SUPL 版 本 ， 以 及 在 NI （ Network Initiated，网络发起）会话中配置最可能使用的 SUPL 版本。 AT+QGPSCFG='suplver' 配置 SUPL 协议版本 设置命令 AT+QGPSCFG='suplver'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'suplver', OK 若指定可选参数，则配置 SUPL 协议版本： OK 或者 ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 22 / 46 LTE-A(Q)系列 GNSS 应用指导 特性说明 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。SUPL 协议版本。 1 SUPL V1.0 2 SUPL V2.0 3 SUPL V2.0.2 操作错误码。详细信息可参考第 4 章。 2.3.1.12.AT+QGPSCFG='lbsapn' 配置 LBS APN 该命令用于配置 LBS APN。 AT+QGPSCFG='lbsapn' 配置 LBS APN 设置命令 AT+QGPSCFG='lbsapn'[,,,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'lbsapn',,, OK 若指定可选参数，则配置 LBS APN： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。异或运算格式的 LBS APN 使用的服务系统。范围：0~31。 0 禁用 1 CDMA 2 HDR 4 GSM 8 WCDMA 上海移远通信技术股份有限公司 23 / 46 16 LTE 整型。LBS APN 配置文件的 PDP 类型。 0 禁用 1 IPv4 2 IPv6 3 IPv4v6 4 PPP 字符串类型。接入点名称。 操作错误码。详细信息可参考第 4 章。 LTE-A(Q)系列 GNSS 应用指导 2.3.1.13.AT+QGPSCFG='agpsposmode' 配置 AGNSS 定位模式 该命令用于配置 AGNSS 定位模式。 AT+QGPSCFG='agpsposmode' 配置 AGNSS 定位模式 设置命令 AT+QGPSCFG='agpsposmode'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'agpsposmode', OK 若指定可选参数，则配置 AGNSS 定位模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。AGNSS 定位模式。不同 bit 位代表不同模式，详细信息可见下图。仅 bit 16 与启用 SUPL-MSB 自主回退相关。bit 位设置为 1 即启用相应模式。范围： 0~33554431；默认值：33488767 或 775。 上海移远通信技术股份有限公司 24 / 46 LTE-A(Q)系列 GNSS 应用指导 操作错误码。详细信息可参考第 4 章。 备注 当插入中国联通/中国电信/中国移动(U)SIM 卡时，的默认值为 775；当插入其他卡 时，的默认值为 33488767。 2.3.1.14.AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议 该命令用于配置 AGPS LPP 定位协议和 AGLONASS 定位协议。 AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议 设置命令 AT+QGPSCFG='agnssprotocol'[, ,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'agnssprotocol',, OK 若指定可选参数，则配置 AGPS LPP 定位协议和 AGLONASS 定 位协议： OK 上海移远通信技术股份有限公司 25 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。AGPS LPP 定位协议。异或运算格式。 0 禁用所有 1 用户平面 LPP 2 控制平面 LPP 3 用户平面 LPP 和控制平面 LPP 整型。AGLOSNASS 定位协议。异或运算格式。默认值：1286。 0 禁用所有 1 控制平面 RRLP 2 控制平面 RRC 4 控制平面 LPP 256 用户平面 RRLP 1024 用户平面 LPP 操作错误码。详细信息可参考第 4 章。 2.3.1.15.AT+QGPSCFG='multibandconfig' 配置 GNSS 多频段 该命令用于配置 GNSS 多频段。 AT+QGPSCFG='multibandconfig' 配置 GNSS 多频段 设置命令 AT+QGPSCFG='multibandconfig',[< multiband>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'multibandconfig', OK 若指定可选参数省，则配置 GNSS 多频段： OK 或者 ERROR 上海移远通信技术股份有限公司 26 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。在 L1 基础上设置的 GNSS 多频段。异或运算格式。bit 位设置为 1 表示启用 相应频段，设置为 0 表示关闭相应频段。 0 禁用 1 GPS L5 2 Galileo E5a 4 BeiDou B2a 操作错误码。详细信息可参考第 4 章。 备注 仅部分型号模块支持通过 AT 命令配置 GNSS 多频段。请联系移远通信技术支持获取详细信息。 2.3.2. AT+QGPSDEL 删除辅助数据 该命令用于删除辅助数据，以便进行 GNSS 冷启动、热启动和温启动操作，且仅可在 GNSS 关闭时 执行。使用该命令删除辅助数据后，可通过 AT+QGPS 强制对 GNSS 进行冷启动。满足相应的条件时， 也可以进行热/温启动。 AT+QGPSDEL 删除辅助数据 测试命令 AT+QGPSDEL=? 响应 +QGPSDEL: (支持的范围) 设置命令 AT+QGPSDEL= OK 响应 OK 或者 ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 27 / 46 LTE-A(Q)系列 GNSS 应用指导 特性说明 / 参数 整型。将要删除的 GNSS 辅助数据类型。 0 删除所有辅助数据。开启 GNSS 后，强制冷启动。 1 不删除数据。开启 GNSS 后，条件允许时进行热启动。 2 删除部分相关数据。开启 GNSS 后，条件允许时进行温启动。 3 删除注入 GNSS 引擎的 XTRA 辅助数据。 操作错误码。详细信息可参考第 4 章。 2.3.3. AT+QGPS 打开 GNSS 该命令用于打开 GNSS 功能。 AT+QGPS 打开 GNSS 测试命令 AT+QGPS=? 响应 EG06、EM06 和 EP06 系列模块： +QGPS: ( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围),(支持的范围),(支持的范围) OK 其他适用模块： +QGPS: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围),(支持的 范围) OK 查询命令 查询当前 GNSS 会话状态 AT+QGPS? 响应 +QGPS: OK 设置命令 EG06、EM06 和 EP06 系列模块 AT+QGPS=[,[,[,[,]]]] ERROR 若错误与 ME 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 28 / 46 LTE-A(Q)系列 GNSS 应用指导 设置命令 其他适用模块 AT+QGPS=[,[,[,]]] 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。GNSS 状态。 0 GNSS 关闭 1 GNSS 打开 整型。GNSS 工作模式。 1 独立模式 2 MSB 3 MSA 4 快速定位 整型。最长定位时间，包括测量 GNSS 伪距期间的反应时间、GNSS 卫星搜 索的时间上限、解调星历数据的时间以及计算位置的时间。范围：1~255；默 认值：30；单位：秒。 整型。定位精度阈值。范围：1~1000；默认值：50；单位：米。 整型。平面位置精度水平。 1 低精度水平 2 中等精度水平 3 高精度水平 整型。尝试定位的次数。范围：0~1000；默认值：0；0 表示连续定位，非零 值表示尝试定位的实际次数。 整型。每次定位的时间间隔。范围：1~65535；默认值：1；单位：秒。 整型。每次定位的时间间隔。范围：100~65535；默认值：1000；单位：毫 秒。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 29 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.4. AT+QGPSEND 关闭 GNSS 该命令用于关闭 GNSS 功能。 AT+QGPSEND 关闭 GNSS 测试命令 AT+QGPSEND=? 执行命令 AT+QGPSEND 响应 OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 操作错误码。详细信息可参考第 4 章。 2.3.5. AT+QGPSLOC 获取定位信息 该命令用于获取定位信息。执行该命令前，必须通过 AT+QGPS 打开 GNSS。如果定位失败，将根据 对应情况返回+CME ERROR: 。 AT+QGPSLOC 获取定位信息 测试命令 AT+QGPSLOC=? 响应 +QGPSLOC: ,,,,,(支持的列表),,,,,< nsat> 设置命令 AT+QGPSLOC= OK 响应 +QGPSLOC: ,,,,,,,,,, OK 或者 ERROR 上海移远通信技术股份有限公司 30 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。纬度和经度显示格式。 0 ,格式：ddmm.mmmmN/S,dddmm.mmmmE/W 1 ,格式：ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W 2 ,格式：(-)dd.ddddd,(-)ddd.ddddd UTC 时间。格式：hhmmss.ss。 纬度。 如果为 0： 格式：ddmm.mmmmN/S dd 度。范围：00~89 mm.mmmm 分。范围：00.0000~59.9999 N/S 北纬/南纬 如果为 1： 格式：ddmm.mmmmmm,N/S dd 度。范围：00~89 mm.mmmmmm 分。范围：00.000000~59.999999 N/S 北纬/南纬 如果为 2： 格式：(-)dd.ddddd dd.ddddd 度。范围：-89.99999~89.99999 - 南纬 经度。 如果为 0： 格式：dddmm.mmmmE/W ddd 度。范围：000~179 mm.mmmm 分。范围：00.0000~59.9999 E/W 东经/西经 如果为 1： 格式：dddmm.mmmmmm,E/W ddd 度。范围：000~179 mm.mmmmmm 分。范围：00.000000~59.999999 E/W 东经/西经 上海移远通信技术股份有限公司 31 / 46 LTE-A(Q)系列 GNSS 应用指导 如果为 2： 格式：(-)ddd.ddddd ddd.ddddd 度。范围：-179.99999~179.99999 - 西经 水平精度因子。范围：0.5~99.9。 天线的海拔高度。单位：米。精确到小数点后一位。 整型。GNSS 定位模式。 2 2D 定位 3 3D 定位 以真北为参考基准的对地航向。格式：x.x。单位：度。范围：0.0~359.9。 对地速度。格式：x.x。单位：千米/时。精确到小数点后一位。 对地速度。格式：x.x。单位：节。精确到小数点后一位。 定位时的 UTC 时间。格式：ddmmyy。 dd 日 mm 月 yy 年 活跃卫星数量。范围：00~80，固定两位数。 操作错误码。详细信息可参考第 4 章。 2.3.6. AT+QGPSGNMEA 获取 NMEA 语句 该 命 令 用 于 获 取 NMEA 语 句 。 使 用 该 命 令 前 ， 必 须 通 过 AT+QGPS 打 开 GNSS ， 并 将 参 数 设置为 1，然后通过 AT+QGPSGNMEA 获取 NMEA 语句。 用 户 可 以 通 过 AT+QGPSCFG='gpsnmeatype',0 、 AT+QGPSCFG='glonassnmeatype',0 、 AT+QGPSCFG='galileonmeatype',0 和 AT+QGPSCFG='beidounmeatype',0 禁用语句输出。如果禁 用语句输出，依然可以通过 AT+QGPSGNMEA 获取 NMEA 语句，但前提条件是 GNSS 在激活后已经通 过此命令获得了语句。 AT+QGPSGNMEA 获取 NMEA 语句 测试命令 AT+QGPSGNMEA=? 响应 +QGPSGNMEA: (支持的列表) 设置命令 查询 GGA 语句 AT+QGPSGNMEA='GGA' OK 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 上海移远通信技术股份有限公司 32 / 46 设置命令 查询 RMC 语句 AT+QGPSGNMEA='RMC' 设置命令 查询 GSV 语句 AT+QGPSGNMEA='GSV' 设置命令 查询 GSA 语句 AT+QGPSGNMEA='GSA' 设置命令 查询 VTG 语句 AT+QGPSGNMEA='VTG' 上海移远通信技术股份有限公司 LTE-A(Q)系列 GNSS 应用指导 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 33 / 46 设置命令 查询 GNS 语句 AT+QGPSGNMEA='GNS' 最大响应时间 特性说明 LTE-A(Q)系列 GNSS 应用指导 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 NMEA 语句类型。 'GGA' GGA 语句 'RMC' RMC 语句 'GSV' GSV 语句 'GSA' GSA 语句 'VTG' VTG 语句 'GNS' GNS 语句 GGA 语句。 RMC 语句。 GSV 语句。 GSA 语句。 VTG 语句。 GNS 语句。 操作错误码。详细信息可参考第 4 章。 2.3.7. AT+QGPSXTRA 启用/禁用 XTRA 辅助功能 该命令用于启用/禁用 XTRA 辅助功能。 AT+QGPSXTRA 启用/禁用 XTRA 辅助功能 测试命令 AT+QGPSXTRA=? 响应 +QGPSXTRA: (支持的列表) 查询命令 AT+QGPSXTRA? OK 响应 +QGPSXTRA: 上海移远通信技术股份有限公司 34 / 46 LTE-A(Q)系列 GNSS 应用指导 设置命令 AT+QGPSXTRA= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。启用/禁用 XTRA 辅助功能。对于 EG06、EM06 和 EP06 系列模块，默认 禁用 XTRA 辅助功能；其他适用模块，默认启用 XTRA 辅助功能。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 2.3.8. AT+QGPSXTRATIME 注入 XTRA 时间 该命令用于将 XTRA 时间注入 GNSS 引擎。使用之前，必须通过 AT+QGPSXTRA=1 启用 XTRA 辅 助功能。激活该功能后，GNSS 引擎将会请求 XTRA 时间和辅助数据文件。在注入 XTRA 数据文件之前， 必须通过 AT+QGPSXTRATIME 注入 XTRA 时间。 AT+QGPSXTRATIME 注入 XTRA 时间 测试命令 AT+QGPSXTRATIME=? 响应 EM06、EG06 和 EP06 系列模块： +QGPSXTRATIME: ,( 支 持 的 列 表),(支持的列表), OK 其他适用模块： +QGPSXTRATIME: , 设置命令 EM06、EG06 和 EP06 系列模块： OK 响应 OK 上海移远通信技术股份有限公司 35 / 46 LTE-A(Q)系列 GNSS 应用指导 AT+QGPSXTRATIME=,[,[,,]] ERROR 设置命令 其他适用模块 AT+QGPSXTRATIME=, 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。操作类型。 0 注入 XTRA 时间 字符串类型。当前待注入的时间。对于 EM06、EG06 和 EP06 系列模块，注入的时间 类型由定义；对于其他适用模块，注入的时间类型为 UTC 时间。 格式：'YYYY/MM/DD,hh:mm:ss'。例如：'2019/01/05,08:30:30'。 整型。时间类型。 0 GPS 时间 1 UTC 时间 整型。是否强制 GNSS 子系统接受注入的时间。 0 不强制 1 强制 整型。时间的不确定性，表示向 SNTP 服务器发送请求与从 SNTP 服务器接收响应的 时间差。默认值：3500；单位：毫秒。 操作错误码。详细信息可参考第 4 章。 2.3.9. AT+QGPSXTRADATA 注入 XTRA 数据文件 该命令用于向 GNSS 引擎注入 XTRA 辅助数据文件。执行该命令前，用户需通过 AT+QGPSXTRA=1 启用 XTRA，再通过 AT+QFUPL 将有效的 XTRA 数据文件存入模块的 UFS，通过 AT+QGPSXTRATIME 将 XTRA 时间注入 GNSS 引擎。 完成上述操作后，再执行 AT+QGPSXTRADATA 将 XTRA 辅助数据文件注入 GNSS 引擎。该命令执 行成功后，可通过 AT+QFDEL 将 UFS 中的 XTRA 数据文件删除。用户可以通过 AT+QGPSXTRADATA? 查询 XTRA 数据是否注入成功。 上海移远通信技术股份有限公司 36 / 46 LTE-A(Q)系列 GNSS 应用指导 AT+QGPSXTRADATA 注入 XTRA 数据文件 测试命令 AT+QGPSXTRADATA=? 响应 +QGPSXTRADATA: 查询命令 查询 XTRA 数据文件的状态 AT+QGPSXTRADATA? OK 响应 +QGPSXTRADATA: , OK 或者 ERROR 设置命令 AT+QGPSXTRADATA= 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 1秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 字符串类型。待注入的 XTRA 数据文件的文件名称。如：'xtra2.bin'或 'xtra3grc.bin'。 整型。已注入的 XTRA 数据文件的有效时间。单位：分钟。 0 无 XTRA 文件或 XTRA 文件过期 1440 有效期为一天的已注入 XTRA 数据文件 4320 有效期为三天的已注入 XTRA 数据文件 10080 有效期为七天的已注入 XTRA 数据文件 字符串类型。已注入的 XTRA 数据文件有效时间的开始时间。 格式：'YYYY/MM/DD,hh:mm:ss'，如：'2016/01/03,15:34:50'。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 37 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.10. AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL 该命令用于配置 SUPL 服务器地址 URL。 AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL 测试命令 AT+QGPSSUPLURL=? 响应 +QGPSSUPLURL: 查询命令 查询当前 SUPL 服务器地址 AT+QGPSSUPLURL? 设置命令 AT+QGPSSUPLURL= OK 响应 +QGPSSUPLURL: OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 字 符串 类型。 SUPL 服务 器地 址。格 式为 ':'（端口 号可 省 略），例如'supl.server.com'、'123.123.123.123'或'supl.server.com:7275'。 当端口号省略时，默认端口为 7275。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 38 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.11. AT+QGPSSUPLCA 导入 SUPL 证书 该命令用于导入 SUPL 证书。证书文件通过 AT+QFUPL 写入文件系统。证书应由运营商或服务器提 供商提供。 AT+QGPSSUPLCA 导入 SUPL 证书 测试命令 AT+QGPSSUPLCA=? 响应 +QGPSSUPLCA: ,(支持的范围) 设置命令 AT+QGPSSUPLCA=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。SUPL 证书名称。 整型。SUPL 证书 ID。范围：0~9。默认值：0。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 39 / 46 LTE-A(Q)系列 GNSS 应用指导 3 举例 3.1. 打开与关闭 GNSS 该示例使用默认参数来打开 GNSS。打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。通过 AT+QGPSEND 可关闭 GNSS。 AT+QGPS=1 //设置 GNSS 工作模式为独立模式并打开 GNSS。 OK //打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。 AT+QGPSLOC=0 //获取定位信息。 +QGPSLOC: 061951.00,3150.7223N,11711.9293E,0.7,62.2,2,0.0,0.0,0.0,110513,09 OK AT+QGPSEND OK //关闭 GNSS。 3.2. GNSS 参数的应用 打开 GNSS 并将设为 1 后，可以直接通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc',1 //将设为 1，使能通过 AT+QGPSGNMEA 获取 NMEA 语 句。 OK AT+QGPSGNMEA='GGA' //获取 GGA 语句。 +QGPSGNMEA: $GPGGA,103647.000,3150.721154,N,11711.925873,E,1,02,4.7,59.8,M,-2.0,M,,*77 OK AT+QGPSCFG='nmeasrc',0 //将设为 0，禁用通过 AT+QGPSGNMEA 获取 NMEA 语 句。 OK AT+QGPSGNMEA='GGA' +CME ERROR: 507 //获取 GGA 语句。 //已禁用通过 AT+QGPSGNMEA 获取 NMEA 语句，因此无法获取 GGA 语句。 上海移远通信技术股份有限公司 40 / 46 LTE-A(Q)系列 GNSS 应用指导 3.3. XTRA 辅助功能的操作步骤 该示例展示了 XTRA 辅助功能的操作步骤（上传文件至 UFS 或从 UFS 删除文件的相关命令详情请参 考文档 [1]）。 AT+QGPSXTRA=1 //如果 XTRA 辅助功能被禁用，先启用 XTRA 辅助 功能，再按以下步骤操作。 OK //立即激活 XTRA 辅助功能。 //如果 XTRA 数据文件有效（可通过 AT+QGPSXTRADATA?查询），直接打开 GNSS 引擎。 //如果 XTRA 数据文件无效（可通过 AT+QGPSXTRADATA?查询），则执行以下步骤。 //用户可以通过第 1.4 章所列的 URL 将 XTRA 数据文件下载至电脑（或 MCU）。 AT+QFUPL='UFS:xtra2.bin',59748,60 //选择一份 XTRA 文件，通过 QCOM 发送命令将该 文件上传到模块内。有关 QCOM 工具的详细信 息，可参考文档 [2]。 OK AT+QGPSXTRATIME='2019/01/05,08:30:30',3500 //将 XTRA 时间注入 GNSS 引擎。需确保注入的 UTC 时间精度保持在 3.5 秒以内。 OK AT+QGPSXTRADATA='UFS:xtra2.bin' //注入 XTRA 数据文件。 OK //该 XTRA 数据文件已成功注入 GNSS 引擎。 AT+QFDEL='UFS:xtra2.bin' //从 UFS 删除 XTRA 数据文件。此步骤为可选项。 OK AT+QGPS=1 //打开 GNSS 引擎。 OK 3.4. AGNSS 功能的操作步骤 该示例展示了 AGNSS 功能的操作步骤（上传文件至 UFS 或从 UFS 删除文件的相关命令详情请参考 文档 [1]）。使用前请通过 AT+QGPSCFG='agpsposmode'开启 AGNSS 功能。 AT+QGPSDEL=0 OK AT+QGPSCFG='plane',1 OK AT+CFUN=1,1 OK AT+QGPSSUPLURL='supl.xxxx.com:7275' //删除所有辅助信息。 //设置 MO AGPS 使用 SSL 连接方式。如果所使用的服 务器不需要证书，则执行命令 AT+QGPSCFG='plane',0。 //重启模块 //设置 SUPL 服务 URL 和端口。其中 supl.xxxx.com 是 示例 URL，应替换为实际 URL；7275 为 SUPL 服务默 认端口。 上海移远通信技术股份有限公司 41 / 46 LTE-A(Q)系列 GNSS 应用指导 OK AT+QFUPL='UFS:supl.xxxx.com.der',893 //上传 CA 证书。其中 supl.xxxx.com.der 为示例 CA 证 书名，应替换为实际 CA 证书；893 为示例 CA 证书大 小，应替换为实际 CA 证书大小。如果所使用的服务器 不需要证书，则忽略该步骤。 OK AT+QGPSSUPLCA='UFS:supl.xxxx.com.der' //导入 CA 证书。其中 supl.xxxx.com.der 为示例 CA 证 书 名，应替换为实际 CA 证书。 OK AT+QFDEL='UFS:supl.xxxx.com.der' //删除 UFS 中的证书。此步骤为可选项。 OK AT+QGPS=2 //以 MSB 模式开启 GNSS。该步骤需在网络配置完成后 方可操作。开启 GNSS 后，通过模块可在 10 秒内完成 定位，如果测试时间偏差大，说明 AGNSS 未起作用。 OK 上海移远通信技术股份有限公司 42 / 46 LTE-A(Q)系列 GNSS 应用指导 4 错误代码 表示与 GNSS 操作相关的错误，详细的参数值，见下表。 表 4：错误代码列表 数值型 字符型 501 Invalid parameter(s) 502 Operation not supported 503 GNSS subsystem busy 504 Session is ongoing 505 Session not active 506 Operation timeout 507 Function not enabled 508 Time information error 509 XTRA not enabled 510 XTRA file open error 511 Bad CRC for XTRA data file 512 Validity time is out of range 513 Internal resource error 514 GNSS locked 515 End by E911 516 Not fixed now 517 CMUX port is not opened 549 Unknown error 中文解释 无效参数 操作不支持 GNSS 子系统繁忙 会话仍在进行 会话未激活 操作超时 功能未使能 时间信息错误 XTRA 功能未使能 XTRA 文件打开错误 XTRA 文件的 CRC 校验错误 超出有效期 内部资源错误 GNSS 锁住 由 E911 结束 当前未定位 CMUX 端口未打开 未知错误 上海移远通信技术股份有限公司 43 / 46 LTE-A(Q)系列 GNSS 应用指导 5 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE-A(Q)系列_FILE_应用指导 [2] Quectel_QCOM_User_Guide 表 6：术语缩写 缩写 AGPS AGNSS APN BeiDou CDMA CMUX COG CRC DOP DPO Galileo GGA GLONASS GNS 英文全称 Assisted GPS Assisted GNSS Access Point Name BeiDou Navigation Satellite System Code-Division Multiple Access Connection Multiplexing Course Over Ground Cyclic Redundancy Check Dilution of Precision Dynamic Power Optimization Galileo Satellite Navigation System Global Positioning System Fix Data Global Navigation Satellite System New GGA Message for GNSS 上海移远通信技术股份有限公司 中文全称 辅助全球定位系统 辅助全球导航卫星系统 接入点名称 北斗卫星导航系统 码分多址 串口多路复用 对地航向 循环冗余校验 精度因子 动态功率优化 伽利略卫星导航系统 全球定位系统修正数据 格洛纳斯卫星导航系统 全球导航卫星系统新的全球定位 44 / 46 GNSS GPS GSA GSM GSV HDOP HDR ID IPv4 IPv6 LBS LPP LTE MCU ME MO MS MSA MSB NMEA NVRAM PDOP PDP PPP LTE-A(Q)系列 GNSS 应用指导 系统修正数据（高通命名数据） Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 GPS DOP and Active Satellites 当前卫星信息 Global System for Mobile Communications 全球移动通信系统 Satellites in View 可见卫星 Horizontal Dilution of Precision 水平精度因子 High Data Rate 高速数据速率 Identifier 标识符 Internet Protocol version 4 第 4 版互联网协议 Internet Protocol version 6 第 6 版互联网协议 Location Based Services 基于位置的服务 LTE Positioning Protocol LTE 定位协议 Long-Term Evolution 长期演进 Micro Control Unit 微控制单元 Mobile Equipment 移动设备 Mobile-Originated 移动主叫 Mobile Station 移动终端 Mobile Station Assisted 移动终端辅助 Mobile Station Based 基于移动终端 NMEA (National Marine Electronics Association) NMEA （ 美 国 国 家 海 洋 电 子 协 0183 Interface Standard 会）0183 接口标准 Non-Volatile Random Access Memory 非易失性随机存取存储器 Position Dilution of Precision 位置精度因子 Packet Data Protocol 分组数据协议 Point to Point Protocol 点对点协议 上海移远通信技术股份有限公司 45 / 46 RMC RRC RRLP SET SNR SNTP SSL SUPL TTFF UART UFS URL USB (U)SIM UTC VDOP VTG WCDMA XTRA LTE-A(Q)系列 GNSS 应用指导 Recommended Minimum Specific GNSS Data 推荐的最少专用 GNSS 数据 Radio Resource Control 无线资源控制 Radio Resource Location Services Protocol 无线资源定位服务协议 SUPL Enabled Terminal SUPL 终端 Signal Noise Ratio 信噪比 Simple Network Time Protocol 简单网络时间协议 Secure Sockets Layer 安全套阶层 Secure User Plane Location 安全用户层面定位 Time to First Fix 第一次定位时间 Universal Asynchronous Receiver & Transmitter 通用费同步收发传输器 User File System 用户文件系统 Uniform Resource Locator 资源定位符 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module （全球）用户身份识别模块 Universal Time Code 国际标准时间码 Vertical Dilution of Precision 垂直精度因子 Course Over Ground and Ground Speed 对地航向和对地速度 Wideband Code Division Multiple Access 宽带码分多址 An Auxiliary Positioning Technology Provided by 高通提供的辅助定位技术 Qualcomm 上海移远通信技术股份有限公司 46 / 46

BG95&BG77&BG600L Series RF FTM Application Note LPWA Module Series Version: 1.2 Date: 2022-04-24 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_RF_FTM_Application_Note 1 / 21 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Series_RF_FTM_Application_Note 2 / 21 LPWA Module Series About the Document Revision History Version 1.0 1.1 1.2 Date 2020-05-28 2020-11-29 2022-04-24 Author Description Hyman DING/ Miles MA Miles MA Lane HAO Initial 1. Updated the uplink channel range for LTE B85 in AT+QRFTEST. 2. Added the applicability restrictions on LTE B26, B27 and B71 in AT+QRFTEST and AT+QRXFTM. 1. Added a note for AT+QRFTESTMODE (Chapter 2.3.1). 2. Added notes 3–5 for AT+QRFTEST (Chapter 2.3.2). 3. Updated the value range of in AT+QRFTEST (Chapter 2.3.2). 4. Added the summary of error codes (Chapter 4). BG95&BG77&BG600L_Series_RF_FTM_Application_Note 3 / 21 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 2 RF FTM AT Commands ...................................................................................................................... 7 2.1. AT Command Introduction ......................................................................................................... 7 2.1.1. Definitions........................................................................................................................ 7 2.1.2. AT Command Syntax ...................................................................................................... 7 2.2. Declaration of AT Command Examples ..................................................................................... 8 2.3. Description of RF FTM AT Commands ...................................................................................... 8 2.3.1. AT+QRFTESTMODE Enter/Exit FTM .......................................................................... 8 2.3.2. AT+QRFTEST Transmit in FTM ................................................................................... 9 2.3.3. AT+QRXFTM Receive in FTM.................................................................................... 13 3 Examples ........................................................................................................................................... 16 3.1. Set the Module into FTM.......................................................................................................... 16 3.2. Transmit in FTM ....................................................................................................................... 16 3.3. Receive in FTM ........................................................................................................................ 19 4 Summary of CME ERROR Codes .................................................................................................... 20 5 Appendix References ....................................................................................................................... 21 BG95&BG77&BG600L_Series_RF_FTM_Application_Note 4 / 21 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Types of AT Commands ................................................................................................................. 7 Table 3: Summary of CME ERROR Codes ............................................................................................... 20 Table 4: Terms and Abbreviations .............................................................................................................. 21 BG95&BG77&BG600L_Series_RF_FTM_Application_Note 5 / 21 LPWA Module Series 1 Introduction The document describes the AT commands which are used to test the receiving and transmitting performance of Quectel BG95 series, BG77 and BG600L-M3 modules under FTM (Factory Test Mode) so as to facilitate RF calibration. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS NOTE See the firmware release notes of corresponding module models to check whether the function has been supported. BG95&BG77&BG600L_Series_RF_FTM_Application_Note 6 / 21 LPWA Module Series 2 RF FTM AT Commands 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_RF_FTM_Application_Note 7 / 21 LPWA Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 2.3. Description of RF FTM AT Commands 2.3.1. AT+QRFTESTMODE Enter/Exit FTM The Write Command makes the module enter/exit FTM. AT+QRFTEST (see Chapter 2.3.2) and AT+QRXFTM (see Chapter 2.3.3) are available only when the module enters FTM with this command. AT+QRFTESTMODE Enter/Exit FTM Test Command AT+QRFTESTMODE=? Response +QRFTESTMODE: (list of supported s) Read Command AT+QRFTESTMODE? OK Response +QRFTESTMODE: Write Command AT+QRFTESTMODE= OK Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. BG95&BG77&BG600L_Series_RF_FTM_Application_Note 8 / 21 Parameter Integer type. Enter/exit FTM. 0 Exit FTM 1 Enter FTM Integer type. Error code. See Chapter 4 for details. LPWA Module Series NOTE It is recommended to reboot the module after entering FTM, otherwise the module may dump in some cases. 2.3.2. AT+QRFTEST Transmit in FTM The Write Commands force the module to transmit in FTM. AT+QRFTEST Transmit in FTM Test Command Currently only returns the parameters supported by the Write Command in GSM AT+QRFTEST=? Response +QRFTEST: ,,,, OK Write Command In GSM: AT+QRFTEST=,,, , Response ALL ON OK Or ALL OFF OK If there is any error related to ME functionality: +CME ERROR: If there is any other error: ERROR Write Command In LTE-M: AT+QRFTEST=,,, , Response ALL ON OK Or ALL OFF BG95&BG77&BG600L_Series_RF_FTM_Application_Note 9 / 21 LPWA Module Series OK If there is any error related to ME functionality: +CME ERROR: If there is any other error: ERROR Write Command In NB-IoT: AT+QRFTEST=,,, ,,,,,, Response ALL ON OK Or ALL OFF OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations is not saved. Parameter String type. Supported bands in GSM/LTE. The possible values are: For GSM: 'GSM850' 'GSM900' 'GSM1800' 'GSM1900' For LTE: 'LTE BAND1' 'LTE BAND2' 'LTE BAND3' 'LTE BAND4' 'LTE BAND5' 'LTE BAND8' 'LTE BAND12' 'LTE BAND13' BG95&BG77&BG600L_Series_RF_FTM_Application_Note 10 / 21 LPWA Module Series 'LTE BAND18' 'LTE BAND19' 'LTE BAND20' 'LTE BAND25' 'LTE BAND26' (Supported by LTE-M only) 'LTE BAND27' (Supported by LTE-M only) 'LTE BAND28' 'LTE BAND31' (Supported by BG95-M4 only) 'LTE BAND66' 'LTE BAND71' (Supported by NB-IoT only) 'LTE BAND72' (Supported by BG95-M4 only) 'LTE BAND73' (Supported by BG95-M4 only) 'LTE BAND85' Integer type. Supported uplink channels in GSM/LTE. The corresponding channels for different bands in GSM/LTE are as follows: Uplink Channels GSM band 128–251 GSM850 1–124, 975–1023 GSM900 512–885 GSM1800 512–810 GSM1900 Uplink Channels LTE band 18000–18599 LTE BAND1 18600–19199 LTE BAND2 19200–19949 LTE BAND3 19950–20399 LTE BAND4 20400–20649 LTE BAND5 21450–21799 LTE BAND8 23010–23179 LTE BAND12 23180–23279 LTE BAND13 23850–23999 LTE BAND18 24000–24149 LTE BAND19 24150–24449 LTE BAND20 26040–26689 LTE BAND25 26690–27039 LTE BAND26 (Supported by LTE-M only) 27040–27209 LTE BAND27 (Supported by LTE-M only) 27210–27659 LTE BAND28 27760–27809 LTE BAND31 (Supported by BG95-M4 only) 131972–132671 LTE BAND66 131122–133471 LTE BAND71 (Supported by NB-IoT only) 133472–133521 LTE BAND72 (Supported by BG95-M4 only) 133522–133571 LTE BAND73 (Supported by BG95-M4 only) 134002–134181 LTE BAND85 String type. Enable/disable RF Tx. BG95&BG77&BG600L_Series_RF_FTM_Application_Note 11 / 21 LPWA Module Series 'ON' Enable 'OFF' Disable Integer type. 0 Continuous Tx mode Integer type. GSM power level (GSM power in dBm × 100). Range: 0–3300. Recommended value: not exceeding 3100. Integer type. LTE power level. Range: 0–100. Recommended value: not exceeding 75. Integer type. 1 LTE modulated Tx mode Integer type. Uplink carrier frequency offset. Range: -10 to 9. Integer type. Modulation type. 0 BPSK 1 QPSK Integer type. Tx power in dBm. Range: -128 to 127. Integer type. Uplink tone bandwidth. 0 Single-tone, 3.75 kHz 1 Single-tone, 15 kHz 2 Multi-tone, 3 × 15 kHz 3 Multi-tone, 6 × 15 kHz 4 Multi-tone, 12 × 15 kHz Integer type. Tone start index. Range: 0–255. Integer type. Error code. See Chapter 4 for details. NOTE 1. Please refer to 3GPP TS 36.101 subclause 5.7.3F Carrier frequency and EARFCN for category NB1 and NB2, to calculate the specific uplink carrier frequency offset, namely, the value of . 2. In LTE-M, the bandwidth is 10 MHz by default, and cannot be configured currently. 3. When executing AT+QRFTEST Write Commands consecutively for forced Tx tests in different RATs, it is recommended to reboot the module before switching to another RAT. 4. For different module models, the value of during mid-frequency band tests and low-frequency band tests is as follows: Model Mid-frequency Bands BG95-M1/BG95-M2/BG95-M3/BG95-MF ≤ 65 /BG77/BG600L-M3 BG95-M4 ≤ 63 (excluding LTE B31, B72 and B73) BG95-M4 (LTE B31, B72 and B73 only) BG95-M5 ≤ 68 Low-frequency Bands ≤ 74 ≤ 73 ≤ 65 ≤ 66 BG95-M6 ≤ 59 ≤ 66 BG95&BG77&BG600L_Series_RF_FTM_Application_Note 12 / 21 LPWA Module Series 2.3.3. AT+QRXFTM Receive in FTM The Write Command forces the module to receive in FTM. AT+QRXFTM Receive in FTM Test Command AT+QRXFTM=? Response +QRXFTM: ,,,,, Read Command AT+QRXFTM? Write Command AT+QRXFTM=,,[,[,[,]]] OK Response OK Response +QRXFTM: , OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 3000 ms The command takes effect immediately. The configurations is not saved. Parameter Integer type. 1 LTE Rx test String type. Supported bands in GSM/LTE. The possible values are: For GSM: 'GSM850' 'GSM900' 'GSM1800' 'GSM1900' For LTE: 'LTE BAND1' 'LTE BAND2' 'LTE BAND3' 'LTE BAND4' 'LTE BAND5' BG95&BG77&BG600L_Series_RF_FTM_Application_Note 13 / 21 LPWA Module Series 'LTE BAND8' 'LTE BAND12' 'LTE BAND13' 'LTE BAND18' 'LTE BAND19' 'LTE BAND20' 'LTE BAND25' 'LTE BAND26' (Supported by LTE-M only) 'LTE BAND27' (Supported by LTE-M only) 'LTE BAND28' 'LTE BAND31' (Supported by BG95-M4 only) 'LTE BAND66' 'LTE BAND71' (Supported by NB-IoT only) 'LTE BAND72' (Supported by BG95-M4 only) 'LTE BAND73' (Supported by BG95-M4 only) 'LTE BAND85' Integer type. Supported downlink channels in GSM/LTE. The corresponding channels for different bands in GSM/LTE are as follows: Downlink Channels GSM band 128–251 GSM850 1–124, 975–1023 GSM900 512–885 GSM1800 512–810 GSM1900 Downlink Channels 0–599 600–1199 1200–1949 1950–2399 2400–2649 3450–3799 5010–5179 5180–5279 5850–5999 6000–6149 6150–6449 8040–8689 8690–9039 9040–9209 9210–9659 9870–9919 66436–67335 68586–68935 68936–68985 LTE band LTE BAND1 LTE BAND2 LTE BAND3 LTE BAND4 LTE BAND5 LTE BAND8 LTE BAND12 LTE BAND13 LTE BAND18 LTE BAND19 LTE BAND20 LTE BAND25 LTE BAND26 (Supported by LTE-M only) LTE BAND27 (Supported by LTE-M only) LTE BAND28 LTE BAND31 (Supported by BG95-M4 only) LTE BAND66 LTE BAND71 (Supported by NB-IoT only) LTE BAND72 (Supported by BG95-M4 only) BG95&BG77&BG600L_Series_RF_FTM_Application_Note 14 / 21 LPWA Module Series 68986–69035 LTE BAND73 (Supported by BG95-M4 only) 70366–70545 LTE BAND85 Integer type. 0 Main antenna path. Integer type. Gain stage. Range: 0–5. Integer type. Bandwidth. Range: 0–5. This parameter is only valid for LTE RAT (that is, not applicable for GSM RAT). 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz Integer type. The value of received power. Integer type. Received power level in dBm converted from . Integer type. Error code. See Chapter 4 for details. NOTE 1. The Write Command responses are instantaneous values. 2. Currently, this command only supports LTE Rx test in FTM. 3. In LTE RAT, the value of equals to / 10. BG95&BG77&BG600L_Series_RF_FTM_Application_Note 15 / 21 LPWA Module Series 3 Examples 3.1. Set the Module into FTM AT+QRFTESTMODE=? +QRFTESTMODE: (0,1) OK AT+QRFTESTMODE=1 OK //After the module reboots AT+QRFTESTMODE? +QRFTESTMODE: 1 OK AT+QRFTESTMODE=0 OK AT+QRFTESTMODE? +QRFTESTMODE: 0 OK //Test command //Enter FTM //Query the current FTM state of the module //Exit FTM //Query the current FTM state of the module 3.2. Transmit in FTM AT+QRFTESTMODE=1 OK //After the module reboots //In GSM RAT AT+QRFTEST='GSM900',122,'ON',0,100 ALL ON OK AT+QRFTEST='GSM900',122,'OFF',0,100 //Enter FTM //Enable RF Tx on 122 channel of GSM900 //Disable RF Tx on 122 channel of GSM900 BG95&BG77&BG600L_Series_RF_FTM_Application_Note 16 / 21 LPWA Module Series ALL OFF OK //After the module reboots //In LTE-M RAT AT+QRFTEST='LTE BAND1',18300,'ON',50,1 ALL ON //Enable RF Tx on 18300 channel of LTE B1 OK AT+QRFTEST='LTE BAND1',18300,'OFF',50,1 ALL OFF //Disable RF Tx on 18300 channel of LTE B1 OK AT+QRFTEST='LTE BAND2',18900,'ON',50,1 ALL ON //Enable RF Tx on 18900 channel of LTE B2 OK AT+QRFTEST='LTE BAND2',18900,'OFF',50,1 ALL OFF //Disable RF Tx on 18900 channel of LTE B2 OK AT+QRFTEST='LTE BAND12',23095,'ON',50,1 ALL ON //Enable RF Tx on 23095 channel of LTE B12 OK AT+QRFTEST='LTE BAND12',23095,'OFF',50,1 ALL OFF //Disable RF Tx on 23095 channel of LTE B12 OK AT+QRFTEST='LTE BAND20',24300,'ON',50,1 ALL ON //Enable RF Tx on 24300 channel of LTE B20 OK AT+QRFTEST='LTE BAND20',24300,'OFF',50,1 ALL OFF //Disable RF Tx on 24300 channel of LTE B20 OK AT+QRFTEST='LTE BAND28',27435,'ON',50,1 ALL ON //Enable RF Tx on 27435 channel of LTE B28 OK AT+QRFTEST='LTE BAND28',27435,'OFF',50,1 ALL OFF //Disable RF Tx on 27435 channel of LTE B28 BG95&BG77&BG600L_Series_RF_FTM_Application_Note 17 / 21 LPWA Module Series OK //After the module reboots //In NB-IoT RAT AT+QRFTEST='LTE BAND1',18300,'ON',50,1,100,0,50,4,0 ALL ON //Enable RF Tx on 18300 channel of LTE B1 OK AT+QRFTEST='LTE BAND1',18300,'OFF',50,1,100,0,50,4,0 ALL OFF //Disable RF Tx on 18300 channel of LTE B1 OK AT+QRFTEST='LTE BAND2',18900,'ON',50,1,100,0,50,4,0 ALL ON //Enable RF Tx on 18900 channel of LTE B2 OK AT+QRFTEST='LTE BAND2',18900,'OFF',50,1,100,0,50,4,0 ALL OFF //Disable RF Tx on 18900 channel of LTE B2 OK AT+QRFTEST='LTE BAND20',24300,'ON',50,1,100,0,50,4,0 ALL ON //Enable RF Tx on 24300 channel of LTE B20 OK AT+QRFTEST='LTE BAND20',24300,'OFF',50,1,100,0,50,4,0 ALL OFF //Disable RF Tx on 24300 channel of LTE B20 OK AT+QRFTEST='LTE BAND28',27435,'ON',50,1,100,0,50,4,0 ALL ON //Enable RF Tx on 27435 channel of LTE B28 OK AT+QRFTEST='LTE BAND28',27435,'OFF',50,1,100,0,50,4,0 ALL OFF //Disable RF Tx on 27435 channel of LTE B28 BG95&BG77&BG600L_Series_RF_FTM_Application_Note 18 / 21 OK AT+QRFTESTMODE=0 OK LPWA Module Series //Exit FTM 3.3. Receive in FTM AT+QRFTESTMODE=1 OK //After the module reboots //In LTE RAT AT+QRXFTM=1,'LTE BAND1',300,0,0,0 +QRXFTM: -1100,-110 //Enter FTM //Enable RF Rx on 300 channel of LTE B1 OK AT+QRXFTM=1,'LTE BAND2',900,0,0,0 +QRXFTM: -1100,-110 //Enable RF Rx on 900 channel of LTE B2 OK AT+QRXFTM=1,'LTE BAND12',5095,0,0,0 +QRXFTM: -1100,-110 //Enable RF Rx on 5095 channel of LTE B12 OK AT+QRXFTM=1,'LTE BAND20',6300,0,0,0 +QRXFTM: -1100, -110 //Enable RF Rx on 6300 channel of LTE B20 OK AT+QRXFTM=1,'LTE BAND28',9435,0,0,0 +QRXFTM: -1100,-110 //Enable RF Rx on 9435 channel of LTE B28 OK AT+QRFTESTMODE=0 OK //Exit FTM BG95&BG77&BG600L_Series_RF_FTM_Application_Note 19 / 21 LPWA Module Series 4 Summary of CME ERROR Codes The CME ERROR: indicates an error related to mobile equipment or network. The details about are described in the following table. Table 3: Summary of CME ERROR Codes 3 323 Meaning Operation not allowed Invalid input parameter BG95&BG77&BG600L_Series_RF_FTM_Application_Note 20 / 21 LPWA Module Series 5 Appendix References Table 4: Terms and Abbreviations Abbreviation BPSK LTE-M FTM GSM LPWA LTE NB-IoT QPSK RAT RF Rx Tx Description Binary Phase Shift Keying LTE-MTC (Machine Type Communication) Factory Test Mode Global System for Mobile Communications Low-Power Wide-Area Long Term Evolution Narrowband Internet of Things Quadrature Phase Shift Keying Radio Access Technology Radio Frequency Receive Transmit BG95&BG77&BG600L_Series_RF_FTM_Application_Note 21 / 21

BG95&BG77&BG600L Series eDRX Application Note LPWA Module Series Version: 1.0 Date: 2022-02-25 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_eDRX_Application_Note 1 / 26 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Series_eDRX_Application_Note 2 / 26 About the Document LPWA Module Series Revision History Version Date Author Description - 2021-12-10 Lane HAO Creation of the document 1.0 2022-02-25 Lane HAO First official release BG95&BG77&BG600L_Series_eDRX_Application_Note 3 / 26 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 2 Description of eDRX Feature ............................................................................................................. 7 3 eDRX Related AT Commands ............................................................................................................ 8 3.1. AT Command Introduction ......................................................................................................... 8 3.1.1. Definitions........................................................................................................................ 8 3.1.2. AT Command Syntax ...................................................................................................... 8 3.2. Declaration of AT Command Examples ..................................................................................... 9 3.3. Description of AT Commands .................................................................................................... 9 3.3.1. AT+CEDRXS eDRX Setting ......................................................................................... 9 3.3.2. AT+QPTWEDRXS Paging Time Window Value and eDRX Setting .......................... 12 3.3.3. AT+CEDRXRDP Read Dynamic Parameters ............................................................ 16 4 FAQ..................................................................................................................................................... 20 5 Summary of Error Codes ................................................................................................................. 23 6 Appendix References ....................................................................................................................... 25 BG95&BG77&BG600L_Series_eDRX_Application_Note 4 / 26 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Types of AT Commands ................................................................................................................. 8 Table 3: Summary of CME ERROR Codes ............................................................................................... 23 Table 4: Related Documents ...................................................................................................................... 25 Table 5: Terms and Abbreviations .............................................................................................................. 25 BG95&BG77&BG600L_Series_eDRX_Application_Note 5 / 26 LPWA Module Series 1 Introduction This document introduces the extended Idle Discontinuous Reception (e-I-DRX) feature and explains how to use the e-I-DRX feature of Quectel BG95 series, BG77 and BG600L-M3 modules. e-I-DRX is also known as eDRX. To simplify the description, eDRX will be used in this application note. 1.1. Applicable Modules Table 1: Applicable Modules Module Series BG95 BG77 BG600L-M3 Model BG95-M1 BG95-M2 BG95-M3 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_eDRX_Application_Note 6 / 26 LPWA Module Series 2 Description of eDRX Feature eDRX is introduced in 3GPP Release 13. It is an extension of the DRX feature used by IoT devices to reduce power consumption. DRX is a mechanism that puts a device to sleep and then wakes it up after a fixed interval to receive downlink data. The basic principle of eDRX is to extend idle mode DRX cycles to allow the device to remain in a power-saving state for a longer period of time. Applications that want to use extended idle mode DRX need to consider specific handling of mobile terminating services or data transfers, and in particular they need to consider the delay tolerance of mobile terminated data. A network side application may send mobile terminated data, an SMS, or a device trigger, and needs to be aware that extended idle mode DRX may be in place. A UE should request for extended idle mode DRX only when all expected mobile terminating communication is tolerant to delay. 1) The eDRX parameters include paging time window (PTW) and eDRX cycle. UE should set expected extended DRX parameters IE in an Attach Request or Tracking Area Update Request message to indicate that UE supports the idle eDRX feature. If the network supports eDRX feature, it sends the corresponding eDRX parameter values in the Attach Accept or Tracking Area Update Accept message to the UE. Regarding eMTC network, it should contain 'eDRX-Allowed-r13 true' IE in the system information, otherwise, it should be considered that it does not support eDRX feature. PTW eDRX Cycle DRX Cycle Decode the paging message CONNECTED Mode Figure 1: Function Overview NOTE 1. 1) Quoted from 3GPP TS 23.682 technical specification. For more information on eDRX mode, see 3GPP TS 23.682, clause 4.5.13 Extended idle mode DRX. 2. The PTW is not started by receiving RRC release; it starts from the next PO (Paging Occasion). About how to calculate PO, it is mainly determined by UE_ID (IMSI). For more details, see 3GPP TS36.304, clause 7 Paging. BG95&BG77&BG600L_Series_eDRX_Application_Note 7 / 26 LPWA Module Series 3 eDRX Related AT Commands 3.1. AT Command Introduction 3.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_eDRX_Application_Note 8 / 26 LPWA Module Series 3.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 3.3. Description of AT Commands 3.3.1. AT+CEDRXS eDRX Setting This command controls the setting of the UE’s eDRX (extended DRX) parameters. AT+CEDRXS Test Command AT+CEDRXS=? eDRX Setting Response +CEDRXS: (range of supported s),(list of supported < AcT-type>s),(range of supported s) Read Command AT+CEDRXS? OK Response +CEDRXS: [,] [+CEDRXS: [,] [...]] Write Command AT+CEDRXS=[,[,]] Maximum Response Time Characteristics Reference 3GPP TS 27.007 OK Response OK If there is any other error: ERROR 300 ms This command takes effect immediately. The configuration will be saved automatically. BG95&BG77&BG600L_Series_eDRX_Application_Note 9 / 26 LPWA Module Series Parameter Integer type. Disable or enable the use of eDRX in the UE. 0 Disable the use of eDRX 1 Enable the use of eDRX 2 Enable the use of eDRX and enable the URC +CEDRXP: [,[,[,]]] 3 Disable the use of eDRX and discard all eDRX parameters or, if available, reset to the default values Integer type. The type of access technology. 0 Access technology is not using eDRX. This parameter value is only used in the URC. 4 eMTC 5 NB-IoT String type. Half a byte in a 4-bit format. bit Description 4 321 E-UTRAN eDRX cycle 0 000 5.12 seconds 0 001 10.24 seconds 0 010 20.48 seconds 0 011 40.96 seconds 0 100 61.44 seconds 0 101 81.92 seconds 0 110 102.4 seconds 0 111 122.88 seconds 1 000 143.36 seconds 1 001 163.84 seconds 1 010 327.68 seconds 1 011 655.36 seconds 1 100 1310.72 seconds 1 101 2621.44 seconds 1 110 5242.88 seconds 1 111 10485.76 seconds String type. Half a byte in a 4-bit format. bit Description 4 321 E-UTRAN eDRX cycle 0 000 5.12 seconds 0 001 10.24 seconds 0 010 20.48 seconds 0 011 40.96 seconds 0 100 61.44 seconds 0 101 81.92 seconds 0 110 102.4 seconds 0 111 122.88 seconds BG95&BG77&BG600L_Series_eDRX_Application_Note 10 / 26 LPWA Module Series 1 000 143.36 seconds 1 001 163.84 seconds 1 010 327.68 seconds 1 011 655,36 seconds 1 100 1310.72 seconds 1 101 2621.44 seconds 1 110 5242.88 seconds 1 111 10485.76 seconds String type. Half a byte in a 4-bit format. eMTC mode bit Description 4 321 Paging Time Window length 0 000 1.28 seconds 0 001 2.56 seconds 0 010 3.84 seconds 0 011 5.12 seconds 0 100 6.4 seconds 0 101 7.68 seconds 0 110 8.96 seconds 0 111 10.24 seconds 1 000 11.52 seconds 1 001 12.8 seconds 1 010 14.08 seconds 1 011 15.36 seconds 1 100 16.64 seconds 1 101 17.92 seconds 1 110 19.20 seconds 1 111 20.48 seconds NB-IoT mode bit Description 4 321 Paging Time Window length 0 000 2.56 seconds 0 001 5.12 seconds 0 010 7.68 seconds 0 011 10.24 seconds 0 100 12.8 seconds 0 101 15.36 seconds 0 110 17.92 seconds 0 111 20.48 seconds 1 000 23.04 seconds 1 001 25.6 seconds 1 010 28.16 seconds 1 011 30.72 seconds 1 100 33.28 seconds BG95&BG77&BG600L_Series_eDRX_Application_Note 11 / 26 LPWA Module Series 1 101 1 110 1 111 35.84 seconds 38.4 seconds 40.96 seconds Example AT+CEDRXS=1,4,'0000' OK AT+CEDRXS=0,4 OK AT+CEDRXS=2,4,'0000' OK +CEDRXP: 4,'0000','0000','0000' //Set the requested eDRX cycle to 5.12 seconds. //Disable eDRX function. //Set the requested eDRX cycle to 5.12 seconds and enable the URC. //Network accepted the eDRX parameters. 3.3.2. AT+QPTWEDRXS Paging Time Window Value and eDRX Setting This command controls the setting of the UE's paging time window (PTW) value and eDRX parameters, whether the UE wants to apply PTW and eDRX or not, as well as the requested PTW and eDRX cycle for each specified type of access technology. It also controls the presentation of the URC +QPTWEDRXP: [,[,[,[,]]]] when =2 and there is a change in the paging time window and eDRX parameters provided by the network. A special form of the command can be given as AT+QPTWEDRXS=3. In this form, PTW and eDRX are disabled and data for all parameters in AT+QPTWEDRXS are removed or, if available, set to the default values. The Read Command returns the current settings for each defined value of . The Test Command returns the supported s and the value ranges for the access technology and the requested PTW and requested eDRX value as compound values. AT+QPTWEDRXS Paging Time Window Value and eDRX Setting Test Command AT+QPTWEDRXS=? Response +QPTWEDRXS: (range of supported s),(list of supported s),(range of supported s),(range of supported s) OK BG95&BG77&BG600L_Series_eDRX_Application_Note 12 / 26 LPWA Module Series Read Command AT+QPTWEDRXS? Response +QPTWEDRXS: [,,[,[,]]] […] OK If there is any error: +CME ERROR: Write Command AT+QPTWEDRXS=[,[, [,]]] If there is any other error: ERROR Response OK If there is any error: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms This command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Disable or enable the use of requested PTW and eDRX in the UE. This parameter is applicable to all specified types of access technology, i.e., the most recent setting of will take effect for all specified values of returned with AT+QNWINFO. For more details about the AT command, see document [3]. 0 Disable the use of requested PTW and eDRX feature 1 Enable the use of requested PTW and eDRX feature 2 Enable the use of requested PTW and eDRX, and enable the URC: +QPTWEDRXP: [,[,< Requested_eDRX_value>[,[,]]]] 3 Disable the use of eDRX and discard all eDRX parameters or, if available, reset to the default values. Integer type. The type of access technology. This AT command specifies the relationship between the type of access technology and the requested eDRX value. BG95&BG77&BG600L_Series_eDRX_Application_Note 13 / 26 LPWA Module Series 0 Access technology is not using eDRX. This parameter value is only used in the URC. 4 eMTC 5 NB-IoT String type. Half a byte in a 4-bit format. eMTC mode bit Description 4 3 2 1 Paging Time Window length 0 0 0 0 1.28 seconds 0 0 0 1 2.56 seconds 0 0 1 0 3.84 seconds 0 0 1 1 5.12 seconds 0 1 0 0 6.4 seconds 0 1 0 1 7.68 seconds 0 1 1 0 8.96 seconds 0 1 1 1 10.24 seconds 1 0 0 0 11.52 seconds 1 0 0 1 12.8 seconds 1 0 1 0 14.08 seconds 1 0 1 1 15.36 seconds 1 1 0 0 16.64 seconds 1 1 0 1 17.92 seconds 1 1 1 0 19.20 seconds 1 1 1 1 20.48 seconds NB-IoT mode bit Description 4 3 2 1 Paging Time Window length 0 0 0 0 2.56 seconds 0 0 0 1 5.12 seconds 0 0 1 0 7.68 seconds 0 0 1 1 10.24 seconds 0 1 0 0 12.8 seconds 0 1 0 1 15.36 seconds 0 1 1 0 17.92 seconds 0 1 1 1 20.48 seconds 1 0 0 0 23.04 seconds 1 0 0 1 25.6 seconds 1 0 1 0 28.16 seconds 1 0 1 1 30.72 seconds 1 1 0 0 33.28 seconds 1 1 0 1 35.84 seconds 1 1 1 0 38.4 seconds 1 1 1 1 40.96 seconds String type. Half a byte in a 4-bit format. BG95&BG77&BG600L_Series_eDRX_Application_Note 14 / 26 LPWA Module Series bit Description 4 3 2 1 E-UTRAN eDRX cycle 0 0 0 0 5.12 seconds 0 0 0 1 10.24 seconds 0 0 1 0 20.48 seconds 0 0 1 1 40.96 seconds 0 1 0 0 61.44 seconds 0 1 0 1 81.92 seconds 0 1 1 0 102.4 seconds 0 1 1 1 122.88 seconds 1 0 0 0 143.36 seconds 1 0 0 1 163.84 seconds 1 0 1 0 327.68 seconds 1 0 1 1 655.36 seconds 1 1 0 0 1310.72 seconds 1 1 0 1 2621.44 seconds 1 1 1 0 5242.88 seconds 1 1 1 1 10485.76 seconds String type. Half a byte in a 4-bit format. bit Description 4 3 2 1 E-UTRAN eDRX cycle 0 0 0 0 5.12 seconds 0 0 0 1 10.24 seconds 0 0 1 0 20.48 seconds 0 0 1 1 40.96 seconds 0 1 0 0 61.44 seconds 0 1 0 1 81.92 seconds 0 1 1 0 102.4 seconds 0 1 1 1 122.88 seconds 1 0 0 0 143.36 seconds 1 0 0 1 163.84 seconds 1 0 1 0 327.68 seconds 1 0 1 1 655.36 seconds 1 1 0 0 1310.72 seconds 1 1 0 1 2621.44 seconds 1 1 1 0 5242.88 seconds 1 1 1 1 10485.76 seconds String type. Half a byte in a 4-bit format. eMTC mode bit Description 4 3 2 1 Paging Time Window length 0 0 0 0 1.28 seconds 0 0 0 1 2.56 seconds 0 0 1 0 3.84 seconds BG95&BG77&BG600L_Series_eDRX_Application_Note 15 / 26 LPWA Module Series 0 0 1 1 5.12 seconds 0 1 0 0 6.4 seconds 0 1 0 1 7.68 seconds 0 1 1 0 8.96 seconds 0 1 1 1 10.24 seconds 1 0 0 0 11.52 seconds 1 0 0 1 12.8 seconds 1 0 1 0 14.08 seconds 1 0 1 1 15.36 seconds 1 1 0 0 16.64 seconds 1 1 0 1 17.92 seconds 1 1 1 0 19.20 seconds 1 1 1 1 20.48 seconds NB-IoT mode bit Description 4 3 2 1 Paging Time Window length 0 0 0 0 2.56 seconds 0 0 0 1 5.12 seconds 0 0 1 0 7.68 seconds 0 0 1 1 10.24 seconds 0 1 0 0 12.8 seconds 0 1 0 1 15.36 seconds 0 1 1 0 17.92 seconds 0 1 1 1 20.48 seconds 1 0 0 0 23.04 seconds 1 0 0 1 25.6 seconds 1 0 1 0 28.16 seconds 1 0 1 1 30.72 seconds 1 1 0 0 33.28 seconds 1 1 0 1 35.84 seconds 1 1 1 0 38.4 seconds 1 1 1 1 40.96 seconds Error codes. For more details, see Chapter 5. 3.3.3. AT+CEDRXRDP Read Dynamic Parameters The Execution Command returns +CEDRXRDP: [,[,[,]]] if eDRX is used for the cell that the MS is currently registered to. AT+CEDRXRDP Read Dynamic Parameters Test Command AT+CEDRXRDP=? Response OK BG95&BG77&BG600L_Series_eDRX_Application_Note 16 / 26 LPWA Module Series Execution Command AT+CEDRXRDP Maximum Response Time Characteristics Reference 3GPP TS 27.007 Response +CEDRXRDP: [,[,[,]]] OK 300 ms / Parameter Integer type. The type of access technology. 0 Access technology is not using eDRX 4 eMTC 5 NB-IoT String type. Half a byte in a 4-bit format. bit Description 4 321 E-UTRAN eDRX cycle 0 000 5.12 seconds 0 001 10.24 seconds 0 010 20.48 seconds 0 011 40.96 seconds 0 100 61.44 seconds 0 101 81.92 seconds 0 110 102.4 seconds 0 111 122.88 seconds 1 000 143.36 seconds 1 001 163.84 seconds 1 010 327.68 seconds 1 011 655,36 seconds 1 100 1310.72 seconds 1 101 2621.44 seconds 1 110 5242.88 seconds 1 111 10485.76 seconds String type. Half a byte in a 4-bit format. bit Description 4 321 E-UTRAN eDRX cycle 0 000 5.12 seconds 0 001 10.24 seconds 0 010 20.48 seconds 0 011 40.96 seconds 0 100 61.44 seconds BG95&BG77&BG600L_Series_eDRX_Application_Note 17 / 26 LPWA Module Series 0 101 81.92 seconds 0 110 102.4 seconds 0 111 122.88 seconds 1 000 143.36 seconds 1 001 163.84 seconds 1 010 327.68 seconds 1 011 655,36 seconds 1 100 1310.72 seconds 1 101 2621.44 seconds 1 110 5242.88 seconds 1 111 10485.76 seconds String type. Half a byte in a 4-bit format. eMTC mode bit Description 4 321 Paging Time Window length 0 000 1.28 seconds 0 001 2.56 seconds 0 010 3.84 seconds 0 011 5.12 seconds 0 100 6.4 seconds 0 101 7.68 seconds 0 110 8.96 seconds 0 111 10.24 seconds 1 000 11.52 seconds 1 001 12.8 seconds 1 010 14.08 seconds 1 011 15.36 seconds 1 100 16.64 seconds 1 101 17.92 seconds 1 110 19.20 seconds 1 111 20.48 seconds NB-IoT mode bit Description 4 321 Paging Time Window length 0 000 2.56 seconds 0 001 5.12 seconds 0 010 7.68 seconds 0 011 10.24 seconds 0 100 12.8 seconds 0 101 15.36 seconds 0 110 17.92 seconds 0 111 20.48 seconds 1 000 23.04 seconds 1 001 25.6 seconds BG95&BG77&BG600L_Series_eDRX_Application_Note 18 / 26 LPWA Module Series 1 010 1 011 1 100 1 101 1 110 1 111 28.16 seconds 30.72 seconds 33.28 seconds 35.84 seconds 38.4 seconds 40.96 seconds Example AT+CEDRXS=1,4,'0000' OK AT+CEDRXRDP +CEDRXRDP: 4,'0000','0000','0000' //Set the requested eDRX cycle to 5.12 seconds. //Network accepted the eDRX parameters. OK AT+CEDRXS=0,4 OK AT+CEDRXRDP +CEDRXRDP: 0 //Disable eDRX feature. //Access technology is not using eDRX. OK BG95&BG77&BG600L_Series_eDRX_Application_Note 19 / 26 LPWA Module Series 4 FAQ This chapter contains some typical issues and provides corresponding answer. 1. Q: Can the module use eDRX without enabling PSM? A: The eDRX can be enabled without enabling the PSM. 2. Q: How to check the eDRX value used by the module? A: Execute AT+CEDRXRDP to query the eDRX value used by the module. 3. Q: Does the PTW start from the moment it receives RRC release message? A: No. It starts from next PO (Paging Occasion), after the module registers the network. Every PO can be calculated by the module. 4. Q: Does the eDRX cause downlink data delay? A: Yes. Enabling the eDRX feature will make the module go into sleep mode and then wake up after a fixed interval to receive downlink data. Network does not send downlink data during eDRX idle status. 5. Q: Why can’t the module use eDRX even though the module requested eDRX values and the network assigned eDRX values? A: Regarding eMTC network, 'eDRX-Allowed-r13 true' IE should be included in the system information, otherwise, it should be considered that it does not support eDRX feature. BG95&BG77&BG600L_Series_eDRX_Application_Note 20 / 26 LPWA Module Series 6. Q: How to check the eDRX status in the QXDM log? A: 1) UE sets eDRX parameters (PTW: 1.28 s; eDRX cycle: 40.96 s) in Attach Request Msg. 2) Network assigns the eDRX parameter (PTW: 2.56 s; eDRX cycle: 40.96 s) in Attach Accept Msg. 3) UE received the RRCConnectionRelease message. 4) UE calculates the next PF/PO, then enters sleep mode and wakes up before the next PTW arrives. BG95&BG77&BG600L_Series_eDRX_Application_Note 21 / 26 5) UE wakes up to decode paging message when PF/PO arrives. LPWA Module Series 6) If no paging message is received, UE waits for the next PF/PO. BG95&BG77&BG600L_Series_eDRX_Application_Note 22 / 26 LPWA Module Series 5 Summary of Error Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation of +CME ERROR: final result code is similar to the regular ERROR result code: if +CME ERROR: is the result code for any of the commands in a command line, none of the following commands in the same command line is executed (neither ERROR nor OK result code shall be returned as a result of a completed command line execution). The format of can be either numeric or verbose. This is set with AT+CMEE. The following table lists most general and GRPS related ERROR codes. For some GSM protocol failure causes described in GSM specifications, the corresponding ERROR codes are not included. Table 3: Summary of CME ERROR Codes Numeric Value 0 1 2 3 4 5 6 7 10 11 12 13 14 Verbose Value phone failure no connection to phone phone-adaptor link reserved operation not allowed operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required SIM not inserted SIM PIN required SIM PUK required SIM failure SIM busy BG95&BG77&BG600L_Series_eDRX_Application_Note 23 / 26 LPWA Module Series 15 SIM wrong 16 incorrect password 17 SIM PIN2 required 18 SIM PUK2 required 20 memory full 21 invalid index 22 not found 23 memory failure 24 text string too long 25 invalid characters in text string 26 dial string too long 27 invalid characters in dial string 30 no network service 31 network timeout 32 network not allowed - emergency calls only 40 network personalization PIN required 41 network personalization PUK required 42 network subset personalization PIN required 43 network subset personalization PUK required 44 service provider personalization PIN required 45 service provider personalization PUK required 46 corporate personalization PIN required 47 corporate personalization PUK required BG95&BG77&BG600L_Series_eDRX_Application_Note 24 / 26 LPWA Module Series 6 Appendix References Table 4: Related Documents Document Name [1] 3GPP TS 23.682 3rd Generation Partnership Project; Technical Specification Group Services and System Aspects; Architecture enhancements to facilitate communications with packet data networks and applications [2] 3GPP TS36.304 3rd Generation Partnership Project; Technical Specification Group Radio Access Network; Evolved Universal Terrestrial Radio Access (E-UTRA); User Equipment (UE) procedures in idle mode [3] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual Table 5: Terms and Abbreviations Abbreviation 3GPP DRX eDRX EGPRS eMTC E-UTRAN IE IMSI IoT Description 3rd Generation Partnership Project Discontinuous Reception Extended Discontinuous Reception Enhanced General Packet Radio Service Enhanced Machine-Type Communication Evolved Universal Terrestrial Radio Access Network Item Element International Mobile Subscriber Identity Internet of Things BG95&BG77&BG600L_Series_eDRX_Application_Note 25 / 26 MS NB-IoT PIN PO PF PSM PTW PUK RRC SMS UE URC (U)SIM Wi-Fi Mobile Station Narrowband Internet of Things Personal Identification Number Paging Occasion Paging Frame Power Saving Mode Paging Time Window PIN Unlock Key Radio Resource Control Short Message Service User Equipment Unsolicited Result Code Universal Subscriber Identity Module Wireless Fidelity LPWA Module Series BG95&BG77&BG600L_Series_eDRX_Application_Note 26 / 26

BG95&BG77&BG600L Series Jamming Detection Application Note LPWA Module Series Version: 1.0 Date: 2021-08-04 Status: Released LPWA Module Series Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 1 / 18 LPWA Module Series Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 2 / 18 LPWA Module Series About the Document Revision History Version Date Author - 2021-07-01 Lane HAO 1.0 2021-08-04 Lane HAO Description Creation of the document First official release BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 3 / 18 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 2 Jamming Detection Overview............................................................................................................ 7 2.1. Application Overview ................................................................................................................. 7 3 Description of AT Commands ........................................................................................................... 8 3.1. AT Command Introduction ......................................................................................................... 8 3.1.1. Definitions...................................................................................................................... 8 3.1.2. AT Command Syntax .................................................................................................... 8 3.2. Declaration of AT Command Examples ..................................................................................... 9 3.3. AT Command Description .......................................................................................................... 9 3.3.1. AT+QJDR Enable/Disable Jamming Detection............................................................ 9 3.3.2. AT+QJDCFG Jamming Detection Configuration........................................................ 10 3.4. URC Description ...................................................................................................................... 13 3.4.1. Indicate the Presence of Jamming ............................................................................... 13 3.4.2. Indicate the Removal of Jamming................................................................................. 13 4 Examples ........................................................................................................................................... 14 4.1. Report the Jamming Status via URC....................................................................................... 14 4.2. Report the Jamming Status via URC Periodically ................................................................... 15 4.3. Enable and Disable Jamming Detection.................................................................................. 15 4.4. Configure Jamming Detection ................................................................................................. 16 5 Appendix References ....................................................................................................................... 18 BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 4 / 18 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Types of AT Commands ................................................................................................................ 8 Table 3: Related Document........................................................................................................................ 18 Table 4: Terms and Abbreviations .............................................................................................................. 18 BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 5 / 18 LPWA Module Series 1 Introduction A cellular communication jammer can totally paralyze all kinds of mobile and portable devices working in cellular frequency bands. Quectel BG95 series, BG77 and BG600L-M3 modules offer jamming detection function which allows the unit to sense attempts to disrupt the GSM/LTE Cat M1/LTE Cat NB2 communication by interference with the signals. The sophisticated jamming detection enables enhanced security features and immediate alarm notification if communication interference is detected. This document gives a detailed explanation on how to use the Jamming Detection function of the following Quectel modules. Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 6 / 18 LPWA Module Series 2 Jamming Detection Overview Quectel Jamming Detection allows modules to identify active jamming of GSM, LTE Cat M1 and LTE Cat NB2 networks. Many alarm, security and life-critical systems rely on the use of cellular networks. Quectel Jamming Detection allows the module to detect jamming signals. When jamming is detected, the module sends a notification to MCU, reporting the presence of active jamming of GSM, LTE Cat M1 and LTE Cat NB2 networks. If the module detects high RSSI on a frequency but does not detect any cell, or PBCH decoding fails, it may imply the presence of a jammer. 2.1. Application Overview With the Jamming Detection function, the module is able to report the presence and removal of jamming automatically via URCs to notify the MCU. Also, you can query the current jamming status via AT+QJDR?. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 7 / 18 LPWA Module Series 3 Description of AT Commands 3.1. AT Command Introduction 3.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 8 / 18 LPWA Module Series 3.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about how to use the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. 3.3. AT Command Description 3.3.1. AT+QJDR Enable/Disable Jamming Detection This command enables/disables the Jamming Detection feature. When Jamming Detection is enabled, the module reports a URC. AT+QJDR Enable/Disable Jamming Detection Test Command AT+QJDR=? Response +QJDR: (list of supported s) Read Command AT+QJDR? OK Response If =1 (Jamming Detection enabled): +QJDR: NOJAMMING OK Or +QJDR: JAMMED OK If =0 (Jamming Detection disabled): +QJDR: 0 Write Command AT+QJDR= OK Response OK Or ERROR BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 9 / 18 LPWA Module Series Maximum Response Time Characteristic 300 ms The command takes effect immediately; The configurations will be saved automatically. Parameter Integer type. Disable or enable the Jamming Detection function. 0 Disable 1 Enable NOTE 1. Before using Jamming Detection, please enable the log output with AT+QCFG='dbgctl' (see document [1] for details). 2. By default, the Jamming Detection function only works under registered state. The module implements different Jamming Detection algorithms for each different RAT. If the module supports multiple RATs, the modem cannot determine which algorithm should be loaded. Therefore, if the module is not registered on network, lock the module to a single RAT supported via AT+QCFG='nwscanmode' and/or AT+QCFG='iotopmode' (see document [1] for details) to make the Jamming Detection function work. 3.3.2. AT+QJDCFG Jamming Detection Configuration This command configures the options of Jamming Detection feature. These options include the Jamming Detection thresholds, the jamming notification methods, etc. AT+QJDCFG Jamming Detection Configuration Test Command AT+QJDCFG=? Response +QJDCFG: 'urc',(list of supported s) +QJDCFG: 'period',(range of supported s) +QJDCFG: 'mnl',(range of supported s) +QJDCFG: 'minch',(range of supported s) +QJDCFG: 'rsrp',(range of supported s) +QJDCFG: 'rsrq',(range of supported s) +QJDCFG: 'rssi',(range of supported s) +QJDCFG: 'totalrssi',(range of supported s) +QJDCFG: 'shakeperiod',(range of supported s) +QJDCFG: 'servenable',(list of supported s) BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 10 / 18 LPWA Module Series Read Command AT+QJDCFG? Write Command AT+QJDCFG='urc', Write Command AT+QJDCFG='period', Write Command (For GSM network only) AT+QJDCFG='mnl', Write Command AT+QJDCFG='minch', Write Command (For LTE network only) AT+QJDCFG='rsrp', Write Command (For LTE network only) AT+QJDCFG='rsrq', Write Command (For LTE network only) AT+QJDCFG='rssi', Write Command OK Response +QJDCFG: 'urc', +QJDCFG: 'period', +QJDCFG: 'mnl', +QJDCFG: 'minch', +QJDCFG: 'rsrp', +QJDCFG: 'rsrq', +QJDCFG: 'rssi', +QJDCFG: 'totalrssi', +QJDCFG: 'shakeperiod', +QJDCFG: 'servenable', OK Response OK Or ERROR Response OK Or ERROR Response OK Or ERROR Response OK Or ERROR Response OK Or ERROR Response OK Or ERROR Response OK Or ERROR Response BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 11 / 18 LPWA Module Series (For LTE network only) AT+QJDCFG='totalrssi', Write Command (For LTE network only) AT+QJDCFG='shakeperiod', Write Command (For LTE network only) AT+QJDCFG='servenable', OK Or ERROR Response OK Or ERROR Response OK Or ERROR Maximum Response Time 300 ms Characteristic The command takes effect immediately; The configurations will be saved automatically. Parameter Integer type. Whether to enable URC reporting. For details about URCs, see Chapter 3.4. 0 Disable 1 Enable Integer type. Whether to enable periodic URC reporting. Valid only when =1. 0 Disable 1–120 Enable, and the value is the interval for URC reporting. Unit: second. Integer type. The minimum RxLev threshold (for GSM network only). Default value: 17. Range: 0–31. Integer type. The minimum channel number or ARFCN number which is jammed. Default value: 5. Range: 0–254. Integer type. The reference signal received power threshold (for LTE network only). Default value: -105. Range: -140 to -44. Unit: dBm. Integer type. The reference signal received quality threshold (for LTE network only). Default value: -15. Range: -19 to -3. Unit: dB. Integer type. The received signal strength indication threshold (for LTE network only). Default value: -40. Range: -90 to -25. Unit: dBm. Integer type. The total received signal strength indication threshold (for LTE network only). Default value: -40. Range: -127 to -5. Unit: dBm. Integer type. Jamming detection period, which prevents false alarms resulted from network jitter (for LTE network only). Default value: 3. Range: 1–10. Unit: second. Integer type. Enable/disable jamming detection report when the module is out of service (for LTE network only). 0 Disable 1 Enable BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 12 / 18 LPWA Module Series NOTE The default values of all parameters except and are verified to be the optimal ones through Quectel’s tests in different scenarios. Therefore, it is recommended to use the Jamming Detection function with default settings, otherwise the function may not work well. If you have any special requirement, contact Quectel Technical Supports for the appropriate setting of threshold values in AT+QJDCFG. 3.4. URC Description 3.4.1. Indicate the Presence of Jamming After Jamming Detection is enabled with AT+QJDR=1 and URC reporting is enabled with AT+QJDCFG='urc',1, the module automatically reports the URC +QJDR: JAMMED when it detects the presence of jamming. If periodic URC reporting is enabled in this case, the module will report the URC periodically in an interval set by of AT+QJDCFG='period'. Indicate the Presence of Jamming +QJDR: JAMMED The module reports this URC when it detects the presence of jamming. 3.4.2. Indicate the Removal of Jamming After the jamming is removed, the module reports the URC +QJDR: NOJAMMING. Indicate the Removal of Jamming +QJDR: NOJAMMING The module reports this URC when the jamming is removed. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 13 / 18 LPWA Module Series 4 Examples 4.1. Report the Jamming Status via URC AT+QJDR=1 OK //Enable Jamming Detection. //If jamming is not existing: AT+QJDR? +QJDR: NOJAMMING //Query the current jamming status. //No jamming is detected. OK //If jamming is existing: AT+QJDR? +QJDR: JAMMED //Query the current jamming status. //Jamming is detected. OK //If jamming is removed: AT+QJDR? +QJDR: NOJAMMING //Query the current jamming status. //No jamming is detected. OK //Automatically report URC to show the current jamming status. AT+QJDR=1 //Enable Jamming Detection. OK AT+QJDCFG='urc',1 //Enable automatic URC reporting. OK //If jamming is existing: +QJDR: JAMMED //When jamming is detected, the URC is reported automatically. //If jamming is removed: +QJDR: NOJAMMING //When jamming is removed, the URC is reported automatically. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 14 / 18 LPWA Module Series 4.2. Report the Jamming Status via URC Periodically AT+QJDR=1 OK AT+QJDCFG='urc',1 OK AT+QJDCFG='period',5 OK //If jamming is existing: +QJDR: JAMMED … +QJDR: JAMMED …. //If jamming is removed: +QJDR: NOJAMMING AT+QJDCFG='period',0 OK //Enable Jamming Detection. //Enable automatic URC reporting. //Set as 5. URC will be reported every 5 seconds when jamming is detected. //The URC will be reported automatically every 5 seconds, to indicate jamming is detected. //When jamming is removed, the URC is reported automatically. //Disable reporting URC periodically. 4.3. Enable and Disable Jamming Detection AT+QJDR=? +QJDR: (0,1) OK AT+QJDR? +QJDR: NOJAMMING OK AT+QJDR=1 OK AT+QJDCFG='urc',1 OK //If jamming is existing: +QJDR: JAMMED //Test command. //Query the current jamming status. //No jamming is detected. //Enable Jamming Detection function. //Enable automatic URC reporting. //When jamming is detected, the URC is reported automatically. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 15 / 18 //If jamming is removed: +QJDR: NOJAMMING AT+QJDR=0 OK LPWA Module Series //When jamming the removed, the URC is reported automatically. //Disable Jamming Detection function. 4.4. Configure Jamming Detection AT+QJDCFG=? //Test command. +QJDCFG: 'urc',(0,1) +QJDCFG: 'period',(0-120) +QJDCFG: 'mnl',(0-31) +QJDCFG: 'minch',(0-254) +QJDCFG: 'rsrp',(-140~-44) +QJDCFG: 'rsrq',(-19~-3) +QJDCFG: 'rssi',(-90~-25) +QJDCFG: 'totalrssi',(-127~-5) +QJDCFG: 'shakeperiod',(1-10) +QJDCFG: 'servenable',(0,1) OK AT+QJDCFG? +QJDCFG: 'urc',0 +QJDCFG: 'period',0 +QJDCFG: 'mnl',17 +QJDCFG: 'minch',5 +QJDCFG: 'rsrp',-105 +QJDCFG: 'rsrq',-15 +QJDCFG: 'rssi',-40 +QJDCFG: 'totalrssi',-40 +QJDCFG: 'shakeperiod',3 +QJDCFG: 'servenable',0 //Query the current parameter configuration. OK AT+QJDCFG='period',5 OK AT+QJDCFG='rsrp',-110 OK AT+QJDR=1 OK //Set the value of as 5. It represents that jamming status is reported via URC through serial port every 5 seconds. //Set the value of as -110. It represents that Jamming Detection function will consider -110 dBm as the threshold of . //Enable Jamming Detection function. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 16 / 18 AT+QJDCFG='urc',1 OK //If jamming is existing: +QJDR: JAMMED //If jamming is removed: +QJDR: NOJAMMING AT+QJDR=0 OK LPWA Module Series //When jamming is detected, the URC is reported automatically . //When jamming the removed, the URC is reported automatically. //Disable Jamming Detection function. BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 17 / 18 LPWA Module Series 5 Appendix References Table 3: Related Document Document Name [1] Quectel_BG95&BG77&BG600L_Series_QCFG_AT_Commands_Manual Table 4: Terms and Abbreviations Abbreviation ARFCN GSM MCU LPWA LTE RAT PBCH RxLev RSRP RSRQ RSSI URC Description Absolute Radio-Frequency Channel Number Global System for Mobile Communications Microcontroller Unit Low-Power Wide-Area Long Term Evolution Radio Access Technology Physical Broadcast Channel Received Signal Level Reference Signal Received Power Reference Signal Received Quality Received Signal Strength Indication Unsolicited Result Code BG95&BG77&BG600L_Series_Jamming_Detection_Application_Note 18 / 18

BC260Y-CN 终端应用设计指导 NB-IoT 模块系列 版本：1.0 日期：2020-08-10 状态：受控文件 www.quectel.com BC260Y-CN 终端应用设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 14 BC260Y-CN 终端应用设计指导 文档历史 修订记录 版本 日期 1.0 2020-08-10 作者 顾根全 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 14 BC260Y-CN 终端应用设计指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图表索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 终端应用设计指导 ................................................................................................................................. 7 2.1. 上报类......................................................................................................................................... 7 2.1.1. 网络参数配置要求 ........................................................................................................... 7 2.1.2. 终端设计建议................................................................................................................... 7 2.1.3. 上报类终端参考流程........................................................................................................ 9 2.2. 控制类........................................................................................................................................11 2.2.1. 网络参数配置要求 ..........................................................................................................11 2.2.2. 终端设计建议..................................................................................................................11 2.2.3. 控制类终端参考流程...................................................................................................... 12 3 补充说明.............................................................................................................................................. 13 3.1. 常规维护测试手段 .................................................................................................................... 13 3.2. 相关 AT 命令说明 ..................................................................................................................... 13 4 附录 A 参考文档及术语缩写................................................................................................................ 14 上海移远通信技术股份有限公司 3 / 14 BC260Y-CN 终端应用设计指导 表格索引 表 1：上报类终端应用网络参数配置要求..................................................................................................... 7 表 2：上报类终端应用设计参考项................................................................................................................ 7 表 3：控制类终端应用网络参数配置要求....................................................................................................11 表 4：控制类终端应用设计参考项...............................................................................................................11 表 5：相关 AT 命令说明 ............................................................................................................................. 13 表 6：参考文档........................................................................................................................................... 14 表 7：术语缩写........................................................................................................................................... 14 上海移远通信技术股份有限公司 4 / 14 BC260Y-CN 终端应用设计指导 图表索引 图 1：上报类终端应用简化流程 ................................................................................................................... 9 图 2：上报类终端应用参考流程 ................................................................................................................. 10 图 3：控制类终端应用参考流程 ................................................................................................................. 12 上海移远通信技术股份有限公司 5 / 14 BC260Y-CN 终端应用设计指导 1 引言 目前，移远通信 NB-IoT 模块主要应用于以下两类终端应用场景： ⚫ 上报类： 1) 固定上报类终端，如水表、气表、烟感报警器等； 2) 移动上报类终端，如共享单车、智能手环等。 ⚫ 控制类：如路灯、共享洗衣机、电动车控制器等。 本文档针对上述两大类终端应用场景提供设计指导，以便于客户在不同的网络部署环境（部署频点变 更、同频改异频等）下进行终端部署。 备注 本文档所涉及的 AT 命令详情，除另有说明外，请参考文档 [1] 。 上海移远通信技术股份有限公司 6 / 14 BC260Y-CN 终端应用设计指导 2 终端应用设计指导 本章节分别根据 BC260Y-CN 模块各类终端应用提供设计指导和建议。 2.1. 上报类 上报类终端应用的数据传输业务具有周期性；大部分时间处于休眠状态，无需接收寻呼消息，仅在终 端发送上行数据时接收下行数据。此类终端应用要求低功耗以及高数据传输成功率，但对数据传输的实时 性要求低，建议遵循以下设计要求。 2.1.1. 网络参数配置要求 表 1：上报类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 功能 配置要求 关闭 开启 备注 如上表格所述功能由核心网配置，因此，需与运营商确认功能开启和关闭状态。 2.1.2. 终端设计建议 表 2：上报类终端应用设计参考项 序号 设计参考项 1 开机入网超时时间 说明 由于网络变化或在深度覆盖下，终端入网时间较长。因此，建议 MCU 开机入网超时时间不小于 300 s。入网超时后，则进入异常处理流 程。 上海移远通信技术股份有限公司 7 / 14 BC260Y-CN 终端应用设计指导 开启模块 PSM 功能，并配置模块定期向核心网进行 TAU 的周期 使用 AT+CPSMS=1[,,,[,< T3324 时间超时后模块才会进入 PSM 状态。 Requested_Active-Tim e>]]命令配置 PSM 参数 的默认请求值为 2 分钟，请求值是否生 效取决于核心网（目前实测，移动 NB-IoT 卡允许配置；电信 NB-IoT 卡是否可配置和开卡时选择的 APN 类型有关）。 模块断电之前，需进行如下操作： 3 若需要给模块断电，建议执 行 AT+CFUN=0 再断电 通过 MCU 向模块发送 AT+CFUN=0 命令，触发模块向核心网发送 去附着消息。 4 数据传输业务 ⚫ 当前版本已支持深度休眠后保存连接状态，如果连接了电信物 联网平台（电信 AEP 平台和电信 IoT 平台）、移动 OneNET 平 台或者建立了 UDP 连接，唤醒后连接恢复成功即可直接发送数 据，无需重新连接。 ⚫ 进行正常数据传输业务时，在业务数据交互过程中，若 60 s 后 未收到下行数据，则 MCU 判定本次数据业务因超时而失败并 再次尝试发送数据；若 3 次尝试均超时失败，则进入异常处理 流程。 5 异常处理流程 若入网异常或数据传输业务失败后，请按如下流程进行异常处理： 1) 执行 AT+CFUN=0 关闭射频和 SIM 卡； 2) 执行 AT+QCSEARFCN 命令（清除记忆频点）； 3) 执行 AT+CFUN=1 再次尝试入网以及数据传输业务； 4) 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 8 / 14 2.1.3. 上报类终端参考流程 BC260Y-CN 终端应用设计指导 模块上电/休眠唤醒 设置关闭模块休眠 AT+QS CLK=0 业务全部完成 No 设置允许模块休眠 AT+QS CLK=1 是否断电 Yes 成功进入休眠 上报+QNBIOTEVENT: Yes 'ENTER DEEP SLEEP' 深休眠 No AT+CFUN=0 断电关机 连续发送 AT 唤醒 AT命令返回OK或者收到 +QNBIOTEVENT: 'EXIT DEEP SLEE P'表示唤醒成功 （PS M_EI NT下降沿也可唤醒） 重新上电 图 1：上报类终端应用简化流程 上海移远通信技术股份有限公司 9 / 14 BC260Y-CN 终端应用设计指导 参数配置前关闭休眠 AT+QS CLK=0 指定Band AT+QBAND=, 重启模块 拉低模块RESE T引脚 如果不需要固定具体Band可跳过 数据传输业务 Yes 数据传输 是否成功? 连续3次接收下行数 据超时（60 s） No Yes 最后一包上行数据建议 采用带RAI功能的命令 空闲模式 是否断电? No Yes 设置允许模块休眠 AT+QS CLK=1 AT+CFUN=0 检查是否 成功进入休眠 Yes 深休眠 No 210 s 后，未上报 +QNBIOTEVENT: 'ENTER DEEP SLEE P' 模块上电 设置关闭模块休眠 AT+QS CLK=0 关闭模块eDRX功能 AT+CEDRXS=0 打开模块PS M功能 AT+CPSMS=1 网络附着 检查是否 成功入网 300 s后，AT+CEREG?查询仍 No 未注网或者AT+CGPADDR?查 询未获取IP地址，找网失败 是否继续 尝试入网? Yes No AT+CFUN=0 清除记忆频点 AT+QCSE ARFCN AT+CFUN=1 可根据退避算法 连续3次入网失败 异常 处理 210 s是按照 data inactivity timer(60 s) + T3324(2 min) + 30 s 冗余计算而来。如果客户有重新配 置这些值则需要重新计算 断电关机 图 2：上报类终端应用参考流程 上海移远通信技术股份有限公司 10 / 14 BC260Y-CN 终端应用设计指导 2.2. 控制类 控制类的终端应用通常由外部电源供电；大部分时间处于在线状态，能实时接收下行数据。该类终端 应用对数据实时性要求高，但对功耗要求低，建议遵循以下设计要求。 2.2.1. 网络参数配置要求 表 3：控制类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 功能 配置要求 关闭 关闭 备注 如上表格所述功能由核心网配置，因此，须与运营商确认功能开启和关闭状态。 2.2.2. 终端设计建议 表 4：控制类终端应用设计参考项 序号 设计建议参数 说明 1 开机入网超时时间 由于网络变化或在深度覆盖下，终端入网时间较长。因此，建议 MCU 开机入网超时时间不小于 300 s。入网超时后，则进入异常处理流 程。 若需要给模块断电，则须先 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，向网络发送去附 2 执行 AT+CFUN=0 再断电 着消息。 3 数据传输业务 进行正常数据传输业务时，在业务数据交互过程中，若 60 s 后未收 到下行数据，则判定本次数据业务因超时而失败，再次尝试发送数 据；若 3 次尝试均超时失败，则进入异常处理流程。 4 异常处理流程 若入网异常或数据传输业务失败后，请按如下流程进行异常处理： 1) 执行 AT+CFUN=0 关闭射频和 SIM 卡； 2) 执行 AT+QCSEARFCN 命令（清除记忆频点）； 3) 执行 AT+CFUN=1 再次尝试入网以及数据传输业务； 4) 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 11 / 14 2.2.3. 控制类终端参考流程 BC260Y-CN 终端应用设计指导 设置关闭模块休眠 AT+QS CLK=0 指定Band AT+QBAND=, 重启模块 拉低模块RESE T引脚 如果不需要固定为特定的Band可跳过 模块上电 设置关闭模块休眠 AT+QS CLK=0 关闭模块eDRX功能 AT+CEDRXS=0 关闭模块PS M功能 AT+CPSMS=0 网络附着 数据传输业务 Yes 数据传输 是否成功? 连续3次接收下行 数据超时（60 s）, 异常处理 No Yes 最后一包上行数据建议 采用带RAI功能的命令 空闲模式 检查是否 成功入网 No 300 s后，AT+CEREG?查询未 注网或者AT+CGPADDR?查询 未获取IP地址，异常处理 是否继续 尝试入网? No Yes AT+CFUN=0 清除记忆频点 AT+QCSE ARFCN AT+CFUN=1 根据退避算法连 续3次入网失败 断电关机 异常 处理 图 3：控制类终端应用参考流程 上海移远通信技术股份有限公司 12 / 14 BC260Y-CN 终端应用设计指导 3 补充说明 3.1. 常规维护测试手段 终端支持网络相关信息的上报且可在平台上显示，例如频点（EARFCN）、小区 ID、覆盖等级（ECL）、 信号强度（RSRP）、信噪比（SNR）等，可通过 AT+QENG=0 命令获取相关信息。 3.2. 相关 AT 命令说明 本章节列举了与 BC260Y-CN 终端应用设计相关的 AT 命令。更多详情，请参考文档 [1] 。 表 5：相关 AT 命令说明 序号 AT 命令 AT+QSCLK=0/ 1 AT+QSCLK=1 2 AT+CEDRXS=0 3 AT+CEREG? 4 AT+CGPADDR? 5 AT+CPSMS=0 6 AT+QENG=0 7 AT+QCSEARFCN=0 8 AT+CFUN=0 说明 关闭深休眠/ 使能深休眠。 关闭模块 eDRX 功能。 查询模块是否成功入网。 查询模块是否获取 IP 地址。 关闭模块 PSM 功能。 查询最近一次所驻留小区的 EARFCN、小区 ID、 ECL、RSRP 和 SNR 等信息。 清除模块保存的记忆频点，当下一次启动搜索网 时，根据场景信号强度选择频点。 关闭模块的射频功能块。 上海移远通信技术股份有限公司 13 / 14 BC260Y-CN 终端应用设计指导 4 附录 A 参考文档及术语缩写 表 6：参考文档 序号 文档名称 [1] Quectel_BC260Y-CN_AT 命令手册 备注 BC260Y-CN AT 命令手册 表 7：术语缩写 缩写 APN EARFCN ECL eDRX MCU NB-IoT PSM RAI RRC RSRP SNR UDP 英文全称 中文全称 Access Point Name E-UTRA Absolute Radio Frequency Channel Number Enhanced Coverage Level 接入点名称 E-UTRA 绝对射频频道号（频点） 增强覆盖范围 Extended Discontinuous Reception 增强型非连续接收 Microprogrammed Control Unit 微控单元 Narrow Band Internet of Things 窄带物联网 Power Saving Mode 省电模式 Release Assistance Indication 释放辅助指示 Radio Resource Control 无线资源控制 Reference Signal Received Power 参考信号接收功率 Signal Noise Ratio 信噪比 User Datagram Protocol 用户数据报协议 上海移远通信技术股份有限公司 14 / 14

BC32 系列 终端应用设计指导 NB-IoT 模块系列 版本：1.0 日期：2020-11-19 状态：受控文件 www.quectel.com BC32 系列终端应用设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 19 BC32 系列终端应用设计指导 文档历史 修订记录 版本 日期 - 2020-09-21 1.0 2020-11-19 作者 方亮/ 秦世鹏 方亮/ 秦世鹏 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 19 BC32 系列终端应用设计指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 NB-IoT 网络下终端应用设计指导 ......................................................................................................... 7 2.1. 上报类......................................................................................................................................... 7 2.1.1. 网络参数配置要求 ........................................................................................................... 7 2.1.2. 终端设计建议................................................................................................................... 8 2.1.3. 终端设计参考流程 ........................................................................................................... 9 2.2. 控制类....................................................................................................................................... 10 2.2.1. 网络参数配置要求 ......................................................................................................... 10 2.2.2. 终端设计建议................................................................................................................. 10 2.2.3. 终端设计参考流程 ..........................................................................................................11 3 GSM 网络下终端应用设计指导 ........................................................................................................... 12 3.1. 上报类....................................................................................................................................... 12 3.1.1. 终端设计建议................................................................................................................. 12 3.1.2. 终端设计参考流程 ......................................................................................................... 13 3.2. 控制类....................................................................................................................................... 14 3.2.1. 终端设计建议................................................................................................................. 14 3.2.2. 终端设计参考流程 ......................................................................................................... 15 4 补充说明 .............................................................................................................................................. 16 4.1. 常规维护测试手段 .................................................................................................................... 16 4.2. 相关 AT 命令说明 ..................................................................................................................... 16 5 附录 A 参考文档及术语缩写............................................................................................................... 18 上海移远通信技术股份有限公司 3 / 19 BC32 系列终端应用设计指导 表格索引 表 1：NB-IoT 网络下上报类终端应用网络参数配置要求 ............................................................................. 7 表 2：NB-IoT 网络下上报类终端应用设计参考项 ........................................................................................ 8 表 3：NB-IoT 网络下控制类终端应用网络参数配置要求 ........................................................................... 10 表 4：NB-IoT 网络下控制类终端应用设计参考项 ...................................................................................... 10 表 5：GSM 网络下上报类终端应用设计参考项.......................................................................................... 12 表 6：GSM 网络下控制类终端应用设计参考项.......................................................................................... 14 表 7：相关 AT 命令说明 ............................................................................................................................. 16 表 8：参考文档........................................................................................................................................... 18 表 9：术语缩写........................................................................................................................................... 18 上海移远通信技术股份有限公司 4 / 19 BC32 系列终端应用设计指导 图片索引 图 1：NB-IoT 网络下上报类终端应用参考流程 ............................................................................................ 9 图 2：NB-IoT 网络下控制类终端应用参考流程 ...........................................................................................11 图 3：GSM 网络下上报类终端应用参考流程 ............................................................................................. 13 图 4：GSM 网络下控制类终端应用参考流程 ............................................................................................. 15 上海移远通信技术股份有限公司 5 / 19 BC32 系列终端应用设计指导 1 引言 目前，移远通信 NB-IoT/GSM 模块主要应用于如下两类终端应用场景： ⚫ 上报类：固定上报类终端，如水表、气表、烟感报警器等；移动上报类终端，如共享单车、智能 手环等。 ⚫ 控制类：如电动车控制器、路灯、共享洗衣机等。 本文档针对上述两大类终端应用场景提供设计指导，以便于客户在不同的网络部署环境（部署频点变 更、同频改异频等）下部署使用移远通信 BC32 系列模块的终端。 除有特别注明，本文出现的 AT 命令均请参考文档 [1]。 上海移远通信技术股份有限公司 6 / 19 BC32 系列终端应用设计指导 2 NB-IoT 网络下终端应用设计指导 本章为 NB-IoT 网络下移远通信 BC32 系列模块各类终端应用的设计提供指导和建议。 模块初始默认配置如下： 1. 模块默认启用 PSM 和 eDRX。 2. 模块可以使用推荐的 PSM 和 eDRX 配置，但实际生效的值取决于网络下发的值。 3. 模块默认 NB-IoT 网络优先。 备注 受运营商频点部署变化的影响，模块注网时间可能会有差异，建议按照 300 秒的注网时间设计 MCU 逻 辑，在注网失败时参考推荐设计做清频处理。 2.1. 上报类 上报类终端应用的数据传输业务具有周期性，其大部分时间处于睡眠状态，无需接收寻呼消息，仅在 发送上行数据时接收下行数据。此类终端应用要求低功耗以及高数据传输成功率，但对数据传输实时性的 要求较低，建议遵循以下设计要求及建议。 2.1.1. 网络参数配置要求 表 1：NB-IoT 网络下上报类终端应用网络参数配置要求 序号 1 2 参数 eDRX PSM 配置要求 开启 开启 备注 上表所述功能最终能否生效由核心网决定，因此须与运营商确认功能开启和关闭状态。 上海移远通信技术股份有限公司 7 / 19 BC32 系列终端应用设计指导 2.1.2. 终端设计建议 表 2：NB-IoT 网络下上报类终端应用设计参考项 序号 设计参考项 说明 由于模块在网络环境发生变化后或在深度覆盖下入网时间较长，因 1 开机入网超时时间 此建议将 MCU 开机入网超时时间设置为不小于 300 秒。若入网超 时，则进入异常处理流程。 开启模块 PSM 功能，并配置模块周期性 TAU 定时器（T3412），以 使用 AT+CPSMS=1,,,,命 令配置 PSM 参数 T3324 时 间 超 时 后 模 块 才 会 进 入 PSM 状 态 。 默认请求值为 2 分钟，请求值是否生 效取决于核心网（目前实测，移动的 NB-IoT 卡允许配置；电信 NB-IoT 卡是否可配置，与开卡时选择的 APN 类型有关）。 模块断电之前需进行如下步骤： 若需要给模块断电，则须在 1) 基于上述 T3324 定时器的配置，等待模块进入 Idle 状态后需延 3 模块进入 Idle 状态 15 秒后， 时至少 15 秒，以保证模块有足够的时间完成小区测量及重选过 程； 先执行 AT+CFUN=0 再断电 2) 通过 MCU 向模块发送 AT+CFUN=0 命令，触发模块向核心网 发送去附着消息。 4 数据传输业务 ⚫ 当前版本已支持休眠保存连接状态，如果连接了移动 OneNET 物联网开放平台或者建立了 UDP 连接，唤醒后恢复成功即可直 接发送数据，无需重新连接。（参考文档 [2]） ⚫ 模块在进行正常数据传输业务时，如在业务数据交互过程中超 过 60 秒未收到下行数据，则判定本次数据业务因超时而失败， 并再次尝试发送数据；若 3 次尝试均超时失败，则进入异常处 理流程。 5 DFOTA 入网后模块可以使用 AT+QFOTADL 命令从 HTTP 服务器获取差分 包进行固件升级。（参考文档 [3]） 若入网异常或数据传输业务失败，请按如下流程进行异常处理： 6 异常处理流程 1) 执行 AT+QCSEARFCN=0 命令（清除先验频点）； 2) 拉低模块 RESET 引脚一段时间后释放（重启模块）； 3) 再次尝试入网以及数据传输业务； 4) 若连续三次尝试入网失败，则建议断电关机，待下一次业务上 报时，再重新入网。 上海移远通信技术股份有限公司 8 / 19 BC32 系列终端应用设计指导 2.1.3. 终端设计参考流程 模块上电 关闭射频 AT+CFUN=0 设置NB-IoT优先 AT+QNWCFG=1 如果使用BC32多频段模块， 则需设置工作频段；单频段 型号BC32-B8可忽略此设置 设置工作频段 AT+QBAND 重启模块：拉低RESET引 脚一段时间后释放 配置eDRX参数 AT+CEDRXS 配置PSM参数 AT+CPSMS 关闭模块深度睡眠 AT+QSCLK=0 网络附着 模块唤醒或者开机后 推荐设置AT+QSCLK=0 禁止模块进入深度睡眠 模式 数据传输业务 Yes 数据传输 是否成功? Yes Idle模式 连续3次接收下行 数据超时（60 s） No No 是否断电? 查看当前注网信息 AT+COPS? NB-IoT 打开模块深度睡眠 AT+QSCLK=1 建议进入Idle模式后 Y 延时至少15 s，先执行 AT+CFUN=0再断电 GSM AT+CFUN=0 检查是否 成功入网 AT+CGATT? N 300 s后，AT+CGATT?查 询返回值不等于1或者 AT+CGPADDR?查询未获 取IP地址 是否继续 尝试入网? Yes 3 清除先验频点 次 AT+QCSEARFCN=0 入 网 失 败 重启模块：拉低RESET引脚 一段时间后释放 异常处理 No 检查是否 成功进入深度睡眠 Yes 深度睡眠 No 300 s后，未上报+QATSLEEP 或者发送AT命令仍然能够返回 OK 断电关机 图 1：NB-IoT 网络下上报类终端应用参考流程 上海移远通信技术股份有限公司 9 / 19 BC32 系列终端应用设计指导 2.2. 控制类 控制类终端应用，通常由外部电源供电，其大部分时间处于在线状态，能实时接收下行数据。该类终 端应用对数据传输实时性要求高，对功耗要求较低，建议遵循以下设计要求及建议。 2.2.1. 网络参数配置要求 表 3：NB-IoT 网络下控制类终端应用网络参数配置要求 序号 1 2 参数 eDRX PSM 配置要求 关闭 关闭 2.2.2. 终端设计建议 表 4：NB-IoT 网络下控制类终端应用设计参考项 序号 设计建议参数 说明 由于模块在网络变化后或在深度覆盖下入网时间较长，因此建议将 1 开机入网超时时间 MCU 开机入网超时时间设置为不小于 300 秒。若入网超时，则进 入异常处理流程。 若需要给模块断电，则须先 在断电前，通过 MCU 向模块发送 AT+CFUN=0 命令，触发模块向 2 执行 AT+CFUN=0 再断电 核心网发送去附着消息。 3 数据传输业务 模块在进行正常数据传输业务时，如在业务数据交互过程中超过 60 秒未收到下行数据，则判定本次数据业务因超时而失败，并再次尝 试发送数据；若 3 次尝试均超时失败，则进入异常处理流程。 4 DFOTA 入网后模块可以使用 AT+QFOTADL 命令从 HTTP 服务器获取差分 包进行固件升级。（参考文档 [3]） 若入网异常或数据传输业务失败，请按如下流程进行异常处理： 5 异常处理流程 1) 执行 AT+QCSEARFCN=0 命令（清除先验频点）； 2) 拉低模块 RESET 引脚一段时间后释放（重启模块）； 3) 再次尝试入网以及数据传输业务； 4) 若连续三次尝试入网失败，则建议断电关机，待下一次业务上 报时，再重新入网。 上海移远通信技术股份有限公司 10 / 19 BC32 系列终端应用设计指导 2.2.3. 终端设计参考流程 模块上电 关闭射频 AT+CFUN=0 设置NB-IoT优先 AT+QNWCFG=1 设置工作频段 AT+QBAND 重启模块：拉低 RESET引脚一段时间 后释放 关闭模块睡眠模式 AT+QSCLK=0 关闭模块PSM功能 AT+CPSMS=0 关闭模块eDRX功能 AT+CEDRXS=0 网络附着 如果使用BC32多频段模块， 则需设置工作频段；单频段 型号BC32-B8可忽略此步骤 数据传输业务 Yes 数据传输 是否成功? 连续3次接收下行 数据超时（60 s） No 检查是否 成功入网 AT+CGATT? No 300 s后，AT+CGATT?查 询返回值不等于1或者 AT+CGPADDR?查询未获 取IP地址 是否继续 尝试入网? Yes Yes Idle模式 3 次 入 No 网 失 败 断电关机 清除先验频点 AT+QCSEARFCN=0 重启模块: 拉低RESET引脚一段 时间后释放 异常处理 图 2：NB-IoT 网络下控制类终端应用参考流程 上海移远通信技术股份有限公司 11 / 19 BC32 系列终端应用设计指导 3 GSM 网络下终端应用设计指导 本章为 GSM 网络下移远通信 BC32 系列模块各类终端应用的设计提供指导和建议。 3.1. 上报类 3.1.1. 终端设计建议 表 5：GSM 网络下上报类终端应用设计参考项 序号 设计建议参数 1 开机设置 2 开机入网超时时间 3 数据传输业务 4 DFOTA 5 异常处理流程 说明 由于 GSM 网络下模块不会自动激活 PDP，所以开机上电后需要手动 设置并激活 PDP 上下文，然后才能处理数据传输业务。 由于模块在网络变化后或在深度覆盖下入网时间较长，因此建议将 MCU 开机入网超时时间设置为不小于 300 秒。若入网超时，则进入 异常处理流程。 模块在进行正常数据传输业务时，如在业务数据交互过程中超过 60 秒未收到下行数据，则判定本次数据业务因超时而失败，并再次尝试 发送数据；若 3 次尝试均超时失败，则进入异常处理流程。 入网后模块可以使用 AT+QFOTADL 命令从 HTTP 服务器获取差分包 进行固件升级。（参考文档 [3]） 若入网异常或数据传输业务失败，请按如下流程进行异常处理： 1) 拉低模块 RESET 引脚一段时间后释放（重启模块）； 2) 使用 AT+CGDCONT 命令重新设置 PDP 上下文； 3) 附着网络成功后，使用 AT+CGACT 命令激活 PDP 上下文； 4) 再次尝试入网以及数据传输业务； 5) 若连续三次尝试入网失败，则建议断电关机，待下一次业务上报 时，再重新入网。 上海移远通信技术股份有限公司 12 / 19 BC32 系列终端应用设计指导 3.1.2. 终端设计参考流程 模块上电 关闭射频 AT+CFUN=0 设置GSM优先 AT+QNWCFG=0,1 重启模块：拉低RESET引 脚一段时间后释放 GSM网络下，模块不会 自动激活任何上下文，需 要手动设置激活 设置PDP上下文 AT+CGDCONT 网络附着 激活承载 AT+CGACT Yes AT+CGACT执行成功后， 使用命令AT+CGPADDR? 查询未获取IP地址 No 检查是否 成功入网 AT+CGATT? 300 s后，AT+CGATT?查 No 询返回值不等于1 Yes 数据传输业务 No 数据传输 是否成功? Yes 连续3次接收下行 数据超时（60 s） 是否继续 尝试入网? 连 续 3 次 No 入 网 失 败 Yes 重启模块: 拉低RESET引脚一段 时间后释放 是否关机？ No Yes 当上报周期很长 时，推荐使用关机 浅休眠 AT+QSCLK=2 断电关机 异常处理 图 3：GSM 网络下上报类终端应用参考流程 上海移远通信技术股份有限公司 13 / 19 BC32 系列终端应用设计指导 3.2. 控制类 3.2.1. 终端设计建议 表 6：GSM 网络下控制类终端应用设计参考项 序号 设计建议参数 1 开机设置 2 开机入网超时时间 3 数据传输业务 4 DFOTA 5 异常处理流程 说明 由于 GSM 网络下模块不会自动激活 PDP，所以开机上电后需要手 动设置并激活 PDP 上下文，然后才能处理数据传输业务。 由于模块在网络变化后或在深度覆盖下入网时间较长，因此建议将 MCU 开机入网超时时间设置为不小于 300 秒。若入网超时，则进 入异常处理流程。 模块在进行正常数据传输业务时，如在业务数据交互过程中超过 60 秒未收到下行数据，则判定本次数据业务因超时而失败，并再次尝 试发送数据；若 3 次尝试均超时失败，则进入异常处理流程。 入网后模块可以使用 AT+QFOTADL 命令从 HTTP 服务器获取差分 包进行固件升级（参考文档 [3]）。 若入网异常或数据传输业务失败，请按如下流程进行异常处理： 1) 拉低模块 RESET 引脚一段时间后释放（重启模块）； 2) 使用 AT+CGDCONT 命令重新设置 PDP 上下文； 3) 附着网络成功后，使用 AT+CGACT 命令激活 PDP 上下文； 4) 再次尝试入网以及数据传输业务； 5) 若连续三次尝试入网失败，则建议断电关机，待下一次业务上 报时，再重新入网。 上海移远通信技术股份有限公司 14 / 19 3.2.2. 终端设计参考流程 BC32 系列终端应用设计指导 模块上电 关闭射频 AT+CFUN=0 设置GSM优先 AT+QNWCFG=0,1 重启模块：拉低RESET引 脚一段时间后释放 GSM网络下，模块不会 自动激活任何上下文，需 要手动设置激活 设置PDP上下文 AT+CGDCONT 网络附着 激活承载 AT+CGACT Yes 检查是否 Yes 成功入网 AT+CGATT? AT+CGACT执行成功后， 使用命令AT+CGPADDR? 查询未获取IP地址 300 s后，AT+CGATT?查 No 询返回值不等于1 No 是否继续 尝试入网? Yes 数据传输业务 No 数据传输 是否成功? Yes 连续3次接收下行 数据超时（60 s） 浅休眠 AT+QSCLK=2 连 续 3 次 No 入 网 失 败 重启模块: 拉低RESET引脚一段 时间后释放 断电关机 异常处理 图 4：GSM 网络下控制类终端应用参考流程 上海移远通信技术股份有限公司 15 / 19 BC32 系列终端应用设计指导 4 补充说明 4.1. 常规维护测试手段 终端支持上报网络相关信息且可在平台上显示：如频点（EARFCN）、小区 ID、覆盖等级（ECL）、信 号强度（RSRP）、信噪比（SNR）等，此类相关信息可通过执行 AT+QENG=0 命令查询，该命令仅在 NB-IoT 网络下有效。 4.2. 相关 AT 命令说明 本章节列举了和 BC32 系列模块的终端应用设计相关的 AT 命令。除非有特别注明，否则本文中出现的 AT 命令均请参考文档 [1]。 表 7：相关 AT 命令说明 序号 AT 命令 1 AT+CEDRXS=0 2 AT+CGACT 3 AT+CGDCONT 4 AT+CFUN=0 5 AT+CGATT? 6 AT+CEDRXS 7 AT+CPSMS=0 8 AT+QBAND 9 AT+QCSEARFCN=0 说明 关闭模块 eDRX 功能。 激活 PDP 上下文。 重新设置 PDP 上下文。 触发模块向核心网发送去附着消息。 查询模块是否成功入网。 配置 eDRX 参数。 关闭模块 PSM 功能。 设置工作频段。 清除先验频点。 上海移远通信技术股份有限公司 16 / 19 BC32 系列终端应用设计指导 10 AT+QFOTADL 11 AT+QSCLK=0 从 HTTP 服务器获取差分包进行固件升级。（参考 文档 [3]） 关闭模块深度睡眠。 12 AT+QSCLK=1 打开模块深度睡眠。 13 AT+QSCLK=2 让模块进入浅休眠。 14 AT+QNWCFG=0,1 将 GSM 设置为优先网络。 15 AT+QNWCFG=1 将 NB-IoT 设置为优先网络。 AT+MIPLNOTIFY=,,,,,,,< 指示核心网立即释放连接，以便模块快速进入 Idle value>,,[,[,]] 17 AT+QENG=0 查询最近一次所驻留小区的 EARFCN、小区 ID、 ECL、RSRP 和 SNR 等信息。 清除模块保存的先验频点，让模块在下一次启动网 络搜索时根据场景信号强度选择频点。 18 AT+QCSEARFCN AT+QCSEARFCN=0 清 除 NB-IoT 频 点 ， AT+QCSEARFCN=1 清除 GSM 频点。 需要重启生效。 19 AT+COPS? 查询当前注网的网络制式。 20 AT+CGPADDR? 查询模块获取的 IP。 21 AT+CFUN=0 关闭模块射频功能。 上海移远通信技术股份有限公司 17 / 19 BC32 系列终端应用设计指导 5 附录 A 参考文档及术语缩写 表 8：参考文档 序号 文档名称 [1] Quectel_BC32_AT 命令手册 [2] Quectel_BC25&BC32_OneNET_应用指导 [3] Quectel_BC25&BC32 系列_DFOTA_应用指导 描述 BC32 AT 命令手册 BC25 和 BC32 模块 OneNET 平台应用指导 BC25 和 BC32 系列模块 DFOTA 应用指导 表 9：术语缩写 缩写 APN CoAP DFOTA EARFCN ECL eDRX GSM HTTP IP MCU NB-IoT PDP 英文全称 中文全称 Access Point Name 接入点名称 Constrained Application Protocol 受限的应用层协议 Delta Firmware Over-The-Air E-UTRA Absolute Radio Frequency Channel Number Enhanced Coverage Level 固件空中差分升级 E-UTRA 绝对射频频道号 增强覆盖等级 Extended Discontinuous Reception 扩展非连续接收 Global System for Mobile Communications 全球移动通信系统 Hypertext Transfer Protocol 超文本传输协议 Internet Protocol 网际互连协议 Microprogrammed Control Unit 微型控制单元 Narrowband Internet of Things 窄带物联网 Packet Data Protocol 分组数据协议 上海移远通信技术股份有限公司 18 / 19 PSM RSRP SNR TAU UDP Power Saving Mode Reference Signal Receiving Power Signal-to-Noise Ratio Tracking Area Update User Datagram Protocol BC32 系列终端应用设计指导 省电模式 参考信号接收功率 信噪比 跟踪区更新 用户数据报协议 上海移远通信技术股份有限公司 19 / 19

BC28-F&BC95-GF 终端应用 设计指导 NB-IoT 模块系列 版本：1.0 日期：2021-02-03 状态：受控文件 www.quectel.com BC28-F&BC95-GF 终端应用设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 23 BC28-F&BC95-GF 终端应用设计指导 文档历史 修订记录 版本 日期 - 2020-12-04 1.0 2021-02-03 作者 变更表述 Louis GU 文档创建 Louis GU 受控版本 上海移远通信技术股份有限公司 2 / 23 BC28-F&BC95-GF 终端应用设计指导 目录 文档历史 ....................................................................................................................................................... 2 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 终端应用设计指导 ................................................................................................................................. 7 2.1. 固定上报类 ................................................................................................................................. 7 2.1.1. 网络参数配置要求 ........................................................................................................... 7 2.1.2. 终端设计建议................................................................................................................... 7 2.1.3. 终端设计参考流程 ........................................................................................................... 9 2.2. 移动上报类 ............................................................................................................................... 10 2.2.1. 网络参数配置要求 ......................................................................................................... 10 2.2.2. 终端设计建议................................................................................................................. 10 2.2.3. 终端设计参考流程 ......................................................................................................... 12 2.3. 控制类....................................................................................................................................... 13 2.3.1. 网络参数配置要求 ......................................................................................................... 13 2.3.2. 终端设计建议................................................................................................................. 13 2.3.3. 终端设计参考流程 ......................................................................................................... 15 3 模块入网流程....................................................................................................................................... 16 3.1. 自动入网 ................................................................................................................................... 17 3.2. 手动入网 ................................................................................................................................... 18 4 模块 PSM 模式唤醒............................................................................................................................. 19 4.1. 3GPP 协议策略唤醒 ................................................................................................................. 19 4.2. 业务数据的相关策略唤醒 ......................................................................................................... 19 4.3. 运营商自注册逻辑唤醒 ............................................................................................................. 19 5 补充说明 .............................................................................................................................................. 20 5.1. 常规维护测试手段 .................................................................................................................... 20 5.2. 终端整机设计建议 .................................................................................................................... 20 5.3. 相关 AT 命令说明 ..................................................................................................................... 20 6 附录 A 参考文档及术语缩写............................................................................................................... 22 上海移远通信技术股份有限公司 3 / 23 BC28-F&BC95-GF 终端应用设计指导 表格索引 表 1：固定上报类终端应用网络参数配置要求.............................................................................................. 7 表 2：固定上报类终端应用设计参考项 ........................................................................................................ 7 表 3：移动上报类终端应用网络参数配置要求............................................................................................ 10 表 4：移动上报类终端应用设计参考项 ...................................................................................................... 10 表 5：控制类终端应用网络参数配置要求................................................................................................... 13 表 6：控制类终端应用设计参考项.............................................................................................................. 13 表 7：相关 AT 命令说明 ............................................................................................................................. 20 表 8：参考文档 ........................................................................................................................................... 22 表 9：术语缩写 ........................................................................................................................................... 22 上海移远通信技术股份有限公司 4 / 23 BC28-F&BC95-GF 终端应用设计指导 图片索引 图 1：固定上报类终端应用参考流程 ............................................................................................................ 9 图 2：移动上报类终端应用参考流程 .......................................................................................................... 12 图 3：控制类终端应用参考流程 ................................................................................................................. 15 图 4：模块自动入网模式场景初始化流程................................................................................................... 17 图 5：模块手动入网模式场景初始化流程................................................................................................... 18 上海移远通信技术股份有限公司 5 / 23 BC28-F&BC95-GF 终端应用设计指导 1 引言 目前，移远通信 NB-IoT 模块主要应用于如下三类终端应用场景： ⚫ 固定上报类：如水表、气表、烟感报警器等； ⚫ 移动上报类：如共享单车、智能手环等； ⚫ 控制类：如电动车控制器。 本文档针对此三类终端应用场景提供设计指导，以便于客户在不同的网络部署环境（部署频点变更、 同频改异频等）下进行终端部署。 本文档适用于移远通信 BC28-F 和 BC95-GF 模块。 上海移远通信技术股份有限公司 6 / 23 BC28-F&BC95-GF 终端应用设计指导 2 终端应用设计指导 本章节主要针对移远通信 BC28-F 和 BC95-GF 模块的各类终端应用提供设计指导和建议。 2.1. 固定上报类 固定上报类的终端应用部署位置固定，数据传输业务具有周期性；大部分时间处于睡眠状态，无需接 收监听下行消息，仅在终端发送上行数据时接收下行数据。该类终端应用一般对数据实时性要求低，但对 功耗和数据传输成功率要求高，建议遵循以下设计方案。 2.1.1. 网络参数配置要求 表 1：固定上报类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 打开 备注 如上表格所述功能由核心网配置，因此需要与运营商确认功能开启和关闭状态。 2.1.2. 终端设计建议 表 2：固定上报类终端应用设计参考项 序号 设计参考项 1 开机入网超时时间 针对最后一条上行数据启用 2 RAI 功能 说明 由于模块在网络环境发生变化后或在深度覆盖下入网时间较长，因 此建议将 MCU 开机入网超时时间设置为不小于 300 秒。 最 后 一 条 上 行 数 据 业 务 采 用 带 有 RAI 功 能 的 命 令 （ 例 如 ： AT+QLWULDATAEX=3,AA34BB,0x0001）发送，通知核心网立 上海移远通信技术股份有限公司 7 / 23 BC28-F&BC95-GF 终端应用设计指导 即释放 RRC 连接。随后模块将快速进入到 Idle 状态，待 T3324 （模块在 Idle 状态下进入 PSM 的激活时间定时器）超时后模块自 动进入 PSM 模式。 若需要给模块断电，则需先执 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，触发模块保存 3 行 AT+CFUN=0 再断电 频点、向网络发送去附着消息。 ⚫ 通过中国电信 IoT 平台或中国电信 AEP 平台发送数据时，若 返回+CME ERROR: 513（513: Platform not registered）错 误（前提是设置了 AT+CMEE=1），MCU 延时 20 秒后再次尝 试发送数据；若连续 3 次数据均发送失败，则进入异常处理 4 数据传输业务 流程（参考如下第 5 项）。 ⚫ 进行正常数据传输业务时，在业务数据交互过程中，若 60 秒 内未收到下行数据，则判定本次数据业务因超时而失败，再次 尝试发送数据；若 3 次尝试均超时失败，则进入异常处理流 程（参考如下第 5 项）。 若入网异常或数据传输业务失败，请按如下步骤进行异常处理： 1) 执行 AT+NRB 重启模块 2) 执行 AT+CFUN=0 开启最小功能模式 3) 执行 AT+NCSEARFCN 清除先验频点 5 异常处理流程 4) 执行 AT+CFUN=1 开启全功能模式 5) 执行 AT+CGATT=1 附着网络 6) 再次尝试入网以及数据传输业务 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 8 / 23 BC28-F&BC95-GF 终端应用设计指导 2.1.3. 终端设计参考流程 模块上电 设置手动入网 AT+NCONFIG=AUTOCONNECT,FALSE 设置CDP服务器地址 若使用UDP/TCP通讯， AT+NCDP=[,] 则跳过此步骤 软件重启模块 AT+NRB 指定频段 AT+NBAND= 设置全功能模式 AT+CFUN=1 关闭模块eDRX功能 AT+CEDRXS=0,5 触发网络附着 AT+CGATT=1 网络附着 数据传输业务 是 检查是否 获取到IP地址 AT+CGPADDR=0 数据传输 是否成功? 连续3次接收下行数 据超时（60秒） 否 最后一包上行数据采 是 用带RAI功能的命令 Idle模式 否 300 s后未获取到IP地址 重启模块 AT+NRB 设置最小功能模式 AT+CFUN=0 触发网络附着 AT+CFUN=1 AT+CGATT=1 清除先验频点 AT+NCSEARFCN 是否断电? 否 推荐进入PSM模式； 若业务完成后采取断电 是 方式，建议进入Idle后 延时至少15秒，执行 AT+CFUN=0，再断电 PSM AT+CFUN=0 是否继续 尝试入网? 根据退避算法连 否 续3次入网失败 是 异常处理 断电关机 图 1：固定上报类终端应用参考流程 上海移远通信技术股份有限公司 9 / 23 BC28-F&BC95-GF 终端应用设计指导 2.2. 移动上报类 移动上报类终端应用会在移动状态下进行数据传输业务；无需接收寻呼消息，仅在终端发送上行数据 时接收下行数据。该类终端应用一般对数据实时性要求低，但对功耗要求高，建议遵循以下设计要求。 2.2.1. 网络参数配置要求 表 3：移动上报类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 打开 备注 如上表格所述功能由核心网配置，因此需要与运营商确认功能开启和关闭状态。 2.2.2. 终端设计建议 表 4：移动上报类终端应用设计参考项 序号 设计参考项 说明 1 开机入网超时时间 由于模块在网络环境发生变化后或在深度覆盖下入网时间较长，因 此建议将 MCU 开机入网超时时间设置为不小于 300 秒。 最 后 一 条 上 行 数 据 业 务 采 用 带 有 RAI 功 能 的 命 令 （ 例 如 ： 针对最后一条上行数据启用 AT+QLWULDATAEX=3,AA34BB,0x0001）发送，通知核心网立 2 RAI 功能 即释放 RRC 连接。随后模块将快速进入到 Idle 状态，待 T3324 （模块在 Idle 状态下进入 PSM 的激活时间定时器）超时后模块自 动进入 PSM 模式。 若需要给模块断电，则需先执 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，触发模块保存 3 行 AT+CFUN=0 再断电 频点、向网络发送去附着消息。 ⚫ 通过中国电信 IoT 平台或中国电信 AEP 平台发送数据时，若 返回+CME ERROR: 513（513: Platform not registered）错 4 数据传输业务 误（前提是设置了 AT+CMEE=1），MCU 延时 20 秒后再次尝 试发送数据；若连续 3 次数据均发送失败，则进入异常处理 流程（参考如下第 5 项）。 ⚫ 进行正常数据传输业务时，在业务数据交互过程中，若 60 秒 上海移远通信技术股份有限公司 10 / 23 5 异常处理流程 BC28-F&BC95-GF 终端应用设计指导 后未收到下行数据，则判定本次数据业务因超时而失败，再次 尝试发送数据；若 3 次尝试均超时失败，则进入异常处理流 程（参考如下第 5 项）。 若入网异常或数据传输业务失败后，请按如下步骤进行异常处理： 1) 执行 AT+NRB 重启模块 2) 执行 AT+CFUN=0 开启最小功能模式 3) 执行 AT+NCSEARFCN 清除先验频点 4) 执行 AT+CFUN=1 开启全功能模式 5) 执行 AT+CGATT=1 附着网络 6) 再次尝试入网以及数据传输业务 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 11 / 23 BC28-F&BC95-GF 终端应用设计指导 2.2.3. 终端设计参考流程 模块上电 设置手动入网 AT+NCONFIG=AUTOCONNECT,FALSE 设置CDP服务器地址 若使用UDP/TCP通讯， AT+NCDP=[,] 则跳过此步骤 软件重启模块 AT+NRB 指定频段 AT+NBAND= 设置全功能模式 AT+CFUN=1 关闭模块eDRX功能 AT+CEDRXS=0,5 触发网络附着 AT+CGATT=1 网络附着 数据传输业务 是 检查是否 获取到IP地址 AT+CGPADDR=0 连续3次接收下行数 据超时（60秒） 数据传输 是否成功? 否 最后一包上行数据采 用带RAI功能的命令 是 Idle模式 否 300 s后未获取到IP地址 重启模块 AT+NRB 设置最小功能模式 AT+CFUN=0 触发网络附着 AT+CFUN=1 AT+CGATT=1 清除先验频点 AT+NCSEARFCN 是否继续 尝试入网? 是 PSM 否 根据退避算法连 续3次入网失败 断电关机 异常处理 图 2：移动上报类终端应用参考流程 上海移远通信技术股份有限公司 12 / 23 BC28-F&BC95-GF 终端应用设计指导 2.3. 控制类 控制类的终端应用在大部分时间处于在线状态，要求能实时接收下行数据和传输上行数据。该类终端 应用一般对功耗要求低，但对数据实时性要求高，建议遵循以下设计要求。 2.3.1. 网络参数配置要求 表 5：控制类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 关闭 备注 如上表格所述功能由核心网配置，因此需要与运营商确认功能开启和关闭状态。 2.3.2. 终端设计建议 表 6：控制类终端应用设计参考项 序号 设计参考项 说明 1 开机入网超时时间 由于模块在网络环境发生变化后或在深度覆盖下入网时间较长，因 此建议将 MCU 开机入网超时时间设置为不小于 300 秒。 若需要给模块断电，则需先执 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，触发模块保存 2 行 AT+CFUN=0 再断电 频点、向网络发送去附着消息。 ⚫ 通过中国电信 IoT 平台或中国电信 AEP 平台发送数据时，若 返回+CME ERROR: 513（513: Platform not registered）错 误（前提是设置了 AT+CMEE=1），MCU 延时 20 秒后再次尝 试发送数据；若连续 3 次数据均发送失败，则进入异常处理 3 数据传输业务 流程（参考如下第 4 项）。 ⚫ 进行正常数据传输业务时，在业务数据交互过程中，若 60 秒 后未收到下行数据，则判定本次数据业务因超时而失败，再次 尝试发送数据；若 3 次尝试均超时失败，则进入异常处理流 程（参考如下第 4 项）。 4 异常处理流程 若入网异常或数据传输业务失败后，请按如下步骤进行异常处理： 1) 执行 AT+NRB 重启模块 上海移远通信技术股份有限公司 13 / 23 BC28-F&BC95-GF 终端应用设计指导 2) 执行 AT+CFUN=0 开启最小功能模式 3) 执行 AT+NCSEARFCN 清除先验频点 4) 执行 AT+CFUN=1 开启全功能模式 5) 执行 AT+CGATT=1 附着网络 6) 再次尝试入网以及数据传输业务 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 14 / 23 BC28-F&BC95-GF 终端应用设计指导 2.3.3. 终端设计参考流程 模块上电 设置手动入网 AT+NCONFIG=AUTOCONNECT,FALSE 设置CDP服务器地址 若使用UDP/TCP通讯， AT+NCDP=[,] 则跳过此步骤 软件重启模块 AT+NRB 指定频段 AT+NBAND= 设置全功能模式 AT+CFUN=1 关闭模块eDRX功能 AT+CEDRXS=0,5 关闭模块PSM功能 AT+CPSMS=0 触发网络附着 AT+CGATT=1 网络附着 数据传输业务 是 连续3次接收下行数 据超时（60秒） 数据传输 是否成功? 否 是 Idle模式 检查是否 获取到IP地址 AT+CGPADDR=0 否 300 s后未获取到IP地址 重启模块 AT+NRB 设置最小功能模式 AT+CFUN=0 清除先验频点 AT+NCSEARFCN 触发网络附着 AT+CFUN=1 AT+CGATT=1 是否继续 尝试入网? 否 根据退避算法连 续3次入网失败 断电关机 是 异常处理 图 3：控制类终端应用参考流程 上海移远通信技术股份有限公司 15 / 23 BC28-F&BC95-GF 终端应用设计指导 3 模块入网流程 模块入网方式有两种：自动入网和手动入网，本章节将详细介绍这两种入网模式的初始化流程。模块 入网时间大约在 7~15 秒左右（覆盖等级 ECL = 0 时），更多入网机制详情请参考文档 [1]。 模块默认以自动模式入网，为了在模块入网前完成终端应用设计所需的相关配置，建议模块上电开机 后先通过 AT+NCONFIG=AUTOCONNECT,FALSE 设置手动入网。 上海移远通信技术股份有限公司 16 / 23 BC28-F&BC95-GF 终端应用设计指导 3.1. 自动入网 模块默认以自动入网模式入网。模块上电后系统开始运行，本地初始化完毕后，立即开始搜寻网络信 号。自动入网模式场景初始化流程如下图所示。 开始 模块上电后自动开机，约5秒之后会输出 OK字样，表示模块可以执行AT命令。 直接发送AT，检查串口通信是否正常。量产之 前需要确认MCU与模块之间的波特率是否完全 匹配，即在高低温环境中MCU发送约 1 KB的数 据，检查MCU与模块通信是否正常。 确认串口通信正常后，检查USIM卡是否初始化 成功。若初始化失败，延时1秒后再查询；如果 连续10次都失败，则建议软件重启模块或者检 查USIM卡硬件电路。 USIM正常初始化之后，模块则开始搜寻网络。 AT+CSQ可查询无线网络的RSSI，取值范围： 0~31；99表示没有搜寻到网络。 查询模块的网络注册状态。返回值的第二个参数 为1表示成功注册本地网络；第二个参数为5表 示成功注册漫游网络；第二个参数为2时表示模 块正在注册。详细可参考文档 [2]。MCU可以每 隔1秒查询一次网络注册状态。 查询模块的PDP上下文激活状态。返回1表示激 活成功，返回0表示激活失败。 查询模块是否获取到IP，正常IP场景中，PDP已 经激活时，网络均会给模块分配一个IP地址。 模块上电 等待输出 OK 否 AT通信是否正常 是 否 AT+CIMI 是 否 AT+CSQ 是 否 AT+CEREG? 是 否 AT+CGATT? 是 否 AT+CGPADDR=0 是 数据业务 结束 图 4：模块自动入网模式场景初始化流程 上海移远通信技术股份有限公司 17 / 23 BC28-F&BC95-GF 终端应用设计指导 3.2. 手动入网 通过 AT+NCONFIG=AUTOCONNECT,FALSE 设置手动上网，手动入网模式场景初始化流程如下图所 示。 模块上电后自动开机，约5秒之后会输出OK 字样，表示模块可以执行AT命令。 直接发送AT，检查串口通信是否正常。量产之 前需要确认MCU与模块之间的波特率是否完全 匹配，即在高低温环境中MCU发送约1 KB的数 据，检查MCU与模块通信是否正常。 判断是否是手动入网模式，若已经是手动方 式则可以直接进行下一步。 该步骤激活modem功能，打开射频开关。如 果需要指定模块的频段，需要在AT+CFUN=1 之前执行。 确认串口通信正常后，检查USIM卡是否初始 化成功。若初始化失败，延时1秒后再查询； 如果连续10次都失败，则建议软件重启模块 或者检查USIM卡硬件电路。 触发模块开始搜寻网络。 AT+CSQ可查询无线网络的RSSI。取值范围： 0~31；99表示没有搜寻到网络。 查询模块的网络注册状态。返回值的第二个参 数为1表示成功注册本地网络；第二个参数为5 表示成功注册漫游网络；第二个参数为2时表示 模块正在注册。详细可参考文档 [2]。MCU可以 每隔1秒查询一次网络附着状态。 查询模块的PDP上下文激活状态。返回1表示 激活成功，返回0表示激活失败。 查询模块是否获取到IP，正常IP场景中， PDP已经激活时，网络均会给模块分配一个 IP地址。 开始 模块上电 等待输出 OK 否 AT通信是否正常 是 AT+NCONFIG?查询是否是 手动入网模式 是 AT+CFUN=1 否 AT+NRB AT+NCDP=[,] (若使用UDP/TCP通讯，则跳过此步骤) AT+NCONFIG=AUTOCONNECT, FALSE 否 AT+CIMI 是 AT+CGATT=1 否 AT+CSQ 是 否 AT+CEREG? 是 否 AT+CGATT? 是 否 AT+CGPADDR 是 数据业务 结束 图 5：模块手动入网模式场景初始化流程 上海移远通信技术股份有限公司 18 / 23 BC28-F&BC95-GF 终端应用设计指导 4 模块 PSM 模式唤醒 模块进入 PSM 模式时，功耗典型值约为 0.8 µA 左右，此时模块的 modem 已经与基站断开连接，无 法接收到基站的任何消息。同时模块的各个内核也处于关闭状态。当设置 AT+NPSMR=1 时，模块退出 PSM 模式时会有 URC 信息+NPSMR: 0 输出。通过命令 AT+NPSMR?也可以查询模块当前是否处于 PSM 模式。 当模块进入 PSM 模式后，以下场景可能会导致退出 PSM 模式。 4.1. 3GPP 协议策略唤醒 3GPP 协议规定的各种原因唤醒模块，主要是 TAU（位置跟踪区域更新）唤醒模块，包括周期性唤醒。 4.2. 业务数据的相关策略唤醒 如下业务数据会导致模块从 PSM 模式中被唤醒： ⚫ 外部 MCU 发送上行数据； ⚫ 模块连接中国电信物联网开放平台时，若注册无响应，超时重发策略会唤醒模块； ⚫ 发送 CON 类型的数据时，若超时未收到 ACK，重传策略会唤醒模块； ⚫ 模块连接中国电信或中国移动物联网开放平台后，Lifetime 定时更新机制会唤醒模块。 4.3. 运营商自注册逻辑唤醒 如下运营商自注册逻辑会导致模块从 PSM 模式中被唤醒： ⚫ 中国电信运营商自注册逻辑 ⚫ 中国移动运营商 DM 注册逻辑 上海移远通信技术股份有限公司 19 / 23 BC28-F&BC95-GF 终端应用设计指导 5 补充说明 5.1. 常规维护测试手段 ⚫ 终端支持上报网络相关信息且可在平台上显示：如频点（EARFCN）、小区 ID、覆盖等级（ECL）、 信号强度（RSRP）、信噪比（SNR）等，相关信息可通过 AT+NUESTATS 命令来获取。 ⚫ 终端支持本地接口升级及信息查询：通过本地接口，可查看模块运行日志、修改配置参数以及完 成对模块的本地固件版本升级。 5.2. 终端整机设计建议 ⚫ 针对模块不断电的终端应用，为保证模块长期有效的通讯，建议大约每隔一个月重启一次模块。 ⚫ 客户终端设计的时候建议一定要在弱信号下（ECL = 2 时）进行验证测试，保证终端设备的各种异 常场景处理机制能生效。 ⚫ 客户整机设计投产之前建议将终端入网相关的流程机制发送给移远通信技术支持人员检查，以确 保终端设备在各种复杂外场环境中能有效接入网络。 5.3. 相关 AT 命令说明 本章节简要列举了 BC28-F 和 BC95-GF 终端应用设计相关的 AT 命令。如需更多 AT 命令详情，请参 考文档 [2]。 表 7：相关 AT 命令说明 序号 AT 命令 1 AT+NCONFIG=AUTOCONNECT,FALSE 说明 设置模块手动入网 上海移远通信技术股份有限公司 20 / 23 BC28-F&BC95-GF 终端应用设计指导 2 AT+NCDP=[,] 设置 CDP 服务器地址 3 AT+NRB 重启模块 4 AT+NBAND= 指定具体频段 5 AT+CFUN=0 设置最小功能模式 6 AT+CFUN=1 设置全功能模式 7 AT+CEDRXS=0,5 关闭模块 eDRX 功能 8 AT+CGATT=1 触发网络附着 9 AT+CGATT? 查询网络附着状态 10 AT+CGPADDR=0 获取 IP 地址 11 AT+CPSMS=0 关闭模块 PSM 功能 可发送携带辅助释放指示的 CoAP 数据，用于 12 AT+QLWULDATAEX=,, 指示核心网立即释放连接，以便模块快速进入 [,] Idle 状态。 13 AT+NUESTATS 查询最近一次所驻留小区的 EARFCN、小区 ID、ECL、RSRP 和 SNR 等信息。 清除模块保存的先验频点，当下一次启动搜索 14 AT+NCSEARFCN 网络时，根据场景信号强度选择频点。该命令 需要在 AT+CFUN=0 的状态下执行。 15 AT+CMEE=1 启用+CME ERROR: 结果码 16 AT+CIMI 获取国际移动用户识别码 17 AT+CSQ 获取信号强度指示 18 AT+CEREG? 查询网络注册状态 19 AT+NPSMR=1 启用 PSM 状态上报 20 AT+NPSMR? 查询模块当前是否处于 PSM 模式 上海移远通信技术股份有限公司 21 / 23 BC28-F&BC95-GF 终端应用设计指导 6 附录 A 参考文档及术语缩写 表 8：参考文档 序号 文档名称 [1] Quectel_BC28-F&BC95-GF_搜网机制说明 [2] Quectel_BC28-F&BC95-GF_AT 命令手册 描述 BC28-F 和 BC95-GF 搜网机制说明 BC28-F 和 BC95-GF AT 命令手册 表 9：术语缩写 缩写 英文全称 中文全称 ACK Acknowledgement 确认消息 AEP Application Enablement Platform 应用使能平台 CDP Continuous Data Protection 持续数据保护 CoAP Constrained Application Protocol 受限应用协议 CON Confirmable Message 需应答消息 DM EARFCN ECL Device Management E-UTRA Absolute Radio Frequency Channel Number Enhanced Coverage Level 设备管理 E-UTRA 绝对无线频率信道号 增强型覆盖等级 eDRX Extended Discontinuous Reception 增强型非连续接收 E-UTRA Evolved Universal Terrestrial Radio Access 演进通用地面无线接入 IP Internet Protocol 互联网协议 MCU Microcontroller Unit 微型控制单元 PDP Packet Data Protocol 分组数据协议 上海移远通信技术股份有限公司 22 / 23 PSM RAI RRC RSRP RSSI SNR TAU TCP UDP URC USIM Power Saving Mode Release Assistant Indication Radio Resource Control Reference Signal Received Power Received Signal Strength Indicator Signal Noise Ratio Tracking Area Update Transmission Control Protocol User Datagram Protocol Unsolicited Result Code Universal Subscriber Identity Module BC28-F&BC95-GF 终端应用设计指导 省电模式 释放辅助指示 无线资源控制 参考信号接收功率 接收信号强度指示 信噪比 位置跟踪区域更新 传输控制协议 用户数据报协议 非请求结果码 全球用户识别卡 上海移远通信技术股份有限公司 23 / 23

BC25 终端应用设计指导 NB-IoT 模块系列 版本：BC25_终端应用设计指导_V1.1 日期：2019-12-11 状态：受控文件 www.quectel.com BC25 终端应用设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 14 BC25 终端应用设计指导 文档历史 修订记录 版本 1.0 1.1 日期 2019-07-17 2019-12-11 作者 方亮/ 顾根全 张先保 变更表述 初始版本 增加移动 OneNET 和电信物联网平台深度睡眠唤醒后直接发 送数据功能的描述（第 2.1.2 章）。 上海移远通信技术股份有限公司 2 / 14 BC25 终端应用设计指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 终端应用设计指导 ................................................................................................................................. 7 2.1. 上报类......................................................................................................................................... 7 2.1.1. 网络参数配置要求 ........................................................................................................... 7 2.1.2. 终端设计建议................................................................................................................... 7 2.1.3. 终端参考流程................................................................................................................... 9 2.2. 控制类....................................................................................................................................... 10 2.2.1. 网络参数配置要求 ......................................................................................................... 10 2.2.2. 终端设计建议................................................................................................................. 10 2.2.3. 终端参考流程..................................................................................................................11 3 补充说明 .............................................................................................................................................. 12 3.1. 常规维护测试手段 .................................................................................................................... 12 3.2. 相关 AT 命令说明 ..................................................................................................................... 12 4 附录 A 参考文档及术语缩写................................................................................................................ 13 上海移远通信技术股份有限公司 3 / 14 BC25 终端应用设计指导 表格索引 表 1：上报类终端应用网络参数配置要求 ............................................................................................................ 7 表 2：上报类终端应用设计参考项 ....................................................................................................................... 7 表 3：控制类终端应用网络参数配置要求 .......................................................................................................... 10 表 4：控制类终端应用设计参考项 ..................................................................................................................... 10 表 5：相关 AT 命令说明 ..................................................................................................................................... 12 表 6：参考文档 .................................................................................................................................................. 13 表 7：术语缩写 .................................................................................................................................................. 13 上海移远通信技术股份有限公司 4 / 14 BC25 终端应用设计指导 图片索引 图 1：上报类终端应用参考流程 ........................................................................................................................... 9 图 2：控制类终端应用参考流程 ..........................................................................................................................11 上海移远通信技术股份有限公司 5 / 14 BC25 终端应用设计指导 1 引言 目前，移远通信 NB-IoT 模块主要应用于如下两类终端应用场景：  上报类：固定上报类终端，如水表、气表、烟感报警器等；移动上报类终端，如共享单车、智能 手环等。  控制类：如路灯、共享洗衣机、电动车控制器等。 本文档针对上述两大类终端应用场景提供设计指导，以便于客户在不同的网络部署环境（部署频点变 更、同频改异频等）下进行终端部署。 本文档适用于如下移远通信 NB-IoT 模块：  BC25：软件版本 BC25_R01A04 及后续版本；  BC25-B5：软件版本 BC25B5_R01A04 及后续版本；  BC25-B8：软件版本 BC25B8_R01A05 及后续版本。 上海移远通信技术股份有限公司 6 / 14 BC25 终端应用设计指导 2 终端应用设计指导 本章节分别根据 BC25 模块各类终端应用提供设计指导和建议。 2.1. 上报类 上报类终端应用的数据传输业务具有周期性；大部分时间处于睡眠状态，无需接收寻呼消息，仅在终 端发送上行数据时接收下行数据。此类终端应用要求低功耗以及高数据传输成功率，但对数据传输的实时 性要求低，建议遵循以下设计要求。 2.1.1. 网络参数配置要求 表 1：上报类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 开启 备注 如上表格所述功能由核心网配置，因此须与运营商确认功能开启和关闭状态。 2.1.2. 终端设计建议 表 2：上报类终端应用设计参考项 序号 设计参考项 说明 1 开机入网超时时间 由于网络变化或在深度覆盖下，终端入网时间较长，因此建议 MCU 开机入网超时时间不小于 300s。入网超时后，则进入异常处理流程。 2 使用 AT+CPSMS=1,,,,命 令配置 PSM 参数 （T3324）。模块发完最后一包数据、核心网释放连接后，模块处于 Idle 状态，T3324 时间超时后模块才会进入 PSM 状态。 的默认请求值为 2 分钟，请求值是否生 效取决于核心网（目前实测，移动 NB-IoT 卡允许配置；电信 NB-IoT 卡是否可配置，和开卡时选择的 APN 类型有关）。 模块断电之前需进行如下步骤： 1) 等待模块进入 Idle 状态后至少 15 秒，使得网络可以通过配置 若需要给模块断电，则须在 3 模块进入 Idle 状态 15 秒后， T3324 定时器，保证模块有足够的时间完成小区测量及重选过 程； 执行 AT+CFUN=0 再断电 2) 通过 MCU 向模块发送 AT+CFUN=0 命令，触发模块向核心网 发送去附着消息。  当前版本已支持深度睡眠后保存连接状态，如果连接了电信物 4 数据传输业务 联网平台、移动 OneNET 平台或者建立了 UDP 连接，唤醒后 恢复成功即可直接发送数据，无需重新连接（请参考文档 [5]）。  进行正常数据传输业务时，在业务数据交互过程中，若 60s 后 未收到下行数据，则判定本次数据业务因超时而失败并再次尝 试发送数据；若 3 次尝试均超时失败，则进入异常处理流程。 5 DFOTA 入网后模块可以使用 AT+QFOTADL 命令从 HTTP 服务器获取差分 包进行在线升级，详细请参考文档 [2]。 若入网异常或数据传输业务失败后，请按如下流程进行异常处理： 6 异常处理流程 1) 执行 AT+QCSEARFCN=0 命令（清除先验频点）； 2) 拉低模块 RESET 引脚（重启模块）； 3) 再次尝试入网以及数据传输业务； 4) 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 8 / 14 2.1.3. 终端参考流程 BC25 终端应用设计指导 设置关闭模块休眠 AT+QS CLK=0 指定Band AT+QBAND=, 重启模块 拉低模块RESE T引脚 如果使用单频模块如BC25-B5、 BC25-B8则跳过该步骤 数据传输业务 Yes 数据传输 是否成功? 连续3次接收下行数 据超时（60s） No Yes 最后一包上行数据建议 采用带RAI功能的命令 Idle模式 模块上电 设置关闭模块休眠 AT+QS CLK=0 关闭模块eDRX功能 AT+CEDRXS=0 打开模块PS M功能 AT+CPSMS=1 网络附着 检查是否 成功入网 300s后，AT+CGATT?查询不 No 等于1 或者AT+CGPADDR?查 询未获取IP地址 是否继续 尝试入网? Yes No 清除先验频点 AT+QCSE ARFCN=0 是否断电? No Yes 若业务完成后采取断电 方式，建议进入Idle后 延时至少15s，执行 AT+CFUN=0，再断电 设置允许模块休眠 AT+QS CLK=1 AT+CFUN=0 检查是否 成功进入休眠 Yes 深休眠 No 300s后，未上报 +QATSLEE P或者发 送AT仍然能返回OK 重启模块 拉低模块RESE T引脚 根据退避算法连 续3次入网失败 异常 处理 断电关机 图 1：上报类终端应用参考流程 上海移远通信技术股份有限公司 9 / 14 BC25 终端应用设计指导 2.2. 控制类 控制类的终端应用通常由外部电源供电；大部分时间处于在线状态，能实时接收下行数据。该类终端 应用对数据实时性要求高，对功耗要求低，建议遵循以下设计要求。 2.2.1. 网络参数配置要求 表 3：控制类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 关闭 备注 如上表格所述功能由核心网配置，因此须与运营商确认功能开启和关闭状态。 2.2.2. 终端设计建议 表 4：控制类终端应用设计参考项 序号 设计建议参数 说明 1 开机入网超时时间 由于网络变化或在深度覆盖下，终端入网时间较长，因此建议 MCU 开机入网超时时间不小于 300s。入网超时后，则进入异常处理流程。 2 若需要给模块断电，则须先 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，向网络发送去附 执行 AT+CFUN=0 再断电 着消息。 进行正常数据传输业务时，在业务数据交互过程中，若 60s 后未收 3 数据传输业务 到下行数据，则判定本次数据业务因超时而失败，再次尝试发送数 据；若 3 次尝试均超时失败，则进入异常处理流程。 4 DFOTA 入网后模块可以使用 AT+QFOTADL 命令从 HTTP 服务器获取差分 包进行在线升级，详细请参考文档 [2]。 若入网异常或数据传输业务失败后，请按如下流程进行异常处理： 1) 执行 AT+QCSEARFCN=0 命令（清除先验频点）； 5 异常处理流程 2) 拉低模块 RESET 引脚（重启模块）； 3) 再次尝试入网以及数据传输业务； 4) 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 10 / 14 2.2.3. 终端参考流程 BC25 终端应用设计指导 设置关闭模块休眠 AT+QS CLK=0 指定Band AT+QBAND=, 重启模块 拉低模块RESE T引脚 如果使用单频模块如BC25-B5、 BC25-B8则跳过该步骤 模块上电 设置关闭模块休眠 AT+QS CLK=0 关闭模块eDRX功能 AT+CEDRXS=0 关闭模块PS M功能 AT+CPSMS=0 网络附着 数据传输业务 Yes 数据传输 连续3次接收下行数 据超时（60s） 是否成功? No 最后一包上行数据建议 Yes 采用带RAI功能的命令 Idle模式 检查是否 成功入网 No 300s后，AT+CGATT?查询不 等于1 或者AT+CGPADDR?查 询未获取IP地址 是否继续 尝试入网? Yes 清除先验频点 No AT+QCSE ARFCN=0 重启模块 拉低模块RESE T引脚 根据退避算法连 续3次入网失败 断电关机 异常 处理 图 2：控制类终端应用参考流程 上海移远通信技术股份有限公司 11 / 14 BC25 终端应用设计指导 3 补充说明 3.1. 常规维护测试手段 终端支持网络相关信息的上报且可在平台上显示，例如频点（EARFCN）、小区 ID、覆盖等级（ECL）、 信号强度（RSRP）、信噪比（SNR）等，此相关信息可通过 AT+QENG=0 命令来获取。 3.2. 相关 AT 命令说明 本章节列举了与 BC25 终端应用设计相关的 AT 命令，更多详情请参考文档 [1]、文档 [2]、文档 [3] 和 文档 [4]。 表 5：相关 AT 命令说明 序号 AT 命令 说明 1 AT+CEDRXS=0 关闭模块 eDRX 功能。 2 AT+CGATT? 查询模块是否成功入网。 3 AT+CGPADDR? 查询模块是否获取 IP 地址。 4 AT+CPSMS=0 关闭模块 PSM 功能。 5 AT+MIPLNOTIFY=,,, ,,,,,,[,[,]] 可发送携带标志位的 OneNET 数据，用于指示核 心网立即释放连接，以便模块快速进入 Idle 状态。 6 AT+NMGS=,[,] 可发送携带 RAI 的 CoAP 数据，用于指示核心网 立即释放连接，以便模块快速进入 Idle 状态。 7 AT+QENG=0 查询最近一次所驻留小区的 EARFCN、小区 ID、 ECL、RSRP 和 SNR 等信息。 8 AT+QCSEARFCN=0 清除模块保存的先验频点，当下一次启动搜索网 时，根据场景信号强度选择频点。 9 AT+CFUN=0 关闭模块的射频功能块。 上海移远通信技术股份有限公司 12 / 14 BC25 终端应用设计指导 4 附录 A 参考文档及术语缩写 表 6：参考文档 序号 文档名称 备注 [1] Quectel_BC25_AT 命令手册 BC25 AT 命令手册 [2] Quectel_BC25&BC32_DFOTA_应用指导 BC25 和 BC32 模块 DFOTA 应用指导 [3] Quectel_BC25_中国电信 loT 平台应用指导 BC25 中国电信物联网平台应用指导 [4] Quectel_BC25&BC32_OneNET_应用指导 BC25 和 BC32 模块 OneNET 平台应用指导 [5] Quectel_BC25_软件开发注意事项及常见问题 BC25 模块的软件开发注意事项和常见问题解答 表 7：术语缩写 缩写 APN CoAP EARFCN ECL eDRX DFOTA HTTP MCU NB-IoT PSM 英文全称 中文全称 Access Point Name 接入点名称 Constrained Application Protocol E-UTRA Absolute Radio Frequency Channel Number Enhanced Coverage Level 受限应用协议 E-UTRA 绝对射频频道号 增强覆盖范围 Extended Discontinuous Reception 增强型非连续接收 Differential Firmware Over-The-Air 固件空中差分升级 HyperText Transfer Protocol 超文本传输协议 Microprogrammed Control Unit 微控单元 Narrow Band Internet of Things 窄带物联网 Power Saving Mode 节电模式 上海移远通信技术股份有限公司 13 / 14 RAI RRC RSRP SNR UDP Release Assistance Indication Radio Resource Control Reference Signal Received Power Signal Noise Ratio User Datagram Protocol BC25 终端应用设计指导 释放辅助指示 无线资源控制 参考信号接收功率 信噪比 用户数据报协议 上海移远通信技术股份有限公司 14 / 14

BC26&BC20&BC030x 系列 终端应用设计指导 NB-IoT 模块系列 版本：BC26&BC20&BC030x 系列_终端应用设计指导_V1.0 日期：2020-03-31 状态：受控文件 www.quectel.com BC26&BC20&BC030x 系列终端应用设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 13 BC26&BC20&BC030x 系列终端应用设计指导 文档历史 修订记录 版本 1.0 日期 2020-03-31 作者 饶晨 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 13 BC26&BC20&BC030x 系列终端应用设计指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 推荐的终端应用设计.............................................................................................................................. 7 2.1. 功耗敏感型业务场景................................................................................................................... 7 2.1.1. 推荐设计 .......................................................................................................................... 8 2.1.2. 流程描述 .......................................................................................................................... 9 2.2. 非功耗敏感型业务场景 ............................................................................................................. 10 2.2.1. 推荐设计 ........................................................................................................................ 10 2.2.2. 流程描述 ........................................................................................................................ 11 3 附录 A 参考文档和术语缩写............................................................................................................... 12 上海移远通信技术股份有限公司 3 / 13 BC26&BC20&BC030x 系列终端应用设计指导 表格索引 表 1：推荐的终端应用设计流程描述（功耗敏感型业务） ................................................................................... 9 表 2：推荐的终端应用设计流程描述（功耗非敏感型业务） ............................................................................. 11 表 3：参考文档 .................................................................................................................................................. 12 表 4：术语缩写 .................................................................................................................................................. 12 上海移远通信技术股份有限公司 4 / 13 BC26&BC20&BC030x 系列终端应用设计指导 图片索引 图 1：推荐的终端应用设计逻辑（功耗敏感型业务） .......................................................................................... 8 图 2：推荐的终端应用设计逻辑（非功耗敏感型业务）..................................................................................... 10 上海移远通信技术股份有限公司 5 / 13 BC26&BC20&BC030x 系列终端应用设计指导 1 引言 本文档主要通过为一些典型的业务应用场景提供软件设计推荐，以便通过移远通信的如下 NB-IoT 模块 便捷地设计出终端应用程序。  BC26  BC20  BC030x 系列（包含 BC3030S-CN 和 BC030N-B5） 上海移远通信技术股份有限公司 6 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2 推荐的终端应用设计 本章针对功耗敏感型和非功耗敏感型终端应用场景，分别提供推荐的应用设计，以便用户根据实际业 务需求而选择合适的推荐设计。 模块默认打开 PSM 和 eDRX 模式，同时支持通过 AT 命令控制是否使能 PSM 和 eDRX，也可通过 AT 命令配置 PSM 和 eDRX 参数。但通过 AT 命令配置的 PSM/eDRX 参数仅仅是模块所支持以及建议的参数， 最终该建议的参数是否被采纳依赖于网络配置。 受运营商频点部署的变化影响，模块注网的时间可能较长，建议按 300 秒的注网超时判断设计 MCU 逻辑。若存在弱网信号，导致模块反复尝试注册并且超过 300 秒仍无法注网成功，则建议参考推荐设计清 频（清除模块已存储的 EARFCN 列表）。 2.1. 功耗敏感型业务场景 对于功耗敏感型业务的应用场景，建议启用 PSM 和 eDRX 以达到降低功耗的目的。 上海移远通信技术股份有限公司 7 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2.1.1. 推荐设计 上电 开机 AT+QRST=1 关机 ＜ 3次， 次数 + 1 3次 重启次数 未准备好 无IP URC上报 AT+QCGDEF 是 CONT AT+QCSEARFCN AT+CFUN=0 300秒超时 未注册成功 AT+IPR？ AT+CPIN? 准备就绪 AT+CIMI AT+QCCID 配置PDN 和 APN 否 AT+QNBIOTEVENT AT+CEREG=5 AT+CGATT？ AT+CEREG？ 注册成功 重试次数重置为0 +IP: xxx AT+CGPADDR? IP URC上报 重试3次 数据传输失败 配置 PSM 和 eDRX 否 传输数据 数据传输成功 Idle PSM 深休眠 （Deep Sleep） 配置波特率 AT+IPR= 是 AT+CPSMS AT+CEDRXS TAU已完成 +CEREG: xxx 图 1：推荐的终端应用设计逻辑（功耗敏感型业务） 上海移远通信技术股份有限公司 8 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2.1.2. 流程描述 表 1：推荐的终端应用设计流程描述（功耗敏感型业务） 序号 概要介绍 1 上电 2 开机 3 AT+IPR? 4 AT+CPIN? AT+CIMI 5 AT+QCCID 6 AT+QCGDEFCONT AT+QNBIOTEVENT 7 AT+CEREG=5 AT+CGATT? 8 AT+CEREG? 9 AT+CGPADDR? 10 +IP: xxx 11 AT+CPSMS 12 AT+CEDRXS 13 AT+CFUN=0 14 AT+QCSEARFCN 15 AT+QRST=1 16 关机 描述 给模块供电。 拉低 PWRKEY 引脚至少 500 毫秒以打开模块。 模块默认处于自适应波特率模式。 模块上电后，MCU 必须连续发送 AT 命令以便和模块进行波特率同 步，直至返回 OK。同步成功后，MCU 可以发送 AT+IPR= 配 置后续通信的波特率。 建议执行 AT+IPR= 设置波特率之前，先查询当前波特率设置。 检查当前 USIM 状态。 查询 USIM 卡的 IMSI 和 ICCID。 配置默认 PDN 连接（=1）的 APN 和 PDN 类型。 该命令在模块重启后生效。 为 PSM 事件和 EPS 注网状态启用 URC 上报。 查询当前 PS 附着状态和 EPS 注网状态。 查询网络分配的 IP 地址。 当 PDP 场景成功与指定的 PDN 连接时，将上报此 URC。 该 URC 上报之前，MCU 无法执行任何数据传输。 设置请求扩展周期 TAU 值（T3412）和激活时间值（T3324）。 可通过 AT+CEREG? 验证网络提供的值。 设置请求的 eDRX 周期。 可通过 AT+CEDRXRDP 验证网络提供的值。 当模块长时间（> 300 秒）无法注网时，执行该命令将模块设置为最 少功能模式。 清除模块已存储的 EARFCN 列表。 重启模块。 模块关机。 上海移远通信技术股份有限公司 9 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2.2. 非功耗敏感型业务场景 对于非功耗敏感型业务的应用场景，建议关闭 PSM 和 eDRX 以降低延迟。 2.2.1. 推荐设计 断电 无IP URC上报 AT+QRST=1 ＜3次， 次数 + 1 3次 重启次数 未准备好 上电 开机 AT+IPR？ 是 AT+CPIN? 已准备就绪 AT+CIMI AT+QCCID 配置波特率 AT+IPR= AT+QCGDEF 是 CONT 配置PDN和APN AT+QCSEARFCN 否 AT+QNBIOTEVENT AT+CEREG=5 AT+CFUN=0 重试3次 数据传输失败 300秒超时 未注册成功 AT+CGATT？ AT+CEREG？ 注册成功 重试次数重置为0 +IP: xxx AT+CGPADDR? IP URC上报 配置 PSM 和 eDRX 否 传输数据 数据传输完成 Idle 是 AT+CPSMS=0 AT+CEDRXS=0 完成TAU +CEREG: xxx 图 2：推荐的终端应用设计逻辑（非功耗敏感型业务） 上海移远通信技术股份有限公司 10 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2.2.2. 流程描述 表 2：推荐的终端应用设计流程描述（功耗非敏感型业务） 序号 概要介绍 1 上电 2 开机 3 AT+IPR？ 4 AT+CPIN? AT+CIMI 5 AT+QCCID 6 AT+QCGDEFCONT AT+CGATT? 7 AT+CEREG? AT+QNBIOTEVENT 8 AT+CEREG=5 9 AT+CGPADDR? 10 +IP: xxx 11 AT+CPSMS=0 12 AT+CEDRXS=0 13 AT+CFUN=0 14 AT+QCSEARFCN 15 AT+QRST=1 16 关机 描述 给模块供电 拉低 PWRKEY 引脚至少 500 毫秒以打开模块。 模块默认处于自适应波特率模式。 模块上电后，MCU 必须连续发送 AT 命令以便和模块进行波特率同 步，直至返回 OK。同步成功后，MCU 可以发送 AT+IPR= 配 置后续通信的波特率。 建议执行 AT+IPR= 设置波特率之前，先查询当前波特率设置。 检查当前 USIM 状态。 查询 USIM 卡的 IMSI 和 ICCID。 配置默认 PDN 连接（=1）时的 APN 和 PDN 类型。 该命令在模块重启后生效。 查询当前 PS 附着状态和 EPS 注网状态。 建议在执行这两个命令之前等待 300 秒，以检查注网状态。 为 PSM 事件和 EPS 注网状态启用 URC 上报。 查询网络分配的 IP 地址。 当 PDP 场景成功与指定的 PDN 连接时，将上报此 URC。 该 URC 上报之前，MCU 无法执行任何数据传输。 禁用 PSM。 禁用 eDRX。 当模块长时间（> 300 秒）无法注网时，执行该命令将模块设置为最 少功能模式。 清除模块已存储的 EARFCN 列表。 重启模块。 模块关机。 上海移远通信技术股份有限公司 11 / 13 BC26&BC20&BC030x 系列终端应用设计指导 3 附录 A 参考文档和术语缩写 表 3：参考文档 序号 文档名称 备注 [1] Quectel_BC26&BC20&BC030x 系列_AT 命令 手册 BC26、BC20、BC030x 系列模块的 AT 命令手册 [2] Quectel_BC26_搜网机制说明 BC26 模块的网络搜索机制说明 表 4：术语缩写 术语 英文全称 APN Access Point Name EARFCN E-UTRA Absolute Radio Frequency Channel Number E-UTRA Evolved Universal Terrestrial Radio Access eDRX extended Discontinuous Reception EPS Evolved Packet System ICCID Integrated Circuit Card Identity IMSI International Mobile Subscriber Identity IP Internet Protocol MCU Microprogrammed Control Unit NB-IoT Narrowband Internet of Things PDN Public Data Network PDP Packet Data Protocol PS Packet Switch 中文全称 接入点名称 E-UTRA 绝对射频信道号 演进的通用陆基无线 扩展非连续接收 演进型分组系统 集成电路卡识别码 国际移动用户识别码 互联网协议 微程序控制器 窄带物联网 公用数据网 分组数据协议 分组交换 上海移远通信技术股份有限公司 12 / 13 BC26&BC20&BC030x 系列终端应用设计指导 PSM URC USIM Power Saving Mode Unsolicited Result Code Universal Subscriber Identity Module 省电模式 非请求结果码 通用用户身份识别模块 上海移远通信技术股份有限公司 13 / 13

LTE-A(Q) IMS Application Note LTE-A Module Series Version: 1.0 Date: 2021-08-18 Status: Released LTE-A Module Series Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. LTE-A(Q)_IMS_Application_Note 1 / 27 LTE-A Module Series Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. LTE-A(Q)_IMS_Application_Note 2 / 27 LTE-A Module Series About the Document Revision History Version 1.0 Date 2021-01-25 2021-08-18 Author Wythe WANG/ Yosef ZHANG Wythe WANG/ Yosef ZHANG Description Creation of the document First official release LTE-A(Q)_IMS_Application_Note 3 / 27 LTE-A Module Series Contents About the Document ................................................................................................................................3 Contents .................................................................................................................................................... 4 Table Index ...............................................................................................................................................5 Figure Index ..............................................................................................................................................6 1 Introduction .......................................................................................................................................7 1.1. Applicable Modules ..................................................................................................................7 1.2. Introduction of MBN..................................................................................................................8 1.2.1. MBN File ........................................................................................................................8 1.2.2. MBN Type ......................................................................................................................8 1.2.3. MBN Selection ...............................................................................................................9 1.3. Introduction of IMS ...................................................................................................................9 1.3.1. IMS Registration Process ............................................................................................10 1.3.2. Processes of Services over IMS .................................................................................. 11 1.3.2.1. VoLTE ............................................................................................................... 11 1.3.2.2. SMS ..................................................................................................................12 1.3.2.3. Emergency Call.................................................................................................13 1.3.2.4. DTMF ................................................................................................................13 1.3.2.5. SRVCC .............................................................................................................14 2 IMS Related AT Command..............................................................................................................16 2.1. AT Command Introduction ......................................................................................................16 2.1.1. Definitions ....................................................................................................................16 2.1.2. AT Command Syntax ...................................................................................................16 2.2. Declaration of AT Command Examples ..................................................................................17 2.3. Description of AT Command ...................................................................................................17 2.3.1. AT+QCFG='ims' Configure IMS ...............................................................................17 2.3.2. AT+QMBNCFG Extended MBN Configuration ..........................................................18 2.3.2.1. AT+QMBNCFG='List' List All MBN Files........................................................18 2.3.2.2. AT+QMBNCFG='Select' Select a Specific MBN File .....................................19 2.3.2.3. AT+QMBNCFG='Deactivate' Deactivate MBN Files......................................20 2.3.2.4. AT+QMBNCFG='AutoSel' Configure MBN Automatic Selection....................20 2.3.2.5. AT+QMBNCFG='Delete' Delete a Specified MBN File ..................................21 2.3.2.6. AT+QMBNCFG='Add' Add a New MBN File..................................................22 2.4. Example .................................................................................................................................22 2.4.1. Upload MBN File Manually ..........................................................................................22 2.4.2. Automatic Selection Feature........................................................................................23 3 Appendix A References ..................................................................................................................25 LTE-A(Q)_IMS_Application_Note 4 / 27 LTE-A Module Series Table Index Table 1: Types of AT Commands ............................................................................................................. 16 Table 2: Related Documents ................................................................................................................... 25 Table 3: Terms and Abbreviations............................................................................................................ 25 LTE-A(Q)_IMS_Application_Note 5 / 27 LTE-A Module Series Figure Index Figure 1: IMS Registration Procedure ..................................................................................................... 10 Figure 2: VoLTE Call Procedure ...............................................................................................................11 Figure 3: SMS over IMS Procedure......................................................................................................... 12 Figure 4: Emergency Call over IMS Procedure ....................................................................................... 13 Figure 5: DTMF over IMS Procedure ...................................................................................................... 13 Figure 6: SRVCC over IMS Procedure .................................................................................................... 14 LTE-A(Q)_IMS_Application_Note 6 / 27 LTE-A Module Series 1 Introduction This document introduces application of the IMS feature from the following aspects. ⚫ Instruction of MBN (Modem Configuration Binary) ⚫ Instruction of IMS (IP Multimedia Subsystem) ⚫ AT commands and examples related to MBN and IMS 1.1. Applicable Modules Table 1: Applicable Modules Module Series LTE-A(Q) EG06 Series EM06 Series EP06 Series EG12 Series EG18 Series EM12-G EG512R-EA EM120R-GL EM121R-GL EM160R-GL LTE-A(Q)_IMS_Application_Note 7 / 27 LTE-A Module Series 1.2. Introduction of MBN 1.2.1. MBN File MBN (Modem Configuration Binary) files are a set of configurations that the system will read during module initialization to assign values for state variables to meet the operational requirements of carriers’ network, so as to configure IMS functions. MBN contains NV Item list with preset default values, EFS file list, MBN version information, and MBN-matching phone card information (ICCID, IMSI). And it is divided into three parts: NV Items Configuration Area, EFS File Configuration Area, and Trailer Record Configuration Area. In NV Items Configuration Area, there are different parameters based on operator's requirements to be set. The configuration area contains: MBN version, MBN version date, MBN-matching phone card information (ICCID, IMSI), etc. When the MBN to be activated is selected (automatically or manually), the module reads all the NVM/EFS item lists from the MBN, and write these default values into the configuration. After that, the module will operate based on these configurations. In the same way, when the MBN is deactivated, the module will delete all the NV/EFS item lists that have been read from the MBN. If an NV item of the MBN files is changed through AT command, when the MBN is activated or deactivated, the previously configured NV item will recover to default. The purpose of MBN file is to maintain different NV item lists and EFS file lists for operators based on IMSI and ICCID. Therefore, it is very convenient to support certification and VoLTE service. NOTE Please contact Quectel technical support (support@quectel.com) for the latest MBN list. 1.2.2. MBN Type In most cases, there is one ROW MBN and many operator MBNs in the module. The operator MBN files are used for certification or VoLTE requirements. Usually, it is named after abbreviations of operators’ names. However, not all operator MBN files enable IMS by default. The ROW MBN file is made of general NV settings. For example, the attached APN from ROW MBN file is null since ROW MBN file indicates to a non-specific operator. When the ROW MBN file activated, you LTE-A(Q)_IMS_Application_Note 8 / 27 LTE-A Module Series should write the list of mandatory NV items for network registration or service request by AT command manually. ROW MBN file is usually used when you cannot activate the operator MBNs based on the inserted SIM card. If no MBN file of a specific operator matches the inserted SIM card, ROW MBN file will be activated automatically. 1.2.3. MBN Selection You can check whether the automatic MBN selection is enabled by AT+QMBNCFG='AutoSel'. When MBN Auto Selection is enabled, the MBN file is activated based on the IMSI of the inserted SIM card. In case of no MBN file including the IMSI of the inserted SIM card, ROW MBN file will be activated. 1.3. Introduction of IMS IMS (IP Multimedia Subsystem) includes all CN elements for provision of IP multimedia services comprising audio, video, text, etc. and a combination of them delivered over the PS domain. VoLTE (Voice over LTE) is a new voice solution utilizing IMS technology. IMS is more like the bearer for the voice service. Except voice, IMS network also supports SMS, emergency calls, DTMF, etc. LTE-A(Q)_IMS_Application_Note 9 / 27 1.3.1. IMS Registration Process LTE-A Module Series Figure 1: IMS Registration Procedure IMS registration is the mandatory procedure for all services over IMS and the registration should be successful before any service triggered. You can check the IMS registration status by AT+QCFG='ims'. LTE-A(Q)_IMS_Application_Note 10 / 27 LTE-A Module Series 1.3.2. Processes of Services over IMS These services procedures based on the IMS network listed below are introduced by the following sections. ⚫ VoLTE over IMS ⚫ SMS over IMS ⚫ Emergency call over IMS ⚫ DTMF over IMS ⚫ SRVCC over IMS 1.3.2.1. VoLTE Caller Network Callee SIP INVITE request with SDP offer SIP INVITE response 100 TRYING SIP INVITE request 183 SESSION_PROGRESS SDP offer Paging SIP INVITE request with SDP offer SIP INVITE response 100 TRYING SIP INVITE request 183 SESSION_PROGRESS SDP offer SIP PRACK request SIP PRACK response 200 OK SIP PRACK request SIP PRACK response 200 OK SIP UPDATE request SIP UPDATE response 200 OK SIP UPDATE request SIP UPDATE response 200 OK SIP INVITE response 180 RINGING SIP INVITE response 180 RINGING Early media over dedicated bearer Early media over dedicated bearer SIP INVITE response 200 OK SIP ACK SIP INVITE response 200 OK SIP ACK Regular media over dedicated bearer Regular media over dedicated bearer SIP BYE request SIP BYE request SIP BYE response 200 OK Figure 2: VoLTE Call Procedure NOTE In case of any error occurring in VoLTE roaming scenario, please provide the logs to Quectel technical support (support@quectel.com) for further analysis. LTE-A(Q)_IMS_Application_Note 11 / 27 LTE-A Module Series 1.3.2.2. SMS Sender Network Receiver SIP REGISTER with '+g.3gpp.smsip' SIP REGISTER 200 OK SIP REGISTER with '+g.3gpp.smsip' SIP REGISTER 200 OK SIP MESSAGE Content Type: vnd.3gpp.sms RP-User-Data with SMS-SUBMIT SIP 202 ACCEPT SIP MESSAGE Content Type: vnd.3gpp.sms RP-ACK with SMS-SUBMIT REPORT SIP 200 OK SIP MESSAGE Content Type: vnd.3gpp.sms RP-User-Data with SMS-SUBMIT DELIVER SIP 200 OK SIP MESSAGE Content Type: vnd.3gpp.sms RP-ACK with SMS-DELIVER REPORT SIP 202 ACCEPT Figure 3: SMS over IMS Procedure LTE-A(Q)_IMS_Application_Note 12 / 27 1.3.2.3. Emergency Call LTE-A Module Series Figure 4: Emergency Call over IMS Procedure Generally, the emergency call number is gathered from the SIM card, UE setting and network-assigned attach accept message. Quectel modules support to read all types of emergency call number. Besides, emergency call numbers can usually be added by AT+QECCNUM, and then take effect immediately and be saved automatically. See document [1], [2] and [3] for details of AT+QECCNUM. 1.3.2.4. DTMF Figure 5: DTMF over IMS Procedure RFC 2833 RTP Event is a popular solution for DTMF over IMS. When it is received and detected correctly, DTMF tone is played with DTMF URC at the same time. NOTE Currently the applicable modules of this document support RFC 2833 RTP Event only. LTE-A(Q)_IMS_Application_Note 13 / 27 LTE-A Module Series 1.3.2.5. SRVCC SRVCC (Single Radio Voice Call Continuity) provides the ability to transit a voice call from a VoIP/IMS domain to the legacy circuit switch domain. The high-level call flow is illustrated by the following figure. Figure 6: SRVCC over IMS Procedure LTE-A(Q)_IMS_Application_Note 14 / 27 LTE-A Module Series From a UE perspective, the SRVCC process involves: 1. SRVCC capability negotiation – UE and MME should agree on the capabilities and whether SRVCC should be supported. This negotiation is performed in different stages using RRC and NAS signaling. 2. Initiating a voice call – For SRVCC purposes, the voice call will be anchored at VCC task. 3. Channel measurements and reporting – On LTE network, UE shall perform the normal channel measurements on E-UTRAN. 4. If the channel quality with the current eNodeB falls below a certain level, UE will notify eNodeB of it. 5. UE shall report the measurements based on the triggers specified by eNodeB. The desired target could be EUTRAN or UTRAN/GERAN. 6. Handover to UMTS/GERAN and derivation of keys upon SRVCC HO. 7. UE uses the CS path to continue the voice call. Generally, SRVCC is enable by default on the module. You can check it from attach request and UE Capability Information message. LTE-A(Q)_IMS_Application_Note 15 / 27 LTE-A Module Series 2 IMS Related AT Command 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 1: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. LTE-A(Q)_IMS_Application_Note 16 / 27 LTE-A Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you familiarize with AT commands and learn how to use them. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. 2.3. Description of AT Command 2.3.1. AT+QCFG='ims' Configure IMS AT+QCFG='ims' Configure IMS Write Command AT+QCFG='ims'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'ims',, OK If the optional parameter is specified, configure IMS: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Whether to enable/disable IMS function. 0 Whether to enable/disable IMS function is determined by the default setting in MBN file 1 Enable IMS function compulsorily 2 Disable IMS function compulsorily Integer type. Indicates the capability of VoLTE. 0 VoLTE is disabled LTE-A(Q)_IMS_Application_Note 17 / 27 LTE-A Module Series 1 VoLTE is enabled Error codes. Please refer to the AT Command Manual of corresponding module. Example AT+QCFG='ims' +QCFG: 'ims',0,0 OK AT+QCFG='ims',1 OK AT+QCFG='ims' +QCFG: 'ims',1,1 OK //Query the current configuration //Enable IMS function compulsorily //Query current settings //VoLTE enabled, VoLTE session available 2.3.2. AT+QMBNCFG Extended MBN Configuration AT+QMBNCFG Extended MBN Configuration Test Command AT+QMBNCFG=? Response +QMBNCFG: 'List' +QMBNCFG: 'Select'[,] +QMBNCFG: 'Deactivate' +QMBNCFG: 'AutoSel'[,(list of supported s)] +QMBNCFG: 'Delete','' +QMBNCFG: 'Add','' Maximum Response Time Characteristics OK 300 ms / 2.3.2.1. AT+QMBNCFG='List' List All MBN Files This command queries all the MBN files available in the module. AT+QMBNCFG='List' List All MBN Files Write Command AT+QMBNCFG='List' Response [+QMBNCFG: 'List',,,,,, [+QMBNCFG: 'List',,,,,, […]]] OK 30 s / Parameter Integer type. MBN index number. The current MBN serial number. Integer type. Indicates whether the MBN file is selected. The MBN file that is selected but not activated will be activated in the next reboot. 0 The current MBN file is not selected 1 The current MBN file is selected Integer type. Indicate whether the MBN file is activated. 0 The current MBN file is not activated 1 The current MBN file is activated String type. The name of the MBN file. The current MBN version. The release date of the current MBN file. 2.3.2.2. AT+QMBNCFG='Select' Select a Specific MBN File This command selects a specific MBN file loaded in the module. AT+QMBNCFG='Select' Select a Specific MBN File Write Command Response AT+QMBNCFG='Select', OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter String type. The name of the MBN file. LTE-A(Q)_IMS_Application_Note 19 / 27 LTE-A Module Series 2.3.2.3. AT+QMBNCFG='Deactivate' Deactivate MBN Files This command deactivates the MBN files running in the module. AT+QMBNCFG='Deactivate' Deactivate MBN Files Write command AT+QMBNCFG='Deactivate' Response OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Example AT+QMBNCFG='List' +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 OK AT+QMBNCFG='Deactivate' OK AT+QMBNCFG='List' +QMBNCFG: 'List',0,0,0,'ROW_Commercial',0x05010800,201801051 OK 2.3.2.4. AT+QMBNCFG='AutoSel' Configure MBN Automatic Selection This command configures automatic selection of MBN file. AT+QMBNCFG='AutoSel' Configure MBN Automatic Selection Write Command AT+QMBNCFG='AutoSel'[,] Response If the optional parameter is omitted, query the current setting: +QMBNCFG: 'AutoSel', OK If the optional parameter is specified, configure automatic selection of MBN file: OK If there is any error: LTE-A(Q)_IMS_Application_Note 20 / 27 LTE-A Module Series ERROR Maximum Response Time Characteristics 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Enable or disable the automatic selection of MBN file. 0 Disable 1 Enable NOTE 1. When this function is enabled, the MBN file will be automatically selected based on the IMSI of (U)SIM card by default. 2. When the function is enabled but no appropriate MBN file is activated, the module will reboot automatically to select and activate a suitable MBN file. 2.3.2.5. AT+QMBNCFG='Delete' Delete a Specified MBN File The command deletes a specified MBN file from EFS. AT+QMBNCFG='Delete' Delete a Specified MBN File Write Command AT+QMBNCFG='Delete', Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect after rebooting. The configuration will be saved automatically. Parameter String type. The name of the MBN file, e.g., 'ROW_Commercial'. LTE-A(Q)_IMS_Application_Note 21 / 27 LTE-A Module Series 2.3.2.6. AT+QMBNCFG='Add' Add a New MBN File The command adds a new MBN file which needs to be uploaded to the UFS in advance. AT+QMBNCFG='Add' Add a New MBN File Write Command AT+QMBNCFG='Add', Response OK Or ERROR Maximum Response Time 300 ms Characteristics / Parameter String type. The file name. The maximum length is 63 characters, e.g., 'test.mbn'. Example AT+QFUPL='test.mbn',9436 CONNECT //Input an MBN file whose size is 9436 bytes +QFUPL: 9436,657c OK AT+QMBNCFG='Add','test.mbn' OK NOTE For details about FILE related AT commands such as AT+QFUPL and AT+QFLST, please refer to document [4]. 2.4. Example 2.4.1. Upload MBN File Manually AT+QMBNCFG='List' OK AT+QFLST='*' //List all MBN files //Only OK is responded, indicating no MBN file //List all files in the UFS LTE-A(Q)_IMS_Application_Note 22 / 27 LTE-A Module Series OK AT+QFUPL='test.mbn',9436 CONNECT //Input an MBN file whose size is 9436 bytes. +QFUPL: 9436,657c //Only OK is responded, indicating no file in the UFS //Upload file test.mbn whose size should be 9436 bytes OK AT+QFLST='*' +QFLST: 'test.mbn',9436 //List all files in the UFS //The uploaded file test.mbn is listed OK AT+QMBNCFG='Add','test.mbn' //Add test.mbn as MBN file OK AT+QMBNCFG='List' //List all MBN files +QMBNCFG: 'List',0,0,0,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being neither selected nor activated OK AT+QMBNCFG='Select','ROW_Commercial' //Select ROW MBN OK AT+QMBNCFG='List' //List all MBN files +QMBNCFG: 'List',0,1,0,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being selected but not activated OK //Restart the module AT+QMBNCFG='List' //List all MBN files +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being selected and activated OK 2.4.2. Automatic Selection Feature AT+QMBNCFG='List' //List all MBN files +QMBNCFG: 'List',0,0,0,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being neither selected nor activated OK AT+QMBNCFG='Autosel' //Query the configuration of MBN automatic selection LTE-A(Q)_IMS_Application_Note 23 / 27 LTE-A Module Series +QMBNCFG: 'Autosel',0 //Automatic selection of MBN file is disabled OK AT+QMBNCFG='Autosel',1 OK //Restart the module manually RDY POWERED DOWN RDY //Enable automatic selection of MBN file //The module reboots automatically to activate a suitable MBN file +CPIN: READY +QUSIM: 1 +QIND: SMS DONE AT+QMBNCFG='List' +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being selected and activated OK //restart the module manually RDY +CPIN: READY +QUSIM: 1 //The module would not reboot if a suitable MBN file has been activated //The MBN file is activated. +QIND: SMS DONE AT+QMBNCFG='List' +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 OK LTE-A(Q)_IMS_Application_Note 24 / 27 LTE-A Module Series 3 Appendix A References Table 2: Related Documents Document Name [1] Quectel_EM12&EG12&EG18_AT_Commands_Manual [2] Quectel_EG512R&EM1x0R_Series_AT_Commands_Manual [3] Quectel_EP06&EG06&EM06_AT_Commands_Manual [4] Quectel_LTE-A(Q)_FILE_Application_Note Table 3: Terms and Abbreviations Abbreviation AKA AS CN CS DTMF EFS eNodeB EPS EUTRAN GERAN HO IMS Description Authentication and Key Agreement Access Stratum Core Network Circuit Switched Dual Tone Multi Frequency Embedded File System Evolved Node B Evolved Packet System Evolved Universal Terrestrial Radio Access Network GSM EDGE Radio Access Network Hand Over IP Multimedia Subsystem LTE-A(Q)_IMS_Application_Note 25 / 27 IMSI IP LTE MBN MME NAS NV NW PCM PCRF PCSCF PDN PDP PGW PLMN PS QCI RES RFC RRC RTP SDP SIM SIP SMS SRVCC LTE-A Module Series International Mobile Subscriber Identification Number Internet Protocol (Long-Term Evolution) a 4G mobile communications standard. Modem Configuration Binary Mobility Management Entity Non-Access-Stratum Non-Volatile Network Pulse Code Modulation Policy and Charging Rules Function Proxy-Call Session Control Function Public Data Networks Packet Data Protocol PDN (Packet Data Network) Gateway Public Land Mobile Network Packet Switch QoS Class Identifier Response Request For Comments Radio Resource Control Real-time Transport Protocol Session Description Protocol Subscriber Identity Module Session Initiation Protocol Short Message Service Single Radio Voice Call Continuity LTE-A(Q)_IMS_Application_Note 26 / 27 TA UE UFS (U)SIM UTRAN VCC VoIP VoLTE LTE-A Module Series Terminal Adapter User Equipment User File System (Universal) Subscriber Identity Module UMTS Terrestrial Radio Access Network Voice Call Continuity Voice over Internet Protocol Voice (voice calls) over LTE. A standard high-speed wireless communication for mobile phones and data terminals, including Internet of things devices and wearables. LTE-A(Q)_IMS_Application_Note 27 / 27

EM12xR-GL&EM160R-GL 高温降速降功率指导 LTE-A 模块系列 版本：1.0 日期：2021-07-13 状态：受控文件 EM12xR-GL&EM160R-GL 高温降速降功率指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 文档历史 修订记录 版本 1.0 日期 2020-12-03 2021-07-13 作者 Floyd WANG Floyd WANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................ 3 表格索引 ..................................................................................................................................................... 4 1 引言 ..................................................................................................................................................... 5 2 AT 命令详解 ........................................................................................................................................ 6 2.1. AT 命令语句.............................................................................................................................. 6 2.1.1. 定义 ............................................................................................................................ 6 2.1.2. AT 命令语句 ................................................................................................................... 6 2.2. AT 示例声明.............................................................................................................................. 7 2.3. AT+QCFG='thermal/modem' 设置高温降速降功率策略 ........................................................ 7 2.4. AT+QTEMP 获取温度信息 ..................................................................................................... 8 3 降温策略............................................................................................................................................ 10 3.1. 上行吞吐率限制 ...................................................................................................................... 10 3.2. 发射功率限制 .......................................................................................................................... 10 3.3. 下行吞吐率限制（仅针对 EM160R-GL）.................................................................................11 3.4. 紧急服务状态 ...........................................................................................................................11 3.5. 模块重启 ..................................................................................................................................11 4 附录 A 参考文档 ................................................................................................................................ 12 上海移远通信技术股份有限公司 3 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 表格索引 表 1：AT 命令类型..................................................................................................................................... 6 表 2：发射功率回退信息.......................................................................................................................... 10 表 3：术语和缩写 .................................................................................................................................... 12 上海移远通信技术股份有限公司 4 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 1 引言 本文档主要介绍了移远通信 EM120R-GL、EM121R-GL 以及 EM160R-GL 模块高温降速降功率相关的 AT 命令以及适用的五种降温策略，当温度到达指定条件时，即可通过对应的降温策略对模块进行冷却降温。 模块主要有两种降温策略：上行吞吐率限制和发射功率限制。此外，模块具有三种自动降温策略：下 行吞吐率限制、紧急服务状态和模块重启。 本文档适用的移远通信模块包括： ⚫ EM120R-GL ⚫ EM121R-GL ⚫ EM160R-GL 上海移远通信技术股份有限公司 5 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 2 AT 命令详解 2.1. AT 命令语句 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 6 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QCFG='thermal/modem' 设置高温降速降功率策略 该命令用于查询或设置高温降速降功率策略（限制上行吞吐率或发射功率）以及响应的温度门限。 AT+QCFG='thermal/modem' 设置高温降速降功率策略 设置命令 AT+QCFG='thermal/modem'[,, ,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'thermal/modem',1,, +QCFG: 'thermal/modem',2,, OK 最大响应时间 特性说明 若指定可选参数，则设置高温降速降功率策略及温度门限： OK 或者 ERROR 300 毫秒 该命令重启后生效。 自动保存参数配置。 参数 整型。降温策略等级。每种降温策略等级对应一组和。 1 Level 1，通过限制上行吞吐率降温 2 Level 2，通过限制发射功率降温 整型。触发温度门限。当模块温度达到值时，将会触发对应等级的降温策略。范围： 0~115000；单位：0.001 ºC。 当=1，表示触发降上行吞吐率的温度门限。默认值：100000。 当=2，表示触发降发射功率的温度门限。默认值：105000。 整型。终止温度门限。当模块温度下降至值，将会终止对应等级的降温策略。范围： 0~115000；单位：0.001 ºC。 当=1，表示终止上行降速的温度门限。默 认值：95000。 当=2，表示终止降发射功率的温度门限。默认值：100000。 上海移远通信技术股份有限公司 7 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 示例 AT+QCFG='thermal/modem' +QCFG: 'thermal/modem',1,100000,95000 +QCFG: 'thermal/modem',2,105000,100000 OK //查询当前设置的温度门限。 备注 1. 值应高于值。 2. 高温降速降功率机制的详情请参考第 3 章。 3. 此命令配置的降温策略将基于'pa-therm1-adc'传感器（参考 AT+QTEMP）的温度触发。 2.4. AT+QTEMP 获取温度信息 该命令用于查询模块的传感器及其温度。 AT+QTEMP 获取温度信息 测试命令 AT+QTEMP=? 执行命令 AT+QTEMP 响应 OK 响应 +QTEMP:, … 最大响应时间 特性说明 OK 300 毫秒 / 参数 字符串类型。传感器类型。 'aoss-usr' 基线芯片内部第一个采集点 'mdm-q6-usr' 基线芯片内部第二个采集点 'ddrss-usr' 基线芯片内部第三个采集点 'cpu-usr' 基线芯片内部第四个采集点 'mdm-core-usr' 基线芯片内部第五个采集点 'xo-therm-adc' 晶振温度采集点 'pa-therm1-adc' PA 芯片温度采集点 'mdm-case-therm-adc' 基线芯片外部温度采集点 上海移远通信技术股份有限公司 8 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 字符串类型。温度。单位：ºC。 举例 AT+QTEMP +QTEMP:'aoss-usr','33' +QTEMP:'mdm-q6-usr','34' +QTEMP:'ddrss-usr','34' +QTEMP:'cpu-usr','34' +QTEMP:'mdm-core-usr','34' +QTEMP:'xo-therm-adc','32' +QTEMP:'pa-therm1-adc','31' +QTEMP:'mdm-case-therm-adc','32' OK 上海移远通信技术股份有限公司 9 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 3 降温策略 3.1. 上行吞吐率限制 限制上行吞吐率可以减少 CPU、PA 等硬件的工作负载，以达到降温目的；但是，在无数据传输或低吞 吐率的情况下降温效果不明显。 通过执行 AT+QCFG='thermal/modem',1,,，模块可基于设置的温度门限，在一定周期内 根据特定的门限等级，对上行吞吐率进行限制。 以 AT+QCFG='thermal/modem',1,100000,95000 为例（触发温度门限为 100 ºC、终止温度门限为 95 ºC），当 'pa-therm1-adc' 的温度上升至 100 ºC 时，模块将自动开始降低上行吞吐率，默认降低至 1 Mbit/s，当 'pa-therm1-adc' 的温度降低至 95 ºC 以下，则取消上行吞吐率限制。 3.2. 发射功率限制 限制发射功率可以减少 PA 的工作负载。但是，实网下发射功率由网络配置，在信号不太差的情况下， 发射功率一般不高，通过限制发射功率进行降温的效果并不明显；另外，当实际发射功率受限，且低于网 络配置的发射功率时，可能会造成网络无法接收模块发送的信号或信号解码失败，进而导致数传性能下降。 通过执行 AT+QCFG='thermal/modem',2,,，模块可基于设置的温度门限，在一定周期内 根据特定功率回退值，对功率进行限制。发射功率回退信息如下表所示： 表 2：发射功率回退信息 参数类别 基准功率回退 最大功率回退 非回退持续时间 回退持续时间 回退持续周期 参数名称 P_BACKOFF MAX_BACKOFF T_UP T_DOWN STEP_TIMER 参数值 5 dBm 13 dBm 50 毫秒 50 毫秒 15 秒 备注 功率回退依次为： 5 dBm、10 dBm、13 dBm、13 dBm、13 dBm…… 上海移远通信技术股份有限公司 10 / 12 TX_POWER EM12xR-GL&EM160R-GL 高温降速降功率指导 MTPL T_UP P_BACKOFF T_DOWN 2*P_BACKOFF STEP_TIMER(15S) TIME 图 1：功率回退图示 以 AT+QCFG='thermal/modem',2,105000,100000 为例，当'pa-therm1-adc'温度上升至 105 ºC 时， 模块将自动开始回退发射功率，默认初始发射功率回退值为 5 dBm，持续 50 毫秒后，将恢复初始功率，持 续 50 毫秒以后，将再次以 5 dBm 的功率回退值进行回退，如此往复，持续 15 秒，即为一个功率回退周期。 若一个功率回退周期后温度仍未降至 100 ºC 以下，则下一个周期将以 10 dBm 的功率回退值和初始功率以 50 毫秒的周期进行交替，以此类推，若温度仍未降至 100 ºC 以下，最终将一直以 13 dBm 的功率回退值进 行回退。若检测到温度低于 100 ºC，则不再降低发射功率，并以初始发射功率继续运行。 3.3. 下行吞吐率限制（仅针对 EM160R-GL） 当 'mdm-core-usr' 温度高于 100 ºC 时，接收天线数量将从 4 个（4Rx）回退到 2 个（2Rx）。 当 'mdm-core-usr' 温度降至 95 ºC 以下时，即将不再限制下行吞吐率。 3.4. 紧急服务状态 当'mdm-core-usr'温度高于 115 ºC 时，模块将强制进入紧急服务状态，通过限制服务的方式保护硬件。 当'mdm-core-usr'温度降至 105 ºC 以下时，退出紧急服务状态。 3.5. 模块重启 当'mdm-core-usr'温度高于 120 ºC 时，为保护硬件，模块将强制重启。该策略无法手动关闭，也不可 手动更改温度配置。 上海移远通信技术股份有限公司 11 / 12 EM12xR-GL&EM160R-GL 高温降速降功率指导 4 附录 A 参考文档 表 3：术语和缩写 缩写 CPU MTPL PA Rx TA 英文全称 Central Processing Unit Maximum Transmission Power Limit Power Amplifier Receive Terminal Adapter 中文全称 中央处理器 最大发射功率限制 功率放大器 接收 终端适配器 上海移远通信技术股份有限公司 12 / 12

EM12xR-GL&EM160R-GL Secure Boot 应用指导 LTE-A 模块系列 版本：1.0 日期：2022-06-28 状态：受控文件 EM12xR-GL&EM160R-GL Secure Boot 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 文档历史 修订记录 版本 1.0 日期 2022-04-21 2022-06-28 作者 Shaun DUAN Shaun DUAN 修改描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 目录 文档历史 ..................................................................................................................................................... 3 目录 ............................................................................................................................................................4 表格索引 ..................................................................................................................................................... 5 1 引言.....................................................................................................................................................6 1.1. 适用模块 ...................................................................................................................................6 2 Secure Boot 概述 ...............................................................................................................................7 2.1. Secure Boot 定义......................................................................................................................7 2.2. 使能 Secure Boot......................................................................................................................7 2.3. 证书链.......................................................................................................................................7 2.4. 签名镜像文件............................................................................................................................8 2.5. QFPROM 配置..........................................................................................................................8 3 Secure Boot 相关 AT 命令 .................................................................................................................9 3.1. AT 命令说明..............................................................................................................................9 3.1.1. 定义 ...............................................................................................................................9 3.1.2. AT 命令语句 ...................................................................................................................9 3.2. AT 示例声明............................................................................................................................10 3.3. AT 命令详解............................................................................................................................10 3.3.1. AT+QSECBOOT 使能或查询 Secure Boot 功能 ........................................................10 3.3.1.1. AT+QSECBOOT='status' 查询 Secure Boot 使能状态.................................. 10 3.3.1.2. AT+QSECBOOT='serialnum' 查询模块唯一序列号 .......................................11 3.3.1.3. AT+QSECBOOT='progsec' 使能 Secure Boot 功能.......................................11 4 注意事项............................................................................................................................................13 5 附录 术语缩写...................................................................................................................................14 上海移远通信技术股份有限公司 4 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 表格索引 表 1：适用模块.......................................................................................................................................... 6 表 2：AT 命令类型..................................................................................................................................... 9 表 3：术语缩写........................................................................................................................................ 14 上海移远通信技术股份有限公司 5 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 1 引言 移远通信 LTE-A EM12xR-GL 和 EM160R-GL 模块支持 Secure Boot 功能。本文档介绍如何使用 AT 命 令在 EM12xR-GL 和 EM160R-GL 模块上开启 Secure Boot 功能，包括 Secure Boot 概述、AT 命令详解以 及注意事项。 1.1. 适用模块 表 1：适用模块 模块系列 EM12xR EM160R 模块 EM120R-GL EM121R-GL EM160R-GL 上海移远通信技术股份有限公司 6 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 2 Secure Boot 概述 2.1. Secure Boot 定义 Secure Boot 是一种建立在授信平台上的安全启动序列。为了保证仅执行通过验证的软件，Secure Boot 在启动过程中增加了验证签名环节。 为防止没有经过合法签名或被恶意修改的软件在模块上运行，Secure Boot 在模块启动过程的每个阶段 均增加了验证签名环节。在一系列启动阶段中，需有一个根信任实体，模块中的 PBL（Primary Boot Loader） 作为固件固化在模块中，且无法被修改，可作为根信任实体。 2.2. 使能 Secure Boot 仅可通过硬件上的熔断器使能 Secure Boot，且使能后无法关闭 Secure Boot。 模块的启动过程分为多个阶段，每个阶段都由一个专用的镜像文件完成特定的功能。使能 Secure Boot 之后，每一阶段的镜像文件在执行前，都需要前一阶段的镜像文件对其进行校验；如果校验失败，会造成整 个启动过程失败，进而模块启动失败。 作为信任根（也称为 RoT），PBL 是一种包含在芯片中的固件且无法修改，因此是可信任的（启动过 程的最信任实体）并可作为下一启动阶段的授信中心；下一启动阶段一般是 SBL（Secondary Boot Loader） 经过验证签名后被执行，可以使用 SBL 进行授信操作。 2.3. 证书链 Secure Boot 支持 2048 位或 4096 位的 RSA 秘钥，用于证书以及镜像文件的签名。证书签名支持的格 式为 PKCS v1.2 标准格式，支持 SHA-256 算法或 SHA-384 算法。 模块的证书链支持两级证书或者三级证书，默认采用三级证书链：Self-signed root certificate、 Attestation CA certificate 和 Attestation certificate。 上海移远通信技术股份有限公司 7 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 2.4. 签名镜像文件 镜像文件的标准格式为 ELF，在 Secure Boot 中，验证启动过程中的每个阶段需要对每个阶段的镜像 文件进行签名操作。标准的 ELF 格式二进制文件包含多个段，分别代表不同种类的信息，其中签名相关的 信息保存在 hash table segment 中。Hash table segment 中还包含每个段的 hash 值，以及证书信任链相 关的信息。 模块中必须签名的镜像文件如下： ⚫ abl.elf ⚫ aop.mbn ⚫ devcfg.mbn ⚫ hyp.mbn ⚫ multi_image.mbn ⚫ prog_firehose_sdx24.mbn ⚫ sbl1.mbn ⚫ tz.mbn ⚫ uefi.elf ⚫ xbl_cfg.elf ⚫ apdp.mbn ⚫ NON-HLOS.ubi 2.5. QFPROM 配置 模块包含一次性可编程熔断器。所有熔断器初始状态均为 0（表示未启动 Secure Boot）。一旦进行写 入（即熔断）操作，熔断器状态将永久地改变为 1（表示启动 Secure Boot）。熔断后，状态无法改变。需 要使用 QFPROM 编程工具协助完成 Secure Boot 的启动。 QFPROM 用于在一个非易失性 ROM（non-volatile read-only memory）中存储代表芯片鉴权相关的配 置，可实现 Secure Boot 所需的安全环境。配置 QFPROM，进行熔断操作，进而完成所需要的安全功能， 例如：Debug 端口的输出功能、JTAG 功能、安全文件系统和软件版本防回滚功能等。 上海移远通信技术股份有限公司 8 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 3 Secure Boot 相关 AT 命令 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT 命令详解 3.3.1. AT+QSECBOOT 使能或查询 Secure Boot 功能 AT+QSECBOOT 使能或查询 Secure Boot 功能 测试命令 AT+QSECBOOT=? 响应 +QSECBOOT: 'status',(支持的列表) +QSECBOOT: 'serialnum', +QSECBOOT: 'progsec',(支持的列表) 最大响应时间 特性说明 OK 或者 ERROR 300 毫秒 - 3.3.1.1. AT+QSECBOOT='status' 查询 Secure Boot 使能状态 该命令用于查询模块当前是否已使能 Secure Boot 功能。 AT+QSECBOOT='status' 查询 Secure Boot 使能状态 设置命令 响应 AT+QSECBOOT='status' +QSECBOOT: 'status', 最大响应时间 特性说明 OK 或者 ERROR 300 毫秒 - 上海移远通信技术股份有限公司 10 / 14 参数 EM12xR-GL&EM160R-GL Secure Boot 应用指导 整型。Secure Boot 功能使能状态。 1 已使能 0 未使能 3.3.1.2. AT+QSECBOOT='serialnum' 查询模块唯一序列号 该命令用于查询模块的唯一序列号。 AT+QSECBOOT='serialnum' 查询模块唯一序列号 设置命令 响应 AT+QSECBOOT='serialnum' +QSECBOOT: 'serialnum', 最大响应时间 特性说明 OK 或者 ERROR 300 毫秒 - 参数 字符串类型。模块的序列号。十六进制格式，不含双引号。 3.3.1.3. AT+QSECBOOT='progsec' 使能 Secure Boot 功能 该命令用于使能 Secure Boot 功能。 AT+QSECBOOT='progsec' 使能 Secure Boot 功能 设置命令 AT+QSECBOOT='progsec'[,] 响应 若省略可选参数，则查询当前状态： +QSECBOOT: 'progsec', OK 若指定可选参数，则使能 Secure Boot 功能： OK 或者 ERROR 上海移远通信技术股份有限公司 11 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 最大响应时间 特性说明 300 毫秒 该命令在模块重启后生效； 参数配置自动保存。 参数 整型。使能 Secure Boot 功能。 1 使能 0 未使能（仅在查询结果中有效） 上海移远通信技术股份有限公司 12 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 4 注意事项 1. Secure Boot 功能只能通过硬件上的 Fuse 使能，一旦使能无法关闭。 2. 推荐使用 AT+QSECBOOT='progsec',使能 Secure Boot 功能，模块 Secure Boot 默认 未使能；该命令在 sec 分区中烧录镜像文件，重启模块后自动激活 Secure Boot。 3. 使能 Secure Boot 后，无法通过 Firehose 将固件降级到不支持 Secure Boot 的版本。 4. 使能 Secure Boot 后，不支持通过 DFOTA 将版本降级至不支持 Secure Boot 的固件版本，否则将 导致无法正常启动模块。 5. PCIe Fuse 模式也是在 sec 分区中烧录镜像文件，与 Secure Boot 的使能有冲突。若先使能 Secure Boot，则无法使能 PCIe Fuse 模式。因此必须先使能 PCIe Fuse 模式后再使能模块的 Secure Boot。 上海移远通信技术股份有限公司 13 / 14 EM12xR-GL&EM160R-GL Secure Boot 应用指导 5 附录 术语缩写 表 3：术语缩写 缩写 英文全称 中文全称 DFOTA Delta Firmware Upgrade Over-The-Air 固件空中差分升级 ELF Executable and Linkable Format 可执行可链接格式 MBN Multi Boot Image Format 多启动镜像文件格式 PBL Primary Boot Loader 主引导加载程序 PCIe Peripheral Component Interconnect Express 快捷外围部件互连标准 PKCS Public-Key Cryptography Standards 公钥密码学标准 QFPROM Qualcomm Fuse Programmable Read Only Memory 一次性可编程只读存储器 RPM RPM Package Manager (originally Red Hat Package RPM软件包管理器 Manager) RoT Root of Trust 可信根 SBL Secondary Boot Loader 二级引导加载程序 SHA Secure Hash Algorithm 安全散列算法 上海移远通信技术股份有限公司 14 / 14

EM12&EG12&EG18 系列 软件热管理指导 LTE-A 模块系列 版本：1.0 日期：2022-07-25 状态：受控文件 EM12&EG12&EG18 系列软件热管理指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提供 给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 15 EM12&EG12&EG18 系列软件热管理指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 15 EM12&EG12&EG18 系列软件热管理指导 文档历史 修订记录 版本 1.0 日期 2020-04-24 2022-07-25 作者 Aydan DING Aydan DING 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 15 EM12&EG12&EG18 系列软件热管理指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT 命令说明................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句..................................................................................................................... 7 2.2. AT 示例声明................................................................................................................................ 8 2.3. AT+QCFG='thermal/modem' 设置 PA 温升处理机制 ............................................................. 8 2.4. AT+QTEMP 查询模块温度值 ................................................................................................... 9 3 温升处理机制....................................................................................................................................... 11 3.1 LTE PA 温升处理机制................................................................................................................11 3.1.1. 限制上行数据传输速率 ...................................................................................................11 3.1.2. 限制发射功率................................................................................................................. 12 3.2. LTE MDM 温升处理机制........................................................................................................... 13 3.3. 紧急服务模式............................................................................................................................ 14 3.4. 模块重启 ................................................................................................................................... 14 4 附录 术语缩写..................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 EM12&EG12&EG18 系列软件热管理指导 表格索引 表 1：AT 命令及响应类型............................................................................................................................. 7 表 2：温升处理机制.....................................................................................................................................11 表 3：上行数传速率门限等级 ......................................................................................................................11 表 4：发射功率回退信息 ............................................................................................................................ 12 表 5：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 EM12&EG12&EG18 系列软件热管理指导 1 引言 本文档主要介绍了移远通信 LTE-A 模块 EM12-G、EG12 和 EG18 系列模块的软件热管理处理机制及 相关的 AT 命令。当温度满足指定条件时，即可通过对应的温升处理机制对模块进行冷却降温。 上海移远通信技术股份有限公司 6 / 15 EM12&EG12&EG18 系列软件热管理指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 15 EM12&EG12&EG18 系列软件热管理指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT+QCFG='thermal/modem' 设置 PA 温升处理机制 此命令配置的温升处理机制将基于 'pa_therm1' 传感器（参考 AT+QTEMP）的温度触发。 AT+QCFG='thermal/modem' 设置 PA 温升处理机制 设置命令 AT+QCFG='thermal/modem'[,, ,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'thermal/modem',1,, +QCFG: 'thermal/modem',2,, OK 最大响应时间 特性说明 若指定可选参数，则设置 PA 的温升等级： OK 或者 ERROR 300 毫秒 该命令重启后生效。 参数配置自动保存。 参数 整型。温升处理等级。每种温升处理等级对应一组和。 1 Level 1，表示降低上行数据传输速率（详见第 3.1.1 章） 2 Level 2，表示在 Level 1 的基础上，同步降低发射功率。（详见第 3.1.2 章） 整型。触发温度阈值。当模块温度达到值时，将会触发对应等级（）的温升处理 机制。范围：0~115000；单位：0.001 ºC。 当=1，表示触发降低上行速率的温度阈值。默认值：100000。 当=2，表示触发降低发射功率的温度阈值。默认值：105000。 整型。终止温度阈值。当温度下降到值时，对应等级（）的温升处理机制将会终 止。范围：0~115000；单位：0.001 ºC。 当=1，表示终止降低上行速率的温度阈值。默认值：95000。 当=2，表示终止降低发射功率的温度阈值。默认值：100000。 上海移远通信技术股份有限公司 8 / 15 EM12&EG12&EG18 系列软件热管理指导 举例 AT+QCFG='thermal/modem',1,100000,95000 //Level 1 通过降低上行速率的方式降低温度。若温度达 到 100 ºC 则降低上行速率；当温度降至 95 ºC 时，则 终止降低上行速率的温度阈值，从而终止 Level 1。 OK AT+QCFG='thermal/modem' //查询 PA 温升处理机制配置 +QCFG: 'thermal/modem',1,100000,95000 +QCFG: 'thermal/modem',2,105000,100000 OK 备注 值应高于对应的值。 2.4. AT+QTEMP 查询模块温度值 AT+QTEMP 查询模块温度值 测试命令 AT+QTEMP=? 执行命令 AT+QTEMP 最大响应时间 特性说明 响应 OK 响应 OK +QTEMP:, … 300 毫秒 / 参数 字符串类型。传感器类型。 'xo_therm_buf' 晶振 'mdm_case_therm' 'pa_therm1' 基线芯片 PA 芯片 'tsens_tz_sensor0' AOSS.0 'tsens_tz_sensor1' Q6_MDM 'tsens_tz_sensor2' C_TILE 上海移远通信技术股份有限公司 9 / 15 'tsens_tz_sensor3' CPU.0.0 'tsens_tz_sensor4' MDM_CORE 字符串类型。温度值。单位：ºC。 举例 AT+QTEMP OK //查询模块温度值 +QTEMP: 'xo_therm_buf','26' +QTEMP: 'mdm_case_therm','25' +QTEMP: 'pa_therm1','25' +QTEMP: 'tsens_tz_sensor0','27' +QTEMP: 'tsens_tz_sensor1','26' +QTEMP: 'tsens_tz_sensor2','26' +QTEMP: 'tsens_tz_sensor3','26' +QTEMP: 'tsens_tz_sensor4','27' EM12&EG12&EG18 系列软件热管理指导 上海移远通信技术股份有限公司 10 / 15 EM12&EG12&EG18 系列软件热管理指导 3 温升处理机制 表 2：温升处理机制 温升处理机制 传感器 LTE PA pa_therm1 LTE MDM tsens_tz_sensor4 Level 1 限制上行数传速率 限制下行速率 Level 2 降低发射功率 （MTPL） 无 Level 3 紧急服务模式 紧急服务模式 3.1 LTE PA 温升处理机制 3.1.1. 限制上行数据传输速率 限制上行数据传输速率可降低 CPU 和 PA 等硬件的工作负载，以达到降温目的。但是，在无数据传输 或低速率的情况下降温效果不明显。 通过执行 AT+QCFG='thermal/modem',1,,，模块可基于设置的温度阈值，在一定周期内 根据上行速率限制的门限等级对上行数据传输速率进行限制。上行速率限制的门限等级详情如下表所示： 表 3：上行数传速率门限等级 速率门限等级 target_rate[0] target_rate[1] target_rate[2] target_rate[3] target_rate[4] target_rate[5] target_rate[6] target_rate[7] 最大上行速率 150 Mbit/秒 100 Mbit/秒 75 Mbit/秒 50 Mbit/秒 40 Mbit/秒 25 Mbit/秒 10 Mbit/秒 5 Mbit/秒 备注 检测周期：3 秒 速率门限等级个数（num_states）：13 个 默认等级：target_rate[5] 上海移远通信技术股份有限公司 11 / 15 EM12&EG12&EG18 系列软件热管理指导 target_rate[8] target_rate[9] target_rate[10] target_rate[11] target_rate[12] 1 Mbit/秒 500 Kbit/秒 100 Kbit/秒 100 Kbit/秒 100 Kbit/秒 以 AT+QCFG='thermal/modem',1,100000,95000 为例（触发温度阈值为 100 °C，终止温度阈值为 95 °C），温升处理机制如下： 1. 传感器'pa_therm1'获取的温度值上升至 100 ºC； 2. 模块进入 Level 1，并自动开始降低上行数据传输速率，无数据传输时将关闭 PA；进入 Level 1 后， 上行速率门限等级立即调整为 target_rate[5]（对应速率为 25 Mbit/秒）； 3. 3 秒后，若温度仍高于终止温度阈值（即 95 ºC），速率门限等级上升一级至 target_rate[6]； 4. 以此类推，每 3 秒检测一次温度，若温度仍高于 95°C，上行速率门限等级上升一级，直至上升至 target_rate[12]（对应速率为 100 Kbit/秒）； 5. 模块温度降至 95 ºC 后，取消上行数据传输速率限制。 3.1.2. 限制发射功率 限制发射功率可以降低 PA 的工作负载。但是，实网下发射功率由网络配置，在信号不太差的情况下， 发射功率一般不高，通过限制发射功率进行降温的效果并不明显；另外，当实际发射功率受限，且低于网络 配置的发射功率时，可能会造成网络无法接收模块发送的信号或信号解码失败，进而导致数传性能下降。 通过执行 AT+QCFG='thermal/modem',2,,，模块可基于设置的温度阈值，在一定周期内 根据特定功率回退值对功率进行限制。功率回退为占空比模式，50 ms 为半周期，占空比为 50 %。 发射功率回退信息如下表所示： 表 4：发射功率回退信息 参数类别 基准功率回退 最大功率回退 非回退持续时间 回退持续时间 回退持续周期 参数名称 P_backoff Max_backoff T_on T_off Step_timer 参数值 5 dBm 13 dBm 50 ms 50 ms 15 s 备注 功率回退依次为：5 dBm、10 dBm、13 dBm、 13 dBm、13 dBm、…… 以正常功率为 21 dBm 为例，回退后的功率 依次为：16 dBm、11 dBm、8 dBm、8 dBm、 8 dBm、…… 上海移远通信技术股份有限公司 12 / 15 TX_POWER MTPL T_on P_backoff T_off n × P_backoff Step_timer (15 s) EM12&EG12&EG18 系列软件热管理指导 TIME 图 1：功率回退示意图 以 AT+QCFG='thermal/modem',2,105000,100000（触发温度阈值为 105 °C，终止温度阈值为 100 °C）、正常功率为 21 dBm 为例，温升处理机制如下： 1. 当传感器'pa_therm1'获取的温度值上升至 105 ºC； 2. 模块进入 Level 2，自动开始回退功率，由 21 dBm 降低为 16 dBm（初始回退值为 5 dBm），持 续 50 毫秒；之后将恢复 21 dBm，持续 50 毫秒；之后再降低为 16 dBm，持续 50 毫秒；如此往 复，持续 15 秒，即为一个功率回退周期（Step_timer）； 3. 以 5 dBm 回退值持续 15 秒后，若温度未降至 100 °C 以下，则开始以 10 dBm 回退值开始新的回 退周期，发射功率将按 50 ms 周期，在 21 dBm 和 11 dBm 交替； 4. 以 10 dBm 回退值持续 15 秒后，若温度仍未降至 100 °C 以下，发射功率将一直以 13 dBm 的回 退值、以 50 毫秒为周期，在 21 dBm 和 8 dBm 交替； 5. 检测到温度降至 100 ºC 后，则不再回退发射功率。 备注 当温升处理机制进入 Level 2 时，Level 1 同时生效，即同时执行限制降低上行数据传输速率和限制发射 功率。 3.2. LTE MDM 温升处理机制 当传感器'tsens_tz_sensor4'获取的温度值达到温度阈值 101 ºC 时，模块会触发下行速率限制机制， 温度低于 98 ºC 时，退出限制下行速率。该策略由软件编码控制，无法通过 AT 命令进行配置修改。 此温升处理机制如下： 1) 模块接收天线数量从 4 Rx 模式回退至 2 Rx 模式。 2) 模块向网络上报一个 CQI 0，用于关闭所有 SCC，仅保留 PCC。 上海移远通信技术股份有限公司 13 / 15 EM12&EG12&EG18 系列软件热管理指导 3.3. 紧急服务模式 当传感器'tsens_tz_sensor4'获取的温度值达到 115 ºC 时，模块强制进入紧急服务模式，将停止所有 服务，以防止硬件受高温损坏。此时，模块只能拨打紧急电话，不能使用其他功能。 该机制无法手动关闭，也不可手动更改温度配置。 3.4. 模块重启 当模块温度（任意传感器获取的温度）高于 120 ºC 时，为保护硬件，模块将强制重启。 该机制无法手动关闭，也不可手动更改温度配置。 上海移远通信技术股份有限公司 14 / 15 EM12&EG12&EG18 系列软件热管理指导 4 附录 术语缩写 表 5：术语缩写 缩写 BB CPU CQI LTE MDM MTPL PA PCC Rx SCC TA Tx XO 英文全称 Baseband Central Processing Unit Channel Quality Indicator Long-Term Evolution Modem Maximum Tx Power Limit Power Amplifier Primary Component Carrier Receive Secondary Component Carrier Terminal Adapter Transmit Crystal Oscillator 中文全称 基带 中央处理器 信道质量指示 长期演进 调制解调器 最大发射功率限制 功率放大器 主载波 接收 辅载波 终端适配器 发送 晶体振荡器（晶振） 上海移远通信技术股份有限公司 15 / 15

EG512R-EA Yocto SDK 编译指导 LTE-A 模块系列 版本：EG512R-EA_Yocto_SDK_编译指导_V1.0 日期：2020-07-13 状态：受控文件 www.quectel.com EG512R-EA Yocto SDK 编译指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 19 EG512R-EA Yocto SDK 编译指导 文档历史 修订记录 版本 日期 作者 1.0 2020-07-13 林江红 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 19 EG512R-EA Yocto SDK 编译指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 图片索引 ....................................................................................................................................................... 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 编译环境搭建......................................................................................................................................... 7 2.1. VMware Workstation 下载及安装............................................................................................... 7 2.2. Linux 虚拟机下载与安装............................................................................................................. 8 2.2.1. 操作系统镜像下载 ........................................................................................................... 8 2.2.2. 安装 Linux 虚拟机至 VMware Workstation...................................................................... 9 2.3. Linux 虚拟机 Host 配置 ............................................................................................................ 13 3 编译 ..................................................................................................................................................... 15 3.1. 编译源码 ................................................................................................................................... 15 3.2. 编译结果 ................................................................................................................................... 16 4 附录 A 参考文档及术语缩写............................................................................................................... 19 上海移远通信技术股份有限公司 3 / 19 EG512R-EA Yocto SDK 编译指导 图片索引 图 1：ubuntu-14.04.6-desktop-amd64.iso 下载........................................................................................... 8 图 2：选择'创建新的虚拟机' ........................................................................................................................ 9 图 3：使用典型推荐...................................................................................................................................... 9 图 4：选择 Ubuntu 14.04 镜像文件位置.................................................................................................... 10 图 5：设置 Linux Ubuntu 登陆用户账号和密码 .......................................................................................... 10 图 6：选择 Linux Ubuntu 虚拟机安装位置 ..................................................................................................11 图 7：选择 Linux Ubuntu 磁盘空间 .............................................................................................................11 图 8：分配 Linux Ubuntu 虚拟机 CPU 核数 ............................................................................................... 12 图 9：分配 Linux Ubuntu 虚拟机内存......................................................................................................... 12 图 10：生成物镜像 ..................................................................................................................................... 18 上海移远通信技术股份有限公司 4 / 19 EG512R-EA Yocto SDK 编译指导 表格索引 表 1：编译镜像 ........................................................................................................................................... 17 表 2：参考文档 ........................................................................................................................................... 19 表 3：术语缩写 ........................................................................................................................................... 19 上海移远通信技术股份有限公司 5 / 19 EG512R-EA Yocto SDK 编译指导 1 引言 本文档提供了移远通信 EG512R-EA 模块 Linux Yocto SDK 的编译说明，包括 Linux Host 端编译环境 安装以及源码编译步骤。 上海移远通信技术股份有限公司 6 / 19 EG512R-EA Yocto SDK 编译指导 2 编译环境搭建 移远通信 Linux APP 编译环境为通过 VMware Workstation 运行的 Linux 虚拟机，本章节主要介绍此 Linux 虚拟机编译环境的搭建流程。 2.1. VMware Workstation 下载及安装 Linux 虚拟机通过 VMware Workstation 运行，Workstation 可以通过 VMware 官网进行下载（建议使 用 Workstation Pro），地址为 https://www.vmware.com/cn.html。打开链接后，在导航栏选择'下载'→'免 费产品下载'→'Workstation Player'进入 Workstation Player 免费版本下载页。 备注 VMware Workstation 下载路径可能会发生变化，以上路径仅供参考。 下载完成后，打开安装程序并根据安装向导即可完成安装。 上海移远通信技术股份有限公司 7 / 19 EG512R-EA Yocto SDK 编译指导 2.2. Linux 虚拟机下载与安装 2.2.1. 操作系统镜像下载 Linux 需要的操作系统版本为 Ubuntu 14.04，可以从 http://mirrors.aliyun.com/ubuntu-releases/14.04/ 下载。打开链接后，选择下图所示红框中标记的'ubuntu-14.04.6-desktop-amd64.iso'即可进行下载。 图 1：ubuntu-14.04.6-desktop-amd64.iso 下载 上海移远通信技术股份有限公司 8 / 19 EG512R-EA Yocto SDK 编译指导 2.2.2. 安装 Linux 虚拟机至 VMware Workstation 使用下载的 Ubuntu 14.04 镜像在 VMWare Workstation 上安装虚拟机，需要 200 GB 以上硬盘空间， 推荐使用 SSD 硬盘。具体安装步骤如下： 1. 打开 VMware Workstation，选择'创建新的虚拟机'，进入'新建虚拟机向导'。选择'典型(推荐)' 后。之后，点击'下一步'。 图 2：选择'创建新的虚拟机' 图 3：使用典型推荐 上海移远通信技术股份有限公司 9 / 19 EG512R-EA Yocto SDK 编译指导 2. 点击镜像文件位置'浏览…'，选择 Ubuntu 14.04 镜像文件位置。之后，点击'下一步'。 图 4：选择 Ubuntu 14.04 镜像文件位置 3. 设置 Ubuntu 登陆信息，请牢记用户名和密码。之后，点击'下一步'。 图 5：设置 Linux Ubuntu 登陆用户账号和密码 上海移远通信技术股份有限公司 10 / 19 EG512R-EA Yocto SDK 编译指导 4. 命名虚拟机并选择 Linux Ubuntu 虚拟机安装路径。需选择剩余空间大于 200 GB 的硬盘（推 荐使用 SSD 硬盘）。之后，点击'下一步'。 图 6：选择 Linux Ubuntu 虚拟机安装位置 5. 为 Linux Ubuntu 操作系统指定磁盘空间。之后，点击'下一步'。 图 7：选择 Linux Ubuntu 磁盘空间 上海移远通信技术股份有限公司 11 / 19 EG512R-EA Yocto SDK 编译指导 6. 点击'自定义硬件…'，分配 Linux 虚拟机处理器数量，建议数量为 6，如下图所示。 图 8：分配 Linux Ubuntu 虚拟机 CPU 核数 7. 分配 Linux 虚拟机内存，建议内存为 16 GB（不可少于 8 GB）。 图 9：分配 Linux Ubuntu 虚拟机内存 备注 处理器数量越多、内存越大，编译效率就越高。 上海移远通信技术股份有限公司 12 / 19 EG512R-EA Yocto SDK 编译指导 8. 关闭自定义硬件窗口，点击'完成'，完成 Linux 虚拟机安装。 2.3. Linux 虚拟机 Host 配置 Linux 虚拟机 Host 环境配置的命令执行步骤如下： 1. 更新 Linux 系统： sudo apt-get update 2. 升级 Linux 系统： sudo apt-get upgrade 3. 安装 Yocto 开发所需软件包： sudo apt-get install build-essential chrpath coreutils cvs desktop-file-utils diffstat docbook-utils fakeroot g++ gawk gcc git git-core help2man libgmp3-dev libmpfr-dev libreadline6-dev libtool libxml2-dev make python-pip python-pysqlite2 quilt sed subversion texi2html texinfo unzip wget 4. 配置 dash： sudo dpkg-reconfigure dash -N 确认 sh 为指向 bash 的软连接，如下所示： 5. 安装 UFS 文件系统软件包： sudo apt-get install liblzo2-dev 6. 安装 zlib 包： sudo apt-get install zlib1g-dev 上海移远通信技术股份有限公司 13 / 19 7. 安装 openjdk-7： sudo apt-get install openjdk-7-jdk 若 openjdk-7 安装出错，可执行如下命令更换源： sudo add-apt-repository ppa:openjdk-r/ppa sudo apt-get update sudo apt-get install openjdk-7-jdk 8. 安装 openssh-server，开启 SSH 服务： sudo apt-get install openssh-server EG512R-EA Yocto SDK 编译指导 上海移远通信技术股份有限公司 14 / 19 EG512R-EA Yocto SDK 编译指导 3 编译 3.1. 编译源码 编译源码之前，请向移远通信获取 Quectel EG512R-EA Yocto SDK 代码。之后，按如下步骤执行命令 完成编译： 1. 修改权限： sudo chmod 777 -R apps_proc 2. 配置编译环境变量： cd apps_proc/poky source build/conf/set_bb_env.sh 3. 配置项目信息： buildconfig EG512REA EG512REAAAR01A01M4G STD YP 执行 buildconfig- -help（请忽略 buildconfig- -help 命令执行后的报错）可查看如下帮助信息： 4. 执行如下命令进行编译： build-sdxpoorwills-perf-image 根据 PC 硬件配置的不同，编译过程需要耗费 1 小时（或以上），请耐心等待编译完成。 上海移远通信技术股份有限公司 15 / 19 EG512R-EA Yocto SDK 编译指导 3.2. 编译结果 编译成功后，apps_proc/poky/build/tmp-glibc/deploy/images/sdxpoorwills-perf$ 目录中会生成如下所 列编译生成物。请根据如下所列内容核对并确认编译生成的文件。 ├── abl.elf machine-image-sdxpoorwills-20200707031753.rootfs.manifest ├── machine-image-sdxpoorwills.testdata.json -> machine-image-sdxpoorwills-20200707031753.testdata.json ├── machine-image-sdxpoorwills.ubi -> machine-image-sdxpoorwills-20200707031753.rootfs.ubi ├── machine-image-sdxpoorwills.ubifs ├── machine-recovery-image-sdxpoorwills-20200701093250.testdata.json ├── machine-recovery-image-sdxpoorwills-20200701132731.testdata.json ├── machine-recovery-image-sdxpoorwills-20200702141640.testdata.json ├── machine-recovery-image-sdxpoorwills-20200702145746.testdata.json ├── machine-recovery-image-sdxpoorwills-20200703003245.testdata.json ├── machine-recovery-image-sdxpoorwills-20200703004911.testdata.json ├── machine-recovery-image-sdxpoorwills-20200703052613.testdata.json ├── machine-recovery-image-sdxpoorwills-20200704074646.testdata.json ├── machine-recovery-image-sdxpoorwills-20200704083028.testdata.json ├── machine-recovery-image-sdxpoorwills-20200704150033.testdata.json ├── machine-recovery-image-sdxpoorwills-20200706073000.testdata.json ├── machine-recovery-image-sdxpoorwills-20200707031753.rootfs.manifest ├── machine-recovery-image-sdxpoorwills-20200707031753.rootfs.ubi ├── machine-recovery-image-sdxpoorwills-20200707031753.rootfs.ubifs ├── machine-recovery-image-sdxpoorwills-20200707031753.testdata.json 上海移远通信技术股份有限公司 16 / 19 EG512R-EA Yocto SDK 编译指导 ├── machine-recovery-image-sdxpoorwills.manifest -> machine-recovery-image-sdxpoorwills-20200707031753.rootfs.manifest ├── machine-recovery-image-sdxpoorwills.testdata.json -> machine-recovery-image-sdxpoorwills-20200707031753.testdata.json ├── sdxpoorwills-boot.img machine-recovery-image-sdxpoorwills-20200707031753.rootfs.ubi <== # recovery rootfs ├── sdxpoorwills-sysfs.ubi <== # rootfs ├── sdxpoorwills-usrfs.ubifs ├── target-files-ubi.zip ├── ubinize-machine-image-sdxpoorwills-20200707031753.cfg ├── ubinize-machine-recovery-image-sdxpoorwills-20200707031753.cfg ├── ubinize_system_userdata.cfg ├── update_ubi.zip ├── vmlinux └── zImage-dtb 如下镜像对应的源代码若有修改，编译完成后请替换固件包中对应文件并烧写到模块中。 表 1：编译镜像 镜像名称 源码目录 abl.elf apps_proc/bootable/bootloader/edk2 sdxpoorwills-boot.img apps_proc/kernel sdxpoorwills-recoveryfs.ubi sdxpoorwills-sysfs.ubi apps_proc/OTA/recovery 除上述目录外的其他所有目录 镜像分类 app bootloader Linux kernel image Recovery root file system Root file system 上海移远通信技术股份有限公司 17 / 19 EG512R-EA Yocto SDK 编译指导 图 10：生成物镜像 备注 1. 可使用 QFlash 工具将固件包烧写至模块中，操作方法请参考《Quectel_QFlash_用户指导》。 2. 部分文件生成时带有格式为'yyyymmddhhmmss'时间信息后缀，会依据编译时间而更新。 上海移远通信技术股份有限公司 18 / 19 EG512R-EA Yocto SDK 编译指导 4 附录 A 参考文档及术语缩写 表 2：参考文档 序号 [1] 文档名称 Quectel_QFlash_用户指导 备注 QFlash 工具用户指导 表 3：术语缩写 缩写 APP CPU SDK SSD 英文全称 Application Central Processing Unit Software Development Kit Solid State Disk 中文全称 应用程序 中央处理器 软件开发工具包 固态硬盘 上海移远通信技术股份有限公司 19 / 19

EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 LTE-A 模块系列 版本：1.1 日期：2023-12-07 状态：受控文件 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2022-05-09 2022-05-26 2023-12-07 作者 变更描述 Shaun DUAN 文档创建 Shaun DUAN Shaun DUAN/ Jayde TONG 受控版本 1. 新增以下适用模块： EG060K 系列、 EG120K 系列、 EM060K 系列和 EM120K-GL。 2. 更新证书链相关内容（第 2.3 章）。 3. 新增 AT+QSECBOOT='roothash'（第 3.3 章）。 4. 更新注意事项（第 4 章）。 上海移远通信技术股份有限公司 3 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 Secure Boot 概述................................................................................................................................. 7 2.1. Secure Boot 定义 ....................................................................................................................... 7 2.2. 使能 Secure Boot ....................................................................................................................... 7 2.3. 证书链......................................................................................................................................... 7 2.4. 签名镜像文件.............................................................................................................................. 8 2.5. QFPROM 配置 ........................................................................................................................... 8 3 Secure Boot 相关 AT 命令................................................................................................................... 9 3.1. AT 命令语句................................................................................................................................ 9 3.1.1. 定义 ................................................................................................................................. 9 3.1.2. AT 命令语句..................................................................................................................... 9 3.2. AT 示例声明.............................................................................................................................. 10 3.3. AT 命令详解.............................................................................................................................. 10 3.3.1. AT+QSECBOOT 使能或查询 Secure Boot................................................................. 10 3.3.1.1. AT+QSECBOOT='status' 查询 Secure Boot 使能状态................................... 10 3.3.1.2. AT+QSECBOOT='serialnum' 查询模块唯一序列号 ........................................11 3.3.1.3. AT+QSECBOOT='roothash' 查询模块根证书的 Hash 值................................11 3.3.1.4. AT+QSECBOOT='progsec' 使能 Secure Boot............................................... 12 4 注意事项 .............................................................................................................................................. 13 5 附录 术语缩写..................................................................................................................................... 14 上海移远通信技术股份有限公司 4 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 表格索引 表 1：适用模块 .................................................................................................................................................... 6 表 2：AT 命令类型 ............................................................................................................................................... 9 表 3：术语缩写 .................................................................................................................................................. 14 上海移远通信技术股份有限公司 5 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 1 引言 移远通信 LTE-A EG06xK，Ex120K 和 EM060K 系列模块支持 Secure Boot 功能。本文档介绍如何使 用 AT 命令在 EG06xK，Ex120K 和 EM060K 系列模块上开启 Secure Boot 功能，包括 Secure Boot 概述、 AT 命令详解以及注意事项。 1.1. 适用模块 表 1：适用模块 模块系列 EG06xK Ex120K - 模块 EG060K 系列 EG065K 系列 EM120K-GL EG120K 系列 EM060K 系列 上海移远通信技术股份有限公司 6 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 2 Secure Boot 概述 2.1. Secure Boot 定义 Secure Boot 是一种建立在授信平台上的安全启动序列。为了保证仅执行通过验证的软件，Secure Boot 在启动过程中增加了验证签名环节。 为防止没有经过合法签名或被恶意修改的软件在模块上运行，Secure Boot 在模块启动过程的每个阶段 均增加了验证签名环节。在一系列启动阶段中，需有一个根信任实体，模块中的 PBL（Primary Boot Loader） 作为固件固化在模块中，且无法被修改，可作为根信任实体。 2.2. 使能 Secure Boot 仅可通过硬件上的熔断器使能 Secure Boot，且使能后无法关闭 Secure Boot。 模块的启动过程分为多个阶段，每个阶段都由一个专用的镜像文件完成特定的功能。使能 Secure Boot 之后，每一阶段的镜像文件在执行前，都需要前一阶段的镜像文件对其进行校验；如果校验失败，会造成整 个启动过程失败，进而模块启动失败。 作为信任根，PBL（也称为 RoT）是一种包含在芯片中的固件且无法修改，因此是可信任的（启动过程 的最信任实体）并可作为下一启动阶段的授信中心；下一启动阶段一般是 SBL（Secondary Boot Loader） 经过验证签名后被执行，可以使用 SBL 进行授信操作。 2.3. 证书链 Secure Boot 使用 2048 位 RSA 算法和 SHA-256 摘要算法，用于证书以及镜像文件的签名。 模块的证书链使用三级证书链：Self-signed root certificate、Attestation CA certificate 和 Attestation certificate。 上海移远通信技术股份有限公司 7 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 2.4. 签名镜像文件 镜像文件的标准格式为 ELF，在 Secure Boot 中，验证启动过程中的每个阶段需要对每个阶段的镜像 文件进行签名操作。标准的 ELF 格式二进制文件包含多个段，分别代表不同种类的信息，其中签名相关的 信息保存在 hash table segment 中。Hash table segment 中还包含每个段的 hash 值，以及证书信任链相 关的信息。 模块中必须签名的镜像文件如下： ⚫ sbl1.mbn ⚫ appsboot.mbn ⚫ prog_nand_firehose_9x55.mbn ⚫ rpm.mbn ⚫ tz.mbn ⚫ devcfg.mbn ⚫ qdsp6sw.mbn ⚫ mba.mbn ⚫ mcfg_sw.mbn ⚫ mcfg_hw.mbn 2.5. QFPROM 配置 模块包含一次性可编程熔断器。所有熔断器初始状态均为 0（表示未启动 Secure Boot）。一旦进行写 入（即熔断）操作，熔断器状态将永久地改变为 1（表示启动 Secure Boot）。熔断后，状态无法改变。需 要使用 QFPROM 编程工具协助完成 Secure Boot 的启动。 QFPROM 用于在一个非易失性 ROM（Non-volatile Read Only Memory）中存储代表芯片鉴权相关的 配置，可实现 Secure Boot 所需的安全环境。配置 QFPROM，进行熔断操作，进而完成所需要的安全功能， 例如：Debug 端口的输出功能、JTAG 功能、安全文件系统和软件防回滚功能等。 上海移远通信技术股份有限公司 8 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 3 Secure Boot 相关 AT 命令 3.1. AT 命令语句 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT 命令详解 3.3.1. AT+QSECBOOT 使能或查询 Secure Boot 功能 AT+QSECBOOT 使能或查询 Secure Boot 功能 测试命令 AT+QSECBOOT=? 响应 +QSECBOOT: 'status',(支持的列表) +QSECBOOT: 'serialnum', +QSECBOOT: 'roothash', +QSECBOOT: 'progsec',(支持的列表) OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 3.3.1.1. AT+QSECBOOT='status' 查询 Secure Boot 使能状态 该命令用于查询模块当前是否已使能 Secure Boot。 AT+QSECBOOT='status' 查询 Secure Boot 使能状态 设置命令 响应 AT+QSECBOOT='status' +QSECBOOT: 'status', OK 最大响应时间 若有任何错误： ERROR 300 毫秒 上海移远通信技术股份有限公司 10 / 14 特性说明 参数 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 / 整型。Secure Boot 使能状态。 1 已使能 0 未使能 3.3.1.2. AT+QSECBOOT='serialnum' 查询模块唯一序列号 该命令用于查询模块的唯一序列号。 AT+QSECBOOT='serialnum' 查询模块唯一序列号 设置命令 响应 AT+QSECBOOT='serialnum' +QSECBOOT: 'serialnum', OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 字符串类型。模块的序列号。十六进制格式，不含双引号。 3.3.1.3. AT+QSECBOOT='roothash' 查询模块根证书的 Hash 值 该命令用于查询模块使能 Secure Boot 后所使用的根证书的 Hash 值。 AT+QSECBOOT='roothash' 查询模块根证书的 Hash 值 设置命令 响应 AT+QSECBOOT='roothash' +QSECBOOT: 'roothash', OK 若有任何错误： ERROR 上海移远通信技术股份有限公司 11 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 最大响应时间 特性说明 300 毫秒 / 参数 字符串类型。模块根证书的 Hash 值。十六进制格式，不含双引号。 备注 未使能 Secure Boot 时，查询到模块根证书的 Hash 值为 0。 3.3.1.4. AT+QSECBOOT='progsec' 使能 Secure Boot 该命令用于使能 Secure Boot。 AT+QSECBOOT='progsec' 使能 Secure Boot 设置命令 AT+QSECBOOT='progsec'[,] 响应 若省略可选参数，则查询当前状态： +QSECBOOT: 'progsec', OK 若指定可选参数，则使能 Secure Boot： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令在模块重启后生效； 参数配置自动保存。 参数 整型。使能 Secure Boot。 1 使能 0 未使能（仅在查询结果中有效） 上海移远通信技术股份有限公司 12 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 4 注意事项 1. Secure Boot 只能通过硬件上的 Fuse 打开，一旦打开无法关闭。 2. 推荐使用 AT+QSECBOOT='progsec',1 使能 Secure Boot，模块 Secure Boot 默认未使能；该命 令在 sec 分区中烧录镜像文件，重启模块后自动激活 Secure Boot。 3. 使能 Secure Boot 后，无法通过 Firehose 将固件降级到不支持 Secure Boot 的版本。 4. 使能 Secure Boot 后，不支持通过 FOTA 将版本降级至不支持 Secure Boot 的固件版本，否则将导 致无法正常启动模块。 5. PCIe Fuse 模式也是在 sec 分区中烧录镜像文件，与 Secure Boot 的使能有冲突。若先使能 Secure Boot，则无法使能 PCIe Fuse 模式。因此必须先使能 PCIe Fuse 模式后再使能模块的 Secure Boot。 6. Secure Boot 必须在工厂阶段开启。禁止将固件版本升级到支持 Secure Boot 的版本后再开启 Secure Boot，否则可能会导致部分功能异常且无法恢复。使能 Secure Boot 之前不建议对模块进 行配置类的操作，例如 SIMLOCK 配置。 上海移远通信技术股份有限公司 13 / 14 EG06xK&Ex120K&EM060K 系列 Secure Boot 应用指导 5 附录 术语缩写 表 3：术语缩写 缩写 英文全称 中文全称 CA Certificate Authority 证书授权 ELF Executable and Linkable Format 可执行可链接格式 FOTA Firmware Over-The-Air 固件空中升级 MBN Multi Boot Image Format 多启动镜像文件格式 PBL Primary Boot Loader 主引导加载程序 PCIe Peripheral Component Interconnect Express 快捷外围部件互连标准 QFPROM Qualcomm Fuse Programmable Read Only Memory 一次性可编程只读存储器 ROM RPM RoT Read Only Memory 只读存储器 RPM Package Manager (originally Red Hat Package RPM软件包管理器 Manager) Root of Trust 可信根 SBL Secondary Boot Loader 二级引导加载程序 SHA Secure Hash Algorithm 安全散列算法 上海移远通信技术股份有限公司 14 / 14

EC2x&EG9x&EG2x-G&EM05 Series IMS Application Note LTE Standard Module Series Version: 1.0 Date: 2021-09-23 Status: Released LTE Standard Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 1 / 28 LTE Standard Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 2 / 28 LTE Standard Module Series About the Document Revision History Version 1.0 Date 2021-01-25 2021-09-23 Author Wythe WANG/ Yosef ZHANG Wythe WANG/ Yosef ZHANG Description Creation of the document First official release EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 3 / 28 LTE Standard Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 1.1. Applicable Modules .................................................................................................................... 7 1.2. Introduction of MBN ................................................................................................................... 7 1.2.1. MBN File.......................................................................................................................... 7 1.2.2. MBN Type........................................................................................................................ 8 1.2.3. MBN Selection ................................................................................................................ 9 1.3. Introduction of IMS ..................................................................................................................... 9 1.3.1. IMS Registration Process ............................................................................................. 10 1.3.2. Processes of Services over IMS ....................................................................................11 1.3.2.1. VoLTE ..................................................................................................................11 1.3.2.2. SMS.................................................................................................................... 12 1.3.2.3. Emergency Call .................................................................................................. 13 1.3.2.4. DTMF.................................................................................................................. 13 1.3.2.5. SRVCC ............................................................................................................... 14 2 IMS Related AT Commands ............................................................................................................. 16 2.1. AT Command Introduction ....................................................................................................... 16 2.1.1. Definitions...................................................................................................................... 16 2.1.2. AT Command Syntax .................................................................................................... 16 2.2. Declaration of AT Command Examples ................................................................................... 17 2.3. Description of AT Commands .................................................................................................. 17 2.3.1. AT+QCFG='ims' Configure IMS ................................................................................ 17 2.3.2. AT+QMBNCFG Extended MBN Configuration........................................................... 18 2.3.2.1. AT+QMBNCFG='List' List All MBN Files ........................................................ 18 2.3.2.2. AT+QMBNCFG='Select' Select a Specific MBN File ..................................... 19 2.3.2.3. AT+QMBNCFG='Deactivate' Deactivate MBN Files ...................................... 20 2.3.2.4. AT+QMBNCFG='AutoSel' Configure MBN Automatic Selection ................... 20 2.3.2.5. AT+QMBNCFG='Delete' Delete a Specified MBN File .................................. 21 2.3.2.6. AT+QMBNCFG='Add' Add a New MBN File .................................................. 22 2.3.2.7. AT+QMBNCFG='List_all' Query PLMN Contained in MBN ........................... 22 2.4. Examples.................................................................................................................................. 23 2.4.1. Upload MBN File Manually ........................................................................................... 23 2.4.2. Automatic Selection Feature ......................................................................................... 24 3 Appendix References ....................................................................................................................... 26 EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 4 / 28 LTE Standard Module Series Table Index Table 1: Types of AT Commands ............................................................................................................... 16 Table 2: Related Documents ...................................................................................................................... 26 Table 3: Terms and Abbreviations .............................................................................................................. 26 EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 5 / 28 LTE Standard Module Series Figure Index Figure 1: IMS Registration Procedure........................................................................................................ 10 Figure 2: VoLTE Call Procedure..................................................................................................................11 Figure 3: SMS over IMS Procedure ........................................................................................................... 12 Figure 4: Emergency Call over IMS Procedure ......................................................................................... 13 Figure 5: DTMF over IMS Procedure......................................................................................................... 13 Figure 6: SRVCC over IMS Procedure ...................................................................................................... 14 EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 6 / 28 LTE Standard Module Series 1 Introduction This document introduces application of the IMS feature from the following aspects. ⚫ Instruction of MBN (Modem Configuration Binary) ⚫ Instruction of IMS (IP Multimedia Subsystem) ⚫ AT commands and examples related to MBN and IMS 1.1. Applicable Modules Table 1: Applicable Modules Module Series EC2x EG9x EG2x-G EM05 Module EC21 Series EC25 Series EC20-CE EG91 Series EG95 Series EG21-G EG25-G EM05 Series 1.2. Introduction of MBN 1.2.1. MBN File MBN (Modem Configuration Binary) files are a set of configurations that the system will read during module initialization to assign values for state variables to meet the operational requirements of carriers’ network, so as to configure IMS functions. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 7 / 28 LTE Standard Module Series MBN contains NV Item list with preset default values, EFS file list, MBN version information, and MBN-matching phone card information (ICCID, IMSI). And it is divided into three parts: NV Items Configuration Area, EFS File Configuration Area, and Trailer Record Configuration Area. NV Items Configuration Area contains the following parameters: MBN version, MBN version date, MBN-matching phone card information (ICCID, IMSI), etc., which are to be set based on operator requirements. When the MBN to be activated is selected (automatically or manually), the module reads all the NVM/EFS item lists from the MBN, and write these default values into the configuration. After that, the module will operate based on these configurations. In the same way, when the MBN is deactivated, the module will delete all the NV/EFS item lists that have been read from the MBN. If an NV item of the MBN files is changed through AT command, when the MBN is activated or deactivated, the previously configured NV item will recover to default. The purpose of MBN file is to maintain different NV item lists and EFS file lists for operators based on IMSI and ICCID. Therefore, it is very convenient to support certification and VoLTE service. NOTE Please contact Quectel Technical Supports (support@quectel.com) for the latest MBN list. 1.2.2. MBN Type In most cases, there is one ROW MBN and many operator MBNs in the module. The operator MBN files are used for certification or VoLTE requirements. Usually, it is named after abbreviations of operators’ names. However, not all operator MBN files enable IMS by default. The ROW MBN file contains general NV settings. For example, the attached APN from ROW MBN file is null since ROW MBN file indicates to a non-specific operator. When the ROW MBN file activated, you should write the list of mandatory NV items for network registration or service request by AT command manually. ROW MBN file is usually used when the operator MBNs based on the inserted (U)SIM card cannot be activated. If no MBN file of a specific operator matches the inserted (U)SIM card, ROW MBN file will be activated automatically. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 8 / 28 LTE Standard Module Series 1.2.3. MBN Selection You can check whether the automatic MBN selection is enabled by AT+QMBNCFG='AutoSel', which can be referred to in Chapter 2.3.2.4. When MBN Auto Selection is enabled, the MBN file is activated based on the IMSI of the inserted (U)SIM card. In case of no MBN file including the IMSI of the inserted (U)SIM card, ROW MBN file will be activated. 1.3. Introduction of IMS IMS (IP Multimedia Subsystem) includes all CN elements for providing IP multimedia services comprising audio, video, text, etc. and a combination of them delivered over the PS domain. VoLTE (Voice over LTE) is a new voice solution utilizing IMS technology. IMS is more like the voice service bearer. In addition to voice, IMS network also supports SMS, emergency calls, DTMF, etc. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 9 / 28 1.3.1. IMS Registration Process LTE Standard Module Series Figure 1: IMS Registration Procedure IMS registration is the mandatory procedure for all services over IMS and the registration should be successful before triggering any service. You can check the IMS registration status by AT+QCFG='ims', which can be referred to in Chapter 2.3.1. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 10 / 28 LTE Standard Module Series 1.3.2. Processes of Services over IMS These services procedures based on the IMS network listed below are introduced by the following sections. ⚫ VoLTE over IMS ⚫ SMS over IMS ⚫ Emergency call over IMS ⚫ DTMF over IMS ⚫ SRVCC over IMS 1.3.2.1. VoLTE Caller Network Callee SIP INVITE request with SDP offer SIP INVITE response 100 TRYING SIP INVITE request 183 SESSION_PROGRESS SDP offer Paging SIP INVITE request with SDP offer SIP INVITE response 100 TRYING SIP INVITE request 183 SESSION_PROGRESS SDP offer SIP PRACK request SIP PRACK response 200 OK SIP PRACK request SIP PRACK response 200 OK SIP UPDATE request SIP UPDATE response 200 OK SIP UPDATE request SIP UPDATE response 200 OK SIP INVITE response 180 RINGING SIP INVITE response 180 RINGING Early media over dedicated bearer Early media over dedicated bearer SIP INVITE response 200 OK SIP ACK SIP INVITE response 200 OK SIP ACK Regular media over dedicated bearer Regular media over dedicated bearer SIP BYE request SIP BYE request SIP BYE response 200 OK Figure 2: VoLTE Call Procedure NOTE In case of any error occurring in VoLTE roaming scenario, please provide the logs to Quectel Technical Supports (support@quectel.com) for further analysis. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 11 / 28 LTE Standard Module Series 1.3.2.2. SMS Sender Network Receiver SIP REGISTER with '+g.3gpp.smsip' SIP REGISTER 200 OK SIP REGISTER with '+g.3gpp.smsip' SIP REGISTER 200 OK SIP MESSAGE Content Type: vnd.3gpp.sms RP-User-Data with SMS-SUBMIT SIP 202 ACCEPT SIP MESSAGE Content Type: vnd.3gpp.sms RP-ACK with SMS-SUBMIT REPORT SIP 200 OK SIP MESSAGE Content Type: vnd.3gpp.sms RP-User-Data with SMS-SUBMIT DELIVER SIP 200 OK SIP MESSAGE Content Type: vnd.3gpp.sms RP-ACK with SMS-DELIVER REPORT SIP 202 ACCEPT Figure 3: SMS over IMS Procedure EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 12 / 28 1.3.2.3. Emergency Call LTE Standard Module Series Figure 4: Emergency Call over IMS Procedure Generally, the emergency call number is gathered from the (U)SIM card, UE setting and network-assigned attach accept message. Quectel modules support reading all emergency call number types. In addition, you can usually add an emergency call numbers with AT+QECCNUM, and then take effect immediately and be saved automatically. Please refer to document [1] for details of the command. 1.3.2.4. DTMF Figure 5: DTMF over IMS Procedure RFC 2833 RTP event is a popular solution for DTMF over IMS. When it is received and detected correctly, DTMF tone is played simultaneously with DTMF URC. NOTE Currently the applicable modules of this document support RFC 2833 RTP event only. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 13 / 28 LTE Standard Module Series 1.3.2.5. SRVCC SRVCC (Single Radio Voice Call Continuity) provides the ability to transit a voice call from a VoIP/IMS domain to the legacy circuit switch domain. The high-level call flow is illustrated by the following figure. Figure 6: SRVCC over IMS Procedure EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 14 / 28 LTE Standard Module Series From a UE perspective, the SRVCC process involves: 1. SRVCC capability negotiation – UE and MME should agree on the capabilities and whether SRVCC should be supported. This negotiation is performed in different stages using RRC and NAS signaling. 2. Initiating a voice call – For SRVCC purposes, the voice call will be anchored at VCC task. 3. Channel measurements and reporting – On LTE network, UE shall perform the normal channel measurements on E-UTRAN. 4. If the channel quality with the current eNodeB falls below a certain level, UE will notify eNodeB of it. 5. UE reports the measurements based on the triggers specified by eNodeB. The desired target could be EUTRAN or UTRAN/GERAN. 6. Handover to UMTS/GERAN and derivation of keys upon SRVCC HO. 7. UE uses the CS path to continue the voice call. Generally, SRVCC is enable by default. You can check it from attach request and UE capability information message. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 15 / 28 LTE Standard Module Series 2 IMS Related AT Commands 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 1: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 16 / 28 LTE Standard Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you familiarize with AT commands and learn how to use them. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. 2.3. Description of AT Commands 2.3.1. AT+QCFG='ims' Configure IMS AT+QCFG='ims' Configure IMS Write Command AT+QCFG='ims'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'ims',, OK If the optional parameter is specified, configure IMS: OK Or ERROR Maximum Response Time Characteristics If error is related to ME functionality: +CME ERROR: 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Whether to enable/disable IMS function. 0 Whether to enable/disable IMS function is determined by the default setting in MBN file 1 Enable IMS function compulsorily 2 Disable IMS function compulsorily Integer type. Indicates the capability of VoLTE. 0 VoLTE is disabled EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 17 / 28 LTE Standard Module Series 1 VoLTE is enabled Error codes. Please refer to document [2] for details. Example AT+QCFG='ims' +QCFG: 'ims',0,0 OK AT+QCFG='ims',1 OK AT+QCFG='ims' +QCFG: 'ims',1,1 OK //Query the current configuration //Enable IMS function compulsorily //Query current settings //VoLTE is enabled, and VoLTE session is available 2.3.2. AT+QMBNCFG Extended MBN Configuration AT+QMBNCFG Extended MBN Configuration Test Command AT+QMBNCFG=? Response +QMBNCFG: 'List' +QMBNCFG: 'Select'[,] +QMBNCFG: 'Deactivate' +QMBNCFG: 'AutoSel'[,(list of supported s)] +QMBNCFG: 'Delete','' +QMBNCFG: 'Add','' +QMBNCFG: 'List_all' Maximum Response Time Characteristics OK 300 ms / 2.3.2.1. AT+QMBNCFG='List' List All MBN Files This command queries all the MBN files available in the module. AT+QMBNCFG='List' List All MBN Files Write Command AT+QMBNCFG='List' Response [+QMBNCFG: 'List',,,,,, EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 18 / 28 LTE Standard Module Series Maximum Response Time Characteristics [+QMBNCFG: 'List',,,,,, […]]] OK 30 s / Parameter Integer type. Current MBN index number. Integer type. Indicates whether the MBN file is selected. The MBN file that is selected but not activated will be activated in the next reboot. 0 The current MBN file is not selected 1 The current MBN file is selected Integer type. Indicate whether the MBN file is activated. 0 The current MBN file is not activated 1 The current MBN file is activated String type. MBN file name. The current MBN version. The release date of the current MBN file. NOTE Maximum 25 MBN files are currently supported. 2.3.2.2. AT+QMBNCFG='Select' Select a Specific MBN File This command selects a specific MBN file loaded in the module. AT+QMBNCFG='Select' Select a Specific MBN File Write Command Response AT+QMBNCFG='Select', OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 19 / 28 Parameter String type. MBN file name. LTE Standard Module Series 2.3.2.3. AT+QMBNCFG='Deactivate' Deactivate MBN Files This command deactivates the MBN files that is running on the module. AT+QMBNCFG='Deactivate' Deactivate MBN Files Write command AT+QMBNCFG='Deactivate' Response OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Example AT+QMBNCFG='List' +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 OK AT+QMBNCFG='Deactivate' OK AT+QMBNCFG='List' +QMBNCFG: 'List',0,0,0,'ROW_Commercial',0x05010800,201801051 OK 2.3.2.4. AT+QMBNCFG='AutoSel' Configure MBN Automatic Selection This command configures automatic selection of MBN file. AT+QMBNCFG='AutoSel' Configure MBN Automatic Selection Write Command AT+QMBNCFG='AutoSel'[,] Response If the optional parameter is omitted, query the current setting: +QMBNCFG: 'AutoSel', OK EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 20 / 28 LTE Standard Module Series If the optional parameter is specified, configure automatic selection of MBN file: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect after rebooting. The configuration will be saved automatically. Parameter Integer type. Enable or disable the automatic selection of MBN file. 0 Disable 1 Enable NOTE 1. When this function is enabled, the MBN file will be automatically selected based on the IMSI of (U)SIM card by default. 2. When the function is enabled but no appropriate MBN file is activated, the module will reboot automatically to select and activate a suitable MBN file. 2.3.2.5. AT+QMBNCFG='Delete' Delete a Specified MBN File The command deletes a specified MBN file from EFS. AT+QMBNCFG='Delete' Delete a Specified MBN File Write Command AT+QMBNCFG='Delete', Response OK Or ERROR Maximum Response Time 300 ms Characteristics The command takes effect after rebooting. The configuration will be saved automatically. Parameter String type. MBN file name, e.g., 'ROW_Commercial'. EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 21 / 28 LTE Standard Module Series 2.3.2.6. AT+QMBNCFG='Add' Add a New MBN File The command adds a new MBN file that needs to be uploaded to the UFS in advance. AT+QMBNCFG='Add' Add a New MBN File Write Command AT+QMBNCFG='Add', Response OK Or ERROR Maximum Response Time 300 ms Characteristics / Parameter String type. File name. Maximum length: 63 characters, e.g., 'test.mbn'. Example AT+QFUPL='test.mbn',9436 CONNECT //Input an MBN file whose size is 9436 bytes +QFUPL: 9436,657c OK AT+QMBNCFG='Add','test.mbn' OK 2.3.2.7. AT+QMBNCFG='List_all' Query PLMN Contained in MBN This command queries the PLMNs contained in every MBN. AT+QMBNCFG='List_all' Query PLMN Contained in MBN Write Command AT+QMBNCFG='List_all' Response [+QMBNCFG: 'List_all',,,, ,,, […]] Maximum Response Time Characteristics OK 300 s / EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 22 / 28 LTE Standard Module Series Parameter Integer type. Current MBN sequence number. Integer type. Indicates whether the MBN is selected. Selected but not activated MBN file will be activated in the next reboot. 0 The current MBN file is not selected 1 The current MBN file is selected Integer type. Indicates whether the MBN list is activated. 0 The current MBN file is not activated 1 The current MBN file is activated String type. MBN file name. Current MBN version. The release date of the current MBN. List of supported PLMNs contained in the imported MBN. Example AT+QMBNCFG=? … +QMBNCFG: 'List_all' … OK AT+QMBNCFG='List_all' //Query PLMNs contained in MBN +QMBNCFG: 'List_all',0,0,0,'ROW_Generic_3GPP',0x05010824,201806201,'' +QMBNCFG: 'List_all',1,1,1,'OpenMkt-Commercial-CU',0x05011510,201911151,'460-01' +QMBNCFG: 'List_all',2,0,0,'OpenMkt-Commercial-CT',0x0501131C,201911141,'455-07' +QMBNCFG: 'List_all',3,0,0,'Volte_OpenMkt-Commercial-CMCC',0x05012011,201904261,'460-00 ' OK 2.4. Examples 2.4.1. Upload MBN File Manually AT+QMBNCFG='List' OK AT+QFLST='*' OK AT+QFUPL='test.mbn',9436 CONNECT //List all MBN files //Only OK is responded, indicating no MBN file //List all files in the UFS //Only OK is responded, indicating no file in the UFS //Upload file test.mbn whose size should be 9436 bytes EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 23 / 28 LTE Standard Module Series //Input an MBN file whose size is 9436 bytes. +QFUPL: 9436,657c OK AT+QFLST='*' +QFLST: 'test.mbn',9436 //List all files in the UFS //The uploaded file test.mbn is listed OK AT+QMBNCFG='Add','test.mbn' //Add test.mbn as MBN file OK AT+QMBNCFG='List' //List all MBN files +QMBNCFG: 'List',0,0,0,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being neither selected nor activated OK AT+QMBNCFG='Select','ROW_Commercial' //Select ROW MBN OK AT+QMBNCFG='List' //List all MBN files +QMBNCFG: 'List',0,1,0,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being selected but not activated OK //Restart the module AT+QMBNCFG='List' //List all MBN files +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being selected and activated OK 2.4.2. Automatic Selection Feature AT+QMBNCFG='List' //List all MBN files +QMBNCFG: 'List',0,0,0,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being neither selected nor activated OK AT+QMBNCFG='Autosel' +QMBNCFG: 'Autosel',0 //Query the configuration of MBN automatic selection //Automatic selection of MBN file is disabled OK EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 24 / 28 LTE Standard Module Series AT+QMBNCFG='Autosel',1 OK //Restart the module manually RDY POWERED DOWN RDY //Enable automatic selection of MBN file //The module reboots automatically to activate a suitable MBN file +CPIN: READY +QUSIM: 1 +QIND: SMS DONE AT+QMBNCFG='List' +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 //ROW MBN is listed, with state being selected and activated OK //Restart the module manually RDY +CPIN: READY +QUSIM: 1 //The module does not reboot if a suitable MBN file has been activated //The MBN file is activated. +QIND: SMS DONE AT+QMBNCFG='List' +QMBNCFG: 'List',0,1,1,'ROW_Commercial',0x05010800,201801051 OK EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 25 / 28 LTE Standard Module Series 3 Appendix References Table 2: Related Documents Document Name [1] Quectel_EC2x&EG9x&EG2x-G_Series_AT_Commands_Manual [2] Quectel_EC2x&EG9x&EG2x-G_Series_QCFG_AT_Commands_Manual Table 3: Terms and Abbreviations Abbreviation AKA AS CN CS DTMF EFS eNodeB EPS EUTRAN GERAN HO IMS IMSI IP Description Authentication and Key Agreement Access Stratum Core Network Circuit Switched Dual Tone Multi Frequency Embedded File System Evolved Node B Evolved Packet System Evolved Universal Terrestrial Radio Access Network GSM EDGE Radio Access Network Hand Over IP Multimedia Subsystem International Mobile Subscriber Identification Number Internet Protocol EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 26 / 28 LTE MBN MME NAS NV NW PCM PCRF PCSCF PDN PDP PGW PLMN PS QCI RES RFC RRC RTP SDP SIM SIP SMS SRVCC TA UE LTE Standard Module Series (Long-Term Evolution) a 4G mobile communications standard. Modem Configuration Binary Mobility Management Entity Non-Access-Stratum Non-Volatile Network Pulse Code Modulation Policy and Charging Rules Function Proxy-Call Session Control Function Public Data Networks Packet Data Protocol PDN (Packet Data Network) Gateway Public Land Mobile Network Packet Switch QoS Class Identifier Response Request For Comments Radio Resource Control Real-time Transport Protocol Session Description Protocol Subscriber Identity Module Session Initiation Protocol Short Message Service Single Radio Voice Call Continuity Terminal Adapter User Equipment EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 27 / 28 UFS (U)SIM UTRAN VCC VoIP VoLTE LTE Standard Module Series User File System (Universal) Subscriber Identity Module UMTS Terrestrial Radio Access Network Voice Call Continuity Voice over Internet Protocol Voice (voice calls) over LTE EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 28 / 28

RGx00U&RM500U 系列 TCP/IP 应用指导 5G 模块系列 版本：2.1 日期：2023-07-20 状态：受控文件 RGx00U&RM500U 系列 TCP/IP 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 文档历史 修订记录 版本 1.0 1.1 2.0 日期 作者 2021-03-23 Polo YE 2021-04-20 Polo YE 2021-09-06 Polo YE 2022-01-13 Wayen XU 变更表述 文档创建 受控版本 增加适用模块 RG200U-CN。 1. 增加支持的 Socket 服务类型：TCP 服务器和 UDP 服务器； 修改 PDP 上下文 ID 范围为 1~5； 2. 增加 AT 命令使用流程介绍（第 1.1 章）； 3. 增加数据访问模式说明（第 1.2 章）； 4. 增加如下 AT 命令（第 2.3 章）： AT+QICSGP AT+QIACT AT+QIDEACT AT+QIACTEX AT+QIDEACTEX AT+QIRD AT+QISWTMD AT+QIDNSCFG AT+QICFG AT+QISDE AT+QIGETERROR 5. 更新 AT+QIOPEN（第 2.3.6 章）； 6. 更新 AT+QICLOSE（第 2.3.7 章）； 7. 更新 AT+QISTATE（第 2.3.8 章）； 8. 更新 AT+QISEND（第 2.3.9 章）； 9. 删除 URC+QIRD（第 2.4 章）； 10. 增加如下 URC（第 2.4 章）： +QIURC: 'closed' +QIURC: 'recv' 上海移远通信技术股份有限公司 3 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 +QIURC: 'incoming full' +QIURC: 'incoming' +QIURC: 'pdpdeact' 11. 更新示例（第 3 章）； 12. 增加错误码（第 4 章）。 1. 新 增 以 下 适 用 模 块 ： RG200U-JO 、 RG500U-EA 和 2.1 2023-07-20 Wayen XU RM500U-EA。 2. 更新 TCP/IP AT 命令使用流程图（第 1.1 章节）。 上海移远通信技术股份有限公司 4 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 5 表格索引 ........................................................................................................................................................ 7 1 引言 ........................................................................................................................................................ 8 1.1. TCP/IP AT 命令使用流程............................................................................................................ 8 1.2. 数据访问模式说明 ..................................................................................................................... 10 2 TCP/IP AT 命令详解 ........................................................................................................................... 12 2.1. AT 命令说明............................................................................................................................... 12 2.1.1. 定义 ................................................................................................................................ 12 2.1.2. AT 命令语句.................................................................................................................... 12 2.2. AT 示例声明............................................................................................................................... 13 2.3. AT 命令说明............................................................................................................................... 13 2.3.1. AT+QICFG 配置可选参数 ............................................................................................ 13 2.3.2. AT+QICSGP 配置 TCP/IP 上下文参数 ........................................................................ 19 2.3.3. AT+QIACT 激活 PDP 上下文....................................................................................... 20 2.3.4. AT+QIDEACT 去激活 PDP 上下文 .............................................................................. 22 2.3.5. AT+QIACTEX 异步激活 PDP 上下文........................................................................... 23 2.3.6. AT+QIDEACTEX 异步去激活 PDP 上下文.................................................................. 24 2.3.7. AT+QIOPEN 打开 Socket 服务.................................................................................... 25 2.3.8. AT+QICLOSE 关闭 Socket 服务.................................................................................. 27 2.3.9. AT+QISTATE 查询 Socket 服务状态............................................................................ 28 2.3.10. AT+QISEND 发送数据 ................................................................................................. 30 2.3.11. AT+QIRD 读取收到的 TCP/IP 数据 ............................................................................. 33 2.3.12. AT+QISWTMD 切换数据访问模式............................................................................... 35 2.3.13. AT+QPING 进行远程服务器 Ping 操作........................................................................ 36 2.3.14. AT+QIDNSCFG 配置 DNS 服务器地址 ....................................................................... 37 2.3.15. AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 ................................................ 38 2.3.16. AT+QIGETERROR 查询上一个 AT 命令错误代码....................................................... 39 2.4. URC 说明 .................................................................................................................................. 40 2.4.1. +QIURC: 'closed' 连接断开通知 ................................................................................ 40 2.4.2. +QIURC: 'recv' 数据接收通知 .................................................................................... 40 2.4.3. +QIURC: 'incoming full' 客户端连接已满通知........................................................... 41 2.4.4. +QIURC: 'incoming' 客户端连接通知......................................................................... 41 2.4.5. +QIURC: 'pdpdeact' PDP 去激活通知 ....................................................................... 42 3 示例 ...................................................................................................................................................... 43 3.1. 上下文配置和激活 ..................................................................................................................... 43 3.1.1. 上下文配置 ..................................................................................................................... 43 3.1.2. 上下文激活 ..................................................................................................................... 43 3.1.3. 上下文去激活.................................................................................................................. 43 3.2. TCP 客户端在缓存模式下工作 .................................................................................................. 43 上海移远通信技术股份有限公司 5 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 3.2.1. 创建 TCP 客户端连接并进入缓存模式 ........................................................................... 43 3.2.2. 缓存模式下发送数据....................................................................................................... 44 3.2.3. 缓存模式下从远程服务器接收数据 ................................................................................. 44 3.2.4. 断开连接 ......................................................................................................................... 45 3.3. TCP 客户端在透传模式下工作 .................................................................................................. 45 3.3.1. 创建 TCP 客户端连接并进入透传模式 ........................................................................... 45 3.3.2. 透传模式下发送数据....................................................................................................... 45 3.3.3. 透传模式接收远程器端数据 ............................................................................................ 45 3.3.4. 断开 TCP 客户端连接 ..................................................................................................... 45 3.4. TCP 客户端在直吐模式下工作 .................................................................................................. 46 3.4.1. 创建 TCP 客户端连接并进入直吐模式 ........................................................................... 46 3.4.2. 直吐模式下发送数据....................................................................................................... 46 3.4.3. 直吐模式下接收远程服务器端数据 ................................................................................. 46 3.4.4. 断开 TCP 用户端连接 ..................................................................................................... 46 3.5. TCP 服务器在缓存模式下工作 .................................................................................................. 47 3.5.1. 启动 TCP 服务器 ............................................................................................................ 47 3.5.2. 接受客户端的连接请求 ................................................................................................... 47 3.5.3. 接收的客户端数据 .......................................................................................................... 47 3.5.4. 断开 TCP 服务器连接 ..................................................................................................... 48 3.6. UDP 服务示例 ........................................................................................................................... 48 3.6.1. 打开 UDP 服务 ............................................................................................................... 48 3.6.2. 向服务器发送 UDP 数据................................................................................................. 48 3.6.3. 接收远程端数据 .............................................................................................................. 48 3.6.4. 关闭 UDP 服务 ............................................................................................................... 49 3.7. PING.......................................................................................................................................... 49 3.8. 获取上一个错误代码示例 .......................................................................................................... 49 4 错误代码 ............................................................................................................................................... 50 5 附录 参考文档及术语缩写 ................................................................................................................... 52 上海移远通信技术股份有限公司 6 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 表格索引 表 1：AT 命令类型 ..................................................................................................................................... 12 表 2：错误代码列表.................................................................................................................................... 50 表 3：参考文档 ........................................................................................................................................... 52 表 4：术语缩写 ........................................................................................................................................... 52 上海移远通信技术股份有限公司 7 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 1 引言 移远通信 RG200U 系列、RG500U 系列和 RM500U 系列模块内置 TCP/IP 协议栈，Host 可以直接通 过 AT 命令访问网络；这大大降低模块对外部 PPP 和 TCP/IP 协议栈的依赖性，从而降低终端设计成本。 RG200U 系列、RG500U 系列和 RM500U 系列可提供 TCP 客户端、UDP 客户端、TCP 服务器、UDP 服务器等 Socket 服务。 本文档主要介绍如何通过 AT 命令使用移远通信 RG200U 系列、RG500U 系列和 RM500U 系列的 TCP/IP 功能。 1.1. TCP/IP AT 命令使用流程 通过 TCP/IP AT 命令，Host 可以配置 PDP 上下文、激活/去激活 PDP 上下文、打开/关闭 Socket 服 务，并通过 Socket 服务发送/接收数据。TCP/IP AT 命令的使用流程如下图所示： 上海移远通信技术股份有限公司 8 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 建议开关机流程： 1.关机：发送AT+QPOWD，等待12秒以 上，直接断电。 2. 开机：先使Power Key按键处于低电平 状态，等待2秒后，再拉高Power Key 查询(U)SIM卡状态： 执行AT+CPIN，若20秒后AT+CPIN?无法 识别(U)SIM卡状态，建议重启模块 PS 业务： 1. 当 AT+C5GREG? 结果中的等于 1 或者5，表示模块已在5GS网络注册上 PS业务 2. 等待60秒后，不管是否注册上PS业务， 都进入下一个流程 配置PDP上下文激活参数： 1. 通过 AT+QICSGP 配置APN、用户 名、密码和鉴权方式 2. 通过 AT+CGQMIN/AT+CGEQMIN/ AT+CGQREQ/AT+CGEQREQ 配置 QoS 给模块上电并开机 发送AT命令并等待响应结果OK 通过AT+CPIN?查询 (U)SIM卡状态 如果在20秒内无法识别 (U)SIM状态，建议重启模块 识别(U)SIM卡 60秒内通过AT+C5GREG?查 询PS业务的状态 如果获取 PS 状态失败，建议 重新配置 PDP 上下文，然后 执行 AT+CFUN=0 和 AT+CFUN=1。 如果仍然获 取失败，建议重启模块。 通过如下AT命令来配置PDP上下文和QoS AT+QICSGP/AT+CGQREQ/ AT+CGEQREQ/AT+CGQMIN/ AT+CGEQMIN 激活PDP上下文： 1. 通过 AT+QIACT= 激活PDP上下文 2. 通过 AT+QIACT? 查询PDP 上下 文IP地址 注意事项： a) 以上命令必须按顺序执行 b) 如果等待150秒后，AT+QIACT 没有响应，建议重启模块. c) 如果连续3次去激活PDP上下文失 败，建议重启模块 3. 去激活PDP Context：如果等待 40秒后AT+QIDEACT没有响应，建 议重启模块 如果等待 40秒没有响 应，建议重启 模块 PDP 上下文 去激活成功 通过 AT+QIACT= 和AT+QIACT激活指定PDP 上下文 1. 如果等待150秒后，没有收到 结果，建议重启模块. 2. 如果连续3次去激活PDP上下 文失败，建议重启模块 PDP上下文激活 失败 PDP上下文激活成功 通过AT+QIDE ACT=去激 活指定的PDP上下文 通过AT+QIOPEN打开 连接 打开连接： 1. 如果等待150秒，没有收到AT+QIOPEN的响应，请关闭 连接。 2.如果连续5次打开连接失败，先去激活PDP上下文，然后 重新激活PDP上下文并再次打开连接。 1. 连续5次打开连接失败 2. 150秒内无响应 +QIOPEN: , 通过AT+QISEND= 发送数据 在收到ACK 90 秒后 TCP连接的维护和检测： 1. 通过 AT+QISEND=[,] 发送数据。 建议定期向远程端发送小数据包以维护和检测TCP连接。 2. 通过 AT+QISEND=,0 查询ACK的发送。 如果在2分钟后（每5秒查询一次，一共查询24次），对方没有收到数据， 说明TCP连接可能出现异常，请执行AT+QICLOSE关闭这个TCP连接，然 后通过AT+QIOPEN重新建立TCP连接。 通过AT+QISEND= ,0查询发送 的数据是否成功被接收 90秒内未收到ACK 通过 AT+QICLOSE OK = 关闭连接 如果等待10秒，无响应，建议重启 模块 注意事项： 1.请注意必须接收到上一个AT命令的执行结果后（例如：'OK'、'CME ERROR'、'CMS ERROR ），才能执行下一个AT命令。一般情况下，如果 在 60秒内未收到AT命令执行结果，建议重启模块。 2.若150秒内未收到AT+QIACT响应，10秒内未收到AT+QICLOSE响应，40秒内未收到AT+QIDEACT响应，建议重启模块。 3.不建议频繁重启模块。如果因为执行AT命令连续3次重启模块失败，此后第一次可立即重启，然后等待10分钟，再进行第二次重启，如果仍重启失 败，建议等待30分钟，再进行第三次重启，以此类推，逐渐增大重启的时间间隔。 图 1：TCP/IP AT 命令使用流程图 上海移远通信技术股份有限公司 9 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 1.2. 数据访问模式说明 RG200U 系列、RG500U 系列和 RM500U 系列支持以下 3 种数据访问模式： ⚫ 缓存模式 ⚫ 直吐模式 ⚫ 透传模式 当使用 AT+QIOPEN 打开 Socket 服务时，可以通过指定 Socket 的数据访问模式； 当 Socket 服务成功打开后，可以通过 AT+QISWTMD 切换数据访问模式。 1) 缓存模式下，可以通过 AT+QISEND 发送数据。从网络接收数据时，模块会缓存所接收的数据，并 直接上报 URC +QIURC: 'recv',，之后用户可以通过 AT+QIRD 读取缓存数据。 2) 直吐模式下，可以通过 AT+QISEND 发送数据。从网络接收数据时，数据会以如下格式直接输出到 COM 口：+QIURC: 'recv',,或+QIURC: 'recv',,,,。 3) 透传模式下，相对应的端口（比如 UART 口、USB Modem 口等）会进入独占模式，通过 COM 口 接收的数据会直接发送到网络端，从网络接收到的数据会从 COM 口直接输出。 ⚫ 退出透传模式 用户可以通过+++或者 DTR（需先设置 AT&D1）两种方式退出透传模式，为了防止+++被当成数据发 送，实际操作时必须遵循以下步骤： 1） +++输入前 1 秒或更长时间内不能输入其它任何数据。 2） 必须在 1 秒内输入+++，并且不能输入其它任何数据。 3） +++输入后 1 秒内不能输入其它任何数据。 4） 通过+++或者 DTR（需先设置 AT&D1）方式使模块退出透传模式，直到模块返回 OK；此时模块成 功退出透传模式。 ⚫ 切换到透传模式 1） 通过执行 AT+QISWTMD：执行此命令时，指定=2；若返回 CONNECT，则表示 成功切换至透传模式； 2） 通过执行 ATO：退出透传模式后，可通过 ATO 再切换回至透传模式；若返回 CONNECT，则表示 成功切换至透传模式。若模块之前未曾进入过透传模式，执行 ATO 则会返回 NO CARRIER。 上海移远通信技术股份有限公司 10 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 备注 1. 在缓存模式下，如果缓存不为空，直到通过 AT+QIRD 读取缓存里面所有接收的数据后，模块才会 上报一个新的 URC。 2. 在透传模式下，不可执行 AT 命令。 若因网络错误或者其他原因导致 Socket 连接断开，模块会上报 NO CARRIER，并退出透传模式，在这种情况下可以执行 AT+QICLOSE 来关闭 Socket 服务。 上海移远通信技术股份有限公司 11 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 2 TCP/IP AT 命令详解 本章节主要描述和 TCP/IP 相关的 AT 命令。 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 12 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令说明 2.3.1. AT+QICFG 配置可选参数 该命令用于配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应： +QICFG: 'transpktsize',(支持的范围) +QICFG: 'transwaittm',(支持的范围) +QICFG: 'dataformat',(支持的列表),(支持的 列表) +QICFG: 'viewmode',(支持的列表) +QICFG: 'tcp/retranscfg',(支持的范围),(支持的< max_rto>范围) +QICFG: 'dns/cache',(支持的列表) +QICFG: 'qisend/timeout',(支持的列表) +QICFG: 'passiveclosed',(支持的列表) +QICFG: 'tcp/accept',(支持的列表) +QICFG: 'tcp/keepalive',(支持的列表),(支持的范围),(支持的范围),(支持的范围) +QICFG: 'recvind',(支持的列表) +QICFG: 'close/mode',(支持的范围) +QICFG: 'sendinfo',(支持的列表) +QICFG: 'formatcfg',(支持的范围) 设置命令 设置待发数据最大长度 AT+QICFG='transpktsize'[,] OK 响应： 若省略可选参数，则查询当前配置： +QICFG: 'transpktsize', OK 若指定可选参数，则设置待发数据最大长度： OK 上海移远通信技术股份有限公司 13 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 设置命令 设置透传模式下，自动发送数据 前的等待时间 AT+QICFG='transwaittm'[,] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'transwaittm', OK 若指定可选参数，则设置透传模式下，自动发送数据前的等待时间： OK 设置命令 设置收发数据格式（仅限非透传 模式） AT+QICFG='dataformat'[,,] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'dataformat',, OK 若指定可选参数，则设置收发数据格式： OK 设置命令 设置已接收数据的输出格式（仅 限非透传模式） AT+QICFG='viewmode'[,] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'viewmode', OK 若指定可选参数，则设置已接收数据的输出格式： OK 若有错误： ERROR 或 上海移远通信技术股份有限公司 14 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 +CME ERROR: 设置命令 设置 TCP 重传的最大次数和间隔 AT+QICFG='tcp/retranscfg'[, ,] 响应： 若省略可选参数，则查询当前配置： +QICFG: 'tcp/retranscfg',, OK 若指定可选参数，则设置 TCP 重传的最大次数和间隔： OK 设置命令 启用或禁用 DNS 缓存 AT+QICFG='dns/cache'[,] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'dns/cache', OK 若指定可选参数，则启用或禁用 DNS 缓存： OK 设置命令 配置输入数据的超时时间 AT+QICFG='qisend/timeout'[, ] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'qisend/timeout', OK 若指定可选参数，则设置输入数据的超时时间： OK 若有错误： ERROR 或 +CME ERROR: 设置命令 响应： 设置启用或禁用 TCP 连接在服务 若省略可选参数，则查询当前配置： 器关闭后被动断开 +QICFG: 'passiveclosed', 上海移远通信技术股份有限公司 15 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 AT+QICFG='passiveclosed'[, ] OK 若指定可选参数，则设置启用或禁用 TCP 连接在服务器关闭后被动断 开： OK 设置命令 启用或禁用自动接受来自客户端 的 TCP 连接 AT+QICFG='tcp/accept'[,] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'tcp/accept', OK 指定可选参数，则设置启用或禁用自动接受来自客户端的 TCP 连接： OK 设置命令 设置是否发送 TCP 保活信息 AT+QICFG='tcp/keepalive'[,< enable>[,,,]] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'tcp/keepalive',,,, OK 指定可选参数，则设置是否发送 TCP 保活信息： OK 设置命令 设置在缓存模式下，模块接收到 数据后上报的 URC 是否显示数 据长度 AT+QICFG='recvind'[,] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'recvind', OK 上海移远通信技术股份有限公司 16 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 指定可选参数，则设置接收到数据后上报的 URC 是否显示数据长度： OK 设置命令 设置启用或禁用以 URC 格式返 回 AT+QICLOSE 的响应信息 AT+QICFG='close/mode'[,] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'close/mode', OK 指定可选参数，则设置启用或禁用以 URC 格式返回 AT+QICLOSE 的 响应信息： OK 设置命令 设置启用或禁用以 URC 格式返 回 AT+QISEND 的响应信息（仅 当='TCP'、'UD P'或者'TCP INCOMING'） AT+QICFG='sendinfo'[,] 若有错误： ERROR 或 +CME ERROR: 响应： 若省略可选参数，则查询当前配置： +QICFG: 'sendinfo', OK 指定可选参数，则设置启用或禁用以 URC 格式返回 AT+QISEND 的响 应信息： OK 若有错误： ERROR 或 +CME ERROR: 设置命令 响应： 设置执行 AT+QISEND 后的响应 若省略可选参数，则查询当前配置： 信息格式 +QICFG: 'formatcfg', AT+QICFG='formatcfg'[,] OK 指定可选参数，则设置执行 AT+QISEND 后的响应信息格式： OK 上海移远通信技术股份有限公司 17 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 最大响应时间 特性说明 若有错误： ERROR 或 +CME ERROR: - 该命令立即生效； 参数配置不保存。 参数 整型。透传模式下，待发数据包最大长度。范围：1~1460；默认值：1024；单 位：字节。 整型。透传模式下，待发数据小于时，自动发送数据前的等待时 间。范围：0~20；默认值：2；单位：100 毫秒。 整型。发送数据格式。当设置为十六进制模式时，不需要带 0x 前缀，模块会自 动将两个字节拼成一个 ASCII 码。 0 文本模式 1 十六进制模式 整型。接收数据格式。当设置为十六进制模式时，不需要带 0x 前缀，模块会自 动将两个字节拼成一个 ASCII 码。 0 文本模式 1 十六进制模式 整型。非透传模式下接收数据的输出格式。 0 data headerrndata. 1 data header,data. 整型。TCP 重传最大次数。范围：3~20；默认值：8。 整型。TCP 重传最大间隔。范围：5~1000；默认值：600；单位：100 毫秒。 整型。启用或禁用 DNS 缓存。 0 启用 1 禁用 整型。AT+QISEND 的超时时间。响应>后，若在指定超时时间段内无数据输入， AT+QISEND 退出。范围：0~3600；默认值：0；单位：毫秒。 整型。启用或禁用 TCP 连接在服务器关闭后被动断开。 0 禁用 1 启用 整型。启用或禁用自动接受来自客户端的 TCP 连接。 0 禁用 1 启用 整型。AT+QICFG='tcp/keepalive'中该参数表示是否发送 TCP 保活信息。 AT+QICFG='recvind'中该参数配置在缓存模式下，模块接收到数据后上报的 URC 是否显示数据长度。 0 不发送/不显示 1 发送/显示 上海移远通信技术股份有限公司 18 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 整型。触发的保活循环时间。范围：1~1800；默认值：60；单位：秒。 整型。在循环时间内发送数据包间隔时间。范围：25~100；默认值：25； 单位：秒。 整型。在循环时间内发送数据包的次数。范围：3~10；默认值：3。 整型。启用或禁用以 URC 格式上报 AT+QICLOSE 响应信息。 0 禁用 1 启用 整型。启用或禁用以 URC 格式上报 AT+QISEND 响应信息。 0 禁用 1 启用 整型。执行 AT+QISEND 后的响应信息格式。其中 S3 和 S4 分别为 ATS3 和 ATS4。 0 'S3S4>' 1 'S3S4>S3S4' 整型。错误码。详情请参考第 4 章。 备注 AT+QICFG='tcp/retranscfg'[,,]的配置对所有 TCP Socket 连接有效。参 数配置不保存至 NV。 2.3.2. AT+QICSGP 配置 TCP/IP 上下文参数 该命令用于配置、和以及其他 TCP/IP 上下文参数。QoS 配置需通 过 AT+CGQMIN、AT+CGEQMIN、AT+CGQREQ 与 AT+CGEQREQ。有关所述 AT 命令的详情，请参考 文档 [1]。 AT+QICSGP 配置 TCP/IP 上下文参数 测试命令 AT+QICSGP=? 响应： +QICSGP: (支持的范围),(支持的范围),,,,(支持的范围) OK 设置命令 配置指定上下文 响应： 若省略可选参数，则查询指定上下文配置： AT+QICSGP=[,,[,,,]] +QICSGP: ,,,, OK 若指定可选参数，则配置指定上下文： OK 上海移远通信技术股份有限公司 19 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 最大响应时间 特性说明 若有错误： ERROR 或者 +CME ERROR: - 该命令立即生效； 参数配置不保存。 参数 整型。PDP 上下文 ID。范围：1~5。 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型。接入点名称。 字符串类型。用户名。最大长度：127；单位：字节。 字符串类型。密码。最大长度：127；单位：字节。 整型。APN 鉴权方式。 0 None 1 PAP 2 CHAP 3 PAP 或 CHAP 整型。错误码。详情请参考第 4 章。 举例 AT+QICSGP=1 +QICSGP: 1,'','','',0 OK AT+QICSGP=1,1,'UNINET','','',0 OK //查询上下文 1 配置。 //配置上下文 1，APN 配置为'UNINET'（中国联通）。 2.3.3. AT+QIACT 激活 PDP 上下文 使用 AT+QIACT 激活 PDP 上下文前，需要使用 AT+QICSGP 配置上下文。上下文激活后，可以通过 AT+QIACT?查询 IP 地址。 的范围为 1~5，模块最多仅可同时激活 5 路 PDP 上下文。受网络状态影响，执行 AT+QIACT 后，等待返回结果 OK 或者 ERROR 的最大时间为 150 秒。在结果尚未返回之前，无法执行任何 AT 命令。 上海移远通信技术股份有限公司 20 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 AT+QIACT 激活 PDP 上下文 测试命令 AT+QIACT=? 响应： +QIACT: (支持的范围) 查询命令 AT+QIACT? OK 响应： 返回当前所有已激活的 PDP 上下文及相应的 IP 地址列表 若=1 +QIACT: 1,,1, [... +QIACT: 5,,1,] OK 或者=2 +QIACT: 1,,2, [... +QIACT: 5,,2,] OK 或者=3 +QIACT: 1,,3,, [... +QIACT: 5,,3,,] 设置命令 激活指定 PDP 上下文 AT+QIACT= 最大响应时间 特性说明 OK 响应： OK 若有错误： ERROR 或者 +CME ERROR: 受网络状态影响，最大响应时间 150 秒 - 上海移远通信技术股份有限公司 21 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 参数 整型。PDP 上下文 ID。范围：1~5。 整型。PDP 上下文状态。 0 去激活 1 激活 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型。上下文激活后的本地 IPv4 地址。 字符串类型。上下文激活后的本地 IPv6 地址。 整型。错误码。详情请参考第 4 章。 2.3.4. AT+QIDEACT 去激活 PDP 上下文 该命令用于去激活特定上下文，断开在此上下文内建立的所有 TCP/IP 连接。受网络状态影响，执行 AT+QIDEACT 后，等待返回结果 OK 或者 ERROR 的最大时间为 40 秒。在结果尚未返回之前，无法执行 任何 AT 命令。 AT+QIDEACT 去激活 PDP 上下文 测试命令 AT+QIDEACT=? 响应： +QIDEACT: (支持的范围) 设置命令 AT+QIDEACT= OK 响应： OK 最大响应时间 特性说明 若有错误： ERROR 或者 +CME ERROR: 受网络状态影响，最大响应时间 40 秒 - 参数 整型。PDP 上下文 ID。范围：1~5。 整型。错误码。详情请参考第 4 章。 上海移远通信技术股份有限公司 22 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 2.3.5. AT+QIACTEX 异步激活 PDP 上下文 该命令用于异步激活指定 PDP 上下文。执行该命令激活指定 PDP 上下文之前，需通过 AT+QICSGP 配置该上下文。上下文激活后，可通过 AT+QIACTEX?查询 IP 地址。 的范围为 1~5，模块支持同时激活 5 路 PDP 上下文。实际支持同时激活的 PDP 上下文数 由(U)SIM 卡决定。执行 AT+QIACTEX 设置命令后，模块响应 OK 或 ERROR，随后并通过 URC +QIACTEX 上报 PDP 上下文激活结果。 AT+QIACTEX 异步激活 PDP 上下文 测试命令 AT+QIACTEX=? 响应： +QIACTEX: (支持的范围),(支持的列表) 查询命令 AT+QIACTEX? OK 响应： 返回当前所有已激活的 PDP 上下文及相应的 IP 地址列表： 若=1 +QIACTEX: 1,,1, [... +QIACTEX: 5,,1,] 或者=2 +QIACTEX: 1,,2, [... +QIACTEX: 5,,2,] 或者=3 +QIACTEX: 1,,3,, [... +QIACTEX: 5,,3,,] OK 设置命令 AT+QIACTEX=[,] 响应： 若=0： OK +QIACTEX: , 若=1： OK 上海移远通信技术股份有限公司 23 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 最大响应时间 特性说明 +QIACTEX: ,[,1,] 或 +QIACTEX: ,[,2,] 或 +QIACTEX: ,[,3,,] 若有错误： ERROR 或 +CME ERROR: 受网络状态影响，最大响应时间 150 秒 - 参数 整型。PDP 上下文 ID。范围：1~5。 整型。是否显示 IP 地址和 IP 类型。 0 不显示 1 显示 整型。PDP 上下文状态。 0 被去激活 1 被激活 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型。上下文激活后的本地 IPv4 地址。 字符串类型。上下文激活后的本地 IPv6 地址。 整型。错误码。详情请参考第 4 章。 2.3.6. AT+QIDEACTEX 异步去激活 PDP 上下文 该命令用于异步去激活 PDP 上下文。执行 AT+QIDEACTEX 设置命令后，模块响应 OK 或 ERROR， 随后并通过 URC +QIDEACTEX 上报 PDP 上下文去激活结果。 AT+QIDEACTEX 异步去激活 PDP 上下文 测试命令 AT+QIDEACTEX=? 响应： +QIDEACTEX: (支持的范围) 上海移远通信技术股份有限公司 24 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 设置命令 AT+QIDEACTEX= 最大响应时间 特性说明 OK 响应： OK +QIDEACTEX: , 若有错误： ERROR 或 +CME ERROR: 受网络状态影响，最大响应时间 40 秒 - 参数 整型。PDP 上下文 ID。范围：1~5。 整型。错误码。详情请参考第 4 章。 2.3.7. AT+QIOPEN 打开 Socket 服务 该命令用于打开 Socket 服务。服务类型由指定，数据访问模式（缓存模式、直吐模式、 透传模式）可通过配置。URC +QIOPEN 用于指示 Socket 服务是否成功打开。 1. 如果='TCP LISTENER'，那么模块作为 TCP 服务器使用。接受一个新的 TCP 连接后，模块会自动指定一个并上报 URC +QIURC: 'incoming',,,,；其中范围为 0~11。新连接的类型为'TCP INCOMING'，则和'TCP LISTENER'的取值相同。 2. 如果='UDP SERVICE'，则可通过向远程服务器 IP 收发 UDP 数据。 ⚫ 发送数据：执行 AT+QISEND=,,,。 ⚫ 在直吐模式下接收数据：模块会上报 URC +QIURC: 'recv',,,,。 ⚫ 在缓存模式下接收数据：模块会上报 URC +QIURC: 'recv',，然后用户可通过 AT+QIRD=读取数据。 等待+QIOPEN: ,输出，建议等待 150 秒；如果 150 秒内未接收到该 URC，则需通 过 AT+QICLOSE 来关闭 Socket。 上海移远通信技术股份有限公司 25 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 AT+QIOPEN 打开 Socket 服务 测试命令 AT+QIOPEN=? 响应： +QIOPEN: (支持的范围),(支持的 范围),(支持的列表),,(支持 的范围),(支持的范围),(支持的范围),(支持的范围), (支持的范围) OK 设置命令 AT+QIOPEN=,,,<address_strin 响应： 如果数据访问模式是透传模式（=2），且 Socket 服务成功打开： g>,[,[,[,[,]]]] CONNECT 若有错误： ERROR 可通过 AT+QIGETERROR 查询错误描述。 如果数据访问模式是缓存模式（=0）或者直 吐模式（=1）： OK 最大响应时间 特性说明 +QIOPEN: , 为 0 表示 Socket 服务成功打开，其他情况下不为 0。 受网络状态影响，最大响应时间 150 秒 - 参数 整型。PDP 上下文 ID。范围：1~5。 整型。Socket ID。范围：0~11。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'UDP SERVICE' 建立 UDP 服务 字符串类型。远程服务器的 IP 地址或域名。该参数可设置为 或。 字符串类型。 若 ='TCP' 或 'UDP' ， 则 指 远 程 服 务 上海移远通信技术股份有限公司 26 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 器的 IP 地址，例如：'220.180.239.212'。 ='TCP LISTENER'或'UDP SERVICE'，输入'127.0.0.1'。 符串类型。远程服务器的域名地址。最大长度：256； 单位：字节。 整型。远程服务器端口。范围：0~65535。 若='TCP'或'UDP'，需指定端口。 若='TCP LISTENER'或'UDP SERVICE'，设置为 0。 整型。本地端口。范围：0~65535。 若='TCP'或'UDP'，设置为 0 时，本地端口自动分配；设置 为其他值，则为指定端口号。 若='TCP LISTENER'或'UDP SERVICE'，需指定端口号。 整型。Socket 服务的数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 整型。仅当='TCP LISTENER'时有效，可以控制客户端连 接的最大数量。范围：0~11；默认值：11。 整型。重新连接的超时时间。范围：10~150；默认值：0；单位：秒。默认 不开启重连。 整型。错误码。详情请参考第 4 章。 备注 1. 等待输出 URC +QIOPEN: ,时，建议等待 150 秒。 2. 若连接失败，需执行 AT+QICLOSE=关闭 Socket 服务。 3. 若模块做服务器，则需要通过执行 AT+QCFG='nat',1 或 AT+QCFG='nat',2 将网卡拨号模式配置 为路由模式或者网桥模式。有关 AT 命令详情，请参考文档 [1]。 2.3.8. AT+QICLOSE 关闭 Socket 服务 该命令用于关闭特定的 Socket 服务。受网络状态影响，执行 AT+QICLOSE 后，等待返回结果 OK 或 者 ERROR 的最大响应时间为 10 秒（此为默认值，可以通过来修改）。在结果尚未返回之前， 不允许执行任何 AT 命令。 AT+QICLOSE 关闭 Socket 服务 测试命令 AT+QICLOSE=? 响应： +QICLOSE: (支持的范围),(支持的范 围) OK 设置命令 响应 AT+QICLOSE=[,<timeou 若=0（AT+QICFG='close/mode'）： 上海移远通信技术股份有限公司 27 / 53 t>] 最大响应时间 特性说明 RGx00U&RM500U 系列 TCP/IP 应用指导 关闭成功： OK 关闭失败： ERROR 若=1（AT+QICFG='close/mode'）： 关闭成功： OK +QIURC: 'closed', 关闭失败： ERROR 或 +CME ERROR: 默认 10 秒，取决于取值 - 参数 整型。Socket ID。范围：0~11。 整型。输出响应结果的超时时间。若未在时间范围内接收到其他客户端的 FI N ACK，模块会强制关闭 Socket。范围：0~65535；默认值：10；单位：秒。 整型。错误码。详情请参考第 4 章。 2.3.9. AT+QISTATE 查询 Socket 服务状态 该命令用于查询 Socket 服务状态。若=0，该命令返回指定上下文中所有现存 Socket 服务的状态；若=1，则返回指定 Socket 服务的状态。 AT+QISTATE 查询 Socket 服务状态 测试命令 AT+QISTATE=? 响应： +QISTATE: (支持的列表),(支持的范围),(支持的范围) 查询命令/执行命令 AT+QISTATE? 或 AT+QISTATE OK 响应： 返回现存所有 Socket 服务状态： +QISTATE: ,,,< remote_port>,,,,< serverID>,, 上海移远通信技术股份有限公司 28 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 […] 设置命令 若=0，查询指定上下文中 所有 Socket 服务的状态 AT+QISTATE=, OK 响应： 返回指定上下文中所有现存 Socket 服务的状态 +QISTATE: ,,,< remote_port>,,,,< serverID>,, […] OK 若有错误： ERROR 或 设置命令 +CME ERROR: 响应： 若=1，查询指定 Socket 服务的状态 返回指定 Socket 服务的状态： +QISTATE: ,,,< AT+QISTATE=,,,,,< tID> serverID>,, OK 最大响应时间 特性说明 若有错误： ERROR 或 +CME ERROR: 300 毫秒 - 参数 整型。查询类型。 0 查询指定上下文中所有 Socket 服务的连接状态 1 查询指定 Socket 服务的连接状态 整型。上下文 ID。范围：1~5。 整型。Socket ID。范围：0~11。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 上海移远通信技术股份有限公司 29 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 'TCP INCOMING' 建立 TCP 服务器接受的 TCP 连接 'UDP SERVICE' 建立 UDP 服务 字符串类型。IP 地址。 若='TCP'或'UDP'，则指远程服务器 IP 地址 若='TCP LISTENER'或'UDP SERVICE'，则指本地 IP 地址 若='TCP INCOMING'，则指远程客户端 IP 地址 整型。远程端口号。范围：1~65535。 若='TCP'或'UDP'，则指远程服务器端口 若='TCP LISTENER'或'UDP SERVICE'，则为 0， 端口无效 若='TCP INCOMING'，则指远程客户端端口 整型。本地端口号。范围：0~65535。 若为 0，本地端口自动分配。 整型。Socket 服务状态。 0 'Initial'：尚未建立连接 1 'Opening'：客户端正在连接或者服务器正尝试监听 2 'Connected'：客户端连接已建立 3 'Listening'：服务器正在监听 4 'Closing'：连接断开 整型。仅当='TCP INCOMING'时才有效。代表哪个服务 器接受了这个 TCP 连接，这个参数值和该服务器'TCP LISTENER'的 值一致。 整型。数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 字符串类型。Socket 服务的 COM 口。 'usbmodem' USB modem port 'usbat' USB AT port 'uart1' UART port 1 整型。错误码。详情请参考第 4 章。 2.3.10. AT+QISEND 发送数据 该命令用于通过指定连接发送字符串格式的 Socket 数据。若特定 Socket 服务的数据访问模式是缓存 模式（=0）或者直吐模式（=1），可通过 AT+QISEND 发送数据。若数 据发送成功，则返回 SEND OK，否则返回 SEND FAIL 或 ERROR。 ⚫ SEND FAIL 表示发送缓存已满，可以尝试重新发送数据。 ⚫ ERROR 表示在发送数据过程中遇到错误，请延迟一段时间后再次发送数据，发送数据的最大长度 为 1460 字节。 ⚫ SEND OK 并不表示服务器已成功接收所有数据，可通过 AT+QISEND=,0 查询数据 收发详情。 上海移远通信技术股份有限公司 30 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 AT+QISEND 发送数据 测试命令 AT+QISEND=? 响应： +QISEND: (支持的范围),(支持的范围),,(支持的范围) 设置命令 若='TCP'、'UDP'或者' TCP INCOMING'，发送不定长数据 AT+QISEND= OK 响应： > 响应>后，输入需要发送的数据；按 Ctrl + Z 发送数据，按 Esc 取消发送。 若=0（AT+QICFG='sendinfo'）： 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若有错误： ERROR 或 +CME ERROR: 若=1（AT+QICFG='sendinfo'）： 若连接已经建立，且发送成功： +QISEND: ,, OK 设置命令 若='TCP'、'UDP'或'TC P INCOMING'，发送定长数据 AT+QISEND=, 若有错误： ERROR 或 +CME ERROR: 响应： > 响应>后，输入长度等于的数据。 若=0（AT+QICFG='sendinfo'）： 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 上海移远通信技术股份有限公司 31 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 若有错误： ERROR 或 +CME ERROR: 若=1（AT+QICFG='sendinfo'）： 若连接已经建立，且发送成功： +QISEND: ,, OK 设置命令 若='UDP SERVICE' AT+QISEND=,,, 若有错误： ERROR 或 +CME ERROR: 响应： 该命令可用来发送固定字节长度数据到特定的远程 IP 地址和 远程端口，必须是'UDP SERVICE'。 > 响应>后，输入长度等于的数据。 若连接已经建立且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 设置命令 当=0，查询发送的数据 AT+QISEND=,0 若有错误： ERROR 或 +CME ERROR: 响应： 若指定连接存在： +QISEND: ,, OK 若有错误： ERROR 或 +CME ERROR: 上海移远通信技术股份有限公司 32 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 最大响应时间 - 特性说明 - 参数 整型。Socket ID。范围：0~11。 整型。发送数据字节长度。范围：0~1460；单位：字节。 字符串类型。远程 IP 地址（必须是点分十进制格式）。仅当='UDP SERVICE'时有效。 整型。远程端口。范围：1~65535。仅当='UDP SERVICE'时 有效。 整型。启用或禁用以 URC 格式上报 AT+QISEND 响应信息。 0 禁用 1 启用 整型。发送数据总长度。单位：字节。 整型。收到数据总长度。单位：字节。 整型。未收到数据总长度。单位：字节。 整型。 0 数据发送至 Socket 缓存成功 1 接收缓存已满，发送失败 整型。当前缓存区剩余空间。范围：0~10240；单位：字节。 整型。错误码。详情请参考第 4 章。 2.3.11. AT+QIRD 读取收到的 TCP/IP 数据 在缓存模式下，模块收到数据后会先缓存数据并上报+QIURC: 'recv',，之后可通过 AT+QIRD 读取缓存数据。 缓存中仍有数据时，模块若再次接收到数据，将不会再上报 URC；直到缓存中所有数据均被读取，才 会上报新的 URC。 AT+QIRD 读取收到的 TCP/IP 数据 测试命令 AT+QIRD=? 响应： +QIRD: (支持的范围),(支持的范围) OK 设置命令 响应： 当='TCP'、'UDP'或' 若指定连接收到数据： TCP INCOMING' +QIRD: AT+QIRD=[,] OK 上海移远通信技术股份有限公司 33 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 若无数据： +QIRD: 0 OK 若有错误： ERROR 或 +CME ERROR: 设置命令 响应： 当='UDP SERVICE 若数据存在： ' AT+QIRD= +QIRD: ,,< CR> OK 若无数据： +QIRD: 0 OK 若有错误： ERROR 或 +CME ERROR: 设置命令 响应： 当=0，查询读取的数 若指定连接存在： 据 +QIRD: ,,<unrea AT+QIRD=,0 d_length> OK 最大响应时间 特性说明 若有错误： ERROR 或 +CME ERROR: - - 上海移远通信技术股份有限公司 34 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 参数 整型。Socket ID。范围：0~11。 整型。待读取数据的最大长度。范围：0~1500；单位：字节。 整型。实际读取数据的长度。单位：字节。 字符串类型。远程 IP 地址。仅当='UDP SERVICE'时有效。 整型。远程端口。范围：1~65535。仅当='UDP SERVICE' 有效。 读取的数据。 整型。已接收数据的总长度。单位：字节。 整型。已读取数据的长度。单位：字节。 整型。未读取数据的长度。单位：字节。 整型。错误码。详情请参考第 4 章。 2.3.12. AT+QISWTMD 切换数据访问模式 该命令用于切换数据访问模式：缓存模式、直吐模式和透传模式。建立 Socket 服务时，可以通过 AT+QIOPEN 的来指定数据访问模式。Socket 服务打开以后，可以通过 AT+QISWTMD 来切换模式。 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应： +QISWTMD: (支持的范围),(支持的范围) OK 设置命令 AT+QISWTMD=, 响应： 若=0 或 1 且数据访问模式切换成功： OK 若=2 且数据访问模式切换成功，模块会进入 透传模式： CONNECT 最大响应时间 特性说明 若有错误： ERROR 或 +CME ERROR: - 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 35 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 参数 整型。Socket ID。范围：0~11。 整型。数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 整型。错误码。详情请参考第 4 章。 2.3.13. AT+QPING 进行远程服务器 Ping 操作 该命令用于检测 Host 网络协议可达性。在执行 Ping 操作命令前，Host 应首先通过 AT+QIACT 激活 对应的上下文，在期间内返回结果，默认值是 4 秒。 AT+QPING 进行远程服务器 Ping 操作 测试命令 AT+QPING=? 响应： +QPING: (支持的范围),,(支持的范围),(支持的范围),(支持的范围) OK 设置命令 AT+QPING=,[,[,[,]]] 响应： 若远程服务器 Ping 操作成功： OK +QPING: [,,,,] […] +QPING: [,,,,,,] 最大响应时间 特性说明 若有错误： ERROR 或 +CME ERROR: - 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 36 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 参数 整型。PDP 上下文 ID。范围：1~5。 字符串类型。Host 地址。格式为域名或点分十进制 IP 地址。 整型。设置每个 Ping 请求响应的最大等待时间。范围：1~255；默认值：4；单位：秒。 整型。Ping 请求的最大次数。范围：1~10；默认值：4。 整型。设置每个 Ping 请求的最大字节长度。范围：32~1500；默认值：32；单位：字 节。 整型。每个 Ping 请求结果。 0 从服务器接收到 Ping 响应，详情以,,,体现。 其他值 错误码，请参考第 4 章。 字符串类型。远程服务器 IP 地址。格式为点分十进制。 整型。实际发送的 Ping 请求字节长度。单位：字节。 整型。发送 Ping 请求后等待响应时间。单位：毫秒。 整型。Ping 请求回应数据包 TTL 值。 整型。该命令执行后最终结果。 0 正常结束，成功激活上下文并找到 Host，结果详情以,,, ,,体现 其他值 错误码，请参考第 4 章。 整型。Ping 请求的发送次数。 整型。得到响应的 Ping 请求个数。 整型。超时的 Ping 请求个数。 整型。最小响应时间。单位：毫秒。 整型。最大响应时间。单位：毫秒。 整型。平均响应时间。单位：毫秒。 整型。错误码。详情请参考第 4 章。 2.3.14. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置 DNS 服务器地址。在配置 DNS 地址之前，Host 需通过 AT+QIACT 来激活 对应的上下文。 AT+QIDNSCFG 配置 DNS 服务器地址 测试命令 AT+QIDNSCFG=? 响应： +QIDNSCFG: (支持的范围),, 设置命令 AT+QIDNSCFG=[,[,]] OK 响应： 若省略可选参数，则查询指定 PDP 上下文的当前 DNS 服务器地址： +QIDNSCFG: ,, 上海移远通信技术股份有限公司 37 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 最大响应时间 特性说明 OK 若指定任意可选参数，则设置指定 PDP 上下文的主要 DNS 服务器 地址和次要 DNS 服务器地址： OK 若有错误： ERROR 或 +CME ERROR: 该命令立即生效； 参数配置不保存。 参数 整型。PDP 上下文 ID。范围：1~5。 字符串类型。主要 DNS 服务器地址。 字符串类型。次要 DNS 服务器地址。 整型。错误码。详情请参考第 4 章。 备注 1. IPv4 网络中，仅支持设置 IPv4 DNS 地址。 2. IPv6 网络中，仅支持设置 IPv6 DNS 地址。 2.3.15. AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 该命令用于控制是否回显 AT+QISEND 要发送的数据，即是否回显输入的待发送数据。 AT+QISDE 控制是否回显 AT+QISEND 要发送的数据 测试命令 AT+QISDE=? 响应： +QISDE: (支持的列表) 查询命令 AT+QISDE? OK 响应： +QISDE: 设置命令 AT+QISDE= OK 响应： OK 上海移远通信技术股份有限公司 38 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 最大响应时间 特性说明 若有错误： ERROR 或 +CME ERROR: - 该命令立即生效； 参数配置不保存。 参数 整型。是否回显 AT+QISEND 要发送的数据。 0 不回显 1 回显 整型。错误码。详情请参考第 4 章。 2.3.16. AT+QIGETERROR 查询上一个 AT 命令错误代码 若 执 行 TCP/IP 命 令 后 返 回 ERROR ， 错 误 详 情 可 通 过 AT+QIGETERROR 查 询 。 需 注 意 AT+QIGETERROR 只返回上一个 TCP/IP AT 命令错误代码。 AT+QIGETERROR 查询上一个 AT 命令错误代码 测试命令 AT+QIGETERROR=? 执行命令 AT+QIGETERROR 响应： OK 响应： +QIGETERROR: , OK 最大响应时间 - 特性说明 - 参数 整型。错误码。详情请参考第 4 章。 字符串类型。详细错误信息，详情请参考第 4 章。 上海移远通信技术股份有限公司 39 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 2.4. URC 说明 TCP/IP AT 命令的 URC 统一以+QIURC: 形式上报 Host，涉及数据接收、连接断开和接入等。实际在 URC 的前后均有，本文档中均不体现。 2.4.1. +QIURC: 'closed' 连接断开通知 当 TCP Socket 服务连接被远程客户端断开或者因为网络异常导致断开，模块将上报该 URC，同时该 Socket 将处于'Closing'状态（=4），调用 AT+QICLOSE=后 Socket 服务可 恢复成'Initial'状态。 +QIURC: 'closed' 连接断开通知 +QIURC: 'closed', Socket 服务连接被断开 参数 整型。Socket ID。范围：0~11。 2.4.2. +QIURC: 'recv' 数据接收通知 在缓存模式或者直吐模式下，模块接收到数据后会上报 URC 通知 Host。 ⚫ 缓存模式下：URC 格式为+QIURC: 'recv',。URC 上报后，Host 可通过 AT+QIRD 读取缓存数据。当缓存不为空而模块再次接收数据时，只有当 Host 通过 AT+QIRD 读取所有缓存 数据后，模块才会上报新的 URC。 ⚫ 直吐模式下：接收的数据会直接从 COM 端输出。 +QIURC: 'recv' 数据接收通知 +QIURC: 'recv', 在缓存模式下，模块接收到数据会上报该 URC，Host 可通过 AT+QIRD 获取数据。 +QIURC: 'recv',,<curre 在 直 吐 模 式 下 ， 当 ='TCP' 、 'UDP' 或 'TCP nt_recvlength> INCOMING'时，模块接收到数据会上报该 URC。 +QIURC: 'recv',,,, 在直吐模式下，当='UDP SERVICE'时，模块 接收到数据会上报该 URC。 上海移远通信技术股份有限公司 40 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 参数 整型。Socket ID。范围：0~11。 整型。实际接收数据的长度。 字符串类型。远程 IP 地址（必须是点分十进制格式）。 整型。远程端口。范围：1~65535。 接收的数据。 2.4.3. +QIURC: 'incoming full' 客户端连接已满通知 如果客户端连接已达限额，或者已经没有 Socket 系统资源可供分配，有新的客户端连接请求时模块会 上报 URC：+QIURC: 'incoming full'。 +QIURC: 'incoming full' 客户端连接已满通知 +QIURC: 'incoming full' 客户端连接请求已满 2.4.4. +QIURC: 'incoming' 客户端连接通知 如果='TCP LISTENER'，当一个远程客户端连接到这个服务器时，Host 会给新连接 自动分配一个空闲的，其中范围是 0~11。此时模块会上报该 URC。新连接的 是'TCP INCOMING'，是缓存模式。 +QIURC: 'incoming' 客户端连接通知 +QIURC: 'incoming',,< serverID>,, 接受了一个新的连接请求时，分配给新连接的以及新连接的和将通过 该 URC 上报。 参数 整型。模块自动为客户端连接指定的 Socket ID。范围：0~11。 整型。接受客户端连接的服务器。服务器的是'TCP LISTENER'，监听 Socket ID 是。 字符串类型。客户端连接的远程 IP 地址。范围：1~65535。 整型。客户端连接的远程端口。范围：1~65535。 上海移远通信技术股份有限公司 41 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 2.4.5. +QIURC: 'pdpdeact' PDP 去激活通知 PDP 可以被网络去激活。PDP 被去激活以后，模块会上报该 URC 通知 Host，Host 需执行 AT+QIDEACT 去激活上下文并重置所有连接。 +QIURC: 'pdpdeact' PDP 去激活通知 +QIURC: 'pdpdeact', 对应的上下文被去激活 参数 整型。PDP 上下文 ID。范围：1~5。 上海移远通信技术股份有限公司 42 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 3 示例 3.1. 上下文配置和激活 3.1.1. 上下文配置 AT+QICSGP=1,1,'UNINET','','',0 OK //配置上下文 1，APN 配置为'UNINET'（中国联通）。 3.1.2. 上下文激活 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK //激活上下文 1，取决于网络状态，最大响应时间为 150 秒。 //上下文激活成功。 //查询上下文状态。 3.1.3. 上下文去激活 AT+QIDEACT=1 OK //去激活上下文 1。 //上下文去激活成功，取决于网络状态，最大响应时间为 40 秒。 3.2. TCP 客户端在缓存模式下工作 3.2.1. 创建 TCP 客户端连接并进入缓存模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,0 OK // 上 下 文 是 1 ， 为 0 。 执 行 AT+QIOPEN 之前，Host 需要使用 AT+QIACT 激活上下文。 +QIOPEN: 0,0 //TCP 客户端连接成功，等待 URC 响应建议 上海移远通信技术股份有限公司 43 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 等待 150 秒。若 150 秒内未收到 URC 响 应，Host 可以使用 AT+QICLOSE 断开 Socket。 AT+QISTATE=1,0 //检查连接状态是否为 0。 +QISTATE: 0,'TCP','220.180.239.212',8009,65514,2,1,0,0,'usbmodem' OK 3.2.2. 缓存模式下发送数据 AT+QISEND=0 >test1 SEND OK AT+QISEND=0,4 >test SEND OK AT+QISEND=0,0 +QISEND: 9,9,0 OK //发送可变长度数据。 //SEND OK 不能代表数据已经成功发送到服务器。Host 可以通 过 AT+QISEND=0,0 来查询数据是否到达服务器。 //发送固定长度数据，字节长度为 4 字节。 //查询发送数据长度。 3.2.3. 缓存模式下从远程服务器接收数据 +QIURC: 'recv',0 AT+QIRD=0,1500 +QIRD: 5 test1 //为 0 接收的数据。 //读取数据，字节长度为 1500 字节。 //实际接收数据长度为 5 字节。 OK AT+QICFG='recvind',1 OK +QIURC: 'recv',0,5 AT+QIRD=0,1500 +QIRD: 5 test1 //为 0 接收到 5 字节的数据 //读取数据，字节长度为 1500 字节。 //实际接收数据长度为 5 字节。 OK AT+QIRD=0,1500 +QIRD: 0 //缓存无数据。 OK AT+QIRD=0,0 //查询接收数据的总长度，包括已读和未读数据。 上海移远通信技术股份有限公司 44 / 53 +QIRD: 10,10,0 OK 3.2.4. 断开连接 AT+QICLOSE=0 OK RGx00U&RM500U 系列 TCP/IP 应用指导 //断开为 0 的连接。受网络状态影响，最大响应时间是 10 秒。 3.3. TCP 客户端在透传模式下工作 3.3.1. 创建 TCP 客户端连接并进入透传模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,2 //上下文为 1，为 0。执行 AT+QIOPEN 之前，Host 需使用 AT+QIACT 来激活上下文。 CONNECT //连接成功，等待 URC 响应结果 CONNECT 建议 等待 150 秒。若 150 秒内 URC 无响应，Host 可 通过 AT+QICLOSE 断开 Socket 连接。 3.3.2. 透传模式下发送数据 3.3.3. 透传模式接收远程器端数据 Test 1 //所有从网络接收的数据都会通过 COM 端口直接输出。 3.3.4. 断开 TCP 客户端连接 AT+QICLOSE=0 OK //使用+++退出透传模式后，Host 可以通过 AT+QICLOSE 断开 TCP 连接。受 网络状态影响，最大响应时间是 10 秒。 上海移远通信技术股份有限公司 45 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 3.4. TCP 客户端在直吐模式下工作 3.4.1. 创建 TCP 客户端连接并进入直吐模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,1 //上下文为 1，为 0。执行 AT+QIOPEN 之前，Host 需使用 AT+QIACT 来激活上下文。 OK +QIOPEN: 0,0 //连接成功，等待 URC 响应建议等待 150 秒，若 150 秒内未响应，Host 可通过 AT+QICLOSE 断开 Socket。 AT+QISTATE=1,0 //查询的连接状态是否为 0。 +QISTATE: 0,'TCP','220.180.239.212',8009,65344,2,1,0,1,'usbmodem' OK 3.4.2. 直吐模式下发送数据 AT+QISEND=0 >test1 SEND OK AT+QISEND=0,5 >test2 SEND OK AT+QISEND=0,0 +QISEND: 10,10,0 OK //发送长度可变数据。 //SEND OK 不能代表数据已经成功发送至服务器，Host 可通过 AT+QISEND=0,0 查询数据是否达到服务器。 //发送固定长度数据，长度为 5 字节。 //查询发送数据长度，已确认数据长度和未确认数据长度。 3.4.3. 直吐模式下接收远程服务器端数据 +QIURC: 'recv',0,4 test //接收远程服务器端数据。 3.4.4. 断开 TCP 用户端连接 AT+QICLOSE=0 OK //断开为 0 的连接。受网络状态影响，最大 响应时间为 10 秒。 上海移远通信技术股份有限公司 46 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 3.5. TCP 服务器在缓存模式下工作 3.5.1. 启动 TCP 服务器 AT+QIOPEN=1,1,'TCP LISTENER','127.0.0.1',0,2020,0 // 上 下 文 为 1 ， 为 1 。 执 行 AT+QIOPEN 之 前 ， Host 需 通 过 AT+QIACT 来激活上下文。 OK +QIOPEN: 1,0 AT+QISTATE=0,1 //TCP 服务器启动成功。 //查询连接状态是否为 1。 +QISTATE: 1,'TCP LISTENER','10.7.157.1',0,2020,3,1,1,0,'usbmodem' OK 3.5.2. 接受客户端的连接请求 +QIURC: 'incoming',11,1,'172.31.242.222',54091 //接受一个 TCP 连接，为'TCP INCOMING'，为 11。 3.5.3. 接收的客户端数据 +QIURC: 'recv',11 AT+QIRD=11,1500 +QIRD: 4 test OK AT+QIRD=11,1500 +QIRD: 0 OK AT+QIRD=11,0 +QIRD: 4,4,0 OK //从远程客户端连接接收的数据。 //读取客户端连接接收的数据。 //实际数据长度为 4 字节。 //缓存无数据。 //查询接收数据总长度，包含已读和未读数据。 上海移远通信技术股份有限公司 47 / 53 3.5.4. 断开 TCP 服务器连接 AT+QICLOSE=11 OK AT+QICLOSE=1 OK RGx00U&RM500U 系列 TCP/IP 应用指导 //断开客户端连接，受网络状态影响最大响应时间 10 秒。 //关闭 TCP 服务器监听。 3.6. UDP 服务示例 3.6.1. 打开 UDP 服务 AT+QIOPEN=1,2,'UDP SERVICE','127.0.0.1',0,3030,0 // 打 开 UDP 服 务 ， 为 2 ， 为 1，执行 AT+QIOPEN 之前， Host 需通过 AT+QIACT 来激活上下文。 OK +QIOPEN: 2,0 //成功打开 UDP 服务。 AT+QISTATE=0,1 //查询的连接状态是否为 1。 +QISTATE: 2,'UDP SERVICE','10.7.157.1',0,3030,2,1,2,0,'usbmodem' OK 3.6.2. 向服务器发送 UDP 数据 AT+QISEND=2,10,'10.7.89.10',6969 >1234567890 SEND OK //向远程端发送字节长度为 10 字节的数据，远程 端 IP 地址是 10.7.89.10，端口是 6969。 3.6.3. 接收远程端数据 +QIURC: 'recv',2 AT+QIRD=2 +QIRD: 4,'10.7.76.34',7687 AAAA OK AT+QIRD=2 +QIRD: 0 //接收远程端数据。 //读取 UDP 数据。可输出一整个 UDP 数据包，无需指定读取长度。 //数据长度为 4，远程 IP 地址 10.7.76.34，远程端口是 7687。 //读取数据。 //缓存无数据。 上海移远通信技术股份有限公司 48 / 53 OK AT+QISEND=2,10,'10.7.76.34',7687 >1234567890 SEND OK 3.6.4. 关闭 UDP 服务 AT+QICLOSE=2 OK RGx00U&RM500U 系列 TCP/IP 应用指导 //向远程端发送数据，远程 IP 地址为 10.7.76.34， 远程端口是 7687。 //关闭服务。 3.7. PING AT+QPING=1,'www.baidu.com' OK +QPING: 0,'61.135.169.125',32,192,255 +QPING: 0,'61.135.169.125',32,240,255 +QPING: 0,'61.135.169.125',32,241,255 +QPING: 0,'61.135.169.125',32,479,255 +QPING: 0,4,4,0,192,479,288 //在上下文 1 中 Ping www.baidu.com，在 Ping 目标 IP 地址前，Host 需通过 AT+QIACT 来激活上下文。 3.8. 获取上一个错误代码示例 AT+QIOPEN=1,'TCP','220.180.239.212',8009,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552,invalid parameters //开启Socket服务，省略了。 OK 上海移远通信技术股份有限公司 49 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 4 错误代码 当 TCP/IP 的 AT 命令返回 ERROR 时，具体的错误类型可以通过 AT+QIGETERROR 来查询。需注意 AT+QIGETERROR 查询的是上一个 TCP/IP AT 命令的错误代码。 表 2：错误代码列表 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 Operation success Unknown error Operation blocked Invalid parameters Memory not enough Socket creation failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed PDP context opening failed PDP context closure failed Socket identity has been used DNS busy DNS parse failed 描述 操作成功 未知错误 操作受阻 无效参数 内存不足 创建Socket失败 操作不支持 Socket绑定失败 Socket监听失败 Socket写入失败 Socket读取失败 Socket接受失败 打开PDP上下文失败 关闭PDP上下文失败 Socket标识被占用 DNS忙碌 DNS解析失败 上海移远通信技术股份有限公司 50 / 53 566 Socket connect failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel sending 572 Operation not allowed 573 APN not configured 574 Port busy RGx00U&RM500U 系列 TCP/IP 应用指导 Socket连接失败 Socket被关闭 操作忙碌 操作超时 PDP上下文出现故障 取消发送 操作不允许 APN未配置 端口忙碌 上海移远通信技术股份有限公司 51 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 5 附录 参考文档及术语缩写 表 3：参考文档 文档名称 [1] Quectel_RGx00U&RM500U 系列_AT 命令手册 表 4：术语缩写 缩写 3GPP ACK APN ASCII CHAP CS DNS FIN ID IP NTP NV PAP PDP PPP 英文全称 中文全称 3rd Generation Partnership Project 第三代合作伙伴计划 Acknowledgement 确认字符 Access Point Name 接入点名称 American Standard Code for Information Interchange 美国信息交换标准代码 Challenge Handshake Authentication Protocol 挑战握手认证协议 Circuit Switching 电路交换 Domain Name System 域名系统 Finish 完成 Identifier 标识符 Internet Protocol 互联网协议 Network Time Protocol 网络时间协议 Non-Volatile 非易失 Password Authentication Protocol 密码认证协议 Packet Data Protocol 分组数据协议 Point-to-Point Protocol 点对点协议 上海移远通信技术股份有限公司 52 / 53 RGx00U&RM500U 系列 TCP/IP 应用指导 PS QoS TCP/IP TTL UART UDP URC USB (U)SIM UTC Packet Switching Quality of Service Transmission Control Protocol/Internet Protocol Time to Live Universal Asynchronous Receiver & Transmitter User Datagram Protocol Unsolicited Result Code Universal Serial Bus (Universal) Subscriber Identity Module Coordinated Universal Time 分组交换 服务质量 传输控制协议/网际协议 生存时间 通用异步收发器 用户数据包协议 非请求结果码 通用串行总线 （通用）用户身份模块 协调世界时 上海移远通信技术股份有限公司 53 / 53

RGx00U&RM500U 系列 Log 抓取指导 5G 模块系列 版本：2.0 日期：2023-11-06 状态：受控文件 RGx00U&RM500U 系列 Log 抓取指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 33 RGx00U&RM500U 系列 Log 抓取指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 33 RGx00U&RM500U 系列 Log 抓取指导 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 2.0 日期 作者 2020-09-18 Larson ZHANG 2021-04-27 Eric LIU 2021-08-24 Eric LIU 2022-01-04 Eric LIU 2022-05-11 Xudong MAO 2023-11-06 Jeffery JIANG 变更表述 版本创建 受控版本 1. 增加适用模块 RG200U-CN； 2. 增加通过 Socket 抓取 CP 侧 Log 的方式（第 3.3 章）。 1. 增加 Linux 系统通过 QLog 工具抓取 AP 侧 Dump 文件的 步骤说明（第 2.3 章）； 2. 增加通过 QLog 工具抓取 CP 侧 Log 时日志等级设置方式 （第 3.2.1 章）； 3. 更新通过 QLog 工具抓取 CP 侧 Dump 文件的步骤（第 3.2.2 章）。 1. 更新配置 USB 端口使用的 AT 命令 AT+QCFG='usbcfg'； 2. 增加通过串口抓取 AP 侧 Log 的方式（第 2.2 章）； 3. 更新 Windows 系统下通过 Logel 工具抓取 AP 侧 Dump 文件的步骤说明（第 2.3 章）。 1. 新增适用模块： RG200U-JO、RG500U-EA/-EB/-LA。 2. 更新 AP 侧 Log 和 Dump 文件抓取相关描述（第 2 章）。 3. 更 新 Linux 系 统 下 执 行 AT 命 令 的 工 具 为 minicom （第 2.2 章、3.2 章、3.3.3 章、3.3.4 章）。 4. 新增有关配置 Log 日志等级、Log/Dump 文件丢包解决方 法的备注（第 3 章） 5. 新增 PCIe 驱动在抓取 Log 中的作用描述（第 2.2.1 章、 3.2.1 章）； 6. 优化了 Socket 方式抓取 CP 侧 Log 的步骤并更新相关的 备注（第 3.3.1 和 3.3.3 章）； 7. 新增 Socket 方式抓取 CP 侧 Dump 文件的方法（第 3.3.2、 3.3.4 章）； 8. 新增典型用法（第 5 章）。 上海移远通信技术股份有限公司 3 / 33 RGx00U&RM500U 系列 Log 抓取指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 2 AP 侧 Log 和 Dump 文件抓取............................................................................................................... 8 2.1. Window 系统 ............................................................................................................................... 8 2.1.1. 通过 ADB 工具抓取 AP 侧 Log ......................................................................................... 8 2.1.2. 通过 USB 虚拟串口抓取 AP 侧 Log.................................................................................. 8 2.1.3. 通过 Debug 口抓取 AP 侧 Log ....................................................................................... 10 2.1.4. 通过 Logel 工具抓取 AP 侧 Dump 文件.......................................................................... 11 2.2. Linux 系统.................................................................................................................................. 13 2.2.1. 通过 QLog 工具抓取 AP 侧 Log...................................................................................... 13 2.2.2. 通过 QLog 工具抓取 AP 侧 Dump 文件.......................................................................... 14 3 CP 侧 Log 和 Dump 文件抓取............................................................................................................. 16 3.1. Windows 系统............................................................................................................................ 16 3.1.1. 通过 Logel 工具抓取 CP 侧 Log ..................................................................................... 16 3.1.2. 通过 Logel 工具抓取 CP 侧 Dump 文件.......................................................................... 19 3.2. Linux 系统.................................................................................................................................. 20 3.2.1. 通过 QLog 工具抓取 CP 侧 Log ..................................................................................... 20 3.2.2. 通过 QLog 工具抓取 CP 侧 Dump 文件.......................................................................... 22 3.3. Socket 方式 ............................................................................................................................... 22 3.3.1. 网线直连的方式抓取 CP 侧 Log ..................................................................................... 23 3.3.2. 网线直连的方式抓取 CP 侧 Dump 文件 ......................................................................... 24 3.3.3. 网线非直连的方式抓取 CP 侧 Log.................................................................................. 26 3.3.4. 网线非直连的方式抓取 CP 侧 Dump 文件...................................................................... 27 4 注意事项 ............................................................................................................................................... 30 4.1. AT 口不通时抓取 Log ................................................................................................................ 30 4.2. 查看模块网络状态 ..................................................................................................................... 31 5 典型用法 ............................................................................................................................................... 32 6 附录 参考文档及术语缩写 ................................................................................................................... 33 上海移远通信技术股份有限公司 4 / 33 RGx00U&RM500U 系列 Log 抓取指导 表格索引 表 1：参考文档 ........................................................................................................................................... 33 表 2：术语缩写 ........................................................................................................................................... 33 上海移远通信技术股份有限公司 5 / 33 RGx00U&RM500U 系列 Log 抓取指导 图片索引 图 1：获取 AP 侧 Log 文件........................................................................................................................... 8 图 2：选择 NMEA Port 连接 ......................................................................................................................... 9 图 3：AP 侧 Log 通过 NMEA Port 打印内容 ................................................................................................ 9 图 4：AP 侧 Log 通过 Debug 口打印内容 .................................................................................................. 10 图 5：AP 侧 Dump 打印内容 .......................................................................................................................11 图 6：检测端口 ............................................................................................................................................11 图 7：配置 Logel 工具 ................................................................................................................................ 12 图 8：Logel 抓取 AP 侧 Dump 文件 ........................................................................................................... 12 图 9：Linux 端通过 USB 抓取 AP 侧 Log ................................................................................................... 13 图 10：Linux 端查看 AP 侧 Log 文件 ......................................................................................................... 14 图 11：加载模块端口.................................................................................................................................. 15 图 12：QLog 工具抓取 AP 侧 Dump 文件 .................................................................................................. 15 图 13：端口识别正常.................................................................................................................................. 16 图 14：选择 Diag Port 和 Log Port............................................................................................................. 17 图 15：Windows 端抓取 CP 侧 Log ........................................................................................................... 18 图 16：选择 Log 分析文件.......................................................................................................................... 18 图 17：Logel 工具勾选配置........................................................................................................................ 19 图 18：Windows 端抓取 CP 侧 Dump 文件 ............................................................................................... 20 图 19：Linux 端抓取 CP 侧 Log ................................................................................................................. 21 图 20：Linux 端查看 CP 侧 Log 文件 ......................................................................................................... 21 图 21：Logel 工具配置 Socket 方式（网线直连） ..................................................................................... 23 图 22：Logel 工具通过 Socket 抓取日志结果 ............................................................................................ 24 图 23：Logel 工具配置 Socket 方式（网线直连） ..................................................................................... 25 图 24：Windows 端抓取 CP 侧 Dump 文件 ............................................................................................... 25 图 25：设备结构 ......................................................................................................................................... 26 图 26：QLog 运行结果 ............................................................................................................................... 26 图 27：Logel 工具配置 Socket 方式（网线非直连） ................................................................................. 27 图 28：QLog 运行结果 ............................................................................................................................... 28 图 29：Logel 工具配置 Socket 方式（网线非直连） ................................................................................. 29 图 30：Windows 端抓取 CP 侧 Dump 文件 ............................................................................................... 29 图 31：识别设备 ......................................................................................................................................... 30 图 32：导出 AP 侧 Log 文件....................................................................................................................... 30 图 33：使用 QLog 工具抓 Log 的实例........................................................................................................ 32 图 34：QLog 工具上位机生成的 Log.......................................................................................................... 32 上海移远通信技术股份有限公司 6 / 33 RGx00U&RM500U 系列 Log 抓取指导 1 引言 本文档主要介绍如何通过 QLog、USB 虚拟串口、ADB 和 Logel 工具抓取移远通信 5G RG200U 系列、 RG500U 系列和 RM500U 系列模块中 AP 侧和 CP 侧的 Log 和 Dump 文件，同时介绍了如何通过 Socket 方式抓取 CP 侧 Log 和 Dump 文件。 模块出现异常情况时，首先需通过 AT 命令查看模块当前的网络状态（详见第 4.2 章），根据查询结果 初步判断问题原因。若模块配置有误，可通过 AT 命令重新配置以解决问题；若无法判断或解决，需收集对 应的日志信息提交至移远通信技术支持进行进一步的分析处理。 备注 1. QLog 工具为移远通信开发的 Log 抓取工具，请联系移远通信技术支持获取安装包。 2. ADB 工具由谷歌开发，可联系移远通信技术支持协助安装。 3. Logel 工具的安装和使用需要展讯授权，可联系移远通信技术支持协助安装 Logel 工具。 上海移远通信技术股份有限公司 7 / 33 RGx00U&RM500U 系列 Log 抓取指导 2 AP 侧 Log 和 Dump 文件抓取 2.1. Window 系统 本章节介绍如何在 Windows 系统下抓取模块 AP 侧 Log 和 Dump 文件。 2.1.1. 通过 ADB 工具抓取 AP 侧 Log 1. 打开 QCOM 工具，执行 AT+QADBKEY?获取模块的 chip_uid 后，联系移远通信技术支持获取对 应的密码。随后使用密码输入 AT+QADBKEY=。 2. 执行 AT+QCFG='usbcfg',0x2c7c,0x0900,1,1,1,1,1,1,0 配置 USB 端口，打开 ADB。有关该命令 详情，请参考文档 [1]。 3. 执行 AT+QTEST='debug'查看当前 Debug 模式。若返回值不是 1，请执行 AT+QTEST='debug',1 进入 Debug 模式。执行成功后，在模块 Debug 口执行 reboot 重启模块，此时 AP 侧 Log 被打开。 模块的 Log 信息会保存至 yocto.log 日志文件中。获取日志文件后需执行 AT+QTEST='debug',0 退出 Debug 模式。 4. 待 AP 侧 Log 文件收集完成后执行 adb pull /data/yocto.log 获取 Log 文件。 图 1：获取 AP 侧 Log 文件 2.1.2. 通过 USB 虚拟串口抓取 AP 侧 Log 1. 打开 QCOM 工具，执行 AT+QCFG='usbcfg',0x2c7c,0x0900,1,1,1,1,1,1,0 配置 USB 端口，打 开 ADB。 2. 执行 AT+QTEST='debug'查看当前 Debug 模式。若返回值不是 4，则执行 AT+QTEST='debug',4 进入 AP 侧 Log 抓取模式。 3. 保存 Log 文件。在 QCOM 工具上选择 NMEA Port 连接，如图 2 所示。在 QCOM 工具上打开'COM Port Setting'界面，勾选'Save Log'并指定 Log 文件存储位置。指定路径后工具直接开始保存 日志，如图 3 所示： 上海移远通信技术股份有限公司 8 / 33 RGx00U&RM500U 系列 Log 抓取指导 图 2：选择 NMEA Port 连接 图 3：AP 侧 Log 通过 NMEA Port 打印内容 上海移远通信技术股份有限公司 9 / 33 RGx00U&RM500U 系列 Log 抓取指导 2.1.3. 通过 Debug 口抓取 AP 侧 Log 1. 打开 QCOM 工具，执行 AT+QTEST='debug'查看当前 Debug 模式。若返回值不是 3，则执行 AT+QTEST='debug',3 打开模块日志。 2. 在 Window 设备上使用串口工具接收模块 AP 侧 Log，然后保存为文件即可。以 MobaXterm 工具 为例： 图 4：AP 侧 Log 通过 Debug 口打印内容 上海移远通信技术股份有限公司 10 / 33 RGx00U&RM500U 系列 Log 抓取指导 2.1.4. 通过 Logel 工具抓取 AP 侧 Dump 文件 1. 如需抓取 AP 侧 Dump 文件，首先需依次执行 AT+ARMLOG=1、AT+QCFG='modemrstlevel',0 和 AT+QCFG='aprstlevel',0，防止因 Dump 导致模块重启，从而影响 Dump 文件的抓取。 Windows 系统下，若模块 AP 侧出现 Dump，模块会立即断开与上位机的连接但不会重启。模块 的 Debug 口将打印如下内容： 图 5：AP 侧 Dump 打印内容 模块 AP 侧 Dump 后上位机出现如下端口： 图 6：检测端口 2. 如需抓取 AP 侧 Dump 文件，同时还需要设置 Logel 工具。Logel_R9.19.1002_P1 之后的版本工 具默认关闭自动识别功能，需点击 Logel 工具的菜单'Option'→'Tool Configure'，选中复选 框开启自动识别功能。 上海移远通信技术股份有限公司 11 / 33 RGx00U&RM500U 系列 Log 抓取指导 图 7：配置 Logel 工具 3. 待上位机出现 U2S Diag 端口后，Logel 工具将自动识别并连接到模块，自动弹出数据框抓取 Dump 文件。Dump 文件存储在上位机端 Logel 工具的/Bin/History/目录下。 图 8：Logel 抓取 AP 侧 Dump 文件 上海移远通信技术股份有限公司 12 / 33 RGx00U&RM500U 系列 Log 抓取指导 2.2. Linux 系统 本章节介绍如何在 Linux 系统通过 QLog 工具抓取模块 AP 侧 Log 和 Dump 文件。 2.2.1. 通过 QLog 工具抓取 AP 侧 Log 1. 请参考文档 [2] 和[3] 安装 Linux 系统的 USB 驱动和 PCIe 驱动。 2. 在 QLog 工具的目录下打开 Linux 终端窗口，执行 make 后在 QLog 工具的目录下将生成一个名为 Qlog 的可执行文件。在 Linux 终端窗口执行 dmesg -w 列出模块端口。 ⚫ 若确定模块已经连接，却无端口显示，可能是未成功安装 USB 驱动，须重新安装。 ⚫ 若模块端口加载成功，此时可启动 QLog 工具。端口加载成功会打印模块信息。 3. 若通过 USB 接口连接到用户 Linux 设备，执行 AT+QTEST='debug'查看当前 Debug 模式。若返 回值不是 4，打开 minicom 工具并执行 AT+QTEST='debug',4 打开模块日志。随后在 Linux 终端 窗口执行 ./QLog -s log -x 打开 QLog 工具开始抓取 Log。输入'Ctrl' + 'C'可结束 QLog 进程。 图 9：Linux 端通过 USB 抓取 AP 侧 Log 若通过 PCIe 接口连接到用户 Linux 设备，执行 AT+QTEST='debug'查看当前 Debug 模式。若返 回值不是 5，打开 minicom 工具并执行 AT+QTEST='debug',5 打开模块日志。然后在 Linux 终端 窗口执行 ./QLog -s log -p /dev/sdiag_nr -x 打开 QLog 工具开始抓取 Log。输入'Ctrl' + 'C' 可结束 QLog 进程。 4. 查看对应的 Log 文件。以查看 Log 文件 20220908_140725_0000.log 为例，具体如下图所示。可 将该 Log 文件保存并提交给移远通信技术支持做进一步分析。 上海移远通信技术股份有限公司 13 / 33 RGx00U&RM500U 系列 Log 抓取指导 图 10：Linux 端查看 AP 侧 Log 文件 备注 QLog 命令常见参数说明： 1. -s 参数用于指定 Log 文件存储路径。 2. -p 参数用于指定抓取 Log 的端口。 3. -f 参数为不同业务、不同等级 Log 的配置文件路径，.conf 文件不会存放在 QLog 文件夹中，使用时 请自行指定该文件的绝对路径或者相对路径。不同的文件名称也代表不同的含义，例如： ⚫ unisoc_ps_cap_dsp_important_log.conf 代表打印 ps（信令）、cap（IP 报文）、dsp 重要等级日 志； ⚫ unisoc_ps_cap_dsp_normal_log.conf 代表打印 ps（信令）、cap（IP 报文）、dsp 一般等级日志。 4. -x 参数表示抓取 AP Log。 2.2.2. 通过 QLog 工具抓取 AP 侧 Dump 文件 Linux 系统下，若模块 AP 侧出现 Dump，则可通过 QLog 工具来抓取 Dump 信息。步骤如下： 1. 请参考文档 [2] 安装 Linux 系统的 USB 驱动。 2. 在 QLog 工具的目录下打开 Linux 终端窗口，执行 make 后在 QLog 工具的目录下将生成一个名为 Qlog 的可执行文件。在 Linux 终端窗口执行 dmesg -w 列出模块端口。 ⚫ 若确定模块已经连接，却无端口显示，可能是未成功安装 USB 驱动，须重新安装。 ⚫ 若模块端口加载成功，此时可启动 QLog 工具。端口加载成功会打印下图所示的信息： 上海移远通信技术股份有限公司 14 / 33 RGx00U&RM500U 系列 Log 抓取指导 图 11：加载模块端口 3. 打 开 minicom 工 具 并 执 行 AT+ARMLOG=1 打 开 模 块 日 志 ， 然 后 发 送 AT+QCFG='modemrstlevel',0 和 AT+QCFG='aprstlevel',0 防止因模块发生 Dump 重启，从而 影响 Dump 文件的抓取。 4. 在 Linux 终端窗口执行./QLog -s apdump 抓取模块的 Dump 文件。抓取的 Dump 文件存放于 QLog 工具的同级目录下。 图 12：QLog 工具抓取 AP 侧 Dump 文件 上海移远通信技术股份有限公司 15 / 33 RGx00U&RM500U 系列 Log 抓取指导 3 CP 侧 Log 和 Dump 文件抓取 3.1. Windows 系统 本章节介绍如何在 Windows 系统下通过 Logel 工具抓取模块 CP 侧 Log 和 Dump 文件。 3.1.1. 通过 Logel 工具抓取 CP 侧 Log 1. 参 考 文 档 [4] 安 装 移 远 通 信 提 供 的 最 新 版 本 的 Quectel_Windows_USB_Driver(U)_For_ECM_RNDIS 驱动，确保端口可被识别。 图 13：端口识别正常 上海移远通信技术股份有限公司 16 / 33 RGx00U&RM500U 系列 Log 抓取指导 2. 打开 QCOM 工具，选择对应的 AT 端口，设置默认波特率并连接模块。然后发送 AT+ARMLOG=1 打开模块日志。 3. 打开 Logel 工具，点击下图红框处设置 Log 存放路径和相应的 Log 端口 Diag Port 和 Log Port， 点击'OK'。示例如下： 图 14：选择 Diag Port 和 Log Port 备注 1. 由于 Log 文件过大，建议不要将 Log 文件存放在 C 盘。 2. 若 Log 文件出现丢包现象，可发送 AT+QCFG='iq_vser',1 重启模块后重新抓取 CP Log。有关该命 令的详细信息，详见文档 [1]。 上海移远通信技术股份有限公司 17 / 33 RGx00U&RM500U 系列 Log 抓取指导 4. 点击 按钮开始抓取 Log，如果图标变成 表示 Log 抓取成功。如下图所示： 图 15：Windows 端抓取 CP 侧 Log 5. Log 抓取成功后，进入相应的存储路径下获取日志即可。如需对抓取的 Log 进行分析（仅可分析 后缀名为.logel、.lst 以及.log 的文件），点击如下图所示 按钮，选择需要分析的文件，加载过程 中 会变成 ，Log 分析成功后，按钮会再变成 。 图 16：选择 Log 分析文件 上海移远通信技术股份有限公司 18 / 33 RGx00U&RM500U 系列 Log 抓取指导 备注 通过 Logel 工具抓取 CP 侧 Log 时，可在执行 AT+ARMLOG=1 打开模块日志（步骤 2）后通过 QCOM 工具执行 AT+SPLOGLEVEL=1,,'FFFFFFFFFFFFFFFF','FFFFFFFFFFFFFFFFFFFFFFF FFFFFFFFF'配置日志等级。除外，其他参数无需修改。 整型。日志等级。 1 仅打印重要日志 3 仅打印一般等级日志 5 打印所有日志 3.1.2. 通过 Logel 工具抓取 CP 侧 Dump 文件 1. 基于第 3.1.1 章中步骤 1~3，打开 QCOM 工具，依次发送 AT+QCFG='modemrstlevel',0 和 AT+QCFG='aprstlevel',0 防止因模块发生 Dump 重启，从而影响 Dump 文件的抓取。 2. Logel 工具中勾选配置完成后开始抓取 Dump 文件。配置如下图所示： 图 17：Logel 工具勾选配置 3. 若模块 CP 侧出现 Dump，执行 CP 侧网络相关 AT 命令时会无响应，即 AT 口不通。打开 Logel 工具会自动弹出如下对话框。点击'Cancel'，工具自动导出 Dump 文件；点击'OK'，手动抓取 Dump 文件，此时需按照提示输入 3 后方可手动抓取 Dump 文件。Dump 文件抓取完成后，将在日 志存储目录下产生后缀为.mem 的文件。 上海移远通信技术股份有限公司 19 / 33 RGx00U&RM500U 系列 Log 抓取指导 图 18：Windows 端抓取 CP 侧 Dump 文件 备注 若抓取的 CP Dump 文件出现丢包现象，可发送 AT+QCFG='quecdumptime',（表示抓 取 Dump 文件后的延时时间。范围：0~5000；单位：微秒）以便重新抓取 CP Dump 文件。有关该命令 的详细信息，详见文档 [1]。 3.2. Linux 系统 本章节介绍如何在 Linux 系统通过 QLog 工具抓取模块 CP 侧 Log 和 Dump 文件。 3.2.1. 通过 QLog 工具抓取 CP 侧 Log 1. 请参考文档 [2] 和[3] 安装 Linux 系统的 USB 驱动和 PCIe 驱动。 2. 在 QLog 工具的目录下打开 Linux 终端窗口，执行 make 后在 QLog 工具的目录下将生成一个名为 Qlog 的可执行文件。在 Linux 终端窗口执行 dmesg -w 列出模块端口。 ⚫ 若确定模块已经连接，却无端口显示，可能是未成功安装 USB 驱动，须重新安装。 ⚫ 若模块端口加载成功，此时可启动 QLog 工具。端口加载成功会打印模块信息。 3. 打开 minicom 工具并执行 AT+ARMLOG=1 打开模块日志。 4. 若通过 USB 接口连接到用户 Linux 设备，在 Linux 终端窗口执行./QLog -s log -f（例如./QLog -s log -f ./unisoc_ps_cap_dsp_normal_log.conf）打开 QLog 工具开始抓取 Log。输入'Ctrl' + 'C'可结束 QLog 进程。 上海移远通信技术股份有限公司 20 / 33 RGx00U&RM500U 系列 Log 抓取指导 若通过 PCIe 接口连接到用户 Linux 设备，在 Linux 终端窗口执行./QLog -s log -p /dev/sdiag_nr -f （例如./QLog -s log -p /dev/sdiag_nr -f ./unisoc_ps_cap_dsp_normal_log.conf）打开 QLog 工具开始抓取 Log。输入'Ctrl' + 'C'可结束 QLog 进程。 以通过 USB 接口连接到用户 Linux 设备为例： 图 19：Linux 端抓取 CP 侧 Log 5. 查看对应的 Log 文件。以查看 Log 文件 20220908_143049_0000.logel 为例，具体如下图所示。 可将该 Log 文件保存并提交给移远通信技术支持做进一步分析。 备注 图 20：Linux 端查看 CP 侧 Log 文件 1. 若 Log 文件出现丢包现象，可发送 AT+QCFG='iq_vser',1 重启模块后重新抓取 CP Log。有关该命 令的详细信息，详见文档 [1]。 2. -f 参数为不同业务、不同等级 Log 的配置文件路径，.conf 文件不会存放在 QLog 文件夹中，使用时请 自行指定该文件的绝对路径或者相对路径。不同的文件名称也代表不同的含义，例如： ⚫ unisoc_ps_cap_dsp_important_log.conf 代表打印 ps（信令）、cap（IP 报文）、dsp 重要等级日 志； 上海移远通信技术股份有限公司 21 / 33 RGx00U&RM500U 系列 Log 抓取指导 ⚫ unisoc_ps_cap_dsp_normal_log.conf 代表打印 ps（信令）、cap（IP 报文）、dsp 一般等级日志。 3.2.2. 通过 QLog 工具抓取 CP 侧 Dump 文件 基 于 第 3.2.1 章 中 步 骤 1~3 ， 使 用 minicom 工 具 执 行 AT+QCFG='modemrstlevel',0 和 AT+QCFG='aprstlevel',0，防止因 Dump 导致模块重启，从而影响 Dump 文件的抓取。 若通过 USB 接口连接到用户 Linux 设备，在 Linux 终端窗口执行./QLog -s dump 抓取模块 Dump 后 的 Dump 文件。输入'Ctrl' + 'C'可结束 QLog 进程。抓取的 Dump 文件存放于 QLog 工具的同级目 录下。 若通过 PCIe 接口连接到用户 Linux 设备，在 Linux 终端窗口执行./QLog -s dump -p /dev/sdiag_nr 抓取模块 Dump 后的 Dump 文件。输入'Ctrl' + 'C'可结束 QLog 进程。抓取的 Dump 文件存放于 QLog 工具的同级目录下。 备注 若抓取的 CP Dump 文件出现丢包现象，可发送 AT+QCFG='quecdumptime',（表示抓 取 Dump 文件后的延时时间。范围：0~5000；单位：微秒）以便重新抓取 CP Dump 文件。有关该命令 的详细信息，详见文档 [1]。 3.3. Socket 方式 模块存在以下情况时，可以通过 Socket 的方式实现 Log 抓取，但需保证上位机和模块均处于同一局域 网络中，且网络通畅： ⚫ 无法通过 USB 或 PCle 连接抓取 CP 侧 Log ⚫ 无 USB/PCle 接口 ⚫ 需远程抓取 CP 侧 Log 备注 1. 当前仅支持在 Windows 系统的上位机使用 Socket 方式抓取 CP 侧 Log。 2. 移远通信在 2021 年 6 月份之后发布的模块固件版本均已支持通过 Socket 方式抓取 CP 侧 Log。 3. 抓取并发送 Log 数据过程中推荐使用有线网络。Log 的数据量较大且需要实时传输，Wi-Fi 网络一般 不太稳定。 上海移远通信技术股份有限公司 22 / 33 RGx00U&RM500U 系列 Log 抓取指导 3.3.1. 网线直连的方式抓取 CP 侧 Log 本章节介绍模块通过 USB 线与上位机相连，并建立有线网络连接的情况下，Windows 系统的上位机如 何通过 Socket 方式抓取 CP 侧 Log。 1. 打开 QCOM 工具，发送 AT+QCFG='nat',2 和 AT+QCFG='usbnet',3。 2. 重启模块使配置生效。 3. 执行 AT+ARMLOG=1 打开模块日志。 4. 打开上位机的 Logel 工具，'Type'选择'Socket'，进行如下配置后，点击'OK'。 ⚫ Address (Diag)：192.168.42.1 ⚫ Port (Diag)：10056 ⚫ Address (SMP)：192.168.42.1 ⚫ Port (SMP)：10057 图 21：Logel 工具配置 Socket 方式（网线直连） 上海移远通信技术股份有限公司 23 / 33 5. 点击 Logel 工具上 按钮开始抓取 Log。 RGx00U&RM500U 系列 Log 抓取指导 图 22：Logel 工具通过 Socket 抓取日志结果 备注 1. 不同的网卡拨号模式下 Address（地址）是不同的，请根据实际地址进行填写。 2. 若 Log 文件出现丢包现象，可发送 AT+QCFG='iq_vser',1 重启模块后重新抓取 CP Log。有关该命 令的详细信息，详见文档 [1]。 3.3.2. 网线直连的方式抓取 CP 侧 Dump 文件 本章节介绍模块通过 USB 线与上位机相连，并建立有线网络连接的情况下，Windows 系统的上位机如 何通过 Socket 方式抓取 CP 侧 Dump 文件。 1. 打开 QCOM 工具，发送 AT+QCFG='nat',2 和 AT+QCFG='usbnet',3。 2. 重启模块使配置生效。 3. 上 位 机 向 模 块 依 次 发 送 AT+ARMLOG=1 、 AT+QCFG='aprstlevel',0 、 AT+QCFG='modemrstlevel',0 和 AT+QCFG='aprstlevel',0，防止因 Dump 导致模块重启，从 而影响 Dump 文件的抓取。 4. 打开上位机的 Logel 工具，'Type'选择'Socket'，进行如下配置后，点击'OK'。 ⚫ Address (Diag)：192.168.42.1 ⚫ Port (Diag)：10056 ⚫ Address (SMP)：192.168.42.1 上海移远通信技术股份有限公司 24 / 33 ⚫ Port (SMP)：10057 RGx00U&RM500U 系列 Log 抓取指导 图 23：Logel 工具配置 Socket 方式（网线直连） 5. 点击 Logel 工具上 按钮开始抓取 Dump 文件。 6. 若模块 CP 侧发生 Dump，Logel 工具将自动弹出如下对话框，点击'Cancel'，工具自动导出 Dump 文件；点击'OK'，手动抓取 Dump 文件，此时需按照提示输入 3 后方可手动抓取 Dump 文件。 Dump 文件抓取完成后，将在日志存储目录下产生后缀为.mem 的文件。 图 24：Windows 端抓取 CP 侧 Dump 文件 备注 1. 使用 Socket 抓取 CP 侧 Dump 文件时，模块的网卡拨号模式只能是路由模式（AT+QCFG='nat',1） 或者网桥模式（AT+QCFG='nat',2），对应的 Address（地址）请根据实际地址进行填写。 上海移远通信技术股份有限公司 25 / 33 RGx00U&RM500U 系列 Log 抓取指导 2. 若抓取的 CP Dump 文件出现丢包现象，可发送 AT+QCFG='quecdumptime',（ 表示抓取 Dump 文件后的延时时间。范围：0~5000；单位：微秒）以便重新抓取 CP Dump 文件。 有关该命令的详细信息，详见文档 [1]。 3.3.3. 网线非直连的方式抓取 CP 侧 Log 本章节介绍模块在通过用户 Linux 设备而非直接连至上位机的情况下，Windows 系统的上位机如何通 过 Socket 方式抓取 CP 侧 Log。该方式网络拓扑结构比较多，以下以最常用的一种拓扑结构为例介绍抓取 Log 的方式。 模块直接连至用户 Linux 设备时，由于用户 Linux 设备的存储空间限制，仅可通过网络连接到上位机的 Logel 工具，间接抓取 CP 侧的 Log。此时需要先在用户 Linux 设备上运行 QLog 工具抓取模块中 CP 侧 Log， 然后通过 Socket 发送至上位机的 Logel 工具，完成 CP 侧 Log 的抓取。详细步骤如下： 1. 模块可选择通过 USB 或者 PCle 接口连接到用户 Linux 设备，Linux 设备再由网线或者同一个局域 网与 PC 端的 Logel 创建 TCP 连接，具体硬件连接图如下： 模块 USB/PCIe Linux设备 TCP（网线直连 或者 同一个 局域网 ） PC端Logel工具 图 25：设备结构 2. 若通过 USB 接口连接到用户 Linux 设备，则在用户 Linux 设备上运行./QLog -s 9000 &。该命令 为默认的 Log 抓取命令，默认端口为/dev/ttyUSB1。 若通过 PCIe 接口连接到用户 Linux 设备，则在用户 Linux 设备上运行./QLog -s 9000 -p /dev/sdiag_nr &，通过命令中的-p 指定抓取 Log 的端口/dev/sdiag_nr。 图 26：QLog 运行结果 上海移远通信技术股份有限公司 26 / 33 RGx00U&RM500U 系列 Log 抓取指导 备注 1. 在用户 Linux 设备上运行 QLog 工具之前，需确保用户设备已安装 USB 或 PCle 驱动，且模块端口 加载成功，详情可参考文档 [2] 和文档 [3]。 2. 若用户上位机性能不是很好，可以使用./Qlog -s 9000 -f xxxx.conf &减小 CP Log 数据大小。请根 据实际场景使用替换命令中 xxxx.conf 为指定的.conf 配置文件以过滤掉非必要的 Log。 3. 若 Log 文件出现丢包现象，可发送 AT+QCFG='iq_vser',1 重启模块后重新抓取 CP Log。有关该命 令的详细信息，详见文档 [1]。 3. 打开 minicom 工具，选择对应的 AT 端口，设置默认波特率并连接模块。随后发送 AT+ARMLOG=1 打开模块日志。 4. 打开上位机的 Logel 工具，'Type'选择'Socket'，进行如下配置后，点击'OK'。 ⚫ Address (Diag)：用户 Linux 设备地址（例如：192.168.100.1，可通过 ifconfig 查看） ⚫ Port (Diag)：9000 ⚫ Address (SMP)：用户 Linux 设备地址（例如：192.168.100.1） ⚫ Port (SMP)：9001 图 27：Logel 工具配置 Socket 方式（网线非直连） 5. 点击 Logel 工具上 按钮，通过 TCP 连接的方式，抓取用户 Linux 设备上 QLog 工具转发的 Log。 3.3.4. 网线非直连的方式抓取 CP 侧 Dump 文件 本章节介绍模块在通过用户 Linux 设备而非直接连至上位机的情况下，Windows 系统的上位机如何通 过 Socket 方式抓取 CP 侧 Dump 文件。该方式网络拓扑结构比较多，以下以最常用的一种拓扑结构为例介 绍抓取 Dump 文件的方式。 模块直接连至用户 Linux 设备时，由于用户 Linux 设备的存储空间限制，仅可通过网络连接到上位机的 Logel 工具，从而间接抓取 CP 侧的 Dump 文件。此时需要先在用户 Linux 设备上运行 QLog 工具抓取模块 中 CP 侧 Dump 文件，然后通过 Socket 发送至上位机的 Logel 工具，完成 CP 侧 Dump 文件的抓取。详细 步骤如下： 上海移远通信技术股份有限公司 27 / 33 RGx00U&RM500U 系列 Log 抓取指导 1. 上位机通过 minicom 依次向模块发送 AT+ARMLOG=1、AT+QCFG='modemrstlevel',0 和 AT+QCFG='aprstlevel',0，防止因 Dump 导致模块重启，从而影响 Dump 文件的抓取。 2. 模块可选择通过 USB 或者 PCle 接口连接到用户 Linux 上位机，Linux 上位机再由网线或者同一个 局域网与 PC 端的 Logel 创建 TCP 连接，具体硬件连接图见图 25。 若通过 USB 接口连接到用户 Linux 设备，则在用户 Linux 设备上运行./QLog -s 9000 &。该命令 为默认的 Log 抓取命令，默认端口为/dev/ttyUSB1。 若通过 PCIe 接口连接到用户 Linux 设备，则在用户 Linux 设备上运行./QLog -s 9000 -p /dev/sdiag_nr &，通过命令中的-p 指定抓取 Log 的端口/dev/sdiag_nr。 图 28：QLog 运行结果 备注 1. 在用户 Linux 设备上运行 QLog 工具之前，需确保用户设备已安装 USB 或 PCle 驱动，且模块端口加 载成功，详情可参考文档 [2]和文档 [3]。 2. 若抓取的 CP Dump 文件出现丢包现象，可发送 AT+QCFG='quecdumptime',（ 表示抓取 Dump 文件后的延时时间。范围：0~5000；单位：微秒）以便重新抓取 CP Dump 文件。 有关该命令的详细信息，详见文档 [1]。 3. 打开 minicom 工具，选择对应的 AT 端口，设置默认波特率并连接模块。随后发送 AT+ARMLOG=1 打开模块日志。 4. 打开上位机的 Logel 工具，'Type'选择'Socket'，进行如下配置，点击'OK'。 ⚫ Address (Diag)：客户 Linux 设备地址（例如：192.168.100.1） ⚫ Port (Diag)：9000 ⚫ Address (SMP)：客户 Linux 设备地址（例如：192.168.100.1） ⚫ Port (SMP)：9001 上海移远通信技术股份有限公司 28 / 33 RGx00U&RM500U 系列 Log 抓取指导 图 29：Logel 工具配置 Socket 方式（网线非直连） 5. 点击 Logel 工具上 按钮，通过 TCP 连接的方式，抓取用户 Linux 设备上 QLog 工具转发的 Dump 文件。 6. 若模块 CP 侧发生 Dump，打开 Logel 工具将自动弹出如下对话框，点击'Cancel'，工具自动导 出 Dump 文件；点击'OK'，手动抓取 Dump 文件，此时需按照提示输入 3 后方可手动抓取 Dump 文件。Dump 文件抓取完成后，将在日志存储目录下产生后缀为.mem 的文件。 图 30：Windows 端抓取 CP 侧 Dump 文件 上海移远通信技术股份有限公司 29 / 33 RGx00U&RM500U 系列 Log 抓取指导 4 注意事项 4.1. AT 口不通时抓取 Log 1. 首先通过 AT 命令的响应情况来判断模块 CP 侧是否发生 Dump。若发送任意 AT 命令没有响应且 模块 AP 侧处于正常运行状态，则表示模块 CP 侧大概率发生了 Dump。 2. 若模块 CP 侧未出现 Dump，连接上位机至模块的 Debug 口，执行 ps|grep atrouter 查看 atrouter 进程是否存在，若进程还在则保留进程的运行环境。 3. 使用 ADB 工具导出/data 目录下 yocto.log 和 yocto.log.tmp 文件。yocto.log 文件为内核和应用的 日志信息。若 Log 信息过多，超出 yocto.log 文件的大小限制，则会自动生成 yocto.log.tmp 文件。 打开 cmd 窗口，执行 adb devices 查看能否识别到设备，识别成功后执行 adb pull /data/yocto.log 和 adb pull /data/yocto.log.tmp 将模块中 Log 文件导出并打包。如 需，可提供此 Log 文件至移远通信技术支持做进一步分析。 图 31：识别设备 图 32：导出 AP 侧 Log 文件 上海移远通信技术股份有限公司 30 / 33 RGx00U&RM500U 系列 Log 抓取指导 4.2. 查看模块网络状态 1. AT+CFUN?：查询模块功能模式。 2. AT+CPIN?：查询(U)SIM PIN 的状态。 3. AT+CEREG?：查询 EPS 网络注册状态。 4. AT+COPS?：查询网络状态。 5. AT+QENG='servingcell'：查询服务小区信息。 6. AT+CGDCONT?：查询 PDP 配置。 7. AT+CGPADDR=：查询 PDP 地址，为指定 PDP 上下文 ID。 8. AT+CGACT?：查询 PDP 激活状态。 备注 有关上述命令详情，请参考文档 [1]。 上海移远通信技术股份有限公司 31 / 33 RGx00U&RM500U 系列 Log 抓取指导 5 典型用法 通过 USB 接口或 PCIe 接口连接到用户 Linux 设备,并使用 QLog 工具同时抓取 AP 侧 Log 和 CP 侧 Log。 具体操作如下： 1. 若通过 USB 接口连接到用户 Linux 设备，需执行 AT+QTEST='debug'查看当前 Debug 模式。若 返回值不是 4，则打开 QCOM 工具并执行 AT+QTEST='debug',4 打开模块日志。 若通过 PCIe 接口连接到用户 Linux 设备，执行 AT+QTEST='debug'查看当前 Debug 模式，若返 回值不是 5，则打开 QCOM 工具并执行 AT+QTEST='debug',5 打开模块日志。 2. 参考下图所示命令使能同时抓取 AP log 和 CP log。 指定 Log 文件存储路径 指定合适的 CP log 过滤场景， x 表示同时抓取 AP log，若是通过 减少不必要的 log PCIe 接口连接 Linux 设备，需再指 定-p /dev/sdiag_nr 图 33：使用 QLog 工具抓 Log 的实例 图 34：QLog 工具上位机生成的 Log 上海移远通信技术股份有限公司 32 / 33 RGx00U&RM500U 系列 Log 抓取指导 6 附录 参考文档及术语缩写 表 1：参考文档 文档名称 [1] Quectel_RGx00U&RM500U 系列_AT 命令手册 [2] Quectel_UMTS_LTE_5G_Linux_USB_Driver_用户指导 [3] Quectel_RGx00U&RM500U 系列_PCIe 驱动_用户指导 [4] Quectel_Windows_USB_Driver(U)_For_ECM_RNDIS_安装指导 表 2：术语缩写 缩写 ADB AP CP COM EPS IP PDP PIN USB (U)SIM 英文全称 Android Debug Bridge Application Processor Central Processor Communication Evolved Packet System Internet Protocol Packet Data Protocol Personal Identification Number Universal Serial Bus (Universal) Subscriber Identity Module 中文全称 安卓调试桥 应用程序处理器 中央处理器 通信 演进型分组系统 网际互连协议 分组数据协议 个人识别号 通用串行总线 （通用）用户识别模块 上海移远通信技术股份有限公司 33 / 33

RGx00U&RM500U 系列 DFOTA 应用指导 5G 模块系列 版本：1.2 日期：2023-04-12 状态：受控文件 RGx00U&RM500U 系列 DFOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 - 2021-03-23 Neil SHI 文档创建 1.0 2021-04-09 Neil SHI 受控版本 1.1 2021-09-06 Neil SHI 增加适用模块 RG200U-CN。 1.2 2023-04-12 Jeffery JIANG 更新文档适用模块，将 RG500U-CN 更新为 RG500U 系列。 上海移远通信技术股份有限公司 3 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 7 2 DFOTA 固件升级流程 ........................................................................................................................... 8 2.1. 获取差分固件包 .......................................................................................................................... 9 2.2. 将差分包存储至 FTP/HTTP/HTTPS 服务器或本地文件系统 ..................................................... 9 2.3. 检查网络状况.............................................................................................................................. 9 2.4. 执行 AT 命令升级固件 .............................................................................................................. 10 3 DFOTA 相关 AT 命令详解 .................................................................................................................. 11 3.1. AT 命令说明...............................................................................................................................11 3.1.1. 定义 ................................................................................................................................11 3.1.2. AT 命令语句....................................................................................................................11 3.2. AT 示例声明.............................................................................................................................. 12 3.3. AT+QFOTADL 使能 DFOTA 固件升级................................................................................... 12 3.3.1. AT+QFOTADL= 通过 FTP 服务器进行差分升级 .................................... 12 3.3.2. AT+QFOTADL= 通过 HTTP 服务器进行差分升级............................... 14 3.3.3. AT+QFOTADL= 通过 HTTPS 服务器进行差分升级 .......................... 16 3.3.4. AT+QFOTADL= 通过本地文件系统进行差分升级 .................................. 18 4 注意事项 .............................................................................................................................................. 20 5 结果码 ................................................................................................................................................. 21 6 附录 参考文档及术语缩写 .................................................................................................................. 22 上海移远通信技术股份有限公司 4 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 表格索引 表 1：AT 命令类型.......................................................................................................................................11 表 2：值描述............................................................................................................................. 21 表 3：、值描述 ............................................................................................... 21 表 4：值描述 ..................................................................................................................................... 21 表 5：参考文档 ........................................................................................................................................... 22 表 6：术语缩写 ........................................................................................................................................... 22 上海移远通信技术股份有限公司 5 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 图片索引 图 1：DFOTA 固件升级流程......................................................................................................................... 8 上海移远通信技术股份有限公司 6 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 1 引言 固件空中差分升级（DFOTA）功能可以实现模块固件包的无线升级或降级。 移远通信 RG200U-CN、RG500U 系列和 RM500U-CN 模块支持固件空中差分升级（DFOTA）功能。 基于 DFOTA，用户通过差分包即可实现固件升级或降级。所述差分包仅包含当前固件版本和目标固件 版本之间的差异，因此数据传输量大大降低、传输时间大大缩短。 上海移远通信技术股份有限公司 7 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 2 DFOTA 固件升级流程 下图阐述了差分包储存在 FTP/HTTP/HTTPS 服务器上时，通过 DFOTA 升级固件的流程。 2.将差分包放在 FTP/HTTP/HTTPS 服务器上 1.获取差分包 4.通过 5G NR/LTE/WCDMA 网 络从 FTP/HTTP/HTTPS 服务器 自动下载差分包 图 1：DFOTA 固件升级流程 如上图所示，通过 DFOTA 升级固件的步骤如下： 第一步：从移远通信或模块供应商处获取差分包。 第二步：将差分包存到 FTP/HTTP/HTTPS 服务器或者模块本地文件系统。 第三步：执行 AT+QFOTADL。 第四步：模块通过 5G NR/LTE/WCDMA 网络自动从 FTP/HTTP/HTTPS 服务器下载差分包或者在模块 本地文件系统直接升级。 第五步：自动升级固件。 上海移远通信技术股份有限公司 8 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 2.1. 获取差分固件包 升级之前，用户需先通过 ATI 命令获取当前固件版本，同时需明确目标固件版本。然后将当前版本和 目标版本信息发送给移远通信或模块供应商以获取相应的差分包。 2.2. 将差分包存储至 FTP/HTTP/HTTPS 服务器或本地文件系统 差分包存储至 FTP/HTTP/HTTPS 服务器的步骤如下： 第一步：用户需自行搭建 FTP/HTTP/HTTPS 服务器（移远通信不提供此服务器）以便 DFOTA 功能的 使用。 第二步：完成服务器搭建之后，需将差分包存储至 FTP/HTTP/HTTPS 服务器并记录下存储路径。 差分包存储至本地文件系统上的路径固定为/mnt/data/update/update.zip。 备注 若模块通过 5G NR/LTE/WCDMA 网络自动从 FTP/HTTP/HTTPS 服务器下载差分包进行固件升级，文件 路径则不会固定为/mnt/data/update/update.zip。 2.3. 检查网络状况 模块开机后、开始升级之前，请确认模块已注网。模块注网确认相关的 AT 命令如下，详情参考文档 [1]。 ⚫ AT+COPS?：查询网络注册和运营商。 ⚫ AT+CEREG?：查询 EPS 注网状态。 ⚫ AT+CREG?：查询 CS 域注册状态。 ⚫ AT+CGATT?：查询 PS 域附着状态。 ⚫ AT+CGPADDR?：查询默认 PDN 分配的 IP 地址。 ⚫ AT+C5GREG?：查询 5GS 网络注册状态。 ⚫ AT+QNETDEVSTATUS=：查询网卡状态。 上海移远通信技术股份有限公司 9 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 2.4. 执行 AT 命令升级固件 确认网络状态后，执行 AT+QFOTADL，随后模块将从 FTP/HTTP/HTTPS 服务器下载差分包或者从本 地文件系统获取差分包，然后自动升级固件。有关 AT 命令的详细信息，请参考第 3.3 章。 上海移远通信技术股份有限公司 10 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 3 DFOTA 相关 AT 命令详解 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 11 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. AT+QFOTADL 使能 DFOTA 固件升级 差分包被储存至 FTP/HTTP/HTTPS 服务器或者本地文件系统中后，用户可执行 AT+QFOTADL 相关 命令使能模块通过 DFOTA 自动进行固件升级。从服务器成功下载差分包或者从本地文件系统获取到差分包 后，模块将自动进行固件升级并重启。 AT+QFOTADL 使能 DFOTA 固件升级 测试命令 AT+QFOTADL=? 响应 OK 最大响应时间 300 毫秒 特性说明 - 3.3.1. AT+QFOTADL= 通过 FTP 服务器进行差分升级 若差分包存储至 FTP 服务器上，执行 AT+QFOTADL=使能模块通过 DFOTA 自动进行固 件升级。命令执行成功后，模块将自动从 FTP 服务器下载差分包，并自动进行固件升级。 AT+QFOTADL= 通过 FTP 服务器进行差分升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPDL', ... +QIND: 'FOTA','FTPDL', +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','START' 上海移远通信技术股份有限公司 12 / 22 最大响应时间 特性说明 RGx00U&RM500U 系列 DFOTA 应用指导 +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 若有任何错误： ERROR 300 毫秒 - 参数 字符串类型。差分包存储至 FTP 服务器上的 URL 地址，以'ftp://'开头，例如： 'ftp://:@:/'。 最大长度：225；单位：字节。 字符串类型。FTP 登录的用户名身份认证。 最大长度：50；单位：字节。 字符串类型。FTP 登录的密码身份认证。 最大长度：50；单位：字节。 字符串类型。FTP 服务器 IP 地址。最大长度：50；单位：字节。 整型。FTP 服务器端口。范围：1~65535；默认值：21。 字符串类型。差分包在服务器中的路径名称。 最大长度：50；单位：字节。 整型。差分包下载、升级进度的百分比。范围：0~100。 整型。FTP 结果码。 0 从 FTP 服务器下载差分包成功 其他值 从 FTP 服务器下载差分包失败。详细信息请参考表 2 整型。升级结果码。 0 固件升级成功 其他值 固件升级失败。详细信息请参考表 4 举例 //当差分包存储在 FTP 服务器时升级固件。例如，服务器地址为：'ftp://test:test@124.74.41.170:21/upd ate.zip'。执行如下命令将会使能自动通过 DFOTA 进行固件升级，模块将开始下载差分包并自动进行固 件升级。 AT+QFOTADL='ftp://test:test@124.74.41.170:21/update.zip' OK 上海移远通信技术股份有限公司 13 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPDL',1 +QIND: 'FOTA','FTPDL',15 ... +QIND: 'FOTA','FTPDL',100 +QIND: 'FOTA','FTPEND',0 //从 FTP 服务器下载差分包成功。 //模块将自动重启并进入恢复模式，USB 端口将重新初始化。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',20 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启进入正常模式。 //固件升级成功。 3.3.2. AT+QFOTADL= 通过 HTTP 服务器进行差分升级 若差分包存储在 HTTP 服务器上，执行 AT+QFOTADL=使能模块通过 DFOTA 自动进行 固件升级。命令执行成功后，模块将自动从 HTTP 服务器下载差分包，并自动进行固件升级。 AT+QFOTADL= 通过 HTTP 服务器进行差分升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPDL', ... +QIND: 'FOTA','HTTPDL', +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' 上海移远通信技术股份有限公司 14 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 最大响应时间 特性说明 +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 若有任何错误： ERROR 300 毫秒 - 参数 字符串类型。差分包存储至 HTTP 服务器上的 URL 地址，以'http://'开头，例如： 'http://:/'。 最大长度：255；单位：字节。 字符串类型。HTTP 服务器 IP 地址或域名。 整型。HTTP 服务器端口。范围：1~65535；默认值：80。 字符串类型。差分包在服务器中路径名称。 整型。HTTP 结果码。 0 从 HTTP 服务器下载差分包成功 其他值 从 HTTP 服务器下载差分包失败。详细信息请参考表 3 整型。差分包下载、升级进度的百分比。范围：0~100。 整型。升级结果码。 0 固件升级成功 其他值 固件升级失败。详细信息请参考表 4 举例 //当差分包存储在 HTTP 服务器时升级固件。例如，服务器地址为：'http://www.quectel.com:100/updat e.zip'。执行如下命令将会使能自动通过 DFOTA 进行固件升级，模块将开始下载差分包并自动进行固件 升级。 AT+QFOTADL='http://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPDL',1 +QIND: 'FOTA','HTTPDL',15 上海移远通信技术股份有限公司 15 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 ... +QIND: 'FOTA','HTTPDL',100 +QIND: 'FOTA','HTTPEND',0 //从 HTTP 服务器下载差分包成功。 //模块将自动重启并进入恢复模式，USB 端口将重新初始化。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启进入正常模式。 //固件升级成功。 3.3.3. AT+QFOTADL= 通过 HTTPS 服务器进行差分升级 若差分包存储在 HTTPS 服务器上，执行 AT+QFOTADL=使能模块通过 DFOTA 自动 进行固件升级。命令执行成功后，模块将自动从 HTTPS 服务器下载差分包，并自动进行固件升级。 AT+QFOTADL= 通过 HTTPS 服务器进行差分升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','HTTPSSTART' +QIND: 'FOTA','HTTPSDL', ... +QIND: 'FOTA','HTTPSDL', +QIND: 'FOTA','HTTPSEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', 上海移远通信技术股份有限公司 16 / 22 最大响应时间 特性说明 RGx00U&RM500U 系列 DFOTA 应用指导 ... +QIND: 'FOTA','END', 若有任何错误： ERROR 300 毫秒 - 参数 字符串类型。差分包存储至 HTTPS 服务器上的 URL 地址，以'https://'开头，例如： 'https://:/'。 最大长度：255；单位：字节。 字符串类型。HTTPS 服务器 IP 地址或域名。 整型。HTTPS 服务器端口。范围：1~65535；默认值：80。 字符串类型。差分包在服务器中路径名称。 整型。HTTPS 结果码。 0 从 HTTPS 服务器下载差分包成功 其他值 从 HTTPS 服务器下载差分包失败。详细信息请参考表 3 整型。差分包下载、升级进度的百分比。范围：0~100。 整型。升级结果码。 0 固件升级成功 其他值 固件升级失败。详细信息请参考表 4 举例 //当差分包存储在 HTTPS 服务器时升级固件。例如，服务器地址为：'https://www.quectel.com:100/upd ate.zip'。执行如下命令将会使能自动通过 DFOTA 进行固件升级，模块将开始下载差分包并自动进行固 件升级。 AT+QFOTADL='https://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSSTART' +QIND: 'FOTA','HTTPSDL',1 +QIND: 'FOTA','HTTPSDL',20 ... +QIND: 'FOTA','HTTPSDL',100 +QIND: 'FOTA','HTTPSEND',0 //从 HTTPS 服务器下载差分包成功。 上海移远通信技术股份有限公司 17 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 //模块将自动重启并进入恢复模式，USB 端口将重新初始化。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //模块将自动重启进入正常模式。 //固件升级成功。 3.3.4. AT+QFOTADL= 通过本地文件系统进行差分升级 若差分包已经存储至本地文件系统，执行 AT+QFOTADL=使能模块通过 DFOTA 自动进 行固件升级。命令执行成功后，模块将自动从本地系统进行固件升级。 AT+QFOTADL= 通过本地文件系统进行差分升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 - 上海移远通信技术股份有限公司 18 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 参数 字符串类型。差分包存储至本地文件系统上的路径；文件路径固定为 /mnt/data/update/update.zip。最大长度：255；单位：字节。 整型。差分包升级进度的百分比。范围：0~100。 整型。升级结果码。 0 固件升级成功 其他值 固件升级失败。详细信息请参考表 4 举例 //当差分包存储在本地文件系统时升级固件。 AT+QFOTADL='/mnt/data/update/update.zip' OK //模块将自动重启并进入恢复模式，USB 端口将重新初始化。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //固件升级成功。 //模块将自动重启进入正常模式。 上海移远通信技术股份有限公司 19 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 4 注意事项 通过 FTP/HTTP/HTTPS 服务器或在本地文件系统进行差分升级需注意以下两点： 1. 若模块处于'UPDATING'状态时断电，将自动进入强制升级模式，即下次启动时将继续升级。升 级界面如下所示： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',20 +QIND: 'FOTA','UPDATING',30 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 2. 模块进入恢复模式时，首先会校验差分包文件： ⚫ 若差分包出错，URC 将上报错误码，错误码详情请参考第 5 章。 ⚫ 若差分包升级成功，模块将重启并进入正常模式。 ⚫ 若差分包升级失败，模块重启进入恢复模式，重新升级直至升级成功，最多可以连续升级 10 次。 上海移远通信技术股份有限公司 20 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 5 结果码 本章节主要介绍与移远通信模块或网络相关的结果码。有关、、 和的详细信息，请参考以下表格。 表 2：值描述 值 0 601 602 描述 从 FTP 服务器下载差分包成功 FTP 未知错误 FTP 网址长度超出限制 表 3：、值描述 / 值 0 701 702 描述 从 HTTP/HTTPS 服务器下载差分包成功 HTTP/HTTPS 未知错误 HTTP/HTTPS 网址长度超出限制 表 4：值描述 值 0 502 505 510 511 520 描述 DFOTA 升级成功。 未知错误或某些异常导致退出升级程序，或差分包不正确。模块重启进入 恢复模式，重新升级直至升级成功，最多可以连续升级 10 次。 差分包校验失败。Zip 格式检查错误。若 Zip 格式错误，将删除差分包。 差分包与模块当前固件版本不匹配，需检查差分包版本信息是否正确。 升级空间不足。 固件升级失败。模块重启进入恢复模式，重新升级直至升级成功，最多可 以连续升级 10 次。 上海移远通信技术股份有限公司 21 / 22 RGx00U&RM500U 系列 DFOTA 应用指导 6 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_RGx00U&RM500U 系列_AT 命令手册 表 6：术语缩写 缩写 5G NR 5GS CS DFOTA EPS FTP HTTP HTTPS IP LTE MCU PDN PS URC URL USB WCDMA 英文全称 5th Generation New Radio 5G System Circuit Switched Delta Firmware Upgrade Over-The-Air Evolved Packet System File Transfer Protocol Hypertext Transfer Protocol Hypertext Transfer Protocol Secure Internet Protocol Long Term Evolution Microcontroller Unit Public Data Network Packet Switch Unsolicited Result Code Uniform Resource Locator Universal Serial Bus Wideband Code Division Multiple Access 中文全称 第五代移动通信 5G 系统 电路交换 固件空中差分升级 演进型分组系统 文件传输协议 超文本传输协议 超文本传输安全协议 网络协议 长期演进 微型控制单元 公共数据网 分组交换 非请求结果码 统一资源定位符 通用串行总线 宽带码分多址 上海移远通信技术股份有限公司 22 / 22

RGx00U&RM500U 系列 网卡拨号应用指导 5G 模块系列 版本：1.2 日期：2023-07-24 状态：受控文件 RGx00U&RM500U 系列网卡拨号应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 16 RGx00U&RM500U 系列网卡拨号应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 16 RGx00U&RM500U 系列网卡拨号应用指导 文档历史 修订记录 版本 1.0 日期 2020-09-14 2021-06-04 作者 Baron QIAN/ Rami ZHANG Rami ZHANG 1.1 2021-09-06 Rami ZHANG 1.2 2023-07-24 Rami ZHANG 变更表述 文档创建 受控版本 增加适用模块 RG200U-CN。 1. 新 增 多 个 适 用 模 块 ： RG200U-JO 、 RG500U-EA 和 RM500U-EA。 2. 更新 USB&Ethernet 网卡拨号流程图（图 1）。 3. 删除网卡拨号方式 MBIM 的相关内容（第 3.1.1 章）。 4. 更新路由模式与网桥模式的分配网段（图 3、图 4）。 5. 删除 AT 命令章节（第 4 章）。 上海移远通信技术股份有限公司 3 / 16 RGx00U&RM500U 系列网卡拨号应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 2 网卡拨号概述......................................................................................................................................... 8 2.1. 网卡拨号方式及模式................................................................................................................... 8 2.2. 网卡拨号数据通路图................................................................................................................... 9 3 网卡拨号说明....................................................................................................................................... 12 3.1. 配置 USB 网卡.......................................................................................................................... 12 3.1.1. 配置网卡拨号方式及驱动类型 ....................................................................................... 12 3.1.1.1. Windows 系统..................................................................................................... 12 3.1.1.2. Linux 系统........................................................................................................... 12 3.1.2. 配置拨号模式................................................................................................................. 12 3.2. 配置 Ethernet 网卡 ................................................................................................................... 13 3.3. 拨号结果 ................................................................................................................................... 13 3.3.1. Windows 系统................................................................................................................ 13 3.3.2. Linux 系统...................................................................................................................... 14 4 附录 参考文档及术语缩写 .................................................................................................................. 15 上海移远通信技术股份有限公司 4 / 16 RGx00U&RM500U 系列网卡拨号应用指导 表格索引 表 1：参考文档 ........................................................................................................................................... 15 表 2：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 16 RGx00U&RM500U 系列网卡拨号应用指导 图片索引 图 1：USB/Ethernet 网卡拨号...................................................................................................................... 8 图 2：网卡模式数据通路图........................................................................................................................... 9 图 3：路由模式数据通路图......................................................................................................................... 10 图 4：网桥模式数据通路图..........................................................................................................................11 图 5：RNDIS 网卡 ...................................................................................................................................... 13 图 6：Windows 系统查看网卡拨号状态 ..................................................................................................... 14 图 7：Linux 系统查看网卡拨号状态 ........................................................................................................... 14 上海移远通信技术股份有限公司 6 / 16 RGx00U&RM500U 系列网卡拨号应用指导 1 引言 本文档主要介绍如何使用移远通信 RG200U 系列、RG500U 系列和 RM500U 系列模块在支持 Windows 和 Linux 操作系统的上位机分别进行网卡拨号，包括不同网卡拨号方式的拨号方法及模式、拨号结果和网卡 状态查询等。 上海移远通信技术股份有限公司 7 / 16 RGx00U&RM500U 系列网卡拨号应用指导 2 网卡拨号概述 网卡拨号为上位机通过规范定义的标准接口访问无线终端，获取 IP 地址和 DNS 地址，从而进行数据 通信业务。 2.1. 网卡拨号方式及模式 RG200U 系列、RG500U 系列和 RM500U 系列模块支持 USB 网卡拨号和 Ethernet 网卡拨号，两种网 卡对应的拨号模式是相同的；有关 USB 网卡拨号方式，详情请参考第 3.1.1 章。 USB Ethernet RNDIS NCM ECM 网卡模式 路由模式 网桥模式 图 1：USB/Ethernet 网卡拨号 上海移远通信技术股份有限公司 8 / 16 RGx00U&RM500U 系列网卡拨号应用指导 2.2. 网卡拨号数据通路图 在网卡模式、路由模式和网桥模式下，模块和上位机之间可切换使用不同的数据传输协议。三种不同模 式下，模块和上位机之间的数据通道分别如下所示： 图 2：网卡模式数据通路图 上海移远通信技术股份有限公司 9 / 16 RGx00U&RM500U 系列网卡拨号应用指导 192.168.42.x (192.168.42.x) 图 3：路由模式数据通路图 上海移远通信技术股份有限公司 10 / 16 RGx00U&RM500U 系列网卡拨号应用指导 192.168.42.x 192.168.42.1 (192.168.42.2) (192.168.42.3) 图 4：网桥模式数据通路图 备注 1. 网卡模式和路由模式下，若同时连接 USB 和 Ethernet 网卡，仅其中一个网卡可获取 IP 地址。两个 网卡同时使能的情况下，Ethernet 网卡优先获取 IP 地址。 2. 网桥模式下，若同时连接 USB 和 Ethernet 网卡，两个网卡均可获取 IP 地址。 3. 网卡模式下，上位机获取的 IP 地址为核心网获取到的 IP 地址，模块内部可以连接外网。 4. 网桥模式和路由模式下，上位机获取的 IP 地址为模块内部局域网分配的 IP 地址，模块内部可以连 接外网。 上海移远通信技术股份有限公司 11 / 16 RGx00U&RM500U 系列网卡拨号应用指导 3 网卡拨号说明 本章主要介绍 USB 与 Ethernet 网卡拨号上网的步骤。首先，通过 AT+QCFG 进行网卡配置；其次， 通过 AT+QNETDEVCTL 进行拨号上网。拨号成功以后，可通过 AT+QNETDEVSTATUS 查看网卡的状态。 有关 AT 命令的详情，请参考文档 [1]。 3.1. 配置 USB 网卡 3.1.1. 配置网卡拨号方式及驱动类型 3.1.1.1. Windows 系统 执行 AT+QCFG='usbnet',3 配置网卡拨号方式及驱动类型为 RNDIS。 3.1.1.2. Linux 系统 执行 AT+QCFG='usbnet',5 配置网卡拨号方式及驱动类型为 NCM。 或者执行 AT+QCFG='usbnet',1 配置网卡拨号方式及驱动类型为 ECM。 或者执行 AT+QCFG='usbnet',3 配置网卡拨号方式及驱动类型为 RNDIS。 备注 参数配置重启后生效。建议开机时通过 AT+QCFG='usbnet'查询当前配置。若当前配置和期望不同， 可按上述方法进行配置并重启模块。 3.1.2. 配置拨号模式 执行 AT+QCFG='nat',0 配置拨号模式为网卡模式。 或者执行 AT+QCFG='nat',1 配置拨号模式为路由模式。 或者执行 AT+QCFG='nat',2 配置拨号模式为网桥模式。 上海移远通信技术股份有限公司 12 / 16 RGx00U&RM500U 系列网卡拨号应用指导 备注 参数配置重启后生效。建议开机时通过 AT+QCFG='nat'查询当前配置；若当前配置和期望不同，可按 上述方法进行配置并重启模块。 3.2. 配置 Ethernet 网卡 模块支持通过 AT 命令开启或关闭 Ethernet 网卡，且默认开启。 执行 AT+QCFG='ethernet',1 开启 Ethernet 网卡。 或者执行 AT+QCFG='ethernet',0 关闭 Ethernet 网卡。 备注 参数配置重启后生效。建议开机时通过 AT+QCFG='ethernet'查询当前配置；若当前配置和期望不同， 可按上述方法进行配置并重启模块。 3.3. 拨号结果 拨号成功以后，上位机创建相应的网卡，可通过查看网卡的状态获取拨号结果。 3.3.1. Windows 系统 以 Windows 7 系统为例，进入主机系统'控制面板'，选择'网络和 Internet'，然后选择已创建的 RNDIS 网卡，点击查看拨号状态。 图 5：RNDIS 网卡 上海移远通信技术股份有限公司 13 / 16 RGx00U&RM500U 系列网卡拨号应用指导 图 6：Windows 系统查看网卡拨号状态 3.3.2. Linux 系统 在上位机执行 ifconfig 查看当前网卡 IP 地址，如下图： 图 7：Linux 系统查看网卡拨号状态 上海移远通信技术股份有限公司 14 / 16 RGx00U&RM500U 系列网卡拨号应用指导 4 附录 参考文档及术语缩写 表 1：参考文档 文档名称 [1] Quectel_RGx00U&RM500U 系列_AT 命令手册 表 2：术语缩写 缩写 AP APN CHAP Connman CP DHCP DNS ECM ID IP IPv4 IPv6 NCM PAP PCIe 英文全称 中文全称 Application Processor 应用处理器 Access Point Name 接入点名称 Challenge Handshake Authentication Protocol 挑战握手认证协议 Connection Manager 连接管理器 Cellular Processor 基带芯片加协处理器 Dynamic Host Configuration Protocol 动态主机设置协议 Domain Name System 域名系统（服务）协议 Ethernet Networking Control Model 以太网控制模型 Identifier 标识符 Internet Protocol 网际互连协议 Internet Protocol version 4 互联网通信协议第四版 Internet Protocol version 6 互联网通信协议第六版 Network Control Model 网络控制模型 Password Authentication Protocol 口令认证协议 Peripheral Component Interconnect express 快捷外围部件互连标准 上海移远通信技术股份有限公司 15 / 16 PDP RNDIS USB RGx00U&RM500U 系列网卡拨号应用指导 Packet Data Protocol 分组数据协议 Remote Network Driver Interface Specification 远程网络驱动程序接口规范 Universal Serial Bus 通用串行总线 上海移远通信技术股份有限公司 16 / 16

RGx00U&RM500U 系列 低功耗休眠应用指导 5G 模块系列 版本：1.2 日期：2023-04-13 状态：受控文件 RGx00U&RM500U 系列低功耗休眠应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 文档历史 修订记录 版本 日期 - 2020-11-26 1.0 2021-04-30 1.1 2021-09-06 1.2 2023-04-13 作者 变更表述 Achang ZHANG 文档创建 Achang ZHANG 受控版本 Achang ZHANG Achang ZHANG 增加适用模块 RG200U-CN。 1. 更新文档适用模块，将 RG500U-CN 更新为 RG500U 系列。 2. 更新低功耗休眠框架图（图 1）。 3. 新增备注（第 2.1 章）。 上海移远通信技术股份有限公司 3 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 2 低功耗休眠应用说明............................................................................................................................... 8 2.1. 低功耗休眠框架 ........................................................................................................................... 8 3 AT 命令详解 ........................................................................................................................................... 9 3.1. AT 命令说明................................................................................................................................. 9 3.1.1. 定义 .................................................................................................................................. 9 3.1.2. AT 命令语句...................................................................................................................... 9 3.2. AT 示例声明............................................................................................................................... 10 3.3. AT+QSCLK 控制模块进入休眠模式........................................................................................ 10 4 附录 术语缩写...................................................................................................................................... 11 上海移远通信技术股份有限公司 4 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 9 表 2：术语缩写 ............................................................................................................................................11 上海移远通信技术股份有限公司 5 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 图片索引 图 1：低功耗休眠框架 .................................................................................................................................. 8 上海移远通信技术股份有限公司 6 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 1 引言 本文档介绍了移远通信 RG200U-CN、RG500U 系列和 RM500U-CN 模块低功耗休眠应用说明及相关 AT 命令。 上海移远通信技术股份有限公司 7 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 2 低功耗休眠应用说明 2.1. 低功耗休眠框架 以 RG500U 系列模块为例，低功耗休眠的框架如下图所示： 语音 RG500U 唤醒源 数据 SMS 图 1：低功耗休眠框架 备注 1. 语音、数据和 SMS 事件可将模块从休眠状态下唤醒。 2. SLEEP_IND 引脚为高电平时，指示模块已进入休眠；SLEEP_IND 引脚为低电平时，指示模块已被 唤醒。 3. 若通过 AT+QSCLK=1（详见第 3.3 章）使能模块进入休眠模式且无其他唤醒源时，主控拉高 DTR 引脚，模块进入休眠；主控拉低 DTR 引脚，模块将被唤醒。 上海移远通信技术股份有限公司 8 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 3 AT 命令详解 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 设置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见，也不 代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或连续 性。 3.3. AT+QSCLK 控制模块进入休眠模式 该命令用于启用或禁用模块进入休眠模式。 AT+QSCLK 控制模块进入休眠模式 测试命令 AT+QSCLK=? 响应 +QSCLK: (支持的列表) 查询命令 AT+QSCLK? OK 响应 +QSCLK: 设置命令 AT+QSCLK= 最大响应时间 特性说明 OK 响应 OK 300 毫秒 - 参数 整型。禁用或启用低功耗休眠模式。 0 禁用低功耗休眠模式 1 启用低功耗休眠模式 备注 1. AT+QSCLK=1 使能模块进入休眠模式。对于 RG200U-CN 和 RG500U 系列来说，若 DTR 引脚为高 电平，模块进入休眠；若 DTR 引脚为低电平，模块将被唤醒；对于 RM500U-CN 来说，若 WAKEUP_IN 引脚为低电平，模块进入休眠；若 WAKEUP_IN 引脚为高电平，模块将被唤醒。 2. AT+QSCLK=0 禁用模块进入休眠模式。此条件下，模块将永远不会进入休眠。 上海移远通信技术股份有限公司 10 / 11 RGx00U&RM500U 系列低功耗休眠应用指导 4 附录 术语缩写 表 2：术语缩写 缩写 DTR LED SMS 英文全称 Data Terminal Ready Light Emitting Diode Short Message Service 中文全称 数据终端就绪 发光二级管 短消息业务 上海移远通信技术股份有限公司 11 / 11

LTE-A(Q) 系列 GNSS 应用指导 LTE-A 模块系列 版本：1.0 日期：2021-11-24 状态：受控文件 LTE-A(Q)系列 GNSS 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同 时，您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分 析、评估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同 意，尽管移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可 用'基础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 46 LTE-A(Q)系列 GNSS 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问 性、安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 2 / 46 LTE-A(Q)系列 GNSS 应用指导 文档历史 修订记录 版本 1.0 日期 2021-11-11 2021-11-24 作者 Remy SHI/ Don XU Remy SHI/ Don XU 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 46 LTE-A(Q)系列 GNSS 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 1.2. 打开/关闭 GNSS 步骤.................................................................................................................. 8 1.3. 支持的 NMEA 语句类型............................................................................................................... 8 1.4. XTRA 辅助技术简介 .................................................................................................................... 9 2 GNSS 相关 AT 命令 ............................................................................................................................. 11 2.1. AT 命令说明............................................................................................................................... 11 2.1.1. 定义 ................................................................................................................................ 11 2.1.2. AT 命令语句.................................................................................................................... 11 2.2. AT 示例声明............................................................................................................................... 12 2.3. AT 命令详解............................................................................................................................... 12 2.3.1. AT+QGPSCFG 配置 GNSS .......................................................................................... 12 2.3.1.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 ....................................... 13 2.3.1.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 ............................................................................................................................ 13 2.3.1.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 ................ 14 2.3.1.4. AT+QGPSCFG='glonassnmeatype' 配置 GLONASS 或 GNSS 组合系统 NMEA 语句输出类型 ........................................................................................................................ 15 2.3.1.5. AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 ........ 16 2.3.1.6. AT+QGPSCFG='beidounmeatype' 配置 BeiDou 和 QZSS NMEA 语句的输出类 型 ............................................................................................................................ 17 2.3.1.7. AT+QGPSCFG='gnssconfig' 配置启用的 GNSS 卫星导航系统 ...................... 19 2.3.1.8. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 ........................................ 20 2.3.1.9. AT+QGPSCFG='dpoenable' 启用/禁用 DPO 模式 .......................................... 21 2.3.1.10. AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 ........................ 21 2.3.1.11. AT+QGPSCFG='suplver' 配置 SUPL 协议版本 ............................................... 22 2.3.1.12. AT+QGPSCFG='lbsapn' 配置 LBS APN.......................................................... 23 2.3.1.13. AT+QGPSCFG='agpsposmode' 配置 AGNSS 定位模式................................. 24 2.3.1.14. AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议................................. 25 2.3.1.15. AT+QGPSCFG='multibandconfig' 配置 GNSS 多频段 .................................... 26 2.3.2. AT+QGPSDEL 删除辅助数据 ....................................................................................... 27 2.3.3. AT+QGPS 打开 GNSS.................................................................................................. 28 2.3.4. AT+QGPSEND 关闭 GNSS .......................................................................................... 30 2.3.5. AT+QGPSLOC 获取定位信息 ....................................................................................... 30 2.3.6. AT+QGPSGNMEA 获取 NMEA 语句 ............................................................................ 32 2.3.7. AT+QGPSXTRA 启用/禁用 XTRA 辅助功能 ................................................................. 34 2.3.8. AT+QGPSXTRATIME 注入 XTRA 时间........................................................................ 35 上海移远通信技术股份有限公司 4 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.9. AT+QGPSXTRADATA 注入 XTRA 数据文件................................................................ 36 2.3.10. AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL ...................................................... 38 2.3.11. AT+QGPSSUPLCA 导入 SUPL 证书............................................................................ 39 3 举例 ...................................................................................................................................................... 40 3.1. 打开与关闭 GNSS ..................................................................................................................... 40 3.2. GNSS 参数的应用 ............................................................................................... 40 3.3. XTRA 辅助功能的操作步骤 ....................................................................................................... 41 3.4. AGNSS 功能的操作步骤 ........................................................................................................... 41 4 错误代码 ............................................................................................................................................... 43 5 附录 参考文档及术语缩写 .................................................................................................................... 44 上海移远通信技术股份有限公司 5 / 46 LTE-A(Q)系列 GNSS 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型 ..................................................................................................................................... 11 表 3：PQGSV 和 PQGSA 语句格式定义.................................................................................................... 18 表 4：错误代码列表.................................................................................................................................... 43 表 5：参考文档 ........................................................................................................................................... 44 表 6：术语缩写 ........................................................................................................................................... 44 上海移远通信技术股份有限公司 6 / 46 LTE-A(Q)系列 GNSS 应用指导 1 引言 移 远 通信 LTE-A(Q)系列模 块 内部 集成 GNSS 引擎 ， 支持 GPS、 BeiDou、 QZSS、 Galileo 和 GLONASS 系统以及 XTRA（即 gpsOneXTRA）辅助技术。高性能 GNSS 引擎适用于各类有低成本、精 确定位需求的应用场景，并支持在无需任何网络协助下进行位置跟踪。这使移远通信 LTE-A(Q)系列模块 广泛应用于如下领域：逐向导航、资产跟踪、人员跟踪、位置感知游戏以及家庭和车队管理。 1.1. 适用模块 表 1：适用模块 模块系列 LTE-A(Q) 模块 EG06 系列 EM06 系列 EP06 系列 EG060K-EA EG120K-EA EM060K-GL EG12 系列 EM12-G EG18 系列 EM120R-GL EM121R-GL EM160R-GL EG512R-EA 上海移远通信技术股份有限公司 7 / 46 LTE-A(Q)系列 GNSS 应用指导 1.2. 打开/关闭 GNSS 步骤 LTE-A(Q)系列模块的 GNSS 支持位置计算功能，且无需网络协助。打开/关闭 GNSS 的步骤如下： 步骤 1：通过 AT+QGPSCFG 配置 GNSS 参数。 步骤 2：通过 AT+QGPS 打开 GNSS。 步骤 3：打开 GNSS，定位成功后，可通过以下三种方式获取定位信息： 1) NMEA 语句默认输出至'usbnmea'端口，可以通过读取该端口获取 NMEA 语句。 2) 通过 AT+QGPSLOC 可直接获取定位信息，例如纬度、经度、高度、GNSS 定位模 式、时间、卫星数量等。 3) 通 过 设 置 AT+QGPSCFG='nmeasrc',1 启 用 通 过 AT+QGPSGNMEA 获 取 指 定 的 NMEA 语 句 。 如 果 设 置 AT+QGPSCFG='nmeasrc',0 ， 则 不 能 通 过 AT+QGPSGNMEA 获取指定的 NMEA 语句。 步骤 4：执行 AT+QGPSEND 关闭 GNSS。 1.3. 支持的 NMEA 语句类型 模块默认支持的 NMEA 语句与 NMEA 0183 协议兼容。可以通过五种前缀区分不同卫星系统的 NMEA 语句，如下所示： GNSS 组合系统 NMEA 语句的前缀为'GN'，如下所示： ⚫ GNGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GNGNS - GNSS 定位数据 GPS NMEA 语句的前缀为'GP'，如下所示： ⚫ GPGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GPRMC - 推荐的最小具体 GNSS 数据 ⚫ GPGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ GPGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GPVTG - 对地航向与对地速度 GLONASS NMEA 语句的前缀为'GL'，如下所示： ⚫ GLGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 Galileo NMEA 语句的前缀为'GA'，如下所示： ⚫ GAGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GARMC - 推荐的最小具体 GNSS 数据 ⚫ GAGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ GAGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 上海移远通信技术股份有限公司 8 / 46 LTE-A(Q)系列 GNSS 应用指导 ⚫ GAVTG - 对地航向与对地速度 BeiDou NMEA 语句的前缀为'PQ'，如下所示： ⚫ PQGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ PQGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 QZSS NMEA 语句的前缀为'PQ'，如下所示： ⚫ PQGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ PQGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 备注 1. LTE-A(Q)系列模块 BeiDou 和 QZSS NMEA 语句的前缀均为'PQ'，是基于 NMEA 0183 V4.10 协议 的拓展语句。 2. 对于 EG06、EM06 和 EP06 系列模块，其 Galileo NMEA 语句仅支持 GAGSV。 1.4. XTRA 辅助技术简介 XTRA 辅助技术能够提高 GNSS 的性能，提供简化的 GNSS 辅助，包括对 GNSS 引擎的星历、年 历、电离层、UTC、健康和粗略时间的辅助。激活 XTRA 辅助后，首次定位时间（TTFF）可减少 18~30 秒（信号弱的恶劣环境下减少更多）。从 XTRA 辅助网络服务器获取的辅助数据需在过期前及时更新。 使用此功能前，首先请确保有效的 XTRA 辅助数据的可用性，需要从如下所列的 URL 地址中下载一 份新的 XTRA 二进制文件，文件中包含某个 XTRA 辅助网络服务器的数据。 ⚫ GPS + GLONASS 系统的数据文件后缀名为'xtra2.bin'： http://xtrapath4.izatcloud.net/xtra2.bin http://xtrapath5.izatcloud.net/xtra2.bin http://xtrapath6.izatcloud.net/xtra2.bin ⚫ GPS + GLONASS + BeiDou 系统的数据文件后缀名为'xtra3grc.bin'： http://xtrapath4.izatcloud.net/xtra3grc.bin http://xtrapath5.izatcloud.net/xtra3grc.bin http://xtrapath6.izatcloud.net/xtra3grc.bin ⚫ GPS + GLONASS + BeiDou + Galileo 系统的数据文件后缀名为'xtra3grcej.bin'： http://xtrapath4.izatcloud.net/xtra3grcej.bin http://xtrapath5.izatcloud.net/xtra3grcej.bin http://xtrapath6.izatcloud.net/xtra3grcej.bin 上海移远通信技术股份有限公司 9 / 46 LTE-A(Q)系列 GNSS 应用指导 备注 本文的适用模块仅部分型号支持后缀名为'xtra3grcej.bin'的 GPS + GLONASS + BeiDou + Galileo 系统 数据文件。详细信息请联系移远通信技术支持。 XTRA 辅助数据需定期更新。在更新 XTRA 辅助数据之前，可通过 AT+QGPSXTRADATA?查询 XTRA 数据文件的状态。 XTRA 辅助功能的操作步骤如下： 步骤 1：对于 EG06、EM06 和 EP06 系列模块，默认禁用 XTRA 辅助功能；其他适用模块，默认启 用 XTRA 辅助功能。若禁用了该功能，可通过 AT+QGPSXTRA=1 开启。 步骤 2：通过 AT+QGPSXTRADATA?查询并确认 XTRA 数据文件当前的有效性。如果数据无效，请 执行步骤 3~步骤 6；如果数据有效，请根据第 1.2 章所述步骤直接打开 GNSS 引擎。 步骤 3：根据上述所列的 URL 地址，将文件名后缀为'xtra2.bin'或'xtra3grc.bin'或'xtra3grcej.bin'的文 件下载到模块。 步骤 4：通过 AT+QGPSXTRATIME 向 GNSS 引擎注入正确的 XTRA 时间。 步骤 5：通过 AT+QGPSXTRADATA 向 GNSS 引擎注入有效的 XTRA 数据文件。 步骤 6：根据第 1.2 章所述步骤打开 GNSS 引擎。 备注 1. 步骤 1 开始之前，需要确保已经关闭 GNSS 引擎。 2. 有关上述 AT 命令的详细信息，可参考第 2.3.7、2.3.8 及 2.3.9 章。 上海移远通信技术股份有限公司 10 / 46 LTE-A(Q)系列 GNSS 应用指导 2 GNSS 相关 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说 明，配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 11 / 46 LTE-A(Q)系列 GNSS 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意 见，也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接 关系或连续性。 2.3. AT 命令详解 2.3.1. AT+QGPSCFG 配置 GNSS 该命令用于查询和配置 GNSS 不同的设置，包括 NMEA 语句输出端口、NMEA 语句的输出类型等。 AT+QGPSCFG 配置 GNSS 测试命令 AT+QGPSCFG=? 响应 +QGPSCFG: 'outport',(支持的列表) +QGPSCFG: 'nmeasrc',(支持的列表) +QGPSCFG: 'gpsnmeatype',(支持的范围) +QGPSCFG: 'glonassnmeatype',(支持的范围) +QGPSCFG: 'galileonmeatype',(支持的范围) +QGPSCFG: 'beidounmeatype',(支持的范围) +QGPSCFG: 'gnssconfig',(支持的范围) +QGPSCFG: 'autogps',(支持的列表) +QGPSCFG: 'dpoenable',(支持的范围) +QGPSCFG: 'plane',(支持的范围) +QGPSCFG: 'suplver',(支持的范围) +QGPSCFG: 'lbsapn',(支持的范围),(支持的范围), +QGPSCFG: 'agpsposmode',(支持的范围) +QGPSCFG: 'agnssprotocol',(支持的范围),(支持的范围) +QGPSCFG：'multibandconfig',(支持的范围) OK 备注 仅部分型号模块支持通过 AT 命令配置 GNSS 多频段。请联系移远通信技术支持获取详细信息。 上海移远通信技术股份有限公司 12 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.1.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 该命令用于配置 NMEA 语句输出端口。 AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 设置命令 AT+QGPSCFG='outport'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'outport', 最大响应时间 特性说明 OK 若指定可选参数，则配置 NMEA 语句输出端口： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 字符串类型。配置 NMEA 语句输出端口。 'none' 关闭 NMEA 语句输出 'usbnmea' 通过 USB NMEA 口输出 'uartdebug' 通过调试串口输出 操作错误码。详细信息可参考第 4 章。 2.3.1.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 该命令用于启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 设置命令 AT+QGPSCFG='nmeasrc'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'nmeasrc', OK 上海移远通信技术股份有限公司 13 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 若指定可选参数，则配置是否启用通过 AT+QGPSGNMEA 获 取 NMEA 语句： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整 型 。 启 用 / 禁 用 通 过 AT+QGPSGNMEA 获 取 NMEA 语 句 。 使 能 后 ， 执 行 AT+QGPSGNMEA，NMEA 语句将以命令返回值的形式通过 AT 口输出。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 2.3.1.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 该命令用于配置 GPS NMEA 语句的输出类型。 AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='gpsnmeatype'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gpsnmeatype', 最大响应时间 OK 若指定可选参数，则配置 GPS NMEA 语句的输出类型： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 14 / 46 LTE-A(Q)系列 GNSS 应用指导 特性说明 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。设置输出的 GPS NMEA 语句类型。取值为异或运算格式。 0 禁用 1 GPGGA 2 GPRMC 4 GPGSV 8 GPGSA 16 GPVTG 31 输出全部 5 种类型语句 操作错误码。详细信息可参考第 4 章。 2.3.1.4. AT+QGPSCFG='glonassnmeatype' 配置 GLONASS 或 GNSS 组合系统 NMEA 语句输出类 型 该命令用于配置 GLONASS 或 GNSS 组合系统 NMEA 语句的输出类型。 AT+QGPSCFG='glonassnmeatype' 配置 GLONASS 或 GNSS 组合系统 NMEA 语句输 出类型 设置命令 AT+QGPSCFG='glonassnmeatype'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'glonassnmeatype', 最大响应时间 特性说明 OK 若指定可选参数，则配置 GLONASS 或 GNSS 组合系统 NMEA 语句的输出类型： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 15 / 46 LTE-A(Q)系列 GNSS 应用指导 参数 整型。设置输出的 GLONASS 或 GNSS 组合系统 NMEA 语句 类型。取值为异或运算格式。 0 禁用 1 GLGSV 2 GNGSA 4 GNGNS 操作错误码。详细信息可参考第 4 章。 2.3.1.5. AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 该命令用于配置 Galileo NMEA 语句的输出类型。 AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 设置命令 AT+QGPSCFG='galileonmeatype'[,< Galileo_NMEA_type>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'galileonmeatype', OK 若指定可选参数，则配置 Galileo NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。设置输出的 Galileo NMEA 语句类型。取值为异或运算格式。 对于 EG06、EM06 和 EP06 系列模块，支持的参数取值如下： 0 禁用 1 GAGSV 对于其他适用模块，支持的参数取值如下： 0 禁用 1 GAGGA 上海移远通信技术股份有限公司 16 / 46 LTE-A(Q)系列 GNSS 应用指导 2 GARMC 4 GAGSV 8 GAGSA 16 GAVTG 操作错误码。详细信息可参考第 4 章。 2.3.1.6. AT+QGPSCFG='beidounmeatype' 配置 BeiDou 和 QZSS NMEA 语句的输出类型 该命令用于配置 BeiDou 和 QZSS NMEA 语句的输出类型。 AT+QGPSCFG='beidounmeatype' 配置 BeiDou 和 QZSS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='beidounmeatype'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'beidounmeatype', 最大响应时间 特性说明 OK 若指定可选参数，则配置 BeiDou 和 QZSS NMEA 语句的输出 类型： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。设置输出的 BeiDou 和 QZSS NMEA 语句类型。取值为异或运算格 式。 0 禁用 1 PQGSA 2 PQGSV 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 17 / 46 LTE-A(Q)系列 GNSS 应用指导 备注 该 命 令 配 置 BeiDou NMEA 语 句 输 出 类 型 时 ， 会 同 时 配 置 QZSS NMEA 语 句 输 出 类 型 ， 如 AT+QGPSCFG='beidounmeatype',1 表 示 同 时 配 置 BeiDou 和 QZSS NMEA 语 句 输 出 类 型 为 PQGSA。 表 3：PQGSV 和 PQGSA 语句格式定义 语句类型 PQGSV PQGSA 格式定义 $PQGSV,,,,,,,,...,, ,,,,* $PQGSA,,,,…,,,,,< SysID>* 参数 语句总条数。范围：1~9。 当前语句编号。范围：1~9。 可见卫星总数。范围：0~36。 卫星识别码。 仰角。最大 90°。 方位角。范围：000°~359°。 信噪比 C/N0。范围：00~99；单位：dB-Hz。不跟踪时为空。 信号识别码。0 表示所有信号。 系统识别码。 4 BeiDou 5 QZSS 校验和。 定位模式一。 M 手动模式，强制 2D 或 3D 定位； A 自动模式，自动切换 2D 或 3D 定位。 定位模式二。 1 未定位； 2 2D 定位； 3 3D 定位。 位置精度因子。 水平精度因子。 垂直精度因子。 上海移远通信技术股份有限公司 18 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.1.7. AT+QGPSCFG='gnssconfig' 配置启用的 GNSS 卫星导航系统 该命令用于配置模块启用的 GNSS 卫星导航系统。 AT+QGPSCFG='gnssconfig' 配置启用的 GNSS 卫星导航系统 设置命令 AT+QGPSCFG='gnssconfig'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gnssconfig', 最大响应时间 特性说明 OK 若省略可选参数，则配置启用的 GNSS 卫星导航系统： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。启用的 GNSS 卫星导航系统。GPS 始终打开。 0 关闭 GLONASS/关闭 BeiDou 和 QZSS/关闭 Galileo 1 打开 GLONASS/打开 BeiDou 和 QZSS/打开 Galileo 2 打开 GLONASS/打开 BeiDou 和 QZSS/关闭 Galileo 3 打开 GLONASS/关闭 BeiDou 和 QZSS/打开 Galileo 4 打开 GLONASS/关闭 BeiDou 和 QZSS/关闭 Galileo 5 关闭 GLONASS/打开 BeiDou 和 QZSS/打开 Galileo 6 关闭 GLONASS/关闭 BeiDou 和 QZSS/打开 Galileo 7 关闭 GLONASS/打开 BeiDou 和 QZSS/关闭 Galileo 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 19 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.1.8. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 该命令用于配置在设备重启时，是否自动运行 GNSS。 AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 设置命令 AT+QGPSCFG='autogps'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'autogps', 最大响应时间 特性说明 OK 若指定可选参数，则配置是否启用 GNSS 自启动： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。模块开机后，启用/禁用 GNSS 自启动。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 备注 GNSS 只能以独立模式自启动。 上海移远通信技术股份有限公司 20 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.1.9. AT+QGPSCFG='dpoenable' 启用/禁用 DPO 模式 该命令用于启用/禁用 DPO 模式。 AT+QGPSCFG='dpoenable' 启用/禁用 DPO 模式 设置命令 AT+QGPSCFG='dpoenable'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'dpoenable', 最大响应时间 特性说明 OK 若指定可选参数，则启用/禁用 DPO 模式： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。启用/禁用 DPO。 0 禁用 DPO 1 使用动态占空比启用 DPO 2 仅在模块未连接外部电源（未依靠电池运行）时，启用 DPO 操作错误码。详细信息可参考第 4 章。 2.3.1.10.AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 该命令用于配置 MO AGPS 会话要使用的平面模式（控制平面或用户平面）。 AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 设置命令 AT+QGPSCFG='plane'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'plane', OK 上海移远通信技术股份有限公司 21 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 若指定可选参数，则配置 MO AGPS 会话使用的平面模式： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。MO AGPS 会话使用的平面模式。 0 无 SSL 的用户平面 1 具有 SSL 的用户平面 2 控制平面 操作错误码。详细信息可参考第 4 章。 2.3.1.11.AT+QGPSCFG='suplver' 配置 SUPL 协议版本 该 命 令 用 于 在 SI（ SET Initiated ， 用 户 发 起 ） 会 话 中 配 置 SUPL 版 本 ， 以 及 在 NI （ Network Initiated，网络发起）会话中配置最可能使用的 SUPL 版本。 AT+QGPSCFG='suplver' 配置 SUPL 协议版本 设置命令 AT+QGPSCFG='suplver'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'suplver', OK 若指定可选参数，则配置 SUPL 协议版本： OK 或者 ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 22 / 46 LTE-A(Q)系列 GNSS 应用指导 特性说明 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。SUPL 协议版本。 1 SUPL V1.0 2 SUPL V2.0 3 SUPL V2.0.2 操作错误码。详细信息可参考第 4 章。 2.3.1.12.AT+QGPSCFG='lbsapn' 配置 LBS APN 该命令用于配置 LBS APN。 AT+QGPSCFG='lbsapn' 配置 LBS APN 设置命令 AT+QGPSCFG='lbsapn'[,,,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'lbsapn',,, OK 若指定可选参数，则配置 LBS APN： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。异或运算格式的 LBS APN 使用的服务系统。范围：0~31。 0 禁用 1 CDMA 2 HDR 4 GSM 8 WCDMA 上海移远通信技术股份有限公司 23 / 46 16 LTE 整型。LBS APN 配置文件的 PDP 类型。 0 禁用 1 IPv4 2 IPv6 3 IPv4v6 4 PPP 字符串类型。接入点名称。 操作错误码。详细信息可参考第 4 章。 LTE-A(Q)系列 GNSS 应用指导 2.3.1.13.AT+QGPSCFG='agpsposmode' 配置 AGNSS 定位模式 该命令用于配置 AGNSS 定位模式。 AT+QGPSCFG='agpsposmode' 配置 AGNSS 定位模式 设置命令 AT+QGPSCFG='agpsposmode'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'agpsposmode', OK 若指定可选参数，则配置 AGNSS 定位模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。AGNSS 定位模式。不同 bit 位代表不同模式，详细信息可见下图。仅 bit 16 与启用 SUPL-MSB 自主回退相关。bit 位设置为 1 即启用相应模式。范围： 0~33554431；默认值：33488767 或 775。 上海移远通信技术股份有限公司 24 / 46 LTE-A(Q)系列 GNSS 应用指导 操作错误码。详细信息可参考第 4 章。 备注 当插入中国联通/中国电信/中国移动(U)SIM 卡时，的默认值为 775；当插入其他卡 时，的默认值为 33488767。 2.3.1.14.AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议 该命令用于配置 AGPS LPP 定位协议和 AGLONASS 定位协议。 AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议 设置命令 AT+QGPSCFG='agnssprotocol'[, ,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'agnssprotocol',, OK 若指定可选参数，则配置 AGPS LPP 定位协议和 AGLONASS 定 位协议： OK 上海移远通信技术股份有限公司 25 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。AGPS LPP 定位协议。异或运算格式。 0 禁用所有 1 用户平面 LPP 2 控制平面 LPP 3 用户平面 LPP 和控制平面 LPP 整型。AGLOSNASS 定位协议。异或运算格式。默认值：1286。 0 禁用所有 1 控制平面 RRLP 2 控制平面 RRC 4 控制平面 LPP 256 用户平面 RRLP 1024 用户平面 LPP 操作错误码。详细信息可参考第 4 章。 2.3.1.15.AT+QGPSCFG='multibandconfig' 配置 GNSS 多频段 该命令用于配置 GNSS 多频段。 AT+QGPSCFG='multibandconfig' 配置 GNSS 多频段 设置命令 AT+QGPSCFG='multibandconfig',[< multiband>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'multibandconfig', OK 若指定可选参数省，则配置 GNSS 多频段： OK 或者 ERROR 上海移远通信技术股份有限公司 26 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。在 L1 基础上设置的 GNSS 多频段。异或运算格式。bit 位设置为 1 表示启用 相应频段，设置为 0 表示关闭相应频段。 0 禁用 1 GPS L5 2 Galileo E5a 4 BeiDou B2a 操作错误码。详细信息可参考第 4 章。 备注 仅部分型号模块支持通过 AT 命令配置 GNSS 多频段。请联系移远通信技术支持获取详细信息。 2.3.2. AT+QGPSDEL 删除辅助数据 该命令用于删除辅助数据，以便进行 GNSS 冷启动、热启动和温启动操作，且仅可在 GNSS 关闭时 执行。使用该命令删除辅助数据后，可通过 AT+QGPS 强制对 GNSS 进行冷启动。满足相应的条件时， 也可以进行热/温启动。 AT+QGPSDEL 删除辅助数据 测试命令 AT+QGPSDEL=? 响应 +QGPSDEL: (支持的范围) 设置命令 AT+QGPSDEL= OK 响应 OK 或者 ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 27 / 46 LTE-A(Q)系列 GNSS 应用指导 特性说明 / 参数 整型。将要删除的 GNSS 辅助数据类型。 0 删除所有辅助数据。开启 GNSS 后，强制冷启动。 1 不删除数据。开启 GNSS 后，条件允许时进行热启动。 2 删除部分相关数据。开启 GNSS 后，条件允许时进行温启动。 3 删除注入 GNSS 引擎的 XTRA 辅助数据。 操作错误码。详细信息可参考第 4 章。 2.3.3. AT+QGPS 打开 GNSS 该命令用于打开 GNSS 功能。 AT+QGPS 打开 GNSS 测试命令 AT+QGPS=? 响应 EG06、EM06 和 EP06 系列模块： +QGPS: ( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围),(支持的范围),(支持的范围) OK 其他适用模块： +QGPS: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围),(支持的 范围) OK 查询命令 查询当前 GNSS 会话状态 AT+QGPS? 响应 +QGPS: OK 设置命令 EG06、EM06 和 EP06 系列模块 AT+QGPS=[,[,[,[,]]]] ERROR 若错误与 ME 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 28 / 46 LTE-A(Q)系列 GNSS 应用指导 设置命令 其他适用模块 AT+QGPS=[,[,[,]]] 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。GNSS 状态。 0 GNSS 关闭 1 GNSS 打开 整型。GNSS 工作模式。 1 独立模式 2 MSB 3 MSA 4 快速定位 整型。最长定位时间，包括测量 GNSS 伪距期间的反应时间、GNSS 卫星搜 索的时间上限、解调星历数据的时间以及计算位置的时间。范围：1~255；默 认值：30；单位：秒。 整型。定位精度阈值。范围：1~1000；默认值：50；单位：米。 整型。平面位置精度水平。 1 低精度水平 2 中等精度水平 3 高精度水平 整型。尝试定位的次数。范围：0~1000；默认值：0；0 表示连续定位，非零 值表示尝试定位的实际次数。 整型。每次定位的时间间隔。范围：1~65535；默认值：1；单位：秒。 整型。每次定位的时间间隔。范围：100~65535；默认值：1000；单位：毫 秒。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 29 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.4. AT+QGPSEND 关闭 GNSS 该命令用于关闭 GNSS 功能。 AT+QGPSEND 关闭 GNSS 测试命令 AT+QGPSEND=? 执行命令 AT+QGPSEND 响应 OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 操作错误码。详细信息可参考第 4 章。 2.3.5. AT+QGPSLOC 获取定位信息 该命令用于获取定位信息。执行该命令前，必须通过 AT+QGPS 打开 GNSS。如果定位失败，将根据 对应情况返回+CME ERROR: 。 AT+QGPSLOC 获取定位信息 测试命令 AT+QGPSLOC=? 响应 +QGPSLOC: ,,,,,(支持的列表),,,,,< nsat> 设置命令 AT+QGPSLOC= OK 响应 +QGPSLOC: ,,,,,,,,,, OK 或者 ERROR 上海移远通信技术股份有限公司 30 / 46 LTE-A(Q)系列 GNSS 应用指导 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 整型。纬度和经度显示格式。 0 ,格式：ddmm.mmmmN/S,dddmm.mmmmE/W 1 ,格式：ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W 2 ,格式：(-)dd.ddddd,(-)ddd.ddddd UTC 时间。格式：hhmmss.ss。 纬度。 如果为 0： 格式：ddmm.mmmmN/S dd 度。范围：00~89 mm.mmmm 分。范围：00.0000~59.9999 N/S 北纬/南纬 如果为 1： 格式：ddmm.mmmmmm,N/S dd 度。范围：00~89 mm.mmmmmm 分。范围：00.000000~59.999999 N/S 北纬/南纬 如果为 2： 格式：(-)dd.ddddd dd.ddddd 度。范围：-89.99999~89.99999 - 南纬 经度。 如果为 0： 格式：dddmm.mmmmE/W ddd 度。范围：000~179 mm.mmmm 分。范围：00.0000~59.9999 E/W 东经/西经 如果为 1： 格式：dddmm.mmmmmm,E/W ddd 度。范围：000~179 mm.mmmmmm 分。范围：00.000000~59.999999 E/W 东经/西经 上海移远通信技术股份有限公司 31 / 46 LTE-A(Q)系列 GNSS 应用指导 如果为 2： 格式：(-)ddd.ddddd ddd.ddddd 度。范围：-179.99999~179.99999 - 西经 水平精度因子。范围：0.5~99.9。 天线的海拔高度。单位：米。精确到小数点后一位。 整型。GNSS 定位模式。 2 2D 定位 3 3D 定位 以真北为参考基准的对地航向。格式：x.x。单位：度。范围：0.0~359.9。 对地速度。格式：x.x。单位：千米/时。精确到小数点后一位。 对地速度。格式：x.x。单位：节。精确到小数点后一位。 定位时的 UTC 时间。格式：ddmmyy。 dd 日 mm 月 yy 年 活跃卫星数量。范围：00~80，固定两位数。 操作错误码。详细信息可参考第 4 章。 2.3.6. AT+QGPSGNMEA 获取 NMEA 语句 该 命 令 用 于 获 取 NMEA 语 句 。 使 用 该 命 令 前 ， 必 须 通 过 AT+QGPS 打 开 GNSS ， 并 将 参 数 设置为 1，然后通过 AT+QGPSGNMEA 获取 NMEA 语句。 用 户 可 以 通 过 AT+QGPSCFG='gpsnmeatype',0 、 AT+QGPSCFG='glonassnmeatype',0 、 AT+QGPSCFG='galileonmeatype',0 和 AT+QGPSCFG='beidounmeatype',0 禁用语句输出。如果禁 用语句输出，依然可以通过 AT+QGPSGNMEA 获取 NMEA 语句，但前提条件是 GNSS 在激活后已经通 过此命令获得了语句。 AT+QGPSGNMEA 获取 NMEA 语句 测试命令 AT+QGPSGNMEA=? 响应 +QGPSGNMEA: (支持的列表) 设置命令 查询 GGA 语句 AT+QGPSGNMEA='GGA' OK 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 上海移远通信技术股份有限公司 32 / 46 设置命令 查询 RMC 语句 AT+QGPSGNMEA='RMC' 设置命令 查询 GSV 语句 AT+QGPSGNMEA='GSV' 设置命令 查询 GSA 语句 AT+QGPSGNMEA='GSA' 设置命令 查询 VTG 语句 AT+QGPSGNMEA='VTG' 上海移远通信技术股份有限公司 LTE-A(Q)系列 GNSS 应用指导 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 33 / 46 设置命令 查询 GNS 语句 AT+QGPSGNMEA='GNS' 最大响应时间 特性说明 LTE-A(Q)系列 GNSS 应用指导 响应 [+QGPSGNMEA: ] […] OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 NMEA 语句类型。 'GGA' GGA 语句 'RMC' RMC 语句 'GSV' GSV 语句 'GSA' GSA 语句 'VTG' VTG 语句 'GNS' GNS 语句 GGA 语句。 RMC 语句。 GSV 语句。 GSA 语句。 VTG 语句。 GNS 语句。 操作错误码。详细信息可参考第 4 章。 2.3.7. AT+QGPSXTRA 启用/禁用 XTRA 辅助功能 该命令用于启用/禁用 XTRA 辅助功能。 AT+QGPSXTRA 启用/禁用 XTRA 辅助功能 测试命令 AT+QGPSXTRA=? 响应 +QGPSXTRA: (支持的列表) 查询命令 AT+QGPSXTRA? OK 响应 +QGPSXTRA: 上海移远通信技术股份有限公司 34 / 46 LTE-A(Q)系列 GNSS 应用指导 设置命令 AT+QGPSXTRA= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。启用/禁用 XTRA 辅助功能。对于 EG06、EM06 和 EP06 系列模块，默认 禁用 XTRA 辅助功能；其他适用模块，默认启用 XTRA 辅助功能。 0 禁用 1 启用 操作错误码。详细信息可参考第 4 章。 2.3.8. AT+QGPSXTRATIME 注入 XTRA 时间 该命令用于将 XTRA 时间注入 GNSS 引擎。使用之前，必须通过 AT+QGPSXTRA=1 启用 XTRA 辅 助功能。激活该功能后，GNSS 引擎将会请求 XTRA 时间和辅助数据文件。在注入 XTRA 数据文件之前， 必须通过 AT+QGPSXTRATIME 注入 XTRA 时间。 AT+QGPSXTRATIME 注入 XTRA 时间 测试命令 AT+QGPSXTRATIME=? 响应 EM06、EG06 和 EP06 系列模块： +QGPSXTRATIME: ,( 支 持 的 列 表),(支持的列表), OK 其他适用模块： +QGPSXTRATIME: , 设置命令 EM06、EG06 和 EP06 系列模块： OK 响应 OK 上海移远通信技术股份有限公司 35 / 46 LTE-A(Q)系列 GNSS 应用指导 AT+QGPSXTRATIME=,[,[,,]] ERROR 设置命令 其他适用模块 AT+QGPSXTRATIME=, 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。操作类型。 0 注入 XTRA 时间 字符串类型。当前待注入的时间。对于 EM06、EG06 和 EP06 系列模块，注入的时间 类型由定义；对于其他适用模块，注入的时间类型为 UTC 时间。 格式：'YYYY/MM/DD,hh:mm:ss'。例如：'2019/01/05,08:30:30'。 整型。时间类型。 0 GPS 时间 1 UTC 时间 整型。是否强制 GNSS 子系统接受注入的时间。 0 不强制 1 强制 整型。时间的不确定性，表示向 SNTP 服务器发送请求与从 SNTP 服务器接收响应的 时间差。默认值：3500；单位：毫秒。 操作错误码。详细信息可参考第 4 章。 2.3.9. AT+QGPSXTRADATA 注入 XTRA 数据文件 该命令用于向 GNSS 引擎注入 XTRA 辅助数据文件。执行该命令前，用户需通过 AT+QGPSXTRA=1 启用 XTRA，再通过 AT+QFUPL 将有效的 XTRA 数据文件存入模块的 UFS，通过 AT+QGPSXTRATIME 将 XTRA 时间注入 GNSS 引擎。 完成上述操作后，再执行 AT+QGPSXTRADATA 将 XTRA 辅助数据文件注入 GNSS 引擎。该命令执 行成功后，可通过 AT+QFDEL 将 UFS 中的 XTRA 数据文件删除。用户可以通过 AT+QGPSXTRADATA? 查询 XTRA 数据是否注入成功。 上海移远通信技术股份有限公司 36 / 46 LTE-A(Q)系列 GNSS 应用指导 AT+QGPSXTRADATA 注入 XTRA 数据文件 测试命令 AT+QGPSXTRADATA=? 响应 +QGPSXTRADATA: 查询命令 查询 XTRA 数据文件的状态 AT+QGPSXTRADATA? OK 响应 +QGPSXTRADATA: , OK 或者 ERROR 设置命令 AT+QGPSXTRADATA= 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 1秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 字符串类型。待注入的 XTRA 数据文件的文件名称。如：'xtra2.bin'或 'xtra3grc.bin'。 整型。已注入的 XTRA 数据文件的有效时间。单位：分钟。 0 无 XTRA 文件或 XTRA 文件过期 1440 有效期为一天的已注入 XTRA 数据文件 4320 有效期为三天的已注入 XTRA 数据文件 10080 有效期为七天的已注入 XTRA 数据文件 字符串类型。已注入的 XTRA 数据文件有效时间的开始时间。 格式：'YYYY/MM/DD,hh:mm:ss'，如：'2016/01/03,15:34:50'。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 37 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.10. AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL 该命令用于配置 SUPL 服务器地址 URL。 AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL 测试命令 AT+QGPSSUPLURL=? 响应 +QGPSSUPLURL: 查询命令 查询当前 SUPL 服务器地址 AT+QGPSSUPLURL? 设置命令 AT+QGPSSUPLURL= OK 响应 +QGPSSUPLURL: OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 字 符串 类型。 SUPL 服务 器地 址。格 式为 ':'（端口 号可 省 略），例如'supl.server.com'、'123.123.123.123'或'supl.server.com:7275'。 当端口号省略时，默认端口为 7275。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 38 / 46 LTE-A(Q)系列 GNSS 应用指导 2.3.11. AT+QGPSSUPLCA 导入 SUPL 证书 该命令用于导入 SUPL 证书。证书文件通过 AT+QFUPL 写入文件系统。证书应由运营商或服务器提 供商提供。 AT+QGPSSUPLCA 导入 SUPL 证书 测试命令 AT+QGPSSUPLCA=? 响应 +QGPSSUPLCA: ,(支持的范围) 设置命令 AT+QGPSSUPLCA=[,] OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 / 参数 字符串类型。SUPL 证书名称。 整型。SUPL 证书 ID。范围：0~9。默认值：0。 操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 39 / 46 LTE-A(Q)系列 GNSS 应用指导 3 举例 3.1. 打开与关闭 GNSS 该示例使用默认参数来打开 GNSS。打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。通过 AT+QGPSEND 可关闭 GNSS。 AT+QGPS=1 //设置 GNSS 工作模式为独立模式并打开 GNSS。 OK //打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。 AT+QGPSLOC=0 //获取定位信息。 +QGPSLOC: 061951.00,3150.7223N,11711.9293E,0.7,62.2,2,0.0,0.0,0.0,110513,09 OK AT+QGPSEND OK //关闭 GNSS。 3.2. GNSS 参数的应用 打开 GNSS 并将设为 1 后，可以直接通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc',1 //将设为 1，使能通过 AT+QGPSGNMEA 获取 NMEA 语 句。 OK AT+QGPSGNMEA='GGA' //获取 GGA 语句。 +QGPSGNMEA: $GPGGA,103647.000,3150.721154,N,11711.925873,E,1,02,4.7,59.8,M,-2.0,M,,*77 OK AT+QGPSCFG='nmeasrc',0 //将设为 0，禁用通过 AT+QGPSGNMEA 获取 NMEA 语 句。 OK AT+QGPSGNMEA='GGA' +CME ERROR: 507 //获取 GGA 语句。 //已禁用通过 AT+QGPSGNMEA 获取 NMEA 语句，因此无法获取 GGA 语句。 上海移远通信技术股份有限公司 40 / 46 LTE-A(Q)系列 GNSS 应用指导 3.3. XTRA 辅助功能的操作步骤 该示例展示了 XTRA 辅助功能的操作步骤（上传文件至 UFS 或从 UFS 删除文件的相关命令详情请参 考文档 [1]）。 AT+QGPSXTRA=1 //如果 XTRA 辅助功能被禁用，先启用 XTRA 辅助 功能，再按以下步骤操作。 OK //立即激活 XTRA 辅助功能。 //如果 XTRA 数据文件有效（可通过 AT+QGPSXTRADATA?查询），直接打开 GNSS 引擎。 //如果 XTRA 数据文件无效（可通过 AT+QGPSXTRADATA?查询），则执行以下步骤。 //用户可以通过第 1.4 章所列的 URL 将 XTRA 数据文件下载至电脑（或 MCU）。 AT+QFUPL='UFS:xtra2.bin',59748,60 //选择一份 XTRA 文件，通过 QCOM 发送命令将该 文件上传到模块内。有关 QCOM 工具的详细信 息，可参考文档 [2]。 OK AT+QGPSXTRATIME='2019/01/05,08:30:30',3500 //将 XTRA 时间注入 GNSS 引擎。需确保注入的 UTC 时间精度保持在 3.5 秒以内。 OK AT+QGPSXTRADATA='UFS:xtra2.bin' //注入 XTRA 数据文件。 OK //该 XTRA 数据文件已成功注入 GNSS 引擎。 AT+QFDEL='UFS:xtra2.bin' //从 UFS 删除 XTRA 数据文件。此步骤为可选项。 OK AT+QGPS=1 //打开 GNSS 引擎。 OK 3.4. AGNSS 功能的操作步骤 该示例展示了 AGNSS 功能的操作步骤（上传文件至 UFS 或从 UFS 删除文件的相关命令详情请参考 文档 [1]）。使用前请通过 AT+QGPSCFG='agpsposmode'开启 AGNSS 功能。 AT+QGPSDEL=0 OK AT+QGPSCFG='plane',1 OK AT+CFUN=1,1 OK AT+QGPSSUPLURL='supl.xxxx.com:7275' //删除所有辅助信息。 //设置 MO AGPS 使用 SSL 连接方式。如果所使用的服 务器不需要证书，则执行命令 AT+QGPSCFG='plane',0。 //重启模块 //设置 SUPL 服务 URL 和端口。其中 supl.xxxx.com 是 示例 URL，应替换为实际 URL；7275 为 SUPL 服务默 认端口。 上海移远通信技术股份有限公司 41 / 46 LTE-A(Q)系列 GNSS 应用指导 OK AT+QFUPL='UFS:supl.xxxx.com.der',893 //上传 CA 证书。其中 supl.xxxx.com.der 为示例 CA 证 书名，应替换为实际 CA 证书；893 为示例 CA 证书大 小，应替换为实际 CA 证书大小。如果所使用的服务器 不需要证书，则忽略该步骤。 OK AT+QGPSSUPLCA='UFS:supl.xxxx.com.der' //导入 CA 证书。其中 supl.xxxx.com.der 为示例 CA 证 书 名，应替换为实际 CA 证书。 OK AT+QFDEL='UFS:supl.xxxx.com.der' //删除 UFS 中的证书。此步骤为可选项。 OK AT+QGPS=2 //以 MSB 模式开启 GNSS。该步骤需在网络配置完成后 方可操作。开启 GNSS 后，通过模块可在 10 秒内完成 定位，如果测试时间偏差大，说明 AGNSS 未起作用。 OK 上海移远通信技术股份有限公司 42 / 46 LTE-A(Q)系列 GNSS 应用指导 4 错误代码 表示与 GNSS 操作相关的错误，详细的参数值，见下表。 表 4：错误代码列表 数值型 字符型 501 Invalid parameter(s) 502 Operation not supported 503 GNSS subsystem busy 504 Session is ongoing 505 Session not active 506 Operation timeout 507 Function not enabled 508 Time information error 509 XTRA not enabled 510 XTRA file open error 511 Bad CRC for XTRA data file 512 Validity time is out of range 513 Internal resource error 514 GNSS locked 515 End by E911 516 Not fixed now 517 CMUX port is not opened 549 Unknown error 中文解释 无效参数 操作不支持 GNSS 子系统繁忙 会话仍在进行 会话未激活 操作超时 功能未使能 时间信息错误 XTRA 功能未使能 XTRA 文件打开错误 XTRA 文件的 CRC 校验错误 超出有效期 内部资源错误 GNSS 锁住 由 E911 结束 当前未定位 CMUX 端口未打开 未知错误 上海移远通信技术股份有限公司 43 / 46 LTE-A(Q)系列 GNSS 应用指导 5 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE-A(Q)系列_FILE_应用指导 [2] Quectel_QCOM_User_Guide 表 6：术语缩写 缩写 AGPS AGNSS APN BeiDou CDMA CMUX COG CRC DOP DPO Galileo GGA GLONASS GNS 英文全称 Assisted GPS Assisted GNSS Access Point Name BeiDou Navigation Satellite System Code-Division Multiple Access Connection Multiplexing Course Over Ground Cyclic Redundancy Check Dilution of Precision Dynamic Power Optimization Galileo Satellite Navigation System Global Positioning System Fix Data Global Navigation Satellite System New GGA Message for GNSS 上海移远通信技术股份有限公司 中文全称 辅助全球定位系统 辅助全球导航卫星系统 接入点名称 北斗卫星导航系统 码分多址 串口多路复用 对地航向 循环冗余校验 精度因子 动态功率优化 伽利略卫星导航系统 全球定位系统修正数据 格洛纳斯卫星导航系统 全球导航卫星系统新的全球定位 44 / 46 GNSS GPS GSA GSM GSV HDOP HDR ID IPv4 IPv6 LBS LPP LTE MCU ME MO MS MSA MSB NMEA NVRAM PDOP PDP PPP LTE-A(Q)系列 GNSS 应用指导 系统修正数据（高通命名数据） Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 GPS DOP and Active Satellites 当前卫星信息 Global System for Mobile Communications 全球移动通信系统 Satellites in View 可见卫星 Horizontal Dilution of Precision 水平精度因子 High Data Rate 高速数据速率 Identifier 标识符 Internet Protocol version 4 第 4 版互联网协议 Internet Protocol version 6 第 6 版互联网协议 Location Based Services 基于位置的服务 LTE Positioning Protocol LTE 定位协议 Long-Term Evolution 长期演进 Micro Control Unit 微控制单元 Mobile Equipment 移动设备 Mobile-Originated 移动主叫 Mobile Station 移动终端 Mobile Station Assisted 移动终端辅助 Mobile Station Based 基于移动终端 NMEA (National Marine Electronics Association) NMEA （ 美 国 国 家 海 洋 电 子 协 0183 Interface Standard 会）0183 接口标准 Non-Volatile Random Access Memory 非易失性随机存取存储器 Position Dilution of Precision 位置精度因子 Packet Data Protocol 分组数据协议 Point to Point Protocol 点对点协议 上海移远通信技术股份有限公司 45 / 46 RMC RRC RRLP SET SNR SNTP SSL SUPL TTFF UART UFS URL USB (U)SIM UTC VDOP VTG WCDMA XTRA LTE-A(Q)系列 GNSS 应用指导 Recommended Minimum Specific GNSS Data 推荐的最少专用 GNSS 数据 Radio Resource Control 无线资源控制 Radio Resource Location Services Protocol 无线资源定位服务协议 SUPL Enabled Terminal SUPL 终端 Signal Noise Ratio 信噪比 Simple Network Time Protocol 简单网络时间协议 Secure Sockets Layer 安全套阶层 Secure User Plane Location 安全用户层面定位 Time to First Fix 第一次定位时间 Universal Asynchronous Receiver & Transmitter 通用费同步收发传输器 User File System 用户文件系统 Uniform Resource Locator 资源定位符 Universal Serial Bus 通用串行总线 (Universal) Subscriber Identity Module （全球）用户身份识别模块 Universal Time Code 国际标准时间码 Vertical Dilution of Precision 垂直精度因子 Course Over Ground and Ground Speed 对地航向和对地速度 Wideband Code Division Multiple Access 宽带码分多址 An Auxiliary Positioning Technology Provided by 高通提供的辅助定位技术 Qualcomm 上海移远通信技术股份有限公司 46 / 46

L26-DR (UDR&ADRC) DR Application Note GNSS Module Series Version: 1.1 Date: 2023-07-20 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. L26-DR(UDR&ADRC)_DR_Application_Note 1 / 33 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. L26-DR(UDR&ADRC)_DR_Application_Note 2 / 33 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status L26-DR (UDR&ADRC) DR Application Note GNSS Module Series Application Note Released Revision History Version Date - 2022-04-15 1.0 2022-06-28 1.1 2023-07-20 Description Creation of the document First official release 1. Added the description about the DR hot start feature (Chapter 1). 2. Added notes on $PSTMSETPAR and the output messages configured with bit 27 (Table 1). 3. Added examples for configuring DR hot start feature (Chapter 2.4.1). 4. Added $PQTM messages (Chapter 3.2). L26-DR(UDR&ADRC)_DR_Application_Note 3 / 33 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index .................................................................................................................................................. 5 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 2 Configuration....................................................................................................................................... 8 2.1. Orientation .............................................................................................................................. 8 2.2. Mounting ................................................................................................................................. 9 2.3. DR Calibration ...................................................................................................................... 10 2.4. Configuration Bits ..................................................................................................................11 2.4.1. Set Configuration Bits ................................................................................................... 12 2.4.2. Get Configuration Bits ................................................................................................... 14 3 Messages ........................................................................................................................................... 15 3.1. PQ Messages ....................................................................................................................... 15 3.1.1. PQSOL .......................................................................................................................... 15 3.1.2. PQGNSS ....................................................................................................................... 17 3.1.3. PQSNR,21..................................................................................................................... 19 3.1.4. PQSNR,23..................................................................................................................... 20 3.1.5. PQEND.......................................................................................................................... 21 3.2. PQTM Messages.................................................................................................................. 22 3.2.1. PQTMCFGDRMODE .................................................................................................... 22 3.2.2. PQTMVEHMSG ............................................................................................................ 23 3.2.2.1. UART Mode .......................................................................................................... 24 3.2.2.1.1. Speed ......................................................................................................... 24 3.2.2.1.2. Speed (Debug Message) ........................................................................... 25 3.2.2.1.3. Wheel Ticks ................................................................................................ 25 3.2.2.1.4. Wheel Ticks (Debug Message) .................................................................. 26 3.2.2.2. Wheel Tick Mode .................................................................................................. 27 3.3. PSTM Messages .................................................................................................................. 27 3.3.1. PSTMDRSENMSG ....................................................................................................... 27 3.3.1.1. IMU Temperature Message (MsgID = 24) ............................................................ 28 3.3.1.2. IMU Accelerometer Message (MsgID = 30) ......................................................... 29 3.3.1.3. IMU Gyroscope Message (MsgID = 31)............................................................... 29 3.3.2. PSTMIMUSELFTESTCMD ........................................................................................... 30 4 Appendix A References .................................................................................................................... 32 5 Appendix B Special Characters ...................................................................................................... 33 L26-DR(UDR&ADRC)_DR_Application_Note 4 / 33 GNSS Module Series Table Index Table 1: List of Configuration Bits................................................................................................................11 Table 2: Related Document........................................................................................................................ 32 Table 3: Terms and Abbreviations .............................................................................................................. 32 Table 4: Special Characters ....................................................................................................................... 33 L26-DR(UDR&ADRC)_DR_Application_Note 5 / 33 GNSS Module Series Figure Index Figure 1: Module Orientation........................................................................................................................ 8 Figure 2: Module Mounting Example ........................................................................................................... 9 L26-DR(UDR&ADRC)_DR_Application_Note 6 / 33 GNSS Module Series 1 Introduction This document provides a comprehensive overview of the dead reckoning (DR) feature of the Quectel L26-DR (UDR, ADRC) modules, including orientation, mounting, calibration, configuration bits and messages related to the Dead Reckoning functionality. Quectel offers a two-DR product portfolio including L26-DR (ADRC) and L26-DR (UDR) modules. L26-DR (ADRC) incorporates a 6-axis inertial sensor (3-axis gyroscope and 3-axis accelerometer) and an attached sensor such as a wheel speed sensor. It is primarily designed for two-wheel applications like motorcycles and scooters. On the other hand, L26-DR (UDR) is suitable for 4-wheel applications and does not require the addition of a wheel speed sensor. However, in situations where GNSS outages occur, the use of an additional wheel speed sensor enhances the maintenance of dead reckoning accuracy for extended periods compared to the untethered UDR, which relies solely on the internal IMU without vehicle tethering. L26-DR (UDR) module features the DR hot start function, which allows it to save calibration parameters in areas without GNSS signal. In practical applications, when the module stays in the no-signal zone after calibration, it will quickly acquire a position fix upon the next restart. This functionality enables efficient and accurate positioning even in challenging environments with limited or no GNSS reception. L26-DR (ADRC) module is typically used in OEM cases, while L26-DR (UDR) is typically used in aftermarket products. This document applies to the following variants of the L26-DR module: ⚫ L26-DR (UDR) ⚫ L26-DR (ADRC) Module L26-DR (UDR) L26-DR (ADRC) Vehicle Type Four-wheeler Two-wheeler Connect Speed or Not No Yes. See Chapter 3.2 PQTM Messages for details. L26-DR(UDR&ADRC)_DR_Application_Note 7 / 33 GNSS Module Series 2 Configuration 2.1. Orientation The L26-DR (UDR, ADRC) modules are specifically designed for use in four-wheel and two-wheel vehicles respectively. User must install the module securely, ensuring that the GNSS module is firmly fixed to vehicle body. No relative movement is allowed between vehicle and device, and maximum isolation from both shock and vibration must be provided. Manual holding of the board is not acceptable. The recommended installation method is to firmly screw the device to the vehicle frame. Mounting location should permit easy access to power supply and GNSS antenna, while also ensuring that the module is not exposed to excessive heat. Z Yaw Pitch X Y Roll Figure 1: Module Orientation NOTE Firmly affix the device incorporating the module to vehicle body. Select a structurally sound location that is not prone to flexing. L26-DR(UDR&ADRC)_DR_Application_Note 8 / 33 GNSS Module Series 2.2. Mounting The Quectel L26-DR (UDR, ADRC) modules can be mounted on a vehicle in any orientation, but one axis (recommend the Z axis) must be perpendicular to the horizontal plane. The reference model is illustrated as follows: Yaw X Pitch β －β Roll γ -γ Figure 2: Module Mounting Example Referring to the above installation model, during the installation process of the module there is no limitation on the α angle (0° ≤ α ≤ 360°). However, for optimal performance, it is recommended to maintain the β angle and the γ angle within the range of -15 degrees to 15 degrees (-15° ≤ β ≤ 15°, -15° ≤ γ≤ 15°). In other words, the angle between the plane where the module is located and the horizontal plane should be kept below 15 degrees. L26-DR(UDR&ADRC)_DR_Application_Note 9 / 33 GNSS Module Series NOTE 1. Yaw Angle (α) has no limitations and can range from 0°to 360°. 2. When the β and γ angles exceed ±15°, positioning performance of the module degrades. 2.3. DR Calibration To ensure accurate functioning of the dead reckoning functionality, the module requires calibration. Follow the steps below for DR calibration: Step 1: Fix the module on the vehicle frame firmly. Any displacement, rotation or tilt of the device relative to the vehicle plane, however small, may cause performance issues and/or void calibration. Step 2: Calibration should be performed under good GNSS signal and clear sky conditions. Step 3: Do not interfere with or move the device after powering on. Step 4: After the initial power-on, keep the vehicle stationary for 30 seconds at least. During driving, the vehicle should experience one or two dynamic changes (such as waiting at traffic lights, acceleration and deceleration, etc.) to facilitate normal driving scenarios and satellite signal reception. Step 5: The calibration process is considered complete when field in $PQSOL message indicates a combined solution (GNSS + DR). See Chapter 3.1.1 PQSOL for details about the message. After the calibration process, you can perform verification tests to assess the module’s performance under various driving scenarios. Consider the following scenarios for verification: 1) Open sky area, urban main road (good satellite signal). 2) Urban tunnels (absence of satellite signals). 3) Urban viaduct (weak satellite signals). 4) Underground vehicle parking (absence of satellite signal). 5) Areas surrounded with dense buildings (multi-path in an urban canyon). 6) City boulevards (weak satellite signals). 7) High-rise dense area (severe canyon multi-path). L26-DR(UDR&ADRC)_DR_Application_Note 10 / 33 GNSS Module Series 2.4. Configuration Bits Table 1: List of Configuration Bits Bit 22, 23 24 25 26 27 1) 28 29 30 Bitmask (32 bits) 0x000000 0x400000 0x800000 0xC00000 0x1000000 0x2000000 0x4000000 0x8000000 0x10000000 0x20000000 0x40000000 Function Fix rate control. 1 Hz (default). Fix rate control. 5 Hz. Fix rate control. 10 Hz (UART baud rate ≥ 230400 bps). Fix rate control. 20 Hz (UART baud rate ≥ 230400 bps). Enable $PQSOL message. Enable $PQGNSS message. Enable $PQSNR,21 and $PQEND messages. Enable $PQSNR,23 message. Enable $PQTMVEHMSG message. Enable $PSTMDRSENMSG message. Enable/Disable DR feature. 0 = Enable 1 = Disable Enable/Disable DR hot start feature. 0 = Disable 1 = Enable Only supported by L26-DR (UDR). NOTE 1. $PSTMSETPAR is used to set or get configuration bits. For details about the command, see Chapters 2.4.1 Set Configuration Bits and 2.4.2 Get Configuration Bits or contact Quectel Technical Support (support@quectel.com). 2. After using $PSTMSETPAR to set the configuration bits, reboot the module to enable the output of PQ, $PQTMVEHMSG and $PSTMDRSENMSG messages. 3. 1) When the output frequency is 1 Hz, the module only outputs $PQTMVEHMSG, and when the output frequency is greater than 1 Hz, the module outputs $PQTMVEHMSG and $PQSNR,23. L26-DR(UDR&ADRC)_DR_Application_Note 11 / 33 2.4.1. Set Configuration Bits 1) Clear the bitmask. $PSTMSETPAR,1228,,2* ⚫ If successful, the module returns: $PSTMSETPAROK,1228* ⚫ If failed, the module returns: $PSTMSETPARERROR,1228* 2) Set the bitmask. $PSTMSETPAR,1228,,1* ⚫ If successful, the module returns: $PSTMSETPAROK,1228* ⚫ If failed, the module returns: $PSTMSETPARERROR,1228* 3) Save the parameters. $PSTMSAVEPAR*58 ⚫ If successful, the module returns: $PSTMSAVEPAROK* ⚫ If failed, the module returns: $PSTMSAVEPARERROR* 4) Reboot the module. $PSTMSRR*49 Example: 1) Set the fix rate to 5 Hz. //Clear the bitmask: $PSTMSETPAR,1228,0xC00000,2*32 $PSTMSETPAROK,1228*3A //Set the bitmask: $PSTMSETPAR,1228,0x400000,1*43 $PSTMSETPAROK,1228*3A L26-DR(UDR&ADRC)_DR_Application_Note GNSS Module Series 12 / 33 //Save the parameter: $PSTMSAVEPAR*58 $PSTMSAVEPAROK*5C //Reboot: $PSTMSRR*49 2) Disable $PQSOL message. //Clear the bitmask: $PSTMSETPAR,1228,0x1000000,2*75 $PSTMSETPAROK,1228*3A //Save the parameter: $PSTMSAVEPAR*58 $PSTMSAVEPAROK*5C //Reboot: $PSTMSRR*49 3) Enable $PQSOL message. //Set the bitmask: $PSTMSETPAR,1228,0x1000000,1*76 $PSTMSETPAROK,1228*3A //Save the parameter: $PSTMSAVEPAR*58 $PSTMSAVEPAROK*5C //Reboot: $PSTMSRR*49 4) Disable DR Hot-Start feature. //Clear the bitmask: $PSTMSETPAR,1228,0x40000000,2*40 $PSTMSETPAROK,1228*3A //Save the parameter: $PSTMSAVEPAR*58 $PSTMSAVEPAROK*5C //Reboot: $PSTMSRR*49 5) Enable DR Hot-Start feature: L26-DR(UDR&ADRC)_DR_Application_Note GNSS Module Series 13 / 33 //Set the bitmask: $PSTMSETPAR,1228,0x40000000,1*43 $PSTMSETPAROK,1228*3A //Save the parameter: $PSTMSAVEPAR*58 $PSTMSAVEPAROK*5C //Reboot: $PSTMSRR*49 GNSS Module Series NOTE For details about $PSTMSAVEPAR and $PSTMSRR, see document [1] protocol specification. 2.4.2. Get Configuration Bits Command: $PSTMGETPAR,1228*2A ⚫ If successful, the module returns: $PSTMSETPAR,1228,* ⚫ If failed, the module returns: $PSTMGETPARERROR* Example: $PSTMGETPAR,1228*2A $PSTMSETPAR,1228,0x11000000*5B L26-DR(UDR&ADRC)_DR_Application_Note 14 / 33 GNSS Module Series 3 Messages 3.1. PQ Messages This chapter outlines the PQ messages (proprietary NMEA messages defined by Quectel) supported by Quectel L26-DR (UDR, ADRC) modules. 3.1.1. PQSOL Reports the navigation results. Type: Output Synopsis: $PQSOL,,,,,,,,,,< TOW>,,,,,,,,,,,,,,,,,,,,,,,,,,,* Parameter: Field Format Unit Numeric Numeric Year Numeric Month Numeric Day Numeric Hour Numeric Minute Description Message Subtype ID, fixed as 1. UTC Year. UTC Month. Range: 1–12. UTC Day. Range: 1–31. UTC Hour. Range: 0–23. UTC Minutes. Range: 0–59. L26-DR(UDR&ADRC)_DR_Application_Note 15 / 33 GNSS Module Series Field Format Numeric Numeric Unit Description Millisecond Milliseconds. Range: 0–59950 (20 Hz fix rate); 0–59900 (10 Hz fix rate); 0–59800 (5 Hz fix rate); 0–59000 (1 Hz fix rate). Millisecond Milliseconds since power-on. 32-bit unsigned integer. Numeric Week GPS week number, including rollover. Numeric Numeric Numeric Millisecond Time of week. Navigation mode. 0 = No navigation. Bit 0: Reserved. Bit 1: GNSS-only. Bit 2: DR-only. Bit 3: Combined solution (GNSS + DR). Bit 4–8: Reserved. Bit 9: Odometer (wheel tick) in use. Bit 10, 11: Reserved. Bit 12: DGNSS (not including satellite-based correction source). Bit 13–31: Reserved. Degree Latitude, scaled by 10^7. Numeric Degree Longitude, scaled by 10^7. Numeric cm Ellipsoidal height. Numeric cm Height above mean-sea-level. Numeric cm/s Northward velocity. Numeric cm/s Eastward velocity. Numeric cm/s Downward velocity. Numeric cm/s Speed over ground. Numeric cm Traveled distance since power-on. Numeric Degree Roll angle, scaled by 100. Numeric Degree Pitch angle, scaled by 100. Numeric Degree Heading angle, scaled by 100. Numeric - - L26-DR(UDR&ADRC)_DR_Application_Note 16 / 33 GNSS Module Series Field Format Unit Numeric - Numeric cm Numeric cm Numeric cm Numeric cm/s Numeric cm/s Numeric cm/s Numeric Degree Numeric Degree Numeric Degree Numeric Degree Numeric Degree Numeric Degree Description Uncertainty of position in northward direction. Uncertainty of position in eastward direction. Uncertainty of position in downward direction. Northward velocity uncertainty. Eastward velocity uncertainty. Downward velocity uncertainty. Roll angle uncertainty, scaled by 100. Pitch angle uncertainty, scaled by 100. Yaw angle uncertainty, scaled by 100. Roll angle misalignment, scaled by 100. Pitch angle misalignment, scaled by 100. Yaw angle misalignment, scaled by 100. Example: $PQSOL,1,2021,12,21,8,25,4000,61300,2189,203121999,2,318221924,1171155060,6587,6618,-3,4,0,5 ,156,1182,331,0,0,0,3267,6444,3273,211,206,137,20,10,10,0,0,0*68 NOTE Attitude-related values (including roll, yaw and pitch) are invalid in GNSS-only mode. 3.1.2. PQGNSS Reports GNSS-only fix information. Type: Output L26-DR(UDR&ADRC)_DR_Application_Note 17 / 33 GNSS Module Series Synopsis: $PQGNSS,,,,,,,,,,,,,,,,,,,,, ,,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Description - Message Subtype ID, fixed as 6. Year UTC year. Month UTC month. Day UTC day. Hour UTC hour. Minute UTC minutes. Second UTC seconds. Week GPS week number, including rollover. Millisecond Time of week. - Number of satellites in use. Degree Latitude, scaled by 10^7. Degree Longitude, scaled by 10^7. cm Ellipsoidal height. cm/s Speed over ground. Degree Heading angle, scaled by 100. cm Horizontal accuracy. cm/s Northward velocity. cm/s Eastward velocity. cm/s Downward velocity. - - - - L26-DR(UDR&ADRC)_DR_Application_Note 18 / 33 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit cm cm cm cm/s cm/s cm/s Second cm - Description Uncertainty of position in northward direction. Uncertainty of position in eastward direction. Uncertainty of position in downward direction. Northward velocity uncertainty. Eastward velocity uncertainty. Downward velocity uncertainty. Leap seconds. Height above mean-sea-level. - Example: $PQGNSS,6,2022,4,15,11,20,34,2205,472852000,11,318221499,1171158627,3673,5,0,2421,1,5,-1,0,0, 1580,1834,1632,272,232,285,18,0,3704,12*34 3.1.3. PQSNR,21 Reports sensor data. Type: Output Synopsis: $PQSNR,,{,,,,,,,< Z_ACC>,,}* Parameter: Field Format Unit Description Numeric - 21 = Mixed DR sensor data. Numeric - Number of data set(s). Start of repeat block. Repeat times: . L26-DR(UDR&ADRC)_DR_Application_Note 19 / 33 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric End of repeat block. Unit ms Deg/s Deg/s Deg/s m/s^2 m/s^2 m/s^2 m/s - Description Milliseconds since power-on. 32-bit unsigned integer. X-axis angular velocity of gyroscope, scaled by 1000. Y-axis angular velocity of gyroscope, scaled by 1000. Z-axis angular velocity of gyroscope, scaled by 1000. X-axis acceleration of accelerometer, scaled by 1000. Y-axis acceleration of accelerometer, scaled by 1000. Z-axis acceleration of accelerometer, scaled by 1000. Vehicle speed, scaled by 100. Vehicle direction. 0 = Forward 1 = Reverse 8 = Unknown Example: $PQSNR,21,10,9800,449,-447,-178,566,1937,9589,0,8,9900,465,-412,-110,562,1937,9593,0,8,10000,5 21,-420,-128,567,1946,9596,0,8,10100,448,-441,-94,565,1937,9591,0,8,10200,454,-437,-118,565,1942, 9599,0,8,10300,487,-403,-129,559,1946,9603,0,8,10400,472,-461,-110,563,1940,9590,0,8,10500,443,-4 31,-121,561,1940,9587,0,8,10600,473,-416,-122,563,1943,9600,0,8,10700,474,-441,-86,564,1947,9597 ,0,8*4B 3.1.4. PQSNR,23 Reports raw sensor data. The message only exists in NHz build. The entire block is comprised of multiple messages. Type: Output Synopsis: $PQSNR,,,,,,,,* L26-DR(UDR&ADRC)_DR_Application_Note 20 / 33 GNSS Module Series Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit ms Deg/s Deg/s Deg/s m/s2 m/s2 m/s2 Description 23 = Raw sensor data Milliseconds since power-on. 32-bit unsigned integer. X-axis angular velocity of gyroscope, scaled by 1000. Y-axis angular velocity of gyroscope, scaled by 1000. Z-axis angular velocity of gyroscope, scaled by 1000. X-axis acceleration of accelerometer, scaled by 1000. Y-axis acceleration of accelerometer, scaled by 1000. Z-axis acceleration of accelerometer, scaled by 1000. Example: $PQSNR,23,3100,399,-519,-454,466,-511,9906*5C 3.1.5. PQEND Indicates the end of an epoch. Type: Output Synopsis: $PQEND,,* Parameter: Field Format Numeric Numeric Unit Description - Fixed at 255. - Fixed at 255. Example: $PQEND,255,255*4E L26-DR(UDR&ADRC)_DR_Application_Note 21 / 33 GNSS Module Series 3.2. PQTM Messages This chapter outlines the PQTM messages (proprietary NMEA messages defined by Quectel) supported by Quectel L26-DR (ADRC) module. Please note that this message is not supported on the L26-DR (UDR) module. 3.2.1. PQTMCFGDRMODE Sets/gets the speed acquisition method. Type: Set/Get Synopsis: //Set: $PQTMCFGDRMODE,,* //Get: $PQTMCFGDRMODE,* Parameter: Field Format Numeric Numeric Unit Description Set or get the speed acquisition method. - 0 = Get 1 = Set Speed mode. 0 = No speed information input - 2 = UART mode 3 = Wheel Tick mode (WHEELTICK pin) Result: ⚫ If successful, the module returns: //Set: $PQTMCFGDRMODEOK* //Get: $PQTMCFGDRMODE,0,* ⚫ If failed, no message is sent as a reply. L26-DR(UDR&ADRC)_DR_Application_Note 22 / 33 Example: //Set UART mode to get vehicle speed: $PQTMCFGDRMODE,1,2*4C $PQTMCFGDRMODEOK*4B //Set Wheel Tick mode to get vehicle speed: $PQTMCFGDRMODE,1,3*4D $PQTMCFGDRMODEOK*4B //Get speed acquisition method: $PQTMCFGDRMODE,0*53 $PQTMDRMODE,0,0*0D GNSS Module Series NOTE When configuring UART mode to get vehicle speed, for corresponding output messages, refer to Chapter 3.2.2.1 UART Mode. When configuring Wheel Tick mode to get vehicle speed, for corresponding output message, refer to Chapter 3.2.2.2 Wheel Tick Mode. 3.2.2. PQTMVEHMSG Inputs/outputs the speed data. This message is only supported on the L26-DR (ADRC) module and not supported by the L26-DR (UDR) module. Type: Input/Output Synopsis: $PQTMVEHMSG[,],[,],[,,…,]*< LF> Parameter: Field Format Unit Numeric Numeric - Description In UART mode, = Number of message(s) × 100, for output messages with speed or wheel ticks injected via UART. See Chapter 3.2.2.1 UART Mode. In Wheel Tick mode, means CPU tick count since power-on. See Chapter 3.2.2.2 Wheel Tick Mode. Type of message input/output via UART interface. 1 = Vehicle speed (in m/s) 2 = Wheel ticks L26-DR(UDR&ADRC)_DR_Application_Note 23 / 33 GNSS Module Series Field Format Numeric to Numeric Unit Description Millisecond - Timestamp since power-on. 32-bit unsigned integer. Always 0 when this message is input. See Chapters 3.2.2.1.1 Speed and 3.2.2.1.3 Wheel Ticks for details for details. Vehicle information. This field varies with the message type. See Chapters 3.2.2.1 UART Mode and 3.2.2.2 Wheel Tick Mode for details. 3.2.2.1. UART Mode This chapter mainly introduces the relevant messages of injecting speed or wheel ticks through UART. It is recommended to inject speed or wheel ticks at a frequency of 10 Hz. 3.2.2.1.1. Speed Type: Input/Output Synopsis: $PQTMVEHMSG,,,* Parameter: Field Format Numeric Numeric Numeric Unit Description - Fixed at 1. Timestamp since power-on. 32-bit unsigned integer. Millisecond Always 0 when this message is input. m/s Vehicle speed. Example: $PQTMVEHMSG,1,0,3.6*1C $PQTMVEHMSG,1,3748292,3.600000*2D L26-DR(UDR&ADRC)_DR_Application_Note 24 / 33 GNSS Module Series 3.2.2.1.2. Speed (Debug Message) This message is output only when speed is injected via UART. It is for debugging purpose only. Type: Output Synopsis: $PQTMVEHMSG,,,,* Parameter: Field Format Numeric Numeric Numeric Unit cm/s Numeric - Description = Number of message(s) × 100. Fixed at 1. Vehicle speed. Forward/backward indicator. 0 = Unknown 1 = Forward 2 = Backward Example: $PQTMVEHMSG,100,1,0,0*1A 3.2.2.1.3. Wheel Ticks Type: Input/Output Synopsis: $PQTMVEHMSG,,,,* Parameter: Field Format Numeric Numeric Unit Description Millisecond Fixed at 2. Timestamp since power-on. 32-bit unsigned integer. Always 0 when this message is input. L26-DR(UDR&ADRC)_DR_Application_Note 25 / 33 GNSS Module Series Field Format Unit Numeric Tick Numeric - Example: $PQTMVEHMSG,2,0,0,1*19 $PQTMVEHMSG,2,3422954,0,1*16 Description Wheel ticks. Forward/backward indicator. 0 = Unknown 1 = Forward 2 = Backward 3.2.2.1.4. Wheel Ticks (Debug Message) This message is output only when wheel tick count is injected via UART. It is for debugging purpose only. Type: Output Synopsis： $PQTMVEHMSG,,, ,* Parameter: Field Format Unit Numeric - Numeric - Numeric Tick Numeric - Description = Number of message(s) × 100. Fixed at 2. Wheel ticks. Forward/backward indicator. 0 = Unknown 1 = Forward 2 = Backward Example: $PQTMVEHMSG,100,2,0,0*19 L26-DR(UDR&ADRC)_DR_Application_Note 26 / 33 GNSS Module Series 3.2.2.2. Wheel Tick Mode This chapter mainly introduces the relevant messages of injecting wheel ticks through WHEELTICK pin. It is for debugging purpose only. Type: Output Synopsis： $PQTMVEHMSG, ,, ,* Parameter: Field Format Unit Numeric Numeric - Numeric Tick Numeric - Description CPU tick count since power-on. Fixed at 2. Wheel ticks. Forward/backward indicator. 0 = Unknown 1 = Forward 2 = Backward Example: $PQTMVEHMSG,100,2,0,0*19 NOTE In Wheel Tick mode, the output frequency is 10 Hz. 3.3. PSTM Messages This chapter outlines the PSTM messages (proprietary NMEA messages defined by the chipset supplier) supported by Quectel L26-DR (UDR, ADRC) modules. 3.3.1. PSTMDRSENMSG Outputs the IMU raw data. L26-DR(UDR&ADRC)_DR_Application_Note 27 / 33 GNSS Module Series Type: Output Synopsis: $PSTMDRSENMSG,[,]* Parameter: Field Format Numeric - Unit Description Message ID. 24 = IMU temperature. 30 = IMU accelerometer. 31 = IMU gyroscope. This field varies with the message type. See Chapters 3.3.1.1 IMU Temperature Message (MsgID = 24), 3.3.1.2 IMU Accelerometer Message (MsgID = 30) and 0 IMU Gyroscope Message (MsgID = 31) for details. 3.3.1.1. IMU Temperature Message (MsgID = 24) Outputs temperature data from the IMU. Type: Output Synopsis: $PSTMDRSENMSG,24,,,* Parameter: Field Format Unit Description Numeric Numeric - Numeric - CPU tick count since power-on. IMU temperature. Real temperature in Celsius degrees: Celsius degrees = / 256 + 25.0 Validity. 0 = Temperature is not valid. 1 = Temperature is valid. L26-DR(UDR&ADRC)_DR_Application_Note 28 / 33 Example: $PSTMDRSENMSG,24,3248649605,-486,1*28 GNSS Module Series 3.3.1.2. IMU Accelerometer Message (MsgID = 30) Outputs accelerometer data from the IMU. FS = ±2g Sensitivity = 0.061mg/LSB Type: Output Synopsis: $PSTMDRSENMSG,30,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description - CPU tick count since power-on. Raw signed 16-bit integer X-axis acceleration data - in sensor frame. Raw signed 16-bit integer Y-axis acceleration data in sensor frame. Raw signed 16-bit integer Z-axis acceleration data in sensor frame. Example: $PSTMDRSENMSG,30,3248512115,299,-35,16514*02 3.3.1.3. IMU Gyroscope Message (MsgID = 31) Outputs gyroscope data from the IMU. FS = ±125 dps Sensitivity = 4.375 mdps/LSB Type: Output L26-DR(UDR&ADRC)_DR_Application_Note 29 / 33 GNSS Module Series Synopsis: $PSTMDRSENMSG,31,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description - CPU tick count since power-on. Raw signed 16-bit integer X-axis angular rate data - in sensor frame. Raw signed 16-bit integer Y-axis angular rate data in sensor frame. Raw signed 16-bit integer Z-axis angular rate data in sensor frame. Example: $PSTMDRSENMSG,31,5855224,62,-119,-49*2A 3.3.2. PSTMIMUSELFTESTCMD Executes the self-test procedure in IMU. Type: Command Synopsis: $PSTMIMUSELFTESTCMD,* Parameter: Field Format Numeric Unit Description IMU type. - 0 = Accelerometer 1 = Gyroscope L26-DR(UDR&ADRC)_DR_Application_Note 30 / 33 GNSS Module Series Result: ⚫ If successful, the module returns: $PSTMIMUSELFTESTCMDOK* ⚫ If failed, the module returns: $PSTMIMUSELFTESTCMDKO* ⚫ If the self-test command is not supported by the mounted IMU or by the FW (sensor layer not present in FW), the module returns: $PSTMIMUSELFTESTCMDERROR* Example: $PSTMIMUSELFTESTCMD,1*16 $PSTMIMUSELFTESTCMDOK*0F L26-DR(UDR&ADRC)_DR_Application_Note 31 / 33 GNSS Module Series 4 Appendix A References Table 2: Related Document Document Name [1] L26-DR Series&L26-P&L26-T&LC98S GNSS Protocol Specification Table 3: Terms and Abbreviations Abbreviation DGNSS DR FW GNSS IMU LSB NMEA OEM UART UDR UTC Description Difference Global Navigation Satellite System Dead Reckoning Firmware Global Navigation Satellite System Inertial Measurement Unit Least Significant Bit NMEA (National Marine Electronics Association) 0183 Interface Standard Original Equipment Manufacturer Universal Asynchronous Receiver/Transmitter Untethered Dead Reckoning Universal Time Coordinated L26-DR(UDR&ADRC)_DR_Application_Note 32 / 33 GNSS Module Series 5 Appendix B Special Characters Table 4: Special Characters Special Character […] {…} Underline Description Carriage return character. Line feed character. Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. L26-DR(UDR&ADRC)_DR_Application_Note 33 / 33

BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 NB-IoT 模块系列 版本：1.0 日期：2022-04-20 状态：受控文件 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 文档历史 修订记录 版本 日期 作者 - 2021-02-05 Oven TAO 1.0 2022-04-20 Oven TAO 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 7 图片索引 ........................................................................................................................................................ 8 1 引言 ........................................................................................................................................................ 9 1.1. BLE 关键特性 .............................................................................................................................. 9 1.2. 典型应用场景............................................................................................................................. 10 2 BLE 相关 AT 命令 ................................................................................................................................ 11 2.1. AT 命令说明............................................................................................................................... 11 2.1.1. 定义 ................................................................................................................................ 11 2.1.2. AT 命令语句.................................................................................................................... 11 2.2. AT 示例声明............................................................................................................................... 12 2.3. BLE 相关 AT 命令详解............................................................................................................... 12 2.3.1. GAP AT 命令................................................................................................................... 12 2.3.1.1. AT+BLEPWR 开启/关闭 BLE 协议栈................................................................ 12 2.3.1.2. AT+BLEDEVINIT 初始化 BLE 设备 .................................................................. 13 2.3.1.3. AT+BLESTATE 获取 BLE 协议栈状态 .............................................................. 15 2.3.1.4. AT+BLEADDR 获取 BLE 设备地址................................................................... 16 2.3.1.5. AT+BLENAME 设置 BLE 设备名称 .................................................................. 17 2.3.1.6. AT+BLEWLSTADD 向白名单添加 BLE 设备 .................................................... 18 2.3.1.7. AT+BLEWLSTRM 从白名单删除 BLE 设备...................................................... 19 2.3.1.8. AT+BLEWLST 查询白名单 ............................................................................... 21 2.3.1.9. AT+BLEWLSTCLR 清空白名单 ........................................................................ 22 2.3.1.10. AT+BLERPAMODE 开启/关闭可解析地址功能 ................................................ 23 2.3.1.11. AT+BLESETADVDATA 设置广播和扫描响应数据 ............................................ 24 2.3.1.12. AT+BLEADV 开启/关闭广播 ............................................................................. 25 2.3.1.13. AT+BLEDISC 断开连接 .................................................................................... 28 2.3.1.14. AT+BLEPARAMUPDATE 更新连接参数 .......................................................... 29 2.3.1.15. AT+BLEDATASEND 发送数据.......................................................................... 30 2.3.1.16. AT+BLEGATCGETMTU 查询最大传输单元 ..................................................... 31 2.3.1.17. AT+BLETXPWR 设置链路发射功率级别 .......................................................... 32 2.3.1.18. AT+BLEADVPWR 设置广播链路功率级别 ....................................................... 34 2.3.1.19. AT+BLEOTAMODE 设置 BLE DFOTA 升级模式.............................................. 35 2.3.1.20. AT+BLEOTARSP 设置 BLE DFOTA 升级请求响应 .......................................... 36 2.3.2. GATT SERVER AT 命令................................................................................................. 38 2.3.2.1. AT+BLEGATADDS 添加服务 ............................................................................ 38 2.3.2.2. AT+BLEGATADDC 添加特征............................................................................ 39 2.3.2.3. AT+BLEGATADDD 添加特征描述符................................................................. 40 2.3.2.4. AT+BLEGATSST 启动服务............................................................................... 41 2.3.2.5. AT+BLEGATSRM 删除服务.............................................................................. 43 上海移远通信技术股份有限公司 4 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.3.2.6. AT+BLEGATRDATT 读取属性值 ...................................................................... 44 2.3.2.7. AT+BLEGATWRATT 写入属性值...................................................................... 45 2.3.2.8. AT+BLEGATSIND 更新属性值并向客户端发送通知和指示.............................. 46 2.3.3. SMP AT 命令 .................................................................................................................. 47 2.3.3.1. AT+BLEPAIRCFG 配对能力配置...................................................................... 47 2.3.3.2. AT+BLEPINSET 配置 BLE PIN 码.................................................................... 50 2.3.3.3. AT+BLERMPAIR 删除配对 ............................................................................... 51 2.3.3.4. AT+BLESETAUTHTK 鉴权 TK 输入 ................................................................. 52 2.3.3.5. AT+BLECONFIRM 鉴权 TK 比较确认 .............................................................. 52 2.3.3.6. AT+BLEBINDINFO 查询配对绑定设备信息...................................................... 53 3 相关事件描述........................................................................................................................................ 55 3.1. GAP 事件................................................................................................................................... 55 3.1.1. 连接结果上报事件 .......................................................................................................... 55 3.1.2. 命令错误通知事件 .......................................................................................................... 56 3.1.3. 命令完成通知事件 .......................................................................................................... 57 3.1.4. 数据接收通知事件 .......................................................................................................... 57 3.1.5. 更新连接参数通知事件 ................................................................................................... 57 3.1.6. 数据通道建立完成通知事件 ............................................................................................ 58 3.1.7. BLE DFOTA 升级通知事件............................................................................................. 58 3.2. GATT 事件................................................................................................................................. 59 3.2.1. 客户端读取属性值事件 ................................................................................................... 59 3.2.2. 客户端写入属性值事件 ................................................................................................... 59 3.3. SMP 事件 .................................................................................................................................. 60 3.3.1. 密钥丢失通知事件 .......................................................................................................... 60 3.3.2. 配对完成事件.................................................................................................................. 60 3.3.3. 鉴权 TK 显示事件 ........................................................................................................... 61 3.3.4. 鉴权 TK 输入通知事件 .................................................................................................... 61 3.3.5. 鉴权 TK 确认事件 ........................................................................................................... 61 4 BLE 与 NB-IoT 共存设计指导.............................................................................................................. 63 4.1. NB-IoT 与 BLE 的优先级 ........................................................................................................... 63 4.2. 共存功能状态............................................................................................................................. 63 4.2.1. BLE 协议栈启动.............................................................................................................. 63 4.2.2. BLE 相关 AT 命令分类.................................................................................................... 63 4.2.3. BLE 协议栈运行中 NB-IoT 与 BLE 对 RF 的抢占 ........................................................... 64 4.3. 用户设计指导............................................................................................................................. 65 4.3.1. BLE 启动流程 ................................................................................................................. 65 4.3.2. NB-IoT 抢占 RF 导致 BLE 连接断开............................................................................... 65 4.4. 启动方式设计............................................................................................................................. 65 4.4.1. 自动启动 ......................................................................................................................... 65 4.4.2. 人工控制启动.................................................................................................................. 65 5 BLEAssistant 使用指南 ...................................................................................................................... 66 5.1. 主要功能 .................................................................................................................................... 66 5.2. 界面介绍 .................................................................................................................................... 67 上海移远通信技术股份有限公司 5 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3. 操作指导 .................................................................................................................................... 68 5.3.1. 扫描 ................................................................................................................................ 69 5.3.1.1. 开启/停止扫描...................................................................................................... 69 5.3.1.2. 白名单扫描 .......................................................................................................... 70 5.3.1.3. BLE 设备基本信息 ............................................................................................... 72 5.3.1.4. 连接/自动重连指定的 BLE 设备........................................................................... 72 5.3.2. 设备管理 ......................................................................................................................... 73 5.3.3. GATT 管理 ...................................................................................................................... 74 5.3.3.1. 显示服务列表....................................................................................................... 74 5.3.3.2. 读写特征值 .......................................................................................................... 75 5.3.3.3. 刷新服务列表....................................................................................................... 76 5.3.3.4. 管理绑定 .............................................................................................................. 77 5.3.4. L2CAP 数据传输............................................................................................................. 79 5.3.4.1. 使能 L2CAP......................................................................................................... 80 5.3.4.2. 发送数据 .............................................................................................................. 80 5.3.4.3. 其他 ..................................................................................................................... 81 5.3.5. AT 通道 ........................................................................................................................... 81 5.3.5.1. 使能 AT 通道........................................................................................................ 81 5.3.5.2. 发送 AT 命令和显示历史发送数据列表................................................................ 82 5.3.5.3. 其他 ..................................................................................................................... 83 5.3.6. DFOTA 升级 ................................................................................................................... 83 5.3.6.1. 使能 DFOTA ........................................................................................................ 83 5.3.6.2. 差分文件 .............................................................................................................. 84 5.3.6.3. 传输文件 .............................................................................................................. 84 5.3.6.4. 断点升级 .............................................................................................................. 85 6 举例 ...................................................................................................................................................... 86 6.1. BLE L2CAP 数据传输与 NB-IoT 共存使用流程......................................................................... 86 6.2. BLE 配对流程 ............................................................................................................................ 88 6.3. BLE L2CAP 数据通道传输流程 ................................................................................................. 89 6.4. BLE GATT Server 使用流程 ...................................................................................................... 90 7 附录 A 参考文档及术语缩写................................................................................................................ 92 8 附录 B BLE 特征权限位域 ................................................................................................................... 94 上海移远通信技术股份有限公司 6 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 表格索引 表 1：AT 命令类型.......................................................................................................................................11 表 2：参考文档 ........................................................................................................................................... 92 表 3：术语缩写 ........................................................................................................................................... 92 表 4：BLE 特征权限位域............................................................................................................................ 94 上海移远通信技术股份有限公司 7 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 图片索引 图 1：广播和扫描响应数据报文格式 .......................................................................................................... 24 图 2：BLE 广播状态时 RF 被 NB-IoT 抢占................................................................................................. 64 图 3：BLEAssistant 位置权限设置 ............................................................................................................. 67 图 4：BLEAssistant 主界面 ........................................................................................................................ 68 图 5：空闲状态扫描界面 ............................................................................................................................ 69 图 6：开启扫描界面.................................................................................................................................... 69 图 7：停止扫描界面.................................................................................................................................... 70 图 8：白名单菜单栏.................................................................................................................................... 70 图 9：白名单管理界面 ................................................................................................................................ 71 图 10：设备信息显示.................................................................................................................................. 72 图 11：连接显示界面.................................................................................................................................. 72 图 12：设备管理显示界面 .......................................................................................................................... 73 图 13：服务列表显示界面 .......................................................................................................................... 74 图 14：特征值读取显示界面....................................................................................................................... 75 图 15：特征值写入显示界面....................................................................................................................... 76 图 16：服务列表刷新.................................................................................................................................. 76 图 17：'未绑定'状态................................................................................................................................... 77 图 18：'绑定中'状态................................................................................................................................... 77 图 19：'已绑定'状态................................................................................................................................... 78 图 20：设备匹配场景 2............................................................................................................................... 78 图 21：设备匹配场景 3............................................................................................................................... 79 图 22：设备匹配场景 4............................................................................................................................... 79 图 23：L2CAP 界面.................................................................................................................................... 80 图 24：AT 对话框界面 ................................................................................................................................ 81 图 25：AT 输入界面.................................................................................................................................... 82 图 26：DFOTA 界面 ................................................................................................................................... 83 图 27：DFOTA 文件传输结束..................................................................................................................... 84 图 28：DFOTA 升级状态 ............................................................................................................................ 85 图 29：断点升级 ......................................................................................................................................... 85 图 30：BLE L2CAP 数据传输与 NB-IoT 共存使用流程.............................................................................. 87 上海移远通信技术股份有限公司 8 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 1 引言 移远通信 BC28-CNV 和 BC95-CNV NB-IoT 模块集成 BLE 5.0 版本及以下规范协议，传输速度高达 2 Mbps，满足多种场景下的近端互联要求。具有低功耗，低成本、高性能特点的 BLE 功能，以其丰富的应 用手段，极大扩展了 NB-IoT 模块在智能家居、智慧城市、共享单车、智能门锁等领域的应用。本文档主要 介绍如何通过 AT 命令快速使用 BC28-CNV 和 BC95-CNV 模块的 BLE 功能，以及 NB-IoT 与 BLE 共存状 态下的应用设计指导。 备注 移远通信 BC28-CNV 和 BC95-CNV 模块仅部分版本支持 BLE 功能，详情请咨询移远通信技术支持。 1.1. BLE 关键特性 ⚫ 集成 BLE 5.0 功能，支持 BLE 与 NB-IoT 共存； ⚫ BLE 与 NB-IoT 可以共用 RF 及前端器件，但在 NB-IoT 业务运行时，BLE 无法工作； ⚫ 仅支持 BLE Slave 模式； ⚫ 数据传输速率：2 Mbps、1 Mbps； ⚫ 支持扩展的数据包长度； ⚫ 支持一个 BLE 连接（不可同时连接多个设备）； ⚫ 支持安全传输：128 位 AES CCM 模式安全加密； ⚫ 提供安卓 App Demo 程序 BLEAssistant，方便二次开发； ⚫ 支持 AT Over BLE 功能； ⚫ 支持 DFOTA Over BLE 功能； ⚫ 支持 BLE 抓取维测信息； ⚫ 支持 BLE 白名单功能； ⚫ 支持 Class 1.5、Class 2 和 Class 3 发射输出功率； ⚫ 性能： − 接收灵敏度：-96 dBm @ 1 M PHY − 发射功率：+10.5 dBm ⚫ 功耗： − 深睡眠功耗：2 μA @ 3.6 V − 发送功耗：28 mA（10 dBm）@ 3.6 V − 接收功耗：20 mA @ 3.6 V − 广播功耗：10 μA（10.24 秒广播周期）@ 3.6 V 上海移远通信技术股份有限公司 9 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 备注 功耗指标为基带芯片在 NB-IoT 处于 PSM 状态下的标称值，实际测试耗流会略有差异，详情请咨询移远 通信技术支持。 1.2. 典型应用场景 ⚫ 燃气表手机预付费 − 用户 IC 卡充值，必须在指定网点现场通过 NB-IoT 网络充值，存在延迟； − 用户手机 BLE 充值更方便快捷。 ⚫ 燃气表自动关阀 − 可燃气体检测器报警后联动燃气表关阀； − BLE 连接解决传统有线方案的布线痛点。 ⚫ 水表、气表近端维护 − 漏报补抄； − 近端 OTA 升级； − 产线生产校准； − 现场参数配置； − 现场故障定位。 ⚫ 烟感近端维护 − 功能性测试； − 参数校准； − 故障定位。 ⚫ 共享单车手机开锁 − 现有单车锁具，BLE 是必需的； − 蜂窝网络繁忙时，自动切换为 BLE 开锁。 ⚫ 智能门锁近端互联 − 密码、指纹信息修改； − 参数配置。 上海移远通信技术股份有限公司 10 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2 BLE 相关 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 11 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. BLE 相关 AT 命令详解 2.3.1. GAP AT 命令 2.3.1.1. AT+BLEPWR 开启/关闭 BLE 协议栈 该命令用于开启或关闭 BLE 协议栈。在下发其他 BLE 相关 AT 命令之前，须先下发开启 BLE 协议栈 的命令。该命令为异步命令，启动成功后通过异步事件+BLECMPEVT 通知相关信息。 AT+BLEPWR 开启/关闭 BLE 协议栈 查询命令 响应 AT+BLEPWR? +BLEPWR: 设置命令 AT+BLEPWR= OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 +BLECMPEVT:0xfcfe 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 12 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 参数 整型。BLE 协议栈状态。 0 关闭状态 1 开启状态 2 关闭过程中 3 启动过程中 4 初始化过程中 7 RF 被 NB-IoT 抢占 整型。控制蓝牙协议栈的开关标识。 0 关闭 BLE 协议栈 1 开启 BLE 协议栈 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK //开启 BLE 协议栈 +BLECMPEVT:0xfcfe AT+BLEPWR? +BLEPWR:1 //BLE 协议栈开启成功 //查询 BLE 协议栈状态 //BLE 协议栈开启状态 OK AT+BLEPWR=0 OK //关闭 BLE 协议栈 +BLECMPEVT:0xfcfe AT+BLEPWR? +BLEPWR:0 //BLE 协议栈关闭成功 //查询 BLE 协议栈状态 //BLE 协议栈关闭状态 OK 2.3.1.2. AT+BLEDEVINIT 初始化 BLE 设备 该命令用于初始化 BLE 设备。初始化完成后，设备中之前存储的信息（BLE 设备名称、白名单、配对 绑定信息及服务器端创建的服务等）将被清空，设备地址仍然为上次设置的地址。 在协议栈开启时，该命令为异步命令，初始化的结果通过异步事件+BLECMPEVT 上报。协议栈关闭 时，也支持该命令，初始化后协议栈仍然是关闭状态，此时该命令是同步命令。 上海移远通信技术股份有限公司 13 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 AT+BLEDEVINIT 执行命令 AT+BLEDEVINIT 初始化 BLE 设备 响应 OK 当 BLE 协议栈为打开状态时，上报异步事件： +BLECMPEVT:0xfcff 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR? +BLEPWR:0 //查询 BLE 协议栈状态 //BLE 协议栈关闭状态 OK AT+BLEDEVINIT OK AT+BLEPWR=1 OK //初始化 BLE 设备 //初始化成功，仅返回 OK //开启 BLE 协议栈 +BLEPWR:0xfcfe AT+BLEPWR? +BLEPWR:1 //BLE 协议栈开启状态 OK AT+BLEDEVINIT OK //初始化 BLE 设备 +BLECMPEVT:0xfcff //初始化成功 上海移远通信技术股份有限公司 14 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.3.1.3. AT+BLESTATE 获取 BLE 协议栈状态 该命令用于查询 BLE 协议栈当前状态。 AT+BLESTATE 获取 BLE 协议栈状态 查询命令 响应 AT+BLESTATE? +BLESTATE: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。BLE 协议栈当前状态。 0 关闭状态 1 开启状态 2 关闭过程中 3 启动过程中 4 初始化过程中 5 广播中 6 连接中 7 RF 被 NB-ToT 抢占 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK //开启 BLE 协议栈 +BLECMPEVT:0xfcfe AT+BLESTATE? +BLESTATE:1 //查询 BLE 协议栈当前状态 //BLE 协议栈开启状态 OK AT+BLESETADVDATA='06094243323856','' //设置 BLE 广播数据 OK 上海移远通信技术股份有限公司 15 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 AT+BLEADV=1,480,480,0xffffffff,0,0,0,'',7,0 //开启 BLE 广播 OK +BLECMPEVT:0x200a AT+BLESTATE? +BLESTATE:5 //开启 BLE 广播成功 //查询 BLE 协议栈当前状态 //广播中 OK +BLEGATCCON:64,7C24A062CABF,1,1,0 AT+BLESTATE? +BLESTATE:6 //BLE 客户端连接接入 //查询 BLE 协议栈当前状态 //连接中 OK 2.3.1.4. AT+BLEADDR 获取 BLE 设备地址 该命令用于获取 BLE 设备地址。 AT+BLEADDR 获取 BLE 设备地址 查询命令 响应 AT+BLEADDR? +BLEADDR: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。BLE 设备地址。48 位地址以十六进制数串表示，如 A662616202C4。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR? +BLEPWR:0 上海移远通信技术股份有限公司 16 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 OK AT+BLEADDR? ERROR AT+BLEPWR=1 OK //需在 BLE 开启状态下查询地址，否则响应错误 +BLECMPEVT:0xfcfe AT+BLEADDR? +BLEADDR:A662616202C3 OK 2.3.1.5. AT+BLENAME 设置 BLE 设备名称 该命令用于配置和读取 BLE 设备名称，为同步命令。 AT+BLENAME 设置 BLE 设备名称 查询命令 响应 AT+BLENAME? +BLENAME:[] OK 设置命令 AT+BLENAME= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。BLE 设备名称。大小不超过 63 字节，BLE 设备名称不支持转义符。 默认无设备名称。 错误码。详情请参考文档 [1]。 上海移远通信技术股份有限公司 17 / 94 举例 AT+BLEPWR? +BLEPWR:0 OK AT+BLENAME? ERROR AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLENAME? +BLENAME: OK AT+BLENAME='NB-IOT' OK AT+BLENAME? +BLENAME:NB-IOT OK BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 //查询 BLE 协议栈状态 //查询 BLE 设备名称 //需在 BLE 协议栈开启状态下查询 BLE 设备名称，否则响应错误 //开启 BLE 协议栈 //查询 BLE 设备名称 //默认无 BLE 设备名称 //设置 BLE 设备名称 //查询 BLE 设备名称 2.3.1.6. AT+BLEWLSTADD 向白名单添加 BLE 设备 该命令用于向白名单添加 BLE 设备。执行命令后，若添加的地址格式不正确，则通过 ERROR 或+CME ERROR: 上报错误通知；若设备处于广播态并且在广播策略中使用了白名单，则通过异步事件 +BLEERREVT 上报错误通知。白名单中最多包含 8 个设备，超过 8 个时，本次添加失败，并通过异步事 件+BLEERREVT 上报错误通知。命令执行成功后，上报完成事件+BLECMPEVT。 AT+BLEWLSTADD 向白名单添加 BLE 设备 设置命令 响应 AT+BLEWLSTADD=, OK 添加成功，上报异步事件： +BLECMPEVT:0x2011 添加失败，上报异步事件： +BLEERREVT:0x2011, 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 18 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 最大响应时间 特性说明 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 KV。 参数 字符串类型。待添加的 BLE 设备地址。48 位地址以十六进制数串表示，每个字节 之 间 可 以 加 ' : '（ 英 文 冒 号 ）， 也 可 以 不 加 ， 如 'A662616202C3' 或 'A6:62:61:62:02:C3'。 整型。BLE 设备地址类型。 0 未加密的设备公共地址（public address） 1 未加密的设备随机地址（random address） 整型。错误原因。详情请参考第 3.1.2 章。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR? +BLEPWR:0 OK AT+BLEWLSTADD='A662616202C4',0 ERROR //需在 BLE 协议栈开启状态下添加 BLE 设备至白名单，否则响应错误 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEWLSTADD='A662616202C4',0 OK +BLECMPEVT:0x2011 2.3.1.7. AT+BLEWLSTRM 从白名单删除 BLE 设备 该命令用于从白名单中删除 BLE 设备。执行命令后，若输入的地址格式不正确，则通过 ERROR 或+CME ERROR: 上报错误通知；若本端设备处于广播态且在广播策略中使用了白名单，则通过异步事件 +BLEERREVT 上报错误通知。若删除的设备不在白名单中，则通过异步事件+BLEERREVT 上报错误通知。 命令执行成功后，上报完成事件+BLECMPEVT。 上海移远通信技术股份有限公司 19 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 AT+BLEWLSTRM 从白名单删除 BLE 设备 设置命令 响应 AT+BLEWLSTRM=, OK 若删除成功，上报异步事件： +BLECMPEVT:0x2012 若删除失败，上报异步事件： +BLEERREVT:0x2012, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 字符串类型。待删除的 BLE 设备的地址。48 位地址以十六进制数串表示，每个字 节 之 间 可 以 加 ' : '（ 英 文 冒 号 ）， 也 可 以 不 加 。 如 'A662616202C4' 或 'A6:62:61:62:02:C4'。 整型。BLE 设备地址类型。 0 未加密的设备公共地址（public address） 1 未加密的设备随机地址（random address） 整型。错误原因。详情请参考第 3.1.2 章。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR? +BLEPWR:0 OK AT+BLEWLSTRM='A662616202C4',0 ERROR //需在 BLE 协议栈开启状态下删除白名单中 BLE 设备，否则响应错误 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEWLSTRM='A662616202C4',0 上海移远通信技术股份有限公司 20 / 94 OK +BLECMPEVT:0x2012 //删除成功 AT+BLEWLSTRM='A662616202C4',0 OK +BLEERREVT:0x2012,18 //删除失败 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.3.1.8. AT+BLEWLST 查询白名单 该命令用于查询本端设备白名单中包含的 BLE 设备地址。 AT+BLEWLST 查询白名单 查询命令 AT+BLEWLST? 响应 [+BLEWLST:,] […] 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。白名单中的 BLE 设备地址。48 位地址以十六进制数串表示，如 A662616202C4。 整型。BLE 设备地址类型。 0 未加密的设备公共地址（public address） 1 未加密的设备随机地址（random address） 错误码。详情请参考文档 [1]。 举例 AT+BLEWLST? OK AT+BLEWLSTADD='A662616202C4',0 OK 上海移远通信技术股份有限公司 21 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 +BLECMPEVT:0x2011 AT+BLEWLST? +BLEWLST:A662616202C4,0 OK AT+BLEWLSTADD='A662616202C5',0 OK +BLECMPEVT:0x2011 AT+BLEWLST? +BLEWLST:A662616202C4,0 +BLEWLST:A662616202C5,0 OK 2.3.1.9. AT+BLEWLSTCLR 清空白名单 该命令用于清空本端设备白名单。该命令执行完成后，之前配置的白名单中 BLE 设备全部失效。若本 端设备处于广播态且在广播策略中使用了白名单，则通过异步事件+BLEERREVT 上报错误通知。命令执行 成功后，上报完成事件+BLECMPEVT。 AT+BLEWLSTCLR 清空白名单 执行命令 响应 AT+BLEWLSTCLR OK 最大响应时间 特性说明 若清空白名单成功，上报异步事件: +BLECMPEVT:0x2010 若清空白名单失败，上报异步事件: +BLEERREVT:0x2010, 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 22 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 参数 整型。错误原因。详情请参考第 3.1.2 章。 错误码。详情请参考文档 [1]。 举例 AT+BLEWLSTCLR OK +BLECMPEVT:0x2010 2.3.1.10. AT+BLERPAMODE 开启/关闭可解析地址功能 该命令用于启用或者关闭可解析地址功能，且只能在 BLE 空闲状态下使用。BLE 广播、扫描和连接态 下执行该命令，均会通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLERPAMODE 开启/关闭可解析地址功能 查询命令 AT+BLERPAMODE? 响应 +BLERPAMODE: OK 设置命令 AT+BLEPRAMODE= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或关闭可解析地址的功能。 0 关闭可解析地址功能 上海移远通信技术股份有限公司 23 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 1 启用可解析地址功能 错误码。详情请参考文档 [1]。 举例 AT+BLERPAMODE? +BLERPAMODE:0 OK AT+BLERPAMODE=1 OK //查询可解析地址是否使能 //启用可解析地址功能 2.3.1.11. AT+BLESETADVDATA 设置广播和扫描响应数据 该命令用于设置广播及扫描响应数据，连接状态下不允许下发该命令。若只需设置广播数据，则扫描 响应数据参数应为'（' 英文空引号）；若只需设置扫描响应数据，则广播数据参数 应为''（英文空引号）。广播和扫描响应数据的报文格式相同，如下图所示： Data Significant part AD Structure 1 AD Structure 2 ... Non-Significant part AD Structure N 000...000b 1 octet Length Length octets Data 1 octet AD Type Length – n octets AD Data 图 1：广播和扫描响应数据报文格式 AT+BLESETADVDATA 设置广播和扫描响应数据 设置命令 响应 AT+BLESETADVDATA=, OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 24 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 最大响应时间 特性说明 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串类型。广播数据。由以下三个字段组成（即多个 AD Structure 组成），组成 方式符合上图的报文格式，内容必须是十六进制的数串。 Length：AD Structure 的长度，包括 AD Type 和 AD Data 的长度，不包含 Length 本身的 1 字节。最大 0x1e，即数据域最大长度为 30 字节。 AD Type：1 字节，该广播数据所属的类型，如功耗级别 TX Power Level(0x0A)、 设备名称 Local Name(0x09)、角色 Le Role(0x1C)、服务标识 Service UUIDs(0x16) 等。对端扫描到广播后，可以根据 AD Type 判断出广播数据的意义。关于 AD Type 的类型和含义取值，请参考 Bluetooth Core Specification 5.0。 AD Data：广播数据内容，以大端模式组织。 字符串类型。扫描响应数据。报文格式与广播数据相同。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLESETADVDATA='0709424332383056','020a01' OK 2.3.1.12. AT+BLEADV 开启/关闭广播 该命令用于开启或关闭本端设备的广播功能。广播参数为可选参数，为 1 时开启广播，命令中 需要设置广播参数；为 0 时关闭广播，命令中没有广播参数。下发的参数不符合协议要求或命令格 式不正确时，通过 ERROR 或+CME ERROR: 上报错误通知。设备在 BLE 连接状态或者正在广播时， 不能下发该命令，否则通过异步事件+BLEERREVT 上报错误通知。广播成功开启后，上报完成事件 +BLECMPEVT。查询命令用来获取协议栈当前使用的广播参数。协议栈不在广播态时，返回的结果中 为 0，没有广播参数，否则为 1，同时上报当前广播参数。 AT+BLEADV 查询命令 AT+BLEADV? 开启/关闭广播 响应 +BLEADV:[,,,,,,,,,] OK 设置命令 AT+BLEADV=[,,,,,,,,,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若设置广播成功，上报异步事件： +BLECMPEVT:0x200a 若设置广播失败，上报异步事件： +BLEERREVT:0x200a, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效。 参数配置不保存。 参数 整型。开启或关闭广播。 0 关闭广播，无需携带广播参数 1 开启广播，需要携带广播参数 整型。广播间隔的最小值。范围：32~65535；单位：timeslot。对应的时间范围： 20 毫秒~40.96 秒（1 timesolt = 625 μs）。 整型。广播间隔的最大值。范围：32~65535；单位：timeslot。对应的时间范围： 20 毫秒~40.96 秒（1 timesolt = 625 μs）。的值不小于 的值。 整型。本次广播的持续时间。范围：1~0xffffffff；单位：毫秒。设置的值大于 180 秒时会被限制成持续时间 180 秒；如果需要持续广播，该值设置成 0xffffffff。如果 广播类型是高占空比定向广播，那么最多只能广播 1.28 秒。 整型。广播类型。 0 可连接的非定向广播（CONNECTABLE UNDIRECTED） 1 可 连 接 的 高 占 空 比 定 向 广 播 （ CONNECTABLE HIGH DUTY CYCLE DIRECTED） 上海移远通信技术股份有限公司 26 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2 可扫描的非定向广播（SCANNABLE UNDIRECTED） 3 不可连接的非定向广播（NON CONNECTABLE UNDIRECTED） 4 可 连 接 的 低 占 空 比 定 向 广 播 （ CONNECTABLE LOW DUTY CYCLE DIRECTED） 整型。本端设备地址类型。设备地址可解析功能关闭时，地址类型应为 0，设备地 址可解析功能开启时，地址类型应为 1。 0 未加密的设备公共地址（public address） 1 设备的公共地址加密后生成的可解析地址。 整型。对端设备地址类型。共有两种地址类型。 0 未加密的设备公共地址（public address） 1 未加密的设备随机地址（random address） 字符串类型。对端设备地址。48 位地址以十六进制数串表示，设置命令中每个字节 之 间 可 以 加 ' : '（ 英 文 冒 号 ）， 也 可 以 不 加 ， 如 'A662616202C4' 或 'A6:62:61:62:02:C4'；查询命令返回结果中不带':'，如'A662616202C4'；广播 类型为非定向广播时，该值可为空。当开启广播时下发的参数中为空 时，查询广播参数命令的返回结果中的内容为'000000000000'。 整型。发送该广播报文的信道。共有三个广播信道：37、38、39，可使用 3 bit 进 行表示，使用 1~7 的数字表示三个信道之间的组合。 1 广播信道 37 2 广播信道 38 3 广播信道 37、38 4 广播信道 39 5 广播信道 37、39 6 广播信道 38、39 7 广播信道 37、38、39 整型。广播过滤策略。 0 不采取任何过滤措施，任何设备都可以对其扫描、连接 1 只允许白名单中的设备对其扫描，允许任何设备进行连接 2 允许任意设备对其扫描，只允许白名单设备对其连接 3 只允许白名单中的设备对其扫描和连接 整型。错误原因。详情请参考第 3.1.2 章。 错误码。详情请参考文档 [1]。 备注 如需重新配置广播参数，需先关闭广播后才可设置。 举例 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe 上海移远通信技术股份有限公司 27 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 AT+BLEADV? +BLEADV:0 OK AT+BLEADV=1,480,480,0xffffffff,0,0,0,'',7,0 OK //开启 BLE 广播 +BLECMPEVT:0x200a AT+BLEADV? +BLEADV:1,480,480,4294967295,0,0,0,000000000000,7,0 //开启 BLE 广播成功 //查询 BLE 广播 OK AT+BLEADV=0 OK //关闭 BLE 广播 +BLECMPEVT:0x200a AT+BLEADV=1,32,32,0xffffffff,0,0,0,'',7,0 OK +BLECMPEVT:0x200a 2.3.1.13. AT+BLEDISC 断开连接 该命令用于断开已存在的连接。当连接句柄对应的连接不存在时，通过 ERROR 或+CME ERROR: 上报错误通知。断开连接成功后，通过连接事件+BLEGATCCON 上报结果。 AT+BLEDISC 断开连接 设置命令 响应 AT+BLEDISC= OK +BLEGATCCON:,,,, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 28 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 参数 整型。BLE 连接句柄。 字符串类型。对端设备地址。48 位地址以十六进制数串表示，如'A662616202C4'。 整型。对端设备地址类型。 0 未加密的设备公共地址（public address） 1 未加密的设备随机地址（random address） 整型。连接状态。 0 断开连接 1 连接 整型。错误原因。详情请参考第 3.1.1 章。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEADV=1,32,32,0xffffffff,0,0,0,'',7,0 OK +BLECMPEVT:0x200a AT+BLESETADVDATA='06094E42494F54','020a01' OK +BLEGATCCON:64,7C24A062CABF,1,1,0 AT+BLEDISC=64 OK //BLE 客户端连接接入 +BLEGATCCON:64,7C24A062CABF,1,0,22 //BLE 断开连接成功 2.3.1.14. AT+BLEPARAMUPDATE 更新连接参数 该命令用于更新连接参数。如果命令中的参数不符合协议要求或者命令格式正确时，通过 ERROR 或 +CME ERROR: 上报错误通知。更新成功后，最终的连接参数通过异步事件+BLEPARAMUPDATE 上报。参数设置范围按照 BLE 协议公式要求： × 10 > (1 + ) × × 2 × 1.25。 AT+BLEPARAMUPDATE 更新连接参数 设置命令 响应 AT+BLEPARAMUPDATE=,,,, 最大响应时间 特性说明 更新成功后，上报异步事件: +BLEPARAMUPDATE:,,, 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。BLE 连接句柄。 整型。连接事件间隔最小值。范围：6~3200；单位：1.25 毫秒；对应的时间范围： 7.5 毫秒~4 秒。 整型。连接事件间隔最大值。范围：6~3200；单位：1.25 毫秒；对应的时间范围： 7.5 毫秒~4 秒。 整型。连接事件间隔值。单位：1.25 毫秒。 整型。从设备延时对应的的数目，即从设备最多忽略主设备数据包的个 数。范围：0~499。 整型。监控超时时间。如果在该时间段内，双方没有数据交互，就会断开连接。 取值范围：10~3200；单位：10 毫秒；对应的时间范围：100 毫秒~32 秒。 错误码。详情请参考文档 [1]。 举例 +BLEGATCCON:64,7C24A062CABF,1,1,0 AT+BLEPARAMUPDATE=64,480,480,5,3200 OK +BLEPARAMUPDATE:64,480,5,3200 //BLE 客户端连接接入 2.3.1.15. AT+BLEDATASEND 发送数据 该命令用于向对端 BLE 设备发送数据。在发送数据之前，需要对端设备创建 L2CAP 通道。 AT+BLEDATASEND 发送数据 设置命令 响应 AT+BLEDATASEND=, 上海移远通信技术股份有限公司 30 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。BLE 连接句柄。 不带双引号的十六进制字符串类型。发送的数据内容。长度必须为偶数，单次支持的数 串最大长度为 2048 个字符。 错误码。详情请参考文档 [1]。 举例 +BLEGATCCON:64,661822DECF30,1,1,0 AT+BLEPAIRCFG=0,0,0 OK +BLETKSHOW:64,661822DECF30,136289 +BLEPAIRDONE:64,0 +BLEDATACONN:64 AT+BLEDATASEND=64,1234 OK //BLE 客户端连接接入 //设备 BLE 配对能力 //客户端发起配对请求 //配对成功 //L2CAP 通道创建成功 //发送数据，对端 BLE 的 L2CAP 通道可以收到该数 据 1234 2.3.1.16. AT+BLEGATCGETMTU 查询最大传输单元 该命令用于查询两端设备当前使用的最大传输单元。参数不符合要求（句柄不存在）或者命令格式错 误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEGATCGETMTU 查询最大传输单元 设置命令 响应 AT+BLEGATCGETMTU= +BLEGATCGETMTU: OK 若出现任何错误： 上海移远通信技术股份有限公司 31 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 300 毫秒 /、 参数 整型。BLE 连接句柄。 整型。最大传输单元值。范围：23~517；单位：字节。 错误码。详情请参考文档 [1]。 举例 +BLEGATCCON:64,7C24A062CABF,1,1,0 AT+BLEGATCGETMTU=64 +BLEGATCGETMUT:23 OK //BLE 客户端连接接入 2.3.1.17. AT+BLETXPWR 设置链路发射功率级别 该命令用于设置链路传输功率级别。可以在连接之前设置链路的功率级别，连接创建后即可使用设定 好的功率发送报文。读取命令读取当前链路的发射功率值，链路不存在时，通过+BLEERREVT 上报错误通 知。参数不符合要求或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLETXPWR 设置链路发射功率级别 查询命令 响应 AT+BLETXPWR? OK 当链路存在时，上报： +BLETXPWR: 设置命令 当链路不存在时，上报： +BLEERREVT:0x0c2d, 若出现任何错误： ERROR 或者 +CME ERROR: 响应 上海移远通信技术股份有限公司 32 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 AT+BLETXPWR= 最大响应时间 特性说明 OK +BLECMPEVT:0xfc3b 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。链路发射功率等级。共 8 个等级，范围：0~7。 整型。对应的功率值。单位：dB。 和对应关系如下： 0 -20 1 -16 2 -12 3 -9 4 -5 5 0 6 5 7 10 整型。错误原因。详情请参考第 3.1.2 章。 错误码。详情请参考文档 [1]。 举例 AT+BLETXPWR=6 OK +BLECMPEVT:0xfc3b //设置链路发射功率级别成功 +BLEGATCCON:64,7C24A062CABF,1,1,0 AT+BLETXPWR? OK //BLE 客户端连接接入 +BLETXPWR:5 +BLEGATCCON:64,7C24A062CABF,1,0,19 //BLE 客户端发起连接断开 上海移远通信技术股份有限公司 33 / 94 AT+BLETXPWR? OK +BLEERREVT:0x0c2d,2 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 //BLE 连接断开后，不能读取链路发射功率级别 2.3.1.18. AT+BLEADVPWR 设置广播链路功率级别 该命令用于设置广播链路传输功率级别。可以在使能广播之前设置链路的功率级别，使能广播后即可 使用设定好的功率发送广播报文。参数不符合要求或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEADVPWR 查询命令 AT+BLEADVPWR? 设置广播链路功率级别 响应 OK +BLEADVPWR: 设置命令 AT+BLEADVPWR= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 当设置成功时，上报异步事件： +BLECMPEVT:0xfc3b 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。广播链路发射功率等级。共 8 个等级。范围：0~7。 整型。对应的功率值。单位：dB。 和对应关系如下： 0 -20 上海移远通信技术股份有限公司 34 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 1 -16 2 -12 3 -9 4 -5 5 0 6 5 7 10 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEADVPWR=2 OK +BLECMPEVT:0xfc3b AT+BLEADVPWR? OK //设置广播链路发射功率级别成功 +BLEADVPWR:-12 2.3.1.19.AT+BLEOTAMODE 设置 BLE DFOTA 升级模式 该命令用于设置 BLE DFOTA 升级的模式，分为手动确认模式和自动升级模式，默认为手动升级模式。 AT+BLEOTAMODE 设置 BLE DFOTA 升级模式 查询命令 响应 AT+BLEOTAMODE? +BLEOTAMODE: OK 设置命令 AT+BLEOTAMODE= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 若出现任何错误： ERROR 上海移远通信技术股份有限公司 35 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 最大响应时间 特性说明 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。BLE DFOTA 升级模式。 0 手动确认模式 1 自动升级模式 错误码。详情请参考文档 [1]。 举例 AT+BLEOTAMODE? +BLEOTAMODE:0 OK AT+BLEOTAMODE=1 OK //默认为手动确认模式 //设置为自动升级模式 2.3.1.20.AT+BLEOTARSP 设置 BLE DFOTA 升级请求响应 该命令用于在手动确认模式下响应 BLE DFOTA 升级请求。 AT+BLEOTARSP 设置 BLE DFOTA 升级响应 设置命令 AT+BLEOTARSP= 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 36 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 参数 整型。BLE DFOTA 升级请求响应。 0 拒绝升级 1 同意升级 错误码。详情请参考文档 [1]。 举例 //省略 BLE 开启、连接过程的示例。升级开始 AT+BLEOTAMODE? +BLEOTAMODE:0 //默认为手动确认模式 OK +BLEFOTAEVT:0 AT+BLEOTARSP=0 OK //BLE DFOTA 升级请求 //拒绝升级 +BLEFOTAEVT:0 //BLE DFOTA 升级请求 OK AT+BLEOTARSP=1 OK //同意升级 +BLEFOTAEVT:1 //固件开始下载 +BLEFOTAEVT:3 //固件传输完成 +BLEFOTAEVT:4 //固件开始升级 REBOOT_CAUSE_SECURITY_FOTA_UPGRADE Neul OK //升级重启 FIRMWARE UPDATE SUCCESS //升级成功 FIRMWARE UPDATE OVER //省略 BLE 开启、连接过程的示例。升级开始 +BLEFOTAEVT:0 //升级结束 //BLE DFOTA 升级请求 +BLEFOTAEVT:5 +BLEFOTAEVT:0 //BLE DFOTA 升级请求超过 2 分钟，没有发送升级 响应命令 AT+BLEOTARSP，上报升级超时事件。 //BLE DFOTA 升级请求 上海移远通信技术股份有限公司 37 / 94 AT+BLEOTARSP=1 OK +BLEFOTAEVT:1 +BLEFOTAEVT:2 +BLEFOTAEVT:0 AT+BLEOTARSP=1 OK +BLEFOTAEVT:1 +BLEFOTAEVT:3 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 //同意升级 //固件开始下载 //升级中断（App 端暂停升级） //BLE DFOTA 恢复升级请求 //同意升级 //固件开始下载 //固件传输完成，后续操作同前面示例，继续完成升 级动作。 2.3.2. GATT SERVER AT 命令 2.3.2.1. AT+BLEGATADDS 添加服务 该命令用于添加服务。参数不符合要求或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEGATADDS 添加服务 设置命令 AT+BLEGATAADDS=,,[,] 最大响应时间 特性说明 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。服务的唯一标识。添加服务时要保证每个服务的 ID 唯一。范围：0~65535。 字符串类型。服务的 UUID。该参数是一个 16 位或 128 位的数，使用十六进制的数串 表示。注意：对应的数串为 4 字节或 32 字节，并且前面不能添加 0x 或者 0X。 整型。是否为首要服务。 1 首要服务 上海移远通信技术股份有限公司 38 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2 次要服务 整型。若该服务包含在另一个服务中，则需配置此参数，内容为所包含服务的 值。若该服务未包含在另一服务中，则省略该参数。范围：0~65535。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEGATADDS=0,181b,1 OK 2.3.2.2. AT+BLEGATADDC 添加特征 该命令用于向指定服务添加特征。参数不符合要求或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEGATADDC 添加特征 设置命令 AT+BLEGATADDC=,,,[,] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。在添加服务时指定的，该特征所属服务的唯一标识。范围：0~65535。 整型。特征在特定服务中的唯一标识。添加特征时要保证每个服务下的每个特征的 ID 值唯一。范围：0~65535。 不带双引号的十六进制字符串类型。特征的 UUID。该参数是一个 16 位或 128 位 的数。对应的字符串为 4 字节或 32 字节，并且前面不能添加 0x 或者 0X。 不带双引号的十六进制字符串类型。特征权限。使用 bit 位表示可对该特征进行哪 些操作。该参数是一个 16 位的数。详细定义见第 8 章。 不带双引号的十六进制字符串类型。特征属性的初始值。该值为可选项，如果不下 发该值，默认为空。长度必须为偶数且超过 512 字节。 上海移远通信技术股份有限公司 39 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEGATADDS=0,181b,1 OK AT+BLEGATADDC=0,0,2a06,0x3a OK 2.3.2.3. AT+BLEGATADDD 添加特征描述符 该命令用于向指定特征添加特征描述符。参数不符合要求或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEGATADDD 添加特征描述符 设置命令 AT+BLEGATADDD=,,,,[,] 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。在添加服务时指定的，该特征所属服务的唯一标识。范围：0~65535。 整型。该描述符所属特征的 ID。添加特征时要保证每个服务下的每个特征的 ID 值 唯一。范围：0~65535。 整型。描述符在特定特征中的唯一标识。添加描述符时要保证在同一特征下每个描 述符的 ID 是唯一的。范围：0~65535。 不带双引号的十六进制字符串类型。该描述符的 UUID。该参数是一个 16 位或 128 位的数。对应的数串为 4 字节或者 32 字节，并且前面不能添加 0x 或者 0X。 不带双引号的十六进制字符串类型。特征描述符的权限。使用 bit 位标识可对该特 征进行哪些操作。该参数是一个 16 位的数。详细定义与特征值的权限定义相同。 上海移远通信技术股份有限公司 40 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 详细定义见第 8 章。 不带双引号的十六进制字符串。描述符属性的初始值。该值为可选项，如果不下发 该值，默认为 0。长度必须为偶数且不超过 512 字节。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEGATADDS=0,181b,1 OK AT+BLEGATADDC=0,0,2a06,0x3a OK AT+BLEGATADDD=0,0,0,2902,0x3a,0100 OK 2.3.2.4. AT+BLEGATSST 启动服务 该命令用于将之前添加的服务、特征、描述符进行注册。添加服务、特征、描述符后，必须下发该 AT 命令，才会真正完成服务的添加。添加成功后，返回每个服务、特征、描述符对应的属性句柄。每个服务 单独换行，并且使用'{}'括起来，每个特征及特征描述符均使用'{}'括起来。添加服务之前不能下发该 命令，否则直接返回 ERROR 或+CME ERROR: 。 AT+BLEGATSST 启动服务 执行命令 AT+BLEGATSST 响应 [+BLEGATSST:{:,{:,{:}…},{:…}}] [+BLEGATSST:{:…}] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 41 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 参数 整型。在添加服务时指定的，服务的唯一标识。详情请参考第 2.3.2.1 章。 整型。服务添加完成后，为它分配的属性句柄。 整型。在添加特征时指定的，特征的唯一标识。详情请参考第 2.3.2.2 章。 整型。特征添加完成后，为特征值分配的属性句柄。 整型。在添加特征描述符时指定的，特征描述符的唯一标识。详情请参考第 2.3.2.3 章。 整型。特征描述符添加完成后，为特征描述符的值分配的属性句柄。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEGATADDS=0,181b,1 OK AT+BLEGATADDC=0,0,2a06,0x3a OK AT+BLEGATADDD=0,0,0,2902,0x3a,0100 OK AT+BLEGATSST +BLEGATSST:{0:14,{0:16,{0:17}}} OK AT+BLESETADVDATA='06094E42494F54','' OK AT+BLEADV=1,32,32,0xffffffff,0,0,0,'',7,0 OK +BLECMPEVT:0x200a +BLEGATCCON:64,661822DECF30,1,1,0 AT+BLEGATSIND=64,16,31323334353637383930 OK +BLEGATRREQ:16,0 AT+BLEGATRDATT=16 +BLEGATRDATT:31323334353637383930 OK +BLEGATWREQ:16,0,313233343536373899 //设置广播数据 //开启广播并配置广播参数 //BLE 客户端连接接入 //更新属性值并向客户端发送通知和指示 //读取属性值 上海移远通信技术股份有限公司 42 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 AT+BLEGATWRATT=16,AABBCCDD OK //写入属性值 +BLEGATRREQ:16,0 AT+BLEGATRDATT=16 +BLEGATRDATT:AABBCCDD //读取属性值 OK AT+BLEGATSIND=64,17,11223344556677880099AA OK //更新属性值并向客户端发送通知和指示 +BLEGATRREQ:17,0 AT+BLEGATRDATT=17 +BLEGATRDATT:11223344556677880099AA OK 2.3.2.5. AT+BLEGATSRM 删除服务 该命令用于删除指定的服务，删除服务时，属于它的特征和描述符也会一并被删除。参数不符合要求 （删除句柄值不存在的服务）或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEGATSRM 删除服务 设置命令 响应 AT+BLEGATSRM= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。待删除服务的属性句柄。 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 上海移远通信技术股份有限公司 43 / 94 OK +BLECMPEVT:0xfcfe AT+BLEGATADDS=0,181b,1 OK AT+BLEGATADDC=0,0,2a06,0x3a OK AT+BLEGATADDD=0,0,0,2a0e,0x3a OK AT+BLEGATADDS=1,181b,1 OK AT+BLEGATADDC=1,0,2a06,0x3a OK AT+BLEGATADDD=1,0,0,2a0e,0x3a OK AT+BLEGATSST +BLEGATSST:{0:14,{0:16,{0:17}}} +BLEGATSST:{1:18,{0:20,{0:21}}} OK AT+BLEGATSRM=14 OK AT+BLEGATSRM=18 OK BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.3.2.6. AT+BLEGATRDATT 读取属性值 该命令用于根据属性的句柄读取属性值。属性句柄未配置属性值时，返回+BLEGATRDATT:；参数不 符合要求（属性句柄不存在时）或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通 知。 AT+BLEGATRDATT 读取属性值 设置命令 AT+BLEGATRDATT= 响应 +BLEGATRDATT:[] OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 44 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 最大响应时间 特性说明 300 毫秒 / 参数 整型。读取特征对应的属性句柄。 不带双引号的字符串类型。读取到的属性值。 错误码。详情请参考文档 [1]。 举例 AT+BLEGATRDATT=16 +BLEGATRDATT:1234 OK 2.3.2.7. AT+BLEGATWRATT 写入属性值 该命令用于根据属性的句柄写入属性值。参数不符合要求（属性句柄值不存在）或者命令格式错误时， 通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEGATWRATT 写入属性值 设置命令 响应 AT+BLEGATWRATT=, 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。待写入特征对应的属性句柄。 不带双引号的十六进制字符串类型。待写入的属性值。长度必须为偶数，且不超过 512 字节。 错误码。详情请参考文档 [1]。 上海移远通信技术股份有限公司 45 / 94 举例 AT+BLEGATWRATT=16,31323334353637383930 OK BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.3.2.8. AT+BLEGATSIND 更新属性值并向客户端发送通知和指示 该命令用于更新属性值并向客户端发送指示和通知。参数不符合要求或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。关于通知指示的详细用法请参考 Bluetooth Core Specification 5.0。 服务器端通知/指示（notify/indicate）配置步骤如下： 1. 服务器端通过 AT+BLEGATADDC 配置相应的为 Notify/Indicate。 2. 通过 AT+BLEGATADDD 对该特征配置 Client Characteristic Configuration（客户端特征配置）， 即必须可读可写。 3. 客户端使能接收通知/指示（notification/indication）功能：客户端对上述 CCCD（客户端特征配置 描述）的进行写操作。 AT+BLEGATSIND 更新属性值并向客户端发送通知和指示 设置命令 响应 AT+BLEGATSIND=,, 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。BLE 连接句柄。 整型。通知或指示的属性句柄。 不带双引号的十六进制字符串。通知或指示的属性值。长度必须为偶数，且不超过 512 字节。 错误码。详情请参考文档 [1]。 举例 AT+BLEGATSIND=64,16,31323334353637383930 OK 上海移远通信技术股份有限公司 46 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.3.3. SMP AT 命令 2.3.3.1. AT+BLEPAIRCFG 配对能力配置 该命令用于配置本端设备的配对能力，包括设备的输入输出（IO）能力、配对完成后是否绑定及链路 的安全等级。默认配置为：设备只有显示能力、没有输入能力；不需要绑定；链路不加密传输。参数不符 合要求或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEPAIRCFG 配对能力配置 设置命令 AT+BLEPAIRCFG=,, 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。设备输入输出能力。 0 设备只有显示能力，没有输入能力（DISPLAYONLY） 1 设备有显示能力，有输入 YES/NO 的能力（DISPLAYYESNO） 2 设备没有输出能力，有输入数字的能力（KEYBOARDONLY） 3 设备没有输出输入能力（NOINPUTNOOUTPUT） 4 设备具有输入数字和显示的能力（KEYBOARDDISPLAY） 整型。配对后是否需要绑定。 0 不需要绑定 1 需要绑定 整型。链路安全等级。 0 链路不加密传输（NO_ENCRYPTION） 1 链路加密传输，但没有鉴权（ENCRYPTION_NO_MITM） 2 链路加密鉴权传输（ENCRYPTION_WITH_MITM） 3 链路使用 ECDH 加密鉴权传输（SC_ENCRYPTION_WITH_MITM） 错误码。详情请参考文档 [1]。 举例 AT+BLEPWR=1 OK //开启 BLE 协议栈 上海移远通信技术股份有限公司 47 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 +BLECMPEVT:0xfcfe AT+BLEADDR? +BLEADDR:C441375CC78B //查询 BLE 地址 OK AT+BLESETADVDATA='06094E42494F54','020a01' OK AT+BLEADV=1,32,32,0xffffffff,0,0,0,'',7,0 OK //设置广播和扫描响应数据 //开启广播并配置广播参数 +BLECMPEVT:0x200a AT+BLEPAIRCFG=0,0,0 OK //设置输入输出能力，BLE 客户端端输入模块显 示的配对临时密钥完成配对 +BLEGATCCON:64,5F497609FCF8,1,1,0 //BLE 客户端连接接入 +BLEPARAMUPDATE:64,6,0,500 +BLEPARAMUPDATE:64,36,0,500 +BLETKSHOW:64,5F497609FCF8,646484 //BLE 客户端输入模块端显示的临时密钥 646484 +BLEPAIRDONE:64,0 //BLE 客户端发起配对，模块端上报临时密钥： 646484 //完成配对 +BLEGATCCON:64,5F497609FCF8,1,0,19 AT+BLEPAIRCFG=1,0,0 OK //BLE 客户端发起连接断开 //设置输入输出能力，通过 AT 命令模拟配对， 确认完成即可完成配对 +BLEGATCCON:64,5F497609FCF8,1,1,0 //BLE 客户端连接接入 +BLETKCONFIRM:64,5F497609FCF8,871457 AT+BLECONFIRM=64,1 OK //配对鉴权临时密钥确认事件 //模块端发起鉴权临时密钥比较，确认一致 +BLEPAIRDONE:64,0 //配对完成 +BLEGATCCON:64,5F497609FCF8,1,0,19 AT+BLEPAIRCFG=2,0,0 //BLE 客户端发起连接断开 //设置输入输出能力，模块端输入 BLE 客户端显 示的配对临时密钥即可完成配对 上海移远通信技术股份有限公司 48 / 94 OK +BLEGATCCON:64,5F497609FCF8,1,1,0 +BLEPTKIN:64 AT+BLESETAUTHTK=64,885247 OK +BLEPAIRDONE:64,0 +BLEGATCCON:64,5F497609FCF8,1,0,19 AT+BLEPAIRCFG=3,0,0 OK +BLEGATCCON:64,5F497609FCF8,1,1,0 +BLEPAIRDONE:64,3 +BLEGATCCON:64,5F497609FCF8,1,0,19 AT+BLEPAIRCFG=4,0,0 OK +BLEGATCCON:64,5F497609FCF8,1,1,0 +BLETKCONFIRM:64,5F497609FCF8,531515 AT+BLECONFIRM=64,1 OK +BLEPAIRDONE:64,0 AT+BLEDISC=64 OK +BLEGATCCON:64,5F497609FCF8,1,0,22 AT+BLEPWR=0 OK +BLECMPEVT:0xfcfe BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 //BLE 客户端连接接入 //鉴权输入临时密钥值通知事件 //885247 为 BLE 客户端显示的临时密钥 //配对完成 //BLE 客户端发起连接断开 //设置输入输出能力，BLE 设备输入输出能力不 足，配对失败 //BLE 客户端连接接入 //BLE 设备输入输出能力不足，配对失败 //连接自动断开 //设置输入输出能力，通过 AT 命令模拟配对确 认完成即可完成配对 //BLE 客户端连接接入 //配对鉴权临时密钥确认事件 //模块端发起鉴权临时密钥比较确认一致 //配对完成 //模块端发起断开连接 //BLE 连接主动断开 //关闭 BLE 协议栈 上海移远通信技术股份有限公司 49 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.3.3.2. AT+BLEPINSET 配置 BLE PIN 码 该命令用于配置 BLE PIN 码。仅在命令 AT+BLEPAIRCFG 设置输入输出能力为 0 时使用。 该命令分为设置固定 PIN 码和随机生成 PIN 码，默认为随机 PIN 码。为可选参数， 为 0 时，随机生成 PIN 码，命令中没有；为 1 时设置固定 PIN 码，必需配置。 参数不符合要求或者命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEPINSET 配置 BLE PIN 码 查询命令 响应 AT+BLEPINSET? +BLEPINSET:[,] OK 设置命令 AT+BLEPINSET=[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。BLE PIN 码输入模式。 0 随机 PIN 码 1 设置固定 PIN 码 不带双引号的字符串类型。设置的固定 PIN 码。长度为 6 个字节。 错误码。详情请参考文档 [1]。 举例 AT+BLEPINSET? +BLEPINSET:0 //查询 BLE PIN 码 上海移远通信技术股份有限公司 50 / 94 OK AT+BLEPINSET=1,123456 OK AT+BLEPINSET? +BLEPINSET:1,123456 OK AT+BLEPINSET=0,123321 ERROR AT+BLEPINSET=0 OK BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 //设置 BLE 固定 PIN 码 //查询 BLE 固定 PIN 码 //设置 BLE 随机 PIN 码，不允许携带参数 //设置随机 PIN 码携带了，因此响应错误 //关闭 BLE 固定 PIN 码，设置随机 PIN 码 2.3.3.3. AT+BLERMPAIR 删除配对 该命令用于删除配对。该命令中下发的地址不存在对应的配对绑定信息时也会返回 OK。用户可通过 AT+BLEBINDINFO? 查询已配对绑定的设备信息。参数不符合要求或者命令格式错误时，ERROR 或通过 +CME ERROR: 上报错误通知。 AT+BLERMPAIR 删除配对 设置命令 响应 AT+BLERMPAIR=, OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 不带双引号的字符串类型。待删除的设备地址。48 位地址以十六进制数串表示，每 个 字 节 之 间 可 以 加 ' : '（ 英 文 冒 号 ）， 也 可 以 不 加 。 如 A662616202C3 或 A6:62:61:62:02:C3。 整型。设备地址类型。 0 未加密的设备公共地址（public address） 1 未加密的设备随机地址（random address） 错误码。详情请参考文档 [1]。 上海移远通信技术股份有限公司 51 / 94 举例 AT+BLERMPAIR=661822DECF30,0 OK BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 2.3.3.4. AT+BLESETAUTHTK 鉴权 TK 输入 该命令用于向协议栈设置临时密钥（TK）。在万能钥匙（passkey entry）配对过程中，收到回调函数 上报的鉴权 TK 输入通知事件+BLEPTKIN 后，需要在 30 秒内输入 TK 值。如果在 30 秒内没有下发该命令 输入 TK 值，协议栈将触发超时机制，终止配对流程，配对失败。参数不符合要求或者命令格式错误时，通 过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLESETAUTHTK 鉴权 TK 输入 设置命令 响应 AT+BLESETAUTHTK=, OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。BLE 连接句柄。 不带双引号的字符串类型。BLE 客户端显示的临时配置密钥。 错误码。详情请参考文档 [1]。 举例 AT+BLESETAUTHTK=64,123456 OK 2.3.3.5. AT+BLECONFIRM 鉴权 TK 比较确认 该命令用于比较鉴权 TK 并确认主从两端设备显示的数字是否一致。在数值比较（Numeric Comparison） 配对过程中，收到回调函数上报的鉴权 VA（Verify Authentication）确认提示事件+BLETKCONFIRM 后， 需要在 30 秒内通过此命令将两端设备显示数字的比较结果返回给协议栈。如果在 30 秒内没有下发该命令 确认比较结果，协议栈将触发超时机制，终止配对流程，配对失败。参数不符合要求或者命令格式错误时， 上海移远通信技术股份有限公司 52 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLECONFIRM 鉴权 TK 比较确认 设置命令 响应 AT+BLECONFIRM=, OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。BLE 连接句柄。 整型。两端设备显示的数字是否一致。 0 不一致 1 一致 错误码。详情请参考文档 [1]。 举例 AT+BLECONFIRM=64,1 OK 2.3.3.6. AT+BLEBINDINFO 查询配对绑定设备信息 该命令用于查询与该设备绑定的设备信息，最终返回与它绑定的所有设备的地址信息。设备最多能绑 定 5 个 BLE 设备。当绑定的设备超过 5 个时，最后绑定的设备将替换最早绑定设备。参数不符合要求或者 命令格式错误时，通过 ERROR 或+CME ERROR: 上报错误通知。 AT+BLEBINDINFO 查询命令 AT+BLEBINDINFO? 查询配对绑定设备信息 响应 [+BLEBINDINFO:,] […] OK 若出现任何错误： 上海移远通信技术股份有限公司 53 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 最大响应时间 特性说明 ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。绑定的设备地址。48 位地址以十六进制数串表示，如 A662616202C3。 整型。设备地址类型。 0 未加密的设备公共地址（public address） 1 未加密的设备随机地址（random address） 错误码。详情请参考文档 [1]。 举例 AT+BLEBINDINFO? +BLEBINDINFO:F366162ADDDD,0 +BLEBINDINFO: F366162ADDDE,0 OK 上海移远通信技术股份有限公司 54 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 3 相关事件描述 3.1. GAP 事件 3.1.1. 连接结果上报事件 +BLEGATCCON: 连接结果上报事件 +BLEGATCCON:,,,, 事件。 参数 整型。BLE 连接句柄。 字符串类型。字符串类型。对端设备地址。48 位地址以十六进制数串表示，如 A662616202C4。 整型。对端设备地址类型。 0 未加密的设备公共地址（public address） 1 未加密的设备随机地址（random address） 整型。连接状态。 0 断开连接 1 连接 整型。连接成功时该值为 0，断开连接事件时，表示断开连接的原因。 0 成功 2 未知连接 ID 5 鉴权失败导致连接终止 6 码缺失导致连接终止 8 连接超时 11 ACL 连接已存在 19 远程用户终端连接 22 本地主机终止连接 31 未指明错误终止连接 34 LMP 响应超时导致连接终止 35 LMP 冲突导致连接终止 40 连接终止即时通过 42 不同的事件冲突导致连接终止 60 广播超时导致连接失败 上海移远通信技术股份有限公司 55 / 94 61 MIC 故障导致连接终止 62 建立连接失败 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 3.1.2. 命令错误通知事件 +BLEERREVT: 命令错误通知事件 +BLEERREVT:, 命令错误通知事件，广播参数错误、广播数据设置错误、使能 广播命令执行失败、创建连接命令执行失败时会上报该事件。 参数 十六进制类型。错误命令对应的操作码值。 0x0c2d 读取传输功率 0x200a 开启/关闭广播 0x2010 清空白名单 0x2011 向白名单添加蓝牙设备 0x2012 从白名单移除蓝牙设备 0x2013 更新连接白名单 0xfc32 设置蓝牙设备地址 0xfc3b 设置传输功率等级 0xfcfe 开启/关闭 BLE 协议 0xfcff 初始化 BLE 设备 整型。表示错误的原因。 0 未知 HCI 命令 1 未知连接 ID 2 硬件故障 7 超出内存容量 12 命令不允许 17 操作不支持 18 无效的 HCI 参数 25 未知的 LMP PDU 26 不支持远程功能 30 无效的 LMP 参数 34 LMP 响应超时 35 LMP 冲突 48 参数超过要求范围 58 控制器繁忙 60 广播超时 上海移远通信技术股份有限公司 56 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 3.1.3. 命令完成通知事件 +BLECMPEVT: 命令完成通知事件 +BLECMPEVT: 命令完成通知事件。 参数 十六进制类型。事件对应的命令操作码值。 0xfcfe 开启/关闭 BLE 协议 0x0c2d 读取传输功率 0x200a 开启/关闭广播 0x2010 清空白名单 0x2011 向白名单添加蓝牙设备 0x2012 从白名单移除蓝牙设备 0x2013 更新连接白名单 0xfc32 设置蓝牙设备地址 0xfc3b 设置传输功率等级 0xfcff 初始化蓝牙设备 3.1.4. 数据接收通知事件 +BLEDATARECV: 数据接收通知事件 +BLEDATARECV:, 参数 整型。BLE 连接句柄。 字符串类型。接收到的数据内容。 3.1.5. 更新连接参数通知事件 +BLEPARAMUPDATE: 更新连接参数通知事件 +BLEPARAMUPDATE:,,, 上海移远通信技术股份有限公司 57 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 参数 整型。BLE 连接句柄。 整型。连接事件间隔。单位：1.25 毫秒。 整型。从设备延时对应的的数目，即从设备最多忽略主设备数据包的个 数。范围：0~499。 整型。监控超时时间。如果在该时间段内，双方没有数据交互，就会断开连接。取 值范围：10~3200；单位：10 毫秒；对应的时间范围：100 毫秒~32 秒。 3.1.6. 数据通道建立完成通知事件 +BLEDATACONN: 数据通道建立完成通知事件 +BLEDATACONN: 数据通道建立完成通知事件。当收到该事件上报时，即 可使用命令 AT+BLEDATASEND 发送数据。 参数 整型。BLE 连接句柄。 3.1.7. BLE DFOTA 升级通知事件 +BLEFOTAEVT: BLE DFOTA 升级通知事件 +BLEFOTAEVT: BLE DFOTA 升级通知事件。 参数 整型。表示 BLE DFOTA 升级事件的类型。 0 BLE DFOTA 升级请求，使用手动确认升级模式时，会上报该事件；使用自动升级 模式时，不会上报该事件。当收到该事件后，需要在 2 分钟内下发升级响应命令 AT+BLEOTARSP 1 固件开始下载 2 固件传输中断 3 固件传输完成 4 开始固件升级 5 手动确认超时。当收到该事件+BLEFOTAEVT:0 之后，若在 2 分钟内未下发升级响 应命令，将上报该事件。 上海移远通信技术股份有限公司 58 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 备注 重启后上报如下升级结果 URC： ⚫ FIRMWARE UPDATE SUCCESS 指示升级成功或 FIRMWARE UPDATE FAILED 指示升级失败。 ⚫ FIRMWARE UPDATE OVER 指示升级结束。 3.2. GATT 事件 3.2.1. 客户端读取属性值事件 +BLEGATRREQ: 客户端读取属性值事件 +BLEGATRREQ:, 客户端读取属性值事件，服务器端收到客户端读取属性值的请 求时上报该事件。 参数 整型。读取属性值的句柄。 整型。本次读取属性值时的偏移量。 3.2.2. 客户端写入属性值事件 +BLEGATWREQ: 客户端写入属性值事件 客户端写入属性值事件，服务器端收到客户端写入属性值 +BLEGATWREQ:,, 的请求时上报该事件。 参数 整型。写入属性值的句柄。 整型。本次读取属性值时的偏移量。 字符串类型。写入属性值的内容。 上海移远通信技术股份有限公司 59 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 3.3. SMP 事件 3.3.1. 密钥丢失通知事件 主设备发起加密时，会向对端请求长期密钥（LTK），当 LTK 丢失时，会上报该事件。收到该事件后， 用户可以选择是否重新发起配对。该事件只会在主设备上报。 +BLEKEYMISS: 密钥丢失通知事件 +BLEKEYMISS: 密钥丢失通知事件。 参数 整型。BLE 连接句柄。 3.3.2. 配对完成事件 +BLEPAIRDONE: 配对完成事件 +BLEPAIRDONE:, 配对完成事件。配对流程结束时，会上报该事件。 参数 整型。BLE 连接句柄。 整型。表示配对结果。 0 配对成功 1 用户密钥不正确或取消配对 2 OOB 数据不可用 3 输入输出能力未达标 4 验证确定值失败 5 设备不支持配对 6 密钥长度不符合要求 7 不支持 SMP 指令 8 其他原因，如主设备在配对过程中取消配对 9 重连时间间隔太短 10 命令参数错误 11 验证共享密钥失败 12 数值比较失败 13 BRREDR 配对过程中的问题 14 发送或生成 BRDR 链路密钥失败 236 系统内存不足 上海移远通信技术股份有限公司 60 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 237 加密链路失败 238 主设备建立配对连接并忽略从设备发起的配对请求 240 链路断开 3.3.3. 鉴权 TK 显示事件 +BLETKSHOW: 鉴权 TK 显示事件 +BLETKSHOW:,,< 配对过程中，经过协商，两端设备确定配对方法为万能 auth_TK> 钥匙（passkey entry），此时需要一端显示 TK 值及对端 设备地址，另一端输入对应的 TK 值完成。 参数 整型。BLE 连接句柄。 字符串类型。对端蓝牙设备地址。48 位地址以十六进制数串表示，如 A662616202C3。 字符串类型。显示的 TK 值，在对端设备中输入该值。 3.3.4. 鉴权 TK 输入通知事件 +BLEPTKIN: 鉴权 TK 输入通知事件 +BLEPTKIN: 配对过程中，经过协商，两端设备确定配对方法为万能钥 匙（passkey entry），具体流程包括：对端显示 TK、本端 输入 TK 或者两端输入 TK。当设备具有输入能力并且需要 输入 TK 值时，会上报该事件通知用户，可以通过 TK 输入 命令输入 TK 值完成配对，TK 值为对端设备通过 TK 值显 示事件上报的值。 参数 整型。BLE 连接句柄。 3.3.5. 鉴权 TK 确认事件 +BLETKCONFIRM: 鉴权 TK 确认事件 +BLETKCONFIRM:,, 在配对过程中，经过双方协商配对方法为数值比较（Numeric Comparison），之后会通过该事件向用户通知 TK 值和对端设 备地址，用户确认后通过 TK 比较确认命令下发确认结果，完 成配对。 上海移远通信技术股份有限公司 61 / 94 参数 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 整型。BLE 连接句柄。 字符串类型。对端设备地址。48 位地址以十六进制数串表示，如 A662616202C4。 字符串类型。显示的 TK 值。 上海移远通信技术股份有限公司 62 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 4 BLE 与 NB-IoT 共存设计指导 由于在模块中 NB-IoT 和 BLE 共用 RF 模块，因此两者不能同时工作。本章节为 NB-IoT 和 BLE 对 RF 模块调度的使用指导。 4.1. NB-IoT 与 BLE 的优先级 在模块中，NB-IoT 业务具有高优先级。若 NB-IoT 业务触发 RF 申请，无论 BLE 是否已持有 RF 权限， 优先满足 NB-IoT 业务。不同状态介绍如下： 1. 若 BLE 发起 RF 申请，RF 未被 NB-IoT 占用，申请成功。 2. 若 BLE 发起 RF 申请，RF 被 NB-IoT 占用，申请失败。 3. 若 NB-IoT 发起 RF 申请，RF 未被 BLE 占用，申请成功。 4. 若 NB-IoT 发起 RF 申请，RF 已被 BLE 占用，申请成功，BLE RF 权限被剥夺抢占。 综上，BLE 在 AT+CFUN=0（详情请参考文档 [1]）或者 PSM 状态下可以工作，当模块处于连接态或 者空闲态时，RF 被 NB-IoT 占用，BLE 没有权限，优先级低。 由于 NB-IoT 的高优先级，NB-IoT 业务的 RF 申请会优先被满足，因此共存功能对 NB-IoT 业务没有限 制。后续章节着重介绍共存功能对 BLE 业务的使用限制。 4.2. 共存功能状态 当 BLE 业务申请 RF 权限失败或者 NB-IoT 抢占 RF 授权时，BLE 协议栈不销毁，BLE 会自动恢复至 抢占前的状态。 4.2.1. BLE 协议栈启动 执行 AT+BLEPWR=1 启动 BLE 协议栈时，协议栈正常启动（只要参数合法，必定成功不会失败）。 4.2.2. BLE 相关 AT 命令分类 AT 命令可以分为需要 RF 权限才能支持的命令和不需要 RF 权限支持的命令。 上海移远通信技术股份有限公司 63 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 ⚫ 对于不需要 RF 权限支持的命令：命令正常执行，NB-IoT 是否占用 RF 对其无影响。 ⚫ 对于需要 RF 权限才能支持的命令：如 AT+BLEADV、AT+BLEDISC、AT+BLETXPWR、 AT+BLEADVPWR、AT+BLEPARAMUPDATE 等 BLE 交互命令，当命令执行时可能会因为 RF 申请失败，导致命令执行失败。用户可以根据应用场景，当 Modem 进入 PSM 状态后，进行命令 重试操作，直至命令执行成功。 4.2.3. BLE 协议栈运行中 NB-IoT 与 BLE 对 RF 的抢占 1. BLE 空闲状态 功能共存对其无影响。 2. 广播状态 RF 被 NB-IoT 抢占后，BLE 维持广播状态不变，只将 RF 通路让给 NB-IoT，空口不再发送广播报 文，待 NB-IoT 释放 RF、BLE 重新获取 RF 授权后，BLE 继续通过空口发送广播报文。如下图所 示。 Adv intv Adv intv Adv intv NB-IoT占用RF授权 当NB-IoT抢占RF授权，RF被NB-IoT占 用，BLE空口广播停止，当NB-IoT释放RF 授权，BLE可以再次使用RF，广播恢复 图 2：BLE 广播状态时 RF 被 NB-IoT 抢占 3. 连接状态 由于 BLE 在拥有 RF 权限和没有 RF 权限时所使用的时钟精度存在较大差异，因此在 BLE 连接态 下，RF 被 NB-IoT 抢占后存在 BLE 连接断开的情况。 当连接断开后，BLE 协议栈所处状态有以下两种情况： ⚫ NB-IoT 未释放 RF 权限时，BLE 处于空闲态，此时无法下发关闭广播的 AT 命令。如需关闭 BLE 广播功能，必须待 NB-IoT 释放权限后才能关闭。 ⚫ NB-IoT 已释放 RF 权限时，此时 BLE 恢复至广播态，BLE 广播所使用的广播参数为上次广播 时的参数。此时可在主设备端实现自动重连的方案（目前提供的手机 App 工具已有自动重连 功能）。 上海移远通信技术股份有限公司 64 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 4.3. 用户设计指导 4.3.1. BLE 启动流程 首先执行 AT+BLEPWR=1 命令启动 BLE 协议栈，其次调用必要的 BLE AT 配置命令（不需要 RF 权限 支持），最后执行 AT+BLEADV 开启广播。 前两者只要参数合法，命令必定执行成功，只有 AT+BLEADV 可能由于不可获得 RF 授权而执行失败， 需要设计重试机制，重新下发 AT+BLEADV，确保广播启动成功。 4.3.2. NB-IoT 抢占 RF 导致 BLE 连接断开 BLE 在连接状态下，因 NB-IoT 抢占 RF 导致 BLE 连接断开。可以在 BLE 主设备侧增加自动重连功能， 当主设备收到 BLE 连接断开/连接建立失败的上报事件，启动一个重连定时器，定时器到期后触发连接建立 过程。 用户可以根据业务场景需要，调整定时器超时时间。 4.4. 启动方式设计 4.4.1. 自动启动 对于需要协议栈自动启动的场景，比如烟雾报警器或者不方便人为操作的场景等，需要用户在系统初 始化时，在适当的时机启动 BLE 协议栈，然后调用相关的 AT 命令集，启动广播业务。 4.4.2. 人工控制启动 对于需要人为控制的应用场景，用户可以根据外部触发信号，如按键或者拨码开关的动作，启动 BLE 协议栈，然后调用相关的 AT 命令集，启动广播业务。 上海移远通信技术股份有限公司 65 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5 BLEAssistant 使用指南 本章节主要描述 BLEAssistant App 的使用方法，帮助客户快速熟悉该工具，明确具体特征的使用方法。 5.1. 主要功能 ⚫ 发现设备： 扫描发现周边可用的 BLE 设备，同时支持白名单扫描。 ⚫ 管理连接： 连接 BLE 设备、自动重连方式连接 BLE 设备。支持同时管理多个连接。 ⚫ GATT（Generic Attribute Profile）管理： 服务列表显示、特征值读写、通知/指示使能、去使能等。 ⚫ L2CAP 数据传输： 数据发送、数据接收显示等。 ⚫ AT 命令： 命令发送、命令回复显示等。 ⚫ DFOTA 升级： 使用 BLE DFOTA 功能升级模块。 ⚫ 其他： 为支持主要功能的辅助功能。包括版本显示、白名单管理、绑定管理等。 上海移远通信技术股份有限公司 66 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.2. 界面介绍 手机安装 BLEAssistant App（如需工具安装包资源，请联系移远通信技术支持 support@quectel.com）。 安装完成后第一次打开应用会弹出界面提示，需要申请位置权限。如下图所示。 图 3：BLEAssistant 位置权限设置 如果点击'拒绝'或者'禁止后不再提示'（不同手机提示可能略有差异），App 将直接退出；也可以 在手机系统设置中的权限管理中允许或者拒绝位置服务权限。 上海移远通信技术股份有限公司 67 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 App 主界面主要由三个部分组成，如下图框线区域所示。 图 4：BLEAssistant 主界面 ⚫ 红色框线区域： 点击右侧按钮，显示应用名称、退出应用、版本信息、白名单管理等辅助功能。 ⚫ 黄色框线区域： 设备主要信息显示、多连接场景下设备管理界面之间切换以及设备管理界面与扫描界面切换。 ⚫ 蓝色框线区域： App 主要功能区域。包括扫描界面、设备管理界面。可同时打开一个或者多个设备管理界面，当 前 App 最大支持同时打卡 5 个设备管理界面。 5.3. 操作指导 该章节主要描述设备扫描、设备管理、GATT 管理、L2CAP 数据传输、AT 命令等功能的操作步骤。 上海移远通信技术股份有限公司 68 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.1. 扫描 如下图所示，打开 App 后显示扫描界面，默认处于空闲状态。 图 5：空闲状态扫描界面 扫描界面提供以下功能： ⚫ 开启/停止扫描 ⚫ 白名单扫描 ⚫ BLE 设备基本信息 ⚫ 连接（自动重连）BLE 设备 5.3.1.1. 开启/停止扫描 如下图所示，开启扫描提供两种操作方式：点击按钮'SCAN'和下拉手势。扫描开启后按钮状态将从 'SCAN'变化为'STOPSCAN'，周围正在发送扫描广播的 BLE 设备的基本信息将更新到扫描界面。 上海移远通信技术股份有限公司 图 6：开启扫描界面 69 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 当扫描界面处于空闲状态时，按照上述两种方式开启扫描后，界面处于扫描中状态。处于扫描中状态 时，可以通过以下两种方式停止扫描： ⚫ 通过下拉手势停止当前扫描，扫描结果将被清空，然后开启一次新的扫描； ⚫ 通过点击扫描界面的停止按钮'STOPSCAN'。扫描结果将被保留，扫描界面进入空闲状态。停 止扫描后的界面如下图所示。 图 7：停止扫描界面 备注 1. 当扫描间隔设置很小时，上次扫描结果被清空的现象不明显。 2. 当在扫描界面发起设备连接，即点击'CONNECT'按钮时，也会终止扫描流程。 3. 短时间内频繁开启停止扫描会出现扫描不到设备的情况。如果由于该原因导致扫描不到设备，可尝试 重启应用或者等待一段时间再重新扫描。 5.3.1.2. 白名单扫描 白名单管理在菜单栏中，如下图所示。 图 8：白名单菜单栏 上海移远通信技术股份有限公司 70 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 点击菜单栏下的'White List'进入白名单管理界面，如下图所示。 图 9：白名单管理界面 白名单功能： ⚫ 是否使能白名单： 默认不使能；勾选'Enable White List'使能白名单。 ⚫ 增加白名单： 目前最多支持添加 12 个地址到白名单。 ⚫ 保存白名单： 保存到手机本地。 ⚫ 删除白名单： 长按白名单地址即可删除。 备注 MAC 地址的合法性：'XX:XX:XX:XX:XX:XX'，其中'X'取值包括 0-9、A-F。 上海移远通信技术股份有限公司 71 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.1.3. BLE 设备基本信息 BLE 设备的基本信息包括下面几个部分，如下图所示。 图 10：设备信息显示 内容： ⚫ 设备名称 ⚫ MAC 地址 ⚫ 手机端与 BLE 设备的绑定状态 ⚫ RSSI 设备名称： 显示的设备名称是从广播数据包中解析所得。若数据中不包含设备名称，则会显示为'N/A'字样。 绑定状态说明： ⚫ 手机端蓝牙协议栈将配对及绑定作为一个状态进行处理。只要跟目标设备配对成功，手机端即会保 存目标设备的绑定信息，即只要配对成功就会绑定。 ⚫ BLE 设备端和手机端按照标准协议实现配对，是否绑定为一个可选参数。若 BLE 设备端设置为配 对但不绑定，则会出现手机端保存有 BLE 设备的配对信息，而 BLE 设备端不保存手机端的配对信 息的现象。 5.3.1.4. 连接/自动重连指定的 BLE 设备 可以采取连接、自动重连两种方式连接到指定的 BLE 设备。如下图所示。 图 11：连接显示界面 点击'CONNECT'后，将打开新的 Tab 页面（BLE 设备管理界面），若已经打开则直接导航至对应的 设备管理页面。 上海移远通信技术股份有限公司 72 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 若采用自动重连的方式连接 BLE 设备，由于信号变弱断开或者其他位置因素导致的被动断开，手机端 会在重新扫描到 BLE 设备广播时尝试重新连接。如人为主动断开，则不再重新连接。 人为断开包括：退出应用、点击设备管理页面的'X'、点击设备管理页面的'Disconnect'或点击设 备管理页面的'Unbond'引起的断开。 5.3.2. 设备管理 扫描界面点击指定设备的'CONNECT'按钮，即可创建对应设备的管理界面（如果该设备的管理界 面已经打开，则会导航至对应的管理界面）。BLE 设备管理界面承载着 App 的大部分功能，包括 GATT 相 关功能、L2CAP 通道透传数据、AT 通道发送命令以及其他部分其他辅助功能。界面显示如下图所示。 图 12：设备管理显示界面 ⚫ 红色框线区域： 该部分与 GATT 连接相关。 ⚫ 黄色框线区域： 该部分指示当前管理界面处于什么子界面。默认处于 GATT 子界面。 ⚫ 蓝色框线区域： 点击'…'部分，可以显示或者隐藏额外的功能列表，包括 GATT 重连/断开连接、刷新服务列表、 使能 AT、使能 DFOTA、使能 L2CAP、绑定管理。 上海移远通信技术股份有限公司 73 / 94 5.3.3. GATT 管理 GATT 界面提供的功能主要包括： ⚫ 显示服务列表 ⚫ 读写特征值 ⚫ 刷新服务列表 ⚫ 管理绑定 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.3.1. 显示服务列表 显示 BLE 设备支持的文件服务列表，BLE 设备默认内置两个标准的文件（Profile），如下图所示，还 可通过 AT 命令添加或者删除服务。 图 13：服务列表显示界面 上图中： ⚫ Generic Attribute Profile − 服务名称：根据 UUID 解析得到。如果使用标准的 UUID，可以解析为有实际含义的名称；如 果使用私有的 UUID，服务名称使用'UN_KNOWN_NAME'。 − 服务种类：有 Primary Service 和 Secondary Service 两个种类。 上海移远通信技术股份有限公司 74 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 ⚫ Generic Access Profile − 服务名称：根据 UUID 解析得到。如果使用标准 UUID，可以解析为有实际含义的名称；如果 使用私有的 UUID，服务名称使用'UN_KNOWN_NAME'。 − Properites ： 当 前 特 征 的 权 限 列 表 。 权 限 包 括 ： BROADCAST 、 READ 、 WRITE 、 WRITE_NO_RESPONSE、NOTIFY、INDICATE、SIGNED_WRITE、EXTENDED_PEOPS。 − Value：当前特征值。 GATT 协议规定了特征值的多种访问权限，各种权限与界面上的图标对应关系如下： READ WRITE，WRITE_NO_RESPONSE INDICATE 使能状态 INDICATE 去使能状态 NOTIFY 去使能状态 NOTIFY 使能状态 5.3.3.2. 读写特征值 点击' '即可从 BLE 设备读取特征值或者描述符的值。App 当前仅对从 BLE 内置的 Generic Attribute Profile 和 Generic Access Profile 两个文件中读取的值进行解析。其他文件中读取的值显示为一个 十六进制的字节数组，如下图所示。 图 14：特征值读取显示界面 上海移远通信技术股份有限公司 75 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 红色框线表示对读取的特征值进行解析，使显示的值有特定的含义；蓝色框线表示特征值未做解析， 仅显示读取到的字节数组。 点击' '即可给 BLE 设备写入特征值，点击后弹出输入对话框，如下图所示： 编辑完成后即可发送。 图 15：特征值写入显示界面 5.3.3.3. 刷新服务列表 通过下拉列表提供的'REFRESH'功能，可以刷新服务列表，以获取 BLE 端最新的服务列表。如下 图所示。 图 16：服务列表刷新 上海移远通信技术股份有限公司 76 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.3.4. 管理绑定 通过下拉列表查看手机端与 BLE 设备的绑定关系。手机端与蓝牙设备的绑定状态有三种：'已绑定'、 '绑定中'、'未绑定'，分别如下所示： ⚫ 未绑定：此状态下可点击'BOND'按钮发起配对流程，如下图。配对流程会根据 BLE 设备设置 的输入输出能力发起不同类型的流程。 图 17：'未绑定'状态 ⚫ 绑定中：按钮不可点击，显示'BONDING'，如下图 图 18：'绑定中'状态 上海移远通信技术股份有限公司 77 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 ⚫ 已绑定：此状态下可点击'UNBOND'按钮解除绑定，如下图。绑定解除后，当前的 GATT、L2CAP （如果存在）、AT（如果存在）连接会断开。 图 19：'已绑定'状态 根据 BLE 设备发送 AT+BLEPAIRCFG 命令配置的输入输出能力不同，配对的过程有以下几个场景： 场景 1： 设备没有设置输入输出能力或者 AT+BLEPAIRCFG 中设置为 3。BLE 设备端输入 输出能力不足，配对失败。 场景 2： AT+BLEPAIRCFG 中设置为 0。输入 BLE 设备上显示的配对码即可完成配对。手 机端弹出配对信息如下图所示。 图 20：设备匹配场景 2 上海移远通信技术股份有限公司 78 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 场景 3： AT+BLEPAIRCFG 中设置为 1 或 4。通过 AT 命令 AT+BLECONFIRM 模拟配对确 认即可完成配对。手机端弹出配对信息如下图所示。 图 21：设备匹配场景 3 场景 4： AT+BLEPAIRCFG 中设置为 2。AT 命令 AT+BLESETAUTHTK 模拟输入手机端显 示的配对码即可完成配对。手机端弹出配对信息如下图所示。 图 22：设备匹配场景 4 5.3.4. L2CAP 数据传输 L2CAP 子界面包括以下几个功能： ⚫ 发送数据 ⚫ 接收数据 ⚫ 显示历史发送及接收数据列表 本章节主要介绍使能 L2CAP、发送数据及其他注意事项等内容。 上海移远通信技术股份有限公司 79 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.4.1. 使能 L2CAP L2CAP 传输功能默认不可用，需点击下拉列表的'CREATE L2CAP'按钮进行激活。激活过程中， 会在手机端与 BLE 设备端之间建立一条 L2CAP 通道。激活成功后，设备管理界面由其他子界面切换到 L2CAP 子界面。如下图所示： 图 23：L2CAP 界面 创建 L2CAP 通道需要如下前置条件： ⚫ GATT 连接存在，未满足时异常提示'Connection Does not Exist'； ⚫ 手机端与 BLE 设备端处于配对状态，未满足时异常提示'The Device Is Not Paired'。 若手机端保存 BLE 设备的配对信息，而 BLE 设备端未保存手机的配对信息，则在激活过程中不会 出现'The Device Is Not Paired'，而是会发起一个配对流程。如果配对顺利完成，也可以激活 L2CAP 传输功能。 5.3.4.2. 发送数据 L2CAP 提供了手机端与 BLE 端数据透传（不含传输层协议）的通道。发送数据前会进行输入数据的格 式校验，不符合格式的数据不会被发送并且给出异常提示。当前支持单次发送的最大字节数为 2 千字节。 BLE 设备端可以使用命令 AT+BLEDATASEND 发送数据到手机端。 备注 数据的合法性：'XX-XX-XX-……XX-XX'表达式中的'X'可用的字符包括 0-9，A-F，a-f。输入数据的最大 长度不超过 2000 字节。 上海移远通信技术股份有限公司 80 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.4.3. 其他 由于信号不稳定等其他因素导致 L2CAP 通道断开，点击'SENDDATA'按钮会出现异常提示'L2CAP Channel Not Found'，重新点击下拉列表提供的'CREATE L2CAP'功能会重新创建 L2CAP 通道。 5.3.5. AT 通道 AT 通道的前置条件与 L2CAP 通道是一致的。AT 子界面包括以下几个功能： ⚫ 发送数据 ⚫ 接收数据 ⚫ 显示历史发送及接收数据列表 本章节主要介绍使能 AT 通道、发送 AT、显示历史发送数据列表及其他注意事项等内容。 5.3.5.1. 使能 AT 通道 AT 通道默认不可用，需点击下拉列表的'AT'按钮进行激活。点击'AT'后，进入 AT 命令输入框。 如下图所示。 图 24：AT 对话框界面 上海移远通信技术股份有限公司 81 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.5.2. 发送 AT 命令和显示历史发送数据列表 在 AT 子界面输入框内输入需要发送的 AT 命令，点击'SENDAT'即可发送 AT 命令。比如需要发送 AT+NCONFIG?，在输入框内输入 AT+NCONFIG? 即可。 AT 子界面还承载着显示历史发送和接收记录的功能。为了保证界面显示的发送和接收的一一对应关系， 命令发送后'SENDAT'按钮变为不可用状态，一直持续到收到命令响应或者响应超时。 由于不可知因素的影响（例如信号不好、响应中连接断开等），会出现 AT 命令不响应现象。如果 AT 命令发送后超过 30 秒未回复，即认为命令响应超时，'SENDAT'按钮重置为可用状态。 图 25：AT 输入界面 备注 1. 将对输入的内容进行合法性校验。校验合法的规则为以'AT+'或者'at+'开头的字符串； 2. 根据用户的实际需求及当前的 AT 实现情况，仅保证 AT+CGMR、AT+NCONFIG 及 AT+NUESTAT 可 用。理论上，AT 通道仅作为数据的通道，不关注传输内容，其他 AT 命令也可用，但手机端 AT 不能保 证完全可用。另外，类似于关闭协议栈、断开连接等会影响 AT 通道的命令需慎用。 上海移远通信技术股份有限公司 82 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.5.3. 其他 由于其他因素导致 AT 通道断开，点击'SENDAT'按钮会出现异常提示'AT Channel Unavailable'， 需重新点击下拉列表'AT'按钮重新创建 AT 通道。 5.3.6. DFOTA 升级 DFOTA 传输文件与 AT 发送使用同一通道。在使用 DFOTA 向 BLE 设备传输文件流时，不会影响 AT 命令的正常收发。 DFOTA 子界面包括以下几个功能： ⚫ 发送数据 ⚫ 接收数据 ⚫ 显示历史发送及接收数据列表 本章节主要介绍使能 DFOTA、导入差分文件、传输文件及断点升级相关内容。 5.3.6.1. 使能 DFOTA DFOTA 功能默认不可用，需点击下拉列表的'FOTA'按钮进行激活。点击'FOTA'后，即可继续 通道建立流程。 图 26：DFOTA 界面 上海移远通信技术股份有限公司 83 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 5.3.6.2. 差分文件 将制作好的差分文件导入手机中，差分文件的合法性由模块端确认，手机 App 不对文件合法性进行判 断。 5.3.6.3. 传输文件 DFOTA 传输文件的界面如下图所示，点击'BROWSER'按钮和'START'按钮分别进行文件选择 和开始升级，此时模块端上报事件+BLEFOTAEVT:0，若为手动确认模式（AT+BLEOTAMODE=0），则 需等待模块执行 AT+BLEOTARSP=1 同意升级，之后进入'Sending'状态（按钮为灰色的时候表示处于 不可用状态）。 当差分文件传输到'100.0%'后，界面显示'Verifying'验证状态；当验证结束后，模块进入重启升 级状态，此时 BLE 连接断开。DFOTA 文件传输结束界面如下图所示： 图 27：DFOTA 文件传输结束 上海移远通信技术股份有限公司 84 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 当模块升级成功后，重新配置 BLE 相关参数，此时 App 重新连接 BLE 设备，按照前述步骤进入 BLE 的 DFOTA 界面，显示'Upgrade succeeded'，此时'Version'显示更新后的固件版本，如下图所示。 图 28：DFOTA 升级状态 5.3.6.4. 断点升级 DFOTA 升级'Sending'状态下，如果由于通信原因或手动点击'STOP'按钮，DFOTA 升级变为失 败或者'IDLE'状态，模块端会记录上次传输文件的 CRC 以及传输进度，如果下一次升级使用的还是上一 次的差分文件，则会继续上次的传输进度，直到进入验证状态。 上海移远通信技术股份有限公司 图 29：断点升级 85 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 6 举例 6.1. BLE L2CAP 数据传输与 NB-IoT 共存使用流程 BLE 与 NB-IoT 共存，NB-IoT 对 RF 使用具有更高优先级。使用 BLE 的前提：AT+CFUN=0 状态；模 块 Modem 进入 PSM。BLE 的 L2CAP 数据传输与 NB-IoT 共存使用的流程如下图所示： 上海移远通信技术股份有限公司 86 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 开机 /重启 Neul OK 设置 AT +C F U N= 0 AT+NPS MR=1 NB-IoT业务 运行 否 是 C FU N 为0或在 PSM 态 进入 PSM 态 +NPS MR:1 AT+B LEPWR= 1 退出 PSM 态 +NPS MR:0 BLE按照 共存状 态运行 BLE开启 失败 BLE开启 成功事 件 +B LECMPEVT:0xfcfe BLE开启 成功 AT+B LEADDR? MAC：112 23344 5566 AT+B LEPAIRCFG AT+B LEADVDATA 进入 PSM 态 +NPS MR:1 1. 退出PSM前BLE处于 广播态：恢复 到广播 态 2. 由于BLE在拥 有RF权限 和没有RF权限 时所使 用的时 钟精 度存 在较大 差异，因此 在BLE连接 态下，RF被NB-IoT抢占 后存 在BLE连接 断开的 情况。 AT+B LEADV=1,... 关闭 广播： +B LECMPEVT:0x2 00a 打开 广播： +B LECMPEVT:0x2 00a 广播 态 AT+B LEADV=0 BLE Maste r 扫描 BLE 设备 是 是否 重新设 置广播 参数 否 BLE Conn ecting 扫描 到 MAC:1 122334 45566 正在 连接 Conne cting 上报 消息 +B LEGA TCCON:... 已连 接 Conne cted 完成 配对 配对 L2CAP通道 创建完 成， +B LEDATACONN: 数据 发：AT+B LEDATASEND 数据 收：+B LEDATARECV:... 主动 断开：AT+B LEDIS C 被动 断开：+B LEGA TCCON:... 创建 L2C AP 通道 数据 收发 BLE断开 连接 主、被动 断开 图 30：BLE L2CAP 数据传输与 NB-IoT 共存使用流程 上海移远通信技术股份有限公司 87 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 6.2. BLE 配对流程 在使用 BLE 的 L2CAP 数据通道、AT 通道和 DFOTA 通道时，需要先进行配对设置。如下是推荐常用 的配对流程示例。更多配对方式，请参考第 2.3.3.1 章和第 5.3.3.4 章。 AT+BLEPWR=1 OK //开启 BLE 协议栈 +BLECMPEVT:0xfcfe AT+BLEADDR? +BLEADDR:C441375CC78B //查询 BLE 地址 OK AT+BLEPAIRCFG=0,0,0 OK //设置输入输出能力，BLE 客户端端输入模块显 示的配对临时密钥完成配对 //以下，区分使用随机 PIN 码值配对和使用固定 PIN 码值配对 //方式一：使用随机 PIN 码方式进行配对 AT+BLEPINSET? //默认是随机 PIN 码配对 +BLEPINSET:0 OK AT+BLESETADVDATA='06094E42494F54','' OK //设置广播数据 AT+BLEADV=1,32,32,0xffffffff,0,0,0,'',7,0 OK //开启广播并配置广播参数 +BLECMPEVT:0x200a +BLEGATCCON:64,5F497609FCF8,1,1,0 //BLE 客户端连接接入 +BLEPARAMUPDATE:64,6,0,500 +BLEPARAMUPDATE:64,36,0,500 +BLETKSHOW:64,5F497609FCF8,646484 //BLE 客户端输入模块端显示的临时密钥 646484 +BLEPAIRDONE:64,0 //BLE 客户端发起配对，模块端上报临时密钥： 646484 //完成配对 //方式二：使用固定 PIN 码方式进行配对 AT+BLEPINSET=1,123456 //使用固定 PIN 码 123456 进行配对 上海移远通信技术股份有限公司 88 / 94 OK +BLEGATCCON:64,5F497609FCF8,1,1,0 +BLEPARAMUPDATE:64,6,0,500 +BLEPARAMUPDATE:64,36,0,500 +BLETKSHOW:64,5F497609FCF8,123456 //BLE 客户端输入模块端显示的固定密钥 123456 +BLEPAIRDONE:64,0 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 //BLE 客户端连接接入 //BLE 客户端发起配对，模块端上报固定密钥： 123456 //完成配对 6.3. BLE L2CAP 数据通道传输流程 使用 BLE L2CAP 数据通道之前，需要与模块端完成配对。L2CAP 数据通道创建，详情请参考第 5.3.4 章。 备注 若使用安卓 App 连接模块，需使用安卓 10.0 及以上版本才支持 L2CAP 数据通道创建功能。 AT+BLEPWR=1 OK +BLECMPEVT:0xfcfe AT+BLEADDR? +BLEADDR:C441375CC78B OK AT+BLEPAIRCFG=0,0,0 OK +BLEGATCCON:64,661822DECF30,1,1,0 AT+BLEPAIRCFG=0,0,0 OK AT+BLEPINSET=1,123456 OK AT+BLESETADVDATA='06094E42494F54','' //开启 BLE 协议栈 //查询 BLE 地址 //设置输入输出能力，BLE 客户端输入服务端 （模块）显示的配对临时密钥完成配对 //BLE 客户端连接接入 //设备 BLE 配对能力 //使用固定 PIN 码值 123456 进行配对 //设置广播 上海移远通信技术股份有限公司 89 / 94 OK AT+BLEADV=1,32,32,0xffffffff,0,0,0,'',7,0 OK +BLECMPEVT:0x200a +BLEGATCCON:64,5F497609FCF8,1,1,0 +BLEPARAMUPDATE:64,6,0,500 +BLEPARAMUPDATE:64,36,0,500 +BLETKSHOW:64,5F497609FCF8,123456 //BLE 客户端输入模块端显示的固定密钥 123456 +BLEPAIRDONE:64,0 +BLEDATACONN:64 AT+BLEDATASEND=64,1234 OK +BLEDATARECV:64,1234567890 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 //开启广播并配置广播参数 //BLE 客户端连接接入 //BLE 客户端发起配对，模块端上报固定密钥： 123456 //完成配对 //BLE 客户端创建 L2CAP 通道成功 //发送数据，对端 BLE 的 L2CAP 通道可以收到 该数据 1234 //BLE 客户端发送数据，模块端收到后上报 URC 数据 1234567890 6.4. BLE GATT Server 使用流程 使用 BLE GATT 服务，不需要进行配对。完成 BLE 连接后，BLE 客户端即可获取模块端配置添加的 GATT 服务内容。详情请参考第 5.3.3 章。 AT+BLEPWR=1 OK //开启 BLE 协议栈 +BLECMPEVT:0xfcfe AT+BLEADDR? +BLEADDR:C441375CC78B //查询 BLE 地址 OK AT+BLEGATADDS=0,181C,1 OK AT+BLEGATADDC=0,0,2AC3,0x0A //添加服务 UUID: 181C //添加特征 UUID: 2AC3，属性 0x0A 表示可读 可写 上海移远通信技术股份有限公司 90 / 94 OK AT+BLEGATSST +BLEGATSST:{0:14,{0:16}} OK AT+BLESETADVDATA='06094E42494F54','' OK AT+BLEADV=1,32,32,0xffffffff,0,0,0,'',7,0 OK +BLECMPEVT:0x200a +BLEGATCCON:64,661822DECF30,1,1,0 +BLEGATWREQ:16,0,313233343536 AT+BLEGATWRATT=16,3132333435 OK +BLEGATRREQ:16,0 AT+BLEPWR=0 OK +BLECMPEVT:0xfcfe BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 //启动服务 //设置广播数据 //开启广播并配置广播参数 //BLE 客户端连接接入 //BLE 客户端向 UUID:2AC3 写数据，HEX String 显示 313233343536 //向句柄 16 对应的 UUID:2AC3 写入数据 //BLE 客户端读取 UUID:2AC3 数据 //关闭 BLE 协议栈 上海移远通信技术股份有限公司 91 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 7 附录 A 参考文档及术语缩写 表 2：参考文档 文档名称 [1] Quectel_BC28-CNV&BC95-CNV_AT 命令手册 表 3：术语缩写 术语 ACL AD AES App BLE CCCD DFOTA ECDH FOTA GAP GATT ID HCI IO L2CAP 英文全称 中文全称 Asynchronous Connectionless Link 异步无连接链路 Advertising Data 广播数据 Advanced Encryption Standard 高级加密标准 Application 应用 Bluetooth Low Energy 蓝牙低能耗 Client Characteristic Configuration Descriptor 客户端特性配置描述 Delta Firmware Upgrade Over-The-Air 差分固件空中升级 Elliptic Curve Diffie–Hellman key Exchange 椭圆曲线迪菲-赫尔曼秘钥交换 Firmware Over-The-Air 固件空中升级 Generic Access Profile 通用访问配置文件 Generic Attribute Profile 通用属性协议 Identifier 标识符 Host Controller Interface 主机控制接口 Input Output 输入输出 Logical Link Control and Adaptation Protocol 逻辑链路控制和适配协议 上海移远通信技术股份有限公司 92 / 94 LMP LTK MAC MIC MTU NB NB-IoT OOB OTA PDU PIN PSM RF RPA RSSI SMP TA TK (U)SIM UUID BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 Link Manager Protocol Long-Term Key Medium Access Control Microphone Maximum Transmission Unit Narrowband Narrow Band Internet of Things Out of Band Over-the-Air Technology Protocol Data Unit Personal Identification Number Power Saving Mode Radio Frequency Resolvable Private Address Received Signal Strength Indicator Security Manage Protocol Terminal Adapter Temporary Key (Universal) Subscriber Identity Module Universally Unique Identifier 链路管理协议 长期密钥 媒体访问控制 麦克风 最大传输单元 窄频带 窄带物联网 带外数据 空中下载技术 协议数据单元 个人识别号 省电模式 射频 可解析私有地址 接收信号强度指示 安全管理协议 终端适配器 临时密钥 （通用）用户身份识别模块 通用唯一识别码 上海移远通信技术股份有限公司 93 / 94 BC28-CNV&BC95-CNV 低功耗蓝牙应用指导 8 附录 B BLE 特征权限位域 表 4：BLE 特征权限位域 属性 Broadcast Read 值 0x01 0x02 Write Without Response 0x04 Write 0x08 Notify 0x10 Indicate 0x20 Authenticated Signed Writes 0x40 Extened Properites 0x80 BLE_ENCRYPTION_NEED 0x0100 BLE_MITM_NEED 0x0300 BLE_ECDH_NEED 0x0500 描述 若设置，则允许使用服务器特征描述符广播特征值。 若设置，则服务器特征配置描述符应存在。 若设置，则允许使用 Bluetooth Core Specification Version 5.0 / Vol 3, Part G, Section 4.8 中定义的过程读取特征值。 若设置，则允许使用 Bluetooth Core Specification Version 5.0 / Vol 3, Part G, Section 4.9.1 中定义的过程写入特征值 而不响应。 若设置，则允许使用 Bluetooth Core Specification Version 5.0 / Vol 3, Part G, Section 4.9.3 或 Section 4.9.4 中定义的 过程写入特征值并响应。 若设置，则允许使用 Bluetooth Core Specification Version 5.0 / Vol 3, Part G, Section 4.10 中定义的过程通知特征值 而不确认。如果设置，则客户端特征配置描述符应存在。 若设置，则允许使用 Bluetooth Core Specification Version 5.0 / Vol 3, Part G, Section 4.11 中定义的过程指示特征值 并进行确认。如果设置，则客户端特征配置描述符应存在。 若设置，则允许使用 Bluetooth Core Specification Version 5.0 / Vol 3, Part G, Section 4.9.2 中定义的过程对特征值进 行签名写入。 若设置，则在 Bluetooth Core Specification Version 5.0 / Vol 3, Part G, Section 3.3.3.1 中定义的特征扩展属性描述 符中，定义附加特征属性。如果设置，则特征扩展属性描述 符应存在。 数据访问需要链接加密且无需身份验证。 数据访问需要链接加密和身份验证。 数据访问需要链接加密和身份验证，需要安全连接。 上海移远通信技术股份有限公司 94 / 94

BC2x&BC9x 系列 中国联通雁飞•格物 DMP 平台 接入指导 NB-IoT 模块系列 版本：1.0 日期：2022-03-25 状态：受控文件 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 文档历史 修订记录 版本 1.0 日期 2022-01-19 2022-03-25 作者 Koala LI Koala LI 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 2 平台配置 ................................................................................................................................................. 8 2.1. 登录平台 ...................................................................................................................................... 8 2.2. 创建产品 ...................................................................................................................................... 9 2.2.1. 新增产品 ........................................................................................................................... 9 2.2.2. 配置产品信息.................................................................................................................... 9 2.2.3. 编辑物模型 ..................................................................................................................... 10 2.2.4. 添加自定义功能 .............................................................................................................. 10 2.3. 创建设备 .................................................................................................................................... 12 2.4. 解析数据 .................................................................................................................................... 13 2.4.1. 设备上报数据调试 .......................................................................................................... 13 2.4.2. 设备接收数据调试 .......................................................................................................... 14 3 平台与模块通信 .................................................................................................................................... 15 3.1. AT 命令接入............................................................................................................................... 15 3.1.1. BC25 系列模块接入平台 AT 命令示例............................................................................ 15 3.1.2. BC260Y-CN 模块接入平台 AT 命令示例 ........................................................................ 16 3.1.3. BC28-CNV&BC95-CNV 模块接入平台 AT 命令示例 ..................................................... 17 3.1.4. BC28-F&BC95-GF 模块接入平台 AT 命令示例.............................................................. 18 3.2. 平台查看模块上报数据 .............................................................................................................. 19 3.3. 平台下发数据至模块.................................................................................................................. 20 4 附录 参考文档与术语缩写 ................................................................................................................... 22 上海移远通信技术股份有限公司 4 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：参考文档 ........................................................................................................................................... 22 表 3：术语缩写 ........................................................................................................................................... 22 上海移远通信技术股份有限公司 5 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 图片索引 图 1：进入雁飞•格物 DMP 平台控制台 ........................................................................................................ 8 图 2：新增产品 ............................................................................................................................................. 9 图 3：配置产品信息...................................................................................................................................... 9 图 4：编辑物模型 ....................................................................................................................................... 10 图 5：添加自定义功能 ................................................................................................................................ 10 图 6：添加产品相关参数 .............................................................................................................................11 图 7：发布物模型 ....................................................................................................................................... 12 图 8：管理设备 ........................................................................................................................................... 12 图 9：创建设备 ........................................................................................................................................... 13 图 10：设备上报数据调试 .......................................................................................................................... 13 图 11：设备接收数据调试........................................................................................................................... 14 图 12：平台查看设备上报的数据 ............................................................................................................... 19 图 13：API 在线调试 .................................................................................................................................. 20 图 14：API 在线调用 .................................................................................................................................. 21 上海移远通信技术股份有限公司 6 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 1 引言 中国联通雁飞•格物 DMP 平台为设备提供安全可靠管理能力，是一个可以快速连接设备和企业系统的 物联网平台。该平台向下接入分散的物联网传感器，汇集传感数据；向上面向应用层服务提供应用开发的 基础性平台和面向底层网络的统一数据接口。 LwM2M 是一种安全、高效且可扩展的客户端-服务器协议，适用于多种网络环境下资源受限的设备管 理。LwM2M 采用基于 REST 的现代化架构设计，定义了一种可扩展的资源和数据模型，重用并基于 CoAP 高效安全的数据传输标准协议建立。基于 CoAP（RFC 7252）的设备服务的简述，LwM2M 定义了一个简 单的对象模型和一组设备管理的接口和操作。 本文档介绍如何将应用了移远通信 BC25 系列、BC260Y-CN、BC28-F、BC95-GF、BC28-CNV 和 BC95-CNV 模块的设备，通过 AT 命令、基于 LwM2M 协议连接到中国联通雁飞•格物 DMP 平台（本文简 称'平台'）。 1.1. 适用模块 表 1：适用模块 模块系列 BC2x BC9x 模块 BC25 系列 BC260Y-CN BC28-F BC28-CNV BC95-GF BC95-CNV 上海移远通信技术股份有限公司 7 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 2 平台配置 使用移远通信模块连接平台之前，需按照如下章节所述内容在平台进行相应的配置。 2.1. 登录平台 注册账号并登录平台（https://dmp.cuiot.cn）。成功登录后点击'控制台'。 图 1：进入雁飞•格物 DMP 平台控制台 上海移远通信技术股份有限公司 8 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 2.2. 创建产品 2.2.1. 新增产品 点击左侧导航栏'产品'，随后点击右侧'新增'新建一款产品。 图 2：新增产品 2.2.2. 配置产品信息 在'新建产品'界面，根据业务需求编辑产品各项配置，填写完成后点击'提交'。以创建燃气表为例： 图 3：配置产品信息 上海移远通信技术股份有限公司 9 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 2.2.3. 编辑物模型 产品信息配置完成后，选择'功能定义'，点击右侧'编辑物模型'开始为产品编辑物模型。示例如下： 图 4：编辑物模型 2.2.4. 添加自定义功能 根据如下步骤为产品添加自定义功能。 1. 在'编辑物模型'界面点击右侧'添加自定义功能'，针对创建的产品进行相关参数的添加。 图 5：添加自定义功能 上海移远通信技术股份有限公司 10 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 以燃气表产品为例，添加如下燃气表的相关参数： 图 6：添加产品相关参数 上海移远通信技术股份有限公司 11 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 2. 自定义功能添加完成后，点击'编辑物模型'页面下方'发布物模型'发布编辑完成的物模型。 示例如下： 图 7：发布物模型 2.3. 创建设备 产品创建完成后，可根据如下步骤添加设备。 1. 在指定产品信息页面点击'管理设备'。示例如下： 图 8：管理设备 上海移远通信技术股份有限公司 12 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 2. 在'设备'页面点击右侧'+新建'，在弹出窗口中输入设备信息后点击'提交'。示例如下： 图 9：创建设备 2.4. 解析数据 2.4.1. 设备上报数据调试 在产品详情页面选择'数据解析'，然后选择'设备上报数据'，随后按顺序编辑脚本、输入上报数据、 点击'保存'、点击'执行'，最后点击'提交'，完成上报数据的调试。示例如下： 图 10：设备上报数据调试 上海移远通信技术股份有限公司 13 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 2.4.2. 设备接收数据调试 在产品详情页面选择'数据解析'，然后在页面下方选择'设备接收数据'，输入下发数据，最后点击 '执行'即可模拟调试下发数据至设备。示例如下： 图 11：设备接收数据调试 备注 1. 有关执行的脚本内容，可咨询中国联通雁飞•格物 DMP 平台技术人员获取例程。 2. 设备上报或平台下发的数据需参考具体的物模型，否则平台无法解析。 上海移远通信技术股份有限公司 14 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 3 平台与模块通信 3.1. AT 命令接入 平台配置完成后，即可通过 AT 命令连接模块与平台。本章节介绍在模块端如何通过 AT 命令接入平台。 有关 AT 命令详情，请参考具体模块的 AT 命令手册。 3.1.1. BC25 系列模块接入平台 AT 命令示例 有关 AT 命令详情，请参考文档 [1]、文档 [2] 和文档 [3]。 +CPIN: READY AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 //设置禁用睡眠模式 //查询网络注册状态 //已注册到网络 OK AT+CGPADDR? +CGPADDR: 1,'100.75.211.205','' //查询是否获取到 IP 地址 OK AT+QIDNSGIP=1,'dmp-coap.cuiot.cn' OK //转换平台域名为 IP 地址格式 +QIURC: 'dnsgip',0,1,0 +QIURC: 'dnsgip','153.35.119.75' AT+NCFG=0,86400 OK AT+NCDPOPEN='153.35.119.75',5683 OK //配置设备在平台的生存周期 //连接模块至平台 +QLWEVTIND: 0 +QLWEVTIND: 3 AT+NMGS=17,00006441bb333300ff00066e6f726d616c,100 //发送数据至平台 OK 上海移远通信技术股份有限公司 15 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 +QLWEVTIND: 4 +NNMI: 26,010000001E4066666600FF000568656C6C6F0000017DE0923A35 //收到平台发送的数据 AT+QSCLK=1 //启用轻度睡眠和深度睡眠 OK +QATSLEEP 3.1.2. BC260Y-CN 模块接入平台 AT 命令示例 有关 AT 命令详情，请参考文档 [4]、文档 [5] 和文档 [6]。 +CPIN: READY +CEREG: 2 AT+QSCLK=0 OK //设置禁用睡眠模式 +CEREG: 1 +IP: 100.85.202.5 AT+QIDNSGIP=0,'dmp-coap.cuiot.cn' OK //转换平台域名为 IP 地址格式 +QIDNSGIP: 0,1,0 +QIDNSGIP: 153.35.119.75 AT+NCDPOPEN='153.35.119.75',5683 OK //连接模块至平台 +QLWEVTIND: 0 +QLWEVTIND: 3 AT+NMGS=17,00006441bb333300ff00066e6f726d616c,100 //发送数据至平台 OK +QLWEVTIND: 4 +NNMI: 26,010000001E4066666600FF000568656C6C6F0000017DE0923A35 //收到平台发送的数据 AT+QSCLK=1 //启用轻度睡眠和深度睡眠 OK +QNBIOTEVENT: 'ENTER DEEPSLEEP' 上海移远通信技术股份有限公司 16 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 3.1.3. BC28-CNV&BC95-CNV 模块接入平台 AT 命令示例 有关 AT 命令详情，请参考文档 [7]。 REBOOT_CAUSE_APPLICATION_POWER_ON_RESET Neul OK AT+CEREG? +CEREG:0,1 //查询网络注册状态 //已注册到网络 OK AT+CGPADDR=0 +CGPADDR:0,100.127.145.10 //查询=0 的 PDP 地址 OK AT+QDNS=0,'dmp-coap.cuiot.cn' OK //解析平台域名 +QDNS:153.35.119.75 AT+NCDP='153.35.119.75',5683 OK AT+QCFG='LWM2M/lifetime',86400 OK //配置平台的 IP 地址和端口 //配置平台的生命周期 REBOOT_CAUSE_APPLICATION_AT Neul OK +QLWEVTIND:0 +QLWEVTIND:3 AT+QLWULDATAEX=17,00006441bb333300ff00066e6f726d616c,0X0100 OK //发送数据至平台 +QLWULDATASTATUS:4 +NNMI:26,010000001E4066666600FF000568656C6C6F0000017DE0923A35 //模块从平台接收数据 上海移远通信技术股份有限公司 17 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 3.1.4. BC28-F&BC95-GF 模块接入平台 AT 命令示例 有关 AT 命令详情，请参考文档 [8]。 REBOOT_CAUSE_APPLICATION_POWER_ON_RESET OK AT+CEREG? +CEREG:0,1 //查询网络注册状态 //已注册到网络 OK AT+CGPADDR=0 +CGPADDR:0,100.68.106.230 //查询=0 的 PDP 地址 OK AT+QDNS=0,'dmp-coap.cuiot.cn' OK //解析平台域名 +QDNS:153.35.119.75 AT+NCDP='153.35.119.75',5683 OK REBOOTING ? REBOOT_CAUSE_APPLICATION_AT OK //配置平台的 IP 地址和端口 +QLWEVTIND:0 +QLWEVTIND:3 AT+QLWULDATAEX=17,00006441bb333300ff00066e6f726d616c,0X0100 OK //发送数据至平台 +QLWULDATASTATUS:4 +NNMI:26,010000001E4066666600FF000568656C6C6F0000017DE0923A35 //模块从平台接收数据 上海移远通信技术股份有限公司 18 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 3.2. 平台查看模块上报数据 模块成功接入后，可在平台查看模块上报的数据。登录后，进入设备详情页，选择'设备数据'即可 查看模块上报的数据。示例如下： 图 12：平台查看设备上报的数据 上海移远通信技术股份有限公司 19 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 3.3. 平台下发数据至模块 可通过调用平台提供的 API 在线调试向模块下发数据。 1. 在导航栏点击'社区'进入'开发者社区'，在'API 在线调试'点击'进入在线调试'。 图 13：API 在线调试 上海移远通信技术股份有限公司 20 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 2. 选择待调试的 API，填写对应的设备信息（设备信息可在设备详情中获取），点击'发起调用'开 始调用 API 向模块发送数据。示例如下： 图 14：API 在线调用 上海移远通信技术股份有限公司 21 / 22 BC2x&BC9x 系列中国联通雁飞•格物 DMP 平台接入指导 4 附录 参考文档与术语缩写 表 2：参考文档 文档名称 [1] Quectel_BC25_AT 命令手册 [2] Quectel_BC25&BC32 系列_TCP(IP)_应用指导 [3] Quectel_BC25 系列_中国电信物联网平台应用指导 [4] Quectel_BC260Y-CN_AT 命令手册 [5] Quectel_BC260Y-CN_TCP(IP)_应用指导 [6] Quectel_BC260Y-CN(R02)_中国电信物联网平台应用指导 [7] Quectel_BC28-CNV&BC95-CNV_AT 命令手册 [8] Quectel_BC28-F&BC95-GF_AT 命令手册 表 3：术语缩写 缩写 API CoAP DMP LwM2M NB-IoT PDP REST 英文全称 中文全称 Application Programming Interface 应用程序编程接口 Constrained Application Protocol 受限应用协议 Device Management Platform 设备管理平台 Lightweight Machine to Machine 轻量化的 M2M 协议 Narrow Band Internet of Things 窄带物联网 Packet Data Protocol 分组数据协议 Representational State Transfer 表述性状态转移 上海移远通信技术股份有限公司 22 / 22

BG95&BG77&BG600L Series GNSS Jamming Detection Application Note LPWA Module Series Version: 1.0 Date: 2022-02-25 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 1 / 13 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 2 / 13 LPWA Module Series About the Document Revision History Version 1.0 Date 2021-12-31 2022-02-25 Author Matt YE/ Kayn SHAO Matt YE/ Kayn SHAO Description Creation of the document First official release BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 3 / 13 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 1.2. GNSS Jamming Indicator .......................................................................................................... 6 1.3. Reference Noise Level (RNL) .................................................................................................... 7 1.4. Limitations .................................................................................................................................. 7 2 AT Command Description.................................................................................................................. 8 2.1. AT Command Introduction ......................................................................................................... 8 2.1.1. Definitions........................................................................................................................ 8 2.1.2. AT Command Syntax ...................................................................................................... 8 2.2. Declaration of AT Command Examples ..................................................................................... 9 2.3. Jamming Detection Related AT Command................................................................................ 9 2.3.1. AT+QGPSCFG='agnssjamming' Enable/Disable GNSS Jamming Detection ............ 9 3 Summary of Error Codes ................................................................................................................. 12 4 Appendix Reference ......................................................................................................................... 13 BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 4 / 13 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Summary of Error Codes.............................................................................................................. 12 Table 3: Terms and Abbreviations .............................................................................................................. 13 BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 5 / 13 LPWA Module Series 1 Introduction This document describes how to implement GNSS jamming detection for Quectel BG95 series, BG77 and BG600L-M3 modules via AT commands. 1.1. Applicable Modules Table 1: Applicable Modules Module Series BG95 BG77 BG600L Model BG95-M1 BG95-M2 BG95-M3 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS 1.2. GNSS Jamming Indicator GNSS jamming indicator is a metric that is linearly proportional to the sum of jammer and noise power at the GNSS antenna port. The jamming indicator can be used to measure the relative increase in the current noise floor, including jammer, versus the observed reference noise level (RNL) — both measured at the GNSS receiver input. In an interference environment, the measured value of the GNSS jamming indicator will increase. BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 6 / 13 LPWA Module Series Interference to the signal received by the module is assessed based on the comparison between the measured value of the GNSS jamming indicator and RNL. 1.3. Reference Noise Level (RNL) To detect jamming events, BG95 series, BG77 and BG600L-M3 modules use a relative measure of the noise level (i.e., RNL) at the input of the GNSS receiver. RNL value is unavailable by default. It will be automatically calculated and updated, once the following conditions are met. a. Jamming detection is enabled (See Chapter 2.3.1). b. GNSS is turned on and the module has been successfully positioned. c. Positioning accuracy is less than 20 m and lasts for 20 s. Therefore, the RNL is changing and automatically adapts to the environment. To avoid too frequent saving of the RNL value to NVRAM, RNL is saved to NVRAM only once at the first update after the module is powered on. The modules support setting an estimated RNL with AT+QGPSCFG='agnssjamming', which is otherwise not recommended, because the modules can update RNL automatically when jamming detection is enabled and the modules work properly. 1.4. Limitations GNSS jamming indicator is a relative measure, therefore there are certain limitations associated with it. Limitations on the use of GNSS jamming detection feature: a. When detecting jammers at the beginning of a GNSS tracking session, the jamming indicator assumes that the antenna input signal conditions are similar to those of a previous GNSS tracking session, i.e., the surrounding environment and the location of the device did not change dramatically. b. When GNSS signals are strong, it is possible to get a good GNSS position fix in the presence of jammers. Jammers can cause RNL bias by several dB, thus impacting RNL reliability in detecting them. c. 'Moderately' and 'severely' jammed conditions as well as their associated thresholds assume open sky and strong GNSS signal conditions. When the GNSS signals are weaker, jammer impact is more pronounced. For example, in challenging GNSS signal conditions, a 5 dB jammer may severely impact GNSS performance. d. Jamming detection cannot be supported when an active antenna is used for GNSS signal reception. BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 7 / 13 LPWA Module Series 2 AT Command Description 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 1: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 8 / 13 LPWA Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 2.3. Jamming Detection Related AT Command 2.3.1. AT+QGPSCFG='agnssjamming' Enable/Disable GNSS Jamming Detection This command enables or disables GNSS jamming detection. AT+QGPSCFG='agnssjamming' Enable/Disable GNSS Jamming Detection Test Command AT+QGPSCFG=? Response: … +QGPSCFG: 'agnssjamming',(range of s),(range of supported s) ... supported Write Command AT+QGPSCFG='agnssjamming' [,[,]] OK Response If the optional parameters are omitted, query the current setting. +QGPSCFG: 'agnssjamming',,,[/], OK If any of the optional parameters is specified, enable/disable jamming detection and/or set the estimated RNL value. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms This command takes effect immediately. The configuration will be not saved. The configuration will be saved automatically. BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 9 / 13 Parameter LPWA Module Series Integer type. Enable/disable GNSS jamming detection and configure URC reporting mode. 0 Disable jamming detection function 1 Enable jamming detection function and report URC every second 2 Enable jamming detection and report URC when the jamming state changes URC is presented below: +QGPSURC: 'jamming_ind',,, Integer type. Estimated Reference Noise Level. Range: 0–105. It is recommended NOT to set this value. Integer type. Jamming state. 0 Jamming does not exist 1 Jamming exists Integer type. Reference Noise Level. NULL means there is no valid RNL. Range: 0–105. Integer type. Jamming metric measured in real time. Unit: dB. Integer type. Error code. See Chapter 3 for more information. NOTE If has not been specified, the RNL returned by AT+QGPSCFG='agnssjamming' is the actual RNL, and NULL means there is no valid RNL. If has been specified, the RNL returned by AT+QGPSCFG='agnssjamming' is the estimated RNL, and it will be updated into the actual RNL after the RNL is available. Example AT+QGPSCFG='agnssjamming',1 OK AT+QGPS=1 OK //Enable jamming detection function and reporting URC every second. //Start GNSS, and wait until GNSS gets position fix and RNL is updated. AT+QGPSCFG='agnssjamming' +QGPSCFG: 'agnssjamming',1,1,55,55 //Query the current jamming detection and URC state. OK //When jammer is detected, the module reports GNSS jamming detection URCs +QGPSURC: 'jamming_ind',1,55,67 +QGPSURC: 'jamming_ind',1,55,67 BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 10 / 13 +QGPSURC: 'jamming_ind',1,55,67 AT+QGPSCFG='agnssjamming',0 OK LPWA Module Series //Disable jamming detection function BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 11 / 13 LPWA Module Series 3 Summary of Error Codes The indicates an error related to the GNSS operation. The details about are presented in the following table. Table 2: Summary of Error Codes 501 502 503 Meaning Invalid parameter Operation not supported GNSS subsystem busy 504 Active session 505 Inactive session 506 Operation timeout 549 Unknown error BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 12 / 13 LPWA Module Series 4 Appendix Reference Table 3: Terms and Abbreviations Abbreviation EGPRS GNSS GPS LPWA NVRAM RNL URC Wi-Fi Description Enhanced General Packet Radio Service Global Navigation Satellite System Global Positioning System Low Power Wide Area Non-Volatile Random Access Memory Reference Noise Level Unsolicited Result Code Wireless Fidelity BG95&BG77&BG600L_Series_GNSS_Jamming_Detection_Application_Note 13 / 13

BC95-CNV&BC35-G &BC95 R2.0 系列 差异说明 NB-IoT 模块系列 版本：1.0 日期：2022-01-15 状态：受控文件 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 文档历史 修订记录 版本 日期 - 2021-11-02 1.0 2022-01-15 作者 Clifton HE/ Miles LI/ Gary TANG Clifton HE/ Miles LI/ Gary TANG 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 特殊符号..................................................................................................................................... 6 2 硬件差异 ................................................................................................................................................. 7 2.1. 主要性能..................................................................................................................................... 7 2.2. 硬件接口..................................................................................................................................... 9 2.3. 模块功耗................................................................................................................................... 12 2.4. 绝对最大额定值........................................................................................................................ 12 2.5. 发射功率和接收灵敏度............................................................................................................. 13 2.5.1. 发射功率 ......................................................................................................................... 13 2.5.2. 接收灵敏度 ..................................................................................................................... 13 2.6. ESD 性能 ................................................................................................................................. 14 3 软件差异 ............................................................................................................................................... 15 3.1. 软件功能................................................................................................................................... 15 3.1.1. BC95-CNV 新增功能 ...................................................................................................... 15 3.1.2. 功能差异 ......................................................................................................................... 15 3.2. AT 命令和 URC 差异................................................................................................................ 16 3.2.1. BC95-CNV 新增 AT 命令和 URC ................................................................................... 16 3.2.2. AT 命令和 URC 差异 ...................................................................................................... 17 4 附录 参考文档及术语缩写 ................................................................................................................... 21 上海移远通信技术股份有限公司 4 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 表格索引 表 1：特殊符号 ............................................................................................................................................. 6 表 2：BC95-CNV 和 BC35-G/BC95 R2.0 硬件关键特性差异 ...................................................................... 7 表 3：BC95-CNV 和 BC35-G/BC95 R2.0 硬件接口对比 ............................................................................. 9 表 4：BC95-CNV 和 BC35-G/BC95 R2.0 耗流（典型值）对比（3.6 V 供电） ........................................ 12 表 5：BC95-CNV 和 BC35-G/BC95 R2.0 模块绝对最大额定值 ................................................................ 12 表 6：BC95-CNV 和 BC35-G/BC95 R2.0 射频发射功率对比（上行 QPSK 和 BPSK 调制）................... 13 表 7：BC95-CNV 蓝牙发射功率................................................................................................................. 13 表 8：BC95-CNV 和 BC35-G/BC95 R2.0 接收灵敏度对比........................................................................ 13 表 9：BC95-CNV 蓝牙接收灵敏度 ............................................................................................................. 14 表 10：BC95-CNV 和 BC35-G/BC95 R2.0 的 ESD 性能参数（温度：25 ºC，湿度：45 %，单位：kV） ............................................................................................................................................................ 14 表 11：BC95-CNV 模块新增功能 ............................................................................................................... 15 表 12：BC95-CNV 和 BC35-G/BC95 R2.0 功能差异 ................................................................................ 15 表 13：BC95-CNV 模块新增 AT 命令和 URC ............................................................................................ 16 表 14：BC95-CNV 和 BC35-G/BC95 R2.0 的 AT 命令和 URC 差异 ......................................................... 17 表 15：参考文档 ......................................................................................................................................... 21 表 16：术语缩写 ......................................................................................................................................... 21 上海移远通信技术股份有限公司 5 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 1 引言 本文档主要介绍说明移远通信 NB-IoT 模块 BC95-CNV 模块，和 BC35-G 及 BC95 R2.0 系列模块之间 的差异。BC95-CNV 模块兼容 BC35-G 和 BC95 R2.0 系列模块的引脚定义，但软件功能不完全相同。 文档主要列举了 BC95-CNV、BC35-G 和 BC95 R2.0 系列模块的硬件和软件差异，旨在帮助客户通过 对比更好地了解和使用 BC95-CNV、BC35-G 和 BC95 R2.0 系列模块。 备注 BC35-G 和 BC95 R2.0 系列模块可能包含不同版本，本文档说明了 BC95-CNV 和标准版本 BC35-G 和 BC95 R2.0 系列模块的差异。 1.1. 特殊符号 表 1：特殊符号 符号 * 定义 若无特别说明，模块功能、特性、接口、引脚名称、AT 命令或参数后所标记的星号（*）表 示该功能、特性、接口、引脚、AT 命令或参数正在开发中，因此暂不支持；模块子型号后所 标记的星号（*）表示该子型号暂无样品。 上海移远通信技术股份有限公司 6 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 2 硬件差异 2.1. 主要性能 模块硬件关键特性差异如下表所示： 表 2：BC95-CNV 和 BC35-G/BC95 R2.0 硬件关键特性差异 参数 频段 供电电压 省电 发射功率 温度范围 USIM 接口 串口 BC95-CNV B3/B5/B8 ⚫ VBAT 供电电压范围：2.1~4.2 V ⚫ 典型供电电压：3.0/3.6 V 2.0 μA BC35-G/BC95 R2.0 ⚫ BC35-G：B1/B3/B5/B8/B20/B28 ⚫ BC95 R2.0： - BC95-B5 R2.0：B5 - BC95-B8 R2.0：B8 ⚫ VBAT 供电电压范围：3.1~4.2 V ⚫ 典型供电电压：3.6 V 3.0 μA 23 dBm ±2 dB 23 dBm ±2 dB ⚫ 正常工作温度：-35 ~ +75 °C 1 ⚫ 正常工作温度：-35 ~ +75 °C 1 ⚫ 扩展工作温度：-40 ~ +85 °C 2 ⚫ 扩展工作温度：-40 ~ +85 °C 2 ⚫ 存储温度：-40 ~ +90 °C ⚫ 存储温度：-40 ~ +90 °C 支持 1.8/3.0 V USIM 卡（支持 3.0 V USIM 卡时， 支持 1.8/3.0 V USIM 卡 需要 VBAT 供电不低于 3.0 V） ⚫ 主串口： ⚫ 主串口： - 用于 AT 命令通信和数据传输，默认波特率 用于 AT 命令通信和数据传输，默认波特率 9600 bps 9600 bps - 用于固件升级，支持的波特率为 115200 bps ⚫ 调试串口： 和 921600 bps - 用于软件调试 ⚫ 调试串口： - 用于固件升级，默认波特率 921600 bps 用于软件调试，仅支持波特率 921600 bps 1 当模块在此温度范围工作时，模块的相关性能满足 3GPP 标准要求。 2 当模块在此温度范围工作时，模块仍能保持正常工作状态，具备短信、数据传输等功能；不会出现不可恢复的故障；射频 频谱、网络基本不受影响。仅个别指标如输出功率等参数的值可能会超出 3GPP 标准的范围。当温度返回至正常工作温度范 围时，模块的各项指标仍符合 3GPP 标准。 上海移远通信技术股份有限公司 7 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 IPv4/IPv6/UDP/TCP/Non-IP/CoAP/LwM2M/ 网络协议特性 DTLS/MQTT/HTTP*/DNS/TLS* 短消息 PDU 模式 ⚫ Single-tone： 25.2 kbps（下行），15.625 kbps（上行） ⚫ Multi-tone： 数据传输特性 25.2 kbps（下行），54 kbps（上行） ⚫ Extended TBS/2 HARQ： 125 kbps（下行），150 kbps（上行） OTDOA 协议：3GPP Rel-14 ⚫ BC35-G: IPv4/IPv6/UDP/CoAP/LwM2M/Non-IP/DTLS/ TCP/MQTT ⚫ BC95 R2.0: IPv4/IPv6/UDP/CoAP/LwM2M/ Non-IP/DTLS/ TCP PDU 模式 ⚫ Single-tone： 25.2 kbps（下行），15.625 kbps（上行） ⚫ Multi-tone： 25.2 kbps（下行），54 kbps（上行） ⚫ Extended TBS/2 HARQ： 125 kbps（下行），150 kbps（上行） 协议：3GPP Rel-14 E-CID 蓝牙特性 3 AT 命令 物理特征 固件升级 天线接口 协议：3GPP Rel-13 协议：3GPP Rel-13 ⚫ 支持 Bluetooth Core Specification 5.0 ⚫ 支持 BLE（低功耗蓝牙） 不支持 ⚫ 3GPP TS 27.007 ⚫ 3GPP TS 27.005 ⚫ Quectel 增强型 AT 命令 ⚫ 3GPP TS 27.007 ⚫ 3GPP TS 27.005 ⚫ Quectel 增强型 AT 命令 ⚫ 尺寸：(23.6 ±0.15) mm × (19.9 ±0.15) mm × ⚫ 尺寸：(23.6 ±0.15) mm × (19.9 ±0.15) mm × (2.2 (2.2 ±0.20) mm ⚫ 重量：约 1.5 ±0.2 g ±0.20) mm ⚫ 重量：约 1.8 ±0.2 g ⚫ 通过调试串口升级 ⚫ DFOTA 升级 ⚫ 通过主串口升级 ⚫ DFOTA 升级 50 Ω 特性阻抗 50 Ω 特性阻抗 备注 蓝色字体用于标示表格中模块之间存在的差异。 3 BC95-CNV 蓝牙功能仅部分版本支持，详情请咨询移远通信技术支持。 上海移远通信技术股份有限公司 8 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 2.2. 硬件接口 BC95-CNV 模块兼容 BC35-G 和 BC95 R2.0 系列模块的封装，在电气特性方面略有差异，硬件接口的 功能对比如下表所示： 表 3：BC95-CNV 和 BC35-G/BC95 R2.0 硬件接口对比 引脚号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 BC95-CNV 引脚名 RESERVED GND RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESET_N RESERVED RESERVED NETLIGHT DBG_RXD DBG_TXD ADC0 描述 地 模块复位 网络状态指示 调试串口接收 调试串口发送 通用模数转换接口 BC35-G/BC95 R2.0 引脚名 描述 RESERVED - GND 地 RESERVED - RESERVED - RESERVED - RESERVED - RESERVED - RESERVED - RESERVED - RESERVED - RESERVED - RESERVED - RESERVED - RESERVED - RESET 模块复位 RESERVED - RESERVED - NETLIGHT 网络状态指示 DBG_RXD 调试串口接收 DBG_TXD 调试串口发送 ADC 通用模数转换接口 差异性 引脚名称定义不同 BC95-CNV 支持 2 个模数 上海移远通信技术股份有限公司 9 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 22 ADC1 通用模数转换接口 RESERVED - 转换接口 23 RESERVED - RESERVED - - 24 RESERVED - RESERVED - - 25 RESERVED - RESERVED - - 26 VDD_EXT 外部电路供电口 VDD_EXT 外部电路供电口 BC95-CNV： 当 3.0 V ≤ VBAT ≤ 4.2 V， VDD_EXT = 3.0 V； 当 2.1 V ≤ VBAT < 3.0 V， VDD_EXT = VBAT 27 RESERVED - RESERVED - BC35-G/BC95 R2.0： VDD_EXT = 3.0 V - 28 RESERVED - RESERVED - - 29 MAIN_RXD 4 串口接收数据 RXD 4 串口接收数据 引脚名称定义不同 30 MAIN_TXD 串口发送数据 TXD 串口发送数据 引脚名称定义不同 31 RESERVED - RESERVED - - 32 RESERVED - RESERVED - - 33 RESERVED - RESERVED - - 34 RI 主串口输出振铃提示 RI 主串口输出振铃提示 - 35 RESERVED - RESERVED - - 36 RESERVED - RESERVED - - 37 WAKEUP_OUT 深休眠状态指示 RESERVED - BC95-CNV 支持深休眠状 态指示接口，深休眠输出高 电平，唤醒输出低电平。 38 USIM_VDD USIM 卡供电 39 USIM_RST USIM 卡复位 40 USIM_DATA USIM 卡数据 41 USIM_CLK USIM 卡时钟 USIM_VDD USIM 接口 USIM_RST USIM 卡复位 USIM_DATA USIM 卡数据 USIM_CLK USIM 卡时钟 BC95-CNV： 当 VBAT ≥ 3 V 时，支持 1.8/3.0 V USIM 卡 当 VBAT < 3 V 时，仅支持 1.8 V USIM 卡 BC35-G/BC95 R2.0： 42 USIM_GND USIM 卡专用地 USIM_GND USIM 卡专用地 支持 1.8/3.0 V USIM 卡 43 GND 地 GND 地 - 4 BC95-CNV 的 MAIN_RXD 引脚及 BC35-G 和 BC95 R2.0 的 RXD 引脚均不可悬空或下拉。 上海移远通信技术股份有限公司 10 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 44 RESERVED - 45 VBAT 46 VBAT 电源输入 47 GND 地 48 GND 地 49 RESERVED - 50 RESERVED - 51 GND 地 52 GND 地 53 ANT_RF&BT 天线接口 54 GND 地 55~58、 67~70、 RESERVED - 75~80、 84~91 59~66、 71~74、 GND 地 81~83、 92~94 RESERVED - VBAT VBAT 电源输入 GND 地 GND 地 RESERVED - RESERVED - GND 地 GND 地 RF_ANT 天线接口 GND 地 RESERVED - GND 地 BC95-CNV： 2.1 V ≤ VBAT ≤ 4.2 V， 典型供电电压为 3.0/3.6 V BC35-G/BC95 R2.0： 3.1 V ≤ VBAT ≤ 4.2 V， 典型供电电压为 3.6 V BC95 R2.0&BC35-G： NB-IoT 天线 BC95-CNV： NB-IoT 天线/蓝牙天线 5 - - - 备注 1. 蓝色字体用于标示表格中模块之间存在的差异。 2. 针对 BC95-CNV 模块，VBAT 上电时间需要保证在 1 毫秒以内，上电后到完成开机的时间至少 2 秒； 针对 BC35-G 和 BC95 R2.0 模块，VBAT 上电时间需要保证在 100 毫秒以内，上电后到完成开机的时 间至少 4.3 秒。 5 BC95-CNV 蓝牙功能仅部分版本支持，详情请咨询移远通信技术支持。 上海移远通信技术股份有限公司 11 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 2.3. 模块功耗 BC95-CNV、BC35-G 和 BC95 R2.0 系列模块耗流数据差异如下表所示： 表 4：BC95-CNV 和 BC35-G/BC95 R2.0 耗流（典型值）对比（3.6 V 供电） 状态 描述 BC95-CNV BC35-G BC95 R2.0 单位 PSM 深休眠状态 2.0 3.0 3.0 µA DRX = 2.56 s，ECL0 空闲状态 0.15 0.5 0.5 mA B3: 330 射频发射状态，23 dBm B5/B8: 215 B1/B3: 250 B8/B5/B20: 220 B28: 280 B8/B5: 220 mA Active @ Single-tone 射频发射状态，12 dBm B3/B5/B8: 80 B1/B3/B8/B5/B20/B28: 130 B8/B5: 130 mA （3.75/15 kHz） 射频发射状态，0 dBm B3/B5/B8: 45 B1/B3/B8/B5/B20/B28: 70 B8/B5: 70 mA Active @ Multi-tone （15 kHz） 射频接收状态 23 B3: 300 射频发射状态，23 dBm B5/B8: 190 60 60 mA B1/B3/B8/B5/B20/B28: 350 B8/B5: 350 mA 2.4. 绝对最大额定值 BC95-CNV、BC35-G 和 BC95 R2.0 模块的绝对最大额定值对比如下表格所示： 表 5：BC95-CNV 和 BC35-G/BC95 R2.0 模块绝对最大额定值 对比项 VBAT 数字引脚处电压 模拟引脚处电压 关机模式下数字/ 模拟引脚处电压 BC95-CNV 最小值 - 最大值 +4.2 V +3.6 V (VBAT - 0.15) V - BC35-G/BC95 R2.0 最小值 最大值 -0.3 V -0.3 V -0.3 V +4.25 V +4.25 V +4.25 V -0.25 V +0.25 V 上海移远通信技术股份有限公司 12 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 2.5. 发射功率和接收灵敏度 2.5.1. 发射功率 BC95-CNV、BC35-G 和 BC95 R2.0 系列模块射频发射功率没有差异，但 BC95-CNV 可选支持 BLE 功能，具体数据如下所示： 表 6：BC95-CNV 和 BC35-G/BC95 R2.0 射频发射功率对比（上行 QPSK 和 BPSK 调制） 模块 BC95-CNV BC35-G BC95 R2.0 系列 发射功率最大值 23 dBm ±2 dB 23 dBm ±2 dB 23 dBm ±2 dB 发射功率最小值 < -40 dBm < -40 dBm < -40 dBm 表 7：BC95-CNV 蓝牙发射功率 测试信道 发射功率 0 10.5 dBm 39 10.5 dBm 78 10.5 dBm 2.5.2. 接收灵敏度 BC95-CNV、BC35-G 和 BC95 R2.0 系列模块接收灵敏度差异如下表所示： 表 8：BC95-CNV 和 BC35-G/BC95 R2.0 接收灵敏度对比 模块 BC95-CNV BC35-G 频段 B3/B5/B8 B1 B3 B8 B5 B20 单传接收灵敏度 -115 dBm -112 dBm -112 dBm -114 dBm -114 dBm -114 dBm 128 次重传接收灵敏度 -129 dBm -128 dBm -128 dBm -130 dBm -130 dBm -130 dBm 上海移远通信技术股份有限公司 13 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 B28 BC95 R2.0 系列 B5/B8 -114 dBm -114 dBm -130 dBm -130 dBm BC95-CNV 可选支持 BLE 功能，具体接收灵敏度数据如下所示： 表 9：BC95-CNV 蓝牙接收灵敏度 测试信道 接收灵敏度 0 -91 dBm 39 -92 dBm 78 -92 dBm 2.6. ESD 性能 BC95-CNV、BC35-G 和 BC95 R2.0 系列模块的 ESD 性能参数对比如下表所示： 表 10：BC95-CNV 和 BC35-G/BC95 R2.0 的 ESD 性能参数（温度：25 ºC，湿度：45 %，单位：kV） 模块 VBAT/GND 接触放电 空气放电 BC95-CNV ±5 ±10 BC35-G ±5 ±10 BC95 R2.0 系列 ±5 ±10 天线接口 接触放电 ±5 ±5 ±5 空气放电 ±10 ±10 ±10 其他接口 接触放电 ±0.5 ±0.5 ±0.5 空气放电 ±1 ±1 ±1 上海移远通信技术股份有限公司 14 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 3 软件差异 3.1. 软件功能 3.1.1. BC95-CNV 新增功能 表 11：BC95-CNV 模块新增功能 新增功能 说明 备注 Quick RRC Connection Release （RRC 连接快速释放） Mixed Standalone Operation Measurement Report in MSG5 CQI Report in MSG3 UE 发 送 HARQ ACK 后 即 认 为 成 功 收 到 RRCConnectionRelease 消息 支持 SA 模式的锚点载波和 IB/GB 部署的非锚 点载波混合部署，支持 IB/GB 部署的锚点载波 和 SA 模式的非锚点载波混合部署。 在 MSG5 中上报 RSRP/RSRQ 信息给网络 在 MSG3 中上报 CQI 信息给网络 详情请参考 3GPP Release 15 详情请参考 3GPP Release 15 详情请参考 3GPP Release 14 详情请参考 3GPP Release 14 BLE 5.0 支持低功耗蓝牙功能 6 - 通过 IPv6 连接 LwM2M 物联网平台 新增支持此功能 - DNS 解析的重试次数和超时时间 支持域名解析时（AT+QDNS）设置重试次数 和超时时间 - 3.1.2. 功能差异 表 12：BC95-CNV 和 BC35-G/BC95 R2.0 功能差异 功能 BC95-CNV BC35-G/BC95 R2.0 DNS 服务器地址 无默认配置 有默认配置 6 BC95-CNV 蓝牙功能仅部分版本支持，详情请咨询移远通信技术支持。 上海移远通信技术股份有限公司 备注 用户必须自己配置或者 网络下发 DNS 服务器地 址。 15 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 DNS 解析 LwM2M CON 数 据超时时间 CoAP 功能 解析结果掉电不保存。 解析结果在模块进入深休眠或执行 - AT+NRB 重启后保存到 KV。 最大重试次数为 4 次，第 1 次重试前 最大重试次数为 4 次，间隔根据信号强 等待 8 秒，重试间隔时间分别为 16 秒、 度等参数计算。最大超时时间在非 客户应用逻辑需要调整 32 秒和 64 秒，第 4 次重试后等待 128 DTLS 情况下为 165 秒，在 DTLS 情况 CON 数据的超时时间。 秒，最大超时时间为 248 秒。DTLS 下 下为 400 秒。 最大超时时间为 700 秒。 支持的命令如下： ⚫ AT+QCOAPCREATE（创建 CoAP 上下文）； 支持的命令如下： ⚫ AT+QCOAPDEL（删除 CoAP 上 ⚫ AT+QCOAPOPEN（创建 CoAP 下文）； 上下文）； ⚫ AT+QCOAPADDRES（添加 AT 命令/URC 的格式、参 ⚫ AT+QCOAPCLOSE（删除 CoAP CoAP 客户端资源）； 数和逻辑均有调整，相互 上下文）； ⚫ AT+QCOAPHEAD（配置 CoAP 不兼容。有关 AT 命令 ⚫ AT+QCOAPOPTION（配置 消息头）； /URC 的具体调整情况， CoAP 消息选项）； ⚫ AT+QCOAPOPTION（配置 请 参 考 文 档 [1] 和 文 档 ⚫ AT+QCOAPHEAD（配置 CoAP CoAP 选项）； [2]。 消息的 Message ID 和 Token）； ⚫ AT+QCOAPSEND（发送数据） ⚫ AT+QCOAPSEND（发送数据） ⚫ AT+QCOAPDATASTATUS（查 询 CON 消息传递状态）； ⚫ AT+QCOAPCFG（CoAP 配置命 令） 联通自注册 不支持 支持测试 - 3.2. AT 命令和 URC 差异 3.2.1. BC95-CNV 新增 AT 命令和 URC 本章节列举了 BC95-CNV 模块新增的 AT 命令及 URC，命令和 URC 详情请参考文档 [3]。 表 13：BC95-CNV 模块新增 AT 命令和 URC AT 命令/URC AT+CPSDO AT+NBIPR AT+NDSDELAY 说明 设置 PS Data Off（PS 数据关闭）状态 设置禁用或启用 BIP 状态上报 设置延迟深休眠模式的时长 上海移远通信技术股份有限公司 16 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 AT+NGSEARFCN 读取已保存的 PLMN 及对应的 EARFCN（频点） AT+NGT3412 读取 T3412 计时器的实际值 AT+NPSMSET 设置省电模式 AT+NQPULD 查询待处理的上行数据 AT+NSIMSRS 设置禁用或启用 USIM 状态报告 AT+NPACR 设置禁用或启用主动命令上报 AT+QADC 读取 ADC 值 AT+QBANKCDPMODE 设置开启或关闭深休眠时 VDDIO_C 电压输出 AT+QMRXDPULLMODE 设置主串口 RXD（MAIN_RXD）的上拉模式 FIRMWARE UPDATE TIMEOUT 指示固件升级超时的 URC FIRMWARE DOWNLOAD RESUME 指示恢复下载的 URC 3.2.2. AT 命令和 URC 差异 本章节列举了 BC95-CNV、BC35-G 和 BC95 R2.0 系列模块的 AT 命令及 URC 差异。命令和 URC 的 详细信息，请参考文档 [3] 和文档 [4]。 表 14：BC95-CNV 和 BC35-G/BC95 R2.0 的 AT 命令和 URC 差异 AT 命令/URC AT+CGDCONT AT+CFUN AT+CNEC AT+CLAC AT+NEARFCN 差异对比 BC95-CNV BC35-G/BC95 R2.0 BC95-CNV 差异点 测试命令响应： 测试命令响应： +CGDCONT:(0-10),('IP','IPV6 +CGDCONT:(0-10),('IP','NON 定义 PDP 上下文命令： ','IPV4V6','NONIP'),,,,(0,1),,,, IP','IPV6','IPV4V6'),,,(0),(0,1) 1.枚举值顺序更新； ,(0,1),(0,1) ,,,,,(0,1),(0,1) 2. 删除响应 …… …… 测试命令响应： +CFUN:(0,1,5) …… 测试命令响应： +CFUN:(0,1),(0,1) …… 设置 UE 功能命令： 1. 不支持参数； 2. 新增=5 支持 部分版本支持 - 按字母排序返回命令列表 测试命令响应： 按命令新增顺序排序返回命令列 列出可用命令： 表 更新命令排序 测试命令响应： 指定搜索频点命令： 上海移远通信技术股份有限公司 17 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 +NEARFCN:(0),(0-262143),(0- OK 1F7) …… SECURITY 核 Log 等级不可配 AT+NLOGLEVEL SECURITY 核 Log 等级可配置 置，始终为 NONE 新增测试命令响应 - 支持 AT+NSOST=? 不支持 AT+NSOST=? AT+NSOST 设置命令： 设置命令： 发送消息（仅 UDP）命令： AT+NSOST=,<remot AT+NSOST=,,,,,<leng 2. 新增 RAI 参数 th>,[,[,,[,] g>]] AT+NSOSTF 支持 AT+NSOSTF=? 不支持 AT+NSOSTF=? 发送带标志的消息（仅 UDP）命令： 新增支持测试命令 AT+NQSOS 支持 AT+NQSOS=? 不支持 AT+NQSOS=? 查询待处理 Socket 消息清单命令： 新增支持测试命令 AT+NSORF 支持 AT+NSORF=? 不支持 AT+NSORF=? 读取消息命令： 新增支持测试命令 AT+NSOCO 支持 AT+NSOCO=? 不支持 AT+NSOCO=? 连接（仅 TCP）命令： 新增支持测试命令 AT+NSOSD 支持 AT+NSOSD=? 不支持 AT+NSOSD=? 发送消息（仅 TCP）命令： 新增支持测试命令 AT+NSOSTATUS 支持 部分版本支持 获取 Socket 状态命令： 参数新增值 4 和 5 AT+NPING 支持 AT+NPING=? 设置命令： AT+NPING=[,][,[,[,[,]]]] 不支持 AT+NPING=? 设置命令： AT+NPING=[,[,]] 测试到远程主机的 IP 网络连接命 令： 1. 新增支持测试命令； 2. 支持指定上下文 ID、PING 次数， RAI，新增、、 参数 AT+NPSMR 支持=2 不支持=2 省电模式状态上报命令： 新增增强型 PSM 模式状态上报 AT+CEDRXS 测试命令响应： 测试命令响应： +CEDRXS:(0,1,2,3),(5),('0010' +CEDRXS:(0,1,2,3),(5),('0000' 设置 eDRX 命令： ,'0011','0101','1001','1010', -'1111') 调整测试命令 新增参数表示负载 长度。详情请参考文档 [5] 和文档 [6]。 AT+QDMPCFG 范围：1~49 字节； 、、 范围：1~65535； 和参 DM 平台接入配置命令： 范围：8~16 字节； 数范围未列出； 更新参数范围，具体差异请参照文 范围：16~48 字节； 参数范围： 档 [7] 和文档 [8]。 范围： 300~4294966 秒 120~4294966 秒 最大长度 63 字节； 最大长度 255 字节； 最大长度 7 字节； 最大长度 19 字节； 最大长度 7 字节； 最大长度 15 字节； 最大长度 19 字节； 最大长度 19 字节； 最大长度 15 字节； 最大长度 47 字节； DM 平台接入配置扩展命令： 最大长度 19 字节； AT+QDMPCFGEX 最大长度 47 字节； 更新参数范围，具体差异请参照文 最大长度 15 字节； 最大长度 47 字节； 档 [7] 和文档 [8]。 最大长度 7 字节； 最大长度 19 字节； 最大长度 15 字节； 最大长度 47 字节； 最大长度 15 字 最大长度 19 字 节； 节； 最大长度 47 字节 最大长度 255 字节 上海移远通信技术股份有限公司 20 / 22 BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 4 附录 参考文档及术语缩写 表 15：参考文档 文档名称 [1] Quectel_BC28-CNV&BC95-CNV_CoAP_应用指导 [2] Quectel_BC35-G&BC28_CoAP_应用指导 [3] Quectel_BC28-CNV&BC95-CNV_AT 命令手册 [4] Quectel_BC35-G&BC28&BC95 R2.0 系列_AT 命令手册 [5] Quectel_BC28-CNV&BC95-CNV_MQTT_应用指导 [6] Quectel_BC35-G&BC28_MQTT_应用指导 [7] Quectel_BC28-CNV&BC95-CNV_中国移动 DM 平台接入指导 [8] Quectel_BC35-G&BC28&BC95 R2.0 系列_中国移动 DM 平台接入指导 表 16：术语缩写 缩写 3GPP ACK ADC BLE BIP CoAP CON CQI 英文全称 3rd Generation Partnership Project Acknowledgement Analog-to-Digital Converter Bluetooth Low Energy Bearer Independent Protocol Constrained Application Protocol Confirmable Channel Quality Indicator 中文全称 第三代合作伙伴计划 确认消息 模数转换器 低功耗蓝牙 承载独立协议 受限的应用层协议 需要应答 信道质量指示 上海移远通信技术股份有限公司 21 / 22 DM DRX DNS DTLS ESD GB GND HARQ IB IoT IPv6 LwM2M OC PLMN PS PSM RRC RSRP RSRQ RXD SA SR UART UE USIM BC95-CNV&BC35-G&BC95 R2.0 系列差异说明 Device Management 设备管理 Discontinuous Reception 非连续接收 Domain Name Server 域名系统（服务）协议 Datagram Transport Layer Security 数据包传输层安全协议 Electrostatic Discharge 静电释放 Guard-Band 保护带部署 Ground 地 Hybrid Automatic Repeat Request 混合式自动重送请求 In-Band 带内部署 Internet of Things 物联网 Internet Protocol version 6 第 6 版互联网协议 Lightweight M2M 轻量化 M2M（协议） Ordering Code 采购编码 Public Land Mobile Network 公共陆地移动网络 Packet Switch 分组交换 Power Saving Mode 省电模式 Radio Resource Control 无线资源控制 Reference Signal Received Power 参考信号接收功率 Reference Signal Received Quality 参考信号接收质量 Receive Data (Pin) 数据接收（引脚） Stand Alone 独立部署 Segment Routing 分段路由 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 User Equipment 用户设备 Universal Subscriber Identity Module 通用用户识别模块 上海移远通信技术股份有限公司 22 / 22

BG770A-GL&BG95xA-GL MQTT Application Note LPWA Module Series Version: 1.0 Date: 2022-01-21 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG770A-GL&BG95xA-GL_MQTT_Application_Note 1 / 31 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG770A-GL&BG95xA-GL_MQTT_Application_Note 2 / 31 LPWA Module Series About the Document Revision History Version Date Author Description - 2021-05-18 Vladan RAKIC Creation of the document 1.0 2022-01-21 Vladan RAKIC First official release BG770A-GL&BG95xA-GL_MQTT_Application_Note 3 / 31 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 2 MQTT Data Interaction........................................................................................................................ 7 3 MQTT AT Commands ......................................................................................................................... 8 3.1. AT Command Introduction ......................................................................................................... 8 3.1.1. Definitions........................................................................................................................ 8 3.1.2. AT Command Syntax ...................................................................................................... 8 3.2. Declaration of AT Command Examples ..................................................................................... 9 3.3. Description of MQTT AT Commands ......................................................................................... 9 3.3.1. AT+QMTCFG Configure Optional Parameters of MQTT ............................................. 9 3.3.2. AT+QMTOPEN Open a Network Connection for MQTT Client ................................. 14 3.3.3. AT+QMTCLOSE Close a Network Connection for MQTT Client ............................... 15 3.3.4. AT+QMTCONN Connect a Client to MQTT Server.................................................... 15 3.3.5. AT+QMTDISC Disconnect a Client from MQTT Server ............................................. 17 3.3.6. AT+QMTSUB Subscribe to Topics ............................................................................. 18 3.3.7. AT+QMTUNS Unsubscribe from Topics ..................................................................... 19 3.3.8. AT+QMTPUB Publish Messages (Data Mode) .......................................................... 20 3.3.9. AT+QMTPUBEX Publish Messages (Command Mode) ............................................ 22 3.3.10. AT+QMTRECV Read Messages from Buffer ............................................................. 23 4 MQTT URCs ....................................................................................................................................... 25 4.1. +QMTSTAT: URC to Indicate State Change in MQTT Link Layer ........................................ 25 4.2. +QMTRECV: URC to Inform the Host to Read MQTT Packet Data..................................... 26 5 Examples ........................................................................................................................................... 27 5.1. Example of MQTT Operation without SSL .............................................................................. 27 5.2. Example of MQTT Operation with SSL.................................................................................... 29 6 Appendix References ....................................................................................................................... 31 BG770A-GL&BG95xA-GL_MQTT_Application_Note 4 / 31 LPWA Module Series Table Index Table 1: Error Codes of +QMTSTAT: URC................................................................................................. 25 Table 2: Related Documents ...................................................................................................................... 31 Table 3: Terms and Abbreviations .............................................................................................................. 31 BG770A-GL&BG95xA-GL_MQTT_Application_Note 5 / 31 LPWA Module Series 1 Introduction Message Queuing Telemetry Transport (MQTT) is a broker-based publish/subscribe messaging protocol designed to be open, simple, lightweight, and easy to implement. It is designed for connections with remote locations where a 'small code footprint' is required, or the network bandwidth is limited. This document explains how to use the MQTT function of Quectel BG770A-GL, BG950A-GL and BG951A-GL modules through AT commands. BG770A-GL&BG95xA-GL_MQTT_Application_Note 6 / 31 LPWA Module Series 2 MQTT Data Interaction This chapter illustrates the data interaction mechanism of the MQTT function. MCU Modem Link layer MQTT Server AT+QMTCFG='will',, AT+QMTCFG='timeout',, AT+QMTOPEN=,, OK TCP-REQ +QMTOPEN: , AT+QMTCONN AT+QMTCONN=,, OK +QMTCONN: ,[,] TCP established CONN-REQ Start timer T1, T2 CONN ACK-IND Stop T1 or handle Excep1 AT+QMTSUB AT+QMTSUB=,,, , OK SUB-REQ () Start timer T1 +QMTSUB: ,,[,] SUB ACK-IND () Stop T1 or handle Excep2 AT+QMTUNS AT+QMTUNS=,,, UNS-REQ () OK Start timer T1 +QMTUNS: ,, UNS ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB=,,=0,, OK PUB-REQ AT+QMTPUB (=1) AT+QMTPUB=,,=1,, OK PUB-REQ () Start timer T1 +QMTPUB: ,,[,] PUB ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB (=2) AT+QMTPUB=,,=2,, OK +QMTPUB: ,,[,] PUB-REQ () Start timer T1 PUB REC-IND () Stop T1 or handle Excep2 PUB REL-REQ () Start timer T1 PUB COMP-IND () Stop T1 or handle Excep2 TCP SYN TCP SYN+ACK TCP ACK Send connect packet Receive connect ACK packet Send subscribe packet Receive subscribe ACK packet Send unsubscribe packet Receive unsubscribe ACK packet Send publish packet Send publish packet Receive publish ACK packet Send publish packet Receive publish receive packet Send publish release packet Receive publish complete packet T1 is packet transmission timeout. T2 is keep alive timer. In the absence of a data-related message during the T2 time period, the client will send PINGREQ packet. Excep1: Disconnect the TCP connection. Excep2: Resend packets unless maximum retry times is reached. Retry times is set with AT+QMTCFG. Whether the timeout information is reported can be configured with AT+QMTCFG. Receive PUBLISH Receive message in the form of URC. +QMTRECV: ,, [,], AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , PUB-IND () PUB ACK/REC-REQ () Reply accor.d..ing to DISC-REQ Receive publish packet Send publish reply packet Send disconnect packet TCP-REQ TCP disconnected TCP discon.n..ect request Note: refers to optional parameters. For more details about optional parameters, please refer to the description of corresponding AT command in Chapter 3.3. Figure 1: MQTT Data Interaction Diagram BG770A-GL&BG95xA-GL_MQTT_Application_Note 7 / 31 LPWA Module Series 3 MQTT AT Commands The AT commands for using the MQTT function are presented in this chapter. 3.1. AT Command Introduction 3.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 1: Types of AT Commands Command Type Test Command Read Command Write Command Syntax Description AT+=? AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. AT+=[,[,[...]]] Set user-definable parameter value. BG770A-GL&BG95xA-GL_MQTT_Application_Note 8 / 31 Execution Command AT+ LPWA Module Series Return a specific information parameter or perform a specific action. 3.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 3.3. Description of MQTT AT Commands 3.3.1. AT+QMTCFG Configure Optional Parameters of MQTT This command configures optional parameters of MQTT. AT+QMTCFG Configure Optional Parameters of MQTT Test Command AT+QMTCFG=? Response +QMTCFG: 'version',(range of supported s),(list of supported s) +QMTCFG: 'pdpcid',(range of supported s),(range of supported s) +QMTCFG: 'ssl',(range of supported s),( list of supported s),(range of supported s) +QMTCFG: 'keepalive',(range of supported s),(range of supported s) +QMTCFG: 'session',(range of supported s),(list of supported s) +QMTCFG: 'timeout',(range of supported s),(range of supported s),(range of supported s),(list of supported s) +QMTCFG: 'will',(range of supported s),(list of supported s),(range of supported s),(list of supported s),, +QMTCFG: 'recv/mode',(range of supported s),(list of supported s),(list of supported s) +QMTCFG: 'aliauth',(range of supported s),,, BG770A-GL&BG95xA-GL_MQTT_Application_Note 9 / 31 LPWA Module Series Write Command Query/set the MQTT protocol version AT+QMTCFG='version',[,] OK Response If the optional parameter is omitted, query the MQTT protocol version: +QMTCFG: 'version', OK If the optional parameter is specified, set the MQTT protocol version: OK Write Command Query/set the PDP to be used by the MQTT client AT+QMTCFG='pdpcid',[,] If there is any error: ERROR Response If the optional parameter is omitted, query the PDP used by the MQTT client: +QMTCFG: 'pdpcid', OK If the optional parameter is specified, set the PDP to be used by the MQTT client: OK Write Command Query/set the MQTT SSL mode and SSL context index AT+QMTCFG='ssl',[,[,]] If there is any error: ERROR Response If the optional parameters are omitted, query the MQTT SSL mode and SSL context index: +QMTCFG: 'ssl',[,] OK If any of the optional parameters is specified, set the MQTT SSL mode and SSL context index: OK Write Command Query/set the keep-alive time AT+QMTCFG='keepalive',< client_idx>[,] If there is any error: ERROR Response If the optional parameter is omitted, query the keep-alive time: +QMTCFG: 'keepalive', OK BG770A-GL&BG95xA-GL_MQTT_Application_Note 10 / 31 LPWA Module Series If the optional parameter is specified, set the keep-alive time: OK Write Command Query/set the session type AT+QMTCFG='session',[, ] If there is any error: ERROR Response If the optional parameter is omitted, query the session type: +QMTCFG: 'session', OK If the optional parameter is specified, set the session type: OK Write Command Query/set the message delivery timeout AT+QMTCFG='timeout',[,[,< retry_times>][,]] If there is any error: ERROR Response If the optional parameters are omitted, query the message delivery timeout: +QMTCFG: 'timeout',,, OK If any of the optional parameters is specified, set the message delivery timeout: OK Write Command Query/set the Will information AT+QMTCFG='will',[,[,,, ,]] If there is any error: ERROR Response If the optional parameters are omitted, query the Will information: +QMTCFG: 'will',[,,,, ] OK If any of the optional parameters is specified, set the Will information: OK Write Command Query/set the MQTT If there is any error: ERROR Response If the optional parameters are omitted, query the MQTT message BG770A-GL&BG95xA-GL_MQTT_Application_Note 11 / 31 LPWA Module Series message receiving mode when the data are received from server AT+QMTCFG='recv/mode', [,[,]] receiving mode. +QMTCFG: 'recv/mode',[,] OK If any of the optional parameters is specified, set the MQTT message receiving mode: OK Write Command Query/set Alibaba device information for AliCloud AT+QMTCFG='aliauth',[,,< device_name>,] If there is any error: ERROR Response If the optional parameters are omitted, query the device information: [+QMTCFG: 'aliauth',,,] OK If the optional parameters are specified, set the device information: OK Maximum Response Time Characteristics If there is any error: ERROR Determined by the network. The command takes effect immediately. The configurations will not be saved. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. MQTT protocol version. 3 MQTT v3.1 4 MQTT v3.1.1 Integer type. PDP to be used by the MQTT client. Range: 1–5. Default value: 1 Integer type. Whether to configure the Will flag. 0 Ignore the Will flag configuration 1 Require the Will flag configuration Integer type. QoS level of message delivery. 0 At most once 1 At least once 2 Exactly once Integer type. Will Retain flag is only used for PUBLISH messages. BG770A-GL&BG95xA-GL_MQTT_Application_Note 12 / 31 LPWA Module Series 0 When a client sends a PUBLISH message to a server, the server will not retain the message after it has been delivered to the current subscribers. 1 When a client sends a PUBLISH message to a server, the server should retain the message after it has been delivered to the current subscribers. String type. Will topic. Maximum length: 255 bytes. String type. The Will message defines the content of the message published on the Will topic if the client is unexpectedly disconnected. It can be a zero-length message. Maximum length: 255 bytes. Integer type. Packet delivery timeout. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. Integer type. Whether to report timeout message when transmitting a packet. 0 Do not report 1 Report Integer type. Configures the session type. 0 The server must store the subscriptions of the client after it disconnects. 1 The server must discard any previously maintained information about the client after it disconnects and treat the connection as 'clean'. Integer type. Keep-alive time. Range: 0–3600. Default value: 120. Unit: second. It defines the maximum interval between messages received from a client. If the server does not receive a message from the client within 1.5 times of the keep-alive time value, it disconnects the client as if the client sent a DISCONNECT message. If the keep-alive time is 0, this means that the server is not required to disconnect the client on the grounds of inactivity. Integer type. MQTT SSL mode. 0 Use normal TCP connection for MQTT 1 Use SSL TCP secure connection for MQTT Integer type. SSL context index. Range: 0–5. Integer type. MQTT message receiving mode. 0 MQTT message received from server will be contained in URC 1 MQTT message received from server will not be contained in URC Integer type. 0 Length of MQTT message received from server will not be contained in URC 1 Length of MQTT message received from server will be contained in URC Product key issued by AliCloud. Device name issued by AliCloud. Device secret key issued by AliCloud. NOTE 1. If =1, then , , and must be specified. Otherwise, they are omitted. 2. =0 is only effective when the server supports the operation. BG770A-GL&BG95xA-GL_MQTT_Application_Note 13 / 31 LPWA Module Series 3. If MQTT connection is configured to SSL mode, must be specified, and AT+QSSLCFG must be used to configure the SSL version, cipher suite, secure level, CA certificate, client certificate, client key and ignorance of RTC time, which will be used in MQTT SSL handshake procedure. For more information on AT+QSSLCFG, see document [3]. 4. Care must be taken to ensure that message delivery does not time out while the sending process is in progress. 5. AT+QMTCFG='aliauth' is only used for AliCloud. If it is configured, and can be omitted in AT+QMTCONN. Once set, a specified session can only be used for AliCloud until reboot. 3.3.2. AT+QMTOPEN Open a Network Connection for MQTT Client This command opens a network connection for an MQTT client. AT+QMTOPEN Open a Network Connection for MQTT Client Test Command AT+QMTOPEN=? Response +QMTOPEN: (range of supported s),,(range of supported s) Read Command AT+QMTOPEN? OK Response [+QMTOPEN: ,,] Write Command AT+QMTOPEN=,, OK Response OK +QMTOPEN: , Maximum Response Time Characteristics If there is any error: ERROR Determined by the network / Parameter Integer type. MQTT client identifier. Range: 0–5. String type. Server address. It could be an IP address or a domain name. Maximum size: 128 bytes. Integer type. Server port number. Range: 0–65535. Integer type. Command execution result. -1 Failed to open a network BG770A-GL&BG95xA-GL_MQTT_Application_Note 14 / 31 0 Network opened successfully 1 Wrong parameter 2 MQTT client identifier is occupied 3 Failed to activate PDP 4 Failed to parse domain name 5 Network connection error LPWA Module Series 3.3.3. AT+QMTCLOSE Close a Network Connection for MQTT Client This command closes a network connection for an MQTT client. AT+QMTCLOSE Close a Network Connection for MQTT Client Test Command AT+QMTCLOSE=? Response +QMTCLOSE: (range of supported s) Write Command AT+QMTCLOSE= OK Response OK +QMTCLOSE: , Maximum Response Time Characteristics If there is any error: ERROR Determined by network / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Command execution result. -1 Failed to close the network 0 Network closed successfully 3.3.4. AT+QMTCONN Connect a Client to MQTT Server This command is used when a client requests a connection to the MQTT server. When a TCP/IP socket connection is established between a client and a server, a protocol level session must be created using a CONNECT flow. BG770A-GL&BG95xA-GL_MQTT_Application_Note 15 / 31 LPWA Module Series AT+QMTCONN Connect a Client to MQTT Server Test Command AT+QMTCONN=? Response +QMTCONN: (range of supported s),,, Read Command AT+QMTCONN? OK Response [+QMTCONN: ,] Write Command AT+QMTCONN=,[,[,]] OK Response OK +QMTCONN: ,[,] Maximum Response Time Characteristics If there is any error: ERROR (default 5 s), determined by the network / Parameter Integer type. MQTT client identifier. Range: 0–5. Client identifier string. String type. Client username. It can be used for authentication. String type. The password corresponding to the client username. It can be used for authentication. Integer type. Command execution result. 0 Packet sent successfully and ACK received from the server 1 Packet retransmission 2 Failed to send the packet Integer type. MQTT connection state. 1 MQTT is initializing 2 MQTT is connecting 3 MQTT is connected 4 MQTT is disconnecting Integer type. Connection status return code. 0 Connection Accepted 1 Connection Refused: Unacceptable Protocol Version 2 Connection Refused: Identifier Rejected 3 Connection Refused: Server Unavailable BG770A-GL&BG95xA-GL_MQTT_Application_Note 16 / 31 LPWA Module Series 4 Connection Refused: Bad Username or Password 5 Connection Refused: Not Authorized Integer type. Packet delivery timeout. Range: 1–60. Default value: 5. Unit: second. NOTE 1. If a client with the same Client ID is already connected to the server, the 'older' client must be disconnected by the server before completing the CONNECT flow of the new client. 2. AT+QMTCFG='aliauth' is only used for AliCloud. If it is configured, then and in AT+QMTCONN can be omitted. 3.3.5. AT+QMTDISC Disconnect a Client from MQTT Server This command requests a disconnection from MQTT server by a client. A DISCONNECT message is sent from the client to the server to indicate that it is about to close its TCP/IP connection. AT+QMTDISC Disconnect a Client from MQTT Server Test Command AT+QMTDISC=? Response +QMTDISC: (range of supported s) Write Command AT+QMTDISC= OK Response OK +QMTDISC: , Maximum Response Time Characteristics If there is any error: ERROR Determined by the network / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Command execution result. -1 Failed to close the connection 0 Connection closed successfully BG770A-GL&BG95xA-GL_MQTT_Application_Note 17 / 31 LPWA Module Series NOTE Disconnecting a client closes the socket. 3.3.6. AT+QMTSUB Subscribe to Topics This command subscribes to one or more topics. A SUBSCRIBE message is sent to the server by a client to register interest in one or more topic names. Messages published on these topics are delivered from the server to the client as PUBLISH messages. AT+QMTSUB Subscribe to Topics Test Command AT+QMTSUB=? Response +QMTSUB: (range of supported s),(range of supported s),,(range of supported s) Write Command AT+QMTSUB=,,,[,,…] OK Response OK +QMTSUB: ,,[,] Maximum Response Time Characteristics If there is any error: ERROR × (default 15 s), determined by network The command takes effect immediately. The configurations will not be saved. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of a packet. Range: 1–65535. String type. Topic that the client wants to subscribe to or unsubscribe from. Integer type. QoS level at which the client wants to publish messages. 0 At most once 1 At least once 2 Exactly once Integer type. Command execution result. 0 Packet sent successfully and ACK received from the server 1 Packet retransmission 2 Failed to send a packet If is 0, it is a vector of granted QoS levels. BG770A-GL&BG95xA-GL_MQTT_Application_Note 18 / 31 LPWA Module Series If is 1, it is the number of times the packet has been retransmitted. If is 2, it will not be presented. Integer type. Packet delivery timeout. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. NOTE The is only present in messages where the QoS bits in the fixed header indicate QoS levels 1 or 2. It must be unique among the set of 'inflight' messages in a particular communication direction. It typically increases by 1 from one message to the next. 3.3.7. AT+QMTUNS Unsubscribe from Topics This command unsubscribes from one or more topics. An UNSUBSCRIBE message is sent by the client to the server to unsubscribe from the named topics. AT+QMTUNS Unsubscribe from Topics Test Command AT+QMTUNS=? Response +QMTUNS: (range of supported s),(range of supported s), Write Command AT+QMTUNS=,,[,…] OK Response OK +QMTUNS: ,, Maximum Response Time Characteristics If there is any error: ERROR × (default 15 s), determined by network The command takes effect immediately. The configurations will not be saved. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of a packet. Range: 1–65535. String type. Topic that the client wants to subscribe to or unsubscribe from. Integer type. Command execution result. 0 Packet sent successfully and ACK received from the server BG770A-GL&BG95xA-GL_MQTT_Application_Note 19 / 31 LPWA Module Series 1 Packet retransmission 2 Failed to send a packet Integer type. Packet delivery timeout. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. 3.3.8. AT+QMTPUB Publish Messages (Data Mode) This command publishes messages by a client to a server for distribution to interested subscribers. Each PUBLISH message is associated with a topic name. If a client subscribes to one or more topics, any message published on those topics is sent by the server to the client as a PUBLISH message. AT+QMTPUB Publish Messages (Data Mode) Test Command AT+QMTPUB=? Response +QMTPUB: (range of supported s),(range of supported s),(range of supported s),(list of supported s),,(range of supported s) Write Command Publish variable-length messages AT+QMTPUB=,, ,, OK Response > After > is reported, input the data to be sent. Press Ctrl+Z to send the data, or Esc to cancel the operation. OK +QMTPUB: ,,[,] Write Command Publish fixed-length messages AT+QMTPUB=,, ,,, If there is any error: ERROR Response > After > is responded, input the data to be sent. The number of bytes of input data must equal . OK +QMTPUB: ,,[,] Maximum Response Time If there is any error: ERROR × (default 15 s), determined by the network BG770A-GL&BG95xA-GL_MQTT_Application_Note 20 / 31 LPWA Module Series Characteristics / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of a packet. Range: 0–65535. It will be 0 only when =0. Integer type. QoS level at which the client wants to publish messages. 0 At most once 1 At least once 2 Exactly once Integer type. Determines whether the server will retain the message after it has been delivered to the current subscribers. 0 The server will not retain the message after it has been delivered to the current subscribers 1 The server will retain the message after it has been delivered to the current subscribers String type. Topic that needs to be published. Integer type. Length of the message to be published. Range: 1–4096. Unit: byte. Integer type. Command execution result. 0 Packet sent successfully and ACK received from the server (message that is published when =0 does not require ACK) 1 Packet retransmission 2 Failed to send a packet If is 1, it means the number of times a packet has been retransmitted. If is 0 or 2, it will not be presented. Integer type. Packet delivery timeout. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. NOTE 1. If this command is executed successfully and OK is reported, the client can continue to publish new packets. The maximum quantity of the packet to be transmitted should not be greater than that of inflight windows (5). 2. After executing this command, the client will be ready to send data as a payload. The maximum length of data input at a time is 4096 bytes. To send the data, remember to press Ctrl+Z. 3. PUBLISH messages can be sent either from a publisher to the server, or from the server to a subscriber. When a server publishes messages to a subscriber, the following URC will be returned to notify the host to read the received data reported by the MQTT server: +QMTRECV: ,,[,], For more information on the URC description, see Chapter 4.2. BG770A-GL&BG95xA-GL_MQTT_Application_Note 21 / 31 LPWA Module Series 3.3.9. AT+QMTPUBEX Publish Messages (Command Mode) This command publishes messages. It provides the same functions as AT+QMTPUB, except that the format is different. AT+QMTPUBEX Publish Messages (Command Mode) Test Command AT+QMTPUBEX=? Response +QMTPUBEX: (range of supported s),( range of supported s),(range of supported s),(list of supported s),, Write Command AT+QMTPUBEX=,,,,, Maximum Response Time Characteristics OK Response OK +QMTPUB: ,,[,] If there is any error: ERROR × (default 15 s), determined by the network / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of a packet. Range: 0–65535. It will be 0 only when =0. Integer type. QoS level at which the client wants to publish messages. 0 At most once 1 At least once 2 Exactly once Integer type. Determines whether the server will retain the message after it has been delivered to the current subscribers. 0 The server will not retain the message after it has been delivered to the current subscribers 1 The server will retain the message after it has been delivered to the current subscribers String type. Topic that needs to be published. String type. Message to be published. Maximum length: 560 bytes. Integer type. Command execution result. 0 Packet sent successfully and ACK received from the server (message that is published when =0 does not require ACK) 1 Packet retransmission BG770A-GL&BG95xA-GL_MQTT_Application_Note 22 / 31 LPWA Module Series 2 Failed to send a packet If is 1, it means the number of times a packet has been retransmitted. If is 0 or 2, it will not be presented. Integer type. Packet delivery timeout. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. NOTE The response flow of AT+QMTPUBEX will be the same as the response flow of AT+QMTPUB. 3.3.10. AT+QMTRECV Read Messages from Buffer This command reads messages from the storage buffer where the messages are stored after being reported by the server. AT+QMTRECV Read Messages from Buffer Test Command AT+QMTRECV=? Read Command AT+QMTRECV? Response OK Response +QMTRECV: ,,,,, OK Write Command AT+QMTRECV=[,] If there is no MQTT connection: OK Response List of (+QMTRECV: ,,,[,])s OK If no message has been received: OK Maximum Response Time If there is no MQTT connection: ERROR Determined by the network. BG770A-GL&BG95xA-GL_MQTT_Application_Note 23 / 31 LPWA Module Series Characteristics / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Indicates if a message is stored in the buffer. As there can be maximum 5 messages in a buffer, the URC can report at most 5 messages simultaneously. 0 No stored messages 1 There are stored messages (up to 5) Integer type. Serial number of a received message. Range: 0–4. All buffer data will be read if this parameter is not specified. Integer type. Message identifier of the packet. Range: 0–65535. It will be 0 only when =0. String type. Topic that needs to be published. Integer type. Payload length. Unit: Byte. String type. Payload relating to topic name. BG770A-GL&BG95xA-GL_MQTT_Application_Note 24 / 31 LPWA Module Series 4 MQTT URCs This chapter describes the MQTT URCs. 4.1. +QMTSTAT: URC to Indicate State Change in MQTT Link Layer The URC that begins with +QMTSTAT will be reported when the state of an MQTT link layer is changed. +QMTSTAT: URC to Indicate State Change in MQTT Link Layer When the state of an MQTT link layer is changed, the client +QMTSTAT: , will close the MQTT connection and report the URC. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Error code. Refer to the table below for more information. Table 1: Error Codes of +QMTSTAT: URC 1 2 3 4 Description Solution Connection is closed or reset by a peer. Sending PINGREQ packet timed out or failed. Sending CONNECT packet timed out or failed. Receiving CONNACK packet timed out or failed. Execute AT+QMTOPEN command to reopen the MQTT connection. First, deactivate and activate the PDP. Then, reopen the MQTT connection. 1. Check whether the inputted username and password are correct. 2. Make sure the client ID is not used. 3. Reopen the MQTT connection and try to send CONNECT packet to the server again. 1. Check whether the inputted username and password are correct. 2. Make sure the client ID is not used. 3. Reopen the MQTT connection and try to send CONNECT packet to the server again. BG770A-GL&BG95xA-GL_MQTT_Application_Note 25 / 31 5 6 7 8–255 LPWA Module Series The client sends DISCONNECT packet to the sever and the server starts closing the MQTT connection. The client takes the initiative to close the MQTT connection due to constant packet sending failure. The link is not alive, or the server is unavailable. This is a normal process. 1. Make sure that the data are correct. 2. Try to reopen the MQTT connection since there may be a network congestion or an error. Make sure that the link is alive, or the server is currently available. Reserved for future uses. NOTE Error codes 5, 6 and 7 are currently not supported. 4.2. +QMTRECV: URC to Inform the Host to Read MQTT Packet Data The URC that begins with +QMTRECV: is mainly used to inform the host to read the received MQTT packet reported from the MQTT server. +QMTRECV: URC to Inform the Host to Read MQTT Packet Data +QMTRECV: ,,< topic>[,], +QMTRECV: ,[,] Notify the host to read the received data reported from the MQTT server. Notify that the message received from the MQTT server has been stored in a buffer. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of the packet. String type. Topic that has been received from the MQTT server. Integer type. Payload length. Unit: byte. String type. Payload relating to topic name. Integer type. Serial number of a received message. Range: 0–4. BG770A-GL&BG95xA-GL_MQTT_Application_Note 26 / 31 LPWA Module Series 5 Examples This chapter provides some examples that explain how to use the MQTT AT commands. 5.1. Example of MQTT Operation without SSL AT+QMTCFG='aliauth',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAazZ' //Configure Alibaba device information for AliCloud. OK AT+QMTOPEN=? +QMTOPEN: (0-5),,(0-65535) OK AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 //Open a network for MQTT client. OK +QMTOPEN: 0,0 //The MQTT client network opened successfully. AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK AT+QMTCONN=? +QMTCONN: (0-5),,, OK //Connect a client to the MQTT server. //If AliCloud is connected, AT+QMTCFG='aliauth' can be used to configure the device information in advance. There is no need to provide the username/password from now on. AT+QMTCONN=0,'clientExample' OK +QMTCONN: 0,0,0 //The client has successfully connected to the MQTT server. AT+QMTSUB=? +QMTSUB: (0-5),(1-65535),,(0-2) BG770A-GL&BG95xA-GL_MQTT_Application_Note 27 / 31 LPWA Module Series OK //Subscribe to topics. AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //If a client subscribed to a topic and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,0,'topic/example','This is the payload related to topic' //Unsubscribe from topics. AT+QMTUNS=0,1,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB : (0-5),(0-65535),(0-2),(0,1),,(1-4096) OK //Publish messages. AT+QMTPUB=0,0,0,0,'topic/pub' >These are test data, hello MQTT. OK //After receiving >, input data These are test data, hello MQTT. and then send it. The maximum length of the data to be sent is 4096 bytes. All the data beyond 4096 bytes will be omitted. After inputting data, press Ctrl+Z to send them. +QMTPUB: 0,0,0 //If a client subscribed to a topic named 'topic/pub' and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,0,'topic/pub','These are test data, hello MQTT.' AT+QMTDISC=0 //Disconnect a client from the MQTT server. OK +QMTDISC: 0,0 //The connection closed successfully. BG770A-GL&BG95xA-GL_MQTT_Application_Note 28 / 31 LPWA Module Series 5.2. Example of MQTT Operation with SSL //Configure the MQTT session into SSL mode. AT+QMTCFG='ssl',0,1,2 OK //If SSL authentication mode is intended to be set as 'manage server and client authentication if requested by the remote server' (=2 in AT+QSSLCFG), upload a server root CA certificate, a client certificate, and a client private key to UFS. AT+QFUPL='cacert.pem',1758,100 //Upload a CA certificate to UFS. CONNECT +QFUPL: 1758,384a OK AT+QFUPL='client.pem',1220,100 //Upload a client certificate to UFS. CONNECT +QFUPL: 1220,2d53 OK AT+QFUPL='user_key.pem',1679,100 //Upload a client private key to UFS. CONNECT +QFUPL: 1679,335f OK //Configure the path of the CA certificate for SSL context 2. AT+QSSLCFG='cacert',2,'cacert.pem' OK //Configure the path of the client certificate for SSL context 2. AT+QSSLCFG='clientcert',2,'client.pem' OK //Configure the path of the client private key for SSL context 2. AT+QSSLCFG='clientkey',2,'user_key.pem' OK //Configure the authentication mode for SSL context 2. AT+QSSLCFG='seclevel',2,2 //SSL authentication mode: server and client authentication if requested by the remote server. BG770A-GL&BG95xA-GL_MQTT_Application_Note 29 / 31 LPWA Module Series OK AT+QSSLCFG='sslversion',2,4 OK AT+QSSLCFG='ciphersuite',2,0XFFFF OK AT+QSSLCFG='ignorelocaltime',2,1 OK //SSL authentication version //Cipher suite //Ignore the authentication time. //Start the MQTT SSL connection. AT+QMTOPEN=0,'a1zgnxur10j8ux.iot.us-east-1.amazonaws.com',8883 OK +QMTOPEN: 0,0 //Connect to the MQTT server. AT+QMTCONN=0,'MQTT-1' OK +QMTCONN: 0,0,0 //Subscribe to topics. AT+QMTSUB=0,1,'$aws/things/ MQTT-1/shadow/update/accepted',1 OK +QMTSUB: 0,1,0,1 //Publish messages. AT+QMTPUB=0,1,1,0,'$aws/things/MQTT-1/shadow/update/accepted' >These are published data from client OK +QMTPUB: 0,1,0 //If a client subscribed to a topic named '$aws/things/MQTT-1/shadow/update/accepted' and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,1,'$aws/things/MQTT-1/shadow/update/accepted','These are published data from client' //Disconnect a client from the MQTT server. AT+QMTDISC=0 OK +QMTDISC: 0,0 BG770A-GL&BG95xA-GL_MQTT_Application_Note 30 / 31 LPWA Module Series 6 Appendix References Table 2: Related Documents Document Name [1] MQTT V3.1 Protocol Specification [2] MQTT V3.1.1 Protocol Specification [3] Quectel_BG770A-GL&BG95×A-GL_SSL_Application_Note Table 3: Terms and Abbreviations Abbreviation ACK CA IP MQTT PDP QoS SSL TCP UFS URC Description Acknowledgement Certificate Authority Internet Protocol Message Queuing Telemetry Transport Packet Data Protocol Quality of Service Secure Sockets Layer Transmission Control Protocol User File System Unsolicited Result Code BG770A-GL&BG95xA-GL_MQTT_Application_Note 31 / 31

EG060V-EA Log 抓取指导 LTE-A 模块系列 版本：1.0 日期：2021-12-21 状态：受控文件 EG060V-EA Log 抓取指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 邮编：200233 电话：+86 21 5108 6236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同 时，您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分 析、评估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同 意，尽管移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在 '可用'基础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文 档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行 为，移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的 使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 26 EG060V-EA Log 抓取指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问 性、安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 2 / 26 EG060V-EA Log 抓取指导 文档历史 修订记录 版本 日期 作者 - 2021-06-10 Paddy LI 1.0 2021-12-21 Paddy LI 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 3 / 26 EG060V-EA Log 抓取指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 2 在 Windows 下抓取 Log 和 Dump 文件 ............................................................................................... 8 2.1. 抓取 Log ...................................................................................................................................... 8 2.1.1. 通过串口工具抓取 AP 侧 Log ........................................................................................... 8 2.1.2. 通过 CATStudio 工具抓取 CP 侧 Log ............................................................................... 9 2.2. 抓取 Dump 文件 ........................................................................................................................ 15 3 在 Linux 环境下抓取 Log 和 Dump 文件 ............................................................................................ 16 3.1. 抓取 Log .................................................................................................................................... 16 3.1.1. 通过串口工具抓取 AP 侧 Log ......................................................................................... 16 3.1.2. 通过 QLog 工具抓取 CP 侧 Log（Log 保存在 Linux 环境）........................................... 16 3.1.3. 通过 QLog 工具抓取 CP 侧 Log（Log 保存在 Windows 环境）..................................... 18 3.2. 抓取 Dump 文件 ........................................................................................................................ 19 4 Dump 模式相关 AT 命令...................................................................................................................... 21 4.1. AT 命令说明............................................................................................................................... 21 4.1.1. 定义 ................................................................................................................................ 21 4.1.2. AT 命令语句.................................................................................................................... 21 4.2. AT 命令详解............................................................................................................................... 22 4.2.1. AT+QCFG='aprstlevel' 设置 AP Dump 等级 ................................................................ 22 4.2.2. AT+QCFG='modemrstlevel' 设置 CP Dump 等级 ........................................................ 22 5 网络状态查询相关 AT 命令 .................................................................................................................. 24 6 附录 参考文档及术语缩写 .................................................................................................................... 25 上海移远通信技术股份有限公司 4 / 26 EG060V-EA Log 抓取指导 表格索引 表 1：AT 命令类型 ............................................................................................................................................. 21 表 2：参考文档 .................................................................................................................................................. 25 表 3：术语缩写 .................................................................................................................................................. 25 上海移远通信技术股份有限公司 5 / 26 EG060V-EA Log 抓取指导 图片索引 图 1：模块开机 Log ............................................................................................................................................. 8 图 2：CATStudio 选择模式界面 ........................................................................................................................... 9 图 3：CATStudio 主界面 .................................................................................................................................... 10 图 4：Communication Settings 界面 ................................................................................................................. 10 图 5：Logger 操作界面 .......................................................................................................................................11 图 6：Database 选择界面 .................................................................................................................................. 12 图 7：Database 匹配成功后 Logger 界面 .......................................................................................................... 12 图 8：CATStudio 主界面工具栏 ......................................................................................................................... 13 图 9：LogViewer 界面........................................................................................................................................ 13 图 10：状态栏选择导出 Log File 界面................................................................................................................ 14 图 11：ExportLog 导出 Log File 路径选择界面 .................................................................................................. 14 图 12：模块发生 AP Dump 时导出的 Dump 文件 .............................................................................................. 15 图 13：模块发生 CP Dump 时导出的 Dump 文件.............................................................................................. 15 图 14：加载的模块端口 ..................................................................................................................................... 16 图 15：Linux 端抓取 CP 侧 Log ......................................................................................................................... 17 图 16：Linux 端查看 CP 侧 Log 文件 ................................................................................................................. 17 图 17：Socket 端口选择界面 ............................................................................................................................. 18 图 18：Linux 环境抓取 Dump 文件连接方式...................................................................................................... 19 图 19：Windows PC 的网卡设置方式 ................................................................................................................ 19 图 20：执行 rdp_transfer 后抓取 Log 成功的打印信息 ...................................................................................... 20 上海移远通信技术股份有限公司 6 / 26 EG060V-EA Log 抓取指导 1 引言 本文档主要介绍如何通过 QLog、rdp_transfer、CATStudio 以及 TFTPD32 工具抓取移远通信 LTE-A EG060V-EA 模块中 AP 侧和 CP 侧 log 文件以及 dump 文件。 模块出现异常情况时，需要首先通过 AT 命令查看模块当前的网络状态（详见第 5 章），再根据查询结 果初步判断问题原因。若判断模块配置有误，可通过相应 AT 命令重新配置以解决问题；若无法判断或解 决，则需收集对应的日志信息提交至移远通信进一步分析处理。 备注 1. QLog 工具为移远通信开发的 log 抓取工具，如需使用，请联系移远通信技术支持获取安装包。 2. rdp_transfer 工具和 CATStudio 工具可联系移远通信技术支持协助安装。 3. TFTPD32 工具可从官方下载网站自行获取：https://bitbucket.org/phjounin/tftpd64/downloads/。 上海移远通信技术股份有限公司 7 / 26 EG060V-EA Log 抓取指导 2 在 Windows 下抓取 Log 和 Dump 文件 2.1. 抓取 Log 2.1.1. 通过串口工具抓取 AP 侧 Log 步骤 1： 通过串口线将模块的调试串口与上位机连接，在上位机打开任意串口工具，选择设备管理器 端口中弹出的 COM 口，将波特率设置为 115200 bps，关闭流控，将模块上电开机，即可在 串口工具中显示开机 log。 图 1：模块开机 Log 上海移远通信技术股份有限公司 8 / 26 EG060V-EA Log 抓取指导 步骤 2： 点击键盘上的'Enter'键，在弹出的'OpenWrt login:'界面中输入用户名'root'及密码 'admin'登录模块 Linux 系统。AP 侧 log 主要包括 kernel log 和 QLog 接口的 API log，在 调试串口通过串口工具输入 echo 1 > /sys/module/printk/parameters/kernel_log_output 可打印 kernel log；在调试串口通过串口工具输入 logcat -b radio 可打印 QLog 接口的 API log。 2.1.2. 通过 CATStudio 工具抓取 CP 侧 Log 在 Windows 环境下，通过 USB 枚举出的 Diag 端口抓取模块的 CP 侧 log。 步骤1： 在上位机打开 CATStudio，选择'在线解析日志'，再点击'OK'。 图 2：CATStudio 选择模式界面 步骤2： 在打开后的 CATStudio 主界面右下角选择'Device Communication'，在'Device Communication'界面选择'Device0'对应的'Settings'，在'Communication Settings'界面选择'Quectel USB DIAG Port'并设置波特率为 115200 bps，再点击 'OK'。 上海移远通信技术股份有限公司 9 / 26 EG060V-EA Log 抓取指导 图 3：CATStudio 主界面 图 4：Communication Settings 界面 上海移远通信技术股份有限公司 10 / 26 EG060V-EA Log 抓取指导 步骤3： 继 续 选 择 主 界 面 的 ' Logger ' 选 项 卡 ， 点 击 ' CpLogStart ' ， 此 时 按 钮 变 为 'CpLogStop'，在下方的'Database'中点击'Update'按钮，进入'Database'选择 界面。 图 5：Logger 操作界面 步骤4： 在'Database'选择界面下，在'Communication'中选择'Text'，在'Text file'中选择 LWG_MDB.txt ， 在 ' Application ' 中 选 择 ' Text '， 在 ' Text file ' 中 选 择 Boerne_DIAG.mdb.txt；然后点击下方的'UpdateAll'。更新完成后，关闭'Database' 选择界面，返回'Logger'界面，此时亮起两个绿灯。 上海移远通信技术股份有限公司 11 / 26 EG060V-EA Log 抓取指导 图 6：Database 选择界面 图 7：Database 匹配成功后 Logger 界面 上海移远通信技术股份有限公司 12 / 26 EG060V-EA Log 抓取指导 步骤5： 选择主界面工具栏中的'Modules'，点击'LogViewer'，打开 log 抓取界面。 图 8：CATStudio 主界面工具栏 图 9：LogViewer 界面 上海移远通信技术股份有限公司 13 / 26 EG060V-EA Log 抓取指导 步骤6： 复现问题后，选择主界面工具栏中的'Log'，选中下拉框中的'Export Log-File…'；在 弹出的'ExportLog'窗口中，自定义 log 文件保存的路径；将需要导出的 log 文件重命名 后，点击'Output(O)'按钮导出 log 文件。 图 10：工具栏导出 Log File 界面 图 11：ExportLog 导出 Log File 路径选择界面 备注 LWG_MDB.txt 与 Boerne_DIAG.mdb.txt 是 database 文件，请联系移远通信技术支持获取。 上海移远通信技术股份有限公司 14 / 26 EG060V-EA Log 抓取指导 2.2. 抓取 Dump 文件 Windows 系统下，模块发生 dump 后的 dump 文件可以通过 Windows 下的 TFTPD32 工具导出，供 移远通信分析。 步骤 1: 首先必须将模块配置 为 dump 模式，配置方式为：执 行 AT+QCFG='aprstlevel',0 和 AT+QCFG='modemrstlevel',0，均返回 OK 后重启模块使命令生效。有关上述命令的详细 信息，请参考第 4.2 章。 步骤 2: Windows 打开 TFTPD32 软件，模块发生 dump 后自动重启，并自动执行 rdp_transfer app。执行完成后，TFTPD32 工具自动导出 dump 文件。 ⚫ 如果模块发生 AP 侧 dump，则 TFTPD32 导出的 dump 文件为一个压缩包以及一个 txt 文件。txt 文件简单描述本次 dump 的发生位置，可用于更清晰地描述问题。 图 12：模块发生 AP Dump 时导出的 Dump 文件 ⚫ 如果模块发生 CP 侧 dump，则 TFTPD32 导出的 dump 文件包含两个 bin 文件和一个压 缩包。 图 13：模块发生 CP Dump 时导出的 Dump 文件 上海移远通信技术股份有限公司 15 / 26 EG060V-EA Log 抓取指导 3 在 Linux 环境下抓取 Log 和 Dump 文件 3.1. 抓取 Log 3.1.1. 通过串口工具抓取 AP 侧 Log Linux 环境下 AP 侧 log 抓取步骤和 Windows 环境下相同，详见第 2.1.1 章。 3.1.2. 通过 QLog 工具抓取 CP 侧 Log（Log 保存在 Linux 环境） 步骤 1: 安装 Linux 端 USB 驱动，可联系移远技术支持获取驱动安装方法。 步骤 2: 在 QLog 工具的根目录下打开 Linux 终端窗口，执行 make 会在 QLog 目录下生成一个名为 Qlog 的可执行文件。在 Linux 终端窗口执行 dmesg -w 列出模块端口。若确定模块已经连 接，却无端口显示，可能是 USB 驱动未安装成功，可重新安装 Linux USB 驱动；若模块端 口加载成功，此时可启动 QLog 工具开始抓取 Log。端口加载成功会打印如下图所示的信 息： 图 14：加载的模块端口 上海移远通信技术股份有限公司 16 / 26 EG060V-EA Log 抓取指导 步骤 3: 在 Linux 终端窗口执行./QLog –s log 打开 QLog 工具开始抓取 log。抓取完成后，点击 'Ctrl'+'C'可结束 QLog 进程。 图 15：Linux 端抓取 CP 侧 Log 步骤 4: 查看对应的 log 文件。可将 log 文件保存并发至移远通信技术支持进一步分析。以查看 log 文 件 20210304_105630_0000.logel 为例，示例如下： 图 16：Linux 端查看 CP 侧 Log 上海移远通信技术股份有限公司 17 / 26 EG060V-EA Log 抓取指导 3.1.3. 通过 QLog 工具抓取 CP 侧 Log（Log 保存在 Windows 环境） 步骤 1: 用户的 Linux CPE 主板通过 LAN 口与 Windows PC 连接，需要在 Windows PC 为相应网口 配置静态地址。例如，若 CPE 主板的 bridge 地址为 192.168.1.x，则给 PC 对应网口配置同 一网段地址，保证 PC 可以 ping 通 CPE 主板的 bridge 地址即可。 步骤 2: 在 Linux CPE 主板中运行 QLog 工具，并在 Linux CPE 主板终端窗口执行-s port 将 log 通 过 TCP port 导出。例如./Qlog -s 9000 代表在端口 9000 创建 TCP 服务。在 Windows 侧打 开 CATStudio ， 在 ' Communication Settings ' 界 面 选 择 ' Socket '， 选 择 ' TCP Client'，在右边的方框中填写好 Linux CPE 主板中的 bridge 地址以及指定的 log 抓取端 口，点击'OK'后即可在'LogViewer'界面查看 log 抓取。 图 17：Socket 端口选择界面 可将该 log 文件保存并发送至移远通信技术支持进行进一步分析，保存步骤可参考第 2.1.2 章的步骤 6。 上海移远通信技术股份有限公司 18 / 26 EG060V-EA Log 抓取指导 3.2. 抓取 Dump 文件 Linux 环境下可通过 rdp_transfer 工具抓取 dump 文件。首先必须将模块配置为 dump 模式，配置方式 为：执行 AT+QCFG='aprstlevel',0 及 AT+QCFG='modemrstlevel',0，均返回 OK 后重启模块。有关 上述命令的详细信息，请参考第 4.2 章。 Linux 系统下，当模块 dump 时需要通过 Windows PC 的 LAN 口将 dump 文件导出。 TFTPD32 PC (Windows) LAN 192.168.0.x rdp_transfer Linux 192.168.0.x USB EG060V-EA 图 18：Linux 环境抓取 Dump 文件连接方式 Linux 环境抓取 dump 文件的操作如下： 步骤 1: Windows PC 打开网络管理配置，为连接 Linux 设备的 LAN 口网络设置一个私网 IP 地址， 例如：192.168.0.10。 图 19：Windows PC 网卡设置方式 上海移远通信技术股份有限公司 19 / 26 EG060V-EA Log 抓取指导 步骤 2: Linux 设备（客户 Linux 设备或者 Ubuntu）使用配置文件设置静态地址（静态地址需要以用 户名'root'、密码'admin'登录模块 Linux 系统获取 root 权限后才能修改）。 1) 修改/etc/network/路径下的 interfaces 配置文件，示例如下： # interfaces(5) file used by ifup(8) and ifdown(8) auto lo iface lo inet loopback auto eth0 iface eth0 inet static address 192.168.0.3 netmask 255.255.255.0 gateway 192.168.0.1 2) 修改/etc/resolvconf/resolv.conf.d/下的 base 配置文件，示例如下： nameserver 10.0.0.1 nameserver 192.168.0.1 重启设备后使用 ifconfig 查看 eth0 网口是否配置成功，并在 Linux 设备和 Windows 设备上 使用 ping 命令确保两个设备的连通性。 步骤 3: 测试模块功能复现 dump 问题。首先在上位机通过 rdp_transfer 源码编译出 rdp_transfer 二 进制可执行程序；模块 dump 后自动重启，通过上位机设备的 rdp_transfer 进程，使用 root 权限执行 sudo ./rdp_transfer ，将模块的 ramdump 文件通过 LAN 口转 发到对端的 Windows PC 上，并通过 Windows PC 的 TFTPD32 工具将 log 导出到本地。 图 20：执行 rdp_transfer 后抓取 Log 成功的打印信息 上海移远通信技术股份有限公司 20 / 26 EG060V-EA Log 抓取指导 4 Dump 模式相关 AT 命令 4.1. AT 命令说明 4.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说 明，配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 4.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 21 / 26 EG060V-EA Log 抓取指导 4.2. AT 命令详解 4.2.1. AT+QCFG='aprstlevel' 设置 AP Dump 等级 该命令用于查询或设置 AP 侧 dump 等级。 AT+QCFG='aprstlevel' 设置 AP Dump 等级 设置命令 AT+QCFG='aprstlevel'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'aprstlevel', 最大响应时间 特性说明 OK 若指定可选参数，则设置 AP 侧 dump 等级： OK 若有任何错误： ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。AP 侧 dump 等级。 0 打开 AP dump，AP 侧发生 dump 时模块重启并进入 dump 模式 1 关闭 AP dump，AP 侧发生 dump 时仅模块重启 4.2.2. AT+QCFG='modemrstlevel' 设置 CP Dump 等级 该命令用于查询或设置 CP 侧（即 modem）dump 等级。 AT+QCFG='modemrstlevel' 设置 CP Dump 等级 设置命令 AT+QCFG='modemrstlevel'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'modemrstlevel', OK 若指定可选参数，则设置 CP 侧 dump 等级： OK 上海移远通信技术股份有限公司 22 / 26 EG060V-EA Log 抓取指导 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令重启生效； 参数配置自动保存。 参数 整型。CP 侧 dump 等级。 0 打开 CP dump，CP 侧发生 dump 时模块重启 1 关闭 CP dump，CP 侧发生 dump 时仅 CP 重启 备注 如 需 AP 或 CP 发 生 dump 时 模 块 都 能 进 入 dump 模 式 ， 则 AT+QCFG='aprstlevel',0 和 AT+QCFG='modemrstlevel',0 均需设置成功且重启模块使命令生效。 上海移远通信技术股份有限公司 23 / 26 EG060V-EA Log 抓取指导 5 网络状态查询相关 AT 命令 查看模块网络状态的 AT 命令如下： 1. AT+CFUN?查询模块功能模式 2. AT+CPIN?查询 SIM 卡的状态 3. AT+CEREG?查询 EPS 网络注册状态 4. AT+COPS?查询网络状态 5. AT+QENG='servingcell'查询服务小区信息 6. AT+ZGDCONT?查询 PDP 配置 7. AT+ZGPADDR 查询 PDP 地址 8. AT+ZGACT?查询 PDP 激活状态 备注 有关上述命令的详细信息，请参考文档 [1]。 上海移远通信技术股份有限公司 24 / 26 EG060V-EA Log 抓取指导 6 附录 参考文档及术语缩写 表 2：参考文档 序号 [1] Quectel_EG060V-EA_AT_Commands_Manual 表 3：术语缩写 缩写 AP API CP CPE ECM EPS IP LAN PC PDP PIN RNDIS SIM TA TCP 英文全称 中文全称 Application Processor 应用程序处理器 Application Programming Interface 应用程序编程接口 Central Processor 中央处理器 Customer-Premise Equipment 用户驻地设备 Ethernet Control Model 以太网控制模型 Evolved Packet System 演进型分组系统 Internet Protocol 网际互连协议 Local Area Network 局域网 Personal Computer 个人电脑 Packet Data Protocol 分组数据协议 Personal Identification Number 个人识别号 Remote Network Driver Interface Specification 远程网络驱动接口规范 Subscriber Identity Module 用户身份识别模块 Terminal Adapter 终端适配器 Transmission Control Protocol 传输控制协议 上海移远通信技术股份有限公司 25 / 26 TFTP UART USB EG060V-EA Log 抓取指导 Trivial File Transfer Protocol 简单文件传输协议 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Universal Serial Bus 通用串行总线 上海移远通信技术股份有限公司 26 / 26

Lx0&Lx6&LC86L&LG77L AGNSS Application Note GNSS Module Series Version: 1.2 Date: 2022-05-09 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 1 / 47 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 2 / 47 GNSS Module Series About the Document Document Information Title Lx0&Lx6&LC86L&LG77L AGNSS Application Note Subtitle GNSS Module Series Document Type Application Note Document Status Released Revision History Version 1.0 Date 2017-04-28 2017-04-28 1.1 2021-11-22 1.2 2022-05-09 Description Creation of the document First official release 1. Modified the structure of the document. 2. Added information on Host EPO including the difference between Host EPO and Flash EPO, AGNSS implementation with Host EPO and relevant example, and Host EPO testing with QGNSS. 3. Added applicable modules (L26, L76, L76-L, L86, L96, L26-LB, L76-LB, L70, L80, L70-R, L80-R, LC86L and LG77L). 4. Added AGNSS requirements (Chapter 1.3). 5. Added the structure of Binary Protocol (Figure 5). 6. Added the description of Binary Protocol fields (Table 6). 7. Added AGNSS procedure with Flash EPO and description of the procedure (Chapter 3.1.3). 8. Added the following messages PMTK127, PMTK713, PMTK721, PMTK740 and PMTK741 (Chapter 4). 9. Added the content of Flash EPO testing with QGNSS (Chapter 5.1). 10. Added the example on Flash EPO implementation (Chapter 6.1). 11. Deleted the description of error handing in data transfer procedure. 1. Added a note for MTK_BIN_ACK_EPO (Chapter 3.1.1.1). Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 3 / 47 GNSS Module Series 2. Modified the description of Result in MTK_BIN_EPO (Table 13). 3. Added optional extended parameters for PMTK_ACK (Chapter 4.1). Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 4 / 47 GNSS Module Series Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 5 Table Index................................................................................................................................................... 7 Figure Index ................................................................................................................................................. 8 1 Introduction .......................................................................................................................................... 9 1.1. Differences Between Host EPO and Flash EPO....................................................................... 9 1.2. Applicable Modules ................................................................................................................. 10 1.3. AGNSS Requirements............................................................................................................. 11 2 Download of EPO Files...................................................................................................................... 12 2.1. Get EPO Files from Server...................................................................................................... 12 2.2. EPO Files Format .................................................................................................................... 13 2.2.1. EPO Files Format – GPS Only ...................................................................................... 13 2.2.2. EPO Files Format – GPS + GLONASS ......................................................................... 14 2.3. Types of EPO Files .................................................................................................................. 15 2.4. Recommended Download Procedures of EPO Files .............................................................. 16 2.5. The Validity Period of EPO Files ............................................................................................. 16 3 AGNSS Implementation..................................................................................................................... 18 3.1. AGNSS with Flash EPO .......................................................................................................... 18 3.1.1. Binary Protocol ............................................................................................................... 18 3.1.1.1. MTK_BIN_EPO (MsgID = 723)............................................................................... 19 3.1.1.2. MTK_BIN_ACK_EPO (Msg = 2) ............................................................................. 20 3.1.1.3. Change UART Format Packet (MsgID = 253) ........................................................ 21 3.1.1.4. ACK Packet (MsgID = 1)......................................................................................... 22 3.1.2. EPO Data Transfer Protocol .......................................................................................... 23 3.1.2.1. Pseudo Code for EPO Data Transfer Protocol ....................................................... 23 3.1.3. AGNSS Procedure with Flash EPO ............................................................................... 26 3.2. AGNSS with Host EPO............................................................................................................ 27 3.2.1. Recommended Sequence for Host EPO ....................................................................... 27 3.2.2. Sample Code of Sending EPO ...................................................................................... 28 4 AGNSS Related Messages ................................................................................................................ 31 4.1. PMTK001 PMTK_ACK ............................................................................................................ 31 4.2. PMTK127 PMTK_CMD_CLEAR_EPO.................................................................................... 31 4.3. PMTK253 PMTK_SET_OUTPUT_FMT .................................................................................. 32 4.4. PMTK607 PMTK_Q_EPO_INFO ............................................................................................ 33 4.5. PMTK707 PMTK_DT_EPO_INFO .......................................................................................... 34 4.6. PMTK713 PMTK_DT_LOC ..................................................................................................... 35 4.7. PMTK721 PMTK_DT_SV_EPO .............................................................................................. 36 4.8. PMTK740 PMTK_DT_UTC ..................................................................................................... 37 4.9. PMTK741 PMTK_DT_POS ..................................................................................................... 37 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 5 / 47 GNSS Module Series 5 EPO Usage Through QGNSS ............................................................................................................ 39 5.1. Testing Flash EPO with QGNSS ............................................................................................. 39 5.2. Testing Host EPO with QGNSS............................................................................................... 41 6 AGNSS Implementation Example..................................................................................................... 43 6.1. Flash EPO Implementation...................................................................................................... 43 6.2. Host EPO Implementation ....................................................................................................... 44 7 Appendix References ........................................................................................................................ 47 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 6 / 47 GNSS Module Series Table Index Table 1: Differences Between Flash EPO and Host EPO ........................................................................... 9 Table 2: Type of EPO Supported on Applicable Modules .......................................................................... 10 Table 3: AGNSS Related Commands .........................................................................................................11 Table 4: Download URL of EPO Files ........................................................................................................ 12 Table 5: Types of EPO Files ....................................................................................................................... 15 Table 6: Description of Binary Protocol Fields ........................................................................................... 19 Table 7: MTK_BIN_EPO Format ................................................................................................................ 19 Table 8: Format for MTK_BIN_EPO with 2 SAT Data................................................................................ 20 Table 9: Format for MTK_BIN_EPO with 1 SAT Data................................................................................ 20 Table 10: Format for MTK_BIN_EPO with No SAT Data ........................................................................... 20 Table 11: Description of MTK_BIN_EPO Fields......................................................................................... 20 Table 12: MTK_BIN_ACK_EPO Format .................................................................................................... 21 Table 13: Description of MTK_BIN_ACK_EPO Fields ............................................................................... 21 Table 14: Format for Change UART Format Packet.................................................................................. 21 Table 15: Description of Change UART Format Packet Fields.................................................................. 22 Table 16: ACK Packet Format .................................................................................................................... 22 Table 17: Description of ACK Packet Fields .............................................................................................. 23 Table 18: Almanac, Ephemeris and EPO................................................................................................... 47 Table 19: Terms and Abbreviations ............................................................................................................ 47 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 7 / 47 GNSS Module Series Figure Index Figure 1: EPO Files Format – GPS Only ................................................................................................... 13 Figure 2: Format for Several Segments of EPO Files ............................................................................... 14 Figure 3: EPO Files Format – GPS + GLONASS ...................................................................................... 14 Figure 4: Recommended Download Procedures of EPO Files ................................................................. 16 Figure 5: Structure of Binary Protocol........................................................................................................ 18 Figure 6: AGNSS Procedure with Flash EPO ............................................................................................ 26 Figure 7: Recommended Sequence for Host EPO.................................................................................... 28 Figure 8: AGNSS Setting Interface of QGNSS .......................................................................................... 39 Figure 9: EPO File Downloading................................................................................................................ 40 Figure 10: Static TTFF Testing ................................................................................................................... 40 Figure 11: TTFF Setting ............................................................................................................................. 41 Figure 12: Static TTFF Testing ................................................................................................................... 41 Figure 13: TTFF Setting ............................................................................................................................. 42 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 8 / 47 GNSS Module Series 1 Introduction EPOTM (Extended Prediction Orbit) is an AGNSS feature provided by the chipset supplier, which can improve sensitivity and shorten TTFF. This document mainly describes the download of EPOTM files, AGNSS implementation, EPOTM related PMTK commands and how to evaluate the EPOTM functionality through QGNSS tool. 1.1. Differences Between Host EPO and Flash EPO Both Flash EPO and Host EPO allow the GNSS receiver to achieve a shorter TTFF, but their differences make each of them suitable for different applications. Host EPO (also called Real Time AGNSS) allows the receiver to store in RAM up to 6 hours of assistance data which are sent to the receiver through NMEA PMTK commands listed in Chapter 4. For Host EPO, there is no data retention after the GNSS receiver reboots and the data should be re-downloaded. Flash EPO, on the other hand, allows the receiver to store in flash 7 or 14 days’ assistance data which are sent to the receiver through Binary Protocol defined by the chipset supplier. Flash EPO enables the receiver to reuse all assistance information stored in flash before the information expires. See Chapter 2.5 for the validity period of EPO files. Table 1: Differences Between Flash EPO and Host EPO Item Storage Space Storage Capacity Protocol Flash EPO Flash 7 or 14 days’ assistance data Binary Host EPO RAM 6 hours’ assistance data NMEA Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 9 / 47 GNSS Module Series NOTE The maximum period that EPO data can be stored in flash is 14 days for GPS-only EPO files, and 7 days for GPS+GLONASS EPO files. If a 30-day GPS-only EPO file is sent, only the first 14 days of EPO data will be stored. If a 30-day GPS+GLONASS EPO file is sent, only the first 7 days of EPO data will be stored. 1.2. Applicable Modules Not all the applicable modules support both Flash EPO and Host EPO. See the following table for the applicable modules of this document and the type of EPO supported on each module. Table 2: Type of EPO Supported on Applicable Modules Series Lx0 Lx6 LC86L LG77L Module L70 L80 L70-R L80-R L26 L76 L76-L L86 L96 L26-LB L76-LB LC86L LG77L Flash EPO            Host EPO              Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 10 / 47 GNSS Module Series 1.3. AGNSS Requirements The host needs to provide the Reference Time, Reference Position and EPO data to the GNSS receiver. The information provided by the host needs to meet the following requirements so that the GNSS receiver can make better use of EPO: ⚫ The Reference Time should be accurate within 3 s and must be specified in UTC time. ⚫ The Reference Position should be accurate within 30 km from the receiver actual location. Keep in mind that if the receiver’s view of the sky is limited, the accuracy of the Reference Position needs to be increased. ⚫ The EPO data should be valid. The receiver can benefit from any of the assistance data to improve the TTFF. All assistance data (Reference Time, Reference Position and EPO data) are useful but none of them are mandatory. If some of them are unavailable or have expired, it is recommended to avoid using them. The host can send the Reference Time, Reference Position and EPO data to the GNSS receiver through the messages listed in following table. See Chapter 4 for a detailed description of these messages. Table 3: AGNSS Related Commands Packet Type PMTK713 PMTK721 PMTK740 PMTK741 Data Content Reference Position. GPS/GLONASS EPO data for a single satellite. Reference UTC Time. Reference Time and Position. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 11 / 47 GNSS Module Series 2 Download of EPO Files Quectel does not provide any Service Level Agreement for EPO files. Quectel is asking users to download EPO data to their own servers and send them to devices so as to ensure the availability of EPO data. 2.1. Get EPO Files from Server Table 4: Download URL of EPO Files EPO Type Unified QEPO Unified QEPO EPO EPO GNSS Type GPS only GPS + GLONASS GPS only GPS + GLONASS EPO File URL File Name http://wpepodownload.mediatek.com/ QGPS.DAT?vendorinfo http://wpepodownload.mediatek.com/ QG_R.DAT?vendorinfo http://wpepodownload.mediatek.com/ EPO_GPS_3_X.DAT?vendorinfo http://wpepodownload.mediatek.com/ EPO_GR_3_X.DAT?vendorinfo Single name: QGPS.DAT Single name: QG_R.DAT X = 1–10 EPO_GPS_3_1.DAT to EPO_GPS_3_10.DAT X = 1–10 EPO_GR_3_1.DAT to EPO_GR_3_10.DAT The following shows a complete URL sample: http://wpepodownload.mediatek.com/QGPS.DAT?vendor=AAA&project=BBB&device_id=CCC ⚫ The query string starts with '?' and is separated by '&'. ⚫ The values of 'vendor' and 'project' (AAA, BBB in the example) are issued by Quectel, contact Quectel Technical Support to get the value. ⚫ The value of 'device_id' (CCC in the example) contains two parts – one is assigned by Quectel and the other assigned by users. For example: if CCC = XXX_YYY, the value XXX is provided by Quectel and users can contact Quectel Technical Support to get the value, while YYY can be assigned by users and it must be a unique value, such as IMEI. Each device must have a unique ID. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 12 / 47 GNSS Module Series NOTE As there can be a maximum of 30 days’ predictions, there will be up to 10 files. Slices of 30-day EPO: _1 for days 1 to 3, _2 for days 4 to 6, ... _10 for days 28 to 30. 2.2. EPO Files Format This part mainly illustrates the format of EPO files for GPS only and for GPS + GLONASS. 2.2.1. EPO Files Format – GPS Only Day1 Day2 ... Day29 Day30 EPO Format (1 day) Segment UTC Segment1 0:00-6:00 Segment2 6:00-12:00 Segment3 12:00-18:00 Segment4 18:00-24:00 EPO Format (1 Segment) SV1 SV2 ... SV31 SV32 EPO Format (1 SV) Data GPS_Hour ... Byte offset 0[LSB]~2[MSB] 3 Data ... Byte offset ... ... 4~7 ... 64~67 ... 8~11 CheckSum 68~71 Figure 1: EPO Files Format – GPS Only GPS_Secs = GPS_Hour * 3600 GPS_Week Number = GPS_Secs / 604800 GPS TOW = GPS_Secs % 604800 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 13 / 47 SAT data SAT data GNSS Module Series An EPO file contains GPS Time (GPS_Week, GPS_Hour and GPS_Secs). The maximum unit in GPS Time is GPS week which starts at approximately midnight of January 5th to 6th, 1980. The following figure illustrates the format for several segments of EPO files. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 EPO SET 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 EPO SET 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 EPO SET Figure 2: Format for Several Segments of EPO Files The basic unit of an EPO file is SAT Data and the size of each SAT Data is 72 bytes. One EPO SET contains 32 SAT Data, so the data size of an EPO SET is 2304 bytes. Each EPO file contains several EPO SETs, so the file size must be a multiple of 2304 bytes. An EPO SET is valid for 6 hours. Therefore, there will be 4 EPO SETs for one day. 2.2.2. EPO Files Format – GPS + GLONASS SAT data SAT data 1 2 1 2 31 32 65 66 31 32 65 66 87 88 87 88 1 2 31 32 65 66 87 88 GPS EPO SET GLONASS EPO SET Figure 3: EPO Files Format – GPS + GLONASS The basic unit of an EPO file is SAT Data, and the size of a SAT Data is 72 bytes. In GPS + GLONASS EPO files, one EPO SET contains 56 SAT Data, so the data size for an EPO SET is 4032 bytes. Each Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 14 / 47 GNSS Module Series EPO file contains several EPO SETs. The file size must be a multiple of 4032 bytes. An EPO SET is valid for 6 hours. Therefore, there will be 4 EPO SETs for one day. 2.3. Types of EPO Files The EPO data can be downloaded in the form of files. Users can select the most suitable file to download based on the availability of a data connection and storage space of the application. See Table 4: Download URL of EPO Files and Table 5: Types of EPO Files to decide on the file type to be downloaded. Table 5: Types of EPO Files EPO Type Unified QEPO GNSS Type GPS only Unified QEPO GPS + GLONASS EPO EPO GPS only GPS + GLONASS Description 6-hour prediction orbit (ephemeris). Single file containing the latest GPS EPO data available. 6-hour prediction orbit (ephemeris). Single file containing the latest GPS + GLONASS EPO data available. 3-30 days’ prediction orbit (ephemeris). Split in 10 files and each contains 3-day information. 3-30 days’ prediction orbit (ephemeris). Split in 10 files and each contains 3-day information. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 15 / 47 GNSS Module Series 2.4. Recommended Download Procedures of EPO Files Set daily timer to check EPO effectiveness Daily timer expires Power on GNSS receiver Will EPO files expire today?1) Yes Download 3-day EPO files for back up Have valid EPO files?3) Yes No Download unified QEPO files EPO aiding with backup file Verify downloaded Data2) Verify downloaded data Position fixed Backup prepared EPO files Position fixed Figure 4: Recommended Download Procedures of EPO Files NOTE 1. Users must know the current UTC time so as to download the valid EPO files. 2. Download MD5 checksum file by replacing file extension 'DAT' with 'MD5' for checking whether the data are correct. 3. If the device is powered off for a long time, EPO files stored in flash may expire. 2.5. The Validity Period of EPO Files EPO validity period is related to the current UTC time. The EPO validity period can be obtained from the last segment of the EPO file. See Figure 1: EPO Files Format – GPS Only for the sample of how to calculate EPO validity period (GPS_Hour + 6). It is necessary to download the EPO file 12 hours in advance. The following codes show the conversion between UTC time and GPS time. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 16 / 47 GNSS Module Series void utc_to_gpstime(kal_uint32 year, //Input year kal_uint8 mon, //Input month: 1~12 kal_uint8 day, //Input day: 1~31 kal_uint8 hour, //Input hour: 0~23 kal_uint8 min, //Input Minute: 0~59 kal_uint8 sec, //Input second: 0~59 kal_int32* wn, //Output GPS week number double* tow) //Output GPS time of week { kal_int32 iYearsElapsed; //Elapsed years since 1980 kal_int32 iDaysElapsed; //Elapsed days since Jan 5/Jan 6, 1980 kal_int32 iLeapDays; //Leap days since Jan 5/Jan 6, 1980 kal_int32 i; //Number of days at the start of each month (ignore leap years). kal_uint16 doy[12] = {0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334}; iYearsElapsed = year - 1980; i = 0; iLeapDays = 0; while (i <= iYearsElapsed) { if ((i % 100) == 20) { if ((i % 400) == 20) { iLeapDays++; } } else if ((i % 4) == 0) { iLeapDays++; } i++; } /* iLeapDays = iYearsElapsed / 4 + 1; */. if ((iYearsElapsed % 100) == 20) { if (((iYearsElapsed % 400) == 20) && (mon <= 2)) { iLeapDays--; } } else if (((iYearsElapsed % 4) == 0) && (mon <= 2)) { iLeapDays--; } iDaysElapsed = iYearsElapsed * 365 + doy[mon - 1] + day + iLeapDays - 6; //Convert time to GPS weeks and seconds. *wn = iDaysElapsed / 7; *tow = (double)(iDaysElapsed % 7) * 86400 + hour * 3600 + min * 60 + sec; } Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 17 / 47 GNSS Module Series 3 AGNSS Implementation This chapter describes two AGNSS implementation methods: Host EPO and Flash EPO. ⚫ Implement AGNSS with Host EPO The host sends EPO data to the GNSS receiver through NMEA PMTK command, such as $PMTK721. ⚫ Implement AGNSS with Flash EPO The EPO data are downloaded to the flash of GNSS receiver through Binary Protocol. Flash EPO keeps data for a longer time than Host EPO. 3.1. AGNSS with Flash EPO Flash EPO can store 7 or 14 days’ EPO assistance data on flash, which enables the receiver to make use of the available data since boot time. The communication protocol of Flash EPO is Binary Protocol. In order to download assistance data to the receiver, users first need to set the device to Binary mode through $PMTK253 so that the assistance data are downloaded in the binary format specified in this document. See Chapter 3.1.2 and Chapter 3.1.3 for details. 3.1.1. Binary Protocol The preamble of the frame, fixed as 0x04 0x24 2-byte Message 2-byte Message ID Preamble Length MsgID Payload The range for checksum calculation 1-byte The tail of the frame, Checksum fixed as 0x0D 0x0A Checksum Tail Figure 5: Structure of Binary Protocol Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 18 / 47 GNSS Module Series Table 6: Description of Binary Protocol Fields Field Preamble Length MsgID Payload Checksum Tail Length (Byte) 2 2 2 Variable 1 2 Description Fixed as 0x04 0x24. Use little endian. Total length of the messages from Preamble to Tail. Unit: byte. Maximum packet size: 256 bytes. Use little endian. Message ID. Payload data to be transferred. The checksum is the 8-bit exclusive OR of all bytes in the message between (but not including) the Preamble and the Checksum. Fixed as 0x0D 0x0A. Use little endian. 3.1.1.1. MTK_BIN_EPO (MsgID = 723) EPO binary packet is named as MTK_BIN_EPO (MsgID = 723) for convenience. Table 7: MTK_BIN_EPO Format Preamble Length MsgID 0x04 0x24 0x00E3 0x02D3 2 Bytes 2 Bytes 2 Bytes EPO SEQ 2 Bytes Payload SAT Data 72 Bytes SAT Data 72 Bytes SAT Data 72 Bytes Checksum 0x** 1 Byte Tail 0x0D 0x0A 2 Bytes An EPO file contains several SAT Data which are encapsulated in several MTK_BIN_EPO packets to be transferred to GNSS receiver. Each MTK_BIN_EPO packet contains a 2-byte EPO SEQ and 3 SAT Data fields. The length of MTK_BIN_EPO is 227 bytes. The EPO SEQ is used for synchronizing MTK_BIN_EPO packets in transfer protocol. Sometimes, there is no enough EPO data to complete the three SAT Data fields. Some of the three fields can be left as blank, that is, to be filled with 0x00. An MTK_BIN_EPO packet that only contains 0–2 SAT Data is possible and acceptable. The following three MTK_BIN_EPO packets are examples: 4.NOTE It is recommended to confirm the validity of the EPO file before sending it. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 19 / 47 GNSS Module Series Table 8: Format for MTK_BIN_EPO with 2 SAT Data Preamble Length MsgID 0x04 0x24 0x00E3 0x02D3 2 Bytes 2 Bytes 2 Bytes EPO SEQ 2 Bytes Payload SAT Data 72 Bytes SAT Data 72 Bytes 0x00 72 Bytes Checksum 0x** 1 Byte Tail 0x0D 0x0A 2 Bytes Table 9: Format for MTK_BIN_EPO with 1 SAT Data Preamble Length MsgID 0x04 0x24 0x00E3 0x02D3 2 Bytes 2 Bytes 2 Bytes EPO SEQ 2 Bytes Payload SAT Data 72 Bytes 0x00 72 Bytes 0x00 72 Bytes Checksum 0x** 1 Byte Tail 0x0D 0x0A 2 Bytes Table 10: Format for MTK_BIN_EPO with No SAT Data Preamble Length MsgID 0x04 0x24 0x00E3 0x02D3 2 Bytes 2 Bytes 2 Bytes EPO SEQ 2 Bytes Payload Checksum 0x00 0x00 0x00 0x** 72 72 72 1 Byte Bytes Bytes Bytes Tail 0x0D 0x0A 2 Bytes Table 11: Description of MTK_BIN_EPO Fields Field EPO SEQ SAT Data Length (Byte) 2 72 Description Sequence number to indicate the corresponding received MTK_BIN_EPO. Satellite EPO data. GNSS receiver will return an ACK packet for each received MTK_BIN_EPO. The packet is named as MTK_BIN_ACK_EPO (MsgID = 2) for convenience. See Chapter 3.1.1.2 for details. 3.1.1.2. MTK_BIN_ACK_EPO (Msg = 2) This packet is usually returned after receiving an MTK_BIN_EPO packet. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 20 / 47 Table 12: MTK_BIN_ACK_EPO Format Preamble Length MsgID 0x04 0x24 0x000C 0x0002 2 Bytes 2 Bytes 2 Bytes Payload EPO SEQ Result 2 Bytes 1 Byte GNSS Module Series Checksum Tail 0x** 0x0D 0x0A 1 Byte 2 Bytes Table 13: Description of MTK_BIN_ACK_EPO Fields Field EPO SEQ Result Length (Byte) 2 1 Description Sequence number to indicate the corresponding received MTK_BIN_EPO. Result. 0: Failed to receive the packet 1: Successfully received the packet Example: //Successfully received the EPO packet whose sequence number is 0x56: 0x04 0x24 0x0C 0x00 0x02 0x00 0x56 0x00 0x01 0x59 0x0D 0x0A //Failed to receive the EPO packet whose sequence number is 0x56: 0x04 0x24 0x0C 0x00 0x02 0x00 0x56 0x00 0x00 0x58 0x0D 0x0A 3.1.1.3. Change UART Format Packet (MsgID = 253) This packet changes UART communication protocol and sets baud rate. Table 14: Format for Change UART Format Packet Preamble Length 0x04 0x24 0x000E 2 Bytes 2 Bytes MsgID 0x00FD 2 Bytes Payload Protocol Baudrate 1 Byte 4 Bytes Checksum Tail 0x** 0x0D 0x0A 1 Byte 2 Bytes Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 21 / 47 GNSS Module Series Table 15: Description of Change UART Format Packet Fields Field Protocol Length (Byte) 1 Baudrate 4 Description Protocol. 0x00 = NMEA PMTK protocol 0x01 = Binary Protocol UART baud rate. 0x00000000 = Default baud rate 0x00002580 = 9600 0x00004B00 = 19200 0x00009600 = 38400 0x0000E100 = 57600 0x0001C200 = 115200 0x00038400 = 230400 0x00070800 = 460800 0x000E1000 = 921600 Use little endian. Example: //Change UART to Binary Protocol and use baud rate 115200: 0x04 0x24 0x0E 0x00 0xFD 0x00 0x01 0x00 0xC2 0x01 0x00 0x31 0x0D 0x0A //Change UART to PMTK protocol and use default baud rate: 0x04 0x24 0x0E 0x00 0xFD 0x00 0x00 0x00 0x00 0x00 0x00 0xF3 0x0D 0x0A 3.1.1.4. ACK Packet (MsgID = 1) This packet is usually returned after receiving Change UART Format Packet (MsgID = 253). Table 16: ACK Packet Format Preamble Length MsgID 0x04 0x24 0x000C 0x0001 2 Bytes 2 Bytes 2 Bytes Payload Responding MsgID Flag 2 Bytes 1 Byte Checksum Tail 0x** 0x0D 0x0A 1 Byte 2 Bytes Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 22 / 47 GNSS Module Series Table 17: Description of ACK Packet Fields Field Responding MsgID Flag Length (Byte) 2 1 Description Responding message ID. ACK flag. 0x00, 0x01: Invalid: the baud rate is invalid. 0x02: Failure: failed to set baud rate. 0x03: Success: succeeded to set baud rate. Example: //Received a valid binary packet and returned a success flag: 0x04 0x24 0x0C 0x00 0x01 0x00 0xFD 0x00 0x03 0xF3 0x0D 0x0A 3.1.2. EPO Data Transfer Protocol EPO data are packed in MTK_BIN_EPO packets and then transferred to GNSS receiver. At the beginning of the transfer procedure, the host should split the EPO files and encapsulate them into several MTK_BIN_EPO packets, then assign a sequence number starting from zero for each MTK_BIN_EPO packet to make sure the MTK_BIN_EPO packets are transferred in correct order and not missed. The host should follow the EPO Data Transfer Protocol when transferring EPO data to GNSS receiver. 3.1.2.1. Pseudo Code for EPO Data Transfer Protocol The following shows pseudo codes for EPO data transfer procedure, which are for reference only. #define MTKBIN_3EPO_PKT_LNG 227 //At first, the protocol of the communication UART is supposed to be PMTK Protocol. Since EPO data are transferred by using binary packet, the protocol should be changed to Binary Protocol. //Before starting EPO data transfer procedure, change the UART protocol set by $PMTK253. See Chapter 4.3 for the details of $PMTK253. //The SendPmtkCmd() function must be implemented by the programmer. //It is recommended to explicitly specify a baud rate when changing UART packet protocol, for example, $PMTK253,1,115200*00. SendPmtkCmd ('$PMTK253,1,0*37rn'); //Now the data transferred via the UART port will be regarded as binary packet format. Please create a thread to transmit/receive binary packets for the UART. And the thread TMtkBinCmdThread() must be implemented by the programmer. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 23 / 47 GNSS Module Series pMtkBinCmdThread() =new TMtkBinCmdThread(); //Read data in the EPO file, and then verify the validity of EPO data. If the inputted EPO file is not a valid EPO format, the programmer shall terminate the procedure. //Please check whether the file size is a multiple of 2304 bytes or 4032 bytes. //The fgEPO_Verify_File() function must be implemented by the programmer. if (!fgEPO_Verify_File (pEpoFile)) return; //Get total length of MTK_BIN_EPO packets that will be sent. //Total number=ceil ((file size/72)/3) //The i2EPO_Get_Num_Pkt function must be implemented by the programmer. i4NumSvEpoPkt = i2EPO_Get_Num_Pkt(pEpoFile); //Start EPO data transfer procedure to send EPO data. u2EpoSeq=0; u2LastEpoSeq=0; for (i = 0; iSendData(szPktData, MTKBIN_3EPO_PKT_LNG); //Update sequence number. u2LastEpoSeq = u2EpoSeq; u2EpoSeq++; } } //Generate final MTK_BIN_EPO packet to indicate the GNSS receiver that the process is finished. //The fgEPO_Get_Final_Pkt function must be implemented by the programmer. vEPO_Get_Final_Pkt(szPktData); //Send final MTK_BIN_EPO packet to the GNSS receiver. The packet size of MTK_BIN_EPO is MTKBIN_3EPO_PKT_LNG. //Then the process is finished. //The SendData function must be implemented by the programmer. pPortMtkBinThread->SendData(szPktData, MTKBIN_3EPO_PKT_LNG); //Switch UART protocol setting to PMTK packet format and change the baud rate to 115200 for the communication UART. See Chapter 3.1.1.3 for details. //The SendMtkBinCmd function must be implemented by the programmer. SendMtkBinCmd(0x04 0x24 0x0E 0x00 0xFD 0x00 0x00 0x00 0xC2 0x01 0x00 0x30 0x0D 0x0A); Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 25 / 47 3.1.3. AGNSS Procedure with Flash EPO Power on GNSS GNSS Module Series Have EPO file? NO YES Has expired EPO file? YES Erase EPO file NO Send Reference Time Download EPO files with MTK_BIN_EPO Verify downloaded data Restart GNSS Send Reference Position Position fixed Figure 6: AGNSS Procedure with Flash EPO 1. Power on the GNSS module. 2. Check whether there are EPO data in GNSS module through $PMTK607. 3. If there exists EPO data, go to the next step to check the data validity. Otherwise, download EPO data to GNSS module and verify downloaded data, then restart GNSS module and directly go to Step 6. 4. Check whether the EPO file in GNSS module has expired. 5. If not, go to next step. Otherwise, erase expired EPO file through $PMTK127 and download a new EPO file. 6. Send Reference Time to GNSS module with $PMTK740. 7. Send Reference Position to GNSS module with $PMTK741 or $PMTK713. 8. Wait for GNSS module to fix position. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 26 / 47 GNSS Module Series 3.2. AGNSS with Host EPO Host EPO allows for a simpler text-based implementation which enables the receiver to perform a fast start up where assistance data must be sent to the receiver each time it boots. When using Host EPO, the receiver can only receive one block of assistance data valid for 6 hours. Implementing Host EPO only requires a few PMTK sentences and all data transfer can be done in NMEA mode. See Chapter 4 for a detailed description of $PMTK713, $PMTK721, $PMTK740 and $PMTK741. Both Reference Time and Position can be sent through $PMTK741. 3.2.1. Recommended Sequence for Host EPO After the GNSS receiver is powered on, it will output a start-up message $PMTK010,001*2E to notify the host that it has finished initialization and is capable of receiving PMTK commands. After the host receives the system startup message, it can send the assistance data in sequence shown in the Figure 7: Recommended Sequence for Host EPO. The sequence of assistance data is Reference Time, Reference Position and EPO data. The Host EPO procedure consists of the following steps: 1. GNSS module starts up. 2. The host sends Reference Time. 3. The host sends Reference Position. 4. The host sends EPO data. The supplied Reference Time, Reference Position and EPO data must comply with the requirements listed in Chapter 1.3. NOTE In the current implementation, the host needs to wait for a $PMTK001 packet to be returned before sending another segment of EPO data. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 27 / 47 GNSS Receiver Host EPO Sequence GNSS Module Series Host GNSS Module Powers Up Start up message Assistance Data(Time) $PMTK001(ACK) Assistance Data(Position) $PMTK001(ACK) Loop [Repeats until all EPO data are sent] EPO Assistance Data Segment 001 $PMTK001(ACK) EPO Assistance Data Segment 002 $PMTK001(ACK) The host needs to wait for $PMTK001 ACK packages Figure 7: Recommended Sequence for Host EPO 3.2.2. Sample Code of Sending EPO The following is the reference code to send one segment of EPO data to GNSS receiver. It reveals how to extract correct EPO segment from an EPO file and how to construct PMTK messages for GNSS receiver. PMTK messages for Reference Time, Reference Position, and second EPO segment are not included in this example. #include #include #define MTKEPO_SV_NUMBER 32 #define MTKEPO_RECORD_SIZE 72 #define MTKEPO_SEGMENT_NUM (30 * 4) unsigned char calc_nmea_checksum(const char* sentence) { unsigned char checksum = 0; Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 28 / 47 GNSS Module Series while (*sentence) { checksum ^= (unsigned char)*sentence++; } return checksum; } // translate UTC to GPS_Hour int utc_to_gps_hour(int iYr, int iMo, int iDay, int iHr) { int iYearsElapsed; // Years since 1980 int iDaysElapsed; // Days elapsed since Jan 6, 1980 int iLeapDays; // Leap days since Jan 6, 1980 int i; // Number of days into the year at the start of each month (ignoring leap years) const unsigned short doy[12] = {0,31,59,90,120,151,181,212,243,273,304,334}; iYearsElapsed = iYr - 1980; i = 0; iLeapDays = 0; while (i <= iYearsElapsed) { if ((i % 100) == 20) { if ((i % 400) == 20) { iLeapDays++; } } else if ((i % 4) == 0) { iLeapDays++; } i++; } if ((iYearsElapsed % 100) == 20) { if (((iYearsElapsed % 400) == 20) && (iMo <= 2)) { iLeapDays--; } } else if (((iYearsElapsed % 4) == 0) && (iMo <= 2)) { iLeapDays--; } iDaysElapsed = iYearsElapsed * 365 + (int)doy[iMo - 1] + iDay + iLeapDays - 6; // Convert time to GPS weeks and seconds return (iDaysElapsed * 24 + iHr); } void send_assistance_data(int iYr, int iMo, int iDay, int iHr) { FILE* fp; int i, segment, epo_gps_hour, current_gps_hour; unsigned epobuf[MTKEPO_RECORD_SIZE/sizeof(unsigned)]; char strbuf[200], outbuf[200]; Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 29 / 47 GNSS Module Series // open EPO file and read the header (assume EPO file has passed integrity check) if (NULL == (fp = fopen('MTKEPO.bin', 'rb'))) { return; } fread(&epo_gps_hour, 4, 1, fp); epo_gps_hour &= 0x00FFFFFF; // determine the segment to use current_gps_hour = utc_to_gps_hour(iYr, iMo, iDay, iHr); segment = (current_gps_hour - epo_gps_hour) / 6; if ((segment < 0) || (segment >= MTKEPO_SEGMENT_NUM)) { return; } // read binary EPO data and sent it to MT3339 fseek(fp, segment*(MTKEPO_RECORD_SIZE)*(MTKEPO_SV_NUMBER), SEEK_SET); for (i = 0; i < MTKEPO_SV_NUMBER; i++) { fread(epobuf, MTKEPO_RECORD_SIZE, 1, fp); // assume host system is little-endian sprintf(strbuf,'PMTK721,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X,%X', i+1, epobuf[0], epobuf[1], epobuf[2], epobuf[3], epobuf[4], epobuf[5], epobuf[6], epobuf[7], epobuf[8], epobuf[9], epobuf[10], epobuf[11], epobuf[12], epobuf[13], epobuf[14], epobuf[15], epobuf[16], epobuf[17]); sprintf(outbuf, '$%s*Xrn', strbuf, calc_nmea_checksum(strbuf)); // send them by UART // uart_send(outbuf, strlen(outbuf)); printf('%s', outbuf); // for demo } fclose(fp); } int main (void) { // get current system time // ... time(); // send assistance data of current time send_assistance_data(2009, 8, 3, 22); return 0; } Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 30 / 47 GNSS Module Series 4 AGNSS Related Messages 4.1. PMTK001 PMTK_ACK Acknowledges a PMTK command. This message is returned to inform the sender that the receiver has received the packet. Type: Output Synopsis: $PMTK001,,[,,…,]* Parameter: Field Format Unit Numeric - Numeric - [,,…,] Numeric - Description The packet type that the acknowledgement responds. ACK flag. 0 = Invalid command 1 = Unsupported command type 2 = Valid command, but action failed 3 = Valid command, and action succeeded Extended parameters (optional). Example: $PMTK001,0,3*30 4.2. PMTK127 PMTK_CMD_CLEAR_EPO Erases the EPO data stored in the GNSS receiver. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 31 / 47 Type: Command Synopsis: $PMTK127* Parameter: None Result: Returns a $PMTK001 message. Example: $PMTK127*36 $PMTK001,127,3*34 GNSS Module Series 4.3. PMTK253 PMTK_SET_OUTPUT_FMT Sets data output format and baud rate for current port. Type: Set Synopsis: $PMTK253,,* Parameter: Field Unit - bps Default 0 115200 Description Protocol mode. 0 = NMEA mode 1 = Binary mode Baud rate for the new output mode. 0: use default baud rate (not recommended) It is highly recommended to specify an explicit baud rate. Possible values will be: 9600 19200 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 32 / 47 GNSS Module Series 38400 57600 115200 230400 460800 921600 Result: Returns a $PMTK001 message. Example: //Switch from NMEA mode to Binary mode, and use default baud rate 115200 bps: $PMTK253,1,0*37 //Switch from Binary mode to NMEA mode, and use baud rate 9600 bps: $PMTK253,0,9600*09 $PMTK001,253,3*34 NOTE When switching from Binary mode to NMEA mode, a binary ACK packet ($PMTK001) will be returned after this message is executed. When switching from NMEA mode to Binary mode, no ACK packet is returned. 4.4. PMTK607 PMTK_Q_EPO_INFO Queries the EPO data stored in the GNSS chip. Type: Query Synopsis: $PMTK607* Parameter: None Result: Returns a $PMTK707 message. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 33 / 47 Example: $PMTK607*33 $PMTK707,56,1468,172800,1470,151200,1468,259200,1468,259200*1F GNSS Module Series 4.5. PMTK707 PMTK_DT_EPO_INFO This message is returned after receiving $PMTK607 and it contains EPO data stored in GNSS chip. Type: Output Synopsis: $PMTK707,,,,,,,,,* Parameter: Field Unit - - - - - - - - - Default Description - Total number of EPO SET stored in GNSS chip - GPS week number of the first EPO SET stored in GNSS chip - GPS TOW of the first EPO SET stored in GNSS chip - GPS week number of the last EPO SET stored in GNSS chip - GPS TOW of the last EPO SET stored in GNSS chip - GPS week number of the first EPO SET currently used - GPS TOW of the first EPO SET currently used - GPS week number of the last EPO SET currently used - GPS TOW of the last EPO SET currently used Result: None Example: $PMTK707,56,1468,172800,1470,151200,1468,259200,1468,259200*1F Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 34 / 47 GNSS Module Series 4.6. PMTK713 PMTK_DT_LOC Sends Reference Position to the GNSS receiver. To have a quick TTFF, the Reference Position shall be accurate within 30 km. Type: Input Synopsis: $PMTK713,,,,,,,* Parameter: Field Unit Range Description Degree Degree -90.0 to 90.0 -180.0 to 180.0 WGS84 geodetic latitude. It is recommended to express this value in floating-point with 6 decimal points. WGS84 geodetic longitude. It is recommended to express this value in floating-point with 6 decimal points. Meter - WGS84 ellipsoidal altitude. Meter > 0 Standard deviation of semi-major axis of error ellipse. Meter > 0 Standard deviation of semi-minor axis of error ellipse. Degree 0–179 Orientation of semi-major axis of error ellipse. Meter > 0 % 0–100 Vertical uncertainty. The confidence by which the position of a target entity is known to be within the shape description. Result: Returns a $PMTK001 message. Example: $PMTK713,24.772816,121.022636,160,333,333,6,50,67*08 $PMTK001,713,3,24.772816,121.022636,160.000000,333.000000,333.000000,6,50.000000,67*0A Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 35 / 47 GNSS Module Series NOTE We use Ellipsoid Point with altitude and uncertainty ellipsoid to describe poosition error shape. 4.7. PMTK721 PMTK_DT_SV_EPO Sends GPS/GLONASS EPO data for a single satellite to GNSS receiver. GPS satellites are identified by their PRN number, which ranges from 1 to 32. GLONASS satellites are identified by their slot number which ranges from 1 to 24 for the full constellation of 24 satellites. for GLONASS is assigned by slot number plus 64, which ranges from 65 to 88. Type: Input Synopsis: $PMTK721,,,...,* Parameter: Field Unit - - Range GPS: 1–32 GLONASS: 65–88 - Description Satellite PRN number [represented in HEX characters] for the EPO data to follow. 18 words [LSB first] of one EPO segment data (total 72 bytes). Result: Returns a $PMTK001 message. Example: $PMTK721,4,40568B0,D6C83E84,70E8E10,FA414370,F913650C,70E71F8,F8D266CF,8732D6FD,7F1D 9CE,E59383DF,76BFB93,A60319DF,C36C3289,20173F8D,959E4561,1000001C,40000,8B94CFB6*2C $PMTK001,721,17,00000000*32 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 36 / 47 GNSS Module Series 4.8. PMTK740 PMTK_DT_UTC Sends current Reference UTC Time to GNSS receiver. Local time should be avoided due to time-zone offset. To have a faster TTFF, the Reference Time should be accurate with 3 s and must be specified in UTC time. Type: Input Synopsis: $PMTK740,,,,,,* Parameter: Field Unit Year Month Day Hour Minute Second Range > 1980 1–12 1–31 0–23 0–59 0–59 Description UTC time: year in 4 digits. UTC time: month. UTC time: day. UTC time: hour. UTC time: minute. UTC time: second. Result: Returns a $PMTK001 message. Example: $PMTK740,2010,2,10,9,0,58*05 $PMTK001,740,3,2010,2,10,9,0,58*07 4.9. PMTK741 PMTK_DT_POS Injects Reference Position and Reference UTC Time into GNSS receiver to have a faster TTFF. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 37 / 47 GNSS Module Series Type: Input Synopsis: $PMTK741,,,,,,,,,* Parameter: Field Unit Range Description Degree Degree -90.0 to 0.0 -180.0 to 180.0 WGS84 geodetic latitude. It is recommended to express this value in floating-point with 6 decimal points. Minus: south; Plus: north. WGS84 geodetic longitude. It is recommended to express this value in floating-point with 6 decimal points. Minus: west; Plus: east. Meter - WGS84 ellipsoidal altitude. Year > 1980 UTC time: year in 4 digits. Month 01–12 UTC time: month. Day 01–31 UTC time: day. Hour 00–23 UTC time: hour. Minute 00–59 UTC time: minute. Second 00–59 UTC time: second. Result: Returns a $PMTK001 message. Example: $PMTK741,24.772816,121.022636,160,2016,01,01,12,00,00*17 $PMTK001,741,3,24.772816,121.022636,160.000000,2016,1,1,12,0,0*3B Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 38 / 47 GNSS Module Series 5 EPO Usage Through QGNSS QGNSS is a Quectel official tool which allows users to evaluate the receiver performance as well as to perform different measurements on the receiver. Visit http://220.180.239.212:8177 for details on QGNSS. This chapter describes how to evaluate the EPO functionality through QGNSS. 5.1. Testing Flash EPO with QGNSS Steps to test Flash EPO with the QGNSS tool: 1. Run the QGNSS tool. 2. In the main interface, click 'AGNSS' → 'Assistant GNSS Offline' as shown below. Figure 8: AGNSS Setting Interface of QGNSS 3. Download EPO file to the module. a) Click the 'Connect' button to connect to the FTP server. b) Select EPO file. c) Click the 'Download selected file' button to download the EPO file to computer. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 39 / 47 d) Click 'Download to module' to download the EPO file to module. GNSS Module Series Figure 9: EPO File Downloading 4. Click 'Tools' → 'Static TTFF Testing' to enter TTFF testing window. Figure 10: Static TTFF Testing 5. Check 'Use AGNSS' and click 'Run' to run the TTFF testing. Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 40 / 47 GNSS Module Series Figure 11: TTFF Setting 5.2. Testing Host EPO with QGNSS The steps to test Host EPO with the QGNSS tool: 1. Run QGNSS tool. 2. In the main interface, click 'Tools' -> 'Static TTFF Testing' to enter the TTFF testing window. Figure 12: Static TTFF Testing Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 41 / 47 GNSS Module Series 3. Configure parameter: a) Click 'Set AGNSS' and check 'Use AGNSS' to enter the Assistant GNSS Online window. b) Click 'Connect' button to connect to FTP server. c) Select EPO file and click 'Download selected file' button to download the EPO file to computer. d) Check 'Using UTC time', 'Cold start', 'Position' and 'AGNSS Data'. e) Enter the latitude and longitude or click 'Use Current Position' to automatically select the last fixed position. f) Click 'Run' to test TTFF. Figure 13: TTFF Setting NOTE 1. If the Flash EPO has been tested first, use $PMTK127*36 to clear the Flash EPO data before users perform the Host EPO testing. A Host EPO file can be selected according to UTC time: 0:00 to 6:00: EPO file 1 6:00 to 12:00: EPO file 2 12:00 to 18:00: EPO file 3 18:00 to 24:00: EPO file 4 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 42 / 47 GNSS Module Series 6 AGNSS Implementation Example This chapter gives examples to show how EPO files can be downloaded to the module. 6.1. Flash EPO Implementation Blue: Send data Red: ACK information //Host sends $PMTK253,1,0*37 for switching from NMEA mode to binary mode, NO ACK will be sent from module: 24 50 4D 54 4B 32 35 33 2C 31 2C 30 2A 33 37 0D 0A //Host sends EPO file: 04 24 E3 00 D3 02 00 00 DC 93 05 01 C6 03 F8 9F 59 DE 0A 73 39 0F 54 00 23 25 FD 02 F4 21 0A 73 ……0D 0A //Module will erase the area where the EPO saved. 24 43 4C 52 2C 45 50 4F 2C 30 30 30 61 38 30 30 30 2A 35 45 0D 0A 24 43 4C 52 2C 45 50 4F 2C 30 30 30 61 39 0D 0A 24 43 4C 52 2C 45 50 4F 2C 30 30 30 61 39 30 30 30 2A 35 46 0D 0A 24 43 4C 52 2C 45 50 4F 2C 30 30 30 61 61 30 30 30 2A 30 37 0D 0A 24 43 4C 52 2C 45 50 4F 2C 30 30 30 61 62 30 30 30 2A 30 34 0D 0A 24 43 4C 52 2C 45 50 4F 2C 30 30 30 61 63 30 30 30 2A 30 35 0D 0A …… //Module returns a $PMTK001 message: 04 24 0C 00 20 00 00 00 01 0F 0D 0A //Host sends EPO data: 04 24 E3 00 D3 02 01 00 DC 93 05 04 B2 02 F8 01 C7 71 0A 73 A6 5F 49 FC A9 68 D9 FC C9 71 0A 73 ……. 0D 0A //Module returns a $PMTK001 message: 04 24 0C 00 02 00 01 00 01 0E 0D 0A //Host sends EPO data: 04 24 E3 00 D3 02 02 00 DC 93 05 07 1B 03 F8 3E F8 41 0A 73 2B 74 62 03 A8 4D 5F 04 C9 41 0A 73 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 43 / 47 ……0D 0A //Module returns a $PMTK001 message: 04 24 0C 00 02 00 02 00 01 0D 0D 0A //Host send EPO data: 04 24 E3 00 D3 02 03 00 DC 93 05 ……. 0D 0A //Module returns a $PMTK001 message: 04 24 0C 00 02 00 03 00 01 0C OD 0A …… //Host send EPO data: 04 24 E3 00 D3 02 6A 00 DC 93 05 ……. 0D 0A //Module returns a $PMTK001 message: 04 24 0C 00 02 00 6A 00 01 65 0D 0A //End of host sending, no data any more: 04 24 E3 00 D3 02 FF FF 00 00 00 00 00 00 00 00……0D 0A //End of module reception: 04 24 0C 00 02 00 FF FF 01 0F 0D 0A //Host changes UART to PMTK protocol and use default baud rate: 04 24 0E 00 FD 00 00 00 00 00 00 F3 0D 0A GNSS Module Series 6.2. Host EPO Implementation Blue: Send data Red: ACK information //Host Sends cold start command: $PMTK103*30: 24 50 4D 54 4B 31 30 33 2A 33 30 0D 0A //Host sends the current UTC time command: $PMTK740,2021,09,18,07,34,14*35: 24 50 4D 54 4B 37 34 30 2C 32 30 32 31 2C 30 39 2C 31 38 2C 30 37 2C 33 34 2C 31 34 2A 33 35 0D 0A //Module returns a $PMTK001 message: $PMTK001,740,2,2021,9,18,7,34,14*36: 24 50 4D 54 4B 30 30 31 2C 37 34 30 2C 32 2C 32 30 32 31 2C 39 2C 31 38 2C 37 2C 33 34 2C 31 34 2A 33 36 0D 0A //Host sends the current location information command: Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 44 / 47 GNSS Module Series $PMTK741,31.822218,117.115247,49.200000,2021,09,18,07,34,14*0B 24 50 4D 54 4B 37 34 31 2C 33 31 2E 38 32 32 32 31 38 2C 31 31 37 2E 31 31 35 32 34 37 2C 34 39 2E 32 30 30 30 30 30 2C 32 30 32 31 2C 30 39 2C 31 38 2C 30 37 2C 33 34 2C 31 34 2A 30 42 0D 0A //Module returns a $PMTK001 message: $PMTK001,741,3,31.822218,117.115247,49.200000,2021,9,18,7,34,14*09 24 50 4D 54 4B 30 30 31 2C 37 34 31 2C 33 2C 33 31 2E 38 32 32 32 31 38 2C 31 31 37 2E 31 31 35 32 34 37 2C 34 39 2E 32 30 30 30 30 30 2C 32 30 32 31 2C 39 2C 31 38 2C 37 2C 33 34 2C 31 34 2A 30 39 0D 0A //Host sends EPO data: $PMTK721,1,10593EE,9FFC01C0,84D8DE59,E250EA6,F6326A6,84D8DE3E,75D098A,855C5F41,6F1 8520,CAD37EAE,2A797EC,A60346B9,25302423,2F28853F,24458AEA,1000001C,0000000,4B65EDB 3*19 24 50 4D 54 4B 37 32 31 2C 31 2C 31 30 35 39 33 45 45 2C 39 46 46 43 30 31 43 30 2C 38 34 44 38 44 45 35 39 2C 45 32 35 30 45 41 36 2C 46 36 33 32 36 41 36 2C 38 34 44 38 44 45 33 45 2C 37 35 44 30 39 38 41 2C 38 35 35 43 35 46 34 31 2C 36 46 31 38 35 32 30 2C 43 41 44 33 37 45 41 45 2C 32 41 37 39 37 45 43 2C 41 36 30 33 34 36 42 39 2C 32 35 33 30 32 34 32 33 2C 32 46 32 38 38 35 33 46 2C 32 34 34 35 38 41 45 41 2C 31 30 30 30 30 30 31 43 2C 30 30 30 30 30 30 30 2C 34 42 36 35 45 44 42 33 2A 31 39 0D 0A //Module returns a $PMTK001 message: $PMTK001,721,3, 1,00000000*25: 24 50 4D 54 4B 30 30 31 2C 37 32 31 2C 33 2C 20 31 2C 30 30 30 30 30 30 30 30 2A 32 35 0D 0A //Host sends EPO data: $PMTK721,2,20593EE,EEFC02B5,84D8EE28,DF12534,E55186E,84D8EEFF,F8B63471,83655362, 6F18E3E,DFA23AA6,D6EB7E5,A6001FC7,19B59076,20492A75,C32F2503,1000001C,0000000,C604 863*1C 24 50 4D 54 4B 37 32 31 2C 32 2C 32 30 35 39 33 45 45 2C 45 45 46 43 30 32 42 35 2C 38 34 44 38 45 45 32 38 2C 44 46 31 32 35 33 34 2C 45 35 35 31 38 36 45 2C 38 34 44 38 45 45 46 46 2C 46 38 42 36 33 34 37 31 2C 38 33 36 35 35 33 36 32 2C 36 46 31 38 45 33 45 2C 44 46 41 32 33 41 41 36 2C 44 36 45 42 37 45 35 2C 41 36 30 30 31 46 43 37 2C 31 39 42 35 39 30 37 36 2C 32 30 34 39 32 41 37 35 2C 43 33 32 46 32 35 30 33 2C 31 30 30 30 30 30 31 43 2C 30 30 30 30 30 30 30 2C 43 36 30 34 38 36 33 2A 31 43 0D 0A //Module returns a $PMTK001 message: $PMTK001,721,3, 2,00000000*26: 24 50 4D 54 4B 30 30 31 2C 37 32 31 2C 33 2C 20 32 2C 30 30 30 30 30 30 30 30 2A 32 36 0D 0A …… …… //Host sends EPO data: $PMTK721,20,200593EE,E2FC0257,84DACE24,FE391CC7,FD6A2881,84DA31D2,F8FB23C7,82F3C2 84,6F39D87,4190A41C,590822F,A601FD64,71D66A59,2004BD1E,9F31A748,100 Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 45 / 47 GNSS Module Series D1E,9F31A748,1000001C,1000000,80B38D89*53 35 41 35 37 32 42 41 2A 31 36 0D 0A 24 50 4D 54 4B 37 32 31 2C 32 30 2C 32 30 30 35 39 33 45 45 2C 45 32 46 43 30 32 35 37 2C 38 34 44 41 43 45 32 34 2C 46 45 33 39 31 43 43 37 2C 46 44 36 41 32 38 38 31 2C 38 34 44 41 33 31 44 32 2C 46 38 46 42 32 33 43 37 2C 38 32 46 33 43 32 38 34 2C 36 46 33 39 44 38 37 2C 34 31 39 30 41 34 31 43 2C 35 39 30 38 32 32 46 2C 41 36 30 31 46 44 36 34 2C 37 31 44 36 36 41 35 39 2C 32 30 30 34 42 44 31 45 2C 39 46 33 31 41 37 34 38 2C 31 30 30 30 30 30 31 43 2C 31 30 30 30 30 30 30 2C 38 30 42 33 38 44 38 39 2A 35 33 0D 0A //Module returns a $PMTK001 message: $PMTK001,721,3, 32,00000000*35: 0A 24 50 4D 54 4B 30 30 31 2C 37 32 31 2C 33 2C 33 32 2C 30 30 30 30 30 30 30 30 2A 33 35 0D 0A Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 46 / 47 GNSS Module Series 7 Appendix References Table 18: Almanac, Ephemeris and EPO Type Source Validity Period Effect Almanac Satellites Several weeks Satellites searching Ephemeris Satellites < 4 hours Positioning EPO Chipset supplier’s server 6 hours to 30 days Satellites searching & positioning Table 19: Terms and Abbreviations Abbreviation EPO FTP GLONASS GNSS GPS TTFF TOW UART UTC URL ACK SV Description Extended Prediction Orbit File Transfer Protocol Global Navigation Satellite System Global Navigation Satellite System Global Positioning System Time to First Fix Time of Week Universal Asynchronous Receiver/Transmitter Coordinated Universal Time Uniform Resource Locator Acknowledgement Satellite Vehicle Lx0&Lx6&LC86L&LG77L_AGNSS_Application_Note 47 / 47

BG95&BG77&BG600L Series PPP Application Note LPWA Module Series Version: 1.0 Date: 2021-10-09 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_PPP_Application_Note 1 / 24 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. BG95&BG77&BG600L_Series_PPP_Application_Note 2 / 24 LPWA Module Series About the Document Revision History Version 1.0 Date Author Description 2021-07-30 Sherlock ZHAO Creation of the document 2021-10-09 Sherlock ZHAO First official release BG95&BG77&BG600L_Series_PPP_Application_Note 3 / 24 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 1.1. Applicable Modules .................................................................................................................... 7 2 Application Mode ................................................................................................................................ 8 3 Procedures for Setting up PPP ......................................................................................................... 9 3.1. General Procedure for Setting up PPP...................................................................................... 9 3.2. Recommended Procedure for Setting up PPP ........................................................................ 10 4 PPP Connection Modes.................................................................................................................... 12 4.1. Data Mode and Command Mode............................................................................................. 12 4.1.1. Switch from Data Mode to Command Mode................................................................. 12 4.1.1.1. Change MAIN_DTR Level to Switch from Data Mode to Command Mode....... 12 4.1.1.2. Use Sequence +++ to Switch from Data Mode to Command Mode ................. 12 4.1.2. Switch from Command Mode to Data Mode................................................................. 13 4.1.2.1. Use ATO to Switch from Command Mode to Data Mode .................................. 13 4.2. Handle URC in Data Mode ...................................................................................................... 13 4.3. Data Carrier Detection (DCD) Mode........................................................................................ 13 5 PPP Connection Termination .......................................................................................................... 15 6 PPP Dial-up Operations.................................................................................................................... 16 6.1. Preparation............................................................................................................................... 16 6.2. PPP Dial-up Network Configuration......................................................................................... 16 6.2.1. Add a New Dial-up Connection..................................................................................... 16 6.2.2. Create the Connection .................................................................................................. 19 6.2.3. Configure the Dial-up Tool............................................................................................. 21 6.2.4. Establish Dial-up Connection........................................................................................ 21 7 Appendix References ....................................................................................................................... 23 BG95&BG77&BG600L_Series_PPP_Application_Note 4 / 24 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 7 Table 2: Related Documents ...................................................................................................................... 23 Table 3: Terms and Abbreviations .............................................................................................................. 23 BG95&BG77&BG600L_Series_PPP_Application_Note 5 / 24 LPWA Module Series Figure Index Figure 1: PPP Application Mode .................................................................................................................. 8 Figure 2: General Procedure for Setting up PPP......................................................................................... 9 Figure 3: Flowchart of Recommended Procedure for Setting up PPP ...................................................... 10 Figure 4: Select 'Network & Internet' in Windows Settings....................................................................... 17 Figure 5: Set up a New PPP Connection................................................................................................... 17 Figure 6: Connect Using Dial-up ................................................................................................................ 18 Figure 7: Create the Connection ................................................................................................................ 19 Figure 8: Connecting to Dial-up Connection.............................................................................................. 20 Figure 9: The Connection to the Internet is Ready to Use ........................................................................ 20 Figure 10: Configure the Dial-up Tool ........................................................................................................ 21 Figure 11: Establish Dial-up Connection.................................................................................................... 22 BG95&BG77&BG600L_Series_PPP_Application_Note 6 / 24 LPWA Module Series 1 Introduction This document provides a brief explanation of the PPP functions of Quectel BG95 series, BG77 and BG600L-M3 modules, including PPP application modes, setting procedures, connection modes, termination steps, and dialing examples. The Point-to-Point Protocol is designed for simple links which transport packets between two ports. These links provide full-duplex simultaneous bi-directional operation, and are assumed to deliver packets in order. It is intended that PPP provides a common solution for easy connection of a wide variety of hosts, bridges, and routers. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_PPP_Application_Note 7 / 24 LPWA Module Series 2 Application Mode PPP (Point-to-Point Protocol) use is illustrated in the figure below. Use UART port or USB port for PPP connection. The module provides a PPP server for application, and the application provides a PPP client for the module. In addition, the application must provide protocols such as TCP/IP, HTTP(S), etc. When the PPP connection is established, the IP packet data stream from the application is transmitted to the Internet through the module. Most standard operating systems (e.g., Windows and Unix/Linux) include the PPP protocol stack. For operating systems that have no available applications for PPP connection, it is necessary to develop application software first. Application IP PPP UART TXD RXD CTS RTS DTR DCD RING USB USB_DM USB_DP USB_GN USB_VBUS IP RELAY PPP TXD RXD CTS RTS DTR DCD RING UART Radio Bearer USB_DM USB_DP USB_GND USB_VBUS USB Application Module Figure 1: PPP Application Mode BG95&BG77&BG600L_Series_PPP_Application_Note 8 / 24 LPWA Module Series 3 Procedures for Setting up PPP 3.1. General Procedure for Setting up PPP After the module registers on LTE Cat M1, LTE Cat NB2 or GPRS network, it is necessary to set the APN for PPP with AT+CGDCONT and to start the PPP with ATD*99#. After executing ATD*99#, the module enters the PPP frame interaction process, which is based on standard PPP protocol. The module data packet interaction description is shown in the figure below. For more information about standard PPP, see RFC 1661. TE Module AT+CGREG? Or AT+CEREG? +CGREG: 0,1 Or +CEREG: 0,1 AT+CGDCONT=1,'IP','CMNET' OK ATD*99# CONNECT 7E FF 7D 23 C0 21 7D 21 7D Figure 2: General Procedure for Setting up PPP NOTE See document [1] for detailed information about the AT commands mentioned in this chapter. BG95&BG77&BG600L_Series_PPP_Application_Note 9 / 24 3.2. Recommended Procedure for Setting up PPP LPWA Module Series Recommended Power-on/off: Power on the module For more information about the recommended power-on/off methods for each applicable module, see the corresponding hardware design document. 1. Synchronization between TE and the module. 2. Set and save baud rate by AT+IPR= and AT&W. This can be ignored if USB modem port is used. N Query (U)SIM Card Status: Reboot the module if it fails to detect (U)SIM card in 20 s with AT+CPIN?. Network: 1. When of AT+CGREG? or AT+CEREG? returns 1 or 5, it indicates that the module has registered on the network. 2. It is possible to go to the next step without registering on network. APN Configuration: 1. APN must be set with AT+CGDCONT. 2. Use AT+CGACT? to check whether the current context has been activated when AT+CGDCONT returns error. Exit PPP dialing if (U)SIM card is not ready in 20 s. AT+CPIN? Y Query (U)SIM card status (U)SIM card is ready AT+CGREG? or AT+CEREG? Query network status 1. Set APN with AT+CGDCONT 2. Start PPP dialing with ATD*99# Connect_Count++ Connect_Count < 5 Packet Interaction Packet Interaction: 1. Exit Packet Interaction procedure with +++. 2. The module will report NO CARRIER when PPP connection is terminated. LCP Negotiation: 1. If UART is used, ensure the MCU and the module baud rates are the same. AUTH Negotiation: 1. Ensure that AUTH type is either PAP(0xc023) or CHAP(0xc223). IPCP Negotiation: 1. Check whether MCU has got legal IP and DNS address. 2. Check whether the amount of DNS MCU is equal to the amount requested by MCU. 3. Terminate PPP connection if IPCP negotiation between the module and TE is not completed in 90 s, and then retry to set up PPP. Start timer when IPCP negotiation begins Exception Handling: 1. Check if the PPP TerminateRequest packet is right. 2. Reboot the module if the steps above are not successful. Return CONNECT LCP negotiation OK AUTH negotiation OK Exception handling N Send Count<5 IPCP negotiation Y N OK Succeed to negotiate IPCP in 90 s MCU sends N PPP Terminate- Request packet MCU receives Terminate-Ack Y packet from PPP in 3 s Send Count++ Y MCU got IP and N DNS Y Data transmission Figure 3: Flowchart of Recommended Procedure for Setting up PPP BG95&BG77&BG600L_Series_PPP_Application_Note 10 / 24 LPWA Module Series When the module is powered on and the main UART is used, set and save the baud rate by executing AT+IPR= and AT&W. Before executing ATD*99# to set up PPP, you must check the status of the (U)SIM card with AT+CPIN?. When the (U)SIM card is ready, periodically check the network registration status with AT+CEREG? or AT+CGREG? until the network is prepared. NOTE 1. Ensure the MCU and the module are synchronized successfully after rebooting the module. The MCU sends AT to the module every 100 ms until it receives OK reported by the module. If the main UART is used, the MCU will execute AT+IPR= and AT&W to set and save the baud rate after successfully synchronizing the baud rate. 2. Before inputting the next AT command, the MCU needs to wait for the response to the previous AT command (e.g., OK, CME error, CMS error). If there is no response within 60 seconds, the module can be restarted. 3. It is strongly recommended NOT to power on/off the module frequently. If 3 consecutive dialing retries fail, you can immediately power on/off (reset) the module for the first time. After resetting, if the dialing retry fails again, you need to wait for 10 minutes for the second reset, 30 minutes for the third reset, and 1 hour for the fourth reset. 4. If MCU fails to transmit data to the network after establishing the PPP connection, check the PPP configuration and network status and restart the module. 5. See document [1] for detailed information about the AT commands mentioned in this chapter. BG95&BG77&BG600L_Series_PPP_Application_Note 11 / 24 LPWA Module Series 4 PPP Connection Modes 4.1. Data Mode and Command Mode The module communicates with an application via USB or UART port (including AT commands and data). USB and UART ports support two types of operation modes: data mode and command mode. The two ports are in command mode before PPP is set up, and the module can execute AT commands in this mode. When PPP negotiation is started, the two ports enter data mode, and stay in the data mode after the PPP connection is configured. The module cannot execute AT commands in data mode. If the PPP connection is not successfully established, the two ports will remain in the command mode. Quectel BG95 series, BG77 and BG600L-M3 modules provide convenient methods for switching between the two modes. 4.1.1. Switch from Data Mode to Command Mode 4.1.1.1. Change MAIN_DTR Level to Switch from Data Mode to Command Mode When PPP connection already exists and the USB/UART port is in data mode, the ports can be switched to command mode by changing MAIN_DTR pin level from low to high (AT&D1 should be set first). The module will return OK after switching to command mode. 4.1.1.2. Use Sequence +++ to Switch from Data Mode to Command Mode After the PPP connection is successfully established, you can also switch the USB/UART port from data mode to command mode by inputting +++. To prevent the +++ escape sequence from being misinterpreted as data, the following requirements should be followed: a) Do not input any character for at least 1 s before and after inputting +++. b) Input +++ within 1 s, and wait until OK is returned. After OK is returned, the module switches to command mode. BG95&BG77&BG600L_Series_PPP_Application_Note 12 / 24 LPWA Module Series NOTE Perform the above operations after completing the PPP negotiation, otherwise the above operations will terminate the PPP negotiation and the USB/UART port will exit the data mode. Once the PPP negotiation is completed, when the USB/UART port switches to the command mode, the input data are treated as AT commands, and the module maintains the PPP connection. 4.1.2. Switch from Command Mode to Data Mode 4.1.2.1. Use ATO to Switch from Command Mode to Data Mode You can execute ATO (see document [1] for details) to switch the USB/UART port from command mode to data mode after the PPP connection has been established. Example //When PPP connection exists, and USB/UART port is in command mode. ATO CONNECT 150000000 //Indicates that the module has entered data mode, and all data inputted from USB/UART port are treated as PPP frames. 4.2. Handle URC in Data Mode The URC for incoming calls and short messages in data mode will not be reported to the PPP dial-up port during PPP connection. However, the level of module’s MAIN_RI pin will change from high to low for 120 ms as an indication of URC for incoming calls and short messages. The MCU can switch the port to command mode according to the MAIN_RI pin status to process incoming calls or short message. After switching to command mode, the URC will be reported to the PPP dial-up port if there are incoming calls or text messages. 4.3. Data Carrier Detection (DCD) Mode DCD mode is determined by AT&C (see document [1] for details). If AT&C0 is executed, the MAIN_DCD pin will not be used to indicate the data carrier status. While executing AT&C1, the MAIN_DCD pin will be used to indicate the data carrier status. The pin will remain at low level when there is a data carrier or PPP negotiation begins, otherwise it will remain at high level. BG95&BG77&BG600L_Series_PPP_Application_Note 13 / 24 LPWA Module Series NOTE When switching module’s USB/UART port from data mode to command mode, the MAIN_DCD pin state remains unchanged. BG95&BG77&BG600L_Series_PPP_Application_Note 14 / 24 LPWA Module Series 5 PPP Connection Termination There are two methods to terminate the PPP dial-up connection: 1. Terminate the PPP connection with the LCP Terminate-Request message (the recommended method). 2. The module can also terminate the PPP connection by changing the MAIN_DTR pin level. First, set the DTR function with AT&D2 when the USB/UART port is still in command mode before PPP connection is established. Then, change the MAIN_DTR pin level from low to high to automatically terminate the data connection. After the PPP connection is terminated, the USB/UART port enters the command mode. Example is presented below: Example //USB/UART port is in command mode before PPP connection is established. AT&D2 OK NOTE PPP connection termination procedures can be performed at any time during the PPP setup or connection establishment process. BG95&BG77&BG600L_Series_PPP_Application_Note 15 / 24 LPWA Module Series 6 PPP Dial-up Operations This chapter explains how to establish a PPP dial-up connection in Windows 10. For detailed operation in Linux operating system, see document [2]. 6.1. Preparation It is necessary to finish the following steps before establishing a PPP dial-up connection in Windows. 1. Connect the module to a PC and enter the PIN code if the (U)SIM card PIN is locked. 2. Make sure the (U)SIM card can successfully register on LTE Cat M1, LTE Cat NB2 or GPRS network. 6.2. PPP Dial-up Network Configuration 6.2.1. Add a New Dial-up Connection If no Windows Dial-up is set up, a new dial-up connection needs to be added to the 'Network & Internet' section in Windows Settings. Click 'Start' → 'Settings' → 'Network & Internet' → 'Dial-up' → 'Set up a new connection' → 'Connect to the Internet' consequently. Click 'Next' and choose 'Dial-up' in the interface to add a new dial-up as shown in figures below. BG95&BG77&BG600L_Series_PPP_Application_Note 16 / 24 LPWA Module Series Figure 4: Select 'Network & Internet' in Windows Settings Figure 5: Set up a New PPP Connection BG95&BG77&BG600L_Series_PPP_Application_Note 17 / 24 LPWA Module Series Figure 6: Connect Using Dial-up BG95&BG77&BG600L_Series_PPP_Application_Note 18 / 24 LPWA Module Series 6.2.2. Create the Connection Enter number (e.g., *99#) in 'dial-up phone number', and then click 'Create' button, as illustrated below. Figure 7: Create the Connection BG95&BG77&BG600L_Series_PPP_Application_Note 19 / 24 After that, the interface displays 'Connecting to Dial-up Connection'. LPWA Module Series Figure 8: Connecting to Dial-up Connection And then it displays 'The connection to the Internet is ready to use' if the connection is successful. Figure 9: The Connection to the Internet is Ready to Use BG95&BG77&BG600L_Series_PPP_Application_Note 20 / 24 LPWA Module Series 6.2.3. Configure the Dial-up Tool If the Windows dial-up has been set up, you can configure its properties with the following steps. 1. Click 'Start' → 'Settings' → 'Network & Internet' → 'Dial-up' → 'Connect'. 2. Click 'Properties' button from the popup window. 3. Click 'Configure…' button to configure the 'Modem – Quectel USB Modem (COM5)'. 4. Select '115200' from the 'Maximum speed' drop-down list. Click 'OK' button to finish the configuration. See the figure below for more information. Figure 10: Configure the Dial-up Tool 6.2.4. Establish Dial-up Connection After the above operations, click the 'Dial' button from 'Connect Dial-up Connection' pop-up window and the interface will pop up a prompt box 'Registering your computer on the network'. Wait for the computer to register on the network successfully. See the figure below for more information. BG95&BG77&BG600L_Series_PPP_Application_Note 21 / 24 LPWA Module Series Figure 11: Establish Dial-up Connection BG95&BG77&BG600L_Series_PPP_Application_Note 22 / 24 LPWA Module Series 7 Appendix References Table 2: Related Documents Document Name [1] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual [2] Quectel_WCDMA&LTE_Linux_USB_Driver_User_Guide [3] Quectel_BG95_Series_Hardware_Design [4] Quectel_BG77_Hardware_Design [5] Quectel_BG600L-M3_Hardware_Design Table 3: Terms and Abbreviations Abbreviation APN CHAP CTS DCD DTR EGPRS GPRS HTTP(S) IP LCP LPWA Description Access Point Name Challenge Handshake Authentication Protocol Clear To Send Data Carrier Detection Data Terminal Ready Enhanced General Packet Radio Service General Packet Radio Service Hypertext Transfer Protocol Secure Internet Protocol Link Control Protocol Low Power Wide Area BG95&BG77&BG600L_Series_PPP_Application_Note 23 / 24 LTE MCU PAP PIN PPP RI RTS RXD TA TCP TE TXD UART USB (U)SIM Wi-Fi LPWA Module Series Long-Term Evolution Micro Control Unit Password Authentication Protocol Personal Identification Number Point-to-Point Protocol Ring Indicator Request to Send Receive Data (Pin) Terminal Adapter Transmission Control Protocol Terminal Equipment Transmit Data (Pin) Universal Asynchronous Receiver Transmitter Universal Serial Bus (Universal) Subscriber Identity Module Wireless Fidelity BG95&BG77&BG600L_Series_PPP_Application_Note 24 / 24

BC25&BC32 OneNET 应用指导 NB-IoT 模块系列 版本：1.1 日期：2021-08-16 状态：受控文件 BC25&BC32 OneNET 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 45 BC25&BC32 OneNET 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 1.0 2019-10-01 Albert ZHANG 初始版本 1. 更新 AT 命令说明及 AT 示例声明（第 3.1 章、第 3.2 章）； 1.1 2021-08-16 Jack QIAN 2. 更新 AT+MIPLCONFIG 命令，添加接收写入数据的输出格 式参数说明（第 3.3.1 章）。 上海移远通信技术股份有限公司 2 / 45 BC25&BC32 OneNET 应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................3 表格索引 ..................................................................................................................................................... 5 1 引言.....................................................................................................................................................6 2 OneNET 数据交互机制........................................................................................................................7 3 OneNET 相关 AT 命令 ........................................................................................................................8 3.1. AT 命令说明..............................................................................................................................8 3.1.1. 定义 ...............................................................................................................................8 3.1.2. AT 命令语句 ..................................................................................................................8 3.2. AT 示例声明..............................................................................................................................9 3.3. OneNET 相关 AT 命令详解 .......................................................................................................9 3.3.1. AT+MIPLCONFIG OneNET 接入配置 .........................................................................9 3.3.2. AT+MIPLCREATE 创建 OneNET 通信套件实例........................................................ 11 3.3.3. AT+MIPLDELETE 删除 OneNET 通信套件实例 ........................................................ 11 3.3.4. AT+MIPLVER 查询当前 OneNET SDK 版本..............................................................12 3.3.5. AT+MIPLADDOBJ 添加 LwM2M 对象 .......................................................................12 3.3.6. AT+MIPLDELOBJ 删除 LwM2M 对象........................................................................13 3.3.7. AT+MIPLOPEN 发送注册请求...................................................................................14 3.3.8. AT+MIPLCLOSE 发送注销请求.................................................................................15 3.3.9. AT+MIPLDISCOVERRSP 响应发现资源请求............................................................15 3.3.10. AT+MIPLOBSERVERSP 响应订阅请求 ....................................................................16 3.3.11. AT+MIPLREADRSP 响应读取请求............................................................................17 3.3.12. AT+MIPLWRITERSP 响应写入请求 ..........................................................................19 3.3.13. AT+MIPLEXECUTERSP 响应执行请求.....................................................................20 3.3.14. AT+MIPLPARAMETERRSP 响应写属性请求 ............................................................21 3.3.15. AT+MIPLNOTIFY 向 OneNET 平台或应用服务器上报数据 .......................................22 3.3.16. AT+MIPLUPDATE 发送更新请求...............................................................................23 4 OneNET 相关 URC ...........................................................................................................................25 4.1. +MIPLDISCOVER 通知 TE 响应发现资源请求的 URC ........................................................25 4.2. +MIPLOBSERVE 通知 TE 响应订阅请求的 URC .................................................................26 4.3. +MIPLREAD 通知 TE 响应读取请求的 URC ........................................................................26 4.4. +MIPLWRITE 通知 TE 响应写入请求的 URC .......................................................................27 4.5. +MIPLEXECUTE 通知 TE 响应执行请求的 URC .................................................................28 4.6. +MIPLPARAMETER 通知 TE 响应写属性请求的 URC.........................................................29 4.7. +MIPLEVENT 通知 TE 关于事件的 URC .............................................................................29 5 举例...................................................................................................................................................31 5.1. 接入配置 .................................................................................................................................31 5.2. 注册及发现资源操作 ...............................................................................................................32 5.2.1. 注册及发现资源操作（平台端设置关闭自动订阅） ......................................................32 上海移远通信技术股份有限公司 3 / 45 BC25&BC32 OneNET 应用指导 5.2.2. 注册及发现资源操作（平台端设置开启自动订阅） ......................................................33 5.2.3. 注册及发现资源操作（模块深度睡眠唤醒保存参数和状态）........................................34 5.3. 读取操作 .................................................................................................................................36 5.3.1. 读取资源 ......................................................................................................................36 5.3.2. 读取实例 ......................................................................................................................36 5.3.3. 读取对象 ......................................................................................................................37 5.4. 写入操作 .................................................................................................................................37 5.4.1. 写入资源 ......................................................................................................................37 5.4.2. 写入实例 ......................................................................................................................38 5.5. 执行操作 .................................................................................................................................38 5.6. 写属性操作 .............................................................................................................................38 5.7. 订阅操作 .................................................................................................................................39 5.8. 上报数据操作..........................................................................................................................39 5.8.1. 上报资源数据 ...............................................................................................................39 5.8.2. 上报实例数据 ...............................................................................................................39 5.8.3. 上报对象数据 ...............................................................................................................40 5.8.4. 使用上报资源数据 ...........................................................................................40 5.8.5. 使用上报实例数据 ...........................................................................................41 5.9. 更新操作 .................................................................................................................................41 5.9.1. 更新操作（不自动更新生命周期） ...............................................................................41 5.9.2. 更新操作（自动更新生命周期）...................................................................................42 6 错误码 ...............................................................................................................................................43 7 附录 A 参考文档及术语缩写 ..............................................................................................................45 上海移远通信技术股份有限公司 4 / 45 BC25&BC32 OneNET 应用指导 表格索引 表 1：AT 命令类型..................................................................................................................................... 8 表 2：OneNET 相关 URC........................................................................................................................ 25 表 3：通用错误（27.007）...................................................................................................................... 43 表 4：通用错误（27.005）...................................................................................................................... 43 表 5：参考文档........................................................................................................................................ 45 表 6：术语缩写........................................................................................................................................ 45 上海移远通信技术股份有限公司 5 / 45 BC25&BC32 OneNET 应用指导 1 引言 LwM2M（轻量级机器对机器技术）是一种安全、高效、易部署的客户端-服务器协议，适用于不同网络 环境下资源有限的终端设备管理。LwM2M 基于 REST（表述性状态转移），采用现代架构设计，定义了一 个可扩展资源和数据模型，其消息传递是通过 CoAP（受限应用协议）这一高效安全的数据传输协议达成的。 依据 CoAP 协议（RFC 7252），LwM2M 提供了轻量紧凑安全的通信接口以及高效的数据模型，帮助实现 M2M 设备的管理与服务使能。 本文档主要介绍如何将应用了移远通信 BC25 模块和 BC32 模块的设备连接到中国移动 OneNET 物联 网开放平台（以下简称 OneNET），并通过 LwM2M 实现相关功能。 上海移远通信技术股份有限公司 6 / 45 BC25&BC32 OneNET 应用指导 2 OneNET 数据交互机制 本章节主要介绍 OneNET 数据交互机制。 终端设备 用户设备 OneNET平台 应用服务器 AT+CGPADDR? AT+MIPLCREATE AT+MIPLADDOBJ=... AT+MIPLOPEN=... URC: +MIPLEVENT: ... 10s URC: +MIPLDISCOVER: ... 超时 AT+MIPLDISCOVERRSP=... 10s URC: +MIPLPARAMETER: ... 超时 AT+MIPLPARAMETERRSP=... 10s URC: +MIPLOBSERVE: ... 超时 AT+MIPLOBSERVERSP=... 10s URC: +MIPLREAD: ... 超时 AT+MIPLREADRSP=... 10s URC: +MIPLWRITE: ... 超时 AT+MIPLWRITERSP=... 10s URC: +MIPLEXECUTE: ... 超时 AT+MIPLEXECUTERSP=... 注册请求 响应 发送发现资源请求 响应 发送写属性请求 响应 发送订阅请求 响应 发送读取请求 响应 发送写入请求 响应 发送执行请求 响应 AT+MIPLNOTIFY=... AT+MIPLUPDATE=... URC: +MIPLEVENT: ... AT+MIPLCLOSE= URC: +MIPLEVENT: ... AT+MIPLDELOBJ=... AT+MIPLDELETE= 通知OneNET平台 发送Update请求 响应 Deregister请求 响应 注册 操作 发送写属性请求 响应 发送订阅请求 响应 发送读取请求 响应 发送写入请求 响应 发送执行请求 响应 Notify the server Discover 操作 WriteAttributes 操作 Observe 操作 Read 操作 Write 操作 Execute 操作 Notify 操作 Update 操作 Deregister 操作 图 1：OneNET 数据交互示意图 上海移远通信技术股份有限公司 7 / 45 BC25&BC32 OneNET 应用指导 3 OneNET 相关 AT 命令 本章节主要展示说明操作 OneNET 功能的 AT 命令。 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 45 BC25&BC32 OneNET 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见，也不 代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或连续 性。 3.3. OneNET 相关 AT 命令详解 3.3.1. AT+MIPLCONFIG OneNET 接入配置 此命令用来配置 Bootstrap（引导接口）模式和引导服务器地址或者 LwM2M 服务器地址，也可以用于 设置 CoAP 协议中的 ACK_TIMEOUT。CoAP 协议中最大传输等待时间 MAX_TRANSMIT_WAIT 等于 ACK_TIMEOUT * ((2(4 + 1)) - 1)。此命令还可以用来配置是否自动响应 OneNET 平台或者应用服务器的订 阅请求、存活周期即将到期时是否会自动更新，以及是否使能 OneNET 深睡眠唤醒保存参数和状态功能。 若不进行配置，参数将为默认值。相关值的说明，请参考第 6 章。 AT+MIPLCONFIG OneNET 接入配置 测试命令 AT+MIPLCONFIG=? 响应 +MIPLCONFIG: ,[,] 查询命令 AT+MIPLCONFIG? OK 响应 +MIPLCONFIG: ,, +MIPLCONFIG: , +MIPLCONFIG: , +MIPLCONFIG: ,, +MIPLCONFIG: , OK 若出现任何错误： ERROR 或 +CME ERROR: 设置命令 响应 AT+MIPLCONFIG=,[,] 若出现任何错误： ERROR 或 上海移远通信技术股份有限公司 9 / 45 最大响应时间 特性说明 BC25&BC32 OneNET 应用指导 +CME ERROR: 300 毫秒 参见备注。 参数 模式选项。 0 禁用 Bootstrap，并配置 LwM2M 服务器 IP 地址和端口 1 使能 Bootstrap，并配置 Bootstrap 服务器 IP 地址和端口，Bootstrap 服务器默 认地址为 183.230.40.39:5683 2 设置 CoAP 协议的参数 ACK_TIMEOUT 3 设置是否使能模块自动响应订阅请求 4 设置是否使能在存活周期即将到期时，自动更新存活周期；以及模块连接 OneNET 后进入深度睡眠再唤醒时是否保存已配置参数和状态功能 5 设置接收写入数据的输出格式 0 1 2 1 3 - 4 5 - 当=0，此参数为 LwM2M 服务器 IP 地址 当=1，此参数为 Bootstrap 服务器 IP 地址 当=0，此参数为 LwM2M 服务器端口 当=1，此参数为 Bootstrap 服务器端口 范围：1000-65535。 整型。ACK_TIMEOUT 的值，范围：2~20，单位：秒，默认值：2。 整型。是否使能模块自动响应订阅请求。 0 禁止自动响应 1 使能自动响应，即 TE 不需要通过命令 AT+MIPLOBSERVERSP 响应订阅请求 整型。是否使能在存活周期即将到期时，自动更新存活周期 0 关闭存活周期自动更新 1 使能自动更新存活周期，即当模块存活周期即将到期并上报 '+MIPLEVENT,14,'时，模块会自动更新存活周期 整型。模块连接 OneNET 后进入深度睡眠是否保存已配置参数和状态功能 0 关闭保存参数和状态功能 1 使能保存参数和状态功能 整型。接收写入数据的输出模式。 0 十六进制字符串格式 1 字符串格式 上海移远通信技术股份有限公司 10 / 45 BC25&BC32 OneNET 应用指导 备注 1. 需要在通过命令 AT+MIPLCREATE 创建通信实例之前使用此命令； 2. 参数和在设置后会被自动保存到 NVM 中； 3. 当=1 时，模块成功注册到 OneNET 平台后进入深度睡眠，会自动保存相关状态和参 数，被唤醒后模块从 NVM 读取相关状态和参数并恢复注册，此时无需手动进行 OneNET 重新连接 动作，可直接与 OneNET 平台和应用服务器进行交互。 4. 此命令的参数配置后不会立刻保存到 NVM 中（和除外），只有当参数 =1，且模块进入深度睡眠时才会保存。模块重启后参数会恢复到默认值。 3.3.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 此命令用来创建 OneNET 通信套件。相关值的说明，请参考第 6 章。 AT+MIPLCREATE 创建 OneNET 通信套件实例 执行命令 响应 AT+MIPLCREATE +MIPLCREATE: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效。 参数 OneNET 通信套件的实例 ID。 3.3.3. AT+MIPLDELETE 删除 OneNET 通信套件实例 此命令用来删除 OneNET 通信套件中的实例。相关值的说明，请参考第 6 章。 AT+MIPLDELETE 删除 OneNET 通信套件实例 测试命令 响应 AT+MIPLDELETE=? +MIPLDELETE: OK 上海移远通信技术股份有限公司 11 / 45 设置命令 AT+MIPLDELETE= 最大响应时间 特性说明 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 3秒 / BC25&BC32 OneNET 应用指导 参数 OneNET 通信套件的实例 ID。 3.3.4. AT+MIPLVER 查询当前 OneNET SDK 版本 此命令用来查询 OneNET SDK 版本。 AT+MIPLVER 查询命令 AT+MIPLVER? 查询当前 OneNET SDK 版本 响应 +MIPLVER: 最大响应时间 特性说明 OK 300 毫秒 / 参数 当前 OneNET SDK 版本。 3.3.5. AT+MIPLADDOBJ 添加 LwM2M 对象 此命令用来添加 LwM2M 对象。相关值的说明，请参考第 6 章。 AT+MIPLADDOBJ 添加 LwM2M 对象 测试命令 响应 AT+MIPLADDOBJ=? +MIPLADDOBJ: ,,,, , 上海移远通信技术股份有限公司 12 / 45 BC25&BC32 OneNET 应用指导 设置命令 AT+MIPLADDOBJ=,,,,, OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 LwM2M 对象 ID，若对象 ID 不存在，则返回错误。 实例数量。 实例位图，字符串型，需标注双引号。例如，若共有 4 个实例，ID 分别为 0、1、2、 3，那么值为 4，同时='1101' 表示实例 ID 0、1、3 将被 注册，而实例 ID 2 不会被注册。 属性个数，表示可读和/或可写资源个数。 动作个数，表示可执行的资源个数。 备注 1. 字符串的长度需要和数量保持一致。 2. 实际注册的实例个数由决定，而非。 3.3.6. AT+MIPLDELOBJ 删除 LwM2M 对象 此命令用来删除 LwM2M 对象。相关值的说明，请参考第 6 章。 AT+MIPLDELOBJ 删除 LwM2M 对象 测试命令 响应 AT+MIPLDELOBJ=? +MIPLDELOBJ: , 设置命令 AT+MIPLDELOBJ=, OK 响应 OK 上海移远通信技术股份有限公司 13 / 45 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效。 BC25&BC32 OneNET 应用指导 参数 OneNET 通信套件的实例 ID。 LwM2M 对象 ID，若对象 ID 不存在，则返回错误。 3.3.7. AT+MIPLOPEN 发送注册请求 此命令用来向 OneNET 平台发送注册请求。相关值的说明，请参考第 6 章。 AT+MIPLOPEN 发送注册请求 测试命令 AT+MIPLOPEN=? 响应 +MIPLOPEN: ,[,] 设置命令 AT+MIPLOPEN=,[,] 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 参该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 整型。设备存活周期，范围：16~268435454。单位：秒。 整型。注册超时时间，范围：30~65535。默认值：60；单位：秒。 上海移远通信技术股份有限公司 14 / 45 BC25&BC32 OneNET 应用指导 备注 在执行 AT+MIPLOPEN 后，如果由于网络或者相关配置问题出现 bootstrap 失败（+MIPLEVENT: 0,3） 或者注册失败（+MIPLEVENT: 0,7），模块会重新进行 bootstrap 和注册，如果连续三次尝试均失败，模 块便放弃此次注册请求动作，此时需要检查网络和相关配置，确认无问题后，重新执行 AT+MIPLOPEN。 3.3.8. AT+MIPLCLOSE 发送注销请求 此命令用来向 OneNET 平台发送注销请求。相关值的说明，请参考第 6 章。 AT+MIPLCLOSE 发送注销请求 测试命令 AT+MIPLCLOSE=? 响应 +MIPLCLOSE: 设置命令 AT+MIPLCLOSE= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 3秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 3.3.9. AT+MIPLDISCOVERRSP 响应发现资源请求 此命令用来响应来自 OneNET 平台的发现资源请求。相关值的说明，请参考第 6 章。 AT+MIPLDISCOVERRSP 响应发现资源请求 测试命令 响应 AT+MIPLDISCOVERRSP=? +MIPLDISCOVERRSP: ,,[,, [,]] 设置命令 OK 响应 上海移远通信技术股份有限公司 15 / 45 BC25&BC32 OneNET 应用指导 AT+MIPLDISCOVERRSP=,,[,,[ ,]] OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLDISCOVER'中获取。 发现资源结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示结果正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方式不允许） 15 4.06 Not acceptable（未接受） 参数的长度。 字符串类型（需标记双引号），包含对象的属性。每个属性之间用分号隔开，例如： '1101;1102;1103'，属性的个数不应超过命令 AT+MIPLADDOBJ 的和 参数值的总和。 整型。用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放 辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 3.3.10. AT+MIPLOBSERVERSP 响应订阅请求 当自动响应订阅请求功能被禁用后，此命令用来手动响应 OneNET 平台或应用服务器发来的订阅请求。 相关值的说明，请参考第 6 章。 AT+MIPLOBSERVERSP 响应订阅请求 测试命令 响应 AT+MIPLOBSERVERSP=? +MIPLOBSERVERSP: ,,[,] OK 上海移远通信技术股份有限公司 16 / 45 BC25&BC32 OneNET 应用指导 设置命令 AT+MIPLOBSERVERSP=,,[,] 最大响应时间 特性说明 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 数据包 消息 ID，由 URC'+MIPLOBSERVE'中获取。 订阅结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示结果正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方式不允许） 15 4.06 Not acceptable（未接受） 整型。用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放 辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 3.3.11. AT+MIPLREADRSP 响应读取请求 此命令用来响应从 OneNET 平台或者应用服务器发来的读取请求。相关值的说明，请参考第 6 章。 AT+MIPLREADRSP 响应读取请求 测试命令 响应 AT+MIPLREADRSP=? +MIPLREADRSP: ,,[,,,,,,,,[,]] 设置命令 AT+MIPLREADRSP=,,< OK 响应 OK 上海移远通信技术股份有限公司 17 / 45 BC25&BC32 OneNET 应用指导 result>[,,,,,,,,[,]] 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLREAD'中获取。 读取结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示结果正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方式不允许） 15 4.06 Not acceptable（未接受） 对象 ID，由 URC'+MIPLREAD'中获取。 实例 ID，由 URC'+MIPLREAD'中获取。 资源 ID，由 URC'+MIPLREAD'中获取。 值的类型。 1 String（字符串类型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 值的长度，单位：字节。 当=1 时，该参数值为字符串型数据的长度 当=2 时，该参数值为十六进制数据的长度 当=3 时，该参数值可以是 2、4 或 8 当=4 时，该参数值只能是 4 当=5 时，该参数值为 1 数据。 当=1 时，该参数值为字符串型格式，由双引号标记 当=2 时，该参数值为十六进制格式 当=3 时，该参数值为整数型格式 当=4 时，该参数值为浮点型格式 当=5 时，该参数值为布尔型格式 消息序号。如果读请求响应由多个消息组成，则需发送多条 AT 来响应。例如，若被分 上海移远通信技术股份有限公司 18 / 45 BC25&BC32 OneNET 应用指导 成了 N 个部分，则参数需从 N-1 到 0 递减，AT 命令也按照从大到小的顺序执 行。=0 表示这是数据中最后一条消息。 整型。消息指示，范围：0~2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 目前软件版本仅支持=0。 整型。用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放 辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 备注 1. 此命令作为对读取请求的响应。 2. 若=2，十六进制值字符的个数为 2*；若=4，浮点型数据的长度建议 为 4 个字节，且参数的值应为 4。 3.3.12. AT+MIPLWRITERSP 响应写入请求 此命令用来响应来自 OneNE 平台或者应用服务器的写入请求。相关值的说明，请参考第 6 章。 AT+MIPLWRITERSP 响应写入请求 测试命令 响应 AT+MIPLWRITERSP=? +MIPLWRITERSP: ,,[,] 设置命令 AT+MIPLWRITERSP=,, [,] 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 上海移远通信技术股份有限公司 19 / 45 BC25&BC32 OneNET 应用指导 数据包消息 ID，由 URC'+MIPLWRITE'中获取。 写入结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示正确结果 11 4.00 无效请求（Bad request） 12 4.01 未授权（Unauthorized） 13 4.04 未找到（Not found） 14 4.05 方式不允许（Method not allowed） 整型。用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放 辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 3.3.13. AT+MIPLEXECUTERSP 响应执行请求 此命令用来响应来自 OneNET 平台或应用服务器的执行请求。相关值的说明，请参考第 6 章。 AT+MIPLEXECUTERSP 响应执行请求 测试命令 响应 AT+MIPLEXECUTERSP=? +MIPLEXECUTERSP: ,,[,] 设置命令 AT+MIPLEXECUTERSP=,,[,] 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLEXECUTE'中获取。 执行结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示正确结果 11 4.00 无效请求（Bad request） 上海移远通信技术股份有限公司 20 / 45 BC25&BC32 OneNET 应用指导 12 4.01 未授权（Unauthorized） 13 4.04 未找到（Not found） 14 4.05 方式不允许（Method not allowed） 整型。用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放 辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 3.3.14. AT+MIPLPARAMETERRSP 响应写属性请求 此命令用来响应来自 OneNET 平台和应用服务器的写属性请求。相关值的说明，请参考第 6 章。 AT+MIPLPARAMETERRSP 响应写属性请求 测试命令 响应 AT+MIPLPARAMETERRSP=? +MIPLPARAMETERRSP: ,,[,] 设置命令 AT+MIPLPARAMETERRSP=,,[,] 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLPARAMETER'中获取。 写属性操作结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示正确结果 11 4.00 无效请求（Bad request） 12 4.01 未授权（Unauthorized） 13 4.04 未找到（Not found） 14 4.05 方式不允许（Method not allowed） 整型。用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放 上海移远通信技术股份有限公司 21 / 45 BC25&BC32 OneNET 应用指导 辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在下发后立即释放 3.3.15. AT+MIPLNOTIFY 向 OneNET 平台或应用服务器上报数据 此命令用来向 OneNET 平台或应用服务器上报数据。相关值的说明，请参考第 6 章。 AT+MIPLNOTIFY 向 OneNET 或应用服务器发送数据 测试命令 响应 AT+MIPLNOTIFY=? +MIPLNOTIFY: ,,,,,,,,[,[,]] 设置命令 AT+MIPLNOTIFY=,,,,,,,,,[,[, ]] OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 消息 ID，由 URC'+MIPLOBSERVE'中获取。 对象 ID，若对象 ID 不存在将返回错误。 实例 ID，由 URC'+MIPLOBSERVE'中获取。 资源 ID，由 URC'+MIPLOBSERVE'中获取。 值的类型。 1 String（字符串型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 值的长度，单位：字节。 当=1 时，该参数值为字符串型数据的长度 上海移远通信技术股份有限公司 22 / 45 BC25&BC32 OneNET 应用指导 当=2 时，该参数值为十六进制数据的长度 当=3 时，该参数值可以是 2、4 或者 8 当=4 时，该参数值只能是 4 当=5 时，该参数值为 1 数据。 当=1 时，该参数值为字符串型格式，应该由双引号标记 当=2 时，该参数值为十六进制格式 当=3 时，该参数值为整数型格式 当=4 时，该参数值为浮点型格式 当=5 是，该参数值为布尔型格式 消息序号。如果读请求响应由多个消息组成，则需发送多条 AT 来响应。若被分成了 N 个部分，则参数需从 N-1 到 0 递减，AT 命令也按照从大到小的顺序执行。 =0 表示这是数据中最后一条消息。 整型。消息指示，范围：0~2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 该版本仅支持=0。 整型。范围：0~65535。 0 数据以 Non-confirmable（不需要确认）消息格式发送，即 NON 数据 1~65535 数据以 Confirmable（需要确认）消息格式发送，即 CON 数据，且消息发 送结果在上报的'+MIPLEVENT'URC 中 整型。用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放 辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在下发后立即释放 备注 1. 若=2，十六进制值字符的个数为 2*；若=4，浮点型数据的长度建 议为 4 个字节，且参数的值为 4。 2. 对于需要 AT+MIPLNOTIFY 命令指示核心网快速释放 RRC 连接的场景，上报 CON 数据时， 建议值为 2，上报 NON 数据时，建议值为 1。 3.3.16. AT+MIPLUPDATE 发送更新请求 此命令用来发送更新请求，以更新使用期限和对象列表。相关值的说明，请参考第 6 章。 AT+MIPLUPDATE 发送更新请求 测试命令 响应 AT+MIPLUPDATE=? +MIPLUPDATE: ,,[,] 上海移远通信技术股份有限公司 23 / 45 BC25&BC32 OneNET 应用指导 设置命令 AT+MIPLUPDATE=,, [,] OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 OneNET 通信套件的实例 ID。 整型。设备存活周期。范围：0 或 16-268435454。单位：秒。0 表示该使用期限是 86400 秒。 整型。是否更新对象列表。 0 不使用 1 使用 整型。用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在下发后立即 释放 备注 对于需要 AT+MIPLUPDATE 命令指示核心网快速释放 RRC 连接的场景，建议值为 2。 AT+MIPLUPDATE 命令，不存在为 1 的场景，因此不建议设置为 1。 上海移远通信技术股份有限公司 24 / 45 BC25&BC32 OneNET 应用指导 4 OneNET 相关 URC 本章节主要描述与 OneNET 相关的一系列 URC 及其描述。 表 2：OneNET 相关 URC 编号 URC 描述 [1] +MIPLDISCOVER: ,, 当 OneNET 平台发送了一个发现资源请求，模 块接收到请求后会上报该 URC。 +MIPLOBSERVE: ,,,,, 阅请求，模块接收到请求后会立即上报该 URC。 +MIPLREAD: ,,,, 取请求，模块接收到请求后会上报该 URC。 +MIPLWRITE: ,,,,,,,,, +MIPLEXECUTE: ,,,,[,,] 行请求，模块接收到请求后会上报该 URC。 +MIPLPARAMETER: ,,, 当 OneNET 平台或者应用服务器发送了一个写 [6] ,,, 属性请求，模块接收到请求后会上报该 URC。 [7] +MIPLEVENT: ,[,][,] 4.1. +MIPLDISCOVER 通知 TE 响应发现资源请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 发来的发现资源请求。该 URC 完全输出以后，TE 应在 10 秒 内通过命令 AT+MIPLDISCOVERRSP 响应请求。 +MIPLDISCOVER 通知 TE 响应发现资源请求的 URC URC 格式 +MIPLDISCOVER: ,, 通知 TE 响应 OneNET 发来的发现资源请求 上海移远通信技术股份有限公司 25 / 45 参数 BC25&BC32 OneNET 应用指导 OneNET 通信套件的实例 ID。 数据包消息 ID。 资源发现请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 4.2. +MIPLOBSERVE 通知 TE 响应订阅请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 或者应用服务器发来的订阅请求。若禁用了自动响应订阅请求， 该 URC 完全输出以后，TE 应在 10 秒内通过命令 AT+MIPLOBSERVERSP 响应请求。 +MIPLOBSERVE 通知 TE 响应订阅请求的 URC URC 格式 +MIPLOBSERVE: ,,,,, 通知 TE 响应 OneNET 或者应用服务器发来的订阅请求。 参数 OneNET 通信套件的实例 ID。 数据包消息 ID。 整型。表示是否订阅 0 取消订阅 1 订阅 订阅请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 订阅请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示订阅或者取 消订阅该对象 ID 下所有实例的所有资源。 订阅请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示订阅或者取 消订阅该实例下的所有资源。 4.3. +MIPLREAD 通知 TE 响应读取请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 平台或者应用服务器发来的读取请求。该 URC 完全输出以后， TE 应在 10 秒内通过命令 AT+MIPLREADRSP 响应请求。 +MIPLREAD 通知 TE 响应读取请求的 URC URC 格式 +MIPLREAD: ,,,, 通知 TE 响应 OneNET 平台或者应用服务器发来的读取请求。 上海移远通信技术股份有限公司 26 / 45 参数 BC25&BC32 OneNET 应用指导 OneNET 通信套件的实例 ID。 数据包消息 ID。 读取请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 读取请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示读取该对象 下的所有资源。 读取请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示读取该实例 下的所有资源。 4.4. +MIPLWRITE 通知 TE 响应写入请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 平台或者应用服务器发来的写入请求。该 URC 完全输出以后， TE 应在 10 秒内通过命令 AT+MIPLWRITERSP 响应请求。 +MIPLWRITE 通知 TE 响应写入请求的 URC URC 格式 +MIPLWRITE: ,,,,,,,,, 通知 TE 响应 OneNET 平台或者应用服务器发来的写入请求。 参数 OneNET 通信套件的实例 ID。 数据包消息 ID。 写入请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 写入请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的。 写入请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的。 值的类型（当前仅显示不透明型）。 1 String（字符串型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 值的长度，单位：字节。 当=1 时，该参数值为字符串型数据的长度 当=2 时，该参数值为十六进制数据的长度 当=3 时，该参数值可以是 2、4 或者 8 当=4 时，改参数只能是 4 当=5 时，该参数值为 1 上海移远通信技术股份有限公司 27 / 45 BC25&BC32 OneNET 应用指导 数据值，从 OneNET 平台或者应用服务器处接收到的十六进制格式数据。 消息指示，范围：0-2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 该版本仅支持=0。 消息序号。如果读请求响应由多个消息组成，则需发送多条 AT 来响应。例如，若被分 成了 N 个部分，则参数需从 N-1 到 0 递减，AT 命令也按照从大到小的顺序执 行。=0 表示这是数据中最后一条消息。 备注 应用服务器发送的写入请求中数据长度应小于 1000 字节，否则可能会失败。 4.5. +MIPLEXECUTE 通知 TE 响应执行请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 平台或者应用服务器发来的执行请求。该 URC 完全输出以后， TE 应在 10 秒内通过命令 AT+MIPLEXECUTERSP 响应请求。 +MIPLEXECUTE 通知 TE 响应执行请求的 URC URC 格式 +MIPLEXECUTE: ,,,,[,,] 通知 TE 响应 OneNET 平台或者应用服务器发来的执行请 求。 Parameter OneNET 通信套件的实例 ID。 数据包消息 ID。 执行请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 执行请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的。 执行请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的。 表示参数的长度，单位：字节 字符串型，执行操作中的 Arguments 对象。 上海移远通信技术股份有限公司 28 / 45 BC25&BC32 OneNET 应用指导 4.6. +MIPLPARAMETER 通知 TE 响应写属性请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 平台或者应用服务器发来的写属性请求。该 URC 完全输出以 后，TE 应在 10 秒内通过命令 AT+MIPLPARAMETERRSP 响应请求。 +MIPLPARAMETER 通知 TE 响应写属性请求的 URC URC 格式 +MIPLPARAMETER: ,, ,,,, 通知 TE 响应 OneNET 平台或者应用服务器发来的写属性请求。 Parameter OneNET 通信套件的实例 ID。 数据包消息 ID。 写属性请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 写属性请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示 适用于该对象下所有资源。 写属性请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示 适用于该实例下所有资源。 表示参数的长度，单位：字节 字符串型，写属性操作中的参数。 4.7. +MIPLEVENT 通知 TE 关于事件的 URC 该 URC 主要用来向 TE 通知事件。 +MIPLEVENT 通知 TE 关于事件的 URC URC 格式 +MIPLEVENT: ,[,][,] 向 TE 通知事件。 参数 OneNET 通信套件的实例 ID。 事件标识符： 1 EVENT_BOOTSTRAP_START 2 EVENT_BOOTSTRAP_SUCCESS 3 EVENT_BOOTSTRAP_FAILED 上海移远通信技术股份有限公司 29 / 45 BC25&BC32 OneNET 应用指导 4 EVENT_CONNECT_SUCCESS 5 EVENT_CONNECT_FAILED 6 EVENT_REG_SUCCESS 7 EVENT_REG_FAILED 8 EVENT_REG_TIMEOUT 9 EVENT_LIFETIME_TIMEOUT 10 EVENT_STATUS_HALT 11 EVENT_UPDATE_SUCCESS 12 EVENT_UPDATE_FAILED 13 EVENT_UPDATE_TIMEOUT 14 EVENT_UPDATE_NEED 15 EVENT_DEREG_DONE 20 EVENT_RESPONSE_FAILED 21 EVENT_RESPONSE_SUCCESS 25 EVENT_NOTIFY_FAILED 26 EVENT_NOTIFY_SUCCESS 40 EVENT_FIRMWARE_DOWNLOADING 41 EVENT_FIRMWARE_DOWNLOAD_FAILED 42 EVENT_FIRMWARE_DOWNLOADED 43 EVENT_FIRMWARE_UPDATING 44 EVENT_FIRMWARE_UPDATE_SUCCESS 45 EVENT_FIRMWARE_UPDATE_FAILED 46 EVENT_FIRMWARE_UPDATE_OVER 47 EVENT_FIRMWARE_DOWNLOAD_DISCONNECT 48 EVENT_FIRMWARE_ERASE_SUCCESS 49 EVENT_FIRMWARE_ERASE_FAIL 扩展参数： 当=20，显示回复命令的消息 ID。 当=14，显示存活周期期限的剩余时间，单位：秒 整数型，范围：1~65535，通过 AT 命令 AT+MIPLNOTIFY 命令设置的 CON 信息的 。 上海移远通信技术股份有限公司 30 / 45 BC25&BC32 OneNET 应用指导 5 举例 本章节通过实例来解释如何使用 OneNET 相关的 AT 命令。 5.1. 接入配置 该示例演示了如何配置 Bootstrap 模式和 Bootstrap 服务器地址或者访问服务器，以及如何设置 CoAP 协议的参数 ACK_TIMEOUT。 AT+MIPLCONFIG=? +MIPLCONFIG: ,[,] OK AT+MIPLCONFIG=1,183.230.40.39,5683 OK //使能 Bootstrap 并配置 Bootstrap 服务器 IP 地址和端口 AT+MIPLCONFIG? +MIPLCONFIG: 1,183.230.40.39,5683 +MIPLCONFIG: 2,2 +MIPLCONFIG: 3,1 +MIPLCONFIG: 4,0,1 +MIPLCONFIG: 5,0 OK AT+MIPLCONFIG=0,183.230.40.40,5683 OK //禁用 Bootstrap 并配置访问服务器 IP 地址和端口 AT+MIPLCONFIG? +MIPLCONFIG: 0,183.230.40.40,5683 +MIPLCONFIG: 2,2 +MIPLCONFIG: 3,1 +MIPLCONFIG: 4,0,1 +MIPLCONFIG: 5,0 OK 上海移远通信技术股份有限公司 31 / 45 //设置参数 ACK_TIMEOUT 值为 9 秒。 AT+MIPLCONFIG=2,1,9 OK AT+MIPLCONFIG? +MIPLCONFIG: 0,183.230.40.40,5683 +MIPLCONFIG: 2,9 +MIPLCONFIG: 3,1 +MIPLCONFIG: 4,0,1 +MIPLCONFIG: 5,0 OK BC25&BC32 OneNET 应用指导 5.2. 注册及发现资源操作 5.2.1. 注册及发现资源操作（平台端设置关闭自动订阅） 在平台端设置关闭自动订阅的情况下，下面的举例中详述了注册以及发现资源操作。 //使能 Bootstrap 模式的情况下，使用单个命令创建通信套件实例 AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例 OK //添加一个 LwM2M 对象 AT+MIPLADDOBJ=0,3311,2,'11',4,2 OK //成功添加对象，并且将要注册 ID 为 0 和 1 的实例 AT+MIPLOPEN=0,600,60 OK //向 OneNET 发送注册请求 +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLDISCOVER: 0,26384,3311 //接收到发现资源请求 上海移远通信技术股份有限公司 32 / 45 BC25&BC32 OneNET 应用指导 //使用资源 ID 列表响应发现资源资源请求 AT+MIPLDISCOVERRSP=0,26384,1,19,'5850;5851;5706;5805' OK AT+MIPLDELOBJ=0,3311 OK //删除一个 LwM2M 对象 //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //注销成功 //删除通信套件实例 AT+MIPLDELETE=0 OK //成功删除通信套件实例 5.2.2. 注册及发现资源操作（平台端设置开启自动订阅） 在平台端设置开启自动订阅的情况下，下面的举例中详述了注册以及发现资源操作。 //在默认配置下使用单个命令创建通信套件实例 AT+MIPLCONFIG? +MIPLCONFIG: 1,183.230.40.39,5683 +MIPLCONFIG: 2,2 +MIPLCONFIG: 3,1 //使能模块自动响应订阅请求的功能 +MIPLCONFIG: 4,0,1 +MIPLCONFIG: 5,0 OK AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例 OK //添加一个 LwM2M 对象 AT+MIPLADDOBJ=0,3311,2,'11',4,2 OK //成功添加对象，并且将要注册 ID 为 0 和 1 的实例 //向 OneNET 发送注册请求 AT+MIPLOPEN=0,600,60 OK 上海移远通信技术股份有限公司 33 / 45 BC25&BC32 OneNET 应用指导 +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLOBSERVE: 0,78025,1,3311,0,-1 //收到订阅（3311/0）请求 +MIPLOBSERVE: 0,143562,1,3311,1,-1 //收到订阅（3311/1）请求 +MIPLDISCOVER: 0,12491,3311 //收到发现资源请求 //使用资源 ID 列表响应发现资源资源请求 AT+MIPLDISCOVERRSP=0,12491,1,19,'5850;5851;5706;5805' OK AT+MIPLDELOBJ=0,3311 OK //删除一个 LwM2M 对象 //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //注销成功 //删除通信套件实例 AT+MIPLDELETE=0 OK //成功删除通信套件实例 5.2.3. 注册及发现资源操作（模块深度睡眠唤醒保存参数和状态） 在使能模块连接 OneNET 后进入深度睡眠再唤醒时保存参数和状态功能的情况下，下面的举例中详述 了注册以及发现资源操作。 //在默认配置下使用单个命令创建通信套件实例 AT+QSCLK=0 OK //做业务前关闭模块休眠功能 AT+MIPLCONFIG? +MIPLCONFIG: 1,183.230.40.39,5683 +MIPLCONFIG: 2,2 +MIPLCONFIG: 3,1 上海移远通信技术股份有限公司 34 / 45 BC25&BC32 OneNET 应用指导 +MIPLCONFIG: 4,0,1 +MIPLCONFIG: 5,0 //使能模块深度睡眠唤醒时保存参数和状态功能 OK AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例 OK //添加一个 LwM2M 对象 AT+MIPLADDOBJ=0,3311,1,'1',4,1 OK //成功添加对象，并且将要注册 ID 为 0 的实例 //向 OneNET 发送注册请求 AT+MIPLOPEN=0,600,60 OK +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLOBSERVE: 0,126564,1,3311,0,-1 //收到订阅（3311/0）请求 +MIPLDISCOVER: 0,61029,3311 //收到发现资源请求 //使用资源 ID 列表响应发现资源资源请求 AT+MIPLDISCOVERRSP=0,61029,1,19,'5805;5850;5851;5706' OK AT+QSCLK=1 OK //业务完成后，需要时打开深度睡眠功能，等待模块进入深度睡眠 //模块进入深度睡眠 +QATSLEEP //拉低 PSM_EINT 唤醒模块 +QATWAKEUP //模块从深度睡眠被唤醒 AT+QSCLK=0 //做业务前关闭模块休眠功能，业务完成后需要模块休眠时再打开 上海移远通信技术股份有限公司 35 / 45 BC25&BC32 OneNET 应用指导 OK //模块恢复参数及状态成功，此时模块状态与进入深度睡眠前一致，可以直接上报数据与接收 OneNET 平 台和应用服务器请求 +MIPLEVENT: 0,4 AT+MIPLDELOBJ=0,3311 OK //删除一个 LwM2M 对象 //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //成功注销 //删除通信套件实例 AT+MIPLDELETE=0 OK //成功删除通信套件实例 5.3. 读取操作 5.3.1. 读取资源 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送读取资源（3311/0/5805）请求。 +MIPLREAD: 0,3123,3311,0,5805 //收到读取资源请求 AT+MIPLREADRSP=0,3123,1,3311,0,5805,4,4,1.88,0,0 OK //响应读取请求 //成功发送数据 1.88 到应用服务器 5.3.2. 读取实例 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送读取实例（3311/0）请求。 +MIPLREAD: 0,25466,3311,0,-1 //收到读取实例请求 上海移远通信技术股份有限公司 36 / 45 BC25&BC32 OneNET 应用指导 AT+MIPLREADRSP=0,25466,1,3311,0,5851,5,1,1,3,0 //发送 4 条消息回应读取请求 OK AT+MIPLREADRSP=0,25466,1,3311,0,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5805,4,4,1.88,0,0 OK 5.3.3. 读取对象 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送读取对象（3311）请求。 +MIPLREAD: 0,39299,3311,-1,-1 //收到读取对象请求 AT+MIPLREADRSP=0,39299,1,3311,0,5851,5,1,1,5,0 //发送 6 条消息回应读取请求 OK AT+MIPLREADRSP=0,39299,1,3311,0,5852,3,2,123,4,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5805,4,4,1.88,0,0 OK 5.4. 写入操作 5.4.1. 写入资源 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送写入资源（3311/0/5706）请求，并含有字符串格式的写入值：hello。 +MIPLWRITE: 0,38017,3311,0,5706,2,5,68656C6C6F,0,0 //收到写入资源请求 上海移远通信技术股份有限公司 37 / 45 AT+MIPLWRITERSP=0,38017,2 OK BC25&BC32 OneNET 应用指导 //响应写入请求，其中结果码为 2 5.4.2. 写入实例 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送写入实例（3311/0）请求。 +MIPLWRITE: 0,46584,3311,0,5706,2,5,68656C6C6F,0,2 //收到写入实例请求 +MIPLWRITE: 0,46584,3311,0,5850,2,1,01,0,1 +MIPLWRITE: 0,46584,3311,0,5851,2,8,00000002DFDC1C3E,0,0 AT+MIPLWRITERSP=0,46584,2 OK //响应写入请求，其中结果码为 2 5.5. 执行操作 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送执行请求，其中包含 Argument：reset。 +MIPLEXECUTE: 0,36476,3303,0,5605,5,'reset' //收到执行请求 AT+MIPLEXECUTERSP=0,36476,2 OK //响应执行请求，其中结果码为 2 5.6. 写属性操作 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送写属性请求。 +MIPLPARAMETER: 0,56642,3303,0,5700,38,'pmin=2;pmax=190;gt=100.0;lt=1.0;st=0.2' 上海移远通信技术股份有限公司 38 / 45 AT+MIPLPARAMETERRSP=0,56642,2 OK 5.7. 订阅操作 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送订阅请求； 3. 禁用了模块的自动响应订阅请求功能。 +MIPLOBSERVE: 0,29620,1,3311,0,-1 AT+MIPLOBSERVERSP=0,29620,1 OK BC25&BC32 OneNET 应用指导 //收到写属性请求 //响应写属性请求，其中结果码为 2 //收到订阅请求 //确认订阅请求 5.8. 上报数据操作 5.8.1. 上报资源数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅资源（3303/0/5700），且订阅请求的参数为 122179。 AT+MIPLNOTIFY=0,122179,3303,0,5700,4,4,25.6,0,0 OK //通知资源数据 5.8.2. 上报实例数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅实例（3303/0），且订阅请求的参数为 653687。 AT+MIPLNOTIFY=0,653687,3303,0,5700,4,4,10.24,3,0 OK //通知实例数据 AT+MIPLNOTIFY=0,653687,3303,0,5701,1,3,'Cel',2,0 上海移远通信技术股份有限公司 39 / 45 OK AT+MIPLNOTIFY=0,653687,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5602,4,4,100.86,0,0 OK BC25&BC32 OneNET 应用指导 5.8.3. 上报对象数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅对象（3303），且订阅请求的参数为 196301。 AT+MIPLNOTIFY=0,196301,3303,0,5700,4,4,9.8,3,0 OK //上报实例 ID 为 0 下资源的数据 AT+MIPLNOTIFY=0,196301,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5602,4,4,99.8,0,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5700,4,4,0.2,3,0 OK //上报实例 ID 为 1 下资源的数据 AT+MIPLNOTIFY=0,196301,3303,1,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5601,4,4,3.2,1,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5602,4,4,100.1,0,0 OK 5.8.4. 使用上报资源数据 前提条件： 上海移远通信技术股份有限公司 40 / 45 BC25&BC32 OneNET 应用指导 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅资源（3303/0/5701），且订阅请求的参数为 307353。 AT+MIPLNOTIFY=0,307353,3303,0,5701,1,3,'Cel',0,0,255 //使用（225）上报资源数据 OK +MIPLEVENT: 0,26,255 //返回上报结果 5.8.5. 使用上报实例数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅资源（3303/0），且订阅请求的参数为 487674。 AT+MIPLNOTIFY=0,487674,3303,0,5700,4,4,170.1,3,0,258 //使用（258）上报资源数据 OK AT+MIPLNOTIFY=0,487674,3303,0,5701,1,3,'Cel',2,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5601,4,4,106.1,1,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5602,4,4,660.9,0,0,258 OK +MIPLEVENT: 0,26,258 //返回上报结果 5.9. 更新操作 前提条件： UE 已经成功注册到 OneNET。 5.9.1. 更新操作（不自动更新生命周期） 在禁用了 OneNET 在存活周期即将到期时自动更新的情况下，下面的举例中详述了更新操作。 AT+MIPLUPDATE=0,86400,0 OK //更新存活周期为 86400 秒。 上海移远通信技术股份有限公司 41 / 45 BC25&BC32 OneNET 应用指导 +MIPLEVENT: 0,11 //返回更新结果 5.9.2. 更新操作（自动更新生命周期） 在使能 OneNET 在存活周期即将到期时自动更新的情况下，下面的举例中详述了更新操作。 //在存活周期即将到期时，上报需要更新存活周期的 URC +MIPLEVENT: 0,14,26 +MIPLEVENT: 0,11 //UE 自动更新并返回更新结果 上海移远通信技术股份有限公司 42 / 45 BC25&BC32 OneNET 应用指导 6 错误码 本章节主要介绍与 BC25 和 BC32 模块相关的值。 下面两个表中列出的错误值符合 3GPP 规范。可参考 3GPP TS 27.007 V13.5.0, sub-clause 9.2 查看 更多值。 表 3：通用错误（27.007） 值 3 4 23 30 50 52 53 159 描述 Operation not allowed Operation not supported Memory failure No network service Execute fail Option not support Param invalid Uplink busy/flow control 表 4：通用错误（27.005） Values 300 301 302 303 304 Description ME failure SMS service of ME reserved Operation not allowed Operation not supported Invalid PDU mode parameter 上海移远通信技术股份有限公司 43 / 45 BC25&BC32 OneNET 应用指导 305 Invalid text mode parameter 310 USIM not inserted 311 USIM PIN required 312 PH-USIM PIN required 313 USIM failure 314 USIM busy 315 USIM wrong 316 USIM PUK required 317 USIM PIN2 required 318 USIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network service 332 Network timeout 340 No +CNMA acknowledgement expected 500 Unknown error 备注 可以使用 AT+CMEE=命令禁用（=0）或者使能（=1，=2）最终结果码的上报+CME ERROR: 上海移远通信技术股份有限公司 44 / 45 BC25&BC32 OneNET 应用指导 7 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] IPSO-Smart-Objects-Starter-Pack [2] OMA-TS-LightweightM2M-V1_0 [3] Quectel_BC25_AT 命令手册 [4] Quectel_BC32_AT 命令手册 表 6：术语缩写 缩写 CoAP ID LwM2M LPWA ME NB-IoT NVM IPSO RAI REST TE UE URC 英文全称 中文全称 Constrained Application Protocol 受限应用协议 Identifier 标识符 Lightweight Machine to Machine 轻量化 M2M Low-Power Wide-Area 低功耗广域 Mobile Equipment 移动设备 Narrow Band Internet of Things 窄带物联网 Non-volatile Memory 非易失性内存 Internet Protocol for Smart Objects 智能设备互联网协议 Release Assistant Indication 释放辅助指示 Representational State Transfer 表述性状态传递 Terminal Equipment (Typically the MCU) 终端设备（典型为 MCU 微型控制单元） User Equipment (Typically the Module) 用户设备（典型为模块） Unsolicited Result Code 非请求结果码 上海移远通信技术股份有限公司 45 / 45

BG95&BG77&BG600L Series QuecCell Application Note LPWA Module Series Version: 1.0 Date: 2021-03-30 Status: Released LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_QuecCell_Application_Note 1 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. BG95&BG77&BG600L_Series_QuecCell_Application_Note 2 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note About the Document Revision History Version Date Author - 2021-02-10 Lane HAO 1.0 2021-03-30 Lane HAO Description Creation of the document First official release BG95&BG77&BG600L_Series_QuecCell_Application_Note 3 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 2 Description of AT Commands ........................................................................................................... 7 2.1. AT Command Introduction ......................................................................................................... 7 2.1.1. Definitions........................................................................................................................ 7 2.1.2. AT Command Syntax ...................................................................................................... 7 2.2. Declaration of AT Command Examples ..................................................................................... 8 2.3. AT+QENG Query Serving Cell and Neighbour Cell Information............................................. 8 2.4. AT+QCELLSCAN Scan Cell Information .............................................................................. 13 3 Appendix A References.................................................................................................................... 16 BG95&BG77&BG600L_Series_QuecCell_Application_Note 4 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Types of AT Commands ................................................................................................................. 7 Table 3: Related Documents ...................................................................................................................... 16 Table 4: Terms and Abbreviations .............................................................................................................. 16 BG95&BG77&BG600L_Series_QuecCell_Application_Note 5 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note 1 Introduction This document presents the description of cell scanning command for the following Quectel LPWA modules. Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_QuecCell_Application_Note 6 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note 2 Description of AT Commands 2.1. AT Command Introduction 2.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on the command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified.  Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_QuecCell_Application_Note 7 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you familiarize with AT commands and learn how to use them. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. 2.3. AT+QENG Query Serving Cell and Neighbour Cell Information The command reports the information of serving cells and neighbour cells. AT+QENG Query Serving Cell and Neighbour Cell Information Test Command AT+QENG=? Response +QENG: (list of supported s) Write Command Query the information of serving cell AT+QENG='servingcell' OK Response In the case of GSM mode: +QENG: 'servingcell',[,,,,,,,,,,,,,,,,,,,,< HSN>,,,,,] OK In the case of LTE Cat M1/Cat NB2 mode: +QENG: 'servingcell',[,,,,< MNC>,,,,,,,,,,< RSSI>,,] OK Write Command Response Query the information of neighbour cells: In the case of GSM mode: AT+QENG='neighbourcell' [+QENG: 'neighbourcell',,,,, ,,,,,,, […]] BG95&BG77&BG600L_Series_QuecCell_Application_Note 8 / 17 Maximum Response Time Characteristics LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note OK In the case of LTE Cat M1/Cat NB2 mode: [+QENG: 'neighbourcell intra',,,,,,,,,,,, […]] [+QENG: 'neighbourcell inter',,,,,,,,,,, […]] OK 300 ms Parameter String type. Type of the cell, of which the information can be queried. 'servingcell' Serving cell 'neighbourcell' Neighbour cell String type. UE state. 'SEARCH' UE is searching but could not (yet) find a suitable cell 'LIMSRV' UE is camping on a cell but has not registered on the network 'NOCONN' UE has camped on a cell and registered on the network, but it is in the idle mode 'CONNECT' UE has camped on a cell and registered on the network, and a call is in progress String type. Radio access technologies. 'GSM' GSM 'eMTC' LTE Cat M1 'NBIoT' LTE Cat NB2 Integer type. A three-digit value indicating mobile country code (the first part of the PLMN code). Integer type. A two-digit value indicating the mobile network code (the second part of the PLMN code). Two-byte location area code, in hexadecimal format (e.g., 00C1 equals 193 in decimal), of the cell that was scanned. Range: 0–0xFFFF. Hexadecimal format. 16-bit (GSM) or 28-bit (LTE) cell ID. Range: 0–0xFFFFFFF. Integer type. Base station identification code. Range: 0–63. Integer type. ARFCN of the cell that was scanned. Range: 0–1023. BG95&BG77&BG600L_Series_QuecCell_Application_Note 9 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note Integer type. The current GSM band. 0 DCS1800 1 PCS1900 2 EGSM900 3 GSM850 Integer type. The Rx level value for base station selection that is mapped from the measured signal level (see 3GPP 45.008). Range: 0–63. Subtracting 111 from the Rx level value, a dBm value will be got. Integer type. The maximum Tx power level an MS may use when accessing the system. Range: 0–31. Integer type. The minimum received signal level at the MS required for access to the system. Range: 0–63. Integer type. Discontinuous reception cycle. Unit: second. Integer type. Path loss criterion used for cell selection and reselection. Integer type. Cell reselection criterion. Integer type. Whether the current cell supports GPRS. 0 Not support 1 Support String or integer type. Displays ‘h’ in hopping; displays the current ARFCN in voice call. Integer type. Timeslot number in voice call. Range: 0–7. Integer type. Timing advance in voice call. Range: 0–63. Integer type. Mobile allocation index offset in voice call. Range: 0–63. Integer type. Hopping sequence number in voice call. Range: 0–63. Integer type. Rx quality (sub) in voice call. Range: 0–7. Integer type. Rx quality (full) in voice call. Range: 0–7. Integer type. Rx level (sub) in voice call. Range: 0–63. Integer type. Rx level (full) in voice call. Range: 0–63. String format. Speech coding modes during a voice call. 'HR' Half rate 'FR' Full rate 'EFR' Enhanced full rate 'AMR' Adaptive multi-rate 'AMRHR' AMR half rate 'AMRFR' AMR full rate 'AMRWB' AMR wide band String type. LTE network mode. 'FDD' LTE-FDD Integer type. Physical cell identity. Integer type. E-UTRA absolute radio frequency channel number. Integer type. E-UTRA frequency bands (see 3GPP 36.101). Integer type. UL bandwidth. 0 1.4 MHz 1 3 MHz 2 5 MHz BG95&BG77&BG600L_Series_QuecCell_Application_Note 10 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note 3 10 MHz 4 15 MHz 5 20 MHz Integer type. DL bandwidth. 0 1.4 MHz 1 3 MHz 2 5 MHz 3 10 MHz 4 15 MHz 5 20 MHz Tracking area code in hexadecimal format (see 3GPP 23.003 subclause 19.4.2.3). Reference signal received power (see 3GPP 36.214 subclause 5.1.1). Unit: dBm. Reference signal received quality (see 3GPP 36.214 subclause 5.1.3). Unit: dB. Integer type. The received signal strength indication. Unit: dBm. Integer type. A converted value of SINR. The actual SINR = (1/5) × - 20. Range: 0–250 (that is, the actual SINR ranges between -20 dB and 30 dB). . Integer type. Cell selection Rx level value (in dB) (see 3GPP 36.304). Integer type. The signal level threshold criterion for hierarchical cell structures (HCS). The parameter is used to determine whether prioritised hierarchical GPRS and LSA cell re-selection shall apply. Integer type. The cell ranking criterion which is used to select cells among those with the same priority. Integer type. Cell reselection priority. Range: 0–7. Integer type. Threshold to control non-intra frequency searches. Integer type. The threshold of (in dB) used by the UE on the serving cell when reselecting towards a lower priority RAT/ frequency. Integer type. Threshold to control intra-frequency searches. Integer type. To be referenced when reselection. The suitable Rx level value of an evaluated lower priority cell must be greater than this value. Integer type. To be referenced when reselection. The suitable Rx level value of an evaluated higher priority cell must be greater than this value. Example AT+QENG='servingcell' +QENG: 'servingcell','SEARCH' OK //If the module registers on GSM network. AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','GSM',460,00,550B,D89,35,59,,-48,255,255,0,55,165,1,,,,,,,,,, OK BG95&BG77&BG600L_Series_QuecCell_Application_Note 11 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note //If the module registers on NB-IoT network. AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','NBIoT','FDD',460,11,DDA1451,280,2506,5,0,0,69C9,-84,-17,-67, 8,44 OK //If the module registers on eMTC network. AT+QENG='servingcell' +QENG: 'servingcell','NOCONN','eMTC','FDD',460,11,690843E,314,1850,3,5,5,691D,-105,-14,-77, 11,22 OK //If the module registers on GSM network. AT+QENG='neighbourcell' +QENG: 'neighbourcell','GSM',460,00,550B,D8A,41,63,-72,31,141,0,0 +QENG: 'neighbourcell','GSM',460,00,550B,D58,58,57,-65,38,148,0,0 +QENG: 'neighbourcell','GSM',460,00,550B,6395,11,64,-66,37,147,0,0 +QENG: 'neighbourcell','GSM',460,00,550B,3C94,43,62,-70,33,143,0,0 OK //If the module registers on NB-IoT network. AT+QENG='neighbourcell' +QENG: 'neighbourcell intra','NBIoT',2506,224,-12,-81,-68,0,59,0,50,0,50 +QENG: 'neighbourcell intra','NBIoT',2506,280,-14,-81,-67,0,47,0,50,0,50 +QENG: 'neighbourcell intra','NBIoT',2506,281,-15,-81,-66,0,58,0,50,0,50 OK //If the module registers on eMTC network. AT+QENG='neighbourcell' +QENG: 'neighbourcell intra','eMTC',1850,314,-15,-107,-78,0,21,7,20,10,58 +QENG: 'neighbourcell intra','eMTC',1850,312,-16,-106,-81,0,21,7,20,10,58 +QENG: 'neighbourcell intra','eMTC',1850,319,-20,-112,-83,0,15,7,20,10,58 OK BG95&BG77&BG600L_Series_QuecCell_Application_Note 12 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note 2.4. AT+QCELLSCAN Scan Cell Information The command returns the information of all cells existing in the coverage area of the network that the module registers on. AT+QCELLSCAN Scan Cell Information Test Command AT+QCELLSCAN=? Response +QCELLSCAN: (list of supported s),(range of ) Write Command AT+QCELLSCAN=[,] OK Response If =1 (in the GSM network): OK +QCELLSCAN: +QCELLSCAN: ''GSM'',,,,,< bsic>, [...] If =8 (in the eMTC network): OK +QCELLSCAN: +QCELLSCAN: ''eMTC'',,,,,,,,, [...] If =9 (in the NB-IoT network): OK +QCELLSCAN: +QCELLSCAN: ''NBIoT'',,,,,,,,, [...] If there is a timeout error or any other error: BG95&BG77&BG600L_Series_QuecCell_Application_Note 13 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note Maximum Response Time Characteristics +QCELLSCAN: Or ERROR Depending on the network environment. The command takes effect immediately. The configuration is not saved. Parameter Integer type. The access technology of the serving cell. 1 GSM network 8 eMTC network 9 NB-IoT network Integer type. The timeout value for the cell-scanning. Range: 5–65535. Default value: 120. Unit: second. Integer type. Number of cells scanned. Integer type. A three-digit value indicating mobile country code. Integer type. A two-digit value indicating the mobile network code. Two-byte location area code in hexadecimal format. Cell ID in hexadecimal format. Integer type. Base station identification code. Range: 0–63. Integer type. The Rx level value for base station selection that is mapped from the measured signal level (see 3GPP 45.008). Range: 0–63. Subtracting 111 from the Rx level value, a dBm value will be got. Tracking area code in hexadecimal format. Integer type. E-UTRA absolute radio frequency channel number. Integer type. Physical cell identity. Reference signal received power (see 3GPP 36.214 subclause 5.1.1). Unit: dBm. Reference signal received quality (see 3GPP 36.214 subclause 5.1.3). Unit: dB. Integer type. The received signal strength indication. Unit: dBm. Integer type. -1 Cell scanning failure NOTE When reaches, cell scanning will be aborted but the response cannot be returned immediately unless no cell has been scanned before. Example //If the module registers on GSM network. AT+QCELLSCAN=1 OK BG95&BG77&BG600L_Series_QuecCell_Application_Note 14 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note +QCELLSCAN: 3 +QCELLSCAN: 'GSM',460,00,550B,34B8,63,58 +QCELLSCAN: 'GSM',460,00,550B,D89,34,44 +QCELLSCAN: 'GSM',460,00,550B,3C94,26,38 //If the module registers on eMTC network. AT+QCELLSCAN=8 OK +QCELLSCAN: 2 +QCELLSCAN: 'eMTC',460,11,1,73A,314,690843E,-103,-12,-77 +QCELLSCAN: 'eMTC',460,11,691D,1850,312,6908430,-108,-17,-77 //If the module registers on NB-IoT network. AT+QCELLSCAN=9 OK +QCELLSCAN: 2 +QCELLSCAN: 'NBIoT',460,00,2,E9A,471,84958B2,-73,-11,-62 +QCELLSCAN: 'NBIoT',460,00,4C10,3736,121,5C4EF33,-85,-10,-75 BG95&BG77&BG600L_Series_QuecCell_Application_Note 15 / 17 LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note 3 Appendix A References Table 3: Related Documents SN Document Name Description 3rd Generation Partnership Project; [1] 3GPP TS 45.008 Technical Specification Group Radio Access Network; GSM/EDGE Radio subsystem link control Quectel_BG95&BG77&BG600L_ AT Commands Manual of BG95 Series, BG77 and [2] Series_AT_Commands_Manual BG600L-M3 Modules Table 4: Terms and Abbreviations Abbreviation 3GPP ARFCN DCS DL EARFCN EGPRS eMTC E-UTRA FDD GPRS GSM ID Description 3rd Generation Partnership Project Absolute Radio Frequency Channel Number Digital Cellular System Downlink E-UTRA Absolute Radio Frequency Channel Number Enhanced General Packet Radio Service enhanced Machine-Type Communication Evolved Universal Terrestrial Radio Access Frequency Division Duplex General Packet Radio Service Global System for Mobile Communications Identifier BG95&BG77&BG600L_Series_QuecCell_Application_Note 16 / 17 LTE LPWA LSA MS NB-IoT PCS PLMN RAT Rx SINR TA TDD Tx UE UL URC UTRA-ARFCN LPWA Module Series BG95&BG77&BG600L Series QuecCell Application Note Long-Term Evolution Low-Power Wide-Area Local Service Area Mobile Station Narrowband Internet of Things Personal Communication Service Public Land Mobile Network Radio Access Technology Receive Signal To Interference Plus Noise Ratio Terminal Adapter Time Division Duplex Transmit User Equipment Uplink Unsolicited Result Code UTRA Absolute Radio Frequency Channel Number BG95&BG77&BG600L_Series_QuecCell_Application_Note 17 / 17

EG060V-EA 网卡拨号应用指导 LTE-A 模块系列 版本：1.0 日期：2021-07-20 状态：受控文件 EG060V-EA 网卡拨号应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司不 承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功能 错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的使 用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任何 因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权使 用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追究 法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 20 EG060V-EA 网卡拨号应用指导 文档历史 修订记录 版本 1.0 日期 2021-07-08 2021-07-20 作者 Martin WANG Martin WANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 20 EG060V-EA 网卡拨号应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 网卡拨号数据流程 ................................................................................................................................. 7 3 网卡拨号说明......................................................................................................................................... 9 3.1. 配置网卡 ..................................................................................................................................... 9 3.1.1. 配置拨号方式................................................................................................................... 9 3.1.1.1. Windows 系统....................................................................................................... 9 3.1.1.2. Linux 系统............................................................................................................. 9 3.1.2. 配置拨号模式................................................................................................................... 9 3.2. 执行拨号 ................................................................................................................................... 10 3.3. 拨号结果 ................................................................................................................................... 10 3.3.1. Windows 系统................................................................................................................ 10 3.3.2. Linux 系统.......................................................................................................................11 4 AT 命令 ............................................................................................................................................... 13 4.1. AT 命令说明.............................................................................................................................. 13 4.1.1. 定义 ............................................................................................................................... 13 4.1.2. 命令语句 ........................................................................................................................ 13 4.2. AT 示例声明.............................................................................................................................. 14 4.3. AT 命令详解.............................................................................................................................. 14 4.3.1. AT+QCFG 扩展配置 ................................................................................................... 14 4.3.1.1. AT+QCFG='usbnet' 配置拨号方式 ................................................................. 14 4.3.1.2. AT+QCFG='nat' 配置拨号模式 ....................................................................... 15 4.3.2. AT+QICSGP 配置 PDP 上下文................................................................................... 16 4.3.3. AT+QNETDEVCTL 执行/断开 PDP 拨号.................................................................... 17 4.3.4. AT+QNETDEVSTATUS 查询指定 PDP 上下文 ID 相关信息 ...................................... 18 5 附录 ..................................................................................................................................................... 20 上海移远通信技术股份有限公司 3 / 20 EG060V-EA 网卡拨号应用指导 表格索引 表 1：AT 命令类型...................................................................................................................................... 13 表 2：参考文档 ........................................................................................................................................... 20 表 3：术语缩写 ........................................................................................................................................... 20 上海移远通信技术股份有限公司 4 / 20 EG060V-EA 网卡拨号应用指导 图片索引 图 1：网卡拨号数据流程 .............................................................................................................................. 7 图 2：RNDIS 网卡 ...................................................................................................................................... 10 图 3：Windows 系统查看网卡拨号状态 ......................................................................................................11 图 4：Linux 系统查看网卡 IP 地址 ............................................................................................................. 12 上海移远通信技术股份有限公司 5 / 20 EG060V-EA 网卡拨号应用指导 1 引言 本文档主要介绍如何使用移远通信 EG060V-EA 模块分别在支持 Windows 和 Linux 操作系统的上位机 上进行网卡拨号，包括不同的网卡拨号方法、拨号步骤、拨号结果和拨号状态查询以及相关 AT 命令等。 上海移远通信技术股份有限公司 6 / 20 EG060V-EA 网卡拨号应用指导 2 网卡拨号数据流程 EG060V-EA网卡拨号数据流程 异常处理机制3: 如果通过重拨和CFUN切换后， 数据业务仍不可用，对模块进行 硬件重启再尝试 异常处理机制2: 如果重拨后数据业务仍不可用， 尝试软复位，执行CFUN切换， 注册成功后再进行拨号 AT+QNETDEVCTL=0,1,1 异常处理机制1: 如果数据业务不可用，首先尝试 断开拨号再重拨 NO AT AT+CPIN? AT+CIMI AT+CGDCONT? AT+QICSGP=1 APN是否和PLMN匹配? YES NO AT+CGDCONT=1,'IP','APN' AT+QICSGP=1,1,'APN' AT+CFUN=0 AT+CFUN=1 AT+CSQ AT+CEREG?/AT+CREG? AT+COPS? AT+QNWINFO AT+QNETDEVCTL=1,1,1 开始数据业务 同时应用上层进行数据保活，探测数 据业务是否可用 数据业务是否可用 模块开机，ttyUSB识别后，确认AT能通 AT+CPIN?返回Ready，则读取到SIM卡 · APN配置流程： 查询AT+CIMI，根据返回的PLMN，程序上识别对应的运 营商，然后设置对应运营商APN（客户程序上需要维护 一个全球运营商的APN表格，可 从 google网站 下 载 ） 。 国内运营商常见APN如下： 移动(CMNET):46000/02/04/07/08 联通(3GNET):46001/06/09 电信(CTNET):46003/05/11 同时需预留客户端配置APN 、用户名、密码、鉴 权接 口 （ 如WEB界面 ） ， 以 便 在 程 序 自 动 匹 配 设置APN无法注网时，终端用户可尝试进行手动设置。 注意： 1. 首次使用某个APN时，需先设置AT+CFUN=0，再设置 AT+CFUN=1，或者选择重启后默认配置为AT+CFUN=1。 2. 如果使用的SIM卡确定不需要设置APN，可忽略这个 配置流程。 AT+CSQ查询信号强度，参数范围为0~31 AT+CGREG?/AT+CREG?最后1位返回5或者1都表示正 常注册。如果2分钟内都不注册，那么主控应用上面考虑 提醒用户手动配置APN。 A T + C OP S ? 查询注册的网络制式，最后1位返回7代表 当 前网络制式为LTE。 执 行 AT+QNETDEVCTL=1,1,1 拨 号 ， 随 后 执 行 AT+QNETDEVCTL?查询是否拨号成功（最后1位参数的 返回值为1时表示已成功连接）。查询返回值如下： +QNETDECTL:,,, 其 中，、以 及的返 回 值为之前设置的值，如果之前没设置过，则均返回0。 的 返 回 值为 0 表示 拨 号 成 功（ 网 卡 已 绑定 ） ， 为 1表示拨号失败（网卡未绑定）。 若拨号成功后出现断网、反激活导致的连接断开或重新连 接，会有URC主动上报，例如: +QNETDEVSTATUS: 1 +QNETDEVSTATUS: 0 数据保活，建议每隔1~2分钟Pin g一 次下 面这 组网址： www.baidu.com、8.8.8.8、114.114.114.114. 如果其中任意一个网址可以Ping通，说明网络可用。 图 1：网卡拨号数据流程 上海移远通信技术股份有限公司 7 / 20 EG060V-EA 网卡拨号应用指导 备注 相关 AT 命令请参考 Quectel_EG060V-EA_AT_Commands_Manual。 上海移远通信技术股份有限公司 8 / 20 EG060V-EA 网卡拨号应用指导 3 网卡拨号说明 本章节主要介绍 USB 网卡拨号上网步骤，请参照第 2 章拨号流程执行拨号。 可通过 AT+QCFG 进行网卡配置，以及通过 AT+QNETDEVCTL 进行拨号上网。拨号成功以后，可通 过 AT+QNETDEVSTATUS 查看网卡的状态。有关 AT 命令的详情，请参考第 4.3 章。 3.1. 配置网卡 3.1.1. 配置拨号方式 3.1.1.1. Windows 系统 执行 AT+QCFG='usbnet',3 配置网卡拨号方式为 RNDIS。 3.1.1.2. Linux 系统 执行 AT+QCFG='usbnet',4 配置网卡拨号方式为 NCM； 或执行 AT+QCFG='usbnet',1 配置网卡拨号方式为 ECM； 或执行 AT+QCFG='usbnet',3 配置网卡拨号方式为 RNDIS。 3.1.2. 配置拨号模式 执行 AT+QCFG='nat',0 配置拨号模式为路由模式； 或者执行 AT+QCFG='nat',1 配置拨号模式为网卡模式。 备注 参数配置在模块重启后生效。建议开机后先通过 AT+QCFG='nat'查询当前配置，若当前配置和期望不 同，可按上述方法进行配置并重启模块。 上海移远通信技术股份有限公司 9 / 20 EG060V-EA 网卡拨号应用指导 3.2. 执行拨号 通过 AT+QNETDEVCTL 进行网卡拨号。例如，执行 AT+QNETDEVCTL=2,1,1（配置=1 并进行拨号，同时开启网络断开自动重连）进行拨号时，若执行拨号成功，拨号结果请参考第 3.3 章。 3.3. 拨号结果 执行拨号成功以后，上位机创建相应的网卡，可通过查看网卡的状态获取拨号结果。 3.3.1. Windows 系统 本文档以 Windows 10 系统为例，进入主机系统'控制面板'，选择'网络和 Internet'，然后选择已 创建的 RNDIS 网卡，双击后点击'详细信息'查看拨号状态。 图 2：RNDIS 网卡 上海移远通信技术股份有限公司 10 / 20 EG060V-EA 网卡拨号应用指导 图 3：Windows 系统查看网卡拨号状态 3.3.2. Linux 系统 在上位机执行 ifconfig 查看当前网卡 IP 地址，如下图： 上海移远通信技术股份有限公司 11 / 20 EG060V-EA 网卡拨号应用指导 图 4：Linux 系统查看网卡 IP 地址 上海移远通信技术股份有限公司 12 / 20 EG060V-EA 网卡拨号应用指导 4 AT 命令 4.1. AT 命令说明 4.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 4.1.2. 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 13 / 20 EG060V-EA 网卡拨号应用指导 4.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 4.3. AT 命令详解 4.3.1. AT+QCFG 扩展配置 AT+QCFG 扩展配置 测试命令 AT+QCFG=? 最大响应时间 响应 … +QCFG: 'usbnet',(支持的列表) +QCFG: 'nat',(支持的列表) … OK 300 毫秒 4.3.1.1. AT+QCFG='usbnet' 配置拨号方式 该命令用于配置 USB 网卡的拨号方式。 AT+QCFG='usbnet' 配置拨号方式 设置命令 AT+QCFG='usbnet'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'usbnet', OK 最大响应时间 特性说明 若指定可选参数，则设置拨号方式： OK 或者 ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 上海移远通信技术股份有限公司 14 / 20 参数 整型。网卡拨号方式。 1 ECM 3 RNDIS 4 NCM 举例 AT+QCFG='usbnet',4 OK //配置拨号方式为 NCM。 EG060V-EA 网卡拨号应用指导 4.3.1.2. AT+QCFG='nat' 配置拨号模式 该命令用于配置 USB 网卡的拨号模式。 AT+QCFG='nat' 配置拨号模式 设置命令 AT+QCFG='nat'[,] 响应 若省略可选参数，则查询当前配置： +QCFG: 'nat', OK 最大响应时间 特性说明 若指定可选参数，则设置拨号模式： OK 或者 ERROR 300 毫秒 该命令重启后生效； 参数配置自动保存。 参数 整型。拨号模式。 0 路由模式 1 网卡模式 备注 路由模式下上位机获取的地址为私网地址，网卡模式下上位机获取的为公网地址。 上海移远通信技术股份有限公司 15 / 20 举例 AT+QCFG='nat',1 OK EG060V-EA 网卡拨号应用指导 //配置拨号模式为网卡模式。 4.3.2. AT+QICSGP 配置 PDP 上下文 该命令用于配置指定的 PDP 上下文信息。 AT+QICSGP 配置 PDP 上下文 测试命令 AT+QICSGP=? 响应 +QICSGP: (支持的范围),(支持的 范围),,,,(支持的范围) 查询命令 AT+QICSGP? OK 响应 +QICSGP: ,,,,, 设置命令 AT+QICSGP=[,,[,,,]] OK 响应 若省略可选参数，查询指定的 PDP 上下文配置： +QICSGP: ,,,, OK 最大响应时间 特性说明 若指定任意可选参数，配置指定的 PDP 上下文信息： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。PDP 上下文 ID。范围：1~15。 整型。协议类型。 1 IPv4 2 IPv6 3 IPv4v6 上海移远通信技术股份有限公司 16 / 20 EG060V-EA 网卡拨号应用指导 字符串类型。接入点名称。 字符串类型。用户名。最大长度：50 字节。 字符串类型。密码。最大长度：50 字节。 整型。鉴权方式。 0 NONE 1 PAP 2 CHAP 举例 AT+QICSGP=2,1,'','quectel','123456',1 OK //配置 PDP 上下文=2。 4.3.3. AT+QNETDEVCTL 执行/断开 PDP 拨号 该命令用于执行/断开 PDP 拨号。 AT+QNETDEVCTL 执行/断开 PDP 拨号 测试命令 AT+QNETDEVCTL=? 响应 +QNETDEVCTL: (支持的范围),(支持的范围),(支持的列表),(支持的列 表) 查询命令 AT+QNETDEVCTL? OK 响应 +QNETDEVCTL: ,,,< state> 设置命令 通过指定的 PDP 上下文进行拨号上网 AT+QNETDEVCTL=,[,] 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。PDP 上下文 ID。范围：1~15。 整型。执行或者断开拨号。 0 断开拨号。 上海移远通信技术股份有限公司 17 / 20 EG060V-EA 网卡拨号应用指导 1 执行拨号。 2 执行拨号，并设置断开之后自动重新执行拨号。 3 执行拨号，并设置断开之后自动重新执行拨号以及开机自动拨号。 整型。是否开启 URC 上报拨号状态。 0 不开启 1 开启 整型。拨号状态。 0 拨号失败。 1 拨号成功。 备注 如需关闭开机自动拨号，设置=0/1/2 均可。 举例 AT+QNETDEVCTL=2,1,1 OK //配置使用 PDP 上下文=1 进行拨号。 4.3.4. AT+QNETDEVSTATUS 查询指定 PDP 上下文 ID 相关信息 该命令用于查询指定 PDP 上下文 ID 相关信息。 AT+QNETDEVSTATUS 查询指定 PDP 上下文 ID 相关信息 测试命令 AT+QNETDEVSTATUS=? 响应 +QNETDEVSTATUS: (激活的列表) 设置命令 AT+QNETDEVSTATUS= OK 响应 +QNETDEVSTATUS: ,,,,,, 最大响应时间 特性说明 OK 或者 ERROR 300 毫秒 / 上海移远通信技术股份有限公司 18 / 20 EG060V-EA 网卡拨号应用指导 参数 整型。PDP 上下文 ID。范围：1~15。 字符串类型。主机 IP 地址。范围：0x0000_0000~0xFFFF_FFFF。 字符串类型。子网掩码。范围：0x0000_00FF~0xFCFF_FFFF。 字符串类型。默认网关。范围：0x0000_0000~0xFFFF_FFFF。 字符串类型。DHCP 服务器的地址。范围：0x0000_0000~0xFFFF_FFFF。 字符串类型。首选 DNS 的地址。范围：0x0000_0000~0xFFFF_FFFF。 字符串类型。备用 DNS 的地址。范围：0x0000_0000~0xFFFF_FFFF。 举例 AT+QNETDEVSTATUS=2 //查询 PDP 上下文=2 的相关信息。 +QNETDEVSTATUS: 2,'10.175.91.166','','','','211.138.180.2','211.138.180.3' OK 上海移远通信技术股份有限公司 19 / 20 EG060V-EA 网卡拨号应用指导 5 附录 表 2：参考文档 文档名称 [1] Quectel_EG060V-EA_AT_Commands_Manual 表 3：术语缩写 缩写 APN CHAP DHCP DNS ECM ID IP IPv4 IPv6 NCM PAP PDP RNDIS URC USB 英文全称 中文全称 Access Point Name 接入点名称 Challenge Protocol Handshake Authentication 挑战握手认证协议 Dynamic Host Configuration Protocol 动态主机设置协议 Domain Name System 域名系统（服务）协议 Ethernet Networking Control Model 以太网控制模型 Identifier 标识符 Internet Protocol 网际互连协议 Internet Protocol version 4 互联网通信协议第四版 Internet Protocol version 6 互联网通信协议第六版 Network Control Model 网络控制模型 Password Authentication Protocol 口令认证协议 Packet Data Protocol Remote Network Specification Driver Unsolicited Result Code 分组数据协议 Interface 远程网络驱动程序接口规范 非请求结果码 Universal Serial Bus 通用串行总线 上海移远通信技术股份有限公司 20 / 20

EC2xEG9x&EG2x-G 系列 AT&T Data-only 软件配置指导 LTE Standard 模块系列 版本：1.0 日期：2021-06-30 状态：受控文件 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 文档历史 修订记录 版本 1.0 日期 2021-06-09 2021-06-30 作者 Dennis FENG Dennis FENG 变更描述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 1.1. 适用模块 ...................................................................................................................................... 5 1.2. Data + Voice 模块与 Data-only 模块 ........................................................................................... 6 2 背景 ........................................................................................................................................................ 7 3 软件配置 ................................................................................................................................................. 8 3.1. 禁用语音和 ECC.......................................................................................................................... 8 3.2. 配置 Ue_Usage_Setting.............................................................................................................. 8 3.3. 禁用 IMS...................................................................................................................................... 9 3.4. 配置为 SMS Only ........................................................................................................................ 9 3.5. 设置指定的 APN 名称.................................................................................................................. 9 3.5.1. 将第一路 APN 配置为 broadband .................................................................................... 9 3.5.2. 将第一路 APN 配置为 firstnet-broadband ...................................................................... 10 3.6. 重启模块 .................................................................................................................................... 10 4 附录 参考文档和术语缩写 ................................................................................................................... 11 上海移远通信技术股份有限公司 3 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 表格索引 表 1：适用模块 ............................................................................................................................................. 5 表 2：Data + Voice 模块与 Data-only 模块 .................................................................................................. 6 表 3：参考文档 ............................................................................................................................................11 表 4：术语缩写 ............................................................................................................................................11 上海移远通信技术股份有限公司 4 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 1 引言 由于 AT&T 要求需认证为 Data-only（仅支持数据）的设备必须使用认证为 Data-only 的模块，为了帮 助用户优化针对 AT&T 技术批准测试要求的操作并提高认证速度，对于已使用移远通信 Voice + Data（同 时支持语音与数据）模块在进行 AT&T Data-only 认证时，需要在设备上进行一些配置。 本文档主要介绍如何将移远通信 Data + Voice 模块通过软件配置切换为 Data-only 模块。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG9x EG2x-G 模块 EC21 系列 EC25 系列 EG91 系列 EG95 系列 EG21-G EG25-G 上海移远通信技术股份有限公司 5 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 1.2. Data + Voice 模块与 Data-only 模块 EC2x 系列、EG9x 系列和 EG2x-G 模块的 Data + Voice 和 Data-only 模块如下表所示。其中所列的 Data + Voice 模块需通过第 3 章所述内容通过软件配置切换为 Data-only 模块；所列的 Data-only 模块仅供 参考。 表 2：Data + Voice 模块与 Data-only 模块 模块型号 EC25 系列 & EC25 系列 Mini PCIe EC21 系列 & EC21 系列 Mini PCIe EG25-G & EG25-G Mini PCIe EG21-G & EG21-G Mini PCIe EG91 系列 EG95 系列 Data + Voice 模块 EC25-AF EC25-AF Mini PCIe EC25-AFX EC25-AFX Mini PCIe EC25-A EC25-A Mini PCIe EC21-A EC21-A Mini PCIe EG25-G EG25-G Mini PCIe EG25-G(C) EG21-G EG21-G Mini PCIe EG91-NA EG91-NAX EG91-NS EG95-NA EG95-NAX Data-only 模块 EC25-AF(D) EC25-AF(D) Mini PCIe EC25-AFXD EC25-AFXD Mini PCIe / / / / EG25-G(D) EG25-G(D) Mini PCIe / / / / EG91-NAXD / / EG95-NAXD 上海移远通信技术股份有限公司 6 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 2 背景 本章介绍了 AT&T 对 Data-only 设备的要求背景。AT&T 13340 V21.1 对 Data-only 设备配置要求如下 所示。 图 1：AT&T 对 Data-only 模块和设备的要求背景 上海移远通信技术股份有限公司 7 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 3 软件配置 本章主要介绍了 EC2x 系列、EG9x 系列和 EG2x-G 模块从 Data + Voice 切换为 Data-only 的软件配置 步骤。 3.1. 禁用语音和 ECC 依次执行如下命令禁用语音和 ECC。 AT+QNVW=5280,0,'0102000000000000' OK AT+QNVR=5280,0 +QNVR: '0102000000000000' OK //禁用语音和 ECC。 //查询当前配置。 3.2. 配置 Ue_Usage_Setting 依次执行如下命令将 Ue_Usage_Setting 配置为 AT&T 要求的 Data Centric。 AT+QNVFW='/nv/item_files/modem/mmode/ue_usage_setting',01 OK AT+QNVFR='/nv/item_files/modem/mmode/ue_usage_setting' +QNVFR: 01 //配置 Ue_Usage_Setting 为 Data Centric。 //查询当前配置。 OK 上海移远通信技术股份有限公司 8 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 3.3. 禁用 IMS 依次执行如下命令禁用 IMS。 AT+QNVFW='/nv/item_files/ims/IMS_enable',00 OK AT+QNVFR='/nv/item_files/ims/IMS_enable' +QNVFR: 00 OK //禁用 IMS。 //查询当前配置。 3.4. 配置为 SMS Only 依次执行如下命令将 UE 配置为 SMS Only（仅支持短信）。 AT+QNVFW='/nv/item_files/modem/mmode/sms_only',01 OK AT+QNVFR='/nv/item_files/modem/mmode/sms_only' +QNVFR: 01 OK //根据 AT&T Data-only 设备要求 将 UE 配置为 SMS Only。 //查询当前配置。 3.5. 设置指定的 APN 名称 依次执行如下命令将第一路 APN 配置为指定的 APN 名称。有关该命令的详细信息，请参考文档 [1]。 3.5.1. 将第一路 APN 配置为 broadband 若插入了 AT&T 运营商(U)SIM 卡，请执行以下命令配置第一路 APN 名称。 AT+CGDCONT=1,'IPV4V6','broadband' //设置为 AT&T 默认的 Data-only APN'broadband' 若有定制 APN，请忽略此步骤。 OK AT+CGDCONT? //查询当前配置。 +CGDCONT: 1,'IPV4V6','broadband','0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0',0,0,0,0 +CGDCONT: 2,'IPV4V6','ims','0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0',0,0,0,0 +CGDCONT: 3,'IPV4V6','SOS','0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0',0,0,0,1 上海移远通信技术股份有限公司 9 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 OK 3.5.2. 将第一路 APN 配置为 firstnet-broadband 若插入了 AT&T 运营商 FirstNet 的(U)SIM 卡，请执行以下命令配置第一路 APN 名称。 AT+CGDCONT=1,'IPV4V6','firstnet-broadband' //设置为 AT&T FirstNet 默认的 Data-only APN'firstnet-broadband'。若有定制 APN， 请忽略此步骤。 OK AT+CGDCONT? //查询当前配置。 +CGDCONT: 1,'IPV4V6','firstnet-broadband','0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0',0,0,0,0 +CGDCONT: 2,'IPV4V6','ims','0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0',0,0,0,0 +CGDCONT: 3,'IPV4V6','SOS','0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0',0,0,0,1 OK 3.6. 重启模块 手动重启模块，上述配置生效。 备注 每次将其他运营商(U)SIM 卡切换为 AT&T 运营商或 AT&T FirstNet (U)SIM 卡后，或在 AT&T 运营商和 FirstNet (U)SIM 卡之间切换时，请根据本章节所述将模块软件重新配置为 Data-only。 上海移远通信技术股份有限公司 10 / 11 EC2xEG9x&EG2x-G 系列 AT&T Data Only 软件配置指导 4 附录 参考文档和术语缩写 表 3：参考文档 文档名称 [1] Quectel_EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual 表 4：术语缩写 术语 APN ECC EPS IMS IoT LTE RAT SIM SMS UE VoLTE 英文全称 Access Point Name Emergency Communications Center Evolved Packet System IP Multimedia Subsystem Internet of Things Long-Term Evolution Radio Access Technology Subscriber Identity Module Short Message Service User Equipment Voice (voice calls) over LTE 中文全称 接入点名称 紧急通讯中心 演进型分组系统 IP 多媒体子系统 物联网 长期演进 无线接入技术 用户身份识别模块 短消息业务 用户设备 长期演进语音承载 上海移远通信技术股份有限公司 11 / 11

LC29D (C) DR 应用指导 GNSS 模块系列 版本：1.0 日期：2023-11-08 状态：受控文件 LC29D(C) DR 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 28 LC29D(C) DR 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 28 LC29D(C) DR 应用指导 关于文档 文档信息 标题 副标题 文档类别 文档状态 LC29D (C) DR 应用指导 GNSS 模块系列 应用指导 受控文件 修订记录 版本 1.0 日期 变更表述 2022-03-17 文档创建 2023-11-08 受控版本 上海移远通信技术股份有限公司 3 / 28 LC29D(C) DR 应用指导 目录 关于文档 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 汽车航位推算（ADR）................................................................................................................ 7 2 配置 ........................................................................................................................................................ 8 2.1. 方向 ............................................................................................................................................. 8 2.2. 安装 ........................................................................................................................................... 10 2.3. DR 校准 ..................................................................................................................................... 11 2.4. PQTM 消息................................................................................................................................ 12 2.4.1. PQTMINS ....................................................................................................................... 12 2.4.2. PQTMIMU ...................................................................................................................... 13 2.4.3. PQTMGPS ..................................................................................................................... 14 2.4.4. PQTMCFGEINSMSG..................................................................................................... 15 2.4.5. PQTMVEHMSG ............................................................................................................. 17 2.4.5.1. 当 = 2 ................................................................................................. 17 2.4.6. PQTMCFGWHEELTICK ................................................................................................ 18 2.4.7. PQTMQMPT................................................................................................................... 19 2.4.8. PQTMCFGORIENTATION ............................................................................................. 20 2.4.9. PQTMDRWARM ............................................................................................................ 21 2.4.10. PQTMSETDRDIFFTHD ................................................................................................. 22 2.4.11. PQTMGETDRDIFFTHD................................................................................................. 23 2.4.12. PQTMSETSEED ............................................................................................................ 24 2.4.13. PQTMGETSEED............................................................................................................ 25 2.4.14. PQTMSAVEPAR ............................................................................................................ 26 3 附录 A 参考文档及术语缩写 ............................................................................................................... 27 4 附录 B 特殊字符 ................................................................................................................................. 28 上海移远通信技术股份有限公司 4 / 28 LC29D(C) DR 应用指导 表格索引 表 1：参考文档 ........................................................................................................................................... 27 表 2：术语缩写 ........................................................................................................................................... 27 表 3：特殊字符 ........................................................................................................................................... 28 上海移远通信技术股份有限公司 5 / 28 LC29D(C) DR 应用指导 图片索引 图 1：参考系 X、Y 和 Z 轴方向.................................................................................................................... 8 图 2：模块 X、Y 和 Z 轴方向 ....................................................................................................................... 8 图 3：模块安装示例 1................................................................................................................................... 9 图 4：模块安装示例 2................................................................................................................................... 9 图 5：偏航角............................................................................................................................................... 10 图 6：俯仰角............................................................................................................................................... 10 图 7：横滚角................................................................................................................................................11 上海移远通信技术股份有限公司 6 / 28 LC29D(C) DR 应用指导 1 引言 本文档主要介绍移远通信 LC29D (C)模块的航位推算（DR）功能，包括如何进行 DR 配置以及与 DR 功能相关的语句。 LC29D (C)模块主要用于摩托车和踏板车等两轮车应用中，该模块能够在 GNSS 信号缺失或中断等复 杂环境中，为用户提供更精确、更高可用性和更加完整的定位数据。 1.1. 汽车航位推算（ADR） LC29D (C)模块仅支持 ADR（汽车航位推算）模式，因此该模块需要依赖车辆的速度数据才能正常运 行。通过将这些数据与模块自身的 6 轴传感器读数相结合，LC29D (C)能够在没有 GNSS 信号的环境中为 用户提供更准确和可靠的定位信息。 该模块通过两种方法接收车速数据：一种是通过 WHEELTICK 引脚接收 WHEELTICK 脉冲（详情可参 考文档 [1]硬件设计手册）；另一种是通过 UART 接收累积的车轮计数。为确保最佳性能，需要持续稳定地 向 模 块 注 入 车 速 数 据 ， 注 入 频 率 至 少 为 10 Hz 。 累 积 车 轮 计 数 相 关 命 令 详 情 可 参 考 第 2.4.5 章 PQTMVEHMSG。车辆行驶中若出现任何中断，都会对模块的性能产生不利影响。 上海移远通信技术股份有限公司 7 / 28 LC29D(C) DR 应用指导 2 配置 本章以 LC29D (C)模块为例，介绍模块 DR 功能的配置方法，包括方向、安装、校准。 2.1. 方向 车辆（参考系）X、Y 和 Z 轴参考方向如下图所示。X 轴方向为车辆前进方向，Y 轴方向指向车辆右侧， Z 轴方向垂直车辆向下。 Z 图 1：参考系 X、Y 和 Z 轴方向 模块的 X、Y 和 Z 轴方向如下图所示： Z Y X 图 2：模块 X、Y 和 Z 轴方向 上海移远通信技术股份有限公司 8 / 28 LC29D (C)模块安装示例如下： Z Y X LC29D(C) DR 应用指导 图 3：模块安装示例 1 若模块安装如上图 3 所示，则模块的 X 轴和 Z 轴方向与图 1 参考系的 X 轴和 Z 轴方向相反；模块的 Y 轴方向与参考系的 Y 轴方向相同。因此，相关命令应为$PQTMCFGORIENTATION,1,-XY-Z*66。 Z X Y 图 4：模块安装示例 2 若模块安装如上图 4 所示，则模块的 X 轴方向与图 1 参考系的 Y 轴方向相反；模块的 Y 轴方向与参考 系的 X 轴方向相反；模块的 Z 轴方向与参考系 Z 轴方向相反。因此，相关命令应为 $PQTMCFGORIENTATION,1,-Y-X-Z*4B。 上海移远通信技术股份有限公司 9 / 28 LC29D(C) DR 应用指导 备注 1. 模块可以安装在不同的方向上，以上举例仅供参考。 2. 使用$PQTMSAVEPAR*5A 命令将方向配置保存到 Flash 中，并重启模块。详情请参考第 2.4.14 章 PQTMSAVEPAR。 2.2. 安装 将移远通信 LC29D (C)模块安装在载体上时，模块的偏航角、俯仰角和横滚角与参考系各轴间的偏差 需保持在 5 度以内。 Forward α 图 5：偏航角 Forward β 图 6：俯仰角 上海移远通信技术股份有限公司 10 / 28 Forward LC29D(C) DR 应用指导 Y γ 图 7：横滚角 备注 安装 LC29D (C) 模块时，确保 -5°≤ α ≤ 5°, -5°≤ β ≤ 5°, -5°≤ γ ≤ 5° 。 当 α、β、γ 角度超过 5 度时， 模块定位性能下降。 2.3. DR 校准 在使用航位推算功能前，需要对模块进行校准。 DR 校准步骤如下所示： 步骤1： 将模块牢固地安装在车架上。发生相对于车辆平面的任何位移、旋转或倾斜，都可能导致模 块性能下降和/或无效校准。 步骤2： 应在良好的 GNSS 信号及天空晴朗的情况下进行校准。 步骤3： 给模块上电，然后在平坦的地面上启动车辆并静止至少 30 秒。 步骤4： 在 GNSS 信号良好的情况下行驶，然后模块会自动进行校准，并且在几分钟内完成校准。 步骤5： 当$PQTMINS 的表示组合解决方案（GNSS + DR）时，校准过程结束。详情参考 第 2.4.1 章 PQTMINS。 校准后，车辆行驶轨迹和行驶动力无限制。 备注 如果需要将 DR 校准值保存到 Flash 中，请参考第 2.4.12 章 PQTMSETSEED。 上海移远通信技术股份有限公司 11 / 28 LC29D(C) DR 应用指导 2.4. PQTM 消息 本章介绍了移远通信 LC29D (C)模块支持的 PQTM 消息（由 Quectel 定义的 NMEA 专有语句）。 2.4.1. PQTMINS 输出融合后的导航信息。 类型： 输出 格式： $PQTMINS,,,,,,,,,,,* 参数： 字段 格式 十进制 单位 毫秒 十进制 - 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 度 度 米 米/秒 米/秒 米/秒 度 度 描述 自上电后的毫秒计数。32 位无符号整数 方案类型： 0 = DR 功能未就绪，横滚角与俯仰角已就绪 1 = DR 功能未就绪，GNSS、横滚角、俯仰角和相对 偏航角已就绪 2 = GNSS + DR 模式，DR 已校准 3 = 仅 DR 模式 纬度 经度 地球的椭球面高度 向北速度 向东速度 向下速度 横滚角 俯仰角 上海移远通信技术股份有限公司 12 / 28 LC29D(C) DR 应用指导 字段 格式 十进制 单位 度 描述 偏航角 示例： $PQTMINS,42529,1,31.822038000,117.115182800,67.681000,,,,-0.392663,1.300793,0.030088*4D 备注 范围为-180.0~179.9，并在-180/+180.0 处环绕到 0.0。 -180.0/ +180.0= 南，0.0 = 北，+90.0 = 东，-90.0 = 西。 2.4.2. PQTMIMU 输出 IMU 原始数据：加速度、角速度和车轮计数。 类型： 输出 格式： $PQTMIMU,,,,,,,,< TickCount>,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 毫秒 g g g 度/秒 度/秒 度/秒 描述 自上电后的毫秒计数。32 位无符号整数。 X 轴方向上的加速度 Y 轴方向上的加速度 Z 轴方向上的加速度 X 轴方向上的角速度 Y 轴方向上的角速度 Z 轴方向上的角速度 上海移远通信技术股份有限公司 13 / 28 LC29D(C) DR 应用指导 字段 格式 十进制 十进制 单位 毫秒 描述 累计车轮计数 上一次的时间戳 示例： $PQTMIMU,42634,-0.006832,-0.022814,1.014552,0.315000,-0.402500,-0.332500,0,0*55 2.4.3. PQTMGPS 输出仅 GNSS 模式下的位置信息。 类型： 输出 格式： $PQTMGPS,,,,,,,,,,,,,,* 参数： 字段 格式 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 十进制 单位 毫秒 秒 度 度 米 米 米/秒 度 米 描述 自上电后的毫秒计数。32 位无符号整数 周内秒 纬度 经度 地球的椭球面高度 平均海平面以上高度（大地水准面） 对地速度（二维平面） 车辆航向（二维平面） 水平精度估计 上海移远通信技术股份有限公司 14 / 28 LC29D(C) DR 应用指导 字段 格式 十进制 十进制 十进制 十进制 单位 - - - 描述 水平精度因子 位置（3D）精度因子 定位类型 0 = 未定位 1 = 2D 定位 2 = 3D 定位 导航卫星数量 示例： $PQTMGPS,671335,463792.000,31.822084600,117.115221100,59.4260,63.0420,0.0270,-171.7101,5.9 890,1.3300,2.1100,3,18*59 2.4.4. PQTMCFGEINSMSG 设置/获取 PQTMINS、PQTMIMU 和 PQTMGPS 语句配置，可配置是否输出上述语句。 类型： 设置/获取 格式： //设置语句配置： $PQTMCFGEINSMSG,,,,,* //获取语句配置： $PQTMCFGEINSMSG,* 参数： 字段 格式 单位 十进制 - 十进制 - 描述 设置/获取消息配置 0 = 获取当前设置 1 = 设置消息配置 启用/禁用 PQTMINS 消息的输出 0 = 禁用 1 = 启用 上海移远通信技术股份有限公司 15 / 28 LC29D(C) DR 应用指导 字段 格式 单位 十进制 - 十进制 - 十进制 Hz 描述 启用/禁用 PQTMIMU 消息的输出 0 = 禁用 1 = 启用 启用/禁用 PQTMGPS 消息的输出 0 = 禁用 1 = 启用 ⚫ 设置 PQTMINS 和 PQTMIMU 的输出频率，可以 设置为 10、20、50 和 100。 当设置输出速率为 100 Hz 时，需要适当调整 UART 输出的波特率。 ⚫ PQTMGPS 语句始终为 1Hz 输出。 结果： ⚫ 如果成功，模块返回： $PQTMCFGEINSMSGOK*16 ⚫ 如果失败，模块返回： $PQTMCFGEINSMSGERROR*4A 示例： //设置消息配置 $PQTMCFGEINSMSG,1,1,1,1,10*3F $PQTMCFGEINSMSGOK*16 //获取消息配置 $PQTMCFGEINSMSG,0*0E $PQTMEINSMSG,0,1,1,1,10*7C 备注 1. 为了使配置的参数生效，需要发送$PQTMSAVEPAR*5A 命令进行保存并且重启模块。详情参考 第 2.4.14 章 PQTMSAVEPAR。 2. 若 Set 类型命令中的参数未体现默认值，用户可使用相应的 Get 命令进行查询，前提是默认值未经 Set 命令进行更改。若默认值已通过 Set 命令更改且用户仍需了解相关默认值，请联系移远通信技术 支持（support@quectel.com）获取相关默认值信息。 上海移远通信技术股份有限公司 16 / 28 LC29D(C) DR 应用指导 2.4.5. PQTMVEHMSG 输入/输出车速信息。 类型： 输入/输出 格式： $PQTMVEHMSG,[,,…,]* 参数： 字段 ,…, 格式 十进制 - 单位 描述 消息类型 - 2 = 通过 UART 输入/输出累计车轮计数 此字段会根据实际语句发生变化；请参考第 2.4.5.1 章 - 当 = 2 获取详细信息。 2.4.5.1. 当 = 2 格式： $PQTMVEHMSG,2,,,* 参数： 字段 格式 十进制 十进制 十进制 单位 毫秒 - 描述 自上电后的毫秒计数。32 位无符号整数 当语句为输入类型时，此值始终为 0 累计车轮计数 预留且始终为 1 结果： 返回带有时间戳的输入累计车轮计数。 $PQTMVEHMSG,2,,,* 上海移远通信技术股份有限公司 17 / 28 示例： //输入累计车轮计数 $PQTMVEHMSG,2,0,100,1*18 //输出累计车轮计数 $PQTMVEHMSG,2,153954,100,1*27 备注 当通过 UART 输入车轮计数时，请确保输入速率至少为 10 Hz。 LC29D(C) DR 应用指导 2.4.6. PQTMCFGWHEELTICK 设置/获取车轮计数引脚触发方式以及车轮刻度值。 类型： 设置/获取 格式： $PQTMCFGWHEELTICK,,,,* 参数： 字段 格式 十进制 单位 - 十进制 - 十进制 - 十进制 米 描述 设置/获取车轮计数引脚触发方式以及车轮刻度值。 0 = 获取当前的配置 1 = 设置车轮计数引脚触发方式以及车轮刻度值 车轮计数引脚触发方式 0 = 上升沿 1 = 下降沿 车轮计数引脚电平状态 0 = 高阻态 1 = 上拉 2 = 下拉 车轮刻度值，默认值为 0.25 上海移远通信技术股份有限公司 18 / 28 LC29D(C) DR 应用指导 结果： ⚫ 如果成功，模块返回： $PQTMCFGWHEELTICKOK*18 ⚫ 如果失败，模块返回： $PQTMCFGWHEELTICKERROR*44 示例： //设置车轮计数引脚触发方式以及车轮刻度值 $PQTMCFGWHEELTICK,1,0,0,0.25*34 $PQTMCFGWHEELTICKOK*18 //获取当前设置 $PQTMCFGWHEELTICK,0*00 $PQTMWHEELTICK,0,0,0,0.250000*77 备注 为 使 上 述 命 令 生 效 ， 使 用 $PQTMSAVEPAR*5A 保 存 更 改 并 重 启 模 块 。 请 参 考 第 2.4.14 章 PQTMSAVEPAR 获取详细信息。由于设置会存在误差，值会实时进行修正。 2.4.7. PQTMQMPT 查询当前车轮刻度值。 类型： 命令 格式： $PQTMQMPT* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMMPT,* 上海移远通信技术股份有限公司 19 / 28 LC29D(C) DR 应用指导 字段 格式 十进制 单位 米 描述 当前车轮刻度值 ⚫ 如果失败，模块返回： $PQTMQMPTERROR*58 示例： $PQTMQMPT*00 $PQTMMPT,0.250000*64 备注 虽然车轮刻度值由 $PQTMCFGWHEELTICK 中的设置，但是在行驶的过程中 DR 引擎时始终计 算车轮刻度值。因此命令获取的刻度值为实时值。 2.4.8. PQTMCFGORIENTATION 设置/获取安装方向。 类型： 设置/获取 格式： $PQTMCFGORIENTATION,,* 参数： 字段 格式 单位 十进制 - 字符串 - 描述 设置/获取安装方向。 0 = 获取当前的配置 1 = 设置安装方向 安装方向。可为 X、Y、Z 或-X、-Y、-Z。 默认值：'-Y-X-Z'。请参考第 2.1 章方向获取详细信息 上海移远通信技术股份有限公司 20 / 28 LC29D(C) DR 应用指导 结果： ⚫ 如果成功，模块返回： $PQTMCFGORIENTATIONOK*08 ⚫ 如果失败，模块返回： $PQTMCFGORIENTATIONERROR*54 示例： //设置安装方向 $PQTMCFGORIENTATION,1,-Y-X-Z*4B $PQTMCFGORIENTATIONOK*08 //获取当前方向配置 $PQTMCFGORIENTATION,0*10 $PQTMORIENTATION,0,-Y-X-Z*08 备注 为使上述命令生效，用$PQTMSAVEPAR*5A 命令保存并重启模块。请参考第 2.4.14 章 PQTMSAVEPAR 获取详细信息。 2.4.9. PQTMDRWARM 重置 DR 校准值。发送该命令后，需要重新校准 DR 校准值。 类型： 命令 格式： $PQTMDRWARM* 参数： 无 上海移远通信技术股份有限公司 21 / 28 结果： ⚫ 如果成功，模块返回： $PQTMDRWARMOK*03 ⚫ 如果失败，模块返回： $PQTMDRWARMERROR*5F 示例： $PQTMDRWARM*07 $PQTMDRWARMOK*03 LC29D(C) DR 应用指导 2.4.10. PQTMSETDRDIFFTHD 设置 DR 状态初始化条件。如果满足用户设置的参数，DR 将被重置。 类型： 设置 格式： $PQTMSETDRDIFFTHD,,* 参数： 字段 格式 十进制 十进制 单位 米 - 描述 GNSS 原始位置与 DR 组合位置之间的最大偏移距离。 最小使用卫星数量 结果： ⚫ 如果成功，模块返回： $PQTMSETDRDIFFTHDOK*1D ⚫ 如果失败，模块返回： $PQTMSETDRDIFFTHDERROR*41 上海移远通信技术股份有限公司 22 / 28 LC29D(C) DR 应用指导 示例： $PQTMSETDRDIFFTHD,100,10*29 $PQTMSETDRDIFFTHDOK*1D 备注 1. 字段推荐范围为 80~150 米。默认值为 0，表示该功能被禁用。 2. 字段推荐范围为 8~10。如果使用的卫星数没有达到设定的数量，但 GNSS 原始位置与 DR 组合位置的偏移距离大于 300 米，DR 状态也会被初始化。 3. 为使上述命令生效，使用$PQTMSAVEPAR*5A 保存更改。有关该消息的详细信息，请参阅第 2.4.14 章 PQTMSAVEPAR 获取详细信息。。 2.4.11. PQTMGETDRDIFFTHD 获取 DR 初始化条件。 类型： 获取 格式： $PQTMGETDRDIFFTHD,* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMDRDIFFTHD,,* ⚫ 如果失败，模块返回： $PQTMGETDRDIFFTHDERROR*55 示例： $PQTMGETDRDIFFTHD*0D $PQTMDRDIFFTHD,100,10*6B 上海移远通信技术股份有限公司 23 / 28 LC29D(C) DR 应用指导 2.4.12. PQTMSETSEED 设置是否将 DR 校准值保存到 Flash 中。发送该命令后，DR 校准参数将保存到 Flash 中，保存在 Flash 中的 DR 校准值将在下次启动后直接使用。 类型： 设置 格式： $PQTMSETSEED,* 参数： 字段 格式 单位 十进制 - 描述 是否将 DR 校准值保存到 Flash 中。 0 = 不保存 1 = 保存 结果： ⚫ 如果成功，模块返回： $PQTMSETSEEDOK*49 ⚫ 如果失败，模块返回： $PQTMSETSEEDERROR*15 示例： $PQTMSETSEED,1*50 $PQTMSETSEEDOK*49 备注 为 了 使 上 述 命 令 生 效 ， 使 用 $PQTMSAVEPAR*5A 保 存 更 改 。 详 细 信 息 请 参 阅 第 2.4.14 章 PQTMSAVEPAR 获取详细信息。 上海移远通信技术股份有限公司 24 / 28 LC29D(C) DR 应用指导 2.4.13. PQTMGETSEED 获取是否将 DR 校准值保存到 Flash 中。 类型： 获取 格式： $PQTMSETSEED* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMGETSEED,* 字段 格式 单位 十进制 - ⚫ 如果失败，模块返回： $PQTMGETSEEDERROR*01 描述 是否将 DR 校准值保存到 Flash 中。 0 = 不保存 1 = 保存 示例： $PQTMGETSEED*59 $PQTMGETSEED,1*44 上海移远通信技术股份有限公司 25 / 28 2.4.14. PQTMSAVEPAR 保存配置到 Flash 中。 类型： 命令 格式： $PQTMSAVEPAR* 参数： 无 结果： ⚫ 如果成功，模块返回： $PQTMSAVEPAROK*5E ⚫ 如果失败，模块返回： $PQTMSAVEPARERROR*02 示例： $PQTMSAVEPAR*5A $PQTMSAVEPAR,OK*5E LC29D(C) DR 应用指导 上海移远通信技术股份有限公司 26 / 28 LC29D(C) DR 应用指导 3 附录 A 参考文档及术语缩写 表 1：参考文档 文档名称 [1] Quectel_LC29D 系列_硬件设计手册 表 2：术语缩写 缩写 ADR DR GNSS GPS HDOP IMU NMEA PDOP UART 英文全称 中文全称 Automotive Dead Reckoning 汽车航位推算 Dead Reckoning 航位推算 Global Navigation Satellite System 全球导航卫星系统 Global Positioning System 全球定位系统 Horizontal Dilution of Precision 水平精度因子 Inertial Measurement Unit 惯性测量单元 NMEA (National Marine Electronics Association) NMEA（美国国家海洋电子协会）0183 0183 Interface Standard 接口标准 Position Dilution of Precision 位置精度因子 Universal Asynchronous Receiver/Transmitter 通用异步接收器/发送器 上海移远通信技术股份有限公司 27 / 28 4 附录 B 特殊字符 表 3：特殊字符 特殊字符 […] {…} 下划线 描述 回车符 换行符 参数名称（实际命令行中不包含尖括号） 可选参数（实际命令行中不包含中括号） 循环参数（实际命令行中不包含大括号） 参数的默认设置 LC29D(C) DR 应用指导 上海移远通信技术股份有限公司 28 / 28

BC25&BC32 系列 软件注意事项及 FAQ NB-IoT 模块系列 版本：2.0 日期：2021-05-14 状态：受控文件 Quectel BC25&BC32 系列软件注意事项及 FAQ 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 文档历史 修订记录 版本 1.0 1.1 2.0 日期 作者 变更表述 2019-07-22 2019-11-26 2021-05-14 Claire ZHANG/ Albert ZHANG/ Quinten SONG Claire ZHANG Koala LI 文档创建 1. 已支持中国移动 OneNET 和中国电信物联网平台模块 休眠保存连接信息功能，更新了相关描述； 2. 已支持 AT 命令 AT+NCFG 和 AT+NMSTATUS，删除 了命令的 '*'，并更新了 Lifetime 配置注意事项； 3. 更新异常恢复部分备注； 4. 更新关于模块进入深度睡眠时间的解答。 1. 新增 BC32 模块及相关内容； 2. 重新规划文档内容，新增部分注意事项和常见问题； 3. 删除部分注意事项及常见问题。 上海移远通信技术股份有限公司 2 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 目录 文档历史 ................................................................................. 2 目录..................................................................................... 3 表格索引 ................................................................................. 7 图片索引 ................................................................................. 8 1 引言 ....................................................................................................................................................... 9 2 注意事项 .............................................................................................................................................. 10 2.1. 产品介绍 ................................................................................................................................... 10 2.2. 固件烧录 ................................................................................................................................... 10 2.2.1. 固件包说明 .................................................................................................................... 10 2.2.1.1. 获取固件包和相关资料 ....................................................................................... 11 2.2.1.2. 固件包文件介绍 .................................................................................................. 11 2.2.2. 固件包下载 .................................................................................................................... 11 2.3. 常用工具 ................................................................................................................................... 13 2.3.1. Log 抓取工具（CoolWatcher）..................................................................................... 13 2.3.2. 串口工具（QCOM） ..................................................................................................... 13 2.4. 串口特性 ................................................................................................................................... 14 2.4.1. 波特率配置 .................................................................................................................... 14 2.5. 网络注册流程： ........................................................................................................................ 15 2.6. DFOTA ..................................................................................................................................... 15 2.7. 低功耗管理 ............................................................................................................................... 16 2.7.1. 休眠模式 ........................................................................................................................ 16 2.7.2. 模块工作状态................................................................................................................. 16 3 FAQ（常见问题解答）........................................................................................................................ 18 3.1. 产品信息相关............................................................................................................................ 18 3.1.1. 如何选择合适的产品型号？ ........................................................................................... 18 3.1.2. 如何获取模块的版本和相关文档？ ................................................................................ 18 3.1.3. 如何获取模块的认证信息？ ........................................................................................... 18 3.1.4. BC25 的低压版本和标准电压版本的区别是什么？ ....................................................... 18 3.1.5. 模块是否可以直接在海外使用？.................................................................................... 18 3.1.6. BC25&BC32 系列模块是否支持 R14 功能？ ................................................................ 18 3.1.7. BC25 系列使用 AT+QPOWD=1 关机需注意什么？ ...................................................... 19 3.1.8. 模块硬件开机设计需注意什么？.................................................................................... 19 3.2. 固件升级失败的原因................................................................................................................. 19 3.2.1. 模块进入深休眠 ............................................................................................................. 19 3.2.2. 串口芯片不支持 921600 bps 波特率 ............................................................................. 19 3.2.3. 模块未开机导致下载失败............................................................................................... 20 3.2.4. 串口线或飞线接触不良 .................................................................................................. 20 3.3. 常用工具相关............................................................................................................................ 20 3.3.1. 如何使能 CoolWatcher Log 信息的输出？ .................................................................... 20 3.3.1.1. 模块异常重启如何通过 CoolWatcher 工具导出 dump 文件？............................ 20 上海移远通信技术股份有限公司 3 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.3.2. QCOM 为何无法正常使用？.......................................................................................... 20 3.4. 串口相关 ................................................................................................................................... 20 3.4.1. 主串口默认波特率是多少？ ........................................................................................... 20 3.4.2. 当模块处于深休眠模式，串口能否接收数据？.............................................................. 21 3.4.3. 串口电平匹配不一致怎么办？ ....................................................................................... 21 3.5. (U)SIM 卡相关 .......................................................................................................................... 21 3.5.1. 模块支持的(U)SIM 卡电压是多少？ .............................................................................. 21 3.5.2. (U)SIM_DATA 引脚是否需要加外部上拉电阻？ ........................................................... 21 3.5.3. 模块是否支持(U)SIM 卡热插拔？ .................................................................................. 21 3.5.4. 如何配置物联网卡的 APN 和 PDP 类型？..................................................................... 21 3.5.5. 为什么开机后模块未找到(U)SIM 卡？........................................................................... 22 3.6. 网络注册相关............................................................................................................................ 22 3.6.1. 如何判断模块是否处于连接状态？ ................................................................................ 22 3.6.2. eDRX、PSM 是什么？.................................................................................................. 23 3.6.3. DRX、eDRX、PSM 是否支持配置？............................................................................ 23 3.6.4. 什么是 TAU？................................................................................................................ 23 3.6.5. 如何通过 AT 命令查看 T3324 和 T3412 的值？ ............................................................ 23 3.6.6. 如何查看模块的 PSM 是否开启？ ................................................................................. 24 3.6.7. PSM 状态是否可以进行业务？...................................................................................... 24 3.6.8. R14 相对于 R13 有哪些提升？...................................................................................... 24 3.6.9. AT+CSQ 查询的信号值较大，但为什么发送数据总是失败？....................................... 24 3.6.10. 如何判断 NB-IoT 网络的信号质量？.............................................................................. 24 3.6.11. 发起数据业务之前，需先查询模块是否已成功获取 IP 地址吗？................................... 24 3.6.12. 为什么模块开机后无法注册网络？ ................................................................................ 25 3.6.13. 模块支持哪些网络制式？............................................................................................... 25 3.6.14. 如何清除模块的历史频点信息？.................................................................................... 25 3.6.15. 模块支持哪些时间同步方式？ ....................................................................................... 25 3.6.16. 网络指示功能是否已经开启？ ....................................................................................... 25 3.6.17. 模块支持 NB-IoT 异频组网吗？..................................................................................... 25 3.7. DFOTA 相关 ............................................................................................................................. 26 3.7.1. 模块支持哪些 DFOTA 升级方式 .................................................................................... 26 3.7.2. 下载时上报+QIND: 'FOTA','HTTPEND',6500 的原因可能有哪些？ ........................... 26 3.7.3. 下载时上报+QIND: 'FOTA','HTTPEND',6503 的原因可能有哪些？ ........................... 26 3.7.4. 电信 IoT 平台 DFOTA 升级的要求有哪些？ .................................................................. 26 3.7.5. 模块是否支持升级外部 MCU？ ..................................................................................... 26 3.7.6. 对接电信 IoT/AEP 平台进行固件升级时有哪些注意事项？........................................... 26 3.8. TCP/UDP 相关 ......................................................................................................................... 27 3.8.1. AT+QIOPEN 是否能够连接 IPv6 域名类型的服务器？ ................................................. 27 3.8.2. AT+QIDNSGIP 是否支持 IPv6 域名方式？ ................................................................... 27 3.8.3. 是否支持 UDP service？ ............................................................................................... 27 3.8.4. Buffer 模式下，为什么下发数据没有收到 URC？......................................................... 27 3.8.5. 模块作为服务器最多可以连接几路客户端？ ................................................................. 27 3.8.6. 模块是否可以同时作为服务器和客户端？ ..................................................................... 27 3.8.7. AT+QISEND 发送数据后，SEND OK 是否标志已经发送到服务器？ .......................... 27 上海移远通信技术股份有限公司 4 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.8.8. 配置和的格式要求是什么？ .......................................................... 27 3.8.9. 模块进入 PSM 后是否能收到下行数据？ ...................................................................... 27 3.8.10. AT+QIOPEN 连接 IPv6 服务器如何配置 protocol type？ ............................................. 28 3.8.11. 同时出现 IPv4 和 IPv6 地址时，如何区分？ ................................................................. 28 3.8.12. 关闭 Socket 链路之后，再次执行 AT+QIOPEN 失败 ................................................... 28 3.8.13. 执行域名类的命令解析失败 ........................................................................................... 29 3.8.14. 执行域名类的命令解析慢............................................................................................... 29 3.9. MQTT 相关 ............................................................................................................................... 30 3.9.1. AT+QMTOPEN 是否能够连接 IPv6 域名类型的服务器？............................................. 30 3.9.2. 模块目前是否支持阿里云平台一机一密？ ..................................................................... 30 3.9.3. 阿里云支持的版本有哪些？ ........................................................................................... 30 3.9.4. 深圳地区使用电信卡连接 MQTT 失败 ........................................................................... 30 3.9.5. 设置为 0，阿里云连接失败 .............................................................. 30 3.9.6. 在阿里云平台执行 AT+QMTOPEN 后未及时执行 AT+QMTCONN 被拒连 .................. 30 3.9.7. 阿里云平台针对标准 MQTT 协议的支持情况是怎样的？ .............................................. 30 3.10. 电信物联网平台相关................................................................................................................. 31 3.10.1. 什么是电信 IoT/AEP 平台？ .......................................................................................... 31 3.10.2. AT+NCDPOPEN 命令返回+QLWEVTIND: 1，可能的原因是什么？ ........................... 31 3.10.3. 生命周期（Lifetime）机制的作用是什么？ ................................................................... 31 3.10.4. 模块是否支持手动更新 Lifetime？如何关闭 Lifetime 的自动更新？.............................. 32 3.10.5. 电信 IoT 平台的立即下发与缓存下发有何区别？ .......................................................... 32 3.10.6. 模块对接电信 IoT/AEP 平台是否支持实时收发数据？ .................................................. 32 3.10.7. 对接电信 IoT/AEP 平台，模块发送的数据包长度最大为多少？ ................................... 32 3.10.8. 模块从深休眠唤醒是否可以立即发送数据？ ................................................................. 32 3.10.9. 模块是否支持 BS（Bootstrap）和加密？...................................................................... 33 3.10.10. 模块是否支持 CoAP 协议？ .......................................................................................... 33 3.11. 中国移动 OneNET 相关............................................................................................................ 33 3.11.1. 如何查询模块支持的 OneNET SDK 版本？ .................................................................. 33 3.11.2. 模块是否支持 BS 和加密？ ........................................................................................... 33 3.11.3. 为什么响应平台下发的发现资源请求和订阅请求会失败？ ........................................... 33 3.11.4. 模块注册到 OneNET 平台并进入深休眠模式后是否支持自行恢复？ ........................... 34 3.11.5. 模块从深休眠模式唤醒后上报+MIPLEVENT: 0,4 有什么含义？................................... 34 3.11.6. 执行 AT+MIPLOPEN 注册平台何种情况下会返回+MIPLEVENT: 0,3？....................... 34 3.11.7. 删除了对象（Object），为何平台上还是能看到资源列表？ ........................................ 34 3.11.8. 连接 OneNET 平台后，是否需要经常发送心跳包维持连接？ ...................................... 34 3.11.9. 注册成功后为什么没有下发订阅和发送资源请求？ ...................................................... 34 3.11.10. 对接 OneNET 平台时，是否可以关闭生命周期的自动更新？ ...................................... 34 3.11.11. 对接 OneNET 平台时，执行 AT+MIPLOPEN 失败....................................................... 35 3.11.12. 对接 OneNET 平台时，是否支持实时收发数据？......................................................... 35 3.12. 低功耗管理、休眠模式相关...................................................................................................... 35 3.12.1. 如何进入浅休眠模式？ .................................................................................................. 35 3.12.2. 如何进入深休眠模式？ .................................................................................................. 35 3.12.3. 如何退出浅休眠模式？ .................................................................................................. 36 3.12.4. 如何退出深休眠模式？ .................................................................................................. 36 上海移远通信技术股份有限公司 5 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.12.5. 模块 PSM_EINT 一直拉低是否无法进入深休眠模式？ ................................................. 36 3.12.6. 上报 ENTER PSM 的 URC 之后，为何依然无法进深休眠模式？................................. 36 3.12.7. 深休眠模式唤醒后，模块为何仍然无法接收到平台下发的数据？................................. 36 3.12.8. 关闭了 PSM 和深休眠模式的情况，模块为何收不到平台下发的数据？....................... 36 3.12.9. T3324 时间设置为 0，模块是否可以直接从 Active 态切换至 PSM 模式？................... 36 3.12.10. 如何快速释放 RRC 连接？ ............................................................................................ 37 3.12.11. 深休眠模式下模块自动唤醒，可能的唤醒源有哪些？................................................... 37 3.12.12. 哪些因素会影响模块进入深休眠模式？......................................................................... 37 3.12.13. 什么场景下模块可以进入深休眠模式？......................................................................... 37 3.12.14. 模块进入 PSM 之后为什么 AT 命令不通？ ................................................................... 37 3.12.15. 为什么模块已经进入 PSM 模式，但功耗没有明显降低？............................................. 37 3.12.16. 是否有模块在各种工作模式下的耗流数据？ ................................................................. 37 3.12.17. PSM_EINT 需要拉低多久方可将模块从深休眠模式唤醒？........................................... 37 3.12.18. 按 RESET 复位后，测试的 VDD_EXT 波形为方波形式是否正常？ ............................. 38 3.12.19. 开机或者唤醒时 VDD_EXT 存在方波形式么？ ............................................................. 38 3.12.20. BT 开启状态下无法进深休眠模式.................................................................................. 38 4 附录 参考文档及术语缩写 .................................................................................................................. 39 上海移远通信技术股份有限公司 6 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 表格索引 表 1：产品介绍 ........................................................................................................................................... 10 表 2：参考文档 ........................................................................................................................................... 39 表 3：术语缩写 ........................................................................................................................................... 40 上海移远通信技术股份有限公司 7 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 图片索引 图 1：固件包文件 ....................................................................................................................................... 11 图 2：QCOM 配置 ...................................................................................................................................... 14 图 3：模块开机入网流程 ............................................................................................................................ 15 图 4：模块 Modem 工作模式示意图........................................................................................................... 16 图 5：模块系统工作模式示意图 ................................................................................................................. 17 上海移远通信技术股份有限公司 8 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 1 引言 本文档介绍了移远通信 BC25 和 BC32 系列模块在开发和使用过程中的重要注意事项和常见问题，用 户可以把本文档作为工具手册使用。在项目开发中，如遇到问题，可参考本文档检查是否有相同或者相似 的问题解决方案，以便快速解决问题，提高项目开发效率。 本文档仅适用于 BC25 和 BC32 系列模块。如无特殊说明，文档中所提及的模块均指代 BC25 和 BC32 系列模块。 备注 本文档中涉及的 AT 命令详细信息，若无另外备注，请参考文档 [1]和文档 [2]。 上海移远通信技术股份有限公司 9 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 2 注意事项 2.1. 产品介绍 表 1：产品介绍 项目名称 支持 BAND 主频 BC25 3/5/8 BC25-B5 5 BC25-B8 BC25_BT 8 3/5/8 192 MHz BC32 3/5/8/20/28 BC32-B8 8 芯片架构 芯片操作系统 MIPS SX RTOS 备注 支持 QuecOpen 支持 QuecOpen 支持 QuecOpen 不支持 QuecOpen 不支持 QuecOpen 不支持 QuecOpen 备注 1. BC25 与 M26/BC25/BC26/BC28 硬件设计兼容，具体的硬件设计请参考文档 [3]。 2. 其中 BC32 支持 NB-IoT + GSM 双制式。 2.2. 固件烧录 2.2.1. 固件包说明 模块在出厂时，移远通信会根据订单需求完成对应版本的固件包烧录。收到模块后，用户可通过 ATI 命令查询当前批次的模块固件包版本号。若需反馈问题给移远通信技术支持或者研发解决，请务必提供模 块固件包版本号以辅助分析或复现问题。 上海移远通信技术股份有限公司 10 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 2.2.1.1. 获取固件包和相关资料 可从移远通信技术支持（support@quectel.com）或者代理商处获取最新版本的固件包和相关资料。 备注 如果已拿到模块，请提供模块的固件版本号（通过 ATI 命令查询），移远通信将提供最新版本的固件包。 2.2.1.2. 固件包文件介绍 图 1：固件包文件 备注 1. 如果误烧录了 QuecOpen 的 APP，可烧录文件 APPNB3MDM32A01 将模块恢复到标准模式。 2. 用户需选择 BC25PAR01A05.lod 进行固件烧录。 2.2.2. 固件包下载 本章节以使用 QFlash 工具进行固件包下载为例，介绍固件包下载流程。QFlash 请选择 4.17 之后的版 本。 使用 QFlash 下载固件包前，需对该工具进行参数配置，如下图所示。 上海移远通信技术股份有限公司 11 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 备注 通过模块 debug 口升级固件版本包时，固定波特率为 921600 bps，为了避免下载失败，用户选择的串口 芯片需要稳定支持 921600 bps。 通过 QFlash 下载固件包有两种可选方式，流程如下： ⚫ 方式一：先上电，后拉低 PWRKEY 引脚： 1. 模块插入(U)SIM 卡，并且上电 2. 通过 USB 转 TTL 转接板将 debug 口连接到 PC，尽量使用 FT232 串口转换芯片工具 3. 打开 QFlash 工具，COM 口选择对应的 debug 口，波特率：921600 bps 4. 选择升级文件，选择 BCxxPARxxAxx.lod，比如：BC25PAR01A05.lod 5. 点击 QFlash 工具界面上的的 Start 按钮 6. 拉低模块 PWRKEY 引脚开机，QFlash 进度条显示升级进度时则表示开始下载 上海移远通信技术股份有限公司 12 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ ⚫ 方式二：先拉低 PWRKEY 引脚，后上电： 1. 拉低 PWRKEY 引脚 2. 模块插入(U)SIM 卡 3. 通过 USB 转 TTL 转接板将 debug 口连接到 PC，尽量使用 FT232 串口转换芯片工具 4. 打开 QFlash 工具，COM 口选择对应的 debug 口号，波特率：921600 bps 5. 选择升级文件，选择 BCxxPARxxAxx.lod，比如：BC25PAR01A05.lod 6. 点击 QFlash 工具界面上的 Start 按钮 7. 模块上电（如果已经上电，拉低 Reset 引脚），QFlash 进度条显示升级进度时则表示开始下载 备注 若升级失败，则需先下电，再重新上电，之后重复上述步骤。 2.3. 常用工具 2.3.1. Log 抓取工具（CoolWatcher） BC25&BC32 模块常用的抓包工具是 CoolWatcher，当模块出现异常或者 dump 时，通过应用层的 AT Log 一般很难定位问题，此时需要用户抓取问题的 CoolWatcher log 辅助分析。通常分析如下几类问题需要 抓取 CoolWatcher log： 1. 模块异常重启或死机； 2. 网络相关异常，找网失败或者找网时间过长。 3. 应用协议相关业务失败，比如 TCP 发送数据失败等； 4. 定位其他内核问题。 备注 关于通过 CoolWatcher 抓取 Log 的具体操作步骤，请参考文档 [4]。 2.3.2. 串口工具（QCOM） QCOM 是移远通信开发的一款串口调试工具。QCOM 可实现 PC 端与模块或用户设备进行数据交互、 抓取应用层的 AT Log 以辅助问题分析。 建议在使用 QCOM 工具时，勾选 Show Time 使 Log 显示时间戳，并勾选 Send With Enter 对话框， 以便于分析问题。 上海移远通信技术股份有限公司 13 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 图 2：QCOM 配置 备注 如果需要进行压力测试，可以将 Log 保存在本地.txt 文件中，避免 Log 丢失。 2.4. 串口特性 串口作为外部 MCU 和模块的交互通道，十分重要，建议用户使用主串口（main 串口）同 MCU 进行 数据交互，用 debug 口抓取 CoolWatch Log 和固件升级。 2.4.1. 波特率配置 一般地，建议使用固定的波特率。模块默认波特率为 9600 bps，可通过 AT+IPR 配置串口波特率为自 适应波特率或者其他固定的波特率，该命令配置会立即生效并保存至 NVRAM。 默认波特率 9600 bps，用户可以使用 AT+IPR 配置波特率，该命令立即生效且掉电保存。当模块进入 上海移远通信技术股份有限公司 14 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 深休眠模式后，串口将不能接收 MCU 端发来的数据，如果用户需要发送数据给模块，可以先通过 PSM_EINT 引脚唤醒模块，然后再进行数据业务。 备注 1. MCU 控制 PSM_EINT 唤醒模块后，先发送字符 AT 给模块，模块返回 OK 后，再发送业务 AT。 2. BC25 系列模块是下降沿触发唤醒，BC32 系列模块是低电平触发唤醒。 2.5. 网络注册流程： 模块注册网络流程主要是指从模块开机到 PDP 激活（Attach Complete）的过程。具体的业务流程如 下： 图 3：模块开机入网流程 更多详细信息，请参考文档 [5]和文档 [6]。 2.6. DFOTA DFOTA 指差分固件空中升级，即通过差分包实现固件升级，所述差分包仅包含模块当前运行的固件版 本和升级的目标版本之间的差异，相对于全量升级方式，差分升级以更小的更新包降低了数据传输量、极 大地缩短了传输时间和功耗。 为满足用户的固件包 OTA 升级需要，BC25 模块提供了两种主要的 DFOTA 方式：通过中国电信 上海移远通信技术股份有限公司 15 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ IoT/AEP 平台升级和通过中国移动 OneNET 平台升级。更多详细信息，请参考文档 [7]。 2.7. 低功耗管理 2.7.1. 休眠模式 BC25 和 BC32 系列模块有深休眠和浅休眠两种休眠模式。模块开机默认允许进入深休眠模式，用户可 使用 AT+QSCLK 命令对休眠模式进行控制。 AT+QSCLK 命令说明： ⚫ AT+QSCLK=0：禁用休眠模式。 ⚫ AT+QSCLK=1：启用浅休眠和深休眠，通过 PSM_EINT（下降沿）唤醒。 ⚫ AT+QSCLK=2：仅启用浅休眠，由主 UART 唤醒。 备注 1. AT+QSCLK 参数配置立即生效，且掉电保存。 2. 在深休眠模式下，UART 不会工作。因此，当 AT+QSCLK=1 时，发送 AT 命令之前需确保已经 唤 醒 UART。 3. 当 AT+QSCLK=0 时，模块的 UART 始终处于工作模式。当 AT+QSCLK=0 时，模块始终处于工作 模式。如果需要允许模块进入休眠模式，请重新发送命令 AT+QSCLK=1 或 AT+QSCLK=2。 2.7.2. 模块工作状态 模块 Modem 有 Connected (接收/发送状态)、Idle 和 PSM 三种模式，如下图所示。 耗流 接收状态 发送状态 模块不活动定时器 Idle T3324 PSM T3412 Idle TAU 图 4：模块 Modem 工作模式示意图 上海移远通信技术股份有限公司 16 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 备注 1. DRX 周期不支持配置，也不支持功能的开启或关闭； 2. eDRX 和 PSM 的周期均可配置，也支持功能开启和关闭，但网络是否接受配置取决于运营商设置。 如果网络不支持配置 eDRX 和 PSM 的周期，建议咨询运营商特定 APN 对应的 eDRX、PSM 时长， 以期找到一个符合业务模型的节能周期。 模块系统的工作模式分为唤醒模式（Active）、浅休眠模式（Light Sleep）和深休眠模式（Deep Sleep）， 如下图所示。 Connected CPU Active Idle Software control CPU Light Sleep Software control 1. RTC event 2. PSM_EINT PSM CPU Deep Sleep No data interaction Only 32KHz RTC is active 图 5：模块系统工作模式示意图 上海移远通信技术股份有限公司 17 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3 FAQ（常见问题解答） 3.1. 产品信息相关 3.1.1. 如何选择合适的产品型号？ 前期产品选型请咨询移远通信销售或技术支持（support@quectel.com），模块具体信息请参考文档 [8] 和文档 [9]。 3.1.2. 如何获取模块的版本和相关文档？ ⚫ 如需正式固件版本和相关文档，请咨询移远通信技术支持。 ⚫ 下一个正式固件版本和文档的归档日期，请咨询移远通信技术支持。 ⚫ 如需定制固件版本，请咨询移远通信销售。 3.1.3. 如何获取模块的认证信息？ 关于模块认证的相关信息，请咨询移远通信技术支持。 3.1.4. BC25 的低压版本和标准电压版本的区别是什么？ ⚫ 低压版本（BC25PA）：2.1~3.6 V，典型值 3.3 V。 ⚫ 标准版本（BC25PB）：3.2~4.2 V，典型值 3.8 V。 3.1.5. 模块是否可以直接在海外使用？ 不建议直接在海外使用 BC25 系列模块。由于国内外模块认证以及支持的频段不同，在海外模块可能 无法正常工作或者嵌入模块的整机产品可能无法通过最终认证。对于海外市场，建议使用针对海外市场的 模块型号，如有需要，请联系移远通信销售。 3.1.6. BC25&BC32 系列模块是否支持 R14 功能？ BC25&BC32 系列模块支持 R14，但默认不打开 R14 功能。如需默认打开 R14，请咨询当地运营商目 前 R14 是否已经稳定覆盖。具体打开的方式如下： 1) AT+nvsetreleaseversion? 查询支持 R13 还是 R14（0：R13，1：R14） 上海移远通信技术股份有限公司 18 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 2) 发送 AT+nvsetreleaseversion=1 3) 发送 AT+nvsetreleaseversion=0 打开 R14，重启生效，掉电保存。 打开 R13，重启生效，掉电保存。 备注 如果当地运营商不支持 R14，即使模块侧开启了 R14 功能，模块仍将在 R13 下工作。 3.1.7. BC25 系列使用 AT+QPOWD=1 关机需注意什么？ BC25 系列模块上电开机需要通过拉低 PWRKEY 大于 1000 毫秒。如果通过执行 AT+QPOWD=1 将正 在运行中的模块关机，那么拉低 PWRKEY 不能开机，只能通过拉低 PSM_EINT 引脚开机。 3.1.8. 模块硬件开机设计需注意什么？ BC25 和 BC32 系列模块在给 VBAT 上电之前，其电压应低于 0.5 V，以保证 VBAT 上电后 PWRKEY 正 常初始化。对于客户项目在模块关闭后立即再次开机的情况，要特别注意模块再次开机前，VBAT 电压是否 已降到 0.5 V 以下。 3.2. 固件升级失败的原因 固件升级失败的原因一般有四种，下文分小节进行阐述。 3.2.1. 模块进入深休眠 如果模块未插卡，则开机后大约 3~5 秒进入深休眠（AT+QSCLK=1）或浅休眠（AT+QSCLK=2）， 导致串口不通，下载失败。可以通过如下方法解决： 步骤一：给模块插卡 步骤二：开机执行 AT+QSCLK=0 禁止模块进入深休眠或浅休眠。 3.2.2. 串口芯片不支持 921600 bps 波特率 由于模块 debug 口波特率只支持 921600 bps，如果用户设备的串口芯片不支持 921600 bps 波特率， 将会导致下载失败。解决方法是更换串口芯片，推荐使用如下串口芯片： 1. 四路串口芯片 FT4232 2. 两路串口芯片 XR21V1412 3. 单路串口芯片 CP2102、XR21B111L16 上海移远通信技术股份有限公司 19 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.2.3. 模块未开机导致下载失败 使用 PWRKEY 开机和使用 RESET 复位模块，至少需要拉低引脚 1000 毫秒以上，否则模块无法正常 开机。另外可以通过 VDD_EXT 电压来判断模块是否开机成功，如果开机成功，BC25 系列 VDD_EXT 电 压为 1.8 V，BC32 系列 VDD_EXT 电压为 2.8 V。 3.2.4. 串口线或飞线接触不良 排除上述原因后，请检查串口线或飞线是否接触不良。 3.3. 常用工具相关 3.3.1. 如何使能 CoolWatcher Log 信息的输出？ 移远通信对外的正式版本固件默认不吐 CoolWatch Log，用户可以通过发送 AT^TRACECTRL=1 打开 调试开关。此 AT 命令立即生效，掉电保存。 3.3.1.1. 模块异常重启如何通过 CoolWatcher 工具导出 dump 文件？ 移远通信对外的正式版本固件默认打开看门狗，当设备因为异常 dump 时会自动重启。 如需分析 dump 原因，需复现 dump 并将生成的 dump 文件（20 个）导出后打包提供给移远通信技术 支持。导出 dump 文件需先发送 AT^FORCENOWDT=1 关闭看门狗（此 AT 命令立即生效，掉电不保存）， 再复现 dump。当模块出现 dump 时，在 CoolWatcher 的命令行输入 elfdump('E:/xxx.elf')，即可将 dump 文件导入到 E 盘（导入地址可自定义）。 3.3.2. QCOM 为何无法正常使用？ 无法正常使用 QCOM 的常见原因如下： ⚫ 串口选择错误或串口被占用。请确认主串口是否可以正常使用。 ⚫ 未勾选 Send With Enter，导致 AT 命令发送后没有返回。请在配置 QCOM 工具时勾选 Send With Enter。 3.4. 串口相关 3.4.1. 主串口默认波特率是多少？ 主串口默认波特率为 9600 bps，可以使用 AT+IPR 配置波特率。该命令立即生效，且深休眠唤醒后有 上海移远通信技术股份有限公司 20 / 42 效，自动保存至 NVRAM。 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.4.2. 当模块处于深休眠模式，串口能否接收数据？ 当模块处于深休眠模式时，串口无法收发数据。可以先通过拉低 PSM_EINT 引脚唤醒模块，再进行数 据业务。 备注 MCU 控制 PSM_EINT 下降沿唤醒模块后，应先发送命令 AT 给模块，待模块返回 OK 后，再发送业务 AT。为避免模块唤醒后，还没有发送 AT 就再次进入休眠模式，PSM_EINT 引脚需等待模块返回 OK 后 再拉高。 3.4.3. 串口电平匹配不一致怎么办？ 如果模块的串口电压和外部 MCU 的串口电平不一致，需要在硬件上做电路匹配。具体的电路实现方法， 请参考文档 [10]和文档 [11] 的串口部分介绍。 3.5. (U)SIM 卡相关 3.5.1. 模块支持的(U)SIM 卡电压是多少？ 模块支持并能自动识别 1.8 V 和 3.0 V 的(U)SIM 卡。 3.5.2. (U)SIM_DATA 引脚是否需要加外部上拉电阻？ 按照硬件设计手册要求，(U)SIM_DATA 引脚需在外部增加 10 kΩ 上拉电阻，否则可能会出现个别设备 识别卡失败或者模块和(U)SIM 卡交互概率性失败的问题。 3.5.3. 模块是否支持(U)SIM 卡热插拔？ 模块不支持(U)SIM 卡热插拔功能。当发生掉卡时，模块会上报+CPIN: NOT READY，MCU 检测到该 URC 时，可以通过重启或者执行 AT+CFUN=0/1 发起重新找卡。 3.5.4. 如何配置物联网卡的 APN 和 PDP 类型？ 目前国内运营商均支持 MME 自动修正 APN，因此配置错误的 APN 也能接入网络。但不建议随意配置， 因为运营商不同的 APN 会配置不同的网络参数，这将影响 T3324/T3412 的值，进而影响终端的功耗。而 PDP 类型配置错误，将导致不能入网。 上海移远通信技术股份有限公司 21 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 请参考如下 AT 命令配置 APN，该命令仅对默认激活的 PDP 有效（开机自动激活），其他多路 PDP 的配置请使用 AT+CGDCONT 和 AT+CGACT 命令。 //配置 APN 举例 AT+QCGDEFCONT? +QCGDEFCONT: 'IP','ims',,, //查询模块当前的 APN 设置 //采用 IPv4，APN 为 ims OK AT+QCGDEFCONT='IP' OK //设置 APN 参数为空，即使用默认 APN 3.5.5. 为什么开机后模块未找到(U)SIM 卡？ 插入(U)SIM 卡并开机后模块返回+CPIN: NOT READY 或者 NOT INSERTED，说明模块未找到(U)SIM 卡。请从以下方面分析解决： ⚫ (U)SIM 卡与卡座接触不良。可以尝试在(U)SIM 卡上增加垫片。 ⚫ SMT 焊接不良。可以通过万用表测试模块与(U)SIM 卡焊盘之间的连通性。 ⚫ (U)SIM 卡已损坏。可以将(U)SIM 卡放在 EVB 或者手机上测试，确认是否正常。 ⚫ VBAT 电源走线过于靠近(U)SIM 信号线。如果 VBAT 电源走线过于靠近(U)SIM 信号线，可能会由 于 VBAT 电源线上的纹波太大，干扰到(U)SIM 卡各个信号线，导致(U)SIM 卡无法识别，可尝试切 断附近的 VBAT 线，通过其他途径单独给模块供电，看问题是否解决。 ⚫ (U)SIM 卡座和模块距离较远，走线过长，或信号线未作地屏蔽处理。如果(U)SIM 卡座和模块距离 较远，走线过长，各个信号线未作地屏蔽处理，很有可能导致(U)SIM 卡无法识别，可以尝试使用 较短的飞线直接连接模块到卡座。 ⚫ (U)SIM 卡信号线上并联的 ESD 保护器件寄生电容过大。(U)SIM 卡信号线上并联的 ESD 保护器 件的寄生电容需要 ≤ 50 pF，过大可能会导致(U)SIM 卡无法识别，可尝试直接去掉该 ESD 保护器 件查看问题是否消失。 ⚫ 周边环境有干扰。确认测试现场周围是否有超强电/磁场存在，比如高压输电线、大功率无线设备 等，可以尝试使用一个屏蔽罩盖住(U)SIM 卡以及(U)SIM 卡各个信号线的走线，或者在走线间增加 地屏蔽，检查问题是否消失。 3.6. 网络注册相关 3.6.1. 如何判断模块是否处于连接状态？ 通过 AT+CSCON?可查询模块 Modem 是否处于已连接（Connected）状态。 //查询模块状态 AT+QCSCON? +CSCON: 1,1 //已连接状态 OK 上海移远通信技术股份有限公司 22 / 42 //查询模块状态 AT+QCSCON? +CSCON: 1,0 //空闲状态 OK Quectel BC25&BC32 系列软件注意事项及 FAQ 3.6.2. eDRX、PSM 是什么？ eDRX、PSM 都是节能技术，其中 PSM 是 3GPP Rel-12 引入的，eDRX 是 3GPP Rel-13 引入的。 ⚫ eDRX（Extended Discontinuous Reception）：扩展非连续接收，在该模式下只能在 PTW 时间 窗内监听下行，最长周期可达 2.91 小时； ⚫ PSM（Power Saving Mode）：节能模式。在该模式下，下行不可达，模块不能响应网络寻呼， 也不能接收网络下发的数据。模块只能通过发送上行数据，或者 TAU 定时器超时唤醒，最长周期 可达 410 多天。 3.6.3. DRX、eDRX、PSM 是否支持配置？ DRX 周期不支持配置，也不支持功能开启或关闭；eDRX 和 PSM 的周期均可配置，也支持功能开启 和关闭，但网络是否接受配置依赖于运营商设置。如果网络不支持配置 eDRX 和 PSM 的周期，建议咨询运 营商特定 APN 对应的 eDRX、PSM 时长，以期找到一个符合业务模型的节能周期。 3.6.4. 什么是 TAU？ TAU 是终端和运营商核心网之间的状态同步、位置同步的消息，可以理解成 NB-IoT 网络的心跳包。 TAU 一般包括周期性的 TAU 和非周期性的 TAU。当 T3412/T3412ext (extended) 定时器超时就会触 发周期性的 TAU。而触发非周期性的 TAU 的常见原因有：小区发生变化且变化前后小区所属的 TAC 不同、 PLMN 发生变化、开启/关闭 PSM、开启/关闭 eDRX 等。 3.6.5. 如何通过 AT 命令查看 T3324 和 T3412 的值？ 设置 AT+CEREG=5 时，通过 AT+CEREG?命令可以查询 T3324 和 T3412ext 的值；T3412 的值暂不 支持 AT 命令方式查询。 T3324 T3412ext 如果 T3412ext 值存在，周期性位置更新将使用这个值；如果不存在，将使用 T3412 值。但 T3412 值， 目前无法通过 AT 命令查询。关于 AT+CEREG 查询的结果具体值表示多少，请参考文档 [1]和文档 [2]。 上海移远通信技术股份有限公司 23 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.6.6. 如何查看模块的 PSM 是否开启？ 执行 AT+CPSMS?，若返回的第一个参数 =1，表示开启了 PSM；若 =0，表示关闭 了 PSM。 备注 请注意，开启 PSM 模式并不代表模块可以进入 PSM 模式，还需要查看网络是否开启了 PSM。最终能否 进入该模式仍然取决于模块当前注册的基站是否支持 PSM 模式。 3.6.7. PSM 状态是否可以进行业务？ PSM 状态下，射频功能是关闭的，因此无法收到下行业务数据。但是，若有上行业务，模块会自动开 启射频功能，退出 PSM 状态。因此，在 PSM 状态下，需先发送上行数据才能接收下行业务。 3.6.8. R14 相对于 R13 有哪些提升？ 相对于 R13，R14 网络接入容量和速率有所提升。一方面，R14 网络支持多达 15 个 non-anchor 载波 同时接入，且 non-anchor 载波上支持 RACH 和 paging，网络容量相比 R13 有较大的提升。另一方面，R14 支持 2-HARQ 和更大的传输块（TBS），因此传输速率较 R13 也有一定的提升。 3.6.9. AT+CSQ 查询的信号值较大，但为什么发送数据总是失败？ AT+CSQ 查询的值为 RSSI（接收信号强度指示），表示一个频率上的总的电平值，其中不仅包含有 用信号，也包含无用的干扰、噪声。因此，信号值大并不代表信号较佳。对于 NB-IoT 模块，信号质量并不 是关键指标，用户可通过 AT+QENG=0 查询信号质量相关参数。 3.6.10. 如何判断 NB-IoT 网络的信号质量？ NB-IoT 网络信号质量一般通过 RSRP（参考信号接收功率）和 SNR（信噪比）值来综合判断。 ⚫ RSRP > -100 dBm 且 SNR > 3 dB：业务比较稳定，成功率高。 ⚫ -110 dBm < RSRP < -100 dBm 且 -3 dB < SNR < 3 dB：业务稳定性相对较差，成功率可能会受 影响。 ⚫ RSRP < -115 dBm 或 SNR < -3 dB：业务失败的概率相对较高，影响业务成功率。 3.6.11. 发起数据业务之前，需先查询模块是否已成功获取 IP 地址吗？ 模块在发起数据业务之前，需通过 AT+CGPADDR?查询 IP 是否已经分配成功。只有当模块获取到本 地 IP 地址后，才可以发起数据业务。 上海移远通信技术股份有限公司 24 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.6.12. 为什么模块开机后无法注册网络？ 模块开机后无法注册网络，请检查如下方面是否存在异常： ⚫ 执行 AT+CPIN?确认模块是否找到(U)SIM 卡。 ⚫ 确认(U)SIM 卡是否欠费。 ⚫ 分别执行 AT+QBAND?和 AT+CFUN?确认设置的模块工作频段是否有效以及工作模式是否为全 部功能模式（AT+CFUN=1）。 ⚫ 执行 AT+QENG=0 确认模块射频信号是否正常。 3.6.13. 模块支持哪些网络制式？ BC25 仅支持 NB-IoT，不支持其他的网络制式。BC32 支持 NB-IoT 和 GSM。 3.6.14. 如何清除模块的历史频点信息？ 使用 AT+QCSEARFCN 可清除先验频点信息，该命令只能在 AT+CFUN=0 的模式下执行，并在切换 至 AT+CFUN=1 后生效，配置自动保存至 NVRAM。 3.6.15. 模块支持哪些时间同步方式？ 模块支持两种时间同步方式：NTP 时间同步和网络下发时间同步。 ⚫ 使用 AT+CCLK 查询当前日期和时间。 ⚫ 使用 AT+QNTP 指定通过 NTP 服务器同步时间并更新到 RTC。 模块在收到网络下发的 EMM INFORMATION 消息后，会自动同步时间到 RTC。 3.6.16. 网络指示功能是否已经开启？ 已开启。模块通过网络指示灯指示网络状态。 3.6.17. 模块支持 NB-IoT 异频组网吗？ 模块支持异频重选和同频重选。如何组网由运营商决定，模块端不可配置。 上海移远通信技术股份有限公司 25 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.7. DFOTA 相关 3.7.1. 模块支持哪些 DFOTA 升级方式 两种方式：HTTP 升级和中国电信 IoT/AEP 平台升级。 3.7.2. 下载时上报+QIND: 'FOTA','HTTPEND',6500 的原因可能有哪些？ 可能是配置有误，建议检查、和是否正 确。 3.7.3. 下载时上报+QIND: 'FOTA','HTTPEND',6503 的原因可能有哪些？ 6503 表示下载失败，如果下载过程中遇到这个问题，大概率是网络问题。DFOTA 支持断点续传，所 以建议此时执行 AT+QFOTADL 继续下载。 3.7.4. 电信 IoT 平台 DFOTA 升级的要求有哪些？ ⚫ 同一时间同一小区最多只能同时升级 3 台设备。 ⚫ 升级步骤是先在平台创建任务，设备需要任意上报一条数据，然后开始执行升级过程。 ⚫ 创建升级任务时，设备需断电，或处于离线或深休眠状态。（但在下载和升级过程中不能断电。） ⚫ 升级过程中建议设备不要有任何数据交互。 3.7.5. 模块是否支持升级外部 MCU？ 支持。可以借助物联网平台（如电信 IoT 或 AEP 平台）的 SOTA 来升级外部 MCU 固件。MCU 通过 发送 PCP 协议（应用层升级协议）数据包来请求平台下发新版本 MCU 软件固件包，当接收到完整的固件 包后，MCU 可自主选择是否更新本地固件。 3.7.6. 对接电信 IoT/AEP 平台进行固件升级时有哪些注意事项？ ⚫ 下载差分包完成，平台会下发升级命令，不需要手动触发。 ⚫ 模块升级成功后，需要上报升级结果。 1) 首先，模块升级完成并自动重启后，需立刻执行 AT+QSCLK=0，避免模块进入深休眠模式（若 模块进入深休眠模式，则无法将结果上报给平台）。 2) 然后，注册至平台后，会自动上报升级结果。 上海移远通信技术股份有限公司 26 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.8. TCP/UDP 相关 3.8.1. AT+QIOPEN 是否能够连接 IPv6 域名类型的服务器？ 可以。AT+QIOPEN 支持连接 IPv6 类型和 IPv6 域名类型的服务器。 3.8.2. AT+QIDNSGIP 是否支持 IPv6 域名方式？ 支持。 3.8.3. 是否支持 UDP service？ 不支持。 3.8.4. Buffer 模式下，为什么下发数据没有收到 URC？ Buffer 模式下，当模块收到数据时，会下发 URC 通知 MCU 读取。当上一条 URC 未读取，或者未读 取完整，即 Buffer 不为空时，将成功接收到下行数据但不会上报 URC。 3.8.5. 模块作为服务器最多可以连接几路客户端？ 总共 6 路 socket，一路用于监听，剩余 5 路可以连接客户端。 3.8.6. 模块是否可以同时作为服务器和客户端？ 可以，每个 socket 都是独立的，可以自由选做服务器和客户端，但是仅有任意一路可以作为服务器。 3.8.7. AT+QISEND 发送数据后，SEND OK 是否标志已经发送到服务器？ SEND OK 仅表示成功发送数据到协议栈。 3.8.8. 配置和的格式要求是什么？ 除使用数据透传模式外，通过 AT+QISEND 和 AT+QISENDEX 分别配置和时， 参数取值必须带双引号，例如：AT+QISEND=0,5,''12345'' 3.8.9. 模块进入 PSM 后是否能收到下行数据？ 模块进入 PSM 后不能接收下行数据，如果模块在短时间内退出 PSM，此时缓存在核心网的数据会下 发给模块并有 URC 上报。 上海移远通信技术股份有限公司 27 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.8.10. AT+QIOPEN 连接 IPv6 服务器如何配置 protocol type？ 默认是 0：IPv4，如需连接 IPv6 服务器，需切换至 1。 3.8.11. 同时出现 IPv4 和 IPv6 地址时，如何区分？ 代码实现： //数组 pPdpAddr 存放的 IP 地址 for (i = 0; i < StrLen(pPdpAddr); i++) { if (pPdpAddr[i] == '.') { iptype = 0; //ip4 break; } else if (pPdpAddr[i] == ':') { iptype = 1; //ip6 break; } } 3.8.12. 关闭 Socket 链路之后，再次执行 AT+QIOPEN 失败 根据 TCP/IP 协议，关闭 Socket 链路后将进入 TIME_WAIT 状态，并且在 120 秒等待时间内不允许绑 定相同的本地端口号，这将导致这段时间内无法使用相同的本地端口号连接到服务器。 ⚫ 解决方法： 执行 AT+QIOPEN 命令时，将配置为 0，例如：AT+QIOPEN=1,0,'TCP','220.180.239. 上海移远通信技术股份有限公司 28 / 42 212',8045,0,1 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.8.13. 执行域名类的命令解析失败 DNS 服务器配置不正确可能导致解析失败，例如使用中国移动物联网卡建立 TCP 连接，但是 DNS 服 务器配置为中国电信的 DNS 服务器。可以通过 AT+QIDNSCFG 重新配置。 3.8.14. 执行域名类的命令解析慢 DNS 第一个服务器和第二个备用服务器配置不正确可能导致解析慢，例如使用中国移动物联网卡建立 TCP 连接，但是第一个 DNS 服务器配置的是中国电信的 DNS 服务器，第二个 DNS 服务器配置的是中国 移动的 DNS 服务器。可以通过 AT+QIDNSCFG 重新配置。 备注 TCP/UDP 相关命令详情，请参考文档 [12]。 上海移远通信技术股份有限公司 29 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.9. MQTT 相关 3.9.1. AT+QMTOPEN 是否能够连接 IPv6 域名类型的服务器？ 可以。AT+QMTOPEN 支持连接 IPv6 类型和 IPv6 域名类型的服务器。 3.9.2. 模块目前是否支持阿里云平台一机一密？ 模块目前支持一机一密，不支持一型一密。 3.9.3. 阿里云支持的版本有哪些？ 目前阿里云支持 MQTT 标准协议接入，兼容 3.1.1 和 3.1 版本协议。 3.9.4. 深圳地区使用电信卡连接 MQTT 失败 深圳地区存在电信白名单问题，如果 QMTOPEN 执行成功后 10 秒内没有发起 Socket 连接，网络就会 断开。这一问题需要和当地电信运营商协商解决。 3.9.5. 设置为 0，阿里云连接失败 阿里云 MQTT 连接心跳时间为 30 至 1200 秒。心跳时间不在此区间内，服务器会拒绝连接。建议取值 300 秒以上。 3.9.6. 在阿里云平台执行 AT+QMTOPEN 后未及时执行 AT+QMTCONN 被拒连 目前阿里云平台有这样的一个处理机制，在 AT+QMTOPEN 执行成功后，如果 10 秒内没有发起 Socket 连接，网络将断开。 3.9.7. 阿里云平台针对标准 MQTT 协议的支持情况是怎样的？ ⚫ 支持 MQTT 的 PUB、SUB、PING、PONG、CONNECT、DISCONNECT 和 UNSUB 等报文。 上海移远通信技术股份有限公司 30 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ ⚫ 支持 clean session。 ⚫ 不支持遗嘱、retain msg。 ⚫ 不支持 QoS2。 ⚫ 不支持 SUB QoS，消息 QoS 以发送方（PUB）指定为准。 ⚫ 基于原生的 MQTT Topic 上支持 RRPC 同步模式，服务器可以同步调用设备并获取设备回执结 果。 备注 MQTT 相关命令详情，请参考文档 [13]。 3.10. 电信物联网平台相关 3.10.1. 什么是电信 IoT/AEP 平台？ 电信 IoT 平台的全称是中国电信物联网开放平台-连接管理子系统，与华为 OceanConnect 平台兼容。 有关中国电信 IoT 平台的详细信息，请访问官方地址：https://www.ct10649.com/。 电信 AEP 平台官方名称为 CTWing 中国电信物联网开放平台。有关中国电信 AEP 平台的详细信息， 请访问地址 https://www.ctwing.cn/。 3.10.2. AT+NCDPOPEN 命令返回+QLWEVTIND: 1，可能的原因是什么？ 一般情况下，如果模块上报+QLWEVTIND: 1，可能的原因如下： 1. 对接电信 AEP 平台时，没有配置 Lifetime。 2. 没有在平台完成创建设备的步骤。 3. 在平台创建产品时 Endpoint 格式选择错误，BC25 模块必须要选择 imei 格式。 4. 平台注册超时。 3.10.3. 生命周期（Lifetime）机制的作用是什么？ 对于电信 IoT 平台来说，若在 25 小时内未与模块进行数据交互将显示异常，49 小时内未与模块进行 数据交互将显示离线，当模块发送上行数据或者更新注册包后将恢复正常。因此，电信 IoT 平台并不关注 生命周期这个参数。 对于 AEP 平台来说，如果在每一次生命周期到期前没有更新注册包，平台将自动断开与模块的连接， 模块与平台间的数据交互将无法进行。 上海移远通信技术股份有限公司 31 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.10.4. 模块是否支持手动更新 Lifetime？如何关闭 Lifetime 的自动更新？ 模块不支持手动更新 Lifetime，默认的 Lifetime 是 0。 如果对接电信 IoT 平台，可不配置 AT+NCFG=0,；如果对接电信 AEP 平台，则必须要配置 AT+NCFG=0,，AEP 平台要求不能配置为 0，否则无法连接至 AEP 平台。 备注 用户可通过配置 AT+NCFG=0,0 关闭自动更新。 3.10.5. 电信 IoT 平台的立即下发与缓存下发有何区别？ ⚫ 立即下发： 1. 如果模块处于 DRX 状态，模块可以立即接收到平台下发的数据。 2. 如果模块处于 eDRX 状态，数据会在核心网缓存一段时间（具体时间需咨询运营商），核心 网网元寻呼到设备后，才会将数据发送给设备。 3. 如果模块处于 PSM 状态，模块大概率收不到数据，除非在核心网缓存时间内有发送上行数据。 ⚫ 缓存下发： 当命令为缓存下发时，平台将收到的下发命令缓存，等设备上报数据时，按顺序将缓存的命令全 部下发。前一个命令送达设备或超时后，开始下发后一个缓存命令。 3.10.6. 模块对接电信 IoT/AEP 平台是否支持实时收发数据？ 模块对接 IoT/AEP 平台支持实时收发数据，但模块需要一直处于 DRX 状态。 3.10.7. 对接电信 IoT/AEP 平台，模块发送的数据包长度最大为多少？ 对 接 IoT/AEP 平 台 时 ，仅 支 持 发 送 十 六 进 制 字符 串 格 式 数 据 ， 数 据 包长 度 不 超 过 512 字 节, BC25PAR01A06 支持最大发送 1024 字节数据。 3.10.8. 模块从深休眠唤醒是否可以立即发送数据？ 模块从深休眠唤醒立即发送数据可能会造成数据发送失败。模块从深休眠唤醒后需要一段时间进行恢 复，恢复成功会上报+QLWEVTIND: 6，恢复失败会上报+QLWEVTIND: 7，因此需等待恢复成功结果码上 报再做业务。 上海移远通信技术股份有限公司 32 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 备注 上报+QLWEVTIND: 6 仅代表模块内部恢复成功，和网络并没有交互，此时不会退出 PSM 模式。 3.10.9. 模块是否支持 BS（Bootstrap）和加密？ 模块不支持 BS 功能，但可以支持 DTLS 的 PSK 加密方式。 3.10.10. 模块是否支持 CoAP 协议？ 模块不支持纯 CoAP 协议。客户使用 CoAP 协议自行组包、解析数据包，较为繁琐。为减少客户的开 发成本，针对客户使用模块对接物联网云平台（电信 IoT/AEP 平台、移动 OneNET 平台等）的需求，BC25 系列模块支持一套基于 CoAP 协议简化的 AT 命令。相关 AT 命令详情，请参考文档 [14]。 备注 中国电信物联网平台相关命令详情，请参考文档 [14]。 3.11. 中国移动 OneNET 相关 3.11.1. 如何查询模块支持的 OneNET SDK 版本？ 模块支持的 SDK 版本为 V2.2.0，也可以通过命令 AT+MIPLVER?进行查询。 3.11.2. 模块是否支持 BS 和加密？ 对接 OneNET 平台时，模块支持 BS，但不支持 DTLS 加密。 3.11.3. 为什么响应平台下发的发现资源请求和订阅请求会失败？ 如果出现响应平台下发的发现资源请求和订阅请求失败，可能是因为没有及时响应，平台端认为已超 时。建议终端在平台下发后 10 秒内响应。 上海移远通信技术股份有限公司 33 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.11.4. 模块注册到 OneNET 平台并进入深休眠模式后是否支持自行恢复？ 支持。模块成功注册到 OneNET 平台后进入深休眠，会自动保存相关状态和参数，被唤醒后自动从 NVRAM 读取相关状态和参数并恢复注册。此时 MCU 无需重新连接 OneNET，可以直接发送上行数据到平 台。此自行恢复功能默认打开，可以通过 AT+MIPLCONFIG 配置。 3.11.5. 模块从深休眠模式唤醒后上报+MIPLEVENT: 0,4 有什么含义？ +MIPLEVENT: 0,4 表示模块内部已经恢复连接，建议从深休眠模式唤醒后等待此 URC 上报后再发送 数据。 备注 模块从深休眠模式唤醒后上报+MIPLEVENT: 0,4，仅表明完成了本地数据的自恢复，并不会和网络进行 交互。 3.11.6. 执行 AT+MIPLOPEN 注册平台何种情况下会返回+MIPLEVENT: 0,3？ ⚫ 平台上未创建设备时，执行 AT+MIPLOPEN 后会在 5 秒内上报 URC +MIPLEVENT: 0,3。 ⚫ 网络信号较差，但数据仍能发送，只收到平台回复的 ACK，超过了 Bootstrap 的超时时间（20 秒）， 此时大约 10 秒后（即发出 AT+MIPLOPEN 命令 30 秒后）上报+MIPLEVENT: 0,3。 ⚫ 网络信号非常差，数据无法发送，此时会一直重传，总耗时约 128 秒后才会上报+MIPLEVENT: 0,3。 3.11.7. 删除了对象（Object），为何平台上还是能看到资源列表？ 删除了对象（Object）之后，需要执行 AT+MIPLUPDATE=0,,1 更新对象列表。 3.11.8. 连接 OneNET 平台后，是否需要经常发送心跳包维持连接？ 模块连接 OneNET 平台后，只要模块在生命周期内（即设置的 lifetime 未超时）就不需要发送心跳包 维持连接，但在设置的 lifetime 超时前，需要发送一次心跳包更新生命周期。 3.11.9. 注册成功后为什么没有下发订阅和发送资源请求？ 可能是由于平台上的自动订阅和自动发现资源功能没有开启。 3.11.10. 对接 OneNET 平台时，是否可以关闭生命周期的自动更新？ 模块对接 OneNET 平台时默认关闭自动更新生命周期的功能，如有需要，可以通过 AT+MIPLCONFIG 配置打开自动更新功能。 上海移远通信技术股份有限公司 34 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.11.11. 对接 OneNET 平台时，执行 AT+MIPLOPEN 失败 执行 AT+MIPLOPEN 后，如果由于网络或者相关配置问题出现 Bootstrap 失败（+MIPLEVENT: 0,3） 或者注册失败（+MIPLEVENT: 0,7），模块会重新进行 Bootstrap 和注册，如果连续三次尝试均失败，模 块便放弃此次注册请求。此时，需要检查网络和相关配置，确认无问题后，重新执行 AT+MIPLOPEN。 3.11.12. 对接 OneNET 平台时，是否支持实时收发数据？ 模块侧支持，但是普通的移动物联网卡不支持，网络侧最多保活 2 分钟。建议每分钟上报一次数 据，或者联系运营商开通 GRE 专用 APN。 由于普通的 APN 存在 2 分钟左右端口老化的问题，无法实现实时控制，故引入 GRE 专用 APN， 以延迟端口老化的时间。 备注 中国移动 OneNET 平台相关命令详情，请参考文档 [15]。 3.12. 低功耗管理、休眠模式相关 3.12.1. 如何进入浅休眠模式？ 如果模块使能了浅休眠功能（即 AT+QSCLK=2），当系统中所有正在运行的任务都处于挂起状态时， 模块 AP 侧会进入空闲状态（Idle 状态），此时模块处于浅休眠模式。浅休眠模式下，模块将切到 32 kHz 慢时钟运行，外部设备将无法正常工作，串口可以响应 AT 命令。 3.12.2. 如何进入深休眠模式？ 正常情况下，模块进入深休眠模式，需要同时满足以下两个条件： （1） Modem 侧处于 PSM 状态； （2） AP 侧所有任务被挂起，进入 Idle 态。 AP 侧何时进入 Idle 态是系统根据当前 task 的运行情况决定的，当所有正在运行的 task 都被挂起时， AP 就会进入 Idle 态。Modem 侧何时进入 PSM 是由 T3324 时间决定的，T3324 超时时间可以通过 AT 命 令配置，但能否设置成功取决于网络是否接受配置，实际 T3324 时间以注网成功后网络下发的为准。 当模块处于深休眠状态时，为最大程度降低功耗，模块会关闭相关外设，串口不再响应 AT 命令，CPU 停止运行，此时模块接近关机状态，仅 RTC 继续运行。 上海移远通信技术股份有限公司 35 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.12.3. 如何退出浅休眠模式？ 若模块处于浅休眠模式，通过主串口发送 AT 命令可让其退出浅休眠模式，进入唤醒（Active）模式。 3.12.4. 如何退出深休眠模式？ BC25 系列和 BC32 系列标准模块退出深休眠模式的方式有如下三种： （1） （2） （3） PSM_EINT 外部中断引脚唤醒； TAU 唤醒； PSM 功能关闭且 eDRX 周期大于 327.68 秒进入的深休眠模式，会在下一个 PTW 周期到来时 唤醒。 其中，PSM_EINT 只能使 AP 侧退出 Idle 态，需要主动上行一包数据才能使 Modem 侧退出 PSM 态。 TAU 唤醒时，既可以使 AP 侧退出 Idle，也可以使 Modem 退出 PSM。 3.12.5. 模块 PSM_EINT 一直拉低是否无法进入深休眠模式？ BC32 系列模块通过 PSM_EINT 低电平将模块从深休眠模式唤醒，所以当 PSM_EINT 引脚一直维持在 低电平，模块将无法进入深休眠模式。 3.12.6. 上报 ENTER PSM 的 URC 之后，为何依然无法进深休眠模式？ 执行 AT+QSCLK?检查是否禁用了深休眠模式，若查询结果不为 1，设置 AT+QSCLK=1 即可。 3.12.7. 深休眠模式唤醒后，模块为何仍然无法接收到平台下发的数据？ 深休眠模式唤醒的方式中，PSM_EINT 唤醒的只是模块的 AP 侧，Modem 侧仍然处于 PSM 状态。 Modem 侧处于 PSM 时，模块无法接收平台下发的数据，需要主动上发一组数据以退出 PSM。 3.12.8. 关闭了 PSM 和深休眠模式的情况，模块为何收不到平台下发的数据？ 检查是否设置了 eDRX 模式，以及设置的 eDRX 周期是否过长。如果 eDRX 周期过长可能会导致接收 平台数据延迟，因为整个 eDRX 周期中只有在 PTW 窗口期内才能接收平台数据。 3.12.9. T3324 时间设置为 0，模块是否可以直接从 Active 态切换至 PSM 模式？ 可以。但是模块 Modem 侧没有执行数据业务时，会有一个释放 RRC 连接的过程，这个过程一般是 20 秒。RRC 连接释放之后模块才能进入 DRX 状态。如果 T3324 时间设置为 0，RRC 连接释放之后没有 DRX 或 eDRX 的过程，模块直接进入 PSM 模式，但释放 RRC 连接的过程仍然存在。 上海移远通信技术股份有限公司 36 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.12.10. 如何快速释放 RRC 连接？ 部分协议（如 LwM2M）在发送数据的时候，会有一个 RAI 标志，RAI 标记用于指示核心网释放与模块 的 RRC 连接，具体请参考《Quectel_BC25_中国电信物联网平台应用指导》中的详细说明。 3.12.11. 深休眠模式下模块自动唤醒，可能的唤醒源有哪些？ ⚫ TAU 唤醒，即 T3412 唤醒，该时间可以配置，但最终是由网络下发的。 ⚫ 生命周期到期前自动唤醒，当前对接电信 IoT/AEP 平台和 OneNET 平台都支持设置生命周期自动 更新。 3.12.12. 哪些因素会影响模块进入深休眠模式？ ⚫ 通过 AT+QSCLK=0 禁用了休眠模式，或通过 AT+QSCLK=2 设置了仅允许进入浅休眠模式； ⚫ PSM_EINT 一直处于拉低状态； ⚫ AP 侧有任务在处理，如 AT 交互；默认每次发送 AT 命令后，模块会被锁住 10 秒无法进入深休眠。 3.12.13. 什么场景下模块可以进入深休眠模式？ ⚫ AT+CFUN=0； ⚫ 底层上报无网（OOS）； ⚫ PSM 功能关闭且 eDRX 周期大于 327.68 秒。 3.12.14. 模块进入 PSM 之后为什么 AT 命令不通？ 如果模块仅进入 PSM，而没有进入深休眠模式，这时是可以执行 AT 命令的。建议在进行 AT 业务前 先通过 PSM_EINT 唤醒模块，发送 AT 至模块，模块响应并返回 OK 后，再进行业务 AT 操作。 3.12.15. 为什么模块已经进入 PSM 模式，但功耗没有明显降低？ 功耗与整个系统的状态有关。Modem 进入 PSM 后只是无法接收到平台端发过来的数据，如果此时 AP 处于 Active 态，模块功耗不会有明显降低。模块进入深休眠模式，系统功耗才能降到很低。 3.12.16. 是否有模块在各种工作模式下的耗流数据？ 有。具体请参阅文档 [10]和文档 [11]中的耗流章节。 3.12.17. PSM_EINT 需要拉低多久方可将模块从深休眠模式唤醒？ BC25 模块检测到下降沿即可从深休眠唤醒，BC32 检测到低电平唤醒。 上海移远通信技术股份有限公司 37 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 3.12.18. 按 RESET 复位后，测试的 VDD_EXT 波形为方波形式是否正常？ 正常。在 RESET 拉低过程中会出现方波，直至 RESET 被松开。 3.12.19. 开机或者唤醒时 VDD_EXT 存在方波形式么？ 不会。VDD_EXT 只在复位过程为方波形式。 3.12.20. BT 开启状态下无法进深休眠模式 BT 功能开启会导致模块无法进入深休眠模式。 上海移远通信技术股份有限公司 38 / 42 Quectel BC25&BC32 系列软件注意事项及 FAQ 4 附录 参考文档及术语缩写 表 2：参考文档 序号 文档名称 备注 [1] Quectel_BC25_AT 命令手册 BC25 系列模块 AT 命令手册 [2] Quectel_BC32_AT 命令手册 BC32 系列模块 AT 命令手册 [3] Quectel_BC25&BC26&BC28&M26_兼容设计手册 BC25&BC26&BC28&M26 模块兼容设计 手册 [4] Quectel_BC25&BC32_固件烧录及 Log 抓取应用指导 BC25&BC32 系列模块固件烧录及 Log 抓 取应用指导 [5] Quectel_BC25_搜网机制说明 BC25 系列模块搜网机制说明 [6] Quectel_BC32_搜网机制说明 BC32 系列模块搜网机制说明 [7] Quectel_BC25&BC32 系列_DFOTA_应用指导 BC25&BC32 系列模块 DFOTA 应用指导 [8] Quectel_BC25 系列_NB-IoT_模块产品规格书 BC25 系列模块产品规格书 [9] Quectel_ BC32 系列_NB-IoT_模块产品规格书 BC32 系列模块产品规格书 [10] Quectel_BC25_硬件设计手册 BC25 系列硬件设计手册 [11] Quectel_BC32_硬件设计手册 BC32 系列硬件设计手册 [12] Quectel_BC25&BC32 系列_TCP(IP)_应用指导 BC25&BC32 系列 TCP/UDP AT 命令手册 [13] Quectel_BC25&BC32_MQTT_应用指导 [14] Quectel_BC25 系列_中国电信物联网平台应用指导 [15] Quectel_BC25&BC32_OneNET_应用指导 BC25&BC32 系列 MQTT AT 命令手册 BC25 系列对接电信 IoT 平台/AEP 平台应 用指导 BC25&BC32 系列对接 OneNET 平台应用 指导 上海移远通信技术股份有限公司 39 / 42 表 3：术语缩写 缩写 ACK APN APP AP BS CoAP CPU DRX DNS DFOTA DTLS eDRX ESD EMM FAQ FOTA GRE GSM GNSS HARQ HTTP IMEI IP IPv4 Quectel BC25&BC32 系列软件注意事项及 FAQ 英文全称 Acknowledgement Access Point Name Application Application Processor Bootstrap Constrained Application Protocol Central Processing Unit Discontinuous Reception Domain Name System Delta Firmware Upgrade Over-The-Air Datagram Transport Layer Security Extended Discontinuous Reception Electro-Static Discharge EPS Connection Management Frequently Asked Questions Firmware Over The Air Generic Routing Encapsulation Global System for Mobile Communication Global Navigation Satellite System Hybrid Automatic Repeat reQuest HyperText Transfer Protocol International Mobile Equipment Identity Internet Protocol Internet Protocol Version 4 中文全称 确认符 接入点名称 应用程序 应用处理器 引导模式 受限的应用层协议 中央处理器 非连续接收 域名系统 差分式固件空中升级 数据包传输层安全性协议 扩展非连续接收 静电释放 EPS 连接管理 常见问题 空中固件升级 通用路由封装 全球移动通信系统 全球导航卫星系统 混合自动重传请求 超文本传输协议 国际移动设备识别码 网际互连协议 网际协议版本 4 上海移远通信技术股份有限公司 40 / 42 IPv6 IoT MCU MIB MIPS MME MQTT NB-IoT NTP NV(RAM) OTA OOS PC PCP PDP PDN PLMN PSK PSM RACH RTOS PTW RSSI RSRP RRC RTC Quectel BC25&BC32 系列软件注意事项及 FAQ Internet Protocol Version 6 Internet of Things Micro Control Unit Management Information Base Millions of Instructions Per Second Mobility Management Entity Message Queuing Telemetry Transport Narrow Band Internet of Things Network Time Protocol Non-volatile Random-Access Memory Over-the-Air Technology Out of Service Personal Computer Private Communication Protocol Packet Data Protocol Public Data Network Public Land Mobile Network Pre-Shared Key Power Saving Mode Random Access Channel Real-Time Operating System Paging Time Window Received Signal Strength Indicator Reference Signal Receiving Power Radio Resource Control Real-Time Clock 网际协议版本 6 物联网 微型控制单元 信息管理基础 每秒百万指令 移动管理实体 消息队列遥测传输 窄带物联网 网络时间协议 非易失性随机存储器 空中下载技术 无服务 个人计算机 私人通信协议 分组数据协议 公用数据网 公共陆地移动网络 预共享密钥 省电模式 随机接入信道 实时操作系统 寻呼时间窗口 接收信号的强度指示 参考信号接收功率 无线资源控制 实时时钟 上海移远通信技术股份有限公司 41 / 42 RAI PSM SDK SIB SIM SNR SOAT TCP TAU TAC TBS TTL UART USB URC UDP (U)SIM Quectel BC25&BC32 系列软件注意事项及 FAQ Release Assistance Indication Power Saving Mode Software Development Kit System Information Block Subscriber Identification Module Signal to Noise Ratio Software Over-the-Air Technology Transmission Control Protocol Tracking Area Update Tracking Area Code Transport Block Size Transistor-Transistor Logic Universal Asynchronous Receiver-Transmitter Universal Serial Bus Unsolicited Result Code User Datagram Protocol (Universal) Subscriber Identity Module 释放辅助指示 省电模式 软件开发工具包 系统消息块 用户识别卡 信噪比 软件空中升级技术 传输控制协议 跟踪区更新 跟踪区编码 传输块大小 逻辑门电路 通用异步收发传输器 通用串行总线 非请求结果码 用户数据报协议 全球用户识别卡 上海移远通信技术股份有限公司 42 / 42

L76K AGNSS 应用指导 GNSS 模块系列 版本：1.0 日期：2021-05-24 状态：受控文件 L76K AGNSS 应用指导 上海移远通信技术股份有限公司始终以为用户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其用户的产品设计。用户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 15 L76K AGNSS 应用指导 关于文档 文档信息 标题 副标题 文档类型 文档状态 L76K AGNSS 应用指导 GNSS 模块系列 AGNSS 应用指导 受控版本 修订历史 版本 1.0 日期 2021-04-02 2021-05-24 描述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 15 L76K AGNSS 应用指导 目录 关于文档 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 AGNSS 操作流程 .................................................................................................................................. 7 2.1. 卫星数据下载.............................................................................................................................. 7 2.2. 卫星数据格式.............................................................................................................................. 7 2.3. AGNSS 测试流程 ....................................................................................................................... 8 3 AGNSS 相关指令 ................................................................................................................................ 10 3.1. 数据格式 ................................................................................................................................... 10 3.2. AID-INI...................................................................................................................................... 10 3.3. MSG_BDSUTC ........................................................................................................................ 12 3.4. MSG_BDSION ......................................................................................................................... 12 3.5. MSG_BDSEPH ........................................................................................................................ 12 3.6. MSG_GPSUTC ........................................................................................................................ 13 3.7. MSG_GPSION ......................................................................................................................... 13 3.8. MSG_GPSEPH ........................................................................................................................ 13 3.9. ACK .......................................................................................................................................... 13 3.10. NACK ....................................................................................................................................... 14 4 附录 参考文档及术语缩写 .................................................................................................................. 15 上海移远通信技术股份有限公司 3 / 15 L76K AGNSS 应用指导 表格索引 表 1：标志掩码 ............................................................................................................................................11 表 2：参考文档 ........................................................................................................................................... 15 表 3：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 L76K AGNSS 应用指导 图片索引 图 1：卫星数据格式...................................................................................................................................... 7 图 2：发送流程 ............................................................................................................................................. 8 上海移远通信技术股份有限公司 5 / 15 L76K AGNSS 应用指导 1 引言 本文档主要介绍移远通信 L76K 模块 AGNSS 功能的操作流程及相关指令。 AGNSS 功能主要用于缩短 L76K 模块的 TTFF。在使用该功能时需要在相关服务器上下载卫星数据 （EPH），并通过串口注入到模块当中。 上海移远通信技术股份有限公司 6 / 15 L76K AGNSS 应用指导 2 AGNSS 操作流程 本章节主要介绍 AGNSS 卫星数据下载、卫星数据格式及 AGNSS 测试流程。 2.1. 卫星数据下载 用户可通过 FTP 协议进行卫星数据文件下载，文件名为 eph.dat。卫星数据文件的 FTP 地址为 ftp://a gnss.queclocator.com。 备注 1. 移远通信服务器会实时下载卫星数据，此时需要用户创建自己的服务器用于从移远通信服务器下载并 存储卫星数据，建议每 1 小时更新一次数据，进而实现终端设备上卫星数据的注入。 2. 需联系移远通信技术支持获取接入移远通信服务器的账户。 2.2. 卫星数据格式 卫星数据是由多个 CASIC 指令组成，与卫星数据相关的 CASIC 指令请参考第 3 章，卫星数据格式如 下图所示： 上海移远通信技术股份有限公司 图 1：卫星数据格式 7 / 15 L76K AGNSS 应用指导 2.3. AGNSS 测试流程 终端设备主控获取到卫星数据后，需要与模块之间通过串口进行交互通信，以完成卫星数据的注入。 数据传输流程如下，有关命令详细信息请参考第 3 章。 1. 终端设备主控发送 AID-INI 至模块。 2. 模块收到命令后，发送 ACK 至主控。若接收失败，模块会发送 NACK 至主控。 3. 终端设备主控收到 ACK 后，发送卫星数据至模块（数据发送过程由用户定义并实现）。由于卫星的 数据是 CASIC 指令的格式，所以建议发送卫星数据的时候参照指令进行发送流程。 4. 模块收到卫星数据后会将数据存储到 RAM 中，同时发送 ACK 至主控。若数据接收失败，模块会 发送 NACK，此时主控需重新发送卫星数据包。 开开始始 网网络络端端获获取取 EEPPHH数数据据 获获取取EEPPHH的的 数数目目 发发送送AAIIDD--IINNII 指指令令 否 是是否否收收到到 AACCKK 是 发发送送EEPPHH数数 据据 否 是是否否收收到到 否 AACCKK 是 是是否否发发送送完完 成成 是 结结束束 图 2：发送流程 上海移远通信技术股份有限公司 8 / 15 L76K AGNSS 应用指导 示例： 蓝色：数据发送 红色：ACK 信息 黑色：NMEA 数据 $GPTXT,01,01,02,MA=CASIC*27 $GPTXT,01,01,02,IC=AT6558-5N-32-1C510800*48 $GPTXT,01,01,02,SW=URANUS5,V5.1.0.0*1F $GPTXT,01,01,02,TB=2018-04-18,10:28:16*40 $GPTXT,01,01,02,MO=GB*77 $GNGGA,,,,,,0,00,25.5,,,,,,*64 $GNGLL,,,,,,V,N*7A $BDGSV,3,1,10,02,37,229,36,03,51,192,37,04,31,119,37,05,17,251,33,0*7A $BDGSV,3,2,10,06,39,190,38,07,68,352,41,09,56,221,39,10,56,301,38,0*79 //AID-INI 指令发送： BA CE 38 00 0B 01 52 B8 1E 85 EB D1 3F 40 D7 A3 70 3D 0A 47 5D 40 00 00 00 00 00 00 00 00 00 00 00 00 7C 2E 11 41 00 00 00 00 00 00 00 00 00 00 00 3F 00 00 00 00 E5 07 00 00 62 08 00 23 19 B4 48 E7 $GNRMC,063040.000,A,3419.32306,N,11706.92160,E,0.00,0.00,030321,,,A,V*0E $GNVTG,0.00,T,,M,0.00,N,0.00,K,A*23 …… //AID-INI ACK： BA CE 04 00 05 01 0B 01 00 00 0F 01 05 01 $GNGGA,063041.000,3149.32307,N,11706.91259,E,1,19,0.8,56.8,M,-5.0,M,,*6C $GNGLL,3149.32307,N,11706.91259,E,063041.000,A,A*4A //发送星历数据： BA CE 48 00 08 07 CD CD 9A 10 E5 7D 0D A1 A0 03 59 05 58 30 63 21 98 4B 91 03 DA 64 0F 28 EC 77 2E B1 4C A8 FF FF EC 2C 81 05 12 05 85 14 DB 19 9C 05 0C 00 40 00 FA 32 63 00 FA 32 00 00 8E 96 18 00 B7 FF 00 0A 27 00 00 00 01 03 A3 41 E2 9B 3D 28 BA CE 48 00 07 F3 E1 31 8C 1E FC 0C A1 8D A9 6D 0A 3B F5 4C C1 28 F5 A4 0D 0A 5C 32 27 C1 AD D6 AD AB A3 FF FF E0 31 8F 04 DA 05 7F 15 26 17 08 07 57 FF B1 FF FA 32 63 00 FA 32 00 00 39 ED EC FF DF FF 00 DA 2A 00 00 00 02 03 A3 41 2E C4 6B 1F ... $GNVTG,0.00,T,,M,0.00,N,0.00,K,A*23 //星历数据 ACK： BA CE 04 00 05 01 08 07 00 00 0C 07 05 01 BA CE 04 00 05 01 08 07 00 00 0C 07 05 01 ... 上海移远通信技术股份有限公司 9 / 15 L76K AGNSS 应用指导 3 AGNSS 相关指令 相关的数据格式请参考文档 [2]的 CASIC 格式。 3.1. 数据格式 缩写 U1 I1 U2 I2 U4 I4 R4 R8 类型 无符号字符 有符号字符 无符号短整型 有符号短整型 无符号长整型 有符号长整型 IEEE754 单精度 IEEE754 双精度 长度（字节） 1 1 2 2 4 4 4 8 备注 补码 补码 补码 3.2. AID-INI 该命令用于发送辅助位置、时钟等信息。由终端设备主控发送，模块收到该命令会有一个 ACK 返回。 格式： 头 0xBA 0xCE 长度（字节） 56 标识符 0x0B 0x01 有效载荷 见下表 校验和 4 字节 上海移远通信技术股份有限公司 10 / 15 L76K AGNSS 应用指导 字符偏移 0 8 16 24 32 36 40 44 48 52 54 55 数据类型 比例缩放 R8 - R8 - R8 - R8 - R4 300 R4 - R4 C^2 R4 300^2 U4 - U2 - U1 - U1 - 名称 Lat Lon Alt TOW FreqBias 单位 度 度 米 秒 ppm pAcc m^2 tAcc S^2 fAcc ppm^2 Res - WN - TimerSource - Flags - 描述 纬度 经度 高度。通常为 0 GPS 周内秒 时钟频率偏移。通常为 0 3D 位置的估计误差的方差。通常为 0 时间的估计误差的方差。通常为 0 时间频率漂移误差的方差 保留 GPS 周 时间源 标志掩码。详细请参考表 1 有效载荷： 表 1：标志掩码 位 B0 B1 B2 B3 B4 B5 B6 B7 描述 1 = 位置有效 1 = 时间有效 1 = 时钟频率漂移数据有效 保留 1 = 时钟频率数据有效 1 = 位置是 LLA 格式 1 = 高度无效 保留 上海移远通信技术股份有限公司 11 / 15 L76K AGNSS 应用指导 示例： //发送： BA CE 38 00 0B 01 00 00 00 80 EB D1 3F 40 00 00 00 40 0A 47 5D 40 00 00 00 00 00 00 00 00 00 00 00 00 A0 A1 15 41 00 00 00 00 00 00 00 00 00 00 00 3F 00 00 00 00 E5 07 00 00 62 08 00 23 14 CB BD //ACK： BA CE 04 00 05 01 0B 01 00 00 0F 01 05 01 3.3. MSG_BDSUTC BDS 定点 UTC 数据（与 UTC 时间同步参数）。 格式： 头 0xBA 0xCE 长度（字节） 20 标识符 0x08 0x00 有效载荷 - 校验和 4 字节 3.4. MSG_BDSION BDS 电离层数据。 格式： 头 0xBA 0xCE 长度（字节） 16 标识符 0x08 0x01 有效载荷 - 校验和 4 字节 3.5. MSG_BDSEPH BDS 星历。 格式： 头 0xBA 0xCE 长度（字节） 92 标识符 0x08 0x02 有效载荷 - 校验和 4 字节 上海移远通信技术股份有限公司 12 / 15 3.6. MSG_GPSUTC GPS 定点 UTC 数据（与 UTC 时间同步参数）。 格式： 头 0xBA 0xCE 长度（字节） 20 标识符 0x08 0x05 L76K AGNSS 应用指导 有效载荷 - 校验和 4 字节 3.7. MSG_GPSION GPS 电离层参数。 格式： 头 0xBA 0xCE 长度（字节） 16 标识符 0x08 0x06 有效载荷 - 校验和 4 字节 3.8. MSG_GPSEPH GPS 星历。 格式： 头 0xBA 0xCE 长度（字节） 72 标识符 0x08 0x07 有效载荷 - 校验和 4 字节 3.9. ACK 该响应信息用于回应正确接收的信息。若成功接收到终端设备主控发送的 AID-INI 或者卫星数据，L76K 模块将发送 ACK 信息用于告知主控已成功接收。 上海移远通信技术股份有限公司 13 / 15 格式： 头 0xBA 0xCE 长度（字节） 4 L76K AGNSS 应用指导 标识符 0x05 0x01 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 0 1 2 数据类型 U1 U1 U2 比例缩放 - 名称 ClsID MsgID Res 单位 描述 - 正确接收信息的类型 - 正确接收信息的编号 - 保留 3.10. NACK 该响应信息用于回应未正确接收的信息。若未接收到终端设备主控发送的 AID-INI 或者卫星数据，L76K 模块将发送 NACK 信息用于告知主控未成功接收。 格式： 头 0xBA 0xCE 长度（字节） 标识符 4 0x05 0x00 有效载荷 见下表 校验和 4 字节 有效载荷： 字符偏移 0 1 2 数据类型 U1 U1 U2 比例缩放 - 名称 ClsID MsgID Res 单位 描述 - 未正确接收信息的类型 - 未正确接收信息的编号 - 保留 上海移远通信技术股份有限公司 14 / 15 L76K AGNSS 应用指导 4 附录 参考文档及术语缩写 表 2：参考文档 序号 文档名称 [1] Quectel_L76K_硬件设计手册 [2] Quectel_L76K&L26K_GNSS_协议规范 [3] Quectel_L76K_参考设计手册 描述 L76K 硬件设计手册 L76K、L26K GNSS 协议规范 L76K 参考设计手册 表 3：术语缩写 缩写 ACK AGNSS BDS EPH FTP GNSS GPS LLA NACK RAM TTFF UTC 英文解释 Acknowledge Character Assisted GNSS BeiDou Navigation Satellite System Ephemeris File Transfer Protocol Global Navigation Satellite System Global Positioning System Longitude, Latitude, Altitude Negative Acknowledgement Random Access Memory Time to First Fix Coordinated Universal Time 中文解释 确认消息 辅助式全球卫星导航系统 北斗卫星导航系统 星历 文件传输协议 全球导航卫星系统 全球定位系统 经度、纬度、高度 否定消息 随机存储器 首次定位时间 协调世界时 上海移远通信技术股份有限公司 15 / 15

L76K&L76-LB 差异说明 GNSS 模块系列 版本：1.0 日期：2021-01-29 状态：受控文档 www.quectel.com L76K&L76-LB 差异对比 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 18 文档历史 修订记录 版本 1.0 日期 2020-04-29 2021-01-29 作者 Ronnie HU/ Phil GAO Ronnie HU/ Phil GAO 变更表述 文档创建 受控版本 L76K&L76-LB 差异对比 上海移远通信技术股份有限公司 2 / 18 L76K&L76-LB 差异对比 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 图片索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 硬件差异对比.......................................................................................................................................... 7 2.1. 基本信息 ...................................................................................................................................... 7 2.2. 硬件接口 ...................................................................................................................................... 7 2.2.1. 引脚分布 ........................................................................................................................... 8 2.2.2. 引脚描述 ........................................................................................................................... 9 2.3. 硬件兼容设计............................................................................................................................. 12 2.3.1. I/O 引脚电平 ................................................................................................................... 12 2.3.2. VCC_RF 引脚（引脚 14） ............................................................................................. 13 2.3.3. I2C 接口引脚（引脚 16/17）.......................................................................................... 13 2.3.4. SET/FORCE_ON 引脚（引脚 18） ............................................................................... 13 2.4. 频段和星系组合 ......................................................................................................................... 14 2.5. 模块性能 .................................................................................................................................... 14 2.5.1. 耗流 ................................................................................................................................ 14 2.5.2. 工作条件 ......................................................................................................................... 15 2.5.3. 灵敏度............................................................................................................................. 15 3 软件差异对比........................................................................................................................................ 16 3.1. 软件差异 .................................................................................................................................... 16 4 附录 A 相关文档及术语缩写................................................................................................................ 17 上海移远通信技术股份有限公司 3 / 18 L76K&L76-LB 差异对比 表格索引 表 1：基本信息 ............................................................................................................................................. 7 表 2：引脚描述 ............................................................................................................................................. 9 表 3：频段和星系组合 ................................................................................................................................ 14 表 4：模块耗流 ........................................................................................................................................... 14 表 5：工作条件 ........................................................................................................................................... 15 表 6：射频灵敏度 ....................................................................................................................................... 15 表 7：软件差异 ........................................................................................................................................... 16 表 8：相关文档 ........................................................................................................................................... 17 表 9：术语和缩写词.................................................................................................................................... 17 上海移远通信技术股份有限公司 4 / 18 L76K&L76-LB 差异对比 图片索引 图 1：引脚分布 ............................................................................................................................................. 8 图 2：串口电平兼容设计（3.3 V 主控串口电平）...................................................................................... 12 图 3：串口电平兼容设计（1.8 V 主控串口电平）...................................................................................... 12 图 4：VCC_RF 兼容设计 ........................................................................................................................... 13 上海移远通信技术股份有限公司 5 / 18 L76K&L76-LB 差异对比 1 引言 本文档介绍了移远通信 L76K 和 L76-LB GNSS 模块之间的差异，包括硬件接口、电气特性以及软件协 议等方面的差异。 备注 L76-LB 模块支持 2.7~2.9 V 和 1.7~1.9 V 两种 I/O 电压；本文所述 L76-LB 模块的 I/O 电压仅为 2.7~2.9 V。 上海移远通信技术股份有限公司 6 / 18 L76K&L76-LB 差异对比 2 硬件差异对比 2.1. 基本信息 表 1：基本信息 型号 外观 L76-LB L76K 封装 尺寸（mm） 供电 18 个 LCC 引脚  10.1 × 9.7 × 2.5  供电范围： 2.8~4.3 V，典型值：3.3 V I/O 电压： 2.7~2.9 V，典型值：2.8 V 18 个 LCC 引脚  10.1 × 9.7 × 2.0  供电范围： 2.7~3.4 V，典型值：3.3 V I/O 电压： 与 VCC 电压范围相同，典型值 3.3 V 2.2. 硬件接口 L76K 和 L76-LB 具有相同的硬件封装，但引脚定义和电气特性略有差异，详情如下。 上海移远通信技术股份有限公司 7 / 18 2.2.1. 引脚分布 L76K&L76-LB 差异对比 GND GND 1 TXD1 TXD 2 RXD1 RXD 3 1PPS 1PPS 4 STANDBY WAKE_UP 5 V_BCKP V_BCKP 6 RESERVED RESERVED 7 VCC VCC 8 RESET RESET_N 9 L76-LB L76K (Top View) 18 SET 17 RESERVED 16 RESERVED 15 RESERVED 14 VCC_RF 13 ANTON 12 GND 11 RF_IN 10 GND FORCE_ON I2C_SCL I2C_SDA RESERVED VCC_RF ANTON GND RF_IN GND 注： SIGNAL POWER 标记为红色的引脚名称，表示其功能不同。 GND ANT RESERVED 图 1：引脚分布 上海移远通信技术股份有限公司 8 / 18 2.2.2. 引脚描述 表 2：引脚描述 引脚号 L76-LB 引脚名称 1 GND 2 TXD1 3 RXD1 4 1PPS 5 STANDBY 6 V_BCKP DC 特性 I/O - - VOLmax = 0.42 V VOHmin = 2.4 V DO VOHnom = 2.8 V VILmin = -0.3 V VILmax = 0.7 V VIHmin = 2.1 V DI VIHmax = 3.1 V VIHnom = 2.8 V VOLmax = 0.42 V VOHmin = 2.4 V DO VOHnom = 2.8 V VILmin = -0.3 V VILmax = 0.7 V DI VIHmin = 2.1 V VIHmax = 3.1 V Vmax = 4.5 V Vmin = 1.5 V PI Vnorm = 3.3 V 引脚描述 - L76K 引脚名称 GND TXD UART 接口用于命令 输入和 NMEA 语句 输出。 RXD 每秒 1 个脉冲 1PPS 用于进入或退出 Standby 模式 WAKE_UP RTC 备用电源 V_BCKP L76K&L76-LB 差异对比 DC 特性 I/O - - VOLmax = 0.4 V VOHmin = VCC - 0.4 V DO VOHnom = VCC VILmin = -0.3 V VILmax = 0.2 × VCC VIHmin = 0.8 × VCC DI VIHmax = VCC + 0.3 VIHnom = VCC VOLmax = 0.4 V VOHmin = VCC - 0.4 V DO VOHnom = VCC VILmin = -0.3 V VILmax = 0.2 × VCC DI VIHmin = 0.8 × VCC VIHmax = VCC + 0.3 Vmax = 3.6 V Vmin = 1.4 V PI Vnom = 3.3 V 引脚描述 - UART 接口用于命令输 入和 NMEA 语句输出。 每秒 1 个脉冲 用于进入或退出 Standby 模式 RTC 备用电源 上海移远通信技术股份有限公司 9 / 18 L76K&L76-LB 差异对比 7 RESERVED - - - 8 VCC Vmax = 4.3 V Vmin = 2.8 V PI 模块主电源 Vnorm = 3.3 V VILmin = -0.3 V VILmax = 0.7 V 9 RESET VIHmin = 2.1 V DI 模块复位 VIHmax = 3.1 V VIHnom = 2.8 V 10 GND - - - 11 RF_IN - AI 射频信号输入 RESERVED VCC RESET_N GND RF_IN - - Vmax = 3.4 V Vmin = 2.7 V PI Vnorm = 3.3 V VILmin = -0.3 V VILmax = 0.2 × VCC VIHmin = 0.8 × VCC DI VIHmax = VCC + 0.3 VIHnom = VCC - - - AI 模块主电源 模块复位 射频信号输入 12 GND 13 ANTON - - VOLmax = 0.42 V VOHmin = 2.4 V DO VOHnom = 2.8 V - GND 有源天线外部供电控 制 ANTON 14 VCC_RF VCC_RF = VCC PO 有源天线供电 VCC_RF - - VOLmax = 0.4 V VOHmin = VCC - 0.4 V DO VOHnom = VCC VCC_RF = VCC PO - 有源天线外部供电控制 有源天线供电和状态检 测 15 RESERVED - - - VILmin = -0.3 V 16 I2C_SDA VILmax = 0.7 V IO I2C 数据 VIHmin = 2.1 V VIHmax = 3.1 V 17 I2C_SCL VOLmax = 0.42 V DI I2C 时钟 RESERVED - RESERVED - RESERVED - - - - - - - 上海移远通信技术股份有限公司 10 / 18 VOHmin = 2.4 V VOHnorm = 2.8 V VILmin = -0.3 V VILmax = 0.7 V 强制从 Backup 模式 18 FORCE_ON VIHmin = 2.1 V DI 唤醒模块； SET VIHmax = 3.1 V 高电平有效。 VIHnom = 2.8 V 备注 1. 更详细的引脚定义，请参阅并对比 L76K 和 L76-LB 硬件设计手册。 2. L76K 和 L76-LB 模块之间有差异的参数或引脚功能，已于上表中用红色标记。 L76K&L76-LB 差异对比 VILmin = -0.3 V VILmax = 0.2 × VCC VIHmin = 0.8 × VCC DI VIHmax = VCC + 0.3 VIHnom = VCC 星系配置； 悬空：GPS + BeiDou； 外部下拉为低电平： GPS + GLONASS。 上海移远通信技术股份有限公司 11 / 18 L76K&L76-LB 差异对比 2.3. 硬件兼容设计 2.3.1. I/O 引脚电平  L76-LB 模块的 I/O 引脚电平为 2.7~2.9 V，典型值为 2.8 V；  L76K 模块的 I/O 引脚电平为 2.7~3.4 V，，典型值 3.3 V； 故 L76K 与 L76-LB 兼容设计时，需做好与主控的电平匹配。以串口为例，若主控串口电平是 3.3 V，模块供 电电压也是 3.3 V，则建议如下兼容设计方案： MCU TXD RXD GND Voltage level: 3.3 V R1 1K R2 1K R3 5.6K for L76-LB 0Ω for L76K Module RXD TXD GND 图 2：串口电平兼容设计（3.3 V 主控串口电平） 若主控串口电平与 3.3 V 电压差较大（如 1.8 V），则建议如下兼容设计方案： VCC_IO_MCU MCU 10K RXD 4.7K 1.0 nF VCC_IO_Module Module TXD TXD VCC_IO_MCU GND Voltage level: 1.8 V 4.7K 1.0 nF RXD 10K VCC_IO_Module GND 图 3：串口电平兼容设计（1.8 V 主控串口电平） 上图中，VCC_IO_MCU 为主控 I/O 口的参考电压源；VCC_IO_Module 为模块 I/O 口的参考电压源（L76-LB： 典型值 2.8 V；L76K：典型值 3.3 V）。 上海移远通信技术股份有限公司 12 / 18 2.3.2. VCC_RF 引脚（引脚 14） Active Antenna C1 100 pF L1 47 nH Pi matching circuit R1 0R C2 C3 NM NM L76K&L76-LB 差异对比 Module RF_IN C4 100 nF R2 10 Ω for L76-LB 0 Ω for L76K VCC_RF 图 4：VCC_RF 兼容设计 L76K 的 VCC_RF（引脚 14）内部有天线检测功能和限流电阻，故外围不需要增加限流电阻。其天线 状态检测功能的详情如下：  当 VCC_RF 输出电流小于 2.5 mA 时，判定天线为开路状态；输出电流在 2.5~50 mA 之间时， 判定天线为正常状态；VCC_RF 最大能输出 50 mA 电流，如果天线耗流大于 50 mA，判定天线 为短路状态，因此选择有源天线时需注意其耗流大小。  天线状态可通过 NMEA 语句输出。 2.3.3. I2C 接口引脚（引脚 16/17） L76K 不支持 I2C 接口，因此引脚 16/17 需悬空处理。 2.3.4. SET/FORCE_ON 引脚（引脚 18） L76-LB 的引脚 18 为 FORCE_ON 引脚，用于强制从 Backup 模式唤醒模块，高电平有效。 L76K 的引脚 18 为星系配置引脚。在模块上电前，若此引脚悬空（默认状态）则模块的默认星系配置 为 GPS + BeiDou，若外部下拉此引脚为低电平则默认星系配置为 GPS + GLONASS。开机后，也可以通 过命令对默认星系进行配置，可支持的配置见第 2.4 章。 上海移远通信技术股份有限公司 13 / 18 2.4. 频段和星系组合 L76K&L76-LB 差异对比 表 3：频段和星系组合 项目 支持的星系频段 默认星系配置 支持的星系配置 L76-LB L76K  GPS L1 C/A  BeiDou B1I  GLONASS L1  GPS L1 C/A  BeiDou B1I  GLONASS L1  GPS + BeiDou 或 GPS + GLONASS，视 软件版本而定。   上电前 SET 引脚悬空：GPS + BeiDou 上电前拉低 SET 引脚：GPS + GLONASS  GPS  GPS + GLONASS  GPS + BeiDou  GPS  BeiDou  GLONASS  GPS + BeiDou  GPS + GLONASS  BeiDou + GLONASS  GPS + BeiDou + GLONASS 备注 有 关 星 系 配 置 命 令 的 详 情 ， 请 参 考 《 Quectel_L26-LB&L76-LB_GNSS_ 协 议 规 范 》 和 《Quectel_L76K_GNSS_协议规范》。 2.5. 模块性能 2.5.1. 耗流 表 4：模块耗流 星系组合 L76-LB 捕获 追踪 Standby Backup GPS 23 mA 20 mA GPS + GLONASS 31 mA 27 mA 0.6 mA 8 μA GPS + BeiDou 32 mA 28 mA L76K 捕获 追踪 Standby Backup 23 mA 23 mA 26 mA 26 mA 20 μA 8 μA 26 mA 26 mA 上海移远通信技术股份有限公司 14 / 18 备注 以上耗流测试条件为：  130 dBm 条件下；  捕获、追踪和 Standby 模式下，VCC 供电为 3.3 V；  Backup 模式下，V_BCKP 供电为 3.3 V。 L76K&L76-LB 差异对比 2.5.2. 工作条件 表 5：工作条件 参数 描述 VCC IVCCP V_BCKP TOPR 主供电电压 供电峰值电流 备份供电电压 工作温度 L76-LB 最小值 典型值 最大值 L76K 最小值 典型值 最大值 单位 2.8 3.3 4.3 2.7 3.3 3.4 V 100 100 mA 1.5 3.3 4.5 1.4 3.3 3.6 V -40 25 85 -40 25 85 °C 备注 不推荐将设备置于上述工作条件之外工作，否则可能会影响设备的稳定性。 2.5.3. 灵敏度 表 6：射频灵敏度 配置 射频接收灵敏度 @ GPS + BeiDou 捕获 重捕获 追踪 L76-LB -149 dBm -161 dBm -167 dBm L76K -147 dBm -159 dBm -162 dBm 上海移远通信技术股份有限公司 15 / 18 L76K&L76-LB 差异对比 3 软件差异对比 3.1. 软件差异 下表列出了 L76K 和 L76-LB 在软件方面的差异，由于两款产品使用不同的平台，所以软件协议不同， 无法完全兼容。 表 7：软件差异 项目 软件版本 支持协议 是否支持版本升级 L76-LB L76LBNRxxAxxS NMEA 0183 协议 4.10 版本 PMTK（联发科专有协议） PQ（移远通信专有协议） 是 L76K ROM 版本 NMEA 0183 协议 4.10 版本 CASIC（中科微通信专有协议） 否 上海移远通信技术股份有限公司 16 / 18 L76K&L76-LB 差异对比 4 附录 A 相关文档及术语缩写 表 8：相关文档 序号 文档名称 描述 [1] Quectel_L76-LB_硬件设计手册 L76-LB 硬件设计手册 [2] Quectel_L26-LB&L76-LB_GNSS_协议规范_V1.0 L76-LB/L26-LB GNSS 协议规范 [3] Quectel_L76-LB_参考设计手册 L76-LB 参考设计手册 [4] Quectel_L76K_硬件设计手册 L76K 硬件设计手册 [5] Quectel_L76K_GNSS_协议规范 L76K GNSS 协议规范 [6] Quectel_L76K_参考设计手册 L76K 参考设计手册 表 9：术语和缩写词 术语 英文全称 AI Analog Input AO Analog Output DI Digital Input DO Digital Output GLONASS Global Navigation Satellite System (Russia) GNSS Global Navigation Satellite System GPS Global Positioning System I/O Input/Output I2C Inter-Integrated Circuit LCC Leadless Chip Carrier 中文全称 模拟输入 模拟输出 数字输入 数字输出 格洛纳斯导航卫星系统（俄罗斯） 全球导航卫星系统 全球定位系统 输入/输出 集成电路总线 无引脚芯片载体 上海移远通信技术股份有限公司 17 / 18 LCC NMEA PI PO ROM UART L76K&L76-LB 差异对比 Leadless Chip Carrier 无引线芯片载体 NMEA (National Marine Electronics NMEA（美国国家海洋电子协会）0183 Association) 0183 Interface Standard 接口标准 Power Input 电源输入 Power Output 电源输出 Read-Only Memory 只读存储器 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 上海移远通信技术股份有限公司 18 / 18

BC260Y-CN 运营商自注册使用说明 NB-IoT 模块系列 版本：1.0 日期：2020-10-28 状态：受控文件 www.quectel.com BC260Y-CN 运营商自注册使用说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 20 BC260Y-CN 运营商自注册使用说明 文档历史 修订记录 版本 日期 作者 变更表述 - 2020-10-22 张鑫/李婷婷 文档创建 1.0 2020-10-28 张鑫/李婷婷 受控版本 上海移远通信技术股份有限公司 2 / 20 BC260Y-CN 运营商自注册使用说明 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 运营商自注册机制 ................................................................................................................................. 7 2.1. 电信自注册 ................................................................................................................................. 7 2.1.1. 自注册启动 ...................................................................................................................... 7 2.1.2. 自注册成功 ...................................................................................................................... 7 2.1.3. 自注册失败 ...................................................................................................................... 8 2.1.4. 自注册影响 ...................................................................................................................... 8 2.2. 移动 CMDMP 自注册.................................................................................................................. 8 2.2.1. 自注册启动 ...................................................................................................................... 8 2.2.2. 自注册成功 ...................................................................................................................... 8 2.2.3. 自注册失败 ...................................................................................................................... 9 2.2.4. 自注册影响 ...................................................................................................................... 9 3 运营商自注册相关 AT 命令 ................................................................................................................. 10 3.1. AT 命令语句.............................................................................................................................. 10 3.1.1. 定义 ............................................................................................................................... 10 3.1.2. AT 命令语句 .................................................................................................................. 10 3.2. AT 命令描述...............................................................................................................................11 3.2.1. AT+QSREGENABLE 启用/禁用中国电信自注册.........................................................11 3.2.2. AT+QDMPCFG CMDMP 接入配置............................................................................. 12 3.2.3. AT+QDMPCFGEX CMDMP 接入扩展配置 ................................................................ 15 4 附录 术语缩写..................................................................................................................................... 20 上海移远通信技术股份有限公司 3 / 20 BC260Y-CN 运营商自注册使用说明 表格索引 表 1：AT 命令及响应类型........................................................................................................................... 10 表 2：术语缩写 ........................................................................................................................................... 20 上海移远通信技术股份有限公司 4 / 20 BC260Y-CN 运营商自注册使用说明 图片索引 图 1：中国电信自注册流程........................................................................................................................... 7 图 2：中国移动 CMDMP 自注册流程 ........................................................................................................... 8 上海移远通信技术股份有限公司 5 / 20 BC260Y-CN 运营商自注册使用说明 1 引言 遵照运营商入库测试需求，移远通信 BC260Y-CN 模块集成了中国电信和中国移动的自注册功能，从 而实现了对终端设备更方便、更有效的管理。本文档主要介绍 BC260Y 模块的自注册机制以及与自注册相 关的 AT 命令。 上海移远通信技术股份有限公司 6 / 20 BC260Y-CN 运营商自注册使用说明 2 运营商自注册机制 2.1. 电信自注册 设备开机入网 开机第一次自注 册失败后，最多 再重试两次 间隔一小时 版本号或机卡 匹配变更？ 否 是 启动自注册 否 重试后 是否自注册成功？ 否 自注册成功？ 是 4 是 流程结束 ？ 次 图 1：中国电信自注册流程 2.1.1. 自注册启动 模块开机入网并识别到中国电信 USIM 卡后，将自动检测模块固件版本号是否变更或者机卡匹配关系 是否发生变化；若符合自注册触发条件，模块会启动电信自注册并自动向电信自注册平台发送特定格式的 数据包以完成设备信息的更新。 2.1.2. 自注册成功 若自注册成功，且模块后续没有固件版本号变更或者机卡匹配关系变化，则模块重启或者断电后再开 机都不会再次触发电信自注册。 上海移远通信技术股份有限公司 7 / 20 BC260Y-CN 运营商自注册使用说明 2.1.3. 自注册失败 ⚫ 若开机后第一次自注册失败，模块会自动再重试两次，每次重试间隔时间为 1 小时。 ⚫ 若重试两次后仍然失败，则等下次开机才会再次触发自注册流程。 2.1.4. 自注册影响 ⚫ 若未设置禁用休眠模式，模块自注册失败后，自动进入深休眠，不会进行自注册重试。 ⚫ 自注册过程中 CoAP 重传可能会影响模块进入深休眠模式的时间。 ⚫ 自注册服务器地址采用域名模式；若域名解析失败，可能会影响模块进入深休眠模式的时间。 2.2. 移动 CMDMP 自注册 设备开机入网 启动自注册 否 自注册成功 是 流程结束 24小时周期性更新 图 2：中国移动 CMDMP 自注册流程 2.2.1. 自注册启动 模块开机入网并识别到中国移动 USIM 卡后，默认自动注册到移动 CMDMP 服务器。 2.2.2. 自注册成功 若自注册成功，模块将默认周期性地（每隔 24 小时）执行一次更新操作。 上海移远通信技术股份有限公司 8 / 20 BC260Y-CN 运营商自注册使用说明 2.2.3. 自注册失败 ⚫ 若模块向 CMDMP 平台发送注册包但未收到平台回复，将进行 5 次重发，即最多发送 6 次注册数 据包；重发间隔依次默认为 2 秒、4 秒、8 秒、16 秒、32 秒、64 秒，总超时时间为 128 秒。 ⚫ 若 5 次重发均未收到平台回复或者收到错误回复，则在下次开机入网时再重新触发自注册流程。 2.2.4. 自注册影响 ⚫ 自注册过程中 CoAP 协议重传可能会影响模块进入深休眠模式的时间。 ⚫ 周期性更新可能会将模块从深休眠模式唤醒。 上海移远通信技术股份有限公司 9 / 20 BC260Y-CN 运营商自注册使用说明 3 运营商自注册相关 AT 命令 本章介绍如何使用 AT 命令控制运营商自注册功能。关于是否需要开启运营商自注册功能，请联系对应 的运营商进行确认。 3.1. AT 命令语句 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 10 / 20 BC260Y-CN 运营商自注册使用说明 3.2. AT 命令描述 3.2.1. AT+QSREGENABLE 启用/禁用中国电信自注册 该命令用于启用/禁用中国电信的自注册功能。 AT+QSREGENABLE 启用/禁用中国电信自注册 查询命令 AT+QSREGENABLE? 响应 +QSREGENABLE: 设置命令 AT+QSREGENABLE= OK 响应 OK 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令重启后生效，参数配置自动保存至 NVRAM，且深休眠唤醒后 仍有效。 参数 整型。启用/禁用中国电信自注册功能。 0 禁用中国电信自注册功能 1 启用中国电信自注册功能 备注 对于 BC260YCNAAR01A03 升级到 BC260YCNAAR01A04 及以上版本时，如果 FOTA 升级前，已配置 AT+QSREGENABLE=1，FOTA 升级后，将不会清除 NVRAM。此时，AT+QSREGENABLE?的查询结 果将为 3，但原有配置依旧有效。 举例 AT+QSREGENABLE? +QSREGENABLE: 0 OK AT+QSREGENABLE=1 OK //查询中国电信自注册状态。 //禁用中国电信自注册。 //启用中国电信自注册。 上海移远通信技术股份有限公司 11 / 20 BC260Y-CN 运营商自注册使用说明 3.2.2. AT+QDMPCFG CMDMP 接入配置 该命令用于配置和查询 CMDMP 接入信息。 查询命令用于查询模块当前配置的参数。 设置命令用于保存或擦除配置信息，相关配置重启后生效。 AT+QDMPCFG CMDMP 接入配置 测试命令 AT+QDMPCFG=? 响应 +QDMPCFG: [,[,[,[,]]]] 查询命令 AT+QDMPCFG? OK 响应 +QDMPCFG: 0, +QDMPCFG: 1,,, +QDMPCFG: 2,,,, OK 设置命令 AT+QDMPCFG=[,[,[,[,]]]] 响应 当为 0、1、2 或 5 且命令执行成功时： OK 当为 4、为 0 且命令执行成功时： +QDMPCFG: 0, OK 当为 4、为 1 且命令执行成功时： +QDMPCFG: 1,,, OK 当为 4、为 2 且命令执行成功时： +QDMPCFG: 2,,,, OK 上海移远通信技术股份有限公司 12 / 20 BC260Y-CN 运营商自注册使用说明 最大响应时间 特性说明 当为 6 且命令执行成功时： +QDMPCFG: 6, OK 若出现任何错误： ERROR 300 毫秒 该命令重启后生效，参数配置自动保存至 NVRAM，且深休眠 唤醒后仍有效。 参数 整型。配置类型。 0 配置 CMDMP 接入状态 1 配置 CMDMP 服务器地址、端口与更新周期 2 配置 CMDMP 应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 4 查询保存到 NVRAM 的配置信息 5 擦除保存到 NVRAM 的配置信息 6 查询 CMDMP 接入状态 不同的值配置不同的参数，格式如下： 0 1 2 3 预留值 4 5 6 整型。CMDMP 接入模式。 0 禁止接入 CMDMP 1 允许接入 CMDMP 字符串类型。CMDMP 服务器 IP/域名地址，默认服务器 IP 为 117.161.2.41，默认域名 为 m.fxltsbl.com。 整型。CMDMP 服务器端口，默认服务器端口为 5683。范围：1~65535。 整型。更新周期。范围：300~4294966，默认值为 86400；单位：秒。 字符串类型。应用密钥。设置命令中，应用双引号标记。 字符串类型。私钥。设置命令中，应用双引号标记；私钥仅显示前四位字符。 整型。终端类型。 0 接口 1 Linux 上海移远通信技术股份有限公司 13 / 20 BC260Y-CN 运营商自注册使用说明 2 Android 字符串类型。终端设备的 IMEI 号。长度应为 15~17 字节。 整型。保存的配置信息查询选项。 0 查询保存的 CMDMP 接入模式 1 查询保存的 CMDMP 服务器 IP 地址、端口和更新周期 2 查询保存的应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 整型。保存的配置信息擦除选项。 0 擦除保存的 CMDMP 接入模式 1 擦除保存的 CMDMP 服务器 IP 地址、端口和更新周期 2 擦除保存的应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 4 擦除以上保存的所有信息 整型。CMDMP 接入状态。 0 DMP 初始状态 4 DMP 连接成功 5 DMP 连接失败 6 DMP 注册成功 7 DMP 注册失败 8 DMP 注册超时 9 DMP 生命周期超时 11 DMP 更新成功 12 DMP 更新失败 13 DMP 更新超时 举例 AT+QDMPCFG? //查询当前配置信息。 +QDMPCFG: 0,1 +QDMPCFG: 1,117.161.2.7,5683,420 +QDMPCFG: 2,M100000089,95Go****,1,863703030822519 OK AT+QDMPCFG=0,0 OK AT+QDMPCFG=4,0 +QDMPCFG: 0,0 //禁止接入 CMDMP。 //查询已保存的 CMDMP 接入模式。 OK AT+QDMPCFG=1,117.161.2.7,5683,420 OK AT+QDMPCFG=4,1 +QDMPCFG: 1,117.161.2.7,5683,420 //设置 CMDMP 服务器 IP 地址、端口和更新周期。 '117.161.2.7'是 CMDMP 测试服务器 IP 地址。 //查询保存的 CMDMP 服务器 IP 地址、端口和更新周期。 上海移远通信技术股份有限公司 14 / 20 BC260Y-CN 运营商自注册使用说明 OK AT+QDMPCFG=2,'M100000089','95Go****',1,863703030822519 //设置应用密钥、私钥、终端类型 和终端 IMEI 号。 OK AT+QDMPCFG=4,2 //查询保存的应用密钥、私钥、终端类型和终端 IMEI 号。 +QDMPCFG: 2,M100000089, 95Go****,1,863703030822519 OK AT+QDMPCFG=5,4 OK AT+QDMPCFG=6 +QDMPCFG: 6,6 //擦除所有已保存的信息。 //查询 CMDMP 接入状态。 //DMP 注册成功。 OK AT+QDMPCFG=6 +QDMPCFG: 6,11 //DMP 更新成功。 OK 3.2.3. AT+QDMPCFGEX CMDMP 接入扩展配置 该命令用于配置和查询 CMDMP v2.0 所需的 CMDMP 接入扩展信息。 设置命令用于保存、读取或擦除配置信息，相关配置重启后生效。 AT+QDMPCFGEX CMDMP 接入扩展配置 测试命令 AT+QDMPCFGEX=? 响应 +QDMPCFGEX: ,[,[,[,,]]] OK 设置命令 AT+QDMPCFGEX=,[,[,[,,]]] 响应 当为 0 或 2 且命令执行成功时： OK 当为 0、为 1 且命令执行成功时： +QDMPCFGEX: 0, OK 当为 1、为 1 且命令执行成功时： +QDMPCFGEX: 1, 上海移远通信技术股份有限公司 15 / 20 BC260Y-CN 运营商自注册使用说明 最大响应时间 特性说明 OK 当为 2、为 1 且命令执行成功时： +QDMPCFGEX: 2,,,, OK 当为 3、为 1 且命令执行成功时： +QDMPCFGEX: 3,, OK 当为 4、为 1 且命令执行成功时： +QDMPCFGEX: 4,,,, OK 当为 5、为 1 且命令执行成功时： +QDMPCFGEX: 5, OK 若出现任何错误： ERROR 300 毫秒 该命令重启后生效，参数配置自动保存至 NVRAM，且深休眠 唤醒后仍有效。 参数 整型。配置类型。 0 配置终端应用程序信息 1 配置终端 MAC 地址 2 配置终端 ROM、RAM、CPU 和操作系统版本信息 3 配置终端软件版本和名称 4 配置终端 VoLTE 状态、网络类型、宽带帐号和电话号码 5 配置终端位置信息 整型。配置模式。 0 保存信息至模块 1 读取模块中的信息 上海移远通信技术股份有限公司 16 / 20 BC260Y-CN 运营商自注册使用说明 2 擦除模块中的信息 不同的值配置不同的参数，格式如下： 0 0 1 0 2 0 3 0 4 0 5 0 带双引号的字符串型。表示终端应用程序信息，最大字符串长度为 255 字节。它是应用 程序信息的集合，每个信息块用分号分隔，内容包含应用程序名称、包名称、应用程序 使用时间（单位：毫秒）、应用程序打开次数，并且每部分内容以'|'分隔。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 MAC 地址，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 ROM 信息，最大字符串长度为 19 字节。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 RAM 信息，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 CPU 信息，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端操作系统版本，最大字符串长度为 47 字节。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的软件版本，最大字符串长度为 47 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的软件名称，最大字符串长度为 47 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端 VoLTE 状态，最大字符串长度为 7 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端网络类型，最大字符串长度为 19 字节。如果没有相关 信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端宽带账号，最大字符串长度为 47 字节。如果没有相关 信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的电话号码，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的位置信息，最大字符串长度为 255 字节。如果没有相 关信息，请将其设置为'NULL'。 举例 AT+QDMPCFGEX=0,0,'Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551 ;Alipay|FW88|22650|5555;Zhihu|FW333|77750|65101' //设置 APP 信息。 OK AT+QDMPCFGEX=0,1 //查询 APP 信息。 上海移远通信技术股份有限公司 17 / 20 BC260Y-CN 运营商自注册使用说明 +QDMPCFGEX: 0,Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551;Alip ay|FW88|22650|5555;Zhihu|FW333|77750|65101 OK AT+QDMPCFGEX=0,2 OK AT+QDMPCFGEX=1,0,'00-01-6C-06-A6-29' OK AT+QDMPCFGEX=1,1 +QDMPCFGEX: 1,00-01-6C-06-A6-29 //擦除 APP 信息。 //设置 MAC 地址。 //查询 MAC 地址。 OK AT+QDMPCFGEX=1,2 //擦除 MAC 地址。 OK AT+QDMPCFGEX=2,0,'4096KB','4096KB','EC616','FREE RTOS' //设置 ROM、RAM、CPU、OS 版本信息。 OK AT+QDMPCFGEX=2,1 //查询 ROM、RAM、CPU、OS 版本信息。 +QDMPCFGEX: 2,4096KB,4096KB,EC616,FREE RTOS OK AT+QDMPCFGEX=2,2 OK AT+QDMPCFGEX=3,0,'BC260YCNAAR01A03','Quectel' OK AT+QDMPCFGEX=3,1 +QDMPCFGEX: 3,BC260YCNAAR01A03,Quectel //擦除 ROM、RAM、CPU、OS 版本信息。 //设置软件版本和名称。 //查询软件版本和名称。 OK AT+QDMPCFGEX=3,2 //擦除软件版本和名称。 OK AT+QDMPCFGEX=4,0,'off','NB-IoT','XY05553867549','18009699999' //设置 VoLTE 状态、网络类 型、宽带帐号和电话号码。 OK AT+QDMPCFGEX=4,1 //查询 VoLTE 状态、网络类型、宽带帐号和电话号码。 +QDMPCFGEX: 4,off,NB-IoT,XY05553867549,18009699999 OK AT+QDMPCFGEX=4,2 //擦除 VoLTE 状态、网络类型、宽带帐号和电话号码。 OK AT+QDMPCFGEX=5,0,'31.8438799075,117.2025477950,OTDOA' //设置位置信息。 OK AT+QDMPCFGEX=5,1 //查询位置信息。 +QDMPCFGEX: 5,31.8438799075,117.2025477950,OTDOA 上海移远通信技术股份有限公司 18 / 20 OK AT+QDMPCFGEX=5,2 OK BC260Y-CN 运营商自注册使用说明 //擦除位置信息。 上海移远通信技术股份有限公司 19 / 20 BC260Y-CN 运营商自注册使用说明 4 附录 术语缩写 表 2：术语缩写 术语 APP CoAP CMDMP CPU IMEI IP MAC ME NB-IoT NVRAM OS RAM ROM USIM VoLTE 英文全称 Applications Constrained Application Protocol China Mobile Device Management Platform Central Processing Unit International Mobile Equipment Identity Internet Protocol Media Access Control Mobile Equipment Narrow Band Internet of Things Non-Volatile Random Access Memory Operating System Random Access Memory Read Only Memory Universal Subscriber Identity Module Voice over Long-Term Evolution 中文全称 应用程序 受限应用协议 中国移动设备管理平台 中央处理单元 国际移动设备识别码 互联网协议 媒体接入控制 移动设备 窄带物联网 非易失性随机访问存储器 操作系统 随机访问存储器 只读存储器 全球用户识别模块 长期演进语音承载（一般称高清通话） 上海移远通信技术股份有限公司 20 / 20

BC260Y-CN 软件注意事项及 FAQ NB-IoT 模块系列 版本：1.1 日期：2021-01-11 状态：受控文件 www.quectel.com BC260Y-CN 软件注意事项及 FAQ 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 44 BC260Y-CN 软件注意事项及 FAQ 文档历史 修订记录 版本 1.0 日期 2020-08-11 2020-09-24 1.1 2021-01-11 作者 李婷婷 李婷婷 吴致文 变更表述 文档创建 受控版本 1. 更新文档名称； 2. 更新目录结构； 3. 扩充文档内容，增加软件注意事项。 上海移远通信技术股份有限公司 2 / 44 BC260Y-CN 软件注意事项及 FAQ 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 7 图片索引 ....................................................................................................................................................... 8 1 引言 ....................................................................................................................................................... 9 2 注意事项 .............................................................................................................................................. 10 2.1. 产品信息 ................................................................................................................................... 10 2.2. 固件烧录 ................................................................................................................................... 10 2.2.1. 固件包说明 .................................................................................................................... 10 2.2.1.1. 获取固件包和相关资料 ....................................................................................... 10 2.2.1.2. 固件包文件介绍 .................................................................................................. 11 2.2.2. 固件包下载 .................................................................................................................... 11 2.2.2.1. QFlash 下载工具 ................................................................................................ 11 2.2.2.2. QFlash 工具参数配置 ......................................................................................... 12 2.2.2.3. 通过 QFlash 下载固件包流程 ............................................................................. 13 2.3. 常用工具 ................................................................................................................................... 13 2.3.1. Log 抓取工具（EPAT） ................................................................................................ 13 2.3.2. 串口工具（QCOM） ..................................................................................................... 13 2.4. 串口特性 ................................................................................................................................... 14 2.4.1. 波特率配置 .................................................................................................................... 14 2.5. 网络注册流程............................................................................................................................ 15 2.6. DFOTA ..................................................................................................................................... 15 2.7. 低功耗管理 ............................................................................................................................... 16 2.7.1. 休眠模式 ........................................................................................................................ 16 2.7.2. 模块工作状态................................................................................................................. 16 3 FAQ（常见问题） ............................................................................................................................... 18 3.1. 产品信息 ................................................................................................................................... 18 3.1.1. 如何选择合适的产品型号？ ........................................................................................... 18 3.1.2. 如何获取模块的版本和相关文档？ ................................................................................ 18 3.1.3. 如何获取模块的认证信息？ ........................................................................................... 18 3.1.4. BC260Y-CN 模块是否可以直接在海外使用？............................................................... 18 3.1.5. BC260Y-CN 模块是否支持 R14 功能？ ........................................................................ 18 3.1.6. 模块支持哪些频段？...................................................................................................... 19 3.1.7. BC260Y-CN 是否支持内部看门狗？ ............................................................................. 19 3.2. 固件升级 ................................................................................................................................... 19 3.2.1. 为何固件升级失败？...................................................................................................... 19 3.2.1.1. BOOT 引脚未拉低 .............................................................................................. 19 3.2.1.2. 串口转换芯片不支持 921600 bps....................................................................... 19 3.2.1.3. 模块未开机导致下载失败.................................................................................... 19 3.2.1.4. 串口线或飞线接触不良 ....................................................................................... 20 上海移远通信技术股份有限公司 3 / 44 BC260Y-CN 软件注意事项及 FAQ 3.3. 常用工具 ................................................................................................................................... 20 3.3.1. EPAT Log 信息为什么不全？ ........................................................................................ 20 3.3.2. 模块异常重启时，如何通过 EPAT 工具导出 dump 文件？ ........................................... 20 3.3.3. QCOM 为何无法正常使用？.......................................................................................... 20 3.4. 串口 .......................................................................................................................................... 21 3.4.1. 主串口默认波特率是多少？ ........................................................................................... 21 3.4.2. 当模块处于深休眠模式，串口能否接收数据？.............................................................. 21 3.4.3. 串口电平匹配不一致怎么办？ ....................................................................................... 21 3.5. USIM 卡.................................................................................................................................... 21 3.5.1. 模块支持的 USIM 卡电压是多少？ ................................................................................ 21 3.5.2. USIM_DATA 引脚外部是否需要加上拉电阻？.............................................................. 21 3.5.3. 模块是否支持 USIM 卡热插拔？.................................................................................... 21 3.5.4. 如何配置物联网卡的 APN 和 PDP 类型？..................................................................... 22 3.5.5. 为什么开机后模块未找到 USIM 卡？ ............................................................................ 22 3.6. 网络注册 ................................................................................................................................... 23 3.6.1. 如何判断模块是否处于连接状态？ ................................................................................ 23 3.6.2. eDRX、PSM 是什么？.................................................................................................. 23 3.6.3. DRX、eDRX、PSM 是否支持配置？............................................................................ 23 3.6.4. 什么是 TAU？................................................................................................................ 23 3.6.5. 如何通过 AT 命令查看 T3324 和 T3412 的值？ ............................................................ 24 3.6.6. 如何查看模块的 PSM 是否开启？ ................................................................................. 24 3.6.7. PSM 状态是否可以进行业务？...................................................................................... 24 3.6.8. R14 相对于 R13 有哪些提升？...................................................................................... 24 3.6.9. AT+CSQ 查询的信号值较大，但为什么发送数据总是失败？....................................... 24 3.6.10. 如何判断 NB-IoT 网络的信号质量？.............................................................................. 25 3.6.11. 在发起数据业务之前，先查询 IP 地址是否已经获取成功 ............................................. 25 3.6.12. 为什么模块开机后无法注册网络？ ................................................................................ 25 3.6.13. 模块支持哪些网络制式？............................................................................................... 25 3.6.14. 如何清除模块的历史频点信息？.................................................................................... 25 3.6.15. 关于时间同步................................................................................................................. 25 3.6.16. 网络指示灯是否已经开通？ ........................................................................................... 26 3.6.17. BC260Y-CN 模块支持 NB-IoT 异频组网吗？................................................................ 26 3.7. DFOTA ..................................................................................................................................... 26 3.7.1. DFOTA 是否支持断电/断点续传？ ................................................................................ 26 3.7.2. DFOTA 是否支持加密？................................................................................................ 26 3.7.3. DFOTA 是否支持 IPv6 下的升级？ ............................................................................... 26 3.7.4. 模块是否支持升级外部 MCU？ ..................................................................................... 26 3.7.5. 对接电信 IoT/AEP 平台进行固件升级时有哪些注意事项？........................................... 27 3.8. TCP/UDP.................................................................................................................................. 27 3.8.1. AT+QIOPEN 是否能够连接 IPv6 域名类型的服务器？ ................................................. 27 3.8.2. AT+QIDNSGIP 是否支持 IPv6 域名方式？ ................................................................... 27 3.8.3. 模块是否可以同时作为服务器和客户端？ ..................................................................... 27 3.8.4. AT+QISEND 发送数据后，SEND OK 是否标志已经发送到服务器？ .......................... 27 3.8.5. 关于 AT+QISEND 的 RAI 标记，有何配置建议？......................................................... 27 上海移远通信技术股份有限公司 4 / 44 BC260Y-CN 软件注意事项及 FAQ 3.8.6. 模块进入 PSM 后是否能收到下行数据？ ...................................................................... 28 3.8.7. 为什么 TCP 会出现 RST？............................................................................................ 28 3.8.8. 为什么 UDP 出现端口不可达？ ..................................................................................... 28 3.8.9. 模块默认的 DNS 服务器是什么？若 DNS 解析失败该如何处理？................................ 28 3.8.10. 模块是否支持 SSL/TLS 协议? ....................................................................................... 29 3.8.11. 关闭 Socket 链路之后，再次执行 AT+QIOPEN 为什么会失败？ ................................. 29 3.9. 电信物联网平台 ........................................................................................................................ 30 3.9.1. 什么是电信 IoT/AEP 平台？ .......................................................................................... 30 3.9.2. AT+NCDPOPEN 命令返回+QLWEVTIND: 1，可能的原因是什么？ ........................... 30 3.9.3. 生命周期（Lifetime）机制的作用是什么？ ................................................................... 31 3.9.4. 模块是否支持手动更新 Lifetime？如何关闭 Lifetime 的自动更新？.............................. 31 3.9.5. IoT 平台的立即下发与缓存下发有何区别？ .................................................................. 31 3.9.6. 模块对接 IoT/AEP 平台是否支持实时收发数据？ ......................................................... 31 3.9.7. 对接 IoT/AEP 平台，模块发送的数据包长度最大为多少？........................................... 31 3.9.8. 模块从深休眠唤醒是否可以立即发送数据？ ................................................................. 32 3.9.9. 模块是否支持 BS（Bootstrap）和加密？...................................................................... 32 3.9.10. 模块是否支持 CoAP 协议？ .......................................................................................... 32 3.10. 中国移动 OneNET.................................................................................................................... 32 3.10.1. 如何查询模块支持的 OneNET SDK 版本？ .................................................................. 32 3.10.2. 模块是否支持 BS 和加密？ ........................................................................................... 32 3.10.3. 模块注册到 OneNET 平台并进入深休眠模式后是否支持自行恢复？ ........................... 33 3.10.4. 模块从深休眠模式唤醒后上报+MIPLEVENT: 0,4 有什么含义？................................... 33 3.10.5. 执行 AT+MIPLOPEN 注册平台何种情况下会返回+MIPLEVENT: 0,3？....................... 33 3.10.6. 删除了对象（Object），为何平台上还是能看到资源列表？ ........................................ 33 3.10.7. 连接 OneNET 平台后，是否需要经常发送心跳包维持连接？ ...................................... 33 3.10.8. 注册成功后为什么没有下发订阅和发送资源请求？ ...................................................... 33 3.10.9. 对接 OneNET 平台时，是否可以关闭生命周期的自动更新？ ...................................... 33 3.10.10. 对接 OneNET 平台时，执行 AT+MIPLOPEN 失败怎么办？ ........................................ 34 3.10.11. 对接 OneNET 平台时，是否支持实时收发数据？......................................................... 34 3.10.12. 执行 AT+MIPLCREATE 创建通信实例之前，需要做何配置？ ..................................... 34 3.10.13. 为什么响应平台下发的发现资源请求和订阅请求会失败？ ........................................... 34 3.11. 低功耗管理与休眠模式 ............................................................................................................. 34 3.11.1. 如何进入浅休眠模式？ .................................................................................................. 34 3.11.2. 如何进入深休眠模式？ .................................................................................................. 34 3.11.3. 如何退出浅休眠模式？ .................................................................................................. 35 3.11.4. 如何退出深休眠模式？ .................................................................................................. 35 3.11.5. 为什么模块发送的 AT 命令会丢失？ ............................................................................. 35 3.11.6. AT+QSCLK 命令配置是否保存？.................................................................................. 35 3.11.7. 模块 PSM_EINT 一直拉低是否无法进入深休眠模式？ ................................................. 35 3.11.8. 为什么关闭了 PSM，模块还会进入了深休眠模式？..................................................... 35 3.11.9. 上报 ENTER PSM 的 URC 之后，为何依然无法进深休眠模式？................................. 35 3.11.10. 深休眠模式唤醒后，模块为何仍然无法接收到平台下发的数据？................................. 36 3.11.11. 关闭了 PSM 和深休眠模式的情况，模块是否收不到平台下发的数据？....................... 36 3.11.12. T3324 时间设置为 0，模块是否可以直接从 Active 态切换为 PSM 态？ ...................... 36 上海移远通信技术股份有限公司 5 / 44 BC260Y-CN 软件注意事项及 FAQ 3.11.13. 如何快速释放 RRC 连接？ ............................................................................................ 36 3.11.14. 深休眠状态下模块自动唤醒，可能的唤醒源有哪些？................................................... 36 3.11.15. 影响模块进入深休眠模式的因素.................................................................................... 36 3.11.16. 模块可以进入深休眠模式的场景.................................................................................... 36 3.11.17. BC260Y-CN 模块进入 PSM 之后为什么 AT 命令不通？ .............................................. 37 3.11.18. 为什么模块已经进入 PSM 状态，但是功耗降低依然不明显？ ..................................... 37 3.11.19. 是否有 BC260Y-CN 模块在各种工作模式下的耗流数据？ ........................................... 37 3.11.20. PSM_EINT 需要拉低多久方可将模块从深休眠模式唤醒？........................................... 37 3.11.21. 除 PSM_EINT 引脚触发方式外，还有其他方式将模块从深休眠模式唤醒吗？ ............ 37 3.11.22. 按 RESET 复位后，测试的 VDD_EXT 波形为方波形式是否正常？ ............................. 37 3.11.23. 开机或者唤醒时 VDD_EXT 存在方波形式么？ ............................................................. 37 3.11.24. 在深休眠模式下，模块的各个引脚状态如何？是否会造成外部 MCU 漏电？ ............... 37 4 附录 A 深休眠模式下模块引脚状态.................................................................................................... 38 5 附录 B 参考文档及术语缩写............................................................................................................... 41 上海移远通信技术股份有限公司 6 / 44 BC260Y-CN 软件注意事项及 FAQ 表格索引 表 1：模块软件基本信息 ............................................................................................................................ 10 表 2：深睡眠模式下 BC260Y-CN 模块的引脚状态 .................................................................................... 38 表 3：参考文档 ........................................................................................................................................... 41 表 4：术语缩写 ........................................................................................................................................... 41 上海移远通信技术股份有限公司 7 / 44 BC260Y-CN 软件注意事项及 FAQ 图片索引 图 1：固件包文件 ....................................................................................................................................... 11 图 2：QFlash 烧录配置示意图 ................................................................................................................... 12 图 3：QCOM 配置 ...................................................................................................................................... 14 图 4：模块开机入网流程 ............................................................................................................................ 15 图 5：BC260Y-CN 模块 Modem 工作模式示意图...................................................................................... 16 图 6：BC260Y-CN 模块系统工作模式示意图............................................................................................. 17 图 7：AT+QIOPEN 失败现象 ..................................................................................................................... 29 图 8：AT+QIOPEN 失败解决方法.............................................................................................................. 30 上海移远通信技术股份有限公司 8 / 44 BC260Y-CN 软件注意事项及 FAQ 1 引言 本文档介绍了移远通信 BC260Y-CN 模块在开发和使用过程中的重要注意事项和常见问题，用户可以 把本文档作为工具手册使用。在项目开发中，如遇到问题，可参考此文档检查是否有相同或者相似的问题 解决方案，快速解决问题，提高项目开发效率。 本文档仅适用于 BC260Y-CN 模块。如无特殊说明，文档中所提及的模块均指代 BC260Y-CN 模块。 备注 本文档中涉及的 AT 命令详细信息，若无另外备注，请参考文档 [1]。 上海移远通信技术股份有限公司 9 / 44 BC260Y-CN 软件注意事项及 FAQ 2 注意事项 2.1. 产品信息 表 1：模块软件基本信息 项目名称 BC260Y-CN 支持频段 B3/B5/B8 主频 204 MHz 芯片架构 Cortex-M3 操作系统 Free RTOS 备注 BC260Y-CN 模块与 M26、BC25、BC26 和 BC28 硬件设计兼容，具体的硬件设计请参考文档 [2]。 2.2. 固件烧录 2.2.1. 固件包说明 模块在出厂时，移远通信会根据订单需求完成对应版本的固件包烧录。收到模块后，用户可通过 ATI 命令查询当前批次的模块固件包版本号。若需反馈问题给移远通信技术支持或者研发解决，请务必将模块 固件包版本号提供给移远通信，以辅助分析或复现问题。 2.2.1.1. 获取固件包和相关资料 可通过移远通信技术支持或者代理商获取最新版本的固件包和相关资料，也可发送邮件到移远通信技 术支持 support@quectel.com 获取。 备注 如果已拿到模块，请提供模块的固件版本号（通过 ATI 命令查询），移远通信将提供对应版本的固件包。 上海移远通信技术股份有限公司 10 / 44 2.2.1.2. 固件包文件介绍 BC260Y-CN 软件注意事项及 FAQ 图 1：固件包文件 备注 可通过 QFlash 4.17 及更新版本的工具选择加载 Bootloader_BC260YCNAARxxAxx.bin 文件，QFlash 将自动导入其他烧录所需的固件文件。 2.2.2. 固件包下载 2.2.2.1. QFlash 下载工具 本章节以使用 QFlash 工具进行固件包下载为例，说明如何烧录固件版本。请选择 4.17 及更新的版本， 关于 QFlash 下载工具下载和使用相关详细信息，请联系移远通信技术支持。 上海移远通信技术股份有限公司 11 / 44 2.2.2.2. QFlash 工具参数配置 BC260Y-CN 软件注意事项及 FAQ 图 2：QFlash 烧录配置示意图 备注 通过模块 AT 口升级固件包时，固定波特率为 921600 bps。为了避免下载失败，所选择的串口芯片需要 能够稳定支持 921600 bps。 上海移远通信技术股份有限公司 12 / 44 BC260Y-CN 软件注意事项及 FAQ 2.2.2.3. 通过 QFlash 下载固件包流程 BOOT 引脚为默认电平（高电平）时，流程如下： 1. 插入 USIM 卡，并且上电。 2. 通过 USB 转 TTL 转接板将 AT 口连接到 PC，建议使用 FT232 串口转换芯片工具。 3. 打开 QFlash 工具，选择 COM 口为对应的 AT 口、波特率为 921600。 4. 选择升级文件 Bootloader_BC260YCNAARxxAx.bin，例如：Bootloader_BC260YCNAAR01A03. bin。 5. 拉低 BOOT 引脚，复位模块，再拉高 BOOT 引脚。 6. 点击 QFlash 工具界面上的'Start'按钮。 7. QFlash 进度条显示升级进度时则表示开始下载。 备注 若升级失败，则需先下电，再重新上电，之后再重复上述步骤。 2.3. 常用工具 2.3.1. Log 抓取工具（EPAT） BC260Y-CN 模块常用的 Log 抓取工具是 EPAT。当模块出现非用户业务异常或者 dump 时，一般难以 通过应用层的 AT Log 定位问题，此时需要抓取问题的 EPAT Log 进行辅助分析。通常，分析如下几类问题 时需要抓取 EPAT Log： ⚫ 模块异常重启或死机。 ⚫ 网络相关异常，如找网失败或找网时间过长。 ⚫ 应用协议相关业务失败，比如 TCP 发送数据失败等。 ⚫ 定位其他内核问题。 备注 关于通过 EPAT 抓取 Log 的具体操作步骤，请参考文档 [3]。 2.3.2. 串口工具（QCOM） QCOM 是移远通信支持开发的一款串口调试工具。QCOM 可实现 PC 端与模块/用户设备进行数据交互、 抓取 APP 层的应用 Log 以及辅助分析问题。 建议在使用 QCOM 工具时，勾选 'Show Time'使 Log 显示时间戳，并勾选'Send With Enter' 上海移远通信技术股份有限公司 13 / 44 对话框，以便于分析问题。 BC260Y-CN 软件注意事项及 FAQ 图 3：QCOM 配置 备注 如果需要进行压力测试，可以将 Log 保存在本地.txt 文件中，避免 Log 丢失。 2.4. 串口特性 串口作为外部 MCU 和模块的数据交互通道，十分重要。可使用主串口同 MCU 进行 AT 交互，还可以 将其用于固件烧录。如果需要抓取 EPAT Log，可以使用调试（Debug）串口。 2.4.1. 波特率配置 一般地，建议使用固定的波特率。模块默认波特率为 9600 bps，可通过 AT+IPR 配置串口波特率为自 适应波特率或者其他固定的波特率，该命令配置会立即生效并保存至 NVRAM。 上海移远通信技术股份有限公司 14 / 44 BC260Y-CN 软件注意事项及 FAQ 需要注意的是，在配置自适应波特率后，需要在 10 秒内发送一次同步数据包(AT)和模块进行波特率 同步，返回 OK 后表示同步成功。 备注 自适应波特率模式下，模块休眠唤醒后，会直接使用开机后同步成功的波特率，无需同步波特率；但是， 在模块重启后，需要重新同步波特率。 2.5. 网络注册流程 BC260Y-CN 模块注册网络流程主要是指从模块开机到 PDP 激活（Attach Complete）的过程。具体的 业务流程如下： 参考 3GPP TS 31.102 TS 36.306 参考 3GPP TS 23.122 上电开机 初始化 PLMN 选择 频点扫描 • USIM 卡识别、NV 读取 • UE能力识别 • 搜网配置检查 • 自动搜网 • 手动搜网 • Band 扫描 • System 扫描 参考 3GPP TS 36.331 参考 3GPP TS 24.301 参考 3GPP TS 36.304 RCC 建链请求 (RCC Connection Request) 附着请求 (Attach Request) 触发RACH 触发RRC建立 小区驻留 Camping On 小区选择 S准侧，芯片特性实现 随机接入 (Random Access) 参考 3GPP TS 36.300 TS 36.322 参考 3GPP TS 36.300 TS 36.331 RCC 建链建立 (RCC Connection Setup) 参考 3GPP TS 24.301 附着请求接受 (Attach Accepted) 附着完成 (Attach Complete) 参考 3GPP TS 36.211 小区搜索 • NPSS • NSSS 参考 3GPP TS 36.331 系统消息接收 • MIB • SIB1 • SIx 图 4：模块开机入网流程 更多详细信息，请参考文档 [4]。 2.6. DFOTA DFOTA 指差分固件空中升级，即通过差分包实现固件升级，所述差分包仅包含模块的当前运行的固件 版本和升级的目标版本之间的差异，相对于全量升级方式，以更小的更新包，降低了数据传输量、极大地 缩短了传输时间和功耗。 上海移远通信技术股份有限公司 15 / 44 BC260Y-CN 软件注意事项及 FAQ 为了满足用户固件包的 OTA 升级功能，BC260Y-CN 模块提供了两种主要的 DFOTA 方式：中国电信 IoT/AEP 平台升级和中国移动 OneNET 平台升级。 更多详细信息，请参考文档 [5]。 2.7. 低功耗管理 2.7.1. 休眠模式 在嵌入式应用中，系统的功耗越来越受到重视，这对于需要电池供电的便携式系统尤为重要。降低系 统功耗，延长电池的寿命，就是降低系统的运营成本。系统功耗的最小化需要从软、硬件两方面入手，下 面重点介绍如何从软件方面降低系统功耗。 BC260Y-CN 模块有深休眠和浅休眠两种休眠模式。模块开机默认允许进入深浅休眠模式，用户可使用 AT+QSCLK 命令对休眠模式进行控制。 AT+QSCLK 命令说明： ⚫ AT+QSCLK=0：禁用休眠模式。 ⚫ AT+QSCLK=1：允许模块休眠等级最深可进入深休眠模式。 ⚫ AT+QSCLK=2：允许模块休眠等级最深可进入浅休眠模式。 AT+QSCLK 掉电不保存，重启后恢复为默认值（默认为 1，允许进入深休眠、浅休眠)。 2.7.2. 模块工作状态 模块 Modem 的工作模式分为 Connect、Idle 和 PSM 三种模式，如下图所示。 耗流 接收 状态 发射 状态 模块不活动定时器 Idle T3324 PSM T3412 Idle TAU 图 5：BC260Y-CN 模块 Modem 工作模式示意图 上海移远通信技术股份有限公司 16 / 44 BC260Y-CN 软件注意事项及 FAQ 备注 1. DRX 周期不支持配置，也不支持功能的开启或关闭； 2. eDRX 和 PSM 的周期均可配置，也支持功能开启和关闭，但网络是否接受配置依赖于运营商设置。 如果网络不支持配置 eDRX 和 PSM 的周期，建议咨询运营商特定 APN 对应的 eDRX、PSM 时长， 以期找到一个符合业务模型的节能周期。 模块系统的工作模式分为唤醒模式（Active）、浅休眠模式（Light Sleep）和深休眠模式（Deep Sleep）， 如下图所示。 Connect CPU Active Idle So ftwar e control CPU Light Sleep Software control 1. RTC event 2. PSM_EINT PSM CPU Deep Sleep Only 32KHz RTC is act ive 图 6：BC260Y-CN 模块系统工作模式示意图 上海移远通信技术股份有限公司 17 / 44 BC260Y-CN 软件注意事项及 FAQ 3 FAQ（常见问题） 3.1. 产品信息 3.1.1. 如何选择合适的产品型号？ 前期产品选型请咨询移远通信销售或技术支持 support@quectel.com，模块具体信息请参考文档 [6]。 3.1.2. 如何获取模块的版本和相关文档？ ⚫ 如需正式固件版本和相关文档，请咨询移远通信技术支持。 ⚫ 下一个正式固件版本和文档的归档日期，请咨询移远通信技术支持。 ⚫ 如需定制固件版本，请咨询移远通信销售。 3.1.3. 如何获取模块的认证信息？ 关于模块认证的相关信息，请咨询移远通信技术支持。 3.1.4. BC260Y-CN 模块是否可以直接在海外使用？ 不建议直接在海外使用 BC260Y-CN 模块。由于国内外模块认证以及支持的频段不同，在海外模块可 能无法正常工作或者嵌入模块的整机产品可能无法通过最终认证。对于海外市场，建议使用针对海外市场 的模块型号，如有需要，请联系移远通信销售。 3.1.5. BC260Y-CN 模块是否支持 R14 功能？ BC260Y-CN 模块支持 R14 功能，默认为关闭状态。如果需要配置开启 R14，请咨询当地运营商当前 R14 是否已经稳定覆盖。 通过 AT 命令开启 R13 和 R14 的方式如下： ⚫ 在 AT+CFUN=0 条件下，发送 AT+QCFG='relversion',13，即可开启 R13，该配置重启后生效， 掉电自动保存。 ⚫ 在 AT+CFUN=0 条件下，发送 AT+QCFG='relversion',14，即可开启 R14，该配置重启后生效， 掉电自动保存。 上海移远通信技术股份有限公司 18 / 44 BC260Y-CN 软件注意事项及 FAQ 备注 如果当地运营商不支持 R14，即使模块侧开启了 R14 功能，模块仍将在 R13 下工作。 3.1.6. 模块支持哪些频段？ BC260Y-CN 目前已经支持 B3/B5/B8，可使用中国移动、中国电信和中国联通运营商的 NB-IoT 网络。 3.1.7. BC260Y-CN 是否支持内部看门狗？ BC260Y-CN 模块支持内部看门狗。当模块出现死机、线程卡死等异常时，会自动触发看门狗并重启， 看门狗超时时间是 30 秒，用户不可配置。 3.2. 固件升级 3.2.1. 为何固件升级失败？ 固件升级失败的原因一般包括如下小节： 3.2.1.1. BOOT 引脚未拉低 在模块复位或者上电时，保持 BOOT 引脚输入为低，模块进入下载模式。建议使用按键控制 BOOT 引 脚。 3.2.1.2. 串口转换芯片不支持 921600 bps 由于模块的主串口作为下载串口时，波特率只支持 921600 bps，如果使用了不支持 921600 bps 的串 口转换芯片，将会导致下载失败，需更换串口芯片。推荐使用如下串口芯片： ⚫ 四路串口芯片 FT4232 ⚫ 两路串口芯片 XR21V1412 ⚫ 单路串口芯片 CP2102、XR21B111L16 3.2.1.3. 模块未开机导致下载失败 模块上电后，保持 RESET 引脚及 BOOT 输入引脚不被拉低，模块自动开机。另外，可以通过 VDD_EXT 电压来判断模块是否可以正常开机。如果开机成功，VDD_EXT 电压为 1.8 V。 上海移远通信技术股份有限公司 19 / 44 3.2.1.4. 串口线或飞线接触不良 上述原因均排除后，请检查串口线或飞线是否接触不良。 BC260Y-CN 软件注意事项及 FAQ 3.3. 常用工具 3.3.1. EPAT Log 信息为什么不全？ 若 EPAT 工具没有导入对应固件版本的 TRACE DB 文件（comdb.txt）、或者 debug 串口转换芯片不 支持 6M 波特率、再或者 debug 串口转换芯片支持、但模块配置的波特率参数过低（低于 3M 波特率）， 会导致 Log 信息显示不全。 备注 关于导入固件版本 TRACE DB 文件的方法，请参考文档 [3]。 3.3.2. 模块异常重启时，如何通过 EPAT 工具导出 dump 文件？ 对于移远通信正式版本固件，当模块异常 dump 时，默认不输出 dump 信息，而是自动重启模块，保 证模块可以正常继续工作。若需要分析 dump 原因，需执行 AT+ECPCFG='FaultAction',3（此命令立即 生效且掉电保存）并重启模块，之后，dump 复现时，模块会将所有异常信息存储到 Flash 和 EPAT 工具。 导出 dump 文件流程如下： 1. 当模块出现 dump 时，EPAT 工具会弹出 RamDump 对话框。 2. 将 dump 文件保存到一个自定义的文件夹。 3. 将 dump 文件和当前使用的固件包（或固件版本号）打包并提交给移远通信技术支持。 3.3.3. QCOM 为何无法正常使用？ 无法正常使用 QCOM 的常见原因如下： ⚫ 串口选择错误或串口被占用。请确认主串口是否可以正常使用。 ⚫ 未勾选'Send With Enter'，导致 AT 命令发送后没有返回。 请在配置 QCOM 工具时勾选'Send With Enter'。 上海移远通信技术股份有限公司 20 / 44 BC260Y-CN 软件注意事项及 FAQ 3.4. 串口 3.4.1. 主串口默认波特率是多少？ 主串口默认波特率为 9600 bps，可以使用 AT+IPR 配置波特率。该命令立即生效，且深休眠唤醒后有 效，自动保存至 NVRAM。 3.4.2. 当模块处于深休眠模式，串口能否接收数据？ 当模块处于深休眠模式时，串口无法收发数据。如果需要通过串口接收数据，则需持续发送 AT，模块 返回 OK 后，才能进行数据业务；也可以先通过 PSM_EINT 引脚唤醒模块，再进行数据业务。 备注 MCU 控制 PSM_EINT 下降沿唤醒模块后，先发送命令 AT 给模块，当模块返回 OK 后，再继续发送业务 AT。为了避免模块被唤醒后，还没有发送 AT 再次进入睡眠模式，PSM_EINT 引脚需等待模块返回 OK 后，再拉高。 3.4.3. 串口电平匹配不一致怎么办？ 如果模块的串口电压和外部 MCU 的串口电平不一致，需要在硬件上做电路匹配。具体的电路实现，请 参考文档 [7] 的串口部分介绍。 3.5. USIM 卡 3.5.1. 模块支持的 USIM 卡电压是多少？ 模块支持 1.8 V 和 3.0 V 电压，能够自动识别 1.8 V 和 3.0 V 的 USIM 卡的电压。 3.5.2. USIM_DATA 引脚外部是否需要加上拉电阻？ 按照硬件设计手册要求，USIM_DATA 引脚需增加 10 kΩ 上拉电阻。如无上拉电阻，可能会出现个别 设备识别卡失败或者发现模块和 USIM 卡交互概率性失败的问题。 3.5.3. 模块是否支持 USIM 卡热插拔？ 目前，BC260Y-CN 模块不支持 USIM 卡热插拔功能。当发生掉卡时，模块会上报+CPIN: NOT READY， MCU 检测到该 URC 时，可以通过重启或者使用 AT+CFUN=0/1 发起重新找卡。 上海移远通信技术股份有限公司 21 / 44 BC260Y-CN 软件注意事项及 FAQ 3.5.4. 如何配置物联网卡的 APN 和 PDP 类型？ 目前国内运营商均支持 MME 自动修正 APN，因此配置错误的 APN 也能接入网络；但不建议随意配置， 因为运营商不同的 APN 会配置不同的网络参数，这将影响 T3324/T3412 的值，进而影响终端的功耗。而 PDP 类型配置错误，将导致不能入网。 请参考如下 AT 命令配置 APN，该命令仅对默认激活的 PDP 有效（开机自动激活），其他多路 PDP 的配置请使用 AT+CGDCONT 和 AT+CGACT 命令。 //配置 APN 举例 AT+QCGDEFCONT? +QCGDEFCONT: 'IP','ims',,, //查询模块当前的 APN 设置 //采用 IPv4，APN 为 ims OK AT+QCGDEFCONT='IP' OK //设置 APN 为空，即使用默认 APN 3.5.5. 为什么开机后模块未找到 USIM 卡？ 插入 USIM 卡并开机后模块返回+CPIN: NOT READY 或者 NOT INSERTED，说明模块未找到 USIM 卡。请从以下方面分析解决： ⚫ USIM 卡与卡座接触不良。可以尝试在 USIM 卡上增加垫片。 ⚫ SMT 焊接不良。可以通过万用表测试模块与 USIM 卡焊盘之间的连通性。 ⚫ USIM 卡已损坏。可以将 USIM 卡放在 EVB 或者手机上测试，确认是否正常。 ⚫ VBAT 电源走线过于靠近 USIM 信号线。如果 VBAT 电源走线过于靠近 USIM 信号线，可能会由于 VBAT 电源线上的纹波太大，干扰到 USIM 卡各个信号线，导致 USIM 卡无法识别，可尝试切断附 近的 VBAT 线，通过其他途径单独给模块供电，看问题是否解决。 ⚫ USIM 卡座和模块距离较远，走线过长，或信号线未作地屏蔽处理。如果 USIM 卡座和模块距离较 远，走线过长，各个信号线未作地屏蔽处理，很有可能导致 USIM 卡无法识别，可以尝试使用较 短的飞线直接连接到卡座。 ⚫ USIM 卡信号线上并联的 ESD 保护器件寄生电容过大。USIM 卡信号线上并联的 ESD 保护器件的 寄生电容需要 ≤ 50 pF，过大可能会导致 USIM 卡无法识别，可尝试直接去掉该 ESD 保护器件查 看问题是否消失。 ⚫ 周边环境有干扰。确认测试现场周围是否有超强电/磁场存在，比如高压输电线、大功率无线设备 等，可以尝试使用一个屏蔽罩盖住 USIM 卡以及 USIM 卡各个信号线的走线，或者使用地屏蔽线 处理 USIM 卡信号线，检查问题是否消失。 上海移远通信技术股份有限公司 22 / 44 BC260Y-CN 软件注意事项及 FAQ 3.6. 网络注册 3.6.1. 如何判断模块是否处于连接状态？ 通过 AT+CSCON?可查询模块 Modem 是否处于已连接（Connect）状态。 //查询模块状态 AT+QCSCON? +CSCON: 1,1 //已连接状态 OK //查询模块状态 AT+QCSCON? +CSCON: 1,0 //空闲状态 OK 3.6.2. eDRX、PSM 是什么？ eDRX、PSM 都是节能技术，其中 PSM 是 3GPP Rel-12 引入的，eDRX 是 3GPP Rel-13 引入的。 ⚫ eDRX（Extended Discontinuous Reception）：扩展非连续接收，在该模式下只能在 PTW 时间 窗内监听下行，最长周期能达到 2.91 小时； ⚫ PSM（Power Saving Mode）：节能模式。在此状态下行不可达，不能响应网络寻呼，也不能接 收网络下发的数据。只能通过模块发送上行数据，或者 TAU 定时器超时唤醒，最长周期达到 410 多天。 3.6.3. DRX、eDRX、PSM 是否支持配置？ DRX 周期不支持配置，也不支持功能开启或关闭；eDRX 和 PSM 的周期均可配置，也支持功能开启 和关闭，但网络是否接受配置依赖于运营商设置。如果网络不支持配置 eDRX 和 PSM 的周期，建议咨询运 营商特定 APN 对应的 eDRX、PSM 时长，以期找到一个符合业务模型的节能周期。 3.6.4. 什么是 TAU？ TAU 是终端和运营商核心网之间的状态同步、位置同步的消息，可以理解成 NB-IoT 网络的心跳包。 TAU 一般包括周期性的 TAU 和非周期性的 TAU。当 T3412/T3412ext (extended) 定时器超时就会触 发周期性的 TAU。而触发非周期性的 TAU 的常见原因有：小区发生变化且变化前后小区所属的 TAC 不同、 PLMN 发生变化、开启/关闭 PSM、开启/关闭 eDRX 等。 上海移远通信技术股份有限公司 23 / 44 BC260Y-CN 软件注意事项及 FAQ 3.6.5. 如何通过 AT 命令查看 T3324 和 T3412 的值？ 设置 AT+CEREG=5 时，通过 AT+CEREG?命令可以查询 T3324 和 T3412ext 的值；T3412 的值暂不 支持 AT 命令方式查询。 T3324 T3412ext 如果 T3412ext 值存在，周期性位置更新将使用这个值；如果不存在，将使用 T3412 值。但 T3412 值， 目前无法通过 AT 命令查询。关于 AT+CEREG 查询的结果具体值表示多少，请参考文档 [1]。 3.6.6. 如何查看模块的 PSM 是否开启？ 执行 AT+CPSMS?，若返回的第一个参数 =1，表示开启了 PSM（省电模式）；若 =0， 表示关闭了 PSM。 备注 请注意，开启 PSM 模式并不代表模块可以进入 PSM 模式，还需要查看网络是否开启了 PSM。最终能否 进入该模式仍然取决于模块当前注册的基站是否支持 PSM 模式。 3.6.7. PSM 状态是否可以进行业务？ PSM 状态下，射频功能是关闭的，因此无法收到下行业务数据。但是，若有上行业务，模块会自动开 启射频功能，退出 PSM 状态。因此，在 PSM 状态下，需先发送上行数据才能接收下行业务。 3.6.8. R14 相对于 R13 有哪些提升？ 相对于 R13，R14 网络接入容量和速率有所提升。对于终端来说，支持了 2-HARQ 和更大的传输块 （TBS），因此速率有一定的提升；网络接入容量支持了最多 15 个 non-anchor 载波，且 non-anchor 载波 上支持 RACH 和 paging，对容量有较大的提升。 3.6.9. AT+CSQ 查询的信号值较大，但为什么发送数据总是失败？ AT+CSQ 查询的值为 RSSI（接收信号强度指示），表示一个频率上的总的电平值，其中不仅包含有 用信号，也包含无用的干扰、噪声。因此，信号值大并不代表信号较佳。对于 NB-IoT 模块，CSQ 并不是 关键指标，用户可通过 AT+QENG=0 查询信号质量相关参数。 上海移远通信技术股份有限公司 24 / 44 BC260Y-CN 软件注意事项及 FAQ 3.6.10. 如何判断 NB-IoT 网络的信号质量？ NB-IoT 网络信号质量一般通过 RSRP（参考信号接收功率）和 SNR（信噪比）值来综合判断。 ⚫ 当 RSRP > -100 dBm 且 SNR > 3 dB，业务比较稳定，成功率高。 ⚫ 当 -110 dBm < RSRP < -100 dBm 且 -3 dB < SNR < 3 dB，业务稳定性相对较差，成功率可能 会有影响。 ⚫ 当 RSRP < -115 dBm 或 SNR < -3 dB，业务失败的概率相对较高，影响业务成功率。 3.6.11. 在发起数据业务之前，先查询 IP 地址是否已经获取成功 模块在发起数据业务之前，需通过 AT+CGPADDR?查询 IP 是否已经分配成功，只有当模块获取到本 地 IP 地址后，才可以发起数据业务。 3.6.12. 为什么模块开机后无法注册网络？ 模块开机后无法注册网络，请检查如下方面是否存在异常： ⚫ 执行 AT+CPIN?确认模块是否找到 USIM 卡。 ⚫ 确认 USIM 卡是否欠费。 ⚫ 分别执行 AT+QBAND?和 AT+CFUN?确认模块工作频段和工作模式是否正确。 ⚫ 执行 AT+QENG=0 确认模块射频信号是否正常。 3.6.13. 模块支持哪些网络制式？ BC260Y-CN 模块仅支持 NB-IoT，不支持其他的网络制式。 3.6.14. 如何清除模块的历史频点信息？ 使用 AT+QCSEARFCN 可清除先验频点信息，该命令只能在 AT+CFUN=0 的模式下配置，切换为 AT+CFUN=1 后生效，自动保存至 NVRAM。 3.6.15. 关于时间同步 目前 BC260Y-CN 模块支持两种时间同步的方式：NTP 时间同步和网络下发时间同步。 ⚫ 使用 AT+CCLK 查询当前的日期和时间 ⚫ 使用 AT+QNTP 可用于指定通过 NTP 服务器同步时间并更新到 RTC ⚫ 模块在收到网络下发的 EMM INFORMATION 消息后，会自动同步时间到 RTC 上海移远通信技术股份有限公司 25 / 44 备注 有关 AT+QNTP 的详情，请参考文档 [8]。 BC260Y-CN 软件注意事项及 FAQ 3.6.16. 网络指示灯是否已经开通？ 模块暂不支持网络指示灯功能，后续版本会计划支持，请注意参考文档 [7]。 3.6.17. BC260Y-CN 模块支持 NB-IoT 异频组网吗？ 如何组网由运营商决定，模块端不可配置。BC260Y-CN 模块支持异频重选和同频重选。 3.7. DFOTA 3.7.1. DFOTA 是否支持断电/断点续传？ BC260YCNAAR02A01 及后续版本支持断点续传，但不支持断电续传功能。 3.7.2. DFOTA 是否支持加密？ 模块暂不支持 DFOTA 加密。 3.7.3. DFOTA 是否支持 IPv6 下的升级？ 支持 IPv6 下的升级，但是需要使用对应的支持 IPv6 的 USIM 卡。 3.7.4. 模块是否支持升级外部 MCU？ 支持。可以借助物联网平台（如电信 IoT 或 AEP 平台）的 SOTA 来升级外部 MCU 固件。MCU 通过 发送 PCP 协议（应用层升级协议）数据包来请求平台下发新版本 MCU 软件固件包，当接收到完整的固件 包后，MCU 可自主选择是否更新本地固件。具体参考文档 [9]。 上海移远通信技术股份有限公司 26 / 44 BC260Y-CN 软件注意事项及 FAQ 3.7.5. 对接电信 IoT/AEP 平台进行固件升级时有哪些注意事项？ ⚫ 下载差分包完成，平台会下发升级命令，不需要手动触发。 ⚫ 模块升级成功后，需要上报升级结果。 1) 首先，升级完成并自动重启后，立刻执行 AT+QSCLK=0，避免模块进入深休眠模式（若模块 进入深休眠模式，则无法将结果上报给平台）。 2) 然后，注册至平台后，会自动上报升级结果。 3.8. TCP/UDP 备注 TCP/UDP 相关命令详情，请参考文档 [8]。 3.8.1. AT+QIOPEN 是否能够连接 IPv6 域名类型的服务器？ AT+QIOPEN 支持 IPv6 域名。 3.8.2. AT+QIDNSGIP 是否支持 IPv6 域名方式？ 模块支持 IPv6 域名解析。 3.8.3. 模块是否可以同时作为服务器和客户端？ 不可以，暂不支持模块作为服务器使用。 3.8.4. AT+QISEND 发送数据后，SEND OK 是否标志已经发送到服务器？ SEND OK 仅表示成功发送数据到协议栈。 3.8.5. 关于 AT+QISEND 的 RAI 标记，有何配置建议？ 当服务器端收到数据，不回复下行数据给模块时，建议的 RAI 配置如下： ⚫ 发送 TCP 数据时，=2。 ⚫ 发送 UDP 数据时，=1。 上海移远通信技术股份有限公司 27 / 44 BC260Y-CN 软件注意事项及 FAQ 3.8.6. 模块进入 PSM 后是否能收到下行数据？ 模块进入 PSM 后不能接收下行数据。如果模块在短时间内退出 PSM，此时缓存在核心网的数据会下 发给模块并上报 URC。 3.8.7. 为什么 TCP 会出现 RST？ 出现 TCP 的 RST 可能是因为： ⚫ 服务器没有开启相应端口的监听。 ⚫ 请求超时。 ⚫ 服务器已关闭连接但客户端依然使用该连接进行发送数据。 3.8.8. 为什么 UDP 出现端口不可达？ 如 UDP 出现端口不可达的情况，请排查服务器的相应端口是否开启 UDP 服务。 3.8.9. 模块默认的 DNS 服务器是什么？若 DNS 解析失败该如何处理？ BC260Y-CN 模块的默认 DNS 依据运营商（国内）选取不同的默认 DNS，具体为： ⚫ 中国移动 主 IPv4：114.114.114.114 备 IPv4：8.8.8.8 主 IPv6：240c::6666 备 IPv6：240c::6644 ⚫ 中国电信 主 IPv4：218.2.2.2 备 IPv4：218.4.4.4 主 IPv6：240c::6666 备 IPv6：240c::6644 ⚫ 中国联通 主 IPv4：119.6.6.6 备 IPv4：8.8.8.8 主 IPv6：240c::6666 备 IPv6：240c::6644 上海移远通信技术股份有限公司 28 / 44 BC260Y-CN 软件注意事项及 FAQ 备注 如果使用默认 DNS 域名解析失败，可以通过 AT+QIDNSCFG 配置其他 DNS 解析。 3.8.10. 模块是否支持 SSL/TLS 协议? 暂不支持 SSL/TLS 协议。 3.8.11. 关闭 Socket 链路之后，再次执行 AT+QIOPEN 为什么会失败？ 图 7：AT+QIOPEN 失败现象 如上图所示，关闭 Socket 链路后，再次执行 AT+QIOPEN，若返回+QIOPEN: 0,0，表示成功使用本 地端口号连接到服务器；若返回+QIOPEN: 0,556，表示无法使用本地端口号连接到服务器。 根据 TCP/IP 协议，在关闭 Socket 链路后将进入 TIME_WAIT 状态，并且在 120 秒等待时间内不允许 绑定相同的本地端口号，这将导致无法使用相同的本地端口号连接到服务器。 ⚫ 解决方法： 执行 AT+QIOPEN 命令时，将 配置为 0，例如： AT+QIOPEN=0,0,'TCP','220.180.239.212',8040,0,1 上海移远通信技术股份有限公司 29 / 44 BC260Y-CN 软件注意事项及 FAQ 图 8：AT+QIOPEN 失败解决方法 3.9. 电信物联网平台 备注 中国电信物联网平台相关命令详情，请参考文档 [9]。 3.9.1. 什么是电信 IoT/AEP 平台？ 电信 IoT 平台的全称是中国电信物联网开放平台-连接管理子系统，与华为 OceanConnect 平台兼容。 使 用 时 需 注 意 平 台 的 版 本 是 否 相 同 。 有 关 中 国 电 信 IoT 平 台 的 详 细 信 息 ， 请 访 问 官 方 地 址 ： https://www.ct10649.com/。 电信 AEP 平台官方名称为 CTWing 中国电信物联网开放平台。有关中国电信 AEP 平台的详细信息， 请访问地址 https://www.ctwing.cn/。 3.9.2. AT+NCDPOPEN 命令返回+QLWEVTIND: 1，可能的原因是什么？ 一般情况下，如果模块在短时间内返回错误，会上报+QLWEVTIND: 1，可能的原因如下： 1. 对接电信 AEP 平台时，没有配置 Lifetime。 2. 没有在平台完成创建设备步骤。 3. 平台注册超时等。 上海移远通信技术股份有限公司 30 / 44 BC260Y-CN 软件注意事项及 FAQ 3.9.3. 生命周期（Lifetime）机制的作用是什么？ 对于电信 IoT 平台来说，若在 25 小时内未与模块进行数据交互将显示异常，49 小时内未与模块进行 数据交互将显示离线，当模块发送上行数据或者更新注册包后将恢复正常。因此，电信 IoT 平台并不关注 生命周期这个参数。 对于 AEP 平台来说，如果在每一次生命周期到期前没有更新注册包，平台将自动断开与模块的连接， 模块与平台间的数据交互将无法进行。 3.9.4. 模块是否支持手动更新 Lifetime？如何关闭 Lifetime 的自动更新？ 模块不支持手动更新 Lifetime，默认的 Lifetime 是 0。 如果对接电信 IoT 或华为 OceanConnect 平台，可不配置 AT+NCFG=0,；如果对接电信 AEP 平台，则必须要配置 AT+NCFG=0,，AEP 平台要求不能配置为 0，否则无法连接至 AEP 平台。 备注 用户可通过配置 AT+NCFG=0,0 关闭自动更新。 3.9.5. IoT 平台的立即下发与缓存下发有何区别？ ⚫ 立即下发： 1. 如果模块处于 DRX 状态，模块可以立即接收到平台下发的数据。 2. 如果模块处于 eDRX 状态，数据会在核心网缓存一段时间（具体时间需咨询运营商），核心 网网元寻呼到设备后，会将数据发送给设备。 3. 如果模块处于 PSM 状态，模块大概率收不到数据，除非在核心网缓存时间内有发送上行数据。 ⚫ 缓存下发： 当命令为缓存下发时，平台将收到的下发命令缓存，等设备上报数据时，按顺序将缓存的命令全 部下发。前一个命令送达设备或超时后，开始下发后一个缓存命令。 3.9.6. 模块对接 IoT/AEP 平台是否支持实时收发数据？ 模块对接 IoT/AEP 平台支持实时收发数据，但是模块需要一直处于 DRX 状态。 3.9.7. 对接 IoT/AEP 平台，模块发送的数据包长度最大为多少？ 对接 IoT/AEP 平台时，仅支持发送十六进制字符串格式数据，数据包长度不超过 1024 字节。 上海移远通信技术股份有限公司 31 / 44 BC260Y-CN 软件注意事项及 FAQ 3.9.8. 模块从深休眠唤醒是否可以立即发送数据？ 模块从深休眠唤醒立即发送数据可能会造成数据发送失败。模块从深休眠唤醒后需要一段时间进行恢 复，恢复成功会上报+QLWEVTIND: 6，恢复失败会上报+QLWEVTIND: 7，因此需等待恢复成功结果码上 报再做业务。 备注 上报+QLWEVTIND: 6 仅代表模块内部恢复成功，和网络并没有交互，此时不会退出 PSM 模式。 3.9.9. 模块是否支持 BS（Bootstrap）和加密？ 模块不支持 BS 功能，但可以支持 DTLS 的 PSK 加密方式。 3.9.10. 模块是否支持 CoAP 协议？ 模块不支持纯 CoAP 协议。客户使用 CoAP 协议自行组包、解析数据包，较为繁琐，因此为减少客户 的开发成本，针对终端客户使用模块对接物联网云平台（电信 IoT/AEP 平台、移动 OneNET 平台等）的需 求，BC260Y-CN 模块支持一套基于 CoAP 协议简化的 AT 命令。相关 AT 命令详情，请参考文档 [9]。 3.10. 中国移动 OneNET 备注 中国移动 OneNET 平台相关命令详情，请参考文档 [10]。 3.10.1. 如何查询模块支持的 OneNET SDK 版本？ 模块支持的 SDK 版本为 V2.3.0，也可以通过命令 AT+MIPLVER?进行查询。 3.10.2. 模块是否支持 BS 和加密？ 对接 OneNET 平台时，模块支持 BS，但不支持 DTLS 加密。 上海移远通信技术股份有限公司 32 / 44 BC260Y-CN 软件注意事项及 FAQ 3.10.3. 模块注册到 OneNET 平台并进入深休眠模式后是否支持自行恢复？ 支持自行恢复。模块成功注册到 OneNET 平台后进入深休眠，会自动保存相关状态和参数，被唤醒后 模块从 NVRAM 读取相关状态和参数并恢复注册。此时，MCU 无需进行 OneNET 重新连接，可以直接发 送上行数据到平台。 3.10.4. 模块从深休眠模式唤醒后上报+MIPLEVENT: 0,4 有什么含义？ +MIPLEVENT: 0,4 表示模块内部已经恢复连接，建议从深休眠模式唤醒后等待此 URC 上报后再发送 数据。 备注 模块从深休眠模式唤醒后，只是进行本地数据的自恢复，并不会和网络进行交互。 3.10.5. 执行 AT+MIPLOPEN 注册平台何种情况下会返回+MIPLEVENT: 0,3？ ⚫ 平台上未创建设备时，执行 AT+MIPLOPEN 后会在 5 秒内上报 URC +MIPLEVENT: 0,3。 ⚫ 网络信号较差，但是数据仍能发送时，只是收到平台回复的 ACK，超过了 Bootstrap 的超时时间 （20 秒），此时大约 30 秒上报+MIPLEVENT: 0,3。 ⚫ 网络信号非常差，数据无法发送，此时会一直重传，总耗时大约 128 秒，之后才会上报+MIPLEVENT: 0,3。 3.10.6. 删除了对象（Object），为何平台上还是能看到资源列表？ 删除了对象（Object）之后，需要执行 AT+MIPLUPDATE=0,,1 更新对象列表。 3.10.7. 连接 OneNET 平台后，是否需要经常发送心跳包维持连接？ 模块连接 OneNET 平台后，只要模块在生命周期内就不需要经常发送心跳包维持连接，并且模块支持 自动更新生命周期。 3.10.8. 注册成功后为什么没有下发订阅和发送资源请求？ 可能是由于平台上的自动订阅和自动发现资源开关没有开启。 3.10.9. 对接 OneNET 平台时，是否可以关闭生命周期的自动更新？ 模块不支持关闭自动更新生命周期。 上海移远通信技术股份有限公司 33 / 44 BC260Y-CN 软件注意事项及 FAQ 3.10.10. 对接 OneNET 平台时，执行 AT+MIPLOPEN 失败怎么办？ 注意在执行 AT+MIPLOPEN 后，如果由于网络或者相关配置问题出现 Bootstrap 失败（+MIPLEVENT: 0,3）或者注册失败（+MIPLEVENT: 0,7），模块会重新进行 Bootstrap 和注册，如果连续三次尝试均失败， 模块便放弃此次注册请求动作。此时，需要检查网络和相关配置，确认无问题后，重新执行 AT+MIPLOPEN。 3.10.11. 对接 OneNET 平台时，是否支持实时收发数据？ 模块侧支持，但是普通的移动物联网卡不支持，网络侧最多保活 2 分钟。建议每分钟上报一次数 据，或者联系运营商开通 GRE 专用 APN。 由于普通的 APN 存在 2 分钟左右端口老化的问题，所以无法实现实时控制。故引入 GRE 专用 APN， 以延迟端口老化的时间。 3.10.12. 执行 AT+MIPLCREATE 创建通信实例之前，需要做何配置？ 在执行 AT+MIPLCREATE 创建通信实例之前，需要通过 AT+MIPLCONFIG 配置 IP/域名和端口 3.10.13. 为什么响应平台下发的发现资源请求和订阅请求会失败？ 如果出现响应平台下发的发现资源请求和订阅请求失败，可能是因为没有及时响应，平台端认为已超 时，建议终端在 10 秒内进行响应。 3.11. 低功耗管理与休眠模式 3.11.1. 如何进入浅休眠模式？ 如果模块使能了浅休眠功能（即 AT+QSCLK=2），当系统中所有正在运行的任务都处于挂起状态时， 模块 AP 侧会进入空闲状态（Idle 状态），此时模块处于浅休眠模式。浅休眠模式下，模块将切到 32 kHz 慢时钟运行，外部设备将无法正常工作，串口可以响应 AT 命令。 3.11.2. 如何进入深休眠模式？ 如果模块使能了深休眠功能（即 AT+QSCLK=1），当所有正在运行的任务处于挂起状态，模块将自动 进入深休眠。 当模块处于深休眠状态时，为最大程度降低模块功耗，会关闭相关外设，串口不再响应 AT 命令， CPU 停止运行，此时模块状态接近于关机状态，仅 RTC 继续运行。 上海移远通信技术股份有限公司 34 / 44 BC260Y-CN 软件注意事项及 FAQ 3.11.3. 如何退出浅休眠模式？ 若模块处于浅休眠状态，通过主串口发送 AT 命令将模块唤醒到唤醒（Active）模式。 3.11.4. 如何退出深休眠模式？ BC260Y-CN 标准模块退出深休眠模式的方式有如下四种： ⚫ PSM_EINT 外部中断引脚唤醒。PSM_EINT 只能使 AP 侧退出空闲（Idle）状态，需要主动上行 一包数据才能使 Modem 侧退出 PSM。 ⚫ TAU 唤醒。TAU 唤醒时，既可以使 AP 侧退出空闲（Idle）状态，也可以使 Modem 退出 PSM。 ⚫ 串口 AT 唤醒。 ⚫ PSM 功能关闭且 eDRX 周期大于 327.68 秒进入的深休眠模式（参考第 3.11.8 章），会在下一个 PTW 周期到来时唤醒模块。 3.11.5. 为什么模块发送的 AT 命令会丢失？ 深休眠模式下，模块类似于关机状态， RTC 可以正常运行，除 AT 口外其他外设均无法正常工作。模 块在深休眠状态下，发送的第一个 AT 命令将丢失，不会生效，仅用于唤醒模块。 3.11.6. AT+QSCLK 命令配置是否保存？ AT+QSCLK 命令掉电不保存，重启后恢复默认值。 3.11.7. 模块 PSM_EINT 一直拉低是否无法进入深休眠模式？ BC260Y-CN 模块通过 PSM_EINT 下降沿将模块从深休眠模式唤醒。当 PSM_EINT 引脚一直维持低电 平，模块将无法进入深休眠模式。 3.11.8. 为什么关闭了 PSM，模块还会进入了深休眠模式？ BC260Y-CN 模块进深休眠模式的场景中，有一种场景是使能了深休眠模式并关闭了 PSM 后，如果 eDRX 周期大于 327.68 秒，模块仍然会进深休眠模式。遇到关闭 PSM 仍然会进深休眠模式的情况，请首 先检查 eDRX 的设置周期。 3.11.9. 上报 ENTER PSM 的 URC 之后，为何依然无法进深休眠模式？ 执行 AT+QSCLK?检查是否禁止了深休眠模式的功能，若查询结果不为 1，设置 AT+QSCLK=1 即可。 上海移远通信技术股份有限公司 35 / 44 BC260Y-CN 软件注意事项及 FAQ 3.11.10. 深休眠模式唤醒后，模块为何仍然无法接收到平台下发的数据？ 深休眠模式唤醒的方式中，PSM_EINT 唤醒的只是模块的 AP 侧，Modem 侧仍然处于 PSM 状态，PSM 状态下模块无法接收平台下发的数据，需要模块主动上发一组数据以退出 PSM 态。 3.11.11. 关闭了 PSM 和深休眠模式的情况，模块是否收不到平台下发的数据？ 检查是否设置了 eDRX 模式，以及设置 eDRX 模式的情况下其周期是否设置过大，如果 eDRX 周期过 大可能会导致接收平台数据延迟，整个 eDRX 周期中只有在 PTW 周期内才能接收平台数据。 3.11.12. T3324 时间设置为 0，模块是否可以直接从 Active 态切换为 PSM 态？ 可以。但是模块 Modem 侧没有执行数据业务时，会有一个释放 RRC 连接的过程，这个过程一般是 20 秒，RRC 连接释放之后模块才能进入 DRX 状态。如果 T3324 时间设置为 0，RRC 连接释放之后没有 DRX 或 eDRX 的过程，直接进入 PSM 模式，但释放 RRC 连接的过程仍然存在。 3.11.13. 如何快速释放 RRC 连接？ 部分协议（如 LwM2M 和 OneNET）在发送数据的时候，会有一个 RAI 标记，该 RAI 标记用于指示核 心网释放与模块的 RRC 连接，具体操作请参考文档 [9] 和文档 [10] 中的详细说明。 3.11.14. 深休眠状态下模块自动唤醒，可能的唤醒源有哪些？ ⚫ TAU 唤醒，即 T3412 唤醒，该时间可以配置，但最终是由网络下发的。 ⚫ 生命周期到期前自动唤醒，当前对接电信 IoT/AEP 平台和 OneNET 平台都支持设置生命周期自动 更新，具体 AT 命令请参考文档 [9] 和文档 [10]。 3.11.15. 影响模块进入深休眠模式的因素 ⚫ 通过 AT+QSCLK=0 禁用了休眠模式，或通过 AT+QSCLK=2 设置了仅允许进入浅休眠模式； ⚫ PSM_EINT 一直处于拉低状态； ⚫ AP 侧有任务在处理，如 AT 交互；默认每次发送 AT 命令后，模块会被锁住 10 秒无法进入深睡眠； 3.11.16. 模块可以进入深休眠模式的场景 ⚫ AT+CFUN=0； ⚫ 底层上报无网（OOS）； ⚫ PSM 功能关闭且 eDRX 周期大于 327.68 秒。 上海移远通信技术股份有限公司 36 / 44 BC260Y-CN 软件注意事项及 FAQ 3.11.17. BC260Y-CN 模块进入 PSM 之后为什么 AT 命令不通？ 如果 BC260Y-CN 模块仅进入 PSM，而没有进入深休眠模式，这时是可以通 AT 命令的；如果模块进 入了深休眠模式，此时发送的第一条 AT 命令只能唤醒模块（AT 命令会丢失），第二条 AT 命令将正常与 模块交互。建议在进行 AT 业务前先发送 AT 命令以确认唤醒模块，收到 OK 后再进行业务 AT 操作。 3.11.18. 为什么模块已经进入 PSM 状态，但是功耗降低依然不明显？ 功耗与整个系统的状态有关；Modem 进入 PSM 后只是无法接收到平台端发过来的数据，如果此时 AP 处于 Active 态，模块功耗不会有明显降低。当模块进入深休眠模式，系统功耗才能降到很低。 3.11.19. 是否有 BC260Y-CN 模块在各种工作模式下的耗流数据？ 有。具体请参见文档 [7] 中的耗流章节说明。 3.11.20. PSM_EINT 需要拉低多久方可将模块从深休眠模式唤醒？ 模块检测到下降沿即可从深休眠唤醒模块。 3.11.21. 除 PSM_EINT 引脚触发方式外，还有其他方式将模块从深休眠模式唤醒吗？ 深休眠模式下，MCU 发送任意 AT 命令到模块，可以让模块退出深休眠模式，但第一条 AT 会丢失。 3.11.22. 按 RESET 复位后，测试的 VDD_EXT 波形为方波形式是否正常？ 正常。在 RESET 拉低过程中会出现方波，直至 RESET 被松开。 3.11.23. 开机或者唤醒时 VDD_EXT 存在方波形式么？ 不会。VDD_EXT 只在复位过程为方波形式。 3.11.24. 在深休眠模式下，模块的各个引脚状态如何？是否会造成外部 MCU 漏电？ 在深休眠模式下，模块的 VDD_EXT 会被关闭，各引脚的状态分为四类（请参阅附录 A）： ⚫ 电源、地引脚； ⚫ BOOT、RESET、PSM_EINT：电压域为 VBAT，按照推荐 OC 电路设计做好电平匹配则不会造 成漏电； ⚫ 其他 I/O 口：电压域为 VDD_EXT，均处于悬空状态，阻抗为 10 MΩ 以上，故不会造成漏电； ⚫ USB 引脚：电压域为外部供电的 VUSB_3V3，处于悬空状态。 上海移远通信技术股份有限公司 37 / 44 BC260Y-CN 软件注意事项及 FAQ 4 附录 A 深休眠模式下模块引脚状态 表 2：深睡眠模式下 BC260Y-CN 模块的引脚状态 引脚号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 引脚名称 GND RESERVED RESERVED RESERVED RESERVED RESERVED BOOT RESERVED ADC0 GND USIM_DATA USIM_RST USIM_CLK USIM_VDD RESET NETLIGHT RXD TXD PSM_EINT 深休眠模式下模块引脚状态（悬空/ 高阻态/ 上拉/ 下拉） GND 悬空 悬空 悬空 悬空 悬空 上拉 悬空 悬空 GND 悬空 悬空 悬空 / 上拉 悬空 悬空 悬空 上拉 上海移远通信技术股份有限公司 38 / 44 20 RI 21 RESERVED 22 RESERVED 23 RESERVED 24 VDD_EXT 25 RESERVED 26 RESERVED 27 GND 28 RESERVED 29 RESERVED 30 RESERVED 31 RESERVED 32 RESERVED 33 RESERVED 34 GND 35 RF_ANT 36 GND 37 GND 38 DBG_RXD 39 DBG_TXD 40 GND 41 GND 42 VBAT 43 VBAT 44 RESERVED 45 GND 上海移远通信技术股份有限公司 悬空 悬空 悬空 悬空 / 悬空 悬空 GND 悬空 悬空 悬空 悬空 悬空 悬空 GND / GND GND 悬空 悬空 GND GND VBAT VBAT 悬空 GND BC260Y-CN 软件注意事项及 FAQ 39 / 44 46 GND 55 GND 56 GND 57 GND 58 GND GND GND GND GND GND BC260Y-CN 软件注意事项及 FAQ 上海移远通信技术股份有限公司 40 / 44 BC260Y-CN 软件注意事项及 FAQ 5 附录 B 参考文档及术语缩写 表 3：参考文档 序号 文档名称 备注 [1] Quectel_BC260Y-CN_AT 命令手册 [2] Quectel_BC260Y-CN&BC2x&M26_兼容设计手册 [3] Quectel_BC260Y-CN_Log 抓取指导 BC260Y-CN AT 命令手册 BC260Y-CN&BC2x&M26 模块兼容设计手 册 BC260Y-CN Log 抓取指导 [4] Quectel_BC260Y-CN 搜网机制说明 BC260Y-CN 搜网机制说明 [5] Quectel_BC260Y-CN_DFOTA_应用指导 BC260Y-CN DFOTA 应用指导 [6] Quectel_BC260Y-CN_NB-IoT_模块产品规格书 BC260Y-CN 模块产品规格书 [7] Quectel_BC260Y-CN_硬件设计手册 BC260Y-CN 硬件设计手册 [8] Quectel_BC260Y-CN_TCP(IP)_应用指导 BC260Y-CN TCP(IP) 应用指导 [9] Quectel_BC260Y-CN_中国电信物联网平台应用指导 BC260Y-CN 对接电信 IOT 平台/AEP 平台 应用指导 [10] Quectel_BC260Y-CN_OneNET_应用指导 BC260Y-CN OneNET 应用指导 [11] 中国电信物联网开放平台_软件升级协议 中国电信物联网开放平台软件升级协议 表 4：术语缩写 缩写 ACK APN APP AP 英文全称 Acknowledgement Access Point Name Application Application Processor 上海移远通信技术股份有限公司 中文全称 确认符 接入点名称 应用程序 应用处理器 41 / 44 BS CoAP CPU DRX DNS DFOTA DTLS eDRX ESD eNB FAQ FOTA GRE GSM GNSS HARQ HTTP ICCID IMSI IMEI IP IPv4 IPv6 IoT LwM2M MCU BC260Y-CN 软件注意事项及 FAQ Bootstrap Constrained Application Protocol Central Processing Unit Discontinuous Reception Domain Name System Delta Firmware Upgrade Over-The-Air Datagram Transport Layer Security Extended Discontinuous Reception Electro-Static Discharge Evolved Node B Frequently Asked Questions Firmware Over The Air Generic Routing Encapsulation Global System for Mobile Communication Global Navigation Satellite System Hybrid Automatic Repeat reQuest HyperText Transfer Protocol Integrate Circuit Card Identity International Mobile Subscriber Identity International Mobile Equipment Identity Internet Protocol Internet Protocol Version 4 Internet Protocol Version 6 Internet of Things Lightweight Machine to Machine Micro Control Unit 引导模式 受限的应用层协议 中央处理器 非连续接收 域名系统 差分式固件空中升级 数据包传输层安全性协议 扩展非连续接收 静电释放 演进型 Node B 常见问题 空中固件升级 通用路由封装 全球移动通信系统 全球导航卫星系统 混合自动重传请求 超文本传输协议 集成电路卡识别码 国际移动用户识别码 国际移动设备识别码 网际互连协议 网际协议版本 4 网际协议版本 6 物联网 轻量化的 M2M 物联网协议 微型控制单元 上海移远通信技术股份有限公司 42 / 44 MME NB-IoT NTP NVRAM OTA OOS OC PC PCP PDP PDN PLMN PRB PSM RACH RTOS PTW RSSI RSRP RRC RTC RAI RST PS PSM SDK Mobility Management Entity Narrow Band Internet of Things Network Time Protocol Non-volatile Random-Access Memory Over-the-Air Technology Out of Service Open Collector Personal Computer Private Communication Protocol Packet Data Protocol Public Data Network Public Land Mobile Network Physical Resource Block Power Saving Mode Random Access Channel Real-Time Operating System Paging Time Window Received Signal Strength Indicator Reference Signal Receiving Power Radio Resource Control Real-Time Clock Release Assistance Indication Reset Packet Switch Power Saving Mode Software Development Kit BC260Y-CN 软件注意事项及 FAQ 移动管理实体 窄带物联网 网络时间协议 非易失性随机存储器 空中下载技术 停止服务 开集 个人计算机 私人通信协议 分组数据协议 公用数据网 公共陆地移动网络 物理资源模块 省电模式 随机接入信道 实时操作系统 寻呼时间窗口 接收信号的强度指示 参考信号接收功率 无线资源控制 实时时钟 释放辅助指示 重置 分组交换 省电模式 软件开发工具包 上海移远通信技术股份有限公司 43 / 44 SIM SNR SSL SGW SN TCP TAU TAC TBS TLS TTL TVS UART USB URC UDP USIM BC260Y-CN 软件注意事项及 FAQ Subscriber Identification Module 用户识别卡 Signal to Noise Ratio 信噪比 Secure Sockets Layer 安全套接字协议 Serving Gateway 服务网关 Serial Number 序号 Transmission Control Protocol 传输控制协议 Tracking Area Update 跟踪区更新 Tracking Area Code 跟踪区编码 Transport Block Size 传输块大小 Transport Layer Security 传输层安全性协议 Transistor-Transistor Logic 逻辑门电路 Transient Voltage Suppression 瞬态二极管 Universal Asynchronous Receiver-Transmitter 通用异步收发传输器 Universal Serial Bus 通用串行总线 Unsolicited Result Code 非请求结果码 User Datagram Protocol 用户数据报协议 Universal Subscriber Identity Module 全球用户识别卡 上海移远通信技术股份有限公司 44 / 44

BC260Y-CN 固件升级用户指导 NB-IoT 模块系列 版本：1.0 日期：2020-10-27 状态：受控文件 www.quectel.com BC260Y-CN 固件升级用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 24 BC260Y-CN 固件升级用户指导 文档历史 修订记录 版本 1.0 日期 2020-09-21 2020-10-27 作者 吴致文 吴致文 变更表述 文档创建 初始版本 上海移远通信技术股份有限公司 2 / 24 BC260Y-CN 固件升级用户指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 前期准备 ................................................................................................................................................ 7 2.1. TE-B 开发板 ............................................................................................................................... 7 2.2. QFlash 工具................................................................................................................................ 8 3 固件升级 .............................................................................................................................................. 10 3.1. 连接与设置 ................................................................................................................................11 3.1.1. 连接 TE-B .......................................................................................................................11 3.1.2. 设置端口与波特率 ......................................................................................................... 12 3.1.2.1. 设置 COM 端口 ..................................................................................................... 12 3.1.2.2. 设置波特率............................................................................................................ 13 3.2. 加载固件包文件 ........................................................................................................................ 14 3.3. 升级固件 ................................................................................................................................... 16 4 常见升级失败原因 ............................................................................................................................... 19 4.1. 串口选择错误............................................................................................................................ 19 4.2. 波特率选择错误 ........................................................................................................................ 20 4.3. 固件包文件无效 ........................................................................................................................ 21 4.4. 电源异常 ................................................................................................................................... 22 4.5. USB 数据线连接异常................................................................................................................ 23 5 附录 参考文档及术语缩写 .................................................................................................................. 24 上海移远通信技术股份有限公司 3 / 24 BC260Y-CN 固件升级用户指导 表格索引 表 1：TE-B 关键组件介绍 ............................................................................................................................ 8 表 2：参考文档 ........................................................................................................................................... 24 表 3：术语缩写 ........................................................................................................................................... 24 上海移远通信技术股份有限公司 4 / 24 BC260Y-CN 固件升级用户指导 图片索引 图 1：BC260Y-CN-TE-B .............................................................................................................................. 7 图 2：QFlash 主界面 .................................................................................................................................... 8 图 3：关于 QFlash 工具 ............................................................................................................................... 9 图 4：查看设备串口对应编号 ......................................................................................................................11 图 5：选择主串口 ....................................................................................................................................... 12 图 6：选择波特率 ....................................................................................................................................... 13 图 7：点击'Load FW Files'按钮 ................................................................................................................. 14 图 8：选择待下载的文件 ............................................................................................................................ 15 图 9：单击'Start'按钮................................................................................................................................. 16 图 10：固件自动升级过程中....................................................................................................................... 17 图 11：固件升级成功.................................................................................................................................. 18 图 12：串口选择错误.................................................................................................................................. 19 图 13：波特率选择错误 .............................................................................................................................. 20 图 14：加载的固件包文件无效 ................................................................................................................... 21 图 15：电源异常 ......................................................................................................................................... 22 图 16：USB 数据线连接异常...................................................................................................................... 23 上海移远通信技术股份有限公司 5 / 24 BC260Y-CN 固件升级用户指导 1 引言 本文档主要介绍如何通过 QFlash 工具升级移远通信 BC260Y-CN 模块的固件版本包。 备注 本文档所提及的模块，若无特殊说明，均指代 BC260Y-CN 模块。 上海移远通信技术股份有限公司 6 / 24 BC260Y-CN 固件升级用户指导 2 前期准备 升级 BC260Y-CN 模块中的固件版本包，需准备以下工具和驱动： ⚫ 开发板：BC260Y-CN-TE-B 开发板。 ⚫ 下载工具：移远通信 QFlash 工具（4.18 及其以上版本）。 ⚫ USB 转串口驱动：由电脑自行通过驱动识别工具自动安装。 备注 有关固件版本包和 QFlash 工具等相关资料，请联系移远通信技术支持 support@quectel.com 获取。 2.1. TE-B 开发板 本章节介绍了 BC260Y-CN-TE-B 开发板，实物图及组件功能介绍如下： 图 1：BC260Y-CN-TE-B 上海移远通信技术股份有限公司 7 / 24 下表描述了 BC260Y-CN-TE-B 的部分组件功能。 BC260Y-CN 固件升级用户指导 表 1：TE-B 关键组件介绍 序号 1 2 3 4 组件名称 RESET 按钮 BOOT 按钮 串口开关 Mini USB 端口 描述 用于重启模块。 用于控制模块进入下载模式。 用于切换模块主串口通信对象：主串口-USB（MAIN UART TO USB） 或主串口-MCU（MAIN UART TO MCU）。 通过 UART 转 USB 芯片，将 UART 口转成 4 路端口：0 路用于 AT 命令，1 路用于抓取 Log，其它 2 路预留。 使用 BC260Y-CN-TE-B-进行固件升级时，请确保串口开关（上图中序号 3）已经切换至 MAIN UART TO USB。关于 BC260Y-CN TE-B 的详细信息，请参考《Quectel_BC260Y-CN-TE-B_用户指导》。 2.2. QFlash 工具 QFlash 是移远通信开发的模块固件版本包升级工具。该工具无需安装，可直接在装有 Windows 7/ 8/ 10 系统的 PC 上运行。 QFlash 工具的主界面如下图所示。 上海移远通信技术股份有限公司 图 2：QFlash 主界面 8 / 24 BC260Y-CN 固件升级用户指导 点击工具栏中'Help'下的'About This Tool'可查看 QFlash 工具版本相关信息，如图所示。 图 3：关于 QFlash 工具 备注 1. 在 Windows 10 中，请右键单击 QFlash 图标并选择'以管理员身份运行'，打开 QFlash.exe。 2. QFlash 工具的存储路径不应包含空格、中文字符以及其他特殊字符，推荐使用全英文路径。 上海移远通信技术股份有限公司 9 / 24 BC260Y-CN 固件升级用户指导 3 固件升级 使用 QFlash 工具升级 BC260Y-CN 模块固件，具体步骤如下： 步骤 1：设置串行端口和波特率。 步骤 2：加载固件文件。 步骤 3：升级固件。 以下章节将通过示例详细介绍如何使用 QFlash 工具升级固件。 备注 本文档操作示例，均在 Windows10 系统下操作完成。 上海移远通信技术股份有限公司 10 / 24 BC260Y-CN 固件升级用户指导 3.1. 连接与设置 3.1.1. 连接 TE-B 通过 TE-B 上的 Mini USB 口将模块与 PC 连接。完成连接后，PC 会自动安装驱动。 打开设备管理器，可查看当前设备的主串口编号，以便在 QFlash 工具串口中选择对应的串口编号。主 串口用于固件升级，如下图所示。 主串口 图 4：查看设备串口对应编号 备注 默认情况下，第一个 COM 口为主串口。非默认情况下，可依次向 4 路 COM 口分别发送任意 AT 命令， 如'AT'，有正常响应的，即为主串口。 上海移远通信技术股份有限公司 11 / 24 BC260Y-CN 固件升级用户指导 3.1.2. 设置端口与波特率 3.1.2.1. 设置 COM 端口 打开 QFlash 工具，在'COM Port'下拉菜单中选择主串口对应的编号，如下图所示。 图 5：选择主串口 上海移远通信技术股份有限公司 12 / 24 BC260Y-CN 固件升级用户指导 3.1.2.2. 设置波特率 点击'Baudrate'下拉列表，选择波特率'921600'，如下图所示。 图 6：选择波特率 备注 1. 升级 BC260Y-CN 模块时，波特率请务必选择 921600，其他波特率可能会导致升级失败。 2. COM 端口和波特率设置的顺序不分前后。 上海移远通信技术股份有限公司 13 / 24 3.2. 加载固件包文件 本节介绍如何加载 BC260Y-CN 模块的固件包文件。 1. 点击'Load FW Files'按钮，如图所示。 BC260Y-CN 固件升级用户指导 图 7：点击'Load FW Files'按钮 上海移远通信技术股份有限公司 14 / 24 BC260Y-CN 固件升级用户指导 2. 选择需要下载到模块的 BootLoader_BC260YCNxxxxxxxx.bin 的固件文件，如下图所示。 图 8：选择待下载的文件 备注 固件文件的存储路径不应包含空格、中文字符以及其他特殊字符。此类字符可能导致无法识别固件文件或 固件文件加载无效。推荐使用全英文路径。 上海移远通信技术股份有限公司 15 / 24 BC260Y-CN 固件升级用户指导 3.3. 升级固件 以上步骤完成后，可通过如下步骤使用 QFlash 工具完成固件升级。 1. 点击'Start'按钮，如下图所示。 图 9：单击'Start'按钮 上海移远通信技术股份有限公司 16 / 24 BC260Y-CN 固件升级用户指导 2. 点击'Start'后 15 秒内，需先长按 TE-B 上的 BOOT 按钮不松开，再按 RESET 按钮重启模块， 最后释放 BOOT 按钮。此时，模块将进入下载模式，自动升级固件。 图 10：固件自动升级过程中 备注 若模块未进入下载模式，请重新尝试第 3.3 章步骤 1 和 2。 上海移远通信技术股份有限公司 17 / 24 BC260Y-CN 固件升级用户指导 3. 固件升级成功后，界面进度条下将显示'PASS'，如下图所示。 图 11：固件升级成功 备注 升级成功后，需重启模块方可生效。 上海移远通信技术股份有限公司 18 / 24 BC260Y-CN 固件升级用户指导 4 常见升级失败原因 若固件升级失败，一般来说，可能有波特率错误、串口错误、文件无效等原因。如下章节将介绍一些 常见的下载失败案例。 4.1. 串口选择错误 固件升级时，若串行端口选择错误，QFlash 界面将出现如下提示： 上海移远通信技术股份有限公司 图 12：串口选择错误 19 / 24 BC260Y-CN 固件升级用户指导 备注 若串口选择正确，模块仍未成功进入下载模式或串口被占用等情况下，错误消息提示语与上图相同。请先 确定已选择主串口并且主串口未被占用，再排查其他原因。若仍未解决问题，请联系移远技术支持。 4.2. 波特率选择错误 固件升级时，若 QFlash 界面出现如下提示，说明波特率选择错误。请参考第 3.1.3 章选择正确的波特 率。 图 13：波特率选择错误 上海移远通信技术股份有限公司 20 / 24 BC260Y-CN 固件升级用户指导 4.3. 固件包文件无效 在选择待升级的文件时，若 QFlash 界面出现如下提示，说明选择了错误或无效的固件包文件。请参考 第 3.2 章选择合适的固件包文件。 图 14：加载的固件包文件无效 上海移远通信技术股份有限公司 21 / 24 BC260Y-CN 固件升级用户指导 4.4. 电源异常 固件升级时，若 QFlash 界面出现如下提示，说明模块端发生异常断电。 图 15：电源异常 备注 若升级过程中发生异常断电，需按照上述步骤进行重新进行升级。 上海移远通信技术股份有限公司 22 / 24 BC260Y-CN 固件升级用户指导 4.5. USB 数据线连接异常 固件升级时，若 QFlash 界面出现如下提示，说明出现 USB 数据线连接异常。请在升级过程中，确保 USB 数据线连接正常。 图 16：USB 数据线连接异常 上海移远通信技术股份有限公司 23 / 24 BC260Y-CN 固件升级用户指导 5 附录 参考文档及术语缩写 表 2：参考文档 序号 [1] 文档名称 Quectel_BC260Y-CN-TE-B_用户指导 表 3：术语缩写 术语 COM port LPT MCU PC UART USB 英文全称 Communication port Line Print Terminal Microcontroller Unit Personal Computer Universal Asynchronous Receiver/Transmitter Universal Serial Bus 备注 BC260Y-CN-TE-B 用户指导 中文全称 通信口 打印终端 微型控制单元 个人电脑 通用异步收发传输器 通用串行总线 上海移远通信技术股份有限公司 24 / 24

BC260Y-CN TCP/IP 应用指导 NB-IoT 模块系列 版本：1.1 日期：2021-04-13 状态：受控文件 BC260Y-CN TCP/IP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 34 BC260Y-CN TCP/IP 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-09-16 2021-04-13 作者 变更表述 Taber JIANG Randy LI/ Albert ZHANG 初始版本 1. 增加 AT+QISEND 以数据模式发送数据，支持定长和 不定长发送数据（第 2.3.5 章）。 2. 增加 AT+QPING 命令参数，支持 ping 包 业务的快速释放（第 2.3.8 章）； 上海移远通信技术股份有限公司 2 / 34 BC260Y-CN TCP/IP 应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................ 3 表格索引 ..................................................................................................................................................... 5 1 引言 ..................................................................................................................................................... 6 2 TCP/IP AT 命令详解 ........................................................................................................................... 7 2.1. AT 命令语句.............................................................................................................................. 7 2.1.1. 定义 ............................................................................................................................... 7 2.1.2. AT 命令语句................................................................................................................... 7 2.2. AT 示例声明.............................................................................................................................. 8 2.3. AT 命令详解.............................................................................................................................. 8 2.3.1. AT+QICFG 配置可选参数............................................................................................ 8 2.3.2. AT+QIOPEN 打开 Socket............................................................................................ 9 2.3.3. AT+QICLOSE 关闭 Socket........................................................................................ 10 2.3.4. AT+QISTATE 查询 Socket 状态 ................................................................................ 11 2.3.5. AT+QISEND 发送十六进制/文本字符串数据 ............................................................. 13 2.3.6. AT+QIDNSGIP 转换域名为 IP 地址........................................................................... 15 2.3.7. AT+QIDNSCFG 配置 DNS 服务器地址 ..................................................................... 16 2.3.8. AT+QPING 远程服务器 Ping 操作 ............................................................................. 17 2.3.9. AT+QNTP 通过 NTP 服务器同步本地时间 ................................................................ 18 2.4. URC 详解................................................................................................................................ 20 2.4.1. 连接断开 URC.............................................................................................................. 20 2.4.2. 下行数据已达 URC....................................................................................................... 20 3 结果码 ............................................................................................................................................... 21 4 举例 ................................................................................................................................................... 23 4.1. 初始化工作 ............................................................................................................................. 23 4.2. TCP 客户端使用说明 .............................................................................................................. 23 4.2.1. 建立 TCP 连接 ............................................................................................................. 23 4.2.2. 配置发送的数据格式为文本字符串 ............................................................................... 24 4.2.3. 配置发送的数据格式为十六进制格式 ........................................................................... 24 4.2.4. 发送文本数据 ............................................................................................................... 24 4.2.5. 发送十六进制数据 ........................................................................................................ 25 4.2.6. ACK 响应检查 .............................................................................................................. 25 4.2.7. 配置接收的数据格式为文本字符串 ............................................................................... 25 4.2.8. 配置接收的数据格式为十六进制格式 ........................................................................... 25 4.2.9. 关闭 TCP 连接 ............................................................................................................. 26 4.2.10. TCP 长连接的会话保活说明......................................................................................... 26 4.3. UDP 客户端使用说明.............................................................................................................. 27 4.3.1. 建立 UDP 连接 ............................................................................................................. 27 4.3.2. 配置发送的数据格式为文本字符串 ............................................................................... 27 上海移远通信技术股份有限公司 3 / 34 BC260Y-CN TCP/IP 应用指导 4.3.3. 配置发送的数据格式为十六进制格式 ........................................................................... 28 4.3.4. 发送文本数据 ............................................................................................................... 28 4.3.5. 发送十六进制数据 ........................................................................................................ 28 4.3.6. 配置接收的数据格式为文本字符串 ............................................................................... 29 4.3.7. 配置接收的数据格式为十六进制格式 ........................................................................... 29 4.3.8. 关闭 UDP 连接 ............................................................................................................. 29 4.3.9. UDP 连接的深休眠唤醒数据收发 ................................................................................. 30 4.4. 转换域名为 IP 地址 ................................................................................................................. 31 4.5. 配置 DNS 服务器地址 ............................................................................................................. 31 4.6. 远程服务器 Ping 操作 ............................................................................................................. 31 4.7. 通过 NTP 服务器同步本地时间 ............................................................................................... 31 5 附录 A 参考文档及术语缩写 ............................................................................................................. 33 上海移远通信技术股份有限公司 4 / 34 BC260Y-CN TCP/IP 应用指导 表格索引 表 1：AT 命令及响应类型.......................................................................................................................... 7 表 2：结果码列表 .................................................................................................................................... 21 表 3：参考文档........................................................................................................................................ 33 表 4：术语缩写........................................................................................................................................ 33 上海移远通信技术股份有限公司 5 / 34 BC260Y-CN TCP/IP 应用指导 1 引言 移远通信 BC260Y-CN 模块内置 TCP/IP 协议栈，使终端设备可以直接通过 AT 命令访问网络。因此， 在很大程度上降低了终端设备对 PPP 协议和 TCP/IP 协议栈的依赖性，从而降低成本。 BC260Y-CN 模块可提供 TCP 客户端、UDP 客户端等 Socket（套接字）服务。 上海移远通信技术股份有限公司 6 / 34 BC260Y-CN TCP/IP 应用指导 2 TCP/IP AT 命令详解 本章节主要描述和 TCP/IP 相关的 AT 命令。通过 TCP/IP AT 命令，可以配置相关参数、打开/关闭 Socket，并通过 Socket 接收和发送数据。 2.1. AT 命令语句 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 34 BC260Y-CN TCP/IP 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QICFG 配置可选参数 该命令可为 TCP/IP 各项功能配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应 +QICFG: 'dataformat',(支持的列表), (支持的列表) 设置命令 AT+QICFG='dataformat'[,,] OK 响应 若省略可选参数，则查询当前配置： +QICFG: 'dataformat',, OK 若指定可选参数，设置发送数据格式和接收数据格式： OK 最大响应时间 特性说明 若有任何错误： ERROR 5秒 该命令立即生效。 深休眠唤醒后仍有效；自动保存至 NVRAM。 参数 整型。发送数据的格式。 0 文本字符串格式 1 十六进制格式 整型。接收数据的格式。 上海移远通信技术股份有限公司 8 / 34 0 文本字符串格式 1 十六进制格式 BC260Y-CN TCP/IP 应用指导 2.3.2. AT+QIOPEN 打开 Socket 该命令用于打开 Socket 以创建 TCP/UDP 连接，可通过参数指定服务类型，并通过参 数指定数据访问模式。命令执行成功以后，模块会上报 URC +QIOPEN: , 通知是否成功打开 Socket。 AT+QIOPEN 打开 Socket 测试命令 AT+QIOPEN=? 响应 +QIOPEN: (支持的范围),(支持的 范围),'TCP/UDP',,,,(支 持的列表) 设置命令 AT+QIOPEN=,,,,[,[, ]] OK 响应 OK +QIOPEN: , 若有任何错误： ERROR 最大响应时间 5秒 特性说明 该命令立即生效。 参数配置在 UDP 下深休眠唤醒后有效；在 TCP 下深休眠唤醒 后无效。不保存至 NVRAM。 参数 整型。上下文 ID。范围：0~11。目前仅支持=0。 0 自动适配当前默认的 PDP 上下文 1~11 指定特定的 PDP 上下文 整型。Socket ID。范围：0~4。 字符串型。Socket 服务类型。 'TCP' 客户端创建 TCP 连接 'UDP' 客户端创建 UDP 连接 字符串型。远程服务器地址，格式为带双引号（' '）的域名或者 IP 地址。最大 长度：150 字节。 整型。远程服务器的端口号。范围：1~65535。 整型。本地端口号。 0 自动分配本地端口号 上海移远通信技术股份有限公司 9 / 34 BC260Y-CN TCP/IP 应用指导 1~65535 指定的本地端口号，建议配置 5 位以上的端口且不使用特殊协议默认 的端口 整型。Socket 的数据访问模式。 1 直吐模式 整型。结果码，详情请参考第 3 章。 备注 1. 模块开机后，请参考文档 [1] 检查是否成功入网后再执行 AT+QIOPEN 命令。 2. URC +QIOPEN: ,上报的超时时间为 60 秒，请在 URC 上报完成后再进行其他 操作。 3. 如果 TCP/UDP 连接创建失败，需执行 AT+QICLOSE 关闭当前 Socket，然后再次尝试打开 Socket 以创建 TCP/UDP 连接。 4. 如果使用指定了本地端口号，当执行 AT+QICLOSE 命令后，本地端口号需要释放，才 能确保下一次正常使用本地端口号。因此，建议在关闭 Socket 后等待 70 秒再重新执行 AT+QIOPEN 命令。如果在回收端口之前使用 AT+QIOPEN 创建新连接，则会导致连接创建失败。 5. Socket 的数据访问模式目前仅支持直吐模式，暂不支持缓存模式。 6. UDP 会话创建后，模块可正常进入深休眠模式，并且唤醒后 UDP 配置信息不会丢失，MCU 可以在 唤醒恢复完成后直接收发数据。在 TCP 模式下，当模块从深休眠状态唤醒时无法保存 TCP 连接，需 通过 AT+QIOPEN 重新开启 Socket。 2.3.3. AT+QICLOSE 关闭 Socket 该命令用于关闭指定的 Socket。 AT+QICLOSE 关闭 Socket 测试命令 AT+QICLOSE=? 响应 +QICLOSE: (支持的范围) 设置命令 AT+QICLOSE= OK 响应 若成功关闭： OK CLOSE OK 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 上海移远通信技术股份有限公司 10 / 34 参数 整型。Socket ID。范围：0~4。 BC260Y-CN TCP/IP 应用指导 2.3.4. AT+QISTATE 查询 Socket 状态 该命令用于查询 Socket 状态。 AT+QISTATE 查询 Socket 状态 测试命令 AT+QISTATE=? 响应 +QISTATE: (支持的范围),(支持的范围) 查询命令 AT+QISTATE? OK 响应 返回所有现存连接的状态： [+QISTATE: ,,,,,,,] […] OK 若有任何错误： ERROR 设置命令 响应 若=0，查询指定上下文的 返回指定上下文里所有现存连接的状态： 连接状态 [+QISTATE: ,,,<remot AT+QISTATE=,,,,, s_mode>] […] OK 若有任何错误： 设置命令 ERROR 响应 若=1，查询指定 Socket 返回指定 Socket 的连接状态： 的连接状态 [+QISTATE: ,,,<remot AT+QISTATE=,,,,, s_mode>] OK 上海移远通信技术股份有限公司 11 / 34 BC260Y-CN TCP/IP 应用指导 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。查询类型。 0 查询指定的连接状态 1 查询指定的连接状态 整型。上下文 ID。范围：0~11。目前仅支持=0。 0 自动适配当前默认的 PDP 上下文 1~11 用于指定特定的 PDP 上下文 整型。Socket ID。范围：0~4。 字符串型。Socket 服务类型。 'TCP' 客户端创建 TCP 连接 'UDP' 客户端创建 UDP 连接 字符串型。远程服务器地址，格式为带双引号（' '）的域名或者 IP 地址。最大 长度：150 字节。 整型。远程服务器的端口号。范围：1~65535。 整型。分配的本地端口号。 0 自动分配本地端口号 1~65535 指定的本地端口号，建议配置 5 位以上的端口且不使用特殊协议默认 的端口 整型。Socket 状态。 0 'Initial'（初始状态） 1 'Connecting'（正在连接） 2 'Connected'（已连接） 3 'Closing'（正在关闭） 4 'Remote Closing'（正在远程关闭） 整型。Socket 的数据访问模式。 1 直吐模式 备注 1. 若响应中无 +QISTATE: 列表，则说明当前未建立 TCP/UDP 连接，请使用 AT+QIOPEN 建立 TCP/UDP 连接。 2. Socket 的数据访问模式目前仅支持直吐模式，暂不支持缓存模式。 上海移远通信技术股份有限公司 12 / 34 BC260Y-CN TCP/IP 应用指导 2.3.5. AT+QISEND 发送十六进制/文本字符串数据 该命令用于通过指定连接发送十六进制或文本字符串格式的 Socket 数据。 AT+QISEND 发送十六进制/文本字符串数据 测试命令 AT+QISEND=? 响应 +QISEND: (支持的范围),(支持的范围),, 设置命令 命令模式发送数据 AT+QISEND=,,[,] OK 响应 若连接建立成功并且数据成功发送到协议栈： OK SEND OK 若命令执行成功但数据发送失败： OK SEND FAIL 设置命令 数据模式下发送不定长数据 AT+QISEND= 若有任何错误： ERROR 响应 > 响应 > 后，模块进入数据模式，输入数据并键入 Ctrl + Z 发送 数据；当输入的数据长度达到最大长度（1024 字节）时将自动 发送数据；或键入 Esc 取消发送。 若连接建立成功并且数据成功发送到协议栈： OK SEND OK 若命令执行成功但数据发送失败： OK SEND FAIL 设置命令 数据模式下发送定长数据 AT+QISEND=, 响应 > 后，模块进入数据模式，之后可输入长度等于 上海移远通信技术股份有限公司 13 / 34 BC260Y-CN TCP/IP 应用指导 gth> 的待发数据。 若连接建立成功并且数据成功发送到协议栈： OK SEND OK 若命令执行成功但数据发送失败： OK SEND FAIL 若有任何错误： 设置命令 ERROR 响应 查询已发送、已应答，以及已发送但未应 +QISEND: ,, 答数据的总长度 AT+QISEND=,0 OK 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。Socket ID；范围：0~4。 整型。待发数据长度。范围：0~1024；单位：字节。文本格式数据的最大长度 1024 字 节，十六进制格式数据的最大长度是 512 字节。 字符串型。待发送的十六进制或文本格式数据（数据格式由 AT+QICFG 配置）。 整型。消息传输携带的快速释放标记 RAI，该标记用于指示核心网如何释放与模块的 RRC 连接。范围：0~2。 0 无标记，不使用释放辅助指示 1 该包数据上行后不期望有进一步的上行或下行数据，核心网可立即释放连接 2 该包数据上行后期望有对应的单个下行数据包回复，核心网在回复后立即释放连接 整型。通过会话已发送数据的总长度。单位：字节。 整型。远程服务器已应答数据的总长度。仅 TCP 会话时有效。单位：字节。 整型。已发送但是还未被远程服务器应答的数据总长度。仅 TCP 会话时有效。单位： 字节。 上海移远通信技术股份有限公司 14 / 34 BC260Y-CN TCP/IP 应用指导 备注 1. SEND OK 仅表示数据已经发送至协议栈。 2. 参数的值和的长度必须一致。即：发送文本字符串数据时， 的值等于的实际长度；发送十六进制格式数据时，的值等于实际长度 的二分之一。 3. MCU 应在收到 SEND OK 或者 SEND FAIL 响应后再继续发送下一条数据。 4. 为特殊格式（如 JSON 格式）字符时，必须为带双引号的字符串。 2.3.6. AT+QIDNSGIP 转换域名为 IP 地址 该命令用于将指定域名转换为 IP 地址。 AT+QIDNSGIP 转换域名为 IP 地址 测试命令 AT+QIDNSGIP=? 响应 +QIDNSGIP: (支持的范围), 设置命令 AT+QIDNSGIP=, OK 响应 OK +QIDNSGIP: [,,] [+QIDNSGIP: ] […] 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。上下文 ID。范围：0~11。目前仅支持=0。 0 自动适配当前默认的 PDP 上下文 1~11 用于指定特定的 PDP 上下文 字符串型。域名。最大长度：150 字节。 整型。参数对应的 IP 地址个数。 整型。DNS 的 TTL 值。当前固定为 0。 字符串型。对应的 IP 地址。 整型。结果码，详情请参考第 3 章。 上海移远通信技术股份有限公司 15 / 34 备注 当前仅支持 DNS 服务器返回的首个 IP 地址。 BC260Y-CN TCP/IP 应用指导 2.3.7. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置主要和次要 DNS 服务器地址。 AT+QIDNSCFG 配置 DNS 服务器地址 测试命令 AT+QIDNSCFG=? 响应 +QIDNSCFG: (支持的范围),, 设置命令 配置主要和次要 DNS 服务器地址 AT+QIDNSCFG=,[,] 设置命令 DNS 服务器地址成功配置后，查询主要 和次要 DNS 服务器地址 AT+QIDNSCFG= OK 响应 OK 若有任何错误： ERROR 响应 [+QIDNSCFG: ,,,,] OK 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。上下文 ID。范围：0~11。目前仅支持=0。 0 自动适配当前默认的 PDP 上下文 1~11 用于指定特定的 PDP 上下文 字符串型。主要 DNS 服务器的 IP 地址。最大长度：64 字节。 字符串型。次要 DNS 服务器的 IP 地址。最大长度：64 字节。 字符串型。IP 格式的 IPv4 主要 DNS 服务器地址。 字符串型。IP 格式的 IPv4 次要 DNS 服务器地址。 字符串型。IP 格式的 IPv6 主要 DNS 服务器地址。 字符串型。IP 格式的 IPv6 次要 DNS 服务器地址。 上海移远通信技术股份有限公司 16 / 34 BC260Y-CN TCP/IP 应用指导 备注 1. 网络类型取决于模块端和网络侧的各自的配置。若网络仅支持 IPv4，则只能设置 IPv4 DNS 地址；若 网络仅支持 IPv6，则只能设置 IPv6 DNS 地址。 2. 模块开机后，需等 IP 地址 URC（例如：+IP: 10.18.237.42，表明模块注网成功）上报完成后方可执 行设置命令。 3. 执行 AT+QIDNSCFG=命令可以查询模块默认的 DNS 服务器地址或者网络下发的 DNS 服务器地址。 2.3.8. AT+QPING 远程服务器 Ping 操作 该命令用于测试主机设备的 IP 地址是否可达。 AT+QPING 远程服务器 Ping 操作 测试命令 AT+QPING=? 响应 +QPING: (支持的范围),,(支持的范围),(支持的列表),(支持的 列表),(支持的列表) 设置命令 AT+QPING=,[,[,[,[,]]]] OK 响应 若远程服务器 Ping 成功： OK +QPING: [,,,,] […] +QPING: [,,,,,,] 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。上下文 ID。范围：0~11。目前仅支持=0。 0 自动适配当前默认的 PDP 上下文 1~11 用于指定特定的 PDP 上下文 字符串型。远程服务器地址，格式为带双引号（' '）的域名或者 IP 地址。最大长度：150 上海移远通信技术股份有限公司 17 / 34 BC260Y-CN TCP/IP 应用指导 字节。 整型。每次 Ping 请求后等待响应的最大时长。范围：1~255；默认值：4；单位：秒。 整型。发送 Ping 请求最大次数。范围：1~10；默认值：4。 整型。每次 Ping 请求的大小。范围：32~1500；默认值：32；单位：字节。 整型。是否使能 RAI 标识。 0 无 RAI 标识 1 使能 RAI 标识（在 ping 的最后一包携带 RAI flag 2） 整型。结果码。每次 Ping 请求的结果。 0 其他 接收到远程服务器的 Ping 响应 错误码；请参考第 3 章 获取详细结果码信息 字符串型。远程服务器的 IP 地址。 整型。每次发送的 Ping 请求长度。单位：字节。 整型。发送 Ping 请求花费的时间。单位：毫秒。 整型。Ping 请求的 TTL 值。 整型。结果码。Ping 操作的最终结果。 0 其他 Ping 成功 错误码；请参考第 3 章 获取详细结果码信息 整型。Ping 请求发送的字节总长度。 整型。Ping 响应中接收到的字节总长度。 整型。Ping 请求中丢失的字节总长度。 整型。最小响应时间。单位：毫秒。 整型。最大响应时间。单位：毫秒。 整型。平均响应时间。单位：毫秒。 备注 相对于 BC260YCNAAR01A02 及之前的版本， BC260YCNAAR01A03 做出如下优化： 1) AT+QPING 响应中增加 TTL 值； 2) AT+QPING 的参数的最大值由 200 字节扩展到 1500 字节。 2.3.9. AT+QNTP 通过 NTP 服务器同步本地时间 该命令通过 NTP 服务器同步本地时间为世界标准时间（UTC）。 AT+QNTP 通过 NTP 服务器同步本地时间 测试命令 AT+QNTP=? 响应 +QNTP: (支持的范围),,,(支持的 列表) OK 设置命令 响应 AT+QNTP=,[,[,]] 最大响应时间 特性说明 BC260Y-CN TCP/IP 应用指导 OK +QNTP: , 若同步失败： OK +QNTP: 若有任何错误： ERROR 5秒 / 参数 整型。上下文 ID。范围：0~11。目前仅支持=0。 0 自动适配当前默认的 PDP 上下文 1~11 用于指定特定的 PDP 上下文 字符串型。NTP 服务器地址，格式为带双引号（' '）的域名或者点分十进制 IP 地址。 最大长度：150 字节。 整型。NTP 服务器端口号。范围：1~65535；默认值：123。 整型。是否自动同步本地时间为 UTC。 0 不自动同步 1 自动同步 字符串型。从 NTP 服务器上同步的时间。格式为：'YY/MM/DD,hh:mm:ss±zz'，各字 符分别表示年（YY）、月（MM）、日（DD）、时（hh）、分（mm）、秒（ss）和 时区（±zz）。 整型。结果码，详情请参考第 3 章。 备注 1. 当=1，RTC 会自动更新到同步时间；随后可使用 AT+CCLK?查询更新后的时间。 关于 AT+CCLK?更多信息，请参考文档 [2]。 2. 注网成功后，模块会自动更新 RTC 时间。 上海移远通信技术股份有限公司 19 / 34 BC260Y-CN TCP/IP 应用指导 2.4. URC 详解 TCP/IP 相关 URC 统一以+QIURC: […]的格式上报。本文中 URC 前后 的均将省略。 备注 1. 当模块在 PSM 模式下，不会上报 URC。 2. 当模块 Modem 在 DRX 或者 eDRX 模式下，URC 上报会有延迟，延迟时间依据寻呼周期而定。 3. 当模块 Modem 在连接状态下，会正常上报 URC。 4. 下行数据最大支持 1024 字节，超过 1024 字节会被分成多条 URC 上报。 2.4.1. 连接断开 URC 当 TCP Socket 被远程关闭或者因为网络异常而断开时，模块将上报 URC +QIURC: 'closed',。 连接断开 URC +QIURC: 'closed', Socket 连接被断开 参数 整型。Socket ID。范围：0~4。 2.4.2. 下行数据已达 URC 下行数据已达 URC +QIURC: 'recv',,, 参数 整型。Socket ID；范围：0~4。 整型。实际接收到的数据长度。单位：字节。 接收到的数据。数据格式为十六进制或文本格式。 上海移远通信技术股份有限公司 20 / 34 BC260Y-CN TCP/IP 应用指导 3 结果码 表 2：结果码列表 结果码 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 结果码描述 Operation successful Unknown error Operation blocked Invalid parameters Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy DNS parse failed Socket connection failed Socket has been closed 上海移远通信技术股份有限公司 含义 操作成功 未知原因 操作受阻 无效参数 内存不足 创建 Socket 失败 操作不支持 Socket 绑定失败 Socket 监听失败 Socket 写入失败 Socket 读取失败 Socket 接受失败 打开 PDP 上下文失败 关闭 PDP 上下文失败 Socket ID 被占用 DNS 繁忙 NDS 解析失败 Socket 连接失败 Socket 已被关闭 21 / 34 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel send 572 Operation not allowed 573 APN not configured 574 Port busy BC260Y-CN TCP/IP 应用指导 操作繁忙 操作超时 PDP 上下文发生故障 取消发送 操作不允许 未配置 APN 端口繁忙 上海移远通信技术股份有限公司 22 / 34 BC260Y-CN TCP/IP 应用指导 4 举例 4.1. 初始化工作 AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 //禁用休眠模式。 //查询网络注册状态。 //注网已成功，若未成功，可多次查询。 OK AT+CGPADDR? //找网成功后，可通过此命令获取模块 IP 地址。 +CGPADDR: 5,'10.177.135.245' OK 备注 1. 需要使用 AT+QSCLK=0 禁用休眠模式；所有业务完成后，请使用 AT+QSCLK=1 启用深休眠模式， 以便模块进入深休眠。关于 AT+QSCLK 命令的详细信息，请参考文档 [2]。 2. 块开机后，请参考文档 [1] 检查是否成功入网后再执行 AT+QIOPEN 命令。 4.2. TCP 客户端使用说明 4.2.1. 建立 TCP 连接 AT+QIOPEN=0,0,'TCP','hf.quectel.com',2020 OK +QIOPEN: 0,0 //更多连接信息可通过如下方式进行查询。 AT+QISTATE=1,0 上海移远通信技术股份有限公司 //远程地址：hf.quectel.com，端口：2020； 本地端口为自动分配。 //建立连接成功。 //查询连接状态。 23 / 34 BC260Y-CN TCP/IP 应用指导 +QISTATE: 0,'TCP','hf.quectel.com',2020,0,2,0,1 OK //连接成功。 4.2.2. 配置发送的数据格式为文本字符串 AT+QICFG='dataformat',0,0 //配置发送的数据格式为文本字符串（=0）。 //此为默认配置（文本字符串）。 OK //配置完成后，会立即生效并自动保存至 NVRAM，无须重复配置。 AT+QICFG='dataformat' +QICFG: 'dataformat',0,0 //查询配置是否成功。 //查询结果：发送的数据格式为文本字符串（=0）。 OK 4.2.3. 配置发送的数据格式为十六进制格式 AT+QICFG='dataformat',1,0 //配置发送的数据格式为十六进制格式（=1）。 OK //配置完成后，会立即生效并自动保存至 NVRAM，无须重复配置。 AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 //查询配置是否成功。 //查询结果：发送的数据格式为十六进制格式（=1）。 OK 4.2.4. 发送文本数据 AT+QISEND=0,10,'1234567890' OK //发送 10 字节数据 1234567890（注意命令中参数 需要和实际长度保持一致）。 SEND OK AT+QISEND=0,17,'{'a':'b','b':'b'}'//发送 17 字节数据{'a':'b','b':'b'}（注意命令中参 数需要和实际长度保持一致）。 //发送 JSON 格式等特殊字符数据时，必须使用双引号将数据包围。 OK SEND OK 上海移远通信技术股份有限公司 24 / 34 BC260Y-CN TCP/IP 应用指导 4.2.5. 发送十六进制数据 AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 //查询当前配置。 //查询结果：发送的数据格式为十六进制格式（=1）。 OK AT+QISEND=0,3,'313233' OK //发送十六进制字符串数据（模块自动将十六进制数据 313233 转换为 文本数据 123 并发送到服务端）。 //注意需要满足十六进制格式，否则转换会失败返回 ERROR。 //注意命令中应该等于长度除以 2。 SEND OK 4.2.6. ACK 响应检查 AT+QISEND=0,0 +QISEND: 94,94,0 OK //=0（查询已发送、已收到 ACK 响应以及未收到 ACK 响应的数据长度）。 //链路建立连接到断开连接过程中累计发送了 94 字节，94 个均收到 了 ACK 响应，0 个未响应（连接断开后数据会重置为 0）。 4.2.7. 配置接收的数据格式为文本字符串 AT+QICFG='dataformat',0,0 //配置接收的数据格式为文本字符串（=0）。 //此为默认配置（文本字符串）。 OK //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置。 AT+QICFG='dataformat' +QICFG: 'dataformat',0,0 //查询配置是否成功。 //查询结果：接收的数据格式为文本字符串（=0）。 OK //远程服务器向模块发送了'hi, quectel'消息。 +QIURC: 'recv',0,10,'hi,quectel' //提示模块已收到远程服务器下发的数据。 4.2.8. 配置接收的数据格式为十六进制格式 AT+QICFG='dataformat',0,1 //配置接收的数据格式为十六进制格式（=1）。 OK //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置。 上海移远通信技术股份有限公司 25 / 34 BC260Y-CN TCP/IP 应用指导 AT+QICFG='dataformat' +QICFG: 'dataformat',0,1 //查询配置是否成功。 //查询结果：接收的数据格式为十六进制格式（=1）。 OK //远程服务器向模块发送了'1234567890'消息。 +QIURC: 'recv',0,10,'31323334353637383930' //提示模块已收到远程服务器下发的数据。 4.2.9. 关闭 TCP 连接 AT+QICLOSE=0 OK CLOSE OK AT+QSCLK=1 OK //主动断开。 //断开连接成功。 //启用深休眠模式。 备注 1. 考虑网络异常等因素，建议关闭连接前，先进行发送数据的 ACK 响应检查，检查无异后再关闭连接. 如果存在，关闭后重新建立连接重发未收到对端 ACK 的数据。 2. 完成业务后，请使用 AT+QSCLK=1 启用休眠模式，以便模块进入深休眠。 4.2.10. TCP 长连接的会话保活说明 一般 TCP 连接建立后，如果一段时间内无数据交互，网络侧可能会主动释放维持连接的必要资源，并 且所述释放行为不会通知模块。关于所述无数据交互导致资源释放的时间长短，暂无明确的数值。目前的 测试情况是，10 分钟内基本可保持端口资源不会被释放。若需保持长连接，建议每隔一定时间（10 分钟以 内）就向服务器发送一个短数据包，以进行会话保活。 基于此，如果长时间不发送数据，在重新发数据时可通过如下方法进行会话校验： AT+QISEND=0,3,'ACK' OK //先发一个短包（发送的数据可以根据需求自由定制）。 SEND OK AT+QISEND=0,0 +QISEND: 3,0,3 //查询已发送数据是否收到 ACK 响应。 //发送的心跳字节，均未得到服务器的响应。 OK 上海移远通信技术股份有限公司 26 / 34 BC260Y-CN TCP/IP 应用指导 //等待 30 秒后。 +QIURC: 'closed',0 //收到提示连接已断开的 URC，此时会话已经被关闭，需要重连。 //如果一直未收到提示连接已断开的 URC，需要等待 60 秒后。 AT+QISEND=0,0 +QISEND: 3,0,3 //查询已发送数据是否收到 ACK 响应。 //发送的心跳字节，均未得到服务器的响应。 OK //如果此时仍未收到服务器响应，需要主动关闭连接并重连。 AT+QICLOSE=0 OK CLOSE OK //主动断开。 //断开连接成功。 4.3. UDP 客户端使用说明 4.3.1. 建立 UDP 连接 AT+QIOPEN=0,0,'UDP','hf.quectel.com',2020 OK +QIOPEN: 0,0 //远程地址：hf.quectel.com，端口：2020； 本地端口为自动分配。 //建立连接成功。 //更多连接信息可通过如下方式进行查询。 AT+QISTATE=1,0 +QISTATE: 0,'UDP','hf.quectel.com',2020,0,2,0,1 //查询连接状态。 //连接成功。 OK 4.3.2. 配置发送的数据格式为文本字符串 AT+QICFG='dataformat',0,0 //配置发送的数据格式为文本字符串（=0）。 //此为默认配置（文本字符串）。 OK //配置完成后，会立即生效并自动保存至 NVRAM，无须重复配置。 AT+QICFG='dataformat' //查询配置是否成功。 上海移远通信技术股份有限公司 27 / 34 BC260Y-CN TCP/IP 应用指导 +QICFG: 'dataformat',0,0 //查询结果：发送的数据格式为文本字符串（=0）。 OK 4.3.3. 配置发送的数据格式为十六进制格式 AT+QICFG='dataformat',1,0 //配置发送的数据格式为十六进制格式（=1）。 OK //配置完成后，会立即生效并自动保存至 NVRAM，无须重复配置。 AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 //查询配置是否成功。 //查询结果：发送的数据格式为十六进制格式（=1）。 OK 4.3.4. 发送文本数据 AT+QISEND=0,10,'1234567890' OK //发送 10 字节数据 1234567890。 //注意命令中参数需要和实际长度保持一致。 SEND OK AT+QISEND=0,17,'{'a':'b','b':'b'}'//发送 17 字节数据{'a':'b','b':'b'}。 //注意命令中参数需要和实际长度保持一致。 //发送 JSON 格式等特殊字符数据时，必须使用双引号将数据包围。 OK SEND OK 4.3.5. 发送十六进制数据 AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 OK AT+QISEND=0,3,'313233' OK //查询当前配置。 //查询结果：发送的数据格式为十六进制格式（ =1）。 //发送十六进制字符串数据（模块自动将十六进制数据 313233 转换为 文本数据 123 并发送到服务端）。 //注意需要满足十六进制格式，否则转换会失败返回 ERROR。 //注意命令中应该等于长度的二分之一。 上海移远通信技术股份有限公司 28 / 34 SEND OK BC260Y-CN TCP/IP 应用指导 4.3.6. 配置接收的数据格式为文本字符串 AT+QICFG='dataformat',0,0 //配置接收的数据格式为文本字符串（=0） //此为默认配置（文本字符串）。 OK //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置。 AT+QICFG='dataformat' +QICFG: 'dataformat',0,0 //查询配置是否成功。 //查询结果：接收的数据格式为文本字符串（=0）。 OK //远程服务器向模块发送了'hi, quectel'消息。 +QIURC: 'recv',0,10,'hi,quectel' //提示模块已收到远程服务器下发的数据。 4.3.7. 配置接收的数据格式为十六进制格式 AT+QICFG='dataformat',0,1 //配置接收的数据格式为十六进制格式（=1） OK //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置。 AT+QICFG='dataformat' +QICFG: 'dataformat',0,1 //查询配置是否成功。 //查询结果：接收的数据格式为十六进制格式（=1）。 OK //远程服务器向模块发送了'1234567890'消息。 +QIURC: 'recv',0,10,'31323334353637383930' //提示模块已收到远程服务器下发的数据。 4.3.8. 关闭 UDP 连接 AT+QICLOSE=0 OK CLOSE OK AT+QSCLK=1 OK //主动断开。 //断开连接成功。 //启用深休眠模式。 备注 完成业务后，请使用 AT+QSCLK=1 启用休眠模式，以便模块进入深休眠。 上海移远通信技术股份有限公司 29 / 34 BC260Y-CN TCP/IP 应用指导 4.3.9. UDP 连接的深休眠唤醒数据收发 AT+QSCLK=0 OK //开始业务前关闭模块深休眠功能。 AT+QIOPEN=0,0,'UDP','hf.quectel.com',2020 OK //远程地址：hf.quectel.com，端口：2020； 本地端口为自动分配。 +QIOPEN: 0,0 //建立连接成功。 //更多连接信息可通过如下方式进行查询。 AT+QISTATE=1,0 //查询连接状态。 +QISTATE: 0,'UDP','hf.quectel.com',2020,0,2,0,1 //连接成功。 OK AT+QISEND=0,10,'1234567890' OK //发送 10 字节数据 1234567890。 //注意命令中参数需要和实际长度保持一致。 SEND OK AT+QSCLK=1 OK //业务完成后，需要时开启深休眠功能，等待模块进入深休眠。 //模块进入深休眠。 +QNBIOTEVENT: 'ENTER DEEPSLEEP' //通过下拉 PSM_EINT 引脚或向模块发送一条 AT 命令（此 AT 命令将会丢失）唤醒模块。 +QNBIOTEVENT: 'EXIT DEEPSLEEP' //模块从深休眠中被唤醒。 AT+QSCLK=0 OK //做业务前关闭模块深休眠功能，业务完成后需要模块深休眠时再开 启。 //模块会恢复 UDP 相关参数及状态，此时模块状态与进入深休眠前一致，可直接发送和接收 UDP 数据。 AT+QISEND=0,10,'1234567890' //发送 10 字节数据 1234567890。 //注意命令中参数需要和实际长度保持一致。 OK SEND OK 上海移远通信技术股份有限公司 30 / 34 BC260Y-CN TCP/IP 应用指导 4.4. 转换域名为 IP 地址 AT+QDNSGIP=0,'baidu.com' OK //获取域名为 baidu.com 的 IP 地址。 +QIDNSGIP: 0,1,0 +QIDNSGIP: 39.156.69.79 4.5. 配置 DNS 服务器地址 AT+QIDNSCFG=0,'218.2.2.2','8.8.8.8' OK AT+QIDNSCFG=0 +QIDNSCFG: 0,'218.2.2.2','8.8.8.8','240E:5A::6666','240E:5B::6666' OK 4.6. 远程服务器 Ping 操作 AT+QPING=0,'iot.quectel.com' OK +QPING: 0,47.100.63.174,32,369 +QPING: 0,47.100.63.174,32,479 +QPING: 0,47.100.63.174,32,484 +QPING: 0,47.100.63.174,32,260 +QPING: 0,4,4,0,260,484,398 4.7. 通过 NTP 服务器同步本地时间 AT+QNTP=0,'ntp5.aliyun.com' OK //使用域名为 ntp5.aliyun.com 的 NTP 服务器同步本地时间。 上海移远通信技术股份有限公司 31 / 34 +QNTP: 0,'19/06/11,11:08:20:35+32' BC260Y-CN TCP/IP 应用指导 上海移远通信技术股份有限公司 32 / 34 BC260Y-CN TCP/IP 应用指导 5 附录 A 参考文档及术语缩写 表 3：参考文档 序号 文档名称 [1] Quectel_BC260Y-CN_终端应用设计指导 [2] Quectel_BC260Y-CN_AT 命令手册 备注 BC260Y-CN 终端应用设计指导 BC260Y-CN AT 命令手册 表 4：术语缩写 术语 英文全称 ACK DNS DRX eDRX ID IP IPv4 IPv6 NVRAM MCU ME NB-IoT NTP PPP Acknowledge character Domain Name System Discontinuous Reception extended Discontinuous Reception Identifier Internet Protocol Internet Protocol version 4 Internet Protocol version 6 Non-Volatile Random Access Memory Micro Controller Unit Mobile Equipment Narrow Band Internet of Things Network Time Protocol Point to Point Protocol 中文全称 确认字符 域名系统 非连续接收 扩展不连续接收 标识符 互联网协议 互联网协议版本 4 互联网协议版本 6 非易失性随机访问存储器 微控制器 移动设备 窄带物联网 网络时间协议 点对点协议 上海移远通信技术股份有限公司 33 / 34 PSM TCP TTL UDP URC UTC Power Saving Mode Transmission Control Protocol Time to Live User Datagram Protocol Unsolicited Result Code Universal Time Coordinated BC260Y-CN TCP/IP 应用指导 省电模式 传输控制协议 生存时间 用户数据报协议 非请求结果码 世界标准时间 上海移远通信技术股份有限公司 34 / 34

BC260Y-CN OneNET 应用指导 NB-IoT 模块系列 版本：1.1 日期：2021-04-22 状态：受控文件 BC260Y-CN OneNET 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 57 BC260Y-CN OneNET 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-08-10 2021-04-22 作者 变更表述 Koala LI/ Taber JIANG/ Albert ZHANG/ Jack QIAN Albert ZHANG/ Jack QIAN 初始版本 1. 增加 AT+MIPLCONFIG 的参数，用来设置 是否使能设备在生命周期即将到期时，自动更新生命周期； 2. 增加中国移动 OneNET 平台 DFOTA 说明章节。 上海移远通信技术股份有限公司 2 / 57 BC260Y-CN OneNET 应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................3 表格索引 ..................................................................................................................................................... 5 1 引言.....................................................................................................................................................6 2 OneNET 数据交互机制........................................................................................................................7 3 OneNET 相关 AT 命令 ........................................................................................................................8 3.1. AT 命令说明..............................................................................................................................9 3.1.1. 定义 ...............................................................................................................................9 3.1.2. AT 命令语句 ..................................................................................................................9 3.2. AT 示例声明..............................................................................................................................9 3.3. OneNET 相关 AT 命令详解 .....................................................................................................10 3.3.1. AT+MIPLCONFIG OneNET 接入配置 .......................................................................10 3.3.2. AT+MIPLCREATE 创建 OneNET 通信套件实例........................................................ 11 3.3.3. AT+MIPLDELETE 删除 OneNET 通信套件实例 ........................................................12 3.3.4. AT+MIPLVER 查询 OneNET 通信套件版本 ...............................................................12 3.3.5. AT+MIPLADDOBJ 添加 LwM2M 对象 .......................................................................13 3.3.6. AT+MIPLDELOBJ 删除 LwM2M 对象........................................................................14 3.3.7. AT+MIPLOPEN 发送注册请求...................................................................................14 3.3.8. AT+MIPLCLOSE 发送注销请求.................................................................................15 3.3.9. AT+MIPLDISCOVERRSP 响应发现资源请求............................................................16 3.3.10. AT+MIPLOBSERVERSP 响应订阅请求 ....................................................................17 3.3.11. AT+MIPLREADRSP 响应读取请求............................................................................18 3.3.12. AT+MIPLWRITERSP 响应写入请求 ..........................................................................20 3.3.13. AT+MIPLEXECUTERSP 响应执行请求.....................................................................21 3.3.14. AT+MIPLPARAMETERRSP 响应写属性请求 ............................................................22 3.3.15. AT+MIPLNOTIFY 上报数据至 OneNET 平台或应用服务器 .......................................23 3.3.16. AT+MIPLUPDATE 发送更新请求...............................................................................25 4 错误码 ...............................................................................................................................................26 5 OneNET 平台相关 URC ....................................................................................................................27 5.1. +MIPLDISCOVER 通知 TE 响应平台的发现资源请求..........................................................27 5.2. +MIPLOBSERVE 通知 TE 响应订阅请求 .............................................................................28 5.3. +MIPLREAD 通知 TE 响应读取请求 ....................................................................................28 5.4. +MIPLWRITE 通知 TE 响应写入请求 ...................................................................................29 5.5. +MIPLEXECUTE 通知 TE 响应执行请求..............................................................................30 5.6. +MIPLPARAMETER 通知 TE 响应写属性请求.....................................................................31 5.7. +MIPLEVENT 向 TE 通知事件 .............................................................................................31 5.8. +QIND: 'FOTA','START' 模块 DFOTA 升级开始 .................................................................32 5.9. +QIND: 'FOTA','UPDATING' 模块 DFOTA 升级进度 ..........................................................32 5.10. +QIND: 'FOTA','END' 模块 DFOTA 升级结果.....................................................................33 上海移远通信技术股份有限公司 3 / 57 BC260Y-CN OneNET 应用指导 6 中国移动 OneNET 平台 DFOTA .......................................................................................................34 6.1. 中国移动 OneNET 平台升级流程 ............................................................................................35 6.1.1. 下载阶段 ......................................................................................................................36 6.1.2. 升级阶段 ......................................................................................................................36 6.1.3. 升级后阶段...................................................................................................................36 6.2. 注意事项 .................................................................................................................................36 6.3. OneNET 平台 DFOTA 相关 URC ............................................................................................37 7 举例...................................................................................................................................................38 7.1. 初始化工作 .............................................................................................................................38 7.2. 注册及发现资源操作 ...............................................................................................................38 7.2.1. 注册 OneNET 平台及发现资源.....................................................................................38 7.2.2. 注册 OneNET 平台及发现资源（使能 Bootstrap） ......................................................39 7.2.3. 注册 OneNET 平台及发现资源（禁用 Bootstarp） ......................................................40 7.3. 读取操作 .................................................................................................................................41 7.3.1. 读取资源 ......................................................................................................................41 7.3.2. 读取实例 ......................................................................................................................41 7.3.3. 读取对象 ......................................................................................................................42 7.4. 写入操作 .................................................................................................................................42 7.4.1. 写入资源 ......................................................................................................................42 7.4.2. 写入实例 ......................................................................................................................43 7.5. 执行操作 .................................................................................................................................43 7.6. 写属性操作 .............................................................................................................................43 7.7. 订阅操作 .................................................................................................................................43 7.8. 上报数据操作..........................................................................................................................44 7.8.1. 上报资源数据 ...............................................................................................................44 7.8.2. 上报实例数据 ...............................................................................................................44 7.8.3. 上报对象数据 ...............................................................................................................44 7.8.4. 使用上报资源数据 ...........................................................................................45 7.8.5. 使用上报实例数据 ...........................................................................................45 7.9. 更新操作 .................................................................................................................................45 7.10. OneNET 平台 DFOTA 实例.....................................................................................................46 7.10.1. 创建群组 ......................................................................................................................46 7.10.2. 群组关联设备 ...............................................................................................................47 7.10.3. 新增固件版本 ...............................................................................................................48 7.10.4. 上传差分升级包............................................................................................................50 7.10.5. 创建升级任务 ...............................................................................................................51 7.10.6. 设备升级 ......................................................................................................................52 7.10.7. 重新注册设备 ...............................................................................................................55 8 附录 A 参考文档及术语缩写 .............................................................................................................56 上海移远通信技术股份有限公司 4 / 57 BC260Y-CN OneNET 应用指导 表格索引 表 1：OneNET 相关 AT 命令 .................................................................................................................... 8 表 2：AT 命令类型..................................................................................................................................... 9 表 3：值描述 ................................................................................................................................... 26 表 4：OneNET 相关 URC........................................................................................................................ 27 表 5：OneNET 平台 DFOTA 相关 URC .................................................................................................. 37 表 6：参考文档........................................................................................................................................ 56 表 7：术语缩写........................................................................................................................................ 56 上海移远通信技术股份有限公司 5 / 57 BC260Y-CN OneNET 应用指导 1 引言 本文档主要介绍如何通过相关 AT 命令将集成移远通信 BC260Y-CN 模块的设备连接到中国移动 OneNET 物联网开放平台（以下简称 OneNET），并通过 LwM2M 实现相关功能，如添加/删除对象、发送/ 读取数据、响应订阅/读取/写入/执行请求等。 LwM2M 是一种安全、高效、易部署的客户端-服务器协议，适用于不同网络环境下资源有限的终端设 备管理。LwM2M 基于表述性状态转移（REST）、采用现代架构设计，定义了可扩展资源和数据模型，使 用并基于受限应用程序协议（CoAP）这一高效安全的数据传输协议进行消息传递。依据 CoAP（RFC 7252）， LwM2M 可作为设备服务的 Profile，以此提供轻量紧凑安全的通信接口以及高效的数据模型，从而实现 M2M 设备的管理与服务。 上海移远通信技术股份有限公司 6 / 57 BC260Y-CN OneNET 应用指导 2 OneNET 数据交互机制 本章节主要介绍 OneNET 平台的数据交互机制，如下图所示。 TE UE OneNET平台 应用服务器 AT+CGATT? AT+MIPLCREATE AT+MIPLADDOBJ=... AT+MIPLOPEN=... URC: +MIPLEVENT: ... 10s URC: +MIPLDISCOVER: ... 超时 AT+MIPLDISCOVERRSP=... 10s URC: +MIPLPARAMETER: ... 超时 AT+MIPLPARAMETERRSP=... 10s URC: +MIPLOBSERVE: ... 超时 AT+MIPLOBSERVERSP=... 10s URC: +MIPLREAD: ... 超时 AT+MIPLREADRSP=... 10s URC: +MIPLWRITE: ... 超时 AT+MIPLWRITERSP=... 10s URC: +MIPLEXECUTE: ... 超时 AT+MIPLEXECUTERSP=... 注册请求 响应 发送发现资源请求 响应 发送写属性请求 响应 发送订阅请求 响应 发送读取请求 响应 发送写入请求 响应 发送执行请求 响应 AT+MIPLNOTIFY=... AT+MIPLUPDATE=... URC: +MIPLEVENT: ... AT+MIPLCLOSE= URC: +MIPLEVENT: ... AT+MIPLDELOBJ=... AT+MIPLDELETE= 通知OneNET平台 发送Update请求 响应 Deregister请求 响应 注册 操作 发送写属性请求 响应 发送订阅请求 响应 发送读取请求 响应 发送写入请求 响应 发送执行请求 响应 通知服务器 发现 资源 操作 写属 性 操作 订阅 操作 读取 操作 写入 操作 执行 操作 通知 操作 Update 操作 Deregister 操作 图 1：OneNET 数据交互机制 上海移远通信技术股份有限公司 7 / 57 BC260Y-CN OneNET 应用指导 3 OneNET 相关 AT 命令 本章节主要介绍操作 OneNET 功能的 AT 命令，如下表所列。 表 1：OneNET 相关 AT 命令 序号 AT 命令 [1] AT+MIPLCONFIG [2] AT+MIPLCREATE [3] AT+MIPLDELETE [4] AT+MIPLVER [5] AT+MIPLADDOBJ [6] AT+MIPLDELOBJ [7] AT+MIPLOPEN [8] AT+MIPLCLOSE [9] AT+MIPLDISCOVERRSP [10] AT+MIPLOBSERVERSP [11] AT+MIPLREADRSP [12] AT+MIPLWRITERSP [13] AT+MIPLEXECUTERSP [14] AT+MIPLPARAMETERRSP [15] AT+MIPLNOTIFY [16] AT+MIPLUPDATE 描述 OneNET 接入配置 创建 OneNET 通信套件实例 删除 OneNET 通信套件实例 查询 OneNET 通信套件版本 添加 LwM2M 对象 删除 LwM2M 对象 发送注册请求 发送注销请求 响应发现资源请求 响应订阅请求 响应读取请求 响应写入请求 响应执行请求 响应写属性请求 上报数据至 OneNET 平台或应用服务器 发送更新请求 上海移远通信技术股份有限公司 8 / 57 BC260Y-CN OneNET 应用指导 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 9 / 57 BC260Y-CN OneNET 应用指导 3.3. OneNET 相关 AT 命令详解 3.3.1. AT+MIPLCONFIG OneNET 接入配置 该命令用于启用或禁用 Bootstrap 模式，以及配置 Bootstrap 服务器或者访问服务器地址。 AT+MIPLCONFIG OneNET 接入配置 测试命令 AT+MIPLCONFIG=? 响应 +MIPLCONFIG: (支持的列表),(支持的列表),(支持的列表),,,(支持 的列表) 查询命令 AT+MIPLCONFIG? OK 响应 +MIPLCONFIG: ,,,,, 设置命令 AT+MIPLCONFIG=,[,,,[, ]] 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或 +CIS ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 平台的数据模式。 0 直吐模式 整型。接收数据的格式。 0 十六进制字符串格式 1 文本字符串格式 整型。用于配置 Bootstrap 模式。 0 禁用 Bootstrap 1 启用 Bootstrap 字符串型。IP 地址。 若=0，表示访问服务器 IP 地址。 若=1，表示 Bootstrap 服务器 IP 地址。 上海移远通信技术股份有限公司 10 / 57 BC260Y-CN OneNET 应用指导 整型。端口。范围：1~65535。 若=0，表示访问服务器端口。 若=1，表示 Bootstrap 服务器端口。 整型。设置是否使能设备在生命周期（Lifetime）即将到期时，自动更新生命周期。 0 禁用自动更新 1 启用自动更新 整型。错误码，详情请参考第 4 章。 备注 1. 请在通过 AT+MIPLCREATE 创建通信套件实例之前执行该命令，否则无法注册到 OneNET 平台。 2. 当=0 时，需要在生命周期到期前执行 AT+MIPLUPDATE 进行手动更新，否则设备 生命周期到期后，OneNET 平台会停止维护该设备，后续数据业务会失败；当=1 时， 设备会在生命周期到期前自动更新，如果设备此时处于深休眠状态，则会被唤醒。 3.3.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 该命令用于创建 OneNET 通信套件实例。 AT+MIPLCREATE 创建 OneNET 通信套件实例 执行命令 响应 AT+MIPLCREATE +MIPLCREATE: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CIS ERROR: 5秒 该命令立即生效。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。错误码，详情请参考第 4 章。 上海移远通信技术股份有限公司 11 / 57 BC260Y-CN OneNET 应用指导 3.3.3. AT+MIPLDELETE 删除 OneNET 通信套件实例 该命令用于删除 OneNET 通信套件中的实例。 AT+MIPLDELETE 删除 OneNET 通信套件实例 测试命令 AT+MIPLDELETE=? 响应 +MIPLDELETE: (支持的范围) 设置命令 AT+MIPLDELETE= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CIS ERROR: 5秒 / 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。错误码，详情请参考第 4 章。 3.3.4. AT+MIPLVER 查询 OneNET 通信套件版本 该命令用于查询当前 OneNET 通信套件版本。 AT+MIPLVER 查询 OneNET 通信套件版本 查询命令 响应 AT+MIPLVER? +MIPLVER: OK 最大响应时间 5秒 特性说明 / 参数 字符串型。当前 OneNET 通信套件版本。 上海移远通信技术股份有限公司 12 / 57 BC260Y-CN OneNET 应用指导 3.3.5. AT+MIPLADDOBJ 添加 LwM2M 对象 该命令用于添加 LwM2M 对象。 AT+MIPLADDOBJ 添加 LwM2M 对象 测试命令 AT+MIPLADDOBJ=? 响应 +MIPLADDOBJ: (支持的范围),(支持的范围),(支 持的范围),,(支持的范 围),(支持的范围) 设置命令 OK 响应 AT+MIPLADDOBJ=,,,,,< actCount> OK 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。LwM2M 对象 ID。若不存在，则返回错误。范围：0~65535（0~0xFFFF）。 整型。实例个数。范围：0~65535（0~0xFFFF）。 带双引号的字符串型。实例位图。例如，若共有 4 个实例（=4），ID 分别为 0、1、2、3，='1101' 表示第 1、2、4 位 ID（即 ID 0、1、3） 将被注册，第 3 位 ID 2 不会被注册。 整型。属性个数，表示可读和/或可写资源的个数。范围：0~65535（0~0xFFFF）。 整型。动作个数，表示可执行的资源个数。范围：0~65535（0~0xFFFF）。 整型。错误码，详情请参考第 4 章。 备注 1. 关于 LwM2M 对象 ID 的详细描述，请参考：http://www.openmobilealliance.org/wp/OMNA/LwM2M/ LwM2MRegistry.html。 2. 字符串的长度需要和取值保持一致。 3. 实际注册的实例个数由决定，而非。 上海移远通信技术股份有限公司 13 / 57 BC260Y-CN OneNET 应用指导 3.3.6. AT+MIPLDELOBJ 删除 LwM2M 对象 该命令用于删除 LwM2M 对象。 AT+MIPLDELOBJ 删除 LwM2M 对象 测试命令 AT+MIPLDELOBJ=? 响应 +MIPLDELOBJ: (支持的范围),(支持的范围) 设置命令 AT+MIPLDELOBJ=, OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CIS ERROR: 5秒 该命令立即生效。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。LwM2M 对象 ID。若不存在，则返回错误。范围：0~65535（0~0xFFFF）。 整型。错误码，详情请参考第 4 章。 3.3.7. AT+MIPLOPEN 发送注册请求 该命令用于向 OneNET 平台发送注册请求。 AT+MIPLOPEN 发送注册请求 测试命令 AT+MIPLOPEN=? 响应 +MIPLOPEN: (支持的范围),(支持的范围),(支 持的范围) 设置命令 AT+MIPLOPEN=,[,] OK 响应 OK 若出现任何错误： ERROR 或 上海移远通信技术股份有限公司 14 / 57 最大响应时间 特性说明 参数 BC260Y-CN OneNET 应用指导 +CIS ERROR: 5秒 参该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。用于设置设备的生命周期，实际生命周期为 × 0.9。范围： 15~268435455，若设置为 0，则表示 3600 秒；单位：秒。 整型。注册请求的超时时间。范围：1~65535；单位：秒。默认值：30。 整型。错误码，详情请参考第 4 章。 3.3.8. AT+MIPLCLOSE 发送注销请求 该命令用于向 OneNET 平台发送注销请求。 AT+MIPLCLOSE 发送注销请求 测试命令 AT+MIPLCLOSE=? 响应 +MIPLCLOSE: (支持的范围) 设置命令 AT+MIPLCLOSE= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CIS ERROR: 5秒 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。错误码，详情请参考第 4 章。 上海移远通信技术股份有限公司 15 / 57 BC260Y-CN OneNET 应用指导 3.3.9. AT+MIPLDISCOVERRSP 响应发现资源请求 该命令用于响应来自 OneNET 平台的发现资源请求。 AT+MIPLDISCOVERRSP 响应发现资源请求 测试命令 AT+MIPLDISCOVERRSP=? 响应 +MIPLDISCOVERRSP: (支持的范围),(支持的 范围),(支持的列表),(支持的范围),,(支持的范围) 设置命令 OK 响应 AT+MIPLDISCOVERRSP=,,,,[, ] OK 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。消息 ID。出自 URC +MIPLDISCOVER。范围：0~268435455（0~0xFFFFFFF）。 整型。发现资源操作结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 内容，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 15 4.06 未接受 整型。参数的长度。范围：0~255（0~0xFF）；单位：字节。 带双引号的字符串型。包含对象的属性，每个属性之间用分号隔开，例如： '1101;1102;1103' ， 属 性 个 数 不 应 超 过 AT+MIPLADDOBJ 命 令 的 和 值的总和。 整型。指定消息传输携带的快速释放标记 RAI（释放辅助提示），该标记用于指示核心网 释放与模块的 RRC 连接。范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 上海移远通信技术股份有限公司 16 / 57 整型。错误码，详情请参考第 4 章。 备注 1. URC +MIPLDISCOVER 的详细信息，请参阅第 5.1 章。 2. AT+MIPLADDOBJ 的详细信息，请参阅第 3.3.5 章。 BC260Y-CN OneNET 应用指导 3.3.10. AT+MIPLOBSERVERSP 响应订阅请求 该命令用于响应 OneNET 平台的订阅请求。 AT+MIPLOBSERVERSP 响应订阅请求 测试命令 AT+MIPLOBSERVERSP=? 响应 +MIPLOBSERVERSP: (支持的范围),(支持的 范围),(支持的列表),(支持的范围) 设置命令 AT+MIPLOBSERVERSP=,,[,] OK 响应 OK 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。消息 ID；出自 URC +MIPLOBSERVE。范围：0~268435455（0~0xFFFFFFF）。 整型。订阅结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 内容，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 15 4.06 未接受 整型。指定消息传输携带的快速释放标记 RAI，该标记用于指示核心网释放与模块的 RRC 连接。范围：0~2。 上海移远通信技术股份有限公司 17 / 57 BC260Y-CN OneNET 应用指导 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。错误码，详情请参考第 4 章。 备注 URC +MIPLOBSERVE 的详细信息，请参阅第 5.2 章。 3.3.11. AT+MIPLREADRSP 响应读取请求 该命令用于响应 OneNET 平台发来的读取请求。 AT+MIPLREADRSP 响应读取请求 测试命令 AT+MIPLREADRSP=? 响应 +MIPLREADRSP: (支持的范围),(支持的范围), (支持的列表),(支持的范围),(支持的范 围),(支持的范围),(支持的范围),(支持的范围),,(支持的范围),(支持的范围), (支持的范围) 设置命令 AT+MIPLREADRSP=,,< result>,,,,,,,,[,] OK 响应 OK 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。消息 ID；出自 URC +MIPLREAD。范围：0~268435455（0~0xFFFFFFF）。 整型。读取结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 内容，表示正确结果 11 4.00 无效请求 上海移远通信技术股份有限公司 18 / 57 BC260Y-CN OneNET 应用指导 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 15 4.06 未接受 整型。LwM2M 对象 ID；出自 URC +MIPLREAD。范围：0~65535（0~0xFFFF）。 整型。实例 ID。出自 URC +MIPLREAD。范围：0~65535（0~0xFFFF）。 整型。资源 ID；出自 URC +MIPLREAD。范围：0~65535（0~0xFFFF）。 整型。值的类型。 1 字符串型 2 十六进制类型 3 整型 4 浮点型 5 布尔型（Boolean） 整型。值的长度。单位：字节。 当=1 时，该参数值为字符串型的长度。范围：0~1024。 当=2 时，该参数值为十六进制字符串型的长度。范围：0~512。 当=3 时，该参数值可能为 2、4 或者 8。 当=4 时，该参数值为 4。 当=5 时，该参数值为 1。 数据。 当=1 时，该参数值为带双引号的字符串型格式，最大 1024 字节。 当=2 时，该参数值为十六进制字符串格式，最大 512 字节。 当=3 时，该参数值为整型格式。 当=4 时，该参数值为浮点型格式。 当=5 时，该参数值为布尔型格式。 整型。消息序号。范围：0~10。若读取请求响应包含多条消息，则需发送多次 AT 命令以 完成响应。例如，若读取请求响应包含 N 条消息，则参数需从 N-1 到 0 依次递 减，AT 命令按照取值从大到小的顺序执行。=0 表示数据中最后一条消 息。 整型。消息指示。范围：0~2。当前版本仅支持=0。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 整型。指定消息传输携带的快速释放标记 RAI，该标记用于指示核心网释放与模块的 RRC 连接。范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。错误码，详情请参考第 4 章。 备注 1. 数据的长度应小于 1024 字节。 上海移远通信技术股份有限公司 19 / 57 2. 若=2，十六进制值字符的个数为 × 2。 3. URC +MIPLREAD 的详细信息，参阅第 5.3 章。 4. 当前版本为 OneNET SDK 2.3.0。 BC260Y-CN OneNET 应用指导 3.3.12. AT+MIPLWRITERSP 响应写入请求 该命令用于响应来自 OneNET 平台的写入请求。 AT+MIPLWRITERSP 响应写入请求 测试命令 AT+MIPLWRITERSP=? 响应 +MIPLWRITERSP: (支持的范围),(支持的范 围),(支持的列表),(支持的范围) 设置命令 OK 响应 AT+MIPLWRITERSP=,, [,] OK 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。消息 ID；出自 URC +MIPLWRITE。范围：0~268435455（0~0xFFFFFFF）。 整型。写入结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 已更改，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 整型。指定消息传输携带的快速释放标记 RAI，该标记用于指示核心网释放与模块的 RRC 连接。范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。错误码，详情请参考第 4 章。 上海移远通信技术股份有限公司 20 / 57 备注 URC +MIPLWRITE 的详细信息，参阅第 5.4 章。 BC260Y-CN OneNET 应用指导 3.3.13. AT+MIPLEXECUTERSP 响应执行请求 该命令用于响应来自 OneNET 平台的执行请求。 AT+MIPLEXECUTERSP 响应执行请求 测试命令 AT+MIPLEXECUTERSP=? 响应 +MIPLEXECUTERSP: (支持的范围),(支持的 范围),(支持的列表),(支持的范围) 设置命令 OK 响应 AT+MIPLEXECUTERSP=,,[,] 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。消息 ID；出自 URC +MIPLEXECUTE。范围：0~268435455（0~0xFFFFFFF）。 整型。执行结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 已更改，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 整型。用于指定消息传输携带的快速释放标记 RAI，该标记用于指示核心网释放与模块 的 RRC 连接。范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。错误码，详情请参考第 4 章。 上海移远通信技术股份有限公司 21 / 57 备注 URC +MIPLEXECUTE 的详细信息，参阅第 5.5 章。 BC260Y-CN OneNET 应用指导 3.3.14. AT+MIPLPARAMETERRSP 响应写属性请求 该命令用于响应来自 OneNET 平台的写属性请求。 AT+MIPLPARAMETERRSP 响应写属性请求 测试命令 AT+MIPLPARAMETERRSP=? 响应 +MIPLPARAMETERRSP: (支持的范围),(支持的范围),(支持的列表),(支持的范围) 设置命令 OK 响应 AT+MIPLPARAMETERRSP=,,[,] 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。消息 ID；出自 URC +MIPLPARAMETER。范围：0~268435455（0~0xFFFFFFF）。 整型。写属性操作结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 已更改，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 整型。指定消息传输携带的快速释放标记 RAI，该标记用于指示核心网释放与模块的 RRC 连接。范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。错误码，详情请参考第 4 章。 上海移远通信技术股份有限公司 22 / 57 备注 URC +MIPLPARAMETER 的详细信息，参阅第 5.6 章。 BC260Y-CN OneNET 应用指导 3.3.15. AT+MIPLNOTIFY 上报数据至 OneNET 平台或应用服务器 该命令用于向 OneNET 平台或应用服务器上报数据。 AT+MIPLNOTIFY 上报数据至 OneNET 平台或应用服务器 测试命令 AT+MIPLNOTIFY=? 响应 +MIPLNOTIFY: (支持的范围),(支持的范围),(支 持的范围),(支持的范围),(支持的范围), (支持的范围),(支持的范围),,(支持 的范围),(支持的范围),(支持的范围),(支 持的范围) 设置命令 OK 响应 AT+MIPLNOTIFY=,,,,,,,,,[,[, ]] OK 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。消息 ID；出自 URC +MIPLOBSERVE。范围：0~268435455（0~0xFFFFFFF）。 整型。LwM2M 对象 ID。范围：0~65535（0~0xFFFF）。 整型。实例 ID；出自 URC +MIPLOBSERVE。范围：0~65535（0~0xFFFF）。 整型。资源 ID；出自 URC +MIPLOBSERVE。范围：0~65535（0~0xFFFF）。 整型。值的类型。 1 字符串型 2 十六进制类型 3 整型 4 浮点型 5 布尔型（Boolean） 整型。值的长度；单位：字节。范围：1~255（1~0xFF）。 上海移远通信技术股份有限公司 23 / 57 BC260Y-CN OneNET 应用指导 当=1 时，该参数值为字符串型的长度。范围：0~1024。 当=2 时，该参数值为十六进制字符串型的长度。范围：0~512。 当=3 时，该参数值可能为 2、4 或者 8。 当=4 时，该参数值为 4。 当=5 时，该参数值为 1。 数据。 当=1 时，该参数值为带双引号的字符串型格式。 当=2 时，该参数值为十六进制字符串格式。 当=3 时，该参数值为整型格式。 当=4 时，该参数值为浮点型格式。 当=5 是，该参数值为布尔型格式。 整型。消息序号。若待上报数据包含多条消息，则需要发送多次 AT 命令以完成上报。 例如，若待上报数据包含 N 条消息，则参数需从 N-1 到 0 依次递减，AT 命令 按照取值从大到小的顺序执行。=0 表示数据中最后一条消息。范围： 0~10。 整型。指示消息。范围：0~2。当前版本仅支持=0。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间消息 整型。范围：0~65535。 0 上报的数据以 Non-confirmable（不需要确认）消息格式发送 1~65535 上报的数据以 Confirmable（需要确认）消息格式发送，且消息发送结果 在上报的 URC +MIPLEVENT 中 整型。指定消息传输携带的快速释放标记 RAI，该标记用于指示核心网释放与模块的 RRC 连接。范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。错误码，详情请参考第 4 章。 备注 1. 该命令用于上报数据，数据总长度应小于 1024 字节。若=2，十六进制值字符的个数为 × 2。 2. 对于多个消息组成的数据来说，若其中一条消息返回错误，其前面的消息仍将会被上报，其后的信息 不会被上报，可重试再上报未发送的信息。 3. 当前版本为 OneNET SDK 2.3.0。 上海移远通信技术股份有限公司 24 / 57 BC260Y-CN OneNET 应用指导 3.3.16. AT+MIPLUPDATE 发送更新请求 该命令用于发送更新请求，以更新生命周期和对象列表。 AT+MIPLUPDATE 发送更新请求 测试命令 AT+MIPLUPDATE=? 响应 +MIPLUPDATE: (支持的范围),(支持的范围), (支持的列表),(支持的范围) 设置命令 AT+MIPLUPDATE=,,< withObjectFlag>[,] OK 响应 OK 若出现任何错误： ERROR 或 +CIS ERROR: 最大响应时间 5秒 特性说明 该命令立即生效。 深休眠唤醒后有效；不保存到 NVRAM。 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。更新后的设备生命周期值（实际生命周期为 × 0.9）。范围： 15~268435455，若设置为 0，表示 3600 秒；单位：秒。 整型。是否更新对象列表。 0 不更新 1 更新 整型。指定消息传输携带的快速释放标记 RAI，该标记用于指示核心网释放与模块 的 RRC 连接。范围：0~2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即 释放 整型。错误码，详情请参考第 4 章。 上海移远通信技术股份有限公司 25 / 57 BC260Y-CN OneNET 应用指导 4 错误码 本章节主要介绍与 BC260Y-CN 模块 OneNET 平台 AT 命令相关的错误码。 表 3：值描述 值 651 652 653 654 655 错误码描述 Memory error Parameter error Operation not supported SDK error Not found error 中文含义 内存错误 参数错误 操作不支持 SDK 错误 未找到错误 上海移远通信技术股份有限公司 26 / 57 BC260Y-CN OneNET 应用指导 5 OneNET 平台相关 URC 本章节主要介绍与 OneNET 相关的一系列 URC 及其描述。 表 4：OneNET 相关 URC 序号 URC 描述 [1] +MIPLDISCOVER: ,, OneNET 平台发送发现资源请求，模块接收 到请求后会立刻上报该 URC。 +MIPLOBSERVE: ,,,,, 求后会立即上报该 URC。 +MIPLREAD: ,,,, 求后会立即上报该 URC。 +MIPLWRITE: ,,,,< OneNET 平台发送写入请求，模块接收到请 [4] resId>,,,,, +MIPLEXECUTE: ,,,,[,,] 求后会立即上报该 URC。 +MIPLPARAMETER: ,,,,,, 请求后会立即上报该 URC。 +MIPLEVENT: ,[,[,]] URC。 [8] +QIND: 'FOTA','START' 开始固件升级 [9] +QIND: 'FOTA','UPDATING', 固件升级进度 [10] +QIND: 'FOTA','END', 固件升级结果 5.1. +MIPLDISCOVER 通知 TE 响应平台的发现资源请求 该 URC 用于通知 TE 响应 OneNET 平台的发现资源请求。该 URC 完全输出以后，TE 应在 10 秒内（从 URC 输出以后开始计时）通过 AT+MIPLDISCOVERRSP 响应请求。 +MIPLDISCOVER 通知 TE 响应平台的发现资源请求 +MIPLDISCOVER: ,, 通知 TE 响应 OneNET 平台的发现资源请求 上海移远通信技术股份有限公司 27 / 57 参数 BC260Y-CN OneNET 应用指导 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。数据包消息 ID。范围：0~268435455（0~0xFFFFFFF）。 整型。从 OneNET 平台接收到的 LwM2M 对象 ID。 5.2. +MIPLOBSERVE 通知 TE 响应订阅请求 该 URC 用于通知 TE 响应 OneNET 或者应用服务器的订阅请求。该 URC 完全输出以后，TE 应在 10 秒内（从 URC 输出以后开始计时）通过 AT+MIPLOBSERVERSP 响应请求。 +MIPLOBSERVE 通知 TE 响应订阅请求 +MIPLOBSERVE: ,,,,, 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。数据包消息 ID。范围：0~268435455（0~0xFFFFFFF）。 整型。表示是否订阅。 0 取消订阅 1 订阅 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。-1 表示订阅或者取消订阅指定 LwM2M 对象下所有实例下的所有资源。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。-1 表示订阅或者取消订阅指定实 例下的所有资源。 5.3. +MIPLREAD 通知 TE 响应读取请求 该 URC 用于通知 TE 响应 OneNET 或者应用服务器的读取请求。该 URC 完全输出以后，TE 应在 10 秒内（从 URC 输出以后开始计时）通过 AT+MIPLREADRSP 响应请求。 +MIPLREAD 通知 TE 响应读取请求 +MIPLREAD: ,,,, 上海移远通信技术股份有限公司 28 / 57 参数 BC260Y-CN OneNET 应用指导 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。数据包消息 ID。范围：0~268435455（0~0xFFFFFFF）。 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。-1 表示读取指定 LwM2M 对象下的所有资源。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。-1 表示读取指定实例 下的所有资源。 5.4. +MIPLWRITE 通知 TE 响应写入请求 该 URC 用于通知 TE 响应 OneNET 或者应用服务器的写入请求。该 URC 完全输出以后，TE 应在 10 秒内（从 URC 输出以后开始计时）通过 AT+MIPLWRITERSP 响应请求。 +MIPLWRITE 通知 TE 响应写入请求 +MIPLWRITE: ,,,,,,,,, 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。数据包消息 ID。范围：0~268435455（0~0xFFFFFFF）。 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。 整型。值的类型（当前仅显示十六进制类型）。 1 字符串型 2 十六进制类型 3 整型 4 浮点型 5 布尔型（Boolean） 整型。值的长度；单位：字节。 字符串型。数据。从 OneNET 或者应用服务器处接收到的数据，仅在直吐模式下 有效。 整型。消息指示。范围：0~2。当前版本仅支持=0。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 上海移远通信技术股份有限公司 29 / 57 BC260Y-CN OneNET 应用指导 整型。写入请求的索引号。若写入请求包含多条消息，则 URC 会被分成多个部 分进行上报。例如，若写入请求包含 N 条消息，则参数需从 N-1 到 0 依 次递减，URC 按照取值从大到小的顺序进行上报。=0 表示这是 写入请求中最后一条消息。 备注 1. OneNET 平台和应用服务器发送的写入请求中数据长度应小于 1024 字节，否则可能会操作 失败。 2. 当前版本为 OneNET SDK 2.3.0。 5.5. +MIPLEXECUTE 通知 TE 响应执行请求 该 URC 用于通知 TE 响应 OneNET 或者应用服务器的执行请求。完全输出该 URC 后，TE 应在 10 秒 内（从 URC 输出以后开始计时）通过 AT+MIPLEXECUTERSP 响应请求。 +MIPLEXECUTE 通知 TE 响应执行请求 +MIPLEXECUTE: ,,,,[,,] 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。数据包消息 ID。范围：0~268435455（0~0xFFFFFFF）。 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。 整型。参数的长度。单位：字节。 字符串型。执行操作中 OneNET 平台或应用服务器下发的参数。 备注 OneNET 平台和应用服务器发送的执行请求中长度（即）应小于 1024 字节，否则发 送执行请求可能会失败。 上海移远通信技术股份有限公司 30 / 57 BC260Y-CN OneNET 应用指导 5.6. +MIPLPARAMETER 通知 TE 响应写属性请求 该 URC 用于通知 TE 响应 OneNET 或者应用服务器的写属性请求。完全输出该 URC 后，TE 应在 10 秒内（从 URC 输出以后开始计时）通过 AT+MIPLPARAMETERRSP 响应请求。 +MIPLPARAMETER 通知 TE 响应写属性请求 +MIPLPARAMETER: ,,,,,, 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。数据包消息 ID。范围：0~268435455（0~0xFFFFFFF）。 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。-1 表示适 用于指定对象下的所有资源。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。-1 表示适 用于指定实例下的所有资源。 整型。参数的长度。单位：字节。 字符串型。写属性操作中的参数。 5.7. +MIPLEVENT 向 TE 通知事件 该 URC 用于向 TE 通知事件。 +MIPLEVENT 向 TE 通知事件 +MIPLEVENT: ,[, 向 TE 通知事件。 [,]] 参数 整型。OneNET 通信套件的实例 ID。范围：0~65535。当前仅支持 0。 整型。事件标识符： 1 EVENT_BOOTSTRAP_START（Bootstrap 开始） 2 EVENT_BOOTSTRAP_SUCCESS（Bootstrap 成功） 3 EVENT_BOOTSTRAP_FAILED（Bootstrap 失败） 4 EVENT_CONNECT_SUCCESS（连接成功） 5 EVENT_CONNECT_FAILED（连接失败） 6 EVENT_REG_SUCCESS（注册成功） 上海移远通信技术股份有限公司 31 / 57 BC260Y-CN OneNET 应用指导 7 EVENT_REG_FAILED（注册失败） 8 EVENT_REG_TIMEOUT（注册超时） 9 EVENT_LIFETIME_TIMEOUT（超出生命周期） 10 EVENT_STATUS_HALT（状态暂停） 11 EVENT_UPDATE_SUCCESS（更新成功） 12 EVENT_UPDATE_FAILED（更新失败） 13 EVENT_UPDATE_TIMEOUT（更新超时） 14 EVENT_UPDATE_NEED（更新需要） 15 EVENT_DEREG_DONE（已注销） 20 EVENT_RESPONSE_FAILED（响应失败） 21 EVENT_RESPONSE_SUCCESS（响应成功） 25 EVENT_NOTIFY_FAILED（通知失败） 26 EVENT_NOTIFY_SUCCESS（通知成功） 40 EVENT_FIRMWARE_DOWNLOADING（固件下载中） 41 EVENT_FIRMWARE_DOWNLOAD_FAILED（固件下载失败） 42 EVENT_FIRMWARE_DOWNLOADED（固件下载完成） 43 EVENT_FIRMWARE_UPDATING（开始升级） 48 EVENT_FIRMWARE_ERASE_SUCCESS（固件擦除成功） 49 EVENT_FIRMWARE_ERASE_FAIL（固件擦除失败） 扩展参数。 =20 或者 25 响应命令的消息 ID。 =14 设备生命周期的剩余时间。单位：秒。 整型。通过 AT+MIPLNOTIFY 设置的确认消息标识符。范围：1~65535。 5.8. +QIND: 'FOTA','START' 模块 DFOTA 升级开始 该 URC 指示模块开始固件升级。 +QIND: 'FOTA','START' 模块 DFOTA 升级开始 +QIND: 'FOTA','START' 表示模块开始 DFOTA 升级 5.9. +QIND: 'FOTA','UPDATING' 模块 DFOTA 升级进度 该 URC 指示模块固件升级进度。 +QIND: 'FOTA','UPDATING', 模块 DFOTA 升级进度 +QIND: 'FOTA','UPDATING', 指示模块 DFOTA 升级进度 上海移远通信技术股份有限公司 32 / 57 参数 整型。DFOTA 升级进度（百分比）。 BC260Y-CN OneNET 应用指导 5.10. +QIND: 'FOTA','END' 模块 DFOTA 升级结果 该 URC 指示模块固件升级结果。 +QIND: 'FOTA','END', 模块 DFOTA 升级结果 +QIND: 'FOTA','END',< upgrade_err> 表示模块 DFOTA 升级结果 参数 整型。DFOTA 升级结果。 0 升级成功 255 升级失败 上海移远通信技术股份有限公司 33 / 57 BC260Y-CN OneNET 应用指导 6 中国移动 OneNET 平台 DFOTA 本章节主要描述 BC260Y-CN 模块通过中国移动 OneNET 平台的固件升级功能进行升级的主要步骤和 注意事项。 OneNET 平台 DFOTA 升级主要步骤如下： 第一步：创建群组。 第二步：群组关联设备。 第三步：新增固件版本。 第四步：上传差分升级包。 第五步：创建升级任务。 第六步：设备升级。 第七步：重新注册设备。 各步骤详细操作实例请参阅第 7.10 章。 上海移远通信技术股份有限公司 34 / 57 6.1. 中国移动 OneNET 平台升级流程 BC260Y-CN OneNET 应用指导 MCU AT+MIPLCREATE AT+MIPLADDOBJ AT+MIPLOPEN +MIPLEVENT: 0,6 NB-IoT模块 OneNET平台 配置平台固件升级任务 POST (register) ACK Get /3/0 ACK Get /4/0 ACK Get /5/0 ACK Get /3/0/9 ACK Post /5/0/25601 ACK 升级策略检查：电量，空间， 信号强度，小区排队等 +MIPLEVENT: 0,40 开始下载 +MIPLEVENT: 0,42 下载完成 Put /5/0/0 ACK Get /3/0/9 ACK 升级 Post /5/0/2 ACK 检查电量 +MIPLEVENT: 0,43 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', x%,x,x +QIND: 'FOTA','END',0 AT+MIPLCREATE AT+MIPLADDOBJ AT+MIPLOPEN +MIPLEVENT: 0,6 上报结果 +MIPLEVENT: 0,48 POST (register) ACK Get /3/0 ACK Put /5/0/0 ACK 图 2：中国移动 OneNET 平台 DFOTA 交互图 上海移远通信技术股份有限公司 35 / 57 BC260Y-CN OneNET 应用指导 6.1.1. 下载阶段 1. 在 OneNET 平台上创建升级任务后，终端设备触发 DFOTA 升级流程，平台则会下发请求查询版 本号、小区 ID、信号强度和升级状态等。 2. 模块给终端 MCU 发送+MIPLEVENT: 0,40，开始下载差分升级包。在此状态下，终端 MCU 不可 以给模块断电，且不能向模块发送数据传输相关的 AT 命令。 3. 若下载过程中出现异常操作，模块将会向终端 MCU 发送+MIPLEVENT: 0,41，指示下载升级包失 败。 6.1.2. 升级阶段 差分包下载完成后，平台下发/3/0/9 获取电量信息，检查完成后，平台下发升级命令/5/0/2，升级状态 由 DOWNLOADED 转换到 UPDATING，模块给终端 MCU 发送+MIPLEVENT: 0,43，表示模块正在升级。 在此状态，终端 MCU 不可以给模块断电，且不能发送业务 AT 命令，也无法紧急警告。 6.1.3. 升级后阶段 1. 差分升级完成后，模块会自动启动，此时模块会向 MCU 发送+QIND: 'FOTA','END',。 2. 当模块正常入网后，MCU 应该使用 AT+MIPLOPEN 命令将模块接入平台，以便模块上报升级结 果。 3. 当模块给终端 MCU 发送 URC +MIPLEVENT: 0,48，仅表示下载的差分升级包擦除成功，并不代 表 DFOTA 升级成功。 6.2. 注意事项 ⚫ 终端注册到平台后并上行一次数据后才会开始 DFOTA 任务。 ⚫ DFOTA 过程中终端对模块进行断电、重启、休眠等操作，可能会造成模块 DFOTA 失败。DFOTA 过程中，终端需要终止业务，并且禁止向模块发送非指定 AT 命令。 ⚫ 模块上报+QIND: 'FOTA','END',后，需要重新注册到平台后，平台才能查询升级 结果。 ⚫ 模块不支持 DFOTA 升级重试机制。若在差分升级过程中断电，模块上电后会继续升级；在其他阶 段模块（包括下载和下载完成阶段），将恢复 IDLE 状态，不再主动向平台上报 DFOTA 状态。 上海移远通信技术股份有限公司 36 / 57 6.3. OneNET 平台 DFOTA 相关 URC BC260Y-CN OneNET 应用指导 表 5：OneNET 平台 DFOTA 相关 URC URC +MIPLEVENT: 0,40 +MIPLEVENT: 0,41 +MIPLEVENT: 0,42 +MIPLEVENT: 0,43 +MIPLEVENT: 0,48 +MIPLEVENT: 0,49 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','END', 描述 通知终端 MCU 开始下载固件 通知终端 MCU 固件下载失败 通知终端 MCU 固件下载成功 通知终端 MCU，模块开始升级固件 通知终端 MCU，模块擦除升级固件信息成功 通知终端 MCU，模块擦除升级固件信息失败 通知终端 MCU，模块开始固件升级 通知终端 MCU，模块固件升级进度 通知终端 MCU，模块固件升级结果 备注 URC 详情请参考第 5 章。 上海移远通信技术股份有限公司 37 / 57 BC260Y-CN OneNET 应用指导 7 举例 本章节主要通过实例解释如何使用与 OneNET 相关的 AT 命令。 7.1. 初始化工作 AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 OK AT+CGPADDR? +CGPADDR: 5,'10.177.135.245' OK //禁用休眠模式 //查询网络注册状态是否成功 //找网已成功，若未成功，可多次查询 //找网成功后，可通过此命令获取模块 IP 地址 备注 1. 需 要 使 用 AT+QSCLK=0 禁 用 休 眠 模 式 使 模 块 处 于 工 作 状 态 ； 待 所 有 业 务 完 成 后 ， 请 使 用 AT+QSCLK=1 允许模块进入深休眠模式，以便模块进入深休眠从而降低流耗。详细信息，请参考文 档 [3]。 2. 模块开机后，请参考文档 [4] 检查是否成功入网。 7.2. 注册及发现资源操作 7.2.1. 注册 OneNET 平台及发现资源 本用例展示如何使用默认配置注册中国移动重庆区域的 OneNET 平台；所述 OneNET 平台默认通过 Bootstrap IP 地址 183.230.40.39 连接。 AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例。 上海移远通信技术股份有限公司 38 / 57 BC260Y-CN OneNET 应用指导 OK AT+MIPLADDOBJ=0,3311,1,'1',4,2 OK AT+MIPLOPEN=0,86400 OK //添加 LwM2M 对象。 //成功添加对象，且将注册 ID 为 0 的实例。 //向 OneNET 发送注册请求，到期（24 小时）后自动更新。 +MIPLEVENT: 0,1 //开始连接到 Bootstrap 服务器。 +MIPLEVENT: 0,2 //成功连接到 Bootstrap 服务器。 +MIPLEVENT: 0,4 //成功连接到 OneNET 平台。 +MIPLEVENT: 0,6 //成功注册到 OneNET 平台。 +MIPLOBSERVE: 0,69234,1,3311,0,-1 AT+MIPLOBSERVERSP=0,69234,1 OK //接收到订阅请求（3311/0）。 //响应订阅请求，其结果码为 1。 +MIPLDISCOVER: 0,26384,3311 //接收到发现资源请求。 AT+MIPLDISCOVERRSP=0,26384,1,19,'5850;5851;5706;5805' //使用资源 ID 列表响应发现资源请求。 OK AT+MIPLDELOBJ=0,3311 //删除 LwM2M 对象。 OK AT+MIPLCLOSE=0 //向 OneNET 平台发送注销请求。 OK +MIPLEVENT: 0,15 AT+MIPLDELETE=0 OK //成功注销。 //成功删除通信套件实例。 7.2.2. 注册 OneNET 平台及发现资源（使能 Bootstrap） 本用例展示如何注册支持 Bootstrap 模式的 OneNET 平台。 AT+MIPLCONFIG=0,1,1,'183.230.40.39',5683 //使能 Bootstrap 模式并配置 Bootstrap 服务器 IP 和端口 号。 OK AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例。 OK AT+MIPLADDOBJ=0,3311,1,'1',4,2 OK AT+MIPLOPEN=0,86400 //添加 LwM2M 对象。 //成功添加对象，且将注册 ID 为 0 的实例。 //向 OneNET 平台发送注册请求，到期（24 小时）后自 上海移远通信技术股份有限公司 39 / 57 BC260Y-CN OneNET 应用指导 动更新。 OK +MIPLEVENT: 0,1 //开始连接 Bootstrap 服务器。 +MIPLEVENT: 0,2 //成功连接到 Bootstrap 服务器。 +MIPLEVENT: 0,4 //成功连接到 OneNET 平台。 +MIPLEVENT: 0,6 //成功注册到 OneNET 平台。 +MIPLOBSERVE: 0,91530,1,3311,0,-1 AT+MIPLOBSERVERSP=0,91530,1 OK //接收到订阅请求（3311/0）。 //响应订阅请求，其结果码为 1。 +MIPLDISCOVER: 0,25995,3311 //接收到发现资源请求。 //响应发现资源的请求。 AT+MIPLDISCOVERRSP=0,25995,1,19,'5850;5851;5706;5805' OK AT+MIPLDELOBJ=0,3311 //删除 LwM2M 对象。 OK AT+MIPLCLOSE=0 //向 OneNET 平台发送注销请求。 OK +MIPLEVENT: 0,15 AT+MIPLDELETE=0 OK //成功注销。 //成功删除通信套件实例。 7.2.3. 注册 OneNET 平台及发现资源（禁用 Bootstarp） 本用例展示如何注册不支持 Bootstrap 模式的 OneNET 平台。 AT+MIPLCONFIG=0,1,0,'183.230.40.40',5683 //禁用 Bootstrap 模式并配置访问服务器 IP 和端口号。 OK AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例。 OK AT+MIPLADDOBJ=0,3311,1,'1',4,2 OK AT+MIPLOPEN=0,86400 //添加 LwM2M 对象。 //添加对象成功并将注册实例 ID 0。 //向 OneNET 平台发送注册请求，到期（24 小时）后自 动更新。 上海移远通信技术股份有限公司 40 / 57 BC260Y-CN OneNET 应用指导 OK +MIPLEVENT: 0,4 //成功连接到 OneNET 平台。 +MIPLEVENT: 0,6 //成功注册到 OneNET 平台。 +MIPLOBSERVE: 0,111068,1,3311,0,-1 AT+MIPLOBSERVERSP=0,111068,1 OK //接收到订阅请求（3311/0）。 //响应订阅请求，其结果码为 1。 +MIPLDISCOVER: 0,45533,3311 //接收到发现资源请求。 AT+MIPLDISCOVERRSP=0,45533,1,19,'5850;5851;5706;5805' //响应发现资源的请求。 OK AT+MIPLDELOBJ=0,3311 //删除 LwM2M 对象。 OK AT+MIPLCLOSE=0 //向 OneNET 平台发送注销请求。 OK +MIPLEVENT: 0,15 AT+MIPLDELETE=0 OK //成功注销。 //成功删除通信套件实例。 7.3. 读取操作 7.3.1. 读取资源 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送读取资源（3311/0/5805）请求。 +MIPLREAD: 0,3123,3311,0,5805 AT+MIPLREADRSP=0,3123,1,3311,0,5805,4,4,1.88,0,0 OK //接收到读取资源请求。 /响应读取请求。 //成功发送数据 1.88 到应用服务器。 7.3.2. 读取实例 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送读取实例（3311/0）请求。 +MIPLREAD: 0,25466,3311,0,-1 //发送 4 条消息响应读取请求。 AT+MIPLREADRSP=0,25466,1,3311,0,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5852,3,2,123,2,0 //接收到读取实例请求。 上海移远通信技术股份有限公司 41 / 57 BC260Y-CN OneNET 应用指导 OK AT+MIPLREADRSP=0,25466,1,3311,0,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5805,4,4,1.88,0,0 OK 7.3.3. 读取对象 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送读取对象（3311）请求。 +MIPLREAD: 0,39299,3311,-1,-1 //接收到读取对象请求。 //发送 6 条消息回应读取请求。 AT+MIPLREADRSP=0,39299,1,3311,0,5851,5,1,1,5,0 OK AT+MIPLREADRSP=0,39299,1,3311,0,5852,3,2,123,4,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5805,4,4,1.88,0,0 OK 7.4. 写入操作 7.4.1. 写入资源 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送写入资源（3311/0/5706）请求，并含有字符串格式的值：hello。 +MIPLWRITE: 0,38017,3311,0,5706,2,5,68656C6C6F,0,0 //接收到写入资源请求。 AT+MIPLWRITERSP=0,38017,2 OK //响应写入请求，其结果码为 2。 +MIPLWRITE: 0,38018,3311,0,5706,2,5,68656C6C6F,0,2 //接收到写入资源请求。 AT+MIPLWRITERSP=0,38018,2 //响应写入请求，其结果码为 2。 OK 上海移远通信技术股份有限公司 42 / 57 BC260Y-CN OneNET 应用指导 7.4.2. 写入实例 //UE 已经成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送写入实例（3311/0）请求。 +MIPLWRITE: 0,46584,3311,0,5706,2,5,68656C6C6F,0,2 //接收到写入实例请求。 +MIPLWRITE: 0,46584,3311,0,5850,2,1,01,0,1 +MIPLWRITE: 0,46584,3311,0,5851,2,8,00000002DFDC1C3E,0,0 AT+MIPLWRITERSP=0,46584,2 //响应写入请求，其结果码为 2。 OK 7.5. 执行操作 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送执行请求，其中包含 Argument：reset。 +MIPLEXECUTE: 0,36476,3303,0,5605,5,'reset' //接收到执行请求。 AT+MIPLEXECUTERSP=0,36476,2 //响应执行请求，其结果码为 2。 OK 7.6. 写属性操作 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送写属性请求。 +MIPLPARAMETER: 0,56642,3303,0,5700,38,'pmin=2;pmax=190;gt=100.0;lt=1.0;st=0.2' AT+MIPLPARAMETERRSP=0,56642,2 //收到写属性请求。 //响应写属性请求，其结果码为 2。 OK 7.7. 订阅操作 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送订阅请求。 +MIPLOBSERVE: 0,29620,1,3311,0,-1 AT+MIPLOBSERVERSP=0,29620,1 OK //收到订阅请求。 //确认订阅请求。 上海移远通信技术股份有限公司 43 / 57 BC260Y-CN OneNET 应用指导 7.8. 上报数据操作 7.8.1. 上报资源数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅资源（3303/0/5700）。 AT+MIPLNOTIFY=0,122179,3303,0,5700,4,4,25.6,0,0 //上报资源数据。 OK 7.8.2. 上报实例数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅实例（3303/0）。 AT+MIPLNOTIFY=0,653687,3303,0,5700,4,4,10.24,3,0 //上报实例数据。 OK AT+MIPLNOTIFY=0,653687,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5602,4,4,100.86,0,0 OK 7.8.3. 上报对象数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅对象（3303）。 //上报实例 ID 为 0 下资源的数据。 AT+MIPLNOTIFY=0,196301,3303,0,5700,4,4,9.8,3,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5602,4,4,99.8,0,0 OK //上报实例 ID 为 1 下资源的数据。 AT+MIPLNOTIFY=0,196301,3303,1,5700,4,4,0.2,3,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5601,4,4,3.2,1,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5602,4,4,100.1,0,0 OK 上海移远通信技术股份有限公司 44 / 57 BC260Y-CN OneNET 应用指导 7.8.4. 使用上报资源数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅资源（3303/0/5701）。 AT+MIPLNOTIFY=0,307353,3303,0,5701,1,3,'Cel',0,0,255 //使用（255）上报资源数据。 OK +MIPLEVENT: 0,26,255 //上报结果。 7.8.5. 使用上报实例数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅实例（3303/0）。 //使用（258）上报实例数据。 AT+MIPLNOTIFY=0,487674,3303,0,5700,4,4,170.1,3,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5701,1,3,'Cel',2,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5601,4,4,106.1,1,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5602,4,4,660.9,0,0,258 OK +MIPLEVENT: 0,26,258 //上报结果。 7.9. 更新操作 //UE 已成功注册到 OneNET 平台。 AT+MIPLUPDATE=0,86400,0 OK +MIPLEVENT: 0,11 //更新设备生命周期为 86400 秒。 //更新结果。 上海移远通信技术股份有限公司 45 / 57 BC260Y-CN OneNET 应用指导 7.10. OneNET 平台 DFOTA 实例 7.10.1. 创建群组 1. 设备注册到 OneNET 平台后，在 OneNET 平台网站主界面左侧工具栏选择'OTA 升级'下的'FOTA 升级'→'添加 FOTA 群组'。 图 3：创建 FOTA 群组 1 2. 填写相应的群组信息。'群组名称'可根据需求填写，'厂商名称'选择'移远通信'，'模块型号' 选择对应模块型号。如下图所示，'模块型号'选择的是'BC260Y-CN'。 上海移远通信技术股份有限公司 图 4：创建 FOTA 群组 2 46 / 57 BC260Y-CN OneNET 应用指导 7.10.2. 群组关联设备 1. 在'FOTA 升级'页面中选择'关联设备'，添加 DFOTA 设备，如下图所示。 图 5：选择关联设备 2. 关联设备时，平台会根据创建群组时选择的模块型号，弹出当前产品下对应模块型号的设备。用户 直接添加对应模块型号的设备即可。若无可添加的设备或未获取到需要添加终端设备的版本号，说 明添加设备失败，请查看 IMEI 是否合法、需要添加的模块的型号是否与群组的模块型号一致或模 块是否在线，如下图所示。 上海移远通信技术股份有限公司 图 6：关联设备 47 / 57 BC260Y-CN OneNET 应用指导 7.10.3. 新增固件版本 1. 请先从供应商处获取差分固件升级包，并且确定当前版本号和目标版本号。 2. 在'FOTA 升级'页面中'正式群组'上点击'FOTA 升级'进入'固件管理'页面，如下图所示。 图 7：选择 FOTA 升级 3. 在'固件管理'页面点击'添加固件版本'，进入添加固件版本页面，如下图所示。模块当前支持 以 DFOTA 方式升级固件，所以平台的 FOTA 升级需要添加两次固件版本，即目标版本和当前固件 版本。以下是 BC260Y-CN 模块固件版本的添加步骤。 图 8：添加固件版本 上海移远通信技术股份有限公司 48 / 57 BC260Y-CN OneNET 应用指导 1) 向 OneNET 平台添加差分升级包当前版本信息，例如'BC260YCNAAR01A03'。 图 9：新增当前版本号 2) 向 OneNET 平台添加差分升级包目标版本信息，例如'BC260YCNAAR01A03_BETA0721'。 图 10：新增目标版本号 上海移远通信技术股份有限公司 49 / 57 BC260Y-CN OneNET 应用指导 7.10.4. 上传差分升级包 1. 在'FOTA 升级'→'固件管理'页面中选择目标版本点击添加升级包。下图以目标版本'B C260YCNAAR01A03_BETA0721'为例。 图 11：升级包管理页面 2. 添加升级包。'类型'选择'差分包'，'初始版本'为当前终端设备的固件版本，如'BC260 YCNAAR01A03'，'目标版本'为待升级的目标版本，如'BC260YCNAAR01A03_BETA07 21'。点击'选择文件'选择差分升级包的本地路径，点击'确定'上传差分升级包文件。需 注意，上传到 OneNET 平台的是差分升级包的 bin 文件，不是 zip 的压缩文件，如下图所示。 图 12：上传差分固件升级包 上海移远通信技术股份有限公司 50 / 57 BC260Y-CN OneNET 应用指导 7.10.5. 创建升级任务 1. 在 FOTA 群组中选择对应模块的'FOTA 升级'→'升级任务管理'页面中点击添加升级任务，如 下图所示： 图 13：升级任务管理页面 2. 任务名称可以自定义（下图以'quectel_demo'为例），选择升级包时需注意检查初始版本，如 'BC260YCNAAR01A03'和目标版本号，如'BC260YCNAAR01A03_BETA0721'。如下图所示。 图 14：添加升级任务页面 上海移远通信技术股份有限公司 51 / 57 BC260Y-CN OneNET 应用指导 3. 选择'FOTA 升级'→'升级任务管理'→'任务'→'更多操作'→'详情'，打开升级任务详 情页面，如下图所示： 图 15：升级任务详情页面 7.10.6. 设备升级 1. 升级任务创建成功之后，终端设备需等待 1~3 分钟后，再执行触发 DFOTA 升级命令操作，使用以 下 3 种方法均可以触发 DFOTA 升级操作： 1) 若创建升级任务时，终端设备离线，终端设备需要重新注册到平台才能触发 DFOTA 升级任务。 2) 若创建升级任务时，终端设备在线，终端设备执行更新操作（如：AT+MIPLUPDATE=0,8640 0,0），可触发 DFOTA 升级任务。 3) 若创建升级任务时，终端设备在线，终端设备执行上报消息操作（如：AT+MIPLNOTIFY=0, 96119,3200,0,5750,1,5,'Dfota',0,0,45），可触发 DFOTA 升级任务。 上海移远通信技术股份有限公司 52 / 57 BC260Y-CN OneNET 应用指导 状态更新成功后，在 OneNET 平台的'升级任务详情'页面下载状态会更新为'下载中'，如下图 所示。 图 16：升级任务下载中 2. OneNET 平台 DFOTA 过程中，MCU 侧 AT 命令操作实例。 +IP: 11.201.96.220 AT+QSCLK=0 OK ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A03 //上报本地 IP //禁止深休眠 //查询当版本 OK AT+MIPLCREATE +MIPLCREATE: 0 OK AT+MIPLOPEN=0,84600 OK +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 上海移远通信技术股份有限公司 53 / 57 +MIPLEVENT: 0,6 +MIPLEVENT: 0,40 +MIPLEVENT: 0,42 +MIPLEVENT: 0,43 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',0%,1,1 +QIND: 'FOTA','UPDATING',3%,1,1 …… +QIND: 'FOTA','UPDATING',100%,1,1 RDY +CFUN: 1 +QIND: 'FOTA','END',0 AT+QSCLK=0 OK +IP: 100.99.159.61 AT+MIPLCREATE +MIPLCREATE: 0 OK AT+MIPLADDOBJ=0,3302,1,'1',4,1 OK AT+MIPLOPEN=0,84600 OK +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 BC260Y-CN OneNET 应用指导 //开始下载差分升级包 //下载差分升级包完成 //开始升级 //升级进度 //升级成功 //再注册到平台，以便上报升级结果到平台 上海移远通信技术股份有限公司 54 / 57 +MIPLEVENT: 0,48 +MIPLEVENT: 0,11 ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A03_BETA0721 OK BC260Y-CN OneNET 应用指导 //查询当版本 7.10.7. 重新注册设备 模块升级后，MCU 需要控制模块重新向 OneNET 平台发起注册，以便模块上报升级结果。成功上报 后平台显示如下： 图 17：任务升级成功 上海移远通信技术股份有限公司 55 / 57 BC260Y-CN OneNET 应用指导 8 附录 A 参考文档及术语缩写 表 6：参考文档 序号 文档名称 IPSO Smart Object Guideline [1] (Smart Objects Starter Pack) Lightweight Machine to Machine Technical [2] Specification [3] Quectel_BC260Y-CN_AT 命令手册 [4] Quectel_BC260Y-CN_终端应用设计指导 [5] Quectel_BC260Y-CN_DFOTA_应用指导 备注 IPSO 联盟发布的智能设备指导标准 OMA 发布的 LwM2M 规格书 BC260Y-CN AT 命令手册 BC260Y-CN 终端应用设计指导 表 7：术语缩写 术语 CoAP ID IPSO LwM2M LPWA ME NB-IoT NVRAM RAI REST RRC 英文全称 Constrained Application Protocol Identifier Internet Protocol for Smart Objects Lightweight Machine to Machine Low-Power Wide-Area Mobile Equipment Narrow Band Internet of Things Non-volatile Random Access Memory Release Assistant Indication Representational State Transfer Radio Resource Control 中文全称 受限应用协议 标识符 智能对象互联网协议 轻量级机器到机器物联网协议 低功耗广覆盖 移动设备 窄带物联网 非易失性随机访问存储器 释放辅助指示 表述性状态转移 无线资源控制 上海移远通信技术股份有限公司 56 / 57 TE UE URC DFOTA Terminal Equipment (Typically the MCU) User Equipment (Typically the Module) Unsolicited Result Code Delta firmware Upgrade Over-the-Air BC260Y-CN OneNET 应用指导 终端设备（通常为 MCU） 用户设备（通常为模块） 非请求结果码 固件空中差分升级 上海移远通信技术股份有限公司 57 / 57

BC260Y-CN MQTT 应用指导 NB-IoT 模块系列 版本：1.0 日期：2021-02-05 状态：受控文件 www.quectel.com BC260Y-CN MQTT 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 29 BC260Y-CN MQTT 应用指导 文档历史 修订记录 版本 1.0 日期 2020-12-15 2021-02-05 作者 变更表述 Arno DONG 文档创建 Arno DONG 受控版本 上海移远通信技术股份有限公司 2 / 29 BC260Y-CN MQTT 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 MQTT 数据交互..................................................................................................................................... 6 3 MQTT 相关 AT 命令.............................................................................................................................. 7 3.1. AT 命令语法................................................................................................................................ 7 3.1.1. 定义 ................................................................................................................................. 7 3.1.2. AT 命令语句 .................................................................................................................... 7 3.2. AT 示例声明................................................................................................................................ 8 3.3. MQTT 相关 AT 命令 ................................................................................................................... 8 3.3.1. AT+QMTCFG 配置 MQTT 参数 .................................................................................... 8 3.3.2. AT+QMTOPEN 打开 MQTT 客户端网络 .................................................................... 13 3.3.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 .................................................................. 14 3.3.4. AT+QMTCONN 连接客户端到 MQTT 服务器............................................................. 15 3.3.5. AT+QMTDISC 断开客户端与 MQTT 服务器的连接.................................................... 17 3.3.6. AT+QMTSUB 订阅主题 .............................................................................................. 18 3.3.7. AT+QMTUNS 退订主题 .............................................................................................. 19 3.3.8. AT+QMTPUB 发布消息 .............................................................................................. 20 4 错误码 ................................................................................................................................................. 23 5 MQTT 相关 URC ................................................................................................................................. 24 5.1. +QMTSTAT 上报 MQTT 链路层状态变化的 URC ................................................................. 24 5.2. +QMTRECV 通知 Host 主机读取 MQTT 数据包的 URC....................................................... 25 6 举例 ..................................................................................................................................................... 26 6.1. 基于 TCP/IP 的 MQTT 操作举例 .............................................................................................. 26 7 附录 A 参考文档及术语缩写................................................................................................................ 29 上海移远通信技术股份有限公司 3 / 29 BC260Y-CN MQTT 应用指导 表格索引 表 1：AT 命令类型........................................................................................................................................ 7 表 2：错误码............................................................................................................................................... 23 表 3：MQTT 相关的 URC........................................................................................................................... 24 表 4：URC +QMTSTAT 中的错误码 .......................................................................................................... 24 表 5：参考文档 ........................................................................................................................................... 29 表 6：术语缩写 ........................................................................................................................................... 29 上海移远通信技术股份有限公司 4 / 29 BC260Y-CN MQTT 应用指导 1 引言 MQTT 是基于代理服务器发布/订阅范式的通讯协议，有开放、简单、轻量和易于实现等特点。MQTT 最大的优势在于，可以以极少的代码和有限的网络带宽，为远程设备连接提供实时可靠的消息服务。 本文档介绍如何通过 AT 命令应用移远通信 BC260Y-CN 模块的 MQTT 功能。 上海移远通信技术股份有限公司 5 / 29 BC260Y-CN MQTT 应用指导 2 MQTT 数据交互 本章节介绍了 MQTT 功能的数据交互机制。 MCU 模块 链路层 MQTT服务器 AT+QMTCFG='keepalive',... AT+QMTCFG='timeout',... … AT+QMTOPEN=... OK TCP-REQ +QMTOPEN: , TCP established AT+QMTCONN AT+QMTCONN=... OK +QMTCONN: ,[,] CONN-REQ Start timer T1, T2 CONN ACK-IND Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK 发送连接数据包 服务器收到连接数据包并返回ACK AT+QMTSUB AT+QMTSUB=... OK +QMTSUB: ,, [,] SUB-REQ () Start timer T1 SUB ACK-IND () Stop T1 or handle Excep2 AT+QMTUNS AT+QMTUNS=... OK +QMTUNS: ,, UNS-REQ () Start timer T1 UNS ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB=,,=0... OK PUB-REQ AT+QMTPUB (=1) AT+QMTPUB=,,=1... PUB-REQ () OK Start timer T1 +QMTPUB: ,,[,< value>] PUB ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB (=2) AT+QMTPUB=,,=2... PUB-REQ () OK Start timer T1 PUB REC-IND ) Stop T1 or handle Excep2 +QMTPUB: ,,[, ] PUB REL-REQ () Start timer T1 PUB COMP-IND () Stop T1 or handle Excep2 发送订阅数据包 服务器收到订阅数据包并返回ACK 发送退订数据包 服务器收到退订数据包并返回ACK 发送发布数据包 发送发布数据包 服务器收到发布数据包并返回ACK 发送发布数据包 服务器收到发布数据包 发送释放发布数据包 服务器收到释放发布数据包 T1是数据包传输超时 时间. T2 是keep alive定时 器超时时间. 在T2超时时间内若没 有数据相关信息传 输，客户端会发送心 跳请求包。 Excep1: 断开TCP连 接 Excep2: 重发数据包，除非 达到允许重发次数 上限； 允许重复次数可通 过命令 AT+QMTCFG来设 置。 命令AT+QMTCFG可以 配置是否上报超时信息。 Receive 收到URC格式的PUBLISH 信息 +QMTRECV: ,,[, ], PUB-IND () PUB ACK/REC-REQ () Reply according to . . . AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , DISC-REQ TCP-REQ TCP disconnected 服务器收到发布数据包 发送发布答复数据包 发送断开连接数据包 TCP断..开. 请求 图 1：MQTT 数据交互机制 上海移远通信技术股份有限公司 6 / 29 BC260Y-CN MQTT 应用指导 3 MQTT 相关 AT 命令 本章节介绍了 MQTT 操作的相关 AT 命令。 3.1. AT 命令语法 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 7 / 29 BC260Y-CN MQTT 应用指导 3.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.3. MQTT 相关 AT 命令 3.3.1. AT+QMTCFG 配置 MQTT 参数 该命令用于配置 MQTT 的相关参数。相关错误码，请参考第 4 章。 AT+QMTCFG 配置 MQTT 参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'will',(支持的范围),(支持的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 列表),, +QMTCFG: 'timeout',(支持的范围),(支 持的范围),(支持的范围),(支持的 列表) +QMTCFG: 'session',(支持的范围),(支 持的列表) +QMTCFG: 'keepalive',(支持的范围),(支 持的范围) +QMTCFG: 'aliauth',( 支 持 的 范 围),,, +QMTCFG: 'version',(支持的范围),(支持 的列表) +QMTCFG: 'showrecvlen',( 支 持 的 范 围),(支持的列表) +QMTCFG: 'echomode',( 支 持 的 范 围),(支持的列表) +QMTCFG: 'dataformat',( 支 持 的 范 围 ),( 支 持 的 列 表 ),( 支 持 的 列 表) 设置命令 配置或查询 Will 信息 AT+QMTCFG='will',[,[,, ,,]] OK 响应 若省略可选参数，则查询当前配置： +QMTCFG: [,,,,] 上海移远通信技术股份有限公司 8 / 29 BC260Y-CN MQTT 应用指导 OK 若指定可选参数，则配置 Will 信息： OK 设置命令 配置或查询消息传输超时时间 AT+QMTCFG='timeout',[,[,][, ]] 若有任何错误： ERROR 或 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMTCFG: ,, OK 若指定可选参数，则配置消息传输超时时间： OK 设置命令 配置或查询会话类型 AT+QMTCFG='session',[,] 若有任何错误： ERROR 或 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMTCFG: OK 若指定可选参数，则配置会话类型： OK 设置命令 配置或查询保活时间 AT+QMTCFG='keepalive',[,] 若出现任何错误： ERROR 或 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMTCFG: OK 若指定可选参数，则配置保活时间： OK 上海移远通信技术股份有限公司 9 / 29 BC260Y-CN MQTT 应用指导 设置命令 配置或查询阿里云设备信息 AT+QMTCFG='aliauth',[,,,] 若有任何错误： ERROR 或 +CME ERROR: 响应 若省略可选参数，并已配置阿里云设备信息，则查询当前配置： +QMTCFG: ,, OK 若省略可选参数，但未配置阿里云设备信息，则不显示设备信 息： OK 若指定可选参数，则配置阿里云设备信息： OK 设置命令 配置或查询 MQTT 协议版本 AT+QMTCFG='version',[,] 若有任何错误： ERROR 或 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMTCFG: OK 若指定可选参数，则配置 MQTT 协议版本： OK 设置命令 配置或查询是否显示接收数据的长度 AT+QMTCFG='showrecvlen',[,] 若有任何错误： ERROR 或 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMTCFG: OK 若指定可选参数，则配置是否显示接收数据的长度： OK 上海移远通信技术股份有限公司 10 / 29 BC260Y-CN MQTT 应用指导 若有任何错误： ERROR 或 设置命令 +CME ERROR: 响应 配置或查询在数据模式下是否向 UART 若省略可选参数，则查询当前配置： 回显输入的数据 +QMTCFG: AT+QMTCFG='echomode',[,] OK 若指定可选参数，则配置在数据模式下是否向 UART 回显输入 的数据： OK 设置命令 配置或查询收发数据的格式 AT+QMTCFG='dataformat',[,,] 若有任何错误： ERROR 或 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QMTCFG: , OK 若指定可选参数，则配置收发数据的格式： OK 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。范围：0~4。 整型。表示是否需要配置 Will 信息。 0 无需配置 Will 信息 1 需要配置 Will 信息 整型。发送消息时的 QoS 级别。 上海移远通信技术股份有限公司 11 / 29 BC260Y-CN MQTT 应用指导 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。表示是否保留 Will 信息。仅适用于 PUBLISH 消息。 0 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者后， 服务器不保留该消息 1 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者后， 服务器保留该消息 带双引号的字符串型。Will 主题名称。长度范围：0~256 字节。 带双引号的字符串型。客户端意外断开后发送到 Will 主题的消息内容。长度范围： 0~256 字节。 整型。数据包传输超时时间。范围：1~60；默认值：30；单位：秒。 整型。数据包传输超时后重发次数。范围：0~10；默认值：0。 整型。数据包传输时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器存储该客户端的订阅消息 1 服务器删除客户端之前保留的任何消息，此连接状态为 Clean 整型。保活时间。范围：0~3600；默认值：120；单位：秒。定义从客户端接收消 息的最大间隔时间。在此参数设置时间的 1.5 倍时间内，若服务器未从客户端收到 消息，则默认断开客户端连接，效果和从客户端发送了 DISCONNECT 消息相同。 0 表示不断开客户端连接 带双引号的字符串型。从阿里云获取的产品密钥。 带双引号的字符串型。从阿里云获取的设备名称。 带双引号的字符串型。从阿里云获取的设备校验凭证。 整型。MQTT 协议版本。 0 MQTT v3.1.0 1 MQTT v3.1.1 整型。显示接收数据长度的 flag，表明是否显示接收数据长度（）。 0 不显示 1 显示 整型。在数据模式下是否向 UART 回显输入数据。 0 不向 UART 回显输入数据 1 向 UART 回显输入数据 整型。发送数据的格式。 0 文本格式 1 十六进制格式 整型。接收数据的格式。 0 文本格式 1 十六进制格式 上海移远通信技术股份有限公司 12 / 29 BC260Y-CN MQTT 应用指导 备注 1. 若参数=1，则必须配置参数、、 和 ， 若参数=0，则省略以上参数。 2. 只有当服务器支持对应的会话操作时，参数配置才有效。 3. 发送 QoS 为非 0 的数据包后，若时间内未收到服务器 ACK，模块会自动重发并重复 次。在 × ( + 1)后仍未收到 ACK，则认为发送失败。 4. 查 询 阿 里 云 设 备 信 息 时 ， 若 当 前 无 设 备 信 息 ， 则 无 +QMTCFG: ,, 返回，仅返回 OK 或者 ERROR。 5. AT+QMTCFG='aliauth'只用于阿里云，若已在 AT+QMTCFG 进行配置，则 AT+QMTCONN 中的参 数和可以省略。 6. 仅在数据模式传输中，才有效。 3.3.2. AT+QMTOPEN 打开 MQTT 客户端网络 该命令用于为 MQTT 客户端打开网络。相关错误码，请参考第 4 章。 AT+QMTOPEN 打开 MQTT 客户端网络 测试命令 AT+QMTOPEN=? 响应 +QMTOPEN: ( 支 持 的 范 围),,(支持的范围) OK 查询命令 AT+QMTOPEN? 若有任何错误： ERROR 或 +CME ERROR: 响应 [+QMTOPEN: ,,] OK 设置命令 AT+QMTOPEN=,, 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTOPEN: , 若出现任何错误： ERROR 上海移远通信技术股份有限公司 13 / 29 最大响应时间 特性说明 或 +CME ERROR: 176 秒，受网络状态影响 - BC260Y-CN MQTT 应用指导 参数 整型。MQTT Socket 标识符。范围：0~4。 带双引号的字符串性。服务器地址，可为 IP 地址或域名。最大长度：100 字节。 整型。服务器端口。范围：1~65535。 整型。命令执行结果。 -1 打开网络失败 0 打开网络成功 1 参数错误 2 MQTT 标识符被占用 3 激活 PDP 失败 4 域名解析失败 5 网络断开 备注 执 行 AT+QMTOPEN? 时 ， 若 当 前 不 存 在 已 打 开 的 客 户 端 信 息 ， 则 无 +QMTOPEN: ,,返回，仅返回 OK 或者 ERROR。 3.3.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 该命令用于关闭 MQTT 客户端网络。相关错误码，请参考第 4 章。 AT+QMTCLOSE 关闭 MQTT 客户端网络 测试命令 AT+QMTCLOSE=? 响应 +QMTCLOSE: (支持的范围) OK 设置命令 AT+QMTCLOSE= 若有任何错误： ERROR 或 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 14 / 29 最大响应时间 特性说明 BC260Y-CN MQTT 应用指导 +QMTCLOSE: , 若有任何错误： ERROR 或 +CME ERROR: 300 毫秒 - 参数 整型。MQTT Socket 标识符。范围：0~4。 整型。命令执行结果。 -1 关闭网络失败 0 关闭网络成功 3.3.4. AT+QMTCONN 连接客户端到 MQTT 服务器 该命令用于客户端请求连接 MQTT 服务器。当创建客户端和服务器之间的 TCP/IP Socket 连接时，必 须使用 CONNECT 流创建一个协议层会话。相关错误码，请参考第 4 章。 AT+QMTCONN 连接客户端到 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: ( 支 持 的 范 围),,, OK 查询命令 AT+QMTCONN? 若有任何错误： ERROR 或 +CME ERROR: 响应 [+QMTCONN: ,] OK 若有任何错误： ERROR 或 +CME ERROR: 上海移远通信技术股份有限公司 15 / 29 BC260Y-CN MQTT 应用指导 设置命令 AT+QMTCONN=,[,[,]] 响应 OK +QMTCONN: ,[,] 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: × ( + 1)（默认 30 秒），受网络 状态影响 - 参数 整型。MQTT Socket 标识符。范围：0~4。 带双引号的字符串型。客户端标识符。 带双引号的字符串型。客户端用户名。可用来鉴权。 带双引号的字符串型。客户端用户名对应的密码。可用来授权。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 初始化 2 MQTT 正在连接 3 MQTT 已经连接成功 4 MQTT 正在断开连接 整型。连接状态返回码。 0 接受连接 1 拒绝连接：不接受该协议版本 2 拒绝连接：标识符被拒绝 3 拒绝连接：服务器不可用 4 拒绝连接：错误的用户名或密码 5 拒绝连接：未授权 整型。数据包传输超时时间。范围：1~60；默认值：30；单位：秒。可通过 AT+QMTCFG='timeout',[,[,] [,]] 来配置超时时间。 整型。数据包传输超时后重发次数。范围：0~10；默认值：0。 上海移远通信技术股份有限公司 16 / 29 BC260Y-CN MQTT 应用指导 备注 1. 若某一个客户端 ID 已经连接服务器端，那么当另一个客户端使用相同 ID 进行连接时，服务器端会在 新客户端完成 CONNECT 流之前，自动断开原来的客户端连接。 2. 执 行 AT+QMTCONN? 时 ， 若 当 前 不 存 在 MQTT 连 接 ， 则 无 +QMTCONN: , 返回，仅返回 OK 或者 ERROR。 3.3.5. AT+QMTDISC 断开客户端与 MQTT 服务器的连接 该命令用于断开客户端与 MQTT 服务器的连接。客户端发送 DISCONNECT 消息到服务器表示即将与 服务器断开 MQTT 连接。相关错误码，请参考第 4 章。 AT+QMTDISC 断开客户端与 MQTT 服务器的连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的范围) OK 设置命令 AT+QMTDISC= 若有任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTDISC: , 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: 300 毫秒 - 参数 整型。MQTT Socket 标识符。范围：0~4。 整型。命令执行结果。 -1 断开连接失败 0 断开连接成功 上海移远通信技术股份有限公司 17 / 29 BC260Y-CN MQTT 应用指导 3.3.6. AT+QMTSUB 订阅主题 该命令用于订阅一个或多个主题。客户端发送 SUBSCRIBE 消息向服务器订阅一个或多个主题。当有 消息被发布到订阅主题时，服务器会把这些消息作为 PUBLISH 消息传输到客户端。相关错误码，请 参考第 4 章。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: (支持的范围),(支持的 范围>),,(支持的范围),,(支持的范 围),… OK 设置命令 AT+QMTSUB=,< msgID>,,[,, …] 若有任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTSUB: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: ×( + 1)（默认 30 秒），受网络状 态影响 - 参数 整型。MQTT Socket 标识符。范围：0~4。 整型。数据包标识符。范围：1~65535。 带双引号的字符串型。客户端订阅或者退订的主题。长度范围：0~256 字节。 整型。客户端发送消息的 QoS 等级。 0 最多一次，该主题下的消息发送端仅发送一次，不需要接收端确认。 1 至少一次，该主题下的消息需要接收端回复 ACK 确认。 2 正好一次，该主题下的消息确保接收端仅接收到一次。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 上海移远通信技术股份有限公司 18 / 29 BC260Y-CN MQTT 应用指导 2 数据包发送失败 整型。 若=0，如果服务器接受订阅，则为已确认的 QoS 等级；如果服务 器拒绝订阅，则为 128； 若=1，则表示数据包重传次数； 若=2，则不显示。 整 型 。 数 据 包 传 输 超 时 时 间 。 范 围 ： 1~60 ； 默 认 值 ： 30 ； 单 位 ： 秒 。 可 通 过 AT+QMTCFG='timeout',[,[,][,]] 配置超时时间。 整型。数据包传输超时后重发次数。范围：0~10；默认值：0。 备注 在特定通信方向的一组飞行消息中，必须只有唯一的消息标识符。该参数取值通常按消息排列顺序逐一 递增，但非必须逐一递增。 3.3.7. AT+QMTUNS 退订主题 该命令用于退订一个或者多个主题。客户端向服务器发送 UNSUBSCRIBE 消息以退订指定的主题。相 关错误码，请参考第 4 章。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: (支持的范围),(支持的 范围),,,… OK 设置命令 AT+QMTUNS=,< msgID>,[,...] 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTUNS: ,, 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: ×( + 1)（默认 30 秒），受网络状 态影响 上海移远通信技术股份有限公司 19 / 29 BC260Y-CN MQTT 应用指导 特性说明 - 参数 整型。MQTT Socket 标识符。范围：0~4。 整型。数据包标识符。范围：1~65535。 带双引号的字符串型。客户端订阅或者退订的主题。长度范围：0~256 字节。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。数据包传输超时时间。范围：1~60；默认值：30；单位：秒。可通过 AT+QMTCFG='timeout',[,[,] [,]] 配置超时时间。 整型。数据包传输超时后重发次数。范围：0~10；默认值：0。 3.3.8. AT+QMTPUB 发布消息 该命令可以从客户端发布消息到服务器，再由服务器分配到订阅者。每一个 PUBLISH 消息都关联一个 主题名称，若一个客户端订阅了一个或者多个主题，服务器会把发布到这些主题下的所有消息作为 PUBLISH 消息发送到客户端。相关错误码，请参考第 4 章。 AT+QMTPUB 发布消息 测试命令 AT+QMTPUB=? 响应 +QMTPUB: ( 支 持 的 范 围 ), ( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 列 表),,(支持的范围), OK 若出现任何错误： ERROR 或 +CME ERROR: 设置命令 数据模式下发布不定长消息 响应 OK AT+QMTPUB=,,,, 响应 > 后，输入需要发送的数据，按 Ctrl+Z 发送数据，按 Esc 取消发送。 +QMTPUB: ,,[,] 若出现任何错误： ERROR 上海移远通信技术股份有限公司 20 / 29 BC260Y-CN MQTT 应用指导 设置命令 数据模式下发布定长消息 AT+QMTPUB=,,,,, 响应 > 后，输入需要发送的数据，当输 入的数据长度达到指定的数据长度 后数据将会被发送 设置命令 非数据模式下发布定长消息 AT+QMTPUB=,,,,,, 或 +CME ERROR: 响应 OK +QMTPUB: ,,[,] 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTPUB: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: × ( + 1)（默认 30 秒），受网络 状态影响 - 参数 整型。MQTT Socket 标识符。范围：0~4。 整型。数据包消息标识符。范围：0~65535。当=0 时，该参数值只能为 0。 客户端发送消息的 QoS 等级。 0 最多一次，发送端仅发送一次，不需要接收端确认。 1 至少一次，需要接收端回复 ACK 确认。 2 正好一次，确保接收端仅接收到一次。 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 不保存 1 保存 带双引号的字符串型。需要发布的消息的主题。长度范围：0~256 字节。 字符串型。需要发布的消息数据。 整型。指定的消息数据长度。范围：0~1460。 整型。命令执行结果。 上海移远通信技术股份有限公司 21 / 29 BC260Y-CN MQTT 应用指导 0 数据包发送成功且接收到服务器的 ACK（当=0 时发布了数据，则无 需 ACK） 1 数据包重传 2 数据包发送失败 整型。 若=1，则表示数据包重传次数； 若=0 或 2，则不显示此参数。 整 型 。 数 据 传 输 超 时 时 间 。 范 围 ： 1~60 ； 默 认 值 ： 30 ； 单 位 ： 秒 。 可 通 过 AT+QMTCFG='timeout',[,[, ][,]]配置超时时间。 整型。数据包传输超时后的重发次数。范围：0~10；默认值：0。 备注 1. 若该命令执行成功并响应 OK，需等待命令最终结果返回后，客户端再继续发布新的数据包。 2. 执行此命令后，客户端可发送数据（即 MQTT payload 有效负载信息）。输入数据每次最大长度为 1460 字节，按 Ctrl+Z 可发送数据。请勿超出最大长度，超出 1460 字节的部分不会被发送。 3. 进入数据模式后，若 60 s 内没有发送数据，则会超时并退出数据模式。 4. PUBLISH 消息既可由发布者发送至服务器，也可以由服务器发送至订阅者。当服务器发布消息到订 阅者时，会返回 URC 通知 host 主机读取 MQTT 服务器发送的数据，URC 的格式为：+QMTRECV: ,,[,],，关于 URC 描述的详细信息， 请参考第 5.2 章。 5. 若=2，则表示数据包发送超时或协议栈阻塞。 上海移远通信技术股份有限公司 22 / 29 BC260Y-CN MQTT 应用指导 4 错误码 最终结果码 +CME ERROR: 表示和移动设备或网络相关的错误。下面的表格中列举了部分常见 的错误码。 表 2：错误码 8503 8504 8505 8506 8507 8508 8509 8510 8511 8600 英文含义 中文含义 MQTT link error MQTT 连接错误 MQTT illegal packet MQTT 非法数据包 MQTT illegal character MQTT 非法字符 MQTT illegal UTF8 MQTT 非法 UTF8 MQTT invalid parameter MQTT 无效参数 The length of transmitted data exceeds that of 传输数据长度超过剩余传输缓存 remaining transmitted buffer MQTT buffer overflow MQTT 缓存溢出 MQTT out of memory MQTT 内存不足 MQTT memory error MQTT 内存错误 MQTT unknown error MQTT 未知错误 备注 AT+CMEE=命令禁用（=0）或启用（=1）最终结果码 +CME ERROR: 。当 =1 时，发生错误时，将返回一组有限的错误代码。请参考文档 [3]。 上海移远通信技术股份有限公司 23 / 29 BC260Y-CN MQTT 应用指导 5 MQTT 相关 URC 本章节描述了 BC260Y-CN 模块 MQTT 相关的 URC。 表 3：MQTT 相关的 URC 索引 URC 格式 描述 [1] +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 并上报 URC。 +QMTRECV: ,,[,], 上报 URC。 5.1. +QMTSTAT 上报 MQTT 链路层状态变化的 URC 此 URC 以 +QMTSTAT：开头，当 MQTT 链路层状态发生变化时，会上报此 URC。 +QMTSTAT 上报 MQTT 链路层状态变化的 URC +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 并上报 URC。 参数 整型。MQTT Socket 标识符。范围：0~4。 错误码。请参考表 4。 表 4：URC +QMTSTAT 中的错误码 1 2 描述 连接被服务器断开或者重置 发送 PINGREQ 包超时或者失败 解决方法 执行 AT+QMTOPEN 命令重建 MQTT 连接 确认模块网络是否正常，并执行 AT+QMTOPEN 命令重建 MQTT 连接。 上海移远通信技术股份有限公司 24 / 29 3 4 5 6 7 8~255 BC260Y-CN MQTT 应用指导 发送 CONNECT 包超时或者失败 接收 CONNACK 包超时或者失败 客户端向服务器发送 DISCONNECT 包，但是服务器主动断开 MQTT 连接 因为发送数据包总是失败，客户端主动 断开 MQTT 连接 1. 查看输入的用户名和密码是否正确； 2. 确保客户端 ID 未被占用； 3. 执行 AT+QMTOPEN 命令，重建 MQTT 连接； 4. 尝试再次发送 CONNECT 包到服务器。 1. 查看输入的用户名和密码是否正确； 2. 确保客户端 ID 未被占用； 3. 执行 AT+QMTOPEN 命令，重建 MQTT 连接； 4. 尝试再次发送 CONNECT 包到服务器。 正常流程。 1. 确保数据正确； 2. 可能因为网络拥堵或者其他错误，尝试 执行 AT+QMTOPEN 命令重建 MQTT 连接。 链路不工作或者服务器不可用 确保当前链路或者服务器可用。 预留作将来使用的错误码 5.2. +QMTRECV 通知 Host 主机读取 MQTT 数据包的 URC 此 URC 以+QMTRECV：开头，用来通知 Host 主机读取 MQTT 服务器发送的数据包。 +QMTRECV 通知 Host 主机读取 MQTT 数据包的 URC +QMTRECV: ,, 通知 Host 主机读取 MQTT 服务器发送的数据包。 [,], 参数 整型。MQTT Socket 标识符。范围：0~4。 整型。数据包的消息标识符。 字符串型。从 MQTT 服务器接收的消息的主题。 整型。负载信息的长度。范围：0~1460；单位：字节。 字符串型。主题名称相关的负载。 备注 可使用 AT+QMTCFG='showrecvlen'命令配置是否显示参数。 上海移远通信技术股份有限公司 25 / 29 BC260Y-CN MQTT 应用指导 6 举例 本章节提供举例以解释如何使用 MQTT 相关命令。 6.1. 基于 TCP/IP 的 MQTT 操作举例 AT+QSCLK=0 //启用休眠锁，防止模块进入深睡眠 OK AT+QMTCFG='aliauth',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAaz Z' //配置阿里云设备信息（如果连接阿里 云平台） OK AT+QMTCFG='showrecvlen',0 +QMTCFG: 0 //查询是否显示接收到的数据的长度 //默认为不显示接收的数据长度 OK AT+QMTCFG='showrecvlen',0,1 //配置显示接收到的数据长度 OK AT+QMTOPEN=0,'oyjtmPl5a5j.iot-as-mqtt.cn-shanghai.aliyuncs.com',1883//MQTT 客户端打开网络 OK +QMTOPEN: 0,0 //MQTT 客户端成功打开网络 AT+QMTOPEN? +QMTOPEN: 0,'oyjtmPl5a5j.iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK AT+QMTCONN=? +QMTCONN: (0-4),,, OK //若连接阿里云，使用 AT+QMTCFG='aliauth'提前配置设备信息，之后便可省略参数和 AT+QMTCONN=0,'clientExample' //客户端连接 MQTT 服务器 OK 上海移远通信技术股份有限公司 26 / 29 BC260Y-CN MQTT 应用指导 +QMTCONN: 0,0,0 AT+QMTSUB=? +QMTSUB : (0-4), (1-65535),, (0-2),, (0-2),… //客户端成功连接到 MQTT 服务器 OK AT+QMTSUB=0,1,'oyjtmPl5a5j/S2fXbFBKh4NSwwyIjSC4/user/get',2 OK //订阅主题 +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'oyjtmPl5a5j/S2fXbFBKh4NSwwyIjSC4/user/update',0 OK +QMTSUB: 0,1,0,0 //若客户订阅了其他设备发布到服务器的主题，模块会上报如下信息： +QMTRECV: 0,0,'oyjtmPl5a5j/S2fXbFBKh4NSwwyIjSC4/user/get',36,'This is the payload related to topic' AT+QMTUNS=0,2,'oyjtmPl5a5j/S2fXbFBKh4NSwwyIjSC4/user/get' OK //退订主题 +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB: (0-4),(0-65535),(0-2),(0,1),,(0-1460), OK AT+QMTPUB=0,0,0,0,'oyjtmPl5a5j/S2fXbFBKh4NSwwyIjSC4/user/update' //发布消息 > This is test data, hello MQTT. //响应 > 后，输入并发送'This is test data, hello MQTT.'，数据最大长度 是 1460 字节，输入的数据不要超出 最大长度，多出的部分不会发送。按 Ctrl+Z 发送数据 OK +QMTPUB: 0,0,0 //若客户端订阅了名为'oyjtmPl5a5j/S2fXbFBKh4NSwwyIjSC4/user/update'的主题，且其他设备向服务 器发布了相同主题，模块会上报如下信息： +QMTRECV: 0,0,'oyjtmPl5a5j/S2fXbFBKh4NSwwyIjSC4/user/update',30,'This is test data, hello MQTT.' 上海移远通信技术股份有限公司 27 / 29 AT+QMTDISC=0 OK +QMTDISC: 0,0 AT+QSCLK=1 OK BC260Y-CN MQTT 应用指导 //断开客户端在 MQTT 服务器的连接 //连接断开成功 //释放休眠锁 上海移远通信技术股份有限公司 28 / 29 BC260Y-CN MQTT 应用指导 7 附录 A 参考文档及术语缩写 表 5：参考文档 序号 [1] [2] [3] 文档名称 MQTT V3.1 Protocol Specification MQTT V3.1.1 Protocol Specification Quectel_BC260Y-CN_AT 命令手册 说明 MQTT 协议规格说明 3.1 版本 MQTT 协议规格说明 3.1.1 版本 BC260Y-CN 模块的 AT 命令手册 表 6：术语缩写 缩写 ACK IP MQTT PDP QoS TCP UART URC 英文全称 中文全称 Acknowledgement 确认字符 Internet Protocol 网际互连协议 Message Queuing Telemetry Transport 消息队列遥测传输 Packet Data Protocol 分组数据协议 Quality of Service 服务质量 Transmission Control Protocol 传输控制协议 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 Unsolicited Result Code 未请求结果码 上海移远通信技术股份有限公司 29 / 29

BC260Y-CN Log 抓取指导 NB-IoT 模块系列 版本：1.0 日期：2020-08-12 状态：受控文件 www.quectel.com BC260Y-CN Log 抓取指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 23 文档历史 修订记录 版本 日期 作者 1.0 2020-08-12 饶晨 变更表述 初始版本 BC260Y-CN Log 抓取指导 上海移远通信技术股份有限公司 2 / 23 BC260Y-CN Log 抓取指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图表索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 工具与驱动 ............................................................................................................................................ 7 2.1. TE-B 开发板 ............................................................................................................................... 7 2.2. EPAT 运行环境 ........................................................................................................................... 8 3 连接与设置 .......................................................................................................................................... 10 3.1. 连接设置 ................................................................................................................................... 10 3.2. 状态查看....................................................................................................................................11 3.2.1. 模块连接状态查看 ..........................................................................................................11 3.2.2. 模块数据库状态查看.......................................................................................................11 4 Log 抓取流程 ..................................................................................................................................... 12 4.1. 确认模块处于校准状态 ............................................................................................................. 12 4.2. 启动 EPAT ................................................................................................................................ 13 4.3. 配置端口波特率 ........................................................................................................................ 14 4.4. 选择数据库文件 ........................................................................................................................ 15 4.5. 抓取 Log ................................................................................................................................... 17 4.6. 保存 Log ................................................................................................................................... 17 4.6.1. 手动保存 ........................................................................................................................ 18 4.6.2. 自动保存 ........................................................................................................................ 19 5 常见问题.............................................................................................................................................. 21 5.1. 模块连接不上 PC 怎么办？ ...................................................................................................... 21 5.2. 模块连接不上 EPAT 怎么办？ .................................................................................................. 21 5.3. 如何获取数据库文件？ ............................................................................................................. 21 5.4. 数据库文件不匹配怎么办？...................................................................................................... 21 5.5. Log 抓取的波特率可以修改吗？............................................................................................... 22 6 附录 A 参考文档及术语缩写................................................................................................................ 23 上海移远通信技术股份有限公司 3 / 23 BC260Y-CN Log 抓取指导 表格索引 表 1：TE-B 关键组件介绍 ............................................................................................................................ 8 表 2：模块连接状态.....................................................................................................................................11 表 3：数据库状态 ........................................................................................................................................11 表 4：按钮功能介绍.................................................................................................................................... 17 表 5：参考文档........................................................................................................................................... 23 表 6：术语缩写........................................................................................................................................... 23 上海移远通信技术股份有限公司 4 / 23 BC260Y-CN Log 抓取指导 图表索引 图 1：BC260Y-CN-TE-B .............................................................................................................................. 7 图 2：接口显示图 ....................................................................................................................................... 10 图 3：选择数据资源.................................................................................................................................... 13 图 4：打开资源选择串口 ............................................................................................................................ 13 图 5：选择 Device ...................................................................................................................................... 14 图 6：选择端口和波特率 ............................................................................................................................ 14 图 7：打开数据库窗口 ................................................................................................................................ 15 图 8：更新数据库文件 ................................................................................................................................ 16 图 9：选择数据库文件 ................................................................................................................................ 16 图 10：控制抓取 Log 按钮.......................................................................................................................... 17 图 11：Log 手动保存 .................................................................................................................................. 18 图 12：选择保存路径.................................................................................................................................. 18 图 13：保存成功......................................................................................................................................... 19 图 14：打开自动保存设置 .......................................................................................................................... 19 图 15：自动保存设置.................................................................................................................................. 20 图 16：保存成功......................................................................................................................................... 20 上海移远通信技术股份有限公司 5 / 23 BC260Y-CN Log 抓取指导 1 引言 本文档主要介绍如何通过 EPAT 工具和 TE-B 开发板，抓取移远通信 BC260Y-CN 模块的 Log 信息，对 BC260Y-CN-TE-B，EPAT 工具，端口设置，抓取和保存 Log 进行说明。 上海移远通信技术股份有限公司 6 / 23 BC260Y-CN Log 抓取指导 2 工具与驱动 在 BC260Y-CN 模块中进行 Log 抓取需要使用以下工具和驱动： ⚫ 开发板：BC260Y-CN 模块的 TE-B 开发板 ⚫ 串口通信工具：移远通信 QCOM 1.6 或者更新的版本 ⚫ Log 抓取工具：EPAT ⚫ USB 转串口驱动：由电脑自行通过驱动识别工具自动安装 2.1. TE-B 开发板 本章节介绍了 BC260Y-CN-TE-B 开发板，实物图及组件功能介绍如下： 图 1：BC260Y-CN-TE-B 上海移远通信技术股份有限公司 7 / 23 下表描述了 BC260Y-CN-TE-B 的组件功能。 BC260Y-CN Log 抓取指导 表 1：TE-B 关键组件介绍 序号 1 2 3 4 5 组件名称 RESET 按钮 BOOT 按钮 PSM_EINT 按钮 串口开关 跳线帽 6 Mini USB 端口 7 USB 口 8 天线端口 描述 用于重启模块。 用于固件的下载。烧录固件时，需要先按下 BOOT，再按下 RESET， 然后松开 RESET，再松开 BOOT 按钮，才能触发模块烧录固件。 将模块从休眠中唤醒。 控制主串口连接模块或连接外接 MCU。 连接 USB 端口和 USIM 卡功能模块，若不连接，USB 供电时，USIM 卡不能供电 通过 UART 转 USB 芯片，将 UART 口转成 4 路端口：0 路用于 AT 命令，1 路用于抓取 Log，其它 2 路预留。 外接串口转接板，用于辅助测试。 提供给外置天线连接使用。 关于 BC260Y-CN-TE-B 的详细信息，请参考文档 [1]。 2.2. EPAT 运行环境 EPAT（EigenComm Platform Analysis Tools）是一款适用于 BC260Y-CN 模块的 Log 抓取、分析工具。 EPAT 支持在线的 Log 抓取和离线的 Log 分析，主要用于问题的追踪、定位和模块的调试。如需获取该工 具，可联系移远通信技术支持 support@quectel.com。 EPAT 在 PC 中的运行环境需要满足以下条件： 1. 硬件： ⚫ CPU：Inter Core（建议 Inter Core i3 以上） ⚫ 内存：1 GB（建议 2 GB 以上） ⚫ 硬盘：5120 MB 可用空间 ⚫ 接口：2 个 USB 口（最小值） 上海移远通信技术股份有限公司 8 / 23 BC260Y-CN Log 抓取指导 2. 软件： ⚫ 操作系统：Microsoft Windows 7、Windows 8.1 或 Windows 10 ⚫ 软件环境：Microsoft Visual C++ 2015 Redistributable (x86) 或 Microsoft Visual Studio 2015 EPAT 工具为绿色软件，无需进行复杂的安装过程。将工具包拷贝到 PC 上，在 Bin 文件夹下找到 EPAT.exe 双击打开即可运行。 上海移远通信技术股份有限公司 9 / 23 BC260Y-CN Log 抓取指导 3 连接与设置 3.1. 连接设置 通过 TE-B 上的 Mini USB 口将模块与 PC 连接，完成连接后 PC 会自动安装驱动，安装完成后会出现 4 个端口，如下图所示： 图 2：接口显示图 一般情况下，第一个端口 'USB Serial Port (COM36)'用于 AT 命令通信；第三个端口 'USB Serial Port (COM38)'用于抓取 Log。 备注 1. PC 安装的驱动不同可能会导致实际显示的端口名称与以上截图不一致，请以实际情况为准。 2. 不同的 PC 上可能端口的顺序是不同的，不一定总是第一个和第三个。 上海移远通信技术股份有限公司 10 / 23 BC260Y-CN Log 抓取指导 3.2. 状态查看 3.2.1. 模块连接状态查看 在 EPAT 工具的右下角，可以查看模块的连接状态，如下表所示。 表 2：模块连接状态 图标显示 状态 连接成功 未连接 连接失败 说明 设备可以和 EPAT 工具通信，可抓取 Log。 EPAT 没有找到设备，不能抓取 Log，请参考第 5.2 章 处理。 EPAT 与设备通信失败，不能抓取 Log，请参考第 5.2 章 处理。 3.2.2. 模块数据库状态查看 在 EPAT 工具的左上角，可以查看模块的数据库状态。 表 3：数据库状态 图标显示 状态 数据库读取失败 数据库不匹配 说明 指定路径下无数据库文件或更改路径后没有重启，请参 考第 5.4 章 更新数据库文件或尝试重启 Device。 请参考第 5.4 章 更新数据库文件。 数据库匹配 可正常抓取 Log。 上海移远通信技术股份有限公司 11 / 23 BC260Y-CN Log 抓取指导 4 Log 抓取流程 抓取的 Log 需要保证其有效性和便于分析。因此，每次抓取的 Log 都要确保数据库选择正确，且单板 校准正常。Log 抓取步骤如下： 第一步：确认模块处于校准状态 第二步：启动 EPAT 工具 第三步：配置端口波特率 第四步：选择数据库文件 第五步：抓取 Log 第六步：保存 Log 4.1. 确认模块处于校准状态 连接设置完成后，注意确认模块是否处于校准状态。所有的测试、应用都应当在校准的状态下进行，否 则不能保证模块的功能和性能。 执行以下 AT 命令查询是否校准，若未校准，请校准后再测试和应用。 AT+QRFSTAT NOT CALIBRATE //表示模块没有校准，这时不能进行测试，各项性能都不能保证 OK AT+QRFSTAT CALIBRATE //表示模块已经校准，这时可以进行测试，并抓取 Log OK 备注 AT+QRFSTAT 命令正在开发中，详细介绍请参考文档 [2]。 上海移远通信技术股份有限公司 12 / 23 BC260Y-CN Log 抓取指导 4.2. 启动 EPAT 首次启动 EPAT 后，会弹出对话框，如下图所示选择'Serial Device'： 图 3：选择数据资源 如果不是首次启动，可能不会弹出以上窗口，此时如需选择数据资源，可以点击 EPAT 工具上如下图 所示按钮以弹出以上对话框： 图 4：打开资源选择串口 上海移远通信技术股份有限公司 13 / 23 BC260Y-CN Log 抓取指导 4.3. 配置端口波特率 选择'Serial Device'并点击'OK'后，会弹出如下端口设置界面如下，点击'Settings'进行端口 和波特率设置： 图 5：选择 Device 图 6：选择端口和波特率 上海移远通信技术股份有限公司 14 / 23 BC260Y-CN Log 抓取指导 完成如上的波特率选择后，同时需要在 AT 口执行以下命令设置波特率： AT+QCFG=logbaudrate,3000000 OK AT+QCFG=logbaudrate,6000000 OK //设置波特率为 3 M //设置波特率为 6 M 备注 1. 建议用户设置的波特率不能低于 3 M，否则会出现 Log 大量丢失的现象，导致后续无法进行问题分 析。 2. 关于 AT+QCFG 命令的详细介绍，请参考文档 [2]。 4.4. 选择数据库文件 不同的固件版本，需要不同的数据库文件才能正确解码。因此，在进行 Log 抓取时需要先选择正确的 数据库文件。 点击 EPAT 的左上角图标，如下图所示： 图 7：打开数据库窗口 上海移远通信技术股份有限公司 15 / 23 在弹出的对话框中点击'Update'以更新数据库文件： BC260Y-CN Log 抓取指导 图 8：更新数据库文件 在弹出的对话框中点击'...'选择相应的数据库文件的路径。完成后点击'Update'按钮，更新数据 库，直至更新完成。 图 9：选择数据库文件 上海移远通信技术股份有限公司 16 / 23 4.5. 抓取 Log 点击左上角的开始、暂停、停止或清除按钮控制 Log 的抓取。 BC260Y-CN Log 抓取指导 图 10：控制抓取 Log 按钮 表 4：按钮功能介绍 按钮图标 功能 开始/继续 暂停 停止 清除 介绍 开始抓取 Log 或暂停后继续抓取 Log。查看器可以自动刷新 Log 页面。 暂停抓取 Log。查看器不刷新 Log 显示，但继续保存 Log。不确定当前 的 Log 是否已发现 UE 的故障，可使用该按钮。 查看器不刷新 Log 显示，并停止保存 Log。当前的 Log 已经保存，后 续接收的 Log 不需要保存时，可使用该按钮。 清除显示页面内已经抓取的 Log。 4.6. 保存 Log Log 保存可以设置为手动保存和自动保存。用户可根据实际需要进行选择。选择手动保存 Log 时，每 次抓取 Log 均需进行保存设置。若选择自动保存，仅需要第一次 Log 保存的时候进行设置，后续抓取 Log， EPAT 会自动将 Log 文件保存到所设置的文件夹。 上海移远通信技术股份有限公司 17 / 23 BC260Y-CN Log 抓取指导 4.6.1. 手动保存 点击工具栏的保存按钮或者按键盘快捷键'CTRL'+'S'，在弹出的窗口选择需要保存的路径。如下 图所示。 图 11：Log 手动保存 图 12：选择保存路径 上海移远通信技术股份有限公司 18 / 23 BC260Y-CN Log 抓取指导 若弹出如下窗口，说明 Log 保存成功。保存时默认文件名为时间，为了便于识别，可自定义文件名称。 图 13：保存成功 4.6.2. 自动保存 点击主菜单上的'Log'→'Preference'，在弹出的对话框中可设置自动保存功能。 图 14：打开自动保存设置 上海移远通信技术股份有限公司 19 / 23 BC260Y-CN Log 抓取指导 在弹出的窗口中勾选'AutoSave Log File'，并设置自动保存 Log 文件的大小，以及保存路径。其中 Log 文件的大小不能设置超过 1000 MB。点击'OK'保存配置。 图 15：自动保存设置 若弹出如下窗口说明 Log 保存成功。 图 16：保存成功 上海移远通信技术股份有限公司 20 / 23 BC260Y-CN Log 抓取指导 5 常见问题 5.1. 模块连接不上 PC 怎么办？ 模块连接 PC 时，Windows 系统会自动搜索并安装 USB 转串口驱动以连接设备。如果测试 PC 不能联 网，可能导致驱动无法下载，此时需要先从其它 PC 下载驱动，再通过 U 盘等方式安装在该测试 PC 上。 如果找不到合适的驱动，可联系移远通信技术支持 support@quectel.com。 5.2. 模块连接不上 EPAT 怎么办？ 首先需要检查端口是否正确。一般情况下为第 3 个端口，如果不正确，则需要尝试其它端口。 如果确认端口正确，但仍然无法连接，或者尝试所有端口均无法成功连接，请检查波特率是否正确。 如果配置的波特率与 Log 口不一致可能输出乱码数据；如果 TE-B 上的 UART2USB 芯片不支持所配置的波 特率 Log 口，则不会输出任何内容。此时，需要修改波特率适配 UART2USB 芯片，详情请见第 5.5 章。 5.3. 如何获取数据库文件？ 数据库文件随着固件包一起提供，固件包中后缀名为'.db'的就是数据库文件。如果出现以下情况， 请联系移远通信技术支持 support@quectel.com： ⚫ 无固件包 ⚫ 固件包中无数据库文件 ⚫ 固件包中的数据库文件不匹配 5.4. 数据库文件不匹配怎么办？ 数据库文件不匹配时，需重新选择数据库文件。数据库文件被用来解码消息，如果不匹配会导致解码 错误或其他异常，并且可能出现 Log 数据不显示，进而影响问题的分析。因此，务必要保证数据库文件匹 配。如果不匹配，请按照第 4.4 章 内容重新选择数据库文件。 上海移远通信技术股份有限公司 21 / 23 BC260Y-CN Log 抓取指导 5.5. Log 抓取的波特率可以修改吗？ Log 抓取的波特率可以修改。Log 抓取的默认波特率为 6 M，可在选择设置端口波特率的时候进行修改 （见第 4.3 章）。请注意，修改 Log 抓取波特率的同时，需要通过 AT+QCFG='logbaudrate' 配置 BC260Y-CN-TE-B 抓取 Log 的波特率。关于该条命令详情，请参考文档 [2]。 上海移远通信技术股份有限公司 22 / 23 BC260Y-CN Log 抓取指导 6 附录 A 参考文档及术语缩写 表 5：参考文档 序号 [1] [2] 文档名称 Quectel_BC260Y-CN-TE-B_用户指导 Quectel_BC260Y-CN_AT 命令手册 备注 BC260Y-CN-TE-B 用户指导 BC260Y-CN AT 命令手册 表 6：术语缩写 缩写 EPAT NB-IoT PC UART UE USB USIM 英文全称 中文全称 EigenComm Platform Analysis Tools EigenComm 平台分析工具 Narrow Band Internet of Things 窄带物联网 Persional Computer 个人电脑 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 User Equipment 用户设备 Universal Serial Bus 通用串行总线 Universal Subscriber Identity Module 全球用户识别卡 上海移远通信技术股份有限公司 23 / 23

BC260Y-CN DFOTA 应用指导 NB-IoT 模块系列 版本：1.1 日期：2021-04-22 状态：受控文件 BC260Y-CN DFOTA 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功能 错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的使 用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任何 因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权使 用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追究 法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 28 BC260Y-CN DFOTA 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 作者 Peyton LI/ 2021-01-08 Jack QIAN Abbas LIU/ 2021-04-22 Jack QIAN 变更表述 初始版本 1. 添加 HTTP DFOTA 应用说明； 2. 删 除 中 国 电 信 物 联 网 平 台 DFOTA 详 细 说 明 ， 移 至 Quectel_BC260Y-CN(R02)_中国电信物联网平台应用指导。 3. 删 除 中 国 移 动 OneNET 平 台 DFOTA 详 细 说 明 ， 移 至 Quectel_BC260Y-CN_OneNET_应用指导。 上海移远通信技术股份有限公司 2 / 28 BC260Y-CN DFOTA 应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................3 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 引言.....................................................................................................................................................7 1.1. AT 命令说明..............................................................................................................................7 1.1.1. 定义 ...............................................................................................................................7 1.1.2. AT 命令语句 ..................................................................................................................7 1.2. AT 示例声明..............................................................................................................................8 2 CoAP DFOTA .....................................................................................................................................9 2.1. CoAP DFOTA 升级流程 ............................................................................................................9 2.1.1. 获取差分包...................................................................................................................10 2.1.2. 上传差分包至 CoAP 服务器 .........................................................................................10 2.1.3. 检查网络状况 ...............................................................................................................10 2.1.4. 执行 AT 命令升级固件 ..................................................................................................10 2.2. CoAP DFOTA 命令详解 .......................................................................................................... 11 3 HTTP DFOTA ...................................................................................................................................13 3.1. HTTP DFOTA 升级流程 ..........................................................................................................13 3.1.1. 获取差分包...................................................................................................................14 3.1.2. 上传差分包至 HTTP 服务器 .........................................................................................14 3.1.3. 检查网络状况 ...............................................................................................................14 3.1.4. 执行 AT 命令升级固件 ..................................................................................................14 3.2. HTTP DFOTA 命令详解 ..........................................................................................................15 4 中国电信物联网平台 DFOTA.............................................................................................................17 5 中国移动 OneNET 平台 DFOTA .......................................................................................................18 6 DFOTA 相关 URC .............................................................................................................................19 6.1. +QIND: 'FOTA','COAPSTART' CoAP 开始下载差分包.......................................................19 6.2. +QIND: 'FOTA','COAPEND', CoAP 差分包下载结果 ............................................19 6.3. +QIND: 'FOTA','HTTPSTART' HTTP 开始下载差分包 .......................................................20 6.4. +QIND: 'FOTA','DOWNLOADING', HTTP 差分包下载进度................................20 6.5. +QIND: 'FOTA','HTTPEND' HTTP 差分包下载结果 ...........................................................20 6.6. +QIND: 'FOTA','START' 开始固件升级...............................................................................21 6.7. +QIND: 'FOTA','UPDATING' 固件升级进度........................................................................21 6.8. +QIND: 'FOTA','END' 固件升级结果 ..................................................................................21 6.9. +QIND: 'FOTA','NOTSUPPORT' 协议不支持.....................................................................22 7 举例...................................................................................................................................................23 7.1. CoAP DFOTA 升级固件实例 ...................................................................................................23 7.2. HTTP DFOTA 升级固件实例 ...................................................................................................24 上海移远通信技术股份有限公司 3 / 28 BC260Y-CN DFOTA 应用指导 8 结果码 ...............................................................................................................................................26 9 附录 A 参考文档及术语缩写 .............................................................................................................27 上海移远通信技术股份有限公司 4 / 28 BC260Y-CN DFOTA 应用指导 表格索引 表 1：AT 命令类型..................................................................................................................................... 8 表 2：查询网络状态命令列表 .................................................................................................................. 10 表 3：查询网络状态命令列表 .................................................................................................................. 14 表 4：升级相关 URC ............................................................................................................................... 19 表 5：结果码 ............................................................................................................................ 26 表 6：结果码 .................................................................................................................. 26 表 7：参考文档........................................................................................................................................ 27 表 8：术语缩写........................................................................................................................................ 27 上海移远通信技术股份有限公司 5 / 28 BC260Y-CN DFOTA 应用指导 图片索引 图 1：CoAP DFOTA 固件升级流程............................................................................................................ 9 图 2：HTTP DFOTA 固件升级流程.......................................................................................................... 13 上海移远通信技术股份有限公司 6 / 28 BC260Y-CN DFOTA 应用指导 1 引言 移远通信 BC260Y-CN 模块支持固件空中差分升级（DFOTA）功能，此功能可以实现模块固件包的无 线升级或降级。基于 DFOTA，用户通过差分包即可实现固件升级或降级。所述差分包仅包含当前固件版本 和目标固件版本之间的差异，因此大大降低了数据传输量、极大地缩短了传输时间。 本文档主要介绍了如何通过 DFOTA 功能对 BC260Y-CN 模块进行的固件升、降级。BC260Y-CN 模块 的 DFOTA 功能可以通过 AT 命令主动触发升级，基于 CoAP 或 HTTP 协议下载差分数据，也可以通过已对 接的 LwM2M 平台触发升级。目前模块支持通过中国电信 IoT/AEP 平台和中国移动 OneNET 平台进行 DFOTA 升级。 备注 1. R01 和 R02 固件是属于不同基线的固件版本，不可进行 DFOTA 互升。 2. R01 和 R02 固件指固件版本号中含有'R01'或'R02'的固件版本，如'BC260YCN…R01…'和 'BC260YCN…R02…'。 1.1. AT 命令说明 1.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 上海移远通信技术股份有限公司 7 / 28 BC260Y-CN DFOTA 应用指导 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 1.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系 或连续性。 上海移远通信技术股份有限公司 8 / 28 BC260Y-CN DFOTA 应用指导 2 CoAP DFOTA 2.1. CoAP DFOTA 升级流程 下图阐述了当差分包储存在 CoAP 服务器上时，通过 CoAP 协议下载差分包并升级固件的流程。 2. 将差分包放在 C oAP服务 器上 CoAP 服务 器 1. 获取差分包 NB-IoT CoAP 4. 通过NB-IoT网络从CoAP 服务 器自动 下载差 分包 外部 MCU 3. 查询网络状态， 执行AT+QFOTADL命令 移远通信 模块 5. 自动升级模块 固件 图 1：CoAP DFOTA 固件升级流程 如上图所示，通过 DFOTA 升级固件的步骤为： 第一步：从移远通信获取差分包； 第二步：将差分包传至 CoAP 服务器； 上海移远通信技术股份有限公司 9 / 28 BC260Y-CN DFOTA 应用指导 第三步：检查网络状态是否正常； 第四步：确认网络状态正常后，执行 AT+QFOTADL 命令。（模块通过 NB-IoT 网络从 CoAP 服务器下 载差分包，即上图中的步骤 4。下载成功后，将自动升级模块固件，即上图中的步骤 5）。 CoAP DFOTA 升级固件实例，请参考第 7.1 章。有关通过 AT+QFOTADL 命令进行 CoAP DFOTA 的 详细信息，请参考第 2.2 章。 2.1.1. 获取差分包 升级之前，用户需先通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和 目标版本信息发送给移远通信或模块供应商以获取相应的差分包。 2.1.2. 上传差分包至 CoAP 服务器 用户需自建 CoAP 服务器以便 DFOTA 功能的使用。完成服务器建立之后，需将差分包存储至服务器 并 记 录 下 存 储 路 径 （ URL ）。 通 过 AT+QFOTADL 进 行 差 分 包 下 载 时 需 要 使 用 正 确 的 URL ， 执 行 AT+QFOTADL 后，模块将自动从此路径下载差分包。 2.1.3. 检查网络状况 模块开机后，开始升级之前，请确认模块已注网。相关的 AT 命令如下表所示。 表 2：查询网络状态命令列表 序号 [1] [2] [3] [4] AT 命令 AT+CESQ AT+CEREG? AT+CGATT? AT+CGPADDR? 描述 查询信号质量 查询注网状态 查询 EPS 附着状态 查询 PDN 分配的 IP 地址 有关上述命令的更多详细信息，请参阅文档 [3]。 2.1.4. 执行 AT 命令升级固件 确认网络状态后，执行 AT+QFOTADL 命令，随后模块将从 CoAP 服务器下载差分包并自动升级固件。 上海移远通信技术股份有限公司 10 / 28 BC260Y-CN DFOTA 应用指导 2.2. CoAP DFOTA 命令详解 AT+QFOTADL 用于启动模块通过 DFOTA 自动进行固件升级。执行此命令后，模块将自动从 CoAP 服 务器下载差分包，差分包下载完成之后，模块会自动升级固件。如果固件升级成功，模块会自动重启；否则 会上报错误并退出 DFOTA 模式。 差分包被储存至 CoAP 服务器后，执行 AT+QFOTADL=命令启动模块通过 DFOTA 自动进行固 件升级。命令执行成功后，模块将自动从 CoAP 服务器下载差分包，并自动进行固件升级。 AT+QFOTADL 启动 DFOTA 固件升级（CoAP） 测试命令 响应 AT+QFOTADL=? +QFOTADL= 设置命令 AT+QFOTADL= OK 响应 OK +QIND: 'FOTA','COAPSTART' +QIND: 'FOTA','COAPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',,, +QIND: 'FOTA','UPDATING',,, ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效。 参数配置深休眠唤醒后无效，不保存到 NVRAM。 上海移远通信技术股份有限公司 11 / 28 参数 BC260Y-CN DFOTA 应用指导 字符串类型。最大长度为 255 字节。以'COAP://'开头，格式如下：'COAP://:/'。 字符串。CoAP 服务器的 IP 地址或域名。 整型。CoAP 服务器的端口号。范围：1~65535；默认值：80。 字符串。CoAP 服务器中的文件名。 整型。下载结果码。 0 下载完成 其他值 下载失败。相关详细信息，请参阅第 8 章。 整型。百分比形式的升级进度。 整型。需要升级的程序总数。当前恒为 1。 整型。当前已升级和正在升级的程序数之和。当前恒为 1。 整型。升级结果码。 0 升级成功 其他值 升级失败。相关详细信息，请参阅第 8 章。 备注 1. 若模块处于升级状态时（即在上报 +QIND: 'FOTA','UPDATING',,, 状态时）断电，则下次开机时将自动进入强制升级模式，并从断电前的升级进度继续升级。 模块开机后会自动上报如下所示的 URC： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', ,1,1 +QIND: 'FOTA','UPDATING', ,1,1 ... +QIND: 'FOTA','END', 2. 升级前请确认模块是否处于自适应波特率模式；若处于自适应波特率模式，升级结束后，串口波特率 未同步之前，模块不会输出升级结果码 URC；用户需主动通过 ATI 命令查询当前固件版本以确认升 级是否成功。因此，建议在升级前通过 AT+IPR 命令固定波特率，详情请参考文档 [3]。 上海移远通信技术股份有限公司 12 / 28 BC260Y-CN DFOTA 应用指导 3 HTTP DFOTA 3.1. HTTP DFOTA 升级流程 下图阐述了通过 HTTP 下载通道，进行 DFOTA 的流程。 2. 将差分包放在HTTP 服务 器上 HTTP 服务 器 1. 获取差分包 NB-IoT (HTTP) 4. 通过NB-IoT网络从HTTP 服务 器自动 下载差 分包 外部 MCU 3. 查询网络状态， 执行 AT+QFO TADL 命令 移远通信 模块 5. 自动升级模块 固件 图 2：HTTP DFOTA 固件升级流程 如上图所示，通过 DFOTA 方式升级固件的步骤为： 第一步：从移远通信获取差分包； 第二步：将差分包放到 HTTP 服务器； 上海移远通信技术股份有限公司 13 / 28 BC260Y-CN DFOTA 应用指导 第三步：检查网络状态是否正常； 第四步：确认网络状态正常后，执行 AT+QFOTADL 命令。（模块通过 NB-IoT 网络从 HTTP 服务器下 载差分包，即上图中的步骤 4。下载成功后，将自动升级模块固件，即上图中的步骤 5）。 HTTP DFOTA 升级固件实例，请参考第 7.2 章。有关通过 AT+QFOTADL 命令进行 HTTP DFOTA 的 详细信息，请参考第 3.2 章。 3.1.1. 获取差分包 升级之前，用户需先通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和 目标版本信息发送给移远通信或模块供应商以获取相应的差分包。 3.1.2. 上传差分包至 HTTP 服务器 用户需自建 HTTP 服务器以便 DFOTA 功能的使用。完成服务器建立之后，需将差分包存储至服务器 并 记 录 下 存 储 路 径 （ URL ）。 通 过 AT+QFOTADL 进 行 差 分 包 下 载 时 需 要 使 用 正 确 的 URL ， 执 行 AT+QFOTADL 后，模块将自动从此路径下载差分包。 3.1.3. 检查网络状况 模块开机后，开始升级之前，请确认模块已注网。相关的 AT 命令如下： 表 3：查询网络状态命令列表 序号 [1] [2] [3] [4] AT 命令 AT+CESQ AT+CEREG? AT+CGATT? AT+CGPADDR? 描述 查询信号质量 查询注网状态 查询 EPS 附着状态 查询为 PDN 分配的 IP 地址 有关上述命令的更多详细信息，请参阅文档 [3]。 3.1.4. 执行 AT 命令升级固件 确认网络状态后，执行 AT+QFOTADL 命令，随后模块将从 HTTP 服务器下载差分包并自动升级固件。 上海移远通信技术股份有限公司 14 / 28 BC260Y-CN DFOTA 应用指导 3.2. HTTP DFOTA 命令详解 AT+QFOTADL 用于启动模块通过 DFOTA 自动进行固件升级。执行此命令后，模块将自动从 HTTP 服 务器下载差分包，差分包下载完成之后，模块会自动升级固件。如果固件升级成功，模块会自动重启；否则 会上报错误并退出 DFOTA 模式。 差分包被储存至 HTTP 服务器后，执行 AT+QFOTADL=命令启动模块通过 DFOTA 自动进行固 件升级。命令执行成功后，模块将自动从 HTTP 服务器下载差分包，并自动进行固件升级。 AT+QFOTADL 启动 DFOTA 固件升级（HTTP） 测试命令 响应 AT+QFOTADL=? +QFOTADL= 设置命令 AT+QFOTADL= OK 响应 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',,, +QIND: 'FOTA','UPDATING',,, ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效。 参数配置深休眠唤醒后无效，不保存到 NVRAM。 上海移远通信技术股份有限公司 15 / 28 参数 BC260Y-CN DFOTA 应用指导 字符串类型。最大长度为 255 字节。以'HTTP://'开头，格式如下：'HTTP://:/'。 字符串。HTTP 服务器的 IP 地址或域名。 整型。HTTP 服务器的端口号。范围：1~65535；默认值：80。 字符串。HTTP 服务器中的文件名。 整型。下载结果码。 0 下载完成 其他值 下载失败。相关详细信息，请参阅第 8 章。 整型。百分比形式的下载或升级进度。 整型。需要升级的程序总数；当前恒为 1。 整型。当前已升级和正在升级的程序数之和；当前恒为 1。 整型。升级结果码。 0 升级成功 其他值 升级失败。相关详细信息，请参阅第 8 章。 备注 1. 若模块处于升级状态时（即在上报 +QIND: 'FOTA','UPDATING',,, 状态时）断电，则下次开机时将自动进入强制升级模式，并从断电前的升级进度继续升级。 模块开机后会自动上报如下所示的 URC： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', ,1,1 +QIND: 'FOTA','UPDATING', ,1,1 ... +QIND: 'FOTA','END', 2. 升级前请确认模块是否处于自适应波特率模式；若处于自适应波特率模式，升级结束后，串口波特率 未同步之前，模块不会输出升级结果码 URC；用户需主动通过 ATI 命令查询当前固件版本以确认升 级是否成功。因此，建议在升级前通过 AT+IPR 命令固定波特率，详情请参考文档 [3]。 3. 模块暂不支持 HTTPS。 上海移远通信技术股份有限公司 16 / 28 BC260Y-CN DFOTA 应用指导 4 中国电信物联网平台 DFOTA 中国电信物联网平台，包含'中国电信物联网开放平台-连接管理子系统'（简称'电信 IoT 平台'） 和'CTWing 中国电信物联网开放平台'（简称'电信 AEP 平台'），详细应用流程，请参考文档 [1]。 上海移远通信技术股份有限公司 17 / 28 BC260Y-CN DFOTA 应用指导 5 中国移动 OneNET 平台 DFOTA BC260Y-CN 模块也可通过中国移动 OneNET 平台的固件升级功能进行 DFOTA 升级，详细流程及注 意事项请参考文档文档 [2]。 上海移远通信技术股份有限公司 18 / 28 BC260Y-CN DFOTA 应用指导 6 DFOTA 相关 URC 表 4：升级相关 URC 索引 [1] [2] [3] [4] [5] [6] [7] [8] [9] URC 描述 +QIND: 'FOTA','COAPSTART' CoAP 开始下载差分包 +QIND: 'FOTA','COAPEND', CoAP 差分包下载结果 +QIND: 'FOTA','HTTPSTART' HTTP 开始下载差分包 +QIND: 'FOTA','DOWNLOADING' HTTP 下载差分包进度 +QIND: 'FOTA','HTTPEND', HTTP 差分包下载结果 +QIND: 'FOTA','START' 开始固件升级 +QIND: 'FOTA','UPDATING',,, +QIND: 'FOTA','END', 固件升级结果 +QIND: 'FOTA','NOTSUPPORT' 不支持该协议 6.1. +QIND: 'FOTA','COAPSTART' CoAP 开始下载差分包 +QIND: 'FOTA','COAPSTART' CoAP 开始下载差分包 +QIND: 'FOTA','COAPSTART' 通知 TE CoAP 开始下载差分包 6.2. +QIND: 'FOTA','COAPEND', CoAP 差分包下载结果 +QIND: 'FOTA','COAPEND' CoAP 差分包下载结果 +QIND: 'FOTA','COAPEND', 通知 TE CoAP 差分包下载结果 上海移远通信技术股份有限公司 19 / 28 参数 整型。下载结果码。 0 下载完成 其他值 下载失败，具体请参考第 8 章。 BC260Y-CN DFOTA 应用指导 6.3. +QIND: 'FOTA','HTTPSTART' HTTP 开始下载差分包 +QIND: 'FOTA','HTTPSTART' HTTP 开始下载差分包 +QIND: 'FOTA','HTTPSTART' 通知 TE HTTP 开始下载差分包 6.4. +QIND: 'FOTA','DOWNLOADING', HTTP 差分包下载进度 +QIND: 'FOTA','HTTPEND' HTTP 差分包下载进度 +QIND: 'FOTA','DOWNLOADING ', 通知 TE HTTP 差分包下载进度 参数 整型。百分比形式的下载进度 6.5. +QIND: 'FOTA','HTTPEND' HTTP 差分包下载结果 +QIND: 'FOTA','HTTPEND' HTTP 差分包下载结果 +QIND: 'FOTA','HTTPEND', 通知 TE HTTP 差分包下载结果 参数 整型。下载结果码。 0 下载完成 其他值 下载失败，具体请参考第 8 章。 上海移远通信技术股份有限公司 20 / 28 6.6. +QIND: 'FOTA','START' 开始固件升级 +QIND: 'FOTA','START' 开始固件升级 +QIND: 'FOTA','START' 通知 TE 固件升级开始 BC260Y-CN DFOTA 应用指导 6.7. +QIND: 'FOTA','UPDATING' 固件升级进度 +QIND: 'FOTA','UPDATING' 固件升级进度 +QIND: 'FOTA','UPDATING',,, 参数 整型。百分比形式的升级进度。 整型。需要升级的程序总数；当前恒为 1。 整型。当前已升级和正在升级的程序数之和；当前恒为 1。 6.8. +QIND: 'FOTA','END' 固件升级结果 +QIND: 'FOTA','END' 固件升级结果 +QIND: 'FOTA','END', 通知 TE 固件升级结果 参数 整型。升级结果。 0 升级成功 其他值 升级失败，详情请参考第 8 章。 上海移远通信技术股份有限公司 21 / 28 BC260Y-CN DFOTA 应用指导 6.9. +QIND: 'FOTA','NOTSUPPORT' 协议不支持 +QIND: 'FOTA','NOTSUPPORT' 协议不支持 +QIND: 'FOTA','NOTSUPPORT' 通知 TE 不支持该协议 上海移远通信技术股份有限公司 22 / 28 BC260Y-CN DFOTA 应用指导 7 举例 7.1. CoAP DFOTA 升级固件实例 //差分包已上传至 CoAP 服务器，地址为 'coap://www.quectel.com:100/update.zip'。 AT+CESQ //查询扩展信号质量 +CESQ: 99,99,255,255,23,49 OK AT+CEREG? +CEREG: 0,1 //查询 EPS 网络注册状态。 //已注册到网络。 OK AT+CPIN? +CPIN: READY //查询 PIN。 //SIM 卡初始化完成。 OK AT+CGPADDR? +CGPADDR: 0,'100.125.10.122' //查询是否获取到 IP 地址。 //已获取到 IP 地址。 OK //执行 AT+QFOTADL 命令以使能模块通过 DFOTA 自动升级固件，随后模块自动下载差分包并升级固件。 AT+QFOTADL='coap://www.quectel.com:100/update.zip' //指定 CoAP 服务器地址 OK +QIND: 'FOTA','COAPSTART' +QIND: 'FOTA','COAPEND',0 //开始下载差分包。 //下载差分包完成。 +QIND: 'FOTA','START' //固件升级开始。 +QIND: 'FOTA','UPDATING',3%,1,1 //升级进度。 +QIND: 'FOTA','UPDATING',5%,1,1 …… 上海移远通信技术股份有限公司 23 / 28 +QIND: 'FOTA','UPDATING',100%,1,1 RDY +CFUN: 1 +QIND: 'FOTA','END',0 //升级成功。 +CPIN: READY +IP: 100.75.72.128 BC260Y-CN DFOTA 应用指导 7.2. HTTP DFOTA 升级固件实例 //差分包已上传至 HTTP 服务器，地址为'http://www.quectel.com:100/update.zip'。 AT+CESQ //查询扩展信号质量 +CESQ: 99,99,255,255,23,49 OK AT+CEREG? +CEREG: 0,1 //查询 EPS 网络注册状态。 //已注册到网络。 OK AT+CPIN? +CPIN: READY //查询 PIN。 //SIM 卡初始化完成。 OK AT+CGPADDR? +CGPADDR: 0,'100.125.10.122' //查询是否获取到 IP 地址。 //已获取到 IP 地址。 OK //执行 AT+QFOTADL 命令以使能模块通过 DFOTA 自动升级固件，随后模块自动下载差分包并升级固件。 AT+QFOTADL='http://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSTART' //开始下载差分包。 +QIND: 'FOTA','DOWNLOADING',1% +QIND: 'FOTA','DOWNLOADING',2% 上海移远通信技术股份有限公司 24 / 28 …… +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 //下载差分包完成。 +QIND: 'FOTA','START' //固件升级开始。 +QIND: 'FOTA','UPDATING',3%,1,1 //升级进度。 +QIND: 'FOTA','UPDATING',5%,1,1 …… +QIND: 'FOTA','UPDATING',100%,1,1 RDY +CFUN: 1 +QIND: 'FOTA','END',0 //升级成功。 +CPIN: READY +IP: 100.75.72.128 BC260Y-CN DFOTA 应用指导 上海移远通信技术股份有限公司 25 / 28 BC260Y-CN DFOTA 应用指导 8 结果码 本章介绍了与和相关的结果码。详细信息，请参阅下表。 表 5：结果码 值 0 1 2 12 13 99 100 101 描述 Downloaded successfully Unknown error DNS resolution error Download failed Network deactivated Network unavailable Flash write error Flash not enough 中文含义 下载成功 未知错误 DNS 解析错误 下载失败 网络已去激活 网络不可用 Flash 写入错误 Flash 空间不足 表 6：结果码 值 0 255 描述 Upgraded successfully Delta firmware package invalid 中文含义 升级成功 差分包无效 上海移远通信技术股份有限公司 26 / 28 BC260Y-CN DFOTA 应用指导 9 附录 A 参考文档及术语缩写 表 7：参考文档 序号 文件名称 [1] Quectel_BC260Y-CN(R02)_中国电信物联网平台应用指导 [2] Quectel_BC260Y-CN_OneNET_应用指导 [3] Quectel_BC260-CN_AT 命令手册 备注 BC260-CN 中国电信物联网平台 应用指导 BC260-CN OneNET 应用指导 BC260-CN AT 命令手册 表 8：术语缩写 术语 AEP CoAP DFOTA EPS HTTP HTTPS IMEI IoT IP LwM2M MCU NB-IoT 英文全称 中文全称 Application Enablement Platform 应用支持平台 Constrained Application Protocol 受限应用协议 Delta Firmware Upgrade Over-the-Air 固件空中差分升级 Evolved Packet System 演进型分组系统 Hypertext Transfer Protocol 超文本传输协议 Hypertext Transfer Protocol (Secure/over 超文本传输安全协议 Secure Socket Layer) International Mobile Equipment Identity 国际移动设备识别码 Internet of Things 物联网 Internet Protocol 网络协议 Lightweight Machine to Machine 轻量级物联网协议 Microcontroller Unit 微控制单元 Narrow Band Internet of Things 窄带物联网 上海移远通信技术股份有限公司 27 / 28 PDN TE URC URL Public Data Network Terminal Equipment Unsolicited Result Code Uniform Resource Locator BC260Y-CN DFOTA 应用指导 公用数据网 终端设备 未经请求的结果代码 统一资源定位器 上海移远通信技术股份有限公司 28 / 28

BC260Y-CN (R01) LwM2M 应用指导 NB-IoT 模块系列 版本：1.2 日期：2021-06-21 状态：受控文件 BC260Y-CN (R01) LwM2M 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司不 承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功能 错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的使 用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任何 因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权使 用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追究 法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 89 BC260Y-CN (R01) LwM2M 应用指导 文档历史 修订记录 版本 日期 - 2020-07-31 1.0 2020-09-27 1.1 2021-04-22 1.2 2021-06-21 作者 Albert ZHANG/ Taber JIANG Albert ZHANG/ Taber JIANG Jack QIAN/ Albert ZHANG Koala LI 变更表述 文档创建 受控版本 1. 添加中国电信物联网平台 DFOTA 说明章节。 2. 更新 AT+QLACONFIG 和 AT+QLACFG 部分参数说明 （第 2.1 章、第 2.2 章）。 3. 添加仅 R01 固件适用备注（第 1 章），更新文档名称。 1. 更新 AT+QLACFG 参数说明（第 2.2 章）。 2. 添加使用标准 LwM2M 协议对接中国联通雁飞·格物 DMP 平台指导章节（第 5.5 章）。 上海移远通信技术股份有限公司 2 / 89 BC260Y-CN (R01) LwM2M 应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................3 表格索引 ..................................................................................................................................................... 6 图片索引 ..................................................................................................................................................... 7 1 引言.....................................................................................................................................................9 1.1. AT 命令说明..............................................................................................................................9 1.1.1. 定义 ...............................................................................................................................9 1.1.2. AT 命令语句 ..................................................................................................................9 1.2. AT 示例声明............................................................................................................................10 2 AT 命令详解 ......................................................................................................................................11 2.1. AT+QLACONFIG 配置注册参数 ........................................................................................... 11 2.2. AT+QLACFG 配置可选注册参数 ..........................................................................................12 2.3. AT+QLAREG 发送注册请求 .................................................................................................16 2.4. AT+QLAUPDATE 发送更新请求...........................................................................................17 2.5. AT+QLADEREG 发送注销请求 ............................................................................................18 2.6. AT+QLAADDOBJ 添加 LwM2M 对象 ...................................................................................19 2.7. AT+QLADELOBJ 删除 LwM2M 对象....................................................................................20 2.8. AT+QLARDRSP 响应读请求 ................................................................................................21 2.9. AT+QLAWRRSP 响应写请求 ...............................................................................................23 2.10. AT+QLAEXERSP 响应执行请求 ..........................................................................................24 2.11. AT+QLAOBSRSP 响应订阅请求 ..........................................................................................25 2.12. AT+QLANOTIFY 上报被订阅资源的数据 .............................................................................27 2.13. AT+QLASENDDATA 直接发送数据 ......................................................................................28 2.14. AT+QLASTATUS 查询当前 LwM2M 状态 .............................................................................30 3 LwM2M 相关 URC ............................................................................................................................31 3.1. +QLAURC: 'ping' 生命周期更新结果通知............................................................................32 3.2. +QLAURC: 'observe' 服务器订阅请求通知 .........................................................................32 3.3. +QLAURC: 'write' 服务器写请求通知 ..................................................................................32 3.4. +QLAURC: 'read' 服务器读请求通知...................................................................................33 3.5. +QLAURC: 'execute' 服务器执行请求通知..........................................................................34 3.6. +QLAURC: 'bs_finished' LwM2M 引导服务器引导阶段完成通知 ........................................34 3.7. +QLAURC: 'report' CON 类型数据已发送通知 ....................................................................34 3.8. +QLAURC: 'report_ack' 收到 CON 类型数据包应答的通知.................................................35 3.9. +QLAURC: 'send_ack' 收到 CON 类型数据包应答的通知 ..................................................35 3.10. +QLAURC: 'lifetime_changed' 生命周期更改通知...............................................................35 3.11. +QLAURC: 'binding_changed' 绑定模式更改通知 ..............................................................36 3.12. +QLAURC: 'recovered' LwM2M 会话恢复结果通知 ............................................................36 3.13. +QLAURC: 'lw_event' LwM2M 其他事件通知 .....................................................................37 4 中国电信物联网平台 DFOTA.............................................................................................................38 4.1. 中国电信 AEP 平台 DFOTA ....................................................................................................38 上海移远通信技术股份有限公司 3 / 89 BC260Y-CN (R01) LwM2M 应用指导 4.1.1. AEP 平台 DFOTA 升级流程 .........................................................................................38 4.1.1.1. 下载阶段........................................................................................................... 40 4.1.1.2. 升级阶段........................................................................................................... 40 4.1.1.3. 升级后阶段 ....................................................................................................... 40 4.1.2. AEP 平台 DFOTA 注意事项 .........................................................................................40 4.1.2.1. 注意事项........................................................................................................... 40 4.1.2.2. 升级 URC 与异常处理 ...................................................................................... 41 4.2. 中国电信 IoT 平台 DFOTA ......................................................................................................41 4.2.1. 中国电信 IoT 平台 DFOTA 升级流程 ............................................................................42 4.2.1.1. 下载阶段........................................................................................................... 44 4.2.1.2. 升级阶段........................................................................................................... 44 4.2.1.3. 升级后阶段 ....................................................................................................... 44 4.2.2. IoT 平台 DFOTA 注意事项 ...........................................................................................44 4.2.2.1. 注意事项........................................................................................................... 44 4.2.2.2. 升级 URC 与异常处理 ...................................................................................... 45 4.3. 中国电信物联网平台 DFOTA 相关的 URC ..............................................................................45 4.3.1. +QIND: 'FOTA','COAPSTART' 开始下载固件..........................................................45 4.3.2. +QIND: 'FOTA','COAPEND', 固件下载结果 ...............................................46 4.3.3. +QIND: 'FOTA','START' 开始固件升级 ....................................................................46 4.3.4. +QIND: 'FOTA','UPDATING', 固件升级进度 ............................................46 4.3.5. +QIND: 'FOTA','END', 固件升级结果 ...............................................47 5 举例...................................................................................................................................................48 5.1. 初始化工作 .............................................................................................................................48 5.2. 使用标准 LwM2M 协议对接中国电信 IoT 平台 ........................................................................49 5.2.1. 平台侧配置...................................................................................................................49 5.2.1.1. 创建设备........................................................................................................... 49 5.2.1.2. 在线调试........................................................................................................... 51 5.2.2. 模块侧对接平台 AT 命令示例 .......................................................................................52 5.3. 使用标准 LwM2M 协议对接中国电信 AEP 平台 ......................................................................54 5.3.1. 平台侧配置...................................................................................................................54 5.3.1.1. 产品创建........................................................................................................... 54 5.3.1.2. 设备添加........................................................................................................... 56 5.3.1.3. 设备激活后对象操作......................................................................................... 56 5.3.2. 模块侧对接平台的 AT 命令示例....................................................................................57 5.4. 使用标准 LwM2M 协议对接中国移动 Andlink 平台 .................................................................59 5.4.1. 平台侧配置...................................................................................................................59 5.4.2. 模块侧对接平台的 AT 命令示例....................................................................................59 5.5. 使用标准 LwM2M 协议对接中国联通雁飞·格物 DMP 平台......................................................61 5.5.1. 平台侧配置...................................................................................................................61 5.5.1.1. 产品创建........................................................................................................... 61 5.5.1.2. 物模型定义 ....................................................................................................... 62 5.5.1.3. 物模型配置 ....................................................................................................... 65 5.5.1.4. 设备添加........................................................................................................... 66 5.5.1.5. 设备激活后对象操作......................................................................................... 67 上海移远通信技术股份有限公司 4 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.5.2. 模块侧对接平台 AT 命令示例 .......................................................................................68 5.6. 中国电信 AEP 平台 DFOTA 实例 ............................................................................................69 5.6.1. 上传差分包到平台 ........................................................................................................69 5.6.2. 创建 DFOTA 任务.........................................................................................................70 5.6.3. 添加升级设备 ...............................................................................................................71 5.6.4. 设备升级 ......................................................................................................................72 5.6.5. 重新注册设备 ...............................................................................................................74 5.7. 中国电信 IoT 平台 DFOTA 实例 ..............................................................................................74 5.7.1. DFOTA 能力配置..........................................................................................................74 5.7.2. 生成公私密钥 ...............................................................................................................76 5.7.3. 制作固件升级包............................................................................................................79 5.7.4. 上传固件升级包............................................................................................................80 5.7.5. 配置平台升级任务 ........................................................................................................81 5.7.6. 设备升级 ......................................................................................................................84 5.7.7. 重新注册设备 ...............................................................................................................86 6 结果码 ...............................................................................................................................................87 7 附录 参考文档及术语缩写.................................................................................................................88 上海移远通信技术股份有限公司 5 / 89 BC260Y-CN (R01) LwM2M 应用指导 表格索引 表 1：AT 命令类型..................................................................................................................................... 9 表 2：LwM2M 相关的 URC ..................................................................................................................... 31 表 3：升级 URC 与异常处理.................................................................................................................... 41 表 4：平台相关 URC ............................................................................................................................... 45 表 5：概要 ........................................................................................................................ 87 表 6：参考文档........................................................................................................................................ 88 表 7：术语缩写........................................................................................................................................ 88 上海移远通信技术股份有限公司 6 / 89 BC260Y-CN (R01) LwM2M 应用指导 图片索引 图 1：中国电信 AEP 平台 DFOTA 交互图 ............................................................................................... 39 图 2：中国电信 IoT 平台 DFOTA 交互图 ................................................................................................. 43 图 3：新建产品........................................................................................................................................ 49 图 4：自定义产品 .................................................................................................................................... 49 图 5：填写创建产品的信息 ...................................................................................................................... 50 图 6：定义 Profile .................................................................................................................................... 50 图 7：开发编码器插件 ............................................................................................................................. 51 图 8：选择在线调测................................................................................................................................. 51 图 9：模拟设备接入 IoT........................................................................................................................... 52 图 10：中国 AEP 平台首页...................................................................................................................... 54 图 11：产品中心 - 创建产品 ................................................................................................................... 55 图 12：创建产品 - 编辑产品配置............................................................................................................ 55 图 13：添加设备...................................................................................................................................... 56 图 14：查看 Object.................................................................................................................................. 56 图 15：查看 Object 日志.......................................................................................................................... 57 图 16：中国联通雁飞·格物 DMP 平台界面 ............................................................................................ 61 图 17：产品中心·创建产品 .................................................................................................................... 61 图 18：创建产品·产品配置 .................................................................................................................... 62 图 19：产品中心·查看 ........................................................................................................................... 62 图 20：产品中心·功能定义 .................................................................................................................... 63 图 21：编辑物模型 .................................................................................................................................. 63 图 22：添加自定义功能 ........................................................................................................................... 64 图 23：发布物模型 .................................................................................................................................. 64 图 24：物模型配置 .................................................................................................................................. 65 图 25：添加对象定义............................................................................................................................... 65 图 26：创建设备...................................................................................................................................... 66 图 27：设备参数配置............................................................................................................................... 66 图 28：设备查看...................................................................................................................................... 67 图 29：设备数据查看............................................................................................................................... 67 图 30：数据下发...................................................................................................................................... 68 图 31：DFOTA 选择固件管理 .................................................................................................................. 69 图 32：创建固件版本............................................................................................................................... 70 图 33：选择创建任务............................................................................................................................... 70 图 34：创建升级任务............................................................................................................................... 71 图 35：选择升级设备管理........................................................................................................................ 71 图 36：选择升级设备............................................................................................................................... 72 图 37：启动升级...................................................................................................................................... 72 图 38：AEP 平台升级结果....................................................................................................................... 74 图 39：应用属性页 .................................................................................................................................. 76 图 40：管理页面...................................................................................................................................... 76 图 41：下载签名工具............................................................................................................................... 76 上海移远通信技术股份有限公司 7 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 42：生成公私密钥............................................................................................................................... 77 图 43：公钥上传步骤 1............................................................................................................................ 78 图 44：公钥上传步骤 2............................................................................................................................ 78 图 45：公钥上传步骤 3............................................................................................................................ 78 图 46：差分固件升级包数据签名步骤...................................................................................................... 79 图 47：添加固件包页面 ........................................................................................................................... 80 图 48：上传签名差分固件升级包至中国 IoT 平台 .................................................................................... 80 图 49：添加设备到默认群组步骤 1 .......................................................................................................... 81 图 50：添加设备到默认群组步骤 2 .......................................................................................................... 81 图 51：默认群组绑定完成........................................................................................................................ 82 图 52：创建批量任务页面........................................................................................................................ 82 图 53：创建批量升级任务........................................................................................................................ 83 图 54：设置升级任务参数........................................................................................................................ 83 图 55：选择升级群组............................................................................................................................... 84 图 56：中国电信 IoT 平台升级结果 ......................................................................................................... 86 上海移远通信技术股份有限公司 8 / 89 BC260Y-CN (R01) LwM2M 应用指导 1 引言 本文档主要介绍如何通过 AT 命令使用移远通信 BC260Y-CN 模块的 LwM2M 协议功能。 备注 1. 本文档仅适用于 R01 固件的 BC260YCNAAR01A02 及之后版本的 BC260Y-CN 模块；R02 固件不支 持本文档所述标准 LwM2M 命令。 2. R01 和 R02 固件指固件版本号中含有'R01'或'R02'的固件版本，如'BC260YCN…R01…'和 'BC260YCN…R02…'。 1.1. AT 命令说明 1.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 上海移远通信技术股份有限公司 9 / 89 BC260Y-CN (R01) LwM2M 应用指导 查询命令 设置命令 执行命令 AT+? 查询相应设置命令的当前参数值。 AT+=[,[,[...]]] 设置用户可定义的参数值。 AT+ 返回特定的参数信息或执行特定的操作。 1.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 10 / 89 BC260Y-CN (R01) LwM2M 应用指导 2 AT 命令详解 本章节介绍了 BC260Y-CN 模块与 LwM2M 功能相关的 AT 命令。 2.1. AT+QLACONFIG 配置注册参数 该命令用于配置 LwM2M 客户端的注册参数。 AT+QLACONFIG 配置注册参数 查询命令 AT+QLACONFIG? 响应 当=0 且配置了相应的 LwM2M 工作 服务器信息时，或当=1 且成功下发 LwM2M 工作服务器信息时： +QLACONFIG: 0,,,,,[,,], OK 设置命令 AT+QLACONFIG=,,,,,[,,[,binding_m ode]] 若未作任何配置，或当=1 但未下发 LwM2M 工作服务器信息时： OK 响应 OK 若有参数错误或当前 LwM2M 状态并非未注册： ERROR 最大响应时间 5秒 特性说明 该命令立即生效。 若使用 LwM2M 工作服务器，深休眠唤醒后有效，参数 配置自动保存； 若使用 LwM2M 引导服务器，参数配置不保存。 上海移远通信技术股份有限公司 11 / 89 BC260Y-CN (R01) LwM2M 应用指导 参数 整型。是否使用 LwM2M 引导服务器。 0 使用 LwM2M 工作服务器 1 使用 LwM2M 引导服务器 字符串类型。LwM2M 服务器的 IP 地址或域名。最大长度：150 字节。 整型。LwM2M 服务器的端口号。范围：0~65535。 字符串类型。设备的端点名称。最大长度：150 字节。 整型。注册的生命周期。范围：20~31536000（365 天）；单位：秒。 如果 ≤ 30 秒，则实际更新间隔 = /2 如果 ≤ 50 秒，则实际更新间隔 = 15 + ( - 30) × 3/4 如果 ≤ 100 秒，则实际更新间隔 = 30 + ( - 50) × 4/5 如果 ≤ 300 秒，则实际更新间隔 = 70 + ( - 100) × 9/10 如果 > 300 秒，则实际更新间隔 = 250 + ( - 300) × 19/20 当实际更新间隔计时器超时，模块将自动上报数据，更新并重置注册的生命周期。 整型。加密模式。 0 DTLS 预共享密钥加密模式 3 非加密模式 字符串类型。预共享密钥标识符。最大长度：150 字节。仅在=0 时有效。 字符串类型。预共享密钥。最大长度：256 字节。仅在=0 时有 效。 整型。为 LwM2M 客户端配置的传输绑定模式。 0 UDP 模式 1 UDP & Queue 模式 备注 1. 若将配置为 LwM2M 引导服务器（即=1），模块不会保存 LwM2M 引导服务器信息，仅保存 LwM2M 引导服务器成功引导分配的工作服务器信息。 2. 若重新配置注册参数，模块会按照新配置的注册参数进行注册或引导注册。 3. 参数为 0 时会增加模块功耗，如无特殊要求，不推荐配置=0。 4. 有关 LwM2M 状态详情，请参考 AT+QLASTATUS 命令。 2.2. AT+QLACFG 配置可选注册参数 该命令用于配置可选注册参数。 AT+QLACFG 配置可选注册参数 查询命令 响应 AT+QLACFG? +QLACFG: 'retransmit',, +QLACFG: 'auto_ack', +QLACFG: 'platform', +QLACFG:'cfg_res',,,, +QLACFG: 'lifetime_enable', +QLACFG: 'dtls_mode', +QLACFG: 'dtls_version', 设置命令 配置响应超时时间和最大重传次数 AT+QLACFG='retransmit'[,,] OK 响应 若省略可选参数，则查询当前配置的响应超时时间和重传最大次 数： +QLACFG: 'retransmit',, OK 若指定可选参数，则配置响应超时时间和重传最大次数： OK 设置命令 配置是否启动平台订阅时自动应答 AT+QLACFG='auto_ack'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前是否启动平台订阅时自动应答： +QLACFG: 'auto_ack', OK 若指定可选参数，则配置是否启动平台订阅时自动应答： OK 设置命令 配置需要连接的目标 IoT 平台 AT+QLACFG='platform'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前连接的物联网平台： +QLACFG: 'platform', OK 若指定可选参数，则配置连接的目标 IoT 平台： OK 若有任何错误： 上海移远通信技术股份有限公司 13 / 89 BC260Y-CN (R01) LwM2M 应用指导 ERROR 设置命令 配置定制化对象资源的值 AT+QLACFG='cfg_res'[,, ,, ] 响应 若省略可选参数，则查询当前定制化对象资源的值： +QLACFG: 'cfg_res',,,, OK 若指定可选参数，则配置定制化对象资源的值： OK 设置命令 配置是否启用自动发送更新请求功能 AT+QLACFG='lifetime_enable'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前是否启用自动发送更新请求功能： +QLACFG: 'lifetime_enable', OK 若指定可选参数，则配置是否启用自动发送更新请求功能： OK 设置命令 配置从深休眠唤醒后模块恢复 LwM2M 会话时的 DTLS 握手模式 AT+QLACFG='dtls_mode'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前从深休眠唤醒后模块恢复 LwM2M 会话时的 DTLS 握手模式： +QLACFG: 'dtls_mode', OK 若指定可选参数，则配置从深休眠唤醒后模块恢复 LwM2M 会话 时的 DTLS 握手模式： OK 设置命令 配置 DTLS 握手时的协议版本号 AT+QLACFG='dtls_version'[,] 若出现参数错误或者当前 LwM2M 状态并非未注册： ERROR 响应 若省略可选参数，则查询 DTLS 握手时的协议版本号： +QLACFG: 'dtls_version', OK 上海移远通信技术股份有限公司 14 / 89 BC260Y-CN (R01) LwM2M 应用指导 最大响应时间 特性说明 若指定可选参数，则配置 DTLS 握手时的协议版本号： OK 若有参数错误或者当前 LwM2M 状态并非未注册： ERROR 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存。 参数 整型。响应超时时间。范围：2~20；默认值：4；单位：秒。每次重传或检测间 隔时间 = × 2(NT-1)，'NT'是总的传输次数。 整型。最大重传次数。范围：0~8；默认值：4。 整型。启动/禁止平台订阅时自动应答，自动应答信息中不包含被订阅资源的具 体值。 0 禁止 1 启动 整型。要连接的目标物联网平台。 0 中国电信 IoT 平台 1 中国电信 AEP 平台或中国联通雁飞·格物 DMP 平台 2 中国移动 Andlink 平台 整型。LwM2M 协议支持的对象 ID。范围：0~65535。 整型。LwM2M 协议支持的实例 ID。范围：0~65535。 整型。LwM2M 协议支持的资源 ID。范围：0~65535。 字符串类型。对应 LwM2M 协议支持的的数据。 整型。是否启用自动更新生命周期请求的功能。 0 禁用 1 启用 整型。从深休眠唤醒后模块恢复 LwM2M 会话时的 DTLS 握手模式。 0 使用 DTLS 完整流程握手 1 使用 DTLS 会话恢复（Session Resumption）流程握手 整型。DTLS 版本号。 0 使用 DTLS 1.0 版本握手 1 使用 DTLS 1.2 版本握手 2 版本号通过握手与服务器协商 备注 连接中国移动 Andlink 平台时，需要通过 AT+QLACFG='cfg_res',3,0,17,配置产品 ID，非 Andlink 平台无须关注此命令。 上海移远通信技术股份有限公司 15 / 89 举例 AT+QLACFG='retransmit',4,5 OK AT+QLACFG='platform',2 OK AT+QLACFG='cfg_res',3,0,17,'500677' OK AT+QLACFG='auto_ack',1 OK AT+QLACFG='lifetime_enable',1 OK AT+QLACFG='dtls_mode',0 OK AT+QLACFG='dtls_version',1 OK BC260Y-CN (R01) LwM2M 应用指导 2.3. AT+QLAREG 发送注册请求 该命令用于向物联网平台发送注册请求。 AT+QLAREG 发送注册请求 执行命令 响应 AT+QLAREG OK +QLAREG: 最大响应时间 特性说明 若有参数错误或者当前 LwM2M 状态不是'未注册'时错误： ERROR 5秒 / 参数 整型。结果码。相关详情请参阅第 6 章。 举例 AT+QLAREG OK 上海移远通信技术股份有限公司 16 / 89 +QLAREG: 0 BC260Y-CN (R01) LwM2M 应用指导 //成功注册到物联网平台。 2.4. AT+QLAUPDATE 发送更新请求 该命令用于向物联网平台发送更新请求。 AT+QLAUPDATE 发送更新请求 设置命令 AT+QLAUPDATE=,/ [,] 响应 OK +QLAUPDATE: , 最大响应时间 特性说明 若有任何错误： ERROR 5秒 该命令立即生效（实际是否生效取决于网络）。 深休眠唤醒后有效；参数配置自动保存。 参数 整型。操作选项。 0 生命周期 1 传输绑定模式 整型。注册的生命周期。范围：20~31536000（365 天）；默认值：86400；单位： 秒。该参数仅在=0 时才有效。 如果 ≤ 30 秒，则实际更新间隔 = /2 如果 ≤ 50 秒，则实际更新间隔 = 15 + ( - 30) × 3/4 如果 ≤ 100 秒，则实际更新间隔 = 30 + ( - 50) × 4/5 如果 ≤ 300 秒，则实际更新间隔 = 70 + ( - 100) × 9/10 如果 > 300 秒，则实际更新间隔 = 250 + ( - 300) × 19/20 当实际更新间隔计时器超时，模块将自动上报数据，更新并重置注册生命周期。 整型。为 LwM2M 客户端配置的传输绑定模式。该参数仅在=1 时才有效。 0 UDP 模式 1 UDP & Queue 模式 整型。消息传输携带的快速释放标记 RAI。该标记用于指示核心网如何释放与模块 的 RRC 连接。 0 无标记 1 该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。消息 ID。 上海移远通信技术股份有限公司 17 / 89 BC260Y-CN (R01) LwM2M 应用指导 整型。结果码。相关详情请参阅第 6 章。 备注 执行 AT+QLAUPDATE 时，若距离上一次成功更新时的时间差超过平台已经接受的注册生命周期 （），则该命令将返回 ERROR。因此，建议在注册生命周期到期前进行更新操作（仅在禁用 自动发送更新请求功能（AT+QLACFG='lifetime_enable',0）下有效）。 举例 AT+QLAUPDATE=0,1000 OK +QLAUPDATE: 0,59797 //更新生命周期。 //更新成功。 2.5. AT+QLADEREG 发送注销请求 该命令用于向物联网平台发起注销请求。 AT+QLADEREG 发送注销请求 执行命令 响应 AT+QLADEREG OK +QLADEREG: 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。结果码。有关详情请参阅第 6 章。 举例 AT+QLADEREG OK //发送注销请求。 上海移远通信技术股份有限公司 18 / 89 +QLADEREG: 0 //注销成功。 BC260Y-CN (R01) LwM2M 应用指导 2.6. AT+QLAADDOBJ 添加 LwM2M 对象 该命令用于添加 LwM2M 对象（Object），并通知平台。 AT+QLAADDOBJ 添加 LwM2M 对象 查询命令 响应 AT+QLAADDOBJ? +QLAADDOBJ: ,,,[,,…] […] OK 设置命令 AT+QLAADDOBJ=,,,[,,…] 若有任何错误： ERROR 响应 OK 如果成功注册到平台，则继续返回： +QLAADDOBJ: 最大响应时间 特性说明 若有任何错误： ERROR 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置自动保存。 参数 整型。LwM2M 协议支持的对象 ID。范围：0~65535。 整型。LwM2M 协议支持的实例 ID。范围：0~65535。 整型。资源数量。 整型。LwM2M 协议支持的资源 ID。范围：0~65535。 整型。结果码。有关详情请参阅第 6 章。 备注 1. 目前最多可自定义 3 个对象，每个对象最多定义 4 个实例，每个实例最多定义 14 个资源。 2. 目前模块默认支持的内置对象有 0/1/3/4/5，模块会自动添加所述对象。因此，不需要通过此命令进 上海移远通信技术股份有限公司 19 / 89 BC260Y-CN (R01) LwM2M 应用指导 行添加订阅。 3. 该命令可以在模块注册到物联网平台之前或之后使用，不支持'注册中'使用。 举例 AT+QLAADDOBJ=19,1,1,0 OK +QLAADDOBJ: 0 AT+QLAADDOBJ=19,0,4,0,1,2,3 OK +QLAADDOBJ: 0 AT+QLAADDOBJ? +QLAADDOBJ: 19,1,1,0 +QLAADDOBJ: 19,0,4,0,1,2,3 OK 2.7. AT+QLADELOBJ 删除 LwM2M 对象 该命令用于删除 LwM2M 对象（Object），并通知物联网平台。 AT+QLADELOBJ 删除 LwM2M 对象 设置命令 响应 AT+QLADELOBJ= OK 如果成功注册到平台，则继续返回： +QLADELOBJ: 最大响应时间 特性说明 如有任何错误： ERROR 5秒 / 参数 整型。LwM2M 协议支持的对象 ID。范围：0~65535。 整型。结果码。有关详情请参阅第 6 章。 上海移远通信技术股份有限公司 20 / 89 BC260Y-CN (R01) LwM2M 应用指导 举例 AT+QLADELOBJ=17 OK +QLADELOBJ: 0 //删除对象 17。 备注 1. 该命令可以在模块注册到物联网平台之前或之后使用，不支持注册中使用。 2. 对于未添加的通用 LwM2M 对象，模块不支持删除。若删除此类对象，可能导致模块报错。 2.8. AT+QLARDRSP 响应读请求 该命令用于响应来自 LwM2M 服务器的读请求。 AT+QLARDRSP 响应读请求 设置命令 响应 AT+QLARDRSP=,,,,,,,,[,] OK +QLARDRSP: 若有任何错误： ERROR 最大响应时间 5秒 特性说明 / 参数 整型。消息 ID，来自 URC +QLAURC: 'read'。 整型。读取操作的结果码。结果码详情如下： 结果码 CoAP响应码 描述 1 2.05 内容，表示正确的结果。 11 4.00 错误请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 15 4.06 未接受 整型。对象 ID，来自 URC +QLAURC: 'read'。 整型。实例 ID，来自 URC +QLAURC: 'read'。 上海移远通信技术股份有限公司 21 / 89 BC260Y-CN (R01) LwM2M 应用指导 整型。资源 ID，来自 URC +QLAURC: 'read'。 整型。值的类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 3 Integer（整型） 4 Float（浮点型） 5 Boolean（布尔型） 整型。值的长度。 当=1 时，该参数值为字符串类型的长度。范围：0~1024。 当=2 时，该参数值为十六进制字符串类型的长度。范围：0~512。 当=3 时，该参数值可能为 2、4 或者 8。 当=4 时，该参数值为 4。 当=5 时，该参数值为 1。 字符串类型。对应 LwM2M 协议支持的的数据。 当=1 时，该参数值为带双引号的字符串类型格式。最大长度：1024 字节。 当=2 时，该参数值为十六进制字符串格式。最大长度：512 字节。 当=3 时，该参数值为整型格式。 当=4 时，该参数值为浮点型格式。 当=5 时，该参数值为布尔型格式，值为 0（FALSE）或者 1（TRUE）。 整型。的索引号。若读取请求响应包含多条消息，则需发送多次 AT 命令以完成 响应。例如，若读取请求响应包含 N 条消息，则参数需从 N-1 到 0 依次递减， AT 命令按照取值从大到小的顺序执行。=0 表示数据中最后一条消息。 整型。消息传输携带的快速释放标记 RAI，该标记用于指示核心网如何释放与模块的 RRC 连接。范围：0~2。 0 无标记 1 该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。结果码。有关详情请参阅第 6 章。 备注 1. 该命令只能响应服务器下发的读请求所通知的消息。 2. 已经响应成功的消息，不允许重复响应。 举例 +QLAURC: 'read',62953,19,0,0 //接收到来自服务器的读请求。 AT+QLARDRSP=62953,1,19,0,0,1,5,'abcde',0 OK +QLARDRSP: 0 上海移远通信技术股份有限公司 22 / 89 BC260Y-CN (R01) LwM2M 应用指导 2.9. AT+QLAWRRSP 响应写请求 该命令用于响应来自服务器的写请求。 AT+QLAWRRSP 响应写请求 设置命令 AT+QLAWRRSP=,[,] 响应 OK +QLAWRRSP: 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。消息 ID，来自 URC +QLAURC: 'write'。 整型。写入操作的结果码。结果码详情如下： 结果码 CoAP 响应码 描述 2 2.04 已更改，表示正确的结果 11 4.00 错误请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 整型。消息传输携带的快速释放标记 RAI。该标记用于指示核心网如何释放与模块的 RRC 连接。 0 无标记 1 该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。结果码。有关详情请参阅第 6 章。 备注 1. 该命令只能响应服务器下发的写请求所通知的消息。 2. 已经响应成功的消息，不允许重复响应。 举例 +QLAURC: 'write',36560,19,0,0,2,7,'5155454354454C',0 //接收到来自服务器的写请求。 AT+QLAWRRSP=36560,2 上海移远通信技术股份有限公司 23 / 89 OK +QLAWRRSP: 0 BC260Y-CN (R01) LwM2M 应用指导 2.10. AT+QLAEXERSP 响应执行请求 该命令用于响应服务器的执行请求。 AT+QLAEXERSP 响应执行请求 设置命令 AT+QLAEXERSP=,[,] 响应 OK +QLAEXERSP: 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。消息 ID，来自 URC +QLAURC: 'execute'。 整型。执行操作的结果码。结果码详情如下： 结果码 CoAP 响应码 描述 2 2.04 已更改，表示正确的结果 11 4.00 错误请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 整型。消息传输携带的快速释放标记 RAI，该标记用于指示核心网如何释放与模块的 RRC 连接。 0 无标记 1 该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。结果码。有关详情请参阅第 6 章。 备注 1. 该命令只能响应服务器下发的执行请求所通知的消息。 2. 已经响应成功的消息，不允许重复响应。 上海移远通信技术股份有限公司 24 / 89 举例 +QLAURC: 'execute',39040,15,0,5 AT+QLAEXERSP=39040,2 OK +QLAEXERSP: 0 BC260Y-CN (R01) LwM2M 应用指导 //接收到来自服务器的执行请求。 2.11. AT+QLAOBSRSP 响应订阅请求 该命令用于响应服务器的订阅请求。 AT+QLAOBSRSP 响应订阅请求 设置命令 AT+QLAOBSRSP=,,,,,,,,[,] 最大响应时间 响应 OK +QLAOBSRSP: 若有任何错误： ERROR 5秒 特性说明 响应订阅请求成功后，订阅信息深休眠仍有效，但掉电不保存。 参数 整型。消息 ID，来自 URC +QLAURC: 'observe'。 整型。订阅操作的结果码。结果码详情如下： 结果码 CoAP响应码 描述 1 2.05 内容，表示正确的结果。 11 4.00 错误请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 15 4.06 未接受 整型。对象 ID，来自 URC +QLAURC: 'observe'。 整型。实例 ID，来自 URC +QLAURC: 'observe'。 整型。资源 ID，来自 URC +QLAURC: 'observe'。 整型。值的类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 3 Integer（整型） 上海移远通信技术股份有限公司 25 / 89 BC260Y-CN (R01) LwM2M 应用指导 4 Float（浮点型） 5 Boolean（布尔型） 整型。值的长度。 当=1 时，该参数值为字符串类型的长度。范围：0~1024。 当=2 时，该参数值为十六进制字符串类型的长度。范围：0~512。 当=3 时，该参数值可能为 2、4 或者 8。 当=4 时，该参数值为 4。 当=5 时，该参数值为 1。 字符串类型。对应 LwM2M 协议支持的的数据。 当=1 时，该参数值为带双引号的字符串类型格式。最大长度：1024 字节。 当=2 时，该参数值为十六进制字符串格式。最大长度：512 字节。 当=3 时，该参数值为整型格式。 当=4 时，该参数值为浮点型格式。 当=5 时，该参数值为布尔型格式，值为 0（FALSE）或者 1（TRUE）。 整型。的索引号。若读取请求响应包含多条消息，则需发送多次 AT 命令以完成 响应。例如，若读取请求响应包含 N 条消息，则参数需从 N-1 到 0 依次递减， AT 命令按照取值从大到小的顺序执行。=0 表示数据中最后一条消息。 整型。消息传输携带的快速释放标记 RAI。该标记用于指示核心网如何释放与模块的 RRC 连接。 0 无标记 1 该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。结果码。有关详情请参阅第 6 章。 备注 1. 该命令只能响应服务器下发的订阅请求所通知的消息。 2. 已经响应成功的消息，不允许重复响应。 举例 +QLAURC: 'observe',624,0,9,0,0 AT+QLAOBSRSP=624,1,9,0,0,1,5,'abcde',0 OK +QLAOBSRSP: 0 //接收来自服务器的订阅请求。 //响应订阅请求。 上海移远通信技术股份有限公司 26 / 89 BC260Y-CN (R01) LwM2M 应用指导 2.12. AT+QLANOTIFY 上报被订阅资源的数据 该命令用于上报被订阅资源的数据。 AT+QLANOTIFY 上报被订阅资源的数据 设置命令 AT+QLANOTIFY=,,,,, ,[,[,]] 响应 若=0，即发送 NON 类型的数据时： OK +QLANOTIFY: 若=1，即发送 CON 类型的数据时： OK +QLAURC: 'report', +QLANOTIFY: +QLAURC: 'report_ack',, 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。LwM2M 协议支持的对象 ID。范围：0~65535。 整型。LwM2M 协议支持的实例 ID。范围：0~65535。 整型。LwM2M 协议支持的资源 ID。范围：0~65535。 整型。值的类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 3 Integer（整型） 4 Float（浮点型） 5 Boolean（布尔型） 整型。值的长度。 当=1 时，该参数值为字符串类型的长度。范围：0~1024。 当=2 时，该参数值为十六进制字符串类型的长度。范围：0~512。 当=3 时，该参数值可能为 2、4 或者 8。 当=4 时，该参数值为 4。 上海移远通信技术股份有限公司 27 / 89 BC260Y-CN (R01) LwM2M 应用指导 当=5 时，该参数值为 1。 字符串类型。对应 LwM2M 协议支持的的数据。 当=1 时，该参数值为带双引号的字符串类型格式。最大长度：1024 字节。 当=2 时，该参数值为十六进制字符串格式。最大长度：512 字节。 当=3 时，该参数值为整型格式。 当=4 时，该参数值为浮点型格式。 当=5 时，该参数值为布尔型格式，值为 0（FALSE）或者 1（TRUE）。 整型。的索引号。若读取请求响应包含多条消息，则需发送多次 AT 命令以完成 响应。例如，若读取请求响应包含 N 条消息，则参数需从 N-1 到 0 依次递减， AT 命令按照取值从大到小的顺序执行。=0 表示数据中最后一条消息。 整型。响应类型标记。 0 NON 类型的数据 1 CON 类型的数据 整型。消息传输携带的快速释放标记 RAI。该标记用于指示核心网如何释放与模块的 RRC 连接。 0 无标记 1 该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。消息 ID。 整型。结果码。有关详情请参阅第 6 章。 备注 1. 该命令不支持未订阅的资源数据上报。 2. 当为 1 时，必须使用双引号（''）将待发送数据包括起来，且发送的数据长 度需要和保持一致。 2.13. AT+QLASENDDATA 直接发送数据 该命令用于直接向已注册的服务器发送数据（需要服务器支持）。 AT+QLASENDDATA 直接发送数据 设置命令 AT+QLASENDDATA=,,[,[,]] 响应 若=0，即发送 NON 类型的数据时： OK +QLASENDDATA: , 若=1，即发送 CON 类型的数据时： OK 上海移远通信技术股份有限公司 28 / 89 最大响应时间 特性说明 BC260Y-CN (R01) LwM2M 应用指导 +QLASENDDATA: , +QLAURC: 'send_ack',, 若有参数错误： ERROR 5秒 / 参数 整型。值的类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 整型。值的长度。 当=1 时，为字符数。最大长度：1024 字节。 当=2 时，为该值中字符长度的一半。最大长度：512 字节。 字符串类型。对应 LwM2M 协议支持的的数据。 当=1 时，该参数值为带双引号的字符串类型格式。最大长度：1024 字节。 当=2 时，该参数值为十六进制字符串类型格式。最大长度：512 字节。 整型。响应类型标记。 0 NON 类型的数据 1 CON 类型的数据 整型。消息传输携带的快速释放标记 RAI。该标记用于指示核心网如何释放与模块的 RRC 连接。 0 无标记 1 该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 整型。消息 ID。 整型。结果码。有关详情请参阅第 6 章。 备注 1. 目前，该命令仅适用于中国移动 Andlink 平台。 2. 当为 1 时，必须使用双引号（''）将待发送数据包括起来，且发送的数据长 度需要和保持一致。 上海移远通信技术股份有限公司 29 / 89 BC260Y-CN (R01) LwM2M 应用指导 2.14. AT+QLASTATUS 查询当前 LwM2M 状态 该命令用于查询当前 LwM2M 状态。 AT+QLASTATUS 查询当前 LwM2M 状态 查询命令 响应 AT+QLASTATUS? +QLASTATUS: OK 最大响应时间 特性说明 若有任何错误： ERROR 5秒 / 参数 整型。LwM2M 状态。 0 未注册 1 注册中 2 已注册 3 注销中 4 已注销 5 无效 6 正在恢复 LwM2M 会话 7 需要恢复 LwM2M 会话 上海移远通信技术股份有限公司 30 / 89 BC260Y-CN (R01) LwM2M 应用指导 3 LwM2M 相关 URC 本章提供与 LwM2M 相关的 URC 及其说明。 表 2：LwM2M 相关的 URC 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] URC 描述 +QLAURC: 'ping', 通知 TE 生命周期的定期更新结果 +QLAURC: 'observe',,,,, +QLAURC: 'write',,,,,,,, +QLAURC: 'read',,,,[,] +QLAURC: 'execute',,,, +QLAURC: 'bs_finished' 通知 TE 收到服务器的订阅请求 通知 TE 收到服务器的写请求 通知 TE 收到服务器的读请求 通知 TE 收到服务器的执行请求 通知 TE LwM2M 引导服务器引导阶段 已完成 +QLAURC: 'report', 通知 TE CON 类型数据已发送 +QLAURC: 'report_ack',, +QLAURC: 'send_ack',, 通知 TE CON 类型数据已被确认 通知 TE 收到 CON 类型数据包的应答 +QLAURC: 'lifetime_changed', 通知 TE 生命周期已更改 +QLAURC: 'binding_changed', +QLAURC: 'recovered', +QLAURC: 'lw_event',,, 通知 TE 绑定模式已更改 通知 TE 深休眠唤醒后的 LwM2M 会话 恢复结果 通知 TE 收到 LwM2M 其他事件 上海移远通信技术股份有限公司 31 / 89 BC260Y-CN (R01) LwM2M 应用指导 3.1. +QLAURC: 'ping' 生命周期更新结果通知 +QLAURC: 'ping' 生命周期更新结果通知 +QLAURC: 'ping', 通知 TE 生命周期的定期更新结果。 参数 整型。结果码。有关详情请参阅第 6 章。 3.2. +QLAURC: 'observe' 服务器订阅请求通知 +QLAURC: 'observe' 服务器订阅请求通知 +QLAURC: 'observe',, 通知 TE，LwM2M 客户端服务器发出订阅请求，TE 应使用 ,,, 参数 整型。消息 ID。 整型。指示是否订阅。 0 订阅 1 取消订阅 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 3.3. +QLAURC: 'write' 服务器写请求通知 +QLAURC: 'write' 服务器写请求通知 +QLAURC: 'write',,,,,,,, 上海移远通信技术股份有限公司 32 / 89 BC260Y-CN (R01) LwM2M 应用指导 参数 整型。消息 ID。 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 整型。值的类型（当前仅显示为非透明数据类型）。 1 字符串类型 2 非透明数据类型 3 整型 4 浮点型 5 布尔型 整型。值的长度。 当=1 时，为字符数。最大长度：1024 字节。 当=2 时，为该值中字符长度的一半。最大长度：512 字节。 当=3 时，为字符数。 当=4 时，为字符数。 当=5 时，为 1。 字符串类型。从服务器接收的值（十六进制）。 整型。写请求的索引号。若写请求由多条消息组成，则应将其拆分为多个部分。假设将 其拆分为 N 个部分，则取值按从 N-1 到 0 降序排列，并且 URC 按照所述从大 到小的编号顺序排序。如果=0，则表示这是写请求的最后一条消息。当前仅支 持=0。 3.4. +QLAURC: 'read' 服务器读请求通知 +QLAURC: 'read' 服务器读请求通知 +QLAURC: 'read',,,,[,] 参数 整型。消息 ID。 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 字符串类型。平台下发请求的标识，表示该请求的参数内容是否需要单独响应。若下发 的 URC 中含此参数，则需响应对应的参数内容。 上海移远通信技术股份有限公司 33 / 89 BC260Y-CN (R01) LwM2M 应用指导 3.5. +QLAURC: 'execute' 服务器执行请求通知 +QLAURC: 'execute' 服务器执行请求通知 +QLAURC: 'execute',, 通知 TE，LwM2M 客户端收到服务器的执行请求，TE 应通过 ,, AT+QLAEXERSP 响应该请求。 参数 整型。消息 ID。 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 3.6. +QLAURC: 'bs_finished' LwM2M 引导服务器引导阶段完成通知 +QLAURC: 'bs_finished' LwM2M 引导服务器引导阶段完成通知 +QLAURC: 'bs_finished' 通知 TE，LwM2M 引导服务器引导阶段已完成。 3.7. +QLAURC: 'report' CON 类型数据已发送通知 +QLAURC: 'report' CON 类型数据已发送通知 +QLAURC: 'report', 通知 TE CON 类型数据包已发送。 参数 整型。消息 ID。 上海移远通信技术股份有限公司 34 / 89 BC260Y-CN (R01) LwM2M 应用指导 3.8. +QLAURC: 'report_ack' 收到 CON 类型数据包应答的通知 +QLAURC: 'report_ack' 收到 CON 类型数据包应答的通知 +QLAURC: 'report_ack',, 使用 AT+QLANOTIFY 发送 CON 类型数据时，LwM2M 工作 服务器通知 TE 收到 CON 类型数据包的应答。此时，可确定服 务器已经收到对应的数据包。 参数 整型。消息 ID。 整型。结果码。有关详情请参阅第 6 章。 3.9. +QLAURC: 'send_ack' 收到 CON 类型数据包应答的通知 +QLAURC: 'send_ack' 收到 CON 类型数据包应答的通知 +QLAURC: 'send_ack',, 使用 AT+QLASENDDATA 发送 CON 类型数据时，LwM2M 工 作服务器通知 TE 收到 CON 类型数据包的应答。此时，可确定 服务器已经收到对应的数据包。 参数 整型。消息 ID。 整型。结果码。有关详情请参阅第 6 章。 3.10. +QLAURC: 'lifetime_changed' 生命周期更改通知 +QLAURC: 'lifetime_changed' 生命周期更改通知 +QLAURC: 'lifetime_changed', 通知 TE，LwM2M 客户端的生命周期（）值已 更改。 参数 整型。注册的生命周期。范围：20~31536000（365 天）；单位：秒。 如果 ≤ 30 秒，则实际更新间隔 = /2 上海移远通信技术股份有限公司 35 / 89 BC260Y-CN (R01) LwM2M 应用指导 如果 ≤ 50 秒，则实际更新间隔 = 15 + ( - 30) × 3/4 如果 ≤ 100 秒，则实际更新间隔 = 30 + ( - 50) × 4/5 如果 ≤ 300 秒，则实际更新间隔 = 70 + ( - 100) × 9/10 如果 > 300 秒，则实际更新间隔 = 250 + ( - 300) × 19/20 当实际更新间隔计时器超时，模块将自动上报数据，更新并重置注册的生命周期。 3.11. +QLAURC: 'binding_changed' 绑定模式更改通知 +QLAURC: 'binding_changed' 绑定模式更改通知 +QLAURC: 'binding_changed',<bin 通知 TE，LwM2M 客户端的值已更改。 ding_mode> 参数 字符串类型。LwM2M 客户端配置的传输绑定模式。 'U' UDP 模式 'UQ' UDP & Queue 模式 3.12. +QLAURC: 'recovered' LwM2M 会话恢复结果通知 +QLAURC: 'recovered' LwM2M 会话恢复结果通知 +QLAURC: 'recovered', 被唤醒，LwM2M 客户端默认会自动恢复会话。此通知告知 TE 恢复的结果。 参数 整型。结果码。有关详情请参阅第 6 章。 上海移远通信技术股份有限公司 36 / 89 BC260Y-CN (R01) LwM2M 应用指导 3.13. +QLAURC: 'lw_event' LwM2M 其他事件通知 当平台下发 RST 应答，模块会使用此 URC 通知 TE。 +QLAURC: 'lw_event' LwM2M 其他事件通知 +QLAURC: 'lw_event',,, 参数 整型。事件的类型。当前仅为 0。 0 收到平台下发的 RST 应答 整型。信息类型。当前固定为 5，即 RST 消息。 整型。消息 ID。 上海移远通信技术股份有限公司 37 / 89 BC260Y-CN (R01) LwM2M 应用指导 4 中国电信物联网平台 DFOTA BC260Y-CN 模块可基于已对接的 LwM2M 平台进行 DFOTA 升级，目前支持中国电信物联网平台 1)。 备注 1) 本文档中所述中国电信物联网平台，包含'中国电信物联网开放平台-连接管理子系统'（本文简称'电 信 IoT 平台'）和'CTWing 中国电信物联网开放平台'（本文简称'电信 AEP 平台'）。 4.1. 中国电信 AEP 平台 DFOTA 本章主要描述如何通过 CTWing 中国电信物联网开放平台（中国电信 AEP 平台）的 DFOTA 功能对移 远通信 BC260Y-CN 模块进行升级及相关注意事项。 备注 有关中国电信 AEP 平台的详细信息，请访问地址 https://www.ctwing.cn/。 4.1.1. AEP 平台 DFOTA 升级流程 AEP 平台 DFOTA 流程如下： 第一步：上传差分包到 AEP 平台 第二步：创建 DFOTA 任务 第三步：添加升级设备 第四步：设备升级 第五步：重新注册设备 各步骤详细操作实例请参考第 5.6 章。 上海移远通信技术股份有限公司 38 / 89 BC260Y-CN (R01) LwM2M 应用指导 MCU NB-IoT模块 AEP平台 AT+QLAREG +QLAREG: 0 +QLAURC: 'observe' AT+QLAOBSRSP 配置平台固件升级任务 POST (register) ACK Get /19/0/0 (observe) ACK Get /3/0/3 ACK /3/0/3(value 当前版本号) Get /5/0/3 ACK /5/0/3(value 0) Get /5/0/3 (observe) ACK /5/0/3(value 0) +QIND: 'FOTA','COAPSTART' 开始下载 AT+QSCLK=0(防止模块进入休眠) AT+QLAUPDATE=0,86400 (防止升级时lifetime到期) +QLAUPDATE: 0,x PUT /5/0/1(Package URI) ACK Get Block2 Num 0 ACK Notify /5/0/3(value 1) ACK POST (Update) ACK 下载完成 +QIND: 'FOTA','COAPEND',0 Get Block2 Num N ACK Notify /5/0/3(value 2) ACK POST /5/0/2 ACK Notify /5/0/3(value 3) ACK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', x%,x,x +QIND: 'FOTA','END',0 AT+QLAREG +QLAREG: 0 升级 +QLAURC: 'observe' AT+QLAOBSRSP POST (register) ACK Notify /5/0/3 ACK Get /19/0/0 (observe) ACK Get /5/0/5 ACK Get /5/0/3 ACK 图 1：中国电信 AEP 平台 DFOTA 交互图 AEP文件服务器 上海移远通信技术股份有限公司 39 / 89 BC260Y-CN (R01) LwM2M 应用指导 4.1.1.1. 下载阶段 1. 当模块注册平台成功并上行任意数据，平台会感知到模块在线，如果平台有固件升级任务，则会下 发请求查询版本号、小区 ID、信号强度以及升级状态等信息。 2. 如果平台判断可以发起升级，则会订阅资源/5/0/3。订阅成功后下发升级包 URL 给模块。模块状态 从 IDLE 转换成 DOWNLOADING。模块向 MCU 发送+QIND: 'FOTA','COAPSTART，通知 MCU 固件下载任务开始。 3. 模块在 DOWNLOADING 状态会向平台请求升级包数据，如果下载过程中有异常导致下载失败， 升级状态将从 DOWNLOADING 转变到 IDLE，模块也会向终端 MCU 发送+QIND: 'FOTA','CO APEND',（为大于 0 的数字），并通过资源/5/0/3 上报平台。如果正常下载完成， 则向 MCU 发送+QIND: 'FOTA','COAPEND',0，并通过资源/5/0/3 上报平台。 4.1.1.2. 升级阶段 平台收到下载完成的消息后，通过资源/5/0/2 下发升级命令，升级状态由 DOWNLOADED 转换到 UPDATING，模块向终端 MCU 发送+QIND: 'FOTA','START'，并通过资源/5/0/3 上报平台，之后模块自 动重启，开始差分升级。 4.1.1.3. 升级后阶段 差分升级完成后，模块会自动启动，状态由 UPDATING 转换到 IDLE。此时模块会向 MCU 发送+QIND: 'FOTA','END',。当模块正常入网后，MCU 应该使用 AT+QLAREG 命令使模块接入平台， 以便模块上报升级状态。平台通过资源/5/0/5 上报升级结果，并取消订阅资源/5/0/3。终端可以正常进行业 务。 4.1.2. AEP 平台 DFOTA 注意事项 4.1.2.1. 注意事项 ⚫ DFOTA 过程中终端对模块进行断电、重启、休眠等操作，可能会造成模块 DFOTA 失败。DFOTA 过程 中，终端需要终止业务，并且禁止向模块发送非指定 AT 命令。 ⚫ MCU 收到+QIND: 'FOTA','COAPSTART'后，需要使用 AT+QSCLK=0 禁止模块休眠，模块在重启 后会自动恢复允许休眠状态；使用 AT+QLAUPDATE 命令更新一个较长的生命周期（Lifetime，建议设 置为 86400 秒），防止模块在升级时生命周期到期，导致平台判定升级失败。升级完成后，可以再次使 用 AT+QLAUPDATE 命令设置回原有的生命周期值。 ⚫ 模块上报+QIND: 'FOTA','END',后，需要重新注册到平台并完成订阅 object19/0/0 后， 平台才能查询升级结果。 ⚫ 模块不支持 AEP DFOTA 升级重试机制。若在差分升级过程中断电，模块上电后会继续升级；在其他 上海移远通信技术股份有限公司 40 / 89 BC260Y-CN (R01) LwM2M 应用指导 阶段模块（包括下载和下载完成阶段），将恢复 IDLE 状态，不再主动向平台上报 DFOTA 状态。 4.1.2.2. 升级 URC 与异常处理 表 3：升级 URC 与异常处理 升级状态 URC DFOTA 升级终端注意事项 +QIND: 'FOTA','COAPS TART' +QIND: 'FOTA','COAPE ND',0 +QIND: 'FOTA','START' MCU 需保障模块不掉电直到模块上报 +QIND: 'FOTA','COAPEND',（详见第 4.3 章）。最长等待 30 分钟，30 分钟后，若无上报提示，请 重启模块。 MCU 需保障模块不掉电直到模块上报+QIND: 'FOTA','START'消息，最 长等待 1 分钟，1 分钟后，若无上报提示，请重启模块。 MCU 需保障模块不掉电直到模块上报+QIND: 'FOTA','END',（详见第 4.3 章），最长等待 10 分钟，10 分钟后，若无上报提示，请 重启模块，直到模块上报+QIND: 'FOTA','END',。 +QIND: 'FOTA','END',0 升级成功，可进行正常业务。 +QIND: 'FOTA','COAPE ND',（为 大于 0 的数字） +QIND: 'FOTA','END',< upgrade_err>（为大于 0 的数字） 下载失败，可进行正常业务。 升级失败，可进行正常业务。 4.2. 中国电信 IoT 平台 DFOTA 本章节主要描述 BC260Y-CN 模块通过中国电信 IoT 平台的固件升级功能进行升级的主要步骤和注意 事项。 备注 1. 本文档提及的电信 IoT 平台是中国电信物联网开放平台-连接管理子系统，与华为 OceanConnect 平台兼容。使用时需注意平台的版本是否相同。有关中国电信 IoT 平台的详细信息，请访问官方地 址：https://www.ct10649.com/。 2. BC260Y-CN 模块固件版本 BC260YCNAAR01A03 及其之后的版本支持中国电信 IoT 平台 DFOTA。 上海移远通信技术股份有限公司 41 / 89 4.2.1. 中国电信 IoT 平台 DFOTA 升级流程 中国电信 IoT 平台 DFOTA 升级的主要步骤如下： 第一步：DFOTA 能力配置。 第二步：生成公私密钥。 第三步：制作固件升级包。 第四步：上传固件升级包。 第五步：配置平台升级任务。 第六步：设备升级。 第七步：重新注册设备。 各步骤详细操作实例请参考第 5.7 章。 BC260Y-CN (R01) LwM2M 应用指导 上海移远通信技术股份有限公司 42 / 89 BC260Y-CN (R01) LwM2M 应用指导 MCU AT+QLAREG +QLAREG: 0 +QLAURC: 'observe' AT+QLAOBSRSP NB-IoT模块 IoT平台 配置平台固件升级任务 POST (register) ACK Get /19/0/0 (observe) ACK Get /3/0/3 ACK /3/0/3(value 当前版本号) Get /5/0/3 ACK /5/0/3(value 0) Get /5/0/3 (observe) ACK /5/0/3(value 0) +QIND: 'FOTA','COAPSTART' 开始下载 AT+QSCLK=0(防止模块进入休眠) AT+QLAUPDATE=0,86400 (防止升级时lifetime到期) +QLAUPDATE: 0,x PUT /5/0/1(Package URI) ACK Get Block2 Num 0 ACK Notify /5/0/3(value 1) ACK POST (Update) ACK 下载完成 +QIND: 'FOTA','COAPEND',0 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', x%,x,x +QIND: 'FOTA','END',0 AT+QLAREG +QLAREG: 0 升级 +QLAURC: 'observe' AT+QLAOBSRSP Get Block2 Num N ACK Notify /5/0/3(value 2) ACK POST /5/0/2 ACK Notify /5/0/3(value 3) ACK POST (register) ACK Notify /5/0/3(value 0) ACK Get /19/0/0 (observe) ACK Get /5/0/5 ACK (value 1) Get /5/0/3 (observe=1) ACK 图 2：中国电信 IoT 平台 DFOTA 交互图 上海移远通信技术股份有限公司 文件服务器 43 / 89 BC260Y-CN (R01) LwM2M 应用指导 4.2.1.1. 下载阶段 1. 当模块注册平台成功并上行任意数据，平台会感知到模块在线，如果平台有固件升级任务，则会下 发请求查询版本号、小区 ID、信号强度以及升级状态等信息。 2. 如果平台判断可以发起升级，则会订阅资源/5/0/3。订阅成功后下发升级包 URL 给模块。模块状态 从 IDLE 转换成 DOWNLOADING。模块向 MCU 发送+QIND: 'FOTA','COAPSTART'，通知 MCU 固件下载任务开始。 3. 模块在 DOWNLOADING 状态会向平台请求升级包数据。如果下载过程中有异常导致下载失败，升 级状态将从 DOWNLOADING 转变到 IDLE，模块也会向终端 MCU 发送+QIND: 'FOTA','COAP END',（为大于 0 的数字），并通过资源/5/0/3 上报平台。如果下载完成，则向 MCU 发送+QIND: 'FOTA','COAPEND',0，并通过资源/5/0/3 上报平台。 4.2.1.2. 升级阶段 平台收到下载完成的消息后，通过资源/5/0/2 下发升级命令，升级状态由 DOWNLOADED 转换到 UPDATING，模块向终端 MCU 发送+QIND: 'FOTA','START'，并通过资源/5/0/3 上报平台，之后模块将 自动重启，开始差分升级。 4.2.1.3. 升级后阶段 差分升级完成后，模块会自动启动，状态由 UPDATING 转换到 IDLE。此时模块会向 MCU 发送+QIND: 'FOTA','END',。当模块正常入网后，MCU 应该使用 AT+QLAREG 命令使模块接入平台， 以便模块上报升级状态。平台通过资源/5/0/5 升级结果，并取消订阅资源/5/0/3。终端可以正常进行业务。 4.2.2. IoT 平台 DFOTA 注意事项 4.2.2.1. 注意事项 ⚫ 终端注册到平台后并上行一次数据后才会开始 DFOTA 任务。 ⚫ DFOTA 过程中终端对模块进行断电、重启、休眠等操作，可能会造成模块 DFOTA 失败。DFOTA 过程 中，终端需要终止业务，并且禁止向模块发送非指定 AT 命令。 ⚫ MCU 收到+QIND: 'FOTA','COAPSTART'后，需要使用 AT+QSCLK=0 禁止模块休眠，模块在重启 后会自动恢复允许休眠状态；使用 AT+QLAUPDATE 命令更新一个较长的生命周期（Lifetime，建议设 置为 86400 秒），防止模块在升级时生命周期到期，导致平台判定升级失败。升级完成后，可以设置回 原有的生命周期值。 ⚫ 模块上报+QIND: 'FOTA','END',后，需要重新注册到平台并完成订阅 object19/0/0 后， 平台才能查询升级结果。 ⚫ 模块不支持 IoT 平台 DFOTA 升级重试机制。若在差分升级过程中断电，模块上电后会继续升级；在其 上海移远通信技术股份有限公司 44 / 89 BC260Y-CN (R01) LwM2M 应用指导 他阶段模块（包括下载和下载完成阶段），将恢复 IDLE 状态，不再主动向平台上报 DFOTA 状态。 4.2.2.2. 升级 URC 与异常处理 参考第 4.1.2.2 章。 4.3. 中国电信物联网平台 DFOTA 相关的 URC 本章列举了与中国电信物联网平台相关的 URC 及其描述。 表 4：平台相关 URC 索引 URC [1] +QIND: 'FOTA','COAPSTART' [2] +QIND: 'FOTA','COAPEND', [3] +QIND: 'FOTA','START' [4] +QIND: 'FOTA','UPDATING', [5] +QIND: 'FOTA','END', 描述 开始下载固件 固件下载结果 开始固件升级 固件升级进度 固件升级结果 4.3.1. +QIND: 'FOTA','COAPSTART' 开始下载固件 该 URC 指示模块开始固件下载，此时终端 MCU 不可给模块断电，也不可发送数据传输相关的 AT 命 令。 +QIND: 'FOTA','COAPSTART' 开始下载固件 +QIND: 'FOTA','COAPSTART' 指示模块开始固件下载 上海移远通信技术股份有限公司 45 / 89 BC260Y-CN (R01) LwM2M 应用指导 4.3.2. +QIND: 'FOTA','COAPEND', 固件下载结果 该 URC 指示模块固件下载结果。 +QIND: 'FOTA','COAPEND', 固件下载结果 +QIND: 'FOTA','COAPEND', 模块固件下载结果 参数 整型。下载结果。 0 固件包下载成功 1 未知错误 12 下载失败 13 网络已去激活 99 网络不能用 100 Flash 写入错误 101 Flash 空间不足 4.3.3. +QIND: 'FOTA','START' 开始固件升级 该 URC 指示模块开始固件升级。 +QIND: 'FOTA','START' 开始固件升级 +QIND: 'FOTA','START' 表示模块开始固件升级 4.3.4. +QIND: 'FOTA','UPDATING', 固件升级进度 该 URC 指示模块固件升级进度。 +QIND: 'FOTA','UPDATING', 固件升级进度 +QIND: 'FOTA','UPDATING', 表示模块固件升级进度 参数 整型。升级进度（百分比）。 上海移远通信技术股份有限公司 46 / 89 BC260Y-CN (R01) LwM2M 应用指导 4.3.5. +QIND: 'FOTA','END', 固件升级结果 该 URC 指示模块固件升级结果。 +QIND: 'FOTA','END', 固件升级结果 +QIND: 'FOTA','END', 表示模块固件升级结果 参数 整型。升级结果。 0 升级成功 255 升级失败 上海移远通信技术股份有限公司 47 / 89 BC260Y-CN (R01) LwM2M 应用指导 5 举例 5.1. 初始化工作 AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 OK AT+CGPADDR? +CGPADDR: 0,'10.177.135.245' OK //禁用休眠模式。 //查询注网状态。 //找网已成功，若未成功，可多次查询。 //找网成功后，可通过此命令查询模块 PDP 地址。 备注 1. 需 要 使 用 AT+QSCLK=0 禁 用 休 眠 模 式 使 模 块 处 于 工 作 状 态 ； 待 所 有 业 务 完 成 后 ， 再 使 用 AT+QSCLK=1 允许模块进入深休眠模式，以便模块进入深休眠从而降低流耗。详细信息，请参考 文档 [1]。 2. 模块开机后，请参考文档 [2] 检查入网是否成功。 上海移远通信技术股份有限公司 48 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.2. 使用标准 LwM2M 协议对接中国电信 IoT 平台 5.2.1. 平台侧配置 5.2.1.1. 创建设备 1. 登录中国电信 IoT 平台开发中心（https://develop.ct10649.com:8093/#/login），在项目空间内， 依次选择'产品'-->'产品开发'，点击'新建产品'新建一款产品。 图 3：新建产品 2. 在'创建产品'界面，选择'自定义产品'，点击'自定义产品'按钮即可开始自主开发一款产品。 上海移远通信技术股份有限公司 图 4：自定义产品 49 / 89 BC260Y-CN (R01) LwM2M 应用指导 3. 在'设置产品信息'窗口，填写创建产品的信息，完成各参数的配置后，点击'创建'即可创建新 的产品。 图 5：填写创建产品的信息 4. 进入新创建的产品，选择'Profile 定义'。 图 6：定义 Profile 上海移远通信技术股份有限公司 50 / 89 BC260Y-CN (R01) LwM2M 应用指导 5. 选择'编解码插件开发'，根据定义的 Profile 进行插件开发和部署，插件开发完成后点击右上角的 '部署'按钮。 图 7：开发编码器插件 5.2.1.2. 在线调试 在入门阶段，开发者可以使用开发中心的虚拟设备模拟设备接入 IoT 平台的场景。在创建的产品中，选 择'在线调测'。 图 8：选择在线调测 上海移远通信技术股份有限公司 51 / 89 BC260Y-CN (R01) LwM2M 应用指导 选择'在线调测'，进入新增测试设备的弹窗，如下图所示。 图 9：模拟设备接入 IoT 备注 关于 Profile 定义、插件开发以及在线调试的具体操作方式的详细内容，请参考中国电信 IoT 平台的官方文 档（电信 IoT 平台首页→'文档中心'）。 5.2.2. 模块侧对接平台 AT 命令示例 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 //禁用休眠模式。 //查询注网状态。 //找网已成功，若未成功，可多次查询。 OK AT+CGPADDR? +CGPADDR: 0,'10.177.135.245' //找网成功后，可通过此命令查询模块 PDP 地址。 OK AT+QLACFG='platform',0 //配置目标平台为电信 IoT 平台。 OK AT+QLACONFIG=0,'180.101.147.115',5683,'867724030023557',300,3 OK AT+QLAADDOBJ=19,0,1,0 //添加对象 19/0/0。 上海移远通信技术股份有限公司 52 / 89 BC260Y-CN (R01) LwM2M 应用指导 OK AT+QLAADDOBJ=19,1,1,0 OK AT+QLAREG OK //添加对象 19/1/0。 +QLAREG: 0 +QLAURC: 'observe',23618,0,19,0,0 AT+QLAOBSRSP=23618,1,19,0,0,2,9,'020001000400023238',0 OK +QLAOBSRSP: 0 AT+QLANOTIFY=19,0,0,2,9,'020001000400023438',0,0 OK +QLANOTIFY: 0 AT+QLANOTIFY=19,0,0,2,9,'020001000400023438',0,1 OK +QLAURC: 'report',8563 +QLANOTIFY: 0 +QLAURC: 'report_ack',0,8563 AT+QLAUPDATE=0,100 OK +QLAUPDATE: 0,41760 AT+QSCLK=1 OK //业务完成后，启用休眠模式。 +QNBIOTEVENT: 'ENTER DEEPSLEEP' //模块成功进入深休眠。 +QNBIOTEVENT: 'EXIT DEEPSLEEP' +QLAURC: 'recovered',0 AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 //PSM_EINT 下降沿或发送一包 AT 唤醒模块。 //唤醒后恢复成功。 //禁用休眠模式。 //查询注网状态。 //网络状态未发生变化。 OK AT+CGPADDR? //查询 PDP 地址。 上海移远通信技术股份有限公司 53 / 89 BC260Y-CN (R01) LwM2M 应用指导 +CGPADDR: 0,'10.177.135.245' //地址未丢失。 OK AT+QLANOTIFY=19,0,0,2,9,'020001000400023238',0,1,2 OK +QLAURC: 'report',52157 +QLANOTIFY: 0 +QLAURC: 'report_ack',0,52157 AT+QLADEREG OK //数据业务结束，去注册。 +QLADEREG: 0 AT+QSCLK=1 OK //业务完成，启用休眠模式。 5.3. 使用标准 LwM2M 协议对接中国电信 AEP 平台 5.3.1. 平台侧配置 5.3.1.1. 产品创建 1. 登录 Wing 中国电信物联网开放平台（即 AEP 平台，https://www.ctwing.cn），在控制台内选择'产 品中心'，点击'创建产品'，新建一款产品。 图 10：中国 AEP 平台首页 上海移远通信技术股份有限公司 54 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 11：产品中心 - 创建产品 2. 在'创建产品'界面，根据自己的需求编辑产品的各项配置。下图仅为举例说明，首次创建产品时， 建议选择透传模式。 图 12：创建产品 - 编辑产品配置 上海移远通信技术股份有限公司 55 / 89 5.3.1.2. 设备添加 进入创建好的产品，点击'添加设备'。 BC260Y-CN (R01) LwM2M 应用指导 图 13：添加设备 5.3.1.3. 设备激活后对象操作 1. 如下图，点击红色箭头所指图标，可查看 Object（对象）。 图 14：查看 Object 上海移远通信技术股份有限公司 56 / 89 BC260Y-CN (R01) LwM2M 应用指导 2. 在'Object 列表'中，可对 Object 进行订阅、取消订阅和读写等操作。如下图所示，点击右上方 '查看 Object 日志'，可查看之前执行的操作。 图 15：查看 Object 日志 备注 以上仅作为新手参考。更多内容，请参考登录中国电信 AEP 平台的官方文档（AEP 平台首页→'文档 中心'）。 5.3.2. 模块侧对接平台的 AT 命令示例 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 //禁用休眠模式。 //查询注网状态。 //找网已成功，若未成功，可多次查询。 OK AT+CGPADDR? +CGPADDR: 0,'10.177.135.245' //找网成功后，可通过此命令查询模块 PDP 地址。 OK AT+QLACFG='platform',1 OK //配置目标平台为中国电信 AEP 平台。 上海移远通信技术股份有限公司 57 / 89 BC260Y-CN (R01) LwM2M 应用指导 AT+QLACONFIG=0,'221.229.214.202',5683,'urn:imei-imsi:866971030603068-460111174747875',30 0,3 OK AT+QLAADDOBJ=19,0,1,0 //添加对象 19/0/0。 OK AT+QLAADDOBJ=19,1,1,0 //添加对象 19/1/0。 OK AT+QLAREG OK +QLAREG: 0 +QLAURC: 'observe',45419,0,19,0,0 AT+QLAOBSRSP=45419,1,19,0,0,2,9,'020001000400023238',0 OK +QLAOBSRSP: 0 AT+QLANOTIFY=19,0,0,2,9,'020001000400023238',0,0 OK +QLANOTIFY: 0 AT+QLANOTIFY=19,0,0,2,9,'020001000400023238',0,1 OK +QLAURC: 'report',34218 +QLANOTIFY: 0 +QLAURC: 'report_ack',0,34218 AT+QLAUPDATE=0,100 OK +QLAUPDATE: 0,8601 AT+QLADEREG OK +QLADEREG: 0 AT+QSCLK=1 OK //业务完成，启用休眠模式。 上海移远通信技术股份有限公司 58 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.4. 使用标准 LwM2M 协议对接中国移动 Andlink 平台 5.4.1. 平台侧配置 如何在中国移动 Andlink 平台上创建设备及平台相关问题，请联系中国移动 Andlink 平台客户经理。 5.4.2. 模块侧对接平台的 AT 命令示例 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 //禁用休眠模式。 //查询注网状态。 //找网已成功，若未成功，可多次查询。 OK AT+CGPADDR? +CGPADDR: 0,'10.177.135.245' //找网成功后，可通过此命令查询模块 PDP 地址。 OK AT+QLACFG='platform',2 //配置目标平台为中国移动 Andlink 平台。 OK AT+QLACFG='cfg_res',3,0,17,'500677' //配置 Andlink 平台的产品类型。 OK AT+QLAADDOBJ=19,1,1,0 //添加对象 19/1/0。 OK AT+QLACONFIG=1,'lwm.home.komect.com',5683,'866971031275899',30,3 //配置服务器信息。 OK AT+QLAREG //发送注册请求。 OK +QLAURC: 'binding_changed',U +QLAURC: 'bs_finished' +QLAREG: 0 +QLAURC: 'read',8095,19,1,0 AT+QLARDRSP=8095,1,19,1,0,2,71,'7b226f75746c6574537461747573223a2231222c227365745469 6d65223a2231222c226669726d77617265223a22312e30222c22736f667456657273696f6e223a22312e 上海移远通信技术股份有限公司 59 / 89 BC260Y-CN (R01) LwM2M 应用指导 30227d',0 OK +QLARDRSP: 0 +QLAURC: 'write',8096,19,1,0,1,20,'{'outletStatus':'1'}',0 AT+QLAWRRSP=8096,2 OK +QLAWRRSP: 0 AT+QLASENDDATA=2,112,'5b7b226e223a222f31392f312f30222c227673223a227b5c226f75746c657 45374617475735c223a5c22305c222c5c2273657454696d655c223a5c22315c222c5c226669726d7761 72655c223a5c22312e305c222c5c22736f667456657273696f6e5c223a5c22312e305c227d227d5d',0 OK +QLASENDDATA: 0,5004 AT+QLASENDDATA=2,112,'5b7b226e223a222f31392f312f30222c227673223a227b5c226f75746c657 45374617475735c223a5c22305c222c5c2273657454696d655c223a5c22315c222c5c226669726d7761 72655c223a5c22312e305c222c5c22736f667456657273696f6e5c223a5c22312e305c227d227d5d',1 OK +QLASENDDATA: 0,5005 +QLAURC: 'send_ack',0,5005 AT+QLAUPDATE=0,100 OK +QLAUPDATE: 0,8601 AT+QLADEREG OK +QLADEREG: 0 AT+QSCLK=1 OK //业务完成，启用休眠模式。 上海移远通信技术股份有限公司 60 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.5. 使用标准 LwM2M 协议对接中国联通雁飞·格物 DMP 平台 5.5.1. 平台侧配置 5.5.1.1. 产品创建 1. 登录中国联通雁飞·格物 DMP 平台（https://dmp.cuiot.cn），在登录后的界面选择'控制台'，点 击左侧导航栏的'产品'，再点击'新增'，打开'新建产品'界面。 图 16：中国联通雁飞·格物 DMP 平台界面 图 17：产品中心·创建产品 上海移远通信技术股份有限公司 61 / 89 BC260Y-CN (R01) LwM2M 应用指导 2. 在'新建产品'界面，根据自己的需求编辑产品的各项配置信息（下图以创建水表产品为例）。 图 18：创建产品·产品配置 5.5.1.2. 物模型定义 1. 在'产品列表'页，点击指定产品后的'查看'，然后选择'功能定义'，点击'编辑物模型'。 图 19：产品中心·查看 上海移远通信技术股份有限公司 62 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 20：产品中心·功能定义 2. 点击'添加自定义功能'，针对创建的产品添加产品相关参数（下图以创建水表产品为例）。 图 21：编辑物模型 上海移远通信技术股份有限公司 63 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 22：添加自定义功能 3. 最后，点击'发布物模型'，至此，物模型定义完成。 上海移远通信技术股份有限公司 图 23：发布物模型 64 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.5.1.3. 物模型配置 1. 在'产品列表'页面，点击指定产品后的'查看'进入产品详情页，选择'LwM2M 物模型配置'， 点击'添加对象定义'。 图 24：物模型配置 2. 根据页面提示完成对象定义的添加。示例如下： 图 25：添加对象定义 上海移远通信技术股份有限公司 65 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.5.1.4. 设备添加 1. 在控制台页面点击左侧导航栏的'设备'，然后点击'新建'打开'新建设备'界面，如下图所示： 图 26：创建设备 2. 根据实际情况完成设备参数配置，点击'提交'，提交成功即表示创建设备成功（下图以创建水表 产品为例）。 图 27：设备参数配置 上海移远通信技术股份有限公司 66 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.5.1.5. 设备激活后对象操作 1. 点击指定设备后的'查看'进入设备详情，然后点击'设备数据'，即可查看数据，如下图所示。 图 28：设备查看 图 29：设备数据查看 上海移远通信技术股份有限公司 67 / 89 BC260Y-CN (R01) LwM2M 应用指导 2. 在设备详情页点击'LwM2M 设备管理'如下图所示，选择想要的操作即可成功下发数据。 图 30：数据下发 5.5.2. 模块侧对接平台 AT 命令示例 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+CEREG? +CEREG: 0,1 //禁用休眠模式。 //查询注网状态。 //找网已成功，若未成功，可多次查询。 OK AT+CGPADDR? +CGPADDR: 0,'10.177.135.245' //找网成功后，可通过此命令查询模块 PDP 地址。 OK AT+QLACFG='platform',1 //配置目标平台为中国联通雁飞·格物 DMP 平台。 OK AT+QLACFG='auto_ack',1 OK AT+QLACONFIG=0,'dmp-coap.cuiot.cn',5683,'861428040064744',300,3 OK AT+QLAADDOBJ=3311,0,2,5850,5851 //添加对象 3311/0/5850 和 3311/0/5851。 OK AT+QLAREG OK 上海移远通信技术股份有限公司 68 / 89 +QLAREG: 0 +QLAURC: 'observe',17015,0,3311,0,-1 AT+QLANOTIFY=3311,0,5850,5,1,1,0,1 OK +QLAURC: 'report',14143 +QLANOTIFY: 0 +QLAURC: 'report_ack',0,14143 AT+QLANOTIFY=3311,0,5851,3,4,500,0,1 OK +QLAURC: 'report',14144 +QLANOTIFY: 0 +QLAURC: 'report_ack',0,14144 AT+QLADEREG OK +QLADEREG: 0 AT+QSCLK=1 OK BC260Y-CN (R01) LwM2M 应用指导 //业务完成，启用休眠模式。 5.6. 中国电信 AEP 平台 DFOTA 实例 5.6.1. 上传差分包到平台 上传差分包到 AEP 平台前，需先从供应商处获取差分固件升级包。然后登录中国电信 AEP 平台控制 台，点击'远程升级管理'，选择'FOTA 升级'→'固件管理'→'创建固件'，将固件信息上传至云端。 图 31：DFOTA 选择固件管理 上海移远通信技术股份有限公司 69 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 32：创建固件版本 5.6.2. 创建 DFOTA 任务 返回中国电信 AEP 平台控制台，选择'远程升级管理'→'创建任务'，即可创建升级任务。 图 33：选择创建任务 上海移远通信技术股份有限公司 70 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 34：创建升级任务 5.6.3. 添加升级设备 选择'远程升级管理'，选中创建的任务名称（下图中以'Test1'为例），点击任务设备管理图标，勾 选需要升级的设备，点击右上角'加入升级'。如下图所示。 图 35：选择升级设备管理 上海移远通信技术股份有限公司 71 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 36：选择升级设备 5.6.4. 设备升级 选择'远程升级管理'→'启动升级图标'→'立即启动'，如下图所示。 图 37：启动升级 设置平台升级任务后，设备注册到平台，收到平台下发的 observe 请求后，随即开始升级。如果设备在 设置平台升级任务前已注册到平台，在上行一次数据后，随即开始升级。以下以第一种情况为例： +IP: 11.201.96.220 ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A01 //上报本地 IP //查询当前版本 OK AT+QSCLK=0 //禁止深休眠 OK AT+QLACFG='platform',1 //配置对接 AEP 平台 OK AT+QLACONFIG=0,'221.229.214.202',5683,'866971030603068',3000,3 //配置平台信息 OK AT+QLAREG //启动注册 OK +QLAREG: 0 //注册成功 上海移远通信技术股份有限公司 72 / 89 BC260Y-CN (R01) LwM2M 应用指导 +QLAURC: 'observe',21295,0,19,0,0 AT+QLAOBSRSP=21295,1,19,0,0,2,9,'020001000400023238',0 OK //收到平台下发的订阅 object19/0/0 的请求 //应答平台订阅 +QLAOBSRSP: 0 +QIND: 'FOTA','COAPSTART' //开始下载差分包 +QIND: 'FOTA','COAPEND',0 //下载完成 +QLAURC: 'report',50697 +QLAURC: 'report',50699 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',20%,1,1 //开始升级 //升级进度 +QIND: 'FOTA','UPDATING',21%,1,1 …… +QIND: 'FOTA','UPDATING',100%,1,1 RDY +CFUN: 1 +QIND: 'FOTA','END',0 AT+QSCLK=0 OK //成功升级 //禁止深休眠 +CPIN: READY +IP: 11.129.144.217 AT+QLACFG='platform',1 //配置对接 AEP 平台 OK AT+QLACONFIG=0,'221.229.214.202',5683,'866971030603068',3000,3 //配置平台信息 OK AT+QLAREG //再注册到平台，以便上报升 级结果到平台 OK 上海移远通信技术股份有限公司 73 / 89 BC260Y-CN (R01) LwM2M 应用指导 +QLAREG: 0 +QLAURC: 'report',8030 +QLAURC: 'observe',62640,0,19,0,0 AT+QLAOBSRSP=62640,1,19,0,0,2,9,'020001000400023238',0 OK +QLAOBSRSP: 0 ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A02 OK //收到平台下发的订阅 object19/0/0 的请求 //应答平台订阅 //查询当前版本 5.6.5. 重新注册设备 模块升级后，MCU 需要控制模块重新向 AEP 平台发起注册，以便模块上报升级结果。成功上报后平 台显示如下： 图 38：AEP 平台升级结果 5.7. 中国电信 IoT 平台 DFOTA 实例 5.7.1. DFOTA 能力配置 在 DFOTA 升级之前，需要确保在中国电信 IoT 平台上成功注册设备，且能正常收发数据。只有在设备 与中国电信 IoT 平台进行正常通讯时，才可以进行 DFOTA 升级。 请参考中国电信 IoT 平台官方文档完成应用的创建。创建应用时，请注意导入设备的 Profile，该 Profile 必须包含 omCapabilities 能力（若未包含，请在 Profile 中添加如下 Profile 模板中的红色标记内容），否则 无法向平台上传对应设备的差分固件升级包且平台无法对该设备创建固件升级任务。请联系中国电信 IoT 平 上海移远通信技术股份有限公司 74 / 89 BC260Y-CN (R01) LwM2M 应用指导 台获取具体的 Profile 开发指导。 以下是支持升级的一个 Profile 模板，仅供参考。 { 'devices': [ { 'manufacturerId': 'QUECTEL', 'manufacturerName': 'QUECTEL', 'model': 'BC260YCN ', 'protocolType': 'CoAP', 'deviceType': 'WaterMeter', 'omCapability':{ 'upgradeCapability' : { 'supportUpgrade':false }, 'fwUpgradeCapability' : { 'supportUpgrade':true, 'upgradeProtocolType':'LWM2M', 'downloadProtocolType':'CoAP' } }, 'serviceTypeCapabilities': [ { 'serviceId': 'Brightness', 'serviceType': 'Brightness', 'option': 'Master' }, { 'serviceId': 'WaterData', 'serviceType': 'WaterData', 'option': 'Optional' } ] } ] } 在 中 国 电 信 IoT 平 台 开 发 者 中 心 对 应 的 应 用 属 性 页 打 开 固 件 升 级 ， 新 创 建 的 应 用 即 可 拥 有 omCapabilities 能力。如下图所示。 上海移远通信技术股份有限公司 75 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 39：应用属性页 备注 对接过中国电信物 IoT 平台 1.5 版本的设备，其对应的 Profile 通常不包含 omCapabilities 能力，若后续 需要测试，请在 Profile 中添加如上 Profile 模板中的用红色标记的内容。 5.7.2. 生成公私密钥 1. 登陆中国电信 IoT 平台，进入'系统管理'→'工具'页面，点击'离线签名工具'下载离线签名 工具压缩包 signtool.zip。如下图所示。 图 40：管理页面 上海移远通信技术股份有限公司 图 41：下载签名工具 76 / 89 BC260Y-CN (R01) LwM2M 应用指导 2. 解压工具压缩包，运行 signtool.exe，选择'签名算法'为'ECDSA_256K1+SHA256'，输入'私 钥 加 密 口 令 ' ， 例 如 'quectel123' ； 点 击 ' 生 成 公 私 密 钥 ' ， 将 生 成 一 对 公 私 密 钥 文 件 private.pem 和 public.pem。如下图所示。 图 42：生成公私密钥 3. 进入'系统管理'→'设备管理'，选择所创建的产品名称，点击'软件库'→'公钥管理'→'上 传'，上传公钥文件 public.pem 到中国电信 IoT 平台，如下图所示。注意'厂商名称'需要与 Profile 文件里面的厂商名称相对应。 上海移远通信技术股份有限公司 77 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 43：公钥上传步骤 1 图 44：公钥上传步骤 2 图 45：公钥上传步骤 3 上海移远通信技术股份有限公司 78 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.7.3. 制作固件升级包 请从供应商处获取差分固件升级包，然后对升级包进行数字签名。签名过程如下： 1. 运行 signtool.exe，在'签名算法'中选择私钥对应的'ECDSA_256K1+SHA256'签名算法。 2. 在'私钥文件'中导入 private.pem 私钥文件并输入之前设置的密码，如'quectel123'。 3. 在'需要数字签名的软件包'处导入差分固件升级包，需要注意的是差分固件升级包的文件是 bin 文件，如：BC260YCNAAR01A03_BETA0721.bin，但对差分固件升级包进行数字签名的文件为 zip 文件，上传到平台的也是已经签名的 zip 文件，所以需要将差分固件升级包的 bin 文件压缩成 zip 文件，如 BC260YCNAAR01A03_BETA0721.zip。 4. 点击'进行数字签名'，显示'签名成功！'后，在差分固件升级包同级目录下将生成带'signed' 标志的签名差分固件升级包，如：BC260YCNAAR01A03_BETA0721_signed.zip。 图 46：差分固件升级包数据签名步骤 上海移远通信技术股份有限公司 79 / 89 BC260Y-CN (R01) LwM2M 应用指导 5.7.4. 上传固件升级包 登陆中国 IoT 平台，进入'软件库'→'固件包管理'→'添加固件包'页面。 图 47：添加固件包页面 上传签名后的差分固件升级包 ，按下图提示填写，如'版本'填写为'BC260YCNAAR01A03_ BETA0721'；'设备类型'填写为'WaterMeter'；'厂商名称'填写为'QUECTEL'；'型号'填写为 'BC260YCN'；'协议'填写为'CoAP'。 图 48：上传签名差分固件升级包至中国 IoT 平台 上海移远通信技术股份有限公司 80 / 89 BC260Y-CN (R01) LwM2M 应用指导 备注 设备类型、厂商名称、型号、协议必须与应用的 Profile 严格一致，否则上传差分固件升级包和 DFOTA 升级任务将失败。 5.7.5. 配置平台升级任务 1. 添加设备到默认群组，选择'群组'→'默认群组'→'设备'→'绑定设备'→'选择设备'→ '绑定'，如下图所示。 图 49：添加设备到默认群组步骤 1 图 50：添加设备到默认群组步骤 2 上海移远通信技术股份有限公司 81 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 51：默认群组绑定完成 2. 在'批量任务'→'批量软固件升级'→'固件升级'→'创建'页面中创建批量任务，按照需求 填写任务名、重试策略和重试次数。 图 52：创建批量任务页面 上海移远通信技术股份有限公司 82 / 89 BC260Y-CN (R01) LwM2M 应用指导 图 53：创建批量升级任务 3. 设置升级任务参数及选择差分包。 图 54：设置升级任务参数 上海移远通信技术股份有限公司 83 / 89 BC260Y-CN (R01) LwM2M 应用指导 4. 选择需要升级的设备群组，完成平台升级任务的创建。 图 55：选择升级群组 5.7.6. 设备升级 升级任务创建成功之后，终端设备发送上行数据包，触发平台的 DFOTA 升级，升级过程包括：下载差 分固件升级包和更新固件。在升级完成后，模块需要手动重新注册平台，才能向平台上报升级结果。 +IP: 11.201.96.220 ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A03 //上报本地 IP //查询当前版本 OK AT+QSCLK=0 OK AT+QLACFG='platform',0 OK AT+QLACONFIG=0,'180.101.147.115',5683,'869405030311568',3000,3 OK AT+QLAREG OK //禁止深休眠 //配置对接 IoT 平台 //配置平台信息 //启动注册 +QLAREG: 0 //注册成功 +QLAURC: 'observe',21295,0,19,0,0 //收到平台下发的订阅 上海移远通信技术股份有限公司 84 / 89 BC260Y-CN (R01) LwM2M 应用指导 AT+QLAOBSRSP=21295,1,19,0,0,2,9,'020001000400023238',0 OK object19/0/0 的请求 //应答平台订阅 +QLAOBSRSP: 0 +QIND: 'FOTA','COAPSTART' +QIND: 'FOTA','COAPEND',0 //开始下载差分包 //下载完成 +QLAURC: 'report',50697 +QLAURC: 'report',50699 +QIND: 'FOTA','START' //开始升级 +QIND: 'FOTA','UPDATING',20%,1,1 //升级进度 +QIND: 'FOTA','UPDATING',21%,1,1 …… +QIND: 'FOTA','UPDATING',100%,1,1 RDY +CFUN: 1 +QIND: 'FOTA','END',0 AT+QSCLK=0 OK //成功升级 //禁止深休眠 +CPIN: READY +IP: 11.129.144.217 AT+QLACFG='platform',0 //配置对接 IoT 平台 OK AT+QLACONFIG=0,'180.101.147.115',5683,'869405030311568',3000,3 //配置平台信息 OK AT+QLAREG //再注册到平台，以便上报升 级结果到平台 OK +QLAREG: 0 上海移远通信技术股份有限公司 85 / 89 BC260Y-CN (R01) LwM2M 应用指导 +QLAURC: 'report',8030 +QLAURC: 'observe',62640,0,19,0,0 AT+QLAOBSRSP=62640,1,19,0,0,2,9,'020001000400023238',0 OK +QLAOBSRSP: 0 ATI Quectel_Ltd Quectel_BC260Y-CN Revision: BC260YCNAAR01A03_BETA0721 OK //收到平台下发的订阅 object19/0/0 的请求 //应答平台订阅 //查询当前版本 5.7.7. 重新注册设备 模块升级后，MCU 需要控制模块重新向电信 IoT 平台发起注册，以便模块上报升级结果。成功上报后 平台显示如下： 图 56：中国电信 IoT 平台升级结果 上海移远通信技术股份有限公司 86 / 89 BC260Y-CN (R01) LwM2M 应用指导 6 结果码 表 5：概要 0 1 2 3 4 5 400 403 404 412 900 描述 成功 超时 数据包未发送 恢复失败 更新失败 重置 错误请求 禁止 未找到 前提条件失败 其他错误 原因 - 网络异常或服务器未响应 当生命周期到期或者恢复过程中平台无响应，会导致恢复失 败，建议执行 AT+QLAREG 重新注册。 当发起更新时，若距离上一次成功更新的时间差超过平台已 经接受的生命周期，则会导致生命周期更新失败，建议执行 AT+QLASTATUS 命令查询状态后执行对应操作。 服务器回复 RST 服务器回复 4.00 服务器回复 4.03 服务器回复 4.04 服务器回复 4.12 未注网成功或其他内部错误 上海移远通信技术股份有限公司 87 / 89 BC260Y-CN (R01) LwM2M 应用指导 7 附录 参考文档及术语缩写 表 6：参考文档 文档名称 [1] Quectel_BC260Y-CN_AT 命令手册 [2] Quectel_BC260Y-CN_终端应用设计指导 表 7：术语缩写 缩写 ACK APN BS CoAP CON DTLS DFOTA DMP FOTA ID IMEI IoT IP LwM2M 英文描述 Acknowledgement Access Point Name BootStrap Constrained Application Protocol Confirmable Datagram Transport Layer Security Delta firmware Upgrade Over-the-Air Device Management Platform Firmware Over-The-Air Identifier International Mobile Equipment Identity Internet of Things Internet Protocol Lightweight Machine to Machine 中文描述 确认消息 接入点名称 用于前端开发的开源工具包 受限应用协议 需要对端返回应答的信息类型 数据包传输层安全性协议 固件空中差分升级 设备管理平台 空中下载软件升级 标识符 国际移动设备识别码 物联网 网际互连协议 一种轻量化的物联网协议 上海移远通信技术股份有限公司 88 / 89 MCU NB-IoT NON PDP PSK PSM RAI RRC RST TE UDP UE URC URI URL Microcontroller Unit Narrow Band Internet of Things Nonconfirmable Packet Data Protocol Pre-Shared Key Power Saving Mode Release Assistant Indication Radio Resource Control Reset Terminal Service User Datagram Protocol User Equipment Unsolicited Result Code Uniform Resource Identifier Uniform Resource Locator BC260Y-CN (R01) LwM2M 应用指导 微型控制单元 窄带物联网 不需要对端返回应答的信息类型 分组数据协议 预共享密钥 省电模式 释放辅助指示 无线资源控制 重置 终端设备 用户数据报协议 用户设备 未经请求的结果代码 统一标识 统一资源定位符 上海移远通信技术股份有限公司 89 / 89

BC260Y-CN (R02) 中国电信物联网平台应用指导 NB-IoT 模块系列 版本：1.1 日期：2021-05-22 状态：受控文件 BC260Y-CN (R02) 中国电信物联网平台应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 文档历史 修订记录 版本 日期 - 2020-12-25 1.0 2021-01-14 1.1 2021-05-22 作者 变更表述 Albert ZHANG 文档创建 Albert ZHANG Jack QIAN 受控版本 1. 更新文档命名为 Quectel_BC260Y-CN(R02)_中国电信物 联网平台应用指导。 2. 第 5 章：新增中国电信 IoT 和 AEP 平台 DFOTA 指导。 上海移远通信技术股份有限公司 2 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................ 3 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 引言 ..................................................................................................................................................... 7 2 平台相关 AT 命令 ................................................................................................................................ 8 2.1. AT 命令语句.............................................................................................................................. 8 2.1.1. 定义 ............................................................................................................................... 8 2.1.2. AT 命令语句 ................................................................................................................... 8 2.2. AT 示例声明.............................................................................................................................. 9 2.3. AT 命令详解.............................................................................................................................. 9 2.3.1. AT+NCDPOPEN 模块发起连接到服务器请求.............................................................. 9 2.3.2. AT+NCDPCLOSE 模块发起断开连接请求................................................................. 10 2.3.3. AT+NMGS 发送数据...................................................................................................11 2.3.4. AT+NMGR 读取缓存数据 .......................................................................................... 12 2.3.5. AT+NNMI 配置数据接收模式 ..................................................................................... 12 2.3.6. AT+NCFG 配置命令 .................................................................................................. 13 2.3.7. AT+NMSTATUS 查询注册状态 .................................................................................. 14 2.3.8. AT+QLWULDATASTATUS 查询 CON 消息发送状态 ................................................. 15 2.3.9. AT+NQMGR 查询已接收消息状态 ............................................................................. 16 3 平台相关的 URC ............................................................................................................................... 18 3.1. +QLWEVTIND: 模块动作执行结果 ........................................................................... 18 3.2. +NNMI[: ,] 接收到新数据 ............................................................................. 19 3.3. +NNMI: 'recv',buff full 缓存区已满 ....................................................................................... 19 3.4. +QIND: 'FOTA','DOWNLOAD START' 开始下载固件......................................................... 20 3.5. +QIND: 'FOTA','DOWNLOADING' 模块固件下载的大小 .................................................... 20 3.6. +QIND: 'FOTA','DOWNLOAD' 模块固件下载结果 .............................................................. 20 3.7. +QIND: 'FOTA','START' 模块开始固件升级 ....................................................................... 21 3.8. +QIND: 'FOTA','UPDATING' 模块固件升级进度................................................................. 21 3.9. +QIND: 'FOTA','END' 模块固件升级结果 ........................................................................... 21 4 举例 ................................................................................................................................................... 22 4.1. 对接电信 IoT 平台 ................................................................................................................... 22 4.1.1. 平台侧配置................................................................................................................... 22 4.1.1.1. 创建设备............................................................................................................ 22 4.1.1.2. 在线调试............................................................................................................ 25 4.1.2. 模块侧对接电信 IoT 平台 AT 命令示例 ......................................................................... 25 4.2. 对接电信 AEP 平台 ................................................................................................................. 27 4.2.1. 平台侧配置................................................................................................................... 27 4.2.1.1. 产品创建............................................................................................................ 27 上海移远通信技术股份有限公司 3 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 4.2.1.2. 设备添加............................................................................................................ 29 4.2.1.3. 设备激活后对象操作.......................................................................................... 29 4.2.2. 模块侧对接电信 AEP 平台 AT 命令示例 ....................................................................... 30 5 中国电信物联网平台 DFOTA............................................................................................................. 33 5.1. 电信 IoT 平台 DFOTA ............................................................................................................. 33 5.1.1. 平台注册 ...................................................................................................................... 33 5.1.2. 创建应用 ...................................................................................................................... 33 5.1.3. 生成公私密钥及上传公钥 ............................................................................................. 35 5.1.4. 差分包获取及签名 ........................................................................................................ 37 5.1.4.1. 获取差分包 ........................................................................................................ 37 5.1.4.2. 对差分包进行签名 ............................................................................................. 37 5.1.5. 上传差分包................................................................................................................... 39 5.1.6. DFOTA 升级................................................................................................................. 40 5.1.6.1. 创建升级任务 .................................................................................................... 40 5.1.6.2. 设备升级............................................................................................................ 43 5.2. AEP 平台 DFOTA ................................................................................................................... 45 5.2.1. 平台注册 ...................................................................................................................... 45 5.2.2. 差分包获取及上传 ........................................................................................................ 45 5.2.2.1. 获取差分包 ........................................................................................................ 45 5.2.2.2. 上传差分包至 AEP 平台 .................................................................................... 45 5.2.3. 创建 DFOTA 任务......................................................................................................... 46 5.2.4. 添加 DFOTA 设备......................................................................................................... 47 5.2.5. DFOTA 升级................................................................................................................. 48 5.2.6. 查看升级结果 ............................................................................................................... 49 5.3. DFOTA 过程说明及注意事项 .................................................................................................. 50 5.3.1. 过程说明 ...................................................................................................................... 50 5.3.1.1. 下载阶段............................................................................................................ 50 5.3.1.2. 升级阶段............................................................................................................ 50 5.3.2. 错误说明 ...................................................................................................................... 50 5.3.2.1. 下载失败错误码 ................................................................................................. 50 5.3.2.2. 升级结束阶段及升级错误码 ............................................................................... 50 5.3.3. 注意事项 ...................................................................................................................... 51 6 错误码概览 ........................................................................................................................................ 52 7 附录 A 参考文档及术语缩写 .............................................................................................................. 54 上海移远通信技术股份有限公司 4 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 表格索引 表 1：AT 命令类型..................................................................................................................................... 8 表 2：平台相关 URC ............................................................................................................................... 18 表 3：平台相关错误码 ............................................................................................................................. 52 表 4：参考文档........................................................................................................................................ 54 表 5：术语缩写........................................................................................................................................ 54 上海移远通信技术股份有限公司 5 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 图片索引 图 1：新建产品........................................................................................................................................ 22 图 2：自定义产品 .................................................................................................................................... 23 图 3：填写创建产品的信息 ...................................................................................................................... 23 图 4：定义 Profile .................................................................................................................................... 24 图 5：开发编码器插件 ............................................................................................................................. 24 图 6：选择在线调测................................................................................................................................. 25 图 7：模拟设备接入平台.......................................................................................................................... 25 图 8：电信 AEP 平台首页........................................................................................................................ 27 图 9：产品中心 - 创建产品..................................................................................................................... 28 图 10：创建产品 - 编辑产品配置............................................................................................................ 28 图 11：添加设备 ...................................................................................................................................... 29 图 12：查看对象（Object） .................................................................................................................... 29 图 13：查看接收数据（Object） ............................................................................................................. 30 图 14：查看 Object 日志.......................................................................................................................... 30 图 15：工具下载页面............................................................................................................................... 35 图 16：生成公私密钥............................................................................................................................... 35 图 17：公钥上传页面............................................................................................................................... 36 图 18：上传公钥文件............................................................................................................................... 36 图 19：对差分包进行数字签名 ................................................................................................................ 38 图 20：进入添加差分包页面 .................................................................................................................... 39 图 21：上传已签名差分包至电信 IoT 平台............................................................................................... 39 图 22：新增群组页面............................................................................................................................... 40 图 23：新增群组...................................................................................................................................... 40 图 24：绑定待升级设备 ........................................................................................................................... 41 图 25：创建批量任务页面........................................................................................................................ 41 图 26：创建批量升级任务........................................................................................................................ 42 图 27：选择对应的差分固件升级包 ......................................................................................................... 42 图 28：选择需要升级的设备群组............................................................................................................. 43 图 29：升级成功...................................................................................................................................... 44 图 30：DFOTA 选择固件管理 .................................................................................................................. 45 图 31：创建固件版本............................................................................................................................... 46 图 32：选择创建任务............................................................................................................................... 46 图 33：创建升级任务............................................................................................................................... 47 图 34：选择升级设备管理........................................................................................................................ 47 图 35：选择升级设备............................................................................................................................... 47 图 36：启动升级...................................................................................................................................... 48 图 37：AEP 平台升级结果....................................................................................................................... 49 上海移远通信技术股份有限公司 6 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 1 引言 本文档主要介绍如何将使用移远通信 BC260Y-CN 模块的设备连接到中国电信物联网平台（以下简称 '平台'），在接下来的文档中将向用户介绍一套基于 CoAP 的简化 AT 命令，用户使用该套命令可以快速 对接中国电信物联网平台。 备注 1. 本文档中所述的中国电信物联网平台，包含'中国电信物联网开放平台-连接管理子系统'（本文简称 '电信 IoT 平台'）和'CTWing 中国电信物联网开放平台'（本文简称'电信 AEP 平台'）。 2. 本文档仅适用于 R02 及之后固件版本的 BC260Y-CN 模块。R01 固件版本的 BC260Y-CN 模块不支持 本文档所述的简化 AT 命令。 3. R01 和 R02 固件指固件版本号中含有'R01'或'R02'的固件版本，如'BC260YCN…R01…'和 'BC260YCN…R02…'。 上海移远通信技术股份有限公司 7 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 2 平台相关 AT 命令 本章主要说明了与平台的连接和功能相关的 AT 命令。 2.1. AT 命令语句 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+NCDPOPEN 模块发起连接到服务器请求 该命令通过配置平台接入的 IP 地址和端口号将模块连接到平台服务器。如果缺省参数未配置，则自动 使用默认值进行连接。 AT+NCDPOPEN 模块发起连接到服务器请求 测试命令 AT+NCDPOPEN=? 响应 OK 设置命令 AT+NCDPOPEN=[,[, ]] 若出现任何错误： ERROR 或 +CME ERROR: 响应 若连接成功： OK +QLWEVTIND: 0 最大响应时间 特性说明 +QLWEVTIND: 3 若出现任何错误： ERROR 或 +CME ERROR: 5秒 / 参数 字符串型。平台服务器接入的 IP 地址。 整型。服务器接入的 IP 端口，当未配置或配置为 0 时，取默认值 5683。范围：0~65535。 上海移远通信技术股份有限公司 9 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 十六进制字符串型。加密设备的密钥，在平台端注册加密设备时可由平台生成或自主设 置，最大支持长度 256 字节。 错误码，详情请参考第 6 章。 备注 1. 在发起连接命令之前，必须确保该设备 IMEI 号在平台端已注册。 2. 如果注册设备为加密设备，则必须通过平台指定的加密端口及正确的进行连接。 3. 如果已经执行 AT+NCDPOPEN 发起连接，必须等到连接结果码上报后才可执行 AT+NCDPCLOSE 主动断开连接，否则会返回 ERROR。 4. 执行 AT+NCDPOPEN 后，若连接超时或者连接被服务器拒绝，将会收到 URC +QLWEVTIND: 1。 5. 非加密连接下，返回连接结果的最大超时时间为 126 秒。加密连接下，受加密过程的影响，返回结 果的最大超时时间不定，若连接失败或者超时，建议检查 AT 命令各参数是否正确后，再重新发起 连接。 2.3.2. AT+NCDPCLOSE 模块发起断开连接请求 该命令用于断开模块与平台的连接。 AT+NCDPCLOSE 模块发起断开连接请求 执行命令 响应 AT+NCDPCLOSE OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 5秒 / 参数 错误码，详情请参考第 6 章。 备注 模块执行 AT+NCDPCLOSE 后会与平台进行去注册数据的交互，当交互完成后，模块注册状态才会变 成 DEREGISTERED（查询注册状态请参考第 2.3.7 章）。交互最大超时时间为 124 秒。 上海移远通信技术股份有限公司 10 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 2.3.3. AT+NMGS 发送数据 该命令用于将数据发送到平台。 AT+NMGS 发送数据 设置命令 响应 AT+NMGS=,[,] OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 5秒 / 参数 整型。需要发送数据的长度。最大值：1024；单位：字节。 十六进制字符串型。要发送的数据内容。 整型。 0 发送 NON 数据并将模块发送数据所携带的 RAI 设置为 0 1 发送 NON 数据并将模块发送数据所携带的 RAI 设置为 1 2 发送 NON 数据并将模块发送数据所携带的 RAI 设置为 2 100 发送 CON 数据并将模块发送数据所携带的 RAI 设置为 0 101 发送 CON 数据并将模块发送数据所携带的 RAI 设置为 1 102 发送 CON 数据并将模块发送数据所携带的 RAI 设置为 2 错误码，详情请参考第 6 章。 备注 1. RAI 用于指示核心网释放与模块的 RRC 连接的方式，如下： RAI 为 0 时，无指示。 RAI 为 1 时，指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放。 RAI 为 2 时，指示该包上行数据后期望有对应回复的单个下行数据包，核心网在下发后立即释放。 2. 若需指示核心网尽快释放网络，需要根据平台配置选择相应。 若平台配置为数据上报无响应，发送 NON 数据则配置=1，发送 CON 数据则配置=102。 若平台配置为数据上报有响应（默认响应 AAAA0000），发送 NON 数据则配置=2，发送 CON 数据则配置=102，但是 RRC 连接快速释放后可能会因为平台下行的响应数据而重新建立，因 此模块发送 CON 数据时，不建议平台配置为数据上报有响应。 上海移远通信技术股份有限公司 11 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 2.3.4. AT+NMGR 读取缓存数据 该命令用于读取缓存区中缓存的数据。当接收数据模式改为缓存模式时，平台下发的数据将会缓存在 本地缓存区中供读取。 AT+NMGR 读取缓存数据 执行命令 AT+NMGR 响应 若缓存区不为空且读取成功： +NMGR: , OK 若缓存区为空： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 5秒 / 参数 整型。表示接收的数据长度。单位：字节。 十六进制字符串型。表示接收的数据内容 错误码，详情请参考第 6 章。 备注 1. 该命令按照数据接收顺序逐条读取，每次执行命令仅返回一条数据。数据读取成功后会将该条数据 从缓存区中移除。 2. 数据接收模式为直吐模式（AT+NNMI=1）时，新接收到的数据将会通过 URC 直接上报，并不会保 存在缓存区中。 2.3.5. AT+NNMI 配置数据接收模式 该命令用于设置模块接收数据模式为直吐模式或者缓存模式。 AT+NNMI 查询命令 AT+NNMI? 配置数据接收模式 响应 +NNMI: 上海移远通信技术股份有限公司 12 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 设置命令 AT+NNMI= 最大响应时间 特性说明 OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 5秒 该命令立即生效； 参数配置不保存到 NVRAM，但深休眠唤醒后仍有效。 参数 整型。 0 设置接收数据模式为缓存模式，接收到新数据时无 URC 上报 1 设置接收数据模式为直吐模式，接收到新数据时通过 URC 立即上报 2 设置接收数据模式为缓存模式，接收到新数据时仅上报指示 URC 错误码，详情请参考第 6 章。 备注 1. 当设置 AT+NNMI=1 时，从平台接收的新数据将直接上报 URC +NNMI: ,，数据不 会缓存在缓存区中。 2. 当设置 AT+NNMI=2 时，接收到新数据上报指示 URC +NNMI，接收的数据将被缓存在缓存区中， 需要使用 AT+NMGR 读取。 3. 缓存区最多可以保存 2560 字节或者最大 8 条的数据，如果保存在缓存区中的数据长度加上新数据长 度超过 2560 字节或者缓存区中保存的数据条数已经达到 8 条，则新数据将被丢弃，并上报 URC +NNMI: 'recv',buff full，表示本地缓存区已满。 2.3.6. AT+NCFG 配置命令 该命令用于配置平台相关功能。 AT+NCFG 配置命令 测试命令 AT+NCFG=? 上海移远通信技术股份有限公司 响应 +NCFG: 0[,(0-2592000)] OK 若出现任何错误： ERROR 13 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 设置命令 AT+NCFG=[,] 最大响应时间 特性说明 或 +CME ERROR: 响应 若省略可选参数，则查询当前生命周期配置： +NCFG: OK 若指定可选参数，则配置生命周期功能： OK 若出现任何错误： ERROR 或 +CME ERROR: 5秒 该命令重启后生效。 深休眠唤醒后有效；参数配置自动保存至 NVRAM。 参数 整型。配置的目标，目前仅支持 0。 0 配置设备在平台端的生存周期（Lifetime） 整型。配置值。 当=0 时，设置设备在平台端的生命周期。单位：秒；范围：0~2592000。默认值： 0 秒。 整型。错误码，详情请参考第 6 章。 备注 1. 如果=0，将配置为 0 时，模块注册到服务器时的注册数据包中将不包含 Lifetime， 模块端也不会自动发送更新包到服务器。 2. 若将 Lifetime 配置为 1 到 900 之间的值，则取值 900。 3. 缓存区中缓存的平台数据，在进入深休眠后不会丢失。 2.3.7. AT+NMSTATUS 查询注册状态 该命令用于查询模块注册状态。 AT+NMSTATUS 查询命令 AT+NMSTATUS? 查询注册状态 响应 +NMSTATUS: 上海移远通信技术股份有限公司 14 / 54 最大响应时间 特性说明 BC260Y-CN (R02) 中国电信物联网平台应用指导 OK 若出现任何错误： ERROR 或 +CME ERROR: 5秒 / 参数 字符串型。注册状态。 UNINITIALISED 未初始化状态 REGISTERING 连接中 REJECTED_BY_SERVER 连接请求被服务器拒接 TIMEOUT 连接超时 REGISTERED 已连接但未订阅 REGISTERED_AND_OBSERVED 已连接并已订阅 DEREGISTERED 连接断开 RESUMPTION_FAILED DTLS 会话恢复失败 错误码，详情请参考第 6 章。 备注 1. 如果查询的状态为 REJECTED_BY_SERVER，请检查模块是否使用了正确的 IP 地址和端口号发 起连接，检查 IMEI 是否已在平台上注册后再重新发起连接。 2. 如果查询的状态为 TIMEOUT，请检查模块是否使用了正确的 IP 地址和端口号发起连接，对于加密 设备，请同时检查是否正确，再重新发起连接。 3. 当查询状态为 REGISTERED_AND_OBSERVED（订阅成功）状态时，模块才可以发送数据。 2.3.8. AT+QLWULDATASTATUS 查询 CON 消息发送状态 该命令用于查询向 NB-IoT 平台发送 CON 数据的状态。 AT+QLWULDATASTATUS 查询 CON 消息发送状态 查询命令 响应 AT+QLWULDATASTATUS? +QLWULDATASTATUS: OK 若出现任何错误： 上海移远通信技术股份有限公司 15 / 54 最大响应时间 特性说明 BC260Y-CN (R02) 中国电信物联网平台应用指导 ERROR 或者 +CME ERROR: 5秒 / 参数 整型。表示 CON 数据发送状态。 0 未发送 1 已发送，等待 IoT 平台响应 2 发送失败 3 超时 4 成功 5 收到 RESET 消息 错误码。详情请参考第 6 章。 举例 AT+QLWULDATASTATUS? +QLWULDATASTATUS: 4 OK 2.3.9. AT+NQMGR 查询已接收消息状态 该命令用于查询从 IoT 平台已接收的下行消息的状态。 AT+NQMGR 查询已接收消息状态 执行命令 响应 AT+NQMGR BUFFERED=,RECEIVED=,DROPPE D= OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 5秒 / 上海移远通信技术股份有限公司 16 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 参数 整型。下行缓存中等待读取的消息条数。 整型。UE 启动后收到的消息总数。 整型。UE 启动后丢弃的消息条数。 错误码。详情请参考第 6 章。 举例 AT+NQMGR BUFFERED=0,RECEIVED=34,DROPPED=2 OK 上海移远通信技术股份有限公司 17 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 3 平台相关的 URC 本章列举了与中国电信物联网平台相关的 URC 及其描述。 表 2：平台相关 URC 索引 URC [1] +QLWEVTIND: [2] +NNMI[: ,] [3] +NNMI: 'recv',buff full [4] +QIND: 'FOTA','DOWNLOAD START' [5] +QIND: 'FOTA','DOWNLOADING', [6] +QIND: 'FOTA','DOWNLOAD', [7] +QIND: 'FOTA','START' [8] +QIND: 'FOTA','UPDATING', [9] +QIND: 'FOTA','END', 描述 模块动作执行结果 接收到平台下发的新数据 缓存区已满，新数据已丢弃 开始下载固件 模块固件下载的大小 固件下载结果 模块开始固件升级 模块固件升级进度 模块固件升级结果 3.1. +QLWEVTIND: 模块动作执行结果 该 URC 指示模块相关动作的执行结果。 +QLWEVTIND: 模块动作执行结果 +QLWEVTIND: 指示模块动作执行的结果 参数 整型。 -1 连接发生异常 0 模块已连接 上海移远通信技术股份有限公司 18 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 1 连接被服务器拒绝或连接超时 2 表示模块自动更新 lifetime 成功 3 表示 object 19/0/0 已订阅 4 CON 数据发送成功 5 CON 数据发送失败 6 深休眠唤醒连接恢复成功 7 深休眠唤醒连接恢复失败 8 上报升级状态的 object 5/0/3 已订阅 9 上报升级状态的 object 5/0/3 已取消订阅 10 通过 object 19/0/0 上行数据时收到了平台回复的 RST 消息，此时只有重新建立连接才 能够发送数据 备注 +QLWEVTIND: 6 仅表示模块从深休眠模式唤醒后进行本地数据的自恢复，并不会和网络进行交互。 3.2. +NNMI[: ,] 接收到新数据 该 URC 指示模块从平台接收到新数据。 +NNMI[: ,] 接收到新数据 +NNMI[: ,] 表示接收到新数据 参数 整型。已接收的数据长度。单位：字节。 十六进制字符串型。已接收的数据内容。 3.3. +NNMI: 'recv',buff full 缓存区已满 该 URC 指示本地存储接收数据的缓存区已满。 +NNMI: 'recv',buff full 缓存区已满 +NNMI: 'recv',buff full 表示本地存储接收数据的缓存区已满 上海移远通信技术股份有限公司 19 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 3.4. +QIND: 'FOTA','DOWNLOAD START' 开始下载固件 该 URC 指示模组开始固件下载，此时终端 MCU 不可给模块断电，也不可发送数据传输相关的 AT 命 令。 +QIND: 'FOTA','DOWNLOAD START' 开始下载固件 +QIND: 'FOTA','DOWNLOAD START' 表示模组开始固件下载 3.5. +QIND: 'FOTA','DOWNLOADING' 模块固件下载的大小 该 URC 指示模块固件下载的大小。 +QIND: 'FOTA','DOWNLOADING' 模块固件下载的大小 +QIND: 'FOTA','DOWNLOADING', 表示模块固件下载的大小 参数 整型。已经下载固件包的大小。单位：字节。 3.6. +QIND: 'FOTA','DOWNLOAD' 模块固件下载结果 该 URC 指示模块固件下载结果。 +QIND: 'FOTA','DOWNLOAD' 模块固件下载结果 +QIND: 'FOTA','DOWNLOAD', 表示模块固件下载结果 参数 整型。固件下载结果。 0 固件包下载成功 2 内存不足，下载失败 4 连接断开，下载失败 9 平台下发了无效的 URL，下载失败 上海移远通信技术股份有限公司 20 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 3.7. +QIND: 'FOTA','START' 模块开始固件升级 该 URC 指示模块开始固件升级。 +QIND: 'FOTA','START' 模块开始固件升级 +QIND: 'FOTA','START' 表示模块开始固件升级 3.8. +QIND: 'FOTA','UPDATING' 模块固件升级进度 该 URC 指示模块固件升级进度。 +QIND: 'FOTA','UPDATING' 模块固件升级进度 +QIND: 'FOTA','UPDATING',, 表示模块固件升级进度 , 参数 整型。升级进度（百分比）。 整型。需要升级的程序总数；当前恒为 1。 整型。当前已升级和正在升级的程序数之和；当前恒为 1。 3.9. +QIND: 'FOTA','END' 模块固件升级结果 该 URC 指示模块固件升级结果。 +QIND: 'FOTA','END' 模块固件升级结果 +QIND: 'FOTA','END', 表示模块固件升级结果 参数 整型。固件升级结果。 0 升级成功 255 升级失败 上海移远通信技术股份有限公司 21 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 4 举例 本章节提供了有关如何应用与平台相关的 AT 命令以实现相关功能的示例。 4.1. 对接电信 IoT 平台 4.1.1. 平台侧配置 4.1.1.1. 创建设备 1. 登录电信 IoT 平台（网址：https://develop.ct10649.com:8093/#/login），在项目空间内，依次选 择'产品'-->'产品开发'，随后点击'新建产品'新建一款产品。 图 1：新建产品 上海移远通信技术股份有限公司 22 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 2. 在'创建产品'界面，选择'自定义产品'，点击'自定义产品'按钮即可开始自主开发一款产 品。 图 2：自定义产品 3. 在'设置产品信息'窗口，填写创建产品的信息，完成各参数的配置后，点击'创建'即可创建 新的产品。 图 3：填写创建产品的信息 上海移远通信技术股份有限公司 23 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 4. 进入新创建的产品，选择'Profile 定义'。 图 4：定义 Profile 5. 选择'编解码插件开发'，根据定义的 Profile 进行插件开发和部署，插件开发完成后点击右上角 的'部署'按钮。 图 5：开发编码器插件 上海移远通信技术股份有限公司 24 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 4.1.1.2. 在线调试 在入门阶段，开发者可以使用开发中心的虚拟设备模拟设备接入电信 IoT 平台的场景。在创建的产品 中，选择'在线调测'。 图 6：选择在线调测 图 7：模拟设备接入平台 备注 Profile 定义、插件开发以及在线调试的具体操作方式请参考中国电信平台开发文档。文档地址如下： https://develop.ct10649.com:8093/assets/docCenter/helpcenter/helpPortal/Portal/helpcenter.html?man ualName=UserGuide_ChinaTelecom&docSite=ChinaTelecom&page=gettingStarted&lang=zh 4.1.2. 模块侧对接电信 IoT 平台 AT 命令示例 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK //禁用休眠模式 上海移远通信技术股份有限公司 25 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 AT+NNMI=2 OK AT+CGPADDR? +CGPADDR: 0,'11.168.11.169' //将数据接收模式设置为缓存模式 //查询模块是否成功注网 //已注网，可以发起连接 OK AT+NCDPOPEN='180.101.147.115',5683 //将模块连接到平台的服务器 OK //命令执行成功 +QLWEVTIND: 0 //模块连接成功 +QLWEVTIND: 3 AT+NMGS=5,00454c4c4f OK //object 19/0/0 已成功订阅，可以发送数据 //向平台发送数据 +NNMI //接收来自平台的数据 AT+NQMGR BUFFERED=1,RECEIVED=1,DROPPED=0 //查询已接收消息状态 OK AT+NMGR +NMGR: 4,AAAA0000 //读取缓存数据 OK AT+NQMGR BUFFERED=0,RECEIVED=1,DROPPED=0 //查询已接收消息状态 OK AT+QSCLK=1 OK //启用浅休眠和深休眠 +QNBIOTEVENT: 'ENTER DEEPSLEEP' //进入深休眠 +QNBIOTEVENT: 'EXIT DEEPSLEEP' //从深休眠唤醒 +QLWEVTIND: 6 AT+QSCLK=0 OK AT+NNMI=1 OK AT+NMGS=7,'010548454c4c4f',100 OK //深休眠唤醒连接恢复成功 //禁用休眠模式 //将数据接收模式设置为直吐模式 //向平台发送数据 +QLWEVTIND: 4 上海移远通信技术股份有限公司 26 / 54 +NNMI: 4,AAAA0000 AT+QLWULDATASTATUS? +QLWULDATASTATUS: 4 OK AT+QSCLK=1 OK BC260Y-CN (R02) 中国电信物联网平台应用指导 //接收来自平台的数据 //查询 CON 消息发送状态 // CON 消息发送状态为发送成功 //启用浅休眠和深休眠 4.2. 对接电信 AEP 平台 4.2.1. 平台侧配置 4.2.1.1. 产品创建 1. 登录电信 AEP 平台（https://www.ctwing.cn），在'开发者中心'内选择'产品中心'，随后点 击'创建产品'，新建一款产品。 图 8：电信 AEP 平台首页 上海移远通信技术股份有限公司 27 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 图 9：产品中心 - 创建产品 2. 在'创建产品'界面，根据自己的需求编辑产品的各项配置（下图仅为举例说明，若第一次创建， 建议选择透传模式）。 图 10：创建产品 - 编辑产品配置 上海移远通信技术股份有限公司 28 / 54 4.2.1.2. 设备添加 进入创建好的产品，点击'添加设备'。 BC260Y-CN (R02) 中国电信物联网平台应用指导 图 11：添加设备 4.2.1.3. 设备激活后对象操作 1. 如下图，点击红色箭头所指图标，可查看对象（Object）。 图 12：查看对象（Object） 上海移远通信技术股份有限公司 29 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 2. 如下图，点击红色箭头所指图标，可查看平台接收数据。 图 13：查看接收数据（Object） 3. 在'Object 列表'中，可对其中的 Object 进行订阅、取消订阅和读写等操作。下图中右上方点击 '查看 Object 日志'，可查看之前执行的操作。 图 14：查看 Object 日志 备注 以上仅作为新手参考，更多内容请参考电信 AEP 平台的官方开发文档。文档地址如下： https://www.ctwing.cn/ksrm/22#see。 4.2.2. 模块侧对接电信 AEP 平台 AT 命令示例 RDY +CFUN: 1 上海移远通信技术股份有限公司 30 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 +CPIN: READY AT+QSCLK=0 OK AT+CSCON=1 OK AT+NNMI=1 OK AT+CGPADDR? +CGPADDR: 0,'11.40.70.201' //禁用休眠模式 //使能信令连接状态上报 //将数据接收模式设置为直吐模式 //查询模块是否成功注网 //已注网，可以发起连接 OK AT+NCFG=0,86400 OK AT+NCDPOPEN='221.229.214.202',5683 OK //配置 lifetime //将模块连接到平台的服务器 //命令执行成功 +QLWEVTIND: 0 +QLWEVTIND: 3 //模块连接成功 //object 19/0/0 已成功订阅，可以发送数据 AT+NMGS=7,'010548454c4c4f',1 OK //向平台发送 NON 数据并携带 RAI 为 1 +CSCON:0 AT+QSCLK=1 OK //RRC 连接快速释放 //启用浅休眠和深休眠 +QNBIOTEVENT: 'ENTER DEEPSLEEP' //进入深休眠 +QNBIOTEVENT: 'EXIT DEEPSLEEP' //从深休眠唤醒 +QLWEVTIND: 6 //深休眠唤醒连接恢复成功 AT+QSCLK=0 OK AT+NMGS=7,'010548454c4c4f',102 OK +CSCON:1 //禁用休眠模式 //向平台发送 CON 数据并携带 RAI 为 2 //RRC 建立成功 +QLWEVTIND: 4 +CSCON:0 //RRC 连接快速释放 上海移远通信技术股份有限公司 31 / 54 AT+QLWULDATASTATUS? +QLWULDATASTATUS: 4 OK AT+QSCLK=1 OK BC260Y-CN (R02) 中国电信物联网平台应用指导 //查询 CON 消息发送状态 //CON 消息发送状态为发送成功 //启用浅休眠和深休眠 上海移远通信技术股份有限公司 32 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 5 中国电信物联网平台 DFOTA 5.1. 电信 IoT 平台 DFOTA 本章节介绍 BC260Y-CN 模块如何在电信 IoT 平台进行 DFOTA 升级。 备注 本文档提及的电信 IoT 平台与华为 OceanConnect IoT 平台兼容。使用时需注意平台的版本是否相同。有 关中国电信 IoT 平台的详细信息，请访问官方地址：https://develop.local.ct10649.com:8843。 通过电信 IoT 平台进行 DFOTA 升级，主要包含以下步骤： 步骤 1： 确保设备在电信 IoT 平台上已成功注册，且能正常收发数据（第 5.1.1 章）。 步骤 2： 创建和导入设备。导入设备的 Profile 必须包含 omCapabilities 能力（第 5.1.2 章）。 步骤 3： 生成公私密钥文件，并上传公钥文件至平台（第 5.1.3 章）。 步骤 4： 从移远通信获取差分包，并使用私钥文件进行签名（第 5.1.4 章）。 步骤 5： 上传差分包至电信 IoT 平台（第 5.1.5 章）。 步骤 6： 在电信 IoT 平台创建升级任务并完成升级（第 5.1.6 章）。 5.1.1. 平台注册 在进行 DFOTA 升级之前，需确保设备在电信 IoT 平台上已成功注册，且能正常收发数据。 5.1.2. 创建应用 参考电信 IoT 平台官方文档完成应用的创建。创建应用时，导入设备的 Profile 必须包含 omCapabilities 能力（若未包含，请在 Profile 中添加如下 Profile 模板中的红色字体部分），否则在平台上将无法上传对应 设备的差分包，平台也无法对该设备创建固件升级任务。具体 Profile 开发指导请联系中国电信物联网平台 获取。 以下是支持升级的一个 Profile 模板，供参考： { 'devices': [ { 上海移远通信技术股份有限公司 33 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 'manufacturerId': 'quectel', 'manufacturerName': 'quectel', 'model': 'NBIoTDevice', 'protocolType': 'CoAP', 'deviceType': 'WaterMeter', 'omCapability':{ 'upgradeCapability' : { 'supportUpgrade':false }, 'fwUpgradeCapability' : { 'supportUpgrade':true, 'upgradeProtocolType':'LWM2M', 'downloadProtocolType':'CoAP' } }, 'serviceTypeCapabilities': [ { 'serviceId': 'Brightness', 'serviceType': 'Brightness', 'option': 'Master' }, { 'serviceId': 'WaterData', 'serviceType': 'WaterData', 'option': 'Optional' } ] } ] } 上海移远通信技术股份有限公司 34 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 5.1.3. 生成公私密钥及上传公钥 步骤 1： 登陆电信 IoT 平台，进入'系统管理'→'工具'→'离线签名工具'页面，然后点击下载 离线签名工具 signtool.zip。如下图所示。 图 15：工具下载页面 步骤 2： 运行 signtool.exe 打开工具，选择'签名算法'为'RSA2048+SHA256'，输入'加密口令'， 例如 Quectel123（由电信 IoT 平台分配）；点击'生成公私密钥'，将生成一对公私密钥文 件 private.pem 和 public.pem。如下图所示。 上海移远通信技术股份有限公司 图 16：生成公私密钥 35 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 步骤 3： 进入'设备管理'→'软件库'→'公钥管理'→'上传'页面，上传公钥文件 public.pem 到电信 IoT 平台，'厂商名称'须与应用 Profile 里的厂商名称对应，如下所示。 图 17：公钥上传页面 图 18：上传公钥文件 上海移远通信技术股份有限公司 36 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 5.1.4. 差分包获取及签名 5.1.4.1. 获取差分包 通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和目标版本信息提交给 移远通信或模块供应商以获取相应的差分包。 5.1.4.2. 对差分包进行签名 步骤 1： 运行 signtool.exe，在'签名算法'中选择私钥对应的'ECDSA_256K1+SHA256'签名算 法。 步骤 2： 在'私钥文件'中导入 private.pem 私钥文件并输入之前设置的密码，例如 Quectel123。 步骤 3： 在'需要数字签名的软件包'处导入差分包，须注意差分包的文件是 bin 格式，（例如 BC260YCNAAR02A01_BC260YCNAAR02A01_BETA1230A.bin），但对差分包进行数字签 名的文件格式需要是 zip 压缩文件，所以需要将差分包的 bin 文件压缩成 zip 格式的压缩文件 （例如 BC260YCNAAR02A01_BC260YCNAAR02A01_BETA1230A.zip）。 步骤 4： 点击'进行数字签名'，弹出签名成功后，在差分包同级目录下会生成文件名包含 signed 备 注 的 已 签 名 差 分 包 （ 例 如 BC260YCNAAR02A01_BC260YCNAAR02A01_BETA1230A _signed.zip）。 上海移远通信技术股份有限公司 37 / 54 整体流程如下图所示： BC260Y-CN (R02) 中国电信物联网平台应用指导 图 19：对差分包进行数字签名 备注 上 传 至 平 台 的 已 签 名 差 分 包 为 zip 格 式 ， 因 此 生 成 的 zip 格 式 的 已 签 名 差 分 包 （ 例 如 BC260YCNAAR02A01_BC260YCNAAR02A01_BETA1230A _signed.zip）不用做解压处理，可直接上传。 上海移远通信技术股份有限公司 38 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 5.1.5. 上传差分包 步骤 1： 登陆电信 IoT 平台，进入'设备管理'→'软件库'→'固件包管理'→'添加固件包'页 面。 图 20：进入添加差分包页面 步骤 2： 上 传 已 签 名 的 差 分 包 并 完 成 其 他 必 填 信 息 ， 如 下 图 所 示 。 例 如 ' 版 本 ' 填 写 为 ' BC260YCNAAR02A01_BETA1230A',' 设 备 类 型 ' 填 写 为 ' WaterMeter ' ,' 厂 商 名 称'填写为'quectel','型号'填写为'NBIoTDevice'，'协议'填写为'CoAP'。最 后点击'保存'按钮。 图 21：上传已签名差分包至电信 IoT 平台 上海移远通信技术股份有限公司 39 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 备注 设备类型、厂商名称、型号、协议必须与应用的 Profile 严格一致，否则上传差分包和 DFOTA 升级任务将 失败。 5.1.6. DFOTA 升级 5.1.6.1. 创建升级任务 步骤 1： 在'设备管理'→'群组'→'新建群组'中新增群组。完成必填字段后点击'确认'完成 添加，例如下图，新建的'群组名称'为'DFOTA'。 图 22：新增群组页面 上海移远通信技术股份有限公司 图 23：新增群组 40 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 步骤 2： 点击新建的群组名，例如'DFOTA'，在'设备管理'→'群组'→'群组管理 > DFOTA' 进入页面，再在'设备'页面中勾选对应设备后，点击'绑定设备'，将需要升级的设备绑 定到新增的群组。如下图所示。 图 24：绑定待升级设备 步骤 3： 在'设备管理'→'批量任务'→'批量软固件升级'→'固件升级'→'创建'弹出页面 中创建批量升级任务，如图所示。（下图中'任务名称'、'重试策略'和'重试次数'是 默认的参数设置，可根据需求自定义） 图 25：创建批量任务页面 上海移远通信技术股份有限公司 41 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 图 26：创建批量升级任务 步骤 4： 选择对应的差分固件升级包，完成平台升级任务的创建。如下图所示。 图 27：选择对应的差分固件升级包 上海移远通信技术股份有限公司 42 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 步骤 5： 选择需要升级的设备群组。如下图所示。 图 28：选择需要升级的设备群组 5.1.6.2. 设备升级 升级任务创建成功之后，终端设备发送上行数据包，即可触发平台的 DFOTA 升级，升级过程包括下载 差分固件升级包和更新固件。 +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 0,'26.166.237.58' //禁止深休眠 //查询本地 IP OK AT+NCDPOPEN='180.101.147.115',5683 OK +QLWEVTIND: 0 +QLWEVTIND: 3 +QLWEVTIND: 8 +QIND: 'FOTA','DOWNLOAD START' //发送注册请求 //注册成功 //订阅 object19/0/0 成功 //平台下发 observe /5/0/3 请求订阅升级状态 //终端设备开始下载差分包 上海移远通信技术股份有限公司 43 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 +QIND: 'FOTA','DOWNLOADING',512 //终端设备已下载 512 字节的差分包 … +QIND: 'FOTA','DOWNLOAD',0 //终端设备下载差分包过程中 //差分包下载完成 +QIND: 'FOTA','START' //终端设备开始本地升级 +QIND: 'FOTA','UPDATING',2%,1,1 … //终端设备本地升级过程中 //终端设备本地升级过程中 +QIND: 'FOTA','UPDATING',100%,1,1 +QIND: 'FOTA','END',0 //终端设备本地升级完成，等待重启 +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 0,'26.238.47.96' //再次执行注册流程 //禁止深休眠 //查询本地 IP OK AT+NCDPOPEN='180.101.147.115',5683 OK //发送注册请求 +QLWEVTIND: 0 //注册成功 +QLWEVTIND: 3 +QLWEVTIND: 9 //订阅 object19/0/0 成功 //平台下发取消 observe /5/0/3 订阅 模块固件升级完成，平台显示升级成功。如下图所示。 上海移远通信技术股份有限公司 图 29：升级成功 44 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 5.2. AEP 平台 DFOTA 本章主要描述如何通过电信 AEP 平台的 DFOTA 功能对移远通信 BC260Y-CN 模块进行升级。 备注 有关中国电信 AEP 平台的详细信息，请访问官方地址：https://www.ctwing.cn/。 通过电信 AEP 平台进行 DFOTA 升级，主要包含以下步骤： 步骤 1： 确保设备在电信 AEP 平台上已成功注册，且能正常收发数据（第 5.2.1 章）。 步骤 2： 获取和上传差分包到 AEP 平台（第 5.2.2 章）。 步骤 3： 创建 DFOTA 任务（第 5.2.3 章）。 步骤 4： 添加 DFOTA 设备（第 5.2.4 章）。 步骤 5： 升级设备（第 5.2.5 章）。 步骤 6： 查看升级结果（第 5.2.6 章）。 5.2.1. 平台注册 在进行 DFOTA 升级之前，需确保设备在电信 AEP 平台上已成功注册，且能正常收发数据。 5.2.2. 差分包获取及上传 5.2.2.1. 获取差分包 通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和目标版本信息提交给 移远通信或模块供应商以获取相应的差分包。 5.2.2.2. 上传差分包至 AEP 平台 上传差分包到 AEP 平台前，需先从供应商处获取差分固件升级包，然后登录 AEP 平台控制台，点击 '远程升级管理'，选择'FOTA 升级'→'固件管理'→'创建固件版本'，将固件信息上传至云端。 图 30：DFOTA 选择固件管理 上海移远通信技术股份有限公司 45 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 图 31：创建固件版本 5.2.3. 创建 DFOTA 任务 登录 AEP 平台控制台，选择'远程升级管理'→'创建任务'，填写任务名称和固件版本之后，即可 创建升级任务。 图 32：选择创建任务 上海移远通信技术股份有限公司 46 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 图 33：创建升级任务 5.2.4. 添加 DFOTA 设备 选择'远程升级管理'，选中创建的任务名称（下图中任务名称为 test），点击任务设备管理图标，选 择需要升级的设备，点击'加入升级'，如下图所示。 图 34：选择升级设备管理 图 35：选择升级设备 上海移远通信技术股份有限公司 47 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 5.2.5. DFOTA 升级 步骤 1： 选择'远程升级管理'后，点击下图标记为 1 的图标（启动升级图标），然后选择'立即启 动'，如下图所示。 图 36：启动升级 步骤 2： 设置平台升级任务后，设备注册到平台，收到平台下发的 observe 请求后，随即开始升级。 如果设备在设置平台升级任务前已注册到平台，在上行一次数据后，即开始升级。示例如下： +CPIN: READY AT+CGPADDR? +CGPADDR: 0,'26.166.237.58' //查询本地 IP OK AT+QSCLK=0 OK AT+NCFG=0,86400 OK AT+NCDPOPEN='221.229.214.202',5683 OK +QLWEVTIND: 0 //禁止深休眠 //配置 lifetime //发送注册请求 //注册成功 +QLWEVTIND: 3 +QLWEVTIND: 8 //订阅 object19/0/0 成功 //平台下发 observe /5/0/3 请求订阅升级状态 +QIND: 'FOTA','DOWNLOAD START' //终端设备开始下载固件升级包 +QIND: 'FOTA','DOWNLOADING',512 ... //终端设备已下载 512 字节差分包 //终端设备下载固件过程中 +QIND: 'FOTA','DOWNLOAD',0 //差分包下载完成 上海移远通信技术股份有限公司 48 / 54 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',2%,1,1 ... +QIND: 'FOTA','UPDATING',100%,1,1 +QIND: 'FOTA','END',0 +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 0,'26.238.47.96' OK AT+NCFG=0,86400 OK AT+NCDPOPEN='221.229.214.202',5683 OK +QLWEVTIND: 0 +QLWEVTIND: 3 +QLWEVTIND: 9 BC260Y-CN (R02) 中国电信物联网平台应用指导 //终端设备开始本地升级 //终端设备本地升级过程中 //终端设备本地升级过程中 //终端设备本地升级完成 //终端设备本地升级完成，等待重启 //再次执行注册流程 //禁止深休眠 //查询本地 IP //配置 lifetime //发送注册请求 //注册成功 //订阅 object19/0/0 成功 //平台下发取消 observe /5/0/3 订阅 5.2.6. 查看升级结果 模块升级后，可以在 AEP 平台上查看升级结果。成功升级后平台显示如下： 图 37：AEP 平台升级结果 上海移远通信技术股份有限公司 49 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 5.3. DFOTA 过程说明及注意事项 5.3.1. 过程说明 5.3.1.1. 下载阶段 1. 当终端发起注册或者上报数据到平台，平台感知终端在线，如果平台有升级任务，则会下发请求查 询版本号、小区 ID、信号强度以及升级状态等。 2. 如果平台判断可以发起升级，则会下发 observe /5/0/3 请求订阅升级状态，订阅成功之后平台下发 升级包 URI 给终端。模块获取平台下发的 URI 之后，升级状态从 IDLE 转换成 DOWNLOADING， 模块通知终端 MCU 开始从平台下载升级包数据，模块会发送 +QIND: 'FOTA','DOWNLOAD START' 给终端 MCU，此时终端 MCU 不可给模块断电，也不可发送数据传输相关的 AT 命令。 如果下载过程中发生异常导致下载失败，升级状态将从 DOWNLOADING 转换到 IDLE，模块同时 向终端 MCU 发送 +QIND: 'FOTA','DOWNLOAD',4，此时若设备已正常联网注册，则终端 MCU 可以正常处理业务。之后平台的服务器下发 read /5/0/5 请求查询失败原因。 3. 若升级包下载完成，升级状态由 DOWNLOADING 转换到 DOWNLOADED，模块向终端 MCU 发 送 +QIND: 'FOTA','DOWNLOAD',0。 5.3.1.2. 升级阶段 当校验完成，平台下发 execute /5/0/2 请求模块升级，升级状态由 DOWNLOADED 转换到 UPDATING， 模块向终端 MCU 发送+QIND: 'FOTA','START'。在此状态下，终端 MCU 不可将模块断电，不可发送数 据传输相关 AT 命令。 5.3.2. 错误说明 5.3.2.1. 下载失败错误码 下载失败，模块向终端 MCU 发送 +QIND: 'FOTA','DOWNLOAD',，有关错误码信息请参考此 URC 参数说明。 5.3.2.2. 升级结束阶段及升级错误码 若升级成功，模块向终端 MCU 发送 +QIND: 'FOTA','END',0，模块会自动重启，需要终端 MCU 再 次执行注册平台流程，以便模块向平台上报升级结果。若升级失败，模块向终端 MCU 发送 +QIND: 'FOTA','END',，有关错误码信息请参考此 URC 参数说明。 上海移远通信技术股份有限公司 50 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 5.3.3. 注意事项 ⚫ DFOTA 过程中若终端 MCU 对模块进行断电、重启等操作，可能会造成模块 DFOTA 升级失败。因 此，在此期间，终端 MCU 需终止业务，禁止向模块发送 AT 命令，禁止断电、重启模块等操作。 ⚫ 如果需要发起 DFOTA 业务，需要执行 AT+QSCLK=0 关闭深睡眠，以避免网络状况不佳时，模块 进入休眠模式影响 DFOTA 升级。特别说明在模组上报+QIND: 'FOTA','DOWNLOAD START'后， 请确定已经关闭了深休眠。 ⚫ 若平台任务创建成功，模块发送一包数据未触发升级，可尝试多发几包数据，此为正常现象。 上海移远通信技术股份有限公司 51 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 6 错误码概览 本章节介绍了与 BC260Y-CN 模块与平台对接相关的错误码。 表 3：平台相关错误码 1 2 3 5 8 14 16 17 303 801 950 951 952 953 954 955 957 958 英文含义 中文含义 CTIOT_EB_OTHER 其它错误 CTIOT_EB_PARAMETER_NUM_ERROR 参数数量错误 CTIOT_EB_PARAMETER_VALUE_ERROR 参数值错误 CTIOT_ED_PSK_ERROR PSK 设置错误 CTIOT_EA_PARAM_NOT_INTIALIZED 连接参数未初始错误 CTIOT_EB_DATA_LENGTH_OVERRRUN Data 字段长度超过上限 CTIOT_EA_CONNECT_FAILED_SIMCARD 连接不可用，卡原因等 CTIOT_EB_DATA_LENGTH_NOT_EVEN Data 字段长度不是偶数 CTIOT_EE_OPERATOR_NOT_SUPPORTED 该操作不支持 CTIOT_EB_NO_RECV_DATA 无接收数据 CTIOT_EA_ENGINE_EXCEPTION Engine 异常 CTIOT_EA_NETWORK_TRAFFIC 连接不可用，网络拥塞 CTIOT_EA_SIGNAL_LEVEL2 操作失败，覆盖等级差 CTIOT_EA_ENGINE_REBOOT Engine 异常，需 reboot 重启 CTIOT_EA_NOT_LOGIN 操作失败，未登录 CTIOT_EA_LOGIN_PROCESSING 操作失败，登录中 CTIOT_EA_CONNECT_USELESS_TEMP 连接暂时不可用 CTI- 操作失败，不存在会话 上海移远通信技术股份有限公司 52 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 OT_EA_OPERATION_FAILED_NOSESSION 959 CTIOT_EA_OPERATION_NOT_PERMITTED 操作不允许 960 CTIOT_EA_OPERATION_NO_AUTHSTR 操作失败，SIMID 认证，未设置认证 备注 可以使用 AT+CMEE=设置禁用（=0）或者使能（=1、=2）最终结果码的+CME EROR: 的上报。有关该命令的使用详情，请参考文档 [1]。 上海移远通信技术股份有限公司 53 / 54 BC260Y-CN (R02) 中国电信物联网平台应用指导 7 附录 A 参考文档及术语缩写 表 4：参考文档 编号 [1] 文档名称 Quectel_BC260Y-CN_AT 命令手册 备注 BC260Y-CN 模块 AT 命令说明手册 表 5：术语缩写 缩写 ACK CoAP eDRX IMEI IoT IP LwM2M NB-IoT PSM RAI REST RRC URC URL 英文全称 Acknowledgement Constrained Application Protocol Extended Discontinuous Receive International Mobile Equipment Identity Internet of Things Internet Protocol Lightweight Machine to Machine Narrow Band Internet of Things Power Saving Mode Release Assistance Indication Representational State Transfer Radio Resource Control Unsolicited Result Code Uniform Resource Locator 中文全称 确认消息 受限应用协议 扩展型非连续接收 国际移动设备识别码 物联网 互联网协议 轻量型物联网（协议） 窄带物联网（技术） 省电模式 释放辅助指示 表述性状态转移 无线资源控制 非请求结果码 统一资源定位符 上海移远通信技术股份有限公司 54 / 54

BC28-F&BC95-GF 中国电信物联网平台 DFOTA 应用指导 NB-IoT 模块系列 版本：1.0 日期：2021-05-27 状态：受控文件 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司不 承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功能 错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的使 用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任何 因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权使 用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追究 法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021 保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 文档历史 修订记录 版本 日期 作者 - 2021-04-06 Jack QIAN 1.0 2021-05-27 Jack QIAN 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................3 表格索引 ..................................................................................................................................................... 4 图片索引 ..................................................................................................................................................... 5 1 引言.....................................................................................................................................................6 2 电信 IoT 平台 DFOTA .........................................................................................................................7 2.1. 平台注册 ...................................................................................................................................7 2.2. 创建应用 ...................................................................................................................................7 2.3. 生成公私密钥及上传公钥文件...................................................................................................9 2.4. 差分包获取及签名................................................................................................................... 11 2.4.1. 获取差分包................................................................................................................... 11 2.4.2. 对差分包进行签名 ........................................................................................................ 11 2.5. 上传差分包 .............................................................................................................................13 2.6. DFOTA 升级 ...........................................................................................................................14 2.6.1. 创建升级任务 ...............................................................................................................14 2.6.2. 设备升级 ......................................................................................................................17 3 电信 AEP 平台 DFOTA .....................................................................................................................19 3.1. 平台注册 .................................................................................................................................19 3.2. 差分包获取及上传...................................................................................................................19 3.2.1. 获取差分包...................................................................................................................19 3.2.2. 上传差分包至 AEP 平台 ...............................................................................................20 3.3. 创建 DFOTA 任务 ...................................................................................................................21 3.4. 添加 DFOTA 设备 ...................................................................................................................22 3.5. DFOTA 升级 ...........................................................................................................................22 3.6. 查看升级结果..........................................................................................................................23 4 DFOTA 过程说明及注意事项.............................................................................................................24 4.1. 过程说明 .................................................................................................................................24 4.1.1. 下载阶段 ......................................................................................................................24 4.1.2. 升级阶段 ......................................................................................................................24 4.1.3. 恢复网络阶段 ...............................................................................................................24 4.2. 注意事项 .................................................................................................................................25 5 终端 MCU 适配建议...........................................................................................................................26 5.1. 查询方式通讯说明...................................................................................................................26 5.2. 中断方式通讯说明...................................................................................................................26 5.2.1. 中断方式通讯说明（单 MCU） ....................................................................................26 5.2.2. 中断方式通讯说明（双 MCU） ....................................................................................27 6 附录 A 参考文档及术语缩写 ..............................................................................................................28 上海移远通信技术股份有限公司 3 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 表格索引 表 1：DFOTA 过程中终端注意事项 ......................................................................................................... 25 表 2：未收到'FIRMWARE UPDATE OVER'时终端处理方法 .................................................................. 25 表 3：参考文档........................................................................................................................................ 28 表 4：术语缩写........................................................................................................................................ 28 上海移远通信技术股份有限公司 4 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 图片索引 图 1：工具下载页面................................................................................................................................... 9 图 2：生成公私密钥................................................................................................................................... 9 图 3：公钥上传页面................................................................................................................................. 10 图 4：上传公钥文件................................................................................................................................. 10 图 5：对差分包进行数字签名 .................................................................................................................. 12 图 6：进入添加差分包页面 ...................................................................................................................... 13 图 7：上传已签名差分包至电信 IoT 平台................................................................................................. 13 图 8：新增群组页面................................................................................................................................. 14 图 9：新增群组........................................................................................................................................ 14 图 10：绑定待升级设备 ........................................................................................................................... 15 图 11：创建批量任务页面........................................................................................................................ 15 图 12：创建批量升级任务........................................................................................................................ 16 图 13：选择对应的差分固件升级包 ......................................................................................................... 16 图 14：选择需要升级的设备群组............................................................................................................. 17 图 15：电信 IoT 平台 DFOTA 升级成功 ................................................................................................... 18 图 16：DFOTA 选择固件管理 .................................................................................................................. 20 图 17：创建固件版本............................................................................................................................... 20 图 18：选择创建任务............................................................................................................................... 21 图 19：创建升级任务............................................................................................................................... 21 图 20：选择升级设备管理........................................................................................................................ 22 图 21：选择升级设备............................................................................................................................... 22 图 22：启动升级...................................................................................................................................... 22 图 23：AEP 平台升级结果....................................................................................................................... 23 图 24：终端单 MCU 功能连接框图 .......................................................................................................... 26 图 25：终端双 MCU 功能连接框图 .......................................................................................................... 27 上海移远通信技术股份有限公司 5 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 1 引言 移远通信 BC28-F 和 BC95-GF 模块支持固件空中差分升级（DFOTA）功能。此功能可以通过固件差 分包实现模块固件的无线升级或降级。所述差分包仅包含当前固件版本和目标固件版本之间的差异，因此 数据传输量大大降低、传输时间大大缩短。 本文档主要介绍如何基于中国电信物联网平台（以下简称'平台'）通过 DFOTA 为 BC28-F 和 BC95-GF 模块进行固件升级。 备注 本文档中所述的中国电信物联网平台，包含'中国电信物联网开放平台-连接管理子系统'（本文简称'电 信 IoT 平台'）和'CTWing 中国电信物联网开放平台'（本文简称'电信 AEP 平台'）。 上海移远通信技术股份有限公司 6 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 2 电信 IoT 平台 DFOTA 本章节介绍 BC28-F 和 BC95-GF 模块如何在电信 IoT 平台进行 DFOTA 升级。 备注 本文档提及的电信 IoT 平台与华为 OceanConnect IoT 平台兼容。使用时需注意平台的版本是否相同。 有关中国电信 IoT 平台的详细信息，请访问官方地址：https://device.local.ct10649.com:8843。 通过电信 IoT 平台进行 DFOTA 升级，主要包含以下步骤： 步骤 1： 确保设备在电信 IoT 平台上已成功注册，且能正常收发数据（请参考第 2.1 章）。 步骤 2： 创建和导入设备。导入设备的 Profile 必须包含 omCapabilities 能力（请参考第 2.2 章）。 步骤 3： 生成公私密钥文件，并上传公钥文件至平台（请参考第 2.3 章）。 步骤 4： 获取差分包，并使用私钥文件进行签名（请参考第 2.4 章）。 步骤 5： 上传差分包至电信 IoT 平台（请参考第 2.5 章）。 步骤 6： 在电信 IoT 平台创建升级任务并完成升级（请参考第 2.6 章）。 2.1. 平台注册 在进行 DFOTA 升级之前，需确保设备在电信 IoT 平台上已成功注册，且能正常收发数据。 2.2. 创建应用 参考电信 IoT 平台官方文档完成应用的创建。创建应用时，导入设备的 Profile 必须包含 omCapabilities 能力（若未包含，请在 Profile 中添加如下 Profile 模板中的红色字体部分），否则在平台上将无法上传对应 设备的差分包，平台也无法对该设备创建固件升级任务。具体 Profile 开发指导请联系中国电信物联网平台 获取。 备注 电信 IoT 平台账号注册及可参考的电信 IoT 平台官方文档，均由中国电信提供。 上海移远通信技术股份有限公司 7 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 以下是支持升级的一个 Profile 模板，供参考： { 'devices': [ { 'manufacturerId': 'quectel', 'manufacturerName': 'quectel', 'model': 'NBIoTDevice', 'protocolType': 'CoAP', 'deviceType': 'WaterMeter', 'omCapability':{ 'upgradeCapability' : { 'supportUpgrade':false }, 'fwUpgradeCapability' : { 'supportUpgrade':true, 'upgradeProtocolType':'LWM2M', 'downloadProtocolType':'CoAP' } }, 'serviceTypeCapabilities': [ { 'serviceId': 'Brightness', 'serviceType': 'Brightness', 'option': 'Master' }, { 'serviceId': 'WaterData', 'serviceType': 'WaterData', 'option': 'Optional' } ] } ] } 上海移远通信技术股份有限公司 8 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 2.3. 生成公私密钥及上传公钥文件 步骤 1： 登陆电信 IoT 平台，进入'系统管理'→'工具'→'离线签名工具'页面，然后点击下载 离线签名工具 signtool.zip。如下图所示。 图 1：工具下载页面 步骤 2： 运行 signtool.exe 打开工具，选择'签名算法'为'ECDSA_256K1+SHA256'（签名算法 由工具决定），输入'加密口令'，例如 Quectel123（由电信 IoT 平台分配）；点击'生成公 私密钥'，将生成一对公私密钥文件 private.pem 和 public.pem。步骤如下图所示。 上海移远通信技术股份有限公司 图 2：生成公私密钥 9 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 步骤 3： 进入'设备管理'→'软件库'→'公钥管理'→'上传'页面，上传公钥文件 public.pem 到 电信 IoT 平台，'厂商名称'须与应用 Profile 里的厂商名称对应，如下所示。 图 3：公钥上传页面 图 4：上传公钥文件 上海移远通信技术股份有限公司 10 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 2.4. 差分包获取及签名 2.4.1. 获取差分包 通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和目标版本信息提交给 移远通信或模块供应商以获取相应的差分包。 2.4.2. 对差分包进行签名 步骤 1： 运行 signtool.exe，在'签名算法'中选择私钥文件对应的'ECDSA_256K1+SHA256'签名 算法。 步骤 2： 在'私钥文件'中导入 private.pem 私钥文件并输入之前设置的密码，例如 Quectel123。 步骤 3： 在'需要数字签名的软件包'处导入差分包，须注意差分包的文件是 bin 格式，（例如 BC95GFFAR01A04_BC95GFFAR01A04_BETA0301A.bin），但对差分包进行数字签名的文 件格式需要是 zip 压缩文件，所以需要将差分包的 bin 文件压缩成 zip 格式的压缩文件（例如 BC95GFFAR01A04_BC95GFFAR01A04_BETA0301A.zip）。 步骤 4： 点击'进行数字签名'，弹出签名成功后，在差分包同级目录下会生成文件名包含 signed 备 注的已签名差分包（例如 BC95GFFAR01A04_BC95GFFAR01A04_BETA0301A_signed.zip）。 上海移远通信技术股份有限公司 11 / 28 整体流程如下图所示： BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 图 5：对差分包进行数字签名 备注 上 传 至 平 台 的 已 签 名 差 分 包 为 zip 格 式 ， 因 此 生 成 的 zip 格 式 的 已 签 名 差 分 包 （ 例 如 BC95GFFAR01A04_BC95GFFAR01A04_BETA0301A_signed.zip）不用做解压处理，可直接上传。 上海移远通信技术股份有限公司 12 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 2.5. 上传差分包 步骤 1： 登陆电信 IoT 平台，进入'设备管理'→'软件库'→'固件包管理'→'添加固件包'页面。 图 6：进入添加差分包页面 步骤 2： 上 传 已 签 名 的 差 分 包 并 完 成 其 他 必 填 信 息 ， 如 下 图 所 示 。 例 如 ' 版 本 ' 填 写 为 'BC95GFFAR01A04_BETA0301A','设备类型'填写为'WaterMeter','厂商名称'填 写为'quectel','型号'填写为'NBIoTDevice'，'协议'填写为'CoAP'。最后点击 '保存'按钮。 图 7：上传已签名差分包至电信 IoT 平台 上海移远通信技术股份有限公司 13 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 备注 设备类型、厂商名称、型号、协议必须与应用的 Profile 严格一致，否则上传差分包和 DFOTA 升级任务 将失败。 2.6. DFOTA 升级 2.6.1. 创建升级任务 步骤 1： 在'设备管理'→'群组'→'新建群组'中新增群组。完成必填字段后点击'确认'完成添 加，例如下图，新建的'群组名称'为'DFOTA'。 图 8：新增群组页面 上海移远通信技术股份有限公司 图 9：新增群组 14 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 步骤 2： 点击新建的群组名，例如'DFOTA'，在'设备管理'→'群组'→'群组管理 > DFOTA' 进入页面，再在'设备'页面中勾选对应设备后，点击'绑定设备'，将需要升级的设备绑定 到新增的群组。如下图所示。 图 10：绑定待升级设备 步骤 3： 在'设备管理'→'批量任务'→'批量软固件升级'→'固件升级'→'创建'弹出页面中 创建批量升级任务，如图所示。（下图中'任务名称'、'重试策略'和'重试次数'是默认的 参数设置，可根据需求自定义） 图 11：创建批量任务页面 上海移远通信技术股份有限公司 15 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 图 12：创建批量升级任务 步骤 4： 选择对应的差分固件升级包，完成平台升级任务的创建。如下图所示。 图 13：选择对应的差分固件升级包 上海移远通信技术股份有限公司 16 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 步骤 5： 选择需要升级的设备群组。如下图所示。 图 14：选择需要升级的设备群组 2.6.2. 设备升级 设置平台升级任务后，设备注册到平台，收到平台下发的 observe 请求后，随即开始升级。如果设备 在设置平台升级任务前已注册到平台，则在上行一次数据后，随即开始升级。示例如下： REBOOT_CAUSE_APPLICATION_POWER_ON_RESET //模块已配置开机自动注册 IoT 平台 OK +QLWEVTIND:0 +QLWEVTIND:3 +QLWEVTIND:5 //平台下发 observe/5/0/3 请求订阅升级状态 FIRMWARE DOWNLOADING //开始下载固件升级包 FIRMWARE DOWNLOADED //下载固件升级包完成 FIRMWARE UPDATING //开始本地固件更新 上海移远通信技术股份有限公司 17 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 REBOOT_CAUSE_APPLICATION_POWER_ON_RESET //模块自动重启 OK FIRMWARE UPDATE SUCCESS //固件升级成功 +QLWEVTIND:0 //注册到中国电信 IoT 平台 +QLWEVTIND:3 //平台订阅资源 19/0/0 FIRMWARE UPDATE OVER //升级完成 模块固件升级完成，平台显示升级成功。如下图所示。 图 15：电信 IoT 平台 DFOTA 升级成功 上海移远通信技术股份有限公司 18 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 3 电信 AEP 平台 DFOTA 本章节主要描述如何通过电信 AEP 平台的 DFOTA 功能对移远通信 BC28-F 和 BC95-GF 模块进行升 级。 备注 有关中国电信 AEP 平台的详细信息，请访问官方地址：https://www.ctwing.cn/。 通过电信 AEP 平台进行 DFOTA 升级，主要包含以下步骤： 步骤 1： 确保设备在电信 AEP 平台上已成功注册，且能正常收发数据（请参考第 3.1 章）。 步骤 2： 获取和上传差分包到 AEP 平台（请参考第 3.2 章）。 步骤 3： 创建 DFOTA 任务（请参考第 3.3 章）。 步骤 4： 添加 DFOTA 设备（请参考第 3.4 章）。 步骤 5： 升级设备（请参考第 3.5 章）。 步骤 6： 查看升级结果（请参考第 3.6 章）。 3.1. 平台注册 在进行 DFOTA 升级之前，需确保设备在电信 AEP 平台上已成功注册，且能正常收发数据。 3.2. 差分包获取及上传 3.2.1. 获取差分包 通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和目标版本信息提交给 移远通信或模块供应商以获取相应的差分包。 上海移远通信技术股份有限公司 19 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 3.2.2. 上传差分包至 AEP 平台 上传差分包到 AEP 平台前，需先从供应商处获取差分固件升级包，然后登录 AEP 平台控制台，点击 '远程升级管理'，选择'FOTA 升级'→'固件管理'→'创建固件版本'，将固件信息上传至云端。 图 16：DFOTA 选择固件管理 图 17：创建固件版本 上海移远通信技术股份有限公司 20 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 3.3. 创建 DFOTA 任务 登录 AEP 平台控制台，选择'远程升级管理'→'创建任务'，填写任务名称和固件版本之后，即可 创建升级任务。 图 18：选择创建任务 图 19：创建升级任务 上海移远通信技术股份有限公司 21 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 3.4. 添加 DFOTA 设备 选择'远程升级管理'，选中创建的任务名称（下图中任务名称为 TEST），点击任务设备管理图标， 选择需要升级的设备，点击'加入升级'，如下图所示。 图 20：选择升级设备管理 图 21：选择升级设备 3.5. DFOTA 升级 步骤 1： 选择'远程升级管理'后，点击下图标记为 1 的图标（启动升级图标），然后选择'立即启 动'，如下图所示。 图 22：启动升级 上海移远通信技术股份有限公司 22 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 步骤 2： 设置平台升级任务后，设备注册到平台，收到平台下发的 observe 请求后，随即开始升级。 如果设备在设置平台升级任务前已注册到平台，则在上行一次数据后，随即开始升级。示例 如下： REBOOT_CAUSE_APPLICATION_POWER_ON_RESET //模块已配置开机自动注册 AEP 平台 OK +QLWEVTIND:0 +QLWEVTIND:3 +QLWEVTIND:5 //平台下发 observe/5/0/3 请求订阅升级状态 FIRMWARE DOWNLOADING //开始下载固件升级包 FIRMWARE DOWNLOADED //下载固件升级包完成 FIRMWARE UPDATING //开始本地固件更新 REBOOT_CAUSE_APPLICATION_POWER_ON_RESET //模块自动重启 OK FIRMWARE UPDATE SUCCESS //固件升级成功 +QLWEVTIND:0 //注册到中国电信 AEP 平台 +QLWEVTIND:3 //平台订阅资源 19/0/0 FIRMWARE UPDATE OVER //升级完成 3.6. 查看升级结果 模块升级后，可以在 AEP 平台上查看升级结果。成功升级后平台显示如下： 图 23：AEP 平台升级结果 上海移远通信技术股份有限公司 23 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 4 DFOTA 过程说明及注意事项 4.1. 过程说明 4.1.1. 下载阶段 1. 当终端发起注册或者上报数据到平台，平台感知到终端在线，如果平台有升级任务，则会下发请求 查询版本号、小区 ID、信号强度以及升级状态等。 2. 如果平台判断可以发起升级，则会下发 observe/5/0/3 请求订阅升级状态，订阅成功之后平台下发 升级包 URI 给终端。模块获取平台下发的 URI 之后，升级状态从 IDLE 转换成 DOWNLOADING， 模块通知终端 MCU 开始从平台下载升级包数据，模块会发送'FIRMWARE DOWNLOADING'给 终端 MCU，此时终端 MCU 不可给模块断电，也不可发送数据传输相关的 AT 命令。如果下载过程 中发生异常导致下载失败，升级状态会从 DOWNLOADING 转换到 IDLE，模块同时向终端 MCU 发送'FIRMWARE DOWNLOAD FAILED'，此时若设备已正常联网注册，则终端 MCU 可以正常 处理业务。之后平台的服务器下发 read/5/0/5 请求查询失败原因，并下发 observe cancel 请求（模 块自动完成），模块停止 DFOTA 任务，并向终端 MCU 发送'FIRMWARE UPDATE OVER'，表 示 DFOTA 任务结束。 3. 若升级包下载完成并校验成功，升级状态由 DOWNLOADING 转换到 DOWNLOADED，模块向终 端 MCU 发送'FIRMWARE DOWNLOADED'。若升级包下载完成但校验失败，升级状态转换到 IDLE，平台的服务器将查询失败原因，下发 observe cancel 请求，模块会停止 DFOTA 任务，并向 终端 MCU 发送'FIRMWARE UPDATE OVER'，表示 DFOTA 任务结束，终端 MCU 可以正常处 理业务。 4.1.2. 升级阶段 当校验完成，平台下发 execute/5/0/2 请求模块升级（模块自动完成），升级状态由 DOWNLOADED 转 换到 UPDATING，模块向终端 MCU 发送'FIRMWARE UPDATING'。在此状态，终端 MCU 不可给模块 断电，也不可发送数据传输相关 AT 命令。 4.1.3. 恢复网络阶段 ⚫ 若升级成功：升级状态由 UPDATING 转换到 IDLE，模块向终端 MCU 发送'FIRMWARE UPDATE SUCCESS'，待模块成功入网后，终端 MCU 可以正常处理业务。平台服务器下发 observe cancel 请求后，模块会停止 DFOTA 任务，并向终端 MCU 发送'FIRMWARE UPDATE OVER'，表示 上海移远通信技术股份有限公司 24 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 DFOTA 任务结束，终端 MCU 可以正常处理业务。 ⚫ 若升级失败：升级状态由 UPDATING 转换到 DOWNLOADED，模块向终端 MCU 发送'FIRMWARE UPDATE FAILED'，等待模块成功入网后，终端 MCU 可以开始正常处理业务。之后平台的服务器 查询失败原因，并下发 observe cancel 请求，模块则会停止 DFOTA 任务，并向终端 MCU 发送 'FIRMWARE UPDATE OVER'，表示 DFOTA 任务结束，终端 MCU 可以正常处理业务。 4.2. 注意事项 DFOTA 过程中若终端 MCU 对模块进行断电、重启、休眠等操作，可能会造成模块 DFOTA 失败。因 此，在此期间，终端 MCU 需要终止业务，禁止向模块发送 AT 命令，禁止断电、重启、休眠模块等操作。 表 1：DFOTA 过程中终端注意事项 序号 1 2 3 DFOTA 过程中终端注意事项 模块收到平台模块的升级消息，发送'FIRMWARE DOWNLOADING'消息通知终端 MCU，模 块要开始自身软件升级。 终端 MCU 收到模块的'FIRMWARE DOWNLOADING'消息后，需进入 DFOTA 升级保护状 态，应该确保模块不断电、不休眠、不发送数据传输相关的 AT 命令给模块。 模块 DFOTA 完成后，发送'FIRMWARE UPDATE OVER'消息给终端 MCU，表示 DFOTA 任 务结束，终端 MCU 可以正常处理业务。 终端 MCU 收到'FIRMWARE DOWNLOADING'消息后，如果持续 35 分钟没有收到'FIRMWARE UPDATE OVER'消息，建议参考下表处理： 表 2：未收到'FIRMWARE UPDATE OVER'时终端处理方法 所处状态 FIRMWARE DOWNLOADING FIRMWARE DOWNLOADED FIRMWARE UPDATING FIRMWARE UPDATE SUCCESS FIRMWARE DOWNLOAD FAILED FIRMWARE UPDATE FAILED 处理方法 重启模块，重启后 MCU 需确保模块不掉电直到模块输出 'FIRMWARE UPDATE OVER'消息（最长 35 分钟） 重启模块，重启后 MCU 需确保模块不掉电直到模块输出 'FIRMWARE UPDATE OVER'消息（最长 35 分钟） 重启模块，重启后 MCU 需确保模块不掉电直到模块输出 'FIRMWARE UPDATE OVER'消息（最长 35 分钟） 无需处理，可进行正常业务 无需处理，可进行正常业务 无需处理，可进行正常业务 上海移远通信技术股份有限公司 25 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 5 终端 MCU 适配建议 模块通过串口和终端 MCU 进行通讯，当前主要有两种串口通讯方式：查询方式和中断方式。建议在通 过 DFOTA 进行模块固件升级时，根据实际情况适配终端 MCU。 5.1. 查询方式通讯说明 当采用查询方式进行模块与终端 MCU 之间的通讯时： 1. 每次终端 MCU 发送完消息，需要等待监听串口新消息，导致终端 MCU 被串口监听任务占用，不 能及时处理自身业务； 2. 如果终端每次发送完数据后长时间被监听串口任务占用，会导致功耗增大； 3. 模块 DFOTA 使用概率极低，如果每天为确认是否有 DFOTA 升级进行等待，引起功耗增加，电池 损耗增加。 5.2. 中断方式通讯说明 5.2.1. 中断方式通讯说明（单 MCU） 当终端只有一个 MCU，同时负责终端自身业务以及终端和模块的通讯时： 图 24：终端单 MCU 功能连接框图 上海移远通信技术股份有限公司 26 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 1. 终端 MCU 和模块的串口通讯，建议采用中断方式，避免查询方式条件下终端 MCU 等待模块消息 时间过长，影响终端检测业务； 2. 每次终端 MCU 上报数据发送完成后，串口工作在中断方式下，响应模块串口输出的升级提示信息 （中断服务程序只做响应和简单接收，不做大任务处理，避免长时间占用中断）； 3. 采用中断方式，在终端 MCU 等待模块消息的同时，可以处理自身其他业务； 4. 当终端 MCU 中断以响应接收到模块输出的'FIRMWARE DOWNLOADING'消息后，终端 MCU 需要遵从表 2 中的处理方法，并进入 DFOTA 升级保护模式，不对模块断电、不发送数据传输相关 的 AT 命令给模块。 5.2.2. 中断方式通讯说明（双 MCU） 当终端有两个 MCU，一个负责终端自身业务，一个负责终端和模块的通讯时，负责与模块串口通讯的 MCU2 不会影响到处理终端自身业务的 MCU1；这种场景下，MCU2 既可以采用串口查询方式监听模块消 息，也可使用中断方式工作。如下图所示： 图 25：终端双 MCU 功能连接框图 1. 如果 MCU2 采用中断方式，具体实现方法请参照第 5.2.1 章； 2. 如果 MCU2 采用查询方式仅处理模块串口消息，每次 MCU1 完成自身业务数据发送后，MCU2 需 要等待监听串口消息至少 2 分钟，以确认是否有 DFOTA 升级以及其他串口消息，等待期间终端业 务由 MCU1 进行处理； 3. 串口采用查询方式时，由于 MCU1、MCU2 有等待时间，会导致功耗增大； 4. DFOTA 使用概率极低，每天增加等待时间，电池损耗较大，因此系统设计时应注意避免使用电池 供电，或者详细评估电池供电容量以留足电量； 5. 当 MCU2 查询到平台下发的 DFOTA 下载消息'FIRMWARE DOWNLOADING'，MCU2 需要遵 从表 2 中的处理方法，并进入 DFOTA 升级保护模式，不对模块断电、不发送数据传输相关的 AT 命令给模块。 6. 如果平台不进行 DFOTA 升级，终端完成自身业务后，查询模块状态，如果进入 IDLE 状态，就可 以按照终端后续流程处理。 上海移远通信技术股份有限公司 27 / 28 BC28-F&BC95-GF_中国电信物联网平台_DFOTA_应用指导 6 附录 A 参考文档及术语缩写 表 3：参考文档 编号 文档名称 [1] Quectel_BC28-F&BC95-GF_AT 命令手册 备注 适用于 BC28-F 和 BC95-GF 模块的 AT 命令手册 表 4：术语缩写 缩写 AEP DFOTA ID IDLE IoT MCU NB-IoT URI 英文全称 Application Enablement Platform Delta firmware Upgrade Over-the-Air Identifier Integrated Development and Learning Environment Internet of Things Microcontroller Unit Narrow Band Internet of Things Uniform Resource Identifier 中文全称 应用支持平台 固件空中差分升级 标识符 集成开发和学习环境 物联网 微型控制单元 窄带物联网（技术） 统一资源标识符 上海移远通信技术股份有限公司 28 / 28

BC28-F&BC95-GF 运营商自注册使用说明 NB-IoT 模块系列 版本：1.0 日期：2021-02-22 状态：受控文件 www.quectel.com BC28-F&BC95-GF 运营商自注册使用说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 19 BC28-F&BC95-GF 运营商自注册使用说明 文档历史 修订记录 版本 日期 作者 - 2021-01-11 Koala LI 1.0 2021-02-22 Koala LI 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 19 BC28-F&BC95-GF 运营商自注册使用说明 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 图片索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 运营商自注册机制 ................................................................................................................................. 6 2.1. 电信自注册 ................................................................................................................................. 6 2.1.1. 自注册启动 ...................................................................................................................... 6 2.1.2. 自注册成功 ...................................................................................................................... 7 2.1.3. 自注册失败 ...................................................................................................................... 7 2.1.4. 自注册影响 ...................................................................................................................... 7 2.2. 移动 CMDMP 自注册.................................................................................................................. 7 2.2.1. 自注册启动 ...................................................................................................................... 8 2.2.2. 自注册成功 ...................................................................................................................... 8 2.2.3. 自注册失败 ...................................................................................................................... 8 2.2.4. 自注册影响 ...................................................................................................................... 8 3 运营商自注册相关 AT 命令 ................................................................................................................... 9 3.1. AT 命令语句................................................................................................................................ 9 3.1.1. 定义 ................................................................................................................................. 9 3.1.2. AT 命令语句..................................................................................................................... 9 3.1.3. AT 示例声明................................................................................................................... 10 3.2. AT 命令描述.............................................................................................................................. 10 3.2.1. AT+QSREGENABLE 启用/禁用中国电信自注册........................................................ 10 3.2.2. AT+QDMPCFG CMDMP 接入配置..............................................................................11 3.2.3. AT+QDMPCFGEX CMDMP 接入扩展配置 ................................................................ 14 4 附录 A 术语缩写 ................................................................................................................................. 19 上海移远通信技术股份有限公司 3 / 19 BC28-F&BC95-GF 运营商自注册使用说明 图片索引 图 1：中国电信自注册流程........................................................................................................................... 6 图 2：中国移动 CMDMP 自注册流程 ........................................................................................................... 7 上海移远通信技术股份有限公司 4 / 19 BC28-F&BC95-GF 运营商自注册使用说明 1 引言 遵照运营商入库测试需求，移远通信 BC95-GF 和 BC28-F 模块集成了中国电信和中国移动的自注册功 能，从而实现了对终端设备更方便、更有效的管理。本文档主要介绍 BC95-GF 和 BC28-F 模块的自注册机 制以及与自注册相关的 AT 命令。 上海移远通信技术股份有限公司 5 / 19 BC28-F&BC95-GF 运营商自注册使用说明 2 运营商自注册机制 2.1. 电信自注册 设备开机入网 开机第一次自注 册失败后，最多 再重试 2 次 间隔 1 小时 否 重试后 是否自注册成功？ 是 版本号或机卡 匹配变更？ 否 是 启动自注册 否 自注册成功？ 是 流程结束 ？ 图 1：中国电信自注册流程 2.1.1. 自注册启动 模块开机入网并识别到中国电信 USIM 卡后，将自动检测模块固件版本号是否变更或者机卡匹配关系 是否发生变化；若符合自注册触发条件，模块会启动电信自注册，并自动向电信自注册平台发送特定格式 的数据包以完成设备信息的更新。 上海移远通信技术股份有限公司 6 / 19 BC28-F&BC95-GF 运营商自注册使用说明 2.1.2. 自注册成功 若自注册成功，且模块后续没有固件版本号变更或者机卡匹配关系变化，则模块重启或者断电后再开 机都不会再次触发电信自注册。 2.1.3. 自注册失败 ⚫ 若开机后第一次自注册失败，模块会自动重试 2 次，每次重试间隔时间为 1 小时。 ⚫ 若重试 2 次后仍然失败，则等下次开机才会再次触发自注册流程。 2.1.4. 自注册影响 ⚫ 若未设置禁用 PSM 模式，模块自注册失败后，自动进入 PSM 模式，不会进行自注册重试。 ⚫ 自注册过程中 CoAP 重传可能会影响模块进入 PSM 模式的时间。 ⚫ 自注册服务器地址采用域名模式；若域名解析失败，可能会影响模块进入 PSM 模式的时间。 2.2. 移动 CMDMP 自注册 设备开机入网 启动自注册 否 自注册成功 是 流程结束 24小时周期性更新 图 2：中国移动 CMDMP 自注册流程 上海移远通信技术股份有限公司 7 / 19 BC28-F&BC95-GF 运营商自注册使用说明 2.2.1. 自注册启动 模块开机入网并识别到中国移动 USIM 卡后，默认自动注册到移动 CMDMP 服务器。 2.2.2. 自注册成功 若自注册成功，模块将默认周期性地（每隔 24 小时）执行一次更新操作。 2.2.3. 自注册失败 ⚫ 若模块向 CMDMP 平台发送注册包，但未收到平台回复，将进行 4 次重传，即最多发送 5 次注册 数据包；重传间隔依次默认为 2 秒、4 秒、8 秒、16 秒、32 秒，总超时时间为 62 秒； ⚫ 若 4 次重传均未收到平台回复或者收到错误回复，则在下次开机入网时再重新触发自注册流程。 2.2.4. 自注册影响 ⚫ 自注册过程中 CoAP 协议重传可能会影响模块进入 PSM 模式的时间； ⚫ 周期性更新可能会将模块从 PSM 模式唤醒。 上海移远通信技术股份有限公司 8 / 19 BC28-F&BC95-GF 运营商自注册使用说明 3 运营商自注册相关 AT 命令 本章介绍如何使用 AT 命令控制运营商自注册功能。关于是否需要开启运营商自注册功能，请联系对应 的运营商进行确认。 3.1. AT 命令语句 3.1.1. 定义 ⚫ 回车符。 ⚫ 换行符。 ⚫ 参数名称。实际命令行中不包含尖括号。 ⚫ […] 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 ⚫ 下划线 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 19 BC28-F&BC95-GF 运营商自注册使用说明 3.1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.2. AT 命令描述 3.2.1. AT+QSREGENABLE 启用/禁用中国电信自注册 该命令用于启用/禁用中国电信的自注册功能。 AT+QSREGENABLE 启用/禁用中国电信自注册 查询命令 AT+QSREGENABLE? 响应 +QSREGENABLE: 设置命令 AT+QSREGENABLE= OK 响应 OK 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令重启后生效。 PSM 唤醒后有效；自动保存至 NVRAM。 参数 整型。启用或禁用中国电信自注册功能。 0 禁用中国电信自注册功能 1 启用中国电信自注册功能 举例 AT+QSREGENABLE? +QSREGENABLE: 0 OK AT+QSREGENABLE=1 OK //查询中国电信自注册状态。 //禁用中国电信自注册。 //启用中国电信自注册。 上海移远通信技术股份有限公司 10 / 19 BC28-F&BC95-GF 运营商自注册使用说明 3.2.2. AT+QDMPCFG CMDMP 接入配置 该命令用于配置和查询 CMDMP 接入信息。 查询命令用于查询模块当前配置的参数。 设置命令用于保存或擦除配置信息，相关配置重启后生效。 AT+QDMPCFG CMDMP 接入配置 测试命令 AT+QDMPCFG=? 响应 +QDMPCFG: [,[,[,[,]]]] 查询命令 AT+QDMPCFG? OK 响应 +QDMPCFG: 0, +QDMPCFG: 1,,, +QDMPCFG: 2,,,, OK 设置命令 AT+QDMPCFG=[,[,[,[,]]]] 响应 当为 0、1、2 或 5 且命令执行成功时： OK 当为 4、为 0 且命令执行成功时： +QDMPCFG: 0, OK 当为 4、为 1 且命令执行成功时： +QDMPCFG: 1,,, OK 当为 4、为 2 且命令执行成功时： +QDMPCFG: 2,,,, OK 上海移远通信技术股份有限公司 11 / 19 BC28-F&BC95-GF 运营商自注册使用说明 最大响应时间 特性说明 当为 6 且命令执行成功时： +QDMPCFG: 6, OK 若出现任何错误： ERROR 300 毫秒 该命令重启后生效。 PSM 唤醒后有效；自动保存至 NVRAM。 参数 整型。操作的参数类型。 0 配置 CMDMP 接入状态 1 配置 CMDMP 服务器地址、端口与更新周期 2 配置 CMDMP 应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 4 查询保存到 NVRAM 的配置信息 5 擦除保存到 NVRAM 的配置信息 6 查询 CMDMP 接入状态 不同的值对应不同的参数类型，具体如下： 0 - - - 1 - 2 3 预留值 4 5 6 整型。CMDMP 接入模式。 0 禁止接入 CMDMP 1 允许接入 CMDMP 字符串型。CMDMP 服务器 IP/域名地址，默认服务器 IP 为'117.161.2.41'，默认 域名为'm.fxltsbl.com'。 整型。CMDMP 服务器端口，默认服务器端口为 5683。范围：1~65535。 整型。更新周期。范围：300~4294966；默认值：86400；单位：秒。 字符串型。应用密钥。设置命令中，应用双引号标记。 字符串型。私钥。设置命令中，应用双引号标记。 整型。终端类型。 0 接口 1 Linux 上海移远通信技术股份有限公司 12 / 19 BC28-F&BC95-GF 运营商自注册使用说明 2 Android 字符串型。终端设备的 IMEI 号。长度应为 15~17 字节。 整型。保存的配置信息查询选项。 0 查询保存的 CMDMP 接入模式 1 查询保存的 CMDMP 服务器 IP 地址、端口和更新周期 2 查询保存的应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 整型。保存的配置信息擦除选项。 0 擦除保存的 CMDMP 接入模式 1 擦除保存的 CMDMP 服务器 IP 地址、端口和更新周期 2 擦除保存的应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 4 擦除以上保存的所有信息 整型。CMDMP 接入状态。 0 DMP_INITIAL_STATE（初始化） 4 DMP_CONNECT_SUCCESS（连接成功） 5 DMP_CONNECT_FAILED（连接失败） 6 DMP_REG_SUCCESS（注册成功） 7 DMP_REG_FAILED（注册失败） 8 DMP_REG_TIMEOUT（注册超时） 9 DMP_LIFETIME_TIMEOUT（设备生存周期超时） 11 DMP_UPDATE_SUCCESS（更新成功） 12 DMP_UPDATE_FAILED（更新失败） 13 DMP_UPDATE_TIMEOUT（更新超时） 举例 AT+QDMPCFG? //查询当前配置信息。 +QDMPCFG: 0,1 +QDMPCFG: 1,117.161.2.7,5683,420 +QDMPCFG: 2,M100000089,95GozTUi33nUK05ha526100QFbk0Y38M,0,863703030822519 OK AT+QDMPCFG=0,0 OK AT+QDMPCFG=4,0 +QDMPCFG: 0,0 //禁止接入 CMDMP。 //查询已保存的 CMDMP 接入模式。 OK AT+QDMPCFG=1,'117.161.2.7',5683,420 OK AT+QDMPCFG=4,1 +QDMPCFG: 1,117.161.2.7,5683,420 //设置 CMDMP 服务器 IP 地址、端口和更新周期。 '117.161.2.7'是 CMDMP 测试服务器 IP 地址。 //查询保存的 CMDMP 服务器 IP 地址、端口和更新周期。 上海移远通信技术股份有限公司 13 / 19 BC28-F&BC95-GF 运营商自注册使用说明 OK AT+QDMPCFG=2,'M100000089','95GozTUi33nUK05ha526100QFbk0Y38M',1,863703030822519 //设置应用密钥、私钥、终端类型和终端 IMEI 号。 OK AT+QDMPCFG=4,2 //查询保存的应用密钥、私钥、终端类型和终端 IMEI 号。 +QDMPCFG: 2,M100000089,95GozTUi33nUK05ha526100QFbk0Y38M,1,863703030822519 OK AT+QDMPCFG=5,4 OK AT+QDMPCFG=6 +QDMPCFG: 6,6 //擦除所有已保存的信息。 //查询 CMDMP 接入状态。 //DMP 注册成功。 OK AT+QDMPCFG=6 +QDMPCFG: 6,11 //DMP 更新成功。 OK 3.2.3. AT+QDMPCFGEX CMDMP 接入扩展配置 该命令用于配置和查询 CMDMP v2.0 所需的 CMDMP 接入扩展信息。 设置命令用于保存、读取或擦除配置信息，相关配置重启后生效。 AT+QDMPCFGEX CMDMP 接入扩展配置 测试命令 AT+QDMPCFGEX=? 响应 +QDMPCFGEX: ,[,[,[,,]]] OK 设置命令 AT+QDMPCFGEX=,[,[,[,,]]] 响应 当为 0 或 2 且命令执行成功时： OK 当为 0、为 1 且命令执行成功时： +QDMPCFGEX: 0, OK 当为 1、为 1 且命令执行成功时： +QDMPCFGEX: 1, 上海移远通信技术股份有限公司 14 / 19 BC28-F&BC95-GF 运营商自注册使用说明 最大响应时间 特性说明 OK 当为 2、为 1 且命令执行成功时： +QDMPCFGEX: 2,,,, OK 当为 3、为 1 且命令执行成功时： +QDMPCFGEX: 3,, OK 当为 4、为 1 且命令执行成功时： +QDMPCFGEX: 4,,,, OK 当为 5、为 1 且命令执行成功时： +QDMPCFGEX: 5, OK 若出现任何错误： ERROR 300 毫秒 该命令重启后生效。 PSM 唤醒后仍有效；自动保存至 NVRAM。 参数 整型。操作的参数类型。 0 终端应用程序信息 1 终端 MAC 地址 2 终端 ROM、RAM、CPU 和操作系统版本信息 3 终端软件版本和名称 4 终端 VoLTE 状态、网络类型、宽带帐号和电话号码 5 终端位置信息 不同的值对应不同的参数类型，具体如下： 0 上海移远通信技术股份有限公司 15 / 19 BC28-F&BC95-GF 运营商自注册使用说明 1 2 3 4 5 整型。操作模式。 0 配置信息至模块 1 查询模块中的信息 2 擦除模块中的信息 字符串型。终端应用程序信息，最大字符串长度为 255 字节。它是应用程序信息的集合， 每个信息块用分号分隔，内容包含应用程序名称、包名称、应用程序使用时间（单位： 毫秒）、应用程序打开次数，并且每部分内容以'|'分隔。如果没有相关信息，请将其 设置为'NULL'。 字符串型。终端的 MAC 地址，最大字符串长度为 19 字节。如果没有相关信息，请将其 设置为'NULL'。 字符串型。终端的 ROM 信息，最大字符串长度为 19 字节。如果没有相关信息，请将 其设置为'NULL'。 字符串型。终端的 RAM 信息，最大字符串长度为 19 字节。如果没有相关信息，请将其 设置为'NULL'。 字符串型。终端的 CPU 信息，最大字符串长度为 19 字节。如果没有相关信息，请将其 设置为'NULL'。 字符串型。终端操作系统版本，最大字符串长度为 47 字节。如果没有相关信息，请将 其设置为'NULL'。 字符串型。终端的软件版本，最大字符串长度为 47 字节。如果没有相关信息，请将其 设置为'NULL'。 字符串型。终端的软件名称，最大字符串长度为 47 字节。如果没有相关信息，请将其 设置为'NULL'。 字符串型。终端 VoLTE 状态，最大字符串长度为 7 字节。如果没有相关信息，请将其 设置为'NULL'。 字符串型。终端网络类型，最大字符串长度为 19 字节。如果没有相关信息，请将其设 置为'NULL'。 字符串型。终端宽带账号，最大字符串长度为 47 字节。如果没有相关信息，请将其设 置为'NULL'。 字符串型。终端的电话号码，最大字符串长度为 19 字节。如果没有相关信息，请将其 设置为'NULL'。 字符串型。终端的位置信息，最大字符串长度为 255 字节。如果没有相关信息，请将其 设置为'NULL'。 举例 AT+QDMPCFGEX=0,0,'Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551 ;Alipay|FW88|22650|5555;Zhihu|FW333|77750|65101' //设置 APP 信息。 OK AT+QDMPCFGEX=0,1 //查询 APP 信息。 上海移远通信技术股份有限公司 16 / 19 BC28-F&BC95-GF 运营商自注册使用说明 +QDMPCFGEX: 0,Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551;Alip ay|FW88|22650|5555;Zhihu|FW333|77750|65101 OK AT+QDMPCFGEX=0,2 OK AT+QDMPCFGEX=1,0,'00-01-6C-06-A6-29' OK AT+QDMPCFGEX=1,1 +QDMPCFGEX: 1,00-01-6C-06-A6-29 //擦除 APP 信息。 //设置 MAC 地址。 //查询 MAC 地址。 OK AT+QDMPCFGEX=1,2 //擦除 MAC 地址。 OK AT+QDMPCFGEX=2,0,'4096KB','4096KB','EC616S','FREE RTOS' //设置 ROM、RAM、CPU、OS 版本信息。 OK AT+QDMPCFGEX=2,1 //查询 ROM、RAM、CPU、OS 版本信息。 +QDMPCFGEX: 2,4096KB,4096KB,EC616S,FREE RTOS OK AT+QDMPCFGEX=2,2 OK AT+QDMPCFGEX=3,0,'BC95GFFAR01A03','Quectel' OK AT+QDMPCFGEX=3,1 +QDMPCFGEX: 3,BC95GFFAR01A03,Quectel //擦除 ROM、RAM、CPU、OS 版本信息。 //设置软件版本和名称。 //查询软件版本和名称。 OK AT+QDMPCFGEX=3,2 //擦除软件版本和名称。 OK AT+QDMPCFGEX=4,0,'off','NB-IoT','XY05553867549','18009699999' //设置 VoLTE 状态、网络类 型、宽带帐号和电话号码。 OK AT+QDMPCFGEX=4,1 //查询 VoLTE 状态、网络类型、宽带帐号和电话号码。 +QDMPCFGEX: 4,off,NB-IoT,XY05553867549,18009699999 OK AT+QDMPCFGEX=4,2 //擦除 VoLTE 状态、网络类型、宽带帐号和电话号码。 OK AT+QDMPCFGEX=5,0,'31.8438799075,117.2025477950,OTDOA' //设置位置信息。 OK AT+QDMPCFGEX=5,1 //查询位置信息。 +QDMPCFGEX: 5,31.8438799075,117.2025477950,OTDOA 上海移远通信技术股份有限公司 17 / 19 OK AT+QDMPCFGEX=5,2 OK BC28-F&BC95-GF 运营商自注册使用说明 //擦除位置信息。 上海移远通信技术股份有限公司 18 / 19 BC28-F&BC95-GF 运营商自注册使用说明 4 附录 A 术语缩写 表 2：术语缩写 术语 APP CoAP CMDMP CPU IMEI IP MAC ME NB-IoT NVRAM OS RAM ROM TA USIM VoLTE 英文全称 Applications Constrained Application Protocol China Mobile Device Management Platform Central Processing Unit International Mobile Equipment Identity Internet Protocol Media Access Control Mobile Equipment Narrow Band Internet of Things Non-Volatile Random Access Memory Operating System Random Access Memory Read Only Memory Terminal Adapter Universal Subscriber Identity Module Voice over Long-Term Evolution 中文全称 应用程序 受限应用协议 中国移动设备管理平台 中央处理单元 国际移动设备识别码 互联网协议 媒体接入控制 移动设备 窄带物联网 非易失性随机访问存储器 操作系统 随机访问存储器 只读存储器 终端适配器 全球用户识别模块 长期演进语音承载（一般称高清通话） 上海移远通信技术股份有限公司 19 / 19

BC28-F&BC95-GF 固件升级用户指导 NB-IoT 模块系列 版本：1.0 日期：2021-04-13 状态：受控文件 BC28-F&BC95-GF 固件升级用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 27 BC28-F&BC95-GF 固件升级用户指导 文档历史 修订记录 版本 1.0 日期 2020-12-16 2021-04-13 作者 Porter WU Porter WU 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 27 BC28-F&BC95-GF 固件升级用户指导 目录 文档历史 .................................................................................................................................................... 2 目录 ........................................................................................................................................................... 3 表格索引 .................................................................................................................................................... 4 图片索引 .................................................................................................................................................... 5 1 引言 .................................................................................................................................................... 6 2 前期准备............................................................................................................................................. 7 2.1. TE-B 开发板............................................................................................................................. 8 2.1.1. BC28-F-TE-B ................................................................................................................ 8 2.1.2. BC95-GF-TE-B ............................................................................................................. 9 2.2. QFlash 工具........................................................................................................................... 10 3 固件升级........................................................................................................................................... 12 3.1. 连接与设置 ............................................................................................................................ 13 3.1.1. 连接 TE-B ................................................................................................................... 13 3.1.2. 设置端口与波特率 ....................................................................................................... 14 3.1.2.1. 设置 COM 端口................................................................................................... 14 3.1.2.2. 设置波特率 ......................................................................................................... 15 3.2. 加载固件包文件 ..................................................................................................................... 16 3.3. 升级固件 ................................................................................................................................ 18 4 常见升级失败原因 ............................................................................................................................ 22 4.1. 串口选择错误 ......................................................................................................................... 22 4.2. 波特率选择过低 ..................................................................................................................... 23 4.3. 固件包文件无效 ..................................................................................................................... 24 4.4. 电源异常 ................................................................................................................................ 25 4.5. USB 数据线连接异常 ............................................................................................................. 26 5 附录 参考文档及术语缩写 ................................................................................................................ 27 上海移远通信技术股份有限公司 3 / 27 BC28-F&BC95-GF 固件升级用户指导 表格索引 表 1：BC28-F-TE-B 关键组件介绍 ............................................................................................................ 8 表 2：BC95-GF-TE-B 关键组件介绍 ......................................................................................................... 9 表 3：参考文档........................................................................................................................................ 27 表 4：术语缩写........................................................................................................................................ 27 上海移远通信技术股份有限公司 4 / 27 BC28-F&BC95-GF 固件升级用户指导 图片索引 图 1：BC28-F-TE-B .................................................................................................................................. 8 图 2：BC95-GF-TE-B................................................................................................................................ 9 图 3：QFlash 主界面 ............................................................................................................................... 10 图 4：QFlash 工具版本信息 .....................................................................................................................11 图 5：查看设备串口对应编号 .................................................................................................................. 13 图 6：选择主串口 .................................................................................................................................... 14 图 7：选择波特率 .................................................................................................................................... 15 图 8：点击'Load FW Files'按钮 .............................................................................................................. 16 图 9：选择待下载的文件.......................................................................................................................... 17 图 10：单击'Start'开始升级流程.............................................................................................................. 18 图 11：固件自动下载和升级过程中.......................................................................................................... 20 图 12：固件升级成功............................................................................................................................... 21 图 13：串口选择错误............................................................................................................................... 22 图 14：波特率选择错误 ........................................................................................................................... 23 图 15：加载的固件包文件无效 ................................................................................................................ 24 图 16：电源异常...................................................................................................................................... 25 上海移远通信技术股份有限公司 5 / 27 BC28-F&BC95-GF 固件升级用户指导 1 引言 本文档主要介绍如何通过 TE-B 开发板和 QFlash 工具升级移远通信 BC28-F 和 BC95-GF 模块的固件 版本。 上海移远通信技术股份有限公司 6 / 27 BC28-F&BC95-GF 固件升级用户指导 2 前期准备 升级 BC28-F 或 BC95-GF 模块中的固件包，需准备以下工具和驱动： ⚫ 开发板：BC28-F-TE-B 开发板或 BC95-GF-TE-B 开发板。 ⚫ 下载工具：移远通信 QFlash 工具（5.2 及其以上版本）。 ⚫ USB 转串口驱动：通常情况下，由电脑自动通过驱动识别工具安装。 备注 1. 如 若 电 脑 未 自 动 识 别 安 装 USB 转 串 口 驱 动 ， 需 自 行 下 载 安 装 驱 动 包 ， 下 载 地 址 为 ： https://www.ftdichip.cn/Drivers/VCP.htm。 2. 有关固件包和 QFlash 工具等相关资料，请联系移远通信技术支持 support@quectel.com 获取。 上海移远通信技术股份有限公司 7 / 27 BC28-F&BC95-GF 固件升级用户指导 2.1. TE-B 开发板 2.1.1. BC28-F-TE-B 本章节简要介绍了 BC28-F-TE-B 开发板。实物图及部分组件功能介绍如下： Micro USB 串口开关 图 1：BC28-F-TE-B 复位按键 表 1：BC28-F-TE-B 关键组件介绍 序号 1 2 3 组件名称 描述 复位按键（RESET） 用于重启模块。 串口开关 Micro USB 端口 用于切换模块主串口通信对象：主串口-USB（MAIN UART TO USB） 或主串口-MCU（MAIN UART TO MCU）。 通过 UART 转 USB 芯片，将 UART 口转成 4 路端口：0 路用于 AT 命 令，2 路用于抓取 Log，其它 2 路预留。 使用 BC28-F-TE-B 进行固件升级时需要将串口开关切换至 MAIN UART TO USB。关于 BC28-F-TE-B 的详细信息，请参考文档 [1]。 上海移远通信技术股份有限公司 8 / 27 BC28-F&BC95-GF 固件升级用户指导 2.1.2. BC95-GF-TE-B 本章节简要介绍了 BC95-GF-TE-B 开发板。实物图及部分组件功能介绍如下： 复位按键 Micro USB 串口开关 图 2：BC95-GF-TE-B 表 2：BC95-GF-TE-B 关键组件介绍 序号 1 2 3 组件名称 复位按键（RESET） 串口开关 Micro USB 端口 描述 用于重启模块。 用于切换模块主串口通信对象：主串口-USB（MAIN UART TO USB） 或主串口-MCU（MAIN UART TO MCU）。 通过 UART 转 USB 芯片，将 UART 口转成 4 路端口：0 路用于 AT 命令，2 路用于抓取 Log，其它 2 路预留。 使 用 BC95-GF-TE-B 进 行 固 件 升 级 时 需 要 将 串 口 开 关 切 换 至 MAIN UART TO USB 。 关 于 BC95-GF-TE-B 的详细信息，请参考文档 [2]。 上海移远通信技术股份有限公司 9 / 27 BC28-F&BC95-GF 固件升级用户指导 2.2. QFlash 工具 QFlash 是移远通信开发的模块固件包升级工具。该工具无需安装，可直接在装有 Windows 7/ 8/ 10 系统的 PC 上运行。 QFlash 工具的主界面如下图所示。 图 3：QFlash 主界面 上海移远通信技术股份有限公司 10 / 27 BC28-F&BC95-GF 固件升级用户指导 点击工具栏中'Help'下的'About This Tool'可查看 QFlash 工具版本相关信息，如下图所示。 图 4：QFlash 工具版本信息 备注 1. 在 Windows 10 中，请右键单击 QFlash 图标并选择'以管理员身份运行'，打开 QFlash_V5.2.exe。 2. QFlash 工具的存储路径不应包含空格、中文字符以及其他特殊字符，推荐使用全英文路径。 上海移远通信技术股份有限公司 11 / 27 BC28-F&BC95-GF 固件升级用户指导 3 固件升级 使用 QFlash 工具升级模块固件，具体步骤如下： 步骤 1：设置串行端口和波特率。 步骤 2：加载固件文件。 步骤 3：升级固件。 以下章节将通过示例详细介绍如何使用 QFlash 工具升级固件。 备注 本文档操作示例，均在 Windows10 系统下操作完成。 上海移远通信技术股份有限公司 12 / 27 BC28-F&BC95-GF 固件升级用户指导 3.1. 连接与设置 3.1.1. 连接 TE-B 通过 TE-B 上的 Micro USB 口将模块与 PC 连接。完成连接后，PC 会自动安装 USB 转串口驱动。 打开设备管理器，查看当前设备的主串口编号，以便在 QFlash 工具串口中选择对应的串口编号。主串 口用于固件升级，如下图所示。 主串口 图 5：查看设备串口对应编号 备注 默认情况下，第一个 COM 口为主串口。非默认情况下，可依次向 4 路 COM 口分别发送任意 AT 命令， 例如发送 AT，有 OK 响应的串口，即为主串口。 上海移远通信技术股份有限公司 13 / 27 BC28-F&BC95-GF 固件升级用户指导 3.1.2. 设置端口与波特率 3.1.2.1. 设置 COM 端口 打开 QFlash 工具，在'COM Port'下拉菜单中选择主串口对应的 COM 端口编号，如下图所示。 图 6：选择主串口 上海移远通信技术股份有限公司 14 / 27 BC28-F&BC95-GF 固件升级用户指导 3.1.2.2. 设置波特率 点击'Baudrate'下拉列表，选择波特率'921600'，如下图所示。 图 7：选择波特率 备注 1. 升级 BC28-F 和 BC95-GF 模块时，波特率请务必选择 921600，其他波特率可能会导致升级失败。 2. COM 端口和波特率设置的顺序不分前后。 上海移远通信技术股份有限公司 15 / 27 BC28-F&BC95-GF 固件升级用户指导 3.2. 加载固件包文件 本节以 BC95-GF 为例，介绍如何加载模块的固件包文件。 步骤 1： 点击'Load FW Files'按钮，如图所示。 图 8：点击'Load FW Files'按钮 上海移远通信技术股份有限公司 16 / 27 BC28-F&BC95-GF 固件升级用户指导 步骤 2： 选择需要下载到模块的 BootLoader_BC95GFxxxxxxxx.bin 的固件文件，如下图所示。 图 9：选择待下载的文件 备注 1. 固件文件的存储路径不应包含空格、中文字符以及其他特殊字符。此类字符可能导致无法识别固件文 件或固件文件加载无效。推荐使用全英文路径。 2. 注意选择加载的文件需以'BootLoader_xxx'开头。 上海移远通信技术股份有限公司 17 / 27 BC28-F&BC95-GF 固件升级用户指导 3.3. 升级固件 以上步骤完成后，可通过如下步骤使用 QFlash 工具完成固件升级。 步骤 1： 点击'Start'按钮，如下图所示。 图 10：单击'Start'开始升级流程 上海移远通信技术股份有限公司 18 / 27 BC28-F&BC95-GF 固件升级用户指导 步骤 2： 点击'Start'后等待提示框提示'Reset……'后，按下复位按键重启模块。此时，模块将进 入下载模式，自动下载并升级固件。 图 10：'Reset'提示 上海移远通信技术股份有限公司 19 / 27 BC28-F&BC95-GF 固件升级用户指导 图 11：固件自动下载和升级过程中 备注 若模块未进入下载模式，请重新尝试本章节的步骤 1 和步骤 2。 上海移远通信技术股份有限公司 20 / 27 BC28-F&BC95-GF 固件升级用户指导 步骤 3： 固件升级成功后，界面进度条下将显示'PASS'，如下图所示。 图 12：固件升级成功 备注 升级成功后，模块不会自动重启，需用户手动重启模块，模块方可正常运行。 上海移远通信技术股份有限公司 21 / 27 BC28-F&BC95-GF 固件升级用户指导 4 常见升级失败原因 若固件升级失败，一般来说，可能有波特率错误、串口错误、文件无效等原因。如下章节将介绍一些 常见的下载失败案例。 4.1. 串口选择错误 固件升级时，若串行端口选择错误，QFlash 界面将出现如下提示： 图 13：串口选择错误 备注 若串口选择正确，模块仍未成功进入下载模式，请检查串口是否被其他工具占用。 上海移远通信技术股份有限公司 22 / 27 BC28-F&BC95-GF 固件升级用户指导 4.2. 波特率选择过低 固件升级时，若 QFlash 界面出现如下提示，说明波特率选择错误。请参考第 3.1.2.2 章选择正确的波 特率。 图 14：波特率选择错误 上海移远通信技术股份有限公司 23 / 27 BC28-F&BC95-GF 固件升级用户指导 4.3. 固件包文件无效 在选择待升级的文件时，若 QFlash 界面出现如下提示，说明选择了错误或无效的固件包文件。请参考 第 3.2 章选择合适的固件包文件。 图 15：加载的固件包文件无效 上海移远通信技术股份有限公司 24 / 27 BC28-F&BC95-GF 固件升级用户指导 4.4. 电源异常 固件升级时，若 QFlash 界面出现如下提示，说明模块端发生异常断电。 图 16：电源异常 备注 若升级过程中发生异常断电，需按照第 3 章步骤进行重新进行升级。 上海移远通信技术股份有限公司 25 / 27 BC28-F&BC95-GF 固件升级用户指导 4.5. USB 数据线连接异常 固件升级时，若 QFlash 界面出现如下提示，说明出现 USB 数据线连接异常。请在升级过程中，确保 USB 数据线连接正常。 图 17：USB 数据线连接异常 上海移远通信技术股份有限公司 26 / 27 BC28-F&BC95-GF 固件升级用户指导 5 附录 参考文档及术语缩写 表 3：参考文档 序号 [1] [2] 文档名称 Quectel_BC28-F-TE-B_用户指导 Quectel_BC95-GF-TE-B_用户指导 备注 BC28-F-TE-B 开发板用户指导 BC95-GF-TE-B 开发板用户指导 表 4：术语缩写 术语 COM (Port) DL FW MCU PC UART USB 英文全称 Communication (Port) Download Firmware Microcontroller Unit Personal Computer Universal Asynchronous Receiver/Transmitter Universal Serial Bus 中文全称 通信（端口） 下载 固件 微型控制单元 个人电脑 通用异步收发传输器 通用串行总线 上海移远通信技术股份有限公司 27 / 27

BC28-F&BC95-GF PSM 唤醒说明 NB-IoT 模块系列 版本：1.0 日期：2021-02-25 状态：受控文件 www.quectel.com BC28-F&BC95-GF PSM 唤醒说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功能 错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的使 用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任何 因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权使 用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追究 法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 11 BC28-F&BC95-GF PSM 唤醒说明 文档历史 修订记录 版本 1.0 日期 2020-12-07 2021-02-25 作者 Allan LIANG Allan LIANG 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 11 BC28-F&BC95-GF PSM 唤醒说明 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 3GPP 协议规定的唤醒 .......................................................................................................................... 6 2.1. TAU 唤醒................................................................................................................................. 6 2.2. 主动上报网络交互数据唤醒 .................................................................................................... 6 3 中国电信物联网平台的策略唤醒 ........................................................................................................... 7 3.1. Lifetime 机制 ........................................................................................................................... 7 3.2. Lifetime 命令配置.................................................................................................................... 7 4 运营商自注册功能的唤醒 ...................................................................................................................... 9 4.1. 电信自注册功能 ...................................................................................................................... 9 4.2. 移动自注册功能 ...................................................................................................................... 9 4.3. 联通自注册功能 .................................................................................................................... 10 5 附录 A 参考文档及术语缩写................................................................................................................ 11 上海移远通信技术股份有限公司 3 / 11 BC28-F&BC95-GF PSM 唤醒说明 表格索引 表 1：参考文档 ...................................................................................................................................................11 表 2：术语缩写 ...................................................................................................................................................11 上海移远通信技术股份有限公司 4 / 11 BC28-F&BC95-GF PSM 唤醒说明 1 引言 本文档说明了移远通信 BC28-F 和 BC95-GF 模块进入 PSM 模式后，模块被唤醒的情况。一般来说， 模块进入 PSM 模式，被唤醒的场景主要包含 3GPP 协议规定唤醒、连接电信物联网平台时的策略唤醒、运 营商自注册唤醒等。本文将详细说明这三种唤醒场景。用户在设计 MCU 程序时，可以根据本文档的介绍， 选择符合项目需求的处理逻辑。 上海移远通信技术股份有限公司 5 / 11 BC28-F&BC95-GF PSM 唤醒说明 2 3GPP 协议规定的唤醒 PSM（Power Saving Mode）即省电模式，是 3GPP Release 12 开始引入的技术，其原理是允许设备 在 Idle 状态一段时间（T3324）后，如果没有应用数据交互，将关闭信号的收发和 AS（接入层）相关功能， 从而减少天线、射频、信令处理等的功耗消耗。设备在 PSM 期间，不接收任何网络寻呼，对于网络侧来说， 模块此时是不可达的，数据、短信都不能接收。 2.1. TAU 唤醒 3GPP 协议规定，当 TAU 周期请求定时器（T3412）超时，模块将被唤醒，退出 PSM 模式。在下次再 次进入 PSM 模式之前，模块需要完成如下行为： ⚫ 小区搜索/读取系统信息 ⚫ 建立 RRC 链路 ⚫ 发送 TAU 请求 ⚫ RRC 释放 ⚫ 等待 T3324 超时，再次进入 PSM 模式。 备注 1. 对于功耗敏感的应用，建议用户在 USIM 卡开卡时，配置一个较大的 T3412 值。 2. TAU 更新请求失败会触发模组的重试机制或异常处理流程，从而导致设备功耗的增加。MCU 可以 通过监控省电模式 URC 以避免此问题：当收到 PSM 唤醒 URC +NPSMR:0 后，若在一定时间（发 送 TAU 请求时间加上 T3324）内未收到进入 PSM 模式 URC +NPSMR:1，MCU 主动关闭模块。 2.2. 主动上报网络交互数据唤醒 3GPP 协议规定，模块进入 PSM 模式后，模块发送与网络交互的业务数据时，将会退出 PSM 模式。 这里的网络交互数据主要包括如下几类： ⚫ TCP/UDP 的 send 发送数据； ⚫ 模块 PING 对端服务器发送的数据； ⚫ 向物联网平台发送的数据； ⚫ 其他情况下，模块发送的与网络交互的业务数据。 上海移远通信技术股份有限公司 6 / 11 BC28-F&BC95-GF PSM 唤醒说明 3 中国电信物联网平台的策略唤醒 3.1. Lifetime 机制 本文档中所述中国电信物联网平台，包含'中国电信物联网开放平台-连接管理子系统'（本文简称 '电信 IoT 平台'1)）和'CTWing 中国电信物联网开放平台'（本文简称'电信 AEP 平台'）。具体 Lifetime 介绍如下： ⚫ 电信 IoT 平台 若在 25 小时内未与模块进行数据交互，平台将显示异常；49 小时内未与模块进行数据交互，平台 将显示离线；模块主动发送上行数据后将恢复正常，异常和离线并不受 Lifetime 数值影响。因此， 使用中国电信 IoT 平台的用户，并不需要关注 Lifetime 这个参数。 ⚫ 电信 AEP 平台 若在 Lifetime 超时前，模块没有更新 Lifetime，平台自动断开与模块的连接，模块将无法继续进行 与平台之间的数据交互。因此，对于电信 AEP 平台，Lifetime 是必须配置的。配置 Lifetime 时间 后，模块会在配置值的 0.9 倍时间到达时，自动更新 Lifetime。 3.2. Lifetime 命令配置 用户可以使用 AT+QCFG='LWM2M/Lifetime'[,] 配置或查询 Lifetime。 一般情况下，对于中国电信物联网平台的 Lifetime 配置建议如下： ⚫ 电信 IoT 平台：建议通过 AT+QCFG='LWM2M/Lifetime',0 禁用 Lifetime 功能。 ⚫ 电信 AEP 平台：建议配置一个较大的 Lifetime 值。 配置示例如下所示，命令详情请参考文档 [1]。 AT+QCFG='LWM2M/Lifetime' +QCFG: 'LWM2M/Lifetime',86400 //查询 Lifetime 时间。 OK AT+QCFG='LWM2M/Lifetime',864000 //配置 Lifetime 时间为 10 天。 上海移远通信技术股份有限公司 7 / 11 BC28-F&BC95-GF PSM 唤醒说明 OK 备注 1. Lifetime 最大支持配置 30 天（30 × 86400）。 2. 模块自动更新 Lifetime 时，如果更新失败（最大超时时间为 124 秒），会重新注册平台。如果注册 失败（最大超时时间为 124 秒），将不再继续业务，此过程将会耗时 248 秒。为了避免频繁的 Lifetime 更新或更新失败导致功耗增加，建议用户配置一个较大的 Lifetime 值，可以配置最大值 30 天。 3. 对于功耗敏感的应用，针对 Lifetime 更新失败导致功耗增加，可以通过 MCU 监控省电模式 URC 以 避免此问题：当收到 PSM 唤醒 URC +NPSMR:0 后，若在一定时间（发送 TAU 请求时间加上 T3324） 内未收到进入 PSM 模式 URC +NPSMR:1，MCU 主动关闭模块。 上海移远通信技术股份有限公司 8 / 11 BC28-F&BC95-GF PSM 唤醒说明 4 运营商自注册功能的唤醒 针对运营商的入库测试需求，BC28-F 和 BC95-GF 模块集成了国内主要运营商（中国电信、中国联通 和中国移动）的自注册功能。为了避免用户设备功耗和流量损失，目前模块出厂时默认禁用运营商自注册功 能。一般情况下，除非项目必须，不建议用户在量产的设备中开启自注册功能。 关于运营商自注册的详细设计逻辑和相关 AT 命令，请参考文档 [2]。本章节主要介绍用户设备中开启 中国移动、中国电信和中国联通的自注册功能对模块唤醒及功耗的影响。 4.1. 电信自注册功能 电信自注册功能只在模块开机的时候发起自注册，当自注册成功后，若后续没有固件版本变更或 USIM 卡更换，模块重启或断电后，再次开机不会触发电信的自注册。 备注 1. 对于开启电信自注册的用户，需要注意，在自注册过程中可能发生重传而导致功耗增加。 2. 模块自注册失败后，会进入 PSM，此时若模块从 PSM 中被唤醒，不会再次发起自注册。 4.2. 移动自注册功能 模块开启移动自注册，在开机入网并识别到中国移动 USIM 卡后，将自动注册移动 CMDMP 服务器。 注册成功后，模块会按照运营商要求，每隔 24 小时执行一次更新操作。 备注 1. 对于开启移动自注册的用户，需要注意，在自注册过程中可能发生重传而导致功耗增加。 2. 用户需特别注意，模块进入 PSM 后，每隔 24 小时会被唤醒，执行一次更新操作。 上海移远通信技术股份有限公司 9 / 11 BC28-F&BC95-GF PSM 唤醒说明 4.3. 联通自注册功能 联通入库目前不要求进行自注册，运营商也没有开放可以对接的自注册服务器，所以模块暂不支持联 通自注册功能。用户如有相关需求，可以联系联通运营商确定是否开放自注册服务。 上海移远通信技术股份有限公司 10 / 11 BC28-F&BC95-GF PSM 唤醒说明 5 附录 A 参考文档及术语缩写 表 1：参考文档 序号 文档名称 备注 [1] Quectel_BC28-F&BC95-GF_AT 命令手册 BC28-F 和 BC95-GF 模块的 AT 命令手册 [2] Quectel_BC28-F&BC95-GF_运营商自注册使用说明 BC28-F 和 BC95-GF 模块运营商自注册 使用说明 表 2：术语缩写 术语 3GPP AEP AS CMDMP IoT MCU NB-IoT PSM RRC SIM TAU TCP UDP USIM 英文全称 3rd Generation Partnership Project Application Enablement Platform Access Stratum China Mobile Device Management Platform Internet of Things Microcontroller Unit Narrow Band Internet of Things Power Saving Mode Radio Resource Control Subscriber Identity Module Tracking Area Update Transmission Control Protocol User Datagram Protocol Universal Subscriber Identity Module 中文全称 第三代合作伙伴计划 应用使能平台 接入层 中国移动设备管理平台 物联网 微控制单元 窄带物联网 省电模式 无线资源控制 用户身份识别卡 跟踪区更新 传输控制协议 用户数据报协议 通用用户身份识别卡 上海移远通信技术股份有限公司 11 / 11

BC28-F&BC95-GF OneNET 应用指导 NB-IoT 模块系列 版本：1.2 日期：2021-11-30 状态：受控版本 BC28-F&BC95-GF OneNET 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 61 BC28-F&BC95-GF OneNET 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 2 / 61 BC28-F&BC95-GF OneNET 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-12-18 2021-01-07 2021-03-02 1.2 2021-11-30 作者 Albert ZHANG Albert ZHANG Albert ZHANG Albert ZHANG 变更表述 文档创建 受控版本 1. 新增适用模块 BC28-F 信息。 2. 新增 AT 示例声明（第 3.1.1 章）。 1. 更新 OneNET 命令相关参数的范围。 2. 更新+MIPLEVENT URC 参数的范围。 3. 新增 OneNET 平台 DFOTA 实例（第 5.11 章）。 上海移远通信技术股份有限公司 3 / 61 BC28-F&BC95-GF OneNET 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 图片索引 ........................................................................................................................................................ 7 1 引言 ........................................................................................................................................................ 8 2 OneNET 数据交互机制 .......................................................................................................................... 9 3 OneNET 相关 AT 命令......................................................................................................................... 10 3.1. AT 命令语句............................................................................................................................... 10 3.1.1. 定义 ................................................................................................................................ 10 3.1.2. AT 命令语句 ................................................................................................................... 10 3.1.3. AT 示例声明.................................................................................................................... 11 3.2. OneNET 相关 AT 命令详解 ....................................................................................................... 11 3.2.1. AT+MIPLCONFIG OneNET 接入配置 ......................................................................... 11 3.2.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 ......................................................... 13 3.2.3. AT+MIPLDELETE 删除 OneNET 通信套件实例.......................................................... 14 3.2.4. AT+MIPLVER 查询 OneNET SDK 版本....................................................................... 14 3.2.5. AT+MIPLADDOBJ 添加 LwM2M 对象 ......................................................................... 15 3.2.6. AT+MIPLDELOBJ 删除 LwM2M 对象.......................................................................... 15 3.2.7. AT+MIPLOPEN 发送注册请求..................................................................................... 16 3.2.8. AT+MIPLCLOSE 发送注销请求................................................................................... 17 3.2.9. AT+MIPLDISCOVERRSP 响应资源发现请求 ............................................................. 17 3.2.10. AT+MIPLOBSERVERSP 响应订阅请求 ...................................................................... 19 3.2.11. AT+MIPLREADRSP 响应读请求 ................................................................................. 20 3.2.12. AT+MIPLWRITERSP 响应写请求................................................................................ 22 3.2.13. AT+MIPLEXECUTERSP 响应执行请求 ...................................................................... 23 3.2.14. AT+MIPLPARAMETERRSP 响应写属性请求.............................................................. 24 3.2.15. AT+MIPLNOTIFY 上报数据 ......................................................................................... 25 3.2.16. AT+MIPLUPDATE 发送更新请求................................................................................. 27 3.2.17. AT+MIPLRD 读取缓存数据.......................................................................................... 27 4 OneNET 相关 URC .............................................................................................................................. 29 4.1. +MIPLDISCOVER 通知 TE 响应资源发现请求的 URC.......................................................... 29 4.2. +MIPLOBSERVE 通知 TE 响应订阅请求的 URC................................................................... 30 4.3. +MIPLREAD 通知 TE 响应读请求的 URC.............................................................................. 30 4.4. +MIPLWRITE 通知 TE 响应写请求的 URC ............................................................................ 31 4.5. +MIPLEXECUTE 通知 TE 响应执行请求的 URC ................................................................... 32 4.6. +MIPLPARAMETER 通知 TE 响应写属性请求的 URC .......................................................... 32 4.7. +MIPLEVENT 向 TE 通知事件的 URC ................................................................................... 33 5 举例 ...................................................................................................................................................... 35 5.1. 接入配置 .................................................................................................................................... 35 上海移远通信技术股份有限公司 4 / 61 BC28-F&BC95-GF OneNET 应用指导 5.2. 注册和资源发现操作.................................................................................................................. 36 5.2.1. 注册和资源发现操作（平台端关闭自动订阅）............................................................... 36 5.2.2. 注册和资源发现操作（平台端开启自动订阅）............................................................... 37 5.2.3. 注册和资源发现操作（平台开启自动订阅，开启鉴权连接）......................................... 38 5.3. 读操作........................................................................................................................................ 40 5.3.1. 读资源............................................................................................................................. 40 5.3.2. 读实例............................................................................................................................. 40 5.3.3. 读对象............................................................................................................................. 41 5.4. 写操作........................................................................................................................................ 41 5.4.1. 写资源............................................................................................................................. 41 5.4.2. 写实例............................................................................................................................. 42 5.5. 执行操作 .................................................................................................................................... 42 5.6. 写属性操作 ................................................................................................................................ 42 5.7. 订阅操作 .................................................................................................................................... 43 5.8. 上报数据操作............................................................................................................................. 43 5.8.1. 上报资源数据.................................................................................................................. 43 5.8.2. 上报实例数据.................................................................................................................. 43 5.8.3. 上报对象数据.................................................................................................................. 44 5.8.4. 使用 CON 消息上报资源数据 ......................................................................................... 44 5.8.5. 使用 CON 消息上报资源数据并携带 RAI 标记 ............................................................... 45 5.8.6. 使用 CON 消息上报实例数据 ......................................................................................... 45 5.8.7. 使用 CON 消息上报实例数据并携带 RAI 标记 ............................................................... 46 5.9. 更新操作 .................................................................................................................................... 46 5.9.1. 无 RAI 标志的更新操作................................................................................................... 46 5.9.2. 有 RAI 标志的更新操作................................................................................................... 47 5.10. 下行数据缓存............................................................................................................................. 47 5.11. OneNET 平台 DFOTA 实例 ....................................................................................................... 49 5.11.1. 创建群组 ......................................................................................................................... 49 5.11.2. 群组关联设备.................................................................................................................. 50 5.11.3. 新增固件版本.................................................................................................................. 51 5.11.4. 上传差分升级包 .............................................................................................................. 53 5.11.5. 创建升级任务.................................................................................................................. 54 5.11.6. 设备升级 ......................................................................................................................... 55 5.11.7. 重新注册设备.................................................................................................................. 57 6 错误码 .................................................................................................................................................. 58 7 附录 A 参考文档与术语缩写................................................................................................................ 60 上海移远通信技术股份有限公司 5 / 61 BC28-F&BC95-GF OneNET 应用指导 表格索引 表 1：AT 命令类型...................................................................................................................................... 10 表 2：OneNET 相关 URC .......................................................................................................................... 29 表 3：一般错误（27.007） ........................................................................................................................ 58 表 4：一般错误（27.005） ........................................................................................................................ 58 表 5：参考文档 ........................................................................................................................................... 60 表 6：术语缩写 ........................................................................................................................................... 60 上海移远通信技术股份有限公司 6 / 61 BC28-F&BC95-GF OneNET 应用指导 图片索引 图 1：OneNET 数据交互示意图................................................................................................................... 9 图 2：创建 FOTA 群组 1............................................................................................................................. 49 图 3：创建 FOTA 群组 2............................................................................................................................. 49 图 4：选择关联设备.................................................................................................................................... 50 图 5：关联设备 ........................................................................................................................................... 50 图 6：选择 FOTA 升级................................................................................................................................ 51 图 7：添加固件版本.................................................................................................................................... 51 图 8：新增当前版本号 ................................................................................................................................ 52 图 9：新增目标版本号 ................................................................................................................................ 52 图 10：升级包管理页面 .............................................................................................................................. 53 图 11：上传差分升级包 .............................................................................................................................. 53 图 12：升级任务管理页面 .......................................................................................................................... 54 图 13：添加升级任务页面 .......................................................................................................................... 54 图 14：升级任务详情页面 .......................................................................................................................... 55 图 15：升级任务下载中 .............................................................................................................................. 55 图 16：任务升级成功.................................................................................................................................. 57 上海移远通信技术股份有限公司 7 / 61 BC28-F&BC95-GF OneNET 应用指导 1 引言 LwM2M 是一种安全、高效且可扩展的客户端-服务器协议，适用于多种网络环境下资源受限的设备管 理。LwM2M 采用基于 REST 的现代化架构设计，定义了一种可扩展的资源和数据模型，重用并基于 CoAP 高效安全的数据传输标准协议建立。基于 CoAP（RFC 7252）的设备服务的简述，LwM2M 定义了一个简 单的对象模型和一组设备管理的接口和操作。 本文档介绍如何将应用了移远通信 BC28-F 和 BC95-GF 模块的设备，通过 AT 命令、基于 LwM2M 协 议连接到中国移动物联网开放平台（OneNET - 中国移动物联网开放平台，以下简称'OneNET'）。 上海移远通信技术股份有限公司 8 / 61 BC28-F&BC95-GF OneNET 应用指导 2 OneNET 数据交互机制 本章讲述终端、模块、OneNET 平台和应用服务器之间的数据交互机制。 终端设备 模块 OneNET 平台 应用服务器 AT+CGATT? AT+MIPLCREATE AT+MIPLADDOBJ=... AT+MIPLOPEN=... URC: +MIPLEVENT: ... 10秒 URC: +MIPLDISCOVER: ... 超时 AT+MIPLDISCOVERRSP=... 10秒 URC: +MIPLPARAMETER: ... 超时 AT+MIPLPARAMETERRSP=... 10秒 URC: +MIPLOBSERVE: ... 超时 AT+MIPLOBSERVERSP=... 10秒 URC: +MIPLREAD: ... 超时 AT+MIPLREADRSP=... 10秒 URC: +MIPLWRITE: ... 超时 AT+MIPLWRITERSP=... 10秒 URC: +MIPLEXECUTE: ... 超时 AT+MIPLEXECUTERSP=... AT+MIPLNOTIFY=... URC: +MIPLEVENT: ... AT+MIPLUPDATE=... URC: +MIPLEVENT: ... AT+MIPLCLOSE= URC: +MIPLEVENT: ... AT+MIPLDELOBJ=... AT+MIPLDELETE= 发送注册请求 响应 发送资源发现请求 响应 发送写属性请求 响应 发送订阅请求 响应 发送读请求 响应 发送写请求 响应 发送执行请求 响应 数据上报 响应 发送更新请求 响应 发送注销请求 响应 发送资源发现请求 响应 发送写属性请求 响应 发送订阅请求 响应 发送读请求 响应 发送写请求 响应 发送执行请求 响应 数据上报 响应 注册 操作 资源 发现 操作 写属 性 操作 订阅 操作 读 操作 写 操作 执行 操作 上报 操作 更新 操作 注销 操作 图 1：OneNET 数据交互示意图 上海移远通信技术股份有限公司 9 / 61 BC28-F&BC95-GF OneNET 应用指导 3 OneNET 相关 AT 命令 本章节讲述与 OneNET 接入和操作相关的 AT 命令。相关值，请参考第 6 章。 3.1. AT 命令语句 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 61 BC28-F&BC95-GF OneNET 应用指导 3.1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.2. OneNET 相关 AT 命令详解 3.2.1. AT+MIPLCONFIG OneNET 接入配置 此命令用于配置引导模式和引导服务器地址、接入服务器.地址、自动响应订阅、鉴权功能和写操作输 出格式等。也可以设置 CoAP 协议中的 ACK_TIMEOUT 参数。CoAP 协议中的 MAX_TRANSMIT_WAIT 通过公式 ACK_TIMEOUT × ((2(4+1)) - 1) 计算。若未设置 ACK_TIMEOUT，则使用默认值。 AT+MIPLCONFIG OneNET 接入配置 测试命令 AT+MIPLCONFIG=? 响应 +MIPLCONFIG: (支持的列表),[,] 查询命令 AT+MIPLCONFIG? OK 响应 +MIPLCONFIG:,, +MIPLCONFIG:, +MIPLCONFIG:, +MIPLCONFIG:, +MIPLCONFIG:, +MIPLCONFIG:, +MIPLCONFIG:,, OK 若有任何错误： ERROR 或 +CME ERROR: 设置命令 响应 AT+MIPLCONFIG=,[,] OK 若有任何错误： ERROR 或 +CME ERROR: 上海移远通信技术股份有限公司 11 / 61 BC28-F&BC95-GF OneNET 应用指导 最大响应时间 特性说明 5秒 该命令立即生效。 深休眠唤醒后有效；参数配置不保存到 NVRAM。 参数 整型。模式选项。 0 关闭引导模式，并配置接入服务器 IP 地址和端口号 1 开启引导模式，并配置引导服务器 IP 地址和端口号。默认的引导服务器 IP 地 址为 183.230.40.39，端口号为 5683 2 设置 CoAP 协议的 ACK_TIMEOUT 参数，ACK_TIMEOUT 的默认值是 2 秒 3 设置是否启用自动响应订阅请求 4 设置是否使能鉴权接入并配置鉴权码 5 设置是否启用 DTLS 模式并配置 PSK 6 设置接收写数据的输出格式 7 设置下行数据缓存配置，以及是否启用下行数据缓存指示 参数、和的对应情况如下： 0 1 2 1 3 4 [] 5 [] 6 7 字符串类型。 当=0，此参数为接入服务器 IP 地址。 当=1，此参数为引导服务器 IP 地址。 整型。 当=0，此参数为接入服务器端口号。 当=1，此参数为引导服务器端口号。 整型。ACK_TIMEOUT 的值。范围：2~20。单位：秒。默认值：2。 整型。是否启用模块自动响应订阅请求。 0 禁用自动响应，由终端设备通过 AT+MIPLOBSERVERSP 响应订阅请求。 1 启用自动响应，终端设备不需要响应订阅请求。 整型。是否启用鉴权连接。 0 禁用鉴权连接 1 启用鉴权连接 字符串类型。鉴权码。最大长度：16 字节。 整型。DTLS 模式开关。（此参数暂不支持） 0 禁用 DTLS 模式 1 启用 DTLS 模式 上海移远通信技术股份有限公司 12 / 61 BC28-F&BC95-GF OneNET 应用指导 双引号标示的字符串类型。预共享密钥。最大长度：16 字节。（此参数暂不支持） 整型。接收写操作数据的输出模式。 0 十六进制字符串显示 1 字符串显示 整型。下行数据缓存配置。 0 不缓存下行数据 1 仅缓存下行写操作数据 2 仅缓存下行执行操作数据 3 同时缓存下行写操作和执行操作数据 整型。是否启用下行数据缓存指示。 0 禁用下行数据缓存指示 1 启用下行数据缓存指示，在数据缓存区为空时收到下行数据缓存时会通过 URC +MIPLEVENT: 指示 备注 1. 需要在通过 AT+MIPLCREATE 创建通信实例之前使用此命令。 2. 暂不支持加密方式注册 OneNET 平台，和参数不支持配置和使用。 3.2.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 此命令用于创建一个 OneNET 通信套件实例。 AT+MIPLCREATE 创建 OneNET 通信套件实例 执行命令 AT+MIPLCREATE 响应 +MIPLCREATE: OK 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: 5秒 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 上海移远通信技术股份有限公司 13 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.3. AT+MIPLDELETE 删除 OneNET 通信套件实例 此命令用于删除 OneNET 通信套件实例。 AT+MIPLDELETE 删除 OneNET 通信套件实例 测试命令 AT+MIPLDELETE=? 响应 +MIPLDELETE: (支持的列表) 设置命令 AT+MIPLDELETE= OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: 3秒 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 3.2.4. AT+MIPLVER 查询 OneNET SDK 版本 此命令用于查询 OneNET SDK 版本。 AT+MIPLVER 查询 OneNET SDK 版本 查询命令 AT+MIPLVER? 响应 +MIPLVER: OK 最大响应时间 5秒 特性说明 / 参数 当前 OneNET SDK 版本。 上海移远通信技术股份有限公司 14 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.5. AT+MIPLADDOBJ 添加 LwM2M 对象 此命令用于添加 LwM2M 对象。 AT+MIPLADDOBJ 添加 LwM2M 对象 测试命令 AT+MIPLADDOBJ=? 响应 +MIPLADDOBJ: ( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的范围),'',(支持的 范围),(支持的范围) 设置命令 AT+MIPLADDOBJ=,,,,,< actcount> OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 整型。对象 ID。如果对象 ID 不存在，模块将返回错误。范围：0~65535（0~0xFFFF）。 整型。实例个数。范围：0~65535（0~0xFFFF）。 字符串类型。实例位图。例如，若共有 4 个实例（=4），ID 分别为 0、 1、2、3，='1101' 表示 ID 0、1、3 将被注册，而 ID 2 不会被 注册。 整型。属性数量，表示可读和/或可写资源数量。范围：0~65535（0~0xFFFF）。 整型。执行数量，表示可执行资源数量。范围：0~65535（0~0xFFFF）。 3.2.6. AT+MIPLDELOBJ 删除 LwM2M 对象 此命令用于删除 LwM2M 对象。 AT+MIPLDELOBJ 删除 LwM2M 对象 测试命令 AT+MIPLDELOBJ=? 响应 +MIPLDELOBJ: (支持的列表),(支持的范围) 上海移远通信技术股份有限公司 15 / 61 BC28-F&BC95-GF OneNET 应用指导 设置命令 AT+MIPLDELOBJ=, 最大响应时间 特性说明 OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 5秒 该命令立即生效； 参数配置后不保存。 参数 整型。OneNET 通信套件实例 ID。 整型。对象 ID。如果 ID 不存在，模块将返回错误。范围：0~65535（0~0xFFFF）。 3.2.7. AT+MIPLOPEN 发送注册请求 此命令用于向 OneNET 平台发送注册请求。 AT+MIPLOPEN 发送注册请求 测试命令 AT+MIPLOPEN=? 响应 +MIPLOPEN: (支持的列表),(支持的范围),(支 持的范围) 设置命令 AT+MIPLOPEN=,[,] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 上海移远通信技术股份有限公司 16 / 61 参数 BC28-F&BC95-GF OneNET 应用指导 整型。OneNET 通信套件实例 ID。 整型。设备生命周期。范围：16~268435454；单位：秒。 整型。注册超时时间。从连接成功（输出 URC +MIPLEVENT: 0,4）开始计时。范围： 30~65535；默认值：30；单位：秒。 3.2.8. AT+MIPLCLOSE 发送注销请求 此命令用于向 OneNET 平台发送注销请求。注销请求不做重发，即平台响应与否不影响模块侧的注销 操作。 AT+MIPLCLOSE 测试命令 AT+MIPLCLOSE=? 发送注销请求 响应 +MIPLCLOSE: (支持的列表) 设置命令 AT+MIPLCLOSE= OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: 3秒 / 参数 整型。OneNET 通信套件实例 ID。 3.2.9. AT+MIPLDISCOVERRSP 响应资源发现请求 此命令用于响应来自 OneNET 平台或应用程序服务器的资源发现（Discover）请求。该命令允许在添 加 LwM2M 对象之后、AT+MIPLOPEN 命令之前执行，此时设置命令必须携带参数，且 无效。设置成功之后，在收到对应的资源发现请求时，由模块自动响应该请求。 AT+MIPLDISCOVERRSP 响应资源发现请求 测试命令 AT+MIPLDISCOVERRSP=? 响应 +MIPLDISCOVERRSP: (支持的列表),(支持的 上海移远通信技术股份有限公司 17 / 61 BC28-F&BC95-GF OneNET 应用指导 范 围 ),( 支 持 的 列 表 ),( 支 持 的 范 围),'',(支持的范围) 设置命令 AT+MIPLDISCOVERRSP=,,[,, [,]] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 整型。消息 ID。由资源发现请求 URC +MIPLDISCOVER: 中获取。范围：0~268435455 （0~0xFFFFFFF）。 整型。资源发现请求结果。结果码如下： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示响应正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 15 4.06 Not acceptable（未接受） 整型。的长度，仅在=1 时有效。 字符串类型。表示对象的属性，每个属性（资源 ID）由分号隔开，仅在=1 时 有 效 ， 例 如 '1101;1102;1103' 。 属 性 数 量 不 应 超 过 AT+MIPLADDOBJ 中 的 与的和。 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 上海移远通信技术股份有限公司 18 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.10. AT+MIPLOBSERVERSP 响应订阅请求 当自动响应订阅请求功能被禁用时，此命令用于响应来自 OneNET 平台或应用程序服务器的订阅 （Observe）请求。 AT+MIPLOBSERVERSP 响应订阅请求 测试命令 AT+MIPLOBSERVERSP=? 响应 +MIPLOBSERVERSP: (支持的列表),(支持的 范围),(支持的列表),(支持的范围) 设置命令 AT+MIPLOBSERVERSP=,,[,] OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 整型。消息 ID。由订阅请求 URC +MIPLOBSERVE: 中获取。范围：0~268435455 （0~0xFFFFFFF）。 整型。订阅请求结果。结果码如下： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示响应正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 15 4.06 Not acceptable（未接受） 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 上海移远通信技术股份有限公司 19 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.11. AT+MIPLREADRSP 响应读请求 此命令用于响应来自 OneNET 平台或应用程序服务器的读（Read）请求。 AT+MIPLREADRSP 响应读请求 测试命令 AT+MIPLREADRSP=? 响应 +MIPLREADRSP: ( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 列 表 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围),(支持的范围),,(支持的范围),(支持的 范围),(支持的范围) 设置命令 AT+MIPLREADRSP=,, [,,,,< value_type>,,,,[,]] OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 整 型 。 消 息 ID 。 由 读 请求 URC +MIPLREAD: 中 获 取 。 范 围 ： 0~268435455 （0~0xFFFFFFF）。 整型。读请求结果。结果码如下： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示响应正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 15 4.06 Not acceptable（未接受） 整型。对象 ID。仅在为 1 时有效。由读请求 URC +MIPLREAD: 中获取。 范围：0~65535（0~0xFFFF）。 整型。实例 ID。仅在为 1 时有效。由读请求 URC +MIPLREAD: 中获取。 范围：0~65535（0~0xFFFF）。 整型。资源 ID。仅在为 1 时有效。由读请求 URC +MIPLREAD: 中获取。 上海移远通信技术股份有限公司 20 / 61 BC28-F&BC95-GF OneNET 应用指导 范围：0~65535（0~0xFFFF）。 整型。数据的类型。仅在为 1 时有效。 1 String（字符串类型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 整型。数据的长度。仅在为 1 时有效。单位：字节。范围：1~1024。 当为 1 时，此参数值为字符串类型数据的长度。 当为 2 时，此参数值为十六进制字符串数据的长度。 当为 3 时，此参数值可能为 2、4 或 8。 当为 4 时，此参数值只能为 4。 当为 5 时，此参数值为 1。 数据的内容。仅在为 1 时有效。 当为 1 时，此参数值为双引号标示的字符串类型，若无双引号标示， 字符串数据会被转化为大写后发送。 当为 2 时，此参数值为十六进制字符串格式，无需双引号标示。 当为 3 时，此参数值为整数型格式。 当为 4 时，此参数值为浮点型格式。 当为 5 时，此参数值为布尔型格式。 整型。消息的序号，仅在为 1 时有效。若读请求响应包含多条消息，则需要 分多条 AT 命令分别执行，若被分成了 N 个部分，则参数需从 N - 1 到 0 依 次递减，AT 命令也按照从大到小的顺序执行。为 0 表示这是数据中最后一 条消息。范围：1~10。 整型。消息的指示，仅在为 1 时有效。范围：0~2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 当前版本仅支持为 0。 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 备注 1. 此命令用于模块响应读请求，响应数据的总长度不能大于 1024 字节。 2. 若为 2，则此十六进制数据的字符数计算方式为 2 × ；若为 4， 浮点型数据的长度建议为 4 个字节，且参数值为 4。 上海移远通信技术股份有限公司 21 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.12. AT+MIPLWRITERSP 响应写请求 此命令用于响应来自 OneNET 平台或应用程序服务器的写（Write）请求。 AT+MIPLWRITERSP 响应写请求 测试命令 AT+MIPLWRITERSP=? 响应 +MIPLWRITERSP: (支持的列表),(支持的范 围),(支持的列表),(支持的范围) 设置命令 AT+MIPLWRITERSP=,, [,] OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 消息 ID。由写请求 URC +MIPLWRITE: 中获取。范围：0~268435455（0~0xFFFFFFF）。 整型。写请求的结果。结果码如下： 结果码 CoAP 响应码 描述 2 2.04 Changed（改变），表示成功处理了请求 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 上海移远通信技术股份有限公司 22 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.13. AT+MIPLEXECUTERSP 响应执行请求 此命令用于响应来自 OneNET 平台或应用程序服务器的执行（Execute）请求。 AT+MIPLEXECUTERSP 响应执行请求 测试命令 AT+MIPLEXECUTERSP=? 响应 +MIPLEXECUTERSP: (支持的列表),(支持的 范围),(支持的列表),(支持的范围) 设置命令 AT+MIPLEXECUTERSP=,,[,] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 消 息 ID 。 由 执 行 请 求 URC +MIPLEXECUTE: 中 获 取 。 范 围 ： 0~268435455 （0~0xFFFFFFF）。 执行请求结果。结果码如下： 结果码 CoAP 响应码 描述 2 2.04 Changed（改变），表示成功处理了请求 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 上海移远通信技术股份有限公司 23 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.14. AT+MIPLPARAMETERRSP 响应写属性请求 此命令用于响应来自 OneNET 平台或应用程序服务器的写属性（Write-Attributes）请求。 AT+MIPLPARAMETERRSP 测试命令 AT+MIPLPARAMETERRSP=? 响应写属性请求 响应 +MIPLPARAMETERRSP: ( 支 持 的 列 表 ),( 支 持 的 范围),(支持的列表),(支持的范 围) 设置命令 AT+MIPLPARAMETERRSP=,,[,] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 整型。消息 ID。由写属性请求 URC +MIPLPARAMETER: 中获取。范围：0~268435455 （0~0xFFFFFFF）。 整型。写属性请求结果。结果码如下： 结果码 CoAP 响应码 描述 2 2.04 Changed（改变），表示成功处理了请求 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 上海移远通信技术股份有限公司 24 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.15. AT+MIPLNOTIFY 上报数据 此命令用于向 OneNET 平台或应用程序服务器上报数据。 AT+MIPLNOTIFY 上报数据 测试命令 AT+MIPLNOTIFY=? 响应 +MIPLNOTIFY: (支持的列表),(支持的范围),(支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范 围),,(支持的范围),(支持的范围),(支持 的范围),(支持的范围) 设置命令 AT+MIPLNOTIFY=,,,,,,,,,[, [,]] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 整型。消息 ID；由订阅请求 URC +MIPLOBSERVE: 中获取。范围：0~268435455 （0~0xFFFFFFF）。 整型。对象 ID，由订阅请求 URC +MIPLOBSERVE: 中获取。范围：0~65535 （0~0xFFFF）。 整型。实例 ID，由订阅请求 URC +MIPLOBSERVE: 中获取。范围：0~65535 （0~0xFFFF）。 整型。资源 ID，由订阅请求 URC +MIPLOBSERVE: 中获取。范围：0~65535 （0~0xFFFF）。 整型。数据的类型。 1 String（字符串类型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 整型。数据的长度。单位：字节。范围：1~1024。 上海移远通信技术股份有限公司 25 / 61 BC28-F&BC95-GF OneNET 应用指导 当为 1 时，此参数值为字符串类型数据的长度。 当为 2 时，此参数值为十六进制字符串数据的长度。 当为 3 时，此参数值可能为 2、4 或 8。 当为 4 时，此参数值只能为 4。 当为 5 时，此参数值为 1。 数据的内容。 当为 1 时，此参数值为双引号标示的字符串类型，若无双引号标示， 字符串数据会被转化为大写后发送。 当为 2 时，此参数值为十六进制字符串格式，无需双引号标示。 当为 3 时，此参数值为整数型格式。 当为 4 时，此参数值为浮点型格式。 当为 5 时，此参数值为布尔型格式。 整型。消息的序号。若读请求响应包含多条消息，则需要分多条 AT 命令分别执行， 若被分成了 N 个部分，则参数需从 N-1 到 0 依次递减，AT 命令也按照从大 到小的顺序执行。为 0 表示这是数据中最后一条消息。范围：0~10。 整型。消息的指示。范围：0~2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 当前版本仅支持为 0。 整型。确认 ID。省略时使用默认值。范围：0~65535。 0 数据以不可确认消息（NON）形式发送 1~65535 数据以可确认消息（CON）形式发送，并通过 URC +MIPLEVENT: 通 知发送结果 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI；当 为非 0 值时，不可设置为 0x200。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 备注 1. 此命令用于数据上报，数据总长度不可超过 1024 个字节。 2. 若为 2，则此十六进制数据的字符数计算方式为 2 × ；若为 4， 浮点型数据的长度建议为 4 个字节，且参数值为 4。 3. 对于多个消息组成的数据，正常发送数据时，若其中一条消息返回错误，此消息之前的消息仍将会被 发送出去。 上海移远通信技术股份有限公司 26 / 61 BC28-F&BC95-GF OneNET 应用指导 3.2.16. AT+MIPLUPDATE 发送更新请求 此命令用于发送更新请求以更新设备生命周期和对象列表。 AT+MIPLUPDATE 测试命令 AT+MIPLUPDATE=? 发送更新请求 响应 +MIPLUPDATE: ( 支 持 的 列 表 ),( 支 持 的 范 围),(支持的列表),(支持的范围) 设置命令 AT+MIPLUPDATE=,, [,] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 5秒 特性说明 该命令立即生效； 参数配置不保存。 参数 整型。OneNET 通信套件实例 ID。 整型。设备生命周期。范围：0 或 16~268435454；单位：秒。 0 表示生命周期是 86400 秒。 整型。是否更新对象列表。 0 不更新 1 更新 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x400 收到消息的回复之后立即释放连接 当非 0 值时，只支持=0x400 3.2.17. AT+MIPLRD 读取缓存数据 此命令用于读取缓存的下行数据。执行命令 AT+MIPLRD 每次返回一条最早缓存的下行数据消息（以 缓存的 URC +MIPLWRITE:或+MIPLEXECUTE:格式返回），返回值含义与相应的 URC 参数意义相同，请 参考第 4.4 章和第 4.5 错误!未找到引用源。章。下行数据缓存区掉电不保存，且在删除通信套件实例时会 清空缓存区。 上海移远通信技术股份有限公司 27 / 61 BC28-F&BC95-GF OneNET 应用指导 AT+MIPLRD 读取缓存数据 查询命令 AT+MIPLRD? 执行命令 AT+MIPLRD 最大响应时间 特性说明 响应 +MIPLRD: ,,, OK 响应 +MIPLWRITE: ,,,,,,,,, 或者 +MIPLEXECUTE: ,,,,, , OK 若有任何错误： ERROR 或者 +CME ERROR: 5秒 / 参数 整型。缓存的数据消息条数。最大支持缓存 8 条消息。当下行数据条数超过最大缓 存条数时，会按序丢弃最早缓存的数据，即只缓存最新数据。 整型。缓存的有效数据总字节数。最大支持缓存 2048 字节。当下行有效数据总字 节数超过最大缓存总字节数时，会按序丢弃最早缓存的数据，即只缓存最新数据。 有效数据是指和所传递的数据。 整型。已经接收到的下行数据消息总条数。 整型。已经丢弃的下行数据消息总条数。 备注 当缓存区中存在未读取的数据时，模块无法进入深休眠，此时需要将缓存区数据读空，模块才能进入深休 眠状态。 上海移远通信技术股份有限公司 28 / 61 BC28-F&BC95-GF OneNET 应用指导 4 OneNET 相关 URC 本章节介绍 OneNET 平台相关的 URC。 表 2：OneNET 相关 URC 序号 URC 描述 [1] +MIPLDISCOVER: ,, 当 OneNET 平台发送资源发现请求，模块接 收到请求后将上报此 URC。 +MIPLOBSERVE: ,,,,, 请求，模块接收到请求后将上报此 URC。 +MIPLREAD: ,,,, 当 OneNET 平台或应用程序服务器发送读请 [3] 求，模块接收到请求后将上报此 URC。 +MIPLWRITE: ,,,,,,,,, +MIPLEXECUTE: ,,,,[,,] 请求，模块接收到请求后将上报此 URC。 +MIPLPARAMETER: ,,,< 当 OneNET 平台或应用程序服务器发送写属 [6] insDd>,,, 性请求，模块接收到请求后将上报此 URC。 [7] +MIPLEVENT: ,[,][,][,,] 4.1. +MIPLDISCOVER 通知 TE 响应资源发现请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台的资源发现请求。此 URC 完全输出以后，终端应在 10 秒内通过 AT+MIPLDISCOVERRSP 响应请求。 +MIPLDISCOVER 通知 TE 响应资源发现请求的 URC URC 格式 +MIPLDISCOVER: ,, 通知终端响应来自 OneNET 平台的资源发现请求。 上海移远通信技术股份有限公司 29 / 61 参数 BC28-F&BC95-GF OneNET 应用指导 整型。OneNET 通信套件实例 ID。 整型。消息 ID。 整型。从 OneNET 接收到的资源发现请求的对象 ID。 4.2. +MIPLOBSERVE 通知 TE 响应订阅请求的 URC 此 URC 用于通知终端有来自 OneNET 平台或应用程序服务器的订阅请求。若已禁用自动响应订阅请 求功能，则终端应在此 URC 完全输出以后的 10 秒内通过 AT+MIPLOBSERVERSP 响应请求。 +MIPLOBSERVE 通知 TE 响应订阅请求的 URC URC 格式 +MIPLOBSERVE: ,,,,, 通知终端有来自 OneNET 或应用程序服务器的订阅请求。 参数 整型。OneNET 通信套件实例 ID。 整型。消息 ID。 整型。表示是否订阅的标记。 0 取消订阅 1 订阅 整型。从 OneNET 或应用服务器接收到的订阅请求对象 ID。 整型。从 OneNET 或应用服务器接收到的订阅请求实例 ID。 -1 表示订阅或者取消订阅该对象 ID 下所有实例的所有资源。 整型。从 OneNET 或应用服务器接收到的订阅请求资源 ID。 -1 表示订阅或者取消订阅该实例下的所有资源。 4.3. +MIPLREAD 通知 TE 响应读请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台或应用程序服务器的读请求。此 URC 完全输出以后，终 端应在 10 秒内通过 AT+MIPLREADRSP 响应请求。 +MIPLREAD 通知 TE 响应读请求的 URC URC 格式： +MIPLREAD: ,,, , 通知终端响应来自 OneNET 平台或应用程序服务器的读请求。 上海移远通信技术股份有限公司 30 / 61 参数 BC28-F&BC95-GF OneNET 应用指导 整型。OneNET 通信套件实例 ID。 整型。消息 ID。 整型。从 OneNET 平台或应用程序服务器接收到的对象 ID。 整型。从 OneNET 平台或应用程序服务器接收到的实例 ID。 -1 表示读取该对象下的所有资源。 整型。从 OneNET 平台或应用程序服务器接收到的资源 ID。 -1 表示读取该实例下的所有资源。 4.4. +MIPLWRITE 通知 TE 响应写请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台或应用程序服务器的写请求。此 URC 完全输出以后，终 端应在 10 秒内通过 AT+MIPLWRITERSP 响应请求。 +MIPLWRITE 通知 TE 响应写请求的 URC URC 格式： +MIPLWRITE: ,,,,,,,,, 通知终端响应来自 OneNET 平台或应用程序服务器的写请 求。 参数 整型。OneNET 通信套件实例 ID。 整型。消息 ID。 整型。从 OneNET 平台或者应用服务器接收到的写请求的对象 ID。 整型。从 OneNET 平台或者应用服务器接收到的写请求的实例 ID。 整型。从 OneNET 平台或者应用服务器接收到的写请求的资源 ID。 整型。数据的类型（当前仅显示不透明型）。 1 String（字符串类型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 整型。数据的长度。单位：字节。 字符串或十六进制格式。从 OneNET 平台或应用程序服务器接收到的数据的内容。 整型。消息的标识。范围：0~2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 当前版本仅支持=0。 上海移远通信技术股份有限公司 31 / 61 BC28-F&BC95-GF OneNET 应用指导 整型。写请求消息的序号。若数据包含多条消息，则分成多个部分；若被分成了 N 个部分，则此 URC 会按从 N-1 到 0 依次递减的顺序排序。=0 表示 这是写请求数据中最后一条消息。 备注 应用服务器发送的写请求中数据长度建议小于 1000 字节，否则可能会导致操作失败。 4.5. +MIPLEXECUTE 通知 TE 响应执行请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台或应用程序服务器的执行请求。此 URC 完全输出以后， 终端应在 10 秒内通过 AT+MIPLEXECUTERSP 响应请求。 +MIPLEXECUTE 通知 TE 响应执行请求的 URC URC 格式： +MIPLEXECUTE: ,,, ,[,,] 通知终端回复来自 OneNET 平台或应用程序服务器的执行 请求。 参数 整型。OneNET 通信套件实例 ID。 整型。消息 ID。 整型。从 OneNET 平台或者应用服务器接收到的执行请求的对象 ID。 整型。从 OneNET 平台或者应用服务器接收到的执行请求的实例 ID。 整型。从 OneNET 平台或者应用服务器接收到的执行请求的资源 ID。 整型。的长度。单位：字节。 字符串类型。执行操作中的 Arguments 参数。 备注 来自应用程序服务器的执行操作的长度建议小于 1000 字节，否则可能会导致操作失败。 4.6. +MIPLPARAMETER 通知 TE 响应写属性请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台或应用程序服务器的写属性请求。此 URC 完全输出以后， 终端应在 10 秒内通过 AT+MIPLPARAMETERRSP 响应请求。 上海移远通信技术股份有限公司 32 / 61 BC28-F&BC95-GF OneNET 应用指导 +MIPLPARAMETER 通知 TE 响应写属性请求的 URC URC 格式： +MIPLPARAMETER: ,,,,,, 通知终端响应来自 OneNET 平台或应用程序服务器的写属 性请求。 参数 整型。OneNET 通信套件实例 ID。 整型。消息 ID。 整型。从 OneNET 平台或者应用服务器接收到的写属性请求的对象 ID。 整型。从 OneNET 平台或者应用服务器接收到的写属性请求的实例 ID。 -1 表示适用于该对象下所有资源 整型。从 OneNET 平台或者应用服务器接收到的写属性请求的资源 ID。 -1 表示适用于该实例下所有资源。 整型。的长度。单位：字节。 字符串类型。写属性操作的参数。 4.7. +MIPLEVENT 向 TE 通知事件的 URC 此 URC 用于向终端通知事件。 +MIPLEVENT 向 TE 通知事件的 URC URC 格式： 向终端通知事件。 +MIPLEVENT: ,[,][,][,,] 参数 整型。OneNET 通信套件实例 ID。 整型。事件代码。 1 引导开始 2 引导成功 3 引导失败 4 连接成功 5 连接失败 6 注册成功 7 注册失败 8 注册超时 9 生命周期超时 上海移远通信技术股份有限公司 33 / 61 BC28-F&BC95-GF OneNET 应用指导 10 停止状态 11 更新成功 12 更新失败 13 更新操作超时 14 需要更新 15 注销成功 20 响应失败 21 响应成功 25 上报失败 26 上报成功 40 固件下载开始 41 固件下载失败 42 固件下载完成 43 固件升级开始 44 固件升级成功 45 固件升级失败 46 固件升级完成 47 固件下载中断 48 固件擦除成功 49 固件擦除失败 50 终端软件包（非模块固件）下载触发 51 终端软件包（非模块固件）下载 52 终端软件包（非模块固件）下载完成 53 终端软件包（非模块固件）擦除 54 终端软件包（非模块固件）升级成功 100 缓存模式下收到下行数据 整型。扩展参数。 当=20，显示响应命令的消息 ID。 当=14，显示剩余生命周期时间，单位：秒。 整型。确认 ID。范围：1~65535。通过 AT+MIPLNOTIFY 设置的 CON 信 息的。 字符串类型。表示回复时间字符串。格式是'YYYYMMDDhhmmss'，Y 是年， M 是月，D 是日，h 是小时，m 是分钟，s 是秒。 整型。表示 OneNET 平台上是否有缓存命令。 0 没有 1 有 上海移远通信技术股份有限公司 34 / 61 BC28-F&BC95-GF OneNET 应用指导 5 举例 本章节展示 OneNET 相关的 AT 命令的使用流程，所有实例都是在已经入网条件下进行的。 5.1. 接入配置 本用例展示了如何配置引导模式、引导服务器地址，以及如何配置接入服务器和 CoAP 协议的参数 ACK_TIMEOUT。 AT+MIPLCONFIG=? +MIPLCONFIG: (0,7),[,] OK AT+MIPLCONFIG=1,'183.230.40.39',5683 OK AT+MIPLCONFIG? +MIPLCONFIG:1,183.230.40.39,5683 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,0 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 //启用引导并设置引导服务器 IP 和端口号 OK AT+MIPLCONFIG=0,'183.230.40.40',5683 OK AT+MIPLCONFIG? +MIPLCONFIG:0,183.230.40.40,5683 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,0 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 //关闭引导并设置接入服务器 IP 和端口号 OK 上海移远通信技术股份有限公司 35 / 61 AT+MIPLCONFIG=2,1,9 OK AT+MIPLCONFIG? +MIPLCONFIG:0,183.230.40.40,5683 +MIPLCONFIG:2,9 +MIPLCONFIG:3,1 +MIPLCONFIG:4,0 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 OK BC28-F&BC95-GF OneNET 应用指导 //设置 ACK_TIMEOUT 值为 9 秒 5.2. 注册和资源发现操作 5.2.1. 注册和资源发现操作（平台端关闭自动订阅） 在平台端设置关闭自动订阅的情况下，如下举例详述了注册和资源发现的操作。 //关闭引导模式，使用单个命令创建通信套件实例 AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例 OK AT+MIPLADDOBJ=0,3311,2,'11',4,2 OK AT+MIPLOPEN=0,600,60 OK //添加 LwM2M 对象 //成功添加对象，并将注册 ID 为 0 和 1 的实例 //向 OneNET 平台发送注册请求 +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLDISCOVER: 0,26384,3311 //接收到资源发现请求 //响应资源发现请求，资源 ID 分别为：5850、5851、5706 和 5805 AT+MIPLDISCOVERRSP=0,26384,1,19,'5850;5851;5706;5805' OK 上海移远通信技术股份有限公司 36 / 61 +MIPLEVENT: 0,11 //删除 LwM2M 对象 AT+MIPLDELOBJ=0,3311 OK AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 AT+MIPLDELETE=0 OK //更新成功 BC28-F&BC95-GF OneNET 应用指导 //向 OneNET 平台发送注销请求 //注销成功 //删除通信套件实例 //成功删除 5.2.2. 注册和资源发现操作（平台端开启自动订阅） 在平台端设置开启自动订阅的情况下，下面的举例中详述了注册以及资源发现操作。 //默认设置，执行 AT 命令创建通信套件实例 AT+MIPLCONFIG? +MIPLCONFIG:1,183.230.40.39,5683 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 //开启自动响应订阅请求 +MIPLCONFIG:4,0 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 OK AT+MIPLCREATE +MIPLCREATE:0 //成功创建通信套件实例 OK AT+MIPLADDOBJ=0,3311,2,'11',4,2 OK AT+MIPLOPEN=0,600,60 OK //添加 LwM2M 对象 //成功添加对象，并将注册 ID 为 0 和 1 的实例 //向 OneNET 平台发送注册请求 +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 上海移远通信技术股份有限公司 37 / 61 BC28-F&BC95-GF OneNET 应用指导 +MIPLOBSERVE: 0,78025,1,3311,0,-1 //接收到订阅（3311/0）请求 +MIPLOBSERVE: 0,143562,1,3311,1,-1 //接收到订阅（3311/1）请求 +MIPLDISCOVER: 0,12491,3311 //接收到资源发现请求 //响应资源发现请求，资源 ID 分别为：5850、5851、5706 和 5805 AT+MIPLDISCOVERRSP=0,12491,1,19,'5850;5851;5706;5805' OK +MIPLEVENT: 0,11 //更新成功 AT+MIPLDELOBJ=0,3311 OK //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK //删除 LwM2M 对象 +MIPLEVENT: 0,15 AT+MIPLDELETE=0 OK //注销成功 //删除通信套件实例 //成功删除 5.2.3. 注册和资源发现操作（平台开启自动订阅，开启鉴权连接） 本用例阐述了在平台开启自动订阅，开启鉴权连接的情况下，如何使用 OneNET 平台的注册和资源发 现操作。 AT+MIPLCONFIG=4,1,'Quectel123' OK AT+MIPLCONFIG? +MIPLCONFIG:1,183.230.40.39,5684 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,Quectel123 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 //开启鉴权连接并设置鉴权码 //查询配置 OK AT+MIPLCREATE +MIPLCREATE:0 //成功创建通信套件 OK AT+MIPLADDOBJ=0,3303,2,'11',4,2 OK //添加 LwM2M 对象 //成功添加对象，并将注册 ID 为 0 和 1 的实例 上海移远通信技术股份有限公司 38 / 61 BC28-F&BC95-GF OneNET 应用指导 AT+MIPLOPEN=0,86400,60 OK //向 OneNET 平台发送注册信息 +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLOBSERVE: 0,82187,1,3303,0,-1 //接收到订阅（3303/0）请求 +MIPLOBSERVE: 0,147724,1,3303,1,-1 //接收到订阅（3303/1）请求 +MIPLDISCOVER: 0,16653,3303 //接收到资源发现请求 //响应资源发现请求，资源 ID 分别为：5700、5701、5601、5602、5605 AT+MIPLDISCOVERRSP=0,16653,1,24,'5700;5701;5601;5602;5605' OK +MIPLEVENT: 0,11 AT+MIPLCLOSE=0 OK //更新成功 //向 OneNET 平台发送注销请求 +MIPLEVENT: 0,15 AT+MIPLOPEN=0,86400,60 OK //成功注销 //向 OneNET 平台发送注册请求 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //成功注册 +MIPLOBSERVE: 0,213270,1,3303,0,-1 +MIPLOBSERVE: 0,278807,1,3303,1,-1 +MIPLDISCOVER: 0,16667,3303 //响应资源发现请求，资源 ID 分别为：5700、5701、5601、5602、5605 AT+MIPLDISCOVERRSP=0,16667,1,24,'5700;5701;5601;5602;5605' OK +MIPLEVENT: 0,11 //更新成功 AT+MIPLDELOBJ=0,3303 //删除 LwM2M 对象 上海移远通信技术股份有限公司 39 / 61 OK AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 AT+MIPLDELETE=0 OK BC28-F&BC95-GF OneNET 应用指导 //向 OneNET 平台发送注销请求 //成功注销 //删除通信套件实例 5.3. 读操作 5.3.1. 读资源 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送读资源（3311/0/5805）请求。 +MIPLREAD: 0,3123,3311,0,5805 //接收到读资源请求 AT+MIPLREADRSP=0,3123,1,3311,0,5805,4,4,1.88,0,0 //响应读请求 OK //成功发送数据 1.88 到应用程序服务器 5.3.2. 读实例 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送读实例（3311/0）请求. +MIPLREAD: 0,25466,3311,0,-1 //接收到读实例请求 //用 4 条消息响应读请求 AT+MIPLREADRSP=0,25466,1,3311,0,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5805,4,4,1.88,0,0 OK 上海移远通信技术股份有限公司 40 / 61 BC28-F&BC95-GF OneNET 应用指导 5.3.3. 读对象 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送读对象（3311）请求。 +MIPLREAD: 0,39299,3311,-1,-1 //接收到读对象请求 //用 6 条消息响应读请求 AT+MIPLREADRSP=0,39299,1,3311,0,5851,5,1,1,5,0 OK AT+MIPLREADRSP=0,39299,1,3311,0,5852,3,2,123,4,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5805,4,4,1.88,0,0 OK 5.4. 写操作 5.4.1. 写资源 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 模块没有配置下行数据缓存模式。 3. 应用程序服务器或 OneNET 平台发送写资源（3311/0/5706）请求。 +MIPLWRITE: 0,38017,3311,0,5706,2,5,68656C6C6F,0,0 //接收写资源请求 AT+MIPLWRITERSP=0,38017,2 OK //用结果码（2）响应写请求 上海移远通信技术股份有限公司 41 / 61 BC28-F&BC95-GF OneNET 应用指导 5.4.2. 写实例 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 模块没有配置下行数据缓存模式。 3. 应用程序服务器或 OneNET 平台发送写实例（3311/0）请求。 //接收写实例请求 +MIPLWRITE: 0,46584,3311,0,5706,2,5,68656C6C6F,0,2 +MIPLWRITE: 0,46584,3311,0,5850,2,1,01,0,1 +MIPLWRITE: 0,46584,3311,0,5851,2,8,00000002DFDC1C3E,0,0 AT+MIPLWRITERSP=0,46584,2 OK //用结果码（2）响应写请求 5.5. 执行操作 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 模块没有配置下行数据缓存模式。 3. 应用程序服务器或 OneNET 平台发送执行请求，参数为 'reset'。 +MIPLEXECUTE: 0,36476,3303,0,5605,5,'reset' //接收到执行请求 AT+MIPLEXECUTERSP=0,36476,2 OK //用结果码(2)响应执行请求 5.6. 写属性操作 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送写属性请求。 //接收到写属性请求 +MIPLPARAMETER: 0,56642,3303,0,5700,38,'pmin=2;pmax=190;gt=100.0;lt=1.0;st=0.2' 上海移远通信技术股份有限公司 42 / 61 AT+MIPLPARAMETERRSP=0,56642,2 OK BC28-F&BC95-GF OneNET 应用指导 //用结果码（2）响应写属性请求 5.7. 订阅操作 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送订阅请求。 3. 关闭模块自动回复订阅请求功能。 +MIPLOBSERVE: 0,29620,1,3311,0,-1 //接收到订阅请求 AT+MIPLOBSERVERSP=0,29620,1 OK //响应订阅请求 5.8. 上报数据操作 5.8.1. 上报资源数据 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅资源（3303/0/5700）。 AT+MIPLNOTIFY=0,122179,3303,0,5700,4,4,25.6,0,0 OK //上报数据 5.8.2. 上报实例数据 前提条件： 1. 模块成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅实例（3303/0）。 //上报实例数据 AT+MIPLNOTIFY=0,653687,3303,0,5700,4,4,10.24,3,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5701,1,3,'Cel',2,0 上海移远通信技术股份有限公司 43 / 61 OK AT+MIPLNOTIFY=0,653687,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5602,4,4,100.86,0,0 OK BC28-F&BC95-GF OneNET 应用指导 5.8.3. 上报对象数据 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅对象（3303）。 //上报实例（0）数据 AT+MIPLNOTIFY=0,196301,3303,0,5700,4,4,9.8,3,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5602,4,4,99.8,0,0 OK //上报实例（1）数据 AT+MIPLNOTIFY=0,196301,3303,1,5700,4,4,0.2,3,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5601,4,4,3.2,1,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5602,4,4,100.1,0,0 OK 5.8.4. 使用 CON 消息上报资源数据 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅资源（3303/0/5701）。 AT+MIPLNOTIFY=0,307353,3303,0,5701,1,3,'Cel',0,0,255 //上报资源数据 OK +MIPLEVENT: 0,26,255 //返回上报数据结果 上海移远通信技术股份有限公司 44 / 61 BC28-F&BC95-GF OneNET 应用指导 5.8.5. 使用 CON 消息上报资源数据并携带 RAI 标记 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅资源（3303/0/5701）。 3. 执行命令 AT+CSCON=1 开启 URC +CSCON: 上报功能，可以指示 RAI 是否生效。 //使用 CON 消息上报资源数据并携带 RAI 标志（0x400） AT+MIPLNOTIFY=0,307353,3303,0,5701,1,3,'Cel',0,0,256,0x400 OK +CSCON:1 //建立 RRC 连接，开始发送数据 +MIPLEVENT: 0,26,256 //返回上报结果 +CSCON:0 //在收到 ACK 后，RRC 连接会被立即释放 备注 1. URC +MIPLEVENT: 和 URC +CSCON: 输出顺序不唯一。 2. AT+CSCON 命令的详细信息，请参考文档 [3]。 5.8.6. 使用 CON 消息上报实例数据 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅实例（3303/0）。 //使用 CON 消息上报实例数据 AT+MIPLNOTIFY=0,487674,3303,0,5700,4,4,170.1,3,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5701,1,3,'Cel',2,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5601,4,4,106.1,1,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5602,4,4,660.9,0,0,258 OK +MIPLEVENT: 0,26,258 //返回结果 上海移远通信技术股份有限公司 45 / 61 BC28-F&BC95-GF OneNET 应用指导 5.8.7. 使用 CON 消息上报实例数据并携带 RAI 标记 前提条件： 1. UE 成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅实例（3303/0）。 3. 执行 AT+CSCON=1 开启 +CSCON: URC 报告功能，可以指示 RAI 标记是否生效。 //使用 CON 消息上报实例数据并携带 RAI 标志（0x400） [15:37:14:339]AT+MIPLNOTIFY=0,450380,3303,0,5700,4,4,170.1,3,0,257,0x400 [15:37:14:403]OK [15:37:14:643]AT+MIPLNOTIFY=0,450380,3303,0,5701,1,3,'Cel',2,0,257,0x400 [15:37:14:692]OK [15:37:14:931]AT+MIPLNOTIFY=0,450380,3303,0,5601,4,4,106.1,1,0,257,0x400 [15:37:14:995]OK [15:37:15:235]AT+MIPLNOTIFY=0,450380,3303,0,5602,4,4,660.9,0,0,257,0x400 [15:37:15:299]OK [15:37:16:281] [15:37:16:281]+CSCON:1 //建立 RRC 连接，开始发送数据 [15:37:16:828] [15:37:16:828]+MIPLEVENT: 0,26,257 //返回结果 [15:37:17:477] [15:37:17:477]+CSCON:0 //接收 ACK 之后，RRC 连接会被立即释放 备注 1. URC +MIPLEVENT: 和 URC +CSCON: 输出顺序不唯一。 2. AT+CSCON 命令的详细信息，请参考文档 [3]。 5.9. 更新操作 5.9.1. 无 RAI 标志的更新操作 前提条件： 模块已经成功注册到 OneNET 平台。 AT+MIPLUPDATE=0,86400,0 OK //发送更新请求，生命周期为 86400 秒 +MIPLEVENT: 0,11 //返回结果，更新成功 上海移远通信技术股份有限公司 46 / 61 BC28-F&BC95-GF OneNET 应用指导 5.9.2. 有 RAI 标志的更新操作 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 执行 AT+CSCON=1 命令开启 +CSCON: URC 报告功能，可以指示 RAI 标记是否生效。 [14:43:14:359]AT+MIPLUPDATE=0,86400,0,0x400 [14:43:14:391]OK [14:43:14:832] [14:43:14:832]+CSCON:1 [14:43:15:182] [14:43:15:182]+MIPLEVENT: 0,11 [14:43:15:389] [14:43:15:389]+CSCON:0 //发送更新请求，更新生命周期为 86400 秒，设置 RAI 为 0x400 //建立 RRC 连接，开始发送数据 //返回结果，更新成功 //接收 ACK 之后，RRC 连接会被立即释放 5.10. 下行数据缓存 前提条件： 模块已经成功入网。 AT+MIPLCONFIG=0,'183.230.40.40',5683 //配置接入机地址 OK AT+MIPLCONFIG=7,3,1 //配置为同时缓存下行写请求和执行请求的数据，开启 URC 提示 OK AT+MIPLCONFIG=4,1,'Quectel123456789' OK AT+MIPLCONFIG? +MIPLCONFIG:0,183.230.40.40,5683 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,1,Quectel123456789 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,3,1 OK AT+MIPLCREATE +MIPLCREATE:0 上海移远通信技术股份有限公司 47 / 61 BC28-F&BC95-GF OneNET 应用指导 OK AT+MIPLADDOBJ=0,3303,2,'11',4,1 OK AT+MIPLOPEN=0,86400,60 OK +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 +MIPLOBSERVE: 0,105630,1,3303,0,-1 +MIPLOBSERVE: 0,171167,1,3303,1,-1 +MIPLDISCOVER: 0,40096,3303 AT+MIPLDISCOVERRSP=0,40096,1,24,'5700;5701;5601;5602;5605' OK +MIPLEVENT: 0,11 //更新成功 +MIPLEVENT: 0,100 //收到下行数据并缓存 //查询缓存，已经缓存 1 条下行数据，下行数据为 15 字节，总共接收到 1 条下行数据，没有丢弃数据 AT+MIPLRD? +MIPLRD: 1,15,1,0 OK //查询缓存，已经缓存 2 条下行数据，下行数据总共为 29 字节，总共接收到 2 条下行数据，没有丢弃数据 AT+MIPLRD? +MIPLRD: 2,29,2,0 OK //读取缓存数据，返回最早收到的数据 AT+MIPLRD +MIPLEXECUTE: 0,40103,3303,0,5605,15,'reset0123456789' OK //读取缓存数据，返回最早收到的数据 AT+MIPLRD +MIPLWRITE: 0,40104,3303,0,5706,2,5,68656C6C6F,0,2 +MIPLWRITE: 0,40104,3303,0,5850,2,1,01,0,1 上海移远通信技术股份有限公司 48 / 61 BC28-F&BC95-GF OneNET 应用指导 +MIPLWRITE: 0,40104,3303,0,5851,2,8,00000002DFDC1C3E,0,0 OK 5.11. OneNET 平台 DFOTA 实例 5.11.1. 创建群组 1. 设备注册到 OneNET 平台后，在 OneNET 平台网站主界面左侧工具栏选择'OTA 升级'下的'FOTA 升级'→'添加 FOTA 群组'。 图 2：创建 FOTA 群组 1 2. 填写相应的群组信息。'群组名称'和'群组描述'可根据需求填写，'厂商名称'选择'移远 通信'，'模块型号'选择对应模块型号。如下图所示，'模块型号'选择的是'BC95-GF'。 图 3：创建 FOTA 群组 2 上海移远通信技术股份有限公司 49 / 61 BC28-F&BC95-GF OneNET 应用指导 5.11.2. 群组关联设备 1. 在'FOTA 升级'页面中选择'关联设备'，添加 DFOTA 设备，如下图所示。 图 4：选择关联设备 2. 关联设备时，平台会根据创建群组时选择的模块型号，弹出当前产品下对应模块型号的设备。用户 直接添加对应模块型号的设备即可。若无可添加的设备或未获取到需要添加终端设备的版本号，说 明添加设备失败，请查看 IMEI 是否合法、需要添加的模块的型号是否与群组的模块型号一致或模 块是否在线，如下图所示。 上海移远通信技术股份有限公司 图 5：关联设备 50 / 61 BC28-F&BC95-GF OneNET 应用指导 5.11.3. 新增固件版本 1. 请先从移远通信技术支持处获取差分升级包，并且确定当前版本号和目标版本号。 2. 在'FOTA 升级'页面中'正式群组'上点击'FOTA 升级'进入'固件管理'页面，如下图所示。 图 6：选择 FOTA 升级 3. 在'固件管理'页面点击'添加固件版本'，进入添加固件版本页面，如下图所示。模块当前支持 以 DFOTA 方式升级固件，所以平台的 FOTA 升级需要添加两次固件版本，即目标版本和当前固件 版本。以下以 BC95-GF 模块举例展示固件版本的添加步骤。 图 7：添加固件版本 上海移远通信技术股份有限公司 51 / 61 BC28-F&BC95-GF OneNET 应用指导 1) 向 OneNET 平台添加差分升级包的当前版本信息，例如'BC95GFFAR01A05'。 图 8：新增当前版本号 2) 向 OneNET 平台添加差分升级包的目标版本信息，例如'BC95GFFAR01A05_BETA0729A'。 图 9：新增目标版本号 上海移远通信技术股份有限公司 52 / 61 BC28-F&BC95-GF OneNET 应用指导 5.11.4. 上传差分升级包 1. 在'FOTA 升级'→'固件管理'页面中选择目标版本点击'添加升级包'。下图以目标版本 'BC95GFFAR01A05_BETA0729A'为例。 图 10：升级包管理页面 2. 添加升级包。'类型'选择'差分包'，'初始版本'为当前终端设备的固件版本，如'BC9 5GFFAR01A05'，'目标版本'为待升级的目标版本，如'BC95GFFAR01A05_BETA072 9A'。点击'选择文件'选择差分升级包的本地路径，点击'确定'上传差分升级包文件。 需注意，上传到 OneNET 平台的是差分升级包的 bin 文件，不是 zip 的压缩文件，如下图所示。 图 11：上传差分升级包 上海移远通信技术股份有限公司 53 / 61 BC28-F&BC95-GF OneNET 应用指导 5.11.5. 创建升级任务 1. 在 FOTA 群组中选择对应模块的'FOTA 升级'→'升级任务管理'页面中点击'添加升级任务'， 如下图所示： 图 12：升级任务管理页面 2. 任务名称可以自定义（下图以'quectel_demo'为例），选择升级包时需注意检查初始版本，如 'BC95GFFAR01A05'和目标版本号，如'BC95GFFAR01A05_BETA0729A'。'信号读取质 量'等其他信息建议采用默认值，也可以根据实际情况进行填写，如下图所示。 图 13：添加升级任务页面 上海移远通信技术股份有限公司 54 / 61 BC28-F&BC95-GF OneNET 应用指导 3. 选择'FOTA 升级'→'升级任务管理'→'任务'→'更多操作'→'详情'，打开升级任务详 情页面，如下图所示： 图 14：升级任务详情页面 5.11.6. 设备升级 1. 升级任务创建成功之后，终端设备需等待 1~3 分钟后，再执行触发 DFOTA 升级命令操作，使用以 下 3 种方法均可以触发 DFOTA 升级操作： 1) 若创建升级任务时，终端设备离线，终端设备需要重新注册到平台才能触发 DFOTA 升级任务。 2) 若创建升级任务时，终端设备在线，终端设备执行更新操作（如：AT+MIPLUPDATE=0,8640 0,0），可触发 DFOTA 升级任务。 3) 若创建升级任务时，终端设备在线，终端设备执行上报消息操作（如：AT+MIPLNOTIFY=0, 96119,3200,0,5750,1,5,'Dfota',0,0,45），可触发 DFOTA 升级任务。 状态更新成功后，在 OneNET 平台的'升级任务详情'页面下载状态会更新为'下载中'，如下图 所示。 上海移远通信技术股份有限公司 图 15：升级任务下载中 55 / 61 BC28-F&BC95-GF OneNET 应用指导 2. OneNET 平台 DFOTA 过程中，MCU 侧 AT 命令操作实例如下。 ATI Quectel BC95-GF Revision:BC95GFFAR01A05 //查询当版本 OK AT+MIPLCREATE +MIPLCREATE: 0 //创建 OneNET 通信套件实例 OK AT+MIPLOPEN=0,84600 OK //发送注册请求 +MIPLEVENT: 0,1 //引导开始 +MIPLEVENT: 0,2 //引导成功 +MIPLEVENT: 0,4 //连接成功 +MIPLEVENT: 0,6 //注册成功 +MIPLEVENT: 0,40 //差分升级包（固件）开始下载 +MIPLEVENT: 0,42 //差分升级包（固件）下载完成 +MIPLEVENT: 0,43 //固件开始升级 REBOOT_CAUSE_APPLICATION_POWER_ON_RESET OK FIRMWARE UPDATE SUCCESS FIRMWARE UPDATE OVER AT+MIPLCREATE +MIPLCREATE: 0 OK AT+MIPLADDOBJ=0,3302,1,'1',4,1 OK AT+MIPLOPEN=0,84600 OK //再注册到平台，以便上报升级结果到平台 上海移远通信技术股份有限公司 56 / 61 BC28-F&BC95-GF OneNET 应用指导 +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 +MIPLEVENT: 0,48 +MIPLEVENT: 0,11 ATI Quectel BC95-GF Revision: BC95GFFAR01A05_BETA0729A //查询当版本 OK 5.11.7. 重新注册设备 模块升级后，MCU 需要控制模块重新向 OneNET 平台发起注册，以便模块上报升级结果。成功上报 后平台显示如下： 图 16：任务升级成功 上海移远通信技术股份有限公司 57 / 61 BC28-F&BC95-GF OneNET 应用指导 6 错误码 本章介绍关于 BC28-F 和 BC95-GF 模块相关的错误码 。 下面两个表格的错误码符合 3GPP 规范。请参考 3GPP TS 27.007 和 3GPP TS 27.005 查看所有错误 码。 表 3：一般错误（27.007） 错误码 3 4 23 30 50 51 52 159 描述 操作不允许 操作不支持 内存不足 无网络服务 无效参数 命令已实现，但当前已禁用 命令被用户终止 上行忙碌/流量控制 表 4：一般错误（27.005） 错误码 300 301 302 303 304 描述 ME 失败 保留 ME 的 SMS 服务 操作不允许 操作不支持 非法的 PDU 模式参数 上海移远通信技术股份有限公司 58 / 61 BC28-F&BC95-GF OneNET 应用指导 305 非法的文本模式参数 310 未插入 USIM 311 需要 USIM PIN 312 需要 PH-USIM PIN 313 USIM 失败 314 USIM 忙碌 315 USIM 错误 316 需要 USIM PUK 317 需要 USIM PIN2 318 需要 USIM PUK2 320 内存失败 321 非法内存索引 322 内存已满 330 未知 SMSC 地址 331 无网络服务 332 网络超时 340 没有期望的 +CNMA 通知 500 未知错误 备注 可使用 AT+CMEE=禁用（=0）或启用（=1）结果码 +CME ERROR: 。当=1，将 返回一组有限的错误码，详细请参考文档 [3]。 上海移远通信技术股份有限公司 59 / 61 BC28-F&BC95-GF OneNET 应用指导 7 附录 A 参考文档与术语缩写 表 5：参考文档 文档名称 [1] IPSO-Smart-Objects-Starter-Pack（ Smart Objects（IPSO）联盟国际标准） [2] OMA-TS-LightweightM2M-V1_0（开放移动联盟 LwM2M 标准） [3] Quectel_BC28-F&BC95-GF_AT 命令手册 表 6：术语缩写 缩写 3GPP ACK CoAP CON DFOTA DTLS FOTA IPSO M2M LwM2M MCU ME NB-IoT 英文全称 3rd Generation Partnership Project Acknowledge Character Constrained Application Protocol Confirmable Delta Firmware Upgrade Over-The-Air Datagram Transport Layer Security Firmware Upgrade Over-The-Air Internet Protocol Smart Objects Machine-To-Machine Lightweight Machine to Machine Microcontroller Unit Mobile Equipment Narrow Band Internet of Things 中文描述 第三代合作伙伴计划 确认字符 受限应用协议 需要应答 固件空中差分升级 数据包传输层安全性协议 固件空中升级 智能物体网际协议 机器对机器 轻量化的 M2M 协议 微控制单元/单片机 移动设备 窄带物联网 上海移远通信技术股份有限公司 60 / 61 NON PDU PIN PSK PUK RAI REST RRC SDK SMS SMSC SOTA TE OTA UE URC USIM BC28-F&BC95-GF OneNET 应用指导 Non-confirmable Protocol Data Unit Personal Identification Number Pre-Shared Key Personal Identification Number Unlock Key Release Assistance Indication Representational state transfer Radio Resource Control Software Development Kit Short Message Service Short Message Service Center Software Over the Air (Typically the MCU) Terminal Equipment (Typically the MCU) Over-the-Air (Technology) User Equipment (Typically the Module) Unsolicited Result Code Universal Subscriber Identity Module 不需要应答 协议数据单元 个人身份识别码 预共享密钥 PIN 解锁码 释放辅助指示 表述性状态传递 无线资源控制协议 软件开发工具包 短信息服务 短消息服务中心 软件空中升级（MCU） 终端设备（MCU） 空中下载技术 用户设备（模块） 非请求结果码 全球用户识别卡 上海移远通信技术股份有限公司 61 / 61

BC28-F&BC95-GF Log 抓取指导 NB-IoT 模块系列 版本：1.1 日期：2021-01-30 状态：受控文件 www.quectel.com BC28-F&BC95-GF Log 抓取指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 23 BC28-F&BC95-GF Log 抓取指导 文档历史 修订记录 版本 日期 - 2020-11-17 1.0 2020-11-27 1.1 2021-01-30 作者 Jacobi RAO Jacobi RAO Jacobi RAO 变更表述 文档创建 受控版本 新增适用模块 BC28-F 信息。 上海移远通信技术股份有限公司 2 / 23 BC28-F&BC95-GF Log 抓取指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................3 表格索引 ..................................................................................................................................................... 4 图表索引 ..................................................................................................................................................... 5 1 引言.....................................................................................................................................................6 2 工具与驱动 ..........................................................................................................................................7 2.1. TE-B 开发板..............................................................................................................................7 2.2. EPAT 运行环境 .........................................................................................................................8 3 连接与设置 ........................................................................................................................................10 3.1. 连接设置 .................................................................................................................................10 3.2. 状态查看 ................................................................................................................................. 11 3.2.1. 模块连接状态查看 ........................................................................................................ 11 3.2.2. 模块数据库状态查看 .................................................................................................... 11 4 Log 抓取流程 ...................................................................................................................................12 4.1. 确认模块处于校准状态............................................................................................................12 4.2. 启动 EPAT ..............................................................................................................................13 4.3. 配置端口波特率 ......................................................................................................................14 4.4. 选择数据库文件 ......................................................................................................................15 4.5. 抓取 Log .................................................................................................................................17 4.6. 保存 Log .................................................................................................................................17 4.6.1. 手动保存 ......................................................................................................................18 4.6.2. 自动保存 ......................................................................................................................19 5 常见问题............................................................................................................................................21 5.1. 模块连接不上 PC 怎么办？.....................................................................................................21 5.2. 模块连接不上 EPAT 怎么办？ .................................................................................................21 5.3. 如何获取数据库文件？............................................................................................................21 5.4. 数据库文件不匹配怎么办？ ....................................................................................................21 5.5. Log 抓取的波特率可以修改吗？..............................................................................................22 6 附录 A 参考文档及术语缩写 .............................................................................................................23 上海移远通信技术股份有限公司 3 / 23 BC28-F&BC95-GF Log 抓取指导 表格索引 表 1：TE-B 关键组件介绍.................................................................................................................................... 8 表 2：模块连接状态 ............................................................................................................................................11 表 3：数据库状态................................................................................................................................................11 表 4：按钮功能介绍 ........................................................................................................................................... 17 表 5：参考文档 .................................................................................................................................................. 23 表 6：术语缩写 .................................................................................................................................................. 23 上海移远通信技术股份有限公司 4 / 23 BC28-F&BC95-GF Log 抓取指导 图表索引 图 1：BC95-GF-TE-B .......................................................................................................................................... 7 图 2：接口显示图............................................................................................................................................... 10 图 3：选择数据资源 ........................................................................................................................................... 13 图 4：打开资源选择串口.................................................................................................................................... 13 图 5：选择 Device.............................................................................................................................................. 14 图 6：选择端口和波特率.................................................................................................................................... 14 图 7：打开数据库窗口 ....................................................................................................................................... 15 图 8：更新数据库文件 ....................................................................................................................................... 16 图 9：选择数据库文件 ....................................................................................................................................... 16 图 10：控制抓取 Log 按钮 ................................................................................................................................. 17 图 11：Log 手动保存.......................................................................................................................................... 18 图 12：选择保存路径 ......................................................................................................................................... 18 图 13：保存成功 ................................................................................................................................................ 19 图 14：打开自动保存设置.................................................................................................................................. 19 图 15：自动保存设置 ......................................................................................................................................... 20 图 16：保存成功 ................................................................................................................................................ 20 上海移远通信技术股份有限公司 5 / 23 BC28-F&BC95-GF Log 抓取指导 1 引言 本文档主要介绍如何通过 EPAT 工具和 TE-B 开发板，抓取移远通信 BC28-F 和 BC95-GF 模块的 Log 信息，同时对模块的 TE-B、EPAT 工具、端口设置以及抓取和保存 Log 进行说明。 上海移远通信技术股份有限公司 6 / 23 BC28-F&BC95-GF Log 抓取指导 2 工具与驱动 对模块进行 Log 抓取需要使用以下工具和驱动： ⚫ 开发板：BC28-F 和 BC95-GF 模块的 TE-B 开发板 ⚫ 串口通信工具：移远通信 QCOM 1.6 或者更新的版本 ⚫ Log 抓取工具：EPAT ⚫ USB 转串口驱动：由电脑自行通过驱动识别工具自动安装 2.1. TE-B 开发板 本章节以 BC95-GF-TE-B 开发板为例，介绍了 TE-B 开发板，包括实物图及组件功能等： 图 1：BC95-GF-TE-B 上海移远通信技术股份有限公司 7 / 23 下表描述了 BC95-GF-TE-B 的组件功能。 BC28-F&BC95-GF Log 抓取指导 表 1：TE-B 关键组件介绍 序号 组件名称 1 RESET 按钮 2 BOOT 按钮 3 WAKEUP 按钮 4 串口开关 5 跳线帽 6 Mini USB 端口 7 电源口 8 天线端口 描述 用于重启模块。 用于固件的下载。如下两种方式可使模块进入 BOOT 下载模式 1)： ⚫ 烧录固件时，需要先按下 BOOT，同时再按下 RESET，然后松开 RESET，最后再松开 BOOT 按钮，才能触发模块烧录固件。 ⚫ 烧录固件时，按下 RESET，然后松开 RESET。 将模块从休眠中唤醒。 控制主串口连接模块或连接外接 MCU。 连接 USB 端口和 USIM 卡功能模块，若不连接，USB 供电时，USIM 卡不 能供电。 通过 UART 转 USB 芯片，将 UART 口转成 4 路端口：1 路用于 AT 命令， 1 路用于抓取 Log，其它 2 路预留。 用于向 TE-B 提供 5 V 稳压电源。当 Mini USB 不能提供稳定电压时，需要 通过该接口引入稳压源。 提供给外置天线连接使用。 备注 1. 1) 不同的工具版本只支持其中一种方式。 2. 关于 BC95-GF-TE-B 的详细信息，请参考文档 [1]。 3. 关于 BC28-F-TE-B 的详细信息，请参考文档 [2]。 2.2. EPAT 运行环境 EPAT（Eigen Comm Platform Analysis Tools）是一款适用于 BC28-F 和 BC95-GF 模块的 Log 抓取、 分析工具。EPAT 支持在线的 Log 抓取和离线的 Log 分析，主要用于问题的追踪、定位和模块的调试。如 需获取该工具，可联系移远通信技术支持 support@quectel.com。 EPAT 在 PC 中的运行环境需要满足以下条件： 1. 硬件条件： ⚫ CPU：Inter Core（建议 Inter Core i3 以上） 上海移远通信技术股份有限公司 8 / 23 BC28-F&BC95-GF Log 抓取指导 ⚫ 内存：1 GB（建议 2 GB 以上） ⚫ 硬盘：5120 MB 可用空间 ⚫ 接口：2 个 USB 口（最小值） 2. 软件条件： ⚫ 操作系统：Microsoft Windows 7、Windows 8.1 或 Windows 10 ⚫ 软件环境：Microsoft Visual C++ 2015 Redistributable (x86) 或 Microsoft Visual Studio 2015 EPAT 工具为绿色软件，无需进行复杂的安装过程。将工具包拷贝到 PC 上，在 Bin 文件夹下找到 EPAT.exe 双击打开即可运行。 上海移远通信技术股份有限公司 9 / 23 BC28-F&BC95-GF Log 抓取指导 3 连接与设置 3.1. 连接设置 通过 TE-B 上的 Mini USB 口将模块与 PC 连接，完成连接后 PC 会自动安装驱动，安装完成后会出现 4 个端口，如下图所示： 图 2：接口显示图 一般情况下，第一个端口 'USB Serial Port (COM36)'用于 AT 命令通信；第三个端口 'USB Serial Port (COM38)'用于抓取 Log。 备注 1. PC 安装的驱动不同可能会导致实际显示的端口名称与以上截图不一致，请以实际情况为准。 2. 不同的 PC 上可能端口的顺序是不同的，不一定总是第一个和第三个。 上海移远通信技术股份有限公司 10 / 23 BC28-F&BC95-GF Log 抓取指导 3.2. 状态查看 3.2.1. 模块连接状态查看 在 EPAT 工具的右下角，可以查看模块的连接状态，如下表所示。 表 2：模块连接状态 图标显示 状态 连接成功 未连接 连接失败 说明 设备可以和 EPAT 工具通信，可抓取 Log。 EPAT 没有找到设备，不能抓取 Log，请参考第 5.2 章 处理。 EPAT 与设备通信失败，不能抓取 Log，请参考第 5.2 章 处理。 3.2.2. 模块数据库状态查看 在 EPAT 工具的左上角，可以查看模块的数据库状态。 表 3：数据库状态 图标显示 状态 数据库读取失败 说明 指定路径下无数据库文件或更改路径后没有重启，请参考 第 5.4 章 更新数据库文件或尝试重启设备。 数据库不匹配 请参考第 5.4 章 更新数据库文件。 数据库匹配 可正常抓取 Log。 上海移远通信技术股份有限公司 11 / 23 BC28-F&BC95-GF Log 抓取指导 4 Log 抓取流程 抓取的 Log 需要保证其有效性和便于分析。因此，每次抓取的 Log 都要确保数据库选择正确，且单板 校准正常。Log 抓取步骤如下： 第一步：确认模块处于校准状态 第二步：启动 EPAT 工具 第三步：配置端口波特率 第四步：选择数据库文件 第五步：抓取 Log 第六步：保存 Log 4.1. 确认模块处于校准状态 连接设置完成后，注意确认模块是否处于校准状态。所有的测试、应用都应当在校准的状态下进行， 否则不能保证模块的功能和性能。 执行以下 AT 命令查询是否校准，若未校准，请校准后再测试和应用。 AT+QRFSTAT NOT CALIBRATE //表示模块没有校准，这时不能进行测试，各项性能都不能保证 OK AT+QRFSTAT CALIBRATE //表示模块已经校准，这时可以进行测试，并抓取 Log OK 备注 AT+QRFSTAT 命令正在开发中，详细介绍请参考文档 [3]。 上海移远通信技术股份有限公司 12 / 23 BC28-F&BC95-GF Log 抓取指导 4.2. 启动 EPAT 首次启动 EPAT 后，会弹出对话框，如下图所示选择'Serial Device'： 图 3：选择数据资源 如果不是首次启动，可能不会弹出以上窗口，此时如需选择数据资源，可以点击 EPAT 工具上如下图 所示按钮以弹出以上对话框： 图 4：打开资源选择串口 上海移远通信技术股份有限公司 13 / 23 BC28-F&BC95-GF Log 抓取指导 4.3. 配置端口波特率 选择'Serial Device'并点击'OK'后，会弹出如下端口设置界面，点击'Settings'进行端口和波 特率设置： 图 5：选择 Device 图 6：选择端口和波特率 上海移远通信技术股份有限公司 14 / 23 BC28-F&BC95-GF Log 抓取指导 完成如上的波特率选择后，同时需要在 AT 口执行以下命令设置 Log 抓取波特率： AT+QCFG='logbaudrate',3000000 OK AT+QCFG='logbaudrate',6000000 OK //设置波特率为 3 M //设置波特率为 6 M 备注 1. Log 抓取的默认波特率为 6 M，建议用户设置的波特率不低于 3 M，否则会出现 Log 大量丢失的现 象，导致后续无法进行问题分析。 2. EPAT 工具界面设置的波特率要与使用 AT 命令设置的 Log 抓取波特率保持一致。 3. 关于 AT+QCFG 命令的详细介绍，请参考文档 [3]。 4.4. 选择数据库文件 不同的固件版本，需要不同的数据库文件才能正确解码。因此，在进行 Log 抓取时需要先选择正确的 数据库文件。 点击 EPAT 的左上角图标，如下图所示： 图 7：打开数据库窗口 上海移远通信技术股份有限公司 15 / 23 在弹出的对话框中点击'Update'以更新数据库文件： BC28-F&BC95-GF Log 抓取指导 图 8：更新数据库文件 在弹出的对话框中点击'...'选择相应的数据库文件的路径。完成后点击'Update'按钮，更新数据 库，直至更新完成。 图 9：选择数据库文件 上海移远通信技术股份有限公司 16 / 23 BC28-F&BC95-GF Log 抓取指导 4.5. 抓取 Log 点击左上角的开始、暂停、停止或清除按钮控制 Log 的抓取。 图 10：控制抓取 Log 按钮 表 4：按钮功能介绍 按钮图标 功能 开始/继续 暂停 停止 清除 介绍 开始抓取 Log 或暂停后继续抓取 Log。查看器可以自动刷新 Log 页面。 暂停抓取 Log。查看器不刷新 Log 显示，但继续保存 Log。若不确定当 前的 Log 是否已发现 UE 的故障，可使用该按钮。 查看器不刷新 Log 显示，并停止保存 Log。当前的 Log 已经保存，后续 接收的 Log 不需要保存时，可使用该按钮。 清除显示页面内已经抓取的 Log。 4.6. 保存 Log Log 保存可以设置为手动保存和自动保存。用户可根据实际需要进行选择。选择手动保存 Log 时，每 次抓取 Log 均需进行保存设置。若选择自动保存，仅需要第一次 Log 保存的时候进行设置，后续抓取 Log， EPAT 会自动将 Log 文件保存到所设置的文件夹。 上海移远通信技术股份有限公司 17 / 23 BC28-F&BC95-GF Log 抓取指导 4.6.1. 手动保存 点击工具栏的保存按钮或者按键盘快捷键'CTRL'+'S'，在弹出的窗口选择需要保存的路径。如下 图所示。 图 11：Log 手动保存 图 12：选择保存路径 上海移远通信技术股份有限公司 18 / 23 BC28-F&BC95-GF Log 抓取指导 若弹出如下窗口，说明 Log 保存成功。保存时默认文件名为时间，为了便于识别，可自定义文件名称。 图 13：保存成功 4.6.2. 自动保存 点击主菜单上的'Log'→'Preference'，在弹出的对话框中可设置自动保存功能。 图 14：打开自动保存设置 上海移远通信技术股份有限公司 19 / 23 BC28-F&BC95-GF Log 抓取指导 在弹出的窗口中勾选'AutoSave Log File'，并设置自动保存 Log 文件的大小，以及保存路径。其中 Log 文件的大小不能设置超过 1000 MB。点击'OK'保存配置。 图 15：自动保存设置 若弹出如下窗口说明 Log 保存成功。 图 16：保存成功 上海移远通信技术股份有限公司 20 / 23 BC28-F&BC95-GF Log 抓取指导 5 常见问题 5.1. 模块连接不上 PC 怎么办？ 模块连接 PC 时，Windows 系统会自动搜索并安装 USB 转串口驱动以连接设备。如果测试 PC 不能联 网，可能导致驱动无法下载，此时需要先从其它 PC 下载驱动，再通过 U 盘等方式安装在该测试 PC 上。 如果找不到合适的驱动，可联系移远通信技术支持 support@quectel.com。 5.2. 模块连接不上 EPAT 怎么办？ 首先需要检查端口是否正确。一般情况下为第 3 个端口，如果不正确，则需要尝试其它端口。 如果确认端口正确，但仍然无法连接，或者尝试所有端口均无法成功连接，请检查波特率是否正确。 如果配置的波特率与 Log 口不一致，可能输出乱码数据；如果 TE-B 上的 UART2USB 芯片不支持所配置的 波特率 Log 口，则不会输出任何内容。此时，需要修改波特率适配 UART2USB 芯片，详情请见第 5.5 章。 5.3. 如何获取数据库文件？ 数据库文件随着固件包一起提供，固件包中后缀名为'comdb.txt'的就是数据库文件。如果出现以下 情况，请联系移远通信技术支持 support@quectel.com： ⚫ 无固件包 ⚫ 固件包中无数据库文件 ⚫ 固件包中的数据库文件不匹配 5.4. 数据库文件不匹配怎么办？ 数据库文件不匹配时，需重新选择数据库文件。数据库文件被用来解码消息，如果不匹配会导致解码 错误或其他异常，并且可能出现 Log 数据不显示，进而影响问题的分析。因此，务必要保证数据库文件匹 配。如果不匹配，请按照第 4.4 章 内容重新选择数据库文件。 上海移远通信技术股份有限公司 21 / 23 BC28-F&BC95-GF Log 抓取指导 5.5. Log 抓取的波特率可以修改吗？ Log 抓取的波特率可以修改。Log 抓取的默认波特率为 6 M，可在选择设置端口波特率的时候进行修改 （见第 4.3 章）。请注意，修改 Log 抓取波特率的同时，需要通过 AT+QCFG='logbaudrate'配置 TE-B 抓 取 Log 的波特率。关于该条命令详情，请参考文档 [3]。 上海移远通信技术股份有限公司 22 / 23 BC28-F&BC95-GF Log 抓取指导 6 附录 A 参考文档及术语缩写 表 5：参考文档 序号 [1] [2] [3] 文档名称 Quectel_BC95-GF-TE-B_用户指导 Quectel_BC28-F-TE-B_用户指导 Quectel_BC28-F&BC95-GF_AT 命令手册 备注 BC95-GF-TE-B 用户指导 BC28-F-TE-B 用户指导 BC28-F 和 BC95-GF AT 命令手册 表 6：术语缩写 缩写 EPAT NB-IoT PC UART UE USB USIM 英文全称 中文全称 Eigen Comm Platform Analysis Tools Eigen Comm 平台分析工具 Narrow Band Internet of Things 窄带物联网 Personal Computer 个人电脑 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 User Equipment 用户设备 Universal Serial Bus 通用串行总线 Universal Subscriber Identity Module 全球用户识别卡 上海移远通信技术股份有限公司 23 / 23

BC28-F&BC95-GF& BC35-G&BC28&BC95 R2.0 系列 软件差异说明 NB-IoT 模块系列 版本：1.0 日期：2021-03-22 状态：受控文件 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 文档历史 修订记录 版本 1.0 日期 2020-12-31 2021-03-22 作者 变更表述 Louis GU 文档创建 Louis GU 受控版本 上海移远通信技术股份有限公司 2 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................ 3 表格索引 ..................................................................................................................................................... 5 1 引言 ..................................................................................................................................................... 6 2 综述 ..................................................................................................................................................... 7 2.1. 产品简介 ............................................................................................................................... 7 2.2. 波特率特性 ............................................................................................................................ 7 2.3. 深休眠模式 ............................................................................................................................ 7 2.4. 开机 URC .............................................................................................................................. 8 2.5. 串口波特率容限..................................................................................................................... 9 3 常用 AT 命令 ..................................................................................................................................... 11 3.1. 一般命令差异 .......................................................................................................................11 3.1.1. 查询制造商版本号命令 ....................................................................................................11 3.1.2. 查询可用命令 ................................................................................................................. 12 3.1.3. 重启命令 ........................................................................................................................ 12 3.1.4. 配置主串口波特率命令 ................................................................................................... 13 3.1.5. 设置调试日志级别 .......................................................................................................... 13 3.1.6. 扩展配置命令 ................................................................................................................. 14 3.1.7. 查询 DNS 服务器地址命令 ............................................................................................. 15 3.2. 网络相关命令 ...................................................................................................................... 15 3.2.1. 读取 SIM 卡 ICCID 命令 ................................................................................................. 15 3.2.2. 选择运营商命令.............................................................................................................. 16 3.2.3. 查询信号信息命令 .......................................................................................................... 16 3.2.4. 上报 IP 地址命令 ............................................................................................................ 16 3.2.5. 配置支持的频段命令 ...................................................................................................... 17 3.2.6. 设置 UE 行为命令 .......................................................................................................... 18 3.2.7. 定义 PDP 上下文鉴权参数命令 ...................................................................................... 19 3.2.8. 定义 PDP 上下文参数命令 ............................................................................................. 19 4 中国电信物联网平台.......................................................................................................................... 20 4.1. 中国电信物联网平台相关 AT 命令差异 ................................................................................ 20 4.1.1. 发送 CON 消息命令 ....................................................................................................... 20 4.1.2. 触发注册命令 ................................................................................................................. 21 4.2. Lifetime 更新失败处理机制.................................................................................................. 21 4.3. URC 差异 ............................................................................................................................ 21 5 OneNET 平台.................................................................................................................................... 22 5.1. OneNET 平台相关 AT 命令差异 .......................................................................................... 22 5.2. 数据缓存机制 ...................................................................................................................... 22 6 其他处理机制差异 ............................................................................................................................. 23 6.1. 搜网机制 ............................................................................................................................. 23 上海移远通信技术股份有限公司 3 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 6.2. 多路 PDN 处理机制 ............................................................................................................. 23 6.3. TX/RX 时间统计清零机制.................................................................................................... 23 6.4. 网络去附着时 URC 上报顺序 .............................................................................................. 23 6.5. OOS 状态处理机制 ............................................................................................................. 24 6.6. SIM 卡检卡机制................................................................................................................... 24 7 附录 A 参考文档及术语缩写 .............................................................................................................. 25 上海移远通信技术股份有限公司 4 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 表格索引 表 1：波特率特性差异 ............................................................................................................................... 7 表 2：深休眠对比 ...................................................................................................................................... 8 表 3：BC28-F/BC95-GF 模块不同温度下波特率接收容限（Error）参考数据表 ........................................ 9 表 4：BC28-F/BC95-GF 模块不同电压下波特率接收容限（Error）参考数据表 ....................................... 9 表 5：BC35-G/BC28/BC95 R2.0 系列模块主串口波特率接收容限（Error）参考数据表 ........................... 9 表 6：查询制造商版本号命令差异 ............................................................................................................11 表 7：查询可用命令的命令差异............................................................................................................... 12 表 8：重启命令差异................................................................................................................................. 12 表 9：配置波特率命令差异 ...................................................................................................................... 13 表 10：设置调试日志级别指令差异 ......................................................................................................... 13 表 11：扩展配置命令差异........................................................................................................................ 14 表 12：查询 DNS 服务器地址 AT 命令差异 ............................................................................................. 15 表 13：读取 SIM 卡 ICCID 号命令差异 .................................................................................................... 15 表 14：查询信号信息命令差异 ................................................................................................................ 16 表 15：上报 IP 地址命令差异 .................................................................................................................. 16 表 16：配置支持的频段命令差异............................................................................................................. 17 表 17：配置 UE 行为命令差异................................................................................................................. 18 表 18：定义 PDP 上下文鉴权参数命令差异............................................................................................. 19 表 19：发送 CON 消息命令差异.............................................................................................................. 20 表 20：触发注册命令差异........................................................................................................................ 21 表 21：缓存数据已满时上报 URC 的差异................................................................................................ 21 表 22：配置加密连接命令差异 ................................................................................................................ 22 表 23：参考文档...................................................................................................................................... 25 表 24：术语缩写...................................................................................................................................... 25 上海移远通信技术股份有限公司 5 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 1 引言 移远通信 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块在软硬件方面基本相互兼容，一般 情况下，客户无需重新设计 PCB 和 MCU 流程，但是仍然存在一些差异。本文档主要介绍了模块在软件方 面的差异性，包括休眠模式、波特率特性、综合 AT 命令、物联网平台相关 AT 命令以及 URC 等方面的差 异。 备注 关于 BC95-GF 和 BC95 R2.0 系列模块的硬件差异，请参考《Quectel_BC95-GF&BC95 R2.0 系列_兼容 参考设计手册》；BC28-F 和 BC28 模块的硬件差异，请参考《Quectel_BC28-F&BC28_兼容参考设计 手册》。 上海移远通信技术股份有限公司 6 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 2 综述 2.1. 产品简介 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块均为 NB-IoT 物联网模块，具有高性能，低 功耗的特性，用户可以根据需求选择合适的产品用于终端设计。 2.2. 波特率特性 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块的波特率特性差异如下表所示。 表 1：波特率特性差异 特性 主串口波特率 (bps) 调试串口波特率 (bps) BC35-G/BC28/BC95 R2.0 系列 BC28-F/BC95-GF 用于 AT 命令通信和数据传输： 用于 AT 命令通信和数据传输： 2400、4800、9600（默认）、57600、 2400、4800、9600（默认）、57600、 115200、230400、460800 115200、230400 用于固件升级： 用于固件升级： 115200 和 921600 921600 921600；不可配置 默认 6 Mbps； 可通过 AT+QCFG='logbaudrate'配置 2.3. 深休眠模式 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块在波特率为 9600 bps 及以下时均支持低功耗 串口模式，模块进入深休眠后，可正常进行数据交互。 上海移远通信技术股份有限公司 7 / 26 表 2：深休眠对比 功能 功耗 URC 提示 URC 开关命令 唤醒方式 主串口 AT 命令 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 BC35-G/BC28/BC95 R2.0 系列 3.0 μA 唤醒：+NPSMR:0 进入：+NPSMR:1 AT+NPSMR=，默认关闭 上行数据/RTC 1) 主串口可直接发送数据 AT+CPSMS BC28-F/BC95-GF 0.8 μA 唤醒：+NPSMR:0 进入：+NPSMR:1 AT+NPSMR=，默认关闭 上行数据/RTC 1) 主串口可直接发送数据 AT+CPSMS 备注 1) RTC 主要针对 Lifetime、TAU 计时等。 2.4. 开机 URC BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块上电开机时，都会有相应的 URC 来表示开 机时的状态。用户可以通过开机上报的 URC 来判断模块是否开机成功，如下所示： ⚫ BC28-F/BC95-GF 的开机 URC 如下，收到 OK 表示模块开机成功： ⚫ BC35-G/BC28/BC95 R2.0 系列的开机 URC 如下，收到 OK 表示模块开机成功： 上海移远通信技术股份有限公司 8 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 2.5. 串口波特率容限 BC28-F/BC95-GF 容错范围相对 BC35-G/BC28/BC95 R2.0 系列模块的更大，具体差异见下表： 表 3：BC28-F/BC95-GF 模块不同温度下波特率接收容限（Error）参考数据表 波特率 26 °C Min (bps) 4800 4557 Max (bps) 5040 Error (%) N (-) P (+) -40 °C Min (bps) -5.06 +5.00 4557 Max (bps) 5040 Error (%) N (-) P (+) 85 °C Min (bps) -5.06 +5.00 4557 Max (bps) 5040 Error (%) N (-) P (+) -5.06 +5.00 9600 9108 10081 -5.13 +5.01 9108 10081 -5.13 +5.01 9108 10081 -5.13 +5.01 57600 54591 60547 -5.22 +5.12 54591 60547 -5.22 +5.12 54591 60547 -5.22 +5.12 115200 109400 121285 -5.03 +5.28 109400 121285 -5.03 +5.28 109400 121285 -5.03 +5.28 表 4：BC28-F/BC95-GF 模块不同电压下波特率接收容限（Error）参考数据表 2.2 V 波特率 Min Max Error (%) (bps) (bps) N (-) P (+) 3.0 V Min (bps) Max (bps) Error (%) N (-) P (+) 3.6 V 3.8 V Min (bps) Max (bps) Error (%) N (-) P (+) Min (bps) Max (bps) Error (%) N (-) P (+) 4800 4557 5040 -5.06 +5.00 4557 5040 -5.06 +5.00 4557 5040 -5.06 +5.00 4557 5040 -5.06 +5.00 9600 9108 10081 -5.13 +5.01 9108 10081 -5.13 +5.01 9108 10081 -5.13 +5.01 9108 10081 -5.13 +5.01 38400 36370 40326 -5.29 +5.02 36371 40326 -5.28 +5.02 36370 40326 -5.29 +5.02 36371 40326 -5.28 +5.02 57600 54591 60547 -5.22 +5.12 54591 60547 -5.22 +5.12 54591 60547 -5.22 +5.12 54591 60547 -5.22 +5.12 115200 109400 121285 -5.03 +5.28 109400 121285 -5.03 +5.28 109400 121285 -5.03 +5.28 109400 121285 -5.03 +5.28 表 5：BC35-G/BC28/BC95 R2.0 系列模块主串口波特率接收容限（Error）参考数据表 波特率 9600 同步模式 0 停止位 1 2 Error (%) N (-) P (+) -3.85 % 0.10 % -3.85 % 2.08 % 1 1 -3.85 % 0.10 % 上海移远通信技术股份有限公司 9 / 26 4800 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 2 -3.85 % 0.94 % 1 -0.73 % 2.81 % 2 2 -0.73 % 4.79 % 1 -0.31 % 2.81 % 3 2 -0.31 % 5.31 % 1 -3.75 % 2.71 % 0 2 -3.75 % 3.33 % 1 -4.17 % 1.46 % 1 2 -3.75 % 3.33 % 1 -3.75 % 2.71 % 2 2 -3.75 % 4.79 % 上海移远通信技术股份有限公司 10 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 3 常用 AT 命令 常用 AT 命令一般根据功能被分为 3 个类别：一般命令、网络相关命令和网络配置相关命令。 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块的 AT 命令基本相同，本章节列举了主要的差异 内容。 3.1. 一般命令差异 一般命令主要包含模块信息查询，模块开关机，异常事件上报等基础命令。如下章节列举客户实际项 目开发中常用的 AT 命令，以及 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块间存在的差异。 3.1.1. 查询制造商版本号命令 表 6：查询制造商版本号命令差异 BC35-G/BC28/BC95 R2.0 系列 BC28-F/BC95-GF 执行命令 AT+CGMR 响应（以基线版本 V150R100C20B500SP3 为例） SSB,V150R100C10B200SP1 执行命令 AT+CGMR SECURITY_A,V150R100C20B500SP3 PROTOCOL_A,V150R100C20B500SP3 APPLICATION_A,V150R100C20B500SP3 SECURITY_B,V150R100C20B500SP3 响应（以固件版本为 BC95GFFAR01A03 为例） Revision:BC95GFFAR01A03 OK RADIO,Hi2115_RF6 OK 差异： 命令响应信息不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 上海移远通信技术股份有限公司 11 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 该命令返回模块各个核的基线版本号。 ⚫ BC28-F/BC95-GF 该命令返回模块固件版本号。 3.1.2. 查询可用命令 表 7：查询可用命令的命令差异 BC35-G/BC28/BC95 R2.0 系列 执行命令 AT+CLAC 响应 [] BC28-F/BC95-GF 无 […] OK 差异： BC35-G/BC28/BC95 R2.0 系列模块可使用 AT+CLAC 列出可用命令；BC28-F/BC95-GF 模 块无此命令。 3.1.3. 重启命令 表 8：重启命令差异 BC35-G/BC28/BC95 R2.0 系列 执行命令 AT+NRB 响应 REBOOTING i 绵! Boot: Unsigned Security B.. Verified Protocol A.. Verified Apps A...... Verified REBOOT_CAUSE_APPLICATION_AT Neul BC28-F/BC95-GF 执行命令 AT+NRB 响应 REBOOTING ? REBOOT_CAUSE_APPLICATION_AT OK 上海移远通信技术股份有限公司 12 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 OK 差异： BC35-G/BC28/BC95 R2.0 系列模块和 BC28-F/BC95-GF 均以返回 OK 表示重启完成，但返 回 OK 前响应的信息不同，具体差异如上表所示。 3.1.4. 配置主串口波特率命令 表 9：配置波特率命令差异 BC35-G/BC28/BC95 R2.0 系列 BC28-F/BC95-GF 设置命令 AT+NATSPEED=,,,[,[,[,]]] 设置命令 1 AT+NATSPEED=,,,< sync_mode>[,[,[,]]] 设置命令 2 AT+IPR= 差异： 命令执行条件以及支持的命令不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 支持通过 AT+NATSPEED 配置波特率并配置其他参数。当配置波特率大于 57600 bps 后，模块上报+NATSPEED:DISABLE_DEEP_SLEEP，且不再进入休眠。 ⚫ BC28-F/BC95-GF 支持通过 AT+NATSPEED 配置波特率并配置其他参数，但其他参数配置不生效。如需配 置波特率大于 9600 bps，需确认 AT+QCFG='slplocktimes'没有配置为 0，否则模块进 入深休眠将不再响应 AT 命令。BC28-F/BC95-GF 模块同时还支持通过 AT+IPR 配置波 特率。 3.1.5. 设置调试日志级别 表 10：设置调试日志级别指令差异 BC35-G/BC28/BC95 R2.0 系列 查询命令 AT+NLOGLEVEL? 响应 +NLOGLEVEL:SECURITY,NORMAL +NLOGLEVEL:PROTOCOL,NORMAL BC28-F/BC95-GF 查询命令 AT+NLOGLEVEL? 响应 +NLOGLEVEL:APPLICATION,VERBOSE OK 上海移远通信技术股份有限公司 13 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 +NLOGLEVEL:APPLICATION,NORMAL OK 测试命令 AT+NLOGLEVEL=? 响应 +NLOGLEVEL:(PROTOCOL,APPLICATION,SECURI TY),(VERBOSE,NORMAL,WARNING,ERROR,NONE) 测试命令 AT+NLOGLEVEL=? 响应 +NLOGLEVEL:(APPLICATION),(VERBOSE, NORMAL,WARNING,ERROR,NONE) OK OK 差异： 支持查询的核以及默认的日志级别不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 该命令查询 SECURITY、PROTOCOL 和 APPLICATION 的日志等级，且默认日志级别 为 NORMAL。 ⚫ BC28-F/BC95-GF 该命令查询 APPLICATION 的日志等级，且默认日志级别为 VERBOSE。 3.1.6. 扩展配置命令 表 11：扩展配置命令差异 BC35-G/BC28/BC95 R2.0 系列 设置命令 AT+QCFG='LWM2M/EndpointName' 响应 +QCFG: 'LWM2M/EndpointName','' OK 设置命令 AT+QCFG='LWM2M/BindingMode' 响应 +QCFG: 'LWM2M/BindingMode',1 BC28-F/BC95-GF 无 OK 差异： BC35-G/BC28/BC95 R2.0 系列模块支持通过 AT+QCFG='LWM2M/EndpointName'配置接 入 IoT 平台时的端点名称以及 AT+QCFG='LWM2M/BindingMode'配置接入 IoT 平台时的绑 定模式；而 BC28-F/BC95-GF 无此命令 上海移远通信技术股份有限公司 14 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 3.1.7. 查询 DNS 服务器地址命令 表 12：查询 DNS 服务器地址 AT 命令差异 BC35-G/BC28/BC95 R2.0 系列 查询命令 AT+QIDNSCFG? 响应 PrimaryDns: SecondaryDns: BC28-F/BC95-GF 查询命令 AT+QIDNSCFG? 响应 PrimaryDns: SecondaryDns: OK OK 差异： 不同配置条件下的查询命令返回结果不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 该命令根据配置的 IP 类型显示 DNS 服务器地址，默认显示 IPv4 + IPv6 的 DNS 服务器 地址。 ⚫ BC28-F/BC95-GF 该命令根据实际注网的 IP 类型显示 IPv4/IPv6/IPv4v6 的 DNS 服务器。 3.2. 网络相关命令 网络相关的常见命令，如查询小区信息、IP 和注册网络状态等，基本为 3GPP 命令，故格式和功能基 本相同。如下列举了需要特别注意的 AT 命令差异。 3.2.1. 读取 SIM 卡 ICCID 命令 表 13：读取 SIM 卡 ICCID 号命令差异 BC35-G/BC28/BC95 R2.0 系列 执行命令 AT+NCCID 响应 AT+NCCID? +NCCID:898607b8121730044692 OK BC28-F/BC95-GF 执行命令 AT+NCCID 响应 AT+NCCID? +NCCID:898607B8121730044692 OK 上海移远通信技术股份有限公司 15 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 差异： 查询结果字母显示不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 返回的 ICCID 中字母为小写。 ⚫ BC28-F/BC95-GF 返回的 ICCID 中字母为大写。 3.2.2. 选择运营商命令 命令执行条件不同：对于 BC35-G/BC28/BC95 R2.0 系列，该命令不可在 RRC 连接状态下执行；对于 BC28-F/BC95-GF，该命令可在 RRC 连接状态下执行，但执行后会打断正在进行的业务。 3.2.3. 查询信号信息命令 表 14：查询信号信息命令差异 BC35-G/BC28/BC95 R2.0 系列 执行命令 AT+CSQ 响应 +CSQ:24,99 BC28-F/BC95-GF 执行命令 AT+CSQ 响应 +CSQ:20,0 OK OK 差异： 命令返回结果不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 该命令仅返回接收到的信号强度，不支持信道误码率并始终返回 99。 ⚫ BC28-F/BC95-GF 该命令返回接收到的信号强度以及信道误码率。仅当信道误码率无有效值时返回 99。 3.2.4. 上报 IP 地址命令 表 15：上报 IP 地址命令差异 BC35-G/BC28/BC95 R2.0 系列 BC28-F/BC95-GF 设置命令 AT+NIPINFO= 设置命令 AT+NIPINFO= 举例（以开启 IP 上报、使用双栈卡、IP 地址类型 举例（以开启 IP 上报、使用双栈卡、IP 地址类型为 上海移远通信技术股份有限公司 16 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 为 IPv4v6 为例） +NIPINFO:0,'IPv4v6',10.215.255.208 IPv4v6 为例） +NIPINFO:0,'IPv4v6',10.55.96.182 +NIPINFO:0,'IPv4v6',10.215.255.208 +NIPINFO:0,'IPv4v6',240E:0878:300:206D:1:2:F9 1F:76ED 差异： 开启 IP 地址上报后，上报的 URC 内容不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 开启 IP 地址上报后，使用双栈卡且 IP 地址类型配置为 IPv4v6 时，上报两次 IPv4 地址。 ⚫ BC28-F/BC95-GF 开启 IP 地址上报后，使用双栈卡且 IP 地址类型配置为 IPv4v6 时，上报一次 IPv4 地址 和一次 IPv6 地址。 3.2.5. 配置支持的频段命令 表 16：配置支持的频段命令差异 BC35-G/BC28/BC95 R2.0 系列 测试命令 AT+NBAND=? 响应 +NBAND:(1,3,5,8,20,28) BC28-F/BC95-GF 测试命令 AT+NBAND=? 响应 +NBAND:(3,5,8) OK OK 差异： 支持的频段范围不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 支持频段为：band 1、band 3、band 5、band 8、band 20 和 band 28。（可联系移远 通信技术支持获取具体型号模块支持的频段信息） ⚫ BC28-F/BC95-GF 支持频段为：band 3、band 5 和 band 8。 上海移远通信技术股份有限公司 17 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 3.2.6. 设置 UE 行为命令 表 17：配置 UE 行为命令差异 BC35-G/BC28/BC95 R2.0 系列 BC28-F/BC95-GF 查询命令 AT+NCONFIG? 响应 +NCONFIG:AUTOCONNECT,TRUE +NCONFIG:CR_0354_0338_SCRAMBLING,TR UE +NCONFIG:CR_0859_SI_AVOID,TRUE +NCONFIG:COMBINE_ATTACH,FALSE +NCONFIG:CELL_RESELECTION,TRUE +NCONFIG:ENABLE_BIP,FALSE +NCONFIG:MULTITONE,TRUE +NCONFIG:NAS_SIM_POWER_SAVING_ENA BLE,TRUE +NCONFIG:BARRING_RELEASE_DELAY,64 +NCONFIG:RELEASE_VERSION,13 +NCONFIG:RPM,FALSE +NCONFIG:SYNC_TIME_PERIOD,0 +NCONFIG:IPV6_GET_PREFIX_TIME,15 +NCONFIG:NB_CATEGORY,1 +NCONFIG:RAI,FALSE +NCONFIG:HEAD_COMPRESS,FALSE +NCONFIG:RLF_UPDATE,FALSE +NCONFIG:CONNECTION_REESTABLISHME NT,FALSE +NCONFIG:PCO_IE_TYPE,EPCO OK 查询命令 AT+NCONFIG? 响应 +NCONFIG:AUTOCONNECT,TRUE +NCONFIG:CELL_RESELECTION,TRUE +NCONFIG:ENABLE_BIP,TRUE +NCONFIG:MULTITONE,TRUE +NCONFIG:NAS_SIM_POWER_SAVING_ENABL E,TRUE +NCONFIG:RELEASE_VERSION,13 +NCONFIG:IPV6_GET_PREFIX_TIME,15 +NCONFIG:NB_CATEGORY,1 +NCONFIG:RAI,FALSE +NCONFIG:HEAD_COMPRESS,TRUE +NCONFIG:CONNECTION_REESTABLISHMENT, TRUE +NCONFIG:TWO_HARQ,TRUE +NCONFIG:PCO_IE_TYPE,EPCO +NCONFIG:T3324_T3412_EXT_CHANGE_REPO RT,FALSE +NCONFIG:NON_IP_NO_SMS_ENABLE,FALSE +NCONFIG:SUPPORT_SMS,TRUE +NCONFIG:HPPLMN_SEARCH_ENABLE,TRUE OK 差异： 支持配置的 UE 功能项不同。BC28-F/BC95-GF 模块不支持配置如下 UE 功能项： COMBINE_ATTACH、BARRING_RELEASE_DELAY、RPM、SYNC_TIME_PERIOD、 RLF_UPDATE、SUPPORT_SMS、NON_IP_NO_SMS_ENABLE、 HPPLMN_SEARCH_ENABLE 上海移远通信技术股份有限公司 18 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 3.2.7. 定义 PDP 上下文鉴权参数命令 表 18：定义 PDP 上下文鉴权参数命令差异 BC35-G/BC28/BC95 R2.0 系列 测试命令 AT+CGAUTH=? 响应 +CGAUTH:(0-10),(0,1,2),(0-60),(0-60) OK BC28-F/BC95-GF 测试命令 AT+CGAUTH=? 响应 +CGAUTH:(0-10),(0,1),(0-20),(0-20) OK 差异： 支持的鉴权协议以及用户名密码最大长度不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 该命令支持的鉴权协议配置包括：不配置、PAP、CHAP。配置鉴权协议为 PAP 或 CHAP 时，用户名和密码最大长度为 60 字节。 ⚫ BC28-F/BC95-GF 该命令支持的鉴权协议配置包括：不配置、PAP。配置鉴权协议为 PAP 时，用户名和密 码最大长度为 20 字节。 3.2.8. 定义 PDP 上下文参数命令 BC35-G/BC28/BC95 R2.0 系 列 和 BC28-F/BC95-GF 模 块 定 义 PDP 上 下 文 参 数 命 令 同 为 AT+CGDCONT，但不同时机可配置的 （上下文 ID）不同： ⚫ BC35-G/BC28/BC95 R2.0 系列 允许未注册之前配置 为 0 或非 0 的 PDN 连接。 ⚫ BC28-F/BC95-GF 允许未注册之前配置 为 0 的 PDN 连接，但不允许配置非 0 的 PDN 连接。 上海移远通信技术股份有限公司 19 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 4 中国电信物联网平台 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块对接中国电信物联网平台使用的 AT 命令基 本相同，存在的部分差异是针对 BC35-G/BC28/BC95 R2.0 系列模块某些 AT 命令和机制优化的结果，不影 响 该 命 令 集 的 主 体 功 能 。 详 情 请 参 考 《 Quectel_BC28-F&BC95-GF_AT 命 令 手 册 》 和 《Quectel_BC35-G&BC28&BC95 R2.0 系列_AT 命令手册》。 4.1. 中国电信物联网平台相关 AT 命令差异 4.1.1. 发送 CON 消息命令 表 19：发送 CON 消息命令差异 BC35-G/BC28/BC95 R2.0 系列 设置命令 AT+QLWULDATAEX=,,[,] 响应（设置 CON 消息模式） OK （最大间隔 165 秒） +QLWULDATASTATUS:3 BC28-F/BC95-GF 设置命令 AT+QLWULDATAEX=,,[,< seq_num>] 响应（设置 CON 消息模式） OK （最大间隔 124 秒） +QLWULDATASTATUS:3 差异： 结果码上报最大间隔时间不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 发送 CON 消息后接收发送结果最大间隔时间为 165 秒。 ⚫ BC28-F/BC95-GF 发送 CON 消息后接收发送结果最大间隔时间为 124 秒。 上海移远通信技术股份有限公司 20 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 4.1.2. 触发注册命令 表 20：触发注册命令差异 BC35-G/BC28/BC95 R2.0 系列 设置命令 AT+QLWSREGIND=0 响应 OK （最大间隔 165 秒） +QLWEVTIND:0 BC28-F/BC95-GF 设置命令 AT+QLWSREGIND=0 响应 OK （最大间隔 124 秒） +QLWEVTIND:0 差异： 结果码上报最大间隔时间不同。 ⚫ BC35-G/BC28/BC95 R2.0 系列 该命令触发注册后，结果码上报最大间隔时间为 165 秒。 ⚫ BC28-F/BC95-GF 该命令触发注册后，结果码上报最大间隔时间为 124 秒。 4.2. Lifetime 更新失败处理机制 模块成功注册到中国电信物联网平台后，若 Lifetime 即将超时，模块会主动向平台更新 Lifetime。若 Lifetime 更新失败，BC28-F/BC95-GF 模块不再重新尝试更新和主动重新注册，此时需重新完成注册过程； BC35-G/BC28/BC95 R2.0 系列模块会主动尝试更新和主动重新注册。 4.3. URC 差异 表 21：缓存数据已满时上报 URC 的差异 BC35-G/BC28/BC95 R2.0 系列 URC 上报 +NNMI BC28-F/BC95-GF URC 上报 +NNMI:'recv',buff full 差异： 当设置 AT+NNMI=2 且模块处于缓存模式时，若中国电信物联网平台下发数据条数大于 8 条 或 者 下 发 总 字 节 数 大 于 2048 字 节 时 （ 缓 存 池 已 满 ） ， BC28-F/BC95-GF 模 块 上 报 +NNMI:'recv',buff full，而 BC35-G/BC28/BC95 R2.0 系列模块上报+NNMI。 上海移远通信技术股份有限公司 21 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 5 OneNET 平台 BC35-G/BC28/BC95 R2.0 系列和 BC28-F/BC95-GF 模块对接 OneNET 平台使用的 AT 命令和对接流 程 基 本 相 同 ， 部 分 差 异 为 BG95-GF 模 块 暂 不 支 持 某 些 功 能 。 详 情 请 参 考 《 Quectel_ BC28-F&BC95-GF_OneNET_应用指导》和《Quectel_BC35-G&BC28&BC95 R2.0_OneNET_应用指导》。 5.1. OneNET 平台相关 AT 命令差异 表 22：配置加密连接命令差异 BC35-G/BC28/BC95 R2.0 系列 设置命令 AT+MIPLCONFIG=5,, BC28-F/BC95-GF 无 差异： BC35-G/BC28/BC95 R2.0 系列模块支持以加密方式对接 OneNET 平台；而 BC28-F/BC95-GF 模块不支持加密连接。 5.2. 数据缓存机制 当缓存中存在未读取的数据时，BC35-G/BC28/BC95 R2.0 系列模块可直接进入深休眠状态；而 BC28-F/BC95-GF 模块无法直接进入深休眠状态，需通过执行 AT+MIPLRD 读取全部数据后方可进入深休 眠状态。 上海移远通信技术股份有限公司 22 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 6 其他处理机制差异 6.1. 搜网机制 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系 列 模 块 搜 网 机 制 的 处 理 逻 辑 不 同 。 关 于 BC28-F/BC95-GF 模 块 和 BC35-G/BC28/BC95 R2.0 系 列 模 块 的 搜 网 机 制 ， 详 情 请 参 考 《Quectel_BC28-F&BC95-GF_搜网机制说明》和《Quectel_BC35-G&BC28&BC95 R2.0_搜网机制说明》。 6.2. 多路 PDN 处理机制 同时激活多路 PDN 连接后，BC28-F/BC95-GF 模块无法再进入深休眠，此时功耗会比较高； BC35-G/BC28/BC95 R2.0 系列模块无此限制。 6.3. TX/RX 时间统计清零机制 BC28-F/BC95-GF 模块会在进入深休眠或重启后清零 TX/RX 时间统计信息；BC35-G/BC28/BC95 R2.0 系列模块会在进入 OOS 状态后清零 TX/RX 时间统计信息。 6.4. 网络去附着时 URC 上报顺序 BC28-F/BC95-GF 和 BC35-G/BC28/BC95 R2.0 系列模块的 URC +CSCON 和 +CEREG 上报顺序存 在差异。BC28-F/BC95-GF 在网络去附着过程中优先上报 +CSCON（信令连接状态），去附着完成后上报 +CEREG（网络注册状态）。BC35-G/BC28/BC95 R2.0 系列模块优先上报 +CEREG，后续上报 +CSCON。 上海移远通信技术股份有限公司 23 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 6.5. OOS 状态处理机制 OOS 状 态 下 模 块 的 处 理 机 制 差 异 较 大 。 关 于 BC28-F/BC95-GF 模 块 ， 请 参 考 《Quectel_BC28-F&BC95-GF_搜网机制说明》；关于 BC35-G/BC28/BC95 R2.0 系列模块，请参考 《Quectel_BC35-G&BC28&BC95 R2.0_搜网机制说明》。 6.6. SIM 卡检卡机制 ⚫ 检测周期 BC28-F/BC95-GF 模块的检测周期为 28 秒；BC35-G/BC28/BC95 R2.0 系列模块的检测周期为 30 秒。两个模块均不支持热插拔功能，若拔出 SIM 卡，仅可在检测 SIM 卡时方可确定 SIM 已拔 出，因此拔卡后至检测前，模块默认 SIM 卡一直存在。 ⚫ 退出 PSM 模式时触发机制 BC28-F/BC95-GF 模块退出 PSM 模式时不会触发检测 SIM 卡；而 BC35-G/BC28/BC95 R2.0 系 列模块退出 PSM 模式时触发检测 SIM 卡。 ⚫ Idle 模式下检测逻辑 模块处于 Idle 模式时，BC28-F/BC95-GF 模块检测不到 SIM 卡时会尝试恢复，若恢复失败则确定 为 SIM 卡掉卡；而对于 BC35-G/BC28/BC95 R2.0 系列模块，若连续 2 次检测不到 SIM 卡时，则 确定为 SIM 卡掉卡。 上海移远通信技术股份有限公司 24 / 26 BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 7 附录 A 参考文档及术语缩写 表 23：参考文档 序号 文档名称 备注 [1] Quectel_BC28-F&BC95-GF_AT 命令手册 移远通信 BC28-F 和 BC95-GF 模块的 AT 命 令手册 Quectel_BC35-G&BC28&BC95 R2.0 系列_AT 命令 移远通信 BC35-G、BC28 和 BC95 R2.0 系 [2] 手册 列模块的 AT 命令手册 [3] Quectel_BC28-F&BC95-GF_搜网机制说明 移远通信 BC28-F 和 BC95-GF 模块搜网机 制说明 [4] Quectel_BC35-G&BC28&BC95 R2.0_搜网机制说 明 移远通信 BC95 R2.0 模块搜网机制说明 [5] Quectel_BC95-GF&BC35-G&BC95 R2.0 系列_硬 件差异说明 移远通信 BC95-GF 和 BC95 R2.0 硬件差异 [6] Quectel_BC28-F&BC95-GF_OneNET_应用指导 移 远 通 信 BC28-F 和 BC95-GF 模 块 OneNET 应用指导 Quectel_BC35-G&BC28&BC95 R2.0_OneNET_应 移远通信 BC95 R2.0 模块 OneNET 应用指 [7] 用指导 导 Quectel_BC95-GF&BC95 R2.0 系列_兼容参考设计 移远通信 BC95-GF 模块和 BC95 R2.0 模 [8] 手册 块的硬件兼容设计手册 [9] Quectel_BC28-F&BC28_兼容参考设计手册 移远通信 BC28-F 模块和 BC28 模块的硬件 兼容设计手册 表 24：术语缩写 缩写 3GPP APN CHAP CON DNS 英文全称 3rd Generation Partnership Project Access Point Name Challenge-Handshake Authentication Protocol Confirmable Domain Name Server 中文全称 第三代合作伙伴计划 接入点名称 挑战握手认证协议 需要被确认的消息 域名系统（服务）协议 上海移远通信技术股份有限公司 25 / 26 eDRX ICCID ID IPv4 IPv6 IPv4v6 MCU NB-IoT OOS PAP PCB PDN PDP PSM RTC SIM TAU UE URC BC28-F&BC95-GF&BC35-G&BC28&BC95 R2.0 系列_软件差异说明 Extended Discontinuous Reception Integrated Circuit Card Identifier Identifier Internet Protocol version 4 Internet Protocol version 6 IPv4 and IPv6 Microprogrammed Control Unit Narrow Band Internet of Thing Out of Service Password Authentication Protocol Printed Circuit Board Public Data Network Packet Data Protocol Power Saving Mode Real Time Clock Subscriber Identity Module Tracking Area Update User Equipment Unsolicited Result Code 扩展不连续接收 集成电路卡识别码 标识符 网际协议版本 4 网际协议版本 6 网际协议版本 4 和网际协议版本 6 微程序控制器 窄带物联网（技术） 无服务 口令验证协议 印刷电路板 共用数据网络 分组数据协议 省电模式 实时时钟 用户身份识别模块 跟踪区更新 用户设备 非请求结果码 上海移远通信技术股份有限公司 26 / 26

EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 LTE Standard 模块系列 版本：1.1 日期：2023-05-16 状态：受控文件 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2021-01-26 2021-05-31 2023-05-16 作者 变更表述 Ramos ZHANG/ Carlton XU Ramos ZHANG/ Carlton XU Damon LI/ Ramos ZHANG/ Carlton XU 文档创建 受控版本 1. 更新适用模块： ⚫ 新增适用模块 EC20-CN、EG21-GL 和 EG25-GL； ⚫ 更新 EC20 R2.1 为 EC20-CE。 2. 更新 DFOTA 升级时注意事项的备注（第 4.2 章）。 上海移远通信技术股份有限公司 3 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 DFOTA 升级流程 .................................................................................................................................. 7 2.1. 获取差分包 ................................................................................................................................. 8 2.2. 存储差分包至 FTP/HTTP(S)服务器............................................................................................ 8 2.3. 执行 AT 命令升级固件 ................................................................................................................ 8 3 DFOTA AT 命令详解 ............................................................................................................................ 9 3.1. AT 命令说明................................................................................................................................ 9 3.1.1. 定义 ................................................................................................................................. 9 3.1.2. AT 命令语句 .................................................................................................................... 9 3.1.3. AT 示例声明................................................................................................................... 10 3.2. AT 命令详解.............................................................................................................................. 10 3.2.1. AT+QFOTADL 启动 DFOTA 固件升级........................................................................ 10 3.2.1.1. AT+QFOTADL= 通过 FTP 服务器进行 DFOTA 固件升级 ................ 10 3.2.1.2. AT+QFOTADL= 通过 HTTP(S)服务器进行 DFOTA 固件升级 ....... 12 3.2.1.3. AT+QFOTADL= 通过本地文件系统进行 DFOTA 固件升级 ......... 13 4 异常情况处理及注意事项 .................................................................................................................... 15 4.1. 异常情况处理............................................................................................................................ 15 4.1.1. 差分包错误 .................................................................................................................... 15 4.1.2. 固件升级错误................................................................................................................. 15 4.2. 注意事项 ................................................................................................................................... 16 5 错误码汇总 .......................................................................................................................................... 17 6 附录 参考文档及术语缩写 .................................................................................................................. 18 上海移远通信技术股份有限公司 4 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：AT 命令及响应类型............................................................................................................................. 9 表 3：错误码描述 ....................................................................................................................................... 17 表 4：参考文档 ........................................................................................................................................... 18 表 5：术语缩写 ........................................................................................................................................... 18 上海移远通信技术股份有限公司 5 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 1 引言 移远通信 LTE Standard EC2x、EG2x、EG9x 和 EM05 系列模块支持固件空中差分升级（DFOTA）功 能，此功能可以实现模块差分包的无线升级或降级。 升级前，用户需准备差分包，差分包仅包含当前固件版本和目标固件版本之间的差异，因此可以降低 数据传输量、缩短传输时间。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG2x EG9x EM05 模块 EC20-CE EC20-CN EC21 系列 EC25 系列 EG21-G EG25-G EG21-GL EG25-GL EG91 系列 EG95 系列 EM05 系列 上海移远通信技术股份有限公司 6 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 2 DFOTA 升级流程 2. 将差分包放到FTP/HTTP (S)服务器 FTP/HTTP(S) 服务 器 1. 获取差分包 LT E/W CD MA/ GSM/GPRS (FTP/HTTP(S)) 4. 通过 LT E/W CD MA/GSM /GPR S网 络从 FTP/H TTP(S)服务 器自动 下载 差分包 外部 MCU 3. 执行AT+QFOTADL命令 移远 通信 模块 5.自动升级模块固件 图 1：DFOTA 升级流程 如上图所示，当差分包存储在 FTP/HTTP(S)服务器时需通过如下步骤进行固件升级： 第一步：从移远通信获取差分包； 第二步：将差分包存储到 FTP/HTTP(S)服务器； 第三步：执行 AT+QFOTADL 命令； 第四步：模块将通过 LTE/WCDMA/GSM/GPRS 网络从 FTP/HTTP(S)服务器自动下载差分包； 第五步：自动升级固件。 上海移远通信技术股份有限公司 7 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 2.1. 获取差分包 升级之前，用户需先通过 ATI 或 AT+CVERSION 命令获取原固件版本，同时需明确目标固件版本；之 后将原版本和目标版本信息发送给移远通信或模块供应商以获取相应的差分包。 2.2. 存储差分包至 FTP/HTTP(S)服务器 第一步：用户需自建 FTP/HTTP(S)服务器以便 DFOTA 功能的使用。 第二步：完成服务器建立之后，需将差分包存储至服务器并记录下路径。 2.3. 执行 AT 命令升级固件 差分包存放至 FTP/HTTP(S)服务器后，执行 AT+QFOTADL，随后模块将从 FTP/HTTP(S)服务器下载 差分包并自动升级固件。更多详细信息，请参考第 3 章。 上海移远通信技术股份有限公司 8 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 3 DFOTA AT 命令详解 AT+QFOTADL 命令用于使能模块通过 DFOTA 自动进行固件升级。执行此命令后，模块将自动从 FTP/HTTP(S)服务器下载差分包；差分包下载完成之后，模块会内部检查差分包版本是否正确，若差分包 版本正确，模块将自动重启，然后进入 recovery 模式并自动升级固件。固件成功升级后，模块将重新启动 并进入正常模式。 3.1. AT 命令说明 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 9 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 3.1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 3.2. AT 命令详解 3.2.1. AT+QFOTADL 启动 DFOTA 固件升级 AT+QFOTADL 启动 DFOTA 固件升级 测试命令 AT+QFOTADL=? 响应 OK 最大响应时间 / 特性说明 / 3.2.1.1. AT+QFOTADL= 通过 FTP 服务器进行 DFOTA 固件升级 当差分包存储在 FTP 服务器时，执行 AT+QFOTADL=使能模块通过 DFOTA 自动进行固件 升级。命令执行成功后，模块将自动从 FTP 服务器下载差分包，并自动进行固件升级。 AT+QFOTADL= 通过 FTP 服务器进行 DFOTA 固件升级 设置命令 响应 AT+QFOTADL= OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若出错： ERROR 300 毫秒 该命令立即生效 上海移远通信技术股份有限公司 10 / 18 参数 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 字符串类型。差分包存储至 FTP 服务器上的 URL 地址，以'FTP://'开头，例如： 'FTP://:@:/'。最大长度 为 255 字节。 字符串类型。鉴权用户名。最大长度为 50 字节。 字符串类型。鉴权密码。最大长度为 50 字节。 字符串类型。FTP 服务器域名或 IP 地址。最大长度为 50 字节。 整型。FTP 服务器端口。范围：1~65535；默认值：21。 字符串类型。差分包 FTP 服务器中的路径名。最大长度为 50 字节。 整型。FTP 错误码。0 表示下载成功，详细信息请参考第 5 章。 整型。固件包升级百分比。 0 表示升级成功，其他值表示发生错误，详细信息请参考第 5 章。 举例 //当差分包存储在 FTP 服务器，升级固件。 //FTP 服务器地址为'ftp://test:test@124.74.41.170:21/Jun/update-v12-to-v13.zip'。 //执行 AT+QFOTADL=使能模块通过 DFOTA 自动进行固件升级。命令执行成功后，模块将自动 从 FTP 服务器下载差分包，并自动进行固件升级。 AT+QFOTADL='ftp://test:test@124.74.41.170:21/Jun/update-v12-to-v13.zip' OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND',0 //开始从 FTP 服务器下载差分包。 //差分包下载完成。 //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //开始升级固件。 //固件升级完成。 上海移远通信技术股份有限公司 11 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 3.2.1.2. AT+QFOTADL= 通过 HTTP(S)服务器进行 DFOTA 固件升级 当差分包存储在HTTP(S)服务器时，执行AT+QFOTADL=使能模块通过DFOTA，自动进行 固件升级。命令执行成功后，模块将自动从HTTP(S)服务器下载差分包，并自动进行固件升级。 AT+QFOTADL= 设置命令 AT+QFOTADL= 通过 HTTP(S)服务器进行 DFOTA 固件升级 响应 OK 最大响应时间 特性说明 +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 若出错： ERROR 300 毫秒 该命令立即生效 参数 字符串类型。差分包存储至 HTTP(S)服务器上的 URL 地址，以'http(s)://'开头，例 如：'http://:/'。最大长度为 255 字 节。 字符串类型。HTTP(S)服务器域名或 IP 地址。 整型。HTTP(S)服务器端口。默认值为 80；范围：1~65535。 字符串类型。差分包在 HTTP(S)服务器中的路径名。 整型。HTTP(S)错误码。0 表示下载成功，详细信息请参考第 5 章。 整型。固件包升级百分比。 0 表示升级成功，其他值表示发生错误，详细信息请参考第 5 章。 举例 //当差分包存储在 HTTP(S)服务器，升级固件。 //HTTP 服务器地址为'http://www.quectel.com:100/update.zip'. //执行 AT+QFOTADL=使能模块通过 DFOTA 自动进行固件升级。命令执行成功后，模块将自动 从 HTTP(S) 服务器下载差分包，并自动进行固件升级。 上海移远通信技术股份有限公司 12 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 AT+QFOTADL='http://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND',0 //开始从 HTTP 服务器下载差分包。 //差分包下载完成。 //模块将自动重启，USB 端口将重新初始化。如果当前使用 USB 端口，MCU 将关闭并重启该端口。 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //开始升级固件。 //固件升级完成。 3.2.1.3. AT+QFOTADL= 通过本地文件系统进行 DFOTA 固件升级 若差分包已经存储在本地文件系统中，执行 AT+QFOTADL=使能模块通过 DFOTA 自动 进行固件升级。命令执行成功后，模块将自动从本地系统下载差分包，并自动进行固件升级。 AT+QFOTADL= 通过本地文件系统进行 DFOTA 固件升级 设置命令 AT+QFOTADL= 响应 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 若出错： ERROR 参数 字符串类型。差分包存储至本地文件系统上的路径，以 UFS 中'/data/ufs/'开头。最 大长度为 90 个字节。 整型。固件包升级百分比。 0 表示升级成功，其他值表示发生错误，详细信息请参考第 5 章。 上海移远通信技术股份有限公司 13 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 举例 //差分包已经存储在本地文件系统中，升级固件。 AT+QFOTADL='/data/ufs/update-v13-to-v12.zip' OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //开始升级固件。 //固件升级完成。 上海移远通信技术股份有限公司 14 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 4 异常情况处理及注意事项 4.1. 异常情况处理 4.1.1. 差分包错误 执行 AT+QFOTADL 命令，下载差分包后，模块会自动重启并进入 recovery 模式升级固件。差分包下 载完成后，模块首先会检验差分包版本，若差分包版本不正确，将上报 URC +QIND: 'FOTA','END',， 该 URC 中包含相关错误码（例如，504 或 510）以指明错误原因，之后模块将自动重启进入 recovery 模式 并重新对差分包进行 5 次再校验。若 5 次校验后，差分包仍错误，模块将自动重启并进入正常模式。为解 决这种情况，用户可以查看上传的差分包是否正确，若不正确，将正确的差分包重新上传至 FTP/HTTP(S) 服务器。 4.1.2. 固件升级错误 若 差 分 包 版 本 校 验 无 误 ， 即 开 始 升 级 固 件 。 若 固 件 升 级 失 败 ， 将 上 报 URC +QIND: 'FOTA','END',，该 URC 中包含相关错误码（例如，502、511、520-530 或 540-546）以指明升级 错误原因，之后模块将自动重启进入 recovery 模式并重试 5 次固件升级。若 5 次升级均失败，模块将停止 升级并恢复到原始版本。 备注 升级过程中，差分包下载完成后，若检验或固件升级失败，最多重试 5 次差分包校验和固件升级。 如第 2 章所述，执行 AT+QFOTADL 命令后，完全自动进行 DFOTA 固件升级，因此，可以忽略模块 发送给外部 MCU 的 URC +QIND: 'FOTA','END',。 上海移远通信技术股份有限公司 15 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 4.2. 注意事项 升级注意事项如下： 1. URC +QIND: 'FOTA','START'表示开始固件升级。执行 AT+QFOTADL 命令后，若 MCU 收到 此 URC，固件升级成功且接收到+QIND: 'FOTA','END',0 前，请勿关闭模块。升级成功后，模 块将自动重启并进入正常模式。 2. 升级过程中，在收到上一个 URC 后的 4 分钟内，若外部 MCU 未收到任何 URC，可重启模块。 3. 建议在外部 MCU 设置一个标志用于标记固件升级任务，并在升级成功后将其清除。 备注 建议 DFOTA 升级过程中不要断电。 上海移远通信技术股份有限公司 16 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 5 错误码汇总 本章节描述升级相关错误码、和，详细信息请参考下表。 表 3：错误码描述 值 英文含义 中文含义 0 Successful FTP download operation FTP 下载操作成功 601 FTP unknown error FTP 未知错误 值 英文含义 中文含义 0 Successful HTTP(S) download operation HTTP(S)下载操作成功 701 HTTP(S) unknown error HTTP(S)未知错误 值 英文含义 中文含义 0 502 504 510 511 520~530, 540~546 Successful DFOTA upgrade DFOTA 升级成功 The upgrade process exits for some 因某些不可预测的错误而退出升级程序 unpredictable errors Something wrong with the upgrade 差分包文件错误 package file The patch does not match the source file in 补丁与模块中的源文件不匹配，需要检查 the module, need to check whether the 差分包是否错误。 delta firmware package is wrong. The file system has no enough space for 文件系统空间不足 upgrading Firmware upgrading failed 固件升级失败 上海移远通信技术股份有限公司 17 / 18 EC2x&EG2x&EG9x&EM05 系列 DFOTA 应用指导 6 附录 参考文档及术语缩写 表 4：参考文档 文档名称 [1] Quectel_EC2x&EG2x&EG9x&EM05_Series_AT_Commands_Manual 表 5：术语缩写 缩写 DFOTA FTP GPRS HTTP HTTP(S) LTE MCU UFS URC URL WCDMA 英文全称 Delta Firmware Upgrade Over-The-Air File Transfer Protocol General Packet Radio Service Hypertext Transfer Protocol Hyper Text Transfer Protocol Secure Long-Term Evolution Microcontroller Unit User File System Unsolicited Result Code Uniform Resource Locator Wideband Code Division Multiple Access 中文全称 固件空中差分升级 文件传输协议 通用分组无线业务 超文本传输协议 超文本传输安全协议 长期演进 微控制单元 用户文件系统 非请求结果码 统一资源定位符 宽带码分多址 上海移远通信技术股份有限公司 18 / 18

M26&M35&MC20&MC30 网络指示灯使用说明 GSM/GPRS/GNSS 模块系列 版本：1.0 日期：2021-06-02 状态：受控文件 M26&M35&MC20&MC30 网络指示灯使用说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 10 M26&M35&MC20&MC30 网络指示灯使用说明 文档历史 修订记录 版本 日期 作者 - 2021-02-22 Johnson CHEN 1.0 2021-06-02 Johnson CHEN 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 10 M26&M35&MC20&MC30 网络指示灯使用说明 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 AT 命令详解 .......................................................................................................................................... 6 2.1. AT 命令说明................................................................................................................................ 6 2.1.1. 定义 ................................................................................................................................. 6 2.1.2. AT 命令语句..................................................................................................................... 6 2.2. AT 示例声明................................................................................................................................ 7 2.3. AT 命令详解................................................................................................................................ 7 2.3.1. AT+QLEDMODE 设置网络指示灯工作模式 ................................................................. 7 2.4. 举例 ............................................................................................................................................ 8 3 附录 术语缩写..................................................................................................................................... 10 上海移远通信技术股份有限公司 3 / 10 M26&M35&MC20&MC30 网络指示灯使用说明 表格索引 表 1：AT 命令类型........................................................................................................................................ 6 表 2：AT+QLEDMODE=5 时举例说明......................................................................................................... 8 表 3：术语缩写 ........................................................................................................................................... 10 上海移远通信技术股份有限公司 4 / 10 M26&M35&MC20&MC30 网络指示灯使用说明 1 引言 本文档提供了移远通信 GSM M26、M35、MC20 和 MC30 模块网络指示灯的使用说明。网络指示灯用 于指示模块当前所处的状态，可以通过命令 AT+QLEDMODE 设置网络灯的工作模式。 上海移远通信技术股份有限公司 5 / 10 M26&M35&MC20&MC30 网络指示灯使用说明 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 6 / 10 M26&M35&MC20&MC30 网络指示灯使用说明 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+QLEDMODE 设置网络指示灯工作模式 该命令用于设置网络指示灯的工作模式。 AT+QLEDMODE 设置网络指示灯工作模式 测试命令 AT+QLEDMODE=? 响应 +QLEDMODE: (支持的范围) 查询命令 AT+QLEDMODE? OK 响应 +QLEDMODE: 设置命令 AT+QLEDMODE= 特性说明 OK 响应 OK +CME ERROR: 或者 ERROR 该命令立即生效且自动保存 参数 整型。配置的网络指示灯工作模式。 0 电话呼叫及接入、收发短信、PDP 激活/去激活、TCP 建立连接、PPP 拨号时网络 指示灯超快闪。闪烁频率：亮 25 ms 灭 75 ms。 PPP 拨号成功后或者 TCP 建立连接后有数据交互时指示灯超快闪。闪烁频率： 亮 25 ms 灭 75 ms。 无数据交互时网络指示灯常灭。闪烁状态：不闪烁。 1 模式 1 为默认模式。开机找 GSM 网络时指示灯快闪。闪烁频率：亮 64 ms 灭 800 ms。 找到 GSM 网络后指示灯慢闪。闪烁频率：亮 64 ms 灭 2000 ms。 PDP 激活或 PPP 拨号时指示灯快闪。闪烁频率：亮 64 ms 灭 600 ms。 来电振铃对网络指示灯无影响。闪烁状态：不闪烁。 上海移远通信技术股份有限公司 7 / 10 M26&M35&MC20&MC30 网络指示灯使用说明 2 同模式 1，但是在新短信和来电时模块会拉低 RI。 3 开机后 PDP 激活之前或 PPP 拨号之前网络指示灯慢闪。闪烁频率：亮 64 ms 灭 2000 ms。 PDP 激活后或拨号后常亮。闪烁状态：不闪烁。 4 开机找 GSM 网络或未找到 GSM 网络时指示灯常灭。闪烁状态：不闪烁。 找到 GSM 网络后慢闪。闪烁频率：亮 64 ms 灭 2000 ms。 PDP 激活后无数据传输时指示灯也慢闪。闪烁频率：亮 64 ms 灭 2000 ms。 有数据传输时超快闪。闪烁频率：亮 25 ms 灭 75 ms。 5 开机找 GSM 网络或未找到 GSM 网络时指示灯常亮。闪烁状态：不闪烁。 找到 GSM 网络后慢闪。闪烁频率：亮 64 ms 灭 2000 ms。 6 开机找 GSM 网络或未找到 GSM 网络时指示灯常亮。闪烁状态：不闪烁。 找到 GSM 网络后慢闪。闪烁频率：亮 200 ms 灭 2000 ms。 通话过程中快闪。闪烁频率：亮 200 ms 灭 500 ms。 7 未读到卡网络指示灯常亮。闪烁状态：不闪烁。 读到卡后慢闪。闪烁频率：亮 200 ms 灭 1800 ms。 通话过程中快闪。闪烁频率：亮 200 ms 灭 500 ms。 PDP 激活快闪。闪烁频率：亮 64 ms 灭 600 ms。 PDP 去激活后慢闪。闪烁频率：亮 64 ms 灭 2000 ms。 8 关闭网络灯，网络指示灯为常灭。闪烁状态：不闪烁。 9 开机找 GSM 网络或未找到 GSM 网络时指示灯慢闪。闪烁频率：亮 200 ms 灭 1800 ms。 找到 GSM 网络后指示灯慢闪。闪烁频率：亮 1800 ms 灭 200 ms。 通话过程中指示灯常亮。闪烁状态：不闪烁。 PDP 激活指示灯快闪。闪烁频率：亮 125 ms 灭 125 ms。 错误码。3518 或者错误描述字符'invalid parameter'。 备注 1. 7、8、9 模式只有部分模块型号支持，详细信息请咨询移远通信技术支持。 2. 提供的闪烁频率毫秒数是近似值。 2.4. 举例 以 AT+QLEDMODE=5 时举例说明指示灯工作状态和闪烁频率，如下表所示。 表 2：AT+QLEDMODE=5 时举例说明 状态 找网过程中常亮 注网成功后慢闪 闪烁频率 不闪烁。 亮 64 ms 灭 2000 ms，慢闪。 上海移远通信技术股份有限公司 8 / 10 PDP 激活时及激活后慢闪 PDP 去激活时及去激活后慢闪 TCP 建立连接时慢闪 TCP 发送数据时慢闪 TCP 断开连接后慢闪 电话拨号、接通、挂断时慢闪 电话呼入、接通、挂断时慢闪 M26&M35&MC20&MC30 网络指示灯使用说明 亮 64 ms 灭 2000 ms，慢闪。 亮 64 ms 灭 2000 ms，慢闪。 亮 64 ms 灭 2000 ms，慢闪。 亮 64 ms 灭 2000 ms，慢闪。 亮 64 ms 灭 2000 ms，慢闪。 亮 64 ms 灭 2000 ms，慢闪。 亮 64 ms 灭 2000 ms，慢闪。 上海移远通信技术股份有限公司 9 / 10 M26&M35&MC20&MC30 网络指示灯使用说明 3 附录 术语缩写 表 3：术语缩写 缩写 GSM LED PDP PPP RI TCP 英文全称 Global System for Mobile Communications Light Emitting Diode Packet Data Protocol Point-to-Point Protocol Rank Indication Transmission Control Protocol 中文全称 全球移动通信系统 发光二极管 分组数据协议 点对点协议 通信中用来表示预编码矩阵的秩 传输控制协议 上海移远通信技术股份有限公司 10 / 10

MC20 BLE AT Commands Manual GSM/GPRS/GNSS Module Series Rev. MC20_BLE_AT_Commands_Manual_V1.2 Date: 2018-09-30 Status: Released www.quectel.com GSM/GPRS/GNSS Module Series MC20 BLE 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. MC20_BLE_AT_Commands_Manual 1 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual About the Document History Revision Date Author 1.0 2017-05-17 Miles MA 1.1 2018-01-09 Miles MA 1.2 2018-09-30 Miles MA Description Initial 1. Added AT+QGATSETADV 2. Added AT commands of BLE GATT client 3. Added URC +QBTGATCSCAN:, +QBTGATCCON: and +QBTGATCN: 4. Added BLE operation process (Chapter 2) 5. Deleted AT commands AT+QBTFMPSREG and AT+QBTPXPSREG 1. Added command AT+QGATADVDATA, AT+QGATSCANRSP, AT+QBTGATSENLE and AT+QGATCFGSCAN. (Chapter 3.2.10, 3.2.11, 3.2.15 and 3.3.15) 2. Added URC +QBTGATEWREQ: (Chapter 4.3) 3. Updated the description of command AT+QGATSETADV, AT+QBTGATCCON and AT+QBTGATCSS (Chapter 3.2.9, 3.3.3 and 3.3.4) 4. Updated the examples in Chapter 2.2 and 3.1.5 5. Updated codes of and their meanings in Table 3 MC20_BLE_AT_Commands_Manual 2 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 5 1 Introduction ....................................................................................................................................... 6 2 BLE Operation Process .................................................................................................................... 7 2.1. BLE Advertising .................................................................................................................... 8 2.2. Simplified Process of BLE Communication ........................................................................... 8 2.2.1. BLE Process When Module is as BLE Server ............................................................... 8 2.2.2. BLE Process When Module is as BLE Client............................................................... 10 3 Description of BLE AT Commands................................................................................................ 12 3.1. General BLE AT Commands ............................................................................................... 12 3.1.1. AT+QBTPWR Power ON/OFF BT Device ................................................................. 12 3.1.2. AT+QBTLEADDR Read Local Address of BLE Device ............................................. 13 3.1.3. AT+QBTLETXPWR Set the Level of BLE Transmission Power ................................ 13 3.1.4. AT+QBTNAME Read/Write the Local Name of BT Device ........................................ 14 3.1.5. AT+QBTVISB Set the Current Visibility Mode of BT.................................................. 15 3.2. BLE GATT Server AT Commands ....................................................................................... 16 3.2.1. AT+QBTGATSREG Register/Deregister a GATT Server........................................... 16 3.2.2. AT+QBTGATSS Add/Remove a Service ................................................................... 17 3.2.3. AT+QBTGATSC Add a Characteristic to an Existing Service .................................... 18 3.2.4. AT+QBTGATSD Add a Descriptor to an Existing Service ......................................... 20 3.2.5. AT+QBTGATSST Start/Stop a Service ...................................................................... 21 3.2.6. AT+QBTGATSIND Send an Indication or Notification to a Client .............................. 22 3.2.7. AT+QBTGATSRSP Send a Response to a Client’s Read or Write Operation ........... 23 3.2.8. AT+QBTGATADV Set Advertising Parameters .......................................................... 24 3.2.9. AT+QGATSETADV Set Advertising Data .................................................................. 24 3.2.10. AT+QGATADVDATA Set Advertising Data................................................................. 26 3.2.11. AT+QGATSCANRSP Set Scan Response Data........................................................ 27 3.2.12. AT+QBTGATCPU Update Connection Parameters................................................... 28 3.2.13. AT+QBTGATSDISC Disconnect Server Actively ....................................................... 29 3.2.14. AT+QBTGATSL Start/Stop BLE Advertising .............................................................. 29 3.2.15. AT+QBTGATSENLE Start/Stop BLE Advertising ....................................................... 30 3.3. BLE GATT Client AT Commands ........................................................................................ 31 3.3.1. AT+QBTGATCREG Register/Deregister GATT Client ............................................... 31 3.3.2. AT+QBTGATCSCAN Start/Stop Scanning LE Device ............................................... 32 3.3.3. AT+QBTGATCCON Connect/Disconnect GATT Client to Remote LE Device........... 33 3.3.4. AT+QBTGATCSS Search and Enumerate Peer’s Service ........................................ 34 3.3.5. AT+QBTGATCGC Search and Enumerate Peer’s Characteristic of the Service....... 35 3.3.6. AT+QBTGATCGD Search and Enumerate Peer’s Descriptor of the Service with UUID ...................................................................................................................... 37 MC20_BLE_AT_Commands_Manual 3 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.3.7. AT+QBTGATCRC Read Peer’s Characteristic of the Service with UUID .................. 38 3.3.8. AT+QBTGATCWC Write Peer’s Characteristic of the Service with UUID.................. 39 3.3.9. AT+QBTGATCRD Read Peer’s Descriptor of the Service with UUID........................ 41 3.3.10. AT+QBTGATCWD Write Peer’s Descriptor of the Service with UUID ....................... 42 3.3.11. AT+QBTGATCEW Execute Write Command ............................................................ 44 3.3.12. AT+QBTGATCRN Register/Deregister Notification Request..................................... 44 3.3.13. AT+QBTGATCGDT Get the Type of Peer Device ..................................................... 46 3.3.14. AT+QBTGATCL Start/Stop Listen Request ............................................................... 47 3.3.15. AT+QGATCFGSCAN Set Scan Interval and Scan Window ...................................... 47 4 Description of URCs ....................................................................................................................... 49 4.1. Notify the GATT Connection or Disconnection .................................................................... 49 4.2. Notify the GATT Client’s Write Request .............................................................................. 49 4.3. Notify the GATT Client’s Write Request Execution.............................................................. 50 4.4. Notify the GATT Client’s Read Request .............................................................................. 52 4.5. Report Scanning Result ...................................................................................................... 52 4.6. Notify Client a Connection’s Status ..................................................................................... 53 4.7. Notify Client a Notification or Indication Comes .................................................................. 54 5 Appendix A References .................................................................................................................. 56 MC20_BLE_AT_Commands_Manual 4 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Table Index TABLE 1: TERMS AND ABBREVIATIONS ........................................................................................................ 56 TABLE 2: FORMAT MAP OF PROPERTIES AND PERMISSION .................................................................... 56 TABLE 3: DIFFERENT CODING SCHEMES OF +CME ERROR: ....................................... 57 MC20_BLE_AT_Commands_Manual 5 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 1 Introduction This document presents the BLE AT Commands Set for Quectel MC20 module. It is only applicable to the MC20 module with ordering codes of MC20ECA-04-BLE and MC20ECB-04-BLE. MC20_BLE_AT_Commands_Manual 6 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 2 BLE Operation Process A set of AT commands are provided to support basic BLE operation, including scanning, advertising, connecting and so on. Quectel MC20 module with ordering codes of MC20ECA-04-BLE and MC20ECB-04-BLE support GATT profile which can be used to communicate between module and other BLE devices. The module can act as a peripheral (server) role or central (client) role. The following figure shows the detailed operation of BLE communication by AT commands. Client Server Search and enumerate peer’s service/ characteristic/ descriptor AT+QBTPWR=1 AT+QBTPWR=1 Register a client Register server Add service Add characteristic Add descriptor Start service Advertising AT+QBTVISB=0 AT+QBTGATADV AT+QGATSETADV AT+QBTGATSL Scan and connect AT+QBTGATCSCAN +QBTGATCSCAN: AT+QBTGATCCON AT+QBTGATCPU AT+QBTGATCSS +QBTGATCSS: AT+QBTGATCGC/AT+QBTGATCGD +QBTGATCGC:/+QBTGATCGD: Power on BT Add BLE server Set advertising parameters Read peer’s characteristic/ descriptor AT+QBTGATCRC/AT+QBTGATCRD +QBTGATWREQ: AT+QBTGATSRSP Write peer’s characteristic/ descriptor AT+QBTGATCWC/AT+QBTGATCWD +QBTGATRREQ: AT+QBTGATSRSP AT+QBTGATCRN AT+QBTGATSIND +QBTGATCN: Send indication/notification to client Figure 1: BLE Operation Flow Chat MC20_BLE_AT_Commands_Manual 7 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 2.1. BLE Advertising If the Bluetooth function is turned on, both the classic BT and BLE will be broadcasted. The separate process of BLE broadcasting is as below. AT+QBTPWR=1 OK AT+QBTVISB=0 OK AT+QBTVISB? +QBTVISB: 0 //Power on BT device. //Set BT to be invisible, and stop classic BT and BLE advertising. OK AT+QBTGATSREG=1,'ABC2' +QBTGATSREG: 1,'ABC2',0 //Register a GATT server. OK AT+QBTGATSL='ABC2',1 +QBTGATSL: 'ABC2',0 //Start advertising. OK 2.2. Simplified Process of BLE Communication 2.2.1. BLE Process When Module is as BLE Server AT+QBTPWR=1 OK AT+QBTLEADDR? +QBTLEADDR: DFF596CB3C76 //Power on BT device. OK AT+QBTGATSREG=1,'A001' +QBTGATSREG: 1,'A001' ,0 //Register a GATT server. OK AT+QBTGATSS=1,'A001','1234',15,1,254 +QBTGATSS: 1,'A001','1234',1,0,254,256 //Add a service. OK AT+QBTGATSC=1,'A001',256,'C001',2,16,17 +QBTGATSC: 1,'A001',256,'C001',2,0,258 //Add a characteristic. MC20_BLE_AT_Commands_Manual 8 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual OK AT+QBTGATSD=1,'A001',256,'0229',1,17 +QBTGATSD: 1,'A001',256,'0229',1,0,259 //Add a descriptor. OK //If property 'notify' or 'indicate' of characteristic is added, please add a descriptor with UUID '0229' after it. //If some Android versions are unable to register 'notify', please try to add 'indicate'. AT+QBTGATSC=1,'A001',256,'C002',2,6,17 //Add a characteristic. +QBTGATSC: 1,'A001',256,'C001',2,0,261 OK AT+QBTGATSST=1,'A001',256,0 +QBTGATSST: 1,'A001',0,256 //Start a service. OK +QBTGATSCON: 1,'A001',0,61625C58B558,1 //URC: establish a connection. +QBTGATWREQ: 'A001',1,14,61625C58B558,259,0100,0,0,0 +QBTGATRREQ: 'A001',1,15,61625C58B558,261,0, 0 //URC: receive GATT client’s Read Request. AT+QBTGATSRSP='A001',0,1,15,261,'0000' //Send a response to a client’s read operation. +QBTGATSRSP: 0,'A001',1,261 OK +QBTGATWREQ: 'A001',1,15,61625C58B558,261,2222,0,0,0 //URC: receive GATT client’s Write Request that does not need to response. +QBTGATRREQ: 'A001',1,16,61625C58B558,259,0,0 //URC: receive GATT client’s Read Request. AT+QBTGATSRSP='A001',0,1,16,259,'0100' //Send a response to a client’s read operation. +QBTGATSRSP: 0,'A001',1,259 OK AT+QBTGATSIND='A001',1,258,1,'3333' +QBTGATSIND: 0,'A001',1,2 //Send an indication or notification to a client. OK AT+QBTGATSDISC=1 OK //Disconnect server. MC20_BLE_AT_Commands_Manual 9 / 58 +QBTGATSCON: 0,'A001',0,61625C58B558,1 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 2.2.2. BLE Process When Module is as BLE Client AT+QBTPWR=1 OK AT+QBTGATCREG=1,'B001' +QBTGATCREG: 1,0,'B001' //Power on BT device. //Register a GATT client. OK AT+QBTGATCSCAN=1,'B001' +QBTGATCSCAN: 1,0,'B001' //Start scanning LE device. OK +QBTGATCSCAN: 'B001',763CCB96F5DF,77,02011A05094C593032 AT+QBTGATCSCAN=0,'B001' //Stop scanning LE device. +QBTGATCSCAN: 0,0,'B001' OK AT+QBTGATCCON=1,'B001',763CCB96F5DF,1 OK //Connect GATT client. +QBTGATCCON: 1,0,'B001',763CCB96F5DF,1 AT+QBTGATCSS='B001',1 OK //Establish a connection. //Enumerate peer’s service. +QBTGATCSS: 0,'B001',1,'0018',0,1 +QBTGATCSS: 0,'B001',1,'0118',0,1 +QBTGATCSS: 0,'B001',1,'1234',0,1 AT+QBTGATCGC='B001',1,'1234',0,1 OK //Enumerate peer’s characteristic of the service. +QBTGATCGC: 0,'B001',1,'1234',0,1,'C001',0,16 AT+QBTGATCGC='B001',1,'1234',0,1,'C001',0 OK +QBTGATCGC: 0,'B001',1,'1234',0,1,'C002',0,6 AT+QBTGATCGD='B001',1,'1234',0,1,'C001',0 OK //Search and enumerate peer’s descriptor of the service. MC20_BLE_AT_Commands_Manual 10 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual +QBTGATCGD: 0,'B001',1,'1234',0,1,'C001',0,'0229',0 AT+QBTGATCRN=1,'B001',763CCB96F5DF,'1234',0,1,'C001',0 //Register notification request. +QBTGATCRN: 1,0,'B001',763CCB96F5DF,'1234',0,1,'C001',0 OK AT+QBTGATCWD='B001',1,1,'1234',0,1,'C001',0,'0229',0,'0100',0 //Write peer’s descriptor of the OK service with UUID +QBTGATCWD: 0,'B001',1,'1234',0,1,'C001',0,'0229',0 AT+QBTGATCRC='B001',1,'1234',0,1,'C002',0,0 //Read peer’s characteristic of the service. OK +QBTGATCRC: 0,'B001',1,'1234',0,1,'C002',0,'0000' AT+QBTGATCWC='B001',1,1,'1234',0,1,'C002',0,'2222',0 OK //Write peer’s characteristic. +QBTGATCWC: 0,'B001',1,'1234',0,1,'C002',0 AT+QBTGATCRD='B001',1,'1234',0,1,'C001',0,'0229',0,0 OK +QBTGATCRD: 0,'B001',1,'1234',0,1,'C001',0,'0229',0,'0100' +QBTGATCN: 'B001',1,763CCB96F5DF,'1234',0,1,'C001',0,0,'3333' //Receive a notification from server. AT+QBTGATCCON? +QBTGATCCON: 1, 763CCB96F5DF OK +QBTGATCCON: 0,0,'B001',763CCB96F5DF,1 MC20_BLE_AT_Commands_Manual 11 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3 Description of BLE AT Commands The BT device in this chapter includes classic BT and BLE devices. 3.1. General BLE AT Commands 3.1.1. AT+QBTPWR Power ON/OFF BT Device The command is used to power on/off BT device. AT+QBTPWR Power ON/OFF BT Device Test Command AT+QBTPWR=? Response: +QBTPWR: (list of supported s) Read Command AT+QBTPWR? OK Response: +QBTPWR: Write Command AT+QBTPWR= OK Response: OK If there is any error relating to ME functionality: +CME ERROR: Parameter 0 1 0 1 Off On Power off Power on Example AT+QBTPWR=1 OK //Power on BT device. MC20_BLE_AT_Commands_Manual 12 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.1.2. AT+QBTLEADDR Read Local Address of BLE Device AT+QBTLEADDR Read Local Address of BLE Device Test Command AT+QBTLEADDR=? Read Command AT+QBTLEADDR? Response OK Response +QBTLEADDR: OK If there is any error relating to ME functionality: +CME ERROR: Parameter Local address of BLE device. (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02C3) Example AT+QBTLEADDR? +QBTLEADDR: A662616202C3 OK 3.1.3. AT+QBTLETXPWR Set the Level of BLE Transmission Power AT+ QBTLETXPWR Set the Level of BLE Transmission Power Test Command AT+QBTLETXPWR=? Response +QBTLETXPWR: (list of supported s) Read Command AT+QBTLETXPWR? OK Response +QBTLETXPWR: Write Command AT+QBTLETXPWR= OK Response OK If there is any error relating to ME functionality: +CME ERROR: MC20_BLE_AT_Commands_Manual 13 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Parameter The level of BLE transmission power. The range is 0-7. NOTES 1. This command takes effect after BT function is restarted. 2. The maximum level of BLE transmission power is 7. Example AT+QBTLETXPWR=2 OK AT+QBTLETXPWR? +QBTLETXPWR: 2 OK 3.1.4. AT+QBTNAME Read/Write the Local Name of BT Device AT+QBTNAME Read/Write the Local Name of BT Device Test Command AT+QBTNAME=? Read Command AT+QBTNAME? Response OK Response +QBTNAME: Write Command AT+QBTNAME= OK Response OK If there is any error relating to ME functionality: +CME ERROR: Parameter String type. BT device local name. MC20_BLE_AT_Commands_Manual 14 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual NOTE The max length of the BT device local name is 54 bytes. Example AT+QBTNAME? +QBTNAME: 'MYBTDEVICE' OK 3.1.5. AT+QBTVISB Set the Current Visibility Mode of BT The classic BT and BLE will stop advertising when the BT settings are invisible. AT+QBTVISB Set the Current Visibility Mode of BT Test Command AT+QBTVISB=? Response +QBTVISB: (list of supported s),(list of supported s) Read Command AT+QBTVISB? OK Response +QBTVISB: OK Write Command AT+QBTVISB=[,] If there is any error relating to ME functionality: +CME ERROR: Response OK If there is any error relating to ME functionality: +CME ERROR: If =2, response: OK +QBTVISB: 0 MC20_BLE_AT_Commands_Manual 15 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Parameter 0 Invisible 1 Visible forever 2 Visible temporarily in the time period that Bluetooth can be found by other devices Integer type. Time period that Bluetooth can be found by other devices. The range is 1-255. Unit: second. Example AT+QBTVISB=0 OK //Set the current visibility mode of BT to be invisible. 3.2. BLE GATT Server AT Commands 3.2.1. AT+QBTGATSREG Register/Deregister a GATT Server AT+QBTGATSREG Register/Deregister a GATT Server Test Command AT+QBTGATSREG=? Response: +QBTGATSREG: (list of supported s),'' Read Command AT+QBTGATSREG? OK Response: +QBTGATSREG: '',, … Write Command AT+QBTGATSREG=,' ' OK Response: +QBTGATSREG: ,'', OK If there is any error relating to ME functionality: +CME ERROR: Parameter 0 Deregister 1 Register User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character MC20_BLE_AT_Commands_Manual 16 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual of it should be in set {‘0’~‘9’,‘a’~’f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL 1 Server Handle of the registered GATT server. Example AT+QBTGATSREG=1,'ABC2' +QBTGATSREG: 1,'ABC2',0 OK //Register a GATT server. 3.2.2. AT+QBTGATSS Add/Remove a Service AT+QBTGATSS Add/Remove a Service Test Command AT+QBTGATSS=? Response: +QBTGATSS: (list of supported s),'','', (list of supported s),(list of supported s),(list of supported s) Read Command AT+QBTGATSS? OK Response: +QBTGATSS: '','',,,,, … Write Command Add a service AT+QBTGATSS=1,'','',,, OK Response: +QBTGATSS: 1,'','',,,, OK Write Command Remove a service AT+QBTGATSS=0,'', If there is any error relating to ME functionality: +CME ERROR: Response: +QBTGATSS: 0,'',, OK MC20_BLE_AT_Commands_Manual 17 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual If there is any error relating to ME functionality: +CME ERROR: Parameter 0 Remove 1 Add User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end to be even). UUID of this service. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Number of handles of this service. The range is 1-65535. Service is the primary one or not. 0 Not primary service 1 Primary service Instance ID of this service. The range is 0-255. Handle of this service. The range is 0-65535. 0 SUCCESS 1 FAIL 0 Service is in stop state 1 Service is in start state Example AT+QBTGATSS=1,'ABC2','3418',15,1,254 +QBTGATSS: 1,'ABC2','3418',1,0,254,256 OK AT+QBTGATSS=0,'ABC2',256 +QBTGATSS: 0,'ABC2',0,256 OK //Add a service. //Remove a service. 3.2.3. AT+QBTGATSC Add a Characteristic to an Existing Service AT+QBTGATSC Add a Characteristic to an Existing Service Test Command AT+QBTGATSC=? Response: +QBTGATSC: 1,'',(list of supported MC20_BLE_AT_Commands_Manual 18 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual s),'',(list of supported s),(list of supported s),(list of supported s) Write Command AT+QBTGATSC=1,'',,'',,< prop>, OK Response: +QBTGATSC: 1,'',,'',,, OK If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Handle of this service. The range is 0-65535. UUID of this characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. Properties of this characteristic. For more details, please refer to Table 2. Permission of this characteristic. For more details, please refer to Table 2. Handle of this characteristic. 0 SUCCESS 1 FAIL Example AT+QBTGATSC=1,'ABC2',256,'332a',2,58,17 +QBTGATSC: 1,'ABC2',256,'332A',2,0,260 OK //Add a characteristic. MC20_BLE_AT_Commands_Manual 19 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.2.4. AT+QBTGATSD Add a Descriptor to an Existing Service AT+QBTGATSD Add a Descriptor to an Existing Service Test Command AT+QBTGATSD=? Response +QBTGATSD: 1,'',(list of s),'',(list of s),(list of supported s) supported supported Write Command AT+QBTGATSD=1,'',,'',,< permission> OK Response +QBTGATSD: 1,'',,'',,, OK If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). UUID of this descriptor. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this descriptor. The range is 0-255. Permission of this descriptor. For more details, please refer to Table 2. Handle of this descriptor. The range is 0-65535. Handle of this service. The range is 0-65535. 0 SUCCESS 1 FAIL Example AT+QBTGATSD=1,'ABC2',256,'1329',1,17 +QBTGATSD: 1,'ABC2',256,'1329',1,0,262 OK //Add a descriptor. MC20_BLE_AT_Commands_Manual 20 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.2.5. AT+QBTGATSST Start/Stop a Service AT+QBTGATSST Start/Stop a Service Test Command AT+QBTGATSST=? Response: +QBTGATSST: (list of supported s),'',(list of supported s)[,(list of supported s)] Write Command Start a service AT+QBTGATSST=1,'',, OK Response: +QBTGATSST: 1,'',, OK Write Command Stop a service AT+QBTGATSST=0,'', If there is any error relating to ME functionality: +CME ERROR: Response: +QBTGATSST: 0,'',, OK If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Handle of this service. The range is 0-65535. Transport method to start this service. 0 LE 0 SUCCESS 1 FAIL Example AT+QBTGATSST=1,'ABC2',256,0 +QBTGATSST: 1,'ABC2',0,256 //Start a service. MC20_BLE_AT_Commands_Manual 21 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual OK 3.2.6. AT+QBTGATSIND Send an Indication or Notification to a Client AT+QBTGATSIND Send an Indication or Notification to a Client Test Command AT+QBTGATSIND=? Response: +QBTGATSIND: '',(list of supported s),(list of supported s), (list of supported s),'' Write Command AT+QBTGATSIND='',,,,'' OK Response: +QBTGATSIND: ,'',,'' OK If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill the ‘0’ at the end of it to even). ID of current connection. The range is 0-255. Handle of attribute. The range is 0-65535. Handle of this characteristic value. The range is 0-65535. The value that needs to be notified (if the length is odd, then fill ‘0’ at the end of it to be even). Need client confirmation when sending indication (not when sending notification). 0 NO 1 YES 0 SUCCESS 1 FAIL Example AT+QBTGATSIND='ABC2',1,258,1,'74ab' +QBTGATSIND: 0,'ABC2',1,2 //Send an indication to a client. MC20_BLE_AT_Commands_Manual 22 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual OK 3.2.7. AT+QBTGATSRSP Send a Response to a Client’s Read or Write Operation AT+QBTGATSRSP Send a Response to a Client’s Read or Write Operation Test Command AT+QBTGATSRSP=? Response: +QBTGATSRSP: '',(list of supported s),(list of supported s),(list of supported s),(list of supported s),'' Write Command AT+QBTGATSRSP='',,,,,'' OK Response: +QBTGATSRSP: ,'',, OK If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Response result for client request. The range is 0-255. 0: Read request successfully Other values: Read request failed ID of current connection. The range is 0-255. ID of current transaction. The range is 0-65535. Handle of attribute. The range is 0-65535. The character value that needs to be responded (if the value length is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL Example +QBTGATRREQ: 'ABC2',1,452,107602B38034,258,0,0 AT+QBTGATSRSP='ABC2',0,1,452,258,'adb2' //Client’s read operation. //Send response to a client. MC20_BLE_AT_Commands_Manual 23 / 58 +QBTGATSRSP: 0,'ABC2',1,258 OK GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.2.8. AT+QBTGATADV Set Advertising Parameters AT+QBTGATADV Set Advertising Parameters Test Command AT+QBTGATADV=? Response +QBTGATADV: (list of supported s),(list of supported s) Write Command AT+QBTGATADV=, OK Response OK If there is any error relating to ME functionality: +CME ERROR: Parameter Minimum advertising interval for undirected and low duty cycle directed advertising. The range is 32-16384. Default: 256. Unit: 0.625ms. Maximum advertising interval for undirected and low duty cycle directed advertising. The range is 32-16384. Default: 512. Unit: 0.625ms. Example AT+QBTGATADV=800,2000 OK NOTE The actual value of advertising interval used is usually the median of maximum and minimum values. 3.2.9. AT+QGATSETADV Set Advertising Data The command adds the specified AD structure into the advertising data. Without any other special setting, the device name will be automatically included in the advertising information after executing this command. MC20_BLE_AT_Commands_Manual 24 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual AT+QGATSETADV Set Advertising Data Test Command AT+QGATSETADV=? Response +QGATSETADV: '',,(list of supported s),'','','' Write Command AT+QGATSETADV ='',,,'','','' OK Response +QGATSETADV: OK If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end to be even). The external appearance of the device. The range is 0-65535. For detailed information of this parameter, please visit the website: https://www.bluetooth.com/specifications/gatt/viewer?attributeXmlFile=org.blueto oth.characteristic.gap.appearance.xml. Format type of parameter and . 0 Hex string. A hex value string (string should be included in quotation marks). 1 String. A string (string should be included in quotation marks). Manufacturer information Service information UUID of this service. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL NOTE The max length of the advertising data is 31 bytes. MC20_BLE_AT_Commands_Manual 25 / 58 Example AT+QBTGATSREG=1,'ABC2' +QBTGATSREG: 1,'ABC2',0 OK AT+QGATSETADV='ABC2',0,0,'400103','9612','66FE' +QGATSETADV: 0 OK AT+QGATSETADV='ABC2',0,1,'ble','test','66FE' +QGATSETADV: 0 OK GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.2.10. AT+QGATADVDATA Set Advertising Data The function of this command is similar to that of the command AT+QGATSETADV, but this command can be used to set any AD structure that customers want to add. AT+QGATADVDATA Set Advertising Data Test Command AT+QGATADVDATA=? Response +QGATADVDATA: '','' OK Write Command AT+QGATADVDATA='',' ' Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end to be even). Raw advertising data string. Hex format. MC20_BLE_AT_Commands_Manual 26 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual NOTES 1. needs to conform to Bluetooth 4.0 Specification. 2. The max length of the advertising data is 31 bytes. Example AT+QBTPWR=1 OK AT+QBTGATSREG=1,'ABC2' +QBTGATSREG: 1,'ABC2',0 OK AT+QGATADVDATA='ABC2','020106070931323334353606FF4400323169' OK 3.2.11. AT+QGATSCANRSP Set Scan Response Data The command adds the required additional data such as the device name or 128-bit service UUID into scan response data. AT+QGATSCANRSP Set Scan Response Data Test Command AT+QGATSCANRSP=? Response +QGATSCANRSP: '','' OK Write Command AT+QGATSCANRSP='',' ' Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end to be even). Raw scan response data string. A hex value string (string should conform to Bluetooth 4.0 Specification). The max length is 31 bytes. MC20_BLE_AT_Commands_Manual 27 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Example AT+QGATSCANRSP='ABC2','11069ECADC240EE5A9E093F3A3B50100406E' OK 3.2.12. AT+QBTGATCPU Update Connection Parameters AT+QBTGATCPU Update Connection Parameters Test Command AT+QBTGATCPU=? Response +QBTGATCPU: ,(list of supported s),(list of supported s),(list of supported s),(list of supported s) Write Command AT+QBTGATCPU=,,,, OK Response OK If there is any error relating to ME functionality: +CME ERROR: Parameter Address of the peer BLE device. (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) Minimum value of the connection interval. The range is 6-3200. Default: 10. Unit: 1.25ms. Maximum value of the connection interval. The range is 6-3200. Default: 15. Unit: 1.25ms. Supervision timeout for the connection. The range is 10-3200. Default: 500. Unit: 10ms. Maximum slave latency allowed for the connection specified as the number of connection events. The range is 0-499. Default: 0. Example AT+QBTGATCPU=E62CA017A503,288,304,600,4 OK MC20_BLE_AT_Commands_Manual 28 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.2.13. AT+QBTGATSDISC Disconnect Server Actively AT+QBTGATSDISC Disconnect Server Actively Test Command AT+QBTGATSDISC=? Response +QBTGATSDISC: (list of supported s) Write Command AT+QBTGATSDISC= OK Response OK +QBTGATSCON: 0,'',,, If there is any error relating to ME functionality: +CME ERROR: Parameter ID of current connection. The range is 0-255. User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks), Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL Address of the peer BLE device (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) Example AT+QBTGATSDISC=1 OK 3.2.14. AT+QBTGATSL Start/Stop BLE Advertising The command is only valid when AT+QBTVISB=0. And it is applied to scenarios where BLE is broadcasted and classic BT is not broadcasted. AT+QBTGATSL Start/Stop BLE Advertising Test Command AT+QBTGATSL=? Response: +QBTGATSL: '',(list of supported s) MC20_BLE_AT_Commands_Manual 29 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Write Command AT+QBTGATSL='', OK Response: +QBTGATSL: '', OK If there is any error relating to ME functionality: +CME ERROR: Parameter 0 Stop 1 Start User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL Example AT+QBTGATSL='ABC2',1 +QBTGATSL: 'ABC2',0 OK 3.2.15. AT+QBTGATSENLE Start/Stop BLE Advertising The command can control BLE advertising independently because command AT+QBTGATSL is only valid when AT+QBTVISB=0. It is applied to scenarios where BLE is not broadcasted and classic BT is broadcasted. AT+QBTGATSENLE Start/Stop BLE Advertising Test Command AT+QBTGATSENLE=? Response +QBTGATSENLE: (list of supported s) Write Command AT+QBTGATSENLE= OK Response OK If error is related to ME functionality: MC20_BLE_AT_Commands_Manual 30 / 58 Maximum Response Time Reference Parameter 0 Stop. 1 Start. Example AT+QBTGATSENLE=1 OK GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual +CME ERROR: 300ms 3.3. BLE GATT Client AT Commands 3.3.1. AT+QBTGATCREG Register/Deregister GATT Client AT+QBTGATCREG Register/Deregister GATT Client Test Command AT+QBTGATCREG=? Response +QBTGATCREG: (list of supported s),'' Write Command AT+QBTGATCREG=,'' OK Response +QBTGATCREG: ,,'' OK If there is any error relating to ME functionality: +CME ERROR: Parameter 0 Deregister 1 Register User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length MC20_BLE_AT_Commands_Manual 31 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL Example AT+QBTGATCREG=1,'ABCD' +QBTGATCREG: 1,0,'ABCD' OK 3.3.2. AT+QBTGATCSCAN Start/Stop Scanning LE Device AT+QBTGATCSCAN Start/Stop Scanning LE Device Test Command AT+QBTGATCSCAN=? Response +QBTGATCSCAN: (list of supporteds),'' Write Command AT+QBTGATCSCAN=,'' OK Response +QBTGATCSCAN: ,,'' OK If there is any error relating to ME functionality: +CME ERROR: Parameter 0 Stop 1 Start User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL Example AT+QBTGATCSCAN=1,'ABCD' +QBTGATCSCAN: 1,0,'ABCD' //Start scanning LE device. MC20_BLE_AT_Commands_Manual 32 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual OK +QBTGATCSCAN: 'ABCD',76DCAB964FEF,40,02011A0B095155454354454C2D4254 +QBTGATCSCAN: 'ABCD',FD3B76CE6EF2,53,02011A0B095155454354454C2D4254 AT+QBTGATCSCAN=0,'ABCD' //Stop scanning LE device. +QBTGATCSCAN: 0,0,'ABCD' OK NOTE Execute the command to start scanning. When a device is scanned, the device information is reported to the serial port. If the device scanned is the same device scanned before, even if its advertising information has changed, the device information is still reported to the serial port only once. 3.3.3. AT+QBTGATCCON Connect/Disconnect GATT Client to Remote LE Device AT+QBTGATCCON Connect/Disconnect GATT Client to Remote LE Device Test Command AT+QBTGATCCON=? Response +QBTGATCCON: (list of supported s),'',< peer_addr>,(list of supported s) Read command AT+QBTGATCCON? OK Response +QBTGATCCON: , …… OK Write Command Connect AT+QBTGATCCON=1,'', , Write Command Disconnect AT+QBTGATCCON=0,'', If there is any error relating to ME functionality: +CME ERROR: Response OK If there is any error relating to ME functionality: +CME ERROR: Response OK If there is any error relating to ME functionality: +CME ERROR: MC20_BLE_AT_Commands_Manual 33 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Parameter 0 Disconnect 1 Connect User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Address of the peer BLE device. (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) 0 Non-direct connection 1 Direct connection ID of current connection. The range is 0-255. Example AT+QBTGATCCON=1,'ABCD',2711C92E38C6,1 OK +QBTGATCCON: 1,0,'ABCD',2711C92E38C6,1 AT+QBTGATCCON=0,'ABCD',1 OK +QBTGATCCON: 0,255,'ABCD',2711C92E38C6,1 3.3.4. AT+QBTGATCSS Search and Enumerate Peer’s Service The command is used to search and enumerate all the GATT services on the connected device. If the connection parameters in command AT+QBTGATCPU are long, the return time will be long correspondingly. AT+QBTGATCSS Search and Enumerate Peer’s Service Test Command AT+QBTGATCSS=? Response +QBTGATCSS: '', Write Command AT+QBTGATCSS='', OK Response OK +QBTGATCSS: ,'',,'',, ...... MC20_BLE_AT_Commands_Manual 34 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. UUID of the service. Instance ID of the service UUID. Service is the primary one or not. 0 Not primary service 1 Primary service 0 SUCCESS 1 FAIL Example AT+QBTGATCSS ='ABCD',1 OK +QBTGATCSS: 0,'ABCD',1,'0018',0,1 +QBTGATCSS: 0,'ABCD',1,'0118',0,1 +QBTGATCSS: 0,'ABCD',1,'3418',0,1 3.3.5. AT+QBTGATCGC Search and Enumerate Peer’s Characteristic of the Service The command is used to search and enumerate all the peer’s characteristics of a given service. If the characteristics info is set to NULL, then customers can only get the first characteristic. AT+QBTGATCGC Search and Enumerate Peer’s Characteristic of the Service Test Command AT+QBTGATCGC=? Response +QBTGATCGC: '',,'',,[,'',] Write Command AT+QBTGATCGC='',,'',,[,'',] +QBTGATCGC: ,'',,'',,[,'',,] If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL ID of current connection. The range is 0-255. UUID of the service. Instance ID of this service. The range is 0-255. Service is the primary one or not. 0 Not primary service 1 Primary service UUID of the characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. The properties of the characteristic. For more details, please refer to Table 2. Example AT+QBTGATCGC='ABCD',1,'3418',0,1 OK //Enumerate peer’s first characteristic of the service. +QBTGATCGC: 0,'ABCD',1,'3418',0,1,'C001',0,58 AT+QBTGATCGC='ABCD',1,'3418',0,1,'C001',0 //Enumerate peer’s second characteristic of the service. OK +QBTGATCGC: 0,'ABCD',1,'3418',0,1,'C002',0,58 MC20_BLE_AT_Commands_Manual 36 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.3.6. AT+QBTGATCGD Search and Enumerate Peer’s Descriptor of the Service with UUID The command is used to search and enumerate all the descriptors for a given characteristic. If the descriptors info is set to NULL, then only the first descriptor will be got. AT+QBTGATCGD UUID Test Command AT+QBTGATCGD=? Search and Enumerate Peer’s Descriptor of the Service with Response +QBTGATCGD: '',,'',,,'', [,'',] Write Command AT+QBTGATCGD='',,'',,,'',[,'',] OK Response OK +QBTGATCGD: ,'',,'',,,'',[,'',] If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. UUID of the service. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of the service UUID. Service is the primary one or not. 0 Not primary service 1 Primary service UUID of the characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. UUID of the descriptor. A string with hex value (string should be included in MC20_BLE_AT_Commands_Manual 37 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this descriptor. The range is 0-255. 0 SUCCESS 1 FAIL Example AT+QBTGATCGD='ABCD',1,'3418',0,1,'332A',0 OK +QBTGATCGD: 0,'ABCD',1,'3418',0,1,'332A',0,'1329',0 3.3.7. AT+QBTGATCRC Read Peer’s Characteristic of the Service with UUID AT+QBTGATCRC Read Peer’s Characteristic of the Service with UUID Test Command AT+QBTGATCRC=? Response +QBTGATCRC: '',,'',,,'', , Write Command AT+QBTGATCRC='',,'',,,'',, OK Response OK +QBTGATCRC: ,'',,'',,,'',,'' If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. UUID of the service. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). MC20_BLE_AT_Commands_Manual 38 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Instance ID of the service UUID. Service is the primary one or not. 0 Not primary service 1 Primary service UUID of the characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. Authentication requirement for reading characteristic. 0 auth_req_NONE 1 auth_req_NO_MITM 2 auth_req_MITM 3 auth_req_SIGNED_NO_MITM 4 auth_req_MITM The value of the characteristic 0 SUCCESS 1 FAIL Example AT+QBTGATCRC='ABCD',1,'3418',0,1,'332A',0,0 OK //Wait for server response. +QBTGATCRC: 0,'ABCD',1,'3418',0,1,'332A',0,'ADB2' 3.3.8. AT+QBTGATCWC Write Peer’s Characteristic of the Service with UUID AT+QBTGATCWC Write Peer’s Characteristic of the Service with UUID Test Command AT+QBTGATCWC=? Response +QBTGATCWC: '',,, '',,, '',,'', Write Command AT+QBTGATCWC='',,,'',,,'',,'', OK Response OK +QBTGATCWC: ,'',,'',,,'', If there is any error relating to ME functionality: MC20_BLE_AT_Commands_Manual 39 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. Type of sending a write request to peer device. 1 Not need the response of peer device to confirm the receiving of write request 2 Need the response of peer device to confirm the receiving of write request 3 Prepare to write the request UUID of the service. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of the service UUID. Service is the primary one or not. 0 Not primary service 1 Primary service UUID of the characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. Authentication requirement for reading characteristic. 0 auth_req_NONE 1 auth_req_NO_MITM 2 auth_req_MITM 3 auth_req_SIGNED_NO_MITM 4 auth_req_MITM The value of the characteristic 0 SUCCESS 1 FAIL Example AT+QBTGATCWC='ABCD',1,1,'3418',0,1,'332A',0,'3435',0 OK +QBTGATCWC: 0,'ABCD',1,'3418',0,1,'332A',0 MC20_BLE_AT_Commands_Manual 40 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.3.9. AT+QBTGATCRD Read Peer’s Descriptor of the Service with UUID AT+QBTGATCRD Read Peer’s Descriptor of the Service with UUID Test Command AT+QBTGATCRD=? Response +QBTGATCRD: '',,'',,,'', ,'',, Write Command AT+QBTGATCRD='',,'',,,'',,'',, OK Response OK +QBTGATCRD: ,'',,'',,,'',,'',,'' If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. UUID of the service. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of the service UUID. Service is the primary one or not. 0 Not primary service 1 Primary service UUID of the characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. UUID of the descriptor. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this descriptor. The range is 0-255. MC20_BLE_AT_Commands_Manual 41 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Authentication requirement for reading characteristic. 0 auth_req_NONE 1 auth_req_NO_MITM 2 auth_req_MITM 3 auth_req_SIGNED_NO_MITM 4 auth_req_MITM The value of the descriptor. 0 SUCCESS 1 FAIL Example AT+QBTGATCRD='ABCD',1,'3418',0,1,'332A',0,'1329',0,0 //Wait for server’s response. OK +QBTGATCRD: 0,'ABCD',1,'3418',0,1,'332A',0,'1329',0,1234 3.3.10. AT+QBTGATCWD Write Peer’s Descriptor of the Service with UUID AT+QBTGATCWD Write Peer’s Descriptor of the Service with UUID Test Command AT+QBTGATCWD=? Response +QBTGATCWD: '',,, ,,,'',,'',,, Write Command AT+QBTGATCWD='',,,,,,'',,'',,, OK Response OK +QBTGATCWD: ,'',,,,,'',,'', If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the MC20_BLE_AT_Commands_Manual 42 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. Type of sending a write request to peer device. 1 Not need the response of peer device to confirm the receiving of write request 2 Need the response of peer device to confirm the receiving of write request 3 Prepare to write the request UUID of the service. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of the service UUID. Service is the primary one or not. 0 Not primary service 1 Primary service UUID of the characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. UUID of the descriptor. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this descriptor. The range is 0-255. Authentication requirement for reading characteristic. 0 auth_req_NONE 1 auth_req_NO_MITM 2 auth_req_MITM 3 auth_req_SIGNED_NO_MITM 4 auth_req_MITM The value of the characteristic. 0 SUCCESS 1 FAIL Example AT+QBTGATCWD='ABCD',1,1,'3418',0,1,'332A',0,'1329',0,'4F4B',0 OK +QBTGATCWD: 0,'ABCD',1,'3418',0,1,'332A',0,'1329',0 MC20_BLE_AT_Commands_Manual 43 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.3.11. AT+QBTGATCEW Execute Write Command AT+QBTGATCEW Execute Write Command Test Command AT+QBTGATCEW=? Response +QBTGATCEW: '',, Write Command AT+QBTGATCEW='',, OK Response +QBTGATCEW: ,'', OK If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. 0 Cancel execution 1 Execute 0 SUCCESS 1 FAIL Example AT+QBTGATCEW='ABCD',1,1 +QBTGATCEW: 0,'ABCD',1 OK 3.3.12. AT+QBTGATCRN Register/Deregister Notification Request AT+QBTGATCRN Register/Deregister Notification Request Test Command AT+QBTGATCRN=? Response +QBTGATCRN: ,'',,,,,'', MC20_BLE_AT_Commands_Manual 44 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Write Command AT+QBTGATCRN=,' ',,,,,'', OK Response +QBTGATCRN: ,,'',,,,, '', OK If there is any error relating to ME functionality: +CME ERROR: Parameter 0 Deregister 1 Register User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Address of the peer BLE device. (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) UUID of the service. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of the service UUID. Service is the primary one or not. 0 Not primary service 1 Primary service UUID of the characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. 0 SUCCESS 1 FAIL Example AT+QBTGATCRN=1,'ABCD',2711C92E38C6,'3418',0,1,'332A',0 +QBTGATCRN: 1,0,'ABCD',2711C92E38C6,'3418',0,1,'332A',0 OK //Server sends indication/notification to client. +QBTGATCN: 'ABCD',1,2711C92E38C6,'3418',0,1,'332A',0,0,'74AB' MC20_BLE_AT_Commands_Manual 45 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.3.13. AT+QBTGATCGDT Get the Type of Peer Device The command is used to get the type of the peer device, such as BLE, BR/EDR or dual-mode. AT+QBTGATCGDT Get the Type of Peer Device Test Command AT+QBTGATCGDT=? Response +QBTGATCGDT: '', Write Command AT+QBTGATCGDT='', OK Response +QBTGATCGDT: ,'',, OK If there is any error relating to ME functionality: +CME ERROR: Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Address of the peer BLE device. (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) 0 Unknown 1 BLE 2 BR/EDR 3 Dual-mode 0 SUCCESS 1 FAIL Example AT+QBTGATCGDT='ABCD',2711C92E38C6 +QBTGATCGDT: 0,'ABCD',2711C92E38C6,1 OK MC20_BLE_AT_Commands_Manual 46 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 3.3.14. AT+QBTGATCL Start/Stop Listen Request AT+QBTGATCL Start/Stop Listen Request Test Command AT+QBTGATCL=? Response +QBTGATCL: '', Write Command AT+QBTGATCL='', OK Response +QBTGATCL: '', OK If there is any error relating to ME functionality: +CME ERROR: Parameter 0 Stop 1 Start User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). 0 SUCCESS 1 FAIL Example AT+QBTGATCL='ABCD',1 +QBTGATCL: 'ABCD',0 OK 3.3.15. AT+QGATCFGSCAN Set Scan Interval and Scan Window The command sets the scan interval and scan window. AT+QGATCFGSCAN Set Scan Interval and Scan Window Test Command AT+QGATCFGSCAN=? Response +QGATCFGSCAN: (list of supported s),(list of supported s) MC20_BLE_AT_Commands_Manual 47 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Read Command AT+QGATCFGSCAN? OK Response +QGATCFGSCAN: , OK Write Command AT+QGATCFGSCAN=, Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300ms Reference Parameter The interval time of each scan. The range is 4-16384. Default: 320. Unit: 0.625ms. The duration of each scan. The range is 4-16384. Default: 160. Unit: 0.625ms. NOTE Scan interval is the time difference between the start times of two consecutive scan windows, including the time of the scanning and the scanning break. Example AT+QGATCFGSCAN? +QGATCFGSCAN: 320,160 OK AT+QGATCFGSCAN=? +QGATCFGSCAN: , OK AT+QGATCFGSCAN=320,200 OK MC20_BLE_AT_Commands_Manual 48 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 4 Description of URCs 4.1. Notify the GATT Connection or Disconnection Notify the GATT Connection or Disconnection +QBTGATSCON: ,'',< result>,, Parameter 0 Disconnect 1 Connect User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks), Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Address of the peer BLE device (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) 0 SUCCESS 1 FAIL ID of current connection. The range is 0-255. Example +QBTGATSCON: 1,'ABC2',0,CB2CD7923F46,1 4.2. Notify the GATT Client’s Write Request Notify the GATT Client’s Write Request +QBTGATWREQ: '',,,,,,,, GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks), Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. ID of current transaction. The range is 0-255. Address of the peer BLE device (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) Handle of attribute. The range is: 0-65535. The value that needs to be written. Hex format. Whether the client needs server’s response. 1 YES 0 NO Whether the server executes request immediately. 0 NO 1 YES Offset of the request. The range is 0-65535. Example +QBTGATWREQ: 'ABC2',1,19,CB2CD7923F46,259,37383336,1,0,0 AT+QBTGATSRSP='ABC2',0,1,19,259,'adb2' +QBTGATSRSP: 0,'ABC2',1,259 OK 4.3. Notify the GATT Client’s Write Request Execution Notify the GATT Client’s Write Request Execution +QBTGATEWREQ: '',,,, MC20_BLE_AT_Commands_Manual 50 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks), Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. ID of current transaction. The range is 0-255. Address of the peer BLE device (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) 0 Cancel execution 1 Execution Example +QBTGATWREQ: 'ABC2',1,36,205CB121455D,258,313233343536373839303132333435363738,1,1,0 AT+QBTGATSRSP='ABC2',0,1,36,258,'00' +QBTGATSRSP: 0,'ABC2',1,258 OK +QBTGATWREQ: 'ABC2',1,37,205CB121455D,258,393031323334353637383930313233343536,1,1, 18 AT+QBTGATSRSP='ABC2',0,1,37,258,'00' +QBTGATSRSP: 0,'ABC2',1,258 OK +QBTGATWREQ: 'ABC2',1,38,205CB121455D,258,3738393031323334353637383930,1,1,36 AT+QBTGATSRSP='ABC2',0,1,38,258,'00' +QBTGATSRSP: 0,'ABC2',1,258 OK +QBTGATEWREQ: 'ABC2',1,39,205CB121455D,0 AT+QBTGATSRSP='ABC2',0,1,39,258,'00' +QBTGATSRSP: 0,'ABC2',1,258 OK MC20_BLE_AT_Commands_Manual 51 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 4.4. Notify the GATT Client’s Read Request Notify the GATT Client’s Read Request +QBTGATRREQ: '',,,,,, Parameter User ID (or the name) of GATT server. A hex value string (string should be included in quotation marks), Each character of it should be in set {‘0’~‘9’,‘a’~’f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. ID of current transaction. The range is 0-255. Address of the peer BLE device (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) Handle of attribute. The range is 0-65535. Notify server the order number of the request (0 means the first request) Offset of the request. The range is 0-65535. Example +QBTGATRREQ: 'ABC2',1,18,CB2CD7923F46,259,0,0 AT+QBTGATSRSP='ABC2',0,1,18,259,'adb2' +QBTGATSRSP: 0,'ABC2',1,259 OK 4.5. Report Scanning Result Report Scanning Result +QBTGATCSCAN: '',,, MC20_BLE_AT_Commands_Manual 52 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Address of the discovered BLE device. (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) Signal strength. The range is 0-255, which means the signal strength is -127dbm~127dbm. Raw EIR data string. Hex format. Example AT+QBTGATCSCAN=1,'ABCD' +QBTGATCSCAN: 1,0,'ABCD' OK +QBTGATCSCAN: 'ABCD',76DCAB964FEF,40,02011A0B095155454354454C2D4254 +QBTGATCSCAN: 'ABCD',FD3B76CE6EF2,53,02011A0B095155454354454C2D4254 4.6. Notify Client a Connection’s Status Notify Client a Connection’s Status +QBTGATCCON: ,,'',, Parameter 0 Disconnect 1 Connect 0 SUCCESS 1 FAIL User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). Address of the peer BLE device. (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) MC20_BLE_AT_Commands_Manual 53 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual ID of current connection. The range is 0-255. Example AT+QBTGATCCON=1,'ABCD',2711C92E38C6,1 OK +QBTGATCCON: 1,0,'ABCD',2711C92E38C6,1 AT+QBTGATCCON=0,'ABCD',1 OK +QBTGATCCON: 0,255,'ABCD',2711C92E38C6,1 4.7. Notify Client a Notification or Indication Comes Notify Client a Notification or Indication Comes +QBTGATCN: '',,,,,,'',,,< value> Parameter User ID (or the name) of GATT client. A hex value string (string should be included in quotation marks). Each character of it should be in set {‘0’~‘9’,‘a’~‘f’,‘A’~‘F’}. The max length is 32 bytes (if the length is odd, then fill ‘0’ at the end of it to be even). ID of current connection. The range is 0-255. Address of the peer BLE device. (e.g.: A662616202C3. Meaning: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) UUID of the service. Instance ID of the service UUID. Service is the primary one or not. 0 Not primary service 1 Primary service UUID of the characteristic. A string with hex value (string should be included in quotation marks). The max length is 32, and the min length is 4 (if the length is odd, then fill ‘0’ at the end of it to be even). Instance ID of this characteristic. The range is 0-255. MC20_BLE_AT_Commands_Manual 54 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 0 Indication 1 Notification The value of notification or indication. Example AT+QBTGATCRN=1,'ABCD',2711C92E38C6,'3418',0,1,'332A',0 +QBTGATCRN: 1,0,'ABCD',2711C92E38C6,'3418',0,1,'332A',0 OK //Server sends indication. +QBTGATCN: 'ABCD',1,2711C92E38C6,'3418',0,1,'332A',0,0,'74AB' MC20_BLE_AT_Commands_Manual 55 / 58 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual 5 Appendix A References Table 1: Terms and Abbreviations Abbreviation BLE BR BT DTE EDR FMP GATT GSM ID ME PXP UE UUID Description Bluetooth Low Energy Basic Rate Bluetooth Data Terminal Equipment Enhanced Data Rate Find Me Profile Generic Attribute Profile Global System for Mobile Communication Identification Mobile Equipment Proximity Profile User Equipment Universally Unique Identifier Table 2: Format Map of Properties and Permission Properties Default Broadcast Format Map 0 1 MC20_BLE_AT_Commands_Manual 56 / 58 Read 2 Write without response 4 Write 8 Notify 16 Indicate 32 Signed write 64 Extended properties 128 Permission Format Map Read 1 Read with encrypted protection 2 Read with MITM protection 4 Write 16 Write with encrypted protection 32 Write with MITM protection 64 Signed write 128 Signed write with MITM protection 256 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual Table 3: Different Coding Schemes of +CME ERROR: Code of 4 8300 8301 8302 8303 8304 Meaning Operation not supported GATT server register failed GATT server deregister failed GATT add service failed GATT remove service failed GATT add include service failed MC20_BLE_AT_Commands_Manual 57 / 58 8305 8306 8307 8308 8309 8310 8311 8312 8320 8321 8322 8323 8324 GSM/GPRS/GNSS Module Series MC20 BLE AT Commands Manual GATT add characteristic failed GATT add descriptor failed GATT service start failed GATT service stop failed GATT indication to client failed GATT send response to client failed GATT start listening failed GATT stop listening failed GATT BLE adv param too long GATT client register failed GATT client deregister failed GATT client connect failed GATT client disconnect failed MC20_BLE_AT_Commands_Manual 58 / 58

WCDMA UGxx TCPIP AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_TCPIP_AT_Commands_Manual_V1.4 Date: 2016-05-05 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx TCPIP 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 1 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual About the Document History Revision 1.0 1.1 1.2 1.3 1.4 Date 2014-08-01 l 2015-03-02 cte l 2015-04-01 ue tia 2015-07-09 CQonfiden 2016-05-05 Author Chris PENG Yolanda YAO Yolanda YAO Chris PENG Sophie ZHU Description Initial 1. Changed the document name from 'UG95' to 'UGxx'. 2. Added AT commands: AT+QISDE, AT+QISENDEX, AT+QICFG Updated applicable modules. Added flow chart of using TCPIP AT Commands Added description about server mode for AT+QISWTMD WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 2 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 1 Introduction .......................................................................................................................................... 6 1.1. The Process of Using TCPIP AT Commands .............................................................................. 6 1.2. Description of Data Access Mode................................................................................................ 8 2 Description of AT Command .............................................................................................................. 9 2.1. AT+QICSGP Configure Context ................................................................................................ 9 2.2. AT+QIACT Activate PDP Context ........................................................................................... 10 2.3. AT+QIDEACT Deactivate PDP Context .................................................................................. 11 3 2.4. AT+QIOPEN Start Socket Service .......................................................................................... 12 2.5. AT+QICLOSE Close Socket Service ...................................................................................... 13 2.6. AT+QISTATE Query Socket Service Status ............................................................................ 14 2.7. AT+QISEND Send Data .......................................................................................................... 16 l 2.8. AT+QIRD Retrieve the Received TCP/IP Data ....................................................................... 18 te 2.9. AT+QISENDEX Send HEX String ........................................................................................... 20 2.10. AT+QISDE Control Whether or Not to Echo the Data for QISEND ........................................ 20 c l 2.11. AT+QISWTMD Switch Data Access Mode.............................................................................. 21 2.12. AT+QPING Ping a Remote Server.......................................................................................... 22 ue tia 2.13. AT+QNTP Synchronize Local Time With NTP Server ............................................................23 2.14. AT+QIDNSCFG Configure Address of DNS Server................................................................ 24 2.15. AT+QIDNSGIP Get IP Address by Domain Name .................................................................. 24 Q n 2.16. AT+QICFG Configure Optional Parameters............................................................................ 25 2.17. AT+QIGETERROR Query the Last Error Code ...................................................................... 27 e 2.18. Description of URC .................................................................................................................... 28 fid 2.18.1. URC of Connection Closed............................................................................................ 28 2.18.2. URC of Incoming Data ................................................................................................... 28 2.18.3. URC of Incoming Connection Full ................................................................................. 29 n 2.18.4. URC of Incoming Connection ........................................................................................ 29 2.18.5. URC of PDP Deactivation .............................................................................................. 29 Co Description of Error Code ................................................................................................................. 31 4 Example .............................................................................................................................................. 33 4.1. Configure and Activate Context ................................................................................................. 33 4.1.1. Configure Context .......................................................................................................... 33 4.1.2. Activate Context ............................................................................................................. 33 4.1.3. Deactivate Context......................................................................................................... 33 4.2. TCP Client Works in Buffer Access Mode ................................................................................. 33 4.2.1. Start up a TCP Client Connection and Enter into Buffer Access Mode ......................... 33 4.2.2. Send Data in Buffer Access Mode ................................................................................. 34 4.2.3. Receive Data from Remote Server in Buffer Access Mode........................................... 34 4.2.4. Close Connection ........................................................................................................... 35 WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 3 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 4.3. TCP Client Works in Transparent Access Mode........................................................................ 35 4.3.1. Start up a TCP Client and Enter into Transparent Access Mode................................... 35 4.3.2. Send Data in Transparent Access Mode ....................................................................... 35 4.3.3. Receive Data from Remote Server in Transparent Access Mode ................................. 35 4.3.4. Close TCP Client............................................................................................................ 36 4.4. TCP Client Works in Direct Push Mode ..................................................................................... 36 4.4.1. Set up TCP Client and Enter into Direct Push Mode ..................................................... 36 4.4.2. Send Data in Direct Push Mode..................................................................................... 36 4.4.3. Receive Data from Remote Server in Direct Push Mode .............................................. 37 4.4.4. Close TCP Client............................................................................................................ 37 4.5. TCP Server Works in Buffer Access Mode ................................................................................ 37 4.5.1. Start up a TCP Server .................................................................................................... 37 4.5.2. Accept TCP Incoming Connection ................................................................................. 37 4.5.3. Receive Data from Incoming Connection ...................................................................... 38 4.5.4. Close TCP Server .......................................................................................................... 38 4.6. Example of UDP Service ........................................................................................................... 38 l 4.6.1. Start up UDP Service ..................................................................................................... 38 4.6.2. Send UDP Data to Remote ............................................................................................ 39 te 4.6.3. Receive Data from Remote............................................................................................ 39 4.6.4. Close UDP Service ........................................................................................................ 39 c l 4.7. PING........................................................................................................................................... 39 ue tia 4.8. Synchronize Local Time............................................................................................................. 40 CQonfiden 4.9. Example of Getting Last Error Code..........................................................................................40 WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 4 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual Table Index TABLE 1: THE DESCRIPTION OF ERROR CODE .................................................................................. 31 CQouneficdteenl tial WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 5 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 1 Introduction UGxx embeds a TCP/IP stack. Host is able to access the Internet directly over AT commands. It can reduce the dependence on the PPP and TCP/IP protocol stack and thus minimize the cost. UGxx provides the following socket services: TCP client, UDP client, TCP server and UDP service. This document is applicable to UGxx modules. 1.1. The Process of Using TCPIP AT Commands tel Through TCPIP AT commands, host can configure PDP context, activate/deactivate PDP context, start/close socket service and send/receive data via socket service. Figure 1 illustrates how to use TCPIP CQouneficdential AT commands: WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 6 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual Recommended Power on/off: 1. Power off: Send AT command AT+QPOWD, then cut off power after 12s. 2. Power on: Keep power key as low for 2s, then pull to high. Query SIM Card Status: Execute AT+CPIN, reboot the module if AT+CPIN? failed to find SIM card in 20s. CS Service： 1. of AT+CREG? equals to 1 or 5, means the module has registered to CS domain service. 2. Reboot the module if failed to register to CS domain service in 90s. Power on the module Send AT command and wait for the module to response OK Query SIM card status by AT+CPIN? If failed to find SIM card in 20s, then reboot the module. Find SIM card Query CS service by AT+CREG? If failed to register to CS domain service in 90s, then reboot the module. PS Service： Register to CS domain service in 60s 1. of AT+CGREG? equales to 1 or 5, means the module has registered to PS domain service. 2. Go to next step no matter register to PS domain service or not in 60s. Configure PDP Context: 1. Configure APN, user name, password and auth type by AT+QICSGP. l 2. Configure QoS settings by AT+CGQMIN/AT+CGEQMIN/ AT+CGQREQ/AT+CGEQREQ. Query PS service in 60s by AT+CGREG? Configure PDP context and Qos by AT+QICSGP/AT+CGQREQ/ AT+CGEQREQ/AT+CGQMIN/ AT+CGEQMIN te Activate PDP Context: 1. Activate PDP context by c l AT+QIACT=. 2. Query IP address of PDP context by AT+QIACT?. ue tia Notes: a) All above commands should be Reboot the module if there is no response in 40s. Succeed to deactivate PDP context Activate PDP context by AT+QIACT= and AT+QIACT? 1. Reboot the module if there is no response in 150s. 2. If failed to deactivate PDP context for 3 times, then reboot the module. executed together in sequence. b) Reboot the module if there is no response for AT+QIACT in 150s. Fail to activate PDP context Succeed to activate PDP context c) If failed to deactivate PDP Q n context for 3 times, then reboot the module. 3. Deactivate PDP context: e Reboot the module if there is no Deactivate PDP context by AT+QIDEACT= Open connection by AT+QIOPEN response for AT+QIDEACT in 40s. 1. Fail to open connection fid Open Connection： continuously for 5 times. +QIOPEN: , 2. There is no response in 150s. 1. If failed to get response of AT+QIOPEN in 150s, then close connection. 2. If failed to open connection for 5 times, deactivate PDP context, then re-activate PDP context and open connection Send data by AT+QISEND= n again. Get ACK TCP Connection Maintenance and Detection: o 1. Send data by AT+QISEND =[,]. It is recommended to periodically send a small data packet to the remote end to maintian and detect the TCP connection. Query sending ACK by AT+QISEND= ,0 in 90s C 2. Query sending ACK by AT+QISEND=,0. If the package is still not acknowledged after two minutes (query every 5 Fail to get ACK in 90s seconds, 24 times in total), the TCP connection may be abnormal, execute AT+QICLOSE to close the current connection, and then execute AT+QIOPEN to re-establish the TCP connection. Close connection by AT+QICLOSE= OK Reboot the module if there is no response in 10s. Notes: 1. Please note that you need to wait for the final response (for example OK, CME error, CMS error) of the last AT command you entered before you enter the next AT command. You can reboot the module if the module failed to get response in 60s. 2. Reboot the module if the module has not got response of AT+QIACT in 150s or response of AT+QICLOSE in 10s and AT+QIDEACT in 40s . 3. When you constantly failed to restart for 3 times, you can restart immediately for the first time after that, if it still fails, you should restart after 10 minutes for the second time, and restart after 30 minutes for the third time, 1 hour for the fourth time, etc.. Figure 1: Flow Chart of Using TCPIP AT Commands WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 7 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 1.2. Description of Data Access Mode The TCPIP AT commands of UGxx includes three kinds of data access modes: 1. Buffer access mode 2. Direct push access mode 3. Transparent access mode When opening a socket service via AT+QIOPEN, you can specify the data access mode by the parameter . After a socket service is opened, AT+QISWTMD could be used to change the data access mode. 1. In buffer access mode, send data by AT+QISEND. When the data has been received, the module will buffer the data and report a URC as +QIURC: 'recv',. Then host can read data by AT+QIRD. Note: If the buffer is not empty, the module will not report a new URC until all the received l data has been read by AT+QIRD from buffer. te 2. In direct push mode, send data by AT+QISEND. The received data will be output to COM port directly by +QIURC: 'recv',,. uec tial 3. In transparent access mode, the corresponding port (such as UART, USB modem port, etc.) enters into the exclusive mode. The data received from COM port will be sent to Internet directly, and the received data from Internet will be output to COM port directly as well. '+++' is used to exit from transparent access mode. When '+++' returns OK, the module will be switched to buffer access mode. Q n AT+QISWTMD can be used to return back to transparent access mode. Note: In transparent access e mode, host cannot execute AT command. If the socket connection is closed because of network error or else, the module will report NO CARRIER and exit from the transparent access mode. In this case, fid AT+QICLOSE should be executed to close socket service. 4. Use '+++' or DTR (AT&D1 should be set) to exit from the transparent access mode. To prevent the n '+++' from being misinterpreted as data, it should comply to the following sequence: 1) Do not input any character within T1 time (1 second) before inputting '+++'. o 2) Input '+++' during 1s, and no other characters can be inputted during this time. C 3) Do not input any character within T1 time (1 second) after '+++' has been inputted. 4) Exit from transparent access mode, return OK. 5. There are two methods to return back to the transparent access mode: 1) By AT+QISWTMD. Specify the as 2. If it enters into transparent access mode successfully, CONNECT will be returned. 2) By ATO. ATO will change the access mode of connection that exits from transparent access mode lately. If it enters into transparent access mode successfully, CONNECT will be returned. If there is no connection enters transparent access mode before, ATO will return NO CARRIER. WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 8 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 2 Description of AT Command 2.1. AT+QICSGP Configure Context Configure the , , and other context by AT+QICSGP. The QoS of the context can be configured by AT+CGQMIN, AT+CGEQMIN, AT+CGQREQ and AT+CGEQREQ. AT+QICSGP Configure Context Test Command l AT+QICSGP=? Response +QICSGP: (1-20),1-IPV4,,,,(0-3) cte l Query the configuration of context ue tia AT+QICSGP= OK Response +QICSGP: ,,,, Q en Write Command, configure the context fid AT+QICSGP=,,[[,,)[,]]] OK Response OK ERROR Con Parameter Integer type, context ID, range is 1-20 Integer type, protocol type 1 IPV4 String type, access point name String type, user name String type, password Integer type, the authentication methods 0 NONE 1 PAP WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 9 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 2 CHAP 3 PAP_OR_CHAP Example AT+QICSGP=1 +QICSGP: 1,'','','',0 //Query the configurations of context 1. OK AT+QICSGP=1,1,'UNINET','','',1 //Configure context 1, APN is 'UNINET' for China Unicom. OK 2.2. AT+QIACT Activate PDP Context tel Before activating context by AT+QIACT, host should configure the context by AT+QICSGP. After activation, the IP address can be queried by AT+QIACT?. The range of is 1-20, but the maximum c l number of context which can be activated at the same time is 3. Depending on the network, it may take at ue tia most 150 seconds to return OK or ERROR after executing AT+QIACT. Before the response is returned, other AT commands cannot be executed. AT+QIACT Activate PDP Context Q n Test Command e AT+QIACT=? Response +QIACT: (1-20) fid Read Command Con AT+QIACT? OK Response Return the list of the current activated context and its IP address: [+QIACT: 1,,, [.....] +QIACT: 20,,, ] Write Command AT+QIACT= OK Response Activate the context of specified : OK ERROR WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 10 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual Maximum Response Time 150 seconds, determined by network. Parameter Integer type, context ID, range is 1-20 Integer type, context state 0 Deactivated 1 Activated Integer type, protocol type 1 IPV4 The local IP address after context is activated 2.3. AT+QIDEACT Deactivate PDP Context tel AT+QIDEACT will deactivate the specific context and close all TCPIP connections set up in this context. Depending on the network, it may take at most 40 seconds to return OK or ERROR after c l executing AT+QIDEACT. Before the response is returned, other AT commands cannot be executed. ue tia AT+QIDEACT Deactivate PDP Context Test Command AT+QIDEACT=? Response +QIDEACT: (1-20) Q en Write Command fid AT+QIDEACT= n Maximum Response Time OK Response OK ERROR 40 seconds, determined by network. Co Parameter Integer type, context ID, range is 1-20 WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 11 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 2.4. AT+QIOPEN Start Socket Service Start a socket service by AT+QIOPEN. The service type can be specified by the parameter . The data access mode (buffer access mode, direct push access mode and transparent access mode) can be specified by parameter . The URC '+QIOPEN' indicates whether or not the socket service is started successfully. 1. If is 'TCP LISTENER', module works as TCP SERVER. After accepting a new TCP connection, module will auto specify a and report URC as +QIURC: 'incoming',,,,. The range of is 0-11. The for this new incoming connection is 'TCP INCOMING' and the is buffer access mode. 2. If is 'UDP SERVICE', UDP data can be sent to and received from the remote IP via . l  Send data: AT+QISEND=,,,.  Receive data in direct push access mode: report URC as +QIURC: 'recv',, te ,,.  Receive data in buffer access mode: report a URC as +QIURC: 'recv',, then c l retrieve data by AT+QIRD=. ue tia 3. The maximum timeout of TCP connect is 75 seconds. AT+QIOPEN Startup Socket Service Q n Test Command fide AT+QIOPEN=? Response +QIOPEN: (1-20),(0-11),'TCP/UDP/TCP LISTENER/UDP SERVICE','/',,,(0-2) n Read Command Co AT+QIOPEN? OK Response OK Write Command Response AT+QIOPEN=,<connectID If the is transparent access mode and it is >,,/,[,,] Else, response: ERROR Error description can be got via AT+QIGETERROR. WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 12 / 40 Maximum Response Time UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual If the is buffer access mode or direct push mode, response: OK +QIOPEN: , is 0 when service is set up successfully, else is not 0. 150 seconds, determined by network. Parameter ctel l Que ntia e Confid Integer type, context ID, range is 1-20 Integer type, socket service index, range is 0-11 String type, socket service type 'TCP' Start up a TCP connection as a client 'UDP' Start up a UDP connection as a client 'TCP LISTENER' Start up a TCP server to listen TCP connection 'UDP SERVICE' Start up a UDP service String type If is TCP or UDP, it indicates the IP address of remote server, such as '124.74.41.170' If is TCP LISTENER or UDP SERVICE, please enter '127.0.0.1' String type, the domain name address of the remote server The port of the remote server, only valid when is 'TCP' or 'UDP' The local port If is 'TCP LISTENER' or 'UDP SERVICE', this parameter must be specified If is 'TCP' or 'UDP', is 0, then the local port will be assigned automatically, else the local port is assigned as specified Integer type, the data access mode of the socket services 0 Buffer access mode 1 Direct push mode 2 Transparent access mode Integer type, error code. Please refer to Chapter 3. 2.5. AT+QICLOSE Close Socket Service Close the specified socket service by AT+QICLOSE. Depending on the Network, it may take some time to return OK or ERROR after executing AT+QICLOSE. Before the response is returned, other AT WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 13 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual commands cannot be executed. AT+QICLOSE Close Socket Service Test Command AT+QICLOSE=? Response +QICLOSE: (0-11) ,(1-60) OK Write Command Response AT+QICLOSE=[,] OK If failed to close, response: ERROR Parameter l cte l Integer type, socket service index, range is 0-11 Integer type. If the FIN ACK of the other peers is still not received until expires, the module will force to close the socket. Range is 1-60, default value is 10, unit: second Que ntia 2.6. AT+QISTATE Query Socket Service Status e AT+QISTATE can be used to query the socket service status. If the is 0, it will return the fid status of all existing socket services in the context of specified . If the is 1, it will return the status of specified socket service. n AT+QISTATE Query Socket Service Status o Test Command AT+QISTATE=? Response OK C If is 0, query by specified Response Return the status of all existing connections in specified AT+QISTATE=,<cont extID> List of (+QISTATE: ,,, ,,,,,,) OK WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 14 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual If is 1, query by specified AT+QISTATE=, Response +QISTATE: ,,, ,,,,,, OK Parameter Integer type, the query type 0 Query connection status by 1 Query connection status by Integer type, context ID, range is 1-20 Integer type, socket service index, range is 0-11 String type, the service type l 'TCP' TCP connection as a client te 'UDP' UDP connection as a client 'TCP LISTENER' TCP listener socket as a TCP server c l 'TCP INCOMING' TCP connection accepted by a TCP server 'UDP SERVICE' UDP service ue tia IP address If ='TCP' or 'UDP', is the IP address of remote server If ='TCP LISTENER' or 'UDP SERVICE', is local IP Q n address e If ='TCP INCOMING', is the IP address of remote client Remote port number fid If ='TCP' or 'UDP', is the port of remote server If ='TCP LISTENER' or 'UDP SERVICE', is invalid If ='TCP INCOMING', is the port of remote client n Local port number If is 0, local port is assigned automatically o Integer type, socket service state C0 'Initial' Connection has not been established 1 'Opening' Client is connecting or server is trying to listen 2 'SSL handshake' SSL handshake 3 'Connected' Client/incoming connection has been established 4 'Listening' Server is listening 5 'Closing' Connection is closing Only valid when is 'TCP INCOMING'. represents which server accepts this TCP incoming connection, the value is the same as for this server’s 'TCP LISTENER'. Data access mode WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 15 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 0 Buffer access mode 1 Direct push mode 2 Transparent access mode String type, COM port of socket service 'usbmodem' USB MODME PORT 'usbatport1' USB AT PORT1 'usbatport2' USB AT PORT2 'uart1' UART PORT1 2.7. AT+QISEND Send Data If of the specified socket service is buffer access mode or direct push mode, send data by AT+QISEND. If data is sent to module successfully, return 'SEND OK', else return 'SEND FAIL'. 'SEND FAIL' indicates the process of sending data is blocked. The host should delay some time for l sending data. The maximum length of sending data is 1460. 'SEND OK' does not mean the data has been sent to the server successfully. Through the 'AT+QISEND=, 0' command, host can te query whether the data has reached the server. c l AT+QISEND Send Data ue tia TestCommand AT+QISEND=? Response +QISEND: (0-11),(0-1460) Q n OK e If is 'TCP', 'UDP' or 'TCP INCOMING', send data with fid changeable length AT+QISEND= Response '>', then type data to send, n tap CTRL+Z to send, tap ESC to cancel Co the operation Response > CTRL+Z If connection has been established and sending successfully, response: SEND OK If connection has been established but sending buffer is full, response: SEND FAIL If connection has not been established, abnormally closed, or parameter is incorrect, response: ERROR If is 'TCP', 'UDP' or Response 'TCP INCOMING', send data with fixed > WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 16 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual length AT+QISEND=, Response '>', type data until the data length is equal to If connection has been established and sending is successful, response: SEND OK If connection has been established but sending buffer is full, response: SEND FAIL If connection has not been established, abnormally closed, or parameter is incorrect, response: ERROR If is 'UDP SERVICE' AT+QISEND=,[],, l Response '>', type data until the data te length is equal to Response This command is used to send data to specified remote IP address and remote port. The must be 'UDP SERVICE'. > c l If connection established and sending succeeds, response: ue tia SENDOK If connection has been established but sending buffer is full, Q n response: SEND FAIL fide If connection has not been established, abnormally closed, or parameter is incorrect, response: ERROR n When is 0, query the sent data Co AT+QISEND=,0 Response If the specified connection exists, return: +QISEND: ,, OK Else, return: ERROR WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 17 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual Parameter Integer type, socket service index, range is 0-11 Integer type. The length of data to be sent, which cannot exceed 1460 String type, the remote IP address, only valid when is 'UDP SERVICE' Integer type, the remote port, only valid when is 'UDP SERVICE' Integer type, the total length of sent data Integer type, the total length of acknowledged data Integer type, the total length of unacknowledged data 2.8. AT+QIRD Retrieve the Received TCP/IP Data In buffer access mode, after receiving data, the module will buffer it and report URC as +QIURC: l 'recv', to notify host. Then host can retrieve data by AT+QIRD. te Notes: If the buffer is not empty, and the module receives data again, then it will not report a new URC until all the received data has been retrieved by AT+QIRD from buffer. c l For UDP socket, the should be ignored; and for the TCP socket, the must ue tia bespecified. AT+QIRD Retrieve the Received TCP/IP Data Q n Test Command e AT+QIRD=? Response +QIRD: (0-11),(0-1500) fid OK When is 'TCP' ,'UDP' or 'TCP INCOMING' n AT+QIRD=[,] Response If the specified connection has received data, response: +QIRD: OK If no data, return: +QIRD: 0 OK When is 'UDP SERVICE' AT+QIRD= If connection does not exist, return: ERROR Response If data exits, return: +QIRD: WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 18 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual ,, OK If no data, return: +QIRD: 0 OK If connection does not exist, return: ERROR When is 0, query Response retrieved data tel AT+QIRD=,0 If the specified connection exists, response: +QIRD: ,, OK Else response: ERROR uec tial Parameter Q n e fid n o C Integer type, the socket service index, the range is 0-11 The maximum length of data to be retrieved, the range is 0-1500 The real length of received data String type, the remote IP address, only valid when is 'UDP SERVICE' Integer type, the remote port, only valid when is 'UDP SERVICE' The retrieved data The total length of received data The read length of received data The unread length of received data WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 19 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 2.9. AT+QISENDEX Send HEX String This command cannot be applied for 'UDP Service' and 'TCP Listener' Socket. AT+QISENDEX Send HEX String Test Command AT+QISENDEX=? Response +QISENDEX: (0-11), OK Write Command Response AT+QISENDEX=, If no data, return: SEND FAIL If connection does not exist, return: ERROR te Parameter uec tial Integer type, the socket service index, range is 0-11. String type, Hex string, the max length is 512. Q en 2.10. AT+QISDE Control Whether or Not to Echo the Data for QISEND fid AT+QISDE Control Whether or Not to Echo the Data for QISEND Test Command n AT+QISDE=? Response +QISDE: (0,1) Co Read Command OK Response AT+QISDE? +QISDE: Write Command AT+QISDE= OK Response OK ERROR WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 20 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual Parameter A numeric indicates whether or not to echo the data for AT+QISEND 0 Do not echo the data 1 Echo the data 2.11. AT+QISWTMD Switch Data Access Mode AT+QISWTMD can switch the data access mode: buffer access mode, direct push mode and transparent access mode. When starting a socket service, host can specify the data access mode by the parameter of AT+QIOPEN. After a socket has started, host can change the data access mode by AT+QISWTMD. If the module work in server mode, AT+QISWTMD can switch the data access mode of server, and the should be given as client incoming connection ID. l AT+QISWTMD Switch Data Access Mode te Test Command AT+QISWTMD=? Response +QISWTMD: (0-11),(0-2) uec tial ReadCommand AT+QISWTMD? Write Command Q n AT+QISWTMD=, OK Response OK Response If switch successfully and is 0 or 1, response: OK fid If switch successfully and is 2, module will enter into data mode, response: CONNECT nElse response: Co ERROR Parameter Integer type, the client connection ID, the range is 0-11 Integer type, the data access mode of the connection 0 Buffer access mode 1 Direct push mode 2 Transparent access mode WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 21 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 2.12. AT+QPING Ping a Remote Server AT+QPING is used to test the Internet Protocol reachability of a host. Before using ping tools, host should activate the context corresponding to via AT+QIACT first. It will return the result during and the default value of is 1 second. AT+QPING Ping a Remote Server Test Command AT+QPING=? Response +QPING: (1-20),,(1-255),(1-10) OK Write Command AT+QPING=,[,[,]] Response If ping successfully, return: OK l [+QPING: [,,,,]…] te +QPING: c l [,,,,,,] ue tia Elseresponse: ERROR Q n Parameter e fid n Co Integer type, the context ID, the range is 1-20 The host address in string style, format is a domain name or a dotted decimal IP address Integer type, set the maximum time to wait for the response of each ping request. Unit: second, range: 1-255, default: 1 Integer type, set the maximum time of ping request. Range: 1-10. Default: 4 The result of each ping request 0 Received the ping response from the server. In this case, it is followed by ',,,,' 1 Timeout for the ping request. In the case, no other information followed The IP address of the remote server formatted as a dotted decimal IP The length of sending each ping request The time wait for the response of the ping request. Unit: ms The value of Time To Live of the response packet for the ping request The final result of the command 0 It is finished normally. It is successful to activate the context and find the host. In this case, it is followed by ',,,,,,' WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 22 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual For other value, please refer to Chapter 3 Total number of sending the ping requests Total number of the ping requests that received the response Total number of the ping requests that were timeout The minimum response time. Unit: ms The maximum response time. Unit: ms The average response time. Unit: ms 2.13. AT+QNTP Synchronize Local Time With NTP Server NTP is intended to synchronize the Universal Time Coordinated (UTC) with the time server. Before using NTP, host should activate the context corresponding to via AT+QIACT first. Depending on the Network, it will take at most 125 seconds to return the result. l AT+QNTP Synchronize Local Time With NTP Server Test command te AT+QNTP=? Response +QNTP: (1-20),,(1-65535),(0,1) uec tial ReadCommand AT+QNTP? OK Response If in the process of synchronizing local time: [+QNTP: ,] Q en Write command fid AT+QNTP=, [,][,] OK Response If synchronize local time with NTP server successfully: OK n+QNTP: , oElse response: C ERROR Maximum Response Time 125s, determined by network. Parameter Integer type, indicates context ID, range is 1-20 String type, indicates the address of NTP server Integer type, indicates the port of NTP server Integer type, indicates whether auto set synchronized time to local time WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 23 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 0 Not set 1 Set Integer type, indicates synchronized result, please refer to Chapter 3 String type, indicates time which is synchronized from NTP server The format is 'YYYY/MM/DD,hh:mm:ss±zz'. The range of zz is -48~56 2.14. AT+QIDNSCFG Configure Address of DNS Server Before setting the DNS address, host must activate the context corresponding to via AT+QIACT first. AT+QIDNSCFG Configure Address of DNS Server Test command AT+QIDNSCFG=? Response +QIDNSCFG: (1-20),, tel Configure DNS server address for c l specified PDP context AT+QIDNSCFG=,[,] Query DNS server address of specified PDP context Q n AT+QIDNSCFG= OK Response OK ERROR Response +QIDNSCFG: ,, OK fide Parameter n Co Integer type, indicates PDP context ID, range is 1-20 String type, indicates primary DNS server address String type, indicates secondary DNS server address 2.15. AT+QIDNSGIP Get IP Address by Domain Name Before querying the DNS, host should activate the context corresponding to via AT+QIACT first. Depending on the Network, it will take at most 60 seconds to return the result. AT+QIDNSGIP Get IP Address by Domain Name Test Command AT+QIDNSGIP=? Response +QIDNSGIP: (1-20), WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 24 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual Write Command AT+QIDNSGIP=, OK Response OK ERROR Maximum Response Time The result will be returned as URC. +QIURC: 'dnsgip',,,[..... +QIURC: 'dnsgip',] 60s, determined by network. Parameter l te c l Integer type, indicates PDP context ID, range is 1-20 String type, indicates domain name Integer type, please refer to Chapter 3 Integer type, the number of the IP address corresponding to the Integer type, the time of the DNS to live String type, the IP address of Que ntia 2.16. AT+QICFG Configure Optional Parameters e AT+QICFG Configure Optional Parameters fid Test Command Con AT+QICFG=? Response +QICFG: 'tcpipcmdset',(0,1) +QICFG: 'transpktsize',(1-1460) +QICFG: 'transwaittm',(0-20) +QICFG: 'dataformat',(0,1),(0,1) +QICFG: 'viewmode',(0,1) +QICFG: 'tcp/retranscfg',(3-20),(5-1000) Set type of TCP commands AT+QICFG='tcpipcmdset'[,] OK Response [+QICFG: 'tcpipcmdset ',] Set packet size for transparent mode AT+QICFG='transpktsize'[,<tran OK ERROR Response [+QICFG: 'transpktsize',] WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 25 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual spktsize>] OK Set waiting time for transparent mode AT+QICFG='transwaittm'[,] ERROR Response [+QICFG: 'transwaittm',] OK Set the data format for sending and receiving AT+QICFG='dataformat'[,,] ERROR Response [+QICFG: 'dataformat',,] Set the display format for receiving data AT+QICFG='viewmode'[,] cte l Set the maximum interval time and number for TCP retransmission ue tia AT+QICFG='tcp/retranscfg'[,,] OK ERROR Response [+QICFG: 'viewmode',] OK ERROR Response [+QICFG: 'tcp/retranscfg',,] OK ERROR Q en Parameter fid n Co Integer type, set type of TCP commands 0 GSM TCPIP AT COMMAND SET 1 WCDMA TCPIP AT COMMAND SET Integer type, indicates the maximum length of sending data packet, range is 1-1460, default: 1024. Integer type, in transparent access mode, if the length of data received from the port is less than the specified value of , after exceeding the time of , data will be sent directly. Unit: 100ms, range: 0-20, default: 2. Integer type, indicates the format for sending data, only used to AT+QISEND command. 0 TEXT Mode 1 HEX String Mode Integer type, indicates the format for receiving data, only valid in non-transparent mode. 0 TEXT Mode WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 26 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 1 HEX String Mode Integer type, indicates the display format for receiving data, only valid in non-transparent mode. 0 Separated the header and the content by CRLF 1 Separated the header and the content by comma Integer type, indicates the maximum number of TCP retransmission Range: 3-20, default is 12 Integer type, indicates the maximum interval time of TCP retransmission Range: 5-1000, default is 600, unit: 100ms NOTES 1. The value of AT+QICFG='tcpipcmdset'[,] is saved to NV. 2. The value of AT+QICFG='tcp/retranscfg'[,,] cannot be saved, it will take effect to all the TCP sockets. tel 2.17. AT+QIGETERROR Query the Last Error Code c l If TCPIP AT commands respond ERROR, the details of error can be queried by AT+QIGETERROR. ue tia Please note that AT+QIGETERROR just returns error code of the last TCPIP AT command. AT+QIGETERROR Query the Last Error Code Q n Test command e AT+QIGETERROR=? Response OK fid Execution Command AT+QIGETERROR Response +QIGETERROR: , nOK Co Parameter Integer type, error code. Please refer to Chapter 3 A string parameter indicates the details of error information. Please refer to Chapter 3 WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 27 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 2.18. Description of URC The URC of TCPIP AT commands will be reported to the host by the type of '+QIURC:'. It contains the reports about connection closed, incoming data and incoming connection and so on. Actually, there are '' both before and after URC, but '' are omitted intentionally in this document. 2.18.1. URC of Connection Closed When TCP socket service is closed by remote peer or network error, this report will be output. The of will be 'closing'. Host must execute AT+QICLOSE= to change the to 'initial'. URC of Connection Closed +QIURC: 'closed', connection is closed. tel Parameter c l Integer type, socket service index, range is 0-11 ue tia 2.18.2. URC of Incoming Data Q n In buffer access mode or direct push mode, after receiving data, the module will report a URC to host. e In buffer access mode, after receiving data, the module will report URC as +QIURC: 'recv', fid to notify the host. Then host can retrieve data by AT+QIRD. Notes: if the buffer is not empty, and the module receives data again, it will not report a new URC until all the received data has been retrieved by AT+QIRD from buffer. In direct push mode, the received data will be output to COM port directly. n URC of Incoming Data Co +QIURC: 'recv', The URC of incoming data in buffer access mode. The host can receive data by AT+QIRD. +QIURC:'recv',, is 'TCP','UDP' or 'TCP INCOMING'. +QIURC:'recv',,,, The URC of incoming data in direct push mode when is 'UDP SERVICE'. WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 28 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual Parameter Integer type, socket service index, range is 0-11 Integer type, the length of actual received data Remote IP address Remote port The received data 2.18.3. URC of Incoming Connection Full If the incoming connection reaches the limit, or no socket system resources can be allocated, then the module will report the URC as +QIURC: 'incoming full' for the new incoming connection request. URC of Incoming Connection Full +QIURC: 'incoming full' Incoming connection is full. tel 2.18.4. URC of Incoming Connection c l If the is 'TCP LISTENER', when remote client connects to this server, host will auto ue tia assign a free for the new connection. The is 0-11. The module will report a URC as below. The of new connection is 'TCP INCOMING', and the is buffer access mode. Q n URC of Incoming Connection e +QIURC:'incoming',,<se When new incoming connection is accepted by , rverID>,, the allocated , and fid will be informed from this URC. n Parameter Co Integer type, assign this for the incoming connection, which is auto specified by the module. The range is 0-11 The incoming accepted by the server which is 'TCP LISTENER' and listening socket ID is Remote IP address of the incoming Remote port of the incoming 2.18.5. URC of PDP Deactivation PDP context may be deactivated by network. UGxx will report a URC to the host. Host should execute AT+QIDEACT to deactivate the context and reset all connections. WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 29 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual URC of PDP Deactivated +QIURC: 'pdpdeact', context is deactivated. Parameter Integer type, context ID, range is 1-20 CQouneficdteenl tial WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 30 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 3 Description of Error Code If TCPIP AT commands respond ERROR, the details of error can be queried by AT+QIGETERROR. Note: AT+QIGETERROR just returns error code of the last TCPIP AT command. Table 1: The Description of Error Code 0 550 551 552 553 554 555 556 557 558 559 560 Description of Error Code operate successfully l unknown error te operation blocked c l invalid parameter ue tia memorynotenough create socket failed Q n operation not supported e socket bind failed fid socket listen failed nsocket write failed osocket read failed Csocket accept failed 561 activate PDP context failed 562 close PDP context failed 563 socket Identity has been used 564 DNS busy 565 DNS parse failed WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 31 / 37 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 566 socket connect failed 567 socket has been closed 568 operation busy 569 operation timeout 570 PDP context break down 571 cancel send 572 operation not allowed 573 CQouneficdteenl tial APNnotconfigured WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 32 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 4 Examples 4.1. Configure and Activate Context 4.1.1. Configure Context AT+QICSGP=1,1, 'UNINET','','',1 //Configure context 1, APN is 'UNINET' for China Unicom. OK tel 4.1.2. Activate Context c l AT+QIACT=1 ue tia OK AT+QIACT? Q n +QIACT: 1,1,1,'10.7.157.1' e OK //Activate context 1. Depending on the Network, the maximum response time is 150s. //Activate successfully. //Query the state of context. fid 4.1.3. Deactivate Context n AT+QIDEACT=1 Co OK //Deactivate context 1. //Deactivate successfully. Depending on the Network, the maximum response time is 40s. 4.2. TCP Client Works in Buffer Access Mode 4.2.1. Start up a TCP Client Connection and Enter into Buffer Access Mode AT+QIOPEN=1,1,'TCP','220.180.239.201',8713,0,0 //Context is 1 and is 1. Before using AT+QIOPEN, host should activate the context WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 33 / 37 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual with AT+QIACT first. OK +QIOPEN: 1,0 //Connect successfully. It is suggested to wait 150 seconds for the URC response as '+QIOPEN: ,'. If the URC response has not been received in 150 seconds, host could use AT+QICLOSE to close the socket. AT+QISTATE=1,1 //Query if connection state of is 1. +QISTATE: 1,'TCP','220.180.239.201',8713,0,3,1,0,0,'usbmodem' OK 4.2.2. Send Data in Buffer Access Mode l AT+QISEND=1 cte l >test1 ue tia SENDOK AT+QISEND=1,4 >test Q n SENDOK AT+QISEND=1,0 e +QISEND: 9,9,0 fid OK //Send changeable length data. 'SEND OK' does not mean the data has been sent to the server successfully. Host can query whether the data has reached the server via AT+QISEND=0,0. //Send fixed length data and the data length is 4. //Query the length of sent data. n 4.2.3. Receive Data from Remote Server in Buffer Access Mode o +QIURC: 'recv',1 C AT+QIRD=1,1500 //The 1 received data. //Read data, the length is 1500. +QIRD: 5 //The actual received data length is 5. test1 OK AT+QIRD=1,1500 +QIRD: 0 //No data in buffer. OK AT+QIRD=1,0 //Query length of total received data, including read and WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 34 / 40 +QIRD: 5,5,0 OK UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual unread. 4.2.4. Close Connection AT+QICLOSE=1 OK //Close a connection whose is 1. Depending on the Network, the maximum response time is 10s. 4.3. TCP Client Works in Transparent Access Mode l 4.3.1. Start up a TCP Client and Enter into Transparent Access Mode cte l AT+QIOPEN=1,1,'TCP','220.180.239.201',8713,0,2 //Context is 1 and is 1. Before using AT+QIOPEN, host should activate the context ue tia withAT+QIACTfirst. CONNECT //Connect successfully. It is suggested to wait 150 seconds for the URC response as '+QIOPEN: Q n ,'. If the URC response has not been received in 150 seconds, host could e use AT+QICLOSE to close the socket. fid 4.3.2. Send Data in Transparent Access Mode Con 4.3.3. Receive Data from Remote Server in Transparent Access Mode test1 //All data received from internet will be output to COM port directly. WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 35 / 40 4.3.4. Close TCP Client AT+QICLOSE=1 OK UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual //After using '+++' to exit from the transparent access mode, host could use AT+QICLOSE to close the TCP link. Depending on the Network, the maximum response time is 10 seconds. 4.4. TCP Client Works in Direct Push Mode 4.4.1. Set up TCP Client and Enter into Direct Push Mode AT+QIOPEN=1,1,'TCP','220.180.239.201',8713,0,1 //Context is 1 and is 1. Before using l AT+QIOPEN, host should activate the context with AT+QIACT first. te OK c l +QIOPEN: 1,0 //Connect successfully. It is suggested to wait ue tia 150 seconds for the URC response as '+QIOPEN: ,'. If the URC response has not been received in 150 Q n seconds, host could use AT+QICLOSE to close the socket. e AT+QISTATE=1,1 //Query if connection state of is 1. +QISTATE: 1,'TCP','220.180.239.201',8713,0,3,1,0,1,'usbmodem' fid OK n 4.4.2. Send Data in Direct Push Mode Co AT+QISEND=1 //Send changeable length data. 'SEND OK' does not mean the data has been sent to the server successfully. Host can query whether the data has reached the server via AT+QISEND=0,0. >test1 SEND OK AT+QISEND=1,5 //Send fixed length data and the data length is 5. >test2 SEND OK AT+QISEND=1,0 //Query the length of sent data. WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 36 / 40 +QISEND: 10,10,0 OK UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 4.4.3. Receive Data from Remote Server in Direct Push Mode +QIURC: 'recv',1,4 test //Receive data from remote server. 4.4.4. Close TCP Client AT+QICLOSE=1 l OK //Close the connection of which is 1. Depending on the Network, the maximum response time is 10s. cte l 4.5. TCP Server Works in Buffer Access Mode ue tia 4.5.1. Start up a TCP Server Q n AT+QIOPEN=1,1,'TCP LISTENER','127.0.0.1',0,2020,0 //Context is 1 and is 1. Before eusing AT+QIOPEN, host should activate the context with AT+QIACT first. fid OK +QIOPEN: 1,0 //Start up TCP server successfully. n AT+QISTATE=0,1 //Query if connection state of 1. Co +QISTATE: 1,'TCP LISTENER','10.7.157.1',0,2020,4,1,0,0,'usbmodem' OK 4.5.2. Accept TCP Incoming Connection +QIURC: 'incoming',11,1,'172.31.242.222',54091 //Accept a TCP connection, is TCP incoming, is 11. WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 37 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 4.5.3. Receive Data from Incoming Connection +QIURC: 'recv',11 AT+QIRD=11,1500 +QIRD: 4 test //Receive data from remote incoming connection. //Read data received from incoming connection. //Actual data length is 4. OK AT+QIRD=11,1500 +QIRD: 0 //No data in buffer. OK AT+QIRD=11,0 //Query the length of total received data, including +QIRD: 4,4,0 OK tel 4.5.4. Close TCP Server c l AT+QICLOSE=11 ue tia OK AT+QICLOSE=1 Q n OK read and unread. //Close incoming connection. Depending on the Network, the maximum response time is 10s. //Close TCP server listening. fide 4.6. Example of UDP Service n 4.6.1. Start up UDP Service o AT+QIOPEN=1,2,'UDP SERVICE','127.0.0.1',0,3030,0 //Start up a UDP service, is 2 C and context is 1. Before using AT+QIOPEN, host should activate the context with AT+QIACT first. OK +QIOPEN: 2,0 //Start up UDP service successfully. AT+QISTATE=0,1 //Query connection state of 1. +QISTATE: 2,'UDP SERVICE','10.7.157.1',0,3030,3,1,0,0,'usbmodem' OK WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 38 / 40 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 4.6.2. Send UDP Data to Remote AT+QISEND=2,10,'10.7.89.10',6969 >1234567890 SEND OK //Send 10 bytes data to remote whose IP is 10.7.89.10 and remote port is 6969. 4.6.3. Receive Data from Remote +QIURC: 'recv',2 //Receive data from remote. AT+QIRD=2 //Read UDP data. One whole UDP packet will output. There is +QIRD: 4,'10.7.76.34',7687 no need to specify the read length. //Data length is 4, remote IP address is 10.7.76.34 and remote port is 7687 test. l OK AT+QIRD=2 te +QIRD: 0 //Read data. //No data in buffer. c l OK ue tia AT+QISEND=2,10,'10.7.76.34',7687 //Send data to remote (10.7.76.34:7687). >1234567890 SEND OK Q en 4.6.4. Close UDP Service fid AT+QICLOSE=2 OK //Close the service. Con 4.7. PING AT+QPING=1,'www.baidu.com' OK //Ping www.baidu.com in context 1. Before pinging the destination IP address, host should activate the context with AT+QIACT first. +QPING: 0,61.135.169.125,0,0,147 +QPING: 0,61.135.169.125,0,0,108 WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 39 / 40 +QPING: 0,61.135.169.125,0,0,96 +QPING: 0,61.135.169.125,0,0,96 +QPING: 0,4,4,0,96,147,111 UMTS/HSPA Module Series WCDMA UGxx TCPIP AT Commands Manual 4.8. Synchronize Local Time AT+QNTP=1,'202.120.2.101',123 //Synchronize local time with NTP server '202.120.2.101'. Before synchronizing the time, host should activate the context with AT+QIACT first. OK +QNTP: 0,'2013/08/19,11:10:10+32' l AT+CCLK? +CCLK: '13/08/19,11:10:57+32' te OK uec tial 4.9. Example of Getting Last Error Code Q n AT+QIOPEN=1,'TCP','220.180.239.201',8713,0,1 e ERROR AT+QIGETERROR fid +QIGETERROR: 552, invalid parameters //Start socket service, forget the . Con OK WCDMA_UGxx_TCPIP_AT_Commands_Manual Confidential / Released 40 / 40

WCDMA UGxx STK AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_STK_AT_Commands_Manual_V1.3 Date: 2016-05-05 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx STK 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 1 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual About the Document History Revision 1.0 1.1 1.2 1.3 Date 2014-12-12 l 2015-03-01 te 2015-04-01 CQouneficdential 2016-05-05 Author Chris PENG Jesse ZHANG Jesse ZHANG Sophie ZHU Description Initial Changed the document name from 'UG95' to 'UGxx'. Updated applicable modules. Added STK state value for AT+QSTKSTATE=?/AT+QSTKGI=?/ AT+QSTKRSP=? WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 2 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. The Process of Using STK AT Command................................................................................... 6 1.2. STK States .................................................................................................................................. 6 1.3. Proactive Command Response .................................................................................................. 7 1.4. STK Character Set ...................................................................................................................... 8 2 Description of AT Command .............................................................................................................. 9 2.1. AT+QSTK Enable STK Functionality........................................................................................ 9 2.2. AT+QSTKPD Download STK Profile...................................................................................... 10 2.3. AT+QSTKSTATE Query STK State ........................................................................................ 10 l 2.4. AT+QSTKGI Get Proactive Command Information ............................................................... 11 2.5. AT+QSTKRSP STK Response .............................................................................................. 11 te 2.6. Summary of URC ...................................................................................................................... 12 2.6.1. URC of Proactive Command.......................................................................................... 12 c l 2.6.2. URC of No Proactive Command .................................................................................... 13 2.6.3. URC of SIM Lost ............................................................................................................ 13 ue tia 2.6.4. URC of Timeout Response ............................................................................................ 13 2.7. Details of Proactive Command .............................................................................. 14 2.7.1. Set up Call (16) .............................................................................................................. 14 Q n 2.7.2. Send SS (17).................................................................................................................. 16 e 2.7.3. Send USSD (18) ............................................................................................................ 18 2.7.4. Send SMS (19)............................................................................................................... 19 fid 2.7.5. Send DTMF (20) ............................................................................................................ 20 2.7.6. Play Tone (32) ................................................................................................................ 21 2.7.7. Display Text (33)............................................................................................................. 23 n 2.7.8. Get Inkey (34)................................................................................................................. 24 2.7.9. Get Input (35) ................................................................................................................. 25 o 2.7.10. Select Item (36).............................................................................................................. 27 C 2.7.11. Set up Menu (37) ........................................................................................................... 29 2.7.12. Set up Idle Mode Text (40)............................................................................................. 31 2.7.13. Language Notification (53)............................................................................................. 32 3 Examples of STK AT Command ....................................................................................................... 34 3.1. Enable STK Function and Set up Menu ................................................................................... 34 3.2. Menu Selection and Set up Call ............................................................................................... 35 3.3. Select Menu and Send SMS..................................................................................................... 36 3.4. STK Session Termination and Timeout Response ................................................................... 37 3.5. Disable STK Function ............................................................................................................... 38 4 Appendix ............................................................................................................................................. 39 WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 3 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 4.1. Reference.................................................................................................................................. 39 4.2. Common Code ................................................................................................................ 40 4.3. Auto Response Timeout Value.................................................................................................. 40 CQouneficdteenl tial WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 4 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Table Index TABLE 1: RESPONSE OF PROACTIVE COMMAND................................................................................. 7 TABLE 2: TYPE OF PROACTIVE COMMAND (REFER TO CHAPTER 13.4 IN 3GPP TS 11.14) .......... 14 TABLE 3: RELATED DOCUMENTS .......................................................................................................... 39 TABLE 4: TERMS AND ABBREVIATIONS ................................................................................................ 39 TABLE 5: COMMON CODE IN STK AT COMMAND.................................................................... 40 TABLE 6: PROACTIVE COMMAND AUTO RESPONSE TIMEOUT VALUE ............................................ 40 CQouneficdteenl tial WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 5 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 1 Introduction UGxx module provides AT commands to support SIM (USIM) Application Toolkit (STK). This document is a reference guide to all the AT commands defined for SIM (USIM) Application Toolkit. This document is applicable to Quectel UGxx modules. 1.1. The Process of Using STK AT Command l Step 1: Switch on the module, and enable STK functionality by command AT+QSTK=1[,] te then reboot the module. Step 2: According to URC, query proactive command information by AT+QSTKGI and respond to the c l STK proactive command by AT+QSTKRSP. When +QSTKURC: 253 has been reported, you can select menu item via command AT+QSTKRSP=253,,. Furthermore, you ue tia can use AT+QSTKRSP=254 to terminate STK session at any time. Step 3: Disable STK functionality by AT+QSTK=0, then reboot the module. Q en 1.2. STK States fid There are three kinds of states: automatic response state, terminal response state and waiting state. For more details, please refer to Chapter 2.3. The following figure shows the state transition. on Automatic C response state AT+QSTK=1[,] and reboot module AT+QSTKRSP=,[…] Terminal response state Waiting state AT+QSTK=0 and reboot +QSTKURC: module Figure 1: STK States Transition WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 6 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 1.3. Proactive Command Response When STK functionality is disabled, module will automatically respond to the proactive command. When STK functionality is enabled, you should respond to the proactive command (Refer to Chapter 2.7). If you do not respond to the proactive command in some time, then URC of timeout response will be reported and module will automatically respond to proactive command. Table 1: Response of Proactive Command Proactive Command Automatic Response User Response Timeout Response SET UP CALL (16) 48 SEND SS (17) 48 l SEND USSD (18) 48 te SEND SHORT 48 MESSAGE (19) c l SEND DTMF (20) 48 ue tia PLAYTONE(32) 48 DISPLAY TEXT (33) 0 Q n GET INKEY (34) 48 e GET INPUT (35) 48 fid SELECT ITEM (36) 48 n SET UP MENU (37) 0 SET UP IDLE MODE o0 TEXT (40) C LANGUAGE 0, 4, 16, 32, 34, 35, 48 50 0, 4, 20, 32, 48 50 0, 4, 20, 32, 48 50 0, 4, 32, 48 50 0, 4, 16, 32, 48 50 0, 4, 16, 32, 48 50 0, 4, 16, 17, 18, 32, 48 48 0, 4, 16, 17, 18, 19, 32, 48 48 0, 4, 16, 17, 18, 19, 32, 48 48 0, 4, 16, 17, 18, 19, 32, 48 48 0, 4, 32, 48 48 0, 4, 32, 48 48 0 0 48 NOTIFICATION (53) WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 7 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 1.4. STK Character Set The STK AT command interface supports the following character sets:  GSM character set (default)  UCS2 character set The character set can be configured by AT+QSTK=[,] (Refer to Chapter 2.1), they become effective after setting. And they will affect STK AT command to input parameter and output information. If UCS2 character cannot convert to GSM character, it will convert to 0x20 (space). CQouneficdteenl tial WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 8 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 2 Description of AT Command 2.1. AT+QSTK Enable STK Functionality AT+QSTK command is used to enable STK functionality and configure the , and will affect the coding of input and output text. AT+QSTK Enable STK Functionality Test Command l AT+QSTK=? Response +QSTK: (0,1),(0,1) cte l ReadCommand AT+QSTK? OK Response +QSTK: , ue tia WriteCommand Q en AT+QSTK=[,] OK Response OK ERROR fid If error is related to ME functionality: +CME ERROR: n Parameter Co Enable STK functionality 0 Disable STK functionality 1 Enable STK functionality Alphabet set 0 GSM character set 1 UCS2 character set WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 9 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 2.2. AT+QSTKPD Download STK Profile AT+QSTKPD command is used to get SIM profile. Profile refers to ETSI TS 102 223. AT+QSTKPD Download STK Profile Test Command AT+QSTKPD=? Read Command AT+QSTKPD? Response OK Response +QSTKPD: OK ERROR If error is related to ME functionality: +CME ERROR: tel Parameter c l Hex string; STK profile Que ntia 2.3. AT+QSTKSTATE Query STK State e When executing AT+QSTKGI or AT+QSTKRSP, you should refer to the value of . When fid is 0 or 2, will be ignored. When is 253, it indicates that STK session has finished. At this time, you cannot get STK n proactive command information via AT+QSTKGI= and do not need to respond to the proactive command via AT+QSTKRSP=,[…]. But you can select menu item via o AT+QSTKRSP=253,, and start STK session. C AT+QSTKSTATE Query STK State Test Command AT+QSTKSTATE=? Response +QSTKSTATE: (0-2),(16-20,32-37,40,53,64-68,253) Read Command AT+QSTKSTATE? OK Response +QSTKSTATE: [,] OK WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 10 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Parameter STK state 0 Automatic response state 1 Terminal response state 2 Waiting state Integer type, type of command. Its value is 16-20,32-37,40,53,64-68,253 2.4. AT+QSTKGI Get Proactive Command Information When URC: +QSTKURC: has been reported, you can get STK proactive command information via AT+QSTKGI=. AT+QSTKGI Get Proactive Command Information l Test Command AT+QSTKGI=? Response +QSTKGI: (16-20,32-37,40,53,64-68) cte l WriteCommand ue tia AT+QSTKGI= OK Response Response varies with the . Please refer to Chapter 2.7 for details. Q n Parameter fide Integer type, type of proactive command, refer to the Table 1 n 2.5. AT+QSTKRSP STK Response Co After receiving the URC +QSTKURC: , you can get information via AT+QSTKGI= and respond via AT+QSTKRSP. The AT+QSTKRSP=253,, command is used to select menu item, it can only be used after receiving +QSTKURC: 253. Terminate STK session via AT+QSTKRSP=254 command, and then +QSTKURC: 253 will be reported. WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 11 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual AT+QSTKRSP STK Response Test Command AT+QSTKRSP=? Response +QSTKRSP: (16-20,32-37,40,53,64-68,253,254) Write Command AT+QSTKRSP=253,, OK Response It‟s used to select menu item. OK ERROR If error is related to ME functionality: Write Command AT+QSTKRSP=254 l Write Command te AT+QSTKRSP=,[ …] +CME ERROR: Response It‟s used to terminate the current STK session. OK ERROR Response Inputted parameters and response vary with the . Please refer to Chapter 2.7 for details. uec tial Parameter Q n fide Integer type, type of proactive command, refer to the Table 1 Command result 0 Trigger modem to select menu 19 Help information required by the user Menu item ID n 2.6. Summary of URC Co The URC of STK will be reported to the host by the type of '+QSTKURC: '. It contains URC of proactive command, no proactive command, SIM lost and timeout response. 2.6.1. URC of Proactive Command When STK session is not finished, this URC will be reported to indicate you to get the proactive command information via AT+QSTKGI= and respond to the proactive command via AT+QSTKRSP=,[…]. WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 12 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual URC of Proactive Command +QSTKURC: Indication of proactive command Parameter A numeric parameter indicates the proactive command to be reported, its value will be 16-20, 32-37, 40, 53 2.6.2. URC of No Proactive Command When STK session is finished, this URC '+QSTKURC:253' will be reported. At this time, you can‟t get STK proactive command information via AT+QSTKGI= and do not need to respond to the proactive command via AT+QSTKRSP=,[…]. But you can select menu item via l AT+QSTKRSP=253,, and start STK session . te URC of No Proactive Command c l +QSTKURC: 253 Indication of no proactive command ue tia 2.6.3. URC of SIM Lost Q n When SIM is lost, this URC will be reported. For example, SIM pulls out or CFUN changes from 1 to 0. e URC of SIM Lost fid +QSTKURC: 254 Indication of SIM lost n 2.6.4. URC of Timeout Response Co When you do not respond to the proactive command in some time, this URC will be reported and module will automatically respond to the proactive command. For the timeout value of each proactive command, please refer to Chapter 4.3. URC of Timeout Response +QSTKURC: 255, Indication of timeout response WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 13 / 40 Parameter UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual A numeric parameter indicates timeout response of the proactive command, its value will be 16-20, 32-37, 40, 53 2.7. Details of Proactive Command You can get proactive command information repeatedly before responding to proactive command. Table 2: Type of Proactive Command (Refer to Chapter 13.4 in 3GPP TS 11.14) l 16 te 17 c l 18 ue tia 19 20 Q n 32 e 33 fid 34 35 on 36 C 37 Name Set up call Send SS Send USSD Send SMS Send DTMF Play tone Display text Get inkey Get input Select item Set up menu 40 Set up idle mode text 53 Language notification 2.7.1. Set up Call (16) After receiving +QSTKURC: 16, you can get information via AT+QSTKGI=16, then respond to proactive command via AT+QSTKRSP=16,[,]. Please refer to the example in Chapter 3.2. WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 14 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Set up Call (16) Write Command AT+QSTKGI=16 Response +QSTKGI: 16,,,,,,, , OK ERROR If error is related to ME functionality: Write Command AT+QSTKRSP=16,[,] +CME ERROR: Response +QSTKRSP: 16,[,] l OK te ERROR c l If error is related to ME functionality: ue tia +CMEERROR: Parameter Q en Confid Details of call set up command 0 Set up call, only if no currently busy calls 1 Set up call, only if no currently busy calls, support redial 2 Set up call, hold on all other calls (if any) 3 Set up call, hold on all other calls (if any), support redial 4 Set up call, disconnect all other calls (if any) 5 Set up call, disconnect all other calls (if any), support redial 6-255 RFU (Reserved for Future Use) String type; confirmation information String type; called number String type; call set up information Confirmation of icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is non self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Confirmation of icon ID WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 15 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 0 No icon 1-255 ID of icon Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID 0 No Icon 1-255 ID of Icon Command result code. uectel tial Q n fide 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 16 Proactive SIM session is terminated by user 20 USSD/SS transact is terminated by user 32 UE is unable to process command currently 34 User did not accept the proactive command. Indicate that the user has denied the call request 35 User cleared call before connection or network release 48 Command is beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 Termination qualifier 0 The proactive command is successfully finished 1-255 The proactive command is performed incorrectly The text contains information regarding to the termination cause n 2.7.2. Send SS (17) o After receiving +QSTKURC: 17, you can get information via AT+QSTKGI=17, then respond via C AT+QSTKRSP=17,[,]. Send SS (17) Write Command AT+QSTKGI=17 Response +QSTKGI: 17,,,, OK ERROR WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 16 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Write Command AT+QSTKRSP=17,[,] If error is related to ME functionality: +CME ERROR: Response +QSTKRSP: 17,[,] OK ERROR If error is related to ME functionality: +CME ERROR: Parameter l uecte tial Q en Confid RFU String type; text Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID 0 No icon 1-255 ID of icon Command result code 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 20 USSD/SS transact is terminated by user 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 Termination qualifier 0 The proactive command is successfully finished 1-255 The proactive command is performed incorrectly The text contains information regarding to the termination cause WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 17 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 2.7.3. Send USSD (18) After receiving +QSTKURC: 18, you can get information via AT+QSTKGI=18, then respond via AT+QSTKRSP=18,[,]. Send USSD (18) Write Command AT+QSTKGI=18 Response +QSTKGI: 18,,,, OK ERROR Write Command l AT+QSTKRSP=18,[,] If error is related to ME functionality: +CME ERROR: Response +QSTKRSP: 18,[,] te OK c l ERROR ue tia If error is related to ME functionality: +CME ERROR: Q en Parameter fid Con RFU String type; text Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID 0 No icon 1-255 ID of icon Command result code 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 18 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 20 USSD/SS transact is terminated by user 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 Termination qualifier 0 The proactive command is successfully finished 1-255 The proactive command is performed incorrectly The text contains information regarding to the termination cause 2.7.4. Send SMS (19) After receiving +QSTKURC: 19, you can get information via AT+QSTKGI=19, then respond via AT+QSTKRSP=19,[,]. Please refer to Chapter 3.3 for example. Send SMS (19) l Write Command te AT+QSTKGI=19 Response +QSTKGI: 19,,,, c l OK ue tia ERROR Q en Write Command AT+QSTKRSP=19,[,] If error is related to ME functionality: +CME ERROR: Response +QSTKRSP: 19,[,] OK nERROR o If error is related to ME functionality: C +CME ERROR: Parameter RFU String type; text Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with The text determined value only if associated icon ID is WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 19 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual not 0 (an icon exists) Bit 2-8 RFU Icon ID 0 No icon 1-255 ID of icon Command result code 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 32 UE is unable to process command currently 48 Command is beyond UE's capabilities l Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 Termination qualifier 0 The proactive command is successfully finished 1-255 The proactive command is performed incorrectly The text contains information regarding to the termination cause cte l 2.7.5. Send DTMF (20) ue tia After receiving +QSTKURC: 20, you can get information via AT+QSTKGI=20, then respond via AT+QSTKRSP=20,[,]. Q n Send DTMF (20) e Write Command fid AT+QSTKGI=20 Response +QSTKGI: 20,,,, OK nERROR o If error is related to ME functionality: C +CME ERROR: Write Command Response AT+QSTKRSP=20,[,] ERROR If error is related to ME functionality: +CME ERROR: WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 20 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Parameter RFU String type; text Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID 0 No icon uectel tial 1-255 ID of icon Command result code 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 16 Proactive SIM session is terminated by user 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 Q n 2.7.6. Play Tone (32) e After receiving the +QSTKURC: 32, you can get information via AT+QSTKGI=32, then response via fid AT+QSTKRSP=32,[,]. Play Tone (32) n Write Command Co AT+QSTKGI=32 Response +QSTKGI: 32,,,,,,, OK ERROR Write Command AT+QSTKRSP=32,[,] If error is related to ME functionality: +CME ERROR: Response OK ERROR WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 21 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual If error is related to ME functionality: +CME ERROR: Parameter RFU String type; text Tone generated by the UE. 01-08 are standard supervisory tones and 16-18 are UE proprietary tones '01' Dial tone '02' Called subscriber busy '03' Congestion ctel l Que ntia nfide Co '04' Radio path acknowledge '05' Radio path not available/call dropped '06' Error/special information '07' Call waiting tone '08' Ringing tone '16' General beep '17' Positive acknowledgement tone '18' Negative acknowledgement or error tone Duration unit 0 Minutes 1 Seconds 2 A tenth of a second Duration of tone in units, range is 1-255 Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID 0 No icon 1-255 ID of icon Command result code. 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 16 Proactive SIM session is terminated by user 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223 Range is 0-255 WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 22 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 2.7.7. Display Text (33) After receiving the +QSTKURC: 33, you can get information via AT+QSTKGI=33, then respond via AT+QSTKRSP=33,[,]. Display Text (33) Write Command AT+QSTKGI=33 Response +QSTKGI: 33,,,,, OK ERROR l Write Command AT+QSTKRSP=33,[,] If error is related to ME functionality: +CME ERROR: Response OK ERROR c l If error is related to ME functionality: ue tia +CMEERROR: Parameter Q en nfid Co Number parameter; display text command details, its value is 0-255 Bit 1 0: Normal priority 1: High priority Bit 2-7 RFU Bit 8 0: Clear message after a delay 1: Wait for user to clear message String type; text Immediate response 0 Send terminal response when text is cleared from screen 1 Send terminal response immediately and continue to display the text until one of the following events occurs:  A subsequent proactive command is received, containing displayed data  A short delay notified with has expired  User intervention  A higher priority event occurs, e.g. a mobile terminated call Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 23 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID 0 No icon 1-255 ID of icon Command result code 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed tel 16 Proactive SIM session is terminated by user 17 Backward move in the proactive SIM session is requested by the user 18 No response from user 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 uec tial 2.7.8. GetInkey(34) After receiving the +QSTKURC: 34, you can get information via AT+QSTKGI=34, then respond via Q n AT+QSTKRSP=34,,[,]. e Get Inkey (34) fid Write Command AT+QSTKGI=34 Response +QSTKGI: 34,,,, nOK Co ERROR If error is related to ME functionality: +CME ERROR: Write Command Response AT+QSTKRSP=34,,[,] ERROR If error is related to ME functionality: +CME ERROR: WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 24 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Parameter Number parameter; get inkey command details, its value is 0-255 Bit 1 0: Digits only 1: Alphabet set Bit 2 0: SMS default alphabet (GSM character set) 1: UCS2 alphabet Bit 3 0: Character sets defined by bit 1 and bit 2 are enabled 1: Character sets defined by bit 1 and bit 2 are disabled and the 'Yes/No' response is requested Bit 4-7 RFU Bit 8 0: No help information is available tel uec tial Qonfiden C 1: Help information is available String type; text Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID 0 No icon 1-255 ID of icon Command result code 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 16 Proactive SIM session is terminated by user 17 Backward move in the proactive SIM session requested by the user 18 No response from user 19 Help information is required by the user 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Input string Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 2.7.9. Get Input (35) After receiving the +QSTKURC: 35, you can get information via AT+QSTKGI=35, then respond via AT+QSTKRSP=35,,[,]. Please refer to Chapter 3.3 for example. WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 25 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Get Input (35) Write Command AT+QSTKGI=35 Response +QSTKGI: 35,,,,,< default_input>,, OK ERROR If error is related to ME functionality: +CME ERROR: Write Command AT+QSTKRSP=35,,[,] Response OK ERROR l If error is related to ME functionality: +CME ERROR: cte l Parameter ue tia CQonfiden Number parameter; get input command details, its value is 0-255 Bit 1 0: Digits only 1: Alphabet set Bit 2 0: SMS default alphabet (GSM character set) 1: UCS2 alphabet Bit 3 0: ME may echo user input on the display 1: User input shall not be revealed in any way Bit 4 0: User input in unpacked format 1: User input in SMS packed format Bit 5-7 RFU Bit 8 0: No help information available 1: Help information available String type; text Minimum length of user input Maximum length of user input String type; default input text Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 26 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 0 No icon 1-255 ID of icon Command result code 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 16 Proactive SIM session is terminated by user 17 Backward move in the proactive SIM session requested by the user 18 No response from user 19 Help information is required by the user 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Input string Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 tel 2.7.10. Select Item (36) c l After receiving the +QSTKURC: 36, you can get information via AT+QSTKGI=36, then respond via AT+QSTKRSP=36,, [,]. ue tia Select Item (36) Write Command Q fiden AT+QSTKGI=36 Response The response for first line of output: +QSTKGI: 36,,,,,,,, nOK o There are repeated lines with total number of , C and here just lists one line of every item: +QSTKGI: 36,,,, OK ERROR Write Command If error is related to ME functionality: +CME ERROR: Response WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 27 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual AT+QSTKRSP=36,, [,] OK ERROR If error is related to ME functionality: +CME ERROR: Parameter Details of selected item command Bit 1 0: Presentation type is not specified 1: Presentation type is specified in bit 2 Bit 2 0: Presentation as a choice of data values, if bit 1=„1‟ tel c l ue tia Q en Confid 1: Presentation as a choice of navigation options if bit 1=„1‟ Bit 3 0: No selection preference 1: Using soft key preferred to select Bit 4-7 RFU Bit 8 0: No help information is available 1: Help information is available Number of items in the list String type; title Default item ID 0 No default item is issued 1-255 ID of the default Item Presence of item icon 0 No icon 1 Icon is presented Item icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Title icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Title icon ID 0 No Icon 1-255 ID of Icon Item identifier String type; item text WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 28 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual The next proactive command type to be issued upon execution of the menu item Item Icon ID 0 No Icon 1-255 ID of Icon Command result code 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 16 Proactive SIM session terminated by user 17 Backward move in the proactive SIM session requested by the user l 18 No response from user 19 Help information required by the user 32 UE is unable to process command currently 48 Command beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 cte l 2.7.11. 2.7.11 Set up Menu (37) ue tia After receiving the +QSTKURC: 37, you can get information via AT+QSTKGI=37, then respond via AT+QSTKRSP=37,[,]. Please refer to Chapter 3.1 for example. After this, you can get main menu via AT+QSTKGI=37 at any time. Q n Set up Menu (37) e Write Command nfid AT+QSTKGI=37 Response The response for first line of output: +QSTKGI: 37,,,,,,, Co There are repeated lines with total number of , and here just lists one line of every item: +QSTKGI: 37,,,, OK ERROR If error is related to ME functionality: +CME ERROR: WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 29 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Write Command AT+QSTKRSP=37,[,] Response OK ERROR If error is related to ME functionality: +CME ERROR: Parameter Details of set up menu command Bit 1 0: No selection preference 1: Using soft key preferred to select l te c l Que entia Confid Bit 2-7 RFU Bit 8 0: No help information is available 1: Help information is available Number of items in the list String type; title Presence of item icon 0 No icon 1 Icon is presented Item icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Title icon ID 0 No Icon 1-255 ID of Icon Item identifier String type; item text The next proactive command type to be issued upon execution of the menu item. Item Icon ID 0 No Icon 1-255 ID of Icon Command result code. 0 Command performed successfully. Indicate that the user has WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 30 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual accepted the call request. 4 Command performed successfully, but requested icon could not be displayed 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 2.7.12. Set up Idle Mode Text (40) After receiving the +QSTKURC: 40, you can get information via AT+QSTKGI=40, then respond via AT+QSTKRSP=40,[,]. This command provides text, and an icon will be displayed by the TE optionally when the display is idle. Set up Idle Mode Text (40) Write Command tel AT+QSTKGI=40 Response The response for first line of output: +QSTKGI: 40,,,, c l OK ue tia ERROR Q en Write Command AT+QSTKRSP=40,[,] If error is related to ME functionality: +CME ERROR: Response OK ERROR If error is related to ME functionality: n+CME ERROR: Co Parameter RFU String type; text to be displayed when TE is in idle mode Icon qualifier Bit 1 0: Icon is self-explanatory and can replace text 1: Icon is not self-explanatory and shall be displayed with the text determined value only if associated icon ID is not 0 (an icon exists) Bit 2-8 RFU Icon ID WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 31 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 0 No icon 1-255 ID of icon Command result code. 0 Command performed successfully. Indicate that the user has accepted the call request 4 Command performed successfully, but requested icon could not be displayed 32 UE is unable to process command currently 48 Command is beyond UE's capabilities Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 2.7.13. Language Notification (53) After receiving the +QSTKURC: 53, you can get information via AT+QSTKGI=53, then respond via AT+QSTKRSP=53,[,]. l Language Notification (53) te Write Command c l AT+QSTKGI=53 Response The response for first line of output: +QSTKGI: 53,, ue tia OK ERROR Q fiden WriteCommand AT+QSTKRSP=53,[,] If error is related to ME functionality: +CME ERROR: Response OK ERROR nIf error is related to ME functionality: Co +CME ERROR: Parameter Details of language notification command Bit 1 0: Non-specific language notification 1: Specific language notification Bit 2-8 RFU Language code string is provided as a pair of alpha-numeric characters, defined in ISO 639. Each alphanumeric character is coded on one byte using the SMS default 7-bit coded alphabet as defined in 3GPP TS 23.038 WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 32 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual Command result code 0 Command performed successfully. Indicate that the user has accepted the call request Optional additional command status; for possible values refer to ETSI TS 102 223. Range is 0-255 CQouneficdteenl tial WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 33 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 3 Examples of STK AT Command 3.1. Enable STK Function and Set up Menu 1. Switch on the module and enable STK function. AT+QSTK=1,1 OK //Enable STK function. l 2. Reset the module and you will receive the URC of the first proactive command, as follow: +QSTKURC: 37 cte l 3. Request menu parameter information and respond to the menu setup proactive command. AT+QSTKGI=37 //Get menu setup proactive command information. ue tia +QSTKURC: 37,0,13,'52A8611F57305E2600530049004D5361',0,0,0,0 +QSTKURC: 37,13,'621176848EAB4EFD8BA48BC1',0,0 +QSTKURC: 37,14,'77ED4FE17FA453D1',0,0 Q n +QSTKURC: 37,17,'4E1A52A163A88350',0,0 e +QSTKURC: 37,1,'00530049004D84254E1A5385',0,0 +QSTKURC: 37,2,'59296C1467E58BE2',0,0 fid +QSTKURC: 37,3,'62117684624B673A62A5',0,0 +QSTKURC: 37,4,'6211768498DE4FE1',0,0 +QSTKURC: 37,5,'621176845F6994C3',0,0 n +QSTKURC: 37,6,'65E07EBF97F34E504FF14E5090E8',0,0 +QSTKURC: 37,7,'003100320035003800304FE1606F67E58BE2',0,0 o +QSTKURC: 37,8,'68218BAF901A',0,0 C +QSTKURC: 37,9,'94F64FE1901A',0,0 +QSTKURC: 37,15,'00530049004D53614FE1606F',0,0 OK AT+QSTKRSP=37,0 OK //Respond to menu setup proactive command. +QSTKURC: 33 //Display text proactive command notification. AT+QSTKGI=33 //Get the displayed text proactive command information. +QSTKURC: 33,1,'6CA19519FF0162115C31662F004D002D005A006F006E00654EBA',0,0,0 WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 34 / 40 OK AT+QSTKRSP=33,0 OK +QSTKURC: 253 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual //Respond to displayed text proactive command. //URC indicates that the proactive session has ended. 3.2. Menu Selection and Set up Call 1. Select menu item. AT+QSTKRSP=253,0,7 OK //Select menu item, ID is 7. 2. Select item. l +QSTKURC: 36 //Select item proactive command notification. te AT+QSTKGI=36 //Get the selected item proactive command information. c l +QSTKURC: 36,0,3,'',0,0,0,0,0 ue tia +QSTKURC: 36,30,'4E1A52A14ECB7ECD',0,0 +QSTKURC: 36,31,'786E8BA462E86253',0,0 +QSTKURC: 36,51,'83DC53557BA17406',0,0 Q n OK e AT+QSTKRSP=36,0,31 fid OK //Respond to the selected item proactive command and the item (ID is 31) is selected. 3. Set up call. n +QSTKURC: 16 Co AT+QSTKGI=16 //Set up call proactive command notification. //Get the call proactive command information which you have set up. +QSTKURC: 16,0,'','12580','',0,0,0,0 OK AT+QSTKRSP=16,0 +QSTKRSP: 16,0 //Respond to the call proactive command. OK +QSTKURC: 253 //URC indicates that the proactive session has ended. WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 35 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 3.3. Select Menu and Send SMS 1. Select menu item. AT+QSTKRSP=253,0,14 OK //Select menu item, ID is 14. 2. Select item and edit SMS. +QSTKURC: 36 //Select item proactive command notification. AT+QSTKGI=36 //Get the selected item proactive command information. +QSTKURC: 36,0,6,'',0,0,0,0,0 +QSTKURC: 36,1,'65B07F1677ED4FE1',0,0 +QSTKURC: 36,2,'5DF2653677ED4FE1',0,0 +QSTKURC: 36,3,'7EC454587BA17406',0,0 l +QSTKURC: 36,4,'589E52A07FA47EC4',0,0 +QSTKURC: 36,5,'7FA47EC46539540D',0,0 te +QSTKURC: 36,6,'522096647FA47EC4',0,0 c l OK ue tia AT+QSTKRSP=36,0,1 OK //Respond to the selected item proactive command and the item (ID is 1) is selected. Q n +QSTKURC: 35 //Get input proactive command notification. e AT+QSTKGI=35 //Get the input proactive command information. +QSTKURC: 35,3,'8F93516551855BB9FF1A',100,1,'',0,0 //Indicate input SMS content. fid OK n AT+QSTKRSP =35,0,'00310038003200320036003600320031003100300036' //Respond to the input proactive command o and input content. C OK +QSTKURC: 36 AT+QSTKGI=36 +QSTKURC: 36,0,3,'',0,0,0,0,0 +QSTKURC: 36,1,'900962E97FA47EC4',0,0 +QSTKURC: 36,2,'900962E953F77801',0,0 +QSTKURC: 36,3,'8F93516553F77801',0,0 OK WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 36 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual AT+QSTKRSP=36,0,3 OK +QSTKURC: 35 AT+QSTKGI=35 +QSTKURC: 35,0,'8F93516553F77801FF1A',16,3,'',0,0 //Indicate input SMS number. OK AT+QSTKRSP =35,0,'00310038003200320036003600320031003100300036' OK +QSTKURC: 36 AT+QSTKGI=36 +QSTKURC: 36,0,3,'',0,0,0,0,0 +QSTKURC: 36,1,'53D1900177ED4FE1',0,0 +QSTKURC: 36,2,'7EE77EED6DFB52A0',0,0 l +QSTKURC: 36,3,'67E5770B63A56536800552178868',0,0 te OK AT+QSTKRSP=36,0,1 c l OK ue tia 3.SendSMS. +QSTKURC: 19 //Send SMS proactive command notification. Q n AT+QSTKGI=19 //Get the sent SMS proactive command information. +QSTKURC: 19,0,'7B2C003000315C01002C65364FE14EBA003A672A547D540D',0,0 fide OK AT+QSTKRSP=19,0 +QSTKRSP: 19,0 //Respond to the SMS proactive command and send SMS. Con OK 3.4. STK Session Termination and Timeout Response 1. Terminate STK session. AT+QSTKRSP=253,0,7 OK +QSTKURC: 36 AT+QSTKGI=36 //Select menu item. ID is 7. //Select item proactive command notification. //Get the selected item proactive command information. WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 37 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual +QSTKURC: 36,0,3,'',0,0,0,0,0 +QSTKURC: 36,30,'4E1A52A14ECB7ECD',0,0 +QSTKURC: 36,31,'786E8BA462E86253',0,0 +QSTKURC: 36,51,'83DC53557BA17406',0,0 OK AT+QSTKRSP=254 OK //Terminate STK session. +QSTKURC: 253 //URC indicates that the proactive session has ended. 2. Timeout response of STK session. AT+QSTKRSP=253,0,7 OK //Select menu item, ID is 7. +QSTKURC: 36 //Select item proactive command notification. l AT+QSTKGI=36 //Get the selected item proactive command information. te +QSTKURC: 36,0,3,'',0,0,0,0,0 +QSTKURC: 36,30,'4E1A52A14ECB7ECD',0,0 c l +QSTKURC: 36,31,'786E8BA462E86253',0,0 +QSTKURC: 36,51,'83DC53557BA17406',0,0 ue tia OK Q n +QSTKURC: 255,36 //Indicate the timeout response of STK session. fide +QSTKURC: 253 //URC indicates that the proactive session has ended and entered into main menu (different SIM cards may have different performances). Con 3.5. Disable STK Function After disabling the STK function, you should reboot the module. AT+QSTK=0 OK //Disable STK function. WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 38 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 4 Appendix 4.1. Reference Table 3: Related Documents SN Document Name [1] 3GPP TS 11.14 l [2] 3GPP TS 11.111 cte l [3] ETSI TS 102 223 Remark Specification of the STK for the Subscriber Identity Module - Mobile Equipment Universal Subscriber Identity Module (USIM) Application Toolkit (USAT) Smart Cards Card Application Toolkit (CAT) ue tia Table 4: Terms and Abbreviations Q n Abbreviation e ME fid TA MS n DTE Co STK Description Mobile Equipment Terminal Adapter Mobile Station Data Terminal Equipment SIM Application Toolkit USAT USIM Application Toolkit URC Unsolicited Result Code SMS Short Message Service RFU Reserved for Future Use WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 39 / 40 UMTS/HSPA Module Series WCDMA UGxx STK AT Commands Manual 4.2. Common Code Table 5: Common Code in STK AT Command Code of 3 4 21 Meaning Operation not allowed Parameters error Invalid index 4.3. Auto Response Timeout Value l Table 6: Proactive Command Auto Response Timeout Value te Proactive Command c l SETUP MENU ue tia SELECTITEM Q n DISPLAYTEXT e GET INKEY fid GET INPUT LANCH BROWSER n SEND SMS Co SEND DTMF Auto Response Timeout (Unit: second) 60 180 180 180 180 180 180 180 SETUP IDLE MODE TEXT 60 SETUP CALL 300 SEND SS 300 SEND USSD 300 PLAY TONE 305 WCDMA_UGxx_STK_AT_Commands_Manual Confidential / Released 40 / 40

WCDMA UGxx SSL AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_SSL_AT_Commands_Manual_V1.2 Date: 2015-04-01 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx SSL 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 1 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual About the Document History Revision 1.0 1.1 1.2 Date 2014-12-13 l 2015-03-03 CQouneficdteential 2015-04-01 Author Chris PENG Jessica GENG Jessica GENG Description Initial 1. Changed the document name from 'UG95' to 'UGxx'. 2. Modified the timeout value of command AT+QSSLCLOSE. Updated applicable modules. WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 2 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. SSL Version and CipherSuite ..................................................................................................... 6 1.2. Procedures of Using SSL Function............................................................................................. 7 1.3. Description of Data Access Mode ............................................................................................... 7 1.4. Time Check for Certificate........................................................................................................... 8 1.5. Open SSL Connection Fails........................................................................................................ 8 2 3 Description of AT Command ............................................................................................................ 10 2.1. AT Command Syntax ................................................................................................................ 10 2.2. Description of AT Command ..................................................................................................... 10 l 2.2.1. AT+QSSLCFG Configure the Parameters of SSL Context......................................... 10 2.2.2. AT+QSSLOPEN Open a SSL Socket to Connect Remote Server ............................. 14 te 2.2.3. AT+QSSLSEND Send Data via SSL Connection........................................................ 15 2.2.4. AT+QSSLRECV Receive Data via SSL Connection ................................................... 16 c l 2.2.5. AT+QSSLCLOSE Close SSL Connection................................................................... 17 ue tia 2.2.6. AT+QSSLSTATE Query the State of SSL Connection................................................17 2.3. URC Description ....................................................................................................................... 18 2.3.1. Notify Received Data ..................................................................................................... 18 Q n 2.3.2. Notify Abnormal Close.................................................................................................... 19 2.3.3. Notify SSL Security Error ............................................................................................... 19 e Example .............................................................................................................................................. 20 fid 3.1. Configure and Activate the PDP Context.................................................................................. 20 3.1.1. Configure Context .......................................................................................................... 20 3.1.2. Activate Context ............................................................................................................. 20 n 3.1.3. Deactivate Context......................................................................................................... 20 3.2. Configure SSL Context ............................................................................................................. 20 o 3.3. SSL Client Works in Buffer Access Mode ................................................................................. 21 C 3.3.1. Set up SSL Connection and Enter into Buffer Access Mode......................................... 21 3.3.2. Send Data in Buffer Access Mode ................................................................................. 21 3.3.3. Receive Data in Buffer Access Mode............................................................................. 21 3.3.4. Close SSL Connection ................................................................................................... 22 3.4. SSL Client Works in Direct Push Mode .................................................................................... 22 3.4.1. Set up SSL Connection and Enter into Direct Push Mode ............................................ 22 3.4.2. Send Data in Direct Push Mode..................................................................................... 22 3.4.3. Receive Data in Direct Push Mode ................................................................................ 23 3.4.4. Close SSL Connection ................................................................................................... 23 3.5. SSL Client Works in Transparent Access Mode ....................................................................... 23 3.5.1. Set up SSL Connection and Send Data in Transparent Access Mode.......................... 23 WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 3 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 3.5.2. 3.5.3. 3.5.4. Send Data in Transparent Access Mode ....................................................................... 23 Receive Data in Transparent Access Mode ................................................................... 24 Close SSL Connection ................................................................................................... 24 4 Appendix A Reference....................................................................................................................... 25 CQouneficdteenl tial WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 4 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual Table Index TABLE 1: SSL VERSION..................................................................................................................................... 6 TABLE 2: SSL CIPHERSUITE............................................................................................................................. 6 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 25 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 25 CQouneficdteenl tial WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 5 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 1 Introduction This document describes how to use the SSL functionality of Quectel standard module. In some cases, in order to ensure communication privacy, the communication between the server and the client should be in an encrypted way. So that it can prevent data from eavesdropping, tampering, or forging during the communication process. The SSL function meets these demands. This document is applicable to UGxx modules. l 1.1. SSL Version and CipherSuite te So far, four SSL versions have been released. They are SSL3.0, TLS1.0, TLS1.1, and TLS1.2. The c l following versions are supported by Quectel modules. ue tia Table1:SSL Version Q n SSL Version e SSL3.0 fid TLS1.0 TLS1.1 n TLS1.2 Co The following table shows the names of the CipherSuites that Quectel module supports. Please refer to RFC 2246 - The TLS Protocol Version 1.0 on the Ciphersuites definitions for details. Table 2: SSL CipherSuite CipherSuite Name 0X0035 0X002F TLS_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 6 / 25 0X0005 0X0004 0X000A 0X003D 0XFFFF UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual TLS_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA256 Support above all ciphersuite 1.2. Procedures of Using SSL Function Step 1: Execute command 'AT+QICSGP' to configure the APN, Username, Password of the context and so on. l Step 2: Execute command 'AT+QIACT' to activate the specified PDP context. After the PDP context is activated, query the local IP address by command 'AT+QILOCIP'. te Step 3: Execute command 'AT+QSSLCFG' to configure the SSL version, ciphersuite, the path of trusted CA Cert and security level for the specified SSL context. c l Step 4: Execute command 'AT+QSSLOPEN' to open SSL client connection, is used to specify SSL context, is used to specify data access mode. ue tia Step 5: After the SSL connection has been established, you can send or receive data via this SSL connection. About how to send and receive data under each access mode, please refer to Chapter 1.3. Q n Step 6: Execute command 'AT+QSSLCLOSE' to close SSL connection. e Step 7: Execute command 'AT+QIDEACT' to deactivate PDP context. fid 1.3. Description of Data Access Mode on The module SSL Connection has three data access modes: buffer access mode, direct push mode, transparent access mode. When you use the command 'AT+QSSLOPEN' to open SSL connection, you C can specify the access mode via . After SSL connection has been established, you can switch the access mode via command 'AT+QISWTMD'. 1. In buffer access mode, you can send data via command 'AT+QSSLSEND', and if the modem has received data from Internet, it will report URC: +QSSLURC: 'recv',, and you can retrieve data via command 'AT+QSSLRECV'. 2. In direct push mode, you can send data via command 'AT+QSSLSEND', and if the module modem has received data from Internet, it will output directly via COM port with following format: +QSSLURC: 'recv',,. WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 7 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 3. In transparent access mode, corresponding port will enter into exclusive mode, and the data received from COM port will be sent to Internet directly, and data received from Internet will be outputted via COM port directly. You can use '+++' or DTR (AT&D1 should be set) to switch to buffer access mode. In transparent access mode, if SSL connection encounters abnormal disconnection, the module modem will report URC: NO CARRIER. 4. Exit from transparent access data mode by '+++' or DTR (AT&D1 should be set). To prevent the '+++' from being misinterpreted as data, it should comply with the following sequence: 1) Do not input any character within 1s before inputting '+++'. 2) Input '+++' during 1s, and no other characters can be inputted during this time. 3) Do not input any character within 1s after '+++' has been inputted. 4) Exit from transparent access mode, return OK. 5. There are two methods to return to transparent access mode: l 1) By AT+QISWTMD. Specify the as 2 by this command. If entering transparent access mode successfully, CONNECT will be returned. te 2) By ATO. ATO will change the access mode of connection which lately exits from transparent access mode. If entering transparent access mode successfully, CONNECT will be returned. If c l there is no connection enters transparent access mode before, ATO will return NO CARRIER. ue tia 1.4. Time Check for Certificate Q en To check whether a certificate is in the period of validity, you must parse the certificate, and compare the local time with the 'Not before' and 'Not after' of the certificate. If the local time is earlier than the time of fid 'Not before' or later than the time of 'Not after', the certificate will be considered expired. When is 0, in order to avoid failure of certificate time check, you must use command Con 'AT+CCLK' to configure the modem time to a validity period of the certificate. 1.5. Open SSL Connection Fails When you fail to open SSL connection, please check the following aspects: 1. Query the status of the specified PDP context by command 'AT+QIACT?' to check whether the specified PDP context is activated. 2. If the address of server is a domain name, please use command 'AT+QIDNSCFG=' to check whether the address of DNS server is valid. Because an invalid DNS server address cannot WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 8 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual convert domain name to IP address. 3. Please check the SSL configuration by command 'AT+QSSLCFG', especially SSL version and ciphersuite, make sure they are supported on server side. If you have configured as 1 or 2, you must upload trusted CA certificate to modem by FILE AT command. If server side has configured 'SSLVerifyClient required', you must upload the client cert and client private key to modem by FILE AT command. For details about certificate time check, please refer to Chapter 1.4. CQouneficdteenl tial WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 9 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 2 Description of AT Command 2.1. AT Command Syntax Test Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. Read Command Write Command l Execution Command AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the GSM engine. uecte tial 2.2. Description of AT Command 2.2.1. AT+QSSLCFG Configure the Parameters of SSL Context Q n This command is used to configure the SSL version, Cipher suites, secure level, CA certificate, client e certificate and client key. These parameters will be used in the handshake procedure. fid is the index of the SSL context. The modules support 6 SSL contexts at most. On the basis of a SSL context, several SSL connections can be established. The settings such as the SSL versions and the Cipher suites are stored in the SSL context, and they will be applied to the new SSL connections n associated with the SSL context. o AT+QSSLCFG Configure the Parameters of SSL Context C Test Command Response AT+QSSLCFG=? +QSSLCFG: 'sslversion',(0-5),(0-4) +QSSLCFG: 'ciphersuite',(0-5),( '0X0035','0X002F','0X0005','0X00 04','0X000A','0X003D','0XFFFF') +QSSLCFG: 'cacert',(0-5), +QSSLCFG: 'clientcert',(0-5), +QSSLCFG: 'clientkey',(0-5), +QSSLCFG: 'seclevel',(0-5),(0-2) +QSSLCFG: 'ignorelocaltime',(0-5),(0,1) WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 10 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual +QSSLCFG: 'negotiatetime',(0-5),(10-300) Configure the version for the AT+QSSLCFG='sslversion',[,] OK Response If is omitted, query the value of 'version' with specified , and response: +QSSLCFG: 'sslversion',, OK Else, set the value of 'version' with specified , and response: Configure the ciphersuites for the l AT+QSSLCFG='ciphersuite',[,] OK or ERROR Response If is omitted, query the value of 'ciphersuite' with specified , and response: +QSSLCFG: 'ciphersuite',, c l OK Que entia Configure the path of CA Cert for the fid AT+QSSLCFG='cacert',[,] Else, set the value of 'ciphersuite' with specified sslctxID, and response: OK or ERROR Response If is omitted, query the value of 'cacert' with specified , and response: +QSSLCFG: 'cacert',, onOK Else, set the value of 'cacert' with specified , and C response: OK or ERROR Configure the path of client Cert for the Response If is omitted, query the value of AT+QSSLCFG='clientcert',[ 'client_cert' with specified , and response: ,] +QSSLCFG: 'clientcert',, OK WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 11 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual Configure the path of client Key for the AT+QSSLCFG='clientkey',[, ] Else, set the value of 'client_cert' with specified , and response: OK or ERROR Response If is omitted, query the value of 'client_key' with specified , and response: +QSSLCFG: 'clientkey',, OK l Configure the security level for the te AT+QSSLCFG='seclevel',[, c l ] Else, set the value of 'clientkey' with specified , and response: OK or ERROR Response If is omitted, query the value of 'seclevel' with specified , and response: +QSSLCFG: 'seclevel',, ue tia OK Q fiden Configure the ignore time check for certification for the n AT+QSSLCFG='ignorelocaltime',[,] Else, set the value of 'seclevel' with specified , and response: OK or ERROR Response If is omitted, query the value of 'ignorelocaltime' with specified , and response: +QSSLCFG: 'ignorelocaltime',, C OK Configure the negotiate timeout for the AT+QSSLCFG='negotiatetime',<sslct Else, set the value of 'ignorelocaltime' with specified , and response: OK or ERROR Response If is omitted, query the value of 'negotiatetimeout' with specified , and response: WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 12 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual xID>[,] +QSSLCFG: 'negotiatetime',, OK Else, set the value of 'negotiatetimeout' with specified , and response: OK or ERROR Parameter Numeric type, SSL context ID, range is 0~5 Numeric type, SSL Version 0 SSL3.0 1 TLS1.0 l 2 TLS1.1 te 3 TLS1.2 4 All version c l String type, SSL Ciphersuite '0X0035' TLS_RSA_WITH_AES_256_CBC_SHA ue tia '0X002F' TLS_RSA_WITH_AES_128_CBC_SHA '0X0005' TLS_RSA_WITH_RC4_128_SHA '0X0004' TLS_RSA_WITH_RC4_128_MD5 Q n '0X000A' TLS_RSA_WITH_3DES_EDE_CBC_SHA '0X003D' TLS_RSA_WITH_AES_256_CBC_SHA256 e '0XFFFF' All support fid Numeric format, indicates how to deal with expired certificate 0 Care time check for certification 1 Ignore time check for certification n String format, the path of the trust CA certificate String format, the path of the client certificate o String format, the path of the client private key C Numeric format, the authentication mode 0 No authentication 1 Manage server authentication 2 Manage server and client authentication if requested by the remote server Numeric format, indicates max timeout used to SSL negotiate stage, value range is 10-300, unit: seconds, default value is 300 WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 13 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 2.2.2. AT+QSSLOPEN Open a SSL Socket to Connect Remote Server AT+QSSLOPEN is used to set up a SSL connection. During the negotiation between the module and the Internet, parameters configured by QSSLCFG will be used in the handshake procedure. After shaking hands with the Internet successfully, the module can send or receive data via this SSL connection. Also the module can set up several SSL connection based on one SSL context. According to description of Chapter 1.2, before executing QSSLOPEN command, you must executing QIACT command to active PDP context. It is suggested to wait 150 seconds for the URC response as '+QSSLOPEN: ,'. If the URC response has not been received in 150 seconds, you could use AT+QSSLCLOSE to close the SSL connection. AT+QSSLOPEN Open a SSL Socket to Connect Remote Server Test Command l AT+QSSLOPEN=? Response +QSSLOPEN: (1-20),(0-5),(0-11),,[,(0-2)] cte l WriteCommand ue tia AT+QSSLOPEN=,,,,[,] OK Response If the is transparent access mode and it is successful to create SSL connection, response: CONNECT Else, response: ERROR Error description can be got via AT+QIGETERROR. fid If the is buffer access mode or direct push mode, response: OK on+QSSLOPEN: , is 0 when service is started successfully, else C is not 0. Maximum Response Time Or ERROR Error description can be got via 'AT+QIGETERROR' 150 seconds, determined by network and WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 14 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual Parameter Numeric type, PDP context ID, range is 1-20 Numeric type, SSL context ID, range is 0-5 Numeric type, socket index, range is 0-11 String type, the address of remote server Numeric type, the listening port of remote server Numeric type, the access mode of SSL connection 0 Buffer access mode 1 Direct push mode 2 Transparent mode Refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual 2.2.3. AT+QSSLSEND Send Data via SSL Connection After the connection is established, the module can send data through the SSL connection. l AT+QSSLSEND Send Data via SSL Connection te Test Command c l AT+QSSLSEND=? Response +QSSLSEND: (0-11)[,(1-1460)] ue tia WriteCommand AT+QSSLSEND= Q n Response '>', then type data to send, tap CTRL+Z to send, tap ESC to cancel fide the operation OK Response > If connection has been established and sending is successful, response: SEND OK nIf connection has been established but sending buffer is full, response: Co SEND FAIL If connection has not been established, abnormally closed, or parameter is incorrect, response: ERROR Write Command Response AT+QSSLSEND=, > Response '>', type data until the data length is equal to If connection has been established and sending is successful, response: WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 15 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual SEND OK If connection has been is full, response: SEND FAIL established but sending buffer If connection has not been established, abnormally closed, or parameter is incorrect, response: ERROR Parameter Numeric type, socket index, range is 0-11 Numeric type, the length of send data, range is 1-1460 2.2.4. AT+QSSLRECV Receive Data via SSL Connection l When you open SSL connection, and specify =0, if the module receives data from the te Internet, it will report URC: +QSSLURC: 'recv',, and you can read data from buffer by AT+QSSLRECV command. uec tial AT+QSSLRECV Receive Data via SSL Connection Test Command AT+QSSLRECV=? Response +QSSLRECV: (0-11),(1-1500) Q en Write Command fid AT+QSSLRECV=, OK Response If the specified connection has received data, response: +QSSLRECV: OK onIf the buffer is empty, directly response: C +QSSLRECV: 0 OK If parameters is not correct or connection is not established, response: ERROR WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 16 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual Parameter Numeric type, socket index, range is 0-11 Numeric type, the length of data will be retrieved, range is 1-1500 Numeric type, the actual data length which is obtained by QSSLRECV The retrieved data 2.2.5. AT+QSSLCLOSE Close SSL Connection Close a SSL connection. If all the SSL connections based on one SSL context have been closed, the module will release the SSL context. AT+QSSLCLOSE Close SSL Connection Test Command AT+QSSLCLOSE=? Response +QSSLCLOSE: (0-11)[,(0-65535)] tel Write Command c l AT+QSSLCLOSE=[,] OK Response If closes successfully, response: OK ue tia If failed to close, response: ERROR Q en Parameter fid Numeric type, socket index, range is 0-11 Numeric type, the timeout value of QSSLCLOSE, range is 0-65535. Unit: s Default value is 10s. If =0, means close immediately Con 2.2.6. AT+QSSLSTATE Query the State of SSL Connection Query the socket connection status. This command can only query the status of SSL connection. AT+QSSLSTATE Query the State of SSL Connection Test Command AT+QSSLSTATE=? Write Command AT+QSSLSTATE= Response OK Response [+QSSLSTATE:,'SSL CLIENT',,,,,,,,,] OK Response [List of (+QSSLSTATE: ,'SSL CLIENT',,,,,,,,,)] OK Parameter Numeric type, socket index, range is 0-11 String type, the address of remote server Numeric type, the port of remote server l Numeric type, the local port te Numeric type, the state of SSL connection 0 'Initial' Connection not established c l 1 'Opening' Client is connecting or server is trying to listen 2 'SSL handshake' SSL handshake ue tia 3 'Connected' Client/incoming connection has been established 4 'Listening' Server is listening 5 'Closing' Connection is closing Q n Numeric type, PDP context ID, range is 1-20 Numeric type, reserved e Numeric type, the access mode of SSL connection fid 0 Buffer access mode 1 Direct push mode 2 Transparent access mode n String type, name of COM port Co Numeric type, SSL Context index, range is 0-5 2.3. URC Description 2.3.1. Notify Received Data Notify received data which comes from peer. Notify Received Data +QSSLURC: 'recv', The URC of SSL data incoming in buffer access mode. You can receive SSL data by AT+QSSLRECV. WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 18 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual +QSSLURC: 'recv',, The URC of SSL data incoming in direct push mode. Parameter Integer type, socket index, range is 0-11 Integer type, the length of actual received data The received data 2.3.2. Notify Abnormal Close Notify that the connection has been disconnected. Lots of reasons can cause this phenomenon, such as the Internet closes the connection or the state of GPRS PDP is deactivated. The of will be 'closing'. Host must execute AT+QSSLCLOSE= to change the l to 'initial'. te Notify Abnormal Close c l +QSSLURC: 'closed', SSL connection is closed. ue tia Parameter Q n Integer type, socket index, range is 0-11 fide 2.3.3. Notify SSL Security Error Notify host encounter security error while transferring data by SSL Connection. n Notify SSL Security Error Co +QSSLURC: 'security',, SSL connection encounter security error. Parameter Socket index, range is 0-11 Security error code 1 Encrypt error 2 Decrypt error 3 Data verify error WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 19 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 3 Example 3.1. Configure and Activate the PDP Context 3.1.1. Configure Context AT+QICSGP=1,1,'UNINET','','',1 OK //Configure context 1, APN is 'UNINET' for China Unicom. l 3.1.2. Activate Context te AT+QIACT=1 c l OK ue tia AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' Q n OK //Activate context 1 //Activate successfully //Query the state of context e 3.1.3. Deactivate Context fid AT+QIDEACT=1 OK //Deactivate context 1 //Deactivate successfully Con 3.2. Configure SSL Context AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,'0X0035' OK AT+QSSLCFG='seclevel',1,1 OK WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 20 / 25 AT+QSSLCFG='cacert',1,'RAM:ca.pem' OK UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 3.3. SSL Client Works in Buffer Access Mode 3.3.1. Set up SSL Connection and Enter into Buffer Access Mode AT+QSSLOPEN=2,1,1,'220.180.239.201',8712,0 OK +QSSLOPEN: 0,0 //Set up SSL connection successfully AT+QSSLSTATE //Query status of all SSL connections +QSSLSTATE: 1,'SSL CLIENT','220.180.239.201',8712,4100,3,1,2,0,'usbmodem',1 l OK te 3.3.2. Send Data in Buffer Access Mode uec tial AT+QSSLSEND=1 > GET /4M.txt HTTP/1.1 > HOST: 220.180.239.201:8011 Q n > > e SEND OK fid AT+QISEND=1,52 > GET /4M.txt HTTP/1.1 > HOST: 220.180.239.201:8011 > n SEND OK //Send changeable length data. //Send fixed length data and the data length is 52 Co 3.3.3. Receive Data in Buffer Access Mode +QSSLURC: 'recv',1 //The 1 received data AT+QSSLRECV=1,1500 //Read data, the length is 1500 +QSSLRECV: 291 //The actual received data length is 291 HTTP/1.1 200 OK Date: Tue, 03 Sep 2013 11:04:13 GMT Server: Apache/2.2.22 (Win32) PHP/5.2.4 mod_ssl/2.2.22 OpenSSL/0.9.8t Last-Modified: Mon, 02 Sep 2013 03:30:38 GMT WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 21 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual ETag: 'f700000001e36d-406538-4e55e322ae3bc' Accept-Ranges: bytes Content-Length: 4220216 Content-Type: text/plain OK AT+QSSLRECV=1,1500 +QSSLRECV: 0 //No Data in buffer OK 3.3.4. Close SSL Connection AT+QSSLCLOSE=1 tel OK //Close a connection whose is 1. Depending on the Network, the maximum response time is 10s. uec tial 3.4. SSL Client Works in Direct Push Mode 3.4.1. Set up SSL Connection and Enter into Direct Push Mode Q en AT+QSSLOPEN= 2,1,1,'220.180.239.201',8712,1 OK fid +QSSLOPEN: 1,0 //Set up SSL connection successfully AT+QSSLSTATE //Query status of all SSL connections n +QSSLSTATE: 1,'SSL CLIENT','220.180.239.201',8712,4100,3,1,2,1,'usbmodem',1 Co OK 3.4.2. Send Data in Direct Push Mode AT+QSSLSEND=1 > GET /4M.txt HTTP/1.1 > HOST: 220.180.239.201:8011 > > SEND OK //Send changeable length data WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 22 / 25 AT+QISEND=1,52 > GET /4M.txt HTTP/1.1 > HOST: 220.180.239.201:8011 > SEND OK UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual //Send fixed length data and the data length is 52 3.4.3. Receive Data in Direct Push Mode +QSSLURC: 'recv',1,291 HTTP/1.1 200 OK Date: Tue, 03 Sep 2013 12:07:19 GMT Server: Apache/2.2.22 (Win32) PHP/5.2.4 mod_ssl/2.2.22 OpenSSL/0.9.8t Last-Modified: Mon, 02 Sep 2013 03:30:38 GMT ETag: 'f700000001e36d-406538-4e55e322ae3bc' Accept-Ranges: bytes l Content-Length: 4220216 Content-Type: text/plain cte l 3.4.4. Close SSL Connection ue tia AT+QSSLCLOSE=1 OK //Close a connection whose is 1. Depending on the Network, the maximum response time is 10s. Q fiden 3.5. SSL Client Works in Transparent Access Mode 3.5.1. Set up SSL Connection and Send Data in Transparent Access Mode on AT+QSSLOPEN= 2,1,1,'220.180.239.201',8712,2 C CONNECT 3.5.2. Send Data in Transparent Access Mode GET /4M.txt HTTP/1.1 HOST: 220.180.239.201:8011 WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 23 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 3.5.3. Receive Data in Transparent Access Mode HTTP/1.1 200 OK Date: Tue, 03 Sep 2013 12:07:19 GMT Server: Apache/2.2.22 (Win32) PHP/5.2.4 mod_ssl/2.2.22 OpenSSL/0.9.8t Last-Modified: Mon, 02 Sep 2013 03:30:38 GMT ETag: 'f700000001e36d-406538-4e55e322ae3bc' Accept-Ranges: bytes Content-Length: 4220216 Content-Type: text/plain 3.5.4. Close SSL Connection AT+QSSLCLOSE=1 CQouneficdteenl tial OK //Close a connection whose is 1. Depending on the Network, the maximum response time is 10s. WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 24 / 25 UMTS/HSPA Module Series WCDMA UGxx SSL AT Commands Manual 4 Appendix A Reference Table 3: Related Documents SN Document Name Remark Digital cellular telecommunications (Phase [1] GSM 07.07 2+); AT command set for GSM Mobile Equipment (ME) [2] GSM 07.10 Support GSM 07.10 multiplexing protocol l Quectel_WCDMA_UGxx_TCPIP_AT_Commands [3] TCPIP AT commands manual _Manual cte l Table 4: Terms and Abbreviations ue tia Abbreviation SSL Q n DTR e DNS Confid PDP Description Security Socket Layer Data Terminal Ready Domain Name Server Packet Data Protocol WCDMA_UGxx_SSL_AT_Commands_Manual Confidential / Released 25 / 25

WCDMA UGxx SMTP AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_SMTP_AT_Commands_Manual_V1.2 Date: 2015-04-01 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx SMTP 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 1 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual About the Document History Revision 1.0 1.1 1.2 Date 2014-12-12 Author Jonathan WEN tel 2015-03-01 Bonnie ZHAO CQouneficdential 2015-04-01 Bonnie ZHAO Description Initial 1. Changed the document name from 'UG95' to 'UGxx'. 2. Modified the of AT+SMTPATT, the maximum size of the file name is 80 bytes. Updated applicable modules. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 2 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 1.1. Introduction about SSL Type ................................................................................................... 5 1.2. The Process of Sending Email ................................................................................................ 5 1.3. Description of Data Mode ........................................................................................................ 7 1.4. Error Handling ......................................................................................................................... 7 1.4.1. Executing SMTP AT Command Fails................................................................................. 7 2 3 4 5 6 1.4.2. PDP Activation Fails........................................................................................................... 7 1.4.3. DNS Parse Fails ................................................................................................................ 8 1.4.4. Error Response of AT+QSMTPPUT .................................................................................. 8 l Description of AT Command .............................................................................................................. 9 2.1. AT+QSMTPCFG SMTP Configuration ................................................................................. 9 te 2.2. AT+QSMTPDST Add or Delete Recipients ........................................................................ 11 2.3. AT+QSMTPSUB Edit the Subject of the Email .................................................................. 13 c l 2.4. AT+QSMTPBODY Edit the Body of the Email.................................................................... 14 ue tia 2.5. AT+QSMTPATT Edit the Attachments of the Email............................................................16 2.6. AT+QSMTPCLR Clear the Content of Email...................................................................... 18 2.7. AT+QSMTPPUT Send Email .............................................................................................. 18 Q n Example .............................................................................................................................................. 20 3.1. Send Email without SSL........................................................................................................ 20 e 3.2. Send Email by SSL ............................................................................................................... 22 fid 3.3. Send Email by STARTTLS .................................................................................................... 23 Summary of Error Codes .................................................................................................................. 25 Summary of SMTP Protocol Error Codes ....................................................................................... 27 Con Appendix A Reference....................................................................................................................... 29 WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 3 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 25 TABLE 2: SUMMARY OF SMTP PROTOCOL ERROR CODES ...................................................................... 27 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 29 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 29 CQouneficdteenl tial WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 4 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 1 Introduction UGxx module provides SMTP application interface for sending e-mails. This document is a reference guide to all the AT commands defined for SMTP. This document is applicable to UGxx modules. 1.1. Introduction about SSL Type l There are three kinds of connections between SMTP client and SMTP server: te  Without SSL c l  SSL  STARTTLS ue tia Since some SMTP servers cannot support connection without SSL, while some can support all of them, you can choose one kind according to your mail service provider. Q n These three kinds of connections can be set by parameter in AT+QSMTPCFG='ssltype'. fide 1. If is 0, it means 'without SSL'. You will not use SSL function and send email by insecure connection. The port of SMTP server depends on mail service provider, usually the port is 25. 2. If is 1, it means 'SSL'. You will send email by SSL/TLS encrypted SMTP, the port of SMTP server depends on mail service provider and usually the port is 465 or 587. n 3. If is 2, it means 'STARTTLS'. You will upgrade the normal insecure connection to secure o connection through STARTTLS function and send the mail data. The port of SMTP server depends C on mail service provider and usually the port is 25, 465 or 587. 1.2. The Process of Sending Email As the module supports SMTP protocol, you can send email easily by SMTP AT command. The general process is as follows: WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 5 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual Step 1: Configure and activate the PDP context. 1) Configure the PDP context parameters , , and other parameters by AT+QICSGP (Please refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual). If QoS settings need to be updated, configure them by the commands AT+CGQMIN, AT+CGEQMIN, AT+CGQREQ, and AT+CGEQREQ. (For more details, please refer to Quectel_WCDMA_UGxx_AT_Commands_Manual). 2) Activate the PDP context by AT+QIACT. 3) Configure the PDP context ID for SMTP by AT+QSMTPCFG='contextid',. Step 2: Configure SMTP server and user account. 1) Configure SSL type by AT+QSMTPCFG='ssltype',. If is SSL or STARTTLS, you should choose a SSL context by AT+QSMTPCFG='sslctxid', and configure the by AT+QSSLCFG='ciphersuite',, (For details, please refer to Quectel_WCDMA_UGxx_SSL_AT_Commands_Manual). 2) Configure SMTP server by AT+QSMTPCFG='smtpserver',,. The and depend on mail service provider. l 3) Configure account information by AT+QSMTPCFG='account',,. 4) Configure sender information by AT+QSMTPCFG='sender',,. te Step 3: Edit the email content. c l 1) Configure the recipient email address by AT+QSMTPDST. ue tia 2) Configure the subject of email by AT+QSMTPSUB. 3) Configure the body of email by AT+QSMTPBODY. 4) Add attachments for the email by AT+QSMTPATT. The attachments can be RAM files. You can upload a file to RAM by AT+QFUPL. (For details, please refer to Quectel_WCDMA_UGxx_ Q n FILE_AT_Commands_Manual). After sending email successfully, you should delete the file by e AT+QFDEL. (Please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). fid Step 4: Send email. Send the email by AT+QSMTPPUT. It will take some time to send the email depending on the total size of attachments and network status. You should wait for '+QSMTPPUT: , n ', which indicates the ending of sending action. o Step 5: Clear the email contents. C AT+QSMTPCLR will clear the email contents configured by Step 3. You should delete the files as attachments by AT+QFDEL (For more details, please refer to Quectel_WCDMA_UGxx_FILE_AT_ Commands_Manual). Then repeat step 3 and 4. Of course, if you would like to change the SMTP server information and user information, step 2 to step 4 can be repeated too. If you have not sent email for a long time, such as 30 minutes or even longer, you should deactivate the PDP context by AT+QIDEACT= (For details, please refer to Quectel_WCDMA_UGxx_TCPIP_AT_ Commands_Manual). WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 6 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 1.3. Description of Data Mode The mode of UGxx module COM port includes AT command mode and data mode. The difference between the two is that in AT command mode, the inputted data via COM port will be treated as AT command, while in data mode, it will be treated as data. You can exit from data mode by '+++' or DTR (AT&D1 should be set). To prevent the '+++' from being misinterpreted as data, it should comply with the following sequences: 1) Do not input any character within 1s or longer before inputting '+++'. 2) Input '+++' within 1s, and no other characters can be inputted during this time. 3) Do not input any character within 1s after '+++' has been inputted. When you execute AT+QSMTPBODY, the module will enter into data mode. All inputted data will be the body of email. If the inputted data reaches the or the time reaches , the l module will exit from data mode automatically. Unless the inputted data is less than the , you can finish editing body by inputting '+++' or changing DTR level from low to high before , te at that situation, you cannot reenter data mode by executing ATO command. uec tial 1.4. Error Handling 1.4.1. Executing SMTP AT Command Fails Q n If you execute SMTP AT command and receive response 'ERROR' from the module, please check if the e SIM card is inserted and AT+CPIN? is in '+CPIN: READY' status. fid 1.4.2. PDP Activation Fails n If you failed to activate PDP context by AT+QIACT command, please check the following aspects: o 1. Query whether the PS domain is attached by AT+CGATT? command, if not, execute AT+CGATT=1 to C attach PS domain. 2. Query the CGREG status by AT+CGREG? and make sure the PS domain is registered to. 3. Query the PDP context parameters by AT+QICSGP command, make sure the APN of specified PDP context is set. 4. Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT command. 5. According to 3GPP Spec, it only supports three PDP contexts activated simultaneously, so you must make sure the number of activated PDP contexts is less than 3. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 7 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual If the result of checking is OK, but the result of executing AT+QIACT command always fails, please reboot the module to resolve this issue. After booting the module, please check the terms mentioned above at least three times and each time at an interval of 10 minutes to avoid frequently rebooting the module. 1.4.3. DNS Parse Fails When executing AT+QSMTPPUT commands, if it responds '+QSMTPPUT: 653,0', please check following aspects: 1. Make sure the domain name of SMTP server is valid. 2. Query the status of PDP context by AT+QIACT? to make sure the specified PDP context is activated successfully. 1.4.4. Error Response of AT+QSMTPPUT l '+QSMTPPUT: , ' will be returned after operating AT+QSMTPPUT. te If is not 0, it indicates the sending is failed, please resend it. If resending is not successful, you should deactivate the PDP context by AT+QIDEACT command, and try again. (Please refer to Chapter c l 1.4.2.) ue tia If the is not 0, it indicates the error code replied from SMTP server. You can check the issue depending on the protocol error code. For example, if is 535 (Authentication failed, refer to Chapter 5), or may be wrong. If is 530 (Access denied, Q n refer to Chapter 5), you may send email too often and the SMTP server rejects to post email. For details, Confide you can refer to the document RFC2821 (Simple Mail Transfer Protocol). WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 8 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 2 Description of AT Command 2.1. AT+QSMTPCFG SMTP Configuration Configure SMTP server, user account and SSL settings. If the Write Command just takes one parameter, it will query the current settings. AT+QSMTPCFG SMTP Configuration Test Command uectel tial AT+QSMTPCFG=? Response +QSMTPCFG: 'account',, +QSMTPCFG: 'sender',, +QSMTPCFG: 'smtpserver',, +QSMTPCFG: 'contextid',(1-20) +QSMTPCFG: 'sslctxid',(0-5) +QSMTPCFG: 'ssltype',(0-2) Q n Write Command AT+QSMTPCFG='account'[,,] OK Response If and are not omitted: OK or +CME ERROR: nElse query the current settings: +QSMTPCFG: 'account',, Co OK Write Command Response AT+QSMTPCFG='sender'[,<sender_ If , are not omitted: name>,] OK or +CME ERROR: Else query the current settings: +QSMTPCFG: 'sender',, WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 9 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual OK Write Command AT+QSMTPCFG='smtpserver'[,,] Response If and are not omitted: OK or +CME ERROR: Else query the current settings: +QSMTPCFG: 'smtpserver',, OK Write Command Response AT+QSMTPCFG='contextid'[,] If is not omitted: OK or +CME ERROR: tel Else query the current settings: +QSMTPCFG: 'contextid', uec tial WriteCommand AT+QSMTPCFG='sslctxid'[,] OK Response If is not omitted: OK or +CME ERROR: fid Else query the current settings: +QSMTPCFG: 'sslctxid', n Write Command o AT+QSMTPCFG='ssltype'[, C ] OK Response If is not omitted: OK or +CME ERROR: Else query the current settings: +QSMTPCFG: 'ssltype', OK WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 10 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual Parameter String type, the user name for the authentication. The maximum size of the parameter is 50 bytes String type, the password for the authentication. The maximum size of the parameter is 50 bytes String type, the email address of the sender. The maximum size of the parameter is 50 bytes String type, the sender’s name that will be shown when the recipients receiving the email. The maximum size of the parameter is 50 bytes String type, the IP address or domain name of the SMTP server. The maximum size of the parameter is 50 bytes tel uec tial Q fiden Integer type, the port of the SMTP server. The default value is 25. It may be different depending on different SMTP server. For details, please query the corresponding mail service provider Integer type, the PDP context ID, the range is 1-20, default value is 1. It should be activated by AT+QIACT before sending email. (For more details, please refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual) Integer type, choose a SSL context ID for SMTP. Range is 0-5, default value is 1. You should configure the SSL context ID by AT+QSSLCFG='ciphersuite', ,. (Please refer to the command AT+QSSLCFG in Quectel_WCDMA_UGxx_SSL_AT_Commands_Manual) Integer type, configure the SSL type, please choose SSL type according to the mail service provider, since some SMTP servers do not support sending email without SSL 0 Without SSL 1 SSL 2 STARTTLS Integer type, indicates the error code of the operation. It is the type of error (For details, please refer to Chapter 4) Con 2.2. AT+QSMTPDST Add or Delete Recipients You can add recipients by AT+QSMTPDST. The maximum number of recipients is 20, including CC recipients and BCC recipients. You can run AT+QSMTPDST=0 to delete all recipients. AT+QSMTPDST Add or Delete Recipients Test Command AT+QSMTPDST=? Response +QSMTPDST: (0,1),(1-3), OK WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 11 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual Read Command AT+QSMTPDST? Write Command AT+QSMTPDST=[,[,]] Response [+QSMTPDST: ,…] OK Response If format is right and it is not sending email: OK or +CME ERROR: Parameter Integer type, indicates to add a recipient or delete a recipient tel uec tial 0 Delete 1 Add Integer type, indicates the type of the recipient 1 Recipient 2 CC recipient 3 BCC recipient String type, the email address of recipient. The maximum size of the parameter is 50 bytes Integer type, indicates the operation error code. It is the type of error (For details, please refer to the Chapter 4) X Q n Example e //Add recipients. AT+QSMTPDST=1,1,'quectel_test@aol.com' fid OK AT+QSMTPDST=1,2,'quectel_test@21cn.com' on OK AT+QSMTPDST? C +QSMTPDST: 1,'quectel_test@aol.com' //Add a recipient and the recipient type is 1 which means recipients. //Add a recipient and the recipient type is 2 which means CC recipients. +QSMTPDST: 2,'quectel_test@21cn.com' OK //Delete all recipients. AT+QSMTPDST=0 OK AT+QSMTPDST? OK //Delete all recipients. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 12 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 2.3. AT+QSMTPSUB Edit the Subject of the Email Edit the subject of the email. If the is not ASCII, the inputted data should be the hex string of the original subject. AT+QSMTPSUB Edit the Subject of the Email Test Command AT+QSMTPSUB=? Response +QSMTPSUB: (0-3), OK Read Command Response AT+QSMTPSUB? +QSMTPSUB: , Write Command tel AT+QSMTPSUB=, OK Response OK or +CME ERROR: c l Parameter ue tia Q fiden Con Integer type, indicates the character set of the subject 0 ASCII 1 UTF-8 2 GB2312 3 BIG5 String type, the subject of the email. If is 0, this string will be the subject of the email. Otherwise, it is formatted as a hex string, e.g. '41' means the hex value 0x41. If the character set is ASCII, the length of is 0-100. If the character set is not ASCII, the length of should be even and the range is 0-200 Integer type, indicates the operation error code. It is the type of error (For details, please refer to Chapter 4) X Example //Add subject for email and the is ASCII. AT+QSMTPSUB=0,'TEST SMTP' OK AT+QSMTPSUB? +QSMTPSUB: 0,'TEST SMTP' //Edit subject and the character set is 0 which means ASCII. //Query the subject of email. OK WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 13 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual //Add subject for email and the is UTF8. '5445535420534D5450' is the hex string of 'TEST SMTP'. AT+QSMTPSUB=1,'5445535420534D5450' OK AT+QSMTPSUB? +QSMTPSUB: 1,'5445535420534D5450' //Edit subject and the character set is 1 which means UTF8. //Query the subject of email. OK 2.4. AT+QSMTPBODY Edit the Body of the Email Edit the body of the email. When you execute AT+QSMTPBODY, the module will enter into data mode. All inputted data will be the body of email. If the inputted data reaches the or the time reaches l , the module will exit from data mode automatically. Unless the inputted data is less than the te , you can finish editing body by inputting '+++' or changing DTR level from low to high before . The maximum size of the email body is 10 Kbytes. The actual body length is the c l inputted data length. ue tia AT+QSMTPBODY Edit the Body of the Email Test Command AT+QSMTPBODY=? Response +QSMTPBODY: (0-3),(1-10240),(1-65535) Q en Read Command fid AT+QSMTPBODY? Write Command AT+QSMTPBODY=,[,] OK Response OK Response If format is right and it is not sending email: CONNECT +QSMTPBODY: OK Else response: +CME ERROR: WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 14 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual Parameter Integer type, indicates the character set of the body 0 ASCII 1 UTF-8 2 GB2312 3 BIG5 Integer type, the specific length of body. If the length of inputted data is less than the specific value , you can exit from data mode by '+++', the actual length of the body is the inputted data length. The range is 1-10240 bytes The actual length of the inputted body Integer type, the maximum time to upload email body from COM port. The unit is second. The range is 1-65535, default value is 90 Integer type, indicates the operation error code. It is the type of error (For details, please refer to Chapter 4) l Example te //Edit email body and the body length is 100bytes. c l AT+QSMTPBODY=0,100,120 ue tia CONNECT Q n +QSMTPBODY: 100 //Edit email body, the character set is 0 which means ASCII, and the maximum input length is 100 bytes and the maximum input time is 120s. //Input 100 bytes data. e OK fid //If the actual inputted data is less than specified length and you want to end the editing of body, you should input '+++'. n AT+QSMTPBODY=0,100,120 Co CONNECT //Edit email body, the character set is 0 which means ASCII, and the maximum input length is 100 bytes and the maximum input time is 120s. //Input '+++'. +QSMTPBODY: 90 OK //If the actual inputted data is less than specified length and the maximum input time expired, the module will end the editing of body automatically. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 15 / 29 AT+QSMTPBODY=0,100,120 CONNECT +QSMTPBODY: 90 OK UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual //Edit email body, the character set is 0 which means ASCII, and the maximum input length is 100 bytes and the maximum input time is 120s. //120s later. 2.5. AT+QSMTPATT Edit the Attachments of the Email The module can add attachments for email by AT+QSMTPATT. When adding an attachment, you should specify the file index. As a result, different attachments should have different file index. The maximum l number of attachments is 10. te The attachments can be RAM files. You can upload a file to RAM by AT+QFUPL (For details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). After sending email successfully, you should c l delete the file by AT+QFDEL (Please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). ue tia The mail service provider may have some restriction on single file size and total size. If you want to delete attachments, you can run AT+QSMTPATT=0 to delete all attachments. AT+QSMTPATT Edit the Attachments of the Email Q n Test Command e AT+QSMTPATT=? Response +QSMTPATT: (0,1),(1-10), fid Read Command n AT+QSMTPATT? OK Response [+QSMTPATT: ,,…] Co Write Command OK Response AT+QSMTPATT=[,,] or +CME ERROR: Parameter Integer type, indicates to add or delete an attachment 0 Delete WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 16 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 1 Add Integer type, the index of the attachment. The range is 1-10 String type, the file name of the attachment to be added. The maximum size of the parameter is 80 bytes. If it must be started with 'RAM:' it will get the specified file in RAM. Integer type, the size of the attachment. The unit is byte Integer type, indicates the operation error code. It is the type of error (For details, please refer to Chapter 4) Example //You can add attachments from RAM After the email is sent, you should delete the file by AT+QFDEL. The detailed example is shown as follows: AT+QFUPL='RAM:test.txt',200,300,1 tel CONNECT c l +QFUPL: 200,707 //Upload a file to RAM, the file will be saved as 'test.txt' and the maximum size of file is 200 bytes. 300 indicates timeout, 1 indicates ACK mode. (Please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual) ue tia OK AT+QFLST='RAM:*' +QFLST: 'RAM:test.txt',200 Q n OK e AT+QSMTPATT=1,1,'RAM:test.txt' fid OK AT+QSMTPATT? +QSMTPATT: 1,'RAM:test.txt',200 //Add an attachment for email and the file index is 1. //Query the attachments. n OK Co //Of course, you can delete all attachments as follows: AT+QSMTPATT=0 //Delete all attachments for email. OK AT+QSMTPATT? //Query the attachments. OK WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 17 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 2.6. AT+QSMTPCLR Clear the Content of Email AT+QSMTPCLR will clear the content of AT+QSMTPDST, AT+QSMTPSUB, AT+QSMTPBODY and AT+QSMTPATT. AT+QSMTPCLR Clear the Content of Email Test Command Response AT+QSMTPCLR=? OK Execute Command Response AT+QSMTPCLR OK or +CME ERROR: Parameter tel Integer type, indicates the operation error code. It is the type of error (For details, please refer to Chapter 4). c l Example ue tia AT+QSMTPCLR OK Q n AT+QSMTPDST? e OK AT+QSMTPSUB? fid +QSMTPSUB: 0,'' OK n AT+QSMTPATT? Co OK //Clear the recipients, subject, body and attachments for email. //Query the recipients of email //Query the subject of email. //Query the attachments of email. 2.7. AT+QSMTPPUT Send Email AT+QSMTPPUT may take some time to complete depending on the total size of attachments and network status. You should not send email again before receiving '+QSMTPPUT: ,', which indicates the ending of sending email. If is not 0, you can resend the email by executing AT+QSMTPPUT= directly. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 18 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual AT+QSMTPPUT Send Email Test Command AT+QSMTPPUT=? Response +QSMTPPUT: (60-65535) Write Command AT+QSMTPPUT= OK Response If format is right and it is not sending email: OK +QSMTPPUT: , or +CME ERROR: Parameter l te uec tial Integer type, the maximum time to send email. The unit is second. The range is 60-65535 Integer type, indicates the error code of sending email. If it is not 0, it is the type of error (For details, please refer to the Chapter 4). If it is 0, it means the operation is successful Integer type, for reference only, indicates the original error code from SMTP server which is defined in SMTP protocol (For details, please refer to Chapter 5). If it is 0, it is invalid Q en Example fid AT+QSMTPPUT=300 OK Con +QSMTPPUT: 0,0 //Send email and the maximum time is 300s. //Send email successfully, If is not 0, you can resend the email by executing AT+QSMTPPUT= directly. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 19 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 3 Example 3.1. Send Email without SSL Send email without SSL, you will not use SSL function and send email by insecure connection. For example: //Step 1: Configure and activate the PDP context. AT+QICSGP=1,1, 'UNINET','','',1 tel OK AT+QIACT=1 c l OK AT+QIACT? ue tia +QIACT: 1,1,1,'10.7.157.1' //Configure PDP context 1, APN is 'UNINET' for China Unicom. //Activate PDP context 1. //Activate successfully. //Query the state of PDP context. OK Q n AT+QSMTPCFG='contextid',1 e OK //Set the PDP context ID as 1. The PDP context ID must be activated first. fid //Step 2: Configure SMTP server and user account. AT+QSMTPCFG='ssltype',0 //Set the SSL type as without SSL for SMTP. You n will not use SSL function and send email by insecure connection. o AT+QSMTPCFG='smtpserver','smtp.aol.com',25 //Set the IP address or domain name and port of C SMTP server. The port of SMTP server depends on mail service provider. OK AT+QSMTPCFG='account','quectel_test@aol.com','aol123456789' //Set username and password. OK AT+QSMTPCFG='sender','quectel_test','quectel_test@aol.com' //Set sender name and sender address. The sender name will be shown when the is email received. OK WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 20 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual //Step 3: Edit the email content. AT+QSMTPDST=1,1,'quectel_test@163.com' OK AT+QSMTPDST=1,2,'quectel_test@21cn.com' OK AT+QSMTPDST? +QSMTPDST: 1,'quectel_test@163.com' +QSMTPDST: 2,'quectel_test@21cn.com' //Add a recipient and the recipient type is 1 which means recipients. //Add a recipient and the recipient type is 2 which means CC recipients. OK AT+QSMTPSUB=0,'TEST SMTP' OK AT+QSMTPSUB? l +QSMTPSUB: 0,'TEST SMTP' te OK c l AT+QSMTPBODY=0,100,120 ue tia CONNECT Q n +QSMTPBODY: 100 e OK fid AT+QFUPL='RAM:smtp.txt',100,200,1 Con CONNECT //Edit subject and the character set is 0 which means ASCII. //Query the subject of email. //Edit email body, the character set is 0 which means ASCII, and the maximum input length is 100 bytes and the maximum input time is 120s. //Upload a file to RAM, the file will be saved as 'smtp.txt' and the maximum size of file is 100 bytes. 200 indicates timeout, 1 indicates ACK mode. (For details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands _Manual). +QFUPL: 100,707 OK AT+QFLST='RAM:*' +QFLST: 'RAM:smtp.txt',100 OK AT+QSMTPATT=1,1,'RAM:smtp.txt' OK //Add an attachment for email and the file index is 1. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 21 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual AT+QSMTPATT? +QSMTPATT: 1, 'RAM:smtp.txt',100 //Query the attachment. OK //Step 4: Send email. AT+QSMTPPUT=300 OK //Send email and the maximum time is 300s. //It may take a few minutes. +QSMTPPUT: 0,0 //Send email successfully. If is not 0, you can resend the email by executing AT+QSMTPPUT= directly. //Step 5: Clear email contents and deactivate PDP context. AT+QSMTPCLR l OK AT+QFDEL='RAM:smtp.txt' te OK //Clear recipients, subject, body and attachments //Delete the file as attachment. c l //You can repeat step 3 and step 4 to send emails. Of course, you can also repeat step 2 to step 4 to send emails ue tia AT+QIDEACT=1 OK //Deactivate the PDP context which is activated for SMTP Q fiden 3.2. Send Email by SSL Send email by SSL, you will send email by SSL/TLS encrypted SMTP, the port of SMTP server depends n on mail service provider and usually the port is 465 or 587. The difference between sending email without SSL is in configuring SMTP server and user account. Co //Configure SSL type. AT+QSMTPCFG='ssltype',1 OK AT+QSMTPCFG='sslctxid',1 OK AT+QSSLCFG='ciphersuite',1,'0xffff' OK AT+QSSLCFG='seclevel',1,0 //Set the SSL type as 1 which means you will send email by SSL. //Choose SSL context 1 for SMTP //Configure SSL cipher suite type as 0xffff, which supports all cipher suite type. //Configure SSL security level as 0, which WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 22 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual OK AT+QSSLCFG='sslversion',1,1 OK means the SSL CA cert is not needed. //Configure SSL version as 1, which means TLS1.0. //Configure SMTP server. AT+QSMTPCFG='smtpserver','smtp.gmail.com',465 //Set SMTP server address and port. OK //As the SMTP server is different, the account information will be different too. As an example, we provide the following information. AT+QSMTPCFG='account','quecteltestmail@gmail.com','yy123456' OK AT+QSMTPCFG='sender','quectel','quecteltestmail@gmail.com' l OK //Set username and password. //Set sender name and sender address. cte l 3.3. Send Email by STARTTLS ue tia Send email by STARTTLS, you will upgrade the normal insecure connection to secure connection through Q n STARTTLS function and send the mail data. The difference between sending email without SSL is configuring SMTP server and user account. The port of SMTP server depends on mail service provider e and usually the port is 25,465 or 587. fid //Configure SSL type. AT+QSMTPCFG='ssltype',2 n OK AT+QSMTPCFG='sslctxid',1 o OK C AT+QSSLCFG='ciphersuite',1,'0xffff' //Set the SSL type as 2, which means you will send email by STARTTLS. //Choose SSL context 1 for SMTP。 //Configure SSL cipher suite type as 0xffff, which supports all cipher suite type. OK AT+QSSLCFG='seclevel',1,0 //Configure SSL security level as 0, which means the SSL CA cert is not needed. OK AT+QSSLCFG='sslversion',1,1 //Configure SSL version as 1, which means TLS1.0. OK //Configure SMTP server. WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 23 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual AT+QSMTPCFG='smtpserver','smtp.gmail.com',25 //Set SMTP server address and port. OK //As the SMTP server is different, the account information will be different as well. As an example, the following information is provided. AT+QSMTPCFG='account','quecteltestmail@gmail.com','yy123456' OK AT+QSMTPCFG='sender','quectel','quecteltestmail@gmail.com' OK //Set username and password. //Set sender name and sender address. CQouneficdteenl tial WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 24 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 4 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The detail about is described in the following table. Table 1: Summary of Error Codes 651 652 653 654 655 656 657 658 659 660 661 Meaning Unknown error l The SMTP service is busy. Such as, uploading body or sending email te Failed to get IP address according to domain name c l Network error. Such as, failed to activate GPRS/CSD context, failed to establish the TCP connection with the SMTP server or failed to send email to the SMTP server, etc. ue tia Unsupported authentication type The connection for the SMTP service is closed by peer. Q en GPRS/CSD context is deactivated fid Timeout No recipient for the SMTP service n Failed to send email Co Failed to open file 662 No enough memory for the attachment 663 Failed to save the attachment 664 The input parameter is wrong 665 SSL authentication fail 666 Service not available, closing transmission channel 667 Requested mail action not taken: mailbox unavailable WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 25 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 668 Requested action aborted: local error in processing 669 Requested action not taken: insufficient system storage 670 Syntax error, command unrecognized 671 Syntax error in parameters or arguments 672 Command not implemented 673 Bad sequence of commands 674 Command parameter not implemented 675 676 677 678 679 680 681 682 does not accept mail (see rfc1846) Access denied l Authentication failed te Requested action not taken: mailbox unavailable c l User not local; please try ue tia Requested mail action aborted: exceeded storage allocation Requested action not taken: mailbox name not allowed CQonfiden Transaction failed WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 26 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 5 Summary of SMTP Protocol Error Codes The protocol error code indicates an error replied from SMTP server. Please refer to RFC2821 (Simple Mail Transfer Protocol). The details about are described in the following table. Table 2: Summary of SMTP Protocol Error Codes l te 421 c l 450 ue tia 451 452 Q n 500 e 501 fid 502 503 n 504 Co 521 Meaning Service not available, closing transmission channel Requested mail action not taken: mailbox unavailable Requested action aborted: local error in processing Requested action not taken: insufficient system storage Syntax error, command unrecognized Syntax error in parameters or arguments Command not implemented Bad sequence of commands Command parameter not implemented does not accept mail (see rfc1846) 530 Access denied 535 Authentication failed 550 Requested action not taken: mailbox unavailable 551 User not local; please try 552 Requested mail action aborted: exceeded storage allocation WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 27 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 553 Requested action not taken: mailbox name not allowed 554 Transaction failed CQouneficdteenl tial WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 28 / 29 UMTS/HSPA Module Series WCDMA UGxx SMTP AT Commands Manual 6 Appendix A Reference Table 3: Related Documents SN Document Name Remark [1] RFC2821 Simple Mail Transfer Protocol [2] RFC3207 SMTP service extension for secure SMTP over transport layer security Quectel_WCDMA_UGxx_TCPIP_AT_Commands_ Introduction on UGxx module TCPIP AT [3] l Manual commands Quectel_WCDMA_UGxx_FILE_AT_Commands_ Introduction on UGxx module file AT te [4] Manual commands c l [5] Quectel_WCDMA_UGxx_AT_Commands_Manual UGxx AT commands sets ue tia Quectel_WCDMA_UGxx_SSL_AT_Commands_ Introduction on UGxx module SSL AT [6] Manual commands Q n Table 4: Terms and Abbreviations e Abbreviation fid SMTP SSL n TLS Co PDP Description Simple Mail Transfer Protocol Security Socket Layer Transport Layer Security Packet Data Protocol CC Carbon Copy BCC Blind Carbon Copy DTR Data Terminal Ready PPP Point-to-Point Protocol DNS Domain Name Server WCDMA_UGxx_SMTP_AT_Commands_Manual Confidential / Released 29 / 29

WCDMA UGxx MMS AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_MMS_AT_Commands_Manual_V1.2 Date: 2015-04-01 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx MMS 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 1 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual About the Document History Revision 1.0 1.1 1.2 Date 2014-12-13 Author Jonathan WEN tel 2015-03-03 Yolanda YAO CQouneficdential 2015-04-01 Yolanda YAO Description Initial 1. Changed the document name from 'UG95' to 'UGxx'. 2. Modified the maximum length of the attachment file name to 80 bytes. 3. Modified the range of to 1-20. Updated applicable modules. WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 2 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 1.1. General Process of Sending MMS Message.............................................................................. 5 1.2. Error Handling ............................................................................................................................. 6 1.2.1. Executing MMS AT Command Fails ................................................................................ 6 1.2.2. PDP Activation Fails ......................................................................................................... 6 1.2.3. Error Response of AT+QMMSEND.................................................................................. 6 2 3 4 5 6 Description of AT Command .............................................................................................................. 7 2.1. AT+QMMSCFG Configure the Parameters of MMS ................................................................ 7 2.2. AT+QMMSEDIT Edit MMS Message ....................................................................................... 9 l 2.2.1. Add the Recipient Address............................................................................................. 11 2.2.2. Add CC Recipient or BCC Recipient ............................................................................. 11 te 2.2.3. Edit the Title of MMS Message ...................................................................................... 12 2.2.4. Add Attachment .............................................................................................................. 12 c l 2.2.5. Clear all the Content of MMS Message ......................................................................... 14 ue tia 2.3. AT+QMMSEND Send MMS Message ................................................................................... 14 Example .............................................................................................................................................. 16 3.1. Send MMS Message................................................................................................................. 16 Q n Summary of Error Codes .................................................................................................................. 20 e Description of HTTP Response Codes ............................................................................................ 22 Confid Appendix A Reference....................................................................................................................... 23 WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 3 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 20 TABLE 2: DESCRIPTION OF HTTP RESPONSE CODE ................................................................................. 22 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 23 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 23 CQouneficdteenl tial WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 4 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 1 Introduction UGxx provides MMS application interface for sending messages including multimedia objects (image, audio, rich text, etc.). This document is a reference guide to all the AT commands defined for MMS. This document is applicable to UGxx modules. 1.1. General Process of Sending MMS Message l Step 1: Configure and activate the PDP context. 1) Configure the PDP context parameters of , , and other te parameters by AT+QICSGP (For more details, please refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual). If QoS settings need to be updated, c l configure them by commands AT+CGQMIN, AT+CGEQMIN, AT+CGQREQ and AT+CGEQREQ ue tia (Please refer to Quectel_WCDMA_UGxx_AT_Commands_Manual). 2) Activate the PDP context by AT+QIACT. 3) Configure the PDP context ID for MMS by AT+QMMSCFG='contextid',. Q n Step 2: Configure the URL and proxy of MMSC. e 1) Configure the URL of MMSC by AT+QMMSCFG='mmsc',. 2) Configure the proxy of MMSC by AT+QMMSCFG='proxy',,. fid Step 3: Configure the sending parameters. Configure the sending parameters by AT+QMMSCFG='sendparam',,,, n ,. o Step 4: Edit the MMS message. C 1) Add recipient address by AT+QMMSEDIT=1,1,. 2) Add CC recipient address by AT+QMMSEDIT=2,1,. 3) Add BCC recipient address by AT+QMMSEDIT=3,1,. 4) Edit the title by AT+QMMSEDIT=4,1,. You should specify the character set as title by AT+QMMSCFG='character ', first. 5) Add attachments by AT+QMMSEDIT=5,1,. The attachments can be RAM files. And you can upload a file to RAM by AT+QFUPL command (Please refer to Quectel_WCDMA_UGxx _FILE_AT_Commands_Manual). After sending MMS message successfully, you should delete the file by AT+QFDEL command (Please refer to Quectel_WCDMA_UGxx_ FILE_AT_Commands_Manual). If the attachment is a text file, you should specify the character WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 5 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual set by AT+QMMSCFG='character', first. Step 5: Send MMS message by AT+QMMSEND=. It may take some time to send MMS message successfully. You should not send MMS message again before '+QMMSEND: ,[,]' which indicates the ending of MMS message sending. Step 6: Clear the content of MMS message by AT+QMMSEDIT=0 and delete the files as attachments by AT+QFDEL (Please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). Step 4 to step 6 can be repeated. And step 2 to step 6 can be repeated too. 1.2. Error Handling 1.2.1. Executing MMS AT Command Fails l If you execute MMS AT command and receive response 'ERROR' from UGxx module, please check if the te SIM card is inserted and CPIN is in '+CPIN: READY' status by executing command 'AT+CPIN?'. c l 1.2.2. PDP Activation Fails ue tia If you failed to activate PDP context by AT+QIACT command, please check the following aspects: Q n 1. Query whether the PS domain is attached by AT+CGATT? command or not. If not, please execute AT+CGATT=1 command to attach PS domain. e 2. Query the PS domain status by AT+CGREG? and make sure the PS domain is registered. fid 3. Query the PDP context parameters by AT+QICSGP command and make sure the APN of specified PDP context is set. 4. Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT. n 5. According to 3GPP specification, it only supports three PDP contexts activated simultaneously, so you must make sure the number of activated PDP contexts is less than 3. Co If the result of checking is OK, but you still fail to activate PDP context by executing AT+QIACT command, please reboot the module to resolve this issue. After booting the module, please check the terms mentioned above at least three times and each time at an interval of 10 minutes to avoid frequently rebooting the module. 1.2.3. Error Response of AT+QMMSEND +QMMSEND: ,[,] will be returned after operating AT+QMMSEND. If is not 0, it indicates the sending is failed, please resend it. If resending is not successfully, you should deactivate the PDP context by AT+QIDEACT command, and try again. (Please refer to Chapter 1.2.2). WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 6 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 2 Description of AT Command 2.1. AT+QMMSCFG Configure the Parameters of MMS You can configure the PDP context ID, MMSC, proxy, character type and sending parameter of MMS by AT+QMMSCFG. AT+QMMSCFG Configure the Parameters of MMS Test Command uectel tial AT+QMMSCFG=? Response +QMMSCFG: 'contextid',(1-20) +QMMSCFG: 'mmsc', +QMMSCFG: 'proxy',,(1-65535) +QMMSCFG: 'character',('ASCII','UTF8','UCS2','GBK') +QMMSCFG: 'sendparam'[, (0-6),(0-3),(0,1),(0,1),(0-2),(0-4)] Q n Write Command AT+QMMSCFG='contextid'[,] OK Response If is not omitted, OK or +CME ERROR: nElse, query the current settings, +QMMSCFG: 'contextid', Co OK Write Command Response AT+QMMSCFG='mmsc'[,] If is not omitted, OK or +CME ERROR: Else, query the current settings, +QMMSCFG: 'mmsc', WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 7 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual OK Write Command AT+QMMSCFG='proxy'[,, ] Response If and are not omitted, OK or +CME ERROR: Else, query the current settings, +QMMSCFG: 'proxy',, OK Write Command Response AT+QMMSCFG='character'[,] If is not omitted, OK or +CME ERROR: tel Else, query the current settings, +QMMSCFG: 'character', uec tial WriteCommand AT+QMMSCFG='sendparam'[,,,,,,] OK Response If ,,,,, are not omitted, OK or +CME ERROR: fid Else, query the current settings, +QMMSCFG: 'sendparam',,,, n,, Co OK Parameter Integer type, PDP context ID, the range is 1-20, default value is 1 String type, the address of MMSC, the maximum length of URL is 100 bytes String type, the IP address of MMS proxy, the maximum length of gateway is 50 bytes Integer type, the port of MMS proxy. The range is 1-65535 String type, indicates the type of character 'ASCII' US-ASCII character set 'UTF8' UTF8 character set WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 8 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 'UCS2' ISO-10646-UCS-2 character set, this needs to specify Big Endian order 'GBK' GBK character set Integer type, the validity period of MMS message 0 1 hour 1 12 hours 2 24 hours 3 2 days 4 1 week 5 Maximum 6 Use the network configuration Integer type, priority 0 Low 1 Normal 2 High 3 Use the network configuration Integer type, whether need to delivery report l 0 No 1 Yes te Integer type, whether need to read report 0 No c l 1 Yes ue tia Integer type, whether to hide address 0 Hide any address 1 Show even BCC address 2 Use the network configuration Q n Integer type, the class of the MMS message e 0 Personal 1 Advertisement fid 2 Informational 3 Auto 4 Use the network configuration Con Integer type, indicates the type of error, please refer to Chapter 4 2.2. AT+QMMSEDIT Edit MMS Message You can add recipient address, edit title and add attachments for MMS message by AT+QMMSEDIT. The character set of title or a text file is specified by AT+QMMSCFG='character',. For example, if the content of a text file uses UTF8 character set, AT+QMMSCFG='character', 'UTF8' must be executed first. WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 9 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual AT+QMMSEDIT Edit MMS Message Test Command AT+QMMSEDIT=? Response +QMMSEDIT: (0-5),(0,1), OK Write Command Delete all content about MMS message, response: AT+QMMSEDIT=0 OK or +CME ERROR: Write Command Query the specified settings of , response: AT+QMMSEDIT= List of [+QMMSEIDT: ,] is not 0 Write Command l AT+QMMSEDIT=,0 cte l WriteCommand Que ntia AT+QMMSEDIT=,1, OK or +CME ERROR: Delete the specified settings of , response: OK or +CME ERROR: Configure the specified settings of , response: OK or +CME ERROR: e Parameter Confid Integer type, operated function 0 Delete all 1 Operate 'TO address' 2 Operate 'CC address' 3 Operate 'BCC address' 4 Operate title 5 Operate file as attachment String type If =1, 2, 3, it is recipient address. The maximum number of 'TO address', 'CC address' and 'BCC address' is 6 respectively. The maximum length of address is 50 bytes If =4, it is the title. The maximum length of title is 200 bytes If=5, it is the file name of attachments. If the file name is started with 'RAM:', the file is from 'RAM'. It is strongly recommended to use RAM file to upload the attachments. The max length of file name is 80 bytes, the maximum number of WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 10 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual attachments is 12, and the maximum size of total attachments is restricted by the operator Integer type, indicates the type of error, please refer to Chapter 4 The following examples show how to edit a MMS message. 2.2.1. Add the Recipient Address //You can add phone number or email address as recipients. The maximum number of recipients address is 6. AT+QMMSEDIT=1,1,'13856122546' //Add a phone number as recipient. OK AT+QMMSEDIT=1,1,'recipient .test@quectel.com' OK AT+QMMSEDIT=1 l +QMMSEDIT: 1,'13856122546' +QMMSEDIT: 1,'recipient.test@quectel.com' //Add an email address as recipient. //Query recipient address. te OK c l //Of course, if you want to delete the recipient address, you can run AT+QMMSEDIT=1,0 as follows: ue tia AT+QMMSEDIT=1,0 OK Q n AT+QMMSEDIT=1 OK //Delete recipient. //Query recipient address. fide 2.2.2. Add CC Recipient or BCC Recipient //Add CC recipient or BCC recipient. The operation is the same as adding recipient address, the n difference is value. For CC recipient, the value is 2, for BCC recipient, it is 3. o AT+QMMSEDIT=2,1,'13856122546' OK C AT+QMMSEDIT=2 //Add a phone number as CC recipient. //Query CC recipient address. +QMMSEDIT: 2,'13856122546' OK //Of course, if you want to delete the CC recipient address, you can run AT+QMMSEDIT=2,0 as follows: AT+QMMSEDIT=2,0 OK AT+QMMSEDIT=2 OK //Delete CC recipient. //Query CC recipient address. WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 11 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 2.2.3. Edit the Title of MMS Message //The character set of title is set by AT+QMMSCFG='character',. If the is 'ASCII', add title as follows: AT+QMMSCFG='character','ASCII' OK AT+QMMSEDIT=4,1,'test UGxx mms' OK AT+QMMSEDIT=4 +QMMSEDIT: 4,'ASCII','test UGxx mms' //Set the charset as 'ASCII'. //Edit the title of MMS message. //Query the title of MMS message. OK //If the is not ASCII, the should be the hex string of the inputted data. AT+QMMSCFG='character','UTF8' //Set the charset as 'UTF8'. l OK AT+QMMSEDIT=4,1,'746573742075633230206D6D73' //Edit the title of MMS message, te'746573742075633230206D6D73' is the hex string of 'test UGxx mms' in UTF8. c l OK ue tia AT+QMMSEDIT=4 //Query the title of MMS message. +QMMSEDIT: 4,'UTF8','746573742075633230206D6D73' Q n OK //Of course, if you want to delete the title, you can run AT+QMMSEDIT=4,0. e AT+QMMSEDIT=4,0 fid OK AT+QMMSEDIT=4 +QMMSEDIT: 4,'UTF8','' //Delete the title of MMS message. //Query the title of MMS message. Con OK 2.2.4. Add Attachment //You can add attachments for MMS message. The attachments can be RAM files. It is strongly recommended to use RAM file to upload the attachments. The maximum number of attachments is 12, and the maximum length of file name is 80 bytes. The total size of attachments may be restricted by the Operator. In the following example, the attachment is a RAM text file: AT+QFUPL='RAM:test_mms.txt',100,200,1 //Upload a file to RAM, the file will be saved as 'test_mms.txt' and the maximum size of file is 100 bytes. 200 indicates timeout, 1 indicates ACK mode. WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 12 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual CONNECT +QFUPL: 100,0 (Please refer to Quectel_WCDMA_UGxx_FILE_AT_ Commands_Manual). OK AT+QFLST='RAM:*' +QFLST: 'RAM:test_mms.txt',100 //Query the file list of RAM. OK AT+QMMSCFG='character','ASCII' //Set the charset as 'ASCII' for 'RAM:test_mms.txt'. OK AT+QMMSEDIT=5,1,'RAM:test_mms.txt' OK AT+QMMSEDIT=5 l +QMMSEDIT: 5,'RAM:test_mms.txt' //Add attachment for MMS message. //Query the attachments. te OK c l //In the following example, the attachment is a RAM JPG file: ue tia AT+QFUPL='RAM:test_pic.jpg',200,300,1 Q en CONNECT fid +QFUPL: 200,0 //Upload a file to RAM, the file will be saved as 'test_pic.jpg' and the maximum size of file is 200 bytes. 300 indicates timeout, 1 indicates ACK mode. (Please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands _Manual). OK n AT+QFLST='RAM:*' +QFLST: 'RAM:test_mms.txt',100 Co +QFLST: 'RAM:test_pic.jpg',200 //Query the file list of RAM. OK AT+QMMSEDIT=5,1,'RAM:test_pic.jpg' //'RAM:test_pic.jpg' is not text file, you need not specify the character set. OK AT+QMMSEDIT=5 //Query the attachments. +QMMSEDIT: 5,'RAM:test_mms.txt' +QMMSEDIT: 5,'RAM:test_pic.jpg' OK WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 13 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual //If you want to delete the attachments, do as follows: AT+QMMSEDIT=5,0 OK AT+QMMSEDIT=5 OK //Delete attachments for MMS message, all attachments will be deleted. //Query the attachments. //After sending MMS message successfully, you should delete the files by AT+QFDEL. AT+QFDEL='RAM:test_mms.txt' //Delete the RAM file. OK AT+QFDEL='RAM:test_pic.jpg' //Delete the RAM file. OK AT+QFLST='RAM:*' OK //Query the file list of RAM. l 2.2.5. Clear all the Content of MMS Message te //AT+QMMSEDIT=0 will delete the recipient, CC recipients, BCC recipients, title and attachments of MMS message. c l AT+QMMSEDIT=0 ue tia OK AT+QMMSEDIT=1 OK Q n AT+QMMSEDIT=2 OK e AT+QMMSEDIT=3 fid OK AT+QMMSEDIT=4 +QMMSEDIT: 4,'ASCII','' //Clear all the content of MMS message. //Query the recipients. //Query the CC recipients. //Query the BCC recipients. //Query the title of MMS message. n OK o AT+QMMSEDIT=5 C OK //Query the attachments. 2.3. AT+QMMSEND Send MMS Message AT+QMMSEND is used to send MMS message. You should not re-execute AT+QMMSEND until '+QMMSEND: ,,' is returned. When the is reached, but the process of sending MMS message has not finished yet, MMS sending will be interrupted. WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 14 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual AT+QMMSEND Send MMS Message Test Command AT+QMMSEND=? Response +QMMSEND: (1-65535) Write Command AT+QMMSEND= OK Response OK +QMMSEND: ,[,] or +CME ERROR: Parameter l te uec tial Integer type, the maximum time to send MMS. The unit is second. The range is 1-65535. If you send MMS successfully, is 0, else indicates the type of error, please refer to Chapter 4 Integer type, the reply code of HTTP, for reference only. For example, 200 indicates HTTP posts data successfully, please refer to Chapter 5 String type, the reply string from MMSC when sending MMS message failed, for reference only Q n Example e AT+QMMSEND=100 OK Confid +QMMSEND: 0,200 //Send MMS message. //Indicate the result of sending MMS message. WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 15 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 3 Example 3.1. Send MMS Message //Step 1: Configure and activate the PDP context. AT+QICSGP=1,1,'UNIWAP','','',1 OK AT+QIACT=1 l OK AT+QIACT? te +QIACT: 1,1,1,'10.7.157.1' //Configure PDP context 1, APN is 'UNIWAP' for China Unicom. //Activate PDP context 1. //Activate successfully. //Query the state of PDP context. c l OK ue tia AT+QMMSCFG='contextid',1 OK Q n AT+QMMSCFG='contextid' +QMMSCFG: 'contextid',1 //Set the PDP context ID as 1. The PDP context ID must be activated first. //Query the PDP context ID. e OK fid //Step 2: Configure the URL and proxy of MMSC. AT+QMMSCFG='mmsc','mmsc.myuni.com' on OK AT+QMMSCFG='mmsc' C +QMMSCFG: 'mmsc','mmsc.myuni.com' //Configure the URL of MMSC, 'mmsc.myuni.com' is for China Unicom. //Query the URL of MMSC. OK AT+QMMSCFG='proxy','10.0.0.172',80 OK AT+QMMSCFG='proxy' +QMMSCFG: 'proxy','10.0.0.172',80 //Configure the proxy address and port of MMSC '10.0.0.172:80' is for China Unicom. //Query the proxy address and port of MMSC. OK WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 16 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual //Step 3: Configure sending parameter. AT+QMMSCFG='sendparam',6,2,0,0,2,4 OK AT+QMMSCFG='sendparam' +QMMSCFG: 'sendparam',6,2,0,0,2,4 //Configure the sending parameters. //Query the sending parameters. OK //Step 4: Edit the MMS message. AT+QMMSEDIT=1,1,'13856122546' //Add a phone number as recipient. OK AT+QMMSEDIT=2,1,'copy.test@quectel.com' //Add an email address as CC recipient. OK AT+QMMSEDIT=3,1,'secret.test@quectel.com' OK AT+QMMSEDIT=1 l +QMMSEDIT: 1,'13856122546' //Add an email address as BCC recipient. //Query recipient address. te OK c l AT+QMMSEDIT=2 +QMMSEDIT: 2,'copy.test@quectel.com' //Query CC recipient address. ue tia OK AT+QMMSEDIT=3 Q n +QMMSEDIT: 3,'secret.test@quectel.com' //Query BCC recipient address. e OK fid AT+QMMSCFG='character','ASCII' OK AT+QMMSEDIT=4,1,'test UGxx mms' OK n AT+QMMSEDIT=4 Co +QMMSEDIT: 4,'ASCII','test UGxx mms' //Configure the character type as ASCII for title. //Edit the title of MMS message. //Query the title of MMS message. OK //Add attachments. AT+QFUPL='RAM:test_ram.txt',100,300,1 CONNECT //Upload a file to RAM, the file will be saved as 'test_ram.txt' and the maximum size of file is 100. 300 indicates timeout, 1 indicates ACK mode. (For more details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_ Manual). WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 17 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual +QFUPL: 100,0 OK AT+QFLST='RAM:*' +QFLST: 'RAM:test_ram.txt',100 //Query the file list of RAM. OK AT+QMMSCFG='character','ASCII' //Configure the character type as ASCII for 'RAM:test_ram.txt'. OK AT+QMMSEDIT=5,1,'RAM:test_ram.txt' OK AT+QMMSEDIT=5 l +QMMSEDIT: 5,'RAM:test_ram.txt' te OK AT+QFUPL='RAM:test_pic.jpg',200,300,1 Quec ntial CONNECT e +QFUPL: 200,0 fid OK AT+QFLST='RAM:*' n +QFLST: 'RAM:test_mms.txt',100 +QFLST: 'RAM:test_pic.jpg',200 Co OK //Add attachment for MMS message, 'test_ram.txt' is RAM file. //Query the attachments. //Upload a file to RAM, the file will be saved as 'test_pic.jpg' and the maximum size of file is 200 bytes. 300 indicates timeout, 1 indicates ACK mode. (For more details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_ Manual). //Query the file list of RAM. AT+QMMSEDIT=5,1,'RAM:test_pic.jpg' //'RAM:test_pic.jpg' is not text file, you do not need to specify the character set. OK AT+QMMSEDIT=5 //Query the attachments. +QMMSEDIT: 5,'RAM:test_mms.txt' +QMMSEDIT: 5,'RAM:test_pic.jpg' OK //Step 5: Send MMS message. WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 18 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual AT+QMMSEND=100 OK //Send MMS message. +QMMSEND: 0,200 //Indicate the result of sending MMS message. //Step 6: Clear the content of MMS message. AT+QMMSEDIT=0 OK AT+QFDEL='RAM:test_ram.txt' OK AT+QFDEL='RAM:test_pic.jpg' OK //Clear the contents of MMS message. //Delete the RAM file. //Delete the RAM file. CQouneficdteenl tial WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 19 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 4 Summary of Error Codes indicates an error related to mobile equipment or network. The details about are described in the following table. Table 1: Summary of Error Codes 751 752 753 754 755 756 757 758 759 760 761 762 Meaning Unknown error l URL length error te URL error c l Proxy type invalid ue tia Proxyaddresserror Invalid parameter Q n Recipient address full e CC recipient address full fid BCC recipient address full Attachments full n File error CoNo recipient 763 File not found 764 MMS busy 765 Server response failed 766 Error response of HTTP post 767 Invalid report of HTTP post 768 Activate PDP fail WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 20 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 769 PDP deactivated 770 Socket create fail 771 Socket connect fail 772 Socket read fail 773 Socket write fail 774 Socket closed 775 Timeout 776 777 Encode data error CQouneficdteenl tial HTTPdecodedataerror WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 21 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 5 Description of HTTP Response Codes The HTTP response error code indicates an error replied from MMSC. Please refer to RFC2616 (Hypertext Transfer Protocol--HTTP/1.1). The details about are described in the following table. Table 2: Description of HTTP Response Code l 200 te 400 403 uec tial 404 409 Q n 411 e 500 Confid 502 Meaning OK Bad request Forbidden Not found Conflict Length required Internal server error Bad gate way WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 22 / 23 UMTS/HSPA Module Series WCDMA UGxx MMS AT Commands Manual 6 Appendix A Reference Table 3: Related Documents SN Document Name Remark Wap MMS protocol standard package [1] Wap-209-mmsencapsulation-20020105-a of documents [2] RFC2616 Hypertext Transfer Protocol--HTTP/1.1 Quectel_WCDMA_UGxx_FILE_AT_Commands_ l [3] Manual Introduction about UGxx FILE AT commands te Quectel_WCDMA_UGxx_TCPIP_AT_Commands_ Introduction about UGxx TCPIP AT [4] Manual commands c l [5] Quectel_WCDMA_UGxx_AT_Commands_Manual UGxx AT commands manual ue tia Table 4: Terms and Abbreviations Q n Abbreviation Description e MMS fid MMSC n HTTP o CC Multimedia Messaging Service Multimedia Messaging Service Center Hypertext Transfer Protocol Carbon Copy C BCC Blind Carbon Copy PDP Packet Data Protocol URL Uniform Resource Locator WCDMA_UGxx_MMS_AT_Commands_Manual Confidential / Released 23 / 23

WCDMA UGxx HTTP AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_HTTP_AT_Commands_Manual_V1.2 Date: 2015-04-01 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx HTTP 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 1 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual About the Document History Revision 1.0 1.1 1.2 Date 2014-12-13 l 2015-03-04 CQouneficdteential 2015-04-01 Author Chris PENG Jessica GENG Jessica GENG Description Initial Changed the document name from 'UG95' to 'UGxx'. Updated applicable modules. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 2 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 1.1. The Process of Using HTTP AT Commands ........................................................................... 5 1.2. Description of HTTP Header ................................................................................................... 6 1.2.1. Customize HTTP Request Header .................................................................................. 6 1.2.2. Output HTTP Response Header...................................................................................... 6 1.3. Description of Data Mode ........................................................................................................ 6 2 3 1.4. Error Handling ......................................................................................................................... 7 1.4.1. Executing HTTP AT Command Fails ............................................................................... 7 1.4.2. PDP Activation Fails ......................................................................................................... 7 1.4.3. DNS Parse Fails............................................................................................................... 8 l 1.4.4. Sending GET/POST Request Fails.................................................................................. 8 te 1.4.5. Reading Response Fails .................................................................................................. 8 Description of AT Command .............................................................................................................. 9 c l 2.1. AT+QHTTPCFG Configure Parameters for HTTP(S) Server............................................... 9 ue tia 2.2. AT+QHTTPURL Set HTTP(S) Server URL ........................................................................ 11 2.3. AT+QHTTPGET Send GET Request to HTTP(S) Server .................................................. 12 2.4. AT+QHTTPPOST Send POST Request to HTTP(S) Server by UART/USB ..................... 14 Q n 2.5. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server by File.......................... 16 2.6. AT+QHTTPREAD Read Response from HTTP(S) Server by UART/USB ........................ 17 e 2.7. AT+QHTTPREADFILE Read Response from HTTP(S) Server by File ............................. 18 fid Example .............................................................................................................................................. 19 3.1. Access HTTP Server ............................................................................................................. 19 3.1.1. Send HTTP GET Request.............................................................................................. 19 n 3.1.2. Send HTTP POST Request ........................................................................................... 20 3.1.2.1. Post Body Obtained from UART/USB .................................................................... 20 o 3.1.2.2. Post Body Obtained from File System ................................................................... 21 C 3.2. Access HTTPS Server .......................................................................................................... 22 3.2.1. Send HTTP GET Request.............................................................................................. 22 3.2.2. Send HTTP POST Request ........................................................................................... 24 3.2.2.1. Post Body Obtained from UART/USB .................................................................... 24 3.2.2.2. Post Body Obtained from File System ................................................................... 25 4 Summary of ERROR Code ................................................................................................................ 27 5 Summary of HTTP Response Code ................................................................................................. 29 6 Appendix A Reference....................................................................................................................... 30 WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 3 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual Table Index TABLE 1: DIFFERENT CODING SCHEMES OF +CME ERROR: ....................................................... 27 TABLE 2: DIFFERENT CODING SCHEMES OF HTTP RESPONSE CODE ................................................... 29 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 30 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 30 CQouneficdteenl tial WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 4 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 1 Introduction The module supports HTTP operation to HTTP(s) Server. This document is a reference guide to all the AT commands defined for UGxx HTTP. This document is applicable to UGxx modules. 1.1. The Process of Using HTTP AT Commands l Through UGxx TCPIP AT command, you can configure PDP context, activate and deactivate PDP context, te query PDP context status (Please refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual), and through UGxx HTTP AT command, you can send HTTP GET/POST request to HTTP server, and c l read HTTP response from HTTP server. The general process is as follows: ue tia Step 1: Configure the , , and other parameters of PDP context by AT+QICSGP. If QoS settings need to be updated, configure them by the commands AT+CGQMIN, AT+CGEQMIN, AT+CGQREQ and AT+CGEQREQ (Please refer to Q n Quectel_WCDMA_UGxx_AT_Commands_Manual). e Step 2: Activate PDP context by AT+QIACT, then the assigned IP address can be queried by AT+QIACT? (Please refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual). fid Step 3: Set PDP context ID by AT+QHTTPCFG command. Step 4: Set SSL context ID by AT+QHTTPCFG command. n Step 5: Configure SSL context parameters by AT+QSSLCFG command (For more details, please refer o to Quectel_WCDMA_UGxx_SSL_AT_Commands_Manual). C Step 6: Set HTTP URL by AT+QHTTPURL command. Step 7: Send HTTP request. AT+QHTTPGET command could be used for sending HTTP GET request, and AT+QHTTPPOST command could be used for sending HTTP POST request. Step 8: Read HTTP response information by AT+QHTTPREAD command. Step 9: Deactivate PDP context by AT+QIDEACT command. (For more details, please refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual). WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 5 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 1.2. Description of HTTP Header 1.2.1. Customize HTTP Request Header HTTP request header is filled by the modem automatically. If you want to customize the HTTP request header, you can set as 1 by AT+QHTTPCFG command, and then input HTTP request header as below: 1. Follow HTTP header syntax. 2. The value of URI in HTTP request line and the 'Host:' header must be in line with the URL configured by AT+QHTTPURL command. 3. The HTTP request header must end with . The following example shows a valid HTTP POST request header: POST/processorder.php HTTP/1.1 l Host: 61.190.19.174:8713 Accept: */* te User-Agent: QUECTEL_MODULE c l Connection: Keep-Alive Content-Type: application/x-www-form-urlencoded ue tia Content-Length: 42 Q n 1.2.2. Output HTTP Response Header e HTTP response header will not be output automatically. If you want to obtain HTTP response header fid information, you can set to 1 by AT+QHTTPCFG command, and the HTTP response header will be output with HTTP response body when you execute AT+QHTTPREAD command. Con 1.3. Description of Data Mode The mode of the COM port includes AT command mode and data mode. The difference between them is as follows: 1) In AT command mode, the data input via COM port will be treated as AT command. 2) In data mode, the data input via COM port will be treated as data. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 6 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual You can exit from data mode by using '+++' or pulling up DTR (AT&D1 should be set). To prevent the '+++' from being misinterpreted as data, it should comply with the following sequence: 1) Do not input any character in 1 second before inputting '+++'. 2) Input '+++' in 1 second, and no other characters can be input during this time. 3) Do not input any character in 1 second after '+++' has been input. When you execute QHTTPURL, QHTTPGET, QHTTPOST and QHTTPREAD, the modem will enter data mode. If you are using '+++' or DTR to make module exit from online data mode, the executing procedure of these command will be interrupted before the executed result is returned, and you can’t reenter online data mode by executing ATO command. 1.4. Error Handling l 1.4.1. Executing HTTP AT Command Fails te If you execute HTTP AT command and receive response 'ERROR' from modem, please check whether the SIM card is inserted and the result of 'AT+CPIN?'? is '+CPIN: READY'. uec tial 1.4.2. PDPActivation Fails If you failed to activate PDP context by AT+QIACT command, please check the following aspects: Q en 1. Query whether the PS domain is attached by AT+CGATT? command. If not, execute AT+CGATT=1 command to attach PS domain. fid 2. Query the PS domain status by AT+CGREG? command and make sure the PS domain has been registered. 3. Query the PDP context parameters by AT+QICSGP command and make sure the APN of specified n PDP context has been set. 4. Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT o command. C 5 The module only supports three PDP contexts activated simultaneously, so you must make sure the amount of activated PDP context is less than 3. If the result of above checking is OK, but the executing of AT+QIACT command still fails, please reboot the modem to resolve this issue. After rebooting the modem, please follow the above checking at least three times and each time at an interval of 10 minutes to avoid frequent rebooting of the module. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 7 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 1.4.3. DNS Parse Fails When executing AT+QHTTPGET, AT+QHTTPPOST and QHTTPPOSTFILE commands, if '+CME ERROR: 714' (714: HTTP DNS error) is returned, please check the following aspects: 1. Make sure the domain name of HTTP server is valid. 2. Query the status of PDP context via AT+QIACT? command to make sure the specified PDP context has been activated successfully. 3. Query the address of DNS server via AT+QIDNSCFG? command to make sure the address of DNS server is not equal to '0.0.0.0'. If the DNS server address is equal to '0.0.0.0', there are two solutions: 1. Reassign a valid DNS server address by AT+QIDNSCFG command. 2. Deactivate the PDP context by AT+QIDEACT command, and re-activate the PDP context via AT+QIACT command. tel 1.4.4. Sending GET/POST Request Fails c l If you receive a failed result during executing AT+QHTTPGET, AT+QHTTPPOST and QHTTPPOSTFILE ue tia command, please check the following aspects: 1. Make sure the URL input via HTTPURL command is valid and can be accessed. 2. Make sure the specified server supports GET/POST command. Q n 3. Make sure the PDP context has been activated successfully. e If the result of above checking is OK, but the executing of AT+QHTTPGET, QHTTPPOST and fid QHTTPPOSTFILE command still fails, please deactivate the PDP context via AT+QIDEACT and reactivate the PDP context via AT+QIACT to resolve this issue. If you encounter failed result during activating the PDP context, please refer to Chapter 1.4.2 to resolve it. Con 1.4.5. Reading Response Fails Before reading response by AT+QHTTPREAD/QHTTPREADFILE command, you should execute AT+QHTTPGET, AT+QHTTPPOST and QHTTPPOSTFILE command and receive the URC information: '+QHTTPGET: [,[,]]'/ '+QHTTPPOST: [,[,]]'. During executing AT+QHTTTPREAD and QHTTPREADFILE command, if you encounter some errors, such as: '+CME ERROR: 717' (717: HTTP read error), please resend HTTP GET/POST request to HTTP server by AT+QHTTPGET, AT+QHTTPPOST and QHTTPPOSTFILE command. If you encounter failed result during sending GET/POST request to HTTP server, please refer to Chapter 1.4.4 to resolve it. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 8 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 2 Description of AT Command 2.1. AT+QHTTPCFG Configure Parameters for HTTP(S) Server AT+QHTTPCFG is used to configure the parameters for HTTP service, including PDP context ID, customizing HTTP request header and outputting HTTP response header and querying SSL settings. If the write command only executes one parameter, it will query the current settings. AT+QHTTPCFG Configure Parameters for HTTP(S) Server l Test Command uecte tial AT+QHTTPCFG=? Response +QHTTPCFG: 'contextid',(1-20) +QHTTPCFG: 'requestheader',(0,1) +QHTTPCFG: 'responseheader',(0,1) +QHTTPCFG: 'sslctxid',(0-5) +QHTTPCFG: 'contenttype',(0-3) Q n Write Command AT+QHTTPCFG='contextid'[,] OK Response If is not omitted: OK or +CME ERROR: nElse, query the current setting: +QHTTPCFG: 'contextid', Co OK Write Command Response AT+QHTTPCFG='requestheader'[,<re If is not omitted: quest_header>] OK or +CME ERROR: Else, query the current setting: +QHTTPCFG: 'requestheader', WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 9 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual OK Write Command AT+QHTTPCFG='responseheader'[,] Response If is not omitted: OK or +CME ERROR: Else, query the current setting: +QHTTPCFG: 'responseheader', OK Write Command Response AT+QHTTPCFG='sslctxid'[, ] If is not omitted: OK or +CME ERROR: tel Else, query the current setting: +QHTTPCFG: 'sslctxid', uec tial ReadCommand Q en AT+QHTTPCFG? OK Response +QHTTPCFG: 'contextid', +QHTTPCFG: 'requestheader', +QHTTPCFG: 'responseheader', +QHTTPCFG: 'sslctxid', +QHTTPCFG: 'contenttype', fid Write Command n AT+QHTTPCFG='contenttype'[,] OK Response If is not omitted: OK or +CME ERROR: Else, query the current setting: +QHTTPCFG: 'contenttype', OK WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 10 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual Parameter Numeric type, indicates PDP context ID, range is 1-20, default value is 1 Numeric type, indicates whether to customize HTTP request header 0 Disable 1 Enable Numeric type, indicates whether to output HTTP response header or not 0 Disable 1 Enable Numeric type, indicates this SSL context ID will be used for HTTP. The range is 0-5, default value is 1. You should configure the SSL parameter by AT+QSSLCFG. (For details, please refer to the command AT+QSSLCFG in tel Quectel_WCDMA_UGxx_SSL_AT_Commands_Manual.) Numeric type, indicates type of HTTP post content 0 application/x-www-from-urlencoded 1 text/plain 2 application/octet-stream 3 multipart/form-data The type of error, please refer to Chapter 4 uec tial 2.2. AT+QHTTPURL Set HTTP(S) Server URL Q n Input URL, you must begin with 'http://' or 'https://'. If the URL begins with 'http://', it indicates you will access a HTTP server. If the URL begins with 'https://', it indicates you will access a HTTPS server. e AT+QHTTPURL Set HTTP(S) Server URL fid Test Command AT+QHTTPURL=? Response +QHTTPURL: (1-700),(1-65535) on Write Command AT+QHTTPURL=[,] OK Response a) If format is right, and it isn’t sending HTTP GET/POST request at present: CONNECT TA switches to the transparent access mode, and the URL can be input. When the total size of the input data reaches , TA will return to command mode and report the following codes: OK If the has reached, but the received length of URL WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 11 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual Read Command AT+QHTTPURL? is less than , TA will return to command mode and report the following code: +CME ERROR: b) If parameter format is not right or other errors occur: +CME ERROR: Response [+QHTTPURL: ] OK Parameter l Numeric type, indicates the length of URL, range is 1-700, unit: byte Numeric type, indicates the maximum time in seconds to input URL, range is 1-65535, default value is 60, unit: second The type of error, please refer to Chapter 4 cte l 2.3. AT+QHTTPGET Send GET Request to HTTP(S) Server ue tia According to the configured parameter in the command AT+QHTTPCFG='request header'[,], the HTTPGET write command has two different formats, the details are Q n shown as below. Please note that if equals to 1, after the command AT+QHTTPGET e has been sent, the CONNECT may be output in 125s to indicate that the connection is successful. If it is not received during this time, the +CME ERROR: will be output. fid After the HTTPGET write command has been sent, it is suggested to wait a specific time (refer to the Maximum Response Time below) after the result code OK is reported for the URC response n '+QHTTPGET: [,[,]]'. o In the URC '+QHTTPGET: [,[,]]', the parameter can C only be reported when equals to 0. If HTTP response header contains 'CONTENT-LENGTH' information, the information will be reported. AT+QHTTPGET Send GET Request to HTTP(S) Server Test Command AT+QHTTPGET=? Response +QHTTPGET: (1-65535),(1-2048),(1-65535) If equals to 0 (disable customize HTTP request OK Response a) If parameter format is right and no other errors occur: WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 12 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual header) AT+QHTTPGET[=] OK When modem has received response from HTTP server, it will report the following URC: +QHTTPGET: [,[,]] b) If parameter format is not right or other errors occur: +CME ERROR: If equals to 1 (enable Response customize HTTP request header) a) If connect HTTP server successfully: AT+QHTTPGET=,[,] Queficdteenl tial MaximumResponseTime TA switches to the transparent access mode, and the HTTP GET request header can be input. When the total size of the input data reaches , TA will return to command mode and report the following codes: OK When modem has received response from HTTP server, it will report the following URC: +QHTTPGET: [,[,]] If the has reached, but the length of received data is less than , TA will return to command mode and report the following code: +CME ERROR: b) If parameter format is not right or other errors occur: +CME ERROR: Determined by on Parameter C Numeric type, the range is 1-65535. The default value is 60, unit: second. It is used to configure the timeout for the HTTP GET response URC '+QHTTPGET: [,,]' to report after the result code OK is returned Numeric type, indicates the length of HTTP request information, including HTTP request header and HTTP request body, range is 1-2048, unit: byte Numeric type, indicates the maximum time in seconds to input HTTP request information, range is 1-65535. The default value is 60, unit: second Please refer to Chapter 4 Please refer to Chapter 5 WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 13 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual Please refer to Chapter 2.1 Numeric type, indicates the length of HTTP response body, unit: byte. 2.4. AT+QHTTPPOST Send POST Request to HTTP(S) Server by UART/USB You can send HTTP POST request via AT+QHTTPPOST command. According to the configured parameter in the command AT+QHTTPCFG='requestheader'[,], the HTTPPOST write command has two different formats, if you set to 0, you should input post body by UART/USB, else if you set to 1, you should input post header and body by UART/USB. After the command AT+QHTTPPOST has been sent, the CONNECT may be output in 125s to indicate l the connection is successful, if it isn’t received during this time, the +CME ERROR: will be output. te It is suggested to wait a specific time (refer to the Maximum Response Time below) after the result code c l OK is reported for the URC response '+QHTTPPOST: [,[,]]'. ue tia AT+QHTTPPOST Send POST Request to HTTP(S) Server by UART/USB Test Command AT+QHTTPPOST=? Response +QHTTPPOST: (1-1024000),(1-65535),(1-65535) Q en If equals to 0 fid (disable customize HTTP request header AT+QHTTPPOST=[,,] OK Response a) If parameter format is right and HTTP server is connected successfully and HTTP request header is sent completely, it will prompt you to input body: CONNECT onTA switches to the transparent access mode, and the HTTP C POST body can be input. When the total size of the input data reaches , TA will return to command mode and report the following codes: OK When modem has received response from HTTP server, it will report the following URC: +QHTTPPOST: [,[,]] If the has reached, but the received length of data is less than , TA will return to command WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 14 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual mode and report the following code: +CME ERROR: If equals to 1 (enable customize HTTP request header) AT+QHTTPPOST=[,,] b) If parameter format is not right or other errors occur: +CME ERROR: Response a) If parameter format is right and HTTP server is connected successfully: CONNECT TA switches to the transparent access mode, and the HTTP POST header and body can be input. When the total size of Queficdteenl tial MaximumResponseTime the input data reaches , TA will return to command mode and report the following codes: OK When modem has received response from HTTP server, it will report the following URC: +QHTTPPOST: [,[,]] If the has reached, but the length of received data is less than , TA will return to command mode and report the following code: +CME ERROR: b) If parameter format is not right or other errors occur: +CME ERROR: Determined by network and Parameter Con Numeric type, if is 0, it indicates the length of post body, and if is 1, it indicates the length of HTTP request information, including HTTP request header and HTTP request body, range is 1-1024000, unit: byte Numeric type, indicates the maximum time in seconds to input post body or HTTP request information, range is 1-65535. The default value is 60, unit: second Numeric type, range is 1-65535. The default value is 60, unit: second. It is used to configure the timeout for the HTTP POST response URC '+QHTTPPOST: [,[,]]' to report after the result code OK is returned Please refer to Chapter 4 WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 15 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual Please refer to Chapter 5 Please refer to Chapter 2.1 Numeric type, indicates the length of HTTP response body, unit: byte 2.5. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server by File You can also send HTTP POST request in file via AT+QHTTPPOSTFILE command. According to the configured parameter in the command AT+QHTTPCFG='requestheader'[,], the file operated through HTTPPOSTFILE command has two different formats, if set to 0, the file in file system will be post body, else if set to 1, the file in file system will be post header and body. l The modem will report information '+QHTTPPOSTFILE: [,[,]]' to indicate the executing result of AT+QHTTPPOSFILE command. The parameter can only te be reported when equals to 0. c l It is suggested to wait a specific time (refer to the Maximum Response Time below) after the result code ue tia OK is reported for the URC response '+QHTTPPOSTFILE: [,[,]]'. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server by File Q n Test Command AT+QHTTPPOSTFILE=? Response +QHTTPPOSTFILE: ,(1-65535) fide Write Command AT+QHTTPPOSTFILE=[,] on If equals to 1, the C specified file must contain HTTP OK Response a) If parameter format is right and HTTP server is connected successfully: OK When modem has received response from HTTP server, it will request header information. report the following URC: +QHTTPPOSTFILE: [,,] Maximum Response Time b) If parameter format is not right or other errors occur: +CME ERROR: Determined by WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 16 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual Parameter String type, file name, the max length of file name is 80, unit: byte Numeric type, the range is 1-65535. The default value is 60, unit: second. It is used to configure the timeout for the HTTP POST response URC '+QHTTPPOSTFILE: [,,]' to report after the result code OK is returned. Please refer to Chapter 4 Please refer to Chapter 5 Please refer to Chapter 2.1 Numeric type, indicates the length of HTTP response body 2.6. AT+QHTTPREAD Read Response from HTTP(S) Server by l UART/USB te After sending HTTP GET/POST request, you can retrieve HTTP response information from HTTP server c l to UART/USB via AT+QHTTPREAD command. Before executing AT+QHTTPREAD command, you must ensure that you have received '+QHTTPGET: [,[,]]', ue tia '+QHTTPPOST:[,[,]]' or '+QHTTPPOSTFILE:[,, ]' information. Q n AT+QHTTPREAD Read Response from HTTP(S) Server by UART/USB Test Command e AT+QHTTPREAD=? Response +QHTTPREAD: (1-65535) fid Write Command Con AT+QHTTPREAD[=] OK Response a) If parameter format is right and read successfully: CONNECT OK +QHTTPREAD: If reaches or other errors occur, but body has not output completely, it will report the following codes: +CME ERROR: b) If parameter format is not right or other errors occur: +CME ERROR: WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 17 / 30 Parameter UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual Numeric type, indicates the maximum interval time between receiving two packets of data. The default value is 60, unit: second Please refer to Chapter 4 2.7. AT+QHTTPREADFILE Read Response from HTTP(S) Server by File After sending HTTP GET/POST request, you can retrieve HTTP response information from HTTP server to file via AT+QHTTPREADFILE command. And before executing AT+QHTTPREADFILE, you must ensure that you have received '+QHTTPGET: [,[,]]', '+QHTTPPOST: [,[,]]' or '+QHTTPPOSTFILE:[,, ]' information. l AT+QHTTPREADFILE Read Response from HTTP(S) Server by File Test Command te AT+QHTTPREADFILE=? Response +QHTTPREADFILE: ,(1-65535),(0,1) uec tial WriteCommand AT+QHTTPREADFILE=[,< Q n wait_time>][,] OK Response OK When body is read over or reached, it will report: +QHTTPREADFILE: fide Parameter n Co Numeric type, it indicates the maximum interval time between receiving two packets data, range is 1-65535. The default value is 60, Unit: second String type, file name, the max length of file name is 80, unit: byte. Numeric type, indicates whether to overwrite file when specified file exists 0 Disable overwrite 1 Enable overwrite Reference Chapter 4 WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 18 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 3 Example 3.1. Access HTTP Server 3.1.1. Send HTTP GET Request Following example shows how to send HTTP GET request with a customer HTTP request header, and how to read HTTP GET response. //How to send HTTP GET response. l AT+QHTTPCFG='contextid',1 te OK AT+QIACT? c l OK ue tia AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK Q n AT+QIACT? e +QIACT: 1,1,1,'10.7.157.1' //Set the PDP context ID as 1. //Query the state of context. //Configure context 1, APN is 'UNINET' for China Unicom. //Activate context 1. //Activate successfully. //Query the state of context. fid OK AT+QHTTPURL=23,80 CONNECT n http://www.sina.com.cn/ o OK C AT+QHTTPGET=80 //Set the URL which will be accessed. //Input URL whose length is 23, note that URL is an example, please input the correct URL in practical test. //Send HTTP GET request and maximum response time is 80s. OK +QHTTPGET: 0,200,631871 //How to read HTTP response. //If HTTP response header contains 'CONTENT-LENGTH' information, the information will be reported. //Solution 1: Read HTTP response information and output by UART. AT+QHTTPREAD=80 //Read HTTP response information and output by UART, the maximum time to wait for HTTP session to closed is 80s. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 19 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual CONNECT HTTP/1.1 200 OK //HTTP response header and body. Content-Type: text/html Vary: Accept-Encoding X-Powered-By: shci_v1.03 Server: nginx Date: Fri, 27 Dec 2014 02:21:43 GMT Last-Modified: Fri, 27 Dec 2014 02:20:01 GMT Expires: Fri, 27 Dec 2014 02:22:43 GMT Cache-Control: max-age=60 Age: 1 Content-Length: 547256 X-Cache: HIT from xd33-85.sina.com.cn OK l +QHTTPREAD: 0 //Read HTTP header and body successfully. te //Solution 2: Read HTTP response information and store it to RAM file. c l AT+QHTTPREADFILE='RAM:1.txt',80,1 ue tia OK //Read HTTP response header and body and store them to 'RAM:1.txt', the maximum time to wait for HTTP session to close is 80s. Q n +QHTTPREADFILE: 0 //HTTP response header and body are stored successfully. fide 3.1.2. Send HTTP POST Request 3.1.2.1. Post Body Obtained from UART/USB on Following example shows how to send HTTP POST request and retrieve post body from UART/USB. In C addition, it also shows how to read HTTP POST response. AT+QHTTPCFG='contextid',1 //Set the PDP context ID as 1. OK AT+QIACT? //Query the state of context. OK AT+QICSGP=1,1,'UNINET','','',1 //Configure context 1, APN is 'UNINET' for China Unicom. OK AT+QIACT=1 //Activate context 1. OK //Activate successfully. AT+QIACT? //Query the state of context. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 20 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual +QIACT: 1,1,1,'172.22.86.226' OK AT+QHTTPURL=59,80 //Set the URL which will be accessed. CONNECT HTTP://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //Input URL whose length is 59, note that URL is an example, please input the correct URL in practical test. OK AT+QHTTPPOST=20,80,80 //Send HTTP POST request, POST body is obtained from UART, maximum input body time is 80s and maximum response time is CONNECT Message=HelloQuectel l OK 80s. //Input post body whose length is 20, note that post body is an example, please input the correct URL in practical test. te +QHTTPPOST: 0,200,177 //If HTTP response header contains 'CONTENT-LENGTH' information, the information will be reported. c l AT+QHTTPREAD=80 //Read HTTP response body and output by UART, the maximum ue tia time to wait for HTTP session to close is 80s. CONNECT Message='HelloQuectel' ASCII:72 Q n 101 108 108 111 81 117 101 99 116 101 108 //Output HTTP response body. e OK fid +QHTTPREAD: 0 //HTTP response body is output successfully. n 3.1.2.2. Post Body Obtained from File System o Following example shows how to send HTTP POST request and retrieve post body from file system. In C addition, it also shows how to store HTTP POST response to file system. AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? //Set the PDP context ID as 1. //Query the state of context. //Configure context 1, APN is 'UNINET' for China Unicom. //Activate context 1. //Activate successfully. //Query the state of context. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 21 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual +QIACT: 1,1,1,' 172.22.86.226' OK AT+QHTTPURL=59,80 //Set the URL which will be accessed. CONNECT HTTP://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //Input URL whose length is 59, note that URL is an example, please input the correct URL in practical test. OK AT+QHTTPPOSTFILE='RAM:2.txt',80 //Send HTTP POST request , POST body is obtained from OK 'RAM:2.txt', and maximum response time is 80s. +QHTTPPOSTFILE: 0,200, 177 //After HTTP POST request is sent successfully, you can execute command AT+QHTTPREAD. AT+QHTTPREADFILE='RAM:3.txt',80,1 //Read HTTP response body and store it to 'RAM:3.txt', l the maximum time to wait for HTTP session to close is 80s. OK te +QHTTPREAD: 0 //HTTP response body is stored successfully. uec tial 3.2. Access HTTPS Server Q n 3.2.1. Send HTTP GET Request e Following example shows how to send HTTP GET request with a customer HTTP request header, and how to read HTTP GET response. fid AT+QHTTPCFG='contextid',1 OK AT+QIACT? n OK o AT+QICSGP=1,1,'UNINET','','',1 OK C AT+QIACT=1 //Set the PDP context ID as 1. //Query the state of context. //Configure context 1, APN is 'UNINET' for China Unicom. //Activate context 1. OK //Activate successfully. AT+QIACT? //Query the state of context. +QIACT: 1,1,1,'10.7.157.1' OK AT+QHTTPCFG='sslctxid',1 OK AT+QSSLCFG='sslversion',1,1 OK //Set the SSL context ID. //Set the SSL version as 1, it means TLsV1.0. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 22 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual AT+QSSLCFG='ciphersuite',1,'0x0005' //Set the SSL ciphersuite as 0x0005, it means RC4-SHA. OK AT+QSSLCFG='seclevel',1,2 //Set the SSL verify level as 2, it means you should upload CA OK Cert, client Cert & client private key by AT+QFUPL command. AT+QSSLCFG='cacert',1,'RAM:cacert.pem' OK AT+QSSLCFG='clientcert',1,'RAM:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'RAM:clientkey.pem' OK AT+QHTTPURL=19,80 //Set the URL which will be accessed. CONNECT https://mail.qq.com/ OK AT+QHTTPGET=80 l OK //Input URL whose length is 19, note that URL is an example, please input the correct URL in practical test. //Send HTTP GET request and maximum response time is 80s. te +QHTTPGET: 0,200,10750 c l //How to read HTTP response. //If HTTP response header contains 'CONTENT-LENGTH' information, the information will be reported. ue tia //Solution 1: Read HTTP response information and output by UART. AT+QHTTPREAD=80 //Read HTTP response information and output by UART, the Q n maximum time to wait for HTTP session to close is 80s. CONNECT e HTTP/1.1 200 OK fid Server: nginx/1.2.7 Date: Fri, 27 Dec 2013 02:38:27 GMT Content-Type: text/html; charset=GB18030 Content-Length: 10750 n Connection: keep-alive o C OK //Solution 2: Read HTTP response information and store it to RAM file. AT+QHTTPREADFILE='RAM:4.txt',80,1 //Read HTTP response body and store it to 'RAM:4.txt', the maximum time to wait for HTTP session to closed is 80s. OK +QHTTPREADFILE: 0 WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 23 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 3.2.2. Send HTTP POST Request 3.2.2.1. Post Body Obtained from UART/USB Following example shows how to send HTTP POST request and retrieve post body from UART/USB. In addition, it also shows how to read HTTP POST response. AT+QHTTPCFG='contextid',1 //Set the PDP context ID as 1. OK AT+QIACT? //Query the state of context. OK AT+QICSGP=1,1,'UNINET','','',1 //Configure context 1, APN is 'UNINET' for China Unicom. OK AT+QIACT=1 OK AT+QIACT? l +QIACT: 1,1,1,'172.22.86.226' //Activate context 1. //Activate successfully. //Query the state of context. te OK c l AT+QHTTPCFG='sslctxid',1 //Set the SSL context ID. OK ue tia AT+QSSLCFG='sslversion',1,1 //Set the SSL version as 1, it means TLsV1.0. OK AT+QSSLCFG='ciphersuite',1,'0x0005' //Set the SSL ciphersuite as 0x0005, it means RC4-SHA. Q n OK AT+QSSLCFG='seclevel',1,2 //Set the SSL verify level as 2, it means you should upload CA e OK Cert, client Cert & client private key by AT+QFUPL command. fid AT+QSSLCFG='cacert',1,'RAM:cacert.pem' OK AT+QSSLCFG='clientcert',1,'RAM:clientcert.pem' OK n AT+QSSLCFG='clientkey',1,'RAM:clientkey.pem' o OK C AT+QHTTPURL=45,80 //Set the URL which will be accessed. CONNECT https://220.180.239.201:8011/processorder.php //Input URL whose length is 45, note that URL is an example, please input the correct URL in practical test. OK AT+QHTTPPOST=48,80,80 //Send HTTP POST request , POST body is obtained from UART, maximum input body time is 80s and maximum response time is 80s. CONNECT Message=1111&Appleqty=2222&Orangeqty=3333&find=1 //Input post body whose length is 48, WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 24 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual note that post body is an example, please input the correct URL in practical test. OK +QHTTPPOST: 0,200,285 //If HTTP response header contains 'CONTENT-LENGTH' information, the information will be reported. AT+QHTTPREAD=80 //Read HTTP response body and output by UART, the maximum time to wait for HTTP session to close is 80s. CONNECT Quectel's Auto Parts - Order Results Quectel's Auto Parts l Order Results Order processed at 02:49, 27th DecemberYour order is as follows: 1111 te message2222 apple3333 orange uec tial OK +QHTTPREAD: 0 //HTTP response body is output successfully. Q en 3.2.2.2. Post Body Obtained from File System fid Following example shows how to send HTTP POST request and retrieve post body from file system. In addition, it also shows how to store HTTP POST response to file system. n AT+QHTTPCFG='contextid',1 OK o AT+QIACT? C OK //Set the PDP context ID as 1. //Query the state of context. AT+QICSGP=1,1,'UNINET','','',1 //Configure context 1, APN is 'UNINET' for China Unicom. OK AT+QIACT=1 //Activate context 1. OK //Activate successfully. AT+QIACT? //Query the state of context. +QIACT: 1,1,1,' 172.22.86.226' OK AT+QHTTPCFG='sslctxid',1 OK //Set the SSL context ID. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 25 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual AT+QSSLCFG='sslversion',1,1 //Set the SSL version as 1, it means TLsV1.0. OK AT+QSSLCFG='ciphersuite',1,'0x0005' //Set the SSL ciphersuite as 0x0005, it means RC4-SHA. OK AT+QSSLCFG='seclevel',1,2 //Set the SSL verify level as 2, it means you should upload CA OK Cert, client Cert & client private key by AT+QFUPL command. AT+QSSLCFG='cacert',1,'RAM:cacert.pem' OK AT+QSSLCFG='clientcert',1,'RAM:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'RAM:clientkey.pem' OK AT+QHTTPURL=45,80 //Set the URL which will be accessed. CONNECT https://220.180.239.201:8011/processorder.php //Input URL whose length is 45, note that URL is an example, please input the correct URL in l practical test. OK te AT+QHTTPPOSTFILE='RAM:5.txt',80 //Send HTTP POST request , POST body is obtained from OK 'RAM:1.txt', and maximum response time is 80s. uec tial +QHTTPPOSTFILE: 0,200, 285 //After HTTP POST request is sent successfully, you can execute command AT+QHTTPREADFILE. AT+QHTTPREADFILE='RAM:6.txt',80,1 //Read HTTP response body and store it to 'RAM:6.txt', the maximum time to wait for HTTP session to close is 80s. Q n OK Confide +QHTTPREADFILE: 0 //HTTP response body is stored successfully. WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 26 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 4 Summary of ERROR Code Table 1: Different Coding Schemes of +CME ERROR: Meaning 0 701 702 703 704 705 706 707 708 709 710 711 712 Operation successfully HTTP unknown error HTTP timeout l HTTP busy te HTTP UART busy c l HTTP no get/post request ue tia HTTPnetworkbusy Q n HTTP network open fail e HTTP network no config fid HTTP network deactive HTTP network error nHTTP URL error CoHTTP empty URL 713 HTTP IP addr error 714 HTTP DNS error 715 HTTP socket create error 716 HTTP socket connect error 717 HTTP socket read error WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 27 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 718 HTTP socket write error 719 HTTP socket close 720 HTTP data encode error 721 HTTP data decode error 722 HTTP read timeout 723 HTTP response fail 724 Incoming call busy 725 726 727 728 729 730 Voice call busy Input timeout l Wait data timeout te Wait HTTP response timeout c l Alloc memory fail CQounefidentia Invalid parameter WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 28 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 5 Summary of HTTP Response Code Table 2: Different Coding Schemes of HTTP Response Code Meaning 200 403 404 409 411 500 OK Forbidden Not found l Conflict te Length required CQouneficdential Internal server error WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 29 / 30 UMTS/HSPA Module Series WCDMA UGxx HTTP AT Commands Manual 6 Appendix A Reference Table 3: Related Documents SN Document Name Remark [1] RFC2616 Hyper Text Transport Protocol Introduction about UGxx TCPIP AT [2] Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual commands lIntroduction about UGxx file AT [3] Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual tecommands [4] Quectel_WCDMA_UGxx_AT_Commands_Manual UGxx AT commands sets uec tial Introduction about UGxx SSL AT [5] Quectel_WCDMA_UGxx_SSL_AT_Commands_Manual commands Q n Table 4: Terms and Abbreviations e Abbreviation fid HTTP n SSL o DTR C PPP Description Hyper Text Transport Protocol Security Socket Layer Data Terminal Ready Point-to-Point Protocol DNS Domain Name Server URL Uniform Resource Locator URI Uniform Resource Identifier WCDMA_UGxx_HTTP_AT_Commands_Manual Confidential / Released 30 / 30

WCDMA UGxx FTP AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_FTP_AT_Commands_Manual_V1.3 Date: 2016-05-05 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx FTP 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 1 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual About the Document History Revision 1.0 1.1 1.2 1.3 Date 2014-12-13 l 2015-03-06 te 2015-04-01 CQouneficdential 2016-05-05 Author Jonathan WEN Jessica GENG Jessica GENG Sophie ZHU Description Initial Changed the document name from 'UG95' to 'UGxx'. Updated applicable modules. Added Error Code 631 WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 2 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. The Process of FTP Operation................................................................................................ 6 1.2. Description of FTPS ................................................................................................................ 7 1.3. Description of Data Mode ........................................................................................................ 8 1.4. Error Handling ......................................................................................................................... 8 1.4.1. Executing FTP AT Command Fails .................................................................................... 8 2 1.4.2. PDP Activation Fails........................................................................................................... 8 1.4.3. DNS Parse Fails ................................................................................................................ 9 1.4.4. Error Response of FTP Server .......................................................................................... 9 l Description of AT Command ............................................................................................................ 10 2.1. AT+QFTPCFG FTP Configurations .................................................................................... 10 te 2.2. AT+QFTPOPEN Login to FTP Server ................................................................................ 13 2.3. AT+QFTPCWD Set the Current Directory on FTP Server ................................................. 14 c l 2.4. AT+QFTPPWD Get the Current Directory on FTP Server ................................................. 14 ue tia 2.5. AT+QFTPPUT Upload a File to FTP Server.......................................................................15 2.6. AT+QFTPGET Download a File from FTP Server.............................................................. 18 2.7. AT+QFTPSIZE Get the File Size on FTP Server ............................................................... 20 Q n 2.8. AT+QFTPDEL Delete the File on FTP Server.................................................................... 21 2.9. AT+QFTPMKDIR Make a Folder on FTP Server ............................................................... 22 e 2.10. AT+QFTPRMDIR Delete an Empty Folder on FTP Server ................................................ 23 2.11. AT+QFTPLIST List Contents of Directory on FTP Server .................................................. 23 fid 2.12. AT+QFTPNLST List File Names of Directory on FTP Server ............................................ 25 2.13. AT+QFTPRENAME Rename a File or Folder on FTP Server ........................................... 27 2.14. AT+QFTPLEN Get the Transferred Data Length ............................................................... 28 n 2.15. AT+QFTPSTAT Get the Status of FTP Service .................................................................. 28 2.16. AT+QFTPCLOSE Logout from FTP Server........................................................................ 29 o 2.17. AT+QFTPMLSD List Standardized File and Directory Information .................................... 30 C 2.18. AT+QFTPMDTM Get the File Modification Time on FTP Server ....................................... 31 3 Example .............................................................................................................................................. 33 3.1. Login to FTP Server .............................................................................................................. 33 3.2. Folder Operation.................................................................................................................... 34 3.3. File Operation ........................................................................................................................ 34 3.4. List File Information or File Names ....................................................................................... 35 3.5. Upload a File to FTP Server.................................................................................................. 36 3.6. Download a File from FTP Server ......................................................................................... 38 3.7. Logout from FTP Server ........................................................................................................ 39 3.8. FTPS Configuration ............................................................................................................... 39 WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 3 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 4 Summary of Error Codes .................................................................................................................. 41 5 Summary of FTP Protocol Error Codes........................................................................................... 43 6 Appendix A Reference....................................................................................................................... 44 CQouneficdteenl tial WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 4 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual Table Index TABLE 1: SUMMARY OF ERROR CODES............................................................................................... 41 TABLE 2: SUMMARY OF FTP PROTOCOL ERROR CODES.................................................................. 43 TABLE 3: RELATED DOCUMENTS .......................................................................................................... 44 TABLE 4: TERMS AND ABBREVIATIONS ................................................................................................ 44 CQouneficdteenl tial WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 5 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 1 Introduction This document is applicable to Quectel UGxx modules. 1.1. The Process of FTP Operation As the module provides FTP protocol, you can operate file and directory on FTP server by these FTP AT commands. The general process is as follows: l Step 1: Configure and activate the PDP context. 1) Configure the PDP context parameters , , and other parameters te by AT+QICSGP (Please refer to Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual). If c l QoS settings need to be updated, configure them by the commands AT+CGQMIN, AT+CGEQMIN, AT+CGQREQ and AT+CGEQREQ (For more details, please refer to ue tia Quectel_WCDMA_UGxx_AT_Commands_Manual). 2) Activate the PDP context by AT+QIACT. 3) Configure the PDP context ID for FTP by AT+QFTPCFG='contextid',. You should Q n activate the PDP context first. e Step 2: Configure FTP service settings. fid 1) Configure account information by AT+QFTPCFG='account',,. 2) Configure file type by AT+QFTPCFG='filetype',. The file type means the transferred data between FTP server and client is binary data or ASCII data. 3) Configure the transfer mode by AT+QFTPCFG='transmode',. The transfer mode n means either the FTP server or client listens to the data connection. o 4) Configure the response timeout value by AT+QFTPCFG='rsptimeout',. C Step 3: Login to FTP server. Login to FTP server by AT+QFTPOPEN=,. And the URC '+QFTPOPEN: 0,0' indicates that login is successful. Step 4: File operation. 1) Set the current directory by AT+QFTPCWD. 2) Upload a file to FTP server. a) You can upload a local file to FTP server by AT+QFTPPUT. The file can be RAM files .You can upload a file to RAM by AT+QFUPL (For more details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). After uploading the file to FTP server WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 6 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual successfully, you can delete the file by AT+QFDEL (For more details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). b) You can upload a file to FTP server from COM port by AT+QFTPPUT too. Then the module will enter into data mode. You can input '+++' to complete the file uploading. 3) Download a file from FTP server. You can download a file from FTP server by AT+QFTPGET. The file can be output to COM port or saved to RAM. If you output the file to COM port, the module will enter into data mode. 4) Get the size of file on FTP server by AT+QFTPSIZE. 5) Get the length of data transferred between FTP server and client by AT+QFTPLEN. 6) Delete a file on FTP server by AT+QFTPDEL. 7) Rename a file on FTP server by AT+QFTPRENAME. Step 5: Directory operation on FTP server. 1) Set the current directory by AT+QFTPCWD. 2) Create a directory by AT+QFTPMKDIR. 3) List the content of a directory by AT+QFTPLIST. l 4) List file names of a directory by AT+QFTPNLST. 5) Rename a directory by AT+QFTPRENMAE. te 6) Delete a directory by AT+QFTPRMDIR. c l Step 6: Close connection with FTP server. ue tia Close the connection with FTP server by AT+QFTPCLOSE, and the URC '+QFTPCLOSE: 0,0' will be reported, it indicates the operation is successful. Step 3 to Step 6 can be repeated. Step 7: Deactivate PDP context. Q n Deactivate the PDP context by AT+QIDEACT= (For more details, please refer to e Quectel_WCDMA_UGxx_TCPIP_AT_Commands_Manual). fid 1.2. Description of FTPS n The module support FTPS client. FTPS means all data from control connection or data connection is o SSL/TLS encrypted. The only difference between FTPS and FTP is the AT+QFTPCFG and C AT+QFTPOPEN command. If module plays as FTPS client, you should do as follows: 1. Run AT+QFTPCFG='ssltype',1 2. Run AT+QFTPCFG='sslctxid', to select a 3. Run AT+QSSLCFG to configure the selected . For more details, please refer to Quectel_WCDMA_UGxx_SSL_AT_Commands_Manual. 4. Log in to FTPS server. The FTPS server has a different port with FTP server, usually the port is 990. Please make it sure by the FTPS server provider. WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 7 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 5. If module logs in FTPS server successfully, all other operations are the same as FTP client. 1.3. Description of Data Mode The mode of the COM port includes AT command mode and data mode. The difference between them is that in AT command mode, the inputted data via COM port will be treated as AT command, while in data mode, it will be treated as data. You can exit from data mode by '+++' or pulling up DTR (AT&D1 should be set). To prevent the '+++' from being misinterpreted as data, it should comply with the following sequence: 1) Do not input any character in 1 second or longer before inputting '+++'. 2) Input '+++' in 1 second, and no other characters can be input during this time. 3) Do not input any character in 1 second after '+++' has been inputted. l When you execute AT+QFTPPUT, AT+QFTPGET, AT+QFTPLIST and AT+QFTPNLST, if the local file te path is 'COM:', which means data will be received from or output to COM port, the module will enter into data mode. You can exit from data mode by inputting '+++' or changing DTR level from low to high. Else, c l you can reenter data mode by executing ATO command when executing AT+QFTPGET, AT+QFTPLIST ue tia and AT+QFTPNLST. You can’t reenter data mode by ATO when executing AT+QFTPPUT. Q n 1.4. Error Handling e 1.4.1. Executing FTP AT Command Fails fid If you execute FTP AT command and receive response 'ERROR' from the module, please check whether the SIM card is inserted and whether the result of AT+CPIN? is '+CPIN: Ready'. on 1.4.2. PDP Activation Fails C If you failed to activate PDP context by AT+QIACT command, please check the following aspects: 1. Query whether the PS domain is attached by AT+CGATT? command, if not, execute AT+CGATT=1 to attach PS domain. 2. Query the CGREG status by AT+CGREG? command and make sure the PS domain has already been registered. 3. Query the PDP context parameters by AT+QICSGP command, make sure the APN of specified PDP context has been set. 4. Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT command. WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 8 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 5. The module only supports three PDP contexts activated simultaneously, so you must make sure the number of activated PDP contexts is less than 3. If the result of checking is OK, but the result of executing AT+QIACT command still fails, please reboot the module to resolve this issue. After rebooting the module, please follow the above checking at least three times and each time at an interval of 10 minutes to avoid frequently rebooting of the module. 1.4.3. DNS Parse Fails When executing AT+QFTPOPEN command, if '+QFTPOPEN: 604,0' is returned, please check the following aspects: 1. Make sure the domain name of FTP server is valid. 2. Query the status of PDP context by executing 'AT+QIACT?' command to make sure the specified PDP context has been activated successfully. l 1.4.4. Error Response of FTP Server te If the in '+QFTPXX: ,' is not 0, it is replied from FTP server. You c l can check the issues depending on the protocol error code. For example, if is 533 (Not ue tia login, refer to Chapter 5), or may be wrong. If is 550 (Request failed, refer to Chapter 5), the file or directory may not exist. For details, you can refer to the document CQonfiden RFC959 (File Transfer Protocol). WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 9 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 2 Description of AT Command 2.1. AT+QFTPCFG FTP Configurations Configure FTP server, user account, file type, transfer mode and context ID. If the Write Command just takes one parameter, it will query the specified information AT+QFTPCFG FTP Configurations Test Command uectel tial AT+QFTPCFG=? Response +QFTPCFG: 'account',, +QFTPCFG: 'filetype',(0,1) +QFTPCFG: 'transmode',(0,1) +QFTPCFG: 'contextid',(1-20) +QFTPCFG: 'rsptimeout',(20-180) +QFTPCFG: 'ssltype',(0,1) +QFTPCFG: 'sslctxid',(0-5) Q n Write Command e AT+QFTPCFG='account'[,,] OK Response If and are not omitted: OK or +CME ERROR: nElse query the current settings: Co +QFTPCFG: 'account',, OK Write Command Response AT+QFTPCFG='filetype'[, If is not omitted: ] OK or +CME ERROR: Else query the current settings: +QFTPCFG: 'filetype', WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 10 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual Write Command AT+QFTPCFG='transmode'[,] OK Response If is not omitted: OK or +CME ERROR: Else query the current settings: +QFTPCFG: 'transmode', OK Write Command AT+QFTPCFG='contextid'[,] Response If is not omitted: OK or +CME ERROR: te Else query the current settings: +QFTPCFG: 'contextid', uec tial WriteCommand AT+QFTPCFG='rsptimeout'[,] OK Response If is not omitted: OK or +CME ERROR: fid Else query the current settings: +QFTPCFG: 'rsptimeout', on Write Command C AT+QFTPCFG='ssltype'[,] OK Response If is not omitted: OK or +CME ERROR: Else query the current settings: +QFTPCFG: 'ssltype', Write Command AT+QFTPCFG='sslctxid'[, OK Response If is not omitted: WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 11 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual ] OK or +CME ERROR: Else query the current settings: +QFTPCFG: 'sslctxid', OK Parameter String type, the user name for the authentication. The maximum size of the parameter is 50 bytes String type, the password for the authentication. The maximum size of the parameter is 50 bytes Integer type, the PDP context ID, the range is 1-20. It should be activated by l AT+QIACT before QFTPOPEN. For details, please refer to Quectel_WCDMA_ te UGxx_TCPIP_AT_Commands_Manual Integer type, indicates the type of transferred data is ASCII or binary data c l 0 Binary 1 ASCII ue tia Integer type, indicates whether the FTP server or client listens to data connection 0 Active mode, module will listen to data connection 1 Passive mode, FTP server will listen to data connection Q n Integer type, the range is 20-180, the unit is second, and the default value is 90s. Generally, it is the timeout value for most +QFTPXXX: xx,xx after the result code e OK is returned, except the commands QFTPPUT/QFTPGET/QFTPLST/ fid QFTPNLST. The rules for these four commands are shown as below: 1) When the command has been sent, but 'CONNECT' has not been output yet, this parameter indicates the maximum interval time for 'CONNECT' n outputting after the command has been sent 2) When the module has entered into data mode, this parameter indicates the omaximum interval time between two packets of received/transmitted data C3) When the is not 'COM:', it indicates the maximum interval time between two packets of received/transmitted data Integer type, indicates the module plays as FTP client or FTPS client 0 FTP client 1 FTPS client Integer type, indicates the SSL context ID. The range is 0-5. It should be configured by AT+QSSLCFG, for more details, please refer to Quectel_WCDMA_ UGxx _SSL_AT_Commands_Manual. Integer type, indicates the error code of the operation. It is the type of error (Please refer to the Chapter 4) WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 12 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 2.2. AT+QFTPOPEN Login to FTP Server This command is used to login to FTP server. You should activate the PDP context by AT+QIACT first. '+QFTPOPEN: ,' indicates the result of QFTPOPEN and it should be output in set by AT+QFTPCFG. AT+QFTPOPEN Login to FTP Server Test Command AT+QFTPOPEN=? Response +QFTPOPEN: , OK Write Command AT+QFTPOPEN=[, l ] Response OK +QFTPOPEN: , or +CME ERROR: cte l Parameter ue tia Q n fide String type, the IP address or domain name of the FTP server. The maximum size of the parameter is 50 bytes Integer type, the port of the FTP server. The default value is 21 Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless n Example o AT+QFTPOPEN='quectel.3322.org',21 C OK //Login to FTP server +QFTPOPEN: 0,0 WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 13 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 2.3. AT+QFTPCWD Set the Current Directory on FTP Server Set the current directory on FTP server. If OK is returned, '+QFTPCWD: ,' should be output in set by AT+QFTPCFG. All the files and directory operation will be set in the current directory. AT+QFTPCWD Set the Current Directory on FTP Server Test Command AT+QFTPCWD=? Response +QFTPCWD: OK Write Command l AT+QFTPCWD= Response OK +QFTPCWD: , or +CME ERROR: cte l Parameter ue tia Q fiden String type, a directory path on FTP server. The maximum size of the parameter is 100 bytes. The root path of FTP server is '/' Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless n 2.4. AT+QFTPPWD Get the Current Directory on FTP Server Co Get the current directory on FTP server. If OK is returned, '+QFTPPWD: 0,' or '+QFTPPWD: ,' should be output in set by AT+QFTPCFG. AT+QFTPPWD Get the Current Directory on FTP Server Test Command AT+QFTPPWD=? Execute Command AT+QFTPPWD Response OK Response OK If successfully get the current directory: WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 14 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual +QFTPPWD: 0, Else fail to get current directory: +QFTPPWD: , or +CME ERROR: Parameter String type, a directory path on FTP server. The root path of FTP server is '/' Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless tel 2.5. AT+QFTPPUT Upload a File to FTP Server c l Upload file to FTP server. The file data can be uploaded from COM port, and the module will enter into ue tia data mode, you may input '+++' to abort the file uploading. You can also upload a local file to FTP server. The file can be RAM file. You can upload a file to RAM by AT+QFUPL (For details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). And then use QFTPPUT command to upload it Q n to FTP server, after uploading file successfully, you can delete the file by AT+QFDEL (For details, please e refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). fid You can upload a file from specified file position by the parameter. If the is 'COM:', 'CONNECT' should be output in set by AT+QFTPCFG. If the is not 'COM:', 'OK' will be output first, +QFTPPUT: 0, will be output after data being transferred n completely. o If the module has entered data mode, the set by AT+QFTPCFG indicates the maximum interval C time between two packets of received/transmitted data. If the is not 'COM:', the set by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPPUT Upload a File to FTP Server Test Command AT+QFTPPUT=? Response +QFTPPUT: ,,,, WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 15 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual OK Write Command AT+QFTPPUT=,'COM:'[,[,,]] Response CONNECT OK If successfully upload the data: +QFTPPUT: 0, Else fail to upload the data: +QFTPPUT: , Write Command AT+QFTPPUT=,[,] te is not 'COM:' or +CME ERROR: Response OK If successfully upload the data: +QFTPPUT: 0,< transferlen> c l Else fail to upload the data: ue tia +QFTPPUT: , or +CME ERROR: Q n Parameter fide Con String type, the file name in FTP server. The maximum size of the parameter is 50 bytes String type, the local file name. The maximum size of the parameter is 60 bytes. If it is 'COM:', the file data will be input from COM port If it starts with 'RAM:', the file is from RAM. After being uploaded successfully, you should delete the file by AT+QFDEL (For details, please refer to Quectel_ WCDMA_UGxx_FILE_AT_Commands_Manual) Integer type, the start position of file to be put. The default value is 0. If the and is specified, the should be consequent for uploading data to the same file Integer type, length of data to be uploaded. It is valid only if is 'COM:'. When data from COM reached , module will exit from data mode Integer type, indicates whether it is the last packet of data to be uploaded 0 Not the last packet of data, when data reached , module will exit from data mode, '+QFTPPUT: 0,' will be output, but not close data connection, so you can continue to upload data to the same file on FTP WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 16 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 1 The last packet of data, when data reached , module will exit from data mode and close data connection, '+QFTPPUT: 0,' will be output Integer type, length of successfully transferred data Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless Example //Upload a file from COM port to FTP server. AT+QFTPPUT='test.txt', 'COM:',0 CONNECT l te OK //All data will be saved as 'test.txt' in FTP server. c l +QFTPPUT: 0,1000 ue tia //Upload a file from COM to FTP server twice, each time in 1024 bytes. AT+QFTPPUT='test.txt', 'COM:',0,1024,0 CONNECT Q n OK //It is not the last 1024 bytes of 'test.txt'. //Data length reaches 1024. fide +QFTPPUT: 0,1024 AT+QFTPPUT='test.txt', 'COM:',1024,1024,1 //It is the last 1024 bytes of 'test.txt'. CONNECT n OK //Data length reaches 1024. Co +QFTPPUT: 0,1024 //Upload a file from RAM to FTP server. AT+QFUPL='RAM:test1.txt',1000,300,1 CONNECT +QFUPL: 1000,707 //Upload a file to RAM, the file will be saved as 'test1.txt' and the maximum size of file is 1000. 300 indicates timeout, 1 indicates ACK mode. (Please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual). WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 17 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual OK AT+QFLST='RAM:*' +QFLST: 'RAM:test1.txt',1000 OK AT+QFTPPUT='test.txt', 'RAM:test1.txt',0 OK //Upload 'RAM:test1.txt' to FTP server and save it as 'test.txt' on FTP server. +QFTPPUT: 0,1000 AT+QFTPDEL='test.txt' OK +QFTPDEL: 0,0 tel 2.6. AT+QFTPGET Download a File from FTP Server c l Download a file from FTP server. You can output the file to COM port by ue tia AT+QFTPGET='filename','COM:'. The module will enter data mode on receiving data from server. After data is transferred completely, the module will exit from data mode automatically and output 'QFTPGET: 0,'. You can save the file to RAM by AT+QFTPGET='filename','RAM:localname'. After file Q n being transferred completely, the module will output '+QFTPGET: 0,'. e If the is 'COM:', 'CONNECT' should be output in set by AT+QFTPCFG. If the is not 'COM:', 'OK' will be output first, '+QFTPGET: 0,' will be output after fid data being transferred completely. If the module has entered data mode, the set by AT+QFTPCFG indicates the maximum interval n time between two packets of received/transmitted data. If the is not 'COM:', the set by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted Co data. AT+QFTPGET Get a File from FTP Server Test Command AT+QFTPGET=? Response +QFTPGET: ,,, Write Command AT+QFTPGET=,'COM:'[, [,]] OK Response CONNECT WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 18 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual OK If successfully download the file: +QFTPGET: 0, Else fail to download the file: +QFTPGET: , or +CME ERROR: Write Command Response AT+QFTPGET=,[,] tel is not 'COM:' If successfully download the file: +QFTPGET: 0, Else fail to download the file: +QFTPGET: , or +CME ERROR: c l Parameter ue tia Q n fide Con String type, the file name in FTP server. The maximum size of the parameter is 50 bytes String type, the local file name. The maximum size of the parameter is 60 bytes. If it is 'COM:', the file data will be output to COM port. If it starts with 'RAM:', the file will be saved to RAM. It is strongly recommended to save the file in RAM. Then you can read the file by AT+QFREAD (For details, please refer to Quectel_WCDMA_UGxx_ FILE_AT_Commands_Manual) Integer type, the start position of file to get. The default value is 0 Integer type, the data length to download. It is valid only if is 'COM:'. If this parameter is specified, module will output bytes to COM and exit from data mode. You can continue to get data from by the same AT command if there is data left Integer type, the actually transferred data length. If it is less than , it means the whole file is transferred completely Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 19 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual Example //Download a file and output to COM port. AT+QFTPGET='test.txt', 'COM:',0 CONNECT OK +QFTPGET: 0,1000 //Download a file and output to COM port twice, each time in 500 bytes. AT+QFTPGET='test.txt','COM:',0,500 //The size of 'test.txt' is 1000 bytes, download the first 500 CONNECT OK bytes. l +QFTPGET: 0,500 te AT+QFTPGET='test.txt', 'COM:',500,500 CONNECT c l ue tia OK //Download 500-1000 bytes. +QFTPGET: 0,500 Q n //Download a file and save it to RAM. e AT+QFTPGET='test.txt', 'RAM:test2.txt',0 fid OK +QFTPGET: 0,1000 AT+QFLST='RAM:*' n +QFLST: 'RAM:test2.txt',1000 Co OK 2.7. AT+QFTPSIZE Get the File Size on FTP Server Get the file size on FTP server. If 'OK' is returned, '+QFTPSIZE: 0,' or '+QFTPSIZE: ,' should be output in set by AT+QFTPCFG. Otherwise, you should close the FTP connection, deactivate and reactive the network. WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 20 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual AT+QFTPSIZE Get the File Size on FTP Server Test Command AT+QFTPSIZE=? Response +QFTPSIZE: Write Command AT+QFTPSIZE= OK Response OK If successfully get the file size: +QFTPSIZE: 0, Else fail to get the file size: +QFTPSIZE: , or +CME ERROR: tel Parameter c l ue tia Q en String type, the file name in FTP server. The maximum size of the parameter is 50 bytes Integer type, the size of file on FTP server Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless nfid 2.8. AT+QFTPDEL Delete the File on FTP Server o Delete file on FTP server. If 'OK' is returned, '+QFTPDEL: ,' should be output in C set by AT+QFTPCFG. Otherwise, you should close the FTP connection, deactivate and reactive the network. AT+QFTPDEL Delete the File on FTP Server Test Command AT+QFTPDEL=? Response + QFTPDEL: Write Command AT+QFTPDEL= OK Response OK WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 21 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual +QFTPDEL: , or +CME ERROR: Parameter String type, the file name in FTP server. The maximum size of the parameter is 50 bytes Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless tel 2.9. AT+QFTPMKDIR Make a Folder on FTP Server c l Make a folder on FTP server. If 'OK' is returned, '+QFTPMKDIR: ,' should be output in set by AT+QFTPCFG. Otherwise, you should close the FTP connection, deactivate ue tia and reactive the network. AT+QFTPMKDIR Make a File Folder on FTP Server Q n Test Command e AT+QFTPMKDIR=? Response +QFTPMKDIR: fid Write Command AT+QFTPMKDIR= OK Response OK n+QFTPMKDIR: , o or C +CME ERROR: Parameter String type, the folder name on FTP server. The maximum size of the parameter is 100 bytes. Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 22 / 44 meaningless UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 2.10. AT+QFTPRMDIR Delete an Empty Folder on FTP Server Delete an empty folder on FTP server. If 'OK' is returned, '+QFTPRMDIR: ,' should be output in set by AT+QFTPCFG. Otherwise, you should close the FTP connection, deactivate and reactive the network. If the folder is not empty on FTP server, error will report. AT+QFTPRMDIR Delete an Empty Folder on FTP Server Test Command AT+QFTPRMDIR=? l Write Command uecte tial AT+QFTPRMDIR= Response +QFTPRMDIR: OK Response OK +QFTPRMDIR: , or +CME ERROR: Parameter Q n fide Con String type, the folder name on FTP server. The maximum size of the parameter is 100 bytes Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless 2.11. AT+QFTPLIST List Contents of Directory on FTP Server List contents of directory on FTP server. If the is 'COM:', 'CONNECT' should be output in set by AT+QFTPCFG. Else 'OK' will be returned first. '+QFTPLIST: 0,' will be output after contents being transferred completely. If the module has entered data mode, the set by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. If the is not 'COM:', the WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 23 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual set by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPLIST List Contents of Directory on FTP Server Test Command AT+QFTPLIST=? Response +QFTPLIST: , Write Command AT+QFTPLIST= [,'COM:'] OK Response CONNECT OK If successfully list contents of the directory: +QFTPLIST: 0, ctel l Write Command ue tia AT+QFTPLIST=, Q n The is not 'COM:' Else fail to list contents of the directory: +QFTPLIST: , or +CME ERROR: Response OK If successfully list contents of the directory: +QFTPLIST: 0, e Else fail to list contents of the directory: +QFTPLIST: , fid or +CME ERROR: n Parameter Co String type, the folder name on FTP server. The maximum size of the parameter is 100 bytes. If it is '.', it will get the content of current directory set by AT+QFTPCWD String type, the local position to save data from FTP server. The maximum size of the parameter is 60 bytes. The default value is 'COM:'. If it is 'COM:', the data will be output to COM port. If it starts with 'RAM:', the data will be saved to RAM. Then you can read the file by AT+QFREAD (For more details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual) Integer type, the size of transferred data from FTP server Integer type, indicates the operation error code. It is the type of error (Please refer WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 24 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless Example //Get contents of current directory on FTP server and output to COM port. AT+QFTPLIST ='.' CONNECT OK +QFTPLIST: 0,1000 //Get content of specified directory on FTP server and save to RAM. l AT+QFTPLIST='TESTDIR', 'RAM:test2.txt' te OK c l +QFTPLIST: 0,1000 ue tia AT+QFLST='RAM:*' +QFLST: 'RAM:test2.txt',1000 Q n OK fide 2.12. AT+QFTPNLST List File Names of Directory on FTP Server List file names of directory on FTP server. If the is 'COM:', 'CONNECT' should be output n in set by AT+QFTPCFG. Else 'OK' will be returned first. '+QFTPNLST: 0,' will o be output after file names being transferred completely. C If the module has entered data mode, the set by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. If the is not 'COM:', the set by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPLIST List File Names of Directory on FTP Server Test Command AT+QFTPNLST=? Response +QFTPNLST: , OK WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 25 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual Write Command AT+QFTPNLST=[,'COM:' ] Response CONNECT OK If successfully list file names: +QFTPNLST: 0, Else fail to list file names: +QFTPNLST: , or +CME ERROR: Write Command AT+QFTPNLST=, l is not 'COM:' Response OK +QFTPNLST: 0, or +CME ERROR: te If error occurs while listing file name: c l +QFTPNLST: , ue tia Parameter Q n fide on C String type, the folder name on FTP server. The maximum size of the parameter is 100 bytes. If it is '.', it will get the content of current directory set by AT+QFTPCWD String type, the local position to save data from FTP server. The maximum size of the parameter is 60 bytes. The default value is 'COM:'. If it is 'COM:', the data will be output to COM port. If it starts with 'RAM:', the data will be saved to RAM. Then you can read the file by AT+QFREAD (For more details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual) Integer type, the size of transferred data from FTP server Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless Example //Get file names of current directory on FTP server and output to COM port. AT+QFTPNLST='.' WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 26 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual CONNECT OK +QFTPNLST: 0,1000 //Get file name of specified directory on FTP server and save to RAM. AT+QFTPNLST='TESTDIR','RAM:test2.txt' OK +QFTPNLST: 0,1000 AT+QFLST='RAM:*' +QFLST: 'RAM:test2.txt',1000 OK tel 2.13. AT+QFTPRENAME Rename a File or Folder on FTP Server c l Rename a file or folder on FTP server. If 'OK' is returned, '+QFTPRENAME: ,' ue tia should be output in set by AT+QFTPCFG. Otherwise, you should close the FTP connection, deactivate and reactive the network. Q n AT+QFTPRENAME Rename a File or Folder on FTP Server Test Command e AT+QFTPRENAME=? Response +QFTPRENAME: , fid Write Command n AT+QFTPRENAME=, OK Response OK +QFTPRENAME: , or +CME ERROR: Parameter String type, the old file name or folder name on FTP server. The maximum size of the parameter is 100 bytes String type, the new file name or folder name on FTP server. The maximum size of the parameter is 100 bytes Integer type, indicates the operation error code. It is the type of error (Please refer to WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 27 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless 2.14. AT+QFTPLEN Get the Transferred Data Length Get the transferred data length on FTP server. AT+QFTPLEN Get the Transferred Data Length Test Command Response AT+QFTPLEN=? Execute Command ctel l AT+QFTPLEN OK Response OK +QFTPLEN: 0, or +CME ERROR: ue tia Parameter Q fiden Integer type, the transferred data length on FTP server. When executing AT+QFTPPUT, AT+QFTPGET, AT+QFTPNLST or AT+QFTPLIST, you can query the transferred data length by AT+QFTPLEN Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) n 2.15. AT+QFTPSTAT Get the Status of FTP Service Co Get the status of FTP service. AT+QFTPSTAT Get the Status of FTP Service Test Command AT+QFTPSTAT=? Execute Command AT+QFTPSTAT Response OK Response OK +QFTPSTAT: 0, WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 28 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual or +CME ERROR: Parameter Integer type, indicates the current status of FTP services 0 Opening an FTP service 1 The FTP service is opened and idle 2 Transferring data with FTP server 3 Closing the FTP service 4 The FTP service is closed Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) l 2.16. AT+QFTPCLOSE Logout from FTP Server te Logout from FTP server. If 'OK' is returned, '+QFTPCLOSE: ,' should be output in c l set by AT+QFTPCFG. Otherwise, you should deactivate and reactive the network. ue tia AT+QFTPCLOSE Logout from FTP Server Test Command AT+QFTPCLOSE=? Q en Execute Command AT+QFTPCLOSE Response OK Response OK fid +QFTPCLOSE: , or n+CME ERROR: Co Parameter Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 29 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 2.17. AT+QFTPMLSD List Standardized File and Directory Information List standardized file and directory information of directory on FTP server. If the is 'COM:', 'CONNECT' should be output within set by AT+QFTPCFG. Else 'OK' will be returned first. '+QFTPMLSD: 0,' will be output after contents has been transferred completely. If the module has entered data mode or the is not 'COM:', the set by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPMLSD List Standardized File and Directory Information Test Command Response AT+QFTPMLSD=? +QFTPMLSD: , Write Command tel AT+QFTPMLSD=[,'COM:'] OK Response CONNECT OK c l If successfully list standardized file and directory information: ue tia +QFTPMLSD: 0, Q en Write Command fid AT+QFTPMLSD=, n The is not 'COM:' Else fail to list standardized file and directory information: +QFTPMLSD: , or +CME ERROR: Response OK If successfully list standardized file and directory information: +QFTPMLSD: 0, o Else fail to list standardized file and directory information: C +QFTPMLSD: , or +CME ERROR: Parameter String type, the folder name on FTP server. The maximum size of the parameter is 100 bytes. If it is '.', it will list standardized file and directory information set by AT+QFTPCWD WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 30 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual String type, the local position to save data from FTP server. The maximum size of the parameter is 60 bytes. The default value is 'COM:'. If it is 'COM:', the data will be output to COM port. If it starts with 'RAM:', the data will be saved to RAM. Then you can read the file by AT+QFREAD (For more details, please refer to Quectel_WCDMA_UGxx_FILE_AT_Commands_Manual) Integer type, the size of transferred data from FTP server Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless Example //Get standardized file and directory information on FTP server and output to COM port. AT+QFTPMLSD ='.' l CONNECT te OK c l +QFTPMLSD: 0,1000 ue tia //Get standardized file and directory information on FTP server and save to RAM. AT+QFTPMLSD='TESTDIR', 'RAM:test2.txt' Q n OK e +QFTPMLSD: 0,1000 fid AT+QFLST='RAM:*' +QFLST: 'RAM:test2.txt',1000 n OK Co 2.18. AT+QFTPMDTM Get the File Modification Time on FTP Server Get the file modification time on FTP server. If 'OK' is returned, '+QFTPMDTM: 0,' or '+QFTPMDTM: ,' should be output in set by AT+QFTPCFG. Otherwise, you should close the FTP connection, deactivate and reactive the network. AT+QFTPMDTM Get the File Modification Time on FTP Server Test Command AT+QFTPMDTM=? Response +QFTPMDTM: WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 31 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual Write Command AT+QFTPMDTM= OK Response OK If successfully get the file modification time: +QFTPMDTM: 0, Else fail to get the file modification time: +QFTPMDTM: , or +CME ERROR: Parameter tel c l CQounefidentia String type, the file name in FTP server. The maximum size of the parameter is 50 bytes String type, the file modification time on FTP server. The format is 'YYYYMMDDHHMMSS', or 'YYYYMMDDHHMMSS.NNN' Integer type, indicates the operation error code. It is the type of error (Please refer to the Chapter 4) Integer type, for reference only, indicates the original error code from FTP server which is defined in FTP protocol (Please refer to Chapter 5). If it is 0, it is meaningless WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 32 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 3 Example 3.1. Login to FTP Server // Step 1: Configure and activate the PDP context. AT+QICSGP=1,1, 'UNINET','','',1 //Configure PDP context 1, APN is 'UNINET' for OK AT+QIACT=1 OK l AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' China Unicom. //Activate PDP context 1. //Activate successfully. //Query the state of PDP context. te OK c l AT+QFTPCFG='contextid',1 ue tia OK //Set the PDP context ID as 1. The PDP context ID must be activated before. //Step 2: Configure user account and transfer settings. Q n AT+QFTPCFG='account','test','test' e OK AT+QFTPCFG='filetype',1 fid OK AT+QFTPCFG='transmode',1 OK n AT+QFTPCFG='rsptimeout',90 o OK //Set user name and password. //Set file type as Binary. //Set transfer mode as Passive mode. //Set response timeout value. C //Step 3: Login to FTP server. AT+QFTPOPEN='quectel.3322.org',21 OK +QFTPOPEN: 0,0 WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 33 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 3.2. Folder Operation AT+QFTPCWD='/' OK //Set current directory. +QFTPCWD: 0,0 AT+QFTPPWD OK //Query current directory. +QFTPPWD: 0,'/' AT+QFTPMKDIR='TEST' //Create a folder as 'TEST' in FTP server. OK +QFTPMKDIR: 0,0 AT+QFTPRENAME='TEST', 'TEST_NEW' OK tel +QFTPRENAME: 0,0 AT+QFTPRMDIR='TEST_NEW' c l OK ue tia +QFTPRMDIR:0,0 Q n 3.3. File Operation e AT+QFTPCWD='/' fid OK +QFTPCWD: 0,0 n AT+QFTPPWD OK Co +QFTPPWD: 0,'/' //Rename a folder. //Delete a folder. //Set current directory. //Query current directory. AT+QFTPSIZE='test_my1.txt' //Query size of 'test_my1.txt' on FTP server. OK +QFTPSIZE: 0,1000 AT+QFTPRENAME='test_my1.txt', 'test_new.txt' //Rename a file. OK +QFTPRENAME: 0,0 WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 34 / 44 AT+QFTPDEL='test_new.txt' OK +QFTPDEL: 0,0 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual //Delete 'test_new.txt' on FTP server. 3.4. List File Information or File Names AT+QFTPCWD='/' OK //Set current directory. +QFTPCWD: 0,0 AT+QFTPLIST='.' CONNECT OK //List file information of current directory and output to COM. tel +QFTPLIST: 0,1000 AT+QFTPLIST='.','RAM:list.txt' c l OK //List file information of current directory and output to RAM:list.txt. ue tia +QFTPLIST:0,1000 AT+QFTPLIST='TEST_2','COM:' Q n CONNECT e OK //List file information of '/TEST_2' and output to COM. fid +QFTPLIST: 0,1000 n AT+QFTPNLST='.' CONNECT o C OK //List file names of current directory and output to COM. +QFTPNLST: 0,1000 AT+QFTPNLST='.','RAM:nlst.txt' //List file information of current directory and output to RAM:nlst.txt. OK +QFTPNLST: 0,1000 AT+QFTPNLST='TEST_2','COM:' //List file names of '/TEST_2' and output to COM. CONNECT WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 35 / 44 OK +QFTPNLST: 0,1000 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 3.5. Upload a File to FTP Server AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPSTAT +QFTPSTAT: 0,1 OK l //Upload a file from COM. te AT+QFTPPUT='test_my.txt', 'COM:',0 CONNECT c l ue tia OK //All data will be saved as 'test.txt' in FTP server. +QFTPPUT: 0,1000 Q n AT+QFTPLEN +QFTPLEN: 0,1000 fide OK AT+QFTPSIZE='test_my.txt' OK n +QFTPSIZE: 0,1000 Co //Upload a file from COM and the start position is 1000. AT+QFTPPUT='test_my.txt', 'COM:',1000 //All data will be saved as 'test.txt' in FTP server. CONNECT OK +QFTPPUT: 0,500 AT+QFTPSIZE='test_my.txt' OK WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 36 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual +QFTPSIZE: 0,1500 //Upload a file from COM to FTP server twice, each time in 1024 bytes. AT+QFTPPUT='test.txt', 'COM:',0,1024,0 CONNECT OK //It is not the last 1024 bytes of 'test.txt'. //Data length reaches1024. +QFTPPUT: 0,1024 AT+QFTPPUT='test.txt', 'COM:',1024,1024,1 //It is the last 1024 bytes of 'test.txt'. CONNECT OK //Data length reaches 1024. +QFTPPUT: 0,1024 //Upload a file from RAM to FTP server. l AT+QFUPL='RAM:test_ram.txt',1000,300,1 uecte tial CONNECT +QFUPL: 1000,707 //Upload a file to RAM, the file will be saved as 'test_ram.txt' and the maximum of file size is 1000. 300 indicates timeout, 1 indicates ACK mode. (Please refer to Quectel_WCDMA_ UGxx_FILE_AT_Commands_Manual). Q en OK AT+QFLST='RAM:*' fid +QFLST: 'RAM:test_ram.txt',1000 OK n AT+QFTPPUT='test_my1.txt', 'RAM:test_ram.txt',0 Co OK //Upload 'RAM:test_ram.txt' to FTP server and saved as 'test_my1.txt' on FTP server. +QFTPPUT: 0,1000 AT+QFTPLEN +QFTPLEN: 0,1000 OK AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 37 / 44 AT+QFDEL='RAM:test_ram.txt' OK UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual //Delete local RAM file. 3.6. Download a File from FTP Server AT+QFTPCWD='/' OK +QFTPCWD: 0,0 //Download a file from FTP server and output to COM. AT+QFTPGET='test_my.txt', 'COM:' CONNECT OK tel +QFTPGET: 0,1000 c l //Download a file and output to COM port twice, each time in 500 bytes. ue tia AT+QFTPGET='test.txt','COM:',0,500 CONNECT Q n OK //The size of test.txt is 1000 bytes, download the first 500 bytes. e +QFTPGET: 0,500 fid AT+QFTPGET='test.txt', 'COM:',500,500 CONNECT n OK //Download 500-1000 bytes. Co +QFTPGET: 0,500 //Download a file from FTP server and save to RAM. AT+QFTPGET='test_my1.txt', 'RAM:test.txt' OK //Download file and save it to RAM as 'test.txt'. +QFTPGET: 0,1000 AT+QFLST='RAM:*' +QFLST: RAM:test.txt,1000 OK WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 38 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual //Download a file from FTP server and save it to RAM, the start position is 450. AT+QFTPGET='test_my1.txt', 'RAM:test1.txt',450 OK //Download file and save to RAM as 'test.txt'. +QFTPGET: 0,550 AT+QFTPLEN +QFTPLEN: 0,550 OK AT+QFLST='RAM:*' +QFLST: RAM:test.txt,1000 +QFLST: RAM:test1.txt,550 OK l 3.7. Logout from FTP Server te AT+QFTPCLOSE c l OK ue tia +QFTPCLOSE:0,0 AT+QIDEACT=1 Q n OK //Logout from FTP server. //Deactivate the PDP context which was activated for FTP. fide 3.8. FTPS Configuration //Step 1: Configure and activate the PDP context. n AT+QICSGP=1,1,'UNINET','','',1 o OK C AT+QIACT=1 //Configure PDP context 1, APN is 'UNINET' for China Unicom. //Activate PDP context 1. OK //Activate successfully. AT+QIACT? //Query the state of PDP context. +QIACT: 1,1,1,'10.7.157.1' OK AT+QFTPCFG='contextid',1 OK //Set the PDP context ID as 1. The PDP context ID must be activated before. //Step 2: Configure user account and transfer settings. WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 39 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual AT+QFTPCFG='account','test','test' OK AT+QFTPCFG='filetype',1 OK AT+QFTPCFG='transmode',1 OK AT+QFTPCFG='rsptimeout',90 OK //Set user name and password. //Set file type as Binary. //Set transfer mode as Passive mode. //Set response timeout value. //Step 3: FTPS configuration. AT+QFTPCFG='ssltype',1 //Set SSL type as 1, module plays as FTPS client OK AT+QFTPCFG='sslctxid',1 OK AT+QSSLCFG='ciphersuite',1, '0xffff' l OK AT+QSSLCFG='seclevel',1,0 te OK c l AT+QSSLCFG='sslversion',1,1 ue tia OK //Step 4: Login to FTPS server. AT+QFTPOPEN='quectel.3322.org',990 Q n OK Confide +QFTPOPEN: 0,0 //Select SSL context 1. //Configure SSL cipher suite type as 0xffff, which supports all cipher suite type . //Configure SSL security level as 0, which mean the SSL CA cert is not needed . //Configure SSL version as 1, which means TLS1.0. WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 40 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 4 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about are described in the following table. Table 1: Summary of Error Codes 0 601 602 603 604 605 606 607 608 609 610 611 Meaning Operate successfully l Unknown error te FTP service would block c l FTP service busy ue tia DNSparsefails Network error Q n Control connection closed. e Data connection closed fid Socket closed by peer Timeout error n Invalid parameter CoFail to open file 612 File position invalid 613 File error 614 Service not available, closing control connection 615 Open data connection fails 616 Connection closed; transfer aborted 617 Requested file action not taken WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 41 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 618 Requested action aborted: local error in processing 619 Requested action not taken: insufficient system storage 620 Syntax error, command unrecognized 621 Syntax error in parameters or arguments 622 Command not implemented 623 Bad sequence of commands 624 Command parameter not implemented 625 626 627 628 629 630 631 Not logged in Need account for storing files Requested action not taken. l Requested action aborted: page type unknown te Requested file action aborted c l Requested file name invalid CQounefidentia SSL authentication failure WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 42 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 5 Summary of FTP Protocol Error Codes The protocol error code indicates an error replied from FTP server. Please refer to RFC959 (File Transfer Protocol).The details about are described in the following table. Table 2: Summary of FTP Protocol Error Codes 421 l 425 te 426 c l 450 ue tia 451 452 Q n 500 e 501 fid 502 503 n 504 Co 530 Meaning Service not available, closing control connection Open data connection fails Connection closed; transfer aborted Requested file action not taken Requested action aborted: local error in processing Requested action not taken: insufficient system storage Syntax error, command unrecognized Syntax error in parameters or arguments Command not implemented Bad sequence of commands Command parameter not implemented Not logged in 532 Need account for storing files 550 Requested action not taken. File unavailable 551 Requested action aborted: page type unknown 552 Requested file action aborted. Exceeded storage allocation 553 Requested action not taken. File name not allowed WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 43 / 44 UMTS/HSPA Module Series WCDMA UGxx FTP AT Commands Manual 6 Appendix A Reference Table 3: Related Documents SN Document Name Remark [1] RFC959 File Transfer Protocol Quectel_WCDMA_UGxx_TCPIP_AT_ [2] Introduction about UGxx TCPIP AT commands Commands_Manual Quectel_WCDMA_UGxx_FILE_AT_ l [3] Commands_Manual Introduction about UGxx file AT commands te Quectel_WCDMA_UGxx_AT_Commands_ [4] UGxx AT commands manual Manual uec tial Table 4: Terms and Abbreviations Abbreviation Q n FTP e PDP fid DTR n PPP Co DNS Description File Transfer Protocol Packet Data Protocol Data Terminal Ready Point-to-Point Protocol Domain Name Server WCDMA_UGxx_FTP_AT_Commands_Manual Confidential / Released 44 / 44

WCDMA UGxx FILE AT Commands Manual UMTS/HSPA Module Series Rev. WCDMA_UGxx_FILE_AT_Commands_Manual_V1.3 Date: 2016-05-05 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx FILE 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 1 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual About the Document History Revision 1.0 1.1 1.2 1.3 Date 2014-12-10 l 2015-03-02 te 2015-04-01 CQouneficdential 2016-05-05 Author Jonathan WEN Bonnie ZHAO Bonnie ZHAO Sophie ZHU Description Initial Changed the document name from 'UG95' to 'UGxx'. Updated applicable modules. Changed into WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 2 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 1 Introduction .......................................................................................................................................... 5 1.1. The Process of Using File AT Commands .............................................................................. 5 2 Description of AT Command .............................................................................................................. 6 2.1. AT+QFLDS Get the Space Information of the Storage......................................................... 6 2.2. AT+QFLST List Files............................................................................................................. 7 2.3. AT+QFDEL Delete the File in the Storage............................................................................ 8 3 4 2.4. 2.5. 2.6. 2.7. l 2.8. 2.9. te 2.10. 2.11. c l 2.12. AT+QFUPL Upload File to the Storage................................................................................. 8 AT+QFDWL Download the File from the Storage............................................................... 10 AT+QFOPEN Open the File ............................................................................................... 11 AT+QFREAD Read the File ................................................................................................ 12 AT+QFWRITE Write the File............................................................................................... 12 AT+QFSEEK Seek the File................................................................................................. 13 AT+QFPOSITION Get the Offset of the File Pointer .......................................................... 14 AT+QFTUCAT Truncate the File from the File Pointer ....................................................... 14 AT+QFCLOSE Close the File ............................................................................................. 15 ue tia Example .............................................................................................................................................. 16 3.1. Upload and Download Files .................................................................................................. 16 3.1.1. Upload the File ............................................................................................................... 16 Q n 3.1.1.1. Non ACK Mode..................................................................................................... 16 3.1.1.2. ACK Mode ............................................................................................................ 16 e 3.1.2. Download the File .......................................................................................................... 17 fid 3.2. Write and Read the File......................................................................................................... 17 3.2.1. Write and Read RAM File .............................................................................................. 17 Con Appendix A Summary of Code ............................................................................................... 18 WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 3 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual Table Index TABLE 1: SUMMARY OF ERROR CODE ................................................................................................. 18 CQouneficdteenl tial WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 4 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 1 Introduction Quectel module provides AT commands to operate files on RAM (Random Access Memory). This document is a reference guide to these commands. The files in the RAM will be lost when rebooting the module. The file name must begin with 'RAM:' This document is applicable to Quectel UGxx modules. 1.1. The Process of Using File AT Commands tel There are two modes to create, read and write the file in the storage: c l 1. The file is created and all the content of the file could be uploaded to the storage by command 'AT+QFUPL'. And the content can be outputted/downloaded through the serial interface by ue tia command 'AT+QFDWL'. 2. Open the file by 'AT+QFOPEN', then the file can be written or read at any time and any location until the file is closed by 'AT+QFCLOSE'. Q n  When the file is opened by command 'AT+QFOPEN', you can set the file as overwrite mode or e read-only mode or others by the parameter . (For more information about , see Section 2.6). After the file is opened, a is assigned to this file. Then you can fid operate this file via this .  After the file is opened, write the file by command 'AT+QFWRITE' and read the file by 'AT+QFREAD' from the current file position. n  You can set the file position by 'AT+QFSEEK' and get the current position by 'AT+QFPOSITION'. o  'AT+QFTUCAT' will truncate the file from the current position to the end of the file. C  Close the file by 'AT+QFCLOSE'. Then the becomes meaningless to this file. There are several commands to manage files in the storage: 1. 'AT+QFLDS' gets the storage size. 2. 'AT+QFLST' lists files information in the storage. 3. 'AT+QFDEL' deletes the file(s). WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 5 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 2 Description of AT Command 2.1. AT+QFLDS Get the Space Information of the Storage AT+QFLDS responds the space information of the specified storage. AT+QFLDS Get the Space Information of the Storage Test Command AT+QFLDS=? l Write Command te AT+QFLDS= Response OK Response +QFLDS: , uec tial ExecutionCommand AT+QFLDS OK or +CME ERROR: Response +QFLDS: , Q n OK fide Parameter on C Pattern 'RAM' RAM files in the random storage The size of the free space in The total size of the storage The error code from the module (see the Appendix A) Example AT+QFLDS='RAM' +QFLDS: 524288,524288 OK WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 6 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 2.2. AT+QFLST List Files AT+QFLST lists the information of a single file or all files in the required storage medium. AT+QFLST List Files Test Command AT+QFLST=? Write Command AT+QFLST= Response OK Response +QFLST: , [+QFLST: , […]] l Execution Command Quectential AT+QFLST OK or +CME ERROR: Response Return the information of the RAM files: +QFLST: , [+QFLST: , […]] OK or +CME ERROR: fide Parameter The file to be listed n 'RAM:*' 'RAM:' o Name of the file C Size in bytes of the file All the files in RAM The specified file in RAM The error code from the module (see the Appendix A) Example AT+QFLST='RAM:*' +QFLST: 'RAM:F_UGxx-1.bmp',56554 +QFLST: 'RAM:F_UGxx-10.bmp',56554 +QFLST: 'RAM:F_UGxx-11.bmp',56554 OK WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 7 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 2.3. AT+QFDEL Delete the File in the Storage AT+QFDEL deletes a single file or all the files in the specified storage. AT+QFDEL Delete the File in the Storage Test Command AT+QFDEL=? Response +QFDEL: OK Write Command Response AT+QFDEL= OK or +CME ERROR: Parameter l The file to be deleted. The max length of is 80 bytes te 'RAM:*' Delete all the files in RAM c l 'RAM:' Delete the specified file in RAM The error code from the module (see the Appendix A) Que ntia 2.4. AT+QFUPL Upload File to the Storage e 1. AT+QFUPL uploads the file to storage directly. If there is a file in the storage which has the same fid name with the file to be uploaded, it will report the error. 2. There are three ways to exit from the transparent transmission mode:  The data uploaded reaches the . n  The time without any data inputted reaches .  When the data is transmitted, the DTR PIN (AT&D1 should be set.) is pulled high or the valid o '+++' is inputted. C 3. To prevent the '+++' from being misinterpreted as data, it should comply to the following sequence:  Do not input any character within T1 time (1 second) before inputting '+++'.  Input '+++' during 1s, and no other characters can be inputted during the time.  Do not input any character within T1 time (1 second) after '+++' has been inputted.  The current result '+QFUPL: ,' is outputted, and the module exits from the transparent access mode, return OK. AT+QFUPL Upload File to the Storage Test Command AT+QFUPL=? Response +QFUPL: [,(1-)[,(1-65535)[,(0,1)]]] WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 8 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual Write Command AT+QFUPL=[,[ ,[,]]] OK Response CONNECT TA switches to the transparent access mode, and the binary data of file can be inputted. When the total size of the inputted data reaches (unit: byte), TA will return to command mode and reply the following codes: +QFUPL: , OK or +CME ERROR: Parameter l te c l ue tia Q en fid The size of the free space in . Please refer to the '+QFLDS' The name of file to be stored. The max length is 80 bytes 'RAM:' The name of file uploaded to RAM The file size expected to be uploaded Default is 10240. Unit is byte The actual size of the uploaded data. Unit: byte The delay time in seconds of waiting data to be inputted to USB/UART. Default is 5s Whether to use ACK mode 0 Turn off the ACK mode by default 1 Turn on the ACK mode The checksum of the uploaded data The error code from the module (see the Appendix A) n NOTES 1. It is strongly recommended to use DOS 8.3 file name format for . o 2. is a 16 bit checksum based on bitwise XOR. C If the number of the characters is odd, set the last character as the high 8 bit, and the low 8 bit as 0, and then use an XOR operator to calculate the checksum. '+++' sequence will cause TA to end the command and switch to command mode; however, the data previously uploaded will be preserved into the file. 3. When executing the command, the data must be entered after CONNECT appears. 4. The ACK mode is provided to avoid the loss of data when uploading large files, in case hardware flow control doesn‟t work. The ACK mode works as follows: 1) Run AT+QFUPL=,,,1 command to enable the ACK mode. 2) The module outputs CONNECT. 3) MCU sends 1K bytes data, and then the module will respond with an „A‟. WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 9 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 4) MCU receives this „A‟ and then sends the next 1K bytes data; 5) Repeat step 3) and 4) until the transfer is completed. 2.5. AT+QFDWL Download the File from the Storage AT+QFDWL downloads the file from the module storage. AT+QFDWL Download the File from the Storage Test Command Response AT+QFDWL=? +QFDWL: Write Command uectel tial AT+QFDWL= OK Response CONNECT TA switches to data mode, and the bin data of the file will be outputted. When the file is read over, TA will return to command mode and reply the following codes: +QFDWL: , OK or +CME ERROR: Q en Parameter fid n Co The name of the file to be downloaded. The max length is 80 letters 'RAM: ' The downloaded file in RAM The size of the downloaded data The checksum of the downloaded data The error code from the module (see the Appendix A) NOTES 1. '+++' sequence will cause TA to end the command and switch to command mode. 2. is a 16 bit checksum based on bitwise XOR. WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 10 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 2.6. AT+QFOPEN Open the File Get the file handle by the 'AT+QFOPEN' which is used in other commands, such as 'AT+QFWRITE', 'AT+QFREAD', 'AT+QFSEEK', 'AT+QCLOSE', 'AT+QFPOSITION' and 'AT+QFTUCAT'. AT+QFOPEN Open the File Test Command AT+QFOPEN=? Response +QFOPEN: [,(0-2)] OK Read Command Response AT+QFOPEN? +QFOPEN: ,, [+QFOPEN: ,, […]] tel Write Command AT+QFOPEN=[,] OK Response +QFOPEN: uec tial OK or +CME ERROR: Q en Parameter fid Con The file to be operated. The max length is 80 bytes 'RAM: ' The operated file in the RAM The handle of the file. The data type is 4 bytes The open mode of the file. Default is 0 0 If the file does not exist, it will be created; if the file exists, it will be directly opened. And both of them can be read and written. 1 If the file does not exist, it will be created; If the file exists, the file will be overwritten and cleared. And both of them can be read and written. 2 If the file exists, open it and it can be read only. When the file does not exist, it will respond the error. The error code from the module (see the Appendix A) WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 11 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 2.7. AT+QFREAD Read the File AT+QFREAD reads the data of the file related to the handle. The data starts from the current position of the file pointer which belongs to the file handle. AT+QFREAD Read the File Test Command AT+QFREAD=? Response +QFREAD: [,] OK Write Command Response AT+QFREAD=[, tel ] CONNECT TA switches to data mode. When the total size of the data reaches (unit: byte), TA will return to command mode, display the result and then reply the following codes: OK or +CME ERROR: c l Parameter ue tia Q n The handle of the file to be operated The length of the file to be read out and the default is the file length The actual read length The error code from the module (see the Appendix A) fide 2.8. AT+QFWRITE Write the File n AT+QFWRITE writes the data to the file in storage. The data starts from the current position of the file Co pointer which belongs to the file handle. AT+QFWRITE Write the File Test Command AT+QFWRITE=? Response +QFWRITE: [,[,]] Write Command AT+QFWRITE=[,[,]] OK Response CONNECT TA switches to data mode. When the total size of the written data reaches (unit: byte) or the time, TA will return to WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 12 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual command mode and reply the following codes: +QFWRITE: , OK or +CME ERROR: Parameter The handle of the file to be operated The length of the file to be written, the default length is 10K. The range of this parameter is same with the of the 'AT+QFUPL' The time of waiting data to be inputted to USB/UART . Default is 5s The actual written length The total length of the file The error code from the module (see the Appendix A) ctel l 2.9. AT+QFSEEK Seek the File ue tia Set the current position of the file pointer which belongs to the file handle. This will decide the starting position of the 'AT+QFREAD', 'AT+QFWRITE', 'AT+QFPOSITION' and 'AT+QFTUCAT'. Q n AT+QFSEEK Seek the File e Test Command AT+QFSEEK=? Response +QFSEEK: ,[,] fid Write Command n AT+QFSEEK=,[, Co ] OK Response OK or +CME ERROR: Parameter The handle of the file to be operated The number of bytes of the file pointer movement Pointer movement mode. Default is 0 0 The beginning of the file 1 The current position of the pointer 2 The end of the file WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 13 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual The error code from the module (see the Appendix A) NOTES 1. If is 0, and the exceeds the file size, the command will return ERROR. 2. If is 1, and the total size of the with the current position of the pointer exceeds the file size the command will return ERROR. 3. If is 2, the handle will move forth. 2.10. AT+QFPOSITION Get the Offset of the File Pointer AT+QFPOSITION gets the current position of the file pointer which is relevant to the file handle. l AT+QFPOSITION Get the Offset of the File Pointer te Test Command AT+QFPOSITION=? Response +QFPOSITION: uec tial WriteCommand AT+QFPOSITION= OK Response +QFPOSITION: Q n OK or e +CME ERROR: fid Parameter n o C The handle of the operated file The offset from the beginning of the file The error code from the module (see the Appendix A) 2.11. AT+QFTUCAT Truncate the File from the File Pointer AT+QFTUCAT will truncate all the data behind the position that the file pointer indicates. AT+QFTUCAT Truncate the File from the File Pointer Test Command AT+QFTUCAT=? Response +QFTUCAT: WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 14 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual Write Command AT+QFTUCAT= OK Response OK or +CME ERROR: Parameter The handle of the operated file The error code from the module (see the Appendix A) 2.12. AT+QFCLOSE Close the File l AT+QFCLOSE closes the file and ends the operation to the file. The file handle is released and should not te be used again, unless open the file again with 'AT+QFOPEN'. c l AT+QFCLOSE Close the File ue tia TestCommand AT+QFCLOSE=? Response +QFCLOSE: Q n Write Command fide AT+QFCLOSE= OK Response OK or +CME ERROR: n Parameter o C The handle of the operated file The error code from the module (see Appendix A) WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 15 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 3 Example 3.1. Upload and Download Files 3.1.1. Upload the File 3.1.1.1. Non ACK Mode l AT+QFUPL='RAM:test1.txt',10 CONNECT te +QFUPL: 10,613e c l OK //Upload the text file 'RAM:test1.txt' to RAM. //Get the bytes of the uploaded data and the checksum. ue tia 3.1.1.2. ACKMode Q en The ACK mode can make the data transmission more reliable. When transmitting the large file without hardware flow control, the ACK mode is used to prevent the data from being lost. About the ACK mode, fid please refer to the details of 'AT+QFUPL'. AT+QFUPL='RAM:test.txt',3000,5,1 n CONNECT Co A //Upload the text file 'RAM:test.txt' to RAM. //After receiving 1024bytes data, the module will respond an 'A', then next 1024 bytes data can be inputted. A +QFUPL: 3000,B34A OK WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 16 / 19 3.1.2. Download the File AT+QFDWL='RAM:test.txt' CONNECT +QFDWL: 10,613e OK UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual //Download the text file 'RAM:test.txt' from RAM. //Get the bytes of the downloaded data and the checksum. 3.2. Write and Read the File 3.2.1. Write and Read RAM File AT+QFLDS='RAM' l +QFLDS: 524288,524288 //Query the space information of RAM. te OK AT+QFOPEN='RAM:1',0 c l +QFOPEN: 3000 //Open the file in the RAM. ue tia OK AT+QFWRITE=3000,10 CONNECT Q n e +QFWRITE: 10,10 //Write 10 bytes to the file. //The actual written bytes and the size of the file are returned. fid OK AT+QFSEEK=3000,0,0 OK n AT+QFREAD=3000,10 CONNECT Co //Set the file pointer to the beginning of the file. //Read the data. OK AT+QFCLOSE=3000 //Close the file. OK WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 17 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 4 Appendix A Summary of Code The result of the final error code is '+CME ERROR: '. indicates an error relating to the ME or Network. The operation is similar to Error result code. It will be returned when some definition error happens. The codes listed here are just related to UGxx module of the File. Table 1: Summary of Error Code 400 tel 401 c l 402 ue tia 403 405 Q n 406 e 407 fid 409 410 n 411 Co 413 Meaning invalid input value larger than the size of the file read zero bytes drive full file not found invalid file name file already exists fail to write the file fail to open the file fail to read the file reach the max number of file allowed to be opened 414 the file read-only 416 invalid file descriptor 417 fail to list the file 418 fail to delete the file 419 fail to get disk info WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 18 / 19 UMTS/HSPA Module Series WCDMA UGxx FILE AT Commands Manual 420 no space 421 time out 423 file too large 425 invalid parameter 426 file already opened CQouneficdteenl tial WCDMA_UGxx_FILE_AT_Commands_Manual Confidential / Released 19 / 19

M25&M26 软件差异说明 GSM/GPRS 系列 版本：1.0 日期：2021-02-09 状态：受控文件 www.quectel.com M25&M26 软件差异说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 13 M25&M26 软件差异说明 文档历史 修订记录 版本 1.0.0 日期 2021-02-07 2021-02-09 作者 Waner PAN Waner PAN 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 13 M25&M26 软件差异说明 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 软件对比 ................................................................................................................................................ 6 2.1. 软件功能对比.............................................................................................................................. 6 2.2. AT 命令对比................................................................................................................................ 7 2.3. QuecOpen®功能对比.................................................................................................................. 9 3 注意事项 .............................................................................................................................................. 11 4 附录 参考文档和术语缩写 .................................................................................................................. 12 上海移远通信技术股份有限公司 3 / 13 M25&M26 软件差异说明 表格索引 表 1：M26 和 M25 模块软件功能对比.......................................................................................................... 6 表 2：M26 和 M25 模块 AT 命令对比........................................................................................................... 7 表 3：M26 和 M25 QuecOpen®模块功能对比.............................................................................................. 9 表 4：参考文档 ........................................................................................................................................... 12 表 5：术语缩写 ........................................................................................................................................... 12 上海移远通信技术股份有限公司 4 / 13 M25&M26 软件差异说明 1 引言 本文档主要介绍移远通信 GSM M26 和 M25 模块软件的主要差异，包括软件功能、AT 命令以及应用 功能等差异对比，包含但不限于以下具体描述。 上海移远通信技术股份有限公司 5 / 13 2 软件对比 2.1. 软件功能对比 表 1：M26 和 M25 模块软件功能对比 模块 M26 芯片 MT6261 DFOTA 不支持 QuecFOTA® 支持 QuecOpen® 支持 QuecOpen® FOTA 支持（整包升级） USSD 支持 PHB 支持 STK 支持 TCP/SSL 不支持 HTTPS 不支持 FTP 支持 PPP 支持 CMUX 支持 HTTP 支持 TCP/UDP 支持 NITZ 支持 上海移远通信技术股份有限公司 M25&M26 软件差异说明 M25 RDA8955 支持 支持 支持 支持（差分升级） 支持 不支持 不支持 支持 支持 支持 支持 支持 支持 支持 支持 6 / 13 PING NTP MQTT 蓝牙 干扰检测 eCall 自适应波特率 音频 闹钟 SMS DTMF 网络 其他 M25&M26 软件差异说明 支持 支持 支持 支持 不支持 支持 支持 不支持 支持 不支持 支持 不支持 支持（支持'AT''at'同步码） 支持（仅支持'AT'同步码） 支持 支持（录音仅支持 amr 格式） 支持 不支持 支持 支持（不支持长短信格式） 支持 支持 支持（支持 425、950、1400、1800 频率音） 支持 （AT+CGCLASS='CC'功能不生效； 锁定 3 个无效频点后，模块仍能够成功注网； AT+QENG=2,2 和 AT+QENG=2,3 的状态下 不自动上报载波列表； 锁定多个频点后查询只显示 1 个小区信息； 不支持 FPLMN 自动清除功能、工程模式 值为 4、查询当前信道信息以及禁运 行商操作） 有关 AT 命令的详细信息，请参考文档[1]。 M26 对比 M25 支持参数设置和 AT&W 连写以及软件流控 2.2. AT 命令对比 表 2：M26 和 M25 模块 AT 命令对比 AT 命令 AT+GCAP=? AT+GCAP AT+ILRR=? AT+QIURC=? M26 支持 上海移远通信技术股份有限公司 M25 不支持 7 / 13 AT+QEXTUNSOl=? AT+QINISTAT=? AT+QNSTATUS=? AT+CTZR=? AT+QCGTIND=? AT+QCSPWD=? AT+QSIMVOL=? ATP ATS6=? ATS7=? ATS8=? ATS10=? ATT AT+CSTA=? AT+CR=? AT+CRC=? AT+CSNS=? AT+QSFR=? AT+QSPCH=? AT+QISCON=? AT+CCUG=? AT+QCLIP=? AT+QCOLP=? ATL ATM AT+QTONEP=? AT+QPCMON=? AT+QPCMVOL=? AT+QALARM=? AT+CRES AT+CSAS AT+QIAUTOS AT+QITCFG AT+QISCON=? AT+QENG=1,4 AT+CGDATA AT+QOPS AT+QISERVER=? AT+CCUG=? AT+QCFG='RFTXburst' AT+QDISHP=? AT+CKPD AT+CMUX? AT+QSEDCB? 上海移远通信技术股份有限公司 M25&M26 软件差异说明 M26 对比 M25 默认值不同 8 / 13 AT+CSCB? AT+QNTP? AT+CBC AT+QSMSCODE? AT+QTDMOD? AT+QVBATT? AT+CSCS=? AT+IFC=? AT+IPR=? AT+QSEDCB=? AT+CLCK=? AT+CPWD=? AT+CRES=? AT+CSAS=? AT+CPBS=? AT+CPBW=? AT+CPBR=? AT+CGCLASS=? AT+QMIC=? AT+QAUDCH=? AT+QLEDMODE=? AT+QLTS=? AT+QLTONE=? AT+QVBATT=? AT+QIFGCNT=? AT+QSMSCODE=? M25&M26 软件差异说明 M26 对比 M25 支持参数不同 M26 对比 M25 返回参数冒号后无空格 M26 对比 M25 返回参数不用[] 2.3. QuecOpen®功能对比 表 3：M26 和 M25 QuecOpen®模块功能对比 功能差异项 GPIO EINT PWM ADC M26 支持 电平触发 支持 范围 0~2.8 V，回调方式 上海移远通信技术股份有限公司 M25 不支持 GPIO 获取上下拉配置 边沿触发 不支持 范围 0~1.8 V，主动读取方式 9 / 13 M25&M26 软件差异说明 UART 唤醒方式 SPI 3 个普通串口 2 个普通串口 M25 和 M26 均支持通过 EINT、timer、GPRS 数据、来电、短信唤醒模块，不同的 是 ， M25 通 过上述 方式唤 醒后 ，模 块 不会 自动进 入睡 眠， 需要用 户再次 调用 Ql_SleepEnable，让模块进入睡眠模式 支持硬件 SPI 不支持硬件 SPI 文件系统 仅支持 RAM 支持 UFS/RAM Ql_Debug_Trace 应用程序升级方案 当调试串口配置为 ADVANCE 模式，需要 通过 catcher 输出，如果配置为 BASIC 模 式，文本格式吐出 应用程序的全量升级 调试串口不支持文本格式数据，只能通过 coolwatcher 输出 差分升级，只升级目标应用程序和原始应 用程序差异部分，且不能跨版本，需用户 自行管控版本信息 可以差分升级内核固件 固件/APP 下载 通过 QFlash 下载（主串口） 通过 QFlash 下载（调试串口） 调试方法 通过 cather 工具抓取内核调试 log 通过 coolwatcher 工具抓取内核调试 log 标准库 Ql_sscanf 支持正则表达式 Ql_sscanf 不支持正则表达式 上海移远通信技术股份有限公司 10 / 13 M25&M26 软件差异说明 3 注意事项 ⚫ 对于 PHB、STK、蓝牙、硬件 SPI、干扰检测、eCall 功能，M25 无法替代 M26。 ⚫ 对于其他没有明确写明不支持的功能项，请先咨询移远通信技术支持了解具体情况，再考虑替代。 上海移远通信技术股份有限公司 11 / 13 M25&M26 软件差异说明 4 附录 参考文档和术语缩写 表 4：参考文档 序号 [1] 文档名称 Quectel_M26_AT 命令手册 描述 M26 AT 命令手册 表 5：术语缩写 缩写 ADC DFOTA DTMF eCall EINT FPLMN FTP GPIO HTTPS MQTT NITZ PPP PHB PWM 英文全称 Analog-to-Digital Converter Delta Firmware Upgrade Over-The-Air Dual-tone Multifrequency Emergency Call External Interrupt Forbidden Public Land Mobile Network File Transfer Protocol General-Purpose Input/Output Hyper Text Transfer Protocol over Secure Socket Layer Message Queuing Telemetry Transport Network Identity and Time Zone Point-to-Point Protocol PhoneBook Pulse Width Modulation 中文全称 模数转换器 固件空中差分升级 双音多频 紧急电话 外部中断 禁用公共陆地移动网 文件传输协议 通用型输入/输出 超文本传输安全协议 消息队列遥测传输 网络标识和时区 点到点协议 电话簿 脉冲宽度调制 上海移远通信技术股份有限公司 12 / 13 SMS SPI SSL STK TCP UART UDP USSD Short Message Service Serial Peripheral Interface Security Socket Layer SIM Tool Kit Transmission Control Protocol Universal Asynchronous Receiver/Transmitter User Datagram Protocol Unstructured Supplementary Service Data M25&M26 软件差异说明 短信息服务 串行外设接口 安全套接层 用户识别应用发展工具 传输控制协议 通用异步收发传输器 用户数据报协议 非结构化补充数据业务 上海移远通信技术股份有限公司 13 / 13

EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 LTE Standard 模块系列 版本：1.1 日期：2021-06-25 状态：受控文件 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 文档历史 修订记录 版本 日期 - 2021-04-09 1.0 2021-04-21 1.1 2021-06-25 作者 Jarvis FENG Jarvis FENG Jarvis FENG 变更表述 文档创建 受控版本 1. 优化软件配置方案（第 3 章） 2. 新增常见问题及解决方案（第 4 章） 上海移远通信技术股份有限公司 2 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 图片索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 适用模块 ...................................................................................................................................... 6 2 背景与技术 ............................................................................................................................................. 7 2.1. 背景 ............................................................................................................................................. 7 2.2. 技术 ............................................................................................................................................. 8 2.2.1. Voice Centric .................................................................................................................... 8 2.2.2. Data Centric ..................................................................................................................... 8 3 软件配置 ................................................................................................................................................. 9 3.1. 终端设备为 Data-only.................................................................................................................. 9 3.2. 终端设备为 Data + Voice 且不需要漫游.................................................................................... 10 3.3. 终端设备为 Data + Voice 且需要漫游 ....................................................................................... 11 4 常见问题及解决方案............................................................................................................................. 13 4.1. 无法确认(U)SIM 卡 IMSI ........................................................................................................... 13 4.2. 不同状态的终端设备的处理建议 ............................................................................................... 13 4.2.1. 正在使用的设备 .............................................................................................................. 13 4.2.2. 针对认证中的设备 .......................................................................................................... 14 4.2.3. 针对计划中的设备 .......................................................................................................... 14 5 附录 参考文档和术语缩写 ................................................................................................................... 15 上海移远通信技术股份有限公司 3 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：IMSI 列表.......................................................................................................................................... 13 表 3：参考文档 ........................................................................................................................................... 15 表 4：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 图片索引 图 1：AT&T 3G 网络退网解决方案............................................................................................................... 7 图 2：Data-only 设备软件配置流程图 .......................................................................................................... 9 图 4：Voice + Data 设备且无需漫游的软件配置流程图 ............................................................................. 10 图 3：Voice + Data 设备且需要漫游的软件配置流程图 ............................................................................. 12 上海移远通信技术股份有限公司 5 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 1 引言 AT&T 将在 2022 年 2 月 22 日将 3G 网络退网，该信息已通知移远通信。由于移远通信 LTE Standard EC2x 系列、EG9x 系列和 EG2x-G 模块的 Ue_Usage_Setting（UE 的使用设置）为 Voice Centric（语音 为中心），AT&T 将 3G 网络退网后，如果用户设备不支持 VoLTE，届时设备将出现无服务的情况。因此， AT&T 要求移远通信及其客户在进行 AT&T 认证和实网使用时将 Ue_Usage_Setting 修改为 Data Centri（c 数 据为中心）。 本文档介绍了将移远通信上述适用模块的 Ue_Usage_Setting 修改为 Data Centric 的软件配置方法、 常见问题及解决方案，以满足 AT&T 3G 网络退网解决方案的要求。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG9x EG2x-G 模块 EC21系列 EC25系列 EG91系列 EG95系列 EG21-G EG25-G 上海移远通信技术股份有限公司 6 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 2 背景与技术 本章节主要介绍了 AT&T 3G 网络退网的相关背景与技术。 2.1. 背景 AT&T 将在 2022 年 2 月 22 日将 3G 网络退网，下图为 AT&T 要求的关于 3G 网络退网的解决方案。 图 1：AT&T 3G 网络退网解决方案 上海移远通信技术股份有限公司 7 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 2.2. 技术 2.2.1. Voice Centric 若 Ue_Usage_Setting 为 Voice Centric，则设备必须在当前 RAT 中具备语音服务。如下为设备驻留 RAT 的三种场景。 1. 当设备注册 LTE、网络端回复注册消息为 EPS/IMSI 联合注册、且网络支持 CS 服务（2G 和 3G 网络）时，那么设备可驻留在该 RAT。 2. 当设备注册 LTE、网络端回复注册消息为 EPS/IMSI 联合注册、且网络不支持 CS 服务（2G 或 3G 网络）时，那么设备将检查是否获取 VoLTE 服务： ⚫ 若获取 VoLTE 服务，则设备可驻留在该 RAT，且同时支持数据和语音服务； ⚫ 若不获取 VoLTE 服务，设备将限制当前 RAT，并搜索支持的 2G 和 3G 网络 RAT，以获取语 音服务。若不支持 2G/3G，则设备进入无服务状态（无数据或语音服务）。 3. 当设备注册 LTE、网络端回复注册消息为 EPS only 时，那么设备将检查是否获取 VoLTE 服务： ⚫ 若获取 VoLTE 服务，则设备将驻留在该 RAT； ⚫ 若不获取 VoLTE 服务，设备将限制当前 RAT，并搜索支持的 2G 和 3G 网络 RAT，以获取语 音服务。若不支持 2G/3G，则设备进入无服务状态（无数据或语音服务）。 2.2.2. Data Centric 若 Ue_Usage_Setting 为 Data Centric，则设备必须在当前 RAT 中具备数据服务。如下为设备驻留 RAT 的三种场景。 1. 当设备注册 LTE、网络端回复注册消息为 EPS/IMSI 联合注册、且网络支持 CS 服务（2G 和 3G 网络）时，那么设备可驻留在该 RAT。设备同时支持语音与数据服务。 2. 当设备注册 LTE、网络端回复注册消息为 EPS/IMSI 联合注册、且网络不支持 CS 服务（2G 或 3G 网络）时，那么设备将检查是否获取 VoLTE 服务： ⚫ 若获取 VoLTE 服务，则设备可驻留在该 RAT，且同时支持数据和语音服务； ⚫ 若不获取 VoLTE 服务，则设备可驻留在该 RAT，且仅支持数据服务。 3. 当设备注册 LTE、网络端回复注册消息为 EPS only 时，那么设备将检查是否获取 VoLTE 服务： ⚫ 若获取 VoLTE 服务，则设备可驻留在该 RAT，且同时支持数据和语音服务； ⚫ 若不获取 VoLTE 服务，则设备可驻留在该 RAT，且仅支持数据服务。 上海移远通信技术股份有限公司 8 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 3 软件配置 本章节将依据终端设备类型以及应用场景介绍将终端设备 Ue_Usage_Setting 配置为 AT&T 要求的 Data Centric 的流程。 3.1. 终端设备为 Data-only 如果终端设备为 Data-only（仅支持数据），不需要语音服务（语音服务包含 2G/3G 下的 CS 语音及 LTE 下的 VoLTE 功能），可按照如下流程在 MCU 上将模块 Ue_Usage_Setting 修改为 Data Centric（无需判断 运营商信息以及是否漫游）。 开始 (U)SIM卡已 就绪 是 执行AT+QNVFR='/nv/item_files/modem/mmode/ ue_usage_setting'查询是否为Data Centric 否 执行 A T+QN VFW='/nv/ite m_files/mode m/mmode/ue_us age_se tt in g', 01将Ue_Usage_Setting配置为Data Centric 执行 A T+C FUN =1,1或PWR KEY键重 启模块 使配 置生效 结束 图 2：Data-only 设备软件配置流程图 检查 Ue_Usage_Setting 是否配置为 AT&T 要求的 Data Centric，若未配置为 Data Centric，则执行 AT+QNVFW='/nv/item_files/modem/mmode/ue_usage_setting',01 配置为 Data Centric。 上海移远通信技术股份有限公司 9 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 AT+QNVFR='/nv/item_files/modem/mmode/ue_usage_setting' +QNVFR: 01 //查询当前配置。 //01 表示 Data Centric，00 表示 Voice Centric。 OK AT+QNVFW='/nv/item_files/modem/mmode/ue_usage_setting',01 OK //配置 Ue_Usage_Setting 为 Data Centric。 有关上述 AT 命令的详细信息，请联系移远通信技术支持（support@quectel.com）。 3.2. 终端设备为 Data + Voice 且不需要漫游 如果终端设备为 Data + Voice（同时支持语音和数据服务），且需要语音服务（语音服务包含 2G/3G 下 的 CS 语音及 LTE 下的 VoLTE 功能），同时无漫游场景（例如若插入 Telus 运营商(U)SIM 卡，设备仅会在 Telus 网络下使用；插入 AT&T (U)SIM 卡，设备仅会在 AT&T 网络下使用，以此类推），可以按照如下流程 图在 MCU 上将模块 Ue_Usage_Setting 修改为 Data Centric（仅需判断运营商信息）。 开始 (U)SIM卡已 就绪 执行AT+QNVFR='/nv/item_files/modem/mmode/ 是 ue_usage_setting'查询Ue_Usage_Setting是否为Data Centric 否 确认是否为 AT&T (U)SIM卡 否 （IMSI为 310 410/313 100/310 170等） 是 执行 A T+QN VFW='/nv/ite m_files/mode m/mmode/ue_us age_se tt in g',01 配置Ue_Usage_Setting为Data Centric 执行 A T+C FUN =1,1或PWR KEY键重 启模块 使配置 生效 结束 图 3：Data + Voice 设备且无需漫游的软件配置流程图 上海移远通信技术股份有限公司 10 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 检查 Ue_Usage_Setting 是否配置为 AT&T 要求的 Data Centric，若未配置为 Data Centric，则执行 AT+QNVFW='/nv/item_files/modem/mmode/ue_usage_setting',01 将其配置为 Data Centric。 AT+QNVFR='/nv/item_files/modem/mmode/ue_usage_setting' +QNVFR: 01 //查询当前配置。 //01 表示 Data Centric，00 表示 Voice Centric。 OK AT+QNVFW='/nv/item_files/modem/mmode/ue_usage_setting',01 OK //配置 Ue_Usage_Setting 为 Data Centric。 执行 AT+CIMI，通过返回的 IMSI 值的前六位（是否为 310410 /313100/310170/310150 等）可判断当 前(U)SIM 卡的运营商是否为 AT&T 或 FirstNet。关于如何通过 IMSI 值判断运营商，详见第 4.1 章。 也可以执行 AT+QMBNCFG='List'查询当前已激活的 MBN 中是否包含 AT&T，示例如下： AT+QMBNCFG='List' //查询当前 MBN 信息。 +QMBNCFG:'List',0,0,0,'ROW_Generic_3GPP',0x0501081F,201901141 +QMBNCFG: 'List',1,1,1,'VoLTE-ATT',0x0501033C,201909271 //AT&T 已激活。 OK 备注 1. 有关 AT+CIMI 和 AT+COPS?的详细信息，详见文档 [1]。 2. 有关 AT+QMBNCFG='List'的详细信息，详见文档 [2]。 3.3. 终端设备为 Data + Voice 且需要漫游 如果终端设备为 Data + Voice（同时支持语音与数据），需要语音服务（语音服务包含 2G/3G 下 CS 语 音及 LTE 下 VoLTE 功能），同时设备插入其他运营商（如 Telus）(U)SIM 卡或者虚拟运营商漫游到 AT&T 网络下时，可以按照如下流程图在 MCU 上将模块 Ue_Usage_Setting 修改为 Data Centric（需判断运营商 信息以及是否漫游）： 上海移远通信技术股份有限公司 11 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 开始 (U)SIM卡就 绪 执行AT+QNVFR='/nv/item_files/ 是 mode m/mmode/ue_us age_se tt in g'检查 Ue_Usage_Setting是否为Data Centric并检查恢复运 营商配置标志为 False 否 是否为AT&T (U)SIM卡（IMSI为 否 310 410/313 100/310 170等） 是 执行 AT+QNVFW='/nv/item_files/modem/mmode/ue_usage_setti ng',01，配置Ue_Usage_Setting为Data Centric 是否已连接 AT&T网络（PLMN为310 410/313 100） 是 执行AT+QNVFR='/nv/item_files/ mode m/mmode/ue_us age_se tt in g' 查询Ue_Usage_Setting是否为Data Centric 否 设置 恢复运 营商配 置标志 为Tr ue 恢复 运营商 配置标 志是否 否 为True 否 是 是 恢复 配置 AT+QNVFW='/nv/item_files/modem/m mode/ue_us age_se tt in g',00 并设 置恢复 运营商 配置标 志为 Fa lse 执行 A T+C FUN =1,1或PWR KEY键重 启模块 使配 置生效 结束 图 4：Data + Voice 设备且需要漫游的软件配置流程图 按照第 3.2 章的操作，依次执行相关命令。 执行 AT+COPS?可以查询当前所有网络运营商信息，查看注册状态是否为已注册，并确认 PLMN 信息 是否为 310410/313100。 备注 1. 有关 AT+COPS?的详细信息，详见文档 [1]。 2. 该方案不适用漫游场景下切换不同运营商(U)SIM 卡的情况。由于 MCU 获取(U)SIM 卡切换状态切换 及刷新 MBN 比较困难，不建议在 MCU 实现该方案。 上海移远通信技术股份有限公司 12 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 4 常见问题及解决方案 4.1. 无法确认(U)SIM 卡 IMSI AT&T、FirstNet 和 Cricket (U)SIM 卡的 IMSI 列表如下表所示，遇到列表中的某一 IMSI 时，需要将终 端设备 Ue_Usage_Setting 配置为 AT&T 要求的 Data Centric。 表 2：IMSI 列表 (U)SIM 卡 AT&T FirstNet Cricket IMSI 310 030 310 170 310 280 310 410 310 560 311 180 310 950 313 100 312 670 313 130 313 140 310 150 4.2. 不同状态的终端设备的处理建议 4.2.1. 正在使用的设备 针对正在使用的设备，建议使用虚拟运营商的用户不区分设备是否为 Data-only，直接按照第 3.1 章进 行操作。用户也可以根据各运营商的要求按照第 3 章的软件配置方案进行操作。 上海移远通信技术股份有限公司 13 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 4.2.2. 针对认证中的设备 针对认证中的设备，建议优先使用移远通信在 2021 年 8 月以后交付的模块，从而可直接使用移远通信 完整的 3G 退网解决方案。如果认证计划早于 2021 年 8 月，则建议按照第 3 章的软件配置方案由 MCU 程 序端进行处理。 备注 请联系移远通信技术支持获取完整的 3G 退网解决方案（包含 AT&T 3G 退网）。 4.2.3. 针对计划中的设备 针对计划立项的设备，建议优先使用移远通信在 2021 年 8 月以后的交付的模块，从而可直接使用移远 通信完整的 3G 退网解决方案。 上海移远通信技术股份有限公司 14 / 15 EC2x&EG9x&EG2x-G 系列 AT&T 3G 退网软件配置指导 5 附录 参考文档和术语缩写 表 3：参考文档 文档名称 [1] Quectel_EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual [2] Quectel_EC2x&EG9x&EG2x-G&EM05_Series_IMS_Application_Note 表 4：术语缩写 缩写 CS EPS IMS IMSI LTE MCU PLMN RAT (U)SIM UE VoLTE 英文全称 中文全称 Circuit Switching 电路交换 Evolved Packet System 演进型分组系统 IP Multimedia Subsystem IP 多媒体子系统 Internation Mobile Subscriber Identity 国际移动用户识别码 Long-Term Evolution 长期演进 Microcontroller Unit/Microprogrammed Control Unit 微型控制单元/微程序控制器 Public Land Mobile Network 公共陆地移动网络 Radio Access Technology 无线接入技术 (Universal) Subscriber Identity Module （通用）用户身份识别模块 User Equipment 用户设备 Voice over Long-Term Evolution 长期演进语音承载 上海移远通信技术股份有限公司 15 / 15

BG95&BG77&BG600L Series Fast Shutdown Application Note LPWA Module Series Version: 1.0 Date: 2021-03-29 Status: Released LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, visit: http://www.quectel.com/support/technical.htm Or send 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 the use of or reliance upon the information. All information supplied herein is subject to change without prior notice. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without prior written consent by Quectel. Quectel reserves the right to take legal action for any noncompliance with the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information. BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 1 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 2 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note About the Document Revision History Version 1.0 Date 2020-11-20 2021-03-29 Author Egbert XU/ Matt YE Egbert XU/ Matt YE Description Creation of the document First official release BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 3 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. Applicable Modules ................................................................................................................. 6 2 Fast Shutdown Mechanism ................................................................................................................ 7 2.1. Fast Shutdown Triggered by Pin ............................................................................................. 7 2.2. Fast Shutdown Triggered by AT Command ............................................................................ 7 3 Fast Shutdown AT Commands........................................................................................................... 8 3.1. AT Command Syntax............................................................................................................... 8 3.1.1. Definitions......................................................................................................................... 8 3.1.2. AT Command Syntax ....................................................................................................... 8 3.2. Declaration of AT Command Examples .................................................................................. 9 3.3. Description of Fast Shutdown AT Commands......................................................................... 9 3.3.1. AT+QCFG='fast/poweroff' Enable/Disable Fast Shutdown Function........................... 9 3.3.2. AT+QPOWD Power off the Module............................................................................. 10 4 Typical Application ............................................................................................................................ 12 5 Appendix A References..................................................................................................................... 13 BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 4 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Types of AT Commands ................................................................................................................. 8 Table 3: Related Documents ...................................................................................................................... 13 Table 4: Terms and Abbreviations .............................................................................................................. 13 BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 5 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note 1 Introduction Usually, shutdown takes too long, and sometimes the module may be powered off abnormally, which may cause file system damage. In order to resolve this issue, Quectel has implemented a fast shutdown feature which can reduce shutdown time to less than 100 ms without damaging the file system. However, note that the data to be written into the internal flash may be lost due to fast shutdown. Two methods for enabling the fast shutdown feature are introduced in this document.  One is by running the AT+QCFG='fast/poweroff' command and pulling down the pin of the module. When the module detects a falling edge, it will complete the current access and stop writing new data into the file system, and then cut off the power supply.  The other is by running the AT+QPOWD=2 command to shut down the module immediately without waiting for pin pull-down. This document explains the fast shutdown feature and how to use it. 1.1. Applicable Modules Table 1: Applicable Modules Module Series BG95 BG77 BG600L Model BG95-M1 BG95-M2 BG95-M3 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 6 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note 2 Fast Shutdown Mechanism 2.1. Fast Shutdown Triggered by Pin AT+QCFG='fast/poweroff' configures a dedicated GPIO pin (see document [3] to [5] for details) as an input pin with internal pull-up and interrupt features. The interrupt feature is triggered by a falling edge. The module will finish the current process of writing the data into the flash block, and the other data that are waiting to be written will be discarded. After the current data writing process is completed, the file system cannot be accessed anymore, and the power supply will be cut off. GPIO_INT VDD_EXT Flash status ACTIVE ≤ 100 ms ACTIVE INACTIVE Finishes the current process of writing the data into the flash block, and the other data that are waiting to be written will be discarded. Power off Figure 1: Fast Shutdown Timing INACTIVE 2.2. Fast Shutdown Triggered by AT Command AT+QPOWD also triggers fast shutdown. When this command executes, the fast shutdown procedure is the same as above. BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 7 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note 3 Fast Shutdown AT Commands 3.1. AT Command Syntax 3.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on the command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified.  Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 8 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note 3.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you familiarize with AT commands and learn how to use them. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. 3.3. Description of Fast Shutdown AT Commands 3.3.1. AT+QCFG='fast/poweroff' Enable/Disable Fast Shutdown Function This command enables/disables the fast shutdown function triggered by a dedicated pin. AT+QCFG='fast/poweroff' Enable/Disable Fast Shutdown Function Test Command AT+QCFG=? Response … +QCFG: 'fast/poweroff',,(list of supported s) Write Command AT+QCFG='fast/poweroff'[,,] OK Response If the optional parameters are omitted, query the current configuration: +QCFG: 'fast/poweroff',, OK If the optional parameters are specified, configure GPIO for fast shutdown: OK Maximum Response Time Characteristics If there is an error: ERROR 300 ms The command takes effect immediately. The configuration is saved automatically. BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 9 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note Parameter Integer type. Pin number of a dedicated GPIO which is configured as an input pin with internal pull-up and interrupt features. The dedicated pin is triggered by a falling edge for fast shutdown. 25 Pin 25 (GPIO1), valid for BG95 series only 63 Pin 63 (GOIO7), valid for BG77 only 11 Pin 11 (GPIO3), valid for BG600L-M3 only Integer type. Enable/Disable fast shutdown function. 0 Disable 1 Enable Example //For BG95 series module AT+QCFG='fast/poweroff',25,1 OK AT+QCFG='fast/poweroff' +QCFG: 'fast/poweroff',25,1 //Configure pin 25 (GPIO1) as the fast shutdown pin and enable the fast shutdown function. //Query the current configuration. //Pin 25 is configured as the fast shutdown pin, and the fast shutdown function is enabled. OK 3.3.2. AT+QPOWD Power off the Module This command powers off the module. When the command is executed successfully, the UE immediately returns OK and deactivates the network. After that, the UE sends the POWERED DOWN message and enters power-off state. The maximum time for unregistering from the network is 60 s. If you use immediate or normal power-down, to avoid data loss, the module needs to remain connected to the power supply until it sends the POWERED DOWN message and sets the STATUS pin to low. AT+QPOWD Power off the Module Test Command AT+QPOWD=? Response +QPOWD: (list of supported s) Write/Execution Command AT+QPOWD[=] OK Response OK Maximum Response Time Characteristics POWERED DOWN 300 ms The command takes effect immediately. BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 10 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note The configuration is not saved. Parameter Integer type. Shutdown mode. 0 Immediate power-down 1 Normal power-down 2 Fast shutdown NOTES 1. The fast shutdown time is less than 100 ms. 2. If is 2, there is no POWERED DOWN response. BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 11 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note 4 Typical Application In some usage scenarios, the power supply of the module may be cut off suddenly during the writing of the data into the file system. It may cause file system damage. In order to avoid this issue, you can add a supper capacitor, which can extend discharge time in the event of external voltage drop, to ensure that the module continues to work for more than 100 ms after the power supply is cut off. When the external MCU detects the powering down, it must pull down the fast shutdown pin and the module will be powered off within 100 ms. BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 12 / 13 LPWA Module Series BG95&BG77&BG600L Series Fast Shutdown Application Note 5 Appendix A References Table 3: Related Documents SN Document Name Description Quectel_BG95&BG77&BG600L_Series_QCFG_ AT+QCFG Command Manual for BG95 [1] AT_Commands_Manuall Series, BG77 and BG600L-M3 Modules Quectel_BG95&BG77&BG600L_Series_AT_ [2] Commands_Manuall AT Commands Manual for BG95 Series, BG77 and BG600L-M3 Modules [3] Quectel_BG95_Series_Hardware_Design BG95 Series Hardware Design [4] Quectel_BG600L-M3_Hardware_Design BG600L-M3 Hardware Design [5] Quectel_BG77_Hardware_Design BG77 Hardware Design Table 4: Terms and Abbreviations Abbreviation EGPRS GPIO LPWA MCU UE Wi-Fi Description Enhanced General Packet Radio Service General Purpose Input/Output Low-Power Wide-Area Microcontroller Unit User Equipment Wireless Fidelity BG95&BG77&BG600L_Series_Fast_Shutdown_Application_Note 13 / 13

BC25&BC32 系列 TCP/IP 应用指导 NB-IoT 模块系列 版本：1.1 日期：2020-11-11 状态：受控文件 www.quectel.com BC25&BC32 系列 TCP/IP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 35 BC25&BC32 系列 TCP/IP 应用指导 文档历史 修订记录 版本 1.0 日期 2019-10-23 作者 宋聪强 1.1 2020-11-11 宋聪强 变更表述 受控版本 1. 增加 AT 命令类型说明（第 2.1 章）； 2. 更新 URC +QIOPEN: ,上报 的最大等待时间（第 2.2.1 章）； 3. 更新 AT+QISEND 中的取值范围 （第 2.2.4 章）； 4. 更新 AT+QIRD 中的取值范围（第 2.2.5 章）； 5. 更新 AT+QISENDEX 中的取值 范围（第 2.2.6 章）； 6. 新增 AT+QICFG='open_time'（第 2.2.11 章）； 7. 增 加 AT+QIDNSCFG 中 和 的最大长度（第 2.2.13 章）； 8. 删除 AT+QIKALIVE。 上海移远通信技术股份有限公司 2 / 35 BC25&BC32 系列 TCP/IP 应用指导 目录 文档历史 ............................................................................... 2 目录 ................................................................................... 3 表格索引 ............................................................................... 5 1 引言 ........................................................................................................................................................ 6 1.1. TCP/IP AT 命令简述.................................................................................................................... 6 1.2. 数据访问模式说明 ....................................................................................................................... 6 2 TCP/IP AT 命令详解 .............................................................................................................................. 7 2.1. AT 命令类型 ................................................................................................................................ 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句..................................................................................................................... 7 2.2. AT 命令说明 ................................................................................................................................ 8 2.2.1. AT+QIOPEN 打开 Socket.............................................................................................. 8 2.2.2. AT+QICLOSE 关闭 Socket............................................................................................ 9 2.2.3. AT+QISTATE 查询 Socket 状态 .................................................................................. 10 2.2.4. AT+QISEND 发送文本字符串数据 .............................................................................. 12 2.2.5. AT+QIRD 读取 TCP/IP 数据........................................................................................ 13 2.2.6. AT+QISENDEX 发送十六进制字符串数据 .................................................................. 15 2.2.7. AT+QISWTMD 切换数据访问模式 .............................................................................. 16 2.2.8. AT+QPING Ping 远程服务器 ....................................................................................... 17 2.2.9. AT+QNTP 通过 NTP 服务器同步本地时间.................................................................. 18 2.2.10. AT+QIDNSGIP 转换域名为 IP 地址............................................................................. 19 2.2.11. AT+QICFG 配置可选参数............................................................................................ 20 2.2.12. AT+QIGETERROR 查询最新一次错误码.................................................................... 22 2.2.13. AT+QIDNSCFG 配置 DNS 服务器地址....................................................................... 23 2.3. URC 详解 .................................................................................................................................. 24 2.3.1. +QIURC: 'closed' 连接断开 ........................................................................................ 24 2.3.2. +QIURC: 'recv' 下行数据已达..................................................................................... 24 2.3.3. +QIURC: 'recv' 下行数据缓存已满 ............................................................................. 25 2.3.4. +QIURC: 'incoming full' 下行连接已达上限 ................................................................ 25 2.3.5. +QIURC: 'incoming' 下行连接请求 ............................................................................. 25 3 相关错误码 ........................................................................................................................................... 26 4 举例 ...................................................................................................................................................... 28 4.1. TCP 客户端在缓存模式下工作 .................................................................................................. 28 4.1.1. 创建一个 TCP 客户端连接并进入缓存模式 .................................................................... 28 4.1.2. 在缓存模式下发送数据 ................................................................................................... 28 4.1.3. 在缓存模式下从远程服务器上接收数据.......................................................................... 29 4.1.4. 断开连接 ......................................................................................................................... 30 4.2. TCP 客户端在直吐模式下工作 .................................................................................................. 30 4.2.1. 创建一个 TCP 客户端连接并进入直吐模式 .................................................................... 30 上海移远通信技术股份有限公司 3 / 35 BC25&BC32 系列 TCP/IP 应用指导 4.2.2. 在直吐模式下发送数据 ................................................................................................... 30 4.2.3. 在直吐模式下接收来自远程服务器的数据 ...................................................................... 30 4.2.4. 断开 TCP 客户端连接..................................................................................................... 31 4.3. TCP 服务器在缓存模式下工作 .................................................................................................. 31 4.3.1. 启动 TCP 服务器 ............................................................................................................ 31 4.3.2. 接受 TCP 连接请求......................................................................................................... 31 4.3.3. 从新连接中接收数据....................................................................................................... 31 4.3.4. 关闭 TCP 服务器 ............................................................................................................ 32 4.4. UDP 客户端模式（支持深度睡眠唤醒） ................................................................................... 32 4.5. 进行远程服务器 Ping 操作......................................................................................................... 33 4.6. 同步本地时间............................................................................................................................. 33 4.7. 查询最新一次错误码.................................................................................................................. 33 5 附录 A 参考文档及术语缩写................................................................................................................. 34 上海移远通信技术股份有限公司 4 / 35 BC25&BC32 系列 TCP/IP 应用指导 表格索引 表 1：AT 命令及响应类型 ............................................................................................................................ 7 表 2：错误码概览 ....................................................................................................................................... 26 表 2：Ping 结果概览................................................................................................................................... 27 表 4：参考文档........................................................................................................................................... 34 表 5：术语缩写........................................................................................................................................... 34 上海移远通信技术股份有限公司 5 / 35 BC25&BC32 系列 TCP/IP 应用指导 1 引言 移远通信 BC25 系列和 BC32 系列模块均内置 TCP/IP 协议栈，可直接通过 AT 命令访问网络；这显著 降低了模块对 PPP 和外部 TCP/IP 协议栈的依赖，从而降低终端设计的成本。 BC25&BC32 系列模块可提供 TCP 客户端、UDP 客户端和 TCP 服务器等套接字（Socket）服务。 1.1. TCP/IP AT 命令简述 通过 TCP/IP AT 命令，模块可以打开/关闭 Socket，并通过 Socket 收发数据。 1.2. 数据访问模式说明 BC25&BC32 系列模块支持如下两种数据访问模式： ⚫ 缓存模式 ⚫ 直吐模式 当使用 AT+QIOPEN 打开 Socket 服务时，可通过指定 Socket 的数据访问模式；当 Socket 服务成功打开后，可通过 AT+QISWTMD 切换数据访问模式。两种访问模式下，均可通过 AT+QISEND 或 AT+QISENDEX 发送数据。 1. 缓 存 模 式 下 ， 从 网 络 接 收 数 据 时 ， 模 块 缓 存 所 接 收 到 的 数 据 ， 并 上 报 URC +QIURC: 'recv',[,]，之后用户可通过 AT+QIRD 读取缓存的数据。 2. 直吐模式下，从网络接收数据时，模块以如下格式的 URC 直接输出数据到 COM 口：+QIURC: 'recv',[,[]]。 备注 1. 缓存模式下，在缓存数据被全部读取完之前，模块不会再上报新的 URC 通知 MCU 收到下行数据。 2. 可通过 AT+QICFG 配置是否显示，请参考第 2.2.11 章。 上海移远通信技术股份有限公司 6 / 35 BC25&BC32 系列 TCP/IP 应用指导 2 TCP/IP AT 命令详解 本章节主要描述和 TCP/IP 相关的 AT 命令。 2.1. AT 命令类型 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应，省略。 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 7 / 35 BC25&BC32 系列 TCP/IP 应用指导 2.2. AT 命令说明 2.2.1. AT+QIOPEN 打开 Socket 服务 该命令用于打开 Socket 服务以创建 TCP/UDP 连接。可通过指定服务类型，并通过 指定数据访问模式。命令执行成功以后，会上报 URC +QIOPEN: ,指 示 Socket 服务是否成功打开。 AT+QIOPEN 打开 Socket 服务 测试命令 AT+QIOPEN=? 响应： +QIOPEN: (支持的范围),(支持的 范围),'TCP/UDP/TCP LISTENER','/',[,[,(支持的列表)[,(支持的列表)]]] OK 设置命令 响应： AT+QIOPEN=,,,'/',[,<loc +QIOPEN: , al_port>[,[,]]] 若有任何错误： ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后仍有效；配置自动保存至 NVM。 参数 整型。上下文 ID。范围：1~3。 整型。Socket ID。范围：0~5。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器端监听 TCP 连接'UDP SERVICE' 建立 UDP 服务（暂不支持） 字符串类型。远程服务器的 IP 地址，例如：220.18.23.22。最大长度：50 字节。 字符串类型。远程服务器的域名地址。最大长度：50 字节。 整型。远程服务器端口号。范围：1~65535。仅当为'TCP'或'UDP' 时有效。若为'TCP LISTENER'，该参数配置无意义。 整型。本地端口号。 上海移远通信技术股份有限公司 8 / 35 BC25&BC32 系列 TCP/IP 应用指导 若为'TCP LISTENER'，此参数必须指定，不可省略。范围：1~65535。 若为'TCP'或者'UDP'，此参数可省略。范围：0~65535；默认值： 0，表示自动分配本地端口。 整型。Socket 服务的数据访问模式。 0 缓存模式 1 直吐模式 整型。互联网协议类型。 0 IPv4 1 IPv6 整型。错误码，详情请参考第 3 章。 备注 1. 若使用创建连接，URC +QIOPEN: ,上报的最大等待时间为（140 + （请参考 AT+QICFG='open_time'））秒；若使用创建连接，URC 上报的最大等待时间为秒。 2. 当模块从深度睡眠状态唤醒，TCP 连接需通过 AT+QIOPEN 重新开启 Socket；UDP 连接支持深度睡 眠唤醒功能，能够恢复至进入深度睡眠前的状态，不需要重新开启 Socket 并可以直接收发数据，此 时使用相同开启 Socket 会报错。 3. 客户端模式下，建议使用默认值 0，使模块自动分配本地端口。若需要配置，建议避免 使用 1000~1500 范围内的端口。另外，指定的本地端口不可以重复。 2.2.2. AT+QICLOSE 关闭 Socket 服务 该命令用于关闭指定的 Socket 服务。 AT+QICLOSE 关闭 Socket 服务 测试命令 AT+QICLOSE=? 响应 +QICLOSE: (支持的范围) 设置命令 AT+QICLOSE= OK 响应 若成功关闭： OK CLOSE OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 9 / 35 参数 整型。Socket ID。范围：0~5。 BC25&BC32 系列 TCP/IP 应用指导 2.2.3. AT+QISTATE 查询 Socket 服务状态 该命令用于查询 Socket 服务状态。 AT+QISTATE 查询 Socket 服务状态 测试命令 AT+QISTATE=? 查询命令 AT+QISTATE? 响应 OK 响应 返回当前存在的所有连接状态： [+QISTATE: ,,,,,,,] […] OK 若有任何错误： ERROR 设置命令 响应 若为 0，查询指定上下文的 [+QISTATE: ,,,,,,<contex AT+QISTATE=,,] D> […] OK 设置命令 若为 1，查询指定 Socket 服务的连接状态 AT+QISTATE=, 若有任何错误： ERROR 响应 [+QISTATE: ,,,,,,,] OK 若有任何错误： ERROR 上海移远通信技术股份有限公司 10 / 35 BC25&BC32 系列 TCP/IP 应用指导 最大响应时间 特性说明 300 毫秒 / 参数 整型。查询类型。 0 查询指定的的连接状态 1 查询指定的的连接状态 整型。上下文 ID。范围：1~3。 整型。Socket ID。范围：0~5。 字符串类型。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 'TCP INCOMING' 建立 TCP 服务器端监听 TCP 连接 建立 TCP 服务器端接受的 TCP 连接（请参考第 2.3.5 章） 字符串类型。IP 地址。 若为'TCP'或'UDP'，则指远程服务器 IP 地址 若为'TCP LISTENER'，则指本地 IP 地址 若为'TCP INCOMING'，则指远程客户端 IP 地址 整型。端口号。 若为'TCP'或'UDP'，则指远程服务器端口 若为'TCP LISTENER'，则端口无效且始终为 0 若为'TCP INCOMING'，则指远程客户端端口 整型。分配的或指定的本地端口号。 整型。Socket 状态。 0 'idle'：客户端连接尚未建立 1 'connecting'：客户端正在连接 2 'connected'：客户端连接已经创建成功 3 'closing'：客户端连接正在关闭 4 'remote closing'：远程服务器正在关闭客户端连接 5 'closed'：连接已关闭 整型。数据访问模式 0 缓存模式 1 直吐模式 上海移远通信技术股份有限公司 11 / 35 BC25&BC32 系列 TCP/IP 应用指导 2.2.4. AT+QISEND 发送文本字符串数据 该命令用于通过指定连接发送文本字符串格式的 Socket 数据。 AT+QISEND 发送文本字符串数据 测试命令 AT+QISEND=? 响应 +QISEND: ( 支 持 的 范 围 ),( 支 持 的 范围),'' 设置命令 非数据模式下发送定长数据 AT+QISEND=,,'' OK 响应 若连接已建立，且发送成功： OK SEND OK 若连接已建立，但发送缓存已满或发送失败： OK 设置命令 数据模式下发送不定长数据 AT+QISEND= SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 响应 > 响应>后，模块将在 500 毫秒内进入数据模式；之后可直接输 入待发数据，按 Ctrl+Z 发送数据，按 Esc 取消发送。 若连接已建立，且发送成功： OK SEND OK 若连接已建立，但发送缓存已满或发送失败： OK SEND FAIL 设置命令 数据模式下发送定长数据 AT+QISEND=, 若连接未建立，异常断开或者参数不正确： ERROR 响应 > 响应>后，模块将在 500 毫秒内进入数据模式；之后可输入长 度等于的待发数据。 上海移远通信技术股份有限公司 12 / 35 最大响应时间 特性说明 BC25&BC32 系列 TCP/IP 应用指导 若连接已建立，且发送成功： OK SEND OK 若连接已建立，但发送缓存已满： OK SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 300 毫秒 / 参数 整型。Socket ID。范围：0~5。 整型。待发数据长度。最大长度：1440 字节。 字符串类型。待发送的文本或者十六进制字符串格式 1)数据。 非数据模式下，发送定长数据（AT+QISEND=,,）， 的内容需使用双引号标识，例如：'data'。数据模式下，的内容无需使 用双引号标识。 备注 1. 1) 此命令目前暂不支持发送十六进制格式数据。 2. SEND OK 仅表示数据已经发送至协议栈。 3. 只有在 Socket 的是'TCP'、'UDP'或'TCP INCOMING'时，方可成功发送； 若为'TCP LISTENER'，则返回 ERROR。可通过 AT+QISTATE 查询。 4. 数据模式下返回>后，若发送的数据为空，按 Ctrl+Z 后会立即返回 SEND FAIL。 2.2.5. AT+QIRD 读取 TCP/IP 数据 该命令用于读取从指定连接接收的 Socket 数据。 在缓存模式下，模块接收到数据后会缓存数据，并向外部 MCU 上报 URC：+QIURC: 'recv',[,]以告知接收到新的下行数据。 上海移远通信技术股份有限公司 13 / 35 BC25&BC32 系列 TCP/IP 应用指导 AT+QIRD 读取 TCP/IP 数据 测试命令 AT+QIRD=? 响应 +QIRD: (支持的范围),(支持的 范围) 设置命令 AT+QIRD=, OK 响应 若指定连接收到数据： +QIRD: [,] OK 若无数据： +QIRD: 0 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。Socket ID。范围：0~5。 整型。待读取数据的最大长度。范围：1~1024；单位：字节。 整型。已读取数据的长度。单位：字节。 整型。剩余数据的长度。单位：字节。 字符串类型。读取的数据。 备注 1. 接收缓存池中仍有数据未读取时，模块若再次接收到下行数据将不会上报新的 URC；只有当缓存池 中所有数据均被读取完成后，才会上报新的 URC。 2. 配置 AT+QICFG='showlength',1（详情请参考第 2.2.11 章）后，模块才会在缓存模式下显示该命 令 返 回 值 中 的 可 选 长 度 参 数 ， 以 及 下 行 数 据 URC 的 可 选 长 度 参 数 。 3. 剩余长度并非缓存池已接收数据的总长度，仅表示某一节点中保存的当前剩余数据长度。 4. 该命令仅在为'TCP'、'UDP'或'TCP INCOMING'时有效。 上海移远通信技术股份有限公司 14 / 35 BC25&BC32 系列 TCP/IP 应用指导 2.2.6. AT+QISENDEX 发送十六进制字符串数据 该命令用于通过指定连接发送十六进制字符串 Socket 数据。 AT+QISENDEX 发送十六进制字符串数据 测试命令 AT+QISENDEX=? 响应 +QISENDEX: (支持的范围),(支持的范 围),'' 设置命令 非数据模式下发送定长数据 AT+QISENDEX=,< send_length>,'' OK 响应 若连接已建立，且发送成功： OK SEND OK 若连接已建立，但发送缓存已满或发送失败： OK SEND FAIL 设置命令 数据模式下发送不定长数据 AT+QISENDEX= 若连接未建立，异常断开或者参数不正确： ERROR 响应 > 响应>后，模块将在 500 毫秒内进入数据模式；之后可直接输入待发 十六进制字符串数据，按 Ctrl+Z 发送数据，按 Esc 取消发送。 若连接已建立，且发送成功： OK SEND OK 若连接已建立，但发送缓存已满或者发送失败： OK SEND FAIL 设置命令 数据模式下发送定长数据 AT+QISENDEX=,< send_length> 若连接没有建立、异常断开或者参数不正确： ERROR 响应 > 响应>后，模块将在 500 毫秒内进入数据模式；之后可输入长度等于 的待发十六进制字符串数据。 上海移远通信技术股份有限公司 15 / 35 最大响应时间 特性说明 BC25&BC32 系列 TCP/IP 应用指导 若连接已建立，且发送成功： OK SEND OK 若连接已建立，但发送缓存已满： OK SEND FAIL 若连接没有建立、异常断开或者参数不正确： ERROR 300 毫秒 / 参数 整型。Socket ID。范围：0~5。 整型。待发数据长度。最大长度：1440 字节。 字符串类型。待发送的十六进制字符串数据。 非数据模式下，发送定长数据（AT+QISENDEX=,,），的内容需使用双引号标识，例如：'3031323334'。数据 模式下，的内容无需使用双引号标识。 备注 1. SEND OK 仅表示数据已经发送至协议栈。 2. 只有在 Socket 的是'TCP'、'UDP'或'TCP INCOMING'时，方可成功 发送；若为'TCP LISTENER'，则返回 ERROR。可通过 AT+QISTATE 查询。 3. 数据模式下返回>后，若发送数据为空，按 Ctrl+Z 后会立即返回 SEND FAIL。 4. 的大小应为实际长度的一半。 2.2.7. AT+QISWTMD 切换数据访问模式 该命令可以用于在成功打开 Socket 后切换数据访问模式。打开新 Socket 时，模块可通过 AT+QIOPEN 的指定数据访问模式。 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应 +QISWTMD: ( 支 持 的 范 围 ),( 支 持 的 列表) 上海移远通信技术股份有限公司 16 / 35 BC25&BC32 系列 TCP/IP 应用指导 OK 查询命令 响应 AT+QISWTMD? OK 设置命令 响应 AT+QISWTMD=, 若有任何错误： ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效。 深休眠唤醒后仍有效；参数设置将自动保存至 NVM。 参数 整型。Socket ID。范围：0~5。 整型。Socket 的数据访问模式。 0 缓存模式 1 直吐模式 2.2.8. AT+QPING Ping 远程服务器 该命令用于测试主机设备的 IP 地址是否可达。 AT+QPING Ping 远程服务器 测试命令 AT+QPING=? 响应 +QPING: ( 支 持 的 范 围 ),''[,( 支 持 的 范 围 )[,( 支 持 的 范 围 )[,( 支 持 的 范围)]]] 设置命令 AT+QPING=,''[,[,[,]]] OK 响应 若远程服务器 Ping 成功： OK +QPING: [,,,,] […] +QPING: [,,,,,,] 上海移远通信技术股份有限公司 17 / 35 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / BC25&BC32 系列 TCP/IP 应用指导 参数 整型。上下文 ID。范围：1~3。 字符串类型。远程服务器地址，格式为域名或者点分十进制 IP 地址。最大长度：50 字节。 整型。每次 Ping 请求后等待响应的最大时长。范围：1~255；默认值：4；单位：秒。 整型。发送 Ping 请求的最大次数。范围：1~10；默认值：4。 整型。每个 Ping 请求的大小。范围：32~200；默认值：32；单位：字节。 整型。每次 Ping 请求的结果。 0 接收到远程服务器的响应，会返回,,, 1 其他 Ping 超时 错误码；请参考第 3 章获取详细错误码信息 字符串类型。远程服务器的 IP 地址。格式为点分十进制。 整型。每次发送的 Ping 请求长度。单位：字节。 整型。发送 Ping 请求花费的时间。单位：毫秒。 整型。Ping 请求的 TTL 值。 整型。Ping 操作的最终结果。 2 其他 Ping 成功 错误码；请参考第 3 章获取详细错误码信息 整型。Ping 请求发送的字节总长度。 整型。Ping 响应中接收到的字节总长度。 整型。Ping 请求中丢失的字节总长度。 整型。最小响应时间。单位：毫秒。 整型。最大响应时间。单位：毫秒。 整型。平均响应时间。单位：毫秒。 2.2.9. AT+QNTP 通过 NTP 服务器同步本地时间 该命令用于通过 NTP 服务器同步本地时间为世界标准时间（UTC）。 AT+QNTP 通过 NTP 服务器同步本地时间 测试命令 响应 AT+QNTP=? +QNTP: (支持的范围),''[,[,(支 持的列表)]] 上海移远通信技术股份有限公司 18 / 35 BC25&BC32 系列 TCP/IP 应用指导 OK 设置命令 AT+QNTP=,''[,< port>[,]] 响应 若同步成功： OK +QNTP: , 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。上下文 ID。范围：1~3。 字符串类型。NTP 服务器地址，格式为域名或者点分十进制 IP 地址。最大长度：50 字节。 整型。NTP 服务器端口号。范围：1~65535；默认值：123。 整型。是否自动同步本地时间为 UTC。 0 不自动同步 1 自动同步 字符串类型。从 NTP 服务器上同步的时间。 格式为：'YY/MM/DD,hh:mm:ss±zz'，各字符分别表示年（YY）、月（MM）、日（DD）、 时（hh）、分（mm）、秒（ss）、时区（±zz）。±zz 的范围：-48~56。 整型。错误码，详情请参考第 3 章。 备注 当为 1，RTC 会自动更新到同步时间。 2.2.10. AT+QIDNSGIP 转换域名为 IP 地址 该命令用于将指定域名转换为 IP 地址格式。 AT+QIDNSGIP 转换域名为 IP 地址 测试命令 AT+QIDNSGIP=? 响应 +QIDNSGIP: (支持的范围),'' 设置命令 OK 响应 上海移远通信技术股份有限公司 19 / 35 BC25&BC32 系列 TCP/IP 应用指导 AT+QIDNSGIP=,'' OK +QIURC: 'dnsgip',,, [+QIURC: 'dnsgip',] […] 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。上下文 ID。范围：1~3。 字符串类型。域名。最大长度：50 字节。 整型。对应的 IP 地址个数。 整型。DNS 的 TTL 值。 字符串类型。的 IP 地址。 整型。错误码，详情请参考第 3 章。 2.2.11. AT+QICFG 配置可选参数 该命令用于为 TCP/IP 各项功能配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应 +QICFG: 'dataformat',(支持的列表),(支 持的列表) +QICFG: 'viewmode',(支持的列表) +QICFG: 'showlength',(支持的列表) +QICFG: 'open_time',(支持的范围) 设置命令 查询/设置发送/接收数据的格式 AT+QICFG='dataformat'[,,] OK 响应 若省略可选参数，则查询当前配置： +QICFG: 'dataformat',, OK 若指定可选参数，则设置发送数据格式和接收数据格式： OK 上海移远通信技术股份有限公司 20 / 35 BC25&BC32 系列 TCP/IP 应用指导 设置命令 查询/设置接收数据的输出格式 AT+QICFG='viewmode'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'viewmode', OK 若指定可选参数，则设置已接收数据的输出格式： OK 若有任何错误： 设置命令 ERROR 响应 查询/设置缓存模式下是否显示可选长 若省略可选参数，则查询当前配置： 度参数 +QICFG: 'showlength', AT+QICFG='showlength'[,] OK 若指定可选参数，则设置在缓存模式下是否显示可选数据长度参 数： OK 设置命令 查询/设置 TCP 连接的超时时间 AT+QICFG='open_time'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'open_time', OK 若指定可选参数，则设置 TCP 连接的超时时间： OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效。 深休眠唤醒后仍有效；参数配置不保存，其他参数 配置自动保存至 NVM。 上海移远通信技术股份有限公司 21 / 35 BC25&BC32 系列 TCP/IP 应用指导 参数 整型。发送数据的格式。 0 文本字符串格式 1 十六进制格式 整型。接收数据的格式。 0 文本字符串格式 1 十六进制格式 整型。已接收数据的输出格式。 0 已收数据输出格式：data headerrndata 1 已收数据输出格式：data header,data 整型。在缓存模式下是否显示可选长度参数。 0 不显示 1 显示 整型。TCP 连接的超时时间。范围：1~36；默认值：36；单位：秒。 备注 1. 目前仅支持配置为文本格式；需发送十六进制数据时，可通过 AT+QISENDEX 发送。 2. 设置的可选长度参数包括以下参数： ⚫ 下行数据 URC 中的 ⚫ AT+QIRD 返回值中的 2.2.12. AT+QIGETERROR 查询上一个错误码 该命令用于查询上一个 TCP/IP 命令返回的错误码及其相应描述。 AT+QIGETERROR 测试命令 AT+QIGETERROR=? 执行命令 AT+QIGETERROR 查询上一个错误码 响应 OK 响应 +QIGETERROR: , OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 22 / 35 BC25&BC32 系列 TCP/IP 应用指导 参数 字符串类型。详细的错误码描述。具体请参考第 3 章。 整型。错误码，详情请参考第 3 章。 2.2.13. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置主要和次要 DNS 服务器地址。 AT+QIDNSCFG 配置 DNS 服务器地址 测试命令 响应 AT+QIDNSCFG=? +QIDNSCFG: [,] 查询命令 AT+QIDNSCFG? OK 响应 +QIDNSCFG: , OK 设置命令 AT+QIDNSCFG=[,] 最大响应时间 特性说明 若有任何错误： ERROR 响应 OK 若有任何错误： ERROR 300 毫秒 该命令立即生效。 深休眠唤醒后无效；参数配置不保存。 参数 字符串类型。主要 DNS 服务器 IP 地址，例如：'220.18.23.22'。最大长度：50 字节。 字符串类型。次要 DNS 服务器 IP 地址，例如：'220.18.23.22'。最大长度：50 字节。 备注 模块成功注网后方可配置 DNS 服务器。 上海移远通信技术股份有限公司 23 / 35 BC25&BC32 系列 TCP/IP 应用指导 2.3. URC 详解 TCP/IP AT 命令的 URC 统一以+QIURC: […]的格式上报通知 MCU，本 文中 URC 前后的均将省略。 2.3.1. +QIURC: 'closed' 连接断开通知 TCP Socket 被远程关闭或因网络异常而断开时，模块上报 URC：+QIURC: 'closed',。 +QIURC: 'closed' 连接断开通知 +QIURC: 'closed', Socket 服务连接被断开。 参数 整型。Socket ID。范围：0~5。 2.3.2. +QIURC: 'recv' 接收下行数据通知 在缓存模式或直吐模式下，当模块从服务器上接收到下行数据时会上报该 URC。 ⚫ 在缓存模式下，URC 格式为+QIURC: 'recv',[,] ⚫ 在直吐模式下，URC 格式为+QIURC: 'recv',[,[]] +QIURC: 'recv' 接收下行数据通知 +QIURC: 'recv',[,] 缓存模式下接收到下行数据。 +QIURC: 'recv',[, 直吐模式下接收到下行数据。 []] 参数 整型。Socket ID。范围：0~5。 整型。实际接收到的数据长度。 接收到的数据 备注 配置 AT+QICFG='showlength',1（详情请参考第 2.2.11 章）后，缓存模式下上报的下行数据已达 URC 才会包含。 上海移远通信技术股份有限公司 24 / 35 BC25&BC32 系列 TCP/IP 应用指导 2.3.3. +QIURC: 'recv' 下行数据缓存已满通知 在缓存模式下，如果已经没有缓存资源可以分配给下行数据，模块会上报该 URC。 +QIURC: 'recv' 下行数据缓存已满通知 +QIURC: 'recv',,'buff full' 下行数据缓存已满。 参数 整型。Socket ID。范围：0~5。 2.3.4. +QIURC: 'incoming full' 下行连接已满通知 当下行连接达到上限，或者当已无 Socket 系统资源可供分配且有下行连接请求时，模块会上报该 URC。 +QIURC: 'incoming full' 下行连接已满通知 +QIURC: 'incoming full' 下行连接已满。 2.3.5. +QIURC: 'incoming' 下行连接请求通知 若为'TCP LISTENER'，当远程客户端连接到此服务器时，模块会为此新连接自动分 配一个空闲的 并上报该 URC。新连接的将会是'TCP INCOMING' ，且 为缓存模式。 +QIURC: 'incoming' 下行连接请求通知 +QIURC: 'incoming',,<se 当服务器接受新的连接请求，上报的 URC 中会通 rverID>,, 知、和。 参数 整型。模块自动为新连接指定的 Socket。范围：0~5。 整型。接受新连接请求的服务器，此服务器的是'TCP LISTENER'，监听的 Socket ID 是。 字符串类型。新连接的远程 IP 地址。 整型。新连接的远程端口。 上海移远通信技术股份有限公司 25 / 35 BC25&BC32 系列 TCP/IP 应用指导 3 相关错误码 执行 TCP/IP AT 命令后若有返回，具体的错误信息可以通过 AT+QIGETERROR 查询。 AT+QIGETERROR 仅返回上一个 TCP/IP AT 命令的错误码。 表 2：错误码概览 错误码 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 错误码描述 Operation successful Unknown error Operation blocked Invalid parameters Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy DNS parse failed 中文描述 操作成功 未知原因 操作受阻 无效参数 内存不足 创建 Socket 失败 操作不支持 Socket 绑定失败 Socket 监听失败 Socket 写入失败 Socket 读取失败 Socket 接受失败 打开 PDP 场景失败 关闭 PDP 场景失败 Socket ID 被占用 DNS 繁忙 DNS 解析失败 上海移远通信技术股份有限公司 26 / 35 566 Socket connection failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel send 572 Operation not allowed 573 APN not configured 574 Port busy 表 3：Ping 结果概览 错误码 错误码描述 0 PING_ECHO 1 PING_TIMEOUT 2 PING_SUCCESS 3 PING_TCPIP_ERROR 4 PING_ADDRESS_NOT_FOUND 5 PING_PDP_ACT_FAIL BC25&BC32 系列 TCP/IP 应用指导 Socket 连接失败 Socket 已被关闭 操作繁忙 操作超时 PDP 场景发生故障 取消发送 操作不允许 未配置 APN 端口繁忙 中文描述 回显 超时 成功 TCPIP 错误 地址未找到 PDP 激活失败 上海移远通信技术股份有限公司 27 / 35 BC25&BC32 系列 TCP/IP 应用指导 4 举例 4.1. TCP 客户端在缓存模式下工作 4.1.1. 创建一个 TCP 客户端连接并进入缓存模式 //做业务前需确保模块已正常注网并获取到 IP 地址 AT+CGATT? +CGATT: 1 //查询注网状态 //注网成功 OK AT+CGPADDR? +CGPADDR: 1,'100.127.243.105' //查询是否已获取 IP 地址 //已获取 IP 地址 OK AT+QIOPEN=1,0,'TCP','220.18.39.22',8062,0,0 OK //上下文 ID 为 1，Socket ID 为 0。 +QIOPEN: 0,0 AT+QISTATE=1,0 +QISTATE: 0,'TCP','220.18.39.22',8062,0,2,1,0 //连接成功，等待 URC 上报后再进行其他操作 //查询 Socket ID 为 0 的连接状态。 OK 4.1.2. 在缓存模式下发送数据 AT+QISEND=0,10,'1234567890' OK SEND OK AT+QISENDEX=0,5,'3031323334' OK SEND OK AT+QISEND=0,10,'1234567890' OK AT+QISEND=0,10,'1234567890' //发送数据，数据长度是 10 个字节。 //发送十六进制字符串数据。 //发送数据，数据长度是 10 个字节。 //上一条命令尚未返回 SEND OK，所以当发送 上海移远通信技术股份有限公司 28 / 35 ERROR SEND OK BC25&BC32 系列 TCP/IP 应用指导 新数据时会返 ERROR。 4.1.3. 在缓存模式下从远程服务器上接收数据 +QIURC: 'recv',0 AT+QIRD=0,1024 +QIRD: 10 1234567890 //=0 接收到数据 URC //读取缓存中的数据，读取最大长度为 1024 字节 //实际数据长度为 10 字节 //数据内容为'1234567890' OK AT+QIRD=0,1024 +QIRD: 0 //读取缓存数据，读取最大长度为 1024 字节 //无缓存数据 OK AT+QICFG='showlength',1 +QICFG: 'showlength',1 //配置显示可选长度参数 OK +QIURC: 'recv',0,12 AT+QIRD=0,10 +QIRD: 10,2 1234567890 //=0 接收到了数据，数据长度为12 字节。 //读取数据，读取长度 10 字节。 //已读取 10 字节长度的数据，还有 2 字节未读取。 OK +QIURC: 'recv',0,'buff full' AT+QICFG='viewmode',1 +QICFG: 'viewemode',1 //=0 上报缓存已满，模块需要使用 AT+QIRD 读取缓存数据。 //已收到数据的输出格式：data header,data OK AT+QISEND=0,12,'012345678901' OK SEND OK +QIURC: 'recv',0,12 AT+QIRD=0,10 +QIRD: 10,2,0123456789 上海移远通信技术股份有限公司 29 / 35 OK 4.1.4. 断开连接 AT+QICLOSE=0 OK CLOSE OK BC25&BC32 系列 TCP/IP 应用指导 //断开 =0 的连接 4.2. TCP 客户端在直吐模式下工作 4.2.1. 创建一个 TCP 客户端连接并进入直吐模式 AT+QIOPEN=1,0,'TCP','220.18.39.22',8062,0,1 OK //上下文 ID 为 1，Socket ID 为 0 +QIOPEN: 0,0 AT+QISTATE=1,0 +QISTATE: 0,'TCP','220.18.39.22',8062,0,2,1,1 //连接成功，最大等待 36 秒后有 URC 上报 //查询 Socket ID 为 0 的连接状态 OK 4.2.2. 在直吐模式下发送数据 AT+QISEND=0,10,'1234567890' OK SEND OK AT+QISENDEX=0,5,'3031323334' OK SEND OK //发送数据，数据长度为 10 字节。 //发送十六进制字符串数据。 4.2.3. 在直吐模式下接收来自远程服务器的数据 +QIURC: 'recv',0,5 12345 AT+QICFG='viewmode',1 +QICFG: 'viewmode',1 //收到来自远程服务器的数据。 //已收到数据的输出格式：data header,data OK 上海移远通信技术股份有限公司 30 / 35 AT+QISEND=0,12,'012345678901' OK SEND OK +QIURC: 'recv',0,12,012345678901 4.2.4. 断开 TCP 客户端连接 AT+QICLOSE=0 OK CLOSE OK BC25&BC32 系列 TCP/IP 应用指导 //断开=0 的连接 4.3. TCP 服务器在缓存模式下工作 4.3.1. 启动 TCP 服务器 AT+QIOPEN=1,0,'TCP LISTENER','192.168.2.6',0,2020,0 //上下文 ID 为 1，Socket ID 为 0 OK +QIOPEN: 0,0 AT+QISTATE? +QISTATE: 0,'TCP LISTENER','192.168.2.6',0,2020,2,1,0 //TCP 服务器连接成功 //查询上下文 ID 为 0 的连接状态 OK 4.3.2. 接受 TCP 连接请求 +QIURC: 'incoming',2,0,'192.168.2.2',36566 //接受 TCP 连接，为'TCP INCOMING'， 为 2 4.3.3. 从新连接中接收数据 +QIURC: 'recv',0 AT+QIRD=0,512 +QIRD: 4 test OK AT+QIRD=0,512 //从远程新连接中接收到数据 //从远程新连接中读取数据 //实际数据长度是 4 字节 //读取的数据 上海移远通信技术股份有限公司 31 / 35 +QIRD: 0 OK 4.3.4. 关闭 TCP 服务器 AT+QICLOSE=2 OK CLOSE OK AT+QICLOSE=0 OK CLOSE OK BC25&BC32 系列 TCP/IP 应用指导 //无缓存数据。 //关闭新连接，受网络状况影响，最大响应时间为 10 秒 //关闭 TCP 服务器监听 4.4. UDP 客户端模式（支持深度睡眠唤醒） AT+QSCLK=0 OK AT+QIOPEN=1,0,'UDP','220.18.39.22',8084,0,0 OK //做业务前关闭模块深度睡眠功能 //上下文 ID 为 1，Socket ID 为 0 +QIOPEN: 0,0 AT+QISTATE=1,0 +QISTATE: 0,'UDP','220.18.39.22',8084,0,2,1,0 //连接成功 //查询 Socket ID 为 0 的连接状态 OK AT+QSCLK=1 OK //业务完成后，需要时开启深度睡眠功能，等待模块 进入深度睡眠 //模块进入深度睡眠 +QATSLEEP //拉 PSM_EINT 唤醒模块 +QATWAKEUP AT+QSCLK=0 OK //模块从深度睡眠被唤醒 //做业务前关闭模块深度睡眠功能，业务完成后需要 模块深度睡眠时再开启 //模块会恢复 UDP 相关参数及状态，此时模块状态与进入深度睡眠前一致，可以直接发送和接收 UDP 数据 AT+QISEND=0,10,'1234567890' //发送数据，数据长度是 10 个字节 OK 上海移远通信技术股份有限公司 32 / 35 BC25&BC32 系列 TCP/IP 应用指导 SEND OK AT+QICLOSE=0 OK CLOSE OK //断开=0 的连接 4.5. 进行远程服务器 Ping 操作 AT+QPING=1,'sh.quectel.com' OK +QPING: 0,220.18.29.21,32,192,255 +QPING: 0,220.18.23.21,32,240,255 +QPING: 0,220.18.23.21,32,241,255 +QPING: 0,220.18.23.21,32,479,255 +QPING: 2,4,4,0,192,479,287 //在上下文 1 中 Ping 域名为 'sh.quectel.com' 的服务器 4.6. 同步本地时间 AT+QNTP=1,'ntp5.aliyun.com' OK //使用域名为'ntp5.aliyun.com'的 NTP 服务器同步本地时间 +QNTP: 0,'18/04/20,11:08:20+32' 4.7. 查询最新一次错误码 AT+QIOPEN=1,'UDP','220.18.39.22',8063,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552,invalid parameters OK //开启 Socket，省略 上海移远通信技术股份有限公司 33 / 35 BC25&BC32 系列 TCP/IP 应用指导 5 附录 A 参考文档及术语缩写 表 4：参考文档 编号 文档名称 [1] Quectel_BC25_AT 命令手册 [2] Quectel_BC32_AT 命令手册 表 5：术语缩写 缩写 英文描述 APN Access Point Name ACK CR DNS Acknowledgement Carriage Return Domain Name System ID IP IPv4 Identifier Internet Protocol Internet Protocol version 4 IPv6 LF MCU ME NTP NVM Internet Protocol version 6 Line Feed Microcontroller Unit Mobile Equipment Network Time Protocol Non-Volatile Memory PDP Packet Data Protocol 备注 BC25 模块 AT 命令说明 BC32 模块 AT 命令说明 中文描述 接入点名称 确认 回车符 域名系统 标识符 互联网协议 互联网协议版本 4 互联网协议版本 6 换行符 微控制器 移动设备 网络时间协议 非易失性存储器 分组数据协议 上海移远通信技术股份有限公司 34 / 35 PPP PSM RTC TCP TTL UDP URC UTC Point to Point Protocol Power Saving Mode Real-Time Clock Transmission Control Protocol Time to Live User Datagram Protocol Unsolicited Result Code Universal Time Coordinated BC25&BC32 系列 TCP/IP 应用指导 点对点协议 省电模式 实时时钟 传输控制协议 生存时间 用户数据报协议 非请求结果码 协调世界时 上海移远通信技术股份有限公司 35 / 35

BG95&BG77&BG600L Series FTP(S) Application Note LPWA Module Series Rev. BG95&BG77&BG600L_Series_FTP(S)_Application_Note_V1.1 Date: 2020-06-23 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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 WITHOUT PERMISSION ARE FORBIDDEN. 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. 2020. All rights reserved BG95&BG77&BG600L_Series_FTP(S)_Application_Note 1 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note About the Document Revision History Version Date Author Description 1.0 2019-10-28 Terrence YANG Initial 1. Added an applicable module BG600L-M3. 2. Deleted AT+QFTPCFG='data_sslctxid'. 1.1 2020-06-23 Terrence YANG 3. Updated the example of login to FTPs server in Chapter 3.2. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 2 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. Applicable Modules ..................................................................................................................... 6 1.2. AT Command Syntax .................................................................................................................. 7 1.2.1. Definitions .......................................................................................................................... 7 1.2.2. AT Command Syntax ......................................................................................................... 7 1.3. The Process of Using FTP(S) AT Commands ............................................................................ 7 1.4. Description of Data Mode ........................................................................................................... 9 2 Description of FTP(S) AT Commands ............................................................................................. 11 2.1. AT+QFTPCFG Configure Parameters for FTP(S) Server ..................................................... 11 2.2. AT+QFTPOPEN Login to FTP(S) Server ............................................................................... 14 2.3. AT+QFTPCWD Configure the Current Directory on FTP(S) Server...................................... 15 2.4. AT+QFTPPWD Get the Current Directory on FTP(S) Server................................................ 16 2.5. AT+QFTPPUT Upload a File to FTP(S) Server ..................................................................... 17 2.6. AT+QFTPGET Download a File from FTP(S) Server ............................................................ 19 2.7. AT+QFTPSIZE Get the File Size on FTP(S) Server .............................................................. 22 2.8. AT+QFTPDEL Delete a File on FTP(S) Server...................................................................... 23 2.9. AT+QFTPMKDIR Create a Folder on FTP(S) Server ............................................................ 23 2.10. AT+QFTPRMDIR Delete a Folder on FTP(S) Server ............................................................ 24 2.11. AT+QFTPLIST List Content of a Directory on FTP(S) Server ............................................... 25 2.12. AT+QFTPNLST List File Names of a Directory on FTP(S) Server ........................................ 27 2.13. AT+QFTPMLSD List Standardized File and Directory Information........................................ 28 2.14. AT+QFTPMDTM Get the File Modification Time on FTP(S) Server ...................................... 30 2.15. AT+QFTPRENAME Rename a File or Folder on FTP(S) Server .......................................... 31 2.16. AT+QFTPLEN Get the Length of Transferred Data ............................................................... 32 2.17. AT+QFTPSTAT Get the Status of FTP(S) Server .................................................................. 32 2.18. AT+QFTPCLOSE Log out from FTP(S) Server ..................................................................... 33 3 Examples ............................................................................................................................................ 35 3.1. Login to FTP Server .................................................................................................................. 35 3.2. Login to FTPS Server ............................................................................................................... 36 3.3. Folder Operation ....................................................................................................................... 37 3.4. File Operation............................................................................................................................ 37 3.5. List File Information or File Names ........................................................................................... 38 3.6. Upload a File to FTP(S) Server ................................................................................................ 39 3.7. Download a File from FTP(S) Server........................................................................................ 42 3.8. Log out from FTP(S) Server...................................................................................................... 43 4 Error Handling .................................................................................................................................... 44 BG95&BG77&BG600L_Series_FTP(S)_Application_Note 3 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 4.1. Executing FTP(S) AT Command Fails ...................................................................................... 44 4.2. PDP Activation Fails.................................................................................................................. 44 4.3. DNS Parse Fails........................................................................................................................ 44 4.4. Error Response of FTP(S) Server ............................................................................................ 45 5 Summary of Error Codes .................................................................................................................. 46 6 Summary of FTP(S) Protocol Error Codes...................................................................................... 48 7 Appendix A References..................................................................................................................... 49 BG95&BG77&BG600L_Series_FTP(S)_Application_Note 4 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Type of AT Commands and Responses ......................................................................................... 7 Table 3: Summary of Error Codes.............................................................................................................. 46 Table 4: Summary of FTP(S) Protocol Error Codes................................................................................... 48 Table 5: Related Documents ...................................................................................................................... 49 Table 6: Terms and Abbreviations .............................................................................................................. 49 BG95&BG77&BG600L_Series_FTP(S)_Application_Note 5 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 1 Introduction Quectel BG95 series, BG77 and BG600L-M3 modules provide FTP(S) application to FTP(S) server. This document is a reference guide to all the AT commands defined for FTP(S). 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG95-N1 BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat NB2 Only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_FTP(S)_Application_Note 6 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 1.2. AT Command Syntax 1.2.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on command line. When an optional parameter is not given, the new value equals to its previous value or its default setting, unless otherwise specified.  Underline Default setting of a parameter. 1.2.2. AT Command Syntax The AT or at prefix must be added at the beginning of each command line. Entering will terminate a command line. Commands are usually followed by a response that includes . Throughout this document, only the response will be presented, are omitted intentionally. Table 2: Type of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. [,[,[...]]] AT+ This command reads non-variable parameters affected by internal processes in the module. 1.3. The Process of Using FTP(S) AT Commands As the modules support FTP(S) protocol, the file and directory on FTP(S) server can be operated via FTP(S) AT commands. The general process is as follows: Step 1: Configure and activate a PDP context. 1) Configure , , and other parameters of a PDP context by BG95&BG77&BG600L_Series_FTP(S)_Application_Note 7 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note AT+QICSGP. 2) Activate the PDP context via AT+QIACT. 3) Configure the PDP context ID for FTP(S) by AT+QFTPCFG='contextid',. The PDP context should be activated first. Step 2: Configure user account and FTP(S) server. 1) Configure the account information by AT+QFTPCFG='account',,. 2) Configure the type of transferred data by AT+QFTPCFG='filetype',. Either binary data or ASCII data can be transferred between FTP(S) server and client. 3) Configure the transfer mode by AT+QFTPCFG='transmode',. The transfer mode means either the FTP(S) server or the client listens on a port for data connection. Please be noted that AT+QFTPCFG='transmode',1 must be set for FTPS operations, because FTPS does not support active mode currently. 4) Configure the response timeout value by AT+QFTPCFG='rsptimeout',. 5) If the module works as an FTPS client, then the following configurations are needed: a) Execute AT+QFTPCFG='ssltype',1. b) Execute AT+QFTPCFG='sslctxid', to select a . c) Execute AT+QSSLCFG to configure the selected . Step 3: Login to FTP(S) server. Login to FTP(S) server by AT+QFTPOPEN=,. If +QFTPOPEN: 0,0 URC is returned, it indicates the operation is successful. Please be noted that the port numbers of FTPS and FTP servers are different. The port number of FTPS server depends on the server provider, and it is 990 usually. Step 4: File operation. 1) Set the current directory by AT+QFTPCWD. 2) Upload a file to FTP(S) server. a) Upload a file to UFS via AT+QFUPL, then upload the file to FTP(S) server by AT+QFTPPUT. After uploading the file to FTP(S) server successfully, the file should be deleted by AT+QFDEL. b) Upload a file to FTP(S) server through COM port by AT+QFTPPUT, then the module will enter in data mode. +++ can be inputted to finish the file uploading process. 3) Download a file from FTP(S) server by AT+QFTPGET. The file can be outputted to COM port or saved to UFS. If the file is outputted to COM port, the module will enter in data mode. 4) Get the size of the file on FTP(S) server by AT+QFTPSIZE. 5) Get the length of data transferred between FTP(S) server and client by AT+QFTPLEN. 6) Delete a file on FTP(S) server by AT+QFTPDEL. 7) Rename a file on FTP(S) server by AT+QFTPRENAME. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 8 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Step 5: Directory operation on FTP(S) server. 1) Set the current directory by AT+QFTPCWD. 2) Create a directory by AT+QFTPMKDIR. 3) List the content of a directory by AT+QFTPLIST. 4) List file names of a directory by AT+QFTPNLST. 5) Rename a directory by AT+QFTPRENAME. 6) Delete a directory by AT+QFTPRMDIR. 7) List standardized file and directory information by AT+QFTPMLSD. 8) Get the file modification time on FTP(S) server by AT+QFTPMDTM. Step 6: Close a connection with FTP(S) server. Close a connection with FTP(S) server by AT+QFTPCLOSE. If +QFTPCLOSE: 0,0 URC is reported, it indicates the operation is successful. Step 3 to Step 6 can be repeated. Step 7: Deactivate PDP context. Deactivate a PDP context by AT+QIDEACT=. NOTES 1. See Quectel_BG95&BG77_TCP(IP)_Application_Note for more details of AT+QICSGP, AT+QIACT and AT+QIDEACT. 2. See Quectel_BG95&BG77_SSL_Application_Note for more details of AT+QSSLCFG. 3. See Quectel_BG95&BG77_FILE_Application_Note for more details of AT+QFUPL and AT+QFDEL. 1.4. Description of Data Mode The COM port of the modules have two working modes: AT command mode and data mode. In AT command mode, the inputted data via COM port will be treated as AT command, while in data mode, it will be treated as data. Inputting +++ or pulling up DTR (AT&D1 should be set first) will make the module exit from data mode. To prevent the +++ from being misinterpreted as data, the following sequence should be followed: 1) Do not input any character within 1s at least before inputting +++. 2) Input +++ within 1s, and no other characters can be inputted during the time. 3) Do not input any character within 1s after +++ has been inputted. When AT+QFTPPUT, AT+QFTPGET, AT+QFTPLIST and AT+QFTPNLST are executed, if the local file path is 'COM:', which means data will be received from or outputted to COM port, the COM port will enter data mode. The module will exit from data mode when inputting +++ or changing DTR level from low to BG95&BG77&BG600L_Series_FTP(S)_Application_Note 9 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note high, and it will re-enter data mode by executing ATO after AT+QFTPGET, AT+QFTPLIST and AT+QFTPNLST are executed. After AT+QFTPPUT is executed, the module will not be able to re-enter data mode anymore. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 10 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 2 Description of FTP(S) AT Commands 2.1. AT+QFTPCFG Configure Parameters for FTP(S) Server This command configures FTP(S) server parameters, including user account, file type, transfer mode, context ID, response timeout, SSL type, SSL context ID, data connection address selection, etc. If only one parameter is executed, the write commend will query the current settings. AT+QFTPCFG Configure Parameters for FTP(S) Server Test Command AT+QFTPCFG=? Response +QFTPCFG: 'account',, +QFTPCFG: 'filetype',(list of supported s) +QFTPCFG: 'transmode',(list of supported s) +QFTPCFG: 'contextid',(range of supported s) +QFTPCFG: 'rsptimeout',(range of supported s) +QFTPCFG: 'ssltype',(range of supported s) +QFTPCFG: 'sslctxid',(range of supported s) +QFTPCFG: 'data_address',(list of supported s) Write Command AT+QFTPCFG='account'[,,] OK Response If the optional parameters are omitted, query the current setting: +QFTPCFG: 'account',, OK Write Command AT+QFTPCFG='filetype'[,] If the optional parameters are specified, set the username and password for authentication: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QFTPCFG: 'filetype', BG95&BG77&BG600L_Series_FTP(S)_Application_Note 11 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note OK Write Command AT+QFTPCFG='transmode'[,] If the optional parameter is specified, set the data type: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QFTPCFG: 'transmode', OK Write Command AT+QFTPCFG='contextid'[,] If the optional parameter is specified, set it is the FTP(S) server or the client that listens on a port for data connection: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QFTPCFG: 'contextid', OK Write Command AT+QFTPCFG='rsptimeout'[,] If the optional parameter is specified, set the PDP context ID: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QFTPCFG: 'rsptimeout', OK Write Command AT+QFTPCFG='ssltype'[,] If the optional parameter is specified, set the timeout value for the response of most FTP(S) AT commands: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QFTPCFG: 'ssltype', OK BG95&BG77&BG600L_Series_FTP(S)_Application_Note 12 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Write Command AT+QFTPCFG='sslctxid'[,] If the optional parameter is specified, set the module to work as FTP client or FTPS client: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QFTPCFG: 'sslctxid', OK Write Command AT+QFTPCFG='data_address'[,] If the optional parameter is specified, set the SSL context ID: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QFTPCFG: 'data_address', OK If the optional parameter is specified, set the FTP(S) data connection address: OK Or +CME ERROR: Parameter String type. Username for authentication. The maximum size of the parameter is 255 bytes. String type. Password for authentication. The maximum size of the parameter is 255 bytes. Integer type. PDP context ID. Range: 1–16. Default value: 1. It should be activated by AT+QIACT before using AT+QFTPOPEN. For more details of AT+QIACT, see Quectel_BG95&BG77_TCP(IP)_Application_Note. Integer type. The type of transferred data. 0 Binary 1 ASCII Integer type. Whether the FTP(S) server or client listens on a port for data connection 0 Active mode, the module will listen on a port for data connection 1 Passive mode, the FTP(S) server will listen on a port for data connection Integer type. Range: 20–180. Default value: 90. Unit: second. Generally, it is the timeout value for the OK result code to be returned for most BG95&BG77&BG600L_Series_FTP(S)_Application_Note 13 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note FTP(S) AT commands except AT+QFTPPUT, AT+QFTPGET, AT+QFTPLST and AT+QFTPNLST. The rules for these four commands are shown as below: a) When the command has been sent, but CONNECT has not been outputted yet, this parameter indicates the maximum timeout value for CONNECT to be outputted after the command has been sent. b) When the module has entered data mode, this parameter indicates the maximum interval time between two packets of received/transmitted data. c) When the is not 'COM:', it indicates the maximum interval time between two packets of received/transmitted data. Integer type. The module works as an FTP client or FTPS client. 0 FTP client 1 FTPS client (FTP over implicit TLS/SSL) 2 FTPS client (FTP over explicit TLS/SSL) Integer type. SSL context ID. Range: 0–5. Default value: 0. Customers should configure the SSL parameters by AT+QSSLCFG. For details, see Quectel_BG95&BG77_SSL_Application_Note. Integer type. FTP(S) data connection address selection. 0 Use server dispatched address 1 Use FTP(S) control session address Integer type. The error code of the operation. See Chapter 5 for details. NOTE During FTPS operation, must be set into 1 because FTPS does not support active mode currently. 2.2. AT+QFTPOPEN Login to FTP(S) Server This command logs in FTP(S) server. The PDP context should be activated by AT+QIACT first. +QFTPOPEN: , indicates the operation result of AT+QFTPOPEN and it should be outputted within configured by AT+QFTPCFG. AT+QFTPOPEN Login to FTP(S) Server Test Command AT+QFTPOPEN=? Response +QFTPOPEN: , Write Command AT+QFTPOPEN=[,<port] OK Response OK +QFTPOPEN: , BG95&BG77&BG600L_Series_FTP(S)_Application_Note 14 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note If there is any error: +CME ERROR: Parameter String type. The IP address or domain name of the FTP(S) server. The maximum size of the parameter is 200 bytes. Integer type. The port number of the FTP(S) server. Default value: 21. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. NOTE Please note that the port numbers of FTPS and FTP servers are different. The port number of FTPS server depends on the server provider, and it is 990 usually. 2.3. AT+QFTPCWD Configure the Current Directory on FTP(S) Server This command configures the current directory on FTP(S) server. If OK is returned, +QFTPCWD: , should be outputted within configured by AT+QFTPCFG. All file and directory operations will be performed in the current directory. AT+QFTPCWD Configure the Current Directory on FTP(S) Server Test Command AT+QFTPCWD=? Response +QFTPCWD: Write Command AT+QFTPCWD= OK Response OK +QFTPCWD: , If there is any error: +CME ERROR: BG95&BG77&BG600L_Series_FTP(S)_Application_Note 15 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Parameter String type. A directory path on FTP(S) server. The maximum size of the parameter is 255 bytes. The root path of FTP(S) server is '/'. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. 2.4. AT+QFTPPWD Get the Current Directory on FTP(S) Server This command gets the current directory on FTP(S) server. If OK is returned, +QFTPPWD: 0, or +QFTPPWD: , should be outputted within configured by AT+QFTPCFG. AT+QFTPPWD Get the Current Directory on FTP(S) Server Test Command AT+QFTPPWD=? Execution Command AT+QFTPPWD Response OK Response OK And then, if the current directory is successfully got: +QFTPPWD: 0, If failed to get the current directory: +QFTPPWD: , If there is any error: +CME ERROR: Parameter String type. A directory path on FTP(S) server. The maximum size of the parameter is 255 bytes. The root path of FTP(S) server is '/'. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 16 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 2.5. AT+QFTPPUT Upload a File to FTP(S) Server This command uploads a file to FTP(S) server. If the file data will be uploaded via COM port, then the module will enter data mode. Inputting +++ will abort the file uploading. A local file can be uploaded to FTP(S) server but the file can only be UFS files. The file can be uploaded to UFS by AT+QFUPL, and then be uploaded to FTP(S) server via AT+QFTPPUT. After a file is uploaded successfully, the file can be deleted by AT+QFDEL. For more details, see Quectel_BG95&BG77_FILE_Application_Note. A file can be uploaded from a specified file position by . If the is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If is not 'COM:', OK will be outputted first, and then +QFTPPUT: 0, will be outputted after data transfer is completed. If the module has entered data mode or the is not 'COM:', the configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPPUT Upload a File to FTP(S) Server Test Command AT+QFTPPUT=? Response +QFTPPUT: ,,,, OK Write Command Response When the is 'COM:', If the module enters data mode successfully: that is, to input data via COM port CONNECT AT+QFTPPUT=,'COM:' Then input the data via COM port [,[,,]] OK After that, if the data are successfully uploaded: +QFTPPUT: 0, If failed to upload the data: +QFTPPUT: , Write Command When is not 'COM:' AT+QFTPPUT=,[,] If there is any error: +CME ERROR: Response OK And then, if the data are successfully uploaded: +QFTPPUT: 0, If failed to upload the data: BG95&BG77&BG600L_Series_FTP(S)_Application_Note 17 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note +QFTPPUT: , If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. String type. The local file name. The maximum size of the parameter is 80 bytes. If it is 'COM:', the data will be inputted via COM port. If it is not 'COM:', the data will be saved to UFS. After successful uploading, the file should be deleted by AT+QFDEL ( see Quectel_BG95&BG77_FILE_Application_Note for details). Integer type. The start position of the file to be uploaded. Default value: 0. If and are specified, should be the position where the data continues to be uploaded to the same file. Integer type. The length of the data to be uploaded. It is valid only when is 'COM:'. When the length of data uploaded via COM port reaches , the module will exit from data mode. Unit: byte. Integer type. Whether it is the last packet of data to be uploaded. 0 Not the last packet of data. When the data length reaches , the module will exit from data mode and +QFTPPUT: 0, will be outputted. In such a case, do not disconnect data connection, as the remained data needs to be uploaded to the same file on FTP(S). 1 The last packet of data. When the data length reaches , the module will exit from data mode and data connection can be disconnected. After that, +QFTPPUT: 0, will be outputted. Integer type. The length of successfully transferred data. Unit: byte. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. Example //Upload a file via COM port to FTP(S) server. AT+QFTPPUT='test.txt','COM:',0 CONNECT //Input the file data via COM port +++ OK //All data will be saved as test.txt on FTP(S) server. //Exit data mode +QFTPPUT: 0,1000 BG95&BG77&BG600L_Series_FTP(S)_Application_Note 18 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note //Upload a file via COM port to FTP(S) server twice in 1024 bytes each time. AT+QFTPPUT='test.txt','COM:',0,1024,0 //It is not the last 1024 bytes of test.txt. CONNECT //Input the file data via COM port OK //Data length reaches 1024 bytes. +QFTPPUT: 0,1024 AT+QFTPPUT='test.txt', 'COM:',1024,1024,1 //It is the last 1024 bytes of test.txt. CONNECT Input the file data via COM port OK //Data length reaches 1024 bytes. +QFTPPUT: 0,1024 //Upload a file to UFS. AT+QFUPL='test1.txt',1000,300,1 CONNECT Input 1000 bytes data +QFUPL: 1000,707 //Upload a file to UFS, the file will be saved as test1.txt and the maximum size of file is 1000 bytes. 300 indicates timeout value, and 1 indicates ACK mode. See Quetel_BG95&BG77_FILE_Application_Note for details. OK AT+QFLST='*' +QFLST: 'test1.txt',1000 OK AT+QFTPPUT='test.txt','test1.txt',0 OK //Upload test1.txt to FTP(S) server, and the file will be saved as test.txt on FTP(S) server. +QFTPPUT: 0,1000 AT+QFDEL='test1.txt' OK 2.6. AT+QFTPGET Download a File from FTP(S) Server This command downloads a file from FTP(S) server. The file can be outputted to COM port by AT+QFTPGET='filename','COM:'. The module will enter data mode on receiving data from server. After the data transfer is completed, the module will exit from data mode automatically and output +QFTPGET: 0,. The file can be saved to UFS by AT+QFTPGET='filename','localname'. After the file transfer has been completed, the module will output +QFTPGET: 0,. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 19 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note If the is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If the is not 'COM:', OK will be outputted first, and then +QFTPGET: 0, will be outputted after data transfer is completed. If the module has entered data mode or the is not 'COM:', the configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPGET Download a File from FTP(S) Server Test Command AT+QFTPGET=? Response +QFTPGET: ,,, Write Command When the is 'COM:', that is, to output the data via COM port AT+QFTPGET=,'COM:'[, [,]] OK Response If the module enters data mode successfully: CONNECT OK And then, if the data are successfully downloaded: +QFTPGET: 0, If failed to download the data: +QFTPGET: , Write Command When the is not 'COM:' AT+QFTPGET=,[,] If there is any error: +CME ERROR: Response OK And then, if the data are successfully downloaded: +QFTPGET: 0, If failed to download the data: +QFTPGET: , If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 20 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note String type. The local file name. The maximum size of the parameter is 80 bytes. If it is 'COM:', the file data will be outputted to COM port. If it is not 'COM:', the data will be saved to UFS, and then the file can be read by AT+QFREAD. For more details, see Quectel_BG95&BG77_FILE_Application_Note. Integer type. The start position of the file to be downloaded. The default value is 0. Integer type. The length of data to be downloaded. It is valid only if is 'COM:'. If this parameter is specified, the module will output bytes to COM port and exit from data mode. And data can be downloaded from by the same AT command if there are some data left. Unit: byte. The file data outputted to COM port. Integer type. The length of actually transferred data. If it is less than , it means the file transfer has completed. Unit: byte. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. Example //Download a file and the file will be outputted to COM port. AT+QFTPGET='test.txt','COM:',0 CONNECT OK +QFTPGET: 0,1000 //Download a file and the file will be outputted to COM port twice in 500 bytes each time. AT+QFTPGET='test.txt','COM:',0,500 //The size of test.txt is 1000 bytes. Download the first 500 bytes. CONNECT OK +QFTPGET: 0,500 AT+QFTPGET='test.txt','COM:',500,500 CONNECT OK //Download the left 500 bytes . +QFTPGET: 0,500 //Download a file and save it to UFS. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 21 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note AT+QFTPGET='test.txt','test2.txt',0 OK +QFTPGET: 0,1000 AT+QFLST='*' +QFLST: 'test2.txt',1000 OK 2.7. AT+QFTPSIZE Get the File Size on FTP(S) Server The command gets the file size on FTP(S) server. If OK is returned, +QFTPSIZE: 0, or +QFTPSIZE: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPSIZE Get the File Size on FTP(S) Server Test Command AT+QFTPSIZE=? Response +QFTPSIZE: Write Command AT+QFTPSIZE= OK Response OK And then, if the file size is successfully got: +QFTPSIZE: 0, If failed to get the file size: +QFTPSIZE: , If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The size of file on FTP(S) server. Unit: byte. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 22 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note If it is 0, it is invalid. 2.8. AT+QFTPDEL Delete a File on FTP(S) Server This command deletes a specified file on FTP(S) server. If OK is returned, +QFTPDEL: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPDEL Delete a File on FTP(S) Server Test Command AT+QFTPDEL=? Response +QFTPDEL: Write Command AT+QFTPDEL= OK Response OK +QFTPDEL: , If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. 2.9. AT+QFTPMKDIR Create a Folder on FTP(S) Server This command creates a folder on FTP(S) server. If OK is returned, +QFTPMKDIR: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPMKDIR Create a Folder on FTP(S) Server Test Command AT+QFTPMKDIR=? Response +QFTPMKDIR: BG95&BG77&BG600L_Series_FTP(S)_Application_Note 23 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Write Command AT+QFTPMKDIR= OK Response OK +QFTPMKDIR: , If there is any error: +CME ERROR: Parameter String type. The folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. 2.10. AT+QFTPRMDIR Delete a Folder on FTP(S) Server This command deletes a specified folder on FTP(S) server. If OK is returned, +QFTPRMDIR: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected and the network should be deactivated and reactivated. AT+QFTPRMDIR Delete a Folder on FTP(S) Server Test Command AT+QFTPRMDIR=? Response +QFTPRMDIR: Write Command AT+QFTPRMDIR= OK Response OK +QFTPRMDIR: , If there is any error: +CME ERROR: BG95&BG77&BG600L_Series_FTP(S)_Application_Note 24 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Parameter String type. The folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. 2.11. AT+QFTPLIST List Content of a Directory on FTP(S) Server This command lists the content of a directory on FTP(S) server. If is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If is not 'COM:', OK will be returned first, and +QFTPLIST: 0, will be outputted after the content is transferred completely. If the module has entered data mode or is not 'COM:', configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPLIST List Content of a Directory on FTP(S) Server Test Command AT+QFTPLIST=? Response +QFTPLIST: , Write Command When is 'COM:' AT+QFTPLIST= [,'COM:'] OK Response If the module enters data mode successfully: CONNECT OK And then, if the content of the directory is successfully listed: +QFTPLIST: 0, If failed to list the content: +QFTPLIST: , Write Command When is not 'COM:' AT+QFTPLIST=, If there is any error: +CME ERROR: Response OK And then if the content of the directory is successfully listed: BG95&BG77&BG600L_Series_FTP(S)_Application_Note 25 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note +QFTPLIST: 0, If failed to list the content: +QFTPLIST: , If there is any error: +CME ERROR: Parameter String type. The directory name on FTP(S) server. The maximum size of the parameter is 255 bytes. If it is '.' it will list the content of the current directory configured by AT+QFTPCWD. String type. The local storage location of the data from FTP(S) server. The maximum size of the parameter is 80 bytes. The default value is 'COM:'. If it is 'COM:', the data will be outputted to COM port. If it is not 'COM:', the data will be saved to UFS first and then can be read via AT+QFREAD. For more details, see Quectel_BG95&BG77_FILE_Application_Note. The directory content outputted to COM port. Integer type. The size of transferred data from FTP(S) server. Unit: byte. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. Example //Get the content of the current directory on FTP(S) server and the data will be outputted to COM port. AT+QFTPLIST='.' CONNECT OK +QFTPLIST: 0,1000 //Get the content of a specified directory on FTP(S) server and save it to UFS. AT+QFTPLIST='TESTDIR','test2.txt' OK +QFTPLIST: 0,1000 AT+QFLST='*' +QFLST: 'test2.txt',1000 OK BG95&BG77&BG600L_Series_FTP(S)_Application_Note 26 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 2.12. AT+QFTPNLST List File Names of a Directory on FTP(S) Server This command lists file names of a directory on FTP(S) server. If is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If is not 'COM:', OK will be returned first, and then +QFTPNLST: 0, will be outputted after file name transfer is completed. If the module has entered data mode or is not 'COM:', configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPNLST List File Names of a Directory on FTP(S) Server Test Command AT+QFTPNLST=? Response +QFTPNLST: , Write Command When is 'COM:' AT+QFTPNLST=[,'COM:'] OK Response If the module enters data mode successfully: CONNECT OK And then, if the file names are successfully listed: +QFTPNLST: 0, If failed to list the file names: +QFTPNLST: , Write Command When is not 'COM:' AT+QFTPNLST=, If there is any error: +CME ERROR: Response OK +QFTPNLST: 0, If there is any error: OK +QFTPNLST: , Or +CME ERROR: BG95&BG77&BG600L_Series_FTP(S)_Application_Note 27 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Parameter String type. The folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. If it is '.' it will list the file names of the current directory configured by AT+QFTPCWD. String type. The local storage location of the data from FTP(S) server. The maximum size of the parameter is 80 bytes. The default value is 'COM:'. If it is 'COM:', the data will be outputted to COM port. If it is not 'COM:', the data will be saved to UFS first and then can be read via AT+QFREAD. For more details, see Quectel_BG95&BG77_FILE_Application_Note. The file names outputted to COM port. Integer type. The size of transferred data from FTP(S) server. Unit: byte. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. Example //Get the file name of the current directory on FTP(S) server and the data will be outputted to COM port. AT+QFTPNLST='.' CONNECT OK +QFTPNLST: 0,1000 //Get the file name of a specified directory on FTP(S) server and save it to UFS. AT+QFTPNLST='TESTDIR','test2.txt' OK +QFTPNLST: 0,1000 AT+QFLST='*' +QFLST: 'test2.txt',1000 OK 2.13. AT+QFTPMLSD List Standardized File and Directory Information This command lists standardized file and directory information on FTP(S) server. If is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If is not 'COM:', OK will be returned first and then +QFTPMLSD: 0, will be BG95&BG77&BG600L_Series_FTP(S)_Application_Note 28 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note outputted after the information transfer is completed. If the module has entered data mode or is not 'COM:', configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPMLSD List Standardized File and Directory Information Test Command AT+QFTPMLSD=? Response +QFTPMLSD: , Write Command When is 'COM:' AT+QFTPMLSD=[,'COM:'] OK Response If the module enters data mode successfully: CONNECT OK And then, if the file and directory information is successfully listed: +QFTPMLSD: 0, If failed to list the file and directory information: +QFTPMLSD: , Write Command When is not 'COM:' AT+QFTPMLSD=, If there is any error: +CME ERROR: Response OK And then, if the file and directory information is successfully listed: +QFTPMLSD: 0, If failed to list the file and directory information: +QFTPMLSD: , If there is any error: +CME ERROR: Parameter String type. The folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. If it is '.' it will list standardized file and directory information configured by AT+QFTPCWD. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 29 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note String type. The local storage location of the data from FTP(S) server. The maximum size of the parameter is 80 bytes. The default value is 'COM:'. If it is 'COM:', the data will be outputted to COM port. If it is not 'COM:', the data will be saved to UFS first and then can be read via AT+QFREAD. For more details, see Quectel_BG95&BG77_FILE_Application_Note. The file and directory information outputted to COM port. Integer type. The size of transferred data from FTP(S) server. Unit: byte. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. Example //Get standardized file and directory information on FTP(S) server and the data will be outputted to COM port. AT+QFTPMLSD='.' CONNECT OK +QFTPMLSD: 0,1000 //Get standardized file and directory information on FTP(S) server and save them to UFS. AT+QFTPMLSD='TESTDIR','test2.txt' OK +QFTPMLSD: 0,1000 AT+QFLST='*' +QFLST: 'test2.txt',1000 OK 2.14. AT+QFTPMDTM Get the File Modification Time on FTP(S) Server This command gets the file modification time on FTP(S) server. If OK is returned, +QFTPMDTM: 0, or +QFTPMDTM: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPMDTM Get the File Modification Time on FTP(S) Server Test Command AT+QFTPMDTM=? Response +QFTPMDTM: BG95&BG77&BG600L_Series_FTP(S)_Application_Note 30 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Write Command AT+QFTPMDTM= OK Response OK And then, if the file modification time is successfully got: +QFTPMDTM: 0, If failed to get the file modification time: +QFTPMDTM: , If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. String type. The file modification time on FTP(S) server. The format is 'YYYYMMDDHHMMSS' or 'YYYYMMDDHHMMSS.NNN'. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. 2.15. AT+QFTPRENAME Rename a File or Folder on FTP(S) Server This command renames a file or folder on FTP(S) server. If OK is returned, +QFTPRENAME: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPRENAME Rename a File or Folder on FTP(S) Server Test Command AT+QFTPRENAME=? Response +QFTPRENAME: , Write Command AT+QFTPRENAME=, OK Response OK +QFTPRENAME: , BG95&BG77&BG600L_Series_FTP(S)_Application_Note 31 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note If there is any error: +CME ERROR: Parameter String type. The old file name or folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. String type. The new file name or folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. 2.16. AT+QFTPLEN Get the Length of Transferred Data This command gets the length of transferred data on FTP(S) server, after executing AT+QFTPPUT, AT+QFTPGET, AT+QFTPNLST and AT+QFTPLIST. AT+QFTPLEN Get the Length of Transferred Data Test Command AT+QFTPLEN=? Execution Command AT+QFTPLEN Response OK Response OK +QFTPLEN: 0, If there is any error: +CME ERROR: Parameter Integer type. The length of transferred data on FTP(S) server. Unit: byte. Integer type. The error code of the operation. See Chapter 5 for details. 2.17. AT+QFTPSTAT Get the Status of FTP(S) Server This command gets the status of FTP(S) server. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 32 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note AT+QFTPSTAT Get the Status of FTP Server Test Command AT+QFTPSTAT=? Execution Command AT+QFTPSTAT Response OK Response OK +QFTPSTAT: 0, If there is any error: +CME ERROR: Parameter Integer type. The current status of FTP(S) server. 0 Opening an FTP(S) server 1 The FTP(S) server is open and idle 2 Transferring data with FTP(S) server 3 Closing the FTP(S) server 4 The FTP(S) server is closed Integer type. The error code of the operation. See Chapter 5 for details. 2.18. AT+QFTPCLOSE Log out from FTP(S) Server This command logs out from FTP(S) server. If OK is returned, +QFTPCLOSE: , should be outputted within configured by AT+QFTPCFG. Otherwise, the network should be deactivated and reactivated. AT+QFTPCLOSE Log out from FTP(S) Server Test Command AT+QFTPCLOSE=? Execution Command AT+QFTPCLOSE Response OK Response OK +QFTPCLOSE: , If there is any error: +CME ERROR: BG95&BG77&BG600L_Series_FTP(S)_Application_Note 33 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Parameter Integer type. The error code of the operation. See Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, see Chapter 6. If it is 0, it is invalid. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 34 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 3 Examples 3.1. Login to FTP Server //Step 1: Configure and activate the PDP context. AT+QICSGP=1,1,'CMNBIOT','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //Configure PDP context 1. APN is 'CMNBIOT' for China Mobile NB-IOT network. //Activate PDP context 1. //Activated successfully. //Query the state of PDP context. OK AT+QFTPCFG='contextid',1 1 OK //Configure the PDP context ID as 1 (PDP context has been activated). //Step 2: Configure user account and transfer settings. AT+QFTPCFG='account','test','test' //Set user name and password. OK AT+QFTPCFG='filetype',1 //Set the data type as ASCII. OK AT+QFTPCFG='transmode',1 //Set transfer mode as passive mode. OK AT+QFTPCFG='rsptimeout',90 //Set response timeout value. OK //Step 3: Login to FTP server. AT+QFTPOPEN='hf.quectel.com',21 OK +QFTPOPEN: 0,0 BG95&BG77&BG600L_Series_FTP(S)_Application_Note 35 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 3.2. Login to FTPS Server //Step 1: Configure and activate the PDP context. AT+QICSGP=1,1,'CMNBIOT','','',1 //Configure PDP context 1. APN is 'CMNBIOT' for China Mobile NB-IOT network. OK AT+QIACT=1 //Activate PDP context 1. OK //Activated successfully. AT+QIACT? //Query the state of PDP context. +QIACT: 1,1,1, '10.7.157.1' OK AT+QFTPCFG='contextid',1 OK //Configure the PDP context ID as 1 (PDP context 1 has been activated). //Step 2: Configure user account and transfer settings. AT+QFTPCFG='account','test','test' //Set user name and password. OK AT+QFTPCFG='filetype',1 //Set the data type as ASCII. OK AT+QFTPCFG='transmode',1 //Set transfer mode as passive mode. OK AT+QFTPCFG='rsptimeout',90 //Set response timeout value. OK //Step 3: FTPS configuration AT+QFTPCFG='ssltype',1 OK AT+QFTPCFG='sslctxid',0 OK AT+QSSLCFG='ciphersuite',0,0XFFFF OK AT+QSSLCFG='seclevel',0,0 OK AT+QSSLCFG='sslversion',0,4 OK //Set SSL type as 1 (the module works as FTPS client). //Select SSL context 0. //Configure SSL cipher suite type as 0XFFFF, which means all cipher suite types are supported. //Configure SSL security level as 0, which means the SSL CA certificate is not needed. //Configure SSL version as 4, which means all SSL Version. //Step 4: Login to FTPS server. AT+QFTPOPEN='hf.quectel.com',990 OK BG95&BG77&BG600L_Series_FTP(S)_Application_Note 36 / 50 +QFTPOPEN: 0,0 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 3.3. Folder Operation AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPPWD OK +QFTPPWD: 0,'/' AT+QFTPMKDIR='TEST' OK +QFTPMKDIR: 0,0 AT+QFTPRENAME='TEST','TEST_NEW' OK +QFTPRENAME: 0,0 AT+QFTPRMDIR='TEST_NEW' OK +QFTPRMDIR: 0,0 //Set the current directory. //Query the current directory. //Create a folder as TEST on FTP(S) server. //Rename the folder into TEST_NEW. //Delete the folder. 3.4. File Operation AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPPWD OK +QFTPPWD: 0, '/' AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 1000 //Set the current directory. //Query the current directory. //Query the size of test_my1.txt on FTP(S) server. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 37 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note AT+QFTPRENAME='test_my1.txt','test_new.txt' //Rename the file into test_new.txt. OK +QFTPRENAME: 0,0 AT+QFTPMDTM='test_new.txt' OK //Get the file modification time of test_new.txt on FTP(S) server. +QFTPMDTM: 0, '20140708110039' AT+QFTPDEL='test_new.txt' //Delete test_new.txt on FTP(S) server. OK +QFTPDEL: 0,0 3.5. List File Information or File Names AT+QFTPCWD='/' OK //Set the current directory. +QFTPCWD: 0,0 AT+QFTPLIST='.','COM:' CONNECT OK //List the content of the current directory and the data will be outputted to COM port. +QFTPLIST: 0,1000 AT+QFTPLIST='.','list.txt' outputted to list.txt. OK //List the content of the current directory and the data will be +QFTPLIST: 0,1000 AT+QFTPLIST='TEST_2','COM:' CONNECT OK //List the content of TEST_2 and the data will be outputted to COM port. +QFTPLIST: 0,1000 AT+QFTPNLST='.','COM:' CONNECT //List file names of the current directory and the data will be outputted to COM port. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 38 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note OK +QFTPNLST: 0,1000 AT+QFTPNLST='.','nlst.txt' OK //List file names of the current directory and the data will be outputted to nlst.txt. +QFTPNLST: 0,1000 AT+QFTPNLST='TEST_2','COM:' CONNECT OK //List file names of TEST_2 and the data will be outputted to COM port. +QFTPNLST: 0,1000 AT+QFTPMLSD='.','COM:' CONNECT OK //List standardized file and directory information of the current directory and the data will be outputted to COM port. +QFTPMLSD: 0,1000 AT+QFTPMLSD='.','nlst.txt' OK //List standardized file and directory information of the current directory and the data is outputted to nlst.txt. +QFTPMLSD: 0,1000 AT+QFTPMLSD='TEST_2','COM:' CONNECT OK //List standardized directory information of TEST_2 and the data is outputted to COM port. +QFTPMLSD: 0,1000 3.6. Upload a File to FTP(S) Server AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPSTAT BG95&BG77&BG600L_Series_FTP(S)_Application_Note 39 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note +QFTPSTAT: 0,1 OK //Upload a file via COM port. AT+QFTPPUT='test_my.txt','COM:',0 CONNECT //Input the data via COM port. +++ OK //All data will be saved as test_my.txt on FTP(S) server. //Exit data mode +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my.txt' OK +QFTPSIZE: 0,1000 //Upload a file via COM port and the start position is 1000. AT+QFTPPUT='test_my.txt','COM:',1000 //All data will be saved as test_my.txt on FTP(S) server. CONNECT //Input the file data via COM port +++ //Exit data mode OK +QFTPPUT: 0,500 AT+QFTPSIZE='test_my.txt' OK +QFTPSIZE: 0,1500 //Upload a file via COM port to FTP(S) server twice in 1024 bytes each time. AT+QFTPPUT='test.txt','COM:',0,1024,0 //It is not the last 1024 bytes of test.txt. CONNECT //Input the file data via COM port OK //Data length reaches 1024 bytes. +QFTPPUT: 0,1024 AT+QFTPPUT='test.txt','COM:',1024,1024,1 CONNECT //It is the last 1024 bytes of test.txt. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 40 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note //Input the file data via COM port OK //Data length reaches 1024 bytes. +QFTPPUT: 0,1024 //Upload a file from UFS to FTP server. AT+QFUPL='test_ufs.txt',1000,300,1 CONNECT //Input 1000 bytes data +QFUPL: 1000,707 //Upload a file to UFS and the file will be saved as test_ufs.txt. The maximum file size is 1000 bytes. 300 indicates timeout value and 1 indicates ACK mode. For more details, see Quectel_BG95&BG77_FILE_Application_Note. OK AT+QFLST='*' +QFLST: 'test_ufs.txt',1000 OK AT+QFTPPUT='test_my1.txt', 'test_ufs.txt',0 OK //Upload test_ufs.txt to FTP(S) server and save it as test_my1.txt on FTP(S) server. +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 AT+QFDEL='test_ufs.txt' OK //Delete the local UFS file. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 41 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 3.7. Download a File from FTP(S) Server AT+QFTPCWD='/' OK +QFTPCWD: 0,0 //Solution 1: Output downloaded data directly via COM port. //Download a file from FTP(S) server and the data will be outputted to COM port. AT+QFTPGET='test_my.txt','COM:' CONNECT OK +QFTPGET: 0,1000 //Download a file and the data will be outputted to COM port twice in 500 bytes each time. AT+QFTPGET='test.txt','COM:',0,500 //The size of test.txt is 1000 bytes. Download the first 500 bytes. CONNECT OK +QFTPGET: 0,500 AT+QFTPGET='test.txt', 'COM:',500,500 CONNECT OK //Download the left 500 bytes. +QFTPGET: 0,500 //Solution 2: Save the downloaded data into a UFS file. //Download a file from FTP(S) server and save it to UFS. AT+QFTPGET='test_my1.txt','test.txt' //Download the file and save it to UFS as test.txt. OK +QFTPGET: 0,1000 AT+QFLST='*' +QFLST: test.txt,1000 OK //Download a file from FTP(S) server and save it to UFS. The start position is 450. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 42 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note AT+QFTPGET='test_my1.txt','test1.txt',450 OK //Download the file and save it to UFS as test.txt. +QFTPGET: 0,550 AT+QFTPLEN OK +QFTPLEN: 0,550 AT+QFLST='*' +QFLST: test.txt,1000 +QFLST: test1.txt,550 OK 3.8. Log out from FTP(S) Server AT+QFTPCLOSE OK +QFTPCLOSE: 0,0 AT+QIDEACT=1 OK //Log out from FTP(S) server. //Deactivate the PDP context which was activated for FTP(S). BG95&BG77&BG600L_Series_FTP(S)_Application_Note 43 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 4 Error Handling 4.1. Executing FTP(S) AT Command Fails When executing FTP(S) AT commands, if ERROR response is received from the module, check whether the U(SIM) card is inserted and whether it is +CPIN: READY returned when executing AT+CPIN?. 4.2. PDP Activation Fails If it is failed to activate a PDP context with AT+QIACT, check the following configurations: 1. Query the PS domain status by AT+CEREG? (for LTE Cat M and Cat NB2 networks) or AT+CGREG? (for EGPRS network) and make sure the PS domain has been registered. 2. Query the PDP context parameters by AT+QICSGP= and make sure the APN of the specified PDP context has been set. 3. Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT. 4. The module supports maximum three PDP contexts activated simultaneously under LTE Cat M/ EGPRS and maximum two under LTE Cat NB2. If all above configurations are correct, but activating the PDP context by AT+QIACT still fails, reboot the module to resolve this issue. After rebooting the module, check the configurations mentioned above for at least three times and each time at an interval of 10 minutes to avoid frequent rebooting of the module. 4.3. DNS Parse Fails When executing AT+QFTPOPEN, if +QFTPOPEN: 604,0 is returned, check the following aspects: 1. Make sure the domain name of FTP(S) server is valid. 2. Query the status of the PDP context with AT+QIACT? to make sure the specified PDP context has been activated successfully. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 44 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 4.4. Error Response of FTP(S) Server When the in +QFTPXX: , is not 0, it indicates an error code replied from FTP(S) server. The issue can be identified based on the returned protocol error code. For example, if is 530 (not logged in), or may be wrong. If is 550 (requested action not taken: file unavailable.), the file or directory may not exist. For more details, see RFC959 - File Transfer Protocol. BG95&BG77&BG600L_Series_FTP(S)_Application_Note 45 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 5 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about are described in the following table. Table 3: Summary of Error Codes 0 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 Description Operation successful Unknown error FTP(S) server blocked FTP(S) server busy DNS parse failed Network error Control connection closed. Data connection closed Socket closed by peer Timeout error Invalid parameter Failed to open file File position invalid File error Service not available, closing control connection Open data connection failed Connection closed; transfer aborted Requested file action not taken BG95&BG77&BG600L_Series_FTP(S)_Application_Note 46 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 618 Requested action aborted: local error in processing 619 Requested action not taken: insufficient system storage 620 Syntax error, command unrecognized 621 Syntax error in parameters or arguments 622 Command not implemented 623 Bad sequence of commands 624 Command parameter not implemented 625 Not logged in 626 Need account for storing files 627 Requested action not taken 628 Requested action aborted: page type unknown 629 Requested file action aborted 630 Requested file name invalid 631 SSL authentication failed BG95&BG77&BG600L_Series_FTP(S)_Application_Note 47 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 6 Summary of FTP(S) Protocol Error Codes The protocol error code indicates an error replied from FTP(S) server when it is not 0. See RFC959 - File Transfer Protocol. The details of are described in the following table. Table 4: Summary of FTP(S) Protocol Error Codes 421 425 426 450 451 452 500 501 502 503 504 530 532 550 551 552 553 Description Service not available, closing control connection Opening data connection failed Connection closed; transfer aborted Requested file action not taken Requested action aborted: local error in processing Requested action not taken: insufficient system storage Syntax error, command unrecognized Syntax error in parameters or arguments Command not implemented Bad sequence of commands Command parameter not implemented Not logged in Need account for storing files Requested action not taken: file unavailable Requested action aborted: page type unknown Requested file action aborted: exceeded storage allocation Requested action not taken: file name not allowed BG95&BG77&BG600L_Series_FTP(S)_Application_Note 48 / 50 LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note 7 Appendix A References Table 5: Related Documents SN Document Name Remark [1] RFC959 File Transfer Protocol [2] Quectel_BG95&BG77_TCP(IP)_Application_Note BG95&BG77 TCP/IP AT Commands Manual [3] Quectel_BG95&BG77_FILE_Application_Note BG95&BG77 FILE AT Commands Manual [4] Quectel_BG95&BG77_AT_Commands_Manual BG95&BG77 AT Commands Manual [5] Quectel_BG95&BG77_SSL_Application_Note BG95&BG77 SSL AT Commands Manual Table 6: Terms and Abbreviations Abbreviation ACK APN ASCII DNS IP DTR FTP FTPS PDP PPP Description Acknowledgement Access Point Name American Standard Code for Information Interchange Domain Name Server Internet Protocol Data Terminal Ready File Transfer Protocol FTP over SSL Packet Data Protocol Point-to-Point Protocol BG95&BG77&BG600L_Series_FTP(S)_Application_Note 49 / 50 PS SSL TLS UFS URC (U)SIM LPWA Module Series BG95&BG77&BG600L Series FTP(S) Application Note Packet Switching Secure Sockets Layer Transport Layer Security Universal Flash Storage Unsolicited Result Code (Universal) Subscriber Identity Module BG95&BG77&BG600L_Series_FTP(S)_Application_Note 50 / 50

BG95&BG77&BG600L Series FILE Application Note LPWA Module Series Version: 1.1 Date: 2020-10-29 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_FILE_Application_Note 1 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Copyright The information contained here is proprietary technical information of Quectel Wireless Solutions Co., Ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved. BG95&BG77&BG600L_Series_FILE_Application_Note 2 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note About the Document Revision History Version Date Author 1.0 2019-09-02 Alfred LI Matt YE/ 1.1 2020-10-29 Egbert XU Description Initial 1. Enabled EUFS (Extended User File Storage on application side) for the module. 2. Added the value 3 for in AT+QFOPEN. 3. Added AT+QFCRC and AT+QFCPY. 4. Added an example to illustrate how to write and read an EUFS file (Chapter 3.2.2). BG95&BG77&BG600L_Series_FILE_Application_Note 3 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Contents About the Document ................................................................................................................................... 3 Contents ....................................................................................................................................................... 4 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. Applicable Modules ..................................................................................................................... 6 1.2. The Process of Using FILE AT Commands ................................................................................ 7 1.3. Description of Data Mode ........................................................................................................... 7 2 Description of FILE AT Commands ................................................................................................... 9 2.1. AT Command Syntax .................................................................................................................. 9 2.1.1. Definitions......................................................................................................................... 9 2.1.2. AT Command Syntax ....................................................................................................... 9 2.2. Description of FILE AT Commands........................................................................................... 10 2.2.1. AT+QFLDS Get the Space Information of Storage ..................................................... 10 2.2.2. AT+QFLST List the File Information ............................................................................ 11 2.2.3. AT+QFDEL Delete File(s)............................................................................................ 12 2.2.4. AT+QFUPL Upload a File ............................................................................................ 13 2.2.5. AT+QFDWL Download a File ...................................................................................... 15 2.2.6. AT+QFOPEN Open a File ........................................................................................... 16 2.2.7. AT+QFREAD Read a File............................................................................................ 17 2.2.8. AT+QFWRITE Write a File .......................................................................................... 18 2.2.9. AT+QFSEEK Set File Pointer to a Position................................................................. 19 2.2.10. AT+QFPOSITION Get the Offset of a File Pointer...................................................... 20 2.2.11. AT+QFTUCAT Truncate a File from the File Pointer................................................... 20 2.2.12. AT+QFCLOSE Close a File......................................................................................... 21 2.2.13. AT+QFCRC Calculate the CRC of a Specified UFS File ............................................ 21 2.2.14. AT+QFCPY Make a Copy of a Specified File ............................................................. 22 3 Examples ............................................................................................................................................ 24 3.1. Upload and Download Files ...................................................................................................... 24 3.1.1. Upload a File .................................................................................................................. 24 3.1.2. Download a File ............................................................................................................. 25 3.2. Write and Read Files................................................................................................................. 25 3.2.1. Write and Read a UFS File ............................................................................................ 25 3.2.2. Write and Read an EUFS File........................................................................................ 25 4 Summary of Error Codes .................................................................................................................. 27 5 Appendix A Reference....................................................................................................................... 29 BG95&BG77&BG600L_Series_FILE_Application_Note 4 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Types of AT Commands and Responses ....................................................................................... 9 Table 3: Summary of Error Codes.............................................................................................................. 27 Table 4: Terms and Abbreviations .............................................................................................................. 29 BG95&BG77&BG600L_Series_FILE_Application_Note 5 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note 1 Introduction Quectel BG95 series, BG77 and BG600L-M3 modules provide AT commands to operate files on different physical storage mediums. This document is a reference guide to these commands. The supported storage mediums are as follows:  UFS: User File Storage directory on modem side. It is a special directory on the flash file system.  EUFS: Extended User File Storage on application side. The file name indicates the storage location. When the file name begins with 'EUFS:', it means the file is located in EUFS. If the file name begins with 'UFS:' or there are no prefix characters in the file name, the file is located in UFS. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_FILE_Application_Note 6 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note NOTE See the firmware release notes of corresponding module models to check whether the function has been supported. 1.2. The Process of Using FILE AT Commands The following illustrates the general procedure to upload/download, open/create, read and write a file in the storage: 1) Upload a file to the storage with AT+QFUPL. If necessary, output/download the file with AT+QFDWL to check the file content, data integrity, etc. 2) Open the file with AT+QFOPEN, and then you can write or read the file at any time and any location until the file is closed by AT+QFCLOSE.  When opening a file with AT+QFOPEN, you can set the file into overwrite mode or read-only mode or others with (see Chapter 2.6 for details). After the file is opened, a is assigned to it. Then the file can be operated via this .  After the file is opened, you can write it with AT+QFWRITE or read it with AT+QFREAD from the current file position.  You can set the file position with AT+QFSEEK and query the current position with AT+QFPOSITION.  AT+QFTUCAT will truncate the file from the current position to the end of the file. 3) Close the file with AT+QFCLOSE, after which the becomes meaningless any more. The following are several commonly used commands to manage files in the storage: 1) AT+QFLDS: Get the space information of storage 2) AT+QFLST: List the file information in the specified storage. 3) AT+QFDEL: Delete the file(s) in the specified storage. 1.3. Description of Data Mode The COM port of the modules has two working modes: AT command mode and data mode. In AT command mode, the inputted data via COM port is taken as AT command. While in data mode, it is taken as data. Inputting +++ or pulling up MAIN_DTR pin (AT&D1 should be set first) can make the COM port exit from data mode. To prevent the +++ from being misinterpreted as data, the following sequence should be BG95&BG77&BG600L_Series_FILE_Application_Note 7 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note followed: 1) Do not input any character for at least 1 second before you input +++. 2) Input +++ within 1 second, and no other characters can be inputted during the time. 3) Do not input any character for at least 1 second after +++ has been inputted. When AT+QFUPL, AT+QFDWL, AT+QFREAD and AT+QFWRITE are executed, the COM port enters data mode. If you use +++ or MAIN_DTR to make the port exit from data mode, the executing procedure of these commands will be interrupted before the response is returned. In such a case, the COM port cannot reenter data mode by executing ATO. BG95&BG77&BG600L_Series_FILE_Application_Note 8 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note 2 Description of FILE AT Commands 2.1. AT Command Syntax 2.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on the command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is omitted, the new value equals to the previous value or the default settings, unless otherwise specified.  Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with 'AT' or 'at' and end with ''. Information responses and result codes always start and end with a carriage return character and a line feed character: . Throughout this document, only the commands and responses are presented, while carriage return and line feed characters are deliberately omitted. Table 2: Types of AT Commands and Responses Command Type Syntax Description Test Command Read Command Write Command Execution Command AT+=? Returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. AT+? Returns the currently set value of a parameter or parameters. AT+= Sets parameter values. [,[,[...]]] AT+ Reads non-variable parameters affected by internal processes in the module. BG95&BG77&BG600L_Series_FILE_Application_Note 9 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note 2.2. Description of FILE AT Commands 2.2.1. AT+QFLDS Get the Space Information of Storage This command gets the space information of the specified storage. AT+QFLDS Get the Space Information of Storage Test Command AT+QFLDS=? Write Command AT+QFLDS= Response OK Response +QFLDS: , OK Execution Command AT+QFLDS If there is an error related to ME functionality: +CME ERROR: Response +QFLDS: , OK Characteristics If there is any error: +CME ERROR: / Parameter String type. Storage pattern. 'UFS' UFS on Modem side 'EUFS' Extended UFS on AP side Integer type. The free space size of . Unit: byte. Integer type. The total size of . Unit: byte. Integer type. The size of all files in UFS. Unit: byte Integer type. The number of files in UFS. Integer type. Error code. See Chapter 4 for possible values. Example AT+QFLDS='UFS' +QFLDS: 1249984,1562624 OK //Query the space information of UFS on Modem side. BG95&BG77&BG600L_Series_FILE_Application_Note 10 / 29 AT+QFLST='*' +QFLST: 'Test1.txt',10 +QFLST: 'Test2.txt',16 +QFLST: 'Test3.txt',150 +QFLST: 'Test4.txt',2056 +QFLST: 'Test5.txt',98 OK AT+QFLDS +QFLDS: 2330,5 OK LPWA Module Series BG95&BG77&BG600L Series FILE Application Note //Query the size and number of all files in UFS. 2.2.2. AT+QFLST List the File Information This command lists the information of a single file or all files in the specified storage. AT+QFLST List the File Information Test Command AT+QFLST=? Write Command AT+QFLST= Response OK Response +QFLST: , [+QFLST: , […]] OK Execution Command AT+QFLST If there is any error: +CME ERROR: Response Return the information of UFS files: +QFLST: , [+QFLST: , […]] OK Characteristics If there is any error: +CME ERROR: / BG95&BG77&BG600L_Series_FILE_Application_Note 11 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Parameter String type. The file to be listed. '*' All the files in UFS 'UFS:*' All the files in UFS 'EUFS:/ufs/*' All the files in ufs directory of EUFS 'EUFS:/datatx/*' All the files in datatx directory of EUFS 'EUFS:*' All the files in ufs directory of EUFS '' A specified file in UFS 'UFS:' A specified file in UFS 'EUFS:' A specified file in ufs directory of EUFS 'EUFS:/ufs/' A specified file in ufs directory of EUFS 'EUFS:/datatx/'A specified file in datatx directory of EUFS String type. Filename. The maximum length of is 80 bytes. Integer type. Size of the file. Unit: byte. Integer type. Error code. See Chapter 4 for possible values. Example AT+QFLST='*' +QFLST: 'F_M12-1.bmp',562554 +QFLST: 'F_M12-10.bmp',562554 +QFLST: 'F_M12-11.bmp',562554 OK AT+QFLST='Test1.txt' +QFLST: 'Test1.txt',2 OK AT+QFLST='EUFS:/ufs/*' +QFLST: 'EUFS:test.txt',10 +QFLST: 'EUFS:test2.txt',20 OK AT+QFLST='EUFS:test.txt' +QFLST: 'EUFS:test.txt',10 OK //List all the files in UFS. //List a specified file 'Test1.txt' in UFS. //List all the files in ufs directory of EUFS . //List a specified file 'test.txt' in ufs directory of EUFS. 2.2.3. AT+QFDEL Delete File(s) This command deletes a specified file or all the files in the storage. BG95&BG77&BG600L_Series_FILE_Application_Note 12 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note AT+QFDEL Delete File(s) Test Command AT+QFDEL=? Write Command AT+QFDEL= Characteristics Response +QFDEL: OK Response OK If there is any error: +CME ERROR: / Parameter String type. Name of the file to be deleted. The maximum length of is 80 bytes. '*' All the files in UFS 'UFS:*' All the files in UFS 'EUFS:/ufs/*' Delete all the files in ufs directory of EUFS (ufs directory is remained) 'EUFS:/datatx/*' Delete all the files in datatx directory of EUFS (datatx directory is remained) 'EUFS:*' Delete all the files in ufs directory of EUFS (ufs directory is remained) '' A specified file in UFS 'UFS:' A specified file in UFS 'EUFS:' Delete a specified file in ufs directory of EUFS 'EUFS:/ufs/' Delete a specified file in ufs directory of EUFS 'EUFS:/datatx/' Delete a specified file in datatx of EUFS Integer type. Error code. See Chapter 4 for possible values. Example AT+QFDEL='*' OK AT+QFDEL='Test1.txt' OK 2.2.4. AT+QFUPL Upload a File This command uploads a file to the storage. If any file in the storage has the same name with the file uploaded, an error is reported. BG95&BG77&BG600L_Series_FILE_Application_Note 13 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note After the Write Command is executed and CONNECT is returned, the module switches to data mode. When the uploaded data reaches , or there is no any data inputted when reaches, the module exits from data mode automatically. During data transmission, you can use +++ or MAIN_DTR to make the module exit from data mode, and more details are provided in Chapter 1.2. AT+QFUPL Upload a File Test Command AT+QFUPL=? Response +QFUPL: [,(1-)[,(range of supported s)[,(list of supported s)]]] Write Command AT+QFUPL=[,[, [,]]] OK Response CONNECT TA switches to the data mode (transparent access mode), and the binary data of file can be inputted. When the total size of the inputted data reaches (unit: byte), TA will return to command mode and reply the following codes: +QFUPL: , OK Characteristics If there is any error: +CME ERROR: / Parameter Integer type. The free space size of . See AT+QFLDS for more details of . String type. Name of the file to be uploaded. The maximum length is 80 bytes. '' Upload the file to UFS 'UFS:' Upload the file to UFS 'EUFS:' Upload the file to ufs directory of EUFS 'EUFS:/ufs/' Upload the file to ufs directory of EUFS 'EUFS:/datatx/' Upload the file to datatx directory of EUFS Integer type. The file size expected to be uploaded. Default value: 10240. Unit: byte. The maximum length is not greater than . Integer type. The actual size of the uploaded data. Unit: byte. Integer type. The time waiting for data to be inputted to USB/UART. Range: 1–65535. Default value: 5. Unit: s. Integer type. Whether to use ACK mode. 0 Turn off the ACK mode by default. 1 Turn on the ACK mode. BG95&BG77&BG600L_Series_FILE_Application_Note 14 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Integer type. The checksum of the uploaded data. Integer type. Error code. See Chapter 4 for possible values. NOTES 1. It is strongly recommended to use DOS 8.3 file name format for . 2. is a 16-bit checksum based on bitwise XOR. If the number of the characters is odd, set the last character as the high 8 bit, and the low 8 bit as 0, and then use an XOR operator to calculate the checksum. +++ sequence will make TA end the command and switch to command mode. However, the data previously uploaded will be preserved in the file. 3. When executing the command, the data must be entered after CONNECT is returned. 4. The ACK mode is provided to avoid the loss of data when uploading a large file, in case hardware flow control does not work. The ACK mode works as follows: 1) Run AT+QFUPL=,,,1 to enable the ACK mode. 2) The module outputs CONNECT. 3) MCU sends 1K bytes data, and then BG95 series, BG77 and BG600L-M3 modules will respond with an A. 4) MCU receives this A and then sends the next 1K bytes data; 5) Repeat step 3) and 4) until the transfer is completed. 2.2.5. AT+QFDWL Download a File This command downloads a specified file from the storage. AT+QFDWL Download a File Test Command AT+QFDWL=? Response +QFDWL: Write Command AT+QFDWL= OK Response CONNECT TA switches to data mode, and the binary data of the file will be outputted. When the file is read over, TA will return to command mode and reply the following codes: +QFDWL: , OK Characteristics If there is any error: +CME ERROR: / BG95&BG77&BG600L_Series_FILE_Application_Note 15 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Parameter String type. Name of the file to be downloaded. The maximum length is 80 bytes. '' Download the file from UFS 'UFS:' Download the file from UFS 'EUFS:' Download the file from ufs directory of EUFS 'EUFS:/ufs/' Download the file from ufs directory of EUFS 'EUFS:/datatx/' Download the file from datatx directory of EUFS Integer type. The size of the downloaded data. Unit: byte. Integer type. The checksum of the downloaded data. Integer type. Error code. See Chapter 4 for possible values. NOTES 1. +++ sequence causes TA to end the command and switches to command mode. 2. is a 16-bit checksum based on bitwise XOR. 2.2.6. AT+QFOPEN Open a File This command opens a file and gets the file handle to be used in commands such as AT+QFREAD, AT+QFWRITE, AT+QFSEEK, AT+QFPOSITION, AT+QFTUCAT and AT+QFCLOSE. AT+QFOPEN Open a File Test Command AT+QFOPEN=? Response +QFOPEN: [,(range of supported s)] Read Command AT+QFOPEN? OK Response +QFOPEN: ,, [+QFOPEN: ,, […]] Write Command AT+QFOPEN=[,] OK Response +QFOPEN: OK Characteristics If there is any error: +CME ERROR: / BG95&BG77&BG600L_Series_FILE_Application_Note 16 / 29 Parameter LPWA Module Series BG95&BG77&BG600L Series FILE Application Note String type. Name of the file to be opened. The maximum length is 80 bytes. '' Open the file in UFS 'UFS:' Open the file in UFS 'EUFS:' Open the file of ufs directory of EUFS. 'EUFS:/ufs/' Open the file of ufs directory of EUFS 'EUFS:/datatx/' Open the file of datatx directory of EUFS Integer type. The handle of the file to be operated. Integer type. The open mode of the file. 0 If the file does not exist, it is created. If the file exists, it is opened directly. In any case, the file can be read and written. 1 If the file does not exist, it is created. If the file exists, it is overwritten. In any case, the file can be read and written. 2 If the file exists, it is opened directly and is read only. If the file does not exist, an error is returned. 3 If the file does not exist, it is created. If the file exists, write data to the file. In any case, the file can be read and written. Integer type. Error code. See Chapter 4 for possible values. NOTE starts form 0 in UFS and starts from 20000 in EUFS. 2.2.7. AT+QFREAD Read a File This command reads the data of a file which is specified by the file handle. The data starts from the current position of the file pointer which belongs to the file handle. AT+QFREAD Read a File Test Command AT+QFREAD=? Response +QFREAD: [,] Write Command AT+QFREAD=[,] OK Response CONNECT TA switches to data mode. When the total size of the data reaches (unit: byte), TA will return to command mode, display the result and then reply the following codes: OK If there is any error: BG95&BG77&BG600L_Series_FILE_Application_Note 17 / 29 Characteristics LPWA Module Series BG95&BG77&BG600L Series FILE Application Note +CME ERROR: / Parameter Integer type. The handle of the file to be operated. Integer type. The length of the file to be read out and the default is the file length. Unit: byte. Integer type. The actual read length. Unit: byte. Integer type. Error code. See Chapter 4 for possible values. 2.2.8. AT+QFWRITE Write a File This command writes data into a file. The data starts from the current position of the file pointer which belongs to the file handle. AT+QFWRITE Write a File Test Command AT+QFWRITE=? Response +QFWRITE: [,[,]] Write Command AT+QFWRITE=[, [,]] OK Response CONNECT TA switches to data mode. When the total size of the written data reaches (unit: byte) or the time reaches , TA will return to command mode and reply the following codes: +QFWRITE: , OK Characteristics If there is any error: +CME ERROR: / Parameter Integer type. The handle of the file to be operated. Integer type. The length of the file to be written. The maximum value of this parameter is determined by of AT+QFUPL. BG95&BG77&BG600L_Series_FILE_Application_Note 18 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Default value: 10240. Unit: byte. Integer type. The time waiting for data to be inputted to USB/UART. Range: 1– 65535. Default value: 5. Unit: s. Integer type. The actual written length. Unit: byte. Integer type. The total length of the file. Unit: byte. Integer type. Error code. See Chapter 4 for possible values. 2.2.9. AT+QFSEEK Set File Pointer to a Position This command sets a file pointer to a specified position. This will decide the starting position of commands such as AT+QFREAD, AT+QFWRITE, AT+QFPOSITION and AT+QFTUCAT. AT+QFSEEK Set File Pointer to a Position Test Command AT+QFSEEK=? Response +QFSEEK: ,[,] Write Command AT+QFSEEK=,[,< position>] OK Response OK If there is any error: +CME ERROR: Characteristics / Parameter Integer type. The handle of the file to be operated. Integer type. The number of bytes of the file pointer movement. Integer type. Pointer movement mode. 0 The beginning of the file. 1 The current position of the pointer. 2 The end of the file. Integer type. Error code. See Chapter 4 for possible values. NOTES 1. If =0 and exceeds the file size, the command returns ERROR. 2. If =1 and the total size of and the current position of the pointer exceed the file size, the command returns ERROR. 3. If =2, the handle moves forth. BG95&BG77&BG600L_Series_FILE_Application_Note 19 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note 2.2.10. AT+QFPOSITION Get the Offset of a File Pointer This command gets the offset of a file pointer from the beginning of the file. AT+QFPOSITION Get the Offset of a File Pointer Test Command AT+QFPOSITION=? Response +QFPOSITION: Write Command AT+QFPOSITION= OK Response +QFPOSITION: OK Characteristics If there is any error: +CME ERROR: / Parameter Integer type. The handle of the file to be operated. Integer type. The offset from the beginning of the file. Integer type. Error code. See Chapter 4 for possible values. 2.2.11. AT+QFTUCAT Truncate a File from the File Pointer This command truncates all the data behind the position that the file pointer indicates. AT+QFTUCAT Truncate a File from the File Pointer Test Command AT+QFTUCAT=? Response +QFTUCAT: Write Command AT+QFTUCAT= OK Response OK Characteristics If there is any error: +CME ERROR: / BG95&BG77&BG600L_Series_FILE_Application_Note 20 / 29 Parameter LPWA Module Series BG95&BG77&BG600L Series FILE Application Note Integer type. The handle of the file to be operated. Integer type. Error code. See Chapter 4 for possible values. 2.2.12. AT+QFCLOSE Close a File This command closes a file and ends all the operation to the file. After that, the file handle is released and should not be used again, unless open the file again with AT+QFOPEN. AT+QFCLOSE Close a File Test Command AT+QFCLOSE=? Response +QFCLOSE: Write Command AT+QFCLOSE= OK Response OK Characteristics If there is any error +CME ERROR: / Parameter Integer type. The handle of the file to be operated. Integer type. Error code. See Chapter 4 for possible values. 2.2.13. AT+QFCRC Calculate the CRC of a Specified UFS File This command calculates the CRC16, CRC16_CCITT and CRC32 checksum of a specified UFS file. AT+QFCRC Calculate the CRC of a Specified UFS File Test Command AT+QFCRC=? Response +QFCRC: Write Command AT+QFCRC= OK Response When the specified file exists, the command returns 32 bits CRC, 16 bits CRC CCITT and 16 bits CRC values: +QFCRC: ,, OK BG95&BG77&BG600L_Series_FILE_Application_Note 21 / 29 Characteristics LPWA Module Series BG95&BG77&BG600L Series FILE Application Note When the file exists but has no byte: +QFCRC: 0,0,0 If there is any error: +CME ERROR: / Parameter String type. The input format is 'UFS:filename' where 'UFS:' can be omitted. The 32 bits CRC value. The 16 bits CRC value. The 16 bits CRC CCITT value. Integer type. Error code. See Chapter 4 for possible values. NOTE This command is applicable to UFS files only. 2.2.14. AT+QFCPY Make a Copy of a Specified File This command copies the whole content of a source file to a destination file.  When the destination file has already existed, the command will return an ERROR unless =1.  When the destination file has the same name as the source file, the command will return an ERROR.  While the remaining space of the file system is smaller than the file size to be copied, the command also will return an ERROR. AT+QFCPY Make a Copy of a Specified File Test Command AT+QFCPY=? Response +QFCPY: ,[,] Write Command AT+QFCPY=,[,] OK Response OK Characteristics If there is any error: +CME ERROR: / BG95&BG77&BG600L_Series_FILE_Application_Note 22 / 29 Parameter LPWA Module Series BG95&BG77&BG600L Series FILE Application Note String type. The source file name. The input format is 'UFS:filename' where 'UFS:' can be omitted. String type. The destination file name. The file name input format is 'UFS:filename' where 'UFS:' can be omitted. Integer type. Determine whether to overwrite the existing file which has the same name as the destination file. 0 Disable 1 Enable Integer type. Error code. See Chapter 4 for possible values. NOTE This command is applicable to UFS files only. BG95&BG77&BG600L_Series_FILE_Application_Note 23 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note 3 Examples 3.1. Upload and Download Files 3.1.1. Upload a File 3.1.1.1. Non ACK Mode AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK AT+QFUPL='EUFS:test.txt',4 CONNECT +QFUPL: 4,6a05 OK //Upload the text file 'test1.txt' to UFS. //Upload the text file 'test.txt' to ufs directory of EUFS. 3.1.1.2. ACK Mode The ACK mode can make the data transmission more reliable. When transmitting a large file without hardware flow control, the ACK mode is recommended to be used to prevent the data from being lost. For more details about ACK mode, please refer to AT+QFUPL command. AT+QFUPL='test.txt',3000,5,1 CONNECT A A +QFUPL: 3000,B34A //Upload the text file 'test.txt' to UFS. //After receiving 1024 bytes data, the module returns A. And then the next 1024 bytes data can be inputted. BG95&BG77&BG600L_Series_FILE_Application_Note 24 / 29 OK 3.1.2. Download a File AT+QFDWL='test.txt' CONNECT +QFDWL: 10,613e OK LPWA Module Series BG95&BG77&BG600L Series FILE Application Note //Download the text file 'test.txt' from UFS. //Get the bytes of the downloaded data and the checksum. 3.2. Write and Read Files 3.2.1. Write and Read a UFS File AT+QFOPEN='test',0 +QFOPEN: 0 //Open the file to get the file handle. OK AT+QFWRITE=0,10 CONNECT +QFWRITE: 10,10 //Write 10 bytes to the file. //The actual bytes written and the size of the file are returned. OK AT+QFSEEK=0,0,0 OK AT+QFREAD=0,10 CONNECT 10 //Set the file pointer to the beginning of the file. //Read 10 bytes from the file. OK AT+QFCLOSE=0 OK //Close the file. 3.2.2. Write and Read an EUFS File AT+QFLDS='EUFS' +QFLDS: 1388544,2435072 //Query the space information of EUFS. OK BG95&BG77&BG600L_Series_FILE_Application_Note 25 / 29 AT+QFOPEN='EUFS:test',0 +QFOPEN: 20000 OK AT+QFWRITE=20000,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=20000,0,0 OK AT+QFREAD=20000,10 CONNECT 10 OK AT+QFCLOSE=20000 OK LPWA Module Series BG95&BG77&BG600L Series FILE Application Note //Open the file to get the file handle. //Write 10 bytes to the file. //The actual bytes written and the size of the file are returned. //Set the file pointer to the beginning of the file. //Read 10 bytes from the file. //Close the file. BG95&BG77&BG600L_Series_FILE_Application_Note 26 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note 4 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about are described in the following table, and these error codes are only related to file operation of the modules. Table 3: Summary of Error Codes 400 401 402 403 405 406 407 409 410 411 413 414 416 417 418 419 Meaning Invalid input value Larger than the size of the file Read zero byte Drive full File not found Invalid file name File already existed Fail to write the file Fail to open the file Fail to read the file Reach the max number of file allowed to be opened The file read-only Invalid file descriptor Fail to list the file Fail to delete the file Fail to get disk info BG95&BG77&BG600L_Series_FILE_Application_Note 27 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note 420 No space 421 Time out 423 File too large 425 Invalid parameter 426 File already opened BG95&BG77&BG600L_Series_FILE_Application_Note 28 / 29 LPWA Module Series BG95&BG77&BG600L Series FILE Application Note 5 Appendix A Reference Table 4: Terms and Abbreviations Abbreviation ACK COM CRC DOS EUFS ME TA UART UFS USB XOR Description Acknowledgement Communication Port Cyclic Redundancy Check Disk Operating System Extended User File Storage Mobile Equipment Terminal Adapter Universal Asynchronous Receiver/Transmitter User File Storage Universal Serial Bus Exclusive OR BG95&BG77&BG600L_Series_FILE_Application_Note 29 / 29

BG95&BG77&BG600L Series MQTT Application Note LPWA Module Series Rev. BG95&BG77&BG600L_Series_MQTT_Application_Note_V1.1 Date: 2020-05-28 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China. Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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 WITHOUT PERMISSION ARE FORBIDDEN. 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. 2020. All rights reserved. BG95&BG77&BG600L_Series_MQTT_Application_Note 1 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note About the Document Revision History Version Date Author 1.0 2019-08-08 Lane HAO 1.1 2020-05-28 Jaryoung LI Description Initial 1. Added an applicable module BG600L-M3. 2. Updated the maximum length of messages to be published into 4096 bytes ( of AT+QMTPUB). 3. Deleted AT+QMTCFG='prefix'. 4. Updated the error response of the AT commands in Chapter 3.2. 5. Deleted the summary of error codes. BG95&BG77&BG600L_Series_MQTT_Application_Note 2 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 1.1. Applicable Modules ..................................................................................................................... 5 2 MQTT Data Interaction......................................................................................................................... 6 3 MQTT Related AT Commands ............................................................................................................ 7 3.1. AT Command Syntax .................................................................................................................. 7 3.1.1. Definitions......................................................................................................................... 7 3.1.2. AT Command Syntax ....................................................................................................... 7 3.2. Description of MQTT Related AT Commands............................................................................. 8 3.2.1. AT+QMTCFG Configure Optional Parameters of MQTT .............................................. 8 3.2.2. AT+QMTOPEN Open a Network for MQTT Client ...................................................... 13 3.2.3. AT+QMTCLOSE Close a Network for MQTT Client ................................................... 13 3.2.4. AT+QMTCONN Connect a Client to MQTT Server..................................................... 14 3.2.5. AT+QMTDISC Disconnect a Client from MQTT Server .............................................. 16 3.2.6. AT+QMTSUB Subscribe to Topics .............................................................................. 16 3.2.7. AT+QMTUNS Unsubscribe from Topics ...................................................................... 17 3.2.8. AT+QMTPUB Publish Messages ................................................................................ 18 3.2.9. AT+QMTPUBEX Publish Messages ........................................................................... 20 3.2.10. AT+QMTRECV Read Messages from Buffers ............................................................ 22 4 MQTT Related URCs .......................................................................................................................... 24 4.1. +QMTSTAT: URC to Indicate State Change in MQTT Link Layer ......................................... 24 4.2. +QMTRECV: URC to Inform the Host to Read MQTT Packet Data ...................................... 25 5 Examples ............................................................................................................................................ 26 5.1. Example of MQTT Operation without SSL ............................................................................... 26 5.2. Example of MQTT Operation with SSL..................................................................................... 28 6 Appendix A References..................................................................................................................... 30 BG95&BG77&BG600L_Series_MQTT_Application_Note 3 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note Table Index Table 1: MQTT Related URCs ................................................................................................................... 24 Table 2: Error Codes of +QMTSTAT: URC................................................................................................. 24 Table 3: Related Documents ...................................................................................................................... 30 Table 4: Terms and Abbreviations .............................................................................................................. 30 BG95&BG77&BG600L_Series_MQTT_Application_Note 4 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 1 Introduction MQTT (Message Queuing Telemetry Transport) is a broker-based publish/subscribe messaging protocol designed to be open, simple, lightweight and easy to implement. It is designed for connections with remote locations where a 'small code footprint' is required or the network bandwidth is limited. This document mainly introduces how to use the MQTT function of Quectel BG95 series, BG77 and BG600L-M3 modules through AT commands. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-N1 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat NB2 Only Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_MQTT_Application_Note 5 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 2 MQTT Data Interaction This chapter gives the data interaction mechanism of MQTT function. MCU Modem Link layer MQTT Server AT+QMTCFG='will',, AT+QMTCFG='timeout',, AT+QMTOPEN=,, OK TCP-REQ +QMTOPEN: , AT+QMTCONN AT+QMTCONN=,, OK +QMTCONN: ,[,] TCP established CONN-REQ Start timer T1, T2 CONN ACK-IND Stop T1 or handle Excep1 AT+QMTSUB AT+QMTSUB=,, OK +QMTSUB: ,,[,] SUB-REQ () Start timer T1 SUB ACK-IND () Stop T1 or handle Excep2 AT+QMTUNS AT+QMTUNS=,, OK +QMTUNS: ,, AT+QMTPUB=,,=0,, OK UNS-REQ () Start timer T1 UNS ACK-IND () Stop T1 or handle Excep2 PUB-REQ AT+QMTPUB (=1) AT+QMTPUB=,,=1,, OK PUB-REQ () Start timer T1 +QMTPUB: ,,[,] PUB ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB (=2) AT+QMTPUB=,,=2,, OK +QMTPUB: ,,[,] PUB-REQ () Start timer T1 PUB REC-IND () Stop T1 or handle Excep2 PUB REL-REQ () Start timer T1 PUB COMP-IND () Stop T1 or handle Excep2 TCP SYN TCP SYN+ACK TCP ACK Send connect packet Receive connect ACK packet Send subscribe packet Receive subscribe ACK packet Send unsubscribe packet Receive unsubscribe ACK packet Send publish packet Send publish packet Receive publish ACK packet Send publish packet Receive publish receive packet Send publish release packet Receive publish complete packet T1 is packet transmission timeout. T2 is keep alive timer. In the absence of a data-related message during the T2 time period, the client will send PINGREQ packet. Excep1: Disconnect the TCP connection. Excep2: Resend packets unless maximum retry times is reached. Retry times is set by AT+QMTCFG. Whether the timeout information is reported can be configured by AT+QMTCFG. Receive PUBLISH Receive message in the form of URC. +QMTRECV: ,,, PUB-IND () PUB ACK/REC-REQ () Reply accor.d..ing to AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , DISC-REQ TCP-REQ TCP disconnected Receive publish packet Send publish reply packet Send disconnect packet TCP discon.n..ect request Note: refers to optional parameters. For more details about optional parameters, please refer to the description of corresponding AT command in Chapter 3.2. Figure 1: MQTT Data Interaction Diagram BG95&BG77&BG600L_Series_MQTT_Application_Note 6 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 3 MQTT Related AT Commands This chapter presents the AT commands for operating MQTT function. 3.1. AT Command Syntax 3.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on command line. When an optional parameter is omitted, the new value equals its previous value or its default setting, unless otherwise specified.  Underline Default setting of a parameter. 3.1.2. AT Command Syntax The AT or at prefix must be added at the beginning of each command line. Entering will terminate a command line. Commands are usually followed by a response that includes . Throughout this document, only the response will be presented, are omitted intentionally. Table 2: Type of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. [,[,[...]]] AT+ This command reads non-variable parameters affected by internal processes in the module. BG95&BG77&BG600L_Series_MQTT_Application_Note 7 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 3.2. Description of MQTT Related AT Commands 3.2.1. AT+QMTCFG Configure Optional Parameters of MQTT This command configures optional parameters of MQTT. AT+QMTCFG Configure Optional Parameters of MQTT Test Command AT+QMTCFG=? Response +QMTCFG: 'version',(range of supported s),(list of supported s) +QMTCFG: 'pdpcid',(range of supported s),(range of supported s) +QMTCFG: 'ssl',(range of supported s),( list of supported s),(range of supported s) +QMTCFG: 'keepalive',(range of supported s,(range of supported s) +QMTCFG: 'session',(range of supported s),(list of supported s) +QMTCFG: 'timeout',(range of supported s),(range of supported s),(range of supported s),(list of supported s) +QMTCFG: 'will',(range of supported s),(list of supported s),(range of supported s),(list of supported s),, +QMTCFG: 'recv/mode',(range of supported s),(list of supported s),(list of supported s) +QMTCFG: 'aliauth',(range of supported s),,, Write Command Query/set the MQTT protocol version AT+QMTCFG='version',[,] OK Response If the optional parameter is omitted, query the MQTT protocol version: +QMTCFG: 'version', OK If the optional parameter is specified, set the MQTT protocol version: OK BG95&BG77&BG600L_Series_MQTT_Application_Note 8 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note Write Command Query/set the PDP to be used by the MQTT client AT+QMTCFG='pdpcid',[,] If there is any error: ERROR Response If the optional parameter is omitted, query the PDP used by the MQTT client: +QMTCFG: 'pdpcid', OK If the optional parameter is specified, set the PDP to be used by the MQTT client: OK Write Command Query/set the MQTT SSL mode and SSL context index AT+QMTCFG='ssl',[,< SSL_enable>[,]] If there is any error: ERROR Response If the optional parameters are omitted, query the MQTT SSL mode and SSL context index: +QMTCFG: 'ssl',[,] OK If any of the optional parameters is specified, set the MQTT SSL mode and SSL context index: OK Write Command Query/set the keep-alive time AT+QMTCFG='keepalive',[,] If there is any error: ERROR Response If the optional parameter is omitted, query the keep-alive time: +QMTCFG: 'keepalive', OK If the optional parameter is specified, set the keep-alive time: OK Write Command Query/set the session type AT+QMTCFG='session',[,] If there is any error: ERROR Response If the optional parameter is omitted, query the session type: +QMTCFG: 'session', OK BG95&BG77&BG600L_Series_MQTT_Application_Note 9 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note If the optional parameter is specified, set the session type: OK Write Command Query/set the timeout of message delivery AT+QMTCFG='timeout',[,[,] [,]] If there is any error: ERROR Response If the optional parameters are omitted, query the timeout of message delivery: +QMTCFG: 'timeout',,, OK If any of the optional parameters is specified, set the timeout of message delivery: OK Write Command Query/set the Will information AT+QMTCFG='will',[, [,, ,,]] If there is any error: ERROR Response If the optional parameters are omitted, query the Will information: +QMTCFG: 'will',[,,,,] OK If any of the optional parameters is specified, set the Will information: OK Write Command Query/set the MQTT message receiving mode when the data is received from server AT+QMTCFG='recv/mode',[,[,]] If there is any error: ERROR Response If the optional parameters are omitted, query the MQTT message receiving mode. +QMTCFG: 'recv/mode',[,] OK If any of the optional parameters is specified, set the MQTT message receiving mode: OK BG95&BG77&BG600L_Series_MQTT_Application_Note 10 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note Write Command Query/set Alibaba device information for AliCloud AT+QMTCFG='aliauth',[,,,] If there is any error: ERROR Response If the optional parameters are omitted, query the device information: [+QMTCFG: 'aliauth',,,] OK If the optional parameters are specified, set the device information: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. MQTT protocol version. 3 MQTT v3.1 4 MQTT v3.1.1 Integer type. The PDP to be used by the MQTT client. Range: 1–16. Default value : 1. Integer type. Configure the Will flag. 0 Ignore the Will flag configuration 1 Require the Will flag configuration Integer type. Quality of service for message delivery. 0 At most once 1 At least once 2 Exactly once Integer type. The Will retain flag is only used on PUBLISH messages. 0 When a client sends a PUBLISH message to a server, the server will not hold on to the message after it has been delivered to the current subscribers 1 When a client sends a PUBLISH message to a server, the server should hold on to the message after it has been delivered to the current subscribers Will topic string. The maximum length is 255 bytes. String type. The Will message defines the content of the message that is published to the Will topic if the client is unexpectedly disconnected. It can be a BG95&BG77&BG600L_Series_MQTT_Application_Note 11 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note zero-length message. The maximum length is 255 bytes. Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. Integer type. 0 Not report timeout message when transmitting packet 1 Report timeout message when transmitting packet Integer type. Configure the session type. 0 The server must store the subscriptions of the client after it is disconnected. 1 The server must discard any previously maintained information about the client and treat the connection as 'clean'. Integer type. Keep-alive time. Range: 0–3600. Default value: 120. Unit: second. It defines the maximum time interval between messages received from a client. If the server does not receive a message from the client within 1.5 times of the keep-alive time period, it disconnects the client as if the client has sent a DISCONNECT message. If the keep-alive value is 0, this means the server is not required to disconnect the client on the grounds of inactivity. Integer type. MQTT SSL mode. 0 Use normal TCP connection for MQTT 1 Use SSL TCP secure connection for MQTT Integer type. SSL context index. Range: 0–5. Integer type. The MQTT message receiving mode. 0 MQTT message received from server will be contained in URC 1 MQTT message received from server will not be contained in URC Integer type. 0 Length of MQTT message received from server will not be contained in URC 1 Length of MQTT message received from server will be contained in URC Product key issued by AliCloud. Device name issued by AliCloud. Device secret key issued by AliCloud. NOTES 1. If =1, then , , and must be specified. Otherwise they will be omitted. 2. =0 is only effective when the server supports the operation. 3. If MQTT connection is configured to SSL mode, must be specified, and AT+QSSLCFG must be used to configure the SSL version, cipher suite, secure level, CA certificate, client certificate, client key and ignorance of RTC time, which will be used in MQTT SSL handshake procedure. For more details of AT+QSSLCFG, please refer to Quectel_BG95&BG77_SSL_AT_Commands_Manual. 4. Care must be taken to ensure message delivery does not time out while it is still being sent. 5. AT+QMTCFG='aliauth' is only used for AliCloud. If it is configured, and in AT+QMTCONN can be omitted. BG95&BG77&BG600L_Series_MQTT_Application_Note 12 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 3.2.2. AT+QMTOPEN Open a Network for MQTT Client This command opens a network for MQTT client. AT+QMTOPEN Open a Network for MQTT Client Test Command AT+QMTOPEN=? Response +QMTOPEN: (range of supported s),,(range of supported s) Read Command AT+QMTOPEN? OK Response [+QMTOPEN: ,,] Write Command AT+QMTOPEN=,, OK Response OK +QMTOPEN: , Maximum Response Time Characteristics If there is any error: ERROR Determined by network / Parameter Integer type. MQTT client identifier. Range: 0–5. String type. The address of the server. It could be an IP address or a domain name. The maximum size is 100 bytes. Integer type. The port number of the server. Range: 0–65535. Integer type. Result of the command execution. -1 Failed to open network 0 Network opened successfully 1 Wrong parameter 2 MQTT client identifier is occupied 3 Failed to activate PDP 4 Failed to parse domain name 5 Network connection error 3.2.3. AT+QMTCLOSE Close a Network for MQTT Client This command closes a network for MQTT client. BG95&BG77&BG600L_Series_MQTT_Application_Note 13 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note AT+QMTCLOSE Close a Network for MQTT Client Test Command AT+QMTCLOSE=? Response +QMTCLOSE: (range of supported s) Write Command AT+QMTCLOSE= OK Response OK +QMTCLOSE: , Maximum Response Time Characteristics If there is any error: ERROR 300 ms / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Result of the command execution. -1 Failed to close network 0 Network closed successfully 3.2.4. AT+QMTCONN Connect a Client to MQTT Server This command is used when a client requests a connection to MQTT server. When a TCP/IP socket connection is established from a client to a server, a protocol level session must be created using a CONNECT flow. AT+QMTCONN Connect a Client to MQTT Server Test Command AT+QMTCONN=? Response +QMTCONN: (range of supported s),,, Read Command AT+QMTCONN? OK Response [+QMTCONN: ,] Write Command AT+QMTCONN=,[,[,]] OK Response OK BG95&BG77&BG600L_Series_MQTT_Application_Note 14 / 30 Maximum Response Time Characteristics LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note +QMTCONN: ,[,] If there is any error: ERROR (default 5 s), determined by network / Parameter Integer type. MQTT client identifier. Range: 0–5. The client identifier string. String type. User name of the client. It can be used for authentication. String type. Password corresponding to the user name of the client. It can be used for authentication. Integer type. Result of the command execution. 0 Packet sent successfully and ACK received from server 1 Packet retransmission 2 Failed to send packet Integer type. MQTT connection state. 1 MQTT is initializing 2 MQTT is connecting 3 MQTT is connected 4 MQTT is disconnecting Integer type. Connection status return code. 0 Connection Accepted 1 Connection Refused: Unacceptable Protocol Version 2 Connection Refused: Identifier Rejected 3 Connection Refused: Server Unavailable 4 Connection Refused: Bad User Name or Password 5 Connection Refused: Not Authorized Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. NOTES 1. If a client with the same Client ID is already connected to the server, the 'older' client must be disconnected by the server before completing the CONNECT flow of the new client. 2. AT+QMTCFG='aliauth' is only used for AliCloud. If it is configured, then and in AT+QMTCONN can be omitted. BG95&BG77&BG600L_Series_MQTT_Application_Note 15 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 3.2.5. AT+QMTDISC Disconnect a Client from MQTT Server This command is used when a client requests a disconnection from MQTT server. A DISCONNECT message is sent from the client to the server to indicate that it is about to close its TCP/IP connection. AT+QMTDISC Disconnect a Client from MQTT Server Test Command AT+QMTDISC=? Response +QMTDISC: (range of supported s) Write Command AT+QMTDISC= OK Response OK +QMTDISC: , Maximum Response Time Characteristics If there is any error: ERROR 300 ms / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Result of the command execution -1 Failed to close connection 0 Connection closed successfully 3.2.6. AT+QMTSUB Subscribe to Topics This command is used to subscribe to one or more topics. A SUBSCRIBE message is sent by a client to register an interest in one or more topic names with the server. Messages published to these topics are delivered from the server to the client as PUBLISH messages. AT+QMTSUB Subscribe to Topics Test Command AT+QMTSUB=? Response +QMTSUB: (range of supported s),(range of supported s),,(range of supported s) Write Command AT+QMTSUB=,,,[,,…] Maximum Response Time Characteristics +QMTSUB: ,,[,] If there is any error: ERROR × (default 15 s), determined by network The command takes effect immediately. The configurations will not be saved. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of packet. Range: 1–65535. String type. The topic that the client wants to subscribe to or unsubscribe from. Integer type. The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once Integer type. Result of the command execution. 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet If is 0, it is a vector of granted QoS levels. If is 1, it means the times of packet retransmission. If is 2, it will not be presented. Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. NOTE The is only present in messages where the QoS bits in the fixed header indicate QoS levels 1 or 2. It must be unique amongst the set of 'inflight' messages in a particular direction of communication. It typically increases by exactly one from one message to the next, but is not required to do so. 3.2.7. AT+QMTUNS Unsubscribe from Topics This command is used to unsubscribe from one or more topics. An UNSUBSCRIBE message is sent by the client to the server to unsubscribe from named topics. BG95&BG77&BG600L_Series_MQTT_Application_Note 17 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note AT+QMTUNS Unsubscribe from Topics Test Command AT+QMTUNS=? Response +QMTUNS: (range of supported s),(range of supported s), Write Command AT+QMTUNS=,,[,…] OK Response OK +QMTUNS: ,, Maximum Response Time Characteristics If there is any error: ERROR × (default 15 s), determined by network The command takes effect immediately. The configurations will not be saved. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of packet. Range: 1–65535. String type. The topic that the client wants to subscribe to or unsubscribe from. Integer type. Result of the command execution. 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. 3.2.8. AT+QMTPUB Publish Messages This command publishes messages by a client to a server for distribution to interested subscribers. Each PUBLISH message is associated with a topic name. If a client subscribes to one or more topics, any message published to those topics are sent by the server to the client as a PUBLISH message. AT+QMTPUB Publish Messages Test Command AT+QMTPUB=? Response +QMTPUB: (range of supported s),(range of supported s),(range of supported s),(list of BG95&BG77&BG600L_Series_MQTT_Application_Note 18 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note supported s),,(range of supported s) Write Command Publish variable-length messages AT+QMTPUB=,, ,, OK Response > After > is responded, input the data to be sent. Tap Ctrl+Z to send the data, and tap Esc to cancel the operation. OK +QMTPUB: ,,[,] Write Command Publish fixed-length messages AT+QMTPUB=,, ,,, If there is any error: ERROR Response > After > is responded, input the data to be sent. The number of bytes of input data must equal . OK +QMTPUB: ,,[,] Maximum Response Time Characteristics If there is any error: ERROR × (default 15 s), determined by network / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of packet. Range: 0–65535. It will be 0 only when =0. Integer type. The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once Integer type. Whether or not the server will retain the message after it has been delivered to the current subscribers. 0 The server will not retain the message after it has been delivered to the current subscribers 1 The server will retain the message after it has been delivered to the current subscribers BG95&BG77&BG600L_Series_MQTT_Application_Note 19 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note String type. Topic that needs to be published. Integer type. Length of the message to be published. Range: 1–4096. Unit: byte. Integer type. Result of the command execution. 0 Packet sent successfully and ACK received from server (message that published when =0 does not require ACK) 1 Packet retransmission 2 Failed to send packet If is 1, it means the times of packet retransmission. If is 0 or 2, it will not be presented. Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. NOTES 1. If this command is executed successfully and gets OK back, the client can continue to publish new packets. The maximum quantity of packet to be transmitted should not be greater than that of inflight windows (5). 2. After executing this command, the client will be ready to send data, which will be sent as payload. The maximum length of the input data is 4096 bytes at a time and please tap Ctrl+Z to send the data. 3. PUBLISH messages can be sent either from a publisher to the server, or from the server to a subscriber. When a server publishes messages to a subscriber, the following URC will be returned to notify the host to read the received data that is reported by MQTT server: +QMTRECV: ,,, For more details about the URC description, please refer to Chapter 4.2. 3.2.9. AT+QMTPUBEX Publish Messages This command publishes messages. It provides the same functions as AT+QMTPUB, except that the format is different. AT+QMTPUBEX Publish Messages Test Command AT+QMTPUBEX=? Response +QMTPUBEX: (range of supported s),( range of supported s),(range of supported s),(list of supported s),, Write Command AT+QMTPUBEX=,,,,, OK Response OK +QMTPUB: ,,[,] BG95&BG77&BG600L_Series_MQTT_Application_Note 20 / 30 Maximum Response Time Characteristics LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note If there is any error: ERROR × (default 15 s), determined by network / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Message identifier of packet. Range: 0–65535. It will be 0 only when =0. Integer type. The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once Integer type. Whether or not the server will retain the message after it has been delivered to the current subscribers. 0 The server will not retain the message after it has been delivered to the current subscribers 1 The server will retain the message after it has been delivered to the current subscribers String type. Topic that needs to be published. String type. Message to be published. Maximum length is 560 bytes. Integer type. Result of the command execution. 0 Packet sent successfully and ACK received from server (message that published when =0 does not require ACK) 1 Packet retransmission 2 Failed to send packet If is 1, it means the times of packet retransmission. If is 0 or 2, it will not be presented. Integer type. Timeout of the packet delivery. Range: 1–60. Default value: 5. Unit: second. Integer type. Retry times when packet delivery times out. Range: 0–10. Default value: 3. NOTE AT+QMTPUBEX is an extension command of AT+QMTPUB, and its response follows AT+QMTPUB. BG95&BG77&BG600L_Series_MQTT_Application_Note 21 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 3.2.10. AT+QMTRECV Read Messages from Buffers This command reads messages from storage buffer where the messages are stored when they are reported by the server. AT+QMTRECV Read Messages from Buffers Test Command AT+QMTRECV=? Read Command AT+QMTRECV? Response OK Response +QMTRECV: ,,,,, OK Write Command AT+QMTRECV=[,] If there is no MQTT connection: OK Response List of (+QMTRECV: ,,,[,])s OK If there is no message received: OK Maximum Response Time Characteristics If there is no MQTT connection: ERROR 300 ms / Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. Indicate whether there is a message stored in the buffer. 0 means no, and 1 means yes. The maximum quantity of message that can be stored in the buffer is 5. Therefore, URC reports maximally 5 messages simultaneously. Integer type. Indicate the serial number of every single message received. Range: 0–4. All buffer data will be read if this parameter is not specified. Integer type. Message identifier of packet. Range: 0–65535. It will be 0 only when =0. String type. Topic that needs to be published. BG95&BG77&BG600L_Series_MQTT_Application_Note 22 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note Integer type. The length of payload. String type. The payload that relates to the topic name. BG95&BG77&BG600L_Series_MQTT_Application_Note 23 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 4 MQTT Related URCs This chapter gives MQTT related URCs and their descriptions. Table 1: MQTT Related URCs SN URC Format [1] +QMTSTAT: , +QMTRECV: ,,, [2] [3] +QMTRECV: , Description When the state of MQTT link layer is changed, the client will close the MQTT connection and report the URC. Reported when the client has received the packet data from MQTT server. Reported when the message received from MQTT server has been stored in buffer. 4.1. +QMTSTAT: URC to Indicate State Change in MQTT Link Layer The URC begins with +QMTSTAT:. It will be reported when there is a change in the state of MQTT link layer. +QMTSTAT: URC to Indicate State Change in MQTT Link Layer +QMTSTAT: , When the state of MQTT link layer is changed, the client will close the MQTT connection and report the URC. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. An error code. Please refer to the table below for details. Table 2: Error Codes of +QMTSTAT: URC Description The connection is closed or reset by 1 a peer. How to do Execute AT+QMTOPEN command to reopen the MQTT connection. BG95&BG77&BG600L_Series_MQTT_Application_Note 24 / 30 2 3 4 5 6 7 8–255 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note Sending PINGREQ packet timed out or failed. Sending CONNECT packet timed out or failed. Receiving CONNACK packet timed out or failed. The client sends DISCONNECT packet to sever and the server is initiative to close MQTT connection. The client takes the initiative to close the MQTT connection due to packet sending failure all the time. The link is not alive or the server is unavailable. Deactivate PDP first, and then activate PDP and reopen MQTT connection. 1. Check whether the inputted user name and password are correct. 2. Make sure the client ID is not used. 3. Reopen MQTT connection and try to send CONNECT packet to the server again. 1. Check whether the inputted user name and password are correct. 2. Make sure the client ID is not used. 3. Reopen MQTT connection and try to send CONNECT packet to the server again. This is a normal process. 1. Make sure the data is correct. 2. Try to reopen MQTT connection since there may be network congestion or an error. Make sure the link is alive or the server is available currently. Reserved for future use. 4.2. +QMTRECV: URC to Inform the Host to Read MQTT Packet Data The URC begins with +QMTRECV:. It is mainly used to inform the host to read the received MQTT packet data that is reported from MQTT server. +QMTRECV: URC to Inform the Host to Read MQTT Packet Data +QMTRECV: ,,< topic>, +QMTRECV: , Notify the host to read the received data that is reported from MQTT server. Notify that the message received from MQTT server has been stored in buffer. Parameter Integer type. MQTT client identifier. Range: 0–5. Integer type. The message identifier of packet. String type. The topic that received from MQTT server. String type. The payload that relates to the topic name. Integer type. The serial number of every single message received. Range: 0–4. BG95&BG77&BG600L_Series_MQTT_Application_Note 25 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 5 Examples This chapter gives some examples to explain how to use MQTT related AT commands. 5.1. Example of MQTT Operation without SSL AT+QMTCFG='aliauth',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAazZ' //Configure Alibaba device information for AliCloud. OK AT+QMTOPEN=? +QMTOPEN: (0-5),,(0-65535) OK AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 //Open a network for MQTT client. OK +QMTOPEN: 0,0 //Opened the MQTT client network successfully. AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK AT+QMTCONN=? +QMTCONN: (0-5),,, OK //Connect a client to MQTT server. //If AliCloud is connected, AT+QMTCFG='aliauth' can be used to configure the device information in advance, and there is no need to provide username/password here anymore. AT+QMTCONN=0,'clientExample' OK +QMTCONN: 0,0,0 //Connected the client to MQTT server successfully. AT+QMTSUB=? +QMTSUB: (0-5),(1-65535),,(0-2) OK BG95&BG77&BG600L_Series_MQTT_Application_Note 26 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note //Subscribe to topics. AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //If a client subscribes to a topic and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,0,'topic/example','This is the payload related to topic' //Unsubscribe from topics. AT+QMTUNS=0,1,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB : (0-5),(0-65535),(0-2),(0,1),,(1-4096) OK //Publish messages. AT+QMTPUB=0,0,0,0,'topic/pub' >This is test data, hello MQTT. OK //After receiving >, input data This is test data, hello MQTT. and then send it. The maximum length of the data is 4096 bytes and the data that beyond 4096 bytes will be omitted. After inputting data, tap Ctrl+Z to send. +QMTPUB: 0,0,0 //If a client subscribes to a topic named 'topic/pub' and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,0,'topic/pub','This is test data, hello MQTT.' AT+QMTDISC=0 //Disconnect a client from MQTT server. OK +QMTDISC: 0,0 //Connection closed successfully. BG95&BG77&BG600L_Series_MQTT_Application_Note 27 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 5.2. Example of MQTT Operation with SSL //Configure MQTT session into SSL mode. AT+QMTCFG='ssl',0,1,2 OK //If SSL authentication mode is intended to be set as 'manage server and client authentication if requested by the remote server' (=2 in AT+QSSLCFG), upload server root CA certificate, client certificate and client private key to UFS. AT+QFUPL='cacert.pem',1758,100 //Upload CA certificate to UFS. CONNECT +QFUPL: 1758,384a OK AT+QFUPL='client.pem',1220,100 //Upload client certificate to UFS. CONNECT +QFUPL: 1220,2d53 OK AT+QFUPL='user_key.pem',1679,100 //Upload client private key to UFS. CONNECT +QFUPL: 1679,335f OK //Configure the path of CA certificate for SSL context 2. AT+QSSLCFG='cacert',2,'cacert.pem' OK //Configure the path of client certificate for SSL context 2. AT+QSSLCFG='clientcert',2,'client.pem' OK //Configure the path of client private key for SSL context 2. AT+QSSLCFG='clientkey',2,'user_key.pem' OK //Configure the authentication mode for SSL context 2. AT+QSSLCFG='seclevel',2,2 //SSL authentication mode: server and client authentication BG95&BG77&BG600L_Series_MQTT_Application_Note 28 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note OK AT+QSSLCFG='sslversion',2,4 OK AT+QSSLCFG='ciphersuite',2,0XFFFF OK AT+QSSLCFG='ignorelocaltime',2,1 OK if requested by the remote server //SSL authentication version //Cipher suite //Ignore the time of authentication. //Start MQTT SSL connection AT+QMTOPEN=0,'a1zgnxur10j8ux.iot.us-east-1.amazonaws.com',8883 OK +QMTOPEN: 0,0 //Connect to MQTT server AT+QMTCONN=0,'MQTT-1' OK +QMTCONN: 0,0,0 //Subscribe to topics. AT+QMTSUB=0,1,'$aws/things/ MQTT-1/shadow/update/accepted',1 OK +QMTSUB: 0,1,0,1 //Publish messages. AT+QMTPUB=0,1,1,0,'$aws/things/MQTT-1/shadow/update/accepted' >This is publish data from client OK +QMTPUB: 0,1,0 //If a client subscribes to a topic named '$aws/things/MQTT-1/shadow/update/accepted' and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,1,'$aws/things/MQTT-1/shadow/update/accepted','This is publish data from client' //Disconnect a client from MQTT server. AT+QMTDISC=0 OK +QMTDISC: 0,0 BG95&BG77&BG600L_Series_MQTT_Application_Note 29 / 30 LPWA Module Series BG95&BG77&BG600L Series MQTT Application Note 6 Appendix A References Table 3: Related Documents SN Document Name [1] MQTT V3.1 Protocol Specification [2] MQTT V3.1.1 Protocol Specification Remarks MQTT protocol specification version 3.1 MQTT protocol specification version 3.1.1 Table 4: Terms and Abbreviations Abbreviation ACK CA LPWA MQTT QoS RAM SSL TCP URC Description Acknowledgement Certificate Authority Low Power Wide Area Message Queuing Telemetry Transport Quality of Service Random Access Memory Secure Sockets Layer Transmission Control Protocol Unsolicited Result Code BG95&BG77&BG600L_Series_MQTT_Application_Note 30 / 30

BG95&BG77&BG600L Series DFOTA Application Note LPWA Module Series Version: 1.2 Date: 2022-04-01 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_DFOTA_Application_Note 1 / 40 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Series_DFOTA_Application_Note 2 / 40 LPWA Module Series About the Document Revision History Version 1.0 1.1 1.2 Date 2020-01-15 2020-07-29 2022-04-01 Author Description Matt YE/ Lane HAO Matt YE Billie XING/ Matt YE/ Adonis CHEN Initial 1. Added the applicable module BG600L-M3. 2. Added supported baud rates for reporting of DFOTA URCs and develop the main UART baud rate to follow the configuration by AT+IPR. 3. Updated the range of the parameter for delta package. 1. Added parameters and in AT+QFOTADL=. 2. Added AT+QFOTADL=. 3. Updated the note about in AT+QFOTAD L='COM:',,. 4. Added for AT+QFOTADL=,, . 5. Added AT+QFOTADL=,. 6. Added AT+QCFGEXT='fota_http_header'. 7. Added AT+QCFGEXT='fota_wd_gpio'. 8. Added AT+QCFGEXT='sni'. 9. Added some examples to illustrate the use of new commands. 10. Completed the list of error codes. BG95&BG77&BG600L_Series_DFOTA_Application_Note 3 / 40 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 Introduction ......................................................................................................................................... 8 2 Trigger DFOTA by AT Commands .................................................................................................... 9 2.1. Firmware Update Procedure...................................................................................................... 9 2.1.1. Get a Delta Firmware Package ..................................................................................... 10 2.1.2. Put Delta Package on the HTTP(S)/CoAP(S)/FTP(S) Server ...................................... 10 2.1.3. Check APN Setting and Network Status ....................................................................... 10 2.1.4. Execute AT Command to Update the Firmware ............................................................11 2.2. DFOTA Related AT Commands ................................................................................................11 2.2.1. AT Command Introduction .............................................................................................11 2.2.1.1. Definitions...............................................................................................................11 2.2.1.2. AT Command Syntax..............................................................................................11 2.2.2. Declaration of AT Command Examples ........................................................................ 12 2.2.3. Description of AT Command Mode and Data Mode ..................................................... 12 2.2.4. AT+QFOTADL Update Firmware via DFOTA ............................................................. 12 2.2.4.1. AT+QFOTADL= Update Firmware When Delta Package is Stored on HTTP(S) Server................................................................................................ 13 2.2.4.2. AT+QFOTADL= Update Firmware When Delta Package is Stored on CoAP(S) Server................................................................................................ 15 2.2.4.3. AT+QFOTADL= Update Firmware When Delta Package is Stored on FTP(S) Server .................................................................................................. 16 2.2.4.4. AT+QFOTADL='COM:',, Upload a Delta Package to Flash18 2.2.4.5. AT+QFOTADL=[,[,]] Extended DFOTA Configurations19 2.2.4.6. AT+QFOTADL=, Copy Delta Package to Flash from File System................................................................................................................... 22 2.2.5. AT+QCFGEXT='fota_apn' Configure IP Family and APN for DFOTA ...................... 23 2.2.6. AT+QCFGEXT='fota_http_header' Configure HTTP(S) Header for DFOTA over HTTP(S) ........................................................................................................................ 24 2.2.7. AT+QCFGEXT='fota_wd_gpio' Configure Watchdog Pin and Feeding Interval During DFOTA........................................................................................................................... 24 2.2.8. AT+QCFGEXT='sni' Configure Whether to Enable Server Name Indication for DFOTA........................................................................................................................... 26 2.3. Example ................................................................................................................................... 26 2.3.1. Update Firmware from HTTP(S) Server by DFOTA ..................................................... 26 2.3.2. Update Firmware from FTP(S) Server by DFOTA ........................................................ 27 2.3.3. Copy Delta Package to NAND Flash from AP EUFS ................................................... 28 2.3.4. Set Breakpoint Continuous Downloading and Single Request Size for HTTP(S) DFOTA BG95&BG77&BG600L_Series_DFOTA_Application_Note 4 / 40 LPWA Module Series 2.3.5. 2.3.6. Downloading.................................................................................................................. 28 Configure HTTP(S) Header for DFOTA over HTTP(S) ................................................. 29 Set Watchdog Configuration for DFOTA....................................................................... 29 3 Trigger DFOTA with LwM2M ............................................................................................................ 31 3.1. Firmware Update Procedure.................................................................................................... 31 3.1.1. Download a Firmware Image ........................................................................................ 32 3.1.2. Update the Firmware..................................................................................................... 33 3.2. URC of Firmware Update with LwM2M ................................................................................... 34 3.2.1. Download Progress URCs ............................................................................................ 34 3.2.1.1. In-Band Mode ........................................................................................................ 34 3.2.1.2. Out-of-Band HTTP(S) Mode.................................................................................. 34 3.2.1.3. Out-of-Band CoAP(S) Mode.................................................................................. 35 3.2.2. Update Progress URCs................................................................................................. 36 3.2.2.1. +QIND: 'FOTA','START' Updating Started........................................................ 36 3.2.2.2. +QIND: 'FOTA','UPDATING', Updating Progress ............................ 36 3.2.2.3. +QIND: 'FOTA','END', Updating Finished................................................ 36 4 Summary of Error Codes ................................................................................................................. 37 5 Appendix A References.................................................................................................................... 39 BG95&BG77&BG600L_Series_DFOTA_Application_Note 5 / 40 LPWA Module Series Table Index Table 1: Types of AT Commands ................................................................................................................11 Table 2: Summary of // Codes.......................................................... 37 Table 3: Summary of Codes ................................................................................................ 38 Table 4: Summary of Codes ............................................................................................................. 38 Table 5: Related Documents ...................................................................................................................... 39 Table 6: Terms and Abbreviations .............................................................................................................. 39 BG95&BG77&BG600L_Series_DFOTA_Application_Note 6 / 40 LPWA Module Series Figure Index Figure 1: DFOTA Procedure (Triggered by AT Command) .......................................................................... 9 Figure 2: LwM2M Firmware Image Download ........................................................................................... 32 Figure 3: Call Flow of Package URI Observing and Firmware Downloading............................................ 33 Figure 4: Call Flow of 'Update' Resource Observing and Update Event Processing............................... 34 BG95&BG77&BG600L_Series_DFOTA_Application_Note 7 / 40 LPWA Module Series 1 Introduction Quectel BG95 series, BG77 and BG600L-M3 modules support DFOTA (Delta Firmware Upgrade Over-The-Air) feature, which allows users to update firmware wirelessly. In DFOTA, a delta firmware package, which contains only differences between the current and the target update versions, is needed before firmware updating. Therefore, DFOTA is time-saving and can reduce unnecessary data transmission. This document mainly introduces how to update the firmware of Quectel BG95 series, BG77 and BG600L-M3 modules via DFOTA, which can be triggered either by AT+QFOTADL or via LwM2M. NOTE 1. It is mandatory to ensure a stable supply voltage during DFOTA process. 2. If there is an external watchdog monitoring the module, the DAM cannot run during DFOTA process, and the watchdog cannot be fed in the DAM app. In this case, it is necessary to remove the watchdog temporarily or feed it through AP kernel (see Chapter 2.3.6 for details) to prevent unexpected restart behaviors that may interrupt the DFOTA process or cause possible damages to the module. BG95&BG77&BG600L_Series_DFOTA_Application_Note 8 / 40 LPWA Module Series 2 Trigger DFOTA by AT Commands 2.1. Firmware Update Procedure The following chart illustrates the DFOTA procedure triggered by the AT command, provided that the firmware package is stored on an HTTP(S)/CoAP(S)/FTP(S) server. 2. Put the package on HTTP(S)/CoAP(S)/FTP(S) Server HTTP(S)/CoAP(S)/ FTP(S) Server 1. Get a delta firmware package LTE/EGPRS (HTTP(S)/CoAP(S)/ FTP(S)) 5. Automatically download from HTTP(S)/CoAP(S)/FTP(S) server via LTE/EGPRS network Ext. MCU 3. Check APN setting and network status 4. Execute AT+QFOTADL Quectel Module 6. Automatically update the module’s firmware Figure 1: DFOTA Procedure (Triggered by AT Command) BG95&BG77&BG600L_Series_DFOTA_Application_Note 9 / 40 LPWA Module Series As shown in the above figure, the following steps need to be performed to update the firmware when the firmware package is stored on an HTTP(S)/CoAP(S)/FTP(S) server: Step 1: Get a delta firmware package from Quectel. Step 2: Put the delta package on the HTTP(S)/CoAP(S)/FTP(S) server. Step 3: Check APN setting and network status. Step 4: Execute AT+QFOTADL. The package will be downloaded to the module from the HTTP(S)/CoAP(S)/FTP(S) server via LTE/EGPRS network (Step 5 in the figure above). Then, the firmware of the module is updated automatically (Step 6 in the figure above). 2.1.1. Get a Delta Firmware Package Before updating, check the current firmware version with AT+QGMR and select a target firmware version, and then send the two firmware versions to Quectel or module supplier to get a delta package. 2.1.2. Put Delta Package on the HTTP(S)/CoAP(S)/FTP(S) Server Step 1: Set up the HTTP(S)/CoAP(S)/FTP(S) server before using the DFOTA function (Quectel does not provide such servers.) Step 2: Put the delta firmware package on the server and record its storage path. Step 3: The module downloads the delta package using the URL path of the file uploaded on the server after executing the corresponding AT command. 2.1.3. Check APN Setting and Network Status Step 1: Check APN setting: check whether the APN is set properly after putting the delta firmware package on the HTTP(S)/CoAP(S)/FTP(S) server. For instance, the APN for a Telstra (U)SIM card should be 'Telstra.internet'. The relevant AT commands are listed below: ⚫ AT+QCFGEXT='fota_apn': Query DFOTA APN ⚫ AT+QCFGEXT='fota_apn',0,'Telstra.internet': Set DFOTA APN Step 2: Check network status: after the APN setting is confirmed, make sure that the data network is registered before firmware updating. The relevant AT commands are listed below: ⚫ AT+CSQ: Query signal quality ⚫ AT+CEREG?: Query network registration status (Optional: AT+CGREG?) ⚫ AT+COPS?: Query the registered operator For more details about the above commands, see document [1]. BG95&BG77&BG600L_Series_DFOTA_Application_Note 10 / 40 LPWA Module Series 2.1.4. Execute AT Command to Update the Firmware After checking the APN setting and network status, execute AT+QFOTADL to download the delta firmware package to the module from the HTTP(S)/CoAP(S)/FTP(S) server via LTE/EGPRS network. Then, the firmware will be updated automatically. For an example, see Chapter 2.3. 2.2. DFOTA Related AT Commands 2.2.1. AT Command Introduction 2.2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 1: Types of AT Commands Command Type Test Command Read Command Write Command Syntax Description AT+=? AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. AT+=[,[,[...]]] Set user-definable parameter value. BG95&BG77&BG600L_Series_DFOTA_Application_Note 11 / 40 Execution Command AT+ LPWA Module Series Return a specific information parameter or perform a specific action. 2.2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 2.2.3. Description of AT Command Mode and Data Mode The COM port of BG95 series, BG77 and BG600L-M3 modules provide two working modes: AT command mode and data mode. In the AT command mode, the inputted data via COM port are treated as AT commands. In data mode, they are treated as data. Inputting +++ or pulling up MAIN_DTR (AT&D1 should be set first) can make the COM port exit data mode. To prevent +++ from being misinterpreted as data, the following sequence should be followed: 1. Do not input any character for at least 1 second before and after inputting +++. 2. Input +++ within 1 second, and wait until OK is returned. After executing AT+QFOTADL='COM:',,, the COM port enters the data mode. The port exits the data mode forcibly and the command is interrupted immediately if +++ is inputted or if MAIN_DTR is pulled up before the command response is returned. 2.2.4. AT+QFOTADL Update Firmware via DFOTA AT+QFOTADL Update Firmware via DFOTA Test Command AT+QFOTADL=? Response OK AT+QFOTADL initiates automatic module firmware updating via DFOTA. Once AT+QFOTADL is executed, the delta firmware package is automatically downloaded to the module. After downloading the delta package, the module automatically updates the firmware. The module reboots automatically if the firmware has been updated successfully, otherwise it returns an error message and exits DFOTA. BG95&BG77&BG600L_Series_DFOTA_Application_Note 12 / 40 LPWA Module Series 2.2.4.1. AT+QFOTADL= Update Firmware When Delta Package is Stored on HTTP(S) Server When the delta firmware package is stored on an HTTP(S) server, execute AT+QFOTADL=[,[,]] to start automatic firmware updating via DFOTA. The module downloads the delta package from the HTTP(S) server over the air and updates the firmware automatically. With and , this command allows the module to download the entire delta package in separate segments. specifies where to continue the download if a segmented download was implemented. When is specified, the size of delta package to be downloaded can be configured with . AT+QFOTADL= Update Firmware When Delta Package is Stored on HTTP(S) Server Write Command Response AT+QFOTADL=[,[,]] OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','RESETTING' +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', If any of the optional parameters is specified, set the breakpoint position and request size: OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','HTTPEND', When =0 (which indicates the entire delta package has been downloaded successfully), the module BG95&BG77&BG600L_Series_DFOTA_Application_Note 13 / 40 LPWA Module Series Maximum Response Time Characteristics automatically reboots and starts firmware updating: +QIND: 'FOTA','RESETTING' +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', If there is any error: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter String type. The maximum length is 700 bytes. It should be started with 'HTTP://' or 'HTTPS://'. For example: 'HTTP://:/'. Integer type. The offset location of the delta package. Default value: 0. Unit: byte. Integer type. Size of the delta package to be downloaded for this downloading request. It must be an integer multiple of 2048. Unit: byte. The default value 0 indicates downloading all remained bytes. String type. The IP address or domain name of the HTTP(S) server. Integer type. The port number of the HTTP(S) server. Default value: 80. Range: 1–65535. String type. File path on HTTP(S) server. Integer type. HTTP(S) result code. 0 Updated successfully. Any other value Errors. See Chapter 4 for more details. Integer type. The download or update progress in percentage. Integer type. Update result code. 0 Updated successfully. Any other value Errors. See Chapter 4 for more details. Error codes. See Chapter 4 for more details. NOTE 1. In the DFOTA mode, only the APP works normally and the modem is not loaded. In this period, the main UART cannot receive AT commands anymore, and can only report DFOTA URCs at the baud rate configured by AT+IPR. Supported baud rates for the reporting of URCs are 4800, 9600, 19200, BG95&BG77&BG600L_Series_DFOTA_Application_Note 14 / 40 LPWA Module Series 38400, 115200, 230400, 460800 and 921600 bps. The default baud rate 115200 bps is used if any unsupported baud rate is set by AT+IPR for the URC reporting. Additionally, the USB port cannot be used either. 2. After a smooth 'DOWNLOADING' process, the module is reset to enter the DFOTA mode. When the 'UPDATING' process is finished, the module restarts and start up in a normal mode. 3. If the module is powered down during 'UPDATING' process, the module will automatically enter the DFOTA mode and continue the previous firmware update when it is powered up next time. 4. (1) If SSL certificates are needed while downloading the firmware package from an HTTPS server, they should be uploaded to /datatx in APP EFS, and must be renamed in accordance with the following rules: 1) The root certificate is renamed fota_cacert.pem; 2) The client certificate is renamed fota_client_cert.pem; 3) The private key is renamed fota_client_key.pem. (2) Certificate upload methods: ⚫ Quectel QEFS Explorer tool can be used to upload the certificates. For more details about the tool, refer to document [2]. ⚫ AT+QFUPL can also be used to upload the certificates. For more details about the command, see document [3]. 2.2.4.2. AT+QFOTADL= Update Firmware When Delta Package is Stored on CoAP(S) Server When the delta firmware package is stored on a CoAP(S) server, execute AT+QFOTADL= to start automatic firmware updating via DFOTA. The module downloads the delta package from the CoAP(S) server over the air and updates the firmware automatically. AT+QFOTADL= CoAP(S) Server Write Command AT+QFOTADL= Update Firmware When Delta Package is Stored on Response OK +QIND: 'FOTA','COAPSTART' +QIND: 'FOTA','COAPEND', +QIND: 'FOTA',' RESETTING' +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', If there is any error: +CME ERROR: BG95&BG77&BG600L_Series_DFOTA_Application_Note 15 / 40 LPWA Module Series Maximum Response Time Characteristics 300 ms The command takes effect immediately. Parameter String type. The maximum length is 700 bytes. It should be started with 'CoAP://' or 'CoAPS://', for example: 'CoAP://:< CoAP_port>/< CoAP_file_path>'. String type. The IP address or domain name of the CoAP(S) server. Integer type. The port number of the CoAP(S) server. Default value: 80. Range: 1–65535. String type. File path on CoAP(S) server. Integer type. CoAP(S) result code. 0 Updated successfully. Any other value Errors. See Chapter 4 for more details. Integer type. The update progress in percentage. Integer type. Update result code. 0 Updated successfully. Any other value Errors. See Chapter 4 for more details. Error codes. See Chapter 4 for more details. NOTE The modules support two security modes for CoAP over DTLS: certificate mode and pre-shared key (PSK) mode. ⚫ In certificate mode, certificates are necessary for downloading the delta package from the CoAPS server. They should be uploaded to /datatx/ssl in APP EFS, and must be renamed in accordance with the following rules: 1) The root certificate is renamed as coap-cert.pem; 2) The client certificate is renamed as coap-cacert.pem; 3) The private key is renamed as coap-key.pem. ⚫ In PSK mode, the PSK is required by server. The PSK key file should be renamed to coap_fota.psk a nd uploaded into the /datatx/ssl folder. 2.2.4.3. AT+QFOTADL= Update Firmware When Delta Package is Stored on FTP(S) Server When the delta firmware package is stored on an FTP(S) server, execute AT+QFOTADL= to start automatic firmware updating via DFOTA. The module downloads the delta package from the FTP(s) server over the air and updates the firmware automatically. BG95&BG77&BG600L_Series_DFOTA_Application_Note 16 / 40 LPWA Module Series AT+QFOTADL= FTP(S) Server Write Command AT+QFOTADL= Update Firmware When Delta Package is Stored on Response OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','RESETTING' +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', Maximum Response Time Characteristics If there is any error: +CME ERROR: 300 ms This command takes effect immediately. The configuration will not be saved. Parameter String type. The maximum length is 700 bytes. It should be started with 'FTP://' or 'FTPS://', for example: 'FTP://:@:/'. String type. The username for FTP(S) server login. String type. The password of FTP(S) server login. String type. The IP address or domain name of FTP(S) server. Integer type. The port number of FTP(S) server. Default value: 21. Range: 1–65535. String type. File path on FTP(S) server. Integer type. FTP(S) result code. 0 Updated successfully. Any other value Errors. Refer to Chapter 4 for more details. Integer type. The download or update progress in percentage. Integer type. Update result code. 0 Updated successfully. Any other value Errors. See Chapter 4 for more details. BG95&BG77&BG600L_Series_DFOTA_Application_Note 17 / 40 Error codes. See Chapter 4 for more details. LPWA Module Series NOTE 1. If SSL certificates are needed while downloading the firmware package from an FTPS server, they should be uploaded to /datatx in APP EFS, and must be renamed in accordance with the following rules: 1) The root certificate must be renamed ftp_fota_cacert.pem; 2) The client certificate must be renamed ftp_fota_client_cert.pem; 3) The private key must be renamed ftp_fota_client_key.pem. 2. Certificate upload methods: ⚫ Quectel QEFS Explorer tool can be used to upload the certificates. For more details about the tool, see document [2]. ⚫ AT+QFUPL can also be used to upload the certificates. For more details about the command, see document [3]. 2.2.4.4. AT+QFOTADL='COM:',, Upload a Delta Package to Flash This command uploads a delta package to the NAND flash. If a delta package already exists in the NAND flash, it will be overwritten when a new package is uploaded. After this command is executed and CONNECT is returned, the module switches to the data mode. When the uploaded data reaches , or if no data are inputted when is reached, the module exits the data mode automatically. During data transmission, inputting +++ or pulling up MAIN_DTR can make the module exit the data mode. More information about the data mode is provided in Chapter 2.2.3. AT+QFOTADL='COM:',, Upload a Delta Package to Flash Write Command AT+QFOTADL='COM:',[,] Response CONNECT TA switches to the data mode (transparent transmission mode), and the delta package in the binary form can be inputted. When the total size of the inputted data reaches , TA returns to the command mode and provides the following response: +QFOTADL: , OK If there is any error: +CME ERROR: BG95&BG77&BG600L_Series_DFOTA_Application_Note 18 / 40 LPWA Module Series Maximum Response Time Characteristics 300 ms The command takes effect immediately. Parameter Integer type. The file size expected to be uploaded. Unit: byte. Integer type. The time waiting for data to be inputted to USB/UART. Default value: 5. Unit: second. Integer type. The file size that has been uploaded. Unit: byte. The checksum of the uploaded data. Error code. See Chapter 4 for more details. NOTE 1. is limited by the flash space for storing the delta firmware package. Since the flash for storing the delta package is also used for storing DFOTA algorithm, may vary with firmware versions. The maximum flash space for storing DFOTA package is calculated automatically by the module, and you can query it with AT+QFOTADL=12 (see Chapter 2.2.4.5 for details). 2. is a 16-bit checksum based on bitwise Exclusive-OR (XOR). When the inputted data is odd byte size, the XOR operator sets the last inputted byte as the upper 8 bits, and sets the lower 8 bits as 0. The checksum verifies if the data have been uploaded correctly. 3. +++ sequence causes TA to end the command and switch to the command mode. However, the data previously uploaded are preserved into the file. 4. When executing the command, the data must be entered after CONNECT is returned. 2.2.4.5. AT+QFOTADL=[,[,]] Extended DFOTA Configurations This command supports several extended configurations through different parameters, such as triggering firmware updating with a local delta firmware package, getting delta firmware package information, and deleting a delta firmware package. AT+QFOTADL=[,[,]] Extended DFOTA Configurations Read Command AT+QFOTADL? Response +QFOTADL: OK If is 3, return the size of the delta package that has been downloaded in DFOTA process: +QFOTADL: 3, BG95&BG77&BG600L_Series_DFOTA_Application_Note 19 / 40 LPWA Module Series Write Command AT+QFOTADL=[,[,]] OK Response If =1, start DFOTA updating: OK If =3, and both and are omitted, return the current DFOTA updating trigger mode: +QFOTADL: 3, OK If =3, and is specified, set DFOTA updating trigger mode: OK If =4, and both and are omitted, return the size of local delta package: +QFOTADL: 4, OK If =5, and both and are omitted, delete the local delta package: OK If =8, and both and are omitted, query retry count and intervals: +QFOTADL: 8,, OK If =8, and both and are specified, set retry count and intervals: OK If =10, is specified and is omitted, download files to EUFS file system from HTTP(S) server and the downloaded-file path will be /datatx/update.zip. OK If =10, and both and are specified, download files to EUFS file system from HTTP(S) server and the downloaded-file path is specified by . BG95&BG77&BG600L_Series_DFOTA_Application_Note 20 / 40 LPWA Module Series Maximum Response Time Characteristics OK If =12, and both and are omitted, return the maximum flash size for storing delta package. +QFOTADL: 12, OK If there is any error: +CME ERROR: If there is any other error: ERROR 10 s The command takes effect immediately. The configuration will not be saved. Parameter Integer type. 1 Start DFOTA updating 2 Reserved 3 Configure whether to trigger DFOTA updating immediately after delta package is downloaded from HTTP(S) server 4 Get the size of local delta package 5 Delete the local delta package 6 Cancel the current delta package downloading 7 Reserved 8 Configure retry count and intervals when the connection breaks down 9 Reserved 10 Download files from HTTP(S) server and save them into EUFS file system 11 Reserved 12 Get the maximum flash size for storing delta package When =3: species the DFOTA updating trigger mode: 0 Trigger DFOTA updating with AT+QFOTADL=1. 1 Trigger DFOTA updating automatically when the package is downloaded. When =4: is only available in the command response, and it represents the size of local delta package in integer type. Unit: byte. If =8: is used to query/configure retry count. Range:1–2147483647. If =10: BG95&BG77&BG600L_Series_DFOTA_Application_Note 21 / 40 LPWA Module Series represents the URL address of file stored on the HTTP(S) server. If =12: represents the maximum flash size for storing delta package. Unit: byte. In other cases, is omitted. If =8: represents the time interval between two retries. Unit: second. if =10: represents the local file path for saving the downloaded file. In other cases, is omitted. Integer type. Delta package downloading state. 0 Downloading not started 1 Downloading 2 Downloaded 3 Downloading failure Integer type. Size of the current delta package that has been downloaded in DFOTA process. Unit: byte. Error code. See Chapter 4 for more details. 2.2.4.6. AT+QFOTADL=, Copy Delta Package to Flash from File System This command copies the delta package to the NAND flash from Modem or AP file system. If the delta package has existed on the NAND flash, it will be overwritten by the latest package. AT+QFOTADL=, Copy Delta Package to Flash from File System Write Command AT+QFOTADL=, Response OK Maximum Response Time Characteristics If there is any error: +CME ERROR: / The command takes effect immediately. Parameter String type. Name of the file to be copied. The maximum length is 128 bytes. 'UFS:' Modem UFS file 'EUFS:' AP EUFS file above indicates the exact name of the file in Modem or AP UFS. Integer type. The type of file to be copied to NAND flash. 0 The first file to be copied to NAND flash 1 The intermediate file(s) to be copied to NAND flash BG95&BG77&BG600L_Series_DFOTA_Application_Note 22 / 40 2 The last file to be copied to NAND flash Error Codes. See Chapter 4 for more details. LPWA Module Series NOTE 1. UFS is a User File Storage directory on modem side. It is a special directory on the flash file system. EUFS is an Extended User File Storage on application side. 2. If there is only one file in AP EUFS/Modem UFS, specify as 2. 2.2.5. AT+QCFGEXT='fota_apn' Configure IP Family and APN for DFOTA This command configures the IP family and APN for DFOTA or queries the current setting. AT+QCFGEXT='fota_apn' Configure IP Family and APN for DFOTA Write Command AT+QCFGEXT='fota_apn',[,< apn>[,,]] Response If the optional parameters are omitted, query the current setting. +QCFGEXT: 'fota_apn',,[,,] OK If any of the optional parameters is specified, set the IP family and APN for DFOTA. OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. IP family. 0 IPv4 address family 1 IPv6 address family 2 IPv4 and IPv6 address family String type. Access point name. String type. Username of the selected APN. String type. Password of the selected APN. BG95&BG77&BG600L_Series_DFOTA_Application_Note 23 / 40 LPWA Module Series 2.2.6. AT+QCFGEXT='fota_http_header' Configure HTTP(S) Header for DFOTA over HTTP(S) This command configures HTTP(S) header for DFOTA over HTTP(S). AT+QCFGEXT='fota_http_header' Configure HTTP(S) Header for DFOTA over HTTP(S) Write Command Response AT+QCFGEXT='fota_http_header' If the optional parameters are omitted, query the current setting. [,,] +QCFGEXT: 'fota_http_header'[,key: value:] OK If the optional parameters are specified, configure HTTP(S) header for DFOTA over HTTP(S). OK Maximum Response Time Characteristics If there is any error: +CME ERROR: 300 ms The command takes effect immediately. The configurations will not be saved. Parameter String type. Key of HTTP(S) header. String type. Value of HTTP(S) header. Error codes. Refer to Chapter 4 for more details. NOTE 1. The maximum number of HTTP(S) header is 5. 2. When is specified while is empty, this command deletes this key-value pair. 3. In the response of AT+QCFGEXT='fota_http_header', and are strings without double quotation marks. 2.2.7. AT+QCFGEXT='fota_wd_gpio' Configure Watchdog Pin and Feeding Interval During DFOTA As the DAM cannot run during DFOTA process, you cannot feed the watchdog in the DAM app if an external watchdog is used to monitor the module. In this case, the module may be reset by the external BG95&BG77&BG600L_Series_DFOTA_Application_Note 24 / 40 LPWA Module Series watchdog because of watchdog timeout. In order to avoid this, Quectel implements a feature to feed the watchdog automatically in AP kernel during DFOTA. This command enables or disables the external watchdog feeding, and configures watchdog pins and the watchdog feeding interval during DFOTA. AT+QCFGEXT='fota_wd_gpio' Configure Watchdog Pin and Feeding Interval During DFOTA Write Command Response AT+QCFGEXT='fota_wd_gpio'[,[,,]] setting: +QCFGEXT: 'fota_wd_gpio',[,,] OK If the optional parameters are specified, configure the watchdog pin and the feeding interval during DFOTA OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Enable/disable watchdog during DFOTA. 0 Disable 1 Enable Integer type. Pin number for watchdog. BG95 series supports the pin numbers below: 4–7, 18, 19, 22, 23, 25–28, 40, 41, 64–66, 85–88. BG600L-M3 supports the pin numbers below: 9–12, 22, 23, 29, 30, 53, 54, 57–62. BG77 supports the pin numbers below: 1–5, 8, 9, 33–37, 40, 41, 48–51, 57, 60, 61, 63, 67–71, 77, 80–82, 90, 91, 93. Integer type. The interval to feed the watchdog. The period of square wave is 2 × . Unit: millisecond. Range: 100–3600000. Error codes. See Chapter 4 for more details. BG95&BG77&BG600L_Series_DFOTA_Application_Note 25 / 40 LPWA Module Series 2.2.8. AT+QCFGEXT='sni' Configure Whether to Enable Server Name Indication for DFOTA AT+QCFGEXT='sni' Configure Whether to Enable Server Name Indication for DFOTA Write Command Response AT+QCFGEXT='sni'[,] If the optional parameter is omitted, query the current setting: +QCFGEXT: 'sni', OK If the optional parameter is specified, configure whether to enable server name indication for DFOTA: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Whether to enable server name indication. 0 Disable 1 Enable 2.3. Example 2.3.1. Update Firmware from HTTP(S) Server by DFOTA //The delta firmware package has already been stored on an HTTP(S) server. The server address is 'https://www.quectel.com:100/update.zip'. AT+CSQ;+CEREG?;+CGREG?;+COPS? //Query network status. +CSQ: 26,99 +CEREG: 0,1 +CGREG: 0,4 BG95&BG77&BG600L_Series_DFOTA_Application_Note 26 / 40 LPWA Module Series +COPS: 0,0,'Telstra Mobile Telstra',8 OK //Execute AT+QFOTADL command to enable automatic firmware update via DFOTA, and then the module starts to download the delta package and update firmware automatically. AT+QFOTADL='https://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING',5% … +QIND: 'FOTA','HTTPEND',0 //Finish downloading the package from the server. +QIND: 'FOTA','RESETTING' //The module is reset and then enters DFOTA mode. +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',2% ... +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 //Finish updating the firmware. 2.3.2. Update Firmware from FTP(S) Server by DFOTA //Update firmware when delta firmware package is stored on an FTP(S) server. The server address is 'ftp://test:test@220.180.239.212:8309/TEST1/upgrade.bin'. Execute AT+QFOTADL to enable automatic firmware updating via DFOTA, and then the module will download the delta package and update firmware automatically. AT+QFOTADL='ftp://test:test@220.180.239.212:8309/TEST1/upgrade.bin' OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','DOWNLOADING',5% +QIND: 'FOTA','DOWNLOADING',10% +QIND: 'FOTA','DOWNLOADING',15% +QIND: 'FOTA','DOWNLOADING',20% … +QIND: 'FOTA','DOWNLOADING',95% +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','FTPEND',0 //Finish the package downloading from the server. +QIND: 'FOTA','RESETTING' //The module resets and then enters DFOTA mode. +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',4% … +QIND: 'FOTA','UPDATING',99% +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 //Finish the firmware update. BG95&BG77&BG600L_Series_DFOTA_Application_Note 27 / 40 LPWA Module Series 2.3.3. Copy Delta Package to NAND Flash from AP EUFS //Assume that the delta package is divided the into four parts: update1.bin, update2.bin, update3.bin and update4.bin. Then, download the four packages to AP EUFS. AT+QFOTADL='EUFS:update1.bin',0 OK AT+QFOTADL='EUFS:update2.bin',1 OK AT+QFOTADL='EUFS:update3.bin',1 OK AT+QFOTADL='EUFS:update4.bin',2 OK //Copy update1.bin to NAND flash. //Copy update2.bin to NAND flash. //Copy update3.bin to NAND flash. //Copy update4.bin to NAND flash. 2.3.4. Set Breakpoint Continuous Downloading and Single Request Size for HTTP(S) DFOTA Downloading //Update firmware when delta firmware package is stored on HTTP(S) server. The server address is 'https://www.quectel.com:100/update.zip'. AT+CSQ;+CEREG?;+CGREG?;+COPS? //Query network status +CSQ: 26,99 +CEREG: 0,1 +CGREG: 0,4 +COPS: 0,0,'Telstra Mobile Telstra',8 OK //Enable automatic firmware updating via DFOTA. AT+QFOTADL=3,1 OK //Set breakpoint continuous downloading and the request size. AT+QFOTADL='https://www.quectel.com:100/update.zip',0,10240 //Download the first 10240 bytes of the delta package. OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING',5% … +QIND: 'FOTA','HTTPEND',712 //Finished downloading of the segmented delta package from the server. AT+QFOTADL? //Query the size of the segmented delta package that has been downloaded in DFOTA process. BG95&BG77&BG600L_Series_DFOTA_Application_Note 28 / 40 LPWA Module Series +QFOTADL: 3,10240 OK //Set the breakpoint position to 10240 and the request size to 0 (i.e., download the package from the breakpoint until the entire package is downloaded completely). AT+QFOTADL='https://www.quectel.com:100/update.zip',10240 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING',10% … +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 +QIND: 'FOTA','RESETTING' //The module resets and enters DFOTA mode automatically. +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',2% ... +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 //Finish firmware updating. 2.3.5. Configure HTTP(S) Header for DFOTA over HTTP(S) //Set the user-defined HTTP(S) header configuration. AT+QCFGEXT='fota_http_header','Auth','test' OK //Query the user-defined HTTP(S) header configuration. AT+QCFGEXT='fota_http_header' +QCFGEXT: key:Auth value:test OK //Delete this key-value pair. AT+QCFGEXT='fota_http_header','Auth','' OK 2.3.6. Set Watchdog Configuration for DFOTA //Set the watchdog configuration for BG95 series. AT+QCFGEXT='fota_wd_gpio',1,6,3000 //Enable the watchdog, set pin 6 as the pin for watchdog and feed the watchdog at an interval of 3000 milliseconds. OK AT+QCFGEXT='fota_wd_gpio' //Query the current watchdog configuration. +QCFGEXT: 'fota_wd_gpio',1,6,3000 BG95&BG77&BG600L_Series_DFOTA_Application_Note 29 / 40 OK AT+QCFGEXT='fota_wd_gpio',0 OK //Disable watchdog. LPWA Module Series BG95&BG77&BG600L_Series_DFOTA_Application_Note 30 / 40 LPWA Module Series 3 Trigger DFOTA with LwM2M 3.1. Firmware Update Procedure OMA defines the application layer communication protocol between a LwM2M server and a LwM2M client, which is located in a LwM2M device. For the modules, the LwM2M protocol is used to manage device provisioning and is a trigger of a DFOTA procedure. For the DFOTA update on the modules, a firmware update object is provided by the LwM2M specification. The following are the routine DFOTA steps with LwM2M: 1. Write 'Package'/'Package URI' to trigger the downloading of a firmware image, so that the DFOTA application downloads the firmware image from LwM2M server automatically. 2. Post 'Update' to trigger firmware update on the modules, so that the DFOTA application finishes firmware update automatically with the candidate firmware image. The LwM2M client is notified about the new firmware by the LwM2M server using CoAP(S). The client sends indication to a registered DFOTA application. The DFOTA application downloads the firmware delta package from the server and stores it on the file system of BG95 series, BG77 and BG600L-M3 modules. The following figure shows key components involved in the LwM2M DFOTA process on the modules. BG95&BG77&BG600L_Series_DFOTA_Application_Note 31 / 40 LPWA Module Series LwM2M and DFOTA Servers CoAP(S) HTTP(S)/CoAP(S) ThreadX LwM2M Client Firmware Update Object Boot Loader (SBL) Loads image based on Cookie Clear Cookie Boot Result DFOTA Application Download Image Set DFOTA Cookie Request Reboot Get Boot Result Security Authenticates Image FLASH File System Boot Partition DFOTA Partition DFOTA Cookie Figure 2: LwM2M Firmware Image Download 3.1.1. Download a Firmware Image About 'Firmware Update Object' in LwM2M, the detailed interaction process between LwM2M client and BG95&BG77&BG600L_Series_DFOTA_Application_Note 32 / 40 LPWA Module Series LwM2M server is described as below. The LwM2M client should register and observe the 'Package URI' resource in the Firmware Update Object, which is shown in the server when the client is registered successfully. LwM2M Client DFOTA Application Write Package/Package URI Register to get Firmware object Update In-Band Download Package (CoAP(S)) Send Firmware Image FLASH Out-of-Band Send Package URI Set Download State Download Package (HTTP(S)/CoAP(S)) Write to DFOTA Partition Figure 3: Call Flow of Package URI Observing and Firmware Downloading NOTE In the in-band mode, the module downloads a firmware package from the LwM2M server directly via the CoAP(S) protocol and sends the downloaded package to the DFOTA application. All 'firmware update' actions are done in the application. But in the out-of-band mode, the module downloads a firmware package from the HTTP(S)/CoAP(S) server to the module. 3.1.2. Update the Firmware The LwM2M server should observe the 'State' resource in the Firmware Update Object. If the 'State' has BG95&BG77&BG600L_Series_DFOTA_Application_Note 33 / 40 LPWA Module Series changed to 'Downloaded', 'Update' resource is executed to trigger the firmware update process. LwM2M Client DFOTA Application Security File System Post 'Update' Register to get Firmware Object Updates Firmware Update Set DFOTA Cookie Request Reboot SysMon Figure 4: Call Flow of 'Update' Resource Observing and Update Event Processing 3.2. URC of Firmware Update with LwM2M 3.2.1. Download Progress URCs 3.2.1.1. In-Band Mode When the DFOTA firmware update is triggered in the LwM2M in-band mode, the following URCs are outputted to notify the download progress. +LWM2M: 'FOTA','DOWNLOADING' Notify the Download Progress URC Format: +LWM2M: 'FOTA','DOWNLOADING','START' URC Format: +LWM2M: 'FOTA','DOWNLOADING','COMPLETED' Download process started. Download process completed. 3.2.1.2. Out-of-Band HTTP(S) Mode When the DFOTA firmware update is triggered in the LwM2M out-of-band HTTP(S) mode, the following URCs are outputted to notify the download progress. BG95&BG77&BG600L_Series_DFOTA_Application_Note 34 / 40 LPWA Module Series +QIND: 'FOTA','HTTP' Notify the Download Progress URC Format: +QIND: 'FOTA','HTTPSTART' URC Format: +QIND: 'FOTA','DOWNLOADING', ... URC Format: +LWM2M: 'FOTA','DOWNLOADED', Download process started. Download progress in percentage. Download operation result. Parameter Integer type. The download progress in percentage. Integer type. The HTTP(S) error code. 0 Downloaded successfully. Any other value Error. Refer to Chapter 4 for more details. 3.2.1.3. Out-of-Band CoAP(S) Mode When the DFOTA firmware update is triggered in the LwM2M out-of-band CoAP(S) mode, the following URCs are outputted to notify the download progress. +QIND: 'FOTA','COAP' Notify the Download Progress URC Format: +QIND: 'FOTA','COAPSTART' URC Format: +LWM2M: 'FOTA','DOWNLOADED', Download process started. Download operation result. Parameter Integer type. The CoAP(S) error code. 0 Downloaded successfully. Any other value Error. Refer to Chapter 4 for more details. BG95&BG77&BG600L_Series_DFOTA_Application_Note 35 / 40 LPWA Module Series 3.2.2. Update Progress URCs 3.2.2.1. +QIND: 'FOTA','START' Updating Started +QIND: 'FOTA','START' Updating Started URC Format: +QIND: 'FOTA','START' Notify the start of the updating. 3.2.2.2. +QIND: 'FOTA','UPDATING', Updating Progress +QIND: 'FOTA','UPDATING', Updating Progress URC Format: +QIND: 'FOTA','UPDATING', Notify the updating progress in percentage. Parameter Integer type. The updating progress in percentage. 3.2.2.3. +QIND: 'FOTA','END', Updating Finished +QIND: 'FOTA','END', Updating Finished URC Format: +QIND: 'FOTA','END', Notify the completion of updating. Parameter Error code. See Chapter 4 for more details. BG95&BG77&BG600L_Series_DFOTA_Application_Note 36 / 40 LPWA Module Series 4 Summary of Error Codes These error codes indicate errors related to mobile equipment or network. The details about , , , and are described in the following tables. Table 2: Summary of // Codes // 0 701 702 703 704 705 706 707 708 709 710 711 712 Meaning Download successful Unknown error Server connection failed Request failed Download timeout URL error File does not exist Write data to file failed Downloaded file is too large Download cancelled Downloaded package check failed Data call disconnected Custom segmented download completed successfully BG95&BG77&BG600L_Series_DFOTA_Application_Note 37 / 40 Table 3: Summary of Codes 0 504 505 506 507 508 509 510 511 512 Meaning Updated successfully Firmware update failed Update package does not exist Update package check failed Decompress failed Compress failed Copy compressed data failed Restore failed Package is mismatched with the current firmware DFOTA unknown error Table 4: Summary of Codes 590 591 592 593 594 Meaning Input parameter invalid DFOTA is ongoing DFOTA downloading is not in progress DFOTA package does not exist or open failure DFOTA memory allocation failed LPWA Module Series BG95&BG77&BG600L_Series_DFOTA_Application_Note 38 / 40 LPWA Module Series 5 Appendix A References Table 5: Related Documents Document Name [1] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual [2] Quectel_BG95&BG77&BG600L_Series_QEFS_Explorer_User_Guide [3] Quectel_BG95&BG77&BG600L_Series_FILE_Application_Note Table 6: Terms and Abbreviations Abbreviation AP APN bps CoAP(S) DAM DFOTA EFS EGPRS FOTA HTTP(S) FTP(S) IP IPv4 Description Application Processor Access Point Name Bit(s) Per Second Constrained Application Protocol (Secure) Downloadable Application Module Delta Firmware Upgrade Over-the-Air Embedded File System Enhanced General Packet Radio Service Firmware Over-the-Air Hyper Text Transport Protocol (Secure) File Transfer Protocol (Secure) Internet Protocol Internet Protocol Version 4 BG95&BG77&BG600L_Series_DFOTA_Application_Note 39 / 40 IPv6 KB LTE LPWA LwM2M NAND OMA SSL URC URI Internet Protocol Version 6 Kilobytes Long Term Evolution Low Power Wide Area Lightweight Machine to Machine Not And Open Mobile Alliance Secure Sockets Layer Unsolicited Result Code Uniform Resource Identifier LPWA Module Series BG95&BG77&BG600L_Series_DFOTA_Application_Note 40 / 40

BG95&BG77&BG600L Series FTM Application Note LPWA Module Series Version: 1.1 Date: 2020-11-29 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series FTM Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_FTM_Application_Note 1 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note Copyright The information contained here is proprietary technical information of Quectel Wireless Solutions Co., Ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved. BG95&BG77&BG600L_Series_FTM_Application_Note 2 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note About the Document Revision History Version 1.0 Date 2020-05-28 Author Hyman DING/ Miles MA 1.1 2020-11-29 Miles MA Description Initial 1. Updated the uplink channel range for LTE B85 in AT+QRFTEST. 2. Added the applicability restrictions on LTE B26, B27 and B71 in AT+QRFTEST and AT+QRXFTM. BG95&BG77&BG600L_Series_FTM_Application_Note 3 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 2 FTM AT Commands ............................................................................................................................ 7 2.1. AT Command Syntax ................................................................................................................. 7 2.1.1. Definitions........................................................................................................................ 7 2.1.2. AT Command Syntax ...................................................................................................... 7 2.2. Description of FTM AT Commands ............................................................................................ 8 2.2.1. AT+QRFTESTMODE Enter/Exit FTM .......................................................................... 8 2.2.2. AT+QRFTEST Transmit in FTM ................................................................................... 9 2.2.3. AT+QRXFTM Receive in FTM.................................................................................... 12 3 Examples ........................................................................................................................................... 15 3.1. Set the Module into FTM.......................................................................................................... 15 3.2. Transmit in FTM ....................................................................................................................... 15 3.3. Receive in FTM ........................................................................................................................ 18 4 Appendix A References.................................................................................................................... 19 BG95&BG77&BG600L_Series_FTM_Application_Note 4 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Type of AT Commands and Responses ......................................................................................... 7 Table 3: Terms and Abbreviations .............................................................................................................. 19 BG95&BG77&BG600L_Series_FTM_Application_Note 5 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note 1 Introduction The document describes the AT commands which are used to test the receiving and transmitting performance of Quectel BG95 series, BG77 and BG600L-M3 modules under FTM (Factory Test Mode) so as to facilitate RF calibration. 1.1. Applicable Modules Table 1: Applicable Modules Module Series BG95 BG77 BG600L Model BG95-M1 BG95-M2 BG95-M3 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS NOTE See the firmware release notes of corresponding module models to check whether the function has been supported. BG95&BG77&BG600L_Series_FTM_Application_Note 6 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note 2 FTM AT Commands 2.1. AT Command Syntax 2.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on command line. When an optional parameter is omitted, the new value equals its previous value or its default setting, unless otherwise specified.  Underline Default setting of a parameter. 2.1.2. AT Command Syntax The AT or at prefix must be added at the beginning of each command line. Entering will terminate a command line. Commands are usually followed by a response that includes . Throughout this document, only the response will be presented, are omitted intentionally. Table 2: Type of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. [,[,[...]]] AT+ This command reads non-variable parameters affected by internal processes in the module. BG95&BG77&BG600L_Series_FTM_Application_Note 7 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note 2.2. Description of FTM AT Commands 2.2.1. AT+QRFTESTMODE Enter/Exit FTM The Write Command makes the module enter/exit FTM (RF test mode). AT+QRFTEST (see Chapter 2.2.2) and AT+QRXFTM (see Chapter 2.2.3) are available only when the module enters FTM with this command. AT+QRFTESTMODE Enter/Exit FTM Test Command AT+QRFTESTMODE=? Response +QRFTESTMODE: (list of supported s) Read Command AT+QRFTESTMODE? Write Command AT+QRFTESTMODE= Characteristics OK Response +QRFTESTMODE: OK Response OK If there is any error related to ME functionality: +CME ERROR: If there is any other error: ERROR The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Enter/exit FTM. 0 Exit FTM 1 Enter FTM BG95&BG77&BG600L_Series_FTM_Application_Note 8 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note 2.2.2. AT+QRFTEST Transmit in FTM The Write Commands force the module to transmit in FTM. AT+QRFTEST Transmit in FTM Test Command The command currently only returns the list of parameters set by the Write Command in GSM AT+QRFTEST=? Response +QRFTEST: ,,,, OK Write Command In GSM: AT+QRFTEST=,,, , Response ALL ON OK Or ALL OFF OK If there is any error related to ME functionality: +CME ERROR: Write Command In LTE-M: AT+QRFTEST=,,, , If there is any other error: ERROR Response ALL ON OK Or ALL OFF OK If there is any error related to ME functionality: +CME ERROR: Write Command In NB-IoT: AT+QRFTEST=,,, ,,,,,, If there is any other error: ERROR Response ALL ON OK Or BG95&BG77&BG600L_Series_FTM_Application_Note 9 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note Characteristics ALL OFF OK If there is any error related to ME functionality: +CME ERROR: If there is any other error: ERROR The command takes effect immediately. The configurations is not saved. Parameter String type. Supported bands in GSM/LTE. The possible values are: For GSM: 'GSM850' 'GSM900' 'GSM1800' 'GSM1900' For LTE: 'LTE BAND1' 'LTE BAND2' 'LTE BAND3' 'LTE BAND4' 'LTE BAND5' 'LTE BAND8' 'LTE BAND12' 'LTE BAND13' 'LTE BAND18' 'LTE BAND19' 'LTE BAND20' 'LTE BAND25' 'LTE BAND26' (Supported by LTE-M only) 'LTE BAND27' (Supported by LTE-M only) 'LTE BAND28' 'LTE BAND31' (Supported by BG95-M4 only) 'LTE BAND66' 'LTE BAND71' (Supported by NB-IoT only) 'LTE BAND72' (Supported by BG95-M4 only) 'LTE BAND73' (Supported by BG95-M4 only) 'LTE BAND85' Integer type. Supported uplink channels in GSM/LTE. The corresponding channels for different bands in GSM/LTE are as follows: BG95&BG77&BG600L_Series_FTM_Application_Note 10 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note GSM band GSM850 GSM900 GSM1800 GSM1900 Uplink Channels 128–251 1–124, 975–1023 512–885 512–810 LTE band Uplink Channels LTE BAND1 18000–18599 LTE BAND2 18600–19199 LTE BAND3 19200–19949 LTE BAND4 19950–20399 LTE BAND5 20400–20649 LTE BAND8 21450–21799 LTE BAND12 23010–23179 LTE BAND13 23180–23279 LTE BAND18 23850–23999 LTE BAND19 24000–24149 LTE BAND20 24150–24449 LTE BAND25 26040–26689 LTE BAND26 26690–27039 (Supported by LTE-M only) LTE BAND27 27040–27209 (Supported by LTE-M only) LTE BAND28 27210–27659 LTE BAND31 27760–27809 (Supported by BG95-M4 only) LTE BAND66 131972–132671 LTE BAND71 131122–133471 (Supported by NB-IoT only) LTE BAND72 133472–133521 (Supported by BG95-M4 only) LTE BAND73 133522–133571 (Supported by BG95-M4 only) LTE BAND85 134002–134181 String type. Enable/disable RF TX. 'ON' Enable RF TX 'OFF' Disable RF TX Integer type. 0 Continuous TX mode Integer type. GSM power level (GSM power in dBm × 100). Range: 0–3300. Integer type. LTE power level. Range: 0–100. Integer type. 1 LTE modulated TX mode Integer type. Uplink carrier frequency offset. Range: -128 to 127. Integer type. Modulation type. 0 BPSK 1 QPSK Integer type. TX power in dBm. Range: -128 to 127. Integer type. Uplink tone bandwidth. 0 Single-tone, 3.75 kHz BG95&BG77&BG600L_Series_FTM_Application_Note 11 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note 1 Single-tone, 15 kHz 2 Multi-tone, 3 × 15 kHz 3 Multi-tone, 6 × 15 kHz 4 Multi-tone, 12 × 15 kHz Integer type. Tone start index. Range: 0–255. NOTES 1. Please refer to Section 5.7.3F Carrier frequency and EARFCN for category NB1 and NB2 in 3GPP TS 36.101, to calculate the specific uplink carrier frequency offset, namely, the value of . 2. For LTE-M, the default bandwidth is 10 MHz currently. 2.2.3. AT+QRXFTM Receive in FTM The Write Command forces the module to receive in FTM. AT+QRXFTM Receive in FTM Test Command AT+QRXFTM=? Response +QRXFTM: ,,,,, Read Command AT+QRXFTM? Write Command AT+QRXFTM=,,[,[,[,]]] OK Response OK Response +QRXFTM: , OK If there is any error related to ME functionality: +CME ERROR: Characteristics If there is any other error: ERROR The command takes effect immediately. The configurations is not saved. Parameter Integer type. 1 LTE RX test BG95&BG77&BG600L_Series_FTM_Application_Note 12 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note String type. Supported bands in GSM/LTE. The possible values are: For GSM: 'GSM850' 'GSM900' 'GSM1800' 'GSM1900' For LTE: 'LTE BAND1' 'LTE BAND2' 'LTE BAND3' 'LTE BAND4' 'LTE BAND5' 'LTE BAND8' 'LTE BAND12' 'LTE BAND13' 'LTE BAND18' 'LTE BAND19' 'LTE BAND20' 'LTE BAND25' 'LTE BAND26' (Supported by LTE-M only) 'LTE BAND27' (Supported by LTE-M only) 'LTE BAND28' 'LTE BAND31' (Supported by BG95-M4 only) 'LTE BAND66' 'LTE BAND71' (Supported by NB-IoT only) 'LTE BAND72' (Supported by BG95-M4 only) 'LTE BAND73' (Supported by BG95-M4 only) 'LTE BAND85' Integer type. Supported downlink channels in GSM/LTE. The corresponding channels for different bands in GSM/LTE are as follows: GSM band Downlink Channels GSM850 128–251 GSM900 1–124, 975–1023 GSM1800 512–885 GSM1900 512–810 LTE band LTE BAND1 LTE BAND2 LTE BAND3 LTE BAND4 LTE BAND5 LTE BAND8 Downlink Channels 0–599 600–1199 1200–1949 1950–2399 2400–2649 3450–3799 BG95&BG77&BG600L_Series_FTM_Application_Note 13 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note LTE BAND12 5010–5179 LTE BAND13 5180–5279 LTE BAND18 5850–5999 LTE BAND19 6000–6149 LTE BAND20 6150–6449 LTE BAND25 8040–8689 LTE BAND26 8690–9039 (Supported by LTE-M only) LTE BAND27 9040–9209 (Supported by LTE-M only) LTE BAND28 9210–9659 LTE BAND31 9870–9919 (Supported by BG95-M4 only) LTE BAND66 66436–67335 LTE BAND71 68586–68935 (Supported by NB-IoT only) LTE BAND72 68936–68985 (Supported by BG95-M4 only) LTE BAND73 68986–69035 (Supported by BG95-M4 only) LTE BAND85 70366–70545 Integer type. 0 Main antenna path. Integer type. Gain stages. Range: 0–5. Integer type. Bandwidth. Range: 0–5. This parameter is only valid for LTE RAT (that is, not applicable for GSM RAT). 0 1.4 MHz bandwidth 1 3 MHz bandwidth 2 5 MHz bandwidth 3 10 MHz bandwidth 4 15 MHz bandwidth 5 20 MHz bandwidth Integer type. Result of receiving power range. Integer type. Receiving power level in dBm converted from . NOTES 1. The result of AT+QRXFTM is an instantaneous value. 2. In LTE RAT, the value of equals to / 10. BG95&BG77&BG600L_Series_FTM_Application_Note 14 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note 3 Examples 3.1. Set the Module into FTM AT+QRFTESTMODE=? +QRFTESTMODE: (0,1) OK AT+QRFTESTMODE=1 OK AT+QRFTESTMODE? +QRFTESTMODE: 1 OK AT+QRFTESTMODE=0 OK AT+QRFTESTMODE? +QRFTESTMODE: 0 OK //Test command //Enter FTM //Query the current FTM state of the module //Exit FTM //Query the current FTM state of the module 3.2. Transmit in FTM AT+QRFTESTMODE=1 OK //In GSM RAT AT+QRFTEST='GSM900',122,'ON',0,100 ALL ON OK AT+QRFTEST='GSM900',122,'OFF',0,100 ALL OFF OK //Enter FTM //Enable RF TX on 122 channel of GSM900 //Disable RF TX on 122 channel of GSM900 BG95&BG77&BG600L_Series_FTM_Application_Note 15 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note //In LTE-M RAT AT+QRFTEST='LTE BAND1',18300,'ON',50,1 ALL ON //Enable RF TX on 18300 channel of LTE B1 OK AT+QRFTEST='LTE BAND1',18300,'OFF',50,1 ALL OFF //Disable RF TX on 18300 channel of LTE B1 OK AT+QRFTEST='LTE BAND2',18900,'ON',50,1 ALL ON //Enable RF TX on 18900 channel of LTE B2 OK AT+QRFTEST='LTE BAND2',18900,'OFF',50,1 ALL OFF //Disable RF TX on 18900 channel of LTE B2 OK AT+QRFTEST='LTE BAND12',23095,'ON',50,1 ALL ON //Enable RF TX on 23095 channel of LTE B12 OK AT+QRFTEST='LTE BAND12',23095,'OFF',50,1 ALL OFF //Disable RF TX on 23095 channel of LTE B12 OK AT+QRFTEST='LTE BAND20',24300,'ON',50,1 ALL ON //Enable RF TX on 24300 channel of LTE B20 OK AT+QRFTEST='LTE BAND20',24300,'OFF',50,1 ALL OFF //Disable RF TX on 24300 channel of LTE B20 OK AT+QRFTEST='LTE BAND28',27435,'ON',50,1 ALL ON //Enable RF TX on 27435 channel of LTE B28 OK AT+QRFTEST='LTE BAND28',27435,'OFF',50,1 ALL OFF //Disable RF TX on 27435 channel of LTE B28 OK //In NB-IoT RAT AT+QRFTEST='LTE BAND1',18300,'ON',50,1,100,0,50,4,0 //Enable RF TX on 18300 channel of BG95&BG77&BG600L_Series_FTM_Application_Note 16 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note ALL ON LTE B1 OK AT+QRFTEST='LTE BAND1',18300,'OFF',50,1,100,0,50,4,0 ALL OFF //Disable RF TX on 18300 channel of LTE B1 OK AT+QRFTEST='LTE BAND2',18900,'ON',50,1,100,0,50,4,0 ALL ON //Enable RF TX on 18900 channel of LTE B2 OK AT+QRFTEST='LTE BAND2',18900,'OFF',50,1,100,0,50,4,0 ALL OFF //Disable RF TX on 18900 channel of LTE B2 OK AT+QRFTEST='LTE BAND20',24300,'ON',50,1,100,0,50,4,0 ALL ON //Enable RF TX on 24300 channel of LTE B20 OK AT+QRFTEST='LTE BAND20',24300,'OFF',50,1,100,0,50,4,0 ALL OFF //Disable RF TX on 24300 channel of LTE B20 OK AT+QRFTEST='LTE BAND28',27435,'ON',50,1,100,0,50,4,0 ALL ON //Enable RF TX on 27435 channel of LTE B28 OK AT+QRFTEST='LTE BAND28',27435,'OFF',50,1,100,0,50,4,0 ALL OFF //Disable RF TX on 27435 channel of LTE B28 OK AT+QRFTESTMODE=0 OK //Disable RF test mode BG95&BG77&BG600L_Series_FTM_Application_Note 17 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note 3.3. Receive in FTM AT+QRFTESTMODE=1 OK //Enter FTM //In LTE RAT AT+QRXFTM=1,'LTE BAND1',300,0,0,0 +QRXFTM: -1100,-110 //Enable RF RX on 300 channel of LTE B1 OK AT+QRXFTM=1,'LTE BAND2',900,0,0,0 +QRXFTM: -1100,-110 //Enable RF RX on 900 channel of LTE B2 OK AT+QRXFTM=1,'LTE BAND12',5095,0,0,0 +QRXFTM: -1100,-110 //Enable RF RX on 5095 channel of LTE B12 OK AT+QRXFTM=1,'LTE BAND20',6300,0,0,0 +QRXFTM: -1100, -110 //Enable RF RX on 6300 channel of LTE B20 OK AT+QRXFTM=1,'LTE BAND28',9435,0,0,0 +QRXFTM: -1100,-110 //Enable RF RX on 9435 channel of LTE B28 OK //In GSM RAT AT+QRXFTM=1,'GSM900',62,0,0 +QRXFTM: 3101799,-90 //Enable RF RX on 62 channel of GSM900 OK AT+QRFTESTMODE=0 OK //Exit FTM BG95&BG77&BG600L_Series_FTM_Application_Note 18 / 19 LPWA Module Series BG95&BG77&BG600L Series FTM Application Note 4 Appendix A References Table 3: Terms and Abbreviations Abbreviation BPSK LTE-M FTM GSM LPWA LTE NB-IoT QPSK RAT RF RX TX Description Binary Phase Shift Keying LTE-MTC (Machine Type Communication) Factory Test Mode Global System for Mobile Communications Low-Power Wide-Area Long Term Evolution Narrow Band Internet of Things Quadrature Phase Shift Keying Radio Access Technology Radio Frequency Receive Transmit BG95&BG77&BG600L_Series_FTM_Application_Note 19 / 19

BG95&BG77&BG600L Series PSM Application Note LPWA Module Series Rev. BG95&BG77&BG600L_Series_PSM_Application_Note_V1.0 Date: 2020-06-18 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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 WITHOUT PERMISSION ARE FORBIDDEN. 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. 2020. All rights reserved. BG95&BG77&BG600L_Series_PSM_Application_Note 1 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note About the Document Revision History Version Date 1.0 2020-06-18 Author Ethan YAN Description Initial BG95&BG77&BG600L_Series_PSM_Application_Note 2 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Applicable Modules ................................................................................................................. 6 2 General Overview of PSM ................................................................................................................... 8 3 Description of PSM AT Commands ................................................................................................... 9 3.1. AT Command Syntax............................................................................................................... 9 3.1.1. Definitions......................................................................................................................... 9 3.1.2. AT Command Syntax ....................................................................................................... 9 3.2. Description of AT Commands ................................................................................................ 10 3.2.1. AT+CPSMS Power Saving Mode Setting ................................................................... 10 3.2.2. AT+QPSMS Extended Power Saving Mode Setting ................................................... 12 3.2.3. AT+QPSMCFG PSM Feature and Minimum Threshold Value Setting ....................... 14 3.2.4. AT+QPSMEXTCFG Modem Optimization .................................................................. 16 3.2.5. AT+QCFG='psm/urc' Enable/Disable PSM Entering Indication................................. 17 3.3. Description of URC................................................................................................................ 18 3.3.1. +QPSMTIMER Indicate the TAU Duration and Active Time Duration......................... 18 4 Wake up from PSM ............................................................................................................................ 20 4.1. Wake up from PSM with PON_TRIG (Recommended) ........................................................ 20 4.2. Wake up from PSM with PWRKEY ....................................................................................... 21 4.3. Wake up from PSM When T3412 Timer Expires .................................................................. 21 5 Typical Power Consumption Cycle.................................................................................................. 23 6 Appendix A References..................................................................................................................... 24 7 Appendix B Summary of CME ERROR Codes................................................................................ 26 BG95&BG77&BG600L_Series_PSM_Application_Note 3 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Type of AT Commands and Responses ......................................................................................... 9 Table 3: Related Documents ...................................................................................................................... 24 Table 4: Terms and Abbreviations .............................................................................................................. 24 Table 5: Summary of CME ERROR Codes ............................................................................................... 26 BG95&BG77&BG600L_Series_PSM_Application_Note 4 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Figure Index Figure 1: Wake up Module from PSM with PON_TRIG ............................................................................. 20 Figure 2: Wake up Module from PSM with PWRKEY................................................................................ 21 Figure 3: Automatically Wake up Module from PSM When T3412 Expires .............................................. 22 Figure 4: Typical Power Consumption Cycle ............................................................................................. 23 BG95&BG77&BG600L_Series_PSM_Application_Note 5 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 1 Introduction Power Saving Mode (PSM) is a key feature for eMTC/NB-IoT devices and applications with the following requirements:  Infrequently active  Short duration of active communication  Data transmission is mainly originated by eMTC/NB-IoT devices, but also possible to engage in DL receiving during the active duration  Power constraint, running on battery  Require long battery life PSM is to make an IoT device inactive or power-down most of the time to save power and wake up the device only for a short period of time for data transmission. This document mainly introduces PSM feature and also describes how to use PSM function of Quectel BG95 series, BG77 and BG600L-M3 modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning BG95&BG77&BG600L_Series_PSM_Application_Note 6 / 27 BG77 BG600L BG95-N1 BG77 BG600L-M3 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Cat NB2 Only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_PSM_Application_Note 7 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 2 General Overview of PSM PSM mode defined by 3GPP Release 12 is similar to power-off, but the UE (BG95 series, BG77 and BG600L-M3 modules) remains registered with the network and there is no need to re-attach or re-establish PDN connections. Therefore, the UE in PSM is not immediately reachable for mobile terminating services. The UE using PSM is available for mobile terminating services during the time it is in connected mode and for the period of an Active Time that is after the connected mode. The connected mode is caused by a mobile originated event like data transmission or signalling, e.g. after a periodic TAU/RAU procedure. PSM is therefore suitable for UE that is expecting only infrequent mobile originating and terminating services and that can accept a corresponding latency in the mobile terminating communication. NOTE For more detailed description of PSM mode defined by 3GPP Release 12, see 3GPP TS 23.682 clause 4.5.4 UE Power Saving Mode. BG95&BG77&BG600L_Series_PSM_Application_Note 8 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 3 Description of PSM AT Commands 3.1. AT Command Syntax 3.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on command line. When an optional parameter is omitted, the new value equals its previous value or its default setting, unless otherwise specified.  Underline Default setting of a parameter. 3.1.2. AT Command Syntax The AT or at prefix must be added at the beginning of each command line. Entering will terminate a command line. Commands are usually followed by a response that includes . Throughout this document, only the response will be presented, are omitted intentionally. Table 2: Type of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. [,[,[...]]] AT+ This command reads non-variable parameters affected by internal processes in the module. BG95&BG77&BG600L_Series_PSM_Application_Note 9 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 3.2. Description of AT Commands 3.2.1. AT+CPSMS Power Saving Mode Setting The Write Command configures PSM parameters of the module. It controls whether the module wants to apply PSM or not, as well as the requested extended periodic RAU value and the requested GPRS READY timer value in GERAN, the requested extended periodic TAU value in E-UTRAN and the requested Active Time value. See the URCs provided by commands AT+CGREG for the Active Time value, the extended periodic RAU value and the GPRS READY timer value that are allocated to the module by the network in GERAN and AT+CEREG for the Active Time value and the extended periodic TAU value that are allocated to the module by the network in E-UTRAN. A special form of the command can be given as AT+CPSMS= (with all parameters omitted). In this form, will be set to 0, the use of PSM will be disabled and data for all parameters in AT+CPSMS will be removed. The Read Command returns the current parameter values. The Test Command returns the supported s and the value ranges for the requested extended periodic RAU value and the requested GPRS READY timer value in GERAN, the requested extended periodic TAU value in E-UTRAN and the requested Active Time value as compound values. AT+CPSMS Power Saving Mode Setting Test Command AT+CPSMS=? Response +CPSMS: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+CPSMS? OK Response +CPSMS: ,[],[],[],[] Write Command AT+CPSMS=[[,[,[,[,]]]]] OK Response OK If there is any other error: ERROR Maximum Response Time 300 ms BG95&BG77&BG600L_Series_PSM_Application_Note 10 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Disable or enable the use of PSM in the UE. 0 Disable the use of PSM 1 Enable the use of PSM String type. One byte in an 8-bit format. Requested extended periodic RAU value (T3312) to be allocated to the UE in GERAN. (e.g. '01000111' equals to 70 hours.) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute String type. One byte in an 8-bit format. Requested GPRS READY timer value (T3314) to be allocated to the UE in GERAN. (e.g. '01001010' equals to 1 hours.) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated String type. One byte in an 8-bit format. Requested extended periodic TAU value (T3412) to be allocated to the UE in E-UTRAN. (e.g. '00001010' equals to 100 minutes) In the Write Command, when is 1 and is omitted, the value configured last time is used. Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours BG95&BG77&BG600L_Series_PSM_Application_Note 11 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute String type. One byte in an 8-bit format. Requested Active Time value (T3324) to be allocated to the UE. (e.g. '00001111' equals to 1 minute) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated. Example AT+CPSMS=1,,,'00000100','00001111' //Set the requested T3412 value to 40 minutes, and set the OK requested T3324 value to 30 seconds. 3.2.2. AT+QPSMS Extended Power Saving Mode Setting This is an extended AT command developed by Quectel for PSM setting. A special form of the command can be given as AT+QPSMS= (with all parameters omitted). In this form, will be set to 0, the use of PSM will be disabled and data for all parameters in AT+QPSMS will be removed. It is similar with AT+CPSMS. AT+QPSMS Extended Power Saving Mode Setting Test Command AT+QPSMS=? Response +QPSMS: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+QPSMS? OK Response +QPSMS: ,[],[],[],[] Write Command AT+QPSMS=[[,[,[,[,]]]]] Maximum Response Time 300 ms Characteristics Reference 3GPP TS 27.007 The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Disable or enable the use of PSM in the UE. 0 Disable the use of PSM 1 Enable the use of PSM String type. One byte in an 8-bit format. Requested extended periodic RAU value (T3312) to be allocated to the UE in GERAN. (e.g. '01000111' equals to 70 hours.) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute String type. One byte in an 8-bit format. Requested GPRS READY timer value (T3314) to be allocated to the UE in GERAN. (e.g. '01001010' equals to 1 hours.) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated. String type. One byte in an 8-bit format. Requested extended periodic TAU value (T3412) to be allocated to the UE in E-UTRAN. (e.g. '00001010' equals to 100 minutes.) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 10 minutes BG95&BG77&BG600L_Series_PSM_Application_Note 13 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 0 0 1 value is incremented in multiples of 1 hour 0 1 0 value is incremented in multiples of 10 hours 0 1 1 value is incremented in multiples of 2 seconds 1 0 0 value is incremented in multiples of 30 seconds 1 0 1 value is incremented in multiples of 1 minute String type. One byte in an 8-bit format. Requested Active Time value (T3324) to be allocated to the UE. (e.g. '00001111' equals to 1 minute.) Bits 5 to 1 represent the binary coded timer value. Bits 6 to 8 define the timer value unit as follows: Bits 8 7 6 0 0 0 value is incremented in multiples of 2 seconds 0 0 1 value is incremented in multiples of 1 minute 0 1 0 value is incremented in multiples of decihours 1 1 1 value indicates that the timer is deactivated. Integer type. Extended periodic RAU value (T3312) to be allocated to the UE in GERAN, and the value is specified by network. Integer type. GPRS READY timer value (T3314) to be allocated to the UE in GERAN, and the value is specified by network. Integer type. Extended periodic TAU value (T3412) to be allocated to the UE in E-UTRAN, and the value is specified by network. Integer type. Active timer value (T3324) to be allocated to the UE in E-UTRAN, and the value is specified by network. Example AT+QPSMS=1,,,'00000100','00001111' OK AT+QPSMS? +QPSMS:1,,,'86400','2' //Set the requested T3412 value to 40 minutes, and set the requested T3324 value to 30 seconds. //Query the PSM mode and the periodic-TAU and active time specified by the network. . OK 3.2.3. AT+QPSMCFG PSM Feature and Minimum Threshold Value Setting The Write Command enables or disables PSM feature and sets the minimum threshold value to enter PSM. A special form of the command can be given as AT+QPSMCFG= (with all parameters omitted). In this form, will be set to 20 and will be set to 4. BG95&BG77&BG600L_Series_PSM_Application_Note 14 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note AT+QPSMCFG PSM Feature and Minimum Threshold Value Setting Test Command AT+QPSMCFG=? Response +QPSMCFG: (list of supported s),(list of supported s) Write Command AT+QPSMCFG=[[,]] Read Command AT+QPSMCFG? OK Response OK If there is any error: ERROR Response +QPSMCFG: , Maximum Response Time Characteristics OK 300 ms The command takes effect after rebooting. The configurations will be saved automatically. Parameter Integer type. Minimum threshold value to enter PSM. Range: 20-4294967295. Unit: second. Integer type. Bitmask to indicate PSM feature (1: Enable; 0: Disable). Each bit is configured independently. Range: 0-4-15. Bit 0 PSM without network coordination Bit 1 Rel-12 PSM without context retention Bit 2 Rel-12 PSM with context retention Bit 3 PSM in between eDRX cycles Example AT+QPSMCFG=100 OK AT+QPSMCFG? +QPSMCFG: 100,4 OK //Set the threshold to 100 seconds. //Query the threshold value and PSM version. BG95&BG77&BG600L_Series_PSM_Application_Note 15 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 3.2.4. AT+QPSMEXTCFG Modem Optimization This command is used to set extended parameters for modem optimizations. A special form of the command can be given as AT+QPSMEXTCFG= (with all parameters omitted). In this form, will be set to 14, and data for all parameters in AT+QPSMEXTCFG will be removed or, if available, set to default values. In the Write Command, any parameter before the one that needs to be configured should be added or, if it is set as a default value, can be omitted and separated by a comma. AT+QPSMEXTCFG Modem Optimization Test Command AT+QPSMEXTCFG=? Response +QPSMEXTCFG: (list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s),(list of supported s) Read Command AT+QPSMEXTCFG? OK Response +QPSMEXTCFG: ,,,,, Write Command AT+QPSMEXTCFG=[[,[,[,[, [,]]]]]] OK Response OK If there is any error: ERROR Maximum Response Time 300 ms Characteristics The command takes effect after rebooting. The configurations will be saved automatically. Parameter Integer type. Range: 0-14-15. 1st bit of the parameter is used to enable/disable (0: disable; 1: enable) PSM ENTER request without sending PSM_READY_REQ to NAS. This is a quick PSM operation. 2nd bit of the parameter is used to enable/disable (0: disable; 1: enable) Out of Service (OoS) status indication from Modem to AP. BG95&BG77&BG600L_Series_PSM_Application_Note 16 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 3rd bit of the parameter is used to enable/disable (0: disable; 1: enable) limited service status indication from Modem to AP. 4th bit of the parameter is used to enable/disable (0: disable; 1: enable) deep-sleep mode if PSM cycle is less than the threshold value. If enabled, the device will be in deep-sleep mode before it enters PSM because of reaching the threshold value. Integer type. Maximum number of full scans to wait before modem declares SYS_PSM_STATUS_OOS to clients. Range: 1-2-100. Integer type. PSM cycle used by PSM daemon upon OOS/Limited Service indication, due to service outage. Range: 120-4294967295. Unit: second. Integer type. PSM wakeup randomization window which avoids network congestion caused by simultaneous wake-up of all the PSM devices. Range: 1-5-1000. Unit: second. Integer type. Maximum time in seconds to wait before declaring SYS_PSM_STATUS_OOS to clients. Range: 1-120-65535. Unit: second. Integer type. The time that the device wakes up in advance to account for boot-up and acquisition delay. While programming PMIC, PSM daemon reduces PSM cycle by this duration. Range: 1-3-1000. Unit: second. Example AT+QPSMEXTCFG=14,2,120 OK AT+QPSMEXTCFG? +QPSMEXTCFG: 14,2,120,5,120,3 OK 3.2.5. AT+QCFG='psm/urc' Enable/Disable PSM Entering Indication The command enables/disables the output of URC +QPSMTIMER: , which is used to indicate the TAU duration and active time duration for the module’s PSM. When PSM function is enabled and RRC connection release is received, the active timer (T3324) will be started, and the indication URC will be reported. AT+QCFG='psm/urc' Enable/Disable PSM Entering Indication Write Command AT+QCFG='psm/urc'[,] Response If the optional parameter is omitted, query the current setting: +QCFG: 'psm/urc', BG95&BG77&BG600L_Series_PSM_Application_Note 17 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Maximum Response Time Characteristics OK If the optional parameter is specified, set whether to enable PSM entering indication. OK If there is an error related to ME functionality: +CME ERROR: If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations will be saved automatically. Parameter Integer type. Enable/disable the output of URC +QPSMTIMER: ,. If enabled, the URC will be reported when RRC connection release is received. 0 Disable 1 Enable Integer type. Error code. See Appendix B. 3.3. Description of URC 3.3.1. +QPSMTIMER Indicate the TAU Duration and Active Time Duration The URC is used to indicate the TAU duration and active time duration of PSM. The URC is disabled by default, and can be enabled with AT+QCFG='psm/urc',1. +QPSMTIMER Indicate the TAU Duration and Active Time Duration +QPSMTIMER: , PSM. Parameter Integer type. TAU duration of PSM. Unit: second. Integer type. Active time duration of PSM. Unit: second. BG95&BG77&BG600L_Series_PSM_Application_Note 18 / 27 Example AT+QCFG='psm/urc' +QCFG: 'psm/urc',0 OK AT+QCFG='psm/urc',1 OK +QPSMTIMER: 86400,2 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note //TAU timer and active timer value of PSM. BG95&BG77&BG600L_Series_PSM_Application_Note 19 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 4 Wake up from PSM Either of the following methods wakes up the module from PSM: 1. Give PON_TRIG a rising edge to wake up the module (recommended). 2. Drive PWRKEY low to wake up the module. 3. When the T3412 timer expires, the module will be automatically woken up. 4.1. Wake up from PSM with PON_TRIG (Recommended) Through the following steps, the module can be woken up from PSM to realize communication between the module and the network. Step 1: Give PON_TRIG a rising edge, and then check whether the module has been woken up from PSM. Step 2: Perform UL and/or DL communication actively. MCU/PC Module Network 1. Give PON_TRIG a rising edge and check whether the module exits PSM 2. Active communication (UL and/or DL) Figure 1: Wake up Module from PSM with PON_TRIG BG95&BG77&BG600L_Series_PSM_Application_Note 20 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 4.2. Wake up from PSM with PWRKEY Similar to the PON_TRIG solution, the module can be woken up from PSM through steps below to realize communication between the module and the network. Step 1: Drive PWRKEY low and then check whether the module has been woken up from PSM. Step 2: Perform UL and/or DL communication actively. MCU/PC Module Network 1. Drive PWRKEY low and check whether the module exits PSM 2. Active communication (UL and/or DL) Figure 2: Wake up Module from PSM with PWRKEY 4.3. Wake up from PSM When T3412 Timer Expires When the T3412 (extended TAU timer) expires, the module will be automatically woken up from PSM. The following figure illustrates the automatic procedure for waking up a module from PSM. BG95&BG77&BG600L_Series_PSM_Application_Note 21 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Module Network T3324 and/or T3412 Extended Value Attach Accept T3324 and/or T3412 Extended Value RRC Release T3324 T3412 Tracking Area Update Request T3324 and/or T3412 Extended Value Tracking Area Update Accept T3324 and/or T3412 Extended Value PSM RRC Release Figure 3: Automatically Wake up Module from PSM When T3412 Expires BG95&BG77&BG600L_Series_PSM_Application_Note 22 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 5 Typical Power Consumption Cycle The following figure shows the typical power consumption cycle of the module. Power Consumption Level TAU Cycle The module is powered on or exits PSM ('woken up'). This could be 'the first time' or 'subsequent' power-on. Standy State Paging Cycle The module exits PSM ('woken-up') Standy State Paging Cycle PSM PSM Time Figure 4: Typical Power Consumption Cycle BG95&BG77&BG600L_Series_PSM_Application_Note 23 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 6 Appendix A References Table 3: Related Documents SN Document Name Quectel_BG95&BG77_AT_Commands_ [1] Manual [2] 3GPP TS 23.401 [3] 3GPP TS 23.682 Remark AT commands manual of BG95 series and BG77 modules 3GPP specification 3GPP specification Table 4: Terms and Abbreviations Abbreviation 3GPP AP DL DRX eDRX eMTC E-UTRAN GERAN GPRS NB-IoT PDN PMIC PSM Description 3rd Generation Partnership Project Application Processor Downlink Discontinuous Reception Extended Discontinuous Reception enhanced Machine-Type Communication Evolved UMTS Terrestrial Radio Access Network GSM EDGE Radio Access Network General Packet Radio Service Narrow Band Internet of Things Packet Data Network Gateway Power Management IC Power Saving Mode BG95&BG77&BG600L_Series_PSM_Application_Note 24 / 27 RAU RRC TAU UE UL URC LPWA Module Series BG95&BG77&BG600L Series PSM Application Note Routing Area Update Radio Resource Control Tracking Area Update User Equipment (typically the module) Uplink Unsolicited Result Code BG95&BG77&BG600L_Series_PSM_Application_Note 25 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 7 Appendix B Summary of CME ERROR Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. None of the following commands in the same command line is executed. Neither ERROR nor OK result code shall be returned. values are mostly used by common message commands. The following table lists most of general and GRPS related ERROR codes. For some GSM protocol failure cause described in GSM specifications, the corresponding ERROR codes are not included. Table 5: Summary of CME ERROR Codes Code of 0 1 2 3 4 5 6 7 10 11 12 13 Meaning Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required (U)SIM failure BG95&BG77&BG600L_Series_PSM_Application_Note 26 / 27 LPWA Module Series BG95&BG77&BG600L Series PSM Application Note 14 (U)SIM busy 15 (U)SIM wrong 16 Incorrect password 17 (U)SIM PIN2 required 18 (U)SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required BG95&BG77&BG600L_Series_PSM_Application_Note 27 / 27

BG95&BG77&BG600L Series Secure Boot Application Note LPWA Module Series Version: 1.1 Date: 2021-12-30 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 1 / 14 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 2 / 14 About the Document LPWA Module Series Revision History Version Date Author - 2020-11-03 Harding HU 1.0 2020-12-02 Harding HU 1.1 2021-12-30 Justice HAN Description Creation of the document First official release 1. Added two images (cmnlib.mbn and keymasterapp32.mbn) that must be signed in Secure Boot process (Chapter 2.4). 2. Updated the directory structure of Secure Boot toolkit (Chapter 2.6). 3. Updated Secure Boot enabling procedure (Chapter 3.1). BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 3 / 14 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 2 Secure Boot Overview ........................................................................................................................ 7 2.1. Definition .................................................................................................................................... 7 2.2. Secure Boot Process ................................................................................................................. 7 2.3. Certificate Chain......................................................................................................................... 8 2.4. Image Signing ............................................................................................................................ 8 2.5. Hardware Foundation ................................................................................................................ 8 2.6. Secure Boot Toolkit .................................................................................................................... 9 2.7. sec.elf ....................................................................................................................................... 10 3 Enable Secure Boot .......................................................................................................................... 11 3.1. Procedure..................................................................................................................................11 3.1.1. Preparation.....................................................................................................................11 3.1.2. Generate Certificates and Public Key Hash Value ........................................................11 3.1.3. Fill in Environment Variables..........................................................................................11 3.1.4. Sign Images and Generate a Firmware Package..........................................................11 3.1.5. Flash Firmware ............................................................................................................. 12 3.2. Verification................................................................................................................................ 12 3.2.1. AT+QSECBOOTSTAT Query Secure Boot Status ..................................................... 12 4 Appendix References ....................................................................................................................... 14 BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 4 / 14 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Quectel SecBootTools Directory Structure ..................................................................................... 9 Table 3: Related Document........................................................................................................................ 14 Table 4: Terms and Abbreviations .............................................................................................................. 14 BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 5 / 14 LPWA Module Series 1 Introduction This document describes Secure Boot details and how to enable Secure Boot on Quectel BG95 series, BG77 and BG600L-M3 modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS NOTE Hereinafter, BG95 series is collectively referred to as BG95 unless otherwise specified. BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 6 / 14 LPWA Module Series 2 Secure Boot Overview 2.1. Definition Secure Boot is defined as a boot sequence in which each loaded and executed firmware image is authorized using the previously authorized firmware. At each stage of the Secure Boot process, signature verification is performed to prevent any software without valid signature or maliciously modified software from running on the module. A root trusted entity is needed during the boot process. The Primary Boot Loader (PBL), embedded in the module as a firmware, is unmodifiable, and therefore can serve as the root trusted entity. 2.2. Secure Boot Process The Secure Boot process comprises multiple stages, and each image in every stage performs a specific function. After enabling the Secure Boot, the image to be executed in each stage needs to be verified by the previously verified image. If the verification fails, the entire boot process stops, and the module cannot boot up. Quectel BG95, BG77 and BG600L-M3 modules follow the verification sequence of Primary Boot Loader (PBL) → Secondary Boot Loader (SBL) → ARM® TrustZone. ⚫ As the root of trust, the PBL (also known as RoT) is the firmware embedded in chips and cannot be modified. Therefore, it is considered as the most trusted entity in the boot process, and authenticates the image to be executed in the next boot stage. ⚫ The SBL is usually verified in the second boot stage. After it is successfully authenticated by the PBL, it can be executed and used to authenticate the image in the next stage. ⚫NOTE Secure Boot is disabled by default. For details on how to enable Secure Boot, see Chapter 3. BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 7 / 14 LPWA Module Series 2.3. Certificate Chain Secure Boot supports 2048-bit or 4096-bit RSA private keys for signatures of the certificate and images. The format of the certificate signatures meets the PKCS #1 v1.5 or ITU-T X.509 v3 Standard and the SHA1 or SHA256 algorithm. The certificate chain of Quectel BG95, BG77 and BG600L-M3 modules consists of two certificates in X.509 format based on SHA-384 algorithm: the self-signed root certificate and the attestation certificate. The required certificates can be generated through the gencerts.bat mentioned in Chapter 2.6. The generated certificates are used to sign the image and the sec.elf file (see Chapter 2.7 for details). 2.4. Image Signing During Secure Boot, the images to be executed in each boot stage must be signed first. Quectel firmware images use the standard ELF format, and each image includes several segments indicating different types of information separately, wherein the hash table segment stores signature related information. The hash table segment also includes the hash values of each segment and the information about certificate trust chain. The images listed below must be signed in the Secure Boot process for Quectel BG95, BG77 and BG600L-M3 modules. ⚫ sbl1.mbn ⚫ prog_firehose_nand_mdm9x05.elf ⚫ tz.mbn ⚫ devcfg.mbn ⚫ rpm.mbn ⚫ multi_image.mbn ⚫ qdsp6sw.mbn ⚫ qdsp6sw_2.mbn ⚫ apps.mbn ⚫ cmnlib.mbn ⚫ keymasterapp32.mbn 2.5. Hardware Foundation The modules include one-time programmable fuses. The initial state of all fuses is 0 (Secure Boot disabled). Once a write operation is performed on the fuse (or the fuse is blown), the fuse state BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 8 / 14 LPWA Module Series permanently becomes 1 (Secure Boot enabled). The state cannot be changed after the fuse is blown, which means that Secure Boot enabling is an irreversible operation. 2.6. Secure Boot Toolkit Quectel provides a Secure Boot toolkit (Quectel SecBootTools) to generate related certificates and the sec.elf file, and to sign software images. The following introduces the directory structure of Quectel SecBootTools in Windows system. Figure 1: Quectel SecBootTools Directory Structure Table 2: Quectel SecBootTools Directory Structure SN File/Folder 1 common 2 dam_mod 3 doc 4 firmwares 5 fw_orig 6 fw_signed Description Contains the toolchain for signature. Stores QuecOpen application images to be signed and secure firehose configuration files for different projects. Contains all reference documents on Secure Boot. Stores firmware package to be signed and secure firehose configuration files for different projects. An intermediary for creating signed firmware packages. Stores the signed firmware package and intermediate files. BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 9 / 14 LPWA Module Series 7 contents.xml A configuration file used during signature. It cannot be modified. 8 dam_signature.bat Signs QuecOpen application images. 9 fw_signature.bat Makes a signed firmware package. 10 gencerts.bat Generates the root certificate (qpsa_rootca.cer) and the attestation certificate (qpsa_attestca.cer) as well as the hash values. 11 Release_History.txt Stores the release history of the tool. 12 Readme.txt For more details about the above files or folders, refer to Readme.txt. NOTE Contact Quectel Technical Support (support@quectel.com) to acquire the Secure Boot toolkit. 2.7. sec.elf The sec.elf file is vital for enabling Secure Boot, as it includes the configuration parameters for the function, as illustrated below. 1. Secure boot enabling 2. JTAG access disabling 3. Anti-rollback enabling 4. Read/Write permissions disabling/enabling for fuses 5. Fuse blowing The sec.elf file is generated during the image signing procedure. See Chapter 3.1.4 for details. BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 10 / 14 LPWA Module Series 3 Enable Secure Boot 3.1. Procedure 3.1.1. Preparation Store the original firmware package to be signed under fw_orig. Then, install Python and OpenSSL and check if Python and OpenSSL paths defined in /common/scripts/env.bat are the same as the actual paths. 3.1.2. Generate Certificates and Public Key Hash Value Run gencerts.bat in the Secure Boot toolkit to generate a root certificate and an attestation certificate, as well as a public key hash value of the root certificate. The generated certificates are automatically stored in /fw_signed/output/certs, and they are used to sign images; and the hash value is used to verify the signed images. If any image does not pass verification, image loading will fail. 3.1.3. Fill in Environment Variables Open fw_signature.bat and fill in the environment variables defined in fw_signature.bat with the firmware version to be signed and corresponding project name. 3.1.4. Sign Images and Generate a Firmware Package Run fw_signature.bat in the toolkit to sign the necessary image files and generate a new firmware package. For the list of necessary images, see Chapter 2.4. The whole process includes: 1) Double click fw_signature.bat and then fw_signature.bat runs automatically to enter Stage 1. In Stage 1, sec.elf that contains the hash of the root CA is automatically generated and stored in /fw_signed/output/sec_elf. 2) Press any key to proceed to Stage 2, during which the necessary images are signed one by one. Signed images are automatically stored in /fw_signed/output/9205. 3) Press any key to proceed to Stage 3, during which a new firmware package is automatically created in BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 11 / 14 LPWA Module Series fw_signed and replaces the original images with the signed images of the same names. 4) Press any key to proceed to Stage 4, during which the firehose configuration file rawprogram_nand_p2K_b128K.xml in the new firmware package is replaced with the secure firehose rawprogram_nand_p2K_b128K_sec.xml. 3.1.5. Flash Firmware Flash the firmware with the signed package created in Chapter 3.1.4. For details about how to flash firmware, see document [1]. NOTE After the Secure Boot is enabled, if you download an unsigned image, or use certificates different from the ones used for enabling Secure Boot to sign the image, the module will fail in downloading the firmware during firmware flashing process. 3.2. Verification After firmware updating, send AT+QSECBOOTSTAT? to query whether Secure Boot is enabled on the module. 3.2.1. AT+QSECBOOTSTAT Query Secure Boot Status This command queries the current status of Secure Boot. AT+QSECBOOTSTAT Query Secure Boot Status Read Command AT+QSECBOOTSTAT? Response +QSECBOOTSTAT: OK Maximum Response Time Characteristics If there is any error related to ME functionality: ERROR 300 ms / Parameter Integer type. Secure Boot status. BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 12 / 14 LPWA Module Series 0 Disabled 1 Enabled Example AT+QSECBOOTSTAT? +QSECBOOTSTAT: 1 OK //Query whether Secure Boot is enabled on the module. //Secure Boot is enabled. BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 13 / 14 LPWA Module Series 4 Appendix References Table 3: Related Document Document Name [1] Quectel_QFlash_User_Guide Table 4: Terms and Abbreviations Abbreviation CA ELF JATG PBL PKCS RoT RSA SBL SSL Description Certificate Authority Executable and Linkable Format Joint Test Action Group (an industry standard for verifying designs and testing printed circuit boards) Primary Boot Loader Public-Key Cryptography Standards Root of Trust Rivest–Shamir–Adleman Secondary Boot Loader Secure Sockets Layer BG95&BG77&BG600L_Series_Secure_Boot_Application_Note 14 / 14

BG95&BG77&BG600L Series LwM2M Application Note LPWA Module Series Version: 1.0 Date: 2021-01-07 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_LwM2M_Application_Note 1 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. BG95&BG77&BG600L_Series_LwM2M_Application_Note 2 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note About the Document Revision History Version 1.0 Date 2020-12-17 2021-01-07 Author Forest WANG/ Sherlock ZHAO Forest WANG/ Sherlock ZHAO Description Creation of the document First official release BG95&BG77&BG600L_Series_LwM2M_Application_Note 3 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 1.1. Applicable Modules .................................................................................................................... 7 2 General Overview of LwM2M ............................................................................................................. 9 2.1. LwM2M Interfaces.................................................................................................................... 10 2.1.1. Bootstrap Interface ........................................................................................................ 10 2.1.2. Client Registration Interface.......................................................................................... 10 2.1.3. Device Management and Service Enablement Interface ............................................. 12 2.1.4. Information Reporting Interface..................................................................................... 13 2.2. LwM2M Objects ....................................................................................................................... 13 2.3. IPv4v6 Fallback Mechanism .................................................................................................... 14 2.4. LwM2M and PSM..................................................................................................................... 14 2.5. File Provisioning and Configuration ......................................................................................... 15 2.5.1. Configuration and Script Files ....................................................................................... 15 2.5.2. Security Mode (DTLS)................................................................................................... 22 3 LwM2M AT Commands..................................................................................................................... 24 3.1. AT Command Syntax ............................................................................................................... 24 3.1.1. Definitions...................................................................................................................... 24 3.1.2. AT Command Syntax .................................................................................................... 24 3.2. Description of LwM2M AT Commands .................................................................................... 25 3.2.1. AT+QLWCFG Configure LwM2M Client .................................................................... 25 3.2.2. AT+QLWSVC Manage LwM2M Session ................................................................... 33 3.3. Description of LwM2M URCs................................................................................................... 36 3.3.1. +QLWURC: 'event' LwM2M Client State Changing Notification............................... 36 3.3.2. +QLWURC: 'observe' Observe Request Indication .................................................. 37 3.3.3. +QLWURC: 'uldata' Application Data Delivery Result Notification ........................... 38 3.3.4. +QLWURC: 'recv' Incoming Data Indication ........................................................... 38 4 Examples ........................................................................................................................................... 40 4.1. Configure LwM2M Client with Provisioning Profiles ................................................................ 40 4.2. Configure LwM2M Client with AT Command........................................................................... 41 4.2.1. Configure in Client-Initiated Bootstrap Mode ................................................................ 41 4.2.2. Configure in Factory Bootstrap Mode ........................................................................... 42 5 Appendix A References.................................................................................................................... 44 BG95&BG77&BG600L_Series_LwM2M_Application_Note 4 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Table Index Table 1: Applicable Modules ........................................................................................................................ 7 Table 2: Configuration and Script Files of LwM2M Client.......................................................................... 15 Table 3: Format of bootstrap.ini ................................................................................................................. 16 Table 4: Items of carrier_apn_cfg .............................................................................................................. 18 Table 5: Items of lwm2m_cfg ..................................................................................................................... 19 Table 6: Types of AT Commands .............................................................................................................. 24 Table 7: Arguments of ............................................................................................................... 32 Table 8: Arguments of and ....................................................................... 32 Table 9: Arguments of and .......................................................................... 36 Table 10: Related Documents.................................................................................................................... 44 Table 11: Terms and Abbreviations ........................................................................................................... 44 BG95&BG77&BG600L_Series_LwM2M_Application_Note 5 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Figure Index Figure 1: LwM2M Stack on the Modules...................................................................................................... 9 Figure 2: Operation Model for Client Initiated Bootstrap Interface ............................................................ 10 Figure 3: Client Registration Interface Example Flows.............................................................................. 11 Figure 4: Example Flows of Device Management and Service Enablement Interface ............................. 12 Figure 5: Example Flow for Information Reporting Interface ..................................................................... 13 BG95&BG77&BG600L_Series_LwM2M_Application_Note 6 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 1 Introduction With the rise of the Internet of Things, more and more terminal devices have been connected to Internet. So the requirement of device management and upgrade becomes urgent. The emergence of OMA Lightweight M2M (LwM2M) solves this industry problem. LwM2M provides some features to help device vendors to manage their devices, update the firmware, remotely control devices, etc. The main motivation for LwM2M is to define a set of lightweight protocols for a variety of IoT devices, since IoT devices are often very limited resources for embedded terminals, without UI, and come with limited computing and network communication capabilities. It is also because of the huge number of IoT terminals, due to which saving network resources becomes more important. This document introduces LwM2M protocol, the architecture of OMA LwM2M, and how to use this feature with Quectel BG95 series, BG77 and BG600L-M3 modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_LwM2M_Application_Note 7 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note NOTE See the firmware release notes of corresponding module models to check whether the function has been supported. BG95&BG77&BG600L_Series_LwM2M_Application_Note 8 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 2 General Overview of LwM2M Open Mobile Alliance (OMA) specifies the application layer communication protocol between a LwM2M Server and a LwM2M Client, located in a LwM2M device. The OMA LwM2M enabler includes device management and service enablement for LwM2M devices. The modules provide LwM2M Client on APPS. The LwM2M Client is compliant with OMA specifications and supports the following interfaces:  Bootstrap  Client Registration  Device Management and Service Enablement  Information Reporting The following figure shows the LwM2M stack on the modules. LwM2M Client LwM2M Core Library QMI QAPI COAP Non-IP DTLS UDP/IP ThreadX & ThreadX module APIs Modem Figure 1: LwM2M Stack on the Modules BG95&BG77&BG600L_Series_LwM2M_Application_Note 9 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 2.1. LwM2M Interfaces 2.1.1. Bootstrap Interface The Bootstrap Interface is used to provision essential information into the LwM2M Client to enable the LwM2M Client to perform the 'Register' operation with one or more LwM2M Servers.  Bootstrap Modes There are four bootstrap modes supported by the LwM2M Enabler: Factory Bootstrap, Bootstrap from Smartcard, Client Initiated Bootstrap and Server Initiated Bootstrap. The LwM2M Client MUST support at least one bootstrap mode specified in the Bootstrap Interface. Quectel BG95 series, BG77 and BG600L-M3 modules support two bootstrap modes: Factory Bootstrap and Client Initiated Bootstrap. LwM2M Client Bootstrap Request LwM2M Bootstrap Server Write/Read/Discover/Delete Bootstrap Finish Figure 2: Operation Model for Client Initiated Bootstrap Interface  Server and Access Control Configurations Information about LwM2M bootstrap server or other standard servers, and the access right for performing an operation for these LwM2M servers. 2.1.2. Client Registration Interface The Client Registration Interface is used by a LwM2M Client to register with one or more LwM2M Servers, maintain each registration, and de-register from a LwM2M Server.  Register When registering, the LwM2M Client performs the 'Register' operation and provides the properties the LwM2M Server requires to contact the LwM2M Client (e.g., End Point Name); maintain the registration and session (e.g., Lifetime, Queue Mode) between the LwM2M Client and LwM2M Server as well as knowledge of the Objects the LwM2M Client supports and existing Object Instances in the LwM2M Client. BG95&BG77&BG600L_Series_LwM2M_Application_Note 10 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note The registration is in soft state, with a lifetime indicated by the Lifetime Resource of that LwM2M Server Object Instance.  Update The LwM2M Client periodically performs an update of its registration information to the registered LwM2M Server(s) by performing the 'Update' operation. If the lifetime of a registration expires and without receiving an update from the LwM2M Client, the LwM2M Server removes the registration of that Client. The LwM2M Client performs the 'Update' operation in an interval equal to the lifetime of registration (as per Resource /1/x/1 value).  De-register Finally, when shutting down or discontinuing use of a LwM2M Server, the LwM2M Client performs a 'De-register' operation. The Binding Resource of the LwM2M Server Object informs the LwM2M Client of the transport protocol preferences of the LwM2M Server for the communication session between the LwM2M Client and LwM2M Server. The LwM2M Client SHOULD perform the operations with the modes indicated by the Binding Resource of the LwM2M Server Object Instance. LwM2M Client Register ep=node1 ,, 2.01 Created LwM2M Server Update 2.04 Changed De-register 2.02 Deleted Figure 3: Client Registration Interface Example Flows BG95&BG77&BG600L_Series_LwM2M_Application_Note 11 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 2.1.3. Device Management and Service Enablement Interface Device Management and Service Enablement is a very important interface in LwM2M.  The interface is used by the LwM2M Server to access Object Instances and Resources available from a registered LwM2M Client.  The interface provides this access through the use of 'Create', 'Read', 'Write', 'Delete', 'Execute', 'Write Attributes', or 'Discover' operations.  The operations that Resource supports are defined in the Object definition using the Object Template. The example flows of Device Management and Service Enablement Interface are shown as below: LwM2M Client LwM2M Server Read /3/0/0 Success Open Mobile Alliance Write /3/0/1 Lightweight M2M Client Success Execute /3/0/4 Success LwM2M Client LwM2M Server Create /2 Success-Location: /2/3 Write /2 Success-Location: /2/4 Delete /2/3 Success Figure 4: Example Flows of Device Management and Service Enablement Interface BG95&BG77&BG600L_Series_LwM2M_Application_Note 12 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 2.1.4. Information Reporting Interface The Information Reporting Interface is used by a LwM2M Server to observe any changes in a Resource on a registered LwM2M Client, receiving notifications when new values are available.  This observation relationship is initiated by sending an 'Observe' operation to the LwM2M Client for an Object, an Object Instance or a Resource.  An observation ends when a 'Cancel Observation' operation is performed. LwM2M Client supports observation and notification of objects, object instances and resources. LwM2M Client Get /4/0/2 Observe 2.05 Content Observe …3.0.. Notify 28 Notify 31 Cancel Observation LwM2M Server Figure 5: Example Flow for Information Reporting Interface 2.2. LwM2M Objects The LwM2M Client of the modules implements the following objects and handles the server requests for them:  Security object  Server object  Access control object  Device object  Connectivity monitoring object  Location object  Connectivity statistics object  APN connection profile  Cellular connectivity  Firmware update object  Software management object BG95&BG77&BG600L_Series_LwM2M_Application_Note 13 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note  Device capability management object The information received for these objects is sent to other registered applications, such as firmware over-the-air (FOTA), which implements these objects and monitors them using the LwM2M QAPI. For example, the LwM2M receives a request for 'execute update' on firmware update object. The LwM2M Client passes the request to the FOTA application that is registered to receive events. When the FOTA application receives the 'execute update' message, it processes and applies the image and sends the result to the LwM2M Client to forward it to the LwM2M Server. 2.3. IPv4v6 Fallback Mechanism If IPv4v6 is selected as the IP family:  An IPv6 call would be brought up first.  If the IPv6 call is not brought up even after all data call retries, then the LwM2M Client only attempts to bring up an IPv4 call. If the module is given IPv4 and IPv6 addresses:  The module first uses the IPv6 address to connect to the LwM2M Server.  If the LwM2M Server is unreachable using the IPv6 address, the module falls back to the IPv4 address and tries to connect to the LwM2M Server. 2.4. LwM2M and PSM  LwM2M Client behavior The LwM2M client must send 'registration update' to the LwM2M Server before the lifetime registration expires per the OMA specification. With the PSM enabled, the modules periodically enter into deep sleep and wake up only after the PSM timer expires. During deep sleep, the LwM2M Client is shut down and cannot send 'registration update' to the server, which results in the LwM2M Client losing its registration with the server.  How to keep LwM2M Client registered? Enable the REG_UPDATE_ON_RECONNECT option (see Chapter 2.5.1.3) for the LwM2M Client to send 'registration update' to the server after every wake-up from PSM. Enabling this feature ensures that the LwM2M Client does not lose its registration with the server. BG95&BG77&BG600L_Series_LwM2M_Application_Note 14 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note NOTE Currently, BG95 series, BG77 and BG600L-M3 modules only support enabling LwM2M PSM feature through provisioning profiles (see Chapter 2.5). 2.5. File Provisioning and Configuration 2.5.1. Configuration and Script Files The LwM2M Client has three configuration files which can be used to control its own behavior, and one script for auto start of LwM2M Client. The four files are listed in the table below. Table 2: Configuration and Script Files of LwM2M Client Filename bootstrap.ini carrier_apn_cfg lwm2m_app_autostart lwm2m_cfg Description  Used as factory bootstrap to discover the bootstrap server or other servers.  Bootstrap server details for client initiated bootstrap.  Can be used to instantiate multiple instances of objects (Security, Server, ACL). Contains information of the APN for the connection to servers. An empty file; the presence of this file indicates the LwM2M Client can start automatically. Contains LwM2M options to control features such as registration retry. NOTE If the above configurations files are preloaded to the /datatx directory of the modules, the LwM2M Client starts up automatically after module reboots. 2.5.1.1. bootstrap.ini bootstrap.ini contains the object information required for the bootstrapping process. The object information is in JSON format defined in the OMA specification. BG95&BG77&BG600L_Series_LwM2M_Application_Note 15 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Table 3: Format of bootstrap.ini Attributes JSON Variable Base Name bn Base Time bt Resource Array e Array Parameters name n Time t Float v Value Boolean bv Value ObjectLink ov Value String sv Value Mandatory Description No No Yes No No One value field is mandatory The base name string which is prepended to the Name value of the entry for forming a globally unique identifier for resource. The base time which the Time values are relative to. The Resource list as JSON value array according to [SenML] with Array parameter extension (Object Link). The Name value is prepended by the Base Name value to form the name of the resource instance. The resulting name uniquely identifies the Resource Instance from all others. Example:  if Base Name is '/', the Array entry Name of the Resource is {Object}/{Object Instance}/{Resource}/{Resource Instance}  when Base Name is not present, the Array entry Name is the full URI of the requested Resource Instance The time of the representation relative to the Base Time in seconds for a notification. Required only for historical representations. Value as a JSON float if the Resource data type is Integer, Float, or Time. Value as a JSON Boolean if the Resource data type is Boolean. Value as a JSON string if the Resource data type is ObjectLink Format.(e.g.'10:03') Value as a JSON string for all other Resource data types. If the Resource data type is opaque the string value holds the Base64 encoded representation of the Resource. The following is an example of a bootstrap.ini file containing security, server, and access control objects, specific to OMA 1.0 servers: {'bn':'/0/0/', 'e':[ {'n':'0','sv':'coaps://10.230.20.192:1111'}, {'n':'1','bv':true}, BG95&BG77&BG600L_Series_LwM2M_Application_Note 16 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note {'n':'2','v':0}, {'n':'10','v':100 }]} {'bn':'/0/1/', 'e':[ {'n':'1','bv':false}, {'n':'2','v':3}, {'n':'10','v':102 }]} {'bn':'/1/1/', 'e':[ {'n':'0','v':102}, {'n':'1','v':50000}, {'n':'2','v':1}, {'n':'3','v':60}, {'n':'5','v':86400}, {'n':'6','bv':true}, {'n':'7','sv':'UQS' }]} {'bn':'/2/0', 'e':[ {'n':'0','v':1}, {'n':'1','v':2}, {'n':'2/102','v':15}, {'n':'3','v':102 }]} The following is an example of a bootstrap.ini file containing security, server, and access control objects, specific to OMA 1.1 servers: {'bn':'/0/0/', 'e':[ {'n':'0','sv':'coap://2002:c023:9c17:c007:5443:ff62:a1f5:2c:5683'}, {'n':'1','bv':true}, {'n':'2','v':0}, {'n':'10','v':100 }]} {'bn':'/0/1/', 'e':[ {'n':'1','bv':false}, {'n':'2','v':3}, {'n':'10','v':102 }]} {'bn':'/1/1/', 'e':[ BG95&BG77&BG600L_Series_LwM2M_Application_Note 17 / 45 {'n':'0','v':102}, {'n':'1','v':50000}, {'n':'2','v':1}, {'n':'3','v':60}, {'n':'5','v':86400}, {'n':'6','bv':true}, {'n':'7','sv':'UN'}, {'n':'10','ov':'11:65533'}, {'n':'22','sv':'U' }]} {'bn':'/2/0', 'e':[ {'n':'0','v':1}, {'n':'1','v':2}, {'n':'2/102','v':15}, {'n':'3','v':102 }]} LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 2.5.1.2. carrier_apn_cfg carrier_apn_cfg includes details about the carrier-specific APN used for each server. Table 4: Items of carrier_apn_cfg Parameter Default value APN_NAME - APN_CLASS 2 SHORT_SERVER_ID1 102 BS_IF_REG_FAILS 0 IP_FAMILY BINDINGS v4 ip_nonip Description APN to be used for the server with SHORT_SERVER_ID1. APN class associated with the APN. Short server ID associated with the APN. If set to 0, LwM2M Client will not perform bootstrapping on registration failure for this SSID. If set to 1, LwM2M Client will perform bootstrapping on registration failure for this SSID. Supported values: v4, v6 and v4v6. This is the IP faimily chosen to connect to the server. Supported values: ip, nonip and ip_nonip. This is the binding type to be chosen to specify whether the LwM2M Client can communicate over IP or non-IP. BG95&BG77&BG600L_Series_LwM2M_Application_Note 18 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note In order to successfully register to the network and activate the PDN connection, the corresponding APN should be configured according to the current network. After the existing APN configuration, add a semicolon and then in the next line add a new APN configuration, as shown below: APN_NAME=carrier_apn1 APN_CLASS=2 BS_IF_REG_FAILS=1 IP_FAMILY=v4 BINDINGS=ip_nonip SHORT_SERVER_ID1=102 ; APN_NAME=carrier_apn2 APN_CLASS=3 BS_IF_REG_FAILS=0 IP_FAMILY=v4 BINDINGS=ip_nonip SHORT_SERVER_ID1=103 ; 2.5.1.3. lwm2m_cfg lwm2m_cfg is a LwM2M Client configuration file containing the following configuration information: Table 5: Items of lwm2m_cfg Parameter APN IP_FAMILY BINDINGS RETRY_TIMEOUT RETRY_EXPONENT_VAL Default value - v4 ip_nonip 30 2 Description Default APN to be used if carrier_apn_cfg is not available. Supported values: v4, v6, and v4v6. This is the default IP family chosen to connect to the server that does not have the IP family mentioned in carrier_apn_cfg. Supported values: ip, nonip and ip_nonip. This is the binding type to be chosen to specify whether the LwM2M Client can communicate over IP or non-IP. Initial time period (in seconds) to retry data-call if there is a data-call failure. Value by which timeout for data-call retry has to be increased exponentially. BG95&BG77&BG600L_Series_LwM2M_Application_Note 19 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note MAX_RETRY_TIMEOUT 640 MAX_NO_RETRIES 5 ACK_TIMEOUT 60 REG_RETRY_TIMEOUT 60 REG_RETRY_EXPONENT 2 REG_RETRY_MAXTIMEOUT 480 REG_UPDATE_ON_RECONNECT 0 ROAMING_FEAT 1 PER_REGSTATUS_FEAT 0 PER_BOOTSTRAP_FEAT 1 BATTERY_LEVEL_THRESHOLD 20 CARRIER_TYPE 0 Maximum time period (in seconds) for data-call retry. Maximum number of retry attempts in case of data-call failure. Sleep-ACK timeout value (in seconds). If there is no activity during the period, then the module goes to sleep. Initial time period (in seconds) to retry registration, if there is a registration failure. Value by which timeout for registration retry must be increased exponentially. Maximum time period in seconds for registration retry, if there is a registration failure. Determines whether a registration update must be sent on reconnections, such as during reboot with persistence-enabled or when IP address changes:  When set to 1, registration update is sent on reconnections.  When set to 0, registration update is not sent on reconnections. Determines LwM2M functionality enablement in roaming condition:  When set to 1, LwM2M functionality is disabled in roaming.  When set to 0, LwM2M functionality is enabled in roaming. Determines registration persistence across reboots in LwM2M Client:  When set to 1, registration persistence is enabled across reboots in the LwM2M Client.  When set to 0, registration persistence is disabled across reboots in the LwM2M Client. Determines the bootstrap persistence across reboots in the LwM2M client.  When set to 1, bootstrap persistence is enabled across reboots in the LwM2M client.  When set to 0, bootstrap persistence is disabled across reboots in the LwM2M client. Battery level less than the threshold mentioned in this configuration value would be considered as low battery by the client. Enables carrier specific functionality in the client: 0 Default BG95&BG77&BG600L_Series_LwM2M_Application_Note 20 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note REG_EP_NAME 4 BOOTSTRAP_EP_NAME 7 BOOT_UP_SLEEP_TIME GPS_MIN_INTERVAL 5 3000 GPS_MIN_DISTANCE MAX_NO_OF_ FACTORY_RESET_ PER_HOUR_BY_SMS MAX_NO_OF_ REG_UPDATE_ PER_HOUR_BY_SMS WAIT_TIME_TO_ TRIGGER_NEXT_ REG_CYCLE 1 1 1 86400 MAX_BOOTSTRAP_WAIT_TIME 0 ROOTCA_SUPPORT_MODE 0 SESSION_TIMEOUT 60 ENABLE_PSM 1 1 Verizon EP Name to be used during registration. See OMA specification Section 6.3.1 Endpoint Client Name for more details. Supported values are given below: 4 IMEI URN 7 IMEI MSISDN URN EP Name to be used during bootstrap. See OMA specification Section 6.3.1 Endpoint Client Name for more details. Supported values are given below: 4 IMEI URN 7 IMEI MSISDN URN Sleep time before LwM2M Client operation starts. The interval (in milliseconds) after which the GNSS information is fetched periodically. The change in distance (in meters) after which the GNSS information is fetched. Number of factory-reset operations per hour allowed by SMS transport. Number of registration update operations per hour allowed by SMS transport. Hold-off time (in seconds) to trigger the next registration on failure of all the registration attempts. This is the hold-off time in seconds where bootstrap procedure is kept on hold, meanwhile extended applications can register objects. Determines whether to use Root CA or domain issue certificate to validate certificate from the peer (bootstrap server and standard server) 0 To use domain issue certificate 3 To use Root CA Inactivity period (in seconds) after which resumption should be triggered for the uplink operation. It is recommended that OEMs configure the value to be the same as network address translation (NAT) timeout. Determines whether LwM2M enables the use of PSM. BG95&BG77&BG600L_Series_LwM2M_Application_Note 21 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note AWAKE_AFTER_PMIN STARTUP_MODE VERSION 0 Disable 1 Enable Determines whether the device must go to PSM for every Pmin cycle. 0 By default, the module wakes from Pmin till 0 Pmax. 1 The module goes to PSM for every Pmin cycle till Pmax limit. Determines whether the LwM2M initialization is through OEM application. 0 0 By default, LwM2M initialization is preloaded. 1 LwM2M initialization through AT commands or DAM application. Specifies the OMA specification version on which 1.0 the LwM2M Client is running. The following example provides an overview of the lwm2m_cfg file with the options explained in the table above: { APN=carrier_apn; RETRY_TIMEOUT=30; RETRY_EXPONENT_VAL=2; MAX_RETRY_TIMEOUT=640; MAX_NO_RETRIES=5; ACK_TIMEOUT=30; REG_RETRY_TIMEOUT=60; REG_RETRY_EXPONENT=2; REG_RETRY_MAXTIMEOUT=480; ROAMING_FEAT=1; PER_REGSTATUS_FEAT=0; BATTERY_LEVEL_THRESHOLD=20; CARRIER_TYPE=0; REG_EP_NAME=4; BOOTSTRAP_EP_NAME=7; BOOT_UP_SLEEP_TIME=10; STARTUP_MODE=0; VERSION=1.0; } 2.5.2. Security Mode (DTLS) Validate the following checkpoints when using pre-shared key security mode: BG95&BG77&BG600L_Series_LwM2M_Application_Note 22 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note  PSK files corresponding to bootstrap server or standard server must be present in /datatx/ssl.  Files should be in the format of _server.psk (e.g. 100_server.psk for bootstrap server).  Resource 0/x/2 decides the security mode. See Appendix E.1 of OMA specification for possible values. A typical PSK file used by the modules contains the following contents:  PSK Identity used with transactions with the LwM2M Server.  PSK Key used with transactions with the LwM2M Server. Here is an example for credentials required for transactions with the Nokia Motive Bootstrap Server. The Bootstrap PSK Identity structure is exactly as shown below: urn:imei-msisdn:- Example: urn:imei-msisdn:004402460030392-2234235569 The PSK Key used with the bootstrap server is defined as SHA2-256 Digest of the com.vzwm2m.com string. As shown below: PSK Key = SHA2(com.vzwm2m.com) = d6160c2e7c90399ee7d207a22611e3d3a87241b0462976b935341d000a91e747 Therefore, the content of PSK file 100_server.psk for Nokia Motive Bootstrap Server contents are as follows: |urn:imei-msisdn:004402460030392-2234235569|: d6160c2e7c90399ee7d207a22611e3d3a87241b0462976b935341d000a91e747 NOTE The LwM2M Client accepts any string value as PSK Identity used with transcation, but only hexadecimal value is used as PSK Key. BG95&BG77&BG600L_Series_LwM2M_Application_Note 23 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 3 LwM2M AT Commands 3.1. AT Command Syntax 3.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on the command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified.  Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . Throughout this document, only the commands and responses are presented, while carriage return and line feed characters are deliberately omitted. Table 6: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and to give information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_LwM2M_Application_Note 24 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 3.2. Description of LwM2M AT Commands A solution for configuring LwM2M Client with provisioning profiles is provided in Chapter 2.5. In this chapter, some AT commands are introduced to implement the LwM2M Client configuration. 3.2.1. AT+QLWCFG Configure LwM2M Client The command configures the parameters of LwM2M Client before connecting to the LwM2M Server. AT+QLWCFG Configure LwM2M Client Test Command AT+QLWCFG=? Response +QLWCFG: 'autostart',(list of supported s) +QLWCFG: 'pdpcid',(range of supported s),(range of supported s),(list of supported s) +QLWCFG: 'security',(range of supported s),(range of supported s),,(list of supported s),(list of supported s),, +QLWCFG: 'server',(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(list of supported s), +QLWCFG: 'epns',(list of supported s),, +QLWCFG: 'transcfg',(range of supported s),(range of supported s),(range of supported s) +QLWCFG: 'version',(list of supported s) +QLWCFG: 'select',(range of supported s),(list of supported s) +QLWCFG: 'host',(list of supported s),(range of supported s), +QLWCFG: 'device',,,,,, +QLWCFG: 'session',(range of supported s),(range of supported s) +QLWCFG: 'mbsps',,,,,, OK BG95&BG77&BG600L_Series_LwM2M_Application_Note 25 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Write Command Query/Set the startup mode of LwM2M Client. AT+QLWCFG='autostart'[,] Response If the optional parameter is omitted, this command queries the current setting. +QLWCFG: 'autostart', OK If the optional parameter is specified, this command sets the startup mode of LwM2M Client. OK Or ERROR Write Command Response Query/Set the APN profile for LwM2M If the optional parameters are omitted, this command queries data connection. the current setting. AT+QLWCFG='pdpcid'[,<client_ind +QLWCFG: 'pdpcid',,,,[,]] ss> OK Write Command Query/Set the resources of LwM2M security object. AT+QLWCFG='security'[,[,,,,[,,]]] If any of the optional parameters is specified, this command sets the APN profile for LwM2M data connection. OK Or ERROR Response If the optional parameters are omitted, this command queries the current setting. +QLWCFG: 'security',,,,, OK If only is specified and all other optional parameters are omitted, this command deletes the property data of the specified . OK If is specified and any of the other optional parameters is specified, this command sets the specified server property. OK Or ERROR BG95&BG77&BG600L_Series_LwM2M_Application_Note 26 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Write Command Query/Set the resources of LwM2M server object. AT+QLWCFG='server'[,[,,,,,,] Response If the optional parameters are omitted, this command queries the current setting. +QLWCFG: 'server',,,,,,, OK If only is specified and all other optional parameters are omitted, this command deletes the LwM2M server attributes of the specified : OK If is specified and any of the other optional parameters is specified, this command sets the LwM2M server attributes. OK Or ERROR Write Command Response Query/Set the endpoint name which If the optional parameters are omitted, this command queries indentifies the LwM2M Client on one the current setting. LwM2M Server. +QLWCFG: 'epns',,, AT+QLWCFG='epns'[,,,] OK Write Command Query/Set the parameters for bootstrap or registraion retry mechanism. AT+QLWCFG='transcfg'[,,,] If the optional parameters are specified, this command sets the endpoint name. OK Or ERROR Response If the optional parameters are omitted, this command queries the current setting. +QLWCFG: 'transcfg',,, OK If the optional parameters are specified, this command sets the parameters for bootstrap and registration retry mechanism. OK Or ERROR BG95&BG77&BG600L_Series_LwM2M_Application_Note 27 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Write Command Query/Set the version of LwM2M Client. AT+QLWCFG='version'[,] Response If the optional parameter is omitted, this command queries the current setting. +QLWCFG: 'version', OK If the optional parameter is specified, this command sets the version of LwM2M Client. OK Or ERROR Write Command Response Confugre/query the built-in LwM2M If the optional parameters are omitted, this command queries Server information, depending on the the current setting. server type specified. +QLWCFG: 'select',, AT+QLWCFG='select'[,[,]] OK Write Command Query/Set the resource of portfolio object. AT+QLWCFG='host', [,[,]] If any of the optional parameters is specifed, this command sets the built-in LwM2M Server information. OK Or ERROR Response If the optional parameters are omitted, this command queries the current setting of the specified . [+QLWCFG: 'host',,, [+QLWCFG: 'host',,, [...]]] If only is omitted, this command queries the current setting of specified and . OK Write Command Query/Set the resource of device object. AT+QLWCFG='device'[,<manufact If the optional parameters are specified, this command sets the resource of portfolio object. OK Or ERROR Response If the optional parameters are omitted, this command queries the current setting. +QLWCFG: 'device',,,,,,< sw_version>,,] ersion>,,, OK Write Command Query/Set the session lifetime. AT+QLWCFG='session'[,,] If the optional parameters are specified, this command sets the resource of device object. OK Or ERROR Response If the optional parameters are omitted, this command queries the current setting. +QLWCFG: 'session',, OK If the optional parameters are specified, this command sets the session lifetime. OK Or ERROR Write Command Response Query/Set the value of parameters If the optional parameters are omitted, this command queries required for LG U+ LwM2M Server the current setting. authentication. +QLWCFG: 'mbsps',,,,<I AT+QLWCFG='mbsps'[,,, ode>,,,,< model>,] OK Maximum Response Time Characteristics If the optional parameters are specified, this command sets the value of parameters required for LG U+ LwM2M Server authentication. OK Or ERROR 300 ms The command takes effect immediately. The configurations are saved automatically. Parameter Integer type. Enable or disable starting LwM2M automatically when the module powers on. BG95&BG77&BG600L_Series_LwM2M_Application_Note 29 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 0 Disable 1 Enable Integer type. LwM2M Client identifier. Range: 0–5. Integer type. PDP context ID of LwM2M Client. Range: 1–16. Default value: 1 Integer type. APN class associated with the APN. The list of supported APN class are 0, 2, 3, 6, 7, 10, 11. Default value: 2. Integer type. This identifier uniquely identifies each LwM2M Server configured for the LwM2M Client. Range: 1–65534. String type. LwM2M Server URI. The maximum length is 255 bytes. Integer type. LwM2M Bootstrap Server flag. 0 Standard LwM2M Server 1 LwM2M Bootstrap Server Integer type. Encryption method for UDP payload. 0 Pre-Shared Key mode 2 Certificate mode 3 No security mode String type. PSK identity. Only valid when =0. String type. PSK secret key. Only valid when =0. Integer type. Lifetime of the registration. Range: 0–2147483647. Default value: 0. Unit: second. Integer type. Minimum period of an Observation. Range: 0–2147483647. Default value: 0. Unit: second. Integer type. Maximum period of an Observation. Range: 0–2147483647. Default value: 0. Unit: second. Integer type. The interval to the next connection after disconnecting from the LwM2M Server. Range: 60–2147483647. Default value: 86400. Unit: second. Integer type. The LwM2M Client stores or discards 'Notify' operations to the LwM2M Server when the LwM2M Server account is disabled or the LwM2M Client is offline. 0 The LwM2M Client stores 'Notify' operations 1 The LwM2M Client discards 'Notify' operations String type. Transport binding mode configured for a LwM2M Client. See Table 7. Integer type. Format of endpoint client name. 0 String type. Specify the endpoint client name with string format directly. 1 Integer type. The value is one of the enumeration specified by the module. Endpoint client name for indentifying bootstrap server. The format is determined by . See Table 8. Endpoint client name for indentifying standard server. The format is determined by . See Table 8. Integer type. The timeout value for each bootstrap or registration retry upon a failure. Range: 0–2147483647. Default value: 60. Unit: second. Integer type. Value by which the timeout for bootstrap or registration retries must be increased exponentially. Range: 0–2147483647. Default value: 2. BG95&BG77&BG600L_Series_LwM2M_Application_Note 30 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Integer type. The maximum timeout value for all bootstrap or registration retries upon failures. Range: 0–2147483647. Default value: 480. Unit: second. Integer type. LwM2M protocol version. 0 LwM2M protocol version 1.0 1 LwM2M protocol version 1.1 Integer type. The built-in LwM2M Server details for network carrier. 0 Factory mode, used to reset all settings of current LwM2M Client 1 Verizon built-in LwM2M Server information 2 AT&T built-in LwM2M Server information 3 T-Mobile built-in LwM2M Server information 4 Telstra built-in LwM2M Server information 5 LG U+ built-in LwM2M Server information 6 NTT DoCoMo built-in LwM2M Server information. Interger type. Whether the proloaded LwM2M Server details is for commercial use. 0 Staging Server 1 Production Server Integer type. Instance ID of host device. Supported values are 0 and 1. Integer type. Resource ID associated with host device instance. 0 Host device ID 1 Host device manufacturer 2 Host device model number 3 Host device software version String type. Host device information. String type. Device manufacturer. String type. Device model number. String type. Device hardware version. String type. Device software version. String type. Device firmware version. String type. Device type name. Integer type. DTLS session lifetime. Range: 0–2147483647. Default value: 0. Unit: second. Integer type. DTLS session resumption timeout. Range: 0–86400. Default value: 86400. Unit: second. String type. Service code. String type. Device serial number, such as IMEI number. String type. MSISDN number. String type. ICCID number. String type. Device model name. String type. Device MAC address. BG95&BG77&BG600L_Series_LwM2M_Application_Note 31 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Table 7: Arguments of 'U' 'UQ' 'S' 'SQ' 'US' 'UQS' 'N' Description UDP. The LwM2M Server expects that the LwM2M Client is reachable via the UDP binding at any time. UDP with Queue Mode. The Server MUST queue all requests to the LwM2M Client, sending requests via UDP when the LwM2M Client is on-line. SMS. The LwM2M Server expects that the LwM2M Client is reachable via the SMS binding at any time. SMS with Queue Mode. The Server MUST queue all requests to the LwM2M Client, sending requests via SMS when the LwM2M Client is on-line. UDP and SMS. The LwM2M Server expects that the LwM2M Client is reachable via the UDP binding and SMS binding at any time. UDP with Queue Mode and SMS. The Server MUST queue all requests to the LwM2M Client, sending requests via UDP when the LwM2M Client is on-line. And the LwM2M Server expects that the LwM2M Client is reachable via the SMS binding at any time. Non-IP. The LwM2M Server MUST send requests to a LwM2M Client using the Non-IP binding. The LwM2M Client MUST send the response to such a request over the Non-IP binding. If =1, the valid values of and are listed as follows: Table 8: Arguments of and / 4 5 6 7 8 9 Description Identify a module using an International Mobile Equipment Identifier (see 3GPP TS 23.003). The IMEI URN specifies a valid, 15-digit IMEI. The format of the URN is 'urn:imei:'. Identify a module using an Electronic Serial Number. The ESN specifies a valid, 8-digit ESN. The format of the URN is 'urn:esn:'. Identify a module using a Mobile Equipment Identifier. The MEID URN specifies a valid, 14-digit MEID. The format of the URN is 'urn:meid:'. Identify a module using a combination of International Mobile Equipment Identifier (see 3GPP TS 23.003), and MSISDN. Both IMEI and MSISDN are 15 digits. The format of the URN is 'urn:imei-msisdn:-'. Identify a module using a combination of International Mobile Equipment Identifier (see 3GPP TS 23.003), and IMSI. Both IMEI and IMSI are 15 digits. The format of the URN is 'urn:imei-imsi:-'. Identify a module using a combination of International Mobile Equipment Identifier (see 3GPP TS 23.003), and IMSI. Both IMEI and IMSI are 15 digits. BG95&BG77&BG600L_Series_LwM2M_Application_Note 32 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note The format of the URN is 'imei-imsi:-'. NOTES 1. The LwM2M security and server objects should be initialized mandatorily before LwM2M Client startup. So AT+QLWCFG='security' must be executed before you configure the resource values of LwM2M Server object and parameters of LwM2M data session. 2. Transport binding mode 'N' is only supported under LwM2M V1.1 protocol version. 3.2.2. AT+QLWSVC Manage LwM2M Session The command operates LwM2M Client and handles the behavior of LwM2M session. AT+QLWSVC Manage LwM2M Session Test Command AT+QLWSVC=? Response +QLWSVC: 'reg',(list of supported s) +QLWSVC: 'dereg',(list of supported s) +QLWSVC: 'lifetime',(range of supported s),(range of supported s) +QLWSVC: 'update',(range of supported s),(list of supported s) +QLWSVC: 'state',(range of supported s) +QLWSVC: 'uldata',(range of supported s),,(range of supported s),,(list of supported s),(list of supported s) Write Command Initiate a registration with LwM2M Server. AT+QLWSVC='reg'[,] OK Response OK +QLWREG: If there is an error: +CME ERROR: Write Command Response Deregister a LwM2M Client from the OK LwM2M Server. AT+QLWSVC='dereg'[,] +QLWDEREG: If there is an error: ERROR BG95&BG77&BG600L_Series_LwM2M_Application_Note 33 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Write Command Query/Update the lifetime of a specific LwM2M Server. AT+QLWSVC='lifetime', [,] Response If the optional parameter is omitted, this command queries the lifetime value of a specific LwM2M server. +QLWSVC: 'lifetime',, OK If the optional parameter is specified, this command updates the lifetime of a specific LwM2M server. OK Or ERROR Write Command Response Send a registration update to a If the registration update message is sent successfully : specific LwM2M Server. OK AT+QLWSVC='update', [,] If there is any error: ERROR Write Command Response Query LwM2M Client registration +QLWSVC: 'state',,,,, AT+QLWSVC='state'[,] OK Write Command Response Send application data over LwM2M OK session. AT+QLWSVC='uldata',, If there is any error: ,,[,[,]] Maximum Response Time 300 ms Characteristics / Parameter Integer type. Registration mode. 0 LwM2M Client initiates 'registration' after the module reboots. 1 LwM2M Client initiates 'registration update' after the module reboots. Integer type. De-register method. 0 De-registration 1 Factory reset Integer type. This identifier uniquely identifies each LwM2M Server configured for BG95&BG77&BG600L_Series_LwM2M_Application_Note 34 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note the LwM2M Client. Range: 1–65534. Integer type. The lifetime of the registration. Range: 0–86400. Unit: second. Integer type. Whether the current registration update message contains an object list. 0 Send the registration update message with NULL payload. 1 Send the registration update message with object list. Integer type. LwM2M Client identifier. Range: 0–5. String type. LwM2M Server URI. Integer type. LwM2M Bootstrap Server flag. 0 Standard LwM2M Server 1 LwM2M Bootstrap Server Integer type. Registration state code of LwM2M Client. See in Chapter 3.3.1. String type. The format of URI is ///. Integer type. Length of the application data. Range: 1–1460. Unit: byte. String type. Application data to be sent. Integer type. Type of the application data. 0 String type. Send application data in string format. 1 Hexadecimal type. Send application data in hexadecimal format. Integer type. Message type of the application data to be sent. 0 Confirmable 1 Non-confirmable Integer type. 0 indicates a successfully operation. Other values indicate a failure. 0 Operation success 1 Operation failure 2 Invalid parameter 3 No memory 4 Failure as another parallel operation started 5 Operation is not allowed Integer type. Error code of AT command operation. 701 Unknown error 702 The command has been executed 703 Invalid parameter 704 LwM2M task is not initiated yet 705 The operation is not allowed 706 No memory NOTE If AT+QLWSVC='lifetime' is executed, a 'registration update' CoAP message containing lifetime value is sent to LwM2M Server. If the module fails to send this CoAP message or receives any response from LwM2M Server, the corresponding event notification in the format below is reported: +QLWURC: 'event',,, BG95&BG77&BG600L_Series_LwM2M_Application_Note 35 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note See Chapter 3.3.1 for details of the URC. 3.3. Description of LwM2M URCs The URCs of LwM2M AT commands are reported to the host when any internal event happens on LwM2M Client, including bootstrapping, registration, observation and incoming application data. 3.3.1. +QLWURC: 'event' LwM2M Client State Changing Notification This URC is reported when the LwM2M Client state is changed during bootstrapping or registering; for instance, when the lifetime of a specific LwM2M server is updated, or when you send a registration update to a specific LwM2M Server. +QLWURC: 'event' LwM2M Client State Changing Notification +QLWURC: 'event',,, Parameter Integer type. Uniquely identifies each LwM2M Server configured for the LwM2M Client. Range: 0–65534. The value 0 is only used for reporting 'GENERIC_FAILED' and 'FACTORY_RESET' related notification. Integer type. Current state code of LwM2M client. See Table 9. String type. A readable string associated with LwM2M Client current state code. See Table 9. Table 9: Arguments of and 0 1 2 3 4 Description INITIAL LwM2M Client not registered or bootstrap not started. REG_PENDING Registration pending. REG_READY Register with LwM2M Server successfully. REG_FAILED Last registration failed. UPDATE_PENDING Registration update pending due to LwM2M Client in sleep BG95&BG77&BG600L_Series_LwM2M_Application_Note 36 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note state. LwM2M Client in bootstrapping state due to hold-off timer is 5 FACTORY_RESET running. 6 BS_START LwM2M Client initiates bootstrap request. 7 BS_PENDING Bootstrap on going. LwM2M client is waitting for the pass-through object 8 BS_HOLDOFF initialization to complete and the 'bootstrap request' message has not yet been sent. 9 BS_FINISH Bootstrap finish. 10 BS_FAILED Bootstrap failed. Data call connection retrying on failure during registration 11 REG_CONN_RETRY phase. 12 REG_RETRY Registration retrying on failure. Data call connection retrying on failure during bootstrapping 13 BS_CONN_RETRY phase. 14 BS_RETRY Bootstrap retrying on failure. Generic error which are usually casued by invalid 15 GENERIC_FAILED parameters, populating endpoint name for bootstrap or registration failed and starting data call failed. 16 REG_UPDATE Send registration update successfully. 17 UPDATE_FAILED Send registration update failed. 18 DEREG_START Trigger deregister from LwM2M server. 19 DEREG_FINISH Deregister from LwM2M server successfully. 3.3.2. +QLWURC: 'observe' Observe Request Indication When the specific resources are observed by LwM2M Server, this URC is reported. +QLWURC: 'observe' Observe Request Indication +QLWURC: 'observe',,,, BG95&BG77&BG600L_Series_LwM2M_Application_Note 37 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note Parameter Integer type. This identifier uniquely identifies each LwM2M Server configured for the LwM2M Client. Range: 1–65534. String type. The URI path of Observe operation. The format of URI is ///. Integer type. Message ID of Observer CoAP message. Integer type. Token ID of Observe CoAP message. Integer type. Observe flag. 0 Observe 1 Cancel Observe 3.3.3. +QLWURC: 'uldata' Application Data Delivery Result Notification When the application data is sent in confirmable message type, this URC is reported after any response is got from the LwM2M Server. +QLWURC: 'uldata' Application Data Delivery Result Notification +QLWURC: 'uldata',,,,, Parameter Integer type. This identifier uniquely identifies each LwM2M Server configured for the LwM2M Client. Range: 1–65534. String type. The format of URI is ///. Integer type. Message ID of CoAP message. Integer type. Token ID of CoAP message. Integer type. Response code used to indicate the result of sending application data. 0 Sent application data with confirmable message type successfully -1 Received error response code from server -2 Received NULL response from server -3 Received unsupported or invalid response message from server 3.3.4. +QLWURC: 'recv' Incoming Data Indication When the LwM2M Client has received downlink data from the server, this URC is reported. BG95&BG77&BG600L_Series_LwM2M_Application_Note 38 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note +QLWURC: 'recv' Incoming Data Indication +QLWURC: 'recv',,,, Parameter String type. The format of URI is ///. Integer type. Content type of incoming downlink data. 4 Resource value type is string. 5 Resource value type is opaque. Integer type. Length of incoming downlink data. The maximum number of bytes that can be received at a time is 1024. Unit: byte. The incoming downlink data. BG95&BG77&BG600L_Series_LwM2M_Application_Note 39 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 4 Examples 4.1. Configure LwM2M Client with Provisioning Profiles 1) Use bootstrap.ini file to configure LwM2M security object and server object information for Leshan Server.  Factory Bootstrap (in Non-Secure mode) {'bn':'/0/1/', 'e':[ {'n':'0','sv':'coap://leshan.eclipseprojects.io:5683'}, {'n':'1','bv':false}, {'n':'2','v':3}, {'n':'10','v':102 }]} {'bn':'/1/1/', 'e':[ {'n':'0','v':102}, {'n':'1','v':50000}, {'n':'2','v':1}, {'n':'3','v':60}, {'n':'5','v':86400}, {'n':'6','bv':true}, {'n':'7','sv':'UQS' }]}  Factory Bootstrap (in Pre-Shared Key mode) {'bn':'/0/1/', 'e':[ {'n':'0','sv':'coaps://leshan.eclipseprojects.io:5684'}, {'n':'1','bv':false}, {'n':'2','v':3}, {'n':'10','v':102 }]} {'bn':'/1/1/', 'e':[ BG95&BG77&BG600L_Series_LwM2M_Application_Note 40 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note {'n':'0','v':102}, {'n':'1','v':50000}, {'n':'2','v':1}, {'n':'3','v':60}, {'n':'5','v':86400}, {'n':'6','bv':true}, {'n':'7','sv':'UQS' }]} An additional PSK key file need to be loaded into /datatx/ssl folder in the case of Pre-Shared Key mode. 2) Confirm with network carrier and configure proper APN and APN class in carrier_apn_cfg and lwm2m_cfg files. For details, see Chapter 2.5.1.2 and Chapter 2.5.1.3. 3) Put the auto startup script lwm2m_app_autostart into /datatx and reboot the module. When the module registers with Leshan Server successfully, the URCs listed below will be reported. +QLWURC: 'event',102,0,'INITIAL' +QLWURC: 'event',102,2,'REG_READY' 4.2. Configure LwM2M Client with AT Command 4.2.1. Configure in Client-Initiated Bootstrap Mode //Configure LwM2M security object with pre-shared key mode. AT+QLWCFG='security',0,111,'coaps://leshan.eclipseprojects.io:5784',1,0,'urn:imei:864475040 090705','313233343536373839' OK //Query the current resource value of LwM2M security object. AT+QLWCFG='security' +QLWCFG: 'security',0,101,'coaps://leshan.eclipseprojects.io:5784',1,0 OK AT+QLWCFG='server',0,60,0,50,60,1,'UQS' OK AT+QLWCFG='server' +QLWCFG: 'server',0,60,0,50,60,1,'UQS' //Configure the LwM2M Server object. OK AT+QLWSVC='reg' //Initiate a bootstrap request to the server. BG95&BG77&BG600L_Series_LwM2M_Application_Note 41 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note OK +QLWREG: 0 +QLWURC: 'event',111,6,'BS_START' +QLWURC: 'event',111,9,'BS_FINISH' +QLWURC: 'event',123,0,'INITIAL' +QLWURC: 'event',123,2,'REG_READY' //The LwM2M Client can only execute the following commands after registering with the server. AT+QLWSVC='lifetime',123,60 //Update the lifetime of registration to 60 s. OK +QLWURC: 'event',123,16,'REG_UPDATE' AT+QLWSVC='update',123,0 OK //Send 'registration update' message to LwM2M Server. If the module sleeps, execute this command to wake up the module. +QLWURC: 'event',123,16,'REG_UPDATE' //Modify 'Device Object' information for the host. AT+QLWCFG='device','Quectel','BG95-M3','R2.1','04','BG95M3LAR02A04','Quectel_BG95' OK AT+QLWSVC='dereg' //LwM2M Client de-registers from LwM2M Server. OK +QLWURC: 'event',123,19,'DEREG_FINISH' //LwM2M Client de-registers from server successfully. +QLWDEREG: 0 4.2.2. Configure in Factory Bootstrap Mode //Configure LwM2M security object in non-secure mode. AT+QLWCFG='security',0,100,'coap://leshan.eclipseprojects.io:5683',0,3 OK AT+QLWCFG='server',0,60,0,50,60,1,'UQS' //Configure LwM2M Server object. OK AT+QLWSVC='reg' //Initiate a registration request to the server. OK BG95&BG77&BG600L_Series_LwM2M_Application_Note 42 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note +QLWREG: 0 +QLWURC: 'event',100,0,'INITIAL' +QLWURC: 'event',100,2,'REG_READY' //The LwM2M Client can only execute the following commands after registering with the server. AT+QLWSVC='lifetime',100,60 //Update the lifetime of registration to 60 s. OK +QLWURC: 'event',100,16,'REG_UPDATE' AT+QLWSVC='update',100,0 OK //Send 'registration update' message to LwM2M Server, If the module sleeps, execute this command to wake up the module. +QLWURC: 'event',100,16,'REG_UPDATE' AT+QLWSVC='dereg',1 OK //Factory reset +QLWURC: 'event',0,5,'FACTORY_RESET' +QLWURC: 'event',100,18,'DEREG_START' +QLWURC: 'event',100,19,'DEREG_FINISH' +QLWDEREG: 0 BG95&BG77&BG600L_Series_LwM2M_Application_Note 43 / 45 LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note 5 Appendix A References Table 10: Related Documents SN Document Name Remark [1] OMA-TS-LightweightM2M-V1_0-20170208-A OMA Lightweight Machine to Machine Technical Specification [2] OMA-AD-LightweightM2M-V1_0-20170208-A OMA Lightweight Machine to Machine Architecture OMA Lightweight Machine to Machine [3] OMA-TS-LightweightM2M_Core-V1_1_1-20190617-A Technical Specification Table 11: Terms and Abbreviations Abbreviation ACK ACL APN APPS CoAP DAM DFOTA DTLS EFS EP FOTA GNSS HTTP(S) ICCID Description Acknowledgement Access Control List Access Point Name Application Subsystem Constrained Application Protocol Downloadable Application Module Delta Firmware Upgrade Over-The-Air Datagram Transport Layer Security Embedded File System Endpoint Firmware Over-The-Air Global Navigation Satellite System Hypertext Transfer Protocol (Secure) Integrated Circuit Card Identifier BG95&BG77&BG600L_Series_LwM2M_Application_Note 44 / 45 IMEI IoT IPv4 IPv6 JSON LwM2M MAC MSISDN NAT OEM OMA PDN PDP Pmax Pmin PSK PSM QMI SBL SenML SMS SSID SSL UDP UI URC URI URN LPWA Module Series BG95&BG77&BG600L Series LwM2M Application Note International Mobile Equipment Identity Internet of Things Internet Protocol version 4 Internet Protocol version 6 JavaScript Object Notation Lightweight Machine to Machine Medium Access Control Mobile Subscriber Integrated Services Digital Network Network Address Translation Original Equipment Manufacturer Open Mobile Alliance Public Data Network Packet Data Protocol Maximum Period Minimum Period Pre-Shared Key Power Saving Mode Qualcomm Message Interface Secondary Boot Loader Sensor Measurement Lists Short Message Service Service Set Identifier Secure Sockets Layer User Datagram Protocol User Interface Unsolicited Result Code Uniform Resource Identifier Uniform Resource Name BG95&BG77&BG600L_Series_LwM2M_Application_Note 45 / 45

BG95&BG77&BG600L Series CoAP Application Note LPWA Module Series Version: 1.0 Date: 2021-03-04 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_CoAP_Application_Note 1 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Copyright The information contained here is proprietary technical information of Quectel. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2021. All rights reserved. BG95&BG77&BG600L_Series_CoAP_Application_Note 2 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note About the Document Revision History Version 1.0 Date 2020-01-10 2021-03-04 Author Sherlock ZHAO/ Terrence YANG Sherlock ZHAO/ Terrence YANG Description Creation of the document First official release BG95&BG77&BG600L_Series_CoAP_Application_Note 3 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 2 General Overview of CoAP ................................................................................................................ 7 3 Description of CoAP AT Commands ................................................................................................ 8 3.1. AT Command Syntax ................................................................................................................. 8 3.1.1. Definitions........................................................................................................................ 8 3.1.2. AT Command Syntax ...................................................................................................... 8 3.2. Declaration of AT Command Examples..................................................................................... 9 3.3. Description of CoAP AT Commands ......................................................................................... 9 3.3.1. AT+QCOAPCFG Configure Optional Parameters of CoAP Client .............................. 9 3.3.2. AT+QCOAPOPEN Create a CoAP Session .............................................................. 11 3.3.3. AT+QCOAPCLOSE Disconnect from CoAP Server .................................................. 12 3.3.4. AT+QCOAPHEADER Configure CoAP Message Header......................................... 12 3.3.5. AT+QCOAPOPTION Configure CoAP Message Options ......................................... 13 3.3.6. AT+QCOAPSEND Send CoAP Message .................................................................. 15 3.4. Description of CoAP URCs ...................................................................................................... 18 3.4.1. +QCOAPRECV Indicating Incoming CoAP Message ................................................ 18 3.4.2. +QCOAPACK Indicating Delivery Result of CoAP Message..................................... 19 3.4.3. +QCOAPIND Notifying Retransmission Result.......................................................... 19 4 Summary of Result Codes ............................................................................................................... 21 5 Examples ........................................................................................................................................... 22 5.1. CoAP Client Operation without DTLS ...................................................................................... 22 5.2. CoAP Client Operation with DTLS ........................................................................................... 23 6 Appendix A References.................................................................................................................... 25 BG95&BG77&BG600L_Series_CoAP_Application_Note 4 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Table Index Table 1: Applicable Modules ........................................................................................................................ 6 Table 2: Types of AT Commands ................................................................................................................ 8 Table 3: Option Definitions ......................................................................................................................... 14 Table 4: and Definitions ........................................................................................ 16 Table 5: Description of Codes...................................................................................................... 21 Table 6: Related Documents...................................................................................................................... 25 Table 7: Terms and Abbreviations ............................................................................................................. 25 BG95&BG77&BG600L_Series_CoAP_Application_Note 5 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 1 Introduction This document introduces how to use the CoAP feature on Quectel BG95 series, BG77 and BG600L-M3 modules through AT commands. 1.1. Applicable Modules Table 1: Applicable Modules Module Series BG95 BG77 BG600L Model BG95-M1 BG95-M2 BG95-M3 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS NOTE See the firmware release notes of corresponding module models to check whether the function has been supported. BG95&BG77&BG600L_Series_CoAP_Application_Note 6 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 2 General Overview of CoAP The Constrained Application Protocol (CoAP) is a specialized web transfer protocol for use with constrained nodes and constrained (e.g., low-power, lossy) networks. The protocol is designed for machine-to-machine (M2M) applications such as smart energy and building automation. CoAP provides a request/response interaction model between application endpoints, supports built-in discovery of services and resources, and includes key concepts of the Web such as URIs and Internet media types. CoAP is designed to easily interface with HTTP for integration with the Web while meeting specialized requirements such as multicast support, very low overhead, and simplicity for constrained environments. This chapter gives the data interaction mechanism of CoAP feature. MCU Modem Configure CoAP Context AT+QCOAPCFG='pdpcid',, AT+QCOAPCFG='dtls',,[,] AT+QCOAPCFG='trans',,, Create CoAP Session AT+QCOAPOPEN=,, DTLS Handshake +QCOAPOPEN: , CoAP Server UDP connetion Client Hello Finished Configure CoAP Message(header and options) AT+QCOAPHEADER=,,[,,] AT+QCOAPOPTION=,,[,] Send Specific CoAP Message AT+QCOAPSEND=,,,[,] CoAP non-confirmable message +QCOAPACK: ,,, CoAP confirmable message CoAP ACK AT+QCOAPSEND=,,,,[,] CoAP confirmable message +QCOAPIND: ,,,1, CoAP Retransmission 1(No ACK) CoAP Retransmission N +QCOAPIND: ,,,N, CoAP ACK Receive CoAP Message from Server Close CoAP Session +QCOAPRECV: ,,,,,[,,...],rn[] AT+QCOAPCLOSE= +QCOAPCLOSE:, Downlink CoAP Message UDP or DTLS Disconnection CoAP Retransmission Figure 1: CoAP Data Interaction Diagram BG95&BG77&BG600L_Series_CoAP_Application_Note 7 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 3 Description of CoAP AT Commands 3.1. AT Command Syntax 3.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on the command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified.  Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . Throughout this document, only the commands and responses are presented, while carriage return and line feed characters are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and to give information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_CoAP_Application_Note 8 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 3.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you familiarize with AT commands and learn how to use them. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. 3.3. Description of CoAP AT Commands 3.3.1. AT+QCOAPCFG Configure Optional Parameters of CoAP Client This command configures optional parameters of a CoAP client. AT+QCOAPCFG Configure Optional Parameters of CoAP Client Test Command AT+QCOAPCFG=? Response +QCOAPCFG: 'pdpcid',(range of supported s),(range of supported s) +QCOAPCFG: 'dtls',(range of supported s),(list of supported s),(range of supported s) +QCOAPCFG: 'trans',(range of supported s),(range of supported s),(range of supported s) Write Command Query/Set the PDP context for a specified CoAP client. AT+QCOAPCFG='pdpcid',[, ] OK Response If the optional parameter is omitted, query the current setting: +QCOAPCFG: 'pdpcid', OK If the optional parameter is specified, set the PDP context of the specified CoAP client: OK If there is any error: ERROR Write Command Response Query/Set the DTLS mode for a If the optional parameters are omitted, query the current BG95&BG77&BG600L_Series_CoAP_Application_Note 9 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note specified CoAP client. AT+QCOAPCFG='dtls',[,[,]] setting: +QCOAPCFG: 'dtls',[,] OK If the optional parameters are specified, set the DTLS mode for the specified CoAP client: OK If there is any error: ERROR Write Command Response Query/Set retransmission settings for a If the optional parameters are omitted, query the current specified CoAP client. setting: AT+QCOAPCFG='trans',[,<t +QCOAPCFG: 'trans',, imeout>,] OK If the optional parameters are specified, set the retransmission settings for the specified CoAP client: OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The commands take effect immediately. The configurations are not saved. Parameter Integer type. CoAP client identifier. Range: 0–5. Integer type. The PDP context ID used by CoAP client. Range: 1–16. Default value: 1. Integer type. Whether to enable DTLS mode for CoAP client. 0 Use normal UDP connection for CoAP client 1 Use DTLS connection for CoAP client Integer type. DTLS context identifier. Range: 0–5. Integer type. The acknowledgement timeout of CoAP confirmable message delivery. Range: 2–60. Default value: 2. Unit: second. Integer type. The maximum retransmission counts of CoAP confirmable message delivery. Range: 4–8. Default value: 5. BG95&BG77&BG600L_Series_CoAP_Application_Note 10 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note NOTE If DTLS mode is enabled for a CoAP session, the PSK file named _server.psk should be uploaded to UFS with AT+QFUPL (see document [2] for details), and the content of the file shoud be in the format of '&'. CoAP client uses this PSK file for establishing DTLS session. 3.3.2. AT+QCOAPOPEN Create a CoAP Session This command creates a CoAP session. AT+QCOAPOPEN Create a CoAP Session Test Command AT+QCOAPOPEN=? Response +QCOAPOPEN: (range of supported s),,(range of supported s) Read Command AT+QCOAPOPEN? OK Response [+QCOAPOPEN: ,,,] Write Command Configure and connect to a specified CoAP server: AT+QCOAPOPEN=,, OK Response OK +QCOAPOPEN: , If there is any error: ERROR Maximum Response Time 75 s, determined by network Characteristics / Parameter Integer type. CoAP client identifier. Range: 0–5. String type. Address of CoAP server. It can be an IP address or a domain name. Maximum size: 255 bytes. Integer type. Port of CoAP server. Range: 1–65535. Integer type. Current status of the specified CoAP client. 0 Idle state or connection disconnected. 1 CoAP client is opening. BG95&BG77&BG600L_Series_CoAP_Application_Note 11 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 2 CoAP client is connecting to the CoAP server. 3 CoAP client is connected. 4 CoAP connection is disconnecting. Integer type. Result of the command execution. See Chapter 4 for details. 3.3.3. AT+QCOAPCLOSE Disconnect from CoAP Server This command disconnects a client from the CoAP server. AT+QCOAPCLOSE Disconnect from CoAP Server Test Command AT+QCOAPCLOSE=? Response +QCOAPCLOSE: (range of supported s) Write Command AT+QCOAPCLOSE= OK Response OK +QCOAPCLOSE: , Maximum Response Time Characteristics If there is any error: ERROR 75 s, determined by network / Parameter Integer type. CoAP client identifier. Range: 0–5. Integer type. Result of the command execution. See Chapter 4 for details. 3.3.4. AT+QCOAPHEADER Configure CoAP Message Header This command configures the header of a CoAP message. AT+QCOAPHEADER Configure CoAP Message Header Test Command AT+QCOAPHEADER=? Response +QCOAPHEADER: (range of supported s), (range of supported s),(list of supported s),(range of supported s), OK BG95&BG77&BG600L_Series_CoAP_Application_Note 12 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Write Command AT+QCOAPHEADER=, ,[,,] Response OK If there is any error: ERROR Maximum Response Time 300 ms Characteristics / Parameter Integer type. CoAP client identifier. Range: 0–5. 16-bit unsigned integer in network byte order. Message ID. Used to detect message duplication and to match messages of type Acknowledgement/Reset to messages of type Confirmable/Non-confirmable. Range: 0–65535. Integer type. Whether to generate token value automatically. 0 Do not generate token value automatically. 1 Generate token value automatically. 4-bit unsigned integer. The length of the variable-length field. Range: 0–8. Unit: bytes. Only valid when =0. Hex string type. Token value of CoAP message. Only valid when =0. 3.3.5. AT+QCOAPOPTION Configure CoAP Message Options This command configures the options of a CoAP message. AT+QCOAPOPTION Configure CoAP Message Options Test Command AT+QCOAPOPTION=? Response +QCOAPOPTION: (range of supported s),(list of supported s),(range of supported s),, Write Command AT+QCOAPOPTION=,,[,,] OK Response OK If there is any error: ERROR Maximum Response Time 300 ms Characteristics / BG95&BG77&BG600L_Series_CoAP_Application_Note 13 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Parameter Integer type. CoAP client identifier. Range: 0–5. Integer type. The operation mode of this command. 0 Add a new option for CoAP message 1 Remove an existing option from CoAP message Integer type. Index of the option to be added/deleted. Range: 0–7. Integer type. Option number. Only valid when =0. The individual CoAP options are summarized and explained in RFC 7252 section 5.10. Option Number Option Name 1 If-Match 3 Uri-Host 4 ETag 5 If-None-Match 7 Uri-Port 8 Location-Path 11 Uri-Path 12 Content-Format 14 Max-Age 15 Uri-Query 17 Accept 20 Location-Query 35 Proxy-Uri 39 Proxy-Scheme 60 Size1 Option value that corresponds to each option number. Only valid when =0. See Table 3 for details such as format and length of this parameter. Table 3: Option Definitions Option Number Option Name 1 If-Match 3 Uri-Host 4 ETag 5 If-None-Match 7 Uri-Port 8 Location-Path Option Value Format opaque string opaque empty unsigned integer string Option Value Length (Bytes) 0–8 1–255 1–8 0 0–2 0–255 BG95&BG77&BG600L_Series_CoAP_Application_Note 14 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 11 Uri-Path string 0–255 12 Content-Format unsigned integer 0–2 14 Max-Age unsigned integer 0–4 15 Uri-Query string 0–255 17 Accept unsigned integer 0–2 20 Location-Query string 0–255 35 Proxy-Uri string 1–1034 39 Proxy-Scheme string 1–255 60 Size1 unsigned integer 0–4 3.3.6. AT+QCOAPSEND Send CoAP Message This command sends a CoAP message. After you input the payload with a specified length, the command first serializes the input data to a CoAP packet and then sends it to the CoAP server. AT+QCOAPSEND Send CoAP Message Test Command AT+QCOAPSEND=? Response +QCOAPSEND: (range of supported s),(range of supported s),,,(range of supported s) Write Command AT+QCOAPSEND=,,< code_value>,[,] OK Response > After > is returned, input the data to be sent. Tap Ctrl + Z to send the data, or tap Esc to cancel the operation. OK +QCOAPACK: ,,, Maximum Response Time Characteristics If there is any error: ERROR 300 ms / BG95&BG77&BG600L_Series_CoAP_Application_Note 15 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Parameter Integer type. CoAP client identifier. Range: 0–5. Integer type. The CoAP message type. 0 Confirmable (CON) 1 Non-confirmable (NON) 2 Acknowledgement 3 Reset Integer type. Request or response code value. See Table 4 for details. Integer type. Currently options can be preset in CoAP client by AT+QCOAPOPTIOIN. If any bit in the bitmask of this parameter is set to 1, the corresponding option will be added to a CoAP packet. Value Bitmask Description 0 00000000 No option is added to the CoAP packet 1 00000001 Add the option of option index 0 to the CoAP packet 2 00000010 Add the option of option index 1 to the CoAP packet 3 00000011 Add options of option index 0 and 1 to the CoAP packet 4 00000100 Add the option of option index 3 to the CoAP packet 5 00000101 Add options of option index 0 and 3 to the CoAP packet ... 253 11111101 Add options of option index 0 and 2–7 to the CoAP packet 254 11111110 Add options of option index 1–7 to the CoAP packet 255 11111111 Add options of option index 0–7 to the CoAP packet Integer type. The length of the data to be sent. Maximum length: 1024 bytes. If this parameter is omitted, data of any length but not exceeding 1024 bytes can be input. 16-bit unsigned integer in network byte order. Message ID. Used to detect message duplication and to match messages of type Acknowledgement/Reset to messages of type Confirmable/Non-confirmable. Range: 0–65535. Integer type. Result of the command execution. See Chapter 4 for details. Table 4: and Definitions Description 0 0.00 Empty message. GET. The GET method retrieves a representation for the information that 1 0.01 currently corresponds to the resource identified by the request URI. POST. The POST method requests that the representation enclosed in 2 0.02 the request be processed. PUT. The PUT method requests that the resource identified by the 3 0.03 request URI be updated or created with the enclosed representation. BG95&BG77&BG600L_Series_CoAP_Application_Note 16 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note DELETE. The DELETE method requests that the resource identified by 4 0.04 the request URI be deleted. Created. Like HTTP 201 'Created', but only used in response to POST 65 2.01 and PUT requests. The payload returned with the response, if any, is a representation of the action result. Deleted. This Response Code is like HTTP 204 'No Content' but only used in response to requests that cause the resource to cease being 66 2.02 available, such as DELETE and, in certain circumstances, POST. The payload returned with the response, if any, is a representation of the action result. Valid. This Response Code is related to HTTP 304 'Not Modified' but only 67 2.03 used to indicate that the response identified by the entity-tag identified by the included ETag Option is valid. Changed. This Response Code is like HTTP 204 'No Content' but only 68 2.04 used in response to POST and PUT requests. The payload returned with the response, if any, is a representation of the action result. Content. This Response Code is like HTTP 200 'OK' but only used in 69 2.05 response to GET requests. 128 4.00 Bad request. Unauthorized. The client is not authorized to perform the requested 129 4.01 action. Bad option. The request could not be understood by the server due to one 130 4.02 or more unrecognized or malformed options. 131 4.03 Forbidden. 132 4.04 Not found. 133 4.05 Method not allowed. 134 4.06 Not acceptable. 140 4.12 Precondition failed. 141 4.13 Request entity too large. 143 4.15 Unsupported Content-Format. 160 5.00 Internal server error. 161 5.01 Not implemented. 162 5.02 Bad gateway. 163 5.03 Service unavailable. BG95&BG77&BG600L_Series_CoAP_Application_Note 17 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 164 5.04 Gateway timeout. Proxying not supported. The server is unable or unwilling to act as a 165 5.05 forward-proxy for the URI specified in the Proxy-Uri Option or using Proxy-Scheme. NOTES 1. is an 8-bit unsigned integer, split into a 3-bit class (most significant bits) and a 5-bit detail (least significant bits), documented as 'c.dd' where 'c' is a digit from 0 to 7 for the 3-bit subfield and 'dd' are two digits from 00 to 31 for the 5-bit subfield. The class can indicate a request (0), a success response (2), a client error response (4), or a server error response (5). (All other class values are reserved.) As a special case, Code 0.00 indicates an Empty message. 2. When is c.dd, = c × 32 + dd. 3.4. Description of CoAP URCs CoAP URCs are reported to the host when a CoAP Client is in registration, observation or application data transmission procedure. 3.4.1. +QCOAPRECV Indicating Incoming CoAP Message This URC is reported when CoAP client receives downlink CoAP message from remote CoAP server. +QCOAPRECV Indicates Incoming CoAP Message +QCOAPRECV: ,,,,,[,,…], This URC is reported when there is a new CoAP message received from CoAP server. Parameter Integer type. The CoAP client identifier. 16-bit unsigned integer in network byte order. Message ID. Response code of incoming message. The format is 'c.dd'. See Table 4 for details. Integer type. The length of a variable-length token field. Token value of a CoAP message. Number of options included in the CoAP message. Option number. BG95&BG77&BG600L_Series_CoAP_Application_Note 18 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Option value that corresponds to the option number. Payload length of incoming CoAP message. Payload data. 3.4.2. +QCOAPACK Indicating Delivery Result of CoAP Message If a CoAP message is sent, the client needs an acknowledgement message from the server.  If a confirmable message is delivered, this URC indicates whether the message has been acknowledged by the server.  If a non-confirmable, acknowledgement or reset message is delivered, this URC indicates whether the message has been sent. +QCOAPACK Indicating Delivery Result of CoAP Message +QCOAPACK: ,,, message has been sent or acknowledged by the server. Parameter Integer type. CoAP client identifier. Range: 0–5. Integer type. The CoAP message type. 0 Confirmable 1 Non-confirmable 2 Acknowledgement 3 Reset 16-bit unsigned integer in network byte order. Message ID. Integer type. Result of CoAP message delivery. See Chapter 4 for details. 3.4.3. +QCOAPIND Notifying Retransmission Result This URC is reported to notify the retransmission result when a client retransmits a confirmable message that is not acknowledged by the server. +QCOAPIND Notifying Retransmission Result +QCOAPIND: ,,,, CoAP confirmable message. Parameter Integer type. CoAP client identifier. Range: 0–5. Integer type. The CoAP message type. BG95&BG77&BG600L_Series_CoAP_Application_Note 19 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 0 Confirmable 16-bit unsigned integer in network byte order. Message ID. Integer type. Retransmission count after sending a confirmable message. The maximum retransmission count is configured by AT+QCOAPCFG='trans'. Integer type. Result of retransmission. See Chapter 4 for details. BG95&BG77&BG600L_Series_CoAP_Application_Note 20 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 4 Summary of Result Codes The following table lists some of the general result codes. Table 5: Description of Codes Code of 0 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 Meaning Operation successful Invalid parameter Operation in processing Operation not allowed Network failure DNS error Data call activating Socket connection failure Out of memory error DTLS handshaking failure CoAP client identifier occupied Data sending failure BG95&BG77&BG600L_Series_CoAP_Application_Note 21 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 5 Examples 5.1. CoAP Client Operation without DTLS AT+QCOAPCFG='pdpcid',0,1 //Set the PDP context ID as 1 for CoAP client 0. OK AT+QCOAPCFG='trans',0,4,5 //Configure retransmission settings for CoAP client 0. (The ACK timeout is 4 seconds and the maximum retransmission count is 5.) OK AT+QCOAPOPEN=0,'220.180.239.212',8028 //Create a CoAP session and connect to the CoAP server. OK +QCOAPOPEN: 0,0 //Created the CoAP session successfully. AT+QCOAPOPEN? //Query the current status of the CoAP session. +QCOAPOPEN: 0,'220.180.239.212',8028,3 OK //Set CoAP message header. AT+QCOAPHEADER=0,1234,1 OK //Set CoAP message ID to 1234 and generate token automatically. //Add CoAP options. AT+QCOAPOPTION=0,0,0,11,'19'//Add an option (option number: 11, corresponding to option name of Uri-Path; option value: '19') to option index 0. OK AT+QCOAPOPTION=0,0,1,12,40 //Add an option (option number: 12, corresponding to option name of Content-Format; option value: 40, corresponding to media type of application/link-format) to option index 1. OK AT+QCOAPSEND=0,1,2,1,20 >Hello, CoAP Message! OK //Send 20 bytes CoAP non-confirmable message to the server. +COAPACK: 0,1,1234,0 //Receive downlink error message from server side. BG95&BG77&BG600L_Series_CoAP_Application_Note 22 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note +QCOAPRECV: 0,1234,4.04,6,D204D52E814B,0,9 Not Found AT+QCOAPCLOSE=0 OK //Close the CoAP session. +QCOAPCLOSE: 0,0 //Closed the CoAP session successfully. 5.2. CoAP Client Operation with DTLS AT+QCOAPCFG='pdpcid',0,1 //Set the PDP context ID as 1 for CoAP client 0. OK AT+QCOAPCFG='trans',0,4,5 //Configure retransmission settings for CoAP client 0. (The ACK timeout is 4 seconds and the maximum retransmission count is 5.) OK AT+QCOAPCFG='dtls',0,1,0 //Enable DTLS mode for CoAP client 0. OK AT+QSSLCFG='dtls',0,1 //Set DTLS mode (enable DTLS feature). OK AT+QSSLCFG='dtlsversion',0,1 //Configure DTLS1.2 for CoAP session OK AT+QFUPL='UFS:0_server.psk',34 //Upload the PSK file for DTLS session to UFS. CONNECT 864508030012428&313233343446473839 //Input the content of the PSK file. +QFUPL: 34,2802 OK AT+QCOAPOPEN=0,'leshan.eclipseprojects.io',5684 //Create a CoAP session and connect to the CoAP server. OK +QCOAPOPEN: 0,0 //Created the CoAP session successfully. //Set CoAP message header. AT+QCOAPHEADER=0,1234,1 OK //Set CoAP message ID to 1234 and generate token automatically. //Add CoAP options. AT+QCOAPOPTION=0,0,0,11,'19'//Add an option (option number: 11, corresponding to option name of Uri-Path; option value: '19') to option index 0. OK AT+QCOAPOPTION=0,0,1,12,40 //Add an option (option number: 12, corresponding to option name of Content-Format; option value: 40, corresponding to media type of application/link-format) to option index 1. BG95&BG77&BG600L_Series_CoAP_Application_Note 23 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note OK AT+QCOAPSEND=0,1,2,1,20 >Hello, CoAP Message! OK //Send 20 bytes CoAP non-confirmable message to the server. +COAPACK: 0,1,1234,0 //Receive downlink error message from server side. +QCOAPRECV: 0,1234,4.04,6,D204D52E814B,0,9 Not Found AT+QCOAPCLOSE=0 //Close the CoAP session. OK +QCOAPCLOSE: 0,0 //Closed the CoAP session successfully. BG95&BG77&BG600L_Series_CoAP_Application_Note 24 / 26 LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note 6 Appendix A References Table 6: Related Documents SN Document Name Description RFC 7252 The Constrained Application Protocol This document is a product of the Internet [1] (CoAP) Engineering Task Force (IETF). Quectel_BG95&BG77&BG600L_Series_FILE_ FILE application note for BG95 series, BG77 [2] Application_Note and BG600L-M3 modules Table 7: Terms and Abbreviations Abbreviation ACK CoAP DTLS EGPRS HTTP(S) ID LPWA M2M MCU PDP PSK UDP UFS URC URI Description Acknowledgement Constrained Application Protocol Datagram Transport Layer Security Enhanced General Packet Radio Service Hypertext Transfer Protocol (Secure) Identifier Low-Power Wide-Area Machine to Machine Microcontroller Unit Packet Data Protocol Pre-Shared Key User Datagram Protocol User File System Unsolicited Result Code Uniform Resource Identifier BG95&BG77&BG600L_Series_CoAP_Application_Note 25 / 26 TA Wi-Fi LPWA Module Series BG95&BG77&BG600L Series CoAP Application Note Terminal Adapter Wireless Fidelity BG95&BG77&BG600L_Series_CoAP_Application_Note 26 / 26

BC20 重要注意事项及常见问题 NB-IoT 模块系列 版本：BC20_重要注意事项及常见问题_V1.0 日期：2019-08-19 状态：受控文件 www.quectel.com BC20 重要注意事项及常见问题 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 21 BC20 重要注意事项及常见问题 文档历史 修订记录 版本 1.0 日期 2019-08-19 作者 变更表述 董海波/刘伟/ 初始版本 魏大成 上海移远通信技术股份有限公司 2 / 21 BC20 重要注意事项及常见问题 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 2 重要注意事项.......................................................................................................................................... 6 2.1. 不支持 USIM 卡热插拔 ................................................................................................................ 6 2.2. APN/PDN 配置 ............................................................................................................................ 6 2.3. 模块工作模式............................................................................................................................... 7 2.3.1. 模块工作状态概述............................................................................................................... 7 2.3.2. 影响模块进入深休眠的因素 ................................................................................................ 8 2.3.3. 模块可以进入深休眠的场景 ................................................................................................ 8 2.4. 模块 IMEI 与 SN 号...................................................................................................................... 8 2.5. AT+EPORT 命令 ......................................................................................................................... 8 2.6. 自适应波特率............................................................................................................................... 9 2.7. 关于时间同步............................................................................................................................... 9 3 常见问题答疑........................................................................................................................................ 10 3.1. 软件相关常见问题 ..................................................................................................................... 10 3.2. 硬件相关常见问题 ..................................................................................................................... 13 3.2.1. NB 部分 ............................................................................................................................ 13 3.2.2. GNSS 部分 ....................................................................................................................... 15 4 附录 A 深休眠模式下模块引脚状态...................................................................................................... 17 5 附录 B 术语缩写 ................................................................................................................................... 20 上海移远通信技术股份有限公司 3 / 21 BC20 重要注意事项及常见问题 表格索引 表 1：深休眠（DEEP SLEEP）模式下 BC20 模块的引脚状态 ......................................................................... 17 表 2：术语缩写 .................................................................................................................................................. 20 上海移远通信技术股份有限公司 4 / 21 BC20 重要注意事项及常见问题 1 引言 本文档主要介绍了移远通信 BC20 模块使用过程中的重要注意事项，并对常见问题进行了解答。 上海移远通信技术股份有限公司 5 / 21 BC20 重要注意事项及常见问题 2 重要注意事项 2.1. 不支持 USIM 卡热插拔 目前模块不支持 USIM 卡热插拔，因此在带电插拔 USIM 卡时会出现各种异常的情况，请注意不要进 行此类操作。如果意外出现此类情况，如掉卡时，MCU 在检测到掉卡时会上报+CPIN: NOT READY，随 后用户可尝试重启或者通过 AT+CFUN 命令切换模块状态以重新找卡。 备注 本文所提及的全部 AT 命令，若无特别说明，请参考 Quectel_BC20_AT_Commands_Manual 以了解详情。 2.2. APN/PDN 配置 目前国内运营商都支持 MME 自动修正 APN，因此配置不正确的 APN 也能接入；但仍不建议随意配置， 因为运营商不同的 APN 会配置不同的网络参数，这将影响 T3324/T3412 的值，进而影响终端的功耗。但 PDN Type 配置错误，将导致不能入网。 请参考如下 AT 命令配置 APN，该命令仅对默认激活的 PDN 有效（开机自动激活），其他多路 PDN 的 配置请使用 AT+CGDCONT/AT+QGACT 命令。 //配置 APN 举例 AT+QCGDEFCONT? +QCGDEFCONT: 'IP','ims' //查询模块当前的 APN 设置 //采用 IPV4，APN 为 ims OK AT+QCGDEFCONT='IP','' OK //设置 APN 为空，即使用默认 APN。 上海移远通信技术股份有限公司 6 / 21 BC20 重要注意事项及常见问题 2.3. 模块工作模式 2.3.1. 模块工作状态概述 模块 Modem 的状态分为 Connected、Idle（DRX/eDRX）和 PSM 三种，满足 3GPP 协议标准。 耗流 接收 状态 发射 状态 模块不活动定时器 Idle T3324 PSM T3412 Idle TAU 图 1：BC20 模块功耗参考示意图 模块状态分为唤醒状态（Active）、轻休眠状态（Light Sleep）和深休眠状态（Deep Sleep）。 Connected CPU Active Idle So ftwar e control CPU Light Sleep Software control 1. RTC event 2. PSM_EINT PSM CPU Deep Sleep Only 32KHz RTC is act ive 图 2：BC20 模块工作模式示意图 上海移远通信技术股份有限公司 7 / 21 BC20 重要注意事项及常见问题 2.3.2. 影响模块进入深休眠的因素 如下因素将可能影响模块进入深休眠： 1) USB 接口有 USB 数据线插入 2) AT+QSCLK=0 或 2 3) AP 侧有任务在处理，如 AT 交互；默认每次发送 AT 命令后，模块会被锁住 10s 无法进入深休眠； 客户可以执行 AT+QRELLOCK 快速解锁 4) PWRKEY 一直被拉低 5) TCP 链路处于 Open 状态 6) PSM_EINT 电平在一直触发 7) PSM 状态被关闭 8) 未插入 USIM 卡 9) GNSS 处于开启状态 2.3.3. 模块可以进入深休眠的场景 当满足如下任一条件时，系统可进入深休眠： 1) AT+CFUN=0 2) AP 处于 Idle 并且 Modem 进入 PSM 3) 底层上报无网（OOS） 4) eDRX 周期在 81.92s 以上 2.4. 模块 IMEI 与 SN 号 BC20 模块出厂时均已写入 IMEI 号和 SN 号且无法修改。 2.5. AT+EPORT 命令 该命令主要用于重新配置 GKI/HSL log 的输出端口和波特率，推荐配置如下： ⚫ 如果使用 USB 接口抓取 log：emmi 设置成 4，uls 设置成 5，无需设置波特率。 //使用 USB 口抓取 Log 时的推荐配置方案 AT+EPORT=1,uls,5 //切换 HSL log 输出端口为 USB 口 AT+EPORT=1,emmi,4 //切换 GKI log 输出端口为 USB 口 上海移远通信技术股份有限公司 8 / 21 BC20 重要注意事项及常见问题 ⚫ 如果使用串口抓取 log：目前 BC20 只有一个串口可用来抓取，需要将辅助串口引出，默认用来抓 取 GKI log，emmi 默认设置为 3，波特率建议设置成 921600bps 波特率以上。 //使用串口抓取 log 时的推荐配置方案 AT+EPORT=1,emmi,3 //切换 GKI log 输出端口为 UART 口 AT+EPORT=3,3,12 //设置 GKI log 输出端口的波特率为 921600bps 备注 1. 由于 connl 口通常用于 AT 命令通信，因此不推荐使用 connl 口抓取 log，以防配置为 log 输出端口后 无法再配置为 AT 命令通信端口。 2. 建议使用如上所述命令配置 GKI/HSL log 的输出端口和波特率；有关 AT+EPORT 命令的更多详情， 请咨询移远通信技术支持。 2.6. 自适应波特率 模块开机后默认处于自适应波特率模式（目前只支持 115200bps 以下波特率的同步），MCU 需要发送 AT 和模块进行波特率同步，返回 OK 后代表同步成功；休眠唤醒后模块会直接使用开机后同步成功的波特 率，无需重新同步。客户也可使用 AT+IPR 命令配置固定波特率，该命令配置会立即生效并保存到 NVRAM。 备注 自适应模式下，模块休眠唤醒后无需同步波特率，会记忆开机同步的波特率。重启后需要重新同步。 2.7. 关于时间同步 目前 BC20 支持两种时间同步的方式：NTP 时间同步和网络下发时间同步。 ⚫ AT+CCLK 可用于查询当前的日期和时间 ⚫ AT+QNTP 可用于指定通过 NTP 服务器同步时间并更新到 RTC ⚫ 模块在收到网络下发的 MM NETWORK INFO 消息后，会自动同步时间到 RTC 备注 有关 AT+QNTP 的详情，请参考 Quectel_BC20_TCP(IP)_AT_Commands_Manual。 上海移远通信技术股份有限公司 9 / 21 BC20 重要注意事项及常见问题 3 常见问题答疑 3.1. 软件相关常见问题 1) Q： 模块支持哪些网络制式？如何设置优先级？ A： BC20 仅支持 NB-IoT，不支持其他的网络制式，因此也不存在优先级设置的问题。 2) Q： BC20 模块可以直接用在海外吗？ A： 不可以。如需应用于海外市场的产品，请咨询移远通信技术支持或当地销售代表。 3) Q： BC20 模块如何获取信号信息？如何判断信号好坏？ A： 可以通过 AT+QENG=0 查询信号质量，当 RSRP 大于-100 且 RSRQ 大于-9，表示信号质量较好， 当 RSRP 小 于 -115 或 RSRQ 小 于 -15 ， 表 示 网 络 信 号 质 量 较 差 。 详 情 请 参 考 Quectel_BC20_AT_Commands_Manual。 4) Q： BC20 模块支持 NB-IoT 异频组网吗？ A： 如何组网是由运营商决定，与模块本身无关。BC20 支持异频重选和同频重选。 5) Q： BC20 模块进入 PSM 之后为什么 AT 命令不通? A： BC20 进入 PSM 是允许 AT 命令通信的，进入 Deep Sleep 模式将不允许 AT 命令通信。 6) Q： PSM 与 Deep Sleep 是相同的概念吗？ A： 不是，具体的区别请参阅 2.3 章节内容。 7) Q： 为什么 Modem 已经进入 PSM 状态，但是功耗降低依然不明显？ A： 功耗与整个系统的状态有关；Modem 进入 PSM 后，还要模块进入 Deep Sleep，系统功耗才能降 到很低。 8) Q： BC20 模块调试过基于 MQTT 协议对接的平台吗？ A： 有，阿里云平台。 9) Q： BC20 支持 GNSS 或 GSM 吗？ A： BC20 支持 GNSS、不支持 GSM。如有相关需求，请咨询移远通信技术支持或当地销售代表。 10) Q： BC20 的主芯片型号是什么？支持 3GPP Rel.14 吗？ A： 联发科的 MT2625 芯片，暂不支持 3GPP Rel.14。 上海移远通信技术股份有限公司 10 / 21 BC20 重要注意事项及常见问题 11) Q： 模块支持哪些主要功能？ A： BC20 主要支持：①PS 域业务；②支持基于 IPv4、IPv6、Non-IP 承载的数据传输；③支持 CP/UP 优化方案；④支持短信业务；⑤支持 Multi-tone、Multi-carrier。 12) Q： 模块为何不能基于 Non-IP 做业务？要如何设置才能实现 Non-IP 业务？ A： 模块支持基于 Non-IP 做业务，但该功能不仅需要模块支持，也需要网络支持，请先咨询运营商 是否开通此项功能。同理，UP 优化方案、短信业务、IPv4/IPv6、Multi-tone/Multi-carrier 等功能 也需要网络支持才可实现。 13) Q： 模块支持到哪个版本的 3GPP 协议？3GPP Rel.14 有哪些主要特性？ A： 模块目前支持到 3GPP Rel.13，暂不支持 3GPP Rel.14。3GPP Rel.14 主要特性：①峰值速率的 提升；②定位功能的增强；③多播能力增强；④Non-anchor 功能增强；⑤定义了新的功率类型。 14) Q： 模块是否支持 RRC 重建、挂起及恢复？ A： 在 3GPP Rel.13 中，以上特性均只有用户面支持，BC20 模块可支持用户面优化方案；但最终这 些特性是否能被支持还取决于网络侧。 15) Q： 什么是用户面方案和控制面方案？ A： NB-IoT 网络为了压缩信令，重新设计了网络业务流程，即分别基于 LTE 用户面、控制面进行优化。 ⚫ 基于控制面优化的 eNB 与核心网不建立 S1-U 接口，只建立 S1-C 接口；用户数据通过 eNB 转发到 MME，由 MME 进行转发； ⚫ 基于用户面优化的 eNB 与核心网同时建立 S1-C/S1-U 的连接，用户数据直接通过基站转发给 SGW； ⚫ 控制面适合发送小包数据；用户面适合发送较大包的数据，但功耗会稍微大一些。 16) Q： 模块支持哪些频段？ A： BC20 目前支持 LTE Cat NB1 B5/B8 频段。 17) Q： 为什么开机选网没有选择信号最强的小区？ A： 模块开机后将按照一定的逻辑搜索小区，并在其第一个找到的、且满足小区选择条件（即满足 S 准则）的小区上驻留；因此不一定选择到信号最强的小区。 18) Q： 为什么模块没有重选到最好的小区？ A： 模块并非无条件的选择信号最好的小区：为了避免在两个信号接近的小区之间产生乒乓效应，模 块仅在两个小区之间信号差值达到一定程度时才会进行小区重选；具体的门限差值由网络下发， 各个小区配置的不尽相同。因此模块在小区之间信号差值不大的时候，不一定会发生重选。 19) Q： eDRX、PSM 是什么？ A： 都是节能技术，其中 PSM 是 3GPP Rel.12 引入的，eDRX 是 3GPP Rel.13 引入的。 ⚫ eDRX（Extended Discontinuous Reception）：扩展的非连续接收，在该模式下只能在 PTW 时间窗内监听下行，最长周期能达到 2.91 小时； ⚫ PSM（Power Saving Mode）：节能模式。在此状态下行不可达，不能响应网络寻呼，也不能 接收网络下发的数据。只能通过模块发送上行数据，或者 TAU 定时器超时唤醒，最长周期达 到 410 多天。 上海移远通信技术股份有限公司 11 / 21 BC20 重要注意事项及常见问题 20) Q： 如何通过 AT 命令查看 T3324 和 T3412 的值？ A： 设 置 AT+CEREG=4 或 者 AT+CEREG=5 时 ， 通 过 AT+CEREG? 命 令 可 以 查 询 T3324 和 T3412 extended 的值；T3412 的值暂不支持 AT 命令方式查询。 T3324 T3412 extended 如果 T3412 extended 值存在，周期性位置更新将使用这个值；如果不存在将使用 T3412 值。但 T3412 值目前不能通过 AT 命令查询。关于 AT+CEREG 命令查询的结果具体值表示多少，请参考 Quectel_BC20_AT_Commands_Manual。 21) Q： DRX、eDRX、PSM 是否支持配置？ A： DRX 周期不支持配置，也不支持功能开启或关闭；eDRX 和 PSM 的周期均可配置，也支持功能 开启和关闭，但网络是否接受配置依赖于运营商设置。如果网络不支持配置 eDRX 和 PSM 的周 期，建议咨询运营商特定 APN 对应的 eDRX、PSM 时长，以期找到一个符合业务模型的节能周期。 22) Q： 典型的进入空闲态（Idle）、进入连接态（Connected）、进入 PSM 的场景是什么？ A： 空闲态：开机后完成小区驻留、RRC 连接释放或无线链路失败时，Modem 将进入空闲态； 连接态：发送任何上/下行数据、信令时，Modem 均需要进入连接态； PSM：在空闲态活动定时器 T3324 超时后，Modem 进入 PSM。 23) Q： 如何快速释放 RRC 连接？ A： 通过 AT+QNBIOTRAI=命令可以配置；有关该命令的详细信息，请参考 Quectel_BC20_AT_ Commands_Manual。 目前 NB-IoT 网络中，都是网络侧主动发起释放；但是可以通过所述 AT+QNBIOTRAI=命令 通知网络：UE 再也没有数据传送了；这样网络会决定是否立即释放 RRC 连接。 参数值选项如下： 0 No information available (or none of the other options apply) (default) 1 TE will send only 1 UL packet and no DL packets expected 2 TE will send only 1 UL packet and only 1 DL packet expected 若想要快速释放，需要设置参数值为 1 或者 2： 1 是指终端发送一个上行，不期望有下行包的，比如 UDP 协议，发送完上行就会释放 RRC； 2 是指终端发送一个上行，且有下行 ACK 包，那么收到下行包后会立即释放 RRC，比如 PING； 如果这类场景使用了参数 1，上行发送完成后也会被立即释放，但是因为网络要给终端回复 ACK，所以网络会再次寻呼终端重新建立 RRC 连接。 24) Q： 如何清除模块的历史频点信息？ A： 使用 AT+QCSEARFCN 命令可清除历史频点信息，如果返回 0 代表清频成功，返回 3 代表历史频 点信息为空。模块最多能保存 10 条历史频点信息。 上海移远通信技术股份有限公司 12 / 21 BC20 重要注意事项及常见问题 25) Q： BC20 是否支持内部看门狗？ A： 支持。当模块出现死机、线程卡死等异常时，会自动触发看门狗自动重启；如果有接 Genie 工具， 在工具收集完 COREDUMP 之后，模块会自动重启。 26) Q：BC20 的 GNSS 如何抓取 debug log？ A：使用如下命令开启，在 TXD_GPS 口即可输出 log AT+QGNSSC=1 AT+QGNSSCMD=0,'$CFGDEBUG,1,1' 27) Q：如何计算 NEMA 语句中的经纬度信息？ A：Google Maps 中的经纬度格式跟 GGA&RMC 中的经纬度格式是存在差别的。GGA 语句中的经纬 度格式为 DDDMM.MMMM、DDMM.MMMM， 但是 Google Maps 中的经纬度格式 DD,DDDDDD。 如果需要输入经纬度信息到 Google Maps 中，需要按如下所示进行计算： 经度：DDDMM.MMMM ---> DDD + MM.MMMM/60 纬度：DDMM.MMMM ---> DD + MM.MMMM/60 28) Q：BC20 能否通过 AT 命令修改 GNSS 的串口波特率并保存？ A：BC20 支持通过 AT 命令修改 GNSS 的串口波特率，但是不支持掉电保存。具体命令请参考 Quectel_BC20_GNSS_协议规范。 29) Q：BC20 的 AGPS 使用疑问 A：具体介绍及使用请参考 Quectel_BC20_GNSS_应用指导。 30) Q：BC20 的不同软件版本 GNSS 输出经纬度数值的小数位数是否有变化？ A：对于 BC20NAR01A04 及之前版本输出的小数位数为 5 位，BC20NAR01A06 及之后的版本输出的 小数位数为 4 位，该小数位数变化不影响定位精度。 3.2. 硬件相关常见问题 BC20 客户原理图和 PCB 检查注意点： ⚫ 功能上：NB 部分主要检查电源供电、PWRKEY、串口、RESET 是否符合模块电气要求；GNSS 部分主要检查 1PPS 引脚不能被拉低。 ⚫ 性能上：参考 BC20 硬件设计手册、参考设计手册来查看各个接口分立元件匹配、选型、参数以 及摆放位置是否正确。 3.2.1. NB 部分 1) Q： 模块在开机和关机状态下，开始下载的方式是否有区别？ A： 模块与 PC 建立连接进入下载模式后，若模块处于关机状态，则拉低 PWRKEY 开始下载；若 模块已经开机，则拉低 RESET 开始下载。 上海移远通信技术股份有限公司 13 / 21 BC20 重要注意事项及常见问题 2) Q： 是否有 BC20 的各种工作模式下的耗流数据？ A： 有，具体请参考 Quectel_BC20_Power_Consumption_Report。 3) Q： 模块开机后能否快速进入休眠模式？工厂如何测试模块的低功耗？ A： 不能快速进入休眠模式。工厂测试过程中，可发送 AT+CFUN=0 关闭射频部分，让模块部分进入 Deep Sleep 以模拟深休眠模式下的功耗。 4) Q： PSM_EINT 引脚可以硬件唤醒 Deep Sleep，但该引脚电压域在硬件设计手册里并没有做说明？ A： PSM_EINT 的电压域为 VBAT，内部默认上拉到 VBAT，建议客户使用 GPIO 通过 OC 电路控制。 5) Q： 不使用 PSM_EINT 引脚，模块能从 Deep Sleep 模式唤醒吗？ A： 可以，PWRKEY 也可将模块从 Deep Sleep 唤醒；另，T3412 定时器超时后，模块将自动退出 Deep Sleep。 6) Q： PWRKEY 引脚内部有上拉吗？ A： PWRKEY 和 RESET 均默认内部上拉到 VBAT。 7) Q： 模块 VBAT 的 TVS 管是否有推荐使用的型号？ A： 推荐用韦尔半导体的 ESD56181W04；请注意 TVS 管都会有一定的漏电流，设计时请考虑在内。 8) Q： 网络指示灯是否已经开通了？ A： 尚未开通，详情请参考 Quectel_BC20_硬件设计手册。 9) Q： PSM_EINT 需要拉低多久方可将模块从 Deep Sleep 模式唤醒？ A： 只需要下降沿即可，下降沿触发。 10) Q： 按 RESET 复位后，测试的 VDD_EXT 波形为方波形式是否正常？ A： 正常，复位时 VDD_EXT 波形本来就是方波形式。 11) Q： 开机或者唤醒时 VDD_EXT 是否会出现方波形式？ A： 不会，VDD_EXT 只在复位过程为方波形式。 12) Q： 在 Deep Sleep 模式下，模块的各引脚是否会造成外部 MCU 漏电？ A： 在 Deep Sleep 模式下，若 MCU 没有将 I/O 配成 Logic Low，是有可能导致漏电的。原因是 MCU 端 Logic High 的 I/O 可能会通过 BC20 的 I/O 外灌回 BC20 的 VCC_EXT，还可能导致其他 GPIO 出现半高电平，若此时这些 I/O 外部有下拉电阻，就会产生漏电。 当模块内部 I/O 口供电关闭时，不允许外部给模块 I/O 提供高电平或外部电源外灌；如果外灌到 VCC_EXT，有可能会影响到系统正常启动。 模块 I/O 口在 Deep Sleep 模式（I/O 口供电关闭）下的阻抗一般为 10MΩ 以上，因此其理论漏电 小于 1μA。 实际上，目前为止使用 MCU 控制 BC20 的客户设备上暂时还没有出现过导致 MCU 漏电的情况。 以引脚 16（NETLIGHT）为例进行测试，用外部 1.8V 电源在系统关机时做外灌，测试结果暂未发 现 I/O 电平被影响的状况。 上海移远通信技术股份有限公司 14 / 21 BC20 重要注意事项及常见问题 13) Q： Deep Sleep 模式下 BC20 各引脚状态如何？是否有模块各引脚状态的表格供参考？ A： Deep Sleep 模式下 VDD_EXT 引脚输出会被关闭，各引脚的状态请参考附录 A。 14) Q： 客户是否可以把 BC20 的 PWRKEY 引脚直接下拉到地，实现上电开机？ A： 不建议。原因：①直接下拉到地会进不了 Deep Sleep 模式；②若后面软件开发 PWRKEY 长按关 机功能，则无法关机；③当客户 MCU I/O 口不够时，PWRKEY 可以用作 Deep Sleep 模式唤醒引 脚。 15) Q： 有的客户在设计 USB 时，USB_3V3 和 USB_MODE 如何处理？ A： 若使用模块内部的 USB 功能，需要给 USB_3V3 引脚供电。另，若需使用 USB 下载功能，需要 将 USB_MODE 预留下拉到地的开关。 16) Q： BC20 模块的 USB 口是否只能作为升级固件使用？是否一定建议客户预留？ A： BC20 的 USB 接口还有调试功能，建议客户预留。 3.2.2. GNSS 部分 1) Q： 有些客户在设计时，会将 1PPS 引脚拉出，接三级管控制 LED 灯作指示使用，为什么 GNSS 开启 失败？ A： BC20 的 1PPS 引脚使用需注意：开机瞬间 1PPS 引脚不能被拉低，否则会导致 GNSS 芯片内的 有源晶振供电异常，GNSS 芯片无法工作，无法输出 NMEA 语句。通常建议客户在使用 1PPS 引 脚时，把三极管改为 MOS 管，以在开机瞬间和地电位隔离开。该引脚已预留。 2) Q： BC20 模块有没有独立串口用于输出 NEMA 语句？ A： 有，TXD_GNSS 串口，可输出 GNSS NMEA 语句；也可通过主串口发送 AT+QGNSSRD?命令查 询 NMEA 语句。 3) Q： BC20 模块 GNSS 芯片的 VRTC 脚是否一定要供电？ A： BC20 模块 GNSS 芯片只要 VCORE 和 VDDIO 供电即可正常工作，VRTC 脚可以不供电。 4) Q： BC20 模块是否支持 AGPS 功能？ A： BC20NAR01A06 及之后的软件版本都已经支持。 5) Q： BC20 在发送 AT+QGNSSC=1 命令打开 GNSS 时，会返回 ERROR: 7103，是什么原因？ A： ① 多 次 发 送 AT+QGNSSC=1 ， 该 命 令 只 需 发 送 一 次 即 可 ； ② 查 询 NMEA 语 句 的 命 令 AT+QGNSSRD，需要等待 5s 左右时间进行再次查询，5s 为 Baseband 部分往 GNSS 芯片加载 固件的时间。 6) Q： BC20 GNSS 切换单卫星/双卫星模式：GPS/BeiDou/GPS+BeiDou 失败的原因？ A： BC20 GNSS 在切换 GPS/BeiDou/GPS+BeiDou 时，需要等固件加载完成，也就是串口发送完 AT+QGNSSC=1 至少等待 5s，再发送切换模式命令。详情请参考 Quectel_BC20_硬件设计手册。 7) Q：BC20 的 1PPS 支持授时脉冲输出吗？ A：BC20 的 GNSS 芯片不支持授时脉冲输出，目前无开发授时功能的计划，该引脚已预留。 上海移远通信技术股份有限公司 15 / 21 BC20 重要注意事项及常见问题 8) Q：为什么 GNSS 的定位时间会很长？ A： ① 首先确认测试环境, 如果在 GPS 信号比较差的地方测试，出现长时间定位也是正常的，一般 建议客户在比较开阔地带测试 GPS 设备； ② 如果在比较开阔的地方测试，还是出现长时间无法定位。可以先检查 NMEA 语句中的 GSV 语 句，能够从此语句中读出当前的卫星信息，比如 C/N 值，卫星数量等。在确定 C/N 值和卫星 数量比较少的情况，再从以下几点加以分析： a) 首先确定 GPS 天线是否存在问题。如果存在问题，可以更换天线，再测试； b) 如果更换天线问题依然存在，需要检查 PCB 硬件设计，比如 RF 走线是否满足 50Ω 阻抗匹配， 参考地是否足够大。 c) 如果 PCB 设计都符合要求，问题仍然存在，需要检查天线四周是否有较高器件以及天线上方 是否有金属材质的屏蔽材料。 上海移远通信技术股份有限公司 16 / 21 BC20 重要注意事项及常见问题 4 附录 A 深休眠模式下模块引脚状态 表 1：深休眠（Deep Sleep）模式下 BC20 模块的引脚状态 引脚号 1 引脚名称 USB_3V3 Deep Sleep 模式下模块引脚状态 （悬空/高阻态/上拉/下拉） 悬空（不外接电源，外接会导致无法进入 Deep Sleep） 2 USB_MODE 悬空 3 RESERVED 悬空 4 RESERVED 悬空 5 PWRKEY 3.3V 6 ADC 1) 悬空 7 RESERVED 悬空 8 RESERVED 悬空 9 RESERVED 悬空 10 RESERVED 悬空 11 USB_DM 悬空 12 USB_DP 悬空 13 RESERVED 悬空 14 GND GND 15 GNSS_ANT / 16 SIM_GND GND 17 1PPS 1) 上拉 18 SIM_VDD 悬空 19 SIM_CLK 悬空 上海移远通信技术股份有限公司 17 / 21 20 SIM_RST 21 SIM_DATA 22 TXD_GNSS 23 RESERVED 24 RXD_AUX 25 TXD_AUX 26 RESERVED 27 GND 28 RESERVED 29 TXD_DBG 30 RXD_DBG 31 GND 32 RESERVED 33 RXD 34 TXD 35 RI 1) 36 DCD 37 PSM_EINT 38 CTS 39 RTS 40 GND 41 RF_ANT 42 GND 43 VDD_EXT 44 GND 45 GND 悬空 悬空 悬空 悬空 悬空 悬空 悬空 GND 悬空 悬空 悬空 GND 悬空 悬空 悬空 悬空 悬空 3.3V 悬空 悬空 GND / GND 下拉 GND GND 上海移远通信技术股份有限公司 BC20 重要注意事项及常见问题 18 / 21 46 RESERVED 47 NETLIGHT 48 GND 49 GND 50 VBAT 51 VBAT 52 RESERVED 53 RESET 54 RESERVED 55 RESERVED 56 RESERVED 57 RESERVED 58 RESERVED 59 RESERVED 60 RESERVED 61 RESERVED 62 RESERVED 63 RESERVED 64 RESERVED 65 RESERVED 66 RESERVED 67 RESERVED 68 RESERVED 备注 1) 表示正在开发中。 下拉 悬空 GND GND 3.3V 3.3V 悬空 3.3V 悬空 悬空 悬空 悬空 悬空 悬空 悬空 悬空 悬空 悬空 悬空 悬空 悬空 悬空 悬空 上海移远通信技术股份有限公司 BC20 重要注意事项及常见问题 19 / 21 BC20 重要注意事项及常见问题 5 附录 B 术语缩写 表 2：术语缩写 缩写 描述 AGPS Assisted GPS AP Application APN Access Point Name CP Control Plane C/N Carrier to Noise Ratio DRX Discontinuous Reception eDRX Extended Discontinuous Reception eNB Evolved Node B GNSS Global Navigation Satellite System GSM Global System for Mobile Communication GSV GPS Satellites in View IMEI International Mobile Equipment Identity IPv4 Internet Protocol version 4 IPv6 Internet Protocol version 6 MME Mobility Management Entity MOS Metal Oxide Semiconductor MQTT Message Queuing Telemetry Transport NB-IoT Narrow Band Internet of Things NTP Network Time Protocol 上海移远通信技术股份有限公司 20 / 21 NVRAM OC OOS PDN PRB RRC PS PSM RSRP RSRQ RTC PTW SGW SN TAU TCP TVS UART USB USIM UP Non-Volatile Random Access Memory Open Collector Out of Service Public Data Network Physical Resource Block Radio Resource Control Packet Switch Power Saving Mode Reference Signal Received Power Reference Signal Received Quality Real Time Clock Paging Time Window Serving Gateway Serial Number Tracking Area Update Transmission Control Protocol Transient Voltage Suppression Universal Asynchronous Receiver-Transmitter Universal Serial Bus Universal Subscriber Identity Module User Plane BC20 重要注意事项及常见问题 上海移远通信技术股份有限公司 21 / 21

BC26&BC20 MQTT 应用指导 NB-IoT 模块系列 版本：BC26&BC20_MQTT_应用指导_V1.1 日期：2020-05-28 状态：受控文件 www.quectel.com BC26&BC20 MQTT 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 26 BC26&BC20 MQTT 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-01-14 2020-05-28 作者 顾根全/ 王瑞/ 刘飞彪 蒋涛 变更表述 初始版本 1. 增加 AT+QMTCFG='ssl'用于配置 SSL/TLS TCP 安全连接功能 （第 3.2.1 章节） 2. 增加基于 SSL/TLS 的 MQTT 使用示例（第 5.2 章） 上海移远通信技术股份有限公司 2 / 26 BC26&BC20 MQTT 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 2 MQTT 数据交互...................................................................................................................................... 6 3 MQTT 相关 AT 命令 ............................................................................................................................... 7 3.1. AT 命令语句................................................................................................................................. 7 3.1.1. 定义 .................................................................................................................................. 7 3.1.2. AT 命令语句...................................................................................................................... 7 3.2. AT 命令详解................................................................................................................................. 8 3.2.1. AT+QMTCFG 配置 MQTT 可选参数.............................................................................. 8 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 ..................................................................... 12 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 ................................................................... 13 3.2.4. AT+QMTCONN 连接客户端至 MQTT 服务器.............................................................. 14 3.2.5. AT+QMTDISC 从 MQTT 服务器断开客户端连接 ........................................................ 15 3.2.6. AT+QMTSUB 订阅主题 ............................................................................................... 16 3.2.7. AT+QMTUNS 退订主题 ............................................................................................... 17 3.2.8. AT+QMTPUB 发布消息 ............................................................................................... 18 4 MQTT 相关 URC .................................................................................................................................. 20 4.1. +QMTSTAT: 指示 MQTT 链路层状态变化的 URC.................................................................. 20 4.2. +QMTRECV: 通知 MCU 读取 MQTT 数据包的 URC ............................................................. 21 5 举例 ...................................................................................................................................................... 22 5.1. 基于 TCP 的 MQTT 使用 ........................................................................................................... 22 5.2. 基于 SSL/TLS 的 MQTT 使用.................................................................................................... 24 6 附录 A 参考文档 .................................................................................................................................. 26 上海移远通信技术股份有限公司 3 / 26 BC26&BC20 MQTT 应用指导 表格索引 表 1：AT 命令及响应类型............................................................................................................................. 7 表 2：MQTT 相关的 URC........................................................................................................................... 20 表 3：URC 中的错误代码........................................................................................................................... 20 表 4：参考文档 ........................................................................................................................................... 26 表 5：术语及缩写 ....................................................................................................................................... 26 上海移远通信技术股份有限公司 4 / 26 BC26&BC20 MQTT 应用指导 1 引言 MQTT 是基于发布/订阅范式的消息协议，具有开放、简单、轻量级且易于实施等特点。MQTT 最大优 势在于，可以以极少的代码和有限的网络带宽，为远程设备连接提供实时可靠的消息服务。 本文档介绍如何通过 AT 命令应用移远通信 BC26 和 BC20 模块的 MQTT 功能。 上海移远通信技术股份有限公司 5 / 26 BC26&BC20 MQTT 应用指导 2 MQTT 数据交互 本章介绍了用于实现 MQTT 功能的数据交互机制，具体如下图所示： MCU 模块 链路层 MQTT服务器 AT+QMTCFG='keepalive',... AT+QMTCFG='timeout',... … AT+QMTOPEN=... OK TCP-REQ +QMTOPEN: , TCP established AT+QMTCONN AT+QMTCONN=... OK +QMTCONN: ,[,] CONN-REQ Start timer T1, T2 CONN ACK-IND Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK 发送连接数据包 服务器收到连接数据包并返回ACK AT+QMTSUB AT+QMTSUB=... OK +QMTSUB: ,, [,] SUB-REQ () Start timer T1 SUB ACK-IND () Stop T1 or handle Excep2 AT+QMTUNS AT+QMTUNS=... OK +QMTUNS: ,, UNS-REQ () Start timer T1 UNS ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB=,,=0... OK PUB-REQ AT+QMTPUB (=1) AT+QMTPUB=,,=1... PUB-REQ () OK Start timer T1 +QMTPUB: ,,[,< value>] PUB ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB (=2) AT+QMTPUB=,,=2... PUB-REQ () OK Start timer T1 PUB REC-IND ) Stop T1 or handle Excep2 +QMTPUB: ,,[, ] PUB REL-REQ () Start timer T1 PUB COMP-IND () Stop T1 or handle Excep2 发送订阅数据包 服务器收到订阅数据包并返回ACK 发送退订数据包 服务器收到退订数据包并返回ACK 发送发布数据包 发送发布数据包 服务器收到发布数据包并返回ACK 发送发布数据包 服务器收到发布数据包 发送释放发布数据包 服务器收到释放发布数据包 T1是数据包传输超时 时间. T2 是keep alive定时 器超时时间. 在T2超时时间内若没 有数据相关信息传 输，客户端会发送心 跳请求包。 Excep1: 断开TCP连 接 Excep2: 重发数据包，除非 达到允许重发次数 上限； 允许重复次数可通 过命令 AT+QMTCFG来设 置。 命令AT+QMTCFG可以 配置是否上报超时信息。 Receive 收到URC格式的PUBLISH 信息 +QMTRECV: ,,, PUB-IND () PUB ACK/REC-REQ () Reply according to . . . AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , DISC-REQ TCP-REQ TCP disconnected 服务器收到发布数据包 发送发布答复数据包 发送断开连接数据包 TCP断..开. 请求 图 1：MQTT 数据交互机制 上海移远通信技术股份有限公司 6 / 26 BC26&BC20 MQTT 应用指导 3 MQTT 相关 AT 命令 本章节介绍了与 MQTT 操作相关的 AT 命令。 3.1. AT 命令语句 3.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应，省略。 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 7 / 26 BC26&BC20 MQTT 应用指导 3.2. AT 命令详解 3.2.1. AT+QMTCFG 配置 MQTT 可选参数 该命令用于配置 MQTT 的可选参数。 AT+QMTCFG 配置 MQTT 可选参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'dataformat',(支持的范围), (支持的列表),(支持的列表) +QMTCFG: 'keepalive',(支持的范围),(支 持的范围) +QMTCFG: 'session',(支持的范围),(支持 的列表) +QMTCFG: 'timeout',(支持的范围),(支持 的范围),(支持的范围),(支持的列表) +QMTCFG: 'will',(支持的范围),(支持的< will_fg>列表),(支持的范围),(支持的 列表),, +QMTCFG: 'version',(支持的范围),(支持 的列表) +QMTCFG: 'aliauth',(支持的范围),,, +QMTCFG: 'echomode',(支持的范围), (支持的列表) +QMTCFG: 'ssl',( 支 持 的 范 围 ),( 支 持 的 列表),(支持的范围),(支持的 范围) 设置命令 查询/设置收发数据的格式 AT+QMTCFG='dataformat',[,,] OK 响应 若省略可选参数，则查询当前收发数据的格式： +QMTCFG: 'dataformat',, OK 若指定可选参数，则设置收发数据的格式： OK 设置命令 若出现任何错误： ERROR 响应 上海移远通信技术股份有限公司 8 / 26 BC26&BC20 MQTT 应用指导 查询/设置保活时间 AT+QMTCFG='keepalive',[,] 若省略可选参数，则查询当前保活时间： +QMTCFG: 'keepalive', OK 若指定可选参数，则设置保活时间： OK 设置命令 查询/设置会话类型 AT+QMTCFG='session',[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前会话类型： +QMTCFG: 'session', OK 若指定可选参数，则设置会话类型： OK 设置命令 查询/设置消息传输超时时间 AT+QMTCFG='timeout',[,,,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置的消息传输超时时间： +QMTCFG: 'timeout',,, OK 若指定可选参数，则设置消息传输超时时间： OK 设置命令 查询/设置 Will 信息 AT+QMTCFG='will',[,,,,,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前配置的 Will 信息： +QMTCFG: 'will',[,,,,] OK 若指定可选参数，则设置 Will 信息： OK 若出现任何错误： 上海移远通信技术股份有限公司 9 / 26 BC26&BC20 MQTT 应用指导 ERROR 设置命令 查询/设置待使用 MQTT 协议版本 AT+QMTCFG='version',[,] 响应 若省略可选参数，则查询 MQTT 协议版本： +QMTCFG: 'version', OK 若指定可选参数，则设置 MQTT 协议版本： OK 设置命令 查询/设置阿里云设备信息 AT+QMTCFG='aliauth',[,,,] 若出现任何错误： ERROR 响应： 若省略可选参数，则查询设备信息： [+QMTCFG: 'aliauth',,,] OK 若指定可选参数，则设置设备信息： OK 设置命令 查询/设置在数据模式下是否向 UART 回显输入的数据 AT+QMTCFG='echomode',[,] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前数据回显模式： +QMTCFG: 'echomode', OK 若指定可选参数，则设置数据回显模式： OK 设置命令 查询/设置是否使用 SSL 安全连接 AT+QMTCFG='ssl',[,[,,]] 若出现任何错误： ERROR 响应 若省略可选参数，则查询当前是否使用 SSL 安全连接： +QMTCFG: 'ssl',[,,] OK 上海移远通信技术股份有限公司 10 / 26 BC26&BC20 MQTT 应用指导 最大响应时间 特性说明 若指定任意可选参数，则设置是否使用 SSL 安全连接： OK 若出现任何错误： ERROR 300 毫秒 该命令立即生效。 深休眠唤醒后无效；不保存到 NVRAM。 参数 整型。MQTT Socket 标识符。范围：0~5。 整型。是否配置 Will 信息。 0 无需配置 Will 信息 1 需要配置 Will 信息 整型。发送消息时的 QoS 级别。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。Will Retain 标记只适用于 PUBLISH 消息。 0 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者 以后，服务器不会保留该消息 1 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者 以后，服务器会保留该消息 字符串类型。主题名称。最大长度：255 字节。 字符串类型。当客户端连接意外断开后，该参数定义需要发布到 Will Topic 的消息 内容。消息长度范围：0~255 字节。 整型。数据包传输超时时间。范围：1~60；默认值：10；单位：秒。 整型。数据包传输超时后重发次数。范围：0~10；默认值：3。 整型。传输数据包时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器必须存储该客户端的订阅消息（仅当服务器支持 所述功能时，该参数取值才有效） 1 服务器必须丢弃之前保留的关于客户端的任何消息，并将这个连接视为 'clean' 整型。保活时间。范围：0~3600；默认值：120；单位：秒。该参数定义从客户 端接收到消息之间的最大间隔时间，在保活时间的 1.5 倍时长内，若服务器未从 客户端收到消息，则默认客户端发送了断开连接消息，服务器会断开客户端连接。 0 不断开客户端连接 字符串类型。阿里云发布的产品密钥。最大长度：64 字节。 上海移远通信技术股份有限公司 11 / 26 BC26&BC20 MQTT 应用指导 字符串类型。阿里云发布的设备名称。最大长度：64 字节。 字符串类型。阿里云发布的设备校验凭证。最大长度：64 字节。 整型。MQTT 协议版本。 3 MQTT v3.1 4 MQTT v3.1.1 整型。发送数据的格式。 0 文本格式 1 十六进制格式 整型。接收数据的格式。 0 文本格式 1 十六进制格式 整型。在数据模式下是否向 UART 回显输入数据。 0 不向 UART 回显输入数据 1 向 UART 回显输入数据 整型。是否使用 SSL 安全连接。 0 为 MQTT 使用 TCP 连接 1 为 MQTT 使用 SSL/TLS TCP 安全连接 整型。SSL 上下文标识符。范围：1~3。 整型。SSL Socket 标识符。范围：0~5。 备注 1. 请确保数据在传输过程中不能超时。 2. AT+QMTCFG='aliauth'只用于阿里云；若已配置此命令，则 AT+QMTCONN 中的和 可以省略。 3. 仅在数据模式传输中，才有效。 4. 当=1 时，必须指定和，并通过 AT+QSSLCFG 设置 SSL/TLS 连接配置。有关 AT+QSSLCFG 的详细信息，请参阅《Quectel_BC26&BC20_SSL_ 应用指导》。 5. 'will'、'session'、'keepalive'、'aliauth'、'version'和'ssl'的配置需在 AT+QMTOPEN 执行前 完成方可生效。 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 该命令用于打开 MQTT 客户端网络。 AT+QMTOPEN 打开 MQTT 客户端网络 测试命令 AT+QMTOPEN=? 响应 +QMTOPEN: (支持的范围),, OK 上海移远通信技术股份有限公司 12 / 26 BC26&BC20 MQTT 应用指导 查询命令 AT+QMTOPEN? 响应 [+QMTOPEN: ,,] 设置命令 AT+QMTOPEN=,, OK 响应 OK +QMTOPEN: , 最大响应时间 特性说明 若出现任何错误： ERROR 75 秒，受网络状态影响 / 参数 整型。MQTT Socket 标识符。范围：0~5。 字符串类型。服务器地址，可以是 IP 地址或者域名。最大长度：150；单位：字节。 整型。服务器端口。范围：1~65535。 整型。命令执行结果。 -1 打开网络失败 0 打开网络成功 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 该命令用于关闭 MQTT 客户端网络。 AT+QMTCLOSE 关闭 MQTT 客户端网络 测试命令 AT+QMTCLOSE=? 响应 +QMTCLOSE: (支持的范围) 设置命令 AT+QMTCLOSE= OK 响应 OK +QMTCLOSE: , 最大响应时间 若出现任何错误： ERROR 300 毫秒 上海移远通信技术股份有限公司 13 / 26 BC26&BC20 MQTT 应用指导 特性说明 / 参数 整型。MQTT Socket 标识符。范围：0~5。 整型。命令执行结果。 -1 关闭网络失败 0 关闭网络成功 3.2.4. AT+QMTCONN 连接客户端至 MQTT 服务器 该命令用于请求连接 MQTT 服务器。当客户端和服务器之间创建了一个 TCP/IP Socket 连接，必须使 用 CONNECT 流创建一个协议层会话。 AT+QMTCONN 连接客户端至 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: (支持的范围),[,< username>[,]] 查询命令 AT+QMTCONN? OK 响应 [+QMTCONN: ,] 设置命令 AT+QMTCONN=,[,[,]] OK 响应 OK +QMTCONN: ,[,] 最大响应时间 特性说明 若出现任何错误： ERROR （默认 10 秒），取决于网络状态 / 参数 整型。MQTT Socket 标识符。范围：0~5。 字符串类型。客户端标识符。最大长度：128 字节。 字符串类型。客户端用户名，可用于鉴权。最大长度：256 字节。 字符串类型。客户端用户名对应的密码，可用于鉴权。最大长度：256 字节。 上海移远通信技术股份有限公司 14 / 26 BC26&BC20 MQTT 应用指导 整型。命令执行结果。 0 数据包发送成功且从服务器接收到 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 初始化 2 MQTT 正在连接 3 MQTT 已经连接成功 4 MQTT 正在断开连接 整型。连接返回码。 0 接受连接 1 拒绝连接：不支持的协议版本 2 拒绝连接：拒绝标识符 3 拒绝连接：服务器不可用 4 拒绝连接：用户名或密码错误 5 拒绝连接：未授权 整型。数据包传输超时时间。范围：1~60；默认值：10；单位：秒。 备注 具有相同客户端标识符（）的两个客户端连接到同一服务器时，在后建立连接的客户端完成连 接后，将由服务器自动断开与先建立连接的客户端之间的连接。 3.2.5. AT+QMTDISC 从 MQTT 服务器断开客户端连接 客户端可通过该命令请求断开与 MQTT 服务器的连接。客户端发送 DISCONNECT 消息到服务器表示 即将与服务器断开 TCP/IP 连接。 AT+QMTDISC 从 MQTT 服务器断开客户端连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的范围) 设置命令 AT+QMTDISC= OK 响应 OK +QMTDISC: , 最大响应时间 特性说明 若出现任何错误： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 15 / 26 BC26&BC20 MQTT 应用指导 参数 整型。MQTT Socket 标识符。范围：0~5。 整型。命令执行结果。 -1 断开连接失败 0 断开连接成功 3.2.6. AT+QMTSUB 订阅主题 该命令用于订阅一个或多个主题。客户端发送 SUBSCRIBE 消息从而在服务器上注册感兴趣的一个或 多个主题名称。将发布到这些主题的消息作为 PUBLISH 消息从服务器传输到客户端。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: (支持的范围),,,[,,...] 设置命令 AT+QMTSUB=,< msgID>,,[,, …] OK 响应 OK +QMTSUB: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR + × （默认 40 秒），取决于网络状态 / 参数 整型。MQTT Socket 标识符。范围：0~5。 整型。数据包的消息标识符。范围：1~65535。 字符串类型。客户端想要订阅或者退订的主题。最大长度：255 字节。 整型。客户端打算发布消息的 QoS 等级。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。命令执行结果。 0 数据包发送成功且从服务器接收到 ACK 1 数据包重传 2 数据包发送失败 上海移远通信技术股份有限公司 16 / 26 BC26&BC20 MQTT 应用指导 若=0，则为已确认 QoS 等级的矢量；参数取值 128 表示服务器拒绝订阅； 若=1，则表示数据包重传次数； 若=2，则不显示。 整型。数据包传输超时时间。范围：1~60；默认值：10；单位：秒。 整型。数据包传输超时后的重发次数。范围：0~10；默认值：3。 备注 只有在固定报头中的 QoS 位指示 QoS 等级是 1 或者 2 的消息中才显示。在特定通信方向的一 组飞行消息中，必须只有唯一的消息标识符。该参数取值通常按消息排列顺序逐一递增，但非必须逐一递 增。 3.2.7. AT+QMTUNS 退订主题 该命令用于退订一个或者多个主题。客户端向服务器发送 UNSUBSCRIBE 消息退订提及的主题。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: (支持的范围),,[,...] 设置命令 AT+QMTUNS=,< msgID>,[,…] OK 响应 OK +QMTUNS: ,, 最大响应时间 特性说明 若出现任何错误： ERROR + × （默认 40 秒），取决于网络状态 / 参数 整型。MQTT Socket 标识符。范围：0~5。 整型。数据包的信息标识符。范围：1~65535。 字符串类型。客户端想要订阅或者退订的主题；最大长度：255 字节。 整型。命令执行结果。 0 数据包发送成功且从服务器接收到 ACK 1 数据包重传 上海移远通信技术股份有限公司 17 / 26 BC26&BC20 MQTT 应用指导 2 数据包发送失败 整型。数据包传输超时时间。范围：1~60；默认值：10；单位：秒。 整型。数据包传输超时后的重发次数。范围：0~10；默认值：3。 3.2.8. AT+QMTPUB 发布消息 客户端通过该命令向服务器发布消息，再由服务器分配到感兴趣的订阅者。每一个 PUBLISH 消息都关 联一个主题名称；若一个客户端订阅了一个或者多个主题，服务器会将发布到这些主题的所有消息作为 PUBLISH 消息发送到客户端。 AT+QMTPUB 发布消息 测试命令 AT+QMTPUB=? 响应 +QMTPUB: (支持的范围),,,,, 设置命令 AT+QMTPUB=,,,, OK 响应 > 响应>后，模块将在 500 毫秒内进入数据模式；之后可直接输入 待发数据，按 Ctrl+Z 发送数据，按 Esc 取消发送。 OK +QMTPUB: ,,[,] 设置命令 AT+QMTPUB=,,,,, 若出现任何错误： ERROR 响应 OK +QMTPUB: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR + × （默认 40 秒），取决于网络状态 / 参数 整型。MQTT Socket 标识符。范围：0~5。 上海移远通信技术股份有限公司 18 / 26 BC26&BC20 MQTT 应用指导 整型。数据包的消息标识符。范围：0~65535。只有当=0 时，该参数值为 0。 整型。客户端想要发布消息的 QoS 等级。 0 最多发送一次 1 最少发送一次 2 只发送一次 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 消息发送到当前订阅者后，服务器不保存消息。 1 消息发送到当前订阅者后，服务器保存消息。 字符串类型。待发布主题。最大长度：255 字节。 字符串类型。待发布消息。最大长度：700 字节；若是在数据模式，最大长度：1024 字节。 整型。命令执行结果。 0 数据包发送成功且从服务器接收 ACK（当=0 时，发布的消息无需 ACK） 1 数据包重传 2 数据包发送失败 若=1，则表示数据包重传次数； 若=0 或 2，则不显示。 整型。数据包传输超时时间。范围：1~60；默认值：10；单位：秒。 整型。数据包传输超时后的重发次数。范围：0~10；默认值：3。 备注 1. PUBLISH 消息可从发布者发布至服务器，也可从服务器发布至订阅者。当服务器发布消息到订阅者 时，会返回如下 URC 以通知 MCU 读取 MQTT 服务器发来的数据： +QMTRECV: ,,, 更多关于此 URC 描述信息，请参考第 4.2 章。 2. 为特殊格式（如 JSON）字符时，必须为带双引号的字符串。暂不支持特殊命令字符，如分 号（;）。 3. 在数据模式下发送数据时，建议返回 > 后等待 500 毫秒再发送数据。 上海移远通信技术股份有限公司 19 / 26 BC26&BC20 MQTT 应用指导 4 MQTT 相关 URC 本章节主要描述 MQTT 相关的 URC。 表 2：MQTT 相关的 URC 索引 URC 格式 描述 当 MQTT 链路层状态改变，客户端会断开 MQTT [1] +QMTSTAT: , 连接并上报该 URC。 当客户端接收到从 MQTT 服务器发送的数据包 [2] +QMTRECV: ,,< 时，会上报该 URC 以通知 MCU 读取 MQTT 数 topic>, 据包。 4.1. +QMTSTAT: 指示 MQTT 链路层状态变化的 URC 该 URC 以+QMTSTAT: 开头；当 MQTT 链路层状态发生变化时，上报该 URC。 +QMTSTAT: 指示 MQTT 链路层状态变化的 URC +QMTSTAT: , 报该 URC。 参数 整型。MQTT Socket 标识符。 整型。错误代码，详细信息请参考下表。 表 3：URC 中的错误代码 码 描述 1 连接被服务器断开或者重置 2 发送 PINGREQ 包超时或者失败 解决方案 执行命令 AT+QMTOPEN 重建 MQTT 连接 先去激活 PDP，再重新激活 PDP 并重建 MQTT 连接 上海移远通信技术股份有限公司 20 / 26 BC26&BC20 MQTT 应用指导 3 4 5 6 7 8~255 发送 CONNECT 包超时或者失败 接收 CONNACK 包超时或者失败 客户端向服务器发送 DISCONNECT 包，但 是服务器主动断开 MQTT 连接 因为发送数据包总是失败，客户端主动断开 MQTT 连接 1. 检查输入的用户名和密码是否正确。 2. 确保客户端标识符（）未被占用。 3. 重 建 MQTT 连 接 ， 并 尝 试 重 新 发 送 CONNECT 包至服务器。 1. 查看输入的用户名和密码是否正确。 2. 确保客户端 ID 未被占用。 3. 重 建 MQTT 连 接 ， 并 尝 试 再 次 发 送 CONNECT 包到服务器。 正常流程。 1. 请确保数据正确。 2. 由于可能存在网络拥堵或者错误，请尝试重 建 MQTT 连接。 链路不工作或者服务器不可用 请确保当前链路工作或者服务器可用。 预留 4.2. +QMTRECV: 通知 MCU 读取 MQTT 数据包的 URC 该 URC 以+QMTRECV: 开头，用于通知 MCU 读取已从 MQTT 服务器接收到的 MQTT 数据包。 +QMTRECV: 通知 MCU 读取 MQTT 数据包的 URC +QMTRECV: ,,, 参数 整型。MQTT Socket 标识符。 整型。数据包的消息标识符。 字符串类型。从 MQTT 服务器接收的主题。 字符串类型。主题名称相关的负载。 备注 URC 最大长度为 1400 字节。 上海移远通信技术股份有限公司 21 / 26 BC26&BC20 MQTT 应用指导 5 举例 本章节主要通过举例来解释如何使用 MQTT 相关命令。 5.1. 基于 TCP 的 MQTT 使用 AT+QMTOPEN=? +QMTOPEN: (0-5),, OK //打开 MQTT 客户端网络 AT+QMTOPEN=0,'220.180.239.212',8401 OK +QMTOPEN: 0,0 //MQTT 客户端网络成功打开 AT+QMTOPEN? +QMTOPEN: 0,'220.180.239.212',8401 OK AT+QMTCONN=? +QMTCONN: (0-5),[,[,]] OK AT+QMTCONN=0,'clientExample' OK +QMTCONN: 0,0,0 //客户端成功连接至 MQTT 服务器 AT+QMTSUB=? +QMTSUB: (0-5),,,[,,...] OK //订阅主题 AT+QMTSUB=0,1,'topic/example',2 OK 上海移远通信技术股份有限公司 22 / 26 BC26&BC20 MQTT 应用指导 +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //若客户端订阅了名为'topic/example'的主题，并且其他设备发布了相同主题的消息到服务器，模块会上 报如下 URC： +QMTRECV: 0,0,'topic/example','This is the payload related to topic' //退订主题 AT+QMTUNS=0,2,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB: (0-5),,,,, OK //发布消息 AT+QMTPUB=0,0,0,0,'topic/pub','hello MQTT.' OK +QMTPUB: 0,0,0 //若客户端订阅了名为'topic/pub'的主题，并且其他设备发布了相同主题的消息到服务器，模块会上报如下 URC： +QMTRECV: 0,0,'topic/pub','hello MQTT.' //在数据模式下发布消息 AT+QMTPUB=0,0,0,0,'topic/pub' > This is test data, hello MQTT. OK //模块进入数据模式 //数据输入完成后，按 Ctrl+Z 发送消息 +QMTPUB: 0,0,0 //若客户端订阅了名为'topic/pub'的主题，其他设备发布了相同主题的消息到服务器，模块会上报如下 URC： +QMTRECV: 0,0,'topic/pub','This is test data, hello MQTT.' //断开 MQTT 服务器与客户端的连接 AT+QMTDISC=0 OK 上海移远通信技术股份有限公司 23 / 26 +QMTDISC: 0,0 //成功断开连接 BC26&BC20 MQTT 应用指导 5.2. 基于 SSL/TLS 的 MQTT 使用 AT+QSCLK=0 OK //配置证书和密钥 AT+QSSLCFG=1,5,'seclevel',2 OK AT+QSSLCFG=1,5,'cacert' > +QSSLCFG: 1,5,'cacert',1216 OK AT+QSSLCFG=1,5,'clientcert' > +QSSLCFG: 1,5,'clientcert',1224 OK AT+QSSLCFG=1,5,'clientkey' > +QSSLCFG: 1,5,'clientkey',1679 OK AT+QSCLK=1 OK AT+QMTCFG='ssl',3,1,1,5 OK AT+QMTOPEN=3,'hf.quectel.com',8164 OK +QMTOPEN: 3,0 AT+QMTCONN=3,'clientExample' OK +QMTCONN: 3,0,0 AT+QMTSUB=3,1,'topic/example/tls',1 OK +QMTSUB: 3,1,0,1 //禁用模块的休眠模式 //配置认证方式为双向认证 //配置 CA 证书 //输入 PEM 格式的 CA 证书内容，按 Ctrl+Z 发送 //配置客户端证书 //输入 PEM 格式的客户端证书内容，按 Ctrl+Z 发送 //配置客户端密钥 //输入 PEM 格式的客户端密钥，按 Ctrl+Z 发送 //启用模块休眠模式 //启用 SSL 并配置 SSL 上下文标识符/Socket 标识符 //MQTT 客户端成功打开 //客户端成功连接至 MQTT 服务器 //客户端订阅名为'topic/example/tls'主题 //主题订阅成功 上海移远通信技术股份有限公司 24 / 26 BC26&BC20 MQTT 应用指导 AT+QMTPUB=3,0,0,0,'topic/example/tls','hello MQTT.' //向指定的主题发布消息 OK +QMTPUB: 3,0,0 //如果客户端订阅了名为'topic/example/tls'的主题，并且其他设备发布了相同主题的消息到服务器，模块会 上报如下 URC： +QMTRECV: 3,0,'topic/example/tls','hello MQTT.' AT+QMTPUB=3,0,0,0,'topic/example/tls' > //模块进入数据模式 This is test data, hello MQTT. //数据输入完成后，按 Ctrl+Z 发送消息 OK +QMTPUB: 3,0,0 //如果客户端订阅了名为'topic/pub'的主题，并且其他设备发布了相同主题的消息到服务器，模块会上报如 下 URC： +QMTRECV: 3,0,'topic/pub','This is test data, hello MQTT.' AT+QMTDISC=3 OK //断开 MQTT 服务器与客户端的连接 +QMTDISC: 3,0 //成功断开连接 上海移远通信技术股份有限公司 25 / 26 BC26&BC20 MQTT 应用指导 6 附录 A 参考文档 表 4：参考文档 序号 [1] [2] [3] 文档名称 MQTT V3.1 Protocol Specification MQTT V3.1.1 Protocol Specification Quectel_BC26&BC20_SSL_应用指导 说明 MQTT 协议 3.1 版本规格说明 MQTT 协议 3.1.1 版本规格说明 BC26 和 BC20 模块的 SSL 应用指导 表 5：术语及缩写 缩写 ACK CA MQTT NB-IoT QoS RAM SSL TCP TLS URC 英文全称 Acknowledgement Certificate Authority Message Queuing Telemetry Transport Narrow Band Internet of Things Quality of Service Random Access Memory Security Socket Layer Transmission Control Protocol Transport Layer Security Unsolicited Result Code 中文全称 确认通知 证书授权中心 消息队列遥测传输 窄带物联网 服务质量 随机存取存储器 安全套接层 传输控制协议 传输层安全 非请求结果码 上海移远通信技术股份有限公司 26 / 26

BC26&BC20 TCP/IP 应用指导 NB-IoT 模块系列 版本：BC26&BC20_TCP/IP_应用指导_V1.1 日期：2020-05-28 状态：受控文件 www.quectel.com BC26&BC20 TCP/IP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 40 BC26&BC20 TCP/IP 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2019-07-26 2020-05-28 作者 蒋涛 蒋涛 变更表述 初始版本 并入《Quectel_BC26&BC20_TCP(IP)_AT 命令手册_V1.0》文 档中有关 TCP/IP AT 命令和 URC 的详情。 上海移远通信技术股份有限公司 2 / 40 BC26&BC20 TCP/IP 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 1.1. TCP/IP AT 命令简述.................................................................................................................... 5 1.2. 数据访问模式说明 ....................................................................................................................... 5 2 TCP/IP AT 命令详解 .............................................................................................................................. 6 2.1. AT 命令类型 ................................................................................................................................ 6 2.1.1. 定义 .................................................................................................................................. 6 2.1.2. AT 命令语句..................................................................................................................... 6 2.2. AT 命令详解 ................................................................................................................................ 7 2.2.1. AT+QIOPEN 打开 Socket.............................................................................................. 7 2.2.2. AT+QICLOSE 关闭 Socket............................................................................................ 8 2.2.3. AT+QISTATE 查询 Socket 状态 .................................................................................... 9 2.2.4. AT+QISEND 发送十六进制/文本字符串数据............................................................... 10 2.2.5. AT+QIRD 读取 TCP/IP 数据........................................................................................ 12 2.2.6. AT+QISENDEX 发送十六进制字符串数据 .................................................................. 14 2.2.7. AT+QISWTMD 切换数据访问模式 .............................................................................. 14 2.2.8. AT+QPING Ping 远程服务器 ....................................................................................... 15 2.2.9. AT+QNTP 通过 NTP 服务器同步本地时间.................................................................. 16 2.2.10. AT+QIDNSGIP 转换域名为 IP 地址............................................................................. 17 2.2.11. AT+QIDNSCFG 配置 DNS 服务器地址....................................................................... 18 2.2.12. AT+QICFG 配置可选参数............................................................................................ 19 2.2.13. AT+QIGETERROR 查询最新一次错误码.................................................................... 22 2.3. URC 详解 .................................................................................................................................. 22 2.3.1. 连接断开 URC ................................................................................................................ 22 2.3.2. 下行数据已达 URC......................................................................................................... 23 2.3.3. 下行数据缓存已满 URC.................................................................................................. 23 3 错误码 .................................................................................................................................................. 25 4 举例 ...................................................................................................................................................... 27 4.1. TCP 客户端使用说明................................................................................................................. 27 4.1.1. 初始化工作 ..................................................................................................................... 27 4.1.2. 建立 TCP 连接................................................................................................................ 27 4.1.3. 配置发送的数据格式（配置为文本字符串格式） ........................................................... 28 4.1.4. 配置发送的数据格式（配置为十六进制格式）............................................................... 28 4.1.5. 配置在数据模式下是否回显 ............................................................................................ 28 4.1.6. 发送文本数据（命令模式） ............................................................................................ 29 4.1.7. 发送文本数据（定长数据模式）..................................................................................... 29 4.1.8. 发送文本数据（不定长数据模式） ................................................................................. 30 上海移远通信技术股份有限公司 3 / 40 BC26&BC20 TCP/IP 应用指导 4.1.9. 发送十六进制数据（命令模式）..................................................................................... 30 4.1.10. 发送十六进制数据（定长数据模式） ............................................................................. 31 4.1.11. 发送十六进制数据（不定长数据模式）.......................................................................... 31 4.1.12. ACK 响应检查................................................................................................................. 32 4.1.13. 配置接收的数据格式（配置为文本字符串格式） ........................................................... 32 4.1.14. 配置接收的数据格式（配置为十六进制格式）............................................................... 32 4.1.15. 配置所接收数据的输出格式（配置为换行格式） ........................................................... 33 4.1.16. 配置所接收数据的输出格式（配置为逗号分隔格式）.................................................... 33 4.1.17. 所接收数据的存取方式（缓存模式） ............................................................................. 34 4.1.18. 所接收数据的存取方式（缓存模式下显示长度） ........................................................... 34 4.1.19. 所接收数据的存取方式（直吐模式） ............................................................................. 36 4.1.20. 关闭连接 ......................................................................................................................... 36 4.2. TCP 长连接的会话保活说明...................................................................................................... 37 4.3. Ping 远程服务器 ........................................................................................................................ 37 4.4. 同步本地时间............................................................................................................................. 38 4.5. 配置 DNS 服务器....................................................................................................................... 38 4.6. 查询最新一次错误码.................................................................................................................. 38 5 附录 A 术语缩写 .................................................................................................................................. 39 上海移远通信技术股份有限公司 4 / 40 BC26&BC20 TCP/IP 应用指导 表格索引 表 1：AT 命令及响应类型 ............................................................................................................................ 6 表 2：错误码列表 ....................................................................................................................................... 25 表 3：术语缩写 ........................................................................................................................................... 39 上海移远通信技术股份有限公司 4 / 40 BC26&BC20 TCP/IP 应用指导 1 引言 移远通信 BC26 和 BC20 模块均内置 TCP/IP 协议栈，可直接通过 AT 命令访问网络；这大大降低模块 对 PPP 以及外部 TCP/IP 协议栈的依赖，从而降低终端设计的成本。 BC26 和 BC20 模块可提供 TCP 客户端、UDP 客户端等套接字（Socket）服务。 1.1. TCP/IP AT 命令简述 通过 TCP/IP AT 命令，模块可以打开/关闭 Socket，并通过 Socket 收发数据。 1.2. 数据访问模式说明 BC26 和 BC20 模块支持如下两种数据访问模式：  缓存模式  直吐模式 当通过 AT+QIOPEN 打开 Socket 时，可以通过指定数据访问模式。成功打开 Socket 后，可以通过 AT+QISWTMD 切换数据访问模式。两种数据访问模式下，均可通过 AT+QISEND 或 AT+QISENDEX 发送数据。 1. 缓 存 模 式 下 ， 模 块 接 收 到 数 据 时 ， 会 先 缓 存 所 接 收 的 数 据 并 上 报 URC +QIURC: 'recv',[,]，之后可通过 AT+QIRD 读取缓存数据。 2. 直吐模式下，模块接收到数据时，会通过上报的 URC +QIURC: 'recv',,直接输出数据。 备注 缓存模式下，在缓存数据被全部读取完之前，模块不会再上报新的 URC 通知 MCU 收到下行数据。 上海移远通信技术股份有限公司 5 / 40 BC26&BC20 TCP/IP 应用指导 2 TCP/IP AT 命令详解 本章节主要描述和 TCP/IP 相关的 AT 命令。 2.1. AT 命令类型 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略。 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 6 / 40 BC26&BC20 TCP/IP 应用指导 2.2. AT 命令详解 2.2.1. AT+QIOPEN 打开 Socket 该命令用于打开 Socket 以创建 TCP/UDP 连接；可通过指定服务类型，并通过 指定数据访问模式。命令执行成功以后，会上报 URC +QIOPEN: ,通 知 Socket 是否成功打开。 AT+QIOPEN 打开 Socket 测试命令 AT+QIOPEN=? 响应 +QIOPEN: (支持的范围),(支持的 范围),'TCP/UDP','/',,,(支持的列表)[,(支持 的列表)] OK 设置命令 响应 AT+QIOPEN=,,,'/',[,[,][,]] OK +QIOPEN: , 若有任何错误： ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效。 '/'、、 、和深休眠唤 醒后仍有效；参数配置不保存至 NVRAM。 参数 整型。场景 ID。范围：1~3。 整型。Socket ID。范围：0~4。 字符串类型。Socket 服务类型。 'TCP' 客户端创建 TCP 连接 'UDP' 客户端创建 UDP 连接 字符串类型。远程服务器的 IP 地址，例如：220.18.23.22。最大长度：150 字节。 字符串类型。远程服务器的域名地址。最大长度：150 字节。 整型。远程服务器的端口号。范围：1~65535。 整型。本地端口号。 0 自动分配本地端口号 上海移远通信技术股份有限公司 7 / 40 BC26&BC20 TCP/IP 应用指导 1~65535 指定的本地端口号 整型。Socket 的数据访问模式。 0 缓存模式 1 直吐模式 整型。互联网协议类型。 0 IPv4 1 IPv6 整型。错误码，详情请参考第 3 章。 备注 1. 目前仅支持=1。 2. URC +QIOPEN: ,上报的超时时间为 60 秒，请在 URC 上报完成后再进行其他操 作。 3. 如果 TCP/UDP 连接创建失败，需执行 AT+QICLOSE=以关闭当前 Socket。 4. 模块开机后，需等 IP 地址 URC（例如：+IP: 10.18.237.42，表明模块注网成功）上报完成后方可执 行该命令。 5. TCP 会话创建后，模块将无法进入深休眠（Deep Sleep）模式。TCP 连接关闭后，模块方可如期进 入深休眠模式。 6. UDP 会话创建后，模块可正常进入深休眠模式，并且唤醒后 UDP 配置信息不会丢失，MCU 可以在 唤醒后直接收发数据。 2.2.2. AT+QICLOSE 关闭 Socket 该命令用于关闭指定的 Socket。 AT+QICLOSE 关闭 Socket 测试命令 AT+QICLOSE=? 响应 +QICLOSE: (支持的范围) 设置命令 AT+QICLOSE= OK 响应 若成功关闭： OK CLOSE OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 8 / 40 参数 整型。Socket ID。范围：0~4。 BC26&BC20 TCP/IP 应用指导 2.2.3. AT+QISTATE 查询 Socket 状态 该命令用于查询 Socket 状态。 AT+QISTATE 查询 Socket 状态 测试命令 AT+QISTATE=? 查询命令 AT+QISTATE? 响应 OK 响应 返回所有现存连接的状态： [+QISTATE: ,,/ ,,,,,] […] OK 设置命令 若为 0，查询指定场景的 连接状态 AT+QISTATE=, 若有任何错误： ERROR 响应 返回指定场景里所有现存连接的状态： [+QISTATE: ,,/ ,,,,,] […] OK 设置命令 若为 1，查询指定 Socket 的连接状态 AT+QISTATE=, 若有任何错误： ERROR 响应 返回指定 Socket 的连接状态： [+QISTATE: ,,/ ,,,,,] OK 若有任何错误： ERROR 上海移远通信技术股份有限公司 9 / 40 BC26&BC20 TCP/IP 应用指导 最大响应时间 特性说明 300 毫秒 / 参数 整型。查询类型。 0 查询指定的连接状态 1 查询指定的连接状态 整型。场景 ID。范围：1~3。 整型。Socket ID。范围：0~4。 字符串类型。Socket 服务类型。 'TCP' 客户端创建 TCP 连接 'UDP' 客户端创建 UDP 连接 字符串类型。远程客户端的 IP 地址。 字符串类型。远程服务器的域名地址。 整型。远程服务器的端口号。 整型。分配的本地端口号。 整型。Socket 状态。 0 'Initial'：客户端连接尚未建立 1 'Connecting'：客户端正在连接 2 'Connected'：客户端连接已经创建成功 3 'Closing'：客户端连接正在关闭 4 'Remote Closing'：远程服务器正在关闭客户端连接 整型。数据访问模式。 0 缓存模式 1 直吐模式 备注 1. 目前仅支持=1。 2. 若响应中无+QISTATE: 列表，则说明当前没有连接。 2.2.4. AT+QISEND 发送十六进制/文本字符串数据 该命令用于通过指定连接发送十六进制或文本字符串格式的 Socket 数据。 AT+QISEND 发送十六进制/文本字符串数据 测试命令 AT+QISEND=? 响应 +QISEND: (支持的范围),(支持的范围), 上海移远通信技术股份有限公司 10 / 40 BC26&BC20 TCP/IP 应用指导 OK 设置命令 AT+QISEND=,, 响应 若数据发送成功： OK SEND OK 若数据发送失败： OK SEND FAIL 设置命令 数据模式下发送不定长数据 AT+QISEND= 若有任何错误： ERROR 响应 > 响应 >后，模块将在 500 毫秒内进入数据模式；之后可直接输 入待发数据，按 Ctrl+Z 发送数据，按 Esc 取消发送。 若数据发送成功： OK SEND OK 若数据发送失败： OK SEND FAIL 设置命令 数据模式下发送定长数据 AT+QISEND=, 若有任何错误： ERROR 响应 > 响应 >后，模块将在 500 毫秒内进入数据模式；之后即可输入 长度等于的待发数据。 若数据发送成功： OK SEND OK 若数据发送失败： OK 上海移远通信技术股份有限公司 11 / 40 BC26&BC20 TCP/IP 应用指导 SEND FAIL 若有任何错误： 设置命令 查询已应答和已发送但未应答数据的总 长 度 （ 包 含 通 过 AT+QISENDEX 和 AT+QISEND 发送的全部数据） AT+QISEND=,0 ERROR 响应 +QISEND: ,, OK 若有任何错误： ERROR 最大响应时间 300 毫秒 特性说明 / 参数 整型。Socket ID。范围：0~4。 整型。待发数据长度。单位：字节。 在非数据模式（命令模式）下，文本格式数据的最大长度 1024 字节，十六进制格式数 据的最大长度是 512 字节。 在数据模式下，文本格式数据的最大长度是 1460 字节，十六进制格式数据的最大长度 是 730 字节。 字符串类型。待发送的十六进制或文本格式数据。 整型。通过会话已发送数据的总长度。单位：字节。 整型。远程服务器已应答数据的总长度；仅 TCP 会话时可用。 整型。已发送但是还未被远程服务器应答的数据总长度；仅 TCP 会话时可用。 备注 1. SEND OK 仅表示数据已经发送至协议栈。 2. 的值和的实际长度必须一致。 3. 为特殊格式（如 JSON）字符时，必须为带双引号的字符串。目前，不支持特殊命令字 符，如分号（;）。 4. MCU 应在收到 SEND OK 或者 SEND FAIL 响应后再继续发送下一条数据。 5. 在数据模式下发送数据时，建议返回 > 后等待 500 毫秒再发送数据。 2.2.5. AT+QIRD 读取 TCP/IP 数据 该命令用于读取从指定连接接收的 Socket 数据。 上海移远通信技术股份有限公司 12 / 40 BC26&BC20 TCP/IP 应用指导 在 缓 存 模 式 下 ， 模 块 接 收 到 数 据 后 会 先 缓 存 数 据 ， 并 向 外 部 MCU 上 报 URC +QIURC: 'recv',[,]以告知接收到新的下行数据。 AT+QIRD 读取 TCP/IP 数据 测试命令 AT+QIRD=? 响应 +QIRD: (支持的范围),(支持的 范围) 设置命令 AT+QIRD=, OK 响应 若指定连接收到数据： +QIRD: [,] OK 若没有收到数据： +QIRD: 0 OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。Socket ID。范围：0~4。 整型。待读取数据的最大长度。范围 1~512；单位：字节。 整型。已读取数据的长度。单位：字节。 整型。剩余数据的长度。单位：字节。 读取的数据。 备注 1. 接收缓存池仍有数据未读取时，模块若再接收到下行数据将不会上报新的 URC；只有当缓存池中所 有数据均被读取完成后，才会上报新的 URC。 2. 配置 AT+QICFG='showlength',1（详情请参考第 2.1.12 章节）后，模块才会在缓存模式下显示该 命令返回值中的可选参数。 3. 剩余数据长度并非缓存池中已接收数据的总长度，仅表示某一个节点中保存的当前剩余数据长度。 上海移远通信技术股份有限公司 13 / 40 BC26&BC20 TCP/IP 应用指导 2.2.6. AT+QISENDEX 发送十六进制字符串数据 该命令用于通过指定连接发送十六进制字符串 Socket 数据。 AT+QISENDEX 发送十六进制字符串数据 测试命令 AT+QISENDEX=? 响应 +QISENDEX: (支持的范围),(支持的范围), 设置命令 AT+QISENDEX=,, OK 响应 若数据发送成功： OK SEND OK 若数据发送失败： OK SEND FAIL 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。Socket ID。范围：0~4。 整型。待发数据的长度。最大长度为 512 字节。 字符串类型。待发送数据。 备注 1. SEND OK 仅表示数据已经发送至协议栈。 2. MCU 应在收到 SEND OK 或者 SEND FAIL 响应后再继续发送下一条数据。 2.2.7. AT+QISWTMD 切换数据访问模式 打开新 Socket 时，模块可通过 AT+QIOPEN 的指定数据访问模式；之后可通过此命 令切换数据访问模式。 上海移远通信技术股份有限公司 14 / 40 BC26&BC20 TCP/IP 应用指导 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应 +QISWTMD: (支持的范围),(支持的列表) 设置命令 AT+QISWTMD=, 最大响应时间 特性说明 OK 响应 OK 若有任何错误： ERROR 300 毫秒 该命令立即生效。 深休眠唤醒后仍有效；参数配置不保存至 NVRAM。 参数 整型。Socket ID。范围：0~4。 整型。Socket 的数据访问模式。 0 缓存模式 1 直吐模式 2.2.8. AT+QPING Ping 远程服务器 该命令用于测试主机设备的 IP 地址是否可达。 AT+QPING Ping 远程服务器 测试命令 AT+QPING=? 响应 +QPING: (支持的范围),''[,(支持的范围)[,(支持的范围)[,(支持的范围)]]] 设置命令 AT+QPING=,''[,[,[,]]] OK 响应 若远程服务器 Ping 成功： OK +QPING: [,,,,] […] 上海移远通信技术股份有限公司 15 / 40 BC26&BC20 TCP/IP 应用指导 最大响应时间 特性说明 +QPING: [,,,,,,] 若有任何错误： ERROR 300 毫秒 / 参数 整型。场景 ID。范围：1~3。 字符串类型。远程服务器地址，格式为域名或者 IP 地址。最大长度：150 字节。 整型。每次 Ping 请求后等待响应的最大时长。范围：1~255，默认值：4，单位：秒。 整型。发送 Ping 请求最大次数。范围：1~10，默认值：4。 整型。每次 Ping 请求的大小。范围：32~200，默认值：32，单位：字节。 整型。每次 Ping 请求的结果。 0 接收到远程服务器的 Ping 响应 其他 错误码；请参考第 3 章获取详细错误码信息 字符串类型。远程服务器的 IP 地址。 整型。每次发送的 Ping 请求长度。单位：字节。 整型。发送 Ping 请求花费的时间。单位：毫秒。 整型。Ping 请求的 TTL 值。 整型。Ping 操作的最终结果。 0 Ping 成功 其他 错误码；请参考第 3 章获取详细错误码信息 整型。Ping 请求发送的字节总长度。 整型。Ping 响应中接收到的字节总长度。 整型。Ping 请求中丢失的字节总长度。 整型。最小响应时间。单位：毫秒。 整型。最大响应时间。单位：毫秒。 整型。平均响应时间。单位：毫秒。 备注 目前仅支持=1。 2.2.9. AT+QNTP 通过 NTP 服务器同步本地时间 该命令通过 NTP 服务器同步本地时间为世界标准时间（UTC）。 上海移远通信技术股份有限公司 16 / 40 BC26&BC20 TCP/IP 应用指导 AT+QNTP 通过 NTP 服务器同步本地时间 测试命令 AT+QNTP=? 响应 +QNTP: (支持的范围),''[,[,(支 持的列表)]] 设置命令 AT+QNTP=,''[,< port>[,]] OK 响应 若同步成功： OK +QNTP: , 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。场景 ID。范围：1~3。 字符串类型。NTP 服务器地址，格式为域名或者点分十进制 IP 地址。最大长度：150 字节。 整型。NTP 服务器端口号。范围：0~65535，默认值：123。 整型。是否自动同步本地时间为 UTC。 0 不自动同步 1 自动同步 字符串类型。从 NTP 服务器上同步的时间。 格式为：'YY/MM/DD,hh:mm:ss±zz'，各字符分别表示年（YY）、月（MM）、日（DD）、 时（hh）、分（mm）、秒（ss）、时区（±zz）。±zz 的范围为-47 ~ +48。 整型。错误码，详情请参考第 3 章。 备注 1. 目前仅支持=1。 2. 当=1，RTC 会自动更新到同步时间；随后可使用 AT+QCCLK?查询更新后的时间。 3. 注网成功后，模块会自动更新 RTC 时间。 2.2.10. AT+QIDNSGIP 转换域名为 IP 地址 该命令用于将指定域名转换为 IP 地址。 上海移远通信技术股份有限公司 17 / 40 BC26&BC20 TCP/IP 应用指导 AT+QIDNSGIP 转换域名为 IP 地址 测试命令 AT+QIDNSGIP=? 响应 +QIDNSGIP: (支持的范围),' ' 设置命令 AT+QIDNSGIP=,'' OK 响应 OK +QIURC: 'dnsgip',,, [+QIURC: 'dnsgip',] […] 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。场景 ID。范围：1~3。 字符串类型。域名。最大长度：150 字节。 整型。参数对应的 IP 地址个数。 整型。DNS 的 TTL 值。 字符串类型。的 IP 地址。 整型。错误码，详情请参考第 3 章。 备注 目前仅支持=1。 2.2.11. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置主要和次要 DNS 服务器地址。 AT+QIDNSCFG 配置 DNS 服务器地址 测试命令 AT+QIDNSCFG=? 响应 +QIDNSCFG: (支持的范围),, 上海移远通信技术股份有限公司 18 / 40 BC26&BC20 TCP/IP 应用指导 OK 设置命令 配置主要和次要 DNS 服务器地址 AT+QIDNSCFG=,[,] 设置命令 DNS 服务器地址成功配置后，查询主要 和次要 DNS 服务器地址 AT+QIDNSCFG= 响应 OK 若有任何错误： ERROR 响应 [+QIDNSCFG: ,[,]] OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效。 深休眠唤醒后仍有效；参数配置不保存至 NVRAM。 参数 整型。场景 ID。范围：1~3。 字符串类型。主要 DNS 服务器的 IP 地址。最大长度：64 字节。 字符串类型。次要 DNS 服务器的 IP 地址。最大长度：64 字节。 备注 1. 目前仅支持=1。 2. 若网络仅支持 IPv4，则只能设置 IPv4 DNS 地址；若网络仅支持 IPv6，则只能设置 IPv6 DNS 地址。 3. 模块开机后，需等 IP 地址 URC（例如：+IP: 10.18.237.42，表明模块注网成功）上报完成后方可执 行设置命令。 4. AT+QIDNSCFG=可查询模块默认的 DNS 服务器或者网络下发的 DNS 服务器。 2.2.12. AT+QICFG 配置可选参数 该命令可为 TCP/IP 各项功能配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应 +QICFG: 'dataformat',( 支 持 的 列 表),(支持的列表) +QICFG: 'viewmode',(支持的列表) 上海移远通信技术股份有限公司 19 / 40 BC26&BC20 TCP/IP 应用指导 +QICFG: 'showlength',(支持的列 表) +QICFG: 'echomode',(支持的列表) 设置命令 查询/设置发送/接收数据的格式 AT+QICFG='dataformat'[,,] OK 响应 若省略可选参数，则查询当前配置： +QICFG: 'dataformat',, OK 若指定可选参数，则设置发送数据格式和接收数据格式： OK 设置命令 查询/设置已接收数据的输出格式 AT+QICFG='viewmode'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'viewmode', OK 若指定可选参数，则设置已接收数据的输出格式： OK 设置命令 查询/设置在缓存模式下是否显示可选数 据长度参数 1) AT+QICFG='showlength'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'showlength', OK 若指定可选参数，则设置在缓存模式下是否显示可选数据长度 参数： OK 设置命令 查询/设置在数据模式下是否向 UART 回 显输入数据 AT+QICFG='echomode'[,<echo_mo 若有任何错误： ERROR 响应 若省略可选参数，则查询当前配置： +QICFG: 'echomode', 上海移远通信技术股份有限公司 20 / 40 BC26&BC20 TCP/IP 应用指导 de>] 最大响应时间 特性说明 OK 若指定可选参数，则设置在数据模式下是否向 UART 回显输入 数据： OK 若有任何错误： ERROR 300 毫秒 该命令立即生效。 1. 、、 和参数配置自动保 存至 NVRAM；深休眠唤醒后仍有效。 2. 参数配置不保存至 NVRAM；深休眠唤醒后 无效。 参数 整型。发送数据的格式。 0 文本字符串格式 1 十六进制格式 整型。接收数据的格式。 0 文本字符串格式 1 十六进制格式 整型。已接收数据的输出格式。 0 已接收数据输出格式：data headerrndata 1 已接收数据输出格式：data header,data 整型。在缓存模式下是否显示可选数据长度参数 1)。 0 不显示 1 显示 整型。是否在数据模式下向 UART 回显输入数据。 0 不回显 1 回显 备注 1. 1) 所述可选数据长度参数包含：  下行数据已达 URC +QIURC: 'recv',[,]中的；  AT+QIRD 返回值中的。 2. 仅在数据模式下才有效，且仅 BC26NxR01A07/BC20NxR01A08 及之后的版本中支持 该参数。 上海移远通信技术股份有限公司 21 / 40 BC26&BC20 TCP/IP 应用指导 2.2.13. AT+QIGETERROR 查询最新一次错误码 该命令用于查询最新一次 TCP/IP 命令返回的错误码及其相应描述。 AT+QIGETERROR 查询最新一次错误码 测试命令 AT+QIGETERROR=? 执行命令 AT+QIGETERROR 响应 OK 响应 +QIGETERROR: , OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 字符串类型。详细的错误码描述，具体请参考第 3 章。 整型。错误码，详情请参考第 3 章。 2.3. URC 详解 TCP/IP AT 命令的 URC 统一以+QIURC: […]的格式上报。本文中 URC 前后的均将省略。 备注 1. 当模块在 PSM 模式下，不会上报 URC。 2. 当模块 Modem 在 DRX 或者 eDRX 模式下，URC 上报会有延迟，延迟时间依据寻呼周期而定。 3. 当模块 Modem 在连接状态下，会正常上报 URC。 4. URC 最大长度为 1400 字节。 5. 使用 UDP 直吐模式接收数据时，模块将丢弃总长度大于 1400 字节的 URC。 2.3.1. 连接断开 URC 当 TCP Socket 被 远 程 关 闭 或 者 因 为 网 络 异 常 而 断 开 时 ， 模 块 将 上 报 URC +QIURC: 'closed',。 上海移远通信技术股份有限公司 22 / 40 BC26&BC20 TCP/IP 应用指导 连接断开 URC +QIURC: 'closed', 表示 Socket 连接被断开 参数 整型。Socket ID。范围：0~4。 2.3.2. 下行数据已达 URC 当模块接收到下行数据时，会上报该 URC：  在缓存模式下，URC 格式为+QIURC: 'recv',[,]；  在直吐模式下，URC 格式为+QIURC: 'recv',, 。 下行数据已达 URC +QIURC: 'recv',,[] 表示缓存模式下有下行数据 +QIURC: 'recv',, 参数 整型。Socket ID。范围：0~4。 整型。实际接收到的数据长度。 接收到的数据。 备注 配置 AT+QICFG='showlength',1（详情请参考第 2.2.12 章节）后，缓存模式下上报的下行数据已达 URC 才会包含可选参数。 2.3.3. 下行数据缓存已满 URC 在缓存模式下，如果已经没有缓存资源可以分配给下行数据，模块会上报该 URC。 下行数据缓存已满 URC +QIURC: 'recv',,'buff full' 表示下行数据缓存已满。 上海移远通信技术股份有限公司 23 / 40 参数 BC26&BC20 TCP/IP 应用指导 整型。Socket ID。范围：0~4。 备注 缓存模式下，数据可分配的最大节点数为 20。 上海移远通信技术股份有限公司 24 / 40 BC26&BC20 TCP/IP 应用指导 3 错误码 执行 TCP/IP AT 命令后若有返回 ERROR 或，则具体的错误码信息可通过 AT+QIGETERROR 查询。AT+QIGETERROR 仅返回最新一个 TCP/IP AT 命令的错误码。 表 2：错误码列表 错误码 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 错误码描述 Operation successful Unknown error Operation blocked Invalid parameters Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy DNS parse failed 含义 操作成功 未知原因 操作受阻 无效参数 内存不足 创建 Socket 失败 操作不支持 Socket 绑定失败 Socket 监听失败 Socket 写入失败 Socket 读取失败 Socket 接受失败 打开 PDP 场景失败 关闭 PDP 场景失败 Socket ID 被占用 DNS 繁忙 NDS 解析失败 上海移远通信技术股份有限公司 25 / 40 566 Socket connection failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel send 572 Operation not allowed 573 APN not configured 574 Port busy BC26&BC20 TCP/IP 应用指导 Socket 连接失败 Socket 已被关闭 操作繁忙 操作超时 PDP 场景发生故障 取消发送 操作不允许 未配置 APN 端口繁忙 上海移远通信技术股份有限公司 26 / 40 BC26&BC20 TCP/IP 应用指导 4 举例 4.1. TCP 客户端使用说明 4.1.1. 初始化工作 AT+IPR=115200 OK AT+CPIN? +CPIN: READY //设置固定波特率为 115200 //查询 USIM 卡的 PIN 码是否已解 //已解 OK AT+CEREG? +CEREG: 0,1 //查询网络注册状态 //网络已注册，如果未注册成功，可以多次查询 OK AT+CGPADDR? //找网成功后，可通过此命令获取模块 IP 地址 +CGPADDR: 1,10.57.39.119 OK 备注 请确保 TCP/UDP 操作在模块获取到 IP（+IP: xxx）)地址上报之后再进行。 4.1.2. 建立 TCP 连接 AT+QIOPEN=1,0,'TCP','220.180.239.212',8164,1234,0 //远程地址：220.180.239.212，端口：8164； 本地端口为 1234，如果将其指定为 0，模块将 自动分配一个可用的端口号 OK +QIOPEN: 0,0 //建立连接成功 //更多连接信息可通过如下方式进行查询 上海移远通信技术股份有限公司 27 / 40 BC26&BC20 TCP/IP 应用指导 AT+QISTATE=1,0 //可查询连接状态信息 +QISTATE: 0,'TCP','220.180.239.212',8164,1234,2,1,0 //连接成功 OK AT+QIGETERROR +QIGETERROR: 0,operate successfully //查询最新一次错误码信息 //建立连接操作成功 OK 4.1.3. 配置发送的数据格式（配置为文本字符串格式） AT+QICFG='dataformat',0,0 //配置发送的数据格式为文本字符串（=0） //此为默认配置（文本字符串） OK //配置完成后，会立即生效并自动保存至 NVRAM，无须重复配置 AT+QICFG='dataformat' //查询配置是否成功 +QICFG: 'dataformat',0,0 //发送的数据格式为文本字符串（=0） OK 4.1.4. 配置发送的数据格式（配置为十六进制格式） AT+QICFG='dataformat',1,0 //配置发送的数据格式为十六进制格式（=1） //此配置默认为=0（文本字符串） OK //配置完成后，会立即生效并自动保存至 NVRAM，无须重复配置 AT+QICFG='dataformat' //查询配置是否成功 +QICFG: 'dataformat',1,0 //发送的数据格式为十六进制格式（=1） OK 4.1.5. 配置在数据模式下是否回显 AT+QICFG='echomode',0 OK AT+QICFG='echomode' +QICFG: 'echomode',0 //配置在数据模式（data mode）下将输入的数据不回显到 UART 串 口（=0） //此配置默认为=1（回显数据模式下输入的数据到 UART 串口） //配置完成；重启或退出深休眠后需要重新配置 //查询配置结果 //不回显（=0） OK 上海移远通信技术股份有限公司 28 / 40 BC26&BC20 TCP/IP 应用指导 4.1.6. 发送文本数据（命令模式） AT+QISEND=0,10,'1234567890' OK //发送 10 字节数据 1234567890 //命令中需要和实际长度保持一致 SEND OK AT+QISEND=0,17,'{'a':'b','b':'b'}' //发送 17 字节数据{'a':'b','b':'b'} //命令中需要和实际长度保持一致 //发送 JSON 格式等特殊字符数据时，必须使用双引号将数据包 围 OK SEND OK 4.1.7. 发送文本数据（定长数据模式） AT+QISEND=0,10 > 1234567890 OK //发送 10 字节数据 //进入数据模式，等待数据输入 //必须输入 10 字节才会退出数据模式并发送 SEND OK AT+QISEND=0,17 > {'a':'b','b':'b'} OK //发送 17 字节数据 //进入数据模式，等待数据输入 //进入数据模式，任何字符都是数据，无须用双引号包围 //必须输入 17 字节才会退出数据模式并发送 SEND OK AT+QICFG='echomode',0 OK AT+QISEND=0,10 > OK //在数据模式（data mode）下将输入的数据不回显到 UART 串口 （=0） //发送 10 字节数据 //进入数据模式，等待数据输入 //输入 10 字节数据：1234567890；此处不回显 1234567890，数据输入 完成后自动退出数据模式并发送 SEND OK 上海移远通信技术股份有限公司 29 / 40 BC26&BC20 TCP/IP 应用指导 4.1.8. 发送文本数据（不定长数据模式） AT+QISEND=0 > 1234567890 OK //发送不定长字节数据 //进入数据模式，等待数据输入 //输入数据后按 Ctrl+Z 会退出数据模式并发送 SEND OK AT+QISEND=0 > {'a':'b','b':'b'} OK //发送不定长字节数据 //进入数据模式，等待数据输入 //进入数据模式，任何字符都是数据，无须用双引号包围；输入数据 后按 Ctrl+Z 会退出数据模式并发送 SEND OK AT+QICFG='echomode',0 OK AT+QISEND=0 > OK //在数据模式（data mode）下将输入的数据不回显到 UART 串口 （=0） //发送不定长字节数据 //进入数据模式，等待数据输入 //输入 10 字节数据：1234567890；此处不回显 1234567890，数据 输入完成后按 Ctrl+Z 会退出数据模式并发送 SEND OK 4.1.9. 发送十六进制数据（命令模式） AT+QISENDEX=0,3,313233 OK //发送十六进制字符串数据（模块自动将十六进制数据 313233 转换为 文本数据 123 并发送到服务端） //注意需要满足十六进制格式，否则转换会失败返回 ERROR //注意命令中应该等于长度除以 2 SEND OK AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 //查询当前配置 //发送的数据为十六进制格式（=1） OK AT+QISEND=0,3,313233 //发送十六进制字符串数据（模块自动将十六进制数据 313233 转换为 文本数据 123 并发送到服务端） //注意需要满足十六进制格式，否则转换会失败返回 ERROR 上海移远通信技术股份有限公司 30 / 40 OK SEND OK BC26&BC20 TCP/IP 应用指导 //注意命令中应该等于长度除以 2 4.1.10. 发送十六进制数据（定长数据模式） AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 //查询当前配置 //=1（发送的数据为十六进制格式） OK AT+QISEND=0,10 > 31323334353637383930 OK //发送 10 字节十六进制数据 //进入数据模式，等待数据输入 //必须输入 20 字节才会退出数据模式并发送 //注意必须为十六进制格式，否则会返回 ERROR //注意命令中应该等于长度除以 2 SEND OK AT+QICFG='echomode',0 OK AT+QISEND=0,5 > OK //数据模式（data mode）下输入的数据不回显到 UART 串口 （=0） //发送 5 字节数据 //进入数据模式，等待数据输入 //输入数据 3132333435；此处不回显 3132333435，数据输入完成后 自动退出数据模式并发送 SEND OK 4.1.11. 发送十六进制数据（不定长数据模式） AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 //查询当前配置 //发送的数据为十六进制格式（=1） OK AT+QISEND=0 > 3132333435 OK //发送不定长字节数据 //进入数据模式，等待数据输入 //输入数据后按 Ctrl+Z 会退出数据模式并发送 //注意需要满足十六进制格式，否则会报 ERROR SEND OK 上海移远通信技术股份有限公司 31 / 40 BC26&BC20 TCP/IP 应用指导 4.1.12. ACK 响应检查 AT+QISEND=0,0 +QISEND: 94,94,0 OK //=0（查询已发送、已收到 ACK 响应以及未收到 ACK 响应的数据长度） //链路建立连接到断开连接过程中累计发送了 94 字节，94 个均收到 了 ACK 响应，0 个未响应 //连接断开后数据会重置为 0 4.1.13. 配置接收的数据格式（配置为文本字符串格式） AT+QICFG='dataformat',0,0 //配置接收的数据格式为文本字符串（=0） //此为默认配置（文本字符串） OK //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置 AT+QICFG='dataformat' //查询配置是否成功 +QICFG: 'dataformat',0,0 //接收的数据格式为文本字符串（=0） OK //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 AT+QIRD=0,512 //提示模块已收到远程服务器下发的数据 //读取缓存中的数据（最大 512 字节） +QIRD: 19 hi, i am tcp server //读取到了 19 字节数据（包括空格） OK OK 4.1.14. 配置接收的数据格式（配置为十六进制格式） AT+QICFG='dataformat',0,1 //配置接收的数据格式为十六进制格式（=1） //此配置默认为=0（文本字符串） OK //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置 AT+QICFG='dataformat' +QICFG: 'dataformat',0,1 //查询配置是否成功 //接收的数据格式为十六进制格式（=1） OK //远程服务器向模块发送了'1234567890'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 //读取缓存中的数据（最大 512 字节） +QIRD: 10 31323334353637383930 //读取到 10 字节文本数据 1234567890 后自动转换成十六进制格式数据 上海移远通信技术股份有限公司 32 / 40 BC26&BC20 TCP/IP 应用指导 OK 4.1.15. 配置所接收数据的输出格式（配置为换行格式） AT+QICFG='viewmode',0 OK AT+QICFG='viewmode' +QICFG: 'viewmode',0 //配置所接收数据的输出格式为：data headerrndata（=0） //此为配置默认 //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置 //查询配置信息 //所接收数据的输出格式为 data headerrndata（=0） OK //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 //读取缓存中的数据（最大 512 字节） +QIRD: 19 //读取到 19 字节数据 hi, i am tcp server //所读取到的 19 字节数据为：'hi, i am tcp server' OK 4.1.16. 配置所接收数据的输出格式（配置为逗号分隔格式） AT+QICFG='viewmode',1 OK AT+QICFG='viewmode' +QICFG: 'viewmode',1 //配置所接收数据的输出格式为：data header,data（=1） //此命令配置默认为=0（data headerrndata） //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置 //查询配置信息 //所接收数据的输出格式为 data header,data（=1） OK //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 //读取缓存中的数据（最大 512 字节） +QIRD: 19,hi, i am tcp server //读取到的数据长度和读取到的数据显示在同一行，用逗号分隔；读取到 的 19 字节数据为 hi, i am tcp server OK 上海移远通信技术股份有限公司 33 / 40 BC26&BC20 TCP/IP 应用指导 4.1.17. 所接收数据的存取方式（缓存模式） AT+QIOPEN=1,0,'TCP','220.180.239.212',8164,1234,0 //=0（缓存模式） //=0 为默认配置 //缓存模式下，需要用 AT+QIRD=读取数据 OK +QIOPEN: 0,0 //建立连接成功 AT+QISTATE=1,0 //查询连接状态信息 +QISTATE: 0,'TCP','220.180.239.212',8164,1234,2,1,0 //连接成功，=0（缓存模式） OK 连接建立后，可随时进行切换： AT+QISWTMD=0,0 OK //更改默认的数据存取方式后，可通过此命令切换回默认的缓存模式 //缓存模式下，需要用 AT+QIRD=读取数据 //配置完成后，将立即生效并自动保存到 NVRAM，无须重新配置 //立即生效 数据读取方法： //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 //读取缓存中的数据（最大 512 字节） +QIRD: 19 //读取到 19 字节数据 hi, i am tcp server //所读取到的 19 字节数据为：hi, i am tcp server OK +QIURC: 'recv',0,'buff full' //当缓存队列满了后，会主动上报此 URC，表示队列已满 备注 最大缓存队列节点数为 20 个，建议在缓存模式下，及时使用 AT+QIRD 命令读取数据，否则容易导致数 据丢失。 4.1.18. 所接收数据的存取方式（缓存模式下显示长度） AT+QICFG='showlength',0 OK //在缓存模式下不显示所接收数据的长度和剩余读取长度 （=0） //此为默认配置 //配置完成后，将立即生效并自动保存到 NVRAM，无须重新配置 上海移远通信技术股份有限公司 34 / 40 BC26&BC20 TCP/IP 应用指导 AT+QICFG='showlength' +QICFG: 'showlength',0 //查询配置信息 //=0（不显示所接收数据的长度和剩余读取长度） OK //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 //读取缓存中的数据（最大 512 字节） +QIRD: 19 //此处未显示读取剩余长度 hi, i am tcp server //读取到的 19 字节数据为：'hi, i am tcp server' OK AT+QICFG='showlength',1 OK AT+QICFG='showlength' +QICFG: 'showlength',1 //在缓存模式下显示接收数据长度和剩余读取长度 （=1） //此配置默认为=0（不显示所接收数据的长度和剩 余读取长度） //配置完成后，将立即生效并自动保存到 NVRAM，无须重新配置 //查询配置信息 //=1（显示接收数据长度和剩余读取长度） OK //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0,19 //提示模块已收到远程服务器下发的数据，所接收数据长度为 19 字节 AT+QIRD=0,10 //读取缓存中的数据（一次最大读取 10 字节） +QIRD: 10,9 //此处显示已经读取到 10 字节数据，还剩余 9 字节未读取 hi, i am t //所读取的 10 字节数据为 hi, i am t OK AT+QIRD=0,10 +QIRD: 9,0 cp server //此处显示已经读取到剩余的 9 字节，全部数据已经读完 //所读取的 9 字节数据为 cp server OK AT+QIRD=0,10 +QIRD: 0 //此处显示无数据未读取 OK 上海移远通信技术股份有限公司 35 / 40 BC26&BC20 TCP/IP 应用指导 4.1.19. 所接收数据的存取方式（直吐模式） 建立连接配置： AT+QIOPEN=1,0,'TCP','220.180.239.212',8164,1234,1 //=1（直吐模式） //默认配置为=0（缓存模式） //后续收到数据时，直接通过+QIURC: 'recv'将数据推送出来 OK +QIOPEN: 0,0 //建立连接成功 AT+QISTATE=1,0 //查询连接状态信息 +QISTATE: 0,'TCP','220.180.239.212',8164,1234,2,1,1 //连接成功，=1（直吐模式） OK 连接建立后，可随时进行切换： AT+QISWTMD=0,1 OK //切换所接收数据的存取方式为直吐模式 //后续收到数据时，直接通过+QIURC: 'recv'将数据推送出来 //立即生效 数据读取方法：无须主动使用命令读取，直接以 URC 形式显示 +QIURC: 'recv',0,19 hi, i am tcp server //提示模块已收到远程服务器下发的数据，所接收数据长度为 19 字节 //自动推送了所接收到的 19 字节数据 hi, i am tcp server OK 4.1.20. 关闭连接 AT+QICLOSE=0 OK CLOSE OK //主动断开 //断开连接成功 备注 考虑网络异常等因素，建议关闭连接前，先进行发送数据的 ACK 响应检查，检查无异后再关闭连接，如 果存在，关闭后重新建立链路重发未 ACK 的数据。 上海移远通信技术股份有限公司 36 / 40 BC26&BC20 TCP/IP 应用指导 4.2. TCP 长连接的会话保活说明 关于多长时间没有数据交互，就会释放资源，目前来说，没有一个明确的值，目前测试情况是 10 分钟 内，基本就可以保持端口资源不会被释放。如果需要保持长连接，建议每隔一定时间（10 分钟）以内就向 服务器发送一个短数据包，通过这个方法可以进行会话保活。 基于此，如果很长时间不用发送数据，在重新发数据时可以通过如下方法进行会话校验： AT+QISEND=0,3,'ACK' OK //先发一个短包（发送的数据可以根据需求自由定制） SEND OK AT+QISEND=0,0 +QISEND: 3,0,3 //再发送一个校验包 //发送的心跳字节，均未得到服务器的响应 SEND OK //等待 30 秒后 +QIURC: 'closed',0 //会收到提示连接已断开的 URC，此时会话已经被关闭，需要重连 //如果一直未收到提示连接已断开的 URC，需要等待 120 秒后 AT+QISEND=0,0 //再发送一个校验包 +QISEND: 3,0,3 //发送的心跳字节，均未得到服务器的响应 SEND OK //如果此时仍未收到服务器响应，需要主动关闭连接并重连 AT+QICLOSE=0 //主动断开 OK CLOSE OK //断开连接成功 4.3. Ping 远程服务器 AT+QPING=1,'iot.quectel.com' OK +QPING: 0,'47.100.63.174',32,560,88 +QPING: 0,'47.100.63.174',32,220,88 上海移远通信技术股份有限公司 37 / 40 BC26&BC20 TCP/IP 应用指导 +QPING: 0,'47.100.63.174',32,230,88 +QPING: 0,'47.100.63.174',32,280,88 +QPING: 0,4,4,0,220,560,322 4.4. 同步本地时间 AT+QNTP=1,'ntp5.aliyun.com' OK //使用域名为 ntp5.aliyun.com 的 NTP 服务器同步本地时间。 +QNTP: 0,'19/06/11,11:08:20+32' 4.5. 配置 DNS 服务器 AT+QIDNSCFG=1,'218.2.2.2','8.8.8.8' OK AT+QIDNSCFG=1 +QIDNSCFG: 1,'218.2.2.2','8.8.8.8' OK 4.6. 查询最新一次错误码 AT+QIOPEN=1,'UDP','220.180.239.212',8063,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552,invalid parameters OK //打开任意一个 Socket。 上海移远通信技术股份有限公司 38 / 40 BC26&BC20 TCP/IP 应用指导 5 附录 A 术语缩写 表 3：术语缩写 术语 英文全称 ACK Acknowledge character APN Access Point Name eDRX extended Discontinuous Reception DNS Domain Name System DRX Discontinuous Reception ID Identifier IP Internet Protocol IPv4 Internet Protocol version 4 IPv6 Internet Protocol version 6 JSON JavaScript Object Notation NVRAM Non-Volatile Random Access Memory MCU Micro Controller Unit ME Mobile Equipment NB-IoT Narrow Band Internet of Things NTP Network Time Protocol PDP Packet Data Protocol PIN Personal Identification Number PPP Point to Point Protocol PSM Power Saving Mode 上海移远通信技术股份有限公司 中文全称 确认字符 接入点名称 扩展不连续接收 域名系统 非连续接收 标识符 互联网协议 互联网协议版本 4 互联网协议版本 6 JS 对象简谱 非易失性随机访问存储器 微控制器 移动设备 窄带物联网 网络时间协议 分组数据协议 个人身份识别码 点对点协议 省电模式 39 / 40 BC26&BC20 TCP/IP 应用指导 RTC TCP TTL UART UDP URC USIM UTC Real Time Clock Transmission Control Protocol Time to Live Universal Asynchronous Receiver/Transmitter User Datagram Protocol Unsolicited Result Code Universal Subscriber Identity Module Universal Time Coordinated 实时时钟 传输控制协议 保活时间 通用异步收发传输器 用户数据报协议 非请求结果码 全球用户识别卡 世界标准时间 上海移远通信技术股份有限公司 40 / 40

BC26&BC20 SSL 应用指导 NB-IoT 模块系列 版本：BC26&BC20_SSL_应用指导_V1.0 日期：2020-05-28 状态：受控文件 www.quectel.com BC26&BC20 SSL 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 20 文档历史 修订记录 版本 日期 1.0 2020-05-28 作者 变更表述 蒋涛/李建 初始版本 BC26&BC20 SSL 应用指导 上海移远通信技术股份有限公司 2 / 20 BC26&BC20 SSL 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 1.1. SSL 版本 .................................................................................................................................... 5 1.2. SSL 加密套件 ............................................................................................................................. 5 2 SSL AT 命令详解 .................................................................................................................................. 7 2.1. AT 命令语句................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句..................................................................................................................... 7 2.2. AT 命令详解................................................................................................................................ 8 2.2.1. AT+QSSLCFG 配置 SSL 上下文参数........................................................................... 8 2.2.2. AT+QSSLOPEN 建立 SSL 连接 ................................................................................. 12 2.2.3. AT+QSSLSEND 发送数据 .......................................................................................... 13 2.2.4. AT+QSSLCLOSE 断开 SSL 连接 ............................................................................... 14 2.3. URC 详解 ................................................................................................................................. 15 2.3.1. +QSSLURC: 'recv' 通知 MCU 接收到新数据 ............................................................ 16 2.3.2. +QSSLURC: 'closed' 通知 MCU SSL 连接将断开 .................................................... 16 3 举例 ..................................................................................................................................................... 17 3.1. 双向认证的 SSL 功能 ............................................................................................................... 17 4 错误码 ................................................................................................................................................. 19 5 附录 A 参考文档和术语缩写 .............................................................................................................. 20 上海移远通信技术股份有限公司 3 / 20 BC26&BC20 SSL 应用指导 表格索引 表 1：SSL 版本 ............................................................................................................................................ 5 表 2：支持的 SSL 加密套件 ......................................................................................................................... 5 表 3：AT 命令及响应类型............................................................................................................................. 7 表 4：错误码概览 ....................................................................................................................................... 19 表 5：术语缩写 ........................................................................................................................................... 20 上海移远通信技术股份有限公司 4 / 20 BC26&BC20 SSL 应用指导 1 引言 本文档介绍如何使用移远通信 BC26 和 BC20 NB-IoT 模块的 SSL 功能。 为确保通信的私密性，在某些情况下，服务器和客户端之间的通信应采用加密方式，以防止在通信过 程中数据被窃听、篡改或伪造。SSL 功能即可满足上述需求。 1.1. SSL 版本 下表为移远通信 BC26 和 BC20 NB-IoT 模块支持的 SSL 版本。 表 1：SSL 版本 SSL 版本 SSL 3.0 TLS 1.0 TLS 1.1 TLS 1.2 1.2. SSL 加密套件 下表为移远通信 BC26 和 BC20 NB-IoT 模块支持的 SSL 加密套件。有关加密套件的详细说明，请参阅 https://www.iana.org/assignments/tls-parameters/tls-parameters.xhtml。 表 2：支持的 SSL 加密套件 加密套件代码 0X003D 加密套件名称（IANA 官方名称） TLS_RSA_WITH_AES_256_CBC_SHA256 上海移远通信技术股份有限公司 5 / 20 0X0035 0X003C 0X002F 0X000A 0X00AF 0X008D 0X00AE 0X008C 0X008B 0X00FF BC26&BC20 SSL 应用指导 TLS_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA256 TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_PSK_WITH_AES_256_CBC_SHA384 TLS_PSK_WITH_AES_256_CBC_SHA TLS_PSK_WITH_AES_128_CBC_SHA256 TLS_PSK_WITH_AES_128_CBC_SHA TLS_PSK_WITH_3DES_EDE_CBC_SHA TLS_EMPTY_RENEGOTIATION_INFO_SCSV 上海移远通信技术股份有限公司 6 / 20 BC26&BC20 SSL 应用指导 2 SSL AT 命令详解 2.1. AT 命令语句 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应，省略。 表 3：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 7 / 20 BC26&BC20 SSL 应用指导 2.2. AT 命令详解 2.2.1. AT+QSSLCFG 配置 SSL 上下文参数 该命令用于配置 SSL 功能相关的参数，如认证模式、协议版本、发送和接受数据的格式等。 AT+QSSLCFG 配置 SSL 上下文参数 测试命令 AT+QSSLCFG=? 响应 +QSSLCFG: (支持的范围),(支持的 范围) +QSSLCFG: (支持的范围),(支持的 范围),'seclevel'[,(支持的范围)] +QSSLCFG: (支持的范围),(支持的 范围),'sslversion'[,(支持的范围)] +QSSLCFG: (支持的范围),(支持的 范围),'dataformat'[,(支持的列表),(支 持的列表)] +QSSLCFG: (支持的范围),(支持的 范围),'timeout'[,(支持的范围)] +QSSLCFG: (支持的范围),(支持的 范围),'debug'[,(支持的范围)] +QSSLCFG: (支持的范围),(支持的 范围),'cacert' +QSSLCFG: (支持的范围),(支持的 范围),'clientcert' +QSSLCFG: (支持的范围),(支持的 范围),'clientkey' 设置命令 查询指定上下文的设置： AT+QSSLCFG=, OK 响应 +QSSLCFG: ,,'seclevel', +QSSLCFG: ,,'sslversion', +QSSLCFG: ,,'dataformat',, +QSSLCFG: ,,'timeout', +QSSLCFG: ,,'debug', +QSSLCFG: ,,'cacert', +QSSLCFG: ,,'clientcert', +QSSLCFG: ,,'clientkey', OK 设置命令 AT+QSSLCFG=,,'seclevel'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的认证模式： +QSSLCFG: ,,'seclevel', OK 若指定可选参数，则为指定 SSL 上下文设置认证模式： OK 设置命令 AT+QSSLCFG=,,'sslversion'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的协议版本： +QSSLCFG: ,,'sslversion', OK 若指定可选参数，则为指定 SSL 上下文设置协议版本： OK 设置命令 AT+QSSLCFG=,,'dataformat'[,,] 若有任何错误： ERROR 响应 若省略可选参数，则查询发送/接收数据的格式： +QSSLCFG: ,,'dataformat',, OK 若指定可选参数，则配置发送/接收数据的格式： OK 若有任何错误： ERROR 上海移远通信技术股份有限公司 9 / 20 BC26&BC20 SSL 应用指导 设置命令 AT+QSSLCFG=,,'timeout'[,] 响应 若省略可选参数，则查询指定 SSL 上下文的连接和信息发送超 时时间： +QSSLCFG: ,,'timeout', OK 若指定可选参数，则配置指定 SSL 上下文的连接和信息发送超 时时间： OK 设置命令 AT+QSSLCFG=,,'debug'[,] 若有任何错误： ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的 Mbed TLS 库调 试日志打印等级： +QSSLCFG: ,,'debug', OK 若指定可选参数，则配置指定 SSL 上下文的 Mbed TLS 库调 试日志打印等级： OK 设置命令 为指定的 SSL 上下文配置 PEM 格式的受 信任 CA 证书内容： AT+QSSLCFG=,,'cacert' 若有任何错误： ERROR 响应 > 响应 >后，模块将在 500 毫秒内进入数据模式；之后即可直接 输入待发数据，按 Ctrl+Z 发送，按 Esc 取消发送。 +QSSLCFG: ,,'cacert', OK 设置命令 为指定的 SSL 上下文配置 PEM 格式的客 户端证书内容： AT+QSSLCFG=, 响应 >后，模块将在 500 毫秒内进入数据模式；之后即可直接 输入待发数据，按 Ctrl+Z 发送，按 Esc 取消发送。 上海移远通信技术股份有限公司 10 / 20 BC26&BC20 SSL 应用指导 ID>,'clientcert' +QSSLCFG: ,,'clientcert', OK 设置命令 为指定的 SSL 上下文配置 PEM 格式的客 户端密钥内容： AT+QSSLCFG=,,'clientkey' 若有任何错误： ERROR 响应 > 响应 >后，模块将在 500 毫秒内进入数据模式；之后即可直接 输入待发数据，按 Ctrl+Z 发送，按 Esc 取消发送。 +QSSLCFG: ,,'clientkey', OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效。 深休眠唤醒无效；不保存至 NVRAM。 参数 整型。SSL 上下文标识符。范围：1~3。 整型。SSL Socket 标识符。范围：0~5。 整型。连接认证模式。 0 无认证 1 单向认证 2 双向认证 整型。连接协议版本。 0 SSL 3.0 1 TLS 1.0 2 TLS 1.1 3 TLS 1.2 4 所有协议均支持，具体使用的协议版本需要同服务器协商 整型。发送数据的格式。 0 文本字符号格式 1 十六进制格式 整型。接收数据的格式。 上海移远通信技术股份有限公司 11 / 20 BC26&BC20 SSL 应用指导 0 文本字符号格式 1 十六进制格式 整型。连接或消息传输的超时时间。范围：10~300；默认值：90；单位：秒。 整型。Mbed TLS 库调试日志打印等级。 0 不打印调试日志 1 打印 Error 相关调试日志 2 打印 State 相关调试日志 3 打印 Info 相关调试日志 4 打印 Detail 相关调试日志 整型。输入证书的总字节数，可用于本地校验。 备注 1. 目前仅支持=1。 2. 仅可在调试时使用；且设置等级越高（即参数值越大），获取到的日志就越多。 3. 若=0，则无需配置任何证书或密钥；若=1，则需配置 CA 证书；若=2， 则需配置 CA 证书、客户端证书和客户端密钥。 4. 在数据模式下发送数据时，建议返回 > 后等待 500 毫秒再发送数据。 2.2.2. AT+QSSLOPEN 建立 SSL 连接 该命令用于建立 SSL 连接。 AT+QSSLOPEN 建立 SSL 连接 测试命令 AT+QSSLOPEN=? 响应 +QSSLOPEN: (支持的范围),(支持的范围),,,(支持的列 表) 查询命令 AT+QSSLOPEN? 设置命令 AT+QSSLOPEN=,,,, OK 响应 OK 响应 OK +QSSLOPEN: ,, 最大响应时间 若有任何错误： ERROR 由 AT+QSSLCFG 的决定（默认 90 秒），且受网络 影响 上海移远通信技术股份有限公司 12 / 20 BC26&BC20 SSL 应用指导 特性说明 / 参数 整型。SSL 上下文标识符。范围：1~3。 整型。SSL Socket 标识符。范围：0~5。 字符串类型。SSL 服务器的 IP 地址或者域名。 整型。远程服务器的端口号。 整型。数据传输模式。 0 非透传模式 1 透传模式 整型。连接结果。详情请参考第 4 章。 0 执行成功 其他值 执行失败 备注 1. 目前仅支持=1。 2. 目前仅支持=0。 2.2.3. AT+QSSLSEND 发送数据 AT+QSSLSEND 发送数据 测试命令 AT+QSSLSEND=? 响应 +QSSLSEND: (支持的范围),(支持的范围)[,(支持的范围)] 查询命令 AT+QSSLSEND? 设置命令 发送不定长数据 AT+QSSLSEND=, OK 响应 OK 响应 > 响应 >后，模块将在 500 毫秒内进入数据模式；之后即可直接 输入待发数据，按 Ctrl+Z 发送数据，按 Esc 取消发送。 若 SSL 数据发送成功： OK +QSSLSEND: ,, 上海移远通信技术股份有限公司 13 / 20 BC26&BC20 SSL 应用指导 设置命令 发送定长数据 AT+QSSLSEND=,, 若 SSL 未连接、连接断开或者其他错误： ERROR 响应 > 响应 >后，模块将在 500 毫秒内进入数据模式；之后即可输入 长度等于的待发数据。 若 SSL 数据发送成功： OK +QSSLSEND: ,, 最大响应时间 特性说明 若 SSL 未连接、连接断开或者其他错误： ERROR 由 AT+QSSLCFG 的决定（默认 90 秒），且受网络 影响 / 参数 整型。SSL 上下文标识符。范围：1~3。 整型。SSL Socket 标识符。范围：0~5。 整型。待发送数据的长度。单位：字节。 文本字符串格式下范围：1~1460；十六进制格式下范围：1~730。 数 据 格 式 由 AT+QSSLCFG=,,'dataformat' 中 的 指定。 整型。连接结果。详情请参考第 4 章。 0 执行成功 其他值 执行失败 备注 1. 当 AT+QSSLCFG 中的设置为 1（十六进制格式），执行 AT+QSSLSEND=,,后输入的数据长度必须是的两倍。 2. 目前仅支持=1。 3. 在数据模式下发送数据时，建议返回 > 后等待 500 毫秒再发送数据。 2.2.4. AT+QSSLCLOSE 断开 SSL 连接 该命令用于断开 SSL 连接。若同一个 SSL 上下文的所有 SSL Socket 连接都已断开，则模块将释放该 SSL 上下文。 上海移远通信技术股份有限公司 14 / 20 BC26&BC20 SSL 应用指导 AT+QSSLCLOSE 断开 SSL 连接 测试命令 AT+QSSLCLOSE=? Response +QSSLCLOSE: (支持的范围),(支持的范围) 查询命令 AT+QSSLCLOSE? 设置命令 AT+QSSLCLOSE=, OK 响应 OK 响应 如果 SSL 连接被成功关闭： OK +QSSLCLOSE: ,, 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。SSL 上下文标识符。范围：1~3。 整型。SSL Socket 标识符。范围：0~5。 整型。连接结果。详情请参考第 4 章。 0 执行成功 其他值 执行失败 备注 目前仅支持=1。 2.3. URC 详解 SSL 相关的 URC 以+QSSLURC:开头，主要用于通知 MCU 收到新数据或 SSL 连接状态改变。 上海移远通信技术股份有限公司 15 / 20 BC26&BC20 SSL 应用指导 2.3.1. +QSSLURC: 'recv' 通知 MCU 接收到新数据 该 URC 用于通知 MCU 接收到新数据。 +QSSLURC: 'recv' 通知 MCU 接收到新数据 +QSSLURC: 'recv',,,, 参数 整型。SSL 上下文标识符。范围：1~3。 整型。SSL Socket 标识符。范围：0~5。 整型。数据长度。单位：字节。 文本字符串格式范围：1~1300；十六进制格式下范围：1~650。 字符串类型。模块接收的业务数据。最大长度：1300 字节。 2.3.2. +QSSLURC: 'closed' 通知 MCU SSL 连接将断开 该 URC 用于通知 MCU SSL 连接将断开。上报此 URC 后，模块将立即自动关闭 SSL 连接，MCU 无 需再执行 AT+QSSLCLOSE。 +QSSLURC: 'closed' 通知 MCU SSL 连接将断开 +QSSLURC: 'closed',,< 基于指定 Socket 的 SSL 连接将断开。 connectID> 参数 整型。SSL 上下文标识符。范围：1~3。 整型。SSL Socket 标识符。范围：0~5。 上海移远通信技术股份有限公司 16 / 20 BC26&BC20 SSL 应用指导 3 举例 3.1. 双向认证的 SSL 功能 AT+QSCLK=0 OK //禁用模块的休眠模式 //配置证书和密钥 AT+QSSLCFG=1,5,'seclevel',2 OK AT+QSSLCFG=1,5,'cacert' > //配置认证方式为双向认证 //配置 CA 证书 //输入 PEM 格式的 CA 证书内容，按 Ctrl+Z 发送 +QSSLCFG: 1,5,'cacert',1216 OK AT+QSSLCFG=1,5,'clientcert' > //配置客户端证书 //输入 PEM 格式的客户端证书内容，按 Ctrl+Z 发送 +QSSLCFG: 1,5,'clientcert',1224 OK AT+QSSLCFG=1,5,'clientkey' > //配置客户端密钥 //输入 PEM 格式的客户端密钥，按 Ctrl+Z 发送 +QSSLCFG: 1,5,'clientkey',1679 OK AT+QSSLOPEN=1,5,'hf.quectel.com',8164,0 //建立 SSL 连接 OK +QSSLOPEN: 1,5,0 AT+QSSLSEND=1,5 > //发送数据 //输入要发送的数据，按 Ctrl+Z 发送 OK 上海移远通信技术股份有限公司 17 / 20 +QSSLSEND: 1,5,0 +QSSLURC: 'recv',1,5,10,'1234567890' AT+QSSLCLOSE=1,5 OK +QSSLCLOSE: 1,5,0 AT+QSCLK=1 OK BC26&BC20 SSL 应用指导 //通知 MCU 接收到新数据 //关闭 SSL 连接 //启用轻休眠和深休眠，并可通过 PSM_EINT（下降沿） 唤醒深休眠 上海移远通信技术股份有限公司 18 / 20 4 错误码 表 4：错误码概览 错误码 0 -1 -2 -3 -4 -5 -6 -7 -9 英文描述 Operation successful Exception error Connection error Cert error Key error Cipher error State error Time out Other errors BC26&BC20 SSL 应用指导 中文描述 执行成功 异常错误 连接失败 配置 CA 证书或客户端证书错误 配置客户端密钥错误 配置加密套件错误 状态错误 执行超时 其他错误 上海移远通信技术股份有限公司 19 / 20 BC26&BC20 SSL 应用指导 5 附录 A 参考文档和术语缩写 表 5：术语缩写 缩写 CA IANA ID IP MCU NB-IoT NVRAM PEM SSL TA TLS URC 英文全称 Certificate Authority Internet Assigned Numbers Authority Identifier Internet Protocol Microprogrammed Control Unit Narrowband Internet of Things Non-Volatile Random Access Memory Privacy Enhanced Mail Security Socket Layer Terminal Adapter Transport Layer Security Unsolicited Result Code 中文全称 证书授权中心 互联网号码分配局 标识符 互联网协议 微程序控制器 窄带物联网 非易失性随机访问存储器 隐私增强邮件 安全套接层 终端适配器 安全网络传输协议 非请求结果码 上海移远通信技术股份有限公司 20 / 20

BC28 Andlink 应用指导 NB-IoT 模块系列 版本: BC28_Andlink_应用指导_V1.0 日期: 2020-02-21 状态: 受控文件 www.quectel.com BC28 Andlink 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 36 BC28 Andlink 应用指导 文档历史 修订记录 版本 1.0 日期 2020-02-21 作者 陆晓程 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 36 BC28 Andlink 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 命令概述 ................................................................................................................................................ 6 2.1. 定义........................................................................................................................................... 7 2.2. 语法........................................................................................................................................... 7 2.3. 响应........................................................................................................................................... 8 3 Andlink 相关命令.................................................................................................................................. 9 3.1. AT+QLASERVERIP 设置/删除 Bootstrap 或 LwM2M 服务器地址......................................... 9 3.2. AT+QLASECSWT 设置数据加密模式 .................................................................................. 10 3.3. AT+QLASETPSK 设置 PSK ID 和 PSK ................................................................................11 3.4. AT+QLASREGIND 注册控制 ............................................................................................... 12 3.5. AT+QLASENDDATA 发送 CON/NON 消息 .......................................................................... 13 3.6. AT+QLASENDRSP 响应写请求或读请求 ............................................................................ 14 3.7. AT+QLADATASTATUS 查询 CON 消息发送状态................................................................. 15 3.8. AT+QLAFOTAIND 设置 DFOTA 升级模式 ........................................................................... 16 3.9. AT+QLAREGSWT 设置注册模式......................................................................................... 17 3.10. AT+QLASTATUS 查询注册状态 ........................................................................................... 19 3.11. AT+QLARESETDTLS 重置 DTLS 状态 ............................................................................... 20 3.12. AT+QLADTLSSTAT 查询 DTLS 状态................................................................................... 20 3.13. AT+QCFG='LWM2M/DeviceType' 配置设备类型 ............................................................... 21 3.14. AT+QLAFOTARESET* 停止 DFOTA 升级并重置 DFOTA 状态 ........................................... 22 3.15. AT+QLASETBSPSK* 为 Bootstrap 配置 PSK ID 和 PSK .................................................... 23 3.16. AT+QLABSSECSWT* 设置 Bootstrap 阶段数据加密模式................................................... 24 4 Andlink 相关 URC .............................................................................................................................. 26 4.1. +QLAWRITE 通知 TE 响应写请求的 URC ........................................................................... 26 4.2. +QLAREAD 通知 TE 响应读请求的 URC ............................................................................ 26 4.3. +QLAEVTIND LwM2M 事件上报（仅用于响应）................................................................ 27 4.4. +QLADATASTATUS CON 数据发送状态上报...................................................................... 27 5 错误码 ................................................................................................................................................. 28 6 举例 ..................................................................................................................................................... 31 6.1. 非加密 ..................................................................................................................................... 31 6.2. 加密......................................................................................................................................... 32 7 重启原因 .............................................................................................................................................. 33 8 附录 A 参考文档及术语缩写............................................................................................................... 35 上海移远通信技术股份有限公司 3 / 36 BC28 Andlink 应用指导 表格索引 表 1: UE 更新状态指示 URC......................................................................................................................... 6 表 2: AT 命令语法 ......................................................................................................................................... 7 表 3: 通用错误代码 (27.007) ..................................................................................................................... 28 表 4: 通用错误代码 (27.005) ..................................................................................................................... 28 表 5: 特定错误代码 .................................................................................................................................... 29 表 6: 重新启动显示的消息.......................................................................................................................... 33 表 7: 参考文档............................................................................................................................................ 35 表 8: 术语缩写............................................................................................................................................ 35 上海移远通信技术股份有限公司 4 / 36 BC28 Andlink 应用指导 1 引言 Andlink 中国移动数字家庭开放平台是一个用于智能硬件设备通信的平台（本文中简称'Andlink'）， 本文档主要介绍了如何通过 AT 命令使用移远通信 BC28 模块对接 Andlink 平台相关功能。 上海移远通信技术股份有限公司 5 / 36 BC28 Andlink 应用指导 2 命令概述 启动模块后将输出字符串 NeulOK，收到此字符串后，AT 命令处理 器准备接受 AT 命令。 如果 BC28 模块由于任何不正常上电顺序导致了重新开机，将在字符串 Neul OK 前输出一条消息，以表明重新启动的原因，详细信息请参考《Quectel_BC35-G&BC28& BC95 R2.0_AT 命令手册》。 如果外部 MCU 介入模块 DFOTA 固件更新过程，模块将输出 URC 通知外部 MCU 当前的更新状态。 表 1: UE 更新状态指示 URC URC 描述 FIRMWARE DOWNLOADING 表示 UE 正在下载更新包。 FIRMWARE DOWNLOAD FAILED 表示下载失败。 FIRMWARE DOWNLOADED 表示下载完成。 FIRMWARE UPDATING FIRMWARE UPDATE SUCCESS FIRMWARE UPDATE FAILED FIRMWARE UPDATE OVER 表示 UE 正在更新。 表示更新成功，但尚未向固件包服务器报告 更新状态。 表示更新失败。 表示更新已完成，并且已向固件包服务器报 告更新状态。在此信息之后升级已经完成。 备注 在更新过程中，在报告 FIRMWARE UPDATE OVER 之前，不应对模块进行操作。例如，不允许执行 AT+NRB 关闭模块，否则将发生错误。 上海移远通信技术股份有限公司 6 / 36 2.1. 定义 ⚫ ：回车符； ⚫ ：换行符； ⚫ ：参数名称，实际命令中不包括尖括号 < >； ⚫ [...]：可选参数，实际命令中不包括方括号 [ ]。 BC28 Andlink 应用指导 2.2. 语法 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅示出响应，省略 。 AT 命令的语法及响应类型如下表所示： 表 2: AT 命令语法 测试命令 查询命令 设置命令 执行命令 AT+=? AT+? AT+= AT+ 返回相应设置命令可设置的参数列表及取值范围。 返回相应设置命令参数的当前设置值。 设置用户可自定义的参数值。 执行无需设置参数值的命令。 可以用分号（;）将多个命令放在同一行。此时只有第一个命令带有 AT 前缀。命令可以是大写或小写。 输入 AT 命令时，将忽略空格，但以下情况除外： ⚫ 带引号的字符串内； ⚫ 不带引号的字符串或数字参数内； ⚫ IP 地址内； ⚫ 在 AT 命令名称中的 =、? 或 =?。 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 上海移远通信技术股份有限公司 7 / 36 BC28 Andlink 应用指导 2.3. 响应 当 AT 命令处理器处理完一条命令后，将响应 OK、ERROR 或 +CME ERROR: ，表示已经准备 接收新命令。在返回最终的 OK，ERROR 或 +CME ERROR: 之前，会发送请求的响应消息。 在使用 AT 命令过程出现错误时，若返回 +CME ERROR: ，请参考第 4 章，查找 错误 码。 AT 命令响应的格式为： +CMD1: OK 或者 OK 备注 1. 若无特殊说明，本文档所述 AT 命令默认立即生效，且参数配置不保存。 2. 本文档参数说明中添加下划线的参数值为默认值。 上海移远通信技术股份有限公司 8 / 36 BC28 Andlink 应用指导 3 Andlink 相关命令 本章介绍了与 Andlink 相关的 AT 命令。 3.1. AT+QLASERVERIP 设置/删除 Bootstrap 或 LwM2M 服务器地址 该命令用于设置/删除 Bootstrap 或物联网平台服务器的 IP 地址。 ⚫ 当 IP 地址和端口与 KV 匹配时，AT+QLASERVERIP='DEL',, 将删除 IP 信息。 ⚫ 当 IP 地址与 KV 匹配时，AT+QLASERVERIP='DEL', 将删除 IP 信息。 AT+QLASERVERIP 设置/删除 Bootstrap 或 LwM2M 服务器地址 设置命令 响应 AT+QLASERVERIP=,[,] 若发生任何错误： ERROR 或 查询命令 +CME ERROR: 响应 AT+QLASERVERIP? +QLASERVERIP: ,, … OK 最大响应时间 若发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 字符串类型。设置 Bootstrap 或服务器的 IP 地址或者删除 IP 地址信息。 'LWM2M' LwM2M 服务器地址 上海移远通信技术股份有限公司 9 / 36 BC28 Andlink 应用指导 'BS' Bootstrap（引导）服务器 IP 地址 'DEL' 删除 IP 地址信息 字符串类型。域名或者 IP 地址。IP 地址采用点分十进制的格式。 整型。端口。范围：0-65535。默认值：5683。 整型。错误码。请参考第 4 章，查找 错误码。 举例 AT+QLASERVERIP='BS','180.101.147.115',5683 OK AT+QLASERVERIP='LWM2M','180.101.147.115',5683 OK AT+QLASERVERIP? +QLASERVERIP: BS,180.101.147.115,5683 LWM2M,180.101.147.115,5683 OK AT+QLASERVERIP='DEL','180.101.147.115',5683 OK 3.2. AT+QLASECSWT 设置数据加密模式 此命令用于设置数据的加密模式和标准 DTLS 会话超时重新协商间隔。 AT+QLASECSWT 设置数据加密模式 设置命令 响应 AT+QLASECSWT=[,] 若发生任何错误： ERROR 或者 查询命令 +CME ERROR: 响应 AT+QLASECSWT? +QLASECSWT:, OK 若发生任何错误： ERROR 或者 上海移远通信技术股份有限公司 10 / 36 BC28 Andlink 应用指导 最大响应时间 +CME ERROR: 300 毫秒 参数 整型。加密模式类型。 0 不加密 1 标准 DTLS 加密模式 整型。NAT 类型，仅在标准 DTLS 加密模式下（=1）有效。 0 使能 NAT，重新协商间隔时间为 30 秒 1 禁用 NAT 和重新协商 整型。错误码。请参考第 4 章，查找 错误码。 举例 AT+QLASECSWT=0 OK AT+QLASECSWT=1,1 OK AT+QLASECSWT? +QLASECSWT:1,1 OK 3.3. AT+QLASETPSK 设置 PSK ID 和 PSK 该命令用于配置 PSK ID 和 PSK。 AT+QLASETPSK 设置 PSK ID 和 PSK 设置命令 响应 AT+QLASETPSK=, OK 查询命令 AT+QLASETPSK? 若发生任何错误： ERROR 或者 +CME ERROR: 响应 +QLASETPSK:, OK 上海移远通信技术股份有限公司 11 / 36 BC28 Andlink 应用指导 最大响应时间 若发生任何错误： ERROR 或者 +CME ERROR: 2秒 参数 整型。密钥索引。十进制数字。固定长度为 15 位数。该值必须和设备 IMEI 值相同。 另外，该值也必须和 Andlink 平台设置的值保持一致。若 为 0，则 IMEI 被 用作 PSK ID。 字符串类型。预置共享密钥。十六进制数字，固定长度 16 位数。另外，该值必须和 Andlink 平台设置的值保持一致。 整型。错误码。请参考第 4 章。查找 错误码。 备注 参数配置自动保存，重启后生效。 举例 AT+QLASETPSK=867724030000225,E8E19CC16CE1F388E8E19CC16CE1F388 OK AT+QLASETPSK? +QSETPSK:867724030000225,*** OK 3.4. AT+QLASREGIND 注册控制 该命令用于控制模块注册到 Andlink 平台或从 Andlink 平台注销。若无法发送消息，将返回 +CME ERROR: 。 AT+QLASREGIND 注册控制 设置命令 响应 AT+QLASREGIND= OK 上海移远通信技术股份有限公司 12 / 36 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。表示动作类型。 0 触发注册操作 1 触发注销操作 整型。错误码。请参考第 4 章，查找 错误码。 举例 AT+QLASREGIND=0 OK BC28 Andlink 应用指导 3.5. AT+QLASENDDATA 发送 CON/NON 消息 该命令用于使用 LwM2M 协议向 Andlink 平台发送消息。发送 CON 数据后，发送结果将自动通知 TE。 TE 也可使用 AT+QLAULDATASTATUS? 命令查询已发送 CON 数据的状态。发送 NON 数据，若命令未 返回 ERROR 则表示数据发送成功。 AT+QLASENDDATA 发送 CON/NON 消息 设置命令 数据模式下发送定长数据 AT+QLASENDDATA=, 响应 > 后，输入需要发送的数据，长度达 到 后将自动发送 响应 > 若发送成功： OK 设置命令 AT+QLASENDDATA=,, 若发生任何错误： ERROR 或者 +CME ERROR: 响应 OK 若发生任何错误： ERROR 上海移远通信技术股份有限公司 13 / 36 最大响应时间 或者 +CME ERROR: 300 毫秒 BC28 Andlink 应用指导 参数 消息类型。 0x0000 发送 NON 消息 0x0001 使用 RELEASE 辅助指令发送 NON 消息 0x0010 使用 RELEASE_AFTER_REPLY 辅助指令发送 NON 消息 0x0100 发送 CON 数据 0x0101 使用 RELEASE_AFTER_REPLY 辅助发送 CON 消息说明 整型。待发数据的长度。最大值 1024。单位：字节。 需要发送的数据。 整型。错误码。请参考第 4 章，查找 错误码。 3.6. AT+QLASENDRSP 响应写请求或读请求 该命令用于响应来自 Andlink 平台或应用服务器的写请求和读请求。 AT+QLASENDRSP 响应写请求或读请求 设置命令 响应 AT+QLASENDRSP=, n>,, 取值大于 0 时，响应 > 后， 若发送成功： 输 入 待 发 送 数 据 ， 输 入 长 度 达 到 OK 后将自动发送 若发生任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 参数 整型。消息标识符。来自 URC：+QLAWRITE 或 +QLAREAD。 字符串类型。十六进制数据。消息令牌。来自 URC：+QLAWRITE 或 +QLAREAD 整型。CoAP 协议的响应码，请参考《RFC 7252》。 结果码 CoAP 协议的响应码 描述 上海移远通信技术股份有限公司 14 / 36 1 2.05 内容 2 2.04 已更改 11 4.00 错误请求 12 4.01 未经许可的 13 4.04 未找到 14 4.05 不允许的方式 整型。发送数据的长度。范围：0-1024。单位：字节。 需要回复的数据。 整型。错误码。请参考第 4 章，查找 错误码。 BC28 Andlink 应用指导 3.7. AT+QLADATASTATUS 查询 CON 消息发送状态 此命令用于查询向 Andlink 平台发送 CON 数据的状态，仅支持查询已发送 CON 数据的状态。 AT+QLADATASTATUS 查询 CON 消息发送状态 查询命令 响应 AT+QLADATASTATUS? +QLADATASTATUS: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。CON 数据发送状态。 0 未发送 1 已发送，等待平台响应 2 发送失败 3 发送超时 4 发送成功 5 RST（收到 reset 信息） 整型。错误码。请参考第 4 章，查找 错误码。 举例 AT+QLAULDATASTATUS? 上海移远通信技术股份有限公司 15 / 36 +QLAULDATASTATUS:4 OK BC28 Andlink 应用指导 3.8. AT+QLAFOTAIND 设置 DFOTA 升级模式 该命令用于配置 DFOTA 升级模式为以下任一模式： ⚫ 自动模式：无需 MCU 发送命令控制即可自动完成 DFOTA 下载和升级。 ⚫ 受控模式：MCU 使用 AT 命令控制是否下载或升级固件。 受控模式下，收到 URC +QLAEVTIND:6（即收到了更新包 URL 消息）或者 URC +QLAEVTIND:7（即 收到了提示 MCU 差分包下载完成消息）后，MCU 使用该命令控制是否下载或者升级固件。 AT+QLAFOTAIND 设置 DFOTA 升级模式 设置命令 响应 AT+QLAFOTAIND= OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 整型。DFOTA 升级模式。 0 自动升级模式 1 受控升级模式 2 MCU 通知模块开始下载版本文件 3 MCU 通知模块取消版本文件下载 4 MCU 通知模块开始更新 5 MCU 通知模块取消更新 整型。错误码。请参考第 4 章，查找 错误码。 举例 AT+QLAFOTAIND=1 OK AT+QLASREGIND=0 OK //设置 DFOTA 升级模式为受控模式 //开始注册 Andlink 平台 上海移远通信技术股份有限公司 16 / 36 BC28 Andlink 应用指导 +QLAEVTIND:0 +QLAEVTIND:3 +QLAEVTIND:5 FIRMWARE DOWNLOADING +QLAEVTIND:6 AT+QLAFOTAIND=2 OK //成功注册 //Andlink 平台已经观察数据对象 //Andlink 平台已经观察固件对象 //通知设备接收更新包的 URL //MCU 通知模块开始下载版本文件 FIRMWARE DOWNLOADED +QLAEVTIND:7 AT+QLAFOTAIND=4 OK //通知设备版本文件下载完成 //MCU 通知模块开始更新 FIRMWARE UPDATING REBOOT_CAUSE_SECURITY_FOTA_UPGRADE Neul OK //模块重启 FIRMWARE UPDATE SUCCESS +QLAEVTIND:0 //成功注册 +QLAEVTIND:3 //Andlink 平台已经观察数据对象 FIRMWARE UPDATE OVER 3.9. AT+QLAREGSWT 设置注册模式 该命令用于设置注册模式。 ⚫ =0，模块重启并连接到网络后，将向设备发送 REGISTERNOTIFY 消息，然后设备通过命 令 AT+QLASREGIND 触发注册。 ⚫ =1，模块重启并连接到网络后，将触发自动注册，无需其他操作。 上海移远通信技术股份有限公司 17 / 36 若执行失败，将返回 +CME ERROR: 作为中间消息。 AT+QLAREGSWT 设置注册模式 设置命令 响应 AT+QLAREGSWT= OK 查询命令 AT+QLAREGSWT? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +QLAREGSWT: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 BC28 Andlink 应用指导 参数 整型。注册模式。 0 手动注册模式 1 自动注册模式 整型。错误码。请参考第 4 章，查找 错误码。 备注 参数配置自动保存，重启后生效。 举例 AT+QLAREGSWT=1 OK AT+QLAREGSWT? +QLAREGSWT:1 OK 上海移远通信技术股份有限公司 18 / 36 BC28 Andlink 应用指导 3.10. AT+QLASTATUS 查询注册状态 该命令用于在客户端连接到服务器时查询当前的注册状态。 AT+QLASTATUS 消息注册状态 查询命令 AT+QLASTATUS? 响应 +QLASTATUS: OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 字符串类型。表示当前注册状态。 UNINITIALISED 未初始化 MISSING_CONFIG 配置丢失 INIITIALISING 初始化中 INIITIALISED 初始化完成 INIT_FAILED 初始化失败 REGISTERING 注册中 REGISTERED 已注册 DEREGISTERED 已注销 MO_DATA_ENABLED 使能数据发送 NO_UE_IP 无UE IP REJECTED_BY_SERVER 服务器拒绝 TIMEOUT_AND_RETRYING 超时并重试 REG_FAILED 注册失败 DEREG_FAILED 注销失败 整型。错误码。请参考第 4 章，查找 错误码。 上海移远通信技术股份有限公司 19 / 36 BC28 Andlink 应用指导 3.11. AT+QLARESETDTLS 重置 DTLS 状态 该命令用于重置 DTLS 状态。 ⚫ 若 DTLS 已完成握手或重新协商，可通过该命令将 DTLS 状态重置为初始状态，下一次发送数据 时将会再次执行 DTLS 握手流程。 ⚫ 若当前 DTLS 状态为正在握手或正在重协商，执行该命令会直接返回 OK，下一次发数据的时候不 会触发握手流程。 AT+QLARESETDTLS 重置 DTLS 状态 执行命令 响应 AT+QLARESETDTLS OK 最大响应时间 若发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 整型。错误码。请参考第 4 章，查找 错误码。 举例 AT+QLARESETDTLS OK 3.12. AT+QLADTLSSTAT 查询 DTLS 状态 该命令用于查询 DTLS 当前链路状态。在固定每 8 秒发送一次上行数据的情况下，若 DTLS 未协商， 则 DTLS 状态无法查询： ⚫ 若 DTLS 协商可在 8 秒内完成，那么协商完成后可查询 DTLS 状态； ⚫ 无论模块通电后自动注册还是通过 AT 命令手动注册，Andlink 平台注册过程都由 LwM2M 触发， 不会阻止任何其他 AT 命令的执行。 DTLS 协商或者握手完成后，模块主动发送消息 +QLADTLSSTAT: 到终端表示是否成功。 上海移远通信技术股份有限公司 20 / 36 BC28 Andlink 应用指导 AT+QLADTLSSTAT 查询命令 AT+QLADTLSSTAT? 查询 DTLS 状态 响应 +QLADTLSSTAT: OK 最大响应时间 若发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 整型。DTLS 当前状态。 0 DTLS 握手或协商完成 1 DTLS 握手或协商尚未开始 2 DTLS 正在握手或协商 3 DTLS 握手或协商失败 整型。错误码。请参考第 4 章，查找 错误码。 举例 AT+QLADTLSSTAT? +QLADTLSSTAT:0 OK 3.13. AT+QCFG='LWM2M/DeviceType' 配置设备类型 该命令用于配置资源 /3/0/17 的设备类型。 AT+QCFG='LWM2M/ DeviceType' 配置设备类型 设置命令 响应 AT+QCFG='LWM2M/DeviceType'[,<D 若省略参数 ，查询当前配置： eviceType>] +QCFG: 'LWM2M/Lifetime', OK 若不省略参数 参数，配置设备类型： 上海移远通信技术股份有限公司 21 / 36 最大响应时间 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 BC28 Andlink 应用指导 参数 字符串类型。配置设备类型（资源 /3/0/17 的值）。 整型。错误码。请参考第 4 章，查找 错误码。 举例 AT+QCFG='LWM2M/DeviceType','31301' OK AT+QCFG='LWM2M/DeviceType' +QCFG: 'LWM2M/DeviceType',31301 OK 3.14. AT+QLAFOTARESET* 停止 DFOTA 升级并重置 DFOTA 状态 该命令用于查询是否可在 DFOTA 升级过程中发送紧急数据。若允许发送数据，当前 DFOTA 过程会停 止并优先传输数据，平台升级结果取决于超时处理。 在 DFOTA 升级过程中，若需发送紧急数据，可先发送该命令。如果响应 OK，则可发送紧急数据；如 果响应 ERROR，则不能发送紧急数据。 AT+QLAFOTARESET* 停止 DFOTA 升级并重置 DFOTA 状态 设置命令 AT+QLAFOTARESET= 响应 若可以发送紧急数据： OK 最大响应时间 若不可发送紧急数据： ERROR 或 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 22 / 36 BC28 Andlink 应用指导 参数 整型。只能设置为 1。用来查询是否可以发送紧急数据。 整型。错误码。请参考第 4 章，查找 错误码。 备注 '*' 表示正在开发中。 举例 AT+QLAFOTARESET=1 OK 3.15. AT+QLASETBSPSK* 为 Bootstrap 配置 PSK ID 和 PSK 该命令用于配置 Bootstrap 服务器对接 DTLS 连接的 PSK ID 和 PSK。 AT+QSETBSPSK* 为 Bootstrap 配置 PSK ID 和 PSK 设置命令 响应 AT+QLASETBSPSK=, 若出现任何错误： ERROR 或 查询命令 +CME ERROR: 响应 AT+QLASETBSPSK? +QSETBSPSK: , OK 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 2秒 上海移远通信技术股份有限公司 23 / 36 BC28 Andlink 应用指导 参数 整型。密钥索引。固定长度为 15 位的十进制数字。该值必须和设备 IMEI 值相同。另 外，该值也必须和 Andlink 平台设置的值保持一致。若 为 0，则 IMEI 被用 作 PSK ID。 字符串类型。预置共享密钥。固定长度为 16 字节的十六进制数字。需和 Andlink 平台 保持一致。 整型。错误码。请参考第 4 章，查找 错误码。 备注 1. 参数配置自动保存，重启后生效。 2. '*' 表示正在开发中。 举例 AT+QLASETBSPSK=201703230000024,0123456789ABCDEF0123456789ABCDEF OK AT+QLASETBSPSK? +QSETBSPSK:201703230000024,*** OK 3.16. AT+QLABSSECSWT* 设置 Bootstrap 阶段数据加密模式 该命令用于配置 Bootstrap 服务器对接 DTLS 连接的加密模式，以及标准 DTLS 会话超时重协商时间。 在启动 DTLS 首次协商时启动计时器，每收到一次 Bootstrap 服务器的 DTLS 报文后重启定时器。发送上 行报文时，如果该定时器已经超时，需触发一个重新协商。 AT+QBSSECSWT* 设置 Bootstrap 阶段数据加密模式 设置命令 响应 AT+QLABSSECSWT=[,] OK 若出现任何错误： ERROR 或 查询命令 +CME ERROR: 响应 AT+QLABSSECSWT? +QLABSSECSWT:, OK 上海移远通信技术股份有限公司 24 / 36 BC28 Andlink 应用指导 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 整型。加密模式类型。 0 不加密 1 标准 DTLS 加密模式 整型。NAT 类型。仅在标准 DTLS 加密模式下有效。 0 使能 NAT，重新协商间隔时间为 30 秒 1 禁用 NAT 和重新协商 整型。错误码。请参考第 4 章，查找 错误码。 备注 1. 参数配置自动保存，重启后生效。 2. '*' 表示正在开发中。 举例 AT+QLABSSECSWT=1,1 OK AT+QLABSSECSWT? +QLABSSECSWT:1,1 OK 上海移远通信技术股份有限公司 25 / 36 BC28 Andlink 应用指导 4 Andlink 相关 URC 本章节描述 Andlink 平台相关的 URC 及其描述。 4.1. +QLAWRITE 通知 TE 响应写请求的 URC 该 URC 主 要 用 于 通 知 TE 响 应 来 自 平 台 或 应 用 服 务 器 的 写 请 求 。 TE 应 在 10 秒 内 执 行 AT+QLASENDRSP 响应请求（自 URC 开始输出时计数），并应在 URC 完全输出后开始响应。 +QLAWRITE 通知 TE 响应写请求的 URC URC 格式 +QLAWRITE: ,,[,] 通知 TE 响应来自平台或应用服务器的写请求。 参数 整型。消息 ID。 字符串类型。标记值。十六进制格式。 数据包的有效负载。 Query 选项的内容。详情请参考《RFC 7252》。 4.2. +QLAREAD 通知 TE 响应读请求的 URC 该 URC 主 要 用 于 通 知 TE 响 应 来 自 平 台 或 应 用 服 务 器 的 读 请 求 。 TE 应 在 10 秒 内 执 行 AT+QLASENDRSP 响应请求（自 URC 开始输出时计数），并应在 URC 完全输出后开始响应。 +QLAREAD 通知 TE 响应读请求的 URC URC 格式 +QLAREAD: ,[,] 通知 TE 响应来自平台或应用服务器的读请求。 参数 整型，消息 ID。 字符串类型，标记值，十六进制格式。 Query 选项的内容，详情请参考 CoAP 协议。 上海移远通信技术股份有限公司 26 / 36 BC28 Andlink 应用指导 举例 +QLAREAD: 9415,'6857D31A64CCBC95','lwm2m=1.&ep=12345&name=123456' 4.3. +QLAEVTIND LwM2M 事件上报（仅用于响应） +QLAEVTIND LwM2M 事件上报（仅用于响应） URC 格式 +QLAEVTIND: 用于上报 LwM2M 事件 参数 整型。上报的事件。 0 注册完成 1 注销完成 2 更新完成 4 Bootstrap 完成 5 资源 5/0/3 订阅完成 6 提示 MCU 接收到差分包 URL 7 提示 MCU 差分包下载完成 4.4. +QLADATASTATUS CON 数据发送状态上报 +QLADATASTATUS CON 数据发送状态上报 URC 格式 +QLADATASTATUS: 用于上报 CON 数据发送状态 参数 整型。CON 数据发送状态。 0 未发送 1 已发送，等待平台响应 2 发送失败 3 发送超时 4 发送成功 5 RST（收到 reset 信息） 上海移远通信技术股份有限公司 27 / 36 BC28 Andlink 应用指导 5 错误码 本章节介绍了与 BC28 模块相关的错误代码。以下两个表中列出的错误代码均符合 3GPP 规范。如需 查看相关参数 错误码，请参考《3GPP TS 27.007 V13.5.0》的子章节 9.2。 表 3: 通用错误代码 (27.007) 错误码 描述 3 Operation not allowed 4 Operation not supported 23 Memory failure 30 No network service 50 Incorrect parameters Command implemented but currently 51 disabled 52 Command aborted by user 159 Uplink busy/flow control 说明 不允许此操作 不支持此操作 内存故障 无网络服务 参数不正确 已执行命令但当前被禁用 此命令被用户终止 上行忙碌/流控 表 4: 通用错误代码 (27.005) 错误码 描述 300 ME failure 301 SMS service of ME reserved 302 Operation not allowed 303 Operation not supported 304 Invalid PDU mode parameter 305 Invalid text mode parameter 说明 ME 故障 ME 预留的短信服务 不允许此操作 不支持此操作 无效 PDU 模式参数 无效文本模式参数 上海移远通信技术股份有限公司 28 / 36 310 USIM not inserted 311 USIM PIN required 312 PH-USIM PIN required 313 USIM failure 314 USIM busy 315 USIM wrong 316 USIM PUK required 317 USIM PIN2 required 318 USIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network service 332 Network timeout 340 No +CNMA acknowledgement expected 500 Unknown error 以下错误代码是 BC28 模块的特定错误代码。 BC28 Andlink 应用指导 无 USIM 卡 需要 USIM PIN 需要 PH-USIM PIN USIM 故障 USIM 忙碌 USIM 错误 需要 USIM PUK 需要 USIM PIN2 需要 USIM PUK2 内存故障 内存索引无效 内存已满 未知的 SMSC 地址 无网络服务 网络超时 预计没有+CNMA 确认 未知错误 表 5: 特定错误代码 错误码 512 513 514 515 516 描述 Required parameter not configured TUP not registered AT internal error CID is active Incorrect state for command 说明 必要的参数未配置 TUP 未注册 AT 内部错误 CID 处于激活状态 命令状态错误 上海移远通信技术股份有限公司 29 / 36 BC28 Andlink 应用指导 517 CID is invalid CID 无效 518 CID is not active CID 处于未激活状态 520 Deactivate the last active CID 停用上次激活的 CID 521 CID is not defined CID 未被定义 522 UART parity error UART 奇偶校验错误 523 UART frame error UART 帧错误 UE is in minimal function mode UE 处于最小功能模式 524 (AT+CFUN=0) (AT+CFUN=0) 525 AT command aborted: in processing AT 命令中止：处理中 526 AT command aborted: error AT 命令中止：错误 527 Command interrupted 命令被中断 528 Configuration conflicts 配置冲突 529 During FOTA updating FOTA 升级中 530 Not the AT allocated socket 不是 AT 分配的 Socket 531 USIM PIN is blocked USIM PIN 被锁定 532 USIM PUK is blocked USIM PUK 被锁定 533 Not mipi module 非 mipi 模块 534 File not found 未找到文件 535 conditions of use not satisfied 使用的条件不符 536 at uart buffer error Uart 口缓冲错误 537 Back off timer is running 退避定时器正在运行 备注 AT+CMEE 命令可以使能（=1）或禁用（=0）结果码 +CME ERROR: 。当 =1 并发 生错误时，将响应结果码 +CME ERROR: ；当 =0 并发生错误时，仅响应 ERROR。此命令 的详细内容请参考《Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册》。 上海移远通信技术股份有限公司 30 / 36 BC28 Andlink 应用指导 6 举例 6.1. 非加密 AT+QLASERVERIP='BS','112.13.96.205',5783 OK //设置 Bootstrap 服务器地址和端口，具体地 址由平台侧提供 //在 Bootstrap 阶段关闭 DTLS 加密 AT+QLABSSECSWT=0 OK AT+NRB //软重启 +QLAEVTIND:4 //Bootstrap 完成 +QLAEVTIND:0 //注册平台成功 +QLAREAD: 48767,'6CBBD6861BC43359' AT+QLASENDRSP=48767,6CBBD6861BC43359,1,48 >{'firstName': 'Brett', 'lastName': 'McLaughlin'} //接收到平台的读请求，包含 和 //响应平台读请求，根据实际应用 组包 OK AT+QLASENDDATA=0x0100,26 >[{'n':'19/1/0','p1':'v1'}] //主动上报数据到平台，数据长度为 26 OK +QLAULDATASTATUS:4 //数据发送成功，并收到服务器 ACK 回复 上海移远通信技术股份有限公司 31 / 36 BC28 Andlink 应用指导 6.2. 加密 AT+QLASERVERIP='BS','lwm.home.komect.com',5684 OK //设置 Bootstrap 服务器地址和端口，具 体地址由平台侧提供 //设置 DTLS 的 PSK ID 和 PSK，需使用 DTLS 加密时方可设置，具体参数由平台提供 AT+QLASETBSPSK=86772403*******,30313233343536373839303132336162 OK AT+QCFG='LWM2M/DeviceType','31301' //设置设备类型，设备类型由平台侧获取 OK AT+QLABSSECSWT=1,0 //开启 DTLS 加密 OK AT+NRB //软重启，使之前的配置生效 +QLADTLSSTAT:0 //DTLS 握手成功 +QLAEVTIND:4 //Bootstrap 完成 +QLAEVTIND:0 //注册平台成功 +QLAREAD: 48767,'6CBBD6861BC43359' AT+QLASENDRSP=48767,6CBBD6861BC43359,1,48 //接收到平台的读请求，包含 和 //回应平台读请求，根据实际 应用组包 >{'outletStatus':'0','setTime':'1','firmware':'1.0','softVersion':'1.0'} OK AT+QLASENDDATA=0X0100,112 //主动上报数据到平台，数据长度为 112 >[{'n':'/19/1/0','vs':'{'outletStatus':'0','setTime':'1','firmware':'1.0', 'softVersion':'1.0'}'}] OK +QLADATASTATUS:4 //数据发送成功且收到服务器 ACK 回复 上海移远通信技术股份有限公司 32 / 36 BC28 Andlink 应用指导 7 重启原因 除了重新上电或外部复位，如果模块因其他任何原因导致重新启动，将在字符串 NeulOK 前输出一条消息，以表明重新启动的原因。 表 6: 重新启动显示的消息 序号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 重启消息显示 REBOOT_CAUSE_SECURITY_RESET_UNKNOWN REBOOT_CAUSE_SECURITY_SYSRESETREQ REBOOT_CAUSE_SECURITY_WATCHDOG REBOOT_CAUSE_SECURITY_SELF REBOOT_CAUSE_SECURITY_ALTBOOT REBOOT_CAUSE_SECURITY_REG_0 REBOOT_CAUSE_SECURITY_REG_3 REBOOT_CAUSE_SECURITY_STANDARD_CHIP_WATCHDOG REBOOT_CAUSE_SECURITY_UPDATER_CHIP_WATCHDOG REBOOT_CAUSE_SEUCRITY_SCAN_ENTER_EXIT REBOOT_CAUSE_SECURITY_PMU_POWER_ON_RESET REBOOT_CAUSE_SECURITY_RESET_PIN REBOOT_CAUSE_SECURITY_REGIONS_UPDATED REBOOT_CAUSE_SECURITY_FOTA_UPGRADE REBOOT_CAUSE_PROTOCOL_SYSRESETREQ REBOOT_CAUSE_PROTOCOL_WATCHDOG REBOOT_CAUSE_PROTOCOL_MONITOR_REBOOT_REQ 上海移远通信技术股份有限公司 33 / 36 BC28 Andlink 应用指导 18 REBOOT_CAUSE_PROTOCOL_RPC_TIMEOUT 19 REBOOT_CAUSE_APPLICATION_SYSRESETREQ 20 REBOOT_CAUSE_APPLICATION_WATCHDOG 21 REBOOT_CAUSE_APPLICATION_AT 22 REBOOT_CAUSE_APPLICATION_RPC_TIMEOUT 23 REBOOT_CAUSE_PROTOCOL_IMSI_UPDATE 24 REBOOT_CAUSE_UNKNOWN 上海移远通信技术股份有限公司 34 / 36 BC28 Andlink 应用指导 8 附录 A 参考文档及术语缩写 表 7: 参考文档 序号 文档名称 备注 [1] RFC 7252 受限的应用协议的 RFC 7252 [2] 3GPP TS 27.007 V13.5.0 3GPP TS 27.007 V13.5.0 [3] Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册 BC35-G、BC28 和 BC95 R2.0 模块的 AT 命令说明和使用手册 表 8: 术语缩写 缩写 BS CoAP CON DFOTA DTLS IMEI KV LwM2M MCU NAT NB-IoT NON 英文全称 Bootstrap Constrained Application Protocol Confirmable message Delta Firmware Over-The-Air Datagram Transport Layer Security International Mobile Equipment Identity Key Value Lightweight Machine to Machine Microcontroller Unit Network Address Translation Narrow Band Internet of Thing Non-confirmable message 中文全称 引导 受限的应用协议 需要确认的消息 差分空中固件升级 数据包传输层安全性协议 国际移动设备识别码 关键字取值 轻量级物联网协议 微控制单元 网络地址转换 窄带物联网 不需确认消息 上海移远通信技术股份有限公司 35 / 36 PDP PSK TE UE URC Packet Data Protocol Pre-shared Key Terminal Equipment User Equipment Unsolicited Result Code BC28 Andlink 应用指导 分组数据协议 预共享密钥 终端设备 用户设备 非请求结果码 上海移远通信技术股份有限公司 36 / 36

BC35-G&BC28 Firmware Upgrade User Guide NB-IoT Module Series Rev. BC35-G&BC28_Firmware_Upgrade_User_Guide_V1.0 Date: 2017-12-14 Status: Released www.quectel.com NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide 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. 2017. All rights reserved. BC35-G&BC28_Firmware_Upgrade_User_Guide 1 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide About the Document History Revision 1.0 Date 2017-12-14 Author Donald TANG Description Initial BC35-G&BC28_Firmware_Upgrade_User_Guide 2 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Figure Index ................................................................................................................................................. 4 1 Introduction .......................................................................................................................................... 5 2 Tool Installation.................................................................................................................................... 6 2.1. Microsoft .NET Framework Installation.................................................................................. 6 3 Firmware Upgrade ............................................................................................................................... 8 3.1. Firmware Upgrade via UEUpdaterUI..................................................................................... 8 3.1.1. Install UEUpdaterUI ...................................................................................................... 8 3.1.2. Upgrade Firmware via UEUpdaterUI.......................................................................... 10 BC35-G&BC28_Firmware_Upgrade_User_Guide 3 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide Figure Index FIGURE 1: MICROSOFT .NET FRAMEWORK INSTALLATION PACKAGE ...................................................... 6 FIGURE 2: LICENSE AGREEMENT FOR MICROSOFT .NET FRAMEWORK INSTALLATION ....................... 6 FIGURE 3: MICROSOFT .NET FRAMEWORK IS INSTALLING ........................................................................ 7 FIGURE 4: MICROSOFT .NET FRAMEWORK IS SUCCESSFULLY INSTALLED ............................................ 7 FIGURE 5: UEUPDATERUI INSTALLATION PACKAGE .................................................................................... 8 FIGURE 6: UEUPDATERUI SETUP WIZARD .................................................................................................... 8 FIGURE 7: WAIT WHILE INSTALLING UEUPDATERUI .................................................................................... 9 FIGURE 8: UEUPDATERUI IS SUCCESSFULLY INSTALLED .......................................................................... 9 FIGURE 9: UEUPDATERUI INTERFACE ......................................................................................................... 10 FIGURE 10: SELECT MAIN PORT TO UPGRADE .......................................................................................... 10 FIGURE 11: CLICK BROWSE TO SELECT THE FIRMWARE PACKAGE........................................................11 FIGURE 12: SELECT THE TARGET FIRMWARE VERSION............................................................................11 FIGURE 13: CHECK 'NO BAUD SWITCH' ...................................................................................................... 12 FIGURE 14: PROMPT FOR UPDATING........................................................................................................... 12 FIGURE 15: UPGRADING PROCESS.............................................................................................................. 13 FIGURE 16: FIRMWARE IS COMPLETELY UPGRADED................................................................................ 14 BC35-G&BC28_Firmware_Upgrade_User_Guide 4 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide 1 Introduction This document mainly introduces how to use UEUpdaterUI tool to upgrade firmware via main UART port for Quectel BC35-G and BC28 modules on Window 7 system. BC35-G&BC28_Firmware_Upgrade_User_Guide 5 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide 2 Tool Installation Customers need to install 'Microsoft .NET Framework' (4.5.2 version or later) on PC before using UEUpdater. 2.1. Microsoft .NET Framework Installation 1. Double-click microsoft.net framework 4.5.2.exe to install Microsoft .NET Framework. Figure 1: Microsoft .NET Framework Installation Package 2. Wait until the following window shows up, and then click 'I have read and accept the license terms' and 'Install' as shown below. Figure 2: License Agreement for Microsoft .NET Framework Installation BC35-G&BC28_Firmware_Upgrade_User_Guide 6 / 14 3. Please wait for the program to install. NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide Figure 3: Microsoft .NET Framework is Installing 4. Click 'Finish' to accomplish installation. Figure 4: Microsoft .NET Framework is Successfully Installed BC35-G&BC28_Firmware_Upgrade_User_Guide 7 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide 3 Firmware Upgrade 3.1. Firmware Upgrade via UEUpdaterUI 3.1.1. Install UEUpdaterUI 1. Double-click UEUpdaterUI-3.11.0.5.msi to install UEUpdaterUI. Figure 5: UEUpdaterUI Installation Package 2. Wait until the following window shows up, and then click 'Next'. Figure 6: UEUpdaterUI Setup Wizard BC35-G&BC28_Firmware_Upgrade_User_Guide 8 / 14 3. Please wait for the program to install NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide Figure 7: Wait While Installing UEUpdaterUI 4. Click 'Finish' to accomplish installation. A shortcut will be automatically generated on the desktop. Figure 8: UEUpdaterUI is Successfully Installed BC35-G&BC28_Firmware_Upgrade_User_Guide 9 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide 3.1.2. Upgrade Firmware via UEUpdaterUI 1. Double-click the desktop shortcut generated when installing UEUpdaterUI to open the UEUpdaterUI. Figure 9: UEUpdaterUI Interface 2. Select the main serial port to upgrade the firmware. Figure 10: Select Main Port to Upgrade BC35-G&BC28_Firmware_Upgrade_User_Guide 10 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide 3. Click the 'browse' button to select the firmware package. Figure 11: Click Browse to Select the Firmware Package 4. Select the target firmware version in .fwpkg format, and then check 'No Baud Switch'. Figure 12: Select the Target Firmware Version BC35-G&BC28_Firmware_Upgrade_User_Guide 11 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide Figure 13: Check 'No Baud Switch' 5. Click the 'update' button to start upgrading. When 'Waiting for UE to reboot to establish communication…' shows up, press 'Reset' button on the module, or power off the module and then power on to restart the module. Figure 14: Prompt for Updating BC35-G&BC28_Firmware_Upgrade_User_Guide 12 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide NOTE Please reset the module within 10 seconds, otherwise UEUpdateUI will be disconnected with the main port. 6. After restarting the module, it starts upgrading the firmware, please wait during the process. Figure 15: Upgrading Process BC35-G&BC28_Firmware_Upgrade_User_Guide 13 / 14 NB-IoT Module Series BC35-G&BC28 Firmware Upgrade User Guide 7. When all 'update pending…' status changes to 'update complete' or 'already loaded', it indicates the firmware is upgraded completely. Figure 16: Firmware is Completely Upgraded 8. Restart the module, and query the firmware version by AT command ATI. If the target version is returned, then the firmware is successfully upgraded. BC35-G&BC28_Firmware_Upgrade_User_Guide 14 / 14

BC95&BC35-G&BC95 R2.0 差异对比 NB-IoT 系列 版本：BC95&BC35-G&BC95 R2.0_差异对比_V1.1 日期：2018-12-20 状态：受控文件 www.quectel.com BC95&BC35-G&BC95 R2.0 差异对比 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2018，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2018. 上海移远通信技术股份有限公司 1 / 29 BC95&BC35-G&BC95 R2.0 差异对比 文档历史 修订记录 版本 日期 1.0 2018-09-30 作者 吴丁园/ 唐正/ 鲁义文 1.1 2018-12-20 鲁义文 变更表述 初始版本 1. 针对 RXD 引脚应用增加差异说明和备注（2.2 章节）。 2. 增加串口推荐电路差异说明（2.3 章节）。 3. 增加耗流差异说明（2.4 章节）。 上海移远通信技术股份有限公司 2 / 29 BC95&BC35-G&BC95 R2.0 差异对比 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 硬件差异对比......................................................................................................................................... 7 2.1. 引脚分配 ..................................................................................................................................... 7 2.2. 引脚差异性描述 .......................................................................................................................... 8 2.3. 串口推荐电路差异 .....................................................................................................................11 2.4. 耗流差异 ................................................................................................................................... 12 3 软件差异对比....................................................................................................................................... 13 3.1. 软件功能差异............................................................................................................................ 13 3.2. 输出及提示信息差异................................................................................................................. 14 3.3. AT 命令差异对比 ...................................................................................................................... 15 3.3.1. 网络相关命令................................................................................................................. 15 3.3.1.1. AT+COPS 选择运营商 ..................................................................................... 15 3.3.2. UDP 相关命令 ............................................................................................................... 15 3.3.2.1. AT+NSOCR 创建 Socket ................................................................................. 15 3.3.2.2. AT+NSOST 发送 UDP 数据............................................................................. 16 3.3.2.3. AT+NSOSTF 发送 UDP 数据并携带标志位..................................................... 17 3.3.3. UART 波特率配置相关命令 ........................................................................................... 17 3.3.3.1. AT+NATSPEED 配置 UART 波特率 ................................................................ 17 3.3.4. 华为 IoT 平台相关命令 .................................................................................................. 18 3.3.4.1. AT+NMGS 发送消息 ........................................................................................ 18 3.3.4.2. AT+NNMI 发送新消息指示............................................................................... 19 3.3.4.3. AT+QLWULDATAEX 发送 CON/NON 消息 ..................................................... 19 3.3.4.4. AT+QLWULDATASTATUS 查询 CON 消息发送状态....................................... 20 3.3.4.5. AT+NMSTATUS 查询注册 CDP Server 状态................................................... 20 3.3.4.6. AT+QSECSWT 设置数据加密模式 .................................................................. 22 3.3.5. 其他命令 ........................................................................................................................ 22 3.3.5.1. AT+NPING 测试 IP 网络与远端主机连接......................................................... 22 3.3.5.2. AT+CGDCONT 定义 PDP 上下文.................................................................... 23 3.3.5.3. AT+NCONFIG 配置 UE 模式 ........................................................................... 23 3.3.5.4. AT+NUESTATS 查询 UE 最新操作统计数....................................................... 24 3.3.5.5. AT+NUESTATS=RADIO 查询 UE 最新操作统计数 ......................................... 25 3.3.5.6. AT+NPOWERCLASS 设置频段与发射功率 .................................................... 26 3.4. BC35-G 和 BC95 R2.0 新增 AT 命令 ....................................................................................... 26 4 附录 A.................................................................................................................................................. 28 上海移远通信技术股份有限公司 3 / 29 BC95&BC35-G&BC95 R2.0 差异对比 表格索引 表 1：引脚差异性描述 ......................................................................................................................................... 8 表 2：BC95 耗流数据 ........................................................................................................................................ 12 表 3：BC35-G/BC95 R2.0 耗流数据.................................................................................................................. 12 表 4：固件版本 .................................................................................................................................................. 13 表 5：软件功能差异 ........................................................................................................................................... 13 表 6：开机输出信息差异.................................................................................................................................... 14 表 7：华为 IOT 平台功能和指示信息差异 .......................................................................................................... 14 表 8：DFOTA 升级提示信息差异 ....................................................................................................................... 14 表 9：BC35-G 和 BC95 R2.0 新增 AT 命令 ....................................................................................................... 27 表 10：参考文档 ................................................................................................................................................ 28 表 11：术语缩写................................................................................................................................................. 28 上海移远通信技术股份有限公司 4 / 29 BC95&BC35-G&BC95 R2.0 差异对比 图片索引 图 1：引脚分配 .................................................................................................................................................... 7 图 2：BC95 串口参考设计 ..................................................................................................................................11 图 3：BC35-G/BC95 R2.0 串口参考设计 ...........................................................................................................11 上海移远通信技术股份有限公司 5 / 29 BC95&BC35-G&BC95 R2.0 差异对比 1 引言 本文档主要介绍 BC95、BC35-G 和 BC95 R2.0 在硬件和软件方面的主要差异，包括引脚分配、软件 功能、AT 命令等差异比较。 上海移远通信技术股份有限公司 6 / 29 BC95&BC35-G&BC95 R2.0 差异对比 2 硬件差异对比 2.1. 引脚分配 BC95、BC35-G 和 BC95 R2.0 的引脚完全兼容，如下是引脚分配图。 RESERVED RESERVED RESERVED VBAT VBAT GND GND GND GND RF_ANT GND 44 45 46 47 48 49 50 51 52 53 54 RESERVED 1 GND 2 RESERVED 3 RESERVED 4 RESERVED 5 RESERVED 6 RESERVED 7 RESERVED 8 RESERVED 9 RESERVED 10 RESERVED 11 RESERVED 12 RESERVED 13 RESERVED 14 RESET 15 RESERVED 16 74 73 72 71 94 93 92 91 55 75 90 70 56 76 89 69 57 77 88 68 58 78 87 67 59 79 86 66 60 80 85 65 81 82 83 84 61 62 63 64 43 GND 42 USIM_GND 41 USIM_CLK 40 USIM_DATA 39 USIM_RST 38 USIM_VDD 37 RESERVED 36 RESERVED 35 RESERVED 34 RI 33 RESERVED 32 RESERVED 31 RESERVED 30 TXD 29 RXD 28 RESERVED 27 26 25 24 23 22 21 20 19 18 17 RESERVED VDD_EXT RESERVED RESERVED RESERVED RESERVED ADC DBG_TXD DBG_RXD NETLIGHT RESERVED POWER ADC UART USIM ANT GND RESERVED OTHERS 图 1：引脚分配 上海移远通信技术股份有限公司 7 / 29 2.2. 引脚差异性描述 BC95&BC35-G&BC95 R2.0 差异对比 表 1：引脚差异性描述 引脚号 BC95 引脚名 BC35-G/ BC95 R2.0 引脚名 引脚描述 1 RESERVED RESERVED 2 GND GND 地 3 RESERVED RESERVED 4 RESERVED RESERVED 5 RESERVED RESERVED 6 RESERVED RESERVED 7 RESERVED RESERVED 8 RESERVED RESERVED 9 RESERVED RESERVED 10 RESERVED RESERVED 11 RESERVED RESERVED 12 RESERVED RESERVED 13 RESERVED RESERVED 14 RESERVED RESERVED 15 RESET RESET 复位模块 16 RESERVED RESERVED 17 RESERVED RESERVED 18 NETLIGHT NETLIGHT 网络状态指示 19 DBG_RXD DBG_RXD 模块调试串口接收数据 20 DBG_TXD DBG_TXD 模块调试串口发送数据 差异性 / / / / / / / / / / / / / / / / / / / / 上海移远通信技术股份有限公司 8 / 29 BC95&BC35-G&BC95 R2.0 差异对比 21 ADC ADC 通用模数转换接口 / 22 RESERVED RESERVED / 23 RESERVED RESERVED / 24 RESERVED RESERVED / 25 RESERVED RESERVED 26 VDD_EXT 1) VDD_EXT 1) 3.0V 输出电源 27 RESERVED RESERVED / BC95： IOmax=20mA (任意模式) BC35-G/BC95 R2.0： IOmax=1mA (PSM 模式) IOmax=20mA (其他模式) / 28 RESERVED RESERVED / 29 RXD 2) RXD 2) 从 DTE 设备 TXD 端接收数据 BC35-G/BC95 R2.0： PSM 模式下，不可悬空 30 TXD TXD 发送数据到 DTE 设备的 RXD 端 / 31 RESERVED RESERVED / 32 RESERVED RESERVED / 33 RESERVED RESERVED / 34 RI RI 模块输出震铃提示 / 35 RESERVED RESERVED / 36 RESERVED RESERVED / 37 RESERVED RESERVED 38 USIM_VDD 3) USIM_VDD 3) USIM 卡供电电压 39 USIM_RST USIM_RST USIM 卡复位信号 / BC95： 支持 3.0V USIM 卡 BC35-G/BC95 R2.0： 支持 1.8V 和 3.0V USIM 卡 / 40 USIM_DATA USIM_DATA USIM 卡数据信号 / 41 USIM_CLK USIM_CLK USIM 卡时钟信号 / 42 USIM_GND USIM_GND USIM 卡专用地 / 上海移远通信技术股份有限公司 9 / 29 BC95&BC35-G&BC95 R2.0 差异对比 43 GND GND 地 / 44 RESERVED RESERVED / 45 VBAT VBAT 模块电源： / 46 VBAT VBAT VBAT=3.1V~4.2V / 47 GND GND / 地 48 GND GND / 49 RESERVED RESERVED / 50 RESERVED RESERVED / 51 GND GND / 地 52 GND GND / 53 RF_ANT RF_ANT 射频天线焊盘 / 54 GND GND 地 / 55~58、 67~70、 75~80、 RESERVED RESERVED / 84~91 59~66、 71~74、 81~83、 GND GND 地 / 92~94 备注 1. 1) VDD_EXT 负载能力差异： ⚫ BC95：任何模式下，最大输出电流 20mA ⚫ BC35-G/BC95 R2.0：PSM 模式下，最大输出电流 1mA；其他模式下，最大输出电流 20mA 2. 2) RXD 参考设计差异： ⚫ BC95：推荐按照 BC95 的串口参考设计（图 2）进行设计 ⚫ BC35-G/BC95 R2.0：PSM 模式下，当 RXD 引脚悬空或者电压不匹配时，易造成耗流异常；因 此建议客户按照 BC35-G/BC95 R2.0 的串口参考设计（图 3）进行设计 3. 3) USIM_VDD 支持的 USIM 卡差异： ⚫ BC95：支持 3.0V USIM 卡 ⚫ BC35-G/BC95 R2.0：支持 1.8V 和 3.0V USIM 卡 上海移远通信技术股份有限公司 10 / 29 BC95&BC35-G&BC95 R2.0 差异对比 2.3. 串口推荐电路差异 MCU TXD RXD EINT GND Voltage level: 3.3V Module 1K RXD 1K TXD 1K RI GND RXD TXD GND VBAT Test points RESET VBAT RESET 图 2：BC95 串口参考设计 VDD_EXT Module R1 2MΩ 1K RXD R2 TXD 1K R3 RI 1K R4 GND VBAT RESET VBAT GND TXD RXD RESET TEST POINTS MCU TXD RXD EINT GND Voltage level: VCC 图 3：BC35-G/BC95 R2.0 串口参考设计 备注 BC35-G 和 BC95 R2.0 的串口参考设计，请注意如下注意事项： 1. PSM 模式下，MCU_TXD 不能悬空，建议预留 2MΩ 电阻上拉到 VDD_EXT； 2. 如 VCC > VDD_EXT，建议将上拉电阻 R1 更改成 20KΩ，电阻 R2 更改成二极管（阴极指向 MCU_TXD）， 以减少 PSM 漏电；如 VCC< VDD_EXT，则建议使用额外的电平转换电路； 3. 当 VCC > VDD_EXT，PSM 模式下，MCU_RXD 建议配置成浮空输入（输入上拉或者下拉都容易造 成漏电）； 4. 串口电平不匹配或模块 RXD 悬空，都容易造成模块的 PSM 耗流偏高，请严格按照推荐电路进行设计。 上海移远通信技术股份有限公司 11 / 29 BC95&BC35-G&BC95 R2.0 差异对比 2.4. 耗流差异 表 2：BC95 耗流数据 参数 模式 PSM Idle IVBAT Active 描述 睡眠状态 空闲状态 @DRX=1.28s 射频发射状态（23dBm） （B8/B5/B20） 射频发射状态（23dBm）（B28） 射频发射状态（12dBm） （B8/B5/B20/B28） 射频发射状态（0dBm） （B8/B5/B20/B28） 射频接收状态 最小值 典型值 最大值 单位 3.6 uA 2 mA 220 mA 250 mA 80 mA 65 mA 60 mA 表 3：BC35-G/BC95 R2.0 耗流数据 参数 模式 描述 最小值 典型值 最大值 单位 PSM 睡眠状态 3 uA Idle 空闲状态，DRX=1.28s 2 mA 射频发射状态， 23dBm（B1/B3） 250 mA 射频发射状态， 23dBm（B8/B5/B20） 220 mA IVBAT Active @Single-tone （3.75kHz/15kHz） 射频发射状态， 23dBm（B28） 射频发射状态， 12dBm 280 mA 130 mA （B1/B3/B8/B5/B20/B28） 射频发射状态， 0dBm（B1/B3/B8/B5/B20/B28） 70 mA 射频接收状态 60 mA Active @Multi-tone （15kHz） 射频发射状态， 23dBm （B1/B3/B8/B5/B20/B28） 350 mA 上海移远通信技术股份有限公司 12 / 29 BC95&BC35-G&BC95 R2.0 差异对比 3 软件差异对比 本文档根据下表列出的固件版本，对 BC95 和 BC35-G、BC95 R2.0 进行软件差异对比。 表 4：固件版本 模组 芯片 固件版本 BC95 Hi2110 (V120) V100R100C10B657SP5 BC35-G/BC95 R2.0 Hi2115 (V150) V150R100C20B300SP2 3.1. 软件功能差异 表 5：软件功能差异 模组 芯片 Multi-Tone ECID OTDOA IPv6 TCP LwM2M MQTT BC95 Hi2110 (V120) 不支持 不支持 不支持 不支持 不支持 不支持 不支持 BC35-G/BC95 R2.0 Hi2115 (V150) 支持 支持，仅供测试 支持，仅供测试 支持 支持 支持 BC35-G 已支持，BC95 R2.0 暂不支持 上海移远通信技术股份有限公司 13 / 29 3.2. 输出及提示信息差异 BC95&BC35-G&BC95 R2.0 差异对比 表 6：开机输出信息差异 模组 芯片 上电开机 硬件重启 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) REBOOT_CAUSE_UNKNOWN REBOOT_CAUSE_SECURITY _RESET_UNKNOWN REBOOT_CAUSE_SECURITY_PM U_POWER_ON_RESET REBOOT_CAUSE_SECURITY_RE SET_PIN 表 7：华为 IoT 平台功能和指示信息差异 模组 芯片 平台功能 提示信息 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) 不使用华为 IoT 平台时，无需执行 关闭动作 无 URC 提示 不使用华为 IoT 平台时，需通过 AT+QREGSWT=2 命令关闭平台注册 功能 +QLWEVTIND:0 +QLWEVTIND:3 表 8：DFOTA 升级提示信息差异 模组 芯片 DFOTA 升级提示信息 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) FIRMWARE DOWNLOADING FIRMWARE DOWNLOADED FIRMWARE UPDATING REBOOT_CAUSE_SECURITY _RESET_UNKNOWN FIRMWARE UPDATING FIRMWARE UPDATE SUCCESS FIRMWARE UPDATE OVER +QLWEVTIND:5 FIRMWARE DOWNLOADING FIRMWARE DOWNLOADED FIRMWARE UPDATING REBOOT_CAUSE_SECURITY_FO TA_UPGRADE FIRMWARE UPDATE SUCCESS FIRMWARE UPDATE OVER 上海移远通信技术股份有限公司 14 / 29 BC95&BC35-G&BC95 R2.0 差异对比 3.3. AT 命令差异对比 3.3.1. 网络相关命令 3.3.1.1. AT+COPS 选择运营商 BC95 Hi2110 (V120) Test Command AT+COPS=? Response +COPS:(2,,,'46000'),,(0-2),(2) OK BC35-G/BC95 R2.0 Hi2115 (V150) Test Command AT+COPS=? Response +COPS: (2,,,'46011'),(3,,,'46000'),(3,,,'46001'),,(0 -2),(2) OK 差异：命令的返回值不同。 ⚫ BC95 1) 可以在 RRC 任何状态下（包括非连接状态）查询 PLMN 设置，且返回值是在 USIM 卡中配 置的信息。 2) 执行 AT+COPS=? 过程中可以执行其他 AT 命令，该命令的最大响应时间为 300ms。 ⚫ BC35-G/BC95 R2.0 1) 只有在 RRC 未连接时才能查询 PLMN 设置，返回值是当前网络中存在的运营商 PLMN 值。 2) 执行 AT+COPS=? 过程中不可执行其他 AT 命令，该命令的最大响应时间为 630s。 3.3.2. UDP 相关命令 3.3.2.1. AT+NSOCR 创建 Socket BC95 Hi2110 (V120) Write Command AT+NSOCR=,,[,] Response BC35-G/BC95 R2.0 Hi2115 (V150) Write Command AT+NSOCR=,,[,[,[,]]] Response 上海移远通信技术股份有限公司 15 / 29 BC95&BC35-G&BC95 R2.0 差异对比 OK OK 差异：支持的 Socket 类型（）和返回值 的起始值不同。 ⚫ BC95 1) 仅支持 =DGRAM（UDP 功能）。 2) 的起始值从 0 或 1 开始。 ⚫ BC35-G/BC95 R2.0 1) 支持 =DGRAM（UDP 功能）和 =STREAM（TCP 功能）。 2) 的起始值从 1、2 或 3 开始。 3) 支持可选参数 和 。 3.3.2.2. AT+NSOST 发送 UDP 数据 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) Write Command AT+NSOST=,,,, Response , Write Command AT+NSOST=,,,,[,] Response , OK OK 差异：发送数据的最大字节数和返回值不同。 ⚫ BC95 1) 支持一次最大 512 字节的数据（）发送，即 的最大值为 512。 2) 返回值不支持 URC 上报。 ⚫ BC35-G/BC95 R2.0 1) 支持一次最大 1358 字节的数据（）发送，即 的最大值为 1358。 2) 支持可选参数 ；数据发送完成后，如果设置 在 1-255 范围内， 返回值会包含形式为 +NSOSTR:,, 的 URC。 上海移远通信技术股份有限公司 16 / 29 BC95&BC35-G&BC95 R2.0 差异对比 3.3.2.3. AT+NSOSTF 发送 UDP 数据并携带标志位 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) Write Command Write Command AT+NSOSTF=,,<rem AT+NSOSTF=,,,,, ort>,,,[,] Response , Response , OK OK 差异：发送数据的最大字节数和返回值不同。 ⚫ BC95 1) 支持一次最大 512 字节的数据（）发送，即 的最大值为 512。 2) 返回值不支持 URC 上报。 ⚫ BC35-G/BC95 R2.0 1) 支持一次最大 1358 字节的数据（）发送，即 的最大值为 1358。 2) 支持可选参数 ；数据发送完成后，如果设置 在 1-255 范围内， 返回值会包含形式为 +NSOSTR:,, 的 URC。 3.3.3. UART 波特率配置相关命令 3.3.3.1. AT+NATSPEED 配置 UART 波特率 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) Test Command AT+NATSPEED=? Test Command AT+NATSPEED=? Response Response +NATSPEED:(4800,9600,57600,115200),(0-3 +NATSPEED:(4800,9600,57600,115200,230400,460 0),(0,1),(0-3),(1,2) 800),(0-30),(0,1),(0-3),(1,2),(0-2),(0,1) OK OK 上海移远通信技术股份有限公司 17 / 29 差异：默认的返回值不同。 ⚫ BC95 仅支持 4 个波特率。 ⚫ BC35-G/BC95 R2.0 支持 6 个波特率，且支持奇偶校验和软件流控。 BC95&BC35-G&BC95 R2.0 差异对比 3.3.4. 华为 IoT 平台相关命令 3.3.4.1. AT+NMGS 发送消息 BC95 Hi2110 (V120) Write Command AT+NMGS=, Response OK BC35-G/BC95 R2.0 Hi2115 (V150) Write Command AT+NMGS=,[,] Response OK [+NSMI:] [+NSMI:[,]] 差异：命令支持的参数不同。 ⚫ BC95 1) 不支持参数 。 2) 当通过 AT+NSMI=1 命令使能消息发送状态指示时，返回值会包含形式为 +NSMI: 的 URC，其中参数 指示为 SENT 或 DISCARDED。 ⚫ BC35-G/BC95 R2.0 1) 支持参数 ，参数范围在 1-255。 2) 当通过 AT+NSMI=1 命令使能消息发送状态指示时，返回值会包含形式为 +NSMI:[,] 的 URC，其中参数 指示为 SENT 或 SENT_TO_AIR_INTERFACE 或 DISCARDED。 备注 当设置 AT+NSMI=1 时，BC35-G、BC95 和 BC95 R2.0 会返回指示消息发送状态的 URC，URC 格式如 上所述；当设置 AT+NSMI=0 时，AT+NMGS 命令返回值中将不会包含指示消息状态的 URC，仅返回 OK。 上海移远通信技术股份有限公司 18 / 29 3.3.4.2. AT+NNMI 发送新消息指示 BC95 Hi2110 (V120) Read Command AT+NNMI? Response +NNMI:0 OK 差异：默认的返回值不同。 ⚫ BC95 默认返回值是 0。 ⚫ BC35-G/BC95 R2.0 默认返回值是 1。 BC95&BC35-G&BC95 R2.0 差异对比 BC35-G/BC95 R2.0 Hi2115 (V150) Read Command AT+NNMI? Response +NNMI:1 OK 3.3.4.3. AT+QLWULDATAEX 发送 CON/NON 消息 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) Write Command AT+QLWULDATAEX=,, Response OK Write Command AT+QLWULDATAEX=,,[,] Response OK [+QLWULDATASTATUS:] [+QLWULDATASTATUS:[,]] 差异：命令支持的参数不同。 ⚫ BC95 1) 不支持参数 。 2) 当发送 CON 消息时（=0x0100 或 0x0101），返回值会包含形式为 +QLWULDATASTATUS: 的 URC。 上海移远通信技术股份有限公司 19 / 29 BC95&BC35-G&BC95 R2.0 差异对比 ⚫ BC35-G/BC95 R2.0 1) 支持参数 ，参数范围在 0-255。 2) 当 发 送 CON 消 息 时 （ =0x0100 或 0x0101 ）， 返 回 值 会 包 含 形 式 为 +QLWULDATASTATUS:[,]] 的 URC。 3.3.4.4. AT+QLWULDATASTATUS 查询 CON 消息发送状态 BC95 Hi2110 (V120) Read Command AT+QLWULDATASTATUS? Response +QLWULDATASTATUS: OK BC35-G/BC95 R2.0 Hi2115 (V150) Read Command AT+QLWULDATASTATUS? Response +QLWULDATASTATUS:[,] OK 差异：命令返回值参数不同。 ⚫ BC95 仅支持返回值参数 。 ⚫ BC35-G/BC95 R2.0 支持返回值参数 和 。 3.3.4.5. AT+NMSTATUS 查询注册 CDP Server 状态 BC95 Hi2110 (V120) Test Command AT+NMSTATUS=? Response UNINITIALISED MISSING_CONFIG INIT_FAILED BC35-G/BC95 R2.0 Hi2115 (V150) Test Command AT+NMSTATUS=? Response UNINITIALISED MISSING_CONFIG INIITIALISING 上海移远通信技术股份有限公司 20 / 29 BC95&BC35-G&BC95 R2.0 差异对比 INIITIALISING INIITIALISED INIITIALISED INIT_FAILED REGISTERING REGISTERING REREGISTERING REGISTERED REGISTERED DEREGISTERED REREGISTERED MO_DATA_ENABLED MO_DATA_ENABLED NO_UE_IP NO_UE_IP REJECTED_BY_SERVER MEMORY_ERROR TIMEOUT_AND_RETRYING COAP_ERROR REG_FAILED MSG_SEND_FAILED DEREG_FAILED REJECTED_BY_SERVER OK TIMEOUT_AND_RETRYING TIMEOUT_AND_FAILED OK 差异：命令的默认返回值不同。 ⚫ BC95 支持 17 项注册 CDP server 状态消息。 ⚫ BC35-G/BC95 R2.0 支持 14 项注册 CDP server 状态消息。 上海移远通信技术股份有限公司 21 / 29 BC95&BC35-G&BC95 R2.0 差异对比 3.3.4.6. AT+QSECSWT 设置数据加密模式 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) Write Command Write Command AT+QSECSWT=[,<renegotiation tim AT+QSECSWT=[,] e>] Response OK Response OK 差异：命令的设置参数不同。 ⚫ BC95 支持设置参数 ，配置重协商时间。 ⚫ BC35-G/BC95 R2.0 支持根据不同的 类型，选择固定的重协商时间。 3.3.5. 其他命令 3.3.5.1. AT+NPING 测试 IP 网络与远端主机连接 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) Write Command AT+NPING=[,[,]] Response OK Write Command AT+NPING=[,[,]] Response OK 差异：参数 取值范围不同。 ⚫ BC95 参数 的取值范围为：8-1460 字节，且默认返回值为 8。 ⚫ BC35-G/BC95 R2.0 参数 的取值范围为：12-1500 字节，且默认返回值为 12。 上海移远通信技术股份有限公司 22 / 29 BC95&BC35-G&BC95 R2.0 差异对比 3.3.5.2. AT+CGDCONT 定义 PDP 上下文 BC95 BC35-G/BC95 R2.0 Hi2110 (V120) Hi2115 (V150) Test Command AT+CGDCONT=? Response +CGDCONT:(0-10),('IP','NONIP'),,,(0),(0),,,,, (0,1) Test Command AT+CGDCONT=? Response +CGDCONT:(0-10),('IP','NONIP','IPV6','IPV4V6 '),,,(0),(0),,,,,(0,1) OK OK Write Command Write Command AT+CGDCONT=[,[,<AP AT+CGDCONT=[,[,[,,,,,,,,< N>]] NSLPI>]]] Response Response OK OK 差异：参数 值和 PDP 类型（）不同 ⚫ BC95 1) 当未通过 AT+CGDCONT 配置时，可以获取到 。 2) 参数 默认值是 IPv4。 ⚫ BC35-G/BC95 R2.0 1) 当未通过 AT+CGDCONT 配置时， 的值为空， 的值是由写入命令设置的。 2) 参数 默认值是 IPv4v6。 3.3.5.3. AT+NCONFIG 配置 UE 模式 BC95 Hi2110 (V120) Read Command AT+NCONFIG? Response +NCONFIG:AUTOCONNECT,TRUE +NCONFIG:CR_0354_0338_SCRAMBLING, TRUE +NCONFIG:CR_0859_SI_AVOID,TRUE +NCONFIG:COMBINE_ATTACH,FALSE BC35-G/BC95 R2.0 Hi2115 (V150) Read Command AT+NCONFIG? Response +NCONFIG:AUTOCONNECT,TRUE +NCONFIG:CR_0354_0338_SCRAMBLING,TRUE +NCONFIG:CR_0859_SI_AVOID,TRUE +NCONFIG:COMBINE_ATTACH,FALSE +NCONFIG:CELL_RESELECTION,TRUE +NCONFIG:ENABLE_BIP,FALSE +NCONFIG:MULTITONE,TRUE 上海移远通信技术股份有限公司 23 / 29 BC95&BC35-G&BC95 R2.0 差异对比 +NCONFIG:CELL_RESELECTION,FALSE +NCONFIG:ENABLE_BIP,FALSE OK 差异：命令的默认返回值不同。 ⚫ BC95 支持配置 UE 的 6 种模式。 ⚫ BC35-G/BC95 R2.0 支持配置 UE 的 18 种模式。 +NCONFIG:NAS_SIM_POWER_SAVING_ENABLE, TRUE +NCONFIG:BARRING_RELEASE_DELAY,64 +NCONFIG:RELEASE_VERSION,13 +NCONFIG:RPM,FALSE +NCONFIG:SYNC_TIME_PERIOD,0 +NCONFIG:IPV6_GET_PREFIX_TIME,15 +NCONFIG:NB_CATEGORY,1 +NCONFIG:RAI,FALSE +NCONFIG:HEAD_COMPRESS,FALSE +NCONFIG:RLF_UPDATE,FALSE +NCONFIG:CONNECTION_REESTABLISHMENT, FALSE OK 3.3.5.4. AT+NUESTATS 查询 UE 最新操作统计数 BC95 Hi2110 (V120) Execution Command AT+NUESTATS Response Signal power:-32768 Total power:-32768 TX power:-32768 TX time:0 RX time:0 Cell ID:4294967295 ECL:255 SNR:-32768 EARFCN:4294967295 PCI:65535 RSRQ:-32768 OK BC35-G/BC95 R2.0 Hi2115 (V150) Execution Command AT+NUESTATS Response Signal power:-32768 Total power:-32768 TX power:-32768 TX time:0 RX time:0 Cell ID:4294967295 ECL:255 SNR:-32768 EARFCN:4294967295 PCI:65535 RSRQ:-32768 OPERATOR MODE:0 上海移远通信技术股份有限公司 24 / 29 OK 差异：命令的默认返回值不同。 ⚫ BC95 返回值不支持 OPERATOR MODE。 ⚫ BC35-G/BC95 R2.0 返回值支持 OPERATOR MODE。 BC95&BC35-G&BC95 R2.0 差异对比 3.3.5.5. AT+NUESTATS=RADIO 查询 UE 最新操作统计数 BC95 Hi2110 (V120) Write Command AT+NUESTATS=RAIOD Response NUESTATS:RADIO,Signal power:-32768 NUESTATS:RADIO,Total power:-32768 NUESTATS:RADIO,TX power:-32768 NUESTATS:RADIO,TX time:0 NUESTATS:RADIO,RX time:0 NUESTATS:RADIO,Cell ID:4294967295 NUESTATS:RADIO,ECL:255 NUESTATS:RADIO,SNR:-32768 NUESTATS:RADIO,EARFCN:4294967295 NUESTATS:RADIO,PCI:65535 NUESTATS:RADIO,RSRQ:-32768 OK BC35-G/BC95 R2.0 Hi2115 (V150) Write Command AT+NUESTATS=RAIOD Response NUESTATS:RADIO,Signal power:-32768 NUESTATS:RADIO,Total power:-32768 NUESTATS:RADIO,TX power:-32768 NUESTATS:RADIO,TX time:0 NUESTATS:RADIO,RX time:0 NUESTATS:RADIO,Cell ID:4294967295 NUESTATS:RADIO,ECL:255 NUESTATS:RADIO,SNR:-32768 NUESTATS:RADIO,EARFCN:4294967295 NUESTATS:RADIO,PCI:65535 NUESTATS:RADIO,RSRQ:-32768 NUESTATS:RADIO,OPERATOR MODE:0 上海移远通信技术股份有限公司 25 / 29 BC95&BC35-G&BC95 R2.0 差异对比 OK 差异：命令的默认返回值不同。 ⚫ BC95 返回值不支持 OPERATOR MODE。 ⚫ BC35-G/BC95 R2.0 返回值支持 OPERATOR MODE。 3.3.5.6. AT+NPOWERCLASS 设置频段与发射功率 BC95 Hi2110 (V120) Test Command AT+NPOWERCLASS=? Response +NPOWERCLASS:(5),(3,5) Or +NPOWERCLASS:(8),(3,5) OK BC35-G BC95 R2.0 Hi2115 (V150) Hi2115 (V150) Test Command AT+NPOWERCLASS=? Test Command AT+NPOWERCLASS=? Response Response +NPOWERCLASS:(5,8,3,28,20,1),(3 +NPOWERCLASS:(5),(3,5,6) ,5,6) OK Or +NPOWERCLASS:(8),(3,5,6) OK 差异：支持的频段和功率等级（）不同。 ⚫ BC95 仅支持单频段（如 Band 5 或 Band 8），且参数 支持 3、5。 ⚫ BC35-G/BC95 R2.0 1) BC35-G 支持多频段（如 Band 5、Band 8、Band 3、Band 28、Band 20、Band 1），且参数 支持 3、5、6。 2) BC95 R2.0 支持单频段 Band 5 或 Band 8，且参数 支持 3、5、6。 3.4. BC35-G 和 BC95 R2.0 新增 AT 命令 下表列出了 BC95 与 BC35-G、BC95 R2.0 进行比较时，BC35-G、BC95 R2.0 新增的 AT 命令。 上海移远通信技术股份有限公司 26 / 29 BC95&BC35-G&BC95 R2.0 差异对比 表 9：BC35-G 和 BC95 R2.0 新增 AT 命令 序号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 新增 AT 命令 AT+QLEDMODE AT+CGCONTRDP AT+CNMPSD AT+NQSOS AT+NSOCO AT+NSOSD +NSOCLI AT+NIPINFO AT+NCPCDPR AT+NQPODCP AT+QDNS AT+QLWSREGIND AT+QLWULDATA AT+QLWFOTAIND AT+QREGSWT +QLWEVTIND AT+QRESETDTLS AT+QDTLSSTAT AT+QLWSERVERIP AT+QCHIPINFO AT+NSONMI 命令描述 设置网络状态指示灯功能模式 读取 PDP 上下文动态参数 提示无 PS 数据交互 查询 Socket 中挂起的消息列表 建立 TCP 连接 发送 TCP 数据 Socket 关闭提示 报告 IP 地址信息 配置要读取的 PDP 上下文动态参数 查询通过控制平面挂起的原始数据列表 DNS 域名解析 华为 IoT 平台注册控制 发送 LwM2M 数据 设置 DFOTA 升级模式 设置注册华为 IoT 平台模式 报告 LwM2M 事件 重置 DTLS 模式 查询 DTLS 状态 设置/删除 Bootstrap/LwM2M 服务器地址 读取系统信息 Socket 已接收消息提示 备注 有关上述 AT 命令的更多详细信息，请参阅文档 Quectel_BC35-G&BC28&BC95 R2.0_AT_Commands_ Manual。 上海移远通信技术股份有限公司 27 / 29 BC95&BC35-G&BC95 R2.0 差异对比 4 附录 A 表 10：参考文档 SN Document Name [1] Quectel_BC95_硬件设计手册 [2] Quectel_BC35-G_硬件设计手册 [3] Quectel_BC95_AT_Commands_Manual Quectel_BC35-G&BC28&BC95 R2.0_AT_ [4] Commands_Manual Remark BC95 硬件设计手册 BC35-G 硬件设计手册 BC95 AT 命令使用手册 BC35-G&BC28&BC95 R2.0 AT 命令使用手 册 表 11：术语缩写 Abbreviation DNS DTLS ECID IPv4 IPv6 LwM2M NB-IoT OTDOA PDP PLMN TCP Description Domain Name System Datagram Transport Layer Security Enhanced Cell ID Internet Protocol Version 4 Internet Protocol Version 6 Lightweight Machine to Machine Narrow Band Internet of Thing Observed Time Difference of Arrival Packet Data Protocol Public Land Mobile Network Transmission Control Protocol 上海移远通信技术股份有限公司 28 / 29 UART UE UDP URC CDP RRC BC95&BC35-G&BC95 R2.0 差异对比 Universal Asynchronous Receiver/Transmitter User Equipment User Datagram Protocol Unsolicited Result Code Connected Device Platform RRC Radio Resource Control 上海移远通信技术股份有限公司 29 / 29

BC35-GR&BC95-BxR&BC35-G& BC95 R2.0 系列软件差异说明 NB-IoT 模块系列 版本：1.0 日期：2020-11-11 状态：受控文件 www.quectel.com BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 文档历史 修订记录 版本 1.0 日期 2020-10-02 2020-11-11 作者 梁维 梁维 变更表述 文档创建 受控版本 上海移远通信技术股份有限公司 2 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 7 2 综述 ........................................................................................................................................................ 8 2.1. 产品简介 .................................................................................................................................. 8 2.2. 波特率特性............................................................................................................................... 8 2.3. 深休眠模式............................................................................................................................... 8 2.4. 开机 URC................................................................................................................................. 9 3 常用 AT 命令 ........................................................................................................................................ 10 3.1. 一般命令差异 ......................................................................................................................... 11 3.1.1. 显示产品标识信息............................................................................................................. 11 3.1.2. 设置命令回显模式............................................................................................................. 11 3.1.3. 查询制造商版本号............................................................................................................. 12 3.1.4. 重启命令 ........................................................................................................................... 12 3.1.5. 查询可用命令.................................................................................................................... 13 3.1.6. 清除存储的频点 ................................................................................................................ 13 3.1.7. 设置 UE 功能 .................................................................................................................... 14 3.1.8. 查询当前日期和时间 ......................................................................................................... 14 3.1.9. 扩展错误报告命令............................................................................................................. 15 3.2. 注网相关命令 ......................................................................................................................... 15 3.2.1. 查询小区信息.................................................................................................................... 15 3.2.2. 锁频命令 ........................................................................................................................... 16 3.2.3. 运营商选择 ....................................................................................................................... 17 3.2.4. 显示 PDP 地址命令 .......................................................................................................... 17 3.2.5. 设置时间同步模式命令 ..................................................................................................... 18 3.3. 网络配置相关命令.................................................................................................................. 18 3.3.1. 配置 PDP 上下文 .............................................................................................................. 19 3.3.2. 查询 eDRX 设置................................................................................................................ 19 4 TCP/UDP AT 命令 ............................................................................................................................... 20 4.1. TCP/UDP AT 命令差异 .......................................................................................................... 20 4.1.1. 创建 Socket ...................................................................................................................... 20 4.1.2. TCP 连接 .......................................................................................................................... 21 4.1.3. UDP 发送消息 .................................................................................................................. 21 4.1.4. UDP 发送带 RAI 消息 ....................................................................................................... 22 4.1.5. TCP 发送消息................................................................................................................... 23 4.1.6. 读取消息 ........................................................................................................................... 23 4.1.7. 查询待处理上行消息清单.................................................................................................. 24 4.1.8. 设置已到达 Socket 消息 URC 模式 .................................................................................. 25 4.1.9. 关闭 Socket ...................................................................................................................... 26 上海移远通信技术股份有限公司 3 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 4.1.10. PING 操作命令 ................................................................................................................. 26 4.1.11. 域名解析 ........................................................................................................................... 27 4.2. URC 差异............................................................................................................................... 28 5 中国电信物联网平台............................................................................................................................. 29 5.1. 中国电信物联网平台相关 AT 命令差异 .................................................................................. 29 5.1.1. 配置 Lifetime..................................................................................................................... 29 5.1.2. 配置 IP 和端口 .................................................................................................................. 30 5.1.3. 平台注册（发起连接） ..................................................................................................... 30 5.1.4. 发送数据 ........................................................................................................................... 31 5.1.5. 发送携带 RAI 的数据 ........................................................................................................ 31 5.1.6. 查询 CON 数据发送状态................................................................................................... 32 5.1.7. 读取数据 ........................................................................................................................... 32 5.1.8. 配置数据接收模式............................................................................................................. 33 5.1.9. 注销连接 ........................................................................................................................... 33 5.1.10. 查询注册状态.................................................................................................................... 34 5.1.11. 查询消息状态.................................................................................................................... 34 5.2. URC 差异............................................................................................................................... 35 6 OneNET 平台....................................................................................................................................... 36 7 附录 A 参考文档及术语缩写................................................................................................................. 37 上海移远通信技术股份有限公司 4 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：波特率特性差异 .................................................................................................................................. 8 表 3：深休眠模式对比 .................................................................................................................................. 9 表 4：AT 命令语句格式差异 ....................................................................................................................... 10 表 5：显示产品标识信息命令差异...............................................................................................................11 表 6：设置命令回显模式命令差异...............................................................................................................11 表 7：查询制造商版本号命令差异.............................................................................................................. 12 表 8：重启命令差异.................................................................................................................................... 12 表 9：查询可用命令的命令差异 ................................................................................................................. 13 表 10：清除存储的频点命令差异 ............................................................................................................... 13 表 11：设置 UR 功能命令差异.................................................................................................................... 14 表 12：查询当前日期和时间命令差异 ........................................................................................................ 14 表 13：扩展错误报告命令差异 ................................................................................................................... 15 表 14：查询小区命令差异 .......................................................................................................................... 15 表 15：锁频命令差异.................................................................................................................................. 16 表 16：运营商选择命令差异....................................................................................................................... 17 表 17：显示 PDP 地址命令差异 ................................................................................................................. 17 表 18：设置时间同步模式命令差异............................................................................................................ 18 表 19：配置 PDP 上下文命令差异 ............................................................................................................. 19 表 20：查询 eDRX 设置命令差异............................................................................................................... 19 表 21：创建 Socket 命令差异..................................................................................................................... 20 表 22：TCP 连接命令差异 ......................................................................................................................... 21 表 23：UDP 发送消息命令差异.................................................................................................................. 21 表 24：UDP 发送带 RAI 消息命令差异 ...................................................................................................... 22 表 25：TCP 发送消息命令差异 .................................................................................................................. 23 表 26：读取消息命令差异 .......................................................................................................................... 23 表 27：查询待处理上行消息清单命令差异................................................................................................. 24 表 28：设置已到达 Socket 消息 URC 模式命令差异 ................................................................................. 25 表 29：关闭 Socket 命令差异..................................................................................................................... 26 表 30：PING 操作命令差异........................................................................................................................ 26 表 31：域名解析命令差异 .......................................................................................................................... 27 表 32：TCP/UDP 相关 URC 差异 .............................................................................................................. 28 表 33：UDP 发送消息命令差异.................................................................................................................. 29 表 34：配置 IP 和端口命令差异 ................................................................................................................. 30 表 35：平台注册（发起连接）命令差异 .................................................................................................... 30 表 36：发送消息命令差异 .......................................................................................................................... 31 表 37：发送携带 RAI 数据命令差异 ........................................................................................................... 31 表 38：查询 CON 数据发送状态命令差异.................................................................................................. 32 表 39：读取数据命令差异 .......................................................................................................................... 32 表 40：配置数据接收模式命令差异............................................................................................................ 33 表 41：注销连接命令差异 .......................................................................................................................... 33 上海移远通信技术股份有限公司 5 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 表 42：查询注册状态命令差异 ................................................................................................................... 34 表 43：查询消息状态命令差异 ................................................................................................................... 34 表 44：TCP/UDP 相关 URC 差异 .............................................................................................................. 35 表 45：OneNET 平台相关 AT 命令差异 ..................................................................................................... 36 表 46：参考文档 ......................................................................................................................................... 37 表 47：术语缩写 ......................................................................................................................................... 37 上海移远通信技术股份有限公司 6 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 1 引言 BC35-GR、BC95-B5R、BC95-B8R 和 BC35-G、BC95 R2.0 系列模块在硬件上相互兼容，一般情况 下客户无需重新设计 PCB，但是软件方面存在一些差异。本文档主要介绍了模块在软件方面的差异性，包 括休眠模式、波特率特性、综合 AT 命令、物联网平台相关 AT 命令以及 URC 等方面的差异。 本文档适用模块如下表所示。 表 1：适用模块 系列 NB-IoT 系列模块 模块 BC35-GR BC95-B8R BC95-B5R BC35-G BC95 R2.0 系列 备注 关于 BC35-GR、BC95-B5R、BC95-B8R 和 BC35-G、BC95 R2.0 系列模块的硬件差异，请参考 《Quectel_BC35-GR&BC95-B5R&BC95-B8R&BC35-G&BC95 R2.0 系列_差异说明》。 上海移远通信技术股份有限公司 7 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 2 综述 2.1. 产品简介 BC35-GR、BC95-B5R、BC95-B8R 和 BC35-G、BC95 R2.0 系列模块均为 NB-IoT 物联网模块，具有 高性能，低功耗的特性，用户可以根据需求选择合适的产品用于终端设计。 2.2. 波特率特性 BC35-GR、BC95-B5R、BC95-B8R 和 BC35-G、BC95 R2.0 系列模块的波特率特性差异如下表所示。 表 2：波特率特性差异 特性 主串口波特率 (bps) 调试串口波特率 (bps) BC35-GR/BC95-B5R/BC95-B8R BC35-G/BC95 R2.0 系列 2400、4800、9600（默认）、14400、 2400、4800、9600（默认）、57600、 28800、33600，57600 115200、230400、460800、921600 921600；不可配置 921600；不可配置 2.3. 深休眠模式 BC35-GR、BC95-B5R、BC95-B8R 和 BC35-G、BC95 R2.0 系列模块都支持低功耗模式，区别是： 当进入深度休眠模式后，BC35-GR、BC95-B5R 和 BC95-B8R 模块由于串口不再工作，所以当模块进入深 休眠模式后，需要通过主串口发送命令 AT 以唤醒模块，然后才能进行正常的数据业务。需要注意的是，用 来触发唤醒的数据会丢失，模块不会处理。建议在软件设计唤醒模块时，每隔 500 ms 循环发送 AT，当返 回 OK 后，说明模块已经唤醒成功，可以正常进行数据交互。 上海移远通信技术股份有限公司 8 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 表 3：深休眠模式对比 功能 BC35-GR/BC95-B5R/BC95-B8R BC35-G/BC95 R2.0 系列 功耗 URC 提示 URC 开关命令 3.8 μA 唤醒：+QATWAKEUP 进入：+QATSLEEP AT+QATWAKEUP=, 默认打开 3.0 μA 唤醒：+NPSMR:0 进入：+NPSMR:1 AT+NPSMR=, 默认关闭 唤醒方式 UART/RTC 1) 上行数据/ RTC 1) 主串口 唤醒后，主串口才可以发送数据 主串口可以直接发数据 AT 命令 AT+QSCLK AT+CPSMS 备注 1) RTC 主要针对 lifetime、TAU 计时等。 2.4. 开机 URC BC35-GR、BC95-B5R、BC95-B8R 和 BC35-G、BC95 R2.0 系列模块上电开机时，都会有相应的 URC 来表示开机时的状态。用户可以通过开机上报的 URC 来判断模块是否开机成功，如下所示： ⚫ BC35-GR、BC95-B5R 和 BC95-B8R 开机 URC 如下。收到 URC RDY 表示模块开机成功： ⚫ BC95 开机 URC 如下,当收到 OK 后，表示模块开机成功： 上海移远通信技术股份有限公司 9 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 3 常用 AT 命令 AT 命令一般根据功能被分为 3 个类别：一般命令、注网相关命令和网络配置相关命令。BC35-GR、 BC95-B5R、BC95-B8R 和 BC35-G、BC95 R2.0 系列模块的 AT 命令之间有一些共有的设计差异，如下所 述： 1. 一般情况下 AT 命令响应中的冒号（:）后： ⚫ BC35-GR、BC95-B5R 和 BC95-B8R 模块 AT 命令响应中的冒号后带有一个空格； ⚫ BC35-G 和 BC95 R2.0 系列模块 AT 命令响应中的冒号后面没有空格。 举例如下表中命令的响应。 2. 一般情况下 AT 命令响应中的字符串： ⚫ BC35-GR、BC95-B5R 和 BC95-B8R 模块响应中的字符串由双引号标示； ⚫ BC35-G 和 BC95 R2.0 系列模块 AT 命令响应中的字符串无双引号标示。 举例如下表 AT+CGPADDR= 响应中的字符串'101.43.5.1'。 表 4：AT 命令语句格式差异 AT 命令 AT+CGSN=1 AT+CGPADDR= 示例 BC35-G/BC95 R2.0 系列 AT+CGSN=1 +CGSN:861003040014856 OK AT+CGPADDR=0 +CGPADDR:0,101.43.5.1 OK BC35-GR/BC95-B5R/BC95-B8R AT+CGSN=1 +CGSN: 861003040014856 OK AT+CGPADDR? +CGPADDR: 1,'101.43.5.1' OK 上海移远通信技术股份有限公司 10 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 3.1. 一般命令差异 一般命令主要包含模块信息查询，模块开关机，异常事件上报等基础命令，如下子章节列举了客户实 际项目开发中常用的 AT 命令，以及 BC35-GR、BC95-B5R、BC95-B8R 和 BC35-G、BC95 R2.0 系列模 块间存在的差异。 3.1.1. 显示产品标识信息 表 5：显示产品标识信息命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 执行命令 ATI 响 应 （ 以 BC95 R2.0 系 列 为 例 ， 固 件 版 本 为 BC95B5JBR01A02） Quectel BC95-B5 Revision:BC95B5JBR01A02 执行命令 ATI 响 应 （ 以 BC95-B5R 为 例 ， 固 件 版 本 为 BC95B5RPBR01A01） Quectel_Ltd Quectel_BC95-B5R Revision: BC95B5RPBR01A01 OK OK 差异： 命令的返回值形式不同。BC35-GR、BC95-B5R 和 BC95-B8R 的 ATI 命令响应中的 Quectel 后增加了_Ltd，设备类型标识前增加了 _Quectel。 3.1.2. 设置命令回显模式 表 6：设置命令回显模式命令差异 BC35-G/BC95 R2.0 系列 执行命令 ATE 参数说明 整型。回显模式设置。 0 关闭回显模式 1 开启回显模式 BC35-GR/BC95-B5R/BC95-B8R 执行命令 ATE 参数说明 整型。回显模式设置。 0 关闭回显模式 1 开启回显模式 差异： 回显模式设置默认值不同。 ⚫ BC35-G/BC95 R2.0 系列 参数默认值为 0（默认关闭回显模式）。 上海移远通信技术股份有限公司 11 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 ⚫ BC35-GR/BC95-B5R/BC95-B8R 参数默认值为 1（默认开启回显模式）。 3.1.3. 查询制造商版本号 表 7：查询制造商版本号命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 执行命令 AT+CGMR 响应（以基线版本 V150R100C20B500SP3 为例） SSB,V150R100C10B200SP1 SECURITY_A,V150R100C20B500SP3 PROTOCOL_A,V150R100C20B500SP3 执行命令 AT+CGMR 响 应 （ 以 BC95-B5R 为 例 ， 固 件 版 本 为 BC95B5RPBR01A01） Revision: BC95B5RPBR01A01 OK APPLICATION_A,V150R100C20B500SP3 SECURITY_B,V150R100C20B500SP3 RADIO,Hi2115_RF6 OK 差异： 命令响应信息不同。 ⚫ BC35-G/BC95 R2.0 系列 该命令返回查询模块各个核的基线版本号。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 该命令返回查询模块固件版本号。 3.1.4. 重启命令 表 8：重启命令差异 BC35-G/BC95 R2.0 系列 执行命令 AT+NRB 响应 REBOOTING BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+QRST=1 响应 OK 上海移远通信技术股份有限公司 12 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 差异： 模块使用不同的 AT 命令进行软件重启，响应也不同。 ⚫ BC35-G/BC95 R2.0 系列 使用执行命令 AT+NRB 重启模块，响应 REBOOTING。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用设置命令 AT+QRST=1 重启模块，响应 OK。 3.1.5. 查询可用命令 表 9：查询可用命令的命令差异 BC35-G/BC95 R2.0 系列 执行命令 AT+CLAC 响应 [] BC35-GR/BC95-B5R/BC95-B8R 无 […] OK 差异： BC35-G 和 BC95 R2.0 系列模块可使用 AT+CLAC 列出可用命令；而 BC35-GR、BC95-B5R 和 BC95-B8R 模块无此命令。 3.1.6. 清除存储的频点 表 10：清除存储的频点命令差异 BC35-G/BC95 R2.0 系列 执行命令 AT+NCSEARFCN 响应 OK BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+QCSEARFCN=0 响应 OK 差异： 模块使用不同的 AT 命令清除存储的频点。 ⚫ BC35-G/BC95 R2.0 系列 使用执行命令 AT+NCSEARFCN 清除存储的频点，并且必须在无线处于非活动状态时执 行（AT+CFUN=0 将强制模块进入无线非活动状态） 上海移远通信技术股份有限公司 13 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用设置命令 AT+QCSEARFCN=0 清除存储的频点。 3.1.7. 设置 UE 功能 表 11：设置 UR 功能命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+CFUN=[,] 响应 OK BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+CFUN=[,] 响应 OK 差异： 命令相同，但 BC35-G 和 BC95 R2.0 系列的 参数暂不支持。 3.1.8. 查询当前日期和时间 表 12：查询当前日期和时间命令差异 BC35-G/BC95 R2.0 系列 查询命令 AT+CCLK? 响应 +CCLK: BC35-GR/BC95-B5R/BC95-B8R 查询命令 AT+CCLK? 响应 +CCLK: OK OK 举例（以 20 年 10 月 3 日 5 时 50 秒+32 时区为例） 举例（以 20 年 10 月 3 日 5 时 50 秒+32 时区为例） +CCLK:20/10/03,05:50:41+32 +QCCLK: 20/10/03,05:50:41 OK OK 差异： 命令响应的 参数格式存在差异。 ⚫ BC35-G/BC95 R2.0 系列 通过 AT+CCLK? 查询本地时间，响应的 参数会显示时区。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 通过 AT+CCLK? 查询本地时间，响应的 参数不显示时区。如需显示时区，可 通过 AT+QCCLK? 查询。 上海移远通信技术股份有限公司 14 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 3.1.9. 扩展错误报告命令 表 13：扩展错误报告命令差异 BC35-G/BC95 R2.0 系列 执行命令 AT+CEER 响应 +CEER: BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+CMEE=2 响应 OK OK 差异： 模块使用不同的命令设置是否启用扩展错误报告（即详细信息文本格式的错误信息）。 ⚫ BC35-G/BC95 R2.0 系列 提供单独的执行命令 AT+CEER 开启扩展错误报告。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用设置命令 AT+CMEE=2 开启扩展错误报告，使用设置命令 AT+CMEE=1 开启数值格 式错误码信息，使用 AT+CMEE=0 关闭错误码。 3.2. 注网相关命令 注网相关的常见命令，如查询小区信息，IP 和注册网络状态等，此类命令大都是 3GPP 的命令，所以 格式和功能基本相同，如下列举了需要特别注意的 AT 命令差异。 3.2.1. 查询小区信息 表 14：查询小区命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+NUESTATS=CELL 响应 NUESTATS:CELL,,,,,,, OK 设置命令 AT+QENG=0 响应 +QENG: 0,,,,,[],[],[],[],,,[], [] [+QENG: 1,,,,], 上海移远通信技术股份有限公司 15 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 [+QENG: 1,,,,], […] OK 举例 举例 NUESTATS:CELL,3682,281,1,-955,-122,-868,68 +QENG: 0,3682,,281,'0',-79.03,24,-64,4,8,'0',0,8 OK OK 差异： 模 块 使 用 不 同 命 令 查 询 小 区 信 息 ， 命 令 功 能 相 似 ， 但 返 回 值 不 同 。 参 数 解 释 请 参 考 《 Quectel_BC35-G&BC28&BC95 R2.0 系 列 _AT 命 令 手 册 》 和 《 Quectel_BC35-GR& BC95-B5R&BC95-B8R_AT 命令手册》。 3.2.2. 锁频命令 表 15：锁频命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+NEARFCN=,[,< pci>] 设置命令 AT+QLOCKF=[,,[, ]] 举例（锁定频点为 3682，物理小区 ID 为 119） AT+NEARFCN=0,3682,119 响应 OK 举例（指定激活锁定，锁定频点为 3682，偏移量为 -20， 物理小区 ID 为 281） AT+QLOCKF=1,3682,0,281 响应 OK 差异： 模块使用不同命令设置锁定频点，命令功能相同，但参数存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 （目前仅为 0，表示锁定 EARFCN 操作）、 和 参数指定搜索类型、锁定的频点和物理小区 ID。 ⚫ BC35-GR/BC95-B5R/BC95-B8R ⚫ 使用 设置激活锁定或移除锁定，同时 ，， 参 数指定锁定的频点、频点偏移量和物理小区 ID。 上海移远通信技术股份有限公司 16 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 3.2.3. 运营商选择 表 16：运营商选择命令差异 BC35-G/BC95 R2.0 系列 查询命令 AT+COPS? 响应 +COPS:[,,] BC35-GR/BC95-B5R/BC95-B8R 查询命令 AT+COPS? 响应 +COPS: [,,][,] OK OK 举例（以自动模式、数字格式、中国移动、NB-IoT 举例（以自动模式、数字格式、中国移动、NB-IoT 网 网络为例） 络为例） +COPS:0,2,'46000' +COPS: 0,2,'46000',9 OK OK 差异： 查询命令相同，但查询结果存在差异。 ⚫ BC35-G/BC95 R2.0 系列 命令响应信息包括当前运营商选择模式 、运营商显示格式 和运营商 信息 ，不显示接入技术信息 。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 命令响应信息包括当前运营商选择模式 、运营商显示格式 和运营商 信息 ，以及接入技术信息 。 3.2.4. 显示 PDP 地址命令 表 17：显示 PDP 地址命令差异 BC35-G/BC95 R2.0 系列 设置命令（查询默认 PDP 地址） AT+CGPADDR=0 响应（以 PDP 地址 101.43.5.1 为例） +CGPADDR:0,101.43.5.1 OK BC35-GR/BC95-B5R/BC95-B8R 查询命令（查询默认 PDP 地址） AT+CGPADDR? 或 AT+CGPADDR=1 响应（以 PDP 地址 100.111.3.246 为例） +CGPADDR: 1,'100.111.3.246' OK 差异： 查询默认地址命令类型不同，响应也存在差异。 上海移远通信技术股份有限公司 17 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 ⚫ BC35-G/BC95 R2.0 系列 默认 PDP 上下文 ID 为 0，需使用设置命令 AT+CGPADDR=0 查询默认 PDP 地址；响 应 OK 前无换行。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 默认 PDP 上下文 ID 为 1，查询命令 AT+CGPADDR? 可直接返回默认 PDP 地址，或使 用 AT+CGPADDR=1 指定返回默认上下文的 PDP 地址；响应 OK 前有换行。 3.2.5. 设置时间同步模式命令 表 18：设置时间同步模式命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+NITZ= BC35-GR/BC95-B5R/BC95-B8R 举例（以设置通过本地时间更新时间为例） AT+NITZ=0 无 举例（以设置通过 NITZ 更新时间为例） AT+NITZ=1 响应 OK 差异： BC35-G 和 BC95 R2.0 系列模块可配置时间同步模式，BC35-GR、BC95-B5R 和 BC95-B8R 模块不可配置。 ⚫ BC35-G/BC95 R2.0 系列 使用设置命令 AT+NITZ= 设置时间同步模式。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 默认通过 NITZ 更新时间，不可配置。 3.3. 网络配置相关命令 网络配置相关的常用命令包括 APN 配置和各网络模式的模式，如 eDRX，PSM 等。如下列举了需要特 别注意的 AT 命令差异。 上海移远通信技术股份有限公司 18 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 3.3.1. 配置 PDP 上下文 表 19：配置 PDP 上下文命令差异 AT 命令 AT+CGDCONT AT+QCGDEFCONT BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R AT+CGDCONT 命令可配置任意一路 PDN 连接。 不支持 AT+CGDCONT 命令不可配置默认 PDN 连接。 需使用 AT+QCGDEFCONT 命令配置默 认默认 PDP 上下文和 PDN 连接。 差异： BC35-G 和 BC95 R2.0 系列模块可使用 AT+CGDCONT 命令配置默认和其他 PDN 连接，而 BC35-GR、BC95-B5R 和 BC95-B8R 模块需区分默认和其他 PDN 连接的配置命令。 3.3.2. 查询 eDRX 设置 表 20：查询 eDRX 设置命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 查询命令 AT+CEDRXS? 响应 +CEDRXS:, 查询命令 AT+CEDRXS? 响应 +CEDRXS: ,, OK OK 举例（以接入 NB-IoT、eDRX 为 20.48 秒为例） +CEDRXS:5,'0010' OK 举例（以 eDRX 已启用、接入 NB-IoT、eDRX 为 81.92 秒为例） +CEDRXS: 1,5,'0101' OK 差异： 查询命令相同，响应返回的参数存在差异。 ⚫ BC35-G/BC95 R2.0 系列 响应中不包含表示 eDRX 开启状态的 参数。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 响应中包含参数 表示 eDRX 开启状态。 上海移远通信技术股份有限公司 19 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 4 TCP/UDP AT 命令 BC35-G、BC95 R2.0 系列和 BC35-GR、BC95-B5R 及 BC95-B8R 的 TCP/UDP 功能差异，主要在于 AT 命令的名称的不同，实现的功能类似，均为创建 socket，发送数据，读取数据等基本功能。主要差异是： 针对 BC35-G 和 BC95 R2.0 系列模块，UDP 和 TCP 作为两个独立的功能来开发 AT 命令；而针对 BC35-GR、 BC95-B5R 和 BC95-B8R，不区分 UDP 和 TCP，共用一套 AT 命令。 4.1. TCP/UDP AT 命令差异 4.1.1. 创建 Socket 表 21：创建 Socket 命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+NSOCR=,, [,[,[,]]] 设置命令 AT+QIOPEN=,,,'/',[,[,[,]]] 举例（以 UDP 类型、自动分配本地端口、忽略输 消息情况为例） AT+NSOCR=DGRAM,17,0,1 响应 举例（以上下文 ID 为 1、Socket ID 为 0、TCP 类型、 IP 地址为 220.18.39.22 远程端口为 8062、自动分配 本地端口、访问模式为缓存模式的情况为例） AT+QIOPEN=1,0,'TCP','220.18.39.22',8062,0,0 响应 OK OK +QIOPEN: , 举例（以创建的 Socket ID 为 0 为例） 0 举例（以创建的 Socket ID 为 0 为例） OK OK +QIOPEN: 0,0 差异： 创建 Socket 命令需要配置的参数存在差异，支持的最大 Socket 数不同。 上海移远通信技术股份有限公司 20 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 ⚫ BC35-G/BC95 R2.0 系列 最大支持 7 路 Socket，创建时必须配置 Socket 类型 、协议类型 、 本地端口号 ；接收控制 、互联网协议类型 和 IP 地址 为可选配置。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 最大支持 6 路 Socket，创建时必须配置上下文 ID 、Socket ID 、Socket 类型 、IP 地址/域名 /、 远程端口号 ；本地端口号 、数据访问模式、互联网协议类型 为可选配置。 4.1.2. TCP 连接 表 22：TCP 连接命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+NSOCO=,, 举例（以 Socket ID 为 0、服务器地址 192.158.5.1、 无 远程端口为 1024 的情况为例） AT+NSOCO=0,192.158.5.1,1024 响应 OK 差异： BC35-GR、BC95-B5R 和 BC95-B8R 模块无单独连接 TCP 服务器的命令。 4.1.3. UDP 发送消息 表 23：UDP 发送消息命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 设置命令 设置命令 AT+NSOST=,,<remot AT+QISENDEX=,,',,[,] ex_string>'[,] 举例（以发送数据为 3132 为例） AT+NSOST=0,192.158.5.1,1024,2,3132,1 响应 , 举例（以发送数据为 3132 为例） AT+QISENDEX=0,2,'3132' 响应 OK 上海移远通信技术股份有限公司 21 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 OK SEND OK 差异： 使用的命令和响应不同，并且发送数据时需要携带的参数存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NSOST 的设置命令发送消息。发送时必须携带的参数，除 Socket 编号 、 数 据 长 度 和 数 据 之 外 ， 需 要 携 带 服 务 器 地 址 和端口 ；响应返回 Socket 编号 和数据长 度 。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用 AT+QISENDEX 的设置命令发送消息。发送时仅必须携带 Socket ID 、 数据长度 和数据 ，不需要携带服务器地址和端口；响应 仅返回 OK 和 SEND OK。同时支持使用 AT+QISEND 仅发送文本字符串格式数据。 4.1.4. UDP 发送带 RAI 消息 表 24：UDP 发送带 RAI 消息命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+NSOSTF=,,,,,[,] 设置命令 AT+QISEND=,,''[,] 举例 举例 AT+NSOSTF=0,192.158.5.1,1024,0x200,2,3132,1 AT+QISEND=0,10,'3132333435',1 响应 , 响应 OK OK SEND OK 差异： UDP 发送带 RAI 的消息所使用的命令存在差异，响应也不同。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NSOSTF 的设置命令发送带 RAI 的消息。响应返回 Socket 编号 和 数据长度 。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用 AT+QISEND 的设置命令发送带 RAI 的消息。响应仅返回 OK 和 SEND OK。使用 AT+QISENDEX 时也可携带 RAI 参数。 上海移远通信技术股份有限公司 22 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 4.1.5. TCP 发送消息 表 25：TCP 发送消息命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 设置命令 设置命令 AT+NSOSD=,,[,<fla AT+QISENDEX=,,'[,]] ex_string>'[,] 举例（以发送数据为 3132 为例） AT+NSOSD=0,2,3132,0x100,255 响应 , 举例（以发送数据为 3132 为例） AT+QISENDEX=0,2,'3132' 响应 OK OK SEND OK 差异： 使用的命令和响应不同，并且发送数据时需要携带的参数存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NSOSD 的设置命令发送消息。发送时必须携带 Socket 编号 、数据 长度 和数据 参数，可选携带消息传输类型标志 和数据序列 ；响应返回 Socket 编号 和数据长度 。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用 AT+QISENDEX 的设置命令发送消息。发送时仅必须携带 Socket ID 、 数据长度 和数据 ，可选携带 RAI 标记 。同 时支持使用 AT+QISEND 仅发送文本字符串格式数据。 4.1.6. 读取消息 表 26：读取消息命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+NSORF=, BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+QIRD=, 举例（以 Socket ID 为 0，最大读取长度为 10 字节 举例（以 Socket ID 为 0，最大读取长度为 512 字节 为例） 为例） AT+NSORF=0,10 响应 AT+QIRD=0,512 响应 ,,,,,< +QIRD: [, th>] 上海移远通信技术股份有限公司 23 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 OK OK 举例 0,192.168.5.1,1024,2,3132,0 OK 举例 +QIRD: 2 3132 OK 差异： 读取消息命令的设置命令功能相同，使用的命令和文档中参数命名不同，读取的响应也存在 差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NSORF 的设置命令读取消息。携带的参数 Socket ID 和最大读取长度参数命 名分别定义为 和 ；响应返回 Socket ID 、发送消息 的 IP 地址 、发送消息的远程端口 、实际返回消息长度 ， 读取到的数据 以及未读取的剩余消息长度 。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用 AT+QIRD 的设置命令读取消息。携带的参数 Socket ID 和最大读取长度参数命名 分 别 定 义 为 和 ； 响 应 仅 返 回 实 际 读 取 长 度 、 读 取 到 的 数 据 以 及 可 选 的 剩 余 消 息 长 度 。 备注 BC35-GR 、 BC95-B5R 和 BC95-B8R 模 块 可 通 过 AT+QICFG 设 置 是 否 显 示 可 选 剩 余 消 息 长 度 。 4.1.7. 查询待处理上行消息清单 表 27：查询待处理上行消息清单命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+NQSOS=[,[,[…]]] BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+QISEND=,0 举例（以查询 Socket 0 和 1 为例） AT+NQSOS=0,1 响应 [+NQSOS:,] 举例（以查询 Socket 0 为例） AT+QISEND=0,0 响应 +QISEND: ,, 上海移远通信技术股份有限公司 24 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 [+NQSOS:,] […] OK 举例（以查询 Socket 0 和 1 为例） +NQSOS:0,2 +NQSOS:1,3 OK 举例（以查询 Socket 0 为例） +QISEND: 10,10,0 OK 差异： 查询待处理上行消息清单所使用的命令不同，查询结果存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NQSOS 的设置命令进行查询。每条命令支持查询多个 Socket ID 的待处理上行 消息。响应返回查询的 Socket ID 和 Socket ID 对应的待处理上行消息序列 。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 仅在 TCP 会话时，使用 AT+QISEND 的设置命令进行查询。每条命令仅支持查询一个 Socket ID 的待处理上行消息。响应返回通过会话已发送数据的总长度 、远程服 务器已应答数据的总长度 以及已发送但还未被远程服务器应答的数据总长度 。 4.1.8. 设置已到达 Socket 消息 URC 模式 表 28：设置已到达 Socket 消息 URC 模式命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+NSONMI= 响应 OK BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+QISWTMD=, 响应 OK 差异： 模块使用不同的命令设置已到达 Socket 消息 URC 的模式，并且已到达 Socket 消息的 URC 存在差异（URC 差异详见第 4.2 章节）。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NSONMI 的设置命令进行设置。携带的 参数可设置禁用消息 URC， 以及启用不同格式的消息 URC。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用 AT+QISWTMD 的设置命令进行设置。携带的 参数指定需设置的 Socket ID， 可指定两种数据访问模式，缓存模式和直吐模式，以及两 种模式对应的两种格式的消息 URC。不支持关闭消息 URC。 上海移远通信技术股份有限公司 25 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 4.1.9. 关闭 Socket 表 29：关闭 Socket 命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+NSOCL= 举例（以关闭 Socket 0 为例） AT+NSOCL=0 响应 OK BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+QICLOSE= 举例（以关闭 Socket 0 为例） AT+QICLOSE=0 响应 OK CLOSE OK 差异： 模块使用不同的命令关闭 Socket，但形式相同；命令响应存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NSOCL 的设置命令关闭指定 ID 的 Socket。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用 AT+QICLOSE 的设置命令关闭指定 ID 的 Socket。响应 OK 后，会 继续响应 CLOSE OK，CLOSE OK 表示关闭 Socket 操作成功。 4.1.10. PING 操作命令 表 30：PING 操作命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R 设置命令 设置命令 AT+NPING=[,[,<ti AT+QPING=,[,[,]] ng_num>[,]]] 举例（以服务器地址 39.156.66.18 为例） AT+NPING=39.156.66.18,32,10000 响应 OK 举例（以服务器地址 www.baidu.com 为例） AT+QPING=1,'www.baidu.com',4,1,32 响应 OK +NPING:,, [+NPING:,,] +QPING: [,,,,][…] +QPING: [,,,,,,] 举例（以服务器地址 39.156.66.18 为例） OK 举例（以服务器地址 www.baidu.com 为例） OK +NPING:39.156.66.18,49,1170 +QPING: 0,39.156.66.18,32,122,255 +QPING: 2,1,1,0,122,122,122 差异： 模块使用的命令、携带的参数以及参数配置均存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NPING 的设置命令。必须携带远程服务器地址参数 ， 仅支持点分十进制 IPv4 地址。可选的最大超时时间 参 数单位为毫秒。不支持设置 Ping 请求的最大次数 。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用 AT+QPING 的设置命令。必须携带上下文 ID 和远程服务器地址参数 ， 可支持域名和点分十进制 IP 地址。可选的最大超时时间 参 数单位为秒。支持设置 Ping 请求的最大次数 。 4.1.11. 域名解析 表 31：域名解析命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+QDNS=[,] 举例（以域名 www.baidu.com 为例） AT+QDNS=0,www.baidu.com 响应 OK +QDNS: 举例（以域名 www.baidu.com 为例） OK +QDNS:39.156.66.14 BC35-GR/BC95-B5R/BC95-B8R 设置命令 AT+QIDNSGIP=, 举例（以域名 www.baidu.com 为例） AT+QIDNSGIP=1,'www.baidu.com' 响应 OK +QIURC: 'dnsgip',,, [+QIURC: 'dnsgip',] […] 举例（以域名 www.baidu.com 为例） OK +QIURC: 'dnsgip',0,1,0 上海移远通信技术股份有限公司 27 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 +QIURC: 'dnsgip','39.156.66.14' 差异： 模块使用的命令、参数以及命令的响应均存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+QDNS 的设置命令解析域名。可使用参数 =1 清除内存中的域名解析 数据。命令成功后，仅响应 OK 和域名解析结果 。 ⚫ BC35-GR/BC95-B5R/BC95-B8R 使用 AT+QIDNSGIP 的设置命令解析域名。需使用 指定上下文 ID。命令 成功后，响应先返回 OK、命令结果码 、域名对应的 IP 地址个数 、 DNS 的 TTL 值 ，再返回域名解析结果 。 4.2. URC 差异 表 32：TCP/UDP 相关 URC 差异 URC 收到消息 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R/BC95-B8R ⚫ AT+NSONMI=0 时： ⚫ AT+QISWTMD=,0 时： 收到消息时，无 URC +QIURC: 'recv',[,] ⚫ AT+NSONMI=1 时： +NSONMI:, ⚫ AT+QISWTMD=,1 时： ⚫ AT+NSONMI=2 时： +QIURC: 'recv',[, +NSONMI:,, ,, ⚫ AT+NSONMI=3 时： +NSONMI:,, Socket 关闭 +NSOCLI: +QIURC: 'closed', 上海移远通信技术股份有限公司 28 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 5 中国电信物联网平台 BC35-G、BC95 R2.0 系列和 BC35-GR、BC95-B5R 对接中国电信物联网平台，使用的 AT 命令功能 上基本相同，切换比较简单，但需要注意的是，两个平台功能相同的 AT 命令，返回的参数和代表的含义可 能 存 在 差 异 ， 详 情 请 参 考 《 Quectel_BC35-GR&BC95-B5R_ 中 国 电 信 物 联 网 平 台 应 用 指 导 》 和 《Quectel_BC35-G&BC28&BC95 R2.0 系列_AT 命令手册》。 5.1. 中国电信物联网平台相关 AT 命令差异 5.1.1. 配置 Lifetime 表 33：UDP 发送消息命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+QCFG='LWM2M/Lifetime'[,] BC35-GR/BC95-B5R 设置命令 AT+NCFG=0[,] 举例（以配置 Lifetime 为 86400 秒为例） AT+QCFG='LWM2M/lifetime',86400 响应 OK 举例（以配置 Lifetime 为 86400 秒为例） AT+NCFG=0,86400 响应 OK 差异： 使用的命令和参数默认值存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+QCFG 的设置命令设置 Lifetime。生命周期参数 默认值为 86400 （秒）。 ⚫ BC35-GR/BC95-B5R 使用 AT+NCFG 的设置命令设置 Lifetime。生命周期参数 默认值为 0，此时 表示模块注册到服务器时的注册数据包中不含 Lifetime 配置，模块端也不会自动发送更 新包到服务器。 上海移远通信技术股份有限公司 29 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 5.1.2. 配置 IP 和端口 表 34：配置 IP 和端口命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+NCDP=[,] BC35-GR/BC95-B5R 举例（以服务器 IP 为 180.101.147.115、端口为 5683 为例） 无 AT+NCDP=180.101.147.115,5683 响应 OK 差异： BC35-G 和 BC95 R2.0 系列支持配置 IP 地址和端口，而 BC35-GR、BC95-B5R 不需要提前 进行此配置。 5.1.3. 平台注册（发起连接） 表 35：平台注册（发起连接）命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R 通过 AT+NCDP 命令配置 IP 和端口后，重启模块 设置命令 可自动注册； AT+NCDPOPEN=[,[,]] 通过 AT+NCDP 命令配置 IP 和端口后，通过手动 触发注册操作命令 AT+QLWSREGIND=0 注册 响应 OK 举例（以 IP 为 180.101.147.115、端口 5683 为例） AT+NCDPOPEN='180.101.147.115',5683 响应 OK +QLWEVTIND: 0 +QLWEVTIND: 3 差异： 发起网络注册的形式存在差异。 ⚫ BC35-G/BC95 R2.0 系列 IP 地址和端口配置完成后，重启模块可自动注册，也可通过 AT+QLWSREGIND=0 手动 发起注册。 ⚫ BC35-GR/BC95-B5R 使用 AT+NCDPOPEN 的设置命令发起注册，命令中需指定 IP 地址 和端口 。 上海移远通信技术股份有限公司 30 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 5.1.4. 发送数据 表 36：发送消息命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+NMGS=,[,] BC35-GR/BC95-B5R 设置命令 T+NMGS=,[,] 举例（以发送 2 字节数据 3132 为例） AT+NMGS=2,3132 响应 OK 举例（以发送 2 字节数据 3132 为例） AT+NMGS=2,3132 响应 OK 差异： 使用的命令和响应相同，数据长度和可选参数存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+NMGS 的设置命令发送数据。数据最大长度为 1024 字节。可选携带数据序列 号参数 。 ⚫ BC35-GR/BC95-B5R 使用 AT+NMGS 的设置命令发送数据。数据最大长度为 512 字节。可选携带发送数据类 型参数 。 5.1.5. 发送携带 RAI 的数据 表 37：发送携带 RAI 数据命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R 设置命令 设置命令 AT+QLWULDATAEX=,, AT+NMGS=,[,] [,] 举例（以发送 2 字节的 CON 数据 3132，且携带 RAI 为 0 的情况为例） AT+QLWULDATAEX=2,3132,0x0100 响应 OK 举例（以发送 2 字节的 CON 数据 3132，且携带 RAI 为 0 的情况为例） AT+NMGS=2,3132,100 响应 OK 差异： 使用的命令存在差异。 ⚫ BC35-G/BC95 R2.0 系列 使用 AT+QLWULDATAEX 的设置命令发送消息。不支持 RAI 为 1 的 CON 数据。 上海移远通信技术股份有限公司 31 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 ⚫ BC35-GR/BC95-B5R 使用 AT+NMGS 的设置命令发送消息。支持 RAI 为 1 的 CON 数据。 备注 RAI 为 1 时，指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放。 5.1.6. 查询 CON 数据发送状态 表 38：查询 CON 数据发送状态命令差异 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B5R 查询命令 AT+QLWULDATASTATUS? 响应 +QLWULDATASTATUS:[,] OK 暂不支持 举例（以发送成功为例） +QLWULDATASTATUS:4 OK 差异： BC35-G 和 BC95 R2.0 系列可使用 AT+QLWULDATASTATUS? 查询 CON 数据发送状态； 而 BC35-GR 和 BC95-B5R 暂不支持查询 CON 数据发送状态。 5.1.7. 读取数据 表 39：读取数据命令差异 BC35-G/BC95 R2.0 系列 执行命令 AT+NMGR 响应 , OK 举例（以读取长度为 2 的数据 3132 为例） 2,3132 BC35-GR/BC95-B5R 执行命令 AT+NMGR 响应 +NMGR: , OK 举例（以读取长度为 2 的数据 3132 为例） +NMGR: 2,3132 上海移远通信技术股份有限公司 32 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 OK OK 差异： 模块使用的命令完全相同，仅响应的格式有所不同。 ⚫ BC35-G/BC95 R2.0 系列 响应直接返回数据长度 和数据 。 ⚫ BC35-GR/BC95-B5R 响应返回的数据长度 和数据 前带有 +NMGR: 。 5.1.8. 配置数据接收模式 表 40：配置数据接收模式命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+NNMI= 响应 OK BC35-GR/BC95-B5R 设置命令 AT+NNMI= 响应 OK 差异： BC35-G 和 BC95 R2.0 系列和 BC35-GR、BC95-B5R 模块配置数据接收模式命令功能一致。 5.1.9. 注销连接 表 41：注销连接命令差异 BC35-G/BC95 R2.0 系列 设置命令 AT+QLWSREGIND=1 响应 OK BC35-GR/BC95-B5R 执行命令 AT+NCDPCLOSE 响应 OK 差异： 模块使用的命令存在差异 ⚫ BC35-G/BC95 R2.0 系列 使用设置命令 AT+QLWSREGIND=1 注销连接。 ⚫ BC35-GR/BC95-B5R 使用执行命令 AT+NCDPCLOSE 注销连接。 上海移远通信技术股份有限公司 33 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 5.1.10. 查询注册状态 表 42：查询注册状态命令差异 BC35-G/BC95 R2.0 系列 查询命令 AT+NMSTATUS? 响应 +NMSTATUS: BC35-GR/BC95-B5R 查询命令 AT+NMSTATUS? 响应 +NMSTATUS: OK 举例（以查询结果为已注册状态为例） +NMSTATUS:REGISTERED OK 举例（以查询结果为已注册状态为例） +NMSTATUS: REGISTERED OK OK 差异： 使用的命令和主要功能完全相同，仅文档中参数命名定义，以及查询到的状态位存在差异。 具体注册状态位差异请查阅对应模块的 AT 命令手册。 5.1.11. 查询消息状态 表 43：查询消息状态命令差异 消息种类查询 已接收消息状态查询 已发送消息状态查询 BC35-G/BC95 R2.0 系列 执行命令 AT+NQMGR 执行命令 AT+NQMGS BC35-GR/BC95-B5R 暂不支持 暂不支持 差异： BC35-G 和 BC95 R2.0 系列分别使用 AT+NQMGR 和 AT+NQMGS 命令查询已接收和已发送 消息状态；BC35-GR 和 BC95-B5R 暂不支持 上海移远通信技术股份有限公司 34 / 37 5.2. URC 差异 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 表 44：TCP/UDP 相关 URC 差异 URC BC35-G/BC95 R2.0 系列 ⚫ AT+NNMI=0 时： 收到消息时，无 URC 接收到消息 ⚫ AT+NNMI=1 时： +NNMI:, 执行结果码 ⚫ AT+NNMI=2 时： +NNMI +QLWEVTIND: BC35-GR/BC95-B5R ⚫ AT+NNMI=0 时： 收到消息时，无 URC ⚫ AT+NNMI=1 时： +NNMI: , ⚫ AT+NNMI=2 时： +NNMI +QLWEVTIND: 差异： URC 格式和参数命名相同，但 参数所指代的事件类型有所差异，详细信息请查阅对 应模块的 AT 命令手册。 上海移远通信技术股份有限公司 35 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 6 OneNET 平台 BC35-G、BC95 R2.0 系列和 BC35-GR、BC95-B8R 对接 OneNET 平台，AT 命令和对接流程基本相 同，需要注意的是，BC35-GR、BC95-B8R 不支持 buffer（缓存）模式。 表 45：OneNET 平台相关 AT 命令差异 AT 命令 BC35-G/BC95 R2.0 系列 BC35-GR/BC95-B8R 鉴权连接开关 AT+MIPLCONFIG=4, - DTLS 模式连接开关 AT+MIPLCONFIG=5, - , 设 置 接 收 写 数 据 得 输 出 AT+MIPLCONFIG=6, 格式 - 设 置 接 收 数 据 得 缓 存 配 AT+MIPLCONFIG=, - 差异： BC35-G 和 BC95 R2.0 系列的鉴权连接开关、DTLS 模式连接开关、设置接收写数据的输出 格式，以及设置接收数据的缓存配置，均为可配置状态；BC35-GR 和 BC95-B8R 模块均已默 认配置，不可使用命令进行设置。 上海移远通信技术股份有限公司 36 / 37 BC35-GR&BC95-BxR&BC35-G&BC95 R2.0 系列软件差异说明 7 附录 A 参考文档及术语缩写 表 46：参考文档 序号 文档名称 [1] Quectel_BC35-GR&BC95-B5R&BC95-B8R_ AT 命令手册 [2] Quectel_BC35-G&BC28&BC95 R2.0 系列_AT 命令手册 备注 移远通信 BC35-GR、BC95-B5R 和 BC95-B8R 模块的 AT 命令手册 移 远 通 信 BC35-G 、 BC28 和 BC95R2.0 系列模块的 AT 命令手册 表 47：术语缩写 缩写 APN EARFCN eDRX ID IMEI IPv4 IPv6 NB-IoT PDN PDP PSM RTC URC 英文全称 中文全称 Access Point Name 接入点名称 E-UTRA Absolute Radio Frequency Channel Number 中心频点 Extended Discontinuous Reception 扩展不连续接收 Identifier 标识符 International Mobile Equipment Identity 国际移动设备识别码 Internet Protocol version 4 网际协议版本 4 Internet Protocol version 6 网际协议版本 6 Narrow Band Internet of Thing 窄带物联网（技术） Public Data Network 共用数据网络 Packet Data Protocol 分组数据协议 Power Saving Mode 省电模式 Real Time Clock 实时时钟 Unsolicited Result Code 非请求结果码 上海移远通信技术股份有限公司 37 / 37

BC35-G&BC28&BC95 R2.0&BC39 系列 运营商自注册使用说明 NB-IoT 模块系列 版本：BC35-G&BC28&BC95 R2.0&BC39 系列_运营商自注册使用说明_V1.0 日期：2020-03-28 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 文档历史 修订记录 版本 1.0 日期 2020-03-28 作者 变更表述 刘强/唐正 初始版本 上海移远通信技术股份有限公司 2 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 图片索引 ....................................................................................................................................................... 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 目前模块版本配置 ...................................................................................................................... 6 2 运营商自注册机制 ................................................................................................................................. 7 2.1. 电信自注册 ................................................................................................................................. 7 2.1.1. 自注册启动 ...................................................................................................................... 8 2.1.2. 自注册成功 ...................................................................................................................... 8 2.1.3. 自注册失败 ...................................................................................................................... 8 2.1.4. 自注册影响 ...................................................................................................................... 8 2.2. 联通自注册 ................................................................................................................................. 9 2.2.1. 自注册启动 ...................................................................................................................... 9 2.2.2. 自注册成功 .................................................................................................................... 10 2.2.3. 自注册失败 .................................................................................................................... 10 2.2.4. 自注册影响 .................................................................................................................... 10 2.3. 移动 DM 注册 ............................................................................................................................11 2.3.1. DM 注册启动 ................................................................................................................. 12 2.3.2. DM 注册成功 ................................................................................................................. 12 2.3.3. DM 注册失败 ................................................................................................................. 12 2.3.4. DM 注册影响 ................................................................................................................. 12 3 运营商自注册 AT 命令......................................................................................................................... 13 3.1. AT+QSREGENABLE 配置电信/联通自注册 .......................................................................... 13 3.2. DM 平台接入相关配置.............................................................................................................. 14 3.2.1. DM V1.0 配置命令 ......................................................................................................... 14 3.2.2. DM V2.0 配置命令 ......................................................................................................... 14 4 附录 A 参考文档及术语缩写............................................................................................................... 15 上海移远通信技术股份有限公司 3 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 图片索引 图 1：电信自注册流程 .................................................................................................................................. 7 图 2：联通自注册流程 .................................................................................................................................. 9 图 3：移动 DM 流程 ....................................................................................................................................11 上海移远通信技术股份有限公司 4 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 表格索引 表 1：参考文档 ........................................................................................................................................... 15 表 2：术语缩写 ........................................................................................................................................... 15 上海移远通信技术股份有限公司 5 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 1 引言 遵照运营商的入库测试需求，BC35-G、BC28、BC95 R2.0 系列和 BC39 系列模块模块集成了国内三 大运营商（中国电信、中国联通和中国移动）的自注册功能。本文档主要介绍中国移动、中国电信和中国 联通的自注册机制、影响和开关方法，以及与自注册相关 AT 命令的使用方法，帮助用户进一步了解和使用 运营商自注册功能。 1.1. 目前模块版本配置 目前基于 R01 软件版本 1)（对应 B300SPx 及之前基线版本）的 BC35-G、BC28 和 BC95 R2.0 模块均 默认开启运营商自注册功能；基于 R02 软件版本 1)（对应 B500SPx 基线版本）的 BC35-G、BC28、BC95 R2.0 模块和 BC39 模块均默认关闭运营商自注册功能。 对于中国移动运营商自注册（即 DM）功能，支持接入 DM 平台的模块，根据固件版本不同分别支持 DM V1.0 或 DM V2.0 的 DM 功能。DM V1.0 和 DM V2.0 分别满足中国移动终端公司发布的《多形态终端 上报接口规范》V1.0.8 和 V2.0.3 的要求。具体说明请参考《Quectel_BC35-G&BC28&BC95 R2.0&BC39_ 中国移动 DM 功能应用指导》。 备注 1. 1) 指软件版本号中含有'R01'或'R02'的版本，例如'BC35GJBR02A02'。 2. 具体软件版本的运营商自注册功能由于历史迭代的原因，在实现细节上可能存在部分差异。 3. 具体软件版本所支持的运营商自注册功能，请参考对应版本的《软件版本变更说明》或咨询移远通信 技术支持。 上海移远通信技术股份有限公司 6 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 2 运营商自注册机制 2.1. 电信自注册 模块的电信自注册流程如下图所示。 设备 开机入 网 是否 满足自 注册 启动条 件 是 下次 开机重 新注册 域名 解析 是否 成功 是 是 重试 是否 超过2次 否 发送 注册数 据包 否 间隔1小时 是 第2次重 传 是否 成功 间隔30秒 否 是 第1次重 传 是否 成功 否 间隔30秒 自注 册 是否 成功 是 流程 结束 图 1：电信自注册流程 否 使用 内置IP 否 上海移远通信技术股份有限公司 7 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 2.1.1. 自注册启动 模块开机入网，识别到电信卡后，检测到模块版本号变更或机卡匹配关系变化时，模块将启动自注册 流程，向运营商自注册服务器发送注册数据包。自注册启动后，进行服务器域名解析，若解析失败，将使 用内置 IP 发送注册数据包。 2.1.2. 自注册成功 若自注册成功，则流程结束，无需周期性地发送自注册数据。 2.1.3. 自注册失败 ⚫ 若自注册失败，将重传 2 次，每次发送间隔 30 秒，即本次注册最多发送 3 次注册数据包； ⚫ 若发送 3 次注册数据包后均注册失败，则会重试 2 次，每次间隔 1 小时（其中每次重试最多会重 传 3 次注册数据包，每次发送间隔 30 秒）； ⚫ 若 2 次重试后仍注册失败，则等待下次开机再触发自注册。 2.1.4. 自注册影响 ⚫ 若模块使用 PSM 功能，自注册失败可能会导致模块退出 PSM 状态； ⚫ 自注册服务器地址采用域名模式，若域名解析失败，也可能导致模块退出 PSM 状态。 上海移远通信技术股份有限公司 8 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 2.2. 联通自注册 模块的联通自注册流程如下图所示。 设备 开机入 网 下次 开机或 1个月 之后 重新注 册 是 是否 满足自 注册 启动条 件 重试 是否 超过2次 否 是 否间隔1小时 是 第2次重 传 是否 成功 发送 注册数 据包 否 否 间隔30秒 是 第1次重 传 是否 成功 否 间隔30秒 自注 册 是否 成功 是 每隔 约1个月 更新 注册 图 2：联通自注册流程 2.2.1. 自注册启动 模块开机入网，识别到联通卡后，检测到模块版本号变更或机卡匹配关系变化时，模块将启动自注册 流程，向运营商自注册服务器发送注册数据包。 上海移远通信技术股份有限公司 9 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 2.2.2. 自注册成功 若自注册成功，则需每隔约一个月（27~30 天之间的某个随机时间点）周期性地重发更新注册请求。 2.2.3. 自注册失败 ⚫ 若自注册失败，会重传 2 次，每次发送间隔 30 秒，即本次注册最多发送 3 次注册数据包； ⚫ 若发送 3 次注册数据包后均注册失败，将重试 2 次，每次间隔 1 小时（其中每次重试最多会发送 3 次注册数据包，每次发送间隔 30 秒）； ⚫ 若重试 2 次后仍注册失败，则间隔约一个月（27~30 天之间的某个随机时间点）或下次开机再触 发自注册。 2.2.4. 自注册影响 若模块使用 PSM 功能，自注册失败可能会导致模块退出 PSM 状态。 上海移远通信技术股份有限公司 10 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 2.3. 移动 DM 注册 模块的移动 DM 注册流程如下图所示。 设备 开机入 网 域名 解析 是否 成功 否 重试 是 使用 内置IP 否 间隔24小时 发送 D M注册 数据 是 第4次重 传 是否 成功 否间隔16秒 是 第3次重 传 是否 成功 否 间隔8秒 是 第2次重 传 是否 成功 否 间隔4秒 是 第1次重 传 是否 成功 否 D M是否 成功 间隔2秒 是 每隔24小时 更新 注册 图 3：移动 DM 流程 上海移远通信技术股份有限公司 11 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 2.3.1. DM 注册启动 模块每次开机入网后都会向 DM 平台发送注册数据包。 2.3.2. DM 注册成功 若 DM 自注册成功，则默认周期性地每 24 小时发送一次更新注册请求（心跳）。 2.3.3. DM 注册失败 ⚫ 若 DM 注册或更新注册失败，则重传 4 次，即最多发送 5 次注册或更新注册数据包，发送间隔依 次默认为 2 秒、4 秒、8 秒和 16 秒，总超时时间 62 秒；总超时时间依据公式 ACK_TIMEOUT ×(2(4+1) – 1) 计 算 得 出 （ 其 中 最 小 间 隔 时 间 ACK_TIMEOUT 默 认 为 2 秒 ， 与 OneNET 功 能 的 AT+MIPLCONFIG 命令中的 参数是保持一致的）。 ⚫ 若重传 4 次注册或更新注册均失败，则 24 小时之后或再次开机会重新注册。 2.3.4. DM 注册影响 ⚫ 若模块使用 PSM 功能，注册或更新注册失败可能会导致模块退出 PSM 状态； ⚫ DM 平台地址采用域名模式，若域名解析失败，可能导致模块退出 PSM 状态。 上海移远通信技术股份有限公司 12 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 3 运营商自注册 AT 命令 本章介绍如何使用 AT 命令配置运营商自注册功能。模块支持禁用或启用运营商自注册功能。关于针对 具体项目是否需要启用运营商自注册功能，请与相应的运营商确认。 3.1. AT+QSREGENABLE 配置电信/联通自注册 该命令用于配置运营商自注册功能。适用于中国电信和中国联通。配置 参数后，需要手动重 启。 AT+QSREGENABLE 配置电信/联通自注册 查询命令 AT+QSREGENABLE? 响应 +QSREGENABLE: 设置命令 AT+QSREGENABLE= OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 参数 整型。启用或禁用运营商自注册功能。 0 禁用中国电信或中国联通自注册功能 1 启用中国电信或中国联通自注册功能 错误码。关于 错误码的详细信息，请查阅《Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册》。 举例 AT+QSREGENABLE? +QSREGENABLE:0 //查询自注册状态 //自注册已禁用 上海移远通信技术股份有限公司 13 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 OK AT+QSREGENABLE=1 OK //启用自注册 备注 该命令参数配置自动保存，重启后生效。 3.2. DM 平台接入相关配置 DM 平台接入相关配置通过本章节所述命令实现。 备注 DM 平台接入配置命令的详细指导，请查阅《Quectel_BC35-G&BC28&BC95 R2.0&BC39_中国移动 DM 平台接入指导》。 3.2.1. DM V1.0 配置命令 ⚫ AT+DMPCONFIG 该命令为 DM 1.0 平台接入配置命令，用于配置和查询 DM 平台接入的相关参数，例如 DM 平台的 IP 地址和端口，心跳周期，APPKEY 和密钥、终端类型以及终端 IMEI 等。模块默认接入 DM 商用平台 （coap://m.fxltsbl.com:5683）。若开启 DM 功能，则入网之后会对 DM 商用平台域名进行解析，如果 无法通过域名解析获取 DM 商用平台的 IP 地址，将使用默认的 DM 平台 IP 地址 117.161.2.41:5683。 3.2.2. DM V2.0 配置命令 ⚫ AT+QDMPCFG: 该命令用于配置和查询 DM 平台接入的相关参数，如 DM 平台 IP 地址和端口，心跳周期，APPKEY 和 密钥、终端类型以及终端 IMEI 等。模块默认接入 DM 商用平台（coap://m.fxltsbl.com:5683）。若开启 了 DM 功能，入网之后则会对 DM 商用平台域名（m.fxltsbl.com）进行解析，如果无法通过域名解析 获取 DM 商用平台的 IP 地址，将使用默认 DM 平台 IP 地址 117.161.2.41:5683。 ⚫ AT+QDMPCFGEX: 该命令为 DM 平台接入配置扩展命令，用于配置和查询终端设备信息资源配置，如应用信息、MAC 地 址、ROM、RAM 和 CPU 等。 上海移远通信技术股份有限公司 14 / 15 BC35-G&BC28&BC95 R2.0&BC39 系列运营商自注册使用说明 4 附录 A 参考文档及术语缩写 表 1：参考文档 序号 文档名称 [1] Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册 Quectel_BC35-G&BC28&BC95 R2.0&BC39_中国移 [2] 动 DM 平台接入指导 备注 BC35-G、BC28、BC95 R2.0 模块的 AT 命令手册 BC35-G、BC28、BC95 R2.0 和 BC39 模块的 DM 平台接入指导说明 表 2：术语缩写 缩写 APP CPU DM IMEI IP MAC NB-IoT PSM RAM ROM 英文全称 中文全称 Application 应用程序 Central Processing Unit 中央处理器 Device Management 设备管理 International Mobile Equipment Identity 国际移动设备识别码 Internet Protocol 网络协议 Media Access Control 媒体访问控制 Narrow Band Internet of Things 窄带物联网 Power Saving Mode 低功耗模式 Random Access Memory 随机存取存储器 Read-Only Memory 只读存储器 上海移远通信技术股份有限公司 15 / 15

L26-DR (ADR) DR Application Note GNSS Module Series Version: 1.1 Date: 2023-07-28 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. L26-DR(ADR)_DR_Application_Note 1 / 48 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. L26-DR(ADR)_DR_Application_Note 2 / 48 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status L26-DR (ADR) DR Application Note GNSS Module Series Application Note Released Revision History Version 1.0 1.1 Date 2019-07-26 2019-07-26 2023-07-28 Description Creation of the document First official release 1. Numerous changes were made to this document. It should be read in its entirety. 2. Updated the applicable module from L26-DR to L26-DR (ADR). L26-DR(ADR)_DR_Application_Note 3 / 48 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Figure Index ................................................................................................................................................ 6 1 Introduction ......................................................................................................................................... 7 1.1. Overview on Automotive DR ...................................................................................................... 7 2 Configuration....................................................................................................................................... 8 2.1. Frame Conventions.................................................................................................................... 8 2.1.1. Vehicle Reference Frame ............................................................................................... 8 2.1.2. Navigation Reference Frame .......................................................................................... 8 2.1.3. Sensor Reference Frame...............................................................................................11 2.2. Mounting................................................................................................................................... 12 2.3. DR Calibration.......................................................................................................................... 12 2.3.1. Conditions ..................................................................................................................... 13 2.3.2. Guidelines ..................................................................................................................... 13 2.3.3. Calibration Result Monitoring........................................................................................ 14 2.3.4. Calibration Parameter Storage...................................................................................... 14 3 DR Operating Modes (Speed & Reverse Data Acquisition) ......................................................... 15 3.1. CAN Bus Mode (Default) ......................................................................................................... 15 3.2. Wheel Tick Mode...................................................................................................................... 16 3.3. UART Mode.............................................................................................................................. 17 3.3.1. UART Odometer Mode ................................................................................................. 17 3.3.2. UART Speed Mode ....................................................................................................... 18 4 PSTM Messages ................................................................................................................................ 19 4.1. PSTMDRCONFID .................................................................................................................... 19 4.2. PSTMDRBSD........................................................................................................................... 21 4.3. PSTMDRGPS .......................................................................................................................... 22 4.4. PSTMDRPVA ........................................................................................................................... 23 4.5. PSTMDRPVASD ...................................................................................................................... 25 4.6. PSTMDRSINT .......................................................................................................................... 26 4.7. PSTMDRSVF ........................................................................................................................... 28 4.8. PSTMDRUPD .......................................................................................................................... 29 4.9. PSTMDRSTYPE ...................................................................................................................... 29 4.10. PSTMDRCAL ........................................................................................................................... 30 4.11. PSTMDR1 ................................................................................................................................ 32 4.12. PSTMDR2 ................................................................................................................................ 33 4.13. PSTMDREPE ........................................................................................................................... 35 4.14. PSTMDRDEBUG ..................................................................................................................... 36 4.15. PSTMDRSENCONFIG ............................................................................................................ 37 4.16. PSTMIMUSELFTESTCMD ...................................................................................................... 38 L26-DR(ADR)_DR_Application_Note 4 / 48 GNSS Module Series 4.17. PSTMDRSENMSG .................................................................................................................. 39 4.17.1. Odometer Message (MsgID = 1) .................................................................................. 40 4.17.2. Reverse Message (MsgID = 2) ..................................................................................... 41 4.17.3. Odometer and Reverse Message (MsgID = 3)............................................................. 41 4.17.4. Vehicle Speed Message (MsgID = 14) ......................................................................... 42 4.17.5. IMU Temperature Message (MsgID = 24)..................................................................... 43 4.17.6. IMU Accelerometer Message (MsgID = 30).................................................................. 43 4.17.7. IMU Gyroscope Message (MsgID = 31) ....................................................................... 44 5 Appendix A References.................................................................................................................... 46 6 Appendix B Special Characters ...................................................................................................... 48 L26-DR(ADR)_DR_Application_Note 5 / 48 GNSS Module Series Figure Index Figure 1: Vehicle Reference Frame ............................................................................................................. 8 Figure 2: Navigation Reference Frame........................................................................................................ 9 Figure 3: Yaw Angle ..................................................................................................................................... 9 Figure 4: Pitch Angle .................................................................................................................................. 10 Figure 5: Roll Angle .................................................................................................................................... 10 Figure 6: IMU Sensor Frame of L26-DR (ADR)..........................................................................................11 L26-DR(ADR)_DR_Application_Note 6 / 48 GNSS Module Series 1 Introduction This document describes the Dead Reckoning (DR) feature, including frame conventions, mounting, calibration, operating modes and messages related to the Dead Reckoning functionality of L26-DR (ADR) module. 1.1. Overview on Automotive DR The L26-DR (ADR) module supports Dead Reckoning (DR) function, which is a technology that combines inertial sensors with GNSS to seamlessly fuse satellite measurements, angular rate and acceleration data. It is designed to improve the accuracy, availability and integrity of positioning data for automotive users in environments where GNSS signals are absent or corrupted. L26-DR (ADR) supports two DR modes: ADR (Automotive Dead Reckoning) and UDR (Untethered Dead Reckoning). In ADR mode, the module relies on speed data from the vehicle and the onboard 6-axis sensor for enhanced accuracy in environments with poor or nonexistent GNSS coverage. On the other hand, UDR mode does not require speed data and is automatically activated by the firmware if no speed data is injected. The module’s DR function is supported by a MEMS Inertial Measurement Unit (IMU) sensor, which is a 6-axis inertial sensor (consisting of a 3-axis gyroscope and 3-axis accelerometer). In addition, the DR function may require information about vehicle speed, which is provided by WHEELTICK, UART or CAN bus. See Chapter 3 DR Operating Modes (Speed & Reverse Data Acquisition) for details. NOTE In case of temporary unavailability of speed signal, the system exploits the presence of accelerometer to seamlessly switch to UDR mode. This capability is called fallback mode and is triggered after the speed signal has been absent for 3 seconds. Once the speed signal becomes available again, the system automatically switches back to ADR mode. L26-DR(ADR)_DR_Application_Note 7 / 48 GNSS Module Series 2 Configuration 2.1. Frame Conventions 2.1.1. Vehicle Reference Frame ADR and UDR internal processing assume that the IMU axes are aligned in a specific manner to the so-called vehicle reference frame. The vehicle reference frame is defined as follows: ⚫ X axis: aligned with vehicle travel direction, pointing forward. ⚫ Y axis: perpendicular to vehicle travel direction, pointing to the left. ⚫ Z axis: perpendicular to vehicle travel direction, pointing upwards (vertical). Z X Y Figure 1: Vehicle Reference Frame 2.1.2. Navigation Reference Frame The navigation reference frame is aligned with the geodetic reference frame and is defined as follows: ⚫ Xn axis: aligned with vehicle travel direction excluding pitch, pointing forward. ⚫ Yn axis: perpendicular to vehicle travel direction excluding roll, pointing to the left. ⚫ Zn axis: perpendicular to the horizontal plane, pointing upwards. L26-DR(ADR)_DR_Application_Note 8 / 48 GNSS Module Series Zn Xn Yn Figure 2: Navigation Reference Frame The module reports the vehicle’s position, velocity and attitude. The attitude is defined by 3 angles. ⚫ Yaw, representing the mismatch between vehicle frame X axis and navigation frame Xn axis (vehicle travel direction). ⚫ Pitch, representing the mismatch between vehicle frame Z axis and navigation frame Zn axis (vertical direction). ⚫ Roll, representing the mismatch between vehicle frame Y axis and navigation frame Yn axis (vertical direction). Positive Rotation Forward X Xn α Yn Y Figure 3: Yaw Angle L26-DR(ADR)_DR_Application_Note 9 / 48 Positive Rotation Z Zn β Xn X GNSS Module Series β Figure 4: Pitch Angle Zn Z Yn γ Positive Rotation Y γ Figure 5: Roll Angle L26-DR(ADR)_DR_Application_Note 10 / 48 GNSS Module Series 2.1.3. Sensor Reference Frame MEMS IMU outputs its raw data (angular rates and accelerations) in the sensor reference frame. L26-DR (ADR) is equipped with a 6-axis sensor, which contains a 3-axis accelerometer and a 3-axis gyroscope, and the axes for both sensors have the same direction in the sensor reference frame. The IMU sensor frame is illustrated below: Z Yaw Pitch X Y Roll Figure 6: IMU Sensor Frame of L26-DR (ADR) NOTE The IMU sensor frame of L26-DR (ADR) shown in the figure above is applicable to both the gyroscope and the accelerometer within the IMU. L26-DR(ADR)_DR_Application_Note 11 / 48 GNSS Module Series 2.2. Mounting L26-DR (ADR) module integrates an IMU and a GNSS receiver and is designed for four-wheel vehicles. Therefore, you must ensure that the device incorporating the module is firmly fixed to vehicle body. No relative movement is allowed between the vehicle and device, and maximum isolation from shock or vibration must be applied. Manually holding the device is not acceptable. The best way to guarantee good installation is to firmly screw the device to the vehicle frame. Mounting location should allow for easy access to the power supply and GNSS antenna, and should not be exposed to excessive heat. DR firmware offers Full Free Mount (FFM) capability, i.e., it automatically estimates the device’s installation and seamlessly compensates for any misalignments. For this reason, there is no specific requirement for the device’s orientation in relation to the vehicle travel direction. However, a sequence of manoeuvres is required to allow the module to calibrate successfully. This sequence is described in Chapter 2.3 DR Calibration. 2.3. DR Calibration This section describes the conditions (driving maneuvers and GNSS reception) needed at the beginning of a test session to calibrate ADR or UDR for the purpose of evaluation. The procedure is required to compensate misalignment (installation pitch, roll and yaw) and MEMS errors (IMU biases and sensitivity). The target is to lead the device in the so-called 'system-ready' status, where the PVT output is given by the fusion of GNSS and sensor measurements. Until this condition is reached the system operates in GNSS-only mode. When the system-ready status is reached, calibration parameters are stored in Non-Volatile Memory. This means that at the next startup the device will start in system-ready mode (the calibration procedure will not be requested anymore). NOTE This procedure is required each time the system starts in not-ready condition, i.e. in the following cases: ⚫ First test after device installation in vehicle. ⚫ Firmware upgrade. ⚫ Device removed from vehicle since the previous test. ⚫ Any modifications have been made to the installation/orientation of the device. L26-DR(ADR)_DR_Application_Note 12 / 48 GNSS Module Series 2.3.1. Conditions The calibration phase length mostly depends on GNSS signal quality and the dynamics encountered by the vehicle, i.e. dynamic driving actions including acceleration, deceleration, braking and fast turns. Therefore, to reduce the calibration phase length, it is recommended to perform it in a location where there are no restrictions on vehicle maneuvering. All calibration maneuvers must happen in benign GNSS signal conditions. The vehicle should be driven to an open and flat area such as an empty parking lot or road with an unobstructed view of the sky, i.e., avoiding areas with urban structures, forests, tunnels, or any other objects that may obstruct or reflect the GNSS signal. It is important to note that calibration success does not depend on its duration, but rather on how well the driving style and sky conditions match the recommended guidelines. 2.3.2. Guidelines The calibration drive should involve different phases, including stationary periods where the car is stopped with engine turned on, normal left and right turns while driving, and periods of driving above 30 km/h under good GNSS reception conditions. Accelerations/braking during driving are beneficial to the process. The following sequence is an example of good calibration procedure: Step 1: Start with a short stationary section (at least 30 seconds). Step 2: Drive for 10 minutes at sufficient speed (> 30 km/h), including acceleration and braking maneuvers. Step 3: Perform several 'fast' turns (circles, U-turns and corners) at sufficient speed (> 30 km/h). NOTE 1. The calibration process typically takes about 15 minutes if the driving conditions reported above are met. The calibration process may take longer if the guidelines are not followed, e.g., if the vehicle moves slowly due to traffic. 2. Fast turns such as corners, roundabouts, circles and U-turns, where the road direction changes by 90 degrees or more in a few seconds, are recommended for calibration. Large turns like those on highways or lane changes are not useful. The same turn can be repeated several times to achieve the desired effect. L26-DR(ADR)_DR_Application_Note 13 / 48 GNSS Module Series 2.3.3. Calibration Result Monitoring NMEA output contains data that enables understanding if the calibration phase is over and the system is ready for operation. $PSTMDRCAL and $PSTMDR2 proprietary NMEA messages provide useful information about calibration status. In ADR mode, the module outputs $PSTMDRCAL,1,1,1,1,ff,1,1,F*04 and field of $PSTMDR2 should read 1 to indicate that the system is fully calibrated and operational. In UDR mode, field of $PSTMDR2 should read 1 to indicate that the system is fully operational. For more details, please refer to Chapter 4.10 PSTMDRCAL and Chapter 4.12 PSTMDR2. 2.3.4. Calibration Parameter Storage It is important to save the position, heading alignment and calibration to NVM at the end of each positioning session to guarantee immediate and accurate start up in the following session. To save the information to NVM, the vehicle must remain stationary for at least 5 seconds. It is recommended to wait this time before turning the unit off. At the next start up, if board installation has not been modified, device will start from the saved position and heading, guaranteeing PVT output even before GNSS acquisition. In case of modified installation, calibration procedure will need to be repeated. L26-DR(ADR)_DR_Application_Note 14 / 48 GNSS Module Series 3 DR Operating Modes (Speed & Reverse Data Acquisition) The DR system can acquire speed information in three different modes: ⚫ CAN Bus Mode (default). ⚫ Wheel Tick Mode (through the WHEELTICK pin). ⚫ UART Mode (including UART Odometer Mode and UART Speed Mode). NOTE $PSTMSETPAR can be used to enable CAN Bus Mode, Wheel Tick Mode, or UART Mode and the output of $PSTMDRSENMSG message. For details about $PSTMSETPAR, contact Quectel Technical Support (support@quectel.com). 3.1. CAN Bus Mode (Default) In this mode, the module receives speed data via CAN bus. Users must connect the module to OBD-II interface of the vehicle. The module only supports receiving data that conforms to ISO15765 standard. PSTM commands for switching to CAN Bus Mode: $PSTMSETPAR,1600,8001050E*65 $PSTMSAVEPAR*58 $PSTMSRR*49 PSTM commands for enabling the output of $PSTMDRSENMSG: $PSTMSETPAR,1228,10000000,1*0E $PSTMSAVEPAR*58 $PSTMSRR*49 L26-DR(ADR)_DR_Application_Note 15 / 48 GNSS Module Series Result: If the module receives speed data via CAN bus successfully, it returns: $PSTMDRSENMSG,14,,* If failed, the module will not return the above message(s). For details about this message, refer to Chapter 4.17.4 Vehicle Speed Message (MsgID = 14). NOTE In CAN Bus Mode, reverse signal is not supported. 3.2. Wheel Tick Mode In this mode, the module uses WHEELTICK pin to obtain speed data from wheel tick sensor. The reverse gear signal should be connected to module’s FWD pin to obtain reverse data. For details about WHEELTICK pin and FWD pin, see document [1] hardware design. PSTM commands for switching to Wheel Tick Mode: $PSTMSETPAR,1600,80010106*12 $PSTMSAVEPAR*58 $PSTMSRR*49 PSTM commands for enabling the output of $PSTMDRSENMSG: $PSTMSETPAR,1228,10000000,1*0E $PSTMSAVEPAR*58 $PSTMSRR*49 Result: If it receives odometer count and reverse data in this mode successfully, the module returns: $PSTMDRSENMSG,3,,,* If failed, the module will not return the above message(s). For details about this message, refer to Chapter4.17.3 Odometer and Reverse Message (MsgID = 3). L26-DR(ADR)_DR_Application_Note 16 / 48 GNSS Module Series 3.3. UART Mode 3.3.1. UART Odometer Mode In this mode, the module gets odometer count and reverse data via the UART interface. PSTM commands for switching to UART Odometer Mode: $PSTMSETPAR,1600,80010306*10 $PSTMSAVEPAR*58 $PSTMSRR*49 PSTM commands for enabling the output of $PSTMDRSENMSG: $PSTMSETPAR,1228,10000000,1*0E $PSTMSAVEPAR*58 $PSTMSRR*49 Odometer count or reverse data sent to the module via UART: $PSTMDRSENMSG,1,0,* $PSTMDRSENMSG,2,0,* Result: If the module gets odometer count or reverse data via UART successfully, it returns: $PSTMDRSENMSG,1,,* $PSTMDRSENMSG,2,,* If failed, the module will not return the above messages. For details about these messages, refer to Chapters 4.17.1 Odometer Message (MsgID = 1) and 4.17.2 Reverse Message (MsgID = 2). NOTE 1. In UART Odometer Mode, it is recommended to inject odometer count or reverse data at a frequency of at least 10 Hz. 2. Ensure that the baud rate of the host and module is consistent. L26-DR(ADR)_DR_Application_Note 17 / 48 GNSS Module Series 3.3.2. UART Speed Mode In this mode, the module gets speed data via the UART interface. PSTM commands for switching to UART Speed Mode: $PSTMSETPAR,1600,80010506*16 $PSTMSAVEPAR*58 $PSTMSRR*49 PSTM commands for enabling the output of $PSTMDRSENMSG: $PSTMSETPAR,1228,10000000,1*0E $PSTMSAVEPAR*58 $PSTMSRR*49 Speed data sent to the module via UART: $PSTMDRSENMSG,14,0,* Result: If the module gets speed data via UART successfully, it returns: $PSTMDRSENMSG,14,,* If failed, the module will not return the above message(s). For details about this message, refer to Chapter 4.17.4 Vehicle Speed Message (MsgID = 14). NOTE 1. In UART Speed Mode, it is recommended to inject speed data at a frequency of at least 10 Hz. 2. Ensure that the baud rate of the host and module is consistent. L26-DR(ADR)_DR_Application_Note 18 / 48 GNSS Module Series 4 PSTM Messages This chapter explains PSTM messages (proprietary NMEA messages about DR function defined by the chipset supplier) supported by Quectel L26-DR (ADR) module. Output messages (except $PSTMDRSENMSG) are provided at 1 Hz. NOTE 1. Use $PSTMSETPAR to enable the output of messages mentioned in this chapter. For details about $PSTMSETPAR, contact Quectel Technical Support (support@quectel.com). 2. After issuing the enable/disable command ($PSTMSETPAR), you must save the configuration (using $PSTMSAVEPAR) and reboot the module (using $PSTMSRR) for the command to take effect. 4.1. PSTMDRCONFID Reports the error estimations (standard deviation) for navigation and calibration estimates. The message is only supported in ADR mode. Type: Output Synopsis: $PSTMDRCONFID,,,,,,,,,,,,< EllipseAngle>,* Parameter: Field Format Numeric Numeric Numeric Unit Meter Meter Degree Description Latitude standard deviation Longitude standard deviation Heading standard deviation L26-DR(ADR)_DR_Application_Note 19 / 48 GNSS Module Series Field Format - Numeric Numeric - Numeric Numeric Numeric Numeric Numeric Numeric Unit Millivolt Millimeter/pulse g Meter Meter Meter Degree m/s Description Reserved for future use Gyro bias standard deviation Odometer scale standard deviation Reserved for future use Accelerometer offset standard deviation Height standard deviation Major semi axis of 1 sigma error ellipse Minor semi axis of 1 sigma error ellipse Angle vs North of 1 sigma error ellipse Speed standard deviation Example: $PSTMDRCONFID,100.00,100.00,180.0419,0.1004,0.00,0.0857,0.000993,0.050002,100.3594,100.0,10 0.0,90.0,0.0*0A NOTE Commands to enable or disable the output of $PSTMDRCONFID are shown below. //Enable $PSTMDRCONFID: $PSTMSETPAR,1228,40000000,1*0B $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRCONFID: $PSTMSETPAR,1228,40000000,2*08 $PSTMSAVEPAR*58 $PSTMSRR*49 L26-DR(ADR)_DR_Application_Note 20 / 48 GNSS Module Series 4.2. PSTMDRBSD Reports the standard deviation of estimates for IMU biases. The message is only supported in UDR mode. Type: Output Synopsis: $PSTMDRBSD,,,,,,,,* Parameter: Field Format hhmmss.sss Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit - dps dps dps m/s2 m/s2 m/s2 Description Position fix timestamp (UTC) hh: Hours. Range: 00–23 mm: Minutes. Range: 00–59 ss: Seconds. Range: 00–59 sss: Decimal fraction of seconds Time of DR estimation (CPU ticks) Gyro x bias standard deviation Gyro y bias standard deviation Gyro z bias standard deviation Acc x bias standard deviation Acc y bias standard deviation Acc z bias standard deviation Example: $PSTMDRBSD,073922.000,1837870321,0.058,0.058,0.019,0.078,0.077,0.058*42 L26-DR(ADR)_DR_Application_Note 21 / 48 GNSS Module Series NOTE Commands to enable or disable the output of $PSTMDRBSD are shown below. //Enable $PSTMDRBSD: $PSTMSETPAR,1228,40000000,1*0B $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRBSD: $PSTMSETPAR,1228,40000000,2*08 $PSTMSAVEPAR*58 $PSTMSRR*49 4.3. PSTMDRGPS Reports relevant GNSS information. It includes position, velocity and attitude data, as well as quality metrics related to GNSS measurements and constellation used. Type: Output Synopsis: $PSTMDRGPS,,,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Degree Degree m/s m/s - Description GNSS latitude GNSS longitude GNSS velocity north component GNSS velocity east component 3D position dilution of precision of used GNSS constellation Horizontal position dilution of precision of used GNSS constellation Vertical position dilution of precision of used GNSS L26-DR(ADR)_DR_Application_Note 22 / 48 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Unit Meter m/s m/s Meter Description constellation RMS error on GNSS pseudo range measurements RMS error on GNSS frequency measurements GNSS velocity up component GNSS altitude Example: $PSTMDRGPS,31.853778470,117.253363350,0.69824,-3.58118,1.254,0.793,0.969,30.811,0.520,-0.076 42,28.7*76 NOTE Commands to enable or disable the output of $PSTMDRGPS are shown below. //Enable $PSTMDRGPS: $PSTMSETPAR,1228,800000,1*07 $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRGPS: $PSTMSETPAR,1228,800000,2*04 $PSTMSAVEPAR*58 $PSTMSRR*49 4.4. PSTMDRPVA Reports the position, velocity and attitude estimated by DR. Type: Output Synopsis: $PSTMDRPVA,,,,,,,,,,,* L26-DR(ADR)_DR_Application_Note 23 / 48 GNSS Module Series Parameter: Field Format hhmmss.sss Floating Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit - Degree Degree Meter m/s m/s m/s Degree Degree Degree Description Position fix timestamp (UTC). hh: Hours. Range: 00–23 mm: Minutes. Range: 00–59 ss: Seconds. Range: 00–59 sss: Decimal fraction of seconds Time of DR estimation (CPU ticks). DR latitude DR Longitude DR height DR velocity north component DR velocity east component DR velocity up component DR pitch angle DR roll angle DR heading angle Example: $PSTMDRPVA,064420.000,24295094,31.8222713,117.1157794,33.1,0.00,0.00,0.21,1.64,-2.10,26.61*4 8 NOTE Commands to enable or disable the output of $PSTMDRPVA are shown below. //Enable $PSTMDRPVA: $PSTMSETPAR,1228,4000000,1*3B $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRPVA: $PSTMSETPAR,1228,4000000,2*38 $PSTMSAVEPAR*58 $PSTMSRR*49 L26-DR(ADR)_DR_Application_Note 24 / 48 GNSS Module Series 4.5. PSTMDRPVASD Reports the standard deviation of DR estimates for position, velocity and attitude. Type: Output Synopsis: $PSTMDRPVASD,,,,,,,,,,,,,,,,,* Parameter: Field Format hhmmss.sss Floating Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit - Degree Degree Meter m/s m/s m/s Degree Degree Degree Meter Meter Description Position fix timestamp (UTC). hh: Hours. Range: 00–23 mm: Minutes. Range: 00–59 ss: Seconds. Range: 00–59 .sss: Decimal fraction of seconds Time of DR estimation (CPU ticks). DR latitude standard deviation DR longitude standard deviation DR height standard deviation DR velocity north component standard deviation DR velocity east component standard deviation DR velocity up component standard deviation DR pitch angle standard deviation DR roll angle standard deviation DR heading angle standard deviation DR position north east standard deviation DR position north up standard deviation L26-DR(ADR)_DR_Application_Note 25 / 48 GNSS Module Series Field Format Numeric Numeric Numeric Numeric Unit Meter m/s m/s m/s Description DR position east up standard deviation DR velocity north east standard deviation DR velocity north up standard deviation DR velocity east up standard deviation Example: $PSTMDRPVASD,064420.000,24295094,17.9,22.0,13.5,2.83,1.77,1.80,0.00,0.00,180.01,11.5,7.2,8.9,1. 32,0.61,0.79*78 NOTE Commands to enable or disable the output of $PSTMDRPVASD are shown below. //Enable $PSTMDRPVASD: $PSTMSETPAR,1228,2000000,1*3D $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRPVASD: $PSTMSETPAR,1228,2000000,2*3E $PSTMSAVEPAR*58 $PSTMSRR*49 4.6. PSTMDRSINT Reports the result for sensors’ integration samples. Type: Output Synopsis: $PSTMDRSINT,,,,,,,,,,,,,,* L26-DR(ADR)_DR_Application_Note 26 / 48 GNSS Module Series Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Second Second Second dps dps dps m/s2 m/s2 m/s2 hPa Description Number of received gyro samples Number of received accelerometer samples Number of received pressure samples Number of received odometer pulses Elapsed time between the receipt of 1st and last gyro sample Elapsed time between the receipt of 1st and last accelerometer sample Elapsed time between the receipt of 1st and last pressure sample Average of x gyro samples received in last second, expressed in vehicle frame. Average of y gyro samples received in last second, expressed in vehicle frame. Average of z gyro samples received in last second, expressed in vehicle frame. Average of x accelerometer samples received in last second, expressed in vehicle frame. Average of y accelerometer samples received in last second, expressed in vehicle frame. Average of z accelerometer samples received in last second, expressed in vehicle frame. Average of received pressure samples Example: $PSTMDRSINT,100,100,0,0,1.000,1.000,0.000,-0.42,0.79,-0.07,0.26,0.35,10.05,0.00*05 NOTE Commands to enable or disable the output of $PSTMDRSINT are shown below. //Enable $PSTMDRSINT: $PSTMSETPAR,1228,800000,1*07 $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRSINT: L26-DR(ADR)_DR_Application_Note 27 / 48 $PSTMSETPAR,1228,800000,2*04 $PSTMSAVEPAR*58 $PSTMSRR*49 GNSS Module Series 4.7. PSTMDRSVF Reports vehicle dynamics (accelerations and angular rates) measured by the IMU. The measurements are illustrated in Chapter 2.1.1 Vehicle Reference Frame. Type: Output Synopsis: $PSTMDRSVF,,,,,,,,* Parameter: Field Format hhmmss.sss Floating Numeric Numeric Numeric Numeric Numeric Numeric Unit - m/s2 m/s2 m/s2 dps dps dps Description Position fix timestamp (UTC). hh: Hours. Range: 00–23 mm: Minutes. Range: 00–59 ss: Seconds. Range: 00–59 sss: Decimal fraction of seconds Time of estimation (CPU ticks). Vehicle acceleration in x direction Vehicle acceleration in y direction Vehicle acceleration in z direction Vehicle angular rate in x direction Vehicle angular rate in y direction Vehicle angular rate in z direction Example: $PSTMDRSVF,064420.000,24295094,0.00,0.00,0.00,0.00,0.00,0.00*50 L26-DR(ADR)_DR_Application_Note 28 / 48 GNSS Module Series NOTE Commands to enable or disable the output of $PSTMDRSVF are shown below. //Enable $PSTMDRSVF: $PSTMSETPAR,1228,200,1*3D $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRSVF: $PSTMSETPAR,1228,200,2*3E $PSTMSAVEPAR*58 $PSTMSRR*49 4.8. PSTMDRUPD This message outputs information for Quectel’s internal debugging purpose only. 4.9. PSTMDRSTYPE Reports DR sensor configuration (combination) type. Type: Output Synopsis: $PSTMDRSTYPE,* Parameter: Field Format Numeric Unit Description Type of sensor for generating yaw value. - 3 = GYRO3, meaning yaw is calculated from a 3D MEMS gyro or CAN bus provided gyro data. Example: $PSTMDRSTYPE,3*58 L26-DR(ADR)_DR_Application_Note 29 / 48 GNSS Module Series NOTE Commands to enable or disable the output of $PSTMDRSTYPE are shown below. //Enable $PSTMDRSTYPE: $PSTMSETPAR,1228,2000000,1*3D $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRSTYPE: $PSTMSETPAR,1228,2000000,2*3E $PSTMSAVEPAR*58 $PSTMSRR*49 4.10. PSTMDRCAL Reports the status of IMU and odometer calibration. The message is only supported in ADR mode. Type: Output Synopsis: $PSTMDRCAL,,,,,,< GyroIntegrityFlag>,,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description DR calibration status. - 0 = DR is not calibrated. 1 = DR is calibrated. Odometer scale calibration status. - 0 = Odometer scale is not calibrated. 1 = Odometer scale is calibrated. Gyro sensitivity calibration status. - 0 = Gyro sensitivity is not calibrated. 1 = Gyro sensitivity is calibrated. Gyro offset calibration status. - 0 = Gyro offset is not calibrated. 1 = Gyro offset is calibrated. L26-DR(ADR)_DR_Application_Note 30 / 48 GNSS Module Series Field Format Hexadecimal Numeric Numeric Character Example: $PSTMDRCAL,1,1,1,1,ff,1,1,F*04 Unit Description Bit fields: Bits 0–5: IMU calibration status flags. They can only be all 0 or all 1. 0 = Not calibrated 1 = Calibrated - Bits 6 and 7: IMU installation status flags. Bit 6 refers to roll installation angle and bit 7 pitch installation angle. 0 = Not self-detected 1 = Self-detected Gyro signal status flags. - 0 = Gyro signal is faulty. 1 = Gyro signal is healthy. Acceleration signal status flags. - 0 = Accelerometer signal is faulty. 1 = Accelerometer signal is healthy. DR calibration state. N =Not calibrated. - L = DR is lightly calibrated. F = DR is fully calibrated. NOTE Commands to enable or disable the output of $PSTMDRCAL are shown below. //Enable $PSTMDRCAL: $PSTMSETPAR,1228,800000,1*07 $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRCAL: $PSTMSETPAR,1228,800000,2*04 $PSTMSAVEPAR*58 $PSTMSRR*49 L26-DR(ADR)_DR_Application_Note 31 / 48 GNSS Module Series 4.11. PSTMDR1 Reports the details about alignment angles, bias and sensitivity values for gyroscope and accelerometer. Type: Output Synopsis: $PSTMDR1,,,,,,,,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Numeric Unit Description Degree Misalignment sensor vs. vehicle frame – Pitch angle Degree Misalignment sensor vs. vehicle frame – Roll angle Degree Misalignment sensor vs. vehicle frame – Yaw angle - Gyro z axis sensitivity dps Gyro x axis bias dps Gyro y axis bias dps Gyro z axis bias m/s2 Accelerometer x axis bias m/s2 Accelerometer y axis bias m/s2 Accelerometer z axis bias Meter/Pulse Odometer scale - Reserved for barometer - Reserved for barometer Example: $PSTMDR1,-1.63,-1.67,-91.75,1.009,-0.754,-0.197,0.118,-0.029,0.254,0.176,0.081,0.000,0.000*39 L26-DR(ADR)_DR_Application_Note 32 / 48 GNSS Module Series NOTES Commands to enable or disable the output of $PSTMDR1 are shown below. //Enable $PSTMDR1: $PSTMSETPAR,1228,20000000,1*0D $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDR1: $PSTMSETPAR,1228,20000000,2*0E $PSTMSAVEPAR*58 $PSTMSRR*49 4.12. PSTMDR2 Reports calibration status and availability. Type: Output Synopsis: $PSTMDR2,,,,,,,,,,* Parameter: Field Format Unit String - String - Numeric - Description 6-axis IMU calibration status. The first character refers to accelerometer status and the second gyroscope status. A = Not Available (sensor not supported) N = Not calibrated C = Calibrated Additional sensor calibration status. Fix as AA. A = Not Available (sensor not supported) N = Not calibrated C = Calibrated Motion status indicator. 0 = Unclassified 1 = Stopped L26-DR(ADR)_DR_Application_Note 33 / 48 GNSS Module Series Field Format Unit Numeric - Numeric - Numeric Numeric Meter Meter Numeric - Numeric Meter Numeric - Example: $PSTMDR2,CC,AA,2,0,1,0.48,2.23,1,0.000,0*2D Description 2 = Moving straight 3 = Not moving straight or turning 4 = Turning 5 = Accelerating 6 = Braking 7: Moving in reverse FW error code. 0 = No error 1 = Gyro failure 2 = Accelerometer failure 3 = Odometer failure 4 = GNSS failure 5 = Pressure sensor failure 6 = Magnetometer failure 7 = Misalignment failure 8 = Accelerometer KF failure 9 = Gyro KF failure 10 = Generic software failure System ready flag. 0 = System not ready (GNSS-only PVT output) 1 = System ready (PVT output from GNSS sensor fusion) Cross-track error: compared from GNSS-only mode Along-track error: compared from GNSS-only mode System aligned flag. 0 = System not aligned (Full Free Mounted procedure is not finished) 1 = System aligned (Full Free Mounted procedure has been completed successfully) Estimated vehicle tire circumference VRO flag. 0 = Not started 1 = Search ongoing 2 = Speed available 3 = Speed not available for weak signal L26-DR(ADR)_DR_Application_Note 34 / 48 GNSS Module Series NOTE Commands to enable or disable the output of $PSTMDR2 are shown below. //Enable $PSTMDR2: $PSTMSETPAR,1228,20000000,1*0D $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDR2: $PSTMSETPAR,1228,20000000,2*0E $PSTMSAVEPAR*58 $PSTMSRR*49 4.13. PSTMDREPE Reports the error of DR estimated horizontal position. Type: Output Synopsis: $PSTMDREPE,,* Parameter: Field Format Numeric Numeric Unit Meter - Description Error of DR estimated horizontal position Fixed as -1.00. Reserved for future use. Example: $PSTMDREPE,141.42,-1.00*72 NOTE Commands to enable or disable the output of $PSTMDREPE are shown below. //Enable $PSTMDREPE: $PSTMSETPAR,1228,2000000,1*3D $PSTMSAVEPAR*58 L26-DR(ADR)_DR_Application_Note 35 / 48 $PSTMSRR*49 //Disable $PSTMDREPE: $PSTMSETPAR,1228,2000000,2*3E $PSTMSAVEPAR*58 $PSTMSRR*49 GNSS Module Series 4.14. PSTMDRDEBUG Reports DR debug information consisting of the following 6 error values that contain the differences between the GNSS Kalman and DR Kalman calculated values for key parameters. Type: Output Synopsis: $PSTMDRDEBUG,,,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Numeric Numeric Unit Meter Meter Degree m/s Meter m/s Description Latitude error Longitude error Heading error Speed error Height error Rise speed error Example: $PSTMDRDEBUG,0.6,-2.0,-8.7,0.0,10.5,0.0*62 L26-DR(ADR)_DR_Application_Note 36 / 48 GNSS Module Series NOTE Commands to enable or disable the output of $PSTMDRDEBUG are shown below. //Enable $PSTMDRDEBUG: $PSTMSETPAR,1228,2000000,1*3D $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRDEBUG: $PSTMSETPAR,1228,2000000,2*3E $PSTMSAVEPAR*58 $PSTMSRR*49 4.15. PSTMDRSENCONFIG Reports data about sensor internal configuration. Type: Outputs Synopsis: $PSTMDRSENCONFIG,,,,,,,* Parameters: Field Format String String Numeric Numeric Numeric Numeric Unit g or dps g/LSB or dps/LSB Hz Hz Description Type of reported sensor. IMU ACC: Accelerometer IMU GYRO: Gyroscope Sensor name. Fixed as LSM6DSR. Maximum sensible value. The unit g for accelerometer, dps for gyro. Nominal sensitivity value. The unit g/LSB for accelerometer, dps/LSB for gyro. Digital data output rate. Bandwidth of sensor’s analog low-pass filter. L26-DR(ADR)_DR_Application_Note 37 / 48 GNSS Module Series Field Format Unit Description Status of the sensors’ embedded temperature compensation block. 0 = Disabled 1 = Enabled This field is only present when is IMU Gyro. Example: $PSTMDRSENCONFIG,IMU GYRO,LSM6DSR,125,4375,52,26.0,1*3E $PSTMDRSENCONFIG,IMU ACC,LSM6DSR,2,61,52,26.0*67 4.16. PSTMIMUSELFTESTCMD Executes the self-test procedure in IMU. Type: Command Synopsis: $PSTMIMUSELFTESTCMD,* Parameter: Field Format Numeric Unit Description IMU type. - 0 = Accelerometer 1 = Gyroscope L26-DR(ADR)_DR_Application_Note 38 / 48 GNSS Module Series Results: ⚫ If successful, the module returns: $PSTMIMUSELFTESTCMDOK* ⚫ If failed, the module returns: $PSTMIMUSELFTESTCMDKO* ⚫ If the self-test command is not supported by the mounted IMU or not supported by the FW (sensor layer not present in FW), the module returns: $PSTMIMUSELFTESTCMDERROR* Example: $PSTMIMUSELFTESTCMD,1*16 $PSTMIMUSELFTESTCMDOK*0F 4.17. PSTMDRSENMSG Outputs the IMU raw data. Type: Output Synopsis: $PSTMDRSENMSG,[,…,]* Parameters: Field Format Unit Numeric - to Numeric - Description Message ID. 1 = Odometer 2 = Reverse 3 = Odometer and reverse 14 = Vehicle speed 24 = IMU temperature 30 = IMU accelerometer 31 = IMU gyroscope This field varies with the message type. See Chapters 4.17.1 Odometer Message (MsgID = 1), 4.17.2 Reverse Message (MsgID = 2), 4.17.3 Odometer L26-DR(ADR)_DR_Application_Note 39 / 48 GNSS Module Series Field Format Unit Description and Reverse Message (MsgID = 3), 4.17.4 Vehicle Speed Message (MsgID = 14), 4.17.5 IMU Temperature Message (MsgID = 24), 4.17.6 IMU Accelerometer Message (MsgID = 30) and 4.17.7 IMU Gyroscope Message (MsgID = 31) for details. NOTE Commands to enable or disable the output of $PSTMDRSENMSG are shown below. //Enable $PSTMDRSENMSG: $PSTMSETPAR,1228,10000000,1*0E $PSTMSAVEPAR*58 $PSTMSRR*49 //Disable $PSTMDRSENMSG: $PSTMSETPAR,1228,10000000,2*0D $PSTMSAVEPAR*58 $PSTMSRR*49 4.17.1. Odometer Message (MsgID = 1) Inputs/outputs the count of accumulated pulses acquired by an odometer-type wheel rotation sensor. It is recommended to inject odometer count at a frequency of 10 Hz. Type: Input/output Synopsis: $PSTMDRSENMSG,1,,* Parameter: Field Format Numeric Numeric Unit Description CPU tick count since power-on. - For input messages, this field is fixed as 0. - Unsigned odometer count. L26-DR(ADR)_DR_Application_Note 40 / 48 Example: $PSTMDRSENMSG,1,0,0*10 $PSTMDRSENMSG,1,1924310999,0*25 GNSS Module Series 4.17.2. Reverse Message (MsgID = 2) Inputs/outputs the status of the indicator of vehicle reverse motion. It is recommended to inject status at a frequency of 10 Hz. Type: Input/output Synopsis: $PSTMDRSENMSG,2,,* Parameter: Field Format Numeric Numeric Unit Description CPU tick count since power-on. - For input messages, this field is fixed as 0. Vehicle direction. - 0 = Forward 1 = Reverse Example: $PSTMDRSENMSG,2,0,0*13 $PSTMDRSENMSG,2,1924310999,0*26 4.17.3. Odometer and Reverse Message (MsgID = 3) Outputs the accumulated count of pulses from an odometer-type wheel rotation sensor, along with the indication of vehicle direction. This message is provided at 10 Hz. Type: Output Synopsis: $PSTMDRSENMSG,3,,,* L26-DR(ADR)_DR_Application_Note 41 / 48 Parameter: Field Format Unit Numeric - Numeric - Numeric - Example: $PSTMDRSENMSG,3,1924310999,0,0*3B GNSS Module Series Description CPU tick count since power-on. Unsigned odometer count. Vehicle direction. 0 = Forward 1 = Reverse 4.17.4. Vehicle Speed Message (MsgID = 14) Inputs/outputs vehicle speed expressed in kilometer per hour. It is recommended to inject vehicle speed at a frequency of 10 Hz. Type: Input/output Synopsis: $PSTMDRSENMSG,14,,* Parameters: Field Format Numeric Numeric Unit μs km/h Description CPU tick count since power-on. For input messages, this field is fixed as 0. Vehicle speed. Example: $PSTMDRSENMSG,14,0,7.0*3D $PSTMDRSENMSG,14,1375473563,7.0*0D L26-DR(ADR)_DR_Application_Note 42 / 48 GNSS Module Series 4.17.5. IMU Temperature Message (MsgID = 24) Outputs the IMU temperature. This message is provided at 1 Hz. Type: Output Synopsis: $PSTMDRSENMSG,24,,,* Parameters: Field Format Numeric Numeric Numeric Unit Description - CPU tick count since power-on. IMU temperature. - Real temperature in Celsius degrees: Celsius degrees = / 256 + 25.0 Temperature validity. - 0 = Not valid 1 = Valid Example: $PSTMDRSENMSG,24,3248649605,-486,1*28 4.17.6. IMU Accelerometer Message (MsgID = 30) Outputs the acceleration values measured by the IMU accelerometer. This message is provided at 100 Hz. Full Scale = ±2g Sensitivity = 0.061 mg/LSB Type: Output Synopsis: $PSTMDRSENMSG,30,,,,* L26-DR(ADR)_DR_Application_Note 43 / 48 GNSS Module Series Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description - CPU tick count since power-on. Raw signed 16-bit integer X-axis acceleration data - in sensor frame Raw signed 16-bit integer Y-axis acceleration data in sensor frame Raw signed 16-bit integer Z-axis acceleration data in sensor frame Example: $PSTMDRSENMSG,30,3248512115,299,-35,16514*02 $PSTMDRSENMSG,30,3248570594,302,-37,16524*09 4.17.7. IMU Gyroscope Message (MsgID = 31) Outputs the raw data measured by the IMU gyroscope. This message is provided at 100 Hz. Full Scale = ±125 dps Sensitivity = 4.375 mdps/LSB Type: Output Synopsis: $PSTMDRSENMSG,31,,,,* Parameter: Field Format Numeric Numeric Numeric Numeric Unit Description - CPU tick count since power-on. Raw signed 16-bit integer X-axis angular rate data - in sensor frame Raw signed 16-bit integer Y-axis angular rate data in sensor frame Raw signed 16-bit integer Z-axis angular rate data in sensor frame L26-DR(ADR)_DR_Application_Note 44 / 48 Example: $PSTMDRSENMSG,31,5855224,62,-119,-49*2A $PSTMDRSENMSG,31,5913732,68,-117,-43*25 GNSS Module Series L26-DR(ADR)_DR_Application_Note 45 / 48 GNSS Module Series 5 Appendix A References Table 1: Related Document Document Name [1] Quectel_L26-DR_Series_Hardware_Design Table 2: Terms and Abbreviations Abbreviation 3D ADR CAN DR DWP FFM FW GNSS IMU KF LSB MEMS NVM OBD-II PVT Description 3 Dimension Automotive Dead Reckoning Controller Area Network Dead Reckoning Differential Wheels Pulse Full Free Mount Firmware Global Navigation Satellite System Inertial Measurement Unit Kalman Filter Least Significant Bit Micro-Electro-Mechanical System Non-volatile Memory On-Board Diagnostics Second Generation Position, Velocity and Time L26-DR(ADR)_DR_Application_Note 46 / 48 Abbreviation RMS UART UDR UTC VRO GNSS Module Series Description Root Mean Square Universal Asynchronous Receiver/Transmitter Untethered Dead Reckoning Universal Time Coordinated Virtual Odometer L26-DR(ADR)_DR_Application_Note 47 / 48 GNSS Module Series 6 Appendix B Special Characters Table 3: Special Characters Special Character […] {…} Underline Description Carriage return character. Line feed character. Parameter name. Angle brackets do not appear in the message. Optional field of a message. Square brackets do not appear in the message. Repeated field of a message. Curly brackets do not appear in the message. Default setting of a parameter. L26-DR(ADR)_DR_Application_Note 48 / 48

模块点胶应用指导 版本：模块点胶应用指导_V1.0 日期：2019-08-01 状态：受控文件 www.quectel.com 模块点胶应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 21 文档历史 修订记录 版本 1.0 日期 2019-08-01 作者 黄克辉 变更表述 初始版本 模块点胶应用指导 上海移远通信技术股份有限公司 2 / 21 模块点胶应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 图片索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 胶水相关信息.......................................................................................................................................... 7 2.1. 胶水封装类型...............................................................................................................................7 2.2. 胶水类型 ...................................................................................................................................... 7 3 点胶设备能力要求 .................................................................................................................................. 9 3.1. 点胶设备 ...................................................................................................................................... 9 3.2. 底部填充胶的规范要求 .............................................................................................................. 10 4 生产注意事项........................................................................................................................................ 13 4.1. 固化设备 .................................................................................................................................... 13 4.2. 底部填充工序测温板要求 .......................................................................................................... 15 4.3. 底部填充关键管控标准 .............................................................................................................. 15 4.3.1. 主要的控制标准 ................................................................................................................ 15 4.3.2. 检验标准 ........................................................................................................................... 16 4.4. 点胶不良的判定 ......................................................................................................................... 17 5 BGA 封装元件的返修...........................................................................................................................19 上海移远通信技术股份有限公司 3 / 21 模块点胶应用指导 表格索引 表 1：底部填充胶回温要求 .................................................................................................................................11 表 2：点胶设备规格参数.................................................................................................................................... 12 表 3：底部填充胶烤箱固化参数 ......................................................................................................................... 13 上海移远通信技术股份有限公司 4 / 21 模块点胶应用指导 图片索引 图 1：针筒装胶水................................................................................................................................................. 7 图 2：包裹胶（固定胶）...................................................................................................................................... 8 图 3：底部填充胶（UNDERFILL 胶）................................................................................................................. 8 图 4：全自动点胶设备 ......................................................................................................................................... 9 图 5：桌面型半自动点胶设备............................................................................................................................. 10 图 6：手动点胶设备 ........................................................................................................................................... 10 图 7：底部填充胶回温操作示意图 ......................................................................................................................11 图 8：固化炉温曲线图 ....................................................................................................................................... 14 图 9：针嘴距离测试器件边缘距离示意图 .......................................................................................................... 15 图 10：底部填充图示 ......................................................................................................................................... 16 图 11：合格标准图示 ......................................................................................................................................... 16 图 12：良品和不良品对比示意图 ....................................................................................................................... 17 图 13：焊点开裂示意图 ..................................................................................................................................... 17 图 14：元件截面切片图 ..................................................................................................................................... 18 图 15：返修流程图............................................................................................................................................. 19 图 16：主板加热 ................................................................................................................................................ 20 图 17：BGA 分离 ............................................................................................................................................... 20 图 18：PCB 清洁 ............................................................................................................................................... 21 图 19：PCB 焊盘清洁 ........................................................................................................................................ 21 上海移远通信技术股份有限公司 5 / 21 模块点胶应用指导 1 引言 本文档描述了移远通信模块进行二次贴片回流和测试后点胶工艺的规范要求和标准，以及维修时的作 业指导要求，以提升移远通信模块在机械冲击、振动和高低温环境下的焊接可靠性，适用于移远通信所有 需要点胶的模块。 上海移远通信技术股份有限公司 6 / 21 模块点胶应用指导 2 胶水相关信息 2.1. 胶水封装类型 模块点胶使用的胶水的封装类型一般为管装和针筒装两种，本文档所使用的底部填充胶封装为针筒装， 如下图所示。 图 1：针筒装胶水 2.2. 胶水类型  包裹胶（固定胶） 在元件周边进行固定的胶水，如白胶、红胶，以防止小焊盘和小器件因外力作用发生掉件。 上海移远通信技术股份有限公司 7 / 21 模块点胶应用指导 图 2：包裹胶（固定胶）  底部填充胶（Underfill 胶） 利用毛细作用使此胶水渗透流入元件内部所有空间形成对焊点的完全包裹，如下图所示。 图 3：底部填充胶（Underfill 胶） 备注 建议使用底部填充胶进行点胶，本文档主要介绍如何使用底部填充胶进行模块点胶应用。 上海移远通信技术股份有限公司 8 / 21 模块点胶应用指导 3 点胶设备能力要求 3.1. 点胶设备  类型： 全自动点胶设备、桌面型半自动点胶设备和手动点胶设备。  性能要求： 全自动点胶机：需具备高精度的 X、Y 和 Z 轴移动，并采用非接触式喷射点胶方式，确保点胶的流量、 精度和工艺性能。胶水的准确性和可重复性为 Cpk>1.33，±1mg@3σ。 半自动点胶机：性能要求可降低，但针对式点胶方式不允许接触到元件本体。点胶前必须检查所有工 装治具和设备的 ESD 防护性能，并测试确保静电环境安全。 图 4：全自动点胶设备 上海移远通信技术股份有限公司 9 / 21 模块点胶应用指导 图 5：桌面型半自动点胶设备 图 6：手动点胶设备 3.2. 底部填充胶的规范要求 胶水的回温规范如下：  回温而未开封使用的胶水可以在室温下放置 24 小时，超过 24 小时应立即放回冰箱冷藏，下次优 先取用；每支胶水最多允许经历 2 次回温；  未使用完的胶水可以在使用后 12 小时之内放回冰箱冷藏，下次优先取用；每支胶水最多允许经历 2 次回温，即只可以做一次放回冰箱重新冷藏的操作；  已经固化的底部填充胶不可再使用，须报废；开封时已经固化或者粘度非常大而导致无法渗透的 底部填充胶，应作退货处理；过期的底部填充胶不可再用，须报废；  完成回温的底部填充胶在使用环境下的放置时间超出要求后（例如，在常温环境放置了超过 48 小 上海移远通信技术股份有限公司 10 / 21 时），胶水必须报废。 胶水回温的要求具体如下表所示。 模块点胶应用指导 表 1：底部填充胶回温要求 参数 使用前回温时间 要求  ≥2.5 小时（30ml 包装）  ≥4 小时（250ml 包装） （底部填充胶的实际回温时间受包装大小影响，具体请参考供应商 使用指导要求） 操作时间（回温后常温环境使用时间） 24 小时（温度≤26℃） 胶水回温操作  底部填充胶使用前，应从冷藏柜中取出，针头朝下放置在室温 下回温；  回温后进行点胶操作时，需严格遵循正确的取胶方法，不允许 手心直接握针管；  不允许采用任何方式加热来加快解冻，防止解冻时产生气泡。 禁用使用条件 回温后出现大量气泡的胶水禁止使用 图 7：底部填充胶回温操作示意图 上海移远通信技术股份有限公司 11 / 21 备注 将胶水放回冰箱前需要拧紧盖子，以防止胶水通过出胶口接触空气吸潮。 模块点胶应用指导 胶水的工艺规范要求如下：  对于不同型号类型的胶水的贮存和使用，需遵从胶水厂商推荐的规范要求；  使用底部填充胶时的 PCB 预热要求：全自动点胶机在点胶之前可以对 PCB 和胶水进行预热处理， 以增加胶水流动性，确保在固化前充满元件底部；  使用底部填充胶时的点胶过程，需根据实际情况调整针头规格、点胶速度和点胶气压，以达到最 佳效果；  使用底部填充胶时的点胶量确认：需要用电子称来确认 PCB 点胶量是否达到要求的重量，电子称 精度须精确至 0.001g（1mg）。 表 2：点胶设备规格参数 规格参数 可选针头范围 推荐针头规格 针头材质 自动点胶设备 21~23# 22# 不锈钢 半自动点胶机/手动点胶设备 18~23# 20# 不锈钢 上海移远通信技术股份有限公司 12 / 21 模块点胶应用指导 4 生产注意事项 4.1. 固化设备 底部填充胶可采用回流炉固化或烘箱固化方式，PCB 板水平放置。 表 3：底部填充胶烤箱固化参数 规格参数 固化温度 固化时间 底部填充胶 请依据具体胶水的参数要求 请依据具体胶水的参数要求 备注 固化时间指元件在固化温度下进行固化持续的时间，升降温时间不计在内。建议参考具体胶水的要求参数 来设置固化温度和时间。 上海移远通信技术股份有限公司 13 / 21 模块点胶应用指导 回流炉固化参数条件同上表，升降温不计在内，请参考下图设置固化炉温曲线。 图 8：固化炉温曲线图 1. 在 PCB 回流焊接后，底部填充点胶前是否需做预烘烤处理，可咨询胶水供应商； 2. 如果在 PCB 回流焊接后超过 8 小时，底部填充点胶前建议做烘烤预热处理，保证点胶时元件底部达到 40~50°C，以增加胶水流动性，确保在固化前充满元件底部。烘烤条件为：  烘箱设置为 80~120°C；  烘烤时间为 4~8 小时；  取出后需静置到约 40~50°C 后直接进行点胶（如全自动点胶设备自带 PCB 烘烤装置的可以直接在 机器上进行）。 3. 底部填充点胶时需保证待点胶 PCB 面水平放置； 4. 点胶路径为：L 型施胶。 5. 点胶时针嘴外径和元件的距离为 4~6mil，如下图所示： 上海移远通信技术股份有限公司 14 / 21 模块点胶应用指导 4－6mil Needle 4－6mil 剖视图 俯视图 图 9：针嘴距离测试器件边缘距离示意图 备注 1. 对于不同型号和供应商的胶水，应考虑供应商的建议，确定合适的固化曲线和工艺制程。 2. 点胶不当会有产生气泡的风险，在加热固化时气体受热膨胀可能产生喷胶现象，使喷出来的胶水污染 焊点导致焊点失效，可采取的措施是胶水在固化过程中延长升温过程。 3. PCB 点胶前必须完成 PCB 测试的所有环节，测试通过的良品板才能点胶，点胶后不可进行二次回流。 4.2. 底部填充工序测温板要求 请参考无铅回流工序炉温测试板制作要求，需要测量每一个点胶元件底部的实际温度曲线。 4.3. 底部填充关键管控标准 4.3.1. 主要的控制标准 依据行业规范：IPC J-STD-030A 定义了粘合剂的工艺标准：  无空洞； 上海移远通信技术股份有限公司 15 / 21  无外露的器件边缘和焊点；  完全固化；  无任何阻焊剂粘度残留。 模块点胶应用指导 图 10：底部填充图示 4.3.2. 检验标准 关于检验合格标准，关键位置的数据请参考如下标准：  必须有足够的圆角/宽度覆盖在元件四个方面；  上胶高度需为元件厚度的 25%以上，但不能覆盖器件顶部；  没有暴露在外的引脚和焊点；  在被固化的底部填充胶和元件的底部边缘之间有明显的润湿角度形成。 上海移远通信技术股份有限公司 图 11：合格标准图示 16 / 21 模块点胶应用指导 图 12：良品和不良品对比示意图 4.4. 点胶不良的判定 底部填充存在气泡或空洞是一种缺陷。如果固化温度和点胶的工艺控制不规范，会失去有效的成本的 投入，严重的会引起二次不良的产生。规范的点胶工艺对预防焊点的失效和开裂有保护作用。所以，对于 点胶不良的判断非常重要。 图 13：焊点开裂示意图 上海移远通信技术股份有限公司 17 / 21 判断底部填充的效果可以通过以下两种测试进行判断： 1. 截面切片分析。 模块点胶应用指导 图 14：元件截面切片图 2. 超声波显微镜（SAT），可用来检测元件组件内部不同位置的脱层（Delamination）、裂缝（Crack）、 气洞及粘着状况，多用于检查元件封胶内的缺陷。 上海移远通信技术股份有限公司 18 / 21 模块点胶应用指导 5 BGA 封装元件的返修 本章节介绍说明了 BGA 元件（Ball Grid Array，焊球阵列封装元件）物料不良时的返修流程。 当 BGA 元件物料不良时，首先需要把 PCB 和 BGA 元件分离并将 PCB 和 BGA 焊球清洁干净，所需 要的工具及流程如下：  恒温电烙铁  通用的焊接返修治具  热风枪  镊子  环保阻焊膏  真空吸笔  吸锡带（线）  底部加热平台  IPA清洗剂 主板加热 PCB&BGA元件分离 PCB 清洁 BGA 清洁 PCB 涂覆焊膏 BGA 植球 加热焊接 图 15：返修流程图 上海移远通信技术股份有限公司 19 / 21 模块点胶应用指导 返修步骤：  主板放在通用的焊接返修治具，加热台放于主板底部，固定好主板后热风枪对准 BGA 均匀加热， 温度 300~350°C，时间约 30 秒，如下图所示。 图 16：主板加热  使用塑料防静电镊子剥去 BGA 四周因受热软化的胶后，两分钟后用吸笔迅速移除 BGA。 图 17：BGA 分离 上海移远通信技术股份有限公司 20 / 21 模块点胶应用指导  使用防静电毛刷或无尘布擦拭 PCB 板上的阻焊剂，用放大镜检查清洁效果。 图 18：PCB 清洁  确保 PCB 的焊盘清洁干净后，使用吸锡带清除焊盘表面的焊锡。 图 19：PCB 焊盘清洁  在清洁好后的 PCB 位置重新焊接新的 BGA 或植球后的 BGA，推荐使用专用的 BGA 返修台。 整个返修流程需要 5-10 分钟，并需使用 X-ray 检查阻焊剂效果。 上海移远通信技术股份有限公司 21 / 21

EP06&EG06&EM06 GNSS AT Commands Manual LTE Module Series Rev. EP06&EG06&EM06_GNSS_AT_Commands_Manual_V1.0 Date: 2018-04-11 Status: Released www.quectel.com LTE Module Series EP06&EG06&EM06 GNSS 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. EP06&EG06&EM06_GNSS_AT_Commands_Manual 1 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual About the Document History Revision 1.0 Date 2018-04-11 Author Amos ZHANG Description Initial EP06&EG06&EM06_GNSS_AT_Commands_Manual 2 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 1.1. GNSS Turning on/off Procedures ............................................................................................... 5 1.2. NMEA Sentences Type ............................................................................................................... 6 1.3. Introduction of gpsOneXTRA Assistance.................................................................................... 6 2 Description of GNSS AT Commands ................................................................................................. 8 2.1. AT+QGPSCFG GNSS Configurations ..................................................................................... 8 2.1.1. AT+QGPSCFG='outport' Configure NMEA Sentences Output Port ............................ 8 2.1.2. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA.......................................................................................................................... 9 2.1.3. AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences.. 10 2.1.4. AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences ..................................................................................................................................... 11 2.1.5. AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences ..................................................................................................................................... 11 2.1.6. AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences ..................................................................................................................................... 12 2.1.7. AT+QGPSCFG='gsvextnmeatype' Enable/Disable Output of GSVEXT NMEA Sentences ..................................................................................................................................... 13 2.1.8. AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations ................ 14 2.1.9. AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically ................... 14 2.2. AT+QGPSDEL Delete Assistance Data ................................................................................. 15 2.3. AT+QGPS Turn on GNSS ...................................................................................................... 16 2.4. AT+QGPSEND Turn off GNSS .............................................................................................. 17 2.5. AT+QGPSLOC Acquire Positioning Information .................................................................... 18 2.6. AT+QGPSGNMEA Acquire NMEA Sentences....................................................................... 20 2.7. AT+QGPSXTRA Enable gpsOneXTRA Assistance Function ................................................ 21 2.8. AT+QGPSXTRATIME Inject gpsOneXTRA Time................................................................... 22 2.9. AT+QGPSXTRADATA Inject a gpsOneXTRA Data File......................................................... 23 3 Examples ............................................................................................................................................ 25 3.1. Turn on and off the GNSS......................................................................................................... 25 3.2. Application of GNSS .............................................................................................. 25 3.3. Operation Procedures of gpsOneXTRA Assistance Function .................................................. 26 4 Summary of Error Codes .................................................................................................................. 27 5 Appendix A References..................................................................................................................... 28 EP06&EG06&EM06_GNSS_AT_Commands_Manual 3 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 27 TABLE 2: RELATED DOCUMENTS .................................................................................................................. 28 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 28 EP06&EG06&EM06_GNSS_AT_Commands_Manual 4 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual 1 Introduction Quectel EP06&EG06&EM06 modules integrate a GNSS engine which supports GPS, BeiDou, Galileo and GLONASS systems, and also it supports gpsOneXTRA Assistance technology. The high performance GNSS engine is suitable for various applications where lowest-cost and accurate positioning is needed, and it supports position tracking without network assistance. EP06&EG06&EM06 GNSS can be applied in the following applications: turn-by-turn navigation, asset tracking, personnel tracking, location-aware games, as well as home and fleet management. 1.1. GNSS Turning on/off Procedures The GNSS of EP06&EG06&EM06 supports location calculation without any assistance from the network. GNSS turning on/off procedures are shown below: Step 1: Configure GNSS parameters via AT+QGPSCFG. Step 2: Turn on GNSS via AT+QGPS. Step 3: After GNSS is turned on and position is fixed successfully, the positioning information can be obtained in three ways: 1) NMEA sentences are outputted to 'usbnmea' port by default. Customers can read the port to obtain NMEA sentences. 2) AT+QGPSLOC can be used to obtain positioning information directly, such as latitude, longitude, height, GNSS positioning mode, time, number of satellites, and so on. 3) After enabling via AT+QGPSCFG='nmeasrc',1, customers can acquire the specified NMEA sentence via AT+QGPSGNMEA. If is disabled, this command cannot be used. Step 4: GNSS can be turned off in two ways: 1) If the parameter of AT+QGPS is set to 0 in Step 2, GNSS will get position continuously, and it can be turned off via AT+QGPSEND. 2) If reaches the specified value, then GNSS will stop automatically. EP06&EG06&EM06_GNSS_AT_Commands_Manual 5 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual 1.2. NMEA Sentences Type The NMEA sentences are compatible with NMEA-0183 Protocol, and all of the standard NMEA sentences have four kinds of prefix, as illustrated below. For GPS sentences, the prefix is 'GP', as below:  GPGGA - Global positioning system fix data, such as time, position, etc.  GPRMC - Recommended minimum data  GPGSV - Detailed satellite data  GPGSA - Overall satellite data  GPVTG - Vector track and speed over the ground For GLONASS sentences, the prefixes are 'GL' and 'GN', as below:  GLGSV - Detailed satellite data  GNGSA - Overall satellite data  GNGNS - Positioning system For Galileo sentences, the prefixes are 'GA' and 'GN', as below:  GAGSV - Detailed satellite data  GNGSA - Overall satellite data  GNGNS - Positioning system For BeiDou sentences, the prefix is 'PQ', as below:  PQGSV - Detailed satellite data  PQGSA - Overall satellite data 1.3. Introduction of gpsOneXTRA Assistance gpsOneXTRA Assistance technology enhances the performance of GNSS, and provides simplified GNSS assistance delivery, including ephemeris, almanac, ionosphere, UTC, health and coarse time assistance for GNSS engine. After activating gpsOneXTRA Assistance, the TTFF (Time to First Fix) can be reduced by 18s~30s (or more in harsh environments with weak signals). The assistance data which is obtained from one of the gpsOneXTRA Assistance web servers on the network needs to be updated once a day (or every couple of days). Before using this function, customers need to ensure that the valid gpsOneXTRA assistance data is available first. They need to download a new gpsOneXTRA binary file which contains the data from one of the gpsOneXTRA Assistance web servers via URLs listed below. The files named as xtra2.bin are for GPS+GLONASS and the files named as xtra3grc.bin are for GPS+GLONASS+BeiDou. The exact file EP06&EG06&EM06_GNSS_AT_Commands_Manual 6 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual size should be less than 50kB. http://xtrapath1.izatcloud.net/xtra2.bin http://xtrapath2.izatcloud.net/xtra2.bin http://xtrapath3.izatcloud.net/xtra2.bin http://xtrapath1.izatcloud.net/xtra3grc.bin http://xtrapath2.izatcloud.net/xtra3grc.bin http://xtrapath3.izatcloud.net/xtra3grc.bin gpsOneXTRA assistance data needs to be updated regularly. Customers can query the status of gpsOneXTRA data file via AT+QGPSXTRADATA? and then update the data properly. The operation procedures of gpsOneXTRA Assistance function are shown as follows: Step 1: If gpsOneXTRA Assistance is disabled, enable it first via AT+QGPSXTRA and it will take effect immediately. Step 2: Query and confirm the current validity of gpsOneXTRA data file via AT+QGPSXTRADATA?. If the data is invalid, perform Step 3~6 then; if the data is valid, turn on GNSS engine according to the procedures described in Chapter 1.1 directly. Step 3: Download file xtra2.bin or xtra3grc.bin to the module via URLs listed above. Step 4: Inject the correct gpsOneXTRA time to GNSS engine via AT+QGPSXTRATIME. Step 5: Inject the valid gpsOneXTRA data file to GNSS engine via AT+QGPSXTRADATA. Step 6: Turn on GNSS engine according to the procedures described in Chapter 1.1. For more detailed information of the AT commands mentioned above, please refer to Chapters 2.7, 2.8 and 2.9. EP06&EG06&EM06_GNSS_AT_Commands_Manual 7 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual 2 Description of GNSS AT Commands 2.1. AT+QGPSCFG GNSS Configurations The command is used to query and configure various GNSS settings, including NMEA sentences output port, output type of NMEA sentences, and more. AT+QGPSCFG GNSS Configurations Test Command AT+QGPSCFG=? Response +QGPSCFG: 'outport',('none','usbnmea','uartdebug') +QGPSCFG: 'nmeasrc',(0,1) +QGPSCFG: 'gpsnmeatype',(0-31) +QGPSCFG: 'glonassnmeatype',(0-7) +QGPSCFG: 'galileonmeatype',(0,1) +QGPSCFG: 'beidounmeatype',(0-3) +QGPSCFG: 'gsvextnmeatype',(0,1) +QGPSCFG: 'gnssconfig',(0-6) +QGPSCFG: 'autogps',(0,1) OK Reference 2.1.1. AT+QGPSCFG='outport' Configure NMEA Sentences Output Port AT+QGPSCFG='outport' Configure NMEA Sentences Output Port Write Command AT+QGPSCFG='outport'[,] Response When there are two parameters: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'outport', OK EP06&EG06&EM06_GNSS_AT_Commands_Manual 8 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Reference If there is any error related to ME functionality: +CME ERROR: Parameter Configure the output port of NMEA sentences, and the configuration parameter will be automatically saved to NVRAM. 'none' Close NMEA sentence output 'usbnmea' Output via USB NMEA port 'uartdebug' Output via debug UART port Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.1.2. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA The command enables/disables acquisition of NMEA sentences via AT+QGPSGNMEA. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA Write Command Response AT+QGPSCFG='nmeasrc'[,] OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'nmeasrc', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter After being enabled, original NMEA sentences can be acquired via AT+QGPSGNMEA, and the configuration parameter will be automatically saved to NVRAM. Meanwhile, sentences are outputted via the same NMEA EP06&EG06&EM06_GNSS_AT_Commands_Manual 9 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual ports as before. 0 Disable 1 Enable Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.1.3. AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences Write Command AT+QGPSCFG='gpsnmeatype'[,] Response When there are two parameters: OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'gpsnmeatype', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Output type of GPS NMEA sentences by ORed, and the configuration parameter will be automatically saved to NVRAM. The default value is 31 which means that all the five types of sentences will be outputted. 0 Disable 1 GGA 2 RMC 4 GSV 8 GSA 16 VTG Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. EP06&EG06&EM06_GNSS_AT_Commands_Manual 10 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual 2.1.4. AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences Write Command Response AT+QGPSCFG='glonassnmeatype'[, When there are two parameters: ] OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'glonassnmeatype', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Configure output type of GLONASS NMEA sentences by ORed, and the configuration parameter will be automatically saved to NVRAM. The default value is 0. 0 Disable 1 GSV 2 GSA 4 GNS Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.1.5. AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences Write Command Response AT+QGPSCFG='galileonmeatype'[,< When there are two parameters: galileonmeatype>] OK EP06&EG06&EM06_GNSS_AT_Commands_Manual 11 / 29 Reference LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual When the second parameter is omitted, query the current setting: +QGPSCFG: 'galileonmeatype', OK If there is any error related to ME functionality: +CME ERROR: Parameter Configure output type of Galileo NMEA sentences by ORed, and the configuration parameter will be automatically saved to NVRAM. The default value is 0. 0 Disable 1 GSV Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.1.6. AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences Write Command Response AT+QGPSCFG='beidounmeatype'[,< When there are two parameters: beidounmeatype>] OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'beidounmeatype', OK Reference If there is any error related to ME functionality: +CME ERROR: EP06&EG06&EM06_GNSS_AT_Commands_Manual 12 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Parameter Configure output type of BeiDou NMEA sentences via ORed, and the configuration parameter will be automatically saved to NVRAM. The default value is 0. 0 Disable 1 GSA 2 GSV Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.1.7. AT+QGPSCFG='gsvextnmeatype' Enable/Disable Output of GSVEXT NMEA Sentences AT+QGPSCFG='gsvextnmeatype' Enable/Disable Output of GSVEXT NMEA Sentences Write Command Response AT+QGPSCFG='gsvextnmeatype'[,< When there are two parameters: gsvextnmeatype>] OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'gsvextnmeatype', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Enable/disable output of extended GSV information. Elevation/Azimuth/SNR (C/No) will be displayed as decimals when extended information is enabled, otherwise they will be displayed as integers. The configuration parameter will be automatically saved to NVRAM. The default value is 0. 0 Disable 1 Enable Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. EP06&EG06&EM06_GNSS_AT_Commands_Manual 13 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual 2.1.8. AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations Write Command Response AT+QGPSCFG='gnssconfig'[,] OK When the second parameter is omitted, query the current setting: +QGPSCFG: 'gnssconfig', OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Supported GNSS constellations GPS is always ON 0 GLONASS OFF/BeiDou OFF/Galileo OFF 1 GLONASS ON/BeiDou ON/Galileo ON 2 GLONASS ON/BeiDou ON/Galileo OFF 3 GLONASS ON/BeiDou OFF/Galileo ON 4 GLONASS ON/BeiDou OFF/Galileo OFF 5 GLONASS OFF/BeiDou ON/Galileo ON 6 GLONASS OFF/BeiDou OFF/Galileo ON Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.1.9. AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically Write Command AT+QGPSCFG='autogps'[,] Response When there are two parameters: OK When the second parameter is omitted, query the current setting: EP06&EG06&EM06_GNSS_AT_Commands_Manual 14 / 29 Reference LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual +QGPSCFG: 'autogps', OK If there is any error related to ME functionality: +CME ERROR: Parameter Enable/disable GNSS to run automatically after the module is powered on, and the configuration parameter will be automatically saved to NVRAM. The default value is 0. 0 Disable GNSS to run automatically 1 Enable GNSS to run automatically Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. NOTE The command is only valid when the GNSS works in stand-alone mode. 2.2. AT+QGPSDEL Delete Assistance Data The command is used to delete assistance data so as to operate cold start, hot start and warm start of GNSS. The command can only be executed when GNSS is turned off. After deleting the assistance data via this command, cold start of GNSS can be enforced via AT+QGPS. Hot/warm start can also be performed if the corresponding conditions are satisfied. AT+QGPSDEL Delete Assistance Data Test Command AT+QGPSDEL=? Response +QGPSDEL: (0-3) Write Command AT+QGPSDEL= OK Response OK If there is any error related to ME functionality: +CME ERROR: EP06&EG06&EM06_GNSS_AT_Commands_Manual 15 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Reference Parameter The type of GNSS assistance data to be deleted. 0 Delete all assistance data except gpsOneXTRA data. Enforce cold start after starting GNSS. 1 Do not delete any data. Perform hot start if the conditions are permitted after starting GNSS. 2 Delete some related data. Perform warm start if the conditions are permitted after starting GNSS. 3 Delete the gpsOneXTRA assistance data injected into GNSS engine. Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.3. AT+QGPS Turn on GNSS The command is used to turn on GNSS function. Currently it only supports turning on GNSS in Stand-alone mode (that is, =1). When is 0, GNSS will fix position continuously, and it can be turned off via AT+QGPSEND. When is non-zero and reaches the specified value, GNSS will be turned off automatically. AT+QGPS Turn on GNSS Test Command AT+QGPS=? Response +QGPS: (1-4),(1-255),(1-1000),(0-1000),(1-65535) Read Command Read current GNSS state AT+QGPS? Write Command AT+QGPS=[,[,[,[,]]]] OK Response +QGPS: OK Response OK If there is any error related to ME functionality: +CME ERROR: Reference EP06&EG06&EM06_GNSS_AT_Commands_Manual 16 / 29 Parameter LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual GNSS state 0 GNSS OFF 1 GNSS ON GNSS working mode 1 Stand-alone 2 MS-based 3 MS-assisted 4 Speed-optimal The maximum positioning time (unit: s), which indicates the response time of GNSS receiver while measuring the GNSS pseudo range and the upper time limit of GNSS satellite searching. It also includes the time for demodulating the ephemeris data and calculating the position. 1-30-255 Maximum positioning time Accuracy threshold of positioning. Unit: m. 1-50-1000 Number of attempts for positioning 0–1000 0 indicates continuous positioning. Non-zero values indicate the actual number of attempts for positioning. The interval time between the first and second time positioning. Unit: s. 1–65535 Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.4. AT+QGPSEND Turn off GNSS When GNSS is turned on and is 0, GNSS fixes position continuously. In this case, GNSS can be turned off compulsorily via AT+QGPSEND. When is non-zero, GNSS will be turned off automatically if the parameter reaches the specified value, and thus the command can be ignored. AT+QGPSEND Turn off GNSS Test Command AT+QGPSEND=? Execution Command AT+QGPSEND Response OK Response OK Reference If there is any error related to ME functionality: +CME ERROR: EP06&EG06&EM06_GNSS_AT_Commands_Manual 17 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Parameter Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.5. AT+QGPSLOC Acquire Positioning Information Before executing the command, GNSS must be turned on via AT+QGPS. If it fails in position fix, +CME ERROR: will be returned to indicate the corresponding situation. AT+QGPSLOC Acquire Positioning Information Test Command AT+QGPSLOC=? Response +QGPSLOC: ,,,,,,,,,, Write Command AT+QGPSLOC= OK Response +QGPSLOC: ,,,,,,,,,, OK Reference If there is any error related to ME functionality: +CME ERROR: Parameter Latitude and longitude display format 0 , format: ddmm.mmmm N/S,dddmm.mmmm E/W 1 , format: ddmm.mmmmmm N/S,dddmm.mmmmmm E/W 2 , format: (-)dd.ddddd,(-)ddd.ddddd UTC time Format: hhmmss.sss (Quoted from GPGGA sentence). Latitude If is 0: Format: ddmm.mmmm N/S (Quoted from GPGGA sentence) dd 00-89 (degree) mm.mmmm 00.0000-59.9999 (minute) N/S North latitude/South latitude EP06&EG06&EM06_GNSS_AT_Commands_Manual 18 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual If is 1: Format: ddmm.mmmmmm N/S (Quoted from GPGGA sentence) dd 00-89 (degree) mm.mmmmmm 00.000000-59.999999 (minute) N/S North latitude/South latitude If is 2: Format: (-)dd.ddddd (Quoted from GPGGA sentence) dd.ddddd -89.99999-89.99999 (degree) - South latitude Longitude If is 0: Format: dddmm.mmmm E/W (Quoted from GPGGA sentence) ddd 000-179 (degree) mm.mmmm 00.0000-59.9999 (minute) E/W East longitude/West longitude If is 1: Format: dddmm.mmmmmm E/W (Quoted from GPGGA sentence) ddd 000-179 (degree) mm.mmmmmm 00.000000-59.999999 (minute) E/W East longitude/West longitude If is 2: Format: (-)dd.ddddd Quoted from GPGGA sentence) dd.ddddd -179.99999-179.99999 (degree) - West longitude Horizontal precision: 0.5-99.9 (Quoted from GPGGA sentence). The altitude of the antenna away from the sea level (unit: m), accurate to one decimal place (Quoted from GPGGA sentence). GNSS positioning mode (Quoted from GNGSA/GPGSA sentence). 2 2D positioning 3 3D positioning Course Over Ground based on true north. Format: ddd.mm (Quoted from GPVTG sentence). ddd 000-359 (degree) mm 00-59 (minute) Speed over ground. Format: xxxx.x. Unit: km/h. Accurate to one decimal place (Quoted from GPVTG sentence). Speed over ground. Format: xxxx.x. Unit: knots. Accurate to one decimal place (Quoted from GPVTG sentence). UTC time when fixing position. Format: ddmmyy (Quoted from GPRMC sentence). Number of satellites, from 00 (The first 0 should be retained) to 12 (Quoted from GPGGA sentence). EP06&EG06&EM06_GNSS_AT_Commands_Manual 19 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.6. AT+QGPSGNMEA Acquire NMEA Sentences Before using this command, GNSS must be turned on via AT+QGPS, and set into 1 to enable acquisition of NMEA sentences via AT+QGPSGNMEA. Customers can disable sentences output via AT+QGPSCFG='gpsnmeatype'/'glonassnmeatype'/ 'galileonmeatype'/'beidounmeatype',0. If sentences output is disabled, AT+QGPSGNMEA can still be used to acquire NMEA sentences on condition that the GNSS has already acquired sentences via this command after its activation. And the sentences acquired via the command will be the last ones that have ever been acquired. AT+QGPSGNMEA Acquire NMEA Sentences Test Command AT+QGPSGNMEA=? Response +QGPSGNMEA: ('GGA','RMC','GSV','GSA','VTG','G NS') Write Command Query GGA sentence AT+QGPSGNMEA='GGA' OK Response +QGPSGNMEA: GGA sentence OK Write Command Query RMC sentence AT+QGPSGNMEA='RMC' If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: RMC sentence OK Write Command Query GSV information AT+QGPSGNMEA='GSV' If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: GSV sentence OK If there is any error related to ME functionality: +CME ERROR: EP06&EG06&EM06_GNSS_AT_Commands_Manual 20 / 29 Write Command Query GSA sentence AT+QGPSGNMEA='GSA' Write Command Query VTG sentence AT+QGPSGNMEA='VTG' Write Command Query GNS sentence AT+QGPSGNMEA='GNS' Reference LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Response +QGPSGNMEA: GSA sentence OK If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: VTG sentence OK If there is any error related to ME functionality: +CME ERROR: Response +QGPSGNMEA: GNS sentence OK If there is any error related to ME functionality: +CME ERROR: Parameter Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.7. AT+QGPSXTRA Enable gpsOneXTRA Assistance Function This command can be used to enable gpsOneXTRA Assistance function, and it will take effect immediately. AT+QGPSXTRA Enable gpsOneXTRA Assistance Function Test Command AT+QGPSXTRA=? Response +QGPSXTRA: (0,1) Read Command AT+QGPSXTRA? OK Response +QGPSXTRA: EP06&EG06&EM06_GNSS_AT_Commands_Manual 21 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Write Command AT+QGPSXTRA= Reference OK Response OK If there is any error related to ME functionality: +CME ERROR: Parameter Enable gpsOneXTRA Assistance function, and the configuration parameter will be automatically saved to NVRAM. 0 Disable gpsOneXTRA Assistance 1 Enable gpsOneXTRA Assistance Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.8. AT+QGPSXTRATIME Inject gpsOneXTRA Time This command can be used to inject gpsOneXTRA time to GNSS engine. Before using it, customers must enable gpsOneXTRA Assistance function via AT+QGPSXTRA=1 command. After activating the function, the GNSS engine will ask for gpsOneXTRA time and assistance data file. Before injecting gpsOneXTRA data file, gpsOneXTRA time must be injected first via this command. AT+QGPSXTRATIME Inject gpsOneXTRA Time Test Command AT+QGPSXTRATIME=? Response +QGPSXTRATIME: 0,,(0,1),(0,1), Write Command Inject gpsOneXTRA time AT+QGPSXTRATIME=,[,[,,]] Reference OK Response OK If there is any error related to ME functionality: +CME ERROR: EP06&EG06&EM06_GNSS_AT_Commands_Manual 22 / 29 Parameter LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Operation type 0 Inject gpsOneXTRA time Current UTC/GPS time Format: YYYY/MM/DD,hh:mm:ss. e.g. 2016/01/03,15:34:50. The type of time 0 GPS time 1 UTC time Allow or force GPS subsystem to accept the time injected 0 Allow acceptance 1 Force acceptance Uncertainty of time. Unit: ms. Default value: 3500ms. It indicates the time difference between sending a request to the SNTP server and receiving a response from the SNTP server. If the set time is less than 3.5s, it will be counted as 3.5s. Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. 2.9. AT+QGPSXTRADATA Inject a gpsOneXTRA Data File This command can be used to inject a gpsOneXTRA assistance data file to GNSS engine. Before operating this command, customers must enable gpsOneXTRA, store the valid gpsOneXTRA data file into RAM or UFS (RAM is recommended) of the mudule and inject gpsOneXTRA time to GNSS engine. After operating this command successfully, gpsOneXTRA data file can be deleted from RAM or UFS, and customers can query whether the gpsOneXTRA data is injected successfully via AT+QGPSXTRADATA?. AT+QGPSXTRADATA Inject a gpsOneXTRA Data File Test Command AT+QGPSXTRADATA=? Response +QGPSXTRADATA: Read Command Query the status of gpsOneXTRA data files AT+QGPSXTRADATA? OK Response +QGPSXTRADATA: , OK If there is any error related to ME functionality: +CME ERROR: EP06&EG06&EM06_GNSS_AT_Commands_Manual 23 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual Write Command Inject gpsOneXTRA data files AT+QGPSXTRADATA= Response OK If there is any error related to ME functionality: +CME ERROR: Reference Parameter Filename of the gpsOneXTRA data file, e.g. xtra2.bin or xtra3grc.bin. Valid time of injected gpsOneXTRA data file. Unit: min. 0 No gpsOneXTRA file or the file is overdue 1-10080 Valid time of gpsOneXTRA file Starting time of the valid time of gpsOneXTRA data file Format: YYYY/MM/DD,hh:mm:ss, e.g. 2016/01/03,15:34:50. Integer type. The error code of the operation. If it is not 0, it is the type of error. Please refer to Chapter 4 for details. EP06&EG06&EM06_GNSS_AT_Commands_Manual 24 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual 3 Examples 3.1. Turn on and off the GNSS Default arguments are used in this example to turn on GNSS. After turning on GNSS, NMEA sentences will be outputted from 'usbnmea' port by default; and GNSS can be turned off via AT+QGPSEND. AT+QGPS=1 OK //Turn on GNSS. //After turning on GNSS, NMEA sentences will be outputted from 'usbnmea' port by default. AT+QGPSLOC? //Obtain positioning information. +QGPSLOC: 061951.0,3150.7223N,11711.9293E,0.7,62.2,2,0.0,0.0,0.0,110513,09 OK AT+QGPSEND OK //Turn off GNSS. 3.2. Application of GNSS When GNSS is turned on and is set to 1, NMEA sentences can be acquired directly via AT+QGPSGNMEA. AT+QGPSCFG='nmeasrc',1 //Set to 1 to enable acquisition of NMEA sentences via AT+QGPSGNMEA. OK AT+QGPSGNMEA='GGA' //Obtain GGA sentence. +QGPSGNMEA: $GPGGA,103647.0,3150.721154,N,11711.925873,E,1,02,4.7,59.8,M,-2.0,M,,*77 OK AT+QGPSCFG='nmeasrc',0 OK AT+QGPSGNMEA='GGA' //Set to 0 to disable acquisition of NMEA sentences via AT+QGPSGNMEA. //Acquisition of NMEA sentences via AT+QGPSGNMEA was EP06&EG06&EM06_GNSS_AT_Commands_Manual 25 / 29 +CME ERROR: 507 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual disabled, and thus GGA sentences cannot be obtained. 3.3. Operation Procedures of gpsOneXTRA Assistance Function This example shows the operation procedures of gpsOneXTRA Assistance function. //If gpsOneXTRA Assistance is disabled, enable it via AT+QGPSXTRA=1, then perform the following procedures. AT+QGPSXTRA=1 OK //Enable gpsOneXTRA Assistance. //The gpsOneXTRA Assistance function is activated immediately. //If gpsOneXTRA data file is valid (query via AT+QGPSXTRADATA?), turn on GNSS engine directly. //If gpsOneXTRA data file is invalid (query via AT+QGPSXTRADATA?), then perform the following procedures. //Customers can download the gpsOneXTRA data file to PC (or MCU) from URL http://xtrapath1.izatcloud.net/xtra2.bin or other URLs listed in Chapter 1.3. AT+QFUPL='RAM:xtra2.bin',59748,60 OK AT+QGPSXTRATIME=0,'2017/09/11,15:30:30',1,1,5 OK AT+QGPSXTRADATA='RAM:xtra2.bin' OK AT+QFDEL='RAM:xtra2.bin' OK AT+QGPS=1 OK //Select a gpsOneXTRA file and upload it to module via QCOM. For more details about this command, please refer to document [2]. And for more details about QCOM tool usage and configuration, please refer to document [3]. //Inject gpsOneXTRA time to GNSS engine. //The gpsOneXTRA data file is injected to GNSS engine successfully. //Delete gpsOneXTRA data file from RAM. //Turn on GNSS engine. EP06&EG06&EM06_GNSS_AT_Commands_Manual 26 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual 4 Summary of Error Codes The indicates an error related to GNSS operation. The details about are described in the following table. Table 1: Summary of Error Codes 501 502 503 504 505 506 507 508 512 513 514 515 516 517 549 Meaning Invalid parameter(s) Operation not supported GNSS subsystem busy Session is ongoing Session not active Operation timeout Function not enabled Time information error Validity time is out of range Internal resource error GNSS locked End by E911 Not fixed now CMUX port is not opened Unknown error EP06&EG06&EM06_GNSS_AT_Commands_Manual 27 / 29 LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual 5 Appendix A References Table 2: Related Documents SN Document Name Quectel_ EP06&EG06&EM06 [1] AT_Commands_Manual [2] Quectel_QCOM_User_Guide Remark EP06&EG06&EM06 AT commands manual QCOM user guide Table 3: Terms and Abbreviations Abbreviation BeiDou Galileo GGA GLONASS GNS GNSS GPS gpsOneXTRA GSA GSV MCU ME MS Description BeiDou Navigation Satellite System Galileo Satellite Navigation System Global Positioning System Fix Data Global Navigation Satellite System Global Network Service Global Navigation Satellite System Global Positioning System An Auxiliary Positioning Technology Provided by Qualcomm GPS DOP and Active Satellites Satellites in View Micro Control Unit Mobile Equipment Mobile Station EP06&EG06&EM06_GNSS_AT_Commands_Manual 28 / 29 NMEA NVRAM PC RAM RMC SNR SNTP TTFF UART URL USB UTC VTG LTE Module Series EP06&EG06&EM06 GNSS AT Commands Manual National Marine Electronics Association Non-Volatile Random Access Memory Private Computer Random Access Memory Recommended Minimum Navigation Information Signal Noise Ratio Simple Network Time Protocol Time to First Fix Universal Asynchronous Receiver & Transmitter Uniform Resource Locator Universal Serial Bus Universal Time Code Track Made Good and Ground Speed EP06&EG06&EM06_GNSS_AT_Commands_Manual 29 / 29

WCDMA&LTE Audio Design Note UMTS/HSPA/LTE Module Series Rev. WCDMA&LTE_Audio_Design_Note_V1.1 Date: 2017-01-06 www.quectel.com UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2017. All rights reserved. WCDMA&LTE_Audio_Design_Note Confidential / Released 1 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note About the Document History Revision 1.0 1.1 Date 2016-12-02 Author Yeoman CHEN/ Jun WU CQouneficdteenl tial 2017-01-06 JunWU Description Initial 1. Added some descriptions, notes and an example to explain the differences in audio setting and audio AT commands between EC2x and UCxx modules (Chapter 5 and Chapter 6) 2. Modified the descriptions of AT commands AT+QAUDCFG='digital/dlgain' and AT+QAUDCFG='innercodec/dlgain' (Chapter 6.10 and Chapter 6.11) WCDMA&LTE_Audio_Design_Note Confidential / Released 2 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 5 Figure Index .............................................................................................................................................. 6 1 Introduction ....................................................................................................................................... 7 2 PCM Characteristics ......................................................................................................................... 8 3 Audio Circuit Design....................................................................................................................... 12 3.1. PCM Design with NAU8814.................................................................................................. 12 4 5 3.2. PCM Design with ALC5616 .................................................................................................. 13 3.3. PCM Design with MAX9860 ................................................................................................. 13 3.4. PCM Design with TLV320AIC3104 ....................................................................................... 14 3.5. PCM Design with MCU ......................................................................................................... 15 l 3.5.1. Module Works in PCM Master Mode ........................................................................... 16 te 3.5.2. Module Works in PCM Slave Mode ............................................................................. 16 3.6. Microphone Interface Design ................................................................................................ 18 c l 3.7. Receiver Interface Design .................................................................................................... 18 3.8. Earphone Interface Design ................................................................................................... 19 ue tia 3.9. Speaker Interface Design ..................................................................................................... 19 Design Considerations ................................................................................................................... 20 Q n 4.1. Power Supply for PCM Codecs ............................................................................................ 20 4.2. Suggestions for Audio Circuit Layout .................................................................................... 20 e 4.3. TDD Noise Solution .............................................................................................................. 21 4.4. Suggestions for Mechanical Design ..................................................................................... 21 fid 4.5. Components of Speaker ....................................................................................................... 24 4.6. Components of Microphone.................................................................................................. 25 n Audio Modes.................................................................................................................................... 27 5.1. Speech Call in Handset Mode .............................................................................................. 27 o 5.2. Speech Call in Headset Mode .............................................................................................. 28 C 5.3. Speech Call in Handsfree Mode ........................................................................................... 28 6 Audio AT Commands...................................................................................................................... 29 6.1. AT+QDAI Digital Audio Interface Configuration .................................................................. 29 6.2. AT+QIIC I2C Read and Write ............................................................................................. 31 6.3. AT+CLVL Loudspeaker Volume Level Selection ................................................................ 32 6.4. AT+QMIC Set Uplink Gains of MIC .................................................................................... 33 6.5. AT+CMUT Mute Control ..................................................................................................... 34 6.6. AT+QAUDMOD Set Audio Mode........................................................................................ 34 6.7. AT+QSIDET Set the Side Tone Gain in Current Mode ....................................................... 36 6.8. AT+QAUDLOOP Enable Audio Loop Test .......................................................................... 36 WCDMA&LTE_Audio_Design_Note Confidential / Released 3 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 6.9. 6.10. 6.11. AT+QAUDPATH Set Audio Output Path ............................................................................. 37 AT+QAUDCFG='digital/dlgain' Set Downlink Gain for ALC5616 ....................................... 38 AT+QAUDCFG='innercodec/dlgain' Set Downlink Digital Gain for internal codec ............ 39 7 Appendix A References .................................................................................................................. 41 CQouneficdteenl tial WCDMA&LTE_Audio_Design_Note Confidential / Released 4 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Table Index TABLE 1: PIN DEFINITION ................................................................................................................................. 8 TABLE 2: I/O CHARACTERISTICS..................................................................................................................... 8 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 41 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 41 CQouneficdteenl tial WCDMA&LTE_Audio_Design_Note Confidential / Released 5 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Figure Index FIGURE 1: PCM INTERFACE TIMING IN PRIMARY MODE ............................................................................. 9 FIGURE 2: PCM INTERFACE TIMING IN AUXILIARY MODE ......................................................................... 10 FIGURE 3: PERIPHERAL, MODULE AND CODEC CONNECTION DIAGRAM .............................................. 10 FIGURE 4: PCM APPLICATION WITH NAU8814............................................................................................. 12 FIGURE 5: PCM APPLICATION WITH ALC5616.............................................................................................. 13 FIGURE 6: PCM APPLICATION WITH MAX9860............................................................................................. 14 FIGURE 7: PCM APPLICATION WITH TLV320AIC3104 .................................................................................. 15 FIGURE 8: REFERENCE DESIGN WHEN MODULE WORKS IN PCM MASTER MODE .............................. 16 FIGURE 9: REFERENCE DESIGN WHEN MODULE WORKS IN PCM SLAVE MODE.................................. 17 FIGURE 10: MICROPHONE INTERFACE DESIGN ......................................................................................... 18 FIGURE 11: RECEIVER INTERFACE DESIGN................................................................................................ 18 FIGURE 12: EARPHONE INTERFACE DESIGN.............................................................................................. 19 FIGURE 13: SPEAKER INTERFACE DESIGN (WITH AMPLIFIER CIRCUIT)................................................. 19 l FIGURE 14: AUDIO CHANNEL LAYOUT EXAMPLE ....................................................................................... 20 FIGURE 15: FIVE ECHO PATHS ...................................................................................................................... 22 te FIGURE 16: RECOMMENDED MICROPHONE SOCKET DESIGN ................................................................ 22 FIGURE 17: SPEAKER SOCKET DESIGN ...................................................................................................... 23 c l FIGURE 18: SPEAKER FREQUENCY RESPONSE ........................................................................................ 24 CQounefidentia FIGURE 19: SPEAKER THD............................................................................................................................. 25 WCDMA&LTE_Audio_Design_Note Confidential / Released 6 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 1 Introduction The document is intended for engineers and customers who are using the audio interface (PCM interface) of Quectel modules. It introduces how to design and use the PCM interface in details in the following chapters. This document is applicable to Quectel UCxx and EC2x modules. In this document, UCxx includes UC15 and UC20, and EC2x includes EC20, EC21, EC25 and EC20 R2.0. CQouneficdteenl tial For the audio design of Quectel UGxx (UG95 & UG96) modules, please refer to document [4]. WCDMA&LTE_Audio_Design_Note Confidential / Released 7 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 2 PCM Characteristics The PCM interfaces of Quectel UCxx and EC2x modules support the following working modes:  Primary mode (short frame synchronization)  Auxiliary mode (long frame synchronization) These modules support 8-bit a-law and μ-law, and also 16-bit linear data formats. They can work as either the master or the slave in primary mode, and only the master in auxiliary mode. The following tables show the pin definition and electrical characteristics of PCM interface. tel Table 1: Pin Definition c l Pin Name I/O ue tia PCM_IN DI PCM_OUT DO Q n PCM_SYNC IO e PCM_CLK IO fid I2C_SCL OD n I2C_SDA OD Description PCM data input PCM data output PCM data frame sync signal, output as master and input as slave PCM data bit clock, output as master and input as slave I2C serial clock I2C serial data Co Table 2: I/O Characteristics Parameter VIL VIH VOL VOH Description Low-level input voltage. High-level input voltage. Low-level output voltage. High-level output voltage. Min Max Unit -0.3 0.35*VDD_EXT V 0.65*VDD_EXT VDD_EXT+0.3 V 0 0.45 V VDD_EXT-0.45 VDD_EXT V WCDMA&LTE_Audio_Design_Note Confidential / Released 8 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note NOTE VDD_EXT is the power source for modules’ GPIO group. In primary mode, the data is sampled on the falling edge of the PCM_CLK and transmitted on the rising edge. The PCM_SYNC falling edge represents the MSB. In this mode, PCM_CLK supports 128, 256, 512, 1024 and 2048KHz for different speech codecs, but UC15 supports 2048KHz only in primary mode. The figure below shows the timing relationship of PCM interface with 8KHz PCM_SYNC and 2048KHz PCM_CLK in primary mode. PCM_CLK 1 2 125us 255 256 tel PCM_SYNC uec tial PCM_OUT Q en PCM_IN MSB MSB LSB LSB MSB MSB nfid Figure 1: PCM Interface Timing in Primary Mode o In auxiliary mode, the data is also sampled on the falling edge of PCM_CLK and transmitted on the rising C edge. But the PCM_SYNC rising edge represents the MSB. In this mode, the PCM interface only acts as the master with a 128KHz PCM_CLK and an 8KHz, 50% duty cycle PCM_SYNC. The following figure shows the timing relationship of PCM interface in auxiliary mode. WCDMA&LTE_Audio_Design_Note Confidential / Released 9 / 42 PCM_CLK 12 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 125us 15 16 PCM_SYNC MSB LSB PCM_OUT MSB LSB PCM_IN tel Figure 2: PCM Interface Timing in Auxiliary Mode c l Both the clock and mode can be configured by AT commands, and the default configuration is the master ue tia mode using short frame synchronization format with 2048KHz PCM_CLK and 8KHz PCM_SYNC. Additionally, the module firmware has integrated the configuration on some popular audio codecs (such as NAU8814, ALC5616, etc.) which can be realized through the I2C interface. For more details, please Q n refer to document [3] for the command AT+QDAI. e For peripherals, the module works in PCM master mode, and the following figure illustrates the fid connection among the peripheral, module, and the codec. n CLK Co UART 0R_NM R1 PCM_CLK PCM_SYNC UART PCM_OUT PCM_IN MICBIAS BCLK LRCLK DACDAT ADCDAT MIC+ MIC- 4.7K 4.7K BIAS USB USB I2C_SCL I2C_SDA Rs MCLK SCL SDA SPK+ SPK- Peripheral Module VDD_EXT CODEC NM Figure 3: Peripheral, Module and Codec Connection Diagram WCDMA&LTE_Audio_Design_Note Confidential / Released 10 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note NOTES 1. The communication between module and peripheral can be realized through the UART or USB interface. 2. The MCLK of codec can be powered by the peripheral or an external XTAL, if it is needed in the audio codec. 3. It is recommended to reserve an RC (R=22Ω, C=22pF) circuit on the PCM lines, especially for PCM_CLK. 4. EC20’s 8-bit a-law and μ-law are still under development. CQouneficdteenl tial WCDMA&LTE_Audio_Design_Note Confidential / Released 11 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 3 Audio Circuit Design Audio codecs NAU8814, ALC5616, MAX9860 and TLV320AIC3104 have been approved for PCM application. The following sub-chapters will show some audio circuit designs with these codecs. 3.1. PCM Design with NAU8814 The following figure shows the PCM application with NAU8814 from Nuvoton (http://www.nuvoton.com), and an I2C interface is available in the design for codec configuration. CQouneficdteenl tial Figure4:PCMApplicationwithNAU8814 NOTES s 1. The RC filter circuit (R=22 ohm, C=22pF) needs to be installed on PCM_CLK line. 2. VDD_3V3 needs to be powered externally. 3. Set AT+QDAI=2 to choose NAU8814. For more details please refer to document [3]. WCDMA&LTE_Audio_Design_Note Confidential / Released 12 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 3.2. PCM Design with ALC5616 The following figure shows the PCM application with ALC5616 from Realtek (http://www.realtek.com.tw), and an I2C interface is available in the design for codec configuration. Quectenl tial Figure 5: PCM Application with ALC5616 fide NOTES 1. VDD_3V3 and VDD_1V8 need to be powered externally. Please pay attention to the power-on n sequence of ALC5616. For more details, please refer to its datasheet. 2. The RC filter circuit (R=22 ohm, C=22pF) should be installed on PCM_CLK line. Co 3. Set AT+QDAI=3 to choose ALC5616. For more details please refer to document [3]. 3.3. PCM Design with MAX9860 The following figure shows the PCM application with MAX9860 from Maxim (http://www.maxim-ic.com), and an I2C interface is available in the design for codec configuration. WCDMA&LTE_Audio_Design_Note Confidential / Released 13 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note ctel l Figure 6: PCM Application with MAX9860 ue tia NOTES Q n 1. The RC filter circuit (R=22 ohm, C=22pF) should be installed on PCM_CLK line. 2. Set AT+QDAI=4 to choose MAX9860. For more details please refer to document [3]. The firmware e of EC2x modules has not integrated the configuration on MAX9860 by now. fid 3. MCLK should be powered externally. n 3.4. PCM Design with TLV320AIC3104 Co The following figure shows the PCM application with TLV320AIC3104 from Texas Instrument (http://www.ti.com.cn), and an I2C interface is available in the design for codec configuration. WCDMA&LTE_Audio_Design_Note Confidential / Released 14 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note uectel tial Figure 7: PCM Application with TLV320AIC3104 Q en NOTES fid 1. The RC filter circuit (R=22ohm, C=22pF) should be installed on PCM_CLK line. 2. VDD_3V3 and VDD_1V8 need to be powered externally. Please pay attention to the power-on n sequence of TLV320AIC3104. For more details, please refer to its datasheet. Co 3. Set AT+QDAI=5 to choose TLV320AIC3104. For more details please refer to document [3]. 3.5. PCM Design with MCU UCxx and EC2x modules can work in either PCM master mode or slave mode to communicate with MCU.  Primary mode (short frame synchronization, works as both master and slave)  Auxiliary mode (long frame synchronization, works as master only) WCDMA&LTE_Audio_Design_Note Confidential / Released 15 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note They provide a 1.8V PCM interface, but 2.6V PCM interface for UC15. A level translator should be used if customers’ application is equipped with a 3.3V UART interface. The level translator TXS0104 provided by Texas Instrument is recommended. 3.5.1. Module Works in PCM Master Mode In PCM master mode, UCxx and EC2x modules support both short and long frame synchronization. The data is sampled on the falling edge of the PCM_CLK and transmitted on the rising edge. The PCM_SYNC falling edge represents the MSB. PCM_CLK supports 128, 256, 512, 1024 and 2048KHz, and PCM_SYNC supports 8KHz. ctel l Codec PCM_CLK PCM_SYNC PCM_OUT PCM_IN MCU A1 B1 A2 B2 A3 B3 A4 B4 Translator PCM_CLK PCM_SYNC PCM_IN PCM_OUT Module ue tia Figure 8: Reference Design When Module Works in PCM Master Mode Q n The modules support 8-bit a-law and μ-law, and also 16-bit linear data formats. The PCM interface can be e configured via AT+QDAI command, and an example is shown below. fid Example AT+QDAI=1,0,0,4,0 n . Co OK //PCM master mode, short frame synchronization, PCM_CLK=2.048MHz, 16bit data 3.5.2. Module Works in PCM Slave Mode When the module works in PCM slave mode, the data is sampled on the falling edge of the PCM_CLK and transmitted on the rising edge. The PCM_SYNC falling edge represents the MSB. PCM_CLK supports 128, 256, 512, 1024 and 2048KHz, and PCM_SYNC supports 8KHz. WCDMA&LTE_Audio_Design_Note Confidential / Released 16 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Codec PCM_CLK PCM_SYNC PCM_OUT PCM_IN MCU A1 B1 A2 B2 A3 B3 A4 B4 Translator PCM_CLK PCM_SYNC PCM_IN PCM_OUT Module Figure 9: Reference Design When Module Works in PCM Slave Mode The modules support 16-bit linear data formats in PCM slave mode. The PCM interface can be configured via AT+QDAI command, and an example is shown below. l Example te AT+QDAI=1,1,0,4,0 c l OK //PCM slave mode, short frame synchronization, PCM_CLK=2.048MHz, 16bit data. ue tia NOTES Q n 1. It is recommended to reserve an RC (R=22 ohm, C=22pF) circuit on the PCM lines, especially for e PCM_CLK. Confid 2. UC15 and EC20 do not support PCM slave mode presently. WCDMA&LTE_Audio_Design_Note Confidential / Released 17 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 3.6. Microphone Interface Design Close to Microphone Differential layout 10pF 33pF MIC_P 0R 10pF 33pF MIC_N 0R Electret 10pF 33pF Microphone tel Figure 10: Microphone Interface Design Quec ential 3.7. Receiver Interface Design Close to Receiver nfid SPK_P Co SPK_N Differential layout 0R 10pF 10pF 0R 33pF 33pF 32Ω 10pF 33pF Figure 11: Receiver Interface Design WCDMA&LTE_Audio_Design_Note Confidential / Released 18 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 3.8. Earphone Interface Design The following figure shows the single-ended application for earphone interface design. MIC_N MIC_P Differential layout 0R 4.7uF Close to Socket 10pF 33pF ctel l SPK_P 0R 22uF 10pF 33pF Earphone 3 4 2 1 32Ω Figure 12: Earphone Interface Design Que ntia 3.9. Speaker Interface Design e If an 8Ω speaker is applied, it is recommended to add an audio amplifier. fidClose to Speaker Con SPK_P Amplifier circuit Ri 10pF 33pF Ri SPK_N 10pF 33pF 8Ω 10pF 33pF Figure 13: Speaker Interface Design (with Amplifier Circuit) WCDMA&LTE_Audio_Design_Note Confidential / Released 19 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 4 Design Considerations 4.1. Power Supply for PCM Codecs Different PCM codecs have different supply voltages. Hence, it is recommended to power a PCM codec with a dedicated LDO, and do not share this power supply with other circuits. l 4.2. Suggestions for Audio Circuit Layout te Power supply ripple, unbalanced ground and RF burst have negative effects to audio circuit layout. In c l order to avoid them, the layout of MICP_PCM/MICN_PCM and SPKP_PCM/SPKN_PCM must meet the rule of differential signal. Moreover, these two pairs of signals should be separated from each other ue tia through ground shielding on not only upper and lower layers but also right and left sides, to avoid echo CQonfiden from SPK signal to MIC signal. The following figure shows an example. Figure 14: Audio Channel Layout Example WCDMA&LTE_Audio_Design_Note Confidential / Released 20 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 4.3. TDD Noise Solution It is important to avoid or reduce TDD noise in audio circuit design and layout. This sub-chapter provides some suggestions for TDD noise reduction or elimination. 1. Different capacitors have their own self-resonant frequencies due to different fabrication processes and materials. Generally, a 33pF capacitor (0603 package) is recommended to be used for filtering GSM900 interference and 10pF capacitor (0603 package) for filtering DCS1800 interference on the power and analog audio signal lines. It is strongly recommended to add the two capacitors (10pF and 33pF) near the electret-microphone in handset and hands-free applications. These two capacitors could largely suppress coupling TDD noise from RF interference. 2. 3. 4. 5. 6. 7. The capacitors should be placed close to audio components or audio interface, and the layout must be short. l Ground shielding area should be as large as possible to reduce the ground impedance and improve grounding performance. te Reduce power supply voltage ripple, especially the power supply in audio circuits. This can be c l achieved through using a wide wire for the layout between power source (like adapter interface, ue tia battery connector, or LDO output pin) and audio power supply. Good antenna matching is also important for reducing power ripple. The filtering capacitors and ESD protection devices should be connected to the main digital ground. Q n Separate the analog ground from the digital ground while routing, and then connect them at a single e point on the PCB with a 0 ohm resistor, so as to reduce digital interference and background noise. fid The antenna must be stay away from audio components and the layout of audio circuit. Keep a distance of at least 5cm between the antenna and the microphone. n The layout of power supply must be stay away from the audio components and layout, and cannot be Co parallel. 4.4. Suggestions for Mechanical Design It is important to consider how to suppress echo in the equipment with hands-free function or in an application where the microphone and the speaker are very close to each other. The mechanical structure design has significant impact on echo issue. If it is not properly designed, the echo suppressing arithmetic in software will not be able to make up the echo issue caused by bad mechanical structure, and even force to redesign. WCDMA&LTE_Audio_Design_Note Confidential / Released 21 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note The echo issue could be generated from several paths as shown in the figure below. ctel l Figure 15: Five Echo Paths ue tia In these five paths, the internal air-path and direct air-path are the primary influential factors. Other three Q n factors (vibrations through casework, vibrations through PCB, distant echoes) are the secondary ones. e How to deal with the echo generated from internal air-path? fid Separating microphone from internal space of chassis by foam or rubber ring can effectively suppress the Con inner echo interference. The figure below shows a recommended design for microphone socket. Figure 16: Recommended Microphone Socket Design WCDMA&LTE_Audio_Design_Note Confidential / Released 22 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note NOTE The best installation way of microphone socket is to encase microphone by silicone cover except for the front cavity, and design a cylindrical hole whose center is the exit hole of the chassis. Also, make sure the microphone with silicone cover just fit the cylindrical hole, so as to only let voice enter into microphone from the exit hole rather than the leak of chassis interior. Certain air space room should be reserved in the front cavity of microphone as it is necessary for good microphone performance. The following figure shows a recommended design for speaker socket. Quecteenl tial Figure 17: Speaker Socket Design fid A good way to suppress the internal echo path is to seal the rear cavity of receiver, which is usually n expensive. The rear cavity of receiver and speaker is important for good voice quality. A sealed rear cavity with sufficient space could produce a good voice output. An 8Ω speaker is often big and thus it is difficult o to give an independently sealed rear cavity for it. However, sealing microphone socket in chassis is C always useful for internal echo suppressing. The microphone socket and speaker socket should be designed as far as possible. If there is any unavoidable leak hole, keep it far away from the microphone. If the leak hole is close to the microphone, the voice coming from the hole could be picked up by microphone, and then leads to echo at the far end. If the leak hole is close to the speaker, the output voice quality could be aggravated at a certain extent. WCDMA&LTE_Audio_Design_Note Confidential / Released 23 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 4.5. Components of Speaker Speakers and receivers with higher sensitivity, flatter frequency response, less THD and impedance of 32Ω (receiver), 16Ω (receiver) or 8Ω (speaker) are recommended. These technical data are often shown in the datasheet of the speaker and receiver. For a speaker, its frequency response and THD performance can be tested by a speaker test system. The speaker frequency response and THD are shown in the following two figures. CQouneficdteenl tial Figure 18: Speaker Frequency Response NOTE  Horizontal axis: frequency  Longitudinal axis: loudness (dB) WCDMA&LTE_Audio_Design_Note Confidential / Released 24 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Quecteenl tial Figure19:SpeakerTHD fid NOTES n 1. Horizontal axis: frequency o Longitudinal axis: distortion (%) C 2. In the above two figures, the three colors represent products of three different vendors. Through comprehensive comparison, the green one performs the best, the blue one is the second, and the red one is the worst. 4.6. Components of Microphone It is recommended to use an electret microphone with a sensitivity of -42±3dB/Pa @2V (not less than -44±3dB) and impedance of 2.2Kohm. If RF TDD noise is detected at the microphone, please contact the WCDMA&LTE_Audio_Design_Note Confidential / Released 25 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note microphone vendor for products with better RF suppression capability. Furthermore, the microphone channel circuit can be optimized to decrease TDD noise at microphone side. CQouneficdteenl tial WCDMA&LTE_Audio_Design_Note Confidential / Released 26 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 5 Audio Modes There are three kinds of common audio modes: handset, headset and handsfree. AT+QAUDMOD is used to choose audio modes. For each mode, there are some default settings, such as AT+CLVL, AT+QSIDET, and AT+QMIC. If the audio performance is not good and AT+QAUDMOD command has been set, the following steps can be applied to tune the audio settings: Step 1: Set AT+CLVL to tune downlink volume. Step 2: Set AT+QMIC to tune uplink volume. l Step 3: If the downlink volume is a little low or high, and AT+CLVL has been set, please use AT+QRXGAIN (EC2x modules)/AT+QAUDCFG='digital/dlgain' (UCxx modules) to tune it. For te uplink volume, AT+QMIC can be used. Step 4: If the recommended codec is used, customers can use AT+QAUDCFG to tune the volume of c l recommended codec. ue tia Step 5: Set AT+QSIDET to tune side tone. Step 6: If there is echo or noise left, please use AT+QEEC to tune EEC. Q n NOTES e 1. Please do not set the volume too high, otherwise it will influence EEC and NR. fid 2. AT+QAUDMOD must be set before using other commands. The following sub-chapters provide some examples which show how to tune the audio settings in different Con audio modes. 5.1. Speech Call in Handset Mode The default mode is handset mode. AT+QAUDMOD=0 OK AT+CLVL=3 OK //=0 means handset mode is selected. //Tuning downlink volume WCDMA&LTE_Audio_Design_Note Confidential / Released 27 / 42 AT+QMIC= 25905,14567 OK AT+QSIDET=1298 OK UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note //Tuning uplink volume //Tuning side tone 5.2. Speech Call in Headset Mode Set AT+QAUDMOD=1 to select headset mode. AT+QAUDMOD=1 OK AT+CLVL=2 tel OK AT+QMIC=25905,14567 c l OK ue tia AT+QSIDET=0 OK //=1 means headset mode is selected. //Tuning downlink volume //Tuning uplink volume //Tuning side tone Q fiden 5.3. Speech Call in Handsfree Mode Set AT+QAUDMOD=2 to select handsfree mode. This mode is always used for vehicle-mounted devices. n AT+QAUDMOD=2 //=2 means handsfree mode is selected. Co OK AT+CLVL=4 //Tuning downlink volume OK AT+QMIC=25905,14567 //Tuning uplink volume OK AT+QSIDET=0 //Tuning side tone OK WCDMA&LTE_Audio_Design_Note Confidential / Released 28 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 6 Audio AT Commands This chapter will introduce the common audio AT commands. For more other AT commands details, refer to document [3]. 6.1. AT+QDAI Digital Audio Interface Configuration The command is used to configure the digital audio interface. When =1, customers can define the PCM mode (master/slave mode) by themselves. When =2 and the external codec chip linked with l PCM interface is the NAU8814 model which is configurable through the I2C, the module can be used te directly and set by the default configurations. When =3 and the external codec chip linked with PCM interface is the ALC5616 model which is configurable through the I2C, the module can also be used c l directly and set by the default configurations. ue tia AT+QDAI Digital Audio Interface Configuration Test Command AT+QDAI=? Response +QDAI: (1-3),(0,1),(0,1),(0-5),(0-2) Q en Read Command fid AT+QDAI? OK Response +QDAI: [,,,,] n Write Command AT+QDAI=[,,,[,]] OK Response OK ERROR Maximum Response Time 300ms Parameter 1 Digital PCM output (customer-defined) 2 Analog output (for the default audio codec NAU8814). 3 Analog output (for the default audio codec ALC5616). 0 Master mode WCDMA&LTE_Audio_Design_Note Confidential / Released 29 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 1 Slave mode 0 Primary mode (short-frame synchronization) 1 Auxiliary mode (long-frame synchronization) 0 128K 1 256K 2 512K 3 1024K 4 2048K 5 4096K 0 16-bit linear 1 8-bit a-law 2 8-bit μ-law NOTES 1. Configuration of will be saved to NV immediately by default. l 2. The PCM interface supports both master and slave mode under short frame synchronization, and only master mode under long frame synchronization. te 3. When short frame synchronization and master mode are selected, PCM_CLK supports 256K~4096K c l clock frequency. If long frame synchronization and master mode are selected, only 128K clock frequency is supported. ue tia 4. If slave mode is selected, then PCM_CLK and PCM_SYNC must be provided for modules. 5. When NAU8814 or ALC5616 is selected, please do not input any other parameters. 6. A-law & μ-law are not supported by EC2x modules. Q en Example fid AT+QDAI=? //Query the range. +QDAI: (1-3),(0,1),(0,1),(0-5),(0-2) n OK AT+QDAI? Co +QDAI: 1,0,0,4,0 //Query the current interface configuration. OK AT+QDAI=1,1,0,4,1 //Set PCM interface to slave short-frame synchronization mode, PCM format 8-bit a-law. OK AT+QDAI=2 //Select NAU8814. OK AT+QDAI=3 //Select ALC5616. OK WCDMA&LTE_Audio_Design_Note Confidential / Released 30 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 6.2. AT+QIIC I2C Read and Write The command is used to configure the codec via I2C interface. AT+QIIC I2C Read and Write Test command AT+QIIC=? Response +QIIC: (0-1),(0-FF),,[,] OK Read command Response AT+QIIC? +QIIC: Execute command AT+QIIC l Write command te AT+QIIC=,,,[,] OK Response ERROR Response OK Response +QIIC: ue tia OK Q n Parameter fide n Co 0 1 0-0xFF 0-0xFF 1-2 0-0xFFFF Write command Read command Device address Register address Read/write bytes Data value NOTES 1. Only 7bit device address is supported presently. 2. The parameters are hexadecimal, and there are some differences between UCxx and EC2x modules in command format:  The device address should be shifted one bit to the left for UCxx modules, and this is not required for EC2x modules;  There is a need to add a prefix '0x' to the parameters of EC2x modules. WCDMA&LTE_Audio_Design_Note Confidential / Released 31 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Example AT+QIIC=0,0x18,0x00,1,0x00 OK //This command is used for EC2x modules, and the module writes 1byte data 0x00 to device. The device address is 0x18, and the register address is 0x00. AT+QIIC=0,30,00,1,00 OK //This command is used for UCxx modules, and the module writes 1byte data 0x00 to device. The device address is 0x18, and the register address is 0x00. 6.3. AT+CLVL Loudspeaker Volume Level Selection The command is used to select the volume level of the internal loudspeaker of Quectel UCxx and EC2x l modules. te AT+CLVL Loudspeaker Volume Level Selection c l Test Command AT+CLVL=? Response +CLVL: (list of supported s) ue tia ReadCommand Q n AT+CLVL? OK Response +CLVL: fide Write Command AT+CLVL= OK Response OK Con Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms Reference 3GPP TS 27.007 Parameter For UCxx modules: Integer type, value (0-3-7) with manufacturer specific range (smallest value represents the lowest sound level). For EC2x modules: WCDMA&LTE_Audio_Design_Note Confidential / Released 32 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Integer type, value (0-3-5) with manufacturer specific range (smallest value represents the lowest sound level). NOTE The parameter will not be saved. 6.4. AT+QMIC Set Uplink Gains of MIC The command is used to set the uplink gains of microphone. AT+QMIC Set Uplink Gains of MIC Test Command l AT+QMIC=? Response +QMIC: (1),(0-65535),(0-65535) cte l ReadCommand AT+QMIC? OK Response +QMIC: ,, Que ntia WriteCommand AT+QMIC=,[,] OK Response OK ERROR fid Maximum Response Time 300ms n Parameter Co Numeric type, reserved, set to 1. This parameter is invalid for EC2x modules. Numeric type, indicates uplink codec gain, range: 0-65535. Default value might be different in different audio modes. This parameter is invalid for UC20 module. Numeric type, indicates uplink digital gain, range: 0-65535. Default value might be different in different audio modes. NOTE These parameters will not be saved. WCDMA&LTE_Audio_Design_Note Confidential / Released 33 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 6.5. AT+CMUT Mute Control The command is used to enable and disable the uplink voice muting during a voice call. AT+CMUT Mute Control Test Command AT+CMUT=? Response +CMUT: (list of supporteds) OK Read Command Response AT+CMUT? +CMUT: Write Command AT+CMUT= ctel l Maximum Response Time Reference ue tia 3GPPTS27.007 Q n Parameter e 0 fid 1 Mute OFF Mute ON OK Response OK If error is related to ME functionality: +CME ERROR: 300ms NOTES n 1. This command is valid only during the call. Co 2. This parameter will not be saved. 6.6. AT+QAUDMOD Set Audio Mode The command is used to set the audio mode required for the connected device. AT+QAUDMOD Set Audio Mode Test Command AT+QAUDMOD=? Response For UC20 & EC2x modules: WCDMA&LTE_Audio_Design_Note Confidential / Released 34 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note +QAUDMOD: (0-2) For UC15 module: +QAUDMOD: (0-8) Read command AT+QAUDMOD? OK Response +QAUDMOD: OK Write Command AT+QAUDMOD= Response OK Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms tel Parameter c l CQounefidentia For UC20 & EC2x modules: Numeric type, indicates the current configured audio mode. 0 Echo canceller, noise suppressor, digital gain and calibration parameter for Handset 1 Echo canceller, noise suppressor, digital gain and calibration parameter for Headset 2 Echo canceller, noise suppressor, digital gain and calibration parameter for Speaker For UC15 module: Numeric type, indicates the current configured audio mode. 0 Handset mode. 1 Headset mode. 2 Hands free kit mode. 3 Analog hands free kit mode. 4 Loudspeaker mode. 5 AUX PCM Handset mode. 6 AUX PCM Headset mode. 7 AUX PCM Loudspeaker mode. 8 Bluetooth headset mode. NOTE The parameter will not be saved. WCDMA&LTE_Audio_Design_Note Confidential / Released 35 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 6.7. AT+QSIDET Set the Side Tone Gain in Current Mode The command is used to set the side tone gain value of the current mode. AT+QSIDET Set the Side Tone Gain in Current Mode Test Command AT+QSIDET=? Response +QSIDET: (0-65535) OK Read Command Response AT+QSIDET? +QSIDET: Write Command AT+QSIDET= tel Maximum Response Time OK Response OK ERROR 300ms uec tial Parameter Q n Numeric type, indicates the configured side tone gain in current mode. Range: 0-65535. Default value might be different in different audio modes. e NOTE fid The parameter will not be saved. Con 6.8. AT+QAUDLOOP Enable Audio Loop Test The command is used to enable audio loop test. AT+QAUDLOOP Enable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (0,1),(0-2) OK WCDMA&LTE_Audio_Design_Note Confidential / Released 36 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Read Command AT+QAUDLOOP? Response +QAUDLOOP: , Write Command AT+QAUDLOOP=[,] OK Response OK ERROR Maximum Response Time 300ms Parameter ctel l Numeric type, to enable or disable audio loop test. 0 Disable audio loop test 1 Enable audio loop test Numeric type, indicates the test path. This parameter is intended for UC15 module only. 0 MIC1 & SPEAKER1 1 MIC2 & SPEAKER2 2 AUX PCM ue tia NOTE These parameters will not be saved. Q fiden 6.9. AT+QAUDPATH Set Audio Output Path n The command is used to set the current audio output path which can be MIC&SPEAKER or AUX PCM. o AT+QAUDPATH Set Audio Output Path C Test Command Response AT+QAUDPATH=? +QAUDPATH: (0-2) Read Command AT+QAUDPATH? OK Response +QAUDPATH: OK WCDMA&LTE_Audio_Design_Note Confidential / Released 37 / 42 Write Command AT+QAUDPATH= Maximum Response Time Response OK ERROR 300ms UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note Parameter Numeric type, indicates the configured output path. 0 MIC1&SPEAKER1 1 MIC2&SPEAKER2 2 AUX PCM NOTES l 1. The parameter will not be saved. 2. This command is intended for UCxx modules only. uecte tial 6.10. AT+QAUDCFG='digital/dlgain' Set Downlink Digital Gain The command is used to set downlink digital gain level. Q n AT+QAUDCFG='digital/dlgain' Set Downlink Digital Gain e Test Command nfid AT+QAUDCFG=? Response …… +QAUDCFG: 'digital/dlgain', …… OK Write Command Co AT+QAUDCFG='digital/dlgain'[,] Response If configuration parameters are omitted (+QAUDCFG='digital/dlgain'), return the current configuration: +QAUDCFG: 'digital/dlgain', OK If configuration parameters are entered: OK ERROR If error is related to ME functionality: WCDMA&LTE_Audio_Design_Note Confidential / Released 38 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note +CME ERROR: Parameter Numeric type, indicates the downlink digital gain level. Range: 0-10000. Default value might be different in different audio modes NOTES 1. The parameter will not be saved. 2. This command is intended for UCxx modules only. l Example AT+QAUDCFG='digital/dlgain',8000 //Set downlink digital gain to 8000. cte l OK ue tia 6.11. AT+QAUDCFG='innercodec/dlgain' Set Downlink Digital Gain for Q n Internal Codec fide The command is used to set the downlink digital gain level for internal codec. AT+QAUDCFG='innercodec/dlgain' Set Downlink Digital Gain for Internal Codec n Test Command Co AT+QAUDCFG=? Response …… +QAUDCFG: 'innercodec/dlgain', …… OK Write Command AT+QAUDCFG='innercodec/dlgain'[,] Response If configuration parameters are omitted (+QAUDCFG='innercodec/dlgain'), return the current configuration: +QAUDCFG: 'innercodec/dlgain', OK If configuration parameters are entered: WCDMA&LTE_Audio_Design_Note Confidential / Released 39 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note OK ERROR If error is related to ME functionality: +CME ERROR: Parameter Numeric type, indicates the downlink digital gain level for internal codec. Range: 0-65535. Default value might be different in different audio modes NOTES 1. The parameter will not be saved. 2. This command is intended for UCxx modules only. l Example te AT+QAUDCFG='innercodec/dlgain',8000 //Set downlink digital gain to 8000. CQouneficdential OK WCDMA&LTE_Audio_Design_Note Confidential / Released 40 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note 7 Appendix A References Table 3: Related Documents SN Document name Remark Hardware design for UC15, UC20, EC25, EC21, [1] Quectel_UCxx/EC2x_Hardware_Design EC20 and EC20 R2.0 [2] Quectel_UCxx/EC2x_Reference_Design Reference design for UC15, UC20, EC25, EC21, EC20 and EC20 R2.0 AT commands manual for UC15, UC20, EC25, l [3] Quectel_UCxx/EC2x_AT_Commands_Manual EC21, EC20 and EC20 R2.0 te Audio design note for Quectel WCDMA UGxx [4] Quectel_WCDMA_UGxx_Audio_Design_Note modules uec tial Table 4: Terms and Abbreviations Abbreviation Q n EEC e ESD fid I2C LDO n LSB Co MCU Description Enhanced Echo Canceller Electrostatic Discharge Inter Integrated Circuit Low Dropout Regulator Least Significant Bit Microcontroller Unit ME Mobile Equipment MSB Most Significant Bit NR Noise Reducer NV Non-Volatile Memory PCB Printed Circuit Board WCDMA&LTE_Audio_Design_Note Confidential / Released 41 / 42 UMTS/HSPA/LTE Module Series WCDMA&LTE Audio Design Note PCM RC RF THD TDD UART XTAL Pulse-code Modulation Resistance Capacitance Radio Frequency Total Harmonic Distortion Time Division Duplexing Universal Asynchronous Receiver/Transmitter Crystal CQouneficdteenl tial WCDMA&LTE_Audio_Design_Note Confidential / Released 42 / 42

EC2x&EG9x Power Management Application Note LTE Module Series Rev. EC2x&EG9x_Power_Management_Application_Note_V1.0 Date: 2018-06-12 Status: Released www.quectel.com LTE Module Series EC2x&EG9x Power Management Application Note 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. EC2x&EG9x_Power_Management_Application_Note 1 / 26 LTE Module Series EC2x&EG9x Power Management Application Note About the Document History Revision 1.0 Date 2018-06-12 Author Wythe WANG Description Initial EC2x&EG9x_Power_Management_Application_Note 2 / 26 LTE Module Series EC2x&EG9x Power Management Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 2 Hardware Interfaces............................................................................................................................. 8 2.1. EC2x/EG9x Pin Assignment ....................................................................................................... 8 2.2. EC2x/EG9x Power Management Pins........................................................................................ 9 2.2.1. DTR ................................................................................................................................ 10 2.2.2. RI .................................................................................................................................... 10 2.2.3. AP_READY .................................................................................................................... 10 2.2.3.1. Function Description ..............................................................................................11 2.2.3.2. Example .................................................................................................................11 3 Introduction on URC .......................................................................................................................... 13 3.1. Set URC Port ............................................................................................................................ 13 3.2. URC Event ................................................................................................................................ 13 3.3. Example of URC Configuration................................................................................................. 14 4 Power Save Solutions ....................................................................................................................... 15 4.1. Power on/off .............................................................................................................................. 15 4.2. Power Save Solutions Based on UART Port ............................................................................ 15 4.2.1. Requirement Description ............................................................................................... 15 4.2.2. Hardware Connection Configuration.............................................................................. 15 4.2.3. Software Initialization Configuration............................................................................... 16 4.2.4. Implementation Method.................................................................................................. 17 4.3. Power Save Solutions Based on USB Remote Wakeup .......................................................... 17 4.3.1. Requirement Description ............................................................................................... 17 4.3.2. Hardware Connection Configuration.............................................................................. 17 4.3.3. Software Initialization Configuration............................................................................... 18 4.3.4. Implementation Method.................................................................................................. 18 4.4. Power Save Solutions Based on USB_VBUS Disconnection .................................................. 19 4.4.1. Requirement Description ............................................................................................... 19 4.4.2. Hardware Connection Configuration.............................................................................. 19 4.4.3. Software Initialization Configuration............................................................................... 19 4.4.4. Implementation Method.................................................................................................. 20 4.5. Power Save Solutions Based on USB Suspend/Resume and RI Pin ...................................... 20 4.5.1. Requirement Description ............................................................................................... 20 4.5.2. Hardware Connection Configuration.............................................................................. 20 4.5.3. Software Initialization Configuration............................................................................... 21 4.5.4. Implementation Method.................................................................................................. 21 EC2x&EG9x_Power_Management_Application_Note 3 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 4.6. Power Save Solutions in Non-Sleep Modes............................................................................. 22 5 Software Mechanisms ....................................................................................................................... 23 5.1. Sleep Mechanism...................................................................................................................... 23 5.2. Sleep Process ........................................................................................................................... 23 5.3. USB Sleep Mechanism ............................................................................................................. 24 5.4. Wakes up Host .......................................................................................................................... 24 5.4.1. Host Wakeup Event........................................................................................................ 24 5.4.2. USB Remote Wakeup .................................................................................................... 24 5.4.3. Configure Host Wakeup Event....................................................................................... 25 6 Appendix A References..................................................................................................................... 26 EC2x&EG9x_Power_Management_Application_Note 4 / 26 LTE Module Series EC2x&EG9x Power Management Application Note Table Index TABLE 1: EC2X/EG9X POWER MANAGEMENT PIN ........................................................................................ 9 TABLE 2: RELATED DOCUMENTS .................................................................................................................. 26 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 26 EC2x&EG9x_Power_Management_Application_Note 5 / 26 LTE Module Series EC2x&EG9x Power Management Application Note Figure Index FIGURE 1: EC2X PIN ASSIGNMENT (TOP VIEW) ............................................................................................ 8 FIGURE 2: EG9X PIN ASSIGNMENT (TOP VIEW)............................................................................................ 9 FIGURE 3: CONNECTION DIAGRAM BASED ON UART ............................................................................... 16 FIGURE 4: CONNECTION DIAGRAM BASED ON USB REMOTE WAKEUP................................................. 18 FIGURE 5: CONNECTION DIAGRAM BASED ON USB DISCONNECTION .................................................. 19 FIGURE 6: CONNECTION DIAGRAM BASED ON USB SUSPEND/RESUME AND RI PIN........................... 21 FIGURE 7: SLEEP PROCESS .......................................................................................................................... 23 EC2x&EG9x_Power_Management_Application_Note 6 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 1 Introduction When Quectel LTE modules are embedded into a host system, it will increase the whole power consumption of the system. Therefore, we provide several power management solutions on Quectel LTE modules, thus allowing the host to reduce the overall power consumption through managing the LTE module’s power consumption. Quectel LTE module power management solutions mainly include the following aspects:  Sleep and wakeup mechanism of the host system (e.g. USB driver suspend and remote wakeup).  Physical connection between the module and the host.  Sleep and wakeup software mechanism of Quectel LTE modules. The following chapters will illustrate Quectel LTE modules’ hardware interfaces and URC events relating to sleep and host-wakeup modes, power save solutions for some typical application scenarios, and the modules’ sleep and host-wakeup software mechanism. This document is applicable to the following Quectel LTE modules:  EC2x (EC21, EC25, EC20 R2.0, EC20 R2.1)  EG9x (EG91, EG95) EC2x&EG9x_Power_Management_Application_Note 7 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 2 Hardware Interfaces The communication between Quectel EC2x/EG9x module and the host is mainly realized through USB and UART ports. Also, there are some other functional pins provided for the host to manage the module’s power consumption. 2.1. EC2x/EG9x Pin Assignment RESERVED 55 GND 56 VBAT_RF 57 VBAT_RF 58 VBAT_BB 59 VBAT_BB 60 STATUS 61 RI 62 DCD 63 CTS 64 RTS 65 DTR 66 TXD 67 RXD 68 USB_DP 69 USB_DM 70 USB_VBUS 71 GND 72 RESERVED 113 RESERVED 114 WAKEUP_IN 1 AP_READY 2 129 117 RESERVED 3 W_DISABLE# 4 130 118 108 103 99 95 90 85 NET_MODE 5 131 119 NET_STATUS 6 VDD_EXT 7 132 120 109 104 100 96 91 86 RESERVED 141 133 121 RESERVED 142 82 79 76 73 GND 8 134 122 110 105 83 80 77 74 92 87 GND 9 135 123 84 81 78 75 USIM_GND 10 136 124 DBG_RXD 11 DBG_TXD 12 137 125 111 106 101 97 93 88 USIM_PRESENCE 13 USIM_VDD 14 138 126 USIM_DATA 15 139 127 112 107 102 98 94 89 USIM_CLK 16 USIM_RST 17 140 128 RESERVED 18 54 GND 53 GND 52 GND 51 GND 50 GND 49 ANT_MAIN 48 GND 144 RESERVED 143 RESERVED 47 ANT_GNSS 46 GND 45 ADC0 44 ADC1 43 RESERVED 42 I2C_SDA 41 I2C_SCL 40 BT_CTS 39 BT_RXD 38 BT_TXD 37 BT_RTS 36 GND 35 ANT_DIV 34 VDD_SDIO 33 SDC2_CMD SDC2_CLK 32 31 SDC2_DATA0 30 SDC2_DATA1 29 SDC2_DATA2 28 SDC2_DATA3 27 PCM_CLK 26 PCM_SYNC 25 PCM_OUT 24 PCM_IN 23 SD_INS_DET 22 GND 21 PWRKEY 20 RESET_N 19 GND 115 USB_BOOT 116 RESERVED Figure 1: EC2x Pin Assignment (Top View) EC2x&EG9x_Power_Management_Application_Note 8 / 26 LTE Module Series EC2x&EG9x Power Management Application Note RESERVED RESERVED(EG9x-E) ANT_DIV(EG9x-NA)/ VBAT_RF VBAT_RF RESERVED ANT_MAIN GND GND GND GND GND GND GND 103 RESERVED 1 RESERVED 2 GND 3 PCM_CLK 4 PCM_SYNC 5 PCM_DIN 6 PCM_DOUT 7 USB_VBUS 8 USB_DP 9 USB_DM 10 RESERVED 11 RESERVED 12 RESERVED 13 RESERVED 14 PWRKEY 15 RESERVED 16 RESET_N 17 RESERVED 18 104 19 20 21 22 23 24 25 26 27 28 29 30 31 62 61 106 50 51 52 53 54 55 56 57 58 59 60 49 48 82 81 80 79 47 102 101 100 99 46 63 83 USIM2_PRESENCE 45 98 78 44 64 84 USIM2_CLK 65 85 USIM2_RST 97 77 43 42 96 76 41 66 86 USIM2_DATA 40 95 75 USB_BOOT 67 87 USIM2_VDD 39 94 74 38 68 88 93 73 37 36 89 90 91 92 35 69 70 71 72 34 33 32 ANT_GNSS(EG9x-NA)/ ANT_DIV(EG9x-E) GND USIM_GND USIM1_CLK USIM1_DATA USIM1_RST USIM1_VDD USIM1_PRESENCE I2C_SDA I2C_SCL RI DCD RTS CTS TXD RXD VBAT_BB VBAT_BB 105 GND DTR VDD_EXT SPI_MISO SPI_MOSI SPI_CLK CLK_OUT RESERVED DBG_TXD DBG_RXD NETLIGHT STATUS AP_READY Figure 2: EG9x Pin Assignment (Top View) 2.2. EC2x/EG9x Power Management Pins Table 1: EC2x/EG9x Power Management Pin Pin Name I/O DTR DI Description  For the host to wake up EC2x/EG9x and allow EC2x/EG9x to enter into the sleep mode. EC2x&EG9x_Power_Management_Application_Note 9 / 26 LTE Module Series EC2x&EG9x Power Management Application Note RI DO AP_READY DI  DTR has been pulled up internally by default.  When it is in high level, EC2x/EG9x is allowed to enter into sleep mode.  When the module is in sleep mode, it can be woken up by pulling down DTR.  For EC2x/EG9x to inform the host there is a URC to report.  When the module has no URC to report, RI will keep in high level.  When there is a URC to report, RI will output a low pulse. In such case, if the host is in sleep mode, it will be woken up and process the reported URC.  Used to inform the module whether the host is in sleep state.  AP_READY can be configured by AT+QCFG='apready', and it supports high level or low level detection. NOTE For more details about the AT commands mentioned in this document, please refer to document [1], [2], [3] or [4]. 2.2.1. DTR Pulling up DTR indicates the module is allowed to enter into sleep mode. For the methods to make the module enter into sleep mode, please refer to Chapter 4. If DTR is pulled down, the module will not be able to enter into sleep mode. If the module has entered into sleep mode, it can be woken up by pulling down DTR. 2.2.2. RI When a host-wakeup event is arrived at the module, the RI pin of module will generate a low pulse (last for 120ms by default, and the time can be configured by AT+QCFG='urc/ri/ring' command) to inform the host. When the host is in sleep mode, it will be woken up when detecting the low pulse. After the host is woken up, AP_READY can be used to inform the module that the host is in wakeup mode currently. 2.2.3. AP_READY Most host systems contain several sleep modes, for instance, suspend to memory or suspend to hard disk in Linux system. In different sleep modes, the degree of sleep is different. EC2x&EG9x_Power_Management_Application_Note 10 / 26 LTE Module Series EC2x&EG9x Power Management Application Note  When the host is in light sleep, it can be woken up quickly, and host application can quickly recover the communication between the module, and read/write data normally from USB or UART port.  When the host is in deep sleep, it is slower to wake it up, and it needs more time to recover the communication between the module before it begins to read and write date form USB or UART port. This means when the host and the module are in sleep mode at the same time, if the module has URC to report, then during the whole procedure of sleep→wakeup→URC processing, the host cannot provide reliable guarantee for the integrity of data receiving, thus the data reported by module may not be processed effectively. In order to enable the host to control the procedure of sleep→wakeup→URC processing, EC2x/EG9x provides the AP_READY functional pin for host sleep state indication and also provides AT+QCFG='apready' command for the host to configure the pin behavior. After the host has enabled AP_READY pin, the module will report the URC to host according to the configured parameters, thus to ensure that the host can receive the URC correctly and process it in any mode. 2.2.3.1. Function Description When there is a URC for the module to be reported, the module will detect whether the AP_READY pin is in active level first.  When the host is in wakeup mode (AP_READY in active level), the module will output the URC to the host directly.  When the host is in sleep mode, the module will cache the URC first, and detect AP_READY pin level according to the configured detection intervals. And it will not output the URC until AP_READY pin is detected to be active, i.e. the host has been woken up. NOTE The module will cache maximally 15 URCs following FIFO principle. 2.2.3.2. Example ………. //System software initialization ………. AT+QCFG='apready',1,0,200 OK //The host enables AP_READY pin, and AP_READY pin is active low, which means when the pin is in low level, the host is EC2x&EG9x_Power_Management_Application_Note 11 / 26 LTE Module Series EC2x&EG9x Power Management Application Note in wakeup mode. If the module has URC to report, then it will output the data to host directly. When AP_READY pin is in high level, it indicates the host is in sleep mode, and if the module has URC to report, it will detect the pin level at an interval of 200ms. When the AP_READY pin is detected in low level, it will output URC to the host. //Both the host and the module enter into sleep mode. ………… When a host-wakeup event is arrived at the module, the module’s RI pin will generate a low pulse to inform the host. The module will detect whether or not the host is woken up from the sleep mode by AP_READY pin. If the host is in wakeup mode, the module will output URC to the host directly, otherwise, it will detect AP_READY pin level at an interval of 200ms until the system is in wakeup mode. As for host, after it has detected the low pulse on the module’s RI pin, it will be woken up. After been woken up completely, the host will pull up AP_READY pin to inform the module to output URC. The host will process URC normally after receiving it. EC2x&EG9x_Power_Management_Application_Note 12 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 3 Introduction on URC In normal data interaction process, the module not only responds the request from the host, but also takes the initiative to report external events to the host, such as incoming calls and short messages. In general, the unsolicited information reported by the module is called URC (Unsolicited Result Code). The processing of URC is embodied in two aspects: report event information to host actively and generate low pulse on RI pin. In Quectel LTE module power management, the RI pin can inform the incoming URC to host in the form of pulse after the host enters into sleep mode. For the module supporting several types of URC, frequent URC report will repeatedly wake up the host from the sleep mode, which will reduce the power management efficiency of the whole system. In order to avoid this, the host should select corresponding URCs based on its own needs. 3.1. Set URC Port Generally, the module and the host communicate with each other by UART or USB port, and the module only reports URC through one of the two ports. The URC report port can be configured by AT+QURCCFG command. 3.2. URC Event EC2x/EG9x module contains various URCs. For example, network status URC is used to report the current network status to host, short message URC is used to report the new incoming short messages and phone call URC is used to report the call state. For most URCs, customers can configure whether to report them or not by AT command. So the host can enable or disable URC report in different system status according to its own needs. For instance,  When system starting, the host can be set to actively report the URC relevant to network, short messages and phone calls.  Before entering into sleep mode, it can be set not to report the URC related to network, but only report the URC related to short messages and phone calls.  After the host has entered into sleep mode, it will only be woken up by URC related to short messages and phone calls. EC2x&EG9x_Power_Management_Application_Note 13 / 26 LTE Module Series EC2x&EG9x Power Management Application Note In this way, the basic requirements of the host are met, and the power management efficiency of whole system is improved as well. 3.3. Example of URC Configuration //The following example shows how to configure the relevant URCs: AT+CREG=1 or AT+CREG=2 OK AT+CREG=0 OK //Enable to actively report the CS network registration status (Disabled by default) //Disable to actively report the CS network registration status AT+CGREG=1 or AT+CGREG=2 OK AT+CGREG=0 OK AT+QINDCFG='csq',1 OK AT+QINDCFG='csq',0 OK //Enable to actively report the PS network registration status (Disabled by default) //Disable to actively report the PS network registration status //Enable to actively report the value of CSQ signals (Disabled by default) //Disable to actively report the value of CSQ signals AT+QINDCFG='ring',1 OK AT+QINDCFG='ring',0 OK //Enable to actively report the RING of incoming call (Enabled by default) //Disable to actively report the RING of incoming call AT+QINDCFG='smsincoming',1 OK AT+QINDCFG='smsincoming',0 OK //Enable to actively report the incoming of new short messages (Enabled by default) //Disable to actively report the incoming of new short messages EC2x&EG9x_Power_Management_Application_Note 14 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 4 Power Save Solutions This chapter mainly introduces the recommended power save solutions for some typical application scenarios. 4.1. Power on/off When the module is powered on, the host should remain at least 25 seconds before power off the module. It is recommended to use AT command or PWRKEY to power off the module before switching off the VBAT power supply. 4.2. Power Save Solutions Based on UART Port 4.2.1. Requirement Description When the device is implementing power saving solutions, it is required that:  Both the host and the module are able to enter into power save mode.  The host communicates with the module by UART port, rather than USB port. The following will illustrate the detailed implementation method based on these requirements. 4.2.2. Hardware Connection Configuration 1. The host is connected to the module by UART port. 2. The host’s I/O pin is connected to the module’s RI pin, and the I/O pin must support host wakeup function. 3. The host’s I/O pin is connected to the module’s DTR pin. 4. The host’s I/O pin is connected to the module’s AP_READY pin (AP_READY can be configured). EC2x&EG9x_Power_Management_Application_Note 15 / 26 LTE Module Series EC2x&EG9x Power Management Application Note Module RXD TXD RI DTR AP_READY GND Host TXD RXD EINT GPIO GPIO GND Figure 3: Connection Diagram Based on UART The UART port is an important channel for communication between the module and the host. Through the DTR pin, the host can manage the module’s power consumption easily.  When DTR is in high level, the module is allowed to enter into sleep mode.  When DTR is in low level, if the module is in wakeup mode, it will not enter into sleep mode.  If the module is in sleep mode, driving DTR to low level will wake the module up. NOTE In the above diagram and the following diagrams in this chapter, the connection in dotted line indicates special attention should be paid to the level match between the two systems, and the connection in solid line means that they can be connected directly. 4.2.3. Software Initialization Configuration 1. Enable the module to enter into sleep mode by AT+QSCLK=1. 2. Specify UART port to report URC from the module by AT+QURCCFG='urcport','uart1'. 3. Enable the module’s AP_READY function by the following command: AT+QCFG='apready',[,,[]]. 4. Configure URCs needed for the module to report by AT+QINDCFG. 5. Configure RI pin by AT+QCFG='risignaltype','physical' to make sure the RI always behaves on UART1 when any URC reports. NOTE The DTR is pulled up by default. When AT+QSCLK=1 command is configured, UART1 will be disabled and will not respond any AT command. It is recommended to drive the DTR to low level before the module goes to sleep to avoid disabling of UART1. EC2x&EG9x_Power_Management_Application_Note 16 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 4.2.4. Implementation Method 1. When host enters into sleep mode When the host enters into power save mode, it should pull up DTR to enable the module entering into sleep mode, and set AP_READY as inactive to indicate that the host is in sleep mode. 2. When host is woken up from sleep mode  Host wakes up module The host pulls down DTR pin, and sets AP_READY pin as active to indicate the host is in wakeup mode.  Module wakes up host When the module has URC to report, its RI pin will generate a low pulse (120ms duration by default, and it can be configured by AT command) to inform the host that URC is coming. When the host is in sleep mode, it is required to ensure that the change of RI pin level can wake up the host itself. After the host is woken up, AP_READY pin should be set as active to indicate the host is in wakeup mode. 4.3. Power Save Solutions Based on USB Remote Wakeup 4.3.1. Requirement Description When the device is implementing power save solution, it is required that:  Both the host and the module are able to enter into power save mode.  The host supports USB suspend/resume and remote wakeup functionality. The following will illustrate the detailed implementation method based on these requirements. 4.3.2. Hardware Connection Configuration 1. Connect the host to the module via USB. 2. The host’s I/O pin is connected to the module’s AP_READY pin (AP_READY can be configured).. EC2x&EG9x_Power_Management_Application_Note 17 / 26 LTE Module Series EC2x&EG9x Power Management Application Note Module USB_VBUS USB_DP USB_DM AP_READY GND Host VDD USB_DP USB_DM GPIO GND Figure 4: Connection Diagram Based on USB Remote Wakeup 4.3.3. Software Initialization Configuration 1. Enable the module to enter into sleep mode by AT+QSCLK=1. 2. Specify USB AT port to report URC by AT+QURCCFG='urcport','usbat'. 3. Enable the module’s AP_READY function by the following command: AT+QCFG='apready',[,,[]]. 4. Configure URCs needed for the module to report by AT+QINDCFG. 5. Configure the corresponding system and driver settings in host system. (For details, please contact Quectel technical support team.) 4.3.4. Implementation Method 1. When host enters into sleep mode The host sets AP_READY as inactive, and suspends USB (the module supports selective suspend and global suspend). 2. When host is woken up from sleep mode  Host wakes up module actively When the host sends data to the module actively, it will resume USB and set AP_READY as active.  Module wakes up host actively When the module has URC to report, its USB will send remote wakeup signals first. The host USB must be able to wake up the host itself through these signals, and then set AP_READY as active. EC2x&EG9x_Power_Management_Application_Note 18 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 4.4. Power Save Solutions Based on USB_VBUS Disconnection 4.4.1. Requirement Description When the device is implementing power save solution, it is required that:  Both the host and the module are able to enter into power save mode.  The host does not support USB suspend/resume and remote wakeup functionality. So the host should disconnect the USB_VBUS when the device enters into power save mode. The following will illustrate the detailed implementation method based on these requirements. 4.4.2. Hardware Connection Configuration 1. Connect the host to the module via USB. 2. The host’s I/O pin is connected to the module’s AP_READY pin (AP_READY can be configured). 3. The host’s I/O pin is connected to the module’s RI pin, and the I/O pin must support host wakeup function. Module USB_VBUS USB_DP USB_DM RI AP_READY GND Power Switch Host GPIO VDD USB_DP USB_DM EINT GPIO GND Figure 5: Connection Diagram Based on USB Disconnection 4.4.3. Software Initialization Configuration 1. Enable the module to enter into sleep mode by AT+QSCLK=1. 2. Specify USB AT port to report URC by AT+QURCCFG='urcport','usbat'. 3. Enable the module’s AP_READY function by the following command: AT+QCFG='apready',[,,[]]. 4. Configure URCs needed for the module to report by AT+QINDCFG. 5. Configure RI pin by AT+QCFG='risignaltype','physical' to make sure the RI always behaves on UART1 when any URC reports. EC2x&EG9x_Power_Management_Application_Note 19 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 4.4.4. Implementation Method 1. When host enters into sleep mode The host disconnects the module’s USB_VBUS, and sets AP_READY as inactive. NOTE When USB_VUBS is disconnected, the USB port on host system will disappear. Due to this, host application should stop the data connection or AT commands on USB port and close the port before disconnecting. 2. When host is woken up from sleep mode  Host wakes up module actively The host connects to the module’s USB_VBUS and sets AP_READY as active, and then the host sends data to the module.  Module wakes up host actively When the module has URC to report, its RI pin will generate a low pulse (120ms duration by default, and it can be configured by AT command), and the host must be able to be woken up by RI pin. After the host has been woken up, it pulls up the module’s USB_VBUS, and set AP_READY as active to indicate that the host is woken up and the module can output the URC to the host now. 4.5. Power Save Solutions Based on USB Suspend/Resume and RI Pin 4.5.1. Requirement Description When the device is implementing power save solution, it is required that:  Both the host and the module are able to enter into power save mode.  The host can support USB suspend/resume, but does not support USB remote wakeup functionality.  The module’s RI pin is the external wakeup source of the host.  The host should disconnect the USB when the device enters into power save mode. The following will illustrate the detailed implementation method based on these requirements. 4.5.2. Hardware Connection Configuration 1. Connect the host to the module via USB. 2. The host’s I/O pin is connected to the module’s AP_READY pin (AP_READY can be configured). EC2x&EG9x_Power_Management_Application_Note 20 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 3. The host’s I/O pin is connected to the module’s RI pin, and the I/O pin must support host wakeup function. Module USB_VBUS USB_DP USB_DM AP_READY RI GND Host VDD USB_DP USB_DM GPIO EINT GND Figure 6: Connection Diagram Based on USB Suspend/Resume and RI Pin 4.5.3. Software Initialization Configuration 1. Enable the module to enter into sleep mode by AT+QSCLK=1. 2. Specify USB AT port to report URC by AT+QURCCFG='urcport','usbat'. 3. Enable the module’s AP_READY function by the following command: AT+QCFG='apready',[,,[]]. 4. Configure URCs needed for the module to report by AT+QINDCFG. 5. Configure RI pin by AT+QCFG='risignaltype','physical' to make sure the RI always behaves on UART1 when any URC reports. 4.5.4. Implementation Method 1. When host enters into sleep mode The host sets AP_READY pin as inactive, and suspends USB. 2. When host is woken up from sleep mode  Host wakes up module actively The host resumes USB, and sets AP_READY pin as active.  Module wakes up host actively When the module has URC to report, its RI pin will generate a low pulse (120ms duration by default, and it can be configured by AT command), and the host must be able to be woken up by RI pin. After the host has been woken up, the host sets AP_READY as active to indicate that the host is woken up and the EC2x&EG9x_Power_Management_Application_Note 21 / 26 LTE Module Series EC2x&EG9x Power Management Application Note module can output the URC to the host now. 4.6. Power Save Solutions in Non-Sleep Modes When the module is working, the host can lower the power level by steps below: 1. Using UART1 or USB only. For example, if the host is using USB, then the host can pull up the DTR and send AT+QSCLK=1 to disable the UART1 port. In this way, UART1 port will not work and thus the current consumption is reduced. 2. Control the speed rate of data transmitting. The slower data transmitting, the lower current will happen. EC2x&EG9x_Power_Management_Application_Note 22 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 5 Software Mechanisms 5.1. Sleep Mechanism There is a lower-priority sleep mission within EC2x/EG9x module, which is used to detect whether the module can enter into sleep mode or not. Other service missions (such as RF/USB/UART and so on) and sleep control variables have rights to vote on the sleep mission to decide whether or not the module can enter into sleep mode. When other service missions and sleep control variables both agree the module to enter into sleep mode, sleep mission will be executed and the module will enter into sleep mode. It should be noted that when the module enters into sleep mode, the module will work in DRX mode. 5.2. Sleep Process Start service missions QSCLKUSBRF UART and so on Vote for/against Start sleep mission Vote statistics Agree to sleep No or not Yes Module enters into sleep mode Service missions and sleep control variables Sleep mission Figure 7: Sleep Process EC2x&EG9x_Power_Management_Application_Note 23 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 5.3. USB Sleep Mechanism When USB is working normally, root hub in hub or HCD will send SOF package periodically (full speed USB sends one package at an interval of 1ms, high speed USB sends one package at an interval of 125μs). At this time, USB on the module will vote against the module to enter into sleep mode. According to the description of suspend in USB standard protocol, when the host system sets the port attached with USB device in hub or root hub as suspend, hub or root hub will stop sending SOF package and USB bus will enter into suspend mode. Then USB on the module will enter into suspend mode, and vote for the module to enter into sleep mode. NOTES 1. Quectel EC2x/EG9x module provides USB suspend solutions for different host systems. Customers can control the module to enter into suspend mode on host system by these solutions. 2. If customers use the USB driver developed by their own, the driver should support both global suspend and selective suspend functions. 5.4. Wakes up Host 5.4.1. Host Wakeup Event Host wakeup event is the event that the module takes the initiative to report information to the host and wake up the host when the host is in sleep mode. Host wakeup event is also called URC. 5.4.2. USB Remote Wakeup When the host enters into sleep mode, and host USB bus is in suspend mode, if the module has URC to report, it will send remote wakeup signals (duration time>3ms) to inform the host to resume USB. The key points of module’s remote wakeup function are listed as follows:  Host USB controller must support remote wakeup, and it can wake up the host. If USB controller does not support remote wakeup, it will not process remote wakeup signals received from the module. Similarly, if USB controller cannot wake up the host, then the host will not be woken up from sleep mode by USB remote wakeup.  As for the host, the module’s remote wakeup function can be set by USB standard request. The host can enable remote wakeup function by 'SET_FEATURE' and disable it by 'CLEAR_FEATURE'. Before the host enters into sleep mode, the module’s remote wakeup function must be enabled. EC2x&EG9x_Power_Management_Application_Note 24 / 26 LTE Module Series EC2x&EG9x Power Management Application Note  When the module sends remote wakeup signals to the host, the host must resume signals for at least 20ms. After that, USB bus will enter into idle state. And before USB bus enters into idle state, USB controller must retrieve to send SOF package on USB bus within 3s. Otherwise the module would enter into suspend mode again. 5.4.3. Configure Host Wakeup Event The host can configure URC report port by AT+QURCCFG, for example, UART port or USB AT port. In specific application scenarios, the host can specify URC port according to the actual hardware connection ways. The default port is USB AT port. In order to avoid host being woken up frequently by URC, the host can choose reporting only necessary URC events by AT+QINDCFG based on its own needs to optimize power consumption of the whole system. EC2x&EG9x_Power_Management_Application_Note 25 / 26 LTE Module Series EC2x&EG9x Power Management Application Note 6 Appendix A References Table 2: Related Documents SN Document Name Remark Quectel_EC25&EC21_AT_Commands_ [1] EC25 & EC21 AT Commands Manual Manual Quectel_EC20_R2.1_AT_Commands_ [2] EC20 R2.1 AT Commands Manual Manual Quectel_EC20_R2.0_AT_Commands_ [3] EC20 R2.0 AT Commands Manual Manual [4] Quectel_EG9x_AT_Commands_Manual EG91 & EG95 AT Commands Manual Table 3: Terms and Abbreviations Abbreviation AP DRX FIFO I/O SOF URC USB Description Application Discontinuous Reception First-in, First-out Input/Output Start of Frame Unsolicited Result Code Universal Serial Bus EC2x&EG9x_Power_Management_Application_Note 26 / 26

EC2x&EG9x TTS Application Note LTE Module Series Rev. EC2x&EG9x_TTS_Application_Note_V1.0 Date: 2018-10-15 Status: Released www.quectel.com LTE Module Series EC2x&EG9x TTS Application Note 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. EC2x&EG9x_TTS_Application_Note 1 / 13 LTE Module Series EC2x&EG9x TTS Application Note About the Document History Revision Date 1.0 2018-10-15 Author Duke XIN/ Ketn WANG Description Initial EC2x&EG9x_TTS_Application_Note 2 / 13 LTE Module Series EC2x&EG9x TTS Application Note Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 4 1 Introduction ....................................................................................................................................... 5 2 Description of TTS AT Commands .................................................................................................. 6 2.1. AT+QTTS Start/Stop TTS ................................................................................................... 6 2.2. AT+QWTTS Play TTS during a Voice Call ......................................................................... 7 2.3. AT+QTTSETUP Set/Get TTS Parameters.......................................................................... 9 3 Summary of Error Codes................................................................................................................ 12 4 Appendix A References .................................................................................................................. 13 EC2x&EG9x_TTS_Application_Note 3 / 13 LTE Module Series EC2x&EG9x TTS Application Note Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 12 TABLE 2: RELATED DOCUMENT .................................................................................................................... 13 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 13 EC2x&EG9x_TTS_Application_Note 4 / 13 LTE Module Series EC2x&EG9x TTS Application Note 1 Introduction This document describes how to use the TTS function of Quectel EC2x&EG9x modules. Customers can input text and output speech by using this function via the auxiliary channel of the module. This document is applicable to following Quectel modules.  EC2x (including EC25, EC21, EC20 R2.0 and EC20 R2.1)  EG9x (including EG91 and EG95) EC2x&EG9x_TTS_Application_Note 5 / 13 LTE Module Series EC2x&EG9x TTS Application Note 2 Description of TTS AT Commands 2.1. AT+QTTS Start/Stop TTS The command starts or stops the function of broadcasting text. AT+QTTS Start/Stop TTS Test Command AT+QTTS=? Response +QTTS: (0-2), Read Command AT+QTTS? OK Response +QTTS: Write Command AT+QTTS=[,] OK Response OK If there is any error related to ME functionality: +CME ERROR: Report when broadcasting text is over: +QTTS: 0 Parameter Start or stop TTS, and define the format of text. 0 Stop TTS, and is omitted. 1 Start TTS, and is in UCS2 format. 2 Start TTS, and can be inputted directly. Normal characters are in ASCII format and Chinese characters are in GBK. Text to be played. The format depends on . The maximum length is 960 bytes. TTS status. 0 Idle 1 Playing EC2x&EG9x_TTS_Application_Note 6 / 13 LTE Module Series EC2x&EG9x TTS Application Note Example AT+QTTS=? +QTTS: (0-2), //Query the parameters OK AT+ QTTS? +QTTS: 0 //Query the current state OK AT+QTTS=1,'6B228FCE4F7F752879FB8FDC6A215757' OK //Start to play text encoded in UNICODE +QTTS: 0 AT+QTTS=2,'Welcome to use the module of QUECTEL' OK //Start to play text encoded in ASCII +QTTS: 0 AT+QTTS=2,'欢迎使用移远模块!' OK //Start to play text encoded in GBK +QTTS: 0 AT+QTTS=2,'Welcome to use the module of QUECTEL' AT+QTTS=0 OK //Stop TTS when playing it +QTTS: 4111 //Module would report URC '4111' NOTE URC '4111' means TTS or WTTS is interrupted when it is played. 2.2. AT+QWTTS Play TTS during a Voice Call AT+QWTTS Play TTS during a Voice Call Test Command AT+QWTTS=? Response +QWTTS: (0,1),(0,1),(0-2), OK EC2x&EG9x_TTS_Application_Note 7 / 13 LTE Module Series EC2x&EG9x TTS Application Note Read Command AT+QWTTS? Response +QWTTS: Write Command AT+QWTTS=,,[,] OK Response OK If there is any error related to ME functionality: +CME ERROR: Report when broadcasting text is over: +QWTTS: 0 Parameter Uplink mute. The range is 0~1. 0 Enable mute 1 Disable mute Downlink mute. The range is 0~1. 0 Enable mute 1 Disable mute Start or stop TTS, and define the format of text. 0 Stop TTS, and is omitted. 1 Start TTS, and is in UCS2 format. 2 Start TTS, and can be inputted directly. Normal characters are in ASCII format and Chinese characters are in GBK. Text to be played. The format depends on . The maximum length is 960 bytes. TTS status. 0 Idle 1 Playing NOTES 1. This command must be executed during a voice call. 2. Hex string should be placed in big-endian sequence if is 2. 3. Some module versions only support English TTS library. Example AT+QWTTS=? +QWTTS: (0,1),(0,1),(0-2), OK AT+QWTTS? //Query parameters //Query the current state EC2x&EG9x_TTS_Application_Note 8 / 13 LTE Module Series EC2x&EG9x TTS Application Note +QWTTS: 0 OK AT+QWTTS=1,1,1,'6B228FCE4F7F752879FB8FDC6A215757'//Start to play text encoded in UNICODE OK +QWTTS: 0 AT+QWTTS=1,1,2,'Welcome to use the module of QUECTEL' //Start to play text encoded in ASCII OK +QTTS: 0 AT+QWTTS=1,1,2,'欢迎使用移远模块!' OK //Start to play text encoded in GBK +QWTTS: 0 AT+QWTTS=1,1,2,'Welcome to use the module of QUECTEL' AT+QWTTS=0,0,0 //Stop TTS during a voice call OK +QTTS: 4111 //Module would report URC '4111' NOTE URC '4111' means TTS or WTTS is interrupted when it is played. 2.3. AT+QTTSETUP Set/Get TTS Parameters The command adjusts the TTS speed and volume of broadcasting. AT+QTTSETUP Set/Get TTS Parameters Test Command AT+QTTSETUP=? Response +QTTSETUP: (1,2),(1-3),(-32768~32767) Read Command AT+QTTSETUP? Write Command AT+QTTSETUP=,[,] OK Response OK Response If the is omitted, the current configuration is queried: +QTTSETUP: 2,, OK EC2x&EG9x_TTS_Application_Note 9 / 13 LTE Module Series EC2x&EG9x TTS Application Note If is inputted: OK Or ERROR Parameter Integer type. Set or query parameter values. 1 Set TTS parameters 2 Get TTS parameters Integer type. Parameter ID. Set speed or volume or language library. 1 Set TTS speed 2 Set TTS volume 3 Set TTS language library When =1, the range is -32768~32767, and the default value is 0. When =2, the range is -32768~32767, and the default value is 0. When =3, the range is 0~1. 0 Support both Chinese and English TTS libraries, and Chinese pronunciation is the best. 1 Support only English TTS library When is 2, this parameter can be omitted. NOTE This command only supports getting TTS parameters when playing TTS, otherwise 'ERROR' will be returned. Example AT+QTTSETUP=? +QTTSETUP: (1,2),(1-3)[,(-32768-32767)] //Query the parameters OK AT+QTTSETUP? OK //Read command AT+QTTSETUP=1,1,-32768 OK //Set TTS speed AT+QTTS=1,'6B228FCE4F7F752879FB8FDC6A215757' OK AT+QTTSETUP=2,1 //Get TTS speed EC2x&EG9x_TTS_Application_Note 10 / 13 +QTTSETUP: 2,1,-32768 OK LTE Module Series EC2x&EG9x TTS Application Note EC2x&EG9x_TTS_Application_Note 11 / 13 LTE Module Series EC2x&EG9x TTS Application Note 3 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about are described in the following table. Table 1: Summary of Error Codes 901 902 903 904 Description of Error Codes Audio unknown error Audio invalid parameters Audio operation not supported Audio device busy EC2x&EG9x_TTS_Application_Note 12 / 13 LTE Module Series EC2x&EG9x TTS Application Note 4 Appendix A References Table 2: Related Document SN Document Name [1] Quectel_EC25&EC21_AT_Commands_Manual [2] Quectel_EG9x_AT_Commands_Manual Remark EC25&EC21 AT Commands Manual EG9x AT Commands Manual Table 3: Terms and Abbreviations Abbreviation ASCII GBK TTS UCS Description American Standard Code for Information Interchange Guo-Biao Kuozhan (Chinese Internal Code Extension Specification) Text to Speech Universal Coded Character Set EC2x&EG9x_TTS_Application_Note 13 / 13

EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual LTE Standard Module Series Rev. EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual _V1.0 Date: 2019-10-23 Status: Released www.quectel.com LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding 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. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 2 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual About the Document History Revision Date 1.0 2019-10-23 Author Chris PENG Description Initial EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 3 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 1 Introduction ......................................................................................................................................... 5 2 Description of AT Commands ........................................................................................................... 6 2.1. AT+QFWDSERVER Establish TCP/UDP Server on AP Side ................................................. 6 2.2. AT+QFWDCLIENT Establish TCP/UDP Client on AP Side .................................................... 7 2.3. AT+QFWDSEND Send Data by AP Side Socket .................................................................... 8 2.4. AT+QFWDRECV Receive Data by AP Side Socket ............................................................... 9 2.5. AT+ QFWDACK Query Data Buffer Queue Information by AP Side Socket ........................ 10 2.6. AT+QFWDSSTATE Query Load State of the Specified Server .............................................11 2.7. AT+QFWDCLOSE Close the Socket on AP Side ..................................................................11 2.8. AT+QFWDCFG Configure the Socket on AP Side ............................................................... 12 3 Description of URCs ......................................................................................................................... 13 3.1. URC Indicating Server Setup................................................................................................... 13 3.2. URC Indicating Active Client Setup ......................................................................................... 13 3.3. URC Indicating Client and Local Server Connection............................................................... 14 3.4. URC Indicating Readable Data of the Connection .................................................................. 14 3.5. URC Indicating Closed Client .................................................................................................. 15 4 Examples ........................................................................................................................................... 16 5 Terms and Abbreviations................................................................................................................. 18 EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 4 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual 1 Introduction The interaction between the network data and the physical data can be realized through socket forwarding. This document mainly introduces the AT commands related to socket forwarding. The applicable modules of this document are as below:  EC2x: EC25, EC21 and EC20 R2.1 EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 5 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual 2 Description of AT Commands 2.1. AT+QFWDSERVER Establish TCP/UDP Server on AP Side This command is used to establish a TCP/UDP server on the AP side. A URC will be reported in format '+QFWDURC: 'server/open',,' indicating whether the server establishment is successful. The module automatically accepts the connection requested by the TCP server by default. After the server is established successfully, the URC port could be re-configured by AT+QFWDCFG='urc'. AT+QFWDSERVER Establish TCP/UDP Server on AP Side Test Command AT+QFWDSERVER=? Response +QFWDSERVER: (0-16),(1-65535),('IP','IPV6'),('tcp','ud p'),(1-65535),(1-10),(1-65535),('uart1','usbat','usbmode m') OK Write Command AT+QFWDSERVER=,,,,,,, Response OK Or ERROR Read Command AT+QFWDSERVER? Response List of (+QFWDSERVER: ,,< listen_port>,) OK Or ERROR Parameter Integer type. Serial number of PDP context. Range: 0-16 0 indicates binding any address. String type. IP version. IP IPv4 EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 6 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual IPV6 IPv6 String type. Protocol type. TCP TCP socket UDP UDP socket Integer type. Listening port. Range: 1-65535. Integer type. Listening backlog. Range: 1-10. Integer type. The duration of the idle timeout between the server and the client. If there is no data interaction, the module server will close connection proactively. Range: 1~65535. Unit: s. Default value: 60s. Integer type. The configured URC port. The default port is AT performance port. Uart1 Main UART port Usbat AT performance port Usbmodem Modem port Integer type. The corresponding socket ID of the server. 2.2. AT+QFWDCLIENT Establish TCP/UDP Client on AP Side This command is used to establish a TCP/UDP client on AP side. A URC will be reported in format '+QFWDURC: 'client/open',,' indicating whether the client establishment is successful. After that, the URC port could be re-configured by AT+QFWDCFG='urc'. AT+QFWDCLIENT Test Command AT+QFWDCLIENT=? Establish TCP/UDP Client on AP Side Response +QFWDCLIENT: (0-16),(1-65535),('IP','IPV6'),('tcp','udp'),, ,('uart1','usbat','usbmodem') OK Write Command Response AT+QFWDCLIENT=,,,,< Or remote_addr>,, Read Command Response AT+QFWDCLIENT? List of (+QFWDCLIENT: ,,,,,,,) OK Or ERROR EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 7 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual Parameter Integer type. Serial number of PDP context. Range: 0-16. 0 indicates binding any address. String type. IP version. IP IPv4 IPV6 IPv6 String type. Protocol type. TCP TCP socket UDP UDP socket String type. Remote address of the socket. It can be an IP address or domain name. Integer type. Remote port of the socket. Range: 1-65535. String type. Local address of the socket. Integer type. Local port of the socket. Range: 1-65535. Integer type. The duration of the idle timeout between the server and the client. If there is no data interaction, the module server will close connection proactively. Range: 1~65535. Unit: s. Default value: 60s. Integer type. The configured URC port. The default port is AT performance port. Uart1 Main UART Usbat AT performance port Usbmodem Modem port Integer type. The corresponding socket ID of the server. String type. It indicates who initiated the connection request. Active The module that serves as a client Income The client that is accessed by an external request when module serves as a server 2.3. AT+QFWDSEND Send Data by AP Side Socket This command is used to send the data inputted via the UART port to the network by AP side socket. The maximum data length supported by this command is 1024 bytes, and both fixed-length data sending and variable-length data sending are supported (the data sending can be ended by tapping 'CTRL+Z'). AT+QFWDSEND Send Data by AP Side Socket Test Command AT+QFWDSEND=? Response +QFWDSEND: ,, Write Command AT+QFWDSEND=,,[] ERROR Or > After the response '>', input the data to be sent. Tap 'CTRL+Z' to end the data sending. If parameter verification succeed: +QFWDSEND: , OK If the data sending is canceled: OK If the length of the data sent is more than 1024 bytes: ERROR Parameter Integer type. Socket ID. Integer type. Data format. 0 ASCII 1 HEX Integer type. The length of the data to be sent. Range: 1-1024. Integer type. The actual length of the data to be sent. Range: 0-1024. 2.4. AT+QFWDRECV Receive Data by AP Side Socket This command is used to receive data by AP side Socket and then receive the data in the socket. AT+QFWDRECV Receive Data by AP Side Socket Test Command AT+QFWDRECV=? Response +QFWDPRECV: , Write Command fixed-length data sending AT+QFWDRECV=, OK Response +QFWDRECV: ,,,,< read_data> OK EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 9 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual Or ERROR Parameter Integer type. Socket ID. Integer type. The length of the data to be received. Range: 1-1024. Integer type. The actual length of the data to be received. Range: 0-1024. 2.5. AT+ QFWDACK Query Data Buffer Queue Information by AP Side Socket This command is used to query the information of the data buffer queue to be sent/received in the specified socket. AT+ QFWDACK Query Data Buffer Queue Information by AP Side Socket Test Command AT+QFWDACK=? Response +QFWDACK: Write Command AT+QFWDACK= OK Response +QFWDACK: ,,,,,, OK Or ERROR Parameter Integer type. Socket ID. Integer type. The used length of the data queue to be sent. 0 All data has been sent. Integer type. The unused length of the data queue to be sent. Integer type. The maximum length of the data queue to be sent. Integer type. The used length of the data queue to be received. Integer type. The unused length of the data queue to be received. Integer type. The maximum length of the data queue to be received. EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 10 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual 2.6. AT+QFWDSSTATE Query Load State of the Specified Server This command is used to query the load state of the specified server, i.e. the number of the client that accesses the server. AT+QFWDSSTATE Query Load State of the Specified Server Test Command AT+QFWDSSTATE=? Write Command AT+QFWDSSTATE= Response OK Response List of (+QFWDSSTATE: ,,,,,) OK Or ERROR Parameter Integer type. The corresponding socket ID of the server. Integer type. The corresponding socket ID of the client that is accessed by external request. String type. Remote address of the socket. It can be an IP address or domain name. Integer type. Remote port of the socket. Range: 1-65535. String type. Local address of the socket. Integer type. Local port of the socket. Range: 1-65535. Integer type. The number of the income client. Range: 1-65535. 2.7. AT+QFWDCLOSE Close the Socket on AP Side This command is used to close the socket on AP side. If the socket corresponds to a TCP server, then only this TCP server will be closed, and the client associated with the socket will not be closed. AT+QFWDSSTATE Close the Socket on AP Side Test Command AT+QFWDCLOSE=? Write Command AT+QFWDCLOSE= Response OK Response OK Or EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 11 / 18 Parameter LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual ERROR Integer type. Socket ID. 2.8. AT+QFWDCFG Configure the Socket on AP Side This command is used to configure the socket on AP side. AT+QFWDCGF Configure the Socket on AP Side Test Command AT+QFWDCFG=? Response +QFWDCFG: 'urc',, OK Write Command Response Query the URC port of the specified +QFWDCFG: 'urc',, socket. AT+QFWDCFG='urc', OK or ERROR Write Command Response Configure the URC port of the OK specified socket. Or AT+QFWDCFG='urc',, ERROR Parameter Integer type. It indicates the socket corresponding to server/client. Integer type. It indicates the configured URC port. Uart1 Main UART Usbat AT performance port Usbmodem Modem port EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 12 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual 3 Description of URCs 3.1. URC Indicating Server Setup URC Indicating Server Setup +QFWDURC: 'server/open',, up. Parameter Integer type. Socket ID. Integer type. Server setup results. 0 Server is set up successfully. Others Server is failed to be set up. 3.2. URC Indicating Active Client Setup URC Indicating Active Client Setup +QFWDURC: 'client/open',, connected to server. Parameter Integer type. Socket ID. Integer type. Client connection results. 0 The setup client is successfully connected to the server. Others The setup client is failed to connect to the server. EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 13 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual 3.3. URC Indicating Incoming Connection URC Indicating Incoming Connection +QFWDURC: 'client/incoming',,,,,,< local_port> This URC will report related information when client is connected to the local server. Parameter Integer type. The socket ID corresponding to the server. Integer type. The socket ID corresponding to the income client. String type. Remote address of the socket. It can be an IP address or domain name. Integer type. Remote port of the socket. Range: 1-65535. String type. Local IP. Integer type. Local port of the socket. Range: 1-65535. 3.4. URC Indicating Readable Data of the Connection URC Indicating Readable Data of the Connection +QFWDURC: 'client/read', This URC will report related information when the data of the connection between the client and the local server is readable. Parameter Integer type. Socket ID. EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 14 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual 3.5. URC Indicating Closed Client URC Indicating Client Closed +QFWDURC: 'client/close', This URC will report a message of disconnection when the client is closed. Parameter Integer type. Socket ID. EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 15 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual 4 Examples AT+QFWDSERVER= 1,'uninet','ip','tcp',2020,5 OK +QFWDURC: 'server/open',1,0 //Establish a TCP server with =1. +QFWDURC: 'client/incoming',1,2,'192.168.225.58',56784,'0.0.0.0',2020 +QFWDURC: 'client/incoming',1,3,'192.168.225.58',56794,'0.0.0.0',2020 AT+QFWDSSTATE= 1 //Query the load state of TCP server with =1. +QFWDSSTATE: 1,2,'192.168.225.58',56784,'0.0.0.0',2020 +QFWDSSTATE: 2,3,'192.168.225.58',56794,'0.0.0.0',2020 OK AT+QFWDSEND= 2,1 > 3131 +QFWDSEND: 2,2 //Send hex data to client with =2 OK +QFWDURC: 'client/read',3 //Receive the URC notifying client data that can be read with =3 AT+QFWDACK= 3,1024 +QFWDACK: 3,18 test, data forward //Read the data received by client with =3. OK +QFWDURC: 'client/close',3 AT+QFWDSSTATE= 1 +QFWDSSTATE: 1,2,'192.168.225.58',56784,'0.0.0.0',2020 OK AT+QFWDCLOSE=2 OK //Close client with =2 proactively. EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 16 / 18 AT+QFWDSSTATE=1 OK LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 17 / 18 LTE Standard Module Series EC21&EC25&EC20 R2.1 Socket Forwarding AT Commands Manual 5 Terms and Abbreviations Table 1: Terms and Abbreviations Abbreviation PDP TCP UDP URC Description Packet Data Protocol Transmission Control Protocol User Datagram Protocol Utility Radio Communication EC21&EC25&EC20 R2.1_Socket_Forwarding_AT_Commands_Manual 18 / 18

LTE Standard 安全防护设计 LTE Standard 模块系列 版本：LTE_Standard_安全防护设计_V1.0 日期：2019-10-24 状态：受控文件 www.quectel.com LTE Standard 安全防护设计 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 10 LTE Standard 安全防护设计 文档历史 修订记录 版本 1.0 日期 2019-10-24 作者 李循威 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 10 LTE Standard 安全防护设计 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 1 引言 ....................................................................................................................................................... 4 1.1. 简介 ............................................................................................................................................ 4 1.2. 适用模块 ..................................................................................................................................... 5 2 安全防护措施......................................................................................................................................... 6 2.1. 网络安全防护.............................................................................................................................. 6 2.2. Linux 登录防护 ........................................................................................................................... 6 3 常见攻击方式及防御手段 ...................................................................................................................... 7 3.1. GSM 伪基站攻击 ........................................................................................................................ 7 3.2. 私有 APN 攻击............................................................................................................................ 7 3.3. 模块 AT 命令漏洞攻击 ................................................................................................................ 7 3.4. SSL KEY 泄漏攻击 ..................................................................................................................... 8 3.5. OTA 攻击 .................................................................................................................................... 8 3.6. TSP 攻击 .................................................................................................................................... 8 4 安全防护建议......................................................................................................................................... 9 5 附录 A 术语缩写 ................................................................................................................................. 10 上海移远通信技术股份有限公司 3 / 10 LTE Standard 安全防护设计 1 引言 1.1. 简介 LTE Standard 模块默认 Linux 系统不接入网络，因此攻击者无法远程登录或控制模块操作系统。 如果需要使用 ECM、RNDIS、SGMII 和 Wi-Fi 等功能，则应该通过模块 AP 侧 Linux 系统的 TCP/IP 协议栈接入 Internet 网络。Linux 系统接入网络时，需要在客户设备与通信模块两部分都进行网络安全防 护。网络安全框架如下图所示。 Active Repair of Network Vulnerabilities WAN driver Firewall Linux IP stack Routing/NATing/IP filter/DMZ Data service TCP/IP stack Protocol stack RF driver RmNet driver SMD/ SMEM WWAN interface Base station Login protection SMD/ SMEM Nerwork drivers RNDIS network ECM network SGMII network Wi-Fi network driver driver driver driver SMD/ SMEM SMD/ SMEM USB driver stack TTY/ACM USB ECM/RNDIS SGMII/SDIO driver USB interface USB SDIO/SGMII interface Customer MCU as WWAN Port TCP/IP AT command USB GobiNet/NDIS/ QMI_WWAN/MBIM Customer MCU as LAN Port USB ECM/RNDIS SGMII Wi-Fi 图 1：网络安全框架 上海移远通信技术股份有限公司 4 / 10 1.2. 适用模块 本文档适用于以下 LTE Standard 模块：  EC2x：EC25、EC21、EC20 R2.0、EC20 R2.1  EG2x-G: EG25-G、EG21-G  EG9x：EG91、EG95  EM05  EP200F LTE Standard 安全防护设计 上海移远通信技术股份有限公司 5 / 10 LTE Standard 安全防护设计 2 安全防护措施 移远通信将持续在模块固件中合入 patch 以修复各类公开的软件漏洞，以及启用防火墙机制，关闭所 有不必要的远程监听端口、远程登录服务和网络端口（如 ADB 远程调试端口），从而避免模块被远程破解 和控制。 同时，移远通信将启用 Linux 控制台的登录防护，以避免恶意登录和调试。如果需要使用 Linux 控制台 进行必要的调试，需采用 RSA 非对称加密算法或采用硬件 ID 绑定的方式，且仅在通过由移远通信内部服 务器密码认证后方可开启相关服务。 2.1. 网络安全防护 网络安全防护支持基于 Netfilter 的防火墙功能并定期修复公开的网络程序漏洞，主要防护措施如下。 1. 过滤传入/传出数据包，以防御 SYN Flood、ping Flood、UDP Flood、Fragmentation bomb、 ICMP routing redirect bomb 等攻击； 2. 端口保护，即禁用不使用的端口，以及关闭端口扫描应答； 3. 若使用内置协议栈 SSL，移远通信后续将提供安全存储方案，用于储存客户的通信证书，避免客 户密钥证书被窃取。 2.2. Linux 登录防护 Linux 控制台的登录防护是安全防护的核心内容，主要防护措施如下。 1. 默认禁止远程登录端口和远程登录服务。如需开启 Linux 控制台，使用 RSA 非对称校验算法并通 过移远通信内部服务器密码认证后方可开启相关服务； 2. 禁止未授权用户登录（未授权用户无法获取模块登录信息）； 3. 绑定初始密码和硬件 ID，并采用强密码技术，避免一个模块密码被破解导致所有模块都被破解。 上海移远通信技术股份有限公司 6 / 10 LTE Standard 安全防护设计 3 常见攻击方式及防御手段 3.1. GSM 伪基站攻击 攻击方式： 攻击者利用模块接入的 GSM 网络将模块接入伪基站中，通过伪基站对模块进行网络攻击。 防御手段： 当客户程序与客户服务器进行端到端通信时，使用双向认证机制；在双向认证机制下，即便模块接入 伪基站后也不会将伪基站当成服务器。 3.2. 私有 APN 攻击 攻击方式： 攻击者接入模块所属的私有 APN 网络并进行扫描，寻找可以攻击的模块。 防御手段： 建议客户与运营商沟通，将私钥 APN 网络进行网络隔离，保证模块通信端口不会暴露在 APN 网络中。 3.3. 模块 AT 命令漏洞攻击 攻击方式： 攻击者通过 AT+QLINUXCMD 及功能上与其类似的 AT 命令对模块实施 linux 命令注入攻击。 防御手段： 模块已经不支持 AT+QLINUXCMD 及功能上与其类似的 AT 命令，不预留命令相关调试后门。 上海移远通信技术股份有限公司 7 / 10 LTE Standard 安全防护设计 3.4. SSL KEY 泄漏攻击 攻击方式： 攻击者通过模块 SSL KEY 明文保存获取 KEY，从而伪装成服务器与模块进行通信并控制模块。 防御手段： 若使用移远通信内置协议栈，模块支持安全存储功，移远通信可将 SSL KEY、证书、模块硬件 ID 进行 加密绑定，并写入特殊文件系统，建议客户在生产的过程中将 SSL KEY 及证书植入到模块中。 若使用外置协议栈，客户端需确保 SSL KEY 和证书的安全存储。 3.5. OTA 攻击 攻击方式： 攻击者劫持 OTA 服务器，获取升级包，从而实施攻击。 防御手段： 建议客户采用安全机制以保护 OTA 服务器，避免被攻击者劫持。模块端的升级程序将会对升级包进行 合法性验证。 3.6. TSP 攻击 攻击方式： 攻击者利用单向认证机制，伪装成 TSP，从而实施攻击。 防御手段： 建议客户应用程序与 TSP 服务器通信采用双向认证机制，防止中间人进行攻击。 上海移远通信技术股份有限公司 8 / 10 LTE Standard 安全防护设计 4 安全防护建议 在使用模块时，建议客户采取如下安全防护措施： 1. 与运营商沟通，将私有 APN 网络进行网络隔离，避免攻击者通过客户的私有 APN 网络对同一 APN 网络下的其他的设备发起攻击。 2. 当客户应用程序与客户服务器通信时，采用双向认证机制，避免中间人攻击，移远通信将提供该 机制所需的组件。 3. 对于客户设备远程控制接口，比如远程短信 AT 命令接口，需要采取双向鉴权或者启用白名单机 制，避免设备被非授权设备恶意控制。 4. 客户 OTA 服务器采用 OTA 安全机制，避免 OTA 服务器被攻击者劫持后下发错误的升级包导致模 块工作异常。 上海移远通信技术股份有限公司 9 / 10 LTE Standard 安全防护设计 5 附录 A 术语缩写 表 1：术语缩写 缩写 ACM AP APN DMZ ECM GSM ICMP MCU OTA RNDIS SDIO SGMII SMD SMEM SSL TCP/IP TSP USB WWAN 英文全称 Abstract Control Model Application Processor Access Point Name Demilitarized Zone Ethernet Networking Control Model Global System for Mobile Communications Internet Control Message Protocol Micro Control Unit Over-The-Air Remote Network Driver Interface Specification Secure Digital Input and Output Card Serial Gigabit Media Independent Interface Shared Memory Driver Shared Memory Secure Sockets Layer Transmission Control Protocol/Internet Protocol Telematics Service Provider Universal Serial Bus Wireless Wide Area Network 中文全称 抽象控制模型 应用程序处理器 接入点 隔离区 以太网网络控制模型 全球移动通信系统 互联网控制报文协议 微控制单元 空中下载 远程网络驱动接口规范 安全数字输入输出卡 串行千兆媒体独立接口 共享内存驱动 共享内存 安全套接层 传输控制协议/网际协议 远程通信服务提供商 通用串行总线 无线广域网 上海移远通信技术股份有限公司 10 / 10

MC25&M25&M35-R&M56-R &M08-R DFOTA 应用指导 GSM/GPRS/GNSS 模块系列 版本：MC25&M25&M35-R&M56-R&M08-R_DFOTA _应用指导_V1.0 日期：2020-07-08 状态：受控文件 www.quectel.com MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 文档历史 修订记录 版本 1.0 日期 作者 2020-07-08 李强 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 DFOTA 固件升级流程 ........................................................................................................................... 7 2.1. 通过 DFOTA 从 HTTP 服务器升级固件...................................................................................... 7 2.1.1. 获取差分固件包 ............................................................................................................... 8 2.1.2. 存储差分包至 HTTP 服务器 ............................................................................................ 8 2.1.3. 检查网络状况................................................................................................................... 8 2.1.4. 配置并激活 PDP 上下文以获取 IP 地址........................................................................... 8 2.1.5. 执行 AT 命令升级固件 ..................................................................................................... 9 2.2. 通过 DFOTA 从本地文件系统升级固件 ...................................................................................... 9 2.2.1. 获取差分固件包 ............................................................................................................... 9 2.2.2. 上传差分固件包至本地文件系统...................................................................................... 9 2.2.3. 执行 AT 命令升级固件 ................................................................................................... 10 3 DFTOA 相关 AT 命令详解 .................................................................................................................. 11 3.1. AT+QFOTADL= 使能模块通过 DFOTA 从 HTTP 服务器升级固件..................11 3.2. AT+QFOTADL= 使能模块通过 DFOTA 从本地文件系统升级固件............................. 12 4 举例 ..................................................................................................................................................... 14 4.1. 通过 DFOTA 从 HTTP 服务器升级固件.................................................................................... 14 4.2. 通过 DFOTA 从本地文件系统升级固件 .................................................................................... 15 5 错误代码 .............................................................................................................................................. 16 6 附录 A 参考文档及术语缩写............................................................................................................... 17 上海移远通信技术股份有限公司 3 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 表格索引 表 1： 错误码概览 ................................................................................................................. 16 表 2：参考文档 ........................................................................................................................................... 17 表 3：术语缩写 ........................................................................................................................................... 17 上海移远通信技术股份有限公司 4 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 图片索引 图 1：通过 DFOTA 从 HTTP 服务器升级固件 ............................................................................................. 7 图 2：通过 DFOTA 从本地文件系统升级固件 ............................................................................................. 9 上海移远通信技术股份有限公司 5 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 1 引言 移远通信 MC25&M25&M35-R&M56-R&M08-R 模块支持固件空中差分升级（DFOTA）功能，此功能 可 以 实 现 模 块 固 件 包 的 无 线 升 级 或 降 级 。 本 文 档 主 要 介 绍 如 何 通 过 DFOTA 功 能 升 级 移 远 通 信 MC25&M25&M35-R&M56-R&M08-R 模块的固件。 基于 DFOTA，用户通过差分包即可实现固件升级或降级。所述差分包仅包含当前固件版本和目标固件 版本之间的差异，因此数据传输量大大降低、传输时间大大缩短。 备注 对于 MC25&M25&M35-R&M56-R&M08-R 模块，DFOTA 的上限次数是 800 次。当升级次数超过 800 次 时可能会出现 Flash 损坏的情况，建议不要频繁升级固件。 上海移远通信技术股份有限公司 6 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 2 DFOTA 固件升级流程 2.1. 通过 DFOTA 从 HTTP 服务器升级固件 下图阐述了差分包储存在 HTTP 服务器上时，通过 DFOTA 升级固件的流程。 2. 将固件包放至HTTP 服务 器 HTTP Server 1. 获取差分固件包 GSM/GPRS (HTTP) 6. 通过GSM/GPRS网络从HTTP服务器下载差分固件包 Ext. MCU 3. 检查网络状态 4. 配置并激活PDP上下文以 获取IP地址 5. 执行AT+QFOTADL命令 Quectel Module 7. 升级模块固件 图 1：通过 DFOTA 从 HTTP 服务器升级固件 上海移远通信技术股份有限公司 7 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 如上图所示，通过 DFOTA 升级固件的步骤为： 第一步: 从移远通信获取差分固件包。 第二步: 将差分包放至 HTTP 服务器。 第三步: 检查网络状态。 第四步: 配置并激活 PDP 上下文以获取 IP 地址。 第五步: 执行命令 AT+QFOTADL，模块将通过 GSM/GPRS 网络从 HTTP 服务器下载差分固件包（第 六步）并升级固件（第七步）。 2.1.1. 获取差分固件包 升级之前，用户需先通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和 目标版本信息发送给移远通信或模块代理商获取相应的差分包。 2.1.2. 存储差分包至 HTTP 服务器 用户需自建 HTTP 服务器以便 DFOTA 功能的使用。服务器自建完成后，需将差分包存储至服务器并 记录下 HTTP 路径。 2.1.3. 检查网络状况 在固件升级之前，需通过如下命令检查模块上电后是否已注册上网络：  AT+CSQ：查询信号质量。  AT+CGREG?：查询网络注册状态。 有关以上命令的详细信息，请参考文档 [1]。 如果模块已注册上网络，则可开始配置并激活上下文。若模块没有注册上网络，请检查(U)SIM 卡是否 正常插入，天线连接是否正常。如若需要，可联系移远通信技术支持。 2.1.4. 配置并激活 PDP 上下文以获取 IP 地址 模块注网后，使用如下命令配置并激活 PDP 上下文以获取 IP 地址：  AT+QIFGCNT=：选择 PDP 文本。  AT+QICSGP=1[,,,]：选择 GPRS 作为承载，配置 APN。  AT+QIREGAPP：启动任务。  AT+QIACT：激活 PDP 以获取 IP 地址 。 有关以上命令的详细信息，请参考文档 [1]。 上海移远通信技术股份有限公司 8 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 2.1.5. 执行 AT 命令升级固件 获取 IP 地址后，执行 AT+QFOTADL 命令，随后模块将从 HTTP 服务器下载差分包并升级固件。有关 该命令的详细信息，请参考第 3 章。 2.2. 通过 DFOTA 从本地文件系统升级固件 下图阐释了差分包存储在本地文件系统时，通过 DFOTA 升级固件的流程。 1. 获取差分固件包 External MCU 2. 执行AT+QFUPL命令将差分固件包 上传 至本地 文件系 统 3. 执行AT+QFOTADL=1命令升 级固 件 Quectel Module 图 2：通过 DFOTA 从本地文件系统升级固件 2.2.1. 获取差分固件包 升级之前，用户需先通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和 目标版本信息发送给移远通信或模块代理商以获取相应的差分包。 2.2.2. 上传差分固件包至本地文件系统 通过如下命令将差分固件包上传至本地文件系统，相关命令如下：  AT+QFUPL=[,[,[,]]]：上传差分包至本地文件系 统。 有关该命令的详细信息，请参考文档 [2]。 上海移远通信技术股份有限公司 9 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 2.2.3. 执行 AT 命令升级固件 差分包上传至本地文件系统之后，执行命令 AT+QFOTADL=1 升级固件。 上海移远通信技术股份有限公司 10 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 3 DFTOA 相关 AT 命令详解 AT+QFOTADL 命令用于使能模块通过 DFOTA 进行固件升级。 3.1. AT+QFOTADL= 使能模块通过 DFOTA 从 HTTP 服务器升 级固件 差分包被储存至 HTTP 服务器后，用户可执行 AT+QFOTADL=命令使能模块通过 DFOTA 进行固件升级。命令执行成功后，模块将从 HTTP 服务器下载差分包，并进行固件升级。若升级成 功，模块会重启。若升级失败，会返回一个错误代码，模块退出 DFOTA 升级，固件仍是旧版本。 AT+QFOTADL= 使能模块通过 DFOTA 从 HTTP 服务器升级固件 测试命令 响应 AT+QFOTADL=? 设置指令 OK 响应 AT+QFOTADL= OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','HTTPEND', +PDP DEACT +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 上海移远通信技术股份有限公司 11 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 最大响应时间 特性说明 若错误与 ME 功能有关： +CME ERROR: 300 毫秒 参数配置立即生效（实际是否生效取决于网络），且 掉电不保存。 参数 带双引号的字符串型。最大长度为 255 字节。以 HTTP://开始，例如：'HTTP: //:/'。 字符串类型。包含在中，表示 HTTP 服务器的 IP 地址或域名。 整型。包含在中，表示 HTTP 服务器端口。默认值：80。范围： 1~65535。 字符串类型。包含在中，表示 HTTP 服务器上差分包路径。 整型。固件差分包下载过程中的错误码。0 表示升级成功，其他任何数值均表 示升级失败。详细信息请参考第 5 章。 整型。下载或者升级进度。范围：0~100。单位：百分比。 备注 若模块在上报消息+QIND: 'FOTA','UPDATING',的过程中断电，将自动进入强制升级模式， 即下次启动时将继续升级。升级界面如下所示： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',2% +QIND: 'FOTA','UPDATING',4% ... +QIND: 'FOTA','END',0 3.2. AT+QFOTADL= 使能模块通过 DFOTA 从本地文件系统升级固件 差分包被存储至本地文件系统后，用户可执行 AT+QFOTADL=命令使能模块通过 DFOTA 进行 固件升级。若升级成功，模块会重启。若升级失败，会返回一个错误代码，模块退出 DFOTA 升级，固件仍 是旧版本。 AT+QFOTADL= 使能模块通过 DFOTA 从本地文件系统升级固件 测试命令 响应 AT+QFOTADL=? OK 上海移远通信技术股份有限公司 12 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 设置命令 AT+QFOTADL= 最大响应时间 特性说明 响应 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 若错误与 ME 功能有关： +CME ERROR: 10 秒 参数配置立即生效（实际是否生效取决于网络），且 掉电不保存。 参数 整型。 1 开始升级。 整型。升级流程进度。范围：0~100。单位：百分比。 整型。0 表示升级成功，其他任何数值均表示升级失败。详细信息请参考第 5 章。 备注 1. 差分固件包名称固定为'fota.pack'。 2. 如果将模块波特率设置为固定波特率，模块在重启升级上报消息+QIND: 'FOTA','UPDATING',时以该波特率上报；如果将模块波特率设置为自动波特率，模块 在重启升级上报 +QIND: 'FOTA','UPDATING',时则使用 115200 波特率上报。 3. 如果在上报消息 +QIND: 'FOTA','UPDATING',的过程中意外断电，下次启动时，模块 将自动进入强制升级模式，并继续升级进度。升级界面如下所示： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',2% +QIND: 'FOTA','UPDATING',4% ... +QIND: 'FOTA','END',0 上海移远通信技术股份有限公司 13 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 4 举例 4.1. 通过 DFOTA 从 HTTP 服务器升级固件 //从 HTTP 服务器获取差分固件包并升级固件。 //HTTP 服务器地址为 http://www.quectel.com:8111/DFOTA/A2B.pack。 AT+CSQ;+CGREG?;+CPIN? //查询网络状态。 +CSQ: 25,0 +CGREG: 0,1 +CPIN: READY OK AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' //配置 PDP 上下文。 OK AT+QIREGAPP OK AT+QIACT //激活 PDP 上下文获取 IP 地址。 OK //执行 AT+QFOTADL 命令通过 HTTP 进行 DFOTA 升级，随后模块从 HTTP 服务器下载差分固件包并升级 固件。 AT+QFOTADL='http://www.quectel.com:8111/DFOTA/A2B.pack' OK +QIND: 'FOTA','HTTP START' //开始下载。 +QIND: 'FOTA','DOWNLOADING',0% +QIND: 'FOTA','DOWNLOADING',10% ... +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 //完成从 HTTP 服务器下载差分包。 +PDP DEACT 上海移远通信技术股份有限公司 14 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 +QIND: 'FOTA','START' //开始更新。 +QIND: 'FOTA','UPDATING', 2% //更新进程。 +QIND: 'FOTA','UPDATING', 4% ... +QIND: 'FOTA','UPDATING', 100% +QIND: 'FOTA','END',0 //固件升级成功。 4.2. 通过 DFOTA 从本地文件系统升级固件 //执行 AT+QFUPL 命令将差分包上传至本地文件系统。 AT+QFUPL='fota.pack',156104 CONNECT //差分固件包名称固定为'fota.pack'。 //报告此字符串后，主机开始向模块发送文件内容。 +QFUPL: 156104,4300 OK //执行 AT+QFOTADL 通过本地文件系统进行 DFOTA 升级，随后模块开始升级固件。 AT+QFOTADL=1 OK +QIND: 'FOTA','START' //开始更新。 +QIND: 'FOTA','UPDATING', 2% //更新进程。 +QIND: 'FOTA','UPDATING', 4% ... +QIND: 'FOTA','UPDATING', 100% +QIND: 'FOTA','END',0 //固件升级成功。 上海移远通信技术股份有限公司 15 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 5 错误代码 本章介绍了与移动设备和网络相关的错误码。有关的详细信息，请参考下表。 表 1： 错误码概览 6500 6501 6502 6503 6504 6505 6506 6507 6508 6509 含义 不明错误 参数错误 固件包太大 下载失败 未找到升级包 写入文件失败 升级包不存在 升级包错误 升级失败 空间不足 上海移远通信技术股份有限公司 16 / 17 MC25&M25&M35-R&M56-R&M08-R DFOTA 应用指导 6 附录 A 参考文档及术语缩写 表 2：参考文档 序号 [1] [2] 文件名称 Quectel_MC25&M25&M35-R&M56-R&M08-R_AT 命 令手册 Quectel_GSM_FILE_AT_Commands_Manual 备注 MC25&M25&M35-R&M56-R&M08-R AT 命令手册 GSM 模块上传文件 AT 命令手册 表 3：术语缩写 缩写 APN DFOTA FOTA GPRS GSM HTTP IP PDP URL 英文全称 Access Point Name Delta Firmware Upgrade Over–The–Air Firmware Over-The-Air General Packet Radio Service Global System for Mobile Communications Hyper Text Transport Protocol Internet Protocol Packet Data Protocol Uniform Resource Locator 中文全称 接入点名称 差分固件空中升级 固件无线升级 通用无线分组业务 全球移动通信系统 超文本传输协议 网络协议 分组数据协议 统一资源定位符 上海移远通信技术股份有限公司 17 / 17

GSM HTTPS 应用指导 GSM/GPRS 模块系列 版本：GSM_HTTPS_应用指导_V1.0 日期：2020-01-13 状态：受控文件 www.quectel.com GSM HTTPS 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 22 文档历史 修订记录 版本 1.0 日期 2020-01-13 作者 陶亮亮/ 叶姗姗/ 李家杨 变更表述 初始版本 GSM HTTPS 应用指导 上海移远通信技术股份有限公司 2 / 22 GSM HTTPS 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 1.1. SSL 版本和加密套件 .................................................................................................................. 5 1.2. SSL 功能使用流程...................................................................................................................... 6 1.3. 错误处理 ..................................................................................................................................... 7 1.3.1. PDP 激活失败.................................................................................................................. 7 2 AT 命令详解 .......................................................................................................................................... 8 2.1. AT 命令类型................................................................................................................................ 8 2.2. AT 命令详解............................................................................................................................... 8 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 ....................................................................... 8 2.2.2. AT+QSECWRITE 添加证书或密钥............................................................................. 12 2.2.3. AT+QSECREAD 查询证书或密钥的校验和 ................................................................ 13 2.2.4. AT+QSECDEL 删除证书或密钥.................................................................................. 14 3 举例 ..................................................................................................................................................... 16 3.1. 加载证书和密钥到 RAM 的 SSL 连接....................................................................................... 16 3.2. 加载证书和密钥到 NVRAM 的 SSL 连接.................................................................................. 17 3.3. 关于 HTTPS 的 SSL 功能的示例.............................................................................................. 17 3.3.1. 发送 HTTP GET 响应 .................................................................................................... 17 3.3.2. 发送 HTTP POST 请求.................................................................................................. 19 4 附录 A 参考文档和术语缩写 .............................................................................................................. 21 上海移远通信技术股份有限公司 3 / 22 GSM HTTPS 应用指导 表格索引 表 1：支持的 SSL 版本 ........................................................................................................................................ 5 表 2：支持的 SSL 加密套件................................................................................................................................. 6 表 3：AT 命令类型及响应 .................................................................................................................................... 8 表 4：参考文档 .................................................................................................................................................. 21 表 5：术语缩写 .................................................................................................................................................. 21 上海移远通信技术股份有限公司 4 / 22 GSM HTTPS 应用指导 1 引言 本文档主要介绍移远通信 GSM 模块的 HTTPS 功能的使用方法。HTTPS 用于保护数据传输。 安全超文本传输协议（HTTPS）是超文本传输协议（HTTP）与 SSL/TLS 协议的组合，提供加密通信 和网络 Web 服务器的安全身份验证。HTTPS 即在 SSL/TLS 协议基础上简单叠加 HTTP 协议，因此在标准 HTTP 通信中增加了 SSL/TLS 协议的安全功能。 在某些情况下，为了确保通信的私密性，服务器和客户端之间的通信应采用加密方式，并且 SSL 功能 可以防止在通信过程中数据被窃听、篡改或伪造。 本文档适用于移远通信所有 GSM 模块。 1.1. SSL 版本和加密套件 当前 GSM 模块支持的 SSL 版本如下： 表 1：支持的 SSL 版本 SSL 版本 SSL3.0 TLS1.0 TLS1.1 TLS1.2 下表为移远通信 GSM 模块支持的 SSL 加密套件。有关加密套件的详细说明，请参阅《RFC 2246-TLS 协议版本 1.0》。 上海移远通信技术股份有限公司 5 / 22 表 2：支持的 SSL 加密套件 加密套件 0X0035 0X0005 0X0004 0X000A 0X002F 0X003D 加密套件名称 TLS_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA256 GSM HTTPS 应用指导 1.2. SSL 功能使用流程 步骤 1：通过命令 AT+QSECWRITE 将证书和密钥导入 RAM 或 NVRAM。命令 AT+QSECDEL 用于 删除证书和密钥，命令 AT+QSECREAD 用于检查证书和密钥的校验和。如果不需要服务器和客户端身份 验证，请跳过此步骤。 步骤 2：通过命令 AT+QICSGP 配置上下文的 APN、用户名和密码。通过命令 AT+QIREGAPP 注册 到 TCP/IP 协议栈。 步骤 3：通过命令 AT+QIACT 激活 GPRS PDP 上下文。激活上下文后，通过命令 AT+QILOCIP 查询 本地 IP 地址。 步骤 4：通过命令 AT+QSSLCFG 配置 SSL 版本、加密套件、服务器认证、客户端认证、服务器根 CA 证书、客户端证书和客户端密钥。 步骤 5：通过命令 AT+QHTTPURL 配置 URL。返回 CONNECT 后，输入格式为'https:URL'的 URL。 步骤 6：通过 AT+QHTTPGET 命令发送 HTTP GET 请求。 步骤 7：通过 AT+QHTTPREAD 命令读取 HTTP 服务器响应。 上海移远通信技术股份有限公司 6 / 22 GSM HTTPS 应用指导 1.3. 错误处理 1.3.1. PDP 激活失败 如果无法通过 AT+QIACT 命令激活 PDP 上下文，请检查以下配置： 1. 通过 AT+CGATT?命令查询是否已附着到 PS 域。如果不是，请执行 AT+CGATT=1 命令附着 PS 域。 2. 通过 AT+CGREG?命令查询 AT+CGREG 状态，并确认已经注册 PS 域。 3. 通过 AT+QIREGAPP 命令查询 PDP 上下文参数，并确保已设置指定 PDP 上下文的 APN。 4. 确保指定的 PDP 上下文 ID 既未被 PPP 使用，也未被 AT+CGACT 命令激活。 5. 该模块仅同时支持两路被激活的 PDP 上下文，因此必须确保被激活的 PDP 上下文的数量小于 2。 如果检查结果正确，但是执行命令 AT+QIACT 的结果仍然失败，请重新启动模块以解决此问题。重新 启动模块后，请至少检查上述配置 3 次，每次间隔 10 分钟，以避免频繁重启模块。 上海移远通信技术股份有限公司 7 / 22 GSM HTTPS 应用指导 2 AT 命令详解 2.1. AT 命令类型 表 3：AT 命令类型及响应 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令或内部程序可支持的参数取值列 表或范围。 AT+? 返回相应设置命令的当前参数设置值。 AT+=[,[,[... 设置用户可自定义的参数值。 ]]] AT+ 主动执行内部程序实现的功能集。 备注 1. ：参数名称，实际命令行中不包括尖括号 < >；添加下划线'_'的参数取值为默认值； 2. [...]：可选参数，实际命令行中不包括方括号 [ ]；若无特别说明，可选参数省略时将采用默认值。 2.2. AT 命令详解 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 该命令用于配置 SSL 版本、加密套件、安全级别、服务器根 CA 证书、客户端证书、客户端密钥、是 否忽略 RTC 时间、HTTP/HTTPS 的 SSL 上下文索引号。这些参数将在握手过程中使用。 CTX 是 SSL 上下文的缩写，而是 SSL 上下文的索引。移远通信 GSM 模块最多支持 6 个 SSL 上下文。可以基于一个 SSL 上下文建立多个 SSL 连接。SSL 版本和加密套件等设置存储在 SSL 上 下文中，并将应用于与该 SSL 上下文关联的新 SSL 连接。 AT+QSSLCFG 配置 SSL 上下文的参数 测试命令 AT+QSSLCFG=? 响应 +QSSLCFG: 'type',(支持的列表),'value' 上海移远通信技术股份有限公司 8 / 22 GSM HTTPS 应用指导 查询命令 查询上下文的设置： AT+QSSLCFG='ctxindex', OK 响应 +QSSLCFG: ,,,,,, 设置命令 配置 SSL 版本： AT+QSSLCFG='sslversion',[,] OK 或者 ERROR 响应 如果省略，查询 SSL 版本： +QSSLCFG: 'sslversion', OK 设置命令 配置加密套件： AT+QSSLCFG='ciphersuite',[,] 如果未省略，设置 SSL 版本： OK 或者 ERROR 响应 如果省略，查询 SSL 加密套件： +QSSLCFG: 'ciphersuite', OK 设置命令 配置身份验证模式： AT+QSSLCFG='seclevel',[,] 如果未省略，设置 SSL 加密套件： OK 或者 ERROR 响应 如果省略，查询身份验证模式： +QSSLCFG: 'seclevel', OK 设置命令 配置服务器根 CA 证书： AT+QSSLCFG='cacert', 如果未省略，设置验证模式： OK 或者 ERROR 响应 如果省略，查询服务器根 CA 证书的路径： +QSSLCFG: 'cacert', 上海移远通信技术股份有限公司 9 / 22 GSM HTTPS 应用指导 [,] OK 设置命令 配置客户端证书： AT+QSSLCFG='clientcert',[,] 如果未省略，设置服务器根 CA 证书的路径： OK 或者 ERROR 响应 如果省略，查询客户端证书的路径： +QSSLCFG: 'clientcert', OK 设置命令 配置客户端密钥： AT+QSSLCFG='clientkey',[,] 如果未省略，设置客户端证书的路径： OK 或者 ERROR 响应 如果省略，查询客户端密钥的路径： +QSSLCFG: 'clientkey', OK 设置命令 配置是否忽略 RTC 时间： AT+QSSLCFG='ignorertctime'[,] 如果未省略，设置客户端私钥的路径： OK 或者 ERROR 响应 如果省略，查询当前是否忽略 RTC 时间： +QSSLCFG: 'ignorertctime', OK 设置命令 启用/禁用 HTTPS 功能： AT+QSSLCFG='https'[,] 如果未省略，设置是否忽略 RTC 时间： OK 或者 ERROR 响应 如果省略，查询是否启用 HTTPS 功能： +QSSLCFG: 'https', OK 如果未省略，设置是否启用 HTTPS 功能： 上海移远通信技术股份有限公司 10 / 22 GSM HTTPS 应用指导 设置命令 为 HTTPS 配置 SSL 上下文索引： AT+QSSLCFG='httpsctxi'[,] OK 或者 ERROR 响应 如果省略，为 HTTPS 查询 SSL 上下文 索引： +QSSLCFG: 'httpsctxi', OK 最大响应时间 特性说明 如果未省略，则为 HTTPS 设置 SSL 上 下文索引： OK 或者 ERROR 300 毫秒 该命令立即生效。 不保存参数配置。 参数 整型。SSL 上下文索引。范围：0-5。 整型。配置支持的 SSL 版本。 0 SSL3.0 1 TLS1.0 2 TLS1.1 3 TLS1.2 4 所有 配置加密套件。 0X0035 TLS_RSA_WITH_AES_256_CBC_SHA 0X002F TLS_RSA_WITH_AES_128_CBC_SHA 0X0005 TLS_RSA_WITH_RC4_128_SHA 0X0004 TLS_RSA_WITH_RC4_128_MD5 0X000A TLS_RSA_WITH_3DES_EDE_CBC_SHA 0X003D TLS_RSA_WITH_AES_256_CBC_SHA256 整型。配置认证模式。 0 无需认证 1 管理服务器认证 2 如果远程服务器要求，则管理服务器和客户端认证 字符串类型。配置服务器根 CA 证书。 字符串类型。配置客户端证书。 字符串类型。配置客户端私钥。 上海移远通信技术股份有限公司 11 / 22 GSM HTTPS 应用指导 整型。配置是否忽略 RTC 时间。 0 不忽略 RTC 时间 1 忽略 RTC 时间 整型。启用/禁用 HTTPS 功能。 0 禁用 HTTPS 功能 1 启用 HTTPS 功能 整型。HTTPS 的 SSL 上下文。该参数是 SSL 上下文的索引。范围：0-5。如果主 机未对其进行配置，则其值为-1。 备注 1. ,和的格式如下： 'RAM:filename' 文件已上传到 RAM 'NVRAM:filename' 文件已上传到 NVRAM，支持服务器根 CA 证书，一个客户端证书和一个客户 端私钥。服务器根 CA 证书的文件名必须为 CA0，客户端证书的文件名必须 为 CC0，客户端私钥的文件名必须为 CK0。 CA0 识别服务器根 CA 证书 CC0 识别客户证书 CK0 识别客户端密钥 2. 如果设置无需认证，则不需要安全数据。如果已设置服务器认证，则需要配置服务器 CA 证书。如果 已设置服务器和客户端认证，则需要配置客户端证书、服务器 CA 证书和客户端私钥。 2.2.2. AT+QSECWRITE 添加证书或密钥 该命令用于将用户证书、用户密钥或服务器根 CA 证书添加到 RAM 或 NVRAM。证书和密钥将以加密 方式存储在这些存储器中。将证书和密钥存储在这些存储器中之后，主机将无法从这些存储器中读取数据， 而只能查询数据校验和。请注意，证书或密钥在添加到 RAM 或 NVRAM 中之前，不应存在于相应的存储器 中；如果已经存在，请将其删除，然后将其添加到相应的存储器中。 AT+QSECWRITE 添加证书或密钥 测试命令 AT+QSECWRITE=? 响应 +QSECWRITE: ,[,支持的 列表] 查询命令 AT+QSECWRITE? 设置命令 AT+QSECWRITE=,[,] OK 响应 OK 或者 ERROR 响应 如果 AT 命令格式正确： CONNECT 上海移远通信技术股份有限公司 12 / 22 特性说明 GSM HTTPS 应用指导 模块切换到数据模式后，可以输入证书或密钥数据。当输入数 据的大小达到（单位：字节）或模块从 UART 接收 到+++时，模块将返回命令模式并响应以下代码。 +QSECWRITE: , OK 若出现任何错误： +CME ERROR: 该命令立即生效。另请参阅如下备注。 参数 字符串类型。要存储的文件名。格式如下： 'RAM:filename' 文件已上传到 RAM 'NVRAM:filename' 文件已上传到 NVRAM。支持服务器根 CA 证书，一个客户端证 书和一个客户端私钥。服务器根 CA 证书的文件名必须为 CA0， 客户端证书的文件名必须为 CC0，客户端私钥的文件名必须为 CK0。 CA0 识别服务器根 CA 证书 CC0 识别客户证书 CK0 识别客户端密钥 要上传的文件大小。单位：字节。 如果文件上传到 RAM，最大为 32768 字节，如果文件上传到 NVRAM，最大为 2017 字 节，最小为 1 字节。 等待从 UART 输入数据的时间（单位：秒）。单位：秒。范围：3-200。默认值：100。 实际上传数据的大小。单位：字节。 上传数据的校验和。 备注 当文件上传到 RAM 时，将不会保存配置。当文件上传到 NVRAM 时，将自动保存参数配置。 2.2.3. AT+QSECREAD 查询证书或密钥的校验和 该命令用于查询证书或密钥的校验和。如果校验和与用户拥有的原始校验和不同，则会发生错误。 AT+QSECREAD 查询证书或密钥的校验和 测试命令 AT+QSECREAD=? 响应 +QSECREAD: 上海移远通信技术股份有限公司 13 / 22 查询命令 AT+QSECREAD? 设置命令 AT+QSECREAD= 特性说明 GSM HTTPS 应用指导 OK 响应 OK 或者 ERROR 响应 +QSECREAD: , OK 若出现任何错误： +CME ERROR: / 参数 字符串类型。要存储的文件名，格式如下： 'RAM:filename' 查询 RAM 中存储的文件的校验和 'NVRAM:filename' 查询 NVRAM 中存储的文件的校验和。支持服务器根 CA 证书， 一个客户端证书和一个客户端私钥。服务器根 CA 证书的文件名 必须为 CA0，客户端证书的文件名必须为 CC0，客户端私钥的文 件名必须为 CK0。 CA0 识别服务器根 CA 证书 CC0 识别客户证书 CK0 识别客户端密钥 表示证书或密钥是否正确。通过 AT+QSECWRITE 上传证书或密钥时，将同时存储证书 或密钥的校验和。执行命令 AT+QSECREAD 后，将再次计算证书或密钥的校验和。然 后将此校验和与 AT+QSECWRITE 存储的校验和进行比较。若相同，则证书或密钥正确， 否则错误。 0 证书或密钥错误 1 证书或密钥正确 文件的校验和。 2.2.4. AT+QSECDEL 删除证书或密钥 该命令用于删除证书或密钥。 AT+QSECDEL 删除证书或密钥 测试命令 AT+QSECDEL=? 响应 +QSECDEL: 上海移远通信技术股份有限公司 14 / 22 查询命令 AT+QSECDEL? 设置命令 AT+QSECDEL= 特性说明 OK 响应 OK 或 ERROR 响应 OK 若出现任何错误： +CME ERROR: / GSM HTTPS 应用指导 参数 字符串类型。要存储的文件名，格式如下： 'RAM:filename' 删除存储在 RAM 中的证书或密钥 'NVRAM:filename' 删除存储在 NVRAM 中的证书或密钥。支持服务器根 CA 证书， 一个客户端证书和一个客户端私钥。服务器根 CA 证书的文件名 必须为 CA0，客户端证书的文件名必须为 CC0，客户端私钥的文 件名必须为 CK0。 CA0 识别服务器根 CA 证书 CC0 识别客户证书 CK0 识别客户端密钥 上海移远通信技术股份有限公司 15 / 22 GSM HTTPS 应用指导 3 举例 3.1. 加载证书和密钥到 RAM 的 SSL 连接 服务器和客户端验证的方式如下所示，其中，证书和密钥存储在 RAM 中。如果不需要服务器和客户端 身份验证，请跳过该步骤。 //将证书和密钥上传到 RAM。 AT+QSECWRITE='RAM:ca_cert.pem',1614,100 CONNECT //输入 ca_cert.pem，数据大小为 1614 字节。 //将服务器根 CA 证书上传到 RAM。 +QSECWRITE: 1614,4039 OK AT+QSECWRITE='RAM:client_cert.pem',1419,100 //将客户端证书上传到 RAM。 CONNECT //输入 client_cert.pem，数据大小为 1419 字节。 +QSECWRITE: 1419,618 OK AT+QSECWRITE='RAM:client_key.pem',1679,100 //将客户端私钥上传到 RAM。 CONNECT //输入 client_key.pem，数据大小为 1679 字节。 +QSECWRITE: 1679,83a7 OK 上海移远通信技术股份有限公司 16 / 22 GSM HTTPS 应用指导 3.2. 加载证书和密钥到 NVRAM 的 SSL 连接 服务器验证和客户端验证的方式如下所示，其中，证书和密钥存储在 NVRAM 中。如果不需要服务器 和客户端身份验证，请跳过该步骤。 //将证书和密钥上传到 NVRAM。 AT+QSECWRITE='NVRAM:CA0',1614,100 CONNECT //将服务器根 CA 证书上传到 NVRAM。 //输入 CA0，数据大小为 1614 字节。 +QSECWRITE: 1614,4039 OK AT+QSECWRITE='NVRAM:CC0',1419,100 CONNECT //将客户端证书上传到 NVRAM。 //输入 CC0，数据大小为 1419 字节。 +QSECWRITE: 1419,618 OK AT+QSECWRITE='NVRAM:CK0',1679,100 CONNECT //将客户端私钥上传到 NVRAM。 //输入 CK0，数据大小为 1679 字节。 +QSECWRITE: 1679,83a7 OK 3.3. 关于 HTTPS 的 SSL 功能的示例 3.3.1. 发送 HTTP GET 响应 //步骤 1：配置并激活 PDP 上下文。 AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' //将上下文 0 设置为场景上下文。 //将承载类型设置为 GPRS，将 APN 设置为'CMNET'，其中 上海移远通信技术股份有限公司 17 / 22 GSM HTTPS 应用指导 OK AT+QIREGAPP OK AT+QIACT OK AT+QILOCIP 10.1.83.188 没有用户名和加密。 //注册到 TCP/IP 协议栈。 //激活 GPRS PDP 上下文. //查询本地 IP 地址。 //步骤 2：配置 SSL 版本、加密套件和无身份验证模式， AT+QSSLCFG='sslversion',1,4 //配置 SSL 版本。 OK AT+QSSLCFG='seclevel',1,2 //将 SSL 验证级别设为 1，表示使用 AT+QSECWRITE 上传 OK 服务器根 CA 认证、客户端认证和客户端私钥。 AT+QSSLCFG='ciphersuite',1,'0XFFFF' //配置加密套件。 OK AT+QSSLCFG='cacert',1,'RAM:ca_cert.pem' OK AT+QSSLCFG='clientcert',1,'RAM:client_cert.pem' OK AT+QSSLCFG='clientkey',1,'RAM:client_key.pem' OK AT+QSSLCFG='ignorertctime',1 //忽略 RTC 时间。 OK //步骤 3：打开 HTTPS 功能并配置 HTTPS 的 SSL 上下文索引。 AT+QSSLCFG='https',1 //打开 HTTPS 功能。 OK AT+QSSLCFG='httpsctxi',1 //配置 SSL 上下文索引为 1。 OK AT+QHTTPURL=34,60 //设置 URL。 CONNECT ………. //例如：输入 34 字节：https://124.74.41.170:5008/1K.html。 OK AT+QHTTPGET=60 //发送 HTTPS GET 请求。 OK AT+QHTTPREAD=30 //读取 HTTPS 服务器的响应。 CONNECT …….. //将服务器的响应数据输出到 UART 端口。 OK AT+QIDEACT DEACT OK 上海移远通信技术股份有限公司 18 / 22 GSM HTTPS 应用指导 3.3.2. 发送 HTTP POST 请求 //步骤 1：配置并激活 PDP 上下文。 AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' OK AT+QIREGAPP OK AT+QIACT OK AT+QILOCIP 10.1.83.188 //将上下文 0 设置为前景上下文。 //将承载类型设置为 GPRS，将 APN 设置为'CMNET'， 该名称没有用户名和密码。 //注册到 TCP/IP 协议栈。 //激活 GPRS PDP 上下文。 //查询本地 IP 地址。 //步骤 2：配置 SSL 版本，加密套件和无身份验证模式。 AT+QSSLCFG='sslversion',2,4 //配置 SSL 版本。 OK AT+QSSLCFG='seclevel',2,2 OK //将 SSL 验证级别设为 2，表示使用 AT+QSECWRITE 上传服务器根 CA 认证、客户端认证和客户端私钥。 AT+QSSLCFG='ciphersuite',2,'0XFFFF' //配置加密套件。 OK AT+QSSLCFG='cacert',2,'RAM:ca_cert.pem' OK AT+QSSLCFG='clientcert',2,'RAM:client_cert.pem' OK AT+QSSLCFG='clientkey',2,'RAM:client_key.pem' OK AT+QSSLCFG='ignorertctime',1 //忽略 RTC 时间。 OK //步骤 3：打开 HTTPS 功能并配置 HTTPS 的 SSL 上下文索引。 AT+QSSLCFG='https',1 //打开 HTTPS 功能。 OK AT+QSSLCFG='httpsctxi',2 //配置 SSL 上下文索引为 2。 OK AT+QHTTPURL=45,60 //设置 URL。 CONNECT ………. //例如：输入 45 字节：https://220.180.239.212:8011/processorder.php。 OK AT+QHTTPPOST=48,60,60 //发送 POST 数据。 CONNECT ………. 上海移远通信技术股份有限公司 19 / 22 GSM HTTPS 应用指导 //例如：输入 48 字节：Message=1111&Appleqty=2222&Orangeqty=3333&find=1。 OK AT+QHTTPREAD=30 //读取 HTTPS 服务器的响应。 CONNECT …….. //将服务器的响应数据输出到 UART 端口。 OK AT+QIDEACT DEACT OK 上海移远通信技术股份有限公司 20 / 22 GSM HTTPS 应用指导 4 附录 A 参考文档和术语缩写 表 4：参考文档 序号 文件名 备注 [1] GSM 07.07 数字蜂窝电信（阶段 2+），GSM 移动设备（ME）的 AT 命令集 [2] GSM 07.10 支持 GSM 07.10 复用协议 [3] Quectel_GSM_HTTP_应用指导 适用于 GSM 模块的 HTTP 应用指导 表 5：术语缩写 缩写 CTX GSM HTTP HTTPS ID IP ME NVRAM PDP PPP RAM RTC SSL 英文全称 SSL Context Global System for Mobile Communications Hypertext Transfer Protocol Hypertext Transfer Protocol Secure Identification Internet Protocol Mobile Equipment Non-Volatile Random Access Memory Packet Data Protocol Point-to-Point Protocol Random Access Memory Real-time Clock Security Socket Layer 中文全称 SSL 上下文 全球移动通信系统 超文本传输协议 超文本传输安全协议 身份标识 互联网协议 移动设备 非易失性随机访问存储器 分组数据协议 点对点协议 随机存取存储器 实时时钟 安全套接层 上海移远通信技术股份有限公司 21 / 22 TCP/IP TLS URC GSM HTTPS 应用指导 Transmission Control Protocol/Internet Protocol 传输控制协议/网际协议 Transport Layer Security 安全传输层协议 Unsolicited Result Code 非请求结果码 上海移远通信技术股份有限公司 22 / 22

M26 MQTT Application Note GSM/GPRS Module Series Rev. M26_MQTT_Application_Note_V1.0 Date: 2017-06-12 www.quectel.com GSM/GPRS Module Series M26 MQTT Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2017. All rights reserved. M26_MQTT_Application_Note Confidential / Released 1 / 25 GSM/GPRS Module Series M26 MQTT Application Note About the document History Revision 1.0 Date CQouneficdteenl tial 2017-06-12 Author Louis GU/ Sherlock ZHAO Description Initial M26_MQTT_Application_Note Confidential / Released 2 / 25 GSM/GPRS Module Series M26 MQTT Application Note Contents About the document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 4 1 Introduction ....................................................................................................................................... 5 2 MQTT Data Interaction ...................................................................................................................... 6 3 MQTT AT Commands........................................................................................................................ 7 3.1. AT Command Syntax ............................................................................................................ 7 3.2. Description of AT Commands................................................................................................ 8 4 5 6 3.2.1. 3.2.2. 3.2.3. 3.2.4. l 3.2.5. te 3.2.6. 3.2.7. c l 3.2.8. AT+QMTCFG Configure Parameters of MQTT ........................................................... 8 AT+QMTOPEN Open a Network for MQTT Client .....................................................11 AT+QMTCLOSE Close a Network for MQTT Client .................................................. 12 AT+QMTCONN Connect a Client to MQTT Server ................................................... 12 AT+QMTDISC Disconnect a Client from MQTT Server............................................. 14 AT+QMTSUB Subscribe to Topics ............................................................................ 14 AT+QMTUNS Unsubscribe from Topics .................................................................... 15 AT+QMTPUB Publish Messages .............................................................................. 16 ue tia MQTT Related Notifications ........................................................................................................... 18 4.1.1. Description of URC '+QMTSTAT' ................................................................................ 18 4.1.2. Description of '+QMTRECV' ....................................................................................... 19 Q n Examples ......................................................................................................................................... 20 e 5.1. Example of MQTT Operation without SSL .......................................................................... 20 5.2. Example of MQTT Operation with SSL ............................................................................... 22 fid Appendix.......................................................................................................................................... 24 6.1. References ......................................................................................................................... 24 Con 6.2. Summary of Error Codes .................................................................................................... 25 M26_MQTT_Application_Note Confidential / Released 3 / 25 GSM/GPRS Module Series M26 MQTT Application Note Table Index TABLE 1: MQTT RELATED NOTIFICATIONS .................................................................................................. 18 TABLE 2: ERROR CODES OF THE URC......................................................................................................... 18 TABLE 3: RELATED DOCUMENT .................................................................................................................... 24 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 24 TABLE 5: SUMMARY OF ERROR CODES ...................................................................................................... 25 CQouneficdteenl tial M26_MQTT_Application_Note Confidential / Released 4 / 25 GSM/GPRS Module Series M26 MQTT Application Note 1 Introduction MQTT (Message Queuing Telemetry Transport) is a broker-based publish/subscribe messaging protocol designed to be open, simple, lightweight and easy to implement. It is designed for connections with remote locations where a 'small code footprint' is required or the network bandwidth is limited. This document mainly introduces how to use the MQTT function of Quectel M26 modules through AT commands. CQouneficdteenl tial M26_MQTT_Application_Note Confidential / Released 5 / 25 GSM/GPRS Module Series M26 MQTT Application Note 2 MQTT Data Interaction This chapter gives the data interaction mechanism of MQTT function. MCU Modem Link layer MQTT Server Data report type (None URC): +QMT***: ,,… AT+QMTCFG='WILL',,.. (1) type=0: Receive ACK packets from server; AT+QMTCFG='USER',,.. (2) type=1: Packet sending timeout and AT+QMTCFG='TIMEOUT',,, retransmission; …... (3) type=2: Packet sending timeout and the maximum times of transmission is reached. AT+QMTOPEN=tcpidx,'host name', OK TCP-REQ +QMTOPEN: tcpidx, TCP established AT+QMTCONN AT+QMTCONN=tcpidx,'client id',... CONN-REQ l OK Start timer T1, T2 CONN ACK-IND +QMTCONN: tcpidx,, Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK Send connect packet Receive connect ACK packet te AT+QMTSUB AT+QMTSUB=tcpidx,msgId... c l OK SUB-REQ (msgId) Start timer T1 SUB ACK-IND (msgId) +QMTSUB: tcpidx,msgId,, Stop T1 or handle Excep2 +QMTSUB: tcpidx,1,msgId Send subscribe packet Receive subscribe ACK packet ue tia AT+QMTUNS AT+QMTUNS=tcpidx,msgId... OK +QMTUNS: tcpidx,, UNS-REQ (msgId) Start timer T1 UNS ACK-IND (msgId) Stop T1 or handle Excep2 +QMTUNS: tcpidx,1,msgId Send unsubscribe packet Receive unsubscribe ACK packet Q n AT+QMTPUB=tcpidx,topic,qos=0... OK PUB-REQ Send publish packet e AT+QMTPUB (qos=1) AT+QMTPUB=tcpidx,msgId,qos=1... OK fid +QMTPUB: tcpidx,msgId,,... PUB-REQ (msgId) Start timer T1 PUB ACK-IND (msgId) Stop T1 or handle Excep2 +QMTPUB: tcpidx,1,msgId Send publish packet Receive publish ACK packet AT+QMTPUB AT+QMTPUB=tcpidx,msgId,qos=2... Con (qos=2) OK PUB-REQ (msgId) Start timer T1 +QMTPUB: tcpidx,1,msgId Send publish packet PUB REC-IND (msgId) Stop T1 or handle Excep2 PUB REL-REQ (msgId) Start timer T1 PUB COMP-IND (msgId) Receive publish receive packet +QMTPUBREL: tcpidx,1,msgId Send publish release packet Receive publish complete packet T1 is packet transmission timeout. T2 is keep alive timer. In the absence of a data-related message during the T2 time period, client will send pingreq packet. Excep1: disconnect the TCP connection. Excep2: resend packets unless max retry times is reached; retry times is set by qmtcfg. Whether the timeout information is reported can be configured by AT+QMTCFG. +QMTPUB: tcpidx,msgId,,... Stop T1 or handle Excep2 Receive PUBLISH message in the form of URC. Receive PUB-IND (msgId) +QMTRCV: tcpidx,msgId,, PUB ACK/REC-REQ (msgId) Reply according to qos . . . AT+QMTDISC=tcpidx OK +QMTDISC: tcpidx, AT+QMTCLOSE=tcpidx OK +QMTCLOSE: tcpidx... DISC-REQ TCP-REQ TCP disconnected Receive publish packet Send publish reply packet Send disconnect packet TCP disco.n.n.ect request Figure 1: MQTT Data Interaction Diagram M26_MQTT_Application_Note Confidential / Released 6 / 25 GSM/GPRS Module Series M26 MQTT Application Note 3 MQTT AT Commands This chapter presents the AT commands for operating MQTT function. 3.1. AT Command Syntax Table 1: Types of AT Commands and Responses l Test Command te Read Command uec tial WriteCommand Execution CQonfiden Command AT+=? AT+? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the UE. M26_MQTT_Application_Note Confidential / Released 7 / 25 GSM/GPRS Module Series M26 MQTT Application Note 3.2. Description of AT Commands 3.2.1. AT+QMTCFG Configure Parameters of MQTT The command is used to configure optional parameters of MQTT. AT+QMTCFG Configure Optional Parameters of MQTT Test Command AT+QMTCFG=? Response +QMTCFG: '',(list of supported s),[,(list of supported s)] Write Command Configure Will information l AT+QMTCFG='WILL',[,[,,, uecte tial '','']] OK Response OK If , , , and are omitted, query the 'WILL' value. Response +QMTCFG: [,,, ,] OK Q fiden WriteCommand Configure timeout of message delivery AT+QMTCFG='TIMEOUT',[,[,][ Con ,]] If there is an error related to ME functionality: +CME ERROR: Response OK If , , are omitted, query the 'TIMEOUT' value. Response +QMTCFG: ,, OK If there is an error related to ME functionality: +CME ERROR: M26_MQTT_Application_Note Confidential / Released 8 / 25 GSM/GPRS Module Series M26 MQTT Application Note Write Command Configure session type AT+QMTCFG='SESSION',[,] Response OK If is omitted, query the 'SESSION' value. Response +QMTCFG: OK If there is an error related to ME functionality: +CME ERROR: Write Command Response Configure keep alive time AT+QMTCFG='KEEPALIVE',[,] OK If is omitted, query the 'KEEPALIVE' value. Response +QMTCFG: te OK uec tial WriteCommand Configure SSL secure connection Q n AT+QMTCFG='SSL',[ e ,[,]] If there is an error related to ME functionality: +CME ERROR: Response OK If is omitted, query the 'SSL' value. Response +QMTCFG: [,] fid OK Con Maximum Response Time If there is an error related to ME functionality: +CME ERROR: 300ms Parameter The type of configuration. It can be any of the following types: 'WILL' 'TIMEOUT' 'SESSION' 'KEEPALIVE' 'SSL' M26_MQTT_Application_Note Confidential / Released 9 / 25 GSM/GPRS Module Series M26 MQTT Application Note MQTT socket identifier. The range is 0-5. Configuration value of MQTT optional parameter. Configure the Will flag 0 Ignore the Will flag configuration 1 Require the Will flag configuration Quality of service for message delivery 0 At most once 1 At least once 2 Exactly once The Will retain flag is only used on PUBLISH messages. 0 When a client sends a PUBLISH message to a server, the server will not hold on to the message after it has been delivered to the current subscribers l te uec tial Q en Confid 1 When a client sends a PUBLISH message to a server, the server should hold on to the message after it has been delivered to the current subscribers Will topic string The Will message defines the content of the message that is published to the will topic if the client is unexpectedly disconnected. It can be a zero-length message. Timeout of the packet delivery. The range is 1-60. The default value is 5. Unit: second. Retry times when packet delivery times out. The range is 0-10. The default value is 3. 0 Not report timeout message when transmitting packet 1 Report timeout message when transmitting packet Configure the session type 0 The server must store the subscriptions of the client after it disconnects. 1 The server must discard any previously maintained information about the client and treat the connection as 'clean'. Keep alive time. The range is 0-3600. The default value is 120. Unit: second. It defines the maximum time interval between messages received from a client. If the server does not receive a message from the client within 1.5 times of the keep alive time period, it disconnects the client as if the client has sent a DISCONNECT message. 0 The client is not disconnected Configure the MQTT SSL mode 0 Use normal TCP connection for MQTT 1 Use SSL TCP secure connection for MQTT SSL context index. The range is 0-5. NOTES 1. If =1, then , , and must be present. Otherwise they will be omitted. 2. =0 is only effective when server supports the operation. 3. If MQTT connection is configured to SSL mode, must be present. Also, customers need M26_MQTT_Application_Note Confidential / Released 10 / 25 GSM/GPRS Module Series M26 MQTT Application Note to use AT+QSSLCFG command to configure the SSL version, cipher suite, secure level, CA certificate, client certificate, client key and ignorance of RTC time, which will be used in MQTT SSL handshake procedure. 4. Care must be taken to ensure message delivery does not time out while it is still being sent. 3.2.2. AT+QMTOPEN Open a Network for MQTT Client The command is used to open a network for MQTT client. AT+QMTOPEN Open a Network for MQTT Client Test Command Response AT+QMTOPEN=? +QMTOPEN: (list of supported s),'',(list of supported s) tel Read Command AT+QMTOPEN? OK Response [+QMTOPEN: ,'',] c l OK ue tia WriteCommand AT+QMTOPEN=,'', Response OK +QMTOPEN: , fide Maximum Response Time If there is an error related to ME functionality: +CME ERROR: 75s, determined by network n Parameter Co MQTT socket identifier. The range is 0-5. The address of the server. It could be an IP address or a domain name. The maximum size is 100 bytes. The port of the server. The range is 1-65535. Result of the command execution -1 Failed to open network 0 Opened network successfully 1 Wrong parameter 2 MQTT identifier is occupied 3 Failed to activate PDP M26_MQTT_Application_Note Confidential / Released 11 / 25 4 Failed to parse domain name 5 Network disconnection error GSM/GPRS Module Series M26 MQTT Application Note 3.2.3. AT+QMTCLOSE Close a Network for MQTT Client The command is used to close a network for MQTT client. AT+QMTCLOSE Close a Network for MQTT Client Test Command AT+QMTCLOSE=? Response +QMTCLOSE: (list of supported s) Write Command AT+QMTCLOSE= ctel l Maximum Response Time OK Response OK +QMTCLOSE: , If there is an error related to ME functionality: +CME ERROR: 300ms ue tia Parameter Q en fid MQTT socket identifier. The range is 0-5. Result of the command execution -1 Failed to close network 0 Closed network successfully on 3.2.4. AT+QMTCONN Connect a Client to MQTT Server C The command is used when a client requests a connection to MQTT server. When a TCP/IP socket connection is established from a client to a server, a protocol level session must be created using a CONNECT flow. AT+QMTCONN Connect a Client to MQTT Server Test Command AT+QMTCONN=? Response +QMTCONN: (list of supported s), ''[,''[,'']] OK M26_MQTT_Application_Note Confidential / Released 12 / 25 GSM/GPRS Module Series M26 MQTT Application Note Read Command AT+QMTCONN? Response [+QMTCONN: ,] Write Command AT+QMTCONN=,''[,''[,'']] OK Response OK +QMTCONN: ,[,] If there is an error related to ME functionality: +CME ERROR: Maximum Response Time (default 5s), determined by network Parameter l te c l ue tia Q n Confide MQTT socket identifier. The range is 0-5. The client identifier string. User name of the client. It can be used for authentication. Password corresponding to the user name of the client. It can be used for authentication. Result of the command execution 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet MQTT connection state 1 MQTT is initial 2 MQTT is connecting 3 MQTT is connected 4 MQTT is disconnecting Connect return code 0 Connection Accepted 1 Connection Refused: Unacceptable Protocol Version 2 Connection Refused: Identifier Rejected 3 Connection Refused: Server Unavailable 4 Connection Refused: Bad User Name or Password 5 Connection Refused: Not Authorized NOTE If a client with the same Client ID is already connected to the server, the 'older' client must be disconnected by the server before completing the CONNECT flow of the new client. M26_MQTT_Application_Note Confidential / Released 13 / 25 GSM/GPRS Module Series M26 MQTT Application Note 3.2.5. AT+QMTDISC Disconnect a Client from MQTT Server The command is used when a client requests a disconnection from MQTT server. A DISCONNECT message is sent from the client to the server to indicate that it is about to close its TCP/IP connection. AT+QMTDISC Disconnect a Client from MQTT Server Test Command AT+QMTDISC=? Response +QMTDISC: (list of supported s) OK Write Command Response AT+QMTDISC= OK tel Maximum Response Time +QMTDISC: , If there is an error related to ME functionality: +CME ERROR: 300ms c l Parameter ue tia Q n MQTT socket identifier. The range is 0-5. Result of the command execution -1 Failed to close connection 0 Closed connection successfully fide 3.2.6. AT+QMTSUB Subscribe to Topics n The command is used to subscribe to one or more topics. A SUBSCRIBE message is sent by a client to register an interest in one or more topic names with the server. Messages published to these topics are Co delivered from the server to the client as PUBLISH messages. AT+QMTSUB Subscribe to Topics Test Command AT+QMTSUB=? Response +QMTSUB: (list of supported s),(list of supported s),'',(list of supported s) Write Command AT+QMTSUB=,,'',[,' ',…] OK Response OK +QMTSUB: ,,[,] M26_MQTT_Application_Note Confidential / Released 14 / 25 GSM/GPRS Module Series M26 MQTT Application Note Maximum Response Time If there is an error related to ME functionality: +CME ERROR: * (default 15s), determined by network Parameter MQTT socket identifier. The range is 0-5. Message identifier of packet. The range is 1-65535. Topic that the client wants to subscribe to or unsubscribe from The QoS level at which the client wants to publish the messages. uectel tial 0 At most once 1 At least once 2 Exactly once Result of the command execution 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet If is 0, it is a vector of granted QoS levels. If is 1, it means the times of packet retransmission. If is 2, it will not be presented. Q n NOTE e The is only present in messages where the QoS bits in the fixed header indicate QoS levels 1 or 2. It must be unique amongst the set of 'in flight' messages in a particular direction of communication. fid It typically increases by exactly one from one message to the next, but is not required to do so. n 3.2.7. AT+QMTUNS Unsubscribe from Topics o The command is used to unsubscribe from one or more topics. An UNSUBSCRIBE message is sent by C the client to the server to unsubscribe from named topics. AT+QMTUNS Unsubscribe from Topics Test Command AT+QMTUNS=? Response +QMTUNS: (list of supported s),(list of supported s),'' Write Command AT+QMTUNS=,,''[,''…] Maximum Response Time +QMTUNS: ,, If there is an error related to ME functionality: +CME ERROR: * (default 15s), determined by network Parameter MQTT socket identifier. The range is 0-5. l Message identifier of packet. The range is 1-65535. Topic that the client wants to subscribe to or unsubscribe from Result of the command execution 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet cte l 3.2.8. AT+QMTPUB Publish Messages ue tia The command is used to publish messages by a client to a server for distribution to interested subscribers. Each PUBLISH message is associated with a topic name. If a client subscribes to one or more topics, any Q n message published to those topics are sent by the server to the client as a PUBLISH message. e AT+QMTPUB Publish Messages Test Command fid AT+QMTPUB=? Response +QMTPUB: (list of supported s),(list of supported s),(list of supported s),(list of supported s),'','' on Write Command C AT+QMTPUB=,,,,'' After '>' is responded, input the data to +QMTPUB: ,,[,] be sent. Tap 'CTRL+Z' to send, and tap 'ESC' to cancel the operation. If there is an error related to ME functionality: +CME ERROR: Maximum Response Time * (default 15s), determined by network M26_MQTT_Application_Note Confidential / Released 16 / 25 GSM/GPRS Module Series M26 MQTT Application Note Parameter MQTT socket identifier. The range is 0-5. Message identifier of packet. The range is 0-65535. It will be 0 only when =0. The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once The server will retain the message after it has been delivered to the current subscribers or not. 0 The server will not retain the message after it has been delivered to the l uecte tial current subscribers 1 The server will retain the message after it has been delivered to the current subscribers Topic that needs to be published Result of the command execution 0 Sent packet successfully and received ACK from server (message that published when =0 does not require ACK) 1 Packet retransmission 2 Failed to send packet If is 1, it means the times of packet retransmission. If is 0 or 2, it will not be presented. Q n NOTES e 1. If this command is executed successfully and gets OK back, the client can continue to publish new packet. The maximum quantity of transmitting packet should not be greater than that of in-flight fid windows (5); otherwise, +CME ERROR: 8512 will be returned. For more details, please refer to Chapter 6.2. 2. After executing this command, the client will be ready to send data, which will be sent as payload. n The maximum length of the input data is 1548 bytes at a time and tap 'Ctrl+Z‟ to send the data. o 3. PUBLISH messages can be sent either from a publisher to the server, or from the server to a subscriber. When server publishes messages to a subscriber, C +QMTRECV: ,,, will be returned to notify the host to read the received data that is reported from MQTT server. For more details, please refer to Chapter 4.1.2. M26_MQTT_Application_Note Confidential / Released 17 / 25 GSM/GPRS Module Series M26 MQTT Application Note 4 MQTT Related Notifications This chapter gives MQTT related notifications and their descriptions. Table 1: MQTT Related Notifications Index Notification Display [1] +QMTSTAT: , l +QMTRECV: [2] te ,, Description When the state of MQTT link layer is changed, the client will close the MQTT connection and report the URC. The client has received the packet data from MQTT server. uec tial 4.1.1. Description of URC '+QMTSTAT' Table 2: Error Codes of the URC Q n Code of e 1 fid 2 Con 3 Description How to do Connection is closed or reset by peer. Sending PINGREQ packet timed out or failed. Sending CONNECT packet timed out or failed Execute AT+QMTOPEN command and reopen MQTT connection. Deactivate PDP first, and then active PDP and reopen MQTT connection. 1. Check inputted user name and password are correct or not. 2. Make sure the client ID is not used. 3. Reopen MQTT connection and try to send CONNECT packet to server again. 1. Check inputted user name and password are correct or not. Receiving CONNACK packet 4 2. Make sure the client ID is not used. timed out or failed 3. Reopen MQTT connection and try to send CONNECT packet to server again. Client sends DISCONNECT 5 packet to sever but server is This is a normal process. initiative to close MQTT M26_MQTT_Application_Note Confidential / Released 18 / 25 6 7 8-255 GSM/GPRS Module Series M26 MQTT Application Note connection. Client is initiative to close MQTT connection due to packet sending failure all the time. The link is not alive or the server is unavailable 1. Make sure the data is correct. 2. Try to reopen MQTT connection since there may be network congestion or error. Make sure the link is alive or the server is available currently. Reserved for future use 4.1.2. Description of '+QMTRECV' The format of data report is '+QMTRECV:'. It is mainly used to notify the host to read the received MQTT packet data that is reported from MQTT server. Notify the Host to Read MQTT Packet Data l +MQTRECV: te ,,, c l Reference Notify the host to read the received data that is reported from MQTT server. Notify the host to read the received data that is reported from MQTT server. ue tia Parameter Q n e Confid MQTT socket identifier. The range is 0-5. The message identifier of packet The topic that received from MQTT server The payload that relates to the topic name M26_MQTT_Application_Note Confidential / Released 19 / 25 GSM/GPRS Module Series M26 MQTT Application Note 5 Examples This chapter gives the examples to explain how to use MQTT commands. 5.1. Example of MQTT Operation without SSL AT+QMTOPEN=? +QMTOPEN: ,'', OK l //Open a network for MQTT client. te AT+QMTOPEN=0, '220.180.239.212',1883 OK c l +QMTOPEN: 0,0 //Opened the MQTT client network successfully. ue tia AT+QMTOPEN? +QMTOPEN: 0,'220.180.239.212',1883 Q n OK fide AT+QMTCONN=? +QMTCONN: ,'' [,''[,'']] n OK o //Connect a client to MQTT server. C AT+QMTCONN=0,'clientExample','username','password' OK +QMTCONN: 0,0,0 //Connected the client to MQTT server successfully. AT+QMTSUB=? +QMTSUB : ,,'', OK //Subscribe to topics. M26_MQTT_Application_Note Confidential / Released 20 / 25 GSM/GPRS Module Series M26 MQTT Application Note AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //If a client subscribes to a topic and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,0, 'topic/example', 'This is the payload related to topic' //Unsubscribe from topics. AT+QMTUNS=0,2, 'topic/example' l OK te +QMTUNS: 0,2,0 c l AT+QMTPUB=? ue tia +QMTPUB : ,,,,'' OK Q n //Publish messages. e AT+QMTPUB=0,0,0,0,'topic/pub' >This is test data, hello MQTT. nfid OK //After receiving „>‟, input data 'This is test data, hello MQTT.' and send it. The maximum length of the data is 1548 bytes and the data that beyond 1548 bytes will be omitted. After inputting data, tap 'Ctrl+Z' to send. Co +QMTPUB: 0,0,0 //If a client subscribes to a topic named 'topic/pub' and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,0, 'topic/pub',This is test data, hello MQTT. //Disconnect a client from MQTT server. AT+QMTDISC=0 OK +QMTDISC: 0,0 //Closed disconnection successfully. M26_MQTT_Application_Note Confidential / Released 21 / 25 GSM/GPRS Module Series M26 MQTT Application Note 5.2. Example of MQTT Operation with SSL //Configure MQTT session into SSL mode. AT+QMTCFG='SSL', 0, 1, 2 OK //If SSL authentication mode is 'server authentication', store CA certificate to RAM. AT+QSECWRITE='RAM:cacert.pem',1758,100 CONNECT +QSECWRITE: 1758,384a OK //If SSL authentication mode is 'server authentication', store CC certificate to RAM. AT+QSECWRITE='RAM:client.pem',1220,100 l CONNECT te +QSECWRITE: 1220,2d53 c l OK ue tia //If SSL authentication mode is 'server authentication', store CK certificate to RAM. AT+QSECWRITE='RAM:user_key.pem',1679,100 Q n CONNECT e +QSECWRITE: 1679,335f fid OK //Configure CA certificate. n AT+QSSLCFG='cacert',2,'RAM:cacert.pem' Co OK //Configure CC certificate. AT+QSSLCFG='clientcert',2,'RAM:client.pem' OK //Configure CK certificate. AT+QSSLCFG='clientkey',2,'RAM:user_key.pem' OK //Configure SSL parameters. AT+QSSLCFG='seclevel',2,2 //SSL authentication mode: server authentication M26_MQTT_Application_Note Confidential / Released 22 / 25 GSM/GPRS Module Series M26 MQTT Application Note OK AT+QSSLCFG='sslversion',2,4 //SSL authentication version OK AT+QSSLCFG='ciphersuite',2,'0xFFFF' //Cipher suite OK AT+Qsslcfg='ignorertctime',1 //Ignore the time of authentication. OK //Start MQTT SSL connection. AT+QMTOPEN=0, 'a1zgnxur10j8ux.iot.us-east-1.amazonaws.com','8883' OK +QMTOPEN: 0,0 //Connect a client to MQTT server. AT+QMTCONN=0,'M26_0206' l OK te +QMTCONN: 0,0,0 c l //Subscribe to topics. ue tia AT+QMTSUB=0,1,'$aws/things/M26_0206/shadow/update/accepted',1 OK +QMTSUB: 0,1,0,1 Q en //Publish messages. AT+QMTPUB=0,1,1,0,'$aws/things/M26_0206/shadow/update/accepted' fid >This is publish data from client OK n +QMTPUB: 0,1,0 o //If a client subscribes to a topic named '$aws/things/M26_0206/shadow/update/accepted' and other C devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,1,'$aws/things/M26_0206/shadow/update/accepted',This is publish data from client //Disconnect a client from MQTT server. AT+QMTDISC=0 OK +QMTDISC: 0,0 M26_MQTT_Application_Note Confidential / Released 23 / 25 GSM/GPRS Module Series M26 MQTT Application Note 6 Appendix 6.1. References Table 3: Related Document SN Document Name l [1] MQTT V3.1 Protocol Specification Remarks MQTT protocol specification version 3.1 cte l Table 4: Terms and Abbreviations ue tia Abbreviation ACK Description Acknowledgement Q n MQTT e QoS fid RAM Message Queuing Telemetry Transport Quality of Service Random Access Memory n SSL Secure Sockets Layer Co TCP Transmission Control Protocol URC Unsolicited Result Code M26_MQTT_Application_Note Confidential / Released 24 / 25 GSM/GPRS Module Series M26 MQTT Application Note 6.2. Summary of Error Codes indicates an error related to mobile equipment or network. The details about are described in the following table. Table 5: Summary of Error Codes Code of Meaning 8503 MQTT link error 8504 8505 8506 8507 8508 8509 8510 8511 8600 8512 MQTT illegal packet MQTT illegal character l MQTT illegal UTF8 te MQTT invalid parameter c l MQTT packet too large ue tia MQTTbuffer overflow MQTT out of memory Q en MQTT memory error fidMQTT unknown error MQTT maximum quantity of transmitting packet Con greater than that of in-flight windows M26_MQTT_Application_Note Confidential / Released 25 / 25

GSM QuecFOTA 应用指导 GSM/GPRS/GNSS 模块系列 版本：1.1 日期：2022-03-24 状态：受控文件 GSM QuecFOTA 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 33 GSM QuecFOTA 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 33 GSM QuecFOTA 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-08-12 2022-03-24 作者 Bob DENG/ Ablaze LU/ Freddy LI Simon HU 变更表述 初始版本 1. 删除 CMD_RD_DATA 和 CMD_RD_DATA_RSP 命令。 2. 新增 MC20 和 MC30 模块特定版本支持的 GNSS bin 文件下载 功能（第 4.3.3 章）。 3. 新增下载 GNSS bin 文件时，模块数据长度要求（第 4.3.5 章）。 上海移远通信技术股份有限公司 3 / 33 GSM QuecFOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 图片索引 ....................................................................................................................................................... 7 1 引言 ....................................................................................................................................................... 8 1.1. 适用模块 ..................................................................................................................................... 8 2 QuecFOTA®概览 .................................................................................................................................. 9 2.1. 获取固件包 ............................................................................................................................... 10 2.2. 存储固件包至服务器................................................................................................................. 10 2.3. 下载固件包 ............................................................................................................................... 10 2.4. 升级固件包 ................................................................................................................................11 3 QuecFOTA®升级流程 ......................................................................................................................... 14 3.1. MCU 与模块同步 ...................................................................................................................... 14 3.2. 下载并升级固件包 .................................................................................................................... 15 3.3. QuecFOTA 升级错误处理......................................................................................................... 17 4 附录 A QuecFOTA®定义 .................................................................................................................... 19 4.1. 数据包格式 ............................................................................................................................... 19 4.2. 协议帧命令列表 ........................................................................................................................ 19 4.3. 协议帧命令描述 ........................................................................................................................ 20 4.3.1. CMD_DL_BEGIN .......................................................................................................... 20 4.3.2. CMD_DL_BEGIN_RSP................................................................................................. 21 4.3.3. CMD_DL_SET_ADDR .................................................................................................. 21 4.3.4. CMD_DL_SET_ADDR_RSP......................................................................................... 22 4.3.5. CMD_DL_DATA ............................................................................................................ 23 4.3.6. CMD_DL_DATA_RSP ................................................................................................... 24 4.3.7. CMD_DL_END .............................................................................................................. 25 4.3.8. CMD_DL_END_RSP .................................................................................................... 25 4.3.9. CMD_RUN_GSMSW .................................................................................................... 26 4.3.10. CMD_RUN_GSMSW_RSP........................................................................................... 26 4.3.11. CMD_CH_BAUDRATE ................................................................................................. 27 4.3.12. CMD_CH_BAUDRATE_RSP ........................................................................................ 28 4.4. 定义列表 ................................................................................................................................... 28 5 附录 B CRC-16 算法 ........................................................................................................................... 29 5.1. CRC-16-CCITT 编码表............................................................................................................. 29 5.2. CRC 值计算.............................................................................................................................. 30 5.3. 举例 .......................................................................................................................................... 30 6 附录 C QuecFOTA®打包工具 ............................................................................................................. 31 6.1. 打包工具格式............................................................................................................................ 31 上海移远通信技术股份有限公司 4 / 33 GSM QuecFOTA 应用指导 6.2. QuecFOTA 打包工具用法......................................................................................................... 32 7 附录 D 术语缩写 .................................................................................................................................. 33 上海移远通信技术股份有限公司 5 / 33 GSM QuecFOTA 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 8 表 2：数据包格式 ....................................................................................................................................... 19 表 3：协议帧命令列表 ................................................................................................................................ 19 表 4：状态值............................................................................................................................................... 28 表 5：术语缩写 ........................................................................................................................................... 33 上海移远通信技术股份有限公司 6 / 33 GSM QuecFOTA 应用指导 图片索引 图 1：QuecFOTA®流程概览 ......................................................................................................................... 9 图 2：QuecFOTA®固件包下载流程 ............................................................................................................ 10 图 3：QuecFOTA®升级数据路线图 .............................................................................................................11 图 4：QuecFOTA®升级流程图 ................................................................................................................... 12 图 5：MCU 与模块同步框架....................................................................................................................... 14 图 6：MCU 与模块同步序列....................................................................................................................... 15 图 7：QuecFOTA®序列化流程 ................................................................................................................... 16 图 8：QuecFOTA®升级错误处理流程图..................................................................................................... 18 图 9：QuecFOTA®打包格式 ....................................................................................................................... 31 图 10：QuecFOTA®打包工具 ..................................................................................................................... 32 上海移远通信技术股份有限公司 7 / 33 GSM QuecFOTA 应用指导 1 引言 移远通信 GSM/GPRS/GNSS 模块系列支持 QuecFOTA®功能，此功能可以实现模块固件包的无线升级 或降级。本文档主要介绍了如何通过 QuecFOTA®功能升级 GSM/GPRS/GNSS 模块系列的固件。 1.1. 适用模块 表 1：适用模块 模块系列 Mxx MCxx 模块 M08-R M25 M26 M35 M35-R M36 M56 M56-R M72-D M72-DFC MC20 MC25 MC30 上海移远通信技术股份有限公司 8 / 33 GSM QuecFOTA 应用指导 2 QuecFOTA®概览 下图阐述了 QuecFOTA 升级流程。 第一步：从移远通信获取 固件包 Qu ectel更新 固件， 同时 提供该 固件的 MD5校验 文件 打包文件 服务器 第二步：存储固件包至服务 器 GPRS (FTP/HTTP/TCP /UDP) 第三步：从服务器 下载固件包 外部 内存 外部 MCU 第四步：升级 固件包 终端设备 移远通信模块 图 1：QuecFOTA®流程概览 如上图所示，通过 QuecFOTA 升级固件的步骤为： 第一步: 从移远通信获取固件包。 第二步: 将固件包存储至服务器。 第三步: 从服务器下载固件包。 第四步: 升级固件包。 上海移远通信技术股份有限公司 9 / 33 GSM QuecFOTA 应用指导 2.1. 获取固件包 固件升级前，将当前固件版本号和所需固件版本号发送给移远通信以获取固件。 在固件存储至服务器前，需检查新固件的完整性和正确性，并可通过一些算法打包新固件。移远通信 提供 MD5 校验文件和 QuceFOTA 打包工具。有关 QuceFOTA 打包工具详情，可参考第 6 章。 2.2. 存储固件包至服务器 需自建服务器以便 QuceFOTA 功能的使用，服务器自建完成后，将打包好的固件包存储至服务器并记 录下存储路径。 2.3. 下载固件包 下图阐述了固件包的下载流程： 服务器 外部 存储器 外部 MCU GPRS (HTTP, TCP/ UDP, FTP) 终端设备 移远通信 模块 图 2：QuecFOTA®固件包下载流程 第一步：MCU 在模块和服务器间建立连接。 第二步：通过 TCP/UDP、HTTP 或 FTP 协议从服务器下载固件包。 第三步：将固件包存储至 MCU 外部存储器。 第四步：MCU 通过打包后的固件包中的校验值，对整个固件包的完整性和正确性进行检查确认，具体 可参考第 6.1 章。 上海移远通信技术股份有限公司 10 / 33 GSM QuecFOTA 应用指导 2.4. 升级固件包 在升级过程中，MCU 将把新固件从外部存储器传输到模块闪存中。下图为 QuecFOTA 升级数据路线 图。有关 QuecFOTA 升级流程详情，可参考第 3 章。 外部 存储器 读 外部 移远通信 MCU 写 模块 图 3：QuecFOTA®升级数据路线图 上海移远通信技术股份有限公司 11 / 33 下图阐释了 QuecFOTA 升级流程： 启动MCU 是 升级标志是否为11) ？ 否 否 是否需要更新？ 是 MCU设置更新标志 GSM QuecFOTA 应用指导 模块上电 开始QuecFOTA 协议通信 MCU同步模块 否 超时时间350（毫秒） 是否同步成功？ 是 新固件包下载 数据包下载结束 模块固件运行 验证版本 版本是否正确 是 MCU清除更新标志 否（再次更新） 模块正常运行 图 4：QuecFOTA®升级流程图 上海移远通信技术股份有限公司 12 / 33 GSM QuecFOTA 应用指导 固件升级的具体步骤如下： 第一步：MCU 设置更新标志。 第二步：MCU 发送同步字。 第三步：模块上电开机，升级过程中保持 PWRKEY 电平为低。 第四步：模块收到 MCU 发送的同步字后进行更新。 第五步：固件下载完成后，数据交互结束。 第六步：模块运行新固件。 第七步：MCU 验证固件版本。 第八步：若固件版本正确，MCU 将清除更新标志。 第九步：模块正常运行。 备注 若升级被中断，MCU 需执行回到图中 1)的地方重新开始升级。有关 QuecFOTA 升级异常情况处理，可 参考第 3.3 章。 上海移远通信技术股份有限公司 13 / 33 GSM QuecFOTA 应用指导 3 QuecFOTA®升级流程 QuecFOTA 升级流程分主要分为两步：MCU 与模块同步，下载并升级固件包。MCU 需要和模块同步 并使模块进入命令模式，之后 MCU 将打包固件并将其发送至模块升级固件。 3.1. MCU 与模块同步 如下图所示，新固件将被存储至 MCU 的闪存中。MCU 将根据下载协议通过模块 UART 接口升级模块 固件。 UART 接口参数应遵循如下要求进行配置： ⚫ 默认波特率：115200 bps ⚫ 数据位：8 bits ⚫ 停止位：1 bit ⚫ 奇偶校验：无 ⚫ 流控：无 MCU Flash 保存目标固件包 MCU应用软件 下载协议 POWER KEY 模块 NVRAM 原固件包 TXD 内部下载协议 RXD GND 图 5：MCU 与模块同步框架 上海移远通信技术股份有限公司 14 / 33 GSM QuecFOTA 应用指导 QuecFOTA 同步流程如下： 首先，MCU 每隔 20 毫秒通过 UART 接口向模块发送 SYNC_WORD1，之后模块开机。MCU 将通过 发送的 SYNC_WORD 与模块进行同步。同时，MCU 将丢弃模块发送的除了同步字之外的所有数据，例如 0xB6 等 。 模 块 响 应 SYNC_WORD_RSP1 后 ， MCU 发 送 SYNC_WORD2 ， 同 时 模 块 响 应 SYNC_WORD_RSP2，这时将接口波特率设置为 115200。之后，模块将进入'命令模式'。若模块无法接 收'同步序列'或无法完成同步协商，模块将运行已经存储在模块的固件版本。 MCU 与模块同步序列如下图所示： MCU 间隔为20毫秒 SYNC_WORD1 (B5) SYNC_WORD1 (B5) ... 丢弃除了同步字之外的所有数据(B6) SYNC_WORD_RSP1 (5B) 模块 开机 约350毫秒 SYNC_WORD2 (A9) SYNC_WORD_RSP2 (9A) 进入命令模式 图 6：MCU 与模块同步序列 3.2. 下载并升级固件包 模块进入'命令模式'后，MCU 将打包新固件并将其下载到模块。QuecFOTA 数据包由 MCU 生成， 数据帧应遵循数据包类型和格式。有关 QuecFOTA 数据包的详细定义，可参考第 4 章。 '命令模式'下，MCU 可发送数据包以升级固件。若 MCU 没有发送任何命令，模块将一直处于'命 令模式'。 QuecFOTA 序列化流程如下。 上海移远通信技术股份有限公司 15 / 33 GSM QuecFOTA 应用指导 MCU CMD_DL_BEGIN CMD_DL_BEGIN_RSP (状态，MTU) 模块 CMD_DL_SET_ADDR CMD_DL_SET_ADDR_RSP CMD_DL_DATA CMD_DL_DATA_RSP ………. CMD_DL_DATA CMD_DL_DATA_RSP CMD_DL_END CMD_DL_END _RSP (状态) CMD_RUN _GSMSW CMD_RUN_GSMSW_RSP (状态) 图 7：QuecFOTA®序列化流程 第一步：MCU 发送 CMD_DL_BEGIN 至模块，模块响应 CMD_DL_BEGIN_RSP。 第二步：MCU 发送 CMD_DL_SET_ADDR 至模块，指定下载地址，模块响应 CMD_DL_SET_ADDR_RSP。 上海移远通信技术股份有限公司 16 / 33 GSM QuecFOTA 应用指导 第三步：MCU 将固件数据（包括序列号和数据块）打包成数据包，然后将数据包发送到模块。序列号 始于 0。模块接收到数据包并将其成功写入闪存后，将响应 CMD_DL_DATA_RSP（状态为 0）。之后，MCU 即可发送下一个数据包。 若模块响应 CMD_DL_DATA_RSP（状态为 1 或状态为 4），表示写入数据包失败，MCU 需要重新发 送该数据包。若模块响应 CMD_DL_DATA_RSP（状态为 2），表示闪存出错，MCU 需开启模块并重新升级 固件。模块响应状态值详情请参考第 4.4 章，对应的升级错误处理请参考第 3.3 章。 MCU 必须依次读取并发送应用程序数据块。除最后一个数据块外，其他数据块的长度必须以偶数类型 对齐。 数 据 包 发 送 完 成 后 ， MCU 需 发 送 CMD_DL_END 给 模 块 ， 表 示 固 件 下 载 完 成 。 模 块 将 响 应 CMD_DL_END_RSP 并退出下载。 数据包下载完成后，MCU 需要通过发送 CMD_RUN_GSMSW 通知模块运行新固件。模块将响应 CMD_RUN_GSMSW_RSP 并运行新固件。 备注 发送数据包后，若 3 秒内未接收到模块响应信息，MCU 应重新发送数据包。若连续发送 3 次相同数据包， MCU 都没有收到来自模块的正确响应，MCU 需关闭模块并重新开始升级流程。 3.3. QuecFOTA 升级错误处理 在 QuecFOTA 升级过程中，若出现下列两种情况将导致固件升级流程被中断且固件无效。同时，模块 将无法正常工作。MCU 必须按照图 4 流程重新开始升级。 ⚫ 断电 ⚫ PWRKEY 被释放 若在升级过程中模块上报下列状态，MCU 需根据上报的状态值（参考第 4.4 章）进行对应错误处理。 ⚫ CRC16 错误 ⚫ 数据写入闪存错误 ⚫ 模块处于下载模式 ⚫ 数据包错误 ⚫ 命令执行失败或命令无效 下图为 QuecFOTA 升级错误处理流程图。 上海移远通信技术股份有限公司 17 / 33 GSM QuecFOTA 应用指导 错误 处理 状态值 1, 4 6,7 2 MCU重新发送数据包 关闭模块 0 3 下载繁忙 重新升级 再次发送 CMD_DL_END 命令 升级成功 图 8：QuecFOTA®升级错误处理流程图 上海移远通信技术股份有限公司 18 / 33 GSM QuecFOTA 应用指导 4 附录 A QuecFOTA®定义 4.1. 数据包格式 表 2：数据包格式 报头 1 字节 (0xAA) 类型 2 字节 长度 2 字节 数据 N 字节 CRC16 2 字节 上表中'长度'值表示数据字段的长度，不包括长度为两个字节的 CRC16 长度。校验和范围由'类 型'字段，'长度'字段和'数据'字段组成。 备注 CRC16 多项式：CRC-16-CCITT x16 + x12 + x5 + 1。 4.2. 协议帧命令列表 表 3：协议帧命令列表 类型 协议帧命令 ID CMD_DL_BEGIN 0x0001 CMD_DL_BEGIN_RSP 0x0002 CMD_DL_SET_ADDR 0x0012 CMD_DL_SET_ADDR_RSP 0x0013 CMD_DL_DATA 0x0003 描述 下载开始 下载开始响应 设置下载地址 设置下载地址响应 数据下载 传输方向 MCU 发送至模块 模块响应 MCU MCU 发送至模块 模块响应 MCU MCU 发送至模块 上海移远通信技术股份有限公司 19 / 33 CMD_DL_DATA_RSP 0x0004 CMD_DL_END 0x0005 CMD_DL_END_RSP 0x0006 CMD_RUN_GSMSW 0x0007 CMD_RUN_GSMSW_RSP 0x0008 CMD_CH_BAUDRATE 0x0010 CMD_CH_BAUDRATE_RSP 0x0011 GSM QuecFOTA 应用指导 数据下载响应 模块响应 MCU 下载完成 MCU 发送至模块 下载完成响应 模块响应 MCU 需要运行应用程序固件 MCU 发送至模块 运行应用程序固件响应 模块响应 MCU 设置波特率 MCU 发送至模块 设置波特率响应 模块响应 MCU 4.3. 协议帧命令描述 4.3.1. CMD_DL_BEGIN 数据字段长度由数据长度字段定义，内容如下： 内容 应用程序固件版本数据 字节数 4 描述 保留 举例： 若应用程序固件版本为 1，命令 CMD_DL_BEGIN 的数据包如下所示。 0xAA 0x00 0x01 0x00 0x04 0x00 0x00 0x00 0x01 0xXX 0xXX 内容 0xAA 0x00 0x01 0x00 0x04 0x00 0x00 0x00 0x01 0xXX 0xXX 描述 包头 CMD_DL_BEGIN 命令 ID 数据长度 应用程序固件版本数据 CRC16 值 上海移远通信技术股份有限公司 20 / 33 GSM QuecFOTA 应用指导 4.3.2. CMD_DL_BEGIN_RSP 数据字段长度由数据长度字段定义，内容如下： 内容 状态 MTU 字节数 2 2 描述 参考第 4.4 章 模块可以接收的命令包的最大长度 备注 1. 状态表示模块是否接收下载请求。 2. MTU 表示模块一次性接收的命令包的最大长度（长度由包头字段、命令 ID 字段、长度字段、数据 字段和 CRC 字段组成）。 举例： 以下为 CMD_DL_BEGIN_RSP 数据包。状态为 0，MTU 为 8224 字节（8 K + 32）。 0xAA 0x00 0x02 0x00 0x04 0x00 0x00 0x20 0x20 0xXX 0xXX 内容 0xAA 0x00 0x02 0x00 0x04 0x00 0x00 0x20 0x20 0xXX 0xXX 描述 包头 CMD_DL_BEGIN_RSP 命令 ID 数据长度 状态值，参考第 4.4 章 MTU 为 8224（十进制） CRC16 值 4.3.3. CMD_DL_SET_ADDR 数据字段长度由数据长度字段定义，内容如下： 内容 设置下载地址 字节数 4 上海移远通信技术股份有限公司 描述 0x10000000：下载核心 bin 文件 0x20000000：下载应用程序 bin 文件 21 / 33 GSM QuecFOTA 应用指导 0x30000000 + [GNSS bin 文件大小]：下 载 GNSS bin 文件 0x00xxxxxx：将 bin 文件下载到指定地址 备注 仅 MC20 和 MC30 模块的特定版本支持 GNSS bin 文件下载功能，详情请参见对应模块的软件版本变更 说明。 举例： 以下为命令 CMD_DL_SET_ADDR 数据包，表示下载核心 bin 文件。 0xAA 0x00 0x12 0x00 0x04 0x10 0x00 0x00 0x00 0xXX 0xXX 内容 0xAA 0x00 0x12 0x00 0x04 0x10 0x00 0x00 0x00 0xXX 0xXX 描述 包头 CMD_DL_SET_ADDR 命令 ID 数据长度 0x10000000：下载核心 bin 文件 0x20000000：下载应用程序 bin 文件 0x30000000 + [GNSS bin 文件大小]：下载 GNSS bin 文件 0x00xxxxxx：将 bin 文件下载到指定地址 CRC16 值 4.3.4. CMD_DL_SET_ADDR_RSP 数据字段长度由数据长度字段定义，内容如下： 内容 字节数 描述 状态 2 参考第 4.4 章 举例： 以下为命令 CMD_DL_SET_ADDR_RSP 数据包，状态为 0。 0xAA 0x00 0x13 0x00 0x02 0x00 0x00 0xXX 0xXX 内容 0xAA 描述 包头 上海移远通信技术股份有限公司 22 / 33 0x00 0x13 0x00 0x02 0x00 0x00 0xXX 0xXX GSM QuecFOTA 应用指导 CMD_DL_SET_ADDR_RSP 命令 ID 数据长度 状态值，参考第 4.4 章 CRC16 值 4.3.5. CMD_DL_DATA 数据字段长度由数据长度字段定义，内容如下： 内容 序列号 模块数据 字节数 4 N - 4 字节 描述 模块数据包的序号，从 0 开始 模块数据，N 是命令包的数据长度 举例： 以下为命令 CMD_DL_DATA 数据包，表示序列号为 244，模块数据长度为 1024 字节。 0xAA 0x00 0x03 0x04 0x04 0x00 0x00 0x00 0xF4 0xXX 0xXX 0xXX... (1024 bytes) 0xXX 0xXX 内容 0xAA 0x00 0x03 0x04 0x04 0x00 0x00 0x00 0xF4 0xXX 0xXX 0xXX...(1024 bytes) 0xXX 0xXX 描述 包头 CMD_DL_DATA 命令 ID 1028 字节数据长度。注意该长度包括 4 字节序号 序号 244 1024 字节数据 CRC16 值 备注 1. 序号：0x00 0x00 0x00 0xF4。 2. 模块数据：0xXX 0xXX 0xXX...（1024 字节）。 3. 模块数据长度：（长度）N -（序号长度）4。 4. 模块数据需要两字节对齐。 上海移远通信技术股份有限公司 23 / 33 GSM QuecFOTA 应用指导 5. 若非两字节对齐，填写 0xff.6。包头字段、命令 ID 字段、长度字段、序号字段、数据字段和 CRC16 字段的总长度不超过 MTU。 6. 下载 GNSS bin 文件时，模块数据长度必须为 1 K（1024 字节）。 4.3.6. CMD_DL_DATA_RSP 数据字段长度由数据长度字段定义，内容如下： 内容 状态 下一个序列号 字节数 2 4 描述 参考第 4.4 章 - 举例： 以下为命令 CMD_DL_DATA_RSP 数据包，状态为 0，下一个序列号为 245。 0xAA 0x00 0x04 0x00 0x06 0x00 0x00 0x00 0x00 0x00 0xF5 0xXX 0xXX 内容 0xAA 0x00 0x04 0x00 0x06 0x00 0x00 0x00 0x00 0x00 0xF5 0xXX 0xXX 描述 包头 CMD_DL_DATA_RSP 命令 ID 数据长度 状态值，参考第 4.4 章 下一个序列号 CRC16 值 上海移远通信技术股份有限公司 24 / 33 4.3.7. CMD_DL_END 该命令无数据字段。数据字段长度为 0。 举例： 命令 CMD_DL_END 的数据包如下所示。 0xAA 0x00 0x05 0x00 0x00 0xXX 0xXX 内容 0xAA 0x00 0x05 0x00 0x00 0xXX 0xXX 描述 包头 CMD_DL_END 命令 ID 数据长度为 0 CRC16 值 GSM QuecFOTA 应用指导 4.3.8. CMD_DL_END_RSP 数据字段长度由数据长度字段定义，内容如下： 内容 状态 字节数 2 描述 参考第 4.4 章 举例： 以下为命令 CMD_DL_END_RSP 数据包，状态为 0。 0xAA 0x00 0x06 0x00 0x02 0x00 0x00 0xXX 0xXX 内容 0xAA 0x00 0x06 0x00 0x02 0x00 0x00 0xXX 0xXX 描述 包头 CMD_DL_END_RSP 命令 ID 数据长度为 2 字节 状态值，参考第 4.4 章 CRC16 值 上海移远通信技术股份有限公司 25 / 33 GSM QuecFOTA 应用指导 4.3.9. CMD_RUN_GSMSW 该命令无数据字段。数据字段长度为 0。 举例： 命令 CMD_RUN_GSMSW 的数据包如下所示。 0xAA 0x00 0x07 0x00 0x00 0xXX 0xXX 内容 0xAA 0x00 0x07 0x00 0x00 0xXX 0xXX 描述 包头 CMD_RUN_GSMSW 命令 ID 数据长度为 0 CRC16 值 4.3.10. CMD_RUN_GSMSW_RSP 数据字段长度由数据长度字段定义，内容如下： 内容 状态 字节数 2 描述 参考第 4.4 章 举例： 命令 CMD_RUN_GSMSW_RSP 的数据包如下所示，状态为 3。 0xAA 0x00 0x08 0x00 0x02 0x00 0x03 0xXX 0xXX 内容 0xAA 0x00 0x08 0x00 0x02 0x00 0x03 0xXX 0xXX 描述 包头 CMD_RUN_GSMSW_RSP 命令 ID 数据长度为 2 字节 状态值，参考第 4.4 章 CRC16 值 上海移远通信技术股份有限公司 26 / 33 GSM QuecFOTA 应用指导 4.3.11. CMD_CH_BAUDRATE 数据字段长度由数据长度字段定义，内容如下： 内容 设置波特率 字节数 4 描述 0x000012C0：4800 bps 0x00002580：9600 bps 0x00004B00：19200 bps 0x00009600：38400 bps 0x0000E100：57600 bps 0x0001C200：115200 bps 0x00038400：230400 bps 0x00070800：460800 bps 0x000E1000：921600 bps 举例： 命令 CMD_CH_BAUDRATE 的数据包如下所示，表示将波特率设置为 921600 bps。 0xAA 0x00 0x10 0x00 0x04 0x00 0x0E 0x10 0x00 0xXX 0xXX 内容 0xAA 0x00 0x10 0x00 0x04 0x00 0x0E 0x10 0x00 0xXX 0xXX 描述 包头 CMD_CH_BAUDRATE 命令 ID 数据长度 波特率 CRC16 值 上海移远通信技术股份有限公司 27 / 33 GSM QuecFOTA 应用指导 4.3.12. CMD_CH_BAUDRATE_RSP 数据字段长度由数据长度字段定义，内容如下： 内容 状态 字节数 2 描述 参考第 4.4 章 举例： 以下为命令 CMD_CH_BAUDRATE_RSP 数据包，状态为 0。 0xAA 0x00 0x11 0x00 0x02 0x00 0x00 0xXX 0xXX 内容 0xAA 0x00 0x11 0x00 0x02 0x00 0x00 0xXX 0xXX 描述 包头 CMD_CH_BAUDRATE_RSP 命令 ID 数据长度 状态值，参考第 4.4 章 CRC16 值 4.4. 定义列表 表 4：状态值 状态值 0 1 2 3 4 6 7 描述 成功 CRC16 错误 闪存出错 模块处于下载模式 数据包错误 命令执行失败 命令无效 上海移远通信技术股份有限公司 响应 MCU 重新发送响应序列号。 MCU 重新启动模块，然后再次下载应用程序固件。 MCU 重新发送响应序列号。 MCU 重新发送响应序列号。 - 28 / 33 GSM QuecFOTA 应用指导 5 附录 B CRC-16 算法 5.1. CRC-16-CCITT 编码表 __align (4) unsigned short CRC16_CCITT_tbl [256] = { 0x0,0x1021,0x2042,0x3063,0x4084,0x50a5,0x60c6,0x70e7,0x8108,0x9129,0xa14a,0xb16b,0xc18c, 0xd1ad,0xe1ce,0xf1ef,0x1231,0x210,0x3273,0x2252,0x52b5,0x4294,0x72f7,0x62d6,0x9339,0x8318, 0xb37b, 0xa35a, 0xd3bd, 0xc39c, 0xf3ff, 0xe3de, 0x2462,0x3443,0x420,0x1401,0x64e6,0x74c7,0x44a4,0x5485,0xa56a,0xb54b,0x8528,0x9509,0xe5ee,0 xf5cf,0xc5ac,0xd58d, 0x3653,0x2672,0x1611,0x630,0x76d7,0x66f6,0x5695,0x46b4,0xb75b,0xa77a,0x9719,0x8738,0xf7df,0xe 7fe,0xd79d,0xc7bc, 0x48c4,0x58e5,0x6886,0x78a7,0x840,0x1861,0x2802,0x3823,0xc9cc,0xd9ed,0xe98e,0xf9af,0x8948,0x 9969,0xa90a,0xb92b, 0x5af5,0x4ad4,0x7ab7,0x6a96,0x1a71,0xa50,0x3a33,0x2a12,0xdbfd,0xcbdc,0xfbbf,0xeb9e,0x9b79,0x8 b58,0xbb3b,0xab1a, 0x6ca6,0x7c87,0x4ce4,0x5cc5,0x2c22,0x3c03,0xc60,0x1c41,0xedae,0xfd8f,0xcdec,0xddcd,0xad2a,0xb d0b,0x8d68,0x9d49, 0x7e97,0x6eb6,0x5ed5,0x4ef4,0x3e13,0x2e32,0x1e51,0xe70,0xff9f,0xefbe,0xdfdd,0xcffc,0xbf1b,0xaf3a, 0x9f59,0x8f78, 0x9188,0x81a9,0xb1ca,0xa1eb,0xd10c,0xc12d,0xf14e,0xe16f,0x1080,0xa1,0x30c2,0x20e3,0x5004,0x4 025,0x7046,0x6067, 0x83b9,0x9398,0xa3fb,0xb3da,0xc33d,0xd31c,0xe37f,0xf35e,0x2b1,0x1290,0x22f3,0x32d2,0x4235,0x5 214,0x6277,0x7256, 0xb5ea,0xa5cb,0x95a8,0x8589,0xf56e,0xe54f,0xd52c,0xc50d,0x34e2,0x24c3,0x14a0,0x481,0x7466,0x 6447,0x5424,0x4405, 0xa7db,0xb7fa,0x8799,0x97b8,0xe75f,0xf77e,0xc71d,0xd73c,0x26d3,0x36f2,0x691,0x16b0,0x6657,0x7 676,0x4615,0x5634, 0xd94c,0xc96d,0xf90e,0xe92f,0x99c8,0x89e9,0xb98a,0xa9ab,0x5844,0x4865,0x7806,0x6827,0x18c0,0 x8e1,0x3882,0x28a3, 0xcb7d,0xdb5c,0xeb3f,0xfb1e,0x8bf9,0x9bd8,0xabbb,0xbb9a,0x4a75,0x5a54,0x6a37,0x7a16,0xaf1,0x1 ad0,0x2ab3,0x3a92, 0xfd2e,0xed0f,0xdd6c,0xcd4d,0xbdaa,0xad8b,0x9de8,0x8dc9,0x7c26,0x6c07,0x5c64,0x4c45,0x3ca2,0x 2c83,0x1ce0,0xcc1, 0xef1f,0xff3e,0xcf5d,0xdf7c,0xaf9b,0xbfba,0x8fd9,0x9ff8,0x6e17,0x7e36,0x4e55,0x5e74,0x2e93,0x3eb2 ,0xed1,0x1ef0}; 上海移远通信技术股份有限公司 29 / 33 GSM QuecFOTA 应用指导 5.2. CRC 值计算 void calculate_crc16(unsigned char* unsigned char* Lower) { unsigned short i; unsigned short nAccum = 0; aData, unsigned short aSize, unsigned char* Higher, for ( i = 0; i < aSize; i++ ) nAccum = ( nAccum << 8 ) ^ ( unsigned short )CRC16_CCITT_tbl[(( nAccum >> 8 ) ^ *aData++)&0xff]; *Higher = (unsigned char)((nAccum>>8) & 0xff); *Lower = (unsigned char)((nAccum) & 0xff); } unsigned long CalculateCRC16(unsigned char*ptr, unsigned long len) { unsigned char Higher = 0; unsigned char Lower = 0; calculate_crc16(ptr,len,&Higher,&Lower); return (((0x00000000 | Higher) << 8) | Lower); } 5.3. 举例 unsigned long new_CRC16_value = 0; new_CRC16_value = CalculateCRC16 ((unsigned char*)pData, nLength); if(org_CRC16_value != new_CRC16_value) { //CRC checksum failed return -1; } else { //CRC checksum successful return 0; } 上海移远通信技术股份有限公司 30 / 33 GSM QuecFOTA 应用指导 6 附录 C QuecFOTA®打包工具 6.1. 打包工具格式 下载和复制过程中，固件可能会意外损坏。因此，上传新固件至服务器前，建议使用 QuecFOTA 打包 工具以如下格式打包新固件。 包头 CRC16值 版本 30字节 2字节 30字节 长度 4字节 新固件 图 9：QuecFOTA®打包格式 下载前需检查新固件的完整性和正确性。'版本'字段用于固件版本的正确性。下载后，可使用'CRC16 值'字段检查下载的固件包的正确性和完整性。使用第 5 章附录 B 中 CRC16 算法计算可得出 CRC16 值， 具体打包格式如下： 内容 包头 CRC16 长度（字节） 描述 30 包头 2 CRC16 校验值 举例 'QuectFOTAPackageV0.1' 若为空，将其设置为 0。 包括版本，长度和新固件 上海移远通信技术股份有限公司 31 / 33 版本 长度 新固件 30 4 Length 新固件版本 新固件大小 完整 bin 文件 6.2. QuecFOTA 打包工具用法 GSM QuecFOTA 应用指导 M10ER01A08W32 若为空，将其设置为 0。 M10ER01A08W32.BIN 图 10：QuecFOTA®打包工具 如何使用 QuecFOTA 打包工具，分为以下三步（以 M10ER01A08W32.bin 文件为例）： 第一步：选择 bin 文件。 第二步：检查 bin 文件。 使用 MD5 文件检查 BIN 是否正确。例如，选择'M10ER01A08W32_MD5.DAT'，然后点击 'Check'按钮检查 M10ER01A08W32.bin 是否正确。 第三步：'生成打包文件'，即生成 QuecFOTA 打包文件。 首 先 ， 输 入 ' M10ER01A08W32_package.bin '， 然 后 按 ' Generate ' 按 钮 ， 使 用 M10ER01A08W32.bin 文件生成 M10ER01A08W32_package.bin 文件。 上海移远通信技术股份有限公司 32 / 33 GSM QuecFOTA 应用指导 7 附录 D 术语缩写 表 5：术语缩写 缩写 CRC MD5 FOTA FTP GSM GNSS HTTP ID MCU MTU NVRAM TCP UDP UART 英文全称 中文全称 Cyclic Redundancy Check 循环冗余校验 Message-Digest Algorithm 信息摘要算法 Firmware Over-The-Air 固件空中升级 File Transfer Protocol 文件传输协议 Global System for Mobile Communications 全球移动通信系统 Global Navigation Satellite System 全球导航卫星系统 Hyper Text Transfer Protocol 超文本传输协议 Mostly refers to Identifier in terms of software 软件中多数指'标识符' Microcontroller Unit 微控单元 Maximum Transmission Unit 最大传输单元 Non-Volatile Random Access Memory 非易失性随机访问存储器 Transmission Control Protocol 传输控制协议 User Datagram Protocol 用户数据报协议 Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 上海移远通信技术股份有限公司 33 / 33

EG25-G&EC2x 系列 蓝牙应用指导 LTE Standard 模块系列 版本：EG25-G&EC2x 系列_蓝牙应用指导_V1.1 日期：2020-06-19 状态：受控文件 www.quectel.com EG25-G&EC2x 系列蓝牙应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 40 EG25-G&EC2x 系列蓝牙应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-03-13 2020-06-19 作者 张波/ 樊恒恒 张波/ 樊恒恒 变更表述 初始版本 新增 HFP-AG（音频网关）相关 AT 命令、URC 和操作步骤 （第 2.5、3.3 和 4.3 章） 上海移远通信技术股份有限公司 2 / 40 EG25-G&EC2x 系列蓝牙应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 蓝牙 AT 命令详解................................................................................................................................... 7 2.1. AT 命令语句 ................................................................................................................................ 7 2.1.1. 定义 .................................................................................................................................. 7 2.1.2. AT 命令语句..................................................................................................................... 7 2.2. 蓝牙通用命令............................................................................................................................... 8 2.2.1. AT+QBTPWR 打开或关闭蓝牙...................................................................................... 8 2.3. 低功耗蓝牙 AT 命令详解 ............................................................................................................. 9 2.3.1. 低功耗蓝牙通用命令......................................................................................................... 9 2.3.1.1. AT+QBTLEADDR 读取低功耗蓝牙设备的本地地址 .......................................... 9 2.3.1.2. AT+QBTNAME 设置蓝牙设备的本地名称 ......................................................... 9 2.3.2. 低功耗蓝牙 GATT 服务的 AT 命令 ................................................................................. 10 2.3.2.1. AT+QBTGATREG 注册/注销 GATT 服务........................................................ 10 2.3.2.2. AT+QBTGATSS 添加/移除服务 ...................................................................... 11 2.3.2.3. AT+QBTGATSC 在现有服务基础上添加/移除特征 ......................................... 12 2.3.2.4. AT+QBTGATSD 在现有特征基础上添加/移除描述 ......................................... 13 2.3.2.5. AT+QBTGATDBALC 请求分配数据库............................................................. 15 2.3.2.6. AT+QBTGATDBDEALC 请求取消分配数据库 ................................................ 15 2.3.2.7. AT+QBTGATSIND 发送指示 ........................................................................... 16 2.3.2.8. AT+QBTGATSNOD 发送通知 ......................................................................... 17 2.3.2.9. AT+QBTGATADV 设置广播参数....................................................................... 18 2.3.2.10. AT+QBTGATRRSP 读取数据 ......................................................................... 18 2.3.2.11. AT+QBTGATWRSP 对写入数据做出响应 ...................................................... 19 2.3.2.12. AT+QBTGATSA 是否激活数据库服务............................................................. 20 2.3.2.13. AT+QBTGATDA 添加数据库 ........................................................................... 21 2.3.2.14. AT+QBTGATDISC 主动断开连接服务器......................................................... 21 2.3.2.15. AT+QBTGATPER 开启外围设备模式.............................................................. 22 2.4. SPP AT 命令详解 ...................................................................................................................... 23 2.4.1. AT+QBTSPPACT 激活/去激活 SPP 设备 ................................................................... 23 2.4.2. AT+QBTSPPDIC 断开与 SPP 设备的连接.................................................................. 23 2.4.3. AT+QBTSPPWRS 向远程设备写入消息 ..................................................................... 24 2.5. HFP-AG* AT 命令详解 .............................................................................................................. 25 2.5.1. AT+QBTSCAN 开启/关闭自动扫描远端设备............................................................... 25 2.5.2. AT+QBTAVREG 注册 AV*功能 ................................................................................... 26 2.5.3. AT+QBTAVACT 激活/去激活 AV*功能........................................................................ 26 2.5.4. AT+QBTAVCON 控制远端设备与 AV*功能连接的状态 .............................................. 27 2.5.5. AT+QBTHFGCON 控制远端设备与 HFP-AG*连接的状态 .......................................... 28 上海移远通信技术股份有限公司 3 / 40 EG25-G&EC2x 系列蓝牙应用指导 3 URC 详解 ............................................................................................................................................. 30 3.1. 低功耗蓝牙相关 URC ................................................................................................................ 30 3.1.1. +QBTGATSCON 通知连接 GATT ............................................................................... 30 3.1.2. +QBTGATSDCON 通知断开 GATT ............................................................................ 30 3.1.3. +QBTGATSRRSP 通知客户端读取 GATT 服务数据................................................... 31 3.1.4. +QBTGATSWRSP 通知客户端写入 GATT 服务数据.................................................. 31 3.2. SPP 相关 URC .......................................................................................................................... 32 3.2.1. +QBTSPPDATAIND 上报数据 .................................................................................... 32 3.2.2. +QBTSPPCONNECT 通知已连接 SPP....................................................................... 32 3.2.3. +QBTSPPDISCONNECT 通知已断开 SPP 连接 ........................................................ 32 3.3. HFP-AG*相关 URC ................................................................................................................... 33 3.3.1. +QBTSEARCHDEVICES 通知扫描的设备蓝牙名称和地址 ........................................ 33 3.3.2. +QBTAVCONNECT 通知已建立 AV*功能连接 ........................................................... 33 3.3.3. +QBTAVDISCONNECT 通知远端设备已断开 AV*功能连接....................................... 34 3.3.4. +QBTHFGCONNECT 通知远端设备已建立 HFP-AG*连接 ........................................ 34 3.3.5. +QBTHFGDISCONNECT 通知远端设备已断开 HFP-AG*连接 .................................. 34 3.3.6. +QBTHFGANSWER 通知 HF 已应答电话 .................................................................. 35 3.3.7. +QBTHFGREJECT 通知 HF 已拒接电话 .................................................................... 35 4 举例 ...................................................................................................................................................... 37 4.1. 低功耗蓝牙通信 ......................................................................................................................... 37 4.2. SPP 激活 ................................................................................................................................... 38 4.3. HFP-AG*操作步骤..................................................................................................................... 38 5 附录 A 术语缩写 ................................................................................................................................. 40 上海移远通信技术股份有限公司 4 / 40 EG25-G&EC2x 系列蓝牙应用指导 表格索引 表 1：AT 命令及响应类型 .................................................................................................................................... 7 表 2：术语缩写 .................................................................................................................................................. 40 上海移远通信技术股份有限公司 5 / 40 EG25-G&EC2x 系列蓝牙应用指导 1 引言 蓝牙（BT）技术是一种无线数据和语音通信开放的全球规范，是基于低成本的近距离无线连接，为固 定设备和移动设备建立通信环境的一种特殊的近距离无线技术连接。蓝牙技术包括传统蓝牙和低功耗蓝牙。 本文档主要介绍了移远通信的 LTE Standard 模块的蓝牙功能，该功能可与移远通信 FC20 系列或 FC21 模 块结合使用，以极低的功耗通过无线技术实现设备互连。 传统蓝牙的开发基于 SPP 和 HFP*协议。SPP 协议能在本地蓝牙设备和远端蓝牙设备之间建立一条传 输通道，实现数据的交互。HFP*在蓝牙协议栈中控制蓝牙设备拨打电话，如接听、挂断、语音和拒接等。 HFP*定义了音频网关角色（AG*）和免提组件角色（HF*）两个角色：HF*角色为音频网关的远程音频输入 输出的机制，并提供若干遥控功能，一般用作车载蓝牙；AG*角色为音频设备的输入输出网关，一般用于手 机端。当前此文档仅对 AG 相关 AT 命令进行了介绍。 蓝牙低能耗（Bluetooth Low Energy，或称 Bluetooth LE、BLE）也称低功耗蓝牙，是蓝牙技术联盟设 计和销售的一种个人局域网技术，旨在用于医疗保健、运动健身、信标、安防、家庭娱乐等领域的新兴应 用。相较经典蓝牙，低功耗蓝牙旨在保持同等通信范围的同时显著降低功耗和成本。低功耗蓝牙连接是建 立在 GATT (Generic Attribute Profile) 协议之上。GATT 是一个在蓝牙连接之上的发送和接收很短的数据 段的通用规范，这些很短的数据段被称为属性（Attribute）。 目前本文档适用的移远通信 LTE Standard 模块如下：  EG25-G  EC2x 系列 1)：EC25 系列、EC21 系列、EC20 R2.1 备注 1. 1) EC2x 模块系列的蓝牙功能正在开发中。 2. '*' 表示正在开发中。 上海移远通信技术股份有限公司 6 / 40 EG25-G&EC2x 系列蓝牙应用指导 2 蓝牙 AT 命令详解 2.1. AT 命令语句 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 7 / 40 EG25-G&EC2x 系列蓝牙应用指导 2.2. 蓝牙通用命令 2.2.1. AT+QBTPWR 打开或关闭蓝牙 该命令用于打开或关闭蓝牙。 AT+QBTPWR 打开或关闭蓝牙 测试命令 AT+QBTPWR=? 响应 +QBTPWR: (支持的列表) 查询命令 AT+QBTPWR? OK 响应 +QBTPWR: 设置命令 AT+QBTPWR= 最大响应时间 特性说明 OK 响应 OK 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。表示打开或者关闭蓝牙。 0 关闭蓝牙 1 开启 SPP/低功耗蓝牙 2 开启 HFP-AG* 举例 AT+QBTPWR=1 OK //打开 SPP/低功耗蓝牙。 备注 1. 使用该命令打开 BT 前，需首先执行 AT+QCFG='spi/set',1 配置 UART 驱动并重启模块。关于该命 令的详细信息，可联系移远通信技术支持。 2. '*' 表示正在开发中。 上海移远通信技术股份有限公司 8 / 40 EG25-G&EC2x 系列蓝牙应用指导 2.3. 低功耗蓝牙 AT 命令详解 2.3.1. 低功耗蓝牙通用命令 2.3.1.1. AT+QBTLEADDR 读取低功耗蓝牙设备的本地地址 AT+QBTLEADDR 读取低功耗蓝牙设备的本地地址 测试命令 AT+QBTLEADDR=? 查询命令 AT+QBTLEADDR? 响应 OK 响应 +QBTLEADDR: 最大响应时间 特性说明 OK 10 秒 / 参数 字符串类型。低功耗蓝牙设备的本地地址。例如：'A662616202C3'。 举例 AT+QBTLEADDR? //查询低功耗蓝牙设备的本地地址。 +QBTLEADDR: 'A662616202C3' OK 2.3.1.2. AT+QBTNAME 设置蓝牙设备的本地名称 该命令用于设置或者读取蓝牙设备的本地名称。 AT+QBTNAME 设置蓝牙设备的本地名称 测试命令 AT+QBTNAME=? 响应 OK 查询命令 AT+QBTNAME? 响应 +QBTNAME: 上海移远通信技术股份有限公司 9 / 40 EG25-G&EC2x 系列蓝牙应用指导 设置命令 AT+QBTNAME= 最大响应时间 特性说明 OK 响应 OK 10 秒 该命令立即生效。 不保存参数配置。 参数 字符串类型。蓝牙设备的本地名称。 举例 AT+QBTNAME? //查询蓝牙设备的本地名称。 +QBTNAME: 'MYBTDEVICE' OK 2.3.2. 低功耗蓝牙 GATT 服务的 AT 命令 2.3.2.1. AT+QBTGATREG 注册/注销 GATT 服务 AT+QBTGATREG 注册/注销 GATT 服务 测试命令 AT+QBTGATREG=? 响应 +QBTGATREG: (支持的列表), 查询命令 AT+QBTGATREG? OK 响应 [+QBTGATREG: …] 设置命令 AT+QBTGATREG=[, ] OK 响应 OK 或者 ERROR 最大响应时间 10 秒 上海移远通信技术股份有限公司 10 / 40 EG25-G&EC2x 系列蓝牙应用指导 特性说明 该命令立即生效。 不保存参数配置。 参数 整型。表示注册/注销 GATT。 0 注销 GATT 服务。 1 注册 GATT 服务。参数设置为 1 时，需省略。 整型。GATT ID。 举例 AT+QBTGATREG=1 +QBTGATREG: 1,131106 OK AT+QBTGATREG? +QBTGATREG: 131106 OK AT+QBTGATREG=0,131106 OK //注册 GATT 服务。 //查询已注册的 GATT ID。 //注销 GATT 服务。 2.3.2.2. AT+QBTGATSS 添加/移除服务 AT+QBTGATSS 添加/移除服务 测试命令 AT+QBTGATSS=? 响应 +QBTGATSS: (支持的列表),,,< serv_UUID>, 设置命令 AT+QBTGATSS=,,< serv_ID>[,,] OK 响应 如果为 0，需省略参数和，移除 服务： OK 或者 ERROR 如果为 1，需输入和，添加服务： OK 或者 上海移远通信技术股份有限公司 11 / 40 最大响应时间 特性说明 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。表示添加/移除服务。 0 移除服务 1 添加服务 整型。GATT ID。 整型。服务 ID。范围：0~65535。 整型。服务 UUID。 整型。是否为主要服务。 0 非主要服务 1 主要服务 举例 AT+QBTGATSS=1,131106,1,6154,1 OK AT+QBTGATSS=0,131106,1 OK //添加服务。 //移除服务。 EG25-G&EC2x 系列蓝牙应用指导 2.3.2.3. AT+QBTGATSC 在现有服务基础上添加/移除特征 AT+QBTGATSC 在现有服务基础上添加/移除特征 测试命令 AT+QBTGATSC=? 响应 +QBTGATSC: (支持的列表),,,< character_ID>,,,,, 设置命令 AT+QBTGATSC=,,< serv_ID>,[,,,,,] OK 响应 如果为 0，需删除参数、、 、和，移除特征： OK 或者 ERROR 上海移远通信技术股份有限公司 12 / 40 EG25-G&EC2x 系列蓝牙应用指导 最大响应时间 特性说明 如果为 1，需输入参数、、 、和，添加特征： OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。表示添加/移除特征。 0 移除特征 1 添加特征 整型。GATT ID。 整型。服务 ID。范围：0~65535。 整型。特征 UUID。 整型。特征 ID。 整型。特征属性。不同值代表不同属性。 整型。特征长度。范围：0~128。单位：字节。 整型。属性值标识。定义访问特征值的方式。 字符串类型。特征的值。 举例 AT+QBTGATSC=1,131106,1,1,10793,7,18,16,'quectel' OK AT+QBTGATSC=0,131106,1,1 OK //添加特征。 //移除特征。 2.3.2.4. AT+QBTGATSD 在现有特征基础上添加/移除描述 AT+QBTGATSD 在现有特征基础上添加/移除描述 测试命令 AT+QBTGATSD=? 响应 +QBTGATSD: (支持的列表),,,< character_ID>,,,,< prop>,, OK 上海移远通信技术股份有限公司 13 / 40 EG25-G&EC2x 系列蓝牙应用指导 设置命令 AT+QBTGATSD=,,< serv_ID>,,[, ,, ,,] 响应 如果为 0，需省略参数、、 、和，移除描述： OK 或者 ERROR 最大响应时间 特性说明 如果为 1，需输入参数、、 、和，添加描述： OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。表示添加/移除描述。 0 移除描述 1 添加描述 整型。GATT ID。 整型。服务 ID。范围：0~65535。 整型。特性 ID。 整型。描述 ID。 整型。描述属性。不同值代表不同属性。 整型。特征 UUID。 整型。描述长度。范围：0~128。单位：字节。 整型。属性值标识。定义访问特征值的方式。 字符串类型。描述的值。 举例 AT+QBTGATSD=1,131106,1,1,1,10498,7,2,0,'quectel' OK AT+QBTGATSD=0,131106,1,1,1 OK //添加描述。 //移除描述。 上海移远通信技术股份有限公司 14 / 40 EG25-G&EC2x 系列蓝牙应用指导 2.3.2.5. AT+QBTGATDBALC 请求分配数据库 AT+ QBTGATDDBALC 请求分配数据库 测试命令 AT+QBTGATDBALC=? 响应 +QBTGATDBALC: ,, OK 设置命令 分配数据库 AT+QBTGATDBALC=,, 最大响应时间 10 秒 特性说明 该命令立即生效。 不保存参数配置。 参数 整型。GATT ID。 整型。属性句柄数量。 整型。应用程序优先选择的 StartHandle。0 表示无偏好。 举例 AT+QBTGATDBALC=131106,200,0 OK //分配数据库。 2.3.2.6. AT+QBTGATDBDEALC 请求取消分配数据库 AT+QBTGATDBDEALC 请求取消分配数据库 测试命令 AT+QBTGATDBDEALC=? 响应 +QBTGATDBDEALC: 设置命令 AT+QBTGATDBDEALC= OK 响应 OK 或者 上海移远通信技术股份有限公司 15 / 40 最大响应时间 特性说明 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。GATT ID。 EG25-G&EC2x 系列蓝牙应用指导 举例 AT+QBTGATDBDEALC=131106 OK //取消分配数据库。 2.3.2.7. AT+QBTGATSIND 发送指示 AT+QBTGATSIND 发送指示 测试命令 AT+QBTGATSIND=? 响应 +QBTGATSIND: ,,,, 设置命令 AT+QBTGATSIND=,,,, OK 响应 OK 或者 ERROR 最大响应时间 10 秒 特性说明 该命令立即生效。 不保存参数配置。 参数 整型。GATT ID。 整型。连接 ID。 整型。属性句柄。范围：0~65535。 整型。指示的长度。范围：0~128。单位：字节。 字符串类型。指示的内容。 上海移远通信技术股份有限公司 16 / 40 举例 AT+QBTGATSIND=131106,1048576,14,4,'1111' OK EG25-G&EC2x 系列蓝牙应用指导 //发送指示。 2.3.2.8. AT+QBTGATSNOD 发送通知 AT+QBTGATSNOD 发送通知 测试命令 AT+QBTGATSNOD=? 响应 +QBTGATSNOD: ,,,< value_length>, 设置命令 AT+QBTGATSNOD=,,,, 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。GATT ID。 整型。连接 ID。 整型。属性句柄。范围：0~65535。 整型。通知的长度。范围：0~128。单位：字节。 字符串类型。通知的内容。 举例 AT+QBTGATSNOD=131106,1048576,14,4,'1111' OK //发送通知。 上海移远通信技术股份有限公司 17 / 40 EG25-G&EC2x 系列蓝牙应用指导 2.3.2.9. AT+QBTGATADV 设置广播参数 AT+QBTGATADV 设置广播参数 测试命令 AT+QBTGATADV=? 响应 +QBTGATADV: ,, 设置命令 AT+QBTGATADV=,, OK 响应 OK 或者 ERROR 最大响应时间 10 秒 特性说明 该命令立即生效。 不保存参数配置。 参数 整型。GATT ID。 整型。最小广告间隔。需小于。 整型。最大广告间隔。范围：20~10240。单位：毫秒。 举例 AT+QBTGATADV=131106,800,2000 OK //设置广播参数。 2.3.2.10. AT+QBTGATRRSP 读取数据 AT+QBTGATRRSP 读取数据 测试命令 AT+QBTGATRRSP=? 响应 +QBTGATRRSP: ,,, (支持的列表),, 设置命令 AT+QBTGATRRSP=,,,,, 最大响应时间 特性说明 ERROR 10 秒 / EG25-G&EC2x 系列蓝牙应用指导 参数 整型。GATT ID。 整型。连接 ID。 整型。属性句柄。范围：0~65535。 整型。返回值的长度。范围：0~128。单位：字节。 整型。返回的内容。 整型。表示操作是否成功。 0 成功 1 失败 举例 AT+QBTGATRRSP=131106,10000,6549,0,7,'quectel' OK //读取数据。 2.3.2.11. AT+QBTGATWRSP 对写入数据做出响应 AT+QBTGATWRSP 对写入数据做出响应 测试命令 AT+QBTGATWRSP=? 响应 +QBTGATWRSP: ,,, (支持的列表) 设置命令 AT+QBTGATWRSP=,,, 最大响应时间 OK 响应 OK 或者 ERROR 10 秒 特性说明 / 上海移远通信技术股份有限公司 19 / 40 EG25-G&EC2x 系列蓝牙应用指导 参数 整型。GATT ID。 整型。连接 ID。 整型。属性句柄。范围：0~65535。 整型。表示操作是否成功。 0 成功 1 失败 举例 AT+QBTGATWRSP=131106,10000,6594,0 OK //对写入数据做出响应。 2.3.2.12. AT+QBTGATSA 是否激活数据库服务 AT+QBTGATSA 是否激活数据库服务 测试命令 AT+QBTGATSA=? 响应 +QBTGATSA: ,, 设置命令 AT+QBTGATSA=,, OK 响应 OK 或者 ERROR 最大响应时间 特性说明 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。应用程序标识。 整型。服务 ID。范围：0~65535。 整型。是否激活数据库服务。 0 不激活数据库服务 1 激活数据库服务 上海移远通信技术股份有限公司 20 / 40 EG25-G&EC2x 系列蓝牙应用指导 举例 AT+QBTGATSA=131106,1,1 OK //激活数据库服务 2.3.2.13. AT+QBTGATDA 添加数据库 AT+QBTGATDA 添加数据库 测试命令 AT+QBTGATDA=? 设置命令 AT+QBTGATDA= 最大响应时间 特性说明 响应 +QBTGATDA: OK 响应 OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。GATT ID。 举例 AT+QBTGATDA=131106 OK //添加数据库。 2.3.2.14. AT+QBTGATDISC 主动断开连接服务器 AT+ QBTGATDISC 主动断开连接服务器 测试命令 AT+QBTGATDISC=? 响应 + QBTGATDISC: , OK 上海移远通信技术股份有限公司 21 / 40 EG25-G&EC2x 系列蓝牙应用指导 设置命令 AT+QBTGATDISC=, 响应 OK 或者 ERROR 最大响应时间 10 秒 特性说明 该命令立即生效。 不保存参数配置。 参数 整型。GATT ID。 整型。连接 ID。 举例 AT+QBTGATDISC=131106,10000 OK //主动断开连接服务器。 2.3.2.15. AT+QBTGATPER 开启外围设备模式 AT+QBTGATPER 开启外围设备模式 测试命令 AT+QBTGATPER=? 响应 +QBTGATPER: 设置命令 AT+QBTGATPER= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。GATT ID。 上海移远通信技术股份有限公司 22 / 40 举例 AT+QBTGATPER=131106 OK //开启外围设备模式。 EG25-G&EC2x 系列蓝牙应用指导 2.4. SPP AT 命令详解 2.4.1. AT+QBTSPPACT 激活/去激活 SPP 设备 AT+QBTSPPACT 测试命令 AT+QBTSPPACT=? 激活/去激活 SPP 设备 响应 +QBTSPPACT: (支持的列表) 设置命令 AT+QBTSPPACT= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。表示激活或者去激活 SPP 设备。 0 去激活 1 激活 举例 AT+QBTSPPACT=1 OK //激活 SPP 设备。 2.4.2. AT+QBTSPPDIC 断开与 SPP 设备的连接 AT+QBTSPPDIC 断开与 SPP 设备的连接 测试命令 AT+QBTSPPDIC=? 响应 +QBTSPPDIC: (支持的列表) 上海移远通信技术股份有限公司 23 / 40 EG25-G&EC2x 系列蓝牙应用指导 设置命令 AT+QBTSPPDIC= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 10 秒。 该命令立即生效。 不保存参数配置。 参数 整型。表示断开与 SPP 的连接。 1 断开连接 举例 AT+QBTSPPDIC=1 OK //断开与 SPP 的连接。 2.4.3. AT+QBTSPPWRS 向远程设备写入消息 AT+QBTSPPWRS 向远程设备写入消息 测试命令 AT+QBTSPPWRS=? 响应 +QBTSPPWRS: , 设置命令 AT+QBTSPPWRS=,< value> OK 响应 OK 或者 ERROR 最大响应时间 10 秒 特性说明 该命令立即生效。 不保存参数配置。 参数 字符串类型。表示消息的负载。 上海移远通信技术股份有限公司 24 / 40 整型。负载长度。 举例 AT+QBTSPPWRS=7,'quectel' //向远程设备写入消息。 OK EG25-G&EC2x 系列蓝牙应用指导 2.5. HFP-AG* AT 命令详解 2.5.1. AT+QBTSCAN 开启/关闭自动扫描远端设备 AT+QBTSCAN 开启/关闭自动扫描远端设备 测试命令 AT+QBTSCAN=? 响应 +QBTSCAN: (支持的列表) 设置命令 AT+QBTSCAN= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。表示开启/关闭自动扫描远端设备。 1 开启 0 关闭 举例 AT+QBTSCAN=1 OK //开启自动扫描远端设备。 上海移远通信技术股份有限公司 25 / 40 EG25-G&EC2x 系列蓝牙应用指导 2.5.2. AT+QBTAVREG 注册 AV*功能 AT+QBTAVREG 注册 AV*功能 测试命令 AT+QBTAVREG=? 响应 +QBTAVREG: (支持的列表) 设置命令 AT+QBTAVREG= 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。注册 AV 功能。 1 注册 AV 功能 举例 AT+QBTAVREG=1 OK //注册 AV 功能。 2.5.3. AT+QBTAVACT 激活/去激活 AV*功能 AT+QBTAVACT 激活/去激活 AV*功能 测试命令 AT+QBTAVACT=? 响应 +QBTAVACT: (支持的列表) 设置命令 AT+QBTAVACT= 最大响应时间 OK 响应 OK 或者 ERROR 10 秒 上海移远通信技术股份有限公司 26 / 40 EG25-G&EC2x 系列蓝牙应用指导 特性说明 该命令立即生效。 不保存参数配置。 参数 整型。表示激活/去激活 AV 功能。 1 激活 AV 功能 0 去激活 AV 功能 举例 AT+QBTAVACT=1 OK //激活 AV 功能。 2.5.4. AT+QBTAVCON 控制远端设备与 AV*功能连接的状态 AT+QBTAVCON 控制远端设备与 AV*功能连接的状态 测试命令 AT+QBTAVCON=? 响应 +QBTAVCON: (支持的范围),, 设置命令 AT+QBTAVCON=[,][, ] OK 响应 若设置为 1 时，需省略，建立 AV 功能连接： +QBTAVCON: 1, OK 若设置为 2 时，需省略，取消建立 AV 功能连 接： OK 若设置为 0 时，需省略，断开 AV 功能连接: OK 最大响应时间 特性说明 若出错： ERROR 10 秒 该命令立即生效。 不保存参数配置。 上海移远通信技术股份有限公司 27 / 40 参数 整型。控制远端设备与 AV 功能连接的状态。 0 断开连接 1 建立连接 2 取消建立连接 整型。连接建 ID。 字符串类型。远端设备蓝牙地址。 举例 AT+QBTAVCON=1,'2000:00:00893c' +QBTAVCON: 1,83245 OK AT+QBTAVCON=0,83245 OK //建立连接。 //断开连接。 EG25-G&EC2x 系列蓝牙应用指导 2.5.5. AT+QBTHFGCON 控制远端设备与 HFP-AG*连接的状态 AT+QBTHFGCON 控制远端设备与 HFP-AG*连接的状态 测试命令 AT+QBTHFGCON=? 响应 +QBTHFGCON: (支持的列表), 设置命令 AT+QBTHFGCON=, 最大响应时间 特性说明 OK 响应 OK 或者 ERROR 10 秒 该命令立即生效。 不保存参数配置。 参数 整型。控制远端设备与 HFP-AG 连接的状态。 0 断开连接 1 建立连接 字符串类型。远端设备蓝牙地址。 上海移远通信技术股份有限公司 28 / 40 举例 AT+QBTHFGCON=1,'2000:00:00893c' OK AT+QBTHFGCON=0,'2000:00:00893c' OK //建立连接。 //断开连接。 备注 '*' 表示 HFP-AG 协议和 AV 功能正在开发中。 EG25-G&EC2x 系列蓝牙应用指导 上海移远通信技术股份有限公司 29 / 40 EG25-G&EC2x 系列蓝牙应用指导 3 URC 详解 3.1. 低功耗蓝牙相关 URC 3.1.1. +QBTGATSCON 通知连接 GATT +QBTGATSCON 通知 GATT 连接状态 +QBTGATSCON=,,, 参数 整型。GATT ID。 整型。连接 ID。 字符串类型。连接的设备地址。 整型。建立连接期间向远程设备发布的最大传输单位。 举例 +QBTGATSCON: 131106,1000,'69b4:67:55370a',23 3.1.2. +QBTGATSDCON 通知断开 GATT +QBTGATSDCON 通知断开 GATT +QBTGATSDCON=,, 参数 整型。GATT ID。 整型。连接 ID。 字符串类型。断开连接的设备地址。 上海移远通信技术股份有限公司 30 / 40 举例 +QBTGATSDCON: 131106,1000,'69b4:67:55370a' EG25-G&EC2x 系列蓝牙应用指导 3.1.3. +QBTGATSRRSP 通知客户端读取 GATT 服务数据 +QBTGATSRRSP 通知客户端读取 GATT 服务数据 +QBTGATSRRSP=,conn_ID>, 参数 整型。GATT ID。 整型。连接 ID。 整型。属性句柄。范围：0~65535。 举例 +QBTGATSRRSP: 131106,1000,14 3.1.4. +QBTGATSWRSP 通知客户端写入 GATT 服务数据 +QBTGATSWRSP 通知客户端写入 GATT 服务数据 +QBTGATSWRSP=,,, 参数 整型。应用程序标识。 整型。连接 ID。 整型。属性句柄。范围：0~65535。 字符串类型。写入的内容。 举例 +QBTGATSWRSP: 131106,1000,14,'1234' 上海移远通信技术股份有限公司 31 / 40 EG25-G&EC2x 系列蓝牙应用指导 3.2. SPP 相关 URC 3.2.1. +QBTSPPDATAIND 上报数据 +QBTSPPDATAIND 上报数据 +QBTSPPDATAIND: , 参数 字符串类型。表示数据的负载。 整型。数据负载长度。 举例 +QBTSPPDATAIND: '66998855',8 3.2.2. +QBTSPPCONNECT 通知已连接 SPP +QBTGATSDCON 通知已连接 SPP +QBTSPPCONNECT: ,, 参数 整型。表示已激活的 SPP 实例的标识符。 整型。表示本地服务器号，CM 使用的参考 ID。 字符串类型。已连接 SPP 的设备地址。 举例 +QBTSPPCONNECT: 32,1,'4887:64:d8b950' 3.2.3. +QBTSPPDISCONNECT 通知已断开 SPP 连接 +QBTSPPDISCONNECT 通知已断开 SPP 连接 +QBTSPPCONNECT: ,, 上海移远通信技术股份有限公司 32 / 40 EG25-G&EC2x 系列蓝牙应用指导 参数 整型。表示已激活的 SPP 示例的标识符. 整型。表示本地服务器号，CM 使用的参考 ID。 字符串类型。已断开 SPP 连接的设备地址。 举例 +QBTSPPDISCONNECT: 32,1,'4887:64:d8b950' 3.3. HFP-AG*相关 URC 3.3.1. +QBTSEARCHDEVICES 通知扫描的设备蓝牙名称和地址 +QBTSEARCHDEVICES 通知扫描的设备蓝牙名称和地址 +QBTSEARCHDEVICES: , 参数 字符串类型。扫描的设备的蓝牙名称。 字符串类型。扫描的设备的蓝牙地址。 举例 +QBTSEARCHDEVICES: 'phone','2000:00:00893c' 3.3.2. +QBTAVCONNECT 通知已建立 AV*功能连接 +QBTAVCONNECT 通知已建立 AV*功能连接 +QBTAVCONNECT: , 参数 整型。连接 ID。 字符串类型。已建立 AV 功能连接的设备的蓝牙地址。 上海移远通信技术股份有限公司 33 / 40 举例 +QBTAVCONNECT: 83245,'2000:00:00893c' EG25-G&EC2x 系列蓝牙应用指导 3.3.3. +QBTAVDISCONNECT 通知远端设备已断开 AV*功能连接 +QBTAVDISCONNECT 通知远端设备已断开 AV*功能连接 +QBTAVDISCONNECT: 参数 整型。连接 ID。 举例 +QBTAVDISCONNECT: 83245 3.3.4. +QBTHFGCONNECT 通知远端设备已建立 HFP-AG*连接 +QBTHFGCONNECT 通知远端设备已建立 HFP-AG*连接 +QBTHFGCONNECT: , 参数 整型。连接 ID。 字符串类型。已建立连接的远端设备的蓝牙地址。 举例 +QBTHFGCONNECT: 83245,'2000:00:00893c' 3.3.5. +QBTHFGDISCONNECT 通知远端设备已断开 HFP-AG*连接 +QBTHFGDISCONNECT 通知远端设备已断开 HFP-AG*连接 +QBTHFGDISCONNECT: 上海移远通信技术股份有限公司 34 / 40 参数 整型。连接 ID。 字符串类型。已建立连接的远端设备的蓝牙地址。 举例 +QBTHFGDISCONNECT: 83245,'2000:00:00893c' EG25-G&EC2x 系列蓝牙应用指导 3.3.6. +QBTHFGANSWER 通知 HF 已应答电话 +QBTHFGANSWER 通知 HF 已应答电话 +QBTHFGANSWER: 参数 整型。连接 ID。 举例 +QBTHFGANSWER: 83245 3.3.7. +QBTHFGREJECT 通知 HF 已拒接电话 +QBTHFGREJECT 通知 HF 已拒接电话 +QBTHFGREJECT: 参数 整型。连接 ID。 举例 +QBTHFGREJECT: 83245 上海移远通信技术股份有限公司 35 / 40 备注 '*' 表示 HFP-AG 协议和 AV 功能正在开发中。 EG25-G&EC2x 系列蓝牙应用指导 上海移远通信技术股份有限公司 36 / 40 EG25-G&EC2x 系列蓝牙应用指导 4 举例 4.1. 低功耗蓝牙通信 本文档提供的 AT 命令用于支持低功耗蓝牙功能的基本操作，包括扫描、广播、连接等。移远通信 FC20 系列& FC21 模块支持在适用的 LTE Standard 模块和其他低功耗蓝牙设备之间进行通信。 如下为模块作为低功耗蓝牙服务器时的低功耗蓝牙流程。 AT+QBTPWR=1 OK AT+QBTGATREG=1 +QBTGATREG: 1,131106 //注册 GATT 服务。 OK AT+QBTGATDBALC=131106,200,0 OK AT+QBTGATSS=1,131106,1,6154,1 OK AT+QBTGATSC=1,131106,1,1,10793,7,18,16,'quectel' OK AT+QBTGATSD=1,131106,1,1,1,10498,7,2,0,'quectel' OK AT+QBTGATSC=1,131106,1,2,10777,7,6,32,'quectel' OK AT+QBTGATSA=131106,1,1 OK AT+QBTGATDA=131106 OK AT+QBTGATPER=131106 OK //分配数据库。 /添加服务。 //添加特征。 //添加描述。 //添加另一个特征。 //激活数据库服务。 //添加数据库。 //开启外围设备模式。 上海移远通信技术股份有限公司 37 / 40 EG25-G&EC2x 系列蓝牙应用指导 4.2. SPP 激活 本章主要介绍模块作为 SPP 服务器时，激活 SPP 的流程的简单示例。Quectel FC20 系列 & FC21 模 块支持在适用的 LTE Standard 模块和其他 SPP 设备之间进行通信。 AT+QBTPWR=1 OK AT+QBTSPPACT=1 OK //打开蓝牙。 //激活 SPP。 4.3. HFP-AG*操作步骤 本章主要介绍模块作为 HFP-AG 服务器时，激活并连接 HFP-AG 的操作实例。 AT+QBTPWR=2 OK AT+QBTSCAN=1 OK //打开 HFP-AG。 //打开扫描，搜索设备。 +QBTSEARCHDEVICES: 'phone','2000:00:00893c' +QBTSEARCHDEVICES: 'HUAWEI Mate F','88f8:72:68ef6e' ... AT+QBTSCAN=0 OK AT+QBTAVREG=1 OK AT+QBTAVACT=1 OK AT+QBTAVCON=1,'2000:00:00893c' +QBTAVCON: 1,83245 //关闭扫描功能。 //注册 AV*功能功能。 //激活 AV*功能功能。 //建立 AV*功能连接。 OK AT+QBTHFGCON=1,'2000:00:00893c' OK //建立 HFP-AG 连接。 +QBTHFGCONNECT: 83245,'2000:00:00893c' 上海移远通信技术股份有限公司 38 / 40 备注 '*' 表示 HFP-AG 协议和 AV 功能正在开发中。 EG25-G&EC2x 系列蓝牙应用指导 上海移远通信技术股份有限公司 39 / 40 EG25-G&EC2x 系列蓝牙应用指导 5 附录 A 术语缩写 表 2：术语缩写 缩写 AG AV BLE BT CM GATT HF HFP ID SPP URC UUID 英文全称 Audio Gateway Audio Video Bluetooth Low Energy Bluetooth Connection Manager Generic Attribute Profile Hands Free Hands-free Profile Identity Serial Port Profile Unsolicited Result Code Universally Unique Identifier 中文全称 音频网关 音频视频 蓝牙低能耗 蓝牙 连接管理器 通用属性配置文件 免提组件 免提网关协议 标识 蓝牙串口 非请求结果码 通用唯一识别码 上海移远通信技术股份有限公司 40 / 40

RG500Q 系列 Wi-Fi 应用指导 5G 模块系列 版本：1.0 日期：2020-09-03 状态：受控文件 www.quectel.com RG500Q 系列 Wi-Fi 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 30 RG500Q 系列 Wi-Fi 应用指导 文档历史 修订记录 版本 1.0 日期 2020-09-03 作者 刘优优 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 30 RG500Q 系列 Wi-Fi 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 图片索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 环境搭建 ................................................................................................................................................. 7 2.1. 硬件准备 ...................................................................................................................................... 7 2.2. 软件准备 ...................................................................................................................................... 7 3 Wi-Fi 功能使用 ....................................................................................................................................... 9 3.1. QCMAP 下使用模块 Wi-Fi 功能 .................................................................................................. 9 3.1.1. 开启 Wi-Fi 的默认配置.................................................................................................... 10 3.1.2. 关闭 Wi-Fi 的默认配置.................................................................................................... 12 3.1.3. 设置 AP 模式 .................................................................................................................. 13 3.1.4. 设置 AP+AP 模式 ........................................................................................................... 14 3.1.5. 设置 AP+AP+AP 模式 .................................................................................................... 15 3.1.6. 设置 AP+STA 模式 ......................................................................................................... 16 3.1.7. 获取 WLAN 配置............................................................................................................. 17 3.1.8. 获取 WLAN 状态............................................................................................................. 18 3.1.9. 获取 WLAN IF 信息 ........................................................................................................ 19 3.1.10. 激活 Hostapd 配置.......................................................................................................... 20 3.2. 无 QCMAP 下使用模块 Wi-Fi 功能............................................................................................ 20 3.2.1. 修改 hostapd.conf 文件 .................................................................................................. 20 3.2.1.1. 修改 interface ...................................................................................................... 21 3.2.1.2. 修改 ssid .............................................................................................................. 21 3.2.1.3. 修改 country_code............................................................................................... 21 3.2.1.4. 修改 hw_mode..................................................................................................... 21 3.2.1.5. 修改 channel........................................................................................................ 21 3.2.1.6. 修改 ht_capab ..................................................................................................... 21 3.2.1.7. 修改 ieee80211ac................................................................................................ 21 3.2.1.8. 修改 ieee80211ax................................................................................................ 21 3.2.1.9. 设置 vht_oper_chwidth........................................................................................ 22 3.2.1.10. 修改 wpa_passphrase ......................................................................................... 22 3.2.1.11. 修改 wpa_key_mgmt ........................................................................................... 22 3.2.1.12. 修改 max_num_sta.............................................................................................. 22 3.2.1.13. 设置 deny_mac_file 和 accept_mac_file ............................................................. 22 3.2.1.14. 设置 ignore_broadcast_ssid................................................................................ 22 3.2.1.15. 设置 WPS ............................................................................................................ 23 3.2.1.16. 配置其他性能参数 ............................................................................................... 23 3.2.2. 修改 wpa_supplicant.conf .............................................................................................. 23 3.2.2.1. 修改 ssid .............................................................................................................. 23 3.2.2.2. 修改 psk............................................................................................................... 24 上海移远通信技术股份有限公司 3 / 30 RG500Q 系列 Wi-Fi 应用指导 3.2.3. 通过脚本使用 Wi-Fi 功能 ................................................................................................ 24 3.2.3.1. 设置 AP 模式 ....................................................................................................... 24 3.2.3.2. 设置 AP+AP 模式 ................................................................................................ 24 3.2.3.3. 设置 AP+AP+AP 模式 ......................................................................................... 24 3.2.3.4. 设置 AP+STA 模式 .............................................................................................. 25 3.2.3.5. 设置 STA 模式 ..................................................................................................... 25 3.3. 查看 WLAN 的配置信息............................................................................................................. 26 3.4. 配置 Wi-Fi 连接状态 .................................................................................................................. 27 3.5. 设置国家码 ................................................................................................................................ 28 4 附录 A 术语缩写 ................................................................................................................................... 29 上海移远通信技术股份有限公司 4 / 30 RG500Q 系列 Wi-Fi 应用指导 图片索引 图 1：嵌入 RG500Q 系列和 FG50V 模块的 5G EVB................................................................................... 8 图 2：Wi-Fi 数据通路框架 ............................................................................................................................ 9 上海移远通信技术股份有限公司 5 / 30 RG500Q 系列 Wi-Fi 应用指导 1 引言 本文档主要介绍移远通信 RG500Q 系列模块联合 FG50V 模块后 Wi-Fi 功能的使用方法。 上海移远通信技术股份有限公司 6 / 30 RG500Q 系列 Wi-Fi 应用指导 2 环境搭建 2.1. 硬件准备  RG500Q 系列模块  移远通信 5G EVB  FG50V 模块  Wi-Fi 客户端 2.2. 软件准备 1. 2. ADB； 3. 4. 5. 使用 QFIL 工具下载模块相应的软件版本； 执行 AT+QADBKEY=和 AT+QCFG='usbcfg',0x2C7C,0x0125,1,1,1,1,1,1 启用 执行 AT+QCFG='pcie/mode',1 启用 PCI-E RC 模式； 执行 AT+QMAPWAC=1 启用 5G 自动拨号功能； 重启 RG500Q 系列模块。 有关上述 AT 命令的详细信息，可参考文档《Quectel_RG50xQ&RM5xxQ_Series_AT_Commands_ Manual》。 上海移远通信技术股份有限公司 7 / 30 RG500Q 系列 Wi-Fi 应用指导 图 1：嵌入 RG500Q 系列和 FG50V 模块的 5G EVB 备注 使用 QFIL 工具需高通授权。 上海移远通信技术股份有限公司 8 / 30 RG500Q 系列 Wi-Fi 应用指导 3 Wi-Fi 功能使用 3.1. QCMAP 下使用模块 Wi-Fi 功能 RG500Q 系列模块内嵌 QCMAP（Qualcomm Mobile Access Point）框架，也称为 SoftAP、移动热点、 Wi-Fi 网络共享、MiFi 和便携式路由器。本章节介绍如何使用 RG500Q 系列模块（联合 FG50V）Wi-Fi 功 能并进行相关模式配置。 图 2：Wi-Fi 数据通路框架 上海移远通信技术股份有限公司 9 / 30 3.1.1. 开启 Wi-Fi 的默认配置 第一步：执行如下命令开启 Wi-Fi 功能： adb shell QCMAP_CLI RG500Q 系列 Wi-Fi 应用指导 第二步：如下图所示依次输入'1'、'2'、'1'，即可开启 MobileAP： 上海移远通信技术股份有限公司 10 / 30 RG500Q 系列 Wi-Fi 应用指导 第三步：如下图所示依次输入'4'、'1'、'1'，即可开启 WLAN： 第四步：打开 Wi-Fi 客户端的 Wi-Fi，扫描时可搜索到模块 QsoftAP 的 SSID，点击并连接，默认密码 为 1234567890。 备注 默认模块被搜索到的 Wi-Fi 名称为 QsoftAP，用户可根据需求进行修改。 上海移远通信技术股份有限公司 11 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.2. 关闭 Wi-Fi 的默认配置 关闭 WLAN 即可关闭 Wi-Fi 功能。如下图所示，依次输入'4'、'1'、'0'即可关闭 WLAN。此时打 开 Wi-Fi 客户端的 Wi-Fi 将无法搜索到 QsoftAP，即表示已关闭模块的 Wi-Fi 功能。 上海移远通信技术股份有限公司 12 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.3. 设置 AP 模式 第一步：依次执行第 3.1.1 章所述第一步和第二步。 第二步：如下图所示依次输入'4'和'3'选择'Set WLAN Config'（设置 WLAN）后，根据返回 值再输入'1'选择 WLAN 模式类型为 AP： 上海移远通信技术股份有限公司 13 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.4. 设置 AP+AP 模式 第一步：依次执行第 3.1.1 章所述第一步和第二步。 第二步：如下图所示依次输入'4'和'3'选择'Set WLAN Config'（设置 WLAN）后，根据返回 值再输入'2'选择 WLAN 模式类型为 AP-AP： 上海移远通信技术股份有限公司 14 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.5. 设置 AP+AP+AP 模式 第一步：依次执行第 3.1.1 章所述第一步和第二步。 第二步：如下图所示依次输入'4'和'3'选择'Set WLAN Config'（设置 WLAN）后，根据返回 值再输入'4'选择 WLAN 模式类型为 AP-AP-AP： 上海移远通信技术股份有限公司 15 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.6. 设置 AP+STA 模式 第一步：依次执行第 3.1.1 章所述第一步和第二步。 第二步：如下图所示依次输入'4'和'3'选择'Set WLAN Config'（设置 WLAN）后，根据返回 值再输入'3'选择 WLAN 模式类型为 AP-STA： 上海移远通信技术股份有限公司 16 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.7. 获取 WLAN 配置 第一步：依次执行第 3.1.1 章所述第一步和第二步。 第二步：如下图所示输入'4'选择'Set WLAN Config'（设置 WLAN）后，根据返回值再输入'4' 即可查看 WLAN 配置信息： 上海移远通信技术股份有限公司 17 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.8. 获取 WLAN 状态 第一步：依次执行第 3.1.1 章所述第一步和第二步。 第二步：如下图所示输入'4'选择'Set WLAN Config'（设置 WLAN）后，根据返回值再输入'5'， 即可查看 WLAN 状态信息： 上海移远通信技术股份有限公司 18 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.9. 获取 WLAN IF 信息 第一步：依次执行第 3.1.1 章所述第一步和第二步。 第二步：如下图所示输入'4'选择'Set WLAN Config'（设置 WLAN）后，根据返回值再输入'11'， 即可查看 WLAN IF（WLAN 接口）信息： 上海移远通信技术股份有限公司 19 / 30 RG500Q 系列 Wi-Fi 应用指导 3.1.10. 激活 Hostapd 配置 第一步：依次执行第 3.1.1 章所述第一步、第二步和第三步。 第二步：如下图所示输入'4'选择'Set WLAN Config'（设置 WLAN）后，根据返回值再输入'9' 选择激活 Hostapd 配置： 3.2. 无 QCMAP 下使用模块 Wi-Fi 功能 Wi-Fi 客户端若无 QCMAP，在 AP 模式下可通过第 3.2.1 和 3.2.3 章所述使用模块的 Wi-Fi 功能；STA 模式下可通过第 3.2.2 和 3.2.3 章所述使用模块的 Wi-Fi 功能。 3.2.1. 修改 hostapd.conf 文件 执行如下命令将 hostapd.conf 文件下载至模块： adb shell mount –o rw,remount / adb push hostapd.conf /etc/misc/wifi/hostapd.conf 下载前，可修改 hostapd.conf 文件的参数配置。本章节将介绍可配置的参数信息。 上海移远通信技术股份有限公司 20 / 30 RG500Q 系列 Wi-Fi 应用指导 3.2.1.1. 修改 interface Interface 表示 Wi-Fi AP 网络接口名称，该接口名称可以修改。需注意多 AP 模式下接口名称不可重复。 例如：可将 interface 修改为 wlan0。 3.2.1.2. 修改 ssid ssid 表示 Wi-Fi 网络名称，即终端可见的 Wi-Fi 名称，可自行修改。修改时需注意与其他已有的 Wi-Fi 网络名称进行区分。例如：可将 ssid 修改为 QsoftAP_0_5G。 3.2.1.3. 修改 country_code country_code 表示国家码，可根据实际使用地区进行设置，中国大陆一般设置为 CN。例如：可将 country_code 修改为 CN。 3.2.1.4. 修改 hw_mode hw_mode 表示 Wi-Fi 的工作模式；a 表示 5G，g 表示 2.4G。例如：可将 hw_mode 修改为 a。 3.2.1.5. 修改 channel channel 表示信道，可设置为固定值，即固定信道，AP 也可自动选择信道。例如：可将 channel 设置 为固定值 0。 3.2.1.6. 修改 ht_capab ht_capab 表示 HT 能力集，建议修改为[HT40-][HT40+][SHORT-GI-20][SHORT-GI-40]。 3.2.1.7. 修改 ieee80211ac 如需使能 802.11ac，需将 Wi-Fi 协议 ieee80211ac 修改为 1。 3.2.1.8. 修改 ieee80211ax 如需使能 802.11ax，需将 Wi-Fi 协议 ieee80211ax 修改为 1。 上海移远通信技术股份有限公司 21 / 30 RG500Q 系列 Wi-Fi 应用指导 3.2.1.9. 设置 vht_oper_chwidth vht_oper_chwidth 表示工作带宽。0 表示 20 MHz 或 40 MHz；1 表示 80 MHz。例如：可将 vht_oper_chwidth 修改为 1。 3.2.1.10.修改 wpa_passphrase wpa_passphrase 表示 Wi-Fi 加密密钥，可自行修改。例如：可将 wpa_passphrase 修改为 1234567890。 3.2.1.11.修改 wpa_key_mgmt 通过修改 wpa_key_mgmt 的值，即可设置相应的加密模式： 1. 若需将加密模式设置为 wpa2，需将 wpa_key_mgmt 设置为 WPA-PSK。 2. 若需将加密模式设置为 wpa3，首先需将 Wi-Fi 协议 ieee80211w 设置为 1，使能 802.11w，然后 设置 wpa_key_mgmt。若 wpa_key_mgmt 设置为 WPA-PSK SAE，即为 wpa3 SAE 模式；若 wpa_key_mgmt 设置为 WPA-PSK OWE，即为 wpa3 OWE 模式。 3.2.1.12.修改 max_num_sta max_num_sta 表示可连接的最大客户端数量，建议最大数量不超过 32。例如，可将 max_num_sta 修 改为 6。 3.2.1.13.设置 deny_mac_file 和 accept_mac_file 用户可以通过修改 hostapd.deny 和 hostapd.accept 文件添加 MAC 地址，修改后的文件名分别为 deny_mac_file 和 accept_mac_file，修改后需执行如下命令将文件下载至模块： adb shell mount –o rw,remount / adb push hostapd.accept /etc adb push hostapd.deny /etc 3.2.1.14.设置 ignore_broadcast_ssid ignore_broadcast_ssid 表示隐藏 SSID，当设置为 1 时，表示打开隐藏 SSID 功能。 上海移远通信技术股份有限公司 22 / 30 RG500Q 系列 Wi-Fi 应用指导 3.2.1.15.设置 WPS WPS 参数建议按照如下信息进行配置：  eap_server=1  wps_state=2  ap_setup_locked=1  uuid=12345678-9abc-def0-1234-56789abcdef0  wps_pin_requests=/var/run/hostapd_wps_pin_requests  device_name=FG50V  manufacturer= uectel  model_name=WAP  model_number=123  serial_number=12345  device_type=6-0050F204-1  os_version=01020300  config_methods=label virtual_display virtual_push_button keypad  pbc_in_m1=1  ap_pin=12345670  friendly_name=FG50V-WPSAP 3.2.1.16. 配置其他性能参数 其他性能参数建议按照如下信息进行配置：  he_bss_color=15  he_su_beamformer=1  he_su_beamformee=1  he_mu_beamformer=1  he_default_pe_duration=4  he_twt_required=1  he_rts_threshold=16 3.2.2. 修改 wpa_supplicant.conf 修改 STA 模式的配置文件 wpa_supplicant.conf 的参数 ssid 和 pask。 3.2.2.1. 修改 ssid ssid 为用来连接 AP 的 SSID，可自行修改。 上海移远通信技术股份有限公司 23 / 30 RG500Q 系列 Wi-Fi 应用指导 3.2.2.2. 修改 psk psk 为用来连接 AP 的 Wi-Fi 密钥，可自行修改。 3.2.3. 通过脚本使用 Wi-Fi 功能 3.2.3.1. 设置 AP 模式 执行如下命令开启 AP 模式： insmod /usr/lib/modules/4.14.117/extra/wlan.ko country_code=CN //加载 Wi-Fi 驱动。 iw dev wlan0 set type __ap //设置 Wi-Fi AP 网络接口 wlan0 的 WLAN 模式类型为 AP。 ifconfig wlan0 up brctl addif bridge0 wlan0 //将 wlan0 添加到网桥中。 hostapd -B /etc/misc/wifi/hostapd.conf -P /var/run/data/hostapd_ssid0.pid -e /data/entropy_file1 -dd -f /var/run/primary-hostapd.log //启动 hostapd。 3.2.3.2. 设置 AP+AP 模式 执行如下命令开启 AP+AP 模式： insmod /usr/lib/modules/4.14.117/extra/wlan.ko country_code=CN //加载 Wi-Fi 驱动。 iw dev wlan0 set type __ap //设置 Wi-Fi AP 网络接口 wlan0 的 WLAN 模式类型为 AP。 ifconfig wlan0 up iw dev wlan0 interface add wlan1 type __ap ifconfig wlan1 up brctl addif bridge0 wlan0 //将 wlan0 添加到网桥中。 brctl addif bridge0 wlan1 hostapd -B /etc/misc/wifi/hostapd.conf -P /var/run/data/hostapd_ssid0.pid -e /data/entropy_file1 -dd -f /var/run/primary-hostapd.log //启动 hostapd。 hostapd -B /etc/misc/wifi/hostapd-wlan1.conf -P /var/run/data/hostapd_ssid0.pid -e /data/entropy_file1 -dd -f /var/run/primary-hostapd.log 3.2.3.3. 设置 AP+AP+AP 模式 执行如下命令开启 AP+AP+AP 模式： insmod /usr/lib/modules/4.14.117/extra/wlan.ko country_code=CN //加载 Wi-Fi 驱动。 iw dev wlan0 set type __ap //设置 Wi-Fi AP 网络接口 wlan0 的 WLAN 模式类型为 AP。 ifconfig wlan0 up 上海移远通信技术股份有限公司 24 / 30 RG500Q 系列 Wi-Fi 应用指导 iw dev wlan0 interface add wlan1 type __ap ifconfig wlan1 up iw dev wlan0 interface add wlan2 type __ap ifconfig wlan2 up brctl addif bridge0 wlan0 //将 wlan0 添加到网桥中。 brctl addif bridge0 wlan1 brctl addif bridge0 wlan2 hostapd -B /etc/misc/wifi/hostapd.conf -P /var/run/data/hostapd_ssid0.pid -e /data/entropy_file1 -dd -f /var/run/primary-hostapd.log //启动 hostapd。 hostapd -B /etc/misc/wifi/hostapd_wlan1.conf -P /var/run/data/hostapd_ssid0.pid -e /data/entropy_file1 -dd -f /var/run/primary-hostapd.log hostapd -B /etc/misc/wifi/hostapd_wlan2.conf -P /var/run/data/hostapd_ssid0.pid -e /data/entropy_file1 -dd -f /var/run/primary-hostapd.log 3.2.3.4. 设置 AP+STA 模式 执行如下命令开启 AP+STA 模式： insmod /usr/lib/modules/4.14.117/extra/wlan.ko country_code=CN iw dev wlan0 set type station ifconfig wlan0 up iw dev wlan0 interface add wlan1 type __ap ifconfig wlan1 up brctl addif bridge0 wlan1 wpa_supplicant -i wlan0 -Dnl80211 -c /etc/misc/wifi/wpa_supplicant.conf -B hostapd -B /etc/misc/wifi/hostapd-wlan1.conf -P /var/run/data/hostapd_ssid2.pid -e /data/entropy_file1 -dd -f /var/run/guestap1-hostapd.log 3.2.3.5. 设置 STA 模式 执行如下命令开启 STA 模式： insmod /usr/lib/modules/4.14.117/extra/wlan.ko country_code=CN iw dev wlan0 set type station ifconfig wlan0 up wpa_supplicant -i wlan0 -Dnl80211 -c /etc/misc/wifi/wpa_supplicant.conf -B 上海移远通信技术股份有限公司 25 / 30 RG500Q 系列 Wi-Fi 应用指导 3.3. 查看 WLAN 的配置信息 Hostapd_cli 命令用于查看 WLAN 的配置信息，常用命令如下： 1. 命令 hostapd_cli -i wlan0 status 用于获取 WLAN 状态和一些常用配置，如下图代码所示： 2. 命令 hostapd_cli –i wlan0 get_config 用于获取 WLAN 配置，如下图代码所示： 上海移远通信技术股份有限公司 26 / 30 RG500Q 系列 Wi-Fi 应用指导 3. 命令 hostapd_cli -i wlan0 all_sta 用于获取所有连接的 Wi-Fi 客户端，如下图代码所示： 3.4. 配置 Wi-Fi 连接状态 1. 命令 wpa_cli –I wlan0 status 用于查看 Wi-Fi 连接状态： 上海移远通信技术股份有限公司 27 / 30 2. 命令 wpa_cli –i wlan0 disconnect 用于断开 Wi-Fi 连接： RG500Q 系列 Wi-Fi 应用指导 3. 命令 wpa_cli –i wlan0 reconnect 用于重新建立 Wi-Fi 连接： 3.5. 设置国家码 可通过多种方式设置国家码，以下为常用的三种方式，分别为： 1. 执行如下命令，加载 Wi-Fi 驱动时写入国家码，如写入国家码 CN： insmod /usr/lib/modules/4.14.117/extra/wlan.ko country_code=CN 2. 执行 Hostapd_cli 命令写入国家码，如写入国家码 CN： hostapd_cli -i wlan0 driver COUNTRY CN 3. 执行 wpa_cli 命令写入国家码，如写入国家码 CN： wpa_cli -i wlan0 driver COUNTRY CN 上海移远通信技术股份有限公司 28 / 30 RG500Q 系列 Wi-Fi 应用指导 4 附录 A 术语缩写 表 1：术语缩写 缩写 5G ADB AP EVB HT MAC MiFi MobileAP OWE PCI-E PSK QCMAP RC SAE SoftAP SSID STA Wi-Fi 英文全称 中文全称 5th Generation Mobile Networks 第五代移动通信技术 Android Debug Bridge Android 调试桥 Access Point 接入点 Evaluation Board 评估板 High Throughput 高吞吐 Media Access Control 媒体访问控制 Mobile Wi-Fi 移动 Wi-Fi Mobile Access Point 移动接入点 Opportunistic Wireless Encryption 机会性无限加密 Peripheral Component Interconnect Express 周边设备高速连接标准 Pre-Shared Key 共享密钥 Qualcomm Mobile Access Point Service 高通移动接入点 Root Complex 无 Simultaneous Authentication of Equals 同时对等身份认证 Soft Access Point 软接入点 Service Set Identifier 服务集标识 Station 客户端 Wireless-Fidelity 无线保真 上海移远通信技术股份有限公司 29 / 30 WLAN WPS Wireless Local Area Networks Wi-Fi Protected Setup RG500Q 系列 Wi-Fi 应用指导 无线局域网络 Wi-Fi 保护设置 上海移远通信技术股份有限公司 30 / 30

天线设计指导 版本：3.3 日期：2021-06-24 状态：受控文件 天线设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 28 天线设计指导 文档历史 修订记录 版本 1.0 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 日期 2012-06-09 2012-06-15 2012-08-01 2012-11-21 2013-07-10 2014-11-21 2015-04-11 2016-01-06 2016-06-01 1.9 2017-07-14 2.0 2018-01-02 3.0 2019-06-21 3.1 2019-07-04 作者 变更表述 魏来 初始版本 魏来 修改图片 1 魏来 添加天线生产商 Antenova 和 Pulse Electronics 的联系信息 魏来 添加 GLONASS 天线供应商 INPAQ 及其联系信息 魏来 添加陶瓷 Chip 天线类型，更新天线厂家联系信息 王照军 增加天线指标及镭雕天线 王照军 张剑楠 张剑楠 杨志强 杨志强 徐雷 增加适用模块说明 1. 增加外置 PCB 天线 2. 添加天线生产商旌泓和圣丹纳 1. 更新天线生产商杰盛康的联系信息 2. 更新天线生产商 Antenova 的地址和联系信息 1. 第 3.8 章节增加金属边框天线类型 2. 第 7 章节增加内置 Wi-Fi 叠层天线类型 3. 第 8 章节更新如下天线供应商信息： ⚫ 更新天线生产商圣丹纳和 INPAQ 的联系方式 ⚫ 删除供应商旌泓信息 ⚫ 添加天线生产商深迅的地址与联系信息 1. 优化 EIRP（等效全向辐射功率）的描述（2.1 章） 2. 更新内置 Wi-Fi 叠层天线说明的第 3 项 3. 增加 GNSS 天线隔离度设计需求（第 8 章） 4. 更新天线供应商 Pulse 的地址和联系方式（电话、传真和邮箱） 5. 增加天线供应商上海尚远（Sunnyway）和维力谷（VLG） 此次文档变动较多，因此建议通篇阅读。 徐雷 更新天线供应商信息 上海移远通信技术股份有限公司 2 / 28 天线设计指导 3.2 2020-02-13 徐雷 1. 删除天线供应商信息。 2. 增加移远通信天线设计服务章节（第 9 章）。 1. 更新本文档中的天线分类。 徐雷/ 2. 更新天线图片（第 3 章~第 7 章）。 3.3 2021-06-24 涂赫 3. 更新各类型天线的部分说明和隔离度描述（第 3 章~第 7 章和 第 8.3 章）。 上海移远通信技术股份有限公司 3 / 28 天线设计指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................ 4 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 器件摆件及天线馈点推荐位置 ............................................................................................................. 7 2 天线基本术语与要求............................................................................................................................ 8 2.1. 天线基本术语 ............................................................................................................................ 8 2.2. 天线基本要求 .......................................................................................................................... 10 3 内置 2G/3G/4G/5G 天线.................................................................................................................... 11 3.1. FPC 天线 .................................................................................................................................11 3.2. 弹片天线 ................................................................................................................................. 13 3.3. 镭雕天线 ................................................................................................................................. 13 3.4. 贴片天线 ................................................................................................................................. 14 3.5. PCB 走线天线......................................................................................................................... 15 3.6. 其他天线 ................................................................................................................................. 16 4 外置 2G/3G/4G/5G 天线.................................................................................................................... 17 4.1. 偶极天线 ................................................................................................................................. 17 4.2. 吸盘天线 ................................................................................................................................. 18 4.3. 组合天线 ................................................................................................................................. 19 4.4. 套筒天线 ................................................................................................................................. 20 5 内置 GNSS 天线................................................................................................................................ 21 5.1. GNSS 有源天线 ...................................................................................................................... 21 5.2. GNSS 无源天线 ...................................................................................................................... 22 6 外置 GNSS 天线................................................................................................................................ 23 7 内置 Wi-Fi 叠层天线 .......................................................................................................................... 24 8 天线隔离度设计需求.......................................................................................................................... 25 8.1. 天线隔离度 ............................................................................................................................. 25 8.2. 3G/4G/5G 天线与 GNSS 天线隔离度设计需求 ....................................................................... 25 8.3. 其他天线隔离度设计需求 ........................................................................................................ 26 9 天线设计服务 .................................................................................................................................... 27 10 附录 A 术语缩写 ............................................................................................................................... 28 上海移远通信技术股份有限公司 4 / 28 天线设计指导 表格索引 表 1：电压驻波比和回波耗损 .................................................................................................................... 9 表 2：天线基本要求................................................................................................................................. 10 表 3：术语缩写........................................................................................................................................ 28 上海移远通信技术股份有限公司 5 / 28 天线设计指导 图片索引 图 1：推荐器件布局图 ............................................................................................................................... 7 图 2：带焊接馈点的 FPC PIFA 天线 .........................................................................................................11 图 3：弹片作为馈点的 FPC 天线 ..............................................................................................................11 图 4：顶针作为馈点的 FPC 天线 ............................................................................................................. 12 图 5：弹片天线........................................................................................................................................ 13 图 6：镭雕天线........................................................................................................................................ 13 图 7：贴片天线........................................................................................................................................ 14 图 8：PCB 走线天线................................................................................................................................ 15 图 9：其他天线形式................................................................................................................................. 16 图 10：偶极天线形式............................................................................................................................... 17 图 11：吸盘天线 ...................................................................................................................................... 18 图 12：多合一天线 .................................................................................................................................. 19 图 13：套筒天线...................................................................................................................................... 20 图 14：带焊针的 GNSS 有源天线............................................................................................................ 21 图 15：带焊针的 GNSS 无源天线............................................................................................................ 22 图 16：GNSS 无源天线实际应用............................................................................................................. 22 图 17：外置 GNSS 天线 .......................................................................................................................... 23 图 18：内置 Wi-Fi 叠层天线形式 ............................................................................................................. 24 上海移远通信技术股份有限公司 6 / 28 天线设计指导 1 器件摆件及天线馈点推荐位置 本文档适用于所有移远通信模块。 图 1：推荐器件布局图 说明： 1. 建议在摆放模块时射频端口靠外侧；射频走线尽量不要打孔、换层。射频走线需要做 50 Ω 阻抗控制， 并保证射频端口到天线的走线最短。如果射频端口距离天线较远，建议使用射频线连接。 2. 天线馈点尽量放在 PCB 板的边缘区域，不要放在 PCB 板内侧。对于有相近频段的两天线，在环境允 许的情况下，两天线摆放距离要达到最低频率的 1/4 波长以外；距离过近时，可尽量正交摆放。 3. 一般情况下，两天线间的隔离度最少要求达到 10 dB 以上，以免产生互扰。 4. 天线摆放位置请尽量远离CPU、SDRAM、Flash、DC-DC转换器、USB和屏幕排线等，建议天线和上 述器件在PCB板的表层和底层异侧放置。 5. CPU 和 SDRAM/Flash/屏幕排线之间的高速线尽量短，且走内层，上、下、左、右包地。建议在 CPU 和屏幕排线之间的高速线上增加 EMI 滤波器。 6. 建议将 CPU/SDRAM/Flash/DC-DC/屏连接器等放到屏蔽罩内部。屏蔽罩建议使用洋白铜材质。 上海移远通信技术股份有限公司 7 / 28 天线设计指导 2 天线基本术语与要求 2.1. 天线基本术语 ⚫ Gain (dBi)：增益。在相同的输入功率下，天线在空间某点的辐射功率与理想无方向性点源天线在 同一点的功率的比值，该增益单位为 dBi，天线厂家提供的天线测试报告中的增益一般以 dBi 为单 位。 ⚫ Gain (dBd)：增益。在相同的输入功率下，天线在空间某点的辐射功率与理想半波偶极子天线最 大辐射方向上功率的比值，该增益的单位为 dBd。 表示同一个增益时，用 dBi 表示出来要比用 dBd 表示出来大 2.15，即 dBi = dBd + 2.15。例如： 对于一增益为 0 dBd 的天线，其增益折算成单位为 dBi 时，则为 2.15 dBi。 ⚫ Directivity：指向性。在相同的辐射功率下，某天线在空间某点产生的功率与理想无方向点源天线 在同一点产生的功率的比值。 ⚫ Efficiency：天线效率。天线辐射功率和天线输入功率的比值。 Gain = Directivity × Efficiency Efficiency = Output Power / Input Power ⚫ APIP (Antenna Port Input Power)：天线端口输入功率即加入到天线口的功率大小，是 PA 输出 到天线口的功率大小。该功率大小主要跟移动设备的传导发射功率大小有关。 ⚫ EIRP (Effective Isotropic Radiated Power)：等效全向辐射功率即无线电发射机供给天线的功率 Pt 与在给定方向上天线绝对增益 Gt 的乘积，反应天线在各个方向上的功率大小。EIRP 表示了发 送功率 Pt 和天线增益 Gt 的联合效果。EIRP 是理论上各向同性的天线（在各个方向均匀分布）的 功率，以产生峰值功率密度，在最大天线增益的方向上观察到。它也被称为等效的各向同性辐射 力。EIRP 可以考虑传输线路和连接器的损耗，包括天线的增益。 EIRP = Pt × Gt - Pt：发射机供给天线的功率，单位 dBm - Gt：表示发射天线的天线增益，单位 dBi 上海移远通信技术股份有限公司 8 / 28 天线设计指导 若用对数（dB）计算，则为：EIRP = P - Loss + G - P：发射机的输出功率，单位为 dBm - Loss：发射机输出端与天线馈源之间的馈线损耗，单位为 dB - G：天线的发送增益，单位为 dBi ⚫ PEIRP (Peak Effective Isotropic Radiated Power)：峰值等效全向辐射功率。 ⚫ ERP (Effective Radiated Power)：有效辐射功率。无线电发射机供给天线的功率和在给定方向 上该天线相对于半波偶极振子的增益的乘积。 ⚫ VSWR (Voltage Standing Wave Ratio)：电压驻波比 VSWR = Vmax 1+ =  Vmin 1−  电压驻波比在工程上常用回波损耗 RL (S11) 表示，其计算公式如下： RL = −20lg V +1 (dB) V -1 RL 与 VSWR 之间的对应关系如下表所示： 表 1：电压驻波比和回波耗损 电压驻波比 (VSWR) 1.20 回波损耗 RL (dB) -20.83 1.25 -19.09 1.30 -17.69 1.35 -16.54 1.40 -15.56 1.50 -13.98 2.00 -9.54 上海移远通信技术股份有限公司 9 / 28 2.2. 天线基本要求 表 2：天线基本要求 项目 频段 驻波比 效率 (%) 增益 (dBi) 最大输入功率 (W) 输入阻抗 (Ω) 极化类型 天线设计指导 要求 根据设备所需要的工作频率而定 ≤ 3 根据 OTA 指标进行换算 无强制要求，如需通过特定运营商认证，可参考该运营商特殊要求 50 50 ⚫ 线极化：垂直、水平 ⚫ 圆极化：左旋、右旋 上海移远通信技术股份有限公司 10 / 28 3 内置 2G/3G/4G/5G 天线 3.1. FPC 天线 天线设计指导 图 2：带焊接馈点的 FPC PIFA 天线 图 3：弹片作为馈点的 FPC 天线 上海移远通信技术股份有限公司 11 / 28 天线设计指导 图 4：顶针作为馈点的 FPC 天线 说明： 1. FPC 天线可以固定在塑料机壳的内侧；为增加牢固性，可以在机壳上增加热熔柱以固定天线。该类型 天线不占用主板面积，因此比较适用于 PAD 及车载等对空间要求较高的应用。根据频段划分，此天线 一般会预留三个馈点：中间馈点为信号点，两边馈点为地馈点。通常会用一个信号点与一个地馈点调 试天线；当高频带宽不够宽时，则需要用另一个地馈点为寄生以用来增加高频带宽。 2. 为保证天线性能，天线体距离主 PCB 板的距离建议大于 5 mm（具体距离还请参考天线供应商的评估 结果）。 3. 对于弧度较为明显的机壳位置，注意 FPC 天线要增加应力孔与应力槽，以避免天线起翘或粘贴不牢。 工作环境温度较高时，FPC 天线的背胶（通常为 3M 胶）粘贴强度会变弱，因此需要增加热熔柱或通 过其它组装方法以限位。 4. 主板通常通过焊接、顶针、弹片三种形式与天线接触，可根据实际情况进行选择。 上海移远通信技术股份有限公司 12 / 28 3.2. 弹片天线 天线设计指导 图 5：弹片天线 说明： 1. 该类型天线一般需要三个馈点：中间馈点为信号点，两边馈点为地馈点。通常会用一个信号点与一个 地馈点调试天线；当高频带宽不够宽时，则需要用另一个地馈点为寄生以用来增加高频带宽（弹片天 线在天线厂评估初期建议射频、结构同时介入，天线支架需要根据天线厂需求制作）。 2. 该类型天线由于材质较硬；走线形式比较单一；天线的走线面积一般较大，因此对天线的环境要求更 高。 3.3. 镭雕天线 图 6：镭雕天线 说明： 1. 通过镭雕与电镀将天线设计在支架上；天线性能稳定，一致性高，精度高。 2. 结构多样性，可以在壳体或支架上任意走线，不占用整机空间。 3. 因天线工艺与支架材质等主要因素，镭雕天线要比普通天线价格贵数倍以上。 4. 因金属附着在塑胶支架上，若塑胶支架若变形，则可能会引起天线断裂。 上海移远通信技术股份有限公司 13 / 28 3.4. 贴片天线 天线设计指导 图 7：贴片天线 说明： 1. 该类天线对净空要求较大，成本较高。 2. 该天线需要严格按照天线供应商规格书的建议，预留天线空间和摆放位置。 3. 该天线可以采用 SMT 的形式进行贴装，天线建议放置到板边位置。 4. 天线的环境与匹配形式对天线的性能影响会很大。 上海移远通信技术股份有限公司 14 / 28 3.5. PCB 走线天线 天线设计指导 图 8：PCB 走线天线 说明： 1. 主板（Layout）初期就要进行天线评估，预留足够的天线空间。 2. 受外界环境影响较大，不同的板材、摆放位置、Layout 对天线均有影响。 3. 目前多用于频段较少的设备，且除天线走线区域以外，主板上接地层的长度不能低于最低频段的 1/4 波长。 上海移远通信技术股份有限公司 15 / 28 3.6. 其他天线 天线设计指导 图 9：其他天线形式 说明： 1. 其他天线通常固定在机壳内侧，或者嵌在合适的槽内，不需要占用主板上的位置。 2. 天线周围不可有金属材质。天线使用面积较大，一般长度在 1/4~1/2 波长之间。 3. 天线通常以 RF 连接器或焊接形式与主板 RF 输出端相连。 4. 部分天线需要借助整机和主板的 GND 进行调试。 上海移远通信技术股份有限公司 16 / 28 4 外置 2G/3G/4G/5G 天线 4.1. 偶极天线 天线设计指导 图 10：偶极天线形式 说明： 1. 天线辐射体距离反射板最小距离大于 8 cm，频段较为单一。 2. 天线连接线的长度直接影响到天线的性能，建议外接距离较长时选择低损线材。 上海移远通信技术股份有限公司 17 / 28 4.2. 吸盘天线 天线设计指导 图 11：吸盘天线 说明： 1. 频段较少，方便移动。需要根据不同的工作环境挑选不同的天线。 2. 摆放在不同材质上时，天线的性能表现不同。一般直接摆放在金属物上，性能最优。 3. 天线连接线的长度直接影响到天线的性能，建议外接距离较长时选择低损线材。 上海移远通信技术股份有限公司 18 / 28 4.3. 组合天线 天线设计指导 图 12：多合一天线 说明： 1. 此天线类型较多，频段覆盖较广，更换方便。 2. 天线内部可能包含 PCB、FPC、弹片天线等形式。 3. 可以根据需求任意对天线端口分频，天线需求频率越低，天线个数越多，需求的尺寸越大。 4. 如果安装在金属面上，天线需要特殊选型。 5. 天线连接线的长度直接影响到天线的性能，建议外接距离较长时选择低损线材。 上海移远通信技术股份有限公司 19 / 28 4.4. 套筒天线 天线设计指导 图 13：套筒天线 说明： 1. 此天线类型较多，频段覆盖较广，更换方便。 2. 天线内部有可能是 PCB/铜管/FPC 等形式。 3. 需要根据不同的工作环境挑选不同的天线。 4. 增加专用底座后可以转变为吸盘天线。 上海移远通信技术股份有限公司 20 / 28 5 内置 GNSS 天线 5.1. GNSS 有源天线 天线设计指导 图 14：带焊针的 GNSS 有源天线 说明： 1. 有源天线自身带有 LNA 来提高信号强度，实际使用中需要保证天线的辐射面朝向天空。 2. 天线周围的金属器件都要低于天线辐射体。 3. 正方形为右旋圆极化，长方形为线极化。如果结构允许，请尽量使用正方形结构，以便更好接收卫星信 号。 4. 天线连接线请尽量短，最好选用低损耗线。 5. 请注意，主板上需要预留给 LNA 的供电，并且需要为板端阻抗线预留隔直电容，供电与阻抗线之间需 串联 56 nH 以上电感。 上海移远通信技术股份有限公司 21 / 28 5.2. GNSS 无源天线 天线设计指导 图 15：带焊针的 GNSS 无源天线 图 16：GNSS 无源天线实际应用 说明： 1. 无源天线可以在主板上增加 LNA 来提高信号强度，在实际应用中天线的辐射面应朝向天空以保证较佳 接收性能。 2. 天线周围的金属器件都要低于天线辐射体。 3. 正方形为右旋圆极化，长方形为线极化。如果结构允许，请尽量使用正方形结构，以便更好接收卫星信 号。 上海移远通信技术股份有限公司 22 / 28 6 外置 GNSS 天线 天线设计指导 图 17：外置 GNSS 天线 说明： 1. 保证在实际应用时，天线辐射体应面向天空。 2. 天线尽量放置在远离高金属器件区域、避免遮挡。 3. 根据实际需要选择天线连接线长度，建议尽量短。 4. 需要根据不同的模块来匹配天线内置 LNA 的增益大小。 5. 请注意，主板需要预留给 LNA 的供电，并且板端阻抗线需要预留隔直电容，供电与阻抗线之间需串联 56 nH 以上电感。 上海移远通信技术股份有限公司 23 / 28 7 内置 Wi-Fi 叠层天线 天线设计指导 图 18：内置 Wi-Fi 叠层天线形式 说明： 1. 该类天线常用于无人机项目。此类定向性天线可以更大性能得将信号向需要的方向辐射出去，所用频 段为 2.4 GHz 和 5 GHz，天线要尽量离主板距离 20 mm。 2. 天线尽量放置在远离高金属器件区域、避免遮挡。 3. 上层绿色 PCB 板载的贴片天线为 5 GHz 频段，下方的白色陶瓷天线为 2.4 GHz 频段，两个天线的极 化方式需要与发射天线的极化方式设计保持一致。 4. 根据实际需要选择天线连接线长度，建议尽量短且采用低损耗线。 上海移远通信技术股份有限公司 24 / 28 天线设计指导 8 天线隔离度设计需求 8.1. 天线隔离度 天线隔离度是指一个天线发射信号通过另一个天线接收的信号与该发射天线信号的比值。天线隔离度 取决于天线辐射方向图、天线的空间距离等。天线隔离度是为了尽量减少各种干扰对接收机的影响所采取 的抑制干扰措施。 通常可通过如下方式增加天线隔离度： ⚫ 增加天线之间的空间距离 ⚫ 近似频段天线间正交摆放 ⚫ 寻找天线高增益方向，避免各天线高增益方向交叉 ⚫ 改变天线的走线形式 此外，可以使用滤波器，滤除某天线端口需求以外的频段，减少天线隔离度不足造成的干扰。 8.2. 3G/4G/5G 天线与 GNSS 天线隔离度设计需求 3G/4G/5G 天线与 GNSS 天线隔离度设计需求如下： ⚫ GNSS 有源天线与 3G/4G/5G 天线之间的隔离度至少需满足 10 dB。 ⚫ GNSS 无源天线与 3G/4G/5G 天线之间的隔离度至少需满足 15 dB。 通常建议在 GNSS 天线和模块之间增加一个滤波器来抑制其他天线的干扰。 上海移远通信技术股份有限公司 25 / 28 天线设计指导 8.3. 其他天线隔离度设计需求 ⚫ 其他各天线之间隔离度至少需满足 15 dB。 ⚫ 多系统同时工作时天线隔离度需参考模块硬件操作手册内的建议值。 ⚫ 频率相近情况下两天线之间才会产生较强的隔离度影响。所以两天线在一起使用时，并不一定是 天线支持的频段越多越好。 例如：整机支持 GSM B1/B3/B5/B8 + LTE B1/B3/B7，则主天线需要支持所有频段，分集天线只 需支持 LTE 频段即可；这样可以有效的避免低频部分的隔离度影响。 上海移远通信技术股份有限公司 26 / 28 9 天线设计服务 移远通信天线设计服务团队，可满足客户的任意如下需求： ⚫ 天线设计咨询/评估 ⚫ 天线设计、测试 ⚫ 认证调试支持 ⚫ 天线生产方案 如有任何天线设计需求，请联系当地移远通信销售或 FAE。 天线设计指导 上海移远通信技术股份有限公司 27 / 28 天线设计指导 10 附录 A 术语缩写 表 3：术语缩写 缩写 APIP CPU DC EIRP ERP FAE FPC GND GNSS LDS LHCP LNA PCB PDA PEIRP RF RHCP SDRAM SMD VSWR 英文全称 中文全称 Antenna Port Input Power 天线端口输入功率 Central Processing Unit 中央处理器 Direct Current 直流 Effective Isotropic Radiated Power 等效全向辐射功率 Effective Radiated Power 有效辐射功率 Field Application Engineer 现场应用工程师 Flexible Printed Circuit 柔性电路板 Ground 地 Global Navigation Satellite System 全球导航卫星系统 Laser Direct Structuring 激光直接成型 Left-Hand Circular Polarization 左旋圆极化 Low-Noise Amplifier 低噪声放大器 Printed Circuit Board 印刷电路板 Personal Digital Assistant 个人数字助理 Peak Effective Isotropic Radiated Power 峰值等效全向辐射功率 Radio Frequency 射频 Right-Hand Circular Polarization 右旋圆极化 Synchronous DRAM (Dynamic Radom 同步动态随机存取内存 Access Memory) Surface-Mount Device 表面贴装器件 Voltage Standing Wave Ratio 电压驻波比 上海移远通信技术股份有限公司 28 / 28

模块 SMT 应用指导 移远通信模块系列 版本：3.7 日期：2024-05-07 状态：受控文件 模块 SMT 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 25 模块 SMT 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2024，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2024. 上海移远通信技术股份有限公司 2 / 25 模块 SMT 应用指导 文档历史 修订记录 版本 1.0 1.1 2.0 2.1 2.2 2.3 2.4 2.5 2.6 2.7 日期 2011-01-18 2011-12-16 2013-06-09 2013-12-19 2015-12-15 2017-03-08 2018-06-02 2019-03-11 2019-07-15 2020-02-25 作者 变更表述 Gavin HOU Gavin HOU Gavin HOU 初始版本 1. 修改 3.1 章节防潮要求的相关描述。 2. 修改 3.2 章节印膏的相关描述，增加钢 网 增 厚 、 扩 孔 示 意 图。 修改 4.2 章节，增加钢网开孔描述。 Gavin HOU 修改图 4：钢网开孔。 Meisy MEI Alain HUANG Rowan WANG/ Alain HUANG Alain HUANG Alain HUANG Alain HUANG 修改 4.2 章节，增加 UC，EC，GC 系列钢网开孔描述。 1. 修改 4.2 章节，增加如下模块的钢网制作要求：M26/ MC20/ L70-R/ L70-RL/ L76-L/ L76B/ L80-R/ L86/ L96/ EC20 R2.0/ EC21/ EC25/ EG91/ EG95/ BG36/ FC10/ FC20/ SC10/ SC20/ SG30/ AG35。 2. 第 5 和 6 章节增加拆焊和维修加热说明。 1. 更新移远通信 SMD 模块的湿敏等级（MSL）为 3。 2. 新增并优化部分模块的钢网制作要求（表 1）。 3. 优化模块生产工艺指导要求、并补充完善炉温曲线的描述。 1. 更新 2.2 章节，删除托盘包装及其图片（图 2）。 2. 更新 3.2 章节焊接要求。 3. 更新 4.2 章节钢网制作要求。 4. 更新 4.4 章节回流焊区最高温度范围（表 2）。 更新 4.2 章节钢网制作要求：更新 SC60/ SC600T/ SC600Y 钢 网制作要求参数；更新 SC66 封装图；增加 RG500Q/ AG520R 钢网设计要求。 1. 更新了 3.2 章节焊接要求的描述。 2. 新增了关于存储和车间寿命的 4.2 章节和 4.3 章节。 3. 更新 4.4 章节钢网制作要求，并新增了如下模块的钢网制作 要 求 ： M08-R/ BC030S-CN/ BC030N-B5/ BC32/ L89/ UC200T/ EC200T/ BG95/ EG18/ EC100Y/ BG600L-M3 上海移远通信技术股份有限公司 3 / 25 模块 SMT 应用指导 4. 更新了 4.6 章节回流焊的参数内容，增加了注意事项。 5. 对第 5 章节进行了更新。 1. 更新 4.3 章节车间寿命描述及备注。 2. 更新 4.4 章节钢网制作要求。并新增了如下模块的钢网制作 2.8 2020-07-07 Alain HUANG 要 求 ： SC200L/ SC200R/ AF50T/ BG77/ AG550Q/ RG801H。 3. 更新 4.6 章节回流焊冷却降温斜率和过炉载具说明。 1. 增加图 1 真空和卷带包装说明文字。 2. 更新第 4.3 章节备注信息。 3. 更新第 4.4 章节钢网制作要求。新增如下模块的钢网制作要 求： M56-R/ EC200U-CN/ EC600U-CN/ EC600S-CN/ BG96/ 2.9 2021-04-26 Alain HUANG EG500U-CN/ EG700U-CN/ SC200K-CE/ SC200Y/ SC665S/ BG770A-GL/ BC28-CNV/ BC95-CNV/ EG512R-EA/ AG509M-EU 删除 RG801H。 4. 更新 4.6 章节回流焊回流时间和最高温度。 5. 新增第 6 章节 ESD 防护相关说明。 1. 更新真空卷带包装图（图 1）。 2. 更新第 4.3 章节车间寿命及温湿度管控相关备注。 3. 更新第 4.4 章节钢网制作要求信息： 新 增 ： LC98S/ LG69T/ EC200A/ EC200S/ EC200N/ BG950A-GL/ BG951A-GL/ BC260Y-CN/ BC28-F/ BC95-GF/ EG915U/ EG21-G/ EC100N-CN/ EG065K/ 3.0 2021-09-27 Alain HUANG EG060V-EA/ RG200U-CN/ SC200E/ SC310K/ SG150H/ EG912Y/ AG600K-CN/ AG215S-CN/ AF51Y/ SG500Q-CN/ RG500L/ RG500U-CN/ SC668S/ SG865W-WF； 删除 EC20 R2.0/ EC20 R2.1/ FC10； 更新 EC200U-CN/ EC600U-CN 为 EC200U/ EC600U。 4. 更新第 5 章节返修拆焊及焊接内容。 5. 新增第 7 章节工艺制程注意事项。 1. 更新第 4.4 章节钢网制作要求信息： 新 增 ： AH20C/ AG521R/ AG529R-CN/ EC800N-CN/ 3.1 2022-01-25 Alain HUANG AG800D-CN/ AG568N/ AG569N-CN/ RG520N/ RG520F/ RG530F。 2. 更新第 4.6 章最大升温斜率和回流焊冷却注意事项说明。 更新第 4.4 章节钢网制作要求信息： 3.2 2022-01-29 Alain HUANG 删除 BC030S-CN/ BC030N-B5/ GC65/ L20/ L30/ L50/ M50/ UC15/ UC20/ UG35。 1. 更新第 3.2 章节焊接要求信息。 2. 更新第 4.4 章节钢网制作要求信息： 3.3 2022-09-30 Alain HUANG 新 增 AF66T/ AG551Q/ AG571Q/ AG660K/ BG772A/ BG773A/ BG952A/ BG953A/ BG955A/ EG060K/ UC200A/ 上海移远通信技术股份有限公司 4 / 25 模块 SMT 应用指导 EC600E/ EC800E/ EC200M/ EC200G/ EC600G/ EC800G/ EG912U/ EC200D/ EG700G/ RG501Q/ RG502Q/ RG525F/ EC600M/ EG915N/ EG800Q/ EG915Q/ EC800M； 删除 M12-D/ BC95 R2.0/ BC35-G/ BC28/ BC20/ BC26/ M89/ EC200T/ UC200T/ UG96； 省略含有 3 位数字的模块名称的型号后缀。 3. 更新第 4.6 章最大升温斜率和冷却降温斜率要求。 4. 新增第 4.6.1 章智能模块系列回流焊炉温曲线及要求。 1. 更新第 3.1 章节贴片机设备要求说明。 2. 新增第 4.3 章节中 AG855G 模块车间寿命备注。 3. 更新第 4.4 章节钢网制作要求信息： 新 增 LC76G/ BC660K/ EC600K/ EG800G/ EG810M/ EG950A/ EC100M/ SC663J/ AG18/ AF55C/ AF56C/ 3.4 2023-04-27 Alain HUANG AF31G/ AF67E/ AF68E/ AF61Y/ AF20/ SG560D/ RG620T/ SG530C/ SG368Z/ RG650E/ RG650V/ SG520B/ AG590E/ AG16-CN/ AG855G； 删除 BC28-CNV/ BC95-CNV。 4. 更新第 4.6.2 章节中非智能模块炉温曲线备注。 5. 新增第 5.1 章节中针对返修 RMA 模块的维修加热注意事项。 3.5 2023-09-19 Alain HUANG 更新第 4.6.2 章节中大尺寸封装模块的冷却降温斜率备注。 1. 新增第 3.2 章节中避免使用含汞（Hg）材料的说明。 3.6 2024-01-29 Alain HUANG 2. 删 除 第 4.4 章 节 中 模 块 的 具 体 钢 网 设 计 要 求 ， 请 在 Quectel_Module_Stencil_Design_Requirements 中查询。 1. 新增第 3.2 章节中腐蚀性气体相关注意事项。 3.7 2024-05-07 Alain HUANG 2. 更新第 4.6.1 章节模块炉温曲线要求。 上海移远通信技术股份有限公司 5 / 25 模块 SMT 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 6 表格索引 ........................................................................................................................................................ 7 图片索引 ........................................................................................................................................................ 8 1 引言 ........................................................................................................................................................ 9 2 模块相关信息........................................................................................................................................ 10 2.1. 封装类型 .................................................................................................................................... 10 2.2. 包装类型 .................................................................................................................................... 10 3 贴片设备要求........................................................................................................................................ 11 3.1. 贴片机........................................................................................................................................ 11 3.2. 焊接要求 .................................................................................................................................... 11 4 生产注意事项........................................................................................................................................ 13 4.1. 湿敏等级及防潮要求.................................................................................................................. 13 4.2. 存储 ........................................................................................................................................... 13 4.3. 车间寿命及温湿度管控 .............................................................................................................. 14 4.4. 钢网制作要求............................................................................................................................. 14 4.5. 贴装流程 .................................................................................................................................... 15 4.5.1. 上料注意事项.................................................................................................................... 15 4.5.2. 自动贴装 ........................................................................................................................... 15 4.6. 回流焊........................................................................................................................................ 16 4.6.1. 炉温曲线 ........................................................................................................................... 16 4.6.2. 注意事项 ........................................................................................................................... 17 5 返修拆焊及焊接 .................................................................................................................................... 19 5.1. 维修加热注意事项 ..................................................................................................................... 19 5.2. 拆焊 ........................................................................................................................................... 19 5.3. 推荐的模块重新焊接步骤 .......................................................................................................... 21 6 ESD 防护.............................................................................................................................................. 23 7 工艺制程注意事项 ................................................................................................................................ 24 8 附录 术语缩写...................................................................................................................................... 25 上海移远通信技术股份有限公司 6 / 25 模块 SMT 应用指导 表格索引 表 1：推荐的炉温控制要求......................................................................................................................... 17 表 2：术语缩写 ........................................................................................................................................... 25 上海移远通信技术股份有限公司 7 / 25 模块 SMT 应用指导 图片索引 图 1：真空卷带包装.................................................................................................................................... 10 图 2：通孔和半通孔设计示意图 ................................................................................................................. 12 图 3：湿度指示卡 ....................................................................................................................................... 13 图 4：钢网局部加厚区域 ............................................................................................................................ 14 图 5：SMT 贴片图 ...................................................................................................................................... 15 图 6：模块第一引脚示意图......................................................................................................................... 16 图 7：推荐的炉温曲线图 ............................................................................................................................ 16 图 8：5G 模块过炉载具.............................................................................................................................. 18 图 9：拆焊工具 ........................................................................................................................................... 20 图 10：加热平台 ......................................................................................................................................... 20 图 11：模块 LCC 封装引脚焊接状况检查................................................................................................... 21 图 12：模块底部引脚及 BGA 元件焊接状况检查 ....................................................................................... 22 图 13：ESD 或 EOS 烧伤........................................................................................................................... 23 上海移远通信技术股份有限公司 8 / 25 模块 SMT 应用指导 1 引言 本文档描述了移远通信模块进行 SMT 贴片的流程及焊接过程，适用于移远通信各封装类型的模块。 备注 由于产品版本升级或其他原因，本文档内容会不定期更新。除非另有约定，本文档仅作为使用指导建议， 各个产品的设计和结构、生产现场的环境和工具等因素的不同，均会影响到实际的工艺结果。本文档中 的所有陈述、信息和建议都不会构成任何明示或暗示的担保。 上海移远通信技术股份有限公司 9 / 25 2 模块相关信息 2.1. 封装类型 模块的封装类型为 LCC、LGA 和 BGA 三种。 2.2. 包装类型 移远通信模块的包装方式为真空卷带包装，如下图所示。 模块 SMT 应用指导 真空包装 图 1：真空卷带包装 真空包装内的卷带 上海移远通信技术股份有限公司 10 / 25 模块 SMT 应用指导 3 贴片设备要求 3.1. 贴片机 为了确保移远通信模块成功完成 SMT 工艺，请使用具有以下功能的贴片机： ⚫ 送料器： 支持卷带、Tray 托盘。 ⚫ 影像处理： 光学对中，方向识别。 ⚫ 吸嘴直径： 根据模块本体大小选取，保证模块贴装时的稳定性。 备注 1. 推荐吸嘴直径：吸嘴直径应不小于短边长度的 40 %，例如：若模块尺寸为 25.0 mm ×20.0 mm，则 建议选取直径 8 mm 以上的吸嘴（可根据不同设备的吸嘴配置选取合适的吸嘴）。 2. 推荐吸嘴材质：橡胶和陶瓷。 3.2. 焊接要求 1. 模块焊接回流，建议使用八温区及以上的回流焊接设备；对于移远通信 LTE Standard/ LTE-A/ LPWA/ Automotive/ 智能模块系列的模块产品，需使用十温区及以上的回流焊接设备。 2. 无铅工艺回流焊炉温要求，模块器件底部焊盘测温点的实测峰值温度需达到 238 °C。带回流工装夹具 时，需评估过炉载具的材料、吸热量和大小尺寸，以选择合适的峰值温度和回流时间参数，以防止模 块冷焊。 3. 若 PCB 板厚度小于 1.0 mm，则建议制作回流工装载具，以防止 PCB 板在高温下变形，影响焊接的共 面性。 4. 底板焊盘表面的处理类型，建议选择等同模块焊盘镀金类型的设计，使用电镀镍/金、化学镀镍/金工艺。 不建议使用喷锡板（HASL）表面处理方式。 5. 模块焊盘封装设计请参考移远通信模块的硬件设计手册文档。对 SMT 的可制造性设计（DFM），为避 上海移远通信技术股份有限公司 11 / 25 模块 SMT 应用指导 免二次回流会造成模块底部引脚连锡短路问题，请注意如下建议： 1) 客户 PCB 主板对移远通信模块功能引脚的阻焊设计，建议做非阻焊定义焊盘设计（NSMD），加强 阻焊、有效地防止溢锡； 2) 客户 PCB 主板上模块中心区域内的焊盘上，不建议有机械孔（通孔和半通孔）的设计，易产生气 泡，如下图所示。 图 2：通孔和半通孔设计示意图 3) 关于板材的 Tg 值，建议客户 PCB 主板选用高 Tg 值板材（170 °C 以上），避免主板因在高温回流 时形变，从而产生翘曲、挤压、空焊和连锡不良。 6. 请勿使用含汞（Hg）的材料，例如胶水，对模块进行处理。即使是符合 RoHS 标准，即汞含量低于 1000 ppm（0.1 %）的材料也不可使用。 7. 腐蚀性气体可能会对模块内的电子元器件产生腐蚀，进而影响其可靠性和性能，甚至导致模块的实际 使用寿命无法达到原设计寿命。切勿在有腐蚀性气体（如氢化硫、二氧化硫、氯气和氨气等）的环境 中存放或使用未加保护的模块。 上海移远通信技术股份有限公司 12 / 25 模块 SMT 应用指导 4 生产注意事项 4.1. 湿敏等级及防潮要求 移远通信 SMD 模块为湿敏产品，参考 IPC-JEDEC 标准，移远通信的 SMD 模块 MSL（Moisture Sensitivity Level，湿敏等级）定义为 3。在使用模块之前需确认包装是否完好；打开包装后，需确认真空 包装袋内湿度指示卡状态。如出现以下情况，需要在使用前对模块进行烘烤。 ⚫ 湿度指示卡：5 %指示圈为粉色且 10 %指示圈不再是蓝色，如下图所示。 正常湿度卡 图 3：湿度指示卡 变粉色 4.2. 存储 推荐存储条件：温度 23 °C ±5 °C，且相对湿度为 35 % ~ 60 %。 存储期限（密封真空包装条件下）：在推荐存储条件下，保存期为 12 个月。 上海移远通信技术股份有限公司 13 / 25 模块 SMT 应用指导 4.3. 车间寿命及温湿度管控 湿敏等级为 3 的产品的车间寿命为 168 小时 1)。在车间温度 23 °C ±5 °C，相对湿度低于 60 %的环境 下，模块拆封后需要在 168 小时内进行回流生产或其它高温操作，否则，需要将模块存储在相对湿度小于 10 %的环境中（例如，防潮柜），以保持产品的干燥性。 备注 1. 移远通信 AG855G 模块湿敏等级为 5a 级，车间寿命为 24 小时，请在拆封后 24 小时内完成贴片回 流。 2. 1) 仅在相对湿度较低的车间环境符合《IPC/JEDEC J-STD-033》规范时适用；不确定车间温湿度环 境是否满足条件，或相对湿度大于 60 %的情况下，请在拆封后 24 小时内完成贴片回流。请勿提前 大量拆包。 3. 为预防和减少模块因受潮导致的起泡、分层等焊接不良的发生，应严格进行管控，不建议拆开真空包 装后长时间暴露在空气中。 4. 如出现密封真空包装漏气、被拆开后未遵守湿敏管制要求、物料散装或超过 1 年有效期的情况，在模 块上线贴片或返修前，均需进行预烘烤处理，需在 120 °C ±5 ºC 条件下高温烘烤 24 小时，以防止吸 湿受潮导致的高温焊接后出现起泡、裂痕和分层。 5. 烘烤前，需将模块从包装取出，将裸模块放置在耐高温器具上（禁止将塑料托盘或包装卷盘直接进行 烘烤）；二次烘烤的模块须在烘烤后 24 小时内完成焊接，否则需在干燥箱内保存。拆放模块时请注 意 ESD 防护，佩戴防静电手套。 6. 烘烤完成后，裸模块上线贴片时，贴片机需要带托盘，方法如下： 方法 1： 使用专用的、匹配尺寸的托盘，放置模块后，方可上线贴片； 方法 2： 无专用的托盘时，可以使用包装模块的黑色静电载带，裁剪多条长度一致的载带，纵横整 齐地拼贴在贴片机的托盘上做为简易的托盘。 4.4. 钢网制作要求 为保证模块焊接时有足够的焊锡以及焊接的可靠性，钢网需要在模块位置局部增厚（Step-up），且采 用正面（印刷面）增厚的方式。模块单个引脚所对应的钢网开孔尺寸不能大于 3.0 mm × 4.0 mm，超过的 应用 0.30~0.50 mm 的架桥分割，分割后的钢网开孔尺寸应不超过 2.0 mm × 2.0 mm。模块引脚附近的半 圆弧形引脚，无需进行钢网开孔设计。 模块局部 加厚钢网 钢 网 正 面 加 厚 上海移远通信技术股份有限公司 图 4：钢网局部加厚区域 14 / 25 模块 SMT 应用指导 请参考 Quectel_Module_Stencil_Design_Requirements 查询模块的具体钢网设计要求。 备注 1. 建议在设计 PCB 时，模块贴装位置的背面不要布置元器件，便于背面加热维修操作。 2. 模块底部区域请不要设置任何油墨丝印，避免存在高度，产生间隙影响焊接效果。 3. 以上钢网制作建议仅供参考，客户可以根据实际情况进行优化。 4. 内切与外延是指相对于客户的 PCB 封装。对于详细的推荐封装，请参考相应的硬件设计手册。 4.5. 贴装流程 4.5.1. 上料注意事项 为保证贴片精度，针对拆包装高温烘烤的单一模块产品，建议客户制作专用托盘，使用托盘进行贴片。 卷盘包装上料时根据实物在设备或送料器上设置进料的间距。 4.5.2. 自动贴装 选取合适的吸嘴，生产中须尽力保证吸嘴吸取在模块的重心位置，贴装速度为中速，图像识别检测通 过率为 100 %，以防在移动时不稳定。模块贴在 PCB 上以后，模块各引脚与锡膏中心对应对齐。模块上三 角标识的为第一脚，与 PCB 上标识点对应。（客户可根据模块底部引脚的差异做防呆识别。） 图 5：SMT 贴片图 上海移远通信技术股份有限公司 15 / 25 模块 SMT 应用指导 图 6：模块第一引脚示意图 4.6. 回流焊 建议基于实板测试设定炉温曲线，炉温板需在模块底部中心焊盘和引脚位置接上热偶探温测试点，以 保证模块引脚达到需要的焊接温度。推荐的炉温曲线图（无铅 SMT 回流焊）如以下章节所示。 4.6.1. 炉温曲线 Temp. (°C) 246 235 217 200 Soak Zone 150 A Reflow Zone 升温斜率： 0~3 °C/s C 降温斜率： -3~0 °C/s B D 100 升温斜率： 0~3 °C/s 图 7：推荐的炉温曲线图 上海移远通信技术股份有限公司 16 / 25 模块 SMT 应用指导 表 1：推荐的炉温控制要求 项目 建议值 吸热区（Soak Zone） 升温斜率 0~3 °C/s 恒温时间（A 和 B 之间的时间：150~200 °C 期间） 70~120 s 回流焊区（Reflow Zone） 升温斜率 0~3 °C/s 回流时间（D：超过 217 °C 的期间） 40~70 s 最高温度 235~246 °C 冷却降温斜率 -3~0 °C/s（详见下方备注） 回流次数 最大回流次数 1 备注 针对最小边长 ≥ 30 mm 的大尺寸两件式屏蔽罩模块，请将冷却降温斜率控制为 -1~0 °C/s，以防止因快 速降温对金属屏蔽罩产生的热应力，从而避免屏蔽盖被拉起。针对大尺寸封装模块，为避免温度变化幅 度过大，引起金属屏蔽框和屏蔽罩热形变过大，建议降低锡膏液相阶段的升温和降温斜率。若有条件， 生产时请选择 10 温区以上的回流炉，从而有更多的温区进行设置，以符合最优的曲线。 4.6.2. 注意事项 1. 炉温： 实际焊接温度受其他外部因素影响，例如，是否有过炉载具、焊膏、基板的大小和厚度、元件的耐 热要求和板面设计等。请在无法达到我司推荐参数的情况下，及时与我司工程技术人员进行确认， 否则可能因为此原因导致模块受损。 2. Tg 值和过炉载具： 对于小于 1.0 mm 厚度的主板，推荐使用过炉载具支撑或高 Tg 的板材，防止受热时翘曲导致 PCB 变形，从而影响模块焊接。 对于 40.0 mm × 40.0 mm 或更大尺寸的模块和 5G 产品类模块，建议使用过炉载具过炉，减小因 底板和模块的 Tg 值失配差异，高温焊接回流过程出现热应力不均衡的现象，引起空焊、连锡的不 上海移远通信技术股份有限公司 17 / 25 良率。 模块 SMT 应用指导 图 8：5G 模块过炉载具 3. 冷却： 受控的冷却斜率能防止负面的焊接影响（焊点变得更加易脆）和产品内部的机械应力，控制冷却能 帮助达到光亮的焊接表面效果，细结晶颗粒和低接触角，避免快速降温变化造成屏蔽罩翘曲。 4. 外观检查： 模块焊接后，使用 X-ray 和光学放大镜检验方法，检验焊接质量，具体请参照 IPC-A-610F 相关标 准执行。区分为 3 个级别（class），客户可以依据产品的应用环境和场景选择相应的焊接等级，车 规类应用场景，建议使用 3 级标准。 备注 1. 针对移远通信采用纸质标签的模块： 在生产焊接或者其他可能直接接触移远通信模块的过程中，不得使用任何有机溶剂（如酒精，异丙醇， 丙酮，三氯乙烯等）擦拭模块标签；否则可能会造成标签字迹模糊。 2. 针对移远通信采用洋白铜材质镭雕屏蔽罩的模块： ⚫ 在生产焊接或者其他可能直接接触移远通信模块的过程中，不得使用任何有机溶剂（如酒精，异 丙醇，丙酮，三氯乙烯等）擦拭模块屏蔽罩；否则可能会造成屏蔽罩生锈。 ⚫ 移远通信洋白铜镭雕屏蔽罩可满足：12 小时中性盐雾测试后，镭雕信息清晰可辨识，二维码可 扫描（可能会有白色锈蚀）。 上海移远通信技术股份有限公司 18 / 25 模块 SMT 应用指导 5 返修拆焊及焊接 5.1. 维修加热注意事项 若需要将模块进行加热拆焊，返修前务必确认如下几点： 1. 通过 X-ray 检查 BGA 的焊接状况，避免因拆焊后的二次加热温度或方法不当引起的芯片连锡，移 位等二次不良。建议和厂商工程技术人员沟通后再进行。 2. 主板需做 120 °C、12~24 小时的烘烤处理（须注意确认主板上的其他元件是否都可以接受 120 °C 烘烤），避免 PCB 受潮后，加热导致 PCB 损坏报废。 3. 请勿对模块本体内部元件进行拆卸，否则保修期将立刻终止。 4. 对于返修 RMA 模块，真空密封包装拆封后 24 小时内必须完成回流焊接。如果 RMA 模块无密封真 空包装，或密封真空包装拆封后超过 24 小时，需对裸模块做 120 °C、48 小时的烘烤处理，并在 处理后 24 小时内完成回流焊接。 5.2. 拆焊 如果需要将模块从主板上取下，请按照如下所述的拆焊过程进行操作。拆焊过程中必须采取适当的 ESD 保护措施。 ⚫ 需使用热风枪（大出风口）和上下加热方式对模块进行加热，热风枪温度设定在 320 ºC ~ 365 ºC 左右，风速和距离根据实际情况调节。 ⚫ 主板在空气中放置超过 48 小时，需要烘烤后再进行维修。 ⚫ 加热时，需平放、固定主板。主板与热风枪的距离保持在 2.0~3.5 cm 之间，依据经验调整。 ⚫ 热风口沿着模块的边缘匀速转动，等锡膏融化后迅速用镊子对角轻取下模块，迅速放在平整的散 热平台冷却。 大于 30.0 mm × 30.0 mm 尺寸的模块拆取可以使用专用 BGA 返修台或者热风枪（大出风口）进行元 件拆焊；在使用热风枪拆卸元件时，须使用底部加热器预热和加热，防止因大型模块单面加热时间长导致 焊盘、线路分层和 PCB 起泡报废。维修好后建议使用 X-ray 检查模块焊接效果，避免因为维修而导致的 BGA 连锡和空焊等不良。 上海移远通信技术股份有限公司 19 / 25 模块 SMT 应用指导 图 9：拆焊工具 对于底部没有元件的单面板主板，也可以使用加热平台，配合热风枪（大出风口）进行返修。上下加 热可以使模块迅速和均匀得受热，锡膏熔融时间短，避免模块或主板 PCB 线路分层、起泡等造成的永久报 废。 加热平台如下图所示。温度设定参考为：265 °C ~ 280 °C（此参考仅依据工厂经验，需根据模块实际 情况调整）。 图 10：加热平台 上海移远通信技术股份有限公司 20 / 25 模块 SMT 应用指导 5.3. 推荐的模块重新焊接步骤 1. 使用电烙铁将主板 PCB 焊盘将多余的锡吸掉，保持焊盘表面平整。 2. 使用电烙铁将模块引脚焊盘预上锡，使锡量适中、分布均匀。 3. 焊盘均匀涂覆助焊膏，量不可太多。 4. 将模块精确对位地安置在主板 PCB 上（注意模块的方向性），通过热风从主板 PCB 底部和模块 位置上下加热，加热需均匀，面积足够覆盖模块区域。待模块底部所有锡膏升温熔化，即完成焊 接。工具使用热风枪（大出风口）组合台或者 BGA 返修台，选择合适的风嘴。 5. 焊接完成后，需要使用风扇快速冷却模块。 6. 温度降到常温后，如果是 LCC 封装模块，需检查四周的焊接效果，是否有连锡短路、少锡等不良 现象。 图 11：模块 LCC 封装引脚焊接状况检查 上海移远通信技术股份有限公司 21 / 25 模块 SMT 应用指导 7. 最后使用 X-ray 检查模块底部引脚焊盘和内部的 BGA 芯片等元件的焊接品质。 图 12：模块底部引脚及 BGA 元件焊接状况检查 上海移远通信技术股份有限公司 22 / 25 模块 SMT 应用指导 6 ESD 防护 静电会导致间歇或永久性的电路损伤，对电子产品危害很大，经分析多数是 ESD 或 EOS 损坏，开盖 分析时均能观察到明显的 ESD 或 EOS 烧伤痕迹，如下图所示： 图 13：ESD 或 EOS 烧伤 因此，模块的静电防护尤为重要，生产和运输过程需要严格按照静电防护进行作业，须遵循以下条件： ⚫ 严禁裸手接触模块，尤其是引脚位置。 ⚫ SMT 贴片机、作业工作台、电烙铁等设备需接地。 ⚫ 作业人员佩戴具有良好接地线的人体防静电手环（不可使用无绳静电手环，建议戴防静电手套）。 ⚫ 包装和 PCB 必须是合格的防静电材料。 上海移远通信技术股份有限公司 23 / 25 模块 SMT 应用指导 7 工艺制程注意事项 请勿对移远通信模块进行超声波清洗，否则可能会造成模块内部晶体损坏。 因 SMT 流程的复杂性，如有其他特殊工艺或不确定的情况，请于 SMT 流程开始前与移远通信技术支 持确认。 上海移远通信技术股份有限公司 24 / 25 模块 SMT 应用指导 8 附录 术语缩写 表 2：术语缩写 缩写 BGA DFM EOS ESD LCC LGA MSL NSMD PCB RMA SMD SMT Tg 英文全称 Ball Grid Array Design for Manufacturability Electrical OverStress Electro-Static Discharge Leadless Chip Carriers Land Grid Array Moisture Sensitivity Level Non-Solder Mask Defined Printed Circuit Board Return Material Authorization Surface Mount Device Surface Mount Technology Glass Transition Temperature 中文全称 球状栅格阵列 可制造性设计 电气过载 静电释放 无针脚芯片封装 栅格阵列封装 湿敏等级 非阻焊层限定 印刷电路板 退料审查 表面贴装器件 表面贴装技术 玻璃化温度 上海移远通信技术股份有限公司 25 / 25

EC2x&EG9x&EG2x-G Series LwM2M Application Note LTE Standard Module Series Version: 1.0 Date: 2020-10-12 Status: Released www.quectel.com LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 1 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note Copyright The information contained here is proprietary technical information of Quectel Wireless Solutions Co., Ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved. EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 2 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note About the Document Revision History Version Date - 2020-09-02 1.0 2020-10-12 Author Description Herry GENG Creation of the document Herry GENG First official release EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 3 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 2 Description of LwM2M AT Commands ............................................................................................. 7 2.1. AT Command Syntax ................................................................................................................. 7 2.1.1. Definitions........................................................................................................................ 7 2.1.2. AT Command Syntax ...................................................................................................... 7 2.2. Description of AT Commands .................................................................................................... 8 2.2.1. AT+QLWCFG Configure Optional Parameters of LwM2M........................................... 8 2.2.2. AT+QLWREG Send a Register Request to the LwM2M Server ................................ 14 2.2.3. AT+QLWUPDATE Send an Update Request to the LwM2M Server ......................... 14 2.2.4. AT+QLWDEREG Send a Deregister Request to the LwM2M Server........................ 15 2.2.5. AT+QLWSTAT Get the State of LwM2M Client .......................................................... 15 3 LwM2M Related URCs ...................................................................................................................... 16 3.1. +QLWURC: 'pdp active' The PDP Activation Indication....................................................... 16 3.2. +QLWURC: 'initial' The Initialization Indication .................................................................... 16 3.3. +QLWURC: 'dtls' The DTLS Handshake Indication ............................................................. 17 3.4. +QLWURC: 'bootstraping' The Bootstrap Working Indication ............................................. 17 3.5. +QLWURC: 'bootstrap' The Bootstrap Indication................................................................. 18 3.6. +QLWURC: 'registering' Start Registration Indication.......................................................... 18 3.7. +QLWURC: 'ready' The Registration Indication................................................................... 18 3.8. +QLWURC: 'update' The Update Indication ........................................................................ 19 3.9. +QLWURC: 'deregister' The Deregistration Indication ........................................................ 19 4 Examples ........................................................................................................................................... 20 4.1. Login to the LwM2M Server ..................................................................................................... 20 5 Appendix A References.................................................................................................................... 23 EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 4 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note Table Index Table 1: Applicable Modules......................................................................................................................... 6 Table 2: Type of AT Commands and Responses ......................................................................................... 7 Table 3: Terms and Abbreviations .............................................................................................................. 23 EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 5 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 1 Introduction OMA Lightweight M2M (LwM2M) is a device management protocol designed for sensor networks and the demands of a machine-to-machine (M2M) environment. The LwM2M protocol, designed for remote management of M2M devices and related service enablement, features a modern architectural design based on REST, defines an extensible resource and data model and builds on an efficient secure data transfer standard called the Constrained Application Protocol (CoAP). This document mainly introduces how to use the LwM2M feature with the following Quectel LTE standard modules through AT commands. 1.1. Applicable Modules Table 1: Applicable Modules Module Series EC2x series EG9x series EG2x-G Module EC21 series EC25 series EC20 R2.1 EG91 series EG95 series EG21-G EG25-G EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 6 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 2 Description of LwM2M AT Commands 2.1. AT Command Syntax 2.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on command line. When an optional parameter is omitted, the new value equals its previous value or its default setting, unless otherwise specified.  Underline Default setting of a parameter. 2.1.2. AT Command Syntax The AT or at prefix must be added at the beginning of each command line. Entering will terminate a command line. Commands are usually followed by a response that includes . Throughout this document, only the response will be presented, are omitted intentionally. Table 2: Type of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. [,[,[...]]] AT+ This command reads non-variable parameters affected by internal processes in the module. EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 7 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 2.2. Description of AT Commands 2.2.1. AT+QLWCFG Configure Optional Parameters of LwM2M This command configures optional parameters of LwM2M. AT+QLWCFG Configure Optional Parameters of LwM2M Test Command AT+QLWCFG=? Response +QLWCFG: 'security',(range of supported s),(range of supported s),,(list of supported s),(list of supported s),, +QLWCFG: 'server',(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(list of supports s),(list of supported s) +QLWCFG: 'epname/mode',(list of supported s) +QLWCFG: 'urc',(list of supported s) +QLWCFG: 'startup',(list of supported s) +QLWCFG: 'fota',(list of supported s),(list of supported s) +QLWCFG: 'hostdevice',(list of supported s),,,,,,, +QLWCFG: 'reset' +QLWCFG: 'nettype',(range of supported s) +QLWCFG: 'maxreconntime',(range of supported s),(range of supported s),(range of supported s) +QLWCFG: 'apnretry',(list of supported s),(range of supported s),(range of supported s) Write Command Read/configure the LwM2M server property AT+QLWCFG='security'[,[,,,< bootstrap>,[,< pskID>,]]] OK Response If the optional parameters are omitted, query the current configuration: +QLWCFG: 'security',,,,, … OK If only is specified and other optional parameters are EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 8 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note omitted, delete the property data of the specified : OK Or ERROR Write Command Read/configure the LwM2M server attribute AT+QLWCFG='server'[,,[,[,[,[,[,]]]]]] If any of the other optional parameters are specified, configure the specified server property: OK Or ERROR Response If the optional parameters are omitted, query the current configurations: +QLWCFG: 'server',,,,,< disable_timeout>,, … OK Write Command Read/configure mode of end point name AT+QLWCFG='epname/mode'[ ,] If any of the optional parameters are specified, configure the server attribute: OK Or ERROR Response If the optional parameter is omitted, query the current configuration: +QLWCFG: 'epname/mode', OK Write Command Read/configure LwM2M URC enablement AT+QLWCFG='urc'[,] If the optional parameter is specified, configure the mode of end point name: OK Or ERROR Response If the optional parameter is omitted, query the current configuration: +QLWCFG: 'urc', OK If the optional parameter is specified, configure whether to enable URC report: OK EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 9 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note Or ERROR Write Command Response Read/configure the startup mode If the optional parameter is omitted, query the current configuration: of LwM2M client +QLWCFG: 'startup', AT+QLWCFG='startup'[,] OK Write Command Read/configure FOTA mode AT+QLWCFG='fota'[,,] If the optional parameter is specified, configure the startup mode: OK Or ERROR Response If the optional parameters are omitted, query the current configuration: +QLWCFG: 'fota',, OK Write Command Read/configure host device information if the network is not Verizon AT+QLWCFG='hostdevice'[,,,,,] If the optional parameters are specified, configure the FOTA mode: OK Or ERROR Response If the optional parameters are omitted, query the current configurations: +QLWCFG: 'hostdevice',,,,, OK Write Command Read/configure host device information under Verizon network AT+QLWCFG='hostdevice'[,[,[,[,[,[ ,[,[, If the optional parameters are specified, configure host device information: OK Or ERROR Response If the optional parameters are omitted, query the current configurations: +QLWCFG: 'hostdevice',,,,,,,, OK EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 10 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note ]]]]]]]] If the optional parameters are specified, configure host device information: OK Or ERROR Execution Command Response Erase LwM2M client running OK record Or AT+QLWCFG='reset' ERROR Write Command Response Read/configure the net type of If the optional parameter is omitted, query the current configuration: LwM2M client +QLWCFG: 'nettype', AT+QLWCFG='nettype'[,] OK Write Command Read/configure the reconnection attribute AT+QLWCFG='maxreconntime '[,,,] If the optional parameter is specified, configure the net type: OK Or ERROR Response If the optional parameters are omitted, query the current configuration: +QLWCFG: 'maxreconntime',,, OK Write Command Read/configure the APN retry attribute AT+QLWCFG='apnretry'[,,,] If the optional parameters are specified, configure the specified reconnection: OK Or ERROR Response If the optional parameters are omitted, query the current configuration: +QLWCFG: 'apnretry',,, … OK If the optional parameters are specified, configure the specified APN retry attribute: OK EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 11 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note Maximum Response Time Characteristics Or ERROR / The commands take effect immediately. The configurations will be saved automatically while the will not be saved. Parameter Integer type. Server type. 0 Bootstrap server 1 DM server 2 Diagnostics server 3 Repository server Integer type. Short server ID. Custom parameter. Range: 1–65535. For Verizon network, the valid values are: 100 Bootstrap server 101 Diagnostics server 102 DM server 1000 Repository server String type. Server address. The format is 'address:port'. Integer type. Bootstrap server flag. 0 Not bootstrap (Only valid when is not 0) 1 Bootstrap (Only valid when =0) Integer type. Encryption method. 0 Pre-share key mode 3 No security mode String type. Pre-shared key identity. Only valid when =0. String type in hexadecimal. Pre-share key. Only valid when =0. Integer type. The lifetime of receiving heartbeat package by server. Range: 1–86400. Default: 60. Unit: second. Integer type. The minimum response period. Range: 1–86400. Default: 1. Unit: second. Integer type. The maximum response period. Range: 1–86400. Default: 60. Unit: second. Integer type. The interval to the next connection after disconnecting from the LwM2M server. Range: 1–86400. Default: 86400. Unit: second. Integer type. Whether to save the server information. 0 Do not save 1 Save String type. The binding mode used to connect the LwM2M server. 'U' UDP EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 12 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 'UQ' UDP with Queue mode 'S' SMS 'SQ' SMS with Queue mode 'US' UDP and SMS 'UQS' UDP and SMS with Queue mode Integer type. The format of endpoint name. 3 The endpoint name format: urn:imei:xxxxx 6 The endpoint name format: urn:imei-msisdn:xxxxx-xxx 7 The endpoint name format: urn:imei-imsi:xxxxx-xxx 8 China Mobile DM endpoint name Integer type. 0 Disable LwM2M URC report 1 Enable LwM2M URC report Integer type. 0 LwM2M will not be started automatically when the module is powered on 1 LwM2M will be started automatically when the module is powered on Integer type. The mode of downloading delta firmware package. 0 Download package manually 1 Download package automatically Integer type. The update mode of FOTA. 0 Update manually 1 Update automatically Integer type. The identity of host device. Range: 0–1. String type. The device ID of host device. String type. The manufacturer name of host device. String type. The model of host device. String type. The software version number of host device. String type. The firmware version number of host device. String type. The hardware version number of host device. Integer type. The seconds from January 1,1970 00:00:00 to the last firmware or software update time. If no time stamp is available, 0 is returned. Integer type. The network type. 0 Others 1 Verizon 2 AT&T Integer type. The coefficient of the wait time before retrying. Range: 1–86400. Default: 1 (300 under AT&T network). Unit: second. Integer type. Base number of the wait time before retrying. Range: 2–86400. Default: 2 (5 under AT&T network). Integer type. The max delay time of the wait time before retrying. Range: 0–86400. Default: 0 (86400 under AT&T network). Unit: second. The module will retry to connect if is greater than the delay time calculated by the following formula, otherwise, it will end reconnection. EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 13 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note Delay time = x ^ reconnection times Integer type. The ID of the APN to be reactivated. Range: 0–1. Integer type. The retry times to reactivate the APN. Range: 0–16. Default: 0 (2 under AT&T network). Integer type. The retry period to reactivate the APN. Range: 0–86400. Default: 0 (86400 under AT&T network). Unit: second. 2.2.2. AT+QLWREG Send a Register Request to the LwM2M Server This command sends a register request to the LwM2M Server. AT+QLWREG Send a Register Request to the LwM2M Server Test Command AT+QLWREG=? Execution Command AT+QLWREG Response OK Response OK Or ERROR 2.2.3. AT+QLWUPDATE Send an Update Request to the LwM2M Server This command sends an update request to the LwM2M Server. AT+QLWUPDATE Send an Update Request to the LwM2M Server Test Command AT+QLWUPDATE=? Write Command AT+QLWUPDATE= Response OK Response OK Or ERROR Parameter Integer type. Short server ID. 0 All servers Others Other specified server EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 14 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 2.2.4. AT+QLWDEREG Send a Deregister Request to the LwM2M Server This command launches a deregister request to the LwM2M Server. AT+QLWDEREG Send a Deregister Request to the LwM2M Server Test Command AT+QLWDEREG=? Execution Command AT+QLWDEREG Response OK Response OK Or ERROR 2.2.5. AT+QLWSTAT Get the State of LwM2M Client This command queries the state of the specified LwM2M client. AT+QLWSTAT Get the State of LwM2M Client Test Command AT+QLWSTAT=? Read Command AT+QLWSTAT? Response OK Response +QLWSTAT: OK Or ERROR Parameter Integer type. Indicates the state of LwM2M client. 0 Not registered 1 Registering 2 Registered 3 Deregistering EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 15 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 3 LwM2M Related URCs This chapter gives LwM2M related URCs and descriptions. 3.1. +QLWURC: 'pdp active' The PDP Activation Indication The activation result of PDP. The PDP should be activated before sending register request to the LwM2M server. +QLWURC: 'pdp active' The PDP Activation Indication +QLWURC: 'pdp active',, This URC is reported to indicate the PDP activation result. Parameter String type. The result of PDP activation. 'successfully' 'failed' String type. APN name. 3.2. +QLWURC: 'initial' The Initialization Indication The initialization result of connection between client and the LwM2M server. +QLWURC: 'initial' The Initialization Indication +QLWURC: 'initial',, This URC is reported to indicate the connection initialization result. Parameter String type. The initialization result. 'successfully' 'failed' EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 16 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note Integer type. Short server ID. 0 All servers Others Specified servers 3.3. +QLWURC: 'dtls' The DTLS Handshake Indication This URC is reported to indicate the DTLS handshake result if the encryption method is used. +QLWURC: 'dtls' The DTLS Handshake Indication +QLWURC: 'dtls',, This URC is reported to indicate the DTLS handshake result. Parameter String type. DTLS handshake result. 'successfully' 'failed' Integer type. Short server ID. 0 All servers Others Specified servers 3.4. +QLWURC: 'bootstraping' The Bootstrap Working Indication This URC will be reported when Bootstrap is working. +QLWURC: 'bootstraping' The Bootstrap Working Indication +QLWURC: 'bootstraping' This URC is reported to indicate that the Bootstrap is working. EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 17 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 3.5. +QLWURC: 'bootstrap' The Bootstrap Indication The working result of Bootstrap. +QLWURC: 'bootstrap' The Bootstrap Indication +QLWURC: 'bootstrap',, This URC is reported to indicate the Bootstrap working result. Parameter String type. The working result of Bootstrap. 'successfully' 'failed' Integer type. Short server ID. 0 All servers Others Specified servers 3.6. +QLWURC: 'registering' Start Registration Indication This URC will be reported when the client is registering on the LwM2M server. +QLWURC: 'registering' Start Registration Indication +QLWURC: 'registering' This URC is reported to indicate that the client is registering. 3.7. +QLWURC: 'ready' The Registration Indication This URC is reported to indicate the registration result after sending the register request to the LwM2M server. +QLWURC: 'ready' The Registration Indication +QLWURC: 'ready',, This URC is reported to indicate the registration result. Parameter String type. The registration result. EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 18 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 'successfully' 'failed' Integer type. Short server ID. 0 All servers Others Specified servers 3.8. +QLWURC: 'update' The Update Indication This URC is reported to indicate the update result after sending the update request to the LwM2M server. +QLWURC: 'update' The Update Indication +QLWURC: 'update',, This URC is reported to indicate the update result. Parameter String type. Update result. 'successfully' 'failed' Integer type. Short server ID. 0 All servers Others Specified servers 3.9. +QLWURC: 'deregister' The Deregistration Indication This URC is reported to indicate the deregistration result after sending deregister request to the LwM2M server. +QLWURC: 'deregister' The Deregistration Indication +QLWURC: 'deregister', This URC is reported to indicate the deregistration result. Parameter Integer type. Short server ID. 0 All servers Others Specified servers EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 19 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 4 Examples This chapter gives the examples to explain how to use LwM2M related AT commands. 4.1. Login to the LwM2M Server AT+QLWCFG=? +QLWCFG: 'security',(0-3),(1-65535),,(0,1),(0,3),, +QLWCFG: 'server',(0-3),(1-86400),(1-86400),(1-86400),(1-86400),(0,1),('U','UQ','S','SQ','US''U QS') +QLWCFG: 'epname/mode',(3,6,7,8) +QLWCFG: 'urc',(0,1) +QLWCFG: 'startup',(0,1) +QLWCFG: 'fota',(0,1),(0,1) +QLWCFG: 'hostdevice',(0,1),,,,,, , +QLWCFG: 'reset' +QLWCFG: 'nettype',(0-2) +QLWCFG: 'maxreconntime',(1-86400),(2-86400),(0-86400) +QLWCFG: 'apnretry',(0,1),(0-16),(0-86400) OK AT+QLWCFG='security',0,100,'coaps://InteropBootstrap.dm.iot.att.com:5694',1,0,'urn:imei:8644 30010001095','313233343536' OK AT+QLWCFG='security' +QLWCFG: 'security',0,100,'coaps://InteropBootstrap.dm.iot.att.com:5694',1,0 OK AT+QLWCFG='epname/mode',3 OK AT+QLWCFG='epname/mode' +QLWCFG: 'epname/mode',3 OK AT+QLWCFG='urc',1 EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 20 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note OK AT+QLWCFG='urc' +QLWCFG: 'urc',1 OK AT+QLWCFG='startup',1 OK AT+QLWCFG='startup' +QLWCFG: 'startup',1 OK AT+QLWCFG='fota',1,1 OK AT+QLWCFG='fota' +QLWCFG: 'fota',1,1 OK AT+QLWCFG='hostdevice',0,'HUID0','HMAN0','HMOD0','HSW0' //Configure host device information if the network is not Verizon. OK AT+QLWCFG='hostdevice' //Read host device information if the network is not Verizon. +QLWCFG: 'hostdevice',0,'HUID0','HMAN0','HMOD0','HSW0' +QLWCFG: 'hostdevice',1,'HUID1','HMAN1','HMOD1','HSW1' OK AT+QLWCFG='reset' OK AT+QLWCFG='nettype',2 OK AT+QLWCFG='nettype' +QLWCFG: 'nettype',2 OK AT+QLWSTAT? +QLWSTAT: 0 OK AT+QLWREG OK +QLWURC: 'pdp active','successfully','attm2mglobal' +QLWURC: 'initial','successfully',100 EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 21 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note +QLWURC: 'dtls','successfully',100 +QLWURC: 'bootstraping' +QLWURC: 'bootstrap','successfully',100 +QLWURC: 'initial','successfully',1 +QLWURC: 'dtls','successfully',1 +QLWURC: 'registering' +QLWURC: 'ready','successfully',1 AT+QLWUPDATE=0 OK +QLWURC: 'update','successfully',1 AT+QLWSTAT? +QLWSTAT: 2 OK AT+QLWDEREG OK +QLWURC: 'deregister',0 AT+QLWSTAT? +QLWSTAT: 0 OK EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 22 / 23 LTE Standard Module Series EC2x&EG9x&EG2x-G Series LwM2M Application Note 5 Appendix A References Table 3: Terms and Abbreviations Abbreviation APN CoAP DM DTLS ID LTE LwM2M PDP REST SMS SSID UDP URC Description Access Point Name Constrained Application Protocol Device Management Datagram Transport Layer Security Mostly refers to Identifier in terms of software Long Term Evolution Lightweight Machine to Machine Packet Data Protocol Representational State Transfer Short Message Service Service Set Identifier User Datagram Protocol Unsolicited Result Code EC2x&EG9x&EG2x-G_Series_LwM2M_Application_Note 23 / 23

BG95&BG77&BG600L Series NIDD Application Note LPWA Module Series Version: 1.0 Date: 2020-10-14 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_NIDD_Application_Note 1 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note Copyright The information contained here is proprietary technical information of Quectel wireless solutions co., ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved. BG95&BG77&BG600L_Series_NIDD_Application_Note 2 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note About the Document Revision History Version Date Author - 2020-05-25 Forest WANG 1.0 2020-10-14 Forest WANG Description Creation of the document First official release BG95&BG77&BG600L_Series_NIDD_Application_Note 3 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 1 Introduction ......................................................................................................................................... 6 2 NIDD AT Commands........................................................................................................................... 7 2.1. AT Command Syntax ................................................................................................................. 7 2.1.1. Definitions........................................................................................................................ 7 2.1.2. AT Command Syntax ...................................................................................................... 7 2.2. Description of NIDD Related AT Commands ............................................................................. 8 2.2.1. AT+QCFGEXT='nipdcfg' Configure NIDD Connection ............................................... 8 2.2.2. AT+QCFGEXT='nipd' Open or Close NIDD Connection ............................................ 8 2.2.3. AT+QCFGEXT='nipds' Send MO Non-IP Data ........................................................... 9 2.2.4. AT+QCFGEXT='nipdr' Retrieve MT Non-IP Data ..................................................... 10 2.3. Description of NIDD Related URCs ..........................................................................................11 2.3.1. +QIND: 'nipd','recv' Indicate the Incoming Data .......................................................11 2.3.2. +QIND: 'nipd','close' Indicate the Connection is Closed .......................................... 12 2.4. Example ................................................................................................................................... 12 3 Summary of ..................................................................................................................... 14 4 Appendix A References.................................................................................................................... 15 BG95&BG77&BG600L_Series_NIDD_Application_Note 4 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note Table Index Table 1: Types of AT Commands and Responses ....................................................................................... 7 Table 2: Summary of ................................................................................................................. 14 Table 3: Related Documents ...................................................................................................................... 15 Table 4: Terms and Abbreviations .............................................................................................................. 15 BG95&BG77&BG600L_Series_NIDD_Application_Note 5 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note 1 Introduction The support for NIDD (Non-IP Data Delivery) is introduced from 3GPP Release 13 and later releases. Functions for NIDD may be used to handle MO and MT communication with UE, where the data used for the communication is considered unstructured from the EPS standpoint (which is referred to as Non-IP). Quectel BG95 series, BG77 and BG600L-M3 modules support NIDD in NB-IoT RAT, and support both tethered and embedded Non-IP data calls. This document introduces how to use the NIDD function of the modules through AT commands. BG95&BG77&BG600L_Series_NIDD_Application_Note 6 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note 2 NIDD AT Commands 2.1. AT Command Syntax 2.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on the command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is omitted, the new value equals to the previous value or the default settings, unless otherwise specified.  Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with 'AT' or 'at' and end with ''. Information responses and result codes always start and end with a carriage return character and a line feed character: . Throughout this document, only the commands and responses are presented, while carriage return and line feed characters are deliberately omitted. Table 1: Types of AT Commands and Responses Command Type Syntax Description Test Command Read Command Write Command Execution Command AT+=? Returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. AT+? Returns the currently set value of a parameter or parameters. AT+= Sets parameter values. [,[,[...]]] AT+ Reads non-variable parameters affected by internal processes in the module. BG95&BG77&BG600L_Series_NIDD_Application_Note 7 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note 2.2. Description of NIDD Related AT Commands 2.2.1. AT+QCFGEXT='nipdcfg' Configure NIDD Connection This command configures an NIDD connection. AT+QCFGEXT='nipdcfg' Configure NIDD Connection Write Command AT+QCFGEXT='nipdcfg'[,[,[,,]]] Response If the optional parameters are omitted, the command queries the current setting. +QCFGEXT: 'nipdcfg',, OK If any of the optional parameters is specified, the command configures the NIDD connection. OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms The command takes effect immediately. The configurations are not saved. Parameter Integer type. Non-IP outgoing data type. 0 MO Non-IP data type 1 MO Exception Non-IP data type String type. Access point name. String type. Username of the selected APN. String type. Password of the selected APN. NOTES Before using the selected APN for starting up a Non-IP data call, set the PDP type of the APN into 'Non-IP' with AT+CGDCONT. See document [2] for details of AT+CGDCONT. 2.2.2. AT+QCFGEXT='nipd' Open or Close NIDD Connection This command opens or closes an NIDD connection. BG95&BG77&BG600L_Series_NIDD_Application_Note 8 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note AT+QCFGEXT='nipd' Open or Close NIDD Connection Write Command AT+QCFGEXT='nipd',[,] Response If =0, the command closes the NIDD connection. OK If =1, the command opens an NIDD connection. OK +QIND: 'nipd','open', If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations are not saved. Parameter Integer type. Close or open an NIDD connection. 0 Close an NIDD connection. 1 Open an NIDD connection. Integer type. The timeout when opening the NIDD connection. This parameter is valid only when =1. Range: 30–90. Default value: 30. Unit: second. Integer type. Error code of operation. See Chapter 3 for details. NOTES 1. NIDD function is disabled by default. AT+QCFG='nccconf',115 can be used to enable the function. 2. Non-IP data calls are supported for AP embedded and tethered RmNet calls only. 3. Non-IP data calls are not supported for modem embedded calls. 2.2.3. AT+QCFGEXT='nipds' Send MO Non-IP Data This command sends MO Non-IP data to a server. BG95&BG77&BG600L_Series_NIDD_Application_Note 9 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note AT+QCFGEXT='nipds' Send MO Non-IP Data Write Command AT+QCFGEXT='nipds',,[,] Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configurations are not saved. Parameter Integer type. Data format. 0 ASCII format string. 1 HEX format string. String type. The data to be sent. Integer type. The length of the data to be sent. If this parameter is omitted, can be specified at any length within 1358 bytes of ASCII format. Range: 1–1358. can be specified at any length within 679 bytes of HEX format. Range: 1–679. Unit: byte. String type. Error code of operation. See Chapter 3 for details. 2.2.4. AT+QCFGEXT='nipdr' Retrieve MT Non-IP Data This command retrieves the data reported by the URC +QIND: 'nipd','recv'. AT+QCFGEXT='nipdr' Retrieve MT Non-IP Data Write Command AT+QCFGEXT='nipdr'[,[ ,]] Response +QCFGEXT: 'nipdr',, OK If there is no data that can be retrieved: +QCFGEXT: 'nipdr',0 OK If there is an error related to ME functionality: BG95&BG77&BG600L_Series_NIDD_Application_Note 10 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note +CME ERROR: If there is any other error: ERROR Write Command When is 0, query the read status of the retrieved data: AT+QCFGEXT='nipdr',0 Response If the connection has existed: +QCFGEXT: 'nipdr',,, OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms / Parameter Integer type. The length of the data to be retrieved. Retrieve all available data if this parameter is omitted. Unit: byte. Integer type. Data format. This parameter is valid only when is not 0. 0 String type 1 Hex type Integer type. The actual length of retrieved data. Unit: byte. String type. Retrieved data. Integer type. The total length of received data. Unit: byte. Integer type. The length of retrieved data. Unit: byte. Integer type. The length of unread data. Unit: byte. Integer type. The error code of the operation. See Chapter 3 for details. 2.3. Description of NIDD Related URCs 2.3.1. +QIND: 'nipd','recv' Indicate the Incoming Data After receiving the non-IP data from the MT, the module reports the URC +QIND: 'nipd','recv' to notify the host that there is incoming data. Then host can retrieve data via AT+QCFGEXT='nipdr'. Be note that BG95&BG77&BG600L_Series_NIDD_Application_Note 11 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note if the buffer is not empty, and the module receives data again, it will not report a new URC until all the received data has been retrieved via AT+QCFGEXT='nipdr' from the buffer. The size of the buffer is 2048 bytes. If the data received exceeds the buffer size, the subsequent data will be discarded. +QIND: 'nipd','recv' Indicate the Incoming Data +QIND: 'nipd','recv' The URC notifies the host that there is incoming data from the network. Then the host can retrieve the data via AT+QCFGEXT='nipdr'. 2.3.2. +QIND: 'nipd','close' Indicate the Connection is Closed +QIND: 'nipd','close' Indicate the Connection is Closed +QIND: 'nipd','close' The URC notifies that the connection is accidentally closed. If the connection is closed normally via the AT+QCFGEXT='nipd',0, this URC will not be reported. 2.4. Example AT+CGDCONT=1,'Non-IP','cmcc' //Set the PDP type of selected APN into 'Non-IP'. OK AT+CEREG? +CEREG: 0,1 OK AT+QCFGEXT='nipdcfg',0,'cmcc' //Set the Non-IP data type and APN. OK AT+QCFGEXT='nipdcfg' +QCFGEXT: 'nipdcfg',0,'cmcc' OK AT+QCFGEXT='nipd',1,30 //Open an NIDD connection. OK +QIND: 'nipd','open',0 AT+QCFGEXT='nipds',0,'quectel',7 OK AT+QCFGEXT='nipds',1,'6162636465',10 OK //Send 'quectel' in ASCII format via NIDD connection. //Send 'abcde' in hex format via NIDD connection. BG95&BG77&BG600L_Series_NIDD_Application_Note 12 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note //When there is any incoming data from the network, the following URC will be reported. +QIND: 'nipd','recv' AT+QCFGEXT='nipdr',0 //Query the retrieved data length. +QCFGEXT: 'nipdr',10,0,10 //There are 10 bytes data to be retrieved. OK AT+QCFGEXT='nipdr',10 +QCFGEXT: 'nipdr',10,0123456789 //Read 10 bytes of the incoming data. OK AT+QCFGEXT='nipdr',0 +QCFGEXT: 'nipdr',10,10,0 //Query the retrieved data length. //All incoming data has been retrieved. OK AT+QCFGEXT='nipd',0 //Close the NIDD connection. OK BG95&BG77&BG600L_Series_NIDD_Application_Note 13 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note 3 Summary of The error code indicates an error related to mobile equipment or network. The table below describes the details about . Table 2: Summary of 0 651 652 653 654 655 656 657 658 Meaning Operation successful Invalid input value Send error Network error NIDD busy Timeout error Connection not open Connection already opened Connection accidentally closed BG95&BG77&BG600L_Series_NIDD_Application_Note 14 / 16 LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note 4 Appendix A References Table 3: Related Documents SN Document Name Remark Quectel_BG95&BG77&BG600L_Series_ QCFGEXT AT commands manual of BG95 series, [1] QCFGEXT_AT_Commands_Manual BG77 and BG600L-M3 modules Quectel_BG95&BG77&BG600L_Series_ AT commands manual of BG95 series, BG77 and [2] _AT_Commands_Manual BG600L-M3 modules Table 4: Terms and Abbreviations Abbreviation 3GPP AP APN ASCII EPS HEX IP IPv4 IPv6 ME MO MT NIDD Description 3rd Generation Partnership Project Application Processor Access Point Name American Standard Code for Information Interchange Evolved Packet System Hexadecimal Internet Protocol Internet Protocol version 4 Internet Protocol version 6 Mobile Equipment Mobile Originated Mobile Terminated Non-IP Data Delivery BG95&BG77&BG600L_Series_NIDD_Application_Note 15 / 16 UE URC LPWA Module Series BG95&BG77&BG600L Series NIDD Application Note User Equipment Unsolicited Result Code BG95&BG77&BG600L_Series_NIDD_Application_Note 16 / 16

BG95&BG77&BG600L Series GNSS Application Note LPWA Module Series Version: 1.3 Date: 2022-02-25 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_GNSS_Application_Note 1 / 75 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Series_GNSS_Application_Note 2 / 75 LPWA Module Series About the Document Revision History Version 1.0 1.1 1.2 Date 2019-11-29 2020-07-17 2020-10-23 Author Matt YE/ Alfred LI Matt YE Matt YE/ Alfred LI/ Mac ZHU Description Initial 1. Added an applicable module BG600L-M3. 2. Added the description of GNSS and WWAN coexistence management (Chapter 1.3). 3. Added AT command syntax (Chapter 2.1). 4. Added AT+QGPSCFG='qzssnmeatype' (Chapter 2.2.1.8). 5. Extended AT+QGPSCFG='priority' to enable saving of priority configuration (Chapter 2.2.1.11). 6. Added AT+QCFGEXT and its example (Chapter 2.2.6 and Chapter 3.4). 7. Added FAQ (Chapter 5). 1. Added introduction of gpsOneXTRA feature (Chapter 1.4). 2. Added the following AT commands (Chapter 2.2.1) AT+QGPSCFG='xtrafilesize', AT+QGPSCFG='xtra_info', AT+QGPSCFG='gpsdop', AT+QGPSCFG='estimation_error', AT+QGPSCFG='nmea_epe', AT+QGPSCFG='xtra_apn', AT+QGPSCFG='xtra_download', AT+QGPSCFG='test_mode'. 3. Added notes for AT+QGPSCFG='priority' (Chapter 2.2.1.11). 4. Supported to return URC +QGPSURC: 'XTRA_DL', indicating whether XTRA file is downloaded successfully after GNSS is turned on (Chapter 2.2.2) 5. Modified and of AT+QGPSLOC (Chapter 2.2.4). BG95&BG77&BG600L_Series_GNSS_Application_Note 3 / 75 LPWA Module Series 6. Added AT+QGPSXTRA (Chapter 2.2.7). 7. Added AT+QGPSXTRATIME (Chapter 2.2.8). 8. Added AT+QGPSXTRADATA (Chapter 2.2.9). 9. Added AT+QGPSDEL (Chapter 2.2.10). 10. Updated the example about positioning information acquiring (Chapter 3.2). 11. Added examples of gpsOneXTRA feature (Chapter 3.5). 12. Updated error code table (Chapter 6). 1. Added the following AT commands (Chapter 2.3.1). AT+QGPSCFG='xtra_autodownload'. AT+QGPSCFG='xtra_ntp' 2. Involved AT+QGPSCFG='xtra_autodownload',1 in XTRA file downloading and XTRA operating procedures (Chapters 1.4.3 and 1.4.4). Kayn 1.3 2022-02-25 3. Added a note to give details if =5 when SHAO configuring supported GNSS constellations (Chapter 2.3.1.2). 4. Updated the supported NMEA sentence types for QZSS (Chapter 2.3.1.8). 5. Changed the default value of AT+QGPSCFG='test_mode' (Chapter 2.3.1.20) BG95&BG77&BG600L_Series_GNSS_Application_Note 4 / 75 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 5 Table Index.................................................................................................................................................. 8 Figure Index ................................................................................................................................................ 9 1 Introduction ....................................................................................................................................... 10 1.1. Applicable Modules .................................................................................................................. 10 1.2. Supported NMEA Sentence Types ...........................................................................................11 1.3. GNSS and WWAN Coexistence Management ........................................................................ 12 1.3.1. WWAN Priority Mode .................................................................................................... 12 1.3.2. GNSS Priority Mode...................................................................................................... 14 1.3.3. WWAN and GNSS Switching Delays............................................................................ 15 1.3.4. GNSS/WWAN Priority and PSM ................................................................................... 16 1.3.5. GNSS/WWAN Priority and eDRX ................................................................................. 17 1.3.6. Minimum eDRX Cycle Recommendation in WWAN Priority Mode .............................. 18 1.4. XTRA Feature .......................................................................................................................... 19 1.4.1. XTRA Configuration Items ............................................................................................ 20 1.4.2. XTRA Time Source........................................................................................................ 20 1.4.3. Downloading XTRA File ................................................................................................ 21 1.4.3.1. XTRA File Downloading Initiation....................................................................... 21 1.4.3.2. Validity Checking ................................................................................................ 21 1.4.3.3. Downloading Process ........................................................................................ 22 1.4.3.4. URLs for Downloading XTRA File Through MCU or Browser ........................... 23 1.4.4. XTRA Operating Procedures ....................................................................................... 24 1.4.4.1. XTRA File Downloading Triggered with AT+QGPSCFG='xtra_download',1 .... 25 1.4.4.2. Automatic XTRA File Downloading by Starting GNSS ...................................... 25 1.4.4.3. XTRA File Downloading Through MCU or Browser........................................... 25 2 Description of GNSS AT Commands .............................................................................................. 26 2.1. AT Command Introduction ....................................................................................................... 26 2.1.1. Definitions...................................................................................................................... 26 2.1.2. AT Command Syntax .................................................................................................... 26 2.2. Declaration of AT Command Examples ................................................................................... 27 2.3. AT Command Description ........................................................................................................ 27 2.3.1. AT+QGPSCFG Configure GNSS ............................................................................... 27 2.3.1.1. AT+QGPSCFG='outport' Configure NMEA Output Port ................................ 28 2.3.1.2. AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations .... 29 2.3.1.3. AT+QGPSCFG='nmeafmt' Configure NMEA Protocol Standard ................... 30 2.3.1.4. AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences ........................................................................................................................... 31 2.3.1.5. AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences ................................................................................................................. 32 BG95&BG77&BG600L_Series_GNSS_Application_Note 5 / 75 LPWA Module Series 2.3.1.6. AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences ........................................................................................................................... 33 2.3.1.7. AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences ........................................................................................................................... 33 2.3.1.8. AT+QGPSCFG='qzssnmeatype' Configure Output Type of QZSS NMEA Sentences ........................................................................................................................... 34 2.3.1.9. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA ............................................................................................................... 35 2.3.1.10. AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically........ 36 2.3.1.11. AT+QGPSCFG='priority' Set GNSS or WWAN Priority Mode ....................... 37 2.3.1.12. AT+QGPSCFG='xtrafilesize' Select XTRA File to be Downloaded ............... 38 2.3.1.13. AT+QGPSCFG='xtra_info' Query the Existing XTRA File Information .......... 38 2.3.1.14. AT+QGPSCFG='gpsdop' Query GNSS DOP Value ...................................... 39 2.3.1.15. AT+QGPSCFG='estimation_error' Get Estimation Error ............................... 40 2.3.1.16. AT+QGPSCFG='nmea_epe' Enable/Disable the Output of EPE NMEA Sentences ........................................................................................................................... 40 2.3.1.17. AT+QGPSCFG='xtra_apn' Configure APN Settings of XTRA File................. 41 2.3.1.18. AT+QGPSCFG='xtra_download' Trigger XTRA File Downloading ................ 42 2.3.1.19. AT+QGPSCFG='xtra_autodownload' Enable/Disable Automatic Downloading of XTRA File ......................................................................................................................... 43 2.3.1.20. AT+QGPSCFG='test_mode' Enable/Disable XTRA Test Mode..................... 43 2.3.1.21. AT+QGPSCFG='xtra_ntp' Enable/Disable Time Synchronization from NTP Server .......................................................................................................................... 44 2.3.2. AT+QGPS Turn on GNSS .......................................................................................... 45 2.3.3. AT+QGPSEND Turn off GNSS .................................................................................. 47 2.3.4. AT+QGPSLOC Acquire Positioning Information ........................................................ 47 2.3.5. AT+QGPSGNMEA Acquire NMEA Sentences ........................................................... 50 2.3.6. AT+QCFGEXT Query and Configure Extended Settings .......................................... 51 2.3.6.1. AT+QCFGEXT='addgeo' Add a Geo-fence ................................................... 52 2.3.6.2. AT+QCFGEXT='deletegeo' Delete a Geo-fence............................................ 54 2.3.6.3. AT+QCFGEXT='querygeo' Query the Position with Respect to Geo-Fence. 55 2.3.7. AT+QGPSXTRA Enable/Disable XTRA Function ...................................................... 55 2.3.8. AT+QGPSXTRATIME Inject XTRA Time.................................................................... 56 2.3.9. AT+QGPSXTRADATA Inject XTRA File ..................................................................... 57 2.3.10. AT+QGPSDEL Delete Assistance Data ..................................................................... 58 3 Examples ........................................................................................................................................... 60 3.1. Turn on/off GNSS..................................................................................................................... 60 3.2. Acquire Positioning Information ............................................................................................... 60 3.3. Query Satellite System ............................................................................................................ 62 3.4. Implement Geo-Fence Function .............................................................................................. 63 3.5. Procedure to Use XTRA Feature ............................................................................................. 64 3.5.1. XTRA File Downloading Triggered with AT+QGPSCFG='xtra_download',1 ............... 64 3.5.2. Automatic XTRA File Downloading by Starting GNSS ................................................. 64 3.5.3. XTRA File Downloading Through MCU or Browser...................................................... 65 BG95&BG77&BG600L_Series_GNSS_Application_Note 6 / 75 LPWA Module Series 4 Use Cases .......................................................................................................................................... 67 4.1. PSM Enabled ........................................................................................................................... 67 4.2. Recommended Mode: WWAN Priority Mode .......................................................................... 67 4.3. Recommended Mode: GNSS Priority Mode ............................................................................ 68 4.4. Limitations of GNSS................................................................................................................. 68 5 FAQ..................................................................................................................................................... 70 6 Summary of Error Codes ................................................................................................................. 71 7 Appendix References ....................................................................................................................... 73 BG95&BG77&BG600L_Series_GNSS_Application_Note 7 / 75 LPWA Module Series Table Index Table 1: Applicable Modules....................................................................................................................... 10 Table 2: Average Delays Captured for Different RATs (Unit: s) ................................................................. 15 Table 3: Recommended Minimum eDRX Cycle in WWAN Priority Mode (Unit: s).................................... 19 Table 4: Types of AT Commands ............................................................................................................... 26 Table 5: Summary of Error Codes.............................................................................................................. 71 Table 6: Related Documents ...................................................................................................................... 73 Table 7: Terms and Abbreviations .............................................................................................................. 73 BG95&BG77&BG600L_Series_GNSS_Application_Note 8 / 75 LPWA Module Series Figure Index Figure 1: GNSS and WWAN Coexistence Management (WWAN Priority Mode) ..................................... 13 Figure 2: GNSS and WWAN Coexistence Management (GNSS Priority Mode) ...................................... 14 Figure 3: Configure PSM in GNSS Priority Mode ...................................................................................... 17 Figure 4: Configure eDRX in GNSS Priority Mode .................................................................................... 18 Figure 5: eDRX Diagram ............................................................................................................................ 19 Figure 6: XTRA File Downloading Process................................................................................................ 22 BG95&BG77&BG600L_Series_GNSS_Application_Note 9 / 75 LPWA Module Series 1 Introduction Quectel BG95 series, BG77 and BG600L-M3 modules integrate the XTRA (i.e., gpsOneXTRA) feature with the multi-GNSS engine, which supports GPS, BeiDou, Galileo, GLONASS and QZSS systems. The GNSS engine can receive simultaneous signals from maximum two constellations (GPS and another constellation) at any given time. Therefore, it is suitable for various applications requiring accurate positioning at the lowest cost, or position tracking without network assistance. The modules are based on a cost-optimized architecture in which WWAN (LTE Cat-M1, LTE Cat-NB2 and GSM) and GNSS Rx chains share certain hardware blocks. However, the modules do not support concurrent operation of WWAN and GNSS. The solution adopted in the modules is a form of coarse time-division multiplexing (TDM) between WWAN and GNSS Rx chains. Given the relaxed latency requirements of most LPWA applications, time-division sharing of resources can be made largely transparent to applications. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 Series BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 Description Cat-M1 Cat-M1/Cat-NB2 Cat-M1/Cat-NB2/EGPRS Cat-M1/Cat-NB2, 450 MHz Supported Cat-M1/Cat-NB2/EGPRS, Power Class 3 Cat-M1/Cat-NB2, Power Class 3 Cat-M1/Cat-NB2, Wi-Fi Positioning Cat-M1/Cat-NB2 BG95&BG77&BG600L_Series_GNSS_Application_Note 10 / 75 BG600L BG600L-M3 LPWA Module Series Cat-M1/Cat-NB2/EGPRS NOTE Hereinafter, BG95 series shall be collectively referred to as BG95 unless otherwise specified. 1.2. Supported NMEA Sentence Types The default NMEA sentences of the modules are compliant with the NMEA 0183 version 4.10 standard except for talker ID of RMC, GGA and VTG sentences, which use Qualcomm-specific standards. Each satellite system uses distinct prefixes, so as to easily distinguish NMEA sentences of different satellite systems, as is illustrated below. GPS sentences have the prefix 'GP': ⚫ GPGGA - Global positioning system fix data, such as time and position. ⚫ GPRMC - Recommended minimum specific GNSS data ⚫ GPGSV - GNSS satellites in view (number of satellites in view, satellite ID numbers, etc.). ⚫ GPGSA - GNSS DOP and active satellites ⚫ GPVTG - Course over ground and ground speed GLONASS sentences have the prefixes 'GL' and 'GN': ⚫ GLGSV - GNSS satellites in view (number of satellites in view, satellite ID numbers, etc.). ⚫ GNGSA - GNSS DOP and active satellites For Galileo sentences, the prefixes are 'GA' and 'GN': ⚫ GAGSV - GNSS satellites in view (number of satellites in view, satellite ID numbers, etc.). ⚫ GNGSA - GNSS DOP and active satellites For BeiDou sentences, the prefix is 'PQ': ⚫ PQGSV - GNSS satellites in view (number of satellites in view, satellite ID numbers, etc.). ⚫ PQGSA - GNSS DOP and active satellites QZSS sentences also start with the prefix 'PQ': ⚫ PQGSV - GNSS satellites in view (number of satellites in view, satellite ID numbers, etc.). ⚫ PQGSA - GNSS DOP and active satellites BG95&BG77&BG600L_Series_GNSS_Application_Note 11 / 75 LPWA Module Series 1.3. GNSS and WWAN Coexistence Management As GNSS and WWAN cannot work simultaneously, either WWAN or GNSS takes priority during implementation. By default, the modules are configured into the GNSS priority mode, which can be switched to the WWAN priority mode with AT+QGPSCFG='priority'. The command takes effect immediately. For more details, see Chapter 2.3.1.11. 1.3.1. WWAN Priority Mode In the WWAN priority mode, GNSS positioning request succeeds only when RRC is released and WWAN enters an idle sleep. Features of WWAN priority mode include: ⚫ Data service works well all the time (No WWAN page is missed) ⚫ RRC connection is not impacted by GNSS operation ⚫ GNSS session is deferred to the time when the UE goes to the eDRX state1) For LPWA applications, the duration for WWAN in the active status is fairly short. Therefore, GNSS has an opportunity to get a position fix. NOTE 1. 1) The eDRX cycle must be configured sufficiently long. In the WWAN priority mode, if the eDRX Sleep Cycle is shorter than the t + t1, the GNSS is not able to get a position fix. For more details, see Chapter 1.3.6. 2. When the eDRX Sleep Cycle is less than t + t1 or eDRX is not supported, it is recommended to set the modules into the GNSS priority mode. 3. When switching from the WWAN priority mode to the GNSS priority mode, the modules take about 1 second (in the open sky, see Chapter 1.3.3) for GNSS to get a position fix (if GNSS has got a position fix before). BG95&BG77&BG600L_Series_GNSS_Application_Note 12 / 75 RRC connected state Send data to server Start GNSS LPWA Module Series GNSS is deferred N Is data transmission over? Y Enter eDRX? N GNSS is deferred Y GNSS fix request succeeded GNSS loading successful GNSS works periodically Data transmission GNSS is deferred automatically Data transmission over; eDRX entered N GNSS is deferred Y GNSS fix request succeeded automatically Figure 1: GNSS and WWAN Coexistence Management (WWAN Priority Mode) BG95&BG77&BG600L_Series_GNSS_Application_Note 13 / 75 LPWA Module Series 1.3.2. GNSS Priority Mode In the GNSS priority mode, GNSS positioning request succeeds in all WWAN states: ⚫ When UE is in the RRC connected state: The UE locally releases the RRC connection and initiates the GNSS session. After the GNSS session is completed, if there is WWAN data to be sent, the RRC connection will be initiated again. ⚫ When UE is in the eDRX state: The UE may miss pages sent on the paging channel while the GNSS session is still active. RRC connected state Start sending data to server Start GNSS (1) Data transmission is stopped and RRC connection is released GNSS fix request succeeded GNSS loaded successfully GNSS works periodically Switch to WWAN priority mode (2) WWAN loaded successfully Start data transmission (3) Data sent successfully Switch to GNSS priority mode Figure 2: GNSS and WWAN Coexistence Management (GNSS Priority Mode) NOTE 1. GNSS starts working as soon as the GNSS is started. 2. After switching to the WWAN priority mode, the GNSS is stopped automatically. In such a case, the BG95&BG77&BG600L_Series_GNSS_Application_Note 14 / 75 LPWA Module Series power consumption is the same as when the GNSS is stopped with AT+QGPSEND. 3. It is recommended to delay 0.5 seconds before transmitting data as this is the time that the module needs to switch from the GNSS to the WWAN priority mode (see Chapter 1.3.3). 4. The priority of the following operations/procedures is higher than that of GNSS/WWAN: ⚫ Power-off/Power Saving Mode ⚫ PS detaching 1.3.3. WWAN and GNSS Switching Delays The following table summarizes the average delays captured for different RATs. All tests were executed in the open sky, with the transmission of 500-byte data as an example. The presented average delays are provided for illustration purposes only and should be taken with caution. ⚫ Test Environment GNSS CNR = 45 dB LTE-M RSRP = -71 dBm SINR = 21.4 dB NB-IoT RSRP = -87 dBm SINR = 15 dB GSM RSSI = -48 dBm ⚫ Test Steps Load WWAN → Unload WWAN → Load GNSS → Get a position fix → Unload GNSS → Load WWAN → Transfer WWAN data. Table 2: Average Delays Captured for Different RATs (Unit: s) Network Type LTE-M Load WWAN 0.251 Unload WWAN 0.153 Load GNSS 0.208 Unload GNSS 0.116 Delay Between 'Switching to WWAN Priority Mode' and 'Start Sending Data' 1) 0.5 Time to Transfer WWAN Data (the delay for setting up and closing the connection is not taken 1.0 into account) 2) NB-IoT 0.177 0.087 0.216 0.112 0.5 4.5 GSM 0.259 0.339 0.197 0.105 0.5 3.6 BG95&BG77&BG600L_Series_GNSS_Application_Note 15 / 75 Delay Between 'Switching to the GNSS Priority 0 Mode' and 'Getting GNSS Started' GNSS Fix with/without XTRA 3) 1/1 LPWA Module Series 0 0 1/1 1/1 NOTE 1. Above mentioned 'Load' and 'Unload' mean loading/unloading WWAN/GNSS protocol stack. 2. 1) When the WWAN is loaded successfully (you can query it via AT+QGPSCFG='priority'), the data can be sent. 3. 2) The time used to transfer WWAN data varies depending on the coverage level and the data amount. In this example, 500-byte data were transferred. 4. 3) The TTFF is about 10/30 seconds (with/without XTRA under the open sky, respectively) after a cold start. The data listed in the table above are the positioning time within 2 hours after a hot start. 1.3.4. GNSS/WWAN Priority and PSM In the GNSS priority mode, PSM cannot be configured when GNSS is active. However, it can be configured before starting GNSS. After PSM is configured successfully, the modules are able to enter PSM even when GNSS is active. In the WWAN priority mode, the modules are able to configure and enter PSM regardless of whether GNSS is active or not. For the actual scenario with PSM, see Chapter 4.1. BG95&BG77&BG600L_Series_GNSS_Application_Note 16 / 75 Power ON Register on network Configure GNSS priority mode LPWA Module Series Start GNSS? N Configure PSM Y Configure PSM Fail Success Start GNSS before entering PSM Enter PSM when T3324 times out Figure 3: Configure PSM in GNSS Priority Mode 1.3.5. GNSS/WWAN Priority and eDRX The eDRX can be configured in the GNSS priority mode when GNSS is turned off. However, the eDRX cannot be configured in GNSS priority mode when GNSS is active. In such a case, the modules cannot enter eDRX even if it has been configured successfully before starting GNSS. BG95&BG77&BG600L_Series_GNSS_Application_Note 17 / 75 LPWA Module Series Power ON Register to a network Configure GNSS priority mode Start GNSS? N Configure eDRX Y Configure eDRX Fail Success Start GNSS before entering eDRX Cannot enter eDRX Figure 4: Configure eDRX in GNSS Priority Mode In WWAN priority mode, the modules are able to configure and enter eDRX regardless of whether GNSS is active or not. 1.3.6. Minimum eDRX Cycle Recommendation in WWAN Priority Mode Assuming that a GNSS fix on average takes a maximum of t seconds: t1 = GNSS Unloading Time + WWAN Loading Time + Page Accepting Wake-up Time From test observations, t1 ≈ 1.5 seconds. The recommended minimum eDRX Sleep Cycle should be > (t + t1) seconds. eDRX Sleep Cycle = eDRX Cycle - PTW BG95&BG77&BG600L_Series_GNSS_Application_Note 18 / 75 eDRX Cycle eDRX Sleep Cycle PTW Figure 5: eDRX Diagram LPWA Module Series Table 3: Recommended Minimum eDRX Cycle in WWAN Priority Mode (Unit: s) Network Type Common eDRX Cycles Recommended Minimum eDRX Cycle (Cold start with XTRA) Recommended Minimum eDRX Cycle (Cold start without XTRA ) LTE-M 5.12 10.24 20.48 40.96 61.44 81.92 … 10485.76 10.24 (PTW = 1.28) NB-IoT 20.48 40.96 61.44 163.84 … 20.48 (PTW ≤ 10.24) 61.44 (PTW ≤ 20.48) 61.44 (PTW ≤ 20.48) GSM eDRX not supported / / NOTE 1. The recommended minimum eDRX cycle is based on strong signal conditions. It is necessary to extend the eDRX Sleep Cycle in weak signal conditions. 2. The minimum eDRX Sleep Cycle must be greater than 8/40 seconds (cold start with/without XTRA respectively). 1.4. XTRA Feature The XTRA technology enhances GNSS performance and provides simplified GNSS assistance delivery, including ephemeris, almanac, ionosphere, UTC, health and coarse time assistance for GNSS engine. After activating XTRA, the TTFF (Time to First Fix) can be reduced to about 10 seconds under the open sky. BG95&BG77&BG600L_Series_GNSS_Application_Note 19 / 75 LPWA Module Series 1.4.1. XTRA Configuration Items Select the XTRA file with 1, 3, or 7-day validity via AT+QGPSCFG='xtrafilesize'. With the constellations enabled on the device, the XTRA files are divided into 4 types: GPS + QZSS, GPS + GLONASS, GPS + Galileo, and GPS + BeiDou. The XTRA file size is shown in the following table. Table 4: XTRA File Size File Type & Duration (Validity) GPS + QZSS 7-Day File (kB) 16.1 GPS + GLONASS 24.5 GPS + BeiDou 23.9 GPS + Galileo 25.8 3-Day File (kB) 9.7 14.7 14.6 15.2 1-Day File (kB) 6.5 9.7 9.9 9.9 NOTE The sizes listed in the table above are for illustrative purposes only. 1.4.2. XTRA Time Source The XTRA time format is UTC time. The modules support the following 4 ways to obtain UTC time: ⚫ Inject time manually ⚫ Synchronize NITZ time ⚫ Synchronize GPS time ⚫ Synchronize NTP time The XTRA time is used to check the XTRA file validity and to inject ephemeris data at the current time to GNSS engine. Unless you inject the time manually, the XTRA time is injected automatically before injecting XTRA data. A device starts to first synchronize NITZ time. If NITZ time is not available, the device will then synchronize GPS time. Lastly, if both NITZ and GPS time are not available, the device will try to obtain NTP time. NOTE The NTP time server is time.xtracloud.net. When obtaining NTP time, the module starts a timer of 35 seconds. If the NTP time is not obtained within 35 seconds, the XTRA technology is not available and the module starts GNSS without XTRA. BG95&BG77&BG600L_Series_GNSS_Application_Note 20 / 75 LPWA Module Series 1.4.3. Downloading XTRA File 1.4.3.1. XTRA File Downloading Initiation The XTRA files are located on XTRA servers that are not configurable. To download XTRA file, the data service and the XTRA feature have to be enabled. There are two ways to trigger XTRA file downloading: ⚫ Execute AT+QGPSCFG='xtra_download',1 ⚫ Start GNSS 1) with AT+QGPSCFG='xtra_autodownload',1 When XTRA file downloading is triggered, the module starts a 35-second timer. If no XTRA file is downloaded within 35 seconds, the XTRA technology is not available and the module starts GNSS without XTRA. NOTE 1. 1) To trigger automatic XTRA file downloading when starting GNSS, make sure the feature is enabled with AT+QGPSCFG='xtra_autodownload',1 before starting GNSS. 2. If the XTRA file is downloaded via AT+QGPSCFG='xtra_download',1 successfully, starting GNSS with AT+QGPSCFG='xtra_autodownload',1 will not trigger downloading of the XTRA file again. If no valid XTRA file is available, starting GNSS with AT+QGPSCFG='xtra_autodownload',1 triggers automatic XTRA file downloading. 3. If the network is unavailable when starting GNSS, the module skips XTRA file downloading and starts GNSS without XTRA. 4. The module checks XTRA file validity before downloading. If the existing XTRA file is expired, the module downloads the new XTRA file and then reports the URC +QGPSURC: 'XTRA_DL', indicating the result of XTRA file downloading. Integer type. Downloading process result. 0 XTRA file downloaded successfully -1 Downloading failed 1.4.3.2. Validity Checking When XTRA file downloading is triggered, the module checks the validity of the existing XTRA file. If the existing XTRA file is valid, the module stops downloading the new XTRA file. You can check the validity of the existing XTRA file manually by executing AT+QGPSCFG='xtra_info' (see Chapter 2.3.1.13) or AT+QGPSXTRADATA? (see Chapter 2.3.9). BG95&BG77&BG600L_Series_GNSS_Application_Note 21 / 75 LPWA Module Series 1.4.3.3. Downloading Process After XTRA file downloading is triggered automatically by starting GNSS with AT+QGPSCFG='xtra_autodownload',1 or manually with AT+QGPSCFG='xtra_download',1, the module downloads the XTRA file with 3-day validity 1) by default and then injects the downloaded XTRA file into the GNSS engine. The XTRA file downloading process is shown as follows: Turn on GNSS XTR A enabled? Y Registered to a network？ Y Manually injected time? N NITZ time? N Y Y Y Y GPS time? N NTP time? Y Get NTP time and start a 35s timer NTP time successfully retrieved? N XTRA file vali d? N N Download XTRA file Start a 35s timer N Y Download successful ? Y N Inject XTRA data N Start Positioning End Figure 6: XTRA File Downloading Process BG95&BG77&BG600L_Series_GNSS_Application_Note 22 / 75 LPWA Module Series NOTE 1) You can change the validity of the XTRA file via AT+QGPSCFG='xtrafilesize'. For more information, see Chapter 2.3.1.12. 1.4.3.4. URLs for Downloading XTRA File Through MCU or Browser You can manually download the XTRA file through the following URLs. Note that a special User-Agent used by HTTP protocol is needed to download the XTRA file. The special User-Agent string allows the devices to be recognized and grouped by the XTRA server. User-Agent: TX/9205/65536/-/-/MDM9205/-/QCX3/-/-/-/-/-/46/46/-/2.5/0/NA/0 GPS + QZSS: 7-day file: http://iot1.xtracloud.net/xtra3gj.bin http://iot2.xtracloud.net/xtra3gj.bin http://iot3.xtracloud.net/xtra3gj.bin 3-day file: http://iot1.xtracloud.net/xtra3gj_72h.bin http://iot2.xtracloud.net/xtra3gj_72h.bin http://iot3.xtracloud.net/xtra3gj_72h.bin 1-day file: http://iot1.xtracloud.net/xtra3gj_24h.bin http://iot2.xtracloud.net/xtra3gj_24h.bin http://iot3.xtracloud.net/xtra3gj_24h.bin GPS + GLONASS: 7-day file: http://iot1.xtracloud.net/xtra3gr.bin http://iot2.xtracloud.net/xtra3gr.bin http://iot3.xtracloud.net/xtra3gr.bin 3-day file: http://iot1.xtracloud.net/xtra3gr_72h.bin http://iot2.xtracloud.net/xtra3gr_72h.bin http://iot3.xtracloud.net/xtra3gr_72h.bin 1-day file: http://iot1.xtracloud.net/xtra3gr_24h.bin BG95&BG77&BG600L_Series_GNSS_Application_Note 23 / 75 http://iot2.xtracloud.net/xtra3gr_24h.bin http://iot3.xtracloud.net/xtra3gr_24h.bin GPS + Galileo: 7-day file: http://iot1.xtracloud.net/xtra3ge.bin http://iot2.xtracloud.net/xtra3ge.bin http://iot3.xtracloud.net/xtra3ge.bin 3-day file: http://iot1.xtracloud.net/xtra3ge_72h.bin http://iot2.xtracloud.net/xtra3ge_72h.bin http://iot3.xtracloud.net/xtra3ge_72h.bin 1-day file: http://iot1.xtracloud.net/xtra3ge_24h.bin http://iot2.xtracloud.net/xtra3ge_24h.bin http://iot3.xtracloud.net/xtra3ge_24h.bin GPS + BeiDou: 7-day file: http://iot1.xtracloud.net/xtra3gc.bin http://iot2.xtracloud.net/xtra3gc.bin http://iot3.xtracloud.net/xtra3gc.bin 3-day file: http://iot1.xtracloud.net/xtra3gc_72h.bin http://iot2.xtracloud.net/xtra3gc_72h.bin http://iot3.xtracloud.net/xtra3gc_72h.bin 1-day file: http://iot1.xtracloud.net/xtra3gc_24h.bin http://iot2.xtracloud.net/xtra3gc_24h.bin http://iot3.xtracloud.net/xtra3gc_24h.bin LPWA Module Series 1.4.4. XTRA Operating Procedures The XTRA file needs to be updated regularly. When triggering new XTRA file downloading with AT+QGPSCFG='xtra_download',1 or by starting GNSS with AT+QGPSCFG='xtra_autodownload',1, the module checks the validity of the existing XTRA file. In that case, if the existing XTRA file has expired, the new XTRA file is downloaded and injected automatically. If, however, the XTRA file is downloaded manually through MCU or browser, then you need to manually inject the new XTRA file into the GNSS engine before starting GNSS. BG95&BG77&BG600L_Series_GNSS_Application_Note 24 / 75 LPWA Module Series 1.4.4.1. XTRA File Downloading Triggered with AT+QGPSCFG='xtra_download',1 Step 1: Enable the XTRA feature via AT+QGPSXTRA=1 and then restart the module to activate the features. Step 2: Check the network registration status via AT+CGEG? or AT+CEREG? before triggering the XTRA file downloading. Step 3: Configure APN via AT+QGPSCFG='xtra_apn'. This step is optional. Step 4: Check XTRA time via AT+QGPSXTRATIME?. If there is no XTRA time, inject XTRA time manually. Step 5: Execute AT+QGPSCFG='xtra_download',1 to trigger XTRA file downloading. Step 6: Start GNSS via AT+QGPS=1. For more detailed information about AT+CGEG? or AT+CEREG?, see document [1]. 1.4.4.2. Automatic XTRA File Downloading by Starting GNSS Step 1: Enable the XTRA feature via AT+QGPSXTRA=1 and enable automatic XTRA file downloading upon GNSS starting via AT+QGPSCFG='xtra_autodownload',1. Then restart the module to activate the features. Step 2: Check the network registration status via AT+CGEG? or AT+CEREG? before triggering the XTRA file downloading. Step 3: Configure APN via AT+QGPSCFG='xtra_apn'. This step is optional. Step 4: Check XTRA time via AT+QGPSXTRATIME?. If there is no XTRA time, inject XTRA time manually. Step 5: Start GNSS via AT+QGPS=1 to trigger automatic downloading of XTRA file. For more detailed information about AT+CGEG? or AT+CEREG?, see document [1]. 1.4.4.3. XTRA File Downloading Through MCU or Browser Step 1: Enable the XTRA feature via AT+QGPSXTRA and then restart the module to activate the feature. Step 2: Query and confirm the validity of the existing XTRA file via AT+QGPSXTRADATA?. If the existing XTRA file has expired, perform Steps 3–7; if the XTRA file is valid, perform Steps 5 and 7. Step 3: Download the XTRA file to the module via URLs listed in Chapter 1.4.3.4. Step 4: Store the downloaded XTRA file to UFS or EUFS via AT+QFUPL, see document [2]. Step 5: Check XTRA time via AT+QGPSXTRATIME?. If there is no XTRA time, inject XTRA time manually. Step 6: Inject the downloaded XTRA file into GNSS engine via AT+QGPSXTRADATA. Step 7: Start GNSS via AT+QGPS=1. BG95&BG77&BG600L_Series_GNSS_Application_Note 25 / 75 LPWA Module Series 2 Description of GNSS AT Commands 2.1. AT Command Introduction 2.1.1. Definitions • Carriage return character. • Line feed character. • Parameter name. Angle brackets do not appear on the command line. • [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. • Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 4: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_GNSS_Application_Note 26 / 75 LPWA Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 2.3. AT Command Description 2.3.1. AT+QGPSCFG Configure GNSS This command queries and configures various GNSS settings, including the NMEA output port and output types of NMEA sentences. AT+QGPSCFG Configure GNSS Test Command AT+QGPSCFG=? Response: +QGPSCFG: 'outport',(list of supported s),(list of supported s) +QGPSCFG: 'gnssconfig',(range of supported s) +QGPSCFG: 'nmeafmt',(list of supported s) +QGPSCFG: 'gpsnmeatype',(range of supported s) +QGPSCFG: 'glonassnmeatype',(range of supported s) +QGPSCFG: 'galileonmeatype',(range of supported s) +QGPSCFG: 'beidounmeatype',(range of supported s) +QGPSCFG: 'qzssnmeatype',(range of supported s) +QGPSCFG: 'nmeasrc',(list of supported s) +QGPSCFG: 'autogps',(list of supported s) +QGPSCFG: 'priority',(list of supported s),(list of supported s) +QGPSCFG: 'xtrafilesize',(list of supported s) +QGPSCFG: 'xtra_info' +QGPSCFG: 'gpsdop' +QGPSCFG: 'nmea_epe',(list of supported s) +QGPSCFG: 'estimation_error' +QGPSCFG: 'xtra_apn',(list of supported s), BG95&BG77&BG600L_Series_GNSS_Application_Note 27 / 75 Characteristics LPWA Module Series +QGPSCFG: 'xtra_download',(list of supported s) +QGPSCFG: 'xtra_autodownload',(list of supported s) +QGPSCFG: 'test_mode',(list of supported s) +QGPSCFG: 'xtra_ntp',(list of supported s) OK / 2.3.1.1. AT+QGPSCFG='outport' Configure NMEA Output Port This command queries and configures the NMEA output port and the port baud rate. AT+QGPSCFG='outport' Configure NMEA Output Port Write Command AT+QGPSCFG='outport'[,[,]] Response If the optional parameters are omitted, query the current setting. +QGPSCFG: 'outport',[,] OK If any of the optional parameters is specified, set the NMEA output port and the port baud rate when is 'uartnmea' or 'auxnmea'. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter String type. NMEA output port. 'none' Close NMEA sentence output 'usbnmea' Output via USB NMEA port 'uartnmea' Output via GNSS UART port 'auxnmea' Output via debug UART port Integer type. Baud rate of GNSS UART and debug UART port. Unit: bps. 4800 9600 19200 BG95&BG77&BG600L_Series_GNSS_Application_Note 28 / 75 LPWA Module Series 38400 57600 115200 230400 460800 921600 Integer type. Error code of an operation. See Chapter 6 for details. NOTE 1. The is available only when is 'uartnmea' or 'auxnmea'. 2. When is 4800 or 9600, data loss may occur if a large amount of NMEA sentences are output. 2.3.1.2. AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations This command queries and configures the supported GNSS constellations of the module. AT+QGPSCFG='gnssconfig' Configure Supported GNSS Constellations Write Command Response AT+QGPSCFG='gnssconfig'[,] +QGPSCFG: 'gnssconfig', OK If the optional parameter is specified, configure the supported GNSS constellations. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration will be saved automatically. Parameter Integer type. Supported GNSS constellation. 1 GPS + GLONASS 2 GPS + BeiDou 3 GPS + Galileo BG95&BG77&BG600L_Series_GNSS_Application_Note 29 / 75 LPWA Module Series 4 GPS + QZSS 5 Variable. One of the options (1–4) is selected based on MCC of the camped network. Integer type. Error code of an operation. See Chapter 6 for details. NOTE If =5, the constellation is selected based on Mobile Country Code (MCC) of camped network: MCC United States/Russia/Default Europe and relevant regions China Japan and relevant regions Constellations GPS + GLONASS GPS + Galileo GPS + BeiDou GPS + QZSS 2.3.1.3. AT+QGPSCFG='nmeafmt' Configure NMEA Protocol Standard This command queries and configures the protocol standard of NMEA sentences. AT+QGPSCFG='nmeafmt' Configure NMEA Protocol Standard Write Command AT+QGPSCFG='nmeafmt'[,] Response If the optional parameter is omitted, query the current setting. +QGPSCFG: 'nmeafmt', OK If the optional parameter is specified, set the NMEA protocol standard. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. BG95&BG77&BG600L_Series_GNSS_Application_Note 30 / 75 LPWA Module Series Parameter Integer type. NMEA protocol standards. 0 NMEA output sentences conform to Qualcomm standards. 1 NMEA output sentences conform to the NMEA 0183 version 4.10. Integer type. Error code of an operation. See Chapter 6 for details. NOTE For details of NMEA sentences in Qualcomm standards, please refer to Chapter 1.2. NMEA sentences in Qualcomm standards and that in NMEA 0183 version 4.10 standard differ from each other only in the talker ID of RMC, GGA and VTG sentences. 2.3.1.4. AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences This command queries and configures the output type of GPS NMEA sentences. AT+QGPSCFG='gpsnmeatype' Configure Output Type of GPS NMEA Sentences Write Command AT+QGPSCFG='gpsnmeatype'[,] Response If the optional parameter is omitted, query the current setting. +QGPSCFG: 'gpsnmeatype', OK If the optional parameter is specified, set the output type of GPS NMEA sentences. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Output type of GPS NMEA sentences by ORed. Range: 0–31. 0 Disable 1 GGA 2 RMC 4 GSV BG95&BG77&BG600L_Series_GNSS_Application_Note 31 / 75 LPWA Module Series 8 GSA 16 VTG 31 All of the above five types Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.5. AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences This command queries and configures the output type of GLONASS NMEA sentences. AT+QGPSCFG='glonassnmeatype' Configure Output Type of GLONASS NMEA Sentences Write Command Response AT+QGPSCFG='glonassnmeatype'[, If the optional parameter is omitted, query the current setting. ] +QGPSCFG: 'glonassnmeatype', OK If the optional parameter is specified, set the output type of GLONASS NMEA sentences. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Output type of GLONASS NMEA sentences by ORed. Range: 0–3. 0 Disable 1 GSV 2 GSA 3 GSV + GSA Integer type. Error code of an operation. See Chapter 6 for details. BG95&BG77&BG600L_Series_GNSS_Application_Note 32 / 75 LPWA Module Series 2.3.1.6. AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences This command queries and configures the output type of Galileo NMEA sentences. AT+QGPSCFG='galileonmeatype' Configure Output Type of Galileo NMEA Sentences Write Command Response AT+QGPSCFG='galileonmeatype'[,< If the optional parameter is omitted, query the current setting. Galileo_NMEA_type>] +QGPSCFG: 'galileonmeatype', OK If the optional parameter is specified, set the output type of Galileo NMEA sentences. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Output type of Galileo NMEA sentences by ORed. Range: 0–3. 0 Disable 1 GSV 2 GSA 3 GSV + GSA Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.7. AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences This command queries and configures the output type of BeiDou NMEA sentences. AT+QGPSCFG='beidounmeatype' Configure Output Type of BeiDou NMEA Sentences Write Command Response AT+QGPSCFG='beidounmeatype'[,< If the optional parameter is omitted, query the current setting. BeiDou_NMEA_type>] +QGPSCFG: 'beidounmeatype', OK BG95&BG77&BG600L_Series_GNSS_Application_Note 33 / 75 LPWA Module Series Maximum Response Time Characteristics If the optional parameter is specified, set the output type of BeiDou NMEA sentences. OK If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Output type of BeiDou NMEA sentences by ORed. Range: 0–3. 0 Disable 1 GSA 2 GSV 3 GSA + GSV Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.8. AT+QGPSCFG='qzssnmeatype' Configure Output Type of QZSS NMEA Sentences This command queries and configures the output type of QZSS NMEA sentences. AT+QGPSCFG='qzssnmeatype' Configure Output Type of QZSS NMEA Sentences Write Command AT+QGPSCFG='qzssnmeatype'[,] Response If the optional parameter is omitted, query the current setting. +QGPSCFG: 'qzssnmeatype', OK If the optional parameter is specified, set the output type of QZSS NMEA sentences. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. BG95&BG77&BG600L_Series_GNSS_Application_Note 34 / 75 LPWA Module Series Parameter Integer type. Output type of QZSS NMEA sentences by ORed. Range: 0–3. 0 Disable 1 GSA 2 GSV 3 GSA + GSV Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.9. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA This command enables/disables the acquisition of NMEA sentences via AT+QGPSGNMEA and queries the current settings. AT+QGPSCFG='nmeasrc' Enable/Disable Acquisition of NMEA Sentences via AT+QGPSGNMEA Write Command Response AT+QGPSCFG='nmeasrc'[,] +QGPSCFG: 'nmeasrc', OK If the optional parameter is specified, set whether to enable the acquisition of NMEA sentences via AT+QGPSGNMEA. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Sets whether to acquire the original NMEA sentences via AT+QGPSGNMEA. 0 Disable 1 Enable Integer type. Error code of an operation. See Chapter 6 for details. BG95&BG77&BG600L_Series_GNSS_Application_Note 35 / 75 LPWA Module Series 2.3.1.10. AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically This command enables/disables the automatic running of GNSS after the module is powered on, or queries the current settings. AT+QGPSCFG='autogps' Enable/Disable GNSS to Run Automatically Write Command AT+QGPSCFG='autogps'[,] Response If the optional parameter is omitted, query the current setting. +QGPSCFG: 'autogps', OK If the optional parameter is specified, enable/disable the automatic running of GNSS. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration will be saved automatically. Parameter Integer type. Enable/disable GNSS to run automatically after the module is powered on. 0 Disable GNSS to run automatically 1 Enable GNSS to run automatically Integer type. Error code of an operation. See Chapter 6 for details. NOTE 1. GNSS runs automatically with a high positioning accuracy and 1 Hz fix rate. 2. After enabling this function, the module may fail to register to a network, since the module cannot search the network when GNSS is active and in high priority. BG95&BG77&BG600L_Series_GNSS_Application_Note 36 / 75 LPWA Module Series 2.3.1.11. AT+QGPSCFG='priority' Set GNSS or WWAN Priority Mode This command sets the GNSS or WWAN priority mode or queries the current settings. AT+QGPSCFG='priority' Set GNSS or WWAN Priority Mode Write Command AT+QGPSCFG='priority'[,[,]] Response If the optional parameters are omitted, query the current setting. +QGPSCFG: 'priority',, OK If any of the optional parameters is specified, set the GNSS or priority mode. OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. Whether to save the configuration is decided by . Parameter Integer type. Switch between GNSS and WWAN priority mode. 0 GNSS priority mode 1 WWAN priority mode Integer type. Choose whether to save the configuration to NVRAM. 0 Do not save to NVRAM 1 Save to NVRAM Integer type. GNSS/WWAN state. 0 WWAN/GNSS in unloaded state 1 WWAN in pending state 2 GNSS in pending state 3 WWAN in loaded state 4 GNSS in loaded state Integer type. Error code of an operation. See Chapter 6 for details. NOTE 1. The data service can be used only when the is 3, while GNSS can work only when the is 4. BG95&BG77&BG600L_Series_GNSS_Application_Note 37 / 75 LPWA Module Series 2. If GNSS is not active, should always be 3; when GNSS is active, changes to 4. 2.3.1.12. AT+QGPSCFG='xtrafilesize' Select XTRA File to be Downloaded This command selects the XTRA file to be downloaded. AT+QGPSCFG='xtrafilesize' Select XTRA File to be Downloaded Write Command AT+QGPSCFG='xtrafilesize'[,] Response If the optional parameter is omitted, the command queries the current setting. +QGPSCFG: 'xtrafilesize', OK If the optional parameter is specified, the command selects the XTRA file to be downloaded: OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module reboots. The configuration is saved automatically. Parameter Integer type. XTRA file type. 1 Download the XTRA file with 1-day validity 3 Download the XTRA file with 3-day validity 7 Download the XTRA file with 7-day validity Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.13. AT+QGPSCFG='xtra_info' Query the Existing XTRA File Information This command queries the existing XTRA file information. You can use the command to manually check the validity of the XTRA file. BG95&BG77&BG600L_Series_GNSS_Application_Note 38 / 75 LPWA Module Series AT+QGPSCFG='xtra_info' Query the Existing XTRA File Information Write Command AT+QGPSCFG='xtra_info' Response +QGPSCFG: 'xtra_info',, OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter Integer type. Remaining validity term of the XTRA file. Range: 0–168. Unit: hour. Integer type. Validity start date of the XTRA file in the UTC format. Format: 'YYYY/MM/DD,hh:mm:ss'. Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.14. AT+QGPSCFG='gpsdop' Query GNSS DOP Value This command queries GNSS DOP value. AT+QGPSCFG='gpsdop' Query GNSS DOP value Write Command AT+QGPSCFG='gpsdop' Response +QGPSCFG: 'gpsdop',,, OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms // Parameter Float type. Position Dilution of Precision. Float type. Horizontal Dilution of Precision. Float type. Vertical Dilution of Precision. Integer type. Error code of an operation. See Chapter 6 for details. BG95&BG77&BG600L_Series_GNSS_Application_Note 39 / 75 LPWA Module Series 2.3.1.15. AT+QGPSCFG='estimation_error' Get Estimation Error This command retrieves the estimation error. AT+QGPSCFG='estimation_error' Get Estimation Error Write Command AT+QGPSCFG='estimation_error' Response +QGPSCFG: 'estimation_error',,, , OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter Float type. Horizontal estimated position error. Unit: meter. Float type. Vertical estimated position error. Unit: meter. Float type. Horizontal estimated velocity error. Unit: m/s. Float type. Estimated heading error. Unit: degree. Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.16. AT+QGPSCFG='nmea_epe' Enable/Disable the Output of EPE NMEA Sentences This command enables or disables the output of EPE NMEA sentences which includes the GNSS receiver’s estimated accuracy. AT+QGPSCFG='nmea_epe' Enable/Disable the Output of EPE NMEA Sentences Write Command AT+QGPSCFG='nmea_epe'[,] Response If the optional parameter is omitted, query the current setting. +QGPSCFG: 'nmea_epe', OK If the optional parameter is specified, enable or disable the NMEA message output of the receiver’s estimated accuracy. OK If there is any error related to ME functionality: BG95&BG77&BG600L_Series_GNSS_Application_Note 40 / 75 LPWA Module Series Maximum Response Time Characteristics +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. Enable/disable the output of EPE NMEA sentences. 0 Disable 1 Enable. Sentence format: $PQEPE,,,,,,,* String type. UTC time. Format: 'hhmmss.ss'. String type. Indication of data validity. A Valid V Invalid Float type. Horizontal dilution of precision. Float type. Horizontal estimated position error. Unit: meter. Float type. Vertical estimated position error. Unit: meter. Float type. Horizontal estimated velocity error. Unit: m/s. Float type. Estimated heading error. Unit: degree. Hexadecimal type. The checksum is the XOR of all bytes between '$' and '*' (not including the delimiters themselves). Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.17. AT+QGPSCFG='xtra_apn' Configure APN Settings of XTRA File This command configures APN settings of the XTRA file. AT+QGPSCFG='xtra_apn' Configure APN Settings of XTRA File Write Command AT+QGPSCFG='xtra_apn'[,,] Response If the optional parameters are omitted, query the current setting. +QGPSCFG: 'xtra_apn',, OK If the optional parameters are specified, configure the APN settings of the XTRA file. OK If there is any error related to ME functionality: BG95&BG77&BG600L_Series_GNSS_Application_Note 41 / 75 LPWA Module Series Maximum Response Time Characteristics +CME ERROR: 300 ms The command takes effect immediately. The configuration will be saved automatically. Parameter Integer type. IP family type. 0 IPv4 1 IPv6 String type. Access point name. Integer type. Error code of an operation. See Chapter 6 for details. NOTE There is no need to configure the APN again if the APN settings of the XTRA file have already been configured via AT+CGDCONT. 2.3.1.18. AT+QGPSCFG='xtra_download' Trigger XTRA File Downloading This command triggers XTRA file downloading. AT+QGPSCFG='xtra_download' Trigger XTRA File Downloading Write Command AT+QGPSCFG='xtra_download', Response OK +QGPSURC: 'XTRA_DL', Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. Parameter Integer type. Operation mode. 1 Trigger XTRA file downloading. Integer type. The result of the download process. 0 XTRA file downloaded successfully. BG95&BG77&BG600L_Series_GNSS_Application_Note 42 / 75 LPWA Module Series -1 Downloading failed Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.19. AT+QGPSCFG='xtra_autodownload' Enable/Disable Automatic Downloading of XTRA File This command enables or disables the automatic downloading of XTRA file upon GNSS starting. AT+QGPSCFG='xtra_autodownload' Enable/Disable Automatic Downloading of XTRA File Write Command AT+QGPSCFG='xtra_autod ownload'[,] Response If the optional parameter is omitted, query the current setting. +QGPSCFG: 'xtra_autodownload', OK If the optional parameter is specified, enable or disable the automatic downloading of XTRA file. OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration will be saved automatically. Parameter Enable/disable automatic downloading of XTRA file upon GNSS starting. 0 Disable 1 Enable Integer type. Error code of an operation. See Chapter 6 for details. 2.3.1.20. AT+QGPSCFG='test_mode' Enable/Disable XTRA Test Mode This command enables/disables the XTRA test mode. BG95&BG77&BG600L_Series_GNSS_Application_Note 43 / 75 LPWA Module Series AT+QGPSCFG='test_mode' Enable/Disable XTRA Test Mode Write Command AT+QGPSCFG='test_mode'[,] Response If the optional parameter is omitted, query the current setting. +QGPSCFG: 'test_mode', OK If the optional parameter is specified, enable or disable the XTRA test mode. OK Maximum Response Time Characteristics If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration will be saved automatically. Parameter Integer type. Enable/disable the XTRA test mode. 0 Disable 1 Enable Integer type. Error code of an operation. See Chapter 6 for details. NOTE 1. When the XTRA test mode is enabled, the number of XTRA file downloading attempt is unlimited. 2. The XTRA test mode is typically used when you test GNSS cold start performance with the XTRA feature enabled. 2.3.1.21. AT+QGPSCFG='xtra_ntp' Enable/Disable Time Synchronization from NTP Server This command enables or disables the time synchronization from NTP server after downloading the XTRA file. AT+QGPSCFG='xtra_ntp' Enable/Disable Time Synchronization from NTP Server Write Command AT+QGPSCFG='xtra_ntp'[, ] Response If the optional parameter is omitted, query the current setting. +QGPSCFG: 'xtra_ntp', BG95&BG77&BG600L_Series_GNSS_Application_Note 44 / 75 LPWA Module Series Maximum Response Time Characteristics OK If the optional parameter is specified, enable or disable time synchronization from NTP server after downloading the XTRA file. OK If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration will be saved automatically. Parameter Integer type. Enable/disable time synchronization from NTP server after downloading the XTRA file. 0 Disable 1 Enable Integer type. Error code of an operation. See Chapter 6 for details. NOTE 1. This configuration takes effect for both manual and automatic downloading of XTRA file. 2. Before XTRA file downloading, you can execute AT+QGPSCFG='xtra_ntp' to enable time synchronization with NTP server. If the file downloading failed due to network or other reasons, GNSS will start positioning after about 35 s. 2.3.2. AT+QGPS Turn on GNSS This command turns on the GNSS function. When is 0, the GNSS continuously gets a position fix and is always on. In that case, you can turn off the GNSS with the AT+QGPSEND. If is not zero, the GNSS is turned off automatically when reaches the specified value. AT+QGPS Turn on GNSS Test Command AT+QGPS=? Response +QGPS: (list of supported s)[,(range of supported s)[,(range of supported s)[,(list of supported s)[,(range of supported s)]]]] OK BG95&BG77&BG600L_Series_GNSS_Application_Note 45 / 75 LPWA Module Series Read Command AT+QGPS? Response +QGPS: Write Command AT+QGPS=[,[,[,[,] ]]] OK Response OK [+QGPSURC: 'XTRA_DL',] Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. GNSS state. 0 GNSS OFF 1 GNSS ON Integer type. GNSS working mode. 1 Stand-alone mode Integer type. The desired level of accuracy acceptable for fix computation. 1 Low Accuracy (1000 m) 2 Medium Accuracy (500 m) 3 High Accuracy (50 m) Integer type. Number of positioning or continuous positioning attempts. Range: 0–1000. Default value: 0. 0 indicates continuous positioning. Other values indicate the number of positioning attempts. When the value reaches the specified number of attempts, the GNSS will be stopped. The interval between the first- and second-time positioning. Unit: second. If < 1, it is a float type. Available options: 0.1 0.2 0.5 If ≥ 1, it is an integer type. Range: 1–65535. Default value: 1. Integer type. Accuracy threshold. GNSS NMEA sentences will not be outputted if the accuracy is less than . 0 means disable this function. Range: 0–1000. Default value: 0. Unit: meter. Integer type. The result of XTRA file downloading. 0 XTRA file downloaded successfully BG95&BG77&BG600L_Series_GNSS_Application_Note 46 / 75 LPWA Module Series -1 Downloading failed Integer type. Error code of an operation. See Chapter 6 for details. NOTE 1. XTRA file downloading is triggered only when XTRA feature is enabled and the XTRA file has expired. 2. Configure cautiously, because the higher the requested accuracy, the longer the TTFF or the more difficult the positioning. It is recommended to disable accuracy threshold. 2.3.3. AT+QGPSEND Turn off GNSS This command turns off GNSS. It is used when GNSS is turned on and continuously fixes position ( is 0). In such a case, GNSS can be turned off with AT+QGPSEND. You do not need to use this command when is not zero, as GNSS is turned off automatically when reaches the specified value. AT+QGPSEND Turn off GNSS Test Command AT+QGPSEND=? Execution Command AT+QGPSEND Response OK Response OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms / Parameter Integer type. Error code of an operation. See Chapter 6 for details. 2.3.4. AT+QGPSLOC Acquire Positioning Information This command acquires positioning information. Before executing the command, GNSS must be turned on via AT+QGPS. BG95&BG77&BG600L_Series_GNSS_Application_Note 47 / 75 LPWA Module Series AT+QGPSLOC Acquire Positioning Information Test Command AT+QGPSLOC=? Response +QGPSLOC: (range of supported s)[,(range of supported s)] Write Command AT+QGPSLOC=[,] OK Response +QGPSLOC: ,,,,,,,,,, OK Read Command AT+QGPSLOC? If there is any error related to the ME functionality: +CME ERROR: Response Return the positioning information with , in format: ddmm.mmmmN/S,dddmm.mmmmE/W: +QGPSLOC: ,,,,,,,,,, Maximum Response Time Characteristics OK 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Latitude and longitude display format. If ≤ 2, the timer periodically queries and reports. In this case, the command has to be executed only after getting the position fix. 0 , format: ddmm.mmmmN/S,dddmm.mmmmE/W 1 , format: ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W 2 , format: (-)dd.ddddd,(-)ddd.ddddd If ≥ 3, the positioning information is reported according to the frequency of RMC NMEA sentences. There is no restriction regarding command execution ─ the command can be executed at any time. 3 , format: ddmm.mmmmN/S,dddmm.mmmmE/W 4 , format: ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W 5 , format: (-)dd.ddddd,(-)ddd.ddddd Integer type. If <=2, the parameter specifies the time when the queried results are reported. BG95&BG77&BG600L_Series_GNSS_Application_Note 48 / 75 LPWA Module Series Range: 0–3600. Default value: 0. Unit: second. 0 Disable reporting. If >=3, the parameter specifies the reporting mode of the positioning information. Range: 0–2. 0 Disable reporting 1 Report once only when the fix status is changed: from 'not fixed' to 'fixed', or vice versa. 2 Always report. Report according to the output frequency of NMEA sentences. String type. Current UTC time. Format: hhmmss.sss (Quoted from GPGGA sentence). Float type. Latitude. If is 0 or 3: Format: ddmm.mmmmN/S (Quoted from GPGGA sentence) dd 00–89 (Unit: degree) mm.mmmm 00.0000–59.9999 (Unit: minute) N/S North latitude / South latitude If is 1 or 4: Format: ddmm.mmmmmm,N/S (Quoted from GPGGA sentence) dd 00–89 (Unit: degree) mm.mmmmmm 00.000000–59.999999 (Unit: minute) N/S North latitude/South latitude If is 2 or 5: Format: (-)dd.ddddd (Quoted from GPGGA sentence) dd.ddddd -89.99999 to 89.99999 (Unit: degree) - South latitude Float type. Longitude. If is 0 or 3: Format: dddmm.mmmmE/W (Quoted from GPGGA sentence) ddd 000–179 (Unit: degree) mm.mmmm 00.0000–59.9999 (minute) E/W East longitude / West longitude If is 1 or 4: Format: dddmm.mmmmmm,E/W (Quoted from GPGGA sentence) ddd 000–179 (Unit: degree) mm.mmmmmm 00.000000–59.999999 (Unit: minute) E/W East longitude / West longitude If is 2 or 5: Format: (-)dd.ddddd (Quoted from GPGGA sentence) dd.ddddd -179.99999 to 179.99999 (Unit: degree) - West longitude Float type. Horizontal precision. Range: 0.5–99.9 (Quoted from GPGGA sentence). Float type. The altitude of the antenna away from the sea level, accurate to one decimal place. Unit: meter. (Quoted from GPGGA sentence) Integer type. GNSS positioning mode (Quoted from GNGSA/GPGSA sentence). BG95&BG77&BG600L_Series_GNSS_Application_Note 49 / 75 LPWA Module Series 2 2D positioning 3 3D positioning String type. Course Over Ground based on true north. Format: ddd.mm (Quoted from GPVTG sentence). ddd 000–359 (Unit: degree) mm 00–59 (Unit: minute) Float type. Speed over ground. Format: xxxx.x. Unit: Km/h. Accurate to one decimal place (Quoted from GPVTG sentence). Float type. Speed over ground. Format: xxxx.x. Unit: knots. Accurate to one decimal place (Quoted from GPVTG sentence). String type. UTC time when fixing position. Format: ddmmyy (Quoted from GPRMC sentence). Integer type. Number of satellites. Range: 00–12 (Quoted from GPGGA sentence). Integer type. Error code of an operation. See Chapter 6 for details. NOTE The response of AT+QGPSLOC? is the same as that of AT+QGPSLOC=0. 2.3.5. AT+QGPSGNMEA Acquire NMEA Sentences This command acquires NMEA sentences. Before using this command, turn on the GNSS via AT+QGPS, and set of AT+QGPSCFG='nmeasrc' to 1. The sentence output can also be disabled via AT+QGPSCFG='gpsnmeatype',0, AT+QGPSCFG= 'glonassnmeatype',0, AT+QGPSCFG='galileonmeatype',0 and AT+QGPSCFG='beidounmeatyp e',0. AT+QGPSGNMEA Acquire NMEA Sentences Test Command AT+QGPSGNMEA=? Response +QGPSGNMEA: (list of supported s) Write Command Acquire GGA sentences AT+QGPSGNMEA='GGA' OK Response +QGPSGNMEA: OK If there is any error related to the ME functionality: +CME ERROR: BG95&BG77&BG600L_Series_GNSS_Application_Note 50 / 75 Write Command Acquire RMC sentences AT+QGPSGNMEA='RMC' Write Command Acquire GSV sentences AT+QGPSGNMEA='GSV' Write Command Acquire GSA sentences AT+QGPSGNMEA='GSA' Write Command Acquire VTG sentences AT+QGPSGNMEA='VTG' Maximum Response Time Characteristics LPWA Module Series Response +QGPSGNMEA: OK If there is any error related to the ME functionality: +CME ERROR: Response +QGPSGNMEA: OK If there is any error related to the ME functionality: +CME ERROR: Response +QGPSGNMEA: OK If there is any error related to the ME functionality: +CME ERROR: Response +QGPSGNMEA: OK If there is any error related to the ME functionality: +CME ERROR: 300 ms / Parameter GGA sentences. RMC sentences. GSV sentences. GSA sentences. VTG sentences. Integer type. Error code of an operation. See Chapter 6 for details. 2.3.6. AT+QCFGEXT Query and Configure Extended Settings This command queries and configures various extended settings of the module. BG95&BG77&BG600L_Series_GNSS_Application_Note 51 / 75 LPWA Module Series AT+QCFGEXT Query and Configure Extended Settings Test Command AT+QCFGEXT=? Response +QCFGEXT: 'addgeo',,,,,< lon1>,[,[,,[,,]]] +QCFGEXT: 'deletegeo', +QCFGEXT: 'querygeo', Maximum Response Time Characteristics OK 300 ms / 2.3.6.1. AT+QCFGEXT='addgeo' Add a Geo-fence This command adds a geo-fence or queries the current settings. AT+QCFGEXT='addgeo' Add a Geo-fence Write Command AT+QCFGEXT='addgeo',[,[< mode>,,,, ,[,[,[,,]]]]] Response If all optional parameters are omitted, query the current settings of all geo-fences that have been added. [+QCFGEXT: 'addgeo',,,,, ,,[,[,[,,]]] … +QCFGEXT: 'addgeo',,,,, ,,[,[,[,,]]]] OK If the optional parameters after are omitted, query the current setting of the specified geo-fence. +QCFGEXT: 'addgeo',,,,, ,,[,[,[,,]]] OK If =0, the command adds a circular geo-fence and the parameters after must be omitted. OK If =1, the command adds a circular geo-fence and the parameters after must be omitted. OK BG95&BG77&BG600L_Series_GNSS_Application_Note 52 / 75 LPWA Module Series Maximum Response Time Characteristics If =2, the command adds a triangular geo-fence and the parameters after must be omitted. OK If =3, the command adds a quadrangle geo-fence. All parameters must be specified. OK If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Geo-fence ID. Range: 0–9. Integer type. URC report mode. 0 Disable URC to be reported when entering or leaving the geo-fence 1 Enable URC to be reported when entering the geo-fence 2 Enable URC to be reported when leaving the geo-fence 3 Enable URC to be reported when entering or leaving the geo-fence The URC is shown as below: +QIND: 'GEOFENCE',,,,,,,< course>,,,, URC parameters: The ID of geo-fence that is to be entered or left. The current action of the module. 1 Entering the geo-fence 2 Leaving the geo-fence The UTC time when entering or leaving the geo-fence. Format: yyyy-MM-dd hh:mm:ss The latitude of module when entering or leaving the geo-fence. Unit: degree. The longitude of module when entering or leaving the geo-fence. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. Mean sea level altitude. Unit: meter. Course over ground, relative to true north. Unit: degree. Speed over ground. Unit: m/s. Position dilution of precision. BG95&BG77&BG600L_Series_GNSS_Application_Note 53 / 75 LPWA Module Series Horizontal dilution of precision. Vertical dilution of precision. Integer type. Geo-fence shape. 0 Circularity with center and radius 1 Circularity with center and one point on the circle 2 Triangle 3 Quadrangle The latitude of a point that is defined as the center of the geo-fence circular region or the first point. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. The longitude of a point that is defined as the center of the geo-fence circular region or the first point. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. When is 0, this parameter is a radius. Range: 0–6000000. Unit: meter. When is not 0, this parameter is a latitude. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. If is 0, the parameters after must be omitted. The longitude of the second point. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. If is 1, the parameters after must be omitted. The latitude of the third point. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. The longitude of the third point. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. If is 2, the parameters after must be omitted. The latitude of the fourth point. Unit: degree. Format: ±dd.dddddd. Range: -90.000000 to 90.000000. The longitude of the fourth point. Unit: degree. Format: ±ddd.dddddd. Range: -180.000000 to 180.000000. Integer type. Error code of an operation. See Chapter 6 for details. 2.3.6.2. AT+QCFGEXT='deletegeo' Delete a Geo-fence This command deletes a geo-fence. AT+QCFGEXT='deletegeo' Delete a Geo-fence Write Command AT+QCFGEXT='deletegeo', Response OK Maximum Response Time If there is any error related to the ME functionality: +CME ERROR: 300 ms BG95&BG77&BG600L_Series_GNSS_Application_Note 54 / 75 LPWA Module Series Characteristics The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Geo-fence ID. Range: 0–10. 10 means deleting all geo-fences. Integer type. Error code of an operation. See Chapter 6 for details. 2.3.6.3. AT+QCFGEXT='querygeo' Query the Position with Respect to Geo-Fence This command queries the position with respect to the geo-fence. AT+QCFGEXT='querygeo' Query the Position with Respect to Geo-Fence Write Command AT+QCFGEXT='querygeo', Response: +QCFGEXT: 'querygeo',, OK Maximum Response Time Characteristics If there is any error related to the ME functionality: +CME ERROR: 300 ms / Parameter Integer type. Geo-fence ID. Range: 0-9. Integer type. Position with respect to the geo-fence. 0 Position unknown 1 Position is inside the geo-fence 2 Position is outside the geo-fence Integer type. Error code of an operation. See Chapter 6 for details. 2.3.7. AT+QGPSXTRA Enable/Disable XTRA Function This command enables/disables XTRA function. AT+QGPSXTRA Enable/Disable XTRA Function Test Command AT+QGPSXTRA=? Response +QGPSXTRA: (list of supported s) BG95&BG77&BG600L_Series_GNSS_Application_Note 55 / 75 LPWA Module Series Read Command AT+QGPSXTRA? Write Command AT+QGPSXTRA= Maximum Response Time Characteristics OK Response +QGPSXTRA: OK Response OK If there is any error related to ME functionality: +CME ERROR: 300 ms The command takes effect after the module is rebooted. The configuration will be saved automatically. Parameter Integer type. Enable/disable XTRA feature. 0 Disable 1 Enable Integer type. Error code of an operation. See Chapter 6 for details. 2.3.8. AT+QGPSXTRATIME Inject XTRA Time This command injects XTRA time to GNSS engine when the module cannot synchronize time from network. Before using this command, enable XTRA feature via AT+QGPSXTRA=1. AT+QGPSXTRATIME Inject XTRA Time Test Command AT+QGPSXTRATIME=? Response +QGPSXTRATIME: 0,,(list of supported s),0, Read Command AT+QGPSXTRATIME? OK Response +QGPSXTRATIME: OK Write Command AT+QGPSXTRATIME=,[,[,,]] If there is any error related to ME functionality: +CME ERROR: Response OK BG95&BG77&BG600L_Series_GNSS_Application_Note 56 / 75 Maximum Response Time Characteristics LPWA Module Series If there is any error related to ME functionality: +CME ERROR: 300 ms / Parameter String type. Injected UTC time. Format: 'YYYY/MM/DD,hh:mm:ss'. e.g. '2020/04/03,15:34:50'. If the queried is empty, it means XTRA time has not been injected yet. Integer type. Operation type. 0 Inject XTRA time String type. Current UTC time to be injected. Format: 'YYYY/MM/DD,hh:mm:ss'. e.g. '2020/04/03,15:34:50'. Integer type. The type of time. 0 Reserved 1 UTC time Reserved. Always 0. Integer type. Uncertainty of time. Range: 1–3600000. Default value: 3500. Unit: millisecond. If this parameter is omitted or less than 3.5 seconds, it will be counted as 3.5 seconds. Integer type. Error code of an operation. See Chapter 6 for details. NOTE The module synchronizes time from network by NITZ automatically and supports querying the injected time via AT+QGPSXTRATIME?. If the XTRA time is not injected, you can inject it manually with this command. 2.3.9. AT+QGPSXTRADATA Inject XTRA File This command injects XTRA data file to GNSS engine. It is used when you are manually downloading XTRA file through MCU or a browser. Before running this command, you must enable XTRA feature, store the valid XTRA file into UFS or EUFS of the module, and inject XTRA time to GNSS engine. The XTRA file stored in UFS or EUFS can be deleted after injecting the XTRA file into GNSS engine. AT+QGPSXTRADATA? returns the injecting result, so the command can be used to check the validity of the XTRA file. AT+QGPSXTRADATA Inject XTRA File Test Command AT+QGPSXTRADATA=? Response +QGPSXTRADATA: BG95&BG77&BG600L_Series_GNSS_Application_Note 57 / 75 LPWA Module Series Read Command AT+QGPSXTRADATA? OK Response +QGPSXTRADATA: , OK Write Command AT+QGPSXTRADATA= If there is any error related to ME functionality: +CME ERROR: Response OK If there is any error related to ME functionality: +CME ERROR: Maximum Response Time 300 ms Characteristics The command takes effect immediately. The configuration will not be saved. Parameter String type. Filename of the XTRA file, e.g. 'UFS:xtra3grc.bin' or 'EUFS:xtra3grc.bin'. Integer type. Validity period of the injected XTRA file. Unit: minute. 1440 For 1-day XTRA file 4320 For 3-day XTRA file 10080 For 7-day XTRA file String type. The starting time of the XTRA file’s validity. Format: 'YYYY/MM/DD,hh:mm:ss', e.g. '2020/07/20,06:00:00'. Integer type. Error code of an operation. See Chapter 6 for details. NOTE The XTRA file expires after the validity period is over: + . 2.3.10. AT+QGPSDEL Delete Assistance Data This command deletes assistance data so as to perform cold start, hot start and warm start of GNSS. The command can only be executed when GNSS is turned off. After deleting the assistance data via this command, cold start of GNSS can be enforced via AT+QGPS. Hot/warm start can also be performed if the corresponding conditions are satisfied. BG95&BG77&BG600L_Series_GNSS_Application_Note 58 / 75 LPWA Module Series AT+QGPSDEL Delete Assistance Data Test Command AT+QGPSDEL=? Response +QGPSDEL: (range of supported ) Write Command AT+QGPSDEL= OK Response OK The maximum response time Characteristics If there is any error related to ME functionality: +CME ERROR: 1 s The command takes effect immediately. The configuration will not be saved. Parameter Integer type. The type of GNSS assistance data to be deleted. 0 Delete all assistance data include XTRA data. Enforce cold start after starting GNSS. 1 Do not delete any data. After starting GNSS, perform hot start if conditions are met. 2 Delete some related data. After starting GNSS, perform warm start if conditions are met. Integer type. Error code of an operation. See Chapter 6 for details. NOTE When performing a cold start, the XTRA file is deleted and cannot be downloaded again for the next 24 hours. You can execute AT+QGPSCFG='test_mode',1 to remove the download limitation. For more information, see Chapter 2.3.1.20. BG95&BG77&BG600L_Series_GNSS_Application_Note 59 / 75 LPWA Module Series 3 Examples 3.1. Turn on/off GNSS Default arguments are used in this example to turn on GNSS. After turning on GNSS, NMEA sentences will be output from 'usbnmea' port by default, and GNSS can be turned off via AT+QGPSEND. AT+QGPS=1 OK //Turn on GNSS. //After turning on GNSS, NMEA sentences will be output from 'usbnmea' port by default. AT+QGPSLOC? //Obtain positioning information. +QGPSLOC: 130618.000,3150.8076N,11711.9039E,0.8,89.5,2,0.00,0.0,0.0,110919,12 OK AT+QGPSEND OK //Turn off GNSS. 3.2. Acquire Positioning Information In the following example, you can see how to acquire the positioning information via AT+QGPSLOC after the GNSS has been turned on and the position fix obtained. AT+QGPS=1 //Turn on GNSS. OK AT+QGPSLOC? +CME ERROR: 516 //Not fixed AT+QGPSLOC? //Obtain positioning information. +QGPSLOC: 130618.000,3150.8076N,11711.9039E,0.8,89.5,2,0.00,0.0,0.0,110919,12 OK AT+QGPSLOC=0 //Set the latitude and longitude display format to ddmm.mmmmN/S,dddmm.mmmmE/W +QGPSLOC: 131050.000,3150.8069N,11711.9032E,1.2,90.7,3,0.00,0.0,0.0,110919,08 BG95&BG77&BG600L_Series_GNSS_Application_Note 60 / 75 LPWA Module Series OK AT+QGPSLOC=1 //Set the latitude and longitude display format to ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W +QGPSLOC: 131117.000,3150.806972,N,11711.903278,E,1.3,90.6,3,0.00,0.0,0.0,110919,07 OK AT+QGPSLOC=2 //Set the latitude and longitude display format to (-)dd.ddddd,(-)ddd.ddddd +QGPSLOC: 131140.000,31.84678,117.19838,1.3,90.5,3,0.00,0.0,0.0,110919,07 OK AT+QGPSLOC=2,1 //Obtain positioning information and enable periodical location report. +QGPSLOC: 131305.000,31.84678,117.19838,1.8,89.9,3,0.00,0.0,0.0,110919,07 OK +QGPSLOC: 131306.000,31.84678,117.19838,1.0,89.9,3,0.00,0.0,0.0,110919,08 +QGPSLOC: 131307.000,31.84678,117.19838,1.0,89.9,3,0.00,0.0,0.0,110919,08 +QGPSLOC: 131308.000,31.84678,117.19838,0.9,89.9,3,0.00,0.0,0.0,110919,08 AT+QGPSLOC=2,0 //Obtain positioning information and disable periodical location report. +QGPSLOC: 131431.000,31.84678,117.19838,0.9,89.7,3,0.00,0.0,0.0,110919,09 OK AT+QGPSLOC=4,1 OK //Set position reporting when the positioning status has changed. //Not fixing → fixing +QGPSLOC:052943.000,3149.314079,N,11706.979269,E,0.8,128.7,3,0.00,0.0,0.0,080720,07 //Fixing → not fixing +QGPSLOC: ,,,,,,,,,, AT+QGPSLOC=4,2 //Set the reporting location information according to the reporting frequency of NMEA sentences +QGPSLOC: 053018.000,3149.309670,N,11706.977340,E,0.8,136.6,3,1.47,2.2,1.2,080720,07 +QGPSLOC: 053019.000,3149.309125,N,11706.978666,E,0.7,136.0,3,0.00,0.0,0.0,080720,08 +QGPSLOC: 053020.000,3149.309125,N,11706.978666,E,0.7,136.0,3,0.00,0.0,0.0,080720,08 BG95&BG77&BG600L_Series_GNSS_Application_Note 61 / 75 AT+QGPSLOC=4,0 OK //Disable location report. LPWA Module Series 3.3. Query Satellite System AT+QGPSCFG='gnssconfig' +QGPSCFG: 'gnssconfig',1 //Query enabled satellite systems //GPS and GLONASS are enabled. OK AT+QGPS=1 //Turn on GNSS. OK AT+QGPSGNMEA='GSV' //GPS GSV sentences +QGPSGNMEA: $GPGSV,4,1,14,02,68,055,16,04,00,000,31,05,64,314,26,07,08,070,18,1*6D +QGPSGNMEA: $GPGSV,4,2,14,09,04,037,30,12,11,228,36,15,16,207,20,19,11,155,14,1*6B +QGPSGNMEA: $GPGSV,4,3,14,25,09,269,20,29,27,316,32,06,26,101,,13,41,177,,1*68 +QGPSGNMEA: $GPGSV,4,4,14,17,00,000,,30,10,091,,1*6D //GLONASS GSV sentences +QGPSGNMEA: $GLGSV,2,1,05,22,32,332,26,20,25,136,13,21,78,073,18,07,57,243,21,1*78 +QGPSGNMEA: $GLGSV,2,2,05,08,10,224,,1*40 OK AT+QGPSCFG='gnssconfig',2 OK //Restarts the module. RDY //Enable GPS and BeiDou. APP RDY AT+QGPSCFG='gnssconfig' +QGPSCFG: 'gnssconfig',2 //Query enabled satellite systems. //GPS and BeiDou are enabled. OK AT+QGPS=1 //Turn on GNSS. OK AT+QGPSGNMEA='GSV' //GPS GSV sentences +QGPSGNMEA: $GPGSV,3,1,11,02,64,089,36,04,00,000,39,05,63,346,45,06,21,113,27,1*6F +QGPSGNMEA: $GPGSV,3,2,11,07,09,059,45,12,02,218,33,15,29,211,30,25,04,257,27,1*64 +QGPSGNMEA: $GPGSV,3,3,11,29,37,307,41,30,16,090,29,13,57,173,,1*59 //BeiDou GSV sentence +QGPSGNMEA: $PQGSV,1,1,03,13,65,343,34,14,72,329,26,21,08,052,42,1*45 BG95&BG77&BG600L_Series_GNSS_Application_Note 62 / 75 LPWA Module Series OK 3.4. Implement Geo-Fence Function AT+QCFGEXT='addgeo',0,3,0,31.826,117.2168,100 //Add a circular geo-fence 0. OK AT+QCFGEXT='addgeo',0 //Query the setting of circular geo-fence 0. +QCFGEXT: 'addgeo',0,3,0,31.826000,117.216800,100.0 OK AT+QCFGEXT='addgeo',7,1,3,31.833348,117.212909,31.826453,117.213248,31.82873,117.222093, 31.833502,117.2208623 //Add a quadrangle geo-fence 7. OK AT+QCFGEXT='addgeo',7 //Query the settings of geo-fence 7. +QCFGEXT: 'addgeo',7,1,3,31.833348,117.212909,31.826453,117.213248,31.828730,117.222093,31.833502,117. 220862 OK AT+QCFGEXT='deletegeo',7 OK AT+QGPS=1 OK AT+QCFGEXT='querygeo',0 +QCFGEXT: 'querygeo',0,1 //Delete geo-fence 7. //Turn on the GNSS engine. //Query the position with respect to geo-fence 0. //The current position is inside the geo-fence 0. OK //When entering the geo-fence 0, this URC is reported. +QIND: 'GEOFENCE',0,1,2017/08/25 08:35:53,31.825179,117.217127,34.0,0.2,13.8,1.1,0.7,0.8 //When leaving the geo-fence 0, this URC is reported. +QIND: 'GEOFENCE',0,2,2017/08/25 08:36:07,31.826951,117.217071,38.0,359.0,13.4,0.9,0.6,0.6 BG95&BG77&BG600L_Series_GNSS_Application_Note 63 / 75 LPWA Module Series 3.5. Procedure to Use XTRA Feature There are three ways to download XTRA files: a) Via AT+QGPSCFG='xtra_download',1 b) By starting GNSS c) Manual download through MCU or browser 3.5.1. XTRA File Downloading Triggered with AT+QGPSCFG='xtra_download',1 AT+QGPSXTRA=1 OK AT+CEREG? +CEREG: 0,1 //Enable XTRA and then restart the module to activate the feature. //Check the network status. OK AT+QGPSXTRATIME? //Check XTRA time. Inject XTRA time if it is not available. +QGPSXTRATIME: '2020/07/20,02:34:47' OK AT+QGPSCFG='xtra_info' //Check whether the existing XTRA file has expired. +QGPSCFG: 'xtra_info',0, '2020/07/16,06:00:00' //XTRA file is expired. OK AT+QGPSCFG='xtra_download',1 OK //Trigger XTRA file downloading. +QGPSURC: 'XTRA_DL',0 //The XTRA file is successfully downloaded. AT+QGPSXTRADATA? //Check the validity of the existing XTRA file. +QGPSXTRADATA: 4320,'2020/07/20,06:00:00' OK AT+QGPS=1 OK //Start GNSS with XTRA. 3.5.2. Automatic XTRA File Downloading by Starting GNSS AT+QGPSXTRA=1 OK AT+QGPSCFG='xtra_autodownload',1 //Enable XTRA feature. //Enable automatic XTRA file downloading upon GNSS starting. BG95&BG77&BG600L_Series_GNSS_Application_Note 64 / 75 LPWA Module Series OK AT+CEREG? +CEREG: 0,1 //Check the network status. OK AT+QGPSXTRATIME? //Check XTRA time. Inject XTRA time if it is not available. +QGPSXTRATIME: '2020/07/20,02:34:47' OK AT+QGPSCFG='xtra_info' //Check whether the existing XTRA file has expired. +QGPSCFG: 'xtra_info',0, '2020/07/16,06:00:00' //XTRA file has expired. OK AT+QGPS=1 OK //Start GNSS to trigger automatic downloading of XTRA file. +QGPSURC: 'XTRA_DL',0 AT+QGPSXTRADATA? //Check the validity of the existing XTRA file. +QGPSXTRADATA: 4320,'2020/07/20,06:00:00' //The XTRA file expires on 2020/07/23,06:00:00. OK 3.5.3. XTRA File Downloading Through MCU or Browser AT+QGPSXTRA=1 OK //Enable XTRA and then restart the module to activate the feature. //Download the XTRA file to PC (or MCU) from the URLs listed in Chapter 1.4.3.4. AT+QFUPL='UFS:xtra3gr.bin',24376 //Select the XTRA file and upload it to the module’s UFS or EUFS via QCOM. For more details about this command, see document [2]. For more details about QCOM tool use and configuration, see document [7]. OK AT+QGPSXTRATIME? //Check XTRA time. +QGPSXTRATIME: '' //There is no XTRA time, so you need to inject it manually. OK AT+QGPSXTRATIME=0,'2020/07/20,07:31:54' OK AT+QGPSXTRADATA='UFS:xtra3gr.bin' OK AT+QGPSXTRADATA? //Inject XTRA time. //Inject the XTRA file. //Check the validity of the existing XTRA file. BG95&BG77&BG600L_Series_GNSS_Application_Note 65 / 75 LPWA Module Series +QGPSXTRADATA: 168,'2020/07/20,06:00:00' OK AT+QFDEL='UFS:xtra3gr.bin' OK AT+QGPS=1 OK //Delete the XTRA file from UFS to save memory. This step is optional. //Start GNSS with XTRA. BG95&BG77&BG600L_Series_GNSS_Application_Note 66 / 75 LPWA Module Series 4 Use Cases Considering the complexity of GNSS feature of the modules and the fact that those use cases listed below cannot cover all tracking applications and extreme cases, we strongly suggest that you provide the specific application cases to Quectel Technical Support team for a review via support@quectel.com or http://e-service.quectel.com. 4.1. PSM Enabled The recommended procedure for using the PSM is given below. For more information on PSM implementation, see document [6]. 1. Power on the module and then register to a network 2. Configure PSM (such as T3412 = 6 hours, T3324 = 10 minutes) 3. Wake up from PSM 4. Set the module into the GNSS priority mode 5. Turn on GNSS and get a position fix 6. Switch to the WWAN priority mode 7. Report positioning information and other data to the server 8. Enter PSM 9. Repeat 3-8 4.2. Recommended Mode: WWAN Priority Mode The WWAN priority mode is recommended when there is a high demand for data transmission services. Before using the WWAN priority mode, make sure that both conditions are satisfied: ⚫ The eDRX is used, and the eDRX cycle is longer than TTFF ⚫ There is a low demand for GNSS positioning The recommended procedure for using the WWAN priority mode: 1. Configure the eDRX cycle that is sufficiently longer than TTFF 1) 2. Wake up from the sleep mode 3. Turn on GNSS (GNSS session may be deferred to eDRX) BG95&BG77&BG600L_Series_GNSS_Application_Note 67 / 75 4. Obtain the GNSS positioning information 5. Turn off GNSS or switch to the WWAN priority mode2 6. Report position information to the server 7. Return to the sleep mode 8. Repeat 2-7 LPWA Module Series NOTE 1. 1) For details of TTFF values, refer to the corresponding hardware design manuals. 2. Step 5 is optional, as it depends on the practical applications and the current consumption requirements. 4.3. Recommended Mode: GNSS Priority Mode The GNSS priority mode is recommended when there is high demand for GNSS positioning and low demand for data transmission. The recommended procedure for using the GNSS priority mode: 1. Wake up from the sleep mode 2. Turn on GNSS (GNSS session starts immediately) 3. Collect data from sensors and obtain the GNSS positioning information 4. Turn off GNSS or switch to WWAN priority mode 5. Report sensor data and positioning information to the server 6. Return to sleep mode 7. Repeat 1–6 NOTE It will take at least 44.5 seconds for one cycle if you transfer 500 bytes of data: TCP connect time (8 s) + Time used to send 500 bytes of data (4.5 s) + TCP close time (10 s) + GNSS fix time (30 s) + delay time (2 s). If XTRA is enabled, this time can be reduced to 24.5 s. 4.4. Limitations of GNSS There may be limitations on reporting positioning and sensor data in applications where the reporting is performed following the steps below. A success of the query on step 7 cannot be guaranteed every time, because the page may be lost when GNSS is in active status with GNSS priority. In addition, obtaining a position on time cannot be guaranteed either if WWAN is preferential. In these cases, it is recommended BG95&BG77&BG600L_Series_GNSS_Application_Note 68 / 75 LPWA Module Series to select a solution where GNSS and WWAN could work simultaneously, either Quectel BG96 module, or Quectel BG95/BG77/BG600L-M3 module with an external GNSS module. Procedure 1. Wake up from sleep mode 2. Turn on GNSS (GNSS session started immediately) 3. Collect data from sensors and obtain the GNSS positioning information 4. Turn off GNSS or switch to WWAN priority mode 5. Report sensor data and positioning information to server 6. Return to sleep mode 7. The sensor data and positioning information may be queried from the network side anytime during Steps 2–5 8. Repeat Steps 1–7. BG95&BG77&BG600L_Series_GNSS_Application_Note 69 / 75 LPWA Module Series 5 FAQ 1. Q: Why cannot the module register to a network when the GNSS auto-start feature is enabled with AT+QGPSCFG='autogps',1? A: If your module is in the GNSS priority mode, If GNSS starts automatically when the module powers up, the module will fail to register on network. Please configure the module into WWAN priority mode if GNSS auto-start feature is needed. 2. Q: When GNSS is active and in high priority, the module can detach from the network after executing AT+CFUN=0, but why cannot it register to the network after executing AT+CFUN=1? A: Network detachment has higher priority than GNSS/WWAN, so the module can detach from the network even if the module is in the GNSS priority mode. However, network attachment does not have the same priority as network detachment, so the module cannot register to the network when the module is in the GNSS priority mode. 3. Q: Why reporting sensor data and positioning information sometimes does not work? A: Reporting sensor data and positioning information cannot be guaranteed every time because the page may be lost when GNSS is in the active status with GNSS priority. Additionally, getting position on time cannot be guaranteed either if WWAN is preferential. In these cases, it is recommended to select a solution where GNSS and WWAN could work simultaneously, either Quectel BG96 module, or Quectel BG95/BG77/BG600L module with an external GNSS module. BG95&BG77&BG600L_Series_GNSS_Application_Note 70 / 75 LPWA Module Series 6 Summary of Error Codes The indicates an error related to the GNSS operation. The details about are described in the following table. Table 5: Summary of Error Codes 501 502 503 Description Invalid parameter Operation not supported GNSS subsystem busy 504 Session is ongoing 505 Session not active 506 Operation timeout 507 Function not enabled 508 Time information error 509 XTRA not enabled 512 Validity time is out of range 513 Internal resource error 514 GNSS locked 515 End by E911 516 No fix 517 Geo-fence ID does not exist 518 Sync time failed 519 XTRA file does not exist BG95&BG77&BG600L_Series_GNSS_Application_Note 71 / 75 LPWA Module Series 520 XTRA file on downloading 521 XTRA file is valid 522 GNSS is working 523 Time injection error 524 XTRA file is invalid 549 Unknown error BG95&BG77&BG600L_Series_GNSS_Application_Note 72 / 75 LPWA Module Series 7 Appendix References Table 6: Related Documents Document Name [1] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual [2] Quectel_BG95&BG77&BG600L_Series_FILE_Application_Note [3] Quectel_BG95_Series_Hardware_Design [4] Quectel_BG77_Hardware_Design [5] Quectel_BG600L-M3_Hardware_Design [6] Quectel_BG95&BG77&BG600L_Series_PSM_Application_Note [7] Quectel_QCOM_User_Guide Table 7: Terms and Abbreviations Abbreviation APN BeiDou CNR DOP eDRX EGPRS EPE EUFS FAQ Description Access Point Name BeiDou Navigation Satellite System Carrier-to-Noise Ratio Dilution of Precision Extended Discontinuous Reception Enhanced General Packet Radio Service Estimated Position Error Extended User File Storage Frequently Asked Questions BG95&BG77&BG600L_Series_GNSS_Application_Note 73 / 75 Galileo GGA GLONASS GNSS GPS GSA GSM GSV HDOP ID IPv4 IPv6 LPWA LTE LTE-M MCC MCU ME MO NB-IoT NITZ NMEA NTP NVRAM PS LPWA Module Series Galileo Satellite Navigation System (EU) Global Positioning System Fix Data Global Navigation Satellite System (Russian) Global Navigation Satellite System Global Positioning System GNSS DOP and Active Satellites Global System for Mobile Communications GNSS Satellites in View Horizontal Dilution of Precision Identifier Internet Protocol Version 4 Internet Protocol Version 6 Low-Power Wide Area Long Term Evolution LTE Machine-to-Machine Communications Mobile Country Code Microcontroller Unit/Microprogrammed Control Unit Mobile Equipment Mobile Originated Narrowband Internet of Things Network Identity and Time Zone NMEA (National Marine Electronics Association) 0183 Interface Standard Network Time Protocol Non-Volatile Random-Access Memory Packet Switch BG95&BG77&BG600L_Series_GNSS_Application_Note 74 / 75 PSM PTW QZSS RAT RMC RRC RSRP RSSI Rx TCP TDM TTFF UART UE UFS URL USB UTC VTG Wi-Fi WWAN XOR XTRA LPWA Module Series Power Saving Mode Paging Time Window Quasi-Zenith Satellite System Radio Access Technology Recommended Minimum Specific GNSS Data Radio Resource Control Reference Signal Received Power Received Signal Strength Indicator Receive Transmission Control Protocol Time-Division Multiplexing Time to First Fix Universal Asynchronous Receiver/Transmitter User Equipment User File Storage Uniform Resource Locator Universal Serial Bus Universal Time Coordinated Course over Ground and Ground Speed Wireless Fidelity Wireless Wide Area Network Exclusive OR Auxiliary Positioning Technology Provided by Qualcomm BG95&BG77&BG600L_Series_GNSS_Application_Note 75 / 75

BC20 GNSS 应用指导 NB-IoT/GNSS 模块系列 版本：1.1 日期：2020-09-21 状态：受控文件 www.quectel.com BC20 GNSS 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 53 BC20 GNSS 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-05-29 2020-09-21 作者 水恒兵/ 董海波 董海波 变更表述 初始版本 增加 AGPS 功能说明（第 4 章） 上海移远通信技术股份有限公司 2 / 53 BC20 GNSS 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 Unicore NPL 协议消息 ......................................................................................................................... 7 2.1. 消息的格式 ................................................................................................................................. 7 2.2. 校验和......................................................................................................................................... 8 2.3. 数据类型 ..................................................................................................................................... 8 2.4. 消息定义 ..................................................................................................................................... 9 2.4.1. 通用消息（Common Message） .................................................................................... 9 2.4.1.1. PDTINFO.............................................................................................................. 9 2.4.1.2. RESET................................................................................................................ 10 2.4.2. 配置消息（Configuration Message） ............................................................................11 2.4.2.1. CFGPRT..............................................................................................................11 2.4.2.2. CFGMSG............................................................................................................ 13 2.4.2.3. CFGNAV............................................................................................................. 15 2.4.2.4. CFGNMEA ......................................................................................................... 16 2.4.2.5. CFGSYS............................................................................................................. 17 2.4.2.6. AIDINFO ............................................................................................................. 19 2.4.2.7. CFGCWOUT ...................................................................................................... 20 2.4.3. NMEA 消息（NMEA Message） .................................................................................. 21 2.4.3.1. GGA.................................................................................................................... 22 2.4.3.2. GLL..................................................................................................................... 23 2.4.3.3. GSA .................................................................................................................... 24 2.4.3.4. GSV .................................................................................................................... 25 2.4.3.5. RMC ................................................................................................................... 26 2.4.3.6. VTG .................................................................................................................... 28 2.4.3.7. ZDA .................................................................................................................... 29 2.4.3.8. GST .................................................................................................................... 30 2.4.4. 导航结果消息（Navigation Result Message） ............................................................. 31 2.4.4.1. NAVPOS............................................................................................................. 31 2.4.4.2. NAVVEL.............................................................................................................. 32 2.4.4.3. NAVTIME............................................................................................................ 33 2.4.4.4. NAVACC ............................................................................................................. 34 2.4.5. 其他消息（Misc Message） ......................................................................................... 35 2.4.5.1. ANTSTAT1.......................................................................................................... 35 2.4.5.2. LSF1 ................................................................................................................... 36 2.4.5.3. CWOUT*............................................................................................................. 38 2.5. 默认配置 ................................................................................................................................... 38 2.5.1. 串口配置（CFGPRT）.................................................................................................. 38 上海移远通信技术股份有限公司 3 / 53 BC20 GNSS 应用指导 2.5.2. 2.5.3. 2.5.4. 2.5.5. 2.5.6. 消息输出配置（CFGMSG） ......................................................................................... 39 定位配置（CFGNAV）.................................................................................................. 40 NMEA 配置（CFGNMEA） .......................................................................................... 40 卫星系统配置（CFGSYS） .......................................................................................... 40 干扰检测配置（CFGCWOUT） .................................................................................... 40 3 GNSS AT 命令详解............................................................................................................................. 41 3.1. AT 命令语法.............................................................................................................................. 41 3.1.1. 定义 ............................................................................................................................... 41 3.1.2. AT 命令语句................................................................................................................... 41 3.2. AT 命令详解.............................................................................................................................. 42 3.2.1. AT+QGNSSC 打开/关闭 GNSS.................................................................................. 42 3.2.2. AT+QGNSSRD 获取 GNSS NMEA 语句.................................................................... 43 3.2.3. AT+QGNSSCMD 发送命令至模块 ............................................................................. 44 3.2.4. AT+QGNSSDB 配置 NEMA 语句输出端口................................................................. 45 3.2.5. AT+QGNSSAGPS 启用/禁用 AGPS 功能 .................................................................. 46 4 AGPS 功能说明................................................................................................................................... 48 4.1. AGPS 运行机制........................................................................................................................ 48 4.2. AGPS 操作流程概述................................................................................................................. 48 4.3. AT 命令执行流程 ...................................................................................................................... 48 5 附录 A 参考文档及术语缩写............................................................................................................... 51 6 附录 B 错误码..................................................................................................................................... 53 上海移远通信技术股份有限公司 4 / 53 BC20 GNSS 应用指导 表格索引 表 1：Unicore NPL 协议消息结构 ................................................................................................................ 7 表 2：消息的类别和 ID ............................................................................................................................... 14 表 3：AT 命令及响应类型........................................................................................................................... 41 表 4：参考文档........................................................................................................................................... 51 表 5：术语缩写........................................................................................................................................... 51 表 6：GNSS AT 命令相关错误码................................................................................................................ 53 上海移远通信技术股份有限公司 5 / 53 BC20 GNSS 应用指导 1 引言 移远通信 BC20 模块集成了 GNSS 引擎，支持 GPS、BeiDou、GLONASS*、Galileo*、QZSS*以及 SBAS*导航系统，同时允许多系统联合定位，从而为客户提供快速、准确的高性能定位体验。该模块可广 泛应用于各行各业实现精准定位和导航。 本文档主要介绍 BC20 模块支持的 Unicore NPL 协议消息，以及如何通过 AT 命令配置和使用 BC20 模块的 GNSS 和 AGPS 功能。 备注 '*' 表示正在开发中。 上海移远通信技术股份有限公司 6 / 53 BC20 GNSS 应用指导 2 Unicore NPL 协议消息 2.1. 消息的格式 GNSS 协议中，输入和输出的语句被统称为消息。每条消息均为全 ASCII 字符组成的字符串。 消息的基本格式为： $MSGNAME,data1,data2,data3,…[*Checksum] 表 1：Unicore NPL 协议消息结构 字段 $ MSGNAME data 区 * 长度（字节） 1 变量 变量 1 Checksum 2 2 说明 所有消息均以$（0x24）开始。 消息名。 不定数目的消息数据。 数据域结束符*（0x2A）。 校验和，计算方法为从 $ 起到 * 之间的所有字符（不包 括 $ 和 *）的异或运算，以十六进制表示。 每条消息以回车换行符结束。 大多数的消息名既可以作为输入的消息（即命令），又可以作为输出的信息。同样的消息名作为输入 时，用于设定参数或查询当前的配置；用于输出时，则用于输出接收机信息或配置。 备注 1. 每条消息的总长度不超过 256 个字节。消息名、参数（data 区）和校验和中的字母均不区分大小写。 2. 部分输入命令的个别参数可被省略（在命令描述中被标记为可选）。这些可选参数可以为空，即在两 个逗号之间没有任何字符；可选参数被省略时，其控制的选项将不做改变。 上海移远通信技术股份有限公司 7 / 53 BC20 GNSS 应用指导 2.2. 校验和 消息中 * 之后的两个字符为校验和，校验和的计算方法为从 $ 起到 * 之前的所有字符（不包括$ 和 *） 的异或，格式为十六进制。 输入命令中的校验和为可选项。若输入的命令中包含 * 及校验和字符，则会对校验和进行检查；检查 结果如有不符，则命令不被执行，接收机输出$FAIL 消息并指示校验和错误。若输入的命令中不包含校验 和，则直接执行命令。 若输入命令中的参数为空，且需要添加校验和，应在其后补加逗号进行校验和计算；参数不为空时不 允许额外添加逗号，例如：$PDTINFO,*62。 输出的消息中总会包含校验和。在后面的消息定义中将省略部分协议中关于校验和的说明。 2.3. 数据类型 Unicore NPL 协议中，消息中的数据包含下面几种类型： 1) 字符串（STR） 字符串由最长 32 个 ASCII 字符（和不含在内）组成，如 GPSL1。 2) 无符号整数（UINT） 无符号整数的范围为 0~4294967295，有十进制和十六进制两种表示方法。十进制的无符号整数由 0~9 组成的 ASCII 字符组成，如 123、4291075193。十六进制无符号整数以字符 h 或 H 开始，后面紧接由 0~9 与 a~f 或 A~F 组成的字符串，最长 8 个字符（不含开始的 h 或 H），如 hE10、hE41BA7C0。 3) 有符号整数（INT） 有符号整数由 0~9 和负号组成的 ASCII 字符组成，其范围为-2147483648 至 2147483647。如 123217754、-245278。 4) 双精度浮点（DOUBLE） 双精度浮点数据由 0~9、负号和小数点组成的 ASCII 字符组成，其范围为-2^1023 至 2^1023。如 3.1415926、-9024.12367225。 上海移远通信技术股份有限公司 8 / 53 2.4. 消息定义 2.4.1. 通用消息（Common Message） 2.4.1.1. PDTINFO ⚫ 读取产品信息 类型： 命令 格式： $PDTINFO 参数： 无 举例： $PDTINFO ⚫ 输出产品信息 类型： 输出 格式： $PDTINFO,,,,,, 参数： 参数名 pdtName config hwVer 格式 STR STR STR 单位 - 描述 产品名称 产品配置选项 硬件版本号 BC20 GNSS 应用指导 上海移远通信技术股份有限公司 9 / 53 fwVer PN SN STR STR STR - 固件版本号 - 产品 ID - 序列号 举例： $PDTINFO,N/A,G1B1,VN/A,R3.2.0.0Build5050,N/A,N/A*36 BC20 GNSS 应用指导 2.4.1.2. RESET 复位接收机。 类型： 命令 格式： $RESET,, 参数： 参数名 格式 UINT type 可选 clrMask UINT 可选 单位 - - 描述 复位的类型： 0 = 软件复位 1 = 芯片级复位（看门狗复位） 2 = 板级复位 3 = 接收机停止（暂不支持） 复位时清除接收机保存的信息，对应的 Bit 置 1 代表 复位时清除： Bit 0 = 清除星历 Bit 1 = 预留 Bit 2 = 清除接收机位置和清除接收机时间 Bit 3 = 预留 Bit 4 = 清除电离层修正参数和 UTC 参数 Bit 5 = 预留 Bit 6 = 预留 Bit 7 = 清除历书 几个常用的启动方式： h00 = 热启动 上海移远通信技术股份有限公司 10 / 53 举例： $RESET,0,h01 h01 = 温启动 h85 = 冷启动 BC20 GNSS 应用指导 备注 1. 冷启动复位命令的参数为 h85，复位参数不符会导致接收机启动状态错误。 2. 发生闰秒时，冷启动复位后的接收机可能需要最多 25 分钟同步到 UTC 时间。 2.4.2. 配置消息（Configuration Message） 2.4.2.1. CFGPRT ⚫ 读取端口配置 类型： 命令 格式： $CFGPRT, 参数： 参数名 格式 portID UINT 可选 举例： $CFGPRT,1 单位 - 描述 输出端口号，范围：0~2。 0 = I2C 接口（暂不支持） 1 = 串口 2 = SPI 接口（暂不支持） 若该项为空，则输出当前使用的端口配置。 上海移远通信技术股份有限公司 11 / 53 BC20 GNSS 应用指导 ⚫ 设定/输出端口配置 类型： 设置/输出 格式： $CFGPRT,,,,, 参数： 参数名 格式 单位 portID UINT 可选 - reserved UINT - baud UINT 可选 bps inProto UINT 可选 - UINT outProto 可选 - 描述 端口号。范围：0~2。 0 = I2C 接口 1 = 串口 2 = SPI 接口 如果该项为空，则配置当前端口 接口为 I2C 时，为从设备地址；为其他接口时无意义。 地址范围：0x07 < 地址 < 0x78，最后 1 Bit 必须为 0；默 认值：0xF2。 端口为串口时，波特率可以设置为： 4800/9600/19200/38400/57600/115200。 端口非串口时，无意义。 输入的协议，对应的 Bit 置 1 代表协议在该端口被启用： Bit 0 = UNICORE 协议 Bit 1 = 预留 Bit 2 = 预留 Bit 3 = 预留 Bit 4 = 预留 Bit 5 = RTCM 2.3 协议 Bit 6 = 预留 Bit 7 = RTCM 3.2 协议 Bit 8 = 预留 Bit 9 = 里程计输入协议（仅在组合导航产品中可支持） Bit 10 = MEMS 输入协议（仅在组合导航产品中可支持） Bit 11 = 预留 Bit 12 = 预留 输出的协议，对应的 Bit 置 1 代表协议在该端口被启用： Bit 0 = UNICORE 协议 Bit 1 = NMEA 协议 Bit 2 = RTCM 3.2 协议 Bit 3 = Debug 信息 Bit 4 = 预留 上海移远通信技术股份有限公司 12 / 53 举例： $CFGPRT,1,0,115200,3,3 BC20 GNSS 应用指导 2.4.2.2. CFGMSG ⚫ 读取消息的输出设置 类型： 命令 格式： $CFGMSG,, 参数： 参数名 msgClass msgID 格式 UINT UINT 单位 - 举例： $CFGMSG,0,1 ⚫ 设置/输出消息的输出配置 类型： 设置/输出 格式： $CFGMSG,,, 参数： 参数名 msgClass 格式 UINT 单位 描述 消息类别（见表 2）。 消息 ID（见表 2）。 描述 消息类别（见表 2）。 上海移远通信技术股份有限公司 13 / 53 msgID UINT 可选 rate UINT 举例： $CFGMSG,0,1,1 表 2：消息的类别和 ID 消息名 NMEA 消息 GGA GLL GSA GSV RMC VTG ZDA GST 导航结果消息 POS VEL TIME 类别 0 0 0 0 0 0 0 0 1 1 1 BC20 GNSS 应用指导 消息 ID（见表 2）。如果为空，则控制该类别下的所 有消息。 输出频度。消息的实际输出频度取决于接收机的定位 频度，其值的设定含义为进行 N 次定位解算后输出 一次选定消息。比如，当通过$CFGNAV 配置接收机 的定位频度为 2 Hz 时，若输出频度设定为 1，则该 消息每秒输出 2 次；若输出频度设定为 2，则该消息 每秒输出 1 次；若输出频度设定为 0，则关闭该消息 输出。 每条消息都有其设置范围。如果设定值超出范围，则 该消息无效。 ID 频度设置范围 最高输出频度 0 0~5 1 0~5 2 0~5 3 0~5 4 0~5 5 0~5 6 0~5 7 0~5 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 与定位频度一致 0 0~5 1 0~5 2 0~5 与定位频度一致 与定位频度一致 与定位频度一致 上海移远通信技术股份有限公司 14 / 53 ACC 其他消息 Reserved ANTSTAT1 1 预留 3 3 0~5 2 - 3 - BC20 GNSS 应用指导 与定位频度一致 预留 1 Hz（不可修改） 2.4.2.3. CFGNAV ⚫ 读取定位配置 类型： 命令 格式： $CFGNAV 参数： 无 举例： $CFGNAV ⚫ 设置/输出定位配置 类型： 设置/输出 格式： $CFGNAV,,, 参数： 参数名 measRate 格式 UINT 可选 单位 毫秒 描述 原始观测量输出频度。 此值目前无作用。 上海移远通信技术股份有限公司 15 / 53 navRate correctionMask UINT 可选 UINT 可选 举例： $CFGNAV,1000,1000,3 毫秒 - BC20 GNSS 应用指导 定位频度。 支持的值包括 1000（1 Hz）、500（2 Hz）、200（5 Hz）。 大气修正控制，对应的 Bit 置 1 代表开启相应的修正： Bit 0 = 电离层修正 Bit 1 = 对流层修正 2.4.2.4. CFGNMEA ⚫ 读取当前的 NMEA 协议版本 类型： 命令 格式： $CFGNMEA 参数： 无 举例： $CFGNMEA ⚫ 设置/输出 NMEA 协议版本 类型： 设置/输出 格式： $CFGNMEA, 参数： 参数名 格式 单位 描述 上海移远通信技术股份有限公司 16 / 53 nmeaVer UINT - 举例： $CFGNMEA,h51 BC20 GNSS 应用指导 输出的 NMEA 协议版本： h51 = 在标准 NMEA 4.1 基础上扩展 BeiDou 相关语 句（$GNGSA，* 前的标志位为 4）的版本 2.4.2.5. CFGSYS ⚫ 读取卫星系统配置 类型： 命令 格式： $CFGSYS 参数： 无 举例： $CFGSYS ⚫ 设置/输出卫星系统配置 类型： 设置/输出 格式： $CFGSYS, 参数： 参数名 sysMask 格式 UINT 上海移远通信技术股份有限公司 单位 - 描述 开启的卫星频点，对应的 Bit 置 1 代表开启： Bit 0 = GPS L1 17 / 53 BC20 GNSS 应用指导 举例： $CFGSYS,h11 Bit 1 = GPS L2 Bit 2 = GPS L5 Bit 3 = 预留 Bit 4 = BDS B1 Bit 5 = BDS B2 Bit 6 = BDS B3 Bit 7 = 预留 Bit 8 = GLONASS L1 Bit 9 = GLONASS L2 Bit 10 = 预留 Bit 11 = 预留 Bit 12 = GALILEO E1 Bit 13 = GALILEO E5a Bit 14 = GALILEO E5b Bit 15 = 预留 Bit 16 = BDS B1C Bit 17~19 = 预留（BDS 二代二期预留） Bit 20 = SBAS* Bit 21~31 = 预留（其他的导航及增强系统） 备注 1. '*' 表示正在开发中。 2. BC20 目前仅支持如下三种卫星系统配置： ⚫ 单 GPS ⚫ 单 BeiDou ⚫ GPS + BeiDou 双系统配置（默认配置） 其他系统配置正在开发中。 上海移远通信技术股份有限公司 18 / 53 BC20 GNSS 应用指导 2.4.2.6. AIDINFO ⚫ 查询 AGPS 辅助数据的状态 类型： 命令 格式： $AIDINFO 参数： 无 举例： $AIDINFO ⚫ 输出辅助数据的状态和辅助类型 类型： 输出 格式： $AIDINFO,,,,,,,, , 参数： 参数名 GPSRS GPSUS BDSRS BDSUS GALRS 格式 UINT64 UINT64 单位 - UINT64 - UINT64 - UINT64 - 描述 GPS 星历的接收状态，只要接收到的数据校验通过， 则相应 bit 置 1；若 GPS 系统未使能，则此字段为空。 GPS 星历有效且可用于定位，则相应 bit 置 1；若 GPS 系统未使能，则此字段为空。 BeiDou 星历的接收状态，只要接收到的数据校验通 过，则相应 bit 置 1；若 BeiDou 系统未使能，则此字 段为空。 BeiDou 星历有效且可用于定位，则相应 bit 置 1；若 BeiDou 系统未使能，则此字段为空。 Galileo 星历的接收状态，只要接收到的数据校验通 上海移远通信技术股份有限公司 19 / 53 BC20 GNSS 应用指导 GALUS GLORS GLOUS Atype 举例： UINT64 - UINT64 - UINT64 - UINT - 过，则相应 bit 置 1；若 Galileo 系统未使能，则此字 段为空。 Galileo 星历有效且可用于定位，则相应 bit 置 1；若 Galileo 系统未使能，则此字段为空。 GLONASS 星历的接收状态，只要接收到的数据校验 通过，则相应 bit 置 1；若 GLONASS 系统未使能， 则此字段为空。 GLONASS 星历有效且可用于定位，则相应 bit 置 1； 若 GLONASS 系统未使能，则此字段为空。 辅助类型。 Bit 0~3 = 有 GPS、BeiDou、Galileo*、GLONASS* 星历辅助 Bit 4 = 辅助位置有效 Bit 5 = 使用辅助位置 Bit 6~7 = 预留 Bit 8 = 辅助时间有效 Bit 9 = 使用辅助时间 Bit 10~15 = 预留 $AIDINFO,0x00FFFFFFF7,0x00FFFFFFF7,0x003FFCBBFF,0x003FFCBBFF,,,,,0x0003 备注 '*' 表示正在开发中。 2.4.2.7. CFGCWOUT ⚫ 查询干扰检测语句配置 类型： 命令 格式： $CFGCWOUT 上海移远通信技术股份有限公司 20 / 53 参数： 无 举例： $CFGCWOUT ⚫ 设定/输出干扰检测语句配置 类型： 设置/输出 格式： $CFGCWOUT, 参数： 参数名 CWOutCtrl 格式 UINT 单位 - 举例： $CFGCWOUT,1 BC20 GNSS 应用指导 描述 1 = 允许$CWOUT 语句输出 0 = 关闭$CWOUT 语句输出 备注 该命令仅允许在 115200 波特率下使用。 2.4.3. NMEA 消息（NMEA Message） NMEA h51 为在标准 NMEA 4.1 基础上扩展 BeiDou 相关语句（$GNGSA，* 前的标志位为 4）的版本。 本章节主要描述 NMEA 协议版本为 h51（即$CFGNMEA 语句中的为 h51）时的 NMEA 消息格式。NMEA h51 消息格式与 NMEA 通用语句的定义有些许差异，详情如后续章节所述。 上海移远通信技术股份有限公司 21 / 53 BC20 GNSS 应用指导 2.4.3.1. GGA NMEA h51 协议版本中，GGA 消息（输出 GNSS 定位数据）的定义如下： 类型： 输出 格式： $--GGA,,,,,,,,,,,,,,*Checksum 参数： 参数名 -- time Lat N Lon E FS NoSV HDOP msl M Altref 格式 STR STR STR STR STR STR 单位 - UINT - UINT - DOUBLE - DOUBLE - STR - DOUBLE - 描述 定位系统标识： GP = GPS 系统单独定位 GB = BD2 系统单独定位 GN = GPS 与 BD2 系统混合定位 UTC 时间。格式为：时时分分秒秒.秒秒。 纬度。格式为：度度分分.分分分分。 北纬或南纬指示： N = 北纬 S = 南纬 经度。格式为：度度分分.分分分分。 东经或西经指示： E = 东经 W = 西经 定位状态标识： 0 = 无效 1 = 单点定位 2 = 差分定位 参与定位的卫星数量。 水平精度因子，0.00~99.99，不定位时值为 99.99。 椭球高，固定输出 1 位小数。 椭球高单位，固定为 M。 海平面分离度，固定输出 1 位小数。 上海移远通信技术股份有限公司 22 / 53 BC20 GNSS 应用指导 M DiffAge DiffStation Checksum STR - DOUBLE 秒 DOUBLE - STR - 海平面分离度单位，固定为 M。 差分校正时延。 非差分定位时为空。 参考站 ID； 非差分定位时为空。 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 举例： $GPGGA,060845.00,4004.7401,N,11614.1961,E,1,10,0.85,53.5,M,,M,,*7B 2.4.3.2. GLL NMEA h51 协议版本中，GLL 消息（输出地理位置的经度/纬度数据）的定义如下： 类型： 输出 格式： $--GLL,,,,<E,,,*Checksum 参数： 参数名 -Lat N Lon E 格式 STR STR STR STR STR 单位 - 描述 定位系统标识： GP = GPS 系统单独定位 GB = BD2 系统单独定位 GN = GPS 与 BD2 系统混合定位 纬度。格式：度度度分分.分分分分。 北纬或南纬指示： N = 北纬 S = 南纬 经度。格式：度度度分分.分分分分。 东经或西经指示： E = 东经 W = 西经 上海移远通信技术股份有限公司 23 / 53 BC20 GNSS 应用指导 time Valid STR - STR - Mode STR - Checksum STR - UTC 时间。格式：时时分分秒秒.秒秒秒。 数据有效标识： V = 无效 A = 有效 定位系统模式标识： N = 未定位 A = 单点定位 D = 差分定位 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 举例： $GPGLL,4004.7401,N,11614.1961,E,060845.00,A,A*6F 2.4.3.3. GSA NMEA h51 协议版本中，GSA 消息（输出 GNSS 精度因子与有效卫星信息）的定义如下： 类型： 输出 格式： $--GSA,,,,,,,,,,,,,,,,,,*Checksum 参数： 参数名 -Smode FS 格式 STR STR UINT 单位 - 描述 定位系统标识： GP = GPS 系统单独定位 GB = BD2 系统单独定位 GN = GPS 与 BD2 系统混合定位 定位模式指定状态： M = 手动指定 2D 或 3D 定位 A = 自动切换 2D 或 3D 定位 定位模式： 1 = 未定位 2 = 2D 定位 上海移远通信技术股份有限公司 24 / 53 BC20 GNSS 应用指导 sv1~sv12 PDOP HDOP VDOP systemID Checksum UINT - DOUBLE DOUBLE DOUBLE - UINT - STR - 3 = 3D 定位 参与定位的卫星号： 参与定位的卫星不足 12 颗时不足的区域填空，多于 12 颗只输出前 12 颗卫星； GPS 卫星号为 01~32； BD2 卫星号为 01~37（BD2 PRN 号）。 位置精度因子，0.00~99.99，不定位时值为 99.99。 水平精度因子，0.00~99.99，不定位时值为 99.99。 垂向精度因子，0.00~99.99，不定位时值为 99.99。 NMEA 协议定义的 GNSS 系统 ID： 1 = GPS 系统 ID 4 = BD2 系统 ID 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 举例： $GPGSA,A,3,02,03,06,09,12,17,19,23,28,25,,,1.34,0.85,1.04,1*1E 2.4.3.4. GSV NMEA h51 协议版本中，GSV 消息（输出可见 GNSS 卫星的信息）的定义如下： 类型： 输出 格式： $--GSV,,,,,,,,,,,,,,,,,,,,*Checksum 参数： 参数名 -NoMsg 格式 STR UINT 单位 - 描述 系统标识每条 GSV 消息只包含 4 颗卫星的信息。 GP = GPS 卫星信息 GB = BD2 卫星信息 GSV 消息总数，最小值为 1。 上海移远通信技术股份有限公司 25 / 53 BC20 GNSS 应用指导 MsgNo NoSv sv1~sv4 elv1~elv4 az1~az4 cno1~cno4 signalID Checksum UINT UINT UINT UINT UINT UINT UINT STR 度 度 dBHz - NoMsg 为当前卫星系统的 GSV 消息总数，比如 $GPGSV 中的 NoMsg 为$GPGSV 的消息总数，不 包含$GBGSV 的消息数量。 当前卫星系统 GSV 消息的编号，最小值为 1。 MsgNo 为当前卫星系统 GSV 消息的编号；连续输出 的$GPGSV 和$GBGSV 分别编号。 当前系统可见卫星的总数。 第 1 至第 4 颗卫星的卫星号： GPS 卫星号为 01~32； BD2 卫星号为 01~37（BD2 PRN 号）。 第 1 至第 4 颗卫星的仰角（0~90 度），固定输出 2 位，不足 2 位前面补零。 第 1 至第 4 颗卫星的方位角（0~359 度），固定输出 3 位，不足 3 位前面补零。 第 1 至第 4 颗卫星的载噪比（0~99 dBHz），固定输 出 2 位，不足 2 位前面补零。 未跟踪的卫星填空。 NMEA 协议定义的信号 ID（固定输出 0）。 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 举例： $GPGSV,3,01,11,02,34,277,41,03,16,043,35,05,04,215,35,06,69,333,48,0*57 $GPGSV,3,02,11,09,25,110,41,12,31,305,43,17,55,116,46,19,76,088,46,0*56 $GPGSV,3,03,11,23,23,077,40,25,04,328,32,28,05,171,36,0*67 $GBGSV,3,01,12,01,37,145,42,02,34,225,39,03,44,188,42,04,25,123,37,0*4C $GBGSV,3,02,12,05,17,249,36,06,30,169,38,07,03,188,31,08,69,027,43,0*4E $GBGSV,3,03,12,09,09,186,34,10,15,211,36,12,26,306,40,13,60,316,44,0*48 2.4.3.5. RMC NMEA h51 协议版本中，RMC 消息（输出推荐的最少数据）的定义如下： 类型： 输出 格式： $--RMC,,,,,,,,,,,,,*Checksum 上海移远通信技术股份有限公司 26 / 53 BC20 GNSS 应用指导 参数： 参数名 -- time status Lat N Lon E spd cog date mv mvE mode 格式 STR STR STR STR STR STR STR DOUBLE DOUBLE STR DOUBLE STR STR navStatus Checksum STR STR 单位 - 节 度 - - - 描述 定位系统标识： GP = GPS 系统单独定位 GB = BD2 系统单独定位 GN = GPS 与 BD2 系统混合定位 UTC 时间。格式：时时分分秒秒.秒秒秒。 位置有效标识： V = 无效 A = 有效 纬度。格式：度度分分.分分分分。 北纬或南纬指示： N = 北纬 S = 南纬 经度。格式：度度度分分.分分分分。 东经或西经指示： E = 东经 W = 西经 对地航速。固定输出 3 位小数。 地面航向。从北向起顺时针计算。 UTC 日期。格式：日日月月年年。 磁偏角，固定为空。 磁偏角方向，固定为空。 定位模式： N = 未定位 A = 单点定位 D = 差分定位 导航状态标志，固定输出 V。 V = 设备不提供导航状态信息 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 举例： $GPRMC,060845.00,A,4004.7401,N,11614.1961,E,0.000,,180817,,,A,V*0B 上海移远通信技术股份有限公司 27 / 53 BC20 GNSS 应用指导 2.4.3.6. VTG NMEA h51 协议版本中，VTG 消息（输出航迹向和地速）的定义如下： 类型： 输出 格式： $--VTG,,,,,,,,,*Checksum 参数： 参数名 -- cogt T cogm M sog N kph K mode 格式 STR DOUBLE STR DOUBLE STR DOUBLE STR DOUBLE STR STR Checksum STR 单位 度 描述 定位系统标识。 GP = GPS 系统单独定位 GB = BD2 系统单独定位 GN = GPS 与 BD2 系统混合定位 以真北为参考基准的地面航向（0.000~359.999 度）。 - 航向标志，固定为 T。 度 以磁北为参考基准的地面航向（0.000~359.999 度）。 - 航向标志，固定为 M。 节 地面速率。 - 速率单位，固定为 N。 千米/小时 地面速率。 -- 速率单位，固定为 K。 定位模式： N = 未定位 A = 单点定位 D = 差分定位 校验和； - 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 举例： $GPVTG,,T,,M,0.000,N,0.000,K,A*23 上海移远通信技术股份有限公司 28 / 53 BC20 GNSS 应用指导 2.4.3.7. ZDA NMEA h51 协议版本中，ZDA 消息（输出日期和时间）的定义如下： 类型： 输出 格式： $--ZDA,,,,,,*Checksum 参数： 参数名 格式 -- STR time day mon year ltzh ltzn Checksum STR UINT UINT UINT UINT UINT STR 举例： 单位 - - 描述 定位系统标识： GP = GPS 系统单独定位 GB = BD2 系统单独定位 GN = GPS 与 BD2 系统混合定位 UTC 时间。格式：时时分分秒秒.秒秒。 UTC 日，两位数字，01~31。 UTC 月，两位数字，01~12。 UTC 年，四位数字。 本地时区的小时（固定输出 00）。 本地时区的分钟（固定输出 00）。 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 $GPZDA,060845.00,18,08,2017,00,00*6C 上海移远通信技术股份有限公司 29 / 53 BC20 GNSS 应用指导 2.4.3.8. GST NMEA h51 协议版本中，GST 消息（输出 GNSS 伪距误差统计数据）的定义如下： 类型： 输出 格式： $--GST,,,,,,,,*Checksum 参数： 参数名 格式 -- STR time rngRMS stdMajor stdMinor hdg stdLat stdLon stdAlt Checksum STR DOUBLE DOUBLE DOUBLE DOUBLE DOUBLE DOUBLE DOUBLE STR 举例： 单位 - 米 米 米 度 米 米 米 - 描述 定位系统标识： GP = GPS 系统单独定位 GB = BD2 系统单独定位 GN = GPS 与 BD2 系统混合定位 UTC 时间。格式：时时分分秒秒.秒秒。 伪距误差的均方差。最大值为 3750000。 误差椭圆的半长轴。固定为空。 误差椭圆的半短轴。固定为空。 误差椭圆的半长轴指向。从正北起顺时针，固定为空。 纬度方向的误差均方差。 经度方向的误差均方差。 高度方向的误差均方差。 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 $GPGST,060845.00,0.6,,,,0.07,0.09,0.09*47 上海移远通信技术股份有限公司 30 / 53 BC20 GNSS 应用指导 2.4.4. 导航结果消息（Navigation Result Message） 2.4.4.1. NAVPOS 输出接收机位置信息。 类型： 输出 格式： $NAVPOS,,,,,,,,,*Checksum 参数： 参数名 time system 格式 UINT UINT quality UINT X Y Z lat lon height Checksum DOUBLE DOUBLE DOUBLE DOUBLE DOUBLE DOUBLE STR 单位 - - - 米 米 米 度 度 米 - 描述 UTC 时间。 时间的含义取决于当前定位使用的系统，GPS 优先 级高于 BeiDou。对于 GPS 和 BeiDou 为对应系统的 周内毫秒计数。 当前定位使用的系统： Bit 0 = GPS Bit 2 = BeiDou 当前定位质量： 0 = 无效 1 = 外部设置 2 = 粗略 3 = 精确 ECEF 坐标系 X。 ECEF 坐标系 Y。 ECEF 坐标系 Z。 接收机纬度，北纬为正，南纬为负。 接收机经度，东经为正，西经为负。 接收机椭球高。 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 上海移远通信技术股份有限公司 31 / 53 BC20 GNSS 应用指导 举例： $NAVPOS,282201000,5,3,-2160481.168,4383619.182,4084735.203,40.078998,116.236534,52.84 3847*1C 2.4.4.2. NAVVEL 输出接收机速度信息。 类型： 输出 格式： $NAVVEL,,,,,,,*Checksum 参数： 参数名 time system 格式 UINT UINT quality UINT Vx Vy Vz clockDrift Checksum DOUBLE DOUBLE DOUBLE DOUBLE STR 单位 - - - 米/秒 米/秒 米/秒 米/秒 - 描述 UTC 时间。 时间的含义取决于当前定位使用的系统，GPS 优先 级高于 BeiDou。对于 GPS 和 BeiDou 为对应系统的 周内毫秒计数。 当前定位使用的系统： Bit 0 = GPS Bit 2 = BeiDou 当前定位质量： 0 = 无效 1 = 外部设置 2 = 粗略 3 = 精确 ECEF 坐标系 Vx。 ECEF 坐标系 Vy。 ECEF 坐标系 Vz。 晶振漂移的等效速度。 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 上海移远通信技术股份有限公司 32 / 53 举例： $NAVVEL,282201000,5,3,0.000,0.000,0.000,31.785*2F BC20 GNSS 应用指导 2.4.4.3. NAVTIME 输出接收机时间信息。 类型： 输出 格式： $NAVTIME,,,,,,,,,,,,*Checksum 参数： 参数名 GPSW GPST GPSQ GLOY GLOD GLOT GLOQ BDW BDT BDQ 格式 UINT DOUBLE UINT UINT UINT DOUBLE UINT UINT DOUBLE UINT 单位 - - - - - 描述 GPS 周。 GPS 周内秒。 GPS 时间质量： 0 = 无效 1 = 外部设置 2 = 粗略 3 = 精确 GLONASS 年。 GLONASS 天。 GLONASS 天内秒。 GLONASS 时间质量： 0 = 无效 1 = 外部设置 2 = 粗略 3 = 精确 BeiDou 周。 BeiDou 周内秒。 BeiDou 时质量； 0 = 无效 上海移远通信技术股份有限公司 33 / 53 BC20 GNSS 应用指导 BDGPSDiff DOUBLE 秒 GLOGPSDiff DOUBLE 秒 Checksum STR - 1 = 外部设置 2 = 粗略 3 = 精确 BeiDou 时与 GPS 时的时差。 GLONASS 时与 GPS 时的时差。 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 举例： $NAVTIME,1848,282201.000291049,3,0,0,0.000000000,0,492,282187.000291134,3,0.000000085, 0.000000000*63 2.4.4.4. NAVACC 输出接收机定位测速精度信息。 类型： 输出 格式： $NAVACC,,,,,*Checksum 参数： 参数名 time status pAcc vAcc cAcc Checksum 格式 STR UINT UINT UINT UINT STR 单位 - 0.001 米 0.001 米/秒 0.001 度 - 描述 UTC 时间。格式：时时分分秒秒.秒秒秒。 数据有效标识： V = 无效 A = 有效 水平定位精度，水平方向二维定位误差的均方差。 水平测速精度，水平方向二维测速误差的均方差。 地面航向精度。 校验和； 本条语句从 $ 到 * 之间所有字符进行异或得到的十 六进制数。 上海移远通信技术股份有限公司 34 / 53 举例： $NAVACC,085206.000,A,2480,70,1250*cs 2.4.5. 其他消息（Misc Message） 2.4.5.1. ANTSTAT1 ⚫ 查询天线检测状态信息 类型： 命令 格式： $ANTSTAT1 参数： 无 举例： $ANTSTAT1 ⚫ 输出天线检测状态信息 类型： 输出 格式： $ANTSTAT1,, 参数： 参数名 格式 单位 status1 INT - 上海移远通信技术股份有限公司 描述 天线检测状态： 0 = 初始化 1 = 未知 2 = 正常 BC20 GNSS 应用指导 35 / 53 status2 INT - 举例： $ANTSTAT1,0,0 备注 天线状态检测需增加外部检测电路。 BC20 GNSS 应用指导 3 = 短路 4 = 开路 天线供电状态： 0 = 断路，未检测到天线供电 1 = 正常，检测到天线供电 2 = 未知 2.4.5.2. LSF1 ⚫ 查询指定卫星系统的闰秒预告信息 类型： 命令 格式： $LSF1, 参数： 参数名 格式 单位 system UINT - 举例： $LSF1,0 描述 查询闰秒预告信息所对应的系统： 0 = GPS 1 = BD2 上海移远通信技术股份有限公司 36 / 53 BC20 GNSS 应用指导 ⚫ 设置/输出闰秒预告信息 类型： 设置/输出 格式： $LSF1,,,,,,,,,< utcA0>, 参数： 参数名 system 格式 UINT 单位 - flag UINT - utcTLS utcTLSF utcTOT utcWN utcTOWLSF utcWNLSF utcA0 utcA1 UINT 秒 UINT 秒 UINT 秒 UINT 星期 DOUBLE 秒 UINT 星期 INT 秒 INT 秒 描述 闰秒预告信息所对应的系统： 0 = GPS 1 = BD2 闰秒预告信息有效标志： 0 = 无效 1 = 有效 闰秒事件发生前，UTC 与系统时差。 闰秒事件发生后，UTC 与系统时差。 UTC 参考周内秒。（BD2 系统参数为 0）。 UTC 参考周数。（BD2 系统参数为 0）。 闰秒事件发生的 UTC 周内秒。 闰秒事件发生的 UTC 周数。 UTC 周数包含连续千周。 UTC 多项式常项系数 A0（比例因子为 2~30）。 UTC 多项式一阶系数 A1（比例因子为 2~50）。 举例： $LSF1,0,1,15,16,462836,82,6,86,7811626,14 上海移远通信技术股份有限公司 37 / 53 BC20 GNSS 应用指导 2.4.5.3. CWOUT* 输出干扰检测信息。 类型： 输出 格式： $CWOUT,, 参数： 参数名 格式 单位 CWFlagOut UINT - CWRatioOut UINT - 描述 干扰标志： 1 = 无干扰 2 = 有干扰 3 = 干扰信号强，已影响接收机定位 干扰强度，0~255；0 代表无干扰，255 表示干扰很强。 举例： $CWOUT,1,0 备注 '*' 表示正在开发中。 2.5. 默认配置 2.5.1. 串口配置（CFGPRT） 参数名 baud inProto 默认配置 115200 129 说明 输入 UNICORE 协议 + RTCM3.2 协议 上海移远通信技术股份有限公司 38 / 53 outProto 3 输出 UNICORE 协议 + NMEA 协议 2.5.2. 消息输出配置（CFGMSG） 消息输出频度的默认配置如下： 参数名 NMEA 消息 GGA GLL GSA GSV RMC VTG ZDA GST 导航结果消息 POS VEL TIME ACC 默认配置 1 1 1 1 1 1 0 0 0 0 0 0 说明 1 Hz 输出 1 Hz 输出 1 Hz 输出 1 Hz 输出 1 Hz 输出 1 Hz 输出 关闭 关闭 关闭 关闭 关闭 关闭 备注 BC20 NmeaVer h51 协议版本下的默认消息输出如上。 BC20 GNSS 应用指导 上海移远通信技术股份有限公司 39 / 53 2.5.3. 定位配置（CFGNAV） 参数名 measRate navRate correctionMask 默认配置 1000 1000 3 说明 1 Hz 观测量频度（无效） 1 Hz 定位频度 电离层和对流层修正开启 BC20 GNSS 应用指导 2.5.4. NMEA 配置（CFGNMEA） 参数名 nmeaVer 默认配置 h51 说明 在标准 NMEA 4.1 基础上扩展 BeiDou 相关语句的版本 2.5.5. 卫星系统配置（CFGSYS） 参数名 sysMask 默认配置 h11 说明 跟踪 GPS 与 BeiDou 卫星 2.5.6. 干扰检测配置（CFGCWOUT） 参数名 CWOutCtrl 默认配置 0 说明 关闭 上海移远通信技术股份有限公司 40 / 53 BC20 GNSS 应用指导 3 GNSS AT 命令详解 本章节主要介绍与 BC20 模块的 GNSS 功能相关的 AT 命令。 3.1. AT 命令语法 3.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应，省略。 表 3：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 41 / 53 3.2. AT 命令详解 3.2.1. AT+QGNSSC 打开/关闭 GNSS 该命令用于控制 GNSS 模块的电源。 AT+QGNSSC 打开/关闭 GNSS 测试命令 AT+QGNSSC=? 响应 +QGNSSC: (支持的列表) 查询命令 AT+QGNSSC? OK 响应 +QGNSSC: 设置命令 AT+QGNSSC= OK 响应 OK 最大响应时间 特性说明 如果发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 / 参数 整型。 0 关闭 GNSS 1 打开 GNSS 整型。错误码信息，请参考附录 B。 举例 AT+QGNSSC? +QGNSSC: 0 OK AT+QGNSSC=1 OK //查询 GNSS 状态。 //GNSS 关闭。 //打开 GNSS。 上海移远通信技术股份有限公司 BC20 GNSS 应用指导 42 / 53 BC20 GNSS 应用指导 3.2.2. AT+QGNSSRD 获取 GNSS NMEA 语句 该命令用于获取 GNSS NMEA 语句。 AT+QGNSSRD 获取 GNSS NMEA 语句 测试命令 响应 AT+QGNSSRD=? +QGNSSRD: (支持的列表) 查询命令 查询所有支持的 NMEA 语句 AT+QGNSSRD? OK 响应 … +QGNSSRD: … 设置命令 查询指定类型的 NMEA 语句 AT+QGNSSRD= OK 响应 +QGNSSRD: OK 最大响应时间 特性说明 如果发生任何错误： +CME ERROR: 300 毫秒 / 参数 字符串类型。NMEA 语句类型。 'NMEA/GGA' GGA 语句 'NMEA/GLL' GLL 语句 'NMEA/GSA' GSA 语句 'NMEA/GSV' GSV 语句 'NMEA/RMC' RMC 语句 'NMEA/VTG' VTG 语句 字符串类型。NMEA 语句。 整型。错误码信息，请参考附录 B。 举例 AT+QGNSSRD? //查询所有支持的 GNSS NMEA 语句。 +QGNSSRD: $GNRMC,030758.00,A,3150.7929,N,11711.8609,E,0.133,,010319,,,A,V*14 $GNGGA,030758.00,3150.7929,N,11711.8609,E,1,19,2.49,63.9,M,,M,,*6C 上海移远通信技术股份有限公司 43 / 53 BC20 GNSS 应用指导 $GNGLL,3150.7929,N,11711.8609,E,030758.00,A,A*7C $GNGSA,A,3,12,32,14,01,20,18,22,10,29,25,31,195,2.98,2.49,1.63,1*36 $GNGSA,A,3,09,06,16,26,21,,,,,,,,2.98,2.49,1.63,4*03 $GPGSV,4,1,16,01,01,295,25,10,40,183,30,12,17,039,43,14,59,341,44,0*65 $GPGSV,4,2,16,18,02,268,23,20,15,169,29,22,17,314,36,25,50,054,40,0*63 $GPGSV,4,3,16,26,21,206,34,29,14,111,37,31,51,287,39,32,70,022,42,0*6B $GPGSV,4,4,16,193,52,165,16,194,69,056,12,199,51,161,,195,22,142,28,0*6B $GBGSV,3,1,09,05,17,251,,06,76,065,29,07,67,203,,09,67,341,38,0*74 $GBGSV,3,2,09,10,45,214,,14,75,219,,16,77,050,22,21,32,155,27,0*71 $GBGSV,3,3,09,26,62,019,38,0*4D $GNVTG,,T,,M,0.133,N,0.246,K,A*3C OK AT+QGNSSRD='NMEA/RMC' //获取当前时刻指定的 NMEA 语句信息。 +QGNSSRD: $GNRMC,031103.00,A,3150.7943,N,11711.8615,E,0.347,,010319,,,A,V*1D OK 3.2.3. AT+QGNSSCMD 发送命令至模块 该命令用于向 GNSS 模块发送命令，以便用户使用特定功能来满足应用程序的需求。 AT+QGNSSCMD 测试命令 AT+QGNSSCMD=? 发送命令至模块 响应 +QGNSSCMD: (支持的列表),'cmdString' 设置命令 AT+QGNSSCMD=, OK 响应 OK +QGNSSCMD: [,...] 最大响应时间 特性说明 如果发生任何错误： +CME ERROR: 300 毫秒 / 参数 整型。需发送的命令类型。 0 NMEA 类型命令 上海移远通信技术股份有限公司 44 / 53 BC20 GNSS 应用指导 1 十六进制类型命令 字符串类型。需要发送的消息命令。关于可发送的消息命令，请参考第 2.4 章。 字符串类型。发送的命令所返回的相应数据，详情请参考第 2.4 章。 整型。错误码信息，请参考附录 B。 举例 AT+QGNSSCMD=0,'$PDTINFO' OK //发送命令以读取产品信息。 +QGNSSCMD: $PDTINFO,N/A,G1B1,VN/A,R3.1.0Build3335,N/A,N/A*2D AT+QGNSSCMD=0,'$RESET,0,h01' OK //发送命令以复位接收机。 备注 当前仅支持=0。 3.2.4. AT+QGNSSDB 配置 NEMA 语句输出端口 该命令用于控制 NEMA 语句是否可从调试串口输出。 AT+QGNSSDB 配置 NEMA 语句输出端口 测试命令 AT+QGNSSDB=? 响应 +QGNSSDB: (支持的列表) 查询命令 AT+QGNSSDB? OK 响应 +QGNSSDB: 设置命令 AT+QGNSSDB= OK 响应 OK 最大响应时间 特性说明 如果发生错误： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 45 / 53 BC20 GNSS 应用指导 参数 整型。是否从调试串口输出 NMEA 语句。 0 不从调试串口输出 1 从调试串口输出 举例 AT+QGNSSDB? +QGNSSDB: 0 OK AT+QGNSSDB=1 OK //查询当前是否从调试串口输出 NMEA 语句。 //不从调试串口输出 NMEA 语句。 //设置从调试串口输出 NMEA 语句。 3.2.5. AT+QGNSSAGPS 启用/禁用 AGPS 功能 该命令用于启用或禁用 AGPS 功能。有关 AGPS 功能的详细介绍，请参考第 4 章。 AT+QGNSSAGPS 启用/禁用 AGPS 功能 测试命令 AT+QGNSSAGPS=? 响应 +QGNSSAGPS: (支持的列表) 查询命令 AT+QGNSSAGPS? OK 响应 +QGNSSAGPS: 设置命令 AT+QGNSSAGPS= OK 响应 OK 最大响应时间 特性说明 如果发生任何错误： ERROR 300 毫秒 / 参数 整型。启用或禁用 AGPS 功能。 0 禁用 上海移远通信技术股份有限公司 46 / 53 1 启用 举例 AT+QGNSSAGPS? +QGNSSAGPS: 1 OK AT+QGNSSAGPS=0 OK //查询 AGPS 功能是否已启用。 //AGPS 功能已启用。 //禁用 AGPS 功能。 BC20 GNSS 应用指导 上海移远通信技术股份有限公司 47 / 53 BC20 GNSS 应用指导 4 AGPS 功能说明 4.1. AGPS 运行机制 AGPS 是一种由外界提供接收机信号捕获与定位所需的信息数据的方式和技术。它既能加快接收机信 号捕获和完成首次定位的速度，又能提高信号捕获与跟踪灵敏度。 通过 AGPS 功能，模块可获取远程服务器上的辅助星历数据。模块下载完辅助星历数据后，自动将该 数据注入到 GNSS 引擎，从而缩短 TTFF（首次定位时间）。 4.2. AGPS 操作流程概述 AGPS 功能的操作流程如下： 1) 模块开机后，确认网络注册成功。 2) 执行 AT+QGNSSAGPS=1 启用 AGPS 功能。 3) 执行 AT+QGNSSAGPS?查询 AGPS 功能是否已启用。 4) 执行 AT+QGNSSC=1 打开 GNSS，开始定位工作。 5) 获取 NMEA 语句信息。 6) 执行 AT+QGNSSC=0 关闭 GNSS（可选步骤，可根据不同的应用需求选择是否执行此步骤）。 4.3. AT 命令执行流程 AT+CEREG? +CEREG: 0,1 OK AT+QGNSSAGPS=1 OK AT+QGNSSAGPS? //检查网络状态。 //已成功注册网络。 //启用 AGPS 功能。 //查询 AGPS 功能是否已启用。 上海移远通信技术股份有限公司 48 / 53 BC20 GNSS 应用指导 +QGNSSAGPS: 0 // AGPS 功能未启用（启用 AGPS 需要一定时间）。 OK AT+QGNSSAGPS? +QGNSSAGPS: 1 //查询 AGPS 功能是否已启用。 // AGPS 功能已启用。 OK AT+QGNSSC=1 OK AT+QGNSSC? +QGNSSC: 0 //开启 GNSS 电源。 //查询 GNSS 是否开启成功。 //未成功开启（加载 GNSS 固件需要一定时间）。 OK AT+QGNSSC? +QGNSSC: 1 //查询 GNSS 是否开启成功。 //返回 1 表示开启成功。 OK AT+QGNSSRD='NMEA/RMC' //获取当前时刻指定的 NMEA 语句信息。 +QGNSSRD: $GNRMC,120715.00,A,3150.78179,N,11711.93433,E,0.000,,310818,,,A,V*19 OK AT+QGNSSRD? //查询当前时刻所有的 NMEA 语句信息。 +QGNSSRD: $GNRMC,030758.00,A,3150.7929,N,11711.8609,E,0.133,,010319,,,A,V*14 $GNGGA,030758.00,3150.7929,N,11711.8609,E,1,19,2.49,63.9,M,,M,,*6C $GNGLL,3150.7929,N,11711.8609,E,030758.00,A,A*7C $GNGSA,A,3,12,32,14,01,20,18,22,10,29,25,31,195,2.98,2.49,1.63,1*36 $GNGSA,A,3,09,06,16,26,21,,,,,,,,2.98,2.49,1.63,4*03 $GPGSV,4,1,16,01,01,295,25,10,40,183,30,12,17,039,43,14,59,341,44,0*65 $GPGSV,4,2,16,18,02,268,23,20,15,169,29,22,17,314,36,25,50,054,40,0*63 $GPGSV,4,3,16,26,21,206,34,29,14,111,37,31,51,287,39,32,70,022,42,0*6B $GPGSV,4,4,16,193,52,165,16,194,69,056,12,199,51,161,,195,22,142,28,0*6B $GBGSV,3,1,09,05,17,251,,06,76,065,29,07,67,203,,09,67,341,38,0*74 $GBGSV,3,2,09,10,45,214,,14,75,219,,16,77,050,22,21,32,155,27,0*71 $GBGSV,3,3,09,26,62,019,38,0*4D $GNVTG,,T,,M,0.133,N,0.246,K,A*3C OK 上海移远通信技术股份有限公司 49 / 53 BC20 GNSS 应用指导 AT+QGNSSC=0 OK //GNSS 定位成功后，关闭 GNSS 减少功耗。 备注 1. 模块在 Standby 模式下支持热启动，再次开启 GNSS 后可快速定位。 2. GNSS 启动成功初期 NMEA 语句尚未输出，建议至少延时 1 秒后再使用 AT+QGNSSRD 查询 NMEA 语句。 3. NMEA 语句的更新周期默认为 1 秒。若使用 AT+QGNSSRD 进行间隔查询时，建议查询周期为 1 秒。 4. 可通过 AT+QGNSSCMD=0,'$AIDINFO'进行查询 AGPS 辅助数据是否有效导入。 上海移远通信技术股份有限公司 50 / 53 BC20 GNSS 应用指导 5 附录 A 参考文档及术语缩写 表 4：参考文档 序号 文档名称 [1] Quectel_BC20_硬件设计手册 备注 BC20 硬件设计手册 表 5：术语缩写 术语 AGPS ASCII BeiDou/BDS DBG DGPS Galileo GGA GLL GLONASS GNSS GPS GSA GSV I2C 英文全称 Assisted Global Positioning System American Standard Code for Information Interchange BeiDou Navigation Satellite System Debug Differential Global Position System Galileo Satellite Navigation System Global Positioning System Fixed Data Geographic Position – Latitude/Longitude Global Navigation Satellite System Global Navigation Satellite System Global Positioning System GNSS DOP and Active Satellites GNSS Satellites in View Inter-Integrated Circuit 中文全称 辅助全球卫星定位系统 美国信息交换标准代码 中国北斗卫星导航系统 调试端口 差分全球定位系统 伽利略卫星导航系统 全球定位系统定位数据 地理位置—纬度/经度 俄罗斯卫星导航系统格洛纳斯 全球导航卫星系统 全球定位系统 GNSS 精度因子（DOP）与有效卫 星 可视 GNSS 卫星 I2C 总线 上海移远通信技术股份有限公司 51 / 53 MEMS NMEA QZSS RMC SBAS SPI TTFF UTC VTG ZDA BC20 GNSS 应用指导 Micro-Electro-Mechanical System NMEA (National Marine Electronics Association) 0183 Interface Standard Quasi-Zenith Satellite System Recommended Minimum Specific GNSS Data Satellite-Based Augmentation System Serial Peripheral Interface Time to First Fix Coordinated Universal Time Course Over Ground and Ground Speed Data and Time 微机电系统 NMEA（美国国家海洋电子协会） 0183 接口标准 准天顶卫星系统 推荐的最少专用 GNSS 数据 星基增强系统 串行外设接口 首次定位时间 协调世界时 对地航向和对地速度 时间和日期信息 上海移远通信技术股份有限公司 52 / 53 6 附录 B 错误码 表 6：GNSS AT 命令相关错误码 错误码 7103 含义 操作失败 BC20 GNSS 应用指导 上海移远通信技术股份有限公司 53 / 53

BG95&BG77&BG600L Series MUX Application Note LPWA Module Series Version: 1.0 Date: 2020-09-22 Status: Released www.quectel.com LPWA Module Series BG95&BG77&BG600L Series MUX Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. Disclaimer While Quectel has made efforts to ensure that the functions and features under development are free from errors, it is possible that these functions and features could contain errors, inaccuracies and omissions. Unless otherwise provided by valid agreement, Quectel makes no warranties of any kind, implied or express, with respect to the use of features and functions under development. To the maximum extent permitted by law, Quectel excludes all liability for any loss or damage suffered in connection with the use of the functions and features under development, regardless of whether such loss or damage may have been foreseeable. Duty of Confidentiality The Receiving Party shall keep confidential all documentation and information provided by Quectel, except when the specific permission has been granted by Quectel. The Receiving Party shall not access or use Quectel’s documentation and information for any purpose except as expressly provided herein. Furthermore, the Receiving Party shall not disclose any of the Quectel's documentation and information to any third party without the prior written consent by Quectel. For any noncompliance to the above requirements, unauthorized use, or other illegal or malicious use of the documentation and information, Quectel will reserve the right to take legal action. BG95&BG77&BG600L_Series_MUX_Application_Note 1 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note Copyright The information contained here is proprietary technical information of Quectel wireless solutions co., ltd. Transmitting, reproducing, disseminating and editing this document as well as using the content without permission are forbidden. 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. 2020. All rights reserved. BG95&BG77&BG600L_Series_MUX_Application_Note 2 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note About the Document Revision History Version Date Author - 2020-09-07 Harding HU 1.0 2020-09-22 Harding HU Description Creation of the document First official release BG95&BG77&BG600L_Series_MUX_Application_Note 3 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 6 1 Introduction ......................................................................................................................................... 7 1.1. Applicable Modules .................................................................................................................... 7 2 Overview of Quectel Multiplexing System ....................................................................................... 8 3 MUX AT Command.............................................................................................................................. 9 3.1. AT Command Syntax ................................................................................................................. 9 3.1.1. Definitions........................................................................................................................ 9 3.1.2. AT Command Syntax ...................................................................................................... 9 3.2. AT+CMUX Multiplexing Mode ............................................................................................... 10 4 Multiplexer Protocol ......................................................................................................................... 12 4.1. Frame Structure ....................................................................................................................... 12 4.1.1. Flag Sequence Field ..................................................................................................... 12 4.1.2. Address Field ................................................................................................................ 12 4.1.2.1. DLCI ................................................................................................................... 12 4.1.2.2. C/R ..................................................................................................................... 13 4.1.2.3. EA....................................................................................................................... 13 4.1.3. Control Field .................................................................................................................. 13 4.1.4. Length Field................................................................................................................... 14 4.1.5. Information Field ........................................................................................................... 14 4.1.6. FCS Field ...................................................................................................................... 14 4.2. Frame Types ............................................................................................................................ 15 4.2.1. SAMB ............................................................................................................................ 15 4.2.2. UA.................................................................................................................................. 15 4.2.3. DM ................................................................................................................................. 15 4.2.4. DISC .............................................................................................................................. 15 4.2.5. UIH ................................................................................................................................ 16 4.3. Multiplexer Control Channel..................................................................................................... 16 4.3.1. Message Format ........................................................................................................... 16 4.3.1.1. Type Field........................................................................................................... 16 4.3.1.2. Length Field........................................................................................................ 17 4.3.1.3. Value Field ......................................................................................................... 17 4.3.2. Message Type and Actions........................................................................................... 17 4.3.2.1. Power Saving Control (PSC) ............................................................................. 17 4.3.2.2. Multiplexer Close Down (CLD)........................................................................... 18 4.3.2.3. Flow Control On Command (FCon) ................................................................... 18 4.3.2.4. Flow Control Off Command (FCoff) ................................................................... 18 4.3.2.5. Modem Status Command (MSC)....................................................................... 19 BG95&BG77&BG600L_Series_MUX_Application_Note 4 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 4.4. Procedures ............................................................................................................................... 22 4.4.1. DLC Establishment ....................................................................................................... 22 4.4.2. DLC Release ................................................................................................................. 22 4.4.3. Information Transfer...................................................................................................... 22 4.4.3.1. Information Data................................................................................................. 22 4.4.4. Time-out Considerations ............................................................................................... 23 4.4.5. Flow Control .................................................................................................................. 23 5 Examples ........................................................................................................................................... 24 5.1. Samples for Frame Structure................................................................................................... 24 5.2. Channels Establishment .......................................................................................................... 25 5.3. Frame Transmission ................................................................................................................ 26 5.4. Power Saving Mode and Wake-up .......................................................................................... 27 5.5. Flow Control ............................................................................................................................. 27 5.6. Synchronization........................................................................................................................ 28 5.7. Close-down of Multiplexer........................................................................................................ 29 6 Appendix A References.................................................................................................................... 30 BG95&BG77&BG600L_Series_MUX_Application_Note 5 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note Table Index Table 1: Applicable Modules ........................................................................................................................ 7 Table 2: Types of AT Commands and Responses ...................................................................................... 9 Table 3: MUX Frame Structure .................................................................................................................. 12 Table 4: Address Field ............................................................................................................................... 12 Table 5: C/R Bit Usage .............................................................................................................................. 13 Table 6: Coding of Control Field ................................................................................................................ 13 Table 7: The Structure of Length Field ...................................................................................................... 14 Table 8: Message Format .......................................................................................................................... 16 Table 9: Message Format – Type Field ..................................................................................................... 16 Table 10: Message Format – Length Field ................................................................................................ 17 Table 11: Power Saving Control Message – Type Field Format ............................................................... 17 Table 12: Multiplexer Close-down Message – Type Field Format ............................................................ 18 Table 13: Flow Control On Command – Type Field Format...................................................................... 18 Table 14: Flow Control Off Command – Type Field Format...................................................................... 19 Table 15: Modem Status Command .......................................................................................................... 19 Table 16: Modem Status Command – Command Field Format ................................................................ 19 Table 17: Format of Address Field............................................................................................................. 20 Table 18: Format of Control Signal Octet .................................................................................................. 20 Table 19: Mapping from the Control Signal Octet by a Receiving Entity................................................... 21 Table 20: Mapping to the Control Signal Octet by a Sending Entity ......................................................... 21 Table 21: Related Documents.................................................................................................................... 30 Table 22: Terms and Abbreviations ........................................................................................................... 30 BG95&BG77&BG600L_Series_MUX_Application_Note 6 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 1 Introduction The document defines Quectel MUX (multiplexer) protocol between UE and TE and provides examples of how to use the MUX function on Quectel BG95 series, BG77 and BG600L-M3 modules. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS NOTE See the firmware release notes of corresponding module models to check whether the function has been supported. BG95&BG77&BG600L_Series_MUX_Application_Note 7 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 2 Overview of Quectel Multiplexing System The multiplexer provides mechanisms for conveying streams of data between TE and UE over a single physical port. Quectel multiplexing system creates 4 virtual channels on one physical port to transmit multiple streams of data simultaneously. It enables the physical port to act like four real physical channels for the application. Every virtual channel supports SMS, PPP dialing, etc. All data from the application is packed into different frames, and the frames consist of the data and protocol fields which clearly indicate the channel number, length of the information, FCS, and so on. The frames are transmitted as one stream via the serial port. After arriving at the other peer, the data is unpacked as four streams by the multiplexer protocol stack and transmitted to the application. In addition to the information field, the control signals are also simulated. Each channel between TE and UE is called a DLC (Data Link Connection) and is established separately and sequentially. TE UE Application App Task DLC1 DLC2 DLC3 DLC4 DLC1 DLC2 DLC3 DLC4 MUX Driver DMSUMXUDXriTvaesrk DATA DATA Physical Layer Multi DATA Physical Layer Figure 1: MUX Architecture BG95&BG77&BG600L_Series_MUX_Application_Note 8 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 3 MUX AT Command 3.1. AT Command Syntax 3.1.1. Definitions  Carriage return character.  Line feed character.  Parameter name. Angle brackets do not appear on the command line.  [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is omitted, the new value equals to the previous value or the default settings, unless otherwise specified.  Underline Default setting of a parameter. 3.1.2. AT Command Syntax All command lines must start with 'AT' or 'at' and end with ''. Information responses and result codes always start and end with a carriage return character and a line feed character: . Throughout this document, only the commands and responses are presented, while carriage return and line feed characters are deliberately omitted. Table 2: Types of AT Commands and Responses Command Type Syntax Description Test Command Read Command Write Command Execution Command AT+=? Returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. AT+? Returns the currently set value of a parameter or parameters. AT+= Sets parameter values. [,[,[...]]] AT+ Reads non-variable parameters affected by internal processes in the module. BG95&BG77&BG600L_Series_MUX_Application_Note 9 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 3.2. AT+CMUX Multiplexing Mode This command enables/disables the multiplexing protocol control channel and sets parameters for the control channel. AT+CMUX Multiplexing Mode Test Command AT+CMUX=? Response +CMUX: (list of supported ),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s),(range of supported s) Read Command AT+CMUX? OK Response +CMUX: [,[,[,[,[,[,[,[,]]]]]]]] Write Command AT+CMUX=[,[ ,[,[,[,[,[,[,]]]]]]]] OK Response OK If there is an error related to ME functionality: +CME ERROR: Maximum Response Time Characteristics If there is any other error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Multiplexer transparency mechanism. 0 Basic option Integer type. Defines the way in which the multiplexer control channel is set up. A virtual channel may subsequently be set up differently but in the absence of any negotiation for the settings of a virtual channel, and the virtual channel shall be set up according to the control channel setting. 0 UIH frames used only 1 UI frames used only (no supported) BG95&BG77&BG600L_Series_MUX_Application_Note 10 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 2 I frames used only (no supported) Integer type. Transmission rate of the physical port. 1 9600 bit/s 2 19200 bit/s 3 38400 bit/s 4 57600 bit/s 5 115200 bit/s 6 230400 bit/s 7 460800 bit/s Integer type. Maximum frame size. Range: 1–32768. Default value: 127. Integer type. Acknowledgement timer, that is, the time UE waits for an acknowledgement before resorting to another action (e.g. transmitting a frame). Range: 1–255. Default value: 10. Unit: ten milliseconds. Integer type. Maximum number of re-transmissions. Range: 0–100. Default value: 3. Integer type. Response timer for the multiplexer control channel. Range: 2–255. Default value: 30. Unit: ten milliseconds. must be longer than . Integer type. Wake up response timer. Range: 1–255. Default value: 10. Unit: second. Integer type. Window size (Not supported currently). Example AT+CMUX=0 OK AT+CMUX? +CMUX: 0,0,5,127,10,3,30,10,2 OK NOTE AT+CMUX can only be executed on the main UART since the modules only support multiplexer function on UART1. BG95&BG77&BG600L_Series_MUX_Application_Note 11 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 4 Multiplexer Protocol This chapter explains the technical details of the multiplexer protocol. 4.1. Frame Structure All information transmitted between the TE and UE is conveyed in frames. Table 3: MUX Frame Structure Opening Flag 1 octet Address 1 octet Control 1 octet Length 1–2 octet Information FCS Closing Flag Multiple octets 1 octet 1 octet 4.1.1. Flag Sequence Field Each frame begins and ends with a flag sequence octet (0xF9). 4.1.2. Address Field The address field consists of a single octet. It contains the Data Link Connection Identifier (DLCI), the C/R bit and the address field extension bit as shown in the figure below. Table 4: Address Field Bit 1 EA Bit 2 C/R Bit 3 Bit 4 Bit 5 Bit 6 DLCI Bit 7 Bit 8 4.1.2.1. DLCI The DLCI identifies the virtual channel between TE and UE. Multiple DLCIs shall be supported but the number is implementation-specific. The DLCIs are dynamically assigned. BG95&BG77&BG600L_Series_MUX_Application_Note 12 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 4.1.2.2. C/R The C/R (command/response) bit identifies the frame as either a command or a response. TE sends a command to the UE with the C/R bit set to 1, and the UE responses with the C/R bit set to 1. The UE sends a command with the C/R bit set to 0, and the TE responses with the C/R bit set to 0. Table 5: C/R Bit Usage Command/Response Command Response Direction TE → UE UE → TE UE → TE TE → UE C/R Value 1 0 1 0 4.1.2.3. EA EA bit extends the range of the address field. When the EA bit is set to 1 in an octet, it signifies that this octet is the last octet of the length field. When the EA bit is set to 0, it signifies that another octet of the address field follows. NOTE EA=1 is supported only currently. 4.1.3. Control Field The content of the control field defines the type of frame. See Chapter 4.2 for details of the frame types. Table 6: Coding of Control Field Frame Type HEX (P/F=0) 1 2 3 4 5 6 7 8 SABM (Set Asynchronous Balanced Mode) 0x2F 1 1 1 1 P/F 1 0 0 UA (Unnumbered Acknowledgement) 0x63 1 1 0 0 P/F 1 1 0 DM (Disconnected Mode) 0x0F 1 1 1 1 P/F 0 0 0 BG95&BG77&BG600L_Series_MUX_Application_Note 13 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note DISC (Disconnect) UIH (Unnumbered Information with Header check) UI (Unnumbered Information) 0x43 0xEF 0x03 1 1 0 0 P/F 0 1 0 1 1 1 1 P/F 1 1 1 1 1 0 0 P/F 0 0 0 P/F is the Poll/Final bit. The poll (P) bit set to 1 shall be used by one station to solicit (poll) a response or sequence of responses from the other station. The final (F) bit set to 1 shall be used by a station to indicate the response frame transmitted as the result of a soliciting (poll) command. The poll/final (P/F) bit shall serve a function in both command frames and response frames. (In command frames, the P/F bit refers to the P bit; in response frames, it is referred to as the F bit.) NOTE UI frame is not supported by Quectel modules currently. 4.1.4. Length Field Table 7: The Structure of Length Field Bit 1 E/A Bit 2 L1 Bit 3 L2 Bit 4 L3 Bit 5 L4 Bit 6 L5 Bit 7 L6 Bit 8 L7 The L1 to L7 bits indicate the length of the following data field for the information field less than 128 bytes. The range of the length field may be extended by use of the EA bit. When the EA bit is set to 1 in an octet, it signifies that this octet is the last octet of the length field. When the EA bit is set to 0, it signifies that a second octet of the length field follows. The total length of the length field is 15 bits in that case. 4.1.5. Information Field The information field is the payload of the frame and carries the user data and any convergence layer information. The field is octet structured and only presents in UIH frames. 4.1.6. FCS Field In the case of the UIH frame, the contents of the information field shall not be included in the FCS BG95&BG77&BG600L_Series_MUX_Application_Note 14 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note calculation. FCS is calculated on the contents of the address, control and length fields only. This means that only the delivery to the correct DLCI is protected, but not the information. 4.2. Frame Types 4.2.1. SAMB SABM is a command frame and is used to establish DLC between TE and UE. 4.2.2. UA The UA frame is a response to SABM or DISC frame, as illustrated in the following figure. SABM (Set up DLC 1) UE TE Quectel Multiplexer UA (Response) DISC (Close DLC 1) Client Receiver UA (Response) Figure 2: UA Frame (Response) 4.2.3. DM The DM response frame is used to report a status where the station is logically disconnected from the data link. When in disconnected mode, no commands are accepted until the disconnected mode is terminated by the receipt of a SABM command. If a DISC command is received while in disconnected mode, a DM response is sent. 4.2.4. DISC DISC is a command frame and is used to close down DLC. Prior to executing the command, the receiving station shall confirm the acceptance of the DISC command by the transmission of a UA response. See the figure above. BG95&BG77&BG600L_Series_MUX_Application_Note 15 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 4.2.5. UIH The UIH command/response sends user data at either station. 4.3. Multiplexer Control Channel At the initiation of communication between the TE and UE, a control channel is set up with DLCI 0. This channel is used to convey information between the two multiplexers. Multiplexer control channel is the basic channel which is used to establish a DLC, launch power saving, wake up from power saving and implement flow control mechanism. 4.3.1. Message Format All UIH frames are transmitted through the control channel and conform to the following type, length and value format. Table 8: Message Format Type Length Value 1 Value 2 … Each box in this table represents a field of minimum size one octet. Value n 4.3.1.1. Type Field The first type field octet has the following format: Table 9: Message Format – Type Field 1 2 3 4 5 6 7 8 EA C/R T1 T2 T3 T4 T5 T6 The EA bit is an extension bit. It is set to 1 in the last octet of the sequence. In other octets, EA is set to 0. In Quectel multiplexing system, only one octet is transmitted so EA is always set to 1. The C/R bit indicates whether the message is a command or a response. BG95&BG77&BG600L_Series_MUX_Application_Note 16 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note The T bits indicate the type coding. Each command has a unique pattern of bit sequence. This means that a single-octet type field can encode 63 different message types. Only single octet message types are defined in this document. 4.3.1.2. Length Field The length field octet has the following structure: Table 10: Message Format – Length Field 1 2 3 4 5 6 7 8 EA L1 L2 L3 L4 L6 L6 L7 The EA bit is an extension bit. It is set to 1 in the last octet of the sequence. In other octets EA is set to 0. In Quectel multiplexing system, only one octet is transmitted so EA is always set to 1. The L bits define the number of value octets that follows. L1 is the LSB and L7 is the MSB; this permits messages with up to 127 value octets to be constructed. 4.3.1.3. Value Field The contents of the value octets are defined for each message type in Chapter 4.3.2. 4.3.2. Message Type and Actions 4.3.2.1. Power Saving Control (PSC) The power saving control messages use the following type field octet: Table 11: Power Saving Control Message – Type Field Format 1 2 3 4 5 6 7 8 EA C/R 0 0 0 0 1 0 The length byte contains the value 0 and there are no value octets. If the UE wants the TE to enter a low-power state, it transmits a power saving control command; then the BG95&BG77&BG600L_Series_MUX_Application_Note 17 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note TE replies with a power saving control response. 4.3.2.2. Multiplexer Close Down (CLD) The multiplexer close down command is used to reset the link into normal AT command mode without multiplexing. The multiplexer closes down messages use the following type field octet: Table 12: Multiplexer Close-down Message – Type Field Format 1 2 3 4 5 6 7 8 EA C/R 0 0 0 0 1 1 The length byte contains the value 0 and there are no value octets. 4.3.2.3. Flow Control On Command (FCon) The flow control command is used to handle the aggregate flow. When either entity is able to receive new information, it transmits FCon command. The length byte contains the value 0 and there are no value octets. The type field octet has the following format: Table 13: Flow Control On Command – Type Field Format 1 2 3 4 5 6 7 8 EA C/R 0 0 0 1 0 1 4.3.2.4. Flow Control Off Command (FCoff) The flow control command is used to handle the aggregate flow. When either entity is not able to receive information, it transmits the FCoff command. The opposite entity is not allowed to transmit frames except on the control channel (DLC=0). The length byte contains the value 0 and there are no value octets. The type field octet has the following format: BG95&BG77&BG600L_Series_MUX_Application_Note 18 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note Table 14: Flow Control Off Command – Type Field Format 1 2 3 4 5 6 7 8 EA C/R 0 0 0 1 1 0 4.3.2.5. Modem Status Command (MSC) It is desired to convey virtual V.24 control signals to a data stream by sending the MSC command. The MSC command has one mandatory control signal byte and an optional break signal byte. This command is only relevant when the basic option is chosen. Send this command prior to any user data after a creation of a DLC. Table 15: Modem Status Command Command Length DLCI V.24 Signals Break Signals (optional) The length byte contains the value 2 or 3 and there are 2 or 3 value octets. Both the DTE and DCE use this command to notify each other of the status of their own V.24 control signals. The length of the MSC command is either 4 or 5 bytes depending on the break signal. The command field octet has the following format: Table 16: Modem Status Command – Command Field Format 1 2 3 4 5 6 7 8 EA C/R 0 0 0 1 1 1 The C/R bit indicates if it is a Modem Status Command or Modem Status Response. Every time the signals change, the DTE or DCE sends this command to indicate the current status of each signal. When a DTE or DCE receives a Modem Command, it always sends a Response back. The mappings of the V.24 signals to the bits in the control signal octet for the receiver and sender are given in Table 19 and Table 20 below, respectively. In a MSC command it is the status of the sender’s own V.24 signals that is sent, but in a Response it is copy of the V.24 signals that are received from the Command frame that is returned. BG95&BG77&BG600L_Series_MUX_Application_Note 19 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note The DLCI field identifies the specific DLC to which the command applies. Bit 2 is always set to 1 and the EA bit is set according to the description in Chapter 4.1.2.3. Table 17: Format of Address Field Bit 1 EA Bit 2 1 Bit 3 Bit 4 Bit 5 Bit 6 DLCI Bit 7 Bit 8 The DLCI field is followed by the control signals field which contains a representation of the state of the signals in accordance with the format below. The use of the extension bit allows other octets to be added to cater for other circumstances. At present, an optional second octet is defined for handling the transmission of break signals. Table 18: Format of Control Signal Octet Bit No. 1 2 3 4 5 6 7 8 Signal EA FC RTC RTR Reserved (0) Reserved (0) IC DV Description of the control signal byte: Bit 1: The EA bit is set to 1 in the last octet of the sequence; in other octets EA is set to 0. In Quectel multiplexing system, only one octet is transmitted so EA is always set to 1. Bit 2: Flow Control (FC). The bit is set to 1 when the device is unable to accept frames. Bit 3: Ready to Communicate (RTC). The bit is set to 1 when the device is ready to communicate. Bit 4: Ready to Receive (RTR). The bit is set to 1 when the device is ready to receive data. Bit 5: Reserved for future use. Set to zero by the sender, ignored by the receiver. Bit 6: Reserved for future use. Set to zero by the sender, ignored by the receiver. Bit 7: Incoming Call Indicator (IC). The bit is set to 1 to indicate an incoming call. Bit 8: Data Valid (DV). The bit is set to 1 to indicate that valid data is being sent. The control byte is mapped to V.24 signals according to the two tables below: BG95&BG77&BG600L_Series_MUX_Application_Note 20 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note Table 19: Mapping from the Control Signal Octet by a Receiving Entity Control Signal Byte Bit number, name 3, RTC 4, RTR 7, IC 8, DV DTE Receiving Signal V.24 circuit DSR 107 CTS 106 RI 125 DCD 109 DCE Receiving Signal V.24 circuit DTR 108/2 RFR 1) 133 Ignored - Ignored - NOTE 1) Circuit 133, RFR (Ready for Receiving) is commonly assigned to the connector pin that is alternatively used for circuit 105, RTS (Ready to Send). Table 20: Mapping to the Control Signal Octet by a Sending Entity Control Signal Byte Bit number, name 3, RTC 4, RTR 7, IC 8, DV DTE Sending Signal, V.24 circuit DTR 108/2 RFR 1) 133 Always 0 - Always 1 - DCE Sending Signal DSR CTS RI DCD V.24 circuit 107 106 125 109 NOTE 1) Circuit 133, RFR (Ready for Receiving) is commonly assigned to the connector pin that is alternatively used for circuit 105, RTS (Ready to Send). If a station is unable to transmit frames because of flow control but wishes to stop accepting further frames itself, it may still send frames containing no user data (i.e. only the control signal octet and, optionally, the break signal octet) in order to control signal flow. BG95&BG77&BG600L_Series_MUX_Application_Note 21 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 4.4. Procedures 4.4.1. DLC Establishment In most cases the establishment of a DLC will be initiated by the TE. However, the protocol is balanced and the initiation may come from the UE. The action taken by the higher layers of the TE upon the initiation of the establishment of a DLC from the UE is outside the scope of this document. The station wishing to establish a DLC transmits a SABM frame with the P-bit set to 1. The address field contains the DLCI value associated with the desired connection. If the responding station is ready to establish the connection, it will reply with a UA frame with the F-bit set to 1. If the responding station is not ready or unwilling to establish the particular DLC, it will reply with a DM frame with the F-bit set to 1. Once a DLC has been established, the stations are both said to be in a connected mode, for the particular DLC, and transfer of information may commence. If no UA or DM response has been received after T1, the initiating station may retransmit the SABM. This action may be repeated until a response is obtained or action is taken by a higher layer. If no negotiation procedure is used, DLC parameters are the default one. 4.4.2. DLC Release The release of a DLC may be initiated by either station by the transmission of a DISC frame with the P-bit set to 1. Confirmation of the DLC release is signaled by the other station sending a UA frame with the F-bit set to 1. Once the DLC has been released, the stations enter disconnected mode for that particular DLC. If the station receiving the DISC command is already in disconnected mode, it will send a DM response. If no UA or DM response has been received after T1, the initiating station may retransmit the DISC. This action may be repeated until a response is obtained or action is taken by a higher layer. 4.4.3. Information Transfer 4.4.3.1. Information Data In Quectel multiplexing system, information is conveyed using UIH frames. UIH frames may also be used for data in situations where the delays inherent in error-recovery procedures are unacceptable, such as transmission of voice data. The transmitter takes information from the convergence layer for the particular DLC and places it in the BG95&BG77&BG600L_Series_MUX_Application_Note 22 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note information field of the transmitted frame. Once a UIH frame has been correctly received, the contents of its information field are passed to the convergence layer. The frames sent by the initiating station have the C/R bit set to 1 and those sent by the responding station have the C/R bit set to 0. Both stations set the P-bit as 0. See Chapter 4.1.2.2 for more details about C/R bit. The maximum length of the information field in UIH frames is in AT+CMUX. 4.4.4. Time-out Considerations In order to detect a no-reply or lost-reply condition, each station provides a response time-out function (T1). The expiry of the time-out function is used to initiate appropriate error recovery procedures. The duration of the time-out function in the two stations is unequal in order to resolve contention situations. The time-out function is started whenever a station has transmitted a frame for which a reply is required. When the expected reply is received, the time-out function is stopped. If during the interval that the time-out function is running, other frames are sent for which acknowledgements are required, the time-out function have to be restarted. If the response time-out function runs out, a command with the P-bit set to 1 may be (re)transmitted, and the response time-out function is restarted. 4.4.5. Flow Control Quectel multiplexing system supports software flow control mechanism. Software flow control is implemented by 3GPP TS 27.010 MSC, FCoff and FCon message frames. TE sends MSC message to UE with FC bit set to 1 in V.24 control signals when TE refuses to accept frames, and with FC bit set to 0 to inform recovery of receiving frames. When receiving MSC, UE sends a response to indicate recovery of data transmission. TE sends FCoff command to UE when it refuses to accept anything except for the control messages on DLC0. In such a case, UE stops sending any frame through all the data channels except the control channel which is still alive and free to send any control message. TE can send FCon command to UE to recover the transmission. When UE receives FCoff or FCon command, it sends a response back. The difference between MSC and FCon is that the former only controls one of the data channels, while the latter controls all the data channels except control channel. BG95&BG77&BG600L_Series_MUX_Application_Note 23 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 5 Examples 5.1. Samples for Frame Structure Sample 1: Opening Flag Address Field F9 03 Header DLCI 0 Control Field 3F SABM Frame Length Field FCS Closing Flag 01 1C F9 0, No Information Filed Tail This sample is a SABM frame to open DLCI 0. Sample 2: Opening Flag F9 Header Address Field 05 DLCI 1 Control Field EF Length Field 09 UIH Frame 4 Closing Information Field FCS Flag 41 54 49 0D 58 F9 AT command Tail string 'ATI' This sample is a UIH frame to transmit the AT command string 'ATI'. Sample 3: Opening Flag F9 Header Address Field 01 DLCI 0 Control Field EF Length Field 0B UIH Frame 5 Information Field E3 07 07 0D 01 MSC Message, Length 3 Closing FCS Flag 79 F9 Tail This sample is a MSC message carried in UIH frame to transmit V2.4 signal 0x0D. BG95&BG77&BG600L_Series_MUX_Application_Note 24 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 5.2. Channels Establishment Step 1: Launch Multiplexer No. Step Data Direction Hex Comment TE launches UE multiplexer function via TE → UE AT command 1 UE sends a response TE ← UE 41 54 2B 43 4D 55 58 3D 30 AT+CMUX=0 0D AT+CMUX=0 41 54 2B 43 4D 55 58 3D 30 OK 0D 0D 0A 4F4B 0D 0A Step 2: Establish DLCI 0 No. Step Data Direction Hex Comment TE requests to establish control channel DLCI 0 by sending SABM TE → UE frame 1 UE replies with the UA response upon receiving SABM frame and accepts to TE ← UE create DLCI 0 F9 03 3F 01 1C F9 SABM Frame F9 03 73 01 D7 F9 UA Frame Step 3: Establish DLCI 1–4 No. Step Data Direction Hex Comment TE requests to establish DLCI 9 by TE → UE sending SABM frame 1 UE replies with the DM response upon receiving SABM but refuses to TE ← UE create DLCI 9 TE requests to establish DLCI 1 by TE → UE sending SABM frame UE replies with the UA response upon receiving SABM and accepts to TE ← UE 2 create DLCI 1 TE sends MSC message frames TE → UE UE replies with a response TE ← UE TE requests to establish DLCI 2 by 3 TE → UE sending SABM frame F9 27 3F 01 0B F9 F9 27 1F 01 21 F9 F9 07 3F 01 DE F9 F9 07 73 01 15 F9 F9 01 EF 0B E3 07 07 0D 01 79 F9 F9 03 EF 0B E1 07 07 0D 01 18 F9 F9 0B 3F 01 59 F9 BG95&BG77&BG600L_Series_MUX_Application_Note 25 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note UE replies with the UA response upon receiving SABM and accepts to TE ← UE create DLCI 2 TE sends MSC message frames TE → UE UE replies with a response TE ← UE Establishment of DLCI 3 and DLCI 4 4 are the same as above. By now, 4 channels have come into 5 existence, and Quectel multiplexing system can work normally. F9 0B 73 01 92 F9 F9 01 EF 0B E3 07 0B 0D 01 79 F9 F9 03 EF 0B E1 07 0B 0D 01 18 F9 This sample is a MSC message carried in UIH frame to transmit V2.4 signal 0x0D. 5.3. Frame Transmission After the control channel and data channels are established, TE and UE can transmit data to each other through UIH frames. Frame Transmission: No. Step Data Direction Hex Comment TE sends the AT command TE → UE string 'ATI' on DLCI 1 1 UE replies with a response TE ← UE on DLCI 1 TE sends the AT command TE → UE string 'AT' on DLCI 2 2 UE replies with a response TE ← UE on DLCI 2 Frame transmission on DLCI 3 3 and DLCI 4 are the same as above. F9 05 EF 09 41 54 49 0D 58 F9 UIH Frame F9 05 EF 09 41 54 49 0D 58 F9 F9 05 EF 65 0D 0A 51 75 65 63 74 65 6C 0D 0A 42 47 39 36 0D 0A 52 65 76 69 73 69 6F 6E 3A 20 42 47 39 36 4D 41 52 30 32 41 30 37 4D 31 47 0D 0A 0D 0A 4F 4B 0D 0A 19 F9 UIH Frame F9 09 EF 07 41 54 0D 35 F9 UIH Frame F9 09 EF 07 41 54 0D 35 F9 F9 09 EF 0D 0D 0A 4F 4B 0D UIH Frame 0A D8 F9 BG95&BG77&BG600L_Series_MUX_Application_Note 26 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 5.4. Power Saving Mode and Wake-up Enter Power Saving Mode: No. Step Data Direction TE sends PSC message on DLCI 0 TE → UE 1 UE replies with a response on DLCI 0 TE ← UE UE enters power saving mode, and TE 2 TE → UE sends F9 continuously Hex F9 03 EF 05 43 01 F2 F9 F9 03 EF 05 41 01 F2 F9 Comment PSC Command Frame PSC Response Frame F9 F9 F9 F9…… Wake-up from Power Saving Mode: No. Step Data Direction TE sends wake up flags 1 UE replies with a response TE → UE TE ← UE UE is woken up, and data 2 transmission is recovered Hex F9 F9 F9 F9 F9 F9 F9 F9 Comment 5.5. Flow Control Flow Control: No. Step Data Direction Hex Comment UE sends MSC message with FC bit set to 1 1 on control channel DLCI 0, to indicate TE ← UE refusing to accept anything on DLCI 1. UE sends MSC message with FC bit set to 2 0 on control channel DLCI 0, to indicate TE ← UE recovery of DLCI 1 data transmission. TE sends MSC message with FC bit set to 3 1 on control channel DLCI 0, to indicate TE → UE refusing to accept anything on DLCI 1. TE sends MSC message with FC bit set to 4 0 on control channel DLCI 0, to indicate TE → UE recovery of DLCI 1 data transmission. F9 01 EF 0B E3 07 07 8F 01 79 F9 F9 01 EF 0B E3 07 07 8D 01 79 F9 F9 01 EF 0B E3 07 07 8F 01 79 F9 F9 01 EF 0B E3 07 07 8D 01 79 F9 BG95&BG77&BG600L_Series_MUX_Application_Note 27 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note TE sends FCoff message on DLCI 0, to 5 indicate refusing to accept anything on all TE → UE DLCs except DLCI 0. TE sends FCon message through DLCI 0, 6 TE → UE to indicate recovery of data transmission. F9 01 EF 05 63 01 93 F9 F9 01 EF 05 A3 01 93 F9 5.6. Synchronization After the data channels are established, TE and UE are synchronized and data transmission is normal. Every transmission is implemented by frames which begins with a starting flag (0xF9) and ends with a closing flag (0xF9). So it is called that multiplexer is synchronized with flag 0xF9. Transmitting bytes other than 0xF9 between frames is considered as faulty or synchronization lost and needs re-sync. Synchronization: No. Step Data Direction Hex Comment 1 TE receives error frame TE ← UE F9 01 EF 05 2 TE sends sync flag to re-sync with UE TE → UE UE replies with three hex values F9 to 3 TE ← UE indicate bytes received TE tests AT command transmission TE → UE through DLCI 1 after re-sync 4 UE replies with a response and TE ← UE synchronization has been reset to normal F9 F9 F9 F9 F9 F9 F9 05 EF 07 41 54 0D 06 F9 F9 05 EF 07 41 54 0D 67 F9 F9 25 EF 0D 0D 0A 4F 4B 0D 0A 8A F9 NOTES 1. Quectel BG95 series, BG77 and BG600L-M3 modules are not initiative to send sync flags (F9), even though UE receives error frames. 2. When the modules are not in power saving mode and receives more than 2 sync flags, they will send only 3 sync flags to TE, even if they receive more than 3 sync flags. 3. When the modules are in power saving mode, they will send the number of sync flags (F9) received from TE. BG95&BG77&BG600L_Series_MUX_Application_Note 28 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 5.7. Close-down of Multiplexer Close-down Procedures: No. Step Data Direction Hex Comment TE sends DISC frame to request for closing TE → UE down DLCI 1 1 UE replies with the UA frame to accept the TE ← UE request TE sends DISC frame to request for closing TE → UE down DLCI 2 2 UE replies with the UA frame to accept the TE ← UE request TE sends DISC frame to request for TE → UE closing down DLC 3 3 UE replies with the UA frame to accept the TE ← UE request TE sends DISC frame to request for closing TE → UE down DLC 4 4 UE replies with the UA frame to accept the TE ← UE request TE sends CLD message frame to request TE → UE for closing down multiplexer on DLCI 0 5 UE acknowledges the CLD message to TE ← UE accept the request F9 07 53 01 3F F9 F9 07 73 01 15 F9 F9 0B 53 01 B8 F9 F9 0B 73 01 92 F9 F9 0F 53 01 7A F9 F9 0F 73 01 50 F9 F9 13 53 01 77 F9 F9 13 73 01 5D F9 F9 03 EF 05 C3 01 F2 F9 F9 03 EF 05 C1 01 F2 F9 6 By now, the multiplexer is closed down. BG95&BG77&BG600L_Series_MUX_Application_Note 29 / 31 LPWA Module Series BG95&BG77&BG600L Series MUX Application Note 6 Appendix A References Table 21: Related Documents SN Document Name [1] 3GPP TS 27.010 version 9.0.0 Quectel_BG95&BG77&BG600L_Series_AT_ [2] Commands_Manual Remark 3rd Generation Partnership Project; Technical Specification Group Terminals; Terminal Equipment to User Equipment (TE-UE) multiplexer protocol AT commands manual of Quectel BG95 series, BG77 and BG600L-M3 modules Table 22: Terms and Abbreviations Abbreviation ABM CLD C/R DCE DISC DLC DLCI DM DTE DV FC FCS Description Asynchronous Balanced Mode Multiplexer Close Down Command/Response Data Communications Equipment Disconnect Data Link Connection Data Link Connection Identifier Disconnected Mode Data Terminal Equipment (typically computer, MCU, external controller) Data Valid Flow Control Frame Check Sequence BG95&BG77&BG600L_Series_MUX_Application_Note 30 / 31 FCoff FCon IC MSC MUX PSC RFR RTC RTR RTS SABM TE UA UE UI UIH LPWA Module Series BG95&BG77&BG600L Series MUX Application Note Flow Control Off Command Flow Control On Command Incoming Call Indicator Modem Status Command Multiplexer Power Saving Control Ready for Receiving Ready to Communicate Ready to Receive Ready to Send Set Asynchronous Balanced Mode Terminal Equipment Unnumbered Acknowledgement User Equipment Unnumbered Information Unnumbered Information with Header Check BG95&BG77&BG600L_Series_MUX_Application_Note 31 / 31

EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 LTE Standard 模块系列 版本：1.1 日期：2022-02-13 状态：受控文件 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 文档历史 修订记录 版本 日期 作者 变更表述 - 2020-09-08 Zoffy YU 文档创建 1.0 2020-10-12 Zoffy YU 受控版本 1. 新增适用模块 EG21-G、EG25-G、EG91 系列和 EG95 系列。 1.1 2022-02-13 Zoffy YU 2. 更新设备描述符的产品 ID（表 4）。 上海移远通信技术股份有限公司 3 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 2 概述 ....................................................................................................................................................... 7 3 USB 描述符........................................................................................................................................... 9 3.1. 设备描述符 ................................................................................................................................. 9 3.2. 配置描述符 ............................................................................................................................... 10 3.3. 接口描述符 ................................................................................................................................11 3.3.1. 接口 0（DM 接口） ........................................................................................................11 3.3.1.1. 端点描述符 0 ...................................................................................................... 12 3.3.1.2. 端点描述符 1 ...................................................................................................... 12 3.3.2. 接口 1（NMEA 接口） .................................................................................................. 13 3.3.2.1. 端点描述符 0 ...................................................................................................... 14 3.3.2.2. 端点描述符 1 ...................................................................................................... 14 3.3.2.3. 端点描述符 2 ...................................................................................................... 15 3.3.3. 接口 2（AT 接口） ........................................................................................................ 15 3.3.3.1. 端点描述符 0 ...................................................................................................... 16 3.3.3.2. 端点描述符 1 ...................................................................................................... 16 3.3.3.3. 端点描述符 2 ...................................................................................................... 17 3.3.4. 接口 3（Modem 接口）................................................................................................. 17 3.3.4.1. 端点描述符 0 ...................................................................................................... 18 3.3.4.2. 端点描述符 1 ...................................................................................................... 18 3.3.4.3. 端点描述符 2 ...................................................................................................... 19 3.3.5. 接口 4（USB 网络接口） .............................................................................................. 19 3.3.5.1. 端点描述符 0 ...................................................................................................... 20 3.3.5.2. 端点描述符 1 ...................................................................................................... 21 3.3.5.3. 端点描述符 2 ...................................................................................................... 21 3.3.6. 接口 5（ADB 接口） ..................................................................................................... 22 3.3.6.1. 端点描述符 0 ...................................................................................................... 22 3.3.6.2. 端点描述符 1 ...................................................................................................... 23 3.3.7. 接口 6（音频控制接口） ............................................................................................... 23 3.3.8. 接口 7（麦克风接口）................................................................................................... 24 3.3.8.1. 端点描述符 0 ...................................................................................................... 24 3.3.9. 接口 8（扬声器控制接口）............................................................................................ 25 3.3.10. 接口 9（ADB 接口） ..................................................................................................... 26 3.3.10.1. 端点描述符 0 ...................................................................................................... 26 3.3.10.2. 端点描述符 1 ...................................................................................................... 27 4 附录 参考文档及术语缩写 .................................................................................................................. 28 上海移远通信技术股份有限公司 4 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：USB 描述符概述................................................................................................................................. 7 表 3：模块 USB 接口描述 ............................................................................................................................ 8 表 4：USB 设备描述符................................................................................................................................. 9 表 5：USB 配置描述符............................................................................................................................... 10 表 6：接口 0 的接口描述符 .........................................................................................................................11 表 7：接口 0 的端点描述符 0...................................................................................................................... 12 表 8：接口 0 的端点描述符 1...................................................................................................................... 12 表 9：接口 1 的接口描述符 ........................................................................................................................ 13 表 10：接口 1 的端点描述符 0.................................................................................................................... 14 表 11：接口 1 的端点描述符 1.................................................................................................................... 14 表 12：接口 1 的端点描述符 2.................................................................................................................... 15 表 13：接口 2 的接口描述符 ...................................................................................................................... 15 表 14：接口 2 的端点描述符 0.................................................................................................................... 16 表 15：接口 2 的端点描述符 1.................................................................................................................... 16 表 16：接口 2 的端点描述符 2.................................................................................................................... 17 表 17：接口 3 的接口描述符 ...................................................................................................................... 17 表 18：接口 3 的端点描述符 0.................................................................................................................... 18 表 19：接口 3 的端点描述符 1.................................................................................................................... 18 表 20：接口 3 的端点描述符 2.................................................................................................................... 19 表 21：接口 4 的接口描述符 ...................................................................................................................... 19 表 22：接口 4 的端点描述符 0.................................................................................................................... 20 表 23：接口 4 的端点描述符 1.................................................................................................................... 21 表 24：接口 4 的端点描述符 2.................................................................................................................... 21 表 25：接口 5 的接口描述符 ...................................................................................................................... 22 表 26：接口 5 的端点描述符 0.................................................................................................................... 22 表 27：接口 5 的端点描述符 1.................................................................................................................... 23 表 28：接口 6 的接口描述符 ...................................................................................................................... 23 表 29：接口 7 的接口描述符 ...................................................................................................................... 24 表 30：接口 7 的端点描述符 0.................................................................................................................... 24 表 31：接口 8 的接口描述符 ...................................................................................................................... 25 表 32：接口 9 的接口描述符 ...................................................................................................................... 26 表 33：接口 9 的端点描述符 0.................................................................................................................... 26 表 34：接口 9 的端点描述符 1.................................................................................................................... 27 表 35：参考文档 ......................................................................................................................................... 28 表 36：术语缩写 ......................................................................................................................................... 28 上海移远通信技术股份有限公司 5 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 1 引言 本文档主要介绍了移远通信 LTE Standard EC2x 系列、EG2x-G 和 EG9x 系列模块的 USB 描述符。 Host 通过各种描述符来识别 USB 设备（模块），包括设备描述符、配置描述符、接口描述符、端点描述符 和字符串描述符（可选）。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG2x-G EG9x 模块 EC21 系列 EC25 系列 EC20-CE EC20-CN EG21-G EG25-G EG91 系列 EG95 系列 上海移远通信技术股份有限公司 6 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 2 概述 USB 描述符的概述如下表。 表 2：USB 描述符概述 USB 描述符 作用 备注 设备描述符 配置描述符 接口描述符 端点描述符 字符串描述符 （可选） 描述 USB 设备的通用信息，包括所有的设备配 置，例如 USB 设备使用的 USB 协议版本号、 一台设备只有一个设备描述符。 设备类型以及设备的其他参数信息 一台设备可以有多个配置描述符。一个 描述特定 USB 设备的配置信息，例如支持的接 配置所支持的接口数由配置描述符的 口数量、供电方式等 bNumInterfaces 决定。 当一个配置支持多个接口，那一个接口 下的所有端点描述符经常是作为一个配 描述一个配置下的特定接口 置描述符下的一部分返回。接口描述符 不 能 使 用 GetDescriptor() 或 SetDescriptor()请求直接访问。 描述 USB 端点的一般信息 USB 设备中的每个端点均有各自的端 点描述符，其数量由接口描述符的 bNumEndpoint 决定。 ⚫ 字符串描述符由 3 三个字段按照固 定的顺序组成，该描述符的总长度 不是固定的，长度随字符串的数量 保存一些供应商名称、产品序列号等文本信息 和信息的长度而变化。 ⚫ 可选。如果不支持字符串描述符， 其设备、配置、接口描述符内的所 有字符串描述符索引都必须为 0。 上海移远通信技术股份有限公司 7 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 Host 连接 EC2x 系列、EG2x-G 和 EG9x 系列模块时，模块默认显示 6 个接口（如下表中所示的 0~5）。 所有支持的 USB 接口具有不同的功能，详见下表。 表 3：模块 USB 接口描述 接口号 0 1 2 3 4 5 6 7 8 9 接口名称 移动诊断接口 Modem 接口 NMEA 接口 AT 接口 USB 网络接口 ADB 接口 Audio 控制接口 麦克风接口 扬声器接口 ADB 接口 描述 诊断端口 用于 PPP 连接和 AT 命令传输 用于输出 GPS NMEA 语句 用于 AT 命令传输 用于网络驱动 安卓调试桥 用于控制语音 用于麦克风 用于扬声器 安卓调试桥 有关各 USB 接口的接口描述符，请参考第 3.3 章。 备注 接口 6、7、8 和 9 默认不显示，可通过 AT+QCFG='usbcfg'打开。关于该 AT 命令的详细信息，请参考 文档 [1]。 上海移远通信技术股份有限公司 8 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 3 USB 描述符 EC2x 系列、EG2x-G 和 EG9x 系列模块均为 USB 复合通信设备。待模块 USB 驱动安装到 Windows 或 Linux 操作系统后，操作系统自动读取模块的设备描述符以及配置描述符，同时根据配置描述符下的接口 描述符创建指定接口。 本章节主要介绍了 EC2x 系列、EG2x-G 和 EG9x 系列模块的设备描述符、配置描述符、接口描述符以 及端点描述符（字符串描述符客户无需使用）。 备注 EC2x 系列、EG2x-G 和 EG9x 系列模块支持的配置网卡拨号方式为 ECM、RNDIS、NDIS 和 MBIM。Linux 系统可自动读取描述符信息，Windows 系统则需先安装上述各驱动后方可实现自动读取。 3.1. 设备描述符 本章节介绍了 EC2x 系列、EG2x-G 和 EG9x 系列模块的 USB 设备描述符。 表 4：USB 设备描述符 参数名称 bLength bDescriptorType bcdUSB bDeviceClass bDeviceSubClass bDeviceProtocol 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 18 1 设备适用的 USB 协议版本 512 设备类型代码 239 设备子类型代码，由设备类型 代码分配 2 协议代码 1 值 十六进制 0x12 0x01 0x0200 0xEF 0x02 0x01 描述 18 字节 设备描述符 USB 2.0 版本 混合型设备 2 IAD – 接口关 联描述符 上海移远通信技术股份有限公司 9 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 bMaxPacketSize0 idVendor idProduct bcdDevice iManufacturer iProduct iSerialNumber bNumConfigurations 端点 0 最大分组大小。 单位：字节。 供应商ID 64 11388 产品ID EC21系列 289 EC25系列 293 EC20-CN/ 288 EC20-CE EG21-G 289 EG25-G 293 EG91系列 401 EG95系列 405 设备出厂编码 792 厂商字符串描述符索引 1 产品字符串描述符索引 2 设备序列号字符串描述符索引 0 设备的配置描述符的个数 1 0x40 0x2C7C 0x121 0x125 0x120 0x121 0x125 0x191 0x195 0x0318 0x01 0x02 0x00 0x01 64字节 上海移远通信 股份有限公司 EC21 EC25 EC20 EG21 EG25 EG91 EG95 792 1 2 0 1 3.2. 配置描述符 本章节介绍了 EC2x 系列、EG2x-G 和 EG9x 系列模块的 USB 配置描述符。 表 5：USB 配置描述符 参数名称 bLength bDescriptorType wTotalLength 参数解释 描述符大小； 单位：字节 描述符类型 该配置返回的数据总长度； 值 十进制 十六进制 9 0x09 2 0x02 428 0x01AC 描述 9 字节 配置描述符 428 字节 上海移远通信技术股份有限公司 10 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 单位：字节 bNumInterface bConfigurationValue iConfiguration bmAttributes bmAttributes.Reserved D7 bmAttributes.SelfPowered D6 bmAttributes.RemoteWakeup D5 bmAttributes.Reserved D4..0 bMaxPower 该配置支持的接口数 10 配置值。仅在设备驱动的系统 软件部分需要时使用。 1 描述该配置描述符的字符串描 述符索引 0 USB 设备特性 224 bmAttributes的第7个字节为 预留 1 是否通过USB_VBUS给USB 设备供电 1 远程唤醒 1 bmAttributes的第4个字节为 预留 0 USB设备全功能运行时该配置 需要消耗的电流。 250 单位：2 mA。 0x0A 0x01 0x00 0xE0 0x01 0x01 0x01 0x00 0xFA 10 个接口 配置 1 无字符串描 述符 224 1 是 1 0 500 mA 3.3. 接口描述符 本章节介绍了 EC2x 系列、EG2x-G 和 EG9x 系列模块的 USB 接口描述符。 3.3.1. 接口 0（DM 接口） 表 6：接口 0 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 0 用来识别同一个接口的不同 接口描述符 0 值 十六进制 0x09 0x04 0x00 0x00 描述 9 字节 接口描述符 0 0 上海移远通信技术股份有限公司 11 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 接口使用的端点数 2 接口类型代码 2 接口子类型代码 6 接口协议代码 0 接口字符串描述符的索引 0 0x02 0x02 0x06 0x00 0x00 2 个端点 2 6 0 0 3.3.1.1. 端点描述符 0 表 7：接口 0 的端点描述符 0 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 十进制 7 5 bEndpointAddress 端点地址 129 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数 据传送端点的时间间隔。 0 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x81 0x02 端点描述符 Direction = IN EndpointID = 129 TransferType = Bulk 0x0200 512 字节 0x00 0 3.3.1.2. 端点描述符 1 表 8：接口 0 的端点描述符 1 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 上海移远通信技术股份有限公司 十进制 7 5 值 十六进制 描述 0x07 7 字节 0x05 端点描述符 12 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 bEndpointAddress 端点地址 1 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大 分组包大小。单位：字节。 512 数据传输中断发生时，轮 询数据传送端点的时间间 0 隔。单位：毫秒。 0x01 0x02 0x0200 0x00 Direction = OUT EndpointID = 1 TransferType = Bulk 512 字节 0 3.3.2. 接口 1（NMEA 接口） 表 9：接口 1 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 1 用来识别同一个接口的不同接 口描述符 0 接口使用的端点数 3 接口类型代码 255 接口子类型代码 0 接口协议代码 0 接口字符串描述符的索引 0 值 十六进制 描述 0x09 9 字节 0x04 0x01 接口描述符 1 0x00 0x03 0xFF 0x00 0x00 0x00 0 3 个端点 255 0 0 0 上海移远通信技术股份有限公司 13 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 3.3.2.1. 端点描述符 0 表 10：接口 1 的端点描述符 0 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 bEndpointAddress 端点地址 十进制 7 5 131 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 3 本端点可接收或发送最大分组 包大小。单位：字节。 10 数据传输中断发生时，轮询数 据传送端点的时间间隔。 9 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x83 0x03 0x0A 端点描述符 Direction = IN EndpointID = 131 TransferType = Interrupt 10 字节 0x09 9 3.3.2.2. 端点描述符 1 表 11：接口 1 的端点描述符 1 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 十进制 7 5 bEndpointAddress 端点地址 130 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 十六进制 0x07 0x05 0x82 0x02 0x0200 0x00 值 描述 7 字节 端点描述符 Direction = OUT EndpointID = 130 TransferType = Bulk 512 字节 0 上海移远通信技术股份有限公司 14 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 3.3.2.3. 端点描述符 2 表 12：接口 1 的端点描述符 2 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 十进制 7 5 bEndpointAddress 端点地址 2 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组包 大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x02 0x02 端点描述符 Direction = OUT EndpointID = 2 TransferType = Bulk 0x0200 512 字节 0x00 0 3.3.3. 接口 2（AT 接口） 表 13：接口 2 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 2 用来识别同一个接口的不 同接口描述符 0 接口使用的端点数 3 接口类型代码 255 接口子类型代码 0 接口协议代码 0 值 十六进制 0x09 0x04 0x02 0x00 0x03 0xFF 0x00 0x00 描述 9 字节 接口描述符 2 0 3 个端点 255 0x00 0x00 上海移远通信技术股份有限公司 15 / 28 iInterface EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 接口字符串描述符的索引 0 0x00 0x00 3.3.3.1. 端点描述符 0 表 14：接口 2 的端点描述符 0 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 7 5 端点地址 133 端点传输类型， 2-bitmap。 3 本端点可接收或发送 最大分组包大小。 10 单位：字节。 数据传输中断发生时， 轮询数据传送端点的 9 时间间隔。单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x85 0x03 端点描述符 Direction = IN EndpointID = 133 TransferType = Interrupt 0x0A 10 字节 0x09 9 3.3.3.2. 端点描述符 1 表 15：接口 2 的端点描述符 1 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 bEndpointAddress 端点地址 bmAttributes 端点传输类型，2-bitmap。 值 十进制 十六进制 描述 7 0x07 7 字节 5 0x05 132 0x84 2 0x02 端点描述符 Direction = IN EndpointID = 132 TransferType = Bulk wMaxPacketSize 本端点可接收或发送最大分组包大 512 0x0200 512 字节 上海移远通信技术股份有限公司 16 / 28 bInterval EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 小。单位：字节。 数据传输中断发生时，轮询数据传 送端点的时间间隔。单位：毫秒。 0 0x00 0 3.3.3.3. 端点描述符 2 表 16：接口 2 的端点描述符 2 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 十进制 十六进制 7 0x07 5 0x05 bEndpointAddress 端点地址 3 0x03 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数 据传送端点的时间间隔。 0 单位：毫秒。 0x02 0x0200 0x00 值 描述 7 字节 端点描述符 Direction = OUT EndpointID = 3 TransferType = Bulk 512 字节 0 3.3.4. 接口 3（Modem 接口） 表 17：接口 3 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 3 用来识别同一个接口 的不同接口描述符 0 值 十六进制 0x09 0x04 0x03 0x00 描述 9 字节 接口描述符 3 0 上海移远通信技术股份有限公司 17 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 接口使用的端点数 3 接口类型代码 255 接口子类型代码 0 接口协议代码 0 接口字符串描述符的 索引 0 0x03 0xFF 0x00 0x00 0x00 3 个端点 255 0 0 0 3.3.4.1. 端点描述符 0 表 18：接口 3 的端点描述符 0 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 bEndpointAddress 端点地址 十进制 7 5 135 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 3 本端点可接收或发送最大分组 包大小。单位：字节。 10 数据传输中断发生时，轮询数 据传送端点的时间间隔。 9 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x87 0x03 0x0A 端点描述符 Direction = IN EndpointID = 135 TransferType = Interrupt 10 字节 0x09 9 毫秒 3.3.4.2. 端点描述符 1 表 19：接口 3 的端点描述符 1 参数名称 bLength 参数解释 描述符大小。 单位：字节。 十进制 7 值 十六进制 描述 0x07 7 字节 上海移远通信技术股份有限公司 18 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 bDescriptorType 描述符类型 5 bEndpointAddress 端点地址 134 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 0x05 0x86 0x02 端点描述符 Direction = IN EndpointID = 134 TransferType = Bulk 0x0200 512 字节 0x00 0 3.3.4.3. 端点描述符 2 表 20：接口 3 的端点描述符 2 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 十进制 7 5 bEndpointAddress 端点地址 4 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数据 传送端点的时间间隔。 0 单位：毫秒。 十六进制 0x07 0x05 0x04 0x02 0x0200 0x00 值 描述 7 字节 端点描述符 Direction = OUT EndpointID = 4 TransferType = Bulk 512 字节 0 3.3.5. 接口 4（USB 网络接口） 表 21：接口 4 的接口描述符 参数名称 bLength 参数解释 描述符大小。 单位：字节。 十进制 9 值 十六进制 0x09 描述 9 字节 上海移远通信技术股份有限公司 19 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 描述符类型 4 接口编号 4 用来识别同一个接口的不 同接口描述符 0 接口使用的端点数 3 接口类型代码 255 接口子类型代码 255 接口协议代码 255 接口字符串描述符的索引 0 0x04 0x04 0x00 0x03 0xFF 0xFF 0xFF 0x00 接口描述符 4 0 3 个端点 255 255 255 0 3.3.5.1. 端点描述符 0 表 22：接口 4 的端点描述符 0 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 描述符大小。 单位：字节。 描述符类型 端点地址 十进制 7 5 137 端点传输类型，2-bitmap。 3 本端点可接收或发送最大 分组包大小。单位：字节。 8 数据传输中断发生时，轮 询数据传送端点的时间间 9 隔。单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x89 0x03 0x0008 端点描述符 Direction = IN EndpointID = 137 TransferType = Interrupt 8 字节 0x09 9 毫秒 上海移远通信技术股份有限公司 20 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 3.3.5.2. 端点描述符 1 表 23：接口 4 的端点描述符 1 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 十进制 7 5 bEndpointAddress 端点地址 136 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数 据传送端点的时间间隔。 0 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x88 0x02 端点描述符 Direction = IN EndpointID = 136 TransferType = Bulk 0x0200 512 字节 0x00 0 3.3.5.3. 端点描述符 2 表 24：接口 4 的端点描述符 2 参数名称 参数解释 bLength bDescriptorType 描述符大小。 单位：字节。 描述符类型 十进制 7 5 bEndpointAddress 端点地址 2 bmAttributes wMaxPacketSize bInterval 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数 据传送端点的时间间隔。 0 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x02 0x02 端点描述符 Direction = OUT EndpointID = 2 TransferType = Bulk 0x0200 512 字节 0x00 0 上海移远通信技术股份有限公司 21 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 3.3.6. 接口 5（ADB 接口） 表 25：接口 5 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 参数解释 描述符大小。 单位：字节。 描述符类型 接口编号 用来识别同一个接口的不 同接口描述符 接口使用的端点数 接口类型代码 接口子类型代码 接口协议代码 接口字符串描述符的索引 十进制 9 4 5 0 2 255 66 1 7 值 十六进制 0x09 0x04 0x05 0x00 0x02 0xFF 0x42 0x01 0x07 描述 9 字节 接口描述符 5 0 2 个端点 255 66 1 7 3.3.6.1. 端点描述符 0 表 26：接口 5 的端点描述符 0 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 7 5 端点地址 6 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 值 十六进制 描述 0x07 7 字节 0x05 0x06 0x02 端点描述符 Direction = IN EndpointID = 5 TransferType = Bulk 0x0200 512 字节 上海移远通信技术股份有限公司 22 / 28 bInterval EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 数据传输中断发生时，轮询数 据传送端点的时间间隔。 0 单位：毫秒。 0x00 0 3.3.6.2. 端点描述符 1 表 27：接口 5 的端点描述符 1 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 7 5 端点地址 138 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 数据传输中断发生时，轮询数 据传送端点的时间间隔。 0 单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x8A 0x02 端点描述符 Direction = IN EndpointID = 138 TransferType = Bulk 0x0200 512 字节 0x00 0 3.3.7. 接口 6（音频控制接口） 表 28：接口 6 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 6 用来识别同一个接口的 不同接口描述符 0 接口使用的端点数 0 值 十六进制 描述 0x09 9 字节 0x04 0x06 接口描述符 6 0x00 0 0x00 0 个端点 上海移远通信技术股份有限公司 23 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 接口类型代码 1 接口子类型代码 1 接口协议代码 0 接口字符串描述符的索 引 8 0x01 1 0x01 1 0x00 0 0x08 8 3.3.8. 接口 7（麦克风接口） 表 29：接口 7 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 7 用来识别同一个接口的 不同接口描述符 0 接口使用的端点数 1 接口类型代码 1 接口子类型代码 2 接口协议代码 0 接口字符串描述符的索 引 0 值 十六进制 描述 0x09 0x04 0x07 9 字节 接口描述符 7 0x00 0 0x01 0x01 0x02 0x00 1 个端点 1 2 0 0x00 0 3.3.8.1. 端点描述符 0 表 30：接口 7 的端点描述符 0 参数名称 bLength 参数解释 描述符大小。 上海移远通信技术股份有限公司 十进制 7 值 十六进制 描述 0x07 7 字节 24 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 单位：字节。 bDescriptorType 描述符类型 5 bEndpointAddress 端点地址 139 bmAttributes wMaxPacketSize 端点传输类型，2-bitmap。 5 本端点可接收或发送最大 分组包大小。单位：字节。 2047 0x05 0x8B 0x05 0x07FF 端点描述符 Direction = IN EndpointID = 139 TransferType = Isochronous 2047 字节 3.3.9. 接口 8（扬声器控制接口） 表 31：接口 8 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 8 用来识别同一个接口的不 同接口描述符 0 接口使用的端点数 0 接口类型代码 1 接口子类型代码 2 接口协议代码 0 接口字符串描述符的索引 13 值 十六进制 描述 0x09 9 字节 0x04 0x08 接口描述符 8 0x00 0 0x00 0x01 0x02 0x00 0x0D 0 个端点 1 2 0 13 上海移远通信技术股份有限公司 25 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 3.3.10. 接口 9（ADB 接口） 表 32：接口 9 的接口描述符 参数名称 bLength bDescriptorType bInterfaceNumber bAlternateSetting bNumEndpoints bInterfaceClass bInterfaceSubClass bInterfaceProtocol iInterface 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 9 4 接口编号 9 用来识别同一个接口的不 同接口描述符 0 接口使用的端点数 2 接口类型代码 255 接口子类型代码 66 接口协议代码 1 接口字符串描述符的索引 7 值 十六进制 描述 0x09 9 字节 0x04 0x09 接口描述符 9 0x00 0 0x02 0xFF 0x42 0x01 0x07 2 个端点 255 66 1 7 3.3.10.1.端点描述符 0 表 33：接口 9 的端点描述符 0 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 十六进制 7 0x07 5 0x05 端点地址 8 0x08 端点传输类型，2-bitmap。 2 本端点可接收或发送最大分组 包大小。单位：字节。 512 0x02 0x0200 值 描述 7 字节 端点描述符 Direction = OUT EndpointID = 8 TransferType = Bulk 512 字节 上海移远通信技术股份有限公司 26 / 28 bInterval EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 数据传输中断发生时，轮询数 据传送端点的时间间隔。 0 0x00 0 单位：毫秒。 3.3.10.2.端点描述符 1 表 34：接口 9 的端点描述符 1 参数名称 bLength bDescriptorType bEndpointAddress bmAttributes wMaxPacketSize bInterval 参数解释 描述符大小。 单位：字节。 描述符类型 十进制 7 5 端点地址 140 端点传输类型， 2-bitmap。 2 本端点可接收或发送最 大分组包大小。单位： 512 字节。 数据传输中断发生时， 轮询数据传送端点的时 0 间间隔。单位：毫秒。 值 十六进制 描述 0x07 7 字节 0x05 0x8C 0x02 端点描述符 Direction = IN EndpointID = 140 TransferType = Bulk 0x0200 512 字节 0x00 0 上海移远通信技术股份有限公司 27 / 28 EC2x&EG2x-G&EG9x 系列 USB 描述符介绍 4 附录 参考文档及术语缩写 表 35：参考文档 文档名称 [1] Quectel_EC2x&EG2x-G&EG9x&EM05_Series_QCFG_AT_Commands_Manual 表 36：术语缩写 缩写 ADB CDC ECM GPS IAD LTE NMEA PPP RNDIS USB 英文全称 Android Debug Bridge Communications Device Class Ethernet Networking Control Model Global Positioning System Interface Association Descriptor Long-Term Evolution NMEA (National Marine Electronics Association) 0183 Interface Standard Point-to-Point Protocol Remote Network Driver Interface Specification Universal Serial Bus 中文全称 安卓调试桥 通信设备类 以太网控制模型 全球定位系统 接口关联描述符 长期演进 NMEA（美国国家海洋电子协会）0183 接口标准 点到点协议 远程网络驱动接口规范 通用串行总线 上海移远通信技术股份有限公司 28 / 28

BC25&BC32 系列 DFOTA 应用指导 NB-loT 模块系列 版本：1.1 日期：2021-08-09 状态：受控文件 BC25&BC32 系列 DFOTA 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 46 BC25&BC32 系列 DFOTA 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-07-04 2021-08-09 作者 Fonda FANG/ Peyton LI Koala LI/ Jack QIAN 变更表述 初始版本 1. 增加中国电信 AEP 平台 DFOTA（第 3.2 章）； 2. 增加电信 IoT/AEP 平台受控 DFOTA 章节（第 3.3 章）； 3. 更新电信 IoT/AEP DFOTA 过程说明及注意事项内容 （第 3.4 章）； 4. 补充术语缩写。 上海移远通信技术股份有限公司 2 / 46 BC25&BC32 系列 DFOTA 应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................3 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 引言.....................................................................................................................................................7 2 HTTP 服务器 DFOTA..........................................................................................................................8 2.1. 升级流程 ...................................................................................................................................8 2.1.1. 获取差分包.....................................................................................................................9 2.1.2. 存储差分包至 HTTP 服务器 ...........................................................................................9 2.1.3. 检查网络状态 .................................................................................................................9 2.1.4. 执行 AT 命令升级固件 ..................................................................................................10 2.2. DFOTA 相关 AT 命令 ..............................................................................................................10 2.2.1. AT 命令语句 .................................................................................................................10 2.2.1.1. 定义.................................................................................................................. 10 2.2.1.2. AT 命令语句 ..................................................................................................... 10 2.2.1.3. AT 命令示例声明 ...............................................................................................11 2.2.2. AT+QFOTADL 通过 DFOTA 功能升级固件 ................................................................ 11 2.2.2.1. AT+QFOTADL= 通过 HTTP 服务器进行 DFOTA 升级..............11 2.2.2.2. AT+QFOTADL= 通过本地进行 DFOTA 升级....................................... 13 2.2.2.3. AT+QFOTADL=, 通过 HTTP 服务器下载 MCU 升级文件 14 2.3. 举例 ........................................................................................................................................15 2.3.1. NB-IoT 网络下通过 HTTP 服务器进行 DFOTA.............................................................15 2.3.2. GSM 网络下通过 HTTP 服务器进行 DFOTA（仅 BC32） ...........................................16 2.3.3. 进行本地固件升级 ........................................................................................................17 2.3.4. NB-IoT 网络下从 HTTP 服务器下载 MCU 升级文件并存储至模块 ...............................18 2.3.5. GSM 网络下从 HTTP 服务器下载 MCU 升级文件并存储至模块（仅 BC32） ..............19 3 中国电信物联网平台 DFOTA.............................................................................................................20 3.1. 电信 IoT 平台 DFOTA .............................................................................................................20 3.1.1. 升级流程 ......................................................................................................................20 3.1.2. 平台注册 ......................................................................................................................20 3.1.3. 创建应用 ......................................................................................................................20 3.1.4. 生成及上传公私密钥 ....................................................................................................22 3.1.5. 差分包获取及签名 ........................................................................................................24 3.1.5.1. 获取差分包 ....................................................................................................... 24 3.1.5.2. 对差分包进行签名 ............................................................................................ 24 3.1.6. 上传差分包...................................................................................................................25 3.1.7. DFOTA 升级.................................................................................................................27 3.1.7.1. 创建升级任务 ................................................................................................... 27 3.1.7.2. 设备升级........................................................................................................... 30 上海移远通信技术股份有限公司 3 / 46 BC25&BC32 系列 DFOTA 应用指导 3.2. 电信 AEP 平台 DFOTA ...........................................................................................................32 3.2.1. 升级流程 ......................................................................................................................32 3.2.2. 平台注册 ......................................................................................................................32 3.2.3. 差分包获取及上传 ........................................................................................................33 3.2.3.1. 获取差分包 ....................................................................................................... 33 3.2.3.2. 上传差分包至 AEP 平台 ................................................................................... 33 3.2.4. 创建 DFOTA 任务.........................................................................................................34 3.2.5. 添加 DFOTA 设备.........................................................................................................35 3.2.6. DFOTA 升级.................................................................................................................36 3.2.7. 查看升级结果 ...............................................................................................................37 3.3. 电信 IoT/AEP 平台受控 DFOTA ..............................................................................................38 3.3.1. AT+QLWFOTAIND 设置 DFOTA 升级模式 ................................................................38 3.3.2. 电信 IoT 平台受控 DFOTA 示例 ...................................................................................39 3.3.3. 电信 AEP 平台受控 DFOTA 示例 .................................................................................40 3.4. 电信 IoT/AEP DFOTA 过程说明及注意事项 ............................................................................42 3.4.1. 过程说明 ......................................................................................................................42 3.4.1.1. 下载阶段........................................................................................................... 42 3.4.1.2. 下载失败错误码介绍......................................................................................... 43 3.4.1.3. 升级阶段........................................................................................................... 43 3.4.1.4. 升级结束阶段及升级错误码 .............................................................................. 43 3.4.2. 注意事项 ......................................................................................................................43 4 错误码 ...............................................................................................................................................44 5 附录 A 参考文档及术语缩写 ..............................................................................................................45 上海移远通信技术股份有限公司 4 / 46 BC25&BC32 系列 DFOTA 应用指导 表格索引 表 1：AT 命令类型................................................................................................................................... 10 表 2：错误码 .............................................................................................................................. 43 表 3：错误码 ......................................................................................................................... 44 表 4：错误码........................................................................................................................ 44 表 5：参考文档........................................................................................................................................ 45 表 6：术语缩写........................................................................................................................................ 45 上海移远通信技术股份有限公司 5 / 46 BC25&BC32 系列 DFOTA 应用指导 图片索引 图 1：通过 HTTP 服务器进行 DFOTA 升级的流程..................................................................................... 8 图 2：工具下载页面................................................................................................................................. 22 图 3：生成公私密钥................................................................................................................................. 22 图 4：公钥上传页面................................................................................................................................. 23 图 5：上传公钥文件................................................................................................................................. 23 图 6：对差分包进行数字签名 .................................................................................................................. 24 图 7：进入添加差分包页面 ...................................................................................................................... 25 图 8：上传已签名差分包至电信 IoT 平台................................................................................................. 26 图 9：新增群组页面................................................................................................................................. 27 图 10：新增群组...................................................................................................................................... 27 图 11：绑定待升级设备 ........................................................................................................................... 28 图 12：创建批量任务页面........................................................................................................................ 28 图 13：创建批量升级任务........................................................................................................................ 29 图 14：选择对应的差分固件升级包 ......................................................................................................... 29 图 15：选择需要升级的设备群组............................................................................................................. 30 图 16：电信 IoT 平台升级成功................................................................................................................. 32 图 17：DFOTA 选择固件管理 .................................................................................................................. 33 图 18：创建固件版本............................................................................................................................... 34 图 19：选择创建任务............................................................................................................................... 34 图 20：创建升级任务............................................................................................................................... 35 图 21：选择升级设备管理........................................................................................................................ 35 图 22：选择升级设备............................................................................................................................... 35 图 23：启动升级...................................................................................................................................... 36 图 24：AEP 平台升级结果....................................................................................................................... 37 上海移远通信技术股份有限公司 6 / 46 BC25&BC32 系列 DFOTA 应用指导 1 引言 移远通信 BC25 系列和 BC32 系列模块均支持 DFOTA（差分固件空中升级）功能，此功能可实现模块 固件包的无线升级或降级。基于 DFOTA，用户通过差分包即可实现固件升级或降级。所述差分包仅包含当 前固件版本和目标固件版本之间的差异，因此大大降低了数据传输量、极大地缩短了传输时间。 本文档主要介绍了如何通过 DFOTA 功能对 BC25 系列和 BC32 系列模块进行的固件升、降级。目前 模块支持通过 HTTP 服务器进行 DFOTA 升级，BC25 模块还支持通过中国电信物联网平台 1) 进行 DFOTA 升级。 备注 1) 本文档中所述中国电信物联网平台，包含'中国电信物联网开放平台-连接管理子系统'（本文简称'电 信 IoT 平台'）和'CTWing 中国电信物联网开放平台'（本文简称'电信 AEP 平台'）。 上海移远通信技术股份有限公司 7 / 46 BC25&BC32 系列 DFOTA 应用指导 2 HTTP 服务器 DFOTA 2.1. 升级流程 下图阐述了差分包储存在 HTTP 服务器时，通过 DFOTA 升级固件的流程。 2. 将差分包放在HTTP 服务器上 HTTP 服务器 1. 获取差分包 NB-IoT (HTTP) 5. 通过NB-IoT网络从HTTP 服务器自动下载差分包 外部 MCU 3. 查询网络状态， 执行AT+QFOTADL命令 4. 执行AT+QFOTADL命令 移远通信 模块 6. 自动升级模块 固件 图 1：通过 HTTP 服务器进行 DFOTA 升级的流程 上海移远通信技术股份有限公司 8 / 46 BC25&BC32 系列 DFOTA 应用指导 如上图所示，通过 DFOTA 升级固件的步骤为： 步骤 1： 从移远通信获取差分包。 步骤 2： 将差分包传至 HTTP 服务器。 步骤 3： 检查网络状态。 步骤 4： 执行 AT+QFOTADL 开始 DFOTA。通过 NB-IoT 或 GSM 网络 1) 从 HTTP 服务器成功下载差 分包后，模块将自动开始固件升级。 备注 1. 1) BC25 系列模块仅支持 NB-loT 网络，故不支持通过 GSM 网络下载固件；BC32 系列模块支持 NB-IoT 和 GSM 网络，支持通过 NB-IoT 或者 GSM 网络下载固件。 2. 当 BC32 系列模块注册到 GSM 网络时，需在检查网络状态后使用 AT+CGDCONT 手动配置 PDP 并 激活 IP。 2.1.1. 获取差分包 升级之前，需先通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和目标 版本信息提交给移远通信或模块供应商以获取相应的差分包。 2.1.2. 存储差分包至 HTTP 服务器 用户需自建 HTTP 服务器以便 DFOTA 功能的使用。完成服务器建立之后，需将差分包存储至服务器 并记录 HTTP 存储路径。 备注 上传差分包至 HTTP 服务器时，请记录差分包在 HTTP 上的路径（URL）。通过 AT+QFOTADL 进行差 分包下载时需要使用该 URL，请参考第 2.2.2 章。 2.1.3. 检查网络状态 模块开机后，开始升级之前，请确认模块已注网。相关的 AT 命令如下： ⚫ AT+CESQ：查询信号质量。 ⚫ AT+COPS?：查询网络类型和注册状态。 ⚫ AT+CGPADDR：查询已经激活的 PDN 分配的 IP 地址。 备注 1. 当 BC32 系列模块注册到 GSM 网络时，需在检查网络状态后使用 AT+CGDCONT 手动配置 PDP 并 上海移远通信技术股份有限公司 9 / 46 激活 IP。 2. 相关的 AT 命令，请参考文档 [1] 或文档 [2]。 BC25&BC32 系列 DFOTA 应用指导 2.1.4. 执行 AT 命令升级固件 确认网络状态后，执行 AT+QFOTADL，随后模块将通过无线网络方式从 HTTP 服务器下载差分包， 并自动升级固件。命令相关的详细信息，请参考第 2.2.2 章。 2.2. DFOTA 相关 AT 命令 2.2.1. AT 命令语句 2.2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 46 BC25&BC32 系列 DFOTA 应用指导 2.2.1.3. AT 命令示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.2.2. AT+QFOTADL 通过 DFOTA 功能升级固件 该命令用于启用 DFOTA 功能，为模块升级固件。执行该命令将差分包从 HTTP 服务器下载到模块， 差分包下载完成后，模块将自动开始固件升级。成功升级固件后，模块将自动重启。若升级出现错误，将 返回错误码并退出 DFOTA。同时，该命令也可以实现本地升级和文件下载功能。 AT+QFOTADL 通过 DFOTA 功能升级固件 测试命令 响应 AT+QFOTADL=? OK 特性说明 / 2.2.2.1. AT+QFOTADL= 通过 HTTP 服务器进行 DFOTA 升级 如果差分包已存储在 HTTP 服务器上，则应执行 AT+QFOTADL=启用 DFOTA 功能。然 后，模块将通过无线网络从 HTTP 服务器下载差分包，并自动升级固件。 AT+QFOTADL= 通过 HTTP 服务器进行 DFOTA 升级 设置命令 响应 AT+QFOTADL= OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... 上海移远通信技术股份有限公司 11 / 46 BC25&BC32 系列 DFOTA 应用指导 特性说明 +QIND: 'FOTA','END', 若出现任何错误： ERROR 或 +CME ERROR: 该命令立即生效。 深休眠唤醒后无效；不保存至 NVRAM。 参数 字符串型。最大长度：511 字节。应该以 'http://' 开头，格式如下： 'http://:/'。 字符串型。HTTP 服务器的 IP 地址或域名。 整型。HTTP 服务器的端口。范围：1~65535；默认值：80。 字符串型。HTTP 服务器中的差分包相对路径。 整型。HTTP 错误码。 0 下载成功 其他值 错误码。更多错误码的含义，请参考第 4 章。 整型。下载或升级进度（百分比）。 整型。DFOTA 错误码。 0 升级成功 其他值 错误码。更多错误码的含义，请参考第 4 章。 备注 若模块处于升级状态时（即正在上报 URC +QIND: 'FOTA','UPDATING',时）断电，则下次 开机时模块将自动进入强制升级模式，并从断电前的升级进度继续升级。模块开机后会自动上报如下 URC： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END',0 上海移远通信技术股份有限公司 12 / 46 BC25&BC32 系列 DFOTA 应用指导 2.2.2.2. AT+QFOTADL= 通过本地进行 DFOTA 升级 该命令用于通过本地进行 DFOTA 升级。如果差分包已经存入到模块的 UFS 中，且差分包名称为 fota.pack，那么可执行该命令进行本地固件升级；如果差分包名称不是 fota.pack，需使用文件系统中相关 的 AT 命令将差分包重命名为 fota.pack 后，执行 AT+QFOTADL=，模块将自动完成版本的升级过 程。 AT+QFOTADL= 通过本地进行 DFOTA 升级 设置命令 响应 AT+QFOTADL= OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 该命令立即生效。 深休眠唤醒后无效；不保存至 NVRAM。 参数 整型。命令操作。 1 本地升级 整型。升级进度（百分比）。 整型。HTTP 错误码。 0 下载成功 其他值 错误码。更多错误码的含义，请参考第 4 章。 整型。DFOTA 错误码。 0 升级成功 其他值 错误码。更多错误码的含义，请参考第 4 章。 备注 1. 可通过文件系统相关的 AT 命令传输差分包到模块 UFS 中，差分包的文件名必须是 fota.pack，否则 无法启动本地升级功能。 上海移远通信技术股份有限公司 13 / 46 BC25&BC32 系列 DFOTA 应用指导 2. 若模块处于升级状态时（即正在上报 URC +QIND: 'FOTA','UPDATING',时）断电，则 下次开机时模块将自动进入强制升级模式，并从断电前的升级进度继续升级。模块开机后会自动上报 如下 URC： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END',0 3. 文件系统相关的 AT 命令，请参考文档 [3]。 2.2.2.3. AT+QFOTADL=, 通过 HTTP 服务器下载 MCU 升级文件 该命令用于从 HTTP 服务器下载 MCU 升级文件。如果外部 MCU 的升级文件已经放到 HTTP 服务器上， 执行该命令下载 MCU 升级文件，下载完成后存储至模块的文件系统中。存入文件系统的文件名默认为 中的文件名，或通过指定来指定其他文件名。 文件系统中的文件可以使用文件系统相关的 AT 命令进行操作。 AT+QFOTADL=, 通过 HTTP 服务器下载 MCU 升级文件 设置命令 响应 AT+QFOTADL=,[, OK ] +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','HTTPEND', 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 该命令立即生效。 深休眠唤醒后无效；不保存至 NVRAM。 上海移远通信技术股份有限公司 14 / 46 BC25&BC32 系列 DFOTA 应用指导 参数 整型。升级模式。 2 从 HTTP 服务器下载文件并存储到模块中。 字符串型。文件名，用于指定下载文件的文件名。 若省略，模块优先从 HTTP URL 中获取文件名； 若文件名包含非法字符，则默认使用 mcu_update.bin 为文件的存储名。 字符串型。最大长度：511 字节。应该以 'http://' 开头，格式如下： 'http://:/'。 字符串型。HTTP 服务器的 IP 地址或域名。 整型。HTTP 服务器的端口。范围：1~65535；默认值：80。 字符串型。HTTP 服务器中的差分包路径。 整型。下载进度（百分比）。 整型。HTTP 错误码。 0 下载成功 其他值 错误码。更多错误码的含义，请参考第 4 章。 备注 1. 使用此命令从 HTTP 服务器下载文件时，文件名长度不能超过 63 个字节，否则会无法执行并报错。 下载完成后，可通过文件系统相关的 AT 命令进行操作。 2. 文件系统相关的 AT 命令，请参考文档 [3]。 2.3. 举例 2.3.1. NB-IoT 网络下通过 HTTP 服务器进行 DFOTA //差分包已存储在 HTTP 服务器中，地址为 http://224.168.203.812:3029/update.pack。 AT+COPS? //查询网络状态。 +COPS: 0,2,'46011',9 //第 4 个参数 9 表示 NB-IoT 网络。 OK //在 NB-IoT 网络下，模块将使用通过 AT+QCGDEFCONT 配置的参数，并自动激活 IP。 AT+CGPADDR? +CGPADDR: 1, '100.68.194.234','' OK //执行 AT+QFOTADL 命令以启用 DFOTA 进行固件升级，模块将开始下载差分包并自动升级固件。 AT+QFOTADL='http://224.168.203.812:3029/update.pack' 上海移远通信技术股份有限公司 15 / 46 BC25&BC32 系列 DFOTA 应用指导 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING',1% +QIND: 'FOTA','DOWNLOADING',3% ... +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',3% ... +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 //开始从 HTTP 服务器下载差分包 //已成功从 HTTP 服务器下载差分包 //开始升级固件 //固件已成功升级。 2.3.2. GSM 网络下通过 HTTP 服务器进行 DFOTA（仅 BC32） //差分包已存储在 HTTP 服务器中，地址为 http://224.168.203.812:3029/update.pack。 AT+COPS? //查询网络状态 +COPS: 0,2,'46011',0 //第 4 个参数 0 表示 GSM 网络 OK //当 BC32 处于 GSM 网络时，需要在下载之前手动配置 PDP 并激活 IP。 AT+CGDCONT=1,'IP' //设置 PDP 类型为 IP OK AT+CGACT=1,1 //激活此 PDP OK AT+CGPADDR? +CGPADDR: 1,'100.68.194.234' OK //执行 AT+QFOTADL 命令以启用 DFOTA 进行固件升级，然后模块将开始下载差分包并自动升级固件。 AT+QFOTADL= 'http://224.168.203.812:3029/update.pack' 上海移远通信技术股份有限公司 16 / 46 BC25&BC32 系列 DFOTA 应用指导 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING',1% +QIND: 'FOTA','DOWNLOADING',3% ... +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',3% ... +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 //开始从 HTTP 服务器下载差分包 //已成功从 HTTP 服务器下载差分包。 //开始升级固件 //固件已升级成功。 备注 该 GSM 网络下的示例仅适用 BC32 系列模块。 2.3.3. 进行本地固件升级 //执行 AT+QFOTADL=1 使用 DFOTA 功能进行本地固件升级，首先要确保模块 UFS 中存在正确的差分固 件包 fota.pack，否则无法进行本地升级。 AT+QFLST //查询文件系统中是否存在差分包。 +QFLST: 'fota.pack',20135 //查询到 20135 字节大小的 fota.pack 固件包 OK AT+QFOTADL=1 OK //触发模块进行本地升级。 +QIND: 'FOTA','START' //开始升级固件 上海移远通信技术股份有限公司 17 / 46 +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',3% ... +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 BC25&BC32 系列 DFOTA 应用指导 //固件已升级成功。 2.3.4. NB-IoT 网络下从 HTTP 服务器下载 MCU 升级文件并存储至模块 AT+COPS? +COPS: 0,2,'46011',9 //查询网络状态。 //第 4 个参数 9 表示 NB-IoT 网络。 OK //在 NB-IoT 网络下，模块将使用通过 AT+QCGDEFCONT 配置的参数，并自动激活 IP。 AT+CGPADDR? +CGPADDR: 1,'100.68.194.234','' OK //执行 AT+QFOTADL=2, 命令从 HTTP 服务器上下载 MCU 升级文件存储到模块中，下载完 成后可以使用相应的文件系统 AT 命令进行操作。 //MCU 升级文件在 HTTP 服务器上的存储地址：http://224.168.203.812:3029/test.bin。 AT+QFOTADL=2,'http://224.168.203.812:3029/test.bin' //触发模块从 HTTP 服务器下载文件 OK +QIND: 'FOTA','HTTPSTART' //开始从 HTTP 服务器下载文件 +QIND: 'FOTA','DOWNLOADING',1% +QIND: 'FOTA','DOWNLOADING',3% ... +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 AT+ QFLST +QFLST: 'test.bin',93368 //已成功从 HTTP 服务器下载文件。 //查询文件系统的文件列表。 //查询到已下载 93368 字节的文件 test.bin。 OK 上海移远通信技术股份有限公司 18 / 46 BC25&BC32 系列 DFOTA 应用指导 2.3.5. GSM 网络下从 HTTP 服务器下载 MCU 升级文件并存储至模块（仅 BC32） AT+COPS? +COPS: 0,2,'46011',0 //查询网络状态。 //第四个参数 0 表示 GSM 网络。 OK //当 BC32 处于 GSM 网络时，需要在下载之前手动配置 PDP 并激活 IP。 AT+CGDCONT=1,'IP' //设置 PDP 类型为 IP OK AT+CGACT=1,1 //激活此 PDP OK AT+CGPADDR? +CGPADDR: 1,'100.68.194.234' OK //执行 AT+QFOTADL=2, 命令从 HTTP 服务器上下载指定的文件存储到模块中,下载完成后 可以使用相应的文件系统 AT 命令进行操作 //MCU 升级文件在 HTTP 服务器上的存储地址： http://224.168.203.812:3029/test.bin。 AT+QFOTADL=2,'http://224.168.203.812:3029/test.bin' OK +QIND: 'FOTA','HTTPSTART' //开始从 HTTP 服务器下载文件。 +QIND: 'FOTA','DOWNLOADING',1% +QIND: 'FOTA','DOWNLOADING',3% ... +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 //已成功从 HTTP 服务器下载文件。 AT+ QFLST +QFLST: 'test.bin',93368 //查询文件系统的文件列表。 OK 备注 该 GSM 网络下的示例仅适用 BC32 系列模块。 上海移远通信技术股份有限公司 19 / 46 BC25&BC32 系列 DFOTA 应用指导 3 中国电信物联网平台 DFOTA 3.1. 电信 IoT 平台 DFOTA 本章节介绍 BC25 系列模块如何在电信 IoT 平台进行 DFOTA 升级。 备注 本文档提及的电信 IoT 平台与华为 OceanConnect IoT 平台兼容。使用时需注意平台的版本是否相同。 有关中国电信 IoT 平台的详细信息，请访问官方地址：https://develop.ct10649.com:8093。 3.1.1. 升级流程 通过电信 IoT 平台进行 DFOTA 升级，主要包含以下步骤： 步骤 1： 确保设备在电信 IoT 平台上已成功注册，且能正常收发数据（第 3.1.2 章）。 步骤 2： 创建和导入设备。导入设备的 Profile 必须包含 omCapabilities 能力（第 3.1.3 章）。 步骤 3： 生成公私密钥文件，并上传公钥文件至平台（第 3.1.4 章）。 步骤 4： 从移远通信获取差分包，并使用私钥文件进行签名（第 3.1.5 章）。 步骤 5： 上传差分包至电信 IoT 平台（第 3.1.6 章）。 步骤 6： 在电信 IoT 平台创建升级任务并完成升级（第 3.1.7 章）。 3.1.2. 平台注册 在进行 DFOTA 升级之前，需确保设备在电信 IoT 平台上已成功注册，且能正常收发数据。 3.1.3. 创建应用 参考电信 IoT 平台官方文档完成应用的创建。创建应用时，导入设备的 Profile 必须包含 omCapabilities 能力（若未包含，请在 Profile 中添加如下 Profile 模板中的红色字体部分），否则在平台上将无法上传对应 设备的差分包，平台也无法对该设备创建固件升级任务。具体 Profile 开发指导请联系中国电信物联网平台 获取。 上海移远通信技术股份有限公司 20 / 46 BC25&BC32 系列 DFOTA 应用指导 以下是支持升级的一个 Profile 模板，供参考： { 'devices': [ { 'manufacturerId': 'quectel', 'manufacturerName': 'quectel', 'model': 'NBIoTDevice', 'protocolType': 'CoAP', 'deviceType': 'WaterMeter', 'omCapability':{ 'upgradeCapability' : { 'supportUpgrade':false }, 'fwUpgradeCapability' : { 'supportUpgrade':true, 'upgradeProtocolType':'LWM2M', 'downloadProtocolType':'CoAP' } }, 'serviceTypeCapabilities': [ { 'serviceId': 'Brightness', 'serviceType': 'Brightness', 'option': 'Master' }, { 'serviceId': 'WaterData', 'serviceType': 'WaterData', 'option': 'Optional' } ] } ] } 上海移远通信技术股份有限公司 21 / 46 BC25&BC32 系列 DFOTA 应用指导 3.1.4. 生成及上传公私密钥 步骤 1： 登陆电信 IoT 平台，进入'系统管理'→'工具'→'离线签名工具'页面，然后点击下载 离线签名工具 signtool.zip。如下图所示。 图 2：工具下载页面 步骤 2： 运行 signtool.exe 打开工具，选择'签名算法'为'RSA2048+SHA256'，输入'加密口令'， 例如 Quectel123（由电信 IoT 平台分配）；点击'生成公私密钥'，将生成一对公私密钥文 件 private.pem 和 public.pem。如下图所示。 图 3：生成公私密钥 上海移远通信技术股份有限公司 22 / 46 BC25&BC32 系列 DFOTA 应用指导 步骤 3： 进入'设备管理'→'软件库'→'公钥管理'→'上传'页面，上传公钥文件 public.pem 到电信 IoT 平台，'厂商名称'须与应用 Profile 里的厂商名称对应，如下所示。 图 4：公钥上传页面 图 5：上传公钥文件 上海移远通信技术股份有限公司 23 / 46 BC25&BC32 系列 DFOTA 应用指导 3.1.5. 差分包获取及签名 3.1.5.1. 获取差分包 通过 ATI 获取当前固件版本，同时需明确目标固件版本，之后将当前版本和目标版本信息提交给移远 通信或模块供应商以获取相应的差分包。 3.1.5.2. 对差分包进行签名 步骤 1： 运行 signtool.exe，在'签名算法'中选择私钥对应的'RSA2048+SHA256'签名算法。 步骤 2： 在'私钥文件'中导入 private.pem 私钥文件并输入之前设置的密码，例如 Quectel123。 步骤 3： 在'需要数字签名的软件包'处导入差分包，须注意差分包的文件是 bin 格式，（例如 BC25R01A03_TO_BC25R01A04.bin），但对差分包进行数字签名的文件格式需要是 zip 压 缩 文 件 ， 所 以 需 要 将 差 分 包 的 bin 文 件 压 缩 成 zip 格 式 的 压 缩 文 件 （ 例 如 BC25R01A03_TO_BC25R01A04.zip）。 步骤 4： 点击'进行数字签名'，弹出签名成功后，在差分包同级目录下会生成文件名包含 signed 备 注的已签名差分包（例如 BC25R01A03_TO_BC25R01A04_signed.zip）。 整体流程如下图所示： 图 6：对差分包进行数字签名 上海移远通信技术股份有限公司 24 / 46 BC25&BC32 系列 DFOTA 应用指导 备注 上 传 至 平 台 的 已 签 名 差 分 包 为 zip 格 式 ， 因 此 生 成 的 zip 格 式 的 已 签 名 差 分 包 （ 例 如 BC25R01A03_TO_BC25R01A04._signed.zip）不用做解压处理，可直接上传。 3.1.6. 上传差分包 步骤 1： 登陆电信 IoT 平台，进入'设备管理'→'软件库'→'固件包管理'→'添加固件包'页 面。 图 7：进入添加差分包页面 上海移远通信技术股份有限公司 25 / 46 BC25&BC32 系列 DFOTA 应用指导 步骤 2： 上 传 已 签 名 的 差 分 包 并 完 成 其 他 必 填 信 息 ， 如 下 图 所 示 。 例 如 ' 版 本 ' 填 写 为 ' BC25PAR01A04',' 设 备 类 型 ' 填 写 为 ' WaterMeter ' ' , 厂 商 名 称 ' 填 写 为 'quectel','型号'填写为'NBIoTDevice'，'协议'填写为'CoAP'。最后点击'保 存'按钮。 图 8：上传已签名差分包至电信 IoT 平台 备注 设备类型、厂商名称、型号、协议必须与应用的 Profile 严格一致，否则上传差分包和 DFOTA 升级任务将 失败。 上海移远通信技术股份有限公司 26 / 46 BC25&BC32 系列 DFOTA 应用指导 3.1.7. DFOTA 升级 3.1.7.1. 创建升级任务 步骤 1： 在'设备管理'→'群组'→'新建群组'中新增群组。完成必填字段后点击'确认'完成 添加，例如下图，新建的'群组名称'为'DFOTA'。 图 9：新增群组页面 图 10：新增群组 上海移远通信技术股份有限公司 27 / 46 BC25&BC32 系列 DFOTA 应用指导 步骤 2： 点击新建的群组名，例如'DFOTA'，在'设备管理'→'群组'→'群组管理 > DFOTA' 进入页面，再在'设备'页面中勾选对应设备后，点击'绑定设备'，将需要升级的设备绑 定到新增的群组。如下图所示。 图 11：绑定待升级设备 步骤 3： 在'设备管理'→'批量任务'→'批量软固件升级'→'固件升级'→'创建'弹出页面 中创建批量升级任务，如图所示。（下图中'任务名称'、'重试策略'和'重试次数'是 默认的参数设置，可根据需求自定义） 图 12：创建批量任务页面 上海移远通信技术股份有限公司 28 / 46 BC25&BC32 系列 DFOTA 应用指导 图 13：创建批量升级任务 步骤 4： 选择对应的差分固件升级包，完成平台升级任务的创建。如下图所示。 图 14：选择对应的差分固件升级包 上海移远通信技术股份有限公司 29 / 46 步骤 5： 选择需要升级的设备群组。如下图所示。 BC25&BC32 系列 DFOTA 应用指导 图 15：选择需要升级的设备群组 3.1.7.2. 设备升级 步骤 1： 升级任务创建成功之后，终端设备发送上行数据包，即可触发平台的 DFOTA 升级，升级过程 包括下载差分固件升级包和更新固件。 +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 1,'10.180.145.117','' //禁止深休眠 //查询本地 IP OK AT+NCDPOPEN='180.101.147.115',5683 OK //发送注册请求 +QLWEVTIND: 0 +QLWEVTIND: 3 AT+NMGS=5,00454c4c4f OK //注册成功 //订阅 object19/0/0 成功 //向平台发送数据触发升级任务 上海移远通信技术股份有限公司 30 / 46 +QLWEVTIND: 8 +QIND: 'FOTA','DOWNLOAD START' +QIND: 'FOTA','DOWNLOADING',512 … +QIND: 'FOTA','DOWNLOAD',0 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',2% … +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 1,'10.180.145.117','' OK AT+NCDPOPEN='180.101.147.115',5683 OK +QLWEVTIND: 0 +QLWEVTIND: 3 +QLWEVTIND: 9 BC25&BC32 系列 DFOTA 应用指导 //平台下发 observe /5/0/3 请求订阅升级状态 //终端设备开始下载差分包 //终端设备已下载 512 字节的差分包 //终端设备下载差分包过程中 //差分包下载完成且差分包校验成功 //终端设备开始本地升级 //终端设备本地升级过程中 //终端设备本地升级过程中 //终端设备本地升级完成，等待重启 //再次执行注册流程 //禁止深休眠 //查询本地 IP //发送注册请求 //注册成功 //订阅 object19/0/0 成功 //平台下发取消 observe /5/0/3 订阅 上海移远通信技术股份有限公司 31 / 46 BC25&BC32 系列 DFOTA 应用指导 步骤 2： 模块固件升级完成，平台显示升级成功。如下图所示。 图 16：电信 IoT 平台升级成功 3.2. 电信 AEP 平台 DFOTA 本章主要描述如何通过电信 AEP 平台的 DFOTA 功能对移远通信 BC25 模块进行升级。 备注 有关中国电信 AEP 平台的详细信息，请访问官方地址：https://www.ctwing.cn/。 3.2.1. 升级流程 通过电信 AEP 平台进行 DFOTA 升级，主要包含以下步骤： 步骤 1： 确保设备在电信 AEP 平台上已成功注册，且能正常收发数据（第 3.2.2 章）。 步骤 2： 获取和上传差分包到 AEP 平台（第 3.2.3 章）。 步骤 3： 创建 DFOTA 任务（第 3.2.4 章）。 步骤 4： 添加 DFOTA 设备（第 3.2.5 章）。 步骤 5： 升级设备（第 3.2.6 章）。 步骤 6： 查看升级结果（第 3.2.7 章）。 3.2.2. 平台注册 在进行 DFOTA 升级之前，需确保设备在电信 AEP 平台上已成功注册，且能正常收发数据。 上海移远通信技术股份有限公司 32 / 46 BC25&BC32 系列 DFOTA 应用指导 3.2.3. 差分包获取及上传 3.2.3.1. 获取差分包 通过 ATI 获取当前固件版本，同时需明确目标固件版本，之后将当前版本和目标版本信息提交给移远 通信或模块供应商以获取相应的差分包。 3.2.3.2. 上传差分包至 AEP 平台 上传差分包到 AEP 平台前，需先从供应商处获取差分固件升级包，然后登录 AEP 平台控制台，点击 '远程升级管理'，选择'FOTA 升级'→'固件管理'→'创建固件版本'，将固件信息上传至云端。 例如，上传差分包 BC25PAR01A05_UPGTOBC25PAR01A06_UPG.pack 如下图所示（此处'.pack'格式 和'.bin'格式相同，可以直接将后缀改为'.bin'）。 图 17：DFOTA 选择固件管理 上海移远通信技术股份有限公司 33 / 46 BC25&BC32 系列 DFOTA 应用指导 图 18：创建固件版本 3.2.4. 创建 DFOTA 任务 登录 AEP 平台控制台，选择'远程升级管理'→'创建任务'，即可创建升级任务。 图 19：选择创建任务 上海移远通信技术股份有限公司 34 / 46 BC25&BC32 系列 DFOTA 应用指导 图 20：创建升级任务 3.2.5. 添加 DFOTA 设备 选择'远程升级管理'，选中创建的任务名称（下图中任务名称为 test），点击任务设备管理图标，选 择需要升级的设备，点击'加入升级'，如下图所示。 图 21：选择升级设备管理 上海移远通信技术股份有限公司 图 22：选择升级设备 35 / 46 BC25&BC32 系列 DFOTA 应用指导 3.2.6. DFOTA 升级 选择'远程升级管理'后，点击下图标记为 1 的图标（启动升级图标），然后选择'立即启动'，如 下图所示。 图 23：启动升级 设置平台升级任务后，设备注册到平台，收到平台下发的 observe 请求后，随即开始升级。如果设备 在设置平台升级任务前已注册到平台，在上行一次数据后，随即开始升级。示例如下： +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 1,'10.180.145.117','' //禁止深休眠 //查询本地 IP OK AT+NCFG=0,86400 OK AT+NCDPOPEN='221.229.214.202',5683 OK //配置 lifetime //发送注册请求 +QLWEVTIND: 0 //注册成功 +QLWEVTIND: 3 //订阅 object19/0/0 成功 +QLWEVTIND: 8 //平台下发 observe /5/0/3 请求订阅升级状态 +QIND: 'FOTA','DOWNLOAD START' //终端设备开始下载固件升级包 +QIND: 'FOTA','DOWNLOADING',512 //终端设备已下载 512 字节差分包 ... //终端设备下载固件过程中 +QIND: 'FOTA','DOWNLOAD',0 //差分包下载完成且差分包校验成功 +QIND: 'FOTA','START' //终端设备开始本地升级 上海移远通信技术股份有限公司 36 / 46 +QIND: 'FOTA','UPDATING',2% ... +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 1,'10.180.145.117','' OK AT+NCFG=0,86400 OK AT+NCDPOPEN='221.229.214.202',5683 OK +QLWEVTIND: 0 +QLWEVTIND: 3 +QLWEVTIND: 9 BC25&BC32 系列 DFOTA 应用指导 //终端设备本地升级过程中 //终端设备本地升级过程中 //终端设备本地升级完成 //终端设备本地升级完成，等待重启 //再次执行注册流程 //禁止深休眠 //查询本地 IP //配置 lifetime //发送注册请求 //注册成功 //订阅 object19/0/0 成功 //平台下发取消 observe /5/0/3 订阅 3.2.7. 查看升级结果 模块升级后，可以在 AEP 平台上查看升级结果。成功升级后平台显示如下： 图 24：AEP 平台升级结果 上海移远通信技术股份有限公司 37 / 46 BC25&BC32 系列 DFOTA 应用指导 3.3. 电信 IoT/AEP 平台受控 DFOTA 3.3.1. AT+QLWFOTAIND 设置 DFOTA 升级模式 该命令用于设置 DFOTA 升级模式，可以设置为下面任意一种模式： ⚫ 自动模式：MCU 无需执行命令，可自动完成基于 DFOTA 的下载和升级。 ⚫ 受控模式：MCU 执行该命令去控制是否下载或升级固件。 受控模式下，收到 URC +QLWEVTIND: 13（即收到了'put package URI'消息）或者 URC +QLWEVTIND: 14（即收到了'update'消息）后，MCU 使用该命令控制是否下载或者升级固件。 AT+QLWFOTAIND 查询命令 AT+QLWFOTAIND? 设置 DFOTA 升级模式 响应 +QLWFOTAIND: OK 设置命令 AT+QLWFOTAIND= 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 为 0 或 1 时，配置重启后生效，自动保存至 NVRAM； 为 2、3、4 或 5 时，配置立即生效，不保存至 NVRAM。 参数 整型。表示 DFOTA 升级模式。 0 使用自动 DFOTA 升级模式 1 使用受控 DFOTA 升级模式 2 终端设备通知模块开始下载版本文件 3 终端设备通知模块取消下载版本文件 4 终端设备通知模块开始升级 5 终端设备通知模块取消升级 上海移远通信技术股份有限公司 38 / 46 整型。错误码。详情参见第 4 章。 举例 AT+QLWFOTAIND=1 OK BC25&BC32 系列 DFOTA 应用指导 3.3.2. 电信 IoT 平台受控 DFOTA 示例 电信 IoT 平台上创建 DFOTA 任务，请参考第 3 章。 AT+QSCLK=0 OK AT+QLWFOTAIND? +QLWFOTAIND: 1 //禁止深休眠 //查询固件的升级模式 //受控模式 OK AT+CGPADDR? +CGPADDR: 1,'10.180.145.117','' //查询本地 IP OK AT+NCDPOPEN='180.101.147.115',5683 OK //发送注册请求 +QLWEVTIND: 0 //注册成功 +QLWEVTIND: 3 AT+NMGS=5,00454c4c4f OK //订阅 object19/0/0 成功 //向平台发送数据触发升级任务 +QLWEVTIND: 8 //平台下发 observe /5/0/3 请求订阅升级状态 +QLWEVTIND: 13 AT+QLWFOTAIND=2 OK //接收到更新包 URL //终端设备通知模块开始下载 +QIND: 'FOTA','DOWNLOAD START' //开始下载差分包 +QIND: 'FOTA','DOWNLOADING',512 //已下载 512 字节的差分包 … +QIND: 'FOTA','DOWNLOAD',0 //差分包下载完成且差分包校验成功 上海移远通信技术股份有限公司 39 / 46 +QLWEVTIND: 14 AT+QLWFOTAIND=4 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',2% … +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 1,'10.180.145.117','' OK AT+NCDPOPEN='180.101.147.115',5683 OK +QLWEVTIND: 0 +QLWEVTIND: 3 +QLWEVTIND: 9 BC25&BC32 系列 DFOTA 应用指导 //收到平台 update 消息 //终端设备通知模块开始升级 //开始升级 //本地升级过程中 //升级完成，等待重启 //再次执行注册流程 //禁止深休眠 //查询本地 IP //发送注册请求 //注册成功 //订阅 object19/0/0 成功 //平台下发取消 observe /5/0/3 订阅 3.3.3. 电信 AEP 平台受控 DFOTA 示例 电信 AEP 平台上创建 DFOTA 任务，请参考第 3.2 章。 AT+QSCLK=0 OK AT+QLWFOTAIND? +QLWFOTAIND: 1 //禁止深休眠 //查询固件的升级模式 //受控模式 上海移远通信技术股份有限公司 40 / 46 OK AT+CGPADDR? +CGPADDR: 1,'10.180.145.117','' OK AT+NCFG=0,86400 OK AT+NCDPOPEN='221.229.214.202',5683 OK +QLWEVTIND: 0 +QLWEVTIND: 3 +QLWEVTIND: 8 +QLWEVTIND: 13 AT+QLWFOTAIND=2 OK +QIND: 'FOTA','DOWNLOAD START' +QIND: 'FOTA','DOWNLOADING',512 … +QIND: 'FOTA','DOWNLOAD',0 +QLWEVTIND: 14 AT+QLWFOTAIND=4 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',2% … +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 RDY BC25&BC32 系列 DFOTA 应用指导 //查询本地 IP //配置 lifetime //发送注册请求 //注册成功 //订阅 object19/0/0 成功 //平台下发 observe /5/0/3 请求订阅升级状态 //接收到更新包 URL //终端设备通知模块开始下载 //开始下载差分包 //已下载 512 字节的差分包 //差分包下载完成且差分包校验成功 //收到平台 update 消息 //终端设备通知模块开始升级 //开始升级 //升级过程中 //升级完成，等待重启 上海移远通信技术股份有限公司 41 / 46 +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+CGPADDR? +CGPADDR: 1,'10.180.145.117','' OK AT+NCFG=0,86400 OK AT+NCDPOPEN='221.229.214.202',5683 OK +QLWEVTIND: 0 +QLWEVTIND: 3 +QLWEVTIND: 9 BC25&BC32 系列 DFOTA 应用指导 //再次执行注册流程 //禁止深休眠 //查询本地 IP //配置 lifetime //发送注册请求 //注册成功 //订阅 object19/0/0 成功 //平台下发取消 observe /5/0/3 订阅 3.4. 电信 IoT/AEP DFOTA 过程说明及注意事项 3.4.1. 过程说明 3.4.1.1. 下载阶段 1. 当终端发起注册或者上报数据到平台，平台感知终端在线，如果平台有升级任务，则会下发请求查 询版本号、小区 ID、信号强度以及升级状态等。 2. 如果平台判断可以发起升级，则会下发 observe /5/0/3 请求订阅升级状态，订阅成功之后平台下发 升级包 URI 给终端。模块获取平台下发的 URI 之后，升级状态从 IDLE 转换成 DOWNLOADING， 模块通知终端 MCU 开始从平台下载升级包数据，模块会发送 +QIND: 'FOTA','DOWNLOAD START' 给终端 MCU，此时终端 MCU 不可给模块断电，也不可发送数据传输相关的 AT 命令。 如果下载过程中发生异常导致下载失败，升级状态将从 DOWNLOADING 转换到 IDLE，模块同时 向终端 MCU 发送 +QIND: 'FOTA','DOWNLOAD',，此时若设备已正常联网注册，则终 端 MCU 可以正常处理业务。之后平台的服务器下发 read /5/0/5 请求查询失败原因。 3. 若升级包下载完成并校验成功，升级状态由 DOWNLOADING 转换到 DOWNLOADED，模块向终 端 MCU 发送 +QIND: 'FOTA','DOWNLOAD',0。若升级包下载完成但校验失败，模块向终端 MCU 发送 +QIND: 'FOTA','DOWNLOAD',5，升级状态转换到 IDLE，平台的服务器将查询失败 原因。 上海移远通信技术股份有限公司 42 / 46 BC25&BC32 系列 DFOTA 应用指导 3.4.1.2. 下载失败错误码介绍 下载失败，模块向终端 MCU 发送 +QIND: 'FOTA','DOWNLOAD',。 表 2：错误码 0 2 4 5 7 描述 固件包下载成功，固件包完整性检查通过，可以发起升级动作 内存不足，下载失败 连接断开，下载失败 固件包下载成功，但固件包完整性检查未通过 平台下发了无效的 URL，下载失败 3.4.1.3. 升级阶段 当校验完成，平台下发 execute /5/0/2 请求模块升级，升级状态由 DOWNLOADED 转换到 UPDATING， 模块向终端 MCU 发送+QIND: 'FOTA','START'。在此状态下，终端 MCU 不可将模块断电，不可发送数 据传输相关 AT 命令。 3.4.1.4. 升级结束阶段及升级错误码 ⚫ 若升级成功，模块向终端 MCU 发送 +QIND: 'FOTA','END',0，模块会自动重启，需要终端 MCU 再次执行注册平台流程，以便模块向平台上报升级结果。 ⚫ 若升级失败，模块向终端 MCU 发送 +QIND: 'FOTA','END',，有关错误码信息请参 考第 4 章。 3.4.2. 注意事项 ⚫ DFOTA 过程中若终端 MCU 对模块进行断电、重启等操作，可能会造成模块 DFOTA 升级失败。因 此，在此期间，终端 MCU 需终止业务，禁止向模块发送 AT 命令，禁止断电、重启模块等操作。 ⚫ 如果需要发起 DFOTA 业务，建议执行 AT+QSCLK=0、AT+CPSMS=0、AT+CEDRXS=0 关闭深 睡眠、PSM 和 eDRX，以避免网络状况不佳时，模块进入 PSM 模式影响 DFOTA 升级。 ⚫ 若平台任务创建成功，模块发送一包数据未触发升级，可尝试多发几包数据，此为正常现象。 上海移远通信技术股份有限公司 43 / 46 BC25&BC32 系列 DFOTA 应用指导 4 错误码 错误码表示与移动设备或网络有关的错误。有关和的详细信息，请参考下表。 表 3：错误码 0 6500 6501 6502 6503 6504 6505 6506 6507 6509 含义 下载成功 未知错误 非法参数 差分包超过文件系统的剩余空间 差分包下载失败 未找到指定的差分包 差分包写入文件系统失败 文件系统中没有差分包 差分包校验失败 分配动态 RAM 空间失败 表 4：错误码 0 6508 含义 升级成功 升级失败 上海移远通信技术股份有限公司 44 / 46 BC25&BC32 系列 DFOTA 应用指导 5 附录 A 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_BC25_AT 命令手册 [2] Quectel_BC32_AT 命令手册 [3] Quectel_BC25&BC32 系列_FILE_应用指导 表 6：术语缩写 缩写 AEP DFOTA eDRX GSM HTTP IP LPWA MCU NB-IoT OC PDP PSM 描述 Application Enable Platform Delta Firmware Upgrade Over-The-Air Extended Discontinuous Reception Global System for Mobile Communication Hyper Text Transport Protocol Internet Protocol Low Power Wide Area Microcontroller Unit Narrowband Internet of Things OceanConnect Packet Data Protocol Power Saving Mode 中文释义 中国电信物联网开放平台 差分包空中升级 扩展不连续接收模式 全球移动通信系统 超文本传输协议 网际互连协议 低功率广域网络 微控制单元 窄带物联网 中国电信 IOT 平台 分组数据协议 省电模式 上海移远通信技术股份有限公司 45 / 46 RAM URI URL UFS URC Random Access Memory Uniform Resource Identifier Uniform Resource Locator User File System Uniform Resource Citation BC25&BC32 系列 DFOTA 应用指导 随机存取存储器 统一资源标识符 统一资源定位符 用户文件系统 统一资源引用 上海移远通信技术股份有限公司 46 / 46

BC26&BC20 运营商自注册使用说明 NB-IoT 模块系列 版本：BC26&BC20_运营商自注册使用说明_V1.0 日期：2020-05-13 状态：受控文件 www.quectel.com BC26&BC20 运营商自注册使用说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 20 BC26&BC20 运营商自注册使用说明 文档历史 修订记录 版本 日期 作者 1.0 2020-05-13 李婷婷 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 20 BC26&BC20 运营商自注册使用说明 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 图片索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 1.1. 模块版本配置.............................................................................................................................. 5 2 运营商自注册机制 ................................................................................................................................. 6 2.1. 电信自注册 ................................................................................................................................. 6 2.1.1. 自注册启动 ...................................................................................................................... 6 2.1.2. 自注册成功 ...................................................................................................................... 6 2.1.3. 自注册失败 ...................................................................................................................... 7 2.1.4. 自注册影响 ...................................................................................................................... 7 2.2. 联通自注册 ................................................................................................................................. 7 2.2.1. 自注册启动 ...................................................................................................................... 7 2.2.2. 自注册成功 ...................................................................................................................... 8 2.2.3. 自注册失败 ...................................................................................................................... 8 2.2.4. 自注册影响 ...................................................................................................................... 8 2.3. 移动 CMDMP 自注册.................................................................................................................. 8 2.3.1. 自注册启动 ...................................................................................................................... 9 2.3.2. 自注册成功 ...................................................................................................................... 9 2.3.3. 自注册失败 ...................................................................................................................... 9 2.3.4. 自注册影响 ...................................................................................................................... 9 3 运营商自注册相关 AT 命令 ................................................................................................................. 10 3.1. AT 命令语句.............................................................................................................................. 10 3.1.1. 定义 ............................................................................................................................... 10 3.1.2. AT 命令语句 .................................................................................................................. 10 3.2. AT 命令描述...............................................................................................................................11 3.2.1. AT+QSREGENABLE 启用/禁用中国电信、中国联通自注册.......................................11 3.2.2. AT+QDMPCFG CMDMP 接入配置..............................................................................11 3.2.3. AT+QDMPCFGEX CMDMP 接入扩展配置 ................................................................ 15 4 附录 A 术语缩写 ................................................................................................................................. 20 上海移远通信技术股份有限公司 3 / 20 BC26&BC20 运营商自注册使用说明 图片索引 图 1：中国电信自注册流程 .................................................................................................................................. 6 图 2：中国联通自注册流程 .................................................................................................................................. 7 图 3：中国移动 CMDMP 自注册流程................................................................................................................... 8 上海移远通信技术股份有限公司 4 / 20 BC26&BC20 运营商自注册使用说明 1 引言 遵照运营商入库测试需求，移远通信 BC26 和 BC20 模块集成了国内三大运营商（中国电信、中国联 通和中国移动）的自注册功能，从而实现了对终端设备更方便、更有效的管理。本文档主要介绍 BC26 和 BC20 模块的三大运营商自注册机制以及与自注册相关的 AT 命令。 1.1. 模块版本配置 表 1：模块版本配置情况 型号 软件版本 支持的运营商自注册 BC26 BC20 BC26NCR01A07 及之前的软件版本   BC26NCR01A08 及之后的软件版本   BC20NAR01A09 及之前的软件版本   BC20NAR01A10 及之后的软件版本   支持中国电信及中国移动 CMDMP 自注册 默认打开 支持中国电信、中国联通及中国移动 CMDMP 自注册 默认关闭 支持中国电信及中国移动 CMDMP 自注册 默认打开 支持中国电信、中国联通及中国移动 CMDMP 自注册 默认关闭 上海移远通信技术股份有限公司 5 / 20 BC26&BC20 运营商自注册使用说明 2 运营商自注册机制 2.1. 电信自注册 设备开机入网 开机第一次自注 册失败后，最多 再重试两次 间隔一小时 版本号或机卡 匹配变更？ 否 是 启动自注册 否 重试后 是否自注册成功？ 否 自注册成功？ 是 4 是 流程结束 ？ 次 图 1：中国电信自注册流程 2.1.1. 自注册启动 模块开机入网并识别到中国电信 USIM 卡后，将自动检测模块固件版本号是否变更或者机卡匹配关系 是否发生变化；若符合自注册触发条件，模块会启动电信自注册并自动向电信自注册平台发送特定格式的 数据包以完成设备信息的更新。 2.1.2. 自注册成功 若自注册成功，且模块后续没有固件版本号变更或者机卡匹配关系变化，则模块重启或者断电后再开 机都不会再次触发电信自注册。 上海移远通信技术股份有限公司 6 / 20 BC26&BC20 运营商自注册使用说明 2.1.3. 自注册失败  若开机后第一次自注册失败，模块会自动再重试两次，每次重试间隔时间为 1 小时；  若重试两次后仍然失败，则等下次开机才会再次触发自注册流程。 2.1.4. 自注册影响  自注册失败后的重试可能会将模块从深休眠模式唤醒；  自注册过程中 TCP 协议重传可能会影响模块进入深休眠模式的时间；  自注册服务器地址采用域名模式；若域名解析失败，可能会影响模块进入深休眠模式的时间。 2.2. 联通自注册 设备开机入网 间隔一小时 开机第一次自注册失败 后，最多再重试两次 否 重试后是否 自注册成功？ 是 流程结束 版本号或机卡 匹配变更？ 否 是 启动自注册 否 自注册成功？ 是 注册状态周期性 次 （每隔30天）更新 当前时间-LastRegTime 否 >30天？ 是 否 注册周期 30天到期？ 是 图 2：中国联通自注册流程 2.2.1. 自注册启动 模块开机入网并识别到中国联通 USIM 卡后，将自动检测模块固件版本号是否变更或者机卡匹配关系 是否发生变化；若符合自注册触发条件，模块会启动自注册并自动向联通自注册平台发送特定格式的数据 包以完成设备信息的更新。 上海移远通信技术股份有限公司 7 / 20 BC26&BC20 运营商自注册使用说明 2.2.2. 自注册成功 若自注册成功，模块将周期性（每隔 30 天）更新注册状态；模块重启或者断电后再开机，更新周期不 会被重置。 2.2.3. 自注册失败  若开机后第一次自注册失败，模块会自动再重试两次，每次重试间隔时间为 1 小时；  若重试两次后仍然失败，则等下次开机才会再次触发自注册流程；  周期性更新注册状态时，若第一次自注册失败，模块也会自动再重试两次，每次重试间隔时间为 1 小时；  周期性更新注册状态时，若三次自注册均失败，则需等待 30 天后（即下个注册状态更新周期）再 重新触发自注册流程。 2.2.4. 自注册影响  自注册失败后的重试或者周期性注册状态更新可能会将模块从深休眠模式唤醒；  自注册过程中 TCP 协议重传可能会影响模块进入深休眠模式的时间。 2.3. 移动 CMDMP 自注册 设备开机入网 启动自注册 否 自注册成功 是 流程结束 24小时周期性更新 图 3：中国移动 CMDMP 自注册流程 上海移远通信技术股份有限公司 8 / 20 BC26&BC20 运营商自注册使用说明 2.3.1. 自注册启动 模块开机入网并识别到中国移动 USIM 卡后，默认自动注册到移动 CMDMP 服务器。 2.3.2. 自注册成功 若自注册成功，模块将默认周期性（每隔 24 小时）执行一次更新操作。 2.3.3. 自注册失败  若模块向 CMDMP 平台发送注册包但未收到平台回复，将进行 5 次重发，即最多发送 6 次注册数 据包；重发间隔依次默认为 2 秒、4 秒、8 秒、16 秒、32 秒和 64 秒，总超时时间为 128 秒；  若 5 次重发均未收到平台回复或者收到错误回复，则在下次开机入网时再重新触发自注册流程。 2.3.4. 自注册影响  自注册过程中 CoAP 协议重传可能会影响模块进入深休眠模式的时间；  周期性更新可能会将模块从深休眠模式唤醒。 上海移远通信技术股份有限公司 9 / 20 BC26&BC20 运营商自注册使用说明 3 运营商自注册相关 AT 命令 本章介绍如何使用 AT 命令控制运营商自注册功能。关于是否需要开启运营商自注册功能，请联系对应 的运营商进行确认。 3.1. AT 命令语句 3.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 2：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 10 / 20 BC26&BC20 运营商自注册使用说明 3.2. AT 命令描述 3.2.1. AT+QSREGENABLE 启用/禁用中国电信、中国联通自注册 该命令用于启用/禁用中国电信和中国联通的自注册功能。 AT+QSREGENABLE 启用/禁用中国电信、中国联通自注册 查询命令 AT+QSREGENABLE? 响应 +QSREGENABLE: 设置命令 AT+QSREGENABLE= OK 响应 OK 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令重启后生效，参数配置自动保存至 NVRAM 参数 整型。启用或禁用中国电信和中国联通自注册功能。 0 禁用中国电信和中国联通自注册功能 1 启用中国电信和中国联通自注册功能 举例 AT+QSREGENABLE? +QSREGENABLE: 0 OK AT+QSREGENABLE=1 OK //查询中国电信和中国联通自注册状态 //禁用中国电信和中国联通自注册 //启用中国电信和中国联通自注册 3.2.2. AT+QDMPCFG CMDMP 接入配置 该命令用于配置和查询 CMDMP 接入信息。 查询命令用于查询模块当前配置的参数。 设置命令用于保存或擦除配置信息，相关配置重启后生效。 上海移远通信技术股份有限公司 11 / 20 BC26&BC20 运营商自注册使用说明 AT+QDMPCFG CMDMP 接入配置 测试命令 AT+QDMPCFG=? 响应 +QDMPCFG: [,[,[,[,]]]] 查询命令 AT+QDMPCFG? OK 响应 +QDMPCFG: 0, +QDMPCFG: 1,,, +QDMPCFG: 2,,,, OK 设置命令 AT+QDMPCFG=[,[,[,[,]]]] 响应 当为 0、1、2 或 5 且命令执行成功时： OK 当为 4、为 0 且命令执行成功时： +QDMPCFG: 0, OK 当为 4、为 1 且命令执行成功时： +QDMPCFG: 1,,, OK 当为 4、为 2 且命令执行成功时： +QDMPCFG: 2,,,, OK 当为 6 且命令执行成功时： +QDMPCFG: 6, OK 最大响应时间 若出现任何错误： ERROR 300 毫秒 上海移远通信技术股份有限公司 12 / 20 BC26&BC20 运营商自注册使用说明 保存机制 参数配置自动保存至 NVRAM，且深休眠唤醒后仍有效 参数 配置类型。 0 配置 CMDMP 接入状态 1 配置 CMDMP 服务器地址与更新周期 2 配置 CMDMP 应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 4 查询保存到 NVRAM 的配置信息 5 擦除保存到 NVRAM 的配置信息 6 查询 CMDMP 接入状态 不同的值配置不同的参数，格式如下： 0 1 2 3 预留值 4 5 6 CMDMP 接入模式。 0 禁止接入 CMDMP 1 允许接入 CMDMP CMDMP 服务器 IP 地址，默认服务器 IP 为 117.161.2.41。 CMDMP 服务器端口，默认服务器端口为 5683。 更新周期。范围：300-4294966，默认值为 86400；单位：秒。 应用密钥。设置命令中，应用双引号标记。 私钥。设置命令中，应用双引号标记；私钥仅显示前四位字符。 终端类型。 0 接口 1 Linux 2 Android 终端设备的 IMEI 号。长度应为 15-17 字节。 保存的配置信息查询选项。 0 查询保存的 CMDMP 接入模式 1 查询保存的 CMDMP 服务器 IP 地址、端口和更新周期 2 查询保存的应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 保存的配置信息擦除选项。 0 擦除保存的 CMDMP 接入模式 1 擦除保存的 CMDMP 服务器 IP 地址、端口和更新周期 2 擦除保存的应用密钥、私钥、终端类型和终端 IMEI 号 上海移远通信技术股份有限公司 13 / 20 BC26&BC20 运营商自注册使用说明 3 预留值 4 擦除以上保存的所有信息 CMDMP 接入状态。 0 DMP_INITIAL_STATE 4 DMP_CONNECT_SUCCESS 5 DMP_CONNECT_FAILED 6 DMP_REG_SUCCESS 7 DMP_REG_FAILED 8 DMP_REG_TIMEOUT 9 DMP_LIFETIME_TIMEOUT 11 DMP_UPDATE_SUCCESS 12 DMP_UPDATE_FAILED 13 DMP_UPDATE_TIMEOUT 举例 AT+QDMPCFG? //查询当前配置信息。 +QDMPCFG: 0,1 +QDMPCFG: 1,117.161.2.7,5683,420 +QDMPCFG: 2,M100000089,95Go****,1,863703030822519 OK AT+QDMPCFG=0,0 OK //禁止接入 CMDMP。 AT+QDMPCFG=4,0 +QDMPCFG: 0,0 //查询已保存的 CMDMP 接入模式。 OK AT+QDMPCFG=1,117.161.2.7,5683,420 OK //设置 CMDMP 服务器 IP 地址、端口和更新周期。117.161.2.7 是 CMDMP 测试服务器 IP 地址。 AT+QDMPCFG=4,1 +QDMPCFG: 1,117.161.2.7,5683,420 //查询保存的 CMDMP 服务器 IP 地址、端口和更新周期。 OK AT+QDMPCFG=2,'M100000089','95Go****',1,863703030822519 OK //设置应用密钥、私钥、终端类型 和终端 IMEI 号。 上海移远通信技术股份有限公司 14 / 20 BC26&BC20 运营商自注册使用说明 AT+QDMPCFG=4,2 //查询保存的应用密钥、私钥、终端类型和终端 IMEI 号。 +QDMPCFG: 2,M100000089, 95Go****,1,863703030822519 OK AT+QDMPCFG=5,4 OK //擦除所有已保存的信息。 AT+QDMPCFG=6 +QDMPCFG: 6,6 //查询 CMDMP 接入状态。 //注册成功。 OK AT+QDMPCFG=6 +QDMPCFG: 6,11 //更新成功。 OK 3.2.3. AT+QDMPCFGEX CMDMP 接入扩展配置 该命令用于配置和查询 CMDMP v2.0 所需的 CMDMP 接入扩展信息。 设置命令用于保存、读取或擦除配置信息，相关配置重启后生效。 AT+QDMPCFGEX CMDMP 接入扩展配置 测试命令 AT+QDMPCFGEX=? 响应 +QDMPCFGEX: ,[,[,[,,]]] OK 设置命令 AT+QDMPCFGEX=,[,[,[,,]]] 响应 当为 0 或 2，且命令执行成功时： OK 当为 0、为 1 且命令执行成功时： +QDMPCFGEX: 0, OK 当为 1、为 1 且命令执行成功时： +QDMPCFGEX: 1, OK 上海移远通信技术股份有限公司 15 / 20 BC26&BC20 运营商自注册使用说明 最大响应时间 保存机制 当为 2、为 1 且命令执行成功时： +QDMPCFGEX: 2,,,, OK 当为 3、为 1 且命令执行成功时： +QDMPCFGEX: 3,, OK 当为 4、为 1 且命令执行成功时： +QDMPCFGEX: 4,,,, OK 当为 5、为 1 且命令执行成功时： +QDMPCFGEX: 5, OK 若出现任何错误： ERROR 300 毫秒 参数配置自动保存至 NVRAM，且深休眠唤醒后仍有效 参数 配置类型。 0 配置终端应用程序信息 1 配置终端 MAC 地址 2 配置终端 ROM、RAM、CPU 和操作系统版本信息 3 配置终端软件版本和名称 4 配置终端 VoLTE 状态、网络类型、宽带帐号和电话号码 5 配置终端位置信息 配置模式。 0 保存信息至模块 1 读取模块中的信息 2 擦除模块中的信息 不同的值配置不同的参数，格式如下： 上海移远通信技术股份有限公司 16 / 20 BC26&BC20 运营商自注册使用说明 0 0 1 0 2 0 3 0 4 0 5 0 带双引号的字符串型。表示终端应用程序信息，最大字符串长度为 255 字节。它是应用 程序信息的集合，每个信息块用分号分隔，内容包含应用程序名称、包名称、应用程序 使用时间（单位：毫秒）、应用程序打开次数，并且每部分内容以'|'分隔。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 MAC 地址，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 ROM 信息，最大字符串长度为 19 字节。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 RAM 信息，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 CPU 信息，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端操作系统版本，最大字符串长度为 47 字节。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的软件版本，最大字符串长度为 47 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的软件名称，最大字符串长度为 47 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端 VoLTE 状态，最大字符串长度为 7 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端网络类型，最大字符串长度为 19 字节。如果没有相关 信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端宽带账号，最大字符串长度为 47 字节。如果没有相关 信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的电话号码，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的位置信息，最大字符串长度为 255 字节。如果没有相 关信息，请将其设置为'NULL'。 举例 AT+QDMPCFGEX=0,0,'Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551 ;Alipay|FW88|22650|5555;Zhihu|FW333|77750|65101' //设置 APP 信息。 OK AT+QDMPCFGEX=0,1 //查询 APP 信息。 +QDMPCFGEX: 0,Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551;Alip ay|FW88|22650|5555;Zhihu|FW333|77750|65101 上海移远通信技术股份有限公司 17 / 20 BC26&BC20 运营商自注册使用说明 OK AT+QDMPCFGEX=0,2 OK //擦除 APP 信息。 AT+QDMPCFGEX=1,0,'00-01-6C-06-A6-29' OK //设置 MAC 地址。 AT+QDMPCFGEX=1,1 +QDMPCFGEX: 1,00-01-6C-06-A6-29 //查询 MAC 地址。 OK AT+QDMPCFGEX=1,2 OK //擦除 MAC 地址。 AT+QDMPCFGEX=2,0,'4096KB','4096KB','MT2625','FREE RTOS' //设置 ROM、RAM、CPU、OS 版本信息。 OK AT+QDMPCFGEX=2,1 //查询 ROM、RAM、CPU、OS 版本信息。 +QDMPCFGEX: 2,4096KB,4096KB,MT2625,FREE RTOS OK AT+QDMPCFGEX=2,2 OK //擦除 ROM、RAM、CPU、OS 版本信息。 AT+QDMPCFGEX=3,0,'BC26NBR01A07','Quectel' OK //设置软件版本和名称。 AT+QDMPCFGEX=3,1 //查询软件版本和名称。 +QDMPCFGEX: 3,BC26NB0R01A07,Quectel OK AT+QDMPCFGEX=3,2 OK //擦除软件版本和名称。 AT+QDMPCFGEX=4,0,'off','NB-IoT','XY05553867549','18009699999' //设置 VoLTE 状态、网络类 型、宽带帐号和电话号码。 OK 上海移远通信技术股份有限公司 18 / 20 BC26&BC20 运营商自注册使用说明 AT+QDMPCFGEX=4,1 //查询 VoLTE 状态、网络类型、宽带帐号和电话号码。 +QDMPCFGEX: 4,off,NB-IoT,XY05553867549,18009699999 OK AT+QDMPCFGEX=4,2 OK //擦除 VoLTE 状态、网络类型、宽带帐号和电话号码。 AT+QDMPCFGEX=5,0,'31.8438799075,117.2025477950,OTDOA' OK //设置位置信息。 AT+QDMPCFGEX=5,1 //查询位置信息。 +QDMPCFGEX: 5,31.8438799075,117.2025477950,OTDOA OK AT+QDMPCFGEX=5,2 OK //擦除位置信息。 上海移远通信技术股份有限公司 19 / 20 BC26&BC20 运营商自注册使用说明 4 附录 A 术语缩写 表 3：术语缩写 术语 APP CoAP CMDMP CPU IMEI IP MAC ME NB-IoT NVRAM OS RAM ROM TCP VoLTE NVRAM 英文全称 Applications Constrained Application Protocol China Mobile Device Management Platform Central Processing Unit International Mobile Equipment Identity Internet Protocol Media Access Control Mobile Equipment Narrow Band Internet of Things Non-Volatile Random Access Memory Operating System Random Access Memory Read Only Memory Transmission Control Protocol Voice over Long-Term Evolution Non-Volatile Random Access Memory 中文全称 应用程序 受限应用协议 中国移动设备管理平台 中央处理单元 国际移动设备识别码 互联网协议 媒体接入控制 移动设备 窄带物联网 非易失性随机访问存储器 操作系统 随机访问存储器 只读存储器 传输控制协议 长期演进语音承载（一般称高清通话） 非易失性随机访问存储器 上海移远通信技术股份有限公司 20 / 20

BC26 LwM2M 应用指导 NB-IoT 模块系列 版本：BC26_LwM2M_应用指导_V1.0 日期：2020-05-16 状态：受控文件 www.quectel.com BC26 LwM2M 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 51 文档历史 修订记录 版本 1.0 日期 2020-05-16 作者 王瑞/ 李婷婷/ 蒋涛 变更表述 初始版本 BC26 LwM2M 应用指导 上海移远通信技术股份有限公司 2 / 51 BC26 LwM2M 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. AT 命令语句 ............................................................................................................................... 7 1.1.1. 定义 ................................................................................................................................. 7 1.1.2. AT 命令语句.................................................................................................................... 7 2 AT 命令详解 .......................................................................................................................................... 8 2.1. AT+QLACONFIG 配置注册参数.............................................................................................. 8 2.2. AT+QLACFG 配置可选注册参数 ............................................................................................. 9 2.3. AT+QLAREG 发送注册请求 .................................................................................................. 14 2.4. AT+QLAUPDATE 发送更新请求 ........................................................................................... 14 2.5. AT+QLADEREG 发送注销请求 ............................................................................................. 16 2.6. AT+QLAADDOBJ 添加 LwM2M 对象.................................................................................... 16 2.7. AT+QLADELOBJ 删除 LwM2M 对象 .................................................................................... 18 2.8. AT+QLARDRSP 响应读请求................................................................................................. 19 2.9. AT+QLAWRRSP 响应写请求 ................................................................................................ 20 2.10. AT+QLAEXERSP 响应执行请求 ........................................................................................... 21 2.11. AT+QLAOBSRSP 响应订阅请求........................................................................................... 22 2.12. AT+QLANOTIFY 上报被订阅资源的数据 .............................................................................. 24 2.13. AT+QLASENDDATA 直接发送数据 ...................................................................................... 25 2.14. AT+QLARD 读取缓存数据..................................................................................................... 27 2.15. AT+QLARECOVER 手动恢复 LwM2M 会话 ......................................................................... 28 2.16. AT+QLASTATUS 查询当前 LwM2M 状态 ............................................................................. 29 3 LwM2M 相关 URC .............................................................................................................................. 30 3.1. +QLAURC: 'ping' 生命周期更新结果通知............................................................................. 31 3.2. +QLAURC: 'buffer' 缓存空间由空到有数据通知 ................................................................... 31 3.3. +QLAURC: 'read' 服务器读请求通知 ................................................................................... 31 3.4. +QLAURC: 'write' 服务器写请求通知 ................................................................................... 32 3.5. +QLAURC: 'execute' 服务器执行请求通知 .......................................................................... 33 3.6. +QLAURC: 'observe' 服务器订阅请求通知 .......................................................................... 33 3.7. +QLAURC: 'bs_finished' LwM2M 引导服务器引导阶段完成通知 ........................................ 34 3.8. +QLAURC: 'report' CON 类型数据已发送通知..................................................................... 34 3.9. +QLAURC: 'report_ack' 收到 CON 类型数据包应答的通知 ................................................. 34 3.10. +QLAURC: 'send_ack' 收到 CON 类型数据包应答的通知................................................... 35 3.11. +QLAURC: 'lifetime_changed' 生命周期更改通知 ............................................................... 35 3.12. +QLAURC: 'binding_changed' 绑定模式更改通知 ............................................................... 35 3.13. +QLAURC: 'recovered' LwM2M 会话恢复结果通知............................................................. 36 3.14. +QLAURC: 'lw_event' LwM2M 其他事件通知 ...................................................................... 36 上海移远通信技术股份有限公司 3 / 51 BC26 LwM2M 应用指导 3.15. 缓存数据 URC（）.............................................................................................. 37 4 举例 ..................................................................................................................................................... 38 4.1. 使用 LwM2M 协议对接中国移动 Andlink 平台 ......................................................................... 38 4.1.1. 平台侧配置 .................................................................................................................... 38 4.1.2. 模块侧对接平台的 AT 命令示例 .................................................................................... 38 4.2. 使用 LwM2M 协议对接中国电信 AEP 平台 .............................................................................. 40 4.2.1. 平台侧配置 .................................................................................................................... 40 4.2.1.1. 产品创建 ............................................................................................................. 40 4.2.1.2. 设备添加 ............................................................................................................. 41 4.2.1.3. 设备激活后对象操作........................................................................................... 42 4.2.2. 模块侧对接平台的 AT 命令示例 .................................................................................... 43 4.3. 使用 LwM2M 协议对接 Telit 平台 ............................................................................................. 44 4.3.1. 平台侧配置 .................................................................................................................... 44 4.3.1.1. 产品创建 ............................................................................................................. 44 4.3.1.2. 设备添加 ............................................................................................................. 45 4.3.1.3. 配置设备属性和添加订阅对象 ............................................................................ 46 4.3.2. 模块侧对接命令示例...................................................................................................... 48 5 结果码概要 .......................................................................................................................................... 50 6 附录 A.................................................................................................................................................. 51 上海移远通信技术股份有限公司 4 / 51 BC26 LwM2M 应用指导 表格索引 表 1：AT 命令及响应类型 ............................................................................................................................ 7 表 2：LwM2M 相关的 URC ........................................................................................................................ 30 表 3：缓存详情...................................................................................................................... 37 表 4：值描述...................................................................................................................................... 37 表 5： 概要 ......................................................................................................................... 50 表 6：术语缩写 ........................................................................................................................................... 51 上海移远通信技术股份有限公司 5 / 51 BC26 LwM2M 应用指导 图片索引 图 1：中国电信物联网开放平台首页 .......................................................................................................... 40 图 2：产品中心 - 创建产品 ....................................................................................................................... 40 图 3：创建产品 - 编辑产品配置 ................................................................................................................ 41 图 4：添加设备 ........................................................................................................................................... 41 图 5：查看对象（Object） ......................................................................................................................... 42 图 6：查看 Object 日志............................................................................................................................... 42 图 7：Telit 平台 .......................................................................................................................................... 44 图 8：创建新设备 ....................................................................................................................................... 45 图 9：选择设备类型.................................................................................................................................... 45 图 10：设备定义 ......................................................................................................................................... 46 图 11：设备管理/查询................................................................................................................................. 46 图 12：定义与 LwM2M thing 相关的 Device profile ................................................................................... 47 图 13：新增与 LwM2M thing 相关的 Device profile ................................................................................... 47 图 14：设置 LwM2M Profile ....................................................................................................................... 48 上海移远通信技术股份有限公司 6 / 51 BC26 LwM2M 应用指导 1 引言 本文档主要介绍如何通过 AT 命令使用移远通信 BC26 模块的 LwM2M 协议功能。 1.1. AT 命令语句 1.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 7 / 51 BC26 LwM2M 应用指导 2 AT 命令详解 本章节主要介绍 BC26 模块与 LwM2M 功能相关的 AT 命令。 2.1. AT+QLACONFIG 配置注册参数 该命令用于配置 LwM2M 客户端的注册参数。 AT+QLACONFIG 配置注册参数 查询命令 AT+QLACONFIG? 响应 当=0 且配置了相应的 LwM2M 工作 服务器信息时，或当=1 且成功下发 LwM2M 工作服务器信息时： +QLACONFIG: 0,,,,,[,,], OK 设置命令 AT+QLACONFIG=,,,,,,[,][,binding_m ode] 若未作任何配置，或当=1 但未下发 LwM2M 工作服务器信息时： OK 响应 OK 若有参数错误或者当前 LwM2M 状态并非未注册： ERROR 最大响应时间 300 毫秒 特性说明 该命令立即生效； 若使用 LwM2M 工作服务器，参数配置自动保存； 若使用 LwM2M 引导服务器，参数配置不保存。 参数 整型。是否使用 LwM2M 引导服务器。 0 使用 LwM2M 工作服务器 上海移远通信技术股份有限公司 8 / 51 BC26 LwM2M 应用指导 1 使用 LwM2M 引导服务器 字符串类型。LwM2M 服务器的 IP 地址或域名。最大长度：150 字节。 整型。LwM2M 服务器的端口号。范围：0~65535。 字符串类型。设备的端点名称。最大长度：150 字节。 整型。注册的生命周期。范围：20~31536000（365 天）；默认值：86400；单位： 秒。 如果 ≤ 30 秒，则实际更新间隔 = /2 如果 ≤ 50 秒，则实际更新间隔 = 15 + ( - 3 0) × 3/4 如果 ≤ 100 秒，则实际更新间隔 = 30 + ( - 50) × 4/5 如果 ≤ 300 秒，则实际更新间隔 = 70 + ( - 100) × 9/10 如果 > 300 秒，则实际更新间隔 = 250 + ( - 300) × 19/20 当实际更新间隔计时器超时，模块将自动上报数据，更新并重置注册的生命周期。 整型。加密模式。 0 DTLS 预共享秘钥加密模式 3 非加密模式 字符串类型。预共享秘钥标识符。最大长度：150 字节。仅在=0 时有效。 字符串类型。预共享秘钥；必须为偶数和十六进制字符串格式。最大长度：256 字 节。仅在=0 时有效。 整型。为 LwM2M 客户端配置的传输绑定模式。 0 UDP 模式 1 UDP & Queue 模式 备注 1. 若配置 LwM2M 引导服务器，模块不会保存 LwM2M 引导服务器信息，仅保存 LwM2M 引导服务器成 功引导分配的工作服务器信息。 2. 若重新配置注册参数，模块会按照新配置的注册参数进行注册或引导注册。 2.2. AT+QLACFG 配置可选注册参数 该命令用于配置可选注册参数。 AT+QLACFG 配置可选注册参数 查询命令 响应 AT+QLACFG? +QLACFG: 'retransmit',, +QLACFG: 'auto_ack', +QLACFG: 'access_mode', +QLACFG: 'platform', +QLACFG: 'cfg_res',,,, 上海移远通信技术股份有限公司 9 / 51 BC26 LwM2M 应用指导 +QLACFG: 'recovery_mode', +QLACFG: 'lifetime_enable', +QLACFG: 'dtls_mode', +QLACFG: 'dtls_version', 设置命令 配置响应超时时间和最大重传次 数 AT+QLACFG='retransmit'[,,] OK 响应 若省略 和 ，则查询当前配 置的响应超时时间和重传最大次数： +QLACFG: 'retransmit',, OK 若指定 和 ，则配置响应超 时时间和重传最大次数： OK 设置命令 配置是否启动平台订阅时自动应 答 AT+QLACFG='auto_ack'[,] 若有任何错误： ERROR 响应 若省略 ，则查询当前是否启动平台订阅时自动应答： +QLACFG: 'auto_ack', OK 若指定 ，则配置是否启动平台订阅时自动应答： OK 设置命令 配置接收数据的读取模式 AT+QLACFG='access_mode' [,] 若有任何错误： ERROR 响应 若省略，则查询当前接收数据的读取模式： +QLACFG: 'access_mode', OK 若指定 ，则配置接收数据的读取模式： OK 设置命令 配置要连接的目标 IoT 平台 AT+QLACFG='platform'[,<pla 若有任何错误： ERROR 响应 若省略，则查询当前连接的 IoT 平台： +QLACFG: 'platform', 上海移远通信技术股份有限公司 10 / 51 BC26 LwM2M 应用指导 tform>] OK 若指定，则配置要连接的目标 IoT 平台： OK 设置命令 配置定制化对象资源的值 AT+QLACFG='cfg_res'[,,,,] 若有任何错误： ERROR 响应 若省略 、、 和 ，则 查询当前定制化对象资源的值： +QLACFG: 'cfg_res',,,, OK 若指定 、、 和 ，则 配置定制化对象资源的值： OK 设置命令 配置模块深休眠唤醒后 LwM2M 会话功能的恢复模式 AT+QLACFG='recovery_mod e'[,] 若有任何错误： ERROR 响应 若省略 ，则查询模块深休眠唤醒后 LwM2M 会话 功能的恢复模式： +QLACFG: 'recovery_mode', OK 若指定 ，则配置模块深休眠唤醒后 LwM2M 会话 功能的恢复模式： OK 设置命令 配置是否启用自动发送更新请求 功能 AT+QLACFG='lifetime_enable '[,] 若有任何错误： ERROR 响应 若省略 ，则查询当前是否启用自动发送更新请求功 能： +QLACFG: 'lifetime_enable', OK 若指定 ，则配置是否启用自动发送更新请求功能： OK 上海移远通信技术股份有限公司 11 / 51 BC26 LwM2M 应用指导 设置命令 配置从深休眠唤醒后模块恢复 LwM2M 会话时的 DTLS 握手模式 AT+QLACFG='dtls_mode'[,< DTLS_mode>] 若有任何错误： ERROR 响应 若省略 ，则查询从深休眠唤醒后模块恢复 LwM2M 会 话时的 DTLS 握手模式： +QLACFG: 'dtls_mode', OK 若指定 ，则配置从深休眠唤醒后模块恢复 LwM2M 会 话时的 DTLS 握手模式： OK 设置命令 配置 DTLS 握手时的协议版本号 AT+QLACFG='dtls_version'[, ] 若有参数错误或者当前 LwM2M 状态并非未注册： ERROR 响应 若省略 ，则查询 DTLS 握手时的协议版本号： +QLACFG: 'dtls_version', OK 若指定 ，则配置 DTLS 握手时的协议版本号： OK 最大响应时间 特性说明 若有参数错误或者当前 LwM2M 状态并非未注册： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。响应超时时间。 每次重传或检测间隔时间 = × 2(NT-1) 'NT' 是传输次数。范围：2~20；默认值：2；单位：秒。 整型。最大重传次数。范围：0~8；默认值：5。 整型。启动/禁止平台订阅时自动应答；自动应答信息中不包含被订阅资源的 具体值。 0 禁止 1 启动 整型。接收数据的读取模式。 0 直吐模式 上海移远通信技术股份有限公司 12 / 51 BC26 LwM2M 应用指导 1 缓存模式 整型。要连接的目标 IoT 平台。 0 其他平台 1 中国电信 AEP 平台 2 中国移动 Andlink 平台 整型。LwM2M 协议支持的对象 ID。范围：0~65535。 整型。LwM2M 协议支持的实例 ID。范围：0~65535。 整型。LwM2M 协议支持的资源 ID。范围：0~65535。 字符串类型。对应 LwM2M 协议支持的资源值。 整型。模块深休眠唤醒后 LwM2M 会话功能的恢复模式。 0 自动恢复 1 手动恢复；在模块的注册生命周期内，可使用 AT+QLARECOVER 手动恢 复 LwM2M 会话 整型。是否启用自动发送更新请求功能。 0 禁用 1 启用 整型。从深休眠唤醒后模块恢复 LwM2M 会话时的 DTLS 握手模式。 0 使用 DTLS 完整流程握手 1 使用 DTLS 会话恢复（Session Resumption）流程握手 整型。DTLS 版本号。 0 使用 DTLS 1.0 版本握手 1 使用 DTLS 1.2 版本握手 2 通过握手与服务器协商 备注 1. 连接中国移动 Andlink 平台时，需要通过 AT+QLACFG='cfg_res',3,0,17,配置产品 ID；非 Andlink 平台无须关注此命令。 2. 当设置为 1 时，建议同时将生命周期拉长，方可正常手动恢复 LwM2M 会话进而起到降低功耗的效果。 举例 AT+QLACFG='access_mode',0 OK AT+QLACFG='retransmit',2,4 OK AT+QLACFG='platform',1 OK AT+QLACFG='cfg_res',3,0,17,500677 OK AT+QLACFG='auto_ack',1 OK AT+QLACFG='lifetime_enable',1 上海移远通信技术股份有限公司 13 / 51 OK AT+QLACFG='dtls_mode',0 OK AT+QLACFG='dtls_version',1 OK BC26 LwM2M 应用指导 2.3. AT+QLAREG 发送注册请求 该命令用于向 IoT 平台发送注册请求。 AT+QLAREG 发送注册请求 执行命令 响应 AT+QLAREG OK +QLAREG: 最大响应时间 特性说明 若有参数错误或者当前 LwM2M 状态并非未注册： ERROR 300 毫秒 / 参数 整型。结果码。相关详情请参阅第 5 章。 举例 AT+QLAREG OK +QLAREG: 0 //成功注册到 loT 平台。 2.4. AT+QLAUPDATE 发送更新请求 该命令用于向 IoT 平台发送更新请求。 上海移远通信技术股份有限公司 14 / 51 BC26 LwM2M 应用指导 AT+QLAUPDATE 发送更新请求 设置命令 响应 AT+QLAUPDATE=,<lifetime/b +QLAUPDATE: inding_mode> OK +QLAUPDATE: , 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效（实际是否生效取决于网络）； 参数配置自动保存。 备注 执行 AT+QLAUPDATE 时，若距离上一次成功更新时的时间差超过平台已经接受的注册生命周期 （），则该命令将返回 ERROR；因此建议在注册生命周期到期前进行更新操作。 参数 整型。操作选项。 0 生命周期 1 传输绑定模式 整型。注册的生命周期。范围：20~31536000（365 天）；默认值：86400；单位： 秒。该参数仅在=0 时有效。 如果 ≤ 30 秒，则实际更新间隔 = /2 如果 ≤ 50 秒，则实际更新间隔 = 15 + ( – 30) × 3/4 如果 ≤ 100 秒，则实际更新间隔 = 30 + ( – 50) × 4/5 如果 ≤ 300 秒，则实际更新间隔 = 70 + ( – 100) × 9/10 如果 > 300 秒，则实际更新间隔 = 250 + ( – 300) × 19/20 当实际更新间隔计时器超时，模块将自动上报数据，更新并重置注册的生命周期。 整型。为 LwM2M 客户端配置的传输绑定模式，该参数仅在=1 时有效。 0 UDP 模式 1 UDP & Queue 模式 整型。消息 ID。 整型。结果码。相关详情请参阅第 5 章。 上海移远通信技术股份有限公司 15 / 51 举例 AT+QLAUPDATE=0,1000 +QLAUPDATE: 59797 //更新注册生命周期 OK +QLAUPDATE: 0,59797 //成功更新 BC26 LwM2M 应用指导 2.5. AT+QLADEREG 发送注销请求 该命令用于向 IoT 平台发起注销请求。 AT+QLADEREG 发送注销请求 执行命令 响应 AT+QLADEREG OK +QLADEREG: 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。结果码。相关详情请参阅第 5 章。 举例 AT+ QLADEREG OK +QLADEREG: 0 //发送注销请求 //注销成功 2.6. AT+QLAADDOBJ 添加 LwM2M 对象 该命令用于添加 LwM2M 对象（Object），并通知平台。 上海移远通信技术股份有限公司 16 / 51 BC26 LwM2M 应用指导 AT+QLAADDOBJ 添加 LwM2M 对象 查询命令 响应 AT+QLAADDOBJ? +QLAADDOBJ: ,,,[,,…] […] OK 设置命令 AT+QLAADDOBJ=,,, 若有任何错误： ERROR 响应 OK 若成功注册到平台，则继续返回： +QLAADDOBJ: 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 该命令立即生效； 参数配置自动保存。 参数 整型。对象 ID。 整型。实例 ID。 整型。资源数量。 整型。资源 ID。 整型。结果码。相关详情请参阅第 5 章。 备注 1. 目前最多可自定义 3 个对象，每个对象最多定义 4 个实例，每个实例最多定义 14 个资源。 2. 目前模块默认支持的内置对象有 0/1/3/4/5，模块会自动添加所述对象，因此不需要通过此命令进行 添加订阅。 3. 该命令可以在模块注册到 IoT 平台之前或之后使用，不支持注册中使用。 举例 AT+QLAADDOBJ=19,1,1,0 OK 上海移远通信技术股份有限公司 17 / 51 +QLAADDOBJ: 0 AT+QLAADDOBJ=19,0,4,0,1,2,3 OK +QLAADDOBJ: 0 AT+QLAADDOBJ? +QLAADDOBJ: 19,1,1,0 +QLAADDOBJ: 19,0,4,0,1,2,3 OK BC26 LwM2M 应用指导 2.7. AT+QLADELOBJ 删除 LwM2M 对象 该命令用于删除 LwM2M 对象（Object），并通知 loT 平台。 AT+QLADELOBJ 删除 LwM2M 对象 设置命令 响应 AT+QLADELOBJ= OK 如果成功注册到平台，则继续返回： +QLADELOBJ: 最大响应时间 特性说明 如有任何错误： ERROR 300 毫秒 / 参数 整型。对象 ID。 整型。结果码。相关详情请参阅第 5 章。 备注 1. 该命令可以在模块注册到 IoT 平台之前或之后使用，不支持注册中使用。 2. 未添加的 LwM2M 对象，不支持删除。 上海移远通信技术股份有限公司 18 / 51 举例 AT+QLADELOBJ=17 OK //删除对象 17 +QLADELOBJ: 0 BC26 LwM2M 应用指导 2.8. AT+QLARDRSP 响应读请求 该命令用于响应来自服务器的读请求。 AT+QLARDRSP 响应读请求 设置命令 响应 AT+QLARDRSP=,,,,,,,, OK +QLARDRSP: 若有任何错误： ERROR 最大响应时间 300 毫秒 特性说明 / 参数 整型。消息 ID，来自 URC +QLAURC: 'read'。 整型。读取操作的结果码。结果码详情如下： 结果码 CoAP响应码 描述 1 2.05 内容，表示正确的结果 11 4.00 错误请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 15 4.06 未接受 整型。对象 ID，来自 URC +QLAURC: 'read'。 整型。实例 ID，来自 URC +QLAURC: 'read'。 整型。资源 ID，来自 URC +QLAURC: 'read'。 整型。值类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 3 Integer（整型） 4 Float（浮点型） 上海移远通信技术股份有限公司 19 / 51 BC26 LwM2M 应用指导 5 Boolean（布尔型） 整型。值的长度。 当=1 时，为字符数。最大长度：1024 字节。 当=2 时，为该值中字符数的一半。最大长度：512 字节。 当=3 时，为字符数。 当=4 时，为字符数。 当=5 时，应为 1。 具体的值。 当=1 时，为字符串类型。 当=2 时，为十六进制字符串类型。 当=3 时，为整型。 当=4 时，为浮点型。 当=5 时，为整型，值为 0（FALSE）或者 1（TRUE）。 整型。数据的索引号。若数据由多条消息组成，则应将其拆分为多个部分。假设将 其拆分为 N 个部分，则 取值按从 N-1 到 0 降序排列，并按所述从大到小的顺 序调用 AT 命令。如果=0，则表示这是最后一条数据消息。 整型。结果码。相关详情请参阅第 5 章。 备注 1. 该命令只能响应服务器下发的读请求所通知的消息。 2. 已经响应成功的消息，不允许重复响应。 举例 +QLAURC: 'read',62953,19,0,0 //接收到来自服务器的读请求 AT+QLARDRSP=62953,1,19,0,0,1,5,abcde,0 OK +QLARDRSP: 0 2.9. AT+QLAWRRSP 响应写请求 该命令用于响应来自服务器的写请求。 AT+QLAWRRSP 响应写请求 设置命令 响应 AT+QLAWRRSP=, OK +QLAWRRSP: 上海移远通信技术股份有限公司 20 / 51 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / BC26 LwM2M 应用指导 参数 整型。消息 ID，来自 URC +QLAURC: 'write'。 整型。写入操作的结果码。结果码详情如下： 结果码 CoAP 响应码 描述 2 2.04 已更改，表示正确的结果 11 4.00 错误请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 整型。结果码。相关详情请参阅第 5 章。 备注 1. 该命令只能响应服务器下发的写请求所通知的消息。 2. 已经响应成功的消息，不允许重复响应。 举例 +QLAURC: 'write',36560,19,0,0,2,7,'5155454354454C',0 //接收到来自服务器的写请求 AT+QLAWRRSP=36560,2 OK +QLAWRRSP: 0 2.10. AT+QLAEXERSP 响应执行请求 该命令用于响应服务器的执行请求。 AT+QLAEXERSP 响应执行请求 设置命令 AT+QLAEXERSP=, 响应 OK +QLAEXERSP: 上海移远通信技术股份有限公司 21 / 51 BC26 LwM2M 应用指导 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。消息 ID，来自 URC +QLAURC: 'execute'。 整型。执行操作的结果码。结果码详情如下： 结果码 CoAP 响应码 描述 2 2.04 已更改，表示正确的结果 11 4.00 错误请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 整型。结果码。相关详情请参阅第 5 章。 备注 1. 该命令只能响应服务器下发的执行请求所通知的消息。 2. 已经响应成功的消息，不允许重复响应。 举例 +QLAURC: 'execute',39040,15,0,5 AT+QLAEXERSP=39040,2 OK +QLAEXERSP: 0 //接收到来自服务器的执行请求 2.11. AT+QLAOBSRSP 响应订阅请求 该命令用于响应服务器的订阅请求。 AT+QLAOBSRSP 响应订阅请求 设置命令 响应 AT+QLAOBSRSP=,,,,,,,, 最大响应时间 +QLAOBSRSP: 若有任何错误： ERROR 300 毫秒 特性说明 响应订阅请求成功后订阅信息深休眠仍有效但掉电不保存。 参数 整型。消息 ID，来自 URC +QLAURC: 'observe'。 整型。订阅操作的结果码。结果码详情如下： 结果码 CoAP响应码 描述 1 2.05 内容，表示正确的结果。 11 4.00 错误请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 15 4.06 未接受 整型。对象 ID，来自 URC +QLAURC: 'observe'。 整型。实例 ID，来自 URC +QLAURC: 'observe'。 整型。资源 ID，来自 URC +QLAURC: 'observe'。 整型。值类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 3 Integer（整型） 4 Float（浮点型） 5 Boolean（布尔型） 整型。值的长度。 当=1 时，为字符数。最大值：1024；单位：字节。 当=2 时，为该值中字符数的一半。最大值：512；单位：字节。 当=3 时，为字符数。 当=4 时，为字符数。 当=5 时，应为 1。 具体的值。 当=1 时，为字符串类型。 当=2 时，为十六进制字符串类型。 当=3 时，为整型。 当=4 时，为浮点型。 当=5 时，为整型，值为 0（FALSE）或者 1（TRUE）。 整型。数据的索引号。若数据由多条消息组成，则应将其拆分为多个部分。假设将 其拆分为 N 个部分，则 取值按从 N-1 到 0 降序排列，并按所述从大到小的顺 序调用 AT 命令。如果=0，则表示这是最后一条数据消息。 上海移远通信技术股份有限公司 23 / 51 整型。结果码。相关详情请参阅第 5 章。 备注 1. 该命令只能响应服务器下发的订阅请求所通知的消息。 2. 已经响应成功的消息，不允许重复响应。 BC26 LwM2M 应用指导 举例 +QLAURC: 'observe',624,0,9,0,0 AT+QLAOBSRSP=624,1,9,0,0,1,5,'abcde',0 OK +QLAOBSRSP: 0 //接收到来自服务器的订阅请求 //响应订阅请求 2.12. AT+QLANOTIFY 上报被订阅资源的数据 该命令用于上报被订阅资源的数据。 AT+QLANOTIFY 上报被订阅资源的数据 设置命令 AT+QLANOTIFY=,,,, ,,[,] 响应 若=0 即发送 NON 类型的数据时： OK +QLANOTIFY: 若=1 即发送 CON 类型的数据时： OK +QLAURC: 'report', +QLANOTIFY: +QLAURC: 'report_ack',, 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 24 / 51 BC26 LwM2M 应用指导 参数 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 整型。值类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 3 Integer（整型） 4 Float（浮点型） 5 Boolean（布尔型） 整型。值的长度。 当=1 时，为字符数。最大值：1024；单位：字节。 当=2 时，为该值中字符数的一半。最大值：512；单位：字节。 当=3 时，为字符数。 当=4 时，为字符数。 当=5 时，应为 1。 具体的值。 当=1 时，为字符串类型。 当=2 时，为十六进制字符串类型。 当=3 时，为整型。 当=4 时，为浮点型。 当=5 时，为整型，值为 0（FALSE）或者 1（TRUE）。 整型。数据的索引号。若数据由多条消息组成，则应将其拆分为多个部分。假设将 其拆分为 N 个部分，则 取值按从 N-1 到 0 降序排列，并按所述从大到小的顺 序调用 AT 命令。如果=0，则表示这是最后一条数据消息。 整型。响应类型标记。 0 NON 类型的数据 1 CON 类型的数据 整型。信息 ID。 整型。结果码。相关详情请参阅第 5 章。 备注 该命令不支持未订阅的资源数据上报。 2.13. AT+QLASENDDATA 直接发送数据 该命令用于直接向已注册的服务器发送数据（需要服务器支持）。 上海移远通信技术股份有限公司 25 / 51 BC26 LwM2M 应用指导 AT+QLASENDDATA 直接发送数据 设置命令 AT+QLASENDDATA=,,, 响应 若=0 即发送 NON 类型的数据时： OK +QLASENDDATA: , 若=1 即发送 CON 类型的数据时： OK +QLASENDDATA: , +QLAURC: 'send_ack',, 最大响应时间 特性说明 若有参数错误： ERROR 300 毫秒 / 参数 整型。值类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 整型。值的长度。 当=1 时，为字符数。最大值：1024；单位：字节。 当=2 时，为该值中字符数的一半。最大值：512；单位：字节。 具体的值。 当=1 时，为字符串类型。 当=2 时，为十六进制字符串类型。 整型。响应类型标记。 0 NON 类型的数据 1 CON 类型的数据 整型。信息 ID。 整型。结果码。相关详情请参阅第 5 章。 备注 目前，该命令仅适用于中国移动 Andlink 平台。 上海移远通信技术股份有限公司 26 / 51 BC26 LwM2M 应用指导 2.14. AT+QLARD 读取缓存数据 该命令用于读取缓冲区中的数据。 AT+QLARD 读取缓存数据 查询命令 AT+QLARD? 执行命令 AT+QLARD 最大响应时间 特性说明 响应 +QLARD: OK 若有任何错误： ERROR 响应： +QLARD: < remain_nodes_number >, OK 当缓冲区无数据时： +QLARD: < remain_nodes_number > OK 若有任何错误： ERROR 300 毫秒 / 参数 整型。缓存节点数。最大值：30。 整型。剩余节点数。最大值：30。 字符串类型。缓存的 URC 内容，详情请参阅第 3.15 章。 举例 AT+QLARD? +QLARD: 4 OK AT+QLARD +QLARD: 3,'observe',36581,0,9,0,0 上海移远通信技术股份有限公司 27 / 51 BC26 LwM2M 应用指导 OK 2.15. AT+QLARECOVER 手动恢复 LwM2M 会话 注册生命周期内，若模块从深休眠唤醒后 LwM2M 会话功能处于手动恢复模式，则可使用该命令手动恢 复 LwM2M 会话。 AT+QLARECOVER 手动恢复 LwM2M 会话 执行命令 响应 AT+QLARECOVER OK +QLARECOVER: 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。结果码。相关详情请参阅第 5 章。 举例 //若禁用自动恢复功能，模块在注册生命周期内从深休眠唤醒后可使用 AT+QLARECOVER 命令恢复 LwM2M 会话 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0000 0000 U0: 0000 0001 [0000] T0: 0000 001E Leaving the BROM +CPIN: READY AT+QLASTATUS? +QLASTATUS: 7 //表示需要恢复 LwM2M 会话 OK AT+QLARECOVER 上海移远通信技术股份有限公司 28 / 51 OK +QLARECOVER: 0 //LwM2M 会话恢复成功 2.16. AT+QLASTATUS 查询当前 LwM2M 状态 该命令用于查询当前 LwM2M 状态。 AT+QLASTATUS 查询当前 LwM2M 状态 查询命令 响应 AT+QLASTATUS? +QLASTATUS: OK 最大响应时间 特性说明 若有任何错误： ERROR 300 毫秒 / 参数 整型。LwM2M 状态。 0 未注册 1 注册中 2 已注册 3 注销中 4 已注销 5 无效 6 正在恢复 LwM2M 会话 7 需要恢复 LwM2M 会话 BC26 LwM2M 应用指导 上海移远通信技术股份有限公司 29 / 51 BC26 LwM2M 应用指导 3 LwM2M 相关 URC 本章提供与 LwM2M 相关的 URC 及其说明。 表 2：LwM2M 相关的 URC 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] URC 格式 描述 +QLAURC: 'ping', 通知 TE 生命周期的定期更新结果 +QLAURC: 'buffer' 通知 TE 缓存空间由空变为有数据 +QLAURC: 'read',,,,[,] +QLAURC: 'write',,,,,,,, +QLAURC: 'execute',,,, +QLAURC: 'observe',,,,, +QLAURC: 'bs_finished' 通知 TE 收到服务器的读请求 通知 TE 收到服务器的写请求 通知 TE 收到服务器的执行请求 通知 TE 收到服务器的订阅请求 通知 TE LwM2M 引导服务器引导阶 段已完成 +QLAURC: 'report', 通知 TE 已发送 CON 类型数据 +QLAURC: 'report_ack',, +QLAURC: 'send_ack',, 通知 TE 收到 CON 类型数据包的应 答 通知 TE 收到 CON 类型数据包的应 答 +QLAURC: 'lifetime_changed', 通知 TE 生命周期已更改 +QLAURC: 'binding_changed', 通知 TE 绑定模式已更改 +QLAURC: 'recovered', 通知 TE 深休眠唤醒后的 LwM2M 会 话恢复结果 +QLAURC: 'lw_event',,[,< 通知 TE 收到 LwM2M 其他事件 parameter2>,…] 上海移远通信技术股份有限公司 30 / 51 3.1. +QLAURC: 'ping' 生命周期更新结果通知 BC26 LwM2M 应用指导 +QLAURC: 'ping' 生命周期更新结果通知 +QLAURC: 'ping', 通知 TE 生命周期的定期更新结果 参数 整型。结果码。相关详情请参阅第 5 章。 3.2. +QLAURC: 'buffer' 缓存空间由空到有数据通知 +QLAURC: 'buffer' 缓存空间由空到有数据通知 +QLAURC: 'buffer' 通知 TE 缓存空间由空变为有数据，只会在由空到有时提示一次 3.3. +QLAURC: 'read' 服务器读请求通知 +QLAURC: 'read' 服务器读请求通知 +QLAURC: 'read',,,,[,] 参数 整型。消息 ID。 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 字符串类型。若下发的 URC 中含此参数，则需响应对应的参数内容。 上海移远通信技术股份有限公司 31 / 51 3.4. +QLAURC: 'write' 服务器写请求通知 BC26 LwM2M 应用指导 +QLAURC: 'write' 服务器写请求通知 +QLAURC: 'write',,,,,,,, 参数 整型。消息 ID。 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 整型。值类型。 1 String（字符串类型） 2 Opaque（非透明数据类型） 3 Integer（整型） 4 Float（浮点型） 5 Boolean（布尔型） 整型。值的长度。 当=1 时，为字符数。最大值：1024；单位：字节。 当=2 时，为该值中字符数的一半。最大值：512；单位：字节。 当=3 时，为字符数。 当=4 时，为字符数。 当=5 时，应为 1。 从服务器接收的具体值。 当=1 时，为字符串类型。 当=2 时，为十六进制字符串类型。 当=3 时，为整型。 当=4 时，为浮点型。 当=5 时，为整型，值为 0（FALSE）或者 1（TRUE）。 整型。写请求的索引号。若写请求由多条消息组成，则应将其拆分为多个部分。假设将 其拆分为 N 个部分，则 取值按从 N-1 到 0 降序排列，并且 URC 按照所述从 大到小的编号顺序排序。如果为 0，则表示这是写请求的最后一条消息。当前， 仅支持=0。 上海移远通信技术股份有限公司 32 / 51 3.5. +QLAURC: 'execute' 服务器执行请求通知 BC26 LwM2M 应用指导 +QLAURC: 'execute' 服务器执行请求通知 +QLAURC: 'execute',, 通知 TE，LwM2M 客户端收到服务器的执行请求，TE 应使用 ,, AT+QLAEXERSP 响应该请求。 参数 整型。消息 ID。 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 3.6. +QLAURC: 'observe' 服务器订阅请求通知 +QLAURC: 'observe' 服务器订阅请求通知 +QLAURC: 'observe',, 通知 TE，LwM2M 客户端服务器发出订阅请求，TE 应使用 ,,, 参数 整型。信息 ID。 整型。指示是否要订阅。 0 订阅 1 取消订阅 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 上海移远通信技术股份有限公司 33 / 51 BC26 LwM2M 应用指导 3.7. +QLAURC: 'bs_finished' LwM2M 引导服务器引导阶段完成通知 +QLAURC: 'bs_finished' LwM2M 引导服务器引导阶段完成通知 +QLAURC: 'bs_finished' 通知 TE，LwM2M 引导服务器引导阶段已完成 3.8. +QLAURC: 'report' CON 类型数据已发送通知 +QLAURC: 'report' CON 类型数据已发送通知 +QLAURC: 'report', 通知 TE CON 类型数据已发送 参数 整型。消息 ID。 3.9. +QLAURC: 'report_ack' 收到 CON 类型数据包应答的通知 +QLAURC: 'report_ack' 收到 CON 类型数据包应答的通知 +QLAURC: 'report_ack',, 使用 AT+QLANOTIFY 发送 CON 类型数据时，LwM2M 工作 服务器通知 TE 收到 CON 类型数据包的应答。此时可确定服务 器已经收到对应的数据包。 参数 整型。结果码。相关详情请参阅第 5 章。 整型。消息 ID。 上海移远通信技术股份有限公司 34 / 51 BC26 LwM2M 应用指导 3.10. +QLAURC: 'send_ack' 收到 CON 类型数据包应答的通知 +QLAURC: 'send_ack' 收到 CON 类型数据包应答的通知 +QLAURC: 'send_ack',, 使 用 AT+QLASENDDATA 命 令 发 送 CON 类 型数 据 时， LwM2M 工作服务器通知 TE 收到 CON 类型数据包的应答。此 时可确定服务器已经收到相应的数据包。 参数 整型。结果码。相关详情请参阅第 5 章。 整型。消息 ID。 3.11. +QLAURC: 'lifetime_changed' 生命周期更改通知 +QLAURC: 'lifetime_changed' 生命周期更改通知 +QLAURC: 'lifetime_changed', 通知 TE，LwM2M 客户端的生命周期（）值 已更改。 参数 整型。注册的生命周期。范围：20~31536000（365 天）；单位：秒。 如果 ≤ 30 秒，则实际更新间隔 = /2 如果 ≤ 50 秒，则实际更新间隔 = 15 + ( - 30) × 3/4 如果 ≤ 100 秒，则实际更新间隔 = 30 + ( - 50) × 4/5 如果 ≤ 300 秒，则实际更新间隔 = 70 + ( - 100) × 9/10 如果 > 300 秒，则实际更新间隔 = 250 + ( - 300) × 19/20 当实际更新间隔计时器超时，模块将自动上报数据，更新并重置注册的生命周期。 3.12. +QLAURC: 'binding_changed' 绑定模式更改通知 +QLAURC: 'binding_changed' 绑定模式更改通知 +QLAURC: 'binding_changed',<bin 通知 TE，LwM2M 客户端的值已更改。 ding_mode> 上海移远通信技术股份有限公司 35 / 51 参数 字符串类型。客户端绑定模式。 'U' UDP 模式 'UQ' UDP & Queue 模式 BC26 LwM2M 应用指导 3.13. +QLAURC: 'recovered' LwM2M 会话恢复结果通知 +QLAURC: 'recovered' LwM2M 会话恢复结果通知 +QLAURC: 'recovered', 被唤醒，LwM2M 客户端默认会自动恢复会话。此通知告知 TE 恢复的结果。 参数 整型。结果码。相关详情请参阅第 5 章。 3.14. +QLAURC: 'lw_event' LwM2M 其他事件通知 +QLAURC: 'lw_event' LwM2M 其他事件通知 +QLAURC: 'lw_event',,, 参数 整型。事件的类型。当前仅为 0。 0 收到平台下发的 RST 应答 整型。信息类型。当前固定为 5。 整型。消息 ID。 上海移远通信技术股份有限公司 36 / 51 3.15. 缓存数据 URC（） BC26 LwM2M 应用指导 表 3：缓存详情 序号 描述 [1] 'read',,,,[,] [2] 'write',,,,,,,, [3] 'execute',,,, 平台执行自定义对象 [4] 'observe',,,,, [5] 'execute',0,3,0,4 平台执行重启，此消息被缓存时需要 MCU 发送 AT+QRST=1 重启模块 [6] 'lifetime_changed', 服务器下发生命周期 [7] 'bs_finished' [8] 'fota_end', LwM2M 引导服务器引导阶段完成 升级结束后上报的升级结果，同时模块也 会上报+QIND: 'FOTA','END',。有 关错误码请参考下表。 表 4：值描述 值 0 1 2 254 255 英文描述 Upgraded successfully Unknown error DFOTA is busy Delta firmware package mismatch Delta firmware package invalid 中文描述 升级成功 未知错误 DFOTA 繁忙 差分包不匹配 差分包无效 上海移远通信技术股份有限公司 37 / 51 BC26 LwM2M 应用指导 4 举例 4.1. 使用 LwM2M 协议对接中国移动 Andlink 平台 4.1.1. 平台侧配置 如何在中国移动 Andlink 平台上创建设备及平台相关问题，请联系中国移动 Andlink 平台客户经理。 4.1.2. 模块侧对接平台的 AT 命令示例 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM RDY +CFUN: 1 +CPIN: READY +IP: 100.64.250.187 AT+QLACFG='platform',2 //配置目标平台为中国移动 Andlink 平台 OK AT+QLACFG='cfg_res',3,0,17,500677 //配置 Andlink 平台的产品类型 OK AT+QLAADDOBJ=19,1,1,0 //添加对象 19/1/0 OK AT+QLACONFIG=1,'lwm.home.komect.com',5683,'866971031275899',30,3 //配置服务器信息 OK AT+QLAREG //发送注册请求 OK +QLAURC: 'binding_changed',U 上海移远通信技术股份有限公司 38 / 51 BC26 LwM2M 应用指导 +QLAURC: 'bs_finished' +QLAREG: 0 +QLAURC: 'read',8095,19,1,0 AT+QLARDRSP=8095,1,19,1,0,2,71,'7b226f75746c6574537461747573223a2231222c227365745469 6d65223a2231222c226669726d77617265223a22312e30222c22736f667456657273696f6e223a22312e 30227d',0 OK +QLARDRSP: 0 +QLAURC: 'write',8096,19,1,0,1,20,'{'outletStatus':'1'}',0 AT+QLAWRRSP=8096,2 OK +QLAWRRSP: 0 AT+QLASENDDATA=2,112,'5b7b226e223a222f31392f312f30222c227673223a227b5c226f75746c65 745374617475735c223a5c22305c222c5c2273657454696d655c223a5c22315c222c5c226669726d776 172655c223a5c22312e305c222c5c22736f667456657273696f6e5c223a5c22312e305c227d227d5d',0 OK +QLASENDDATA: 0,5004 AT+QLASENDDATA=2,112,'5b7b226e223a222f31392f312f30222c227673223a227b5c226f75746c65 745374617475735c223a5c22305c222c5c2273657454696d655c223a5c22315c222c5c226669726d776 172655c223a5c22312e305c222c5c22736f667456657273696f6e5c223a5c22312e305c227d227d5d',1 OK +QLASENDDATA: 0,5005 +QLAURC: 'send_ack',0,5005 AT+QLAUPDATE=0,100 +QLAUPDATE: 8601 OK +QLAUPDATE: 0,8601 AT+QLADEREG OK +QLADEREG: 0 上海移远通信技术股份有限公司 39 / 51 BC26 LwM2M 应用指导 4.2. 使用 LwM2M 协议对接中国电信 AEP 平台 4.2.1. 平台侧配置 4.2.1.1. 产品创建 1. 登录 CTWing 中国电信物联网开放平台（https://www.ctwing.cn）（即 AEP 平台），在控制台内 选择'产品中心'，随后点击'创建产品'，新建一款产品。 图 1：中国电信物联网开放平台首页 图 2：产品中心 - 创建产品 上海移远通信技术股份有限公司 40 / 51 BC26 LwM2M 应用指导 2. 在'创建产品'界面，根据自己的需求编辑产品的各项配置（下图仅为举例说明，若第一次创建， 建议选择透传模式）。 图 3：创建产品 - 编辑产品配置 4.2.1.2. 设备添加 进入创建好的产品，点击'添加设备'。 上海移远通信技术股份有限公司 图 4：添加设备 41 / 51 4.2.1.3. 设备激活后对象操作 1. 如下图，点击红色箭头所指图标，可查看对象（Object）。 BC26 LwM2M 应用指导 图 5：查看对象（Object） 2. 在'Object 列表'中，可对其中的 Object 进行订阅、取消订阅和读写等操作。下图中右上方点击 '查看 Object 日志'，可查看之前执行的操作日志。 图 6：查看 Object 日志 备注 以上仅作为新手参考，更多内容请参考中国电信 AEP 平台的官方开发文档（https://help.ctwing.cn/）。 上海移远通信技术股份有限公司 42 / 51 BC26 LwM2M 应用指导 4.2.2. 模块侧对接平台的 AT 命令示例 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM RDY +CFUN: 1 +CPIN: READY +IP: 100.64.250.187 AT+QLACFG='platform',1 //配置目标平台为中国电信 AEP 平台 OK AT+QLACONFIG=0,'221.229.214.202',5683,'urn:imei-imsi:866971030603068-460111174747875',3 00,3 OK AT+QLAADDOBJ=19,0,1,0 //添加对象 19/0/0 OK AT+QLAADDOBJ=19,1,1,0 //添加对象 19/1/0 OK AT+QLAREG OK +QLAREG: 0 +QLAURC: 'observe',45419,0,19,0,0 AT+QLAOBSRSP=45419,1,19,0,0,2,9,'020001000400023238',0 OK +QLAOBSRSP: 0 AT+QLANOTIFY=19,0,0,2,9,'020001000400023238',0,0 OK +QLANOTIFY: 0 AT+QLANOTIFY=19,0,0,2,9,'020001000400023238',0,1 OK 上海移远通信技术股份有限公司 43 / 51 +QLAURC: 'report',34218 +QLANOTIFY: 0 +QLAURC: 'report_ack',0,34218 AT+QLAUPDATE=0,100 +QLAUPDATE: 8601 OK +QLAUPDATE: 0,8601 AT+QLADEREG OK +QLADEREG: 0 BC26 LwM2M 应用指导 4.3. 使用 LwM2M 协议对接 Telit 平台 4.3.1. 平台侧配置 4.3.1.1. 产品创建 1. 登录中国联通物联网开放平台（https://device1-portal.10646.cn/things/browse/）（即 Telit 平台）， 登录门户，点击正上方'Things'，进入设备管理界面。 图 7：Telit 平台 2. 点击右上角'New Thing'创建新设备。NB-IoT 设备选择'LWM2M thing'类型。 上海移远通信技术股份有限公司 44 / 51 BC26 LwM2M 应用指导 图 8：创建新设备 图 9：选择设备类型 4.3.1.2. 设备添加 1. 进入'Thing definitions'界面，如果前面已经创建过 thing definition 就有多个可以选择；如果 没创建过，则只有默认配置。如需创建新模板可点击'Create new thing definition'，选择'next' 进入下一步。 2. 'Endpoint'下填写对应设备的 IMEI，'Connection'选择'Server without DTLS'，若已创建 Device profile，则有多个可供选择；如果未创建过，则仅可选默认配置。如需创建新模板可进入 'Developer' 'Device profiles'，点击'Add'完成设备创建。 上海移远通信技术股份有限公司 45 / 51 BC26 LwM2M 应用指导 图 10：设备定义 3. 设备创建成功后，进入如下界面，可对设备进行管理、查询等。 图 11：设备管理/查询 4.3.1.3. 配置设备属性和添加订阅对象 1. 先点击正上方的'Developer'，然后需要定义与 LwM2M thing 相关的 Device profile，进入之后 选择'New device profile'。 上海移远通信技术股份有限公司 46 / 51 BC26 LwM2M 应用指导 图 12：定义与 LwM2M thing 相关的 Device profile 图 13：新增与 LwM2M thing 相关的 Device profile 2. 完成 Device profile 的创建后，将 LwM2M thing 的 Device profile 改为新创建的 profile。 上海移远通信技术股份有限公司 47 / 51 BC26 LwM2M 应用指导 图 14：设置 LwM2M Profile 4.3.2. 模块侧对接命令示例 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM RDY +CFUN: 1 +CPIN: READY +IP: 100.64.250.187 AT+QLACFG='platform',0 //配置目标平台为 Telit 平台 OK AT+QLACONFIG=0,'device1-api.10646.cn',5683,'867726030187399',300,3 OK AT+QLAADDOBJ=19,0,1,0 //添加对象 19/0/0 OK AT+QLAADDOBJ=19,1,1,0 //添加对象 19/1/0 上海移远通信技术股份有限公司 48 / 51 OK AT+QLAREG OK +QLAREG: 0 +QLAURC: 'observe',23618,0,19,0,0 AT+QLAOBSRSP=23618,1,19,0,0,2,9,'020001000400023238',0 OK +QLAOBSRSP: 0 AT+QLANOTIFY=19,0,0,2,9,'020001000400023438',0,0 OK +QLANOTIFY: 0 AT+QLANOTIFY=19,0,0,2,9,'020001000400023438',0,1 OK +QLAURC: 'report',8563 +QLANOTIFY: 0 +QLAURC: 'report_ack',0,8563 AT+QLAUPDATE=0,100 +QLAUPDATE: 41760 OK +QLAUPDATE: 0,41760 AT+QLADEREG OK +QLADEREG: 0 BC26 LwM2M 应用指导 上海移远通信技术股份有限公司 49 / 51 BC26 LwM2M 应用指导 5 结果码概要 表 5： 概要 0 1 2 3 描述 成功 超时 数据包未发送 恢复失败 4 更新失败 5 重置 400 错误请求 403 禁止 404 未找到 412 前提条件失败 900 其他错误 原因 - 网络异常或服务器未响应 当生命周期到期或者恢复过程中平台无响应，会导致恢复失 败，建议执行 AT+QLAREG 重新注册。 当发起更新时，若距离上一次成功更新时的时间差超过平台已 经接受的注册生命周期，则会导致生命周期更新失败；建议执 行 AT+QLASTATUS 查询状态后执行对应操作。 服务器回复 RST 服务器回复 4.00 服务器回复 4.03 服务器回复 4.04 服务器回复 4.12 未注网成功或其他内部错误 上海移远通信技术股份有限公司 50 / 51 BC26 LwM2M 应用指导 6 附录 A 表 6：术语缩写 缩写 APN CoAP CON DTLS DFOTA ID IMEI IoT IP LwM2M NB-IoT NON RST TE UDP URC 英文描述 Access Point Name Constrained Application Protocol Confirmable Datagram Transport Layer Security Delta Firmware Upgrade Over-The-Air Identifier International Mobile Equipment Identity Internet of Things Internet Protocol Lightweight Machine to Machine Narrow Band Internet of Things Nonconfirmable Reset Terminal Service User Datagram Protocol Unsolicited Result Code 中文描述 接入点名称 受限应用协议 需要对端返回应答的信息类型 数据包传输层安全性协议 固件空中差分升级 标识符 国际移动设备识别码 物联网 网际互连协议 一种轻量化的物联网协议 窄带物联网 不需要对端返回应答的信息类型 重置 终端设备 用户数据报协议 非请求结果码 上海移远通信技术股份有限公司 51 / 51

BC25&BC32 China Telecom IoT Platform Application Note LPWA Module Series Rev. BC25&BC32_China_Telecom_IoT_Platform_Application_Note_V1.0 Date: 2019-07-22 Status: Released www.quectel.com LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 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. 2019. All rights reserved. BC25&BC32_China_Telecom_IoT_Platform_Application_Note 1 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note About the Document History Revision Date Author 1.0 2019-07-22 Peyton LI Description Initial BC25&BC32_China_Telecom_IoT_Platform_Application_Note 2 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index...................................................................................................................................................4 1 Introduction .......................................................................................................................................... 5 2 The Platform Related AT Commands ................................................................................................ 6 2.1. AT Command Syntax .................................................................................................................. 6 2.2. Description of AT Commands ..................................................................................................... 6 2.2.1. AT+NCDPOPEN Connect Modules to the Platform...................................................... 6 2.2.2. AT+NCDPCLOSE Disconnect Modules from the Platform ........................................... 7 2.2.3. AT+NMGS Send Message to the Platform.................................................................... 8 2.2.4. AT+NMGR Retrieve a Message Received from the Platform....................................... 9 2.2.5. AT+NNMI New Message Indication ............................................................................ 10 2.2.6. AT+NCFG* Configuration Command of the Platform ................................................. 10 2.2.7. AT+NMSTATUS* Query the Register Status............................................................... 12 3 The Platform Related URCs .............................................................................................................. 13 3.1. '+QLWEVTIND' URC to Indicate Status of Modules................................................................ 13 3.2. '+NNMI' URC to Indicate A New Message Has Been Received.............................................. 14 3.3. '+NNMI: OC'recv',buff full' URC to Indicate the Buffer Is Full................................................. 14 4 Examples ............................................................................................................................................ 15 4.1. Connect Unencrypted Device to the Platform and Disable Deep Sleep .................................. 15 4.2. Connect Encrypted Devices to the Platform and Disable Deep Sleep..................................... 16 4.3. Connect Device to the Platform and Enable Deep Sleep......................................................... 18 5 Summary of Codes .................................................................................................................. 20 6 Appendix A References.....................................................................................................................21 BC25&BC32_China_Telecom_IoT_Platform_Application_Note 3 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note Table Index TABLE 1: TYPES OF AT COMMANDS AND RESPONSES ............................................................................... 6 TABLE 2: URCS RELATED TO THE PLATFORM ............................................................................................ 13 TABLE 3: GENERAL ERRORS (27.007)........................................................................................................... 20 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 21 BC25&BC32_China_Telecom_IoT_Platform_Application_Note 4 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 1 Introduction LwM2M (Lightweight Machine to Machine) is a secure, efficient and deployable client-server protocol for managing resource constrained devices on a variety of networks. LwM2M uses a modern architectural design based on REST, defines an extensible resource and data model and reuses and builds on an efficient secure data transfer standard called the Constrained Application Protocol (CoAP). It is a profile for device services based on CoAP (RFC 7252). LwM2M offers a light and compact secure communication interface together with an efficient data model, realizing the management and service enablement of M2M devices. This document mainly introduces how to connect devices applying Quectel BC25 and BC32 modules to China Telecom IoT Platform (the Platform) and realize related functions through LwM2M. BC25&BC32_China_Telecom_IoT_Platform_Application_Note 5 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 2 The Platform Related AT Commands In this chapter presented the AT commands related to connection and functions of the Platform. 2.1. AT Command Syntax Table 1: Types of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? AT+? AT+= AT+ This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. This command returns the currently set value of the parameter or parameters. This command sets the user-definable parameter values. This command reads non-variable parameters affected by internal processes in the UE. 2.2. Description of AT Commands 2.2.1. AT+NCDPOPEN Connect Modules to the Platform The command is used to connect modules to server of the Platform by configuring the IP address and port. If not configured, default of these parameters will be used. Please refer to Chapter 5 for possible values. AT+NCDPOPEN Connect Modules to the Platform Test Command AT+NCDPOPEN=? Response OK If there is any error: ERROR Or +CME ERROR: BC25&BC32_China_Telecom_IoT_Platform_Application_Note 6 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note Write Command Response AT+NCDPOPEN=[,[, If the module is successfully registered on the Platform: ]] OK +QLWEVTIND: 0 +QLWEVTIND: 3 Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Parameter IP address of the server: '180.101.147.115'. Integer type. IP port of the Server. Default is 5683 when not configured or configured to 0. The range is 0-65535. String type. The key for encrypted devices. Dynamically generated by the Platform or set by the user when connecting modules to the server. NOTES 1. The module’s IMEI must be registered on the server first before using any function of the Platform. The registration address is: https://develop.ct10649.com:8093. 2. If the module is an encrypted one, it must be connected through the port 5684 with the . 3. If one AT+NCDPOPEN command has already been executed, AT+NCDPCLOSE must be executed before executing another AT+NCDPOPEN. 4. If the module is woken up from Deep Sleep, it has to be re-registered with AT+NCDPOPEN. 5. After AT+NCDPOPEN is executed, the module will keep trying connecting until the connection succeeds. 2.2.2. AT+NCDPCLOSE Disconnect Modules from the Platform This command is used to disconnect the module from the Platform. Please refer to Chapter 5 for possible values. AT+NCDPCLOSE Disconnect Modules from the Platform Execution Command AT+NCDPCLOSE Response OK BC25&BC32_China_Telecom_IoT_Platform_Application_Note 7 / 21 Maximum Response Time LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note If there is any error: ERROR Or +CME ERROR: 300ms 2.2.3. AT+NMGS Send Message to the Platform The command is used to send data to the Platform through LwM2M protocol. It will respond ERROR or +CME ERROR: if the message cannot be sent. Please refer to Chapter 5 for possible values. AT+NMGS Send Message to the Platform Write Command Response AT+NMGS=,[,] OK Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Parameter * Decimal length of message. The maximum is 512. Unit: byte. Data to be sent in hexadecimal format. Integer type 0 Send NON message and set RAI mode to 0 1 Send NON message and set RAI mode to 1 2 Send NON message and set RAI mode to 2 100 Send CON message and set RAI mode to 0 101 Send CON message and set RAI mode to 1 102 Send CON message and set RAI mode to 2 NOTES 1. '*' means under development. 2. Sending NON message means to send message without need for ACK from the server, while sending CON message means to send message with need for ACK from the server. 3. If RAI mode has been set, it will take effect on all data sent by the module to the server. 4. RAI mode being set to 0 means to release network normally, RAI mode being set to 1 means to BC25&BC32_China_Telecom_IoT_Platform_Application_Note 8 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note release network right now and RAI mode being set to 2 means to release network after receiving data. 5. The default value of is 0. Thus, if is omitted, it will be set to 0. 2.2.4. AT+NMGR Retrieve a Message Received from the Platform The command is used to retrieve a message which has been received from the server of the Platform. Please refer to Chapter 5 for possible values. AT+NMGR Retrieve a Message Received from the Platform Execution Command AT+NMGR Response If the message is not null and retrieved successfully: +NMGR: , OK If the message is null and retrieved successfully: OK Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Parameter The length of received message. Unit: byte. Message received from the Platform in hexadecimal format. NOTES 1. The command retrieves the oldest buffered message and deletes it from the buffer when the message is successfully retrieved. 2. In the case that the direct new message indication is enabled (AT+NNMI=1), received messages will be displayed directly in the URC and will not be saved in the buffer, thus, there is no need to manually retrieve the message with AT+NMGR. BC25&BC32_China_Telecom_IoT_Platform_Application_Note 9 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 2.2.5. AT+NNMI New Message Indication The command is used to enable and disable the URC indication when a new downstream message from the Platform’s server reaches the module. Please refer to Chapter 5 for possible values. AT+NNMI New Message Indication Read Command AT+NNMI? Response +NNMI: Write Command AT+NNMI= OK Response OK Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Parameter Integer type. 0 No indications 1 Indications and message 2 Indications only NOTES 1. When AT+NNMI=1 is configured, all messages received from the Platform will be returned directly with URC '+NNMI: ,' and received messages will not be buffered. 2. When AT+NNMI=2 is configured, the newly received message when the buffer is empty triggers an indication URC '+NNMI' while the received message will be buffered to be retrieved with AT+NMGR. 3. The buffer saves 2560 bytes of data at most, if a new message plus messages saved in the buffer exceeds 2560 bytes, the new message will be abandoned with a URC '+NNMI: OC'recv',buff full' returned indicating the buffer is full. 2.2.6. AT+NCFG* Configuration Command of the Platform This command is used to configure functions of the Platform. Please refer to Chapter 5 for possible values. BC25&BC32_China_Telecom_IoT_Platform_Application_Note 10 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note AT+NCFG* Configuration Command of the Platform Test Command AT+NCFG=? Response +NCFG: 0[,(0-2592000)] OK Write Command AT+NCFG=[,] If there is any error: ERROR Or +CME ERROR: Response If is presented, configure the : OK If is omitted, query the current : +NCFG: value OK Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Parameter Integer type. 0 Lifetime configure Integer type when =0. Default is 86400. Unit: second. Range: 0-2592000. NOTES 1. '*' means under development. 2. If the lifetime is configured to 0, lifetime will not be included in the registration package when the module is registered to the server, at the same time, the module will not send the update package to the server. 3. Lifetime will be reset to default after the module is rebooted. If the lifetime is configured when the module has already been connected to the Platform, it will only take effect when the module is reconnected next time. 4. If the lifetime is configured to a value from 1 to 900, it will be taken as 900. BC25&BC32_China_Telecom_IoT_Platform_Application_Note 11 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 2.2.7. AT+NMSTATUS* Query the Register Status This command is used to query the register status. Please refer to Chapter 5 for possible values. AT+NMSTATUS* Read Command AT+NMSTATUS? Query the Register Status Response +NMSTATUS: OK Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Parameter String type UNINITIALISED REGISTERING REJECTED_BY_SERVER TIMEOUT_AND_RETRYING REGISTERED DEREGISTERED RESUMPTION_FAILED Connection not initialized by AT+NCDPOPEN yet Try to register to the server Connect request rejected by the server Connect time out and try to reconnect Registered successfully Disconnected successfully by AT+NCDPCLOSE Session resumption failed of DTLS connect NOTES 1. '*' means under development. 2. If the status is REJECTED_BY_SERVER, please check whether the module is connecting to the Platform with correct IP address and port, and check whether the IMEI, before executing AT+NCDPOPEN, has been registered on the Platform. Then execute AT+NCDPCLOSE and then AT+NCDPOPEN to reconnect. 3. If the status is TIMEOUT_AND_RETRYING, please check whether the IP address and port are correct, and, for encrypted devices, check the as well. Then, try to reconnect. BC25&BC32_China_Telecom_IoT_Platform_Application_Note 12 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 3 The Platform Related URCs In this chapter listed URCs relevant to China Telecom IoT Platform and their descriptions. Table 2: URCs Related to the Platform Index URC [1] +QLWEVTIND: [2] +NNMI[: ,] [3] +NNMI: OC'recv',buff full Description Indicate the module’s status. Indicate a new message has been received. Indicate the buffer is full. 3.1. '+QLWEVTIND' URC to Indicate Status of Modules The URC mainly indicates the status of modules. '+QLWEVTIND: ' URC to Indicate Status of Modules URC Format: +QLWEVTIND: Indicate the module’s status. Parameter Integer type -1 Indicate the connection open failed, abnormal event has occurred 0 Indicate the module is registered 3 Indicate the module is observed 4 Indicate the CON message is sent successfully 5 Indicate the CON message failed to be sent BC25&BC32_China_Telecom_IoT_Platform_Application_Note 13 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 3.2. '+NNMI' URC to Indicate A New Message Has Been Received The URC mainly indicates a new message that has been received from the Platform. '+NNMI' URC to Indicate A New Message Has Been Received URC Format: +NNMI[: ,] A new message has been received. Parameter The length of the received message. The new message that has been received. 3.3. '+NNMI: OC'recv',buff full' URC to Indicate the Buffer Is Full The URC mainly indicates the buffer is full. '+NNMI: OC'recv',buff full' URC to Indicate the Buffer Is Full URC Format: +NNMI: OC'recv',buff full The buffer is full. BC25&BC32_China_Telecom_IoT_Platform_Application_Note 14 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 4 Examples This chapter offers the examples about how to apply AT commands related to the Platform to realize relevant functions. 4.1. Connect Unencrypted Device to the Platform and Disable Deep Sleep AT+QSCLK=0 OK //Disable Deep Sleep AT+CPSMS=0 OK //Disable PSM AT+CEDRXS=0 OK //Disable eDRX AT+CGDCONT? //Query whether the module registers on network successfully +CGDCONT: 1,'IP','CMNBIOT','100.96.147.151',0,0 //Registered and ready OK AT+NCDPOPEN='180.101.147.115' //Connect module to the server of the Platform OK //Executed successfully +QLWEVTIND: 0 //The module has been registered +QLWEVTIND: 3 //Data can be sent to the Platform AT+NNMI=1 OK //Set the new message indication mode to 'Indications and message' AT+NMGS=7,010548454c4c4f OK //Send message to the Platform +NNMI: 4,AAAA0000 //The message received from the Platform BC25&BC32_China_Telecom_IoT_Platform_Application_Note 15 / 21 AT+NNMI=0 OK AT+NMGS=7,010548454c4c4f OK AT+NMGR +NMGR: 4,AAAA0000 OK AT+NNMI=2 OK AT+NMGS=7,010548454c4c4f OK +NNMI AT+NMGR +NMGR: 4,AAAA0000 OK AT=NCDPCLOSE OK LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note //Set the new message indication mode to 'No indications' //Retrieve a message in the buffer received from the Platform //The message received from the Platform //Set the new message indications mode to 'Indications only' //Send message to the Platform //A new message has been received //Retrieve a message in the buffer received from the Platform //The message received from the Platform //Disconnect the module from the Platform 4.2. Connect Encrypted Devices to the Platform and Disable Deep Sleep AT+QSCLK=0 OK //Disable Deep Sleep AT+CPSMS=0 OK //Disable PSM AT+CEDRXS=0 OK //Disable eDRX AT+CGDCONT? //Query whether the module registers on network successfully +CGDCONT: 1,'IP','CMNBIOT','100.96.147.151',0,0 //Registered and ready BC25&BC32_China_Telecom_IoT_Platform_Application_Note 16 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note OK AT+NCDPOPEN='180.101.147.115',5684,'d32804b8cb6701dc4d698ad67ec0ed25' //When the device is encrypted, execute the command with the port 5684 and to connect the device OK //Executed successfully +QLWEVTIND: 0 //The module has been registered +QLWEVTIND: 3 //Data can be sent to the Platform AT+NNMI=1 OK //Set the new message indication mode to 'Indications and message' AT+NMGS=7,010548454c4c4f OK //Send message to the Platform +NNMI: 4,AAAA0000 //The message received from the Platform AT+NNMI=0 OK //Set the new message indication mode to 'No indications' AT+NMGS=7,010548454c4c4f OK AT+NMGR +NMGR: 4,AAAA0000 //Retrieve a message in the buffer received from the Platform //The message received from the Platform OK AT+NNMI=2 OK //Set the new message indication mode to 'Indications only' AT+NMGS=7,010548454c4c4f OK //Send message to the Platform +NNMI //New message has been received AT+NMGR +NMGR: 4,AAAA0000 //Retrieve a message in the buffer received from the Platform //The message received from the Platform OK BC25&BC32_China_Telecom_IoT_Platform_Application_Note 17 / 21 AT=NCDPCLOSE OK LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note //Disconnect the module from the Platform 4.3. Connect Device to the Platform and Enable Deep Sleep AT+QSCLK=0 OK //Disable Deep Sleep AT+CPSMS=1 OK //Enable PSM AT+CEDRXS=1 OK //Enable eDRX if needed AT+CGDCONT? //Query whether the module registers on network successfully +CGDCONT: 1,'IP','CMNBIOT','100.96.147.151',0,0 //Registered and ready OK AT+NCDPOPEN='180.101.147.115' //Connect the module to the Platform OK //Executed successfully +QLWEVTIND: 0 //The module has been registered +QLWEVTIND: 3 //Data can be sent to the Platform AT+NNMI=1 OK //Set the new message indication mode to 'Indications and message' AT+NMGS=7,010548454c4c4f OK //Send message to the Platform +NNMI: 4,AAAA0000 //The message received from the Platform AT+NNMI=0 OK //Set the new message indication mode to 'No indications' AT+NMGS=7,010548454c4c4f OK AT+NMGR //Retrieve a message in the buffer received from the Platform BC25&BC32_China_Telecom_IoT_Platform_Application_Note 18 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note +NMGR: 4,AAAA0000 //The message received from the Platform OK AT+NNMI=2 OK //Set the new message indication mode to 'Indications only' AT+NMGS=7,010548454c4c4f OK //Send message to the Platform +NNMI //A new message has been received AT+NMGR +NMGR: 4,AAAA0000 //Retrieve a message in the buffer received from the Platform //The message received from the Platform OK AT=NCDPCLOSE OK //Disconnect the module from the Platform AT+QSCLK=1 OK //Enable Deep Sleep +QATSLEEP //Entering Deep Sleep +QATWAKEUP //The module is woken up from Deep Sleep AT+QSCLK=0 OK //Disable Deep Sleep AT+CGDCONT? //Query whether the module registers on network successfully +CGDCONT: 1,'IP','CMNBIOT','100.96.147.151',0,0 //Registered and ready OK AT+NCDPOPEN='180.101.147.115' //Connect the module to the Platform OK //Executed successfully +QLWEVTIND: 0 //The module has been registered +QLWEVTIND: 3 //Data can be sent to the Platform BC25&BC32_China_Telecom_IoT_Platform_Application_Note 19 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 5 Summary of Codes This chapter introduces the error values related to BC25 and BC32 modules. Table 3: General Errors (27.007) Code of 3 4 23 30 50 52 53 159 285 286 Description Operation not allowed Operation not supported Memory failure No network service Execute fail Option not support Param invalid Uplink busy/flow control wait for session resumption wait for data sending NOTE AT+CMEE= command disables (=0) or enables (=1, =2) the use of final result code +CME ERROR:. For details of this command, refer to Quectel_BC25_AT_Commands_Manual or Quectel_BC32_AT_Commands_Manual please. BC25&BC32_China_Telecom_IoT_Platform_Application_Note 20 / 21 LPWA Module Series BC25&BC32 China Telecom IoT Platform Application Note 6 Appendix A References Table 4: Terms and Abbreviations Abbreviation ACK CON eDRX IMEI IoT LwM2M NB-IoT LPWA NON PDN PSM RAI URC Description Acknowledgement Confirmable Extended Discontinuous Receive International Mobile Equipment Identity Internet of Things Lightweight Machine to Machine Narrow Band Internet of Things Low-Power Wide-Area Non-confirmable Public Data Network Power Saving Mode Release Assistance Indication Unsolicited Result Code BC25&BC32_China_Telecom_IoT_Platform_Application_Note 21 / 21

M26 Alipay SDK 应用指导 GSM/GPRS 模块系列 版本：Quectel_M26_Alipay_SDK_应用指导_V1.0 日期：2020-02-14 状态：受控文件 www.quectel.com M26 Alipay SDK 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 2 / 18 M26 Alipay SDK 应用指导 文档历史 修订记录 版本 1.0 日期 2020-02-14 作者 李家杨 变更表述 初始版本 上海移远通信技术股份有限公司 3 / 18 M26 Alipay SDK 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 1 引言 ....................................................................................................................................................... 5 2 Alipay SDK 应用流程 .......................................................................................................................... 6 3 AT 命令描述 .......................................................................................................................................... 8 3.1. AT+ALIPAYCFG 配置 Alipay 产品定义参数............................................................................. 8 3.2. AT+ALIPAYOPEN 启动 Alipay SDK ........................................................................................ 9 3.3. AT+ALIPAYPINFO 通过 Alipay SDK 上报产品规格信息 ....................................................... 10 3.4. AT+ALIPAYSHUT 关闭 Alipay SDK........................................................................................11 3.5. AT+ALIPAYDID 查询 bizTid 值 ...............................................................................................11 3.6. AT+ALIPAYSIGN 通过 Alipay SDK 对数据进行加签 ............................................................. 12 3.7. AT+ALIPAYREP 通过 Alipay SDK 上报数据到云端............................................................... 13 3.8. AT+ALIPAYACT 通过 Alipay SDK 上报行为数据................................................................... 14 4 举例 ..................................................................................................................................................... 16 5 附录 A 术语缩写 ................................................................................................................................. 18 上海移远通信技术股份有限公司 4 / 18 M26 Alipay SDK 应用指导 1 引言 本文档主要提供移远通信 M26 模块集成了 Alipay IoT RTOS UNISDK 软件包的应用指导，包含 M26 模块和支付宝后台的交互流程以及相关 AT 命令的介绍和使用。 Alipay IoT RTOS UNISDK 是支付宝为开发者提供的 RTOS 平台的软件开发包，为接入方提供如下功 能：  设备身份标识生成：为设备分配支付宝平台统一的身份标识。  设备信息获取：获取设备的硬件信息，包括厂商、型号、SN、MAC/IMEI 等信息。  网络接入功能：设备的在线状态维持、数据通讯和身份获取等。  关键信息入库：交易统计和行业专有信息等数据报告功能。 上海移远通信技术股份有限公司 5 / 18 M26 Alipay SDK 应用指导 2 Alipay SDK 应用流程 Alipay SDK 应用流程图如下： MCU Modem (SDK) 1. 模块初始化 1. AT+CPIN?查询(U)SIM卡状态 2. AT+CGREG?查询网络状态 3. AT+CSQ查询信号强度 返回(U)SI M卡状态、网络状态、信号强度信息 1. AT+QIFGCNT=0配置场景 2. AT+QNTP同步UTC时间和PDP激活 获取到IP地址，网络时间同步 ISV Server Alipay Server 2. Alipay SDK初始化 3. 发数据给 IS V服务器 4. ISV服务器给 支付宝服务器 发起代扣交易 请求 5. 发数据给支 付宝服务器 AT +GS N查询IM EI 返回IMEI值 AT +AL IPA YCFG配置 de vice_sup plier _no ,m er cha nt_use r_id,item _id, product_key,terminal_id,env 返回AT +AL IPA YCFG结果码 AT+ALIPAYOPEN初始化Alipay SDK，并连接 支付宝服务器，注册激活 返回AT +AL IPA YOP EN执行结果 AT+AL IPA YPI NFO上报产品信息 返回AT+AL IPA YPI NFO执行结果 当产品定义改变时，配置参数前会自 动清除SDK上次连接的缓存信息 通过AliPay SDK发起Register Req 支付宝服务器返回Register Cnf AT+ALIPAYSIGN, MCU发起加签请求 （待加签数据：根据加签模式输入需要加签的数据） 将加签后数据，返回给MCU SDK对数据进行加签 通过AT+QHTTPPO ST,将加签后数据和商户订 单号组包，发给modem 返回AT +QHTTPPS OT结果码 将数据通过HTTPS发给IS V服务器 IS V服务器返回结果码 AT +AL IPA YREP，上报交易信息，将代扣协议号 或交易流水号或用户付款码、金额、交易耗时、 交易结果和交易时间戳发到AliPay SDK 返回AT +AL IPA YREP结果码 AT +AL IPA YACT上报行为信息 语音播报增量次数，扫码增量次数 返回AT +AL IPA YACT结果码 交易信息上报 （必选项） 通过AliPay SDK发起Report Req 支付宝服务器返回Report Cnf 行为信息上报 （可选项） 通过AliPay SDK发起Action Req 支付宝服务器返回Act ion Cnf IS V服务端获得了商户订单号、加签数 据，并结合金额、UID、sho pI D、代扣 协议号等信息传入代扣传参，发起代 扣交易 支付宝服务端反馈交易结果到 IS V服务端 Alipay SDK 主动发送心 跳包 AliPay SDK周期性，自动发送心跳包 图 1：Alipay SDK 应用流程图 上海移远通信技术股份有限公司 6 / 18 M26 Alipay SDK 应用指导 备注 Alipay 水控项目场景下需注意以下三点： 1. 执行 AT+ALIPAYSIGN 加签，选择模式为 4（第三方代扣）和需要加签的数据，填写代扣协议号，详见第 3.6 章。 2. 执行 AT+ALIPAYREP 上报交易信息时，支付宝交易模式需填写代扣协议号；非支 付宝交易模式则为空。无论何种交易方式，每次交易时都必须上报交易信息，详见第 3.7 章。 3. 无需执行 AT+ALIPAYACT 上报行为信息。 上海移远通信技术股份有限公司 7 / 18 M26 Alipay SDK 应用指导 3 AT 命令描述 3.1. AT+ALIPAYCFG 配置 Alipay 产品定义参数 AT+ALIPAYCFG 配置 Alipay 产品定义参数 1. 测试命令 响应 AT+ALIPAYCFG=? 查询命令 OK 响应 AT+ALIPAYCFG? +ALIPAYCFG: 'module_supplier_no': 'device_supplier_no': 'merchant_user_id': 'item_id': 'product_key': 'env': 'terminal_id': 设置命令 AT+ALIPAYCFG=, ,,,, 特性说明 OK 响应 OK 或者 ERROR 该命令立即生效； 参数设置自动保存至 NVM 参数 字符串类型。硬件供应商编号，默认为 Quectel 申请的编号。默认值为 '201901220900654009'。 字符串类型。设备供应商编号。最大长度 32 字节。 字符串类型。设备识别符。最大长度 32 字节。 字符串类型。蚂蚁金服提供的产品身份识别号。最大长度 64 字节。 字符串类型。产品密钥。最大长度 64 字节。 整型。环境配置。正式上线，此参数的值设为 0；产品内测，此参数值设为 4。 字符串类型。机具 SN 号。最大长度为 64 字节。 上海移远通信技术股份有限公司 8 / 18 M26 Alipay SDK 应用指导 备注 1. 是蚂蚁金服分配给移远通信的硬件供应商编号，客户不需要输入。 2. 、、和这些参数由蚂蚁金服 提供，表示产品定义，客户只需设置一次，设置值会保存到NVM，重启也生效。 3. 是设备商的机具SN编号，需要设备供应商提供，以保证每台设备SN编号只有一个。 4. 执行AT+ALIPAYCFG后，若参数和上次的参数有任何不同，则模块会清空Alipay IOT SDK中的所 有缓存数据。 3.2. AT+ALIPAYOPEN 启动 Alipay SDK AT+ALIPAYOPEN 启动 Alipay SDK 测试命令 响应 AT+ALIPAYOPEN=? 执行命令 OK 响应 AT+ALIPAYOPEN OK 上报的 URC 表示启动 Alipay SDK 的结果，如果启动成功， 的值为 0；如果启动失败，的值为-1。 +ALIPAYOPEN: 特性说明 或者 ERROR / 参数 整型。启动 Alipay SDK 的结果。 0 启动成功 -1 启动失败 1 Alipay SDK 已存在 备注 AT+ALIPAYOPEN仅可在开机时执行一次，不能重复执行；如果执行失败，需要重启后再执行此命令。 上海移远通信技术股份有限公司 9 / 18 M26 Alipay SDK 应用指导 3.3. AT+ALIPAYPINFO 通过 Alipay SDK 上报产品规格信息 AT+ALIPAYPINFO 通过 Alipay SDK 上报产品规格信息 测试命令 响应 AT+ALIPAYPINFO=? 设置命令 OK 响应 AT+ALIPAYPINFO= OK 特性说明 参数 上报的 URC 表示上报的结果，如果上报成功，的 值为 0；如果上报失败，的值为其他值。 +ALIPAYPINFO: 或者 ERROR 该命令立即生效； 参数设置不保存至 NVM 整型。设备核查消费者身份的⽅式。 1 ⼆维码识别 2 ⼈脸识别 4 ⼿机号码识别 (SMS/CALL) 8 声纹识别 16 NFC 识别 32 指纹识别 64 邮箱识别 整型。结果码。 -1 失败 0 成功 1 参数错误 2 未初始化 3 缓存队列访问错误 4 内存分配失败 5 网络发送繁忙 6 缓存队列已满 7 数据备份失败 备注 Alipay SDK启动成功后，执行一次AT+ALIPAYPINFO即可，上报的产品信息包括流量账户信息（account flow）和(U)SIM卡的ICCID，默认account flow和(U)SIM卡的ICCID一致。 上海移远通信技术股份有限公司 10 / 18 3.4. AT+ALIPAYSHUT 关闭 Alipay SDK AT+ALIPAYSHUT 关闭 Alipay SDK 测试命令 响应 AT+ALIPAYSHUT=? 执行命令 AT+ALIPAYSHUT OK 响应 如果关闭成功： +ALIPAYSHUT OK 特性说明 否则： ERROR / M26 Alipay SDK 应用指导 备注 AT+ALIPAYSHUT命令仅用于在关机或重启设备前关闭Alipay SDK。 3.5. AT+ALIPAYDID 查询 bizTid 值 AT+ALIPAYDID 查询 bizTid 值 测试命令 AT+ALIPAYDID=? 执行命令 AT+ALIPAYDID 响应 OK 响应 OK 上报的 URC 为查询 bizTid 的结果，如果查询正确，上报 为 0 和的值；如果查询错误，则上报 为-1，无 。 特性说明 +ALIPAYDID: [,] 或者 ERROR / 上海移远通信技术股份有限公司 11 / 18 参数 查询 bizTid 的结果。 0 查询成功 -1 查询失败 bizTid 的值为支付宝服务器返回客户端的值。 备注 Alipay IoT SDK启动成功后才能使用AT+ALIPAYDID查询bizTid。 M26 Alipay SDK 应用指导 3.6. AT+ALIPAYSIGN 通过 Alipay SDK 对数据进行加签 AT+ALIPAYSIGN 通过 Alipay SDK 对数据进行加签 测试命令 响应 AT+ALIPAYSIGN=? 设置命令 OK 响应 AT+ALIPAYSIGN=,[,] OK 上报的 URC 是 Alipay SDK 对加签的结 果 ，若加 签成 功， 的 值为 0， 并上报 加签 结果 和；若加签失败，则没有 和上报。 +ALIPAYSIGN: [,,] 特性说明 或者 ERROR 该命令立即生效； 参数设置不保存至 NVM 参数 整型。加签模式。 1 用户被扫 2 用户人脸 3 用户主扫 4 第三方代扣 需要加签的数据。最大长度为 128 字节。 字符串类型。需要加签的金额。实际单位为元。最大值为 32 字节。若缺省，则为 上海移远通信技术股份有限公司 12 / 18 M26 Alipay SDK 应用指导 空。 整型。结果码。 0 加签成功 -1 加签失败 1 参数错误 2 IO 错误 3 安全库内部错误 4 签名接口调用错误 99 未知错误 加签后的数据长度。 字符串类型。加签后的数据。最大值为 2048 字节。 备注 仅当bizTid有效且不为空时，方可使用AT+ALIPAYSIGN命令。 3.7. AT+ALIPAYREP 通过 Alipay SDK 上报数据到云端 AT+ALIPAYREP 通过 Alipay SDK 上报数据到云端 测试命令 响应 AT+ALIPAYREP=? 查询命令 OK 响应 AT+ALIPAYREP? +ALIPAYREP: , 设置命令 AT+ALIPAYREP=,,,,, OK 响应 OK 上报的 URC 是通过 Alipay SDK 上报数据到云端的结果 +ALIPAYREP : 特性说明 或者 ERROR 该命令立即生效； 参数设置不保存至 NVM 参数 字符串类型。交易产生的流水号。最大 64 字节。为空表示无。当 为 0 时，需要输入流水号；当为 6 时，则缺省此参数。 字符串类型。⽤户付款码。最大为 64 个字节。此参数缺省时，值为空。 上海移远通信技术股份有限公司 13 / 18 M26 Alipay SDK 应用指导 整型。交易金额。单位：分。 整型。交易时间耗费。单位：秒。当不省略时，此参数不可为空。 整型。交易对应的结果。 -1 交易结果无法获取 0 交易成功 1 交易超时 2 交易返回失败 3 ⽀付处理中 4 网络异常 5 未知异常 6 不支持的交易 整型。交易时间戳。 整型。结果码。 -1 失败 0 成功 1 参数错误 2 未初始化 3 缓存队列访问错误 4 内存分配失败 5 mdap 繁忙 6 缓存队列已满 7 数据备份失败 发送队列的最大队列长度。 备注 请根据实际项目填写AT+ALIPAYREP传入的参数，可能会由于网络原因导致队列已满，此时将无法写入 数据。 3.8. AT+ALIPAYACT 通过 Alipay SDK 上报行为数据 AT+ALIPAYACT 通过 Alipay SDK 上报行为数据 测试命令 响应 AT+ALIPAYACT=? 设置命令 OK 响应 AT+ALIPAYACT=, OK 上报的 URC 表示上报的结果，如果上报成功，的 值为 0，如果上报失败，的值为其他值。 +ALIPAYACT: 上海移远通信技术股份有限公司 或者 14 / 18 特性说明 ERROR 该命令立即生效； 参数设置不保存至 NVM M26 Alipay SDK 应用指导 参数 整型。语⾳播报增量次数。 整型。扫码增量次数。 整型。结果码。 -1 失败 0 成功 1 参数错误 2 未初始化 3 缓存队列访问错误 4 内存分配失败 5 网络发送繁忙 6 缓存队列已满 7 数据备份失败 备注 语音播报和扫码的增量次数MCU端需要掉电保存。AT+ALIPAYACT用来上报行为数据，可根据项目需要 进行上报。 上海移远通信技术股份有限公司 15 / 18 M26 Alipay SDK 应用指导 4 举例 本章节介绍如何通过 Alipay SDK 进行数据加签和上报，示例如下： //第一步：初始化。 AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' OK AT+CREG?;+CGREG?;+CSQ +CREG: 0,1 //设置场景为 0。 //设置 APN。 //查询网络状态。 +CGREG: 0,1 +CSQ: 11,0 OK AT+QNTP='ntp1.aliyun.com' OK //访问 NTP 同步网络时间和激活网络。 +QNTP: 0 AT+ALIPAYCFG='2018040500703640','2018040500703640','2018070401748657','ALIPAY_BOX', 4,'1234567890abcdef' //设置产品定义参数。 OK AT+ALIPAYCFG? //查询产品定义参数。 +ALIPAYCFG: ' module_supplier_no': '201901220900654009' 'device_supplier_no': '2018040500703640' 'merchant_user_id': '2018040500703640' 'item_id': '2018070401748657' 'product_key': 'ALIPAY_BOX' 'env': 4 'terminal_id': '1234567890abcdef' OK //第二步：启动 Alipay SDK，只需要发送一次。 AT+ALIPAYOPEN //启动 Alipay SDK。 上海移远通信技术股份有限公司 16 / 18 M26 Alipay SDK 应用指导 OK +ALIPAYOPEN: 0 AT+ALIPAYPINFO=1 OK //上报产品信息。 +ALIPAYPINFO: 0 AT+ALIPAYDID OK //查询 Alipay bizTid 的值。 +ALIPAYDID: 0,'010100F00A1XBEXbZFJ1rsU50nCHqWohV0duAd4eOBbA5t56nJq2kkw' AT+ALIPAYSIGN=4,'1234567890','10.25' OK //通过 Alipay SDK 进行加签。 +ALIPAYSIGN: 0,369,'{'terminalType':'IOT','signature':'QIIAQ+7BtAVJiOlD98oY8Cm7tY7uUGULYx4QCFItWtU wrhcB','apdidToken':'JHRcvCf0ayAybxFkVeomX1-bYl7qvMvYwrmbrybKLep2ke4naAEAAA==',' hardToken':'','time':'1546890790','bizCode':'11000200040004000122','bizTid':'010100F00A1X BEXbZFJ1rsU50nCHqWohV0duAd4eOBbA5t56nJq2kkw','signedKeys':'authCode,totalAmount,a pdidToken,hardToken,time,bizCode,bizTid'}' AT+ALIPAYREP='2019012922001450181015731428',,1025,2,0,1548811777 OK //上报支付宝交易模式 数据。 +ALIPAYREP: 0 AT+ALIPAYREP=,,1025,,6,1548811777 OK //上报非支付宝交易模式数据。 +ALIPAYREP: 0 上海移远通信技术股份有限公司 17 / 18 M26 Alipay SDK 应用指导 5 附录 A 术语缩写 表 1：术语缩写 缩写 APN GSM ICCID IoT IO RTOS SDK (U)SIM SMS SN URC 英文全称 Access Point Name Global System for Mobile Communications Integrate Circuit Card Identity Internet of Things Input Output Real Time Operating System Software Development Kit (Universal) Subscriber Identification Module Short Message Service Serial Number Unsolicited Result Code 中文全称 网络接入技术 全球移动通信系统 集成电路卡识别码 物联网 输入输出 实时操作系统 软件开发工具包 （全球）用户身份识别卡 短信息服务 产品序列号 未经请求的结果代码 上海移远通信技术股份有限公司 18 / 18

BC26&BC20&BC030x 系列 终端应用设计指导 NB-IoT 模块系列 版本：BC26&BC20&BC030x 系列_终端应用设计指导_V1.0 日期：2020-03-31 状态：受控文件 www.quectel.com BC26&BC20&BC030x 系列终端应用设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 13 BC26&BC20&BC030x 系列终端应用设计指导 文档历史 修订记录 版本 1.0 日期 2020-03-31 作者 饶晨 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 13 BC26&BC20&BC030x 系列终端应用设计指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 推荐的终端应用设计.............................................................................................................................. 7 2.1. 功耗敏感型业务场景................................................................................................................... 7 2.1.1. 推荐设计 .......................................................................................................................... 8 2.1.2. 流程描述 .......................................................................................................................... 9 2.2. 非功耗敏感型业务场景 ............................................................................................................. 10 2.2.1. 推荐设计 ........................................................................................................................ 10 2.2.2. 流程描述 ........................................................................................................................ 11 3 附录 A 参考文档和术语缩写............................................................................................................... 12 上海移远通信技术股份有限公司 3 / 13 BC26&BC20&BC030x 系列终端应用设计指导 表格索引 表 1：推荐的终端应用设计流程描述（功耗敏感型业务） ................................................................................... 9 表 2：推荐的终端应用设计流程描述（功耗非敏感型业务） ............................................................................. 11 表 3：参考文档 .................................................................................................................................................. 12 表 4：术语缩写 .................................................................................................................................................. 12 上海移远通信技术股份有限公司 4 / 13 BC26&BC20&BC030x 系列终端应用设计指导 图片索引 图 1：推荐的终端应用设计逻辑（功耗敏感型业务） .......................................................................................... 8 图 2：推荐的终端应用设计逻辑（非功耗敏感型业务）..................................................................................... 10 上海移远通信技术股份有限公司 5 / 13 BC26&BC20&BC030x 系列终端应用设计指导 1 引言 本文档主要通过为一些典型的业务应用场景提供软件设计推荐，以便通过移远通信的如下 NB-IoT 模块 便捷地设计出终端应用程序。  BC26  BC20  BC030x 系列（包含 BC3030S-CN 和 BC030N-B5） 上海移远通信技术股份有限公司 6 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2 推荐的终端应用设计 本章针对功耗敏感型和非功耗敏感型终端应用场景，分别提供推荐的应用设计，以便用户根据实际业 务需求而选择合适的推荐设计。 模块默认打开 PSM 和 eDRX 模式，同时支持通过 AT 命令控制是否使能 PSM 和 eDRX，也可通过 AT 命令配置 PSM 和 eDRX 参数。但通过 AT 命令配置的 PSM/eDRX 参数仅仅是模块所支持以及建议的参数， 最终该建议的参数是否被采纳依赖于网络配置。 受运营商频点部署的变化影响，模块注网的时间可能较长，建议按 300 秒的注网超时判断设计 MCU 逻辑。若存在弱网信号，导致模块反复尝试注册并且超过 300 秒仍无法注网成功，则建议参考推荐设计清 频（清除模块已存储的 EARFCN 列表）。 2.1. 功耗敏感型业务场景 对于功耗敏感型业务的应用场景，建议启用 PSM 和 eDRX 以达到降低功耗的目的。 上海移远通信技术股份有限公司 7 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2.1.1. 推荐设计 上电 开机 AT+QRST=1 关机 ＜ 3次， 次数 + 1 3次 重启次数 未准备好 无IP URC上报 AT+QCGDEF 是 CONT AT+QCSEARFCN AT+CFUN=0 300秒超时 未注册成功 AT+IPR？ AT+CPIN? 准备就绪 AT+CIMI AT+QCCID 配置PDN 和 APN 否 AT+QNBIOTEVENT AT+CEREG=5 AT+CGATT？ AT+CEREG？ 注册成功 重试次数重置为0 +IP: xxx AT+CGPADDR? IP URC上报 重试3次 数据传输失败 配置 PSM 和 eDRX 否 传输数据 数据传输成功 Idle PSM 深休眠 （Deep Sleep） 配置波特率 AT+IPR= 是 AT+CPSMS AT+CEDRXS TAU已完成 +CEREG: xxx 图 1：推荐的终端应用设计逻辑（功耗敏感型业务） 上海移远通信技术股份有限公司 8 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2.1.2. 流程描述 表 1：推荐的终端应用设计流程描述（功耗敏感型业务） 序号 概要介绍 1 上电 2 开机 3 AT+IPR? 4 AT+CPIN? AT+CIMI 5 AT+QCCID 6 AT+QCGDEFCONT AT+QNBIOTEVENT 7 AT+CEREG=5 AT+CGATT? 8 AT+CEREG? 9 AT+CGPADDR? 10 +IP: xxx 11 AT+CPSMS 12 AT+CEDRXS 13 AT+CFUN=0 14 AT+QCSEARFCN 15 AT+QRST=1 16 关机 描述 给模块供电。 拉低 PWRKEY 引脚至少 500 毫秒以打开模块。 模块默认处于自适应波特率模式。 模块上电后，MCU 必须连续发送 AT 命令以便和模块进行波特率同 步，直至返回 OK。同步成功后，MCU 可以发送 AT+IPR= 配 置后续通信的波特率。 建议执行 AT+IPR= 设置波特率之前，先查询当前波特率设置。 检查当前 USIM 状态。 查询 USIM 卡的 IMSI 和 ICCID。 配置默认 PDN 连接（=1）的 APN 和 PDN 类型。 该命令在模块重启后生效。 为 PSM 事件和 EPS 注网状态启用 URC 上报。 查询当前 PS 附着状态和 EPS 注网状态。 查询网络分配的 IP 地址。 当 PDP 场景成功与指定的 PDN 连接时，将上报此 URC。 该 URC 上报之前，MCU 无法执行任何数据传输。 设置请求扩展周期 TAU 值（T3412）和激活时间值（T3324）。 可通过 AT+CEREG? 验证网络提供的值。 设置请求的 eDRX 周期。 可通过 AT+CEDRXRDP 验证网络提供的值。 当模块长时间（> 300 秒）无法注网时，执行该命令将模块设置为最 少功能模式。 清除模块已存储的 EARFCN 列表。 重启模块。 模块关机。 上海移远通信技术股份有限公司 9 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2.2. 非功耗敏感型业务场景 对于非功耗敏感型业务的应用场景，建议关闭 PSM 和 eDRX 以降低延迟。 2.2.1. 推荐设计 断电 无IP URC上报 AT+QRST=1 ＜3次， 次数 + 1 3次 重启次数 未准备好 上电 开机 AT+IPR？ 是 AT+CPIN? 已准备就绪 AT+CIMI AT+QCCID 配置波特率 AT+IPR= AT+QCGDEF 是 CONT 配置PDN和APN AT+QCSEARFCN 否 AT+QNBIOTEVENT AT+CEREG=5 AT+CFUN=0 重试3次 数据传输失败 300秒超时 未注册成功 AT+CGATT？ AT+CEREG？ 注册成功 重试次数重置为0 +IP: xxx AT+CGPADDR? IP URC上报 配置 PSM 和 eDRX 否 传输数据 数据传输完成 Idle 是 AT+CPSMS=0 AT+CEDRXS=0 完成TAU +CEREG: xxx 图 2：推荐的终端应用设计逻辑（非功耗敏感型业务） 上海移远通信技术股份有限公司 10 / 13 BC26&BC20&BC030x 系列终端应用设计指导 2.2.2. 流程描述 表 2：推荐的终端应用设计流程描述（功耗非敏感型业务） 序号 概要介绍 1 上电 2 开机 3 AT+IPR？ 4 AT+CPIN? AT+CIMI 5 AT+QCCID 6 AT+QCGDEFCONT AT+CGATT? 7 AT+CEREG? AT+QNBIOTEVENT 8 AT+CEREG=5 9 AT+CGPADDR? 10 +IP: xxx 11 AT+CPSMS=0 12 AT+CEDRXS=0 13 AT+CFUN=0 14 AT+QCSEARFCN 15 AT+QRST=1 16 关机 描述 给模块供电 拉低 PWRKEY 引脚至少 500 毫秒以打开模块。 模块默认处于自适应波特率模式。 模块上电后，MCU 必须连续发送 AT 命令以便和模块进行波特率同 步，直至返回 OK。同步成功后，MCU 可以发送 AT+IPR= 配 置后续通信的波特率。 建议执行 AT+IPR= 设置波特率之前，先查询当前波特率设置。 检查当前 USIM 状态。 查询 USIM 卡的 IMSI 和 ICCID。 配置默认 PDN 连接（=1）时的 APN 和 PDN 类型。 该命令在模块重启后生效。 查询当前 PS 附着状态和 EPS 注网状态。 建议在执行这两个命令之前等待 300 秒，以检查注网状态。 为 PSM 事件和 EPS 注网状态启用 URC 上报。 查询网络分配的 IP 地址。 当 PDP 场景成功与指定的 PDN 连接时，将上报此 URC。 该 URC 上报之前，MCU 无法执行任何数据传输。 禁用 PSM。 禁用 eDRX。 当模块长时间（> 300 秒）无法注网时，执行该命令将模块设置为最 少功能模式。 清除模块已存储的 EARFCN 列表。 重启模块。 模块关机。 上海移远通信技术股份有限公司 11 / 13 BC26&BC20&BC030x 系列终端应用设计指导 3 附录 A 参考文档和术语缩写 表 3：参考文档 序号 文档名称 备注 [1] Quectel_BC26&BC20&BC030x 系列_AT 命令 手册 BC26、BC20、BC030x 系列模块的 AT 命令手册 [2] Quectel_BC26_搜网机制说明 BC26 模块的网络搜索机制说明 表 4：术语缩写 术语 英文全称 APN Access Point Name EARFCN E-UTRA Absolute Radio Frequency Channel Number E-UTRA Evolved Universal Terrestrial Radio Access eDRX extended Discontinuous Reception EPS Evolved Packet System ICCID Integrated Circuit Card Identity IMSI International Mobile Subscriber Identity IP Internet Protocol MCU Microprogrammed Control Unit NB-IoT Narrowband Internet of Things PDN Public Data Network PDP Packet Data Protocol PS Packet Switch 中文全称 接入点名称 E-UTRA 绝对射频信道号 演进的通用陆基无线 扩展非连续接收 演进型分组系统 集成电路卡识别码 国际移动用户识别码 互联网协议 微程序控制器 窄带物联网 公用数据网 分组数据协议 分组交换 上海移远通信技术股份有限公司 12 / 13 BC26&BC20&BC030x 系列终端应用设计指导 PSM URC USIM Power Saving Mode Unsolicited Result Code Universal Subscriber Identity Module 省电模式 非请求结果码 通用用户身份识别模块 上海移远通信技术股份有限公司 13 / 13

BC35-G&BC28&BC95 R2.0 ID2 应用指导 NB-IoT 模块系列 版本：BC35-G&BC28&BC95 R2.0_ID2_应用指导_V1.0 日期：2020-03-21 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0 ID2 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 文档历史 修订记录 版本 1.0 日期 2020-03-21 作者 唐正/王成钧 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 2 ID2 AT 命令............................................................................................................................................. 6 2.1. AT 命令说明 ................................................................................................................................ 6 2.1.1. 定义 .................................................................................................................................. 6 2.1.2. 语句 .................................................................................................................................. 6 2.1.3. 响应 .................................................................................................................................. 6 2.2. AT+QID2CREATE 初始化 ID2 客户端 ...................................................................................... 7 2.3. AT+QID2VER 查询 ID2 客户端版本号 ........................................................................................ 8 2.4. AT+QID2GETID 获取 ID2 的 ID ................................................................................................ 8 2.5. AT+QID2DELETE ID2 去初始化 ............................................................................................... 9 2.6. AT+QID2GETAC 获取设备认证码 ......................................................................................... 10 2.7. AT+QID2DECRYPT ID2 解密 ................................................................................................. 11 2.8. AT+QID2GETDC 获取设备挑战字 ......................................................................................... 11 2.9. AT+QID2VERIFY* 验证服务器认证码.................................................................................... 12 2.10. AT+QID2GETS 获取密钥 ....................................................................................................... 13 3 错误码 .................................................................................................................................................. 15 4 附录 A 术语缩写 .................................................................................................................................. 17 上海移远通信技术股份有限公司 3 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 表格索引 表 1：AT 命令格式............................................................................................................................................... 6 表 2：通用错误码（27.007） ............................................................................................................................ 15 表 3：ID2 错误码 ................................................................................................................................................ 15 表 4：术语缩写 .................................................................................................................................................. 17 上海移远通信技术股份有限公司 4 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 1 引言 本文档主要描述了阿里云物联网设备身份认证 – Link ID2（Internet Device ID）功能应用相关的 AT 命 令。阿里云 Link ID2 是一种物联网设备的可信身份标识，具备不可篡改、不可伪造、全球唯一的安全属性， 是实现万物互联、服务流转的关键基础设施。集成 ID2 功能的安全模块中已经烧录了 ID2 数据，支持获取设 备认证码、设备挑战字和密钥，及解密等设备端 ID2 服务。ID2 功能详细应用方法请参考阿里云官网帮助文 档，可在 https://help.aliyun.com/ 搜索获取。 本文档主要适用于如下移远通信 NB-IoT 模块： ⚫ BC35-G ⚫ BC28 ⚫ BC95 R2.0 备注 本文档仅适用于固件版本号后缀为'_ID2'的 BC35-G、BC28 和 BC95 R2.0 模块。 上海移远通信技术股份有限公司 5 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 2 ID2 AT 命令 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. 语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令格式 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令或内部程序可支持的参数取值列表或范围。 AT+? 返回相应设置命令的当前参数设置值。 AT+=[, 设置用户可自定义的参数值。 [,[...]]] AT+ 主动执行内部程序实现的功能集。 2.1.3. 响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或 +CME ERROR: ，表示已经准备 好接收新命令。在返回最终的 OK，ERROR 或 +CME ERROR: 之前，会发送请求的响应消息。 上海移远通信技术股份有限公司 6 / 17 以下是响应消息的格式： +CMD1: OK 或者 OK 备注 相关 错误码信息，请查阅第 3 章。 BC35-G&BC28&BC95 R2.0 ID2 应用指导 2.2. AT+QID2CREATE 初始化 ID2 客户端 该命令用于初始化 ID2 客户端 SDK。使用 ID2 设备端的其他 AT 命令之前，必须发送该命令进行初始化 操作，且不允许重复初始化。 AT+QID2CREATE 初始化 ID2 客户端 执行命令 AT+QID2CREATE 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 举例 AT+QID2CREATE OK 上海移远通信技术股份有限公司 7 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 2.3. AT+QID2VER 查询 ID2 客户端版本号 该命令用于查询 ID2 客户端版本号。 AT+QID2VER 查询 ID2 客户端版本号 查询命令 AT+QID2VER? 响应 +QID2VER: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 16 进制字符串类型。ID2 客户端版本号。 举例 AT+QID2VER? +QID2VER: 0x00020000 OK 2.4. AT+QID2GETID 获取 ID2 的 ID 该命令用于获取 ID2 的 ID 字符串。 AT+QID2GETID 获取 ID2 的 ID 查询命令 AT+QID2GETID? 响应 +QID2GETID: OK 上海移远通信技术股份有限公司 8 / 17 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 ID2 应用指导 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 字符串类型。模块 ID2 的 ID。长度为 24 字节。 举例 AT+QID2GETID? +QID2GETID: '005F2FB5DAEB026449C8E700' OK 2.5. AT+QID2DELETE ID2 去初始化 AT+QID2DELETE ID2 去初始化 执行命令 AT+QID2DELETE 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 举例 AT+QID2DELETE OK 上海移远通信技术股份有限公司 9 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 2.6. AT+QID2GETAC 获取设备认证码 该命令基于时间戳模式或随机数模式生成设备端认证码，可以有选择性的携带额外数据（）， 携带的额外数据参与设备认证码的签名运算。时间戳可以由设备端 RTC 生成，或者由服务器端发送给设备 端。 AT+QID2GETAC 获取设备认证码 设置命令 AT+QID2GETAC=,,[,,] 响应 +QID2GETTAC: , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。认证模式。 0 随机数模式 1 时间戳模式 整型。=0 时为随机数的长度；=1 时为当前系统时间 字符串长度，最大 32 字节。 字符串类型。=0 时为随机数；当=1 时为当前系统时 间戳（从 1970 年 1 月 1 日 0 时 0 分 0 秒至当前系统时间经过的毫秒数），例 如 '1500954672653'。 整型。额外数据长度，最大长度 512 字节。 字符串类型。额外数据。由 Device 和 SP Server 根据某种约定分别生成。 整型。设备认证码字符串长度。 字符串类型。设备认证码。 举例 AT+QID2GETAC=0,13,'1500954672653',6,'abcd12' +QID2GETAC: 99,'2~2~043C7AD38B0C4216~1500954672653~C6V3Qe0ewfGPA1T1Fp2FSAK9c0A Uj8kNRSAdKl9sLwdK8ofioM4nKOW9XEPban89' OK 上海移远通信技术股份有限公司 10 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 2.7. AT+QID2DECRYPT ID2 解密 该命令使用 ID2 解密指定的数据。 AT+QID2DECRYPT ID2 解密 设置命令 AT+QID2DECRYPT=, 响应 +QID2DECRYPT: , OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。待解密的数据长度。最大值：512。单位：字节。 16 进制字符串类型。待解密的数据。 整型。解密后的数据长度。 字符串类型。解密后的数据。 举例 AT+QID2DECRYPT=16,6d6b06877f7d1274b715cd305ebbc2dc +QID2DECRYPT: 10,'1234567890' OK 2.8. AT+QID2GETDC 获取设备挑战字 该命令用于获取设备挑战字。 AT+QID2GETDC 获取设备挑战字 执行命令 AT+QID2GETDC 响应 +QID2GETDC: , 上海移远通信技术股份有限公司 11 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。设备挑战字长度。 字符串类型。设备挑战字 举例 AT+QID2GETDC +QID2GETDC: 16,'043C7AD38B0C4216' OK 2.9. AT+QID2VERIFY* 验证服务器认证码 该命令用于验证来自 ID2 服务器的认证码。 AT+QID2VERIFY* 验证服务器认证码 设置命令 AT+QID2VERIFY=,,,,, 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 / 上海移远通信技术股份有限公司 12 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 参数 整型。服务器认证码长度。最小值：256。单位：字节。 字符串类型。服务器认证码。长度不小于 256 字节。 整型。服务器挑战字长度。 字符串类型。服务器挑战字。 整型。服务器的额外数据长度。最大值：512。单位：字节。 字符串类型。服务器的额外数据。 备注 '*'表示该功能正在开发中。 2.10. AT+QID2GETS 获取密钥 该命令用于获取密钥。 AT+QID2GETS 获取密钥 执行命令 AT+QID2GETS=, 响应 +QID2GETS: , OK 最大响应时间 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 特性说明 / 参数 整型。随机数种子长度。最大值：128。单位：字节。 字符串类型。随机数种子。 整型。密钥长度。最大值：64。单位：字节。 字符串类型。密钥。 上海移远通信技术股份有限公司 13 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 举例 AT+QID2GETS=36,'0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ' +QID2GETS: 32,AFAF10F950FAC0E11803D892BE3C12979C47834EED2A80325550550417AFBD04 OK 上海移远通信技术股份有限公司 14 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 3 错误码 本章节介绍与 ID2 相关功能的 错误码。 表 2：通用错误码（27.007） 3 4 5 23 30 50 51 52 100 描述 说明 Operation not allowed 操作不被允许 Operation not supported 不支持该操作 Need to enter PIN 需要输入 PIN Memory failure 内存故障 No network service 无网络服务 Incorrect parameters 参数不正确 Command implemented but currently disabled 命令禁用 Command aborted by user 命令被用户中止 Unknown 未知错误 表 3：ID2 错误码 707 708 709 710 711 描述 ID2 general error Bad parameter Short buffer Data excessed Out of memory 说明 ID2 操作错误 参数错误 缓存不足错误 数据超出错误 内存溢出错误 上海移远通信技术股份有限公司 15 / 17 712 Communication error 713 Not support 714 Not implemented 715 Timeout 716 Item not found 717 ID2 Client uninitialized 718 ID2 Client initialized BC35-G&BC28&BC95 R2.0 ID2 应用指导 通信错误 操作不支持 未实现 超时 项目缺失 ID2 客户端未初始化 ID2 客户端已初始化 上海移远通信技术股份有限公司 16 / 17 BC35-G&BC28&BC95 R2.0 ID2 应用指导 4 附录 A 术语缩写 表 4：术语缩写 缩写 ID ID2 RTC SDK SP 英文全称 Identifier Internet Device ID Real-time Clock Software Development Kit Service Provider 中文全称 标识符 设备身份认证 实时时钟 软件开发工具包 服务提供商 上海移远通信技术股份有限公司 17 / 17

BC25&BC32 运营商自注册使用说明 NB-IoT 模块系列 版本：BC25&BC32_运营商自注册使用说明_V1.0 日期：2020-02-24 状态：受控文件 www.quectel.com BC25&BC32 运营商自注册使用说明 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 24 BC25&BC32 运营商自注册使用说明 文档历史 修订记录 版本 1.0 日期 2020-02-24 作者 张鑫/ 顾根全 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 24 BC25&BC32 运营商自注册使用说明 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 模块型号配置.............................................................................................................................. 6 2 运营商自注册机制 ................................................................................................................................. 7 2.1. 电信自注册 ................................................................................................................................. 7 2.1.1. 自注册启动 ...................................................................................................................... 7 2.1.2. 自注册成功 ...................................................................................................................... 7 2.1.3. 自注册失败 ...................................................................................................................... 7 2.1.4. 自注册影响 ...................................................................................................................... 8 2.2. 联通自注册 ................................................................................................................................. 8 2.2.1. 自注册启动 ...................................................................................................................... 8 2.2.2. 自注册成功 ...................................................................................................................... 9 2.2.3. 自注册失败 ...................................................................................................................... 9 2.2.4. 自注册影响 ...................................................................................................................... 9 2.3. 移动 DM 自注册........................................................................................................................ 10 2.3.1. 自注册启动 .................................................................................................................... 10 2.3.2. 自注册成功 .................................................................................................................... 10 2.3.3. 自注册失败 .................................................................................................................... 10 2.3.4. 自注册影响 .................................................................................................................... 10 3 相关 AT 命令 ....................................................................................................................................... 11 3.1. AT+QSELFREGISTER 启用/禁用运营商自注册功能 .............................................................11 3.2. 中国移动自注册功能配置指令 .................................................................................................. 12 3.2.1. AT+QDMPCFG CMDMP 接入配置............................................................................. 12 3.2.2. AT+QDMPCFGEX 扩展 CMDMP 接入配置 ............................................................... 16 4 错误码 ................................................................................................................................................. 21 5 附录 A 参考文档及术语缩写............................................................................................................... 23 上海移远通信技术股份有限公司 3 / 24 BC25&BC32 运营商自注册使用说明 表格索引 表 1：模块型号配置情况 .............................................................................................................................. 6 表 2：错误代码列表（27.007） ................................................................................................................. 21 表 3：错误代码列表（27.005） ................................................................................................................. 21 表 4：参考文档 ........................................................................................................................................... 23 表 5：术语缩写 ........................................................................................................................................... 23 上海移远通信技术股份有限公司 4 / 24 BC25&BC32 运营商自注册使用说明 图片索引 图 1：电信自注册流程 .................................................................................................................................. 8 图 2：联通自注册流程 .................................................................................................................................. 9 图 3：移动 DM 自注册流程......................................................................................................................... 10 上海移远通信技术股份有限公司 5 / 24 BC25&BC32 运营商自注册使用说明 1 引言 遵照运营商入库测试的需求，移远通信 BC25 模块集成了国内三大运营商（中国电信、中国联通和中 国移动）的自注册功能，BC32 模块集成了中国移动的自注册功能，从而实现了对终端设备更方便以及更有 效的管理。本文档主要介绍中国移动、中国电信和中国联通的自注册功能，以及与自注册相关 AT 命令的使 用方法。 1.1. 模块型号配置 表 1：模块型号配置情况 型号 支持的运营商自注册 BC25 移动、电信、联通 BC25-B5 BC25-B8 BC32 BC32-B8 电信 移动 移动 移动 说明 BC25PAR01A04 及之前软件版本默认打开； BC25PAR01A04 之后软件版本默认关闭。 BC25PAR01A03_BT 及之前软件版本默认打开； BC25PAR01A03_BT 之后软件版本默认关闭。 BC25B5PAR01A04 及之前软件版本默认打开； BC25B5PAR01A04 之后软件版本默认关闭。 BC25B8PAR01A05 及之前软件版本默认打开； BC25B8PAR01A05 之后软件版本默认关闭。 BC32RAR01A03 及之前软件版本默认打开； BC32RAR01A03 之后软件版本默认关闭。 BC32B8RAR01A03 及之前软件版本默认打开； BC32B8RAR01A03 之后软件版本默认关闭。 上海移远通信技术股份有限公司 6 / 24 BC25&BC32 运营商自注册使用说明 2 运营商自注册机制 2.1. 电信自注册 2.1.1. 自注册启动 模块开机入网，识别为电信的运营商后，检测模块版本号是否变更或者机卡匹配关系是否发生变化， 如果符合触发条件，模块将启动自注册流程，向运营商自注册服务器发送注册数据包。 2.1.2. 自注册成功 若自注册成功，流程结束，无需周期性更新。 2.1.3. 自注册失败 ⚫ 若自注册时发送一次注册数据包失败，将重发一次注册数据包，最多重发 4 次。重发时间间隔分 别为 3 秒、6 秒、12 秒和 24 秒，即本次注册最多发送 5 次注册数据包； ⚫ 若 5 次注册数据包均发送失败，则会进行 2 轮重试，重试间隔为 1 小时（每轮重试最多会发送 5 次注册数据包）； ⚫ 若 2 轮重试后注册均失败，则下次开机才会再次触发自注册。 上海移远通信技术股份有限公司 7 / 24 电信自注册流程如下图所示。 BC25&BC32 运营商自注册使用说明 设备 开机入 网 间隔1小时 失败 重发4次 否 成功 版本 号或 机卡 匹配变 更 否 是 重试 次数 小于2次 否 是 启动 自注册 自注 册成功 是 流程 结束 图 1：电信自注册流程 2.1.4. 自注册影响 ⚫ 若自注册功能已开启，模块开机入网后会按照要求主动向运营商自注册平台发起注册； ⚫ 若模块使用 PSM 功能，自注册失败后，模块在下次重试时将退出 PSM 状态； ⚫ 自注册服务器地址采用域名模式，若域名解析失败，可能导致模块自注册失败并进行重试。 2.2. 联通自注册 2.2.1. 自注册启动 模块开机入网，识别为联通的运营商后，检测模块版本号是否变更或者机卡匹配关系是否发生变化， 如果符合触发条件，模块将启动自注册流程，向运营商自注册服务器发送注册数据包。 上海移远通信技术股份有限公司 8 / 24 BC25&BC32 运营商自注册使用说明 2.2.2. 自注册成功 若自注册成功，则需每隔 30 天周期性地执行一次更新操作。 2.2.3. 自注册失败 ⚫ 若自注册时发送一次注册数据包失败，将重发一次注册数据包，最多重发 4 次。重发间隔分别为 3 秒、6 秒、12 秒和 24 秒，即本次注册最多发送 5 次注册数据包； ⚫ 若 5 次注册数据包均发送失败，则会进行 2 轮重试，重试间隔为 1 小时（每轮重试最多会发送 5 次注册数据包）； ⚫ 若 2 轮重试后注册均失败，则下次开机才会再触发自注册。 联通自注册流程如下图所示。 设备 开机入 网 间隔1小时 失败 版本 号或 机卡 匹配变 更 否 是 重试 次数 小于2次 否 是 启动 自注册 结束 重发4次 成功 否 自注 册成功 是 3 0天周 期性更 新 图 2：联通自注册流程 2.2.4. 自注册影响 ⚫ 若打开自注册功能，模块开机入网后会按照要求主动向运营商自注册平台发起注册；自注册成功 后会周期性地进行更新。 ⚫ 若模块使用 PSM 功能，自注册失败后，模块在下次重试时将退出 PSM 状态。 上海移远通信技术股份有限公司 9 / 24 BC25&BC32 运营商自注册使用说明 2.3. 移动 DM 自注册 2.3.1. 自注册启动 模块每次开机入网后都会向 DM 服务器发送注册数据包。 2.3.2. 自注册成功 若 DM 注册成功，则默认每 24 小时周期性地执行一次更新操作（如果到达更新周期时模块处于深睡眠 状态，模块不会发起更新）。 2.3.3. 自注册失败 ⚫ 若 DM 注册时发送一次注册数据包失败，将重发一次注册数据包，最多重发 4 次，即最多发送 5 次注册数据包，重发时间间隔依次默认为 2 秒、4 秒、8 秒和 16 秒，总超时时间 30 秒； ⚫ 若 5 次注册均失败，则在下次开机入网时才会再触发自注册。 移动 DM 自注册流程如下图所示。 设备 开机入 网 启动 自注册 否 自注 册成功 是 重发4次 成功 失败 流程 结束 2 4H周期 性更新 图 3：移动 DM 自注册流程 2.3.4. 自注册影响 若打开自注册，模块开机入网后会按照要求主动向运营商自注册平台发起注册；自注册成功后会周期 性地进行更新操作。 上海移远通信技术股份有限公司 10 / 24 BC25&BC32 运营商自注册使用说明 3 相关 AT 命令 本章主要描述如何使用 AT 命令控制运营商自注册功能。关于是否需要开启运营商自注册功能，请联系 对应的运营商进行确认。 3.1. AT+QSELFREGISTER 启用/禁用运营商自注册功能 该命令用于启用/禁用运营商自注册功能，适用于中国移动、中国电信和中国联通。 AT+QSELFREGISTER 启用/禁用运营商自注册功能 查询命令 AT+QSELFREGISTER? 响应 +QSELFREGISTER: 设置命令 AT+QSELFREGISTER= OK 响应 OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 重启后生效，参数配置自动保存至 NVRAM 参数 整型。启用或禁用自注册功能。 0 禁用自注册功能 1 启用自注册功能 举例 AT+QSELFREGISTER? +QSELFREGISTER: 0 //查询自注册开关状态 //自注册功能处于禁用状态 上海移远通信技术股份有限公司 11 / 24 OK AT+QSELFREGISTER=1 OK //启用自注册功能 BC25&BC32 运营商自注册使用说明 3.2. 中国移动自注册功能配置指令 3.2.1. AT+QDMPCFG CMDMP 接入配置 该命令用于配置和查询 CMDMP 接入信息。 查询命令用于查询 BC25 与 BC32 模块当前使用的参数，这些参数可能与保存的配置信息不同。 设置命令用于保存或擦除配置信息。 相关 错误码请参考第 4 章。 AT+QDMPCFG CMDMP 接入配置 测试命令 AT+QDMPCFG=? 响应 +QDMPCFG: [,[,[,[,]]]] 查询命令 AT+QDMPCFG? OK 响应 +QDMPCFG: 0, [+QDMPCFG: 1,,, +QDMPCFG: 2,,,,] 设置命令 AT+QDMPCFG=[,[,[,[,]]]] OK 响应 若 为 0、1、2 或 5 且命令执行成功时： OK 若 为 4， 为 0 且命令执行成功时： +QDMPCFG: 0, OK 若 为 4， 为 1 且命令执行成功时： 上海移远通信技术股份有限公司 12 / 24 最大响应时间 特性说明 参数 BC25&BC32 运营商自注册使用说明 +QDMPCFG: 1,,, OK 若 为 4， 为 2 且命令执行成功时： +QDMPCFG: 2,,,, OK 若 为 6 且命令执行成功时： +QDMPCFG: 6, OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 重启后生效，参数配置自动保存至 NVRAM 整型。配置类型。 0 配置 CMDMP 接入状态 1 配置 CMDMP 服务器地址、端口和更新周期 2 配置 CMDMP 应用密钥，私钥，接口类型和终端 IMEI 3 预留 4 查询 NVRAM 中保存的配置信息 5 擦除 NVRAM 中保存的配置信息 6 查询 CMDMP 接入状态 不同的 值对应不同参数的配置，具体如下： 0 - - - 1 - 2 3 预留 4 - - - 5 - - - 6 - - - - 上海移远通信技术股份有限公司 13 / 24 BC25&BC32 运营商自注册使用说明 整型。CMDMP 接入模式。 0 禁用接入 CMDMP 1 启用接入 CMDMP 字符串类型。CMDMP 服务器 IP 地址。默认服务器 IP 为 117.161.2.41。 整型。CMDMP 服务器端口。范围：1000-65535。默认服务器端口为 5683。 整型。更新周期。范围：300-4294966。单位：秒。默认更新周期为 86400 秒。 字符串类型。应用密钥。设置命令中，需用双引号标记，例如 'appkey'。 字符串类型。私钥。设置命令中，需用双引号标记，例如 'password'。查询命令 中，私钥仅显示前四位字符，例如 'pass****'。 整型。终端类型。 0 接口 1 Linux 2 Android 字符串类型。终端设备 IMEI。长度应为 15-17 字节。 整型。已保存配置信息的查询选项。 0 查询已保存的 CMDMP 接入模式 1 查询已保存的 CMDMP 服务器 IP 地址、端口及更新周期 2 查询已保存的应用密钥、私钥、接口类型和终端 IMEI 3 预留 整型。已保存配置信息的擦除选项。 0 擦除已保存的 CMDMP 接入模式 1 擦除已保存的 CMDMP 服务器 IP 地址、端口及更新周期 2 擦除已保存的应用密钥、私钥、接口类型和终端 IMEI 3 预留 4 擦除以上保存的所有信息 整型。CMDMP 接入状态。 0 DMP_INITIAL_STATE（初始化） 4 DMP_CONNECT_SUCCESS（连接成功） 5 DMP_CONNECT_FAILED（连接失败） 6 DMP_REG_SUCCESS（注册成功） 7 DMP_REG_FAILED（注册失败） 8 DMP_REG_TIMEOUT（注册超时） 9 DMP_LIFETIME_TIMEOUT（生命周期已超时） 11 DMP_UPDATE_SUCCESS（更新成功） 12 DMP_UPDATE_FAILED（更新失败） 13 DMP_UPDATE_TIMEOUT（更新超时） 举例 AT+QDMPCFG? //查询模块当前使用的配置信息。 +QDMPCFG: 0,1 +QDMPCFG: 1,117.161.2.41,5683,420 +QDMPCFG: 2,M100000089,95Go****,1,863703030822519 上海移远通信技术股份有限公司 14 / 24 BC25&BC32 运营商自注册使用说明 OK AT+QDMPCFG=0,0 OK //禁用接入 CMDMP。 AT+QDMPCFG=4,0 +QDMPCFG: 0,0 //查询已保存的 CMDMP 接入模式。 OK AT+QDMPCFG=1,117.161.2.7,5683,420 OK //设置 CMDMP 的服务器 IP 地址、端口及更新周期。 AT+QDMPCFG=4,1 +QDMPCFG: 1,117.161.2.7,5683,420 //查询已保存的 CMDMP 的服务器 IP 地址、端口及更新 周期。 OK //设置应用密钥、私钥、接口类型和终端 IMEI。 AT+QDMPCFG=2,'M100000089','77GaaTUi33nUK05ha528888QFbk0Y38M',1,863703030822519 OK AT+QDMPCFG=4,2 //查询已保存的应用密钥、私钥、接口类型和终端 IMEI。 +QDMPCFG: 2,M100000089,77Ga****,1,863703030822519 OK AT+QDMPCFG=5,4 OK //擦除所有已保存的配置信息。 AT+QDMPCFG=6 +QDMPCFG: 6,6 //查询 CMDMP 接入状态。 //注册成功。 OK AT+QDMPCFG=6 +QDMPCFG: 6,11 //查询 CMDMP 接入状态。 //更新成功。 OK 上海移远通信技术股份有限公司 15 / 24 BC25&BC32 运营商自注册使用说明 3.2.2. AT+QDMPCFGEX 扩展 CMDMP 接入配置 该命令用于配置和查询 CMDMP V2.0 所需的 CMDMP 接入扩展配置信息。 设置命令用于保存、读取或擦除配置信息。 相关 错误码请参考第 4 章。 AT+QDMPCFGEX 扩展 CMDMP 接入配置 测试命令 AT+QDMPCFGEX=? 响应 +QDMPCFGEX: ,[,[,[,,]]] 设置命令 AT+QDMPCFGEX=,[,[,[,,]]] OK 响应 若 为 0 或 2，且命令执行成功时： OK 若 为 0、 为 1 且命令执行成功时： +QDMPCFGEX: 0, OK 若 为 1、 为 1 且命令执行成功时： +QDMPCFGEX: 1, OK 若 为 2、 为 1 且命令执行成功时： +QDMPCFGEX: 2,,,, OK 若 为 3、 为 1 且命令执行成功时： +QDMPCFGEX: 3,, OK 若 为 4、 为 1 且命令执行成功时： +QDMPCFGEX: 4,,,, OK 上海移远通信技术股份有限公司 16 / 24 最大响应时间 特性说明 BC25&BC32 运营商自注册使用说明 若 为 5、 为 1 且命令执行成功时： +QDMPCFGEX: 5, OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 重启后生效，参数配置自动保存至 NVRAM 参数 整型。配置类型。 0 终端应用程序信息 1 终端 MAC 地址 2 终端 ROM、RAM、CPU 和操作系统版本信息 3 终端软件版本和名称 4 终端 VoLTE 状态、网络类型、宽带帐号和电话号码 5 终端位置信息 不同的 值对应不同参数的配置，配置时 始终为 0，具体如下： 0 0 - - - 1 0 - - - 2 0 3 0 - - 4 0 5 0 整型。操作模式。 0 配置参数信息至模块 1 读取模块中的信息 2 擦除模块中的信息 <phonenu 字符串类型。终端应用程序信息。设置命令中须用双引号标记，例如 'appInfo'。最大 字符串长度为 255 字节。此参数是应用程序的信息集合，每个程序日志用分号分隔。日 志内容包含应用程序名称、包名称、应用程序使用时间（毫秒）、应用程序打开时间， 并以'|'分隔。如果没有信息，请设置为 'NULL'。 字符串类型。终端的 MAC 地址，设置命令中须用双引号标记，最大长度为 19 字节。如 果没有信息，请设置为 'NULL'。 字符串类型。终端的 ROM 信息，设置命令中须用双引号标记，最大长度为 19 字节。 如果没有信息，请设置为 'NULL'。 字符串类型。终端的 RAM 信息，设置命令中须用双引号标记，最大长度为 19 字节。如 上海移远通信技术股份有限公司 17 / 24 BC25&BC32 运营商自注册使用说明 果没有信息，请设置为 'NULL'。 字符串类型。终端的 CPU 信息，设置命令中须用双引号标记，最大长度为 19 字节。如 果没有信息，请设置为 'NULL'。 字符串类型。终端操作系统版本，设置命令中须用双引号标记，最大长度为 47 字节。 如果没有信息，请设置为 'NULL'。 字符串类型。终端的软件版本，设置命令中须用双引号标记，最大长度为 47 字节。如 果没有信息，请设置为 'NULL'。 字符串类型。终端的软件名称，设置命令中须用双引号标记，最大长度为 47 字节。如 果没有信息，请设置为 'NULL'。 字符串类型。终端的 VoLTE 状态，设置命令中须用双引号标记，最大长度为 7 字节。 如果没有信息，请设置为 'NULL'。 字符串类型。终端的网络类型，设置命令中须用双引号标记，最大长度为 19 字节。如 果没有信息，请设置为 'NULL'。 字符串类型。终端的宽带账号，设置命令中须用双引号标记，最大长度为 47 字节。如 果没有信息，请设置为 'NULL'。 字符串类型。终端的电话号码，设置命令中须用双引号标记，最大长度为 19 字节。如 果没有信息，请设置为 'NULL'。 字符串类型。终端的位置信息，设置命令中须用双引号标记，最大长度为 255 字节。如 果没有信息，请设置为 'NULL'。 举例 AT+QDMPCFGEX=0,0,'Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551 ;Alipay|FW88|22650|5555;Zhihu|FW333|77750|65101' //设置应用程序信息。 OK AT+QDMPCFGEX=0,1 //查询应用程序信息。 +QDMPCFGEX: 0,Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551;Alip ay|FW88|22650|5555;Zhihu|FW333|77750|65101 OK AT+QDMPCFGEX=0,2 OK //擦除应用程序信息。 AT+QDMPCFGEX=1,0,'00-01-6C-06-A6-29' OK //设置 MAC 地址。 AT+QDMPCFGEX=1,1 +QDMPCFGEX: 1,00-01-6C-06-A6-29 //查询 MAC 地址。 OK AT+QDMPCFGEX=1,2 //擦除 MAC 地址。 上海移远通信技术股份有限公司 18 / 24 BC25&BC32 运营商自注册使用说明 OK AT+QDMPCFGEX=2,0,'8192KB','4096KB','RDA8909B','SX RTOS' //设置 ROM、RAM、CPU、 OS 版本信息。 OK AT+QDMPCFGEX=2,1 //查询 ROM、RAM、CPU、OS 版本信息。 +QDMPCFGEX: 2,8192KB,4096KB,RDA8909B,SX RTOS OK AT+QDMPCFGEX=2,2 OK //擦除 ROM、RAM、CPU、OS 版本信息。 AT+QDMPCFGEX=3,0,'BC32B8R01A01','Quectel' OK //设置软件版本和名称。 AT+QDMPCFGEX=3,1 +QDMPCFGEX: 3,BC32B8R01A01,Quectel ///查询软件版本和名称。 OK AT+QDMPCFGEX=3,2 OK //擦除软件版本和名称。 AT+QDMPCFGEX=4,0,'off','NB-IoT','XY05553867549','18009699999' //设置 VoLTE 状态、网络类 型、宽带帐号和电话号码。 OK AT+QDMPCFGEX=4,1 //查询 VoLTE 状态、网络类型、宽带帐号和电号码。 +QDMPCFGEX: 4,off,NB-IoT,XY05553867549,18009699999 OK AT+QDMPCFGEX=4,2 OK //擦除 VoLTE 状态、网络类型、宽带帐号和电话号码。 AT+QDMPCFGEX=5,0,'31.8438799075,117.2025477950,OTDOA' OK //设置位置信息。 AT+QDMPCFGEX=5,1 +QDMPCFGEX: 5,31.8438799075,117.2025477950,OTDOA //查询位置信息。 上海移远通信技术股份有限公司 19 / 24 OK AT+QDMPCFGEX=5,2 OK BC25&BC32 运营商自注册使用说明 //擦除位置信息。 上海移远通信技术股份有限公司 20 / 24 BC25&BC32 运营商自注册使用说明 4 错误码 本章介绍了与 BC25 和 BC32 模块相关的错误码。 下表列出的错误代码符合 3GPP 规范，请参考《3GPP TS 27.007 V13.5.0》的第 9.2 章节了解 错误码相关详细信息。 表 2：错误代码列表（27.007） 3 4 23 30 50 52 53 159 错误代码 Operation not allowed Operation not supported Memory failure No network service Execute fail Option not supported Param invalid Uplink busy/flow control 中文描述 不允许此操作 不支持此操作 内存不足 无网络服务 执行失败 不支持此选项 无效参数 上行忙碌/流控 表 3：错误代码列表（27.005） 300 301 302 303 304 错误代码 ME failure SMS service of ME reserved Operation not allowed Operation not supported Invalid PDU mode parameter 中文描述 ME 失败 预留 ME 的 SMS 服务 不允许此操作 不支持此操作 无效 PDU 模式参数 上海移远通信技术股份有限公司 21 / 24 BC25&BC32 运营商自注册使用说明 305 Invalid text mode parameter 无效文本模式参数 310 USIM not inserted 未插入 USIM 卡 311 USIM PIN required 需要 USIM PIN 312 PH-USIM PIN required 需要 PH-USIM PIN 313 USIM failure USIM 失败 314 USIM busy USIM 忙碌 315 USIM wrong USIM 错误 316 USIM PUK required 需要 USIM PUK 317 USIM PIN2 required 需要 USIM PIN2 318 USIM PUK2 required 需要 USIM PUK2 320 Memory failure 内存不足 321 Invalid memory index 无效内存索引 322 Memory full 内存满 330 SMSC address unknown 未知的 SMSC 地址 331 No network service 无网络服务 332 Network timeout 网络超时 340 No +CNMA acknowledgement 无期望+CNMA 确认消息 expected 500 Unknown error 未知错误 备注 AT+CMEE= 命令禁用（=0）或使能（=1，=2）最终结果码 +CME ERROR: 的 显示。更多详细信息，请参考《Quectel_BC25_AT 命令手册》或《Quectel_BC32_AT 命令手册》。 上海移远通信技术股份有限公司 22 / 24 BC25&BC32 运营商自注册使用说明 5 附录 A 参考文档及术语缩写 表 4：参考文档 编号 文档名称 [1] 3GPP TS 27.007 V13.5.0 [2] Quectel_BC25_AT 命令手册 [3] Quectel_BC32_AT 命令手册 备注 3GPP 技术规范 BC25 模块 AT 命令说明 BC32 模块 AT 命令说明 表 5：术语缩写 缩写 CoAP CMDMP CPU DM IMEI IP LwM2M LPWA MAC MCU ME NB-IoT NVRAM OS 英文全称 Constrained Application Protocol China Mobile Device Management Platform Central Processing Unit Device Management International Mobile Equipment Identity Internet Protocol Lightweight Machine to Machine Low-Power Wide-Area Media Access Control Microcontroller Unit Mobile Equipment Narrow Band Internet of Things Non-Volatile Radom Access Memory Operation System 中文全称 受限应用协议 中国移动设备管理平台 中央处理器 设备管理 国际移动设备识别码 互联网协议 轻量级 M2M（协议） 低功率广域 媒体访问控制 微型控制单元 移动设备 窄带物联网（协议） 非易失性随机存取存储器 操作系统 上海移远通信技术股份有限公司 23 / 24 RAM ROM TE UE URC VoLTE Random Access Memory Read-Only Memory Terminal Equipment (Typically the MCU) User Equipment (Typically the Module) Unsolicited Result Code Voice over Long-Term Evolution BC25&BC32 运营商自注册使用说明 随机存取存储器 只读存储器 终端设备（一般指 MCU） 用户设备（一般指模块） 非请求结果码 长期演进语音 上海移远通信技术股份有限公司 24 / 24

BC26&BC20 MQTT 应用指导 NB-IoT 模块系列 版本：BC26&BC20_MQTT_应用指导_V1.0 日期：2020-01-17 状态：受控文件 www.quectel.com BC26&BC20 MQTT 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 25 BC26&BC20 MQTT 应用指导 文档历史 修订记录 版本 1.0 日期 2020-01-17 作者 顾根全/ 王瑞/ 刘飞彪 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 25 BC26&BC20 MQTT 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 MQTT 数据交互..................................................................................................................................... 6 3 MQTT 相关 AT 命令 .............................................................................................................................. 7 3.1. AT 命令类型................................................................................................................................ 7 3.2. MQTT 相关 AT 命令描述 ............................................................................................................ 8 3.2.1. AT+QMTCFG 配置 MQTT 可选参数............................................................................. 8 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 .................................................................... 12 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 .................................................................. 13 3.2.4. AT+QMTCONN 连接客户端至 MQTT 服务器............................................................. 14 3.2.5. AT+QMTDISC 从 MQTT 服务器断开客户端连接 ....................................................... 15 3.2.6. AT+QMTSUB 订阅主题 .............................................................................................. 16 3.2.7. AT+QMTUNS 退订主题 .............................................................................................. 17 3.2.8. AT+QMTPUB 发布消息 .............................................................................................. 18 4 MQTT 相关 URC ................................................................................................................................. 20 4.1. +QMTSTAT: 指示 MQTT 链路层状态变化的 URC................................................................. 20 4.2. +QMTRECV: 通知 MCU 读取 MQTT 数据包的 URC ............................................................ 21 5 举例 ..................................................................................................................................................... 22 6 附录 A 参考文档 .................................................................................................................................. 25 上海移远通信技术股份有限公司 3 / 25 BC26&BC20 MQTT 应用指导 表格索引 表 1：AT 命令类型及响应............................................................................................................................. 7 表 2：MQTT 相关的 URC........................................................................................................................... 20 表 3：URC 中的错误代码........................................................................................................................... 20 表 4：参考文档 ........................................................................................................................................... 25 表 5：术语及缩写 ....................................................................................................................................... 25 上海移远通信技术股份有限公司 4 / 25 BC26&BC20 MQTT 应用指导 1 引言 MQTT 是基于发布/订阅范式的消息协议，具有开放、简单、轻量级且易于实施等特点。MQTT 最大优 势在于，可以以极少的代码和有限的网络带宽，为远程设备连接提供实时可靠的消息服务。 本文档介绍如何通过 AT 命令应用移远 BC26 和 BC20 模块的 MQTT 功能。 上海移远通信技术股份有限公司 5 / 25 BC26&BC20 MQTT 应用指导 2 MQTT 数据交互 本章节介绍了用于实现 MQTT 功能的数据交互机制，具体如下图所示： MCU 模块 链路层 MQTT服务器 数据上报类型 (非URC): +QMT***: ,,… 更多信息请参考第 3章。 AT+QMTCFG='KEEPALIVE',... AT+QMTCFG='TIMEOUT',... … AT+QMTOPEN=... OK TCP-REQ +QMTOPEN: , AT+QMTCONN AT+QMTCONN=... OK +QMTCONN: ,[,] TCP established CONN-REQ Start timer T1, T2 CONN ACK-IND Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK 发送连接数据包 服务器收到连接数据包并返回ACK AT+QMTSUB AT+QMTSUB=... OK SUB-REQ () Start timer T1 +QMTSUB: SUB ACK-IND () ,,[,] Stop T1 or handle Excep2 AT+QMTUNS AT+QMTUNS=... OK +QMTUNS: ,, UNS-REQ () Start timer T1 UNS ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB=tcpidx,topic,qos=0... OK PUB-REQ AT+QMTPUB (=1) AT+QMTPUB=... OK PUB-REQ () Start timer T1 +QMTPUB: PUB ACK-IND () ,,[,] Stop T1 or handle Excep2 AT+QMTPUB (=2) AT+QMTPUB=... OK PUB-REQ () Start timer T1 PUB REC-IND ) Stop T1 or handle Excep2 PUB REL-REQ () Start timer T1 +QMTPUB: PUB COMP-IND () ,,[,] Stop T1 or handle Excep2 发送订阅数据包 服务器收到订阅数据包并返回ACK 发送退订数据包 服务器收到退订数据包并返回ACK 发送发布数据包 发送发布数据包 服务器收到发布数据包并返回ACK 发送发布数据包 服务器收到发布数据包 发送释放发布数据包 服务器收到释放发布数据包 T1是数据包传输超时 时间. T2 是keep alive定时 器. 在T2超时时间内若没 有数据相关信息传 输，客户端会发送心 跳请求包。 Excep1: 断开TCP连 接 Excep2: 重发数据包，除非 达到允许重发次数 上限； 允许重复次数可通 过命令 AT+QMTCFG来设 置。 命令AT+QMTCFG可以 配置是否上报超时信息。 Receive 收到URC格式的PUBLISH 信息 +QMTRECV: ,,, PUB-IND () PUB ACK/REC-REQ (msgId) Reply according to . . . AT+QMTDISC=... OK +QMTDISC: , AT+QMTCLOSE=... OK +QMTCLOSE: , DISC-REQ TCP-REQ TCP disconnected 服务器收到发布数据包 发送发布答复数据包 发送断开连接数据包 TCP断..开. 请求 图 1：MQTT 数据交互机制 上海移远通信技术股份有限公司 6 / 25 BC26&BC20 MQTT 应用指导 3 MQTT 相关 AT 命令 本章节介绍了与 MQTT 操作相关的 AT 命令。 3.1. AT 命令类型 AT 命令的类型及响应如下表所示： 表 1：AT 命令类型及响应 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 AT 命令相关定义如下：  ：回车符；  ：换行符；  ：参数名称，实际命令行中不包括尖括号< >；添加下划线'_'的参数取值为默认值；  [...]：可选参数，实际命令行中不包括方括号[ ]；若无特别说明，可选参数省略时将采用默认值。 备注 若无特别说明，本文档中的 AT 命令默认立即生效。 上海移远通信技术股份有限公司 7 / 25 BC26&BC20 MQTT 应用指导 3.2. MQTT 相关 AT 命令描述 3.2.1. AT+QMTCFG 配置 MQTT 可选参数 该命令用于配置 MQTT 的可选参数。 AT+QMTCFG 配置 MQTT 可选参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'dataformat',(支持的范围), (支持的列表),(支持的列表) +QMTCFG: 'keepalive',(支持的范围),(支 持的范围) +QMTCFG: 'session',(支持的范围),(支持 的列表) +QMTCFG: 'timeout',(支持的范围),(支持 的范围),(支持的范围),(支持的列表) +QMTCFG: 'will',(支持的范围),(支持的< will_fg>列表),(支持的范围),(支持的 列表),'will_topic','will_msg' +QMTCFG: 'version',(支持的范围),(支持 的列表) +QMTCFG: 'aliauth',(支持的范围),'prod uctkey','devicename','devicesecret' +QMTCFG: 'echomode',(支持的范围), (支持的列表) 设置命令 配置收发数据的格式 AT+QMTCFG='dataformat',[,,] OK 响应 若省略参数和，查询当前收发数 据的格式： +QMTCFG: 'dataformat',, OK 若指定参数和，则配置收发数 据的格式： OK 设置命令 配置保活时间 若出现任何错误： ERROR 响应 若省略参数，则查询当前 keep-alive 时间： 上海移远通信技术股份有限公司 8 / 25 BC26&BC20 MQTT 应用指导 AT+QMTCFG='keepalive',[,] +QMTCFG: 'keepalive', OK 若指定参数，则配置 keep-alive 时间： OK 设置命令 配置会话类型 AT+QMTCFG='session',[,] 若出现任何错误： ERROR 响应 若省略参数，则查询当前会话类型： +QMTCFG: 'session', OK 若指定参数，则配置会话类型： OK 设置命令 配置消息传输超时时间 AT+QMTCFG='timeout',[,,,] 若出现任何错误： ERROR 响应 若省略参数、、，则查询当前配置的消息传输超时时间： +QMTCFG: 'timeout',,, OK 若指定参数、、，则配置消息传输超时时间： OK 设置命令 配置 Will 信息 AT+QMTCFG='will',[,,,,'',''] 若出现任何错误： ERROR 响应 若省略参数、、、''和''，则查询当前配置的 Will 信息： +QMTCFG: 'will',[,,,'< will_topic>',''] OK 若 指 定 参 数 、 、 、 ''和''，则配置 Will 信息： 上海移远通信技术股份有限公司 9 / 25 BC26&BC20 MQTT 应用指导 OK 设置命令 配置待使用 MQTT 协议版本 AT+QMTCFG='version',[,] 若出现任何错误： ERROR 响应 若省略参数，则查询 MQTT 协议版本： +QMTCFG: 'version', OK 若指定参数，则配置 MQTT 协议版本： OK 设置命令 配置阿里云设备信息 AT+QMTCFG='aliauth',[,'','',''] 若出现任何错误： ERROR 响应： 若省略参数''、''和''，则查询设备信息： [+QMTCFG: 'aliauth','','', ''] OK 若指定参数''、''和''，则配置设备信息： OK 若出现任何错误： 设置命令 ERROR 响应 配置在数据模式下是否向 UART 回显输 若省略参数，查询当前数据回显模式： 入的数据 +QMTCFG: 'echomode', AT+QMTCFG='echomode',[,] OK 若指定参数，则配置数据回显模式： OK 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置不保存到 NVRAM，且深休眠唤醒后无效 上海移远通信技术股份有限公司 10 / 25 BC26&BC20 MQTT 应用指导 参数 整型。MQTT Socket 标识符；范围：0-5。 整型。配置 Will Flag。 0 无需配置 Will Flag 1 需要配置 Will Flag 整型。发送消息时的 QoS 级别。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。Will Retain 标记只适用于 PUBLISH 消息。 0 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者 以后，服务器不会保留该消息 1 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者 以后，服务器会保留该消息 字符串类型。主题名称；最大长度：255 字节。 字符串类型。当客户端连接意外断开后，该参数定义需要发布到 Will Topic 的消息 内容；消息长度范围：0-255 字节。 整型。数据包传输超时时间；范围：1-60；默认值：10；单位：秒。 整型。数据包传输超时后重发次数；范围：0-10；默认值：3。 整型。传输数据包时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器必须存储该客户端的订阅消息 1 服务器必须丢弃之前保留的关于客户端的任何消息，并将这个连接视为 'clean' 整型。保活时间；范围：0-3600；默认值：120；单位：秒。该参数定义从客户 端接收到消息之间的最大间隔时间，在保活时间的 1.5 倍时长内，若服务器未从 客户端收到消息，则默认客户端发送了断开连接消息，服务器会断开客户端连接。 0 不断开客户端连接 字符串类型。阿里云发布的产品密钥；最大长度：64 字节。 字符串类型。阿里云发布的设备名称；最大长度：64 字节。 字符串类型。阿里云发布的设备校验凭证；最大长度：64 字节。 整型。MQTT 协议版本。 3 MQTT v3.1 4 MQTT v3.1.1 整型。发送数据的格式。 0 文本格式 1 十六进制格式 整型。接收数据的格式。 0 文本格式 1 十六进制格式 上海移远通信技术股份有限公司 11 / 25 BC26&BC20 MQTT 应用指导 整型。在数据模式下是否向 UART 回显输入数据。 0 不向 UART 回显输入数据 1 向 UART 回显输入数据 备注 1. 只有当服务器支持 clean session 操作时，参数=0 才有效。 2. 请确保数据在传输过程中不能超时。 3. 命令 AT+QMTCFG='aliauth'只用于阿里云；若已配置此命令，则命令 AT+QMTCONN 中的参数 ''和''可以省略。 4. 只有在数据模式传输中，参数才有效。 5. 'will'、'session'、'keepalive'、'aliauth'和'version'的配置需在 AT+QMTOPEN 命令执行前完 成方可生效。 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 该命令用来打开 MQTT 客户端网络。 AT+QMTOPEN 打开 MQTT 客户端网络 测试命令 AT+QMTOPEN=? 响应 +QMTOPEN: (支持的范围),'', 查询命令 AT+QMTOPEN? OK 响应 [+QMTOPEN: ,'',] 设置命令 AT+QMTOPEN=,'< host_name>', OK 响应 OK +QMTOPEN: , 最大响应时间 保存机制 若出现任何错误： ERROR 75 秒，受网络状态影响 / 上海移远通信技术股份有限公司 12 / 25 BC26&BC20 MQTT 应用指导 参数 整型。MQTT Socket 标识符；范围：0-5。 字符串类型。服务器地址，可以是 IP 地址或者域名；最大长度：150 字节。 整型。服务器端口；范围：1-65535。 整型。命令执行结果。 -1 打开网络失败 0 打开网络成功 1 参数错误 2 MQTT 标识符被占用 3 激活 PDP 失败 4 域名解析失败 5 网络断开错误 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 该命令用来关闭 MQTT 客户端网络。 AT+QMTCLOSE 关闭 MQTT 客户端网络 测试命令 AT+QMTCLOSE=? 响应 +QMTCLOSE: (支持的范围) 设置命令 AT+QMTCLOSE= OK 响应 OK +QMTCLOSE: , 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 / 参数 整型。MQTT Socket 标识符，范围：0-5。 整型。命令执行结果。 -1 关闭网络失败 0 关闭网络成功 上海移远通信技术股份有限公司 13 / 25 BC26&BC20 MQTT 应用指导 3.2.4. AT+QMTCONN 连接客户端至 MQTT 服务器 客户端通过该命令请求连接至 MQTT 服务器。当客户端和服务器之间创建了一个 TCP/IP Socket 连接， 必须使用 CONNECT 流创建一个协议层会话。 AT+QMTCONN 连接客户端至 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: (支持的范围),'' [,''[,'']] 查询命令 AT+QMTCONN? OK 响应 [+QMTCONN: ,] 设置命令 AT+QMTCONN=,'< clientID>'[,''[,'']] OK 响应 OK +QMTCONN: ,[,] 最大响应时间 保存机制 若出现任何错误： ERROR （默认 10 秒），取决于网络状态 / 参数 整型。MQTT Socket 标识符；范围：0-5。 字符串类型。客户端标识符；最大长度：128 字节。 字符串类型。客户端用户名，可用于鉴权；最大长度：256 字节。 字符串类型。客户端用户名对应的密码，可用于鉴权；最大长度：256 字节。 整型。命令执行结果。 0 数据包发送成功且从服务器接收到 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 初始化 2 MQTT 正在连接 3 MQTT 已经连接成功 4 MQTT 正在断开连接 整型。连接返回码。 0 接受连接 上海移远通信技术股份有限公司 14 / 25 BC26&BC20 MQTT 应用指导 1 拒绝连接：不支持的协议版本 2 拒绝连接：拒绝标识符 3 拒绝连接：服务器不可用 4 拒绝连接：用户名或密码错误 5 拒绝连接：未授权 整型。数据包传输超时时间，范围：1-60，默认值：10，单位：秒。 备注 具有相同客户端标识符（）的两个客户端连接到同一服务器时，在后建立连接的客户端完成连 接后，将由服务器自动断开与先建立连接的客户端之间的连接。 3.2.5. AT+QMTDISC 从 MQTT 服务器断开客户端连接 客户端可通过该命令请求断开与 MQTT 服务器的连接。客户端发送 DISCONNECT 消息到服务器表示 即将与服务器断开 TCP/IP 连接。 AT+QMTDISC 从 MQTT 服务器断开客户端连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的范围) 设置命令 AT+QMTDISC= OK 响应 OK +QMTDISC: , 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 / 参数 整型。MQTT Socket 标识符；范围：0-5。 整型。命令执行结果。 -1 断开连接失败 0 断开连接成功 上海移远通信技术股份有限公司 15 / 25 BC26&BC20 MQTT 应用指导 3.2.6. AT+QMTSUB 订阅主题 该命令用于订阅一个或多个主题。客户端发送 SUBSCRIBE 消息从而在服务器上注册感兴趣的一个或 多个主题名称。将发布到这些主题的消息作为 PUBLISH 消息从服务器传输到客户端。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: (支持的范围),,'',[,'',...] 设置命令 AT+QMTSUB=,< msgID>,'',[,'',…] OK 响应 OK +QMTSUB: ,,[,] 最大响应时间 保存机制 若出现任何错误： ERROR + ×（默认 40 秒）， 取决于网络状态 / 参数 整型。MQTT Socket 标识符；范围：0-5。 整型。数据包的消息标识符；范围：1-65535。 字符串类型。客户端想要订阅或者退订的主题；最大长度是 255 字节。 整型。客户端打算发布消息的 QoS 等级。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。命令执行结果。 0 数据包发送成功且从服务器接收到 ACK 1 数据包重传 2 数据包发送失败 若为 0，则为已确认 QoS 等级的矢量；参数取值 128 表示服务器拒绝订阅； 若为 1，则表示数据包重传次数； 若为 2，则不显示。 整型。数据包传输超时时间；范围：1-60；默认值：10；单位：秒。 整型。数据包传输超时后的重发次数；范围：0-10；默认值：3。 上海移远通信技术股份有限公司 16 / 25 BC26&BC20 MQTT 应用指导 备注 只有在固定报头中的 QoS 位指示 QoS 等级是 1 或者 2 的消息中才显示参数。在特定通信方向 的一组飞行消息中，必须只有唯一的消息标识符。该参数取值通常按消息排列顺序逐一递增，但非必须逐 一递增。 3.2.7. AT+QMTUNS 退订主题 该命令用来退订一个或者多个主题。客户端向服务器发送 UNSUBSCRIBE 消息退订提及的主题。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: (支持的范围),,''[,''...] 设置命令 AT+QMTUNS=,< msgID>,''[,''…] OK 响应 OK +QMTUNS: ,, 最大响应时间 保存机制 若出现任何错误： ERROR + ×（默认 40 秒）， 取决于网络状态 / 参数 整型。MQTT Socket 标识符；范围：0-5。 整型。数据包的信息标识符；范围：1-65535。 字符串类型。客户端想要订阅或者退订的主题；最大长度是 255 字节。 整型。命令执行结果。 0 数据包发送成功且从服务器接收到 ACK 1 数据包重传 2 数据包发送失败 整型。数据包传输超时时间；范围：1-60；默认值：10；单位：秒。 整型。数据包传输超时后的重发次数；范围：0-10；默认值：3。 上海移远通信技术股份有限公司 17 / 25 BC26&BC20 MQTT 应用指导 3.2.8. AT+QMTPUB 发布消息 客户端通过该命令向服务器发布消息，再由服务器分配到感兴趣的订阅者。每一个 PUBLISH 消息都关 联一个主题名称；若一个客户端订阅了一个或者多个主题，服务器会将发布到这些主题的所有消息作为 PUBLISH 消息发送到客户端。 AT+QMTPUB 发布消息 测试命令 AT+QMTPUB=? 响应 +QMTPUB: (支持的范围),,,,'','' OK 设置命令 响应 AT+QMTPUB=,,,,'' 响应>后，模块进入数据模式，输入需要 发送的数据，按 Ctrl+Z 发送数据，按 Esc 取消发送。 +QMTPUB: ,,[,] 若出现任何错误： 设置命令 ERROR 响应 AT+QMTPUB=,,,,'','' +QMTPUB: ,,[,] 最大响应时间 若有任何有关 ME 功能性的错误： ERROR + × （默认 40 秒），取决于网络状态 参数 整型。MQTT Socket 标识符；范围：0-5。 整型。数据包的消息标识符；范围：0-65535。只有当=0 时，该参数值为 0。 整型。客户端想要发布消息的 QoS 等级。 0 最多发送一次 1 最少发送一次 2 只发送一次 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 消息发送到当前订阅者后，服务器不保存消息。 1 消息发送到当前订阅者后，服务器保存消息。 字符串类型。待发布主题；最大长度为 255 字节。 上海移远通信技术股份有限公司 18 / 25 BC26&BC20 MQTT 应用指导 字符串类型。待发布消息，最大长度为 700 字节，若是在数据模式，最大长度为 1024 字节。 整型。命令执行结果。 0 数据包发送成功且从服务器接收 ACK（当=0 时，发布的消息无需 ACK） 1 数据包重传 2 数据包发送失败 若为 1，则表示数据包重传次数； 若为 0 或者 2，则不显示。 整型。数据包传输超时时间；范围：1-60；默认值：10；单位：秒。 整型。数据包传输超时后的重发次数；范围：0-10；默认值：3。 备注 1. PUBLISH 消息可从发布者发布至服务器，也可从服务器发布至订阅者。当服务器发布消息到订阅者 时，会返回如下 URC 以通知 MCU 读取 MQTT 服务器发来的数据： +QMTRECV: ,,, 更多关于此 URC 描述信息，请参考第 4.2 章。 2. 采用特殊格式字符（如 JSON 字符）时，必须表示为带双引号的字符串。暂不支持特殊命令 字符如分号';'。 上海移远通信技术股份有限公司 19 / 25 BC26&BC20 MQTT 应用指导 4 MQTT 相关 URC 本章节主要描述 MQTT 相关的 URC。 表 2：MQTT 相关的 URC 索引 URC 格式 描述 当 MQTT 链路层状态改变，客 [1] +QMTSTAT: , 户端会断开 MQTT 连接并上 报该 URC。 当客户端接收到从 MQTT 服 务器发送的数据包时，会上报 [2] +QMTRECV: ,,, 该 URC 以通知 MCU 读取 MQTT 数据包。 4.1. +QMTSTAT: 指示 MQTT 链路层状态变化的 URC 该 URC 以+QMTSTAT: 开头；当 MQTT 链路层状态发生变化时，上报该 URC。 +QMTSTAT: 指示 MQTT 链路层状态变化的 URC +QMTSTAT: , 报该 URC。 参数 整型。MQTT Socket 标识符。 整型。错误代码，详细信息请参考下表。 表 3：URC 中的错误代码 码 描述 1 连接被服务器断开或者重置 如何解决 执行命令 AT+QMTOPEN 重建 MQTT 连接 上海移远通信技术股份有限公司 20 / 25 BC26&BC20 MQTT 应用指导 2 3 4 5 6 7 8-255 发送 PINGREQ 包超时或者失败 发送 CONNECT 包超时或者失败 接收 CONNACK 包超时或者失败 客户端向服务器发送 DISCONNECT 包，但是 服务器主动断开 MQTT 连接 因为发送数据包总是失败，客户端主动断开 MQTT 连接 先去激活 PDP，再重新激活 PDP 并重建 MQTT 连接 1. 检查输入的用户名和密码是否正确。 2. 确保客户端标识符（）未被占 用。 3. 重 建 MQTT 连 接 ， 并 尝 试 重 新 发 送 CONNECT 包至服务器。 1. 查看输入的用户名和密码是否正确。 2. 确保客户端 ID 未被占用。 3. 重 建 MQTT 连 接 ， 并 尝 试 再 次 发 送 CONNECT 包到服务器。 正常流程。 1. 请确保数据正确。 2. 由于可能存在网络拥堵或者错误，请尝试 重建 MQTT 连接。 链路不工作或者服务器不可用 请确保当前链路工作或者服务器可用。 预留 4.2. +QMTRECV: 通知 MCU 读取 MQTT 数据包的 URC 该 URC 以+QMTRECV: 开头，用于通知 MCU 读取已从 MQTT 服务器接收到的 MQTT 数据包。 +QMTRECV: 通知 MCU 读取 MQTT 数据包的 URC +QMTRECV: ,,, 参数 整型。MQTT Socket 标识符。 整型。数据包的消息标识符。 字符串类型。从 MQTT 服务器接收的主题。 字符串类型。主题名称相关的负载。 备注 URC 最大长度为 1400 字节。 上海移远通信技术股份有限公司 21 / 25 BC26&BC20 MQTT 应用指导 5 举例 本章节主要通过举例来解释如何使用 MQTT 相关命令。 AT+QMTOPEN=? +QMTOPEN: (0-5),'', OK //打开 MQTT 客户端网络 AT+QMTOPEN=0,'220.180.239.212',8401 OK +QMTOPEN: 0,0 //MQTT 客户端网络成功打开 AT+QMTOPEN? +QMTOPEN: 0,'220.180.239.212',8401 OK AT+QMTCONN=? +QMTCONN: (0-5),''[,''[,'']] OK AT+QMTCONN=0,'clientExample' OK +QMTCONN: 0,0,0 //客户端成功连接至 MQTT 服务器 AT+QMTSUB=? +QMTSUB: (0-5),,'',[,'',...] OK //订阅主题 AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 上海移远通信技术股份有限公司 22 / 25 BC26&BC20 MQTT 应用指导 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //若客户端订阅了一个主题，并且其他设备发布了相同主题的消息到服务器，模块会上报如下 URC： +QMTRECV: 0,0,'topic/example','This is the payload related to topic' //退订主题 AT+QMTUNS=0,2,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB: (0-5),,,,'','' OK //发布消息 AT+QMTPUB=0,0,0,0,'topic/pub','hello MQTT.' OK +QMTPUB: 0,0,0 //若客户端订阅了名为'topic/pub'的主题，并且其他设备发布了相同主题的消息到服务器，模块会上报如 下 URC： +QMTRECV: 0,0,'topic/pub','hello MQTT.' //在数据模式下发布消息 AT+QMTPUB=0,0,0,0,'topic/pub' > This is test data, hello MQTT. OK //模块进入数据模式 //数据输入完成后，按 CTRL+Z 发送消息 +QMTPUB: 0,0,0 //若客户端订阅了名为'topic/pub'的主题，其他设备发布了相同主题的消息到服务器，模块会上报如下 URC： +QMTRECV: 0,0,'topic/pub','This is test data, hello MQTT.' //断开 MQTT 服务器与客户端的连接 AT+QMTDISC=0 OK 上海移远通信技术股份有限公司 23 / 25 +QMTDISC: 0,0 //成功断开连接 BC26&BC20 MQTT 应用指导 上海移远通信技术股份有限公司 24 / 25 BC26&BC20 MQTT 应用指导 6 附录 A 参考文档 表 4：参考文档 序号 [1] [2] 文档名称 MQTT V3.1 Protocol Specification MQTT V3.1.1 Protocol Specification 说明 MQTT 协议 3.1 版本规格说明 MQTT 协议 3.1.1 版本规格说明 表 5：术语及缩写 缩写 ACK ID IP MCU ME MQTT NB-IoT NVRAM PDP QoS RAM SSL TCP URC UART 英文全称 中文全称 Acknowledgement 确认通知 Identifier 标识符 Internet Protocol 互联网协议 Micro Control Unit 微控制单元 Mobile Equipment 移动设备 Message Queuing Telemetry Transport 消息队列遥测传输 Narrowband Internet of Things 窄带物联网 Nonvolatile Random Access Memory 非易失随机读写存储器 Packet Data Protocol 分组数据协议 Quality of Service 服务质量 Random Access Memory 随机存取存储器 Secure Sockets Layer 安全套接层 Transmission Control Protocol 传输控制协议 Unsolicited Result Code 非请求结果码 Universal Asynchronous Receiver/Transmitter 通用异步收/发器 上海移远通信技术股份有限公司 25 / 25

BC26&BC20 CMDMP 接入指导 NB-IoT 模块系列 版本：BC26&BC20_CMDMP_接入指导_V1.0 日期：2019-12-04 状态：受控文件 www.quectel.com BC26&BC20 CMDMP 接入指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 14 BC26&BC20 CMDMP 接入指导 文档历史 修订记录 版本 日期 作者 1.0 2019-12-04 李芝勇/李婷婷 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 14 BC26&BC20 CMDMP 接入指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 1 引言 ....................................................................................................................................................... 4 2 CMDMP 接入相关 AT 命令详解............................................................................................................ 5 2.1. AT 命令类型................................................................................................................................ 5 2.2. AT+QDMPCFG CMDMP 接入配置 ......................................................................................... 5 2.3. AT+QDMPCFGEX CMDMP 接入扩展配置 ............................................................................. 9 3 附录 A 术语缩写 ................................................................................................................................. 14 上海移远通信技术股份有限公司 3 / 14 BC26&BC20 CMDMP 接入指导 1 引言 本文档主要介绍如何使用 AT 命令配置接入中国移动设备管理平台（CMDMP）相关的参数。 基于移远通信 BC26 和 BC20 模块进行通信的终端设备支持 CMDMP 接入，以实现设备管理、设备信 息收集以及与设备相关的事件和预警信息的处理。有关 CMDMP 的详细信息，请联系中国移动。 上海移远通信技术股份有限公司 4 / 14 BC26&BC20 CMDMP 接入指导 2 CMDMP 接入相关 AT 命令详解 2.1. AT 命令类型 表 1：AT 命令类型及响应 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令或内部程序可支持的参数取值列表 或范围。 AT+? 返回相应设置命令的当前参数设置值。 AT+=[,[,[... 设置用户可自定义的参数值。 ]]] AT+ 主动执行内部程序实现的功能集。 备注 1. ：参数名称，实际命令行中不包括尖括号 < >；添加下划线'_'的参数取值为默认值； 2. [...]：可选参数，实际命令行中不包括方括号 [ ]；若无特别说明，可选参数省略时将采用默认值。 2.2. AT+QDMPCFG CMDMP 接入配置 该命令用于配置和查询 CMDMP 接入信息。 查询命令用于查询模块当前配置的参数。 设置命令用于保存或擦除配置信息，相关配置重启后生效。 AT+QDMPCFG CMDMP 接入配置 测试命令 AT+QDMPCFG=? 响应 +QDMPCFG: [,[,[,[,]]]] 上海移远通信技术股份有限公司 5 / 14 BC26&BC20 CMDMP 接入指导 查询命令 AT+QDMPCFG? OK 响应 +QDMPCFG: 0, +QDMPCFG: 1,,, +QDMPCFG: 2,,,, OK 设置命令 AT+QDMPCFG=[,[,[,[,<p 响应 当为 0、1、2 或 5 且命令执行成功时： OK arameter4>]]]] 当为 4、为 0 且命令执行成功时： +QDMPCFG: 0, OK 当为 4、为 1 且命令执行成功时： +QDMPCFG: 1,,, OK 当为 4、为 2 且命令执行成功时： +QDMPCFG: 2,,,, OK 当为 6 且命令执行成功时： +QDMPCFG: 6, OK 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置自动保存至 NVRAM，且深休眠唤醒后仍有效 上海移远通信技术股份有限公司 6 / 14 BC26&BC20 CMDMP 接入指导 参数 配置类型。 0 配置 CMDMP 接入状态 1 配置 CMDMP 服务器地址与更新周期 2 配置 CMDMP 应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 4 查询保存到 NVRAM 的配置信息 5 擦除保存到 NVRAM 的配置信息 6 查询 CMDMP 接入状态 不同的值配置不同的参数，格式如下： 0 1 2 3 预留值 4 5 6 CMDMP 接入模式。 0 禁止接入 CMDMP 1 允许接入 CMDMP CMDMP 服务器 IP 地址，默认服务器 IP 为 117.161.2.41。 CMDMP 服务器端口，默认服务器端口为 5683。 更新周期。范围：300-4294966，默认值为 86400；单位：秒。 应用密钥。设置命令中，应用双引号标记。 私钥。设置命令中，应用双引号标记；私钥仅显示前四位字符。 终端类型。 0 接口 1 Linux 2 Android 终端设备的 IMEI 号。长度应为 15-17 字节。 保存的配置信息查询选项。 0 查询保存的 CMDMP 接入模式 1 查询保存的 CMDMP 服务器 IP 地址、端口和更新周期 2 查询保存的应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 保存的配置信息擦除选项。 0 擦除保存的 CMDMP 接入模式 1 擦除保存的 CMDMP 服务器 IP 地址、端口和更新周期 2 擦除保存的应用密钥、私钥、终端类型和终端 IMEI 号 3 预留值 4 擦除以上保存的所有信息 CMDMP 接入状态。 上海移远通信技术股份有限公司 7 / 14 BC26&BC20 CMDMP 接入指导 0 DMP_INITIAL_STATE 4 DMP_CONNECT_SUCCESS 5 DMP_CONNECT_FAILED 6 DMP_REG_SUCCESS 7 DMP_REG_FAILED 8 DMP_REG_TIMEOUT 9 DMP_LIFETIME_TIMEOUT 11 DMP_UPDATE_SUCCESS 12 DMP_UPDATE_FAILED 13 DMP_UPDATE_TIMEOUT 举例 //查询当前配置信息。 AT+QDMPCFG? +QDMPCFG: 0,1 +QDMPCFG: 1,117.161.2.7,5683,420 +QDMPCFG: 2,M100000089,95Go****,1,863703030822519 OK //禁止接入 CMDMP。 AT+QDMPCFG=0,0 OK //查询已保存的 CMDMP 接入模式。 AT+QDMPCFG=4,0 +QDMPCFG: 0,0 OK //设置 CMDMP 服务器 IP 地址、端口和更新周期。117.161.2.7 是 CMDMP 测试服务器 IP 地址。 AT+QDMPCFG=1,117.161.2.7,5683,420 OK //查询保存的 CMDMP 服务器 IP 地址、端口和更新周期。 AT+QDMPCFG=4,1 +QDMPCFG: 1,117.161.2.7,5683,420 OK //设置应用密钥、私钥、终端类型和终端 IMEI 号。 AT+QDMPCFG=2,'M100000089','95Go****',1,863703030822519 OK 上海移远通信技术股份有限公司 8 / 14 //查询保存的应用密钥、私钥、终端类型和终端 IMEI 号。 AT+QDMPCFG=4,2 +QDMPCFG: 2,M100000089, 95Go****,1,863703030822519 OK //擦除所有已保存的信息。 AT+QDMPCFG=5,4 OK //查询 CMDMP 接入状态。 AT+QDMPCFG=6 +QDMPCFG: 6,6 //注册成功。 OK AT+QDMPCFG=6 +QDMPCFG: 6,11 //更新成功。 OK BC26&BC20 CMDMP 接入指导 2.3. AT+QDMPCFGEX CMDMP 接入扩展配置 该命令用于配置和查询 CMDMP v2.0 所需的 CMDMP 接入扩展信息。 设置命令用于保存、读取或擦除配置信息，相关配置重启后生效。 AT+QDMPCFGEX CMDMP 接入扩展配置 测试命令 AT+QDMPCFGEX=? 响应 +QDMPCFGEX: ,[,[,[,,]]] OK 设置命令 AT+QDMPCFGEX=,[,[,[,,]]] 响应 当为 0 或 2，且命令执行成功时： OK 当为 0、为 1 且命令执行成功时： +QDMPCFGEX: 0, 上海移远通信技术股份有限公司 9 / 14 BC26&BC20 CMDMP 接入指导 最大响应时间 保存机制 OK 当为 1、为 1 且命令执行成功时： +QDMPCFGEX: 1, OK 当为 2、为 1 且命令执行成功时： +QDMPCFGEX: 2,,,, OK 当为 3、为 1 且命令执行成功时： +QDMPCFGEX: 3,, OK 当为 4、为 1 且命令执行成功时： +QDMPCFGEX: 4,,,, OK 当为 5、为 1 且命令执行成功时： +QDMPCFGEX: 5, OK 若出现任何错误： ERROR 300 毫秒 参数配置自动保存至 NVRAM，且深休眠唤醒后仍有效 参数 配置类型。 0 配置终端应用程序信息 1 配置终端 MAC 地址 2 配置终端 ROM、RAM、CPU 和操作系统版本信息 3 配置终端软件版本和名称 4 配置终端 VoLTE 状态、网络类型、宽带帐号和电话号码 5 配置终端位置信息 上海移远通信技术股份有限公司 10 / 14 BC26&BC20 CMDMP 接入指导 配置模式。 0 保存信息至模块 1 读取模块中的信息 2 擦除模块中的信息 不同的值配置不同的参数，格式如下： 0 0 1 0 2 0 3 0 4 0 5 0 带双引号的字符串型。表示终端应用程序信息，最大字符串长度为 255 字节。它是应用 程序信息的集合，每个信息块用分号分隔，内容包含应用程序名称、包名称、应用程序 使用时间（单位：毫秒）、应用程序打开次数，并且每部分内容以'|'分隔。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 MAC 地址，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 ROM 信息，最大字符串长度为 19 字节。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 RAM 信息，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的 CPU 信息，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端操作系统版本，最大字符串长度为 47 字节。如果没有 相关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的软件版本，最大字符串长度为 47 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的软件名称，最大字符串长度为 47 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端 VoLTE 状态，最大字符串长度为 7 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端网络类型，最大字符串长度为 19 字节。如果没有相关 信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端宽带账号，最大字符串长度为 47 字节。如果没有相关 信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的电话号码，最大字符串长度为 19 字节。如果没有相 关信息，请将其设置为'NULL'。 带双引号的字符串型。表示终端的位置信息，最大字符串长度为 255 字节。如果没有相 关信息，请将其设置为'NULL'。 上海移远通信技术股份有限公司 11 / 14 BC26&BC20 CMDMP 接入指导 举例 //设置 APP 信息。 AT+QDMPCFGEX=0,0,'Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551 ;Alipay|FW88|22650|5555;Zhihu|FW333|77750|65101' OK //查询 APP 信息。 AT+QDMPCFGEX=0,1 +QDMPCFGEX: 0,Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551;Alip ay|FW88|22650|5555;Zhihu|FW333|77750|65101 OK //擦除 APP 信息。 AT+QDMPCFGEX=0,2 OK //设置 MAC 地址。 AT+QDMPCFGEX=1,0,'00-01-6C-06-A6-29' OK //查询 MAC 地址。 AT+QDMPCFGEX=1,1 +QDMPCFGEX: 1,00-01-6C-06-A6-29 OK //擦除 MAC 地址。 AT+QDMPCFGEX=1,2 OK //设置 ROM、RAM、CPU、OS 版本信息。 AT+QDMPCFGEX=2,0,'4096KB','4096KB','MT2625','FREE RTOS' OK //查询 ROM、RAM、CPU、OS 版本信息。 AT+QDMPCFGEX=2,1 +QDMPCFGEX: 2,4096KB,4096KB,MT2625,FREE RTOS OK //擦除 ROM、RAM、CPU、OS 版本信息。 AT+QDMPCFGEX=2,2 OK 上海移远通信技术股份有限公司 12 / 14 BC26&BC20 CMDMP 接入指导 //设置软件版本和名称。 AT+QDMPCFGEX=3,0,'BC26NBR01A07','Quectel' OK //查询软件版本和名称。 AT+QDMPCFGEX=3,1 +QDMPCFGEX: 3,BC26NB0R01A07,Quectel OK //擦除软件版本和名称。 AT+QDMPCFGEX=3,2 OK //设置 VoLTE 状态、网络类型、宽带帐号和电话号码。 AT+QDMPCFGEX=4,0,'off','NB-IoT','XY05553867549','18009699999' OK //查询 VoLTE 状态、网络类型、宽带帐号和电话号码。 AT+QDMPCFGEX=4,1 +QDMPCFGEX: 4,off,NB-IoT,XY05553867549,18009699999 OK //擦除 VoLTE 状态、网络类型、宽带帐号和电话号码。 AT+QDMPCFGEX=4,2 OK //设置位置信息。 AT+QDMPCFGEX=5,0,'31.8438799075,117.2025477950,OTDOA' OK //查询位置信息。 AT+QDMPCFGEX=5,1 +QDMPCFGEX: 5,31.8438799075,117.2025477950,OTDOA OK //擦除位置信息。 AT+QDMPCFGEX=5,2 OK 上海移远通信技术股份有限公司 13 / 14 BC26&BC20 CMDMP 接入指导 3 附录 A 术语缩写 表 2：术语缩写 术语 APP CMDMP CPU IMEI IP MAC ME NB-IoT NVRAM OS RAM ROM VoLTE 英文全称 Applications China Mobile Device Management Platform Central Processing Unit International Mobile Equipment Identity Internet Protocol Media Access Control Mobile Equipment Narrow Band Internet of Things Non-Volatile Random Access Memory Operating System Random Access Memory Read Only Memory Voice over Long-Term Evolution 中文全称 应用程序 中国移动设备管理平台 中央处理单元 国际移动设备识别码 互联网协议 媒体接入控制 移动设备 窄带物联网 非易失性随机访问存储器 操作系统 随机访问存储器 只读存储器 长期演进语音承载（一般称高清通话） 上海移远通信技术股份有限公司 14 / 14

BC26&BC20 DFOTA 应用指导 NB-IoT 模块系列 版本：2.0 日期：2020-09-04 状态：受控文件 www.quectel.com BC26&BC20 DFOTA 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 56 BC26&BC20 DFOTA 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 1.0 2019-11-20 王瑞 初始版本 1. 添加 AT 命令定义及其命令语句描述（第 1.1 章）。 2. 添加串口 DFOTA 及其实例（第 3 章和第 7.2 章）。 2.0 2020-09-04 蒋涛/ 董海波 3. 添加 AEP 平台 DFOTA 及其实例（第 4 章和第 7.3 章）。 4. 添加 OC 平台 DFOTA 及其实例（第 5 章和第 7.4 章）。 5. 添加 DFOTA 相关 URC 及其描述（第 6 章）。 上海移远通信技术股份有限公司 2 / 56 BC26&BC20 DFOTA 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 5 图片索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. AT 命令语句................................................................................................................................ 8 1.1.1. 定义 ................................................................................................................................. 8 1.1.2. AT 命令语句 .................................................................................................................... 8 2 HTTP DFOTA ....................................................................................................................................... 9 2.1. HTTP DFOTA 升级流程.............................................................................................................. 9 2.1.1. 获取差分包 .................................................................................................................... 10 2.1.2. 上传差分包至 HTTP 服务器 .......................................................................................... 10 2.1.3. 检查网络状况................................................................................................................. 10 2.1.4. 执行 AT 命令升级固件 ....................................................................................................11 2.2. HTTP DFOTA 相关 AT 命令 ..................................................................................................... 12 2.2.1. AT+QFOTADL= 触发 HTTP DFOTA 自动升级 .................................... 12 3 串口 DFOTA........................................................................................................................................ 14 3.1. 串口 DFOTA 升级流程.............................................................................................................. 14 3.2. 串口 DFOTA 相关 AT 命令....................................................................................................... 14 3.2.1. AT+QFUPLEX 通过串口分段写入差分包数据 ............................................................ 14 3.2.2. AT+QFOTADL=1 触发串口 DFOTA 自动升级 ............................................................ 16 3.3. CCITT CRC16 C 语言参考源码 ............................................................................................... 17 4 中国电信 AEP 平台 DFOTA................................................................................................................ 19 4.1. LwM2M 相关 AT 命令 .............................................................................................................. 19 4.2. AEP 平台 DFOTA 升级流程...................................................................................................... 21 4.2.1. 下载阶段 ........................................................................................................................ 22 4.2.2. 升级阶段 ........................................................................................................................ 22 4.2.3. 升级后阶段 .................................................................................................................... 22 4.3. AEP 平台 DFOTA 注意事项...................................................................................................... 22 4.3.1. 注意事项 ........................................................................................................................ 22 4.3.2. 升级 URC 与异常处理 ................................................................................................... 23 5 中国电信 IoT 平台 DFOTA.................................................................................................................. 24 5.1. 电信 IoT 平台相关 AT 命令 ....................................................................................................... 24 5.2. 电信 IoT 平台 DFOTA 升级流程 ............................................................................................... 26 5.2.1. 下载阶段 ........................................................................................................................ 27 5.2.2. 升级阶段 ........................................................................................................................ 27 5.2.3. 升级后阶段 .................................................................................................................... 27 5.3. 电信 IoT 平台 DFOTA 注意事项 ............................................................................................... 27 5.3.1. 注意事项 ........................................................................................................................ 27 5.3.2. 升级 URC 与异常处理 ................................................................................................... 28 上海移远通信技术股份有限公司 3 / 56 BC26&BC20 DFOTA 应用指导 6 DFOTA 相关 URC............................................................................................................................... 29 6.1. +QIND: 'FOTA','HTTPSTART' 开始通过 HTTP 下载差分包................................................ 29 6.2. +QIND: 'FOTA','DOWNLOADING' 通过 HTTP 下载差分包的进度 ..................................... 29 6.3. +QIND: 'FOTA','HTTPEND' 通过 HTTP 下载差分包的结果................................................ 30 6.4. +QIND: 'FOTA','COAPSTART' 开始通过 CoAP 下载差分包............................................... 30 6.5. +QIND: 'FOTA','COAPEND' 通过 CoAP 下载差分包的结果 ............................................... 30 6.6. +QIND: 'FOTA','START' 开始差分升级................................................................................ 31 6.7. +QIND: 'FOTA','UPDATING' 差分升级进度......................................................................... 31 6.8. +QIND: 'FOTA','END' 差分升级结果 ................................................................................... 31 7 实例 ..................................................................................................................................................... 33 7.1. HTTP DFOTA 升级................................................................................................................... 33 7.2. 串口 DFOTA 升级 .................................................................................................................... 34 7.3. AEP 平台 DFOTA 实例............................................................................................................. 36 7.3.1. 上传差分包到 AEP 平台 ................................................................................................ 36 7.3.2. 创建 DFOTA 任务 .......................................................................................................... 37 7.3.3. 添加升级设备................................................................................................................. 38 7.3.4. 设备升级 ........................................................................................................................ 39 7.3.5. 重新注册设备................................................................................................................. 41 7.4. 中国电信 IoT 平台 DFOTA 实例 ............................................................................................... 42 7.4.1. 配置平台 DFOTA 能力................................................................................................... 42 7.4.2. 生成公私密钥................................................................................................................. 43 7.4.3. 制作固件升级包 ............................................................................................................. 46 7.4.4. 上传固件升级包 ............................................................................................................. 47 7.4.5. 配置平台升级任务 ......................................................................................................... 48 7.4.6. 设备升级 ........................................................................................................................ 51 7.4.7. 重新注册设备................................................................................................................. 53 8 错误码 ................................................................................................................................................. 54 9 附录 A 参考文档及术语缩写............................................................................................................... 55 上海移远通信技术股份有限公司 4 / 56 BC26&BC20 DFOTA 应用指导 表格索引 表 1：AT 命令及响应类型............................................................................................................................. 8 表 2：查询网络状态命令列表 ..................................................................................................................... 10 表 3：LwM2M 相关 AT 命令列表............................................................................................................... 19 表 4：升级 URC 与异常处理 ...................................................................................................................... 23 表 5：电信 IoT 平台相关 AT 命令列表........................................................................................................ 24 表 6：DFOTA 相关 URC ............................................................................................................................ 29 表 7：值描述 ................................................................................................................................. 54 表 8：值描述....................................................................................................................... 54 表 9：参考文档........................................................................................................................................... 55 表 10：术语缩写......................................................................................................................................... 55 上海移远通信技术股份有限公司 5 / 56 BC26&BC20 DFOTA 应用指导 图片索引 图 1：DFOTA 分类 ....................................................................................................................................... 7 图 2：DFOTA 固件升级流程......................................................................................................................... 9 图 3：中国电信 AEP 平台 DFOTA 交互图.................................................................................................. 21 图 4：中国电信 IoT 平台 DFOTA 交互图................................................................................................... 26 图 5：DFOTA 选择固件管理....................................................................................................................... 36 图 6：创建固件版本.................................................................................................................................... 37 图 7：选择创建任务.................................................................................................................................... 37 图 8：创建升级任务.................................................................................................................................... 38 图 9：选择升级设备管理 ............................................................................................................................ 38 图 10：选择升级设备.................................................................................................................................. 38 图 11：启动升级 ......................................................................................................................................... 39 图 12：AEP 平台升级结果 ......................................................................................................................... 41 图 13：应用属性页 ..................................................................................................................................... 43 图 14：管理页面......................................................................................................................................... 43 图 15：下载签名工具.................................................................................................................................. 44 图 16：生成公私密钥.................................................................................................................................. 44 图 17：公钥上传步骤 1............................................................................................................................... 45 图 18：公钥上传步骤 2............................................................................................................................... 45 图 19：上传公钥文件.................................................................................................................................. 45 图 20：差分固件升级包数据签名步骤 ........................................................................................................ 46 图 21：添加固件包页面 .............................................................................................................................. 47 图 22：上传签名差分固件升级包至中国电信 IoT 平台............................................................................... 47 图 23：添加设备到默认群组步骤 1 ............................................................................................................ 48 图 24：添加设备到默认群组步骤 2 ............................................................................................................ 48 图 25：默认群组绑定完成 .......................................................................................................................... 49 图 26：创建批量任务页面 .......................................................................................................................... 49 图 27：创建批量升级任务 .......................................................................................................................... 50 图 28：设置升级任务参数 .......................................................................................................................... 50 图 29：选择升级群组.................................................................................................................................. 51 图 30：中国电信 IoT 平台升级结果............................................................................................................ 53 上海移远通信技术股份有限公司 6 / 56 BC26&BC20 DFOTA 应用指导 1 引言 移远通信 BC26 和 BC20 模块支持固件空中差分升级（DFOTA）功能，此功能可以实现模块固件的无 线升级或降级。 利用 DFOTA，用户通过差分包即可实现固件升级或降级。所述差分包仅包含当前版本固件和目标版本 固件之间的差异，因此大大降低了数据传输量、极大地缩短了传输时间。 本文档主要介绍如何通过 DFOTA 升级 BC26 和 BC20 模块的固件。DFOTA 根据数据下载通道，可以 分为 HTTP DFOTA、串口 DFOTA、CoAP DFOTA，其中 CoAP DFOTA 依赖于 LwM2M 平台，又分为 IoT 平台 DFOTA 和 AEP 平台 DFOTA。 DFOTA HTTP DFOTA 串口 DFOTA CoAP DFOTA OC平台DFOTA AEP平台DFOTA 图 1：DFOTA 分类 备注 1. BC20 模块当前没有对接 AEP 平台。因此，不能通过 AEP 进行 DFOTA 升级。 2. BC20 不支持串口 DFOTA。 上海移远通信技术股份有限公司 7 / 56 BC26&BC20 DFOTA 应用指导 1.1. AT 命令语句 1.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 1：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 8 / 56 BC26&BC20 DFOTA 应用指导 2 HTTP DFOTA 2.1. HTTP DFOTA 升级流程 下图阐述了通过 HTTP 下载通道，进行 DFOTA 升级的流程。 2. 将差分包放在HTTP 服务 器上 HTTP 服务 器 1. 获取差分包 NB-IoT (HTTP) 4. 通过NB-IoT网络从HTTP 服务 器自动 下载差 分包 外部 MCU 3. 执行AT+QFOTADL命令 移远通信 模块 5. 自动升级模块 固件 图 2：DFOTA 固件升级流程 上海移远通信技术股份有限公司 9 / 56 BC26&BC20 DFOTA 应用指导 如上图所示，通过 DFOTA 方式升级固件的步骤为： 第一步：从移远通信获取差分包。 第二步：将差分包放到 HTTP 服务器。 第三步：执行 AT+QFOTADL 命令。（模块通过 NB-IoT 或 GSM 网络从 HTTP 服务器下载差分固件 包，即上图中的步骤 4。下载成功后，将自动升级模块固件，即上图中的步骤 5。） 2.1.1. 获取差分包 升级之前，用户需先通过 ATI 命令获取当前固件版本，同时需明确目标固件版本；之后将当前版本和 目标版本信息发送给移远通信或模块供应商以获取相应的差分包。 2.1.2. 上传差分包至 HTTP 服务器 用户需自建 HTTP 服务器以便使用 DFOTA 功能。完成服务器建立之后，将差分包上传服务器并记录 下 HTTP 路径。执行 AT+QFOTADL 命令后，模块将自动从此路径下载差分包。 备注 上传差分固件包至 HTTP 服务器时，请记录差分固件包在 HTTP 上的路径（URL）。通过 AT+QFOTADL 进行固件包下载时需要使用正确的 URL，请参考第 2.2 章。 2.1.3. 检查网络状况 模块开机后，开始升级之前，请确认模块已注网。相关的 AT 命令如下： 表 2：查询网络状态命令列表 序号 [1] [2] [3] [4] AT 命令 AT+CESQ AT+CEREG? AT+CGATT? AT+CGPADDR? 描述 查询信号质量 查询注网状态 查询 EPS 附着状态 查询 PDN 分配的 IP 地址 有关上述命令的更多详细信息，请参阅文档 [1]。 上海移远通信技术股份有限公司 10 / 56 BC26&BC20 DFOTA 应用指导 2.1.4. 执行 AT 命令升级固件 确认网络状态后，执行 AT+QFOTADL 命令，随后模块将从 HTTP 服务器下载差分包并自动升级固件。 命令相关的详细信息，请参考第 2.2 章。 上海移远通信技术股份有限公司 11 / 56 BC26&BC20 DFOTA 应用指导 2.2. HTTP DFOTA 相关 AT 命令 2.2.1. AT+QFOTADL= 触发 HTTP DFOTA 自动升级 该 命 令用 于 触发 HTTP DFOTA 自动 下 载和 升级固 件 。将 差 分包 上 传 HTTP 服 务 器后 ，执 行 AT+QFOTADL= 命令，模块将自动从 HTTP 服务器下载差分包。若下载成功，模块将自动 更新固件。更新成功后，模块将自动重启；若更新失败，将返回 ERROR 并退出 DFOTA 模式。 AT+QFOTADL= 测试命令 AT+QFOTADL=? 设置命令 AT+QFOTADL= 触发 HTTP DFOTA 自动升级 响应 OK 响应 OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',,, +QIND: 'FOTA','UPDATING',,, ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效。 深休眠唤醒后无效；不保存到 NVRAM。 上海移远通信技术股份有限公司 12 / 56 BC26&BC20 DFOTA 应用指导 参数 字符串类型。最大长度为 255 字节。以'HTTP://'开头，格式如下： 'HTTP://< HTTP_server_URL>:< HTTP_port>/< HTTP_file_path>'。 < HTTP_server_URL> 字符串。HTTP 服务器的 IP 地址或域名。 < HTTP_port> 整型。HTTP 服务器的端口号。范围：1~65535；默认值： 80。 < HTTP_file_path> 字符串。HTTP 服务器中的文件路径。 整型。HTTP 下载相关的错误码。 0 下载成功 其他值 下载失败。相关详细信息，请参阅第 8 章。 整型。下载或升级的百分比进度。 整型。需要升级的程序总数；当前恒为 1。 整型。当前已升级和正在升级的程序数之和；当前恒为 1。 整型。升级结果错误码。 0 升级成功 其他值 升级失败。相关详细信息，请参阅第 8 章。 备注 1. 若模块处于升级状态时（即在上报+QIND: 'FOTA','UPDATING',,,状态时）断电，则下次开机时将自动进入强制升级模式，并从断电前的升级进度继续升级。 模块开机后会自动上报的 URC 如下： +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',,1,1 +QIND: 'FOTA','UPDATING',,1,1 ... +QIND: 'FOTA','END', 2. BC26 和 BC20 模块暂不支持 HTTPS。 3. 升级前请确认模块是否处于自适应波特率模式：若处于自适应波特率模式，升级结束后，串口波特率 未同步之前，模块不会输出升级结果码 URC；用户需主动通过 ATI 命令查询当前固件版本以确认升 级是否成功。因此，建议在升级前通过 AT+IPR 命令固定波特率，详情请参考文档 [1]。 上海移远通信技术股份有限公司 13 / 56 BC26&BC20 DFOTA 应用指导 3 串口 DFOTA 本章主要描述通过串口进行 BC26 模块 DFOTA 固件升级的相关命令。 3.1. 串口 DFOTA 升级流程 串口 DFOTA 升级流程如下： 第一步：使用 AT+QFUPLEX 命令向模块写入差分文件。 第二步：使用 AT+QFOTADL=1 命令触发模块升级。 具体过程实例请参见第 7.2 章。 备注 串口 DFOTA 仅适用于 BC26 模块。 3.2. 串口 DFOTA 相关 AT 命令 3.2.1. AT+QFUPLEX 通过串口分段写入差分包数据 该命令用于通过串口分段写入差分包数据。 AT+QFUPLEX 通过串口分段写入差分包数据 测试命令 AT+QFUPLEX=? 响应 AT+QFUPLEX=,[,[,]] AT+QFUPLEX=ESC 设置命令 AT+QFUPLEX=,[,[,]] OK 响应 > （响应 > 后，模块进入数据模式，即可分段写入差分包数据） 上海移远通信技术股份有限公司 14 / 56 BC26&BC20 DFOTA 应用指导 1）当输入的数据长度达到，且写入 Flash 成功并校验 正确： +QFUPLEX: OK 2）当输入的数据长度超过，或输入的数据校 验错误： ERROR 3）若数据输入时间超过： +QFUPLEX: -2,TIMEOUT ERROR 设置命令 若分段写入拆分数据长时间无响应，退 出数据模式 AT+QFUPLEX=ESC 最大响应时间 特性说明 若发生任何其他错误： ERROR 响应 +QFUPLEX: -1,ESC OK 或者 ERROR 300 毫秒 该命令立即生效。 参数 整型。单次写入的分段差分数据长度。取值为 128、256、512、1024、2048、4096 和 8192。单位：字节。 整型。写入的分段差分数据序号。取值从 0 开始递增。 整型。单次写入的实际数据长度。单位：字节。写入最后一包差分包数据时，通常剩余 差分包长度不足时，则必须配置，且取值为剩余差分包长度加 2； 其它情况下可省略，省略时将使用默认值，默认值为的值加 2。 整型。超时时间。单位：秒。默认值：6。范围 1-60。执行设置命令返回 > 后，若数 据输入时间超过，模块未接收到指定长度的数据，将会自动退出数据模式并 返回 ERROR。 整型。单次写入的差分数据实际长度。值为值减 2；单位：字节。 上海移远通信技术股份有限公司 15 / 56 BC26&BC20 DFOTA 应用指导 备注 1. 需要分段写入差分升级包，每段数据末尾追加 2 字节 CCITT-CRC16 校验，校验和低字节在前，高字 节在后。 2. 写入差分数据时，需要取固定值。 3. 需按顺序分段写入差分数据。当分段写入差分数据失败并返回 ERROR 时，需再次写入此段数据直至 数据写入成功。 4. 执行 AT+QFUPLEX=,[,[,]]分段写入差分数据时，若长 时间无响应，可以通过发送 AT+QFUPLEX=ESC 退出数据模式，并再次尝试写入此段数据。 5. CRC 校验以标准 CCITT-CRC16 低字节优先。相关 C 语言参考源代码，请参考第 3.2 章。 3.2.2. AT+QFOTADL=1 触发串口 DFOTA 自动升级 当模块内部存在差分包时，该命令用于触发串口 DFOTA 自动升级。 AT+QFOTADL=1 触发差分升级 测试命令 响应 AT+QFOTADL=? 设置命令 OK 响应 AT+QFOTADL=1 OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',,, +QIND: 'FOTA','UPDATING',,, ... +QIND: 'FOTA','END', 最大响应时间 特性说明 若发生任何错误： ERROR 300 毫秒 该命令立即生效。 上海移远通信技术股份有限公司 16 / 56 BC26&BC20 DFOTA 应用指导 参数 整型。下载或升级的百分比进度。 整型。需要升级的程序总数；当前恒为 1。 整型。当前已升级和正在升级的程序数之和；当前恒为 1。 整型。升级结果错误码。 0 升级成功 其他值 升级失败。相关详细信息，请参阅第 8 章。 3.3. CCITT CRC16 C 语言参考源码 const unsigned short CRC16_CCITT_table[256]={ 0x0,0x1021,0x2042,0x3063,0x4084,0x50a5,0x60c6,0x70e7,0x8108,0x9129,0xa14a,0xb16b,0xc18c,0xd 1ad,0xe1ce,0xf1ef, 0x1231,0x210,0x3273,0x2252,0x52b5,0x4294,0x72f7,0x62d6,0x9339,0x8318,0xb37b,0xa35a,0xd3bd,0 xc39c,0xf3ff,0xe3de, 0x2462,0x3443,0x420,0x1401,0x64e6,0x74c7,0x44a4,0x5485,0xa56a,0xb54b,0x8528,0x9509,0xe5ee, 0xf5cf,0xc5ac,0xd58d, 0x3653,0x2672,0x1611,0x630,0x76d7,0x66f6,0x5695,0x46b4,0xb75b,0xa77a,0x9719,0x8738,0xf7df,0x e7fe,0xd79d,0xc7bc, 0x48c4,0x58e5,0x6886,0x78a7,0x840,0x1861,0x2802,0x3823,0xc9cc,0xd9ed,0xe98e,0xf9af,0x8948,0x 9969,0xa90a,0xb92b, 0x5af5,0x4ad4,0x7ab7,0x6a96,0x1a71,0xa50,0x3a33,0x2a12,0xdbfd,0xcbdc,0xfbbf,0xeb9e,0x9b79,0x8 b58,0xbb3b,0xab1a, 0x6ca6,0x7c87,0x4ce4,0x5cc5,0x2c22,0x3c03,0xc60,0x1c41,0xedae,0xfd8f,0xcdec,0xddcd,0xad2a,0xb d0b,0x8d68,0x9d49, 0x7e97,0x6eb6,0x5ed5,0x4ef4,0x3e13,0x2e32,0x1e51,0xe70,0xff9f,0xefbe,0xdfdd,0xcffc,0xbf1b,0xaf3a ,0x9f59,0x8f78, 0x9188,0x81a9,0xb1ca,0xa1eb,0xd10c,0xc12d,0xf14e,0xe16f,0x1080,0xa1,0x30c2,0x20e3,0x5004,0x4 025,0x7046,0x6067, 0x83b9,0x9398,0xa3fb,0xb3da,0xc33d,0xd31c,0xe37f,0xf35e,0x2b1,0x1290,0x22f3,0x32d2,0x4235,0x5 214,0x6277,0x7256, 上海移远通信技术股份有限公司 17 / 56 BC26&BC20 DFOTA 应用指导 0xb5ea,0xa5cb,0x95a8,0x8589,0xf56e,0xe54f,0xd52c,0xc50d,0x34e2,0x24c3,0x14a0,0x481,0x7466,0x 6447,0x5424,0x4405, 0xa7db,0xb7fa,0x8799,0x97b8,0xe75f,0xf77e,0xc71d,0xd73c,0x26d3,0x36f2,0x691,0x16b0,0x6657,0x7 676,0x4615,0x5634, 0xd94c,0xc96d,0xf90e,0xe92f,0x99c8,0x89e9,0xb98a,0xa9ab,0x5844,0x4865,0x7806,0x6827,0x18c0,0 x8e1,0x3882,0x28a3, 0xcb7d,0xdb5c,0xeb3f,0xfb1e,0x8bf9,0x9bd8,0xabbb,0xbb9a,0x4a75,0x5a54,0x6a37,0x7a16,0xaf1,0x1 ad0,0x2ab3,0x3a92, 0xfd2e,0xed0f,0xdd6c,0xcd4d,0xbdaa,0xad8b,0x9de8,0x8dc9,0x7c26,0x6c07,0x5c64,0x4c45,0x3ca2,0 x2c83,0x1ce0,0xcc1, 0xef1f,0xff3e,0xcf5d,0xdf7c,0xaf9b,0xbfba,0x8fd9,0x9ff8,0x6e17,0x7e36,0x4e55,0x5e74,0x2e93,0x3eb 2,0xed1,0x1ef0 }; void crc16_ccitt_cal(uint8_t *aData, uint16_t aSize, uint8_t *Higher, uint8_t *Lower) { uint16_t i; uint16_t nAccum = 0; for ( i = 0; i < aSize; i++ ) { nAccum = ( nAccum << 8 ) ^ ( unsigned short )CRC16_CCITT_table[(( nAccum >> 8 ) ^ *aData++)&0xff]; } *Higher = (uint8_t)((nAccum>>8) & 0xff); *Lower = (uint8_t)((nAccum) & 0xff); } 上海移远通信技术股份有限公司 18 / 56 BC26&BC20 DFOTA 应用指导 4 中国电信 AEP 平台 DFOTA 本章主要描述如何通过 CTWing 中国电信物联网开放平台（中国电信 AEP 平台）的 DFOTA 功能对移 远通信 BC26 模块进行升级及相关注意事项。 AEP 平台 DFOTA 升级流程如下： 第一步：上传差分包到 AEP 平台。 第二步：创建 DFOTA 任务。 第三步：添加升级设备。 第四步：设备升级。 第五步：重新注册设备。 具体步骤请参见第 7.3 章。 备注 1. 有关中国电信 AEP 平台的详细信息，请访问地址 https://www.ctwing.cn/。 2. BC20 模块当前没有对接 AEP 平台，因此，不能通过 AEP 进行 DFOTA 升级。 4.1. LwM2M 相关 AT 命令 AEP 平台适用 LwM2M 协议，其与 DFOTA 相关的 AT 命令如下表所示。更多相关信息，请参阅文档 [2]。 表 3：LwM2M 相关 AT 命令列表 序号 [1] [2] [3] [4] AT 命令 AT+QLACONFIG AT+QLACFG AT+QLAREG AT+QLAUPDATE 描述 配置注册参数 配置可选注册参数 发送注册请求 发送更新请求 上海移远通信技术股份有限公司 19 / 56 BC26&BC20 DFOTA 应用指导 [5] AT+QLADEREG 发送注销请求 [6] AT+QLAADDOBJ 增加 LwM2M 对象 [7] AT+QLADELOBJ 删除 LwM2M 对象 [8] AT+QLARDRSP 响应读请求 [9] AT+QLAWRRSP 响应写请求 [10] AT+QLAEXERSP 响应执行请求 [11] AT+QLAOBSRSP 响应订阅请求 [12] AT+QLANOTIFY 上报被订阅资源的数据 [13] AT+QLASENDDATA 直接发送数据（只支持 AndLink） [14] AT+QLARD 读取缓存数据 [15] AT+QLASTATUS 查询当前 LwM2M 状态 [16] AT+QLARECOVER 手动恢复 LwM2M 会话 上海移远通信技术股份有限公司 20 / 56 4.2. AEP 平台 DFOTA 升级流程 BC26&BC20 DFOTA 应用指导 MCU AT+QLAREG +QLAREG: 0 +QLAURC: 'observe' AT+QLAOBSRS NB-IoT模块 AEP平台 配置平台固件升级任务 POST (register) ACK Get /19/0/0 (observe) ACK Get /3/0/3 ACK /3/0/3(value 当前版本号) Get /5/0/3 ACK /5/0/3(value 0) Get /5/0/3 (observe) ACK /5/0/3(value 0) +QIND: 'FOTA','COAPSTART' 开始下载 AT+QSCLK=0(防止模块进入休眠) AT+QLAUPDATE=0,7200 (防止升级时lifetime到期) +QLAUPDATE: 0,x PUT /5/0/1(Package URI) ACK Get Block2 Num 0 ACK Notify /5/0/3(value 1) ACK POST (Update) ACK 下载完成 +QIND: 'FOTA','COAPEND',0 +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', x%,x,x +QIND: 'FOTA','END',0 AT+QLAREG +QLAREG: 0 升级 +QLAURC: 'observe' AT+QLAOBSRSP Get Block2 Num N ACK Notify /5/0/3(value 2) ACK POST /5/0/2 ACK Notify /5/0/3(value 3) ACK POST (register) ACK Notify /5/0/3(value 0) ACK Get /19/0/0 (observe) ACK Get /5/0/5 ACK (value 1) Get /5/0/3 (observe=1) ACK 图 3：中国电信 AEP 平台 DFOTA 交互图 上海移远通信技术股份有限公司 AEP文件服务器 21 / 56 BC26&BC20 DFOTA 应用指导 4.2.1. 下载阶段 1. 当模块注册平台成功并上行任意数据，平台会感知模块在线。如果平台有固件升级任务，则会下发 请求查询版本号、小区 ID、信号强度以及升级状态等信息。 2. 如果平台判断可以发起升级，则会订阅资源/5/0/3。订阅成功后下发升级包 URL 给模块。模块状态 从 IDLE 转换成 DOWNLOADING。模块向 MCU 发送+QIND: 'FOTA','COAPSTART，通知 MCU 固件升级任务开始。 3. 模块在 DOWNLOADING 状态会向平台请求升级包数据，如果下载过程中有异常导致下载失败， 升级状态将从 DOWNLOADING 转变到 IDLE，模块也会向终端 MCU 发送+QIND: 'FOTA','CO APEND',（为大于 0 的数字），并通过资源/5/0/3 上报平台。如果正常下载完成， 则向 MCU 发送+QIND: 'FOTA','COAPEND',0，并通过资源/5/0/3 上报平台。 4.2.2. 升级阶段 平台收到下载完成的消息后，通过资源/5/0/2 下发升级命令，升级状态由 DOWNLOADED 转换到 UPDATING，模块向终端 MCU 发送+QIND: 'FOTA','START'，并通过资源/5/0/3 上报平台，之后模块自 动重启，开始差分升级。 4.2.3. 升级后阶段 差分升级完成后，模块会自动启动，状态由 UPDATING 转换到 DOWNLOADED。此时模块会向 MCU 发送+QIND: 'FOTA','END',。当模块正常入网后，MCU 应该使用 AT+QLAREG 命令使 模块接入平台，以便模块上报升级状态。平台通过资源/5/0/5 上报升级结果，并取消订阅资源/5/0/3。终端 可以正常进行业务。 4.3. AEP 平台 DFOTA 注意事项 4.3.1. 注意事项 ⚫ DFOTA 过程中终端对模块进行断电、重启、休眠等操作，可能会造成模块 DFOTA 失败。DFOTA 过程 中，终端需要终止业务，并且禁止向模块发送非指定 AT 命令。 ⚫ MCU 收到+QIND: 'FOTA','COAPSTART'后，需要使用 AT+QSCLK=0 禁止模块休眠，模块在重启 后会自动恢复允许休眠状态；使用 AT+QLAUPDATE 命令更新一个较长的生命周期（lifetime，建议设 置为 86400 秒），防止模块在升级时生命周期到期，导致平台判定升级失败。升级完成后，可以再次使 用 AT+QLAUPDATE 命令设置回原有的生命周期值。 ⚫ 模块上报+QIND: 'FOTA','END',后，需要重新注册到平台并完成订阅 object 19/0/0 后，平台才能查询升级结果。 ⚫ 模块不支持 AEP DFOTA 升级重试机制。若在差分升级过程中断电，模块上电后会继续升级；在其他 阶段（包括下载和下载完成阶段），模块将恢复 IDLE 状态，不再主动向平台上报 DFOTA 状态。 上海移远通信技术股份有限公司 22 / 56 BC26&BC20 DFOTA 应用指导 4.3.2. 升级 URC 与异常处理 表 4：升级 URC 与异常处理 升级状态 DFOTA 升级终端注意事项 +QIND: 'FOTA','COAPS TART' MCU 需保障模块不掉电直到模块上报+QIND: 'FOTA','COAPEND',（参见第 8 章）。最长等待 30 分钟，30 分钟后，若无上报提示，请重 启模块。 +QIND: 'FOTA','COAPEND',0 +QIND: 'FOTA','START' MCU 需保障模块不掉电直到模块上报+QIND: 'FOTA','START'消息，最 长等待 1 分钟；1 分钟后，若无上报提示，请重启模块。 MCU 需保障模块不掉电直到模块上报+QIND: 'FOTA','END',（参见第 8 章），最长等待 10 分钟；10 分钟后，若无上报提示，请 重启模块，直到模块上报+QIND: 'FOTA','END',。 +QIND: 'FOTA','END',0 升级成功，可进行正常业务。 上海移远通信技术股份有限公司 23 / 56 BC26&BC20 DFOTA 应用指导 5 中国电信 IoT 平台 DFOTA 本章节主要描述 BC26&BC20 模块通过中国电信 IoT 平台的固件升级功能进行升级的主要步骤和注意 事项。 中国电信 IoT 平台 DFOTA 升级的主要步骤如下： 第一步：配置平台 DFOTA 能力。 第二步：生成公私密钥。 第三步：制作固件升级包。 第四步：上传固件升级包。 第五步：配置平台升级任务。 第六步：设备升级 。 第七步：重新注册设备。 具体步骤请参见第 7.4 章。 备注 本文档提及的中国电信 IoT 平台是中国电信物联网开放平台-连接管理子系统，与华为 OceanConnect IoT 平台兼容。使用时需注意平台的版本是否相同。有关中国电信 IoT 平台的详细信息，请访问官方地址： https://www.ct10649.com/。 5.1. 电信 IoT 平台相关 AT 命令 电信 IoT 平台与 DFOTA 升级相关的 AT 命令如下表所示。更多相关信息，请参阅文档 [3]。 表 5：电信 IoT 平台相关 AT 命令列表 序号 [1] [2] [3] AT 命令名称 AT+QLWSERV AT+QLWCONF AT+QLWADDOBJ 功能描述 配置电信 loT 平台地址和端口 配置电信 IoT 平台参数 添加 LwM2M 对象 上海移远通信技术股份有限公司 24 / 56 BC26&BC20 DFOTA 应用指导 [4] AT+QLWDELOBJ 删除 LwM2M 对象 [5] AT+QLWOPEN 向电信 IoT 平台发送注册请求 [6] AT+QLWUPDATE 向电信 IoT 平台发送更新请求 [7] AT+QLWCLOSE 向电信 IoT 平台发送注销请求 [8] AT+QLWDATASEND 发送数据到电信 IoT 平台 [9] AT+QLWDATASTATUS 查询 CON 消息的发送状态 [10] AT+QLWRD 读取接收数据 [11] AT+QLWCFG 配置可选参数 [12] AT+QLWDEL 删除 LwM2M 场景 上海移远通信技术股份有限公司 25 / 56 5.2. 电信 IoT 平台 DFOTA 升级流程 BC26&BC20 DFOTA 应用指导 MCU NB-IoT模块 电信IoT平台 AT+QLWOPEN CONNECT OK +QLWOBSERVE: 0,19,0,0 POST (register) ACK 配置平台固件升级任务 Get /19/0/0 (observe) ACK AT+QLWDATASEND Get /3/0/3 ACK /3/0/3(value 当前版本号) Get /4/0 ACK /4/0 Get /5/0/3 (observe=0) ACK /5/0/3(value 0) PUT /5/0/1(Package URI) ACK Notify /5/0/3(value 1) +QIND: 'FOTA','COAPSTART' AT+QSCLK=0(防止模组进入休眠) 开始下载 ACK Get Block2 Num 0 ACK 下载完成 Get Block2 Num N ACK +QIND: 'FOTA','COAPEND',0 Notify /5/0/3(value 2) ACK POST /5/0/2 ACK Notify /5/0/3(value 3) +QIND: 'FOTA','START' ACK +QIND: 'FOTA','UPDATING', x%,x,x 升级 +QIND: 'FOTA','END',0 AT+QLWOPEN CONNECT OK POST (register) ACK Notify /5/0/3(value 0) ACK Get /5/0/5 ACK (value 1) Get /5/0/3 (observe=1) ACK 图 4：中国电信 IoT 平台 DFOTA 交互图 上海移远通信技术股份有限公司 文件服务器 26 / 56 BC26&BC20 DFOTA 应用指导 5.2.1. 下载阶段 1. 当模块注册平台成功并上行任意数据，平台会感知模块在线，如果平台有固件升级任务，则会下发 请求查询版本号、小区 ID、信号强度以及升级状态等信息。 2. 如果平台判断可以发起升级，则会订阅资源/5/0/3。订阅成功后下发升级包 URL 给模块。模块状态 从 IDLE 转换成 DOWNLOADING。模块向 MCU 发送+QIND: 'FOTA','COAPSTART'，通知 MCU 固件升级任务开始。 3. 模块在 DOWNLOADING 状态会向平台请求升级包数据，如果下载过程中有异常导致下载失败，升 级状态从 DOWNLOADING 转变到 IDLE，模块也会向终端 MCU 发送+QIND: 'FOTA','COAPE ND',（：大于 0 的数字），并通过资源/5/0/3 上报平台。如果下载完成，则向 M CU 发送+QIND: 'FOTA','COAPEND',0，并通过资源/5/0/3 上报平台。 5.2.2. 升级阶段 平台收到下载完成的消息后，通过资源/5/0/2 下发升级命令，升级状态由 DOWNLOADED 转换到 UPDATING，模块向终端 MCU 发送+QIND: 'FOTA','START'，并通过资源/5/0/3 上报平台，之后模块将 自动重启，开始差分升级。 5.2.3. 升级后阶段 差分升级完成后，模块会自动启动，状态由 UPDATING 转换到 IDLE。此时模块会向 MCU 发送+QIND: 'FOTA','END',。当模块正常入网后，MCU 应该使用 AT+QLAREG 命令使模块接入平台， 以便模块上报升级状态。平台通过资源/5/0/5 升级结果，并取消订阅资源/5/0/3。终端可以正常进行业务。 5.3. 电信 IoT 平台 DFOTA 注意事项 5.3.1. 注意事项 ⚫ 终端注册到平台后并上行一次数据后才会开始 DFOTA 任务。 ⚫ DFOTA 过程中终端对模块进行断电、重启、休眠等操作，可能会造成模块 DFOTA 失败。DFOTA 过程 中，终端需要终止业务，并且禁止向模块发送非指定 AT 命令。 ⚫ MCU 收到+QIND: 'FOTA','COAPSTART'后，需要使用 AT+QSCLK=0 禁止模块休眠，模块在重启 后会自动恢复允许休眠状态。 ⚫ 支持电信 IoT 平台 DFOTA 重试机制，若在 UPDATING 状态前出现下载失败、断电、超时等情况，重 启后重新注册到平台，平台将启动重试。在 UPDATING 状态断电，上电后模块会自动恢复差分升级。 之后过程同第 5.2.3 章 所述'升级后阶段'。 上海移远通信技术股份有限公司 27 / 56 5.3.2. 升级 URC 与异常处理 参见第 4.3.2 章。 BC26&BC20 DFOTA 应用指导 上海移远通信技术股份有限公司 28 / 56 BC26&BC20 DFOTA 应用指导 6 DFOTA 相关 URC 表 6：DFOTA 相关 URC 序号 [1] [2] [3] [4] [5] [6] [7] [8] URC +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','COAPSTART' +QIND: 'FOTA','COAPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',,, +QIND: 'FOTA','END', 描述 开始通过 HTTP 下载差分包 通过 HTTP 下载差分包的进度 通过 HTTP 下载差分包的结果 开始通过 CoAP 下载差分包 通过 CoAP 下载差分包的结果 开始差分升级 差分升级进度 差分升级结果 6.1. +QIND: 'FOTA','HTTPSTART' 开始通过 HTTP 下载差分包 +QIND: 'FOTA','HTTPSTART' 开始通过 HTTP 下载差分包 +QIND: 'FOTA','HTTPSTART' 开始通过 HTTP 下载差分包 6.2. +QIND: 'FOTA','DOWNLOADING' 通过 HTTP 下载差分包的进度 +QIND: 'FOTA','DOWNLOADING' 通过 HTTP 下载差分包的进度 +QIND: 'FOTA','DOWNLOADING',< 通过 HTTP 下载差分包的进度 上海移远通信技术股份有限公司 29 / 56 percent> 参数 整型。下载进度。百分比形式。 BC26&BC20 DFOTA 应用指导 6.3. +QIND: 'FOTA','HTTPEND' 通过 HTTP 下载差分包的结果 +QIND: 'FOTA','HTTPEND' 通过 HTTP 下载差分包的结果 +QIND: 'FOTA','HTTPEND', 通过 HTTP 下载差分包的结果 参数 整型。HTTP 下载结果。 0 下载完成 其他值 下载失败。详情参见第 8 章。 6.4. +QIND: 'FOTA','COAPSTART' 开始通过 CoAP 下载差分包 +QIND: 'FOTA','COAPSTART' 开始通过 CoAP 下载差分包 +QIND: 'FOTA','COAPSTART' 开始通过 CoAP 下载差分包 6.5. +QIND: 'FOTA','COAPEND' 通过 CoAP 下载差分包的结果 +QIND: 'FOTA','COAPEND' 通过 CoAP 下载差分包的结果 +QIND: 'FOTA','COAPEND', 通知 TE CoAP 下载差分包结果 上海移远通信技术股份有限公司 30 / 56 参数 整型。CoAP 差分包下载结果。 0 下载完成 其他值 下载失败。详情参见第 8 章。 BC26&BC20 DFOTA 应用指导 6.6. +QIND: 'FOTA','START' 开始差分升级 +QIND: 'FOTA','START' 开始差分升级 +QIND: 'FOTA','START' 开始差分升级 6.7. +QIND: 'FOTA','UPDATING' 差分升级进度 +QIND: 'FOTA','UPDATING' 差分升级进度 +QIND: 'FOTA','UPDATING',,, 参数 整型。下载或升级的百分比进度。。 整型。需要升级的程序总数；当前恒为 1。 整型。当前已升级和正在升级的程序数之和；当前恒为 1。 6.8. +QIND: 'FOTA','END' 差分升级结果 +QIND: 'FOTA','END' 差分升级结果 +QIND: 'FOTA','END', 差分升级结果 上海移远通信技术股份有限公司 31 / 56 参数 整型。升级结果。 0 升级成功 其他值 升级失败。详情参见第 8 章。 BC26&BC20 DFOTA 应用指导 上海移远通信技术股份有限公司 32 / 56 BC26&BC20 DFOTA 应用指导 7 实例 7.1. HTTP DFOTA 升级 //差分包已存储至 HTTP 服务器。 //HTTP 服务器地址为'http://www.quectel.com:100/update.bin'。 AT+CESQ;+CEREG?;+CPIN?;+COPS? //查询信号质量和网络注册状态。 +CESQ: 47,6,255,255,0,54 +CEREG: 0,1 +CPIN: READY +COPS: 0,2,'46011',9 OK //执行 AT+QFOTADL 命令以使能模块通过 DFOTA 自动升级固件，随后模块自动下载差分包并升级固件。 AT+QFOTADL='http://www.quectel.com:100/update.bin' OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', 1% +QIND: 'FOTA','DOWNLOADING', 2% …… +QIND: 'FOTA','DOWNLOADING', 100% +QIND: 'FOTA','HTTPEND',0 //下载差分包完成 +QIND: 'FOTA','START' F1: 0000 0000 V0: 0000 0000 [0001] 上海移远通信技术股份有限公司 33 / 56 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM +QIND: 'FOTA','UPDATING',20%,1,1 +QIND: 'FOTA','UPDATING',21%,1,1 …… …… …… +QIND: 'FOTA','UPDATING',100%,1,1 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM RDY +CFUN: 1 +QIND: 'FOTA','END',0 +CPIN: READY +IP: 100.75.72.128 //升级进度 //升级成功 BC26&BC20 DFOTA 应用指导 7.2. 串口 DFOTA 升级 AT+QFUPLEX=4096,0,4098 > 636F7265 …… 07BE723390 +QFUPLEX: 4096 上海移远通信技术股份有限公司 //输入二进制格式的分段数据和 CRC 校验值 34 / 56 BC26&BC20 DFOTA 应用指导 OK AT+QFUPLEX=4096,1,4098 > 000048BA …… 029017CCF0 //输入二进制格式的分段数据和 CRC 校验值 +QFUPLEX: 4096 OK ….. AT+QFUPLEX=4096,50,1082 > 98603BF2 …… EE7ED2A5F0 //输入二进制格式的分段数据和 CRC 校验值 +QFUPLEX: 1080 OK AT+QFOTADL=1 +QIND: 'FOTA','START' F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM +QIND: 'FOTA','UPDATING',20%,1,1 //升级进度 +QIND: 'FOTA','UPDATING',21%,1,1 …… +QIND: 'FOTA','UPDATING',100%,1,1 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM 上海移远通信技术股份有限公司 35 / 56 RDY +CFUN: 1 +QIND: 'FOTA','END',0 +CPIN: READY +IP: 100.86.71.166 BC26&BC20 DFOTA 应用指导 //升级成功 7.3. AEP 平台 DFOTA 实例 7.3.1. 上传差分包到 AEP 平台 上传差分包到 AEP 平台前，需先从供应商处获取差分固件升级包。然后登录 AEP 平台控制台，点击 '远程升级管理'，选择'FOTA 升级'→'固件管理'→'创建固件'，将固件信息上传至云端。 图 5：DFOTA 选择固件管理 上海移远通信技术股份有限公司 36 / 56 BC26&BC20 DFOTA 应用指导 图 6：创建固件版本 7.3.2. 创建 DFOTA 任务 返回 AEP 平台控制台，选择'远程升级管理'→'创建任务'，即可创建升级任务。 图 7：选择创建任务 上海移远通信技术股份有限公司 37 / 56 BC26&BC20 DFOTA 应用指导 图 8：创建升级任务 7.3.3. 添加升级设备 选择'远程升级管理'，选中创建的任务名称（下图中以'Test1'为例），点击任务设备管理图标， 勾选需要升级的设备，点击右上角'加入升级'。如下图所示。 图 9：选择升级设备管理 图 10：选择升级设备 上海移远通信技术股份有限公司 38 / 56 BC26&BC20 DFOTA 应用指导 7.3.4. 设备升级 选择'远程升级管理'→'启动升级图标'→'立即启动'，如下图所示。 图 11：启动升级 设置平台升级任务后，设备注册到平台，收到平台下发的 observe 请求后，随即开始升级。如果设备 在设置平台升级任务前已注册到平台，在上行一次数据后，随即开始升级。以下以第一种情况为例： +IP: 11.201.96.220 //上报本地 IP ATI Quectel_Ltd Quectel_BC26 Revision: BC26NCR01A08 //查询当前版本 OK AT+QLACONFIG=0,221.229.214.202,5683,'urn:imei-imsi:866971030603068- 460111174747875',3000,3,0 //配置平台信息 OK AT+QLAREG //启动注册 OK +QLAREG: 0 //注册成功 +QLAURC: 'observe',21295,0,19,0,0 //收到平台下发的订阅 object19/0/0 的请求 AT+QLAOBSRSP=21295,1,19,0,0,2,9,'020001000400023238',0 //应答平台订阅 OK +QLAOBSRSP: 0 +QIND: 'FOTA','COAPSTART' AT+QSCLK=0 OK //开始下载差分包 //禁止深休眠 上海移远通信技术股份有限公司 39 / 56 AT+QLAUPDATE=0,300 +QLAUPDATE: 35654 OK +QLAUPDATE: 0,35654 +QLAURC: 'report',50695 +QIND: 'FOTA','COAPEND',0 +QLAURC: 'report',50697 +QLAURC: 'report',50699 +QIND: 'FOTA','START' F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM +QIND: 'FOTA','UPDATING',20%,1,1 +QIND: 'FOTA','UPDATING',21%,1,1 …… +QIND: 'FOTA','UPDATING',100%,1,1 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM RDY +CFUN: 1 上海移远通信技术股份有限公司 BC26&BC20 DFOTA 应用指导 //下载完成 //开始升级 //升级进度 40 / 56 BC26&BC20 DFOTA 应用指导 +QIND: 'FOTA','END',0 //成功升级 +CPIN: READY +IP: 11.129.144.217 AT+QLAREG OK //再注册到平台，以便上报升级结果到平台 +QLAREG: 0 +QLAURC: 'report',8030 +QLAURC: 'observe',62640,0,19,0,0 //收到平台下发的订阅 object19/0/0 的请求 AT+QLAOBSRSP=62640,1,19,0,0,2,9,'020001000400023238',0 //应答平台订阅 OK +QLAOBSRSP: 0 ATI Quectel_Ltd Quectel_BC26 Revision: BC26NCR01A08_BETA0306 //查询当前版本 7.3.5. 重新注册设备 模块升级后，MCU 需要控制模块重新向 AEP 平台发起注册，以便模块上报升级结果。成功上报后平 台显示如下： 图 12：AEP 平台升级结果 上海移远通信技术股份有限公司 41 / 56 BC26&BC20 DFOTA 应用指导 7.4. 中国电信 IoT 平台 DFOTA 实例 7.4.1. 配置平台 DFOTA 能力 在 DFOTA 升级之前，需要确保在中国电信 IoT 平台上成功注册设备，且能正常收发数据。只有在设备 与电信 IoT 平台进行正常通讯时，才可以进行 DFOTA 升级。 参考中国电信 IoT 平台官方文档完成应用的创建。创建应用时，请注意导入设备的 Profile，该 Profile 必须包含 omCapabilities 能力（若未包含，请在 Profile 中添加如下 Profile 模板中的红色标记内容），否则 无法向平台上传对应设备的差分固件升级包且平台无法对该设备创建固件升级任务。具体 Profile 开发指导 请联系中国电信 IoT 平台获取。 以下是支持升级的一个 Profile 模板，供参考。 { 'devices': [ { 'manufacturerId': 'QUECTEL', 'manufacturerName': 'QUECTEL', 'model': 'BC26', 'protocolType': 'CoAP', 'deviceType': 'WaterMeter', 'omCapability':{ 'upgradeCapability' : { 'supportUpgrade':false }, 'fwUpgradeCapability' : { 'supportUpgrade':true, 'upgradeProtocolType':'LWM2M', 'downloadProtocolType':'CoAP' } }, 'serviceTypeCapabilities': [ { 'serviceId': 'Brightness', 'serviceType': 'Brightness', 'option': 'Master' }, { 'serviceId': 'WaterData', 'serviceType': 'WaterData', 'option': 'Optional' } ] 上海移远通信技术股份有限公司 42 / 56 BC26&BC20 DFOTA 应用指导 } ] } 在中国电信 IoT 开发者中心对应的应用属性页打开固件升级，新创建的应用即可拥有 omCapabilities 能力。如下图所示。 图 13：应用属性页 备注 对接过中国电信 IoT 平台 1.5 版本的设备，其对应的 Profile 基本没有包含 omCapabilities 能力，若后续 需要测试，请在 Profile 中添加如上 Profile 模板中的用红色标记的内容。 7.4.2. 生成公私密钥 1. 登陆中国电信 IoT 平台，进入'系统管理'→'工具'页面，点击'离线签名工具'下载离线签名 工具压缩包 signtool.zip。如下图所示。 图 14：管理页面 上海移远通信技术股份有限公司 43 / 56 BC26&BC20 DFOTA 应用指导 图 15：下载签名工具 2. 解压工具压缩包，运行 signtool.exe，选择'签名算法'为'RSA2048+SHA256'，输入'私钥加 密口令'，例如'quectel123'；点击'生成公私密钥'，将生成一对公私密钥文件 private.pem 和 public.pem。如下图所示。 图 16：生成公私密钥 上海移远通信技术股份有限公司 44 / 56 BC26&BC20 DFOTA 应用指导 3. 进入'系统管理'→'设备管理'，选择所创建的产品名称，点击'软件库'→'公钥管理'→'上 传'，上传公钥文件 public.pem 到电信 IoT 平台，如下图所示。注意'厂商名称'需要与 Profile 文 件里面的厂商名称相对应。 图 17：公钥上传步骤 1 图 18：公钥上传步骤 2 图 19：上传公钥文件 上海移远通信技术股份有限公司 45 / 56 BC26&BC20 DFOTA 应用指导 7.4.3. 制作固件升级包 通过 ATI 获取当前固件版本，同时需明确目标固件版本；之后将当前版本和目标版本信息提交给移远 通信或模块供应商以获取相应的差分包，然后对升级包进行数字签名。签名过程如下： 1. 运行 signtool.exe，在'签名算法'中选择私钥对应的'RSA2048+SHA256'签名算法。 2. 在'私钥文件'中导入 private.pem 私钥文件并输入之前设置的密码，例如'quectel123'。 3. 在'需要数字签名的软件包'处导入差分固件升级包，需要注意的是差分固件升级包的文件是 bin 格式文件，例如：BC26NCR01A07-BC26NCR01A08.bin，但对差分固件升级包进行数字签名的文 件为 zip 格式文件，上传到平台的也是已经签名的 zip 文件，所以需要将差分固件升级包的 bin 格 式文件压缩成 zip 格式，如 BC26NCR01A07-BC26NCR01A08.zip。 4. 点击'进行数字签名'，显示'签名成功！'后，在差分固件升级包同级目录下将生成带'signed' 标志的已签名差分固件升级包，如：BC26NCR01A07-BC26NCR01A08_signed.zip。 图 20：差分固件升级包数据签名步骤 备注 上传至平台的已签名差分固件升级包为 zip 格式。因此，生成的 zip 格式的已签名差分固件升级包（例如 BC26NCR01A07-BC26NCR01A08_signed.zip）不用做解压处理，可直接上传。 上海移远通信技术股份有限公司 46 / 56 BC26&BC20 DFOTA 应用指导 7.4.4. 上传固件升级包 登陆中国电信 IoT 平台，进入'软件库'→'固件包管理'→'添加固件包'页面。 图 21：添加固件包页面 上传签名后的差分固件升级包，并按下图提示完成信息填写，例如'版本'填写为'BC26NCR01A07BC26NCR01A08'、'设备类型'填写为'WaterMeter'、'厂商名称'填写为'QUECTEL'、'型号'填 写为'BC26'、'协议'填写为'CoAP'。 图 22：上传签名差分固件升级包至中国电信 IoT 平台 上海移远通信技术股份有限公司 47 / 56 BC26&BC20 DFOTA 应用指导 备注 设备类型、厂商名称、型号、协议必须与应用的 Profile 严格一致，否则上传差分固件升级包和 DFOTA 升 级任务将失败。 7.4.5. 配置平台升级任务 1. 添加设备到默认群组，选择'群组'→'默认群组'→'设备'→'绑定设备'→'选择设备'→ '绑定'，如下图所示。 图 23：添加设备到默认群组步骤 1 图 24：添加设备到默认群组步骤 2 上海移远通信技术股份有限公司 48 / 56 BC26&BC20 DFOTA 应用指导 图 25：默认群组绑定完成 2. 在'批量任务'→'批量软固件升级'→'固件升级'→'创建'页面中创建批量任务，按照需求 填写任务名、重试策略和重试次数。 图 26：创建批量任务页面 上海移远通信技术股份有限公司 49 / 56 BC26&BC20 DFOTA 应用指导 图 27：创建批量升级任务 3. 设置升级任务参数并选择对应的差分固件升级包。 图 28：设置升级任务参数 上海移远通信技术股份有限公司 50 / 56 4. 选择需要升级的设备群组，完成平台升级任务的创建。 BC26&BC20 DFOTA 应用指导 图 29：选择升级群组 7.4.6. 设备升级 升级任务创建成功之后，终端设备发送上行数据包，触发平台的 DFOTA 升级，升级过程包括下载差分 固件升级包和更新固件。在升级完成后，模块需要手动重新注册平台，才能向平台上报升级结果。 AT+QLWSERV='180.101.147.115',5683 OK AT+QLWCONF='866971030399922' OK AT+QLWADDOBJ=19,0,0,'0' OK AT+QLWADDOBJ=19,1,0,'0' OK AT+QLWOPEN=1 OK //设置平台 IP 和端口 //设置终端名 //增加对象 19 //增加对象 19 //打开 LwM2M，开始连接 CONNECT OK //连接平台成功 +QLWOBSERVE: 0,19,0,0 AT+QLWCFG='dataformat',1,1 OK AT+QLWDATASEND=19,0,0,1,01,0x0100 OK //平台订阅 19/0/0 //设置数据模式，收发数据均配置为十六进制字符串格式 //上传数据触发平台升级 上海移远通信技术股份有限公司 51 / 56 BC26&BC20 DFOTA 应用指导 SEND OK +QLWDATARECV: 19,1,0,8,FFFE01134C9A0000 +QLWOBSERVE: 0,5,0,3 +QIND: 'FOTA','COAPSTART' //开始差分包下载 +QIND: 'FOTA','COAPEND',0 //完成差分包下载 +QIND: 'FOTA','START' //开始升级 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM +QIND: 'FOTA','UPDATING',20%,1,1 //升级进度 +QIND: 'FOTA','UPDATING',21%,1,1 …… +QIND: 'FOTA','UPDATING',100%,1,1 F1: 0000 0000 V0: 0000 0000 [0001] 00: 0006 000C 01: 0000 0000 U0: 0000 0001 [0000] T0: 0000 00B4 Leaving the BROM RDY +CFUN: 1 +QIND: 'FOTA','END',0 //完成升级 +CPIN: READY +IP: 100.96.44.128 AT+QLWSERV='180.101.147.115',5683 //设置平台 IP 和端口，重新连接平台以便上报升级结果 上海移远通信技术股份有限公司 52 / 56 OK AT+QLWCONF='866971030399922' OK AT+QLWADDOBJ=19,0,0,'0' OK AT+QLWADDOBJ=19,1,0,'0' OK AT+QLWOPEN=1 OK CONNECT OK //设置终端名 //增加对象 19 //增加对象 19 BC26&BC20 DFOTA 应用指导 //连接平台成功 7.4.7. 重新注册设备 模块升级后，MCU 需要控制模块重新向电信 IoT 平台发起注册，以便模块上报升级结果。成功上报后 平台显示如下： 图 30：中国电信 IoT 平台升级结果 上海移远通信技术股份有限公司 53 / 56 BC26&BC20 DFOTA 应用指导 8 错误码 本章介绍了与和相关的错误码。详细信息，请参阅下表。 表 7：值描述 值 0 12 13 20 102 英文含义 Downloaded successfully HTTP download failed Network deactivated Network activating Unsupported protocol 中文含义 下载成功 HTTP 下载失败 网络已去激活 网络激活过程中 不支持的协议 表 8：值描述 值 0 1 2 254 255 英文含义 Upgraded successfully Unknown error FOTA is busy Delta firmware package mismatch Delta firmware package invalid 中文含义 升级成功 未知错误 FOTA 繁忙 差分包不匹配 差分包无效 上海移远通信技术股份有限公司 54 / 56 BC26&BC20 DFOTA 应用指导 9 附录 A 参考文档及术语缩写 表 9：参考文档 序号 文件名称 [1] Quectel_BC26&BC20&BC030x 系列_AT 命令手册 [2] Quectel_BC26_LwM2M_应用指导 [3] Quectel_BC26&BC20_电信 IoT 平台_应用指导 备注 BC26&BC20&BC030x 系列 AT 命令 手册 BC26 LwM2M 应用指导 BC26&BC20 电信 IoT 平台应用指导 表 10：术语缩写 术语 AEP CoAP CRC DFOTA EPS FOTA HTTP(S) ID IP LwM2M MCU NB-IoT 英文全称 Application Enablement Platform Constrained Application Protocol Cyclic Redundancy Check Delta Firmware Upgrade Over-the-Air Evolved Packet System Firmware Upgrade Over-the-Air Hyper Text Transport Protocol (Secure) Identity Internet Protocol Lightweight Machine to Machine Microcontroller Unit Narrow Band Internet of Things 中文全称 应用支持平台 受限应用协议 循环冗余校验 固件空中差分升级 演进型分组系统 固件空中升级 超文本传输（安全）协议 身份标识号码 网络协议 轻量级物联网协议 微控制单元 窄带物联网 上海移远通信技术股份有限公司 55 / 56 NVRAM PDN TE URC URI URL Non-Volatile Random Access Memory Public Data Network Terminal Equipment Unsolicited Result Code Uniform Resource Identifier Uniform Resource Locator BC26&BC20 DFOTA 应用指导 非易失性随机访问存储器 公用数据网 终端设备 非请求结果码 统一标识 统一资源定位符 上海移远通信技术股份有限公司 56 / 56

BC26&BC20 OneNET 应用指导 NB-IoT 模块系列 版本：BC26&BC20_OneNET_应用指导_V1.0 日期：2019-12-10 状态：受控文件 www.quectel.com BC26&BC20 OneNET 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 40 BC26&BC20 OneNET 应用指导 文档历史 修订记录 版本 日期 作者 1.0 2019-12-10 李婷婷 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 40 BC26&BC20 OneNET 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 OneNET 数据交互机制 ......................................................................................................................... 7 3 OneNET 相关 AT 命令.......................................................................................................................... 8 3.1. AT 命令类型................................................................................................................................ 8 3.2. OneNET 相关 AT 命令详解 ........................................................................................................ 8 3.2.1. AT+MIPLCONFIG OneNET 接入配置 .......................................................................... 8 3.2.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 .......................................................... 9 3.2.3. AT+MIPLDELETE 删除 OneNET 通信套件实例......................................................... 10 3.2.4. AT+MIPLVER 查询 OneNET 通信套件版本.................................................................11 3.2.5. AT+MIPLADDOBJ 添加 LwM2M 对象 .........................................................................11 3.2.6. AT+MIPLDELOBJ 删除 LwM2M 对象......................................................................... 12 3.2.7. AT+MIPLRD 读取接收数据......................................................................................... 12 3.2.8. AT+MIPLOPEN 发送注册请求.................................................................................... 14 3.2.9. AT+MIPLCLOSE 发送注销请求.................................................................................. 14 3.2.10. AT+MIPLDISCOVERRSP 响应发现资源请求 ............................................................ 15 3.2.11. AT+MIPLOBSERVERSP 响应订阅请求 ..................................................................... 16 3.2.12. AT+MIPLREADRSP 响应读取请求 ............................................................................ 17 3.2.13. AT+MIPLWRITERSP 响应写入请求 ........................................................................... 18 3.2.14. AT+MIPLEXECUTERSP 响应执行请求 ..................................................................... 19 3.2.15. AT+MIPLPARAMETERRSP 响应写属性请求............................................................. 20 3.2.16. AT+MIPLNOTIFY 上报数据至 OneNET 平台或应用服务器 ....................................... 21 3.2.17. AT+MIPLUPDATE 发送更新请求................................................................................ 22 4 错误码 ................................................................................................................................................. 24 5 OneNET 相关 URC ............................................................................................................................. 25 5.1. +MIPLDISCOVER 通知 TE 响应发现资源请求 ..................................................................... 25 5.2. +MIPLOBSERVE 通知 TE 响应订阅请求 .............................................................................. 26 5.3. +MIPLREAD 通知 TE 响应读取请求 ..................................................................................... 26 5.4. +MIPLWRITE 通知 TE 响应写入请求 .................................................................................... 27 5.5. +MIPLEXECUTE 通知 TE 响应执行请求 .............................................................................. 28 5.6. +MIPLPARAMETER 通知 TE 响应写属性请求...................................................................... 29 5.7. +MIPLEVENT 向 TE 通知事件 .............................................................................................. 29 6 举例 ..................................................................................................................................................... 31 6.1. 注册及发现资源操作................................................................................................................. 31 6.1.1. 注册 OneNET 平台 ........................................................................................................ 31 6.1.2. 注册 OneNET 平台（使能 Bootstrap） ......................................................................... 32 上海移远通信技术股份有限公司 3 / 40 BC26&BC20 OneNET 应用指导 6.1.3. 注册 OneNET 平台（禁用 Bootstarp） ......................................................................... 33 6.2. 读取操作 ................................................................................................................................... 34 6.2.1. 读取资源 ........................................................................................................................ 34 6.2.2. 读取实例 ........................................................................................................................ 34 6.2.3. 读取对象 ........................................................................................................................ 35 6.3. 写入操作 ................................................................................................................................... 35 6.3.1. 写入资源 ........................................................................................................................ 35 6.3.2. 写入实例 ........................................................................................................................ 36 6.4. 执行操作 ................................................................................................................................... 36 6.5. 写属性操作 ............................................................................................................................... 37 6.6. 订阅操作 ................................................................................................................................... 37 6.7. 上报数据操作............................................................................................................................ 37 6.7.1. 上报资源数据................................................................................................................. 37 6.7.2. 上报实例数据................................................................................................................. 37 6.7.3. 上报对象数据................................................................................................................. 38 6.7.4. 使用上报资源数据............................................................................................. 38 6.7.5. 使用上报实例数据............................................................................................. 39 6.8. 更新操作 ................................................................................................................................... 39 7 附录 A 参考文档及术语缩写............................................................................................................... 40 上海移远通信技术股份有限公司 4 / 40 BC26&BC20 OneNET 应用指导 表格索引 表 1：AT 命令类型及响应 .................................................................................................................................... 8 表 2：值描述 .......................................................................................................................................... 24 表 3：ONENET 相关 URC................................................................................................................................. 25 表 4：参考文档 .................................................................................................................................................. 40 表 5：术语缩写 .................................................................................................................................................. 40 上海移远通信技术股份有限公司 5 / 40 BC26&BC20 OneNET 应用指导 1 引言 LwM2M 是一种安全、高效、易部署的客户端-服务器协议，适用于不同网络环境下资源有限的终端设 备管理。LwM2M 基于表述性状态转移（REST）、采用现代架构设计，定义了可扩展资源和数据模型，使 用并基于受限应用程序协议（CoAP）这一高效安全的数据传输协议进行消息传递。依据 CoAP（RFC 72 52），LwM2M 可作为设备服务的 Profile，以此提供轻量紧凑安全的通信接口以及高效的数据模型，从而实 现 M2M 设备的管理与服务。 本文档主要介绍如何通过相关 AT 命令将集成移远通信 BC26 或 BC20 模块的设备连接到中国移动 OneNET 物联网开放平台（以下简称 OneNET），并通过 LwM2M 实现相关功能，如添加/删除对象、发送/ 读取数据、响应订阅/读取/写入/执行请求等。 上海移远通信技术股份有限公司 6 / 40 BC26&BC20 OneNET 应用指导 2 OneNET 数据交互机制 本章节主要介绍 OneNET 平台的数据交互机制。 TE UE OneNET平台 应用服务器 AT+CGATT? AT+MIPLCREATE AT+MIPLADDOBJ=... AT+MIPLOPEN=... URC: +MIPLEVENT: ... 10s URC: +MIPLDISCOVER: ... 超时 AT+MIPLDISCOVERRSP=... 10s URC: +MIPLPARAMETER: ... 超时 AT+MIPLPARAMETERRSP=... 10s URC: +MIPLOBSERVE: ... 超时 AT+MIPLOBSERVERSP=... 10s URC: +MIPLREAD: ... 超时 AT+MIPLREADRSP=... 10s URC: +MIPLWRITE: ... 超时 AT+MIPLWRITERSP=... 10s URC: +MIPLEXECUTE: ... 超时 AT+MIPLEXECUTERSP=... 注册请求 响应 发送发现资源请求 响应 发送写属性请求 响应 发送订阅请求 响应 发送读取请求 响应 发送写入请求 响应 发送执行请求 响应 AT+MIPLNOTIFY=... AT+MIPLUPDATE=... URC: +MIPLEVENT: ... AT+MIPLCLOSE= URC: +MIPLEVENT: ... AT+MIPLDELOBJ=... AT+MIPLDELETE= 通知OneNET平台 发送Update请求 响应 Deregister请求 响应 注册 操作 发送写属性请求 响应 发送订阅请求 响应 发送读取请求 响应 发送写入请求 响应 发送执行请求 响应 通知服务器 发现 资源 操作 写属 性 操作 订阅 操作 读取 操作 写入 操作 执行 操作 通知 操作 Update 操作 Deregister 操作 图 1：OneNET 数据交互机制 上海移远通信技术股份有限公司 7 / 40 BC26&BC20 OneNET 应用指导 3 OneNET 相关 AT 命令 本章节主要介绍操作 OneNET 功能的 AT 命令。 3.1. AT 命令类型 表 1：AT 命令类型及响应 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令或内部程序可支持的参数取值列 表或范围。 AT+? 返回相应设置命令的当前参数设置值。 AT+=[,[,[... 设置用户可自定义的参数值。 ]]] AT+ 主动执行内部程序实现的功能集。 备注 1. ：参数名称，实际命令行中不包括尖括号 < >；添加下划线'_'的参数取值为默认值； 2. [...]：可选参数，实际命令行中不包括方括号 [ ]；若无特别说明，可选参数省略时将采用默认值。 3. 若无特别说明，本文档中的 AT 命令默认立即生效。 3.2. OneNET 相关 AT 命令详解 3.2.1. AT+MIPLCONFIG OneNET 接入配置 该命令用于启用或禁用 Bootstrap 模式，以及配置 Bootstrap 服务器或者访问服务器地址。有关错误码 的说明，请参阅第 4 章。 AT+MIPLCONFIG OneNET 接入配置 测试命令 AT+MIPLCONFIG=? 响应 +MIPLCONFIG: ,[,,,] 上海移远通信技术股份有限公司 8 / 40 BC26&BC20 OneNET 应用指导 查询命令 AT+MIPLCONFIG? OK 响应 +MIPLCONFIG: ,,,, 设置命令 AT+MIPLCONFIG=,[,,,] OK 响应 OK 若出现任何错误： +CIS ERROR: 最大响应时间 300 毫秒 保存机制 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 平台的数据模式。 0 Direct push 模式 1 Buffer access 模式 整型。接收数据的格式。 0 十六进制字符串格式 1 文本字符串格式 整型。用于配置 Bootstrap 模式。 0 禁用 Bootstrap 1 启用 Bootstrap 若=0，表示访问服务器 IP 地址。 若=1，表示 Bootstrap 服务器 IP 地址。 整型。范围：1-65535。 若=0，表示访问服务器端口。 若=1，表示 Bootstrap 服务器端口。 备注 请在通过 AT+MIPLCREATE 创建通信套件实例之前执行该命令。 3.2.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 该命令用于创建 OneNET 通信套件实例。有关错误码的说明，请参阅第 4 章。 上海移远通信技术股份有限公司 9 / 40 BC26&BC20 OneNET 应用指导 AT+MIPLCREATE 创建 OneNET 通信套件实例 执行命令 响应 AT+MIPLCREATE +MIPLCREATE: OK 最大响应时间 保存机制 若出现任何错误： +CIS ERROR: 300 毫秒 / 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 3.2.3. AT+MIPLDELETE 删除 OneNET 通信套件实例 该命令用于删除 OneNET 通信套件中的实例。有关错误码的说明，请参阅第 4 章。 AT+MIPLDELETE 删除 OneNET 通信套件实例 测试命令 响应 AT+MIPLDELETE=? +MIPLDELETE: 设置命令 AT+MIPLDELETE= OK 响应 OK 最大响应时间 保存机制 若出现任何错误： +CIS ERROR: 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 上海移远通信技术股份有限公司 10 / 40 BC26&BC20 OneNET 应用指导 3.2.4. AT+MIPLVER 查询 OneNET 通信套件版本 该命令用于查询当前 OneNET 通信套件版本。 AT+MIPLVER 查询命令 AT+MIPLVER? 查询 OneNET 通信套件版本 响应 +MIPLVER: 最大响应时间 保存机制 OK 300 毫秒 / 参数 字符串类型。当前 OneNET 通信套件版本。 3.2.5. AT+MIPLADDOBJ 添加 LwM2M 对象 该命令用于添加 LwM2M 对象。有关错误码的说明，请参阅第 4 章。 AT+MIPLADDOBJ 添加 LwM2M 对象 测试命令 响应 AT+MIPLADDOBJ=? +MIPLADDOBJ: ,,,,< attrCount>, 设置命令 AT+MIPLADDOBJ=,,,,,< actCount> OK 响应 OK 若出现任何错误： +CIS ERROR: 最大响应时间 300 毫秒 保存机制 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。LwM2M 对象 ID。若对象 ID 不存在，则返回错误。 整型。实例个数。 上海移远通信技术股份有限公司 11 / 40 BC26&BC20 OneNET 应用指导 带 双 引 号 的 字 符 串 类 型 。 实 例 位 图 。 例 如 ， 若 值 为 4 、 ='1101'，则表示实例 ID 0、2、3 将被注册，而实例 ID 1 不会被注 册。 整型。属性个数，表示可读和/或可写资源的个数。 整型。动作个数，表示可执行的资源个数。 备注 1. 更多关于 LwM2M 对象 ID 的详细描述，请参考：http://www.openmobilealliance.org/wp/OMNA/LwM 2M/LwM2MRegistry.html。 2. 字符串的长度需要和取值保持一致。 3. 实际注册的实例个数由决定，而非。 3.2.6. AT+MIPLDELOBJ 删除 LwM2M 对象 该命令用于删除 LwM2M 对象。有关错误码的说明，请参阅第 4 章。 AT+MIPLDELOBJ 删除 LwM2M 对象 测试命令 响应 AT+MIPLDELOBJ=? +MIPLDELOBJ: , 设置命令 AT+MIPLDELOBJ=, OK 响应 OK 最大响应时间 保存机制 若出现任何错误： +CIS ERROR: 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。LwM2M 对象 ID。若对象 ID 不存在，则返回错误。 3.2.7. AT+MIPLRD 读取接收数据 该命令用于从缓存中读取数据。在 Buffer access 模式下，模块接收到数据以后，会缓存所接收的数据 并向外部 MCU 上报 URC +MIPLWRITE: ,,,,,,, ,。有关错误码的说明，请参阅第 4 章。 上海移远通信技术股份有限公司 12 / 40 BC26&BC20 OneNET 应用指导 AT+MIPLRD 读取接收数据 测试命令 AT+MIPLRD=? 设置命令 AT+MIPLRD= 最大响应时间 保存机制 响应 +MIPLRD: (支持的范围) OK 响应 +MIPLRD: , OK 若无数据： +MIPLRD: 0 OK 若出现任何错误： +CIS ERROR: 300 毫秒 / 参数 待读取数据长度；范围：1-512；单位：字节。 已读取数据长度；单位：字节。 剩余未读取数据长度；单位：字节。 所读取的数据。 举例 AT+MIPLRD=2 +MIPLRD: 2,0 021F OK AT+MIPLRD=4 +MIPLRD: 0 OK //从缓存中读取两字节数据。 //从缓存中读取四字节数据。 //缓存为空。 上海移远通信技术股份有限公司 13 / 40 BC26&BC20 OneNET 应用指导 备注 1. 当模块接收到新数据时，若缓存数据未读取完，则在缓存数据全部读取完毕之前不会上报新的 +MIPLWRITE URC。有关该 URC 的详细信息，请参阅第 5.4 章。 2. 剩余未读取数据长度并非全部缓存数据的总长度，仅表示某一节点的剩余未读取数据长度。 3.2.8. AT+MIPLOPEN 发送注册请求 该命令用于向 OneNET 平台发送注册请求。有关错误码的说明，请参阅第 4 章。 AT+MIPLOPEN 发送注册请求 测试命令 AT+MIPLOPEN=? 响应 +MIPLOPEN: , 设置命令 AT+MIPLOPEN=, OK 响应 OK 最大响应时间 保存机制 若出现任何错误： +CIS ERROR: 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。用于设置设备的使用期限，实际使用期限为×0.9。单位：秒。 0 3600 秒 15-268435455 3.2.9. AT+MIPLCLOSE 发送注销请求 该命令用于向 OneNET 平台发送注销请求。有关错误码的说明，请参阅第 4 章。 AT+MIPLCLOSE 发送注销请求 测试命令 AT+MIPLCLOSE=? 响应 +MIPLCLOSE: 设置命令 AT+MIPLCLOSE= OK 响应 OK 上海移远通信技术股份有限公司 14 / 40 BC26&BC20 OneNET 应用指导 最大响应时间 保存机制 参数 若出现任何错误： +CIS ERROR: 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 整型。OneNET 通信套件的实例 ID；范围：0-65535。 3.2.10. AT+MIPLDISCOVERRSP 响应发现资源请求 该命令用于响应来自 OneNET 平台的发现资源请求。有关错误码的说明，请参阅第 4 章。 AT+MIPLDISCOVERRSP 响应发现资源请求 测试命令 响应 AT+MIPLDISCOVERRSP=? +MIPLDISCOVERRSP: ,,,, 设置命令 AT+MIPLDISCOVERRSP=,,,, OK 响应 OK 若出现任何错误： +CIS ERROR: 最大响应时间 300 毫秒 保存机制 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。消息 ID；出自 URC +MIPLDISCOVER。 整型。发现资源操作结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 内容，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 上海移远通信技术股份有限公司 15 / 40 BC26&BC20 OneNET 应用指导 15 4.06 未接受 整型。参数的长度。单位：字节。 带双引号的字符串类型。包含对象的属性，每个属性之间用分号隔开，例如： '1101;1102;1103'，属性个数不应超过 AT+MIPLADDOBJ 命令的和 参数值总和。 备注 1. 有关 URC +MIPLDISCOVER 的详细信息，请参阅第 5.1 章。 2. 有关 AT+MIPLADDOBJ 的详细信息，请参阅第 3.2.5 章。 3.2.11. AT+MIPLOBSERVERSP 响应订阅请求 该命令用于响应 OneNET 平台的订阅请求。有关错误码的说明，请参阅第 4 章。 AT+MIPLOBSERVERSP 响应订阅请求 测试命令 响应 AT+MIPLOBSERVERSP=? +MIPLOBSERVERSP: ,, 设置命令 AT+MIPLOBSERVERSP=,, OK 响应 OK 若出现任何错误： +CIS ERROR: 最大响应时间 300 毫秒 保存机制 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。消息 ID；出自 URC +MIPLDISCOVER。 整型。订阅结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 内容，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 15 4.06 未接受 上海移远通信技术股份有限公司 16 / 40 备注 有关 URC +MIPLOBSERVE 的详细信息，请参阅第 5.2 章。 BC26&BC20 OneNET 应用指导 3.2.12. AT+MIPLREADRSP 响应读取请求 该命令用于响应 OneNET 平台发来的读取请求。有关错误码的说明，请参阅第 4 章。 AT+MIPLREADRSP 响应读取请求 测试命令 响应 AT+MIPLREADRSP=? +MIPLREADRSP: ,,[,,,,,,,,] 设置命令 OK 响应 AT+MIPLREADRSP=,,< result>[,,,,,,,,] OK 若出现任何错误： +CIS ERROR: 最大响应时间 300 毫秒 保存机制 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。消息 ID；出自 URC +MIPLREAD。 整型。读取结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 内容，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 15 4.06 未接受 整型。LwM2M 对象 ID；出自 URC +MIPLREAD。 整型。实例 ID，出自 URC +MIPLREAD。 整型。资源 ID；出自 URC +MIPLREAD。 整型。值的类型。 1 字符串类型 2 十六进制类型 3 整型 上海移远通信技术股份有限公司 17 / 40 BC26&BC20 OneNET 应用指导 4 浮点型 5 布尔型（Boolean） 整型。值的长度；单位：字节。 当=1 时，该参数值为字符串类型的长度，范围：0-1024。 当=2 时，该参数值为十六进制字符串类型的长度，范围： 0-512。 当=3 时，该参数值可能为 2、4 或者 8。 当=4 时，该参数值为 4。 当=5 时，该参数值为 1。 数据。 当=1 时，该参数值为带双引号的字符串类型格式，最大 1024 字节。 当=2 时，该参数值为十六进制字符串格式，最大 512 字节。 当=3 时，该参数值为整型格式。 当=4 时，该参数值为浮点型格式。 当=5 时，该参数值为布尔型格式。 整型。消息序号。若读取请求响应包含多条消息，则需发送多次 AT 命令以完成 响应。例如，若读取请求响应包含 N 条消息，则参数需从 N-1 到 0 依次 递减，AT 命令按照取值从大到小的顺序执行。=0 表示数据中最 后一条消息。 整型。消息指示；范围：0-2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 当前版本仅支持=0。 备注 1. 数据的长度应小于 512 字节。 2. 若=2，数据的长度为值的两倍。 3. 有关 URC +MIPLREAD 的详细信息，参见第 5.3 章。 3.2.13. AT+MIPLWRITERSP 响应写入请求 该命令用于响应来自 OneNET 平台的写入请求。有关错误码的说明，请参阅第 4 章。 AT+MIPLWRITERSP 响应写入请求 测试命令 响应 AT+MIPLWRITERSP=? +MIPLWRITERSP: ,, 设置命令 AT+MIPLWRITERSP=,, OK 响应 OK 上海移远通信技术股份有限公司 18 / 40 最大响应时间 保存机制 BC26&BC20 OneNET 应用指导 若出现任何错误： +CIS ERROR: 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。消息 ID；出自 URC +MIPLWRITE。 整型。写入结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 备注 有关 URC +MIPLWRITE 的详细信息，参见第 5.4 章。 3.2.14. AT+MIPLEXECUTERSP 响应执行请求 该命令用于响应来自 OneNET 平台的执行请求。有关错误码的说明，请参阅第 4 章。 AT+MIPLEXECUTERSP 响应执行请求 测试命令 响应 AT+MIPLEXECUTERSP=? +MIPLEXECUTERSP: ,, 设置命令 AT+MIPLEXECUTERSP=,, OK 响应 OK 若出现任何错误： +CIS ERROR: 最大响应时间 300 毫秒 保存机制 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 上海移远通信技术股份有限公司 19 / 40 参数 BC26&BC20 OneNET 应用指导 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。消息 ID；出自 URC +MIPLEXECUTE。 整型。执行结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示正确结果 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方式不允许 备注 有关 URC +MIPLEXECUTE 的详细信息，参见第 5.5 章。 3.2.15. AT+MIPLPARAMETERRSP 响应写属性请求 该命令用于响应来自 OneNET 平台的写属性请求。有关错误码的说明，请参阅第 4 章。 AT+MIPLPARAMETERRSP 响应写属性请求 测试命令 响应 AT+MIPLPARAMETERRSP=? +MIPLPARAMETERRSP: ,, 设置命令 AT+MIPLPARAMETERRSP=,, OK 响应 OK 若出现任何错误： +CIS ERROR: 最大响应时间 300 毫秒 保存机制 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。消息 ID；出自 URC +MIPLPARAMETER。 整型。写属性操作结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示正确结果 上海移远通信技术股份有限公司 20 / 40 BC26&BC20 OneNET 应用指导 11 4.00 12 4.01 13 4.04 14 4.05 无效请求 未授权 未找到 方式不允许 备注 有关 URC +MIPLPARAMETER 的详细信息，参见第 5.6 章。 3.2.16. AT+MIPLNOTIFY 上报数据至 OneNET 平台或应用服务器 该命令用于向 OneNET 平台或应用服务器上报数据。有关错误码的说明，请参阅第 4 章。 AT+MIPLNOTIFY 上报数据至 OneNET 平台或应用服务器 测试命令 响应 AT+MIPLNOTIFY=? +MIPLNOTIFY: ,,,,,,,,[,] 设置命令 OK 响应 AT+MIPLNOTIFY=,,,,,,,,,[,] 若出现任何错误： +CIS ERROR: 最大响应时间 300 毫秒 保存机制 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。消息 ID；出自 URC +MIPLOBSERVE。 整型。LwM2M 对象 ID。 整型。实例 ID；出自 URC +MIPLOBSERVE。 整型。资源 ID；出自 URC +MIPLOBSERVE。 整型。值的类型。 1 字符串类型 2 十六进制类型 3 整型 4 浮点型 5 布尔型（Boolean） 上海移远通信技术股份有限公司 21 / 40 BC26&BC20 OneNET 应用指导 整型。值的长度；单位：字节。 当=1 时，该参数值为字符串类型的长度，范围：0-1024。 当=2 时，该参数值为十六进制字符串类型的长度，范围： 0-512。 当=3 时，该参数值可能为 2、4 或者 8。 当=4 时，该参数值为 4。 当=5 时，该参数值为 1。 数据。 当=1 时，该参数值为带双引号的字符串类型格式。 当=2 时，该参数值为十六进制字符串格式。 当=3 时，该参数值为整型格式。 当=4 时，该参数值为浮点型格式。 当=5 是，该参数值为布尔型格式。 整型。消息序号。若待上报数据包含多条消息，则需要发送多次 AT 命令以完成 上报。例如，若待上报数据包含 N 条消息，则参数需从 N-1 到 0 依次递 减，AT 命令按照取值从大到小的顺序执行。=0 表示数据中最后 一条消息。 整型。指示消息，范围：0-2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间消息 该版本仅支持=0。 整型。范围：0-65535。 0 上报的数据为不需要确认的消息 1-65535 上报的数据为需要确认的消息 备注 1. 该命令用于上报数据，数据总长度应小于 1024 字节。若=2，数据的长度为 值的两倍。 2. 对于多个消息组成的数据来说，若其中一条消息返回错误，其前面的消息仍将会被上报。 3.2.17. AT+MIPLUPDATE 发送更新请求 该命令用于发送更新请求，以更新使用期限和对象列表。有关错误码的说明，请参阅第 4 章。 AT+MIPLUPDATE 发送更新请求 测试命令 响应 AT+MIPLUPDATE=? +MIPLUPDATE: ,, 设置命令 OK 响应 AT+MIPLUPDATE=,,< OK 上海移远通信技术股份有限公司 22 / 40 withObjectFlag> 最大响应时间 保存机制 BC26&BC20 OneNET 应用指导 若出现任何错误： +CIS ERROR: 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。更新后的设备使用期限值（实际使用期限为×0.9）。单位：秒。 0 3600 秒 15-268435455 整型。是否更新对象列表。 0 不更新 1 更新 上海移远通信技术股份有限公司 23 / 40 BC26&BC20 OneNET 应用指导 4 错误码 本章节主要介绍与 BC26 和 BC20 模块 OneNET 命令相关的错误码。 表 2：值描述 值 651 652 653 654 655 错误码描述 Memory error Parameter error Operation not supported SDK error Not found error 中文含义 内存错误 参数错误 操作不支持 SDK 错误 未找到错误 上海移远通信技术股份有限公司 24 / 40 BC26&BC20 OneNET 应用指导 5 OneNET 相关 URC 本章节主要介绍与 OneNET 相关的一系列 URC 及其描述。 表 3：OneNET 相关 URC 序号 URC 描述 [1] +MIPLDISCOVER: ,, OneNET 平台发送发现资源请求，模块接收 到请求后会立刻上报该 URC。 +MIPLOBSERVE: ,,,,, 求后会立即上报该 URC。 +MIPLREAD: ,,,, 求后会立即上报该 URC。 +MIPLWRITE: ,,,,< OneNET 平台发送写入请求，模块接收到请 [4] resId>,,,,, +MIPLEXECUTE: ,,,,[,,] 求后会立即上报该 URC。 +MIPLPARAMETER: ,,,,,, 请求后会立即上报该 URC。 +MIPLEVENT: ,[,[,]] URC。 5.1. +MIPLDISCOVER 通知 TE 响应发现资源请求 该 URC 主要用于通知 TE 响应 OneNET 平台的发现资源请求。该 URC 完全输出以后，TE 应在 10 秒 内（从 URC 输出以后开始计时）通过 AT+MIPLDISCOVERRSP 命令响应请求。 +MIPLDISCOVER 通知 TE 响应发现资源请求 URC 格式 +MIPLDISCOVER: ,, 上海移远通信技术股份有限公司 25 / 40 参数 BC26&BC20 OneNET 应用指导 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。数据包消息 ID。 整型。从 OneNET 平台接收到的 LwM2M 对象 ID。 5.2. +MIPLOBSERVE 通知 TE 响应订阅请求 该 URC 主要用来通知 TE 响应 OneNET 或者应用服务器的订阅请求。该 URC 完全输出以后，TE 应 在 10 秒内（从 URC 输出以后开始计时）通过 AT+MIPLOBSERVERSP 命令响应请求。 +MIPLOBSERVE 通知 TE 响应订阅请求 URC 格式 +MIPLOBSERVE: ,,,,, 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。数据包消息 ID。 整型。表示是否订阅 0 取消订阅 1 订阅 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。-1 表示订阅或者取消订 阅指定 LwM2M 对象下所有实例下的所有资源。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。-1 表示订阅或者取消订 阅指定实例下的所有资源。 5.3. +MIPLREAD 通知 TE 响应读取请求 该 URC 主要用来通知 TE 响应 OneNET 或者应用服务器的读取请求。该 URC 完全输出以后，TE 应 在 10 秒内（从 URC 输出以后开始计时）通过 AT+MIPLREADRSP 命令响应请求。 +MIPLREAD 通知 TE 响应读取请求 URC 格式 +MIPLREAD: ,,,, 通知 TE 响应 OneNET 或者应用服务器的读取请求。 上海移远通信技术股份有限公司 26 / 40 参数 BC26&BC20 OneNET 应用指导 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。数据包消息 ID。 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。-1 表示读取指定 LwM2M 对象下的所有资源。 整型。从 OneNET 或者应用服务器处接收到的资源 ID，-1 表示读取指定实例下 的所有资源。 5.4. +MIPLWRITE 通知 TE 响应写入请求 该 URC 主要用来通知 TE 响应 OneNET 或者应用服务器的写入请求。该 URC 完全输出以后，TE 应 在 10 秒内（从 URC 输出以后开始计时）通过命令 AT+MIPLWRITERSP 响应请求。 +MIPLWRITE 通知 TE 响应写入请求 URC 格式 +MIPLWRITE: ,,,,,,,,, 通知 TE 响应 OneNET 或者应用服务器的写入请求。 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。数据包消息 ID。 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。 整型。值的类型（当前仅显示十六进制类型。 1 字符串类型 2 十六进制类型 3 整型 4 浮点型 5 布尔型（Boolean） 整型。值的长度；单位：字节。 字符串类型。数据。从 OneNET 或者应用服务器处接收到的数据，仅在 Direct push 模式下有效。 整型。消息指示；范围：0-2。 0 表示中最后一条消息 1 表示中第一条消息 上海移远通信技术股份有限公司 27 / 40 BC26&BC20 OneNET 应用指导 2 表示中中间的消息 该版本仅支持=0。 整型。写入请求的索引号。若写入请求包含多条消息，则 URC 会被分成多个部 分进行上报。例如，若写入请求包含 N 条消息，则参数需从 N-1 到 0 依 次递减，URC 按照取值从大到小的顺序进行上报。=0 表示这是 写入请求中最后一条消息。 备注 应用服务器发送的写入请求中数据长度应小于 1024 字节，否则可能会操作失败。 5.5. +MIPLEXECUTE 通知 TE 响应执行请求 该 URC 主要用于通知 TE 响应 OneNET 或者应用服务器的执行请求。完全输出该 URC 后，TE 应在 10 秒内（从 URC 输出以后开始计时）通过命令 AT+MIPLEXECUTERSP 响应请求。 +MIPLEXECUTE 通知 TE 响应执行请求的 URC URC 格式 +MIPLEXECUTE: ,,,,[,,] 通知 TE 响应 OneNET 或者应用服务器的执行请求。 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。数据包消息 ID。 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。 整型。参数的长度；单位：字节。 字符串类型。执行操作中的。 备注 应用服务器发送的执行请求中长度（即）应小于 1024 字节，否则发送执行请求可能 会失败。 上海移远通信技术股份有限公司 28 / 40 BC26&BC20 OneNET 应用指导 5.6. +MIPLPARAMETER 通知 TE 响应写属性请求 该 URC 主要用来通知 TE 响应 OneNET 或者应用服务器的写属性请求。完全输出该 URC 后，TE 应 在 10 秒内（从 URC 输出以后开始计时）通过命令 AT+MIPLPARAMETERRSP 响应请求。 +MIPLPARAMETER 通知 TE 响应写属性请求的 URC URC 格式 +MIPLPARAMETER: ,, ,,,, 通知 TE 响应 OneNET 或者应用服务器的写属性请求。 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。数据包消息 ID。 整型。从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。 整型。从 OneNET 或者应用服务器处接收到的实例 ID。-1 表示适 用于指定对象下的所有资源。 整型。从 OneNET 或者应用服务器处接收到的资源 ID。-1 表示适 用于指定实例下的所有资源。 整型。参数的长度。 字符串类型。写属性操作中的参数。 5.7. +MIPLEVENT 向 TE 通知事件 该 URC 主要用于向 TE 通知事件。 +MIPLEVENT 向 TE 通知事件 URC 格式 +MIPLEVENT: ,[,[,]] 向 TE 通知事件。 参数 整型。OneNET 通信套件的实例 ID；范围：0-65535。 整型。事件标识符： 1 EVENT_BOOTSTRAP_START 2 EVENT_BOOTSTRAP_SUCCESS 3 EVENT_BOOTSTRAP_FAILED 上海移远通信技术股份有限公司 29 / 40 BC26&BC20 OneNET 应用指导 4 EVENT_CONNECT_SUCCESS 5 EVENT_CONNECT_FAILED 6 EVENT_REG_SUCCESS 7 EVENT_REG_FAILED 8 EVENT_REG_TIMEOUT 9 EVENT_LIFETIME_TIMEOUT 10 EVENT_STATUS_HALT 11 EVENT_UPDATE_SUCCESS 12 EVENT_UPDATE_FAILED 13 EVENT_UPDATE_TIMEOUT 14 EVENT_UPDATE_NEED 15 EVENT_DEREG_DONE 20 EVENT_RESPONSE_FAILED 21 EVENT_RESPONSE_SUCCESS 25 EVENT_NOTIFY_FAILED 26 EVENT_NOTIFY_SUCCESS 扩展参数。 =20 或者 25 响应命令的消息 ID。 =14 设备使用期限的剩余时间；单位：秒。 整型。通过 AT+MIPLNOTIFY 告知的确认消息标识符；范围：1-65535。 上海移远通信技术股份有限公司 30 / 40 BC26&BC20 OneNET 应用指导 6 举例 本章节主要通过实例解释如何使用与 OneNET 相关的 AT 命令。 6.1. 注册及发现资源操作 6.1.1. 注册 OneNET 平台 本用例展示如何注册中国移动重庆区域的 OneNET 平台；所述 OneNET 平台默认通过 Bootstrap IP 地址 183.230.40.39 连接。 AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例。 OK AT+MIPLADDOBJ=0,3311,1,'1',4,2 OK //添加 LwM2M 对象。 //成功添加对象，且将注册 ID 为 0 的实例。 AT+MIPLOPEN=0,86400 OK //向 OneNET 发送注册请求。 +MIPLEVENT: 0,1 //开始连接到 Bootstrap 服务器。 +MIPLEVENT: 0,2 //成功连接到 Bootstrap 服务器。 +MIPLEVENT: 0,4 //成功连接到 OneNET 平台。 +MIPLEVENT: 0,6 //成功注册到 OneNET 平台。 +MIPLOBSERVE: 0,69234,1,3311,0,-1 //接收到订阅请求（3311/0）。 AT+MIPLOBSERVERSP=0,69234,1 OK //响应订阅请求，其结果码为 1。 +MIPLDISCOVER: 0,26384,3311 //接收到发现资源请求。 上海移远通信技术股份有限公司 31 / 40 BC26&BC20 OneNET 应用指导 AT+MIPLDISCOVERRSP=0,26384,1,19,'5850;5851;5706;5805' //使用资源 ID 列表响应发现资源请求。 OK AT+MIPLDELOBJ=0,3311 OK //删除 LwM2M 对象。 AT+MIPLCLOSE=0 OK //向 OneNET 平台发送注销请求。 +MIPLEVENT: 0,15 //成功注销。 AT+MIPLDELETE=0 OK //成功删除通信套件实例。 6.1.2. 注册 OneNET 平台（使能 Bootstrap） 本用例展示如何注册支持 Bootstrap 模式的 OneNET 平台。 AT+MIPLCONFIG=0,1,1,'183.230.40.39',5683 //使能 Bootstrap 模式并配置 Bootstrap 服务器 IP 和端口 号。 OK AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例。 OK AT+MIPLADDOBJ=0,3311,1,'1',4,2 OK //添加 LwM2M 对象。 //成功添加对象，且将注册 ID 为 0 的实例。 AT+MIPLOPEN=0,86400 OK //向 OneNET 平台发送注册请求。 +MIPLEVENT: 0,1 //开始连接 Bootstrap 服务器。 +MIPLEVENT: 0,2 //成功连接到 Bootstrap 服务器。 +MIPLEVENT: 0,4 //成功连接到 OneNET 平台。 +MIPLEVENT: 0,6 //成功注册到 OneNET 平台。 +MIPLOBSERVE: 0,91530,1,3311,0,-1 //接收到订阅请求（3311/0）。 AT+MIPLOBSERVERSP=0,91530,1 //响应订阅请求，其结果码为 1。 上海移远通信技术股份有限公司 32 / 40 BC26&BC20 OneNET 应用指导 OK +MIPLDISCOVER: 0,25995,3311 //接收到发现资源请求。 //响应发现资源的请求。 AT+MIPLDISCOVERRSP=0,25995,1,19,'5850;5851;5706;5805' OK AT+MIPLDELOBJ=0,3311 OK //删除 LwM2M 对象。 AT+MIPLCLOSE=0 OK //向 OneNET 平台发送注销请求。 +MIPLEVENT: 0,15 //成功注销。 AT+MIPLDELETE=0 OK //成功删除通信套件实例。 6.1.3. 注册 OneNET 平台（禁用 Bootstarp） 本用例展示如何注册不支持 Bootstrap 模式的 OneNET 平台。 AT+MIPLCONFIG=0,1,0,'183.230.40.40',5683 //禁用 Bootstrap 模式并配置访问服务器 IP 和端口号。 OK AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例。 OK AT+MIPLADDOBJ=0,3311,1,'1',4,2 OK //添加 LwM2M 对象。 //添加对象成功并将注册实例 ID 0。 AT+MIPLOPEN=0,86400 OK //向 OneNET 平台发送注册请求。 +MIPLEVENT: 0,4 //成功连接到 OneNET 平台。 +MIPLEVENT: 0,6 //成功注册到 OneNET 平台。 +MIPLOBSERVE: 0,111068,1,3311,0,-1 //接收到订阅请求（3311/0）。 上海移远通信技术股份有限公司 33 / 40 BC26&BC20 OneNET 应用指导 AT+MIPLOBSERVERSP=0,111068,1 OK //响应订阅请求，其结果码为 1。 +MIPLDISCOVER: 0,45533,3311 //接收到发现资源请求。 AT+MIPLDISCOVERRSP=0,45533,1,19,'5850;5851;5706;5805' //响应发现资源的请求。 OK AT+MIPLDELOBJ=0,3311 OK //删除 LwM2M 对象。 AT+MIPLCLOSE=0 OK //向 OneNET 平台发送注销请求。 +MIPLEVENT: 0,15 //成功注销。 AT+MIPLDELETE=0 OK //成功删除通信套件实例。 6.2. 读取操作 6.2.1. 读取资源 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送读取资源（3311/0/5805）请求。 +MIPLREAD: 0,3123,3311,0,5805 //接收到读取资源请求。 AT+MIPLREADRSP=0,3123,1,3311,0,5805,4,4,1.88,0,0 OK /响应读取请求。 //成功发送数据 1.88 到应用服务器。 6.2.2. 读取实例 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送读取实例（3311/0）请求。 +MIPLREAD: 0,25466,3311,0,-1 //发送 4 条消息响应读取请求。 AT+MIPLREADRSP=0,25466,1,3311,0,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5852,3,2,123,2,0 OK //接收到读取实例请求。 上海移远通信技术股份有限公司 34 / 40 BC26&BC20 OneNET 应用指导 AT+MIPLREADRSP=0,25466,1,3311,0,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5805,4,4,1.88,0,0 OK 6.2.3. 读取对象 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送读取对象（3311）请求。 +MIPLREAD: 0,39299,3311,-1,-1 //接收到读取对象请求。 //发送 6 条消息回应读取请求。 AT+MIPLREADRSP=0,39299,1,3311,0,5851,5,1,1,5,0 OK AT+MIPLREADRSP=0,39299,1,3311,0,5852,3,2,123,4,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5805,4,4,1.88,0,0 OK 6.3. 写入操作 6.3.1. 写入资源 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送写入资源（3311/0/5706）请求，并含有字符串格式的值：hello。 +MIPLWRITE: 0,38017,3311,0,5706,2,5,68656C6C6F,0,0 //接收到写入资源请求。 AT+MIPLWRITERSP=0,38017,2 OK //响应写入请求，其结果码为 2。 上海移远通信技术股份有限公司 35 / 40 BC26&BC20 OneNET 应用指导 AT+MIPLCONFIG=1,1 OK //设置 Buffer Access 模式，接收文本字符串类型数据。 //仅显示所接收数据的长度，然后发送 AT+MIPLRD 命令读取数据。 +MIPLWRITE: 0,38018,3311,0,5706,2,5,0,0 //接收到写入资源请求。 AT+MIPLWRITERSP=0,38018,2 OK //响应写入请求，其结果码为 2。 AT+MIPLRD=5 +MIPLRD: 5,0 hello OK //从缓存中读取数据。 //已读取数据长度为 5 字节，未读取数据长度为 0 字节。 //所读取的文本字符串类型数据。 6.3.2. 写入实例 //UE 已经成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送写入实例（3311/0）请求。 +MIPLWRITE: 0,46584,3311,0,5706,2,5,68656C6C6F,0,2 //接收到写入实例请求。 +MIPLWRITE: 0,46584,3311,0,5850,2,1,01,0,1 +MIPLWRITE: 0,46584,3311,0,5851,2,8,00000002DFDC1C3E,0,0 AT+MIPLWRITERSP=0,46584,2 OK //响应写入请求，其结果码为 2。 6.4. 执行操作 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送执行请求，其中包含 Argument：reset。 +MIPLEXECUTE: 0,36476,3303,0,5605,5,'reset' //接收到执行请求。 AT+MIPLEXECUTERSP=0,36476,2 OK //响应执行请求，其结果码为 2。 上海移远通信技术股份有限公司 36 / 40 BC26&BC20 OneNET 应用指导 6.5. 写属性操作 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送写属性请求。 +MIPLPARAMETER: 0,56642,3303,0,5700,38,'pmin=2;pmax=190;gt=100.0;lt=1.0;st=0.2' //收到写属性请求。 AT+MIPLPARAMETERRSP=0,56642,2 OK //响应写属性请求，其结果码为 2。 6.6. 订阅操作 //UE 已成功注册到 OneNET 平台。 //应用服务器已经向 UE 发送订阅请求。 +MIPLOBSERVE: 0,29620,1,3311,0,-1 AT+MIPLOBSERVERSP=0,29620,1 OK //收到订阅请求。 //确认订阅请求。 6.7. 上报数据操作 6.7.1. 上报资源数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅资源（3303/0/5700）。 AT+MIPLNOTIFY=0,122179,3303,0,5700,4,4,25.6,0,0 //上报资源数据。 OK 6.7.2. 上报实例数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅实例（3303/0）。 AT+MIPLNOTIFY=0,653687,3303,0,5700,4,4,10.24,3,0 //上报实例数据。 OK AT+MIPLNOTIFY=0,653687,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5601,4,4,0.16,1,0 OK 上海移远通信技术股份有限公司 37 / 40 AT+MIPLNOTIFY=0,653687,3303,0,5602,4,4,100.86,0,0 OK BC26&BC20 OneNET 应用指导 6.7.3. 上报对象数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅对象（3303）。 //上报实例 ID 为 0 下资源的数据。 AT+MIPLNOTIFY=0,196301,3303,0,5700,4,4,9.8,3,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5602,4,4,99.8,0,0 OK //上报实例 ID 为 1 下资源的数据。 AT+MIPLNOTIFY=0,196301,3303,1,5700,4,4,0.2,3,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5601,4,4,3.2,1,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5602,4,4,100.1,0,0 OK 6.7.4. 使用上报资源数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅资源（3303/0/5701）。 AT+MIPLNOTIFY=0,307353,3303,0,5701,1,3,'Cel',0,0,255 //使用（255）上报资源数据。 OK +MIPLEVENT: 0,26,255 //上报结果。 上海移远通信技术股份有限公司 38 / 40 BC26&BC20 OneNET 应用指导 6.7.5. 使用上报实例数据 //UE 已成功注册到 OneNET 平台且应用服务器已经成功订阅实例（3303/0）。 //使用（258）通知实例数据。 AT+MIPLNOTIFY=0,487674,3303,0,5700,4,4,170.1,3,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5701,1,3,'Cel',2,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5601,4,4,106.1,1,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5602,4,4,660.9,0,0,258 OK +MIPLEVENT: 0,26,258 //上报结果。 6.8. 更新操作 //UE 已成功注册到 OneNET 平台。 AT+MIPLUPDATE=0,86400,0 OK +MIPLEVENT: 0,11 //更新设备使用期限为 86400 秒。 //更新结果。 上海移远通信技术股份有限公司 39 / 40 BC26&BC20 OneNET 应用指导 7 附录 A 参考文档及术语缩写 表 4：参考文档 序号 文档名称 IPSO Smart Object Guideline [1] (Smart Objects Starter Pack) Lightweight Machine to Machine Technical [2] Specification 备注 IPSO 联盟发布的智能设备指导标准 OMA 发布的 LwM2M 规格书 表 5：术语缩写 术语 CoAP ID IPSO LwM2M LPWA ME NB-IoT NVM RAI REST TE UE URC 英文全称 Constrained Application Protocol Identifier Internet Protocol for Smart Objects Lightweight Machine to Machine Low-Power Wide-Area Mobile Equipment Narrow Band Internet of Things Non-volatile Memory Release Assistant Indication Representational State Transfer Terminal Equipment (Typically the MCU) User Equipment (Typically the Module) Unsolicited Result Code 中文全称 受限应用协议 标识符 智能对象互联网协议 轻量级机器到机器物联网协议 低功耗广覆盖 移动设备 窄带物联网 非易失性存储器 释放辅助指示 表述性状态转移 终端设备（通常为 MCU） 用户设备（通常为模块） 非请求结果码 上海移远通信技术股份有限公司 40 / 40

BC26&BC20 TCP/IP AT 命令手册 NB-IoT 模块系列 版本：BC26&BC20_TCP/IP_AT 命令手册_V1.0 日期：2019-12-05 状态：受控文件 www.quectel.com BC26&BC20 TCP/IP AT 命令手册 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 31 BC26&BC20 TCP/IP AT 命令手册 文档历史 修订记录 版本 1.0 日期 2019-12-05 作者 变更表述 王 瑞 /蒋涛 / 初始版本 刘飞彪 上海移远通信技术股份有限公司 2 / 31 BC26&BC20 TCP/IP AT 命令手册 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 1.1. TCP/IP AT 命令简述.................................................................................................................... 5 1.2. 数据访问模式说明 ....................................................................................................................... 5 2 TCP/IP AT 命令详解 .............................................................................................................................. 6 2.1. 定义 ............................................................................................................................................. 6 2.2. AT 命令类型 ................................................................................................................................ 6 2.3. AT 命令详解 ................................................................................................................................ 7 2.3.1. AT+QIOPEN 打开 Socket.............................................................................................. 7 2.3.2. AT+QICLOSE 关闭 Socket............................................................................................ 8 2.3.3. AT+QISTATE 查询 Socket 状态 .................................................................................... 9 2.3.4. AT+QISEND 发送十六进制/文本字符串数据............................................................... 10 2.3.5. AT+QIRD 读取 TCP/IP 数据........................................................................................ 12 2.3.6. AT+QISENDEX 发送十六进制字符串数据 .................................................................. 13 2.3.7. AT+QISWTMD 切换数据访问模式 .............................................................................. 14 2.3.8. AT+QPING Ping 远程服务器 ....................................................................................... 15 2.3.9. AT+QNTP 通过 NTP 服务器同步本地时间.................................................................. 16 2.3.10. AT+QIDNSGIP 转换域名为 IP 地址............................................................................. 17 2.3.11. AT+QIDNSCFG 配置 DNS 服务器地址....................................................................... 18 2.3.12. AT+QICFG 配置可选参数............................................................................................ 19 2.3.13. AT+QIGETERROR 查询上一个错误码 ....................................................................... 21 2.4. URC 详解 .................................................................................................................................. 22 2.4.1. 连接断开 URC ................................................................................................................ 22 2.4.2. 下行数据已达 URC......................................................................................................... 23 2.4.3. 下行数据缓存已满 URC.................................................................................................. 23 3 错误码 .................................................................................................................................................. 24 4 举例 ...................................................................................................................................................... 26 4.1. TCP 客户端在缓存模式下工作 .................................................................................................. 26 4.1.1. 创建一个 TCP 客户端连接并进入缓存模式 .................................................................... 26 4.1.2. 在缓存模式下发送数据 ................................................................................................... 26 4.1.3. 在缓存模式下从远程服务器上读取数据.......................................................................... 27 4.1.4. 断开连接 ......................................................................................................................... 28 4.2. TCP 客户端在直吐模式下工作 .................................................................................................. 28 4.2.1. 创建一个 TCP 客户端连接并进入直吐模式 .................................................................... 28 4.2.2. 在直吐模式下发送数据 ................................................................................................... 28 4.2.3. 在直吐模式下接收来自远程服务器的数据 ...................................................................... 29 4.2.4. 断开连接 ......................................................................................................................... 29 上海移远通信技术股份有限公司 3 / 31 BC26&BC20 TCP/IP AT 命令手册 4.3. Ping 远程服务器 ........................................................................................................................ 29 4.4. 同步本地时间............................................................................................................................. 30 4.5. 配置 DNS 服务器....................................................................................................................... 30 4.6. 查询上一个错误码 ..................................................................................................................... 30 5 附录 A 术语缩写 .................................................................................................................................. 31 上海移远通信技术股份有限公司 4 / 31 BC26&BC20 TCP/IP AT 命令手册 表格索引 表 1：AT 命令类型及响应 .................................................................................................................................... 6 表 2：错误码列表............................................................................................................................................... 24 表 3：术语缩写 .................................................................................................................................................. 31 上海移远通信技术股份有限公司 4 / 31 BC26&BC20 TCP/IP AT 命令手册 1 引言 移远通信 BC26 和 BC20 模块均内置 TCP/IP 协议栈，可直接通过 AT 命令访问网络；这大大降低模块 对 PPP 以及外部 TCP/IP 协议栈的依赖，从而降低终端设计的成本。 BC26 和 BC20 模块可提供 TCP 客户端、UDP 客户端等套接字（Socket）服务。 1.1. TCP/IP AT 命令简述 通过 TCP/IP AT 命令，模块可以打开/关闭 Socket，并通过 Socket 收发数据。 1.2. 数据访问模式说明 BC26 和 BC20 模块支持如下两种数据访问模式：  缓存模式  直吐模式 当通过 AT+QIOPEN 打开 Socket 时，可以通过参数指定数据访问模式。成功打开 Socket 后，可以通过 AT+QISWTMD 切换数据访问模式。两种数据访问模式下，均可通过 AT+QISEND 或 AT+QISENDEX 发送数据。 1. 缓 存 模 式 下 ， 模 块 接 收 到 数 据 时 ， 会 先 缓 存 所 接 收 的 数 据 并 上 报 URC +QIURC: 'recv',[,]，之后可通过 AT+QIRD 读取缓存数据。 2. 直吐模式下，模块接收到数据时，会通过上报的 URC +QIURC: 'recv',,直接输出数据。 备注 缓存模式下，在缓存数据被全部读取完之前，模块不会再上报新的 URC 通知 MCU 收到下行数据。 上海移远通信技术股份有限公司 5 / 31 BC26&BC20 TCP/IP AT 命令手册 2 TCP/IP AT 命令详解 本章节主要描述和 TCP/IP 相关的 AT 命令。 2.1. 定义  ：回车符；  ：换行符；  ：参数名称，实际命令行中不包括尖括号 < >；添加下划线'_'的参数取值为默认值；  [...]：可选参数，实际命令行中不包括方括号 [ ]；若无特别说明，可选参数省略时将采用默认值。 2.2. AT 命令类型 表 1：AT 命令类型及响应 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令或内部程序可支持的参数取值列表 或范围。 AT+? 返回相应设置命令的当前参数设置值。 AT+=[,[,[ 设置用户可自定义的参数值。 ...]]] AT+ 主动执行内部程序实现的功能集。 备注 若无特别说明，本文档中的 AT 命令默认立即生效。 上海移远通信技术股份有限公司 6 / 31 BC26&BC20 TCP/IP AT 命令手册 2.3. AT 命令详解 2.3.1. AT+QIOPEN 打开 Socket 该命令用于打开 Socket 以创建 TCP/UDP 连接；可通过参数指定服务类型，并通过参 数指定数据访问模式。命令执行成功以后，会上报 URC +QIOPEN: , 通知 Socket 是否成功打开。 AT+QIOPEN 打开 Socket 测试命令 AT+QIOPEN=? 响应 +QIOPEN: (支持的范围),(支持的 范围),'TCP/UDP','/',,,(支持的列表)[,(支持 的列表)] OK 设置命令 响应 AT+QIOPEN=,,,'/',[,[,][,]] OK +QIOPEN: , 若有任何错误： ERROR 最大响应时间 300 毫秒 保存机制 /、、 、和参数配置 不保存至 NVRAM；深休眠唤醒后仍有效 参数 整型。场景 ID；范围：1-3。 整型。Socket ID；范围：0-4。 字符串类型。Socket 服务类型。 'TCP' 客户端创建 TCP 连接 'UDP' 客户端创建 UDP 连接 字符串类型。远程服务器的 IP 地址，例如：220.18.23.22。最大长度：150 字节。 字符串类型。远程服务器的域名地址。最大长度：150 字节。 整型。远程服务器的端口号；范围：1-65535。 整型。本地端口号。 0 1-65535 自动分配本地端口号 指定的本地端口号 整型。Socket 的数据访问模式。 上海移远通信技术股份有限公司 7 / 31 BC26&BC20 TCP/IP AT 命令手册 0 缓存模式 1 直吐模式 整型。互联网协议类型。 0 IPv4 1 IPv6 备注 1. 目前仅支持=1。 2. URC +QIOPEN: ,上报的超时时间为 60 秒，请在 URC 上报完成后再进行其他操 作。 3. 如果 TCP/UDP 连接创建失败，需执行 AT+QICLOSE=以关闭当前 Socket。 4. 模块开机后，需等 IP 地址 URC（例如：+IP: 10.18.237.42，表明模块注网成功）上报完成后方可执 行该命令。 5. TCP 会话创建后，模块将无法进入深休眠（Deep Sleep）模式。TCP 连接关闭后，模块方可如期进 入深休眠模式。 6. UDP 会话创建后，模块会自动备份最新 UDP 配置信息，MCU 可以在唤醒后直接收发数据。 2.3.2. AT+QICLOSE 关闭 Socket 该命令用于关闭指定的 Socket。 AT+QICLOSE 关闭 Socket 测试命令 AT+QICLOSE=? 响应 +QICLOSE: (支持的范围) 设置命令 AT+QICLOSE= OK 响应 若成功关闭： OK CLOSE OK 最大响应时间 保存机制 若有任何错误： ERROR 300 毫秒 / 参数 整型。Socket ID；范围：0-4。 上海移远通信技术股份有限公司 8 / 31 BC26&BC20 TCP/IP AT 命令手册 2.3.3. AT+QISTATE 查询 Socket 状态 该命令用于查询 Socket 状态。 AT+QISTATE 查询 Socket 状态 测试命令 AT+QISTATE=? 查询命令 AT+QISTATE? 响应 OK 响应 返回所有现存连接的状态： [+QISTATE: ,,/ ,,,,,] […] OK 设置命令 若为 0，查询指定场景的 连接状态 AT+QISTATE=, 若有任何错误： ERROR 响应 返回指定场景里所有现存连接的状态： [+QISTATE: ,,/ ,,,,,] […] OK 设置命令 若为 1，查询指定 Socket 的连接状态 AT+QISTATE=, 若有任何错误： ERROR 响应 返回指定 Socket 的连接状态： [+QISTATE: ,,/ ,,,,,] OK 最大响应时间 保存机制 若有任何错误： ERROR 300 毫秒 / 上海移远通信技术股份有限公司 9 / 31 BC26&BC20 TCP/IP AT 命令手册 参数 整型。查询类型。 0 查询指定的连接状态 1 查询指定的连接状态 整型。场景 ID；范围：1-3。 整型。Socket ID；范围：0-4。 字符串类型。Socket 服务类型。 'TCP' 客户端创建 TCP 连接 'UDP' 客户端创建 UDP 连接 字符串类型。远程客户端的 IP 地址。 字符串类型。远程服务器的域名地址。 整型。远程服务器的端口号。 整型。分配的本地端口号。 整型。Socket 状态。 0 'Initial'：客户端连接尚未建立 1 'Connecting'：客户端正在连接 2 'Connected'：客户端连接已经创建成功 3 'Closing'：客户端连接正在关闭 4 'Remote Closing'：远程服务器正在关闭客户端连接 整型。数据访问模式。 0 缓存模式 1 直吐模式 备注 1. 目前仅支持=1。 2. 若响应中无+QISTATE: 列表，则说明当前没有连接。 2.3.4. AT+QISEND 发送十六进制/文本字符串数据 该命令用于通过指定连接发送十六进制或文本字符串格式的 Socket 数据。 AT+QISEND 发送十六进制/文本字符串数据 测试命令 AT+QISEND=? 响应 +QISEND: (支持的范围),(支持的范围), 设置命令 AT+QISEND=,, OK 响应 若数据发送成功： OK 上海移远通信技术股份有限公司 10 / 31 BC26&BC20 TCP/IP AT 命令手册 SEND OK 若数据发送失败： OK SEND FAIL 设置命令 数据模式下发送不定长数据 AT+QISEND= 响应 > 后，模块将进入数据模式；之后 可直接输入待发数据，按 Ctrl+Z 发送数 据，按 Esc 取消发送。 若有任何错误： ERROR 响应 若数据发送成功： OK SEND OK 若数据发送失败： OK SEND FAIL 设置命令 数据模式下发送定长数据 AT+QISEND=, 响应 > 后，模块将进入数据模式；之后 输 入 长 度 等 于 的 待 发 数 据。 若有任何错误： ERROR 响应 若数据发送成功： OK SEND OK 若数据发送失败： OK SEND FAIL 设置命令 查询已应答和已发送但未应答数据的总 长 度 （ 包 含 通 过 AT+QISENDEX 和 AT+QISEND 发送的全部数据） AT+QISEND=,0 若有任何错误： ERROR 响应 +QISEND: ,, OK 若有任何错误： ERROR 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 11 / 31 BC26&BC20 TCP/IP AT 命令手册 保存机制 / 参数 整型。Socket ID；范围：0-4。 整型。待发数据长度，单位：字节。 在非数据模式（普通模式）下，文本格式数据的最大长度 1024 字节，十六进制格式数 据的最大长度是 512 字节。 在数据模式下，文本格式数据的最大长度是 1460 字节，十六进制格式数据的最大长度 是 730 字节。 字符串类型。待发送的十六进制或文本格式数据。 整型。通过会话已发送数据的总长度；单位：字节。 整型。远程服务器已应答数据的总长度；仅 TCP 会话时可用。 整型。已发送但是还未被远程服务器应答的数据总长度；仅 TCP 会话时可用。 备注 1. SEND OK 仅表示数据已经发送至协议栈。 2. 参数的值和的实际长度必须一致。 3. 为特殊格式（如 JSON）字符时，必须为带双引号的字符串。目前，不支持特殊命令字 符，如分号（;）。 4. MCU 应在收到 SEND OK 或者 SEND FAIL 响应后再继续发送下一条数据。 2.3.5. AT+QIRD 读取 TCP/IP 数据 该命令用于读取从指定连接接收的 Socket 数据。 在 缓 存 模 式 下 ， 模 块 接 收 到 数 据 后 会 先 缓 存 数 据 ， 并 向 外 部 MCU 上 报 URC +QIURC: 'recv',[,]以告知接收到新的下行数据。 AT+QIRD 读取 TCP/IP 数据 测试命令 AT+QIRD=? 响应 +QIRD: (支持的范围),(支持的 范围) 设置命令 AT+QIRD=, OK 响应 若指定连接收到数据： +QIRD: [,] OK 上海移远通信技术股份有限公司 12 / 31 最大响应时间 保存机制 BC26&BC20 TCP/IP AT 命令手册 若没有收到数据： +QIRD: 0 OK 若有任何错误： ERROR 300 毫秒 / 参数 整型。Socket ID；范围：0-4。 整型。待读取数据的最大长度；范围：1-512；单位：字节。 整型。已读取数据的长度；单位：字节。 整型。剩余数据的长度；单位：字节。 已读取的数据。 备注 1. 接收缓存池仍有数据未读取时，模块若再接收到下行数据将不会上报新的 URC；只有当缓存池中所 有数据均被读取完成后，才会上报新的 URC。 2. 配置 AT+QICFG='showlength',1（详情请参考第 2.1.12 章节）后，模块才会在缓存模式下显示该 命令返回值中的可选参数。 3. 剩余数据长度并非缓存池中已接收数据的总长度，仅表示某一个节点中保存的当前剩余数据数据。 2.3.6. AT+QISENDEX 发送十六进制字符串数据 该命令用于通过指定连接发送十六进制字符串 Socket 数据。 AT+QISENDEX 发送十六进制字符串数据 测试命令 AT+QISENDEX=? 响应 +QISENDEX: ( 支 持 的 范 围 ),( 支 持 的 范围), 设置命令 AT+QISENDEX=,, OK 响应 若数据发送成功： OK SEND OK 上海移远通信技术股份有限公司 13 / 31 最大响应时间 保存机制 若数据发送失败： OK SEND FAIL 若有任何错误： ERROR 300 毫秒 / BC26&BC20 TCP/IP AT 命令手册 参数 整型。Socket ID；范围：0-4。 整型。待发数据的长度，最大长度为 512 字节。 字符串类型。待发送数据。 备注 1. SEND OK 仅表示数据已经发送至协议栈。 2. MCU 应在收到 SEND OK 或者 SEND FAIL 响应后再继续发送下一条数据。 2.3.7. AT+QISWTMD 切换数据访问模式 打开新 Socket 时，模块可通过 AT+QIOPEN 的参数指定数据访问模式；之后可通过 此命令切换数据访问模式。 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应 +QISWTMD: ( 支 持 的 范 围 ),( 支 持 的 列表) 查询命令 AT+QISWTMD? 设置命令 AT+QISWTMD=, OK 响应 OK 响应 OK 若有任何错误： ERROR 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 14 / 31 BC26&BC20 TCP/IP AT 命令手册 保存机制 参数配置不保存至 NVRAM；深休眠唤醒后仍有效 参数 整型。Socket ID；范围：0-4。 整型。Socke 的数据访问模式。 0 缓存模式 1 直吐模式 2.3.8. AT+QPING Ping 远程服务器 该命令用于测试主机设备的 IP 地址是否可达。 AT+QPING Ping 远程服务器 测试命令 AT+QPING=? 响应 +QPING: ( 支 持 的 范 围 ),''[,( 支 持 的 范 围 )[,( 支 持 的 列 表 )[,( 支 持 的 列表)]]] 设置命令 AT+QPING=,''[,[,[,]]] OK 响应 若远程服务器 Ping 成功： OK +QPING: [,,,,] […] +QPING: [,,,,,,] 最大响应时间 保存机制 若有任何错误： ERROR 300 毫秒 / 参数 整型。场景 ID；范围：1-3。 字符串类型。远程服务器地址，格式为域名或者点分十进制 IP 地址。最大长度：150 字 上海移远通信技术股份有限公司 15 / 31 BC26&BC20 TCP/IP AT 命令手册 节。 整型。每次 Ping 请求后等待响应的最大时长；范围：1-255；默认值：4；单位：秒。 整型。发送 Ping 请求最大次数；范围：1-10；默认值：4。 整型。每次 Ping 请求的大小；范围：32-200；默认值：32；单位：字节。 整型。每次 Ping 请求的结果。 0 其他 接收到远程服务器的 Ping 响应 错误码；请参考第 3 章获取详细错误码信息 字符串类型。远程服务器的 IP 地址，格式为点分十进制。 整型。每次发送的 Ping 请求长度；单位：字节。 整型。发送 Ping 请求花费的时间；单位：毫秒。 整型。Ping 请求的 TTL 值。 整型。Ping 操作的最终结果。 0 其他 Ping 成功 错误码；请参考第 3 章获取详细错误码信息 整型。Ping 请求发送的字节总长度。 整型。Ping 响应中接收到的字节总长度。 整型。Ping 请求中丢失的字节总长度。 整型。最小响应时间；单位：毫秒。 整型。最大响应时间；单位：毫秒。 整型。平均响应时间；单位：毫秒。 备注 目前仅支持=1、不支持 IPv6。 2.3.9. AT+QNTP 通过 NTP 服务器同步本地时间 该命令通过 NTP 服务器同步本地时间为世界标准时间（UTC）。有关错误码的说明，请参阅第 3 章。 AT+QNTP 通过 NTP 服务器同步本地时间 测试命令 AT+QNTP=? 响应 +QNTP: (支持的范围),''[,[,(支 持的列表)]] 设置命令 AT+QNTP=,''[,< port>[,]] OK 响应 若同步成功： OK +QNTP: , 上海移远通信技术股份有限公司 16 / 31 BC26&BC20 TCP/IP AT 命令手册 最大响应时间 保存机制 若有任何错误： ERROR 300 毫秒 / 参数 整型。场景 ID；范围：1-3。 字符串类型。NTP 服务器地址，格式为域名或者点分十进制 IP 地址。最大长度：150 字节。 整型。NTP 服务器端口号；默认值：123。 整型。是否自动同步本地时间为 UTC。 0 不自动同步 1 自动同步 字符串类型。从 NTP 服务器上同步的时间。 格式为：'YY/MM/DD,hh:mm:ss±zz'，各字符分别表示年（YY）、月（MM）、日（DD）、 时（hh）、分（mm）、秒（ss）、时区（±zz）。±zz 的范围为-47 ~ +48。 备注 1. 目前仅支持=1。 2. 当=1，RTC 会自动更新到同步时间；随后可使用 AT+QCCLK?查询更新后的时间。 3. 注网成功后，模块会自动更新 RTC 时间。 2.3.10. AT+QIDNSGIP 转换域名为 IP 地址 该命令用于将指定域名转换为 IP 地址。有关错误码的说明，请参阅第 3 章。 AT+QIDNSGIP 转换域名为 IP 地址 测试命令 AT+QIDNSGIP=? 响应 +QIDNSGIP: (支持的范围),' ' 设置命令 AT+QIDNSGIP=,'' OK 响应 OK +QIURC: 'dnsgip',,, [+QIURC: 'dnsgip',] […] 上海移远通信技术股份有限公司 17 / 31 BC26&BC20 TCP/IP AT 命令手册 最大响应时间 保存机制 若有任何错误： ERROR 300 毫秒 / 参数 整型。场景 ID；范围：1-3。 字符串类型。域名。最大长度：150 字节。 整型。参数对应的 IP 地址个数。 整型。DNS 的 TTL 值。 字符串类型。的 IP 地址。 备注 目前仅支持=1 2.3.11. AT+QIDNSCFG 配置 DNS 服务器地址 该命令用于配置主要和次要 DNS 服务器地址。 AT+QIDNSCFG 配置 DNS 服务器地址 测试命令 AT+QIDNSCFG=? 响应 +QIDNSCFG: (支持的范围),, 设置命令 配置主要和次要 DNS 服务器地址 AT+QIDNSCFG=,[,] 设置命令 DNS 服务器地址成功配置后，查询主要 和次要 DNS 服务器地址 AT+QIDNSCFG= OK 响应 OK 若有任何错误： ERROR 响应 [+QIDNSCFG: ,[,]] OK 若有任何错误： 上海移远通信技术股份有限公司 18 / 31 BC26&BC20 TCP/IP AT 命令手册 最大响应时间 保存机制 ERROR 300 毫秒 和参数配置不保存至 NVRAM； 深休眠唤醒后仍有效 参数 整型。场景 ID；范围：1-3。 字符串类型。主要 DNS 服务器的 IP 地址。最大长度：64 字节。 字符串类型。次要 DNS 服务器的 IP 地址。最大长度：64 字节。 备注 1. 目前仅支持=1。 2. 若网络仅支持 IPv4，则只能设置 IPv4 DNS 地址；若网络仅支持 IPv6，则只能设置 IPv6 DNS 地址。 3. 模块开机后，需等 IP 地址 URC（例如：+IP: 10.18.237.42，表明模块注网成功）上报完成后方可配 置 DNS 服务器地址。 2.3.12. AT+QICFG 配置可选参数 该命令可为 TCP/IP 各项功能配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应 +QICFG: 'dataformat',( 支 持 的 列 表),(支持的列表) +QICFG: 'viewmode',(支持的列表) +QICFG: 'showlength',( 支 持 的 列 表) +QICFG: 'echomode',(支持的列表) 设置命令 设置发送/接收数据的格式 AT+QICFG='dataformat'[,,] OK 响应 若缺省参数和，则 查询当前配置： +QICFG: 'dataformat',, OK 若不缺省参数和， 则设置发送数据格式和接收数据格式： 上海移远通信技术股份有限公司 19 / 31 BC26&BC20 TCP/IP AT 命令手册 OK 设置命令 设置已接收数据的输出格式 AT+QICFG='viewmode'[,] 若有任何错误： ERROR 响应 若缺省参数，则查询当前配置： +QICFG: 'viewmode', OK 若不缺省参数，则设置已接收数据的输出格式： OK 设置命令 设置在缓存模式下是否显示可选数据长 度参数 1) AT+QICFG='showlength'[,] 若有任何错误： ERROR 响应 若缺省参数，则查询当前配置： +QICFG: 'showlength', OK 若不缺省参数，则设置在缓存模式下是 否显示可选数据长度参数： OK 设置命令 设置在数据模式下是否向 UART 回显输 入数据 AT+QICFG='echomode'[,] 若有任何错误： ERROR 响应 若缺省参数，则查询当前配置： +QICFG: 'echomode', OK 若不缺省参数，则设置回显模式： OK 最大响应时间 保存机制 若有任何错误： ERROR 300 毫秒 1. 、、 和参数配置自动保 存至 NVRAM；深休眠唤醒后仍有效。 2. 参数配置不保存至 NVRAM；深休眠唤醒后 上海移远通信技术股份有限公司 20 / 31 无效。 BC26&BC20 TCP/IP AT 命令手册 参数 整型。发送数据的格式。 0 文本格式 1 十六进制格式 整型。接收数据的格式。 0 文本格式 1 十六进制格式 整型。已接收数据的输出格式。 0 已接收数据输出格式：data headerrndata 1 已接收数据输出格式：data header,data 整型。在缓存模式下是否显示可选数据长度参数 1)。 0 不显示 1 显示 整型。是否在数据模式下向 UART 回显输入数据。 0 不回显 1 回显 备注 1. 1) 所述可选数据长度参数包含：  下行数据已达 URC +QIURC: 'recv',[,]中的参数；  AT+QIRD 命令返回值中的参数。 2. 参数仅在数据模式下才有效，且仅 BC26NxR01A07/BC20NxR01A08 及之后的版本中 才支持该参数。 2.3.13. AT+QIGETERROR 查询上一个错误码 该命令用于查询上一个 TCP/IP 命令返回的错误码及其相应描述。有关错误码的说明，请参阅第 3 章。 AT+QIGETERROR 查询上一个错误码 测试命令 响应 AT+QIGETERROR=? 执行命令 OK 响应 AT+QIGETERROR +QIGETERROR: , OK 上海移远通信技术股份有限公司 21 / 31 最大响应时间 参数 若有任何错误： ERROR 300 毫秒 BC26&BC20 TCP/IP AT 命令手册 字符串类型。详细的错误码描述，具体请参考第 3 章。 2.4. URC 详解 TCP/IP AT 命令的 URC 统一以+QIURC: […]的格式上报。本文中 URC 前后的均将省略。 备注 1. 当模块在 PSM 模式下，不会上报 URC。 2. 当模块 Modem 在 DRX 或者 eDRX 模式下，URC 上报会有延迟，延迟时间依据寻呼周期而定。 3. 当模块 Modem 在连接状态下，会正常上报 URC。 4. URC 最大长度为 1400 字节。 5. 使用 UDP 直吐模式接收数据时，模块将丢弃总长度大于 1400 字节的 URC。 2.4.1. 连接断开 URC 当 TCP Socket 被 远 程 关 闭 或 者 因 为 网 络 异 常 而 断 开 时 ， 模 块 将 上 报 URC +QIURC: 'closed',，同时参数（表示 Socket 状态）变为'Closing'；此时必须执行 AT+QICLOSE=将设置为'Initial'。 在缓存模式下，模块也可以执行命令 AT+QIRD=,以读取缓存数据。 连接断开 URC +QIURC: 'closed', 表示 Socket 连接被断开 参数 整型。Socket ID；范围：0-4。 上海移远通信技术股份有限公司 22 / 31 BC26&BC20 TCP/IP AT 命令手册 2.4.2. 下行数据已达 URC 当模块接收到下行数据时，会上报该 URC：  在缓存模式下，URC 格式为+QIURC: 'recv',[,]；  在直吐模式下，URC 格式为+QIURC: 'recv',, 。 下行数据已达 URC +QIURC: 'recv',,[] +QIURC: 'recv',, 表示缓存模式下有下行数据 表示直吐模式下有下行数据 参数 整型。Socket ID；范围：0-4。 整型。实际接收到的数据长度。 接收到的数据。 备注 配置 AT+QICFG='showlength',1（详情请参考第 2.1.12 章节）后，缓存模式下上报的下行数据已达 URC 才会包含可选参数。 2.4.3. 下行数据缓存已满 URC 在缓存模式下，如果已经没有缓存资源可以分配给下行数据，模块会上报该 URC。 下行数据缓存已满 URC +QIURC: 'recv',,'buff full' 表示下行数据缓存已满。 参数 整型。Socket ID；范围：0-4。 备注 缓存模式下，数据可分配的最大节点数为 20。 上海移远通信技术股份有限公司 23 / 31 BC26&BC20 TCP/IP AT 命令手册 3 错误码 执行 TCP/IP AT 命令后若有返回 ERROR 或，则具体的错误码信息可通过 AT+QIGETERROR 命令查询。AT+QIGETERROR 仅返回最后一个 TCP/IP AT 命令的错误码。 表 2：错误码列表 错误码 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 错误码描述 Operation successful Unknown error Operation blocked Invalid parameters Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy DNS parse failed 含义 操作成功 未知原因 操作受阻 无效参数 内存不足 创建 Socket 失败 操作不支持 Socket 绑定失败 Socket 监听失败 Socket 写入失败 Socket 读取失败 Socket 接受失败 打开 PDP 场景失败 关闭 PDP 场景失败 Socket ID 被占用 DNS 繁忙 NDS 解析失败 上海移远通信技术股份有限公司 24 / 31 566 Socket connection failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel send 572 Operation not allowed 573 APN not configured 574 Port busy BC26&BC20 TCP/IP AT 命令手册 Socket 连接失败 Socket 已被关闭 操作繁忙 操作超时 PDP 场景发生故障 取消发送 操作不允许 未配置 APN 端口繁忙 上海移远通信技术股份有限公司 25 / 31 BC26&BC20 TCP/IP AT 命令手册 4 举例 4.1. TCP 客户端在缓存模式下工作 4.1.1. 创建一个 TCP 客户端连接并进入缓存模式 //打开一个 Socket：场景 ID 为 1、Socket ID 为 0。 AT+QIOPEN=1,0,'TCP','220.180.239.212',8062,1234,0 OK +QIOPEN: 0,0 //连接成功，建议等 URC 上报（超时时间：60 秒）后再进行其他操作。 AT+QISTATE=1,0 //查询当前 Socket（Socket ID 为 0）的连接状态。 +QISTATE: 0,'TCP','220.180.239.212',8062,1234,2,1,0 OK 4.1.2. 在缓存模式下发送数据 AT+QISEND=0,10,1234567890 OK SEND OK AT+QISEND=0 > 1234567890 OK SEND OK AT+QISEND=0,10 > 1234567890 OK SEND OK //发送数据，数据长度为 10 字节。 //发送不定长数据。 //发送定长数据，数据长度为 10 字节。 上海移远通信技术股份有限公司 26 / 31 BC26&BC20 TCP/IP AT 命令手册 AT+QISENDEX=0,5,'3031323334' OK SEND OK //发送十六进制字符串数据。 4.1.3. 在缓存模式下从远程服务器上读取数据 +QIURC: 'recv',0 //ID 为 0 的 Socket 接收到下行数据。 AT+QIRD=0,512 +QIRD: 10 1234567890 //读取 512 字节数据。 //实际读取的数据长度为 10 字节。 //所读取的数据内容。 OK AT+QIRD=0,512 +QIRD: 0 //读取数据，数据长度为 512 字节。 //无缓存数据。 OK AT+QICFG='showlength',1 OK //使能在缓存模式下显示可选参数 和。 +QIURC: 'recv',0,12 //ID 为 0 的 Socket 接收到 12 字节下行数据。 AT+QIRD=0,10 +QIRD: 10,2 1234567890 //读取 10 字节数据。 //已读取 10 字节数据，剩余还有 2 字节未读取。 OK +QIURC: 'recv',0,'buff full' //ID 为 0 的 Socket 上报缓存已满，模块需要使用 AT+QIRD 读取 缓存数据。 AT+QICFG='viewmode',1 OK //已接收数据的输出格式：data header,data。 AT+QISEND=0,12,'012345678901' OK SEND OK 上海移远通信技术股份有限公司 27 / 31 +QIURC: 'recv',0,12 AT+QIRD=0,10 +QIRD: 10,2,0123456789 OK 4.1.4. 断开连接 AT+QICLOSE=0 OK //断开 ID 为 0 的 Socket 连接。 CLOSE OK BC26&BC20 TCP/IP AT 命令手册 4.2. TCP 客户端在直吐模式下工作 4.2.1. 创建一个 TCP 客户端连接并进入直吐模式 //打开一个 Socket：场景 ID 为 1、Socket ID 为 0。 AT+QIOPEN=1,0,'TCP','220.180.239.212',8062,0,1 OK +QIOPEN: 0,0 //连接成功，建议等 URC 上报（超时时间：60 秒）后再进行其他操作。 AT+QISTATE=1,0 //查询当前 Socket（Socket ID 为 0）的连接状态。 +QISTATE: 0,'TCP','220.180.239.212',8062,0,2,1,1 OK 4.2.2. 在直吐模式下发送数据 AT+QISEND=0,5,12345 OK SEND OK AT+QISEND=0 > 12345 OK SEND OK //发送数据，数据长度为 5 字节。 //发送不定长数据。 上海移远通信技术股份有限公司 28 / 31 AT+QISEND=0,5 > 12345 OK SEND OK AT+QISENDEX=0,5,'3132333435' OK SEND OK BC26&BC20 TCP/IP AT 命令手册 //发送定长数据，数据长度为 5 字节。 //发送十六进制字符串数据。 4.2.3. 在直吐模式下接收来自远程服务器的数据 +QIURC: 'recv',0,5 12345 //ID 为 0 的 Socket 接收到 5 字节下行数据。 //所接收到的数据。 AT+QICFG='viewmode',1 OK //已接收数据的输出格式：data header,data。 AT+QISEND=0,12,'012345678901' OK SEND OK +QIURC: 'recv',0,12,'012345678901' 4.2.4. 断开连接 AT+QICLOSE=0 OK //断开 ID 为 0 的 Socket 连接。 CLOSE OK 4.3. Ping 远程服务器 AT+QPING=1,'iot.quectel.com' OK +QPING: 0,'47.100.63.174',32,560,88 上海移远通信技术股份有限公司 29 / 31 +QPING: 0,'47.100.63.174',32,220,88 +QPING: 0,'47.100.63.174',32,230,88 +QPING: 0,'47.100.63.174',32,280,88 +QPING: 0,4,4,0,220,560,322 BC26&BC20 TCP/IP AT 命令手册 4.4. 同步本地时间 AT+QNTP=1,'ntp5.aliyun.com' OK //使用域名为 ntp5.aliyun.com 的 NTP 服务器同步本地时间。 +QNTP: 0,'19/06/11,11:08:20:35+32' 4.5. 配置 DNS 服务器 AT+QIDNSCFG=1,'218.2.2.2','8.8.8.8' OK AT+QIDNSCFG=1 +QIDNSCFG: 1,'218.2.2.2','8.8.8.8' OK 4.6. 查询上一个错误码 AT+QIOPEN=1,'UDP','220.180.239.212',8063,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552,invalid parameters OK //打开任意一个 Socket。 上海移远通信技术股份有限公司 30 / 31 BC26&BC20 TCP/IP AT 命令手册 5 附录 A 术语缩写 表 3：术语缩写 术语 英文全称 eDRX extended Discontinuous Reception DNS Domain Name System DRX Discontinuous Reception ID Identifier IP Internet Protocol IPv4 Internet Protocol version 4 IPv6 Internet Protocol version 6 MCU Micro Controller Unit ME Mobile Equipment NB-IoT Narrow Band Internet of Things NTP Network Time Protocol PPP Point to Point Protocol PSM Power Saving Mode TCP Transmission Control Protocol TTL Time to Live UDP User Datagram Protocol URC Unsolicited Result Code UTC Universal Time Coordinated 中文全称 扩展不连续接收 域名系统 非连续接收 标识符 互联网协议 互联网协议版本 4 互联网协议版本 6 微控制器 移动设备 窄带物联网 网络时间协议 点对点协议 省电模式 传输控制协议 生存时间 用户数据报协议 非请求结果码 世界标准时间 上海移远通信技术股份有限公司 31 / 31

BC26&BC20 电信 IoT 平台应用指导 NB-loT 模块系列 版本：BC26&BC20_电信 IoT 平台_应用指导_V1.0 日期：2019-12-10 状态：受控文件 www.quectel.com BC26&BC20 电信 IoT 平台应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 27 BC26&BC20 电信 IoT 平台应用指导 文档历史 修订记录 版本 1.0 日期 作者 2019-12-10 李婷婷 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 27 BC26&BC20 电信 IoT 平台应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 1.1. AT 命令类型 ............................................................................................................................... 5 2 电信 IoT 平台相关 AT 命令详解............................................................................................................ 6 2.1. AT+QLWSERV 配置电信 loT 平台地址和端口........................................................................ 6 2.2. AT+QLWCONF 配置电信 loT 平台参数 .................................................................................. 7 2.3. AT+QLWADDOBJ 添加 LwM2M 对象..................................................................................... 8 2.4. AT+QLWDELOBJ 删除 LwM2M 对象 ..................................................................................... 9 2.5. AT+QLWOPEN 向电信 loT 平台发送注册请求 ....................................................................... 9 2.6. AT+QLWUPDATE 向电信 IoT 平台发送更新请求................................................................. 10 2.7. AT+QLWCLOSE 向电信 IoT 平台发送注销请求 ................................................................... 11 2.8. AT+QLWDATASEND 发送数据到电信 loT 平台 ................................................................... 12 2.9. AT+QLWDATASTATUS 查询 CON 消息的发送状态 ............................................................ 13 2.10. AT+QLWRD 读取接收数据.................................................................................................... 15 2.11. AT+QLWCFG 配置可选参数 ................................................................................................. 16 2.12. AT+QLWDEL 删除 LwM2M 场景........................................................................................... 19 3 LwM2M 相关 URC 详解 ...................................................................................................................... 20 3.1. +QLWOBSERVE 通知设备有来自电信 IoT 平台下发的订阅请求 ......................................... 20 3.2. +QLWDATARECV 通知设备接收到电信 IoT 平台下发的数据 .............................................. 21 4 举例 ..................................................................................................................................................... 22 4.1. 注册到电信 loT 平台 ................................................................................................................. 22 4.2. 在直吐模式下发送和接收数据 .................................................................................................. 23 4.3. 在缓存模式下发送和接收数据 .................................................................................................. 24 5 附录 A 术语缩写 ................................................................................................................................. 27 上海移远通信技术股份有限公司 3 / 27 BC26&BC20 电信 IoT 平台应用指导 表格索引 表 1：AT 命令类型及响应 .................................................................................................................................... 5 表 2：LWM2M 相关的 URC............................................................................................................................... 20 表 3：术语缩写 .................................................................................................................................................. 27 上海移远通信技术股份有限公司 4 / 27 BC26&BC20 电信 IoT 平台应用指导 1 引言 移远通信 BC26 和 BC20 NB-IoT 模块支持接入中国电信 IoT 平台。本文档主要介绍与中国电信 IoT 平 台接入和配置相关的 AT 命令。 1.1. AT 命令类型 表 1：AT 命令类型及响应 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令或内部程序可支持的参数取值列表 或范围。 AT+? 返回相应设置命令的当前参数设置值。 AT+=[,[,[ 设置用户可自定义的参数值。 ...]]] AT+ 主动执行内部程序实现的功能集。 备注 1. ：参数名称，实际命令行中不包括尖括号 < >；添加下划线'_'的参数取值为默认值； 2. [...]：可选参数，实际命令行中不包括方括号 [ ]；若无特别说明，可选参数省略时将采用默认值。 3. 若无特别说明，本文档中的 AT 命令默认立即生效。 上海移远通信技术股份有限公司 5 / 27 BC26&BC20 电信 IoT 平台应用指导 2 电信 IoT 平台相关 AT 命令详解 2.1. AT+QLWSERV 配置电信 loT 平台地址和端口 该命令用于配置模块将连接的电信 IoT 平台的 IP 地址和端口号。 AT+QLWSERV 配置电信 loT 平台地址和端口 测试命令 AT+QLWSERV=? 响应 +QLWSERV: ,(支持的范围) 查询命令 AT+QLWSERV? OK 响应 +QLWSERV: , OK 设置命令 AT+QLWSERV=, 若出现任何错误： ERROR 响应 OK 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置不保存至 NVRAM； 若成功配置，则深休眠唤醒后仍有效 参数 带双引号的字符串类型。电信 loT 平台的 IP 地址。 整型。电信 loT 平台端口号；范围：0-65535。 上海移远通信技术股份有限公司 6 / 27 举例 AT+QLWSERV='180.101.147.115',5683 OK AT+QLWSERV? +QLWSERV: '180.101.147.115',5683 OK BC26&BC20 电信 IoT 平台应用指导 2.2. AT+QLWCONF 配置电信 loT 平台参数 该命令用于配置模块将连接的电信 IoT 平台的参数。 AT+QLWCONF 配置电信 loT 平台参数 测试命令 响应 AT+QLWCONF=? +QLWCONF: 查询命令 AT+QLWCONF? OK 响应 +QLWCONF: OK 设置命令 AT+QLWCONF= 若出现任何错误： ERROR 响应 OK 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 带双引号的字符串类型。设备的结点名称，如设备的 IMEI 号等。 上海移远通信技术股份有限公司 7 / 27 举例 AT+QLWCONF='866971030001361' OK AT+QLWCONF? +QLWCONF: '866971030001361' OK BC26&BC20 电信 IoT 平台应用指导 2.3. AT+QLWADDOBJ 添加 LwM2M 对象 该命令用于添加新的 LwM2M 对象。 AT+QLWADDOBJ 添加 LwM2M 对象 设置命令 响应 AT+QLWADDOBJ=,[ OK [,,]] 若模块成功注册到平台，则继续返回： UPDATE OK 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。对象 ID；范围：0-65535。 整型。实例 ID。 整型。资源 ID 个数。 带双引号的字符串类型。资源 ID。 举例 AT+QLWADDOBJ=19,0,1,'0' OK //添加 LwM2M 对象(/19/0/0)。 AT+QLWADDOBJ=19,1,1,'0' OK //添加 LwM2M 对象(/19/1/0)。 上海移远通信技术股份有限公司 8 / 27 BC26&BC20 电信 IoT 平台应用指导 UPDATE OK 2.4. AT+QLWDELOBJ 删除 LwM2M 对象 该命令用于删除指定的 LwM2M 对象。 AT+QLWDELOBJ 删除 LwM2M 对象 设置命令 响应 AT+QLWDELOBJ= OK 若模块成功注册到平台，则继续返回： UPDATE OK 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。LwM2M 对象 ID。 举例 AT+QLWADDOBJ=19,1,1,'0' OK AT+QLWDELOBJ=19 OK UPDATE OK //添加 LwM2M 对象（/19/1/0）。 //删除 ID 为 19 的 LwM2M 对象。 //将删除结果更新到电信 IoT 平台。如果模块尚未注册到平台，则不会 显示 UPDATE OK。 2.5. AT+QLWOPEN 向电信 loT 平台发送注册请求 该命令用于向电信 loT 平台发送注册请求。 上海移远通信技术股份有限公司 9 / 27 BC26&BC20 电信 IoT 平台应用指导 AT+QLWOPEN 向电信 loT 平台发送注册请求 设置命令 AT+QLWOPEN= 响应 若模块成功注册到电信 loT 平台： OK CONNECT OK 若模块未能注册到电信 loT 平台： OK CONNECT FAIL 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。LwM2M 的数据模式。 0 直吐模式 1 缓存模式 备注 响应 CONNECT OK 或 CONNECT FAIL 的最大超时时间默认约为 128 秒。 举例 AT+QLWOPEN=0 OK CONNECT OK //在直吐模式下注册到电信 loT 平台。 //模块已成功注册到电信 loT 平台。 2.6. AT+QLWUPDATE 向电信 IoT 平台发送更新请求 该命令用于向电信 IoT 平台发送更新请求。 上海移远通信技术股份有限公司 10 / 27 BC26&BC20 电信 IoT 平台应用指导 AT+QLWUPDATE 向电信 IoT 平台发送更新请求 设置/执行命令 AT+QLWUPDATE[=] 响应 若更新成功： OK UPDATE OK 若更新失败： OK UPDATE FAIL 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。用于设置模块向电信 IoT 平台发送更新请求的间隔时间；实际间隔时间为 ×0.8。单位：秒。 范围：900-2592000；默认值 86400。 0 关闭自动发送更新请求，此时模块不会自动发送更新注册包 备注 响应 UPDATE OK 或 UPDATE FAIL 的最大超时时间默认约为 128 秒。 2.7. AT+QLWCLOSE 向电信 IoT 平台发送注销请求 该命令用于向电信 IoT 平台发送注销请求。 AT+QLWCLOSE 向电信 IoT 平台发送注销请求 执行命令 AT+QLWCLOSE 响应 若注销成功： OK 上海移远通信技术股份有限公司 11 / 27 最大响应时间 保存机制 BC26&BC20 电信 IoT 平台应用指导 CLOSE OK 若注销失败： OK CLOSE FAIL 若出现任何错误： ERROR 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 备注 响应 CLOSE OK 或 CLOSE FAIL 的最大超时时间默认约为 128 秒。 举例 AT+QLWCLOSE OK CLOSE OK //成功从电信 loT 平台注销 2.8. AT+QLWDATASEND 发送数据到电信 loT 平台 该命令用于向电信 IoT 平台发送 CON 或 NON 数据。发送 CON 数据后，发送结果将自动通知终端。 终端也可以使用 AT+QLWDATASTATUS?命令查询已发送 CON 数据的状态。 AT+QLWDATASEND 发送数据到电信 loT 平台 设置命令 AT+QLWDATASEND=,,,,, 响应 若成功发送 NON 消息： OK 若成功发送 CON 消息并且被电信 IoT 平台确认： OK SEND OK 上海移远通信技术股份有限公司 12 / 27 最大响应时间 保存机制 BC26&BC20 电信 IoT 平台应用指导 若发送 CON 消息失败： OK SEND FAIL 若出现任何错误： ERROR 300 毫秒 / 参数 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 整型。要发送的数据长度。文本字符串数据的最大长度为 1024 字节，十六进制字符串数据 的最大长度为 512 字节。 带双引号的字符串类型。要发送的数据。 0x0000 发送 NON 消息 0x0100 发送 CON 消息 备注 1. 发送 CON 数据时，必须等上一条 CON 消息发送结果返回后方可执行下一个发送请求。 2. 发送 CON 消息后响应 SEND OK 或 SEND FAIL 的最大超时时间默认约为 128 秒。 举例 AT+QLWDATASEND=19,0,0,1,00,0x0000 //将 NON 类型的十六进制字符串数据发送到电信 IoT 平台。 OK AT+QLWDATASEND=19,0,0,1,01,0x0100 //将 CON 类型的十六进制字符串数据发送到电信 IoT 平台。 OK SEND OK 2.9. AT+QLWDATASTATUS 查询 CON 消息的发送状态 该命令用于查询上一条 CON 消息的发送状态。 上海移远通信技术股份有限公司 13 / 27 BC26&BC20 电信 IoT 平台应用指导 AT+QLWULDATASTATUS 查询命令 AT+QLWDATASTATUS? 查询 CON 消息的发送状态 响应 +QLWDATASTATUS: OK 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 参数 整型。上一条 CON 消息的发送状态。 0 尚未发送 1 已发送，等待 loT 平台的响应 2 发送失败 3 发送超时 4 发送成功 5 被平台拒绝 备注 该命令仅可用于查询 CON 消息的发送状态。 举例 AT+QLWDATASEND=19,0,0,1,01,0x0100 OK SEND OK AT+QLWDATASTATUS? +QLWDATASTATUS: 4 OK //向电信 loT 平台发送 CON 数据。 //数据已发送成功。 上海移远通信技术股份有限公司 14 / 27 BC26&BC20 电信 IoT 平台应用指导 2.10. AT+QLWRD 读取接收数据 该命令用于在缓存模式下读取已接收的数据。 在 缓 存 模 式 下 ， 当 模 块 接 收 到 数 据 时 ， 会 先 缓 存 数 据 并 上 报 URC +QLWDATARECV: ,,,。 AT+QLWRD 读取接收数据 测试命令 AT+QLWRD=? 响应 +QLWRD: (支持的范围) 设置命令 AT+QLWRD= OK 响应 +QLWRD: , OK 若无数据： +QLWRD: 0 OK 最大响应时间 保存机制 若出现任何错误： ERROR 300 毫秒 / 参数 要读取的数据长度；范围：1-512；单位：字节。 已读取的数据长度；单位：字节。 剩余未读取的数据长度；单位：字节。 所读取的数据。 备注 1. 如果接收的缓存区不为空，并且模块再次接收数据，则在从缓存区读取到所有接收到的数据之前，模 块不会上报新的 URC。 2. 剩余长度不是缓存区中的总接收字节数，仅表示存储在一个节点中的当前剩余数据。 上海移远通信技术股份有限公司 15 / 27 举例 AT+QLWRD=2 +QLWRD: 2,2 AAAA OK AT+QLWRD=2 +QLWRD: 2,0 0000 OK AT+QLWRD=4 +QLWRD: 0 OK BC26&BC20 电信 IoT 平台应用指导 //从缓存区中读取两字节数据。 //已读取两字节，剩余两字节未读取。 //从缓存区中读取两字节数据。 //已读取两字节，无剩余数据未读。 //从缓存区中读取四字节数据。 //缓存区为空，没有可读取的数据。 2.11. AT+QLWCFG 配置可选参数 该命令用于配置与电信 IoT 平台相关的可选参数。 AT+QLWCFG 配置可选参数 测试命令 AT+QLWCFG=? 响应 +QLWCFG: 'dataformat',( 支 持 的 列 表),(支持的列表) +QLWCFG: 'lifetime',(支持的列表) +QLWCFG: 'retransmit',(支持的范围),(支持 的范围) 查询命令 AT+QLWCFG? OK Response +QLWCFG: 'dataformat',, +QLWCFG: 'lifetime', +QLWCFG: 'retransmit',, OK 若出现任何错误： 上海移远通信技术股份有限公司 16 / 27 BC26&BC20 电信 IoT 平台应用指导 ERROR 设置命令 AT+QLWCFG='dataformat'[,,] 响应 若设置全部参数，则配置发送/接收数据的格式： OK 若省略和，则查询 当前发送和接收数据的格式： +QLWCFG: 'dataformat',, OK 设置命令 AT+QLWCFG='lifetime'[,] 若出现任何错误： ERROR 响应 若设置全部参数，则配置模块向电信 IoT 平台发送更新请求的 间隔时间： OK 若省略，则查询当前模块向电信 IoT 平台发 送更新请求的间隔时间： +QLWCFG: 'lifetime', OK 设置命令 AT+QLWCFG='retransmit'[,,] 若出现任何错误 ERROR 响应 若设置全部参数，则配置响应超时时间和最大重传次数： OK 若省略、，则查询当前 配置的响应超时时间和最大重传次数： +QLWCFG: 'retransmit',, OK 最大响应时间 保存机制 若出现任何错误 ERROR 300 毫秒 1. 、参数配置不 保存至 NVRAM，但深休眠唤醒后仍有效。 上海移远通信技术股份有限公司 17 / 27 BC26&BC20 电信 IoT 平台应用指导 2. 参数配置不保存至 NVRAM，但深休眠唤 醒后仍有效。 3. 、参数配置自动保 存至 NVRAM；深休眠唤醒后仍有效。 参数 整型。发送数据的格式。 0 文本字符串 1 十六进制字符串 整型。接收数据的格式。 0 文本字符串 1 十六进制字符串 整型。用于设置模块向电信 IoT 平台发送更新请求的间隔时间；实际间隔时间 为×0.8。单位：秒。 范围：900-2592000；默认值：86400。 0 关闭自动发送更新请求，此时模块不会自动发送更新注册包 整型。响应超时时间；单位：秒，范围 2~20。 超时时间= × 2(NT-1) 'NT' 表示重传次数。响应超时等待时间第一次重传默认为 2 秒。 整型。最大重传次数；范围 2~8，默认为 5 次。 备注 1. AT+QLWCFG='lifetime',必须在 AT+QLWSERV 之前配置方可生效。 2. AT+QLWCFG='retransmit',,需要在模块重启后方可生效。 举例 //将发送和接收的数据均设置为十六进制字符串格式。 AT+QLWCFG='dataformat',1,1 OK //将发送的数据设置为十六进制字符串格式，并将接收的数据设置为文本字符串格式。 AT+QLWCFG='dataformat',1,0 OK //关闭自动发送更新请求，模块不再自动发送更新注册包。 AT+QLWCFG='lifetime',0 OK //设置为 10 天，即模块每隔 8 天向电信 IoT 平台发送一次更新注册包请求。 AT+QLWCFG='lifetime',864000 上海移远通信技术股份有限公司 18 / 27 OK //配置为 2 秒，最大重传次数为 5 次。 AT+QLWCFG='retransmit',2,5 OK BC26&BC20 电信 IoT 平台应用指导 2.12. AT+QLWDEL 删除 LwM2M 场景 该命令用于删除 LwM2M 场景。 AT+QLWDEL 删除 LwM2M 场景 执行命令 响应 AT+QLWDEL OK 最大响应时间 保存机制 若出现任何错误： ERROR 5秒 参数配置不保存至 NVRAM，但深休眠唤醒后仍有效 上海移远通信技术股份有限公司 19 / 27 BC26&BC20 电信 IoT 平台应用指导 3 LwM2M 相关 URC 详解 本章介绍与 LwM2M 相关的 URC 及其描述。 表 2：LwM2M 相关的 URC 索引 [1] [2] URC 格式 描述 +QLWOBSERVE: ,,, +QLWDATARECV: ,,,< length>[,] 通知设备有来自电信 IoT 平台下发的订阅 请求 通知设备接收到来自电信 IoT 平台下发的 数据 3.1. +QLWOBSERVE 通知设备有来自电信 IoT 平台下发的订阅请求 +QLWOBSERVE 通知设备有来自电信 IoT 平台下发的订阅请求 +QLWOBSERVE: ,,, 在注册订阅指定的对象/实例/资源之后，电信 IoT 平台将向模块 发送订阅请求。 该 URC 用于通知设备有来自电信 IoT 平台下发的订阅请求。 参数 整型。是否订阅。 0 订阅 1 取消订阅 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 -1 与指定实例相关的所有资源 上海移远通信技术股份有限公司 20 / 27 BC26&BC20 电信 IoT 平台应用指导 3.2. +QLWDATARECV 通知设备接收到电信 IoT 平台下发的数据 +QLWDATARECV 通知设备接收到电信 IoT 平台下发的数据 +QLWDATARECV: ,,,[,] 参数 整型。对象 ID。 整型。实例 ID。 整型。资源 ID。 整型。收到的数据长度，最大值为 512 字节。 从电信 IoT 平台接收的十六进制/文本字符串数据。数据格式取决于 AT+QLWCFG 命令 的配置。是否显示取决于 AT+QLWOPEN 命令的配置。 上海移远通信技术股份有限公司 21 / 27 BC26&BC20 电信 IoT 平台应用指导 4 举例 4.1. 注册到电信 loT 平台 AT+CGPADDR=1 +CGPADDR: 1,10.52.241.198 //检查默认 PDN 分配的 IP 地址。 OK //设置电信 loT 平台 IP 地址和端口。 //如遇异常情况需要重新配置相关参数，则应在配置之前执行 AT+QLWDEL。 AT+QLWSERV='180.101.147.115',5683 OK AT+QLWCONF='867724030023557' //设置连接到电信 loT 平台设备的 IMEI 号。 OK AT+QLWADDOBJ=19,0,1,'0' OK //添加 LwM2M 对象 19/0/0。 AT+QLWADDOBJ=19,1,1,'0' OK //添加 LwM2M 对象 19/1/0。 AT+QLWOPEN=0 OK //以直吐模式注册到电信 loT 平台。 CONNECT OK //注册成功。 +QLWOBSERVE: 0,19,0,0 //接收订阅（19/0/0）请求。 AT+QLWUPDATE OK //向电信 IoT 平台发送更新请求。 UPDATE OK //更新成功。 上海移远通信技术股份有限公司 22 / 27 AT+QLWCLOSE OK CLOSE OK AT+QLWDEL OK BC26&BC20 电信 IoT 平台应用指导 //注销电信 IoT 平台。 //注销成功。 //删除 LwM2M 场景。 4.2. 在直吐模式下发送和接收数据 AT+CGPADDR=1 +CGPADDR: 1,10.52.241.198 //检查默认 PDN 分配的 IP 地址。 OK //设置电信 IoT 平台的 IP 地址和端口。 //如遇异常情况需要重新配置相关参数，则应在配置之前执行 AT+QLWDEL。 AT+QLWSERV='180.101.147.115',5683 OK AT+QLWCONF='867724030023557' //设置连接到电信 loT 平台设备的 IMEI 号。 OK AT+QLWADDOBJ=19,0,1,'0' OK //添加 LwM2M 对象 19/0/0。 AT+QLWADDOBJ=19,1,1,'0' OK //添加 LwM2M 对象 19/1/0。 AT+QLWOPEN=0 OK //以直吐模式注册到电信 IoT 平台。 CONNECT OK //注册成功。 +QLWOBSERVE: 0,19,0,0 //接收订阅（19/0/0）请求。 AT+QLWCFG='dataformat',1,1 OK //配置发送和接收数据为十六进制字符串格式。 //发送 NON 消息到电信 IoT 平台。 AT+QLWDATASEND=19,0,0,57,01F00035020056FFFFFFCD383633373033303330373335313235343 上海移远通信技术股份有限公司 23 / 27 BC26&BC20 电信 IoT 平台应用指导 6303131313137343830383738350000015FFB289A180100040200010097,0x0000 OK +QLWDATARECV: 19,1,0,4,AAAA0000 //接收到来自电信 IoT 平台的数据。 //将 CON 数据发送到电信 IoT 平台，等待来自平台的确认。 AT+QLWDATASEND=19,0,0,57,01F00035020056FFFFFFCD383633373033303330373335313235343 6303131313137343830383738350000015FFB289A180100040200010097,0x0100 OK SEND OK //消息已成功发送。 +QLWDATARECV: 19,1,0,4,AAAA0000 //接收到来自电信 IoT 平台的数据。 AT+QLWDATASTATUS? +QLWDATASTATUS: 4 //查询 CON 消息的发送状态。 //消息已成功发送。 OK 4.3. 在缓存模式下发送和接收数据 AT+CGPADDR=1 +CGPADDR: 1,10.52.241.198 //检查默认 PDN 分配的 IP 地址。 OK //设置电信 IoT 平台的 IP 地址和端口。 //如遇异常情况需要重新配置相关参数，则应在配置之前执行 AT+QLWDEL。 AT+QLWSERV='180.101.147.115',5683 OK AT+QLWCONF='867724030023557' OK //设置连接到电信 loT 平台设备的 IMEI 号。 AT+QLWADDOBJ=19,0,1,'0' OK //添加 LwM2M 对象 19/0/0。 AT+QLWADDOBJ=19,1,1,'0' OK //添加 LwM2M 对象 19/1/0。 AT+QLWOPEN=1 //在缓存模式下注册到电信 IoT 平台。 上海移远通信技术股份有限公司 24 / 27 BC26&BC20 电信 IoT 平台应用指导 OK CONNECT OK //注册成功。 +QLWOBSERVE: 0,19,0,0 //接收订阅（19/0/0）请求。 AT+QLWCFG='dataformat',1,1 OK //配置发送和接收数据为十六进制字符串格式。 //将 NON 消息发送到电信 IoT 平台。 AT+QLWDATASEND=19,0,0,57,01F00035020056FFFFFFCD383633373033303330373335313235343 6303131313137343830383738350000015FFB289A180100040200010097,0x0000 OK +QLWDATARECV: 19,1,0,4 //接收到来自电信 IoT 平台的数据。 AT+QLWRD=4 +QLWRD: 4,0 AAAA0000 //从缓存区中读取四字节数据。 OK //将 CON 数据发送到电信 IoT 平台，等待来自电信 IoT 平台的确认。 AT+QLWDATASEND=19,0,0,57,01F00035020056FFFFFFCD383633373033303330373335313235343 6303131313137343830383738350000015FFB289A180100040200010097,0x0100 OK SEND OK //消息已成功发送。 +QLWDATARECV: 19,1,0,4 //接收到来自电信 IoT 平台的数据。 AT+QLWRD=2 +QLWRD: 2,2 AAAA //从缓存区中读取两字节数据。 //已读取两字节，剩余两字节未读取。 OK AT+QLWRD=2 +QLWRD: 2,0 0000 //从缓存区中读取两字节数据。 //已读取两字节，无剩余数据未读。 OK AT+QLWDATASTATUS? //查询 CON 消息的发送状态。 上海移远通信技术股份有限公司 25 / 27 +QLWDATASTATUS: 4 OK BC26&BC20 电信 IoT 平台应用指导 //消息已成功发送。 上海移远通信技术股份有限公司 26 / 27 BC26&BC20 电信 IoT 平台应用指导 5 附录 A 术语缩写 表 3：术语缩写 术语 CON IMEI loT LwM2M NB-loT NVRAM NON PDN URC 英文全称 Confirmable International Mobile Equipment Identity Internet of Things Lightweight Machine to Machine Narrow Band Internet of Thing Non-volatile Random Access Memory Non-confirmable Public Data Network Unsolicited Result Code 中文全称 需确认 国际移动设备识别码 物联网 轻量级机器到机器物联网协议 窄带物联网 非易失性随机存取存储器 无需确认 公用数据网 非请求结果码 上海移远通信技术股份有限公司 27 / 27

BC25 终端应用设计指导 NB-IoT 模块系列 版本：BC25_终端应用设计指导_V1.1 日期：2019-12-11 状态：受控文件 www.quectel.com BC25 终端应用设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 14 BC25 终端应用设计指导 文档历史 修订记录 版本 1.0 1.1 日期 2019-07-17 2019-12-11 作者 方亮/ 顾根全 张先保 变更表述 初始版本 增加移动 OneNET 和电信物联网平台深度睡眠唤醒后直接发 送数据功能的描述（第 2.1.2 章）。 上海移远通信技术股份有限公司 2 / 14 BC25 终端应用设计指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 终端应用设计指导 ................................................................................................................................. 7 2.1. 上报类......................................................................................................................................... 7 2.1.1. 网络参数配置要求 ........................................................................................................... 7 2.1.2. 终端设计建议................................................................................................................... 7 2.1.3. 终端参考流程................................................................................................................... 9 2.2. 控制类....................................................................................................................................... 10 2.2.1. 网络参数配置要求 ......................................................................................................... 10 2.2.2. 终端设计建议................................................................................................................. 10 2.2.3. 终端参考流程..................................................................................................................11 3 补充说明 .............................................................................................................................................. 12 3.1. 常规维护测试手段 .................................................................................................................... 12 3.2. 相关 AT 命令说明 ..................................................................................................................... 12 4 附录 A 参考文档及术语缩写................................................................................................................ 13 上海移远通信技术股份有限公司 3 / 14 BC25 终端应用设计指导 表格索引 表 1：上报类终端应用网络参数配置要求 ............................................................................................................ 7 表 2：上报类终端应用设计参考项 ....................................................................................................................... 7 表 3：控制类终端应用网络参数配置要求 .......................................................................................................... 10 表 4：控制类终端应用设计参考项 ..................................................................................................................... 10 表 5：相关 AT 命令说明 ..................................................................................................................................... 12 表 6：参考文档 .................................................................................................................................................. 13 表 7：术语缩写 .................................................................................................................................................. 13 上海移远通信技术股份有限公司 4 / 14 BC25 终端应用设计指导 图片索引 图 1：上报类终端应用参考流程 ........................................................................................................................... 9 图 2：控制类终端应用参考流程 ..........................................................................................................................11 上海移远通信技术股份有限公司 5 / 14 BC25 终端应用设计指导 1 引言 目前，移远通信 NB-IoT 模块主要应用于如下两类终端应用场景：  上报类：固定上报类终端，如水表、气表、烟感报警器等；移动上报类终端，如共享单车、智能 手环等。  控制类：如路灯、共享洗衣机、电动车控制器等。 本文档针对上述两大类终端应用场景提供设计指导，以便于客户在不同的网络部署环境（部署频点变 更、同频改异频等）下进行终端部署。 本文档适用于如下移远通信 NB-IoT 模块：  BC25：软件版本 BC25_R01A04 及后续版本；  BC25-B5：软件版本 BC25B5_R01A04 及后续版本；  BC25-B8：软件版本 BC25B8_R01A05 及后续版本。 上海移远通信技术股份有限公司 6 / 14 BC25 终端应用设计指导 2 终端应用设计指导 本章节分别根据 BC25 模块各类终端应用提供设计指导和建议。 2.1. 上报类 上报类终端应用的数据传输业务具有周期性；大部分时间处于睡眠状态，无需接收寻呼消息，仅在终 端发送上行数据时接收下行数据。此类终端应用要求低功耗以及高数据传输成功率，但对数据传输的实时 性要求低，建议遵循以下设计要求。 2.1.1. 网络参数配置要求 表 1：上报类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 开启 备注 如上表格所述功能由核心网配置，因此须与运营商确认功能开启和关闭状态。 2.1.2. 终端设计建议 表 2：上报类终端应用设计参考项 序号 设计参考项 说明 1 开机入网超时时间 由于网络变化或在深度覆盖下，终端入网时间较长，因此建议 MCU 开机入网超时时间不小于 300s。入网超时后，则进入异常处理流程。 2 使用 AT+CPSMS=1,,,,命 令配置 PSM 参数 （T3324）。模块发完最后一包数据、核心网释放连接后，模块处于 Idle 状态，T3324 时间超时后模块才会进入 PSM 状态。 的默认请求值为 2 分钟，请求值是否生 效取决于核心网（目前实测，移动 NB-IoT 卡允许配置；电信 NB-IoT 卡是否可配置，和开卡时选择的 APN 类型有关）。 模块断电之前需进行如下步骤： 1) 等待模块进入 Idle 状态后至少 15 秒，使得网络可以通过配置 若需要给模块断电，则须在 3 模块进入 Idle 状态 15 秒后， T3324 定时器，保证模块有足够的时间完成小区测量及重选过 程； 执行 AT+CFUN=0 再断电 2) 通过 MCU 向模块发送 AT+CFUN=0 命令，触发模块向核心网 发送去附着消息。  当前版本已支持深度睡眠后保存连接状态，如果连接了电信物 4 数据传输业务 联网平台、移动 OneNET 平台或者建立了 UDP 连接，唤醒后 恢复成功即可直接发送数据，无需重新连接（请参考文档 [5]）。  进行正常数据传输业务时，在业务数据交互过程中，若 60s 后 未收到下行数据，则判定本次数据业务因超时而失败并再次尝 试发送数据；若 3 次尝试均超时失败，则进入异常处理流程。 5 DFOTA 入网后模块可以使用 AT+QFOTADL 命令从 HTTP 服务器获取差分 包进行在线升级，详细请参考文档 [2]。 若入网异常或数据传输业务失败后，请按如下流程进行异常处理： 6 异常处理流程 1) 执行 AT+QCSEARFCN=0 命令（清除先验频点）； 2) 拉低模块 RESET 引脚（重启模块）； 3) 再次尝试入网以及数据传输业务； 4) 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 8 / 14 2.1.3. 终端参考流程 BC25 终端应用设计指导 设置关闭模块休眠 AT+QS CLK=0 指定Band AT+QBAND=, 重启模块 拉低模块RESE T引脚 如果使用单频模块如BC25-B5、 BC25-B8则跳过该步骤 数据传输业务 Yes 数据传输 是否成功? 连续3次接收下行数 据超时（60s） No Yes 最后一包上行数据建议 采用带RAI功能的命令 Idle模式 模块上电 设置关闭模块休眠 AT+QS CLK=0 关闭模块eDRX功能 AT+CEDRXS=0 打开模块PS M功能 AT+CPSMS=1 网络附着 检查是否 成功入网 300s后，AT+CGATT?查询不 No 等于1 或者AT+CGPADDR?查 询未获取IP地址 是否继续 尝试入网? Yes No 清除先验频点 AT+QCSE ARFCN=0 是否断电? No Yes 若业务完成后采取断电 方式，建议进入Idle后 延时至少15s，执行 AT+CFUN=0，再断电 设置允许模块休眠 AT+QS CLK=1 AT+CFUN=0 检查是否 成功进入休眠 Yes 深休眠 No 300s后，未上报 +QATSLEE P或者发 送AT仍然能返回OK 重启模块 拉低模块RESE T引脚 根据退避算法连 续3次入网失败 异常 处理 断电关机 图 1：上报类终端应用参考流程 上海移远通信技术股份有限公司 9 / 14 BC25 终端应用设计指导 2.2. 控制类 控制类的终端应用通常由外部电源供电；大部分时间处于在线状态，能实时接收下行数据。该类终端 应用对数据实时性要求高，对功耗要求低，建议遵循以下设计要求。 2.2.1. 网络参数配置要求 表 3：控制类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 关闭 备注 如上表格所述功能由核心网配置，因此须与运营商确认功能开启和关闭状态。 2.2.2. 终端设计建议 表 4：控制类终端应用设计参考项 序号 设计建议参数 说明 1 开机入网超时时间 由于网络变化或在深度覆盖下，终端入网时间较长，因此建议 MCU 开机入网超时时间不小于 300s。入网超时后，则进入异常处理流程。 2 若需要给模块断电，则须先 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，向网络发送去附 执行 AT+CFUN=0 再断电 着消息。 进行正常数据传输业务时，在业务数据交互过程中，若 60s 后未收 3 数据传输业务 到下行数据，则判定本次数据业务因超时而失败，再次尝试发送数 据；若 3 次尝试均超时失败，则进入异常处理流程。 4 DFOTA 入网后模块可以使用 AT+QFOTADL 命令从 HTTP 服务器获取差分 包进行在线升级，详细请参考文档 [2]。 若入网异常或数据传输业务失败后，请按如下流程进行异常处理： 1) 执行 AT+QCSEARFCN=0 命令（清除先验频点）； 5 异常处理流程 2) 拉低模块 RESET 引脚（重启模块）； 3) 再次尝试入网以及数据传输业务； 4) 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 上海移远通信技术股份有限公司 10 / 14 2.2.3. 终端参考流程 BC25 终端应用设计指导 设置关闭模块休眠 AT+QS CLK=0 指定Band AT+QBAND=, 重启模块 拉低模块RESE T引脚 如果使用单频模块如BC25-B5、 BC25-B8则跳过该步骤 模块上电 设置关闭模块休眠 AT+QS CLK=0 关闭模块eDRX功能 AT+CEDRXS=0 关闭模块PS M功能 AT+CPSMS=0 网络附着 数据传输业务 Yes 数据传输 连续3次接收下行数 据超时（60s） 是否成功? No 最后一包上行数据建议 Yes 采用带RAI功能的命令 Idle模式 检查是否 成功入网 No 300s后，AT+CGATT?查询不 等于1 或者AT+CGPADDR?查 询未获取IP地址 是否继续 尝试入网? Yes 清除先验频点 No AT+QCSE ARFCN=0 重启模块 拉低模块RESE T引脚 根据退避算法连 续3次入网失败 断电关机 异常 处理 图 2：控制类终端应用参考流程 上海移远通信技术股份有限公司 11 / 14 BC25 终端应用设计指导 3 补充说明 3.1. 常规维护测试手段 终端支持网络相关信息的上报且可在平台上显示，例如频点（EARFCN）、小区 ID、覆盖等级（ECL）、 信号强度（RSRP）、信噪比（SNR）等，此相关信息可通过 AT+QENG=0 命令来获取。 3.2. 相关 AT 命令说明 本章节列举了与 BC25 终端应用设计相关的 AT 命令，更多详情请参考文档 [1]、文档 [2]、文档 [3] 和 文档 [4]。 表 5：相关 AT 命令说明 序号 AT 命令 说明 1 AT+CEDRXS=0 关闭模块 eDRX 功能。 2 AT+CGATT? 查询模块是否成功入网。 3 AT+CGPADDR? 查询模块是否获取 IP 地址。 4 AT+CPSMS=0 关闭模块 PSM 功能。 5 AT+MIPLNOTIFY=,,, ,,,,,,[,[,]] 可发送携带标志位的 OneNET 数据，用于指示核 心网立即释放连接，以便模块快速进入 Idle 状态。 6 AT+NMGS=,[,] 可发送携带 RAI 的 CoAP 数据，用于指示核心网 立即释放连接，以便模块快速进入 Idle 状态。 7 AT+QENG=0 查询最近一次所驻留小区的 EARFCN、小区 ID、 ECL、RSRP 和 SNR 等信息。 8 AT+QCSEARFCN=0 清除模块保存的先验频点，当下一次启动搜索网 时，根据场景信号强度选择频点。 9 AT+CFUN=0 关闭模块的射频功能块。 上海移远通信技术股份有限公司 12 / 14 BC25 终端应用设计指导 4 附录 A 参考文档及术语缩写 表 6：参考文档 序号 文档名称 备注 [1] Quectel_BC25_AT 命令手册 BC25 AT 命令手册 [2] Quectel_BC25&BC32_DFOTA_应用指导 BC25 和 BC32 模块 DFOTA 应用指导 [3] Quectel_BC25_中国电信 loT 平台应用指导 BC25 中国电信物联网平台应用指导 [4] Quectel_BC25&BC32_OneNET_应用指导 BC25 和 BC32 模块 OneNET 平台应用指导 [5] Quectel_BC25_软件开发注意事项及常见问题 BC25 模块的软件开发注意事项和常见问题解答 表 7：术语缩写 缩写 APN CoAP EARFCN ECL eDRX DFOTA HTTP MCU NB-IoT PSM 英文全称 中文全称 Access Point Name 接入点名称 Constrained Application Protocol E-UTRA Absolute Radio Frequency Channel Number Enhanced Coverage Level 受限应用协议 E-UTRA 绝对射频频道号 增强覆盖范围 Extended Discontinuous Reception 增强型非连续接收 Differential Firmware Over-The-Air 固件空中差分升级 HyperText Transfer Protocol 超文本传输协议 Microprogrammed Control Unit 微控单元 Narrow Band Internet of Things 窄带物联网 Power Saving Mode 节电模式 上海移远通信技术股份有限公司 13 / 14 RAI RRC RSRP SNR UDP Release Assistance Indication Radio Resource Control Reference Signal Received Power Signal Noise Ratio User Datagram Protocol BC25 终端应用设计指导 释放辅助指示 无线资源控制 参考信号接收功率 信噪比 用户数据报协议 上海移远通信技术股份有限公司 14 / 14

BG95&BG77 FTP(S) Application Note LPWA Module Series Rev. BG95&BG77_FTP(S)_Application_Note_V1.0 Date: 2019-10-28 Status: Released www.quectel.com LPWA Module Series BG95&BG77 FTP(S) Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved BG95&BG77_FTP(S)_Application_Note 1 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note About the Document History Revision 1.0 Date Author Description 2019-10-28 Terrence YANG Initial BG95&BG77_FTP(S)_Application_Note 2 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 1.1. The Process of Using FTP(S) AT Commands ........................................................................ 6 1.2. Description of Data Mode ........................................................................................................ 8 2 Description of FTP(S) AT Commands ............................................................................................... 9 2.1. AT+QFTPCFG Configure Parameters for FTP(S) Server .................................................... 9 2.2. AT+QFTPOPEN Login to FTP(S) Server ........................................................................... 13 2.3. AT+QFTPCWD Configure the Current Directory on FTP(S) Server .................................. 13 2.4. AT+QFTPPWD Get the Current Directory on FTP(S) Server ............................................ 14 2.5. AT+QFTPPUT Upload a File to FTP(S) Server.................................................................. 15 2.6. AT+QFTPGET Download a File from FTP(S) Server......................................................... 18 2.7. AT+QFTPSIZE Get the File Size on FTP(S) Server .......................................................... 20 2.8. AT+QFTPDEL Delete a File on FTP(S) Server .................................................................. 21 2.9. AT+QFTPMKDIR Create a Folder on FTP(S) Server ........................................................ 22 2.10. AT+QFTPRMDIR Delete a Folder on FTP(S) Server......................................................... 23 2.11. AT+QFTPLIST List Content of a Directory on FTP(S) Server............................................ 23 2.12. AT+QFTPNLST List File Names of a Directory on FTP(S) Server .................................... 25 2.13. AT+QFTPMLSD List Standardized File and Directory Information .................................... 27 2.14. AT+QFTPMDTM Get the File Modification Time on FTP(S) Server .................................. 29 2.15. AT+QFTPRENAME Rename a File or Folder on FTP(S) Server....................................... 30 2.16. AT+QFTPLEN Get the Length of Transferred Data ........................................................... 31 2.17. AT+QFTPSTAT Get the Status of FTP(S) Server............................................................... 31 2.18. AT+QFTPCLOSE Log out from FTP(S) Server.................................................................. 32 3 Examples ............................................................................................................................................ 33 3.1. Login to FTP Server .............................................................................................................. 33 3.2. Login to FTPS Server ............................................................................................................ 34 3.3. Folder Operation.................................................................................................................... 35 3.4. File Operation ........................................................................................................................ 36 3.5. List File Information or File Names ....................................................................................... 37 3.6. Upload a File to FTP(S) Server ............................................................................................. 38 3.7. Download a File from FTP(S) Server .................................................................................... 41 3.8. Log out from FTP(S) Server .................................................................................................. 42 4 Error Handling .................................................................................................................................... 43 4.1. Executing FTP(S) AT Command Fails .................................................................................. 43 4.2. PDP Activation Fails .............................................................................................................. 43 4.3. DNS Parse Fails .................................................................................................................... 43 4.4. Error Response of FTP(S) Server ......................................................................................... 44 BG95&BG77_FTP(S)_Application_Note 3 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 5 Summary of Error Codes .................................................................................................................. 45 6 Summary of FTP(S) Protocol Error Codes...................................................................................... 47 7 Appendix A References..................................................................................................................... 48 BG95&BG77_FTP(S)_Application_Note 4 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 45 TABLE 2: SUMMARY OF FTP(S) PROTOCOL ERROR CODES .................................................................... 47 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 48 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 48 BG95&BG77_FTP(S)_Application_Note 5 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 1 Introduction Quectel BG95 and BG77 modules provide FTP(S) application to FTP(S) server. This document is a reference guide to all the AT commands defined for FTP(S). 1.1. The Process of Using FTP(S) AT Commands As BG95 and BG77 modules support FTP(S) protocol, the file and directory on FTP(S) server can be operated via FTP(S) AT commands. The general process is as follows: Step 1: Configure and activate a PDP context. 1) Configure , , and other parameters of a PDP context by AT+QICSGP. 2) Activate the PDP context via AT+QIACT. 3) Configure the PDP context ID for FTP(S) by AT+QFTPCFG='contextid',. The PDP context should be activated first. Step 2: Configure user account and FTP(S) server. 1) Configure the account information by AT+QFTPCFG='account',,. 2) Configure the type of transferred data by AT+QFTPCFG='filetype',. Either binary data or ASCII data can be transferred between FTP(S) server and client. 3) Configure the transfer mode by AT+QFTPCFG='transmode',. The transfer mode means either the FTP(S) server or the client listens on a port for data connection. Please be noted that AT+QFTPCFG='transmode',1 must be set for FTPS operations, because FTPS does not support active mode currently. 4) Configure the response timeout value by AT+QFTPCFG='rsptimeout',. 5) If the module works as an FTPS client, then the following configurations are needed: a) Execute AT+QFTPCFG='ssltype',1. b) Execute AT+QFTPCFG='sslctxid', to select a . c) Execute AT+QSSLCFG to configure the selected . d) Execute AT+QFTPCFG='data_sslctxid', to select a . e) Execute AT+QSSLCFG to configure the selected . BG95&BG77_FTP(S)_Application_Note 6 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Step 3: Login to FTP(S) server. Login to FTP(S) server by AT+QFTPOPEN=,. If +QFTPOPEN: 0,0 URC is returned, it indicates the operation is successful. Please be noted that the port numbers of FTPS and FTP servers are different. The port number of FTPS server depends on the server provider, and it is 990 usually. Step 4: File operation. 1) Set the current directory by AT+QFTPCWD. 2) Upload a file to FTP(S) server. a) Upload a file to UFS via AT+QFUPL, then upload the file to FTP(S) server by AT+QFTPPUT. After uploading the file to FTP(S) server successfully, the file should be deleted by AT+QFDEL. b) Upload a file to FTP(S) server through COM port by AT+QFTPPUT, then the module will enter in data mode. +++ can be inputted to finish the file uploading process. 3) Download a file from FTP(S) server by AT+QFTPGET. The file can be outputted to COM port or saved to UFS. If the file is outputted to COM port, the module will enter in data mode. 4) Get the size of the file on FTP(S) server by AT+QFTPSIZE. 5) Get the length of data transferred between FTP(S) server and client by AT+QFTPLEN. 6) Delete a file on FTP(S) server by AT+QFTPDEL. 7) Rename a file on FTP(S) server by AT+QFTPRENAME. Step 5: Directory operation on FTP(S) server. 1) Set the current directory by AT+QFTPCWD. 2) Create a directory by AT+QFTPMKDIR. 3) List the content of a directory by AT+QFTPLIST. 4) List file names of a directory by AT+QFTPNLST. 5) Rename a directory by AT+QFTPRENAME. 6) Delete a directory by AT+QFTPRMDIR. 7) List standardized file and directory information by AT+QFTPMLSD. 8) Get the file modification time on FTP(S) server by AT+QFTPMDTM. Step 6: Close a connection with FTP(S) server. Close a connection with FTP(S) server by AT+QFTPCLOSE. If +QFTPCLOSE: 0,0 URC is reported, it indicates the operation is successful. Step 3 to Step 6 can be repeated. Step 7: Deactivate PDP context. Deactivate a PDP context by AT+QIDEACT=. BG95&BG77_FTP(S)_Application_Note 7 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note NOTES 1. Please refer to Quectel_BG95&BG77_TCP(IP)_Application_Note for more details of AT+QICSGP, AT+QIACT and AT+QIDEACT. 2. Please refer to Quectel_BG95&BG77_SSL_Application_Note for more details of AT+QSSLCFG. 3. Please refer to Quectel_BG95&BG77_FILE_Application_Note for more details of AT+QFUPL and AT+QFDEL. 1.2. Description of Data Mode The COM port of BG95/BG77 has two working modes: AT command mode and data mode. In AT command mode, the inputted data via COM port will be treated as AT command, while in data mode, it will be treated as data. Inputting +++ or pulling up DTR (AT&D1 should be set first) will make the module exit from data mode. To prevent the +++ from being misinterpreted as data, the following sequence should be followed: 1) Do not input any character within 1s at least before inputting +++. 2) Input +++ within 1s, and no other characters can be inputted during the time. 3) Do not input any character within 1s after +++ has been inputted. When AT+QFTPPUT, AT+QFTPGET, AT+QFTPLIST and AT+QFTPNLST are executed, if the local file path is 'COM:', which means data will be received from or outputted to COM port, the COM port will enter data mode. The module will exit from data mode when inputting +++ or changing DTR level from low to high, and it will re-enter data mode by executing ATO command after AT+QFTPGET, AT+QFTPLIST and AT+QFTPNLST are executed. After AT+QFTPPUT is executed, the module will not be able to re-enter data mode anymore. BG95&BG77_FTP(S)_Application_Note 8 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 2 Description of FTP(S) AT Commands 2.1. AT+QFTPCFG Configure Parameters for FTP(S) Server The command is used to configure FTP(S) server parameters, including user account, file type, transfer mode, context ID, response timeout, SSL type, SSL context ID, data connection address selection, etc.. If only one parameter is executed, the write commend will query the current settings. AT+QFTPCFG Configure Parameters for FTP(S) Server Test Command AT+QFTPCFG=? Response +QFTPCFG: 'account',, +QFTPCFG: 'filetype',(0,1) +QFTPCFG: 'transmode',(0,1) +QFTPCFG: 'contextid',(1-16) +QFTPCFG: 'rsptimeout',(20-180) +QFTPCFG: 'ssltype',(0-2) +QFTPCFG: 'sslctxid',(0-5) +QFTPCFG: 'data_sslctxid',(0-5) +QFTPCFG: 'data_address',(0,1) Write Command AT+QFTPCFG='account'[,,] OK Response If and are present: OK Or +CME ERROR: If and are both omitted, query the current setting: +QFTPCFG: 'account',, Write Command AT+QFTPCFG='filetype'[,] OK Response If is present: OK Or BG95&BG77_FTP(S)_Application_Note 9 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note +CME ERROR: If is omitted, query the current setting: +QFTPCFG: 'filetype', Write Command AT+QFTPCFG='transmode'[,] OK Response If is present: OK Or +CME ERROR: If is omitted, query the current setting: +QFTPCFG: 'transmode', Write Command AT+QFTPCFG='contextid'[,] OK Response If is present: OK Or +CME ERROR: If is omitted, query the current setting: +QFTPCFG: 'contextid', Write Command AT+QFTPCFG='rsptimeout'[,] OK Response If is present: OK Or +CME ERROR: If is omitted, query the current setting: +QFTPCFG: 'rsptimeout', Write Command AT+QFTPCFG='ssltype'[,] OK Response If is present: OK Or +CME ERROR: If is omitted, query the current setting: +QFTPCFG: 'ssltype', BG95&BG77_FTP(S)_Application_Note 10 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Write Command AT+QFTPCFG='sslctxid'[,] OK Response If is present: OK Or +CME ERROR: If is omitted, query the current setting: +QFTPCFG: 'sslctxid', Write Command AT+QFTPCFG='data_sslctxid'[,] OK Response If is present: OK Or +CME ERROR: If is omitted, query the current setting: +QFTPCFG: 'data_sslctxid', Write Command AT+QFTPCFG='data_address'[,] OK Response If is present: OK Or +CME ERROR: If is omitted, query the current setting: +QFTPCFG: 'data_address', OK Parameter String type. The user name for authentication. The maximum size of the parameter is 255 bytes. String type. The password for authentication. The maximum size of the parameter is 255 bytes. Integer type. The PDP context ID. The range is 1-16, and the default value is 1. It should be activated by AT+QIACT before using AT+QFTPOPEN. For more details of AT+QIACT, please refer to Quectel_BG95&BG77_TCP(IP)_Application_Note. Integer type. The type of transferred data. 0 Binary BG95&BG77_FTP(S)_Application_Note 11 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 1 ASCII Integer type. Whether the FTP(S) server or client listens on a port for data connection 0 Active mode, the module will listen on a port for data connection 1 Passive mode, the FTP(S) server will listen on a port for data connection Integer type. The range is 20-180, and the default value is 90. Unit: second. Generally, it is the timeout value for the OK result code to be returned for most FTP(S) AT commands except AT+QFTPPUT, AT+QFTPGET, AT+QFTPLST and AT+QFTPNLST. The rules for these four commands are shown as below: a) When the command has been sent, but CONNECT has not been outputted yet, this parameter indicates the maximum timeout value for CONNECT to be outputted after the command has been sent. b) When the module has entered data mode, this parameter indicates the maximum interval time between two packets of received/transmitted data. c) When the is not 'COM:', it indicates the maximum interval time between two packets of received/transmitted data. Integer type. The module works as an FTP client or FTPS client. 0 FTP client 1 FTPS client (FTP over implicit TLS/SSL) 2 FTPS client (FTP over explicit TLS/SSL) Integer type. The SSL context ID of the control connection. The range is 0-5, and the default value is 0. The value should be different from . And the SSL parameters should be configured by AT+QSSLCFG. For details of the command, please refer to Quectel_BG95&BG77_SSL_Application_Note. Integer type. The SSL context ID of the data connection. The range is 0-5, and the default value is 1. The value should be different from . The SSL parameters should be configured by AT+QSSLCFG. For details of the command, please refer to Quectel_BG95&BG77_SSL_Application_Note. Integer type. FTP(S) data connection address selection. 0 Use server dispatched address 1 Use FTP(S) control session address Integer type. The error code of the operation. Please refer to Chapter 5 for details. NOTE During FTPS operation, must be set into 1 because FTPS does not support active mode currently. BG95&BG77_FTP(S)_Application_Note 12 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 2.2. AT+QFTPOPEN Login to FTP(S) Server The command is used to login to FTP(S) server. The PDP context should be activated by AT+QIACT first. +QFTPOPEN: , indicates the operation result of AT+QFTPOPEN and it should be outputted within configured by AT+QFTPCFG. AT+QFTPOPEN Login to FTP(S) Server Test Command AT+QFTPOPEN=? Response +QFTPOPEN: , Write Command AT+QFTPOPEN=[,<port] OK Response OK +QFTPOPEN: , If there is any error: +CME ERROR: Parameter String type. The IP address or domain name of the FTP(S) server. The maximum size of the parameter is 200 bytes. Integer type. The port number of the FTP(S) server. The default value is 21. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. NOTE Please note that the port numbers of FTPS and FTP servers are different. The port number of FTPS server depends on the server provider, and it is 990 usually. 2.3. AT+QFTPCWD Configure the Current Directory on FTP(S) Server The command is used to configure the current directory on FTP(S) server. If OK is returned, +QFTPCWD: , should be outputted within configured by AT+QFTPCFG. All file and directory operations will be performed in the current directory. BG95&BG77_FTP(S)_Application_Note 13 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note AT+QFTPCWD Configure the Current Directory on FTP(S) Server Test Command AT+QFTPCWD=? Response +QFTPCWD: Write Command AT+QFTPCWD= OK Response OK +QFTPCWD: , If there is any error: +CME ERROR: Parameter String type. A directory path on FTP(S) server. The maximum size of the parameter is 255 bytes. The root path of FTP(S) server is '/'. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. 2.4. AT+QFTPPWD Get the Current Directory on FTP(S) Server The command is used to get the current directory on FTP(S) server. If OK is returned, +QFTPPWD: 0, or +QFTPPWD: , should be outputted within configured by AT+QFTPCFG. AT+QFTPPWD Get the Current Directory on FTP(S) Server Test Command AT+QFTPPWD=? Execution Command AT+QFTPPWD Response OK Response OK And then, if the current directory is successfully got: +QFTPPWD: 0, If failed to get the current directory: +QFTPPWD: , BG95&BG77_FTP(S)_Application_Note 14 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note If there is any error: +CME ERROR: Parameter String type. A directory path on FTP(S) server. The maximum size of the parameter is 255 bytes. The root path of FTP(S) server is '/'. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. 2.5. AT+QFTPPUT Upload a File to FTP(S) Server The command is used to upload a file to FTP(S) server. If the file data will be uploaded via COM port, then the module will enter data mode. Inputting +++ will abort the file uploading. A local file can be uploaded to FTP(S) server but the file can only be UFS files. The file can be uploaded to UFS by AT+QFUPL, and then be uploaded to FTP(S) server via AT+QFTPPUT command. After a file is uploaded successfully, the file can be deleted by AT+QFDEL. For more details, please refer to Quectel_BG95&BG77_FILE_Application_Note. A file can be uploaded from a specified file position by parameter. If the is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If the is not 'COM:', OK will be outputted first, and then +QFTPPUT: 0, will be outputted after data transfer is completed. If the module has entered data mode or the is not 'COM:', the configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPPUT Upload a File to FTP(S) Server Test Command AT+QFTPPUT=? Response +QFTPPUT: ,,,, Write Command When the is 'COM:', that is, to input data via COM port AT+QFTPPUT=,'COM:' [,[,,]] OK Response If the module enters data mode successfully: CONNECT Then input the data via COM port OK BG95&BG77_FTP(S)_Application_Note 15 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note After that, if the data are successfully uploaded: +QFTPPUT: 0, If failed to upload the data: +QFTPPUT: , Write Command When is not 'COM:' AT+QFTPPUT=,[,] If there is any error: +CME ERROR: Response OK And then, if the data are successfully uploaded: +QFTPPUT: 0,< transferlen> If failed to upload the data: +QFTPPUT: , If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. String type. The local file name. The maximum size of the parameter is 60 bytes. If it is 'COM:', the data will be inputted via COM port. If it is not 'COM:', the data will be saved to UFS. After successful uploading, the file should be deleted by AT+QFDEL. For details of the command, please refer to Quectel_BG95&BG77_FILE_Application_Note. Integer type. The start position of the file to be uploaded. The default value is 0. If and are specified, should be the position where the data continues to be uploaded to the same file. Integer type. The length of the data to be uploaded. It is valid only when is 'COM:'. When the length of data uploaded via COM port reaches , the module will exit from data mode. Unit: byte. Integer type. Whether it is the last packet of data to be uploaded. 0 Not the last packet of data. When the data length reaches , the module will exit from data mode and +QFTPPUT: 0, will be outputted. In such a case, please do not disconnect data connection, as the remained data needs to be uploaded to the same file on FTP(S). 1 The last packet of data. When the data length reaches , the module will exit from data mode and data connection can be disconnected. After that, +QFTPPUT: 0, will be outputted. BG95&BG77_FTP(S)_Application_Note 16 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Integer type. The length of successfully transferred data. Unit: byte. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. Example //Upload a file via COM port to FTP(S) server. AT+QFTPPUT='test.txt','COM:',0 CONNECT //Input the file data via COM port +++ OK //All data will be saved as test.txt on FTP(S) server. //Exit data mode +QFTPPUT: 0,1000 //Upload a file via COM port to FTP(S) server twice in 1024 bytes each time. AT+QFTPPUT='test.txt','COM:',0,1024,0 //It is not the last 1024 bytes of test.txt. CONNECT //Input the file data via COM port OK //Data length reaches 1024 bytes. +QFTPPUT: 0,1024 AT+QFTPPUT='test.txt', 'COM:',1024,1024,1 //It is the last 1024 bytes of test.txt. CONNECT Input the file data via COM port OK //Data length reaches 1024 bytes. +QFTPPUT: 0,1024 //Upload a file to UFS. AT+QFUPL='test1.txt',1000,300,1 CONNECT Input 1000 bytes data +QFUPL: 1000,707 //Upload a file to UFS, the file will be saved as test1.txt and the maximum size of file is 1000 bytes. 300 indicates timeout value, and 1 indicates ACK mode. For details, please refer to Quetel_BG95&BG77_FILE_ Application_Note. OK AT+QFLST='*' BG95&BG77_FTP(S)_Application_Note 17 / 49 +QFLST: 'test1.txt',1000 OK AT+QFTPPUT='test.txt','test1.txt',0 OK +QFTPPUT: 0,1000 AT+QFDEL='test1.txt' OK LPWA Module Series BG95&BG77 FTP(S) Application Note //Upload test1.txt to FTP(S) server, and the file will be saved as test.txt on FTP(S) server. 2.6. AT+QFTPGET Download a File from FTP(S) Server The command is used to download a file from FTP(S) server. The file can be outputted to COM port by AT+QFTPGET='filename','COM:'. The module will enter data mode on receiving data from server. After the data transfer is completed, the module will exit from data mode automatically and output QFTPGET: 0,. The file can be saved to UFS by AT+QFTPGET='filename','localname'. After the file transfer has been completed, the module will output +QFTPGET: 0,. If the is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If the is not 'COM:', OK will be outputted first, and then +QFTPGET: 0, will be outputted after data transfer is completed. If the module has entered data mode or the is not 'COM:', the configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPGET Download a File from FTP(S) Server Test Command AT+QFTPGET=? Response +QFTPGET: ,,, Write Command When the is 'COM:', that is, to output the data via COM port AT+QFTPGET=,'COM:'[, [,]] OK Response If the module enters data mode successfully: CONNECT OK And then, if the data are successfully downloaded: +QFTPGET: 0, BG95&BG77_FTP(S)_Application_Note 18 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note If failed to download the data: +QFTPGET: , Write Command When the is not 'COM:' AT+QFTPGET=,[,] If there is any error: +CME ERROR: Response OK And then, if the data are successfully downloaded: +QFTPGET: 0, If failed to download the data: +QFTPGET: , If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. String type. The local file name. The maximum size of the parameter is 60 bytes. If it is 'COM:', the file data will be outputted to COM port. If it is not 'COM:', the data will be saved to UFS, and then the file can be read by AT+QFREAD. For more details, please refer to Quectel_BG95&BG77_FILE_Application_Note. Integer type. The start position of the file to be downloaded. The default value is 0. Integer type. The length of data to be downloaded. It is valid only if is 'COM:'. If this parameter is specified, the module will output bytes to COM port and exit from data mode. And data can be downloaded from by the same AT command if there are some data left. Unit: byte. The file data outputted to COM port. Integer type. The length of actually transferred data. If it is less than , it means the file transfer has completed. Unit: byte. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. Example //Download a file and the file will be outputted to COM port. AT+QFTPGET='test.txt','COM:',0 CONNECT BG95&BG77_FTP(S)_Application_Note 19 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note OK +QFTPGET: 0,1000 //Download a file and the file will be outputted to COM port twice in 500 bytes each time. AT+QFTPGET='test.txt','COM:',0,500 //The size of test.txt is 1000 bytes. Download the first 500 bytes. CONNECT OK +QFTPGET: 0,500 AT+QFTPGET='test.txt','COM:',500,500 CONNECT OK //Download the left 500 bytes . +QFTPGET: 0,500 //Download a file and save it to UFS. AT+QFTPGET='test.txt','test2.txt',0 OK +QFTPGET: 0,1000 AT+QFLST='*' +QFLST: 'test2.txt',1000 OK 2.7. AT+QFTPSIZE Get the File Size on FTP(S) Server The command is used to get the file size on FTP(S) server. If OK is returned, +QFTPSIZE: 0, or +QFTPSIZE: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPSIZE Get the File Size on FTP(S) Server Test Command AT+QFTPSIZE=? Response +QFTPSIZE: BG95&BG77_FTP(S)_Application_Note 20 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Write Command AT+QFTPSIZE= OK Response OK And then, if the file size is successfully got: +QFTPSIZE: 0, If failed to get the file size: +QFTPSIZE: , If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The size of file on FTP(S) server. Unit: byte. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. 2.8. AT+QFTPDEL Delete a File on FTP(S) Server The command is used to delete a specified file on FTP(S) server. If OK is returned, +QFTPDEL: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPDEL Delete a File on FTP(S) Server Test Command AT+QFTPDEL=? Response +QFTPDEL: Write Command AT+QFTPDEL= OK Response OK +QFTPDEL: , BG95&BG77_FTP(S)_Application_Note 21 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note If there is any error: +CME ERROR: Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. 2.9. AT+QFTPMKDIR Create a Folder on FTP(S) Server The command is used to create a folder on FTP(S) server. If OK is returned, +QFTPMKDIR: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPMKDIR Create a Folder on FTP(S) Server Test Command AT+QFTPMKDIR=? Response +QFTPMKDIR: Write Command AT+QFTPMKDIR= OK Response OK +QFTPMKDIR: , If there is any error: +CME ERROR: Parameter String type. The folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. BG95&BG77_FTP(S)_Application_Note 22 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 2.10. AT+QFTPRMDIR Delete a Folder on FTP(S) Server The command is used to delete a specified folder on FTP(S) server. If OK is returned, +QFTPRMDIR: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected and the network should be deactivated and reactivated. AT+QFTPRMDIR Delete a Folder on FTP(S) Server Test Command AT+QFTPRMDIR=? Response +QFTPRMDIR: Write Command AT+QFTPRMDIR= OK Response OK +QFTPRMDIR: , If there is any error: +CME ERROR: Parameter String type. The folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. 2.11. AT+QFTPLIST List Content of a Directory on FTP(S) Server The command is used to list the content of a directory on FTP(S) server. If the is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If the is not 'COM:', OK will be returned first, and +QFTPLIST: 0, will be outputted after the content is transferred completely. If the module has entered data mode or the is not 'COM:', the configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. BG95&BG77_FTP(S)_Application_Note 23 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note AT+QFTPLIST List Content of a Directory on FTP(S) Server Test Command AT+QFTPLIST=? Response +QFTPLIST: , Write Command When is 'COM:' AT+QFTPLIST= [,'COM:'] OK Response If the module enters data mode successfully: CONNECT OK And then, if the content of the directory is successfully listed: +QFTPLIST: 0, If failed to list the content: +QFTPLIST: , Write Command When is not 'COM:' AT+QFTPLIST=, If there is any error: +CME ERROR: Response OK And then if the content of the directory is successfully listed: +QFTPLIST: 0, If failed to list the content: +QFTPLIST: , If there is any error: +CME ERROR: Parameter String type. The directory name on FTP(S) server. The maximum size of the parameter is 255 bytes. If it is '.' it will list the content of the current directory configured by AT+QFTPCWD. String type. The local storage location of the data from FTP(S) server. The maximum size of the parameter is 60 bytes. The default value is 'COM:'. If it is 'COM:', the data will be outputted to COM port. If it is not 'COM:', the data will be saved to UFS first and then can be read via AT+QFREAD. For more details, please refer to Quectel_BG95&BG77_FILE_Application_Note. The directory content outputted to COM port. BG95&BG77_FTP(S)_Application_Note 24 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Integer type. The size of transferred data from FTP(S) server. Unit: byte. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. Example //Get the content of the current directory on FTP(S) server and the data will be outputted to COM port. AT+QFTPLIST='.' CONNECT OK +QFTPLIST: 0,1000 //Get the content of a specified directory on FTP(S) server and save it to UFS. AT+QFTPLIST='TESTDIR','test2.txt' OK +QFTPLIST: 0,1000 AT+QFLST='*' +QFLST: 'test2.txt',1000 OK 2.12. AT+QFTPNLST List File Names of a Directory on FTP(S) Server The command is used to list file names of a directory on FTP(S) server. If the is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If the is not 'COM:', OK will be returned first, and then +QFTPNLST: 0, will be outputted after file name transfer is completed. If the module has entered data mode or the is not 'COM:', the configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPNLST List File Names of a Directory on FTP(S) Server Test Command AT+QFTPNLST=? Response +QFTPNLST: , OK BG95&BG77_FTP(S)_Application_Note 25 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Write Command When is 'COM:' AT+QFTPNLST=[,'COM:'] Response If the module enters data mode successfully: CONNECT OK And then, if the file names are successfully listed: +QFTPNLST: 0, If failed to list the file names: +QFTPNLST: , Write Command When is not 'COM:' AT+QFTPNLST=, If there is any error: +CME ERROR: Response OK +QFTPNLST: 0, If there is any error: OK +QFTPNLST: , Or +CME ERROR: Parameter String type. The folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. If it is '.' it will list the file names of the current directory configured by AT+QFTPCWD. String type. The local storage location of the data from FTP(S) server. The maximum size of the parameter is 60 bytes. The default value is 'COM:'. If it is 'COM:', the data will be outputted to COM port. If it is not 'COM:', the data will be saved to UFS first and then can be read via AT+QFREAD. For more details, please refer to Quectel_BG95&BG77_FILE_Application_Note. The file names outputted to COM port. Integer type. The size of transferred data from FTP(S) server. Unit: byte. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. BG95&BG77_FTP(S)_Application_Note 26 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Example //Get the file name of the current directory on FTP(S) server and the data will be outputted to COM port. AT+QFTPNLST='.' CONNECT OK +QFTPNLST: 0,1000 //Get the file name of a specified directory on FTP(S) server and save it to UFS. AT+QFTPNLST='TESTDIR','test2.txt' OK +QFTPNLST: 0,1000 AT+QFLST='*' +QFLST: 'test2.txt',1000 OK 2.13. AT+QFTPMLSD List Standardized File and Directory Information The command is used to list standardized file and directory information on FTP(S) server. If the is 'COM:', CONNECT should be outputted within configured by AT+QFTPCFG. If the is not 'COM:', OK will be returned first and then +QFTPMLSD: 0, will be outputted after the information transfer is completed. If the module has entered data mode or the is not 'COM:', the configured by AT+QFTPCFG indicates the maximum interval time between two packets of received/transmitted data. AT+QFTPMLSD List Standardized File and Directory Information Test Command AT+QFTPMLSD=? Response +QFTPMLSD: , Write Command When is 'COM:' AT+QFTPMLSD=[,'COM:'] OK Response If the module enters data mode successfully: CONNECT OK BG95&BG77_FTP(S)_Application_Note 27 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note And then, if the file and directory information is successfully listed: +QFTPMLSD: 0, If failed to list the file and directory information: +QFTPMLSD: , Write Command When is not 'COM:' AT+QFTPMLSD=, If there is any error: +CME ERROR: Response OK And then, if the file and directory information is successfully listed: +QFTPMLSD: 0, If failed to list the file and directory information: +QFTPMLSD: , If there is any error: +CME ERROR: Parameter String type. The folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. If it is '.' it will list standardized file and directory information configured by AT+QFTPCWD. String type. The local storage location of the data from FTP(S) server. The maximum size of the parameter is 60 bytes. The default value is 'COM:'. If it is 'COM:', the data will be outputted to COM port. If it is not 'COM:', the data will be saved to UFS first and then can be read via AT+QFREAD. For more details, please refer to Quectel_BG95&BG77_FILE_Application_Note. The file and directory information outputted to COM port. Integer type. The size of transferred data from FTP(S) server. Unit: byte. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. Example //Get standardized file and directory information on FTP(S) server and the data will be outputted to COM port. AT+QFTPMLSD ='.' BG95&BG77_FTP(S)_Application_Note 28 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note CONNECT OK +QFTPMLSD: 0,1000 //Get standardized file and directory information on FTP(S) server and save them to UFS. AT+QFTPMLSD='TESTDIR', 'test2.txt' OK +QFTPMLSD: 0,1000 AT+QFLST='*' +QFLST: 'test2.txt',1000 OK 2.14. AT+QFTPMDTM Get the File Modification Time on FTP(S) Server The command is used to get the file modification time on FTP(S) server. If OK is returned, +QFTPMDTM: 0, or +QFTPMDTM: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPMDTM Get the File Modification Time on FTP(S) Server Test Command AT+QFTPMDTM=? Response +QFTPMDTM: Write Command AT+QFTPMDTM= OK Response OK And then, if the file modification time is successfully got: +QFTPMDTM: 0, If failed to get the file modification time: +QFTPMDTM: , If there is any error: +CME ERROR: BG95&BG77_FTP(S)_Application_Note 29 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Parameter String type. The file name on FTP(S) server. The maximum size of the parameter is 255 bytes. String type. The file modification time on FTP(S) server. The format is 'YYYYMMDDHHMMSS' or 'YYYYMMDDHHMMSS.NNN'. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. 2.15. AT+QFTPRENAME Rename a File or Folder on FTP(S) Server The command is used to rename a file or folder on FTP(S) server. If OK is returned, +QFTPRENAME: , should be outputted within configured by AT+QFTPCFG. Otherwise, the FTP(S) connection should be disconnected, and the network should be deactivated and reactivated. AT+QFTPRENAME Rename a File or Folder on FTP(S) Server Test Command AT+QFTPRENAME=? Response +QFTPRENAME: , Write Command AT+QFTPRENAME=, OK Response OK +QFTPRENAME: , If there is any error: +CME ERROR: Parameter String type. The old file name or folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. String type. The new file name or folder name on FTP(S) server. The maximum size of the parameter is 255 bytes. Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. BG95&BG77_FTP(S)_Application_Note 30 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 2.16. AT+QFTPLEN Get the Length of Transferred Data The command is used to get the length of transferred data on FTP(S) server, after executing AT+QFTPPUT, AT+QFTPGET, AT+QFTPNLST and AT+QFTPLIST commands. AT+QFTPLEN Get the Length of Transferred Data Test Command AT+QFTPLEN=? Execution Command AT+QFTPLEN Response OK Response OK +QFTPLEN: 0, If there is any error: +CME ERROR: Parameter Integer type. The length of transferred data on FTP(S) server. Unit: byte. Integer type. The error code of the operation. Please refer to Chapter 5 for details. 2.17. AT+QFTPSTAT Get the Status of FTP(S) Server The command is used to get the status of FTP(S) server. AT+QFTPSTAT Get the Status of FTP Server Test Command AT+QFTPSTAT=? Execution Command AT+QFTPSTAT Response OK Response OK +QFTPSTAT: 0, If there is any error: +CME ERROR: BG95&BG77_FTP(S)_Application_Note 31 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note Parameter Integer type. The current status of FTP(S) server 0 Opening an FTP(S) server 1 The FTP(S) server is open and idle 2 Transferring data with FTP(S) server 3 Closing the FTP(S) server 4 The FTP(S) server is closed Integer type. The error code of the operation. Please refer to Chapter 5 for details. 2.18. AT+QFTPCLOSE Log out from FTP(S) Server The command is used to log out from FTP(S) server. If OK is returned, +QFTPCLOSE: , should be outputted within configured by AT+QFTPCFG. Otherwise, the network should be deactivated and reactivated. AT+QFTPCLOSE Log out from FTP(S) Server Test Command AT+QFTPCLOSE=? Execution Command AT+QFTPCLOSE Response OK Response OK +QFTPCLOSE: , If there is any error: +CME ERROR: Parameter Integer type. The error code of the operation. Please refer to Chapter 5 for details. Integer type. For reference only. Indicates the original error code from FTP(S) server which is defined in FTP(S) protocol. For more details, please refer to Chapter 6. If it is 0, it is invalid. BG95&BG77_FTP(S)_Application_Note 32 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 3 Examples 3.1. Login to FTP Server //Step 1: Configure and activate the PDP context. AT+QICSGP=1,1,'CMNBIOT','','',1 OK //Configure PDP context 1. APN is 'CMNBIOT' for China Mobile NB-IOT network. AT+QIACT=1 OK //Activate PDP context 1. //Activated successfully. AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //Query the state of PDP context. OK AT+QFTPCFG='contextid',1 OK //Configure the PDP context ID as 1 (PDP context 1 has been activated). //Step 2: Configure user account and transfer settings. AT+QFTPCFG='account','test','test' //Set user name and password. OK AT+QFTPCFG='filetype',1 OK //Set the data type as binary. AT+QFTPCFG='transmode',1 OK //Set transfer mode as passive mode. AT+QFTPCFG='rsptimeout',90 OK //Set response timeout value. //Step 3: Login to FTP server. AT+QFTPOPEN='hf.quectel.com',21 OK BG95&BG77_FTP(S)_Application_Note 33 / 49 +QFTPOPEN: 0,0 LPWA Module Series BG95&BG77 FTP(S) Application Note 3.2. Login to FTPS Server //Step 1: Configure and activate the PDP context. AT+QICSGP=1,1,'CMNBIOT','','',1 //Configure PDP context 1. APN is 'CMNBIOT' for China Mobile NB-IOT network. OK AT+QIACT=1 OK //Activate PDP context 1. //Activated successfully. AT+QIACT? +QIACT: 1,1,1, '10.7.157.1' //Query the state of PDP context. OK AT+QFTPCFG='contextid',1 OK //Configure the PDP context ID as 1 (PDP context 1 has been activated). //Step 2: Configure user account and transfer settings. AT+QFTPCFG='account','test','test' //Set user name and password. OK AT+QFTPCFG='filetype',1 OK //Set the data type as binary. AT+QFTPCFG='transmode',1 OK //Set transfer mode as passive mode. AT+QFTPCFG='rsptimeout',90 OK //Step 3: FTPS configuration AT+QFTPCFG='ssltype',1 OK //Set response timeout value. //Set SSL type as 1 (the module works as FTPS client). AT+QFTPCFG='sslctxid',0 OK AT+QFTPCFG='data_sslctxid',1 OK //Select SSL context 0 for control connection. //Select SSL context 1 for data connection. BG95&BG77_FTP(S)_Application_Note 34 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note AT+QSSLCFG='ciphersuite',0,0XFFFF OK //Configure SSL cipher suite type as 0XFFFF, which means all cipher suite types are supported. AT+QSSLCFG='ciphersuite',1,0XFFFF OK //Configure SSL cipher suite type as 0XFFFF, which means all cipher suite types are supported. AT+QSSLCFG='seclevel',0,0 //Configure SSL security level as 0, which means the SSL CA certificate is not needed. AT+QSSLCFG='seclevel',1,0 OK //Configure SSL security level as 0, which means the SSL CA certificate is not needed. AT+QSSLCFG='sslversion',0,4 OK //Configure SSL version as 4, which means all SSL Version. AT+QSSLCFG='sslversion',1,4 OK //Configure SSL version as 4, which means all SSL Version. //Step 4: Login to FTPS server. AT+QFTPOPEN='hf.quectel.com',990 OK +QFTPOPEN: 0,0 3.3. Folder Operation AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPPWD OK +QFTPPWD: 0,'/' AT+QFTPMKDIR=mailto:'TEST' OK +QFTPMKDIR: 0,0 //Set the current directory. //Query the current directory. //Create a folder as TEST on FTP(S) server. BG95&BG77_FTP(S)_Application_Note 35 / 49 AT+QFTPRENAME='TEST','TEST_NEW' OK +QFTPRENAME: 0,0 AT+QFTPRMDIR='TEST_NEW' OK +QFTPRMDIR: 0,0 LPWA Module Series BG95&BG77 FTP(S) Application Note //Rename the folder into TEST_NEW. //Delete the folder. 3.4. File Operation AT+QFTPCWD='/' OK //Set the current directory. +QFTPCWD: 0,0 AT+QFTPPWD OK //Query the current directory. +QFTPPWD: 0, '/' AT+QFTPSIZE='test_my1.txt' OK //Query the size of test_my1.txt on FTP(S) server. +QFTPSIZE: 1000 AT+QFTPRENAME='test_my1.txt','test_new.txt' //Rename the file into test_new.txt. OK +QFTPRENAME: 0,0 AT+QFTPMDTM='test_new.txt' OK //Get the file modification time of test_new.txt on FTP(S) server. +QFTPMDTM: 0, '20140708110039' AT+QFTPDEL='test_new.txt' OK //Delete test_new.txt on FTP(S) server. +QFTPDEL: 0,0 BG95&BG77_FTP(S)_Application_Note 36 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 3.5. List File Information or File Names AT+QFTPCWD='/' OK //Set the current directory. +QFTPCWD: 0,0 AT+QFTPLIST='.','COM:' CONNECT OK //List the content of the current directory and the data will be outputted to COM port. +QFTPLIST: 0,1000 AT+QFTPLIST='.','list.txt' OK //List the content of the current directory and the data will be outputted to list.txt. +QFTPLIST: 0,1000 AT+QFTPLIST='TEST_2','COM:' CONNECT OK //List the content of TEST_2 and the data will be outputted to COM port. +QFTPLIST: 0,1000 AT+QFTPNLST='.','COM:' CONNECT OK //List file names of the current directory and the data will be outputted to COM port. +QFTPNLST: 0,1000 AT+QFTPNLST='.','nlst.txt' OK //List file names of the current directory and the data will be outputted to nlst.txt. +QFTPNLST: 0,1000 BG95&BG77_FTP(S)_Application_Note 37 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note AT+QFTPNLST='TEST_2','COM:' CONNECT OK //List file names of TEST_2 and the data will be outputted to COM port. +QFTPNLST: 0,1000 AT+QFTPMLSD='.','COM:' CONNECT OK //List standardized file and directory information of the current directory and the data will be outputted to COM port. +QFTPMLSD: 0,1000 AT+QFTPMLSD='.','nlst.txt' OK //List standardized file and directory information of the current directory and the data is outputted to nlst.txt. +QFTPMLSD: 0,1000 AT+QFTPMLSD='TEST_2','COM:' CONNECT OK //List standardized directory information of TEST_2 and the data is outputted to COM port. +QFTPMLSD: 0,1000 3.6. Upload a File to FTP(S) Server AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPSTAT +QFTPSTAT: 0,1 OK BG95&BG77_FTP(S)_Application_Note 38 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note //Upload a file via COM port. AT+QFTPPUT='test_my.txt','COM:',0 CONNECT //Input the data via COM port. +++ OK //All data will be saved as test_my.txt on FTP(S) server. //Exit data mode +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my.txt' OK +QFTPSIZE: 0,1000 //Upload a file via COM port and the start position is 1000. AT+QFTPPUT='test_my.txt','COM:',1000 //All data will be saved as test_my.txt on FTP(S) server. CONNECT //Input the file data via COM port +++ //Exit data mode OK +QFTPPUT: 0,500 AT+QFTPSIZE='test_my.txt' OK +QFTPSIZE: 0,1500 //Upload a file via COM port to FTP(S) server twice in 1024 bytes each time. AT+QFTPPUT='test.txt','COM:',0,1024,0 //It is not the last 1024 bytes of test.txt. CONNECT //Input the file data via COM port OK //Data length reaches 1024 bytes. +QFTPPUT: 0,1024 AT+QFTPPUT='test.txt','COM:',1024,1024,1 CONNECT //Input the file data via COM port //It is the last 1024 bytes of test.txt. BG95&BG77_FTP(S)_Application_Note 39 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note OK //Data length reaches 1024 bytes. +QFTPPUT: 0,1024 //Upload a file from UFS to FTP server. AT+QFUPL='test_ufs.txt',1000,300,1 CONNECT //Input 1000 bytes data +QFUPL: 1000,707 //Upload a file to UFS and the file will be saved as test_ufs.txt. The maximum file size is 1000 bytes. 300 indicates timeout value and 1 indicates ACK mode. For more details, please refer to Quectel_BG95&BG77_FILE_Application_Note. OK AT+QFLST='*' +QFLST: 'test_ufs.txt',1000 OK AT+QFTPPUT='test_my1.txt', 'test_ufs.txt',0 OK //Upload test_ufs.txt to FTP(S) server and save it as test_my1.txt on FTP(S) server. +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 AT+QFDEL='test_ufs.txt' OK //Delete the local UFS file. BG95&BG77_FTP(S)_Application_Note 40 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 3.7. Download a File from FTP(S) Server AT+QFTPCWD='/' OK +QFTPCWD: 0,0 //Solution 1: Output downloaded data directly via COM port. //Download a file from FTP(S) server and the data will be outputted to COM port. AT+QFTPGET='test_my.txt','COM:' CONNECT OK +QFTPGET: 0,1000 //Download a file and the data will be outputted to COM port twice in 500 bytes each time. AT+QFTPGET='test.txt','COM:',0,500 //The size of test.txt is 1000 bytes. Download the first 500 bytes. CONNECT OK +QFTPGET: 0,500 AT+QFTPGET='test.txt', 'COM:',500,500 CONNECT OK //Download the left 500 bytes. +QFTPGET: 0,500 //Solution 2: Save the downloaded data into a UFS file. //Download a file from FTP(S) server and save it to UFS. AT+QFTPGET='test_my1.txt','test.txt' //Download the file and save it to UFS as test.txt. OK +QFTPGET: 0,1000 AT+QFLST='*' +QFLST: test.txt,1000 OK BG95&BG77_FTP(S)_Application_Note 41 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note //Download a file from FTP(S) server and save it to UFS. The start position is 450. AT+QFTPGET='test_my1.txt','test1.txt',450 //Download the file and save it to UFS as test.txt. OK +QFTPGET: 0,550 AT+QFTPLEN OK +QFTPLEN: 0,550 AT+QFLST='*' +QFLST: test.txt,1000 +QFLST: test1.txt,550 OK 3.8. Log out from FTP(S) Server AT+QFTPCLOSE OK +QFTPCLOSE: 0,0 AT+QIDEACT=1 OK //Log out from FTP(S) server. //Deactivate the PDP context which was activated for FTP(S). BG95&BG77_FTP(S)_Application_Note 42 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 4 Error Handling 4.1. Executing FTP(S) AT Command Fails When executing FTP(S) AT commands, if ERROR response is received from the module, please check whether the U(SIM) card is inserted and whether it is +CPIN: READY returned when executing AT+CPIN?. 4.2. PDP Activation Fails If it is failed to activate a PDP context with AT+QIACT command, please check the following configurations: 1. Query the PS domain status by AT+CEREG? (for LTE Cat M and Cat NB2 networks) or AT+CGREG? (for EGPRS network) and make sure the PS domain has been registered. 2. Query the PDP context parameters by AT+QICSGP= command and make sure the APN of the specified PDP context has been set. 3. Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT command. 4. The module supports maximum three PDP contexts activated simultaneously under LTE Cat M/ EGPRS and maximum two under LTE Cat NB2. If all above configurations are correct, but activating the PDP context by AT+QIACT command still fails, please reboot the module to resolve this issue. After rebooting the module, please check the configurations mentioned above for at least three times and each time at an interval of 10 minutes to avoid frequent rebooting of the module. 4.3. DNS Parse Fails When executing AT+QFTPOPEN command, if +QFTPOPEN: 604,0 is returned, please check the following aspects: BG95&BG77_FTP(S)_Application_Note 43 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 1. Make sure the domain name of FTP(S) server is valid. 2. Query the status of the PDP context with AT+QIACT? command to make sure the specified PDP context has been activated successfully. 4.4. Error Response of FTP(S) Server When the in +QFTPXX: , is not 0, it indicates an error code replied from FTP(S) server. The issue can be identified based on the returned protocol error code. For example, if is 530 (not logged in), or may be wrong. If is 550 (requested action not taken: file unavailable.), the file or directory may not exist. For more details, please refer to RFC959 - File Transfer Protocol. BG95&BG77_FTP(S)_Application_Note 44 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 5 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about are described in the following table. Table 1: Summary of Error Codes 0 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 Description Operation successful Unknown error FTP(S) server blocked FTP(S) server busy DNS parse failed Network error Control connection closed. Data connection closed Socket closed by peer Timeout error Invalid parameter Failed to open file File position invalid File error Service not available, closing control connection Open data connection failed Connection closed; transfer aborted Requested file action not taken BG95&BG77_FTP(S)_Application_Note 45 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 618 Requested action aborted: local error in processing 619 Requested action not taken: insufficient system storage 620 Syntax error, command unrecognized 621 Syntax error in parameters or arguments 622 Command not implemented 623 Bad sequence of commands 624 Command parameter not implemented 625 Not logged in 626 Need account for storing files 627 Requested action not taken 628 Requested action aborted: page type unknown 629 Requested file action aborted 630 Requested file name invalid 631 SSL authentication failed BG95&BG77_FTP(S)_Application_Note 46 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 6 Summary of FTP(S) Protocol Error Codes The protocol error code indicates an error replied from FTP(S) server when it is not 0. Please refer to RFC959 - File Transfer Protocol. The details of are described in the following table. Table 2: Summary of FTP(S) Protocol Error Codes 421 425 426 450 451 452 500 501 502 503 504 530 532 550 551 552 553 Description Service not available, closing control connection Opening data connection failed Connection closed; transfer aborted Requested file action not taken Requested action aborted: local error in processing Requested action not taken: insufficient system storage Syntax error, command unrecognized Syntax error in parameters or arguments Command not implemented Bad sequence of commands Command parameter not implemented Not logged in Need account for storing files Requested action not taken: file unavailable Requested action aborted: page type unknown Requested file action aborted: exceeded storage allocation Requested action not taken: file name not allowed BG95&BG77_FTP(S)_Application_Note 47 / 49 LPWA Module Series BG95&BG77 FTP(S) Application Note 7 Appendix A References Table 3: Related Documents SN Document Name [1] RFC959 [2] Quectel_BG95&BG77_TCP(IP)_Application_Note [3] Quectel_BG95&BG77_FILE_Application_Note [4] Quectel_BG95&BG77_AT_Commands_Manual [5] Quectel_BG95&BG77_SSL_Application_Note Remark File Transfer Protocol BG95&BG77 TCP/IP AT Commands Manual BG95&BG77 FILE AT Commands Manual BG95&BG77 AT Commands Manual BG95&BG77 SSL AT Commands Manual Table 4: Terms and Abbreviations Abbreviation ACK APN ASCII DNS IP DTR FTP FTPS PDP PPP Description Acknowledgement Access Point Name American Standard Code for Information Interchange Domain Name Server Internet Protocol Data Terminal Ready File Transfer Protocol FTP over SSL Packet Data Protocol Point-to-Point Protocol BG95&BG77_FTP(S)_Application_Note 48 / 49 PS SSL TLS UFS URC (U)SIM LPWA Module Series BG95&BG77 FTP(S) Application Note Packet Switching Secure Sockets Layer Transport Layer Security Universal Flash Storage Unsolicited Result Code (Universal) Subscriber Identity Module BG95&BG77_FTP(S)_Application_Note 49 / 49

BG95&BG77&BG600L Series SSL Application Note LPWA Module Series Version: 1.1 Date: 2021-10-22 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_SSL_Application_Note 1 / 38 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserve BG95&BG77&BG600L_Series_SSL_Application_Note 2 / 38 LPWA Module Series About the Document Revision History Version Date Author Description 1.0 2019-10-12 Terrence YANG Initial 1. Added an applicable module BG600L-M3. 2. Updated the supported SSL cipher suites (Table 3 and Chapter 2.3.1). 3. Added AT+QSSLCFG='renegotiation' (Chapter 2.3.1). 1.1 2021-10-22 Terrence YANG 4. Added AT+QSSLRECV=,0 (Chapter 2.3.4). 5. Added AT+QSSLCRYPT (Chapter 2.3.7). 6. Added an example about setting up a DTLS connection based on PSK encryption (Chapter 3.6). BG95&BG77&BG600L_Series_SSL_Application_Note 3 / 38 LPWA Module Series Contents About the Document ................................................................................................................................ 3 Contents.................................................................................................................................................... 4 Table Index ............................................................................................................................................... 6 1 Introduction ....................................................................................................................................... 7 1.1. Applicable Modules .................................................................................................................. 7 1.2. SSL Versions and Cipher Suites............................................................................................... 8 1.3. Using SSL Function ................................................................................................................ 10 1.4. Description of Data Access Modes ......................................................................................... 10 1.5. Certificate Validity Check .........................................................................................................11 1.6. Server Name Indication .......................................................................................................... 12 2 Description of SSL AT Commands ................................................................................................ 13 2.1. AT Command Introduction ...................................................................................................... 13 2.1.1. Definitions .................................................................................................................... 13 2.1.2. AT Command Syntax ................................................................................................... 13 2.2. Declaration of AT Command Examples .................................................................................. 14 2.3. Description of SSL AT Commands.......................................................................................... 14 2.3.1. AT+QSSLCFG Configure Parameters of an SSL Context ......................................... 14 2.3.2. AT+QSSLOPEN Open an SSL Socket to Connect a Remote Server ....................... 21 2.3.3. AT+QSSLSEND Send Data via SSL Connection ...................................................... 22 2.3.4. AT+QSSLRECV Retrieve Data Through SSL Connection ........................................ 24 2.3.5. AT+QSSLCLOSE Close an SSL Connection ............................................................ 25 2.3.6. AT+QSSLSTATE Query the State of SSL Connections............................................. 25 2.3.7. AT+QSSLCRYPT Encrypt/Decrypt Data with a Specified Algorithm ......................... 27 2.4. Description of URCs ............................................................................................................... 28 2.4.1. +QSSLURC: 'recv' Notify Received Data ................................................................. 28 2.4.2. +QSSLURC: 'closed' Notify Abnormal Disconnection .............................................. 28 3 Examples ......................................................................................................................................... 29 3.1. Configure and Activate a PDP Context ................................................................................... 29 3.1.1. Configure a PDP Context............................................................................................. 29 3.1.2. Activate a PDP Context ............................................................................................... 29 3.1.3. Deactivate a PDP Context ........................................................................................... 29 3.2. Configure an SSL Context ...................................................................................................... 29 3.3. SSL Client in Buffer Access Mode .......................................................................................... 30 3.3.1. Set up an SSL Connection and Enter Buffer Access Mode ......................................... 30 3.3.2. Send Data in Buffer Access Mode ............................................................................... 30 3.3.3. Retrieve Data in Buffer Access Mode .......................................................................... 30 3.3.4. Close an SSL Connection ............................................................................................ 31 3.4. SSL Client in Direct Push Mode ............................................................................................. 31 3.4.1. Set up an SSL Connection and Enter Direct Push Mode............................................. 31 3.4.2. Send Data in Direct Push Mode................................................................................... 31 BG95&BG77&BG600L_Series_SSL_Application_Note 4 / 38 LPWA Module Series 3.4.3. Retrieve Data in Direct Push Mode.............................................................................. 31 3.4.4. Close an SSL Connection ............................................................................................ 32 3.5. SSL Client in Transparent Access Mode................................................................................. 32 3.5.1. Set up an SSL Connection and Send Data in Transparent Access Mode.................... 32 3.5.2. Set up an SSL Connection and Retrieve Data in Transparent Access Mode ............... 32 3.5.3. Close an SSL Connection ............................................................................................ 32 3.6. DTLS Connection Based on PSK Encryption ......................................................................... 33 3.6.1. Set up a DTLS Connection .......................................................................................... 33 3.6.2. Close an SSL Connection ............................................................................................ 33 4 Check for Failure in SSL Connection ............................................................................................ 34 5 Summary of Error Codes................................................................................................................ 35 6 Appendix References ..................................................................................................................... 37 BG95&BG77&BG600L_Series_SSL_Application_Note 5 / 38 LPWA Module Series Table Index Table 1: Applicable Modules ...................................................................................................................... 7 Table 2: Supported SSL Versions .............................................................................................................. 8 Table 3: Supported SSL Cipher Suites ...................................................................................................... 8 Table 4: Types of AT Commands ............................................................................................................. 13 Table 5: Summary of Error Codes ........................................................................................................... 35 Table 6: Related Documents ................................................................................................................... 37 Table 7: Terms and Abbreviations............................................................................................................ 37 BG95&BG77&BG600L_Series_SSL_Application_Note 6 / 38 LPWA Module Series 1 Introduction Quectel BG95 series, BG77 and BG600L-M3 modules support SSL function. SSL (Secure Sockets Layer) is a networking protocol designed for securing connections between web clients and web servers over an insecure network, such as the internet. The SSL function is to ensure the privacy of communication. In some cases, the communication between the server and the client should be encrypted to prevent tampering, eavesdropping attacks, or data forging. 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS BG95&BG77&BG600L_Series_SSL_Application_Note 7 / 38 LPWA Module Series 1.2. SSL Versions and Cipher Suites The following SSL versions are supported by BG95 series, BG77 and BG600L-M3 modules. Table 2: Supported SSL Versions SSL Version SSL3.0 TLS1.0 TLS1.1 TLS1.2 SSL cipher suites supported by the modules are presented in the table below. For detailed description of cipher suites, refer to RFC 2246: The TLS Protocol Version 1.0. Table 3: Supported SSL Cipher Suites Cipher Suite Cide 0X0035 0X002F 0X0005 0X0004 0X000A 0X003D 0XC002 0XC003 0XC004 0XC005 0XC007 Cipher Suite Name TLS_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA256 TLS_ECDH_ECDSA_WITH_RC4_128_SHA TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA TLS_ECDHE_ECDSA_WITH_RC4_128_SHA BG95&BG77&BG600L_Series_SSL_Application_Note 8 / 38 0XC008 0XC009 0XC00A 0XC011 0XC012 0XC013 0XC014 0XC00C 0XC00D 0XC00E 0XC00F 0XC023 0XC024 0XC025 0XC026 0XC027 0XC028 0XC029 0XC02A 0XC02B 0XC02F 0XC0A8 0X00AE 0XC0AE LPWA Module Series TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA TLS_ECDHE_RSA_WITH_RC4_128_SHA TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA TLS_ECDH_RSA_WITH_RC4_128_SHA TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA TLS_ECDH_RSA_WITH_AES_128_CBC_SHA TLS_ECDH_RSA_WITH_AES_256_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 TLS-ECDHE-ECDSA-WITH-AES-128-GCM-SHA256 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_PSK_WITH_AES_128_CCM_8 TLS_PSK_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 BG95&BG77&BG600L_Series_SSL_Application_Note 9 / 38 0XFFFF Support all cipher suites above LPWA Module Series 1.3. Using SSL Function Step 1: Configure , , and other parameters of a PDP context with AT+QICSGP. See document [1] for detailed information. Step 2: Activate the PDP context with AT+QIACT, then the assigned IP address can be queried with AT+QIACT?. See document [1] for detailed information. Step 3: Configure the SSL version, cipher suite, trusted CA certificate path and the security level for a specified SSL context with AT+QSSLCFG. Step 4: Open an SSL socket to connect a remote server with AT+QSSLOPEN. is used to specify SSL context, and is used to specify data access mode. Step 5: After the SSL connection has been established, data will be sent or received via the connection. For detailed information about how to send and receive data in each data access mode, see Chapter 1.4 Step 6: Close SSL connection with AT+QSSLCLOSE. Step 7: Deactivate the PDP context with AT+QIDEACT. See document [1] for detailed information. 1.4. Description of Data Access Modes The SSL connection supports three data access modes: ⚫ Buffer access mode ⚫ Direct push mode ⚫ Transparent transmission mode When opening an SSL connection via AT+QSSLOPEN, you can specify the data access mode with . After the SSL connection is established, you can switch the data access mode with AT+QISWTMD (see document [1] for details). 1. In buffer access mode, the module buffers data upon receiving them and reports a URC in the format of +QSSLURC: 'recv', to notify the host of the incoming data. In such a case, the host can retrieve the buffered data with AT+QSSLRECV. BG95&BG77&BG600L_Series_SSL_Application_Note 10 / 38 LPWA Module Series 2. In direct push mode, the module outputs the received data directly through UART1, USB modem or USB AT port as URC of +QSSLURC: 'recv',,. 3. In transparent transmission mode, the corresponding COM port (UART port, USB modem port, etc.) enters exclusive mode, in which the data received from the port are directly sent to the Internet, and data received from the Internet are directly outputted via the port. ⚫ Exit from transparent transmission mode The module can exit from transparent transmission mode through either of the following ways. 1) Execute +++. Follow the requirements below to prevent the +++ from being misinterpreted as data: a) Do not input any character within 1 second before and after inputting +++. b) Input +++ within 1 second, and wait until OK is returned. When OK is returned, the module is switched to buffer access mode. 2) Change MAIN_DTR from LOW to HIGH to make the module enter command mode. In this case, set AT&D1 (see document [2]) before the module enters transparent transmission mode. ⚫ Return to transparent transmission mode 1) By AT+QISWTMD. Specify as 2 when executing this command. When transparent transmission mode is entered successfully, CONNECT is returned. 2) By ATO (see document [2]). After a connection exits from transparent transmission mode, executing ATO will switch the data access mode back to transparent transmission mode. When transparent transmission mode is entered successfully, CONNECT is returned. If no connection has entered transparent transmission mode before, ATO returns NO CARRIER. 1.5. Certificate Validity Check To check certificate validity, compare your local time against certificate validity range ('Not before' and 'Not after'). If the local time is earlier than the 'Not before' time or later than the 'Not after' time the certificate has expired. When certificate validity check is required (set as 0 when executing AT+QSSLCFG), to avoid validity period check failure, execute AT+CCLK to configure the module time within the certificate validity period. See document [2] for detailed information about AT+CCLK. BG95&BG77&BG600L_Series_SSL_Application_Note 11 / 38 LPWA Module Series 1.6. Server Name Indication SNI (Server Name Indication) allows the server to safely host multiple TLS Certificates since it provides Server Host Name information as an extension in the client hello message. It thus enhances connection security with multiple virtual servers based on a single IP address. This feature is only applicable to TLS protocol. BG95&BG77&BG600L_Series_SSL_Application_Note 12 / 38 LPWA Module Series 2 Description of SSL AT Commands 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals to its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 4: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_SSL_Application_Note 13 / 38 LPWA Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about how to use the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples and that they should be executed in a given sequence. 2.3. Description of SSL AT Commands 2.3.1. AT+QSSLCFG Configure Parameters of an SSL Context The command configures the SSL version, cipher suite, security level, CA certificate, client certificate and client key. These parameters will be used in the handshake procedure. is the index of the SSL context. The module supports 6 SSL contexts at most. Several SSL connections can be established based on one SSL context. The settings such as the SSL version and the cipher suite are stored in the SSL context, and they will be applied to the new SSL connections associated with the SSL context. AT+QSSLCFG Configure Parameters of an SSL Context Test Command AT+QSSLCFG=? Response +QSSLCFG: 'sslversion',(range of supported s),(range of supported s) +QSSLCFG: 'ciphersuite',(range of supported s),(list of supported s) +QSSLCFG: 'cacert',(range of supported s), +QSSLCFG: 'clientcert',(range of supported s), +QSSLCFG: 'clientkey',(range of supported s), +QSSLCFG: 'seclevel',(range of supported s),(range of supported s) +QSSLCFG: 'session',(range of supported s),(list of supported s) +QSSLCFG: 'sni',(range of supported s),(list of supported s) +QSSLCFG: 'checkhost',(range of supported s),(list of supported s) BG95&BG77&BG600L_Series_SSL_Application_Note 14 / 38 LPWA Module Series +QSSLCFG: 'ignorelocaltime',(range of supported s),(list of supported s) +QSSLCFG: 'negotiatetime',(range of supported s),(range of supported s) +QSSLCFG: 'renegotiation',(range of supported s),(list of supported s) +QSSLCFG: 'dtls',(range of supported s),(list of supported s) +QSSLCFG: 'dtlsversion',(range of supported s),(range of supported s) Write Command AT+QSSLCFG='sslversion',[,] OK Response If the optional parameter is omitted, query the current SSL version of the specified SSL context: +QSSLCFG: 'sslversion',, OK Write Command AT+QSSLCFG='ciphersuite',[,] If the optional parameter is specified, set the SSL version for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query the current SSL cipher suite of the specified SSL context: +QSSLCFG: 'ciphersuite',, OK Write Command AT+QSSLCFG='cacert',[, ] If the optional parameter is specified, set the SSL cipher suite for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query the current path of trusted CA certificate for the specified SSL context: +QSSLCFG: 'cacert',, OK BG95&BG77&BG600L_Series_SSL_Application_Note 15 / 38 LPWA Module Series Write Command AT+QSSLCFG='clientcert',[,] If the optional parameter is specified, set the path of trusted CA certificate for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query the current path of client certificate for the specified SSL context: +QSSLCFG: 'clientcert',, OK Write Command AT+QSSLCFG='clientkey',[,] If the optional parameter is specified, set the path of client certificate for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query the current path of client private key for the specified SSL context: +QSSLCFG: 'clientkey',, OK Write Command AT+QSSLCFG='seclevel',[,] If the optional parameter is specified, set the path of the client private key for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query the current authentication mode of the specified SSL context: +QSSLCFG: 'seclevel',, Write Command AT+QSSLCFG='session',[,] OK If the optional parameter is specified, set the authentication mode for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query whether SSL Resumption feature is enabled for the specified SSL context: +QSSLCFG: 'session',, BG95&BG77&BG600L_Series_SSL_Application_Note 16 / 38 LPWA Module Series OK Write Command AT+QSSLCFG='sni',[,] If the optional parameter is specified, enable/disable SSL Resumption feature for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query whether server name indication feature is enabled for the specified SSL context: +QSSLCFG: 'sni',, OK Write Command AT+QSSLCFG='checkhost',[,] If the optional parameter is specified, enable/disable server name indication feature for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query whether the hostname validation feature is enabled for the specified SSL context: +QSSLCFG: 'checkhost',, OK Write Command AT+QSSLCFG='ignorelocaltime',[,] If the optional parameter is specified, enable/disable hostname validation feature for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query whether the certificate validity check is ignored for the specified SSL context: +QSSLCFG: 'ignorelocaltime',, OK If the optional parameter is specified, set whether or not to BG95&BG77&BG600L_Series_SSL_Application_Note 17 / 38 LPWA Module Series Write Command AT+QSSLCFG='negotiatetime',[,] ignore certificate validity check for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query the maximum timeout of SSL negotiation for the specified SSL context: +QSSLCFG: 'negotiatetime',, OK Write Command AT+QSSLCFG='renegotiation',[,] If the optional parameter is specified, set the maximum timeout of SSL negotiation for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query whether support for TLS renegotiation is enabled for the specified SSL context: +QSSLCFG: 'renegotiation',, OK Write Command AT+QSSLCFG='dtls',[,] If the optional parameter is specified, set whether to enable support for TLS renegotiation for the specified SSL context: OK Or ERROR Response If the optional parameter is omitted, query whether DTLS feature is enabled for the specified SSL context: +QSSLCFG: 'dtls',, OK If the optional parameter is specified, set whether to enable DTLS feature for the specified SSL context: OK Or ERROR BG95&BG77&BG600L_Series_SSL_Application_Note 18 / 38 LPWA Module Series Write Command AT+QSSLCFG='dtlsversion',[,] Response If the optional parameter is omitted, query the current DTLS version of the specified SSL context: +QSSLCFG: 'dtlsversion',, OK Maximum Response Time Characteristics If the optional parameter is specified, set the DTLS version of the specified SSL context: OK Or ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. SSL context ID. Range: 0–5. Integer type. SSL Version. 0 SSL3.0 1 TLS1.0 2 TLS1.1 3 TLS1.2 4 All Numeric type in HEX format. SSL cipher suites. 0X0035 TLS_RSA_WITH_AES_256_CBC_SHA 0X002F TLS_RSA_WITH_AES_128_CBC_SHA 0X0005 TLS_RSA_WITH_RC4_128_SHA 0X0004 TLS_RSA_WITH_RC4_128_MD5 0X000A TLS_RSA_WITH_3DES_EDE_CBC_SHA 0X003D TLS_RSA_WITH_AES_256_CBC_SHA256 0XC002 TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0XC003 TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0XC004 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0XC005 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0XC007 TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0XC008 TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0XC009 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0XC00A TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0XC011 TLS_ECDHE_RSA_WITH_RC4_128_SHA 0XC012 TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA BG95&BG77&BG600L_Series_SSL_Application_Note 19 / 38 LPWA Module Series 0XC013 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0XC014 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0XC00C TLS_ECDH_RSA_WITH_RC4_128_SHA 0XC00D TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0XC00E TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0XC00F TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0XC023 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0XC024 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0XC025 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0XC026 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0XC027 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0XC028 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0XC029 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0XC02A TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0XC02B TLS-ECDHE-ECDSA-WITH-AES-128-GCM-SHA256 0XC02F TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0XC0A8 TLS_PSK_WITH_AES_128_CCM_8 0X00AE 0XC0AE TLS_PSK_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0XFFFF Support all String type. The path of the trusted CA certificate. String type. The path of the client certificate. String type. The path of the client private key. Integer type. Authentication mode. 0 No authentication 1 Perform server authentication 2 Perform server and client authentication if requested by the remote server Integer type. Enable or disable SSL Resumption feature. 0 Disable 1 Enable Integer type. Enable or disable Server Name Indication feature. DNS hostnames are currently the only supported server names. 0 Disable 1 Enable Integer type. Enable or disable hostname validation feature (Subject Common Name (CN) matches the specified host name). 0 Disable 1 Enable Integer type. Whether or not to ignore certificate validity check. 0 Not to ignore 1 Ignore Integer type. The maximum timeout of SSL negotiation. Range: 10–300. Default value: 300. Unit: second. BG95&BG77&BG600L_Series_SSL_Application_Note 20 / 38 LPWA Module Series Integer type. Enable or disable support for TLS renegotiation. 0 Disable 1 Enable Integer type. Enable or disable DTLS feature. 0 Disable 1 Enable Integer type. DTLS version. 0 DTLS1.0 1 DTLS1.2 2 Both 2.3.2. AT+QSSLOPEN Open an SSL Socket to Connect a Remote Server The command sets up an SSL connection. During the negotiation between the module and the Internet, parameters configured with AT+QSSLCFG will be used in the handshake procedure. After successful handshake with the Internet, the module can send or receive data via this SSL connection. In addition, the module can set up several SSL connections based on one SSL context. According to steps mentioned in Chapter 1.3, execute AT+QIACT first to activate the PDP context and then execute AT+QSSLOPEN. It is suggested to wait for a specific period of time (refer to the Maximum Response Time below) for +QSSLOPEN: , URC to be outputted. If the URC cannot be received during that time, use AT+QSSLCLOSE to close the SSL connection. AT+QSSLOPEN Open an SSL Socket to Connect a Remote Server Test Command AT+QSSLOPEN =? Response +QSSLOPEN: (range of supported s),(range of supported s),(range of supported s),,,(range of supported s) Write Command AT+QSSLOPEN=,,,,[,] OK Response If the =2 (transparent access mode) and the SSL connection is successfully set up: CONNECT If the =0/1 (buffer access mode or direct push mode): OK BG95&BG77&BG600L_Series_SSL_Application_Note 21 / 38 LPWA Module Series Maximum Response Time Characteristics +QSSLOPEN: , If there is any error: ERROR Maximum network response time of 150 s, plus configured time of . The command takes effect immediately. The configurations will not be saved. Parameter Integer type. PDP context ID. Range: 1–16. Integer type. SSL context ID. Range: 0–5. Integer type. Socket index. Range: 0–11. String type. Remote server address. Integer type. The listening port of remote server. Range: 0–65535. Integer type. The data access mode of SSL connection. 0 Buffer access mode 1 Direct push mode 2 Transparent transmission mode The error code of the operation. See Chapter 5. Integer type. The maximum timeout of SSL negotiation. Range: 10–300. Default value: 300. Unit: second. NOTE Error description can be got via AT+QIGETERROR. For more details, refer to document [1]. 2.3.3. AT+QSSLSEND Send Data via SSL Connection After the connection is established, the module can send data through the SSL connection. AT+QSSLSEND Send Data via SSL Connection Test Command AT+QSSLSEND=? Response +QSSLSEND: (range of supported s), (range of supported s) Write Command Send variable-length data OK Response > BG95&BG77&BG600L_Series_SSL_Application_Note 22 / 38 AT+QSSLSEND= Write Command Send fixed-length data AT+QSSLSEND=, Maximum Response Time Characteristics LPWA Module Series After the above response, input the data to be sent. Tap CTRL+Z to send, and tap ESC to cancel the operation. If the connection has been established and sending is successful: SEND OK If the connection has been established but sending buffer is full: SEND FAIL If the connection has not been established, abnormally closed, or any parameter is incorrect: ERROR Response > After the above response, input the data until the data length equals . If the connection has been established and sending is successful: SEND OK If the connection has been established butsending buffer is full: SEND FAIL If the connection has not been established, abnormally closed, or the parameter is incorrect: ERROR 300 ms / Parameter Integer type. Socket index. Range: 0–11. Integer type. The length of data to be sent. Range: 1–1460. Unit: byte. BG95&BG77&BG600L_Series_SSL_Application_Note 23 / 38 LPWA Module Series 2.3.4. AT+QSSLRECV Retrieve Data Through SSL Connection When an SSL connection is opened with specified as 0 (buffer access mode), the module reports URC +QSSLURC: 'recv', when it receives data from the Internet. You can read the data from buffer with AT+QSSLRECV. AT+QSSLRECV Retrieve Data Through SSL Connection Test Command AT+QSSLRECV=? Response +QSSLRECV: (range of supported s),(range of supported s) Write Command When is not 0, retrieve the data in specified length AT+QSSLRECV=[,] OK Response If the specified connection has received data: +QSSLRECV: OK When the buffer is empty: +QSSLRECV: 0 Write Command When is 0, query the retrieved data length AT+QSSLRECV=,0 OK If any parameter is incorrect or the connection cannot be established: ERROR Response If the specified connection exists: +QSSLRECV: ,, OK Maximum Response Time Characteristics If there is any error: ERROR 300 ms / Parameter Integer type. Socket index. Range: 0–11. Integer type. The length of data to be retrieved. Range: 0–1500. Default BG95&BG77&BG600L_Series_SSL_Application_Note 24 / 38 LPWA Module Series value: 1500. Unit: byte. Integer type. Length of the data that have been actually retrieved. Unit: byte. String type. Retrieved data. Integer type. Total length of received data. Unit: byte. Integer type. Length of the data that have been retrieved. Unit: byte. Integer type. Length of the data that have not been retrieved. Unit: byte. 2.3.5. AT+QSSLCLOSE Close an SSL Connection The command closes an SSL connection. If all the SSL connections based on the same SSL context are closed, the module releases the SSL context. AT+QSSLCLOSE Close an SSL Connection Test Command AT+QSSLCLOSE=? Response +QSSLCLOSE: (range of supported s),(range of supported s) Write Command AT+QSSLCLOSE=[,] Maximum Response Time Characteristics OK Response OK Or ERROR 10 s by default, determined by parameter The command takes effect immediately. The configuration will not be saved. Parameter Integer type. Socket index. Range: 0–11. Integer type. The timeout value of AT+QSSLCLOSE. Range: 0–65535. Default value: 10. Unit: second. 0 means closing immediately. 2.3.6. AT+QSSLSTATE Query the State of SSL Connections The command queries the state of SSL connections. AT+QSSLSTATE Query the State of SSL Connections Test Command AT+QSSLSTATE=? Write Command AT+QSSLSTATE= Response OK Response +QSSLSTATE: ,'SSLClient',,,,,,,,< AT_port>, OK Response +QSSLSTATE: ,'SSLClient',,,,,,,,< AT_port>, [...] OK 300 ms / Parameter Integer type. Socket index. Range: 0–11. String type. Remote server address. Integer type. Remote server port. Range: 0–65535. Integer type. Local port. Range: 0–65535. Integer type. The state of SSL connection. 0 'Initial' Connection has not been established. 1 'Opening' Client is connecting. 2 'Connected' Connection has been established. 4 'Closing' Connection is closing Integer type. PDP context ID. Range: 1–16. Integer type. Reserved. The value is usually the same as . Integer type. The data access mode of SSL connection. 0 Buffer access mode 1 Direct push mode 2 Transparent transmission mode String type. COM port. Integer type. SSL context ID. Range: 0–5. BG95&BG77&BG600L_Series_SSL_Application_Note 26 / 38 LPWA Module Series 2.3.7. AT+QSSLCRYPT Encrypt/Decrypt Data with a Specified Algorithm This command encrypts/decrypts data with a specified algorithm. It supports AES-128-CBC encryption/decryption and MD5 encryption. AT+ QSSLCRYPT Encrypt/Decrypt Data with a Specified Algorithm Test Command AT+QSSLCRYPT=? Response +QSSLCRYPT: ('AES','MD5'),,(list of supported s),(list of supported s), Write Command AT+QSSLCRYPT='AES',,, OK Response +QSSLCRYPT: 'AES', OK Write Command AT+QSSLCRYPT='MD5', If there is any error: ERROR Response +QSSLCRYPT: 'MD5', OK Maximum Response Time Characteristic If there is any error: ERROR 300 ms / Parameter In AES-128-CBC mode: The data to be encrypted or decrypted. The data format is specified by . The maximum length of is 256 bytes. The length of data to be encrypted/decrypted with AES-128-CBC should be a multiple of 16 bytes. In MD5 mode: String type. The data to be encrypted. The maximum length of is 256 bytes. Integer type. The format of input data. 0 String format 1 Hex format Integer type. AES-128-CBC mode. 0 AES-128-CBC decryption BG95&BG77&BG600L_Series_SSL_Application_Note 27 / 38 LPWA Module Series 1 AES-128-CBC encryption String type. The encryption/decryption key of AES-128-CBC. The length must be 16 bytes. Hex String type. The encrypted data or decrypted data. 2.4. Description of URCs 2.4.1. +QSSLURC: 'recv' Notify Received Data The URC notifies the data received from peer in buffer access mode and direct push mode. +QSSLURC: 'recv' Notify Received Data +QSSLURC: 'recv', +QSSLURC: 'recv',, The URC of SSL data incoming in buffer access mode. SSL data can be retrieved with AT+QSSLRECV. The URC of SSL data incoming in direct push mode. Parameter Integer type. Socket index. Range: 0–11. Integer type. The length of actual received data. Unit: byte. The actual received data. 2.4.2. +QSSLURC: 'closed' Notify Abnormal Disconnection The URC notifies that the SSL connection has been disconnected. Disconnection can be caused by many reasons. For example, the Internet closes the connection or the state of GPRS PDP is deactivated, and the SSL connection state based on the specified socket may be 'closing'. In such case, AT+QSSLCLOSE= must be executed to change the SSL connection state to 'initial'. +QSSLURC: 'closed' Notify Abnormal Disconnection +QSSLURC: 'closed', The SSL connection based on the specified socket is closed. Parameter Integer type. Socket index. Range: 0–11. BG95&BG77&BG600L_Series_SSL_Application_Note 28 / 38 LPWA Module Series 3 Examples 3.1. Configure and Activate a PDP Context 3.1.1. Configure a PDP Context AT+QICSGP=1,1,'CMNBIOT','','',1 OK //Configure PDP context as 1. APN is 'CMNBIOT' for China Mobile NB-IoT network 3.1.2. Activate a PDP Context AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'100.142.162.0' OK //Activate PDP context 1. //Activated the context successfully. //Query the context state, protocol type and IP address of PDP context 1. 3.1.3. Deactivate a PDP Context AT+QIDEACT=1 OK //Deactivate PDP context 1. //Deactivated the context successfully. 3.2. Configure an SSL Context AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0X0035 OK AT+QSSLCFG='seclevel',1,1 //Set SSL context ID as 1 and SSL version as TLS1.0. //Set SSL context ID as 1 and cipher suite as TLS_RSA_WITH_AES_256_CBC_SHA. //Set SSL context ID as 1 and authentication mode as BG95&BG77&BG600L_Series_SSL_Application_Note 29 / 38 LPWA Module Series server OK AT+QSSLCFG='cacert',1,'cacert.pem' OK authentication. //Set path of the trusted CA certificate of SSL context ID 1 3.3. SSL Client in Buffer Access Mode 3.3.1. Set up an SSL Connection and Enter Buffer Access Mode AT+QSSLOPEN=1,1,4,'220.180.239.212',8010,0 //Set up an SSL connection. OK +QSSLOPEN: 4,0 //Set up the SSL connection successfully. AT+QSSLSTATE //Query the state of SSL connections. +QSSLSTATE: 4,'SSLClient','220.180.239.212',8010,65344,2,1,4,0,'usbmodem',1 OK 3.3.2. Send Data in Buffer Access Mode AT+QSSLSEND=4 > Test data from SSL SEND OK AT+QSSLSEND=4,18 > Test data from SSL SEND OK //Send variable-length data. //Send fixed-length data and the data length is 18 bytes. 3.3.3. Retrieve Data in Buffer Access Mode +QSSLURC: 'recv',4 AT+QSSLRECV=4,1500 +QSSLRECV: 18 Test data from SSL //The Socket 4 (=4) has received data. //Retrieve the data. The length of data to be retrieved is 1500 bytes. //The retrieved data length is 18 bytes. OK AT+QSSLRECV=4,1500 +QSSLRECV: 0 //The buffer is empty. BG95&BG77&BG600L_Series_SSL_Application_Note 30 / 38 LPWA Module Series OK 3.3.4. Close an SSL Connection AT+QSSLCLOSE=4 OK //Close the connection (=4). Depending on the network, the maximum response time is 10 s. 3.4. SSL Client in Direct Push Mode 3.4.1. Set up an SSL Connection and Enter Direct Push Mode AT+QSSLOPEN= 1,1,4,'220.180.239.212',8011,1 //Set up an SSL connection. OK +QSSLOPEN: 4,0 //Set up the SSL connection successfully. AT+QSSLSTATE //Query the status of SSL connections. +QSSLSTATE: 4,'SSLClient','220.180.239.212',8011,65047,2,1,4,1,'usbmodem',1 OK 3.4.2. Send Data in Direct Push Mode AT+QSSLSEND=4 > Test data from SSL //Send variable-length data. SEND OK AT+QSSLSEND=4,18 > Test data from SSL //Send fixed-length data and the data length is 18 bytes. SEND OK 3.4.3. Retrieve Data in Direct Push Mode +QSSLURC: 'recv',4,18 Test data from SSL BG95&BG77&BG600L_Series_SSL_Application_Note 31 / 38 LPWA Module Series 3.4.4. Close an SSL Connection AT+QSSLCLOSE=4 OK //Close the connection (=4). Depending on the network, the maximum response time is 10 s. 3.5. SSL Client in Transparent Access Mode 3.5.1. Set up an SSL Connection and Send Data in Transparent Access Mode AT+QSSLOPEN= 1,1,4,'220.180.239.212',8011,2 CONNECT OK server //Set up an SSL connection. //Enter transparent transmission mode. //The client is sending data from COM port to the Internet directly. (The data are not visible in the example.) //Use +++ or MAIN_DTR (set AT&D1 first) to exit transparent transmission mode. The NO CARRIER result code indicates that the has stopped the SSL connection. 3.5.2. Set up an SSL Connection and Retrieve Data in Transparent Access Mode AT+QSSLOPEN= 1,1,4,'220.180.239.212',8011,2 CONNECT OK //Set up an SSL connection. //The client is reading the data. //Use +++ or MAIN_DTR (set AT&D1 first) to exit transparent transmission mode. The NO CARRIER result code indicates that the server has stopped the SSL connection. 3.5.3. Close an SSL Connection AT+QSSLCLOSE=4 OK //Close the connection (=4). Depending on the network, the maximum response time is 10 s. BG95&BG77&BG600L_Series_SSL_Application_Note 32 / 38 LPWA Module Series 3.6. DTLS Connection Based on PSK Encryption 3.6.1. Set up a DTLS Connection AT+QFUPL='0_server.psk' CONNECT +QFUPL: 24,553 //Upload PSK file first. The PSK file should be named as SSL_ctxID_server.psk (0_server.psk for instance) and the content of the file should be in the format of & (e.g., DTLS_Client&1a2b3c4d). OK AT+QSSLCFG='dtls',0,1 //Enable DTLS feature for SSL context 0. OK AT+QSSLCFG='dtlsversion',0,0 //Configure DTLS version to DTLS1.0 for SSL context 0. OK AT+QSSLCFG='ciphersuite',0,0X00AE //Configure cipher suite for SSL context 0. OK AT+QSSLOPEN=1,0,0,'220.180.239.201',8010,0 OK +QSSLOPEN: 0,0 //Set up the SSL connection successfully. AT+QSSLSTATE //Query the status of SSL connections. +QSSLSTATE: 0,'SSLClient','220.180.239.201',8010,65344,2,1,4,0,'usbmodem',1 OK 3.6.2. Close an SSL Connection AT+QSSLCLOSE=0 OK //Close the connection (=0). Depending on the network, the maximum response time is 10 s. BG95&BG77&BG600L_Series_SSL_Application_Note 33 / 38 LPWA Module Series 4 Check for Failure in SSL Connection Please find reasons for the failure to open an SSL connection as follows: 1. Query the status of the specified PDP context with AT+QIACT? to check whether the specified PDP context has been activated. 2. If the address of server is a domain name, please check whether the address of DNS server is valid with AT+QIDNSCFG=. Because an invalid DNS server address cannot convert domain name to IP address. 3. Check the SSL configuration with AT+QSSLCFG, especially the SSL version and cipher suite, to make sure that they are supported on server side. If has been configured as 1 or 2, then the trusted CA certificate has to be uploaded to the module with AT+QFUPL (see document [3]). If the server has configured 'SSLVerifyClient required', the client certificate and client private key have to be uploaded to the module with AT+QFUPL (see document [3]). For detailed information about certificate validity check, see Chapter 1.5. And for more information about related FILE AT commands, see document [2]. BG95&BG77&BG600L_Series_SSL_Application_Note 34 / 38 LPWA Module Series 5 Summary of Error Codes If an ERROR is returned after executing SSL AT commands, the details of error can be queried by AT+QIGETERROR. Please note that AT+QIGETERROR just returns error code of the last SSL AT command. Table 5: Summary of Error Codes 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 Meaning Operation successful Unknown error Operation blocked Invalid parameter Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy BG95&BG77&BG600L_Series_SSL_Application_Note 35 / 38 565 DNS parse failed 566 Socket connection failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context break down 571 Cancel send 572 Operation not allowed 573 APN not configured 574 Port busy LPWA Module Series BG95&BG77&BG600L_Series_SSL_Application_Note 36 / 38 LPWA Module Series 6 Appendix References Table 6: Related Documents Document Name [1] Quectel_BG95&BG77&BG600L_Series_TCP(IP)_Application_Note [2] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual_V2.0 [3] Quectel_BG95&BG77&BG600L_Series_FILE_Application_Note Table 7: Terms and Abbreviations Abbreviation APN CA CR DNS DTR DTLS EGPRS GPRS ID IP LF PDP SNI Description Access Point Name Certificate Authority Carriage Return Domain Name Server Data Terminal Ready Datagram Transport Layer Security Enhanced General Packet Radio Service General Packet Radio Service Identifier Internet Protocol Line Feed Packet Data Protocol Server Name Indication BG95&BG77&BG600L_Series_SSL_Application_Note 37 / 38 SSL TCP TLS UART URC USB LPWA Module Series Secure Sockets Layer Transmission Control Protocol Transport Layer Security Universal Asynchronous Receiver/Transmitter Unsolicited Result Code Universal Serial Bus BG95&BG77&BG600L_Series_SSL_Application_Note 38 / 38

BG95&BG77 FILE Application Note LPWA Module Series Rev. BG95&BG77_FILE_Application_Note_V1.0 Date: 2019-09-02 Status: Released www.quectel.com LPWA Module Series BG95&BG77 FILE Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. BG95&BG77_FILE_Application_Note 1 / 22 LPWA Module Series BG95&BG77 FILE Application Note About the Document History Revision 1.0 Date 2019-09-02 Author Alfred LI Description Initial BG95&BG77_FILE_Application_Note 2 / 22 LPWA Module Series BG95&BG77 FILE Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 1.1. The Process of Using FILE AT Commands ................................................................................ 5 1.2. Description of Data Mode ........................................................................................................... 6 2 Description of FILE AT Commands ................................................................................................... 7 2.1. AT+QFLDS Get the Space Information of Storage.................................................................. 7 2.2. AT+QFLST List Files Information ............................................................................................. 8 2.3. AT+QFDEL Delete Files ........................................................................................................... 9 2.4. AT+QFUPL Upload a File ....................................................................................................... 10 2.5. AT+QFDWL Download a File ................................................................................................. 12 2.6. AT+QFOPEN Open a File ...................................................................................................... 12 2.7. AT+QFREAD Read a File....................................................................................................... 13 2.8. AT+QFWRITE Write a File ..................................................................................................... 14 2.9. AT+QFSEEK Set File Pointer to a Position............................................................................ 15 2.10. AT+QFPOSITION Get the Offset of a File Pointer................................................................. 16 2.11. AT+QFTUCAT Truncate a File from the File Pointer ............................................................. 16 2.12. AT+QFCLOSE Close a File.................................................................................................... 17 3 Examples ............................................................................................................................................ 18 3.1. Upload and Download Files ...................................................................................................... 18 3.1.1. Upload a File .................................................................................................................. 18 3.1.2. Download a File ............................................................................................................. 19 3.2. Write and Read Files................................................................................................................. 19 3.2.1. Write and Read a UFS File ............................................................................................ 19 4 Summary of Error Codes .................................................................................................................. 20 5 Appendix A Reference....................................................................................................................... 22 BG95&BG77_FILE_Application_Note 3 / 22 LPWA Module Series BG95&BG77 FILE Application Note Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 20 TABLE 2: TERMS AND ABBREVIATIONS ........................................................................................................ 22 BG95&BG77_FILE_Application_Note 4 / 22 LPWA Module Series BG95&BG77 FILE Application Note 1 Introduction Quectel BG95 and BG77 modules provide AT commands to operate files in UFS. UFS is the User File Storage directory on modem side. It is a special directory on the flash file system. This document is a reference guide to these AT commands. 1.1. The Process of Using FILE AT Commands The following illustrates the procedure to create, read and write a file in the storage: 1) A file can be uploaded to the storage by AT+QFUPL, and can be outputted/downloaded through the serial interfaces by AT+QFDWL. 2) Open the file by AT+QFOPEN, and then the file can be written or read at any time and any location until the file is closed by AT+QFCLOSE. ⚫ When the file is opened by AT+QFOPEN, it can be set as overwrite mode or read-only mode or others by the parameter . (For more information about , please refer to Chapter 2.6). After the file is opened, a is assigned to it. Then the file can be operated via this . ⚫ After the file is opened, it can be written by AT+QFWRITE and read by AT+QFREAD from the current file position. ⚫ The file position can be set by AT+QFSEEK and the current position can be queried by AT+QFPOSITION. ⚫ AT+QFTUCAT will truncate the file from the current position to the end of the file. 3) AT+QFCLOSE is used to close the file, after which the becomes meaningless any more. The following are several commonly used commands to manage files in the storage: 1) AT+QFLDS: Get the storage size 2) AT+QFLST: List the file information in the storage. 3) AT+QFDEL: Delete the file(s) BG95&BG77_FILE_Application_Note 5 / 22 LPWA Module Series BG95&BG77 FILE Application Note 1.2. Description of Data Mode The COM port of BG95 and BG77 modules has two working modes: AT command mode and data mode. In AT command mode, the inputted data via COM port will be treated as AT command. While in data mode, it will be treated as data. Inputting +++ or pulling up DTR (AT&D1 should be set first) can make the COM port exit from data mode. To prevent the +++ from being misinterpreted as data, the following sequence should be followed: 1) Do not input any character within 1s (at least or longer) before inputting +++. 2) Input +++ within 1s, and no other characters can be inputted during the time. 3) Do not input any character within 1s after +++ has been inputted. When AT+QFUPL, AT+QFDWL, AT+QFREAD and AT+QFWRITE are executed, the COM port will enter data mode. If customers are using +++ or DTR to make the port exit from data mode, the executing procedure of these commands will be interrupted before the response is returned. In such case, the COM port cannot reenter data mode by executing ATO command. BG95&BG77_FILE_Application_Note 6 / 22 LPWA Module Series BG95&BG77 FILE Application Note 2 Description of FILE AT Commands 2.1. AT+QFLDS Get the Space Information of Storage The command responds the space information of the specified storage. AT+QFLDS Get the Space Information of Storage Test Command AT+QFLDS=? Write Command AT+QFLDS= Response OK Response +QFLDS: , OK Execution Command AT+QFLDS If there is any error: +CME ERROR: Response Return the UFS information: +QFLDS: , OK If there is any error: +CME ERROR: Parameter Storage pattern. 'UFS' UFS on modem side The free space size of UFS. Unit: byte. The total size of UFS. Unit: byte. The size of all files in UFS. Unit: byte The number of files in UFS. An error code relating to ME or network. Please refer to Chapter 4 for details. BG95&BG77_FILE_Application_Note 7 / 22 Examples AT+QFLDS='UFS' +QFLDS: 1249984, 1562624 OK AT+QFLST='*' +QFLST: 'Test1.txt',10 +QFLST: 'Test2.txt',16 +QFLST: 'Test3.txt',150 +QFLST: 'Test4.txt',2056 +QFLST: 'Test5.txt',98 OK AT+QFLDS +QFLDS: 2330,5 OK LPWA Module Series BG95&BG77 FILE Application Note //Query the space information of UFS. //Query the size and number of all files in UFS. 2.2. AT+QFLST List Files Information The command lists the information of a single file or all files in the specified storage medium. AT+QFLST List Files Information Test Command AT+QFLST=? Write Command AT+QFLST= Response OK Response +QFLST: , [+QFLST: , […]] OK Execution Command AT+QFLST If there is any error: +CME ERROR: Response Return the information of UFS files: +QFLST: , [+QFLST: , […]] BG95&BG77_FILE_Application_Note 8 / 22 LPWA Module Series BG95&BG77 FILE Application Note OK If there is any error: +CME ERROR: Parameter The file to be listed. '*' All the files in UFS '' A specified file in UFS Name of the file. The maximum length of is 80 bytes. Size of the file. Unit: byte. An error code relating to ME or network. Please refer to Chapter 4 for details. Examples AT+QFLST='*' +QFLST: 'F_M12-1.bmp',562554 +QFLST: 'F_M12-10.bmp',562554 +QFLST: 'F_M12-11.bmp',562554 OK AT+QFLST='Test1.txt' +QFLST: 'Test1.txt',2 OK //List all the files in UFS. //List a specified file 'Test1.txt' in UFS. 2.3. AT+QFDEL Delete Files The command deletes a specified file or all the files in the storage. AT+QFDEL Delete Files Test Command AT+QFDEL=? Response +QFDEL: Write Command AT+QFDEL= OK Response OK BG95&BG77_FILE_Application_Note 9 / 22 LPWA Module Series BG95&BG77 FILE Application Note If there is any error: +CME ERROR: Parameter Name of the file to be deleted. The maximum length of is 80 bytes. '*' All the files in UFS '' A specified file in UFS An error code relating to ME or network. Please refer to Chapter 4 for details. Examples AT+QFDEL='*' OK AT+QFDEL='Test1.txt' OK 2.4. AT+QFUPL Upload a File The command is used to upload a file to the storage. If any file in the storage has the same name with the file uploaded, an error will be reported. After executing the write command and 'CONNECT' returns, the module will switch to data mode. When the uploaded data reaches , or there is no any data inputted when is reached, it will exit from data mode automatically. During data transmission, customers can use +++ or DTR to make the module exit from data mode, and more details are provided in Chapter 1.2. AT+QFUPL Upload a File Test Command AT+QFUPL=? Response +QFUPL: [,(1-)[,(1-65535)[,(0,1)]]] Write Command AT+QFUPL=[,[, [,]]] OK Response CONNECT TA switches to the data mode (transparent access mode), and the binary data of file can be inputted. When the total size of the inputted data reaches (unit: byte), TA will return to command mode and reply the following codes: +QFUPL: , BG95&BG77_FILE_Application_Note 10 / 22 LPWA Module Series BG95&BG77 FILE Application Note OK If there is any error: +CME ERROR: Parameter The free space size of UFS. Please refer to AT+QFLDS command for more details. Name of the file to be uploaded. The maximum length is 80 bytes. '' Upload the file to UFS The file size expected to be uploaded. The default value is 10240. Unit: byte. The actual size of the uploaded data. Unit: byte. The time waiting for data to be inputted to USB/UART. Range: 1- 65535. The default value is 5. Unit: s. Whether to use ACK mode. 0 Turn off the ACK mode by default. 1 Turn on the ACK mode. The checksum of the uploaded data. An error code relating to ME or network. Please refer to Chapter 4 for details. NOTES 1. It is strongly recommended to use DOS 8.3 file name format for . 2. is a 16-bit checksum based on bitwise XOR. If the number of the characters is odd, set the last character as the high 8 bit, and the low 8 bit as 0, and then use an XOR operator to calculate the checksum. +++ sequence will make TA end the command and switch to command mode. However, the data previously uploaded will be preserved in the file. 3. When executing the command, the data must be entered after 'CONNECT' is returned. 4. The ACK mode is provided to avoid the loss of data when uploading a large file, in case hardware flow control does not work. The ACK mode works as follows: 1) Run AT+QFUPL=,,,1 command to enable the ACK mode. 2) BG95 and BG77 modules output 'CONNECT'. 3) MCU sends 1K bytes data, and then BG95 and BG77 modules will respond with an 'A'. 4) MCU receives this 'A' and then sends the next 1K bytes data; 5) Repeat step 3) and 4) until the transfer is completed. BG95&BG77_FILE_Application_Note 11 / 22 LPWA Module Series BG95&BG77 FILE Application Note 2.5. AT+QFDWL Download a File The command downloads a specified file from the storage. AT+QFDWL Download a File Test Command AT+QFDWL=? Response +QFDWL: Write Command AT+QFDWL= OK Response CONNECT TA switches to data mode, and the binary data of the file will be outputted. When the file is read over, TA will return to command mode and reply the following codes: +QFDWL: , OK If there is any error: +CME ERROR: Parameter Name of the file to be downloaded. The maximum length is 80 bytes. '' Download the file from UFS The size of the downloaded data. Unit: byte The checksum of the downloaded data. An error code relating to ME or network. Please refer to Chapter 4 for details. NOTES 1. +++ sequence will cause TA to end the command and switch to command mode. 2. is a 16-bit checksum based on bitwise XOR. 2.6. AT+QFOPEN Open a File The command can be used to open a file and get the file handle to be used in commands such as AT+QFREAD, AT+QFWRITE, AT+QFSEEK, AT+QFPOSITION, AT+QFTUCAT and AT+QCLOSE. BG95&BG77_FILE_Application_Note 12 / 22 LPWA Module Series BG95&BG77 FILE Application Note AT+QFOPEN Open a File Test Command AT+QFOPEN=? Response +QFOPEN: [,(0-2)] Read Command AT+QFOPEN? OK Response +QFOPEN: ,, [+QFOPEN: ,, […]] Write Command AT+QFOPEN=[,] OK Response +QFOPEN: OK If there is any error: +CME ERROR: Parameter Name of the file to be opened. The maximum length is 80 bytes. '' Open the file in UFS The handle of the file to be operated. The open mode of the file. 0 If the file does not exist, it will be created. If the file exists, it will be directly opened. And both of them can be read and written. 1 If the file does not exist, it will be created. If the file exists, it will be overwritten. And both of them can be read and written. 2 If the file exists, open it and it can be read only. When the file does not exist, an error will be responded. An error code relating to ME or network. Please refer to Chapter 4 for details. 2.7. AT+QFREAD Read a File The command reads the data of a file which is specified by the file handle. The data starts from the current position of the file pointer which belongs to the file handle. BG95&BG77_FILE_Application_Note 13 / 22 LPWA Module Series BG95&BG77 FILE Application Note AT+QFREAD Read a File Test Command AT+QFREAD=? Response +QFREAD: [,] Write Command AT+QFREAD=[,] OK Response CONNECT TA switches to data mode. When the total size of the data reaches (unit: byte), TA will return to command mode, display the result and then reply the following codes: OK If there is any error: +CME ERROR: Parameter The handle of the file to be operated. The length of the file to be read out and the default is the file length. Unit: byte. The actual read length. Unit: byte. An error code relating to ME or network. Please refer to Chapter 4 for details. 2.8. AT+QFWRITE Write a File The command is used to write data into a file. The data starts from the current position of the file pointer which belongs to the file handle. AT+QFWRITE Write a File Test Command AT+QFWRITE=? Response +QFWRITE: [,[,]] Write Command AT+QFWRITE=[, [,]] OK Response CONNECT TA switches to data mode. When the total size of the written data reaches (unit: byte) or the time reaches , TA will return to command mode and reply the following codes: +QFWRITE: , BG95&BG77_FILE_Application_Note 14 / 22 LPWA Module Series BG95&BG77 FILE Application Note OK If there is any error: +CME ERROR: Parameter The handle of the file to be operated. The length of the file to be written, and the default length is 10K. The maximum value of this parameter is determined by of AT+QFUPL. Unit: byte. The time waiting for data to be inputted to USB/UART. Range: 1- 65535. The default value is 5. Unit: s. The actual written length. Unit: byte. The total length of the file. Unit: byte. An error code relating to ME or network. Please refer to Chapter 4 for details. 2.9. AT+QFSEEK Set File Pointer to a Position The command sets a file pointer to a specified position. This will decide the starting position of commands such as AT+QFREAD, AT+QFWRITE, AT+QFPOSITION and AT+QFTUCAT. AT+QFSEEK Set File Pointer to a Position Test Command AT+QFSEEK=? Response +QFSEEK: ,[,] Write Command AT+QFSEEK=,[,< position>] OK Response OK If there is any error: +CME ERROR: Parameter The handle of the file to be operated. The number of bytes of the file pointer movement. Pointer movement mode. 0 The beginning of the file. 1 The current position of the pointer. 2 The end of the file. BG95&BG77_FILE_Application_Note 15 / 22 LPWA Module Series BG95&BG77 FILE Application Note An error code relating to ME or network. Please refer to Chapter 4 for details. NOTES 1. If is 0 and exceeds the file size, the command will return 'ERROR'. 2. If is 1 and the total size of and the current position of the pointer exceed the file size, the command will return 'ERROR'. 3. If is 2, the handle will move forth. 2.10. AT+QFPOSITION Get the Offset of a File Pointer The command gets the offset of a file pointer from the beginning of the file. AT+QFPOSITION Get the Offset of a File Pointer Test Command AT+QFPOSITION=? Response +QFPOSITION: Write Command AT+QFPOSITION= OK Response +QFPOSITION: OK If there is any error: +CME ERROR: Parameter The handle of the file to be operated. The offset from the beginning of the file. An error code relating to ME or network. Please refer to Chapter 4 for details. 2.11. AT+QFTUCAT Truncate a File from the File Pointer The command will truncate all the data behind the position that the file pointer indicates. BG95&BG77_FILE_Application_Note 16 / 22 LPWA Module Series BG95&BG77 FILE Application Note AT+QFTUCAT Truncate a File from the File Pointer Test Command AT+QFTUCAT=? Response +QFTUCAT: Write Command AT+QFTUCAT= OK Response OK If there is any error: +CME ERROR: Parameter The handle of the file to be operated. An error code relating to ME or network. Please refer to Chapter 4 for details. 2.12. AT+QFCLOSE Close a File The command closes a file and ends all the operation to the file. After that, the file handle is released and should not be used again, unless open the file again with AT+QFOPEN. AT+QFCLOSE Close a File Test Command AT+QFCLOSE=? Response +QFCLOSE: Write Command AT+QFCLOSE= OK Response OK If there is any error: +CME ERROR: Parameter The handle of the file to be operated. An error code relating to ME or network. Please refer to Chapter 4 for details. BG95&BG77_FILE_Application_Note 17 / 22 LPWA Module Series BG95&BG77 FILE Application Note 3 Examples 3.1. Upload and Download Files 3.1.1. Upload a File 3.1.1.1. Non ACK Mode AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK //Upload the text file 'test1.txt' to UFS. 3.1.1.2. ACK Mode The ACK mode can make the data transmission more reliable. When transmitting a large file without hardware flow control, the ACK mode is recommended to be used to prevent the data from being lost. For more details about ACK mode, please refer to AT+QFUPL command. AT+QFUPL='test.txt',3000,5,1 CONNECT A A +QFUPL: 3000,B34A //Upload the text file 'test.txt' to UFS. //After receiving 1024 bytes data, BG95&BG77 will respond an 'A'. And then the next 1024 bytes data can be inputted. OK BG95&BG77_FILE_Application_Note 18 / 22 3.1.2. Download a File AT+QFDWL='test.txt' CONNECT +QFDWL: 10,613e OK LPWA Module Series BG95&BG77 FILE Application Note //Download the text file 'test.txt' from UFS. //Get the bytes of the downloaded data and the checksum. 3.2. Write and Read Files 3.2.1. Write and Read a UFS File AT+QFOPEN='test',0 +QFOPEN: 0 //Open the file to get the file handle. OK AT+QFWRITE=0,10 CONNECT +QFWRITE: 10,10 //Write 10 bytes to the file. //The actual bytes written and the size of the file are returned. OK AT+QFSEEK=0,0,0 OK AT+QFREAD=0,10 CONNECT 10 //Set the file pointer to the beginning of the file. //Read 10 bytes from the file. OK AT+QFCLOSE=0 OK //Close the file. BG95&BG77_FILE_Application_Note 19 / 22 LPWA Module Series BG95&BG77 FILE Application Note 4 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about are described in the following table, and these error codes are only related to file operation of BG95&BG77 modules. Table 1: Summary of Error Codes 400 401 402 403 405 406 407 409 410 411 413 414 416 417 418 419 Meaning Invalid input value Larger than the size of the file Read zero byte Drive full File not found Invalid file name File already existed Fail to write the file Fail to open the file Fail to read the file Reach the max number of file allowed to be opened The file read-only Invalid file descriptor Fail to list the file Fail to delete the file Fail to get disk info BG95&BG77_FILE_Application_Note 20 / 22 LPWA Module Series BG95&BG77 FILE Application Note 420 No space 421 Time out 423 File too large 425 Invalid parameter 426 File already opened BG95&BG77_FILE_Application_Note 21 / 22 LPWA Module Series BG95&BG77 FILE Application Note 5 Appendix A Reference Table 2: Terms and Abbreviations Abbreviation COM DOS ME TA UART UFS USB Description Communication Port Disk Operating System Mobile Equipment Terminal Adapter Universal Asynchronous Receiver-Transmitter User File Storage Universal Serial Bus BG95&BG77_FILE_Application_Note 22 / 22

BG95&BG77 eDRX 应用指导 LPWA 模块系列 版本：BG95&BG77_eDRX_应用指导_V1.0 日期：2019-10-24 状态：受控文件 www.quectel.com BG95&BG77 eDRX 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 18 文档历史 修订记录 版本 日期 作者 1.0 2019-10-24 韩彦钊 变更表述 初始版本 BG95&BG77 eDRX 应用指导 上海移远通信技术股份有限公司 2 / 18 BG95&BG77 eDRX 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 eDRX 简介............................................................................................................................................. 7 3 eDRX 配置相关命令.............................................................................................................................. 8 3.1. AT+CEDRXS eDRX 设置 ........................................................................................................ 8 3.2. AT+CEDRXRDP 查询 eDRX 状态..........................................................................................11 4 eDRX 配置常见问题............................................................................................................................ 14 4.1. 网络分配的 eDRX 周期或 PTW 与请求不符............................................................................. 14 4.2. 无法开启 eDRX 功能 ................................................................................................................ 14 5 eDRX 应用场景 ................................................................................................................................... 15 5.1. 低功耗模式分类 ........................................................................................................................ 15 5.2. 推荐的低功耗应用方案 ............................................................................................................. 15 5.2.1. 推荐使用 eDRX 的应用场景 .......................................................................................... 15 5.2.2. 推荐使用 DRX 的应用场景 ............................................................................................ 16 5.2.3. 推荐使用 PSM 的应用场景 ............................................................................................ 16 6 eDRX 耗流数据 ................................................................................................................................... 17 7 附录 A 术语缩写 ................................................................................................................................. 18 上海移远通信技术股份有限公司 3 / 18 BG95&BG77 eDRX 应用指导 表格索引 表 1：BG95 耗流数据（中国移动 NB-IOT 实网） ............................................................................................. 17 表 2：BG77 耗流数据（中国移动 NB-IOT 实网） ............................................................................................. 17 表 3：术语和缩写............................................................................................................................................... 18 上海移远通信技术股份有限公司 4 / 18 BG95&BG77 eDRX 应用指导 图片索引 图 1：DRX 示意图 ............................................................................................................................................... 7 图 2：EDRX 示意图 ............................................................................................................................................. 7 上海移远通信技术股份有限公司 5 / 18 BG95&BG77 eDRX 应用指导 1 引言 移远通信一直关注模块功耗的优化，以确保客户终端产品整体功耗最大程度的降低。随着物联网通信 技术的迅速发展以及节能减排环保意识的不断加强，移动通信将提供更多不同的低功耗方案以满足客户对 其终端产品越来越严苛的功耗要求。 NB-IoT 和 eMTC 作为蜂窝系统中一项全新的无线接入技术，对功耗有更加严苛的要求，例如其终端可 能要求一块电池可维持正常工作长达数年之久。为了进一步降低终端功耗、满足终端设备对极低功耗的需 求，移远通信 NB-IoT/eMTC 模块均支持低功耗方案。 移远通信 BG95 和 BG77 模块支持 DRX、eDRX 和 PSM 等多种低功耗方案。本文档主要介绍如何通 过 eDRX 的不同参数配置，实现该模块在不同场景下达到功耗与实时性需求的平衡。 上海移远通信技术股份有限公司 6 / 18 BG95&BG77 eDRX 应用指导 2 eDRX 简介 DRX 是一种节省终端功耗的工作模式，其基本原理是让模块周期性地进入休眠模式；休眠期间，模块 将不监听 PDCCH、关闭收发单元，以降低其功耗。 DRX 作用于 Idle 态中，通过在 Idle 态中周期性监听寻呼的方式来降低模块功耗，示意图如下所示。但 DRX 参数由网络决定，模块无法修改也无法建议网络修改。 图 1：DRX 示意图 为进一步降低功耗，NB-IoT 不仅支持传统 LTE 的 DRX 模式，还支持扩展的 DRX 周期，即 eDRX。eDRX 目的与 DRX 相同，均是通过让模块周期性进入休眠状态以达到降低功耗的目的。其基本的原理是将 Idle 态 分成寻呼期和休眠期：在寻呼期，模块的工作模式和 LTE 的 DRX 一致；在休眠期，模块不监听下行寻呼。 相比 DRX，eDRX 可支持更长的寻呼周期，以达到进一步降低功耗的目的，示意图如下所示： 图 2：eDRX 示意图 eDRX 模式下，模块只在 PTW 内按 DRX 周期监听下行寻呼、接收下行业务（打开接收机）；如果在休 眠期有数据发给模块，模块并不能及时接收，只能等到当前 eDRX 周期完毕后再次进入 PTW 监听寻呼。因 此，eDRX 模式下，模块功耗的降低以实时性为'代价'，实际应用时需要根据业务模型，确定合适的 eDRX 周期和 PTW 值，以达到功耗与实时性的平衡。 上海移远通信技术股份有限公司 7 / 18 BG95&BG77 eDRX 应用指导 3 eDRX 配置相关命令 如下命令可以设置不同的 eDRX 参数，以实现不同应用场景下的多样应用需求。如果 AT 命令执行报错 或需了解相关 AT 命令的更多详情，请参考 Quectel_BG95&BG77_AT_Commands_Manual。 3.1. AT+CEDRXS eDRX 设置 该命令用于设置 UE 的 eDRX 参数，即设置 UE 是否使用 eDRX 以及指定接入技术请求的 eDRX 值。 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的取值),(支持的取值), (支持的取值) 查询命令 AT+CEDRXS? OK 响应 [+CEDRXS: , [+CEDRXS: , [...]]] 设置命令 AT+CEDRXS=[[,[, ]]] 最大响应时间 OK 响应 OK 若出现任何错误： ERROR 300 毫秒 生效机制 立即生效；参数设置将保存至 NVM 参数 整型。启用或禁用 eDRX。 0 禁用 eDRX 1 启用 eDRX 上海移远通信技术股份有限公司 8 / 18 BG95&BG77 eDRX 应用指导 2 启用 eDRX 并启用 URC +CEDRXP: [,[, [,]]]上报 3 禁用 eDRX，并清除所有的 eDRX 参数配置或者重置为默认值（若有） 整型。接入技术类型。 2 GSM（该命令中不支持此参数取值） 4 eMTC 5 NB-IoT 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。 位数 4 321 E-UTRAN eDRX 周期 0 000 5.12 秒 0 001 10.24 秒 0 010 20.48 秒 0 011 40.96 秒 0 100 61.44 秒 0 101 81.92 秒 0 110 102.4 秒 0 111 122.88 秒 1 000 143.36 秒 1 001 163.84 秒 1 010 327.68 秒 1 011 655.36 秒 1 100 1310.72 秒 1 101 2621.44 秒 1 110 5242.88 秒 1 111 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 0 0 5.12 秒 0 0 0 1 10.24 秒 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 0 61.44 秒 0 1 0 1 81.92 秒 0 1 1 0 102.4 秒 0 1 1 1 122.88 秒 1 0 0 0 143.36 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 上海移远通信技术股份有限公司 9 / 18 BG95&BG77 eDRX 应用指导 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时间窗。 eMTC 模式 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 1.28 秒 0 0 0 1 2.56 秒 0 0 1 0 3.84 秒 0 0 1 1 5.12 秒 0 1 0 0 6.4 秒 0 1 0 1 7.68 秒 0 1 1 0 8.96 秒 0 1 1 1 10.24 秒 1 0 0 0 11.52 秒 1 0 0 1 12.8 秒 1 0 1 0 14.08 秒 1 0 1 1 15.36 秒 1 1 0 0 16.64 秒 1 1 0 1 17.92 秒 1 1 1 0 19.20 秒 1 1 1 1 20.48 秒 NB-IoT 模式 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 上海移远通信技术股份有限公司 10 / 18 举例 AT+CEDRX=1,5,'0000' OK BG95&BG77 eDRX 应用指导 //设置 eDRX 周期为 5.12 秒 3.2. AT+CEDRXRDP 查询 eDRX 状态 若 eDRX 用于 UE 当前注册的小区，执行命令将返回、、 和。 AT+CEDRXRDP 查询 eDRX 状态 测试命令 AT+CEDRXRDP=? 执行命令 AT+CEDRXRDP 响应 OK 响应 +CEDRXRDP: [,[,< NW-provided_eDRX_value>[,]]] 最大响应时间 生效机制 OK 300 毫秒 / 参数 整型。接入技术类型。 2 GSM（该命令中不支持此参数取值） 4 eMTC 5 NB-IoT 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。 位数 4 321 E-UTRAN eDRX 周期 0 000 0 001 5.12 秒 10.24 秒 0 010 0 011 20.48 秒 40.96 秒 0 100 0 101 61.44 秒 81.92 秒 0 110 102.4 秒 0 111 122.88 秒 1 000 143.36 秒 1 001 163.84 秒 上海移远通信技术股份有限公司 11 / 18 BG95&BG77 eDRX 应用指导 1 010 327.68 秒 1 011 655,36 秒 1 100 1310.72 秒 1 101 2621.44 秒 1 110 5242.88 秒 1 111 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 位数 4 321 E-UTRAN eDRX 周期 0 000 5.12 秒 0 001 10.24 秒 0 010 20.48 秒 0 011 40.96 秒 0 100 61.44 秒 0 101 81.92 秒 0 110 102.4 秒 0 111 122.88 秒 1 000 143.36 秒 1 001 163.84 秒 1 010 327.68 秒 1 011 655.36 秒 1 100 1310.72 秒 1 101 2621.44 秒 1 110 5242.88 秒 1 111 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时间窗。 eMTC 模式 位数 4 321 寻呼时间窗长度 0 000 1.28 秒 0 001 2.56 秒 0 010 3.84 秒 0 011 5.12 秒 0 100 6.4 秒 0 101 7.68 秒 0 110 8.96 秒 0 111 10.24 秒 1 000 11.52 秒 1 001 12.8 秒 1 010 14.08 秒 1 011 15.36 秒 1 100 16.64 秒 1 101 17.92 秒 1 110 19.20 秒 上海移远通信技术股份有限公司 12 / 18 BG95&BG77 eDRX 应用指导 1 111 NB-IoT 模式 位数 4 321 0 000 0 001 0 010 0 011 0 100 0 101 0 110 0 111 1 000 1 001 1 010 1 011 1 100 1 101 1 110 1 1 1 1 20.48 秒 寻呼时间窗长度 2.56 秒 5.12 秒 7.68 秒 10.24 秒 12.8 秒 15.36 秒 17.92 秒 20.48 秒 23.04 秒 25.6 秒 28.16 秒 30.72 秒 33.28 秒 35.84 秒 38.4 秒 40.96 秒 上海移远通信技术股份有限公司 13 / 18 BG95&BG77 eDRX 应用指导 4 eDRX 配置常见问题 4.1. 网络分配的 eDRX 周期或 PTW 与请求不符  问题 网络分配的 eDRX 周期或 PTW 与模块所请求的不同。  原因分析 3GPP 协议规定模块使用的 eDRX 周期需要与网络协商，由两者协商决定。 模块可通过 Attach request/TAU request 消息将一组 eDRX 参数发送给网络以告知网络模块可以支持 的和期望的 eDRX 参数配置，但最终可使用的 eDRX 参数由网络配置决定。网络将参考模块所请求的 eDRX 参数、APN 和 IMSI 为不同的模块配置不同的值，并在 Attach accept/TAU accept 消息中携带并发送给模 块。因此，网络分配的 eDRX 周期与模块请求的 eDRX 周期可能有所不同。 另外，eDRX 周期和 PTW 均应是 DRX 周期的整数倍，如果所请求的参数并非 DRX 周期的整数倍，则 网络分配的值会做相应的更改。 4.2. 无法开启 eDRX 功能  问题 通过软件配置启用 eDRX 后，eDRX 参数配置实际无法生效；无论配置什么 eDRX 参数，模块均按照 DRX 模式工作。  原因分析 启用 eDRX 后无法生效的，请咨询网络运营商，以确认所用 USIM 卡在网络侧是否已开通 eDRX 功能， 以及该卡签约的 APN 是否支持 eDRX 功能。 上海移远通信技术股份有限公司 14 / 18 BG95&BG77 eDRX 应用指导 5 eDRX 应用场景 5.1. 低功耗模式分类 BG95 和 BG77 模块支持三种低功耗应用模式：DRX、eDRX 和 PSM。 DRX 模式下，模块在每个 DRX 周期监听一次寻呼信道，功耗相对 eDRX 和 PSM 来说较高。 eDRX 就是模块不断地打开、关闭接收机。打开接收机时能够接收数据，关闭接收机时则无法接收数 据；eDRX 周期即由关闭接收机和打开接收机这两个完整的时段组成，支持配置的时长为 20.48s ~ 2.92h。 eDRX 功耗较 DRX 低。 与 eDRX 相比，PSM 打开、关闭接收机的频率更低，可低至几天打开一次接收机。PSM 周期内，模 块仅在接收机打开的时间内能够接收到数据，接收机关闭的时间内将无法接收下行数据。PSM 模式下，功 耗只有微安级，终端在此工作模式下才可能实现极低的功耗，如'一节电池用数年'。 5.2. 推荐的低功耗应用方案 根据不同的应用场景，移远通信推荐客户使用不同的低功耗模式。 5.2.1. 推荐使用 eDRX 的应用场景 eDRX 在兼顾低功耗的同时，可以实现网络的快速响应；比如可通过配置使模块实现休眠若干分钟， 再唤醒工作，再休眠若干分钟。因此 eDRX 适用于无需频繁发送数据、但需要实现快速响应的应用场景。 对于物流监控等隔几十分钟才需要进行一次数据业务的应用，即推荐使用 eDRX。 此外，对于监控时间要求可修改的应用，例如宠物跟踪器应用中，可通过设置不同的 eDRX 参数实现 不同场景下的应用需求。正常情况下，服务器可以每 2621s 或者 5242s 采集一次宠物位置信息；当宠物丢 失时，通过服务器修改 eDRX 参数，模块接收到控制信息后，重新配置 eDRX 周期为 20.48s 或者 40.96s， 服务器即可每 20.48s 或者 40.96s 采集一次宠物位置信息。这样可以最大程度地平衡客户需求及设备省电 需求。 上海移远通信技术股份有限公司 15 / 18 BG95&BG77 eDRX 应用指导 5.2.2. 推荐使用 DRX 的应用场景 共享单车锁、智能锁等应用场景中，实时性要求较高（远程开锁之后，开锁动作应立即响应并完成）， 此时建议使用 DRX 方案。 5.2.3. 推荐使用 PSM 的应用场景 对于远程水表/煤气表类的表计行业应用，一般情况下几天或更久才需要给服务器传输一次用水/用气量 数据即可满足需求，这类应用推荐使用 PSM。 上海移远通信技术股份有限公司 16 / 18 BG95&BG77 eDRX 应用指导 6 eDRX 耗流数据 表 1：BG95 耗流数据（中国移动 NB-IoT 实网） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 待定 待定 待定 表 2：BG77 耗流数据（中国移动 NB-IoT 实网） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 待定 待定 待定 备注 BG95 和 BG77 模块实网下耗流数据将在下个版本中提供，目前数据正在优化中。 上海移远通信技术股份有限公司 17 / 18 BG95&BG77 eDRX 应用指导 7 附录 A 术语缩写 表 3：术语和缩写 术语 APN DRX eDRX eMTC NB-IoT NVM LTE PDCCH PSM PTW TAU 3GPP UE USIM 英文全称 Access Point Name Discontinuous Reception extended DRX Enhanced Machine-Type Communication Narrowband Internet of Things Non-Volatile Memory Long Term Evolution Physical Downlink Control Channel Power Saving Mode Paging Time Window Tracking Area Update 3rd Generation Partnership Project User Equipment Universal Subscriber Identification Module 中文全称 接入点名称 非连续接收 扩展型非连续接收 增强型机器类通讯 窄带物联网 非易失性存储器 长期演进 物理下行控制信道 省电模式 寻呼时间窗 跟踪区更新 第三代合作伙伴计划 用户设备 全球用户身份模块 上海移远通信技术股份有限公司 18 / 18

BC25&BC32 MQTT 应用指导 NB-IoT 模块系列 版本：BC25&BC32_MQTT_应用指导_V1.0 日期：2019-11-08 状态：受控文件 www.quectel.com BC25&BC32 MQTT 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 28 BC25&BC32 MQTT 应用指导 文档历史 修订记录 版本 1.0 日期 2019-11-08 作者 宋聪强 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 28 BC25&BC32 MQTT 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 MQTT 数据交互..................................................................................................................................... 6 3 MQTT 相关 AT 命令 .............................................................................................................................. 7 3.1. AT 命令语法................................................................................................................................ 7 3.2. MQTT 相关 AT 命令 ................................................................................................................... 8 3.2.1. AT+QMTCFG 配置 MQTT 参数 .................................................................................... 8 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 .................................................................... 12 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 .................................................................. 13 3.2.4. AT+QMTCONN 连接客户端到 MQTT 服务器............................................................. 14 3.2.5. AT+QMTDISC 断开客户端与 MQTT 服务器的连接.................................................... 16 3.2.6. AT+QMTSUB 订阅主题 .............................................................................................. 17 3.2.7. AT+QMTUNS 退订主题 .............................................................................................. 18 3.2.8. AT+QMTPUB 发布消息 .............................................................................................. 19 4 错误码 ................................................................................................................................................. 22 5 MQTT 相关 URC ................................................................................................................................. 23 5.1. +QMTSTAT MQTT 链路层状态变化的 URC.......................................................................... 23 5.2. +QMTRECV 通知 Host 主机读取 MQTT 数据包的 URC....................................................... 24 6 举例 ..................................................................................................................................................... 25 6.1. 无 SSL 的 MQTT 操作举例....................................................................................................... 25 7 附录 A 参考文档及术语缩写................................................................................................................ 28 上海移远通信技术股份有限公司 3 / 28 BC25&BC32 MQTT 应用指导 表格索引 表 1：AT 命令及响应类型 .................................................................................................................................... 7 表 2：错误码 ...................................................................................................................................................... 22 表 3：MQTT 相关的 URC .................................................................................................................................. 23 表 4：URC +QMTSTAT 中的错误码 .................................................................................................................. 23 表 5：参考文档 .................................................................................................................................................. 28 表 6：术语缩写 .................................................................................................................................................. 28 上海移远通信技术股份有限公司 4 / 28 BC25&BC32 MQTT 应用指导 1 引言 MQTT 是基于代理服务器发布/订阅范式的通讯协议，有开放，简单，轻量和易于实现等特点。MQTT 最大的优势在于，可以以极少的代码和有限的网络带宽，为远程设备连接提供实时可靠的消息服务。 本文档介绍如何通过 AT 命令应用移远通信 BC25 和 BC32 模块的 MQTT 功能。 上海移远通信技术股份有限公司 5 / 28 BC25&BC32 MQTT 应用指导 2 MQTT 数据交互 本章节介绍了 MQTT 功能的数据交互机制。 MCU 模块 链路层 MQTT服务器 数据上报类型（非URC）： +QMT***: ,...,,… AT+QMTCFG='WILL',,.. (1) =0：从服务器接收ACK数据包； AT+QMTCFG='USER',,.. (2) =1：数据包发送超时并重新传输； …... (3) =2：数据包发送超时，且已达到最 大允许重传次数。 AT+QMTOPEN= ,, OK TCP请求 AT+QMT CO NN +QMTOPEN: , AT+QMTCONN=,,... OK +QMTCONN: ,,... TCP已创建 连接请求 Start timer T1, T2 返回连接ACK指示 Stop T1 or handle Excep1 TCP同步 TCP同步&ACK TCP ACK 发送连接数据包 服务器收到连接数据包并返回ACK T1是数据包传输超时时 间. T2 是keep alive定时器. 在T2超时时间内若没有 数据相关信息传输，客 户端会发送心跳请求 包。 AT+QMT SUB AT+QMT UN S AT+QMTSUB=,... OK +QMTSUB: ,,... 订阅请求 (msgID) Start timer T1 +QMTSUB: ,,1 发送订阅数据包 返回订阅ACK指示 (msgID) 服务器收到订阅数据包并返回ACK Stop T1 or handle Excep2 AT+QMTUNS=,,... OK 退订请求 (msgID) Start timer T1 +QMTUNS: ,, 退订ACK指示 (msgID) Stop T1 or handle Excep2 +QMTUNS: ,,1 发送退订数据包 服务器收到退订数据包并返回ACK Excep1: 断开TCP连接 Excep2: 重发数据包，除非达到 允许重发次数上限； 允许重复次数可通过命 令 AT+QMTCFG来设 置。 AT+QMT PUB (qos=1) AT+QMTPUB=,topic,qos=0... OK 发布请求 发送发布数据包 命令AT+QMTCFG可以 配置是否上报超时信息。 AT+QMTPUB=,,qos=1... 发布请求 (msgID) OK Start timer T1 +QMTPUB: ,,1 发送发布数据包 发布ACK指示 (msgID) +QMTPUB: ,,,... Stop T1 or handle Excep2 服务器收到发布数据包并返回ACK AT+QMT PUB (qos=2) AT+QMTPUB=,,qos=2... 发布请求 (msgID) OK Start timer T1 +QMTPUB: ,,1 发送发布数据包 发布REC指示(msgID) 服务器收到发布数据包 Stop T1 or handle Excep2 发布释放请求 (msgID) Start timer T1 发布完成指示 (msgID) +QMTPUBREL: ,,1 发送释放发布数据包 服务器收到发布完成数据包 +QMTPUB: ,,,... Stop T1 or handle Excep2 Receive 接收URC格式的 PUBLISH消息。 发布指示 (msgID) +QMTRCV: ,,,... 发布ACK/REC请求 (msgID) 根据QoS答复 . .. AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , 断开连接请求 TCP请求 TCP已断开 服务器收到发布数据包 发送发布答复数据包 发送断开连接数据包 TCP 断. . 开. 请求 图 1：MQTT 数据交互机制 上海移远通信技术股份有限公司 6 / 28 BC25&BC32 MQTT 应用指导 3 MQTT 相关 AT 命令 本章节介绍了 MQTT 操作的相关 AT 命令。 3.1. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅示出响应，省略 。 BC25 和 BC32 实现的 AT 命令可以在语法上分为两类：基础类和扩展类，如下所列：  基础类语法 这些 AT 命令的格式为 AT 或 AT&，其中 是命令， 是该命令的参数。以 ATE 为例，它通知 DCE 根据 的取值是否将接收到的字符回显给 DTE。如果 是可选的，被 省略时则将使用默认值。  扩展类语法 这些命令可以以多种模式进行操作，如下表所示。 表 1：AT 命令及响应类型 测试命令 查询命令 设置命令 执行命令 AT+=? AT+? AT+=p1[,p2[,p3[.....]]] AT+ 返回相应设置命令可设置的参数清单或取值范围。 返回相应设置命令参数的当前设置值。 设置用户可自定义的参数值。 执行无需设置参数值的命令。 备注 1. 模块每次只支持单个 AT 命令。只有当前 AT 命令的执行完成时，才会执行下一个 AT 命令。 2. 本文档参数说明中添加下划线的参数值为默认值。 上海移远通信技术股份有限公司 7 / 28 BC25&BC32 MQTT 应用指导 3.2. MQTT 相关 AT 命令 3.2.1. AT+QMTCFG 配置 MQTT 参数 此命令用来配置 MQTT 的相关参数。相关 错误码，请参考第 4 章。 AT+QMTCFG 配置 MQTT 参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'WILL',(支持的范围),(支持 的列表),(支持的范围),(支持的列表),'will_topic','will_msg' +QMTCFG: 'TIMEOUT',(支持的范围), (支持的范围),(支持的范围),(支持 的值) +QMTCFG: 'SESSION',(支持的范围), (支持的值) +QMTCFG: 'KEEPALIVE',(支持的范围), (支持的范围) +QMTCFG: 'ALIAUTH',(支持的范围),'p roductkey','devicename','devicesecret' +QMTCFG: 'VERSION',(支持的范围), (支持的值) +QMTCFG: 'SHOWRECVLEN',(支持的 范围),(支持的值) 设置命令 配置或查询 Will 信息 AT+QMTCFG='WILL',[,[,,,'','']] OK 响应 若省略参数 、、、 和 '，则查询当前 Will 配置信息： +QMTCFG: [,,,,] OK 若指定参数 、、、 和 ，则配置 Will 信息： OK 设置命令 若出现任何错误： ERROR 或 +CME ERROR: 响应 上海移远通信技术股份有限公司 8 / 28 BC25&BC32 MQTT 应用指导 配置或查询消息传输超时时间 AT+QMTCFG='TIMEOUT',[,[, ][,]] 若省略参数 、 和 ，则查询当前设置的消息传输超时时间： +QMTCFG: ,, OK 若指定参数 、 和 ，则配置消息传输超时时间： OK 设置命令 配置或查询会话类型 AT+QMTCFG='SESSION',[,] 若出现任何错误： ERROR 或 +CME ERROR: 响应 若省略参数 ，则查询当前会话类型： +QMTCFG: OK 若指定参数 ，则配置会话类型： OK 设置命令 配置或查询保活时间 AT+QMTCFG='KEEPALIVE',[,] 若出现任何错误： ERROR 或 +CME ERROR: 响应 若省略参数 ，则查询当前保活时间： +QMTCFG: OK 若指定参数 ，则配置保活时间： OK 设置命令 配置或查询阿里云设备信息 AT+QMTCFG='ALIAUTH',<TCP_con 若出现任何错误： ERROR 或 +CME ERROR: 响应 若省略参数 、 和 并已配置阿里云设备信息，则查询设备信息： 上海移远通信技术股份有限公司 9 / 28 BC25&BC32 MQTT 应用指导 nectID>[,,<device_na [+QMTCFG: '','',',] e_secret>'] OK 若省略参数 、 和 但未配置阿里云设备信息，则不显示设备信息： OK 若指定参数 、 和 ，则配置设备信息： OK 设置命令 配置或查询 MQTT 协议版本 AT+QMTCFG='VERSION',[,] 若出现任何错误： ERROR 或 +CME ERROR: 响应 若省略参数 ，则查询 MQTT 协议版本： +QMTCFG: OK 若指定参数 ，则配置 MQTT 协议版本： OK 设置命令 配置或查询是否显示接收数据的长度 AT+QMTCFG='SHOWRECVLEN',[,] 若出现任何错误： ERROR 或 +CME ERROR: 响应 若省略参数 ，则查询当前配置是否显示接收数据 的长度： +QMTCFG: OK 若指定参数 ，则配置是否显示接收数据的长度： OK 若出现任何错误： ERROR 或 +CME ERROR: 上海移远通信技术股份有限公司 10 / 28 最大响应时间 生效机制 BC25&BC32 MQTT 应用指导 300 毫秒 参数配置立即生效，掉电后不保存 参数 整型。MQTT Socket 标识符。范围：0-5。 整型。表示是否需要配置 Will flag。 0 无需配置 Will flag 1 需要配置 Will flag 整型。发送消息时的 QoS 级别。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。Will 保留 flag。仅适用于 PUBLISH 消息。 0 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者后， 服务器不保留该消息 1 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者后， 服务器保留该消息 带双引号的字符串型。Will 主题名称。长度范围：0-256 字节。 带双引号的字符串型。表示若客户端意外断开，发送到 Will 主题的消息内容。长度 范围：0-256 字节。 整型。数据包传输超时时间。范围：1-60。默认值：30。单位：秒。 整型。数据包传输超时后重发次数。范围：0-10。默认值：0。 整型。传输数据包时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器存储该客户端的订阅消息 1 服务器删除客户端之前保留的任何消息，此连接状态为 Clean 整型。保活时间。范围：0-3600。默认值：120。单位：秒。定义从客户端接收消 息的最大间隔时间。在此参数设置时间的 1.5 倍的时间内，若服务器未从客户端收 到消息，则默认断开客户端连接，效果和从客户端发送了 DISCONNECT 消息相同。 0 表示不断开客户端连接 带双引号的字符串型。从阿里云获取的产品密钥。 带双引号的字符串型。从阿里云获取的设备名称。 带双引号的字符串型。从阿里云获取的设备校验凭证。 整型。MQTT 协议版本。 0 MQTTv3.1.0 1 MQTTv3.1.1 整型。显示接收数据长度的 flag，表明是否显示接收数据长度（）。 0 不显示 上海移远通信技术股份有限公司 11 / 28 BC25&BC32 MQTT 应用指导 1 显示 备注 1. 若参数 =1，则必须配置参数 、、 和 ， 若参数 =0，需省略以上参数。 2. 只有当服务器支持清除会话操作时，参数 =0 才有效。 3. 发送 QoS 为非 0 的数据包后，若 时间内未收到服务器 ACK，模块会自动重发并重复 次。在 ×（+1）后仍未收到 ACK，则认为发送失败。 4. 查询阿里云设备信息时，若当前无设备信息，则无 +QMTCFG: '',' ','' 返回，仅返回 OK 或者 ERROR。 5. 命 令 AT+QMTCFG='aliauth' 只 用 于 阿 里 云 ， 若 已 在 AT+QMCFG 命 令 进 行 配 置 ， 则 命 令 AT+QMTCONN 中的参数 和 可以省略。 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 此命令用来为 MQTT 客户端打开网络。相关 错误码，请参考第 4 章。 AT+QMTOPEN 打开 MQTT 客户端网络 测试命令 AT+QMTOPEN=? 响应 +QMTOPEN: (支持的范围),'', OK 查询命令 AT+QMTOPEN? 若出现任何错误： ERROR 或 +CME ERROR: 响应 [+QMTOPEN: ,,] OK 设置命令 AT+QMTOPEN=,, 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTOPEN: , 上海移远通信技术股份有限公司 12 / 28 最大响应时间 生效机制 BC25&BC32 MQTT 应用指导 若出现任何错误： ERROR 或 +CME ERROR: 176 秒，受网络状态影响 参数配置立即生效 参数 整型。MQTT Socket 标识符。范围：0-5。 带双引号的字符串性。服务器地址。可为 IP 地址或域名。最大长度：100 字节。 整型。服务器端口。范围：1-65535。 整型。命令执行结果。 -1 打开网络失败 0 打开网络成功 1 参数错误 2 MQTT 标识符被占用 3 激活 PDP 失败 4 域名解析失败 5 网络断开 备注 执行 AT+QMTOPEN? 时，若当前不存在已打开的客户端信息，则无 +QMTOPEN: , , 返回，仅返回 OK 或者 ERROR。 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 此命令用来关闭 MQTT 客户端网络。相关 错误码，请参考第 4 章。 AT+QMTCLOSE 关闭 MQTT 客户端网络 测试命令 AT+QMTCLOSE=? 响应 +QMTCLOSE: (支持的范围) OK 若出现任何错误： ERROR 或 +CME ERROR: 上海移远通信技术股份有限公司 13 / 28 BC25&BC32 MQTT 应用指导 设置命令 AT+QMTCLOSE= 响应 OK +QMTCLOSE: , 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 整型。MQTT Socket 标识符。范围：0-5。 整型。命令执行结果。 -1 关闭网络失败 0 关闭网络成功 3.2.4. AT+QMTCONN 连接客户端到 MQTT 服务器 此命令用于客户端请求连接 MQTT 服务器。当创建客户端和服务器之间的 TCP/IP Socket 连接时，必 须使用 CONNECT 流创建一个协议层会话。相关 错误码，请参考第 4 章。 AT+QMTCONN 连接客户端到 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: (支持的范围),'' [,''[,'']] OK 查询命令 AT+QMTCONN? 若出现任何错误： ERROR 或 +CME ERROR: 响应 [+QMTCONN: ,] OK 若出现任何错误： ERROR 或 上海移远通信技术股份有限公司 14 / 28 BC25&BC32 MQTT 应用指导 +CME ERROR: 设置命令 AT+QMTCONN=,[,[,]] 响应 OK +QMTCONN: ,[,] 最大响应时间 生效机制 若出现任何错误： ERROR 或 +CME ERROR: ×（ +1）（默认 30 秒），受网 络状态影响 参数配置立即生效 参数 整型。MQTT Socket 标识符。范围：0-5。 带双引号的字符串型。客户端标识符。 带双引号的字符串型。可用来鉴权。 带双引号的字符串型。客户端用户名对应的密码。可用来授权。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 初始化 2 MQTT 正在连接 3 MQTT 已经连接成功 4 MQTT 正在断开连接 整型。连接状态返回码。 0 接受连接 1 拒绝连接：不接受的协议版本 2 拒绝连接：标识符被拒绝 3 拒绝连接：服务器不可用 4 拒绝连接：错误的用户名或密码 5 拒绝连接：未授权 整型。数据包传输超时时间。范围：1-60。默认值：30。单位：秒。可通过 AT 命令 AT+QMTCFG='timeout',[,[,][,]] 进行超时时间配置。 整型。数据包传输超时后重发次数。范围：0-10。默认值：0。 上海移远通信技术股份有限公司 15 / 28 BC25&BC32 MQTT 应用指导 备注 若某一个客户端 ID 已经连接服务器端，另一个客户端使用相同 ID 进行连接，当新客户端 CONNECT 流 完成之前，服务器会自动断开原来的客户端连接。 3.2.5. AT+QMTDISC 断开客户端与 MQTT 服务器的连接 此命令用于断开客户端与 MQTT 服务器的连接。客户端发送 DISCONNECT 消息到服务器表示即将与 服务器断开 MQTT 连接。相关 错误码，请参考第 4 章。 AT+QMTDISC 断开客户端与 MQTT 服务器的连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的范围) OK 设置命令 AT+QMTDISC= 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTDISC: , 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 整型。MQTT Socket 标识符。范围：0-5。 整型。命令执行结果。 -1 断开连接失败 0 断开连接成功 上海移远通信技术股份有限公司 16 / 28 BC25&BC32 MQTT 应用指导 3.2.6. AT+QMTSUB 订阅主题 该命令用来订阅一个或多个主题。客户端发送 SUBSCRIBE 消息向服务器订阅一个或多个主题。当有 消息被发布到订阅主题时，服务器会把这些消息作为 PUBLISH 消息传输到客户端。相关 错误码， 请参考第 4 章。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: (支持的范围),,'',[,'',] OK 设置命令 AT+QMTSUB=,< msgID>,,[,, …] 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTSUB: ,,[,] 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: ×（ +1）（默认 30 秒），受网络 状态影响 参数 整型。MQTT Socket 标识符，范围：0-5。 整型。数据包标识符，范围：1-65535。 带双引号的字符串型。客户端订阅或者退订的主题。长度范围：0-256 字节。 整型。客户端发送消息的 QoS 等级。 0 最多一次，该主题下的消息发送端仅发送一次，不需要接收端确认。 1 至少一次，该主题下的消息需要接收端回复 ACK 确认。 2 正好一次，该主题下的消息确保接收端仅且接收到一次。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。 上海移远通信技术股份有限公司 17 / 28 BC25&BC32 MQTT 应用指导 若 =0，则 作为服务器已确认的 QoS 等级。当 =0 时， =128 表示服务器拒绝订阅； 若 =1，则表示数据包重传次数； 若=2，则不显示。 整型。数据包传输超时时间。范围：1-60。默认值：30。单位：秒。可通过 AT 命 令 AT+QMTCFG='timeout',[,[,] [,]] 配置超时时间。 整型。数据包传输超时后重发次数。范围：0-10。默认值：0。 备注 值是 1 或 2 的消息中才显示参数 。在命令返回最终结果之前 不可以重复， 一般来说，该参数值根据消息数逐一递增。 3.2.7. AT+QMTUNS 退订主题 该命令用来退订一个或者多个主题。客户端向服务器发送 UNSUBSCRIBE 消息以退订指定的主题。相 关 错误码，请参考第 4 章。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: (支持的范围),,''[,''…] OK 设置命令 AT+QMTUNS=,< msgID>,[,...] 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTUNS: ,, 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: ×（ +1）（默认 30 秒），受网络 状态影响 上海移远通信技术股份有限公司 18 / 28 BC25&BC32 MQTT 应用指导 参数 整型。MQTT Socket 标识符。范围：0-5。 整型。数据包标识符。范围：1-65535。 带双引号的字符串型。客户端订阅或者退订的主题。长度范围：0-256 字节。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。数据包传输超时时间。范围：1-60。默认值：30。单位：秒。可通过 AT 命令 AT+QMTCFG='timeout',[,[,][,]] 配置超时时间。 整型。数据包传输超时后重发次数。范围：0-10。默认值：0。 3.2.8. AT+QMTPUB 发布消息 通过该命令可以从客户端发布消息到服务器，再由服务器分配到的已订阅主题的订阅者。每一个 PUBLISH 消息都关联一个主题名称，若一个客户端订阅了一个或者多个主题，服务器会把发布到这些主题 下的所有消息作为 PUBLISH 消息发送到客户端。相关 错误码，请参考第 4 章。 AT+QMTPUB 发布消息 测试命令 AT+QMTPUB=? 响应 +QMTPUB: (支持的范围),,,,'','','' OK 设置命令 数据模式下发布不定长消息 AT+QMTPUB=,,,, 响应 > 后，输入需要发送的数据，按 Ctrl+Z 发送数据，按 Esc 取消发送。 设置命令 数据模式下发布定长消息 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTPUB: ,,[,] 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 19 / 28 BC25&BC32 MQTT 应用指导 AT+QMTPUB=,,,,, 响应 > 后，输入需要发送的数据，数据 长度必须和参数 相同 设置命令 非数据模式下发布定长消息 AT+QMTPUB=,,,,,, +QMTPUB: ,,[,] 若出现任何错误： ERROR 或 +CME ERROR: 响应 OK +QMTPUB: ,,[,] 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: ×（ +1）（默认 30 秒），受网络 状态影响 参数 整型。MQTT Socket 标识符，范围：0-5。 整型。数据包消息标识符，范围：1-65535。当=0 时，该参数值只能为 0。 客户端发送消息的 QoS 等级。 0 最多一次，发送端仅发送一次，不需要接收端确认。 1 至少一次，需要接收端回复 ACK 确认。 2 正好一次，确保接收端仅接收到一次。 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 不保存 1 保存 带双引号的字符串型。需要发布的消息的主题。长度范围：0-256 字节。 字符串型。需要发布的消息数据。 非数据模式下，发布定长消息， 的内容需要用双引号标识，例如 'msg'； 数据模式下， 的内容无需用双引号标识。 整型。指定的消息数据长度，范围：0-1460。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK（当=0 时发布了数据，则无需 ACK.） 1 数据包重传 2 数据包发送失败 整型。若 =1，则表示数据包重传次数； 上海移远通信技术股份有限公司 20 / 28 BC25&BC32 MQTT 应用指导 若 =0 或 2，则不显示此参数。 整型。数据传输超时时间。范围：1-60。默认值：30。单位：秒。可通过 AT 命令 AT+QMTCFG='timeout',[,[,][,]] 配置超时时间。 整型。数据包传输超时后的重发次数，范围：0-10，默认值：0。 备注 1. 若该命令执行成功并响应 OK，需等待命令最终结果返回后，客户端再继续发布新的数据包。 2. 执行此命令后，客户端可发送数据（即 MQTT payload 有效负载信息）。输入数据每次最大长度为 1460 字节，按 Ctrl+Z 可发送数据。请勿超出最大长度，超出 1460 字节的部分不会被发送（超出部分的数 据会被放在下次 AT 命令前，被当作 AT 命令处理，导致错误）。 3. PUBLISH 消息既可由发布者发送至服务器，也可以由服务器发送至订阅者。当服务器发布消息到订 阅者时，会返回 URC 通知 host 主机读取 MQTT 服务器发送的数据，URC 的格式为：+QMTRECV: ,,[,],，关于 URC 描述的详细信息， 请参考第 5.2 章。 4. 若 =2，则表示数据包发送超时或协议栈阻塞。 上海移远通信技术股份有限公司 21 / 28 BC25&BC32 MQTT 应用指导 4 错误码 最终结果码 +CME ERROR: 表示和移动设备或网络相关的错误。下面的表格中列举了部分常见 的错误码。 表 2：错误码 错误码 8503 英文含义 MQTT link error 中文含义 MQTT 连接错误 8504 MQTT illegal packet MQTT 非法数据包 8505 MQTT illegal character MQTT 非法字符 8506 8507 8508 8509 MQTT illegal UTF8 MQTT 非法 UTF8 MQTT invalid parameter MQTT 无效参数 The length of transmitted data exceeds that of 传输数据长度超过剩余传输缓存 remaining transmitted buffer MQTT buffer overflow MQTT 缓存溢出 8510 MQTT out of memory MQTT 内存不足 8511 MQTT memory error MQTT 内存错误 8600 8512 MQTT unknown error MQTT 未知错误 MQTT maximum quantity of transmitting packet MQTT 最大传输数据包数量大于 greater than that of in-flight windows 飞行窗口数量 备注 AT+CMEE= 命令禁用（=0）或使能（=1）使用最终结果代码 +CME ERROR: 。当 =1 时，发生错误时，将返回一组有限的错误代码。请参考文档 [3] 或文档 [4]。 上海移远通信技术股份有限公司 22 / 28 BC25&BC32 MQTT 应用指导 5 MQTT 相关 URC 本章节描述了 BC25 和 BC32 模块 MQTT 相关的 URC。 表 3：MQTT 相关的 URC 索引 URC 格式 描述 [1] +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 连接并上报 URC。 [2] +QMTRECV: ,,[,], 上报 URC。 5.1. +QMTSTAT MQTT 链路层状态变化的 URC 此 URC 以 +QMTSTAT：开头，当 MQTT 链路层状态发生变化时，会上报此 URC。 +QMTSTAT MQTT 链路层状态变化的 URC +QMTSTAT: , 当 MQTT 链路层状态改变，客户端会断开 MQTT 连接并 上报 URC。 参数 整型。MQTT Socket 标识符。范围：0-5。 错误码。请参考表 4。 表 4：URC +QMTSTAT 中的错误码 码 描述 1 连接被服务器断开或者重置 2 发送 PINGREQ 包超时或者失败 解决方法 执行 AT+QMTOPEN 命令重建 MQTT 连接 确认模块网络是否正常，并执行 AT+QMTOPEN 命令 重建 MQTT 连接。 上海移远通信技术股份有限公司 23 / 28 BC25&BC32 MQTT 应用指导 3 4 5 6 7 8-255 发送 CONNECT 包超时或者失败 接收 CONNACK 包超时或者失败 客户端向服务器发送 DISCONNECT 包，但是服务器主动断开 MQTT 连接 因为发送数据包总是失败，客户端主动 断开 MQTT 连接 1. 查看输入的用户名和密码是否正确； 2. 确保客户端 ID 未被占用； 3. 执行 AT+QMTOPEN 命令，重建 MQTT 连接； 4. 尝试再次发送 CONNECT 包到服务器。 1. 查看输入的用户名和密码是否正确； 2. 确保客户端 ID 未被占用； 3. 执行 AT+QMTOPEN 命令，重建 MQTT 连接； 4. 尝试再次发送 CONNECT 包到服务器。 正常流程。 1. 确保数据正确； 2. 可 能 因 为 网 络 拥 堵 或 者 其 他 错 误 ， 尝 试 执 行 AT+QMTOPEN 命令重建 MQTT 连接。 链路不工作或者服务器不可用 确保当前链路或者服务器可用。 预留作将来使用的错误码 5.2. +QMTRECV 通知 Host 主机读取 MQTT 数据包的 URC 此 URC 以+QMTRECV：开头，用来通知上位机读取 MQTT 服务器发送的数据包。 +QMTRECV 通知 Host 主机读取 MQTT 数据包的 URC +QMTRECV: ,, 通知 Host 主机读取 MQTT 服务器发送的数据包。 [,], 参数 整型。MQTT Socket 标识符。范围：0-5。 整型。数据包的消息标识符。 字符串型。从 MQTT 服务器接收的消息的主题。 整型。负载信息的长度。范围：0-1460。单位：字节。 字符串型。主题名称相关的负载。 备注 可使用 AT+QMTCFG='showrecvlen' 命令配置是否显示参数 。 上海移远通信技术股份有限公司 24 / 28 BC25&BC32 MQTT 应用指导 6 举例 本章节提供举例以解释如何使用 MQTT 相关命令。 6.1. 无 SSL 的 MQTT 操作举例 AT+QMTCFG='ALIAUTH',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAaz Z' //配置阿里云设备信息（如果连接阿里 云平台） OK AT+QMTCFG='SHOWRECVLEN',0 //查询是否显示接收到的数据的长度 +QMTCFG: 0 //默认为不显示接收的数据长度 OK AT+QMTCFG='SHOWRECVLEN',0,1 OK AT+QMTOPEN=? +QMTOPEN: (0-5),'', //配置显示接收到的数据长度 OK AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 //MQTT 客户端打开网络 OK +QMTOPEN: 0,0 AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 //MQTT 客户端成功打开网络 OK AT+QMTCONN=? +QMTCONN: (0-5),''[,''[,'']] OK // 若 连 接 阿 里 云 ， 使 用 命 令 AT+QMTCFG='ALIAUTH' 提 前 配 置 设 备 信 息 ， 之 后 便 可 省 略 参 数 和 上海移远通信技术股份有限公司 25 / 28 BC25&BC32 MQTT 应用指导 AT+QMTCONN=0,'clientExample' OK //客户端连接 MQTT 服务器 +QMTCONN: 0,0,0 //客户端成功连接到 MQTT 服务器 AT+QMTSUB=? +QMTSUB : (0-5),,'',[,'', …] OK AT+QMTSUB=0,1,'topic/example',2 OK //订阅主题 +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //若客户订阅了其他设备发布到服务器的主题，模块会上报如下信息： +QMTRECV: 0,0, topic/example,36,This is the payload related to topic AT+QMTUNS=0,2,'topic/example' OK //退订主题 +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB : (0-5),,,,'',(0-1460),'' OK AT+QMTPUB=0,0,0,0,'topic/pub' > This is test data, hello MQTT. OK //发布消息 //响应 > 后，输入并发送'This is test data, hello MQTT.'，数据最大长度 是 1460 字节，输入的数据不要超出 最大长度，否则多出的部分会随着下 次执行 AT 时一并被当作 AT 处理。按 Ctrl+Z 发送数据 +QMTPUB: 0,0,0 //若客户端订阅了名为 'topic/pub' 的主题，且其他设备向服务器发布了相同主题，模块会上报如下信息： +QMTRECV: 0,0,topic/pub,30,This is test data, hello MQTT. 上海移远通信技术股份有限公司 26 / 28 AT+QMTDISC=0 OK +QMTDISC: 0,0 BC25&BC32 MQTT 应用指导 //断开客户端在 MQTT 服务器的连接 //连接断开成功 上海移远通信技术股份有限公司 27 / 28 BC25&BC32 MQTT 应用指导 7 附录 A 参考文档及术语缩写 表 5：参考文档 序号 [1] [2] [3] [4] 文档名称 MQTT V3.1 Protocol Specification MQTT V3.1.1 Protocol Specification Quectel_BC25_AT 命令手册 Quectel_BC32_AT 命令手册 说明 MQTT 协议规格说明 3.1 版本 MQTT 协议规格说明 3.1.1 版本 BC25 模块的 AT 命令手册 BC32 模块的 AT 命令手册 表 6：术语缩写 缩写 ACK MQTT QoS RAM SSL TCP URC 英文全称 Acknowledgement Message Queuing Telemetry Transport Quality of Service Random Access Memory Secure Sockets Layer Transmission Control Protocol Unsolicited Result Code 中文全称 确认字符 消息队列遥测传输 服务质量 随机存储器 安全套接层协议 传输控制协议 未请求结果码 上海移远通信技术股份有限公司 28 / 28

BC35-G&BC28&BC95 R2.0 eDRX 应用指导 NB-IoT 模块系列 版本：BC35-G&BC28&BC95 R2.0_eDRX_应用指导_V1.0 日期：2019-10-24 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0 eDRX 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 文档历史 修订记录 版本 日期 作者 变更表述 1.0 2019-10-24 刘强/王成钧 初始版本 上海移远通信技术股份有限公司 2 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 eDRX 简介............................................................................................................................................. 7 3 eDRX 配置相关命令.............................................................................................................................. 8 3.1. AT+CEDRXS eDRX 设置 ........................................................................................................ 8 3.2. AT+CEDRXRDP 查询 eDRX 状态..........................................................................................11 3.3. AT+NPTWEDRXS PTW 和 eDRX 设置................................................................................. 13 4 eDRX 配置常见问题............................................................................................................................ 17 4.1. 网络分配的 eDRX 周期或 PTW 与请求不符............................................................................. 17 4.2. 无法开启 eDRX 功能 ................................................................................................................ 17 5 eDRX 应用场景 ................................................................................................................................... 18 5.1. 低功耗模式分类 ........................................................................................................................ 18 5.2. 推荐的低功耗应用方案 ............................................................................................................. 18 5.2.1. 推荐使用 eDRX 的应用场景 .......................................................................................... 18 5.2.2. 推荐使用 DRX 的应用场景 ............................................................................................ 19 5.2.3. 推荐使用 PSM 的应用场景 ............................................................................................ 19 6 eDRX 耗流数据 ................................................................................................................................... 20 6.1. BC35-G eDRX 耗流 ................................................................................................................. 20 6.2. BC28 eDRX 耗流 ..................................................................................................................... 22 6.3. BC95 R2.0 eDRX 耗流............................................................................................................. 24 7 附录 A 术语缩写 ................................................................................................................................. 26 上海移远通信技术股份有限公司 3 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 表格索引 表 1：BC35-G 耗流数据（中国移动 NB-IOT 实网 B8） .................................................................................... 20 表 2：BC28 耗流数据（中国移动 NB-IOT 实网 B8） ........................................................................................ 22 表 3：BC95 R2.0 耗流数据（中国移动 NB-IOT 实网 B8） ............................................................................... 24 表 4：术语和缩写............................................................................................................................................... 26 上海移远通信技术股份有限公司 4 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 图片索引 图 1：DRX 示意图 ............................................................................................................................................... 7 图 2：EDRX 示意图 ............................................................................................................................................. 7 图 3：BC35-G DRX 耗流示意图（DRX 周期=2.56S） ..................................................................................... 20 图 4：BC35-G EDRX 耗流示意图（EDRX 周期=20.48S）............................................................................... 21 图 5：BC26 EDRX 耗流示意图（EDRX 周期=40.96S）................................................................................... 21 图 6：BC28 DRX 耗流示意图（DRX 周期=2.56S） ......................................................................................... 22 图 7：BC28 EDRX 耗流示意图（EDRX 周期=20.48S）................................................................................... 23 图 8：BC28 EDRX 耗流示意图（EDRX 周期=40.96S）................................................................................... 23 图 9：BC95 R2.0 DRX 耗流示意图（DRX 周期=2.56S）................................................................................. 24 图 10：BC95 R2.0 EDRX 耗流示意图（EDRX 周期=20.48S） ........................................................................ 25 图 11：BC95 R2.0 EDRX 耗流示意图（EDRX 周期=40.96S） ........................................................................ 25 上海移远通信技术股份有限公司 5 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 1 引言 移远通信一直关注模块功耗的优化，以确保客户终端产品整体功耗最大程度的降低。随着物联网通信 技术的迅速发展以及节能减排环保意识的不断加强，移动通信将提供更多不同的低功耗方案以满足客户对 其终端产品越来越严苛的功耗要求。 NB-IoT 作为蜂窝系统中一项全新的无线接入技术，对功耗有更加严苛的要求，例如其终端可能要求一 块电池可维持正常工作长达数年之久。为了进一步降低终端功耗、满足终端设备对极低功耗的需求，移远 通信 NB-IoT 模块均支持低功耗方案。 移远通信 BC35-G、BC28 和 BC95 R2.0 模块支持 DRX、eDRX 和 PSM 等多种低功耗方案。本文档 主要介绍如何通过 eDRX 的不同参数配置，实现该模块在不同场景下达到功耗与实时性需求的平衡。 上海移远通信技术股份有限公司 6 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 2 eDRX 简介 DRX 是一种节省终端功耗的工作模式，其基本原理是让模块周期性地进入休眠模式；休眠期间，模块 将不监听 PDCCH、关闭收发单元，以降低其功耗。 DRX 作用于 Idle 态中，通过在 Idle 态中周期性监听寻呼的方式来降低模块功耗，示意图如下所示。但 DRX 参数由网络决定，模块无法修改也无法建议网络修改。 图 1：DRX 示意图 为进一步降低功耗，NB-IoT 不仅支持传统 LTE 的 DRX 模式，还支持扩展的 DRX 周期，即 eDRX。eDRX 目的与 DRX 相同，均是通过让模块周期性进入休眠状态以达到降低功耗的目的。其基本的原理是将 Idle 态 分成寻呼期和休眠期：在寻呼期，模块的工作模式和 LTE 的 DRX 一致；在休眠期，模块不监听下行寻呼。 相比 DRX，eDRX 可支持更长的寻呼周期，以达到进一步降低功耗的目的，示意图如下所示： 图 2：eDRX 示意图 eDRX 模式下，模块只在 PTW 内按 DRX 周期监听下行寻呼、接收下行业务（打开接收机）；如果在休 眠期有数据发给模块，模块并不能及时接收，只能等到当前 eDRX 周期完毕后再次进入 PTW 监听寻呼。因 此，eDRX 模式下，模块功耗的降低以实时性为'代价'，实际应用时需要根据业务模型，确定合适的 eDRX 周期和 PTW 值，以达到功耗与实时性的平衡。 上海移远通信技术股份有限公司 7 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 3 eDRX 配置相关命令 如下命令可以设置不同的 eDRX 参数，以实现不同应用场景下的多样应用需求。如果 AT 命令执行报错 或需了解相关 AT 命令的更多详情，请参考 Quectel_BC35-G&BC28&BC95 R2.0_AT_命令手册。 3.1. AT+CEDRXS eDRX 设置 设置命令用于配置 UE 的 eDRX 参数，即配置 UE 是否使用 eDRX 以及指定接入技术请求的 eDRX 值。 当=2 且网络提供的 eDRX 参数发生变化时，该设置命令还可用于控制 URC +CEDRXP: [,[,[,]]]的上 报。 该设置命令包含一种特殊形式：AT+CEDRXS=3。此形式的命令将禁用 eDRX 且之前通过 AT+CEDRXS 所配置的所有参数都将被清除，或者被设置为默认值（若有）。 AT+CEDRXS eDRX 设置 设置命令 AT+CEDRXS=,[,< Requested_eDRX_value>] 查询命令 AT+CEDRXS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXS:, OK 测试命令 AT+CEDRXS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +CEDRXS:(支持的取值),(支持的取值), (支持的取值) 上海移远通信技术股份有限公司 8 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 最大响应时间 生效机制 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 立即生效；参数设置将保存至 NVM 参数 整型。启用或禁用 eDRX。该参数适用于所有指定的接入技术类型，即的最新 设置将对的所有指定值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并启用如下 URC 的上报： +CEDRXP:[,[,[,]]] 3 禁用 eDRX 并删除 eDRX 的所有参数。 整型。接入技术类型。 0 接入技术未使用 eDRX，该参数值仅在 URC 中使用。 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 上海移远通信技术股份有限公司 9 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时间窗。 NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 备注 在 B300SP5 或后续版本中，默认启用 UE 的 eDRX。 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS:5,'0101' OK 上海移远通信技术股份有限公司 10 / 26 AT+CEDRXS=? +CEDRXS:(0,1,2,3),(5),('0000'-'1111') OK AT+CEDRXS=0,5 OK BC35-G&BC28&BC95 R2.0 eDRX 应用指导 3.2. AT+CEDRXRDP 查询 eDRX 状态 当 eDRX 用于 UE 当前注册的小区时，该执行命令返回、、 和。 如果 UE 当前注册的小区未使用 eDRX，则仅返回且值为 0。 AT+CEDRXRDP 查询 eDRX 状态 执行命令 AT+CEDRXRDP 响应 +CEDRXRDP:[,[,[,]]] OK 测试命令 AT+CEDRXRDP=? 最大响应时间 生效机制 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK 300 毫秒 / 参数 整型。接入技术类型。 0 接入技术未使用 eDRX。该参数值仅在 URC 中使用。 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。 NB-S1 模式。 位数 上海移远通信技术股份有限公司 11 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型。4 位格式的半字节。网络下发的寻呼时间窗。 NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.3 6 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 上海移远通信技术股份有限公司 12 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 1 1 1 1 40.96 秒 举例 AT+CEDRXRDP +CEDRXRDP:5,'0010','1110','0101' OK AT+CEDRXRDP=? OK 3.3. AT+NPTWEDRXS PTW 和 eDRX 设置 设置命令用于设置 UE 的 PTW 和 eDRX 参数，即设置 UE 是否启用 PTW 和 eDRX，以及每个指定接 入技术所请求的 PTW 和 eDRX 值。 AT+NPTWEDRXS PTW 和 eDRX 设置 设置命令 AT+NPTWEDRXS=,[,[,]] 查询命令 AT+NPTWEDRXS? 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPTWEDRXS:,,[,[,]] OK 测试命令 AT+NPTWEDRXS=? 若出现任何错误： ERROR 或者 +CME ERROR: 响应 +NPTWEDRXS:(支持的取值),(支持的取 值),(支持的取值),(支持 的取值) 上海移远通信技术股份有限公司 13 / 26 最大响应时间 生效机制 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 OK 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 立即生效；参数设置将保存至 NVM 参数 整型。启用或禁用 UE 请求的 PTW 和 eDRX。此参数适用于所有指定类型的接入技术，即参 数的最新设置将对所有指定的值生效。当设置参数为 0 并且没 有参数或参数时，则会 将缺省值设置为无效值，如 0x00。 0 禁用请求的 PTW 和 eDRX 1 启用请求的 PTW 和 eDRX 2 启用请求的 PTW 和 eDRX，并且启用如下 URC 的上报： +NPTWEDRXP:[,[,[,[,]]]] 3 禁用 eDRX 的使用并清除 eDRX 的所有参数值。 整型。接入技术类型。 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。 UE 请求的寻呼时间窗。 NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 上海移远通信技术股份有限公司 14 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 1 1 1 1 40.96 秒 字符串类型，半字节（4 位）格式。 UE 请求的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时间窗。 NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 上海移远通信技术股份有限公司 15 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 上海移远通信技术股份有限公司 16 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 4 eDRX 配置常见问题 4.1. 网络分配的 eDRX 周期或 PTW 与请求不符  问题 网络分配的 eDRX 周期或 PTW 与模块所请求的不同。  原因分析 3GPP 协议规定模块使用的 eDRX 周期需要与网络协商，由两者协商决定。 模块可通过 Attach request/TAU request 消息将一组 eDRX 参数发送给网络以告知网络模块可以支持 的和期望的 eDRX 参数配置，但最终可使用的 eDRX 参数由网络配置决定。网络将参考模块所请求的 eDRX 参数、APN 和 IMSI 为不同的模块配置不同的值，并在 Attach accept/TAU accept 消息中携带并发送给模 块。因此，网络分配的 eDRX 周期与模块请求的 eDRX 周期可能有所不同。 另外，eDRX 周期和 PTW 均应是 DRX 周期的整数倍，如果所请求的参数并非 DRX 周期的整数倍，则 网络分配的值会做相应的更改。 4.2. 无法开启 eDRX 功能  问题 通过软件配置启用 eDRX 后，eDRX 参数配置实际无法生效；无论配置什么 eDRX 参数，模块均按照 DRX 模式工作。  原因分析 启用 eDRX 后无法生效的，请咨询网络运营商，以确认所用 USIM 卡在网络侧是否已开通 eDRX 功能， 以及该卡签约的 APN 是否支持 eDRX 功能。 上海移远通信技术股份有限公司 17 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 5 eDRX 应用场景 5.1. 低功耗模式分类 BC35-G、BC28 和 BC95 R2.0 模块支持三种低功耗应用模式：DRX、eDRX 和 PSM。 DRX 模式下，模块在每个 DRX 周期监听一次寻呼信道，功耗相对 eDRX 和 PSM 来说较高。 eDRX 就是模块不断地打开、关闭接收机。打开接收机时能够接收数据，关闭接收机时则无法接收数 据；eDRX 周期即由关闭接收机和打开接收机这两个完整的时段组成，支持配置的时长为 20.48s ~ 2.92h。 eDRX 功耗较 DRX 低。 与 eDRX 相比，PSM 打开、关闭接收机的频率更低，可低至几天打开一次接收机。PSM 周期内，模 块仅在接收机打开的时间内能够接收到数据，接收机关闭的时间内将无法接收下行数据。PSM 模式下，功 耗只有微安级，终端在此工作模式下才可能实现极低的功耗，如'一节电池用数年'。 5.2. 推荐的低功耗应用方案 根据不同的应用场景，移远通信推荐客户使用不同的低功耗模式。 5.2.1. 推荐使用 eDRX 的应用场景 eDRX 在兼顾低功耗的同时，可以实现网络的快速响应；比如可通过配置使模块实现休眠若干分钟， 再唤醒工作，再休眠若干分钟。因此 eDRX 适用于无需频繁发送数据、但需要实现快速响应的应用场景。 对于物流监控等隔几十分钟才需要进行一次数据业务的应用，即推荐使用 eDRX。 此外，对于监控时间要求可修改的应用，例如宠物跟踪器应用中，可通过设置不同的 eDRX 参数实现 不同场景下的应用需求。正常情况下，服务器可以每 2621s 或者 5242s 采集一次宠物位置信息；当宠物丢 失时，通过服务器修改 eDRX 参数，模块接收到控制信息后，重新配置 eDRX 周期为 20.48s 或者 40.96s， 服务器即可每 20.48s 或者 40.96s 采集一次宠物位置信息。这样可以最大程度地平衡客户需求及设备省电 需求。 上海移远通信技术股份有限公司 18 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 5.2.2. 推荐使用 DRX 的应用场景 共享单车锁、智能锁等应用场景中，实时性要求较高（远程开锁之后，开锁动作应立即响应并完成）， 此时建议使用 DRX 方案。 5.2.3. 推荐使用 PSM 的应用场景 对于远程水表/煤气表类的表计行业应用，一般情况下几天或更久才需要给服务器传输一次用水/用气量 数据即可满足需求，这类应用推荐使用 PSM。 上海移远通信技术股份有限公司 19 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 6 eDRX 耗流数据 6.1. BC35-G eDRX 耗流 表 1：BC35-G 耗流数据（中国移动 NB-IoT 实网 B8） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 0.497mA 0.248mA @ PTW=10.24s 0.065mA @ PTW=5.12s 图 3：BC35-G DRX 耗流示意图（DRX 周期=2.56s） 上海移远通信技术股份有限公司 20 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 图 4：BC35-G eDRX 耗流示意图（eDRX 周期=20.48s） 图 5：BC26 eDRX 耗流示意图（eDRX 周期=40.96s） 上海移远通信技术股份有限公司 21 / 26 6.2. BC28 eDRX 耗流 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 表 2：BC28 耗流数据（中国移动 NB-IoT 实网 B8） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 0.521mA 0.250mA @ PTW=10.24s 0.073mA @ PTW=5.12s 图 6：BC28 DRX 耗流示意图（DRX 周期=2.56s） 上海移远通信技术股份有限公司 22 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 图 7：BC28 eDRX 耗流示意图（eDRX 周期=20.48s） 图 8：BC28 eDRX 耗流示意图（eDRX 周期=40.96s） 上海移远通信技术股份有限公司 23 / 26 6.3. BC95 R2.0 eDRX 耗流 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 表 3：BC95 R2.0 耗流数据（中国移动 NB-IoT 实网 B8） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 0.495mA 0.271mA @ PTW=10.24s 0.072mA @ PTW=5.12s 图 9：BC95 R2.0 DRX 耗流示意图（DRX 周期=2.56s） 上海移远通信技术股份有限公司 24 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 图 10：BC95 R2.0 eDRX 耗流示意图（eDRX 周期=20.48s） 图 11：BC95 R2.0 eDRX 耗流示意图（eDRX 周期=40.96s） 上海移远通信技术股份有限公司 25 / 26 BC35-G&BC28&BC95 R2.0 eDRX 应用指导 7 附录 A 术语缩写 表 4：术语和缩写 术语 APN DRX eDRX IMSI NB-IoT NVM LTE PDCCH PSM PTW TAU 3GPP UE USIM 英文全称 Access Point Name Discontinuous Reception extended DRX International Mobile Subscriber Identity Narrowband Internet of Things Non-Volatile Memory Long Term Evolution Physical Downlink Control Channel Power Saving Mode Paging Time Window Tracking Area Update 3rd Generation Partnership Project User Equipment Universal Subscriber Identification Module 中文全称 接入点名称 非连续接收 扩展型非连续接收 国际移动用户识别码 窄带物联网 非易失性存储器 长期演进 物理下行控制信道 省电模式 寻呼时间窗 跟踪区更新 第三代合作伙伴计划 用户设备 全球用户身份模块 上海移远通信技术股份有限公司 26 / 26

BC25&BC32 CMDMP Application Note LPWA Module Series Rev. BC25&BC32_CMDMP_Application_Note_V1.0 Date: 2019-07-31 Status: Released www.quectel.com LPWA Module Series BC25&BC32 CMDMP Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 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. 2019. All rights reserved. BC25&BC32_CMDMP_Application_Note 1 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note About the Document History Revision Date 1.0 2019-07-31 Author Albert ZHANG Description Initial BC25&BC32_CMDMP_Application_Note 2 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index...................................................................................................................................................4 1 Introduction .......................................................................................................................................... 5 2 CMDMP Related AT Commands......................................................................................................... 6 2.1. AT+QDMPCFG CMDMP Access Configuration....................................................................... 6 2.2. AT+QDMPCFGEX Extended CMDMP Access Configuration ................................................. 9 3 Error Values........................................................................................................................................14 4 Appendix A References.....................................................................................................................16 BC25&BC32_CMDMP_Application_Note 3 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note Table Index TABLE 1: GENERAL ERRORS (27.007)........................................................................................................... 14 TABLE 2: GENERAL ERRORS (27.005)........................................................................................................... 14 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 16 BC25&BC32_CMDMP_Application_Note 4 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note 1 Introduction China Mobile Device Management Platform (CMDMP) is used to manage terminal devices, collect terminal device information and to handle events and alerts of terminal devices that applies Quectel BC25 or BC32 modules. For details of CMDMP related information, please contact China Mobile. This document mainly introduces how to configure the parameters related to the access of BC25 and BC32 modules to CMDMP with AT commands. BC25&BC32_CMDMP_Application_Note 5 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note 2 CMDMP Related AT Commands 2.1. AT+QDMPCFG CMDMP Access Configuration This command is used to configure and query CMDMP access information. The read command is used to query the parameters currently used by BC25 and BC32 modules, which may not be identical with the saved configuration information. The write command is used to save or erase configuration, and all the saved configuration will take effect after reboot. Please refer to Chapter 3 for possible values. AT+QDMPCFG CMDMP Access Configuration Test Command AT+QDMPCFG=? Response +QDMPCFG: [,[,[,[,]]]] Read Command AT+QDMPCFG? OK Response +QDMPCFG: 0, [+QDMPCFG: 1,,, +QDMPCFG: 2,,,,] Write Command AT+QDMPCFG=, [,[,[,]]] OK Response [+QDMPCFG: ,[,[,[,]]] ] OK If there is any error: ERROR Or BC25&BC32_CMDMP_Application_Note 6 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note +CME ERROR: Parameter Configure type. 0 Configure CMDMP access mode 1 Configure CMDMP server address and update period 2 Configure CMDMP App key, private key, interface type and terminal IMEI 3 Reserved 4 Query saved configuration information from NVRAM 5 Erase saved configuration information from NVRAM 6 Query CMDMP access state 0 1 2 3 Reserved 4 5 6 CMDMP access mode 0 Disable access to CMDMP 1 Enable access to CMDMP The IP address of CMDMP server, and the default server IP is 117.161.2.41. CMDMP server port, and the default server port is 5683. Update period. Range: 300-4294966. Unit: second. The default update period is 86400s. App key, in write command, it should be marked with double quotation marks, e.g. 'appkey'. Private key, in write command, it should be marked with double quotation marks, e.g. 'password'. In read command, only the first four characters of the private key will be shown, e.g. 'pass****'. Terminal type. 0 Interface 1 Linux 2 Android Terminal device IMEI. The length should be 15-17 bytes. Options for querying saved configuration information. 0 Query saved CMDMP access mode 1 Query saved IP address and port of CMDMP server and the update period 2 Query saved App key, private key, interface type and terminal IMEI 3 Reserved BC25&BC32_CMDMP_Application_Note 7 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note Options for erasing saved configuration information. 0 Erase saved CMDMP access mode 1 Erase saved IP address and port of CMDMP server and the update period 2 Erase saved App key, private key, interface type and terminal IMEI 3 Reserved 4 Erase all above saved information CMDMP access state 0 DMP_INITIAL_STATE 4 DMP_CONNECT_SUCCESS 5 DMP_CONNECT_FAILED 6 DMP_REG_SUCCESS 7 DMP_REG_FAILED 8 DMP_REG_TIMEOUT 9 DMP_LIFETIME_TIMEOUT 11 DMP_UPDATE_SUCCESS 12 DMP_UPDATE_FAILED 13 DMP_UPDATE_TIMEOUT NOTES 1. The configuration will be saved to NVRAM automatically. 2. The write command is used to save or erase configuration. All saved configuration will take effect after reboot. Example AT+QDMPCFG? //Query current configuration information +QDMPCFG: 0,1 +QDMPCFG: 1,117.161.2.7,5683,420 +QDMPCFG: 2,M100000089,95Go****,1,863703030822519 OK AT+QDMPCFG=0,0 OK //Disable access to CMDMP AT+QDMPCFG=4,0 +QDMPCFG: 0,0 //Query saved CMDMP access mode OK AT+QDMPCFG=1,117.161.2.7,5683,420 OK //Set the IP address and port of CMDMP server and the update period BC25&BC32_CMDMP_Application_Note 8 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note AT+QDMPCFG=4,1 +QDMPCFG: 1,117.161.2.7,5683,420 //Query saved IP address and port of CMDMP server and the update period OK //Set App key, private key, interface type and terminal IMEI AT+QDMPCFG=2,'M100000089','77GaaTUi33nUK05ha528888QFbk0Y38M',1,863703030822519 OK AT+QDMPCFG=4,2 //Query saved App key, private key, interface type and terminal IMEI +QDMPCFG: 2,M100000089,77Ga****,1,863703030822519 OK AT+QDMPCFG=5,4 OK //Erase all saved information AT+QDMPCFG=6 +QDMPCFG: 6,6 //Query CMDMP access state //Registered successfully OK AT+QDMPCFG=6 +QDMPCFG: 6,11 //Query CMDMP access state //Updated successfully OK 2.2. AT+QDMPCFGEX Extended CMDMP Access Configuration The command is used to configure and query CMDMP configuration information, which is required for CMDMP V2.0 functions. The write command is used to save or erase configuration, all the saved configuration will only take effect after reboot. Please refer to Chapter 3 for possible values. BC25&BC32_CMDMP_Application_Note 9 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note AT+QDMPCFGEX Extended CMDMP Access Configuration Test Command AT+QDMPCFGEX=? Response +QDMPCFGEX: ,[,[,[,,]]] OK Write Command AT+QDMPCFGEX=,[,[,[,,]]] Response [+QDMPCFGEX: ,[,[,,]] ] OK If there is any error: ERROR Or +CME ERROR: Parameter Configure type 0 Configure terminal application information 1 Configure terminal MAC address 2 Configure terminal ROM, RAM, CPU and operation system version information 3 Configure terminal software version and name 4 Configure terminal VoLTE state, network type, broadband account and phone number 5 Configure terminal location information Action mode 0 Save information to the module 1 Read information from the module 2 Erase information from the module 0 0 1 0 2 0 3 0 4 0 5 0 String type. Terminal application information. It should be marked with double quotation marks, e.g. 'appInfo'. The maximum length is 255 bytes. It is an App collection with each log separated by semicolon. Each log contains App name, package name, App usage time (milliseconds), App open times, which are separated by '|'. If there is no such information, BC25&BC32_CMDMP_Application_Note 10 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note please set with 'NULL'. String type. MAC address of terminal. It should be marked with double quotation marks and the maximum length is 19 bytes. If there is no such information, please set with 'NULL'. String type. ROM information of terminal. It should be marked with double quotation marks and the maximum length is 19 bytes. If there is no such information, please set with 'NULL'. String type. RAM information of terminal. It should be marked with double quotation marks and the maximum length is 19 bytes. If there is no such information, please set with 'NULL'. String type. CPU information of terminal. It should be marked with double quotation marks and the maximum length is 19 bytes. If there is no such information, please set with 'NULL'. String type. Operation system version of terminal. It should be marked with double quotation marks and the maximum length is 47 bytes. If there is no such information, please set with 'NULL'. String type. Software version of terminal. It should be marked with double quotation marks and the maximum length is 47 bytes. If there is no such information, please set with 'NULL'. String type. Software name of terminal. It should be marked with double quotation marks and the maximum length is 47 bytes. If there is no such information, please set with 'NULL'. String type. VoLTE state of terminal. It should be marked with double quotation marks and the maximum length is 7 bytes. If there is no such information, please set with 'NULL'. String type. Network type of terminal. It should be marked with double quotation marks and the maximum length is 19 bytes. If there is no such information, please set with 'NULL'. String type. Broadband account of terminal. It should be marked with double quotation marks and the maximum length is 47 bytes. If there is no such information, please set with 'NULL'. String type. Phone number of terminals. It should be marked with double quotation marks and the maximum length is 19 bytes. If there is no such information, please set with 'NULL'. String type. Location information of terminal. It should be marked with double quotation marks and the maximum length is 255 bytes. If there is no such information, please set with 'NULL'. NOTES 1. The configuration will be saved to NVRAM automatically. 2. The write command is used to save or erase configuration. All saved configuration will take effect after reboot. BC25&BC32_CMDMP_Application_Note 11 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note Example AT+QDMPCFGEX=0,0,'Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551 ;Alipay|FW88|22650|5555;Zhihu|FW333|77750|65101' //Set App information OK AT+QDMPCFGEX=0,1 //Query App information +QDMPCFGEX: 0,Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551;Alipay|FW88|22650|5 555;Zhihu|FW333|77750|65101 OK AT+QDMPCFGEX=0,2 OK // Erase App information AT+QDMPCFGEX=1,0,'00-01-6C-06-A6-29' OK //Set MAC address AT+QDMPCFGEX=1,1 +QDMPCFGEX: 1,00-01-6C-06-A6-29 //Query MAC address OK AT+QDMPCFGEX=1,2 OK //Erase MAC address AT+QDMPCFGEX=2,0,'8192KB','4096KB','RDA8909B','SX RTOS' //Set ROM, RAM, CPU, OS version information OK AT+QDMPCFGEX=2,1 //Query ROM, RAM, CPU, OS version information +QDMPCFGEX: 2,8192KB,4096KB,RDA8909B,SX RTOS OK AT+QDMPCFGEX=2,2 OK //Erase ROM, RAM, CPU, OS version information AT+QDMPCFGEX=3,0,'BC32B8R01A01','Quectel' OK //Set software version and name BC25&BC32_CMDMP_Application_Note 12 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note AT+QDMPCFGEX=3,1 +QDMPCFGEX: 3,BC32B8R01A01,Quectel //Query software version and name OK AT+QDMPCFGEX=3,2 //Erase software version and name OK AT+QDMPCFGEX=4,0,'off','NB-IoT','XY05553867549','18009699999' OK AT+QDMPCFGEX=4,1 //Query VoLTE state, network type, broadband account and phone number +QDMPCFGEX: 4,off,NB-IoT,XY05553867549,18009699999 OK AT+QDMPCFGEX=4,2 OK //Erase VoLTE state, network type, broadband account and phone number AT+QDMPCFGEX=5,0,'31.8438799075,117.2025477950,OTDOA' OK //Set location information AT+QDMPCFGEX=5,1 +QDMPCFGEX: 5,31.8438799075,117.2025477950,OTDOA //Query location information OK AT+QDMPCFGEX=5,2 OK //Erase location information BC25&BC32_CMDMP_Application_Note 13 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note 3 Error Values This chapter introduces the error values related to BC25 and BC32 modules. The error codes listed in the following two tables are compliant with the 3GPP specifications. Customers can refer to 3GPP TS 27.007 V13.5.0, sub-clause 9.2 for all possible values. Table 1: General Errors (27.007) values 3 4 23 30 50 52 53 159 Description Operation not allowed Operation not supported Memory failure No network service Execute fail Option not supported Param invalid Uplink busy/flow control Table 2: General Errors (27.005) values 300 301 302 303 304 Description ME failure SMS service of ME reserved Operation not allowed Operation not supported Invalid PDU mode parameter BC25&BC32_CMDMP_Application_Note 14 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note 305 Invalid text mode parameter 310 USIM not inserted 311 USIM PIN required 312 PH-USIM PIN required 313 USIM failure 314 USIM busy 315 USIM wrong 316 USIM PUK required 317 USIM PIN2 required 318 USIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network service 332 Network timeout 340 No +CNMA acknowledgement expected 500 Unknown error NOTE AT+CMEE= command disables (=0) or enables (=1, =2) the use of final result code +CME ERROR:. For more details, please refer to Quectel_BC25_AT_Commands_Manual or Quectel_BC32_AT_Commands_Manual. BC25&BC32_CMDMP_Application_Note 15 / 16 LPWA Module Series BC25&BC32 CMDMP Application Note 4 Appendix A References Table 3: Terms and Abbreviations Abbreviation CoAP CMDMP CPU DM IMEI LwM2M LPWA MAC ME NB-IoT NVRAM OS RAM ROM REST TE UE URC Description Constrained Application Protocol China Mobile Device Management Platform Central Processing Unit Device Management International Mobile Equipment Identity Lightweight Machine to Machine Low-Power Wide-Area Media Access Control Mobile Equipment Narrow Band Internet of Things Non-Volatile Radom Access Memory Operation System Random Access Memory Read-Only Memory Representational state transfer Terminal Equipment (Typically the MCU) User Equipment (Typically the Module) Unsolicited Result Code BC25&BC32_CMDMP_Application_Note 16 / 16

BC25&BC32 DFOTA Application Note LPWA Module Series Rev. BC25&BC32_DFOTA_Application_Note_V1.0 Date: 2019-07-15 Status: Released www.quectel.com LPWA Module Series BC25&BC32 DFOTA Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 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. 2019. All rights reserved. BC25&BC32_DFOTA_Application_Note 1 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note About the Document History Revision 1.0 Date 2019-07-15 Author Fonda FANG Description Initial BC25&BC32_DFOTA_Application_Note 2 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index...................................................................................................................................................4 1 Introduction .......................................................................................................................................... 5 2 DFOTA Procedure ................................................................................................................................ 6 2.1. Acquire Delta Firmware Package ............................................................................................... 7 2.2. Put Delta Package on HTTP Server ........................................................................................... 7 2.3. Check Network Status................................................................................................................. 7 2.4. Execute AT Command to Upgrade the Firmware ....................................................................... 8 3 DFOTA AT Commands ........................................................................................................................ 9 3.1. AT+QFOTADL DFOTA via HTTP Server.................................................................................. 9 4 Examples ............................................................................................................................................ 11 4.1. DFOTA via HTTP Server under NB-IoT Network...................................................................... 11 4.2. DFOTA via HTTP Server under GSM Network (BC32) ............................................................ 12 5 Summary of Error Codes .................................................................................................................. 14 6 Appendix A References.....................................................................................................................15 BC25&BC32_DFOTA_Application_Note 3 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note Table Index TABLE 1: SUMMARY OF CODES ............................................................................................ 14 TABLE 2: SUMMARY OF CODES ............................................................................................ 14 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 15 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 15 BC25&BC32_DFOTA_Application_Note 4 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note 1 Introduction Quectel BC25 and BC32 modules support DFOTA (Delta Firmware Upgrade Over-The-Air) feature, which allows customers to upgrade or downgrade firmware wirelessly. In DFOTA, a delta firmware package, which only contains the differences between the source and the target firmware version, is needed. In this way, the amount of data transmitted and time consumed can be reduced. This document mainly describes how to upgrade the firmware of Quectel BC25 and BC32 modules via DFOTA. BC25&BC32_DFOTA_Application_Note 5 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note 2 DFOTA Procedure The following chart illustrates the firmware upgrade procedure via DFOTA when the firmware package is stored on an HTTP server. 2. Put the package on an HTTP server HTTP Server 1. Get the delta firmware package NB-IoT/GSM (HTTP) 5. Automatically download from the HTTP server via NB-IoT/GSM network Ext. MCU 3. Check network status 4. Execute AT+QFOTADL command Quectel Module 6. Automatically upgrade the module’s firmware Figure 1: DFOTA Procedure As shown in the above figure, customers only need to perform the following steps to upgrade the firmware when the firmware package is stored on an HTTP server: Step 1: Get the delta firmware package from Quectel. Step 2: Put the delta firmware package on an HTTP server. BC25&BC32_DFOTA_Application_Note 6 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note Step 3: Check the status of network. Step 4: Execute AT+QFOTADL command. Then the module will automatically download the package from the HTTP server via NB-IoT network or GSM network (Step 5) and finally automatically upgrade the module’s firmware (Step 6). NOTES 1. Since BC32 supports both NB-IoT and GSM networks, BC32 also supports to download upgrade files through GSM network. 2. When BC32 is under GSM network, it is needed to manually configure PDP and activate IP with the command AT+CGDCONT after Step 3. 3. Please refer to Quectel_BC25_AT_Commands_Manual or Quectel_BC32_AT_Commands_Manual for more details about the AT commands other than AT+QFOTADL in this chapter, . 2.1. Acquire Delta Firmware Package Before upgrading, the source firmware version needs to be checked by executing ATI command and the target firmware version needs to be decided. Then, customers should send the two firmware versions to Quectel or the responsible agent to get a delta package. 2.2. Put Delta Package on HTTP Server Customers need to setup their own HTTP servers when applying DFOTA, since Quectel does not provide such a server. Then, after the delta firmware package is put on the server and the HTTP path is recorded, the module will be able to acquire the delta firmware package through the HTTP path by executing the corresponding AT command. NOTE Please record the HTTP path (URL) where the delta firmware package is put for the AT+QFOTADL command in Chapter 3. 2.3. Check Network Status After the module is powered on, please make sure it is registered on network before the firmware upgrading. BC25&BC32_DFOTA_Application_Note 7 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note Relevant AT commands are listed below:  AT+CESQ: Query signal quality  AT+COPS?: Query the network type and registration status  AT+CGPADDR: Query allocated IP address for the default PDN 2.4. Execute AT Command to Upgrade the Firmware After the network status is confirmed to be ready, AT+QFOTADL command can be executed to start the download. Then the module will download the delta firmware package from the HTTP server wirelessly and upgrade the firmware automatically. For more details, please refer to Chapter 3. BC25&BC32_DFOTA_Application_Note 8 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note 3 DFOTA AT Commands AT+QFOTADL command enables the automatic firmware upgrade for Quectel module via DFOTA. After the command is executed, the package will be automatically downloaded to the module from the HTTP server. After the package download completes, the module will start to upgrade its firmware automatically. If firmware is upgraded successfully, the module will reboot, otherwise it will return an error and exit from DFOTA. 3.1. AT+QFOTADL DFOTA via HTTP Server If the delta firmware package is stored on an HTTP server, AT+QFOTADL= command should be executed to enable the automatic firmware upgrade via DFOTA. Then the module will download the delta firmware package from the HTTP server wirelessly and upgrade the firmware automatically. AT+QFOTADL DFOTA via HTTP Server Test Command AT+QFOTADL=? Write Command AT+QFOTADL= Response OK Response OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','DOWNLOADING', +QIND: 'FOTA','DOWNLOADING', ... +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... BC25&BC32_DFOTA_Application_Note 9 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note +QIND: 'FOTA','END', If there is any error: ERROR Or +CME ERROR: Parameter String format. The max length is 255 bytes. It should be started with 'HTTP://', for example: 'HTTP://:/'. String type. The IP address of the HTTP server. Integer type. The port of the HTTP server. The default value is 80. The range is 1-65535. String type. The file name in HTTP server. Integer type. The HTTP error code. 0 means download successfully. Any other value means an error. Please refer to Chapter 5 for more details. Integer type. The download or upgrade progress in percentage. Integer type. 0 means upgraded successfully. Any other value means an error. Please refer to Chapter 5 for more details. NOTE If the module is powered off during '+QIND: 'FOTA','UPDATING',', the module will automatically enter force upgrade mode when powered on next time, and continue the upgrading progress. The upgrade interface is shown as below: +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',2% ... +QIND: 'FOTA','END',0 BC25&BC32_DFOTA_Application_Note 10 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note 4 Examples 4.1. DFOTA via HTTP Server under NB-IoT Network //Upgrade firmware when delta firmware package is stored on an HTTP server. //The HTTP server address is 'http://224.168.203.812:3029/update.pack'. AT+COPS? //Query network status +COPS: 0,2,'46011',9 //The fourth parameter 9 means NB-IoT network OK //Under NB-IoT network, the module will use the parameter configured by AT+QCGDEFCONT and automatically activate IP AT+CGDCONT? +CGDCONT: 1,'IP','cmnbiot','100.68.194.234',0,0 OK //Execute AT+QFOTADL command to enable automatic firmware upgrade via DFOTA, and then the module will start to download the delta firmware package and upgrade firmware automatically. AT+QFOTADL= 'http://224.168.203.812:3029/update.pack' OK +QIND: 'FOTA','HTTPTART' +QIND: 'FOTA','DOWNLOADING',1% +QIND: 'FOTA','DOWNLOADING',2% ... +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 //The package from HTTP server is successfully downloaded BC25&BC32_DFOTA_Application_Note 11 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',2% ... +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 //The firmware is successfully upgraded 4.2. DFOTA via HTTP Server under GSM Network (BC32) //Upgrade firmware when delta firmware package is stored on an HTTP server. //The HTTP server address is 'http://224.168.203.812:3029/update.pack'. AT+COPS? //Query network status +COPS: 0,2,'46011',0 //The fourth parameter 0 means GSM network OK //When BC32 is under GSM network, it is needed to configure PDP and activate IP manually before downloading AT+CGDCONT=1,'IP' OK AT+CGACT=1,1 OK AT+CGDCONT? +CGDCONT: 1,'IP','','100.68.194.234',0,0 OK //Execute AT+QFOTADL command to enable automatic firmware upgrade via DFOTA, and then the module will start to download the delta firmware package and upgrade firmware automatically. AT+QFOTADL= 'http://224.168.203.812:3029/update.pack' OK +QIND: 'FOTA','HTTPTART' BC25&BC32_DFOTA_Application_Note 12 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note +QIND: 'FOTA','DOWNLOADING',1% +QIND: 'FOTA','DOWNLOADING',2% ... +QIND: 'FOTA','DOWNLOADING',100% +QIND: 'FOTA','HTTPEND',0 //The package from HTTP server is successfully downloaded +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1% +QIND: 'FOTA','UPDATING',2% ... +QIND: 'FOTA','UPDATING',100% +QIND: 'FOTA','END',0 //The firmware is successfully upgraded BC25&BC32_DFOTA_Application_Note 13 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note 5 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about and are described in the following tables. Table 1: Summary of Codes 0 6500 6501 Meaning Download successfully Unknown mistake Illegal parameter 6502 Upgrade package is too large 6503 6504 6505 6506 6507 Download failed Upgrade package not found Upgrade package failed to write flash There are no differential packages in the module file system Differential packet verification error 6509 Allocate memory failed Table 2: Summary of Codes 0 6508 Meaning Upgraded successfully Upgrade failed BC25&BC32_DFOTA_Application_Note 14 / 15 LPWA Module Series BC25&BC32 DFOTA Application Note 6 Appendix A References Table 3: Related Documents SN Document Name [1] Quectel_BC25_AT_Commands_Manual [2] Quectel_BC32_AT_Commands_Manual Remark AT commands manual for BC25 AT commands manual for BC32 Table 4: Terms and Abbreviations Abbreviation DFOTA HTTP LPWA NB-IoT Description Delta Firmware Upgrade Over-The-Air Hyper Text Transport Protocol (Secure) Low Power Wide Area Narrowband Internet of Things BC25&BC32_DFOTA_Application_Note 15 / 15

BC25&BC32 OneNET 应用指导 NB-IoT 模块系列 版本：BC25&BC32_OneNET_应用指导_V1.0 日期：2019-10-01 状态：受控文件 www.quectel.com BC25&BC32 OneNET 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 44 BC25&BC32 OneNET 应用指导 文档历史 修订记录 版本 日期 作者 1.0 2019-10-01 张鑫 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 44 BC25&BC32 OneNET 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 OneNET 数据交互机制 ......................................................................................................................... 7 3 OneNET 相关 AT 命令.......................................................................................................................... 8 3.1. AT 命令句法................................................................................................................................ 8 3.2. OneNET 相关 AT 命令详解 ........................................................................................................ 8 3.2.1. AT+MIPLCONFIG OneNET 接入配置 .......................................................................... 8 3.2.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 ........................................................ 10 3.2.3. AT+MIPLDELETE 删除 OneNET 通信套件实例..........................................................11 3.2.4. AT+MIPLVER 查询当前 OneNET SDK 版本 ...............................................................11 3.2.5. AT+MIPLADDOBJ 添加 LwM2M 对象 ........................................................................ 12 3.2.6. AT+MIPLDELOBJ 删除 LwM2M 对象......................................................................... 13 3.2.7. AT+MIPLOPEN 发送注册请求.................................................................................... 13 3.2.8. AT+MIPLCLOSE 发送注销请求.................................................................................. 14 3.2.9. AT+MIPLDISCOVERRSP 响应发现资源请求 ............................................................ 15 3.2.10. AT+MIPLOBSERVERSP 响应订阅请求 ..................................................................... 16 3.2.11. AT+MIPLREADRSP 响应读取请求 ............................................................................ 17 3.2.12. AT+MIPLWRITERSP 响应写入请求 ........................................................................... 18 3.2.13. AT+MIPLEXECUTERSP 响应执行请求 ..................................................................... 19 3.2.14. AT+MIPLPARAMETERRSP 响应写属性请求............................................................. 20 3.2.15. AT+MIPLNOTIFY 向 OneNET 平台或应用服务器上报数据 ....................................... 21 3.2.16. AT+MIPLUPDATE 发送更新请求................................................................................ 23 4 OneNET 相关 URC ............................................................................................................................. 24 4.1. +MIPLDISCOVER 通知 TE 响应发现资源请求的 URC......................................................... 24 4.2. +MIPLOBSERVE 通知 TE 响应订阅请求的 URC.................................................................. 25 4.3. +MIPLREAD 通知 TE 响应读取请求的 URC ......................................................................... 25 4.4. +MIPLWRITE 通知 TE 响应写入请求的 URC........................................................................ 26 4.5. +MIPLEXECUTE 通知 TE 响应执行请求的 URC .................................................................. 27 4.6. +MIPLPARAMETER 通知 TE 响应写属性请求的 URC ......................................................... 28 4.7. +MIPLEVENT 通知 TE 关于事件的 URC .............................................................................. 28 5 举例 ..................................................................................................................................................... 30 5.1. 接入配置 ................................................................................................................................... 30 5.2. 注册及发现资源操作................................................................................................................. 31 5.2.1. 注册及发现资源操作（平台端设置关闭自动订阅） ...................................................... 31 5.2.2. 注册及发现资源操作（平台端设置开启自动订阅） ...................................................... 32 5.2.3. 注册及发现资源操作（模块深度睡眠唤醒保存参数和状态）........................................ 33 5.3. 读取操作 ................................................................................................................................... 35 上海移远通信技术股份有限公司 3 / 44 BC25&BC32 OneNET 应用指导 5.3.1. 读取资源 ........................................................................................................................ 35 5.3.2. 读取实例 ........................................................................................................................ 35 5.3.3. 读取对象 ........................................................................................................................ 36 5.4. 写入操作 ................................................................................................................................... 36 5.4.1. 写入资源 ........................................................................................................................ 36 5.4.2. 写入实例 ........................................................................................................................ 37 5.5. 执行操作 ................................................................................................................................... 37 5.6. 写属性操作 ............................................................................................................................... 37 5.7. 订阅操作 ................................................................................................................................... 38 5.8. 上报数据操作............................................................................................................................ 38 5.8.1. 上报资源数据................................................................................................................. 38 5.8.2. 上报实例数据................................................................................................................. 38 5.8.3. 上报对象数据................................................................................................................. 39 5.8.4. 使用上报资源数据............................................................................................. 39 5.8.5. 使用上报实例数据............................................................................................. 40 5.9. 更新操作 ................................................................................................................................... 40 5.9.1. 更新操作（不自动更新生命周期） ................................................................................ 40 5.9.2. 更新操作（自动更新生命周期）.................................................................................... 41 6 值概览 ........................................................................................................................................ 42 7 附录 A 参考文档及术语缩写................................................................................................................ 44 上海移远通信技术股份有限公司 4 / 44 BC25&BC32 OneNET 应用指导 表格索引 表 1：AT 命令类型及其响应................................................................................................................................. 8 表 2：ONENET 相关 URC................................................................................................................................. 24 表 3：通用错误（27.007） ................................................................................................................................ 42 表 4：通用错误（27.005） ................................................................................................................................ 42 表 5：参考文档 .................................................................................................................................................. 44 表 6：术语缩写 .................................................................................................................................................. 44 上海移远通信技术股份有限公司 5 / 44 BC25&BC32 OneNET 应用指导 1 引言 LwM2M（轻量级机器对机器技术）是一种安全、高效、易部署的客户端-服务器协议，适用于不同网络 环境下资源有限的终端设备管理。LwM2M 基于 REST（表述性状态转移），采用现代架构设计，定义了一 个可扩展资源和数据模型，其消息传递是通过 CoAP（受限应用协议）这一高效安全的数据传输协议达成的。 依据 CoAP 协议（RFC 7252），LwM2M 提供了轻量紧凑安全的通信接口以及高效的数据模型，帮助实现 M2M 设备的管理与服务使能。 本文档主要介绍如何将应用了移远通信 BC25 模块和 BC32 模块的设备连接到中国移动 OneNET 物联 网开放平台（以下简称 OneNET），并通过 LwM2M 实现相关功能。 上海移远通信技术股份有限公司 6 / 44 BC25&BC32 OneNET 应用指导 2 OneNET 数据交互机制 本章节主要介绍 OneNET 数据交互机制。 终端设备 用户设备 OneNET平台 应用服务器 AT+CGATT? AT+MIPLCREATE AT+MIPLADDOBJ=... AT+MIPLOPEN=... URC: +MIPLEVENT: ... 10s URC: +MIPLDISCOVER: ... 超时 AT+MIPLDISCOVERRSP=... 10s URC: +MIPLPARAMETER: ... 超时 AT+MIPLPARAMETERRSP=... 10s URC: +MIPLOBSERVE: ... 超时 AT+MIPLOBSERVERSP=... 10s URC: +MIPLREAD: ... 超时 AT+MIPLREADRSP=... 10s URC: +MIPLWRITE: ... 超时 AT+MIPLWRITERSP=... 10s URC: +MIPLEXECUTE: ... 超时 AT+MIPLEXECUTERSP=... 注册请求 响应 发送发现资源请求 响应 发送写属性请求 响应 发送订阅请求 响应 发送读取请求 响应 发送写入请求 响应 发送执行请求 响应 AT+MIPLNOTIFY=... AT+MIPLUPDATE=... URC: +MIPLEVENT: ... AT+MIPLCLOSE= URC: +MIPLEVENT: ... AT+MIPLDELOBJ=... AT+MIPLDELETE= 通知OneNET平台 发送Update请求 响应 Deregister请求 响应 注册 操作 发送写属性请求 响应 发送订阅请求 响应 发送读取请求 响应 发送写入请求 响应 发送执行请求 响应 Notify the server Discover 操作 WriteAttributes 操作 Observe 操作 Read 操作 Write 操作 Execute 操作 Notify 操作 Update 操作 Deregister 操作 图 1：OneNET 数据交互示意图 上海移远通信技术股份有限公司 7 / 44 BC25&BC32 OneNET 应用指导 3 OneNET 相关 AT 命令 本章节主要展示说明操作 OneNET 功能的 AT 命令。 3.1. AT 命令句法 表 1：AT 命令类型及其响应 测试命令 查询命令 AT+=? AT+? 此命令返回通过相应设置命令或者内部程序可以设置的参数列表 以及其参数取值范围。 此命令返回所有参数的当前设置值。 设置命令 AT+= 此命令用来设置用户自定义的参数值。 执行命令 AT+ 此命令查询 UE 内部程序所控制的不可变参数。 3.2. OneNET 相关 AT 命令详解 3.2.1. AT+MIPLCONFIG OneNET 接入配置 此命令用来配置 Bootstrap（引导接口）模式和引导服务器地址或者 LwM2M 服务器地址，也可以用于 设置 CoAP 协议中的 ACK_TIMEOUT。CoAP 协议中最大传输等待时间 MAX_TRANSMIT_WAIT 等于 ACK_TIMEOUT * ((2(4 + 1)) - 1)。此命令还可以用来配置是否自动响应 OneNET 平台或者应用服务器的订 阅请求、存活周期即将到期时是否会自动更新，以及是否使能 OneNET 深睡眠唤醒保存参数和状态功能。 若不进行配置，参数将为默认值。相关值的说明，请参考章节 6。 AT+MIPLCONFIG OneNET 接入配置 测试命令 AT+MIPLCONFIG=? 响应 +MIPLCONFIG: ,[,] 查询命令 OK 响应 上海移远通信技术股份有限公司 8 / 44 BC25&BC32 OneNET 应用指导 AT+MIPLCONFIG? +MIPLCONFIG: ,, +MIPLCONFIG: , +MIPLCONFIG: , +MIPLCONFIG: ,, OK 若出现任何错误： ERROR 或 +CME ERROR: 设置命令 AT+MIPLCONFIG=,[,] 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 模式选项。 0 禁用 Bootstrap，并配置 LwM2M 服务器 IP 地址和端口 1 使能 Bootstrap，并配置 Bootstrap 服务器 IP 地址和端口，Bootstrap 服务器默 认地址为 183.230.40.39:5683 2 设置 CoAP 协议的参数 ACK_TIMEOUT 3 设置是否使能模块自动响应订阅请求 4 设置是否使能在存活周期即将到期时，自动更新存活周期；以及模块连接 OneNET 后进入深度睡眠再唤醒时是否保存已配置参数和状态功能 0 1 2 1 3 4 当=0，此参数为 LwM2M 服务器 IP 地址 当=1，此参数为 Bootstrap 服务器 IP 地址 当=0，此参数为 LwM2M 服务器端口 当=1，此参数为 Bootstrap 服务器端口 范围：1000-65535。 ACK_TIMEOUT 的值，范围：2-20，单位：秒，默认值：2。 是否使能模块自动响应订阅请求。 上海移远通信技术股份有限公司 9 / 44 BC25&BC32 OneNET 应用指导 0 禁止自动响应 1 使能自动响应，即 TE 不需要通过命令 AT+MIPLOBSERVERSP 响应订阅请求 是否使能在存活周期即将到期时，自动更新存活周期 0 关闭存活周期自动更新 1 使能自动更新存活周期，即当模块存活周期即将到期并上报 '+MIPLEVENT,14,'时，模块会自动更新存活周期 模块连接 OneNET 后进入深度睡眠是否保存已配置参数和状态功能 0 关闭保存参数和状态功能 1 使能保存参数和状态功能 备注 1. 需要在通过命令 AT+MIPLCREATE 创建通信实例之前使用此命令； 2. 参数和在设置后会被自动保存到 NVM 中； 3. 当=1 时，模块成功注册到 OneNET 平台后进入深度睡眠，会自动保存相关状态和参 数，被唤醒后模块从 NVM 读取相关状态和参数并恢复注册，此时无需手动进行 OneNET 重新连接 动作，可直接与 OneNET 平台和应用服务器进行交互。 4. 此命令的参数配置后不会立刻保存到 NVM 中（和除外），只有当参数 =1，且模块进入深度睡眠时才会保存。模块重启后参数会恢复到默认值。 3.2.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 此命令用来创建 OneNET 通信套件。相关值的说明，请参考章节 6。 AT+MIPLCREATE 创建 OneNET 通信套件实例 执行命令 AT+MIPLCREATE 响应 +MIPLCREATE: OK 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 OneNET 通信套件的实例 ID。 上海移远通信技术股份有限公司 10 / 44 BC25&BC32 OneNET 应用指导 3.2.3. AT+MIPLDELETE 删除 OneNET 通信套件实例 此命令用来删除 OneNET 通信套件中的实例。相关值的说明，请参考章节 6。 AT+MIPLDELETE 删除 OneNET 通信套件实例 测试命令 AT+MIPLDELETE=? 响应 +MIPLDELETE: 设置命令 AT+MIPLDELETE= OK 响应 OK 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 3秒 参数 OneNET 通信套件的实例 ID。 3.2.4. AT+MIPLVER 查询当前 OneNET SDK 版本 此命令用来查询 OneNET SDK 版本。 AT+MIPLVER 查询当前 OneNET SDK 版本 查询命令 AT+MIPLVER? 响应 +MIPLVER: 最大响应时间 OK 300 毫秒 参数 当前 OneNET SDK 版本。 上海移远通信技术股份有限公司 11 / 44 BC25&BC32 OneNET 应用指导 3.2.5. AT+MIPLADDOBJ 添加 LwM2M 对象 此命令用来添加 LwM2M 对象。相关值的说明，请参考章节 6。 AT+MIPLADDOBJ 添加 LwM2M 对象 测试命令 AT+MIPLADDOBJ=? 响应 +MIPLADDOBJ: ,,,, , 设置命令 AT+MIPLADDOBJ=,,,,, OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 OneNET 通信套件的实例 ID。 LwM2M 对象 ID，若对象 ID 不存在，则返回错误。 实例数量。 实例位图，字符串型，需标注双引号。例如，若共有 4 个实例，ID 分别为 0、1、2、 3，那么值为 4，同时='1101'表示实例 ID 0、1、3 将被 注册，而实例 ID 2 不会被注册。 属性个数，表示可读和/或可写资源个数。 动作个数，表示可执行的资源个数。 备注 1. 字符串的长度需要和数量保持一致。 2. 实际注册的实例个数由决定，而非。 上海移远通信技术股份有限公司 12 / 44 BC25&BC32 OneNET 应用指导 3.2.6. AT+MIPLDELOBJ 删除 LwM2M 对象 此命令用来删除 LwM2M 对象。相关值的说明，请参考章节 6。 AT+MIPLDELOBJ 删除 LwM2M 对象 测试命令 AT+MIPLDELOBJ=? 响应 +MIPLDELOBJ: , 设置命令 AT+MIPLDELOBJ=, OK 响应 OK 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 OneNET 通信套件的实例 ID。 LwM2M 对象 ID，若对象 ID 不存在，则返回错误。 3.2.7. AT+MIPLOPEN 发送注册请求 此命令用来向 OneNET 平台发送注册请求。相关值的说明，请参考章节 6。 AT+MIPLOPEN 发送注册请求 测试命令 AT+MIPLOPEN=? 响应 +MIPLOPEN: ,[,] 设置命令 AT+MIPLOPEN=,[,] 最大响应时间 OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 13 / 44 参数 BC25&BC32 OneNET 应用指导 OneNET 通信套件的实例 ID。 设备存活周期，范围：16-268435454，单位：秒。 注册超时时间，范围：30-65535，默认值为 60，单位：秒。 备注 在执行 AT+MIPLOPEN 后，如果由于网络或者相关配置问题出现 bootstrap 失败（+MIPLEVENT: 0,3） 或者注册失败（+MIPLEVENT: 0,7），模块会重新进行 bootstrap 和注册，如果连续三次尝试均失败，模 块便放弃此次注册请求动作，此时需要检查网络和相关配置，确认无问题后，重新执行 AT+MIPLOPEN。 3.2.8. AT+MIPLCLOSE 发送注销请求 此命令用来向 OneNET 平台发送注销请求。相关值的说明，请参考章节 6。 AT+MIPLCLOSE 发送注销请求 测试命令 AT+MIPLCLOSE=? 响应 +MIPLCLOSE: 设置命令 AT+MIPLCLOSE= OK 响应 OK 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 3秒 参数 OneNET 通信套件的实例 ID。 上海移远通信技术股份有限公司 14 / 44 BC25&BC32 OneNET 应用指导 3.2.9. AT+MIPLDISCOVERRSP 响应发现资源请求 此命令用来响应来自 OneNET 平台的发现资源请求。相关值的说明，请参考章节 6。 AT+MIPLDISCOVERRSP 响应发现资源请求 测试命令 AT+MIPLDISCOVERRSP=? 响应 +MIPLDISCOVERRSP: ,,[,, [,]] 设置命令 AT+MIPLDISCOVERRSP=,,[,,[ ,]] OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLDISCOVER'中获取。 发现资源结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示结果正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方式不允许） 15 4.06 Not acceptable（未接受） 参数的长度。 字符串型（需标记双引号），包含对象的属性。每个属性之间用分号隔开，例如： '1101;1102;1103'，属性的个数不应超过命令 AT+MIPLADDOBJ 的和 参数值的总和。 整数型，用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释 放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0-2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 上海移远通信技术股份有限公司 15 / 44 BC25&BC32 OneNET 应用指导 3.2.10. AT+MIPLOBSERVERSP 响应订阅请求 当自动响应订阅请求功能被禁用后，此命令用来手动响应 OneNET 平台或应用服务器发来的订阅请求。 相关值的说明，请参考章节 6。 AT+MIPLOBSERVERSP 响应订阅请求 测试命令 AT+MIPLOBSERVERSP=? 响应 +MIPLOBSERVERSP: ,,[,] 设置命令 AT+MIPLOBSERVERSP=,,[,] 最大响应时间 OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 OneNET 通信套件的实例 ID。 数据包 消息 ID，由 URC'+MIPLOBSERVE'中获取。 订阅结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示结果正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方式不允许） 15 4.06 Not acceptable（未接受） 整数型，用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释 放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0-2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 上海移远通信技术股份有限公司 16 / 44 BC25&BC32 OneNET 应用指导 3.2.11. AT+MIPLREADRSP 响应读取请求 此命令用来响应从 OneNET 平台或者应用服务器发来的读取请求。相关值的说明，请参考章节 6。 AT+MIPLREADRSP 响应读取请求 测试命令 AT+MIPLREADRSP=? 响应 +MIPLREADRSP: ,,[,,,,,,,,[,]] 设置命令 AT+MIPLREADRSP=,,< result>[,,,,,,,,[,]] OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLREAD'中获取。 读取结果，以下为结果码： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示结果正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方式不允许） 15 4.06 Not acceptable（未接受） 对象 ID，由 URC'+MIPLREAD'中获取。 实例 ID，由 URC'+MIPLREAD'中获取。 资源 ID，由 URC'+MIPLREAD'中获取。 值的类型。 1 String（字符串型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 值的长度，单位：字节。 上海移远通信技术股份有限公司 17 / 44 BC25&BC32 OneNET 应用指导 当=1 时，该参数值为字符串型数据的长度 当=2 时，该参数值为十六进制数据的长度 当=3 时，该参数值可以是 2、4 或 8 当=4 时，该参数值只能是 4 当=5 时，该参数值为 1 数据。 当=1 时，该参数值为字符串型格式，由双引号标记 当=2 时，该参数值为十六进制格式 当=3 时，该参数值为整数型格式 当=4 时，该参数值为浮点型格式 当=5 时，该参数值为布尔型格式 消息序号。如果读请求响应由多个消息组成，则需发送多条 AT 来响应。例如，若被分 成了 N 个部分，则参数需从 N-1 到 0 递减，AT 命令也按照从大到小的顺序执 行。=0 表示这是数据中最后一条消息。 消息指示，范围：0-2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 目前软件版本仅支持=0。 整数型，用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释 放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0-2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 备注 1. 此命令作为对读取请求的响应。 2. 若=2，十六进制值字符的个数为 2*；若=4，浮点型数据的长度建议 为 4 个字节，且参数的值应为 4。 3.2.12. AT+MIPLWRITERSP 响应写入请求 此命令用来响应来自 OneNE 平台或者应用服务器的写入请求。相关值的说明，请参考章节 6。 AT+MIPLWRITERSP 响应写入请求 测试命令 AT+MIPLWRITERSP=? 响应 +MIPLWRITERSP: ,,[,] 设置命令 AT+MIPLWRITERSP=,, [,] OK 响应 OK 上海移远通信技术股份有限公司 18 / 44 最大响应时间 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 BC25&BC32 OneNET 应用指导 参数 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLWRITE'中获取。 写入结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示正确结果 11 4.00 无效请求（Bad request） 12 4.01 未授权（Unauthorized） 13 4.04 未找到（Not found） 14 4.05 方式不允许（Method not allowed） 整数型，用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释 放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0-2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 3.2.13. AT+MIPLEXECUTERSP 响应执行请求 此命令用来响应来自 OneNET 平台或应用服务器的执行请求。相关值的说明，请参考章节 6。 AT+MIPLEXECUTERSP 响应执行请求 测试命令 AT+MIPLEXECUTERSP=? 响应 +MIPLEXECUTERSP: ,,[,] 设置命令 AT+MIPLEXECUTERSP=,,[,] 最大响应时间 OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 19 / 44 参数 BC25&BC32 OneNET 应用指导 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLEXECUTE'中获取。 执行结果，以下为结果码： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示正确结果 11 4.00 无效请求（Bad request） 12 4.01 未授权（Unauthorized） 13 4.04 未找到（Not found） 14 4.05 方式不允许（Method not allowed） 整数型，用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释 放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0-2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在回复后立即释放 3.2.14. AT+MIPLPARAMETERRSP 响应写属性请求 此命令用来响应来自 OneNET 平台和应用服务器的写属性请求。相关值的说明，请参考章节 6。 AT+MIPLPARAMETERRSP 响应写属性请求 测试命令 AT+MIPLPARAMETERRSP=? 响应 +MIPLPARAMETERRSP: ,,[,] 设置命令 AT+MIPLPARAMETERRSP=,,[,] OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 OneNET 通信套件的实例 ID。 数据包消息 ID，由 URC'+MIPLPARAMETER'中获取。 写属性操作结果，以下为结果码： 结果码 CoAP 响应码 描述 上海移远通信技术股份有限公司 20 / 44 BC25&BC32 OneNET 应用指导 2 2.04 Changed，表示正确结果 11 4.00 无效请求（Bad request） 12 4.01 未授权（Unauthorized） 13 4.04 未找到（Not found） 14 4.05 方式不允许（Method not allowed） 整数型，用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释 放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0-2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在下发后立即释放 3.2.15. AT+MIPLNOTIFY 向 OneNET 平台或应用服务器上报数据 此命令用来向 OneNET 平台或应用服务器上报数据。相关值的说明，请参考章节 6。 AT+MIPLNOTIFY 向 OneNET 或应用服务器发送数据 测试命令 AT+MIPLNOTIFY=? 响应 +MIPLNOTIFY: ,,,,,,,,[,[,]] 设置命令 AT+MIPLNOTIFY=,,,,,,,,,[,[, ]] OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 OneNET 通信套件的实例 ID。 消息 ID，由 URC'+MIPLOBSERVE'中获取。 对象 ID，若对象 ID 不存在将返回错误。 实例 ID，由 URC'+MIPLOBSERVE'中获取。 资源 ID，由 URC'+MIPLOBSERVE'中获取。 值的类型。 1 String（字符串型） 2 Opaque（不透明型） 3 Integer（整数型） 上海移远通信技术股份有限公司 21 / 44 BC25&BC32 OneNET 应用指导 4 Float（浮点型） 5 Boolean（布尔型） 值的长度，单位：字节。 当=1 时，该参数值为字符串型数据的长度 当=2 时，该参数值为十六进制数据的长度 当=3 时，该参数值可以是 2、4 或者 8 当=4 时，该参数值只能是 4 当=5 时，该参数值为 1 数据。 当=1 时，该参数值为字符串型格式，应该由双引号标记 当=2 时，该参数值为十六进制格式 当=3 时，该参数值为整数型格式 当=4 时，该参数值为浮点型格式 当=5 是，该参数值为布尔型格式 消息序号。如果读请求响应由多个消息组成，则需发送多条 AT 来响应。若被分成了 N 个部分，则参数需从 N-1 到 0 递减，AT 命令也按照从大到小的顺序执行。 =0 表示这是数据中最后一条消息。 消息指示，范围：0-2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 该版本仅支持=0。 整数型，范围：0-65535 0 数据以 Non-confirmable（不需要确认）消息格式发送，即 NON 数据 1~65535 数据以 Confirmable（需要确认）消息格式发送，即 CON 数据，且消息发 送结果在上报的'+MIPLEVENT'URC 中 整数型，用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释 放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0-2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在下发后立即释放 备注 1. 若=2，十六进制值字符的个数为 2*；若=4，浮点型数据的长度建 议为 4 个字节，且参数的值为 4。 2. 对于需要 AT+MIPLNOTIFY 命令指示核心网快速释放 RRC 连接的场景，上报 CON 数据时， 建议值为 2，上报 NON 数据时，建议值为 1。 上海移远通信技术股份有限公司 22 / 44 BC25&BC32 OneNET 应用指导 3.2.16. AT+MIPLUPDATE 发送更新请求 此命令用来发送更新请求，以更新使用期限和对象列表。相关值的说明，请参考章节 6。 AT+MIPLUPDATE 发送更新请求 测试命令 AT+MIPLUPDATE=? 响应 +MIPLUPDATE: ,,[,] 设置命令 AT+MIPLUPDATE=,, [,] OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 OneNET 通信套件的实例 ID。 设备存活周期。范围：0 或 16-268435454。单位：秒。0 表示该使用期限是 86400 秒。 是否更新对象列表 0 不使用 1 使用 整数型，用于指定消息传输携带的快速释放标记 RAI（Release Assistant Indication 释放辅助提示），该标记用于指示核心网释放与模块的 RRC 连接，范围：0-2。 0 无指示 1 指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放 2 指示该包上行数据后期望有对应的单个下行数据包回复，核心网在下发后立即 释放 备注 对于需要 AT+MIPLUPDATE 命令指示核心网快速释放 RRC 连接的场景，建议值为 2。 AT+MIPLUPDATE 命令，不存在为 1 的场景，因此不建议设置为 1。 上海移远通信技术股份有限公司 23 / 44 BC25&BC32 OneNET 应用指导 4 OneNET 相关 URC 本章节主要描述与 OneNET 相关的一系列 URC 及其描述。 表 2：OneNET 相关 URC 编号 URC 描述 [1] +MIPLDISCOVER: ,, 当 OneNET 平台发送了一个发现资源请求，模 块接收到请求后会上报该 URC。 [2] +MIPLOBSERVE: ,,,,, 阅请求，模块接收到请求后会立即上报该 URC。 [3] +MIPLREAD: ,,,, 取请求，模块接收到请求后会上报该 URC。 [4] +MIPLWRITE: ,,,,,,,,, 当 OneNET 平台或者应用服务器发送了一个写 入请求，模块接收到请求后会上报该 URC。 [5] +MIPLEXECUTE: ,,,,[,,] 行请求，模块接收到请求后会上报该 URC。 [6] +MIPLPARAMETER: ,,, 当 OneNET 平台或者应用服务器发送了一个写 ,,, 属性请求，模块接收到请求后会上报该 URC。 [7] +MIPLEVENT: ,[,][,] 当有事件发生需要通知 TE，则上报该 URC。 4.1. +MIPLDISCOVER 通知 TE 响应发现资源请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 发来的发现资源请求。该 URC 完全输出以后，TE 应在 10 秒 内通过命令 AT+MIPLDISCOVERRSP 响应请求。 +MIPLDISCOVER 通知 TE 响应发现资源请求的 URC URC 格式 +MIPLDISCOVER: ,, 上海移远通信技术股份有限公司 24 / 44 参数 BC25&BC32 OneNET 应用指导 OneNET 通信套件的实例 ID。 数据包消息 ID。 资源发现请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 4.2. +MIPLOBSERVE 通知 TE 响应订阅请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 或者应用服务器发来的订阅请求。若禁用了自动响应订阅请求， 该 URC 完全输出以后，TE 应在 10 秒内通过命令 AT+MIPLOBSERVERSP 响应请求。 +MIPLOBSERVE 通知 TE 响应订阅请求的 URC URC 格式 +MIPLOBSERVE: ,,,,, 参数 OneNET 通信套件的实例 ID。 数据包消息 ID。 表示是否订阅 0 取消订阅 1 订阅 订阅请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 订阅请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示订阅或者取 消订阅该对象 ID 下所有实例的所有资源。 订阅请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示订阅或者取 消订阅该实例下的所有资源。 4.3. +MIPLREAD 通知 TE 响应读取请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 平台或者应用服务器发来的读取请求。该 URC 完全输出以后， TE 应在 10 秒内通过命令 AT+MIPLREADRSP 响应请求。 +MIPLREAD 通知 TE 响应读取请求的 URC URC 格式 +MIPLREAD: ,,,, 上海移远通信技术股份有限公司 25 / 44 参数 BC25&BC32 OneNET 应用指导 OneNET 通信套件的实例 ID。 数据包消息 ID。 读取请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 读取请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示读取该对象 下的所有资源。 读取请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示读取该实例 下的所有资源。 4.4. +MIPLWRITE 通知 TE 响应写入请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 平台或者应用服务器发来的写入请求。该 URC 完全输出以后， TE 应在 10 秒内通过命令 AT+MIPLWRITERSP 响应请求。 +MIPLWRITE 通知 TE 响应写入请求的 URC URC 格式 +MIPLWRITE: ,,,,,,,,, 通知 TE 响应 OneNET 平台或者应用服务器发来的写入请求。 参数 OneNET 通信套件的实例 ID。 数据包消息 ID。 写入请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 写入请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的。 写入请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的。 值的类型（当前仅显示不透明型）。 1 String（字符串型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 值的长度，单位：字节。 当=1 时，该参数值为字符串型数据的长度 当=2 时，该参数值为十六进制数据的长度 当=3 时，该参数值可以是 2、4 或者 8 当=4 时，改参数只能是 4 当=5 时，该参数值为 1 上海移远通信技术股份有限公司 26 / 44 BC25&BC32 OneNET 应用指导 数据值，从 OneNET 平台或者应用服务器处接收到的十六进制格式数据。 消息指示，范围：0-2。 0 表示中最后一条消息 1 表示中第一条消息 2 表示中中间的消息 该版本仅支持=0。 消息序号。如果读请求响应由多个消息组成，则需发送多条 AT 来响应。例如，若被分 成了 N 个部分，则参数需从 N-1 到 0 递减，AT 命令也按照从大到小的顺序执 行。=0 表示这是数据中最后一条消息。 备注 应用服务器发送的写入请求中数据长度应小于 1000 字节，否则可能会失败。 4.5. +MIPLEXECUTE 通知 TE 响应执行请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 平台或者应用服务器发来的执行请求。该 URC 完全输出以后， TE 应在 10 秒内通过命令 AT+MIPLEXECUTERSP 响应请求。 +MIPLEXECUTE 通知 TE 响应执行请求的 URC URC 格式 +MIPLEXECUTE: ,,,,[,,] 通知 TE 响应 OneNET 平台或者应用服务器发来的执行请 求。 Parameter OneNET 通信套件的实例 ID。 数据包消息 ID。 执行请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 执行请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的。 执行请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的。 表示参数的长度，单位：字节 字符串型，执行操作中的 Arguments 对象。 上海移远通信技术股份有限公司 27 / 44 BC25&BC32 OneNET 应用指导 4.6. +MIPLPARAMETER 通知 TE 响应写属性请求的 URC 该 URC 主要用来通知 TE 响应 OneNET 平台或者应用服务器发来的写属性请求。该 URC 完全输出以 后，TE 应在 10 秒内通过命令 AT+MIPLPARAMETERRSP 响应请求。 +MIPLPARAMETER 通知 TE 响应写属性请求的 URC URC 格式 +MIPLPARAMETER: ,, ,,,, 通知 TE 响应 OneNET 平台或者应用服务器发来的写属性请求。 Parameter OneNET 通信套件的实例 ID。 数据包消息 ID。 写属性请求的对象 ID，从 OneNET 平台或者应用服务器处接收到的。 写属性请求的实例 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示 适用于该对象下所有资源。 写属性请求的资源 ID，从 OneNET 平台或者应用服务器处接收到的，-1 表示 适用于该实例下所有资源。 表示参数的长度，单位：字节 字符串型，写属性操作中的参数。 4.7. +MIPLEVENT 通知 TE 关于事件的 URC 该 URC 主要用来向 TE 通知事件。 +MIPLEVENT 通知 TE 关于事件的 URC URC 格式 +MIPLEVENT: ,[,][,] 参数 OneNET 通信套件的实例 ID。 事件标识符： 1 EVENT_BOOTSTRAP_START 2 EVENT_BOOTSTRAP_SUCCESS 3 EVENT_BOOTSTRAP_FAILED 上海移远通信技术股份有限公司 28 / 44 BC25&BC32 OneNET 应用指导 4 EVENT_CONNECT_SUCCESS 5 EVENT_CONNECT_FAILED 6 EVENT_REG_SUCCESS 7 EVENT_REG_FAILED 8 EVENT_REG_TIMEOUT 9 EVENT_LIFETIME_TIMEOUT 10 EVENT_STATUS_HALT 11 EVENT_UPDATE_SUCCESS 12 EVENT_UPDATE_FAILED 13 EVENT_UPDATE_TIMEOUT 14 EVENT_UPDATE_NEED 15 EVENT_DEREG_DONE 20 EVENT_RESPONSE_FAILED 21 EVENT_RESPONSE_SUCCESS 25 EVENT_NOTIFY_FAILED 26 EVENT_NOTIFY_SUCCESS 40 EVENT_FIRMWARE_DOWNLOADING 41 EVENT_FIRMWARE_DOWNLOAD_FAILED 42 EVENT_FIRMWARE_DOWNLOADED 43 EVENT_FIRMWARE_UPDATING 44 EVENT_FIRMWARE_UPDATE_SUCCESS 45 EVENT_FIRMWARE_UPDATE_FAILED 46 EVENT_FIRMWARE_UPDATE_OVER 47 EVENT_FIRMWARE_DOWNLOAD_DISCONNECT 48 EVENT_FIRMWARE_ERASE_SUCCESS 49 EVENT_FIRMWARE_ERASE_FAIL 扩展参数： 当=20，显示回复命令的消息 ID。 当=14，显示存活周期期限的剩余时间，单位：秒 整数型，范围：1-65535，通过 AT 命令 AT+MIPLNOTIFY 命令设置的 CON 信息的 。 上海移远通信技术股份有限公司 29 / 44 BC25&BC32 OneNET 应用指导 5 举例 本章节通过实例来解释如何使用 OneNET 相关的 AT 命令。 5.1. 接入配置 该示例演示了如何配置 Bootstrap 模式和 Bootstrap 服务器地址或者访问服务器，以及如何设置 CoAP 协议的参数 ACK_TIMEOUT。 AT+MIPLCONFIG=? +MIPLCONFIG: ,[,] OK AT+MIPLCONFIG=1,183.230.40.39,5683 OK //使能 Bootstrap 并配置 Bootstrap 服务器 IP 地址和端口 AT+MIPLCONFIG? +MIPLCONFIG: 1,183.230.40.39,5683 +MIPLCONFIG: 2,2 +MIPLCONFIG: 3,1 +MIPLCONFIG: 4,0,1 OK AT+MIPLCONFIG=0,183.230.40.40,5683 OK //禁用 Bootstrap 并配置访问服务器 IP 地址和端口 AT+MIPLCONFIG? +MIPLCONFIG: 0,183.230.40.40,5683 +MIPLCONFIG: 2,2 +MIPLCONFIG: 3,1 +MIPLCONFIG: 4,0,1 OK //设置参数 ACK_TIMEOUT 值为 9 秒。 上海移远通信技术股份有限公司 30 / 44 AT+MIPLCONFIG=2,1,9 OK AT+MIPLCONFIG? +MIPLCONFIG: 0,183.230.40.40,5683 +MIPLCONFIG: 2,9 +MIPLCONFIG: 3,1 +MIPLCONFIG: 4,0,1 OK BC25&BC32 OneNET 应用指导 5.2. 注册及发现资源操作 5.2.1. 注册及发现资源操作（平台端设置关闭自动订阅） 在平台端设置关闭自动订阅的情况下，下面的举例中详述了注册以及发现资源操作。 //使能 Bootstrap 模式的情况下，使用单个命令创建通信套件实例 AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例 OK //添加一个 LwM2M 对象 AT+MIPLADDOBJ=0,3311,2,'11',4,2 OK //成功添加对象，并且将要注册 ID 为 0 和 1 的实例 AT+MIPLOPEN=0,600,60 OK +MIPLEVENT: 0,1 //向 OneNET 发送注册请求 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLDISCOVER: 0,26384,3311 //接收到发现资源请求 //使用资源 ID 列表响应发现资源资源请求 AT+MIPLDISCOVERRSP=0,26384,1,19,'5850;5851;5706;5805' OK 上海移远通信技术股份有限公司 31 / 44 BC25&BC32 OneNET 应用指导 AT+MIPLDELOBJ=0,3311 OK //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //删除通信套件实例 AT+MIPLDELETE=0 OK //删除一个 LwM2M 对象 //注销成功 //成功删除通信套件实例 5.2.2. 注册及发现资源操作（平台端设置开启自动订阅） 在平台端设置开启自动订阅的情况下，下面的举例中详述了注册以及发现资源操作。 //在默认配置下使用单个命令创建通信套件实例 AT+MIPLCONFIG? +MIPLCONFIG: 1,183.230.40.39,5683 +MIPLCONFIG: 2,2 +MIPLCONFIG: 3,1 //使能模块自动响应订阅请求的功能 +MIPLCONFIG: 4,0,1 OK AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例 OK //添加一个 LwM2M 对象 AT+MIPLADDOBJ=0,3311,2,'11',4,2 OK //成功添加对象，并且将要注册 ID 为 0 和 1 的实例 //向 OneNET 发送注册请求 AT+MIPLOPEN=0,600,60 OK +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 上海移远通信技术股份有限公司 32 / 44 BC25&BC32 OneNET 应用指导 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLOBSERVE: 0,78025,1,3311,0,-1 //收到订阅（3311/0）请求 +MIPLOBSERVE: 0,143562,1,3311,1,-1 //收到订阅（3311/1）请求 +MIPLDISCOVER: 0,12491,3311 //收到发现资源请求 //使用资源 ID 列表响应发现资源资源请求 AT+MIPLDISCOVERRSP=0,12491,1,19,'5850;5851;5706;5805' OK AT+MIPLDELOBJ=0,3311 OK //删除一个 LwM2M 对象 //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //注销成功 //删除通信套件实例 AT+MIPLDELETE=0 OK //成功删除通信套件实例 5.2.3. 注册及发现资源操作（模块深度睡眠唤醒保存参数和状态） 在使能模块连接 OneNET 后进入深度睡眠再唤醒时保存参数和状态功能的情况下，下面的举例中详述 了注册以及发现资源操作。 //在默认配置下使用单个命令创建通信套件实例 AT+QSCLK=0 OK //做业务前关闭模块休眠功能 AT+MIPLCONFIG? +MIPLCONFIG: 1,183.230.40.39,5683 +MIPLCONFIG: 2,2 +MIPLCONFIG: 3,1 +MIPLCONFIG: 4,0,1 //使能模块深度睡眠唤醒时保存参数和状态功能 OK 上海移远通信技术股份有限公司 33 / 44 BC25&BC32 OneNET 应用指导 AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例 OK //添加一个 LwM2M 对象 AT+MIPLADDOBJ=0,3311,1,'1',4,1 OK //成功添加对象，并且将要注册 ID 为 0 的实例 //向 OneNET 发送注册请求 AT+MIPLOPEN=0,600,60 OK +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLOBSERVE: 0,126564,1,3311,0,-1 //收到订阅（3311/0）请求 +MIPLDISCOVER: 0,61029,3311 //收到发现资源请求 //使用资源 ID 列表响应发现资源资源请求 AT+MIPLDISCOVERRSP=0,61029,1,19,'5805;5850;5851;5706' OK AT+QSCLK=1 OK //业务完成后，需要时打开深度睡眠功能，等待模块进入深度睡眠 //模块进入深度睡眠 +QATSLEEP //拉低 PSM_EINT 唤醒模块 +QATWAKEUP //模块从深度睡眠被唤醒 AT+QSCLK=0 OK //做业务前关闭模块休眠功能，业务完成后需要模块休眠时再打开 //模块恢复参数及状态成功，此时模块状态与进入深度睡眠前一致，可以直接上报数据与接收 OneNET 平 台和应用服务器请求 +MIPLEVENT: 0,4 上海移远通信技术股份有限公司 34 / 44 AT+MIPLDELOBJ=0,3311 OK //删除一个 LwM2M 对象 //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //成功注销 //删除通信套件实例 AT+MIPLDELETE=0 OK //成功删除通信套件实例 BC25&BC32 OneNET 应用指导 5.3. 读取操作 5.3.1. 读取资源 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送读取资源（3311/0/5805）请求。 +MIPLREAD: 0,3123,3311,0,5805 AT+MIPLREADRSP=0,3123,1,3311,0,5805,4,4,1.88,0,0 OK //收到读取资源请求 //响应读取请求 //成功发送数据 1.88 到应用服务器 5.3.2. 读取实例 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送读取实例（3311/0）请求。 +MIPLREAD: 0,25466,3311,0,-1 //收到读取实例请求 AT+MIPLREADRSP=0,25466,1,3311,0,5851,5,1,1,3,0 //发送 4 条消息回应读取请求 OK AT+MIPLREADRSP=0,25466,1,3311,0,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5706,1,10,'1234567890',1,0 上海移远通信技术股份有限公司 35 / 44 OK AT+MIPLREADRSP=0,25466,1,3311,0,5805,4,4,1.88,0,0 OK BC25&BC32 OneNET 应用指导 5.3.3. 读取对象 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送读取对象（3311）请求。 +MIPLREAD: 0,39299,3311,-1,-1 //收到读取对象请求 AT+MIPLREADRSP=0,39299,1,3311,0,5851,5,1,1,5,0 //发送 6 条消息回应读取请求 OK AT+MIPLREADRSP=0,39299,1,3311,0,5852,3,2,123,4,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5805,4,4,1.88,0,0 OK 5.4. 写入操作 5.4.1. 写入资源 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送写入资源（3311/0/5706）请求，并含有字符串格式的写入值：hello。 +MIPLWRITE: 0,38017,3311,0,5706,2,5,68656C6C6F,0,0 //收到写入资源请求 AT+MIPLWRITERSP=0,38017,2 OK //响应写入请求，其中结果码为 2 上海移远通信技术股份有限公司 36 / 44 BC25&BC32 OneNET 应用指导 5.4.2. 写入实例 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送写入实例（3311/0）请求。 +MIPLWRITE: 0,46584,3311,0,5706,2,5,68656C6C6F,0,2 //收到写入实例请求 +MIPLWRITE: 0,46584,3311,0,5850,2,1,01,0,1 +MIPLWRITE: 0,46584,3311,0,5851,2,8,00000002DFDC1C3E,0,0 AT+MIPLWRITERSP=0,46584,2 OK //响应写入请求，其中结果码为 2 5.5. 执行操作 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送执行请求，其中包含 Argument：reset。 +MIPLEXECUTE: 0,36476,3303,0,5605,5,'reset' //收到执行请求 AT+MIPLEXECUTERSP=0,36476,2 OK //响应执行请求，其中结果码为 2 5.6. 写属性操作 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送写属性请求。 +MIPLPARAMETER: 0,56642,3303,0,5700,38,'pmin=2;pmax=190;gt=100.0;lt=1.0;st=0.2' //收到写属性请求 AT+MIPLPARAMETERRSP=0,56642,2 OK //响应写属性请求，其中结果码为 2 上海移远通信技术股份有限公司 37 / 44 5.7. 订阅操作 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经向 UE 发送订阅请求； 3. 禁用了模块的自动响应订阅请求功能。 +MIPLOBSERVE: 0,29620,1,3311,0,-1 AT+MIPLOBSERVERSP=0,29620,1 OK BC25&BC32 OneNET 应用指导 //收到订阅请求 //确认订阅请求 5.8. 上报数据操作 5.8.1. 上报资源数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅资源（3303/0/5700），且订阅请求的参数为 122179。 AT+MIPLNOTIFY=0,122179,3303,0,5700,4,4,25.6,0,0 OK //通知资源数据 5.8.2. 上报实例数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅实例（3303/0），且订阅请求的参数为 653687。 AT+MIPLNOTIFY=0,653687,3303,0,5700,4,4,10.24,3,0 OK //通知实例数据 AT+MIPLNOTIFY=0,653687,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5601,4,4,0.16,1,0 OK 上海移远通信技术股份有限公司 38 / 44 AT+MIPLNOTIFY=0,653687,3303,0,5602,4,4,100.86,0,0 OK BC25&BC32 OneNET 应用指导 5.8.3. 上报对象数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅对象（3303），且订阅请求的参数为 196301。 AT+MIPLNOTIFY=0,196301,3303,0,5700,4,4,9.8,3,0 OK //上报实例 ID 为 0 下资源的数据 AT+MIPLNOTIFY=0,196301,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5602,4,4,99.8,0,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5700,4,4,0.2,3,0 OK //上报实例 ID 为 1 下资源的数据 AT+MIPLNOTIFY=0,196301,3303,1,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5601,4,4,3.2,1,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5602,4,4,100.1,0,0 OK 5.8.4. 使用上报资源数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅资源（3303/0/5701），且订阅请求的参数为 307353。 AT+MIPLNOTIFY=0,307353,3303,0,5701,1,3,'Cel',0,0,255 //使用（225）上报资源数据 OK 上海移远通信技术股份有限公司 39 / 44 BC25&BC32 OneNET 应用指导 +MIPLEVENT: 0,26,255 //返回上报结果 5.8.5. 使用上报实例数据 前提条件： 1. UE 已经成功注册到 OneNET 平台； 2. 应用服务器已经成功订阅资源（3303/0），且订阅请求的参数为 487674。 AT+MIPLNOTIFY=0,487674,3303,0,5700,4,4,170.1,3,0,258 //使用（258）上报资源数据 OK AT+MIPLNOTIFY=0,487674,3303,0,5701,1,3,'Cel',2,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5601,4,4,106.1,1,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5602,4,4,660.9,0,0,258 OK +MIPLEVENT: 0,26,258 //返回上报结果 5.9. 更新操作 前提条件： UE 已经成功注册到 OneNET。 5.9.1. 更新操作（不自动更新生命周期） 在禁用了 OneNET 在存活周期即将到期时自动更新的情况下，下面的举例中详述了更新操作。 AT+MIPLUPDATE=0,86400,0 OK //更新存活周期为 86400 秒。 +MIPLEVENT: 0,11 //返回更新结果 上海移远通信技术股份有限公司 40 / 44 BC25&BC32 OneNET 应用指导 5.9.2. 更新操作（自动更新生命周期） 在使能 OneNET 在存活周期即将到期时自动更新的情况下，下面的举例中详述了更新操作。 //在存活周期即将到期时，上报需要更新存活周期的 URC +MIPLEVENT: 0,14,26 +MIPLEVENT: 0,11 //UE 自动更新并返回更新结果 上海移远通信技术股份有限公司 41 / 44 BC25&BC32 OneNET 应用指导 6 值概览 本章节主要介绍与 BC25 和 BC32 模块相关的值。 下面两个表中列出的错误值符合 3GPP 规范。可参考 3GPP TS 27.007 V13.5.0, sub-clause 9.2 获取 更多值。 表 3：通用错误（27.007） 值 3 4 23 30 50 52 53 159 描述 Operation not allowed Operation not supported Memory failure No network service Execute fail Option not support Param invalid Uplink busy/flow control 表 4：通用错误（27.005） Values 300 301 302 303 304 Description ME failure SMS service of ME reserved Operation not allowed Operation not supported Invalid PDU mode parameter 上海移远通信技术股份有限公司 42 / 44 BC25&BC32 OneNET 应用指导 305 Invalid text mode parameter 310 USIM not inserted 311 USIM PIN required 312 PH-USIM PIN required 313 USIM failure 314 USIM busy 315 USIM wrong 316 USIM PUK required 317 USIM PIN2 required 318 USIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network service 332 Network timeout 340 No +CNMA acknowledgement expected 500 Unknown error 备注 可以使用 AT+CMEE=命令禁用（=0）或者使能（=1，=2）最终结果码的上报+CME ERROR: 上海移远通信技术股份有限公司 43 / 44 BC25&BC32 OneNET 应用指导 7 附录 A 参考文档及术语缩写 表 5：参考文档 编号 文档名称 备注 [1] IPSO-Smart-Objects-Starter-Pack IPSO 联盟 [2] OMA-TS-LightweightM2M-V1_0 开放式移动联盟 LwM2M 规格书 [3] Quectel_BC25_AT_Commands_Manual_V1.0 BC25 模块 AT 命令说明 [4] Quectel_BC32_AT_Commands_Manual_V1.0 BC32 模块 AT 命令说明 表 6：术语缩写 缩写 CoAP ID LwM2M LPWA ME NB-IoT NVM IPSO RAI REST TE UE URC 英文全称 中文全称 Constrained Application Protocol 受限应用协议 Identifier 标识符 Lightweight Machine to Machine 轻量化 M2M Low-Power Wide-Area 低功耗广域 Mobile Equipment 移动设备 Narrow Band Internet of Things 窄带物联网 Non-volatile Memory 非易失性内存 Internet Protocol for Smart Objects 智能设备互联网协议 Release Assistant Indication 释放辅助指示 Representational State Transfer 表述性状态传递 Terminal Equipment (Typically the MCU) 终端设备（典型为 MCU 微型控制单元） User Equipment (Typically the Module) 用户设备（典型为模块） Unsolicited Result Code 非请求结果码 上海移远通信技术股份有限公司 44 / 44

BC25&BC32 TCP/IP 应用指导 NB-IoT 模块系列 版本：BC25&BC32_TCP/IP_应用指导_V1.0 日期：2019-10-23 状态：受控文件 www.quectel.com BC25&BC32 TCP/IP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 36 BC25&BC32 TCP/IP 应用指导 文档历史 修订记录 版本 1.0 日期 2019-10-23 作者 宋聪强 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 36 BC25&BC32 TCP/IP 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. TCP/IP AT 命令的使用原理......................................................................................................... 6 1.2. 数据访问模式说明 ....................................................................................................................... 6 2 TCP/IP AT 命令详解 ..............................................................................................................................8 2.1. AT 命令说明 ................................................................................................................................8 2.1.1. AT+QIOPEN 开启 Socket.............................................................................................. 8 2.1.2. AT+QICLOSE 关闭 Socket............................................................................................ 9 2.1.3. AT+QISTATE 查询 Socket 状态 .................................................................................. 10 2.1.4. AT+QISEND 发送文本字符串数据 .............................................................................. 12 2.1.5. AT+QIRD 读取收到的 TCP/IP 数据 ............................................................................. 13 2.1.6. AT+QISENDEX 发送十六进制字符串数据 .................................................................. 14 2.1.7. AT+QISWTMD 切换数据访问模式 .............................................................................. 16 2.1.8. AT+QPING 进行远程服务器 Ping 操作 ....................................................................... 17 2.1.9. AT+QNTP 通过 NTP 服务器同步本地时间.................................................................. 18 2.1.10. AT+QIDNSGIP 通过域名获取 IP 地址......................................................................... 19 2.1.11. AT+QICFG 配置可选参数............................................................................................ 20 2.1.12. AT+QIGETERROR 查询上一个错误码 ....................................................................... 21 2.1.13. AT+QIKALIVE 配置 TCP Socket Keepalive 功能........................................................ 22 2.1.14. AT+QIDNSCFG 配置 DNS 服务器功能....................................................................... 23 2.2. URC 说明 ..................................................................................................................................24 2.2.1. 连接断开 URC ................................................................................................................ 24 2.2.2. 下行数据 URC ................................................................................................................ 24 2.2.3. 下行数据缓存已满 URC.................................................................................................. 25 2.2.4. 下行连接已达上限 URC.................................................................................................. 25 2.2.5. 下行连接请求 URC......................................................................................................... 25 3 相关错误码 ........................................................................................................................................... 26 4 举例 ...................................................................................................................................................... 28 4.1. TCP 客户端在 Buffer 模式下工作 .............................................................................................. 28 4.1.1. 创建一个 TCP 客户端连接并进入 Buffer 模式................................................................ 28 4.1.2. 在 Buffer 模式下发送数据............................................................................................... 28 4.1.3. 在 Buffer 模式下从远程服务器上接收数据 ..................................................................... 29 4.1.4. 断开连接 ......................................................................................................................... 30 4.2. TCP 客户端在 Direct Push 模式下工作..................................................................................... 30 4.2.1. 创建一个 TCP 客户端连接并进入 Direct Push 模式....................................................... 30 4.2.2. 在 Direct Push 模式下发送数据...................................................................................... 30 4.2.3. 在 Direct Push 模式下接收来自远程服务器的数据......................................................... 30 上海移远通信技术股份有限公司 3 / 36 BC25&BC32 TCP/IP 应用指导 4.2.4. 断开 TCP 客户端连接 ..................................................................................................... 31 4.3. TCP 服务器在 Buffer 模式下工作 .............................................................................................. 31 4.3.1. 启动 TCP 服务器 ............................................................................................................ 31 4.3.2. 接受 TCP 连接请求......................................................................................................... 31 4.3.3. 从新连接中接收数据....................................................................................................... 31 4.3.4. 关闭 TCP 服务器 ............................................................................................................ 32 4.4. UDP 客户端模式（支持深度睡眠唤醒） ................................................................................... 32 4.5. UDP 服务器模式* ......................................................................................................................33 4.5.1. 启动 UDP 服务器............................................................................................................ 33 4.5.2. 从远程新连接中接收数据 ............................................................................................... 33 4.5.3. 关闭 UDP 服务器............................................................................................................ 33 4.6. 进行远程服务器 Ping 操作......................................................................................................... 34 4.7. 同步本地时间.............................................................................................................................34 4.8. 获取上一个错误码 ..................................................................................................................... 34 5 附录 A 参考文档及术语缩写................................................................................................................. 35 上海移远通信技术股份有限公司 4 / 36 BC25&BC32 TCP/IP 应用指导 表格索引 表 1：错误码概览............................................................................................................................................... 26 表 2：PING 结果概览......................................................................................................................................... 27 表 3：参考文档 .................................................................................................................................................. 35 表 4：术语缩写 .................................................................................................................................................. 35 上海移远通信技术股份有限公司 5 / 36 BC25&BC32 TCP/IP 应用指导 1 引言 移远通信 BC25 模块和 BC32 模块都内置 TCP/IP 协议栈，使终端设备可以直接通过 AT 命令访问网络。 因此，在很大程度上降低了终端设备对 PPP 协议和 TCP/IP 协议栈的依赖性，从而降低成本。 BC25 和 BC32 模块可提供 TCP 客户端、UDP 客户端等 Socket 服务。 本文档适用于以下移远通信模块：  BC25  BC32 1.1. TCP/IP AT 命令的使用原理 通过 TCP/IP AT 命令，终端设备可以开启或关闭 Socket，并通过 Socket 收发数据。 1.2. 数据访问模式说明 BC25 和 BC32 模块支持以下 2 种数据访问模式：  Buffer（缓存）模式  Direct Push（直吐）模式 当使用 AT+QIOPEN 开启 Socket 时，可以通过参数 来指定数据访问模式；成功开 启 Socket 后，可以通过 AT+QISWTMD 切换数据访问模式。在两种访问模式下，均可通过 AT+QISEND 或 AT+QISENDEX 命令发送数据。  Buffer 模式下，从网络接收数据时，模块会缓存接收到的数据，并直接上报不包含数据内容的 URC， 之后可以通过 AT+QIRD 命令来读取缓存的数据。此模式下 URC 的格式如下： +QIURC: 'recv',[,] 上海移远通信技术股份有限公司 6 / 36 BC25&BC32 TCP/IP 应用指导  Direct Push 模式下，从网络接收数据时，模块会直接通过 URC 输出接收到的数据。此模式下 URC 的格式如下： +QIURC: 'recv',[,[]] 备注 1. 在 Buffer 模式下，如果缓存不为空，通过 AT+QIRD 读取完缓存中所有接收到的数据后，模块才会上 报新的 URC。 2. 可以通过 AT+QICFG 命令配置是否显示 参数，请参考第 2.1.11 章。 上海移远通信技术股份有限公司 7 / 36 BC25&BC32 TCP/IP 应用指导 2 TCP/IP AT 命令详解 2.1. AT 命令说明 2.1.1. AT+QIOPEN 开启 Socket 此命令用于开启 Socket 来创建连接。可通过参数 指定服务类型。数据访问模式可通 过参数 配置。URC +QIOPEN: , 会显示 Socket 是否成功开启。 AT+QIOPEN 开启 Socket 测试命令 AT+QIOPEN=? 响应： +QIOPEN: (1-3),(0-5),'TCP/UDP/TCP LISTENER/UDP SE RVICE','/', [,[,(0-1)[,(0-1)]]] OK 设置命令 AT+QIOPEN=,,,/,[,[,[,]]] 响应： OK +QIOPEN: , 若有任何错误： ERROR 最大响应时间 300 毫秒 生效机制 立即生效 参数 整型。上下文 ID。范围：1-3。 整型。Socket ID。范围：0-5。 带双引号的字符串型格式。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器端监听 TCP 连接 'UDP SERVICE' 建立 UDP 服务 上海移远通信技术股份有限公司 8 / 36 BC25&BC32 TCP/IP 应用指导 带双引号的字符串型格式。远程服务器的 IP 地址，例如：'220.18.23.22'。 带双引号的字符串型格式。远程服务器的域名地址。 远程服务器端口。仅有当 是 'TCP' 或者 'UDP' 时有效。范围： 1-65535。 本地端口号。 如果 的值是 'TCP LISTENER' 或者 'UDP SERVICE' ，此参 数必须指定，不可省略。范围：1-65535。 如果 的值是 'TCP' 或者 'UDP'， 可省略，缺省 值为 0，将会自动分配本地端口，否则需要指定 。范围：0-65535。 整型。Socket 的数据访问模式。 0 Buffer 模式 1 Direct Push 模式 整型。协议类型。 0 IPv4 1 IPv6 备注 1. 若使用 创建连接，URC +QIOPEN: , 上报的最大等待时间为 176 秒；若使用 创建连接，URC 上报的最大等待时间为 36 秒。 2. 参数的 'UDP SERVICE' 暂不支持。 3. 当模块从深度睡眠状态唤醒，TCP 连接需通过命令 AT+QIOPEN 重新开启 Socket；UDP 连接支持深 度睡眠唤醒功能，能够恢复至进入深度睡眠前的状态，不需要重新开启 Socket 并可以直接收发数据， 此时使用相同 开启 Socket 会报错。 4. 若省略参数 、 或 ，则使用默认值。 5. 客户端模式下， 建议使用默认值 0，使模块自动分配本地端口。若需要配置，建议避免 使用 1000-1500 范围内的端口。另外，指定的本地端口不可以重复。 2.1.2. AT+QICLOSE 关闭 Socket 此命令用于关闭指定的 Socket。 AT+QICLOSE 关闭 Socket 测试命令 AT+QICLOSE=? 响应 +QICLOSE: (0-5) 设置命令 AT+QICLOSE= OK 响应 若关闭成功： OK CLOSE OK 上海移远通信技术股份有限公司 9 / 36 BC25&BC32 TCP/IP 应用指导 最大响应时间 生效机制 若有任何错误： ERROR 300 毫秒 立即生效 参数 整型。Socket ID。范围：0-5。 2.1.3. AT+QISTATE 查询 Socket 状态 此命令用于查询 Socket 状态。 AT+QISTATE 查询 Socket 状态 测试命令 AT+QISTATE=? 查询命令 AT+QISTATE? 响应 OK 响应 返回当前存在的所有连接状态： [+QISTATE: ,,,,,,,] […] OK 若有任何错误： ERROR 设置命令 若 为 0，查询指定上下文 下的连接状态 AT+QISTATE=, 响应 [+QISTATE: ,,,,,,,] […] OK 若有任何错误： ERROR 设置命令 响应 若 为 1，查询指定 Socket [+QISTATE: ,,<IP_addres 上海移远通信技术股份有限公司 10 / 36 BC25&BC32 TCP/IP 应用指导 的连接状态 AT+QISTATE=, s>,,,,,] OK 最大响应时间 生效机制 若有任何错误： ERROR 300 毫秒 立即生效 参数 整型。查询类型。 0 查询指定的 的连接状态 1 查询指定的 的连接状态 整型。上下文 ID。范围：1-3。 整型。Socket ID。范围：0-5。 带双引号的字符串型格式。Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP LISTENER' 建立 TCP 服务器端监听 TCP 连接 'TCP INCOMING' 建立 TCP 服务器端接受的 TCP 连接 'UDP SERVICE' 建立 UDP 服务 带双引号的字符串型格式。远程客户端的 IP 地址。 若 为 'TCP' 或 'UDP'，则指远程服务器 IP 地址 若 为 'TCP LISTENER' 或 'UDP SERVICE'，则指本地 IP 地址 若 为 'TCP INCOMING'，则指远程客户端 IP 地址 整型。远程端口号 若 为 'TCP' 或 'UDP'，则指远程服务器端口 若 为 'TCP LISTENER' 或 'UDP SERVICE'，则端口无效，值始终 为0 若 为 'TCP INCOMING'，则指远程客户端端口 整型。分配的本地端口号。 若 为 0，自动分配本地端口 整型。Socket 状态。 0 'idle'（空闲） 1 'connecting'（正在连接） 2 'connected'（已连接） 3 'closing'（正在关闭） 4 'remote closing'（正在远程关闭） 5 'closed'（已关闭） 数据访问模式 上海移远通信技术股份有限公司 11 / 36 0 Buffer 模式 1 Direct Push 模式 BC25&BC32 TCP/IP 应用指导 2.1.4. AT+QISEND 发送文本字符串数据 此命令用于通过指定连接发送文本字符串格式的 Socket 数据。 AT+QISEND 发送文本字符串数据 测试命令 AT+QISEND=? 响应 +QISEND: (0-5),(1-512),'' OK 设置命令 响应 非数据模式下发送定长数据 AT+QISEND=,, 若数据发送成功： OK SEND OK 数据发送失败： OK SEND FAIL 若有任何错误： ERROR 设置命令 数据模式下发送不定长数据 AT+QISEND= 响应 > 后，输入需要发送的 ， 按 Ctrl+Z 发送数据，按 Esc 取消发送 响应 > OK 若连接已建立，且发送成功： SEND OK 若连接已建立，但是发送缓存已满或发送失败： SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 设置命令 响应 数据模式下发送定长数据 > AT+QISEND=, OK 响应 > 后，输入需要发送的 ， 长度达到 后， SEND OK 上海移远通信技术股份有限公司 12 / 36 将会发送数据 最大响应时间 生效机制 BC25&BC32 TCP/IP 应用指导 若连接已建立，但是发送缓存已满： OK SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 300 毫秒 立即生效 参数 整型。Socket ID，范围：0-5。 整型。发送数据 的字节长度。最大长度为 512 字节。 文本或者十六进制字符串格式 1)。待发送的数据。 非数据模式下，发送定长数据（AT+QISEND=,,）， 的内容需要用双引号标识，例如 'data'。 数据模式下， 的内容无需用双引号标识。 备注 1. 1) 此命令目前暂不支持发送十六进制格式数据。 2. SEND OK 的返回，仅表示数据已经发送至协议栈。 3. 只有在 Socket 的 是 'TCP'、'UDP' 或 'TCP INCOMING' 时， 才能成功 发送；如果是 'TCP LISTENER' 或 'UDP SERVICE'，则会返回 ERROR。 可通 过命令 AT+QISTATE 查询。 4. 数据模式下返回 > 后，若发送的数据为空，按 Ctrl+Z 后会立即返回 SEND FAIL。 2.1.5. AT+QIRD 读取收到的 TCP/IP 数据 此命令用于读取从指定连接接收的 Socket 数据。 在 Buffer 数据访问模式下，收到数据后，模块会缓存数据，并向 MCU 上报 URC： +QIURC: 'recv',[,]。 AT+QIRD 读取收到的 TCP/IP 数据 测试命令 AT+QIRD=? 响应 +QIRD: (0-5),(1-512) OK 上海移远通信技术股份有限公司 13 / 36 BC25&BC32 TCP/IP 应用指导 设置命令 当 为 'TCP'、'UDP' 或 'TCP INCOMING' 时 AT+QIRD=, 响应 若指定连接收到数据： +QIRD: [,] OK 若无数据： +QIRD: 0 OK 最大响应时间 生效机制 若有任何错误： ERROR 300 毫秒 立即生效 参数 整型。Socket ID。范围：0-5。 整型。读取数据的最大长度。范围：1-512。单位：字节。 整型。接收数据的实际长度。单位：字节。 上一次接收数据的剩余长度。单位：字节。 读取的数据。 备注 1. 若接收缓存中仍有数据，此时模块接收到新数据不会上报新的 URC，只有当缓存中的数据全部被读 取以后，才会上报新的 URC。 2. 若配置 AT+QICFG='showlength',1，会返回此命令的可选长度参数 ，以及下 行数据 URC 的可选长度参数 ，请参考第 2.1.11 章。 3. 剩余长度并不是指缓存中所有接收数据长度，而仅仅指某一节点中保存的当前剩余数据长度。 2.1.6. AT+QISENDEX 发送十六进制字符串数据 此命令用于通过指定连接发送十六进制字符串格式的 Socket 数据。 AT+QISENDEX 发送十六进制字符串数据 测试命令 AT+QISENDEX=? 响应 +QISENDEX: (0-5),(1-512),'' OK 上海移远通信技术股份有限公司 14 / 36 BC25&BC32 TCP/IP 应用指导 设置命令 非数据模式下发送定长数据 AT+QISENDEX=,< send_length>, 响应 若数据发送成功： OK SEND OK 若数据发送失败： OK SEND FAIL 若有任何错误： ERROR 设置命令 数据模式下发送不定长数据 AT+QISENDEX= 响应 > 后，输入需要发送的 ，按 Ctrl+Z 发送数 据，按 Esc 取消发送 响应 > OK 若连接已建立，且发送成功： SEND OK 若连接已建立，但发送缓存已满或者发送失败： SEND FAIL 若连接没有建立、异常断开或者参数不正确： ERROR 设置命令 数据模式下发送定长数据 AT+QISENDEX=,< send_length> 响应 > 后，输入需要发送的 ， 长 度达到 后，将会 发送数据 响应 > 若连接已建立，且发送成功： OK SEND OK 若连接已建立，但发送缓存已满： OK SEND FAIL 最大响应时间 生效机制 若连接没有建立、异常断开或者参数不正确： ERROR 300 毫秒 立即生效 上海移远通信技术股份有限公司 15 / 36 BC25&BC32 TCP/IP 应用指导 参数 整型。Socket ID。范围：0-5。 整型。待发数据长度。最大长度：512 字节。 待发送的十六进制字符串格式数据。 非数据模式下，发送定长数据（AT+QISENDEX=,,）， 的内容需要用双引号标识，例如 '3031323334'。 数据模式下， 的内容无需用双引号标识。 备注 1. SEND OK 的返回，仅表示数据已经发送至协议栈。 2. 只有在 Socket 的 是 'TCP', 'UDP' 或 'TCP INCOMING' 时， 才 能成功发送，如果是 'TCP LISTENER' 或者 'UDP SERVICE' 则会返回 ERROR， 可通过命令 AT+QISTATE 查询。 3. 数据模式下返回 > 后，若发送数据为空，按 Ctrl+Z 后会立即返回 SEND FAIL。 2.1.7. AT+QISWTMD 切换数据访问模式 此命令可以用于在成功开启 Socket 后切换数据访问模式。开启新的 Socket 时，可以通过 AT+QIOPEN 的参数 来设置数据访问模式。 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应 +QISWTMD: (0-5),(0-1) OK 查询命令 AT+QISWTMD? 响应 OK 设置命令 AT+QISWTMD=, 响应 OK 若有任何错误： ERROR 最大响应时间 300 毫秒 生效机制 立即生效；参数设置将保存至 NVM 参数 整型。Socket ID。范围：0-5。 上海移远通信技术股份有限公司 16 / 36 整型。Socket 数据访问模式。 0 Buffer 模式 1 Direct Push 模式 BC25&BC32 TCP/IP 应用指导 2.1.8. AT+QPING 进行远程服务器 Ping 操作 此命令用来检测主机设备 IP 地址是否可达。 AT+QPING 进行远程服务器 Ping 操作 测试命令 AT+QPING=? 响应 +QPING: (1-3),''[,(1-255)[,(1-10)[,(32-200)]]] OK 设置命令 AT+QPING=,[,[,[,]]] 响应 若远程服务器 Ping 成功： OK +QPING: [,,,,] […] +QPING: [,,,,,,] 最大响应时间 生效机制 若有任何错误： ERROR 300 毫秒 立即生效 参数 整型。上下文 ID。范围：1-3。 带双引号的字符串型。Host 服务器地址。格式为域名或者点分十进制 IP 地址。 整型。每次 Ping 请求后等待响应的最大时长。范围：1-255。单位：秒。默认值为 4。 整型。发送 Ping 请求的最大次数。范围：1-10。默认值为 4。 整型。每个 Ping 请求的大小。范围：32-200。单位：字节。默认值为 32。 整型。每次 Ping 请求的结果 0 接收到远程服务器的响应，会返回 ,,, 1 Ping 超时 其他 请参考第 3 章，获取错误码信息 字符串型。远程服务器的 IP 地址。格式为点分十进制。 整型。每次发送 Ping 请求的长度。单位：字节。 上海移远通信技术股份有限公司 17 / 36 BC25&BC32 TCP/IP 应用指导 整型。发送 Ping 请求花费的时间。单位：毫秒。 整型。Ping 请求的 TTL 值。 整型。Ping 操作的最终结果 2 Ping 成功 其他 请参考第 3 章，获取错误码信息 整型。Ping 请求发送的全部字节长度。 整型。Ping 响应中接收到的全部字节长度。 整型。表示所有 Ping 请求中丢失的字节总长度。 整型。最小响应时间。单位：毫秒。 整型。最大响应时间。单位：毫秒。 整型。平均响应时间。单位：毫秒。 备注 若省略参数 、 和 ，则使用默认值。 2.1.9. AT+QNTP 通过 NTP 服务器同步本地时间 此命令通过 NTP 服务器同步本地时间为世界标准时间（UTC）。相关 错误码信息，请参考第 3 章。 AT+QNTP 通过 NTP 服务器同步本地时间 测试命令 AT+QNTP=? 响应 +QNTP: (1-3),''[,[,(0,1)]] 设置命令 AT+QNTP=,[,[,]] OK 响应 若同步成功： OK +QNTP: , 最大响应时间 生效机制 若有任何错误： ERROR 300 毫秒 立即生效 参数 整型。上下文 ID。范围：1-3。 带双引号的字符串型格式。NTP 服务器地址。格式为域名或者点分十进制 IP 地址。 上海移远通信技术股份有限公司 18 / 36 BC25&BC32 TCP/IP 应用指导 整型。NTP 服务器端口号。默认值：123。 整型。表示是否自动同步本地时间到 UTC。 0 不同步 1 同步 带双引号的字符串型格式。从 NTP 服务器上同步的时间。 格式为：'YY/MM/DD,hh:mm:ss±zz'，各字符分别表示年（YY）、月（MM）、日（DD）、 时（hh）、分（mm）、秒（ss）、时区（±zz）。±zz 的范围是-48~56。 备注 1. 当设置 为 1，RTC 会自动更新到同步时间。 2. 若省略参数 和 ，则使用默认值。 2.1.10. AT+QIDNSGIP 通过域名获取 IP 地址 此命令用于将指定域名转换为 IP 地址格式。 错误码信息，请参考第 3 章。 AT+QIDNSGIP 通过域名获取 IP 地址 测试命令 AT+QIDNSGIP=? 响应 +QIDNSGIP: (1-3),'' 设置命令 AT+QIDNSGIP=, OK 响应 OK +QIURC: 'dnsgip',,, [+QIURC: 'dnsgip',] […] 最大响应时间 生效机制 若有任何错误： ERROR 300 毫秒 立即生效 参数 整型。上下文 ID。范围：1-3。 带双引号的字符串型格式。域名。 整型。参数 对应的 IP 地址个数。 整型。DNS 的 TTL 值。 字符串型。 的 IP 地址。 上海移远通信技术股份有限公司 19 / 36 BC25&BC32 TCP/IP 应用指导 2.1.11. AT+QICFG 配置可选参数 此命令可为 TCP/IP 各项功能配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应 +QICFG: 'dataformat',(0,1),(0,1) +QICFG: 'viewmode',(0,1) +QICFG: 'showlength',(0,1) 设置命令 设置发送/接收数据格式 AT+QICFG='dataformat'[,,] OK 响应 +QICFG: 'dataformat',, OK 设置命令 设置接收数据的输出格式 AT+QICFG='viewmode'[,] 若有任何错误： ERROR 响应 +QICFG: 'viewmode', OK 设置命令 设置 Buffer 数据访问模式是否显示可选 长度参数 AT+QICFG='showlength'[,] 若有任何错误： ERROR 响应 +QICFG: 'showlength', OK 若有任何错误： ERROR 最大响应时间 300 毫秒 生效机制 立即生效；参数设置将保存至 NVM 参数 整型。命令发送数据的格式。 0 文本格式 1 十六进制格式 整型。接收数据的格式。 上海移远通信技术股份有限公司 20 / 36 BC25&BC32 TCP/IP 应用指导 0 文本格式 1 十六进制格式 整型。表示已接收数据的输出格式。 0 已收数据输出格式：data headerrndata 1 已收数据输出格式：data header,data 整型。是否显示可选长度参数。 0 不显示 1 显示 备注 1. 目前参数 只能配置为文本格式，需要发送十六进制数据时，可通过命令 AT+QISENDEX 进行十六进制格式的数据的发送。 2. 参数 的设置的可选长度参数包括以下参数：  下行数据 URC 中的参数  命令 AT+QIRD 返回值中的参数 3. 若省略 、、 和 ， 则使用参数默认值。 2.1.12. AT+QIGETERROR 查询上一个错误码 此命令用来查询参数 错误码，以及上一个 TCP/IP 命令返回的 错误码的描述。 AT+QIGETERROR 查询上一个错误码 测试命令 AT+QIGETERROR=? 执行命令 AT+QIGETERROR 响应 OK 响应 +QIGETERROR: , OK 最大响应时间 生效机制 若有任何错误： ERROR 300 毫秒 立即生效 参数 字符串型。表示详细的错误信息描述。相关 错误码信息以及对应的 描述，请参考第 3 章。 上海移远通信技术股份有限公司 21 / 36 BC25&BC32 TCP/IP 应用指导 2.1.13. AT+QIKALIVE 配置 TCP Socket Keepalive 功能 此命令用于配置是否使能 TCP Socket Keepalive 功能及各项参数。 AT+QIKALIVE 配置 TCP Socket Keepalive 功能 测试命令 AT+QIKALIVE=? 响应 +QIKALIVE: [,[,[,,[' ']]]] 查询命令 AT+QIKALIVE? OK 响应 +QIKALIVE: ,,, OK 设置命令 AT+QIKALIVE=[, [,[,,[]]]] 若有任何错误： ERROR 响应 OK 若有任何错误： ERROR 最大响应时间 300 毫秒 生效机制 立即生效 参数 整型。是否使能 Keepalive 功能状态。 0 关闭 1 开启 整型。两个 Keepalive 消息之间的间隔时长。范围：1-36000。单位：秒。 默认值：60。 整 型 。 当 使 能 Keepalive 功 能 ， 发 送 Keepalive 消 息 后 ， 若 模 块 在 时间内未接收到来自 Socket 服务的 ACK 消 息，模块会重发 Keepalive 消息。范围：10-20。单位：秒。默认值：10。 整型。模块未能收到 ACK 消息后可重发 Keepalive 包的总次数。默认值：9。 带双引号的十六进制型。Keepalive 包中携带的数据。最大长度：256。 上海移远通信技术股份有限公司 22 / 36 BC25&BC32 TCP/IP 应用指导 备注 1. 目前不支持参数。 2. 若省略参数和，则使用默认值。 3. 开启 TCP Socket Keepalive 功能后，模块可能会进不了深度睡眠状态。 2.1.14. AT+QIDNSCFG 配置 DNS 服务器功能 此命令用来配置 DNS 服务器功能和各项参数。 AT+QIDNSCFG 配置 DNS 服务器功能 测试命令 AT+QIDNSCFG=? 响应 +QIDNSCFG: [,] 查询命令 AT+QIDNSCFG? OK 响应 +QIDNSCFG: , OK 设置命令 AT+QIDNSCFG=[,] 最大响应时间 若有任何错误： ERROR 响应 OK 若有任何错误： ERROR 300 毫秒 生效机制 立即生效 参数 带双引号的字符串型格式。主要 DNS 服务器 IP 地址。例如：'220.18.23.22'。 带双引号的字符串型格式。备用 DNS 服务器 IP 地址。例如：'220.18.23.22'。 备注 模块成功注网后方可配置 DNS 服务器。 上海移远通信技术股份有限公司 23 / 36 BC25&BC32 TCP/IP 应用指导 2.2. URC 说明 TCP/IP AT 命令的 URC 统一以 +QIURC: […] 格式上报通知 MCU，为 简便，本文中 URC 命令说明前后的 均被省略。 2.2.1. 连接断开 URC 当 TCP Socket 服 务 被 远 程 关 闭 或 者 因 为 网 络 异 常 而 断 开 ， 模 块 将 上 报 URC ： +QIURC: 'closed',，同时参数 （表示 Socket 服务的状态）变为 'closing'，模块必 须执行命令 AT+QICLOSE= 把 改为初始状态 0。 在 Buffer 模式下，模块也可以执行命令 AT+QIRD=, 来读取缓存数据。 连接断开 URC +QIURC: 'closed', 表示 Socket 服务连接被断开。 参数 整型。Socket ID。范围：0-5。 2.2.2. 下行数据 URC 在 Buffer 模式或者 Direct Push 模式下，当模块从服务器上接收到数据时会上报 URC。  在 Buffer 模式下，URC 的格式为+QIURC: 'recv',[,]  在 Direct Push 模式下，URC 格式为+QIURC: 'recv',[,[< CR>]] 下行数据 URC +QIURC: 'recv',[,] +QIURC: 'recv',[,[]] 表示 Buffer 模式下有下行数据。 表示 Direct Push 模式下有下行数据。 参数 整型。Socket ID。范围：0-5。 整型。实际接收数据的长度。 接收到的数据 上海移远通信技术股份有限公司 24 / 36 BC25&BC32 TCP/IP 应用指导 2.2.3. 下行数据缓存已满 URC 在 Buffer 模式下，如果已经没有资源可以分配给下行数据进行缓存，模块会上报如下 URC。 下行数据缓存已满 URC +QIURC: 'recv',,'buff full' 表示新数据缓存已满。 参数 整型。Socket ID。范围：0-5。 2.2.4. 下行连接已达上限 URC 当下行连接达到上限，或者已经没有 Socket 系统资源可分配，当有下行连接请求时，模块会上报如下 URC。 下行连接已达上限 URC +QIURC: 'incoming full' 表示下行连接已满。 2.2.5. 下行连接请求 URC 若 为 'TCP LISTENER'，当远程客户端连接到此服务器时，模块会为此新连接自动 分配一个空闲的 并上报 URC， 的范围是 0-5。新连接的 类 型将会是 'TCP INCOMING'，且 为 Buffer 模式。 下行连接请求 URC +QIURC: 'incoming',,<se 当 服务器接受新的连接请求，上报的 URC 中会 rverID>,, 通知 ， 和 。 参数 整型。为新连接分配的 Socket。由模块自动指定。范围：0-5。 接受新连接 请求的服务器，此服务器的 是 'TCP LISTENER'，监听的 Socket ID 是 。 新连接 的远程 IP 地址。 新连接 的远程端口。 上海移远通信技术股份有限公司 25 / 36 BC25&BC32 TCP/IP 应用指导 3 相关错误码 执行 TCP/IP AT 命令后返回的 ，具体的错误信息可以通过 AT+QIGETERROR 命令来查询。 AT+QIGETERROR 只返回上一个 TCP/IP AT 命令的错误码。 表 1：错误码概览 错误码 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 错误码描述 Operation successful Unknown error Operation blocked Invalid parameters Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy DNS parse failed 中文描述 操作成功 未知错误 操作受阻 无效参数 内存不足 创建 Socket 失败 操作不支持 Socket 绑定失败 Socket 监听失败 Socket 写入失败 Socket 读取失败 Socket 接受失败 开启 PDP 上下文失败 关闭 PDP 上下文失败 Socket 标识被占用 DNS 忙 DNS 解析失败 上海移远通信技术股份有限公司 26 / 36 566 Socket connection failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel send 572 Operation not allowed 573 APN not configured 574 Port busy 表 2：Ping 结果概览 错误码 错误码描述 0 PING_ECHO 1 PING_TIMEOUT 2 PING_SUCCESS 3 PING_TCPIP_ERROR 4 PING_ADDRESS_NOT_FOUND 5 PING_PDP_ACT_FAIL BC25&BC32 TCP/IP 应用指导 Socket 连接失败 Socket 已被关闭 操作忙 操作超时 PDP 上下文发生故障 取消发送 操作不允许 APN 未配置 端口忙 中文描述 回显 超时 成功 TCPIP 错误 地址未找到 PDP 激活失败 上海移远通信技术股份有限公司 27 / 36 BC25&BC32 TCP/IP 应用指导 4 举例 4.1. TCP 客户端在 Buffer 模式下工作 4.1.1. 创建一个 TCP 客户端连接并进入 Buffer 模式 //做业务前需确保模块已正常注网并获取到 IP 地址 AT+CGATT? +CGATT: 1 //查询注网状态 //注网成功 OK AT+CGPADDR? +CGPADDR: 1,'100.127.243.105' OK AT+QIOPEN=1,0,'TCP','220.18.39.22',8062,0,0 OK //查询是否已获取 IP 地址 //已获取 IP 地址 //上下文 ID 为 1，Socket ID 为 0。 +QIOPEN: 0,0 AT+QISTATE=1,0 +QISTATE: 0,'TCP','220.18.39.22',8062,0,2,1,0 //连接成功，等待 URC 上报后再进行其他操作 //查询 Socket ID 为 0 的连接状态。 OK 4.1.2. 在 Buffer 模式下发送数据 AT+QISEND=0,10,'1234567890' OK SEND OK AT+QISENDEX=0,5,'3031323334' OK SEND OK AT+QISEND=0,10,'1234567890' OK AT+QISEND=0,10,'1234567890' //发送数据，数据长度是 10 个字节。 //发送十六进制字符串数据。 //发送数据，数据长度是 10 个字节。 //上一条命令尚未返回 SEND OK，所以当发送 上海移远通信技术股份有限公司 28 / 36 ERROR SEND OK BC25&BC32 TCP/IP 应用指导 新数据时会返 ERROR。 4.1.3. 在 Buffer 模式下从远程服务器上接收数据 +QIURC: 'recv',0 AT+QIRD=0,512 +QIRD: 10 1234567890 //=0 接收到数据 URC //读取缓存中的数据，读取最大长度为 512 字节 //实际数据长度为 10 字节 //数据内容为'1234567890' OK AT+QIRD=0,512 +QIRD: 0 //读取缓存数据，读取最大长度为 512 字节 //无缓存数据 OK AT+QICFG='showlength',1 +QICFG: 'showlength',1 //配置显示可选长度参数 OK +QIURC: 'recv',0,12 AT+QIRD=0,10 +QIRD: 10,2 1234567890 //=0 接收到了数据，数据长度为12 字节。 //读取数据，读取长度 10 字节。 //已读取 10 字节长度的数据，还有 2 字节未读取。 OK +QIURC: 'recv',0,'buff full' AT+QICFG='viewmode',1 +QICFG: 'viewemode',1 //=0 上报缓存已满，模块需要使用命令 AT+QIRD 来读取缓存数据。 //已收到数据的输出格式：data header,data OK AT+QISEND=0,12,'012345678901' OK SEND OK +QIURC: 'recv',0,12 AT+QIRD=0,10 +QIRD: 10,2,0123456789 上海移远通信技术股份有限公司 29 / 36 OK 4.1.4. 断开连接 AT+QICLOSE=0 OK CLOSE OK BC25&BC32 TCP/IP 应用指导 //断开 =0 的连接 4.2. TCP 客户端在 Direct Push 模式下工作 4.2.1. 创建一个 TCP 客户端连接并进入 Direct Push 模式 AT+QIOPEN=1,0,'TCP','220.18.39.22',8062,0,1 OK //上下文 ID 为 1，Socket ID 为 0 +QIOPEN: 0,0 AT+QISTATE=1,0 +QISTATE: 0,'TCP','220.18.39.22',8062,0,2,1,1 //连接成功，最大等待 36 秒后有 URC 上报 //查询 Socket ID 为 0 的连接状态 OK 4.2.2. 在 Direct Push 模式下发送数据 AT+QISEND=0,10,'1234567890' OK SEND OK AT+QISENDEX=0,5,'3031323334' OK SEND OK //发送数据，数据长度为 10 字节。 //发送十六进制字符串数据。 4.2.3. 在 Direct Push 模式下接收来自远程服务器的数据 +QIURC: 'recv',0,5 12345 AT+QICFG='viewmode',1 +QICFG: 'viewmode',1 //收到来自远程服务器的数据。 //已收到数据的输出格式：data header,data OK 上海移远通信技术股份有限公司 30 / 36 AT+QISEND=0,12,'012345678901' OK SEND OK +QIURC: 'recv',0,12,012345678901 4.2.4. 断开 TCP 客户端连接 AT+QICLOSE=0 OK CLOSE OK BC25&BC32 TCP/IP 应用指导 //断开 =0 的连接 4.3. TCP 服务器在 Buffer 模式下工作 4.3.1. 启动 TCP 服务器 AT+QIOPEN=1,0,'TCP LISTENER','192.168.2.6',0,2020,0 //上下文 ID 为 1，Socket ID 为 0 OK +QIOPEN: 0,0 //TCP 服务器连接成功 AT+QISTATE? //查询上下文 ID 为 0 的连接状态 +QISTATE: 0,'TCP LISTENER','192.168.2.6',0,2020,2,1,0 OK 4.3.2. 接受 TCP 连接请求 +QIURC: 'incoming',2,0,'192.168.2.2',36566 //接受 TCP 连接， 为 'TCP INCOMING'， 为 2 4.3.3. 从新连接中接收数据 +QIURC: 'recv',0 AT+QIRD=0,512 +QIRD: 4 test OK AT+QIRD=0,512 //从远程新连接中接收到数据 //从远程新连接中读取数据 //实际数据长度是 4 字节 //读取的数据 上海移远通信技术股份有限公司 31 / 36 +QIRD: 0 OK 4.3.4. 关闭 TCP 服务器 AT+QICLOSE=2 OK CLOSE OK AT+QICLOSE=0 OK CLOSE OK //无缓存数据。 BC25&BC32 TCP/IP 应用指导 //关闭新连接，受网络状况影响，最大响应时间为 10 秒 //关闭 TCP 服务器监听 4.4. UDP 客户端模式（支持深度睡眠唤醒） AT+QSCLK=0 OK AT+QIOPEN=1,0,'UDP','220.18.39.22',8084,0,0 OK //做业务前关闭模块深度睡眠功能 //上下文 ID 为 1，Socket ID 为 0 +QIOPEN: 0,0 AT+QISTATE=1,0 +QISTATE: 0,'UDP','220.18.39.22',8084,0,2,1,0 //连接成功 //查询 Socket ID 为 0 的连接状态 OK AT+QSCLK=1 OK //业务完成后，需要时开启深度睡眠功能，等待模块 进入深度睡眠 //模块进入深度睡眠 +QATSLEEP //拉 PSM_EINT 唤醒模块 +QATWAKEUP AT+QSCLK=0 OK //模块从深度睡眠被唤醒 //做业务前关闭模块深度睡眠功能，业务完成后需要 模块深度睡眠时再开启 //模块会恢复 UDP 相关参数及状态，此时模块状态与进入深度睡眠前一致，可以直接发送和接收 UDP 数据 AT+QISEND=0,10,'1234567890' //发送数据，数据长度是 10 个字节 OK 上海移远通信技术股份有限公司 32 / 36 SEND OK AT+QICLOSE=0 OK CLOSE OK BC25&BC32 TCP/IP 应用指导 //断开 =0 的连接 4.5. UDP 服务器模式* 4.5.1. 启动 UDP 服务器 AT+QIOPEN=1,0,'UDP SERVICE','192.168.2.6',0,2020,0 OK //启动 UDP 服务器，上下文 ID 为 1，Socket ID 为 0 +QIOPEN: 0,0 AT+QISTATE? +QISTATE: 0,'UDP SERVICE','192.168.2.6',0,2020,2,1,0 //UDP 服务器启动成功 //查询上下文 ID 为 0 的连接状态 OK 4.5.2. 从远程新连接中接收数据 +QIURC: 'recv',2 AT+QIRD=2,4 +QIRD: 4 AAAA //从远程新连接中接收数据。 //读取 UDP 数据，会输出一整个 UDP 数据包，需要指定读取长度。 //实际数据长度为 4 字节。 OK 4.5.3. 关闭 UDP 服务器 AT+QICLOSE=0 OK CLOSE OK //关闭服务。 上海移远通信技术股份有限公司 33 / 36 BC25&BC32 TCP/IP 应用指导 4.6. 进行远程服务器 Ping 操作 AT+QPING=1,'sh.quectel.com' OK +QPING: 0,220.18.29.21,32,192,255 +QPING: 0,220.18.23.21,32,240,255 +QPING: 0,220.18.23.21,32,241,255 +QPING: 0,220.18.23.21,32,479,255 +QPING: 2,4,4,0,192,479,287 //在上下文 1 中 Ping 域名为 'sh.quectel.com' 的服务器 4.7. 同步本地时间 AT+QNTP=1,'ntp5.aliyun.com' OK //使用域名为 'ntp5.aliyun.com' 的 NTP 服务器同步本地时间 +QNTP: 0, '18/04/20,11:08:20+32' 4.8. 获取上一个错误码 AT+QIOPEN=1,'UDP','220.18.39.22',8063,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552,invalid parameters OK //开启 Socket，缺省 上海移远通信技术股份有限公司 34 / 36 BC25&BC32 TCP/IP 应用指导 5 附录 A 参考文档及术语缩写 表 3：参考文档 编号 文档名称 备注 [1] Quectel_BC25_AT 命令手册_V1.0 BC25 模块 AT 命令说明 [2] Quectel_BC32_AT_Commands_Manual_V1.0 BC32 模块 AT 命令说明 表 4：术语缩写 缩写 英文描述 ACK CR DNS ID IP IPv4 IPv6 LF MCU ME NTP NVM PPP PSM Acknowledgement Carriage Return Domain Name System Identifier Internet Protocol Internet Protocol version 4 Internet Protocol version 6 Line Feed Microcontroller Unit Mobile Equipment Network Time Protocol Non-Volatile Access Memory Point to Point Protocol Power Saving Mode 中文描述 确认 回车符 域名系统 标识符 互联网协议 互联网协议版本 4 互联网协议版本 6 换行符 微控制器 移动设备 网络时间协议 非易失性存储器 点对点协议 省电模式 上海移远通信技术股份有限公司 35 / 36 TCP TTL UDP URC UTC Transmission Control Protocol Time to Live User Datagram Protocol Unsolicited Result Code Universal Time Coordinated BC25&BC32 TCP/IP 应用指导 传输控制协议 生存时间 用户数据报协议 非请求结果码 世界标准时间 上海移远通信技术股份有限公司 36 / 36

BC25&BC32 固件烧录 及 Log 抓取应用指导 NB-IoT 模块系列 版本：BC25&BC32_固件烧录及 Log 抓取应用指导_V1.0 日期：2019-08-24 状态：受控文件 www.quectel.com BC25&BC32 固件烧录及 Log 抓取应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 文档历史 修订记录 版本 1.0 日期 2019-08-24 作者 方亮/ 顾根全/ 宋聪强 变更表述 初始版本 上海移远通信技术股份有限公司 1 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 目录 文档历史 ....................................................................................................................................................... 1 目录 .............................................................................................................................................................. 2 图片索引 ....................................................................................................................................................... 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 软硬件需求 ............................................................................................................................................ 6 2.1 硬件需求 ..................................................................................................................................... 6 2.2 软件需求 ..................................................................................................................................... 6 3 烧录固件的方法 ..................................................................................................................................... 7 3.1. 查看串口 ..................................................................................................................................... 7 3.2. 通过 QFlash 烧录固件 ................................................................................................................ 8 3.2.1. 配置 QFlash 工具 ............................................................................................................ 8 3.2.2. 选择目标固件并烧录........................................................................................................ 9 3.2.2.1. 添加目标固件........................................................................................................ 9 3.2.2.2. 烧录固件 ............................................................................................................. 10 3.3. 通过 CoolWatcher 烧录固件..................................................................................................... 12 3.3.1. 打开 CoolWatcher 工具 ................................................................................................. 12 3.3.2. 配置 CoolWatcher 工具 ................................................................................................. 14 3.3.3. 选择目标固件并烧录...................................................................................................... 16 3.3.3.1. 添加目标固件...................................................................................................... 16 3.3.3.2. 添加 Flash 驱动 .................................................................................................. 18 3.3.3.3. 烧录固件 ............................................................................................................. 20 3.4. 注意事项 ................................................................................................................................... 21 4 抓取 Log 的方法.................................................................................................................................. 22 4.1. 配置模块开启 Log 上报 ............................................................................................................ 22 4.2. CoolWatcher 抓取 Log ............................................................................................................. 23 4.3. ArmTracer 配合 CoolWatcher 抓取 Log ................................................................................... 25 4.3.1. ArmTracer 简单介绍 ...................................................................................................... 25 4.3.2. 配置 ArmTracer 工具 ..................................................................................................... 25 4.3.3. 查看 Log ........................................................................................................................ 27 4.3.3.1. 查看注网测试流程 Log ....................................................................................... 27 4.4. 注意事项 ................................................................................................................................... 27 4.4.1. 模块重启时如何抓取 Log............................................................................................... 27 5 附录 A 参考文档及术语缩写................................................................................................................ 31 上海移远通信技术股份有限公司 2 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 图片索引 图 1：当前设备串口对应编号............................................................................................................................... 7 图 2：QFLASH 工具配置 ..................................................................................................................................... 8 图 3：打开选择目标固件窗口............................................................................................................................... 9 图 4：选择添加目标固件...................................................................................................................................... 9 图 5：QFLASH 开始烧录固件............................................................................................................................ 10 图 6：固件版本烧录成功.....................................................................................................................................11 图 7：打开 COOLWATCHER 工具..................................................................................................................... 12 图 8：COOLWATCHER 配置界面 ..................................................................................................................... 13 图 9：配置 COOLWATCHER 工具..................................................................................................................... 14 图 10：COOLWATCHER 工具成功连接模块 ..................................................................................................... 15 图 11：打开目标固件添加窗口........................................................................................................................... 16 图 12：选择添加目标固件.................................................................................................................................. 17 图 13：选择模块内部 FLASH 的驱动................................................................................................................. 18 图 14：加载内部 FLASH 的驱动 ........................................................................................................................ 19 图 15：烧录固件 ................................................................................................................................................ 20 图 16：进入'SET TRACE LEVELS'窗口 ........................................................................................................... 23 图 17：开启所有 LOG 输出................................................................................................................................ 23 图 18：LOG 接收/清除/保存等操作.................................................................................................................... 24 图 19：LOG 分段保存........................................................................................................................................ 24 图 20：查看解码后的 LOG 信息 ........................................................................................................................ 25 图 21：配置 ARMTRACER 工具........................................................................................................................ 25 图 22：选择 DEBUG 端口.................................................................................................................................. 26 图 23：使用 ARMTRACER 保存 LOG ............................................................................................................... 26 图 24：使用 ARMTRACER 查看 LOG ............................................................................................................... 27 图 25：模块重启，DUMP 信息导出................................................................................................................... 28 图 26：模块重启时 DUMP 信息导出.................................................................................................................. 29 图 27：导出 HEAP REPORT 文件步骤 1 .......................................................................................................... 29 图 28：导出 HEAP REPORT 文件步骤 2 .......................................................................................................... 30 上海移远通信技术股份有限公司 3 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 表格索引 表 1：参考文档 .................................................................................................................................................. 31 表 2：术语缩写 .................................................................................................................................................. 31 上海移远通信技术股份有限公司 4 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 1 引言 本文档主要描述移远通信 BC25 和 BC32 模块通过 QFlash 和 CoolWatcher 工具烧录固件以及应用 CoolWatcher 和 ArmTracer 工具抓取 Log 的方法步骤。 备注 必须先接通模块电源之后才能打开烧录工具连接模块。 上海移远通信技术股份有限公司 5 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 2 软硬件需求 本章节描述了使用固件烧录和 Log 抓取工具的硬件和软件环境要求。 2.1 硬件需求 移远通信 BC25 或 BC32 模块、PC、USB 数据线。 2.2 软件需求 在烧录固件及抓取 Log 之前，需要在 PC 上安装对应的串口驱动。获取 QFlash、CoolWatcher 和 ArmTracer 工具文件，解压后存至 C 盘根目录。 备注 QFlash、CoolWatcher 和 ArmTracer 工具的获取，请联系移远通信技术支持。 上海移远通信技术股份有限公司 6 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3 烧录固件的方法 BC25 和 BC32 模块固件可通过 QFlash 和 CoolWatcher 工具进行烧录，本章节说明如何通过这两个工 具进行模块固件烧录。 3.1. 查看串口 打开设备管理器，查看当前的设备 debug 口编号，以便在对应工具串口中设置对应的串口编号，如下 图所示。 图 1：当前设备串口对应编号 上海移远通信技术股份有限公司 7 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3.2. 通过 QFlash 烧录固件 3.2.1. 配置 QFlash 工具 打开 QFlash 工具后在'COM Port'下拉菜单中选择 debug 口对应的编号，波特率选择'921600'， 如下图所示。 图 2：QFlash 工具配置 上海移远通信技术股份有限公司 8 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3.2.2. 选择目标固件并烧录 3.2.2.1. 添加目标固件 点击'Load FW Files'按钮，弹出选择窗口，选择需要烧录的.lod 固件文件后，点击'打开'，完成 目标固件的选择，如下图所示。 图 3：打开选择目标固件窗口 上海移远通信技术股份有限公司 图 4：选择添加目标固件 9 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3.2.2.2. 烧录固件 完成目标固件添加后，点击'Start'按钮，开始固件烧录，如下图所示。 图 5：QFlash 开始烧录固件 上海移远通信技术股份有限公司 10 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 图 6：固件版本烧录成功 当 QFlash 界面显示'PASS'后，固件烧录成功，如上图所示。此时可重启模块，再执行 ATI 命令查 询版本号是否为烧录的目标固件版本。 备注 QFlash 工具使用说明，请参考 Quectel_QFlash_User_Guide。 上海移远通信技术股份有限公司 11 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3.3. 通过 CoolWatcher 烧录固件 3.3.1. 打开 CoolWatcher 工具 将 cooltools.zip 工具压缩包拷贝至 C 盘根目录，解压到当前文件夹。CoolWatcher 工具无需另外安装 程序，解压后，打开 coolhost 文件夹，双击 coolwatcher.exe 可执行文件，即可打开 CoolWatcher，如下图 所示。 图 7：打开 CoolWatcher 工具 上海移远通信技术股份有限公司 12 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 打开 CoolWatcher 工具后，即进入配置界面，如下图所示。 图 8：CoolWatcher 配置界面 上海移远通信技术股份有限公司 13 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3.3.2. 配置 CoolWatcher 工具 在配置界面'Profiles'配置栏中选中 8909（步骤 1），在'Key'配置栏中配置'lastcomport'， 把对应值的串口编号改为模块接入电脑后分配的 debug 串口对应的编号（步骤 2），其他的设置保持默认， 最后确认配置无误后点击'Ok'（步骤 3），如下图所示。 图 9：配置 CoolWatcher 工具 上海移远通信技术股份有限公司 14 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 点击'Ok'后，出现下图所示信息，即表示烧录工具已成功连接模块。 图 10：CoolWatcher 工具成功连接模块 上海移远通信技术股份有限公司 15 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3.3.3. 选择目标固件并烧录 3.3.3.1. 添加目标固件 工具配置完成后，点击下图红框标识的图标，进行目标固件的选择。 图 11：打开目标固件添加窗口 上海移远通信技术股份有限公司 16 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 在弹出的固件选择窗口选择.lod 扩展名的目标固件后，点击'打开'，即完成固件包的添加，如下图所 示。 图 12：选择添加目标固件 上海移远通信技术股份有限公司 17 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3.3.3.2. 添加 Flash 驱动 目标固件添加完成后，点击下图中红框标识的图标，选择模块内部 Flash 的驱动。 图 13：选择模块内部 Flash 的驱动 上海移远通信技术股份有限公司 18 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 在弹出的选择窗口中选中对应的 Flash 烧录驱动，点击'打开'，即完成模块内部 Flash 驱动的添加。 BC25 模块的 Flash 驱动请选择 host_8909u02_flsh_spi32m_ramrun.lod，如下图所示。 图 14：加载内部 Flash 的驱动 上海移远通信技术股份有限公司 19 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 BC32 模块的 Flash 驱动请选择 host_8909u02_flsh_spi64m_ramrun.lod，如下图所示。 3.3.3.3. 烧录固件 建议在开始烧录前先点击菜单栏绿色 reset 按钮，等模块重启后，再点击下图的烧写按钮，出现烧录 进度条，即表示烧录工具正在对模块固件进行烧录： 图 15：烧录固件 当右下角的烧录进度条显示为'100%'后，模块会自动复位重启，至此固件烧录完成。 上海移远通信技术股份有限公司 20 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3.4. 注意事项 若遇到固件烧录失败问题，可从如下方面进行问题排查： (1) 确认选择的是否为 debug 口：  BC32 模块会出现四个串口，按数字序号顺序由小到大，第一个串口为主 AT 口，第二个为 debug 口。  BC25 模块会出现两个串口，其中 Ch A 为主 AT 口，Ch B 为 debug 口。 (2) debug 口波特率为 921600bps，确认工具波特率选择是否正确。 (3) 如果设备需飞线引出口，需确认选择的串口转换芯片是否支持波特率 921600bps。 (4) 固件路径不可包含中文，路径层次不宜过多。 (5) 深度睡眠情况下模块无法下载固件，建议下载前先重启模块，或者先配置 AT+QSCLK=0 关闭深度睡 眠。 (6) 如果选择 CoolWatcher 工具可以通过查看 Log 是否正常输出以确认模块连接是否正常。 上海移远通信技术股份有限公司 21 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 4 抓取 Log 的方法 本章节主要介绍如何使用 CoolWatcher 以及 ArmTracer 配合 CoolWatcher 抓取 Log。CoolWatcher 单 独抓取的是原始 Log，需要借助解码软件才能查看信令里的详细配置信息，ArmTracer 抓取的 Log 则是已 经解码的，点击信令即可查看配置信息。 4.1. 配置模块开启 Log 上报 默认情况下，模块只会上报一些 Event 信息，不上报具体的 Log 信息，因此抓取 Log 前首先需要手动 开启 Log 上报，具体 AT 命令的操作如下： AT^TRACECTRL=0 AT^TRACECTRL=1 //关闭 Log //开启 Log 备注 以上配置在模块重启后仍然有效。 上海移远通信技术股份有限公司 22 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 4.2. CoolWatcher 抓取 Log 1. 点击菜单'Plugins''Activate Tracer'打开'Set Trace Levels'窗口。 图 16：进入'Set Trace Levels'窗口 2. 按照下图所示步骤选择 filter，选择'All'打开所有 Log 输出。 图 17：开启所有 Log 输出 上海移远通信技术股份有限公司 23 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3. 点击开始按钮，开始接收 Log。 如果需要进行清除或保存 Log，过滤关键字等操作，请参考下图。 图 18：Log 接收/清除/保存等操作 4. 根据 CoolWatcher 配置的文件大小上限，Log 会自动分割成多段，并保存在工具根目录下的 logs 文件夹中。 上海移远通信技术股份有限公司 图 19：Log 分段保存 24 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 4.3. ArmTracer 配合 CoolWatcher 抓取 Log 4.3.1. ArmTracer 简单介绍 ArmTracer 需要与 CoolWatcher 同时使用，才可抓取 Log。与 CoolWatcher 单独抓取的 Log 不同， ArmTracer 抓取的 Log 已经完成解码，点击信令即可查看配置信息。 图 20：查看解码后的 Log 信息 4.3.2. 配置 ArmTracer 工具 1. ArmTracer 需配合 CoolWacther 一同使用以抓取 Log，打开 CoolWacther 配置完成后，保持 CoolWatcher 开启状态，再打开 ArmTracer 工具，设置选取'CoolHost'，如下图所示。 图 21：配置 ArmTracer 工具 上海移远通信技术股份有限公司 25 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 2. 打开 CoolHost 参数设置窗口，同 CoolWatcher 的相同，选择设置'CoolHost Port'为对应 debug 口编号，如下图所示。 图 22：选择 debug 端口 3. 点击抓取按钮，打开 Log 文件参数设置窗口，可以选择 Log 保存路径以及自定义 Log 文件名。完 成设置之后点击'确定'即可开始抓取 Log。Log 会被保存在选定的目录下面，以提供相应 Log 进 行分析。 图 23：使用 ArmTracer 保存 Log 上海移远通信技术股份有限公司 26 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 4.3.3. 查看 Log 4.3.3.1. 查看注网测试流程 Log ArmTracer 主要用于查看层三信令的 Log，第一第二条就是系统消息（MIB 和 SIB），之后可以查看的 是整个注网流程的 Log，以及数据收发等消息。 图 24：使用 ArmTracer 查看 Log 4.4. 注意事项 4.4.1. 模块重启时如何抓取 Log 如果遇到模块重启，可通过如下步骤进行操作抓取 Log： 1. 执行以下命令，以便进行调试。 AT^FORCENOWDT=1 备注 该配置在模块重启后失效。 上海移远通信技术股份有限公司 27 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 2. 当工具显示如下信息时，表示出现重启。此时在 QCOM 工具中'Command'处输入 elfdump 'xxx.elf'可以导出 Dump 信息。'Command'右侧会出现几次进度条显示，等待所有进度条完 成。 图 25：模块重启，Dump 信息导出 备注 elfdump 'xxx.elf'命令中，xxx 是可自定义的文件名，例如上图的 elfdump 'BC25B5A03.elf'。 上海移远通信技术股份有限公司 28 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 3. 出现下图表示 Dump 导出完成。文件将被保存在 CoolWacther 根目录下，可以将该目录下文件按 照时间排序，拷贝所有最新的文件另存至其他文件夹以便之后的分析。 图 26：模块重启时 Dump 信息导出 4. 继以上步骤，需同步导出 Heap Report 文件，用于辅助分析问题，具体导出步骤如下图所示。 图 27：导出 Heap Report 文件步骤 1 上海移远通信技术股份有限公司 29 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 图 28：导出 Heap Report 文件步骤 2 上海移远通信技术股份有限公司 30 / 31 BC25&BC32 固件烧录及 Log 抓取应用指导 5 附录 A 参考文档及术语缩写 表 1：参考文档 序号 文档名称 [1] Quectel_QFlash_User_Guide 备注 QFlash 工具用户指导 表 2：术语缩写 术语 MIB PC SIB USB 描述 Management Information Base Personal Computer Service Implementation Bean Universal Serial Bus 上海移远通信技术股份有限公司 31 / 31

BC25 系列 中国电信物联网平台应用指导 NB-IoT 模块系列 版本：1.2 日期：2020-03-31 状态：受控文件 BC25 系列中国电信物联网平台应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 保密义务 除非上海移远通信技术股份有限公司特别授权，否则我司所提供文档和信息的接收方须对接收的文档和信 息保密，不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司 书面同意，不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权 使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，上海移远通信技术股份有限公司有权追 究法律责任。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2021，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2021. 上海移远通信技术股份有限公司 1 / 34 BC25 系列中国电信物联网平台应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 日期 2019-10-11 2019-10-11 作者 Albert ZHANG/ Koala LI Albert ZHANG/ Koala LI Albert ZHANG/ 2020-11-13 Koala LI 2021-03-31 Albert ZHANG 变更表述 文档创建 受控版本 1. 新 增 URC +QLWEVTIND: 1 ， 用 于 标 识 AT+NCDPOPEN 连接超时或被拒的场景； 2. 修 改 AT+NMSTATUS 查 询 的 状 态 TIMEOUT_AND_RETYRING 为 TIMEOUT； 3. 增加 AT+NCDPOPEN 命令中参数最大支持 256 字节的长度限制； 4. 增加对接中国电信 IoT 和 AEP 平台的应用指导。 1. 新增第 2.2.8 章 AT+QLWULDATASTATUS 命令，用于 查询 CON 消息发送状态； 2. 新增第 2.2.9 章 AT+NQMGR 命令，用于查询已接收消 息状态； 3. 修改第 2.2.6 章备注中对配置模块 Lifetime 的描述； 4. URC +NNMI[: ,]中增加对模块单次可接 收的最大数据包长度的备注介绍； 5. 优化第 4.1.2 章对接中国电信 IoT 平台的 AT 命令示例； 6. 优化第 4.2.2 章对接中国电信 AEP 平台的 AT 命令示例。 上海移远通信技术股份有限公司 2 / 34 BC25 系列中国电信物联网平台应用指导 目录 文档历史 ..................................................................................................................................................... 2 目录 ............................................................................................................................................................ 3 表格索引 ..................................................................................................................................................... 5 图片索引 ..................................................................................................................................................... 6 1 引言 ..................................................................................................................................................... 7 2 平台相关的 AT 命令 ............................................................................................................................ 8 2.1. AT 命令说明.............................................................................................................................. 8 2.1.1. 定义 ............................................................................................................................... 8 2.1.2. AT 命令语句 ................................................................................................................... 8 2.2. AT 示例声明.............................................................................................................................. 9 2.3. AT 命令详解.............................................................................................................................. 9 2.3.1. AT+NCDPOPEN 发起连接 .......................................................................................... 9 2.3.2. AT+NCDPCLOSE 断开连接 ...................................................................................... 10 2.3.3. AT+NMGS 发送数据.................................................................................................. 10 2.3.4. AT+NMGR 读取缓存数据 ...........................................................................................11 2.3.5. AT+NNMI 配置数据接收模式 ..................................................................................... 12 2.3.6. AT+NCFG 配置命令 .................................................................................................. 13 2.3.7. AT+NMSTATUS 查询注册状态 .................................................................................. 15 2.3.8. AT+QLWULDATASTATUS 查询 CON 消息发送状态 ................................................. 15 2.3.9. AT+NQMGR 查询已接收消息状态 ............................................................................. 16 3 平台相关的 URC ............................................................................................................................... 18 3.1. +QLWEVTIND: 模块动作执行结果 ........................................................................... 18 3.2. +NNMI[: ,] 接收到新数据 ............................................................................. 19 3.3. +NNMI: OC'recv',buff full 缓存区已满.................................................................................. 20 3.4. +QIND: 'FOTA','DOWNLOAD START' 开始下载固件......................................................... 20 3.5. +QIND: 'FOTA','DOWNLOADING', 固件下载状态 ................................................. 20 3.6. +QIND: 'FOTA','DOWNLOAD', 固件下载结果 ....................................................... 20 3.7. +QIND: 'FOTA','START' 模块开始升级固件 ....................................................................... 21 3.8. +QIND: 'FOTA','UPDATING', 模块固件升级进度................................................ 21 3.9. +QIND: 'FOTA','END', 模块固件升级结果 .......................................................... 21 4 举例 ................................................................................................................................................... 22 4.1. 对接电信 IoT 平台 ................................................................................................................... 22 4.1.1. 平台侧配置................................................................................................................... 22 4.1.1.1. 创建设备............................................................................................................ 22 4.1.1.2. 在线调试............................................................................................................ 25 4.1.2. 模块侧对接电信 IoT 平台 AT 命令示例 ......................................................................... 25 4.2. 对接电信 AEP 平台 ................................................................................................................. 27 4.2.1. 平台侧配置................................................................................................................... 27 4.2.1.1. 产品创建............................................................................................................ 27 上海移远通信技术股份有限公司 3 / 34 BC25 系列中国电信物联网平台应用指导 4.2.1.2. 设备添加............................................................................................................ 29 4.2.1.3. 设备激活后对象操作.......................................................................................... 29 4.2.2. 模块侧对接电信 AEP 平台 AT 命令示例 ....................................................................... 30 5 错误码概览 ........................................................................................................................................ 32 6 附录 A 参考文档及术语缩写 .............................................................................................................. 33 上海移远通信技术股份有限公司 4 / 34 BC25 系列中国电信物联网平台应用指导 表格索引 表 1：AT 命令及响应类型 .......................................................................................................................... 8 表 2：平台相关 URC ............................................................................................................................... 18 表 3：常见错误码（27.007） .................................................................................................................. 32 表 4：参考文档........................................................................................................................................ 33 表 5：术语缩写........................................................................................................................................ 33 上海移远通信技术股份有限公司 5 / 34 BC25 系列中国电信物联网平台应用指导 图片索引 图 1：新建产品........................................................................................................................................ 22 图 2：自定义产品 .................................................................................................................................... 23 图 3：填写创建产品的信息 ...................................................................................................................... 23 图 4：定义 Profile .................................................................................................................................... 24 图 5：开发编码器插件 ............................................................................................................................. 24 图 6：选择在线调测................................................................................................................................. 25 图 7：模拟设备接入平台.......................................................................................................................... 25 图 8：中国电信物联网开放平台首页........................................................................................................ 27 图 9：产品中心 - 创建产品..................................................................................................................... 28 图 10：创建产品 - 编辑产品配置............................................................................................................ 28 图 11：添加设备 ...................................................................................................................................... 29 图 12：查看对象（Object） .................................................................................................................... 29 图 13：查看数据（Object） .................................................................................................................... 30 图 14：查看 Object 日志.......................................................................................................................... 30 上海移远通信技术股份有限公司 6 / 34 BC25 系列中国电信物联网平台应用指导 1 引言 LwM2M 是一种安全、高效且可部署的客户端-服务器协议，用于管理各种网络环境下资源受限的终端 设备。LwM2M 使用基于 REST 的现代架构设计，并基于一套高效安全的数据传输标准 CoAP 重新构建而 来，定义了可扩展的资源和数据模型。基于 CoAP 协议（RFC 7252），LwM2M 提供了轻量、紧凑且安全 的通信接口以及高效的数据模型，从而实现 M2M 设备的管理和服务使能。 本文档主要介绍如何将应用了移远通信 BC25 模块的设备连接到中国电信物联网平台（以下简称'平 台'），并通过 LwM2M 协议实现相关功能。 备注 本文档中所述的中国电信物联网平台，包含'中国电信物联网开放平台-连接管理子系统'（以下简称'电 信 IoT 平台'）和'CTWing 中国电信物联网开放平台'（以下简称'电信 AEP 平台'） 上海移远通信技术股份有限公司 7 / 34 BC25 系列中国电信物联网平台应用指导 2 平台相关的 AT 命令 本章主要说明与平台的连接和功能相关的 AT 命令。 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了 ， 仅显示命令和响应。 表 1：AT 命令及响应类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的设置命令，并返回有关其参 数的类型、值或范围的信息。 查询相应设置命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 8 / 34 BC25 系列中国电信物联网平台应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 2.3. AT 命令详解 2.3.1. AT+NCDPOPEN 发起连接 该命令通过配置平台接入的 IP 地址和端口号将模块连接到平台服务器。如果缺省参数未配置，则自动 使用默认值进行连接。 AT+NCDPOPEN 发起连接 测试命令 响应 AT+NCDPOPEN=? OK 设置命令 AT+NCDPOPEN=[,[, ]] 若出现任何错误： ERROR 或 +CME ERROR: 响应 若连接成功： OK +QLWEVTIND: 0 最大响应时间 特性说明 +QLWEVTIND: 3 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 / 参数 字符串型。平台服务器接入的 IP 地址。 整型。服务器接入的 IP 端口。当未配置或配置为 0 时，取默认值 5683。范围：0~65535。 十六进制字符串型。加密设备的密钥，在平台端注册加密设备时可由平台生成或自主设 上海移远通信技术股份有限公司 9 / 34 BC25 系列中国电信物联网平台应用指导 置，最大支持长度 256 字节。 错误码，详情请参考第 5 章。 备注 1. 在模块连接命令之前，必须确保该设备 IMEI 号在平台端已注册。 2. 如果注册设备为加密设备，则必须通过平台指定的加密端口及正确的进行连接。 3. 如果已经执行 AT+NCDPOPEN 命令发起连接，可执行 AT+NCDPCLOSE 主动断开连接。 4. 执行 AT+NCDPOPEN 命令后，若连接超时或者连接被服务器拒绝，将收到 URC +QLWEVTIND: 1。 5. 非加密连接下，返回连接结果的最大超时时间为 124 秒。加密连接场景下，若 MCU 在 180 秒后仍 未收到连接结果，建议执行 AT+NMSTATUS 查询注册状态，检查 AT 命令各参数是否正确，执行 AT+NCDPCLOSE 主动断开连接后，再重新发起连接。 2.3.2. AT+NCDPCLOSE 断开连接 该命令用于断开模块与平台的连接。 AT+NCDPCLOSE 断开连接 执行命令 响应 AT+NCDPCLOSE OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 / 参数 错误码，详情请参考第 5 章。 2.3.3. AT+NMGS 发送数据 该命令用于将数据发送到平台。如果数据发送失败，将返回 ERROR 或+CME ERROR：。 AT+NMGS 发送数据 设置命令 响应 AT+NMGS=,[,] OK 若出现任何错误： 上海移远通信技术股份有限公司 10 / 34 最大响应时间 特性说明 BC25 系列中国电信物联网平台应用指导 ERROR 或 +CME ERROR: 300 毫秒 / 参数 整型。发送数据的长度。最大值：512；单位：字节。 十六进制字符串型。要发送的数据内容。 整型。发送数据类型。 0 发送 NON 数据并将模块发送数据所携带的 RAI 辅助释放标记设置为 0 1 发送 NON 数据并将模块发送数据所携带的 RAI 辅助释放标记设置为 1 2 发送 NON 数据并将模块发送数据所携带的 RAI 辅助释放标记设置为 2 100 发送 CON 数据并将模块发送数据所携带的 RAI 辅助释放标记设置为 0 101 发送 CON 数据并将模块发送数据所携带的 RAI 辅助释放标记设置为 1 102 发送 CON 数据并将模块发送数据所携带的 RAI 辅助释放标记设置为 2 错误码，详情请参考第 5 章。 备注 1. NON 数据表示发送的该数据不需要服务器 ACK，CON 表示发送数据需要服务器 ACK。 2. 如果通过该命令设置了 RAI 标记，则后续由模块向平台发送的所有数据都将携带已配置的 RAI 标记。 3. RAI 标记用于指示核心网释放与模块的 RRC 连接。 RAI 为 0 时，无指示。 RAI 为 1 时，指示该包上行数据后不期望有进一步的上行或者下行数据，核心网可立即释放。 RAI 为 2 时，指示该包上行数据后期望有对应回复的单个下行数据包，核心网在下发后立即释放。 4. 如果参数省略，则取默认值 0。 5. 若需指示核心网尽快释放网络，需要根据平台配置选择相应。 若平台配置为数据上报无响应，发送 NON 数据则配置=1，发送 CON 数据则配置=102。 若平台配置为数据上报有响应（默认响应 AAAA0000），发送 NON 数据则配置=1，发送 CON 数据则配置=101。 2.3.4. AT+NMGR 读取缓存数据 该命令用于读取 Buffer 中缓存的数据。当接收数据模式改为 Buffer（缓存）模式时，平台下发的数据 将会缓存在本地 Buffer 中供读取。 AT+NMGR 读取缓存数据 执行命令 AT+NMGR 响应 若 Buffer 不为空且读取成功： +NMGR: , 上海移远通信技术股份有限公司 11 / 34 BC25 系列中国电信物联网平台应用指导 最大响应时间 特性说明 OK 若 Buffer 为空： OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 / 参数 整型。接收的数据长度。单位：字节。 十六进制字符串型。接收的数据内容。 错误码，详情请参考第 5 章。 备注 1. 该命令按照数据接收顺序逐条读取，若数据读取成功，则会把该条数据从 Buffer 中移除。 2. 如果将数据接收模式设置为直吐模式（AT+NNMI=1），则新接收到的数据将会通过 URC 直接上报， 并不会保存在 Buffer 中。 2.3.5. AT+NNMI 配置数据接收模式 该命令用于设置模块接收数据模式为 Push（直吐）模式或者 Buffer（缓存）模式。 AT+NNMI 查询命令 AT+NNMI? 配置数据接收模式 响应 +NNMI: 设置命令 AT+NNMI= OK 响应 OK 若出现任何错误： ERROR 或 +CME ERROR: 上海移远通信技术股份有限公司 12 / 34 BC25 系列中国电信物联网平台应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置不保存到 NVRAM，但深度睡眠唤醒后仍有效。 参数 整型。数据接收模式。 0 设置接收数据模式为缓存模式，接收到新数据时无 URC 上报 1 设置接收数据模式为直吐模式，接收到新数据时通过 URC 立即上报 2 设置接收数据模式为缓存模式，接收到新数据时仅上报指示 URC 错误码，详情请参考第 5 章。 备注 1. 当设置 AT+NNMI=1 时，从平台接收的新数据将直接上报 URC +NNMI: ,，数据不 会缓存在 Buffer 中。 2. 当设置 AT+NNMI=2 时，只有当本地 Buffer 为空时，接收到新数据上报指示 URC +NNMI，接收的 数据将被缓存在 Buffer 中，需要使用 AT+NMGR 命令读取。 3. 缓存区最多可以保存 2560 字节的数据，如果保存在 Buffer 中的数据长度加上新数据长度超过 2560 字节，则新数据将被丢弃，并上报 URC +NNMI: OC'recv',buff full，表示本地 Buffer 已满。 2.3.6. AT+NCFG 配置命令 该命令用于配置平台相关功能。 AT+NCFG 配置命令 测试命令 AT+NCFG=? 设置命令 AT+NCFG=[,] 响应 +NCFG: 0[,(配置生命周期时支持的范围)] +NCFG: 1[,(配置唤醒后连接恢复功能时支持的范围)] OK 若出现任何错误： ERROR 或 +CME ERROR: 响应 若指定可选参数，则配置： OK 若省略可选参数，则查询当前已配置： +NCFG: 上海移远通信技术股份有限公司 13 / 34 BC25 系列中国电信物联网平台应用指导 最大响应时间 特性说明 OK 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 =0 时，参数配置在进入深度睡眠前保存到 NVRAM， 深度睡眠唤醒后有效，重启后恢复成默认设置； =1 时，参数配置自动保存至 NVRAM。 参数 整型。配置的模式。 0 配置设备在平台端的生存周期（Lifetime） 1 配置深度睡眠唤醒后连接恢复功能 整型。配置值。 当=0 时，表示设备在平台端的生命周期。单位：秒；范围：0~2592000。 当=1 时，0 表示开启深度睡眠唤醒恢复功能。1 表示关闭深度睡眠唤醒恢复功能。 错误码，详情请参考第 5 章。 备注 1. 若=0 且=0（即配置平台端生命周期为 0）时，模块注册到服务器时的注册数据包 中将不包含 Lifetime，模块端也不会自动发送更新包到服务器； 当=0，不为 0（即配置的生命周期不为 0 时），模块实际将以 × 0.9 的时 间周期，向平台发起更新注册。如果此时配置 AT+NCFG=1,0（即配置开启深度睡眠唤醒功能）， 该更新注册行为会将模块从深度睡眠唤醒。 2. 重新启动模块后，Lifetime 将重置为默认值 0。若在模块已连接到平台后配置 Lifetime，需要下次发 起连接才会生效。 3. 若将 Lifetime 配置为 1 到 900 之间的值，则取值 900。 4. 模块从深度睡眠唤醒，Lifetime 和 AT+NNMI 的值将会恢复进入睡眠前的配置值，若深度睡 眠唤醒恢复功能开启，且进入深度睡眠之前的状态为已连接，则唤醒后会自动恢复连接，恢复成功 上报 URC +QLWEVTIND: 6，此时可以直接做业务，恢复失败将会上报 URC +QLWEVTIND: 7，此 时需要重新发起连接。 5. Buffer 中缓存的平台数据，在进入深度睡眠后会全部丢失，请及时读取。 上海移远通信技术股份有限公司 14 / 34 BC25 系列中国电信物联网平台应用指导 2.3.7. AT+NMSTATUS 查询注册状态 该命令用于查询注册状态。相关错误码请参考章节 5。 AT+NMSTATUS 查询命令 AT+NMSTATUS? 查询注册状态 响应 +NMSTATUS: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或 +CME ERROR: 300 毫秒 / 参数 字符串型。 UNINITIALISED 未初始化状态 REGISTERING 连接中 REJECTED_BY_SERVER 连接请求被服务器拒接 TIMEOUT 连接超时 REGISTERED 已连接未订阅 REGISTERED_AND_OBSERVED 已连接已订阅 DEREGISTERED 连接断开 RESUMPTION_FAILED DTLS 会话恢复失败 错误码，详情请参考第 5 章。 备注 1. 如果查询的状态为 REJECTED_BY_SERVER，请检查模块是否使用了正确的 IP 地址和端口号发 起连接，检查 IMEI 是否已在平台上注册后再重新发起连接。 2. 如果查询的状态为 TIMEOUT，请检查模块是否使用了正确的 IP 地址和端口号发起连接，对于加密 设备，请同时检查是否正确，再重新发起连接。 3. 当查询状态为 REGISTERED_AND_OBSERVED（订阅成功）状态时，模块才可以发送数据。 2.3.8. AT+QLWULDATASTATUS 查询 CON 消息发送状态 该命令用于查询向 NB-IoT 平台发送 CON 数据的状态。此命令仅查询已发送的 CON 数据的状态。 上海移远通信技术股份有限公司 15 / 34 BC25 系列中国电信物联网平台应用指导 AT+QLWULDATASTATUS 查询 CON 消息发送状态 查询命令 AT+QLWULDATASTATUS? 响应 +QLWULDATASTATUS: OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。CON 数据发送状态。 0 未发送 1 已发送，等待 NB-IoT 平台响应 2 发送失败 3 发送超时 4 发送成功 5 收到 RESET 消息 错误码。详情请参考第 5 章。 举例 AT+QLWULDATASTATUS? +QLWULDATASTATUS: 4 OK 2.3.9. AT+NQMGR 查询已接收消息状态 该命令用来查询从 NB-IoT 平台接收的下行消息的状态。 AT+NQMGR 查询已接收消息状态 执行命令 AT+NQMGR 响应 BUFFERED=,RECEIVED=,DROPPE D= OK 上海移远通信技术股份有限公司 16 / 34 BC25 系列中国电信物联网平台应用指导 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。下行缓存中等待读取的消息条数。 整型。UE 启动后收到的消息总数。 整型。UE 启动后丢弃的消息条数。 错误码。详情请参考第 5 章。 举例 AT+NQMGR BUFFERED=0,RECEIVED=34,DROPPED=2 OK 上海移远通信技术股份有限公司 17 / 34 BC25 系列中国电信物联网平台应用指导 3 平台相关的 URC 本章列举了与中国电信物联网平台相关的 URC 及其描述。 表 2：平台相关 URC 索引 URC [1] +QLWEVTIND: [2] +NNMI[: ,] [3] +NNMI: OC'recv',buff full [4] +QIND: 'FOTA','DOWNLOAD START' [5] +QIND: 'FOTA','DOWNLOADING', [6] +QIND: 'FOTA','DOWNLOAD', [7] +QIND: 'FOTA','START' [8] +QIND: 'FOTA','UPDATING', [9] +QIND: 'FOTA','END', 描述 模块动作执行结果 接收到平台下发的新数据 Buffer 已满，新数据已丢弃 开始下载固件 固件下载状态 固件下载结果 模块固件升级开始 模块固件升级进度 模块固件升级结果 3.1. +QLWEVTIND: 模块动作执行结果 该 URC 表示模块相关动作的执行结果。 +QLWEVTIND: 模块动作执行结果 +QLWEVTIND: 表示模块动作执行的结果 参数 整型。 -1 连接发生异常 0 模块已连接 上海移远通信技术股份有限公司 18 / 34 BC25 系列中国电信物联网平台应用指导 1 连接被服务器拒绝或连接超时 3 表示 object 19/0/0 已订阅 4 CON 数据发送成功 5 CON 数据发送失败 6 深度睡眠唤醒连接恢复成功 7 深度睡眠唤醒连接恢复失败 8 上报升级状态的 object 5/0/3 已订阅 9 上报升级状态的 object 5/0/3 已取消订阅 10 通过 object 19/0/0 上行数据时收到了平台回复的 RST 消息，此时只有重新建立连 接才能够发送数据 备注 1. BC25PAR01A05 和 BC25B5PAR01A06 及 以 上 版 本 新 增 了 为 1 的 结 果 码 。 执 行 AT+NCDPOPEN 发起连接被服务器拒绝或连接超时会上报，MCU 可根据此结果码直接判断是否需 要做异常处理。 2. +QLWEVTIND: 6 仅表示模块从深度睡眠唤醒后进行本地数据的自恢复，并不会和网络进行交互。 3.2. +NNMI[: ,] 接收到新数据 该 URC 表示从平台接收到新数据。 +NNMI[: ,] 接收到新数据 +NNMI[: ,] 接收到新数据 参数 整型。已接收的数据长度 已接收的数据内容 备注 1. 模块单次可接收的最大数据包长度为 1024 字节。如果超过 1024 字节，则此条数据会被丢弃。 2. AT+NNMI=1 时上报 URC +NNMI: ,；AT+NNMI=2 时仅上报指示 URC +NNMI。 上海移远通信技术股份有限公司 19 / 34 BC25 系列中国电信物联网平台应用指导 3.3. +NNMI: OC'recv',buff full 缓存区已满 该 URC 表示本地存储接收数据的 Buffer 已满。 +NNMI: OC'recv',buff full 缓存区已满 +NNMI: OC'recv',buff full 本地存储接收数据的 Buffer 已满 3.4. +QIND: 'FOTA','DOWNLOAD START' 开始下载固件 该 URC 表示开始下载升级包固件。 +QIND: 'FOTA','DOWNLOAD START' 开始下载固件 +QIND: 'FOTA','DOWNLOAD START' 开始下载固件 3.5. +QIND: 'FOTA','DOWNLOADING', 固件下载状态 该 URC 表示固件目前下载状态。 +QIND: 'FOTA','DOWNLOADING', 固件下载状态 +QIND: 'FOTA','DOWNLOADING', 固件目前下载状态 参数 整型。表示目前已下载的固件包大小。单位：字节。 3.6. +QIND: 'FOTA','DOWNLOAD', 固件下载结果 该 URC 表示固件的下载结果。 +QIND: 'FOTA','DOWNLOAD', 固件下载结果 +QIND: 'FOTA','DOWNLOAD', 固件下载结果 参数 整型。固件下载结果。 上海移远通信技术股份有限公司 20 / 34 BC25 系列中国电信物联网平台应用指导 0 固件下载成功，固件包完整性检查通过，可以发起升级动作 2 内存不足，下载失败 4 连接断开，下载失败 5 固件下载成功，但固件包完整性检查未通过 7 平台下发了无效的 URL，下载失败 3.7. +QIND: 'FOTA','START' 模块开始升级固件 该 URC 表示模块开始升级已下载的固件。 +QIND: 'FOTA','START' 模块开始升级固件 +QIND: 'FOTA','START' 模块开始固件升级 3.8. +QIND: 'FOTA','UPDATING', 模块固件升级进度 该 URC 表示模块固件升级进度。 +QIND: 'FOTA','UPDATING', 模块固件升级进度 +QIND: 'FOTA','UPDATING', 表示模块固件升级进度 参数 百分比格式。表示模块固件升级进度。 3.9. +QIND: 'FOTA','END', 模块固件升级结果 该 URC 主要指示模块固件升级结果。 +QIND: 'FOTA','END', 模块固件升级结果 +QIND: 'FOTA','END', 模块固件升级结果 参数 整型。固件升级结果。 0 模块固件升级成功 6508 模块固件升级失败 上海移远通信技术股份有限公司 21 / 34 BC25 系列中国电信物联网平台应用指导 4 举例 本章节提供了有关如何应用与平台相关的 AT 命令以实现相关功能的示例。 4.1. 对接电信 IoT 平台 4.1.1. 平台侧配置 4.1.1.1. 创建设备 1. 登录电信 IoT 平台（网址：https://develop.ct10649.com:8093/#/login），在项目空间内，依次选 择'产品'→'产品开发'，随后点击'新建产品'新建一款产品。 图 1：新建产品 上海移远通信技术股份有限公司 22 / 34 BC25 系列中国电信物联网平台应用指导 2. 在'创建产品'界面，选择'自定义产品'，点击'自定义产品'按钮即可开始自主开发一款产 品。 图 2：自定义产品 3. 在'设置产品信息'窗口，填写创建产品的信息，完成各参数的配置后，点击'创建'即可创建 新的产品。 图 3：填写创建产品的信息 上海移远通信技术股份有限公司 23 / 34 4. 进入新创建的产品，选择'Profile 定义'。 BC25 系列中国电信物联网平台应用指导 图 4：定义 Profile 5. 选择'编解码插件开发'，根据定义的 Profile 进行插件开发和部署，插件开发完成后点击右上角 的'部署'按钮。 图 5：开发编码器插件 上海移远通信技术股份有限公司 24 / 34 BC25 系列中国电信物联网平台应用指导 4.1.1.2. 在线调试 在入门阶段，开发者可以使用开发中心的虚拟设备模拟设备接入电信 IoT 平台的场景。在创建的产品 中，选择'在线调测'。 图 6：选择在线调测 图 7：模拟设备接入平台 备注 Profile 定义、插件开发以及在线调试的具体操作方式请参考中国电信平台开发文档。文档地址如下： https://develop.ct10649.com:8093/assets/docCenter/helpcenter/helpPortal/Portal/helpcenter.html?ma nualName=UserGuide_ChinaTelecom&docSite=ChinaTelecom&page=gettingStarted&lang=zh 4.1.2. 模块侧对接电信 IoT 平台 AT 命令示例 RDY +CFUN: 1 +CPIN: READY AT+QSCLK=0 OK AT+NNMI=1 //禁用睡眠模式 //将数据接收模式设置为直吐模式 上海移远通信技术股份有限公司 25 / 34 BC25 系列中国电信物联网平台应用指导 OK AT+CGPADDR? +CGPADDR: 1,'11.49.118.218','' //查询模块是否成功注网 //已注网，可以发起连接 OK AT+NCDPOPEN='180.101.147.115' OK +QLWEVTIND: 0 //将模块连接到平台的服务器 //命令执行成功 //模块连接成功 +QLWEVTIND: 3 AT+NNMI=2 OK AT+NMGS=5,00454c4c4f OK //object 19/0/0 已成功订阅，可以发送数据 //设置数据接收模式为缓存模式且仅上报指示 URC //向平台发送数据 +NNMI //URC 提示已接收到来自平台的数据 AT+NQMGR //查询已接收消息状态 BUFFERED=1,RECEIVED=1,DROPPED=0 //查询结果：待读取 1 条，已接收 1 条，已丢弃 0 条 OK AT+NMGR +NMGR: 4,AAAA0000 //读取缓存数据 OK AT+NQMGR //查询已接收消息状态 BUFFERED=0,RECEIVED=1,DROPPED=0 //查询结果：待读取 0 条，已接收 1 条，已丢弃 0 条 OK AT+QSCLK=1 OK +QATSLEEP //启用浅睡眠和深睡眠 //进入深睡眠 +QATWAKEUP +QLWEVTIND: 6 AT+QSCLK=0 OK AT+NMGS=7,000548454c4c4f,100 OK //从深睡眠唤醒 //深睡眠唤醒连接恢复成功 //禁用睡眠模式 //向平台发送 CON 数据 +QLWEVTIND: 4 上海移远通信技术股份有限公司 26 / 34 +NNMI AT+QLWULDATASTATUS? +QLWULDATASTATUS: 4 OK AT+QSCLK=1 OK BC25 系列中国电信物联网平台应用指导 //URC 提示已接收到来自平台的数据 //查询 CON 消息发送状态 //CON 消息发送成功 //启用浅睡眠和深睡眠 4.2. 对接电信 AEP 平台 4.2.1. 平台侧配置 4.2.1.1. 产品创建 1. 登录电信 AEP 平台（https://www.ctwing.cn），在'开发者中心'内选择'产品中心'，随后点 击'创建产品'，新建一款产品。 图 8：中国电信物联网开放平台首页 上海移远通信技术股份有限公司 27 / 34 BC25 系列中国电信物联网平台应用指导 图 9：产品中心 - 创建产品 2. 在'创建产品'界面，根据自己的需求编辑产品的各项配置（下图仅为举例说明，若第一次创建， 建议选择透传模式）。 图 10：创建产品 - 编辑产品配置 上海移远通信技术股份有限公司 28 / 34 4.2.1.2. 设备添加 进入创建好的产品，点击'添加设备'。 BC25 系列中国电信物联网平台应用指导 图 11：添加设备 4.2.1.3. 设备激活后对象操作 1. 如下图，点击红色箭头所指图标，可查看对象（Object）。 图 12：查看对象（Object） 上海移远通信技术股份有限公司 29 / 34 BC25 系列中国电信物联网平台应用指导 2. 如下图，点击红色箭头所指图标，可查看平台接收数据。 图 13：查看数据（Object） 3. 在'Object 列表'中，可对其中的 Object 进行订阅、取消订阅和读写等操作。下图中右上方点击 '查看 object 日志'，可查看之前执行的操作。 图 14：查看 Object 日志 备注 以上仅作为新手参考，更多内容请参考电信 AEP 平台的官方开发文档。文档地址如下： https://help.ctwing.cn/zhangti-kaifa-liuc/zhangti-kaifa-liuc.html 4.2.2. 模块侧对接电信 AEP 平台 AT 命令示例 RDY +CFUN: 1 上海移远通信技术股份有限公司 30 / 34 BC25 系列中国电信物联网平台应用指导 +CPIN: READY AT+QSCLK=0 OK AT+NNMI=1 OK AT+CGPADDR? +CGPADDR: 1,'11.40.70.201','' //禁用睡眠模式 //将数据接收模式设置为直吐模式 //查询模块是否成功注网 //已注网，可以发起连接 OK AT+NCFG=0,86400 OK AT+NCDPOPEN='221.229.214.202' OK //将模块连接到平台的服务器 //命令执行成功 +QLWEVTIND: 0 //模块连接成功 +QLWEVTIND: 3 AT+NMGS=7,000548454c4c4f OK AT+QSCLK=1 OK //object 19/0/0 已成功订阅，可以发送数据 //向平台发送数据 //启用浅睡眠和深睡眠 +QATSLEEP //进入深睡眠 +QATWAKEUP //从深睡眠唤醒 +QLWEVTIND: 6 AT+QSCLK=0 OK AT+NMGS=7,010548454c4c4f ,100 OK //深睡眠唤醒连接恢复成功 //禁用睡眠模式 //向平台发送 CON 数据 +QLWEVTIND: 4 AT+QLWULDATASTATUS? +QLWULDATASTATUS: 4 //查询 CON 消息发送状态 //CON 消息发送成功 OK AT+QSCLK=1 OK //启用浅睡眠和深睡眠 上海移远通信技术股份有限公司 31 / 34 BC25 系列中国电信物联网平台应用指导 5 错误码概览 本章节介绍了与 BC25 系列模块相关的错误码。 表 3：常见错误码（27.007） 3 4 23 30 50 52 53 159 285 286 英文含义 Operation not allowed Operation not supported Memory failure No network service Execute fail Option not support Param invalid Uplink busy/flow control Wait for session resumption Wait for data sending 中文含义 不允许该操作 不支持该操作 内存故障 无网络服务 执行失败 不支持该选项 参数无效 上行忙/流控 等待会话恢复 等待数据发送 备注 可使用 AT+CMEE=命令设置禁用（=0）或者使能（=1、=2）最终结果码的+CME EROR: 的上报。有关该命令的使用详情，请参考文档 [1]。 上海移远通信技术股份有限公司 32 / 34 BC25 系列中国电信物联网平台应用指导 6 附录 A 参考文档及术语缩写 表 4：参考文档 编号 文档名称 [1] Quectel_BC25_AT 命令手册 备注 BC25 模块 AT 命令说明 表 5：术语缩写 缩写 ACK CoAP CON eDRX IMEI IoT IP LwM2M NB-IoT NON NVRAM PSM RAI REST 英文全称 Acknowledgement Constrained Application Protocol Confirmable Extended Discontinuous Receive International Mobile Equipment Identity Internet of Things Internet Protocol Lightweight M2M Narrow Band Internet of Things Nonconfirmable Non-Volatile Random Access Memory Power Saving Mode Release Assistance Indication Representational State Transfer 中文全称 确认字符 受限的应用层协议 需要对端返回应答的信息类型 扩展非连续接收 国际移动设备识别码 物联网 网际互连协议 轻量化 M2M（协议） 窄带物联网 不需要对端返回应答的信息类型 非易失性随机访问存储器 省电模式 辅助释放指示 表述性状态转移 上海移远通信技术股份有限公司 33 / 34 RRC URC URL Radio Resource Control Unsolicited Result Code Uniform Resource Locator BC25 系列中国电信物联网平台应用指导 无线资源控制 非请求结果码 统一资源定位符 上海移远通信技术股份有限公司 34 / 34

BG95&BG77&BG600L Series TCP/IP Application Note LPWA Module Series Version: 1.2 Date: 2022-06-15 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you re quire any assistance, please contact our headquarters: Que ctel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For te chnical support, or to report documentation errors, please v isit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 1 / 57 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third -party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhan ce, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel ’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third -party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 2 / 57 LPWA Module Series About the Document Revision History Version Date Author De scription 1.0 2019-08-12 Terrence YANG Initial 1. Added an applicable module BG600L-M3. 2. Updated the valid value range of in AT+QICLOSE from 1–65535 to 0–65535 (Chapter 2.3.5). 3. Added for AT+QISENDEX to configure RAI (Chapter 2.3.9). 4. Changed the default value of of Terrence YANG/ 1.1 2021-03-29 AT+QICFG='tcp/retranscfg' from 8 to 12 (Chapter Sherlock ZHAO 2.3.15). 5. Added AT+QICFG='sack' and AT+QICFG='tcp/ke epalive' commands (Chapter 2.3.15). 6. Added some examples about TCP/UDP operations under IPv6 (Chapter 3.3, 3.7 and 3.9) and an example about UDP client with RAI feature (Chapter 3.10). 1. Added notes about AT+QICSGP (Chapter 2.3.1). 2. Added the maximum length of , in AT+QICSGP (Chapter 2.3.1). 3. Added the maximum length of in Water WANG/ AT+QIOPEN (Chapter 2.3.4). 1.2 2022-06-15 Sherlock ZHAO/ 4. Added the valid value range of and Terrence YANG (Chapter 2.3). 5. Added AT+QICFG='tcp/inactivetm', AT+QICFG='ip v6prior' and AT+QICFG='asyncmode' (Chapter 2.3.15). BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 3 / 57 LPWA Module Series Contents About the Document ............................................................................................................................. 3 Contents ................................................................................................................................................ 4 Table Index ............................................................................................................................................ 7 1 Introduction .................................................................................................................................... 8 1.1. Usage of TCP/IP AT Commands ............................................................................................. 8 1.2. Description of Data Access Modes........................................................................................ 10 2 TCP/IP AT Commands.................................................................................................................. 12 2.1. AT Command Introduction..................................................................................................... 12 2.1.1. Definitions ................................................................................................................. 12 2.1.2. AT Command Syntax................................................................................................. 12 2.2. Declaration of AT Command Examples ................................................................................. 13 2.3. Description of TCP/IP AT Commands .................................................................................... 13 2.3.1. AT+QICSGP Configure Parameters of a TCP/IP Context ........................................ 13 2.3.2. AT+QIACT Activate a PDP Context ......................................................................... 14 2.3.3. AT+QIDEACT Deactivate a PDP Context................................................................ 15 2.3.4. AT+QIOPEN Open a Socket Service ...................................................................... 16 2.3.5. AT+QICLOSE Close a Socket Service .................................................................... 18 2.3.6. AT+QISTATE Query Socket Service Status............................................................. 19 2.3.7. AT+QISEND Send Data .......................................................................................... 21 2.3.8. AT+QIRD Retrieve the Received TCP/IP Data ........................................................ 23 2.3.9. AT+QISENDEX Send Hex String Data .................................................................... 25 2.3.10. AT+QISWT MD Switch Data Access Mode .............................................................. 26 2.3.11. AT+QPING Ping a Remote Host ............................................................................. 26 2.3.12. AT+QNTP Synchronize Local Time with NTP Server ............................................... 28 2.3.13. AT+QIDNSCFG Configure Address of DNS Server ................................................. 29 2.3.14. AT+QIDNSGIP Get IP Address by Domain Na me ................................................... 30 2.3.15. AT+QICFG Configure Optional Parameters............................................................. 30 2.3.16. AT+QISDE Control Whether to Echo the Data for AT+QISEND ............................... 35 2.3.17. AT+QIGETERROR Query the Last Result Code ..................................................... 36 2.4. Description of URCs ............................................................................................................. 36 2.4.1. +QIURC: 'closed' Indicate Connection Closed ....................................................... 37 2.4.2. +QIURC: 'recv' Indicate Incoming Data .................................................................. 37 2.4.3. +QIURC: 'incoming full' Indicate Incoming Connection Reaches the Limit .............. 38 2.4.4. +QIURC: 'incoming' Indicate Incoming Connection ................................................ 38 2.4.5. +QIURC: 'pdpdeact' Indicate PDP Deactivation ..................................................... 38 3 Examples ...................................................................................................................................... 40 3.1. Configure and Activate a Context .......................................................................................... 40 3.1.1. Configure a Context .................................................................................................. 40 3.1.2. Activate a Context ..................................................................................................... 40 3.1.3. Deactivate a Context ................................................................................................. 40 BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 4 / 57 LPWA Module Series 3.2. TCP Client Works in Buffer Access Mode under IPv4 ............................................................ 40 3.2.1. Set up a TCP Client Connection and Enter Buffer Access Mode................................ 40 3.2.2. Send Data in Buffer Access Mode ............................................................................. 41 3.2.3. Retrieve Data from Remote Server in Buffer Access Mode ........................................ 41 3.2.4. Close a Connection ................................................................................................... 42 3.3. TCP Client Works in Buffer Access Mode under IPv6 ............................................................ 42 3.3.1. Set up a TCP Client Connection and Enter Buffer Access Mode................................ 42 3.3.2. Send Data in Buffer Access Mode ............................................................................. 42 3.3.3. Receive Data from Remote Server in Buffer Access Mode ........................................ 43 3.3.4. Close a Connection ................................................................................................... 43 3.4. TCP Client Works in Transparent Transmission Mode........................................................... 44 3.4.1. Set up a TCP Client Connection and Enter Transparent Transmission Mode ............. 44 3.4.2. Send Data in Transparent Transmission Mode .......................................................... 44 3.4.3. Retrieve Data from Remote Server in Transparent Transmission Mode ..................... 44 3.4.4. Close a TCP Client.................................................................................................... 44 3.5. TCP Client Works in Direct Push Mode................................................................................. 44 3.5.1. Set up a TCP Client Connection and Enter Direct Push Mode ................................... 44 3.5.2. Send Data in Direct Push Mode................................................................................. 45 3.5.3. Retrieve Data from Remote Server in Direct Push Mode ........................................... 45 3.5.4. Close a TCP Client.................................................................................................... 45 3.6. TCP Server Works in Buffer Access Mode under IPv4 Net work............................................. 46 3.6.1. Start a TCP Server .................................................................................................... 46 3.6.2. Accept TCP Incoming Connection ............................................................................. 46 3.6.3. Retrieve Data from Incoming Connection .................................................................. 46 3.6.4. Close a TCP Server................................................................................................... 47 3.7. TCP Server Works in Buffer Access Mode under IPv6 Net work............................................. 47 3.7.1. Start a TCP Server .................................................................................................... 47 3.7.2. Accept TCP Incoming Connection ............................................................................. 47 3.7.3. Retrieve Data from Incoming Connection .................................................................. 47 3.7.4. Switch Incoming Connection to Transparent Transmission Mode............................... 48 3.7.5. Close a TCP Server................................................................................................... 48 3.8. UDP Service under IPv4 Network ......................................................................................... 48 3.8.1. Start a UDP Service .................................................................................................. 48 3.8.2. Send UDP Data to Remote Client.............................................................................. 49 3.8.3. Retrieve Data from Remote Client ............................................................................. 49 3.8.4. Close a UDP Service ................................................................................................. 49 3.9. UDP Service under IPv6 Network ......................................................................................... 49 3.9.1. Start a UDP Service .................................................................................................. 49 3.9.2. Send UDP Data to Remote Client.............................................................................. 50 3.9.3. Retrieve Data from Remote Client ............................................................................. 50 3.9.4. Close a UDP Service ................................................................................................. 50 3.10. UDP Client with RAI Feature................................................................................................. 51 3.10.1. Start a UDP Client ..................................................................................................... 51 3.10.2. Send UDP Data with RAI Information ........................................................................ 51 BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 5 / 57 LPWA Module Series 3.10.3. Close a UDP Client.................................................................................................... 52 3.11. PING..................................................................................................................................... 52 3.11.1. PING under IPv4 ....................................................................................................... 52 3.11.2. PING under IPv6 ....................................................................................................... 52 3.12. Synchronize Local Time ........................................................................................................ 53 3.13. Getting the Last Error Code .................................................................................................. 53 4 Summary of Result Codes........................................................................................................... 54 5 Appendix References................................................................................................................... 56 BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 6 / 57 LPWA Module Series Table Index Table 1: Types of AT Commands ...........................................................................................................12 Table 2: Summary of Result Codes........................................................................................................54 Table 3: Related Document ...................................................................................................................56 Table 4: Terms and Abbreviations ..........................................................................................................56 BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 7 / 57 LPWA Module Series 1 Introduction Quectel BG95 series, BG77 and BG600L-M3 modules feature an embedded TCP/IP stack, which enables the host to access the Internet directly via AT commands. This greatly reduces the dependence on external PPP and TCP/IP protocol stacks and thus minimizes the cost. BG95 series, BG77 and BG600L-M3 modules provide the following socket services: ⚫ TCP client ⚫ UDP client ⚫ TCP server ⚫ UDP server NOTE See the firmware release notes of corresponding module models to check whether the function has been supported. 1.1. Usage of TCP/IP AT Commands With TCP/IP AT commands, the host can configure a PDP context, activate/deactivate the PDP context, open/close a socket service and send/retrieve data via the socket service. The following figure illustrates how to use TCP/IP AT commands. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 8 / 57 Recommended Power on/off: For the proper power on/off procedure and timings, please check the hardware design manual of specified modules. Query (U)SIM Card Status: Execute AT+CPIN. Reboot the module if AT+CPIN? fails to identify (U)SIM card in 20 s. PS Service: 1. If of AT+CGREG?/AT+CEREG? equals 1 or 5, it means that the module has registered on PS domain service in EGRPS/Cat M1 or NB-IoT network. 2. Go to next step no matter whether it is registered on PS domain service or not in 60 s. Configure a PDP Context: Configure APN, user name, password and auth type with AT+QICSGP. (AT+CGDCONT only can configure APN information.) LPWA Module Series Power on the module Send AT command and wait for the module to respond OK Query (U)SIM card status with AT+CPIN? If you fail to identify (U)SIM card in 20 s, reboot the module. Identify (U)SIM card Query PS service in 60 s with AT+CGREG?/ AT+CEREG? If you fail to get PS registered status, configure the PDP context then switch the functionality level with AT+CFUN or reboot the module. Configure the PDP Context with AT+QICSGP/AT+CGDCONT Activate a PDP Context: 1. Activate the PDP context with AT+QIACT=. 2. Query IP address of the PDP context with AT+QIACT?. NOTE: a) All above commands should be executed together in sequence. b) Reboot the module if there is no response to AT+QIACT in 150s. c) Reboot the module if it fails to deactivate the PDP context for 3 consecutive times. 3. Deactivate the PDP context: reboot the module if there is no response to AT+QIDEACT in 40 s. Reboot the module if there is no response in 40 s. The PDP context is deactivated successfully Activate the PDP context with AT+QIACT= and AT+QIACT? 1. Reboot the module if there is no response in 150 s. 2. If you fail to deactivate the PDP context for 3 consecutive times, reboot the module. Failed to activate the PDP context Successfully activate PDP context Deactivate the PDP context with AT+QIDEACT= Open connection with AT+QIOPEN Open Connection: 1. If you fail to get the response to AT+QIOPEN in 150 s, close the connection. 2. If the module fails to open the connection for 5 consecutive times, deactivate the PDP context first, and then re-activate the PDP context and open connection again. 1. Failed to open connection for 5 consecutive times. 2. No response in150 s. +QIOPEN: , Send data with AT+QISEND= Get ACK in 90 s TCP Connection Maintenance and Detection: 1. Send data with AT+QISEND =[,]. It is recommended to periodically send a small data packet to the remote end to maintain and detect the TCP connection. 2. Query sending ACK with AT+QISEND=,0. If the package is still not acknowledged after two minutes (query every 5 seconds, 24 times in total), the TCP connection may be abnormal. Execute AT+QICLOSE to close the current connection, and then execute AT+QIOPEN to re-establish the TCP connection. Query sending ACK with AT+QISEND= ,0 Failed to get ACK in 90 s Close connection OK with AT+QICLOSE= Reboot the module if there is no response in 10 s. NOTE: 1. Please note that you need to wait for the final response (for example OK, CME error, CMS error) of the last AT command you entered before you enter the next AT command. You can reboot the module if the module fails to get response in 60 s. 2. Reboot the module if you do not get the response to AT+QIACT in 150 s or response to AT+QICLOSE in 10 s and AT+QIDEACT in 40 s. 3. DO NOT reboot the module too frequently. If the module has been rebooted for 3 consecutive times due to a failed AT command, it can immediately be rebooted for the fourth time. If the command fails again, reboot the module for the fifth time in 10 minutes. If the command fails, reboot for the sixth time in 30 minutes, and if the command still fails, reboot for the seventh time in 1 hour. Figure 1: Flow Chart of Using TCP/IP AT Commands BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 9 / 57 LPWA Module Series 1.2. Description of Data Access Modes The modules support three data access modes: ⚫ Buffer access mode ⚫ Direct push mode ⚫ Transparent transmission mode When opening a socket service with AT+QIOPEN, you can specify the data access mode with . After the socket service is opened, the data access mode can be changed with AT+QISWTM D. 1. In buffer access mode, the module buffers data upon receiving them and reports a URC in the format of +QIURC: 'recv',[,] to notify the host of the incoming data. In this case, the host can retrieve the buffered data with AT+QIRD. 2. In direct push mode, the module outputs the received data directly through a URC in the format of +QIURC: 'recv',, or +QIURC: 'recv',,,, . See Chapter 2.4.2 for more details. 3. In transparent transmission mode, the corresponding COM port (such as UART port, USB modem port, etc.) is exclusively used for sending/receiving data directly to/from the Internet. It cannot be used for other purposes such as running AT commands, etc. ⚫ Exit transparent transmission mode To make the module exit transparent transmission mode either: 1) Execute +++. Follow the requirements below to prevent the +++ from being misinterpreted as data: a) b) OR Do not input any character for at least 1 second before and after inputting +++. Input +++ within 1 second, and wait until OK is returned. After OK is returned, the module switches to buffer access mode. 2) Change MAIN_DTR from LOW to HIGH to make the module enter command mode. In this case, set AT&D1 (see document [1]) before the module enters transparent transmission mode. ⚫ Re turn to transparent transmission mode To return to transparent transmission mode either: 1) Execute AT+QISWTMD. Specify as 2 when executing this command. Once transparent transmission mode is entered successfully, CONNECT is returned. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 10 / 57 LPWA Module Series OR 2) Execute ATO. After a connection exits from transparent transmission mode, executing ATO switches the data access mode back to transparent transmission mode. Once transparent transmission mode is entered successfully, CONNECT is returned. If no connection has entered transparent transmission mode before, ATO returns NO CARRIER. NOTE 1. In buffer access mode, if the buffer is not empty, and the module receives data again, it does not report a new URC until all the received data have been retrieved with AT+QIRD from the buffer. 2. In transparent transmission mode, AT commands cannot be executed. If the socket connection is closed because of a network error or other errors, the module reports NO CARRIER and exits the transparent transmission mode. In this case, execute AT+QICLOSE to close the socket service. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 11 / 57 LPWA Module Series 2 TCP/IP AT Commands 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 1: Types of AT Commands Command Type Syntax De scription Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 12 / 57 LPWA Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel ’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 2.3. Description of TCP/IP AT Commands 2.3.1. AT+QICSGP Configure Parameters of a TCP/IP Context This command configures the , , and other parameters of a TCP/IP context. AT+QICSGP Configure Parameters of a TCP/IP Context Test Command AT+QICSGP=? Response +QICSGP: (range of supported s),(range of supported s),,,,(range of supported s) OK Write Command Query/set a specified context AT+QICSGP=[,,[,,[,]]] Response If the optional parameters are omitted, query the current setting: +QICSGP: ,,,, OK Maximum Response Time Characteristics If any of the optional parameters is specified, set a specified context: OK Or ERROR 300 ms The command takes effect immediately (actually determined by network). The configuration is saved automatically. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 13 / 57 Parameter LPWA Module Series Integer type. Context ID. Range: 1–16. Integer type. Protocol type. 1 IPv4 2 IPv6 3 IPv4v6 String type. Access Point Name. String type. Username. Maximum length: 128 bytes. String type. Password. Maximum length: 128 bytes. Integer type. Authentication methods. 0 None 1 PAP 2 CHAP 3 PAP or CHAP NOTE 1. The configurations of and are saved automatically. This means that if or has been configured before, the next time when AT+QICSGP is executed with any of the two parameters omitted, the parameter setting equals its previous value rather than the default one. 2. On BG95 series, BG77 and BG600L-M3 modules, AT+QICSGP cannot configure a same APN profile on different context IDs. Example AT+QICSGP=1 +QICSGP: 1,'','','',0 //Query the configuration of context 1. OK AT+QICSGP=1,1,'CM NBIOT','','',1 OK //Configure context 1. China Mobile NB-IoT network APN: CMNBIOT. 2.3.2. AT+QIACT Activate a PDP Context Before activating a PDP context with AT+QIACT, the context should be configured with AT+QICSGP. After activation, the IP address can be queried with AT+QIACT?. Although the range of is 1–16, the module supports maximum three PDP contexts activated simultaneously under LTE Cat M/EGPRS and maximum two under LTE Cat NB2. Depending on the BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 14 / 57 LPWA Module Series network, it may take max. 150 seconds to return OK or ERROR after executing AT+QIACT. Other AT commands can be executed only after the response is returned. AT+QIACT Activate a PDP Context Test Command AT+QIACT=? Response +QIACT: (range of supported s) Read command AT+QIACT? OK Response Return the list of the currently activated contexts and their IP addresses: +QIACT: 1,,[,] [..... +QIACT: 16,,[,]] Write Command Activate a specified PDP context AT+QIACT= Maximum Response Time Characteristics OK Response OK Or ERROR 150 s, determined by the network. / Parameter Integer type. Context ID. Range: 1–16. Integer type. Context state. 0 Deactivated 1 Activated Integer type. Protocol type. 1 IPv4 2 IPv6 String type. Local IP address after the context is activated. 2.3.3. AT+QIDEACT Deactivate a PDP Context This command deactivates a specific context and closes all TCP/IP connections set up in this context. Depending on the network, it may take max. 40 seconds to return OK or ERROR after executing AT+QIDEACT. Other AT commands can be executed only after the response is returned. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 15 / 57 LPWA Module Series AT+QIDEACT Deactivate a PDP Context Test Command AT+QIDEACT=? Response +QIDEACT: (range of supported s) Write Command AT+QIDEACT= Maximum Response Time Characteristics OK Response OK Or ERROR 40 seconds, determined by the network. / Parameter Integer type. Context ID. Range: 1–16. 2.3.4. AT+QIOPEN Open a Socket Service This command opens a socket service. The service type can be specified by . The data access mode (buffer access mode, direct push mode and transparent transmission mode) can be specified by . The response +QIOPEN: , indicates whether the socket service has been opened successfully. 1. If is 'TCP LISTENER', the module works as a TCP server. After accepting a new TCP connection, the module automatically specifies a and reports the URC +QIURC: 'incoming',,,,. The range of is 0–11. The type of this new incoming connection is 'TCP INCOMING' and the of 'TCP INCOMING' is the same as that of 'TCP LISTENER'. 2. If is 'UDP SERVICE', UDP data can be sent to or received from the remote IP via . ⚫ Send data: execute AT+QISEND=,,,. ⚫ Receive data in direct push mode: the module reports the URC +QIURC: 're cv',,,,. ⚫ Receive data in buffer access mode: the module reports the URC +QIURC: 'recv',[,], and then the received data can be retrieved with AT+QIRD=. 3. It is suggested to wait for 150 seconds for +QIOPEN: , to be outputted after BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 16 / 57 LPWA Module Series executing the Write Command. If the response cannot be received in 150 seconds, use AT+QICLOSE to close the socket. AT+QIOPEN Open a Socket Service Test Command AT+QIOPEN=? Response +QIOPEN: (range of supported s),(range of supported s),'TCP/UDP/TCP LISTENER/UDP SERVICE','/',(range of supported s),(range of supported s),(range of supported s) OK Write Command AT+QIOPEN=,,,/,[,[,]] Response If in transparent transmission mode (=2) and the service is opened successfully: CONNECT If there is any error: ERROR Error description can be got with AT+QIGETERROR. If in buffer access mode (=0) or direct push mode (=1): OK Maximum Response Time Characteristics +QIOPEN: , is 0 when the service is opened successfully. In other cases, is not 0. 150 seconds, determined by the network. / Parameter Integer type. Context ID. Range: 1–16. Integer type. Socket service index. Range: 0–11. String type. The socket service type. 'TCP' Start a TCP connection as a client 'UDP' Start a UDP connection as a client 'TCP LISTENER' Start a TCP server to listen for TCP incoming connections 'UDP SERVICE' Start a UDP service String type. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 17 / 57 LPWA Module Series If is 'TCP' or 'UDP', it indicates the IP address of remote server, such as '220.180.239.212'. If is 'TCP LISTENER' or 'UDP SERVICE', enter '127.0.0.1'. String type. Domain name address of the remote server. Maximum length: 256 bytes. Integer type. Port number of the remote server. Range: 0–65535. If is 'TCP' or 'UDP', this parameter must be specified. Range: 1– 65535. If is 'TCP LISTENER' or 'UDP SERVICE', specify this parameter as 0. Integer type. Local port number. Range: 0–65535. If is 'TCP LISTENER' or 'UDP SERVICE', this parameter must be specified. Range: 1–65535. If is 'TCP' or 'UDP', this parameter can be omitted and the default value is 0. The local port is assigned automatically if is 0. Otherwise the local port is assigned as specified. Integer type. Data access mode of the socket service. 0 Buffer access mode 1 Direct push mode 2 Transparent transmission mode Integer type. Result code. See Chapter 4 for details. NOTE 1. Only one socket service can be set to transparent transmission mode at a time. 2. If is 'TCP LISTENER', cannot be transparent transmission mode. When a remote client connects to this server, AT+QSWTMD can be used to switch the incoming connection to transparent transmission mode. 2.3.5. AT+QICLOSE Close a Socket Service This command closes a specified socket service. Depending on the network, it takes max. 10 seconds (default value, can be modified by ) to return OK or ERROR after executing AT+QICLOSE. Other AT commands can be executed only after the response is returned . AT+QICLOSE Close a Socket Service Test Command AT+QICLOSE=? Response +QICLOSE: (range of supported s),(range of supported s) Write Command OK Response BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 18 / 57 LPWA Module Series AT+QICLOSE=[,] OK Maximum Response Time Characteristics If the command failed to close the socket service: ERROR Determined by / Parameter Integer type. Socket service index. Range: 0–11. Integer type. Timeout value for the response to be outputted. If the FIN ACK of the other peer is not received within , the module will be forced to close the socket. Range: 0–65535. Default value: 10. Unit: second. 2.3.6. AT+QISTATE Query Socket Service Status This command queries the socket service status. If the is 0, it returns the status of all existing socket services in the specified context. If the is 1, it returns the status of a specified socket service. AT+QISTATE Query Socket Service Status Test Command AT+QISTATE=? Response OK Read/Execution Command AT+QISTATE? or AT+QISTATE Response Return the status of all existing connections: +QISTATE: ,,,< re mote _port>,,,,< se rv erID>,, […] OK Write Command If is 0, query the connection status of a specified context AT+QISTATE=, Response Return the status of all existing connections in a specified context: +QISTATE: ,,,< re mote _port>,,,,< se rv erID>,, […] OK BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 19 / 57 LPWA Module Series Write Command If is 1, query the connection status of a specified socket service AT+QISTATE=, Response +QISTATE: ,,,< re mote _port>,,,,< se rv erID>,, OK Maximum Response Time 300 ms Characteristics / Parameter Integer type. Query type. 0 Query connection status of all socket services in a specified context 1 Query connection status of a specified socket service Integer type. Context ID. Range: 1–16. Integer type. Socket service index. Range: 0–11. String type. Socket service type. 'TCP' Start a TCP connection as a client 'UDP' 'TCP LISTENER' Start a UDP connection as a client Start a TCP server to listen for TCP incoming connections 'TCP INCOMING' Start a TCP connection accepted by a TCP server 'UDP SERVICE' Start a UDP service String type. IP address. If is 'TCP' or 'UDP', it is the IP address of a remote server. If is 'TCP LISTENER' or 'UDP SERVICE', it is the local IP address. If is 'TCP INCOMING', it is the IP address of a remote client. Integer type. Remote port number. Range: 0–65535. If is 'TCP' or 'UDP', it is the port of a remote server. If is 'TCP LISTENER' or 'UDP SERVICE', the port is invalid. If is 'TCP INCOMING', it is the port of a remote client. Integer type. Local port number. Range: 0–65535. If is 0, then the local port is assigned automatically. Integer type. Socket service status. 0 'Initial': connection has not been established 1 'Opening': client is connecting or server is trying to listen 2 'Connected': client/incoming connection has been established 3 'Listening': server is listening 4 'Closing': connection is closing Integer type. Only valid when is 'TCP INCOMING'. represents the ID of the server that accepts this TCP incoming connection, and the value is the same as of 'TCP LISTENER'. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 20 / 57 Integer type. Data access mode. 0 Buffer access mode 1 Direct push mode 2 Transparent transmission mode String type. COM port of socket service. 'usbmodem' USB modem port 'uart1' UART1 port LPWA Module Series 2.3.7. AT+QISEND Send Data In buffer access mode (=0) or direct push mode (=1), the data can be sent with AT+QISEND. If the data have been sent to the module successfully, SEND OK is returned, otherwise SEND FAIL or ERROR is returned. ⚫ SEND FAIL indicates that the sending buffer is full. In this case, data can be resent. ⚫ ERROR indicates an error in the data sending process. In this case, wait for some time before you resend the data. ⚫ SEND OK means that the data have been sent to the peer, but it does not mean that they have reached the peer successfully. You can query whether the data have reached the peer with AT+QISEND=,0 . AT+QISEND Send Data Test Command AT+QISEND=? Response +QISEND: (range of supported s),(range of supported s) OK Write Command Send variable-length data when is 'TCP', 'UDP' or 'TCP INCOMING' AT+QISEND= Response > After the response >, input the data to be sent. Tap Ctrl+Z to send the data, and tap Esc to cancel the sending operation If the connection is established and the data is sent successfully: SEND OK If the connection is established but the sending buffer is full: SEND FAIL Write Command If the connection is not established, abnormally closed, or any parameter is incorrect: ERROR Response BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 21 / 57 LPWA Module Series Send fixed-length data when is 'TCP', 'UDP' or 'TCP INCOMING' AT+QISEND=, > After the response >, input the data until the data length equals If the connection is established and the data is sent successfully: SEND OK If the connection is established but the sending buffer is full: SEND FAIL If the connection is not established, abnormally closed, or any parameter is incorrect: ERROR Write Command When is 'UDP SERVICE' AT+QISEND=,,, Response Send fixed length data to specified remote IP address and remote port. The must be 'UDP SERVICE'. > After response >, type the data until the data length equals If the connection is established and the data is sent successfully: SEND OK If the connection is established but the sending buffer is full: SEND FAIL If the connection is not established, abnormally closed, or any parameter is incorrect: ERROR Write Command When is 0, query the sent data AT+QISEND=,0 Response If the specified exists: +QISEND: ,, OK Maximum Response Time If the specified does not exist, or there is any other error: ERROR 120 s, determined by network. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 22 / 57 LPWA Module Series Characteristics / Parameter Integer type. Socket service index. Range: 0–11. Integer type. Length of the data to be sent. Range: 0–1460. Unit: byte. String type. Remote IP address (must be dot format). Valid only when is 'UDP SERVICE'. Integer type. Remote port. Valid only when is 'UDP SERVICE'. Range: 0–65535. Integer type. Total length of sent data. Unit: byte. Integer type. Total length of acknowledged data. Unit: byte. Integer type. Total length of unacknowledged data. Unit: byte. 2.3.8. AT+QIRD Retrieve the Received TCP/IP Data In buffer access mode, after receiving data, the module buffers them and reports +QIURC: 'recv',[,], then the data can be retrieved with AT+QIRD. Please note that if the buffer is not empty, and the module receives data again, it does not report a new URC until all received data have been retrieved with AT+QIRD from the buffer. AT+QIRD Retrieve the Received TCP/IP Data Test Command AT+QIRD=? Response +QIRD: (range of supported s),(range of supported s) OK Write Command When is 'TCP', 'UDP' or 'TCP INCOMING' AT+QIRD=[,] Response If the specified connection has received the data: +QIRD: OK If there are no data: +QIRD: 0 OK If the connection does not exist: ERROR BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 23 / 57 LPWA Module Series Write Command When is 'UDP SERVICE' AT+QIRD= Response If data exist: +QIRD: ,, OK If there are no data: +QIRD: 0 OK If the connection does not exist: ERROR Write Command When is 0, query the retrieved data length AT+QIRD=,0 Response If the specified connection exists: +QIRD: ,, OK Maximum Response Time Characteristics If there is any error: ERROR 120 s, determined by network. / Parameter Integer type. Socket service index. Range: 0–11. Integer type. Maximum length of the data to be retrieved. Range: 0–1500. Default value: 1500. Unit: byte. Integer type. Length of actually retrieved data. Unit: byte. String type. Remote IP address. Valid only when is 'UDP SERVICE'. Integer type. Remote port number. Valid only when is 'UDP SERVICE'. Range: 0–65535. String type. Retrieved data. Integer type. Total length of received data. Unit: byte. Integer type. Length of the data that have been retrieved. Unit: byte. Integer type. Length of the data that have not been retrieved. Unit: byte. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 24 / 57 LPWA Module Series 2.3.9. AT+QISENDEX Send Hex String Data This command sends hex string data and cannot be applied for 'UDP SERVICE' and 'TCP LISTENER' sockets. AT+QISENDEX Send Hex String Data Test Command AT+QISENDEX=? Response +QISENDEX: (range of supported s),, (range of supported s) Write Command AT+QISENDEX=,< he x_string>[,] OK Response If the hex string is sent successfully: SEND OK If the sending buffer is full: SEND FAIL Maximum Response Time Characteristics If the connection does not exist: ERROR 120 s, determined by network. / Parameter Integer type. Socket service index. Range: 0–11. String type. Hex string data. Maximum length: 512 bytes. Integer type. RAI (Release Assistance Indication) information. 0 No RAI information available. 1 No further uplink or downlink data transmission. 2 Only a single downlink data transmission and no further uplink data transmission. NOTE 1. RAI (Release Assistance Indication) is introduced in 3GPP Release 14 and it is primarily a MAC layer feature. 2. The RAI feature is only applicable to NB-IoT RAT. This feature allows tracking the predictable nature of data traffic and requests for connection release when there are no additional data to be sent. It is essentially a ‘fast dormancy’ feature to save UE battery power. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 25 / 57 LPWA Module Series 2.3.10. AT+QISWTMD Switch Data Access Mode This command switches the data access mode among buffer access mode, direct push mode and transparent transmission mode. When starting a socket service, the data access mode can be specified via the of AT+QIOPEN. After opening a socket, the data access mode can be changed with AT+QISWTMD. AT+QISWTMD Switch Data Access Mode Test Command AT+QISWTM D=? Response +QISWTMD: (range of supported s),(range of supported s) OK Write Command AT+QISWTM D=, Response If is 0 or 1, and data access mode is switched successfully: OK If is 2 and data access mode is switched successfully, the module enters data mode (i.e. transparent transmission mode): CONNECT Maximum Response Time Characteristics If there is any error: ERROR 300 ms / Parameter Integer type. Socket service index. Range: 0–11. Integer type. Data access modes of the connection. 0 Buffer access mode 1 Direct push mode 2 Transparent transmission mode 2.3.11. AT+QPING Ping a Remote Host This command tests the reachability of a host on an Internet protocol network. Before using the ping utility, the host should activate the context of the corresponding with AT+QIACT. The command returns the result within . BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 26 / 57 LPWA Module Series AT+QPING Ping a Remote Host Test Command AT+QPING=? Response +QPING: (range of supported s),,(range of supported s),(range of supported s) Write Command AT+QPING=,[,[,]] OK Response If a remote host is pinged successfully: OK +QPING: [,,,,< TTL>] […] +QPING: [,,,,, < ma x>,] Maximum Response Time Characteristics If there is any error: ERROR 300 s / Parameter Integer type. Context ID. Range: 1–16. String type. Host address. It is a domain name or a dotted decimal IP address. Integer type. Maximum time to wait for the response of each ping request. Range: 1–255. Default value: 4. Unit: second. Integer type. Maximum number of ping requests. Range: 1–10. Default value: 4. Integer type. Result of each ping request. 0 Received the ping response from the host. In this case, it is Others followed by ,,,,. See Chapter 4 for specific result codes. String type. IP address of the remote host in dotted-decimal notation. Integer type. Length of each sent ping request. Unit: byte. Integer type. Time wait for the response of the ping request. Unit: ms. Integer type. Time to live value of the response packet for the ping request. Integer type. The final result of the command. 0 Pinged successfully. It is successful to activate the context and find BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 27 / 57 LPWA Module Series the host. In this case, it is followed by ,,,,,, . Others See Chapter 4 for specific result codes. Integer type. Total number of the ping requests that have been sent. Integer type. Total number of the ping requests that have received responses. Integer type. Total number of the ping requests that are time out. Integer type. Minimum response time. Unit: ms. Integer type. Maximum response time. Unit: ms. Integer type. Average response time. Unit: ms. 2.3.12. AT+QNTP Synchronize Local Time with NTP Server This command synchronizes the local time with the Universal Time Coordinated (UTC) through the NTP server. Before time synchronization, the host should activate the context corresponding to with AT+QIACT. AT+QNTP Synchronize Local Time with NTP Server Test Command AT+QNTP=? Response +QNTP: (range of supported s),,(range of supported s),(list of supported s) Read Command AT+QNTP? OK Response If in the process of local time synchronization: +QNTP: , Write Command AT+QNTP=, [,[,]] OK Response If the local time is synchronized with NTP server successfully: OK +QNTP: , Maximum Response Time Characteristics If there is any error: ERROR 125 s, determined by the network. The command takes effect immediately (actually determined by network). The configuration is not saved. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 28 / 57 LPWA Module Series Parameter Integer type. Context ID. Range: 1–16. String type. NTP server address. Integer type. NTP server port number. Range: 1–65535. Default value: 123. Integer type. Whether to automatically set synchronized time as local time. 0 Not set 1 Set Integer type. Result code. See Chapter 4 for details. String type. Time synchronized with NTP server. The format is 'YYYY/MM/DD,hh:mm:sszz'. Range of 'zz': -48 to 56. 2.3.13. AT+QIDNSCFG Configure Address of DNS Server Before setting the DNS server address, the host must activate the context of corresponding with AT+QIACT. AT+QIDNSCFG Configure Address of DNS Server Test Command AT+QIDNSCFG=? Response +QIDNSCFG: (range of supported s),, OK Write Command Response AT+QIDNSCFG=[,[,]] server addresses of a specified PDP context: +QIDNSCFG: ,, OK Maximum Response Time Characteristics If any of the parameters is specified, configure the primary and secondary DNS server addresses of a specified PDP context: OK Or ERROR 300 ms The command takes effect immediately. The configurations will not be saved. Parameter Integer type. PDP context ID. Range: 1–16. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 29 / 57 String type. Primary DNS server address. String type. Secondary DNS server address. LPWA Module Series 2.3.14. AT+QIDNSGIP Get IP Address by Domain Name This commands gets an IP address by domain name. Before querying the DNS, the host should activate the context of corresponding with AT+QIACT. .AT+QIDNSGIP Get IP Address by Domain Name Test Command AT+QIDNSGIP=? Response +QIDNSGIP: (range of supported s), Write Command AT+QIDNSGIP=, OK Response OK +QIURC: 'dnsgip',,, [..... +QIURC: 'dnsgip',] Maximum Response Time Characteristics If there is any error: ERROR 60 s, determined by the network. / Parameter Integer type. Context ID. Range: 1–16. String type. Domain name. Integer type. Result code of the operation. See Chapter 4 for details. Integer type. Number of the IP addresses corresponding to the . Integer type. Time to live of the DNS. String type. IP address of . 2.3.15. AT+QICFG Configure Optional Parameters This command configures optional parameters. AT+QICFG Configure Optional Parameters Test Command AT+QICFG=? Response +QICFG: 'transpktsize',(range of supported s) BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 30 / 57 LPWA Module Series +QICFG: 'transwaittm',(range of supported s) +QICFG: 'dataformat',(list of supported s),(list of supported s) +QICFG: 'viewmode',(list of supported s) +QICFG: 'recvind',(list of supported s) +QICFG: 'sack',(list of supported s) +QICFG: 'tcp/inactivetm',(range of supported s) +QICFG: 'tcp/keepalive',(list of supported s),(range of supported s),(range of supported s),(range of supported >s) +QICFG: 'tcp/retranscfg',(range of supported s),(range of supported s) +QICFG: 'ipv6prior',(list of supported s) +QICFG: 'asyncmode',(list of supported s) Write Command Query/set the packet size for transparent transmission mode AT+QICFG='transpktsize '[,] OK Response If the optional parameter is omitted, query the current setting: +QICFG: 'transpktsize', OK Write Command Query/set the waiting time for transparent transmission mode AT+QICFG='transwaittm'[,] If the optional parameter is specified, set the packet size for transparent transmission mode: OK Or ERROR Response If the optional parameter is omitted, query the current setting: +QICFG: 'transwaittm', OK Write Command Query/set the format of the data to be sent and received (only for buffer access mode and direct push mode) AT+QICFG='dataformat'[,<send If the optional parameter is specified, set the waiting time for transparent transmission mode: OK Or ERROR Response If the optional parameter is omitted, query the current setting: +QICFG: 'dataformat',, OK BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 31 / 57 LPWA Module Series _data_format>,] If the optional parameter is specified, set the format for the data to be sent and received: OK Or ERROR Write Command Response Query/set the output format of If the optional parameter is omitted, query the current setting: received data (only for non- +QICFG: 'viewmode', transparent mode) AT+QICFG='viewmode'[,] If the optional parameter is specified, set the output format of received data: OK Or ERROR Write Command Response Query/set the URC format in buffer If the optional parameter is omitted, query the current setting: access mode. +QICFG: 'recvind', AT+QICFG='re cv ind',[ ] OK Write Command Query/set whether to enable SACK option in TCP header. AT+QICFG='sack',[] If the optional parameter is specified, set the URC format in buffer access mode: OK Or ERROR Response If the optional parameter is omitted, query the current setting: +QICFG: 'sack', OK Write Command Query/set the TCP idle time. AT+QICFG='tcp/inactiv etm'[,] If the optional parameter is specified, configure whether to enable SACK option in TCP header: OK Or ERROR Response If the optional parameter is omitted, query the current setting: +QICFG: 'tcp/inactivetm', OK BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 32 / 57 LPWA Module Series If the optional parameter is specified, set TCP idle time: OK If there is any error: ERROR Write Command Response Query/set whether to enable TCP If the optional parameters are omitted, query the current setting: keepalive feature and the relevant +QICFG: 'tcp/keepalive',,,, AT+QICFG='tcp/ke e palive '[,[,,,]] OK If any of the optional parameter is specified, set whether to enable TCP keepalive feature and the relevant parameter values: OK Or ERROR Write Command Response Query/set the maximum interval If the optional parameters are omitted, query the current setting: time and number of TCP +QICFG: 'tcp/retranscfg',, retransmission AT+QICFG='tcp/retranscfg'[,,] If the optional parameters are specified, set the maximum interval and the number of TCP retransmission: OK Or ERROR Write Command Response Query/set the prior PDP type when If the optional parameter is omitted, query the current setting: the APN profile is IPv4v6 +QICFG: 'ipv6prior', AT+QICFG='ipv 6prior'[,] OK If the optional parameter is specified, set the prior PDP type when the APN profile is IPv4v6 OK If there is any error: ERROR Write Command Response Query/set the execution mode of If the optional parameter is omitted, query the current setting: AT+QIACT +QICFG: 'asyncmode', AT+QICFG='asyncmode '[,] OK BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 33 / 57 LPWA Module Series Maximum Response Time Characteristics If the optional parameter is specified, set the execution mode of AT+QIACT: OK If there is any error: ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Maximum length of the data packet to be sent. Range: 1–1460. Default value: 1024. Unit: byte. Integer type. In transparent transmission mode, if the length of data received from the port is less than the specified value of , after exceeding the time specified by , the data will be sent directly. Range: 0–20. Default value: 2. Unit: 100 ms. Integer type. Format of the data to be sent. 0 Text mode 1 Hex mode Integer type. Format of the data to be received. 0 Text mode 1 Hex mode Integer type. Output format of received data. 0 Output format of received data: data headerrndata. 1 Output format of received data: data header,data. Integer type. URC format. 0 URC format without data length. URC format is +QIURC: 'recv',. 1 URC format with data length. URC format is +QIURC: 'recv',,. Integer type. Whether to enable SACK option in TCP header. 0 Disable 1 Enable Integer type. TCP idle time. 0 Disable TCP idle timeout 1–65535 Idle timeout. Unit: seconds Integer type. Whether to enable TCP keepalive feature. When it is 0, , and should be ignored. 0 Disable 1 Enable BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 34 / 57 LPWA Module Series Integer type. Default keepalive time. Range: 1–120. Unit: minute. Integer type. Interval between keepalive probes. Range: 25–100. Unit: second. Integer type. Maximum number of keepalive probes. Range: 3–10. Integer type. Maximum number of TCP retransmissions. Range: 3–20. Default value: 12. Integer type. Maximum interval between TCP retransmissions. Range: 5–1000. Default value: 600. Unit: 100 ms. Integer type. The prior PDP type to be set when the APN profile is IPv4v6. 0 IPv4 1 IPv6 Integer type. Execution mode of AT+QIACT. In different execution modes, the maximum response time of AT+QIACT varies. In synchronous mode, the maximum response time is 150 s and determined by the network, while in synchronous mode, the response is returned immediately after command execution. 0 Synchronous mode 1 Asynchronous mode NOTE 1. Settings of AT+QICFG='tcp/keepalive',,,, and AT+QICFG='tcp/retranscfg',, take effect to all TCP sockets. 2. Settings of AT+QICFG='tcp/inactivetm' take effect to socket type of 'TCP', 'TCP INCOMING' and 'SSLClient'. For more information on 'SSLClient', see document [2]. 2.3.16. AT+QISDE Control Whether to Echo the Data for AT+QISEND This command controls whether to echo the data for AT+QISEND. AT+QISDE Control Whether to Echo the Data for AT+QISEND Test Command AT+QISDE=? Response +QISDE: (list of supported s) Read Command AT+QISDE? OK Response +QISDE: Write Command AT+QISDE= OK Response OK Or ERROR BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 35 / 57 LPWA Module Series Maximum Response Time Characteristics 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. Whether to echo the data for AT+QISEND. 0 Do not echo the data 1 Echo the data 2.3.17. AT+QIGETERROR Query the Last Result Code If is returned after executing TCP/IP commands, the detailed information about a result code can be queried with AT+QIGETERROR. Please note that AT+QIGETERROR just returns the result code of the last TCP/IP AT command. AT+QIGETERROR Query the Last Result Code Test command AT+QIGETERROR=? Execution Command AT+QIGETERROR Response OK Response +QIGETERROR: , Maximum Response Time Characteristics OK 300 ms / Parameter Integer type. Result code. See Chapter 4 for details. String type. Result code description. See Chapter 4 for details. 2.4. Description of URCs The URC of TCP/IP AT commands will be reported to the host in the format that begins with +QIURC:. It contains the reports about incoming data, closed connection and incoming connection and so on. Actually, there is both before and after URC, but is not presented intentionally. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 36 / 57 LPWA Module Series 2.4.1. +QIURC: 'closed' Indicate Connection Closed When the TCP socket service is closed by a remote peer or due to a network error, the URC is outputted, and the status of the socket service is 'closing' (=4). AT+QICLOSE= can be used to change the to 'initial'. +QIURC: 'closed' Indicate Connection Closed +QIURC: 'closed', Socket service connection is closed. Parameter Integer type. Socket service index. Range: 0–11. 2.4.2. +QIURC: 'recv' Indicate Incoming Data In buffer access mode or direct push mode, after receiving data, the module reports a URC to the host. In buffer access mode, after receiving data, the module reports +QIURC: 'recv',[,] to notify the host. The host can then retrieve data with AT+QIRD. Please note that if the buffer is not empty, and the module receives data again, it does not report a new URC until all the received data have been retrieved with AT+QIRD from the buffer. In direct push mode, the received data is outputted to COM port directly. +QIURC: 'recv' Indicate Incoming Data +QIURC: 'recv',[,] retrieve data with AT+QIRD. +QIURC: 'recv',, is 'TCP', 'UDP' or 'TCP INCOMING'. +QIURC: 'recv',,,,<remote_ is 'UDP SERVICE'. port> Parameter Integer type. Socket service index. Range: 0–11. Integer type. Data length. Unit: byte. Integer type. Length of actually received data. String type. Remote IP address. Integer type. Remote port number. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 37 / 57 String type. Received data. LPWA Module Series 2.4.3. +QIURC: 'incoming full' Indicate Incoming Connection Reaches the Limit If the number of incoming connections reaches the limit, or no socket system resources can be allocated, the module reports +QIURC: 'incoming full' for the new incoming connection request. +QIURC: 'incoming full' Indicate Incoming Connection Reaches the Limit +QIURC: 'incoming full' Indicates that the number of incoming connections has reached the limit. 2.4.4. +QIURC: 'incoming' Indicate Incoming Connection If is 'TCP LISTENER', when a remote client connects to this server, the host automatically assigns a free to the new connection, and the range of is 0–11. In this case, the module reports +QIURC: 'incoming'. The of the new connection will be 'TCP INCOMING', and the will be buffer access mode. +QIURC: 'incoming' Indicate Incoming Connection +QIURC: 'incoming',,<s When the new incoming connection is accepted by , erverID>,, the allocated , and are informed by this URC. Parameter Integer type. Index of the socket service assigned to the incoming connection, which is automatically specified by the module. Range: 0–11. Integer type. ID of the listening socket whose is 'TCP LISTENER' and which accepts the incoming . String type. Remote IP address of the incoming . Integer type. Remote port number of the incoming . 2.4.5. +QIURC: 'pdpdeact' Indicate PDP Deactivation PDP context may be deactivated by the network. The module report s this URC to the host about PDP deactivation. In this case, the host must execute AT+QIDEACT to deactivate the context and reset all connections. +QIURC: 'pdpdeact' Indicate PDP Deactivation +QIURC: 'pdpdeact', context is deactivated. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 38 / 57 Parameter Integer type. Context ID. Range: 1–16. LPWA Module Series BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 39 / 57 LPWA Module Series 3 Examples 3.1. Configure and Activate a Context 3.1.1. Configure a Context AT+QICSGP=1,1,'CM NBIOT','','',1 OK //Configure context 1. China Mobile NB-IoT network APN: CMNBIOT. 3.1.2. Activate a Context AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK //Activate context 1. Depending on the network, the maximum response time is 150 s. //Activated the context successfully. //Query the context state, protocol type and IP address of context 1. 3.1.3. Deactivate a Context AT+QIDEACT=1 OK //Deactivate context 1. //Deactivated the context successfully. Depending on the network, the maximum response time is 40 s. 3.2. TCP Client Works in Buffer Access Mode under IPv4 3.2.1. Set up a TCP Client Connection and Enter Buffer Access Mode //Context is 1 and is 0. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,0 BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 40 / 57 LPWA Module Series OK +QIOPEN: 0,0 //TCP client connected successfully. It is suggested to wait for 150 seconds for the URC +QIOPEN: ,. If the URC cannot be received in 150 seconds, the host could use AT+QICLOSE to close the socket. AT+QISTATE=1,0 //Query connection status of socket service 1. +QISTATE: 0,'TCP','220.180.239.212',8009,65514,2,1,0,0,'usbmodem' OK 3.2.2. Send Data in Buffer Access Mode AT+QISEND=0 >te st1 SEND OK AT+QISEND=0,4 >te st SEND OK AT+QISEND=0,0 +QISEND: 9,9,0 //Send variable-length data. //SEND OK does not mean the data have reached the server successfully. The host can query whether the data has reached the server with AT+QISEND=0,0. //Send fixed-length data and the data length is 4 bytes. //Query the length of sent data, acknowledged data and unacknowledged data. //A total of 9 bytes of data have been sent, and the 9 bytes of data have been acknowledged by the server. OK AT+QISENDEX=0,'3132333435' SEND OK AT+QISEND=0,0 //Send Hex string data. //Query the length of sent data, acknowledged data and unacknowledged data. +QISEND: 14,14,0 OK 3.2.3. Retrieve Data from Remote Server in Buffer Access Mode +QIURC: 'recv',0 AT+QIRD=0,1500 +QIRD: 5 //The 0 has received data. //Retrieve the data, and the maximum length of data to be retrieved is 1500 bytes. //The length of actually retrieved data is 5 bytes. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 41 / 57 LPWA Module Series te st1 OK AT+QIRD=0,1500 +QIRD: 0 OK AT+QIRD=0,0 +QIRD: 5,5,0 OK //No data in buffer. //Query the total length of received data, including read and unread data. 3.2.4. Close a Connection AT+QICLOSE=0 OK //Close a connection whose is 0. Depending on the network, the maximum response time is 10 s by default. 3.3. TCP Client Works in Buffer Access Mode under IPv6 3.3.1. Set up a TCP Client Connection and Enter Buffer Access Mode //Context is 1 and is 0. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,0,'TCP','2001:468:2100:1:0:0:0:0',5001,0,0 OK +QIOPEN: 0,0 //TCP client is connected successfully. It is suggested to wait for 150 seconds for the URC +QIOPEN: ,. If the URC cannot be received in 150 seconds, the host can use AT+QICLOSE to close the socket. AT+QISTATE=1,0 //Query the connection status of socket service 1. +QISTATE: 0,'TCP','2001:468:2100:1:0:0:0:0',5001,11921,2,1,0,0,'usbmodem' OK 3.3.2. Send Data in Buffer Access Mode AT+QISEND=0 >te st1 SEND OK //Send variable-length data. //SEND OK does not mean the data have reached the server BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 42 / 57 LPWA Module Series AT+QISEND=0,4 >te st SEND OK AT+QISEND=0,0 +QISEND: 9,9,0 successfully. The host can query whether the data have reached the server with AT+QISEND=0,0. //Send fixed-length data and the data length is 4 bytes. //Query the length of sent data, acknowledged data and unacknowledged data. //A total of 9 bytes of data have been sent, and the 9 bytes of data have been acknowledged by the server. OK AT+QISENDEX=0,'3132333435' //Send Hex string data. SEND OK AT+QISEND=0,0 //Query the length of sent data, acknowledged data and unacknowledged data. +QISEND: 14,14,0 OK 3.3.3. Receive Data from Remote Server in Buffer Access Mode +QIURC: 'recv',0 AT+QIRD=0,1500 +QIRD: 5 te st1 // 0 has received data. //Retrieve the data. The maximum length of data to be retrieved is 1500 bytes. //The length of actually retrieved data is 5 bytes. OK AT+QIRD=0,1500 +QIRD: 0 //No data in buffer. OK AT+QIRD=0,0 +QIRD: 5,5,0 //Query the total length of received data, including read and unread d ata. OK 3.3.4. Close a Connection AT+QICLOSE=0 OK //Close a connection whose is 0. Depending on the network, the maximum response time is 10 seconds by default. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 43 / 57 LPWA Module Series 3.4. TCP Client Works in Transparent Transmission Mode 3.4.1. Set up a TCP Client Connection and Enter Transparent Transmission Mode //Context is 1 and is 0. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,2 CONNECT //TCP client connected successfully. It is suggested to wait for 150 seconds for the URC CONNECT. If the URC cannot be received in 150 seconds, the host could use AT+QICLOSE to close the socket. 3.4.2. Send Data in Transparent Transmission Mode 3.4.3. Retrieve Data from Remote Server in Transparent Transmission Mode Test 1 //All data received from the Internet are outputted via the COM port directly. 3.4.4. Close a TCP Client AT+QICLOSE=0 OK //After using +++ to exit from the transparent transmission mode, the host could use AT+QICLOSE to close the TCP link. Depending on the network, the maximum response time is 10 seconds by default. 3.5. TCP Client Works in Direct Push Mode 3.5.1. Set up a TCP Client Connection and Enter Direct Push Mode //Context is 1 and is 0. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,1 OK BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 44 / 57 LPWA Module Series +QIOPEN: 0,0 //TCP client connected successfully. It is suggested to wait for 150 seconds for the URC +QIOPEN: ,. If the URC cannot be received in 150 seconds, the host could use AT+QICLOSE to close the socket. AT+QISTATE=1,0 //Query the connection state of socket service 0. +QISTATE: 0,'TCP','220.180.239.212',8009,65344,2,1,0,1,'usbmodem' OK 3.5.2. Send Data in Direct Push Mode AT+QISEND=0 >te st1 SEND OK AT+QISEND=0,5 >te st2 SEND OK AT+QISEND=0,0 +QISEND: 10,10,0 //Send variable-length data. //SEND OK does not mean the data have reached the server successfully. The host can query whether the data has reached the server with AT+QISEND=0,0. //Send fixed-length data and the data length is 5 bytes. //Query the length of sent data, acknowledged data and unacknowledged data. //A total of 10 bytes of data have been sent, and all the 10 bytes of data have been acknowledged. OK 3.5.3. Retrieve Data from Remote Server in Direct Push Mode +QIURC: 'recv',0,4 te st //Retrieve data from remote server. 3.5.4. Close a TCP Client AT+QICLOSE=0 OK //Close the connection whose is 0. Depending on the network, the maximum response time is 10 seconds by default. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 45 / 57 LPWA Module Series 3.6. TCP Server Works in Buffer Access Mode under IPv4 Network 3.6.1. Start a TCP Server //Context is 1 and is 1. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,1,'TCP LISTENER','127.0.0.1',0,2020,0 OK +QIOPEN: 1,0 //TCP server is opened successfully. AT+QISTATE=0,1 //Query the connection status of context 1. +QISTATE: 1,'TCP LISTENER','10.7.157.1',0,2020,3,1,1,0,'usbmodem' OK 3.6.2. Accept TCP Incoming Connection +QIURC: 'incoming',11,1,'172.31.242.222',54091 //A new TCP connection is accepted. The is 'TCP incoming', and is 11. 3.6.3. Retrieve Data from Incoming Connection +QIURC: 'recv',11 AT+QIRD=11,1500 +QIRD: 4 te st OK AT+QIRD=11,1500 +QIRD: 0 OK AT+QIRD=11,0 +QIRD: 4,4,0 OK //Received data from remote incoming connection. //Retrieve the data received from incoming connection. //Length of actually retrieved data is 4 bytes. //No data in buffer. //Query the total length of received data, including read and unread data. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 46 / 57 3.6.4. Close a TCP Server AT+QICLOSE=11 OK AT+QICLOSE=1 OK LPWA Module Series //Close the incoming connection. Depending on the network, the maximum response time is 10 seconds by default. //Close the listening TCP server. 3.7. TCP Server Works in Buffer Access Mode under IPv6 Network 3.7.1. Start a TCP Server //Context is 1 and is 1. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,1,'TCP LISTENER','0:0:0:0:0:0:0:1',0,12345,0 OK +QIOPEN: 1,0 //TCP server is opened successfully. AT+QISTATE=0,1 //Query the connection status of context 1. +QISTATE: 1,'TCP LISTENER','2001:468:2100:1:2001:468:2100:1',0,12345,3,1,1,0,'usbmodem' OK 3.7.2. Accept TCP Incoming Connection +QIURC: 'incoming',11,1,'2001:468:2100:1:0:0:0:0',54091 //A new TCP connection is accepted. The is 'TCP incoming', and is 11. 3.7.3. Retrieve Data from Incoming Connection +QIURC: 'recv',11 AT+QIRD=11,1500 +QIRD: 4 te st OK AT+QIRD=11,1500 +QIRD: 0 //Received data from remote incoming connection. //Retrieve the data received from incoming connection. //Length of actually retrieved data is 4 bytes. //No data in buffer. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 47 / 57 LPWA Module Series OK AT+QIRD=11,0 +QIRD: 4,4,0 OK //Query the total length of received data, including read and unread data. 3.7.4. Switch Incoming Connection to Transparent Transmission Mode AT+QSWTM D=11,2 CONNECT 1234567890 +++ OK //Switch the incoming connection whose socket service index is 11 to transparent transmission mode. //Send data directly. //Exit transparent transmission mode. 3.7.5. Close a TCP Server AT+QICLOSE=11 OK AT+QICLOSE=1 OK //Close the incoming connection. Depending on the network, the maximum response time is 10 seconds by default. //Close the listening TCP server. 3.8. UDP Service under IPv4 Network 3.8.1. Start a UDP Service //Start a UDP service whose is 2 and is 1. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,2,'UDP SERVICE','127.0.0.1',0,3030,0 OK +QIOPEN: 2,0 //UDP service is opened successfully. AT+QISTATE=0,1 //Query the connection status of context 1. +QISTATE: 2,'UDP SERVICE','10.7.157.1',0,3030,2,1,2,0,'usbmodem' OK BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 48 / 57 LPWA Module Series 3.8.2. Send UDP Data to Remote Client AT+QISEND=2,10,'10.7.89.10',6969 >1234567890 SEND OK //Send 10 bytes of data to a remote client whose IP is 10.7.89.10 and the remote port is 6969. 3.8.3. Retrieve Data from Remote Client +QIURC: 'recv',2 AT+QIRD=2 +QIRD: 4,'10.7.76.34',7687 AAAA //Data received from the remote client. //Retrieve UDP data. One whole UDP packet will be outputted. There is no need to specify the read length. //The retrieved data length is 4 bytes. The IP address of the remote client is 10.7.76.34 and the port is 7687. OK AT+QIRD=2 +QIRD: 0 //Retrieve data. //No data in buffer. OK AT+QISEND=2,10,'10.7.76.34',7687 >1234567890 SEND OK //Send data to the remote client whose IP is 10.7.76.34 and the port is 7687. 3.8.4. Close a UDP Service AT+QICLOSE=2 OK //Close the service. 3.9. UDP Service under IPv6 Network 3.9.1. Start a UDP Service //Start a UDP service whose is 2 and is 1. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,2,'UDP SERVICE','0:0:0:0:0:0:0:1',0,12345,0 OK BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 49 / 57 LPWA Module Series +QIOPEN: 2,0 //UDP service is opened successfully. AT+QISTATE=0,1 //Query the connection status of context 1. +QISTATE: 2,'UDP SERVICE','2001:468:2100:1:2001:468:2100:1',0,12345,2,1,2,0,'usbmodem' OK 3.9.2. Send UDP Data to Remote Client AT+QISEND=2,10,'2001:468:2100:1:0:0:0:0',5001 >1234567890 SEND OK //Send 10 bytes of data to a remote client whose IP is 2001:468:2100:1:0:0:0:0 and the port is 5001. 3.9.3. Retrieve Data from Remote Client +QIURC: 'recv',2 AT+QIRD=2 +QIRD: 4,'2001:468:2100:1:0:0:0:0',5001 AAAA //Received data from the remote client. //Retrieve UDP data. One whole UDP packet will be outputted. There is no need to specify the read length. //The retrieved data length is 4 bytes. The IP address of the remote client is 2001:468:2100:1:0:0:0:0 and the port is 5001. OK AT+QIRD=2 +QIRD: 0 //Retrieve data. //No data in buffer. OK 3.9.4. Close a UDP Service AT+QICLOSE=2 OK //Close the service. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 50 / 57 LPWA Module Series 3.10. UDP Client with RAI Feature 3.10.1. Start a UDP Client //Start a UDP client whose is 0 and is 1. Before using AT+QIOPEN, the host should activate the context with AT+QIACT. AT+QIOPEN=1,0,'UDP','220.180.239.212',8009 OK 3.10.2. Send UDP Data with RAI Information AT+QCSCON=1 OK AT+QISENDEX=0,'313233',0 SEND OK //18:48:14:649 +QCSCON: 1,1 //18:48:35:790 +QCSCON: 1,0 AT+QISENDEX=0,'313233',1 SEND OK //18:51:59:905 +QCSCON: 1,1 //18:52:01:135 +QCSCON: 1,0 AT+QISENDEX=0,'313233',2 SEND OK //19:00:28:037 +QCSCON: 1,1 //19:00:35:115 +QIURC: 'recv',0 //19:00:35:264 +QCSCON: 1,0 //Enable RRC state reported via URC. //Send '123' without RAI information. //RRC connection set up successfully. //After 20 s, RRC connection is released. //Send '123' and release RRC connection right away. //RRC connection set up successfully. //Within 1 s, RRC connection is released. //Send '123' and release RRC connection after receiving a packet of downlink data. //RRC connection set up successfully. //Receive a packet of downlink data from peer. //After receiving downlink data, RRC state became idle. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 51 / 57 3.10.3. Close a UDP Client AT+QICLOSE=0 OK //Close the client. LPWA Module Series 3.11. PING 3.11.1. PING under IPv4 AT+QPING=1,'www.baidu.com' OK +QPING: 0,'61.135.169.125',32,192,255 +QPING: 0,'61.135.169.125',32,240,255 +QPING: 0,'61.135.169.125',32,241,255 +QPING: 0,'61.135.169.125',32,479,255 +QPING: 0,4,4,0,192,479,287 //Ping www.baidu.com in context 1. Before pinging the destination IP address, the host should activate the context with AT+QIACT. 3.11.2. PING under IPv6 AT+QPING=1,'2001:468:2100:1:0:0:0:0' OK //Ping 2001:468:2100:1:0:0:0:0 in context 1. Before pinging the destination IP address, the host should activate the context with AT+QIACT. +QPING: 0,'2001:468:2100:1:0:0:0:0',32,58,255 +QPING: 0,'2001:468:2100:1:0:0:0:0',32,49,255 +QPING: 0,'2001:468:2100:1:0:0:0:0',32,39,255 +QPING: 0,'2001:468:2100:1:0:0:0:0',32,40,255 +QPING: 0,4,4,0,39,58,46 BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 52 / 57 3.12. Synchronize Local Time AT+QNTP=1,'202.120.2.101',123 OK +QNTP: 0,'2013/08/19,11:10:10+32' AT+CCLK? +CCLK: '13/08/19,11:10:57+32' OK LPWA Module Series //Synchronize local time with NTP server '202.120.2.101:123'. Before synchronizing the time, the host should activate the context with AT+QIACT. 3.13. Getting the Last Error Code AT+QIOPEN=1,'TCP','220.180.239.212',8009,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552, invalid parameters OK //Start a socket service but and is not present. BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 53 / 57 LPWA Module Series 4 Summary of Result Codes If is returned after executing TCP/IP AT commands, the detailed information about result codes can be queried with AT+QIGETERROR. Please note that AT+QIGETERROR just returns the result code of the last TCP/IP AT command. Table 2: Summary of Result Codes 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 operate successfully unknown error operation blocked invalid parameters Memory allocation failed create socket failed operation not supported socket bind failed socket listen failed socket write failed socket read failed socket accept failed Activate pdp context failed Deactivate pdp context failed socket identity has been used dns busy BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 54 / 57 565 dns failed 566 socket connect failed 567 connection reset 568 operation busy 569 operation timeout 570 pdp context deactivated 571 user cancel send 572 operation not allowed 573 port busy 574 pdp has been actived LPWA Module Series BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 55 / 57 LPWA Module Series 5 Appendix References Table 3: Related Documents Document Name [1] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual [2] Quectel_BG95&BG77&BG600L_Series_SSL_Application_Note Table 4: Terms and Abbreviations Abbre v iation 3GPP ACK APN CHAP DNS FIN ID IP IPv4 IPv6 LPWA LTE NB-IoT NTP De scription 3rd Generation Partnership Project Acknowledge Access Point Name Challenge Handshake Authentication Protocol Domain Name System Finish Identify Internet Protocol Internet Protocol Version 4 Internet Protocol Version 6 Low Power Wide Area Long-Term Evolution Narrowband Internet of Things Network Time Protocol BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 56 / 57 NVM PAP PDP PPP SACK TCP UART UDP URC USB UTC Non-Volatile Memory Password Authentication Protocol l Packet Data Protocol Point-to-Point Protocol Selective Acknowledgment Transmission Control Protocol Universal Asynchronous Receiver & Transmitter User Datagram Protocol Unsolicited Result Code Universal Serial Bus Coordinated Universal Time LPWA Module Series BG95&BG77&BG600L_Se ries _TCP/IP_Application_Note 57 / 57

BC35-G&BC28&BC95 R2.0 应用设计指导 NB-IoT 模块系列 版本：BC35-G&BC28&BC95 R2.0_应用设计指导_V1.2 日期：2019-09-12 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0 应用设计指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 文档历史 修订记录 版本 日期 1.0 2018-06-14 1.1 2018-07-03 1.2 2019-09-12 作者 吴丁园/ 王成钧 吴丁园/ 王成钧 王成钧 变更表述 初始版本 更新 DFOTA 升级过程关于固件升级状态的信息上报提示 1. 更新文档名称为 Quectel_BC35-G&BC28&BC95 R2.0_应用设 计指导； 2. 更新 BC95 相关信息为 BC95 R2.0； 3. 增加参考文档，更新原有参考文档名称； 4. 新增章节 3 模块入网流程； 5. 新增章节 4 模省电模式； 6. 添加章节 5.2 终端整机设计建议。 上海移远通信技术股份有限公司 2 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 终端应用设计指导 ................................................................................................................................. 7 2.1. 固定上报类 ................................................................................................................................. 7 2.1.1. 网络参数配置要求 ........................................................................................................... 7 2.1.2. 终端设计建议................................................................................................................... 7 2.1.3. 终端设计参考流程 ........................................................................................................... 9 2.2. 固定控制类 ............................................................................................................................... 10 2.2.1. 网络参数配置要求 ......................................................................................................... 10 2.2.2. 终端设计建议................................................................................................................. 10 2.2.3. 终端设计参考流程 ......................................................................................................... 12 2.3. 移动上报类 ............................................................................................................................... 13 2.3.1. 网络参数配置要求 ......................................................................................................... 13 2.3.2. 终端设计建议................................................................................................................. 13 2.3.3. 终端设计参考流程 ......................................................................................................... 15 2.4. 移动控制类 ............................................................................................................................... 16 2.4.1. 网络参数配置要求 ......................................................................................................... 16 2.4.2. 终端设计建议................................................................................................................. 16 2.4.3. 终端设计参考流程 ......................................................................................................... 18 3 模块入网流程....................................................................................................................................... 19 3.1. 自动入网模式............................................................................................................................ 20 3.2. 手动入网模式............................................................................................................................ 21 4 模块 PSM 模式 .................................................................................................................................... 22 4.1. 3GPP 协议策略唤醒 ................................................................................................................. 22 4.2. 业务数据的相关策略唤醒 ......................................................................................................... 22 4.3. 运营商自注册逻辑唤醒 ............................................................................................................. 22 5 补充说明 .............................................................................................................................................. 23 5.1. 常规维护测试手段 .................................................................................................................... 23 5.2. 终端整机设计建议 .................................................................................................................... 23 5.3. 相关 AT 命令说明 ..................................................................................................................... 23 6 附录 A 参考文档及术语缩写............................................................................................................... 25 上海移远通信技术股份有限公司 3 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 表格索引 表 1：固定上报类终端应用网络参数配置要求 ..................................................................................................... 7 表 2：固定上报类终端应用设计参考项 ................................................................................................................ 7 表 3：固定控制类终端应用网络参数配置要求 ................................................................................................... 10 表 4：固定控制类终端应用设计参考项 .............................................................................................................. 10 表 5：移动上报类终端应用网络参数配置要求 ................................................................................................... 13 表 6：移动上报类终端应用设计参考项 .............................................................................................................. 13 表 7：移动控制类应用网络参数配置要求 .......................................................................................................... 16 表 8：移动控制类终端应用设计参考项 .............................................................................................................. 16 表 9：相关 AT 命令说明 ..................................................................................................................................... 23 表 10：参考文档 ................................................................................................................................................ 25 表 11：术语缩写................................................................................................................................................. 25 上海移远通信技术股份有限公司 4 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 图片索引 图 1：固定上报类终端应用参考流程.................................................................................................................... 9 图 2：固定控制类终端应用参考流程.................................................................................................................. 12 图 3：移动上报类应用终端参考流程.................................................................................................................. 15 图 4：移动控制类终端应用参考流程.................................................................................................................. 18 图 5：模块自动入网模式场景初始化流程 .......................................................................................................... 20 图 6：模块手动入网模式场景初始化流程 .......................................................................................................... 21 上海移远通信技术股份有限公司 5 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 1 引言 目前，移远通信 NB-IoT 模块主要应用于如下四类终端应用场景：  固定上报类：如水表、气表、烟感报警器等；  固定控制类：如路灯、共享洗衣机等；  移动上报类：如共享单车、智能手环等；  移动控制类：如电动车控制器。 本文档针对此四类终端应用场景提供设计指导，以便于客户在不同的网络部署环境（部署频点变更、 同频改异频等）下进行终端部署。 本文档适用于如下移远通信 NB-IoT 模块：  BC35-G 模块 V150R100C20B300 及其后软件版本；  BC28 模块 V150R100C20B300 及其后软件版本；  BC95 R2.0 模块 V150R100C20B300 及其后软件版本。 上海移远通信技术股份有限公司 6 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 2 终端应用设计指导 本章分别针对移远通信 NB-IoT 模块各类终端应用提供设计指导和建议。 2.1. 固定上报类 固定上报类的终端应用部署位置固定，数据传输业务具有周期性；大部分时间处于睡眠状态，无需接 收寻呼消息，仅在终端发送上行数据时接收下行数据。此类终端应用要求低功耗以及高数据传输成功率， 但对数据实时性要求低，建议遵循以下设计要求。 2.1.1. 网络参数配置要求 表 1：固定上报类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 打开 备注 如上表格所述功能由核心网配置，因此须与运营商确认功能开启和关闭状态。 2.1.2. 终端设计建议 表 2：固定上报类终端应用设计参考项 序号 设计参考项 1 开机入网超时时间 2 使能小区重选功能 说明 由于网络变化或在深度覆盖下，终端入网时间较长，因此建议 MCU 开机入网超时时间不小于 300s。  为了选择信号更好的小区，建议开启模块的小区重选功能。 BC35-G/BC28/BC95 R2.0 V150R100C20B300 及其后软件 上海移远通信技术股份有限公司 7 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 版本模块的小区重选功能均默认开启。  若小区重选功能被关闭，首先确认模块处于最小功能模式（可 通过 AT+CFUN?查询），然后向模块发送 AT+NCONFIG=CE LL_RESELECTION,TRUE 命令使能小区重选。 最后一条上行数据业务采用带有 RAI 功能的命令发送（例如： 3 针对最后一条上行数据启用 AT+QLWULDATAEX=3,AA34BB,0x0001），提示核心网立即释放 RAI 功能 RRC 连接。模块快速进入到 Idle 状态，待 Idle 定时器超时后模块 自动进入 PSM 模式。 若需要给模块断电，则须在模 模块进入 Idle 状态后须至少等待 15s，再进行断电，使得网络可以 4 块进入 Idle 状态后延时 15s 再 通过配置 T3324 定时器，保证模块有足够的时间完成小区测量及 进行断电动作 重选过程。 5 若需要给模块断电，则须先执 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，触发模块保存 行 AT+CFUN=0 再断电 频点、向网络发送去附着消息。 6 数据传输业务  通过华为 OceanConnect IoT 平台或中国电信物联网开放平 台发送数据时，若返回 '+CME ERROR: 513' 错误（前提是 设置 AT+CMEE=1；513: TUP not registered），MCU 延时 20s 后再次尝试发送数据；若连续 3 次数据均发送失败，则进 入异常处理流程（参考如下第 7 项）。  进行正常数据传输业务时，在业务数据交互过程中，若 60s 后未收到下行数据，则判定本次数据业务因超时而失败，再次 尝试发送数据；若 3 次尝试均超时失败，则进入异常处理流 程（参考如下第 7 项）。 若入网异常或数据传输业务失败后，请按如下步骤进行异常处理： 7 异常处理流程 1) 执行 AT+NRB 重启模块 2) 执行 AT+CFUN=0 开启最小功能模式 3) 执行 AT+NCSEARFCN 清除先验频点 4) 执行 AT+CFUN=1 开启全功能模式 5) 执行 AT+CGATT=1 附着网络 6) 再次尝试入网以及数据传输业务 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 DFOTA 升级过程中，禁止向模块发送任何 AT 命令并禁止给模块 断电，建议不断电保护时间为 30 分钟。模块通过主串口输出 8 支持模块 DFOTA 固件升级 'FIRMWARE DOWNLOADING' 表 示 固 件 已 开 始 升 级 ， 输 出 'FIRMWARE UPDATE SUCCESS'表 示 固 件 升 级 成 功 ， 输 出 'FIRMWARE UPDATE OVER'表示固件升级结束。 上海移远通信技术股份有限公司 8 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 2.1.3. 终端设计参考流程 模块上电 设置手动入网 AT+NCONFI G=AUTO CO NNE CT,FALSE 设置CDP服务器地址 若使用UDP/TCP通讯， AT+NCDP=[,] 则跳过此步骤 软件重启模块 AT+NRB 指定Band值 AT+NBAND= 若使 用单Ban d模块 ，则跳 过此步 骤 设置最大功能模式 AT+CFUN=1 关闭模块eDRX功能 AT+CEDRXS=0,5 触发网络附着 AT+CGATT=1 网络附着 数据传输业务 Yes 连续3次接收下行数 据超时（60s） 数据传输 是否成功? No 最后一包上行数据采 Yes 用带RAI功能的命令 Idle模式 检查是否 成功入网 AT+CGATT? 300s后，AT+CGATT?查 No 询返回值不等于1 重启模块 AT+NRB 设置最小功能模式 AT+CFUN=0 触发网络附着 AT+CFUN=1 AT+CGATT=1 清除先验频点 AT+NCSEARFCN 是否断电? N 推荐进入PS M模式； 若业务完成后采取断电 Y 方式，建议进入Idle后 延时至少15s，执行 AT+CFUN=0，再断电 PSM AT+CFUN=0 是否继续 尝试入网? 根据退避算法连 No 续3次入网失败 Yes 异常 处理 断电关机 图 1：固定上报类终端应用参考流程 上海移远通信技术股份有限公司 9 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 2.2. 固定控制类 固定控制类的终端应用部署位置固定，通常由外部电源供电；大部分时间处于在线状态，能实时接收 下行数据。该类终端应用对数据实时性要求高，对功耗要求低，建议遵循以下设计要求。 2.2.1. 网络参数配置要求 表 3：固定控制类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 关闭 备注 如上表格所述功能由核心网配置，因此须与运营商确认功能开启和关闭状态。 2.2.2. 终端设计建议 表 4：固定控制类终端应用设计参考项 序号 设计建议参数 说明 1 开机入网超时时间 由于网络变化或在深度覆盖下，终端入网时间较长，因此建议 MCU 开机入网超时时间不小于 300s。  为了选择信号更好小区，建议开启模块的小区重选功能。 BC35-G/BC28/BC95 R2.0 V150R100C20B300 及其后软件 2 使能小区重选功能 版本模块的小区重选功能均默认开启。  若小区重选功能被关闭，首先确认模块处于最小功能模式（可 通过 AT+CFUN?查询），然后向模块发送 AT+NCONFIG=CE LL_RESELECTION,TRUE 命令使能小区重选。 3 若需要给模块断电，则须先执 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，触发模块保存 行 AT+CFUN=0 再断电 频点、向网络发送去附着消息。  通过华为 OceanConnect IoT 平台或中国电信物联网开放平 台发送数据时，若返回 '+CME ERROR: 513' 错误（前提是 4 数据传输业务 设置 AT+CMEE=1；513: TUP not registered），MCU 延时 20s 后再次尝试发送数据；若连续 3 次数据均发送失败，则进 入异常处理流程（参考如下第 5 项）。 上海移远通信技术股份有限公司 10 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导  进行正常数据传输业务时，在业务数据交互过程中，若 60s 后未收到下行数据，则判定本次数据业务因超时而失败，再次 尝试发送数据；若 3 次尝试均超时失败，则进入异常处理流 程（参考如下第 5 项）。 若入网异常或数据传输业务失败后，请按如下步骤进行异常处理： 5 异常处理流程 1) 执行 AT+NRB 重启模块 2) 执行 AT+CFUN=0 开启最小功能模式 3) 执行 AT+NCSEARFCN 清除先验频点 4) 执行 AT+CFUN=1 开启全功能模式 5) 执行 AT+CGATT=1 附着网络 6) 再次尝试入网以及数据传输业务 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 DFOTA 升级过程中，禁止向模块发送任何 AT 命令并禁止给模块 断电，建议不断电保护时间为 30 分钟。模块通过主串口输出 6 支持模块 DFOTA 固件升级 'FIRMWARE DOWNLOADING' 表 示 固 件 已 开 始 升 级 ， 输 出 'FIRMWARE UPDATE SUCCESS'表 示 固 件 升 级 成 功 ， 输 出 'FIRMWARE UPDATE OVER'表示固件升级结束。 上海移远通信技术股份有限公司 11 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 2.2.3. 终端设计参考流程 模块上电 设置手动入网 AT+NCONFI G=AUTO CO NNE CT,FALSE 设置CDP服务器地址 若使用UDP/TCP通讯， AT+NCDP=[,] 则跳过此步骤 软件重启模块 AT+NRB 指定Band值 AT+NBAND= 若使 用单Ban d模块 ，则跳 过此步 骤 设置最大功能模式 AT+CFUN=1 关闭模块eDRX功能 AT+CEDRXS=0,5 关闭模块PS M功能 AT+CPS MS =0 触发网络附着 AT+CGATT=1 网络附着 数据传输业务 Yes 连续3次接收下行数 据超时（60s） 数据传输 是否成功? No Yes 检查是否 成功入网 AT+CGATT? 300s后，AT+CGATT?查 No 询返回值不等于1 重启模块 AT+NRB 设置最小功能模式 AT+CFUN=0 触发网络附着 AT+CFUN=1 AT+CGATT=1 Idle模式 清除先验频点 AT+NCSEARFCN 是否继续 尝试入网? No 根据退避算法连 续3次入网失败 断电关机 Yes 异常 处理 图 2：固定控制类终端应用参考流程 上海移远通信技术股份有限公司 12 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 2.3. 移动上报类 移动上报类终端应用会在移动状态下进行数据传输业务；无需接收寻呼消息，仅在终端发送上行数据 时接收下行数据。该类终端应用要求低功耗，对数据实时性要求低，建议遵循以下设计要求。 2.3.1. 网络参数配置要求 表 5：移动上报类终端应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 打开 备注 如上表格所述功能由核心网配置，因此须与运营商确认功能开启和关闭状态。 2.3.2. 终端设计建议 表 6：移动上报类终端应用设计参考项 序号 设计建议参数 说明 1 开机入网超时时间 由于网络变化或在深度覆盖下，终端入网时间较长，因此建议 MCU 开机入网超时时间不小于 300s。  为了选择信号更好小区，建议开启模块的小区重选功能。 BC35-G/BC28/BC95 R2.0 V150R100C20B300 及其后软件 2 使能小区重选功能 版本模块的小区重选功能均默认开启。  若小区重选功能被关闭，首先确认模块处于最小功能模式（可 通过 AT+CFUN?查询），然后向模块发送 AT+NCONFIG=CE LL_RESELECTION,TRUE 命令使能小区重选。 最后一条上行数据业务采用带有 RAI 功能的命令发送（例如： 3 针对最后一条上行数据启用 AT+QLWULDATAEX=3,AA34BB,0x0001），提示核心网立即释放 RAI 功能 RRC 连接。模块快速进入到 Idle 状态，待 Idle 定时器超时后模块 自动进入 PSM 模式。 4 若需要给模块断电，则须先执 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，触发模块保存 行 AT+CFUN=0 再断电 频点、向网络发送去附着消息。 5 数据传输业务  通过华为 OceanConnect IoT 平台或中国电信物联网开放平 上海移远通信技术股份有限公司 13 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 台发送数据时，若返回 '+CME ERROR: 513' 错误（前提是 设置 AT+CMEE=1；513: TUP not registered），MCU 延时 20s 后再次尝试发送数据；若连续 3 次数据均发送失败，则进 入异常处理流程（参考如下第 6 项）。  进行正常数据传输业务时，在业务数据交互过程中，若 60s 后未收到下行数据，则判定本次数据业务因超时而失败，再次 尝试发送数据；若 3 次尝试均超时失败，则进入异常处理流 程（参考如下第 6 项）。 若入网异常或数据传输业务失败后，请按如下步骤进行异常处理： 6 异常处理流程 1) 执行 AT+NRB 重启模块 2) 执行 AT+CFUN=0 开启最小功能模式 3) 执行 AT+NCSEARFCN 清除先验频点 4) 执行 AT+CFUN=1 开启全功能模式 5) 执行 AT+CGATT=1 附着网络 6) 再次尝试入网以及数据传输业务 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 DFOTA 升级过程中，禁止向模块发送任何 AT 命令并禁止给模块 断电，建议不断电保护时间为 30 分钟。模块通过主串口输出 7 支持模块 DFOTA 固件升级 'FIRMWARE DOWNLOADING' 表 示 固 件 已 开 始 升 级 ， 输 出 'FIRMWARE UPDATE SUCCESS'表 示 固 件 升 级 成 功 ， 输 出 'FIRMWARE UPDATE OVER'表示固件升级结束。 上海移远通信技术股份有限公司 14 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 2.3.3. 终端设计参考流程 模块上电 设置手动入网 AT+NCONFI G=AUTO CO NNE CT,FALSE 设置CDP服务器地址 若使用UDP/TCP通讯， AT+NCDP=[,] 则跳过此步骤 软件重启模块 AT+NRB 指定Band值 AT+NBAND= 若使 用单Ban d模块 ，则跳 过此步 骤 设置最大功能模式 AT+CFUN=1 关闭模块eDRX功能 AT+CEDRXS=0,5 触发网络附着 AT+CGATT=1 网络附着 数据传输业务 Yes 连续3次接收下行数 据超时（60s） 数据传输 是否成功? No 最后一包上行数据采 用带RAI功能的命令 Yes Idle模式 检查是否 成功入网 AT+CGATT? 300s后，AT+CGATT?查 No 询返回值不等于1 重启模块 AT+NRB 设置最小功能模式 AT+CFUN=0 触发网络附着 AT+CFUN=1 AT+CGATT=1 清除先验频点 AT+NCSEARFCN 是否继续 尝试入网? Yes PSM No 根据退避算法连 续3次入网失败 断电关机 异常 处理 图 3：移动上报类应用终端参考流程 上海移远通信技术股份有限公司 15 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 2.4. 移动控制类 移动控制类的终端应用处于在移动状态下，且在大部分时间处于在线状态，要求能实时接收下行数据 或传输上行数据。此类终端应用一般可充电，对功耗要求低，但对数据实时性要求高，建议遵循以下设计 要求。 2.4.1. 网络参数配置要求 表 7：移动控制类应用网络参数配置要求 序号 1 2 参数 eDRX 功能 PSM 状态 配置要求 关闭 关闭 备注 如上表格所述功能由核心网配置，因此须与运营商确认功能开启和关闭状态。 2.4.2. 终端设计建议 表 8：移动控制类终端应用设计参考项 序号 设计建议参数 说明 1 开机入网超时时间 由于网络变化或在深度覆盖下，终端入网时间较长，因此建议 MCU 开机入网超时时间不小于 300s。  为了选择信号更好小区，建议开启模块的小区重选功能。 BC35-G/BC28/BC95 R2.0 V150R100C20B300 及其后软件 2 使能小区重选功能 版本模块的小区重选功能均默认开启。  若小区重选功能被关闭，首先确认模块处于最小功能模式（可 通过 AT+CFUN?查询），然后向模块发送 AT+NCONFIG=CE LL_RESELECTION,TRUE 命令使能小区重选。 最后一条上行数据业务采用带有 RAI 功能的命令发送（例如： 3 针对最后一条上行数据启用 RAI 功能 AT+QLWULDATAEX=3,AA34BB,0x0001），提示核心网立即释放 RRC 连接。模块快速进入到 Idle 状态，待 Idle 定时器超时后模块 自动进入 PSM 模式。 4 若需要给模块断电，则须先执 在断电前 MCU 需向模块发送 AT+CFUN=0 命令，触发模块保存 行 AT+CFUN=0 再断电 频点、向网络发送去附着消息。 上海移远通信技术股份有限公司 16 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 5 数据传输业务  通过华为 OceanConnect IoT 平台或中国电信物联网开放平 台发送数据时，若返回 '+CME ERROR: 513' 错误（前提是 设置 AT+CMEE=1；513: TUP not registered），MCU 延时 20s 后再次尝试发送数据；若连续 3 次数据均发送失败，则进 入异常处理流程（参考如下第 6 项）。  进行正常数据传输业务时，在业务数据交互过程中，若 60s 后未收到下行数据，则判定本次数据业务因超时而失败，再次 尝试发送数据；若 3 次尝试均超时失败，则进入异常处理流 程（参考如下第 6 项）。 若入网异常或数据传输业务失败后，请按如下步骤进行异常处理： 6 异常处理流程 1) 执行 AT+NRB 重启模块 2) 执行 AT+CFUN=0 开启最小功能模式 3) 执行 AT+NCSEARFCN 清除先验频点 4) 执行 AT+CFUN=1 开启全功能模式 5) 执行 AT+CGATT=1 附着网络 6) 再次尝试入网以及数据传输业务 若入网或数据传输业务仍失败，可根据退避算法进行 3 次重试； 若仍失败，则断电关机，待下一次业务上报时，再重新入网。 DFOTA 升级过程中，禁止向模块发送任何 AT 命令并禁止给模块 断电，建议不断电保护时间为 30 分钟。模块通过主串口输出 7 支持模块 DFOTA 固件升级 'FIRMWARE DOWNLOADING' 表 示 固 件 已 开 始 升 级 ， 输 出 'FIRMWARE UPDATE SUCCESS'表 示 固 件 升 级 成 功 ， 输 出 'FIRMWARE UPDATE OVER'表示固件升级结束。 上海移远通信技术股份有限公司 17 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 2.4.3. 终端设计参考流程 模块上电 设置手动入网 AT+NCONFI G=AUTO CO NNE CT,FALSE 设置CDP服务器地址 若使用UDP/TCP通讯， AT+NCDP=[,] 则跳过此步骤 软件重启模块 AT+NRB 指定Band值 AT+NBAND= 若使 用单Ban d模块 ，则跳 过此步 骤 设置最大功能模式 AT+CFUN=1 关闭模块eDRX功能 AT+CEDRXS=0,5 关闭模块PS M功能 AT+CPSMS=0 触发网络附着 AT+CGATT=1 网络附着 数据传输业务 Yes 连续3次接收下行数 据超时（60s） 数据传输 是否成功? No 最后一包上行数据采 用带RAI功能的命令 Yes Idle模式 检查是否 成功入网 AT+CGATT? 300s后，AT+CGATT?查 No 询返回值不等于1 重启模块 AT+NRB 设置最小功能模式 AT+CFUN=0 触发网络附着 AT+CFUN=1 AT+CGATT=1 清除先验频点 AT+NCSEARFCN 是否继续 尝试入网? Yes No 根据退避算法连 续3次入网失败 断电关机 异常 处理 图 4：移动控制类终端应用参考流程 上海移远通信技术股份有限公司 18 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 3 模块入网流程 模块入网有两种方式：自动入网和手动入网。默认情况下模块以自动模式入网（AT+NCONFIG:AUTO CONNECT,TRUE）。模块入网时间大约在 7~15s 左右（覆盖等级 ECL=0 时）。更多详细入网机制请参考 文档 [4]。 上海移远通信技术股份有限公司 19 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 3.1. 自动入网模式 模块默认以自动入网模式入网。模块上电后系统开始运行，本地初始化完毕后，立即开始搜寻网络信 号。自动入网模式场景初始化流程如下图所示。 开始 模块上电后自动开机，约5s之后会输 出Neul OK字样。表示模块可以执行 AT命令 直接发送AT，检查串口通讯是否正常。量产 之前需要确认MCU与模块之间的波特率是否 完全匹配。即在高低温环境中MCU发送约1K 的数据，检查MCU与模块通讯是否正常。 检查USIM卡是否初始化成功。串口通讯成功 后可查询，若失败，延时1s后再查询。如果 连续10次都失败，则建议软件重启模块或者 检查USIM卡硬件电路。 USIM正常初始化之后，模块则开始搜寻网 络。AT+CSQ可查询无线网络的RSSI的指示 状态。取值范围0-31； 99表示没有搜寻到网络 查询模块的网络附着状态。返回值的第二个 参数为1表示成功附着本地网络；第二个参数 为5表示成功附着漫游网络；第二个参数为2 时表示模块正在注册。详细可参考相应模块 AT命令手册。MCU可以每隔1s查询一次。 查询模块的PDP上下文激活状态。返回1表示 激活成功，返回0表示激活失败。 查询模块是否获取到IP，正常IP方式附着， PDP已经激活，则网络均会给模块分配一个 IP地址。 模块上电 等待输出 Neul OK 否 AT通讯是否正常 是 否 AT+CIMI 是 否 AT+CSQ 是 否 AT+CEREG? 是 否 AT+CGATT? 是 否 AT+CGPADDR 是 数据业务 结束 图 5：模块自动入网模式场景初始化流程 上海移远通信技术股份有限公司 20 / 26 3.2. 手动入网模式 BC35-G&BC28&BC95 R2.0 应用设计指导 模块上电后自动开机，约5s之后会输出Neul OK字样，表示模块可以执行AT命令 直接发送AT，检查串口通讯是否正常。量产 之前需要确认MCU与模块之间的波特率是否 完全匹配。即在高低温环境中MCU发送约1K 的数据，检查MCU与模块通讯是否正常。 判断是否是手动入网模式，若已经是手动方 式则可以直接进行下一步 该步骤激活modem功能，打开射频开关。如 果需要指定模块的band，需要在 AT+CFUN=1之前执行。 检查USIM卡是否初始化成功。串口通讯成功 后可查询，若失败，延时1s后再查询。如果 连续10次都失败，则建议软件重启模块或者 检查USIM卡硬件电路。 触发模块开始搜寻网络。 AT+CSQ可查询无线网络的RSSI的指示状 态。取值范围0-31；99表示没有搜寻到网络 查询模块的网络附着状态。返回值的第二个参 数为1表示成功附着本地网络；第二个参数为5 表示成功附着漫游网络；第二个参数为2时表示 模块正在注册。详细可参考相应模块模块AT命 令手册。MCU可以每隔1是查询一次。 查询模块的PDP上下文激活状态。返回1表示 激活成功，返回0表示激活失败。 查询模块是否获取到IP，正常IP场景中， PDP已经激活，则网络均会给模块分配一个 IP地址。 开始 模块上电 等待输出 Neul OK 否 AT通讯是否正常 是 AT+NCO NFIG?查询 是否是 手动 入网模 式 是 AT+CFUN=1 否 AT+CIMI 是 AT+CGATT=1 否 AT+CSQ 是 否 AT+CEREG? 是 否 AT+CGATT? 是 否 AT+CGPADDR 是 数据业务 结束 AT+NRB AT+NCDP=[,] (若使 用UDP/TCP通讯，则跳 过此步 骤) AT+NCONFIG=AUTOCONNECT ,FALSE 否 图 6：模块手动入网模式场景初始化流程 上海移远通信技术股份有限公司 21 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 4 模块 PSM 模式 模块进入 PSM 模式时，功耗约为 3uA 左右，此时模块的 modem 已经与基站断开连接，无法接收到基 站的任何消息。同时模块的各个内核也处于关闭状态。当设置 AT+NPSMR=1 时，模块退出 PSM 模式时会 有 URC 信息+NPSMR:0 输出。通过命令 AT+NPSMR?也可以查询模块的当前是否处于 PSM 模式。当模 块进入 PSM 模式后，以下场景可能会导致退出 PSM 模式。 4.1. 3GPP 协议策略唤醒 3GPP 协议的 TAU（位置跟踪区域更新）唤醒模块，包括周期性唤醒和 TAC 变更唤醒。 4.2. 业务数据的相关策略唤醒 如下业务数据会导致模块从 PSM 模式中被唤醒：  外部 MCU 发送上行数据；  模块连接中国电信物联网开放平台时，若注册无响应，超时重发策略会唤醒模块；  发送 CON 类型的数据时，若超时未收到 ACK，重传策略会唤醒模块；  模块连接中国电信物联网开放平台后，Lifetime 定时更新机制会唤醒模块。（详细的机制可参考文 档 [5] ）。 4.3. 运营商自注册逻辑唤醒 如下运营商自注册逻辑会导致模块从 PSM 模式中被唤醒：  中国电信运营商自注册逻辑  中国联通运营商自注册逻辑  中国移动运营商 DM 注册逻辑 上海移远通信技术股份有限公司 22 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 5 补充说明 5.1. 常规维护测试手段  终端支持上报网络相关信息且可在平台上显示：如频点（EARFCN）、小区 ID、覆盖等级（ECL）、 信号强度（RSRP）、信噪比（SNR）等，相关信息可通过 AT+NUESTATS 命令来获取。  终端支持本地接口升级及信息查询：通过本地接口，可查看模块运行日志、修改配置参数以及完 成对模块的本地固件版本升级。 5.2. 终端整机设计建议  针对模块不断电的终端应用，为保证模块长期有效的通讯，建议大约每隔一个月重启一次模块。  客户终端设计的时候建议一定要在弱信号下（ECL=2 时）进行验证测试，保证终端设备的各种异 常场景处理机制能生效。  客户整机设计投产之前建议将终端入网相关的流程机制发送给移远通信技术支持人员检查，以保 证终端设备在各种复杂外场环境中能有效接入网络。 5.3. 相关 AT 命令说明 本章节简要列举了针对 BC35-G 、BC28 以及 BC95 R2.0 的终端应用设计相关的 AT 命令。如需更多 AT 命令详情，请参考文档 [1]。 表 9：相关 AT 命令说明 序号 AT 命令 1 AT+NCONFIG=CELL_RESELECTION,TRUE 2 AT+NCONFIG=AUTOCONNECT,FALSE 说明 使能模块小区重选功能 关闭模块自动入网功能 上海移远通信技术股份有限公司 23 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 3 AT+CEDRXS=0,5 关闭模块 eDRX 功能 4 AT+CGATT=1 触发模块进行网络附着 5 AT+CGATT? 查询模块是否成功入网 6 AT+NRB 重启模块 7 AT+CPSMS=0 关闭模块 PSM 功能 8 AT+NSOSTF=,,,,,[,] Idle 状态。 可发送携带辅助释放指示的 CoAP 数据，用 9 AT+QLWULDATAEX=,, 于指示核心网立即释放连接，以便模块快速 [,] 进入 Idle 状态。 10 AT+NUESTATS 查询最近一次所驻留小区的 EARFCN、小区 ID、ECL、RSRP 和 SNR 等信息。 清除模块保存的先验频点，当下一次启动搜 11 AT+NCSEARFCN 索网时，根据场景信号强度选择频点。该命 令需要在 AT+CFUN=0 的状态下执行。 12 AT+CFUN= 设置模块功能模式 上海移远通信技术股份有限公司 24 / 26 BC35-G&BC28&BC95 R2.0 应用设计指导 6 附录 A 参考文档及术语缩写 表 10：参考文档 序号 文档名称 备注 [1] Quectel_BC35-G&BC28&BC95 R2.0_AT_Commands _Manual BC35-G、BC28 和 BC95 R2.0 AT 命令手册 [2] Quectel_BC95&BC35-G&BC28_RAI_应用指导 BC95、BC35-G、BC28 RAI 功能使用说明 [3] Quectel_BC35-G&BC28&BC95 R2.0_中国电信物联网 BC35-G、BC28 和 BC95 R2.0 电信物联网 开放平台_DFOTA_用户指导 开放平台 DFOTA 用户指导 [4] Quectel_BC35-G&BC28&BC95 R2.0_搜网机制说明 模块搜网机制说明文档 [5] Quectel_BC35-G&BC28&BC95 R2.0_注意事项及常见 BC35-G、BC28 和 BC95 R2.0 模块的注意 问题 事项及常见问题说明文档 表 11：术语缩写 缩写 英文全称 中文全称 CoAP EARFCN ECL Constrained Application Protocol E-UTRA Absolute Radio Frequency Channel Number Enhanced Coverage Level 受限应用协议 中心频点 增强型覆盖等级 eDRX Extended Discontinuous Reception 增强型非连续接收 E-UTRA Evolved Universal Terrestrial Radio Access 演进通用地面无线接入 MCU Micro Control Unit 微型控制单元 PSM Power Saving Mode 省电模式 RAI Release Assistant Indication 释放辅助指示 RRC Radio Resource Control 无线资源控制 RSRP Reference Signal Received Power 参考信号接收功率 上海移远通信技术股份有限公司 25 / 26 SNR TCP UDP Signal Noise Ratio Transmission Control Protocol User Datagram Protocol BC35-G&BC28&BC95 R2.0 应用设计指导 信噪比 传输控制协议 用户数据报协议 上海移远通信技术股份有限公司 26 / 26

BC35-G&BC28 CoAP 应用指导 NB-IoT 模块系列 版本：BC35-G&BC28_CoAP_应用指导_V1.0 日期：2019-10-14 状态：受控文件 www.quectel.com BC35-G&BC28 CoAP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 31 BC35-G&BC28 CoAP 应用指导 文档历史 修订记录 版本 1.0 日期 2019-10-14 作者 陶亮亮/ 陆晓程 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 31 BC35-G&BC28 CoAP 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 1.1. 定义 ............................................................................................................................................. 5 1.2. AT 命令语句................................................................................................................................5 1.3. AT 命令响应................................................................................................................................6 2 CoAP AT 命令....................................................................................................................................... 7 2.1. AT+QCOAPCREATE 创建 CoAP 上下文 ................................................................................. 7 2.2. AT+QCOAPDEL 删除 CoAP 上下文......................................................................................... 8 2.3. AT+QCOAPADDRES 添加 CoAP 客户端资源 ......................................................................... 9 2.4. AT+QCOAPHEAD 配置 CoAP 消息头 ................................................................................... 10 2.5. AT+QCOAPOPTION 配置 CoAP 消息选项 ............................................................................ 11 2.6. AT+QCOAPSEND 发送数据 .................................................................................................. 13 2.7. AT+QCOAPDATASTATUS 查询 CON 消息传递状态 ............................................................. 15 2.8. AT+QCOAPCFG CoAP 配置命令 .......................................................................................... 16 3 CoAP 相关 URC...................................................................................................................................19 3.1. 响应 URC ..................................................................................................................................19 3.2. 请求 URC ..................................................................................................................................20 4 错误码概览 ........................................................................................................................................... 22 5 举例 ...................................................................................................................................................... 24 5.1. 发送 CoAP 请求到 CoAP 服务器............................................................................................... 24 5.2. 注册到中国电信物联网平台....................................................................................................... 26 5.3. 配置命令的使用示例..................................................................................................................28 6 附录 A 参考文档及术语缩写................................................................................................................. 30 上海移远通信技术股份有限公司 3 / 31 BC35-G&BC28 CoAP 应用指导 表格索引 表 1：AT 命令及响应类型 .................................................................................................................................... 5 表 2：COAP 相关 URC...................................................................................................................................... 19 表 3：通用错误代码（27.007）......................................................................................................................... 22 表 4：通用错误代码（27.005）......................................................................................................................... 22 表 5：参考文档 .................................................................................................................................................. 30 表 6：术语缩写 .................................................................................................................................................. 30 上海移远通信技术股份有限公司 4 / 31 BC35-G&BC28 CoAP 应用指导 1 引言 本文主要介绍了如何通过 AT 命令使用 BC35-G 和 BC28 模块的 CoAP 协议相关功能。 1.1. 定义  ：回车符；  ：换行符；  ：参数名称，实际命令中不包括尖括号；  [...]：可选参数，实际命令中不包括方括号[]。 1.2. AT 命令语句 表 1：AT 命令及响应类型 测试命令 查询命令 设置命令 执行命令 AT+=? AT+? AT+= AT+ 返回相应设置命令可设置的参数列表及取值范围。 返回相应设置命令参数的当前设置值。 设置用户可自定义的参数值。 执行无需设置参数值的命令。 可以用分号（';'）将多个命令放在同一行。此时只有第一个命令带有'AT'前缀。命令可以是大写或 小写。 输入 AT 命令时，可以忽略空格。但以下情况除外：  带引号的字符串内；  不带引号的字符串或数字参数内；  IP 地址内  在 AT 命令名称中的'='、'？'或'=？'内 上海移远通信技术股份有限公司 5 / 31 BC35-G&BC28 CoAP 应用指导 输入 AT 命令时，至少需要一个回车符。换行符会被忽略，因此在输入时允许使用一个回车符/换行符 对。 若只输入了 AT 标记，未携带命令，则会返回 OK；若输入的是无效命令，则会返回 ERROR。 对于可选参数，除非明确说明，否则需要一直输入到最后一个可选参数为止。 1.3. AT 命令响应 当 AT 命令处理器处理完一条命令后，会返回 OK、ERROR 或+CME ERROR: ，表示已经准备 好接收新命令。在返回最终的 OK，ERROR 或+CME ERROR: 之前，会发送请求的响应消息。 以下是响应消息的格式： +CMD1: OK 或者 OK 上海移远通信技术股份有限公司 6 / 31 BC35-G&BC28 CoAP 应用指导 2 CoAP AT 命令 2.1. AT+QCOAPCREATE 创建 CoAP 上下文 该命令用来创建 CoAP 上下文。 AT+QCOAPCRETAE 创建 CoAP 上下文 测试命令 AT+QCOAPCREATE=? 响应 +QCOAPCREATE: (支持的值范围) OK 设置命令 AT+QCOAPCREATE= 若发生任何错误： ERROR 或 +CME ERROR: 响应 OK 最大响应时间 若发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 CoAP 上下文的本地端口，范围：1-65535。 相关错误码，请参考第 4 章。 举例 AT+QCOAPCREATE=? +QCOAPCREATE: //查询相关参数值范围。 上海移远通信技术股份有限公司 7 / 31 OK AT+QCOAPCREATE=56830 OK BC35-G&BC28 CoAP 应用指导 //创建一个 CoAP 上下文。 2.2. AT+QCOAPDEL 删除 CoAP 上下文 该命令用来删除 CoAP 上下文。 AT+QCOAPDEL 删除 CoAP 上下文 执行命令 AT+QCOAPDEL 响应 OK 最大响应时间 若发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 相关错误码，请参考第 4 章。 举例 AT+QCOAPCREATE=56830 OK AT+QCOAPDEL OK //创建 CoAP 上下文。 //删除 CoAP 上下文。 上海移远通信技术股份有限公司 8 / 31 BC35-G&BC28 CoAP 应用指导 2.3. AT+QCOAPADDRES 添加 CoAP 客户端资源 此命令用来配置 CoAP 资源。 AT+QCOAPADDRES 添加 CoAP 客户端资源 测试命令 AT+QCOAPADDRES=? 响应 +QCOAPADDRES: ,'' OK 设置命令 AT+QCOAPADDRES=,'' 最大响应时间 若发生任何错误： ERROR 或 +CME ERROR: 响应 OK 若发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 CoAP 客户端资源名称长度，范围：1-128。单位：字符。 资源名称。 相关错误码，请参考第 4 章。 举例 AT+QCOAPADDRES=4,'/t/d' OK //添加 CoAP 资源，值为'/t/d'。 上海移远通信技术股份有限公司 9 / 31 BC35-G&BC28 CoAP 应用指导 2.4. AT+QCOAPHEAD 配置 CoAP 消息头 此命令用来配置 CoAP 消息头信息值（由消息 ID 和标记值组成）。 AT+QCOAPHEAD 配置 CoAP 消息头 测试命令 AT+QCOAPHEAD=? 响应 +QCOAPHEAD: [,[][,,]] OK 设置命令 AT+QCOAPHEAD=[,[ ][,,]] 若发生任何错误： ERROR 或 +CME ERROR: 响应 OK 若发生任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 消息 ID 和标记参数设置模式，范围：1-5。 1 随机生成消息 ID 和标记值。 2 随机生成消息 ID；配置标记值。 3 只随机配置消息 ID；省略标记值。 4 配置消息 ID；随机生成标记值。 5 配置消息 ID 和标记值。 消息 ID，仅在参数值为 3、4 和 5 时需要配置。范围：0-65535。 标记值的长度，仅在参数值为 2 或 5 时需要配置。范围：1-8。 标记值，十六进制格式。仅在参数值为 2 或 5 时需要配置。 相关错误码，请参考第 4 章。 备注 若未设置此命令，模块会随机生成消息 ID，并省略标记值。 上海移远通信技术股份有限公司 10 / 31 BC35-G&BC28 CoAP 应用指导 举例 AT+QCOAPHEAD=1 OK AT+QCOAPHEAD=2,8,0102030405060708 OK AT+QCOAPHEAD=3,13940 OK AT+QCOAPHEAD=4,13940 OK AT+QCOAPHEAD=5,13940,4,02040608 OK //随机生成消息 ID 和标记值。 //随机生成消息 ID，并将标记值配置为 0102030405060708。 //将消息 ID 配置为 13940，省略标记值。 //配置消息 ID 为 13940，并随机生成标记值。 //配置消息 ID 为 13940，并将标记值配置为 02040608。 2.5. AT+QCOAPOPTION 配置 CoAP 消息选项 此命令用来配置 CoAP 消息的选项。 AT+QCOAPOPTION 配置 CoAP 消息选项 测试命令 AT+QCOAPOPTION=? 响应 +QCOAPOPTION: ,,''[,...] OK 设置命令 AT+QCOAPOPTION=,,''[,...] 最大响应时间 若发生任何错误： ERROR 或 +CME ERROR: 响应 OK 若发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 11 / 31 BC35-G&BC28 CoAP 应用指导 参数 选项计数，范围：1-8。 CoAP 选项名称，请参考 RFC 7252。 1 If-Match 3 Uri-Host 4 ETag 5 If-None-Match 6 Observe 7 Uri-Port 8 Location-Path 11 Uri-Path 12 Content-Format 14 Max-Age 15 Uri-Query 17 Accept 20 Location-Query 23 Block2 27 Block1 28 SIZE 35 Proxy-Uri 39 Proxy-Scheme 60 Size1 字符串类型，CoAP 选项值。参数值的字符串长度为：1-180 字节。 若参数是 12 或 17，那么参数的值将如下所示： 0 Text-plain 40 Application/link-format 41 Application/xml 42 Application/octet-stream 47 Application/exi 50 Application/json 相关错误码，请参考第 4 章。 举例 AT+QCOAPOPTION=1,11,'rd' OK //配置 CoAP 选项为 11（Uri-path），值为'rd'。 AT+QCOAPOPTION=2,11,'rd',15,'ep=86370303' OK //配置 CoAP 选项为 11（Uri-path），值为'rd'；同 时配置选项为 15（Uri-Query），值为 'ep=86370303'。 AT+QCOAPOPTION=2,11,'.well-know',11,'core' //配置 CoAP 选项为 11（Uri-path），值为'well-know' 上海移远通信技术股份有限公司 12 / 31 BC35-G&BC28 CoAP 应用指导 和'core'。 OK 2.6. AT+QCOAPSEND 发送数据 此命令用来发送数据到 CoAP 服务器。发送 CON 数据之后，发送结果将被自动通知到终端。发送的 CON 数据状态也可以通过终端用 AT+QCOAPDATASTATUS?命令进行查询。 AT+QCOAPSEND 发送数据 测试命令 AT+QCOAPSEND=? 响应 +QCOAPSEND: ,,,[,,[]] OK 若发生任何错误： ERROR 或 +CME ERROR: 设置命令 响应 AT+QCOAPSEND=,,, 响应 > 后，输入需要发送的数据， 若发生任何错误： 再按下 Ctrl+Z 发送，或按下 ESC 取消操 ERROR 作。 或 +CME ERROR: 设置命令 响应 AT+QCOAPSEND=,,, 响应 > 后，输入需要发送的数据， 若发生任何错误： 长度达到值后会自动发送。 ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 CoAP 协议的消息类型，范围：0-3。请参考 RFC 7252。 0 CON 1 NON 2 ACK 上海移远通信技术股份有限公司 13 / 31 BC35-G&BC28 CoAP 应用指导 3 RST CoAP 协议的方法，请参考 RFC 7252。 1 GET 2 POST 3 PUT 4 DELETE CoAP 协议的响应码，请参考 RFC 7252。 0 空消息 201 2.01，已创建 202 2.02，已删除 203 2.03，有效 204 2.04，已更改 205 2.05，内容 400 4.00，错误请求 401 4.01，未经许可的 402 4.02，错误选项 403 4.03，禁止 404 4.04，未找到 405 4.05，不允许的方式 406 4.06，不接受 412 4.12，前提条件失败 413 4.13，请求的实体太大 415 4.15，不支持的内容格式 500 5.00，内部服务器错误 501 5.01，未实现 502 5.02，错误网关 503 5.03，服务不可用 504 5.04，网关超时 505 5.05，代理不受支持 CoAP 服务器地址。 CoAP 服务器端口。 输入数据的长度。最大值 1024。单位：字节。 需要发送的数据。 相关错误码，请参考第 4 章。 举例 AT+QCOAPSEND=1,1,139.196.41.136,5683 > OK //发送 NON 类型的 GET 请求到 CoAP 服务器 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据为空。 AT+QCOAPSEND=0,2,139.196.41.136,5683 >0102 OK //发送 CON 类型的 POST 请求到 CoAP 服务器 上海移远通信技术股份有限公司 14 / 31 BC35-G&BC28 CoAP 应用指导 //收到响应 URC。消息 ID 为 61440，数据长度为 25 字节，响应码为 2.05。 +QCOAPURC: 'rsp' 2.05,61440,25,4E692048616F2066726F6D20436F41502E4E45542052464320 备注 1. 最大数据长度为 1024 字节，超过 1024 字节的数据将被忽略。 2. 若需要发送 CON 数据，必须在发送下一个 CON 或 NON 数据之前通过 AT+QCOAPDATASTATUS 命令获取 CON 数据的发送状态，详见章节 2.7。 2.7. AT+QCOAPDATASTATUS 查询 CON 消息传递状态 此命令用来查询发送到 CoAP 服务器的 CON 消息的状态。 AT+QCOAPDATASTATUS 查询 CON 消息传递状态 查询命令 AT+QCOAPDATASTATUS? 响应 +QCOAPDATASTATUS: OK 最大响应时间 若发生任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数 发送的 CON 数据的状态。 0 未发送 1 已发送，等待 IoT 平台的响应 2 发送失败 3 超时 4 发送成功 5 获得重置消息 相关错误码，请参考第 4 章。 上海移远通信技术股份有限公司 15 / 31 BC35-G&BC28 CoAP 应用指导 举例 AT+QCOAPSEND=0,1,139.196.41.136,5683 > OK //发送 CON 类型的 GET 请求到 CoAP 服务器 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据为空。 AT+QCOAPDATASTATUS? +QCOAPDATASTATUS:1 //已发送，等待 CoAP 服务器响应。 OK //收到响应 URC。消息 ID 为 61440，数据长度为 24 字节，响应码为 2.05。 +QCOAPURC: 'rsp',2.05,61440,24, 4E692048616F2066726F6D20436F41502E4E455420524643 AT+QCOAPDATASTATUS? +QLWDATASTATUS:4 //发送成功。 OK 备注 此命令仅用来查询已发送的 CON 数据状态。 2.8. AT+QCOAPCFG CoAP 配置命令 此命令用于配置 CoAP 功能参数。 AT+QCOAPCFG CoAP 配置命令 测试命令 AT+QCOAPCFG=? 查询命令 AT+QCOAPCFG? 设置命令 AT+QCOAPCFG='Showra'[,] 响应 OK 响应 OK 响应 若不省略，则配置是否显示发送方的 IP 地址和端口： OK 若省略，则查询是否显示发送方的 IP 地址和端口： +QCOAPCFG: 'Showra', OK 上海移远通信技术股份有限公司 16 / 31 BC35-G&BC28 CoAP 应用指导 若发生任何错误： ERROR 或者 +CME ERROR: 设置命令 AT+QCOAPCFG='Showrspopt'[,] 响应 若不省略，则配置是否显示发送方的 CoAP 选 项： OK 若省略，则查询是否显示发送方的 CoAP 选项： +QCOAPCFG: 'Showrspopt', OK 最大响应时间 若发生任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 配置是否显示发送方的 IP 地址和端口。 0 不显示 IP 地址和端口 1 在 URC 中显示 IP 地址和端口，格式如下： +QCOAPURC: 'rsp',[,],,,[, ,] 配置是否显示发送方的 CoAP 选项。 0 不显示 CoAP 选项 1 在 URC 中显示 CoAP 选项，格式如下： +QCOAPURC: 'rsp',,,[,,,''[,...]][,,] 相关错误码，请参考第 4 章。 备注 1. 鉴于数据发送后会及时返回 URC，建议在 AT+QCOAPSEND 之前配置 AT+QCOAPCFG。 2. 参数和不会保存在闪存中，因此配置在关机之后将被重置为默认值（0）。 3. 关于 URC 的详细信息，请参考第 3 章。 上海移远通信技术股份有限公司 17 / 31 举例 AT+QCOAPCFG? OK AT+QCOAPCFG='Showra',1 OK BC35-G&BC28 CoAP 应用指导 //配置显示 URC 中的 IP 地址和端口 上海移远通信技术股份有限公司 18 / 31 BC35-G&BC28 CoAP 应用指导 3 CoAP 相关 URC 本章介绍了与 CoAP 相关的 URC 及其描述。 表 2：CoAP 相关 URC URC +QCOAPURC: 'rsp'[,,],,[,,,''[,…]][,,] +QCOAPURC: 'req',[,,],< method>,,[,,][,,''[,...]][,,] 描述 发送 CON 消息时，CoAP 服务器将返回 ACK 或 RST。如果模块收到此响应，将上报此 URC。 当 CoAP 服务器发送请求时，如果模块收到此请 求，将上报此 URC。 3.1. 响应 URC 模块会将 CoAP 响应事件上报至设备。 通知设备来自服务器的数据响应 URC 格式： +QCOAPURC: 'rsp',[,,],,[,,,''[,...]][,,] 通知来自 CoAP 服务器的响应。 参数 CoAP 服务器 IP 地址，可以通过设置 AT+QCOAPCFG='Showra',1 显示。 CoAP 服务器端口，可以通过设置 AT+QCOAPCFG='Showra',1 显示。 CoAP 协议的消息类型。范围：0-3。请参考 RFC 7252。 0 CON 1 NON 2 ACK 3 RST CoAP 协议的响应码。请参考 RFC 7252。 上海移远通信技术股份有限公司 19 / 31 BC35-G&BC28 CoAP 应用指导 0 空消息 2.01 已创建 2.02 已删除 2.03 有效 2.04 已更改 2.05 内容 4.00 错误请求 4.01 无范围权限 4.02 错误选项 4.03 服务器拒绝请求 4.04 未找到资源 4.05 非法请求方法 4.06 不接受 4.12 请求参数不足 4.13 请求实体过大 4.15 不支持的内容格式 5.00 内部服务器错误 5.01 未实现 5.02 错误网关 5.03 服务器不可用 5.04 网关超时 5.05 代理不受支持 CoAP 消息 ID。 选项计数，可以通过设置 AT+QCOAPCFG='Showrspopt',1 显示。 选项名称， 可以通过设置 AT+QCOAPCFG='Showrspopt',1 显示。 选项值，可以通过设置 AT+QCOAPCFG='Showrspopt',1 显示。 数据长度，最大数据长度为 512，单位：字节。 若参数为 12，且参数为 0（'text-plain'），41 （'application/xml'）或 50（'application/json'），参数格式将是文 本字符串，否则，为十六进制格式。 3.2. 请求 URC 通知 TE 响应来自 CoAP 服务器的请求 URC 格式： +QCOAPURC: 'req',[,,],,,[,,][,,''[,...]][,,] 通知 TE 响应来自 CoAP 服务器的请求。 上海移远通信技术股份有限公司 20 / 31 参数 BC35-G&BC28 CoAP 应用指导 CoAP 服务器 IP 地址，可以通过设置 AT+QCOAPCFG='Showra',1 显示。 CoAP 服务器端口，可以通过设置 AT+QCOAPCFG='Showra',1 显示。 CoAP 协议消息类型，范围：0-3，请参考 RFC 7252。 0 CON 1 NON 2 ACK 3 RST CoAP 协议的方法，请参考 RFC 7252。 1 GET 2 POST 3 PUT 4 DELETE CoAP 消息 ID 表示存在标记，选项和数据，十六进制格式。 0 位：存在标记 1-6 位：选项计数 7 位：存在数据 标记值长度 标记值，十六进制格式。 选项名称 选项值 数据长度，最大数据长度为 1024，单位：字节。 若参数为 12，且参数为 0（'text-plain'），41 （'application/xml'）或 50（'application/json'），参数格式将是文 本字符串，否则，为十六进制格式。 上海移远通信技术股份有限公司 21 / 31 BC35-G&BC28 CoAP 应用指导 4 错误码概览 本章总结了与 BC35-G 和 BC28 模块相关的错误代码。 以下两个表中列出的错误代码均符合 3GPP 规范。如需查看相关参数错误码，请参考 3GPP TS 27.007 V13.5.0，子条款 9.2。 表 3：通用错误代码（27.007） 错误码 描述 说明 3 Operation not allowed 不允许此操作 4 Operation not supported 不支持此操作 23 Memory failure 内存故障 30 No network service 无网络服务 50 Incorrect parameters 参数不正确 51 Command implemented but currently disabled 已执行命令但当前被禁用 52 Command aborted by user 此命令被用户终止 159 Uplink busy/flow control 上行忙碌/流控 表 4：通用错误代码（27.005） 错误码 300 301 302 303 304 描述 ME failure SMS service of ME reserved Operation not allowed Operation not supported Invalid PDU mode parameter 说明 ME 故障 ME 预留的短信服务 不允许此操作 不支持此操作 无效 PDU 模式参数 上海移远通信技术股份有限公司 22 / 31 BC35-G&BC28 CoAP 应用指导 305 Invalid text mode parameter 无效文本模式参数 310 USIM not inserted 无 USIM 卡 311 USIM PIN required 需要 USIM PIN 312 PH-USIM PIN required 需要 PH-USIM PIN 313 USIM failure USIM 故障 314 USIM busy USIM 忙碌 315 USIM wrong USIM 错误 316 USIM PUK required 需要 USIM PUK 317 USIM PIN2 required 需要 USIM PIN2 318 USIM PUK2 required 需要 USIM PUK2 320 Memory failure 内存故障 321 Invalid memory index 内存索引无效 322 Memory full 内存已满 330 SMSC address unknown 未知的 SMSC 地址 331 No network service 无网络服务 332 Network timeout 网络超时 340 No +CNMA acknowledgement expected 预计没有+CNMA 确认 500 Unknown error 未知错误 备注 AT+CMEE=命令可以使能（=1）或禁用（=0）结果码+CME ERROR: 。当=1 并发 生错误时，将响应结果码+CME ERROR: ；当=0 并发生错误时，仅响应 ERROR。如需了解此 命令的详细内容，请参考 Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册。 上海移远通信技术股份有限公司 23 / 31 BC35-G&BC28 CoAP 应用指导 5 举例 5.1. 发送 CoAP 请求到 CoAP 服务器 AT+CGATT? +CGATT: 1 //查询 PS 服务附着状态。 //附着到 PS 服务。 OK AT+QCOAPCREATE=56830 OK //创建 CoAP 上下文。 AT+QCOAPSEND=0,1,139.196.187.107,5683 > OK //发送 CON 类型的 GET 请求到服务器。 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据为空。 AT+QCOAPDATASTATUS? +QCOAPDATASTATUS: 1 //查询数据发送状态。 //已发送，等待 loT 平台响应。 OK //收到响应 URC，响应码为 2.05，消息 ID 为 6685，数据长度为 24 字节，数据为十六进制格式。 +QCOAPURC: 'rsp',2,2.05,6685,24,4E692048616F2066726F6D20436F41502E4E455420524643 AT+QCOAPDATASTATUS? +QCOAPDATASTATUS: 4 //查询数据发送状态。 //发送成功。 OK AT+QCOAPHEAD=3,5566 OK //配置消息 ID 为 5566，省略标记值。 AT+QCOAPSEND=0,1,139.196.187.107,5683 > OK //发送 CON 类型的 GET 请求到服务器。 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据为空。 //收到响应 URC，响应码为 2.05，消息 ID 为 5566（消息 ID 和设置的 ID 相同），数据长度为 24 字节，格 上海移远通信技术股份有限公司 24 / 31 BC35-G&BC28 CoAP 应用指导 式为十六进制。 +QCOAPURC: 'rsp',2,2.05,5566,24,4E692048616F2066726F6D20436F41502E4E455420524643 AT+QCOAPOPTION=1,11,'rd' OK //配置 CoAP 选项，Uri-Path 为'/rd'。 AT+QCOAPSEND=0,1,139.196.187.107,5683 > OK //发送 CON 类型的 GET 请求到服务器 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据为空。 //收到响应 URC，响应码为 2.05，消息 ID 为 61441，数据长度为 17 字节，格式为十六进制。 +QCOAPURC:'req',2,2.05,61441,17,323031382F312F392031313A31313A3139 AT+QCOAPHEAD=5,6677,4,30323436 OK //配置消息 ID 为 6677，标记值为 30323436。 AT+QCOAPOPTION=1,11,'hello' OK //配置 CoAP 选项，Uri-Path 为'/hello'。 AT+QCOAPSEND=0,1,139.196.187.107,5683 > OK //发送 CON 类型的 GET 请求到服务器 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据为空。 //收到响应 URC，响应码为 2.05，消息 ID 为 6677，数据长度为 22 字节，采用十六进制格式。 +QCOAPURC:'rsp',2,2.05,6677,22,68656C6C6F20776F72642066726F6D20736572766572 //设置显示 IP 地址和端口，当收到 URC 时，会显示 IP 地址和端口。 AT+QCOAPCFG='Showra',1 //配置在 URC 中显示 IP 地址和端口 OK AT+QCOAPADDRES=4,'/t/d' OK //添加 CoAP 资源，值为'/t/d'。 //配 置 CoAP 选 项 11 （Uri-Path ） 的值 为 ' t'和 ' r'， 配 置 CoAP 选项 15 （Uri-Query） 的 值为 'ep=863703030822519'。 AT+QCOAPOPTION=3,11,'t',11,'r',15,'ep=863703030822519' OK AT+QCOAPSEND=0,2, 139.196.187.107,5683 > OK //发送 CON 类型的 POST 请求到服务器。 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据为空。 //从服务器 139.196.187.107,5683 收到响应 URC。消息类型为 ACK，响应码为 2.04，消息 ID 为 6677。 +QCOAPURC:'rsp',139.196.187.107,5683,2,2.04,2802 上海移远通信技术股份有限公司 25 / 31 BC35-G&BC28 CoAP 应用指导 //从服务器 180.101.147.115:5683 收到请求 URC。消息类型为 CON，方法是 GET，消息 ID 为 50670，参 数为 09（表示选项计数为 4 且存在标记和选项）。 +QCOAPURC:'req',139.196.187.107,5683,0,1,50670,09,8,1A84BFE989C01C08,6,'0',7,'54321',11,'t ',11,'d' //当收到请求数据时，客户端应该要有所响应。 AT+QCOAPHEAD=5,50670,8,1A84BFE989C01C08 OK //配置消息 ID 和标记值。 AT+QCOAPSEND=1,205,139.196.187.107,5683 > OK //发送 NON 类型的消息到 服务器，响应码为 2.05。 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处 数据为空。 AT+QCOAPDEL OK //删除 CoAP 上下文。 5.2. 注册到中国电信物联网平台 AT+QCOAPCREATE=56830 OK //创建 CoAP 上下文 AT+QCOAPHEAD=1 OK //随机生成消息 ID 和标记值。 //配置 CoAP 选项 11（Uri-Path）的值为'rd'，配置 CoAP 选项 12 的值为'42'，配置 CoAP 选项 15（Uri-Query） 的值为'lwm2m=1.0'和'ep=867725030002525；460041850403693'... AT+QCOAPOPTION=6,11,'rd',12,'42',15,'lwm2m=1.0',15,'ep=867725030002525;46004185040369 3',15,'b=U',15,'lt=86400' OK AT+QCOAPADDRES=6,'/4/0/2' //添加 CoAP 资源，值为'/ 4/0/2'。 OK AT+QCOAPADDRES=6,'/4/0/3' //添加 CoAP 资源，值为'/4/0/3'。 OK AT+QCOAPADDRES=6,'/4/0/8' //添加 CoAP 资源，值为'/4/0/8'。 OK 上海移远通信技术股份有限公司 26 / 31 BC35-G&BC28 CoAP 应用指导 AT+QCOAPADDRES=6,'/3/0/9' //添加 CoAP 资源，值为'/3/0/9'。 OK AT+QCOAPADDRES=6,'/3/0/7' OK //添加 CoAP 资源，值为'/3/0/7'。 AT+QCOAPADDRES=7,'/19/0/0' //添加 CoAP 资源，值为'/19/0/0'。 OK AT+QCOAPADDRES=7,'/19/1/0' //添加 CoAP 资源，值为'/19/1/0'。 OK //发送注册消息到中国电信物联网平台。 AT+QCOAPSEND=0,2,180.101.147.115,5683 >3c2f3e3b72743d226f6d612e6c776d326d222c3c2f312f303e2c3c2f332f303e2c3c2f342f303e2c3c2f3 52f303e2c3c2f32302f303e2c3c2f31392f303e OK //收到响应 URC，消息类型为 ACK，响应码为 2.01，消息 ID 为 55018。 +QCOAPURC: 'rsp',2,2.01,55018 //收到请求 URC。消息类型为 CON，方法为 GET，消息 ID 为 62084，参数为 09（表示选项计数 为 4 并且存在标记和选项）。 +QCOAPURC: 'req',0,1,62084,09,8,1A98EB114F501C07,6,'0',11,'19',11,'0',11,'0' //当收到请求数据时，客户端应该有所响应。 //配置 CoAP 标记与请求消息相同。 AT+QCOAPHEAD=5,62084,8,1A98EB114F501C07 //配置消息 ID 为 62084，配置标记值为 1A98EB114F501C07。 OK AT+QCOAPSEND=2,205,180.101.147.115, 5683 > OK //发送 ACK 类型消息到服务器，响应码为 2.05。 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据 为空。 AT+QCOAPDEL OK //删除 CoAP 上下文。 上海移远通信技术股份有限公司 27 / 31 BC35-G&BC28 CoAP 应用指导 5.3. 配置命令的使用示例 AT+QCOAPCREATE=56830 OK //创建 CoAP 上下文。 AT+QCOAPCFG='Showrspopt',1 OK //配置显示发送方的 CoAP 选项。 //配置 CoAP 选项 11（Uri-Path）的值为'rd'，配置 CoAP 选项 12 的值为'40'，配置 CoAP 选项 15 的 值（Uri-Query）为'ep= I@#@G7pjZBAQUoVav0yXQcQ6v4Ad1nFGXcKhnTWYJt3AE0TpZSj3xDrYMO m6NmohixF@#@M100000089'，'b=U'和'lt=2700'。 AT+QCOAPOPTION=5,11,'rd',12,'40',15,'ep=I@#@G7pjZBAQUoVav0yXQcQ6v4Ad1nFGXcKhnT WYJt3AE0TpZSj3xDrYMOm6NmohixF@#@M100000089',15,'b=U',15,'lt=2700' OK AT+QCOAPSEND=0,2,220.180.239.212,8063 >3c2f3e3b72743d226f6d612e6c776d326d222c3c2f30 OK AT+QCOAPDATASTATUS? +QCOAPDATASTATUS: 4 //查询数据发送状态。 //发送成功。 OK //收到响应 URC，选项 8（location-path）的值是'rd'和'BEHJvP29Lb'。 +QCOAPURC: 'rsp',2,2.01,13357,2,8,'rd',8,'BEHJvP29Lb' AT+QCOAPCFG='Showra',1 OK //配置在 URC 中显示 IP 地址和端口 AT+QCOAPOPTION=5,11,'rd',12,'40',15,'ep=I@#@G7pjZBAQUoVav0yXQcQ6v4Ad1nFGXcKhnT WYJt3AE0TpZSj3xDrYMOm6NmohixF@#@M100000089',15,'b=U',15,'lt=2700' OK AT+QCOAPSEND=0,2,220.180.239.212,8063 >3c2f3e3b72743d226f6d612e6c776d326d222c3c2f30 OK //发送 CON 类型的 POST 请求到服务器。 //输入数据并按下 Ctrl+Z 发送。 //收到响应 URC。 选项 8（location-path）的值是'rd'和'dTuzhqieJe'，CoAP 服务器 IP 地址是 220.180.239.212，端口是 8063。 +QCOAPURC: 'rsp',220.180.239.212,8063,2,2.01,13358,2,8,'rd',8,'dTuzhqieJe' AT+QCOAPCFG='Showrspopt',0 //配置不在 URC 中显示 CoAP 选项。 上海移远通信技术股份有限公司 28 / 31 BC35-G&BC28 CoAP 应用指导 OK AT+QCOAPCFG='Showra',0 OK //配置不在 URC 中显示 IP 地址和端口。 //配置 CoAP 选项 11（Uri-Path）的值为'hello'，配置 CoAP 选项 15（Uri-Query）的值为'name = aaaa'。 AT+QCOAPOPTION=2,11,'hello',15,'name=aaaa' OK AT+QCOAPSEND=0,1,220.180.239.212,8098 > OK //发送 CON 类型的 GET 请求到服务器。 //收到 > 后，输入数据并按 Ctrl+Z 发送，此处数据为空。 //收到响应 URC，内容格式为'0'，数据格式为文本字符串。 +QCOAPURC: 'rsp',2,2.05,54750,1,12,'0',41, hi name=aaaa,this is quectel IoT platform AT+QCOAPDEL OK //删除 CoAP 上下文。 上海移远通信技术股份有限公司 29 / 31 BC35-G&BC28 CoAP 应用指导 6 附录 A 参考文档及术语缩写 表 5：参考文档 序号 文档名称 [1] Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册 备注 BC35-G&BC28&BC95 R2.0 模块的 AT 命令说明和使用手册 表 6：术语缩写 缩写 ACK CoAP CR ID IP loT LF ME OPT PDU PIN PS PUK RST 英文全称 Acknowledgement Constrained Application Protocol Carriage Return Identification Internet Protocol Internet of Things LineFeed Mobile Equipment Option Protocol Data Unit Personal Identification Number Packet Switch PIN Unlock Key Reset 中文全称 确认 受限应用协议 回车符 标识符 国际互联网协议 物联网 换行符 移动设备 选项 协议数据单元 个人识别号码 分组交换 PIN 解锁码 复位 上海移远通信技术股份有限公司 30 / 31 SMS SMSC TE URC USIM BC35-G&BC28 CoAP 应用指导 Short Message Service Short Message Service Center Terminal Equipment Unsolicited Result Code Universal Subscriber Identity Module 短信服务 短信服务中心 终端设备 非请求结果码 通用用户身份识别模块 上海移远通信技术股份有限公司 31 / 31

BC25 eDRX 应用指导 NB-IoT 模块系列 版本：BC25_eDRX_应用指导_V1.0 日期：2019-10-24 状态：受控文件 www.quectel.com BC25 eDRX 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 20 文档历史 修订记录 版本 日期 作者 1.0 2019-10-24 秦世鹏 变更表述 初始版本 BC25 eDRX 应用指导 上海移远通信技术股份有限公司 2 / 20 BC25 eDRX 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 eDRX 简介............................................................................................................................................. 7 3 eDRX 配置相关命令.............................................................................................................................. 8 3.1. AT+CEDRXS eDRX 设置 ........................................................................................................ 8 3.2. AT+CEDRXRDP 查询 eDRX 状态......................................................................................... 10 4 eDRX 配置常见问题............................................................................................................................ 13 4.1. 网络分配的 eDRX 周期或 PTW 与请求不符............................................................................. 13 4.2. 无法开启 eDRX 功能 ................................................................................................................ 13 5 eDRX 应用场景 ................................................................................................................................... 14 5.1. 低功耗模式分类 ........................................................................................................................ 14 5.2. 推荐的低功耗应用方案 ............................................................................................................. 14 5.2.1. 推荐使用 eDRX 的应用场景 .......................................................................................... 14 5.2.2. 推荐使用 DRX 的应用场景 ............................................................................................ 15 5.2.3. 推荐使用 PSM 的应用场景 ............................................................................................ 15 6 eDRX 耗流数据 ................................................................................................................................... 16 6.1. BC25（标准版本） eDRX 耗流............................................................................................... 16 6.2. BC25（低压版本） eDRX 耗流............................................................................................... 18 7 附录 A 术语缩写 ................................................................................................................................. 20 上海移远通信技术股份有限公司 3 / 20 BC25 eDRX 应用指导 表格索引 表 1：BC25（标准版本）耗流数据（中国移动 NB-IOT 实网） ........................................................................ 16 表 2：BC25（低压版本）耗流数据（中国移动 NB-IOT 实网） ........................................................................ 18 表 3：术语和缩写............................................................................................................................................... 20 上海移远通信技术股份有限公司 4 / 20 BC25 eDRX 应用指导 图片索引 图 1：DRX 示意图 ............................................................................................................................................... 7 图 2：EDRX 示意图 ............................................................................................................................................. 7 图 3：BC25（标准版本）DRX 耗流示意图（DRX 周期=2.56S）..................................................................... 16 图 4：BC25（标准版本）EDRX 耗流示意图（EDRX 周期=20.48S）.............................................................. 17 图 5：BC25（标准版本）EDRX 耗流示意图（EDRX 周期=40.96S）.............................................................. 17 图 6：BC25（低压版本）DRX 耗流示意图（DRX 周期=2.56S）..................................................................... 18 图 7：BC25（低压版本）EDRX 耗流示意图（EDRX 周期=20.48S）.............................................................. 19 图 8：BC25（低压版本）EDRX 耗流示意图（EDRX 周期=40.96S）.............................................................. 19 上海移远通信技术股份有限公司 5 / 20 BC25 eDRX 应用指导 1 引言 移远通信一直关注模块功耗的优化，以确保客户终端产品整体功耗最大程度的降低。随着物联网通信 技术的迅速发展以及节能减排环保意识的不断加强，移动通信将提供更多不同的低功耗方案以满足客户对 其终端产品越来越严苛的功耗要求。 NB-IoT 作为蜂窝系统中一项全新的无线接入技术，对功耗有更加严苛的要求，例如其终端可能要求一 块电池可维持正常工作长达数年之久。为了进一步降低终端功耗、满足终端设备对极低功耗的需求，移远 通信 NB-IoT 模块均支持低功耗方案。 移远通信 BC25 模块支持 DRX、eDRX 和 PSM 等多种低功耗方案。本文档主要介绍如何通过 eDRX 的不同参数配置，实现该模块在不同场景下达到功耗与实时性需求的平衡。 上海移远通信技术股份有限公司 6 / 20 BC25 eDRX 应用指导 2 eDRX 简介 DRX 是一种节省终端功耗的工作模式，其基本原理是让模块周期性地进入休眠模式；休眠期间，模块 将不监听 PDCCH、关闭收发单元，以降低其功耗。 DRX 作用于 Idle 态中，通过在 Idle 态中周期性监听寻呼的方式来降低模块功耗，示意图如下所示。但 DRX 参数由网络决定，模块无法修改也无法建议网络修改。 图 1：DRX 示意图 为进一步降低功耗，NB-IoT 不仅支持传统 LTE 的 DRX 模式，还支持扩展的 DRX 周期，即 eDRX。eDRX 目的与 DRX 相同，均是通过让模块周期性进入休眠状态以达到降低功耗的目的。其基本的原理是将 Idle 态 分成寻呼期和休眠期：在寻呼期，模块的工作模式和 LTE 的 DRX 一致；在休眠期，模块不监听下行寻呼。 相比 DRX，eDRX 可支持更长的寻呼周期，以达到进一步降低功耗的目的，示意图如下所示： 图 2：eDRX 示意图 eDRX 模式下，模块只在 PTW 内按 DRX 周期监听下行寻呼、接收下行业务（打开接收机）；如果在休 眠期有数据发给模块，模块并不能及时接收，只能等到当前 eDRX 周期完毕后再次进入 PTW 监听寻呼。因 此，eDRX 模式下，模块功耗的降低以实时性为'代价'，实际应用时需要根据业务模型，确定合适的 eDRX 周期和 PTW 值，以达到功耗与实时性的平衡。 上海移远通信技术股份有限公司 7 / 20 BC25 eDRX 应用指导 3 eDRX 配置相关命令 如下命令可以设置不同的 eDRX 参数，以实现不同应用场景下的多样应用需求。如果 AT 命令执行报错 或需了解相关 AT 命令的更多详情，请参考 Quectel_BC25_AT_命令手册。 3.1. AT+CEDRXS eDRX 设置 设置命令用于设置 UE 的 eDRX 参数，即设置 UE 是否要应用 eDRX，以及指定接入技术请求的 eDRX 值。 当=2 且网络提供的 eDRX 参数发生变化时，该设置命令将用于控制 URC +CEDRXP: [,[,[,]]]的上 报。 该设置命令包含一种特殊形式：AT+CEDRXS=3。此形式的命令将禁用 eDRX 且之前通过 AT+CEDRXS 所配置的所有参数都将被清除，或者被设置为默认值（若有）。 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的取值),(支持的取值), (支持的取值) 查询命令 AT+CEDRXS? OK 响应 +CEDRXS: ,, 设置命令 AT+CEDRXS=[,[,< Requested_eDRX_value>]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 上海移远通信技术股份有限公司 8 / 20 BC25 eDRX 应用指导 生效机制 立即生效；参数设置将保存至 NVM 参数 整型。启用或禁用 eDRX。该参数适用于所有指定的接入技术类型，即的 最 新设置将对所有指定的取值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并启用 URC +CEDRXP:[,[,< NW-provided_eDRX_value>[,]]]上报 3 禁用 eDRX，并清除所有的 eDRX 参数配置或者重置为默认值（若有） 整型。接入技术类型。 0 未使用 eDRX 的接入技术，该参数取值仅在 URC 中使用 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时间窗。 上海移远通信技术股份有限公司 9 / 20 NB-S1 模式。 位数 4 3 2 1 0 0 0 0 0 0 0 1 0 0 1 0 0 0 1 1 0 1 0 0 0 1 0 1 0 1 1 0 0 1 1 1 1 0 0 0 1 0 0 1 1 0 1 0 1 0 1 1 1 1 0 0 1 1 0 1 1 1 1 0 1 1 1 1 寻呼时间窗长度 2.56 秒 5.12 秒 7.68 秒 10.24 秒 12.8 秒 15.36 秒 17.92 秒 20.48 秒 23.04 秒 25.6 秒 28.16 秒 30.72 秒 33.28 秒 35.84 秒 38.4 秒 40.96 秒 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS: 1,5,'0101' OK AT+CEDRXS=? +CEDRXS: (0-3),(5),('0000'-'1111') OK BC25 eDRX 应用指导 3.2. AT+CEDRXRDP 查询 eDRX 状态 若 eDRX 用于 UE 当前注册到的小区，执行命令将返回，， 和。 如果 UE 当前注册的小区未使用 eDRX，则仅返回且值为 0。 上海移远通信技术股份有限公司 10 / 20 BC25 eDRX 应用指导 AT+CEDRXRDP 查询 eDRX 状态 测试命令 AT+CEDRXRDP=? 执行命令 AT+CEDRXRDP 响应 OK 响应 +CEDRXRDP: [,[,< NW-provided_eDRX_value>[,]]] OK 最大响应时间 生效机制 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。接入技术类型。 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 上海移远通信技术股份有限公司 11 / 20 BC25 eDRX 应用指导 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时间窗。 NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 举例 AT+CEDRXRDP +CEDRXRDP: 5,'0010','1110','0101' OK AT+CEDRXRDP=? OK 上海移远通信技术股份有限公司 12 / 20 BC25 eDRX 应用指导 4 eDRX 配置常见问题 4.1. 网络分配的 eDRX 周期或 PTW 与请求不符  问题 网络分配的 eDRX 周期或 PTW 与模块所请求的不同。  原因分析 3GPP 协议规定模块使用的 eDRX 周期需要与网络协商，由两者协商决定。 模块可通过 Attach request/TAU request 消息将一组 eDRX 参数发送给网络以告知网络模块可以支持 的和期望的 eDRX 参数配置，但最终可使用的 eDRX 参数由网络配置决定。网络将参考模块所请求的 eDRX 参数、APN 和 IMSI 为不同的模块配置不同的值，并在 Attach accept/TAU accept 消息中携带并发送给模 块。因此，网络分配的 eDRX 周期与模块请求的 eDRX 周期可能有所不同。 另外，eDRX 周期和 PTW 均应是 DRX 周期的整数倍，如果所请求的参数并非 DRX 周期的整数倍，则 网络分配的值会做相应的更改。 4.2. 无法开启 eDRX 功能  问题 通过软件配置启用 eDRX 后，eDRX 参数配置实际无法生效；无论配置什么 eDRX 参数，模块均按照 DRX 模式工作。  原因分析 启用 eDRX 后无法生效的，请咨询网络运营商，以确认所用 USIM 卡在网络侧是否已开通 eDRX 功能， 以及该卡签约的 APN 是否支持 eDRX 功能。 上海移远通信技术股份有限公司 13 / 20 BC25 eDRX 应用指导 5 eDRX 应用场景 5.1. 低功耗模式分类 BC25 模块支持三种低功耗应用模式：DRX、eDRX 和 PSM。 DRX 模式下，模块在每个 DRX 周期监听一次寻呼信道，功耗相对 eDRX 和 PSM 来说较高。 eDRX 就是模块不断地打开、关闭接收机。打开接收机时能够接收数据，关闭接收机时则无法接收数 据；eDRX 周期即由关闭接收机和打开接收机这两个完整的时段组成，支持配置的时长为 20.48s ~ 2.92h。 eDRX 功耗较 DRX 低。 与 eDRX 相比，PSM 打开、关闭接收机的频率更低，可低至几天打开一次接收机。PSM 周期内，模 块仅在接收机打开的时间内能够接收到数据，接收机关闭的时间内将无法接收下行数据。PSM 模式下，功 耗只有微安级，终端在此工作模式下才可能实现极低的功耗，如'一节电池用数年'。 5.2. 推荐的低功耗应用方案 根据不同的应用场景，移远通信推荐客户使用不同的低功耗模式。 5.2.1. 推荐使用 eDRX 的应用场景 eDRX 在兼顾低功耗的同时，可以实现网络的快速响应；比如可通过配置使模块实现休眠若干分钟， 再唤醒工作，再休眠若干分钟。因此 eDRX 适用于无需频繁发送数据、但需要实现快速响应的应用场景。 对于物流监控等隔几十分钟才需要进行一次数据业务的应用，即推荐使用 eDRX。 此外，对于监控时间要求可修改的应用，例如宠物跟踪器应用中，可通过设置不同的 eDRX 参数实现 不同场景下的应用需求。正常情况下，服务器可以每 2621s 或者 5242s 采集一次宠物位置信息；当宠物丢 失时，通过服务器修改 eDRX 参数，模块接收到控制信息后，重新配置 eDRX 周期为 20.48s 或者 40.96s， 服务器即可每 20.48s 或者 40.96s 采集一次宠物位置信息。这样可以最大程度地平衡客户需求及设备省电 需求。 上海移远通信技术股份有限公司 14 / 20 BC25 eDRX 应用指导 5.2.2. 推荐使用 DRX 的应用场景 共享单车锁、智能锁等应用场景中，实时性要求较高（远程开锁之后，开锁动作应立即响应并完成）， 此时建议使用 DRX 方案。 5.2.3. 推荐使用 PSM 的应用场景 对于远程水表/煤气表类的表计行业应用，一般情况下几天或更久才需要给服务器传输一次用水/用气量 数据即可满足需求，这类应用推荐使用 PSM。 上海移远通信技术股份有限公司 15 / 20 BC25 eDRX 应用指导 6 eDRX 耗流数据 6.1. BC25（标准版本） eDRX 耗流 表 1：BC25（标准版本）耗流数据（中国移动 NB-IoT 实网） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 1.22mA 1.56mA @ PTW=10.24s 1.07mA @ PTW=5.12s 图 3：BC25（标准版本）DRX 耗流示意图（DRX 周期=2.56s） 上海移远通信技术股份有限公司 16 / 20 BC25 eDRX 应用指导 图 4：BC25（标准版本）eDRX 耗流示意图（eDRX 周期=20.48s） 图 5：BC25（标准版本）eDRX 耗流示意图（eDRX 周期=40.96s） 上海移远通信技术股份有限公司 17 / 20 6.2. BC25（低压版本） eDRX 耗流 表 2：BC25（低压版本）耗流数据（中国移动 NB-IoT 实网） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 1.47mA 1.86mA @ PTW=10.24s 1.39mA @ PTW=5.12s BC25 eDRX 应用指导 图 6：BC25（低压版本）DRX 耗流示意图（DRX 周期=2.56s） 上海移远通信技术股份有限公司 18 / 20 BC25 eDRX 应用指导 图 7：BC25（低压版本）eDRX 耗流示意图（eDRX 周期=20.48s） 图 8：BC25（低压版本）eDRX 耗流示意图（eDRX 周期=40.96s） 上海移远通信技术股份有限公司 19 / 20 BC25 eDRX 应用指导 7 附录 A 术语缩写 表 3：术语和缩写 术语 APN DRX eDRX IMSI NB-IoT NVM LTE PDCCH PSM PTW TAU 3GPP UE USIM 英文全称 Access Point Name Discontinuous Reception extended DRX International Mobile Subscriber Identity Narrowband Internet of Things Non-Volatile Memory Long Term Evolution Physical Downlink Control Channel Power Saving Mode Paging Time Window Tracking Area Update 3rd Generation Partnership Project User Equipment Universal Subscriber Identification Module 中文全称 接入点名称 非连续接收 扩展型非连续接收 国际移动用户识别码 窄带物联网 非易失性存储器 长期演进 物理下行控制信道 省电模式 寻呼时间窗 跟踪区更新 第三代合作伙伴计划 用户设备 全球用户身份模块 上海移远通信技术股份有限公司 20 / 20

BC26&BC20 eDRX 应用指导 NB-IoT 模块系列 版本：BC26&BC20_eDRX_应用指导_V1.0 日期：2019-10-24 状态：受控文件 www.quectel.com BC26&BC20 eDRX 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 23 文档历史 修订记录 版本 日期 作者 1.0 2019-10-24 饶晨 变更表述 初始版本 BC26&BC20 eDRX 应用指导 上海移远通信技术股份有限公司 2 / 23 BC26&BC20 eDRX 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 eDRX 简介............................................................................................................................................. 7 3 eDRX 配置相关命令.............................................................................................................................. 8 3.1. AT+CEDRXS eDRX 设置 ........................................................................................................ 8 3.2. AT+CEDRXRDP 查询 eDRX 状态..........................................................................................11 3.3. AT+QEDRXCFG eDRX 和 PTW 设置 ................................................................................... 13 4 eDRX 配置常见问题............................................................................................................................ 16 4.1. 网络分配的 eDRX 周期或 PTW 与请求不符............................................................................. 16 4.2. 无法开启 eDRX 功能 ................................................................................................................ 16 5 eDRX 应用场景 ................................................................................................................................... 17 5.1. 低功耗模式分类 ........................................................................................................................ 17 5.2. 推荐的低功耗应用方案 ............................................................................................................. 17 5.2.1. 推荐使用 eDRX 的应用场景 .......................................................................................... 17 5.2.2. 推荐使用 DRX 的应用场景 ............................................................................................ 18 5.2.3. 推荐使用 PSM 的应用场景 ............................................................................................ 18 6 eDRX 耗流数据 ................................................................................................................................... 19 6.1. BC26 eDRX 耗流 ..................................................................................................................... 19 6.2. BC20 eDRX 耗流 ..................................................................................................................... 21 7 附录 A 术语缩写 ................................................................................................................................. 23 上海移远通信技术股份有限公司 3 / 23 BC26&BC20 eDRX 应用指导 表格索引 表 1：BC26 耗流数据（中国移动 NB-IOT 实网） ............................................................................................. 19 表 2：BC20 耗流数据（中国移动 NB-IOT 实网 B8） ........................................................................................ 21 表 3：术语和缩写............................................................................................................................................... 23 上海移远通信技术股份有限公司 4 / 23 BC26&BC20 eDRX 应用指导 图片索引 图 1：DRX 示意图 ............................................................................................................................................... 7 图 2：EDRX 示意图 ............................................................................................................................................. 7 图 3：BC26 DRX 耗流示意图（DRX 周期=2.56S） ......................................................................................... 19 图 4：BC26 EDRX 耗流示意图（EDRX 周期=20.48S）................................................................................... 20 图 5：BC26 EDRX 耗流示意图（EDRX 周期=40.96S）................................................................................... 20 图 6：BC20 DRX 耗流示意图（DRX 周期=2.56S） ......................................................................................... 21 图 7：BC20 EDRX 耗流示意图（EDRX 周期=20.48S）................................................................................... 22 图 8：BC20 EDRX 耗流示意图（EDRX 周期=40.96S）................................................................................... 22 上海移远通信技术股份有限公司 5 / 23 BC26&BC20 eDRX 应用指导 1 引言 移远通信一直关注模块功耗的优化，以确保客户终端产品整体功耗最大程度的降低。随着物联网通信 技术的迅速发展以及节能减排环保意识的不断加强，移动通信将提供更多不同的低功耗方案以满足客户对 其终端产品越来越严苛的功耗要求。 NB-IoT 作为蜂窝系统中一项全新的无线接入技术，对功耗有更加严苛的要求，例如其终端可能要求一 块电池可维持正常工作长达数年之久。为了进一步降低终端功耗、满足终端设备对极低功耗的需求，移远 通信 NB-IoT 模块均支持低功耗方案。 移远通信 BC26 和 BC20 模块支持 DRX、eDRX 和 PSM 等多种低功耗方案。本文档主要介绍如何通 过 eDRX 的不同参数配置，实现该模块在不同场景下达到功耗与实时性需求的平衡。 上海移远通信技术股份有限公司 6 / 23 BC26&BC20 eDRX 应用指导 2 eDRX 简介 DRX 是一种节省终端功耗的工作模式，其基本原理是让模块周期性地进入休眠模式；休眠期间，模块 将不监听 PDCCH、关闭收发单元，以降低其功耗。 DRX 作用于 Idle 态中，通过在 Idle 态中周期性监听寻呼的方式来降低模块功耗，示意图如下所示。但 DRX 参数由网络决定，模块无法修改也无法建议网络修改。 图 1：DRX 示意图 为进一步降低功耗，NB-IoT 不仅支持传统 LTE 的 DRX 模式，还支持扩展的 DRX 周期，即 eDRX。eDRX 目的与 DRX 相同，均是通过让模块周期性进入休眠状态以达到降低功耗的目的。其基本的原理是将 Idle 态 分成寻呼期和休眠期：在寻呼期，模块的工作模式和 LTE 的 DRX 一致；在休眠期，模块不监听下行寻呼。 相比 DRX，eDRX 可支持更长的寻呼周期，以达到进一步降低功耗的目的，示意图如下所示： 图 2：eDRX 示意图 eDRX 模式下，模块只在 PTW 内按 DRX 周期监听下行寻呼、接收下行业务（打开接收机）；如果在休 眠期有数据发给模块，模块并不能及时接收，只能等到当前 eDRX 周期完毕后再次进入 PTW 监听寻呼。因 此，eDRX 模式下，模块功耗的降低以实时性为'代价'，实际应用时需要根据业务模型，确定合适的 eDRX 周期和 PTW 值，以达到功耗与实时性的平衡。 上海移远通信技术股份有限公司 7 / 23 BC26&BC20 eDRX 应用指导 3 eDRX 配置相关命令 如下命令可以设置不同的 eDRX 参数，以实现不同应用场景下的多样应用需求。如果 AT 命令执行报错 或需了解相关 AT 命令的更多详情，请参考 Quectel_BC26&BC20_AT_命令手册。 3.1. AT+CEDRXS eDRX 设置 设置命令用于设置 UE 的 eDRX 参数，即设置 UE 是否使用 eDRX 以及指定接入技术请求的 eDRX 值。 当=2 且网络提供的 eDRX 参数发生变化时，该设置命令还可用于控制 URC +CEDRXP: [,[,[,]]]的上 报。 该设置命令包含一种特殊形式：AT+CEDRXS=3。此形式的命令将禁用 eDRX 且之前通过 AT+CEDRXS 所配置的所有参数都将被清除，或者被设置为默认值（若有）。 AT+CEDRXS eDRX 设置 测试命令 AT+CEDRXS=? 响应 +CEDRXS: (支持的取值),(支持的取值), (支持的取值) 查询命令 AT+CEDRXS? OK 响应 +CEDRXS: , [+CEDRXS: ,] [...] 设置命令 AT+CEDRXS=[,[,< Requested_eDRX_value>]] OK 响应 OK 若出现任何错误： ERROR 或者 上海移远通信技术股份有限公司 8 / 23 最大响应时间 生效机制 BC26&BC20 eDRX 应用指导 +CME ERROR: 300 毫秒 立即生效；参数设置将保存至 NVM 参数 整型。启用或禁用 eDRX。该参数适用于所有指定的接入技术类型，即的 最 新设置将对所有指定的取值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 并启用 URC +CEDRXP:[,[,< NW-provided_eDRX_value>[,]]]上报 3 恢复参数配置为默认值（若有） 整型。接入技术类型。 0 未使用 eDRX 的接入技术，该参数取值仅在 URC 中使用 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 上海移远通信技术股份有限公司 9 / 23 BC26&BC20 eDRX 应用指导 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时间窗。 NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 举例 AT+CEDRXS=1,5,'0101' OK AT+CEDRXS? +CEDRXS: 5,'0101' OK AT+CEDRXS=? +CEDRXS: (0-3),(5),('0000'-'1111') OK 上海移远通信技术股份有限公司 10 / 23 BC26&BC20 eDRX 应用指导 3.2. AT+CEDRXRDP 查询 eDRX 状态 若 eDRX 用于 UE 当前注册的小区，执行命令将返回、、 和。 如果 UE 当前注册的小区未使用 eDRX，则仅返回且值为 0。 AT+CEDRXRDP 查询 eDRX 状态 测试命令 AT+CEDRXRDP=? 执行命令 AT+CEDRXRDP 响应 OK 响应 +CEDRXRDP: [,[,< NW-provided_eDRX_value>[,]]] OK 最大响应时间 生效机制 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 / 参数 整型。接入技术类型。AT+CEDRXS?用于指定接入技术类型与请求的 eDRX 值之 间的关系。 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 上海移远通信技术股份有限公司 11 / 23 BC26&BC20 eDRX 应用指导 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时间窗。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 举例 AT+CEDRXRDP +CEDRXRDP: 5,'0010','1110','0101' OK AT+CEDRXRDP=? OK 上海移远通信技术股份有限公司 12 / 23 BC26&BC20 eDRX 应用指导 3.3. AT+QEDRXCFG eDRX 和 PTW 设置 设置命令可设置 UE 的 eDRX/PTW 参数，即控制 UE 是否使用 eDRX、请求的 eDRX 值以及指定接入 技术的 PTW 值。 AT+CEDRXS eDRX 和 PTW 设置 测试命令 AT+QEDRXCFG=? 响应 +QEDRXCFG: (支持的取值),(支持的取 值),(支持的取值),(支持的取值) 查询命令 AT+QEDRXCFG? OK 响应 +QEDRXCFG: ,, 设置命令 AT+QEDRXCFG=[,[,[,]]] OK 响应 OK 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 生效机制 立即生效；参数设置将保存至 NVM 参数 整型。启用或禁用 eDRX。此参数适用于所有指定接入技术，即的最新设置将 对所有指定的值生效。 0 禁用 eDRX 1 启用 eDRX 2 启用 eDRX 和 URC +CEDRXP: [,[, [,]]]上报 3 恢复默认参数 整型。接入技术类型。AT+CEDRXS?用于指定接入技术与请求的 eDRX 值之间的关系。 0 未使用 eDRX 的接入技术，此参数仅用于 URC 中。 5 E-UTRAN（NB-S1 模式） 字符串类型，半字节（4 位）格式。UE 请求的 eDRX 周期。NB-S1 模 式。 上海移远通信技术股份有限公司 13 / 23 BC26&BC20 eDRX 应用指导 位数 4 3 2 0 0 1 0 0 1 0 1 0 1 0 0 1 0 1 1 0 1 1 1 0 1 1 0 1 1 1 11 1 1 E-UTRAN eDRX 周期 0 20.48 秒 1 40.96 秒 1 81.92 秒 1 163.84 秒 0 327.68 秒 1 655.36 秒 0 1310.72 秒 1 2621.44 秒 0 5242.88 秒 1 10485.76 秒 字符串类型，半字节（4 位）格式。请求的寻呼时间窗。 NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 字符串类型，半字节（4 位）格式。网络下发的 eDRX 周期。NB-S1 模式。 位数 4 3 2 1 E-UTRAN eDRX 周期 0 0 1 0 20.48 秒 0 0 1 1 40.96 秒 0 1 0 1 81.92 秒 1 0 0 1 163.84 秒 1 0 1 0 327.68 秒 1 0 1 1 655.36 秒 1 1 0 0 1310.72 秒 1 1 0 1 2621.44 秒 上海移远通信技术股份有限公司 14 / 23 BC26&BC20 eDRX 应用指导 1 1 1 0 5242.88 秒 1 1 1 1 10485.76 秒 字符串类型，半字节（4 位）格式。网络下发的寻呼时 间窗。NB-S1 模式。 位数 4 3 2 1 寻呼时间窗长度 0 0 0 0 2.56 秒 0 0 0 1 5.12 秒 0 0 1 0 7.68 秒 0 0 1 1 10.24 秒 0 1 0 0 12.8 秒 0 1 0 1 15.36 秒 0 1 1 0 17.92 秒 0 1 1 1 20.48 秒 1 0 0 0 23.04 秒 1 0 0 1 25.6 秒 1 0 1 0 28.16 秒 1 0 1 1 30.72 秒 1 1 0 0 33.28 秒 1 1 0 1 35.84 秒 1 1 1 0 38.4 秒 1 1 1 1 40.96 秒 上海移远通信技术股份有限公司 15 / 23 BC26&BC20 eDRX 应用指导 4 eDRX 配置常见问题 4.1. 网络分配的 eDRX 周期或 PTW 与请求不符  问题 网络分配的 eDRX 周期或 PTW 与模块所请求的不同。  原因分析 3GPP 协议规定模块使用的 eDRX 周期需要与网络协商，由两者协商决定。 模块可通过 Attach request/TAU request 消息将一组 eDRX 参数发送给网络以告知网络模块可以支持 的和期望的 eDRX 参数配置，但最终可使用的 eDRX 参数由网络配置决定。网络将参考模块所请求的 eDRX 参数、APN 和 IMSI 为不同的模块配置不同的值，并在 Attach accept/TAU accept 消息中携带并发送给模 块。因此，网络分配的 eDRX 周期与模块请求的 eDRX 周期可能有所不同。 另外，eDRX 周期和 PTW 均应是 DRX 周期的整数倍，如果所请求的参数并非 DRX 周期的整数倍，则 网络分配的值会做相应的更改。 4.2. 无法开启 eDRX 功能  问题 通过软件配置启用 eDRX 后，eDRX 参数配置实际无法生效；无论配置什么 eDRX 参数，模块均按照 DRX 模式工作。  原因分析 启用 eDRX 后无法生效的，请咨询网络运营商，以确认所用 USIM 卡在网络侧是否已开通 eDRX 功能， 以及该卡签约的 APN 是否支持 eDRX 功能。 上海移远通信技术股份有限公司 16 / 23 BC26&BC20 eDRX 应用指导 5 eDRX 应用场景 5.1. 低功耗模式分类 BC26 和 BC20 模块支持三种低功耗应用模式：DRX、eDRX 和 PSM。 DRX 模式下，模块在每个 DRX 周期监听一次寻呼信道，功耗相对 eDRX 和 PSM 来说较高。 eDRX 就是模块不断地打开、关闭接收机。打开接收机时能够接收数据，关闭接收机时则无法接收数 据；eDRX 周期即由关闭接收机和打开接收机这两个完整的时段组成，支持配置的时长为 20.48s ~ 2.92h。 eDRX 功耗较 DRX 低。 与 eDRX 相比，PSM 打开、关闭接收机的频率更低，可低至几天打开一次接收机。PSM 周期内，模 块仅在接收机打开的时间内能够接收到数据，接收机关闭的时间内将无法接收下行数据。PSM 模式下，功 耗只有微安级，终端在此工作模式下才可能实现极低的功耗，如'一节电池用数年'。 5.2. 推荐的低功耗应用方案 根据不同的应用场景，移远通信推荐客户使用不同的低功耗模式。 5.2.1. 推荐使用 eDRX 的应用场景 eDRX 在兼顾低功耗的同时，可以实现网络的快速响应；比如可通过配置使模块实现休眠若干分钟， 再唤醒工作，再休眠若干分钟。因此 eDRX 适用于无需频繁发送数据、但需要实现快速响应的应用场景。 对于物流监控等隔几十分钟才需要进行一次数据业务的应用，即推荐使用 eDRX。 此外，对于监控时间要求可修改的应用，例如宠物跟踪器应用中，可通过设置不同的 eDRX 参数实现 不同场景下的应用需求。正常情况下，服务器可以每 2621s 或者 5242s 采集一次宠物位置信息；当宠物丢 失时，通过服务器修改 eDRX 参数，模块接收到控制信息后，重新配置 eDRX 周期为 20.48s 或者 40.96s， 服务器即可每 20.48s 或者 40.96s 采集一次宠物位置信息。这样可以最大程度地平衡客户需求及设备省电 需求。 上海移远通信技术股份有限公司 17 / 23 BC26&BC20 eDRX 应用指导 5.2.2. 推荐使用 DRX 的应用场景 共享单车锁、智能锁等应用场景中，实时性要求较高（远程开锁之后，开锁动作应立即响应并完成）， 此时建议使用 DRX 方案。 5.2.3. 推荐使用 PSM 的应用场景 对于远程水表/煤气表类的表计行业应用，一般情况下几天或更久才需要给服务器传输一次用水/用气量 数据即可满足需求，这类应用推荐使用 PSM。 上海移远通信技术股份有限公司 18 / 23 BC26&BC20 eDRX 应用指导 6 eDRX 耗流数据 6.1. BC26 eDRX 耗流 表 1：BC26 耗流数据（中国移动 NB-IoT 实网） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 0.47mA 0.40mA @ PTW=10.24s 0.31mA @ PTW=5.12s 图 3：BC26 DRX 耗流示意图（DRX 周期=2.56s） 上海移远通信技术股份有限公司 19 / 23 BC26&BC20 eDRX 应用指导 图 4：BC26 eDRX 耗流示意图（eDRX 周期=20.48s） 图 5：BC26 eDRX 耗流示意图（eDRX 周期=40.96s） 上海移远通信技术股份有限公司 20 / 23 6.2. BC20 eDRX 耗流 BC26&BC20 eDRX 应用指导 表 2：BC20 耗流数据（中国移动 NB-IoT 实网 B8） 模式 DRX @ DRX 周期=2.56s eDRX @ eDRX 周期=20.48s eDRX @ eDRX 周期=40.96s 实网下平均耗流 0.51mA 0.42mA @ PTW=5.12s 0.39mA @ PTW=10.24s 图 6：BC20 DRX 耗流示意图（DRX 周期=2.56s） 上海移远通信技术股份有限公司 21 / 23 BC26&BC20 eDRX 应用指导 图 7：BC20 eDRX 耗流示意图（eDRX 周期=20.48s） 图 8：BC20 eDRX 耗流示意图（eDRX 周期=40.96s） 上海移远通信技术股份有限公司 22 / 23 BC26&BC20 eDRX 应用指导 7 附录 A 术语缩写 表 3：术语和缩写 术语 APN DRX eDRX IMSI NB-IoT NVM LTE PDCCH PSM PTW TAU 3GPP UE USIM 英文全称 Access Point Name Discontinuous Reception extended DRX International Mobile Subscriber Identity Narrowband Internet of Things Non-Volatile Memory Long Term Evolution Physical Downlink Control Channel Power Saving Mode Paging Time Window Tracking Area Update 3rd Generation Partnership Project User Equipment Universal Subscriber Identification Module 中文全称 接入点名称 非连续接收 扩展型非连续接收 国际移动用户识别码 窄带物联网 非易失性存储器 长期演进 物理下行控制信道 省电模式 寻呼时间窗 跟踪区更新 第三代合作伙伴计划 用户设备 全球用户身份模块 上海移远通信技术股份有限公司 23 / 23

EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 LTE Standard 模块系列 版本：1.1 日期：2023-06-13 状态：受控文件 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗 旨。如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料 的使用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情 况下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保 护和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-01-10 2023-06-13 作者 Wayne WEI/ Chester WANG/ Mandy WANG Josiah LI 变更表述 初始版本 1. 更新适用模块： ⚫ 新增 EC20-CN、EG21-GL 和 EG25-GL； ⚫ 删除 EP200F 和 EC20 R2.0； ⚫ 更新 EC20 R2.1 为 EC20-CE。 2. 新增模块支持的物理存储媒介 EFS 及其相关内容。 3. 新增 AT 命令说明和 AT 示例说明（第 2.1 和 2.2 章）。 4. 更新参数和的取值范 围（第 2.3.1~2.3.6 章）。 5. 新增 AT+QFUPL 和 AT+QFDWL 查询命令（第 2.3.4 和 2.3.5 章）。 6. 新增 AT+QFDWL、AT+QFOPEN 和 AT+QFMOV 举例内容（第 2.3.5、2.3.6 和 2.3.13 章）。 7. 新增以下命令及其相关举例（第 2.3.14~2.3.18 和 3.3 章）： ⚫ AT+QFFLUSH ⚫ AT+QUSBWAITTIME ⚫ AT+QFCWD ⚫ AT+QFMKD ⚫ AT+QFPWD 8. 新增错误码 404（第 4 章）。 上海移远通信技术股份有限公司 3 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 目录 文档历史 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 7 1.2. FILE AT 命令使用流程 ................................................................................................................ 8 1.3. 数据模式说明............................................................................................................................... 9 2 FILE AT 命令详解 ................................................................................................................................ 10 2.1. AT 命令说明 .............................................................................................................................. 10 2.1.1. 定义 ................................................................................................................................ 10 2.1.2. AT 命令语句 ................................................................................................................... 10 2.2. AT 示例声明 .............................................................................................................................. 11 2.3. AT 命令详解 .............................................................................................................................. 11 2.3.1. AT+QFLDS 获取存储器空间信息 ................................................................................ 11 2.3.2. AT+QFLST 列出存储媒介中的文件信息...................................................................... 12 2.3.3. AT+QFDEL 删除存储媒介中的文件............................................................................. 14 2.3.4. AT+QFUPL 上传文件到存储媒介 ................................................................................ 15 2.3.5. AT+QFDWL 下载存储媒介中的文件............................................................................ 17 2.3.6. AT+QFOPEN 打开文件 ............................................................................................... 18 2.3.7. AT+QFREAD 读取文件 ............................................................................................... 19 2.3.8. AT+QFWRITE 写入数据至文件................................................................................... 20 2.3.9. AT+QFSEEK 设置文件指针位置 ................................................................................. 21 2.3.10. AT+QFPOSITION 获取文件指针偏移量 ...................................................................... 22 2.3.11. AT+QFTUCAT 从文件指针处截取文件 ....................................................................... 22 2.3.12. AT+QFCLOSE 关闭文件 ............................................................................................. 23 2.3.13. AT+QFMOV 移动文件 ................................................................................................. 23 2.3.14. AT+QFFLUSH 将缓冲区内容强制写入文件 ................................................................ 25 2.3.15. AT+QUSBWAITTIME 设置 USB 等待时间.................................................................. 26 2.3.16. AT+QFCWD 设置当前工作文件夹或目录.................................................................... 27 2.3.17. AT+QFMKD 创建文件夹或目录................................................................................... 27 2.3.18. AT+QFPWD 显示当前工作文件夹或目录路径............................................................. 28 3 举例 ...................................................................................................................................................... 29 3.1. 上传或下载文件 ......................................................................................................................... 29 3.1.1. 上传文件 ......................................................................................................................... 29 3.1.1.1. 无 ACK 模式 ....................................................................................................... 29 3.1.1.2. ACK 模式 ............................................................................................................ 29 3.1.2. 下载文件 ......................................................................................................................... 30 3.2. 写入和读取文件 ......................................................................................................................... 30 3.2.1. 写入和读取 UFS 文件 ..................................................................................................... 30 3.2.2. 写入和读取 RAM 文件 .................................................................................................... 31 上海移远通信技术股份有限公司 4 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 3.2.3. 写入和读取 EFS 文件 ..................................................................................................... 31 3.3. 设置当前工作文件夹/目录和显示其路径.................................................................................... 32 4 错误代码 ............................................................................................................................................... 33 5 附录 术语缩写...................................................................................................................................... 35 上海移远通信技术股份有限公司 5 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型 ..................................................................................................................................... 10 表 3：错误代码列表.................................................................................................................................... 33 表 4：术语缩写 ........................................................................................................................................... 35 上海移远通信技术股份有限公司 6 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 1 引言 本文档主要介绍了与移远通信 EC2x、EG2x、EG9x 和 EM05 系列模块相关的 AT 命令，这些命令可以 指导用户在不同的物理存储媒介上进行文件操作。 模块支持的物理存储媒介如下： ⚫ UFS: 用户文件存储目录。Flash 文件系统上的一个特殊目录。 ⚫ SD: SD 卡目录。 ⚫ RAM: 随机存取存储器。相对于 UFS 来说，它读取速度更快但存储空间更小。重启模块时，RAM 中的文件会丢失。 ⚫ EFS: 加密文件系统。 文件名称表示存储位置。若文件名以 RAM:开头，则表示文件被存储在 RAM 中；若文件名以 SD:开头， 则表示文件被存储在 SD 卡中；若文件名以 EFS:开头，则表示文件被存储在 EFS 中；若文件被存储在 UFS 中，文件名无前缀。 备注 EG9x（EG95 和 EG91）模块不支持 SD 存储。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG2x 模块 EC20-CE EC20-CN EC21 系列 EC25 系列 EG21-G 上海移远通信技术股份有限公司 7 / 35 EG9x EM05 EG25-G EG21-GL EG25-GL EG91 系列 EG95 系列 EM05 系列 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 1.2. FILE AT 命令使用流程 用户可以参照以下步骤在存储媒介中上传/下载、打开/创建、及读取/写入文件： 第一步，通过 AT+QFUPL 上传文件至存储媒介，然后执行 AT+QFDWL 通过串行接口输出/下载文件。 第二步，使用 AT+QFOPEN 打开文件后，可写入或读取此文件，直到文件被 AT+QFCLOSE 关闭。 ⚫ 使用 AT+QFOPEN 打开文件时，可以通过参数将文件设置为覆盖模式，只读模式或其他 模式（有关更多信息，请参考第 2.3.6 章）。打开文件后，会分配，之后可 以通过操作文件。 ⚫ 文件打开后，可从当前文件位置通过 AT+QFWRITE 写入数据至文件，通过 AT+QFREAD 读取文 件数据。 ⚫ 用户可通过 AT+QFSEEK 设置文件位置，执行 AT+QFPOSITION 查询当前文件位置。 ⚫ AT+QFTUCAT 截取文件指针之后文件。 ⚫ AT+QFCLOSE 用来关闭文件，文件关闭后，就无效了。 用户可以通过以下几个命令管理存储媒介中的文件： 1. AT+QFLDS：获取存储媒介空间信息。 2. AT+QFLST：列出存储媒介中的文件信息。 3. AT+QFDEL：删除存储媒介中的文件。 上海移远通信技术股份有限公司 8 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 1.3. 数据模式说明 移远通信 EC2x、EG2x、EG9x 和 EM05 系列的 COM 口有两种工作模式，一是 AT 命令模式，另一种 为数据模式。AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；数据模式下，则被认为是数据。 ⚫ 进入数据模式 执行 AT+QFUPL、AT+QFDWL、AT+QFREAD 或 AT+QFWRITE 后，模块响应 CONNECT， COM 口进入数据模式。或执行 ATO 重新进入数据模式。 ⚫ 退出数据模式 用户可以通过输入+++或拉高 DTR（需先设置 AT&D1）使 COM 口退出数据模式。在退出数据模 式及返回响应之前，模块会中断进入数据模式命令的执行。在此情况下，COM 口无法通过执行 ATO 重新进入数据模式。 为防止+++被误认为是数据，用户应遵循以下要求： 1. 输入+++前 1 秒内不能输入其它任何数据； 2. 必须在 1 秒内输入+++，并且不能输入其它任何数据； 3. 输入+++后，等待模块响应 OK。响应 OK 表示 COM 口退出数据模式。 上海移远通信技术股份有限公司 9 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2 FILE AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 上海移远通信技术股份有限公司 10 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.2. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见，也不 代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或连续 性。 2.3. AT 命令详解 2.3.1. AT+QFLDS 获取存储器空间信息 该命令用于获取指定存储器的空间信息。 AT+QFLDS 获取存储器空间信息 测试命令 AT+QFLDS=? 设置命令 AT+QFLDS= 执行命令 AT+QFLDS 特性说明 响应 OK 响应 +QFLDS: , OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 响应 返回 UFS 空间信息： +QFLDS: , OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 存储媒介类型。 'UFS' UFS 'RAM' RAM 'SD' SD 卡 上海移远通信技术股份有限公司 11 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 'EFS' EFS 的可用空间。单位：字节。 的总空间。单位：字节。 UFS 中所有文件大小。单位：字节。 UFS 中的文件数量。 错误码。请参考第 4 章。 举例 AT+QFLDS='RAM' +QFLDS: 2616320,2621440 OK AT+QFLDS='UFS' +QFLDS: 49180672,49205248 OK AT+QFLDS='SD' +QFLDS: 251920384,253132800 OK AT+QFLDS='EFS' +QFLDS: 6852032,9000960 OK //查询 RAM 可用空间和总空间信息。 //查询 UFS 可用空间和总空间信息。 //查询 SD 卡可用空间和总空间信息。 //查询 EFS 可用空间和总空间信息。 2.3.2. AT+QFLST 列出存储媒介中的文件信息 该命令用于列出指定存储媒介中的单个或所有文件信息。 AT+QFLST 列出存储媒介中的文件信息 测试命令 AT+QFLST=? 响应 OK 设置命令 AT+QFLST= 响应 +QFLST: , [+QFLST: , […]] OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 上海移远通信技术股份有限公司 12 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 执行命令 AT+QFLST 特性说明 响应 返回存储在 UFS 中所有文件的空间信息： +QFLST: , [+QFLST: , […]] OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 列出的文件类型。 '*' 列出 UFS 中所有文件 '' 列出 UFS 中指定文件 'RAM:*' 列出 RAM 中所有文件 'RAM:' 列出 RAM 中指定文件 'SD:*' 列出 SD 卡中所有文件 'SD:' 列出 SD 卡中指定文件 'EFS:*' 列出 EFS 中所有文件 'EFS:' 列出 EFS 中指定文件 文件的具体名称。最大长度 80 字节。 文件大小。单位：字节。 错误码。请参考第 4 章。 举例 AT+QFLST='*' +QFLST: 'UFS:F_M12-1.bmp',562554 +QFLST: 'UFS:F_M12-10.bmp',562554 +QFLST: 'UFS:F_M12-11.bmp',562554 OK AT+QFLST='RAM:*' +QFLST: 'RAM:F_EM05-1.bmp',56554 +QFLST: 'RAM:F_EM05-10.bmp',56554 +QFLST: 'RAM:F_EM05-11.bmp',56554 OK AT+QFLST='SD:*' //列出 UFS 中所有文件。 //列出 RAM 中所有文件。 //列出 SD 卡中所有文件。 上海移远通信技术股份有限公司 13 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 +QFLST: 'SD:10b.txt',10 +QFLST: 'SD:50K.txt',51209 +QFLST: 'SD:94k.jpg',95811 OK AT+QFLST='EFS:*' //列出 EFS 中所有文件。 +QFLST: 'EFS:quecsdkConfig_BAK.ini',200 OK 2.3.3. AT+QFDEL 删除存储媒介中的文件 该命令用于删除指定存储媒介中的单个或所有文件。 AT+QFDEL 删除存储媒介中的文件 测试命令 AT+QFDEL=? 响应 +QFDEL: 设置命令 AT+QFDEL= OK 响应 OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 删除的文件名称。最大长度为 80 字节。 '*' 删除 UFS 中所有文件（不删除目录） '' 删除 UFS 中指定的文件 'RAM:*' 删除 RAM 中所有文件 'RAM:' 删除 RAM 中指定的文件 'SD:*' 删除 SD 卡中所有文件（不删除目录） 'SD:' 删除 SD 卡中指定的文件 'EFS:*' 删除 EFS 中所有文件 'EFS:' 删除 EFS 中指定的文件 错误码。请参考第 4 章。 上海移远通信技术股份有限公司 14 / 35 举例 AT+QFDEL=? +QFDEL: OK AT+QFDEL='*' OK AT+QFDEL='RAM:*' OK AT+QFDEL='SD:*' OK AT+QFDEL='EFS:*' OK EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.3.4. AT+QFUPL 上传文件到存储媒介 该命令用于上传文件到存储媒介，若上传的文件与存储媒介中的文件同名，则会上报错误。 执行设置命令并返回 CONNECT 后，模块会切换为数据模式。当上传的文件大小达到，或 达到时间内无数据输入，模块会自动退出数据模式。数据传输期间，用户可以通过执行+++或拉 高 DTR 使之退出数据模式，更多相关信息，请参考第 1.3 章。 AT+QFUPL 上传文件到存储媒介 测试命令 AT+QFUPL=? 响应 +QFUPL: [,(1-)[,(支持的范 围)[,(支持的列表)]]] 查询命令 AT+QFUPL? 设置命令 AT+QFUPL=[,[, [,]]] OK 响应 ERROR 响应 CONNECT TA 切换为数据模式（即透传模式），可输入二进制文件数据。 当输入数据的总大小达到或时间内无数 据输入时，TA 将切换回命令模式： +QFUPL: , OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 上海移远通信技术股份有限公司 15 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 特性说明 该命令立即生效。 参数配置不保存。 参数 的可用空间。有关详情，请参考第 2.3.1 章。 上传文件的名称。最大长度为 80 字节。 '' 上传至 UFS 中的文件名称 'RAM:' 上传至 RAM 中的文件名称 'SD:' 上传至 SD 卡中的文件名称 'EFS:' 上传至 EFS 中的文件名称 预计上传的文件大小。默认值：10240。单位：字节。该参数最大值应不超过。 实际上传的文件大小。单位：字节。 通过 USB/UART 输入数据的等待时间。范围：1~65535。默认值：5。单位：秒。 是否使用 ACK 模式。 0 关闭 ACK 模式 1 开启 ACK 模式 上传数据的校验和。 错误码。请参考第 4 章。 备注 1. 推荐使用 DOS 8.3 文件名格式。 2. 是基于异或的 16 位校验和。 如果字符数为奇数，则将最后一个字符设置为高 8 位，将低 8 位设置为 0，然后使用 XOR 运算符计 算校验和。+++序列可使 TA 结束数据传输并切换到命令模式。之前上传的数据将保留在文件中。 3. 执行命令时，必须在返回 CONNECT 后输入数据。 4. 在硬件流控制不起作用时，ACK 模式可避免在上传大文件时数据丢失。ACK 模式的工作原理如下： 1）运行 AT+QFUPL=,,,1 启用 ACK 模式。 2）模块输出 CONNECT。 3）MCU 发送 1 KB 字节数据，模块响应 A。 4）MCU 接收 A，然后发送下一个 1 KB 字节数据。 5）重复第 3）和 4）步骤，直到传输完成。 上海移远通信技术股份有限公司 16 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.3.5. AT+QFDWL 下载存储媒介中的文件 该命令用于从存储媒介中下载指定的文件。 AT+QFDWL 下载存储媒介中的文件 测试命令 AT+QFDWL=? 响应 +QFDWL: 设置命令 AT+QFDWL= OK 响应 CONNECT TA 切换为数据模式，可输出文件二进制数据。文件读取完后， TA 将切换回命令模式： +QFDWL: , OK 查询命令 AT+QFDWL? 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 响应 ERROR 该命令立即生效。 参数配置不保存。 参数 下载文件的名称。最大长度为 80 字节。 '' 下载的 UFS 文件名称 'RAM:' 下载的 RAM 文件名称 'SD:' 下载的 SD 文件名称 'EFS:' 下载的 EFS 文件名称 已下载数据的大小。 单位：字节。 已下载数据的校验和。 错误码。请参考第 4 章。 备注 1. +++序列会使 TA 结束数据传输并切换到命令模式。 2. 是基于异或的 16 位校验和。 上海移远通信技术股份有限公司 17 / 35 举例 AT+QFDWL=? +QFDWL: OK AT+QFDWL='EFS:quecsdkConfig_BAK.ini' CONNECT +QFDWL: 200,fe57 OK EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.3.6. AT+QFOPEN 打开文件 该命令用于打开文件并获取命令中使用的文件句柄，相关命令如 AT+QFREAD、AT+QFWRITE、 AT+QFSEEK、AT+QFPOSITION、AT+QFTUCAT 和 AT+QFCLOSE。 AT+QFOPEN 打开文件 测试命令 AT+QFOPEN=? 响应 +QFOPEN: [,(支持的范围)] 查询命令 AT+QFOPEN? OK 响应 +QFOPEN: ,, [+QFOPEN: ,, […]] 设置命令 AT+QFOPEN=[,] OK 响应 +QFOPEN: OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 打开的文件名称。最大长度为 80 字节。 '' 打开的 UFS 文件名称 上海移远通信技术股份有限公司 18 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 'RAM:' 打开的 RAM 文件名称 'SD:' 打开的 SD 文件名称 'EFS:' 打开的 EFS 文件名称 文件句柄。数据类型为 4 字节。 文件的打开模式。 0 若文件不存在，则会创建一个新文件；若文件存在，则直接打开文件。两种情 况中的文件皆可读写 1 若文件不存在，则会创建一个新文件；若文件存在，则清除并覆盖文件。两种 情况中的文件皆可读写 2 若文件存在，则打开文件，且文件只可读；若文件不存在，则响应错误 错误码。请参考第 4 章。 举例 AT+QFOPEN=? +QFOPEN: [,(0-2)] OK AT+QFOPEN? OK AT+QFOPEN='1.txt',0 +QFOPEN: 0 OK //打开已有 1.txt 文件获取文件指针。 2.3.7. AT+QFREAD 读取文件 该命令用于读取由文件句柄指定的文件数据。数据从文件指针的当前位置开始读取，文件指针属于文 件句柄。 AT+QFREAD 读取文件 测试命令 AT+QFREAD=? 响应 +QFREAD: [,] 设置命令 AT+QFREAD=[, ] OK 响应 CONNECT TA 切换到数据模式，当数据总大小超过时，TA 将切 换回命令模式： OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 上海移远通信技术股份有限公司 19 / 35 特性说明 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 该命令立即生效。 参数配置不保存。 参数 需要操作的文件句柄。 预计读取的文件长度，默认为文件长度。单位：字节。 实际读取的文件长度。单位：字节。 错误码。请参考第 4 章。 2.3.8. AT+QFWRITE 写入数据至文件 该命令用于将数据写入到文件。数据从文件指针的当前位置开始写入，文件指针属于文件句柄。 AT+QFWRITE 写入数据至文件 测试命令 AT+QFWRITE=? 响应 +QFWRITE: [,[,]] 设置命令 AT+QFWRITE=[,[,]] OK 响应 CONNECT TA 切换到数据模式。当写入数据的总大小超过或写 入时间超过，TA 将切换回命令模式： +QFWRITE: , OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 需要操作的文件句柄。 预计写入文件的长度，默认长度为 10 KB。此参数的最大值由 AT+QFUPL 的 决定。 通过 USB/UART 输入数据的等待时间。默认值：5；单位：秒。 实际写入数据的长度。单位：字节。 文件总长度。单位：字节。 错误码。请参考第 4 章。 上海移远通信技术股份有限公司 20 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.3.9. AT+QFSEEK 设置文件指针位置 该 命 令 用 于 设 置 文 件 指 针 到 指 定 的 位 置 ， 可 决 定 这 些 命 令 的 初 始 位 置 ， 如 AT+QFREAD 、 AT+QFWRITE、AT+QFPOSITION 和 AT+QFTUCAT。 AT+QFSEEK 设置文件指针位置 测试命令 AT+QFSEEK=? 响应 +QFSEEK: ,[,] 设置命令 AT+QFSEEK=,[, ] 特性说明 OK 响应 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 需要操作的文件句柄。 文件指针移动的字节数。 文件指针移动模式。 0 文件初始位置 1 文件指针当前位置 2 文件最终位置 错误码。请参考第 4 章。 备注 1. 若为 0 且超过文件大小，执行此命令会返回 ERROR。 2. 若为 1 且总文件大小和当前位置的文件指针超过文件大小，执行此命令会返回 ERROR。 3. 若为 2，文件句柄将向前移动。 上海移远通信技术股份有限公司 21 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.3.10. AT+QFPOSITION 获取文件指针偏移量 该命令用于从文件初始位置获取文件指针的偏移量。 AT+QFPOSITION 获取文件指针偏移量 测试命令 AT+QFPOSITION=? 响应 +QFPOSITION: 设置命令 AT+QFPOSITION= OK 响应 +QFPOSITION: OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 需要操作的文件句柄。 从初始位置起文件指针的偏移量。 错误码。请参考第 4 章。 2.3.11. AT+QFTUCAT 从文件指针处截取文件 该命令用于从文件指针位置之后截取所有文件。 AT+QFTUCAT 从文件指针处截取文件 测试命令 AT+QFTUCAT=? 响应 +QFTUCAT: 设置命令 AT+QFTUCAT= OK 响应 OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 上海移远通信技术股份有限公司 22 / 35 参数 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 需要操作的文件句柄。 错误码。请参考第 4 章。 2.3.12. AT+QFCLOSE 关闭文件 该命令用于关闭文件或结束对文件的操作。关闭文件后，文件句柄会被释放。除非通过 AT+QFOPEN 再次打开文件，否则不可再次使用文件句柄。 AT+QFCLOSE 关闭文件 测试命令 AT+QFCLOSE=? 响应 +QFCLOSE: 设置命令 AT+QFCLOSE= OK 响应 OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 需要操作的文件句柄。 错误码。请参考第 4 章。 2.3.13. AT+QFMOV 移动文件 该命令用于将文件从一个存储器移动到另一个存储器，仅支持将文件从 UFS 或 SD 移动到 RAM，不支 持从 RAM 移动到 UFS 或 SD。 AT+QFMOV 移动文件 测试命令 AT+QFMOV=? 响应 +QFMOV: ,,( 支 持 的 列表),(支持的列表) 设置命令 OK 响应 上海移远通信技术股份有限公司 23 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 AT+QFMOV=,,, 特性说明 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 源文件。最大长度为 80 字节。 '' UFS 中文件名为的源文件 'SD:' SD 中文件名为的源文件 目标文件。最大长度为 80 字节。 'RAM:' RAM 中文件名为的目标文件 移动文件后是否删除源文件。 0 移动后删除源文件，即剪切该文件 1 移动后不删除源文件，即复制该文件 如果目标文件已存在，是否覆盖目标文件。 0 如果目标文件已存在，不覆盖目标文件 1 如果目标文件已存在，覆盖目标文件 错误码。请参考第 4 章。 备注 执行 AT+QFMOV='filenamea','RAM:flienameb',,表示移动单个文件，用户可以将 UFS 中名为 filenamea 的文件移动到 RAM 中，并将其重命名为 filenameb。 举例 AT+QFMOV=? +QFMOV: ,,(0,1),(0,1) OK AT+QFMOV='1.txt','RAM:2.txt',1,1 OK 上海移远通信技术股份有限公司 24 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.3.14. AT+QFFLUSH 将缓冲区内容强制写入文件 该命令用于将缓冲区内容强制写入文件。 AT+QFFLUSH 将缓冲区内容强制写入文件 测试命令 AT+QFFLUSH=? 响应 +QFFLUSH: 设置命令 AT+QFFLUSH= OK 响应 OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 需要操作的文件句柄。 错误码。请参考第 4 章。 举例 AT+QFOPEN='1.txt',0 +QFOPEN: 4 OK AT+QFFLUSH=? +QFFLUSH: OK AT+QFFLUSH=4 OK AT+QFCLOSE=4 OK //UFS 下获取文件 1.txt 的句柄。 //关闭文件。 上海移远通信技术股份有限公司 25 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.3.15. AT+QUSBWAITTIME 设置 USB 等待时间 该命令用于设置 USB 等待时间。 AT+QUSBWAITTIME 设置 USB 等待时间 设置命令 AT+QUSBWAITTIME=[] 执行命令 AT+QUSBWAITTIME 响应 1）若 < 4 或者 > 100，则 ERROR 2）若 4<= <= 100，则 OK 响应 +QUSBWAITTIME: 特性说明 OK 该命令立即生效。 参数配置不保存。 参数 USB 等待时间。范围：4~100。超出取值范围会报错。默认值：10；单位：毫秒。 备注 若省略可选参数，则设置 USB 等待时间为上一次设置的参数。若此前没有设置 USB 等待时 间，则此次设置为默认值。 举例 AT+QUSBWAITTIME +QUSBWAITTIME: 10 OK AT+QUSBWAITTIME=6 OK AT+QUSBWAITTIME +QUSBWAITTIME: 6 OK AT+QUSBWAITTIME=2 ERROR //刚开始 USB 等待时间为 10 毫秒。 //设置 USB 等待时间为 6 毫秒。 //再次查看 USB 等待时间为 6 毫秒。 //设置 USB 等待时间为 2 毫秒，USB 等待时间超出 4~100 范围，报错。 上海移远通信技术股份有限公司 26 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 2.3.16. AT+QFCWD 设置当前工作文件夹或目录 该命令用于设置当前工作文件夹或目录，一般默认在 UFS 下，但不支持 RAM、SD 或 EFS。 AT+QFCWD 设置当前工作文件夹或目录 测试命令 AT+QFCWD=? 响应 +QFCWD: 设置命令 AT+QFCWD= OK 响应 OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 文件夹或目录名。 错误码。请参考第 4 章。 2.3.17. AT+QFMKD 创建文件夹或目录 该命令用于创建一个新的文件夹或目录，一般默认在 UFS 下，但不支持 RAM、SD 或 EFS。如果文件 夹或目录已经存在，则响应'+CME ERROR: 405'。 AT+ QFMKD 创建文件夹或目录 测试命令 AT+QFMKD=? 响应 +QFMKD: 设置命令 AT+QFMKD= OK 响应 OK 特性说明 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 上海移远通信技术股份有限公司 27 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 参数 文件夹或目录名。 错误码。请参考第 4 章。 举例 AT+QFMKD='EG91' OK AT+QFLST +QFLST: 'EG91',160 OK //在 UFS 创建名为 EG91 的文件夹或目录。 //列出新文件夹或目录信息。 2.3.18. AT+QFPWD 显示当前工作文件夹或目录路径 该命令用于显示当前工作文件夹或目录路径，一般默认在UFS下，但不支持RAM、SD或EFS。 AT+QFPWD 显示当前工作文件夹或目录路径 测试命令 AT+QFPWD=? 响应 +QFPWD: 设置命令 AT+QFPWD= OK 响应 +QFPWD: '' 特性说明 OK 若发生任何与 ME 功能有关的错误： +CME ERROR: 该命令立即生效。 参数配置不保存。 参数 文件夹名或目录名。 当前工作文件夹或目录路径。 错误码。请参考第 4 章。 上海移远通信技术股份有限公司 28 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 3 举例 3.1. 上传或下载文件 3.1.1. 上传文件 3.1.1.1. 无 ACK 模式 AT+QFUPL='test1.txt',10 CONNECT +QFUPL: 10,3938 OK AT+QFUPL='RAM:test1.txt',10 CONNECT +QFUPL: 10,6466 OK //上传 test1.txt 文本文件到 UFS。 //上传 test1.txt 文本文件到 RAM。 //获取已上传数据的字节数与校验和值。 3.1.1.2. ACK 模式 ACK 模式下传输数据更可靠。在无硬件流控情况下传输大文件时，推荐开启 ACK 模式避免数据丢失。 有关更多 ACK 模式详情，请参考 AT+QFUPL。 AT+QFUPL='RAM:test.txt',3000,5,1 CONNECT A A +QFUPL: 3000,B34A //上传文本文件 RAM:test.txt 到 RAM。 //接收 1024 字节数据后，模块会响应 A。然后输入下一个 1024 字节数据。 上海移远通信技术股份有限公司 29 / 35 OK 3.1.2. 下载文件 AT+QFDWL='RAM:test.txt' CONNECT +QFDWL: 10,613e OK EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 //从 RAM 中下载文本文件 RAM:test.txt。 //获取已下载数据的字节数与校验和值。 3.2. 写入和读取文件 3.2.1. 写入和读取 UFS 文件 AT+QFOPEN='test',0 +QFOPEN: 0 OK AT+QFWRITE=0,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=0,0,0 OK AT+QFREAD=0,10 CONNECT 10 OK AT+QFCLOSE=0 OK //打开文件获取文件指针。 //将 10 个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取文件的 10 个字节。 //关闭文件。 上海移远通信技术股份有限公司 30 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 3.2.2. 写入和读取 RAM 文件 AT+QFLDS='RAM' +QFLDS: 2606080,2621440 OK AT+QFOPEN='RAM:1',0 +QFOPEN: 3000 OK AT+QFWRITE=3000,10 CONNECT +QFWRITE: 10,10 OK AT+QFSEEK=3000,0,0 OK AT+QFREAD=3000,10 CONNECT OK AT+QFCLOSE=3000 OK //查询 RAM 空间信息。 //打开 RAM 中的文件。 //将 10 个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取数据。 //关闭文件。 3.2.3. 写入和读取 EFS 文件 AT+QFOPEN='EFS:TEST',0 +QFOPEN: 3 OK AT+QFWRITE=3,9 CONNECT +QFWRITE: 9,9 OK AT+QFSEEK=3,0,0 OK AT+QFREAD=3,9 CONNECT 9 //打开EFS中的文件。 //将9个字节写入文件。 //返回实际写入字节数和文件大小。 //设置文件指针为文件的初始位置。 //读取数据。 上海移远通信技术股份有限公司 31 / 35 OK AT+QFCLOSE=3 OK EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 //关闭文件。 3.3. 设置当前工作文件夹/目录和显示其路径 AT+QFMKD='EG91' OK AT+QFCWD='EG91' OK AT+QFPWD='UFS' +QFPWD: 'UFS: EG91' OK AT+QFMKD='EG92' OK AT+QFCWD='EG92' OK AT+QFPWD='UFS' +QFPWD: 'UFS: EG91EG92' OK //一般默认是在 UFS 下，创建名为 EG91 的文件夹或目录。 //设置 UFS: EG91 为当前工作文件夹或目录。 //显示当前工作文件夹或目录是 UFS: EG91。 //在 UFS:EG91 创建名为 EG92 的文件夹或目录。 //设置 UFS:EG91EG92 为当前工作文件夹或目录。 //显示当前工作文件夹/目录是 UFS: EG91EG92。 上海移远通信技术股份有限公司 32 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 4 错误代码 表示与移动设备或网络有关的错误码，下表中的错误码与本文档适用模块的文件操作有关。 表 3：错误代码列表 错误码 400 401 402 403 404 405 406 407 409 410 411 413 414 416 417 418 419 描述 Invalid input value Larger than the size of the file Read zero byte Drive full Not supported File not found Invalid file name File already exists Fail to write the file Fail to open the file Fail to read the file Reach the max number of file allowed to be opened The file read-only Invalid file descriptor Fail to list the file Fail to delete the file Fail to get disk info 上海移远通信技术股份有限公司 33 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 420 No space 421 Time out 423 File too large 425 Invalid parameter 426 File already opened 上海移远通信技术股份有限公司 34 / 35 EC2x&EG2x&EG9x&EM05 系列 FILE 应用指导 5 附录 术语缩写 表 4：术语缩写 缩写 ACK COM DOS DTR ME RAM SD TA UART UFS USB XOR 英文全称 Acknowledgement Communication Port Disk Operating System Data Terminal Ready Mobile Equipment Random Access Memory Secure Digital Terminal Adapter Universal Asynchronous Receiver-Transmitter User File Storage Universal Serial Bus Exclusive OR 中文全称 确认字符 串行通讯端口 磁盘操作系统 数据终端就绪 移动设备 随机存储器 安全数字存储器 终端适配器 通用异步收发传输器 用户文件存储 通用串行总线 异或 上海移远通信技术股份有限公司 35 / 35

BC26&BC20 TCP/IP 应用指导 LPWA 模块系列 版本：BC26&BC20_TCP/IP_应用指导_V1.0 日期：2019-07-26 状态：受控文件 www.quectel.com BC26&BC20 TCP/IP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 23 BC26&BC20 TCP/IP 应用指导 文档历史 修订记录 版本 日期 作者 1.0 2019-07-26 蒋涛 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 23 BC26&BC20 TCP/IP 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 图片索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 初始化工作 ............................................................................................................................................ 6 3 建立 TCP 连接....................................................................................................................................... 7 4 发送数据 ................................................................................................................................................ 8 4.1. 配置发送的数据格式................................................................................................................... 8 4.1.1. 发送的数据为 Text 字符串 ............................................................................................... 8 4.1.2. 发送的数据转换为 Hex 格式............................................................................................ 8 4.2. 配置在数据模式下是否回显........................................................................................................ 8 4.3. 发送 Text 字符串数据 ................................................................................................................. 9 4.3.1. 普通模式 .......................................................................................................................... 9 4.3.2. 定长数据模式................................................................................................................... 9 4.3.3. 不定长数据模式 ............................................................................................................. 10 4.4. 发送 Hex 字符串数据................................................................................................................ 10 4.4.1. 普通模式 ........................................................................................................................ 10 4.4.2. 定长数据模式..................................................................................................................11 4.4.3. 不定长数据模式 ............................................................................................................. 12 4.5. ACK 响应检查........................................................................................................................... 12 5 接收数据 .............................................................................................................................................. 13 5.1. 配置接收的数据格式................................................................................................................. 13 5.1.1. 接收的数据为 Text 字符串 ............................................................................................. 13 5.1.2. 接收的数据转换为 Hex 格式.......................................................................................... 13 5.2. 配置所接收数据的输出格式...................................................................................................... 14 5.2.1. 换行格式 ........................................................................................................................ 14 5.2.2. 逗号分隔格式................................................................................................................. 14 5.3. 所接收数据的存取方式 ............................................................................................................. 15 5.3.1. 缓存模式 ........................................................................................................................ 15 5.3.2. 缓存模式下显示长度...................................................................................................... 16 5.3.3. 直吐模式 ........................................................................................................................ 17 6 关闭连接 .............................................................................................................................................. 19 7 TCP 会话保活...................................................................................................................................... 20 8 附录 ..................................................................................................................................................... 21 8.1. 术语缩写 ................................................................................................................................... 21 8.2. TCP/UDP 应用时序图 .............................................................................................................. 22 上海移远通信技术股份有限公司 3 / 23 BC26&BC20 TCP/IP 应用指导 图片索引 图 1：TCP 应用时序图....................................................................................................................................... 22 图 2：UDP 应用时序图 ...................................................................................................................................... 23 上海移远通信技术股份有限公司 4 / 23 BC26&BC20 TCP/IP 应用指导 1 引言 该文档主要结合实例，介绍如何使用移远通信 BC26 和 BC20 模块内嵌的 TCP/IP 服务，以及使用过程 中的重要注意事项。 上海移远通信技术股份有限公司 5 / 23 BC26&BC20 TCP/IP 应用指导 2 初始化工作 AT+IPR=115200 OK //设置固定波特率为 115200 AT+CPIN? +CPIN: READY //查询 USIM 卡的 PIN 码是否已解 //已解 OK AT+CEREG? +CEREG: 0,1 //查询网成功 //找网已成功，如果未成功，可以多次查询 OK AT+CGPADDR? //找网成功后，可通过此命令获取模块 IP 地址 +CGPADDR: 1,10.57.39.119 OK 备注 请确保 TCP/UDP 操作在模块获取到 IP (+IP: xxx) 地址上报之后再进行。 上海移远通信技术股份有限公司 6 / 23 BC26&BC20 TCP/IP 应用指导 3 建立 TCP 连接 AT+QIOPEN=1,0,'TCP','220.180.239.212',8164,1234,0 //远程地址：220.180.239.212，端口：8164； 本地端口为 1234，如果将其指定为 0，模块将 自动分配一个可用的端口号 OK +QIOPEN: 0,0 //建立连接成功 //更多连接信息可通过如下方式进行查询 AT+QISTATE=1,0 //可查询连接状态信息 +QISTATE: 0,'TCP','220.180.239.212',8164,1234,2,1,0 //连接成功 OK AT+QIGETERROR +QIGETERROR: 0,operate successfully //获取最后一个 Socket 的错误码信息 //建立连接操作成功 OK 上海移远通信技术股份有限公司 7 / 23 BC26&BC20 TCP/IP 应用指导 4 发送数据 4.1. 配置发送的数据格式 4.1.1. 发送的数据为 Text 字符串 AT+QICFG='dataformat',0,0 //配置发送的数据格式为 Text 字符串（=0） //此为默认配置（Text 字符串） OK //配置完成后，会立即生效并自动保存至 NVRAM，无须重复配置 AT+QICFG='dataformat' +QICFG: 'dataformat',0,0 //查询配置是否成功 //查询结果：发送的数据格式为 Text 字符串（=0） OK 4.1.2. 发送的数据转换为 Hex 格式 AT+QICFG='dataformat',1,0 //配置发送的数据格式为 Hex 格式（=1） //此配置默认为=0（Text 字符串） OK //配置完成后，会立即生效并自动保存至 NVRAM，无须重复配置 AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 //查询配置是否成功 //查询结果：发送的数据格式为 Hex 格式（为=1） OK 4.2. 配置在数据模式下是否回显 AT+QICFG='echomode',0 //配置在数据模式（data mode）下将输入的数据不回显到 UART 串口 （=0） //此配置默认为=1（回显数据模式下输入的数据到 UART 串口） OK //配置完成；重启或退出深休眠后需要重新配置 AT+QICFG='echomode' //查询配置结果 +QICFG: 'echomode',0 //查询结果：不回显（=0） 上海移远通信技术股份有限公司 8 / 23 BC26&BC20 TCP/IP 应用指导 OK 4.3. 发送 Text 字符串数据 4.3.1. 普通模式 AT+QISEND=0,10,'1234567890' //发送 10 字节数据 1234567890 //注意命令中参数需要和实际长度保持一致 OK SEND OK AT+QISEND=0,17,'{'a':'b','b':'b'}' //发送 17 字节数据{'a':'b','b':'b'} //注意命令中参数需要和实际长度保持一致 //发送 JSON 格式等特殊字符数据时，必须使用双引号将数据包围 OK SEND OK 4.3.2. 定长数据模式 AT+QISEND=0,10 > 1234567890 OK SEND OK AT+QISEND=0,17 > {'a':'b','b':'b'} OK SEND OK AT+QICFG='echomode',0 OK AT+QISEND=0,10 > //发送 10 字节数据 //进入数据模式，等待数据输入 //必须输入 10 字节才会退出数据模式并发送 //发送 17 字节数据 //进入数据模式，等待数据输入 //进入数据模式，任何字符都是数据，无须用双引号包围 //必须输入 17 字节才会退出数据模式并发送 //配置在数据模式（data mode）下将输入的数据不回显到 UART 串口 （=0） //发送 10 字节数据 //进入数据模式，等待数据输入 上海移远通信技术股份有限公司 9 / 23 OK SEND OK BC26&BC20 TCP/IP 应用指导 //输入 10 字节数据：1234567890；此处不回显 1234567890，数据 输入完成后自动退出数据模式并发送 4.3.3. 不定长数据模式 AT+QISEND=0 > 1234567890 OK SEND OK AT+QISEND=0 > {'a':'b','b':'b'} OK SEND OK AT+QICFG='echomode',0 OK AT+QISEND=0 > OK SEND OK //发送不定长字节数据 //进入数据模式，等待数据输入 //输入数据后按 CTRL+Z 会退出数据模式并发送 //发送不定长字节数据 //进入数据模式，等待数据输入 //进入数据模式，任何字符都是数据，无须用双引号包围；输入数据后 按 CTRL+Z 会退出数据模式并发送 //配置在数据模式（data mode）下将输入的数据不回显到 UART 串口 （=0） //发送不定长字节数据 //进入数据模式，等待数据输入 //输入 10 字节数据：1234567890；此处不回显 1234567890，数据 输入完成后自动退出数据模式并发送 4.4. 发送 Hex 字符串数据 4.4.1. 普通模式 AT+QISENDEX=0,3,313233 //发送 Hex 字符串数据（模块自动将 Hex 数据 313233 转换为 Text 数 据 123 并发送到服务端） //注意需要满足 Hex 格式，否则转换会失败返回 ERROR 上海移远通信技术股份有限公司 10 / 23 OK SEND OK AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 OK AT+QISEND=0,3,313233 OK SEND OK 4.4.2. 定长数据模式 AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 OK AT+QISEND=0,10 > 31323334353637383930 OK SEND OK AT+QICFG='echomode',0 OK AT+QISEND=0,5 > OK SEND OK BC26&BC20 TCP/IP 应用指导 //注意命令中应该等于长度除以 2 //查询当前配置 //查询结果：发送的数据格式为 Hex 格式（=1） /发送 Hex 字符串数据（模块自动将 Hex 数据 313233 转换为 Text 数 据 123 并发送到服务端） //注意需要满足 Hex 格式，否则转换会失败返回 ERROR //注意命令中应该等于长度除以 2 //查询当前配置 //查询结果：为 1（Hex 格式） //发送 10 字节 Hex 数据 //进入数据模式，等待数据输入 //必须输入 20 字节才会退出数据模式并发送 //注意需要满足 Hex 格式，否则会返回 ERROR //注意命令中应该等于长度除以 2 //配置在数据模式（data mode）下将输入的数据不回显到 UART 串口 （=0） //发送 5 字节数据 //进入数据模式，等待数据输入: //输入数据 3132333435；此处不回显 3132333435，数据输入完成后 自动退出数据模式并发送 上海移远通信技术股份有限公司 11 / 23 4.4.3. 不定长数据模式 AT+QICFG='dataformat' +QICFG: 'dataformat',1,0 OK AT+QISEND=0 > 3132333435 OK SEND OK AT+QICFG='echomode',0 OK AT+QISEND=0 > OK SEND OK BC26&BC20 TCP/IP 应用指导 //查询当前配置 //查询结果：发送的数据格式为 Hex 格式（=1） //发送不定长字节数据 //进入数据模式，等待数据输入 //输入数据后按 CTRL+Z 会退出数据模式并发送 //注意需要满足 Hex 格式，否则会报 ERROR //配置在数据模式（data mode）下将输入的数据不回显到 UART 串口 （=0） //发送不定长字节数据 //进入数据模式，等待数据输入 //输入数据 3132333435；此处不回显 3132333435，数据输入完成后 自动退出数据模式并发送 4.5. ACK 响应检查 AT+QISEND=0,0 +QISEND: 94,94,0 OK //=0（查询已发送、已收到 ACK 响应以及未收到 ACK 响应的数据长度） //链路建立连接到断开连接过程中累计发送了 94 字节，94 个均收到 了 ACK 响应，0 个未响应 //连接断开后数据会重置为 0 上海移远通信技术股份有限公司 12 / 23 BC26&BC20 TCP/IP 应用指导 5 接收数据 5.1. 配置接收的数据格式 5.1.1. 接收的数据为 Text 字符串 AT+QICFG='dataformat',0,0 //配置接收的数据格式为 Text 字符串（=0） //此为默认配置（Text 字符串） OK //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置 AT+QICFG='dataformat' +QICFG: 'dataformat',0,0 //查询配置是否成功 //查询结果：接收的数据格式为 Text 字符串（=0） OK //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 +QIRD: 19 hi, i am tcp server //读取缓存中的数据（最大 512 字节） //读取到了 19 字节数据（包括空格）：hi, i am tcp server OK 5.1.2. 接收的数据转换为 Hex 格式 AT+QICFG='dataformat',0,1 //配置接收的数据格式为 Hex 格式（=1） //此配置默认为=0（Text 字符串） OK //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置 AT+QICFG='dataformat' +QICFG: 'dataformat',0,1 //查询配置是否成功 //查询结果：接收的数据格式为 Hex 格式（=1） OK //远程服务器向模块发送了'1234567890'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 上海移远通信技术股份有限公司 13 / 23 BC26&BC20 TCP/IP 应用指导 AT+QIRD=0,512 +QIRD: 10 31323334353637383930 OK //读取缓存中的数据（最大 512 字节） //读取到 10 字节 Text 数据 1234567890 后自动转换成 Hex 格式数据 5.2. 配置所接收数据的输出格式 5.2.1. 换行格式 AT+QICFG='viewmode',0 OK //配置所接收数据的输出格式为：data headerrndata（=0） //此为配置默认 //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置 AT+QICFG='viewmode' +QICFG: 'viewmode',0 //查询配置信息 // 查 询 结 果 ： 所 接 收 数 据 的 输 出 格 式 为 data headerrndata （=0） OK //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 +QIRD: 19 hi, i am tcp server //读取缓存中的数据（最大 512 字节） //读取到 19 字节数据 //所读取到的 19 字节数据为：'hi, i am tcp server' OK 5.2.2. 逗号分隔格式 AT+QICFG='viewmode',1 OK //配置所接收数据的输出格式为：data header,data（=1） //此命令配置默认为=0（data headerrndata） //配置完成后，会立即生效并自动保存到 NVRAM，无须重新配置 AT+QICFG='viewmode' +QICFG: 'viewmode',1 //查询配置信息 //查询结果：所接收数据的输出格式为 data header,data（=1） OK //远程服务器向模块发送了'hi, i am tcp server'消息 上海移远通信技术股份有限公司 14 / 23 BC26&BC20 TCP/IP 应用指导 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 //读取缓存中的数据（最大 512 字节） +QIRD: 19,hi, i am tcp server //读取到的数据长度和读取到的数据显示在同一行，用逗号分隔；读取到的 19 字节数据为 hi, i am tcp server OK 5.3. 所接收数据的存取方式 5.3.1. 缓存模式 建立连接配置： AT+QIOPEN=1,0,'TCP','220.180.239.212',8164,1234,0 //=0（缓存模式） //=0 为默认配置 //缓存模式下，需要用 AT+QIRD=读取数据 OK +QIOPEN: 0,0 //建立连接成功 AT+QISTATE=1,0 //查询连接状态信息 +QISTATE: 0,'TCP','220.180.239.212',8164,1234,2,1,0 //连接成功，=0（缓存模式） OK 连接建立后，可随时进行切换： AT+QISWTMD=0,0 OK //更改默认的数据存取方式后，可通过此命令切换回默认的缓存模式 //缓存模式下，需要用 AT+QIRD=读取数据 //配置完成后，将立即生效并自动保存到 NVRAM，无须重新配置 //立即生效 数据读取方法： //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 +QIRD: 19 hi, i am tcp server //读取缓存中的数据（最大 512 字节） //读取到 19 字节数据 //所读取到的 19 字节数据为：hi, i am tcp server OK 上海移远通信技术股份有限公司 15 / 23 BC26&BC20 TCP/IP 应用指导 +QIURC: 'recv',0,'buff full' //当缓存队列满了后，会主动上报此 URC，表示队列已满 备注 最大缓存队列节点数为 20 个，建议在缓存模式下，及时使用 AT+QIRD 命令读取数据，否则容易导致数 据丢失。 5.3.2. 缓存模式下显示长度 AT+QICFG='showlength',0 OK //在缓存模式下不显示所接收数据的长度和剩余读取长度 （） //此为默认配置 //配置完成后，将立即生效并自动保存到 NVRAM，无须重新配置 AT+QICFG='showlength' +QICFG: 'showlength',0 //查询配置信息 //查询结果：（不显示所接收数据的长度和剩余 读取长度） OK //远程服务器向模块发送了'hi, i am tcp server'消息 +QIURC: 'recv',0 //提示模块已收到远程服务器下发的数据 AT+QIRD=0,512 +QIRD: 19 hi, i am tcp server //读取缓存中的数据（最大 512 字节） //此处未显示读取剩余长度 //读取到的 19 字节数据为：'hi, i am tcp server' OK AT+QICFG='showlength',1 OK //在缓存模式下显示接收数据长度和剩余读取长度 （） //此配置默认为<show_length_mode=0（不显示所接收数据的长度和剩余 读取长度） //配置完成后，将立即生效并自动保存到 NVRAM，无须重新配置 AT+QICFG='showlength' +QICFG: 'showlength',1 //查询配置信息 //查询结果：=1（显示接收数据长度和剩余读取长 度） OK //远程服务器向模块发送了'hi, i am tcp server'消息 上海移远通信技术股份有限公司 16 / 23 +QIURC: 'recv',0,19 AT+QIRD=0,10 +QIRD: 10,9 hi, i am t OK AT+QIRD=0,10 +QIRD: 9,0 cp server OK AT+QIRD=0,10 +QIRD: 0 OK BC26&BC20 TCP/IP 应用指导 //提示模块已收到远程服务器下发的数据，所接收数据长度为 19 字节 //读取缓存中的数据（一次最大读取 10 字节） //此处显示已经读取到 10 字节数据，还剩余 9 字节未读取 //所读取的 10 字节数据为 hi, i am t //此处显示已经读取到剩余的 9 字节，全部数据已经读完 //所读取的 9 字节数据为 cp server //此处显示无数据未读取 5.3.3. 直吐模式 建立连接配置： AT+QIOPEN=1,0,'TCP','220.180.239.212',8164,1234,1 //=1（直吐模式） //默认配置为=0（缓存模式） //后续收到数据时，直接通过+QIURC: 'recv'将数据推送出来 OK +QIOPEN: 0,0 //建立连接成功 AT+QISTATE=1,0 //查询连接状态信息 +QISTATE: 0,'TCP','220.180.239.212',8164,1234,2,1,1 //连接成功，=1（直吐模式） OK 连接建立后，可随时进行切换： AT+QISWTMD=0,1 OK //切换所接收数据的存取方式为直吐模式 //后续收到数据时，直接通过+QIURC: 'recv'将数据推送出来 //立即生效 上海移远通信技术股份有限公司 17 / 23 BC26&BC20 TCP/IP 应用指导 数据读取方法：无须主动使用命令读取，直接显示 +QIURC: 'recv',0,19 hi, i am tcp server //提示模块已收到远程服务器下发的数据，所接收数据长度为 19 字节 //自动推送了所接收到的 19 字节数据 hi, i am tcp server OK 上海移远通信技术股份有限公司 18 / 23 BC26&BC20 TCP/IP 应用指导 6 关闭连接 AT+QICLOSE=0 OK CLOSE OK //主动断开 //断开连接成功 备注 考虑网络异常等因素，建议关闭连接前，先进行发送数据的 ACK 响应检查，检查无异后再关闭连接，如 果存在，关闭后重新建立链路重发未 ACK 的数据。 上海移远通信技术股份有限公司 19 / 23 BC26&BC20 TCP/IP 应用指导 7 TCP 会话保活 关于多长时间没有数据交互，就会释放资源，目前来说，没有一个明确的值，目前测试情况是 10 分钟 内，基本就可以保持端口资源不会被释放。如果需要保持长连接，建议每隔一定时间(10 分钟以内)就向服 务器发送一个短数据包，通过这个方法可以进行会话保活。 基于此，如果很长时间不用发送数据，在重新发数据时可以通过如下方法进行会话校验： AT+QISEND=0,3,'ACK' OK //先发一个短包（发送的数据可以根据需求自由定制） SEND OK AT+QISEND=0,0 +QISEND: 3,0,3 //再发送一个校验包 //发送的心跳字节，均未得到服务器的响应 SEND OK //等待 30 秒后 +QIURC: 'closed',0 //会收到提示连接已断开的 URC，此时会话已经被关闭，需要重连 //如果一直未收到提示连接已断开的 URC，需要等待 120 秒后 AT+QISEND=0,0 +QISEND: 3,0,3 //再发送一个校验包 //发送的心跳字节，均未得到服务器的响应 SEND OK //如果此时仍未收到服务器响应，需要主动关闭连接并重连 AT+QICLOSE=0 OK //主动断开 CLOSE OK //断开连接成功 上海移远通信技术股份有限公司 20 / 23 BC26&BC20 TCP/IP 应用指导 8 附录 8.1. 术语缩写 表 1：术语缩写 术语 MCU LWIP TCP UDP HEX NVRAM 描述 Microprogrammed Control Unit Lightweight TCP/IP Protocol Transmission Control Protocol User Datagram Protocol Hexadecimal Non-Volatile Random Access Memory 微程序控制器 轻量级 TCP/IP 协议栈 传输控制协议 用户数据报协议 十六进制 非易失性随机访问存储器 上海移远通信技术股份有限公司 21 / 23 8.2. TCP/UDP 应用时序图 BC26&BC20 TCP/IP 应用指导 上海移远通信技术股份有限公司 图 1：TCP 应用时序图 22 / 23 BC26&BC20 TCP/IP 应用指导 上海移远通信技术股份有限公司 图 2：UDP 应用时序图 23 / 23

BG95&BG77&BG600L Series HTTP(S) Application Note LPWA Module Series Version: 1.1 Date: 2021-11-30 Status: Released LPWA Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal nonexclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 1 / 52 LPWA Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any thirdparty intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 2 / 52 LPWA Module Series About the Document Revision History Version 1.0 1.1 Date 2019-08-12 2021-11-30 Author Terrence YANG/ Sherlock ZHAO Water WANG/ Adonis CHEN Description Initial 1. Added the applicable module BG600L-M3. 2. Extended the value range of in AT+QHTTPCFG (Chapter 2.3.1). 3. Added the following AT commands (Chapter 2.3.1): AT+QHTTPCFG='auth',:; AT+QHTTPCFG='custom_header'[,'']. 4. Extended the value range of in AT+QHTTPURL (Chapter 2.3.2). 5. Added AT+QHTTPPUT (Chapter 2.3.6). 6. Added AT+QHTTPPUTFILE (Chapter 2.3.7). 7. Added examples about sending HTTP(S) PUT requests (Chapter 3.1.3 and Chapter 3.2.3). BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 3 / 52 LPWA Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 6 1 Introduction ......................................................................................................................................... 7 1.1. Applicable Modules .................................................................................................................... 7 1.2. Using HTTP(S) AT Commands .................................................................................................. 7 1.3. Description of HTTP(S) Header ................................................................................................. 8 1.3.1. Customize HTTP(S) Request Header ............................................................................ 8 1.3.2. Output HTTP(S) Response Header ................................................................................ 9 1.4. Description of Data Mode .......................................................................................................... 9 2 Description of HTTP(S) AT Commands .......................................................................................... 10 2.1. AT Command Introduction ....................................................................................................... 10 2.1.1. Definitions...................................................................................................................... 10 2.1.2. AT Command Syntax .................................................................................................... 10 2.2. Declaration of AT Command Examples ....................................................................................11 2.3. AT Commands Description .......................................................................................................11 2.3.1. AT+QHTTPCFG Configure Parameters for HTTP(S) Server .....................................11 2.3.2. AT+QHTTPURL Set URL of HTTP(S) Server ............................................................ 14 2.3.3. AT+QHTTPGET Send GET Request to HTTP(S) Server .......................................... 15 2.3.4. AT+QHTTPPOST Send POST Request to HTTP(S) Server via UART/USB ............ 17 2.3.5. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server via File................. 19 2.3.6. AT+QHTTPPUT Send PUT Request to HTTP(S) Server via UART/USB ................. 20 2.3.7. AT+QHTTPPUTFILE Send PUT Request to HTTP(S) Server via File ...................... 23 2.3.8. AT+QHTTPREAD Read Response from HTTP(S) Server via UART/USB ............... 24 2.3.9. AT+QHTTPREADFILE Store the Response from HTTP(S) Server to File................ 25 3 Examples ........................................................................................................................................... 27 3.1. Access HTTP Server................................................................................................................ 27 3.1.1. Send HTTP GET Request and Read the Response .................................................... 27 3.1.2. Send HTTP POST Request and Read the Response .................................................. 28 3.1.2.1. HTTP POST Body Obtained from UART/USB ..................................................... 28 3.1.2.2. HTTP POST Body Obtained from File System .................................................... 30 3.1.3. Send HTTP PUT Request and Read the Response .................................................... 31 3.1.3.1. HTTP PUT Body Obtained from UART/USB........................................................ 31 3.1.3.2. HTTP PUT Body Obtained from File System ....................................................... 33 3.2. Access HTTPS Server ............................................................................................................. 34 3.2.1. Send HTTPS GET Request and Read the Response.................................................. 34 3.2.2. Send HTTPS POST Request and Read the Response ............................................... 36 3.2.2.1. HTTPS POST Body Obtained from UART/USB .................................................. 36 3.2.2.2. HTTPS POST Body Obtained from File System.................................................. 38 3.2.3. Send HTTPS PUT Request and Read the Response .................................................. 40 BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 4 / 52 LPWA Module Series 3.2.3.1. HTTPS PUT Body Obtained from UART/USB ..................................................... 40 3.2.3.2. HTTPS PUT Body Obtained from File System .................................................... 42 4 Error Handling ................................................................................................................................... 45 4.1. Executing HTTP(S) AT Command Failure ............................................................................... 45 4.2. PDP Activation Failure ............................................................................................................. 45 4.3. DNS Parse Failure ................................................................................................................... 45 4.4. Entering Data Mode Failure ..................................................................................................... 46 4.5. Sending GET/POST/PUT Requests Failure ............................................................................ 46 4.6. Reading Response Failure ...................................................................................................... 46 5 Summary of Result Codes ............................................................................................................... 48 6 Summary of HTTP(S) Response Codes ......................................................................................... 50 7 Appendix References ....................................................................................................................... 51 BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 5 / 52 LPWA Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 7 Table 2: Types of AT Commands ............................................................................................................... 10 Table 3: Summary of Result Codes ........................................................................................................... 48 Table 4: Summary of HTTP(S) Response Codes ...................................................................................... 50 Table 5: Related Documents ...................................................................................................................... 51 Table 6: Terms and Abbreviations .............................................................................................................. 51 BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 6 / 52 LPWA Module Series 1 Introduction Quectel LPWA BG95 series, BG77 and BG600L-M3 modules support HTTP(S) applications through accessing HTTP(S) servers. This document is a reference guide that includes all AT commands defined for HTTP(S). 1.1. Applicable Modules Table 1: Applicable Modules Module Series Model BG95-M1 BG95-M2 BG95-M3 BG95 BG95-M4 BG95-M5 BG95-M6 BG95-MF BG77 BG77 BG600L BG600L-M3 Description Cat M1 only Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS Cat M1/Cat NB2, 450 MHz Supported Cat M1/Cat NB2/EGPRS, Power Class 3 Cat M1/Cat NB2, Power Class 3 Cat M1/Cat NB2, Wi-Fi Positioning Cat M1/Cat NB2 Cat M1/Cat NB2/EGPRS 1.2. Using HTTP(S) AT Commands With TCP/IP AT commands, you can configure a PDP context, activate/deactivate the PDP context, and query the PDP context status. Whereas, with HTTP(S) AT commands, you can send HTTP(S) GET/POST/PUT requests to the HTTP(S) server, and read the HTTP(S) response from the HTTP(S) server. In general, the process is as follows: BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 7 / 52 LPWA Module Series Step 1: Configure the , , and other parameters of a PDP context with AT+QICSGP. Step 2: Activate the PDP context with AT+QIACT. You can query the assigned IP address with AT+QIACT?. Step 3: Configure the PDP context ID and SSL context ID with AT+QHTTPCFG. Step 4: Configure the SSL context parameters with AT+QSSLCFG. Step 5: Set HTTP(S) URL with AT+QHTTPURL. Step 6: Send an HTTP(S) request. AT+QHTTPGET can be used for sending an HTTP(S) GET request, while AT+QHTTPPOST or AT+QHTTPOSTFILE can be used for sending an HTTP(S) POST request. AT+QHTTPPUT or AT+QHTTPPUTFILE can be used for sending an HTTP(S) PUT request. Step 7: Read the HTTP(S) response with AT+QHTTPREAD or AT+QHTTPREADFILE. Step 8: Deactivate the PDP context with AT+QIDEACT. NOTE 1. See document [1] for more information on AT+QICSGP, AT+QIACT and AT+QIDEACT. 2. See document [2] for more information on AT+QSSLCFG. 1.3. Description of HTTP(S) Header 1.3.1. Customize HTTP(S) Request Header By default, an HTTP(S) request header is filled by the module automatically. It can also be customized by configuring to 1 via AT+QHTTPCFG first, and then by inputting the HTTP(S) request header according to the following requirements: 1. Apply the HTTP(S) header syntax. 2. The value of a URI in the HTTP(S) request line and the 'Host:' the header must be in line with the URL configured with AT+QHTTPURL. 3. The HTTP(S) request header must end with . A valid HTTP(S) POST request header is shown in the following example: POST /processorder.php HTTP/1.1 Host: 220.180.239.212:8011 Accept: */* User-Agent: QUECTEL_MODULE Connection: Keep-Alive BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 8 / 52 Content-Type: application/x-www-form-urlencoded Content-Length: 48 Message=1111&Appleqty=2222&Orangeqty=3333&find=1 LPWA Module Series 1.3.2. Output HTTP(S) Response Header By default, the HTTP(S) response header will not be outputted. Outputting of the HTTP(S) response header can be enabled by configuring to 1 via AT+QHTTPCFG. The HTTP(S) response header will be outputted together with the HTTP(S) response body after executing AT+QHTTPREAD or AT+QHTTPREADFILE. 1.4. Description of Data Mode The COM port of the modules has two working modes: AT command mode and data mode. In the AT command mode, the data inputted via the COM port are treated as AT commands, while in the data mode they are treated as data. ⚫ Exit Data Mode Inputting +++ or pulling the MAIN_DTR pin up can make the COM port exit the data mode. To prevent the +++ from being misinterpreted as data, the following sequence should be followed: 1) Do not input any character within 1 s before and after inputting +++. 2) Input +++ within 1 s, and wait until OK is returned. When OK is returned, COM port exits the data mode. If you are exiting the data mode by pulling the MAIN_DTR pin up, make sure to set AT&D1 first. ⚫ Enter Data Mode To enter the data mode, execute AT+QHTTPURL, AT+QHTTPOST and AT+QHTTPREAD. If you input +++ or pull the MAIN_DTR pin up to make the port exit the data mode, the execution of these commands will be interrupted before the response is returned. In such a case, the COM port cannot re-enter data mode if you execute ATO. NOTE See document [3] for more information on AT&D and ATO. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 9 / 52 LPWA Module Series 2 Description of HTTP(S) AT Commands 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of corresponding Write Command and return information about the type, value, or range of its parameter. Check the current parameter value of a corresponding Write Command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 10 / 52 LPWA Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendation or suggestions about how you should design a program flow or what status you should set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there exists a correlation among these examples, or that they should be executed in a given sequence. 2.3. AT Commands Description 2.3.1. AT+QHTTPCFG Configure Parameters for HTTP(S) Server This command configures the parameters for an HTTP(S) server, such as configuring a PDP context ID, customizing the HTTP(S) request header, outputting the HTTP(S) response header, and querying SSL settings. When the Write Command only executes one parameter, it will query the current settings. AT+QHTTPCFG Configure Parameters for HTTP(S) Server Test Command AT+QHTTPCFG=? Response +QHTTPCFG: 'contextid',(range of supported s) +QHTTPCFG: 'requestheader',(list of supported s) +QHTTPCFG: 'responseheader',(list of supported s) +QHTTPCFG: 'sslctxid',(range of supported s) +QHTTPCFG: 'contenttype',(range of supported s) +QHTTPCFG: 'auth',('username:password') +QHTTPCFG: 'custom_header',('custom_header') Read Command AT+QHTTPCFG? OK Response +QHTTPCFG: 'contextid', +QHTTPCFG: 'requestheader', +QHTTPCFG: 'responseheader', +QHTTPCFG: 'sslctxid', +QHTTPCFG: 'contenttype', +QHTTPCFG: 'auth',: +QHTTPCFG: 'custom_header', OK BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 11 / 52 LPWA Module Series Write Command AT+QHTTPCFG='contextid'[,] Response If the optional parameter is omitted, query the current setting: +QHTTPCFG: 'contextid', OK Write Command AT+QHTTPCFG='requestheader'[,] If the optional parameter is specified, configure the PDP context ID: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QHTTPCFG: 'requestheader', OK Write Command AT+QHTTPCFG='responseheader'[,] If the optional parameter is specified, configure whether to enable customization of HTTP(S) request header: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QHTTPCFG: 'responseheader', OK Write Command AT+QHTTPCFG='sslctxid'[, ] If the optional parameter is specified, configure whether to enable the outputting of the HTTP(S) response header: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QHTTPCFG: 'sslctxid', OK If the optional parameter is specified, configure the SSL context ID used for HTTP(S): OK Or +CME ERROR: BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 12 / 52 LPWA Module Series Write Command AT+QHTTPCFG='contenttype'[,] Response If the optional parameter is omitted, query the current setting: +QHTTPCFG: 'contenttype', OK Write Command AT+QHTTPCFG='auth'[,: ] If the optional parameter is specified, configure the data type of HTTP(S) body: OK Or +CME ERROR: Response If the optional parameter is omitted, query the current setting: +QHTTPCFG: 'auth',':' OK Write Command AT+QHTTPCFG='custom_header'[,] If the optional parameter is specified, configure the username and password for logging in to the HTTP(S) server: OK Or ERROR Response If the optional parameter is omitted, query the current setting: +QHTTPCFG:'custom_header', OK Maximum Response Time Characteristics If the optional parameter is specified, configure the userdefined HTTP(S) header: OK Or ERROR 300 ms The command takes effect immediately. The configuration is not saved. Parameter Integer type. PDP context ID. Range: 1–16. Default value: 1. Integer type. Disable or enable customization of HTTP(S) request header. 0 Disable BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 13 / 52 LPWA Module Series 1 Enable Integer type. Disable or enable the outputting of HTTP(S) response header. 0 Disable 1 Enable Integer type. SSL context ID used for HTTP(S). Range: 0–5. Default value: 1. SSL parameters can be configured with AT+QSSLCFG. For more information on this command, see document [2]. Integer type. Data type of HTTP(S) body. 0 application/x-www-form-urlencoded 1 text/plain 2 application/octet-stream 3 multipart/form-data 4 application/json 5 image/jpeg String type. Username for logging in to the HTTP(S) server. String type. Password for logging in to the HTTP(S) server. String type. User-defined HTTP(S) request header. Integer type. Result code. See Chapter 5 for more information. NOTE AT+QHTTPCFG='auth' configures the username and password for logging in to the HTTP(S) server, but it is only applicable to basic authentication of the HTTP(S) server. For more information, see RFC2616 14.8. 2.3.2. AT+QHTTPURL Set URL of HTTP(S) Server This command sets the URL of an HTTP(S) Server. The URL must begin with 'http://' or 'https://', which indicates that an HTTP or HTTPS server will be accessed. AT+QHTTPURL Set URL of HTTP(S) Server Test Command AT+QHTTPURL=? Response +QHTTPURL: (range of supported s),(range of supported s) Read Command AT+QHTTPURL? OK Response [+QHTTPURL: ] Write Command AT+QHTTPURL=[,] OK Response a) If the parameter format is correct, but it is not sending HTTP(S) GET/POST/PUT requests at present: BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 14 / 52 Maximum Response Time Characteristics LPWA Module Series CONNECT TA switches to the transparent transmission mode, and then the URL can be inputted. When the total size of the inputted data reaches , TA will return to the command mode and report the following code: OK If has been reached, but the received URL length is less than , TA will return to the command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: Determined by / Parameter String type. HTTP(S) server URL. Integer type. URL length. Range: 1–3000. Unit: byte. Integer type. Maximum time for inputting a URL. Range: 1–65535. Default value: 60. Unit: second. Integer type. Result code. See Chapter 5 for more information. 2.3.3. AT+QHTTPGET Send GET Request to HTTP(S) Server This command sends an HTTP(S) GET request. According to the configured in AT+QHTTPCFG='requestheader'[, ], AT+HTTPGET has two different formats. If =1, after sending AT+QHTTPGET, CONNECT is outputted within 125 s to indicate successful establishment of the connection. If that is not the case, then +CME ERROR: will be returned. It is recommended to wait for a specific period of time () for +QHTTPGET: [,[,]] to be outputted after OK is returned. In +QHTTPGET: [,[,]], the parameter can only be reported when is 0. If HTTP(S) response header contains 'Content-Length', then will be reported. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 15 / 52 LPWA Module Series AT+QHTTPGET Send GET Request to HTTP(S) Server Test Command AT+QHTTPGET=? Response +QHTTPGET: (range of supported s),(range of supported s),(range of supported s) Write Command If =0 (disabled to customize HTTP(S) request header) AT+QHTTPGET[=] OK Response a) If the parameter format is correct and no other errors occur: OK When the module has received a response from the HTTP(S) server, it will report the following URC: +QHTTPGET: [,[,]] Write Command If =1 (enabled to customize HTTP(S) request header) AT+QHTTPGET=,[,] b) If the parameter format is incorrect or other errors occur: +CME ERROR: Response a) If the connection to the HTTP(S) server has been established successfully: CONNECT TA switches to the transparent transmission mode, and then the HTTP(S) GET request header can be inputted. When the total size of the inputted data reaches , TA will return to the command mode and report the following code: OK When the module has received a response from HTTP(S) server, it will report the following URC: +QHTTPGET: [,[,]] If the has been reached, but the received data length is less than , TA will return to the command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 16 / 52 LPWA Module Series Maximum Response Time Characteristics Determined by / Parameter Integer type. Timeout value for the HTTP(S) GET response +QHTTPGET: [,[,]] to be outputted after OK is returned. Range: 1–65535. Default value: 60. Unit: second. Integer type. Length of HTTP(S) request information, including HTTP(S) request header and HTTP(S) request body. Range: 1–2048. Unit: byte. Integer type. Maximum time for inputting HTTP(S) request information. Range: 1–65535. Default value: 60. Unit: second. Integer type. HTTP(S) server response code. See Chapter 6 for more information. Integer type. Disable or enable customizing the HTTP(S) request header. 0 Disable 1 Enable Integer type. Length of the HTTP(S) response body. Unit: byte. Integer type. Result code. See Chapter 5 for more information. 2.3.4. AT+QHTTPPOST Send POST Request to HTTP(S) Server via UART/USB This command sends an HTTP(S) POST request. According to the configured in AT+QHTTPCFG='requestheader'[,], AT+HTTPPOST has two different formats: ⚫ If =0, then only the HTTP(S) POST body should be inputted via a UART/USB port. ⚫ If =1, then both the HTTP(S) POST header and body should be inputted via a UART/USB port. After sending AT+QHTTPPOST, CONNECT is outputted within 125 s to indicate successful establishment of the connection. If that is not the case, +CME ERROR: will be returned. It is recommended to wait for a specific period of time (see the maximum response time below) for +QHTTPPOST: [,[,]] to be outputted after OK is returned. AT+QHTTPPOST Send POST Request to HTTP(S) Server via UART/USB Test Command AT+QHTTPPOST=? Response +QHTTPPOST: (range of supported s),(range of supported s),(range of supported s) Write Command OK Response BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 17 / 52 LPWA Module Series If =0 (disabled to customize HTTP(S) request header) AT+QHTTPPOST=[,,] a) If the parameter format is correct, the connection to HTTP(S) server has been established successfully, and the HTTP(S) request header has been sent: CONNECT TA switches to the transparent transmission mode, and then the HTTP(S) POST body can be inputted. When the total size of the inputted data reaches , TA will return to the command mode and report the following code: OK When the module has received a response from HTTP(S) server, it will report the following URC: +QHTTPPOST: [,[,]] If the has been reached, but the received data length is less than , TA will return to the command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: Write Command Response If =1 (enabled to a) If the parameter format is correct and the connection to customize HTTP(S) request header) HTTP(S) server has been established successfully: AT+QHTTPPOST=[,,] TA switches to the transparent transmission mode, and then the HTTP(S) POST header and body can be inputted. When the total size of the inputted data reaches , TA will return to command mode and report the following code: OK When the module has received a response from HTTP(S) server, it will report the following URC: +QHTTPPOST: [,[,]] If the has been reached, but the received data length is less than , TA will return to command mode and report the following code: +CME ERROR: BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 18 / 52 Maximum Response Time Characteristics LPWA Module Series b) If the parameter format is incorrect or other errors occur: +CME ERROR: Determined by network and / Parameter Integer type. If =0, it indicates the length of HTTP(S) POST body. If =1, it indicates the length of HTTP(S) POST request information, including the HTTP(S) POST request header and body. Range: 1–1024000. Unit: byte. Integer type. Maximum time for inputting the HTTP(S) POST body or HTTP(S) POST request information. Range: 1–65535. Default value: 60. Unit: second. Integer type. Timeout value for the HTTP(S) POST response +QHTTPPOST: [,[,]] to be outputted after OK is returned. Range: 1–65535. Default value: 60. Unit: second. Integer type. HTTP(S) server response code. See Chapter 6 for more information. Integer type. Disable or enable customizing the HTTP(S) request header. 0 Disable 1 Enable Integer type. Length of the HTTP(S) response body. Unit: byte. Integer type. Result code. See Chapter 5 for more information. 2.3.5. AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server via File This command sends HTTP(S) POST request via a file. According to the configuration in AT+QHTTPCFG='requestheader'[,], the file operated with AT+HTTPPOSTFILE has two different formats: ⚫ If =0, the file in a file system will be the HTTP(S) POST body only. ⚫ If =1, the file in a file system will be the HTTP(S) POST header and body. After executing AT+QHTTPPOSFILE, the module will report +QHTTPPOSTFILE: [,[,]] to indicate the execution result. The can only be reported when =0. It is recommended to wait for a specific period of time (see the maximum response time below) for +QHTTPPOSTFILE: [,[,]] to be outputted after OK is returned. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 19 / 52 LPWA Module Series AT+QHTTPPOSTFILE Send POST Request to HTTP(S) Server via File Test Command AT+QHTTPPOSTFILE=? Response +QHTTPPOSTFILE: ,(range of supported s) OK Write Command Response AT+QHTTPPOSTFILE=[,< a) If the parameter format is correct and the connection to rsptime>] HTTP(S) server has been established successfully: If =1, the specified OK file must contain both HTTP(S) request header and body. When the module has received a response from the HTTP(S) server, it will report the following URC: +QHTTPPOSTFILE: [,[,]] Maximum Response Time Characteristics b) If the parameter format is incorrect or other errors occur: +CME ERROR: Determined by / Parameter String type. File name. Max file name length: 80 bytes. Integer type. Timeout value for the HTTP(S) POST response +QHTTPPOSTFILE: [,[,]] to be outputted after OK is returned. Range: 1–65535. Default value: 60. Unit: second. Integer type. HTTP(S) server response code. See Chapter 6 for more information. Integer type. Disable or enable customizing the HTTP(S) request header. 0 Disable 1 Enable Integer type. Length of HTTP(S) response body. Integer type. Result code. See Chapter 5 for more information. 2.3.6. AT+QHTTPPUT Send PUT Request to HTTP(S) Server via UART/USB This command sends an HTTP(S) PUT request. According to the configured in AT+QHTTPCFG='requestheader'[,], AT+QHTTPPUT has two different formats. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 20 / 52 LPWA Module Series ⚫ If =0, HTTP(S) PUT body should be inputted via UART/USB port. ⚫ If =1, then both HTTP(S) PUT header and body should be inputted via UART/USB port. After sending AT+QHTTPPUT, CONNECT is outputted within 125 s to indicate successful establishment of the connection. If that is not the case, +CME ERROR: will be outputted. It is recommended to wait for a specific period of time (see the maximum response time below) for +QHTTPPUT: [,[,]] to be outputted after OK is returned. AT+QHTTPPUT Send PUT Request to HTTP(S) Server via UART/USB Test Command AT+QHTTPPUT=? Response +QHTTPPUT: (range of supported s),(range of supported s),(range of supported s) OK Write Command Response If =0 (disabled to a) If the parameter format is correct, the connection to customize HTTP(S) request header) HTTP(S) server has been established successfully, and AT+QHTTPPUT=[,,] CONNECT TA switches to transparent transmission mode, and the HTTP(S) PUT body can be inputted. When the total size of the inputted data reaches , TA will return to command mode and report the following code: OK When the module has received a response from HTTP(S) server, it will report the following URC: +QHTTPPUT: [,[,]] If the has been reached, but the received data length is less than , TA will return to command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: Write Command Response If =1 (enabled to a) If the parameter format is correct and the connection to customize HTTP(S) request header) HTTP(S) server has been established successfully: AT+QHTTPPUT=[,,] CONNECT BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 21 / 52 LPWA Module Series Maximum Response Time Characteristics TA switches to the transparent transmission mode, and the HTTP(S) PUT header and body can be inputted. When the total size of the inputted data reaches , TA will return to command mode and report the following code: OK When the module has received a response from the HTTP(S) server, it will report the following URC: +QHTTPPUT: [,[,]] If the has been reached, but the received data length is less than , TA will return to command mode and report the following code: +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: Determined by network and This command takes effect immediately. The configuration is not saved. Parameter Integer type. If =0, it indicates the length of HTTP(S) PUT body. If =1, it indicates the length of HTTP(S) PUT request information, including HTTP(S) PUT request header and body. Range: 1–1024000. Unit: byte. Integer type. Maximum time for inputting HTTP(S) PUT body or HTTP(S) PUT request information. Range: 1–65535. Default value: 60. Unit: second. Integer type. Timeout value for the HTTP(S) PUT response +QHTTPPUT: [,[,]] to be outputted after OK is returned. Range: 1–65535. Default value: 60. Unit: second. Integer type. HTTP(S) server response code. See Chapter 6 for more information. Integer type. Disable or enable customizing the HTTP(S) request header. 0 Disable 1 Enable Integer type. Length of HTTP(S) response body. Unit: byte. Integer type. Result code. See Chapter 5 for more information. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 22 / 52 LPWA Module Series 2.3.7. AT+QHTTPPUTFILE Send PUT Request to HTTP(S) Server via File This command sends an HTTP(S) PUT request via file. According to the in AT+QHTTPCFG='requestheader'[,], the file operated with AT+QHTTPPUTFILE has two different formats. ⚫ If =0, the file in file system will be the PUT body only. ⚫ If =1, the file in file system will be the PUT header and body. After executing AT+QHTTPPUTFILE, the module will report +QHTTPPUTFILE: [,[,]] to indicate the execution result. The can only be reported when =0. It is recommended to wait for a specific period of time (see the maximum response time below) for +QHTTPPUTFILE: [,[,]] to be outputted after OK is returned. AT+QHTTPPUTFILE Send PUT Request to HTTP(S) Server via File Test Command AT+QHTTPPUTFILE=? Response +QHTTPPUTFILE: ,(range of supported s)[,(range of supported s)] Write Command AT+QHTTPPUTFILE=[,[,]] OK Response a) If parameter format is correct and the connection to HTTP(S) server has been established successfully: OK When the module has received a response from HTTP(S) server, it will report the following URC: +QHTTPPUTFILE: [,[,]] Maximum Response Time Characteristics b) If parameter format is incorrect or other errors occur: +CME ERROR: Determined by the network and This command takes effect immediately. The configuration is not saved. Parameter String type. File name. Max file name length: 80 bytes. Integer type. Timeout value for the HTTP(S) POST response +QHTTPPUTFILE: [,[,]] to be BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 23 / 52 LPWA Module Series outputted after OK is returned. Range: 1–65535. Default: 60. Unit: second. Integer type. File information to be sent. This parameter can only be omitted when =0. 0 If =0, it indicates request body If =1, it indicates both request header and body 1 Request header ( must be set to 1) 2 Request body ( must be set to 1) Integer type. HTTP(S) server response code. See Chapter 6 for more information. Integer type. Disable or enable customizing the HTTP(S) request header. 0 Disable 1 Enable Integer type. Length of HTTP(S) response body. Unit: byte. Integer type. Result code. See Chapter 5 for more information. 2.3.8. AT+QHTTPREAD Read Response from HTTP(S) Server via UART/USB This command retrieves the HTTP(S) response from an HTTP(S) server via the UART/USB port, after HTTP(S) GET/POST/PUT requests are sent. It must be executed after +QHTTPGET: [,[,]], +QHTTPPOST: [,[,]], +QHTTPPOSTFILE: [,[,]], +QHTTPPUT: [,[,]] or +QHTTPPUTFILE: [,[,]] is received. AT+QHTTPREAD Read Response from HTTP(S) Server via UART/USB Test Command AT+QHTTPREAD=? Response +QHTTPREAD: (range of supported s) Write/Execution Command AT+QHTTPREAD[=] OK Response a) If the parameter format is correct and the HTTP(S) response is read successfully: CONNECT Outputs HTTP(S) response information OK +QHTTPREAD: If is reached or other errors occur, but the HTTP(S) response has not been outputted completely, it will report the following code: BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 24 / 52 LPWA Module Series Maximum Response Time Characteristics +CME ERROR: b) If the parameter format is incorrect or other errors occur: +CME ERROR: Determined by The command takes effect immediately. The configuration is not saved. Parameter Integer type. Maximum time between receiving two packets of data. Range: 1–65535. Default value: 60. Unit: second. Integer type. Result code. See Chapter 5 for more information. Integer type. HTTP(S) server response code. See Chapter 6 for more information. Integer type. Length of HTTP(S) response body. Unit: byte. 2.3.9. AT+QHTTPREADFILE Store the Response from HTTP(S) Server to File This command stores the HTTP(S) response from an HTTP(S) server to a specified file, after HTTP(S) GET/POST/PUT requests are sent, thus allowing users to retrieve the response information from the file. It must be executed after +QHTTPGET: [,[,]], +QHTTPPOST: [,[,]], +QHTTPPOSTFILE: [,[,]], +QHTTPPUT: [,[,]] or +QHTTPPUTFILE: [,[,]] is reported. AT+QHTTPREADFILE Store the Response from HTTP(S) Server to File Test Command AT+QHTTPREADFILE=? Response +QHTTPREADFILE: ,(range of supported s) Write Command AT+QHTTPREADFILE=[, ] OK Response a) If the parameter format is correct: OK When the response from the HTTP(S) server is read or is reached, it will report: +QHTTPREADFILE: b) If the parameter format is incorrect or other errors occur: BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 25 / 52 LPWA Module Series Maximum Response Time Characteristics +CME ERROR: Determined by The command takes effect immediately. The configuration is not saved. Parameter Integer type. Maximum time between receiving two packets of data. Range: 1– 65535. Default value: 60. Unit: second. String type. File name. Max file name length: 80 bytes. Integer type. Result code. See Chapter 5 for more information. Integer type. HTTP(S) server response code. See Chapter 6 for more information. Integer type. Length of HTTP(S) response body. Unit: byte. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 26 / 52 LPWA Module Series 3 Examples 3.1. Access HTTP Server 3.1.1. Send HTTP GET Request and Read the Response The following examples show how to send an HTTP GET request and enable the output of the HTTP response header, as well as how to read an HTTP GET response. //Example of how to send an HTTP GET response. AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='responseheader',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //Configure the PDP context ID as 1. //Allow the output of HTTP response header. //Query the list of currently activated contexts and their IP addresses. //No context activated currently. //Configure PDP context 1. Protocol type: IPv4. China Unicom APN: UNINET. Authentication method: PAP. //Activate context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. OK AT+QHTTPURL=23,80 CONNECT http://www.sina.com.cn/ OK AT+QHTTPGET=80 OK //Set the URL of the HTTP server that will be accessed. //Input the URL whose length should be 23 bytes. (This URL is only an example. Input the correct URL in a practical test.) //Send the HTTP GET request with the maximum response time of 80 s. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 27 / 52 LPWA Module Series +QHTTPGET: 0,200,547256 //If the HTTP response header contains 'Content-Length' information, then the (547256) will be reported. //Example of how to read an HTTP response. //Solution 1: Read the HTTP response information and output it via the UART port. AT+QHTTPREAD=80 //Read the HTTP response information and output it via a UART. The maximum time to wait for an HTTP session to be closed is 80 s. CONNECT HTTP/1.1 200 OK //HTTP response header and body. Content-Type: text/html Vary: Accept-Encoding X-Powered-By: shci_v1.03 Server: nginx Date: Fri, 27 Dec 2013 02:21:43 GMT Last-Modified: Fri, 27 Dec 2013 02:20:01 GMT Expires: Fri, 27 Dec 2013 02:22:43 GMT Cache-Control: max-age=60 Age: 1 Content-Length: 547256 X-Cache: HIT from xd33-85.sina.com.cn OK +QHTTPREAD: 0 //Successful reading of HTTP response header and body. //Solution 2: Read the HTTP response information through storing it to a UFS file. AT+QHTTPREADFILE='1.txt',80 OK //Read the HTTP response header and body through storing them to 1.txt. The maximum time to wait for an HTTP session to be closed is 80 s. +QHTTPREADFILE: 0 //The HTTP response header and body have been stored successfully. 3.1.2. Send HTTP POST Request and Read the Response 3.1.2.1. HTTP POST Body Obtained from UART/USB The following examples show how to send an HTTP POST request and retrieve the POST body via the UART port, as well as how to read the HTTP POST response. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 28 / 52 LPWA Module Series AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //Configure the PDP context ID as 1. //Query the list of currently activated contexts and their IP addresses. //No context activated currently. //Configure PDP context 1. Protocol type: IPv4. China Unicom APN: UNINET. Authentication method: PAP. //Activate context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. OK AT+QHTTPURL=44,80 CONNECT http://220.180.239.212:8300/processorder.php OK AT+QHTTPPOST=48,80,80 CONNECT Message=1111&Appleqty=2222&Orangeqty=3333&find=1 OK //Set the URL of the HTTP server that will be accessed. //Input the URL whose length is 44 bytes. (This URL is only an example. Input the correct URL in a practical test.) //Send an HTTP POST request. The maximum input time and the maximum response time are 80 s each. //Input the POST body whose length should be 48 bytes. (The POST body is only an example. Input the correct POST body in a practical test.) +QHTTPPOST: 0,200,320 //If the HTTP response header contains 'Content-Length' information, then the (320) will be reported. AT+QHTTPREAD=80 //Read the HTTP response body and output it via a UART. The maximum time to wait for an HTTP session to be closed is 80 s. CONNECT HTTP/1.1 200 OK Date: Tue, 06 Jul 2021 07:24:18 GMT Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips PHP/7.2.15 BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 29 / 52 LPWA Module Series X-Powered-By: PHP/7.2.15 Access-Control-Allow-Origin: * Content-Length: 320 Keep-Alive: timeout=60, max=9999 Connection: Keep-Alive Content-Type: application/x-www-form-urlencoded Quectel's Auto Parts - Order Results Quectel's Auto Parts Order Results Content-Type:application/x-www-form-urlencoded Order processed at Your order is as follows: 1111 message2222 />3333 orange apple<br OK +QHTTPREAD: 0 //HTTP response body has been outputted successfully. 3.1.2.2. HTTP POST Body Obtained from File System The following examples show how to send an HTTP POST request and retrieve the POST body via a file system, as well as how to store an HTTP POST response to a file system. AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //Configure the PDP context ID as 1. //Query the list of currently activated contexts and their IP addresses. //No context activated currently. //Configure PDP context 1. Protocol type: IPv4 China Unicom APN: UNINET Authentication method: PAP. //Activate context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. OK BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 30 / 52 LPWA Module Series AT+QHTTPURL=44,80 CONNECT http://220.180.239.212:8300/processorder.php OK //Set the URL of the HTTP server that will be accessed. //Input URL whose length is 44 bytes. (This URL is only an example. Input the correct URL in a practical test.) //POST the request information from a UFS file, and read the HTTP response information through storing it to a UFS file. AT+QHTTPPOSTFILE='2.txt',80 OK //Send the HTTP POST request. The POST body is obtained from 2.txt. The maximum response time is 80 s. +QHTTPPOSTFILE: 0,200,295 //HTTP POST request has been sent successfully. The HTTP response body can be read via either AT+QHTTPREAD or AT+QHTTPREADFILE. AT+QHTTPREADFILE='3.txt',80 OK //Read the HTTP response body through storing it to 3.txt. The maximum time to wait for an HTTP session to be closed is 80 s. +QHTTPREADFILE: 0 //The HTTP response body has been stored successfully. 3.1.3. Send HTTP PUT Request and Read the Response 3.1.3.1. HTTP PUT Body Obtained from UART/USB The following examples show how to send an HTTP PUT request and retrieve the HTTP PUT body via a UART port, as well as how to read the HTTP PUT response. AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='contenttype',4 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 //Configure the PDP context ID as 1. //Configure the content type as application/json //Query the list of currently activated contexts and their IP addresses. //Configure the PDP context 1. Protocol type: IPv4 China Unicom APN: UNINET. Authentication method: PAP. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 31 / 52 LPWA Module Series OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //Activate PDP context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. OK AT+QHTTPURL=44,80 CONNECT http://220.180.239.212:8300/processorder.php OK AT+QHTTPPUT=18,80,80 CONNECT {'Message':'1234'} OK //Set the URL that will be accessed. //Input the URL whose length is 44 bytes. (This URL is only an example. Input the correct URL in a practical test.) //Send an HTTP PUT request. The HTTP PUT body is obtained via UART. The maximum input body time and the maximum response time are 80 s each. //Input the HTTP PUT body whose length is 18 bytes. (The PUT body is only an example. Input the correct PUT body in a practical test.) +QHTTPPUT: 0,200,295 //If the HTTP response header contains 'Content-Length' information, then the information will be reported. AT+QHTTPREAD=80 //Read the HTTP response body and output it via a UART. The maximum time to wait for the HTTP session to be closed is 80 s. CONNECT Quectel's Auto Parts - Order Results Quectel's Auto Parts Order Results Content-Type:application/json Order processed at Your order is as follows: 1234 message apple orange //Output the HTTP response body. OK BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 32 / 52 +QHTTPREAD: 0 LPWA Module Series //HTTP response body is output successfully. 3.1.3.2. HTTP PUT Body Obtained from File System The following examples show how to send an HTTP PUT request and retrieve the PUT body via a file system, as well as how to store the HTTP PUT response to a file system. AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG=' contenttype',4 AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //Configure the PDP context ID as 1. //Configure the content type as application/json. //Query the list of currently activated contexts and their IP addresses. //Configure PDP context 1. Protocol type: IPv4. China Unicom APN: UNINET. Authentication method: PAP. //Activate PDP context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. OK AT+QHTTPURL=44,80 CONNECT http://220.180.239.212:8300/processorder.php OK //Set the URL that will be accessed. Timeout value: 80 s. //Input URL whose length is 44 bytes. (This URL is only an example. Input the correct URL in a practical test.) //PUT the request information from a UFS file, and read the HTTP response information and store it to a UFS file. AT+QHTTPPUTFILE='UFS:2.txt',80 OK //Send an HTTP(S) PUT request. PUT body is obtained from UFS:2.txt. The maximum response time: 80 s. +QHTTPPUTFILE: 0,200,295 AT+QHTTPREADFILE='RAM:3.txt',80 //After an HTTP PUT request is sent successfully, AT+QHTTPREADFILE can be executed. //Read an HTTP response body and store it to UFS:3.txt. The maximum time to wait for an HTTP session to be closed is 80 s. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 33 / 52 OK +QHTTPREADFILE: 0 LPWA Module Series //HTTP response body has been stored successfully. 3.2. Access HTTPS Server 3.2.1. Send HTTPS GET Request and Read the Response The following examples show how to send an HTTPS GET request and enable the output of the HTTPS response header, as well as how to read an HTTPS GET response. //An example of how to send an HTTPS GET request. AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='responseheader',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //Configure the PDP context ID as 1. //Allow the output of the HTTPS response header. //Query the list of currently activated contexts and their IP addresses. //Configure PDP context 1. Protocol type: IPv4. China Unicom APN: UNINET. Authentication method: PAP. //Activate context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. OK AT+QHTTPCFG='sslctxid',1 OK AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0xFFFF OK AT+QSSLCFG='seclevel',1,0 OK AT+QHTTPURL=22,80 CONNECT //Set the SSL context ID as 1. //Set the SSL verification as 1 which means TLSv1.0. //Set the SSL cipher suite as 0xFFFF which means support all. //Set the SSL verify level as 0 which means CA certificate is not needed. //Set the URL of the HTTPS server that will be accessed. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 34 / 52 LPWA Module Series https://www.alipay.com OK AT+QHTTPGET=80 OK //Input a URL whose length is 22 bytes. (This URL is only an example. Input the correct URL in a practical test.) //Send an HTTPS GET request. The maximum response time : 80 s. +QHTTPGET: 0,200,21472 //If the HTTPS response header contains 'Content-Length' information, then the (21472) will be reported. //An example of how to read an HTTPS response. //Solution 1: Read the HTTPS response information and output it via a UART. AT+QHTTPREAD=80 //Read the HTTPS response information and output it via a UART. The maximum time to wait for an HTTPS session to be closed is 80 s. CONNECT //HTTPS response header and body. HTTP/1.1 200 OK Server: nginx/1.2.7 Date: Fri, 27 Dec 2013 02:38:27 GMT Content-Type: text/html; charset=GB18030 Content-Length: 10750 Connection: keep-alive OK +QHTTPREAD: 0 //Successful reading of HTTPS response header and body. //Solution 2: Read the HTTPS response information through storing it to UFS file. AT+QHTTPREADFILE='4.txt',80 OK //Read the HTTPS response header and body through storing it to 4.txt. The maximum time to wait for an HTTPS session to be closed is 80 s. +QHTTPREADFILE: 0 //The HTTPS response header and body have been stored successfully. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 35 / 52 LPWA Module Series 3.2.2. Send HTTPS POST Request and Read the Response 3.2.2.1. HTTPS POST Body Obtained from UART/USB The following examples show how to send an HTTPS POST request and retrieve the POST body via a UART port, as well as how to read the HTTPS POST response. AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1, 'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //Configure the PDP context ID as 1. //Query the list of currently activated contexts and their IP addresses. //No context activated currently. //Configure PDP context 1. Protocol type: IPv4. China Unicom APN: UNINET. Authentication method: PAP. //Activate context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. OK AT+QHTTPCFG='sslctxid',1 OK AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0xFFFF which OK AT+QSSLCFG='seclevel',1,2 OK AT+QFUPL='cacert.pem' CONNECT +QFUPL:1216,7648 //Set the SSL context ID as 1. //Set the SSL version as 1 which means TLSv1.0. //Set the SSL cipher suite as 0xFFFF means support all. //Set the SSL verification level as 2 which means that a CA certificate, a client certificate and a client private key should all be uploaded with AT+QFUPL. //Upload the CA certificate to UFS. OK AT+QFUPL='clientcert.pem' CONNECT //Upload the client certificate to UFS. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 36 / 52 LPWA Module Series +QFUPL:1216,5558 OK AT+QFUPL='clientkey.pem' CONNECT +QFUPL:1706,538 //Upload the client private key to UFS. OK AT+QSSLCFG='cacert',1,'cacert.pem' OK AT+QSSLCFG='clientcert',1,'clientcert.pem' OK AT+QSSLCFG='clientkey',1,'clientkey.pem' OK AT+QHTTPURL=45,80 CONNECT https://220.180.239.212:8303/processorder.php OK AT+QHTTPPOST=48,80,80 CONNECT Message=1111&Appleqty=2222&Orangeqty=3333&find=1 OK //Configure the path of CA certificate for SSL context 1. //Configure the path of client certificate for SSL context 1. //Configure the path of client private key for SSL context 1. //Set the URL of the HTTPS server that will be accessed. //Input the URL whose length is 45 bytes. (This URL is only an example. Input the correct URL in practical test.) //Send the HTTPS POST request. The maximum input body time and the maximum response time are 80 s each. //Input the POST body whose length should be 48 bytes. (This POST body is only an example. Input the correct one in a practical test.) +QHTTPPOST: 0,200,320 AT+QHTTPREAD=80 CONNECT //If the HTTPS response header contains 'Content-Length' information, the (285) will be reported. //Read the HTTPS response body and output it via a UART. The maximum time to wait for an HTTPS session to be closed is 80 s. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 37 / 52 LPWA Module Series HTTP/1.1 200 OK Date: Tue, 06 Jul 2021 07:35:55 GMT Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips PHP/7.2.15 X-Powered-By: PHP/7.2.15 Access-Control-Allow-Origin: * Content-Length: 320 Keep-Alive: timeout=60, max=9999 Connection: Keep-Alive Content-Type: application/x-www-form-urlencoded Quectel's Auto Parts - Order Results Quectel's Auto Parts Order Results Content-Type:application/x-www-form-urlencoded Order processed at Your order is as follows: 1111 message2222 />3333 orange apple<br OK +QHTTPREAD: 0 //The HTTPS response body has been outputted successfully. 3.2.2.2. HTTPS POST Body Obtained from File System The following examples show how to send an HTTPS POST request and retrieve the POST body from a file system, as well as how to store the HTTPS POST response to a file system. AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1, 'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? //Configure the PDP context ID as 1. //Query the list of currently activated contexts and their IP addresses. //No context activated currently. //Configure PDP context 1. Protocol type: IPv4. China Unicom APN: UNINET. Authentication method: PAP. //Activate context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 38 / 52 +QIACT: 1,1,1,'172.22.86.226' OK AT+QHTTPCFG='sslctxid',1 OK AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0xFFFF OK AT+QSSLCFG='seclevel',1,2 OK AT+QFUPL='cacert.pem' CONNECT +QFUPL:1216,7648 OK AT+QFUPL='clientcert.pem' CONNECT +QFUPL:1216,5558 OK AT+QFUPL='clientkey.pem' CONNECT +QFUPL:1706,538 OK AT+QSSLCFG='cacert',1,'cacert.pem' OK AT+QSSLCFG='clientcert',1,'clientcert.pem' OK AT+QSSLCFG='clientkey',1,'clientkey.pem' OK LPWA Module Series //Set the SSL context ID as 1. //Set the SSL version as 1 which means TLSv1.0. //Set the SSL cipher suite as 0xFFFF which means support all. //Set the SSL verification level as 2 which means that a CA certificate, a client certificate and a client private key should all be uploaded with AT+QFUPL. //Upload the CA certificate to UFS. //Upload the client certificate to UFS. //Upload the client private key to UFS. //Configure the path of CA certificate for SSL context 1. //Configure the path of client certificate for SSL context 1. //Configure the path of client private key for SSL context 1. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 39 / 52 LPWA Module Series AT+QHTTPURL=45,80 CONNECT https://220.180.239.212:8303/processorder.php OK //Set the URL of HTTPS server that will be accessed. //Input the URL whose length should be 45 bytes. (This URL is only an example. Input the correct URL in a practical test.) //POST request information from UFS file, and read the HTTPS response information through storing it to a UFS file. AT+QHTTPPOSTFILE='5.txt',80 OK +QHTTPPOSTFILE: 0,200,320 AT+QHTTPREADFILE='6.txt',80 OK //Send the HTTPS POST request. The POST body is obtained from 5.txt. The maximum response time is 80 s. //The HTTPS POST request has been sent successfully. And then the HTTPS response body can be read via either AT+QHTTPREAD or AT+QHTTPREADFILE. //Read the HTTPS response body through storing it to 6.txt. The maximum time to wait for an HTTPS session to be closed is 80 s. +QHTTPREADFILE: 0 //The HTTPS response body has been stored successfully. 3.2.3. Send HTTPS PUT Request and Read the Response 3.2.3.1. HTTPS PUT Body Obtained from UART/USB The following examples show how to send an HTTPS PUT request and retrieve the PUT body via a UART port, as well as how to read an HTTPS PUT response. AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='contenttype',4 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 //Configure the PDP context ID as 1. //Configure the content type as application/json. //Query the list of currently activated contexts and their IP addresses. //Configure PDP context 1. Protocol type: IPv4. China Unicom APN: UNINET. Authentication method: PAP. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 40 / 52 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' OK AT+QHTTPCFG='sslctxid',1 OK AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0xFFFF OK AT+QSSLCFG='seclevel',1,2 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' OK AT+QHTTPURL=45,80 CONNECT https://220.180.239.212:8303/processorder.php OK AT+QHTTPPUT=18,80,80 CONNECT {'Message':'1234'} LPWA Module Series //Activate PDP context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. //Set SSL context ID as 1. //Set SSL version as 1 which means TLSV1.0. //Set SSL cipher suite as 0xFFFF which means support all. //Set SSL verify level as 2 which means CA certificate, client certificate and client private key should be uploaded with AT+QFUPL. //Set the URL that will be accessed. Timeout value: 80 s //Input URL whose length is 45 bytes. (This URL is only an example. Input the correct URL in a practical test.) //Send an HTTPS PUT request. The HTTPS PUT body is obtained from UART. The maximum input body time and the maximum response time are 80 s each. //Input HTTPS PUT body whose length is 18 bytes. (This PUT body is only an example. Input the correct one in a practical test.) BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 41 / 52 LPWA Module Series OK +QHTTPPUT: 0,200,295 //If the HTTPS response header contains content length information, then the information will be reported. AT+QHTTPREAD=80 //Read HTTPS response body and output it via a UART. The maximum time to wait for an HTTPS session to be closed is 80 s. CONNECT //Successful reading of the HTTPS response body. Quectel's Auto Parts - Order Results Quectel's Auto Parts Order Results Content-Type:application/json Order processed at Your order is as follows: 1234 message apple orange OK +QHTTPREAD: 0 //HTTPS response body has been outputted successfully. 3.2.3.2. HTTPS PUT Body Obtained from File System The following examples show how to send an HTTPS PUT request and retrieve the HTTPS PUT body from a file system, as well as how to store an HTTPS PUT response to file system. AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='contenttype',4 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK //Configure the PDP context ID as 1. //Configure the content type as application/json. //Query the list of currently activated contexts and their IP addresses. //Configure PDP context 1. Protocol type: IPv4 China Unicom APN: UNINET. Authentication method: PAP. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 42 / 52 LPWA Module Series AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //Activate PDP context 1. //Activated successfully. //Query the list of currently activated contexts and their IP addresses. OK AT+QHTTPCFG='sslctxid',1 //Set SSL context ID as 1. OK AT+QSSLCFG='sslversion',1,1 //Set SSL version as 1, which means TLSV1.0. OK AT+QSSLCFG='ciphersuite',1,0xFFFF //Set SSL cipher suite as 0xFFFF, which means support all. OK AT+QSSLCFG='seclevel',1,2 //Set SSL verify level as 2, which means that a CA certificate, client certificate and client private key should be uploaded with AT+QFUPL. OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' OK AT+QHTTPURL=45,80 //Set the URL that will be accessed. Timeout value: 80 s. CONNECT https://220.180.239.212:8303/processorder.php //Input URL whose length is 45 bytes. (This URL is only an example. Input the correct URL in a practical test.) OK //PUT request information from UFS file, and read HTTPS response information and store it to UFS file. AT+QHTTPPUTFILE='UFS:5.txt',80 OK //Send HTTPS PUT request. HTTPS PUT body is obtained from UFS:5.txt. The maximum response time: 80 s. +QHTTPPUTFILE: 0,200,295 AT+QHTTPREADFILE='UFS:6.txt',80 OK //After HTTPS PUT request is sent successfully, AT+QHTTPREADFILE can be executed. //Read HTTPS response body and store it to UFS:6.txt. The maximum time to wait for HTTPS session to be closed is 80 s. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 43 / 52 +QHTTPREADFILE: 0 LPWA Module Series //HTTPS response body has been stored successfully. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 44 / 52 LPWA Module Series 4 Error Handling 4.1. Executing HTTP(S) AT Command Failure If ERROR response is received from the module after executing HTTP(S) AT commands, check whether the (U)SIM card has been inserted and whether +CPIN: READY is returned when executing AT+CPIN?. 4.2. PDP Activation Failure In case of failure to activate a PDP context with AT+QIACT, check the following configurations: 1. Query the PS domain status with AT+CEREG? (for LTE Cat M1 and Cat NB2 networks) or AT+CGREG? (for EGPRS network) and make sure the PS domain has been registered. 2. Query the PDP context parameters with AT+QICSGP= and make sure that the APN of the specified PDP context has been set. 3. Make sure the specified PDP context ID is neither used by PPP nor activated with AT+CGACT. 4. The module supports maximum three PDP contexts activated simultaneously under LTE Cat M1/ EGPRS and maximum two under LTE Cat NB2. If all above configurations are correct, but activating the PDP context with AT+QIACT still fails, reboot the module. After rebooting, check the configurations above at least three times in 10-minute intervals to avoid frequent module rebooting. 4.3. DNS Parse Failure If +CME ERROR: 714 (714: HTTP(S) DNS error) is returned after executing AT+QHTTPGET, AT+QHTTPPOST, AT+QHTTPPOSTFILE, AT+QHTTPPUT and AT+QHTTPPUTFILE, check the following: 1. Make sure the domain name of the HTTP(S) server is valid. 2. Query the status of the PDP context with AT+QIACT? to make sure the specified PDP context has been activated successfully. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 45 / 52 LPWA Module Series 3. Query the address of the DNS server with AT+QIDNSCFG to make sure the address is not null or '0.0.0.0'. If the DNS server address is null or '0.0.0.0', there are three solutions: 1. Reassign a valid DNS server address with AT+QIDNSCFG. 2. Deactivate the PDP context with AT+QIDEACT, and then re-activate the PDP context with AT+QIACT. 3. If the module has registered to an NB-IoT network, execute AT+QCFG='nccconf',101 to enable ePCO, and then re-register to the network with AT+CFUN=0/1 or reboot the module. 4.4. Entering Data Mode Failure If +CME ERROR: 704 (704: HTTP(S) UART busy) is returned after executing AT+QHTTPURL, AT+QHTTPGET, AT+QHTTPPOST, AT+QHTTPPUT and AT+QHTTPREAD, check if there are several ports in data mode, since the module only supports one port in data mode at a time. If there are, re-execute these commands when all but one of the ports have exited the data mode. 4.5. Sending GET/POST/PUT Requests Failure If a failed response is received after executing AT+QHTTPGET, AT+QHTTPPOST, QHTTPPOSTFILE, AT+QHTTPPUT and AT+QHTTPPUTFILE, check the following configurations: 1. Make sure the URL inputted via AT+HTTPURL is valid and can be accessed. 2. Make sure the specified server supports GET/POST/PUT requests. 3. Make sure the PDP context has been activated successfully. If all above configurations are correct, but sending GET/POST/PUT requests with AT+QHTTPGET, AT+QHTTPPOST, AT+QHTTPPOSTFILE, AT+QHTTPPUT and AT+QHTTPPUTFILE still fails, deactivate the PDP context with AT+QIDEACT and then re-activate it with AT+QIACT to resolve this issue. If activating the PDP context fails, see Chapter 4.2. 4.6. Reading Response Failure Before reading responses with AT+QHTTPREAD and AT+QHTTPREADFILE, execute AT+QHTTPGET, AT+QHTTPPOST, AT+QHTTPPOSTFILE, AT+QHTTPPUT and AT+QHTTPPUTFILE and wait until the following URC information is reported: +QHTTPGET: [,[,]] BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 46 / 52 LPWA Module Series +QHTTPPOST: [,[,]] +QHTTPPOSTFILE: [,[,]] +QHTTPPUT: [,[,]] +QHTTPPUTFILE: [,[,]] In case of errors during the execution of AT+QHTTTPREAD and AT+QHTTPREADFILE, such as +CME ERROR: 717 (717: HTTP(S) socket read error), resend HTTP(S) GET/POST/PUT requests to the HTTP(S) server with AT+QHTTPGET, AT+QHTTPPOST, AT+QHTTPPOSTFILE, AT+QHTTPPUT and AT+QHTTPPUTFILE. If the sending of GET/POST/PUT requests to HTTP(S) server fails, see Chapter 4.5 to resolve this issue. BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 47 / 52 LPWA Module Series 5 Summary of Result Codes The result code indicates a result related to mobile equipment or network operation. The meaning of is presented in the following table. Table 3: Summary of Result Codes 0 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 Meaning Operation successful HTTP(S) unknown error HTTP(S) timeout HTTP(S) busy HTTP(S) UART busy HTTP(S) no GET/POST/PUT requests HTTP(S) network busy HTTP(S) network open failed HTTP(S) network no configuration HTTP(S) network deactivated HTTP(S) network error HTTP(S) URL error HTTP(S) empty URL HTTP(S) IP address error HTTP(S) DNS error HTTP(S) socket create error HTTP(S) socket connect error HTTP(S) socket read error BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 48 / 52 LPWA Module Series 718 HTTP(S) socket write error 719 HTTP(S) socket closed 720 HTTP(S) data encode error 721 HTTP(S) data decode error 722 HTTP(S) read timeout 723 HTTP(S) response failed 724 Incoming call busy 725 Voice call busy 726 Input timeout 727 Wait data timeout 728 Wait HTTP(S) response timeout 729 Memory allocation failed 730 Invalid parameter BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 49 / 52 LPWA Module Series 6 Summary of HTTP(S) Response Codes indicates the response codes from HTTP(S) server. The meaning of is presented in the following table. Table 4: Summary of HTTP(S) Response Codes 200 403 404 409 411 500 Meaning OK Forbidden Not found Conflict Length required Internal server error BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 50 / 52 LPWA Module Series 7 Appendix References Table 5: Related Documents Document Name [1] Quectel_BG95&BG77&BG600L_Series_TCP(IP)_AT_Commands_Manual [2] Quectel_BG95&BG77&BG600L_Series_SSL_AT_Commands_Manual [3] Quectel_BG95&BG77&BG600L_Series_AT_Commands_Manual [4] Quectel_BG95&BG77&BG600L_Series_FILE_Application_Note Table 6: Terms and Abbreviations Abbreviation APN CA COM port CR DNS DTR EGPRS ePCO GMT HTTP HTTPS Description Access Point Name Certification Authority Communication Port Carriage Return Domain Name Server Data Terminal Ready Enhanced General Packet Radio Service Extended Protocol Configuration Options Greenwich Mean Time Hyper Text Transport Protocol Hyper Text Transfer Protocol Secure BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 51 / 52 ID IP LF LTE LTE Cat PAP PDP PPP PS SIM SSL TCP TLS UART UFS URC URI URL USB USIM LPWA Module Series Identifier Internet Protocol Line Feed (a new line) Long-Term Evolution LTE Category Password Authentication Protocol Packet Data Protocol Point-to-Point Protocol Packet Switch Subscriber Identity Module Security Socket Layer Transmission Control Protocol Transport Layer Security Universal Asynchronous Receiver/Transmitter. Universal Flash Storage Unsolicited Result Code Uniform Resource Identifier Uniform Resource Locator Universal Serial Bus Universal Subscriber Identity Module BG95&BG77&BG600L_Series_HTTP(S)_Application_Note 52 / 52

BG95&BG77 MQTT Application Note LPWA Module Series Rev. BG95&BG77_MQTT_Application_Note_V1.0 Date: 2019-08-12 Status: Released www.quectel.com LPWA Module Series BG95&BG77 MQTT Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai, China 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. 2019. All rights reserved. BG95&BG77_MQTT_Application_Note 1 / 32 LPWA Module Series BG95&BG77 MQTT Application Note About the Document History Revision Date Author 1.0 2019-08-12 Lane HAO Description Initial BG95&BG77_MQTT_Application_Note 2 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 2 MQTT Data Interaction......................................................................................................................... 6 3 MQTT Related AT Commands ............................................................................................................ 7 3.1. AT Command Syntax .................................................................................................................. 7 3.2. Description of MQTT Related AT Commands............................................................................. 7 3.2.1. AT+QMTCFG Configure Optional Parameters of MQTT .............................................. 7 3.2.2. AT+QMTOPEN Open a Network for MQTT Client ...................................................... 12 3.2.3. AT+QMTCLOSE Close a Network for MQTT Client ................................................... 13 3.2.4. AT+QMTCONN Connect a Client to MQTT Server..................................................... 14 3.2.5. AT+QMTDISC Disconnect a Client from MQTT Server .............................................. 15 3.2.6. AT+QMTSUB Subscribe to Topics .............................................................................. 16 3.2.7. AT+QMTUNS Unsubscribe from Topics ...................................................................... 17 3.2.8. AT+QMTPUB Publish Messages ................................................................................ 18 3.2.9. AT+QMTPUBEX Publish Messages ........................................................................... 19 3.2.10. AT+QMTRECV Read Messages from Buffers ............................................................ 21 4 Summary of Error Codes .................................................................................................................. 23 5 MQTT Related URCs .......................................................................................................................... 25 5.1. '+QMTSTAT' URC to Indicate State Change in MQTT Link Layer .......................................... 25 5.2. '+QMTRECV' URC to Inform the Host to Read MQTT Packet Data....................................... 26 6 Examples ............................................................................................................................................ 27 6.1. Example of MQTT Operation without SSL ............................................................................... 27 6.2. Example of MQTT Operation with SSL..................................................................................... 29 7 Appendix A References..................................................................................................................... 32 BG95&BG77_MQTT_Application_Note 3 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Table Index TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 23 TABLE 2: MQTT RELATED URCS.................................................................................................................... 25 TABLE 3: ERROR CODES OF '+QMTSTAT' URC .......................................................................................... 25 TABLE 4: RELATED DOCUMENTS .................................................................................................................. 32 TABLE 5: TERMS AND ABBREVIATIONS ........................................................................................................ 32 BG95&BG77_MQTT_Application_Note 4 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 1 Introduction MQTT (Message Queuing Telemetry Transport) is a broker-based publish/subscribe messaging protocol designed to be open, simple, lightweight and easy to implement. It is designed for connections with remote locations where a 'small code footprint' is required or the network bandwidth is limited. This document mainly introduces how to use the MQTT function of Quectel BG95 and BG77 modules through AT commands. BG95&BG77_MQTT_Application_Note 5 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 2 MQTT Data Interaction This chapter gives the data interaction mechanism of MQTT function. MCU Modem Link layer MQTT Server Data report type (None URC): +QMT***: ,,… (1) =0: Receive ACK packets from server; (2) =1: Packet sending timeout and retransmission; (3) =2: Packet sending timeout and the maximum times of transmission is reached. AT+QMTCFG='will',, AT+QMTCFG='timeout',, AT+QMTOPEN=,'', OK TCP-REQ +QMTOPEN: , TCP established AT+QMTCONN AT+QMTCONN=,'', CONN-REQ OK Start timer +QMTCONN: ,[,] T1, T2 CONN ACK-IND Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK Send connect packet Receive connect ACK packet T1 is packet transmission timeout. T2 is keep alive timer. In the absence of a data-related message during the T2 time period, the client will send PINGREQ packet. AT+QMTSUB AT+QMTSUB=,... OK +QMTSUB: ,,[,] AT+QMTUNS AT+QMTUNS=,... OK +QMTUNS: ,, SUB-REQ (msgId) Start timer T1 SUB ACK-IND (msgId) Stop T1 or handle Excep2 +QMTSUB: tcpidx,1,msgId Send subscribe packet Receive subscribe ACK packet UNS-REQ (msgId) Start timer T1 UNS ACK-IND (msgId) Stop T1 or handle Excep2 +QMTUNS: tcpidx,1,msgId Send unsubscribe packet Receive unsubscribe ACK packet Excep1: Disconnect the TCP connection. Excep2: Resend packets unless maximum retry times is reached. Retry times is set by AT+QMTCFG. AT+QMTPUB=,, = 0 , ,'' OK AT+QMTPUB (=1) AT+QMTPUB=,, = 1 , ,'' OK +QMTPUB: ,,[,] PUB-REQ Send publish packet PUB-REQ (msgId) Start timer T1 PUB ACK-IND (msgId) Stop T1 or handle Excep2 +QMTPUB: tcpidx,1,msgId Send publish packet Receive publish ACK packet Whether the timeout information is reported can be configured by AT+QMTCFG. AT+QMTPUB (=2) AT+QMTPUB=,, = 2 , ,'' OK +QMTPUB: ,,[,] PUB-REQ (msgId) Start timer T1 +QMTPUB: tcpidx,1,msgId Send publish packet PUB REC-IND (msgId) Receive publish receive packet Stop T1 or handle Excep2 PUB REL-REQ (msgId) Start timer T1 PUB COMP-IND (msgId) +QMTPUBREL: tcpidx,1,msgId Send publish release packet Receive publish complete packet Stop T1 or handle Excep2 Receive PUBLISH Receive message in the form of URC. +QMTRECV: ,,, AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , PUB-IND (msgId) PUB ACK/REC-REQ (msgId) Reply accor.d..ing to DISC-REQ Receive publish packet Send publish reply packet Send disconnect packet TCP-REQ TCP disconnected TCP discon..n. ect request Note: refers to optional parameters. For more details about optional parameters, please refer to the description of corresponding AT command in Chapter 3.2. Figure 1: MQTT Data Interaction Diagram BG95&BG77_MQTT_Application_Note 6 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 3 MQTT Related AT Commands This chapter presents the AT commands for operating MQTT function. 3.1. AT Command Syntax Table 1: Types of AT Commands and Responses Test Command Read Command Write Command Execution Command AT+=? AT+? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the module. 3.2. Description of MQTT Related AT Commands 3.2.1. AT+QMTCFG Configure Optional Parameters of MQTT The command is used to configure optional parameters of MQTT. AT+QMTCFG Configure Optional Parameters of MQTT Test Command AT+QMTCFG=? Response +QMTCFG: 'version',(0-5),(3,4) +QMTCFG: 'pdpcid',(0-5),(1-16) +QMTCFG: 'ssl',(0-5),(0,1),(0-5) +QMTCFG: 'keepalive',(0-5),(0-3600) +QMTCFG: 'session',(0-5),(0,1) +QMTCFG: 'prefix',(0-5),,(32,40,48,56,64,96) +QMTCFG: 'timeout',(0-5),(1-60),(0-10),(0,1) +QMTCFG: 'will',(0-5),(0,1),(0-2),(0,1),, +QMTCFG: 'recv/mode',(0-5),(0,1),(0,1) +QMTCFG: 'aliauth',(0-5),,, Write Command Configure/query the MQTT protocol version AT+QMTCFG='version',[,] OK Response If is present, configure the MQTT protocol version: OK If is omitted, query the MQTT protocol version: +QMTCFG: 'version', OK Write Command Configure/query the PDP to be used by the MQTT client AT+QMTCFG='pdpcid',[,] If there is an error related to ME functionality: +CME ERROR: Response If is present, configure the PDP to be used by the MQTT client: OK If is omitted, query the PDP used by the MQTT client: +QMTCFG: 'pdpcid', OK Write Command Configure/query the MQTT SSL mode and SSL context index AT+QMTCFG='ssl',[, [,]] If there is an error related to ME functionality: +CME ERROR: Response If and are present, configure the MQTT SSL mode and SSL context index: OK If and are omitted, query the MQTT SSL mode and SSL context index: +QMTCFG: 'ssl',[,] OK Write Command Configure/query the keep-alive time If there is an error related to ME functionality: +CME ERROR: Response If is present, configure the keep-alive time: BG95&BG77_MQTT_Application_Note 8 / 32 LPWA Module Series BG95&BG77 MQTT Application Note AT+QMTCFG='keepalive',[,] OK If is omitted, query the keep-alive time: +QMTCFG: 'keepalive', OK Write Command Configure/query the session type AT+QMTCFG='session',[,] If there is an error related to ME functionality: +CME ERROR: Response If is present, configure the session type: OK If is omitted, query the session type: +QMTCFG: 'session', OK Write Command Configure/query the prefix of IPv4-converted IPv6 address AT+QMTCFG='prefix',[,,] If there is an error related to ME functionality: +CME ERROR: Response If and are present, configure the prefix of IPv4-converted IPv6 address: OK If and are omitted, query the prefix of IPv4-converted IPv6 address: +QMTCFG: 'prefix',, Write Command Configure/query the timeout of message delivery AT+QMTCFG='timeout',[,[,][,]] OK Response If all parameters are present, configure the timeout of message delivery: OK If , and are omitted, query the timeout of message delivery: +QMTCFG: 'timeout',,, OK If there is an error related to ME functionality: +CME ERROR: BG95&BG77_MQTT_Application_Note 9 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Write Command Configure/query the Will information AT+QMTCFG='will',[, [,,,< will_topic>,]] Response If all parameters are present, configure the Will information: OK If , , , and are omitted, query the Will information: +QMTCFG: 'will',[,,,,] OK Write Command Configure/query the MQTT message receiving mode when the data is received from server AT+QMTCFG='recv/mode',[,[,]] If there is an error related to ME functionality: +CME ERROR: Response If and are present, configure the MQTT message receiving mode: OK If and are omitted, query the MQTT message receiving mode. +QMTCFG: 'recv/mode',[,] OK Write Command Configure Alibaba device information for AliCloud AT+QMTCFG='aliauth',[,,,< device_secret>] If there is an error related to ME functionality: +CME ERROR: Response If all parameters are present, configure the device information: OK If ,, are omitted, query the device information: [+QMTCFG: 'aliauth',,,] OK Maximum Response Time If there is an error related to ME functionality: +CME ERROR: 300ms BG95&BG77_MQTT_Application_Note 10 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Parameter MQTT socket identifier. The range is 0-5. MQTT protocol version. 3 MQTT v3.1 4 MQTT v3.1.1 The PDP to be used by the MQTT client. The range is 1-16. The default value is 1. Configure the Will flag. 0 Ignore the Will flag configuration 1 Require the Will flag configuration Quality of service for message delivery. 0 At most once 1 At least once 2 Exactly once The Will retain flag is only used on PUBLISH messages. 0 When a client sends a PUBLISH message to a server, the server will not hold on to the message after it has been delivered to the current subscribers 1 When a client sends a PUBLISH message to a server, the server should hold on to the message after it has been delivered to the current subscribers Will topic string. The Will message defines the content of the message that is published to the Will topic if the client is unexpectedly disconnected. It can be a zero-length message. Timeout of the packet delivery. The range is 1-60. The default value is 5. Unit: second. Retry times when packet delivery times out. The range is 0-10. The default value is 3. 0 Not report timeout message when transmitting packet 1 Report timeout message when transmitting packet Configure the session type. 0 The server must store the subscriptions of the client after it is disconnected. 1 The server must discard any previously maintained information about the client and treat the connection as 'clean'. The prefix of IPv4-converted IPv6 address. The length of the prefix string. The value can be 32, 40, 48, 56, 64 or 96. Unit: Byte. Keep-alive time. The range is 0-3600. The default value is 120. Unit: second. It defines the maximum time interval between messages received from a client. If the server does not receive a message from the client within 1.5 times of the keep-alive time period, it disconnects the client as if the client has sent a DISCONNECT message. 0 No limitations on the maximum time interval between messages received from a client MQTT SSL mode. 0 Use normal TCP connection for MQTT BG95&BG77_MQTT_Application_Note 11 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 1 Use SSL TCP secure connection for MQTT SSL context index. The range is 0-5. Integer type. The MQTT message receiving mode. 0 MQTT message received from server will be contained in URC 1 MQTT message received from server will not be contained in URC Integer type. 0 Length of MQTT message received from server will not be contained in URC 1 Length of MQTT message received from server will be contained in URC Product key issued by AliCloud. Device name issued by AliCloud. Device secret key issued by AliCloud. NOTES 1. If =1, then , , and must be present. Otherwise they will be omitted. 2. =0 is only effective when the server supports the operation. 3. If MQTT connection is configured to SSL mode, must be present, and AT+QSSLCFG must be used to configure the SSL version, cipher suite, secure level, CA certificate, client certificate, client key and ignorance of RTC time, which will be used in MQTT SSL handshake procedure. For more details of AT+QSSLCFG, please refer to Quectel_BG95&BG77_SSL_AT_Commands_Manual. 4. Care must be taken to ensure message delivery does not time out while it is still being sent. 5. AT+QMTCFG='aliauth' command is only used for AliCloud. If it is configured, the parameters and in command AT+QMTCONN can be omitted. 3.2.2. AT+QMTOPEN Open a Network for MQTT Client The command is used to open a network for MQTT client. AT+QMTOPEN Open a Network for MQTT Client Test Command AT+QMTOPEN=? Response +QMTOPEN: (list of supported s),,(list of supported s) Read Command AT+QMTOPEN? OK Response [+QMTOPEN: ,,] OK Write Command AT+QMTOPEN=,, Response OK +QMTOPEN: , BG95&BG77_MQTT_Application_Note 12 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Maximum Response Time If there is an error related to ME functionality: +CME ERROR: 75s, determined by network Parameter MQTT socket identifier. The range is 0-5. The address of the server. It could be an IP address or a domain name. The maximum length is 100 bytes. The port number of the server. The range is 0-65535. Result of the command execution. -1 Failed to open network 0 Network opened successfully 1 Wrong parameter 2 MQTT socket identifier is occupied 3 Failed to activate PDP 4 Failed to parse domain name 5 Network disconnection error 3.2.3. AT+QMTCLOSE Close a Network for MQTT Client The command is used to close a network for MQTT client. AT+QMTCLOSE Close a Network for MQTT Client Test Command AT+QMTCLOSE=? Response +QMTCLOSE: (list of supported s) Write Command AT+QMTCLOSE= OK Response OK +QMTCLOSE: , Maximum Response Time If there is an error related to ME functionality: +CME ERROR: 300ms Parameter MQTT socket identifier. The range is 0-5. BG95&BG77_MQTT_Application_Note 13 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Result of the command execution. -1 Failed to close network 0 Network closed successfully 3.2.4. AT+QMTCONN Connect a Client to MQTT Server The command is used when a client requests a connection to MQTT server. When a TCP/IP socket connection is established from a client to a server, a protocol level session must be created using a CONNECT flow. AT+QMTCONN Connect a Client to MQTT Server Test Command AT+QMTCONN=? Response +QMTCONN: (list of supported s),[,[,]] Read Command AT+QMTCONN? OK Response [+QMTCONN: ,] Write Command AT+QMTCONN=,[,[,]] OK Response OK +QMTCONN: ,[,] Maximum Response Time If there is an error related to ME functionality: +CME ERROR: (default 5s), determined by network Parameter MQTT socket identifier. The range is 0-5. The client identifier string. User name of the client. It can be used for authentication. Password corresponding to the user name of the client. It can be used for authentication. Result of the command execution. 0 Packet sent successfully and ACK received from server 1 Packet retransmission 2 Failed to send packet MQTT connection state. 1 MQTT is initializing BG95&BG77_MQTT_Application_Note 14 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 2 MQTT is connecting 3 MQTT is connected 4 MQTT is disconnecting Connection status return code. 0 Connection Accepted 1 Connection Refused: Unacceptable Protocol Version 2 Connection Refused: Identifier Rejected 3 Connection Refused: Server Unavailable 4 Connection Refused: Bad User Name or Password 5 Connection Refused: Not Authorized Timeout of the packet delivery. The range is 1-60. The default value is 5. Unit: second. The error code of operation. For more details, please refer to Chapter 4. NOTE If a client with the same Client ID is already connected to the server, the 'older' client must be disconnected by the server before completing the CONNECT flow of the new client. 3.2.5. AT+QMTDISC Disconnect a Client from MQTT Server The command is used when a client requests a disconnection from MQTT server. A DISCONNECT message is sent from the client to the server to indicate that it is about to close its TCP/IP connection. AT+QMTDISC Disconnect a Client from MQTT Server Test Command AT+QMTDISC=? Response +QMTDISC: (list of supported s) Write Command AT+QMTDISC= OK Response OK +QMTDISC: , Maximum Response Time If there is an error related to ME functionality: +CME ERROR: 300ms Parameter MQTT socket identifier. The range is 0-5. BG95&BG77_MQTT_Application_Note 15 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Result of the command execution -1 Failed to close connection 0 Connection closed successfully The error code of operation. For more details, please refer to Chapter 4. 3.2.6. AT+QMTSUB Subscribe to Topics The command is used to subscribe to one or more topics. A SUBSCRIBE message is sent by a client to register an interest in one or more topic names with the server. Messages published to these topics are delivered from the server to the client as PUBLISH messages. AT+QMTSUB Subscribe to Topics Test Command AT+QMTSUB=? Response +QMTSUB: (list of supported s),(list of supported s),,(list of supported s) Write Command AT+QMTSUB=,,,[,,…] OK Response OK +QMTSUB: ,,[,] Maximum Response Time If there is an error related to ME functionality: +CME ERROR: * (default 15s), determined by network Parameter MQTT socket identifier. The range is 0-5. Message identifier of packet. The range is 1-65535. The topic that the client wants to subscribe to or unsubscribe from. The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once Result of the command execution. 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet If is 0, it is a vector of granted QoS levels. If is 1, it means the times of packet retransmission. If is 2, it will not be presented. BG95&BG77_MQTT_Application_Note 16 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Timeout of the packet delivery. The range is 1-60. The default value is 5. Unit: second. Retry times when packet delivery times out. The range is 0-10. The default value is 3. The error code of operation. For more details, please refer to Chapter 4. NOTE The is only present in messages where the QoS bits in the fixed header indicate QoS levels 1 or 2. It must be unique amongst the set of 'inflight' messages in a particular direction of communication. It typically increases by exactly one from one message to the next, but is not required to do so. 3.2.7. AT+QMTUNS Unsubscribe from Topics The command is used to unsubscribe from one or more topics. An UNSUBSCRIBE message is sent by the client to the server to unsubscribe from named topics. AT+QMTUNS Unsubscribe from Topics Test Command AT+QMTUNS=? Response +QMTUNS: (list of supported s),(list of supported s), Write Command AT+QMTUNS=,,[,…] OK Response OK +QMTUNS: ,, Maximum Response Time If there is an error related to ME functionality: +CME ERROR: * (default 15s), determined by network Parameter MQTT socket identifier. The range is 0-5. Message identifier of packet. The range is 1-65535. The topic that the client wants to subscribe to or unsubscribe from. Result of the command execution. 0 Sent packet successfully and received ACK from server 1 Packet retransmission 2 Failed to send packet BG95&BG77_MQTT_Application_Note 17 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Timeout of the packet delivery. The range is 1-60. The default value is 5. Unit: second. Retry times when packet delivery times out. The range is 0-10. The default value is 3. The error code of operation. For more details, please refer to Chapter 4. 3.2.8. AT+QMTPUB Publish Messages The command is used to publish messages by a client to a server for distribution to interested subscribers. Each PUBLISH message is associated with a topic name. If a client subscribes to one or more topics, any message published to those topics are sent by the server to the client as a PUBLISH message. AT+QMTPUB Publish Messages Test Command AT+QMTPUB=? Response +QMTPUB: (list of supported s),(list of supported s),(list of supported s),(list of supported s),,[] Write Command Publish variable-length messages AT+QMTPUB=,,,, After > is responded, input the data to be sent. Tap CTRL+Z to send, and tap ESC to cancel the operation. OK Response OK +QMTPUB: ,,[,] If there is an error related to ME functionality: +CME ERROR: Write Command Publish fixed-length messages AT+QMTPUB=,,,,, After > is responded, input the data to be sent. The number of bytes of input data must equal to . Response OK +QMTPUB: ,,[,] If there is an error related to ME functionality: +CME ERROR: Maximum Response Time * (default 15s), determined by network Parameter MQTT socket identifier. The range is 0-5. Message identifier of packet. The range is 0-65535. It will be 0 only when =0. BG95&BG77_MQTT_Application_Note 18 / 32 LPWA Module Series BG95&BG77 MQTT Application Note The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once Whether or not the server will retain the message after it has been delivered to the current subscribers. 0 The server will not retain the message after it has been delivered to the current subscribers 1 The server will retain the message after it has been delivered to the current subscribers Topic that needs to be published. Length of the message to be published. The range is 1-1548. Unit: byte. Result of the command execution. 0 Packet sent successfully and ACK received from server (message that published when =0 does not require ACK) 1 Packet retransmission 2 Failed to send packet If is 1, it means the times of packet retransmission. If is 0 or 2, it will not be presented. Timeout of the packet delivery. The range is 1-60. The default value is 5. Unit: second. Retry times when packet delivery times out. The range is 0-10. The default value is 3. The error code of operation. For more details, please refer to Chapter 4. NOTES 1. If this command is executed successfully and gets OK back, the client can continue to publish new packets. The maximum quantity of packet to be transmitted should not be greater than that of inflight windows (5). 2. After executing this command, the client will be ready to send data, which will be sent as payload. The maximum length of the input data is 1548 bytes at a time and please tap Ctrl+Z to send the data. 3. PUBLISH messages can be sent either from a publisher to the server, or from the server to a subscriber. When a server publishes messages to a subscriber, the following URC will be returned to notify the host to read the received data that is reported by MQTT server: +QMTRECV: ,,, For more details about the URC description, please refer to Chapter 5.2. 3.2.9. AT+QMTPUBEX Publish Messages The command is used to publish messages. It provides the same functions as AT+QMTPUB, except that the format is different. BG95&BG77_MQTT_Application_Note 19 / 32 LPWA Module Series BG95&BG77 MQTT Application Note AT+QMTPUBEX Publish Messages Test Command AT+QMTPUBEX=? Response +QMTPUBEX: (list of supported s),(list of supported s),(list of supported s),(list of supported s),, Write Command AT+QMTPUBEX=,,,,,' OK Response OK +QMTPUBEX: ,,[,] Maximum Response Time If there is an error related to ME functionality: +CME ERROR: * (default 15s), determined by network Parameter MQTT socket identifier. The range is 0-5. Message identifier of packet. The range is 0-65535. It will be 0 only when =0. The QoS level at which the client wants to publish the messages. 0 At most once 1 At least once 2 Exactly once Whether or not the server will retain the message after it has been delivered to the current subscribers. 0 The server will not retain the message after it has been delivered to the current subscribers 1 The server will retain the message after it has been delivered to the current subscribers Topic that needs to be published. Message to be published. Result of the command execution. 0 Packet sent successfully and ACK received from server (message that published when =0 does not require ACK) 1 Packet retransmission 2 Failed to send packet If is 1, it means the times of packet retransmission. If is 0 or 2, it will not be presented. Timeout of the packet delivery. The range is 1-60. The default value is 5. Unit: BG95&BG77_MQTT_Application_Note 20 / 32 LPWA Module Series BG95&BG77 MQTT Application Note second. Integer type. Retry times when packet delivery times out. The range is 0-10. The default value is 3. The error code of operation. For more details, please refer to Chapter 4. 3.2.10. AT+QMTRECV Read Messages from Buffers The command is used to read messages from storage buffer where the messages are stored when they are reported by the server. AT+QMTRECV Read Messages from Buffers Test Command AT+QMTRECV=? Read Command AT+QMTRECV? Response OK Response +QMTRECV: ,,,,, OK Write Command AT+QMTRECV=[,] If there is no MQTT connection, response: OK Response List of (+QMTRECV: ,,,[,])s OK If there is no message received, response: OK Maximum Response Time If there is no MQTT connection, response: ERROR Parameter Integer type. MQTT client identifier. The range is 0-5. Integer type. Indicate whether there is a message stored in the buffer. 0 means no, and 1 means yes. The maximum quantity of message that can be stored in the buffer is 5. Therefore, URC reports maximally 5 messages simultaneously. Integer type. Indicate the serial number of every single message received. The range is 0-4. BG95&BG77_MQTT_Application_Note 21 / 32 LPWA Module Series BG95&BG77 MQTT Application Note Integer type. Message identifier of packet. The range is 0-65535. It will be 0 only when =0. String type. Topic that needs to be published. Integer type. The length of payload. String type. The payload that relates to the topic name. BG95&BG77_MQTT_Application_Note 22 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 4 Summary of Error Codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The following table lists some of the general error codes. Table 1: Summary of Error Codes 0 1 2 3 4 5 6 7 10 11 12 13 14 15 16 17 18 Meaning UE failure No connection to UE Adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required PH-FSIM PIN required PH-FSIM PUK required (U)SIM not inserted (U)SIM PIN required (U)SIM PUK required (U)SIM failure (U)SIM busy (U)SIM wrong Incorrect password (U)SIM PIN2 required (U)SIM PUK2 required BG95&BG77_MQTT_Application_Note 23 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network timeout 32 Network not allowed - emergency calls only 40 Network personalization PIN required 41 Network personalization PUK required 42 Network subset personalization PIN required 43 Network subset personalization PUK required 44 Service provider personalization PIN required 45 Service provider personalization PUK required 46 Corporate personalization PIN required 47 Corporate personalization PUK required BG95&BG77_MQTT_Application_Note 24 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 5 MQTT Related URCs This chapter gives MQTT related URCs and their descriptions. Table 2: MQTT Related URCs SN URC Format Description When the state of MQTT link layer is [1] +QMTSTAT: , changed, the client will close the MQTT connection and report the URC. +QMTRECV: ,,'','' packet data from MQTT server. 5.1. '+QMTSTAT' URC to Indicate State Change in MQTT Link Layer The URC begins with '+QMTSTAT:'. It will be reported when there is a change in the state of MQTT link layer. '+QMTSTAT' URC to Indicate State Change in MQTT Link Layer +QMTSTAT: , close the MQTT connection and report the URC. Reference Parameter MQTT socket identifier. The range is 0-5. An error code. Please refer to the table below for details. Table 3: Error Codes of '+QMTSTAT' URC Description The connection is closed or reset 1 by a peer. How to do Execute AT+QMTOPEN command to reopen the MQTT connection. BG95&BG77_MQTT_Application_Note 25 / 32 2 3 4 5 6 7 8-255 LPWA Module Series BG95&BG77 MQTT Application Note Sending PINGREQ packet timed out or failed. Sending CONNECT packet timed out or failed. Receiving CONNACK packet timed out or failed. The client sends DISCONNECT packet to sever and the server is initiative to close MQTT connection. The client takes the initiative to close the MQTT connection due to packet sending failure all the time. The link is not alive or the server is unavailable. Deactivate PDP first, and then activate PDP and reopen MQTT connection. 1. Check whether the inputted user name and password are correct. 2. Make sure the client ID is not used. 3. Reopen MQTT connection and try to send CONNECT packet to the server again. 1. Check whether the inputted user name and password are correct. 2. Make sure the client ID is not used. 3. Reopen MQTT connection and try to send CONNECT packet to the server again. This is a normal process. 1. Make sure the data is correct. 2. Try to reopen MQTT connection since there may be network congestion or an error. Make sure the link is alive or the server is available currently. Reserved for future use. 5.2. '+QMTRECV' URC to Inform the Host to Read MQTT Packet Data The URC begins with '+QMTRECV:'. It is mainly used to inform the host to read the received MQTT packet data that is reported from MQTT server. '+QMTRECV' URC to Inform the Host to Read MQTT Packet Data +QMTRECV: ,,'','' MQTT server. Reference Parameter MQTT socket identifier. The range is 0-5. The message identifier of packet. The topic that received from MQTT server. The payload that relates to the topic name. BG95&BG77_MQTT_Application_Note 26 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 6 Examples This chapter gives some examples to explain how to use MQTT related AT commands. 6.1. Example of MQTT Operation without SSL AT+QMTCFG='aliauth',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAazZ' //Configure Alibaba device information for AliCloud. OK AT+QMTOPEN=? +QMTOPEN: ,, OK AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 //Open a network for MQTT client. OK +QMTOPEN: 0,0 //Opened the MQTT client network successfully. AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK AT+QMTCONN=? +QMTCONN: , [,[,]] OK //Connect a client to MQTT server. //If AliCloud is connected, AT+QMTCFG='aliauth' can be used to configure the device information in advance, and there is no need to provide username/password here anymore. AT+QMTCONN=0,'clientExample' OK +QMTCONN: 0,0,0 //Connected the client to MQTT server successfully. BG95&BG77_MQTT_Application_Note 27 / 32 LPWA Module Series BG95&BG77 MQTT Application Note AT+QMTSUB=? +QMTSUB: ,,, OK //Subscribe to topics. AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //If a client subscribes to a topic and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,0,'topic/example','This is the payload related to topic' //Unsubscribe from topics. AT+QMTUNS=0,2,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB : ,,,, OK //Publish messages. AT+QMTPUB=0,0,0,0,'topic/pub' >This is test data, hello MQTT. OK //After receiving >, input data 'This is test data, hello MQTT.' and then send it. The maximum length of the data is 1548 bytes and the data that beyond 1548 bytes will be omitted. After inputting data, tap Ctrl+Z to send. +QMTPUB: 0,0,0 //If a client subscribes to a topic named 'topic/pub' and other devices publish the same topic to the server, the module will report the following information. BG95&BG77_MQTT_Application_Note 28 / 32 LPWA Module Series BG95&BG77 MQTT Application Note +QMTRECV: 0,0,'topic/pub','This is test data, hello MQTT.' AT+QMTDISC=0 OK //Disconnect a client from MQTT server. +QMTDISC: 0,0 //Connection closed successfully. 6.2. Example of MQTT Operation with SSL //Configure MQTT session into SSL mode. AT+QMTCFG='ssl',0,1,2 OK //If SSL authentication mode is intended to be set as 'manage server and client authentication if requested by the remote server' (=2 in AT+QSSLCFG), upload CA certificate, client certificate and client private key to UFS. AT+QFUPL='cacert.pem',1758,100 //Upload CA certificate to UFS. CONNECT +QFUPL: 1758,384a OK AT+QFUPL='client.pem',1220,100 //Upload client certificate to UFS. CONNECT +QFUPL: 1220,2d53 OK AT+QFUPL='user_key.pem',1679,100 //Upload client private key to UFS. CONNECT +QFUPL: 1679,335f OK //Configure the path of CA certificate for SSL context 2. AT+QSSLCFG='cacert',2,'cacert.pem' OK //Configure the path of client certificate for SSL context 2. BG95&BG77_MQTT_Application_Note 29 / 32 LPWA Module Series BG95&BG77 MQTT Application Note AT+QSSLCFG='clientcert',2,'client.pem' OK //Configure the path of client private key for SSL context 2. AT+QSSLCFG='clientkey',2,'user_key.pem' OK //Configure the authentication mode for SSL context 2. AT+QSSLCFG='seclevel',2,2 //SSL authentication mode: server and client authentication if requested by the remote server OK AT+QSSLCFG='sslversion',2,4 OK //SSL authentication version AT+QSSLCFG='ciphersuite',2,0XFFFF //Cipher suite OK AT+QSSLCFG='ignorelocaltime',2,1 OK //Ignore the time of authentication. //Start MQTT SSL connection AT+QMTOPEN=0,'a1zgnxur10j8ux.iot.us-east-1.amazonaws.com',8883 OK +QMTOPEN: 0,0 //Connect to MQTT server AT+QMTCONN=0,'MQTT-1' OK +QMTCONN: 0,0,0 //Subscribe to topics. AT+QMTSUB=0,1,'$aws/things/ MQTT-1/shadow/update/accepted',1 OK +QMTSUB: 0,1,0,1 //Publish messages. AT+QMTPUB=0,1,1,0,'$aws/things/MQTT-1/shadow/update/accepted' >This is publish data from client OK BG95&BG77_MQTT_Application_Note 30 / 32 LPWA Module Series BG95&BG77 MQTT Application Note +QMTPUB: 0,1,0 //If a client subscribes to a topic named '$aws/things/MQTT-1/shadow/update/accepted' and other devices publish the same topic to the server, the module will report the following information. +QMTRECV: 0,1,'$aws/things/MQTT-1/shadow/update/accepted','This is publish data from client' //Disconnect a client from MQTT server. AT+QMTDISC=0 OK +QMTDISC: 0,0 BG95&BG77_MQTT_Application_Note 31 / 32 LPWA Module Series BG95&BG77 MQTT Application Note 7 Appendix A References Table 4: Related Documents SN Document Name [1] MQTT V3.1 Protocol Specification [2] MQTT V3.1.1 Protocol Specification Remarks MQTT protocol specification version 3.1 MQTT protocol specification version 3.1.1 Table 5: Terms and Abbreviations Abbreviation ACK MQTT QoS RAM SSL TCP URC Description Acknowledgement Message Queuing Telemetry Transport Quality of Service Random Access Memory Secure Sockets Layer Transmission Control Protocol Unsolicited Result Code BG95&BG77_MQTT_Application_Note 32 / 32

BC26 重要注意事项及常见问题 LPWA 模块系列 版本：BC26_重要注意事项及常见问题_V1.0 日期：2019-03-29 状态：受控文件 www.quectel.com BC26 重要注意事项及常见问题 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 20 BC26 重要注意事项及常见问题 文档历史 修订记录 版本 1.0 日期 2019-03-29 作者 变更表述 饶晨 /刘伟 / 初始版本 孙鹏鹏 上海移远通信技术股份有限公司 2 / 20 BC26 重要注意事项及常见问题 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 2 重要注意事项.......................................................................................................................................... 6 2.1. 不支持 USIM 卡热插拔 ................................................................................................................ 6 2.2. APN/PDN 配置 ............................................................................................................................ 6 2.3. 模块工作模式............................................................................................................................... 7 2.3.1. 模块工作状态概述............................................................................................................... 7 2.3.2. 影响模块进入深睡眠的因素 ................................................................................................ 7 2.3.3. 模块可以进入深睡眠的场景 ................................................................................................ 8 2.4. 模块 IMEI 与 SN 号...................................................................................................................... 8 2.5. AT+EPORT 命令 ......................................................................................................................... 8 2.6. 自适应波特率............................................................................................................................... 9 2.7. 关于时间同步............................................................................................................................... 9 2.8. 不同波特率下的频偏.................................................................................................................... 9 3 常见问题答疑........................................................................................................................................ 11 3.1. 软件相关常见问题 ..................................................................................................................... 11 3.2. 硬件相关常见问题 ..................................................................................................................... 14 4 附录 A 深睡眠模式下模块引脚状态...................................................................................................... 16 5 附录 B 术语缩写 ................................................................................................................................... 19 上海移远通信技术股份有限公司 3 / 20 BC26 重要注意事项及常见问题 表格索引 表 1：不同波特率下 BC26 的 RX 频偏结果（常温：26°C） ............................................................................. 10 表 2：不同波特率下 BC26 的 RX 频偏结果（低温：-40°C）............................................................................ 10 表 3：不同波特率下 BC26 的 RX 频偏结果（高温：85°C） ............................................................................. 10 表 4：深睡眠（DEEP SLEEP）模式下 BC26 模块的引脚状态 ......................................................................... 16 表 5：术语缩写 .................................................................................................................................................. 19 上海移远通信技术股份有限公司 4 / 20 BC26 重要注意事项及常见问题 1 引言 本文档主要介绍了移远通信 BC26 模块使用过程中的重要注意事项及常见问题答疑。 上海移远通信技术股份有限公司 5 / 20 BC26 重要注意事项及常见问题 2 重要注意事项 2.1. 不支持 USIM 卡热插拔 目前模块不支持 USIM 卡热插拔，因此在带电插拔 USIM 卡时会出现各种异常的情况，请注意不要作 此类操作。如果意外出现此类情况，如掉卡时，MCU 在检测到掉卡时会上报+CPIN: NOT READY，随后 用户可尝试重启或者通过 AT+CFUN 命令切换模块状态以重新找卡。 备注 本文所提及的全部 AT 命令，若无特别说明，请参阅 Quectel_BC26_AT_Commands_Manual 以了解详情。 2.2. APN/PDN 配置 目前国内运营商都支持 MME 自动修正 APN，因此配置不正确的 APN 也能接入；但仍不建议随意配置， 因为运营商不同的 APN 会配置不同的网络参数，这将影响 T3324/T3412 的值，进而影响终端的功耗。但 PDN Type 配置错误，将导致不能入网。 请参考如下 AT 命令配置 APN，该命令仅对默认激活的 PDN 有效（开机自动激活），其他多路 PDN 的 配置请使用 AT+CGDCONT/AT+QGACT 命令。 //配置 APN 举例 AT+QCGDEFCONT? +QCGDEFCONT: 'IP','ims' //查询模块当前的 APN 设置 //采用 IPV4，APN 为 ims OK AT+QCGDEFCONT='IP','' OK //设置 APN 为空，即使用默认 APN。 上海移远通信技术股份有限公司 6 / 20 BC26 重要注意事项及常见问题 2.3. 模块工作模式 2.3.1. 模块工作状态概述 模块 Modem 的状态分为 Connected、Idle 和 PSM 三种，满足 3GPP 协议标准。 耗流 接收 状态 发射 状态 模块不活动定时器 Idle T3324 PSM T3412 Idle TAU 图 1：BC26 模块功耗参考示意图 模块状态分为工作态（Active）、轻休眠态（Light Sleep）和深睡眠态（Deep Sleep）。 Connected CPU Active Idle So ftwar e control CPU Light Sleep Software control 1. RTC event 2. PSM_EINT PSM CPU Deep Sleep Only 32KHz RTC is act ive 图 2：BC26 模块工作模式示意图 2.3.2. 影响模块进入深睡眠的因素 如下因素将可能影响模块进入深睡眠： 1) USB 口有 USB 数据线插入 2) AT+QSCLK=0 或 2 上海移远通信技术股份有限公司 7 / 20 BC26 重要注意事项及常见问题 3) AP 侧有任务在处理，如 AT 交互；默认每次发送 AT 命令后，模块会被锁住 10s 无法进入深睡眠； 客户可以执行 AT+QRELLOCK 快速解锁 4) PWRKEY 一直被拉低 5) TCP 链路处于 Open 状态 6) PSM_EINT 电平在一直触发 7) PSM 状态被关闭 8) 未插入 USIM 卡 2.3.3. 模块可以进入深睡眠的场景 当满足如下任一条件时，系统可进入深睡眠： 1) AT+CFUN=0 2) Modem 进入 PSM 3) 底层上报无网（OOS） 4) eDRX 周期在 81.92s 以上 2.4. 模块 IMEI 与 SN 号 BC26 模块出厂时均已写入 IMEI 号和 SN 号且无法修改。 2.5. AT+EPORT 命令 该命令主要用于重新配置 GKI/HSL Log 的输出端口和波特率，推荐配置如下：  如果使用 USB 口抓取 Log：emmi 设置成 4，uls 设置成 5，无需设置波特率。 //使用 USB 口抓取 Log 时的推荐配置方案 AT+EPORT=1,uls,5 //切换 HSL Log 输出端口为 USB 口 AT+EPORT=1,emmi,4 //切换 GKI Log 输出端口为 USB 口  如果使用 UART 口抓取 Log：需要将 DBG 口和 AUX 口引出，emmi 设置成 2，uls 设置成 1，波 特率建议设置成 921600bps 波特率以上。 //使用 UART 口抓取 Log 时的推荐配置方案 AT+EPORT=1,uls,1 //切换 HSL Log 输出端口为 UART 口 AT+EPORT=1,emmi,2 //切换 GKI Log 输出端口为 UART 口 AT+EPORT=3,2,12 //设置 HSL Log 输出端口的波特率为 921600bps AT+EPORT=3,1,12 //设置 GKI Log 输出端口的波特率为 921600bps 上海移远通信技术股份有限公司 8 / 20 BC26 重要注意事项及常见问题 备注 1. 由于 connl 口通常用于 AT 命令通信，因此不推荐使用 connl 口抓取 Log，以防配置为 Log 输出端口 后无法再配置为 AT 命令通信端口。 2. 建议使用如上所述命令配置 GKI/HSL Log 的输出端口和波特率；有关 AT+EPORT 命令的更多详情， 请咨询移远通信技术支持。 2.6. 自适应波特率 模块开机后默认处于自适应波特率模式（目前只支持 115200bps 以下波特率的同步），MCU 需要发送 AT 和模块进行波特率同步，返回 OK 后代表同步成功；休眠唤醒后模块会直接使用开机后同步成功的波特 率，无需重新同步。客户也可使用 AT+IPR 命令配置固定波特率，该命令配置会立即生效并保存到 NVRAM。 备注 自适应模式下，模块休眠唤醒后无需同步波特率，会记忆开机同步的波特率。重启后需要重新同步。 2.7. 关于时间同步 目前 BC26 支持两种时间同步的方式：NTP 时间同步和网络下发时间同步。  AT+CCLK 可用于查询当前的日期和时间  AT+QNTP 可用于指定通过 NTP 服务器同步时间并更新到 RTC  模块在收到网络下发的 MM NETWORK INFO 消息后，会自动同步时间到 RTC 备注 有关 AT+QNTP 的详情，请参阅 Quectel_BC26_TCP(IP)_AT_Commands_Manual。 2.8. 不同波特率下的频偏 如下所示为 BC26 模块在不同温度、不同波特率条件下 Rx 频偏测试结果： 上海移远通信技术股份有限公司 9 / 20 BC26 重要注意事项及常见问题 表 1：不同波特率下 BC26 的 Rx 频偏结果（常温：26°C） Baud Rate Stop Bit 115200 1 Min (bps) 109757 Under 26°C Max (bps) Error (%) Negative Positive 121064 -4.72% 5.09% 38400 1 36588 39957 -4.72% 4.05% 9600 1 9136 10083 -4.83% 5.03% 4800 1 4567 5044 -4.85% 5.08% 表 2：不同波特率下 BC26 的 Rx 频偏结果（低温：-40°C） Baud Rate Stop Bit 115200 1 Min (bps) 109865 Under -40°C Max (bps) Error (%) Negative Positive 120843 -4.63% 4.90% 38400 1 36511 39721 -4.92% 3.44% 9600 1 9141 10062 -4.78% 4.81% 4800 1 4563 4989 -4.94% 3.94% 表 3：不同波特率下 BC26 的 Rx 频偏结果（高温：85°C） Baud Rate Stop Bit 115200 1 Min (bps) 111421 Under 85°C Max (bps) Error (%) Negative Positive 122321 -3.28% 6.18% 38400 1 36583 40265 -4.73% 4.86% 9600 1 9135 10077 -4.84% 4.97% 4800 1 4566 5044 -4.88% 5.08% 上海移远通信技术股份有限公司 10 / 20 BC26 重要注意事项及常见问题 3 常见问题答疑 3.1. 软件相关常见问题 1) Q： 模块支持哪些网络制式？如何设置优先级？ A： BC26 仅支持 NB-IoT，不支持其他的网络制式，因此也不存在优先级设置的问题。 2) Q： BC26 模块可以直接用在海外吗？ A： 不可以。如需应用于海外市场的产品，请咨询移远通信技术支持或当地销售代表。 3) Q： BC26 模块如何获取信号信息？如何判断信号好坏？ A： 可以通过 AT+QENG=0 查询信号质量，当 RSRP 大于-100 且 RSRQ 大于-9，表示信号质量较好， 当 RSRP 小 于 -115 或 RSRQ 小 于 -15 ， 表 示 网 络 信 号 质 量 较 差 。 详 情 请 参 阅 Quectel_BC26_AT_Commands_Manual。 4) Q： BC26 模块支持 NB-IoT 异频组网吗？ A： 如何组网是由运营商决定，与模块本身无关。BC26 支持异频重选和同频重选。 5) Q： BC26 模块进入 PSM 之后为什么 AT 命令不通? A： BC26 进入 PSM 是可以 AT 命令通信的，进入 Deep Sleep 模式将不允许 AT 命令通信。 6) Q： PSM 与 Deep Sleep 是相同的概念吗？ A： 不是，具体的区别请参阅 2.3 章节内容。 7) Q： 为什么模块已经进入 PSM 状态，但是功耗降低依然不明显？ A： 功耗与整个系统的状态有关；Modem 进入 PSM 后，还要模块进入 Deep Sleep，系统功耗才能降 到很低。 8) Q： BC26 模块调试过基于 MQTT 协议对接的平台吗？ A： 有，阿里云平台。 9) Q： BC26 支持 GNSS 或 GSM 么？ A： BC26 不支持 GNSS、也不支持 GSM。如有相关需求，请咨询移远通信技术支持或当地销售代表。 10) Q： BC26 的主芯片型号是什么？支持 3GPP Rel.14 吗？ A： 联发科的 MT2625 芯片，暂不支持 3GPP Rel.14。 上海移远通信技术股份有限公司 11 / 20 BC26 重要注意事项及常见问题 11) Q： 模块支持哪些主要功能？ A： BC26 主要支持：① PS 域业务；②支持基于 IPv4、IPv6、Non-IP 承载的数据传输；③支持 CP/UP 优化方案；④支持短信业务；⑤支持 Multi-tone、Multi-carrier。 12) Q： 模块为何不能基于 Non-IP 做业务？要如何设置才能实现 Non-IP 业务？ A： 模块支持基于 Non-IP 做业务的，但该功能不仅需要模块支持，也需要网络支持，请先咨询运营商 是否开通此项功能。同理，UP 优化方案、短信业务、IPv4/IPv6、Multi-tone/Multi-carrier 等功能 也需要网络支持方可实现。 13) Q： 模块支持到哪个版本的 3GPP 协议？3GPP Rel.14 有哪些主要特性？ A： 模块目前支持到 3GPP Rel.13，暂不支持 3GPP Rel.14。3GPP Rel.14 主要特性：① 峰值速率的 提升；② 定位功能的增强；③ 多播能力增强；④ Non-anchor 上功能增强；⑤ 定义了新的功率 类型。 14) Q： 模块是否支持 RRC 重建、RRC 挂起、RRC 恢复？ A： 在 3GPP Rel.13 中，以上特性均只有用户面支持，BC26 模块可支持用户面优化方案；但最终这 些特性是否能被支持还取决于网络侧。 15) Q： 什么是用户面方案、控制面方案？ A： NB-IoT 网络为了压缩信令，重新设计了网络业务流程，即分别基于 LTE 用户面、控制面进行优化。  基于控制面优化的 eNB 与核心网不建立 S1-U 接口，只建立 S1-C 接口；用户数据通过 eNB 转发到 MME，由 MME 进行转发；  基于用户面优化的 eNB 与核心网同时建立 S1-C/S1-U 的连接，用户数据直接通过基站转发给 SGW。  控制面适合发送小包数据；用户面适合发送较大包的数据，但功耗会稍微大一些。 16) Q： 模块支持哪些频段？ A： BC26 目前已经支持 B1/B3/B5/B8/B20，后续也将开通 B28。另外，BC26 还有其他版本可供可选 选择：如仅支持 B1/B3/B5/B8 的版本、仅支持 B5 的版本、仅支持 B8 的版本等。 17) Q： 为什么开机选网没有选择信号最强的小区？ A： 模块开机后将按照一定的逻辑搜索小区，并在其第一个找到的、且满足小区选择条件（即满足 S 准则）的小区上驻留；因此不一定选择到信号最强的小区。 18) Q： 为什么模块没有重选到最好的小区？ A： 模块并非无条件的选择信号最好的小区：为了避免在两个信号接近的小区之间产生乒乓效应，模 块仅在两个小区之间信号差值达到一定程度时才会进行小区重选；具体的门限差值由网络下发， 各个小区配置的不尽相同。因此模块在小区之间信号差值不大的时候，不一定会发生重选。 19) Q： eDRX、PSM 是什么？ A： 都是节能技术，其中 PSM 是 3GPP Rel.12 引入的，eDRX 是 3GPP Rel.13 引入的。  eDRX（Extended Discontinuous Reception）：扩展的非连续接收，在该模式下只能在 PTW 时间窗内监听下行，最长周期能达到 2.91 小时；  PSM（Power Saving Mode）：节能模式。在此状态下行不可达，不能响应网络寻呼，也不能 上海移远通信技术股份有限公司 12 / 20 BC26 重要注意事项及常见问题 接收网络下发的数据。只能通过模块发送上行数据，或者 TAU 定时器超时唤醒，最长周期达 到 410 多天。 20) Q： 如何通过 AT 命令查看 T3324 和 T3412 的值？ A： 设 置 AT+CEREG=4 或 者 AT+CEREG=5 时 ， 通 过 AT+CEREG? 命 令 可 以 查 询 T3324 和 T3412 extended 的值；T3412 的值暂不支持 AT 命令方式查询。 T3324 T3412 extended 如果 T3412 extended 值存在，周期性位置更新将使用这个值；如果不存在将使用 T3412 值。但 T3412 值目前不能通过 AT 指令查询。关于 AT+CEREG 命令查询的结果具体值表示多少，请参见 Quectel_BC26_AT_Commands_Manual 文档。 21) Q： DRX、eDRX、PSM 是否支持配置？ A： DRX 周期不支持配置，也不支持功能开启或关闭；eDRX 和 PSM 的周期均可配置，也支持功能 开启和关闭，但网络是否接受配置依赖于运营商设置。如果网络不支持配置 eDRX 和 PSM 的周 期，建议咨询运营商特定 APN 对应的 eDRX、PSM 时长，以期找到一个符合业务模型的节能周期。 22) Q： 典型的进入空闲态（Idle）、进入连接态（Connected）、进入 PSM 的场景是什么？ A： 空闲态：开机后完成小区驻留、RRC 连接释放或无线链路失败时，模块将进入空闲态； 连接态：发送任何上/下行数据、信令时，模块均需要进入连接态； PSM：在空闲态活动定时器 T3324 超时后，模块进入 PSM。 23) Q： 如何快速释放 RRC 连接？ A： 通过 AT+QNBIOTRAI=命令可以配置；有关该命令的详细信息，请参见 Quectel_BC26_AT_ Commands_Manual 文档。 目前 NB-IoT 网络中，都是网络侧主动发起释放；但是可以通过所述 AT+QNBIOTRAI=命令 通知网络：UE 再也没有数据传送了；这样网络会决定是否立即释放 RRC 连接。 参数值选项如下： 0 No information available (or none of the other options apply) (default) 1 TE will send only 1 UL packet and no DL packets expected 2 TE will send only 1 UL packet and only 1 DL packet expected 若想要快速释放，需要设置参数值为 1 或者 2：  1 是指终端发送一个上行，不期望有下行包的，比如 UDP 协议，发送完上行就会释放 RRC。  2 是指终端发送一个上行，且有下行 ACK 包，那么收到下行包后会立即释放 RRC，比如 PING；如果这类场景使用了参数 1， 上行发送完成后也会被立即释放，但是因为网络要 给终端回复 ACK，所以网络会再次寻呼终端重新建立 RRC 连接。 上海移远通信技术股份有限公司 13 / 20 BC26 重要注意事项及常见问题 24) Q： 如何清除模块的历史频点信息？ A： 使用 AT+QCSEARFCN 命令可清除历史频点信息，如果返回 0 代表清频成功，返回 3 代表历史频 点信息为空。模块最多能保存 10 条历史频点信息。 25) Q： BC26 是否支持内部看门狗？ A： 支持。当模块出现死机、线程卡死等异常时，会自动触发看门狗自动重启；如果有接 Genie 工具， 在工具收集完 COREDUMP 之后，模块会自动重启。 3.2. 硬件相关常见问题 1) Q： 模块在开机和关机状况下，开始下载的方式是否有区别？ A： 模块与 PC 建立连接进入下载模式后，若模块处于关机状态，则拉低 PWRKEY 开始下载；若 模块已经开机，则拉低 RESET 开始下载。 2) Q： 是否有 BC26 的各种工作模式下的耗流数据？ A： 有，具体请参见 Quectel_BC26_Power_Consumption_Report。 3) Q： 模块开机后能否快速进入睡眠模式？工厂如何测试模块的低功耗？ A： 不能快速进入睡眠模式。工厂测试过程中，可发送 AT+CFUN=0 以模拟深睡眠模式下的功耗。 4) Q： PSM_EINT 可以硬件唤醒 PSM，但该引脚电压域在硬件设计手册里并没有做说明？ A： PSM_EINT 的电压域为 VBAT，内部默认上拉到 VBAT，建议客户使用 GPIO 通过 OC 电路控制。 5) Q： 不用 PSM_EINT，模块能从 PSM 模式唤醒吗？ A： 可以，T3412 定时器超时后，模块将自动退出 PSM。 6) Q： PWRKEY 引脚内部有上拉吗？ A： PWRKEY 和 RESET 均默认内部上拉到 VBAT。 7) Q： PCBA 上电瞬间有 800mA 的 ms 级别脉冲，为何与耗流测试报告中有差异？ A： 首先要给模块单独供电测试，排除 PCBA 上因其他因素而引起的开机瞬时电流过高。若单独测试 发现所述问题没有改善，请重点关注设备 PCBA 上的电容容值：若有使用 220uF 钽电容，且开机 瞬时峰值电流为 800mA，建议将所述电容容值改为 100uF 再重新测试。 8) Q： 模块 VBAT 的 TVS 管是否有型号推荐？ A： 推荐用韦尔半导体的 ESD56181W04；请注意 TVS 管都会有一定的漏电流，设计时请考虑在内。 9) Q： 网络指示灯是否已经开通了？ A： 已经开通，详情请见 Quectel_BC26_硬件设计手册。 10) Q： PSM_EINT 需要拉低多久方可将模块从 PSM 模式唤醒？ A： 只需要下降沿即可，下降沿触发。 上海移远通信技术股份有限公司 14 / 20 BC26 重要注意事项及常见问题 11) Q： BC26 开机或者复位瞬间，为何会有 200us 左右约 750mA 的大电流产生？ A： 此类大电流通常由 DC-DC 芯片内部产生，是使用 DC-DC 芯片的共性问题。  模块的 BB 芯片提供一个专门的引脚用于 DC-DC 芯片的使能控制；当 VBAT 开始供电并拉低 PWRKEY 开机后，所述的使能控制引脚将从低电平变成高电平以使能 DC-DC 芯片工作（复 位时，此引脚发生同样的电平转换）；使能的瞬间，DC-DC 芯片内部将产生瞬时大电流。  在模块 VBAT 端口加 100uF 的钽电容，将有一定改善作用； VBAT 端口所使用的电容容值越 大，可降低的耗流也越多；推荐使用 100uF 钽电容并且将电容靠近模块摆放。  经过移远通信内部测试验证，如果使用移远通信推荐的锂锰电池供电，则所述瞬时大电流即 便存在也不会影响模块的正常工作；而其他供电方式下，所述瞬时大电流则很可能造成电压 跌落导致异常关机。 12) Q： 按 RESET 复位后，测试的 VDD_EXT 波形为方波形式是否正常？ A： 正常。在 RESET 拉低过程中会出现方波，直至 RESET 被松开。 13) Q： 开机或者唤醒时 VDD_EXT 存在方波形式么？ A： 不会。VDD_EXT 只在复位过程为方波形式。 14) Q：在 Deep sleep 模式下，模块的各个引脚状态如何？是否会造成外部 MCU 漏电？ A：在 Deep sleep 模式下，模块的 VDD_EXT 会被关闭，各引脚的状态请参阅附录 A。 如附录 A 所示，模块引脚分为四类：  电源、地引脚；  PWRKEY、RESET、PSM_EINT：电压域为 VBAT，按照推荐 OC 电路设计做好电平匹配则 不会造成漏电；  其他 I/O 口：电压域为 VDD_EXT，均处于悬空状态，阻抗为 10MΩ 以上，故不会造成漏电；  USB 引脚：电压域为外部供电的 VUSB_3V3，处于悬空状态。 15) Q： PWRKEY/PSM_EINT 一直拉低可否进入 PSM? A： PSM 为 Modem 侧状态，其行为完全遵循 3GPP 协议，与 PWRKEY 和 PSM_EINT 都没有关系。 拉低 PWRKEY 无法使模块进入 Deep Sleep；PSM_EINT 的下降沿可将模块从 Deep Sleep 唤醒， 由于是下降沿触发而非电平触发，因此一直拉低 PSM_EINT 不会对模块是否能够进入 Deep Sleep 产生任何影响。 上海移远通信技术股份有限公司 15 / 20 BC26 重要注意事项及常见问题 4 附录 A 深睡眠模式下模块引脚状态 表 4：深睡眠（Deep Sleep）模式下 BC26 模块的引脚状态 引脚号 1 引脚名称 GND Deep Sleep 模式下模块引脚状态 （悬空/高阻态/上拉/下拉） GND 2 RESERVED 3 SPI_MISO 4 SPI_MOSI 悬空 悬空 悬空 5 SPI_SCLK 悬空 6 SPI_CS 7 PWRKEY 8 RESERVED 悬空 上拉 悬空 9 ADC0 悬空 10 SIM_GND GND 11 SIM_DATA 12 SIM_RST 悬空 悬空 13 SIM_CLK 悬空 14 SIM_VDD 15 RESET 16 NETLIGHT / 上拉 悬空 17 RXD 悬空 18 TXD 19 PSM_EINT 悬空 上拉 上海移远通信技术股份有限公司 16 / 20 20 RI 21 RESERVED 22 RESERVED 23 RESERVED 24 VDD_EXT 25 RESERVED 26 RESERVED 27 GND 28 RXD_AUX 29 TXD_AUX 30 RESERVED 31 RESERVED 32 RESERVED 33 RESERVED 34 GND 35 RF_ANT 36 GND 37 GND 38 DBG_RXD 39 DBG_TXD 40 GND 41 GND 42 VBAT_BB 43 VBAT_RF 44 RESERVED 47 USB_MODE 上海移远通信技术股份有限公司 BC26 重要注意事项及常见问题 悬空 悬空 悬空 悬空 / 悬空 悬空 GND 悬空 悬空 悬空 悬空 悬空 悬空 GND / GND GND 悬空 悬空 GND GND VBAT VBAT 悬空 悬空 17 / 20 49 VUSB_3V3 50 USB_DP 51 USB_DM BC26 重要注意事项及常见问题 / 悬空 悬空 上海移远通信技术股份有限公司 18 / 20 BC26 重要注意事项及常见问题 5 附录 B 术语缩写 表 5：术语缩写 缩写 描述 APN Access Point Name AUX Auxiliary CP Control Plane DBG Debug eDRX Extended Discontinuous Reception eNB Evolved Node B GNSS Global Navigation Satellite System GSM Global System for Mobile Communication IMEI International Mobile Equipment Identity IPv4 Internet Protocol version 4 IPv6 Internet Protocol version 6 MME Mobility Management Entity MQTT Message Queuing Telemetry Transport NB-IoT Narrow Band Internet of Things NTP Network Time Protocol OC Open Collector OOS Out of Service PDN Public Data Network PRB Physical Resource Block 上海移远通信技术股份有限公司 19 / 20 RRC PS PSM RSRP RSRQ RTC SGW SN TCP TVS UART USB USIM UP Radio Resource Control Packet Switch Power Saving Mode Reference Signal Received Power Reference Signal Received Quality Real Time Clock Serving Gateway Serial Number Transmission Control Protocol Transient Voltage Suppression Universal Asynchronous Receiver-Transmitter Universal Serial Bus Universal Subscriber Identity Module User Plane BC26 重要注意事项及常见问题 上海移远通信技术股份有限公司 20 / 20

BC35-G&BC28 CoAP Application Note NB-IoT Module Series Rev. Quectel_BC35-G&BC28_CoAP_Application_Note_V1.0 Date: 2018-12-18 Status: Released www.quectel.com NB-IoT Module Series BC35-G&BC28 CoAP Application Note 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. BC35-G&BC28_CoAP_Application_Note 1 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note About the Document History Revision Date 1.0 2018-12-18 Author Oven TAO/ Benjamin LU Description Initial BC35-G&BC28_CoAP_Application_Note 2 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 1.1. Definitions .................................................................................................................................. 5 1.2. AT Command Syntax ................................................................................................................. 5 1.3. AT Command Responses.......................................................................................................... 6 2 CoAP AT Commands ........................................................................................................................... 7 2.1. AT+QCOAPCREATE Create CoAP Context .......................................................................... 7 2.2. AT+QCOAPDEL Delete CoAP Context .................................................................................. 8 2.3. AT+QCOAPADDRES Add CoAP Client Resources ............................................................... 8 2.4. AT+QCOAPHEAD Configure CoAP Head.............................................................................. 9 2.5. AT+QCOAPOPTION Configure CoAP Options .................................................................... 11 2.6. AT+QCOAPSEND Send Data .............................................................................................. 13 2.7. AT+QCOAPDATASTATUS Query CON Messages Delivery Status..................................... 15 2.8. AT+QCOAPCFG CoAP Configuration Command ................................................................ 16 3 CoAP Related URCs .......................................................................................................................... 18 3.1. Description of Response URC ................................................................................................ 18 3.2. Description of Request URC ................................................................................................... 20 4 Summary of Error Codes .................................................................................................................. 21 5 Examples ............................................................................................................................................ 23 5.1. Send CoAP Request to the CoAP Server ............................................................................... 23 5.2. Register to China Telecom IoT Platform.................................................................................. 25 5.3. Example of using the configure commands ............................................................................ 27 BC35-G&BC28_CoAP_Application_Note 3 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note Table Index TABLE 1: AT COMMAND SYNTAX ..................................................................................................................... 5 TABLE 2: COAP RELATED URCS .................................................................................................................... 18 TABLE 3: GENERAL ERRORS (27.007)........................................................................................................... 21 TABLE 4: GENERAL ERRORS (27.005)........................................................................................................... 21 BC35-G&BC28_CoAP_Application_Note 4 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 1 Introduction This document mainly introduces how to use the CoAP function of Quectel BC35-G and BC28 modules through AT commands. 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 1: AT Command Syntax Test Command AT+=? Check possible sub-parameter values Read Command AT+? Check current sub-parameter values Write Command Execution Command AT+=p1[,p2[,p3[.....]]] Write command AT+ Execution command Multiple commands can be placed on a single line using a semicolon (';') between commands. Only the first command should have AT prefix. Commands can be in upper case 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 ‘=?’. BC35-G&BC28_CoAP_Application_Note 5 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 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, 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 of the format below: +CMD1: OK Or OK BC35-G&BC28_CoAP_Application_Note 6 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 2 CoAP AT Commands 2.1. AT+QCOAPCREATE Create CoAP Context The command is used to create a CoAP context. ERROR or +CME ERROR: will be responded if there is any error. Please refer to Chapter 4 for possible codes. AT+QCOAPCRETAE Create CoAP Context Test Command AT+QCOAPCREATE=? Response +QCOAPCREATE: (the range of supported values of ) OK Write Command AT+QCOAPCREATE= If there is any error: ERROR Or +CME ERROR: Response OK Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Parameter The CoAP context local port. Range: 1-65535. Example AT+QCOAPCREATE=? +QCOAPCREATE: //Check possible parameter values BC35-G&BC28_CoAP_Application_Note 7 / 28 OK AT+QCOAPCREATE=56830 OK NB-IoT Module Series BC35-G&BC28 CoAP Application Note //Create a CoAP context. 2.2. AT+QCOAPDEL Delete CoAP Context The command is used to delete the CoAP context. ERROR or +CME ERROR: will be responded if there is any error. Please refer to Chapter 4 for possible codes. AT+QCOAPDEL Delete CoAP Context Execution Command AT+QCOAPDEL Response OK Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Example AT+QCOAPCREATE=56830 OK AT+QCOAPDEL OK //Create a CoAP context. //Delete the CoAP context. 2.3. AT+QCOAPADDRES Add CoAP Client Resources The command is used to configure the CoAP resources. ERROR or +CME ERROR: will be responded if there is any error. Please refer to Chapter 4 for possible codes. AT+QCOAPADDRES Add CoAP Client Resources Test Command AT+QCOAPADDRES=? Response +QCOAPADDRES: (the range of supported values of ),'' BC35-G&BC28_CoAP_Application_Note 8 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note OK Write Command AT+QCOAPADDRES=,'' If there is any error: ERROR Or +CME ERROR: Response OK If there is any error: ERROR Or +CME ERROR: Maximum Response Time 300ms Parameter The CoAP client resources. Range: 1-50. Unit: character. The resource name. Example AT+QCOAPADDRES=4,'/t/d' OK //Add the CoAP resource, and the value is '/t/d'. 2.4. AT+QCOAPHEAD Configure CoAP Head The command is used to configure CoAP head value (consisting of message ID and token value). ERROR or +CME ERROR: will be responded if there is any error. Please refer to Chapter 4 for possible codes. AT+QCOAPHEAD Configure CoAP Head Test Command AT+QCOAPHEAD=? Response +QCOAPHEAD: [,[][,,]] OK If there is any error: ERROR BC35-G&BC28_CoAP_Application_Note 9 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note Write Command AT+QCOAPHEAD=[,[ ][,,]] Or +CME ERROR: Response OK If there is any error: ERROR Or +CME ERROR: Maximum Response Time 300ms Parameter The message ID and token parameter. Range: 1-5. 1 Generate message ID and token values randomly. 2 Generate message ID randomly; configure token values. 3 Configure message ID randomly only; token value is not needed. 4 Configure message ID; generate token values randomly. 5 Configure message ID and token values. The message ID, which only needs configuring when the value is 3, 4, 5. Range: 0-65535. The length of token values, which only needs configuring when the value is 2 or 5. Range: 1-8. The token values. Hexadecimal format. Only needs configuring when the value is 2 or 5. NOTE If this command is not set, the module will generate message ID randomly without need of token values. Example AT+QCOAPHEAD=1 OK AT+QCOAPHEAD=2,8,0102030405060708 OK AT+QCOAPHEAD=3,13940 OK //Generate the message ID and token value randomly. //Generate message ID randomly, and configure the token value to 0102030405060708. //Configure the message ID to 13940, and the token value is not needed. BC35-G&BC28_CoAP_Application_Note 10 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note AT+QCOAPHEAD=4,13940 OK AT+QCOAPHEAD=5,13940,4,02040608 OK //Configure the message ID to 13940, and generate the token value randomly. //Configure the message ID to 13940, and configure the token value to 02040608. 2.5. AT+QCOAPOPTION Configure CoAP Options The command is used to configure the CoAP options. ERROR or +CME ERROR: will be responded if there is any error. Please refer to Chapter 4 for possible codes. AT+QCOAPOPTION Configure CoAP Options Test Command AT+QCOAPOPTION=? Response +QCOAPOPTION: ,,''[,...] OK Write Command AT+QCOAPOPTION=,,''[,...] Maximum Response Time If there is any error: ERROR Or +CME ERROR: Response OK If there is any error: ERROR Or +CME ERROR: 300ms Parameter The option count. Range: 1-12. The option name. Refer to the RFC 7252. 1 If-Match 3 Uri-Host BC35-G&BC28_CoAP_Application_Note 11 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 4 ETag 5 If-None-Match 6 Observe 7 Uri-Port 8 Location-Path 11 Uri-Path 12 Content-Format 14 Max-Age 15 Uri-Query 17 Accept 20 Location-Query 23 Block2 27 Block1 28 SIZE 35 Proxy-Uri 39 Proxy-Scheme 60 Size1 String type. The option value. The length of value string: 1-180 byte(s). If the is 12 or 17, the should be the value below: 0 Text-plain 40 Application/link-format 41 Application/xml 42 Application/octet-stream 47 Application/exi 50 Application/json Example AT+QCOAPOPTION=1,11,'rd' OK //Configure the CoAP option 11 (Uri-Path) and the value is 'rd'. AT+QCOAPOPTION=2,11,'rd',15,'ep=86370303' OK //Configure the CoAP option 11 (Uri-Path), the value is 'rd', and configure the option 15 (Uri-Query), the value is 'ep=86370303'. AT+QCOAPOPTION=2,11,'.well-know',11,'core' OK //Configure the CoAP option 11 (Uri-Path), the values are '.well-know' and 'core'. BC35-G&BC28_CoAP_Application_Note 12 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 2.6. AT+QCOAPSEND Send Data This command is used to send data to the CoAP server. After sending CON data, the sending result will be automatically notified to the terminal. The status of the CON data that has been sent can also be queried by the terminal with the command AT+QCOAPDATASTATUS?. ERROR or +CME ERROR: will be responded if there is any error. Please refer to Chapter 4 for possible codes. AT+QCOAPSEND Send Data Test Command AT+QCOAPSEND=? Response +QCOAPSEND: ,,, OK Write Command AT+QCOAPSEND=,,, After '>' is responded, input the data to be sent. Tap 'CTRL+Z' to send, and tap 'ESC' to cancel the operation. If there is any error: ERROR Or +CME ERROR: Response OK If there is any error: ERROR Or +CME ERROR: Maximum Response Time 300ms Parameter The message type of CoAP Protocol. Range: 0-3. Refer to the RFC 7252. 0 CON 1 NON 2 ACK 3 RST The method of CoAP Protocol. Refer to the RFC 7252. 1 GET 2 POST 3 PUT 4 DELETE The response code of CoAP Protocol. Refer to the RFC 7252. 0 Empty Message 201 2.01, Created BC35-G&BC28_CoAP_Application_Note 13 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 202 2.02, Deleted 203 2.03, Valid 204 2.04, Changed 205 2.05, Content 400 4.00, Bad Request 401 4.01, Unauthorized 402 4.02, Bad Option 403 4.03, Forbidden 404 4.04, Not Found 405 4.05, Method Not Allowed 406 4.06, Not Acceptable 412 4.12, Precondition Failed 413 4.13, Request Entity Too Large 415 4.15, Unsupported Content-Format 500 5.00, Internal Server Error 501 5.01, Not Implemented 502 5.02, Bad Gateway 503 5.03, Service Unavailable 504 5.04, Gateway Timeout 505 5.05, Proxying Not Supported The CoAP server address. The CoAP server port. Example AT+QCOAPSEND=1,1,139.196.41.136,5683 OK //Send GET request with NON type to the CoAP server. //After receiving '>', input data and then send it. The maximum length of the data is 1024 bytes and the data that beyond 1024 bytes will be omitted. After inputting the data, tap 'Ctrl+Z' to send. AT+QCOAPSEND=0,2,139.196.41.136,5683 >0102 OK //Send POST request in CON type to the CoAP server. //Received response URC. The message ID is 61440, the data length is 25 bytes, and the response code is 2.05. +QCOAPURC: 'rsp' 2.05,61440,25,4E692048616F2066726F6D20436F41502E4E45542052464320 NOTES 1. The max data length is 1024 bytes. 2. If CON data is to be sent, the status (not being sent/sent, waiting for the response of IoT BC35-G&BC28_CoAP_Application_Note 14 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note platform/sending failed/timeout/success/got reset message) of CON data sending must be acquired before sending the next CON or NON data through AT+QCOAPDATASTATUS. 2.7. AT+QCOAPDATASTATUS Query CON Messages Delivery Status This command queries the status of the CON data sent to CoAP server. ERROR or +CME ERROR: will be responded if there is any error. Please refer to Chapter 4 for possible codes. AT+QCOAPDATASTATUS Query CON Messages Delivery Status Read Command AT+QCOAPDATASTATUS? Response +QCOAPDATASTATUS: OK Maximum Response Time If there is any error: ERROR Or +CME ERROR: 300ms Parameter Status of the sent CON data 0 Not being sent 1 Sent, waiting for the response of IoT platform 2 Sending failed 3 Timeout 4 Success 5 Got reset message Example AT+QCOAPSEND=0,1,139.196.41.136,5683 > OK //Send GET request in CON type to CoAP server. //After receiving '>', input data and then send it. AT+QCOAPDATASTATUS? +QCOAPDATASTATUS:1 //Sent, waiting for the response of CoAP server. OK BC35-G&BC28_CoAP_Application_Note 15 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note //Received response URC. The message ID is 61440, the data length is 29 bytes, and the response code is 2.05. +QCOAPURC: 'rsp',2.05,61440,25, 4E692048616F2066726F6D20436F41502E4E455420524643 AT+QCOAPDATASTATUS? +QLWDATASTATUS:4 //Success. OK NOTE This command only queries the status of the CON data that has been sent. 2.8. AT+QCOAPCFG CoAP Configuration Command The command is used to configure the CoAP function parameters. ERROR or +CME ERROR: will be responded if there is any error. Please refer to Chapter 4 for possible codes. AT+QCOAPCFG CoAP Configuration Command Test Command AT+QCOAPCFG=? Read Command AT+QCOAPCFG? Write Command AT+QCOAPCFG='Showra'[,] Response OK Response OK Response If the parameter is present, configure whether to display the IP address and port of sender: OK If the parameter is omitted, query whether the IP address and port of sender is displayed: +QCOAPCFG: 'Showra', OK Write Command AT+QCOAPCFG='Showrspopt'[,<Sh If error is related to ME functionality: ERROR Or +CME ERROR: Response If the parameter is present, configure whether BC35-G&BC28_CoAP_Application_Note 16 / 28 owrspopt>] Maximum Response Time NB-IoT Module Series BC35-G&BC28 CoAP Application Note to display the CoAP option of sender: OK If the parameter is omitted, query whether the CoAP option of sender is displayed: +QCOAPCFG: 'Showrspopt', OK If error is related to ME functionality: ERROR Or +CME ERROR: 300ms Parameter Configure whether or not to display the IP address and port of sender. 0 Do not display the IP address and port. 1 Display the IP address and port in the URC; the format is as follows: +QCOAPURC: 'rsp',[,],,,[, ,] Configure whether or not to display the CoAP option of sender. 0 Do not display the CoAP option. 1 Display the CoAP option in the URC; the format is as follows: +QCOAPURC: 'rsp',,,[,,,''[,...]][,,]. NOTES 1. Considering that the URC will be returned timely after the data is sent, it is recommended to configure with AT+QCOAPCFG before AT+QCOAPSEND. 2. and will not be saved in the flash, thus, the configuration will be reset to default value (0) after powering down. 3. Please refer to Chapter 3 for details about URCs. Example AT+QCOAPCFG? OK AT+QCOAPCFG='Showra',1 OK //Configure to display the IP address and port in the URC. BC35-G&BC28_CoAP_Application_Note 17 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 3 CoAP Related URCs This chapter gives CoAP related URCs and their descriptions. Table 2: CoAP Related URCs Index URC Description When sending the CON message, the +QCOAPURC: 'rsp'[,,],,[,,,''[,…]][,,] URC will be reported. +QCOAPURC: 'req',[,,],,,[,,][,,''[,...]][,,] 3.1. Description of Response URC The module reports the CoAP response event to the device. Notify the Device of the Response Data from the Server URC Format: +QCOAPURC: 'rsp',[,,],,[,,,'' [,...]][,,] Notify the response from CoAP server. Parameter The CoAP server IP address, which will be present with setting AT+QCOAPCFG='Showra',1. The CoAP server port, which will be present with setting AT+QCOAPCFG='Showra',1. The message type of CoAP Protocol. Range: 0-3. Refer to the RFC 7252. BC35-G&BC28_CoAP_Application_Note 18 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 0 CON 1 NON 2 ACK 3 RST The response code of CoAP Protocol. Refer to the RFC 7252. 0 Empty Message 2.01 Created 2.02 Deleted 2.03 Valid 2.04 Changed 2.05 Content 4.00 Bad Request 4.01 Unauthorized 4.02 Bad Option 4.03 Forbidden 4.04 Not Found 4.05 Method Not Allowed 4.06 Not Acceptable 4.12 Precondition Failed 4.13 Request Entity Too Large 4.15 Unsupported Content-Format 5.00 Internal Server Error 5.01 Not Implemented 5.02 Bad Gateway 5.03 Service Unavailable 5.04 Gateway Timeout 5.05 Proxying Not Supported The CoAP message ID. The count of option, which will be present with setting. AT+QCOAPCFG='Showrspopt',1 The option name, which will be present with setting. AT+QCOAPCFG='Showrspopt',1. The option value, which will be present with setting. AT+QCOAPCFG='Showrspopt',1. The data length. The max length is 512. Unit: byte. If the is 12, and the is 0 'text-plain', 41 'application/xml' or 50 'application/json', the format will be text string, otherwise, the format will be hexadecimal. BC35-G&BC28_CoAP_Application_Note 19 / 28 3.2. Description of Request URC NB-IoT Module Series BC35-G&BC28 CoAP Application Note Notify the TE to Respond the Request from CoAP Server URC Format: +QCOAPURC: 'req',[,,],,,[,,][,,''[,...]][,,] Notify the TE to respond the request from CoAP server. Parameter The CoAP server IP address, which will be present with setting AT+QCOAPCFG='Showra',1. The CoAP server port, which will be present with setting AT+QCOAPCFG='Showra',1. The message type of CoAP Protocol. Range: 0-3. Refer to the RFC 7252. 0 CON 1 NON 2 ACK 3 RST The method of CoAP Protocol. Refer to the RFC 7252. 1 GET 2 POST 3 PUT 4 DELETE The CoAP message ID. Indicates the existence of token, option, and data. Hexadecimal format. Bit 0: The existence of token. Bit 1-6: The count of option. Bit 7: The existence of data. The token value length. The token value. Hexadecimal format. The option name. The option value. The data length. The max length is 1024. Unit: byte. If the is 12, and the is 0 'text-plain', 41 'application/xml' or 50 'application/json', the data format will be text string, otherwise, the format will be hexadecimal. BC35-G&BC28_CoAP_Application_Note 20 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 4 Summary of Error Codes This chapter summarizes the error codes related to BC35-G and BC28 modules. The error codes listed in the following two tables are compliant with the 3GPP specifications. Please refer to 3GPP TS 27.007 V13.5.0, sub-clause 9.2 for all possible values. Table 3: General Errors (27.007) Code of 3 4 23 30 50 51 52 159 Description Operation not allowed Operation not supported Memory failure No network service Incorrect parameters Command implemented but currently disabled Command aborted by user Uplink busy/flow control Table 4: General Errors (27.005) Code of 300 301 302 303 304 Description ME failure SMS service of ME reserved Operation not allowed Operation not supported Invalid PDU mode parameter BC35-G&BC28_CoAP_Application_Note 21 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 305 Invalid text mode parameter 310 USIM not inserted 311 USIM PIN required 312 PH-USIM PIN required 313 USIM failure 314 USIM busy 315 USIM wrong 316 USIM PUK required 317 USIM PIN2 required 318 USIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network service 332 Network timeout 340 No +CNMA acknowledgement expected 500 Unknown error NOTE AT+CMEE= command disables (=0) or enables (=1) the use of final result code '+CME ERROR:'. When =1, a limited set of error codes will be returned. Please refer to Quectel_BC35-G&BC28&BC95 R2.0_AT_Commands_Manual for details of this command. BC35-G&BC28_CoAP_Application_Note 22 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 5 Examples 5.1. Send CoAP Request to the CoAP Server AT+CGATT? +CGATT: 1 OK //Query the PS service attach status. //Attached to the PS service. AT+QCOAPCREATE=56830 OK //Create the CoAP context. AT+QCOAPSEND=0,1,5.39.83.206,5683 OK //Send GET request in CON type to the server. AT+QCOAPDATASTATUS? +QCOAPDATASTATUS: 1 //Query the data sending status. //Sent, waiting response from IoT platform. OK //Received response URC. The response code is 2.05, the message ID is 6685, and the data length is 25 bytes. The data is in hexadecimal format. +QCOAPURC: 'rsp',2,2.05,6685,25,4E692048616F2066726F6D20436F41502E4E455420524643 AT+QCOAPDATASTATUS? +QCOAPDATASTATUS: 4 //Query the data sending status. //Success. OK AT+QCOAPHEAD=3,5566 OK //Configure the message ID to 5566 and the token is not needed. AT+QCOAPSEND=0,1,139.196.187.107,5683 > OK //Send GET request in CON type to the server. //Type 'Ctrl+Z', payload is none. //Received response URC. The response code is 2.05, the message ID is 5566 (the message ID is the BC35-G&BC28_CoAP_Application_Note 23 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note same as the set ID), and the data length is 25 bytes. The data is in hexadecimal format. +QCOAPURC: 'rsp',2,2.05,5566,29,4E692048616F2066726F6D20436F41502E4E455420524643 AT+QCOAPOPTION=1,11,'rd' OK //Configure the CoAP option, the Uri-Path is '/rd'. AT+QCOAPSEND=0,1,139.196.187.107,5683 > OK //Send GET request in CON type to the server. //Type 'Ctrl+Z', payload is none. //Received response URC. The response code is 2.05, the message ID is 61441, and the data length is 17 bytes. The data is in hexadecimal format. +QCOAPURC:'req',2,2.05,61441,17,323031382F312F392031313A31313A3139 AT+QCOAPHEAD=5,6677,4,30323436 OK //Configure the message ID to 6677 and the token value to 30323436. AT+QCOAPOPTION=1,11,'hello' OK //Configure the CoAP option, the Uri-Path is '/hello'. AT+QCOAPSEND=0,1,139.196.187.107,5683 > OK //Send GET request in CON type to the server. //Type 'Ctrl+Z', payload is none. //Received response URC. The response code is 2.05, the message ID is 6677, and the data length is 22 bytes. The data is in hexadecimal format. +QCOAPURC:'rsp',2,2.05,6677,22,68656C6C6F20776F72642066726F6D20736572766572 //Set to display the IP address and port. When receiving the URC, the IP address and port will be shown. AT+QCOAPCFG='Showra',1 OK AT+QCOAPADDRES=4,'/t/d' OK //Add the CoAP resource, the value is '/t/d'. //Configure the value of CoAP option 11 (Uri-Path) to 't' and 'r', the value of CoAP option 15 (Uri-Query) to 'ep=863703030822519'. AT+QCOAPOPTION=3,11,'t',11,'r',15,'ep=863703030822519' OK AT+QCOAPSEND=0,2, 139.196.187.107,5683 // Send POST request in CON type to the server. > //Type 'Ctrl+Z', payload is none. OK BC35-G&BC28_CoAP_Application_Note 24 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note //Received response URC from the server 180.101.147.115:5683. The type is ACK, the response code is 2.04, and the message ID is 6677. +QCOAPURC:'rsp',180.101.147.115,5683,2,2.04,2802 //Received request URC from the server 180.101.147.115:5683. The message type is CON, the method is GET, the message ID is 50670, and the is 09 (meaning the option count is 4 and the token and option exists). +QCOAPURC:'req',180.101.147.115,5683,0,1,50670,09,8,1A84BFE989C01C08,6,'0',7,'54321',11,'t ',11,'d' //When receiving the request data, the client should respond it. AT+QCOAPHEAD=5,50670,8,1A84BFE989C01C08 //Configure the message ID and token values. OK AT+QCOAPSEND=1,205,139.196.187.107,5683 > OK //Send message with response code of 2.05 in NON type to the server. //Type 'Ctrl+Z', payload is none AT+QCOAPDEL OK //Delete the CoAP context. 5.2. Register to China Telecom IoT Platform AT+QCOAPCREATE=56830 OK //Create a CoAP context AT+QCOAPHEAD=1 OK //Generate the message ID and the token value randomly. //Configure the value of CoAP option 11 (Uri-Path) to 'rd', the value of CoAP option 12 to '42' and the value of CoAP option 15 (Uri-Query) to 'lwm2m=1.0' and 'ep=867725030002525;460041850403693'… AT+QCOAPOPTION=6,11,'rd',12,'42',15,'lwm2m=1.0',15,'ep=867725030002525;46004185040369 3',15,'b=U',15,'lt=86400' OK AT+QCOAPADDRES=6,'/4/0/2' //Add the CoAP resource, the value is '/4/0/2' OK AT+QCOAPADDRES=6,'/4/0/3' //Add the CoAP resource, the value is '/4/0/3' OK BC35-G&BC28_CoAP_Application_Note 25 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note AT+QCOAPADDRES=6,'/4/0/8' //Add the CoAP resource, the value is '/4/0/8' OK AT+QCOAPADDRES=6,'/3/0/9' //Add the CoAP resource, the value is '/3/0/9' OK AT+QCOAPADDRES=6,'/3/0/7' OK //Add the CoAP resource, the value is '/3/0/7' AT+QCOAPADDRES=7,'/19/0/0' //Add the CoAP resource, the value is '/19/0/0' OK AT+QCOAPADDRES=7,'/19/1/0' //Add the CoAP resource, the value is '/19/1/0' OK //Send register message to China Telecom IoT Platform AT+QCOAPSEND=0,2,180.101.147.115,5683 >3c2f3e3b72743d226f6d612e6c776d326d222c3c2f312f303e2c3c2f332f303e2c3c2f342f303e2c3c2f3 52f303e2c3c2f32302f303e2c3c2f31392f303e OK //Received response URC. The message type is ACK, the response code is 2.01, and the message ID is 55018. +QCOAPURC: 'rsp',2,2.01,55018 //Received request URC. The message type is CON, the method is GET, the message ID is 62084, and the is 09 (meaning the option count is 4 and the token and option exists). +QCOAPURC: 'req',0,1,62084,09,8,1A98EB114F501C07,6,'0',11,'19',11,'0',11,'0' //When receiving the request data, the client should respond it. //Configure the CoAP token the same as the request message AT+QCOAPHEAD=5,62084,8,1A98EB114F501C07 //Configure the message ID to 62084 and the token value to 1A98EB114F501C07. OK AT+QCOAPSEND=2,205,180.101.147.115, 5683 > OK //Send message with response code 2.05 in ACK type to the server. //Type 'Ctrl+Z', payload is none. AT+QCOAPDEL OK //Delete the CoAP context. BC35-G&BC28_CoAP_Application_Note 26 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note 5.3. Example of using the configure commands AT+QCOAPCREATE=56830 OK //Create a CoAP context AT+QCOAPCFG='Showrspopt',1 OK //Configure to show the CoAP option of sender //Configure the value of CoAP option 11 (Uri-Path) to 'rd', the value of CoAP option 12 to '40' and the value of CoAP option 15 (Uri-Query) to 'ep= I@#@G7pjZBAQUoVav0yXQcQ6v4Ad1nFGX cKhnTWYJt3AE0TpZSj3xDrYMOm6NmohixF@#@M100000089', 'b=U' and 'lt=2700'. AT+QCOAPOPTION=5,11,'rd',12,'40',15,'ep=I@#@G7pjZBAQUoVav0yXQcQ6v4Ad1nFGXcKhnT WYJt3AE0TpZSj3xDrYMOm6NmohixF@#@M100000089',15,'b=U',15,'lt=2700' OK AT+QCOAPSEND=0,2,220.180.239.212,8063 >3c2f3e3b72743d226f6d612e6c776d326d222c3c2f30 OK AT+QCOAPDATASTATUS? +QCOAPDATASTATUS: 4 //Query the data sending status. //Success OK //Received response URC. The values of option 8 (location-path) are 'rd' and 'BEHJvP29Lb'. +QCOAPURC: 'rsp',2,2.01,13357,2,8,'rd',8,'BEHJvP29Lb' //Set to display the IP address and port of sender. When receiving the URC, the IP address and port will be shown. AT+QCOAPCFG='Showra',1 OK AT+QCOAPOPTION=5,11,'rd',12,'40',15,'ep=I@#@G7pjZBAQUoVav0yXQcQ6v4Ad1nFGXcKhnT WYJt3AE0TpZSj3xDrYMOm6NmohixF@#@M100000089',15,'b=U',15,'lt=2700' OK AT+QCOAPSEND=0,2,220.180.239.212,8063 >3c2f3e3b72743d226f6d612e6c776d326d222c3c2f30 OK //Send POST request in CON type to the server. //Type the payload and 'Ctrl+Z' to send. //Received response URC. The values of option 8 (location-path) are 'rd' and 'dTuzhqieJe', the CoAP server IP address is 220.180.239.212 and the port is 8063. BC35-G&BC28_CoAP_Application_Note 27 / 28 NB-IoT Module Series BC35-G&BC28 CoAP Application Note +QCOAPURC: 'rsp',220.180.239.212,8063,2,2.01,13358,2,8,'rd',8,'dTuzhqieJe' //Set not to display the CoAP option. When receiving the URC, the CoAP option will not be shown. AT+QCOAPCFG='Showrspopt',0 OK //Set not to display the IP address and port. When receiving the URC, the IP address and port will not be shown. AT+QCOAPCFG='Showra',0 OK //Configure the value of CoAP option 11 (Uri-Path) to 'hello' and the value of CoAP option 15 (Uri-Query) to 'name=aaaa'. AT+QCOAPOPTION=2,11,'hello',15,'name=aaaa' OK AT+QCOAPSEND=0,1,220.180.239.212,8098 > OK //Send GET request in CON type to the server. //Type 'Ctrl+Z', payload is none. //Received response URC. The content format is '0', and the data format is text string. +QCOAPURC: 'rsp',2,2.05,54750,1,12,'0',41, hi name=aaaa,this is quectel IoT platform AT+QCOAPDEL OK //Delete the CoAP context. BC35-G&BC28_CoAP_Application_Note 28 / 28

BC35-G&BC28&BC95 R2.0 注意事项及常见问题 NB-IoT 模块系列 版本：BC35-G&BC28&BC95 R2.0_注意事项及常见问题_V1.2 日期：2019-11-15 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0 注意事项及常见问题 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 文档历史 修订记录 版本 1.0 1.1 1.2 日期 2019-01-09 2019-09-04 2019-11-15 作者 王成钧/ 鲁义文 王成钧 王成钧/ 刘强 变更表述 初始版本 1. 新 增 终 端 模 块 长 期 运 行 （ 章 节 2.11 ） 和 模 块 的 Connect/Idle/PSM 状态的切换（章节 2.12）内容； 2. 新增常见问题解答 15~18（章节 3）； 3. 新增参考文档及术语缩写章节（章节 4）。 1. 更新模块 PSM 状态下被唤醒内容（章节 2.4）； 2. 新增运营商自注册功能内容（章节 2.5）； 3. 更新 Connect/Idle/DRX/eDRX/PSM 状态说明（章节 2.13）； 4. 新增常见问题 19~21 及解答（章节 3）。 上海移远通信技术股份有限公司 2 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 图片索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 2 重要注意事项.......................................................................................................................................... 7 2.1. 错误代码 .................................................................................................................................. 7 2.2. 模块波特率特性 ....................................................................................................................... 7 2.3. 模块 LwM2M 功能 Lifetime 参数............................................................................................ 10 2.4. 模块在 PSM 状态下被唤醒 .................................................................................................... 10 2.5. 运营商自注册功能.................................................................................................................. 11 2.6. 模块注册中国电信物联网开放平台 ........................................................................................ 12 2.7. 模块 IMEI 与 SN 号 ................................................................................................................ 12 2.8. AT+CFUN 命令 ......................................................................................................................12 2.9. AT+CGDCONT 命令.............................................................................................................. 12 2.10. 模块附着网络 ......................................................................................................................... 13 2.11. UDP/TCP 连接的创建............................................................................................................ 14 2.12. 终端模块需长期运行 .............................................................................................................. 14 2.13. 模块 Modem 与核心网通信的工作状态.................................................................................. 15 2.13.1. Connect 状态....................................................................................................................15 2.13.2. Idle、DRX 和 eDRX 状态 ................................................................................................. 16 2.13.2.1. Idle 状态 ..................................................................................................................16 2.13.2.2. DRX 状态 ................................................................................................................ 16 2.13.2.3. eDRX 状态 .............................................................................................................. 16 2.13.3. PSM 状态..........................................................................................................................17 3 常见问题解答........................................................................................................................................ 18 4 附录 A 参考文档及术语缩写................................................................................................................. 21 上海移远通信技术股份有限公司 3 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 表格索引 表 1：BC35-G&BC28&BC95 R2.0 模块波特率范围参考数据表.......................................................................... 9 表 2：AT+NSOCR 命令参数.............................................................................................................................. 14 表 3：参考文档 .................................................................................................................................................. 21 表 4：术语缩写 .................................................................................................................................................. 21 上海移远通信技术股份有限公司 4 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 图片索引 图 1：MODEM 的工作状态切换......................................................................................................................... 15 图 2：串口电平匹配电路.................................................................................................................................... 19 上海移远通信技术股份有限公司 5 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 1 引言 本文档主要介绍在使用移远通信 BC35-G、BC28 和 BC95 R2.0 模块过程中的重要注意事项及常见问 题答疑。 备注 本文档中提及的 AT 命令，若无另外备注，详情请参考文档 [1]。 上海移远通信技术股份有限公司 6 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 2 重要注意事项 2.1. 错误代码 通过 AT+CMEE=1 命令设置报告错误代码后，当出现错误时，模块可能会返回+CME ERROR: 523 或 +CME ERROR: 50（未设置 AT+CMEE=1 情况下，只会返回 ERROR）两种错误。错误的根本原因为：  +CME ERROR: 523 模块检测到其串口 RXD 引脚上有不符合串口帧格式的电平；  +CME ERROR: 50 模块应用层检测到 AT 命令参数不合法。 以下两种情况可能会导致上述错误的发生： 1) 模块串口 RXD 引脚工作时波形不稳定。 解决方案： 建议排查系统的供电电压，确保系统供电稳定。 2) 设备 MCU 的串口波特率范围与模块的串口波特率范围不完全吻合。 解决方案： 建议参考 AT+NATSPEED 命令，选择适合串口的及参数值进行适配。 2.2. 模块波特率特性 BC35-G、BC28 和 BC95 R2.0 模块主串口波特率在 9600bps 和 4800bps 时，上下限范围如表 1 所示。 外部 MCU 选型时，请注意 MCU 的串口波特率不能超出模块主串口波特率的允许范围，否则会引起通讯异 常。使用时请参考 AT+NATSPEED 命令，选择适合串口的及参数值进行适配。 //波特率参数修改例程 AT+NATSPEED? +NATSPEED:9600,2,1,0,0 //查询模块当前使用的波特率参数 OK AT+NATSPEED=57600,30,1,2,1,0,0 OK //修改波特率参数为 57600，超时时间 timeout=30s 上海移远通信技术股份有限公司 7 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 //在 timeout 超时时间内，将 MCU 波特率切换到 57600 并发出 AT 命令（若在超时时间内，模块没有接收 到新波特率发出的 AT 命令，模块将自动恢复到原始波特率）。 AT+NATSPEED? +NATSPEED:57600,2,1,0,0 //查询模块更新后的波特率参数 OK 上海移远通信技术股份有限公司 8 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 表 1：BC35-G&BC28&BC95 R2.0 模块波特率范围参考数据表 同步 波特率 停止位 模式 1 0 2 1 1 2 9600 1 2 2 1 3 2 1 0 2 1 4800 1 2 1 2 2 最小值 (bps) 9210 9210 9210 9210 9500 9500 9560 9560 4610 4610 4550 4550 4610 4610 25°C 最大值 (bps) 误差 (%) 负 正 9610 -4.06% 0.10% 9800 -4.06% 2.08% 9610 -4.06% 0.10% 9740 -4.06% 1.46% 9870 -1.04% 2.81% 10060 -1.04% 4.79% 9870 -0.42% 2.81% 10200 -0.42% 6.25% 4930 -3.96% 2.71% 5000 -3.96% 4.17% 4870 -5.21% 1.46% 5000 -5.21% 4.17% 4930 -3.96% 2.71% 5100 -3.96% 6.25% 最小值 (bps) 9210 -40°C 最大值 (bps) 误差 (%) 负 正 9610 -4.06% 0.10% 9210 9800 -4.06% 2.08% 9210 9610 -4.06% 0.10% 9210 9740 -4.06% 1.46% 9500 9870 -1.04% 2.81% 9500 10060 -1.04% 4.79% 9560 9870 -0.42% 2.81% 9560 10200 -0.42% 6.25% 4610 4930 -3.96% 2.71% 4610 5000 -3.96% 4.17% 4610 4930 -3.96% 2.71% 4610 5000 -3.96% 4.17% 4610 4930 -3.96% 2.71% 4610 5000 -3.96% 4.17% 最小值 (bps) 9210 9210 9210 9210 9500 9500 9560 9560 4610 4610 4550 4550 4610 4610 80°C 最大值 (bps) 误差 (%) 负 正 9610 -4.06% 0.10% 9800 -4.06% 2.08% 9610 -4.06% 0.10% 9740 -4.06% 1.46% 9870 -1.04% 2.81% 10060 -1.04% 4.79% 9870 -0.42% 2.81% 10200 -0.42% 6.25% 4930 -3.96% 2.71% 5000 -3.96% 4.17% 4870 -5.21% 1.46% 5000 -5.21% 4.17% 4930 -3.96% 2.71% 5100 -3.96% 6.25% 上海移远通信技术股份有限公司 9 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 2.3. 模块 LwM2M 功能 Lifetime 参数 Lifetime 是 LwM2M 协议定义的参数，云平台将 Lifetime 定义的时间作为判断终端设备是否在线的依据。 具体的判断机制各云平台策略不同，如：  中国电信物联网开放平台中，Lifetime 定时器超时之后，平台判断设备异常，但此时设备仍可以正 常发送上行数据；  中国移动 OneNET 平台中，Lifetime 定时器超时之后，平台判定设备离线，后续若设备继续发送 数据，OneNET 平台会回复 RST 消息，导致数据发送失败。 因此，终端必须在平台 Lifetime 定时器超时之前上报 update 信息，以更新 Lifetime 定时器。 针对不同的云平台，模块的机制为：  对于中国电信物联网开放平台，基线版本 V150R100C20B300SP5（可通过 AT+CGMR 命令查询） 之前的模块注册上中国电信物联网开放平台时，默认携带的 Lifetime 时间为 24H（24 小时），模 块 会 在 24H*0.9=21.6H 的 时 候 自 动 上 报 update 更 新 消 息 至 中 国 电 信 物 联 网 开 放 平 台 。 V150R100C20B500 基 线 版 本 及 之 后 的 版 本 默 认 关 闭 了 lifetime 自 动 更 新 功 能 。 V150R100C20B300SP5 基线版本及之后的版本，模块新增了 AT+QCFG='LWM2M/Lifetime'命 令，该命令可以配置的参数。  针对中国移动 OneNET 平台，模块在注册 OneNET 平台时，需要设备的 MCU 在 AT+MIPLOPEN 命令中携带参数。在 OneNET 平台 Lifetime 定时器超时之前，设备的 MCU 需要通过 AT+MIPLUPDATE 命令来上报 update 更新消息至 OneNET 平台。 备注 AT+MIPLOPEN 和 AT+MIPLUPDATE 命令的详细信息，请参考文档 [2]。 2.4. 模块在 PSM 状态下被唤醒 模块处于 PSM 状态时，可以直接被 AT 串口或者模块内部定时器直接唤醒，并发送数据到网络。如下 情况，模块会在 PSM 状态下被唤醒：  终端的 MCU 有上行数据发送，通过 AT 串口发送数据给模块。  3GPP 协议的跟踪区域更新（TAU）上报。包括周期性更新、区域码变化更新和链路异常更新等。 上海移远通信技术股份有限公司 10 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题  终端的 MCU 发送 CON 类型的数据时，因长时间没有收到云平台的 ACK 应答，CON 数据重传导 致模块在 PSM 状态下被唤醒。  因使用 LwM2M 协议，需要上报 update 消息来更新 Lifetime 时间导致模块在 PSM 状态下被唤醒。  因运营商的自注册功能，模块会重发或者周期性发送自注册信息导致模块在 PSM 状态下被唤醒。  模块进入无网环境，PLMN_SEARCH 定时器超时后搜网导致模块在 PSM 状态下被唤醒。  模块连接电信物联网平台失败后会每间隔 1 小时重新附着网络并注册平台而导致模块在 PSM 状态 下被唤醒。 2.5. 运营商自注册功能 遵照运营商的入库测试需求，模块集成了国内三大运营商的自注册功能。该功能运行机制如下：  电信自注册 模块第一次开机或模块版本号变更或机卡匹配关系变化时，需向运营商自注册服务器发送注册数 据包。若自注册成功，则无需周期性发送自注册数据；若自注册失败（最多重发三次，间隔 30 秒） 则会重试 2 次，间隔 1 小时（其中每次重试最多会重发三次，间隔 30 秒），该过程会导致模块退 出 PSM 状态。自注册服务器地址采用域名模式，若域名解析失败，则可能导致模块退出 PSM 状 态。  联通自注册 模块第一次开机或模块版本号变更或机卡匹配关系变化时，需向运营商自注册服务器发送注册数 据包。若自注册成功，则需每隔一个月（27~30 天之间的某个随机时间点）周期性重发更新注册 请求；若自注册失败（最多重发三次，间隔 30 秒）则会重试 2 次，间隔 1 小时（其中每次重试最 多会重发三次，间隔 30 秒），该过程会导致模块退出 PSM 状态。  移动 DM 自注册 模块每次开机入网后都会向 DM 注册服务器发送注册数据包。若 DM 注册成功，则默认周期性地 每 24 小时执行一次更新操作，更新时发送更新注册包会导致模块退出 PSM 状态；若 DM 注册失 败（最多重发 4 次，间隔依次默认为 2 秒、4 秒、8 秒、16 秒，总超时时间 62 秒）则 24 小时之 后再重新注册。DM 自注册服务器地址采用域名模式，若域名解析失败则可能会导致模块退出 PSM 状态。 模块支持关闭以上运营商自注册功能，运营商自注册功能是否需要关闭，请与对应的运营商确认。具 体关闭命令请与移远技术支持联系。 上海移远通信技术股份有限公司 11 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 2.6. 模块注册中国电信物联网开放平台 BC35-G、BC28 和 BC95 R2.0 模块通过 LwM2M 协议注册到中国电信物联网开放平台。 1. 模块默认配置为附着网络后自动注册，注册成功后会输出+QLWEVTIND:0 和+QLWEVTIND:3 信 息（可以通过 AT+QREGSWT 命令来设置模块是否自动注册到平台）。 2. 当 模 块 通 过 AT+QREGSWT=0 被 配 置 为 手 动 注 册 到 电 信 物 联 网 开 放 平 台 时 ， 可 以 通 过 AT+QLWSREGIND=0 命 令 来 触 发 注 册 ， 或 者 直 接 使 用 发 送 数 据 的 命 令 AT+NMGS 、 AT+QLWULDATA 或 AT+QLWULDATAEX 来触发注册。 3. 当模块采取手动注册电信物联网开放平台，并以发数据命令 AT+NMGS、AT+QLWULDATA 或 AT+QLWULDATAEX 触发注册时，第一条命令会立即返回+CME ERROR: 513，数据会被丢弃， 同时模块内部触发注册流程。 4. 当模块通过 AT+QREGSWT=2 命令被配置为禁止注册到电信物联网开放平台时，与电信物联网开 放平台相关的命令将不可用。 5. AT+NNMI 命令的默认值是 1，即收到数据后立即提示并将数据输出到串口。 2.7. 模块 IMEI 与 SN 号 BC35-G、BC28 和 BC95 R2.0 模块出厂时均已经写入 IMEI 号和 SN 号且无法修改。 2.8. AT+CFUN 命令 该命令主要是用来控制模块的协议核和射频功能块的开启与关闭。开启时请注意需要确认 USIM 卡已 经成功插入卡槽。执行开启命令 AT+CFUN=1，模块初始化协议核与射频相关功能，但此时模块不会发起 附着网络的行为，初始化完成后，需要执行 AT+CGATT=1 命令来触发模块发起网络附着行为。 2.9. AT+CGDCONT 命令 该命令可以用来配置模块 PDP 相关参数，例如 IP 指定分组数据协议的类型（IPv4/IPv6）、网络接入点 名称 APN 等。当=0 时，配置的相关参数可以被保存，为其他值时配置的相关参数将不会被保 存。已保存的=0 时对应的参数可以通过 AT+CGDCONT?命令读取。 上海移远通信技术股份有限公司 12 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 网络下发的 APN 值可以通过 AT+CGCONTRDP 命令读取。 2.10. 模块附着网络 对于全频段模块 BC35-G 和 BC28 第一次搜寻网络，模块会按照默认的 Band 顺序（+NBAND: 5,8,3,28,20,1）进行网络搜寻。当模块成功识别有效小区后，模块就会保存网络的频点，下次模块会优先以 已保存的频点入网，入网时间大约在 7~15 秒左右（覆盖等级 ECL=0 时）。 //采取自动入网的方式 AT+NCONFIG=AUTOCONNECT,TRUE [2018-12-02_12:47:41:254]REBOOT_CAUSE_APPLICATION_AT [2018-12-02_12:47:41:286]Neul [2018-12-02_12:47:41:286]OK //模块重启 [2018-12-02_12:47:41:749]AT+CEREG=1 [2018-12-02_12:47:41:780] [2018-12-02_12:47:41:781]OK [2018-12-02_12:47:48:452]+CEREG:1 //网络附着成功 [2018-12-02_12:47:48:612] [2018-12-02_12:48:00:033]AT+CGPADDR [2018-12-02_12:48:00:049]+CGPADDR:0,100.67.2.201 [2018-12-02_12:48:00:065]OK [2018-12-02_12:55:37:848]AT+NUESTATS [2018-12-02_12:55:37:864]Signal power:-809 //网络信号的实际 RSRP=-80.9 [2018-12-02_12:55:37:880]Total power:-735 //网络信号的 RSSI=-73.5 [2018-12-02_12:55:37:896]TX power:70 //模块的射频发送功率 7dBm [2018-12-02_12:55:37:912]TX time:719 //射频的持续发送时间，单位：毫秒 [2018-12-02_12:55:37:928]RX time:24786 //射频的持续接收时间，单位：毫秒 [2018-12-02_12:55:37:944]Cell ID:137262770 //小区基站 ID，需要转为十六进制 [2018-12-02_12:55:37:960]ECL:0 //当前的网络覆盖等级 ECL=0 [2018-12-02_12:55:37:960]SNR:234 //网络信号的实际 SNR=23.4 dB [2018-12-02_12:55:37:976]EARFCN:3734 //当前服务小区的频点 [2018-12-02_12:55:37:992]PCI:105 //当前服务小区的物理小区标识 [2018-12-02_12:55:37:992]RSRQ:-109 //网络的 RSRQ=-10.9 [2018-12-02_12:55:38:008]OPERATOR MODE:4 //当前网络的部署模式 [2018-12-02_12:55:38:024]CURRENT BAND:8 //当前网络的 Band [2018-12-02_12:55:38:040]OK 上海移远通信技术股份有限公司 13 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 2.11. UDP/TCP 连接的创建 需要建立 Socket 才可通过 UDP/TCP 发送数据，所以发送数据前需创建 Socket。可以通过执行 AT+NSOCR=,,[,][,[,]] 命令来 创建 Socket。参数解释如下： 表 2：AT+NSOCR 命令参数 参数 描述 Socket 类型。支持 DGRAM（UDP）和 STREAM（TCP）。 标准互联网协议定义。UDP 协议对应的该参数值为 17，TCP 协议对应的该参数值 为 6。 本地端口号。B300SP2 基线版本及其之后版本建议将该参数设为 0，即模块内部自 动随机分配。 该参数值为 1 表示接收到消息后有提示信息；该参数值为 0 表示接收到消息后没有 提示信息。参数默认值为 1。 连接的网络类型。'AF_INET' 表示 IPv4，'AF_INET6' 表示 IPv6。 网络分配给模块的 IP 地址。一般多路 PDN 的时候会使用。 AT+NSOCR 命令创建时返回的值不是固定值，是模块根据内部资源情况动态分配的值。终 端的 MCU 不能使用固定的，需要动态解析模块返回的值。 2.12. 终端模块需长期运行 若模块长期处于供电状态，为保证模块的有效通讯，建议每隔一个月对终端/模块执行一次重启。以保 证终端在最佳状态下运行。 上海移远通信技术股份有限公司 14 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 2.13. 模块 Modem 与核心网通信的工作状态 模块 Modem 与核心网通信时，包含 Connect、Idle 和 PSM 状态，状态的切换如下图所示。 上电开机 搜索小区，之后 RRC连接建立 无数据交互 RRC连接释放 Periodic-TAU 活跃时间 深度睡眠 T X Connect DRX周期 Idle PSM DRX T3324 T3412 RRC 连接建立， AT+NSOST 发送数据 T X PSM Connect Idle PSM T Idle A U 无数据交互 上电开机 搜索小区，之后 RRC连接建立 RRC连接释放 Periodic-TAU 活跃时间 深度睡眠 T X Connect DRX周期 Idle PSM eDRX T3324 T3412 RRC连接建立， AT+NSOST 发送数据 T X PSM Connect Idle PSM T Idle A U eDRX_value (eDRX周期) DRX周期 PTW 寻呼时间窗口 图 1：Modem 的工作状态切换 2.13.1. Connect 状态 模块搜索小区，建立 RRC 连接后，Modem 处于 Connect 状态。此状态下，模块可以发送和接收数据， 无数据交互超过一段时间（由基站设置，模块无法进行配置）后，Modem 会进入 Idle 状态。 上海移远通信技术股份有限公司 15 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 2.13.2. Idle、DRX 和 eDRX 状态 2.13.2.1.Idle 状态 Modem 处于 Idle 状态时模块可收发数据，在收发数据时 Modem 会回到 Connect 状态；在 Idle 状态下 无数据交互且 T3324 定时器超时后，则会进入 PSM 状态。 Idle 状态下可通过 AT+CEDRXS 命令开启或关闭 eDRX，来决定应用 DRX 或 eDRX。关闭 eDRX 则 会默认应用 DRX。 2.13.2.2.DRX 状态 DRX 为模块 Modem 的工作状态。 为节省功耗，模块于每个 DRX 周期监听一次寻呼信道，以检查是否有下行业务到达。如上图，当 Modem 进入 Idle 状态，在 T3324 时间内，模块处于 DRX 寻呼状态。通常 DRX 周期比较短，在这段时间内，若 IoT 平台有下行数据，模块接收数据的时延相对较小。 备注 1. 常见的 DRX 周期为 1.28 秒和 2.56 秒。 2. DRX 周期由网络决定，模块不可配置。 2.13.2.3.eDRX 状态 eDRX 为模块 Modem 的工作状态。 eDRX 是 3GPP Rel.13 引入的技术，eDRX 相比 DRX 具有更长的寻呼周期，使得终端能够更好的节省 功耗，但是也会导致更长的下行数据延时。模块只能在 PTW 内按 DRX 周期监听寻呼信道，以便接收下行 业务；PTW 外的时间不监听寻呼信道、不能接收下行业务。 备注 1. 常见的 eDRX 周期为 20.48 秒或 81.92 秒。 2. AT+CEDRXS 命令可以配置 eDRX 周期，但是最终由网络决定是否接受配置。 上海移远通信技术股份有限公司 16 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 2.13.3. PSM 状态 PSM 为模块 Modem 的工作状态。此模式下终端关闭收发信号机，不监听无线侧的寻呼，模块无法收 到下行数据。 其原理是允许 Modem 在 Idle 状态一段时间（T3324）后，关闭信号的收发和 AS（接入层）相关功能， 从而减少天线、射频、信令处理等的功耗消耗。模块在 PSM 期间，不接收任何网络寻呼、并将关闭连网活 动，包括搜寻小区消息、小区重选等；对于网络侧来说，模块不再接收下行数据，此时模块是下行不可达 的。 备注 AT+CPSMS 命令可以配置是否使能 PSM，但是最终由网络决定是否接受配置。 上海移远通信技术股份有限公司 17 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 3 常见问题解答 1) Q： 如何通过 AT 命令查看 T3324 和 T3412 的值？ A： 设置 AT+CEREG=4 或者 AT+CEREG=5 时，通过 AT+CEREG?命令可以查询 T3324 和 extended T3412 的值；T3412 的值暂不支持 AT 命令方式查询。 2) Q： AUTOCONNECT 为 TRUE 时，模块开机输出 Neul rnOKrn 后，为什么不能立即执行 AT+CFUN=0 命令？ A： 不建议模块开机后立即执行 AT+CFUN=0 命令。因为 AUTOCONNECT 为 TRUE 时，模块上 电后会立即执行入网相关的初始化，此时执行 AT+CFUN=0 命令可能会打乱模块入网初始化 流程。若需要执行 AT+CFUN=0，建议延迟 2s 后再执行。 3) Q： 模块上电开机入网与 PSM 状态下唤醒入网是否有差异？ A： 有差异。模块开机入网，首先需要搜寻最优有效小区，找到小区之后，模块向核心网发送附 着注册鉴权请求，鉴权成功之后才可以发送应用数据；模块 PSM 状态下唤醒入网，因模块进 入 PSM 之前已经成功注册了核心网，所以此时只要找到最优有效的小区就可以发送应用数据。 4) Q： 模块与中国电信物联网开放平台交互时，数据下行的缓存区是多大？缓存机制是什么？ A： 下行缓存区总大小为 1024 字节，每包数据不能超过 512 字节；最大缓存数据包数不能超过 8 包数据，否则会丢弃最早接收到的数据。 5) Q： 模块 UDP/TCP 的下行缓存区为多大？ A： UDP/TCP 应用数据缓存区大小为 1700 字节。缓存的数据结构为数据头加应用数据，数据头 占用 36 字节空间。例如，服务器一次性下发 1628 字节数据（分成两包)，可以完全被模块缓 存下来。最大缓存数据包条数不超过 10 条，否则会丢弃当前（最近一次收到的）数据包。 6) Q： 模块是否支持空中写号功能？ A： 支持。 7) Q： 针对全频段模块，使用时是否需要指定 Band 值？ A： 建议指定 Band 值，终端可根据使用的 USIM 卡来设定 Band，例如通过识别 AT+CIMI 的返回 值来区别不同的运营商，从而设置运营商对应的 Band 频段。 8) Q： 如何开启模块 3GPP R14 特性功能？ A： 模块默认支持的是 3GPP R13 特性， 可通过配置命令 AT+NCONFIG=RELEASE_VERSIO N,14 开启模块的 3GPP R14 特性。 9) Q： 如何判定模块 UDP/TCP 数据是被缓存在底层 buffer 还是已被成功发送出去？ A： UDP/TCP 发送数据的命令均允许携带参数，当携带参数后，数据 上海移远通信技术股份有限公司 18 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 是否发送成功会通过 URC +NSOSTR:,,来提示。对于 UDP 则表示数据成功发送到基站或者发送失败；对于 TCP 则表示数据成功发送到 TCP 服务器或 者发送失败。另外，模块支持通过 AT+NQSOS 查询当前模块底层缓存中的数据。 10) Q： PSM 模式下，MAIN_RXD 是什么状态？ A： 浮空输入状态。 11) Q： PSM 模式下，模块串口与 MCU 串口如何匹配？ A： 1. PSM 模式下，MCU_TXD 不能悬空，建议预留 2MΩ 电阻上拉到 VDD_EXT； 2. 若 VDD_EXT < VCC ≤ 3.6V，建议将模块 RXD 上拉电阻更改成 20kΩ，直连 MCU 的电 阻更改成肖特基二极管（阴极指向 MCU_TXD），以减少 PSM 漏电；若 VCC < VDD_EXT 或 VCC > 3.6V，则建议使用额外的电平转换电路； 3. 如 VCC > VDD_EXT，PSM 模式下，MCU_RXD 建议配置成浮空输入（输入上拉或者 下拉都容易造成漏电）； 4. 串口电平不匹配或模块 RXD 悬空，都容易造成 PSM 功耗偏高，请严格按照推荐电路进 行设计； 5. 可参考下图推荐电路匹配模块与 MCU 串口。 VDD_EXT Module R1 2MΩ RXD 1K R2 TXD 1K R3 RI 1K R4 GND MCU TXD RXD EINT GND VBAT RESET VBAT GND TXD RXD RESET TEST POINTS Voltage level: VCC 图 2：串口电平匹配电路 12) Q： BC35-G、BC28 和 BC95 R2.0 支持的 USIM 卡电压是多少？ A： 1.8V 和 3.0V 都支持，模块会自动识别 USIM 卡电压。 13) Q： BC35-G、BC28 和 BC95 R2.0 支持的 LTE Cat NB2 频段分别是多少？ A： BC35-G 支持的频段为 B1、B3、B8、B5、B20、B28； BC28 支持的频段为 B1、B3、B8、B5、B20、B28； BC95 R2.0 为单频模块，有两个型号，BC95-B8 R2.0 和 BC95-B5 R2.0，分别支持 B8 和 B5。 上海移远通信技术股份有限公司 19 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 14) Q： 模块是否支持 NETLIGHT 功能？ A： 支持 NETLIGHT 功能，默认设置为关闭。若需要 NETLIGHT 功能，可使用 AT+QLEDMODE=1 打开此功能。 15) Q： 为什么拔掉模块的 USIM 卡，通过 AT+CIMI 命令还能查询的到 IMSI 号？ A： 模块初始化 USIM 之后，会将 USIM 中的 IMSI、ICCID 数据读到模块的 RAM 中，当 USIM 被移除时，查询到的信息实际是模块 RAM 中缓存的数据。 16) Q： 模块是否支持 USIM 热插拔功能？ A： 不支持。 17) Q： 模块检测 USIM 是否被移除的逻辑是什么？ A： 在 Connect 状态（+CSCON:0,1）时，模块会每隔 30s 去检查一次 USIM 是否正常；刚进入 Idle 状态时，30s 之内可检查 USIM 是否被移除；进入 Idle 状态超过 30s 后，模块不再进行 USIM 的检查。下一次发送数据的时候会再次出发检查机制。 18) Q： 连接私有服务器时，是选择 UDP 协议还是选择 TCP 协议？ A： 推荐使用 UDP 协议，因为 NB-IoT 网络具有时延高、数据小的特性，与 UDP 协议功能更适配； 如果采用 TCP 协议，TCP 协议本身有重传特性，遇到网络信号稍差的场景，可能会引发 TCP 数据的底层多次重传，导致 USIM 卡流量过度消耗，或者导致网络的堵塞。 19) Q： 开机入网时，为什么模块没有选择信号最强的小区？ A： 模块开机后将按照一定的逻辑搜索小区，并在其第一个找到的且满足小区选择条件（即满足 S 准则）的小区上驻留；因此不一定选择到信号最强的小区。 20) Q： 模块为什么没有重选到最好的小区？ A： 模块并非无条件的选择信号最好的小区，为了避免在两个信号接近的小区之间产生乒乓效应， 模块仅在两个小区之间信号差值达到一定门限，并且持续一定时间时才会触发小区重选；具 体的门限差值由网络下发，各个小区配置的可能不同。因此模块在小区之间信号差值不大的 时候，不一定会发生重选。 21) Q： 创建 Socket 后发送 TCP 数据，随后关闭这个 Socket，再用同样的端口号创建，为什么会创 建失败？ A： TCP 协议中，正常关闭 Socket 之后，会有一个 120 秒的链路保护时间。在这个保护时间内 以相同的端口号再次创建 Socket，可能会失败。 上海移远通信技术股份有限公司 20 / 22 BC35-G&BC28&BC95 R2.0 注意事项及常见问题 4 附录 A 参考文档及术语缩写 表 3：参考文档 序号 文档名称 [1] Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册 [2] Quectel_BC35-G&BC28&BC95 R2.0_OneNET_应用指导 [3] Quectel_BC35-G_硬件设计手册 备注 BC35-G、BC28 和 BC95 R2.0 模块 的 AT 命令手册。 BC35-G、BC28 和 BC95 R2.0 模块 OneNET 平台应用指导。 BC35-G 模块硬件设计手册 [4] Quectel_BC28_硬件设计手册 BC28 模块硬件设计手册 [5] Quectel_BC95_R2.0_硬件设计手册 BC95 R2.0 模块硬件设计手册 表 4：术语缩写 术语 APN ECL DRX eDRX IMEI IPv4 IPv6 LPWA LwM2M NB-IoT 英文解释 Access Point Name Enhanced Coverage Level Discontinuous Reception Extended Discontinuous Reception International Mobile Equipment Identity Internet Protocol Version 4 Internet Protocol Version 6 Low-Power Wide Area Lightweight M2M (Protocol) Narrowband Internet of Things 中文解释 接入点名称 覆盖增强等级 不连续接收 扩展不连续接收 国际移动设备身份码 互联网协议版本 4 互联网协议版本 6 低功耗广域网 轻量级物联网（协议） 窄带物联网 上海移远通信技术股份有限公司 21 / 22 PDN PDP PSM PTW SN TAU UART USB USIM BC35-G&BC28&BC95 R2.0 注意事项及常见问题 Public Data Network 公共数据网络 Packet Data Protocol 分组数据协议 Power Saving Mode 省电模式 Paging Time Window 寻呼时间窗口 Serial Number 序列号 Tracking Area Update 追踪区域更新 Universal Asynchronous Receiver-Transmitter 通用异步收发传输器 Universal Serial Bus 通用串行总线 Universal Subscriber Identity Module 全球用户身份模块 上海移远通信技术股份有限公司 22 / 22

LTE Standard UAC 应用指导 LTE Standard 模块系列 版本：LTE_Standard_UAC _应用指导_V1.0 日期：2019-10-24 状态：受控文件 www.quectel.com LTE Standard UAC 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 15 文档历史 修订记录 版本 1.0 日期 2019-10-24 作者 陈结兵 /汪嘉 变更表述 初始版本 LTE Standard UAC 应用指导 上海移远通信技术股份有限公司 2 / 15 LTE Standard UAC 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 概述 ....................................................................................................................................................... 7 3 AT 命令详解 .......................................................................................................................................... 8 4 操作步骤 .............................................................................................................................................. 10 4.1. UAC 功能的操作步骤 ............................................................................................................... 10 4.2. 在上位机使用 UAC 功能........................................................................................................... 12 4.2.1. 在 Windows 设备上使用 UAC 功能 ............................................................................... 12 4.2.2. 在 Linux 设备上使用 UAC 功能 ..................................................................................... 12 5 附录 A 参考文档和术语缩写 .............................................................................................................. 15 上海移远通信技术股份有限公司 3 / 15 LTE Standard UAC 应用指导 表格索引 表 1：参考文档 .................................................................................................................................................... 6 表 1：参考文档 .................................................................................................................................................. 15 表 2：术语和缩写............................................................................................................................................... 15 上海移远通信技术股份有限公司 4 / 15 LTE Standard UAC 应用指导 图片索引 图 1：UAC 功能的语音流 .................................................................................................................................... 7 图 2：UAC 功能的操作步骤................................................................................................................................11 上海移远通信技术股份有限公司 5 / 15 LTE Standard UAC 应用指导 1 引言 本文档主要介绍 LTE Standard 系列模块关于 UAC 功能的一般操作流程。适用模块如下： 表 1：参考文档 LTE Standard 模块系列 EC2x：EC25、EC21、EC20 R2.0、EC20 R2.1 EG2x-G：EG25-G、EG21-G EG9x：EG91、EG95 EP200F 上海移远通信技术股份有限公司 6 / 15 LTE Standard UAC 应用指导 2 概述 UAC 功能的语音流如下图所示。 UAC（USB Audio Class）是 USB 规范中的音频协议类。在 UAC 模式下，模块被识别为主机设备中的 USB 声卡，并且 'AC 接口'设备出现在主机设备管理器中。标准的第三方音频库（如 alsa-lib）可用于在 Linux 设备（主机设备）上运行音频应用程序，某些第三方工具也可用于在 Windows 设备上播放/记录应用 程序。 在语音呼叫状态下，模块通过空中接口获取语音数据。DSP 将数据解码为语音 PCM 流，然后通过 USB 总线将 PCM 流传输到设备。因此，主机设备中的音频应用可以通过 USB 声卡获得 PCM 数据，并将语音 数据传输到扬声器。类似地，在通过设备上的麦克风记录语音之后，数据将以相反的方向传输。请注意， LTE Standard 模块的 UAC 功能仅支持单声道，PCM 数据必须设置为 8KHz 的采样率和 16 位线性格式。 天线 RF LTE Standard 模块 DSP/BB 设备 USB Slave PCM 8KHz, 16bit, Mono USB Bus USB Host Sound Card (USB Audio Driver) SPK MIC Aud io App lication 图 1：UAC 功能的语音流 上海移远通信技术股份有限公司 7 / 15 LTE Standard UAC 应用指导 3 AT 命令详解 LTE Standard 模块支持 AT+QPCMV 命令启用/禁用 UAC 功能。启用该功能后，拨打电话时，来自对 方的语音数据将被模块解码为 PCM 数据，然后通过已设置的 USB 端口输出到设备。同时，设备将 PCM 数据写入端口，数据将通过网络传输到呼叫设备的另一端。当呼叫结束时，没有任何数据要输出，输入的 数据无效。输出和输入的 PCM 数据必须设置为 8KHz 的采样率和 16 位线性格式。 AT+QPCMV 测试命令 AT+QPCMV=? 启用/禁用 UAC 功能 响应 +QPCMV: (0,1),(0-2) 查询命令 AT+QPCMV? OK 响应 +QPCMV: [,] 设置命令 AT+QPCMV=[,] URC OK 响应 OK 或者 ERROR +QPCMV: 0 或者 +QPCMV: 1 参数 启用/禁用 UAC 功能 1 启用 0 禁用 配置 PCM 数据传输的端口或者声卡 0 USB NMEA 模式，LTE Standard 模块不支持此模式。 1 Debug UART 模式，波特率为 230400bps，LTE Standard 模块不支持此模式。 2 UAC 模式，将 LTE Standard 模块作为 USB 声卡使用。 上海移远通信技术股份有限公司 8 / 15 LTE Standard UAC 应用指导 备注 1. 设置立即生效。 参数不会保存，并会在重新启动模块后恢复为默认值。 2. 如果 modem 输出+QPCMV: 0，则表示 modem 正忙，无法接收更多 PCM 数据，并停止发送 PCM 数据；如果 modem 输出 URC +QPCMV: 1，则表示 modem 已准备好接收更多 PCM 数据。 3. 在 UAC 模 式 下 ， 则 必 须 通 过 AT+QCFG='USBCFG',0x2C7C,0x0125,x,x,x,x,x,x,1 和 AT+QPCMV=1,2 命令启用 USB 音频设备。如需了解这两个命令的详细信息，可联系移远通信技术 支持。 上海移远通信技术股份有限公司 9 / 15 LTE Standard UAC 应用指导 4 操作步骤 本章介绍 LTE Standard 模块关于 UAC 功能的详细操作步骤。 4.1. UAC 功能的操作步骤 步骤 1：给模块上电，模块将自动连接到网络。 步骤 2：在 USB AT 端口上执行命令 AT+QCFG='USBCFG',0x2C7C,0x0125,x,x,x,x,x,x,1 以使能模 块上的 UAC 设备（命令中的'x'表示变量值，只能是 0 或 1）。将命令中的第七个功能参 数设置为 1 可以使能 UAC 设备，其他参数保持不变，仍为其他 USB 配置的返回 URC 的对应 值。例如，首先执行 AT+QCFG='USBCFG'对 USB 功能的设置进行检查，上报 URC '+QCFG: 'USBCFG',0x2C7C,0x0125,1,1,1,1,1,1,0'。接着执行命令 AT+QCFG='USBCFG',0x2C7 C,0x0125,1,1,1,1,1,1,1 以使能模块上的 UAC 设备。（如果客户不升级固件，则此步骤仅需执 行一次） 备注 如果 AT+QCFG='USBCFG'只有 6 个功能参数，则当前固件不支持使用 AT 命令启用 UAC 声卡设备。 步骤 3：在 USB AT 端口上执行 AT+QPCMV=1,2 以启用 UAC 功能 步骤 4：在 USB AT 端口上执行 ATD 拨打电话，或者执行 ATA 接听来电。 步骤 5：设备上的音频驱动程序每 40ms 通过 USB 声卡接收 640 字节的 PCM 数据，并立即通过 USB 将数据发送到主机。 步骤 6： 设备上的音频驱动程序通过 DSP 获取语音数据。PCM 应用程序应以 100ms 的间隔向 USB 声 卡发送 1600 字节的语音数据。 步骤 7：执行 ATH 结束通话。 步骤 8：在 USB AT 端口上执行 AT+QPCMV=0 以禁用 UAC 功能。 上海移远通信技术股份有限公司 10 / 15 LTE Standard UAC 应用指导 设备 模块 启用 UAC: AT+QCFG='Usbcfg',0x2C7C,0x0125,x,x,x,x,x,x,1 启用 UAC Voice: AT+QPCMV=1,2 (USB AT端口) OK (USB AT端口) ATD/ATA (USB AT端口) OK (USB AT端口) PCM数据 (USB Bus (USB Audio Class), 1600bytes/100ms) PCM数据 (USB Bus (USB Audio.Class), 640bytes/40ms) . . PCM数据 (USB Bus (USB Audio Class), 1600bytes/100ms) PCM数据 (USB Bus (USB Audio Class), 640bytes/40ms) ATH (USB AT端口) OK (USB AT端口) AT+QPCMV=0 (USB AT端口) OK (USB AT端口) 图 2：UAC 功能的操作步骤 上海移远通信技术股份有限公司 11 / 15 LTE Standard UAC 应用指导 4.2. 在上位机使用 UAC 功能 4.2.1. 在 Windows 设备上使用 UAC 功能 USB 声卡驱动程序（UAC 设备驱动程序）包含在 Windows 系统中。因此，当启用 USB 声卡设备并且 模块 USB 接口连接到 Windows 设备时，将在设备管理器中找到 USB 声卡设备'AC Interface'。如果设 备管理器中没有 USB 声卡设备而是带有黄色感叹号的未识别设备，则需要使用 Windows 内置驱动程序或 第三方驱动程序工具升级 USB 声卡驱动程序。客户可以像普通声卡一样使用 USB 声卡播放或录制通话的 语音数据。 4.2.2. 在 Linux 设备上使用 UAC 功能 步骤 1：添加 VID 和 PID。 为了识别模块，应将以下模块 VID 和 PID 信息添加到文件[KERNEL]/drivers/usb/serial/option.c. static const struct usb_device_id option_ids[] = { #if 1 //Added by Quectel { USB_DEVICE(0x2C7C, 0x0121) }, /* Quectel EC21 */ { USB_DEVICE(0x2C7C, 0x0125) }, /* Quectel */EG25G/EG21G/EP200F { USB_DEVICE(0x2C7C, 0x0191) }, /* Quectel EG91 */ { USB_DEVICE(0x2C7C, 0x0195) }, /* Quectel EG95 */ #endif EC25/EC20 R2.0/EC20 R2.1 此外，还应为不同的 Linux 内核版本添加以下信息。 对于比 2.6.30 更新的 Linux 内核版本，应将以下信息添加到文件[KERNEL]/drivers/usb/serial/option.c. static int option_probe(struct usb_serial *serial, const struct usb_device_id *id) { struct usb_wwan_intf_private *data; …… #if 1 //Added by Quectel //Quectel EC25&EC21&EC20 R2.0&EC20 R2.1&EG91&EG95&EG25G&EG21G&EP200F's interface 4 can be used as USB sound card device if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C) && serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4) return -ENODEV; #endif /* Store device id so we can use it during attach. */ usb_set_serial_data(serial, (void *)id); return 0; } 上海移远通信技术股份有限公司 12 / 15 LTE Standard UAC 应用指导 对于早于 2.6.31 的 Linux 内核版本，应将以下信息添加到文件[KERNEL]/drivers/usb/serial/option.c. static int option_startup(struct usb_serial *serial) { …… dbg('%s', __func__); #if 1 //Added by Quectel //Quectel EC25&EC21&EC20 R2.0&EC20 R2.1&EG91&EG95&EG25G&EG21G&EP200F's interface 4 can be used as USB sound card device if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C) && serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4) return -ENODEV; #endif …… } 有关详细信息，请参阅文档[1]。 步骤 2：使能 USB 音频功能，并重新编译 Linux 内核。 执行命令 make menuconfig，然后依次选择以下选项，在 Linux 内核 menuconfig 接口中使能用 USB 声卡功能。 [*] Device Drivers → [*] Sound card support → [*] Advanced Linux Sound Architecture → [*] USB sound devices → 上海移远通信技术股份有限公司 13 / 15 LTE Standard UAC 应用指导 接着，重新编译 Linux 内核，并重启设备。 步骤 3：使用并验证 UAC 功能。 重启客户 Linux 设备，并通过 USB 端口连接模块。然后在路径/dev/snd,中找到新的声卡设备，客户可 以通过第三方音频工具或第三方音频库像普通声卡设备一样使用该声卡设备。但 PCM 数据格式固定为 8KHz 采样率和 16 位线性。 tinyalsa 工具的源代码可以从 https://github.com/tinyalsa/tinyalsa 下载。 使用 tinyalsa 工具，分别运行以下两个命令进行播放和录制语音。命令中的'x'是客户设备的声卡 号。 语音播放： tinyplay music.wav -D x -d 0 -c 1 -r 8000 语音录制： tinycap rec.wav -D x -d 0 -c 1 -r 8000 上海移远通信技术股份有限公司 14 / 15 LTE Standard UAC 应用指导 5 附录 A 参考文档和术语缩写 表 2：参考文档 序号 [1] 文档名称 Quectel_LTE&5G_Linux_USB_Driver_ User_Guide 备注 Linux USB 驱动程序用户指南，适用于 LTE 和 5G 模块系列 表 3：术语和缩写 缩写 DSP 英文全称 Digital Signal Processing NMEA National Marine Electronics Association PCM UAC USB Pulse Code Modulation USB Audio Class Universal Serial Bus 中文全称 数字信号处理 美国国家海洋电子协会（GPS 导航设 备统一的 RTCM 标准协议） 脉冲编码调制 USB 音频类 通用串行总线 上海移远通信技术股份有限公司 15 / 15

BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 LPWA 模块系列 版本：BC35-G&BC28&BC95 R2.0_Lifetime 参数设置指导_V1.0 日期：2019-02-27 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 文档历史 修订记录 版本 1.0 日期 2019-02-27 作者 陆晓程 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 图片索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 使用 AT 命令设置模块 Lifetime 参数 ................................................................................................... 6 2.1. AT+QCFG='LWM2M/Lifetime' 设置电信物联网平台注册生命周期 ........................................ 6 3 通过平台设置模块 Lifetime 参数 .......................................................................................................... 8 3.1. 修改平台 Profile 文件 ................................................................................................................. 8 3.1.1. 导出平台 Profile 文件....................................................................................................... 8 3.1.2. Profile 文件修改............................................................................................................... 9 3.1.2.1. 添加 LwM2M Server 目录及 json 文件 ................................................................. 9 3.1.2.2. 新增 LwM2M Server 特性内容 ........................................................................... 10 3.1.3. 导入 Profile 文件至平台 ..................................................................................................11 3.2. 设置 Lifetime 参数 .................................................................................................................... 12 3.2.1. 通过平台设置 Lifetime 参数值 ....................................................................................... 12 3.2.2. 使用 API 设置 Lifetime 参数值....................................................................................... 13 3.2.2.1. 典型场景 ............................................................................................................. 13 3.2.2.2. 注意事项 ............................................................................................................. 13 3.2.2.3. 接口原型 ............................................................................................................. 14 3.2.2.4. 请求示例 ............................................................................................................. 14 3.2.2.5. 响应码................................................................................................................. 15 4 附录 ..................................................................................................................................................... 17 4.1. servicetype-capability.json ....................................................................................................... 17 4.2. devicetype-capability.json ........................................................................................................ 17 上海移远通信技术股份有限公司 3 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 图片索引 图 1：导出已有的 PROFILE 文件 ........................................................................................................................ 8 图 2：添加 LWM2M SERVER 目录及 JSON 文件 ............................................................................................... 9 图 3：添加 LWM2M SERVER 特性内容 ............................................................................................................ 10 图 4：导入 PROFILE ..........................................................................................................................................11 图 5：上传 PROFILE ..........................................................................................................................................11 图 6：打开'设备影子'页签 ................................................................................................................................. 12 图 7：设置 LIFETIME 参数值............................................................................................................................. 13 上海移远通信技术股份有限公司 4 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 1 引言 Lifetime 是 LwM2M 协议中控制终端与服务器周期更新的参数。终端会在注册到平台时将 Lifetime 参数 在注册消息中发送给平台。 本文档主要介绍如何通过 AT 命令和电信物联网平台设置 BC35-G、BC28 和 BC95 R2.0 模块的 LwM2M Lifetime 参数。 上海移远通信技术股份有限公司 5 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 2 使用 AT 命令设置模块 Lifetime 参数 2.1. AT+QCFG='LWM2M/Lifetime' 设置电信物联网平台注册生命周期 该命令用于设置通过 LwM2M 协议连接电信物联网平台时的 Lifetime 参数值。模块的注册更新时间约 为 0.9*lifetime。目前仅支持 V150R100C20B300SP5 基准版及更高版本（可通过 AT+CGMR 命令查询版本）， 设置完成后，重启模块使设置生效。 AT+QCFG='LWM2M/Lifetime' 设置电信物联网平台注册生命周期 设置命令 AT+QCFG='LWM2M/Lifetime'[,] 响应 若命令包含设置参数值，则设置电信物联网平台注 册生命周期： OK 若命令不包含设置参数值，则查询电信物联网平台 注册生命周期： +QCFG: 'LWM2M/Lifetime', OK 最大响应时间 若出现任何错误，响应： ERROR 或 +CME ERROR: 300ms Parameter 整数型参数：设置模块的 LwM2M 协议注册生命周期。单位：秒。范围：0-30*86400。 默认值为 86400。 0 关闭 Lifetime 功能。模块将不会每隔一段时间发送升级注册包至 电信物联网开放平台。 1-30x86400 启用 Lifetime 功能。注册生命周期实际最小有效值为 900（秒）， 即使设置值为 1-899，最终生效生命周期也将为 900（秒）。.. 上海移远通信技术股份有限公司 6 / 17 举例 AT+QCFG='LWM2M/lifetime' +QCFG: 'LWM2M/Lifetime',86400 OK AT+QCFG='LWM2M/lifetime',900 OK BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 上海移远通信技术股份有限公司 7 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 3 通过平台设置模块 Lifetime 参数 在通过电信物联网开放平台设置 LwM2M Lifetime 参数值之前，需要确保平台的 Profile 文件已经包含 LwM2M Server 配置。若未包含，需按照 3.1 章节进行平台 Profile 文件修改后进行 Lifetime 参数设置；若 已经包含，请按照 3.2 章节直接进行 Lifetime 参数设置。 3.1. 修改平台 Profile 文件 3.1.1. 导出平台 Profile 文件 登录到电信物联网开放平台，选择'Profile 开发'→'Profile 在线开发'；选择要修改的 Profile。点 击进入，点击'导出该产品 Profile'。另存为当前 Profile 到本地路径。 图 1：导出已有的 Profile 文件 备注 导出的 Profile 文件为 zip 格式压缩包，可解压后修改。 上海移远通信技术股份有限公司 8 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 3.1.2. Profile 文件修改 3.1.2.1. 添加 LwM2M Server 目录及 json 文件 在产品 Profile 根目录（例如，下图中的 Smoke_010F_0C02-1002）下的 service 目录下新建 LwM2M Serverprofile 目录，然后新建 servicetype-capability.json 文件，文件内容如下： 图 2：添加 LwM2M Server 目录及 json 文件 备注 servicetype-capability.json 文本内容详见 4.1 章节。 上海移远通信技术股份有限公司 9 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 3.1.2.2. 新增 LwM2M Server 特性内容 修改根目录下 profile 目录下的 devicetype-capability.json 文件，添加如下图红框中 LwM2M Server 特 性内容： 图 3：添加 LwM2M Server 特性内容 备注 devicetype-capability.json 文本内容详见 4.2 章节。 上海移远通信技术股份有限公司 10 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 3.1.3. 导入 Profile 文件至平台 如上两个文件修改完成后，将整个 Profile 打包成 zip 格式压缩包，作为待导入的新 Profile 文件。登录 到电信物联网开放平台，选择'Profile 开发'→'Profile 导入'，单击'导入'按钮，打开导入 Profile 的上传文件对话框。 图 4：导入 Profile 在打开的对话框点击'点击选择文件'选择修改过后的 Profile 文件。点击上传，覆盖之前的 Profile 文 件，如下图所示。 上海移远通信技术股份有限公司 图 5：上传 Profile 11 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 3.2. 设置 Lifetime 参数 3.2.1. 通过平台设置 Lifetime 参数值 1. 登录到'中国电信物联网开放平台-连接管理子系统'，选择'设备'，找到对应的设备，打开'设 备影子'页签。如下图所示: 图 6：打开'设备影子'页签 2. 在'设备影子'中，单击'属性配置'，打开属性配置对话框，设置 Lifetime 属性值，单击'保存'， 下发设置 Lifetime 命令。 备注 点击保存后，平台缓存设置 Lifetime 命令，等待下次模块上报数据时下发设置命令到模块。 上海移远通信技术股份有限公司 12 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 图 7：设置 Lifetime 参数值 3.2.2. 使用 API 设置 Lifetime 参数值 3.2.2.1. 典型场景 从应用设置设备影子的时候，需调用 API。设置设备影子属性，需要向应用服务器提供设置设备的配置 或状态数据（desired 属性）信息。 3.2.2.2. 注意事项 应用已鉴权后，在 header 中携带参数 app_key 和 Authorization: Bearer {accessToken} 上海移远通信技术股份有限公司 13 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 3.2.2.3. 接口原型 1. 接口 请求方法 请求地址 传输协议 PUT https://server:port/iocm/app/shadow/v1.5.0/devices/{deviceId}?appId={appId} HTTPS 2. 请求参数 名称 Authorization 必选/可选 必选 类型 String 位置 header app_key 必选 deviceId 必选 appId 可选 serviceDesireds 可选 String String String List header path query Body 说明 请求的认证信息，值为'Bearer ******'，其中******为 Auth 鉴权 接口返回的 accessToken 已鉴权应用的 appId 设备 ID 授权应用 ID 需要设置的配置或状态 3. ServiceDesiredDTO 名称 desired serviceId 必选/可选 必选 必选 类型 ObjectNode String(1-256) 说明 设备的服务属性配置 设备中的服务标识 ID 3.2.2.4. 请求示例 ObjectNode json 格式体，填写的是设备服务中属性值，格式为：'属性名字':'属性的值' 以下对应 3 个属性名称的属性值： 'desired': { 'UTC Offset':'+2:00', 'pmin':'10', 上海移远通信技术股份有限公司 14 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 'pmax':'30' } PUT /iocm/app/shadow/v1.5.0/devices/{deviceId}?appId={appId} HTTP/1..1 Host: server:port Content-Type: application/json Authorization: '******' app_key: '******' { 'serviceDesireds' : [ { 'desired' : :{'UTC Offset':'+2:00','pmin':'10','pmax':'30'} 'serviceId' : ' Device' } ] } 响应示例： Status Code: 200 OK Lifetime 设置示例： { 'serviceDesireds':[{ 'desired':{ 'Lifetime':null }, 'serviceId': 'LWM2M Server' }] } 3.2.2.5. 响应码 HTTP 状态码 200 200 400 400 403 错误码 100425 100431 107002 107003 100203 说明 The special deviceCapability is not exist. The serviceType is not exist. The properties is empty in database. The request properties is unknown. The application is not existed. 上海移远通信技术股份有限公司 15 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 403 100217 The application hasn't been authorized. 403 100443 The property is forbidden to write. 404 100403 The device is not existed. 404 100418 The deviceData is not existed. 500 100023 The data in dataBase is abnomal.. 500 100203 The application is not existed. 上海移远通信技术股份有限公司 16 / 17 BC35-G&BC28&BC95 R2.0 Lifetime 参数设置指导 4 附录 4.1. servicetype-capability.json { 'services': [ { 'serviceType': 'LWM2M Server', 'description': 'LWM2M Server', 'commands': null, 'properties': [ { 'propertyName': 'Lifetime', 'dataType': 'int', 'required': true, 'min': 900, 'max': 2592000, 'step': 1, 'maxLength': 256, 'method': 'RW', 'unit': 'L', 'enumList': null } ] } ] } 4.2. devicetype-capability.json { 'serviceId': 'LWM2M Server', 'serviceType': 'LWM2M Server', 'option': 'Mandatory' } 上海移远通信技术股份有限公司 17 / 17

BC35-G&BC28&BC95 R2.0 OneNET 应用指导 NB-IoT 模块系列 版本：BC35-G&BC28&BC95 R2.0_OneNET_应用指导_V1.0 日期：2019-12-04 状态：受控版本 www.quectel.com BC35-G&BC28&BC95 R2.0 OneNET 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供此文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对此文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载此文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 文档历史 修订记录 版本 1.0 日期 2019-12-04 作者 唐正/ 江文珍 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格 ............................................................................................................................................................... 5 1 引言 ........................................................................................................................................................ 6 2 OneNET 数据交互机制 ..........................................................................................................................7 3 OneNET 相关 AT 命令...........................................................................................................................8 3.1. AT 命令语法.................................................................................................................................8 3.2. OneNET 相关 AT 命令详解 ......................................................................................................... 8 3.2.1. AT+MIPLCONFIG OneNET 接入配置 ........................................................................... 8 3.2.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 ......................................................... 11 3.2.3. AT+MIPLDELETE 删除 OneNET 通信套件实例.......................................................... 11 3.2.4. AT+MIPLVER 查询 OneNET SDK 版本....................................................................... 12 3.2.5. AT+MIPLADDOBJ 添加 LwM2M 对象 ......................................................................... 12 3.2.6. AT+MIPLDELOBJ 删除 LwM2M 对象.......................................................................... 13 3.2.7. AT+MIPLOPEN 发送注册请求..................................................................................... 13 3.2.8. AT+MIPLCLOSE 发送注销请求................................................................................... 14 3.2.9. AT+MIPLDISCOVERRSP 响应资源发现请求 ............................................................. 15 3.2.10. AT+MIPLOBSERVERSP 响应订阅请求 ...................................................................... 16 3.2.11. AT+MIPLREADRSP 响应读请求 ................................................................................. 17 3.2.12. AT+MIPLWRITERSP 响应写请求................................................................................ 18 3.2.13. AT+MIPLEXECUTERSP 响应执行请求 ...................................................................... 19 3.2.14. AT+MIPLPARAMETERRSP 响应写属性请求.............................................................. 20 3.2.15. AT+MIPLNOTIFY 上报数据 ......................................................................................... 21 3.2.16. AT+MIPLUPDATE 发送更新请求................................................................................. 23 3.2.17. AT+MIPLRD 读取缓存数据.......................................................................................... 24 3.2.18. AT+QSOTAINFO 配置软件升级信息 ........................................................................... 25 3.2.19. AT+QSOTARESULT 设置软件升级操作结果 .............................................................. 25 4 OneNET 相关 URC ..............................................................................................................................27 4.1. +MIPLDISCOVER 通知 TE 响应资源发现请求的 URC.......................................................... 27 4.2. +MIPLOBSERVE 通知 TE 响应订阅请求的 URC................................................................... 28 4.3. +MIPLREAD 通知 TE 响应读请求的 URC.............................................................................. 28 4.4. +MIPLWRITE 通知 TE 响应写请求的 URC ............................................................................ 29 4.5. +MIPLEXECUTE 通知 TE 响应执行请求的 URC ................................................................... 30 4.6. +MIPLPARAMETER 通知 TE 响应写属性请求的 URC .......................................................... 31 4.7. +MIPLEVENT 向 TE 通知事件的 URC ................................................................................... 31 5 举例 ...................................................................................................................................................... 33 5.1. 接入配置 .................................................................................................................................... 33 5.2. 注册和资源发现操作..................................................................................................................34 5.2.1. 注册和资源发现操作（平台端关闭自动订阅）............................................................... 34 上海移远通信技术股份有限公司 3 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5.2.2. 注册和资源发现操作（平台端开启自动订阅）............................................................... 35 5.2.3. 注册和资源发现操作（平台开启自动订阅，开启鉴权连接和 DTLS 模式）................... 36 5.3. 读操作........................................................................................................................................39 5.3.1. 读资源.............................................................................................................................39 5.3.2. 读实例.............................................................................................................................39 5.3.3. 读对象.............................................................................................................................39 5.4. 写操作........................................................................................................................................40 5.4.1. 写资源.............................................................................................................................40 5.4.2. 写实例.............................................................................................................................40 5.5. 执行操作 .................................................................................................................................... 41 5.6. 写属性操作 ................................................................................................................................ 41 5.7. 订阅操作 .................................................................................................................................... 42 5.8. 上报数据操作.............................................................................................................................42 5.8.1. 上报资源数据..................................................................................................................42 5.8.2. 上报实例数据..................................................................................................................42 5.8.3. 上报对象数据..................................................................................................................43 5.8.4. 使用 CON 消息上报资源数据 ......................................................................................... 43 5.8.5. 使用 CON 消息上报资源数据并携带 RAI 标记 ............................................................... 44 5.8.6. 使用 CON 消息上报实例数据 ......................................................................................... 44 5.8.7. 使用 CON 消息上报实例数据并携带 RAI 标记 ............................................................... 45 5.9. 更新操作 .................................................................................................................................... 45 5.9.1. 无 RAI 标志的更新操作................................................................................................... 45 5.9.2. 有 RAI 标志的更新操作................................................................................................... 46 5.10. 下行数据缓存.............................................................................................................................46 5.11. SOTA 实例.................................................................................................................................48 6 错误码 .................................................................................................................................................. 50 7 附录 A 参考文档与术语缩写................................................................................................................ 52 上海移远通信技术股份有限公司 4 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 表格 表 1：AT 命令类型及其响应................................................................................................................................. 8 表 2：ONENET 相关 URC................................................................................................................................. 27 表 3：一般错误(27.007)..................................................................................................................................... 50 表 4：一般错误(27.005)..................................................................................................................................... 50 表 5：参考文档 .................................................................................................................................................. 52 表 6：术语缩写 .................................................................................................................................................. 52 上海移远通信技术股份有限公司 5 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 1 引言 LwM2M 是一种安全、高效且可扩展的客户端-服务器协议，适用于多种网络环境下资源受限的设备管 理。LwM2M 采用基于 REST 的现代化架构设计，定义了一种可扩展的资源和数据模型，重用并基于 CoAP 高效安全的数据传输标准协议建立。基于 CoAP（RFC 7252）的设备服务的简述，LwM2M 定义了一个简 单的对象模型和一组设备管理的接口和操作。 本文档介绍如何将应用了移远通信 BC35-G、BC28 和 BC95 R2.0 系列模块的设备，通过 AT 命令、基 于 LwM2M 协议连接到中国移动物联网开放平台（中国移动 OneNET 平台，以下简称'OneNET'）。 备注 1. 本文档适用于固件版本号以'_ONT'结尾的 BC35-G、BC28 和 BC95 R2.0 系列模块； 2. 自动响应资源发现功能（请参考第 3.2.9 章）、下行数据缓存功能（请参考第 3.2.17 章）和 SOTA 功能（请参考第 3.2.18 章 和第 3.2.19 章）仅部分 Band 8 的单频段版本支持，请查阅对应模块固件 的《软件版本变更说明》确认支持情况。 上海移远通信技术股份有限公司 6 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 2 OneNET 数据交互机制 本章讲述终端、模块、OneNET 平台和应用服务器之间的数据交互机制。 终端设备 模块 OneNET 平台 应用服务器 AT+CGATT? AT+MIPLCREATE AT+MIPLADDOBJ=... AT+MIPLOPEN=... URC: +MIPLEVENT: ... 10秒 URC: +MIPLDISCOVER: ... 超时 AT+MIPLDISCOVERRSP=... 10秒 URC: +MIPLPARAMETER: ... 超时 AT+MIPLPARAMETERRSP=... 10秒 URC: +MIPLOBSERVE: ... 超时 AT+MIPLOBSERVERSP=... 10秒 URC: +MIPLREAD: ... 超时 AT+MIPLREADRSP=... 10秒 URC: +MIPLWRITE: ... 超时 AT+MIPLWRITERSP=... 10秒 URC: +MIPLEXECUTE: ... 超时 AT+MIPLEXECUTERSP=... AT+MIPLNOTIFY=... URC: +MIPLEVENT: ... AT+MIPLUPDATE=... URC: +MIPLEVENT: ... AT+MIPLCLOSE= URC: +MIPLEVENT: ... AT+MIPLDELOBJ=... AT+MIPLDELETE= 发送注册请求 响应 发送资源发现请求 响应 发送写属性请求 响应 发送订阅请求 响应 发送读请求 响应 发送写请求 响应 发送执行请求 响应 数据上报 响应 发送更新请求 响应 发送注销请求 响应 发送资源发现请求 响应 发送写属性请求 响应 发送订阅请求 响应 发送读请求 响应 发送写请求 响应 发送执行请求 响应 数据上报 响应 注册 操作 资源 发现 操作 写属 性 操作 订阅 操作 读 操作 写 操作 执行 操作 上报 操作 更新 操作 注销 操作 图 1: OneNET 数据交互示意图 上海移远通信技术股份有限公司 7 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 3 OneNET 相关 AT 命令 本章节讲述与 OneNET 接入和操作相关的 AT 命令。相关 值，请参考第 6 章。 3.1. AT 命令语法 表 1：AT 命令类型及其响应 测试命令 查询命令 设置命令 执行命令 AT+=? 返回相应设置命令可设置的参数清单或取值范围。 AT+? 返回相应设置命令参数的当前设置值。 AT+= 设置用户可自定义的参数值。 AT+ 执行无需设置参数值的命令。 备注 AT 命令参数说明中，添加下划线的参数值为默认值。 3.2. OneNET 相关 AT 命令详解 3.2.1. AT+MIPLCONFIG OneNET 接入配置 此命令用于配置引导模式和引导服务器地址、接入服务器地址、自动响应订阅、鉴权功能、DTLS 功能 和 写 操 作 输 出 格 式 等 。 也 可 以 设 置 CoAP 协 议 中 的 ACK_TIMEOUT 参 数 。 CoAP 协 议 中 的 MAX_TRANSMIT_WAIT 通过公式 ACK_TIMEOUT * ((2(4+1)) - 1) 计算。若未设置 ACK_TIMEOUT，则使 用默认值。 AT+MIPLCONFIG OneNET 接入配置 测试命令 AT+MIPLCONFIG=? 响应 +MIPLCONFIG: ,[,] 上海移远通信技术股份有限公司 8 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 查询命令 AT+MIPLCONFIG? OK 响应 +MIPLCONFIG:,, +MIPLCONFIG:, +MIPLCONFIG:, +MIPLCONFIG:, +MIPLCONFIG:, +MIPLCONFIG:, +MIPLCONFIG:,, OK 若有任何错误： ERROR 或 +CME ERROR: 设置命令 AT+MIPLCONFIG=,[,] 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 参数 整型。模式选项。 0 关闭引导模式，并配置接入服务器 IP 地址和端口号。 1 开启引导模式，并配置引导服务器 IP 地址和端口号。默认的引导服务器 IP 地 址为 183.230.40.39，端口号为 5683。 2 设置 CoAP 协议的 ACK_TIMEOUT 参数，ACK_TIMEOUT 的默认值是 2 秒。 3 设置是否启用自动响应订阅请求。 4 设置是否使能鉴权接入并配置鉴权码。 5 设置是否启用 DTLS 模式并配置 PSK。 6 设置接收写数据的输出格式。 参数 、 和 的对应情况如下： 0 1 上海移远通信技术股份有限公司 9 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 2 1 3 4 [] 5 [] 6 7 当 =0，此参数为接入服务器 IP 地址。 当 =1，此参数为引导服务器 IP 地址。 当 =0，此参数为接入服务器端口号。 当 =1，此参数为引导服务器端口号。 整型。ACK_TIMEOUT 的值。范围 2-20。单位：秒。默认值：2。 整型。是否启用模块自动响应订阅请求。 0 禁用自动响应，由终端设备通过命令 AT+MIPLOBSERVERSP 响应订阅请求 1 启用自动响应，终端设备不需要响应订阅请求 整型。是否启用鉴权连接。 0 禁用鉴权连接 1 启用鉴权连接 双引号标示的字符串类型。鉴权码。最大长度：16 字节。 整型。DTLS 模式开关。 0 禁用 DTLS 模式。 1 启用 DTLS 模式。 双引号标示的字符串类型。预共享密钥。最大长度：16 字节。 整型。接收写操作数据的输出模式。 0 十六进制字符串显示 1 字符串显示 整型。下行数据缓存配置。 0 不缓存下行数据 1 仅缓存下行写操作数据 2 仅缓存下行执行操作数据 3 同时缓存下行写操作和执行操作数据 整型。是否启用下行数据缓存指示。 0 禁用下行数据缓存指示 1 启用下行数据缓存指示，在数据缓存区为空时收到下行数据缓存时会通过 URC '+MIPLEVENT:'指示。 备注 1. 需要在通过 AT+MIPLCREATE 命令创建通信实例之前使用此命令； 2. 开启 DTLS 模式时需要配置正确的 IP 地址和端口号。 上海移远通信技术股份有限公司 10 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 3.2.2. AT+MIPLCREATE 创建 OneNET 通信套件实例 此命令用于创建一个 OneNET 通信套件实例。 AT+MIPLCREATE 创建 OneNET 通信套件实例 执行命令 AT+MIPLCREATE 响应 +MIPLCREATE: OK 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 3.2.3. AT+MIPLDELETE 删除 OneNET 通信套件实例 此命令用于删除 OneNET 通信套件实例。 AT+MIPLDELETE 删除 OneNET 通信套件实例 测试命令 AT+MIPLDELETE=? 响应 +MIPLDELETE: 设置命令 AT+MIPLDELETE= OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: 3秒 参数配置立即生效，掉电后不保存 上海移远通信技术股份有限公司 11 / 53 参数 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 OneNET 通信套件实例 ID。 3.2.4. AT+MIPLVER 查询 OneNET SDK 版本 此命令用于查询 OneNET SDK 版本。 AT+MIPLVER 查询 OneNET SDK 版本 查询命令 AT+MIPLVER? 响应 +MIPLVER: 最大响应时间 OK 300 毫秒 参数 当前 OneNET SDK 版本。 3.2.5. AT+MIPLADDOBJ 添加 LwM2M 对象 此命令用于添加 LwM2M 对象。 AT+MIPLADDOBJ 添加 LwM2M 对象 测试命令 AT+MIPLADDOBJ=? 响应 +MIPLADDOBJ: ,,,, , 设置命令 AT+MIPLADDOBJ=,,,,, OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 上海移远通信技术股份有限公司 12 / 53 参数 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 OneNET 通信套件实例 ID。 对象 ID。如果对象 ID 不存在，模块将返回错误。 实例个数。 双 引 号 标 示 的 字 符 串 类 型 。 实 例 位 图 。 例 如 ， 如 果 =4 且 ='1101'，意味着 0、1 和 3 会被注册，而 2 不会被注册。 属性数量，表示可读和/或可写资源数量。 执行数量，表示可执行资源数量。 3.2.6. AT+MIPLDELOBJ 删除 LwM2M 对象 此命令用于删除 LwM2M 对象。 AT+MIPLDELOBJ 删除 LwM2M 对象 测试命令 AT+MIPLDELOBJ=? 响应 +MIPLDELOBJ: , 设置命令 AT+MIPLDELOBJ=, OK 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 对象 ID。如果 ID 不存在，模块将返回错误。 3.2.7. AT+MIPLOPEN 发送注册请求 此命令用于向 OneNET 平台发送注册请求。 AT+MIPLOPEN 发送注册请求 上海移远通信技术股份有限公司 13 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 测试命令 AT+MIPLOPEN=? 响应 +MIPLOPEN: ,[,] 设置命令 AT+MIPLOPEN=,[,] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 设备生命周期。取值范围：16-268435454。单位：秒。 注册超时时间。从连接成功（输出 URC +MIPLEVENT: 0,4）开始计时。省略时使用默 认值。取值范围：30-65535，默认值：30。单位：秒。 3.2.8. AT+MIPLCLOSE 发送注销请求 此命令用于向 OneNET 平台发送注销请求。注销请求不做重发，即平台响应与否不影响模块侧的注销 操作。 AT+MIPLCLOSE 发送注销请求 测试命令 AT+MIPLCLOSE=? 响应 +MIPLCLOSE: 设置命令 AT+MIPLCLOSE= OK 响应 OK 最大响应时间 若有任何错误： ERROR 或 +CME ERROR: 3秒 上海移远通信技术股份有限公司 14 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 参数 OneNET 通信套件实例 ID。 3.2.9. AT+MIPLDISCOVERRSP 响应资源发现请求 此命令用于响应来自 OneNET 平台或应用程序服务器的资源发现（Discover）请求。该命令允许在添 加 LwM2M 对象之后、AT+MIPLOPEN 命令之前执行，此时设置命令必须携带参数 ，且 无效。设置成功之后，在收到 对应的资源发现请求时，由模块自动响应该请求。 AT+MIPLDISCOVERRSP 响应资源发现请求 测试命令 AT+MIPLDISCOVERRSP=? 响应 +MIPLDISCOVERRSP: ,,[,, [,]] 设置命令 AT+MIPLDISCOVERRSP=,,[,,[,]] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 消息 ID。由资源发现请求 URC'+MIPLDISCOVER:'中获取。 对象 ID。 资源发现请求结果。结果码如下： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示响应正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 15 4.06 Not acceptable（未接受） 的长度，仅在 =1 时有效。 双引号标示的字符串类型。表示对象的属性，每个属性（资源 ID）由分号隔开，仅在 上海移远通信技术股份有限公司 15 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 =1 时有效，例如 '1101;1102;1103'。属性数量不应超过 AT+MIPLADDOBJ 命令中的 与 的和。 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 3.2.10. AT+MIPLOBSERVERSP 响应订阅请求 当自动响应订阅请求功能被禁用时，此命令用于响应来自 OneNET 平台或应用程序服务器的订阅 （Observe）请求。 AT+MIPLOBSERVERSP 响应订阅请求 测试命令 AT+MIPLOBSERVERSP=? 响应 +MIPLOBSERVERSP: ,,[,] 设置命令 AT+MIPLOBSERVERSP=,,[,] OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 消息 ID。由订阅请求 URC'+MIPLOBSERVE:'中获取。 订阅请求结果。结果码如下： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示响应正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 15 4.06 Not acceptable（未接受） 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 上海移远通信技术股份有限公司 16 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 0 0x200 0x400 不携带 RAI 标记 发送消息之后立即释放连接 收到消息的回复之后立即释放连接 3.2.11. AT+MIPLREADRSP 响应读请求 此命令用于响应来自 OneNET 平台或应用程序服务器的读（Read）请求。 AT+MIPLREADRSP 响应读请求 测试命令 AT+MIPLREADRSP=? 响应 +MIPLREADRSP: ,,[,,,,,,,,[,]] 设置命令 AT+MIPLREADRSP=,, [,,,,< value_type>,,,,[,]] OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 消息 ID。由读请求 URC'+MIPLREAD:'中获取。 读请求结果。结果码如下： 结果码 CoAP 响应码 描述 1 2.05 Content（内容），表示响应正确 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 15 4.06 Not acceptable（未接受） 对象 ID。仅在 =1 时有效。由读请求 URC'+MIPLREAD:'中获取。 实例 ID。仅在 =1 时有效。由读请求 URC'+MIPLREAD:'中获取。 资源 ID。仅在 =1 时有效。由读请求 URC'+MIPLREAD:'中获取。 数据 的类型。仅在 =1 时有效。 1 String（字符串型） 上海移远通信技术股份有限公司 17 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 数据 的长度。仅在 =1 时有效。单位：字节。 当 =1 时，此参数值为 字符串型数据的长度。 当 =2 时，此参数值为 十六进制字符串数据的长度。 当 =3 时，此参数值可能为 2、4 或 8。 当 =4 时，此参数值只能为 4。 当 =5 时，此参数值为 1。 数据的内容。仅在 =1 时有效。 当 =1 时，此参数值为双引号标示的字符串型格式，若无双引号标示， 字符串数据会被转化为大写后发送。 当 =2 时，此参数值为十六进制字符串格式，无需双引号标示。 当 =3 时，此参数值为整数型格式。 当 =4 时，此参数值为浮点型格式。 当 =5 时，此参数值为布尔型格式。 消息的序号，仅在 =1 时有效。若读请求响应包含多条消息，则需要分多条 AT 命令分别执行，若被分成了 N 个部分，则参数 需从 N-1 到 0 依次递减， AT 命令也按照从大到小的顺序执行。=0 表示这是数据中最后一条消息。 整型。消息的指示，仅在 =1 时有效。范围：0-2。 0 表示 中最后一条消息 1 表示 中第一条消息 2 表示 中中间的消息 当前版本仅支持 =0。 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 备注 1. 此命令用于模块响应读请求，响应数据的总长度不能大于 1024 字节。 2. 若 =2，则此十六进制数据的字符数计算方式为 2 × ；若 =4，浮 点型数据的长度建议为 4 个字节，且参数 值为 4。 3.2.12. AT+MIPLWRITERSP 响应写请求 此命令用于响应来自 OneNET 平台或应用程序服务器的写（Write）请求。 AT+MIPLWRITERSP 响应写请求 测试命令 响应 上海移远通信技术股份有限公司 18 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 AT+MIPLWRITERSP=? +MIPLWRITERSP: ,,[,] 设置命令 AT+MIPLWRITERSP=,, [,] OK 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 消息 ID。由写请求 URC'+MIPLWRITE:'中获取。 写请求的结果。结果码如下： 结果码 CoAP 响应码 描述 2 2.04 Changed（改变），表示成功处理了请求 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 3.2.13. AT+MIPLEXECUTERSP 响应执行请求 此命令用于响应来自 OneNET 平台或应用程序服务器的执行（Execute）请求。 AT+MIPLEXECUTERSP 响应执行请求 测试命令 AT+MIPLEXECUTERSP=? 响应 +MIPLEXECUTERSP: ,,[,] 设置命令 AT+MIPLEXECUTERSP=,,[,] 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 若有任何错误： ERROR 或 +CME ERROR: 300 毫秒 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 消息 ID。由执行请求 URC'+MIPLEXECUTE:'中获取。 执行请求结果。结果码如下： 结果码 CoAP 响应码 描述 2 2.04 Changed（改变），表示成功处理了请求 11 4.00 Bad request（无效请求） 12 4.01 Unauthorized（未授权） 13 4.04 Not found（未找到） 14 4.05 Method not allowed（方法不允许） 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 3.2.14. AT+MIPLPARAMETERRSP 响应写属性请求 此命令用于响应来自 OneNET 平台或应用程序服务器的写属性（Write-Attributes）请求。 AT+MIPLPARAMETERRSP 测试命令 AT+MIPLPARAMETERRSP=? 响应写属性请求 响应 +MIPLPARAMETERRSP: ,,[,] 设置命令 AT+MIPLPARAMETERRSP=,,[,] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 上海移远通信技术股份有限公司 20 / 53 最大响应时间 特性说明 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 300 毫秒 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 消息 ID。由写属性请求 URC'+MIPLPARAMETER:'中获取。 写属性请求结果。结果码如下： 结果码 CoAP 响应码 描述 2 2.04 Changed，表示成功处理了请求 11 4.00 无效请求 12 4.01 未授权 13 4.04 未找到 14 4.05 方法不允许 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 3.2.15. AT+MIPLNOTIFY 上报数据 此命令用于向 OneNET 平台或应用程序服务器上报数据。 AT+MIPLNOTIFY 上报数据 测试命令 AT+MIPLNOTIFY=? 响应 +MIPLNOTIFY: ,,,,,,,,[,[,]] 设置命令 AT+MIPLNOTIFY=,,,,,,,,,[, [,]] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 上海移远通信技术股份有限公司 21 / 53 参数 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 OneNET 通信套件实例 ID。 消息 ID。任意 32 位无符号数均可 1)。此参数无实际意义，建议设置为 0。 对象 ID，由订阅请求 URC'+MIPLOBSERVE:'中获取。 实例 ID，由订阅请求 URC'+MIPLOBSERVE:'中获取。 资源 ID，由订阅请求 URC'+MIPLOBSERVE:'中获取。 数据 的类型。 1 String（字符串型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 数据 的长度。单位：字节。 当 =1 时，此参数值为 字符串型数据的长度。 当 =2 时，此参数值为 十六进制字符串数据的长度。 当 =3 时，此参数值可能为 2、4 或 8。 当 =4 时，此参数值只能为 4。 当 =5 时，此参数值为 1。 数据的内容。 当 =1 时，此参数值为双引号标示的字符串型格式，若无双引号标示， 字符串数据会被转化为大写后发送。 当 =2 时，此参数值为十六进制字符串格式，无需双引号标示。 当 =3 时，此参数值为整数型格式。 当 =4 时，此参数值为浮点型格式。 当 =5 时，此参数值为布尔型格式。 消息的序号。若读请求响应包含多条消息，则需要分多条 AT 命令分别执行，若被分 成了 N 个部分，则参数 需从 N-1 到 0 依次递减，AT 命令也按照从大到小 的顺序执行。=0 表示这是数据中最后一条消息。 整型。消息的指示。范围：0-2。 0 表示 中最后一条消息 1 表示 中第一条消息 2 表示 中中间的消息 当前版本仅支持 =0。 确认 ID。省略时使用默认值。范围：0-65535。 0 数据以不可确认消息（NON）形式发送。 1-65535 数据以可确认消息（CON）形式发送，并通过 URC '+MIPLEVENT:' 通知发送结果。 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI；当 为非 0 时，不可设置为 0x200。 0 不携带 RAI 标记 0x200 发送消息之后立即释放连接 0x400 收到消息的回复之后立即释放连接 上海移远通信技术股份有限公司 22 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 备注 1. 1) 早期版本固件不支持使用任意消息 ID，仍需要由订阅请求 URC'+MIPLOBSERVE:'中获取对应 的 。请查阅对应模块固件版本的《软件版本变更说明》，确认支持情况。 2. 此命令用于数据上报，数据总长度不可超过 1024 个字节。 3. 若 =2，则此十六进制数据的字符数计算方式为 2 × ；若 =4，浮 点型数据的长度建议为 4 个字节，且参数 值为 4。 4. 对于多个消息组成的数据，正常发送数据时，若其中一条消息返回错误，此消息之前的消息仍将会被 发送出去。 3.2.16. AT+MIPLUPDATE 发送更新请求 此命令用于发送更新请求以更新设备生命周期和对象列表。 AT+MIPLUPDATE 测试命令 AT+MIPLUPDATE=? 发送更新请求 响应 +MIPLUPDATE: ,,[,] 设置命令 AT+MIPLUPDATE=,, [,] OK 响应 OK 若有任何错误： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 特性说明 参数配置立即生效，掉电后不保存 参数 OneNET 通信套件实例 ID。 设备生命周期。范围：0 或 16-268435454。单位：秒。0 表示生命周期是 86400 秒。 整型。是否更新对象列表。 0 不更新 1 更新 无符号整数。十六进制格式。用于指示消息传输携带的快速释放标记 RAI。 0 不携带 RAI 标记 0x400 收到消息的回复之后立即释放连接 当 非 0 时，只支持 =0x400 上海移远通信技术股份有限公司 23 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 3.2.17. AT+MIPLRD 读取缓存数据 此命令用于读取缓存的下行数据。执行命令 AT+MIPLRD 每次返回一条最早缓存的下行数据消息，返 回值含义与相应的 URC 参数意义相同，请参考第 4.4 章 和第 4.5 章。下行数据缓存区掉电不保存，且在 删除通信套件实例时会清空缓存区。 AT+MIPLRD 读取缓存数据 查询命令 AT+MIPLRD? 响应 +MIPLRD: ,,, 执行命令 AT+MIPLRD OK 响应 +MIPLWRITE: ,,,,,,,,, 或 +MIPLEXECUTE: ,,,,, , OK 最大响应时间 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数 缓存的数据消息条数。最大支持缓存 8 条消息。当下行数据条数超过最大缓存条数 时，会按序丢弃最早缓存的数据，即只缓存最新数据。 缓存的有效数据总字节数。最大支持缓存 2048 字节。当下行有效数据总字节数超 过最大缓存总字节数时，会按序丢弃最早缓存的数据，即只缓存最新数据。有效数 据是指 和 所传递的数据。 已经接收到的下行数据消息总条数。 已经丢弃的下行数据消息总条数。 上海移远通信技术股份有限公司 24 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 3.2.18. AT+QSOTAINFO 配置软件升级信息 此命令用于配置软件相关信息，例如终端软件版本号和软件包存储区大小。 AT+QSOTAINFO 配置软件升级信息 设置命令 AT+QSOTAINFO=, 查询命令 AT+QSOTAINFO? 响应 OK 若有任何错误： ERROR 或者 +CME ERROR: 响应 +QSOTAINFO: , 最大响应时间 特性说明 OK 300 毫秒 参数配置立即生效，掉电后不保存 参数 双引号标识的字符串型。终端软件版本号。最大长度为 48 字节。 32 位无符号整型。终端软件包存储区大小。单位：字节。 3.2.19. AT+QSOTARESULT 设置软件升级操作结果 此命令用于设置软件升级操作结果。 AT+QSOTARESULT 设置软件升级操作结果 设置命令 AT+QSOTARESULT= 响应 OK 最大响应时间 特性说明 若有任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，掉电后不保存 上海移远通信技术股份有限公司 25 / 53 参数 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 软件升级操作结果。 1 软件包擦除成功 2 软件包擦除失败 3 软件包写入成功 4 软件包写入失败 5 软件包校验成功 6 软件包校验失败 7 软件升级成功 8 软件升级失败 上海移远通信技术股份有限公司 26 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 4 OneNET 相关 URC 本章节介绍 OneNET 平台相关的 URC。 表 2：OneNET 相关 URC 序号 URC 描述 [1] +MIPLDISCOVER: ,, 当 OneNET 平台发送资源发现请求，模块 接收到请求后将上报此 URC。 [2] +MIPLOBSERVE: ,,,, 当 OneNET 平台或应用程序服务器发送订 , 阅请求，模块接收到请求后将上报此 URC。 [3] +MIPLREAD: ,,,, 请求，模块接收到请求后将上报此 URC。 +MIPLWRITE: ,,,,,,,,, 请求，模块接收到请求后将上报此 URC。 [5] +MIPLEXECUTE: ,,,,[,,] 行请求，模块接收到请求后将上报此 URC。 [6] +MIPLPARAMETER: ,,,,,, URC。 [7] +MIPLEVENT: ,[,][,] 当有事件需要通知终端，则上报此 URC。 4.1. +MIPLDISCOVER 通知 TE 响应资源发现请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台的资源发现请求。此 URC 完全输出以后，终端应在 10 秒内通过 AT+MIPLDISCOVERRSP 响应请求。 +MIPLDISCOVER 通知 TE 响应资源发现请求的 URC URC 格式 通知终端响应来自 OneNET 平台的资源发现请求。 +MIPLDISCOVER: ,, 上海移远通信技术股份有限公司 27 / 53 参数 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 OneNET 通信套件实例 ID。 消息 ID。 从 OneNET 接收到的资源发现请求的对象 ID。 4.2. +MIPLOBSERVE 通知 TE 响应订阅请求的 URC 此 URC 用于通知终端有来自 OneNET 平台或应用程序服务器的订阅请求。若已禁用自动响应订阅请 求功能，则终端应在此 URC 完全输出以后的 10 秒内通过 AT+MIPLOBSERVERSP 响应请求。 +MIPLOBSERVE 通知 TE 响应订阅请求的 URC URC 格式 通知终端有来自 OneNET 或应用程序服务器的订阅请求。 +MIPLOBSERVE: ,,,,, 参数 OneNET 通信套件实例 ID。 消息 ID。 表示是否订阅的标记。 0 取消订阅 1 订阅 从 OneNET 或应用服务器接收到的订阅请求对象 ID。 从 OneNET 或应用服务器接收到的订阅请求实例 ID。-1 表示订阅或者取消订阅该对象 ID 下所有实例的所有资源。 从 OneNET 或应用服务器接收到的订阅请求资源 ID。-1 表示订阅或者取消订阅该实例 下的所有资源。 4.3. +MIPLREAD 通知 TE 响应读请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台或应用程序服务器的读请求。此 URC 完全输出以后，终 端应在 10 秒内通过 AT+MIPLREADRSP 响应请求。 +MIPLREAD 通知 TE 响应读请求的 URC URC 格式： 通知终端响应来自 OneNET 平台或应用程序服务器的读请求。 +MIPLREAD: ,,, , 上海移远通信技术股份有限公司 28 / 53 参数 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 OneNET 通信套件实例 ID。 消息 ID。 从 OneNET 平台或应用程序服务器接收到的对象 ID。 从 OneNET 平台或应用程序服务器接收到的实例 ID。-1 表示读取该对象下的所有资 源。 从 OneNET 平台或应用程序服务器接收的资源 ID。-1 表示读取该实例下的所有资源。 4.4. +MIPLWRITE 通知 TE 响应写请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台或应用程序服务器的写请求。此 URC 完全输出以后，终 端应在 10 秒内通过 AT+MIPLWRITERSP 响应请求。 +MIPLWRITE 通知 TE 响应写请求的 URC URC 格式： +MIPLWRITE: ,,,,,,,,, 通知终端响应来自 OneNET 平台或应用程序服务器的写请 求。 参数 OneNET 通信套件实例 ID。 消息 ID。 从 OneNET 平台或者应用服务器接收到的写请求的对象 ID。 从 OneNET 平台或者应用服务器接收到的写请求的实例 ID。 从 OneNET 平台或者应用服务器接收到的写请求的资源 ID。 数据的类型（当前仅显示不透明型）。 1 String（字符串型） 2 Opaque（不透明型） 3 Integer（整数型） 4 Float（浮点型） 5 Boolean（布尔型） 数据的长度。单位：字节。 字符串或十六进制格式。从 OneNET 平台或应用程序服务器接收到的数据的内容。 消息的标识。范围：0-2。 0 表示 中最后一条消息 1 表示 中第一条消息 2 表示 中中间的消息 当前版本仅支持 =0。 写请求消息的序号。若数据包含多条消息，则分成多个部分；若被分成了 N 个部分， 上海移远通信技术股份有限公司 29 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 则此 URC 会按 从 N-1 到 0 依次递减的顺序排序。=0 表示这是写 请求数据中最后一条消息。 备注 应用服务器发送的写请求中 数据长度建议小于 1000 字节，否则可能会导致操作失败。 4.5. +MIPLEXECUTE 通知 TE 响应执行请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台或应用程序服务器的执行请求。此 URC 完全输出以后， 终端应在 10 秒内通过 AT+MIPLEXECUTERSP 响应请求。 +MIPLEXECUTE 通知 TE 响应执行请求的 URC URC 格式： 通知终端回复来自 OneNET 平台或应用程序服务器的执行 +MIPLEXECUTE: ,,, 请求。 ,[,,] 参数 OneNET 通信套件实例 ID。 消息 ID。 从 OneNET 平台或者应用服务器接收到的执行请求的对象 ID。 从 OneNET 平台或者应用服务器接收到的执行请求的实例 ID。 从 OneNET 平台或者应用服务器接收到的执行请求的资源 ID。 参数 的长度。单位：字节。 字符串类型。执行操作中的 Arguments 参数。 备注 来自应用程序服务器的执行操作的 长度建议小于 1000 字节，否则可能会导致操作失败。 上海移远通信技术股份有限公司 30 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 4.6. +MIPLPARAMETER 通知 TE 响应写属性请求的 URC 此 URC 用于通知终端响应来自 OneNET 平台或应用程序服务器的写属性请求。此 URC 完全输出以后， 终端应在 10 秒内通过 AT+MIPLPARAMETERRSP 响应请求。 +MIPLPARAMETER 通知 TE 响应写属性请求的 URC URC 格式： 通知终端响应来自 OneNET 平台或应用程序服务器的写属 +MIPLPARAMETER: ,,,,,, 参数 OneNET 通信套件实例 ID。 消息 ID。 从 OneNET 平台或者应用服务器接收到的写属性请求的对象 ID。 从 OneNET 平台或者应用服务器接收到的写属性请求的实例 ID。-1 表示 适用于该对象下所有资源 从 OneNET 平台或者应用服务器接收到的写属性请求的资源 ID，-1 表示 适用于该实例下所有资源。 参数 的长度。单位：字节。 字符串类型。写属性操作的参数。 4.7. +MIPLEVENT 向 TE 通知事件的 URC 此 URC 用于向终端通知事件。 +MIPLEVENT 向 TE 通知事件的 URC URC 格式： +MIPLEVENT: ,[,][,][,,] 向终端通知事件。 参数 OneNET 通信套件实例 ID。 事件代码。 1 引导开始 2 引导成功 3 引导失败 4 连接成功 上海移远通信技术股份有限公司 31 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5 连接失败 6 注册成功 7 注册失败 8 注册超时 9 生命周期超时 10 停止状态 11 更新成功 12 更新失败 13 更新操作超时 14 需要更新 15 注销成功 20 响应失败 21 响应成功 25 上报失败 26 上报成功 40 固件下载 41 固件下载失败 42 固件下载完成 43 固件升级 44 固件升级成功 45 固件升级失败 46 固件升级完成 47 固件下载中断 48 固件擦除成功 49 固件擦除失败 50 非模块固件下载触发 51 终端软件包下载 52 终端软件包下载完成 53 终端软件包擦除 54 终端软件升级成功 100 缓存模式下收到下行数据 扩展参数。 当 =20，显示响应命令的消息 ID。 当 =14，显示剩余生命周期时间，单位：秒。 整数型。确认 ID。范围：1-65535。通过 AT+MIPLNOTIFY 命令设置的 CON 信息的。 表示回复时间字符串。格式是 YYYYMMDDHHmmSS，Y 是年，M 是月， D 是日，H 是小时，m 是分钟，S 是秒。 整型。表示 OneNET 平台上是否有缓存命令。 0 没有 1 有 上海移远通信技术股份有限公司 32 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5 举例 本章节展示 OneNET 相关的 AT 命令的使用流程，所有实例都是在已经入网条件下进行的。 5.1. 接入配置 本用例展示了如何配置引导模式、引导服务器地址，以及如何配置接入服务器和 CoAP 协议的参数 ACK_TIMEOUT。 AT+MIPLCONFIG=? +MIPLCONFIG: ,[,] OK //启用引导并设置引导服务器 IP 和端口号。 AT+MIPLCONFIG=1,183.230.40.39,5683 OK AT+MIPLCONFIG? +MIPLCONFIG:1,183.230.40.39,5683 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,0 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 OK //关闭引导并设置接入服务器 IP 和端口号。 AT+MIPLCONFIG=0,183.230.40.40,5683 OK AT+MIPLCONFIG? +MIPLCONFIG:0,183.230.40.40,5683 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,0 +MIPLCONFIG:5,0 上海移远通信技术股份有限公司 33 / 53 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 OK //设置 ACK_TIMEOUT 值为 9 秒。 AT+MIPLCONFIG=2,1,9 OK AT+MIPLCONFIG? +MIPLCONFIG:0,183.230.40.40,5683 +MIPLCONFIG:2,9 +MIPLCONFIG:3,1 +MIPLCONFIG:4,0 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 OK BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5.2. 注册和资源发现操作 5.2.1. 注册和资源发现操作（平台端关闭自动订阅） 在平台端设置关闭自动订阅的情况下，下面的举例详述了注册和资源发现的操作。 //关闭引导模式，使用单个命令创建通信套件实例 AT+MIPLCREATE +MIPLCREATE: 0 //成功创建通信套件实例 OK //添加 LwM2M 对象 AT+MIPLADDOBJ=0,3311,2,'11',4,2 OK //成功添加对象，并将注册 ID 为 0 和 1 的实例 AT+MIPLOPEN=0,600,60 OK //向 OneNET 平台发送注册请求 +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 上海移远通信技术股份有限公司 34 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 +MIPLEVENT: 0,6 //注册成功 +MIPLDISCOVER: 0,26384,3311 //接收到资源发现请求 //响应资源发现请求，资源 ID 分别为：5850、5851、5706 和 5805 AT+MIPLDISCOVERRSP=0,26384,1,19,'5850;5851;5706;5805' OK //删除 LwM2M 对象. AT+MIPLDELOBJ=0,3311 OK //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //注销成功 //删除通信套件实例 AT+MIPLDELETE=0 OK //成功删除 5.2.2. 注册和资源发现操作（平台端开启自动订阅） 在平台端设置开启自动订阅的情况下，下面的举例中详述了注册以及资源发现操作。 //默认设置，用 AT 命令创建通信套件实例 AT+MIPLCONFIG? +MIPLCONFIG:1,183.230.40.39,5683 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,0 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 //开启自动响应订阅请求 OK AT+MIPLCREATE +MIPLCREATE:0 //成功创建通信套件实例 OK 上海移远通信技术股份有限公司 35 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 //添加 LwM2M 对象 AT+MIPLADDOBJ=0,3311,2,'11',4,2 OK //成功添加对象，并将注册 ID 为 0 和 1 的实例 AT+MIPLOPEN=0,600,60 OK //向 OneNET 平台发送注册请求 +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLOBSERVE: 0,78025,1,3311,0,-1 //接收到订阅（3311/0）请求 +MIPLOBSERVE: 0,143562,1,3311,1,-1 //接收到订阅（3311/1）请求 +MIPLDISCOVER: 0,12491,3311 //接收到资源发现请求 //响应资源发现请求，资源 ID 分别为：5850、5851、5706 和 5805 AT+MIPLDISCOVERRSP=0,12491,1,19,'5850;5851;5706;5805' OK //删除 LwM2M 对象. AT+MIPLDELOBJ=0,3311 OK //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //注销成功 //删除通信套件实例 AT+MIPLDELETE=0 OK //成功删除 5.2.3. 注册和资源发现操作（平台开启自动订阅，开启鉴权连接和 DTLS 模式） 本用例阐述了在平台开启自动订阅，开启鉴权连接和 DTLS 模式的情况下，如何使用 OneNET 平台的 注册和资源发现操作。 上海移远通信技术股份有限公司 36 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 //开启鉴权连接并设置鉴权码 AT+MIPLCONFIG=4,1,'Quectel123' OK //开启 DTLS 模式并设置预共享密钥 AT+MIPLCONFIG=5,1,'FhyvhmglRQrde4ln' OK //查询配置 AT+MIPLCONFIG? +MIPLCONFIG:1,183.230.40.39,5684 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,1,Quectel123 +MIPLCONFIG:5,1,FhyvhmglRQrde4ln +MIPLCONFIG:6,0 +MIPLCONFIG:7,0,1 OK AT+MIPLCREATE +MIPLCREATE:0 //成功创建通信套件 OK //添加 LwM2M 对象. AT+MIPLADDOBJ=0,3303,2,'11',4,2 OK //成功添加对象，并将注册 ID 为 0 和 1 的实例 //向 OneNET 平台发送注册信息 AT+MIPLOPEN=0,86400,60 OK +MIPLEVENT: 0,1 +MIPLEVENT: 0,2 +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //注册成功 +MIPLOBSERVE: 0,82187,1,3303,0,-1 //接收到订阅（3303/0）请求 +MIPLOBSERVE: 0,147724,1,3303,1,-1 //接收到订阅（3303/1）请求 上海移远通信技术股份有限公司 37 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 +MIPLDISCOVER: 0,16653,3303 //接收到资源发现请求 //响应资源发现请求，资源 ID 分别为：5700、5701、5601、5602、5605 AT+MIPLDISCOVERRSP=0,16653,1,24,'5700;5701;5601;5602;5605' OK //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //成功注销 //向 OneNET 平台发送注册请求 AT+MIPLOPEN=0,86400,60 OK +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 //成功注册 +MIPLOBSERVE: 0,213270,1,3303,0,-1 +MIPLOBSERVE: 0,278807,1,3303,1,-1 +MIPLDISCOVER: 0,16667,3303 //响应资源发现请求，资源 ID 分别为：5700、5701、5601、5602、5605 AT+MIPLDISCOVERRSP=0,16667,1,24,'5700;5701;5601;5602;5605' OK //删除 LwM2M 对象 AT+MIPLDELOBJ=0,3303 OK //向 OneNET 平台发送注销请求 AT+MIPLCLOSE=0 OK +MIPLEVENT: 0,15 //成功注销 //删除通信套件实例 AT+MIPLDELETE=0 OK 上海移远通信技术股份有限公司 38 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5.3. 读操作 5.3.1. 读资源 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送读资源（3311/0/5805）请求。 //接收到读资源请求 +MIPLREAD: 0,3123,3311,0,5805 //响应读请求 AT+MIPLREADRSP=0,3123,1,3311,0,5805,4,4,1.88,0,0 OK //成功发送数据 1.88 到应用程序服务器 5.3.2. 读实例 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送读实例（3311/0）请求. //接收到读实例请求 +MIPLREAD: 0,25466,3311,0,-1 //用 4 条消息响应读请求 AT+MIPLREADRSP=0,25466,1,3311,0,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,25466,1,3311,0,5805,4,4,1.88,0,0 OK 5.3.3. 读对象 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送读对象（3311）请求。 上海移远通信技术股份有限公司 39 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 //接收到读对象请求 +MIPLREAD: 0,39299,3311,-1,-1 //用 6 条消息响应读请求 AT+MIPLREADRSP=0,39299,1,3311,0,5851,5,1,1,5,0 OK AT+MIPLREADRSP=0,39299,1,3311,0,5852,3,2,123,4,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5851,5,1,1,3,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5852,3,2,123,2,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5706,1,10,'1234567890',1,0 OK AT+MIPLREADRSP=0,39299,1,3311,1,5805,4,4,1.88,0,0 OK 5.4. 写操作 5.4.1. 写资源 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 模块没有配置下行数据缓存模式。 3. 应用程序服务器或 OneNET 平台发送写资源（3311/0/5706）请求。 //接收写资源请求 +MIPLWRITE: 0,38017,3311,0,5706,2,5,68656C6C6F,0,0 //用结果码（2）响应写请求 AT+MIPLWRITERSP=0,38017,2 OK 5.4.2. 写实例 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 模块没有配置下行数据缓存模式。 3. 应用程序服务器或 OneNET 平台发送写实例（3311/0）请求。 上海移远通信技术股份有限公司 40 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 //接收写实例请求 +MIPLWRITE: 0,46584,3311,0,5706,2,5,68656C6C6F,0,2 +MIPLWRITE: 0,46584,3311,0,5850,2,1,01,0,1 +MIPLWRITE: 0,46584,3311,0,5851,2,8,00000002DFDC1C3E,0,0 //用结果码（2）响应写请求 AT+MIPLWRITERSP=0,46584,2 OK 5.5. 执行操作 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 模块没有配置下行数据缓存模式。 3. 应用程序服务器或 OneNET 平台发送执行请求，参数为 'reset'。 //接收到执行请求 +MIPLEXECUTE: 0,36476,3303,0,5605,5,'reset' //用结果码(2)响应执行请求 AT+MIPLEXECUTERSP=0,36476,2 OK 5.6. 写属性操作 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送写属性请求。 //接收到写属性请求 +MIPLPARAMETER: 0,56642,3303,0,5700,38,'pmin=2;pmax=190;gt=100.0;lt=1.0;st=0.2' //用结果码（2）响应写属性请求 AT+MIPLPARAMETERRSP=0,56642,2 OK 上海移远通信技术股份有限公司 41 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5.7. 订阅操作 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台发送订阅请求。 3. 关闭模块自动回复订阅请求功能。 //接收到订阅请求 +MIPLOBSERVE: 0,29620,1,3311,0,-1 //响应订阅请求 AT+MIPLOBSERVERSP=0,29620,1 OK 5.8. 上报数据操作 5.8.1. 上报资源数据 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅资源（3303/0/5700）。 //上报数据 AT+MIPLNOTIFY=0,122179,3303,0,5700,4,4,25.6,0,0 OK 5.8.2. 上报实例数据 前提条件： 1. 模块成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅实例（3303/0）。 //上报实例数据 AT+MIPLNOTIFY=0,653687,3303,0,5700,4,4,10.24,3,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,653687,3303,0,5601,4,4,0.16,1,0 上海移远通信技术股份有限公司 42 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 OK AT+MIPLNOTIFY=0,653687,3303,0,5602,4,4,100.86,0,0 OK 5.8.3. 上报对象数据 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅对象（3303）。 //上报实例（0）数据 AT+MIPLNOTIFY=0,196301,3303,0,5700,4,4,9.8,3,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5601,4,4,0.16,1,0 OK AT+MIPLNOTIFY=0,196301,3303,0,5602,4,4,99.8,0,0 OK //上报实例（1）数据 AT+MIPLNOTIFY=0,196301,3303,1,5700,4,4,0.2,3,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5701,1,3,'Cel',2,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5601,4,4,3.2,1,0 OK AT+MIPLNOTIFY=0,196301,3303,1,5602,4,4,100.1,0,0 OK 5.8.4. 使用 CON 消息上报资源数据 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅资源（3303/0/5701）。 //上报资源数据 AT+MIPLNOTIFY=0,307353,3303,0,5701,1,3,'Cel',0,0,255 OK +MIPLEVENT: 0,26,255 //返回上报数据结果 上海移远通信技术股份有限公司 43 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5.8.5. 使用 CON 消息上报资源数据并携带 RAI 标记 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅资源（3303/0/5701）。 3. 执行命令 AT+CSCON=1 开启 URC'+CSCON:'上报功能，可以指示 RAI 是否生效。 //使用 CON 消息上报资源数据并携带 RAI 标志（0x400） AT+MIPLNOTIFY=0,307353,3303,0,5701,1,3,'Cel',0,0,256,0x400 OK +CSCON:1 //建立 RRC 连接，开始发送数据 +MIPLEVENT: 0,26,256 //返回上报结果 +CSCON:0 //在收到 ACK 后，RRC 连接会被立即释放 备注 URC'+MIPLEVENT:'和 URC'+CSCON:'输出顺序不唯一。 5.8.6. 使用 CON 消息上报实例数据 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅实例（3303/0）。 //使用 CON 消息上报实例数据 AT+MIPLNOTIFY=0,487674,3303,0,5700,4,4,170.1,3,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5701,1,3,'Cel',2,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5601,4,4,106.1,1,0,258 OK AT+MIPLNOTIFY=0,487674,3303,0,5602,4,4,660.9,0,0,258 OK +MIPLEVENT: 0,26,258 //返回结果 上海移远通信技术股份有限公司 44 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5.8.7. 使用 CON 消息上报实例数据并携带 RAI 标记 前提条件： 1. UE 成功注册到 OneNET 平台。 2. 应用程序服务器或 OneNET 平台已成功订阅实例（3303/0）。 3. 执行 AT+CSCON=1 命令开启'+CSCON:' URC 报告功能，可以指示 RAI 标记是否生效。 //使用 CON 消息上报实例数据并携带 RAI 标志（0x400） [15:37:14:339]AT+MIPLNOTIFY=0,450380,3303,0,5700,4,4,170.1,3,0,257,0x400 [15:37:14:403]OK [15:37:14:643]AT+MIPLNOTIFY=0,450380,3303,0,5701,1,3,'Cel',2,0,257,0x400 [15:37:14:692]OK [15:37:14:931]AT+MIPLNOTIFY=0,450380,3303,0,5601,4,4,106.1,1,0,257,0x400 [15:37:14:995]OK [15:37:15:235]AT+MIPLNOTIFY=0,450380,3303,0,5602,4,4,660.9,0,0,257,0x400 [15:37:15:299]OK [15:37:16:281] [15:37:16:281]+CSCON:1 //建立 RRC 连接，开始发送数据 [15:37:16:828] [15:37:16:828]+MIPLEVENT: 0,26,257 //返回结果 [15:37:17:477] [15:37:17:477]+CSCON:0 //接收 ACK 之后，RRC 连接会被立即释放 备注 URC'+MIPLEVENT:'和 URC'+CSCON:'输出顺序不唯一。 5.9. 更新操作 5.9.1. 无 RAI 标志的更新操作 前提条件： 模块已经成功注册到 OneNET 平台。 //更新生命周期为 86400 秒 AT+MIPLUPDATE=0,86400,0 OK +MIPLEVENT: 0,11 上海移远通信技术股份有限公司 //返回更新结果 45 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 5.9.2. 有 RAI 标志的更新操作 前提条件： 1. 模块已经成功注册到 OneNET 平台。 2. 执行 AT+CSCON=1 命令开启'+CSCON:'URC 报告功能，可以指示 RAI 标记是否生效。 [14:43:14:359]AT+MIPLUPDATE=0,86400,0,0x400 [14:43:14:391]OK [14:43:14:832] [14:43:14:832]+CSCON:1 [14:43:15:182] [14:43:15:182]+MIPLEVENT: 0,11 //更新生命周期为 86400 秒 //建立 RRC 连接，开始发送数据 //返回更新结果 [14:43:15:389] [14:43:15:389]+CSCON:0 //接收 ACK 之后，RRC 连接会被立即释放 5.10. 下行数据缓存 前提条件： 模块已经成功入网。 //配置接入机地址 AT+MIPLCONFIG=0,183.230.40.40,5683 OK //配置为同时缓存下行写请求和执行请求的数据，开启 URC 提示 AT+MIPLCONFIG=7,3,1 OK AT+MIPLCONFIG=4,1,'Quectel123456789' OK AT+MIPLCONFIG? +MIPLCONFIG:0,183.230.40.40,5683 +MIPLCONFIG:2,2 +MIPLCONFIG:3,1 +MIPLCONFIG:4,1,Quectel123456789 +MIPLCONFIG:5,0 +MIPLCONFIG:6,0 +MIPLCONFIG:7,3,1 上海移远通信技术股份有限公司 46 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 OK AT+MIPLCREATE +MIPLCREATE:0 OK AT+MIPLADDOBJ=0,3303,2,'11',4,1 OK AT+MIPLOPEN=0,86400,60 OK +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 +MIPLOBSERVE: 0,105630,1,3303,0,-1 +MIPLOBSERVE: 0,171167,1,3303,1,-1 +MIPLDISCOVER: 0,40096,3303 AT+MIPLDISCOVERRSP=0,40096,1,24,'5700;5701;5601;5602;5605' OK //收到下行数据并缓存 +MIPLEVENT: 0,100 //查询缓存，已经缓存 1 条下行数据，下行数据为 15 字节，总共接收到 1 条下行数据，没有丢弃数据 AT+MIPLRD? +MIPLRD: 1,15,1,0 OK //查询缓存，已经缓存 2 条下行数据，下行数据总共为 29 字节，总共接收到 2 条下行数据，没有丢弃数据 AT+MIPLRD? +MIPLRD: 2,29,2,0 OK //读取缓存数据，返回最早收到的数据 AT+MIPLRD +MIPLEXECUTE: 0,40103,3303,0,5605,15,'reset0123456789' 上海移远通信技术股份有限公司 47 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 OK //读取缓存数据，返回最早收到的数据 AT+MIPLRD +MIPLWRITE: 0,40104,3303,0,5706,2,5,68656C6C6F,0,2 +MIPLWRITE: 0,40104,3303,0,5850,2,1,01,0,1 +MIPLWRITE: 0,40104,3303,0,5851,2,8,00000002DFDC1C3E,0,0 OK 5.11. SOTA 实例 前提条件： 1. 模块已经成功入网。 2. 已经关闭引导并设置接入服务器 IP 和端口号。 3. 已经在 OneNET 平台创建 SOTA 任务，软件版本从 MCU_SW_V1 升级到 MCU_SW_V2。 //设置当前软件版本及软件包存储空间大小 AT+QSOTAINFO='MCU_SW_V1',10240 OK //前提是通信套件已经创建，对象已经添加 AT+MIPLOPEN=0,86400,120 OK +MIPLEVENT: 0,4 +MIPLEVENT: 0,6 +MIPLOBSERVE: 0,1639892,1,3303,0,-1 +MIPLOBSERVE: 0,1770967,1,3303,1,-1 //开始下载 +MIPLEVENT: 0,51 //收到下行软件包 +MIPLWRITE: 0,1503,5,0,0,2,512,30820DE1A0820DB981075175656374656C820101A382021AA0818380176…,0,0 上海移远通信技术股份有限公司 48 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 //软件包写入成功 AT+QSOTARESULT=3 OK //继续接收 n 包….. //最后一包 +MIPLWRITE: 0,1514,5,0,0,2,488,63C2CE3FBA2956C9601A66C50EF54437C0BD6B0DA7…,0,0 //软件包写入成功 AT+QSOTARESULT=3 OK //软件包下载完成 +MIPLEVENT: 0,52 //软件升级 +MIPLEVENT: 0,54 //更新完成后发送新版本号 AT+QSOTAINFO='MCU_SW_V2',10240 OK //设置 SOTA 结果（软件升级成功） AT+QSOTARESULT=7 OK AT+MIPLUPDATE=0,0,0 OK +MIPLEVENT: 0,11 //擦除软件包 +MIPLEVENT: 0,53 //擦除软件包成功 AT+QSOTARESULT=1 OK 上海移远通信技术股份有限公司 49 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 6 错误码 本章介绍关于 BC35-G、BC28 和 BC95 R2.0 系列模块相关的错误码 。 下面两个表格的错误码符合 3GPP 规范。请参考《3GPP TS 27.007 V13.5.0》的 sub-clause 9.2 查看 所有错误码。 表 3：一般错误(27.007) 错误码 3 4 23 30 50 51 52 159 描述 操作不允许 操作不支持 内存失败 无网络服务 参数不正确 命令已实现但被禁用 命令被用户弃用 上行忙碌/流量控制 表 4：一般错误(27.005) 错误码 300 301 302 303 304 描述 ME 失败 保留 ME 的 SMS 服务 操作不允许 操作不支持 非法的 PDU 模式参数 上海移远通信技术股份有限公司 50 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 305 非法的文本模式参数 310 未插入 USIM 311 需要 USIM PIN 312 需要 PH-USIM PIN 313 USIM 失败 314 USIM 忙碌 315 USIM 错误 316 需要 USIM PUK 317 需要 USIM PIN2 318 需要 USIM PUK2 320 内存失败 321 非法内存索引 322 内存已满 330 未知 SMSC 地址 331 无网络服务 332 网络超时 340 没有期望的 +CNMA 通知 500 未知错误 备注 可使用 AT+CMEE= 命令禁用（=0）或启用（=1）结果码 +CME ERROR: 。当 =1， 将返回一组有限的错误码，详细请参考《Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册》 上海移远通信技术股份有限公司 51 / 53 BC35-G&BC28&BC95 R2.0 OneNET 应用指导 7 附录 A 参考文档与术语缩写 表 5：参考文档 序号 文档名称 备注 [1] IPSO-Smart-Objects-Starter-Pack Smart Objects（IPSO）联盟国际标准 [2] OMA-TS-LightweightM2M-V1_0 开放移动联盟 LwM2M 标准 [3] Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册 BC35-G、BC28 和 BC95 R2.0 模块的 AT 命令说明和使用手册 表 6：术语缩写 缩写 3GPP ACK CoAP CON DTLS IPSO M2M LwM2M MCU ME NB-IoT NON PDU PIN 英文全称 3rd Generation Partnership Project Acknowledge Character Constrained Application Protocol Confirmable Datagram Transport Layer Security Internet Protocol Smart Objects Machine-To-Machine Lightweight Machine to Machine Microcontroller Unit Mobile Equipment Narrow Band Internet of Things Non-confirmable Protocol Data Unit Personal Identification Number 中文描述 第三代合作伙伴计划 确认字符 受限应用协议 需要被确认 数据包传输层安全性协议 智能物体网际协议 机器到机器的通讯 轻量化的 M2M 协议 微控制单元/单片机 移动设备 窄带物联网 不需要被确认 协议数据单元 个人身份识别码 上海移远通信技术股份有限公司 52 / 53 PSK PUK RAI REST RRC SDK SMS SMSC SOTA TE UE URC USIM BC35-G&BC28&BC95 R2.0 OneNET 应用指导 Pre-Shared Key Personal ldentification Number Unlock Key Release Assistance Indication Representational state transfer Radio Resource Control Software Development Kit Short Message Service Short Message Service Center Software Over the Air (Typically the MCU) Terminal Equipment (Typically the MCU) User Equipment (Typically the Module) Unsolicited Result Code Universal Subscriber Identity Module 预共享密钥 PIN 解锁码 释放辅助指示 表述性状态传递 无线资源控制协议 软件开发工具包 短信息服务 短消息服务中心 软件空中升级（MCU） 终端设备（MCU） 用户设备（模块） 非请求结果码 全球用户识别卡 上海移远通信技术股份有限公司 53 / 53

BC35-G&BC28 MQTT 应用指导 NB-IoT 模块系列 版本：BC35-G&BC28_MQTT_应用指导_V1.0 日期：2019-12-07 状态：受控文档 www.quectel.com BC35-G&BC28 MQTT 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 27 BC35-G&BC28 MQTT 应用指导 文档历史 修订记录 版本 1.0 日期 2019-12-07 作者 陆晓程 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 27 BC35-G&BC28 MQTT 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 2 MQTT 数据交互......................................................................................................................................6 3 MQTT 相关的 AT 命令 ...........................................................................................................................7 3.1. AT 命令语法.................................................................................................................................7 3.2. MQTT 相关的命令描述................................................................................................................ 8 3.2.1. AT+QMTCFG 配置 MQTT 的可选参数 .......................................................................... 8 3.2.2. AT+QMTENAUTH 从腾讯云获取令牌 ......................................................................... 11 3.2.3. AT+QMTOPEN 开启 MQTT 客户端网络 ..................................................................... 12 3.2.4. AT+QMTCLOSE 关闭 MQTT 客户端网络 ................................................................... 13 3.2.5. AT+QMTCONN 连接客户端到 MQTT 服务器.............................................................. 14 3.2.6. AT+QMTDISC 断开客户端与 MQTT 服务器的连接..................................................... 16 3.2.7. AT+QMTSUB 订阅主题 ............................................................................................... 16 3.2.8. AT+QMTUNS 退订主题 ............................................................................................... 18 3.2.9. AT+QMTPUB 发布消息 ............................................................................................... 19 4 MQTT 相关 URC ..................................................................................................................................21 4.1. +QMTSTAT MQTT 链路层状态变化 URC .............................................................................. 21 4.2. +QMTRECV 通知 MCU 读取 MQTT 包数据 URC.................................................................. 22 5 错误码 .................................................................................................................................................. 23 6 举例 ...................................................................................................................................................... 25 6.1. MQTT 操作举例.........................................................................................................................25 7 附录 A 参考文档及术语缩写................................................................................................................. 27 上海移远通信技术股份有限公司 3 / 27 BC35-G&BC28 MQTT 应用指导 表格索引 表 1：AT 命令及响应类型 ................................................................................................................................... 7 表 2：MQTT 相关 URC...................................................................................................................................... 21 表 3：URC +QMTSTAT 中的错误码 .................................................................................................................. 21 表 4：常见错误码（27.007） ............................................................................................................................ 23 表 5：常见错误码（27.005） ............................................................................................................................ 23 表 6：参考文档 .................................................................................................................................................. 27 表 7：术语及缩写............................................................................................................................................... 27 上海移远通信技术股份有限公司 4 / 27 BC35-G&BC28 MQTT 应用指导 1 引言 MQTT 是基于发布/订阅范式的消息协议，具有开放、简单、轻便且易于实施等特点。MQTT 最大的优 势在于，可以以极少的代码和有限的网络带宽，为远程设备连接提供实时可靠的消息服务。 本文档介绍如何通过 AT 命令应用移远通信 BC35-G 和 BC28 模块的 MQTT 功能。 上海移远通信技术股份有限公司 5 / 27 BC35-G&BC28 MQTT 应用指导 2 MQTT 数据交互 本章节介绍了 MQTT 功能的数据交互机制，如下图所示 MCU 模块 链路层 MQTT服务器 数据上报类型（非URC）： +QMT***: ,...,,… AT+QMTCFG='WILL',,.. (1) =0：从服务器接收ACK数据包； AT+QMTCFG='USER',,.. (2) =1：数据包发送超时并重新传输； …... (3) =2：数据包发送超时，且已达到最 大允许重传次数。 AT+QMTOPEN= ,, OK TCP请求 AT+QMT CO NN +QMTOPEN: , AT+QMTCONN=,,... OK +QMTCONN: ,,... TCP已创建 连接请求 T1、T2开始 返回连接ACK指示 T1停止或处理异常1 TCP同步 TCP同步&ACK TCP ACK 发送连接数据包 服务器收到连接数据包并返回ACK T1是数据包传输超时时 间. T2 是keep alive定时器. 在T2超时时间内若没有 数据相关信息传输，客 户端会发送心跳请求 包。 AT+QMT SUB AT+QMT UN S AT+QMT PUB (qos=1) AT+QMT PUB (qos=2) AT+QMTSUB=,... OK +QMTSUB: ,,... AT+QMTUNS=,,... OK 订阅请求 (msgID) T1开始 +QMTSUB: ,,1 发送订阅数据包 返回订阅ACK指示 (msgID) T1停止或处理异常2 服务器收到订阅数据包并返回ACK 退订请求 (msgID) T1开始 +QMTUNS: ,,1 发送退订数据包 异常1：断开TCP连接 异常2：重传数据包， 直到允许重传的次数达 到上限； 允许重传次数可通过命 令 AT+QMTCFG设 置。 +QMTUNS: ,, 退订ACK指示 (msgID) T1停止或处理异常2 服务器收到退订数据包并返回ACK AT+QMTPUB=,,1,... OK 发布请求 发送发布数据包 命令AT+QMTCFG可以 配置是否上报超时信息。 AT+QMTPUB=,,1,... OK 发布请求 (msgID) T1开始 发布ACK指示 (msgID) +QMTPUB: ,,,... T1停止或处理异常2 +QMTPUB: ,,1,... 发送发布数据包 服务器收到发布数据包并返回ACK AT+QMTPUB=,,2,... OK 发布请求 (msgID) T1开始 +QMTPUB: ,,2,... 发送发布数据包 发布REC指示 (msgID) T1停止或处理异常2 发布释放请求 (msgID) T1开始 发布完成指示 (msgID) +QMTPUB: ,,,... T1停止或处理异常2 服务器收到发布数据包 +QMTPUBREL: ,,1 发送释放发布数据包 服务器收到发布完成数据包 Receive 接收URC格式的 PUBLISH消息。 发布指示 (msgID) +QMTRCV: ,,,... 发布ACK/REC请求 (msgID) 根据QoS答复 . .. AT+QMTDISC= OK +QMTDISC: , AT+QMTCLOSE= OK +QMTCLOSE: , 断开连接请求 TCP请求 TCP已断开 服务器收到发布数据包 发送发布答复数据包 发送断开连接数据包 TCP 断开请求 . .. 图 1: MQTT 数据交互图 上海移远通信技术股份有限公司 6 / 27 BC35-G&BC28 MQTT 应用指导 3 MQTT 相关的 AT 命令 本章节介绍了与 MQTT 操作相关的 AT 命令。 3.1. AT 命令语法 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅示出响应，省略 。 AT 命令的语法及响应类型如下表所示： 表 1：AT 命令及响应类型 测试命令 查询命令 设置命令 执行命令 AT+=? AT+? AT+= AT+ 返回相应设置命令可设置的参数列表及取值范围。 返回相应设置命令参数的当前设置值。 设置用户可自定义的参数值。 执行无需设置参数值的命令。 当 AT 命令处理器处理完一条命令后，将响应 OK、ERROR 或+CME ERROR: ，表示已经准备 接收新命令。在返回最终的 OK，ERROR 或+CME ERROR: 之前，会发送请求的响应消息。 在使用 AT 命令过程出现错误时，若返回+CME ERROR: ，请参考第 5 章，查找 错误码。 备注 本文档参数说明中添加下划线的参数值为默认值。 上海移远通信技术股份有限公司 7 / 27 BC35-G&BC28 MQTT 应用指导 3.2. MQTT 相关的命令描述 3.2.1. AT+QMTCFG 配置 MQTT 的可选参数 该命令用于配置 MQTT 的可选参数。 AT+QMTCFG 配置 MQTT 的可选参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: 'version',(支持的列表),(支 持的列表) +QMTCFG: 'keepalive',(支持的列表), (支持的范围) +QMTCFG: 'session',(支持的列表),(支 持的列表) +QMTCFG: 'timeout',(支持的列表),(支 持的范围),(支持的范围),(支持 的列表) +QMTCFG: 'will',(支持的列表),(支持的< will_fg>列表),(支持的范围),(支持的 列表),, +QMTCFG: 'aliauth',(支持的列表),,, 设置命令 配置 MQTT 协议版本 AT+QMTCFG='version',[,] OK 响应 若省略，则查询 MQTT 协议版本： +QMTCFG: 'version', OK 若指定，则配置 MQTT 协议版本： OK 设置命令 配置 Keep-alive 时间 AT+QMTCFG='keepalive',[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略，则查询 Keep-alive 时间： +QMTCFG: 'keepalive', OK 上海移远通信技术股份有限公司 8 / 27 BC35-G&BC28 MQTT 应用指导 若指定，则配置 Keep-alive 时间： OK 设置命令 配置会话类型 AT+QMTCFG='session',[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略，则查询会话类型： +QMTCFG: 'session', OK 若指定，则配置会话类型： OK 设置命令 配置消息传输超时时间 AT+QMTCFG='timeout',[,[,] [,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略、和， 则查询消息传输超时时间： +QMTCFG: 'timeout',,, OK 若指定、和， 则配置消息传输超时时间： OK 设置命令 配置 Will 信息 AT+QMTCFG='will',[,[,,,,]] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略、、、 和，则查询 Will 信息： +QMTCFG: 'will',[,,,,] OK 上海移远通信技术股份有限公司 9 / 27 BC35-G&BC28 MQTT 应用指导 若指定、、、 和，则配置 Will 信息： OK 设置命令 为阿里云配置阿里设备信息 AT+QMTCFG='aliauth',[,,,< devicesecret>] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 若省略、和， 则查询设备信息： [+QMTCFG: 'aliauth',,,] OK 若指定、和， 则配置设备信息： OK 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。当前只支持一个 MQTT 实例，该值始终为 0。 整型。MQTT 协议版本。 3 MQTT 协议 v3.1 4 MQTT 协议 v3.1.1 整型。表示是否需要配置 Will flag。 0 无需配置 Will flag 1 需要配置 Will flag 整型。消息传输的 QoS 级别。 0 最多一次 1 至少一次 2 仅一次 整型。Will retain flag，仅适用于 PUBLISH（发布）消息。 0 当客户端向服务器发送 PUBLISH 消息时，在消息成功发送到当前订阅者 上海移远通信技术股份有限公司 10 / 27 BC35-G&BC28 MQTT 应用指导 之后，服务器端将不会保留该消息 1 当客户端向服务器发送 PUBLISH 消息时，服务器应在消息传输到当前订 阅者后保留该消息。 字符串类型。Will 主题名称。最大长度为 255 字节。 字符串类型。Will 消息，表示如果客户端意外断开连接，将发布到 Will 主题的 消息内容。长度可为 0。最大长度为 255 字节。 整型。数据包传输超时时间。范围：1-60。默认值：10。单位：秒。 整型。数据包传输超时后的重发次数。范围：0-10。默认值：3。 整型。表示传输数据包时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器存储该客户端的订阅 1 服务器端丢弃之前为该客户端保留的任何信息，并将连接视为'clean（清 除）' 整型。Keep-alive 时间。范围：0-3600。默认值：120。单位：秒。 此参数定义了从客户端接收消息的最大间隔时间。在此参数设置的 Keep-alive 时间的 1.5 倍时间内，若服务器端未从客户端收到消息，则默认断开客户端连 接，效果和从客户端发送了 DISCONNECT（断开连接）消息相同。 当设置为 0，表示不会根据此参数断开客户端连接。 字符串类型。阿里云发布的产品密钥。 字符串类型。阿里云发布的设备名称。 字符串类型。阿里云发布的设备密钥。 备注 1. 若参数 =1，则必须配置参数 ，， 和 ； 若参数 =0，则需省略以上参数。 2. 只有当服务器支持清除会话操作时，=0 才有效。 3. 必须注意确保消息在发送过程中不会超时。AT+QMTCFG='aliauth' 命令仅用于阿里云，若已在此命 令中配置了参数 、 和 ，则 AT+QMTCONN 命令中的 和 参数可以省略。 3.2.2. AT+QMTENAUTH 从腾讯云获取令牌 该命令用于从腾讯云获取令牌。 AT+QMTENAUTH 从腾讯云获取令牌 测试命令 AT+QMTENAUTH=? 响应 +QMTTENAUTH: ,,,,, OK 上海移远通信技术股份有限公司 11 / 27 BC35-G&BC28 MQTT 应用指导 查询命令 AT+QMTENAUTH? 响应 [+QMTTENAUTH: ] 设置命令 AT+QMTTENAUTH=,,,[,[,]] OK 响应 OK +QMTTENAUTH: [,] 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 195 秒，由网络决定 参数配置立即生效，掉电后不保存。 参数 字符串类型。腾讯云发布的产品 ID。 字符串类型。腾讯云发布的设备名称。 字符串类型。客户端 ID，格式为 @。 字符串类型。腾讯云发布的设备密钥。 设置密码过期时间。最大值：60。单位：天。 字符串类型。设置 URL 以获取密码。 从腾讯云获取的密码。 整型。命令执行结果。 0 成功获取密码 1 DNS 解析失败 2 初始化 Socket 失败 3 HTTP 数据包错误 4 发送 Socket 错误 5 HTTP 数据包分析错误 6 超时 3.2.3. AT+QMTOPEN 开启 MQTT 客户端网络 该命令用于为 MQTT 客户端打开网络。 AT+QMTOPEN 开启 MQTT 客户端网络 测试命令 AT+QMTOPEN=? 响应 +QMTOPEN: (支持的列表),, 查询命令 AT+QMTOPEN? OK 响应 [+QMTOPEN: ,,] 设置命令 AT+QMTOPEN=,, OK 响应 OK +QMTOPEN: , 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 75 秒，由网络决定 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。当前只支持一个 MQTT 实例，该值始终为 0。 字符串类型。服务器的地址。可为 IP 地址或域名。最大长度为 100 字节。 整型。服务器端口。范围：0-65535。 整型。命令执行结果。 -1 打开网络失败 0 成功打开网络 1 参数错误 2 MQTT 标识符被占用 3 激活 PDP 失败 4 解析域名失败 5 网络断开 3.2.4. AT+QMTCLOSE 关闭 MQTT 客户端网络 该命令用于关闭 MQTT 客户端的网络。 AT+QMTCLOSE 关闭 MQTT 客户端网络 测试命令 AT+QMTCLOSE=? 响应 +QMTCLOSE: (支持的列表) 上海移远通信技术股份有限公司 13 / 27 BC35-G&BC28 MQTT 应用指导 设置命令 AT+QMTCLOSE= OK 响应 OK +QMTCLOSE: , 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。当前只支持一个 MQTT 实例，该值始终为 0。 整型。命令执行结果。 -1 关闭网络失败 0 成功关闭网络 3.2.5. AT+QMTCONN 连接客户端到 MQTT 服务器 该命令用于客户端请求连接到 MQTT 服务器。当创建客户端和服务器之间的 TCP/IP Socket 连接时， 必须使用 CONNECT（连接）流创建一个协议层会话。 AT+QMTCONN 连接客户端到 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: (支持的列表),,< username>, 查询命令 AT+QMTCONN? OK 响应 [+QMTCONN: ,] 设置命令 AT+QMTCONN=,[,[,]] OK 响应 OK +QMTCONN: ,[,] 上海移远通信技术股份有限公司 14 / 27 最大响应时间 特性说明 BC35-G&BC28 MQTT 应用指导 若出现任何错误： ERROR 或者 +CME ERROR: （默认为 10 秒），由网络决定。 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。目前只支持一个 MQTT 实例，该值始终为 0。 字符串类型。客户端标识符。 字符串类型。客户端用户名称，可用于身份验证。 字符串类型。与客户端用户名称相对应的密码，可以用于身份验证。 整型。命令执行结果。 0 已成功发送数据包并从服务器接收到 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 正在初始化 2 MQTT 正在连接 3 MQTT 已连接 4 MQTT 正在断开 整型。连接状态返回码。 0 接受连接 1 拒绝连接：协议版本不可接受 2 拒绝连接：标识符被拒绝 3 拒绝连接：服务器不可用 4 拒绝连接：用户名或密码错误 5 拒绝连接：未授权 整型。数据包传输超时时间。范围：1-60。默认值：10。单位：秒。 备注 若新客户端连接服务器端时，已有相同 ID 的客户端已经连接至服务器， 则在新客户端 CONNECT 流完成 之前，服务器会断开原有已连接的客户端。 上海移远通信技术股份有限公司 15 / 27 BC35-G&BC28 MQTT 应用指导 3.2.6. AT+QMTDISC 断开客户端与 MQTT 服务器的连接 该命令用于客户端请求从 MQTT 服务器断开连接。客户端发送 DISCONNECT（断开连接）消息至服 务器表示 TCP/IP 连接即将关闭。 AT+QMTDISC 断开客户端与 MQTT 服务器的连接 测试命令 AT+QMTDISC=? 响应 +QMTDISC: (支持的列表) 设置命令 AT+QMTDISC= OK 响应 OK +QMTDISC: , 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: 300 毫秒 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。目前只支持一个 MQTT 实例，该值始终为 0。 整型。命令执行结果。 -1 关闭连接失败 0 关闭连接成功 3.2.7. AT+QMTSUB 订阅主题 该命令用于订阅一个或多个主题。客户端发送 SUBSCRIBE（订阅）消息，在服务器注册一个或多个 主题名称的 Interest（兴趣）。发布到这些主题的消息作为 PUBLISH（发布）消息从服务器发送到客户端。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: (支持的列表),(支持的 范围),,(支持的范围)[,,(支持的范 围)...] OK 上海移远通信技术股份有限公司 16 / 27 BC35-G&BC28 MQTT 应用指导 设置命令 AT+QMTSUB=,< msgID>,,[,,...] 响应 OK +QMTSUB: ,,[,] 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: * （默认为 15 秒），由网络决定。 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。目前只支持一个 MQTT 实例，该值始终为 0。 整型。消息标识符。范围：1-65535。 字符串类型。客户端订阅或退订的主题。最大长度为 255 字节。 整型。客户端发布消息的 QoS 级别。 0 最多一次 1 至少一次 2 仅一次 整型。命令执行结果。 0 已成功发送数据包并从服务器接收到 ACK 1 重传数据包 2 数据包发送失败 整型。 若 =0，则 作为服务器已确认的 QoS 等级。当 =0 时， =128 表示服务器拒绝订阅； 若 =1，则表示数据包重传次数； 若=2，则不显示。 整型。数据包传输超时时间。范围：1-60。默认值：10。单位：秒。 整型。数据包传输超时后的重发次数。范围：0-10。默认值：3。 备注 参数 仅在 值为 1 或 2 的消息中有效，此参数在特定通信方向上的一组'飞行'消息中 必须唯一。一般来说， 参数值根据消息逐一递增。 上海移远通信技术股份有限公司 17 / 27 BC35-G&BC28 MQTT 应用指导 3.2.8. AT+QMTUNS 退订主题 该命令用于取消一个或多个主题的订阅。客户端向服务器发送 UNSUBSCRIBE（取消订阅）消息以退 订指定的主题。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: (支持的列表),(支持的 范围),[,...] 设置命令 AT+QMTUNS=,< msgID>,[,…] OK 响应 OK +QMTUNS: ,, 最大响应时间 特性说明 若出现任何错误： ERROR 或者 +CME ERROR: * （默认为 15 秒），由网络决定。 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。目前只支持一个 MQTT 实例，该值始终为 0。 整型。消息标识符。范围：1-65535。 整型。客户端订阅或退订的主题。最大长度为 255 字节。 整型。命令执行结果。 0 已成功发送数据包并从服务器接收到 ACK 1 重传数据包 2 数据包发送失败 整型。数据包传输超时时间。范围：1-60。默认值：10。单位：秒。 整型。数据包传输超时后的重发次数。范围：0-10。默认值：3。 上海移远通信技术股份有限公司 18 / 27 BC35-G&BC28 MQTT 应用指导 3.2.9. AT+QMTPUB 发布消息 通过该命令可以从客户端发布消息到服务器，再由服务器分配到的已订阅主题的订阅者。每个 PUBLISH 消息都关联一个主题名称。如果客户端订阅了一个或多个主题，那么服务器会将发布到这些主题下的所有 消息作为 PUBLISH 消息发送到客户端。 AT+QMTPUB 发布消息 测试命令 AT+QMTPUB=? 响应 +QMTPUB: (支持的列表),(支持的范围),(支持的范围),(支持的列表),, (支持的范围) 设置命令 发布不定长消息 AT+QMTPUB=,,,, 响应 > 后，输入要发送的数据，然后按 CTRL+Z 发送，或按 Esc 取消操作。 设置命令 发布定长消息 AT+QMTPUB=,,,,, 响应 > 后，输入要发送的数据。当数据 长度达到 规定的长度后，将自动 发送 OK 响应 OK +QMTPUB: ,,[,] 若出现任何错误： ERROR 或者 +CME ERROR: 响应 OK +QMTPUB: ,,[,] 若出现任何错误： ERROR 或者 +CME ERROR: 最大响应时间 * （默认为 15 秒），由网络决定。 特性说明 参数配置立即生效，掉电后不保存。 参数 整型。MQTT Socket 标识符。目前只支持一个 MQTT 实例，该值始终为 0。 整型。消息标识符。范围：0-65535。只有当参数 =0 时才为 0。 整型。客户端发布消息的 QoS 级别。 0 最多一次 上海移远通信技术股份有限公司 19 / 27 BC35-G&BC28 MQTT 应用指导 1 至少一次 2 仅一次 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 将消息传输到当前订阅服务器后，服务器将不会保留该消息。 1 服务器将在消息传输到当前订阅服务器之后，保留该消息。 字符串类型。需要发布消息的主题。最大长度为 255 字节。 字符串类型。需要发布的消息。 整型。范围：1-1024。单位：字节。 整型。命令执行结果。 0 已成功发送数据包并从服务器接收到 ACK（当参数 =0 时，发布的消息 不需要 ACK） 1 重传数据包 2 数据包发送失败 整型。 若 =1，则表示数据包重传次数； 若 =0 或 2，则不显示此参数。 整型。数据包传输超时时间。范围：1-60。默认值：10。单位：秒。 整型，数据包传输超时后的重发次数。范围：0-10。默认值：3。 备注 1. 若该命令执行成功并响应 OK，则用户可以继续发布新数据包。发送数据包的最大数量不得大于飞行窗 口的最大数量（5）。 2. 执行该命令后，客户端将准备发送数据，数据将作为有效负载发送。当输入数据达到最大长度时自动 发送数据，字节数小于最大字节的需要点击 CTRL+Z 发送数据。 3. PUBLISH 消息既可由发布者发送至服务器，也可以由服务器发送至订阅者。当服务器向订阅者发布消 息时，将返回以下 URC 将 MQTT 服务器发送的数据通知给终端 MCU： +QMTRECV: ,,, 有关 URC 的详细信息，请参考第 4.2 章。 上海移远通信技术股份有限公司 20 / 27 BC35-G&BC28 MQTT 应用指导 4 MQTT 相关 URC 本章提供与 MQTT 相关的 URC 及其描述。 表 2：MQTT 相关 URC 序号 [1] [2] URC 格式 描述说明 +QMTSTAT: , 当 MQTT 链路层的状态发生变化时，客户端 将关闭 MQTT 连接并上报此 URC。 +QMTRECV: ,,, 报此 URC。 4.1. +QMTSTAT MQTT 链路层状态变化 URC 此 URC 以 +QMTSTAT 开头。当 MQTT 链路层的状态发生变化时，将上报 URC。 +QMTSTAT MQTT 链路层状态变化 URC +QMTSTAT: , 当 MQTT 链路层的状态改变时，客户端将关闭 MQTT 连接并上报 URC。 参考 参数 整型。MQTT Socket 标识符。目前只支持一个 MQTT 实例，该值始终为 0。 整型。错误代码。详情请参考下表。 表 3：URC +QMTSTAT 中的错误码 描述 如何操作 1 连接被对等方关闭或重置。 执行 AT+QMTOPEN 命令并重新开启 MQTT 连接。 2 发送 PINGREQ 数据包超时或失败。 首先将 PDP 去激活，然后再激活 PDP 并重新开启 MQTT 连接。 上海移远通信技术股份有限公司 21 / 27 3 4 5 6 7 8-255 BC35-G&BC28 MQTT 应用指导 发送 CONNECT 包超时或失败 接收 CONNECK 包超时或失败 客户端向服务器发送 DISCONNECT 包，服务器主动关闭 MQTT 连接。 因为发送数据包一直失败，客户端主动 关闭 MQTT 连接。 1. 检查输入的用户名和密码是否正确。 2. 确保客户端 ID 未使用。 3. 重新开启 MQTT 连接并尝试再次向服务器发 送 CONNECT 数据包。 1. 检查输入的用户名和密码是否正确。 2. 确保客户端 ID 未使用。 3. 重新打开 MQTT 连接并尝试再次向服务器发 送连接数据包。 正常流程。 1. 确保数据正确。 2. 由于可能存在网络堵塞或错误，尝试重新开启 MQTT 连接。 链路未激活或服务器不可用。 确保当前链路处于活动状态或服务器可用。 预留作将来使用的错误码 4.2. +QMTRECV 通知 MCU 读取 MQTT 包数据 URC 此 URC 以 +QMTRECV 开头，用于通知终端 MCU 读取已从 MQTT 服务器接收的 MQTT 包数据。 +QMTRECV 通知 MCU 读取 MQTT 包数据 URC +QMTRECV: ,,, 数据。 参考 参数 整型。MQTT Socket 标识符。目前只支持一个 MQTT 实例，该值始终为 0。 整型。消息标识符。 字符串类型。从 MQTT 服务器接收消息的主题。 字符串类型。与主题名称相关的负载。 上海移远通信技术股份有限公司 22 / 27 BC35-G&BC28 MQTT 应用指导 5 错误码 最终结果码 +CME ERROR: 表示与移动设备或网络相关的错误。下表列出了部分常见错误代 码。 表 4：常见错误码（27.007） 错误码 3 4 23 30 50 51 52 159 含义 不允许此操作 不支持此操作 内存故障 无网络服务 参数不正确 已执行命令但当前被禁用 此命令被用户中止 上行忙碌/流控 表 5：常见错误码（27.005） 错误码 300 301 302 303 304 305 含义 ME 故障 ME 预留的短信服务 不允许此操作 不支持此操作 无效 PDU 模式参数 无效文本模式参数 上海移远通信技术股份有限公司 23 / 27 BC35-G&BC28 MQTT 应用指导 310 未插入 USIM 卡 311 需要 USIM PIN 312 需要 PH-USIM PIN 313 USIM 故障 314 USIM 忙碌 315 USIM 错误 316 需要 USIM PUK 317 需要 USIM PIN2 318 需要 USIM PUK2 320 内存故障 321 内存索引无效 322 内存已满 330 未知的 SMSC 地址 331 无网络服务 332 网络超时 340 预计没有+CNMA 确认 500 未知错误 备注 AT+CMEE= 可禁用（=0）或使能（=1）最终结果码 +CME ERROR: 的使用。若参数 保持默认值 0，则错误响应为 ERROR；若参数 设置为 1，则错误响应为 +CME ERROR: 。命令 详情请参考《Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册_V1.0》。 上海移远通信技术股份有限公司 24 / 27 BC35-G&BC28 MQTT 应用指导 6 举例 本章提供了一些示例以解释如何使用与 MQTT 相关的 AT 命令。 6.1. MQTT 操作举例 //为阿里云配置阿里设备信息。 AT+QMTCFG='aliauth',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAazZ' OK AT+QMTOPEN=? +QMTOPEN: (0),, OK /开启 MQTT 客户端网络。 AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK +QMTOPEN: 0,0 //成功打开 MQTT 客户端网络。 AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK AT+QMTCONN=? +QMTCONN: (0),,, OK // 若 连 接 阿 里 云 ， 使 用 命 令 AT+QMTCFG='ALIAUTH' 提 前 配 置 设 备 信 息 ， 之 后 便 可 省 略 参 数 和 AT+QMTCONN=0,'clientExample' //将客户端连接到 MQTT 服务器。 OK +QMTCONN: 0,0,0 //已成功将客户端连接到 MQTT 服务器。 上海移远通信技术股份有限公司 25 / 27 BC35-G&BC28 MQTT 应用指导 AT+QMTSUB=? +QMTSUB: (0),(1-65535),,(0-2)[,,(0-2)...] OK AT+QMTSUB=0,1,'topic/example',2 OK //订阅主题'topic/example'。 +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK //订阅主题'topic/pub'。 +QMTSUB: 0,1,0,0 //若客户订阅了其他设备发布到服务器的相同主题，则模块会上报如下信息： +QMTRECV: 0,0, 'topic/example', 'This is the payload related to topic' AT+QMTUNS=0,2, 'topic/example' OK //退订主题。 +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB: (0),(0-65535),(0-2),(0,1),,(1-1024) OK AT+QMTPUB=0,0,0,0,'topic/pub' >这是测试数据, hello MQTT. OK //发布消息。 //接收到 > 后，输入数据：'这是测试数据, hello MQTT'， 数据的最大长度为 1024 字节，超过 1024 字节的数据将被忽 略，输入完成后，点击 CTRL+Z 发送。 +QMTPUB: 0,0,0 //若客户端订阅了名为'topic/pub'的主题，且其他设备向服务器发布了相同主题，则模块将上报以下信息： +QMTRECV: 0,0,'topic/pub',这是测试数据, hello MQTT. AT+QMTDISC=0 OK //断开客户端与 MQTT 服务器的连接。 上海移远通信技术股份有限公司 26 / 27 BC35-G&BC28 MQTT 应用指导 7 附录 A 参考文档及术语缩写 表 6：参考文档 序号 [1] [2] [3] 文档名称 说明 MQTT V3.1 Protocol Specification MQTT 协议规格说明 3.1 版本 MQTT V3.1.1 Protocol Specification MQTT 协议规格说明 3.1.1 版本 Quectel_BC35-G&BC28&BC95 R2.0_AT 命 BC35-G、BC28 和 BC95 R2.0 模块的 AT 命令 令手册_V1.0 手册 表 7：术语及缩写 缩写 ACK MQTT QoS TCP IP URC URL 英文全称 中文全称 Acknowledgement 确认字符 Message Queuing Telemetry Transport 消息队列遥测传输 Quality of Service 服务质量 Transmission Control Protocol 传输控制协议 Internet Protocol 互联网协议 Unsolicited Result Code 非请求结果码 Uniform Resource Locator 统一资源定位符 上海移远通信技术股份有限公司 27 / 27

BC35-G&BC28&BC95 R2.0 &BC39 中国移动 DM 平台 接入指导 NB-IoT 模块系列 版本：BC35-G&BC28&BC95 R2.0&BC39_中国移动 DM 平台接入指导_V1.0 日期：2020-01-23 状态：受控文件 www.quectel.com BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 文档历史 修订记录 版本 日期 作者 1.0 2020-01-23 唐正/段洁 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 DM V1.0 相关 AT 命令 .......................................................................................................................... 6 2.1. AT+DMPCONFIG DM 平台接入配置....................................................................................... 6 3 DM V2.0 相关 AT 命令 ........................................................................................................................ 11 3.1. AT+QDMPCFG DM 平台接入配置 .........................................................................................11 3.2. AT+QDMPCFGEX DM 平台接入配置扩展 ............................................................................ 15 4 错误码 ................................................................................................................................................. 20 5 附录 A 参考文档及术语缩写............................................................................................................... 23 上海移远通信技术股份有限公司 3 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 表格索引 表 1：通用错误码（27.007）..................................................................................................................... 20 表 2：通用错误码（27.005）..................................................................................................................... 20 表 3：特定错误码 ....................................................................................................................................... 21 表 4：参考文档 ........................................................................................................................................... 23 表 5：术语缩写 ........................................................................................................................................... 23 上海移远通信技术股份有限公司 4 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 1 引言 中国移动终端管理（DM）平台是中国移动终端公司为 UE 提供注册、管理、统计等功能的管理平台。 满足《中国移动终端公司（DM）终端技术规范》的终端可以接入到中国移动终端管理平台（本文档中简称 'DM 平台'），由 DM 平台完成对终端的管理。如需了解更多 DM 平台相关信息，请联系中国移动终端公 司。 支持接入 DM 平台的模块，根据固件版本不同分别支持 DM V1.0 或 DM V2.0 的 DM 功能。DM V1.0 和 DM V2.0 分别满足中国移动终端公司发布的《多形态终端上报接口规范》V1.0.8 和 V2.0.3 的要求。 本文档主要介绍了与接入 DM 平台相关 AT 命令的用法。请根据软件版本选择使用对应的 AT 命令，支 持 DM V1.0 的软件版本请使用 第 2 章 的命令，支持 DM V2.0 的软件版本请使用 第 3 章 的命令。 上海移远通信技术股份有限公司 5 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 2 DM V1.0 相关 AT 命令 本章仅适用于满足《多形态终端上报接口规范》V1.0.8 的软件版本，即除 BC39 以外的所有 R01 基线 系列的 OneNET 版本。 备注 1. 本章 AT 命令所支持的具体软件版本，请参考对应版本的《软件版本变更说明》或咨询移远通信技术 支持。 2. OneNET 版本指版本号后缀为 ONT 的软件版本，例如 BC35GJBR01A04_ONT。 3. R01 基线指软件版本中含有 R01 的版本，例如 BC35GJBR01A04_ONT。 2.1. AT+DMPCONFIG DM 平台接入配置 该命令用于配置和查询 DM 平台接入的相关参数，如 DM 平台 IP 地址和端口，心跳周期，APPKEY 和 密钥、终端类型以及终端 IMEI 等。模块默认接入 DM 商用平台（coap://m.fxltsbl.com:5683）。若开启了 DM 功能，入网之后则会对 DM 商用平台域名（m.fxltsbl.com）进行解析，如果无法通过域名解析获取 DM 商 用平台的 IP 地址，将使用默认 DM 平台 IP 地址 117.161.2.41，端口为 5683。 可使用参数 =1 手动配置 DM 平台接入的 IP 地址，以满足测试需求。 查询命令用于查询模块当前使用的 DM 平台接入参数配置。 设置命令用于保存或擦除配置信息。 请参阅 第 4 章，查找相关 错误码。 AT+DMPCONFIG DM 平台接入配置 测试命令 AT+DMPCONFIG=? 响应 +DMPCONFIG: [,[][,[][, [,]]]] 查询命令 AT+DMPCONFIG? OK 响应 +DMPCONFIG: 0, [+DMPCONFIG: 1,[],[], +DMPCONFIG: 2,,,,] OK 设置命令 AT+DMPCONFIG=[,[,[,]]] 响应 若有参数输出： ,[,[,]] OK 若无参数输出： OK 若出现任何错误： ERROR 或者 +CME ERROR: 参数 整型。配置类型。不同的配置类型对应不同的 DM 平台接入参数。 0 配置 DM 功能模式 1 配置 DM 平台接入地址及心跳（更新）周期 2 配置 APPKEY 和密钥、终端类型以及终端 IMEI 3 配置 PLMN 4 查询 Flash 中保存的配置信息 5 擦除 Flash 中保存的配置信息 6 查询 DM 接入状态 0 - - - 1 - 2 3 - 4 - - - 5 - - - 6 - - - 整型。DM 功能模式。 0 DM 功能关闭 1 DM 功能开启 DM 平台 IP 地址。 DM 平台的端口。默认端口为 5683。 心跳（更新）周期。范围：300-4294966。单位：秒。默认心跳（更新）周期：86400。 上海移远通信技术股份有限公司 7 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 APPKEY。在设置命令中，需用双引号标记。默认为移远通信 APPKEY。 密钥。在设置命令中，需用双引号标记。默认为移远通信密钥。 整型。终端类型。 0 接口 1 Linux 2 Android 终端设备 IMEI。参数值长度为 15-17 个字节。 PLMN 值。此参数仅在中国移动新增 PLMN 时可使用。 整型。查询 Flash 中保存的配置信息选项。 0 查询保存的 DM 功能模式 1 查询保存的 DM 平台 IP 地址、端口以及心跳（更新）周期 2 查询保存的 APPKEY、密钥、终端类型以及终端 IMEI，仅会显示密钥的前四 位字符 3 查询保存的 PLMN 整型。擦除 Flash 中保存的配置信息选项。 0 擦除保存的 DM 功能模式 1 擦除保存的 DM 平台服务器 IP 地址、端口以及更新周期 2 擦除保存的 APPKEY、密钥、接口类型以及终端 IMEI 3 擦除保存的 PLMN 4 擦除以上所有保存的信息 整型。DM 接入状态。 0 初始化 4 连接成功 5 连接失败 6 注册成功 7 注册失败 8 注册超时 9 设备生存周期超时 11 心跳（更新）成功 12 心跳（更新）失败 13 心跳（更新）超时 备注 1. 使用查询命令进行查询时，当前配置信息可能与保存的配置信息不同。并且，在入网成功且域名解析 完成后查询命令才能返回完整参数，否则仅会返回 。 2. 该命令的配置将自动保存至 Flash 中，所有保存的配置信息将在重启后生效。 举例 //查询当前配置信息。 AT+DMPCONFIG? +DMPCONFIG: 0,1 +DMPCONFIG: 1,117.161.2.7,5683,420 上海移远通信技术股份有限公司 8 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 +DMPCONFIG: 2,M100000089,95Go****,1,863703030822519 OK //关闭 DM 功能。 AT+DMPCONFIG=0,0 OK //查询保存的 DM 功能模式。 AT+DMPCONFIG=4,0 0,0 OK //设置 DM 平台 IP 地址、端口及心跳（更新）周期。 AT+DMPCONFIG=1,117.161.2.7,5683,420 OK //查询保存的 DM 平台 IP 地址、端口及心跳（更新）周期。 AT+DMPCONFIG=4,1 1,117.161.2.7,5683,420 OK //设置心跳（更新）周期，不设置 DM 平台 IP 地址和端口。 AT+DMPCONFIG=1,,,300 OK //查询保存的 DM 平台 IP 地址、端口及心跳（更新）周期。 AT+DMPCONFIG=4,1 1,,,300 OK //设置 APPKEY、密钥、终端类型和终端 IMEI。 AT+DMPCONFIG=2,'M100000089','77GaaTUi33nUK05ha528888QFbk0Y38M',1,863703030822519 OK //查询保存的 APPKEY、密钥、终端类型和终端 IMEI。 AT+DMPCONFIG=4,2 2,M100000089,77Ga****,1,863703030822519 OK 上海移远通信技术股份有限公司 9 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 //添加一个中国移动 PLMN。 AT+DMPCONFIG=3,46004 OK //查询保存的中国移动 PLMN（此仅为示例，并非真实 PLMN）。 AT+DMPCONFIG=4,3 3,46004 OK //添加三个 PLMN（此仅为示例，并非真实 PLMN）。 AT+DMPCONFIG=3,46005,46008,46009 OK //查询保存的 PLMN。 AT+DMPCONFIG=4,3 3,46005,46008,46009 OK //擦除保存的 PLMN。 AT+DMPCONFIG=5,3 OK //擦除所有保存的信息。 AT+DMPCONFIG=5,4 OK //查询 DM 接入状态。 AT+DMPCONFIG=6 6,6 //注册成功。 OK //心跳（更新）成功。 AT+DMPCONFIG=6 6,11 OK 备注 以上示例主要用于说明 AT 命令的使用，而非实际操作流程。 上海移远通信技术股份有限公司 10 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 3 DM V2.0 相关 AT 命令 本章仅适用于满足《多形态终端上报接口规范》V2.0.3 的软件版本，即 BC39 和所有 R02 的基线系列 OneNET 版本以及部分定制版本。 备注 1. 本章 AT 命令所支持的具体软件版本，请参考对应版本的《软件版本变更说明》或咨询移远通信技术 支持。 2. OneNET 版本指版本号后缀为 ONT 的软件版本，例如 BC35GJBR02A02_ONT。 3. R02 基线指软件版本中含有 R02 的版本，例如 BC35GJBR02A02_ONT。 3.1. AT+QDMPCFG DM 平台接入配置 该命令用于配置和查询 DM 平台接入的相关参数，如 DM 平台 IP 地址和端口，心跳周期，APPKEY 和 密钥、终端类型以及终端 IMEI 等。模块默认接入 DM 商用平台（coap://m.fxltsbl.com:5683）。若开启了 DM 功能，入网之后则会对 DM 商用平台域名（m.fxltsbl.com）进行解析，如果无法通过域名解析获取 DM 商用平台的 IP 地址，将使用默认 DM 平台 IP 地址 117.161.2.41，端口为 5683。 可使用参数 =1 手动配置 DM 平台接入的 IP 地址，以满足测试需求。 查询命令用于查询模块当前使用的 DM 平台接入参数配置。 设置命令用于保存或擦除配置信息。 请参阅第 4 章，查找相关 错误码。 AT+QDMPCFG DM 平台接入配置 测试命令 AT+QDMPCFG=? 响应 +QDMPCFG: [,[][,[][,< parameter3>[,]]]] 查询命令 AT+QDMPCFG? OK 响应 +QDMPCFG: 0, [+QDMPCFG: 1,[],[], +QDMPCFG: 2,,,,] OK 设置命令 AT+QDMPCFG=[,[,[,]]] 响应 若有参数输出： [,[,[,]]] OK 若无参数输出： OK 若出现任何错误： ERROR 或者 +CME ERROR: 参数 整型。配置类型。不同的配置类型对应不同的 DM 平台接入参数。 0 配置 DM 功能模式 1 配置 DM 平台接入地址及心跳（更新）周期 2 配置 APPKEY 和密钥、终端类型以及终端 IMEI 3 配置 PLMN 4 查询 Flash 中保存的配置信息 5 擦除 Flash 中保存的配置信息 6 查询 DM 接入状态 0 - - - 1 - 2 3 - 4 - - - 5 - - - 6 - - - 整型。DM 功能模式。 0 DM 功能关闭 1 DM 功能开启 DM 平台 IP 地址。 DM 平台的端口。默认端口为 5683。 心跳（更新）周期。范围：300-4294966。单位：秒。默认心跳（更新）周期：86400。 上海移远通信技术股份有限公司 12 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 APPKEY。在设置命令中，需用双引号标记。默认为移远通信 APPKEY。 密钥。在设置命令中，需用双引号标记。默认为移远通信密钥。 整型。终端类型。 0 接口 1 Linux 2 Android 终端设备 IMEI。参数值长度应为 15-17 个字节。 PLMN 值。此参数仅在中国移动新增 PLMN 时可使用。 整型。查询 Flash 中保存的配置信息选项。 0 查询保存的 DM 功能模式 1 查询保存的 DM 平台 IP 地址、端口以及心跳（更新）周期 2 查询保存的 APPKEY、密钥、终端类型以及终端 IMEI，仅会显示密钥的前四 位字符 3 查询保存的 PLMN 整型。擦除 Flash 中保存的配置信息选项。 0 擦除保存的 DM 功能模式 1 擦除保存的 DM 平台服务器 IP 地址、端口以及更新周期 2 擦除保存的 APPKEY、密钥、接口类型以及终端 IMEI 3 擦除保存的 PLMN 4 擦除以上所有保存的信息 整型。DM 接入状态。 0 初始化 4 连接成功 5 连接失败 6 注册成功 7 注册失败 8 注册超时 9 设备生存周期超时 11 心跳（更新）成功 12 心跳（更新）失败 13 心跳（更新）超时 备注 1. 使用查询命令进行查询时，当前配置信息可能与保存的配置信息不同。并且，在入网成功且域名解析 完成后查询命令才能返回完整参数，否则仅会返回 。 2. 该命令的配置将自动保存至 Flash 中，所有保存的配置信息将在重启后生效。 3. 部分版本的最小更新周期为 120 秒，详情请参考对应版本的《软件版本变更说明》或咨询移远通信 技术支持。 举例 //查询当前配置信息。 AT+QDMPCFG? 上海移远通信技术股份有限公司 13 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 +QDMPCFG:0,1 +QDMPCFG:1,117.161.2.7,5683,420 +QDMPCFG:2,M100000089,95Go****,1,863703030822519 OK //关闭 DM 功能。 AT+QDMPCFG=0,0 OK //查询 DM 功能模式。 AT+QDMPCFG=4,0 +QDMPCFG: 0,0 OK //设置 DM 平台 IP 地址，端口和心跳（更新）周期。 AT+QDMPCFG=1,117.161.2.7,5683,420 OK //查询 DM 平台 IP 地址，端口和心跳（更新）周期。 AT+QDMPCFG=4,1 +QDMPCFG: 1,117.161.2.7,5683,420 OK //设置 APPKEY，密钥，终端类型和终端 IMEI。 AT+QDMPCFG=2,'M100000089','77GaaTUi33nUK05ha528888QFbk0Y38M',1,863703030822519 OK //查询设置 APPKEY，密钥，终端类型和终端 IMEI。 AT+QDMPCFG=4,2 +QDMPCFG: 2,M100000089,77Ga****,1,863703030822519 OK //擦除 Flash 中保存的所有配置信息。 AT+QDMPCFG=5,4 OK //查询 DM 接入状态。 AT+QDMPCFG=6 +QDMPCFG: 6,6 //注册成功。 上海移远通信技术股份有限公司 14 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 OK AT+QDMPCFG=6 +QDMPCFG: 6,11 OK //更新成功。 备注 以上示例主要用于说明 AT 命令的使用，而非实际操作流程。 3.2. AT+QDMPCFGEX DM 平台接入配置扩展 该命令用于配置和查询终端设备信息资源配置，如应用信息、MAC 地址、ROM、RAM 和 CPU 等，具 体请参考《多形态终端上报接口规范》V2.0.3。 设置命令用于保存或擦除模块保存的终端设备信息资源配置。 请参阅 第 4 章，查找相关 错误码。 AT+QDMPCFGEX 测试命令 AT+QDMPCFGEX=? DM 平台接入配置扩展 响应 +QDMPCFGEX: ,[,[,[,,]]] OK 设置命令 AT+QDMPCFGEX=,[,[,[,,]]] 响应 若有参数输出： ,[,[,,]] OK 若无参数输出： OK 若出现任何错误： ERROR 或者 +CME ERROR: 上海移远通信技术股份有限公司 15 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 参数 整型。配置类型。不同配置类型对应不同的终端设备信息。 0 配置终端应用信息。 1 配置终端 MAC 地址。 2 配置终端 ROM、RAM、CPU 和操作系统版本信息。 3 配置终端软件版本和名称。 4 配置终端 VOLTE 状态，网络类型，账号和电话号码。 5 配置终端位置信息。 0 - - - 1 - - - 2 3 - - 4 5 - - - 整型。操作类型。 0 保存信息到模块，后面需带参数 1 从模块读取信息，后面不需带参数 2 从模块擦除信息，后面不需带参数 终端应用信息。设置命令中需用双引号标记。支持的最大长度为 255 字节。应用信息是 APP 集合，每条日志用英文分号分隔，每条日志包含 APP 名称、包名、APP 使用时长 （单位：毫秒）、APP 开启次数，由'|'分隔，最多支持 16 条日志。默认为 'NULL'。 终端 MAC 地址信息。设置命令中需用双引号标记。支持的最大长度为 19 字节。默认为 'NULL'。 终端 ROM 信息。设置命令中需用双引号标记。支持的最大长度为 19 字节。默认为 'NULL'。 终端 RAM 信息。设置命令中需用双引号标记。支持的最大长度为 19 字节。默认为 'NULL'。 终端 CPU 信息。设置命令中需用双引号标记。支持的最大长度为 19 字节。默认为 'NULL'。 终端操作系统版本信息。设置命令中需用双引号标记。支持的最大长度为 47 字节。默认 为'NULL'。 终端软件版本信息。设置命令中需用双引号标记。支持的最大长度为 47 字节。默认为 'NULL'。 终端软件名称信息。设置命令中需用双引号标记。支持的最大长度为 47 字节。默认为 'NULL'。 终端 VoLTE 状态信息。设置命令中需用双引号标记。支持的最大长度为 7 字节。默认为 'NULL'。 终端网络类型信息。设置命令中需用双引号标记。支持的最大长度为 19 字节。默认为 'NULL'。 终端网络账号信息。设置命令中需用双引号标记。支持的最大长度为 47 字节。默认为 'NULL'。 终端电话号码信息。设置命令中需用双引号标记。支持的最大长度为 19 字节。默认为 上海移远通信技术股份有限公司 16 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 'NULL'。 终端位置信息。设置命令中需用双引号标记。支持的最大长度为 255 字节。默认为 'NULL'。 举例 //配置终端应用信息。 AT+QDMPCFGEX=0,0,'Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551 ;Alipay|FW88|22650|5555;Zhihu|FW333|77750|65101' OK //查询终端应用信息。 AT+QDMPCFGEX=0,1 +QDMPCFGEX: 0,Douyin|FW1|990650|9123;Wechat|FW02|80650|9201;QQ|FW03|11650|92551;Alip ay|FW88|22650|5555;Zhihu|FW333|77750|65101 OK //擦除终端应用信息。 AT+QDMPCFGEX=0,2 OK //配置终端 MAC 地址信息。 AT+QDMPCFGEX=1,0,'00-01-6C-06-A6-29' OK //查询终端 MAC 地址信息。 AT+QDMPCFGEX=1,1 +QDMPCFGEX: 1,00-01-6C-06-A6-29 OK //擦除终端 MAC 地址信息。 AT+QDMPCFGEX=1,2 OK //配置终端 ROM、 RAM、CPU 和操作系统信息。 AT+QDMPCFGEX=2,0,'8192KB','4096KB','RDA8909B','SX RTOS' OK //查询终端 ROM、 RAM、CPU 和操作系统信息。 AT+QDMPCFGEX=2,1 +QDMPCFGEX: 2,8192KB,4096KB,RDA8909B,SX RTOS 上海移远通信技术股份有限公司 17 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 OK //擦除终端 ROM、 RAM、CPU 和操作系统信息。 AT+QDMPCFGEX=2,2 OK //配置终端软件版本和名称。 AT+QDMPCFGEX=3,0,'BC32B8R01A01','Quectel' OK //查询终端软件版本和名称。 AT+QDMPCFGEX=3,1 +QDMPCFGEX: 3,BC32B8R01A01,Quectel OK //擦除终端软件版本和名称。 AT+QDMPCFGEX=3,2 OK //终端 VOLTE 状态、网络类型，网络账号和电话号码。 AT+QDMPCFGEX=4,0,'off','NB-IoT','XY05553867549','18009699999' OK //查询终端 VOLTE 状态、网络类型，网络账号和电话号码。 AT+QDMPCFGEX=4,1 +QDMPCFGEX: 4,off,NB-IoT,XY05553867549,18009699999 OK //擦除配置终端 VOLTE 状态、网络类型，网络账号和电话号码。 AT+QDMPCFGEX=4,2 OK //配置终端位置信息。 AT+QDMPCFGEX=5,0,'31.8438799075,117.2025477950,OTDOA' OK //查询终端位置信息。 AT+QDMPCFGEX=5,1 +QDMPCFGEX: 5,31.8438799075,117.2025477950,OTDOA OK 上海移远通信技术股份有限公司 18 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 //擦除终端位置信息。 AT+QDMPCFGEX=5,2 OK 备注 以上示例主要用于说明 AT 命令的使用，而非实际操作流程。 上海移远通信技术股份有限公司 19 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 4 错误码 本章主要介绍了与 BC35-G、BC28、BC95 R2.0 和 BC39 模块相关的错误码。 以下两个表中列出的错误码符合 3GPP 规范。所有可能出现的 错误码，请参考《3GPP TS 27.007 V13.5.0》的子章节 9.2。 表 1：通用错误码（27.007） 错误码 3 4 5 23 30 50 51 52 100 159 描述 说明 Operation not allowed 操作不被允许 Operation not supported 不支持该操作 Need to enter PIN 需要输入 PIN Memory failure 内存故障 No network service 无网络服务 Incorrect parameters 参数不正确 Command implemented but currently disabled 命令被已执行但当前被禁用 Command aborted by user 命令被终止 Unknown 未知错误 Uplink busy/flow control 上行链路忙/流控 表 2：通用错误码（27.005） 错误码 300 301 302 描述 ME failure SMS service of ME reserved Operation not allowed 说明 ME 故障 ME 保留的短信服务 操作不被允许 上海移远通信技术股份有限公司 20 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 303 Operation not supported 不支持该操作 304 Invalid PDU mode parameter 无效的 PDU 模式参数 305 Invalid text mode parameter 无效的 text 模式参数 310 USIM not inserted 未插入 USIM 卡 311 USIM PIN required 需要输入 USIM PIN 312 PH-USIM PIN required 需要输入 PH-USIM PIN 313 USIM failure USIM 故障 314 USIM busy USIM 忙 315 USIM wrong USIM 错误 316 USIM PUK required 需要输入 USIM PUK 317 USIM PIN2 required 需要输入 USIM PIN2 318 USIM PUK2 required 需要输入 USIM PUK2 320 Memory failure 内存故障 321 Invalid memory index 无效的内存索引 322 Memory full 内存已满 330 SMSC address unknown 未知的 SMSC 地址 331 No network service 无网络服务 332 Network timeout 网络超时 340 No +CNMA acknowledgement expected 预计无 +CNMA 确认 500 Unknown error 未知错误 以下错误码是 BC35-G、BC28、BC95 R2.0 和 BC39 模块的特定错误码。错误码 512 是之前的错误码 256，错误码 513 是之前的错误码 257。 表 3：特定错误码 错误码 512 513 描述 Required parameter not configured TUP not registered 说明 必要的参数未配置 TUP 未注册 上海移远通信技术股份有限公司 21 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 514 AT internal error AT 内部错误 515 CID is active CID 处于激活状态 516 Incorrect state for command 命令状态错误 517 CID is invalid CID 无效 518 CID is not active CID 处于未激活状态 520 Deactivate the last active CID 停用上次激活的 CID 521 CID is not defined CID 未被定义 522 UART parity error UART 奇偶校验错误 523 UART frame error UART 帧错误 524 UE is in minimal function mode (AT+CFUN=0) UE 处于最小功能模式（AT+CFUN=0） 525 AT command aborted: in processing AT 命令中止：处理中 526 AT command aborted: error AT 命令中止：错误 527 Command interrupted 命令被中断 528 Configuration conflicts 配置冲突 529 During FOTA updating FOTA 升级中 530 Not the AT allocated socket 不是 AT 分配的 Socket 531 USIM PIN is blocked USIM PIN 被锁定 532 USIM PUK is blocked USIM PUK 被锁定 备注 AT+CMEE= 命令禁用（=0）或启用（=1）最终结果码 +CME ERROR: 。当 =1， 发生错误时将返回一组有限的错误码；当 =0 时，发生错误时仅返回 ERROR。更多详细信息，请参 考《Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册》 上海移远通信技术股份有限公司 22 / 23 BC35-G&BC28&BC95 R2.0&BC39 中国移动 DM 平台接入指导 5 附录 A 参考文档及术语缩写 表 4：参考文档 序号 文档名称 [1] Quectel_BC35-G&BC28&BC95 R2.0_AT 命令手册 备注 BC35-G、BC28、BC95 R2.0 模块的 AT 命令手册 表 5：术语缩写 缩写 APP CPU DMP DM IMEI IP PLMN ROM RAM UE NB-IoT MAC 英文全称 Application Central Processing Unit Device Management Platform Device Management International Mobile Equipment Identity Internet Protocol Public Land Mobile Network Read-Only Memory Random Access Memory User Equipment Narrow Band Internet of Things Media Access Control 中文全称 应用程序 中央处理器 中国移动终端设备管理平台 设备管理 国际移动设备识别码 互联网协议 公共陆地移动网络 只读存储器 随机存取存储器 用户设备 窄带物联网 媒体访问控制 上海移远通信技术股份有限公司 23 / 23

EP06&EG06&EM06 DFOTA User Guide LTE-A Module Series Rev. EP06&EG06&EM06_DFOTA_User_Guide_V1.0 Date: 2018-08-31 Status: Released www.quectel.com LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 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://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.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. EP06&EG06&EM06_DFOTA_User_Guide 1 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide About the Document History Revision 1.0 Date 2018-08-31 Author Ramos ZHANG/ Mayra XU Description Initial EP06&EG06&EM06_DFOTA_User_Guide 2 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 2 Firmware Upgrade Procedure via DFOTA......................................................................................... 6 2.1. Get Delta Firmware Package .................................................................................................. 7 2.2. Put Delta Package on FTP/HTTP(S) Server........................................................................... 7 2.3. Execute AT Command to Upgrade the Firmware ................................................................... 7 3 Description of DFOTA AT Commands............................................................................................... 8 3.1. AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on an FTP Server 8 3.2. AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on an HTTP(S) Server ................................................................................................................................... 10 3.3. AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on the Local File System................................................................................................................................. 11 4 Abnormalities and Important Note................................................................................................... 13 4.1. Abnormalities......................................................................................................................... 13 4.1.1. Wrong Delta Firmware Package ..................................................................... 13 4.1.2. Failure of Firmware Upgrade........................................................................... 13 4.2. Important Note....................................................................................................................... 14 5 Summary of Error Codes .................................................................................................................. 15 6 Appendix A References..................................................................................................................... 16 EP06&EG06&EM06_DFOTA_User_Guide 3 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide Table Index TABLE 1: SUMMARY OF , AND CODES ................................................ 15 TABLE 2: TERMS AND ABBREVIATIONS ........................................................................................................ 16 EP06&EG06&EM06_DFOTA_User_Guide 4 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 1 Introduction Quectel EP06&EG06&EM06 modules support DFOTA (Delta Firmware Upgrade Over-the-air) function, which allows customers to upgrade the firmware over the air. It can upgrade the firmware to a new version and revert to the old version as well. Before firmware upgrading, customers only need to prepare the firmware package which contains the differences between the original and target firmware versions. This reduces the amount of data transmitted and accelerates the speed of firmware upgrade. This document is applicable to Quectel EP06&EG06&EM06 modules. EP06&EG06&EM06_DFOTA_User_Guide 5 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 2 Firmware Upgrade Procedure via DFOTA The following chart illustrates the firmware upgrade procedure via DFOTA. 2. Put the package on FTP/HTTP(S) server FTP/HTTP(S) Server 1. Get delta firmware package LTE/WCDMA/ (FTP/HTTP(S)) 4. Automatically download from FTP/HTTP(S) server via LTE/WCDMA network Ext. MCU 3. Execute AT+QFOTADL command Quectel Module 5. Automatically upgrade the module’s firmware Figure 1: Firmware Upgrade Procedure via DFOTA EP06&EG06&EM06_DFOTA_User_Guide 6 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide As shown in the above figure, customers only need to perform the following steps to upgrade the firmware. Step 1: Get the delta firmware package from Quectel. Step 2: Put the delta firmware on FTP/HTTP(S) server. Step 3: Execute AT+QFOTADL command. Then the module will automatically download the package from FTP/HTTP(S) server via LTE/WCDMA network (Step 4) and finally automatically upgrade the module’s firmware (Step 5). 2.1. Get Delta Firmware Package Before upgrading, customers need to check the current firmware version (the original version) by executing ATI command, and also need to know the target firmware version. Then the two firmware versions should be provided for Quectel or the module supplier in order to get the delta firmware package. 2.2. Put Delta Package on FTP/HTTP(S) Server When using the DFOTA function, customers need to set up an FTP/HTTP(S) server by themselves, for Quectel does not provide such a server. Then please put the delta firmware package on the server, and record the FTP/HTTP(S) path. The module will get the delta package from the path after executing corresponding AT command. 2.3. Execute AT Command to Upgrade the Firmware After putting the delta firmware package on the FTP/HTTP(S) server, customers need to execute AT+QFOTADL command. Then the module will download the firmware package from the FTP/HTTP(S) server over the air and upgrade the firmware automatically. For more details, please refer to Chapter 3. EP06&EG06&EM06_DFOTA_User_Guide 7 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 3 Description of DFOTA AT Commands AT+QFOTADL command enables automatic firmware upgrade for the module via DFOTA. After executing the command, the module will automatically download the package from FTP/HTTP(S) server, reboot automatically and then enter into recovery mode. When the upgrade package is checked OK and the firmware upgrade is successful, the module will reboot and enter into normal mode. AT+QFOTADL Upgrade Firmware via DOFTA Test Command AT+QFOTADL=? Response OK 3.1. AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on an FTP Server If the delta firmware package is stored on an FTP server, AT+QFOTADL= should be executed to enable automatic firmware upgrade via DFOTA. Then the module will download the delta package from the FTP server over the air and upgrade the firmware automatically. AT+QFOTADL= FTP Server Write Command AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on an Response OK +QIND: 'FOTA','FTPSTART' +QIND: 'FOTA','FTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', If there is any error, response: ERROR EP06&EG06&EM06_DFOTA_User_Guide 8 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide Parameter String type. The URL of the FTP server. The maximum length is 255 bytes. It should be started with 'ftp://'. For example: 'ftp://: @:/'. String type. The user name for authentication. String type. The password for authentication. String type. The IP address or domain name of the FTP server. Integer type. The port of the FTP server. The default value is 21. The range is 1-65535. String type. The file name on FTP server. Integer type. The FTP error code. 0 means the upgrade is successful. Please refer to Chapter 5 for details. Integer type. The upgrade progress in percentage. Integer type. 0 means firmware upgrade successful. Any other value means an error. Please refer to Chapter 5 for details. Example //Upgrade the firmware when the delta firmware package is stored on an FTP server. //The FTP server address is 'ftp://test:test@124.74.41.170:21/Jun/update-v12-to-v13.zip'. //Execute AT+QFOTADL command to enable automatic firmware upgrade via DFOTA, and then the module will start to download the delta package and upgrade firmware automatically. AT+QFOTADL='ftp://test:test@124.74.41.170:21/Jun/update-v12-to-v13.zip' OK +QIND: 'FOTA','FTPSTART' //Start to download the delta package from the FTP server. +QIND: 'FOTA','FTPEND',0 //Finish downloading the delta package. //The module will reboot automatically and the USB port will be re-initialized. If the current port is USB port, then the MCU should close and reopen it. +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //Start to upgrade the firmware. //The firmware is upgraded successfully. EP06&EG06&EM06_DFOTA_User_Guide 9 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 3.2. AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on an HTTP(S) Server If the delta firmware package is stored on an HTTP(S) server, AT+QFOTADL= command should be executed to enable automatic firmware upgrade via DFOTA. Then the module will download the delta package from the HTTP(S) server over the air and upgrade the firmware automatically. AT+QFOTADL= HTTP(S) Server Write Command AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on an Response OK +QIND: 'FOTA','HTTPSTART' +QIND: 'FOTA','HTTPEND', +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', If there is any error, response: ERROR Parameter String type. The maximum length is 255 bytes. It should be started with 'http://' or 'https://'. For example: 'http://:/'. String type. The IP address or domain name of the HTTP(S) server. Integer type. The port of the HTTP(S) server. The default value is 80. The range is 1-65535. String type. The file name in HTTP(S) server. Integer type. The HTTP(S) error code. 0 means upgraded successfully. Please refer to Chapter 5 for details. Integer type. The upgrade progress in percentage. Integer type. 0 means firmware upgrade successful. Any other value means an error. Please refer to Chapter 5 for details. Example //Upgrade the firmware when the delta firmware package is stored on an HTTP server. //The HTTP server address is 'http://www.quectel.com:100/update.zip'. //Execute AT+QFOTADL command to enable automatic firmware upgrade via DFOTA, and then the EP06&EG06&EM06_DFOTA_User_Guide 10 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide module will start to download the delta package and upgrade firmware automatically. AT+QFOTADL='http://www.quectel.com:100/update.zip' OK +QIND: 'FOTA','HTTPSTART' //Start to download the delta package from the HTTP server. +QIND: 'FOTA','HTTPEND',0 //Finish downloading the delta package. //The module will be rebooted automatically and the USB port will be re-initialized. If the current port is USB port, then the MCU should close and reopen it. +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //Start to upgrade the firmware. //The firmware is upgraded successfully.. 3.3. AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on the Local File System If the delta firmware package has already been stored in the module’s file system, AT+QFOTADL= command should be executed to enable automatic firmware upgrade via DFOTA. Then the module will download the delta package from the local file system and upgrade the firmware automatically. AT+QFOTADL= Local File System Write Command AT+QFOTADL= Upgrade Firmware When Delta Package is Stored on the Response OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING', +QIND: 'FOTA','UPDATING', ... +QIND: 'FOTA','END', If there is any error, response: ERROR EP06&EG06&EM06_DFOTA_User_Guide 11 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide Parameter String type. The maximum length is 90 bytes. It should be started with '/data/ufs/' in UFS. Integer type. The upgrade progress in percentage. Integer type. 0 means firmware upgrade successful. Any other value means an error. Please refer to Chapter 5 for details. Example //Upgrade the firmware when the delta firmware package is stored on the local file system. AT+QFOTADL='/data/ufs/update-v13-to-v12.zip' OK +QIND: 'FOTA','START' +QIND: 'FOTA','UPDATING',1 +QIND: 'FOTA','UPDATING',2 ... +QIND: 'FOTA','UPDATING',100 +QIND: 'FOTA','END',0 //Start to upgrade the firmware. //The firmware is upgraded successfully. EP06&EG06&EM06_DFOTA_User_Guide 12 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 4 Abnormalities and Important Note 4.1. Abnormalities 4.1.1. Wrong Delta Firmware Package After executing AT+QFOTADL command and the delta firmware package is downloaded, the module will reboot automatically and then enter into recovery mode. The module checks the upgrade package first, if there is something wrong with the package, the URC (+QIND: 'FOTA','END',) of an error code (504, 505 or 510) will be reported, then the module will reboot automatically, enter into recovery mode and re-check the package for maximally five times. If the package is still wrong after five retries, the module will reboot and enter into normal mode. In such case, please confirm the delta firmware package and re-put it on FTP/HTTP(S) server. 4.1.2. Failure of Firmware Upgrade After the upgrade package is checked OK, then it starts to upgrade firmware. If it is failed to upgrade the firmware, the URC (+QIND: 'FOTA','END',) of an error code (502, 511, 520-530 or 540-546) will be reported, then the module will reboot automatically, enter into recovery mode and retry to upgrade for maximally five times. If upgrade is still unsuccessful after five retries, the module will stop firmware upgrade and restore to the original version. NOTE During an upgrading process, once the delta firmware package is downloaded, the module can only retry for maximally five times in total, among which retry times for package checking and firmware upgrading are both included. As mentioned in Chapter 2, it is a completely automatic process after executing AT+QFOTADL command. Therefore, any +QIND: 'FOTA','END', URCs sent from the module to the Ext. MCU can be ignored. EP06&EG06&EM06_DFOTA_User_Guide 13 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 4.2. Important Note The URC of +QIND: 'FOTA','START' indicates the firmware upgrade process really starts. If the Ext. MCU receives this URC after executing AT+QFOTADL command, please do NOT power off the module until the firmware is upgraded successfully and +QIND: 'FOTA','END',0 is received. Then the module will reboot and enter into normal mode automatically. During upgrading process, if the Ext. MCU does not receive any URC in four minutes after the last URC is returned, then the module can be rebooted. Meanwhile, it is recommended to set a flag on Ext. MCU to mark the task of the firmware upgrading and clean it after successful upgrading. EP06&EG06&EM06_DFOTA_User_Guide 14 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 5 Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about , and are described in the following table. Table 1: Summary of , and Codes 0 601 0 701 0 502 504 505 510 511 520-530, 540-546 Meaning FTP download operation successful FTP unknown error Meaning HTTP(S) download operation successful HTTP(S) unknown error Meaning Firmware upgrade successful The upgrade process exits for some unpredictable errors. Something wrong with the upgrade package file Something wrong with the upgrade package file The patch does not match the source file in the module, need to check whether the upgrade package is wrong. The file system has no enough space for upgrading. Firmware upgrade failed EP06&EG06&EM06_DFOTA_User_Guide 15 / 16 LTE-A Module Series EP06&EG06&EM06 DFOTA User Guide 6 Appendix A References Table 2: Terms and Abbreviations Abbreviation DFOTA Ext. MCU FTP GPRS HTTP(S) LTE UFS WCDMA Description Delta Firmware Upgrade Over the Air External Microprogrammed Control Unit File Transfer Protocol General Packet Radio Service Hyper Text Transport Protocol (Secure) Long Term Evolution User File System Wideband Code Division Multiple Access EP06&EG06&EM06_DFOTA_User_Guide 16 / 16

BC95&BC35-G&BC28 RAI 应用指导 NB-IoT 系列 版本：BC95&BC35-G&BC28_RAI_应用指导_V1.0 日期：2018-05-15 状态：受控文件 www.quectel.com BC95&BC35-G&BC28 RAI 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录： http://quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2018，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2018. 上海移远通信技术股份有限公司 1 / 11 BC95&BC35-G&BC28 RAI 应用指导 文档历史 修订记录 版本 日期 作者 1.0 2018-05-15 王成钧 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 11 BC95&BC35-G&BC28 RAI 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 RAI 功能相关 AT 命令........................................................................................................................... 6 2.1. RAI 功能相关 AT 命令 ................................................................................................................ 6 2.1.1. AT+NSOSTF 发送 UDP 数据并携带标志位 ................................................................... 6 2.1.2. AT+QLWULDATAEX 发送 CON/NON 数据.................................................................... 7 3 RAI 功能操作示例 ................................................................................................................................. 9 3.1. 发送 UDP 数据并携带标志位...................................................................................................... 9 3.2. 发送 CoAP CON/NON 数据 ..................................................................................................... 10 4 附录 A.................................................................................................................................................. 11 上海移远通信技术股份有限公司 3 / 11 BC95&BC35-G&BC28 RAI 应用指导 表格索引 表 1：参考文档 ............................................................................................................................................11 表 2：术语缩写 ............................................................................................................................................11 上海移远通信技术股份有限公司 4 / 11 BC95&BC35-G&BC28 RAI 应用指导 1 引言 移远通信 NB-IoT 模组支持 RAI（辅助释放指示）功能，模组在发送数据时携带 RAI 指示标志，核心网 根据该指示标志释放 RRC 连接，以便模组快速进入 Idle 状态，从而节省功耗并在小区重选功能开启时可以 快速进行临近小区信号测量。本文档描述了 RAI 功能相关 AT 命令，并通过操作示例详细介绍了如何使用 RAI 功能。 本文档适用于移远通信 NB-IoT BC95、BC35-G 和 BC28 模组。 上海移远通信技术股份有限公司 5 / 11 BC95&BC35-G&BC28 RAI 应用指导 2 RAI 功能相关 AT 命令 模组发送上行数据时携带 RAI 指示标志，核心网根据此指示标志来决定是否需要立即释放当前 RRC 连 接状态，具体指示标志有两种： ⚫ 当前数据发送完成后，后续没有上行或下行数据，则立即释放 RRC 连接； ⚫ 当前数据发送完成后，仅有一条下行数据（如应答或对上行数据的响应），且后续没有其他上行 数据交互，则立即释放 RRC 连接。 2.1. RAI 功能相关 AT 命令 2.1.1. AT+NSOSTF 发送 UDP 数据并携带标志位 通过 AT+NSOSTF 命令向远端服务器发送 UDP 数据并携带标志位。 AT+NSOSTF 发送 UDP 数据并携带标志位 设置命令 AT+NSOSTF=,,,,, 响应 , OK 最大响应时间 如果出现错误，响应： ERROR 或 +CME ERROR: 300 毫秒 参数 通过 AT+NSOCR 建立的 Socket IPv4 地址 点分表示的 IP 地址 远端服务器 UDP 端口号。范围为 0-65535。 标志位，十六进制格式表示；若需要同时设置多个标志，则该参数由各标志位进行 逻辑或运算（OR）得到。 0 不设置任何标志位 上海移远通信技术股份有限公司 6 / 11 BC95&BC35-G&BC28 RAI 应用指导 0x100 特殊消息数据，以高优先级发送。该功能需要 USIM 支持。 0x200 RRC 连接释放指示：上行数据发送完成后，指示核心网立即释放连接 0x400 RRC 连接释放指示：上行数据发送完成并收到下行数据回复后，指示核心 网立即释放连接 已发送数据长度；以十进制表示。最大数据长度为 512 字节。 已接收的数据；以十六进制字符串或带引号的字符串格式表示。 备注 1. 支持八进制、十进制或十六进制表示法。 2. 仅支持 IPv4 地址。 3. 目前仅支持十六进制字符串格式。 4. 关于此命令的更多详情，请参考文档 [1]&[2]。 2.1.2. AT+QLWULDATAEX 发送 CON/NON 数据 通过 AT+QLWULDATAEX 命令可向华为 IoT 平台发送携带辅助释放指示的 CoAP CON (Confirmable) 数据或 NON (Non-confirmable) 数据。 AT+QLWULDATAEX 发送 CON/NON 数据 设置命令 AT+QLWULDATAEX=, , 响应 OK 如果出现错误，响应： ERROR 或 +CME ERROR: 最大响应时间 300 毫秒 参数 已发送数据长度；以十进制表示。最大数据长度为 512 字节。 已接收的数据；以十六进制字符串表示。 发送的 CON/NON 数据模式 0x0000：发送 NON 数据 0x0100：发送 CON 数据 0x0001：发送 NON 数据，带 RELEASE 标记 0x0101：发送 CON 数据，带 RELEASE_AFTER_REPLY 标记 上海移远通信技术股份有限公司 7 / 11 BC95&BC35-G&BC28 RAI 应用指导 备注 1. 针对 BC95 模组，值 0x0001 和 0x0101 仅在 B657SP5 或之后版本上支持。 2. 发送 CON 消息之后，必须在收到响应或发送超时之后才能发送下一条 CON/NON 消息。 3. 关于此命令的更多详情，请参考文档 [1]&[2]。 上海移远通信技术股份有限公司 8 / 11 BC95&BC35-G&BC28 RAI 应用指导 3 RAI 功能操作示例 3.1. 发送 UDP 数据并携带标志位 执行 AT+CSCON 命令使能 URC 上报功能，通过 URC 的上报状态，可判断标志位是否生效。 [13:38:08:105]AT+CSCON=1 [13:38:08:121]OK [13:38:08:344] [13:38:08:344]+CSCON:0 [13:38:24:470]AT+NSOCR=DGRAM,17,1234,1 [13:38:24:502]0 //使能 URC 上报功能 //创建 UDP socket [13:38:24:518]OK [13:38:28:717]AT+NSOSTF=0,220.180.239.212,8052,0x400,2,AB30 //使用 0x400 标志位发送数据 [13:38:28:765]0,2 [13:38:28:765]OK [13:38:29:340] [13:38:29:340]+CSCON:1 [13:38:29:611] [13:38:29:611]+NSONMI:0,2 [13:38:29:931] [13:38:29:931]+CSCON:0 [13:38:37:244]AT+NSORF=0,512 [13:38:37:276]0,220.180.239.212,8052,2,AB30,0 //收到下行数据后，立即释放 RRC 连接 //读出下行数据 [13:38:37:307]OK [13:38:56:275]AT+NSOSTF=0,220.180.239.212,8052,0x200,2,AB30 [13:38:56:323]0,2 //使用 0x200 标志位发送数据 [13:38:56:339]OK [13:38:58:782] [13:38:58:782]+CSCON:1 [13:38:59:086] [13:38:59:086]+CSCON:0 //建立 RRC 连接，并开始发送数据 //数据发送完毕后，立即释放 RRC 连接 上海移远通信技术股份有限公司 9 / 11 BC95&BC35-G&BC28 RAI 应用指导 3.2. 发送 CoAP CON/NON 数据 执行 AT+CSCON 命令使能 URC 上报功能，通过 URC 的上报状态，可判断 RAI 功能是否生效。 [14:17:35:307]AT+CSCON=1 [14:17:35:322]OK [14:17:45:876] [14:17:45:876]+CSCON:0 [14:17:53:301]AT+NCDP? [14:17:53:301]+NCDP:180.101.147.115,5683 //使能 URC 上报功能 //IoT 平台服务器地址 [14:17:53:333]OK [14:18:03:920]AT+QLWULDATAEX=3,AA34BB,0x0001 //使用 0x0001 标志位发送 NON CoAP 数据 [14:18:05:404]OK [14:18:05:532] [14:18:05:532]+CSCON:1 //建立 RRC 连接，并开始发送数据 [14:18:05:947] [14:18:05:947]+CSCON:0 //数据发送完毕后，立即释放 RRC 连接 [14:21:06:880]AT+QLWULDATAEX=3,AA34BB,0x0101 //使用 0x0101 标志位发送 CON CoAP 数据 [14:21:06:911]OK [14:21:07:933] [14:21:07:933]+CSCON:1 //建立 RRC 连接，并开始发送数据 [14:21:08:221] [14:21:08:221]+QLWULDATASTATUS:4 //CON CoAP 数据被平台确认收到 [14:21:09:179] [14:21:09:179]+CSCON:0 //数据发送完毕后，立即释放 RRC 连接 上海移远通信技术股份有限公司 10 / 11 BC95&BC35-G&BC28 RAI 应用指导 4 附录 A 表 1：参考文档 SN 文档名称 描述 [1] Quectel_BC95_AT_Commands_Manual BC95 AT Commands Manual [2] Quectel_BC35-G&BC28_AT_Commands_Manual BC35-G&BC28 AT Commands Manual 表 2：术语缩写 缩写 CoAP RAI RRC UDP URC 描述 Constrained Application Protocol Release Assistance Indication Radio Resource Control User Datagram Protocol Unsolicited Result Code 上海移远通信技术股份有限公司 11 / 11

EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 LTE Standard 模块系列 版本：1.0 日期：2020-08-21 状态：受控文件 www.quectel.com EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 文档历史 修订记录 版本 日期 作者 1.0 2020-08-21 刘康康 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 1.1. 适用模块 ..................................................................................................................................... 6 1.2. AT 命令语句................................................................................................................................ 7 1.2.1. 定义 ................................................................................................................................. 7 1.2.2. AT 命令语句 .................................................................................................................... 7 1.3. FTP(S)命令使用流程 .................................................................................................................. 7 1.4. 数据模式说明.............................................................................................................................. 9 2 FTP(S) AT 命令详解 ........................................................................................................................... 10 2.1. AT+QFTPCFG 配置 FTP(S)服务器参数................................................................................ 10 2.2. AT+QFTPOPEN 登录 FTP(S)服务器 .................................................................................... 13 2.3. AT+QFTPCWD 配置 FTP(S)服务器当前目录 ....................................................................... 14 2.4. AT+QFTPPWD 获取 FTP(S)服务器当前目录........................................................................ 15 2.5. AT+QFTPPUT 上传文件至 FTP(S)服务器............................................................................. 16 2.6. AT+QFTPGET 从 FTP(S)服务器下载文件 ............................................................................ 19 2.7. AT+QFTPSIZE 获取 FTP(S)服务器文件大小 ........................................................................ 21 2.8. AT+QFTPDEL 删除 FTP(S)服务器文件................................................................................. 22 2.9. AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 ........................................................................ 23 2.10. AT+QFTPRMDIR 删除 FTP(S)服务器文件夹........................................................................ 23 2.11. AT+QFTPLIST 获取 FTP(S)服务器目录内容......................................................................... 24 2.12. AT+QFTPNLST 获取 FTP(S)服务器目录文件名 ................................................................... 26 2.13. AT+QFTPMLSD 获取标准化文件和目录信息........................................................................ 28 2.14. AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 .............................................................. 29 2.15. AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹...................................................... 30 2.16. AT+QFTPLEN 获取传输数据长度 ......................................................................................... 31 2.17. AT+QFTPSTAT 获取 FTP(S)服务器状态............................................................................... 32 2.18. AT+QFTPCLOSE 退出 FTP(S)服务器 .................................................................................. 32 3 举例 ..................................................................................................................................................... 34 3.1. 登录 FTP 服务器....................................................................................................................... 34 3.2. 登录 FTPS 服务器 .................................................................................................................... 35 3.3. 文件夹操作 ............................................................................................................................... 36 3.4. 文件操作 ................................................................................................................................... 36 3.5. 获取文件信息或文件名 ............................................................................................................. 37 3.6. 上传文件至 FTP(S)服务器........................................................................................................ 38 3.7. 从 FTP(S)服务器下载文件........................................................................................................ 41 3.8. 退出 FTP(S)服务器................................................................................................................... 43 4 常见问题处理....................................................................................................................................... 44 4.1. FTP(S) AT 命令执行失败.......................................................................................................... 44 上海移远通信技术股份有限公司 3 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 4.2. PDP 激活失败........................................................................................................................... 44 4.3. DNS 解析失败 .......................................................................................................................... 44 4.4. FTP(S)服务器响应错误 ............................................................................................................ 45 5 错误码 ................................................................................................................................................. 46 6 FTP(S)协议错误码 .............................................................................................................................. 48 7 附录 A 参考文档和术语缩写 .............................................................................................................. 49 上海移远通信技术股份有限公司 4 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 表格索引 表 1：适用模块 .................................................................................................................................................... 6 表 2：AT 命令及响应类型 .................................................................................................................................... 7 表 3：错误码列表............................................................................................................................................... 46 表 4：FTP(S)协议错误码列表............................................................................................................................ 48 表 5：参考文档 .................................................................................................................................................. 49 表 6：术语缩写 .................................................................................................................................................. 49 上海移远通信技术股份有限公司 5 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 1 引言 移远通信 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块支持 FTP 和 FTPS 文件传输协议（下 文简称'FTP(S)'）。 FTP（File Transfer Protocol，文件传输协议）是一种标准的网络协议，用于在计算机网络上的客户端 和服务器之间传输计算机文件，具有很高的传输速率。 FTPS（FTP over SSL 或 FTP Secure）是一种对常用的文件传输协议（FTP）添加传输层安全（TLS） 和安全套接层（SSL）加密协议支持的扩展协议。 本文档主要介绍如何通过 AT 命令应用如下移远通信模块的 FTP(S)功能。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x 系列 EG9x 系列 EG2x-G EM05 系列 模块 EC21 系列 EC25 系列 EC20 R2.1 EC20-CN EG91 系列 EG95 系列 EG21-G EG25-G EM05 系列 上海移远通信技术股份有限公司 6 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 1.2. AT 命令语句 1.2.1. 定义  回车符。  换行符。  参数名称。实际命令行中不包含尖括号。  […] 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。  下划线 参数的默认设置。 1.2.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 2：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 1.3. FTP(S)命令使用流程 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块支持 FTP(S)协议，因此 FTP(S)服务器上的文件 和目录可以通过 FTP(S)相关 AT 命令进行操作。FTP(S)相关 AT 命令使用流程如下： 第一步：配置和激活 PDP 上下文。 1. 使用 AT+QICSGP 配置 PDP 上下文的、、和其他参数，详细信 息可见文档[1]。可通过 AT+CGQMIN、AT+CGEQMIN、AT+CGQREQ 和 AT+CGEQREQ 更新 QoS 设置，详细信息可见文档[2]； 2. 通过 AT+QIACT 激活 PDP 上下文，详细信息可见文档[1]； 3. 通过 AT+QFTPCFG='contextid',配置 FTP(S) PDP 上下文 ID。需提前激活 PDP 上 下文。 上海移远通信技术股份有限公司 7 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 第二步：配置用户账号和 FTP(S)服务器。 1. 通过 AT+QFTPCFG='account',,配置账号信息； 2. 通过 AT+QFTPCFG='filetype',配置文件类型。在 FTP(S)服务器和客户端间传输的 文件类型可以是二进制数据或 ASCII 数据； 3. 通过 AT+QFTPCFG='transmode',配置传输模式，即在 FTP(S)服务器端口或客户 端 端 口 监 听 数 据 连 接 。 请 注 意 ， 因 为 FTPS 当 前 不 支 持 主 动 模 式 ， 必 须 设 置 AT+QFTPCFG='transmode',1 后才能进行 FTPS 操作； 4. 通过 AT+QFTPCFG='rsptimeout',配置命令的最大响应时间； 5. 若模块作为 FTPS 客户端，需执行如下命令： 1） 执行 AT+QFTPCFG='ssltype',1 2） 执行 AT+QFTPCFG='sslctxid',设置 3） AT+QSSLCFG 配置所指定的。详细信息可见文档[3]。 第三步：登录 FTP(S)服务器。 通 过 AT+QFTPOPEN=, 登 录 FTP(S) 服 务 器 ， 命 令 执 行 后 ， 若 响 应 URC +QFTPOPEN: 0,0，表示操作成功。注意 FTPS 和 FTP 端口不同。FTPS 服务器的端口取决于 FTPS 服务器提供商，通常为 990。 第四步：文件操作。 1. 通过 AT+QFTPCWD 设置当前目录； 2. 上传文件至 FTP(S)服务器； 1） 通过 AT+QFUPL 从 RAM、UFS 或 SD 卡目录上传文件，再通过 AT+QFTPPUT 将文件上传 至 FTP(S)服务器。文件上传成功后，可通过 AT+QFDEL 将其删除。详细信息可见文档[4]； 2） 在 COM 口通过 AT+QFTPPUT 将文件上传至 FTP(S)服务器。执行+++可结束文件上传。 3. 通过 AT+QFTPGET 从 FTP(S)服务器下载文件。文件将在 COM 口输出或被保存至 RAM、UFS 或 SD 卡。若 COM 口输出文件，模块将进入数据模式； 4. 通过 AT+QFTPSIZE 获取 FTP(S)服务器文件大小； 5. 通过 AT+QFTPLEN 获取 FTP(S)服务器和客户端之间传输的数据长度； 6. 通过 AT+QFTPDEL 删除 FTP(S)服务器文件； 7. 通过 AT+QFTPRENAME 重命名 FTP(S)服务器文件。 第五步：FTP(S)服务器目录操作。 1. 通过 AT+QFTPCWD 设置当前目录； 2. 通过 AT+QFTPMKDIR 创建文件夹； 3. 通过 AT+QFTPLIST 列出目录内容； 4. 通过 AT+QFTPNLST 列出目录文件名； 5. 通过 AT+QFTPRENAME 重命名文件或文件夹； 6. 通过 AT+QFTPRMDIR 删除文件夹； 7. 通过 AT+QFTPMLSD 列出标准文件和目录信息； 8. 通过 AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间。 第六步：关闭和 FTP(S)服务器的连接。 通过 AT+QFTPCLOSE 关闭和 FTP(S)服务器的连接，命令执行后，若响应 URC +QFTPCLOSE: 0,0， 表明操作成功，即可重复上述第三步至第六步。 上海移远通信技术股份有限公司 8 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 第七步：去激活 PDP 上下文。 通过 AT+QIDEACT=去激活 PDP 上下文，详细信息可见文档[1]。 1.4. 数据模式说明 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块的 COM 口有两种工作模式：一种是 AT 命令模 式，另一种是数据模式。在 AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；在数据模式下， 则被认为是数据。 用户可以通过输入+++或拉高 DTR（需先设置 AT&D1）使 COM 口退出数据模式。为防止+++被误认 为是数据，在使用 COM 口之前应遵循以下标准：  +++输入前 1 秒内不能输入其它任何数据。  必须在 1 秒内输入+++，并且不能输入其它任何数据。  +++输入后 1 秒内不能输入其它任何数据。 在 COM 口执行 AT+QFTPPUT、AT+QFTPGET、AT+QFTPLIST 和 AT+QFTPNLST 时，若本地文件 路径为'COM:'，数据将从 COM 口接收和输出，COM 口会进入数据模式。用户可使用+++或拉高 DTR 退 出数据模式。此外，执行 AT+QFTPGET、AT+QFTPLIST 和 AT+QFTPNLST 后，可使用 ATO 重新进入数 据模式。但执行 AT+QFTPPUT 后，使用 ATO 不能再次进入数据模式。 上海移远通信技术股份有限公司 9 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 2 FTP(S) AT 命令详解 2.1. AT+QFTPCFG 配置 FTP(S)服务器参数 该命令用于配置 FTP(S)服务器参数，包括用户账号、文件类型、传输模式和上下文 ID 等。设置命令 省略可省参数时，将查询当前配置。 AT+QFTPCFG 配置 FTP(S)服务器参数 测试命令 响应 AT+QFTPCFG=? +QFTPCFG: 'account',, +QFTPCFG: 'filetype',(支持的列表) +QFTPCFG: 'transmode',(支持的列表) +QFTPCFG: 'contextid',(支持的范围) +QFTPCFG: 'rsptimeout',(支持的范围) +QFTPCFG: 'ssltype',(支持的范围) +QFTPCFG: 'sslctxid',(支持的范围) +QFTPCFG: 'data_address',(支持的范 围),(支持的范围) 设置命令 AT+QFTPCFG='account'[,,] OK 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'account',, OK 设置命令 AT+QFTPCFG='filetype'[, ] 若指定可选参数，则设置用户账号： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'filetype', OK 若指定可选参数，则设置文件类型： 上海移远通信技术股份有限公司 10 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 设置命令 AT+QFTPCFG='transmode'[,] OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'transmode', OK 设置命令 AT+QFTPCFG='contextid'[,] 若指定可选参数，则设置传输模式： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'contextid', OK 设置命令 AT+QFTPCFG='rsptimeout'[,] 若指定可选参数，则设置上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'rsptimeout', OK 设置命令 AT+QFTPCFG='ssltype'[,] 若指定可选参数，则设置响应超时时间： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'ssltype', OK 若指定可选参数，则设置 SSL 类型： OK 或者 +CME ERROR: 上海移远通信技术股份有限公司 11 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 设置命令 AT+QFTPCFG='sslctxid'[,] 响应 若省略可选参数，则查询当前配置： +QFTPCFG: 'sslctxid', OK 设置命令 AT+QFTPCFG='data_address'[,[,]] 若指定可选参数，则设置 SSL 上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： 1) 若为 2： +QFTPCFG: 'data_address',, OK 2) 若不为 2： +QFTPCFG: 'data_address', OK 最大响应时间 特性说明 若指定任意参数，设置数据连接地址： OK 或者 +CME ERROR: 300 毫秒 该命令立即生效；参数配置不保存 参数 字符串类型。鉴权用户名。最大长度为 255 字节。 字符串类型。鉴权密码。最大长度为 255 字节。 整型。传输数据类型。 0 二进制 1 ASCII 整型。在 FTP(S)服务器端口还是客户端端口上监听数据连接。 0 主动模式，模块将在端口上监听数据连接 1 被动模式，FTP(S)服务器将在端口上监听数据连接 整型。PDP 上下文 ID。范围：1~16。默认值：1。使用 AT+QFTPOPEN 前，应先通 过 AT+QIACT 激活 PDP 上下文。详细信息可见文档{1]。 上海移远通信技术股份有限公司 12 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 整型。范围：20~180。默认值：90。单位：秒。 一般除 AT+QFTPPUT/QFTPGET/QFTPLST/QFTPNLST 外，执行其他命令响应 OK 前 ， 该 参 数 值 为 +QFTPXXX: xx,xx 的 最 大 响 应 时 间 。 该 参 数 对 于 AT+QFTPPUT/QFTPGET/QFTPLST/QFTPNLST 的含义如下： 1） 发送命令后，未响应 CONNECT 前，该参数值表示 CONNECT 的最大响应时间。 2） 模块进入数据模式后，该参数值表示接收或发送两个数据包之间的最大间隔时间。 3） 当不为'COM:'时，该参数值表示接收或发送两个数据包之间的最大 间隔时间。 整型。模块用作 FTP 客户端或 FTPS 客户端。 0 FTP 客户端 1 FTPS 隐式加密 2 FTPS 显式加密 整型。SSL 上下文 ID。范围：0~5。默认值：0。用户可以通过 AT+QSSLCFG 配置 SSL 参数。详细信息可见文档{3]。 整型。FTP(S)数据连接地址选择。 0 使用服务器分配的地址 1 使用 FTP(S)控制会话地址 2 优先使用 FTP(S)控制会话地址。若连接失败，将切换为服务器分配的地址。 整型。当 FTP(S)控制会话地址连接失败时，切换服务器分配的地址所需时间。 仅当为 2 时有效。范围：15~50。默认值：25。单位： 秒。 整型。错误码。详细信息可见第 5 章。 备注 由于 FTPS 当前不支持主动模式，操作 FTPS 时，必须将设置为 1。 2.2. AT+QFTPOPEN 登录 FTP(S)服务器 该命令用于登录 FTP(S 服务器。执行该命令前，需先通过 AT+QIACT 激活 PDP 上下文。+QFTPOPEN: ,表示 AT+QFTPOPEN 的操作结果，应在 AT+QFTPCFG 配置的时间内 输出。 AT+QFTPOPEN 登录 FTP(S)服务器 测试命令 响应 AT+QFTPOPEN=? +QFTPOPEN: , 设置命令 AT+QFTPOPEN=[, OK 响应 OK 上海移远通信技术股份有限公司 13 / 50 ] 最大响应时间 特性说明 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 +QFTPOPEN: , 或者 +CME ERROR: 125 秒 该命令立即生效；参数配置不保存 参数 字符串类型。FTP(S)服务器 IP 地址和域名。最大长度为 200 字节。 整型。FTP(S)服务器端口。默认值：21。范围：1~65535。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可见第 6 章。若为 0，则无效。 举例 AT+QFTPOPEN='101.95.183.122',21 OK +QFTPOPEN: 0,0 AT+QFTPOPEN='quectel.3322.org',990 OK +QFTPOPEN: 0,0 //登录 FTP 服务器。 //登录 FTPS 服务器。 备注 注意 FTPS 和 FTP 服务器端口不同，FTPS 服务器的端口取决于 FTPS 服务器提供商，通常为 990。 2.3. AT+QFTPCWD 配置 FTP(S)服务器当前目录 该命令用于配置 FTP(S)服务器当前目录。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPCWD: ,。所有文件和目录均可在当前目录中进行操 作。 AT+QFTPCWD 配置 FTP(S)服务器当前目录 测试命令 响应 AT+QFTPCWD=? +QFTPCWD: 上海移远通信技术股份有限公司 14 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 设置命令 AT+QFTPCWD= 最大响应时间 特性说明 OK 响应 OK +QFTPCWD: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效；参数配置不保存 参数 字符串类型。FTP(S)服务器目录路径。最大长度为 255 字节。根路径为'/'。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可见第 6 章。若为 0，则无效。 2.4. AT+QFTPPWD 获取 FTP(S)服务器当前目录 该命令用于获取 FTP(S)服务器当前目录。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPCWD: ,。 AT+QFTPPWD 获取 FTP(S)服务器当前目录 测试命令 响应 AT+QFTPPWD=? 执行命令 OK 响应 AT+QFTPPWD OK 若当前目录获取成功： +QFTPPWD: 0, 最大响应时间 特性说明 若当前目录获取失败： +QFTPPWD: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效；参数配置不保存 上海移远通信技术股份有限公司 15 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 参数 字符串类型。FTP(S)服务器目录路径。最大长度为 255 字节。根路径为'/'。 整型。错误码，详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.5. AT+QFTPPUT 上传文件至 FTP(S)服务器 该命令用于上传文件至 FTP(S)服务器。若通过 COM 口上传文件，模块将进入数据模式。使用+++可 终止文件上传。本地文件，例如 RAM、UFS 或 SD 文件，可上传至 FTP(S)服务器。通过 AT+QFUPL 可 以将文件上传至 RAM、UFS 或 SD 卡，再通过 AT+QFTPPUT 将其上传至 FTP(S)服务器。文件上传成功 后，即可使用 AT+QFDEL 删除文件。详细信息可见文档{4]。 用 于 将 文 件 从 指 定 位 置 上 传 。 若 为 'COM:'， 应 在 AT+QFTPCFG 配 置 的 时间内响应+QFTPCWD: ,。若不为'COM:'，执行该命令 后，将先响应 OK，数据传输完成后再响应+QFTPPUT: 0,。 若模块进入数据模式或不为'COM:'，AT+QFTPCFG 配置的则表示接收或发 送两包数据之间的最大时间间隔。 AT+QFTPPUT 上传文件至 FTP(S)服务器 测试命令 响应 AT+QFTPPUT=? +QFTPPUT: ,,,, 设置命令 当为'COM:' AT+QFTPPUT=,[,[,,]] OK 响应 CONNECT OK 若文件上传成功： +QFTPPUT: 0, 设置命令 当不为'COM:' AT+QFTPPUT=,<local_ 若文件上传失败： +QFTPPUT: , 或者 +CME ERROR: 响应 OK 上海移远通信技术股份有限公司 16 / 50 name>[,] 最大响应时间 特性说明 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 若文件上传成功： +QFTPPUT: 0, 若文件上传失败： +QFTPPUT: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效；参数配置不保存 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 字符串类型。本地文件名称。最大长度为 60 字节。若该值为'COM:'，将在 COM 口输出数据。否则，数据将被保存至 RAM、UFS 或 SD 卡。文件上传成功后，可 通过 AT+QFDEL 删除。详细信息可见文档{4]。 整 型 。 上 传 文 件 的 起 始 位 置 。 默 认 值 ： 0 。 若 指 定 和 ， 则 表示继续上传到同一文件的数据位置。 整型。上传的数据长度。仅当为'COM:'时有效。当通过 COM 口上 传的数据长度达到时，模块将退出数据模式。单位：字节。 整型。上传的数据是否是最后一包。仅当为'COM:'时有效。 0 不是最后一包数据。当数据长度达到，模块将退出数据模式并响 应+QFTPPUT: 0,。此时，请勿断开数据连接，因为剩余的数据 需要上传到 FTP 上的同一文件。 1 最后一包数据。当数据长度达到，模块将退出数据模式，此时可 关闭数据连接，将响应+QFTPPUT: 0,。 整型。成功传输数据的长度。单位：字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 备注 若省略和，将上传所有数据至 FTP(S)服务器。 举例 //通过 COM 口将文件上传到 FTP(S)服务器。 AT+QFTPPUT='test.txt','COM:',0 CONNECT //在FTP(S)服务器上将所有数据保存为test.txt。 上海移远通信技术股份有限公司 17 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 OK +QFTPPUT: 0,1000 //通过COM口分两次将文件上传至FTP(S)服务器，每次上传1024字节。 AT+QFTPPUT='test.txt','COM:',0,1024,0 CONNECT OK //非test.txt文件最后1024字节数据。 //数据长度达到1024字节。 +QFTPPUT: 0,1024 AT+QFTPPUT='test.txt','COM:',1024,1024,1 CONNECT OK //test.txt文件最后1024字节数据。 //数据长度达到1024字节。 +QFTPPUT: 0,1024 //上传文件至RAM。 AT+QFUPL='RAM:test1.txt',1000,300,1 CONNECT +QFUPL: 1000,707 //上传文件至RAM，该文件被保存为test1.txt。文件大小为 1000字节。超时时间为300秒，处于ACK模式。详细信息 可见文档[4]. OK AT+QFLST='RAM:*' +QFLST: 'RAM:test1.txt',1000 OK AT+QFTPPUT='test.txt','RAM:test1.txt',0 OK //上传RAM:test1.txt文件至FTP(S)服务器，文件在FTP(S) 服务器上被保存为test.txt。 +QFTPPUT: 0,1000 AT+QFDEL='RAM:test1.txt' OK 上海移远通信技术股份有限公司 18 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 2.6. AT+QFTPGET 从 FTP(S)服务器下载文件 该命令用于从 FTP(S)服务器下载文件。通过设置 AT+QFTPGET='filename','COM:'文件可从 COM 口输出。模块从服务器接收数据时将进入数据模式。数据传输完成后，模块将自动退出数据模式并输出+Q FTPGET: 0,。通过 AT+QFTPGET='filename','RAM:localname'、AT+QFTPGET='filen ame','UFS:localname'或 AT+QFTPGET='filename','SD:localname'可将文件保存至 RAM、UFS 或 SD。文件传输成功后，模块将响应+QFTPGET: 0,。 若为'COM:'，应在 AT+QFTPCFG 配置的时间内响应 CONNECT；若 不为'COM:'，将先响应 OK，数据传输完成后才会响应+QFTPGET: 0,。 若模块进入数据模式或不为'COM:'，AT+QFTPCFG 配置的则表示接收或发 送两包数据之间的最大时间间隔。 AT+QFTPGET 从 FTP(S)服务器下载文件 测试命令 响应 AT+QFTPGET=? +QFTPGET: ,,, 设置命令 当为'COM:' AT+QFTPGET=,[,[,]] OK 响应 CONNECT OK 若文件下载成功： +QFTPGET: 0, 设置命令 当不为'COM:' AT+QFTPGET=,[,] 若文件下载失败： +QFTPGET: , 或者 +CME ERROR: 响应 OK 若文件下载成功： +QFTPGET: 0, 若文件下载失败： +QFTPGET: , 或者 +CME ERROR: 上海移远通信技术股份有限公司 19 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 最大响应时间 特性说明 取决于 AT+QFTPCFG 中配置的 该命令立即生效；参数配置不保存 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 字符串类型。本地文件名称。最大长度为 60 字节。若该值为'COM:'，将在 COM 口输 出数据。否则，数据将被保存至 RAM、UFS 或 SD 卡。建议将其保存在 RAM、UFS 或 SD 卡。之后可通过 AT+QFREAD 读取文件。详细信息可见文档{4]。 整型。要上传的文件的起始位置。默认值：0。 整型。下载的数据长度。仅当为'COM:'时有效。若指定该参数，模块将 输出字节至 COM 口并退出数据模式。若有剩余数据，则可以通过同 一 AT 命令从处下载数据。单位：字节。 整型。成功传输数据的长度。单位：字节。若传输数据少于，表示成 功传输整个文件。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。详 细信息可参考第 6 章。若为 0，则无效。 备注 当为'COM:'时，若省略和，将从 FTP(S)服务器下载整个文件。 举例 //通过COM口下载文件。 AT+QFTPGET='test.txt','COM:',0 CONNECT OK //从FTP(S)服务器下载整个文件。 +QFTPGET: 0,1000 //下载文件，通过COM口分两次输出数据，每次500字节。 AT+QFTPGET='test.txt','COM:',0,500 CONNECT OK //test.txt文件大小为1000字节数据，首次下载500字节。 +QFTPGET: 0,500 上海移远通信技术股份有限公司 20 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 AT+QFTPGET='test.txt','COM:',500,500 CONNECT OK //下载剩余500字节。 +QFTPGET: 0,500 //下载文件并保存至 RAM。 AT+QFTPGET='test.txt','RAM:test2.txt',0 OK +QFTPGET: 0,1000 AT+QFLST='RAM:*' +QFLST: 'RAM:test2.txt',1000 OK 2.7. AT+QFTPSIZE 获取 FTP(S)服务器文件大小 该命令用于获取 FTP(S)服务器文件大小。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPSIZE: 0,或+QFTPSIZE: ,，否则应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPSIZE 获取 FTP(S)服务器文件大小 测试命令 响应 AT+QFTPSIZE=? +QFTPSIZE: 设置命令 AT+QFTPSIZE= OK 响应 OK 若文件大小获取成功： +QFTPSIZE: 0, 最大响应时间 特性说明 若文件大小获取失败： +QFTPSIZE: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效；参数配置不保存 上海移远通信技术股份有限公司 21 / 50 参数 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 整型。FTP(S)服务器文件大小。单位：字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供 参考。详细信息可参考第 6 章。若为 0，则无效。 2.8. AT+QFTPDEL 删除 FTP(S)服务器文件 该命令用于删除指定 FTP(S)服务器文件。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPDEL: ,，否则应断开 FTP(S)连接，并去激活后重新 激活网络。 AT+QFTPDEL 删除 FTP(S)服务器文件 测试命令 响应 AT+QFTPDEL=? +QFTPDEL: 设置命令 AT+QFTPDEL= OK 响应 OK 最大响应时间 特性说明 +QFTPDEL: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件名称。最大长度为 255 字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 22 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 2.9. AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 该命令用于在 FTP(S)服务器创建文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPMKDIR: ,，否则应断开 FTP(S)连接，并去激活后重 新激活网络。 AT+QFTPMKDIR 创建 FTP(S)服务器文件夹 测试命令 响应 AT+QFTPMKDIR=? +QFTPMKDIR: 设置命令 AT+QFTPMKDIR= OK 响应 OK 最大响应时间 特性说明 +QFTPMKDIR: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 2.10. AT+QFTPRMDIR 删除 FTP(S)服务器文件夹 该命令用于在 FTP(S)服务器删除指定文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPRMDIR: ,，否则应断开 FTP(S)连接，并去激活后重 新激活网络。 AT+QFTPRMDIR 删除 FTP(S)服务器文件夹 测试命令 响应 AT+QFTPRMDIR=? +QFTPRMDIR: OK 上海移远通信技术股份有限公司 23 / 50 设置命令 AT+QFTPRMDIR= 最大响应时间 特性说明 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 响应 OK +QFTPRMDIR: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参 考。详细信息可参考第 6 章。若为 0，则无效。 2.11. AT+QFTPLIST 获取 FTP(S)服务器目录内容 该命令用于获取 FTP(S)服务器目录内容。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，服务器目录内容传输 完成后响应+QFTPLIST: 0,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接 收或发送两包数据之间的最大时间间隔。 AT+QFTPLIST 获取 FTP(S)服务器目录内容 测试命令 响应 AT+QFTPLIST=? +QFTPLIST: , 设置命令 当为'COM:' AT+QFTPLIST=[,] OK 响应 CONNECT OK 若获取服务器目录内容获取成功： +QFTPLIST: 0, 若获取服务器目录内容获取失败： 上海移远通信技术股份有限公司 24 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 设置命令 当不为'COM:' AT+QFTPLIST=, +QFTPLIST: , 或者 +CME ERROR: 响应 OK 若获取服务器目录内容获取成功： +QFTPLIST: 0, 最大响应时间 若获取服务器目录内容获取失败： +QFTPLIST: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 特性说明 该命令立即生效；参数配置不保存 参数 字符串类型。 FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'，将获 取由 AT+QFTPCWD 配置的当前目录内容。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 60 字节。默认值： 'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 RAM、 UFS 或 SD 卡。之后可通过 AT+QFREAD 读取文件，详细信息可见文档[4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 //在FTP(S)服务器上获取当前目录的内容，并通过COM口输出数据。 AT+QFTPLIST='.' CONNECT OK +QFTPLIST: 0,1000 //获取FTP(S)服务器上指定目录的内容并将其保存到RAM。 AT+QFTPLIST='TESTDIR','RAM:test2.txt' OK 上海移远通信技术股份有限公司 25 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 +QFTPLIST: 0,1000 AT+QFLST='RAM:*' +QFLST: 'RAM:test2.txt',1000 OK 2.12. AT+QFTPNLST 获取 FTP(S)服务器目录文件名 该命令用于获取 FTP(S)服务器目录文件名。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，文件名称传输完成后 响应+QFTPNLST: 0,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接收 或发送两包数据之间的最大时间间隔。 AT+QFTPNLIST 获取 FTP(S)服务器目录文件名 测试命令 响应 AT+QFTPNLST=? +QFTPNLST: , 设置命令 当为'COM:' AT+QFTPNLST=[, ] OK 响应 CONNECT OK 若文件名获取成功： +QFTPNLST: 0, 设置命令 当不为'COM:' AT+QFTPNLST=, 若文件名获取失败： +QFTPNLST: , 或者 +CME ERROR: 响应 OK +QFTPNLST: 0, 或者 +CME ERROR: 若获取文件名出错： +QFTPNLST: , 上海移远通信技术股份有限公司 26 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 最大响应时间 特性说明 取决于 AT+QFTPCFG 中配置的 该命令立即生效；参数配置不保存 举例 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'，将获取 由 AT+QFTPCWD 配置的当前目录的文件名。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 60 字节。默认值： 'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 RAM、 UFS 或 SD 卡。之后可通过 AT+QFREAD 读取文件，详细信息可见文档[4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可参考第 6 章。若为 0，则无效。 举例 //在FTP(S)服务器上获取当前目录文件名，并通过COM口输出数据。 AT+QFTPNLST='.' CONNECT OK +QFTPNLST: 0,1000 //获取FTP(S)服务器上指定目录文件名并将其保存到RAM。 AT+QFTPNLST='TESTDIR','RAM:test2.txt' OK +QFTPNLST: 0,1000 AT+QFLST='RAM:*' +QFLST: 'RAM:test2.txt',1000 OK 上海移远通信技术股份有限公司 27 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 2.13. AT+QFTPMLSD 获取标准化文件和目录信息 该命令用于获取标准化文件和目录信息。若为'COM:'，应在 AT+QFTPCFG 配置的 时间内响应 CONNECT；若不为'COM:'，首先将响应 OK，标准化文件和目录信 息传输完成后响应+QFTPMLSD: 0,。 若模块进入数据模式或不为'COM:'，则在 AT+QFTPCFG 中配置的表示接收 或发送两包数据之间的最大时间间隔。 AT+QFTPMLSD 获取标准化文件和目录信息 测试命令 响应 AT+QFTPMLSD=? +QFTPMLSD: , 设置命令 当为'COM:' AT+QFTPMLSD=[,] OK 响应 CONNECT OK 若标准化文件和目录信息获取成功： +QFTPMLSD: 0, 设置命令 当不为'COM:' AT+QFTPMLSD=, 若标准化文件和目录信息获取失败： +QFTPMLSD: , 或者 +CME ERROR: 响应 OK 若标准化文件和目录信息获取成功： +QFTPMLSD: 0, 最大响应时间 特性说明 若标准化文件和目录信息获取失败： +QFTPMLSD: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 上海移远通信技术股份有限公司 28 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 参数 字符串类型。FTP(S)服务器文件夹名称。最大长度为 255 字节。若值为'.'， 将获取由 AT+QFTPCWD 配置的标准化文件和目录信息。 字符串类型。FTP(S)服务器中数据的本地存储位置。最大长度为 60 字节。默认值： 'COM:'。若值为'COM:'，数据将从 COM 口输出。否则，数据将被保存至 RAM、 UFS 或 SD 卡。之后可通过 AT+QFREAD 读取文件，详细信息可见文档[4]。 整型。从 FTP(S)服务器传输数据的大小。单位：字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可见第 6 章。若为 0，则无效。 举例 //在FTP(S)服务器上获取标准化文件和目录信息，并通过COM口输出数据。 AT+QFTPMLSD='.' CONNECT OK +QFTPMLSD: 0,1000 //获取FTP(S)服务器上标准化文件和目录信息并将其保存到RAM。 AT+QFTPMLSD='TESTDIR','RAM:test2.txt' OK +QFTPMLSD: 0,1000 AT+QFLST='RAM:*' +QFLST: 'RAM:test2.txt',1000 OK 2.14. AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 该命令用于获取 FTP(S)服务器文件修改时间。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPMDTM: 0,或+QFTPMDTM: ,。否则 应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPMDTM 获取 FTP(S)服务器文件修改时间 测试命令 AT+QFTPMDTM=? 响应 +QFTPMDTM: 上海移远通信技术股份有限公司 29 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 设置命令 AT+QFTPMDTM= 最大响应时间 特性说明 OK 响应 OK 若获取成功： +QFTPMDTM: 0, 若获取失败： +QFTPMDTM: , 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 字符串类型。FTP(S)服务器文件名。最大长度为 255 字节。 字 符 串 类 型 。 FTP(S) 服 务 器 文 件 修 改 时 间 。 格 式 为 'YYYYMMDDHHMMSS' 或 'YYYYMMDDHHMMSS.NNN'。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可见第 6 章。若为 0，则无效。 2.15. AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹 该命令用于重命名 FTP(S)服务器文件或文件夹。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的 时间内响应+QFTPRENAME: ,。否则应断开 FTP(S)连接，并去激活后 重新激活网络。 AT+QFTPRENAME 重命名 FTP(S)服务器文件或文件夹 测试命令 响应 AT+QFTPRENAME=? +QFTPRENAME: , 设置命令 AT+QFTPRENAME=, OK 响应 OK +QFTPRENAME: , 上海移远通信技术股份有限公司 30 / 50 最大响应时间 特性说明 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 举例 字符串类型。FTP(S)服务器旧文件名或旧文件夹名称。最大长度为 255 字节。 字符串类型。FTP(S)服务器新文件名或新文件夹名称。最大长度为 255 字节。 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。详 细信息可见第 6 章。若为 0，则无效。 2.16. AT+QFTPLEN 获取传输数据长度 该命令用于获取 FTP(S)服务器传输数据长度。 AT+QFTPLEN 获取传输数据长度 测试命令 响应 AT+QFTPLEN=? 执行命令 OK 响应 AT+QFTPLEN OK 最大响应时间 特性说明 +QFTPLEN: 0, 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 举例 整 型 。 FTP(S) 服 务 器 传 输 数 据 长 度 。 执 行 AT+QFTPPUT 、 AT+QFTPGET 、 AT+QFTPNLST 或 AT+QFTPLIST 命令时，可使用 AT+QFTPLEN 查询传输数据长度。 单位：字节。 整型。错误码。详细信息可见第 5 章。 上海移远通信技术股份有限公司 31 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 2.17. AT+QFTPSTAT 获取 FTP(S)服务器状态 该命令用于获取 FTP(S)服务器状态。 AT+QFTPSTAT 获取 FTP(S)服务器状态 测试命令 响应 AT+QFTPSTAT=? 执行命令 OK 响应 AT+QFTPSTAT OK 最大响应时间 特性说明 +QFTPSTAT: 0, 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 / 参数 整型。当前 FTP(S)服务器状态。 0 正在开启 FTP(S)服务器 1 FTP(S)服务器开启并处于空闲状态 2 FTP(S)服务器正在传输数据 3 正在关闭 FTP(S)服务器 4 FTP(S)服务器已关闭 整型。错误码。详细信息可见第 5 章。 2.18. AT+QFTPCLOSE 退出 FTP(S)服务器 该命令用于退出 FTP(S)服务器。执行该命令响应 OK 后，应在 AT+QFTPCFG 配置的时间 内响应+QFTPCLOSE: ,。否则应断开 FTP(S)连接，并去激活后重新激活网络。 AT+QFTPCLOSE 退出 FTP(S)服务器 测试命令 响应 AT+QFTPCLOSE=? 执行命令 OK 响应 AT+QFTPCLOSE OK +QFTPCLOSE: , 上海移远通信技术股份有限公司 32 / 50 最大响应时间 特性说明 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 或者 +CME ERROR: 取决于 AT+QFTPCFG 中配置的 该命令立即生效；参数配置不保存 举例 整型。错误码。详细信息可见第 5 章。 整型。表示 FTP(S)服务器原始错误码。该错误码在 FTP(S)协议中定义，仅供参考。 详细信息可见第 6 章。若为 0，则无效。 上海移远通信技术股份有限公司 33 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 3 举例 3.1. 登录 FTP 服务器 //第一步：配置和激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK AT+QFTPCFG='contextid',1 OK //第二步：配置用户账号和传输设置。 AT+QFTPCFG='account','test','test' OK AT+QFTPCFG='filetype',1 OK AT+QFTPCFG='transmode',1 OK AT+QFTPCFG='rsptimeout',90 OK //第三步：登录FTP服务器。 AT+QFTPOPEN='quectel.3322.org',21 OK +QFTPOPEN: 0,0 //设置 PDP 上下文为 1，中国联通 APN 为'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 //设置PDP上下文为1。必须先激活PDP上下文ID。 //设置用户名和密码。 //设置文件类型为ASCII。 //设置为被动传输方式。 //设置最大响应时间（默认为90秒）。 上海移远通信技术股份有限公司 34 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 3.2. 登录 FTPS 服务器 //第一步：配置和激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //设置 PDP 上下文为 1，中国联通 APN 为'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QFTPCFG='contextid',1 OK //设置 PDP 上下文为 1。必须先激活 PDP 上下文 ID。 //第二步：配置用户账号和传输设置。 AT+QFTPCFG='account','test','test' //设置用户名和密码。 OK AT+QFTPCFG='filetype',1 OK AT+QFTPCFG='transmode',1 OK AT+QFTPCFG='rsptimeout',90 OK //设置文件类型为 ASCII。 //设置被动传输方式。 //设置最大响应时间（默认为 90 秒）。 //第三步：配置 FTPS。 AT+QFTPCFG='ssltype',1 //设置 SSL 类型为 1，模块作为 FTPS 客户端。 OK AT+QFTPCFG='sslctxid',1 OK AT+QSSLCFG='ciphersuite',1,0xffff OK AT+QSSLCFG='seclevel',1,0 OK AT+QSSLCFG='sslversion',1,1 OK //设置 SSL 上下文为 1。 //设置 SSL 加密套件类型为 0xffff，支持所有加密套件类型。 //设置 SSL 安全类型为 0，即不需要 SSL CA 证书。 //设置 SSL 版本为 1，表示 TLS1.0。 //第四步：登录 FTPS 服务器。 AT+QFTPOPEN='quectel.3322.org',990 OK +QFTPOPEN: 0,0 上海移远通信技术股份有限公司 35 / 50 3.3. 文件夹操作 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPPWD OK +QFTPPWD: 0,/ AT+QFTPMKDIR='TEST' OK +QFTPMKDIR: 0,0 AT+QFTPRENAME='TEST','TEST_NEW' OK +QFTPRENAME: 0,0 AT+QFTPRMDIR='TEST_NEW' OK +QFTPRMDIR: 0,0 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 //设置当前目录。 //查询当前目录。 //在 FTP(S)服务器创建名为 TEST 的文件夹。 //重命名文件夹为 TEST_NEW。 //删除文件夹 TEST_NEW。 3.4. 文件操作 AT+QFTPCWD='/' OK //设置当前目录。 +QFTPCWD: 0,0 AT+QFTPPWD OK //查询当前目录。 +QFTPPWD: 0,'/' AT+QFTPSIZE='test_my1.txt' OK //查询 FTP(S)服务器 test_my1.txt 文件大小。 +QFTPSIZE:0, 1000 AT+QFTPRENAME='test_my1.txt','test_new.txt' OK //重命名文件为 test_new.txt。 +QFTPRENAME: 0,0 AT+QFTPMDTM='test_new.txt' //获取 FTP(S)服务器上的 test_new.txt 文件修改时间。 上海移远通信技术股份有限公司 36 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 OK +QFTPMDTM: 0,'20140708110039' AT+QFTPDEL='test_new.txt' OK //删除 FTP(S)服务器上的 test_new.txt 文件。 +QFTPDEL: 0,0 3.5. 获取文件信息或文件名 AT+QFTPCWD='/' OK //设置当前目录。 +QFTPCWD: 0,0 AT+QFTPLIST='.' CONNECT OK //获取当前目录的内容，并通过 COM 口输出数据。 +QFTPLIST: 0,1000 AT+QFTPLIST='.','RAM:list.txt' OK //获取当前目录的内容，并通过 RAM:list.txt 输出数据。 +QFTPLIST: 0,1000 AT+QFTPLIST='TEST_2','COM:' CONNECT OK //获取 TEST_2 文件内容，并通过 COM 口输出数据。 +QFTPLIST: 0,1000 AT+QFTPNLST='.' CONNECT OK //获取当前目录的文件名，并通过 COM 口输出数据。 +QFTPNLST: 0,1000 AT+QFTPNLST='.','RAM:nlst.txt' //获取当前目录的文件名，并通过 RAM:nlst.txt 输出数据。 OK +QFTPNLST: 0,1000 AT+QFTPNLST='TEST_2','COM:' CONNECT //获取 TEST_2 文件名称，并通过 COM 口输出数据。 上海移远通信技术股份有限公司 37 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 OK +QFTPNLST: 0,1000 AT+QFTPMLSD='.' CONNECT OK +QFTPMLSD: 0,1000 AT+QFTPMLSD='.','RAM:nlst.txt' OK +QFTPMLSD: 0,1000 AT+QFTPMLSD='TEST_2','COM:' CONNECT OK +QFTPMLSD: 0,1000 //获取当前目录的标准化文件和目录信息，并通过 COM 口输 出数据。 //获取当前目录的标准化文件和目录信息，并通过 RAM:nlst.txt 输出数据。 //获取 TEST_2 的标准化文件和目录信息，并通过 COM 口输出 数据。 3.6. 上传文件至 FTP(S)服务器 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 AT+QFTPSTAT +QFTPSTAT: 0,1 OK //通过COM口上传文件 AT+QFTPPUT='test_my1.txt','COM:',0 CONNECT OK //所有数据在FTP(S)服务器上被保存为test_my1.txt。 +QFTPPUT: 0,1000 AT+QFTPLEN 上海移远通信技术股份有限公司 38 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 //通过COM口上传文件，起始位置为1000。 AT+QFTPPUT='test_my1.txt','COM:',1000 CONNECT OK //所有数据在FTP(S)服务器上被保存为test_my1.txt。 +QFTPPUT: 0,500 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1500 //方案1：通过COM口上传两次文件至FTP(S)服务器，每次上传1024字节数据。 AT+QFTPPUT='test_my1.txt','COM:',0,1024,0 CONNECT OK //非test_my1.txt最后一包1024字节数据。 //数据长度达到1024字节。 +QFTPPUT: 0,1024 AT+QFTPPUT='test_my1.txt','COM: ',1024,1024,1 CONNECT OK //test_my1.txt最后一包1024字节数据 //数据长度达到1024字节。 +QFTPPUT: 0,1024 //方案2：从RAM上传文件至FTP(S)服务器。 AT+QFUPL='RAM:test_ram.txt',1000,300,1 CONNECT +QFUPL: 1000,707 //上传文件至RAM，文件被保存为test_ram.txt。文件大小 为1000字节。超时时间为300秒。设置为ACK模式。详 细信息可见文档[4]。 OK 上海移远通信技术股份有限公司 39 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 AT+QFLST='RAM:*' +QFLST: 'RAM:test_ram.txt',1000 OK AT+QFTPPUT='test_my1.txt','RAM:test_ram.txt',0 OK //上传RAM:test_ram.txt至FTP(S)服务器，并将其 保存为test_my1.txt。 +QFTPPUT: 0,1000 //方案3：从UFS上传文件至FTP(S)服务器。 AT+QFUPL='UFS:test_ufs.txt',1000,300,1 CONNECT +QFUPL: 1000,707 //上传文件至UFS，文件被保存为test_ufs.txt。文件大小为 1000字节。超时时间为300秒。设置为ACK模式。详细信 息可见文档[4]。 OK AT+QFLST='UFS:*' +QFLST: 'UFS:test_ufs.txt',1000 OK AT+QFTPPUT='test_my1.txt','UFS:test_ufs.txt',0 OK //上传UFS:test_ufs.txt至FTP(S)服务器，并将其保 存为test_my1.txt。 +QFTPPUT: 0,1000 //方案4：从SD上传文件至FTP(S)服务器。 AT+QFUPL='SD:test_sd.txt',1000,300,1 CONNECT +QFUPL: 1000,707 //上传文件至SD，文件被保存为test_sd.txt。文件大小为 1000字节。超时时间为300秒。设置为ACK模式。详细信 息可见文档[4]。 OK AT+QFLST=SD:*' +QFLST: 'SD:test_sd.txt',1000 OK AT+QFTPPUT='test_my1.txt','SD:test_sd.txt',0 //上传SD:test_sd.txt至FTP(S)服务器，并将其保存 为test_my1.txt。 上海移远通信技术股份有限公司 40 / 50 OK +QFTPPUT: 0,1000 AT+QFTPLEN OK +QFTPLEN: 0,1000 AT+QFTPSIZE='test_my1.txt' OK +QFTPSIZE: 0,1000 AT+QFDEL='RAM:test_ram.txt' OK EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 //删除本地RAM文件。 3.7. 从 FTP(S)服务器下载文件 AT+QFTPCWD='/' OK +QFTPCWD: 0,0 //方案 1：直接通过 COM 口输出下载数据。 //从 FTP(S)服务器下载文件，并通过 COM 输出数据。 AT+QFTPGET='test_my.txt','COM:' CONNECT OK +QFTPGET: 0,1000 //下载文件，通过COM口分两次输出数据，每次500字节。 AT+QFTPGET='test.txt','COM:',0,500 CONNECT OK //test.txt文件大小为1000字节数据，首次下载500字节。 +QFTPGET: 0,500 AT+QFTPGET='test.txt','COM:',500,500 CONNECT OK //下载剩余500字节。 上海移远通信技术股份有限公司 41 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 +QFTPGET: 0,500 //方案 2：将下载数据保存至 RAM。 //从 FTP(S)服务器下载文件并将其保存至 RAM。 AT+QFTPGET='test_my1.txt','RAM:test.txt' OK //下载文件并将其保存至 RAM，命名为 test.txt。 +QFTPGET: 0,1000 AT+QFLST='RAM:*' +QFLST: RAM:test.txt,1000 OK //从 FTP(S)服务器下载文件并将其保存至 RAM，起始位置为 450。 AT+QFTPGET='test_my1.txt','RAM:test1.txt',450 //下载文件并将其保存至 RAM，命名为 test.txt。 OK +QFTPGET: 0,550 //方案 3：保存下载数据至 UFS。 //从 FTP(S)服务器下载文件并将其保存至 UFS。 AT+QFTPGET='test_my1.txt','UFS:test.txt' OK //下载文件并将其保存至 UFS，命名为 test.txt。 +QFTPGET: 0,1000 AT+QFLST='UFS:*' +QFLST: UFS:test.txt,1000 OK //从 FTP(S)服务器下载文件并将其保存至 UFS，起始位置为 450。 AT+QFTPGET='test_my1.txt','UFS:test1.txt',450 //下载文件并将其保存至 UFS，命名为 test.txt。 OK +QFTPGET: 0,550 //方案 4：保存下载数据至 SD 卡。 //从 FTP(S)服务器下载文件并将其保存至 SD 卡。 AT+QFTPGET='test_my1.txt','SD:test.txt' OK //下载文件并将其保存至 SD 卡，命名为 test.txt。 +QFTPGET: 0,1000 AT+QFLST='SD:*' 上海移远通信技术股份有限公司 42 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 +QFLST: SD:test.txt,1000 OK //从 FTP(S)服务器下载文件并将其保存至 SD 卡，起始位置为 450。 AT+QFTPGET='test_my1.txt','SD:test1.txt',450 //下载文件并将其保存至 SD 卡，命名为 test.txt。 OK +QFTPGET: 0,550 AT+QFTPLEN OK +QFTPLEN: 0,550 AT+QFLST='RAM:*' +QFLST: RAM:test.txt,1000 +QFLST: RAM:test1.txt,550 OK 3.8. 退出 FTP(S)服务器 AT+QFTPCLOSE OK +QFTPCLOSE: 0,0 AT+QIDEACT=1 OK //退出FTP(S)服务器。 //去激活为FTP(S)激活的PDP上下文。 上海移远通信技术股份有限公司 43 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 4 常见问题处理 4.1. FTP(S) AT 命令执行失败 执行 FTP(S) AT 命令后，若返回 ERROR，请检查是否插入了(U)SIM 卡，并注意执行 AT+CPIN?后是 否返回了+CPIN: READY。 4.2. PDP 激活失败 若使用 AT+QIACT 激活 PDP 失败，请检查以下配置： 1. 通过 AT+CGATT?查询是否已经附着 PS 域。若未附着 PS 域，请先执行 AT+CGATT=1 命令附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保已注册了 PS 域。 3. 通过 AT+QICSGP 命令查询 PDP 上下文参数，并确保已设置了指定 PDP 上下文的 APN。 4. 确保 PPP 未使用指定的 PDP 上下文 ID，AT+CGACT 也未激活指定的 PDP 上下文 ID。 5. 根据 3GPP 规范，模块仅支持同时激活三个 PDP 上下文，因此激活 PDP 上下文的数量必须不超 过 3。 若上述配置无误，但依然无法通过 AT+QIACT 成功激活 PDP 上下文，请重启模块。重启模块后，请 至少检查三次上述配置，每次间隔 10 分钟，以避免频繁重启模块。 4.3. DNS 解析失败 执行 AT+QFTPOPEN 后，若返回+QFTPOPEN: 604,0，请检查以下配置： 1. 确认 FTP(S)服务器域名有效。 2. 通过 AT+QIACT?查询 PDP 上下文状态，确保成功激活了指定的 PDP 上下文。 上海移远通信技术股份有限公司 44 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 4.4. FTP(S)服务器响应错误 若+QFTPXX: ,中的不为 0，表示 FTP(S)服务器响应的错误 码。 用户可根据协议错误码检查 FTP(S)服务器响应的错误码。例如，若为 530（未登录）， 表明或密码可能错误；若为 550（请求失败：文件不可用）， 表明文件或目录不存在。详细信息可参考文档[5]。 上海移远通信技术股份有限公司 45 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 5 错误码 表示与移动设备或网络有关的错误代码。相关详细信息参见下表。 表 3：错误码列表 错误码 0 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 英文含义 中文含义 Operation successful 操作成功 Unknown error 未知错误 FTP(S) server blocked FTP(S)服务器不可用 FTP(S) server busy FTP(S)服务器繁忙 DNS parse failed DNS 解析错误 Network error 网络错误 Control connection closed. 控制连接关闭 Data connection closed 数据连接关闭 Socket closed by peer 对端关闭 Socket Timeout error 超时错误 Invalid parameter 无效参数 Failed to open file 文件打开失败 File position invalid 文件位置无效 File error 文件错误 Service not available, closing control connection 服务不可用，关闭控制连接 Open data connection failed 数据连接打开失败 Connection closed; transfer aborted 连接关闭，传输中止 Requested file action not taken 文件操作请求失败 上海移远通信技术股份有限公司 46 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 618 Requested action aborted: local 请求中止：本地错误处理中 error in processing 619 Requested action not taken: 请求失败：系统空间不足 insufficient system storage 620 Syntax error, command 语句错误，无法命令识别 unrecognized 621 Syntax error in parameters or 语句错误，参数出错 arguments 622 Command not implemented 未执行命令 623 Bad sequence of commands 命令顺序有误 624 Command parameter not 未输入命令参数 implemented 625 Not logged in 未登录 626 Need account for storing files 需要能存储文件的账号 627 Requested action not taken 请求失败 628 Requested action aborted: 请求中止：未知网页类型 page type unknown 629 Requested file action aborted 文件操作请求失败 630 Requested file name invalid 请求的文件名无效 631 SSL authentication failed SSL 鉴权失败 上海移远通信技术股份有限公司 47 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 6 FTP(S)协议错误码 协议错误码表示 FTP(S)服务器响应的错误码。详细信息可见文档[5]。下表描述了部 分常见错误码。 表 4：FTP(S)协议错误码列表 英文含义 Service not available, closing control 421 connection 425 Open data connection failed 中文含义 服务不可用，关闭控制连接 打开数据连接失败 426 Connection closed; transfer aborted 连接关闭；传输中止 450 Requested file action not taken 文件操作请求失败 451 Requested action aborted: local error in 请求中间：本地错误处理中 processing 452 Requested action not taken: insufficient 请求失败：系统空间不足 system storage 500 Syntax error, command unrecognized 语句错误，无法命令识别 501 Syntax error in parameters or arguments 参数语句错误 502 Command not implemented 未执行命令 503 Bad sequence of commands 命令顺序有误 504 Command parameter not implemented 未输入参数 530 Not logged in 未登录 532 Need account for storing files 需要能存储文件的账号 550 Requested action not taken: file unavailable 请求失败：文件不可用 551 Requested action aborted: page type 请求中止：未知网页类型 unknown Requested file action aborted: exceeded 文件操作请求中止：存储空间分配过 552 storage allocation 量 553 Requested action not taken: file name not 请求失败：不允许的文件名 allowed 上海移远通信技术股份有限公司 48 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 7 附录 A 参考文档和术语缩写 表 5：参考文档 序号 文档名称 [1] Quectel_LTE_Standard_TCP(IP)_应用指导 Quectel_EC2x&EG9x&EG2x-G&EM05 系列 [2] _AT_Commands_Manual Quectel_EC2x&EG9x&EG2x-G&EM05 系列 [3] _SSL_应用指导 [4] Quectel_LTE_Standard_FILE_应用指导 [5] RFC959 备注 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列的 TCP/IP 应用指导 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列的 AT 命令手册 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列的 SSL 应用指导 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列的 FILE 应用指导 文件传输协议 表 6：术语缩写 缩写 ACK APN ASCII DNS ID DTR FTP FTPS 英文全称 中文全称 Acknowledgement 确认消息 Access Point Name 接入点名称 American Standard Code for Information Interchange 美国信息交换标准代码 Domain Name Server 域名服务器 Internet Protocol 网络协议 Data Terminal Ready 数据终端就绪 File Transfer Protocol FTP over SSL/FTP Secure 文件传输协议 对常用的文件传输协议（FTP） 添加传输层安全（TLS）和安全 套接层（SSL）加密协议支持的 扩展协议 上海移远通信技术股份有限公司 49 / 50 EC2x&EG9x&EG2x-G&EM05 系列 FTP(S)应用指导 PDP PPP PS QoS RAM SD SSL TLS UFS URC (U)SIM Packet Data Protocol Point-to-Point Protocol Packet Switching Quality of Service Random Access Memory Secure Digital Secure Sockets Layer Transport Layer Security Universal Flash Storage Unsolicited Result Code (Universal) Subscriber Identity Module 分组数据协议 点对点协议 数据转换 服务质量 随机存取存储器 安全数码卡 安全套接层 安全传输层协议 通用闪存存储 未经请求的结果码 全球用户识别卡 上海移远通信技术股份有限公司 50 / 50

EC2x Series&EG25-G Wi-Fi Application Note LTE Standard Module Series Version: 1.4 Date: 2023-06-26 Status: Released LTE Standard Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. EC2x_Series&EG25-G_Wi-Fi_Application_Note 1 / 44 LTE Standard Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2023. All rights reserved. EC2x_Series&EG25-G_Wi-Fi_Application_Note 2 / 44 LTE Standard Module Series About the Document Revision History Version Date 1.0 2017-12-20 1.1 2020-02-26 1.2 2022-03-02 1.3 2023-03-02 1.4 2023-06-26 Author Duke XIN/ Adolph WANG Mike ZHOU/ Paddy LI Victor YAN Gavin LU/ Mount ZHONG Harry GONG Description Initial 1. Added AT+QWIFICFG related commands (Chapter 2.10). 2. Added Wi-Fi related URC of AT+QWIFICFG related commands (Chapter 3.2 and 3.3). 3. Added examples for AT+QWIFICFG related commands (Chapter 4). 1. Added FC21 Wi-Fi module for 4G + Wi-Fi one-stop solution. 2. Added matters requiring attention (Chapter 1.4). 1. Added the response: If the length of SSID is more than 32 bytes, and then return ERROR (Chapter 2.3.1.2). 2. Updated the value range of in the following 3 commands: ⚫ AT+QWIFICFG='channel' (Chapter 2.3.1.5). ⚫ AT+QWIFICFG='stastatus' (Chapter 2.3.1.14). ⚫ AT+QWMOCH (Chapter 2.3.7). 3. Changed the default value of in AT+QWIFICFG='macacl' (Chapter 2.3.1.9). 4. Added AT+QWIFICFG='speedlimit'(Chapter 2.3.1.15). 5. Added AT+QWIFICFG='datarate' (Chapter 2.3.1.16). 6. Added AT+QWIFICFG='traffictransf' (Chapter 2.3.1.17). 7. Added AT+QWIFICON (Chapter 2.3.11). Added AT+QCFG='sdio_clk' (Chapter 2.3.12). EC2x_Series&EG25-G_Wi-Fi_Application_Note 3 / 44 LTE Standard Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 6 Figure Index ................................................................................................................................................ 7 1 4G + Wi-Fi Solution ............................................................................................................................. 8 1.1. Introduction ................................................................................................................................ 8 1.2. Features of FC20 Series/FC21 .................................................................................................. 9 1.3. Wi-Fi Solution Architecture....................................................................................................... 10 1.4. Matters Requiring Attention...................................................................................................... 10 2 Description of Wi-Fi AT Commands ............................................................................................... 11 2.1. AT Command Introduction ........................................................................................................11 2.1.1. Definitions.......................................................................................................................11 2.1.2. AT Command Syntax .....................................................................................................11 2.2. Declaration of AT Command Examples ................................................................................... 12 2.3. AT Command Details ............................................................................................................... 12 2.3.1. AT+QWIFICFG Extended Configuration Settings ...................................................... 12 2.3.1.1. AT+QWIFICFG='workmode' Set Work Mode................................................. 13 2.3.1.2. AT+QWIFICFG='ssid' Set SSID ..................................................................... 14 2.3.1.3. AT+QWIFICFG='ssidhide' Enable/Disable Hiding of AP SSID ...................... 15 2.3.1.4. AT+QWIFICFG='maxsta' Set Maximum Number of Stations Allowed ........... 15 2.3.1.5. AT+QWIFICFG='channel' Set Channel.......................................................... 16 2.3.1.6. AT+QWIFICFG='mode' Set Frequency Mode................................................ 17 2.3.1.7. AT+QWIFICFG='bandwidth' Set Bandwidth .................................................. 18 2.3.1.8. AT+QWIFICFG='auth' Set Authentication Type, Encryption Mode and Password............................................................................................................ 19 2.3.1.9. AT+QWIFICFG='macacl' Set MAC Address Filter List .................................. 20 2.3.1.10. AT+QWIFICFG='cc' Set Country Code .......................................................... 21 2.3.1.11. AT+QWIFICFG='stainfo' Get Station Information........................................... 22 2.3.1.12. AT+QWIFICFG='scan' Scan Wi-Fi Hotspot Information ................................ 23 2.3.1.13. AT+QWIFICFG='scanresult' Get Wi-Fi Scanning Hotspot Information Result24 2.3.1.14. AT+QWIFICFG='stastatus' Get Connection Information of STA Mode.......... 24 2.3.1.15. AT+QWIFICFG='speedlimit' Control Wi-Fi Downlink Speed.......................... 25 2.3.1.16. AT+QWIFICFG='datarate' Check Wi-Fi Data Rate ........................................ 26 2.3.1.17. AT+QWIFICFG='traffictransf' Check Wi-Fi Traffic.......................................... 26 2.3.2. AT+QWIFI Enable/Disable Wi-Fi Function................................................................. 27 2.3.3. AT+QWSSIDHEX Set SSID Encoding ....................................................................... 28 2.3.4. AT+QWSSID Set SSID............................................................................................... 29 2.3.5. AT+QWBCAST Enable/Disable Broadcast ................................................................ 30 2.3.6. AT+QWAUTH Set Network Authentication Type, Encryption Mode and Password .. 31 2.3.7. AT+QWMOCH Set Frequency Mode and Channel of 802.11 Network ..................... 32 EC2x_Series&EG25-G_Wi-Fi_Application_Note 4 / 44 LTE Standard Module Series 2.3.8. 2.3.9. 2.3.10. 2.3.11. 2.3.12. AT+QWISO Enable/Disable Isolation Among Clients Connected to AP .................... 34 AT+QWCLICNT Query Number of Wi-Fi Clients ....................................................... 35 AT+QWRSTD Restore Default Settings..................................................................... 35 AT+QWIFICON Check Whether a TE device accesses the Internet in Wi-Fi AP mode ............................................................................................................................ 36 AT+ QCFG='sdio_clk' Set WLAN SDIO Clock .......................................................... 37 3 Description of URCs ......................................................................................................................... 38 3.1. +QWIFIND URC of Client Connection Status ....................................................................... 38 3.2. +QWIFICFG='stastatus' URC of STA Connection Status .................................................... 39 3.3. +QWIFCFG='scandone' URC of Finishing STA Scanning................................................... 39 4 Examples ........................................................................................................................................... 40 4.1. Single AP Mode........................................................................................................................ 40 4.2. Single STA Mode...................................................................................................................... 40 4.3. AP0 + AP1 Mode...................................................................................................................... 41 4.4. AP + STA Mode........................................................................................................................ 41 4.5. Scan Hotspots Nearby ............................................................................................................. 41 5 Appendix References ....................................................................................................................... 43 EC2x_Series&EG25-G_Wi-Fi_Application_Note 5 / 44 LTE Standard Module Series Table Index Table 1: Applicable Modules......................................................................................................................... 8 Table 2: Types of AT Commands ...............................................................................................................11 Table 3: Related Documents ...................................................................................................................... 43 Table 4: Terms and Abbreviations .............................................................................................................. 43 EC2x_Series&EG25-G_Wi-Fi_Application_Note 6 / 44 LTE Standard Module Series Figure Index Figure 1: Software Workflow of 4G + Wi-Fi One-stop Solution ................................................................... 9 Figure 2: Wi-Fi Solution Architecture ......................................................................................................... 10 EC2x_Series&EG25-G_Wi-Fi_Application_Note 7 / 44 LTE Standard Module Series 1 4G + Wi-Fi Solution 1.1. Introduction The rapid development of LTE and IoT accelerates the integration of 4G and Wi-Fi technology. Accordingly, many customer companies turn to converting the operator’s 4G signals to Wi-Fi signals so that smartphone, tablet, and laptop users can enjoy free Wi-Fi access to share local resources and communicate with several terminals over a high-speed network. Therefore, Quectel provides a 4G + Wi-Fi one-stop solution based on its cellular modules and FC20 series/FC21 Wi-Fi modules, which is realized by converting 4G signals into Wi-Fi signals to create Wi-Fi hotspots. This document applies to the following Quectel LTE Standard modules. Table 1: Applicable Modules Module Family EC2x - Module EC25 Series EC21 Series EC20-CE EG25-G NOTE Currently, the 4G + Wi-Fi one-stop solution is not supported by variants of the above modules with 128 MB RAM + 128 MB ROM. EC2x_Series&EG25-G_Wi-Fi_Application_Note 8 / 44 LTE Standard Module Series Figure 1: Software Workflow of 4G + Wi-Fi One-stop Solution ⚫ Client and MCU can access the 4G network through EC2x family and EG25-G modules simultaneously. ⚫ MCU can control Wi-Fi connection by AT commands. ⚫ FC20 series and FC21 Wi-Fi modules support AP and STA modes. In AP mode, the client (e.g., a mobile phone, a computer) connected to the AP hotspot can access the Internet through the cellular network of EC2x family and EG25-G modules. In STA mode, the physical interfaces (ECM, RNDIS, or SGMII interface) of EC2x family and EG25-G modules can access the Internet. ⚫ EC2x family and EG25-G modules support various connections, such as through USB and UART, between the module and MCU. ⚫ The maximum access point is 16. ⚫ STA mode of Wi-Fi only supports hotspot connection and scanning. 1.2. Features of FC20 Series/FC21 For detailed features of FC20 series and FC21 modules, please refer to documents [1] and [2]. EC2x_Series&EG25-G_Wi-Fi_Application_Note 9 / 44 LTE Standard Module Series 1.3. Wi-Fi Solution Architecture WLAN&BT_ANT FC20 Series/ FC21 Coexistence control SDIO 3.0 UART Power for VIO Typ. 3.3 V (U)SIM Card MAIN_ANT GNSS_ANT DIV_ANT EC2x Family & EG25-G USB UART MCU (1.8 V) SD Card (Optional) VBAT Typ. 3.8 V VCC_MCU Power Supply Figure 2: Wi-Fi Solution Architecture ⚫ EC2x family and EG25-G modules communicate with FC20 series/FC21 through SDIO 3.0 interface with a maximum data rate of up to 200 Mbps. ⚫ The communication between MCU and EC2x family and EG25-G modules can be realized through USB or UART. ⚫ If the MCU voltage level is not 1.8 V, a voltage level translation circuit should be added between the module and the MCU. 1.4. Matters Requiring Attention ⚫ Use AT+QLWWANCID to set the default PDP context for dialing. ⚫ An IP filter list is on the modem side. After Wi-Fi is activated, UDP data packets will no longer be transferred to the modem until the IP address is added to the IP filter list. Alternatively, set different PDP contexts for UDP and Wi-Fi. EC2x_Series&EG25-G_Wi-Fi_Application_Note 10 / 44 LTE Standard Module Series 2 Description of Wi-Fi AT Commands 2.1. AT Command Introduction 2.1.1. Definitions ⚫ Carriage return character. ⚫ Line feed character. ⚫ Parameter name. Angle brackets do not appear on the command line. ⚫ [...] Optional parameter of a command or an optional part of TA information response. Square brackets do not appear on the command line. When an optional parameter is not given in a command, the new value equals its previous value or the default settings, unless otherwise specified. ⚫ Underline Default setting of a parameter. 2.1.2. AT Command Syntax All command lines must start with AT or at and end with . Information responses and result codes always start and end with a carriage return character and a line feed character: . In tables presenting commands and responses throughout this document, only the commands and responses are presented, and and are deliberately omitted. Table 2: Types of AT Commands Command Type Syntax Description Test Command AT+=? Read Command AT+? Test the existence of the corresponding command and return information about the type, value, or range of its parameter. Check the current parameter value of the corresponding command. Write Command AT+=[,[,[...]]] Set user-definable parameter value. Execution Command AT+ Return a specific information parameter or perform a specific action. EC2x_Series&EG25-G_Wi-Fi_Application_Note 11 / 44 LTE Standard Module Series 2.2. Declaration of AT Command Examples The AT command examples in this document are provided to help you learn about the use of the AT commands introduced herein. The examples, however, should not be taken as Quectel’s recommendations or suggestions about how to design a program flow or what status to set the module into. Sometimes multiple examples may be provided for one AT command. However, this does not mean that there is a correlation among these examples, or that they should be executed in a given sequence. 2.3. AT Command Details 2.3.1. AT+QWIFICFG Extended Configuration Settings The command queries and configures various settings of Wi-Fi. AT+QWIFICFG Extended Configuration Settings Test Command AT+QWIFICFG=? Response … +QWIFICFG: 'workmode',(range of supported s) +QWIFICFG: 'ssid',(range of supported s), +QWIFICFG: 'ssidhide',(list of supported s),(list of supported s) +QWIFICFG: 'maxsta',(list of supported s),(range of supported s) +QWIFICFG: 'channel',(list of supported s),(list of supported s) +QWIFICFG: 'mode',(list of supported s),(range of supported s) +QWIFICFG: 'bandwidth',(list of supported s),(range of supported s) +QWIFICFG: 'auth',(list of supported s),(list of supported s)[,(list of supported s),] +QWIFICFG: 'macacl',(list of supported s),(range of supported s,(range of supported s)[,] +QWIFICFG: 'cc', +QWIFICFG: 'stainfo' +QWIFICFG: 'scan'[,(list of supported s)] +QWIFICFG: 'scanresult' +QWIFICFG: 'stastatus' EC2x_Series&EG25-G_Wi-Fi_Application_Note 12 / 44 Maximum Response Time Characteristics LTE Standard Module Series +QWIFICFG: 'speedlimit',(range of supported s) +QWIFICFG: 'datarate',(list of supported s),(list of supported s) +QWIFICFG: 'traffictransf',(list of supported s),(list of supported s) … OK 30 s / 2.3.1.1. AT+QWIFICFG='workmode' Set Work Mode This command sets Wi-Fi work mode. This command should be executed before you enabling Wi-Fi function. AT+QWIFICFG='workmode' Set Work Mode Write Command AT+QWIFICFG='workmode'[,] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'workmode', OK If the optional parameter is specified, configure the Wi-Fi work mode: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. EC2x_Series&EG25-G_Wi-Fi_Application_Note 13 / 44 Parameter Integer type. Work mode of Wi-Fi. 0 AP0 mode 1 STA mode 2 AP0 and STA concurrency mode 3 AP0 and AP1 concurrency mode LTE Standard Module Series 2.3.1.2. AT+QWIFICFG='ssid' Set SSID This command sets Wi-Fi SSID. AT+QWIFICFG='ssid' Set SSID Write Command AT+QWIFICFG='ssid',[,] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'ssid',, OK If the optional parameter is specified, configure the Wi-Fi SSID: OK If there is any error: ERROR Maximum Response Time Characteristics If the length of SSID is more than 32 bytes: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Index of Wi-Fi in different work modes. 0 AP0 1 AP1 2 STA String type. Wi-Fi SSID. ASCII string with length not greater than 32 bytes. Default value: QSoftAP. EC2x_Series&EG25-G_Wi-Fi_Application_Note 14 / 44 LTE Standard Module Series 2.3.1.3. AT+QWIFICFG='ssidhide' Enable/Disable Hiding of AP SSID This command enables or disables hiding AP SSID. AT+QWIFICFG='ssidhide' Enable/Disable Hiding of AP SSID Write Command AT+QWIFICFG='ssidhide',[,< SSID_hide>] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'ssidhide',, OK If the optional parameter is specified, enable or disable the hiding of AP SSID: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Index of Wi-Fi in different work modes. 0 Primary AP (AP0) 1 Guest AP (AP1) Integer type. Enable or disable the hiding of AP SSID. 0 Disable 1 Enable 2.3.1.4. AT+QWIFICFG='maxsta' Set Maximum Number of Stations Allowed This command sets maximum number of stations allowed in AP mode. AT+QWIFICFG='maxsta' Set Maximum Number of Stations Allowed Write Command AT+QWIFICFG='maxsta',[,< maxsta>] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'maxsta',, OK EC2x_Series&EG25-G_Wi-Fi_Application_Note 15 / 44 LTE Standard Module Series Maximum Response Time Characteristics If the optional parameter is specified, configure maximum number of stations allowed in AP mode: OK If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Index of Wi-Fi in different work modes. 0 Primary AP (AP0) 1 Guest AP (AP1) Integer type. Maximum number of stations allowed in AP mode. Default value: 16. Range: 1–16. Example AT+QWIFICFG='maxsta',0 +QWIFICFG: 'maxsta',0,16 OK AT+QWIFICFG='maxsta',0,10 OK //The current maximum number of stations is 16. //Set Primary AP’s maximum number of stations to 10. 2.3.1.5. AT+QWIFICFG='channel' Set Channel This command sets channel of AP mode. AT+QWIFICFG='channel' Set Channel Write Command AT+QWIFICFG='channel',[,< channel>] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'channel',, OK If the optional parameter is specified, configure the AP mode channel: EC2x_Series&EG25-G_Wi-Fi_Application_Note 16 / 44 LTE Standard Module Series Maximum Response Time Characteristics OK If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Index of Wi-Fi in different work modes. 0 Primary AP (AP0) 1 Guest AP (AP1) Integer type. 802.11 network channel. 0 Automatic selection 1–13 2.4 GHz channel 36/40/44/48/52/56/60/64/100/104/108/112/116/120/124/128/132/136/140/144/149/153/157 /161/165/170/171/172/173/174/175/176/177/178/179/180/181/182/183/184 5 GHz channel 2.3.1.6. AT+QWIFICFG='mode' Set Frequency Mode This command sets frequency mode of AP mode. AT+QWIFICFG='mode' Set Frequency Mode Write Command AT+QWIFICFG='mode',[,] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'mode',, OK If the optional parameter is specified, configure the AP frequency mode: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. EC2x_Series&EG25-G_Wi-Fi_Application_Note 17 / 44 LTE Standard Module Series Parameter Integer type. Index of Wi-Fi in different work modes. 0 Primary AP (AP0) 1 Guest AP (AP1) Integer type. Frequency mode of AP mode. 0 802.11a 1 802.11a/n 2 802.11b 3 802.11b/g 4 802.11b/g/n 5 802.11ac 2.3.1.7. AT+QWIFICFG='bandwidth' Set Bandwidth This command sets bandwidth of AP mode. AT+QWIFICFG='bandwidth' Set Bandwidth Write Command AT+QWIFICFG='bandwidth', [,] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'bandwidth',, OK If the optional parameter is specified, configure the bandwidth of the AP mode: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. EC2x_Series&EG25-G_Wi-Fi_Application_Note 18 / 44 LTE Standard Module Series Parameter Integer type. Index of Wi-Fi in different work modes. 0 Primary AP (AP0) 1 Guest AP (AP1) Integer type. Bandwidth of AP mode. 0 20 MHz 1 40 MHz 2 80 MHz. Only supported by 802.11ac frequency mode. 2.3.1.8. AT+QWIFICFG='auth' Set Authentication Type, Encryption Mode and Password This command sets authentication type, encryption mode, and password. AT+QWIFICFG='auth' Set Authentication Type, Encryption Mode and Password Write Command AT+QWIFICFG='auth',[,[,,]] Response If the optional parameters are omitted, query the current configuration: +QWIFICFG: 'auth',,[,,] OK If is specified, When is 0, and should be omitted, then configure the authorization type: OK When is not 0, and should be specified, then configure authorization type, encryption mode, and password: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. EC2x_Series&EG25-G_Wi-Fi_Application_Note 19 / 44 LTE Standard Module Series Parameter Integer type. Index of Wi-Fi in different work modes. 0 Primary AP (AP0) 1 Guest AP (AP1) 2 STA Integer type. Authentication type. 0 Open system authentication 2 WPA 3 WPA2 4 WPA/WPA2 Integer type. Encryption mode. This parameter is only available when is not 0. 0 TKIP 1 AES 2 TKIP-AES String type. Password of WPA and WPA2 personal authentication. This parameter is only available when is not 0. 2.3.1.9. AT+QWIFICFG='macacl' Set MAC Address Filter List This command sets MAC address filter list of AP mode. AT+QWIFICFG='macacl' Set MAC Address Filter List Write Command AT+QWIFICFG='macacl',, [,[,]] Response If the optional parameters are omitted, query the current configuration: +QWIFICFG: 'macacl',,,, OK If is specified, when rule is 0, is omitted; or when rule is not 0, set MAC address filter list: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. EC2x_Series&EG25-G_Wi-Fi_Application_Note 20 / 44 LTE Standard Module Series Parameter Integer type. Index of Wi-Fi in different work modes. 0 Primary AP (AP0) 1 Guest AP (AP1) Integer type. Operation of the command. 0 Set and get type of MAC address filter list 1 Add station MAC address 2 Delete station MAC address 3 Get station MAC address Integer type. Types of MAC address filter list. 0 MAC address filter list disabled 1 Blacklist 2 Whitelist String type. Station MAC address. NOTE 1. MAC address filter will be disabled when is 0, in which case should be omitted. 2. Please first execute AT+QWIFICFG='macacl',,, to set the type of MAC address filter list to blacklist or whitelist, and then execute AT+QWIFICFG='macacl',,,, to add or delete the MAC address. 3. You can implement either a blacklist or whitelist; both listing techniques cannot be implemented simultaneously. 2.3.1.10. AT+QWIFICFG='cc' Set Country Code This command sets Wi-Fi country code. The country code is compliant with ISO 3166 alpha-2. AT+QWIFICFG='cc' Set Country Code Write Command AT+QWIFICFG='cc'[,] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'cc', OK If the optional parameter is specified, configure the Wi-Fi country code: OK If there is any error: EC2x_Series&EG25-G_Wi-Fi_Application_Note 21 / 44 LTE Standard Module Series Maximum Response Time Characteristics ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter String type. Country code of Wi-Fi. Default value: CN. Example AT+QWIFICFG='cc' +QWIFICFG: 'cc','CN' OK AT+QWIFICFG='cc','JP' OK //The current country code is CN. //Set country code to JP. 2.3.1.11. AT+QWIFICFG='stainfo' Get Station Information This command gets station information of AP mode. AT+QWIFICFG='stainfo' Get Station Information Write Command AT+QWIFICFG='stainfo' Response … +QWIFICFG: 'stainfo',,,,, … OK Characteristics If there is any error: ERROR / Parameter Integer type. Station serial number. String type. Station mac address. String type. Station IPv4 address. String type. Station IPv6 address. String type. Station host name. EC2x_Series&EG25-G_Wi-Fi_Application_Note 22 / 44 LTE Standard Module Series 2.3.1.12. AT+QWIFICFG='scan' Scan Wi-Fi Hotspot Information This command scans Wi-Fi hotspot information for working in STA mode. AT+QWIFICFG='scan' Scan Wi-Fi Hotspot Information Write Command AT+QWIFICFG='scan'[,] Response If the optional parameter is omitted or set to 0, current information is returned: … +QWIFICFG: 'scan',,,, … OK If is set to 1: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s / Parameter Integer type. Way of returning hotspot information. 0 Return hotspot information synchronously. 1 Return hotspot information asynchronously. Hotspot information will be returned via a URC after executing AT+QWIFICFG='scanresult'. String type. Hotspot MAC address. String type. Hotspot SSID. Integer type. Hotspot signal quality. Range: -95 to -1. The smaller the value, the poorer the signal quality. Integer type. Authentication type. 0 Open system authentication 2 WPA 3 WPA2 4 WPA/WPA2 EC2x_Series&EG25-G_Wi-Fi_Application_Note 23 / 44 LTE Standard Module Series 2.3.1.13. AT+QWIFICFG='scanresult' Get Wi-Fi Scanning Hotspot Information Result This command gets Wi-Fi scanning hotspot information result. AT+QWIFICFG='scanresult' Get Wi-Fi Scanning Hotspot Information Result Write Command AT+QWIFICFG='scanresult' Response … +QWIFICFG: 'scan',,,, … OK Maximum Response Time 30 s Characteristics / Parameter String type. Hotspot MAC address. String type. Hotspot SSID. Integer type. Hotspot signal quality. Range: -95 to -1. The smaller the value, the poorer the signal quality. Integer type. Authentication type. 0 Open system authentication 2 WPA 3 WPA2 4 WPA/WPA2 2.3.1.14. AT+QWIFICFG='stastatus' Get Connection Information of STA Mode This command gets connection information of STA mode. AT+QWIFICFG='stastatus' Get Connection Information of STA Mode Write Command AT+QWIFICFG='stastatus' Response +QWIFICFG: 'stastatus',,,,, OK Characteristics If there is any error: ERROR / EC2x_Series&EG25-G_Wi-Fi_Application_Note 24 / 44 LTE Standard Module Series Parameter Integer type. STA mode connection status. Range: 0–1. When it is 0, , , and should be omitted. 0 Disconnected 1 Connected String type. Access hotspot SSID. String type. Access hotspot MAC address. Integer type. Access hotspot channel. 0 Automatic selection 1–13 2.4 GHz channel 36/40/44/48/52/56/60/64/100/104/108/112/116/120/124/128/132/136/140/144/149/ 153/157/161/165/170/171/172/173/174/175/176/177/178/179/180/181/1 82/183/184 5 GHz channel Integer type. Access hotspot signal quality. Range: -95 to -1. The smaller the value, the poorer the signal quality. 2.3.1.15. AT+QWIFICFG='speedlimit' Control Wi-Fi Downlink Speed AT+QWIFICFG='speedlimit' Control Wi-Fi Downlink Speed Write Command AT+QWIFICFG='speedlimit'[,] Response If the optional parameter is omitted, query the current configuration: +QWIFICFG: 'speedlimit', OK If the optional parameter is specified, configure Wi-Fi downlink speed: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configurations are not saved. Parameter Integer type. Wi-Fi downlink speed. Range: 0–100. Unit: Mbps. EC2x_Series&EG25-G_Wi-Fi_Application_Note 25 / 44 LTE Standard Module Series 2.3.1.16. AT+QWIFICFG='datarate' Check Wi-Fi Data Rate AT+QWIFICFG='datarate' Check Wi-Fi Data Rate Write Command AT+QWIFICFG='datarate',[ ,] Response +QWIFICFG:'datarate',RxRate ,TxRate OK Maximum Response Time Characteristics If there is any error: ERROR 30S / Parameter String type. Work mode of Wi-Fi. 'AP' 'STA' Integer type. Index of Wi-Fi in different work modes. This parameter must be specified if =3 in AT+QWIFICFG='workmode' and =AP. 0 AP0 1 AP1 String type. Wi-Fi data rate. 2.3.1.17. AT+QWIFICFG='traffictransf' Check Wi-Fi Traffic This command checks the received and transmitted traffic of Wi-Fi. AT+QWIFICFG='traffictransf' Check Wi-Fi Traffic Write Command AT+QWIFICFG='traffictransf',[,] Response +QWIFICFG:'traffictransf',Rx:,Tx: OK Maximum Response Time Characteristics If there is any error: ERROR 30 s / EC2x_Series&EG25-G_Wi-Fi_Application_Note 26 / 44 LTE Standard Module Series Parameter String type. Work mode. 'AP' 'STA' Integer type. Index of Wi-Fi in different work modes. This parameter must be specified if =3 in AT+QWIFICFG='workmode' and =AP. 0 AP0 1 AP1 Integer type. Received traffic. Unit: byte. Integer type. Transmitted traffic. Unit: byte. 2.3.2. AT+QWIFI Enable/Disable Wi-Fi Function This command enables or disables Wi-Fi function. AT+QWIFI Enable/Disable Wi-Fi Function Test Command AT+QWIFI=? Response +QWIFI: (list of supported s) Read Command AT+QWIFI? OK Response +QWIFI: Write Command AT+QWIFI= OK Response OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Enable or disable Wi-Fi function. 0 Disable Wi-Fi function 1 Enable Wi-Fi function EC2x_Series&EG25-G_Wi-Fi_Application_Note 27 / 44 Example AT+QWIFI? +QWIFI: 0 OK AT+QWIFI=1 OK LTE Standard Module Series //Wi-Fi function is currently disabled. //Enable Wi-Fi function. 2.3.3. AT+QWSSIDHEX Set SSID Encoding This command sets the SSID encoding. AT+QWSSIDHEX Set SSID Encoding Test Command AT+QWSSIDHEX=? Response +QWSSIDHEX: (list of supported s) Read Command AT+QWSSIDHEX? OK Response +QWSSIDHEX: Write Command AT+QWSSIDHEX= OK Response OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Set the of AT+QWSSID to be in HEX format or string format. is saved separately. See AT+QWSSID in Chapter 2.3.4. 0 of AT+QWSSID is a string 1 of AT+QWSSID is a HEX number Example AT+QWSSIDHEX? +QWSSIDHEX: 0 //The SSID is in string format. EC2x_Series&EG25-G_Wi-Fi_Application_Note 28 / 44 LTE Standard Module Series OK AT+QWSSID? +QWSSID: QSoftAP //The SSID is QSoftAP. OK AT+QWSSIDHEX=1 OK AT+QWSSID? +QWSSID: 5175656374656c2d57494649 //Set SSID to be in HEX format. //The SSID is Quectel-WIFI in ASCII encoding. OK 2.3.4. AT+QWSSID Set SSID This command sets Wi-Fi SSID. AT+QWSSID Set SSID Test Command AT+QWSSID=? Read Command AT+QWSSID? Write Command AT+QWSSID= Maximum Response Time Characteristics Response +QWSSID: OK Response +QWSSID: OK Response OK If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter When AT+QWSSIDHEX=0: String type. A series of ASCII characters not larger than 32 bytes. Default value: QSoftAP. When AT+QWSSIDHEX=1: String type. HEX digits. The length of raw data is no more than 32 bytes after coding (in GBK, UTF-8, etc.). It is mainly used to set SSID in Chinese. EC2x_Series&EG25-G_Wi-Fi_Application_Note 29 / 44 Example AT+QWSSIDHEX? +QWSSIDHEX: 0 OK AT+QWSSID? +QWSSID: QSoftAP OK AT+QWSSID=EC25_WIFI OK LTE Standard Module Series //The SSID is QSoftAP. //Set new SSID to EC25_WIFI. 2.3.5. AT+QWBCAST Enable/Disable Broadcast This command enables or disables the broadcast. AT+QWBCAST Enable/Disable Broadcast Test Command AT+QWBCAST=? Response +QWBCAST: (list of supported s) Read Command AT+QWBCAST? OK Response +QWBCAST: Write Command AT+QWBCAST= OK Response OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Enable or disable broadcast. 0 Disable broadcast 1 Enable broadcast EC2x_Series&EG25-G_Wi-Fi_Application_Note 30 / 44 Example AT+QWBCAST? +QWBCAST: 1 OK AT+QWBCAST=0 OK LTE Standard Module Series //The broadcast is enabled. //The broadcast is disabled. 2.3.6. AT+QWAUTH Set Network Authentication Type, Encryption Mode and Password This command sets network authentication type, encryption mode, and password. AT+QWAUTH Set Network Authentication Type, Encryption Mode and Password Test Command AT+QWAUTH=? Response +QWAUTH: (list of supported s) Read Command AT+QWAUTH? OK Response +QWAUTH: [,,] Write Command AT+QWAUTH=,[,] OK Response OK If there is any error: ERROR Maximum Response Time 30 s Characteristics The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Authentication type. 1 Open 3 WPA 4 WPA2 5 WPA/WPA2 Integer type. Encryption mode. 0 No encryption 2 TKIP EC2x_Series&EG25-G_Wi-Fi_Application_Note 31 / 44 3 AES 4 TKIP-AES String type. Password string. LTE Standard Module Series NOTE The default network authorization mode is WPA2, encryption mode is AES, and password is 1234567890. The setting of these parameters should comply with the following criteria: 1. If is 1, must be 0. 2. If ≥ 3, must ≥ 2. 3. If = 0, is null. 4. If ≥ 2, needs 8–63 ASCII characters or 8 to 64-byte HEX number, and '' needs to be added to ASCII characters. Example AT+QWAUTH? +QWAUTH: 4,3,'1234567890' OK AT+QWAUTH=1,0 OK AT+QWAUTH=5,4,'12345678' OK //Set authorization type as open and encryption mode as null. //Set authorization type to WPA/WPA2 and encryption, mode to TIKP-AES, and password to 12345678. 2.3.7. AT+QWMOCH Set Frequency Mode and Channel of 802.11 Network This command sets the frequency mode and channel of 802.11 network. AT+QWMOCH Set Frequency Mode and Channel of 802.11 Network Test Command AT+QWMOCH=? Response +QWMOCH: (range of supported s),(list of supported s) Read Command AT+QWMOCH? OK Response +QWMOCH: , Write Command AT+QWMOCH=, OK Response OK EC2x_Series&EG25-G_Wi-Fi_Application_Note 32 / 44 LTE Standard Module Series Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. 802.11 network frequency mode. 1 a/n 5 GHz HT20 mode 2 b 2.4 GHz mode 3 b/g 2.4 GHz mode 4 b/g/n 2.4 GHz mode 5 b/g/n 5 GHz HT40 mode 6 a/n 5 GHz HT40 mode 7 a 5 GHz mode 8 g 2.4 GHz mode 9 a/n 5 GHz HT20 mode 10 ac 5 GHz VHT40 mode 11 ac 5 GHz VHT80 mode 12 n 2.4 GHz HT20 mode 13 n 2.4 GHz HT40 mode 14 n 5 GHz HT20 mode 15 n 5 GHz HT40 mode Integer type. 802.11 network channel. 0 Automatic selection 1–13 2.4 GHz channel 36/40/44/48/52/56/60/64/100/104/108/112/116/120/124/128/132/136/140/144/149/153/157 /161/165/170/171/172/173/174/175/176/177/178/179/180/181/182/183/184 5 GHz channel NOTE and should meet the following requirements: 1. If is 1/6/7/9/10/11/14/15, must be set to 0 or 36/40/44/48/52/56/60/64/ 100/104/108/112/116/120/124/128/132/136/140/144/149/153/157/161/165/170/171/172/173/174/ 175/176/177/178/179/180/181/182/183/184, and the client device must support 5 GHz mode. 2. If is 2/3/4/5/8/12/13, must be set to 0–13. EC2x_Series&EG25-G_Wi-Fi_Application_Note 33 / 44 Example AT+QWMOCH? +QWMOCH: 4,0 OK AT+QWMOCH=3,1 OK LTE Standard Module Series //Current frequency mode is 2.4 GHz 802.11b/g/n, and the channel is automatically selected. //Set frequency mode as 2.4 GHz 802.11b/g and network channel to channel 1. 2.3.8. AT+QWISO Enable/Disable Isolation Among Clients Connected to AP This command enables or disables isolation among clients connected to AP. AT+QWISO Enable/Disable Isolation Among Clients Connected to AP Test Command AT+QWISO=? Response +QWISO: (list of supported s) Read Command AT+QWISO? OK Response +QWISO: Write Command AT+QWISO= OK Response OK Maximum Response Time Characteristics If there is any error: ERROR 30 s The command takes effect immediately. The configuration is saved automatically. Parameter Integer type. Enable or disable isolation among clients connected to AP. 0 Disable isolation 1 Enable isolation EC2x_Series&EG25-G_Wi-Fi_Application_Note 34 / 44 Example AT+QWISO? +QWISO: 1 OK AT+QWISO=0 OK LTE Standard Module Series //Currently isolation is enabled. //Disable isolation. 2.3.9. AT+QWCLICNT Query Number of Wi-Fi Clients This command queries the number of Wi-Fi clients connected to AP. AT+QWCLICNT Query Number of Wi-Fi Clients Read Command AT+QWCLICNT? Response +QWCLICNT: OK Characteristics / Parameter Integer type. Number of clients connected to AP. Default value: 16. Range: 1–16. Example AT+QWCLICNT? +QWCLICNT: 16 OK //Currently, 16 clients are connected to AP. 2.3.10. AT+QWRSTD Restore Default Settings This command restores Wi-Fi to default settings. AT+QWRSTD Restore Default Settings Execution Command AT+QWRSTD Response OK Maximum Response Time 30 s Characteristics The command takes effect immediately. The configuration is saved automatically. EC2x_Series&EG25-G_Wi-Fi_Application_Note 35 / 44 Example AT+QWRSTD OK //Restore Wi-Fi to default settings. LTE Standard Module Series 2.3.11. AT+QWIFICON Check Whether a TE device accesses the Internet in Wi-Fi AP mode This command checks whether a TE device accesses the Internet in Wi-Fi AP mode. AT+QWIFICON Check Whether a TE device accesses the Internet in Wi-Fi AP mode Execution Command AT+QWIFICON Response +QWIFICON: 'status', Maximum Response Time Characteristics OK 3 s The command takes effect immediately. Parameter Integer type. Indicate whether a TE device accesses the Internet in Wi-Fi AP mode. 0 Disconnected 1 Connected 2 Signal unavailable Example AT+QWIFICON +QWIFICON: 'status',0 OK NOTE The command only supports the network situation when Wi-Fi is in AP mode. EC2x_Series&EG25-G_Wi-Fi_Application_Note 36 / 44 LTE Standard Module Series 2.3.12. AT+QCFG='sdio_clk' Set WLAN SDIO Clock This command sets WLAN SDIO clock. AT+QCFG='sdio_clk' Set WLAN SDIO Clock Read Command AT+QCFG='sdio_clk' Response +QCFG: 'sdio_clk', Write Command AT+QCFG='sdio_clk', OK Response OK Maximum Response Time Characteristics If there is any error: ERROR 30 s This command takes effect after the module is rebooted. The configuration is saved automatically. Parameter Integer type. WLAN SDIO clock type. 0 50 MHz 1 100 MHz 2 200 MHz 3 20 MHz 4 25 MHz Example AT+QCFG='sdio_clk' +QCFG='sdio_clk',0 OK AT+QCFG='sdio_clk',2 OK //The WLAN SDIO clock is 50 MHz. //Set WLAN SDIO clock as 200 MHz. EC2x_Series&EG25-G_Wi-Fi_Application_Note 37 / 44 LTE Standard Module Series 3 Description of URCs 3.1. +QWIFIND URC of Client Connection Status After Wi-Fi is enabled (AT+QWIFI=1), the URC will be reported to indicate if a client is connected or disconnected to AP and the MAC address of the client. +QWIFIND URC of Client Connection Status +QWIFIND: , Indicate the client connection/disconnection status and MAC address of the client. Parameter Integer type. Client connection/disconnection status. 0 Client is disconnected to AP 1 Client is connected to AP String type. MAC address of the client. Format: HEX number, such as '0A:0B:0C:0D:0E:0F'. Example +QWIFIND: 1,'0A:0B:0C:0D:0E:0F' //The client is connected to AP and the MAC address is '0A:0B:0C:0D:0E:0F'. +QWIFIND: 0,'0A:0B:0C:0D:0E:0F' //The client is disconnected to AP and the MAC address is '0A:0B:0C:0D:0E:0F'. EC2x_Series&EG25-G_Wi-Fi_Application_Note 38 / 44 LTE Standard Module Series 3.2. +QWIFICFG='stastatus' URC of STA Connection Status After Wi-Fi is enabled (AT+QWIFI=1), when a client in STA mode is connected or disconnected to AP, a URC will be reported to indicate the status and AP information automatically. +QWIFICFG='stastatus' URC of STA Connection Status +QWIFICFG:'stastatus',[,] URC will be reported. Parameter Integer type. STA mode connection status. 0 Disconnected 1 Connected String type. Access hotspot SSID. When =0, should be omitted. 3.3. +QWIFCFG='scandone' URC of Finishing STA Scanning After executing AT+QWIFICFG='scan',1, a URC will be reported when Wi-Fi STA scanning is finished. +QWIFCFG='scandone' URC of Finishing STA Scan +QWIFICFG: 'scandone', When the Wi-Fi STA scanning is finished, this URC will be reported. Parameter Integer type. Scanning status. 1 Scanning finished EC2x_Series&EG25-G_Wi-Fi_Application_Note 39 / 44 LTE Standard Module Series 4 Examples 4.1. Single AP Mode AT+QWIFICFG='workmode',0 OK AT+QWIFICFG='ssid',0,'AP-MODE-TEST' OK AT+QWIFICFG='channel',0,5 OK AT+QWIFICFG='mode',0,4 OK AT+QWIFICFG='auth',0,3,2,'1234567890' OK AT+QWIFI=1 OK //Set work mode to single AP (AP0). //Set the SSID of AP0 to AP-MODE-TEST. //Set the channel of AP0 to 5. //Set the frequency mode of AP0 to 802.11b/g/n. //Set the authentication type of AP0 to WPA2 personal authentication, encryption mode to TKIP and AES, and password to '1234567890'. //Enable Wi-Fi function. 4.2. Single STA Mode AT+QWIFICFG='workmode',1 OK AT+QWIFICFG='ssid',2,QSoftAP OK AT+QWIFICFG='auth',2,0 OK AT+QWIFI=1 OK //Set work mode to single STA. //Set the SSID of STA to QSoftAP. //Set the authentication type of STA to open system authentication. //Enable Wi-Fi function. EC2x_Series&EG25-G_Wi-Fi_Application_Note 40 / 44 4.3. AP0 + AP1 Mode AT+QWIFICFG='workmode',3 OK AT+QWIFICFG='ssid',0,QSoftAP-2.4G OK AT+QWIFICFG='ssid',1,QSoftAP-5G OK AT+QWIFI=1 OK LTE Standard Module Series //Set work mode to AP0 + AP1. //Set SSID of AP0 to QSoftAP-2.4 GHz. //Set SSID of AP1 to QSoftAP-5 GHz. //Enable Wi-Fi function. 4.4. AP + STA Mode AT+QWIFICFG='workmode',2 OK AT+QWIFICFG='ssid',0,'AP-MODE-TEST' OK //Set work mode to AP + STA mode. //Set SSID of AP0 to AP-MODE-TEST. AT+QWIFICFG='ssid',2,QSoftAP //Set SSID of STA to QSoftAP. OK AT+QWIFICFG='auth',2,4,2,'1234567890' OK AT+QWIFI=1 OK //Set authentication type of STA to WPA/WPA2 personal authentication, encryption mode to TKIP and AES, and password to '1234567890'. //Enable Wi-Fi function. 4.5. Scan Hotspots Nearby AT +QWIFICFG='workmode',1 OK AT+QWIFI=1 OK AT+QWIFICFG='scan',0 //Set work mode to single STA. //Enable Wi-Fi function. //Set Wi-Fi to scan and return hotspot information synchronously. EC2x_Series&EG25-G_Wi-Fi_Application_Note 41 / 44 LTE Standard Module Series +QWIFICFG: 'scan','01:02:03:04:05:06','Quectel_WiFi_Test',-34,4 //Return MAC address, SSID, signal, authentication type of the hotspot nearby. …. OK AT+QWIFICFG='scan',1 OK +QWIFICFG: 'scandone',1 //Set Wi-Fi to scan and return hotspot information asynchronously. //If STA is scanned, the URC will be reported. AT+QWIFICFG='scanresult' //Get nearby hotspots information. +QWIFICFG: 'scan','01:02:03:04:05:06','Quectel_WiFi_Test',-34,4 //Return MAC address, SSID, signal, and authentication type of the hotspot nearby. …. OK EC2x_Series&EG25-G_Wi-Fi_Application_Note 42 / 44 LTE Standard Module Series 5 Appendix References Table 3: Related Documents Document Name [1] Quectel_FC20_Series_Hardware_Design [2] Quectel_FC21_Hardware_Design Table 4: Terms and Abbreviations Abbreviation AES AP ASCII GBK GNSS HEX IoT IP IPv4 IPv6 LTE MAC MCU NMEA Description Advanced Encryption Standard Access Point American Standard Code for Information Interchange Chinese Internal Code Specification Global Navigation Satellite System Hexadecimal Internet of Things Internet Protocol Internet Protocol Version 4 Internet Protocol Version 6 Long Term Evolution Media Access Control Microcontroller Unit National Marine Electronics Association EC2x_Series&EG25-G_Wi-Fi_Application_Note 43 / 44 SDIO SSID STA TKIP UART UDP URC USB UTF WEP WLAN WPA WWAN LTE Standard Module Series Secure Digital Input Output Service Set Identifier Station Temporal Key Integrity Protocol Universal Asynchronous Receiver/Transmitter User Datagram Protocol Unsolicited Result Code Universal Serial Bus Unicode Transformation Format Wired Equivalent Privacy Wireless Local Area Network Wi-Fi Protected Access Wireless Wide Area Network EC2x_Series&EG25-G_Wi-Fi_Application_Note 44 / 44

UG96 DSSS Application Note UMTS/HSPA Module Series Rev. UG96_DSSS_Application_Note_V1.0 Date: 2018-01-12 Status: Released www.quectel.com UMTS/HSPA Module Series UG96 DSSS Application Note 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. UG96_DSSS_Application_Note 1 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note About the Document History Revision 1.0 Date 2018-01-12 Author Winnie XI/ Yeoman CHEN Description Initial UG96_DSSS_Application_Note 2 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 4 1 Introduction ....................................................................................................................................... 5 2 DSSS Overview ................................................................................................................................. 6 3 DSSS Related AT Command ............................................................................................................ 7 3.1. AT+QDSIM Set the Level of Pin AP_READY ..................................................................... 7 4 Schematic .......................................................................................................................................... 8 5 Appendix A References .................................................................................................................. 10 UG96_DSSS_Application_Note 3 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note Table Index TABLE 1: TRUTH TABLE OF ANALOG SWITCH ............................................................................................... 8 TABLE 2: RECOMMENDED ANALOG SWITCHES ........................................................................................... 8 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 10 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 10 UG96_DSSS_Application_Note 4 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note 1 Introduction This document gives a brief introduction on how to use the DSSS (Dual SIM Single Standby) function of Quectel UG96 module. UG96_DSSS_Application_Note 5 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note 2 DSSS Overview Quectel UG96’s DSSS function provides a solution for dual (U)SIM card switching. This function allows customers to switch from one (U)SIM card to another (U)SIM card. The (U)SIM card switching can be controlled by UG96's pin 19 AP_READY, which can be controlled by AT+QDSIM. When the pin is switched to low level by AT+QDSIM=0, (U)SIM1 card will be active; and when it is switched to high level by AT+QDSIM=1, (U)SIM2 card will be active. For more details about the AT command, please refer to Chapter 3.1. The pin does not require external pull-down or pull-up. AP_READY is at low level by default, and restarting of module will not affect its level setting. For instance, when the pin is at high level, unless AT+QDSIM=0 is executed to change it to low; otherwise it stays at high level even after the module is restarted. However, when the module is reset, the pin will change to its default low level. UG96_DSSS_Application_Note 6 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note 3 DSSS Related AT Command 3.1. AT+QDSIM Set the Level of Pin AP_READY The command can set the level of pin AP_READY to high or low. AT+QDSIM Set the Level of Pin AP_READY Test Command AT+QDSIM=? Response +QDSIM: (0,1) Read Command AT+QDSIM? OK Response +QDSIM: Write Command AT+QDSIM= OK Response OK or ERROR Parameter Integer type. Set the level of pin AT_READY. 0 Pin AP_READY will be at low level. 1 Pin AP_READY will be at high level. Example AT+QDSIM=0 AT+QDSIM=1 //AP_READY will be at low level, and (U)SIM1 card will be active. //AP_READY will be at high level, and (U)SIM2 card will be active. UG96_DSSS_Application_Note 7 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note 4 Schematic The schematic of DSSS function illustrated below is provided for your reference only. Figure 1: Reference Design of DSSS Solution The following two tables show the truth table of analog switch and the recommended analog switches. Table 1: Truth Table of Analog Switch Level of SIM_SEL High Function 1VSIM=VSIM,1RST=RST,1CLK=CLK,1DAT=DAT Low 2VSIM=VSIM, 2RST=RS, 2CLK=CLK, 2DAT=DAT Table 2: Recommended Analog Switches Manufacturer Fairchild Part Number FSA2567MPX Remark The footprints of these three analog UG96_DSSS_Application_Note 8 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note ON Semi ST NLAS3699MN1R2G STG3699QTR switches are compatible among each other. In order to ensure good performance and avoid damage of (U)SIM cards, please follow the criteria below in the circuit design of dual (U)SIM card switching:  The power supply range of FSA2567 is 1.65V~4.3V.  Components in the two dotted boxes should be placed close to (U)SIM card connector.  R108 and R109 can improve anti-jamming capability of the (U)SIM card circuit.  The power supply of VCC_MCU is the same as that of MCU.  When analog switch FSA2567 is used, R107 does not need to be mounted. If analog switch NLAS3699 or STG3699 is used, the R107 should be mounted.  For more details about the design and layout of (U)SIM card circuit, please refer to document [2]. UG96_DSSS_Application_Note 9 / 10 UMTS/HSPA Module Series UG96 DSSS Application Note 5 Appendix A References Table 3: Related Documents SN Document Name Remark AT commands manual for UG96, UG95 [1] Quectel_WCDMA_UGxx_AT_Commands_Manual and UG35 modules [2] Quectel_UG96_Hardware_Design UG96 hardware design Table 4: Terms and Abbreviations Abbreviation DSSS Description Dual SIM Single Standby MCU Micro Control Unit (U)SIM (Universal) Subscriber Identity Module UG96_DSSS_Application_Note 10 / 10

EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 LTE Standard 模块系列 版本：1.1 日期：2022-06-07 状态：受控文件 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2022，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2022. 上海移远通信技术股份有限公司 2 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2020-05-15 2020-05-15 2022-06-07 作者 变更表述 Domingo DENG 文档创建 Domingo DENG Larson LI 受控版本 1. 删除适用模块 EC20-CN 和 EP200F-CE。 2. 新增 AT+QHTTPCFG='contenttype' AT+QHTTPCFG='custom_header' AT+QHTTPCFG='windowsize' AT+QHTTPCFG='closewaittime' AT+QHTTPCFG='auth'（第 2.1 章）。 3. 更新 AT+QHTTPCFG='closed/ind'的参 数解释（第 2.1 章）。 4. 新增 AT+QHTTPPUT（第 2.7 章）。 5. 新增 AT+QHTTPPUTFILE（第 2.8 章）。 6. 新增 AT+QHTTPCFGEX（第 2.11 章）。 7. 新增 AT+QHTTPSEND（第 2.12 章）。 8. 新增发送 HTTP PUT 请求相关举例（第 3.1.3 章）。 9. 新增发送 HTTP SEND 请求相关举例（第 3.1.4 章）。 10. 新增发送 HTTPS PUT 请求相关举例（第 3.2.3 章）。 11. 新增发送 HTTPS SEND 请求相关举例（第 3.2.4 章）。 上海移远通信技术股份有限公司 3 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块......................................................................................................................................... 7 1.2. AT 命令说明 ................................................................................................................................... 8 1.2.1. 定义......................................................................................................................................... 8 1.2.2. AT 命令语句........................................................................................................................... 8 1.3. AT 示例声明 ................................................................................................................................... 8 1.4. HTTP(S)命令使用流程 ................................................................................................................... 9 1.5. HTTP(S)请求头信息说明 ............................................................................................................... 9 1.5.1. 自定义 HTTP(S)请求头信息 ................................................................................................... 9 1.5.2. 输出 HTTP(S)响应头信息 ..................................................................................................... 10 1.6. 数据模式说明 ............................................................................................................................... 10 2 HTTP(S) AT 命令详解......................................................................................................................... 11 2.1. AT+QHTTPCFG 配置 HTTP(S)服务器参数............................................................................... 11 2.2. AT+QHTTPURL 设置 HTTP(S)服务器 URL .............................................................................. 15 2.3. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器.................................................................. 16 2.4. AT+QHTTPGETEX 发送 GET 请求到 HTTP(S)服务器获取指定范围数据................................ 18 2.5. AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 ................................. 19 2.6. AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器....................................... 20 2.7. AT+QHTTPPUT 通过 UART/USB 发送 PUT 请求到 HTTP(S)服务器....................................... 22 2.8. AT+QHTTPPUTFILE 通过文件发送 PUT 请求到 HTTP(S)服务器 ............................................ 23 2.9. AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 ......................................... 25 2.10. AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息............................................... 26 2.11. AT+QHTTPCFGEX 配置发送的文件和参数 .............................................................................. 27 2.12. AT+QHTTPSEND 通过文件向 HTTP(S)发送 POST 请求 ......................................................... 28 2.13. AT+QHTTPSTOP 取消 HTTP(S)请求 ....................................................................................... 29 3 举例 ..................................................................................................................................................... 30 3.1. 访问 HTTP 服务器........................................................................................................................ 30 3.1.1. 发送 HTTP GET 请求并读取响应信息 .................................................................................. 30 3.1.2. 发送 HTTP POST 请求并读取响应信息................................................................................ 31 3.1.2.1. 通过 UART/USB 获取 POST 请求体................................................................................. 31 3.1.2.2. 从文件系统获取 POST 请求体 .......................................................................................... 33 3.1.3. 发送 HTTP PUT 请求并读取响应信息 .................................................................................. 34 3.1.3.1. 通过 UART/USB 获取 PUT 请求体 ................................................................................... 34 3.1.3.2. 从文件系统获取 PUT 请求体............................................................................................. 35 3.1.4. 通过文件向 HTTP 发送 POST 请求 ...................................................................................... 36 3.2. 访问 HTTPS 服务器 ..................................................................................................................... 37 上海移远通信技术股份有限公司 4 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 3.2.1. 发送 HTTPS GET 请求并读取响应信息................................................................................ 37 3.2.2. 发送 HTTPS POST 请求并读取响应信息 ............................................................................. 38 3.2.2.1. 从 UART/USB 获取 POST 请求体 .................................................................................... 38 3.2.2.2. 从文件系统获取请求体...................................................................................................... 40 3.2.3. 发送 HTTPS PUT 请求并读取响应信息................................................................................ 41 3.2.3.1. 从 UART/USB 获取 PUT 请求体 ....................................................................................... 41 3.2.3.2. 从文件系统获取 PUT 请求体............................................................................................. 43 3.2.4. 通过文件向 HTTPS 发送 POST 请求.................................................................................... 44 4 常见问题处理....................................................................................................................................... 47 4.1. HTTP(S) AT 命令执行失败........................................................................................................... 47 4.2. PDP 激活失败 .............................................................................................................................. 47 4.3. DNS 解析失败 .............................................................................................................................. 48 4.4. 数据模式进入失败 ........................................................................................................................ 48 4.5. GET/POST/PUT 请求发送失败.................................................................................................... 48 4.6. 响应信息读取失败 ........................................................................................................................ 49 5 错误代码 .............................................................................................................................................. 50 6 HTTP(S)响应错误代码 ........................................................................................................................ 52 7 附录 参考文档及术语缩写 .................................................................................................................. 53 上海移远通信技术股份有限公司 5 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型 ....................................................................................................................................... 8 表 3：错误代码列表.................................................................................................................................... 50 表 4：HTTP(S)响应代码列表 ..................................................................................................................... 52 表 5：参考文档 ........................................................................................................................................... 53 表 6：术语缩写 ........................................................................................................................................... 53 上海移远通信技术股份有限公司 6 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 1 引言 移远通信 LTE Standard EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块为 HTTP(S)服务器提供 HTTP(S)应用程序。本文档主要介绍了与 HTTP(S)相关的 AT 命令。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x 系列 EG2x-G EG9x 系列 EM05 系列 模块 EC21 系列 EC25 系列 EC20-CE EG21-G EG25-G EG91 系列 EG95 系列 EM05 系列 上海移远通信技术股份有限公司 7 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 1.2. AT 命令说明 1.2.1. 定义 ⚫ ⚫ ⚫ ⚫ […] ⚫ 下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 1.2.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 8 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 1.4. HTTP(S)命令使用流程 通过 LTE Standard EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块的 TCP/IP AT 命令，可配置 PDP 上下文、激活/去激活 PDP 上下文以及查询上下文状态。通过 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块的 HTTP(S) AT 命令，可以发送 HTTP(S) GET/POST/PUT 请求到 HTTP(S)服务器，并读 取来自 HTTP(S)服务器的响应结果。大致流程如下： 第一步，使用 AT+QICSGP 配置 PDP 上下文的、、和其他参数，详 见文档 [1]。可通过 AT+CGQMIN、AT+CGEQMIN、AT+CGQREQ 和 AT+CGEQREQ 更新 QoS 设置， 详见文档 [2]。 第二步，通过 AT+QIACT 激活 PDP 上下文后，可使用 AT+QIACT?查询已分配的 IP 地址，详见文档 [1]。 第三步，通过 AT+QHTTPCFG 配置 PDP 和 SSL 上下文 ID。 第四步，通过 AT+QSSLCFG 配置 SSL 上下文参数，详见文档 [3]。 第五步，通过 AT+QHTTPURL 设置 HTTP(S) URL。 第六步，发送 HTTP(S)请求。AT+QHTTPGET 用于发送 HTTP(S) GET 请求，AT+QHTTPGETEX 用 于发送 HTTP(S)范围 GET 请求。AT+QHTTPPOST、AT+QHTTPPOSTFILE 或 AT+QHTTPSEND 用于发 送 HTTP(S) POST 请求。AT+QHTTPPUT 或 AT+QHTTPPUTFILE 用于发送 HTTP(S) PUT 请求。 第七步，通过 AT+QHTTPREAD 或 AT+QHTTPREADFILE 读取 HTTP(S)响应信息。 第八步，通过 AT+QIDEACT 去激活 PDP 上下文，详见文档 [1]。 1.5. HTTP(S)请求头信息说明 1.5.1. 自定义 HTTP(S)请求头信息 模块自动填补 HTTP(S)请求头信息，用户可通过 AT+QHTTPCFG 将配置为 1 自定 义 HTTP(S)请求头信息，但需遵循以下标准： ⚫ 遵循 HTTP(S)头信息语句规范。 ⚫ HTTP(S)请求行中的 URL 值和 Host:头信息必须与 AT+QHTTPURL 配置的 URL 一致。 ⚫ HTTP(S)请求头信息必须以结尾。 以下为有效的 HTTP(S) POST 请求头信息示例： POST /processorder.php HTTP/1.1 上海移远通信技术股份有限公司 9 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 Host: 220.180.239.212:8011 Accept: */* User-Agent: QUECTEL_MODULE Connection: Keep-Alive Content-Type: application/x-www-form-urlencoded Content-Length: 48 Message=1111&Appleqty=2222&Orangeqty=3333&find=1 1.5.2. 输出 HTTP(S)响应头信息 模块不自动输出 HTTP(S)响应头信息，可通过 AT+QHTTPCFG 将配置为 1 获取 HTTP(S)响应头信息，然后执行 AT+QHTTPREAD 或 AT+QHTTPREADFILE 命令，HTTP(S)响应头信息 将以 HTTP(S)响应体形式输出。 1.6. 数据模式说明 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块的 COM 口有两种工作模式：一种是 AT 命令模 式，另一种是数据模式。在 AT 命令模式下，通过 COM 口输入的数据被认为是 AT 命令；在数据模式下， 则被认为是数据。 ⚫ 退出数据模式 用户可以通过+++或者DTR（需先设置AT&D1）两种方式退出数据模式，为了防止+++被当成数据发送， 实际操作时必须遵循以下标准： a) +++输入前后 1 秒内不能输入其它任何数据。 b) 必须在 1 秒内输入+++，并且不能输入其它任何数据。若返回 OK，则表示模块成功退出数据模式。 ⚫ 进入数据模式 通 过 执 行 AT+QHTTPURL 、 AT+QHTTPPOST 、 AT+QHTTPPUT 、 AT+QHTTPSEND 和 AT+QHTTPREAD 可使 COM 口进入数据模式，但在这些命令响应之前，若通过+++或拉高 DTR 退出数据 模式，会中断这些命令的执行。在这种情况下，无法通过执行 ATO 命令使 COM 口重新进入数据模式。 上海移远通信技术股份有限公司 10 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 2 HTTP(S) AT 命令详解 2.1. AT+QHTTPCFG 配置 HTTP(S)服务器参数 该命令用于配置 HTTP(S)服务器参数，包括配置 PDP 上下文 ID、自定义 HTTP(S)请求头信息、输出 HTTP(S)响应头信息和查询 SSL 设置。若执行设置命令时省略可选参数，表示查询当前配置。 AT+QHTTPCFG 配置 HTTP(S)服务器参数 测试命令 AT+QHTTPCFG=? 响应 +QHTTPCFG: 'contextid',(支持的范围) +QHTTPCFG: 'requestheader',(支持的 列表) +QHTTPCFG: 'responseheader',(支持的列表) +QHTTPCFG: 'sslctxid',(支持的范围) +QHTTPCFG: 'contenttype',(支持的范围) +QHTTPCFG: 'rspout/auto',(支持的列表) +QHTTPCFG: 'closed/ind',(支持的列表) +QHTTPCFG: 'windowsize',(支持的范围) +QHTTPCFG: 'closewaittime',(支持的 范围) +QHTTPCFG: 'auth',('username:password') +QHTTPCFG: 'custom_header',('custom_value') 查询命令 AT+QHTTPCFG? OK 响应 +QHTTPCFG: 'contextid', +QHTTPCFG: 'requestheader', +QHTTPCFG: 'responseheader', +QHTTPCFG: 'sslctxid', +QHTTPCFG: 'contenttype', +QHTTPCFG: 'rspout/auto', +QHTTPCFG: 'closed/ind', +QHTTPCFG: 'windowsize', +QHTTPCFG: 'closewaittime', +QHTTPCFG: 'auth',':' 上海移远通信技术股份有限公司 11 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 +QHTTPCFG: 'custom_header','' 设置命令 AT+QHTTPCFG='contextid'[,] OK 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'contextid', OK 设置命令 AT+QHTTPCFG='requestheader'[,] 若指定可选参数，则配置 PDP 上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'requestheader', OK 设置命令 AT+QHTTPCFG='responseheader'[, ] 若指定可选参数，则禁用或启用自定义 HTTP(S)请求头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'responseheader', OK 设置命令 AT+QHTTPCFG='sslctxid'[,] 若指定可选参数，则禁用或启用输出 HTTP(S)响应头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'sslctxid', OK 若指定可选参数，则配置用于 HTTP(S)的 SSL 上下文 ID： OK 或者 +CME ERROR: 上海移远通信技术股份有限公司 12 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 设置命令 AT+QHTTPCFG='contenttype'[,] 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'contenttype', OK 设置命令 AT+QHTTPCFG='rspout/auto'[,] 若指定可选参数，则配置 HTTP(S)体的数据类型： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'rspout/auto', OK 设置命令 AT+QHTTPCFG='closed/ind'[,] 若指定可选参数，则禁用或启用自动输出 HTTP(S)响应头信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'closed/ind', OK 设置命令 AT+QHTTPCFG='windowsize'[,] 若指定可选参数，则禁用或启用上报 HTTP(S)会话关闭 URC +QHTTPURC: 'closed'： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'windowsize', OK 设置命令 AT+QHTTPCFG='closewaittime'[,] 若指定可选参数，则配置 HTTP socket 滑动窗口大小： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'closewaittime', 上海移远通信技术股份有限公司 13 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 OK 设置命令 AT+QHTTPCFG='auth'[,:] 若指定可选参数，则配置 HTTP socket 关闭等待时间： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QHTTPCFG: 'auth',':' 设置命令 AT+QHTTPCFG='custom_header'[,' '] OK 若指定可选参数，则配置 HTTP 登录的用户名和密码： OK 或者 ERROR 响应 若省略可选参数，则查询当前配置： +QHTTPCFG:'custom_header','' OK 最大响应时间 特性说明 若指定可选参数，则配置客户自定义 HTTP 头： OK 或者 ERROR 200 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。PDP 上下文 ID。范围：1~16；默认值：1。 整型。禁用或启用自定义 HTTP(S)请求头信息。 0 禁用 1 启用 整型。禁用或启用输出 HTTP(S)响应头信息。 0 禁用 1 启用 整型。HTTP(S)的 SSL 上下文 ID。范围：0~5；默认值：1。通过 AT+QSSLCFG 配置 SSL 参数，详见文档 [3]。 整型。HTTP(S)体的数据类型。 上海移远通信技术股份有限公司 14 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 0 application/x-www-form-urlencoded 1 text/plain 2 application/octet-stream 3 multipart/form-data 4 application/json 5 image/jpeg 整型。禁用或启用自动输出 HTTP(S)响应头信息。若启用自动输出 HTTP(S) 响应头信息，AT+QHTTPREAD 和 AT+QHTTPREADFILE 会执行失败。 0 禁用 1 启用 整型。禁用或启用上报 HTTP(S)会话关闭 URC +QHTTPURC: 'closed'。 0 禁用 0 启用 字符串类型。表示 HTTP 登录的用户名。 字符串类型。表示 HTTP 登录的密码。 整型。HTTP socket 滑动窗口大小。范围：1~4294967295；默认值：16384 （16 KB）；单位：字节。 整型。HTTP socket 关闭等待时间。范围：0~4294967295；默认值：60000； 单位：毫秒。 字符串类型。用户自定义 HTTP 头。 错误代码。请参考第 5 章。 备注 使用 AT+QHTTPCFG='auth'命令，可以配置 HTTP 登录的用户名和密码，但这种方式仅适用于 HTTP 服务器的基本认证，详见 RFC2616 14.8。 2.2. AT+QHTTPURL 设置 HTTP(S)服务器 URL HTTP(S)服务器的 URL 必须以 http://或 https://开头，表示访问 HTTP 或 HTTPS 服务器。 AT+QHTTPURL 设置 HTTP(S)服务器 URL 测试命令 AT+QHTTPURL=? 响应 +QHTTPURL: ( 支 持 的 范 围 ),( 支 持 的 范围) 查询命令 AT+QHTTPURL? 设置命令 OK 响应 [+QHTTPURL: ] OK 响应 上海移远通信技术股份有限公司 15 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 AT+QHTTPURL=[,] CONNECT TA 切换到透传模式，即可输入 URL。当输入数据的总大小达 到，TA 将切换回命令模式并上报以下结果： OK 若 输 入 时 间 达 到 ， 但 接 收 的 URL 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +CME ERROR: 最大响应时间 特性说明 b) 若参数格式不正确或发生其他错误： +CME ERROR: 由决定 该命令立即生效； 参数配置不保存。 参数 整型。URL 长度。范围：1~2048；单位：字节。 整型。URL 的最大输入时间。范围：1~65535；默认值：60；单位：秒。 错误代码。请参考第 5 章。 2.3. AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器 根 据 在 AT+QHTTPCFG='requestheader'[,] 命 令 中 配 置 的 参 数 ， AT+QHTTPGET 设 置 命 令 有 两 种 形 式 。 若 为 1 ， 发 送 AT+QHTTPGET 命令后，若 125 秒内输出 CONNECT，则表示 HTTP(S)服务器连接成功；若 125 秒内未 上报 CONNECT，将输出+CME ERROR: 。 发送 AT+QHTTPGET 上报 OK 后，需要等待一段时间（参考下表中最大响应时间）才会输出 +QHTTPGET: [,[,]]。 +QHTTPGET: [,[,]] 中 ， 仅 当 为 0 时 ， 才 上 报 。若 HTTP(S)响应头信息包括 CONTENT-LENGTH，将上报信息。 AT+QHTTPGET 发送 GET 请求到 HTTP(S)服务器 测试命令 AT+QHTTPGET=? 响应 +QHTTPGET: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) 上海移远通信技术股份有限公司 16 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 若为 0（禁用自定义 HTTP(S)请求头信息） 设置命令 AT+QHTTPGET[=] OK 响应 a) 若参数格式正确且无其他错误发生： OK 模块收到来自 HTTP(S)服务器的响应后，将上报以下 URC： +QHTTPGET: [,[,]] 若为 1（启用自定义 HTTP(S) GET 请求头信息） 设置命令 AT+QHTTPGET=,[,] b) 若参数格式不正确或有其他错误发生： +CME ERROR: 响应 a) 若 HTTP(S)服务器连接成功： CONNECT TA 切换到透传模式，即可输入 HTTP(S) GET 请求头信息。当 输入数据的总大小达到，TA 将切换回命令模式 并上报以下结果： OK 模块收到来自 HTTP(S)服务器的响应后，将上报以下 URC： +QHTTPGET: [,[,]] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +CME ERROR: 最大响应时间 特性说明 b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由决定 该命令立即生效； 参数配置不保存。 参数 整 型 。 上 报 OK 后 HTTP(S) GET 响 应 +QHTTPGET: [,[,]]的最大输出时间。范围：1~65535； 默认值：60；单位：秒。 整型。HTTP(S) GET 请求信息的长度。包括 HTTP(S) GET 请求头和请求体信息。 范围：1~2048；单位：字节。 整型。HTTP(S) GET 请求信息的最大输入时间。包括 HTTP(S) GET 请求头和请 求体信息。范围：1~65535；默认值：60；单位：秒。 错误代码。请参考第 5 章。 上海移远通信技术股份有限公司 17 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。请参考第 2.1 章。 整型。HTTP(S)响应体长度。单位：字节。 2.4. AT+QHTTPGETEX 发送 GET 请求到 HTTP(S)服务器获取指定范围数据 与读取文件类似，MCU 可以通过 AT+QHTTPGETEX 从 HTTP(S)服务器获取指定位置和指定长度的 数据，该命令仅在 AT+QHTTPCFG='requestheader',0 时可执行。之后，HTTP(S)服务器将始终以 206 代码响应用于获取指定位置和指定长度数据的 GET 请求。 AT+QHTTPGETEX 发送 GET 请求到 HTTP(S)服务器获取指定范围数据 测试命令 AT+QHTTPGETEX=? 响应 +QHTTPGET: (支持的范围),, 设置命令 AT+QHTTPGETEX=,, OK 响应 a) 若参数格式正确且无其他错误发生： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPGET: [,[,]] 最大响应时间 特性说明 b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由决定 该命令立即生效； 参数配置不保存。 参数 整 型 。 上 报 OK 后 ， HTTP(S) GET 响 应 +QHTTPGET: [,[,]]的最大响应时间。范围：1~65535； 默认值：60；单位：秒。 整型。HTTP(S)客户端需要获取数据的初始位置。 整型。HTTP(S)客户端需要获取数据的长度。 错误代码。请参考第 5 章。 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。HTTP(S)响应体长度。单位：字节。 上海移远通信技术股份有限公司 18 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 2.5. AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 该命令用于发送 HTTP(S) POST 请求。根据在 AT+QHTTPCFG='requestheader'[,]命令中配置的，AT+QHTTPPOST 设置命令有两种形式。 ⚫ 若为 0，则通过 UART/USB 口输入 HTTP(S) POST 请求体； ⚫ 若为 1，则通过 UART/USB 口输入 HTTP(S) POST 请求头和请求体信息。 发送 AT+QHTTPPOST 命令后，若 125 秒内返回 CONNECT，则表示 HTTP(S)服务器连接成功；若 125 秒内未返回 CONNECT，将输出+CME ERROR: 。 上报 OK 后，需要等待一段时间（参考下表中最大响应时间）才会输出 URC +QHTTPPOST: [,[,]]。仅当为 0 时，才上报。 AT+QHTTPPOST 通过 UART/USB 发送 POST 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPOST=? 响应 +QHTTPPOST: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) 若为 0（禁用自定义 HTTP(S)请求头信息） 设置命令 AT+QHTTPPOST=[,,] OK 响应 a) 若参数格式正确，HTTP(S)服务器连接成功且 HTTP(S)请 求头信息发送完成： CONNECT TA 切换到透传模式，即可输入 HTTP(S) POST 请求体。当输 入数据总长度达到，TA 将切换回命令模式并上 报以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPOST: [,[,]] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +CME ERROR: 若为 1（启用自定义 HTTP(S)请求头信息） 设置命令 AT+QHTTPPOST=[,<in b) 若参数格式不正确或有其他错误发生： +CME ERROR: 响应 a) 若参数格式正确且 HTTP(S)服务器连接成功： CONNECT 上海移远通信技术股份有限公司 19 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 put_time>,] 最大响应时间 特性说明 TA 切换到透传模式，即可输入 HTTP(S) POST 请求头和请求 体信息。当输入数据总大小达到，TA 将切换回 命令模式并上报以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPOST: [,[,]] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +CME ERROR: b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由网络和决定 该命令立即生效； 参数配置不保存。 参数 整型。若为 0，表示 HTTP(S) POST 请求体长度；若 为 1，表示 HTTP(S) POST 请求信息的长度，包括 HTTP(S) POST 请求头和请求数据。范围：1~1024000；单位：字节。 整型。HTTP(S) POST 请求体或 HTTP(S) POST 请求信息的最大输入时间。 范围：1~65535；默认值：60；单位：秒。 整型。上报 OK 后，HTTP(S) POST 响应+QHTTPPOST: [,[,]]的最大输出时间。范围：1~65535；默认值：60； 单位：秒。 错误代码。请参考第 5 章。 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。请参考第 2.1 章。 整型。HTTP(S)响应体长度。单位：字节。 2.6. AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 该命令可用来通过文件发送 POST 请求到 HTTP(S)服务器。根据在 AT+QHTTPCFG='requestheade r'[,]命令中配置的，AT+QHTTPPOSTFILE 操作的文件有两种形式。 ⚫ 若为 0，文件系统的文件将为 HTTP(S) POST 请求体； ⚫ 若为 1，文件系统的文件将为 POST 请求头和请求体信息。 上海移远通信技术股份有限公司 20 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 执行 AT+QHTTPPOSTFILE 命令后，模块会上报 URC +QHTTPPOSTFILE: [,[, ]]表示命令执行结果。仅当为 0 时，才上报。 上 报 OK 后 ， 需 要 等 待 一 段 时 间 （ 参 考 下 表 中 最 大 响 应 时 间 ） 才 会 输 出 +QHTTPPOSTFILE: [,[,]]信息。 AT+QHTTPPOSTFILE 通过文件发送 POST 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPOSTFILE=? 响应 +QHTTPPOSTFILE: ,( 支 持 的 范 围)[,(支持的范围)] 设置命令 AT+QHTTPPOSTFILE=[, [,]] 若为 1，指定的文件 必须包含 HTTP(S)请求头信息。 OK 响应 a) 若参数格式正确且 HTTP(S)服务器连接成功： OK 当模块收到来自 HTTP(S)服务器响应后： +QHTTPPOSTFILE: [,[,]] 最大响应时间 特性说明 b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由决定 该命令立即生效； 参数配置不保存。 参数 整型。HTTP(S)分段发送文件。 0 直接发送当前文件 1 记录当前要发送的文件名 2 将文件 1 和文件 2 按顺序发出 字符串类型。文件名称。最大长度为 80 字节。 整 型 。 上 报 OK 后 ， HTTP(S) POST 响 应 +QHTTPPOSTFILE: [,[,]] 的 最 大 输 出 时 间 。 范 围 ： 1~65535；默认值：60；单位：秒。 错误代码。请参考第 5 章。 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。请参考第 2.1 章。 整型。HTTP(S)响应体长度。单位：字节。 上海移远通信技术股份有限公司 21 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 2.7. AT+QHTTPPUT 通过 UART/USB 发送 PUT 请求到 HTTP(S)服务器 该命令用于发送 HTTP(S) PUT 请求。根据在 AT+QHTTPCFG='requestheader'[,] 命令中配置的，AT+QHTTPPUT 设置命令有两种格式。 ⚫ 若为 0，则通过 UART/USB 口输入 HTTP(S) PUT 请求体； ⚫ 若为 1，则通过 UART/USB 口输入 HTTP(S) PUT 请求头和请求体信息。 发送 AT+QHTTPPUT 设置命令后，若 125 秒内返回 CONNECT，表示 HTTP(S)服务器连接成功；若 125 秒内未返回 CONNECT，将输出+CME ERROR: 。 上 报 OK 后 ， 需 等 待 一 段 时 间 （ 参 考 下 表 中 最 大 响 应 时 间 ） 才 会 输 出 +QHTTPPUT: [,[,]]。仅当为 0 时，才上报。 AT+QHTTPPUT 通过 UART/USB 发送 PUT 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPUT=? 响应 +QHTTPPUT: ( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) 若为 0（禁用自定义 HTTP(S)请求头信息） 设置命令 AT+QHTTPPUT=[,,] OK 响应 a) 若参数格式正确，HTTP(S)服务器连接成功且 HTTP(S)请 求头信息发送完成： CONNECT TA 切换到透传模式，即可输入 HTTP(S) PUT 请求体。当输入 数据总大小达到，TA 将切换回命令模式并上报 以下结果： OK 模块收到来自 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPUT: [,[,]] 若 输 入 时 间 达 到 ， 但 收 到 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +CME ERROR: 若为 1（启用自定义 HTTP(S)请求头信息） 设置命令 AT+QHTTPPUT=[,<in b) 若参数格式不正确或有其他错误发生： +CME ERROR: 响应 a) 若参数格式正确且 HTTP(S)服务器连接成功： CONNECT 上海移远通信技术股份有限公司 22 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 put_time>,] 最大响应时间 特性说明 TA 切换到透传模式，即可输入 HTTP(S) PUT 头和请求体信息。 当输入数据总大小达到，TA 将返回命令模式并 上报以下结果： OK 模块收到 HTTP(S)服务器响应后，将上报以下 URC： +QHTTPPUT: [,[,]] 若 输 入 时 间 达 到 ， 但 接 收 的 数 据 长 度 小 于 ，TA 将切换回命令模式并上报以下结果： +CME ERROR: b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由网络和决定 该命令立即生效； 参数配置不保存。 参数 整 型 。 若 为 0 ， 表 示 HTTP(S) PUT 请 求 体 长 度 ； 若 为 1，表示 HTTP(S) PUT 请求信息长度，包含 HTTP(S) PUT 请求头和请求体信息。范围：1~1024000；单位：字节。 整型。HTTP(S) PUT 请求体或 HTTP(S) PUT 请求信息的最大输入时间。范围： 1~65535；默认值：60；单位：秒。 整 型 。 上 报 OK 后 ， HTTP(S) PUT 响 应 +QHTTPPUT: [,[,]]的最大输出时间。范围：1~65535； 默认值：60；单位：秒。 错误代码。请参考第 5 章。 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头。请参考第 2.1 章。 整型。HTTP(S)响应体长度。单位：字节。 2.8. AT+QHTTPPUTFILE 通过文件发送 PUT 请求到 HTTP(S)服务器 该命令用于通过文件发送 PUT 请求到 HTTP(S)服务器。根据在 AT+QHTTPCFG='requestheader'[, ]命令中配置的，AT+QHTTPPUTFILE 操作的文件有两种形式。 ⚫ 若为 0，文件系统中的文件将为 HTTP(S) PUT 请求体； ⚫ 若为 1，文件系统中的文件将为 PUT 请求头和请求体信息。 上海移远通信技术股份有限公司 23 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 执行 AT+QHTTPPUTFILE 命令后，模块会上报+QHTTPPUTFILE: [,[,]]表示命令执行结果。仅当为 0 时，才上报。 上 报 OK 后 ， 需 要 等 待 一 段 时 间 （ 参 考 下 表 中 最 大 响 应 时 间 ） 才 会 输 出 +QHTTPPUTFILE: [,[,]]信息。 AT+QHTTPPUTFILE 通过文件发送 PUT 请求到 HTTP(S)服务器 测试命令 AT+QHTTPPUTFILE=? 响应 +QHTTPPUTFILE: ,( 支 持 的 范 围)[,(支持的范围)] 设置命令 AT+QHTTPPUTFILE=[,< rsptime>[,]] OK 响应 a) 若参数格式正确且 HTTP(S)服务器连接成功： OK 模块收到 HTTP(S)服务器响应，将上报如下 URC： +QHTTPPUTFILE: [,[,]] 最大响应时间 特性说明 b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由网络和决定 该命令立即生效； 参数配置不保存。 参数 字符串类型。文件名称。最大长度为 80 字节。 整 型 。 上 报 OK 后 ， HTTP(S) PUT 响 应 +QHTTPPUTFILE: [,[,]]的最大输出时间。范围：1~65535； 默认值：60；单位：秒。 整型。表示发送的文件信息。仅在=0 时该参数才可省略。 0 若设置为 0，表示请求体文件； 若设置为 1，表示请求头和请求体文件。 1 表示请求头文件，此时取值须为 1。 2 表示请求体文件，此时取值须为 1。 错误代码。请参考第 5 章。 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。请参考第 2.1 章。 整型。HTTP(S)响应体长度。单位：字节。 上海移远通信技术股份有限公司 24 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 2.9. AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 发送 HTTP(S) GET/POST/PUT 请求后，可使用 AT+QHTTPREAD 命令通过 UART/USB 端口从 HTT P(S)服务器检索 HTTP(S)响应信息。必须接收+QHTTPGET: [,[,]]、+QHTTPPOST: [,[,]]、+QHTTPPUT: [,[,]]、+QHTTPPOSTFILE: [,[,]]或+QHTTP PUTFILE: [,[,]]信息后才能执行 AT+QHTTPREAD。 AT+QHTTPREAD 通过 UART/USB 读取 HTTP(S)服务器响应信息 测试命令 AT+QHTTPREAD=? 响应 +QHTTPREAD: (支持的范围) 设置命令 AT+QHTTPREAD[=] OK 响应 a) 若参数格式正确且读取成功： CONNECT OK +QHTTPREAD: 若 两 个 数 据 包 接 收 间 隔 时 间 达 到 或 发 生 其 他 错 误，但请求体信息未输出完成： +CME ERROR: 最大响应时间 特性说明 b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由决定 该命令立即生效； 参数配置不保存。 参数 整型。接收两个数据包之间的最大间隔时间。范围：1~65535；默认值：60； 单位：秒。 错误代码。请参考第 5 章。 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。HTTP(s)响应内容长度。单位：字节。 上海移远通信技术股份有限公司 25 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 2.10. AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 发送 HTTP(S) GET/POST/PUT 请求后，用户可以使用 AT+QHTTPREADFILE 通过文件从 HTTP(S) 服务器检索 HTTP(S)响应信息，必须接收+QHTTPGET: [,[,]]、+ QHTTPPOST: [,[,]]、+QHTTPPUT: [,[,]]、+QHTTPPOSTFILE: [,[,]]或+QHTTPPUTFI LE: [,[,]]信息后才能执行 AT+QHTTPREADFILE。 AT+QHTTPREADFILE 通过文件读取 HTTP(S)服务器响应信息 测试命令 AT+QHTTPREADFILE=? 响应 +QHTTPREADFILE: ,(支持的范围) 设置命令 AT+QHTTPREADFILE=[, ] OK 响应 a) 若参数格式正确： OK 若 两 个 数 据 包 接 收 间 隔 时 间 达 到 或 发 生 其 他 错 误，但请求体信息未输出完成： +QHTTPREADFILE: 最大响应时间 特性说明 b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由决定 该命令立即生效； 参数配置不保存。 参数 整型。接收两个数据包之间的最大间隔时间。范围：1~65535；默认值：60； 单位：秒。 字符串类型。文件名称。最大长度为 80 字节。 错误代码。请参考第 5 章。 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。HTTP(s)响应内容长度。单位：字节。 上海移远通信技术股份有限公司 26 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 2.11. AT+QHTTPCFGEX 配置发送的文件和参数 该命令用于配置 AT+QHTTPSEND 要发送的文件和参数。 AT+QHTTPCFGEX 配置发送的文件和参数 测试命令 AT+QHTTPCFGEX=? 响应 +QHTTPCFGEX: 'send_add','name','file_name','conte nt_type','value' +QHTTPCFGEX: 'send_del',(支持的范围) 设置命令 AT+QHTTPCFGEX='send_add'[,[,,,,]] OK 响应 若省略可选参数，查询是否配置： +QHTTPCFGEX: 'send_add',,,,,,,< x>,,,,, OK 若省略可选参数、、和 ，则查询当前配置： +QHTTPCFGEX: 'send_add',,not_exit OK 或者 +QHTTPCFGEX: 'send_add',,,, OK 最大响应时间 特性说明 若指定可选参数，则配置对应的： OK 或者 +CME ERROR: 200 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。表示文件上传序列，一共可上传 12 路。范围：0~11。若已配 置，再次使用该命令进行配置相同的时候，则覆盖之前的配置信息。 整型。当前是否被配置。 0 未添加配置参数 上海移远通信技术股份有限公司 27 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 1 已添加配置参数 字符串类型。需要配置的参数名。 字符串类型。需要发送的文件。例如：UFS:xxx。 字符串型。需要发送内容的数据类型。例如：application/x-www-form-urlencoded， text/plain，application/octet-stream 或者 multipart/form-data。 该参数与 AT+QHTTPCFG='contenttype',中的参数区别在于： AT+QHTTPCFG 中的在组包的时候影响 HTTP 消息头里的内容， 而 AT+QHTTPCFGEX 中的影响消息体里的类型。 需要发送到服务器的数据。 错误代码。请参考第 5 章。 备注 参数和、不能同时配置；需先配置和 后，再设置。 2.12. AT+QHTTPSEND 通过文件向 HTTP(S)发送 POST 请求 该 命 令 用 于 通 过 文 件 向 HTTP(S) 发 送 POST 请 求 。 AT+QHTTPCFG='requestheader'[,]中参数应设置为 0，表示禁用 用户自定义 HTTP(S)请求头，使用标准请求头；AT+QHTTPCFG='contenttype',中参数 应设置为 3，表示 HTTP(S)内容数据类型为 multipart/form-data，表示表单数据由多部分 构成，既有文本数据，又有文件等二进制数据。 执行 AT+QHTTPSEND 命令后，会上报 URC：+QHTTPSEND: [,[,]]表示执行结果。只有当参数值为 0 时，URC 才支持显示参数。 发送 AT+QHTTPSEND 后响应 OK，等待一定时间后会返回+QHTTPSEND: [,[, ]]。 AT+QHTTPSEND 通过文件向 HTTP(S)发送 POST 请求 测试命令 AT+QHTTPSEND=? 响应 +QHTTPSEND: (支持的范围) 设置命令 AT+QHTTPSEND[=] OK 响应 a) 若参数格式正确且 HTTP(S)服务器连接成功： OK 当模块收到来自 HTTP(S)服务器的响应，会上报如下 URC： +QHTTPSEND: [,[,]] 上海移远通信技术股份有限公司 28 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 最大响应时间 特性说明 b) 若参数格式不正确或有其他错误发生： +CME ERROR: 由网络和参数决定 该命令立即生效； 参数配置不保存。 参数 整型。上报 OK 后，HTTP(S) POST 响应+QHTTPSEND: [, [,]]的超时时间。范围：1~65535；默认值：60；单位：秒。若 此参数缺省，则使用默认值。 错误代码。请参考第 5 章。 整型。HTTP(S)服务器响应代码。请参考第 6 章。 整型。禁用或启用自定义 HTTP(S)请求头信息。请参考第 2.1 章。 整型。HTTP(s)响应内容长度。单位：字节。 整型。HTTP(S)体的数据类型。请参考第 2.1 章。 2.13. AT+QHTTPSTOP 取消 HTTP(S)请求 MCU 可通过该命令取消 HTTP(S) GET/POST/PUT 请求，断开与 HTTP(S)的会话连接。 AT+QHTTPSTOP 取消 HTTP(S)请求 测试命令 AT+QHTTPSTOP=? 执行命令 AT+QHTTPSTOP 响应 OK 响应 若参数格式正确且无其他错误发生： OK 最大响应时间 特性说明 若参数格式不正确或有其他错误发生： +CME ERROR: 10 秒 / 参数 错误代码。请参考第 5 章。 上海移远通信技术股份有限公司 29 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 3 举例 3.1. 访问 HTTP 服务器 3.1.1. 发送 HTTP GET 请求并读取响应信息 以下举例说明如何发送 HTTP GET 请求，启用 HTTP 响应头信息输出以及读取 HTTP GET 响应。 //发送 HTTP GET 响应示例 AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='responseheader',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //配置PDP上下文ID为1。 //启用输出 HTTP 响应头信息。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPURL=23,80 CONNECT HTTP://www.sina.com.cn/ OK AT+QHTTPGET=80 OK //设置要访问的 URL，设置超时时间为 80 秒。 //输入长度为 23 个字节的 URL。（此 URL 仅为示例。请根据 实际情况输入正确的 URL。） //发送 HTTP GET 请求，最大响应时间为 80 秒。 +QHTTPGET: 0,200,601710 //若 HTTP 响应头信息中包括 CONTENT-LENGTH，则将上 报信息。 //读取 HTTP GET 响应信息示例 //方法 1：读取 HTTP 响应信息并通过 UART 口将其输出。 上海移远通信技术股份有限公司 30 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 AT+QHTTPREAD=80 //读取 HTTP 响应信息并通过 UART 口将其输出。HTTP 会话 关闭的最长等待时间为 80 秒。 CONNECT HTTP/1.1 200 OK //HTTP 响应头信息和响应体。 Server: nginx Date: Tue, 12 Sep 2017 05:57:29 GMT Content-Type: text/html Content-Length: 601710 Connection: close Last-Modified: Tue, 12 Sep 2017 05:54:48 GMT Vary: Accept-Encoding Expires: Tue, 12 Sep 2017 05:58:28 GMT Cache-Control: max-age=60 X-Powered-By: shci_v1.03 Age: 1 …… //此处省略行。 OK +QHTTPREAD: 0 //成功读取 HTTP 响应头信息和响应体。 //方法 2：读取 HTTP 响应信息并将其储存到 RAM 文件中。 AT+QHTTPREADFILE='RAM:1.txt',80 OK //读取 HTTP 响应头信息和响应体并将其储存到 RAM:1.txt。 HTTP 会话关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //成功储存 HTTP 响应头信息和响应体。 3.1.2. 发送 HTTP POST 请求并读取响应信息 3.1.2.1. 通过 UART/USB 获取 POST 请求体 以下举例说明如何发送 HTTP POST 请求，通过 UART 口检索 POST 请求体以及如何读取 HTTP POST 响应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。 上海移远通信技术股份有限公司 31 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPURL=59,80 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? OK AT+QHTTPPOST=20,80,80 CONNECT Message=HelloQuectel OK //设置要访问的 URL，设置超 时时间为 80 秒。 //输入长度为 59 个字节的 URL。（此 URL 仅为示例， 请根据实际情况输入正确的 URL。） //发送 HTTP POST 请求，通 过 UART 获取 POST 请求体。 POST 请求体的最大输入时 间和响应时间皆为 80 秒。 //输入长度为 20 个字节的 POST 请求体。（此请求体仅 为示例，请根据实际情况输 入正确的 POST 请求体。） +QHTTPPOST: 0,200,177 //若 HTTP 响应头信息包含 CONTENT-LENGTH ， 则 将 上报信 息。 AT+QHTTPREAD=80 //读取 HTTP 响应体并通过 UART 口将其输出。HTTP 会 话关闭的最长等待时间为 80 秒。 CONNECT Message='HelloQuectel' ASCII:72 101 108 108 111 81 117 101 99 116 101 108 //输出 HTTP 响应体。 OK +QHTTPREAD: 0 //成功输出 HTTP 响应体。 上海移远通信技术股份有限公司 32 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 3.1.2.2. 从文件系统获取 POST 请求体 以下举例说明如何发送 HTTP POST 请求，通过文件系统检索 POST 请求体，以及将 HTTP POST 响 应储存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPURL=59,80 //设置要访问的 URL，设置超 时时间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。（此 URL 仅为示例， 请根据实际情况输入正确的 URL。） OK //来自 RAM 文件的 POST 请求信息，读取 HTTP 响应信息并将其储存到 RAM 文件中。 AT+QHTTPPOSTFILE='RAM:2.txt',80 //发送 HTTP POST 请求，从 RAM:2.txt 中获取 POST 请求 体，最大响应时间为 80 秒。 OK +QHTTPPOSTFILE: 0,200,177 AT+QHTTPREADFILE='RAM:3.txt',80 OK //HTTP POST 请求发送成功 后，方可执行 AT+QHTTPREADFILE 命 令。 //读取 HTTP 响应体并将其储 存到 RAM:3.txt。HTTP 会话 关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTP 响应体储存成功。 上海移远通信技术股份有限公司 33 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 3.1.3. 发送 HTTP PUT 请求并读取响应信息 3.1.3.1. 通过 UART/USB 获取 PUT 请求体 以下举例说明如何发送 HTTP PUT 请求，通过 UART 口读取 PUT 请求体以及如何读取 HTTP PUT 响 应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为 中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPURL=59,80 //设置要访问的 URL，设置超时时 间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。 （此 URL 仅为示例，请根据实际 情况输入正确的 URL。） OK AT+QHTTPPUT=20,80,80 //发送 HTTP PUT 请求，通过 UART 获取 PUT 请求体。PUT 请 求体的最大输入时间和响应时间 皆为 80 秒。 CONNECT Message=HelloQuectel //输入长度为 20 个字节的 PUT 请 求体。（此 PUT 请求体仅为示例， 请根据实际情况输入正确的 PUT 请求体。） OK +QHTTPPUT: 0,200,177 AT+QHTTPREAD=80 //若 HTTP 响应头信息包含 CONTENT-LENGTH，则将上报 信息。 //读取 HTTP 响应信息并通过 UART 口将其输出。HTTP 会话关 上海移远通信技术股份有限公司 34 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 闭的最长等待时间为 80 秒。 CONNECT Message='HelloQuectel' ASCII:72 101 108 108 111 81 117 101 99 116 101 108 //输出 HTTP 响应信息。 OK +QHTTPREAD: 0 //成功输出 HTTP 响应信息。 3.1.3.2. 从文件系统获取 PUT 请求体 以下举例说明如何发送 HTTP PUT 请求，通过文件系统读取 PUT 请求体，以及将 HTTP PUT 响应储 存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为 中国联通的'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPURL=59,80 //设置要访问的 URL，设置超时时 间为 80 秒。 CONNECT http://api.efxnow.com/DEMOWebServices2.8/Service.asmx/Echo? //输入长度为 59 个字节的 URL。 （此 URL 仅为示例，请根据实际 情况输入正确的 URL。） OK //来自 UFS 文件的 PUT 请求信息，读取 HTTP 响应信息并将其储存到 UFS 文件中。 AT+QHTTPPUTFILE='UFS:2.txt',80 //发送 HTTP PUT 请求，从 UFS:2.txt 中获取 PUT 请求体，最 大响应时间为 80 秒。 OK +QHTTPPUTFILE: 0,200,177 AT+QHTTPREADFILE='UFS:3.txt',80 //HTTP PUT 请求发送成功后，方 可执行 AT+QHTTPREADFILE。 //读取 HTTP 响应信息并将其储存 上海移远通信技术股份有限公司 35 / 54 OK +QHTTPREADFILE: 0 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 到 UFS:3.txt。HTTP 会话关闭的最长 等待时间为 80 秒。 //HTTP 响应信息储存成功。 3.1.4. 通过文件向 HTTP 发送 POST 请求 AT+QHTTPCFGEX='send_add' +QHTTPCFGEX: 'send_add',0,0,0,0,0,0,0,0,0,0,0,0 //查询是否配置文件上传序列。 OK AT+QHTTPCFGEX='send_add',1,'app_key','SD:1.TXT' //增加发送内容 1：SD:1.txt 文件。 OK AT+QHTTPCFGEX='send_add',2,'phone_number','','','xx-xxxx-xxxx-xxxx' //增加发送内容 2：xx-xxxx-xxxx-xxxx。 OK AT+QHTTPCFGEX='send_add',3,'longitude','','','DD' //增加发送内容 3：DD。 OK AT+QHTTPCFGEX='send_add',0,'sn','','','AA' //增加发送内容 0：AA。 OK AT+QHTTPCFG='CONTENTTYPE',3 //配置 HTTP 体的数据类型为 multipart/form-data。 OK AT+QHTTPURL=41,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT //返回 CONNECT 后，输入支持通过文件 发送 POST 请求的 HTTP 服务器 URL。 OK AT+QHTTPCFGEX='send_add',0 +QHTTPCFGEX: 'send_add','sn','','','AA' //查询增加的内容 0。 OK AT+QHTTPCFGEX='send_add' +QHTTPCFGEX: 'send_add',1,1,1,1,0,0,0,0,0,0,0,0 //查询是否配置文件上传序列。 OK AT+QHTTPCFGEX='send_add',0 +QHTTPCFGEX: 'send_add','sn','','','AA' //查询增加的内容 0。 OK AT+QHTTPCFGEX='send_del',0 OK //删除之前增加的内容 0。 上海移远通信技术股份有限公司 36 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 AT+QHTTPCFGEX='send_add' +QHTTPCFGEX: 'send_add',0,1,1,1,0,0,0,0,0,0,0,0 OK AT+QHTTPSEND=60 OK +QHTTPSEND: 0,200 //查询是否配置文件上传序列。 //发送 POST 请求。 3.2. 访问 HTTPS 服务器 3.2.1. 发送 HTTPS GET 请求并读取响应信息 以下举例说明如何发送 HTTPS GET 请求，启用 HTTPS 响应头信息输出以及如何读取 HTTPS GET 响应信息。 //发送HTTPS GET请求示例 AT+QHTTPCFG='contextid',1 OK AT+QHTTPCFG='responseheader',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //配置PDP上下文ID为1。 //启用输出 HTTPS 响应头信息。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 OK AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0x0005 OK AT+QSSLCFG='seclevel',1,0 OK AT+QHTTPURL=22,80 CONNECT https://www.alipay.com //设置 SSL 上下文 ID。 //设置 SSL 版本为 1，表示 TLSV1.0。 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 //设置 SSL 验证级别为 0，表示不需要 CA 证书。 //设置要访问的 URL。 //输入长度为 19 个字节的 URL。（此 URL 仅为示例，请根据 实际情况输入正确的 URL。） 上海移远通信技术股份有限公司 37 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 OK AT+QHTTPGET=80 OK //发送 HTTPS GET 请求，最大响应时间为 80 秒。 +QHTTPGET: 0,200,21472 //读取 HTTPS 响应信息示例 //若 HTTPS 响应头信息包含 CONTENT-LENGTH，则将上报 信息。 //方法 1：读取 HTTPS 响应信息并将其通过 UART 输出。 AT+QHTTPREAD=80 //读取 HTTPS 响应信息并将其通过 UART 输出。HTTP 会 CONNECT 话关闭的最长等待时间为 80 秒。 //HTTPS 响应头信息和响应体。 HTTP/1.1 200 OK Server: Tengine/2.1.0 Date: Tue, 12 Sep 2017 05:54:34 GMT Content-Type: text/html; charset=utf-8 Content-Length: 21451 Connection: keep-alive …… //此处省略行。 OK +QHTTPREAD: 0 //HTTPS 响应头信息和响应体读取成功。 //方法 2：读取 HTTPS 响应信息并将其储存到 RAM 文件中。 AT+QHTTPREADFILE='RAM:4.txt',80 OK //读取 HTTPS 响应头信息和响应体并将其储存在 RAM:4.txt。 HTTP 会话关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTPS 响应头信息和响应体储存成功。 3.2.2. 发送 HTTPS POST 请求并读取响应信息 3.2.2.1. 从 UART/USB 获取 POST 请求体 以下举例说明如何发送 HTTPS POST 请求，通过 UART 检索 POST 请求体以及如何读取 HTTPS POST 响应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 上海移远通信技术股份有限公司 38 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置 PDP 上下文为 1，APN 为中国联通 的'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID。 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 命令上传 CA 证书、客户端证 书和客户端私钥。 OK AT+QSSLCFG='cacert',1,'RAM:cacert.pem' //配置指定 SSL 上下文的受信任 CA 证书路 径。 OK AT+QSSLCFG='clientcert',1,'RAM:clientcert.pem' //配置指定 SSL 上下文的客户端证书路径。 OK AT+QSSLCFG='clientkey',1,'RAM:clientkey.pem' //配置指定 SSL 上下文的客户端密钥。 OK AT+QHTTPURL=45,80 //设置要访问的 URL。 CONNECT HTTPs://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示例，请根据实际情况输入正确的 URL。） OK AT+QHTTPPOST=48,80,80 //发送 HTTPS POST 请求，通过 UART 获 取 POST 请求体。POST 请求体的最大输 入时间和响应时间为 80 秒。 CONNECT Message=1111&Appleqty=2222&Orangeqty=3333&find=1 //输入长度为 48 个字节的 POST 请求体。 （此请求体仅为示例，请根据实际情况输 入正确的 POST 请求体。） OK +QHTTPPOST: 0,200,285 //若 HTTPS 响应头信息包含 上海移远通信技术股份有限公司 39 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 AT+QHTTPREAD=80 CONNECT Quectel's Auto Parts - Order Results Quectel's Auto Parts Order Results CONTENT-LENGTH，则将上报 信息。 //读取 HTTPS 响应体并将其通过 UART 输 出。HTTP 会话关闭的最长等待时间为 80 秒。 //HTTPS 响应体读取成功。 Order processed at 02:49, 27th DecemberYour order is as follows: 1111 message2222 apple3333 orange OK +QHTTPREAD: 0 //HTTPS 响应体输出成功。 3.2.2.2. 从文件系统获取请求体 以下举例说明如何发送 HTTPS POST 请求，从文件系统检索 POST 请求体以及如何将 HTTPS POST 响应信息储存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','' ,'' ,1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的 'UNINET'。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 上下文 ID。 //设置 SSL 版本为 1，表示 TLSV1.0。 上海移远通信技术股份有限公司 40 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 命令上传 CA 证书、客户端证书和客户端私钥。 OK AT+QSSLCFG='cacert',1,'RAM:cacert.pem' //配置指定 SSL 上下文的受信任 CA 证书路径。 OK AT+QSSLCFG='clientcert',1,'RAM:clientcert.pem'//配置指定 SSL 上下文的客户端证书路径。 OK AT+QSSLCFG='clientkey',1,'RAM:clientkey.pem'//配置指定 SSL 上下文的客户端密钥。 OK AT+QHTTPURL=45,80 //设置要访问的 URL。 CONNECT https://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示例， 请根据实际情况输入正确的 URL。） OK //POST 请求信息来自 RAM 文件，读取 HTTPS 响应信息并将其储存在 RAM 文件中。 AT+QHTTPPOSTFILE='RAM:5.txt',80 //发送 HTTPS POST 请求，从 RAM:5.txt 获取 POST 请求体，最大响应时间为 80 秒。 OK +QHTTPPOSTFILE: 0,200,177 AT+QHTTPREADFILE='RAM:6.txt',80 OK //HTTPS POST 请求发送成功后，方可执行 AT+QHTTPREAD 命令。 //读取 HTTPS 响应体并将其储存在 RAM:6.txt'。 HTTP 会话关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTPS 响应体储存成功。 3.2.3. 发送 HTTPS PUT 请求并读取响应信息 3.2.3.1. 从 UART/USB 获取 PUT 请求体 以下举例说明如何发送 HTTPS PUT 请求，通过 UART 读取 PUT 请求体以及如何读取 HTTPS PUT 响 应信息。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通 的'UNINET'。需设置 AT+CFUN=1,1 使配 上海移远通信技术股份有限公司 41 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' 置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 //设置 SSL 上下文 ID 为 1。 OK AT+QSSLCFG='sslversion',1,1 //设置 SSL 版本为 1，表示 TLSV1.0。 OK AT+QSSLCFG='ciphersuite',1,0x0005 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 OK AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证书，客户端证书和 客户端私钥。 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' //配置指定 SSL 上下文的受信任 CA 证书路 径。 OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' //配置指定 SSL 上下文的客户端证书路径。 OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' //配置指定 SSL 上下文的客户端密钥。 OK AT+QHTTPURL=45,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT HTTPs://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示例，请根据实际情况输入正确 的 URL。） OK AT+QHTTPPUT=48,80,80 //发送 HTTPS PUT 请求，通过 UART 获取 PUT 请求体。PUT 请求体的最大输入时间 和响应时间为 80 秒。 CONNECT Message=1111&Appleqty=2222&Orangeqty=3333&find=1 //输入长度为 48 个字节的 PUT 请求体。（此 PUT 请求体仅为示例，请根据实际情况输入 正确的 PUT 请求体。） OK +QHTTPPUT: 0,200,285 //若 HTTPS 响应头信息包含 CONTENT-LENGTH，则将上报 上海移远通信技术股份有限公司 42 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 AT+QHTTPREAD=80 CONNECT Quectel's Auto Parts - Order Results Quectel's Auto Parts Order Results 信息。 //读取 HTTPS 响应信息并将其通过 UART 输出。HTTPS 会话关闭的最长等待时间为 80 秒。 //HTTPS 响应信息读取成功。 Order processed at 02:49, 27th DecemberYour order is as follows: 1111 message2222 apple3333 orange OK +QHTTPREAD: 0 //HTTPS 响应信息输出成功。 3.2.3.2. 从文件系统获取 PUT 请求体 以下举例说明如何发送 HTTPS PUT 请求，从文件系统读取 PUT 请求体以及如何将 HTTPS PUT 响应 信息储存到文件系统。 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通的 'UNINET'。需设置 AT+CFUN=1,1 使配置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QHTTPCFG='sslctxid',1 OK AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0x0005 OK //设置 SSL 上下文 ID 为 1。 //设置 SSL 版本为 1，表示 TLSV1.0。 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 上海移远通信技术股份有限公司 43 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 AT+QSSLCFG='seclevel',1,2 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证书，客户端证书和客户端私钥。 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' //配置指定 SSL 上下文的受信任 CA 证书路径。 OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' //配置指定 SSL 上下文的客户端证书路径。 OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' //配置指定 SSL 上下文的客户端密钥。 OK AT+QHTTPURL=45,80 //设置要访问的 URL，设置超时时间为 80 秒。 CONNECT https://220.180.239.212:8011/processorder.php //输入长度为 45 个字节的 URL。（此 URL 仅为示例， 请根据实际情况输入正确的 URL。） OK //PUT 请求信息来自 UFS 文件，读取 HTTPS 响应信息并将其储存在 UFS 文件中。 AT+QHTTPPUTFILE='UFS:5.txt',80 //发送 HTTPS PUT 请求，从 UFS:5.txt 获取 PUT 请 求体，最大响应时间为 80 秒。 OK +QHTTPPUTFILE: 0,200,177 AT+QHTTPREADFILE='UFS:6.txt',80 OK //HTTPS PUT 请求发送成功后，方可执行 AT+QHTTPREADFILE。 //读取 HTTPS 响应信息并将其储存在 UFS:6.txt'。 HTTP 会话关闭的最长等待时间为 80 秒。 +QHTTPREADFILE: 0 //HTTPS 响应信息储存成功。 3.2.4. 通过文件向 HTTPS 发送 POST 请求 AT+QHTTPCFG='contextid',1 OK AT+QIACT? OK AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'172.22.86.226' OK AT+QHTTPCFG='sslctxid',1 //配置PDP上下文ID为1。 //查询 PDP 上下文状态。 //配置 PDP 上下文为 1，APN 为中国联通 的'UNINET'。需设置 AT+CFUN=1,1 使配 置生效。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 //设置 SSL 上下文 ID 为 1。 上海移远通信技术股份有限公司 44 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 OK AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0x0005 OK AT+QSSLCFG='seclevel',1,2 OK AT+QSSLCFG='cacert',1,'UFS:cacert.pem' OK AT+QSSLCFG='clientcert',1,'UFS:clientcert.pem' OK AT+QSSLCFG='clientkey',1,'UFS:clientkey.pem' OK AT+QHTTPCFGEX='send_add' +QHTTPCFGEX: 'send_add',0,0,0,0,0,0,0,0,0,0,0,0 //设置 SSL 版本为 1，表示 TLSV1.0。 //设置 SSL 加密套件为 0x0005，表示 RC4-SHA。 //设置 SSL 验证级别为 2，表示需通过 AT+QFUPL 上传 CA 证书，客户端证书和 客户端私钥。 //配置指定 SSL 上下文的受信任 CA 证书路 径。 //配置指定 SSL 上下文的客户端证书路径。 //配置指定 SSL 上下文的客户端密钥。 //查询是否配置文件上传序列。 OK AT+QHTTPCFGEX='send_add',1,'app_key','SD:1.TXT' //增加发送内容 1：SD:1.txt 文件。 OK AT+QHTTPCFGEX='send_add',2,'phone_number','','','xx-xxxx-xxxx-xxxx' //增加发送内容 2：xx-xxxx-xxxx-xxxx OK AT+QHTTPCFGEX='send_add',3,'longitude','','','DD' //增加发送内容 3：DD。 OK AT+QHTTPCFGEX='send_add',0,'sn','','','AA' //增加发送内容 0：AA。 OK AT+QHTTPCFG='CONTENTTYPE',3 //配置 HTTPS 体的数据类型为 multipart/form-data。 OK AT+QHTTPURL=41,80 CONNECT //返回 CONNECT 后，输入支持通过文件 发送 POST 请求的 HTTPS 服务器 URL。 OK AT+QHTTPCFGEX='send_add',0 +QHTTPCFGEX: 'send_add','sn','','','AA' //查询增加的内容 0。 OK AT+QHTTPCFGEX='send_add' +QHTTPCFGEX: 'send_add',1,1,1,1,0,0,0,0,0,0,0,0 //查询是否配置文件上传序列。 上海移远通信技术股份有限公司 45 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 OK AT+QHTTPCFGEX='send_add',0 +QHTTPCFGEX: 'send_add','sn','','','AA' OK AT+QHTTPCFGEX='send_del',0 OK AT+QHTTPCFGEX='send_add' +QHTTPCFGEX: 'send_add',0,1,1,1,0,0,0,0,0,0,0,0 OK AT+QHTTPSEND=60 OK +QHTTPSEND: 0,200 //查询增加的内容 0。 //删除之前增加的内容 0。 //查询是否配置文件上传序列。 //发送 POST 请求。 上海移远通信技术股份有限公司 46 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 4 常见问题处理 4.1. HTTP(S) AT 命令执行失败 执行 HTTP(S) AT 命令后，若返回 ERROR，请检查是否插入了(U)SIM 卡，并注意执行 AT+CPIN?后 是否返回了+CPIN: READY。 4.2. PDP 激活失败 若使用 AT+QIACT 激活 PDP 失败，请检查以下配置： 1. 查询是否通过 AT+CGATT?附着了 PS 域。若未附着 PS 域，请先执行 AT+CGATT=1 附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保已注册了 PS 域。 3. 通过 AT+QICSGP 查询 PDP 上下文参数，并确保已设置了指定 PDP 上下文的 APN。 4. 确保指定 PDP 上下文 ID 既不被 PPP 使用，也不通过 AT+CGACT 激活。 5. 根据 3GPP 规范，模块仅支持同时激活三个 PDP 上下文，因此激活 PDP 上下文的数量必须小于 3。 若上述配置无误，使用 AT+QIACT 激活 PDP 上下文仍失败，请重启模块。重启模块后，请至少检查 三次上述提及的配置，每次间隔 10 分钟，以避免频繁重启模块。 上海移远通信技术股份有限公司 47 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 4.3. DNS 解析失败 执 行 AT+QHTTPGET 、 AT+QHTTPPOST 、 AT+QHTTPPOSTFIL 、 AT+QHTTPPUT 、 AT+QHTTPPUTFILE 和 AT+QHTTPSEND，若返回+CME ERROR: 714（714：HTTP(S) DNS 错误）， 请检查以下配置： 1. 确认 HTTP(S)服务器域名有效。 2. 通过 AT+QIACT?查询 PDP 上下文状态，确保成功激活了指定的 PDP 上下文。 3. 通过 AT+QIDNSCFG 命令查询 DNS 服务器地址，确保 DNS 服务器的地址不是'0.0.0.0'。 若 DNS 服务器的地址为'0.0.0.0'，有两种解决方法： 1. 通过 AT+QIDNSCFG 重新分配一个有效 DNS 服务器地址。 2. 通过 AT+QIDEACT 去激活 PDP 上下文，通过 AT+QIACT 重新激活 PDP 上下文。 4.4. 数据模式进入失败 执 行 AT+QHTTPURL 、 AT+QHTTPGET 、 AT+QHTTPPOST 、 AT+QHTTPPOSTFILE 、 AT+QHTTPREAD、AT+QHTTPPUT 和 AT+QHTTPPUTFILE 后，若返回+CME ERROR: 704（704： HTTP(S) UART 繁忙），请检查数据模式下是否存在其他端口。由于模块仅支持一个端口处于数据模式， 若存在其他端口，请退出其他端口数据模式后重新执行这些命令。 4.5. GET/POST/PUT 请求发送失败 若 执 行 AT+QHTTPGET 、 AT+QHTTPGETEX 、 AT+QHTTPPOST 、 AT+QHTTPPOSTFILE 、 AT+QHTTPPUT 和 AT+QHTTPPUTFILE 失败，请检查以下配置： 1. 确保通过 AT+QHTTPURL 命令输入的 URL 有效且可以访问。 2. 确保指定服务器支持 GET/POST/PUT 相关命令。 3. 确保 PDP 上下文已激活。 若 上 述 配 置 无 误 ， 通 过 AT+QHTTPGET 、 AT+QHTTPGETEX 、 AT+QHTTPPOST 、 AT+QHTTPPOSTFILE、AT+QHTTPPUT 和 AT+QHTTPPUTFILE 发送 GET/POST 请求仍失败，请通过 AT+QIDEACT 去激活 PDP 上下文，并通过 AT+QIACT 重新激活 PDP 上下文。若激活 PDP 上下文失败， 请参阅第 4.2 章解决此问题。 上海移远通信技术股份有限公司 48 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 4.6. 响应信息读取失败 通过 AT+QHTTPREAD 和 AT+QHTTPREADFILE 命令读取响应信息之前，首先要执行 AT+QHTTPGET、AT+QHTTPPOST、AT+QHTTPPOSTFILE、AT+QHTTPPUT、AT+QHTTPPUTFILE 和 AT+QHTTPSEND 命令，之后将上报以下 URC： +QHTTPGET: [,[,]] +QHTTPPOST: [,[,]] +QHTTPPOSTFILE: [,[,]] +QHTTPPUT: [,[,]] +QHTTPPUTFILE: [,[,]] +QHTTPSEND: ],[,]] 执行 AT+QHTTPREAD 和 AT+QHTTPREADFILE 命令时，若发生错误，如上报+CME ERROR: 717 （717：HTTP(S) Socket 读取错误），请通过 AT+QHTTPGET、AT+QHTTPPOST、AT+QHTTPPOSTFILE、 AT+QHTTPPUT、AT+QHTTPPUTFILE 和 AT+QHTTPSEND 命令向 HTTP(S)服务器重新发送 HTTP(S) GET/POST/PUT 请求，若请求仍发送失败，请参考第 4.5 章解决此问题。 上海移远通信技术股份有限公司 49 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 5 错误代码 表示与移动设备或网络有关的错误代码。相关详细信息请参考下表。 表 3：错误代码列表 错误代码 0 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 描述 Operation successful HTTP(S) unknown error HTTP(S) timeout HTTP(S) busy HTTP(S) UART busy HTTP(S) no GET/POST requests HTTP(S) network busy HTTP(S) network open failed HTTP(S) network no configuration HTTP(S) network deactivated HTTP(S) network error HTTP(S) URL error HTTP(S) empty URL HTTP(S) IP address error HTTP(S) DNS error HTTP(S) socket create error HTTP(S) socket connect error HTTP(S) socket read error 上海移远通信技术股份有限公司 50 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 718 HTTP(S) socket write error 719 HTTP(S) socket closed 720 HTTP(S) data encode error 721 HTTP(S) data decode error 722 HTTP(S) read timeout 723 HTTP(S) response failed 724 Incoming call busy 725 Voice call busy 726 Input timeout 727 Wait data timeout 728 Wait HTTP(S) response timeout 729 Memory allocation failed 730 Invalid parameter 上海移远通信技术股份有限公司 51 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 6 HTTP(S)响应错误代码 表示 HTTP(S)服务器响应代码。相关详细信息请参考下表。 表 4：HTTP(S)响应代码列表 响应代码 200 403 404 409 411 500 描述 OK Forbidden Not found Conflict Length required Internal server error 上海移远通信技术股份有限公司 52 / 54 EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 7 附录 参考文档及术语缩写 表 5：参考文档 文档名称 [1] Quectel_LTE_Standard_TCP(IP)_应用指导 [2] Quectel_EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual [3] Quectel_EC2x&EG9x&EG2x-G&EM05 系列_SSL_应用指导 [4] Quectel_LTE_Standard_FILE_应用指导 表 6：术语缩写 缩写 APN CA DNS DTR HTTP(S) ID IP LTE MCU PPP PS 英文全称 Access Point Name Certification Authority Domain Name Server Data Terminal Ready Hyper Text Transport Protocol (Secure) Identifier Internet Protocol Long-Term Evolution Microprogrammed Control Unit Point-to-Point Protocol Packet Switch 中文全称 接入点名称 数字证书认证系统 域名服务器 数据终端就绪 超文本传输协议（安全） 标识符 网际互连协议 长期演进 微程序控制器 点对点协议 分组交换 上海移远通信技术股份有限公司 53 / 54 RAM SSL TA UART URL (U)SIM EC2x&EG9x&EG2x-G&EM05 系列 HTTP(S)应用指导 Random Access Memory 随机存储器 Security Socket Layer 安全 Socket 层 Terminal Adapter Universal Asynchronous Receiver/Transmitter Uniform Resource Locator 终端适配器 通用异步收发传输器 统一资源定位符 (Universal) Subscriber Identity Module （通用）用户身份识别模块 上海移远通信技术股份有限公司 54 / 54

LTE Standard TCP/IP 应用指导 LTE Standard 模块系列 版本：LTE_Standard_TCP/IP_应用指导_V1.0 日期：2019-10-28 状态：受控文件 www.quectel.com LTE Standard TCP/IP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 45 LTE Standard TCP/IP 应用指导 文档历史 修订记录 版本 1.0 日期 2019-10-28 作者 李柱 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 45 LTE Standard TCP/IP 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. 使用 TCP/IP 命令的流程 ............................................................................................................. 6 1.2. 数据访问模式说明 ....................................................................................................................... 8 2 TCP/IP AT 命令详解 ............................................................................................................................ 10 2.1. AT 命令说明 .............................................................................................................................. 10 2.1.1. AT+QICSGP 配置 TCP/IP 场景参数........................................................................... 10 2.1.2. AT+QIACT 激活 PDP 场景 .......................................................................................... 11 2.1.3. AT+QIDEACT 去激活 PDP 场景 ................................................................................... 12 2.1.4. AT+QIOPEN 打开 Socket 服务 ................................................................................... 13 2.1.5. AT+QICLOSE 关闭 Socket 服务 ................................................................................. 15 2.1.6. AT+QISTATE 查询 Socket 服务状态........................................................................... 15 2.1.7. AT+QISEND 发送数据................................................................................................. 17 2.1.8. AT+QIRD 读取收到的 TCP/IP 数据 ............................................................................. 19 2.1.9. AT+QISENDEX 发送 16 进制字符串数据.................................................................... 21 2.1.10. AT+QISWTMD 切换数据访问模式 .............................................................................. 21 2.1.11. AT+QPING 进行远程服务器 Ping 操作 ....................................................................... 22 2.1.12. AT+QNTP 使用 NTP 服务器同步本地时间.................................................................. 23 2.1.13. AT+QIDNSCFG 配置 DNS 服务器地址....................................................................... 24 2.1.14. AT+QIDNSGIP 用域名获取 IP 地址............................................................................. 25 2.1.15. AT+QICFG 配置可选参数............................................................................................ 25 2.1.16. AT+QISDE 控制是否回显 AT+QISEND 的数据 .......................................................... 29 2.1.17. AT+QIGETERROR 查询上一个错误代码.................................................................... 30 2.2. URC 说明 .................................................................................................................................. 30 2.2.1. 连接断开 URC ................................................................................................................ 31 2.2.2. 数据接收 URC ................................................................................................................ 31 2.2.3. 客户端连接已满 URC ..................................................................................................... 32 2.2.4. 客户端连接 URC............................................................................................................. 32 2.2.5. PDP 去激活 URC ........................................................................................................... 33 3 示例 ...................................................................................................................................................... 34 3.1. 场景配置和激活 ......................................................................................................................... 34 3.1.1. 场景配置 ......................................................................................................................... 34 3.1.2. 场景激活 ......................................................................................................................... 34 3.1.3. 场景去激活 ..................................................................................................................... 34 3.2. TCP 客户端在非透传 Buffer 模式下工作 ................................................................................... 34 3.2.1. 创建 TCP 客户端连接并进入非透传 Buffer 模式 ............................................................ 34 3.2.2. Buffer 模式下发送数据 ................................................................................................... 35 3.2.3. Buffer 模式下从远处服务器接收数据.............................................................................. 35 上海移远通信技术股份有限公司 3 / 45 LTE Standard TCP/IP 应用指导 3.2.4. 断开连接 ......................................................................................................................... 36 3.3. TCP 客户端在透传模式下工作 .................................................................................................. 36 3.3.1. 创建 TCP 客户端连接并进入透传模式 ........................................................................... 36 3.3.2. 透传模式下发送数据....................................................................................................... 36 3.3.3. 透传模式接收远程器端数据 ............................................................................................ 36 3.3.4. 断开 TCP 客户端连接 ..................................................................................................... 37 3.4. TCP 客户端在非透传 Push 模式下工作 .................................................................................... 37 3.4.1. 创建 TCP 客户端连接并进入非透传 Push 模式.............................................................. 37 3.4.2. 非透传 Push 模式下发送数据 ......................................................................................... 37 3.4.3. 非透传 Push 模式下接收远程服务器端数据 ................................................................... 38 3.4.4. 断开 TCP 用户端连接 ..................................................................................................... 38 3.5. TCP 服务器在非透传 Buffer 模式下工作 ................................................................................... 38 3.5.1. 启动 TCP 服务器 ............................................................................................................ 38 3.5.2. 接受客户端的连接请求 ................................................................................................... 38 3.5.3. 接收的客户端数据 .......................................................................................................... 38 3.5.4. 断开 TCP 服务器连接 ..................................................................................................... 39 3.6. UDP 服务示例 ........................................................................................................................... 39 3.6.1. 打开 UDP 服务 ............................................................................................................... 39 3.6.2. 向服务器发送 UDP 数据................................................................................................. 39 3.6.3. 接收远程端数据 .............................................................................................................. 40 3.6.4. 关闭 UDP 服务 ............................................................................................................... 40 3.7. PING.......................................................................................................................................... 40 3.8. 同步本地时间............................................................................................................................. 41 3.9. 获取上一个错误代码示例 .......................................................................................................... 41 4 错误代码 ............................................................................................................................................... 42 5 附录 A 术语缩写 .................................................................................................................................. 44 上海移远通信技术股份有限公司 4 / 45 LTE Standard TCP/IP 应用指导 表格索引 表 1：错误代码列表 ........................................................................................................................................... 42 表 2：术语缩写 .................................................................................................................................................. 44 上海移远通信技术股份有限公司 5 / 45 LTE Standard TCP/IP 应用指导 1 引言 移远通信 LTE Standard 模块内置 TCP/IP 协议栈，Host 可以直接通过 AT 命令访问网络，在很大程度 上可降低对 PPP 和 TCP/IP 协议栈的依赖性，从而降低成本。LTE Standard 模块可提供 TCP 客户端、UDP 客户端、TCP 服务器、UDP 服务器等 Socket 服务。 该文档适用于以下移远通信模块：  EC2x：EC25、EC21、EC20 R2.0 和 EC20 R2.1  EG2x-G：EG25-G、EG21-G  EG9x：EG91、EG95  EM05  EP200F 1.1. 使用 TCP/IP 命令的流程 通过 TCP/IP AT 命令，Host 可以配置 PDP 场景、激活/去激活场景、建立/关闭 Socket 服务，并通过 Socket 服务发送/接收数据。下图说明了 TCP/IP AT 命令的流程： 上海移远通信技术股份有限公司 6 / 45 LTE Standard TCP/IP 应用指导 建议开关机流程： 1.关机：发送'AT+QPOWD'，等待12s以 上，直接断电。 2. 开机：先使Power Key按键处于低电平 状态，等待2s后，再拉高Power Key 查询(U)SIM卡状态： 执行AT+CPIN，如果20s后命令AT+CPIN 无法识别(U)SIM卡状态，建议重启模块 CS业务： 1. 当 'AT+CREG?' 结果中的等于 1 或者5，表示模块已经注册上CS业务 2. 如果在90s内没有注册上CS业务，建议 重启模块 PS 业务： 1. 当 'AT+CGREG?/AT+CEREG?' 结果 中的等于 1 或者5，表示模块已在 UMTS/LTE网络注册上PS业务 2. 等待60s后，不管是否注册上PS业务， 都进入下一个流程 配置PDP Context激活参数： 1. 通过 'AT+QICSGP' 命令配置APN， User Name，Password 和Auth Type 2. 通过 'AT+CGQMIN/AT+CGEQMIN/ AT+CGQREQ/AT+CGEQREQ' 配置 QoS 参数 给模块上电并开机 发送AT命令并等待响应结果 'OK' 通过'AT+CPIN?'命 令查询(U)SIM卡状态 如果在20s内无法识别 (U)SIM状态，建议重启模块 识别(U)SIM卡 通过'AT+CREG?'命 令查询CS业务的状态 如果在90s内，没有注册 上CS业务，建议重启模块 60s内注册上CS业务 60s内通过 'AT+CGREG?/AT+CEREG? '命令查询PS业务的状态 通过如下AT命令来配置PDP场景和Qos 参数:'AT+QICSGP/AT+CGQREQ/ AT+CGEQREQ/AT+CGQMIN/ AT+CGEQMIN' 激活PDP Context： 1. 通过 'AT+QIACT=' 激活PDP Context 2. 通过 'AT+QIACT?' 查询PDP Context IP地址 注意事项： a) 以上命令必须按顺序执行 b) 如果等待150s后，'AT+QIACT' 没有响应，建议重启模块. c) 如果连续3次反激活PDP Context 失败，建议重启模块 3. 反激活PDP Context：如果等待 40s后'AT+QIDEACT'没有响应，建 议重启模块 如果等待40s, 没有响应，建 议重启模块 PDP Context 反 激活成功 通过 'AT+QIACT=' 和'AT+QIACT'命令激活指 定的PDP Context 1. 如果等待150s后，没有收到 结果，建议重启模块. 2. 如果连续3次反激活PDP context失败，建议重启模块 PDP Context激 活失败 PDP Context激活成功 通过'AT+QIDE ACT='命令反 激活指定的PDP Context 通过AT+QIOPEN命令 打开连接 1. 连续5次打开连接失败 2. 150s内无响应 +QIOPEN:, 打开连接： 1. 如果等待150s，没有收到'AT+QIOPEN'的响应，请关闭 连接。 2.如果连续5次打开连接失败，先反激活PDP Context，然后 重新激活PDP Context并再次打开连接。 通过AT+QISEND=命令 发送数据 在收到ACK 90s 后 TCP连接的维护和检测： 1. 通过 'AT+QISEND=[,]' 发送数据。 建议定期向远程端发送小数据包以维护和检测TCP连接。 2. 通过 'AT+QISEND=,0' 查询ACK的发送。 如果在2分钟后（每5s查询一次，一共查询24次），对方没有收到数据， 说明TCP连接可能出现异常，请执行'AT+QICLOSE'命令关闭这个TCP连 接，然后通过'AT+QIOPEN'重新建立TCP连接。 通过'AT+QISEND= ,0'命令查询 发送的数据是否成功被接 收 90s内未收到ACK 通过'AT+QICLOSE OK =' 关闭连接 如果等待10s，无响应，建议重启 模块 注意事项： 1.请注意必须接收到上一个AT命令的执行结果后（例如：'OK'/'CME ERROR'/'CMS ERROR'），才能执行下一个AT命令。一般情况下，如果在 60s内没有收到AT命令执行结果，建议重启模块。 2.若150s内未收到'AT+QIACT'响应，10s内未收到'AT+QICLOSE'响应，40s内未收到'AT+QIDEACT'响应，建议重启模块。 3.不建议频繁重启模块。如果因为执行AT命令连续3次重启模块失败，此后第一次可立即重启，然后等待10分钟，再进行第二次重启，如果仍重启失 败，建议等待30分钟，再进行第三次重启，以此类推，逐渐增大重启的时间间隔。 图 1：TCP/IP AT 命令使用流程图 上海移远通信技术股份有限公司 7 / 45 LTE Standard TCP/IP 应用指导 1.2. 数据访问模式说明 LTE Standard 模块支持以下 3 种数据访问模式：  非透传 Buffer 模式  非透传 Push 模式  透传模式 当使用 AT+QIOPEN 打开 Socket 服务时，可以通过参数来指定 Socket 的数据访问 模式；当 Socket 服务成功打开后，可以通过 AT+QISWTMD 切换数据访问模式。 1. 非透传 Buffer 模式下，可以通过 AT+QISEND 命令发送数据。从网络接收数据时，模块会缓存所接收 的数据，并直接上报 URC：+QIURC: 'recv',，之后用户可以通过 AT+QIRD 命令来读取 缓存数据。 2. 非透传 Push 模式下，可以通过 AT+QISEND 发送数据。从网络接收数据时，数据会以如下格式直接输 出到 COM 口上：+QIURC: 'recv',, 。 3. 透传模式下，相对应的串口（比如 UART 口、USB Modem 口等）会进入独占模式，通过 COM 口接收 的数据会直接发送到网络端，从网络接收到的数据会从 COM 口直接输出。+++可以用来退出透传模式： 当输入+++返回 OK 后，访问模式就会切换到非透传 Buffer 模式，如需切换回透传模式，可使用 AT+QISWTMD 命令。  退出透传模式 用户可以通过+++或者 DTR（需先设置 AT&D1）两种方式退出透传模式，为了防止+++被当成数据发 送，实际操作时必须遵循以下步骤： 1） +++输入前 1 秒或更长时间内不能输入其它任何数据； 2） 必须在 1 秒内输入+++，并且不能输入其它任何数据； 3） +++输入后 1 秒内不能输入其它任何数据； 4） 通过+++或者 DTR（设置 AT&D1）方式使模块退出透传模式，直到模块返回 OK，成功。  切换到透传模式 1） 通过执行 AT+QISWTMD 命令：执行命令时，指定为 2，返回 CONNECT，成功 切换到透传模式。 2） 通过 ATO 方式：若连接访问模式是最近从透传模式中切换过来的，则 ATO 可以用来切换回透传模 式。返回 CONNECT，成功切换到透传模式；若连接访问模式之前没有进入过透传模式，那么执行 ATO 会返回 NO CARRIER。 上海移远通信技术股份有限公司 8 / 45 LTE Standard TCP/IP 应用指导 备注 1. 在非透传 Buffer 模式下，如果缓存不为空，直到通过 AT+QIRD 读取缓存里面所有接收的数据后， 模块才会上报一个新的 URC。 2. 在透传模式下，不可执行 AT 命令。 若因网络错误或者其他原因导致 Socket 连接断开，模块会上 报 NO CARRIER，并退出透传模式，在这种情况下可以执行 AT+QICLOSE 来关闭 Socket 服务。 上海移远通信技术股份有限公司 9 / 45 LTE Standard TCP/IP 应用指导 2 TCP/IP AT 命令详解 2.1. AT 命令说明 2.1.1. AT+QICSGP 配置 TCP/IP 场景参数 该命令可用来配置、、以及其他 TCP/IP 场景参数。QoS 设置配置 需通过 AT+CGQMIN，AT+CGEQMIN，AT+CGQREQ 与 AT+CGEQREQ 命令。 AT+QICSGP 配置 TCP/IP 场景相关参数 测试命令 AT+QICSGP=? 响应 +QICSGP: (1-16),(1-3),,,,(0 -3),(0-1) 设置命令 查询指定场景配置 AT+QICSGP= OK 响应 +QICSGP: ,,,, 设置命令 配置指定场景 AT+QICSGP=[,,[,,)[,[,]] ]] OK 响应 OK 如有错误： ERROR 参数 整型，场景 ID。范围：1-16。 整型，协议类型。 1 IPv4 2 IPv6 3 IPv4v6 字符串类型，接入点名称。 字符串类型，用户名。允许输入最大长度 127 字节。 上海移远通信技术股份有限公司 10 / 45 LTE Standard TCP/IP 应用指导 字符串类型，密码。允许输入最大长度 127 字节。 整型，鉴权方式。 0 None 1 PAP 2 CHAP 3 PAP 或 CHAP 整型，表示配置是否在 CDMA 网络下保存和。 0 禁用 1 使能 举例 AT+QICSGP=1 +QICSGP: 1,'','','',0 OK AT+QICSGP=1,1,'UNINET','','',1 OK //查询场景 1 配置 //配置场景 1，APN 配置为'UNINET'（中国联通）。 2.1.2. AT+QIACT 激活 PDP 场景 在用 AT+QIACT 激活 PDP 场景前，需要使用 AT+QICSGP 来配置场景。场景激活后，可以通过 AT+QIACT?来查询 IP 地址。 的范围是 1-16，模块最多可同时激活 3 路 PDP 场景。受网络状态影响，执行 AT+QIACT 命令后，等待返回结果 OK 或者 ERROR 的最大时间为 150 秒，在结果尚未返回之前，不允许执行任何 AT 命令。 AT+QIACT 激活 PDP 场景 测试命令 AT+QIACT=? 响应 +QIACT: (1-16) 查询命令 AT+QIACT? OK 响应 返回当前所有被激活的场景与 IP 地址： +QIACT: 1,,[,] [..... +QIACT: 16,,[,]] OK 上海移远通信技术股份有限公司 11 / 45 设置命令 AT+QIACT= 最大响应时间 LTE Standard TCP/IP 应用指导 响应 激活指定场景： OK 如有错误： ERROR 150 秒，受网络状态影响。 参数 整型，场景 ID。范围：1-16。 整型，场景状态。 0 被去激活 1 被激活 整型，协议类型。 1 IPv4 2 IPv6 3 IPv4v6 场景被激活后本地 IP 地址。 2.1.3. AT+QIDEACT 去激活 PDP 场景 该命令可用来去激活特定场景，断开在这个场景内建立的所有 TCP/IP 连接。受网络状态影响，执行 AT+QIDEACT 命令后，等待返回结果 OK 或者 ERROR 的最大时间为 40 秒。在结果尚未返回之前，不允 许执行任何 AT 命令。 AT+QIDEACT 去激活 PDP 场景 测试命令 AT+QIDEACT=? 响应 +QIDEACT: (1-16) 设置命令 AT+QIDEACT= OK 响应 OK 最大响应时间 如有错误： ERROR 40 秒，受网络状态影响。 上海移远通信技术股份有限公司 12 / 45 参数 整型，场景 ID。范围：1-16. LTE Standard TCP/IP 应用指导 2.1.4. AT+QIOPEN 打开 Socket 服务 该命令可用来打开 Socket 服务。服务类型可通过参数来指定，数据访问模式（非透传 Buffer 模式，非透传 Push 模式和透传模式）可通过参数来配置，URC +QIOPEN 会显示 Socket 服务是否成功打开。 1. 如果是'TCP LISTENER'，那么模块作为 TCP 服务器来使用。接受一个新的 TCP 连接 后，模块会自动指定一个并上报一个 URC +QIURC: 'incoming',,,,，其中 范围是 0-11，这个新的连接请求类型是'TCP IN COMING'它的参数值和'TCP LISTENER'的该参数值一样。 2. 如果是'UDP SERVICE'，则可通过向远程 IP 收发 UDP 数据。  发送数据：执行 AT+QISEND=,,,。  在非透传 Push 模式下接收数据：模块会上报一个 URC +QIURC: 'recv',,,,。  在非透传 Buffer 模式下接收数据：模块会上报一个 URC +QIURC: 'recv',，然后客 户可通过 AT+QIRD=检索数据。 3. 等待+QIOPEN: ,输出，建议等待 150 秒，如果 150 秒内未接收到 URC，则需通过 AT+QICLOSE 来关闭 Socket。 AT+QIOPEN 打开 Socket 服务 测试命令 AT+QIOPEN=? 响应： +QIOPEN: (1-16),(0-11),'TCP/UDP/TCP LISTENER/UDP S ERVICE','/',, ,(0-2) OK 设置命令 AT+QIOPEN=,,,/,[,[,]] 响应： 如果是透传模式（=2）并且 成功打开服务： CONNECT 如有错误： ERROR 可以通过 AT+QIGETERROR 获悉错误描述。 如果是非透传 Buffer 模式（ 上海移远通信技术股份有限公司 13 / 45 最大响应时间 LTE Standard TCP/IP 应用指导 =0）或者非透传 Push 模式（=1）： OK +QIOPEN: , 当服务成功打开，是 0，其他情况下不是 0。 150 秒，受网络状态影响。 参数 整型，场景 ID。范围：1-16。 整型，Socket 连接号。范围：0-11。 字符串类型，Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP SERVICE' 建立 TCP 服务 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'UDP SERVICE' 建立 UDP 服务 'UDP LISTENER' 建立 UDP 服务器监听 UDP 连接 字符串类型。 如 果 是 'TCP' 或 者 'UDP', 则 为 远 程 服 务 器 的 IP 地 址 ， 例 如 220.180.239.212. 如果是 'TCP LISTENER'或者'UDP SERVICE',请输入 127.0.0.1. 字符串类型，远程服务器的域名地址。 远程服务器端口，范围：0-65535。只有当 是'TCP'或者'UDP'时才 有效。 本地端口，范围：0-65535。 如果是 'TCP LISTENER'或者'UDP SERVICE'，该参数必须指定。 如果是'TCP'或者'UDP', 且 是 0，那么将会自动分配本 地端口；否则本地端口会被指定。 整型，Socket 服务的数据访问模式。 0 非透传 Buffer 模式 1 非透传 Push 模式 2 透传模式 整型，操作错误代码，请参阅第 4 章。 备注 仅 EG95 和 EG91 支持的参数值'UDP LISTENER'。 上海移远通信技术股份有限公司 14 / 45 LTE Standard TCP/IP 应用指导 2.1.5. AT+QICLOSE 关闭 Socket 服务 该命令可用来关闭特定的 Socket 服务。受网络状态影响，执行 AT+QICLOSE 命令后，等待返回结果 OK 或者 ERROR 的最大时间为 10 秒（此为默认值，可以通过来修改）。在结果尚未返回之前， 不允许执行任何 AT 命令。 AT+QICLOSE 关闭 Socket 服务 测试命令 AT+QICLOSE=? 响应 +QICLOSE: (0-11),(0-65535) OK 设置命令 AT+QICLOSE=[,] 响应 关闭成功： OK 关闭失败： ERROR 参数 整型，Socket 连接号。范围：0-11。 整型，输出响应结果的超时时间值。若未在时间范围内接收到其他客户端的 FIN ACK，模块会强制关闭 Socket。范围：0-65535。默认值：0。单位：秒。 2.1.6. AT+QISTATE 查询 Socket 服务状态 该命令可用来查询 Socket 服务状态。若为 0，则返回在特定场景下现存所有 Socket 服 务的状态；若为 1，则返回特定 Socket 服务的状态。 AT+QISTATE 查询 Socket 服务状态 测试命令 AT+QISTATE=? 响应 OK 查询/执行命令 AT+QISTATE? 或 AT+QISTATE 响应 返回现存所有连接状态： +QISTATE: ,,,,,,,,, […] […] OK 上海移远通信技术股份有限公司 15 / 45 LTE Standard TCP/IP 应用指导 设置命令 若为 0, 查询特定场景下 的连接状态 AT+QISTATE=, 响应 返回特定场景下现存所有连接的状态： +QISTATE: ,,,,,,,,, […] 设置命令 若为 1, 查询特定 Socket 服务连接状态 AT+QISTATE=, OK 响应 +QISTATE: ,,,,,,,,, OK Parameter 整型，查询类型。 0 查询特定场景下所有 Socket 服务的连接状态 1 查询特定 Socket 服务连接状态 整型，场景 ID。范围：1-16。 整型，Socket 连接号。范围：0-11。 字符串类型，Socket 服务类型。 'TCP' 客户端建立 TCP 连接 'UDP' 客户端建立 UDP 连接 'TCP SERVICE' 建立 TCP 服务 'TCP LISTENER' 建立 TCP 服务器监听 TCP 连接 'TCP INCOMING' 建立 TCP 服务器接受的 TCP 连接 'UDP SERVICE' 建立 UDP 服务 'UDP LISTENER' 建立 UDP 服务器监听 UDP 连接 'UDP INCOMING' 建立 UDP 服务器接受的 UDP 连接 IP 地址。 若='TCP'或'UDP'，则指远程服务器 IP 地址 若='TCP LISTENER'或'UDP SERVICE'，则指本地 IP 地址 若='TCP INCOMING'或'UDP INCOMING'，则指远程客户端 IP 地址 远程端口号。 若='TCP'或'UDP'，则指远程服务器端口 若='TCP LISTENER'或'UDP SERVICE'，则端口无效. 若='TCP INCOMING'或'UDP INCOMING'，则指远程客户端端口 本地端口号。 若为 0，本地端口自动分配 整型，Socket 服务状态。 0 'Initial' 尚未建立连接 上海移远通信技术股份有限公司 16 / 45 LTE Standard TCP/IP 应用指导 1 'Opening' 客户端正在连接或者服务器正尝试监听 2 'Connected' 客户端连接已建立 3 'Listening' 服务器正在监听 4 'Closing' 连接断开 只有当是'TCP INCOMING'时才有效。 代表哪个服务器接 受了这个 TCP 连接，这个参数值和该服务器'TCP LISTENER'的值一样。 数据访问模式。 0 非透传 Buffer 模式 1 非透传 Push 模式 2 透传模式 字符串类型，Socket 服务的 COM 口。 'usbmodem' USB modem port 'usbat' USB AT port 'uart1' UART port 1 'cmux1' MUX port 1 'cmux2' MUX port 2 'cmux3' MUX port 3 'cmux4' MUX port 4 备注 仅 EG95 和 EG91 支持的参数值'UDP LISTENER'。 2.1.7. AT+QISEND 发送数据 若特定 Socket 服务的是非透传 Buffer 模式（=0）或者非透传 Push 模式（=1），可通过 AT+QISEND 发送数据，成功发送数据到模块，则返回 SEND OK； 否则返回 SEND FAIL 或 ERROR。其中，SEND FAIL 说明发送缓存已满，可以尝试重新发送数据；ERROR 说明在发送数据过程中遇到错误，请延迟一段时间后再次发送数据，其中最大字节长度是 1460 字节；SEND OK 不代表数据已经成功发送至服务器，可通过 AT+QISEND=,0 命令来查询数据是否已经发 送至服务器。 AT+QISEND 发送数据 测试命令 AT+QISEND=? 响应 +QISEND: (0-11),(0-1460) OK 设置命令 响应 若为'TCP', 'UDP'或者 > 'TCP INCOMING'、'UDP INCOMING'， 响应>后，输入需要发送的数据，按'CTRL+Z'发送数据，按 发送长度可变数据 ESC 取消发送。 AT+QISEND= 上海移远通信技术股份有限公司 17 / 45 LTE Standard TCP/IP 应用指导 若连接已经建立，且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 设置命令 响应 若 为 'TCP', 'UDP' 或 > 'TCP INCOMING'、'UDP INCOMING'， 响应>后，输入长度等于的数据。 发送固定长度数据 AT+QISEND=, SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 设置命令 若为'UDP SERVICE' AT+QISEND=,,, 若连接未建立，异常断开或者参数不正确： ERROR 响应 该命令可用来发送固定字节长度数据到特定的远程 IP 地址和远 程端口， 必须是'UDP SERVICE'. > 响应>后，输入长度等于的数据。 若连接已经建立且发送成功： SEND OK 若连接已经建立，但是发送缓存已满： SEND FAIL 若连接未建立，异常断开或者参数不正确： ERROR 设置命令 当为 0，可查询发送数据 AT+QISEND=,0 响应 若指定连接存在： +QISEND: ,, OK 如有错误： ERROR 上海移远通信技术股份有限公司 18 / 45 LTE Standard TCP/IP 应用指导 参数 整型，Socket 连接号。范围：0-11。 整型，发送数据字节长度。不得大于 1460 字节。 字符串类型，远程 IP 地址（必须是点分十进制格式）。只有当为'UDP SERVICE'才有效。 整型，远程端口。只有当为'UDP SERVICE'才有效。 整型，发送数据总长度。单位：字节。 整型，收到数据总长度。单位：字节。 整型，未收到数据总长度。单位：字节。 整型，操作代码错误。请参照第 4 章。 备注 仅 EG95 和 EG91 支持的参数值'UDP LISTENER'。 2.1.8. AT+QIRD 读取收到的 TCP/IP 数据 在非透传 Buffer 模式下，收到数据后，模块会缓存数据并上报+QIURC: 'recv',，这样才 能通过 AT+QIRD 来读取这些数据。 在缓存不为空的情况下，模块再次接收数据，模块将不会上报新的 URC， 直到 buffer 里面所有接收 数据都已经通过 AT+QIRD 读取才会上报。 AT+QIRD 读取收到的 TCP/IP 数据 测试命令 AT+QIRD=? 响应 +QIRD: (0-11),(0-1500) 设置命令 当为'TCP'/'UDP'/'TCP INCOMING'/'UDP INCOMING' AT+QIRD=[,] OK 响应 若特定连接收到数据： +QIRD: OK 若无数据： +QIRD: 0 OK 若连接不存在： ERROR 上海移远通信技术股份有限公司 19 / 45 LTE Standard TCP/IP 应用指导 设置命令 当为'UDP SERVICE' AT+QIRD= 响应 若数据存在： +QIRD: ,, OK 若无数据： +QIRD: 0 OK 设置命令 当为 0，查询读取的数据 AT+QIRD=,0 若连接不存在： ERROR 响应 若指定连接存在： +QIRD: ,, OK 如有错误： ERROR 参数 整型，Socket 连接号。范围：0-11。 待读取数据的最大长度。范围：0-1500。单位：字节。 实际接收数据的长度。单位：字节。 字符串类型，远程 IP 地址。只有当为'UDP SERVICE'时才有 效。 整型，远程端口。只有为'UDP SERVICE'才有效。 读取的数据。 接收数据的总长度。单位：字节。 已读取数据的长度。单位：字节。 未读取数据的长度。单位：字节。 备注 仅 EG95 和 EG91 支持的参数值'UDP LISTENER'。 上海移远通信技术股份有限公司 20 / 45 LTE Standard TCP/IP 应用指导 2.1.9. AT+QISENDEX 发送 16 进制字符串数据 该命令可用来发送 16 进制字符串数据，不适用于'UDP SERVICE'和'TCP LISTENER'两种 Socket 服 务类型。 AT+QISENDEX 发送 16 进制字符串数据 测试命令 AT+QISENDEX=? 响应 +QISENDEX: (0-11), 设置命令 AT+QISENDEX=, OK 响应 若数据发送成功： SEND OK 若发送缓存已满： SEND FAIL 连接不存在： ERROR 参数 整型，Socket 连接号。范围：0-11 字符串类型，16 进制字符串数据。最大字节长度为 512 字节。 2.1.10. AT+QISWTMD 切换数据访问模式 该命令可用来切换数据访问模式：非透传 Buffer 模式，非透传 Push 模式和透传模式。建立 Socket 服 务时，可以通过 AT+QIOPEN 的参数来指定数据访问模式，Socket 服务打开以后，可以 通过 AT+QISWTMD 来切换模式。 AT+QISWTMD 切换数据访问模式 测试命令 AT+QISWTMD=? 响应 +QISWTMD: (0-11),(0-2) 设置命令 AT+QISWTMD=, OK 响应 若数据访问模式切换成功，为 0 或 1： OK 若数据访问模式切换成功，为 2，模块会进入 数据模式： 上海移远通信技术股份有限公司 21 / 45 CONNECT 如有错误： ERROR 参数 整型，Socket 连接号。范围：0-11。 整型，连接数据访问模式。 0 非透传 Buffer 模式 1 非透传 Push 模式 2 透传模式 LTE Standard TCP/IP 应用指导 2.1.11. AT+QPING 进行远程服务器 Ping 操作 该命令可用来检测 Host 网络协议可达性。在使用 Ping 工具前，Host 应首先通过 AT+QIACT 激活 对应的场景，在期间内返回结果，默认值是 4 秒。 AT+QPING 进行远程服务器 Ping 操作 测试命令 AT+QPING=? 响应 +QPING: (1-16),,(1-255),(1-10) 设置命令 AT+QPING=,[,[,]] OK 响应 若远程服务器 Ping 操作成功： OK [+QPING: [,,,,]…] +QPING: [,,,,,, ] 如有错误： ERROR 参数 整型，场景 ID。范围：1-16。 字符串类型，Host 地址。格式为域名或点分十进制 IP 地址。 整型，设置每个 Ping 请求回应等待最大时间。范围：1-255。默认值：4。单位：秒。 整型，设置 Ping 请求最大次数。范围：1-10。默认值：4。 每个 Ping 请求结果。 上海移远通信技术股份有限公司 22 / 45 LTE Standard TCP/IP 应用指导 0 从服务器接收到 Ping 响应，紧跟,,,,。 其他值 请参阅第 4 章。 远程服务器 IP 地址。格式为点分十进制 IP。 发送 Ping 请求字节长度。单位：字节。 发送 Ping 请求后等待响应时间。单位：毫秒。 Ping 请求回应数据包 TTL 值。 该命令执行后最终结果。 0 正常结束，成功激活场景并找到 Host，此情况下紧跟,,,, ,, 其他值 错误码。请参阅第 4 章。 Ping 请求发送次数。 得到响应的 Ping 请求个数。 Ping 请求超时的个数。 最小响应时间。单位：毫秒。 最大响应时间。单位：毫秒。 平均响应时间。单位：毫秒。 2.1.12. AT+QNTP 使用 NTP 服务器同步本地时间 该命令用于通过 NTP 服务器同步本地时间到 UTC 时间，在同步之前，Host 需通过 AT+QIACT 来激活 对应的场景。受网络状态影响，等待返回结果最多需要 125 秒。 AT+QNTP 使用 NTP 服务器同步本地时间 测试命令 AT+QNTP=? 响应 +QNTP: (1-16),,(支持的列表),(0,1) 查询命令 AT+QNTP? OK 响应 若在同步时间过程中： +QNTP: , 设置命令 AT+QNTP=, [,[,]] OK 响应 同步成功： OK +QNTP: , 最大响应时间 如有错误： ERROR 受网络状态影响，最大 125 秒。 上海移远通信技术股份有限公司 23 / 45 LTE Standard TCP/IP 应用指导 参数 整型，场景ID。范围：1-16。 字符串类型，NTP服务器地址。 整型，NTP服务器端口。范围：1-65535。 整型，是否自动设置同步时间到本地时间。 0 不设置 1 设置 整型，错误码。请参阅第4章。 字符串类型，从NTP服务器上同步的时间。 格式为YYYY/MM/DD,hh:mm:sszz，zz的范围：-48~+56. 2.1.13. AT+QIDNSCFG 配置 DNS 服务器地址 在配置 DNS 地址之前，Host 需通过 AT+QIACT 来激活对应的场景。 AT+QIDNSCFG 配置 DNS 服务器地址 测试命令 响应： AT+QIDNSCFG=? +QIDNSCFG: (1-16),, 设置命令 AT+QIDNSCFG=[,[,]] OK 响应： 若缺省参数和，则查询指定 PDP 场景 当前 DNS 服务器地址： +QIDNSCFG: ,, OK 若不缺省参数和，则配置指定 PDP 场 景的主要 DNS 服务器地址和次要 DNS 服务器地址： OK 如有错误： ERROR 参数 整型，PDP 场景 ID。范围：1-16。 字符串类型，主要 DNS 服务器地址。 字符串类型，次要 DNS 服务器地址。 上海移远通信技术股份有限公司 24 / 45 LTE Standard TCP/IP 应用指导 2.1.14. AT+QIDNSGIP 用域名获取 IP 地址 查询 DNS 之前，Host 需通过 AT+QIACT 来激活对应的场景。受网络状态影响，等待返 回响应结果最多需要 60 秒。 .AT+QIDNSGIP 测试命令 AT+QIDNSGIP=? 用域名获取 IP 地址 响应： +QIDNSGIP: (1-16), 设置命令 AT+QIDNSGIP=, OK 响应： OK 如有错误： ERROR 最大响应时间 以 URC 格式返回结果 +QIURC: 'dnsgip',,, [..... +QIURC: 'dnsgip',] 60 秒，受网络状态影响 参数 整型，PDP 场景 ID。范围：1-16。 字符串类型，域名。 整型，操作错误代码。请参阅第 4 章。 整型，对应的 IP 地址数。 整型，DNS 的 TTL 值。 字符串类型，IP 地址。 2.1.15. AT+QICFG 配置可选参数 该命令可用来配置可选参数。 AT+QICFG 配置可选参数 测试命令 AT+QICFG=? 响应： +QICFG: 'transpktsize',(1-1460) +QICFG: 'transwaittm',(0-20) +QICFG: 'dataformat',(0,1),(0,1) +QICFG: 'viewmode',(0,1) 上海移远通信技术股份有限公司 25 / 45 LTE Standard TCP/IP 应用指导 +QICFG: 'tcp/retranscfg',(3-20),(5-1000) +QICFG: 'dns/cache',(0,1) +QICFG: 'qisend/timeout',(0-3600) +QICFG: 'passiveclosed',(0,1) +QICFG: 'udp/readmode',(0,1) +QICFG: 'udp/sendmode',(0,1) +QICFG: 'tcp/accept',(0,1) +QICFG: 'tcp/keepalive',(0,1),(1-120),(25-100),(3-10) +QICFG: 'recv/buffersize',(10240-524288) +QICFG: 'recvind',(0,1) 设置命令 设置透传模式数据包大小 AT+QICFG='transpktsize'[,] OK 响应： [+QICFG: 'transpktsize',] OK 设置命令 设置透传模式等待时间 AT+QICFG='transwaittm'[,] 如有错误： ERROR 响应： [+QICFG: 'transwaittm',] OK 如有错误： ERROR 设置命令 响应 设置收发数据格式（仅限非透传模 [+QICFG: 式） 'dataformat',,] AT+QICFG='dataformat'[,,] 如有错误： ERROR 设置命令 响应 设置接收数据显示格式（仅限非透传 [+QICFG: 'viewmode',] 模式） AT+QICFG='viewmode'[,] 如有错误： ERROR 设置命令 响应 设置 TCP 重新发送的最大间隔时间 [+QICFG: 'tcp/retranscfg',,] 和次数 上海移远通信技术股份有限公司 26 / 45 LTE Standard TCP/IP 应用指导 AT+QICFG='tcp/retranscfg'[,,] 设置命令 使能或者关闭 DNS 缓存 AT+QICFG='dns/cache'[,dns_ca che] OK 如有错误： ERROR 响应 [+QICFG: 'dns/cache',] OK 设置命令 设置输入数据超时时间 AT+QICFG='qisend/timeout'[,ti me] 如有错误： ERROR 响应： [+QICFG: 'qisend/timeout',] OK 设置命令 服务器关闭后，使能或者禁止 TCP 连接自动断开 AT+QICFG='passiveclosed'[,clo sed] 设置命令 读取 UDP 数据模式 AT+QICFG='udp/readmode'[,mo de] 如有错误： ERROR 响应： [+QICFG: 'passiveclosed',] OK 如有错误： ERROR 响应： [+QICFG: 'udp/readmode',] OK 设置命令 发送 UPD 数据模式 AT+QICFG='udp/sendmode'[,m ode] 如有错误： ERROR 响应： [+QICFG: 'udp/sendmode',] OK 设置命令 使能或禁止自动接收来自客户端的 TCP 连接 AT+QICFG='tcp/accept'[,state] 如有错误： ERROR 响应： [+QICFG: 'tcp/accept',] OK 上海移远通信技术股份有限公司 27 / 45 LTE Standard TCP/IP 应用指导 设置命令 发送 TCP 保活 AT+QICFG='tcp/keepalive',[,,,] 如有错误： ERROR 响应： ['tcp/keepalive',[,,] OK 设置命令 设置接收缓存大小 AT+QICFG='recv/buffersize'[,] 如有错误： ERROR 响应： [+QICFG: 'recv/buffersize',] OK 设置命令 配置 TCP/IP 非透传 Buffer 模式 URC 格式 AT+QICFG='recvind'[,enable] 如有错误： ERROR 响应： [+QICFG: 'recvind',] OK 如有错误： ERROR 参数 整型，待发数据包字节最大长度。范围：1-1460。默认值：1024。单位：字节。 整型，在透传模式下，若从端口接收的数据长度小于指定长度， 超出指定时间后数据可直接发送。范围：0-20。默认值：2。单 位：100 毫秒。 整型，发送数据格式。当设置为 16 进制模式时，不需要带 0x 前缀，模块会自 动把两个字节拼成一个 ASCII 码。 0 文本模式 1 16 进制模式 整型，接收数据格式。当设置为 16 进制模式时，不需要带 0x 前缀，模块会自 动把两个字节拼成一个 ASCII 码。 0 文本模式 1 16 进制模式 整型。 0 接收数据的输出方式：data headerrndata. 1 接收数据的输出方式：data header,data. 整型，TCP 重新发送最大次数。范围：3-20，默认值：12。 上海移远通信技术股份有限公司 28 / 45 LTE Standard TCP/IP 应用指导 整型，TCP 重新发送间隔时间。 范围：5-1000。默认值：600。单位：100 毫秒。 整型。 0 关闭 DNS 缓存 1 使能 DNS 缓存 整 型 ， AT+QISEND 的 超 时 周 期 。 响 应 > 后 ， 若 在 周 期 内 无 数 据 输 入 ， AT+QISEND 命令将退出。范围：0-3600。默认值：0。单位：毫秒。 整型。 0 禁止 TCP 连接在服务器关闭后自动断开 1 使能 TCP 连接在服务器关闭后自动断开 整型。 0 禁止块模式 1 使能流模式 整型。 0 禁止自动接受来自客户端的 TCP 连接 1 使能自动接受来自客户端的 TCP 连接 整型，在命令 AT+QICFG='tcp/keepalive'中表示是否发送 TCP 保活信息，在 命令 AT+QICFG='recvind'表示是否配置 TCP/IP 非透传 Buffer 模式下 URC 格式。 0 禁止对应功能 1 使能对应功能 整型，触发 keepalive 循环时间。范围：1-120。单位：分钟。 整型，在循环时间内发送数据包间隔时间。范围：25-100。单位：秒。 整型，在循环时间内发送数据包的 cnt。范围：3-10。 整型，TCP/IP 接收缓存大小。范围：10240-524288。默认值：10240。单位： 字节。 备注 不能保存 AT+QICFG='tcp/retranscfg'[,,]值到 NV，且对所有 TCP Socket 有效。 2.1.16. AT+QISDE 控制是否回显 AT+QISEND 的数据 该命令可用来控制是否回显 AT+QISEND 的数据。 AT+QISDE 控制是否回显 AT+QISEND 数据 测试命令 AT+QISDE=? 响应： +QISDE: (0,1) 查询命令 AT+QISDE? OK 响应： +QISDE: 上海移远通信技术股份有限公司 29 / 45 LTE Standard TCP/IP 应用指导 设置命令 AT+QISDE= OK 响应： OK 如有错误： ERROR 参数 数字类型，是否回显 AT+QISEND 数据。 0 不回显 1 回显 2.1.17. AT+QIGETERROR 查询上一个错误代码 若 执 行 TCP/IP 命 令 后 返 回 ERROR ， 错 误 详 情 可 通 过 AT+QIGETERROR 查 询 。 需 注 意 AT+QIGETERROR 只返回上一个 TCP/IP AT 命令错误代码。 AT+QIGETERROR 查询上一个错误代码 测试命令 AT+QIGETERROR=? 执行命令 AT+QIGETERROR 响应： OK 响应： +QIGETERROR: , OK 参数 整型，操作错误代码。请参阅第 4 章。 字符串参数，指示详细错误信息。请参阅第 4 章。 2.2. URC 说明 TCP/IP AT 命令的 URC 统一以+QIURC:形式上报 Host，涉及数据接收，连接断开和接入等。在 URC 的前后均有，本文里均不显示。 上海移远通信技术股份有限公司 30 / 45 LTE Standard TCP/IP 应用指导 2.2.1. 连接断开 URC 当 TCP Socket 服务连接被远程客户端断开或者因为网络异常导致断开，模块将上报 URC，同时该 Socket 将处于 Closing 状态，调用 AT+QICLOSE=后 Socket 服务可恢复成 Initial 状态。 连接断开通知 +QIURC: 'closed', Socket 服务连接被断开 参数 整型，Socket 连接号。范围：0-11。 2.2.2. 数据接收 URC 在非透传 Buffer 模式或者非透传 Push 模式下，接收数据后，模块会上报 URC 通知 Host。 在非透传 Buffer 模式下接收数据后，模块会上报 URC +QIURC: 'recv',通知 Host，随后 Host 可通过 AT+QIRD 检索数据。如果缓存不为空且模块再次接收数据的情况下，只有当 Host 通过 AT+QIRD 检索所有接收的数据后，模块才会上报新的 URC。 在非透传 Push 模式下，接收的数据会直接从 COM 端输出。 数据接收 URC +QIURC: 'recv', 在非透传 Buffer 模式下接收数据上报的 URC，Host 可通过 AT+QIRD 获取数据。 +QIURC: 'recv',, 当为'TCP', 'UDP', 'UDP INCOMING'或'TCP INCOMING'，在非透传 Push 模式下接收数据上报的 URC。 +QIURC: 'recv',,,,< LF> 当为'UDP SERVICE'，在非透传 Push 模式下 接收数据上报的 URC。 参数 整型，Socket 连接号。范围：0-11。。 整型，实际接收数据的长度。 远程 IP 地址。 远程端口。 接收的数据。 上海移远通信技术股份有限公司 31 / 45 LTE Standard TCP/IP 应用指导 备注 仅 EG95 和 EG91 支持的参数值'UDP LISTENER'。 2.2.3. 客户端连接已满 URC 如果客户端连接已达限额，或者已经没有 Socket 系统资源可供分配，有新的客户端连接请求时模块会 上报 URC：+QIURC: 'incoming full'。 客户端连接已满 URC +QIURC: 'incoming full' 表示客户端连接请求已满 2.2.4. 客户端连接 URC 如果为'TCP LISTENER'或者'UDP LISTENER'，当一个远程客户端连接到这个服务 器时，Host 会给新连接自动分配一个空闲的，其中范围是 0-11。此时模块会上 报一个 URC，新连接的是'TCP INCOMING'，是非透传 Buffer 模式。 客户端连接 URC +QIURC: 'incoming',,, , 接受了一个新的连接请求时，上报的 URC 会显示分 配的、和 Parameter 整型，模块自动为客户端连接指定分配的 Socket 服务。范围：0-11 接受客户端连接的服务器。服务器的是'TCP LISTENER' 或者'UDP LISTENER'，监听 Socket ID 是。 客户端连接的远程 IP 地址。 客户端连接的远程端口。 备注 仅 EG95 和 EG91 支持的参数值'UDP LISTENER'。 上海移远通信技术股份有限公司 32 / 45 LTE Standard TCP/IP 应用指导 2.2.5. PDP 去激活 URC PDP 可以被网络去激活。PDP 被去激活以后，模块会上报 URC 通知 Host，Host 需执行 AT+QIDEACT 命令去激活场景并重置所有连接。 PDP 去激活 URC +QIURC: 'pdpdeact', 场景被去激活 参数 整型，场景 ID。范围：1-16。 上海移远通信技术股份有限公司 33 / 45 LTE Standard TCP/IP 应用指导 3 示例 3.1. 场景配置和激活 3.1.1. 场景配置 AT+QICSGP=1,1,'UNINET','','',1 OK //配置场景 1，APN 配置为'UNINET'（中国联通）。 3.1.2. 场景激活 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK //激活场景 1，受网络状态影响，最大响应时间为 150 秒， //激活成功。 //查询场景状态。 3.1.3. 场景去激活 AT+QIDEACT=1 OK //去激活场景 1。 //场景去激活成功，受网络状态影响，最大响应时间为 40 秒。 3.2. TCP 客户端在非透传 Buffer 模式下工作 3.2.1. 创建 TCP 客户端连接并进入非透传 Buffer 模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,0 OK // 场 景 是 1 ， 为 0 。 在 执 行 AT+QIOPEN 之前，Host 需要使用 AT+QIACT 激活场景 上海移远通信技术股份有限公司 34 / 45 LTE Standard TCP/IP 应用指导 +QIOPEN: 0,0 //连接成功，等待 URC：+QIOPEN: ,响应建议等待 150 秒。 若 150 秒 内未收到 URC 响应，Host 可以使用 AT+QI CLOSE 断开 Socket。 AT+QISTATE=1,0 //检查连接状态是否为 0。 +QISTATE: 0,'TCP','220.180.239.201',8009,65514,2,1,0,0,'usbmodem' OK 3.2.2. Buffer 模式下发送数据 AT+QISEND=0 > test1 SEND OK AT+QISEND=0,4 > test SEND OK AT+QISEND=0,0 +QISEND: 9,9,0 OK AT+QISENDEX=0,'3132333435' SEND OK AT+QISEND=0,0 +QISEND: 14,14,0 OK //发送可变长度数据，SEND OK 不能代表数据已经成功发送到 服务器。Host 可以通过 AT+QISEND=0,0 来查询数据是否到 达服务器。 //发送固定长度数据，字节长度为 4 字节。 //查询发送数据长度。 //发送 16 进制字符串数据。 //查询发送数据长度，确认数据长度和未确认数据长度。 3.2.3. Buffer 模式下从远处服务器接收数据 +QIURC: 'recv',0 AT+QIRD=0,1500 +QIRD: 5 test1 // 为 0 接收的数据。 //读取数据，字节长度为 1500 字节。 //实际接收数据长度为 5 字节。 OK AT+QICFG='recvind',1 OK +QIURC: 'recv',0,5 AT+QIRD=0,1500 //为 0 接收的数据字节长度为 5 字节 //读取数据，字节长度 1500 字节 上海移远通信技术股份有限公司 35 / 45 +QIRD: 5 test1 OK AT+QIRD=0,1500 +QIRD: 0 OK AT+QIRD=0,0 +QIRD: 10,10,0 OK 3.2.4. 断开连接 AT+QICLOSE=0 OK //实际接收数据长度为 5 字节。 LTE Standard TCP/IP 应用指导 //缓存里无数据。 //查询接收数据总长度，包含已读和未读数据。 //断开为 0 的连接。受网络状态影响，最大响应时间是 10 秒 3.3. TCP 客户端在透传模式下工作 3.3.1. 创建 TCP 客户端连接并进入透传模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,2 //场景为 1，为 0。执行 AT+QIOPEN 之前，Host 需使用 AT+QIACT 来激活场景。 CONNECT //连接成功。等待 URC 响应结果 CONNECT 建议 等待 150 秒。若 150 秒内 URC 无响应，Host 可 通过 AT+QICLOSE 断开 Socket 连接。 3.3.2. 透传模式下发送数据 3.3.3. 透传模式接收远程器端数据 Test 1 //所有从网络接收的数据都会通过 COM 端口直接输 出。 上海移远通信技术股份有限公司 36 / 45 3.3.4. 断开 TCP 客户端连接 AT+QICLOSE=0 OK LTE Standard TCP/IP 应用指导 // 使 用 +++ 退 出 透 传 模 式 后 ， Host 可 以 通 过 AT+QICLOSE 断开 TCP 连接。受网络状态影响，最 大响应时间是 10 秒。 3.4. TCP 客户端在非透传 Push 模式下工作 3.4.1. 创建 TCP 客户端连接并进入非透传 Push 模式 AT+QIOPEN=1,0,'TCP','220.180.239.212',8009,0,1 //场景为 1，为 0。执行 AT+QIOPEN 之前，Host 需使用 AT+QIACT 来激活场景。 OK +QIOPEN: 0,0 //连接成功， 等待 URC：+QIOPEN: ,响应建议等待 150 秒，.若 150 秒内未响 AT+QISTATE=1,0 应，Host 可通过 AT+QICLOSE 断开 Socket //查询的连接状态是否为 0。 +QISTATE: 0,'TCP','220.180.239.201',8009,65344,2,1,0,1,'usbmodem' OK 3.4.2. 非透传 Push 模式下发送数据 AT+QISEND=0 > test1 SEND OK AT+QISEND=0,5 > test2 SEND OK AT+QISEND=0,0 +QISEND: 10,10,0 OK //发送长度可变数据。SEND OK 不能代表数据已经成功 发送至服务器，Host 可通过 AT+QISEND=0,0 查询数据 是否达到服务器。 //发送固定长度数据，长度为 5 字节。 //查询发送数据长度，已确认数据长度和未确认数据长度。 上海移远通信技术股份有限公司 37 / 45 LTE Standard TCP/IP 应用指导 3.4.3. 非透传 Push 模式下接收远程服务器端数据 +QIURC: 'recv',0,4 test //接收远程服务器端数据 3.4.4. 断开 TCP 用户端连接 AT+QICLOSE=0 OK //断开为 0 的连接。受网络状态影响，最大 响应时间为 10 秒。 3.5. TCP 服务器在非透传 Buffer 模式下工作 3.5.1. 启动 TCP 服务器 AT+QIOPEN=1,1,'TCP LISTENER','127.0.0.1',0,2020,0 // 场 景 为 1 ， 为 1 。 执 行 AT+QIOPEN 之 前 ， Host 需 通 过 AT+QIACT 来激活场景。 OK +QIOPEN: 1,0 //TCP 服务器启动成功。 AT+QISTATE=0,1 //查询连接状态是否为 1。 +QISTATE: 1,'TCP LISTENER','10.7.157.1',0,2020,3,1,1,0,'usbmodem' OK 3.5.2. 接受客户端的连接请求 +QIURC: 'incoming',11,1,'172.31.242.222',54091 //接受一个 TCP 连接，为'TCP incoming'，为 11。 3.5.3. 接收的客户端数据 +QIURC: 'recv',11 AT+QIRD=11,1500 +QIRD: 4 test //从远程客户端连接接收的数据。 //读取客户端连接接收的数据。 //实际数据长度为 4 字节。 上海移远通信技术股份有限公司 38 / 45 OK AT+QIRD=11,1500 +QIRD: 0 OK AT+QIRD=11,0 +QIRD: 4,4,0 OK 3.5.4. 断开 TCP 服务器连接 AT+QICLOSE=11 OK AT+QICLOSE=1 OK LTE Standard TCP/IP 应用指导 //缓存无数据。 //查询接收数据总长度，包含已读和未读数据。 //断开客户端连接，受网络状态影响最大响应时间 10 秒。 //关闭 TCP 服务器监听。 3.6. UDP 服务示例 3.6.1. 打开 UDP 服务 AT+QIOPEN=1,2,'UDP SERVICE','127.0.0.1',0,3030,0 // 打 开 UDP 服 务 ， 为 2 ， 为 1. 执行 AT+QIOPEN 之前， Host 需通过 AT+QIACT 来激活场景。 OK +QIOPEN: 2,0 //成功打开 UDP 服务。 AT+QISTATE=0,1 //查询的连接状态是否为 1。 +QISTATE: 2,'UDP SERVICE','10.7.157.1',0,3030,2,1,2,0,'usbmodem' OK 3.6.2. 向服务器发送 UDP 数据 AT+QISEND=2,10,'10.7.89.10',6969 >1234567890 SEND OK //向远程端发送字节长度为 10 字节的数据，远程 端 IP 地址是 10.7.89.10，端口是 6969。 上海移远通信技术股份有限公司 39 / 45 3.6.3. 接收远程端数据 +QIURC: 'recv',2 AT+QIRD=2 +QIRD: 4,'10.7.76.34',7687 AAAA OK AT+QIRD=2 +QIRD: 0 OK AT+QISEND=2,10,'10.7.76.34',7687 >1234567890 SEND OK 3.6.4. 关闭 UDP 服务 AT+QICLOSE=2 OK LTE Standard TCP/IP 应用指导 //接收远程端数据。 //读取 UDP 数据。可输出一整个 UDP 数据包，无 需指定读取长度。 //数据长度为 4，远程 IP 地址 10.7.76.34，远程端 口是 7697。 //读取数据。 //缓存无数据。 //向远程端发送数据，远程端 IP 地址为 10.7.76.34， 远程端口是 7687。 //关闭服务。 3.7. PING AT+QPING=1,'www.baidu.com' OK +QPING: 0,'61.135.169.125',32,192,255 +QPING: 0,'61.135.169.125',32,240,255 +QPING: 0,'61.135.169.125',32,241,255 +QPING: 0,'61.135.169.125',32,479,255 +QPING: 0,4,4,0,192,479,287 //在场景 1 中 Ping www.baidu.com，在 Ping 目标 IP 地址前，Host 需通过 AT+QIACT 来激活场景。 上海移远通信技术股份有限公司 40 / 45 3.8. 同步本地时间 AT+QNTP=1,'202.112.10.36',123 OK +QNTP: 0,'2019/07/21,06:10:59+00' AT+CCLK? +CCLK: '19/07/21,06:11:05+00' OK LTE Standard TCP/IP 应用指导 //使用 NTP 服务器 202.112.10.36:123 同步时间。同 步时间之前，Host 需要通过 AT+QIACT 来激活场 景。 3.9. 获取上一个错误代码示例 AT+QIOPEN=1,'TCP','220.180.239.212',8009,0,1 ERROR AT+QIGETERROR +QIGETERROR: 552, invalid parameters //开启Socket服务，省略了。 OK 上海移远通信技术股份有限公司 41 / 45 LTE Standard TCP/IP 应用指导 4 错误代码 当 TCP/IP 的 AT 命令返回 ERROR 时，具体的错误类型可以通过 AT+QIGETERROR 来查询。需注意 AT+QIGETERROR 查询的是上一个 TCP/IP AT 命令的错误代码。 表 1：错误代码列表 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 代表意义 Operation successful Unknown error Operation blocked Invalid parameters Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy DNS parse failed 上海移远通信技术股份有限公司 42 / 45 LTE Standard TCP/IP 应用指导 566 Socket connect failed 567 Socket has been closed 568 Operation busy 569 Operation timeout 570 PDP context broken down 571 Cancel send 572 Operation not allowed 573 APN not configured 574 Port busy 上海移远通信技术股份有限公司 43 / 45 LTE Standard TCP/IP 应用指导 5 附录 A 术语缩写 表 2：术语缩写 缩写 英文全称 中文全称 3GPP ACK APN ASCII CHAP CS DNS FIN ID IP NTP NV PAP PDP PPP PS QoS TCP UART 3rd Generation Partnership Project 第三代合作伙伴计划 Acknowledge 确认字符 Access Point Name 接入点名称 American Standard Code for Information Interchange 美国信息交换标准代码 Challenge Handshake Authentication Protocol 挑战握手认证协议 Circuit Switching 电路交换 Domain Name System 域名系统 Finish 完成 Identify 身份证标识号 Internet Protocol 互联网协议 Network Time Protocol 网络时间协议 Non-Volatile 非易失 Password Authentication Protocol 密码认证协议 Packet Data Protocol 分组数据协议 Point-to-Point Protocol 点对点协议 Packet Switching 分组交换 Quality of Service 服务质量 Transmission Control Protocol 传输控制协议 Universal Asynchronous Receiver& Transmitter 通用异步收发器 上海移远通信技术股份有限公司 44 / 45 UDP URC USB (U)SIM UTC User Datagram Protocol Unsolicited Result Code Universal Serial Bus (Universal) Subscriber Identity Module Coordinated Universal Time LTE Standard TCP/IP 应用指导 用户数据包协议 非请求结果码 通用串行总线 （全球）用户身份模块 协调世界时 上海移远通信技术股份有限公司 45 / 45

EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 LTE Standard 模块系列 版本：1.0 日期：2020-08-30 状态：受控文件 www.quectel.com EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功 能错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的 使用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任 何因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 文档历史 修订记录 版本 1.0 日期 2020-08-30 作者 刘康康 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 5 1 引言 ........................................................................................................................................................ 6 1.1. SSL 版本和加密套件 ................................................................................................................... 7 1.2. SSL 功能使用流程....................................................................................................................... 9 1.3. 数据访问模式说明 ....................................................................................................................... 9 1.4. 证书有效性验证 ......................................................................................................................... 10 1.5. 服务器名称指示 ......................................................................................................................... 10 2 SSL AT 命令详解 ................................................................................................................................ 11 2.1. AT 命令语句............................................................................................................................... 11 2.1.1. 定义 ................................................................................................................................ 11 2.1.2. AT 命令语句 ................................................................................................................... 11 2.2. SSL 相关 AT 命令描述............................................................................................................... 12 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 ...................................................................... 12 2.2.2. AT+QSSLOPEN 打开 SSL Socket 连接远程服务器.................................................... 20 2.2.3. AT+QSSLSEND 通过 SSL 连接发送数据.................................................................... 21 2.2.4. AT+QSSLRECV 通过 SSL 连接接收数据.................................................................... 22 2.2.5. AT+QSSLCLOSE 关闭 SSL 连接 ................................................................................ 23 2.2.6. AT+QSSLSTATE 查询 Socket 连接状态...................................................................... 24 2.3. URC 详解 .................................................................................................................................. 25 2.3.1. +QSSLURC: 'recv' 通知主机接收数据........................................................................ 25 2.3.2. +QSSLURC: 'closed' 通知异常断开连接 .................................................................... 25 3 举例 ...................................................................................................................................................... 27 3.1. 配置并激活 PDP 上下文 ............................................................................................................ 27 3.1.1. 配置 PDP 上下文 ............................................................................................................ 27 3.1.2. 激活 PDP 上下文 ............................................................................................................ 27 3.1.3. 去激活 PDP 上下文 ........................................................................................................ 27 3.2. 配置 SSL 上下文........................................................................................................................ 27 3.3. SSL 客户端在缓存模式下工作................................................................................................... 28 3.3.1. 建立 SSL 连接并进入缓存模式....................................................................................... 28 3.3.2. 缓存模式下发送数据....................................................................................................... 28 3.3.2.1. 发送不定长数据..................................................................................................... 28 3.3.2.2. 发送定长数据 ........................................................................................................ 28 3.3.3. 缓存模式下接收数据....................................................................................................... 28 3.3.4. 关闭 SSL 连接 ................................................................................................................ 29 3.4. SSL 客户端在直吐模式下工作................................................................................................... 29 3.4.1. 建立 SSL 连接并进入直吐模式....................................................................................... 29 3.4.2. 直吐模式下发送数据....................................................................................................... 29 3.4.3. 直吐模式下接收数据....................................................................................................... 30 上海移远通信技术股份有限公司 3 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 3.4.4. 关闭 SSL 连接 ................................................................................................................ 30 3.5. SSL 客户在透传模式下工作 ...................................................................................................... 30 3.5.1. 建立 SSL 连接并在透传模式下发送数据 ........................................................................ 30 3.5.2. 建立 SSL 连接并在透传模式下接收数据 ........................................................................ 30 3.5.3. 关闭 SSL 连接 ................................................................................................................ 30 4 错误处理 ............................................................................................................................................... 31 4.1. 打开 SSL 连接失败 .................................................................................................................... 31 5 错误代码 ............................................................................................................................................... 32 6 附录 A 参考文档和术语缩写................................................................................................................ 34 上海移远通信技术股份有限公司 4 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 6 表 2：SSL 版本 ............................................................................................................................................ 7 表 3：支持的 SSL 加密套件 ......................................................................................................................... 7 表 4：AT 命令及响应类型............................................................................................................................11 表 5：错误代码 ........................................................................................................................................... 32 表 6：参考文档 ........................................................................................................................................... 34 表 7：术语缩写 ........................................................................................................................................... 34 上海移远通信技术股份有限公司 5 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 1 引言 移远通信 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块支持 SSL 功能。SSL 功能即为确保通 信的私密性，在某些情况下，服务器和客户端之间的通信应采用加密方式，以防止在通信过程中数据被窃 听、篡改或伪造。 本文档主要介绍如何通过 AT 命令应用如下移远通信模块的 SSL 功能。 表 1：适用模块 模块系列 EC2x 系列 EG9x 系列 EG2x-G EM05 系列 模块 EC25 系列 EC21 系列 EC20 R2.1 EC20-CN EG95 系列 EG91 系列 EG21-G EG25-G EM05 系列 上海移远通信技术股份有限公司 6 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 1.1. SSL 版本和加密套件 下表为支持的 SSL 版本。 表 2：SSL 版本 SSL 版本 SSL3.0 TLS1.2 TLS1.1 TLS1.0 下表为移远通信 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列模块支持的 SSL 加密套件，默认支 持所有加密套件。有关加密套件的详细说明，可参考《RFC 2246-The TLS Protocol Version 1.0》。 表 3：支持的 SSL 加密套件 加密套件代码 0X0035 0X002F 0X0005 0X0004 0X000A 0X003D 0XC002 0XC003 0XC004 0XC005 0XC007 加密套件名称 TLS_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA256 TLS_ECDH_ECDSA_WITH_RC4_128_SHA TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 上海移远通信技术股份有限公司 7 / 35 0XC008 0XC009 0XC00A 0XC011 0XC012 0XC013 0XC014 0xC00C 0XC00D 0XC00E 0XC00F 0XC023 0xC024 0xC025 0xC026 0XC027 0XC028 0xC029 0XC02A 0XC02F 0XFFFF EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA TLS_ECDHE_RSA_WITH_RC4_128_SHA TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA TLS_ECDH_RSA_WITH_RC4_128_SHA TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA TLS_ECDH_RSA_WITH_AES_128_CBC_SHA TLS_ECDH_RSA_WITH_AES_256_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 支持以上所有加密套件 上海移远通信技术股份有限公司 8 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 1.2. SSL 功能使用流程 步骤 1: 步骤 2: 步骤 3: 步骤 4: 步骤 5: 步骤 6: 步骤 7: 通过 AT+QICSGP 配置 PDP 上下文的、、和其他参数。详细信 息可参考《Quectel_LTE_Standard_TCP(IP)_应用指导》。 通过 AT+QIACT 激活 PDP 上下文。成功激活上下文后，可通过 AT+QIACT?查询分配的 IP 地址。 详细信息可参考《Quectel_LTE_Standard_TCP(IP)_应用指导》。 通过 AT+QSSLCFG 配置指定 SSL 上下文的 SSL 版本、加密套件、受信任 CA 证书路径、身份验 证模式、客户端证书路径、客户端秘钥路径等 SSL 配置。 通过 AT+QSSLOPEN 打开 SSL socket 连接远程服务器。 SSL 连接成功建立后，将通过该连接发送/接收数据。每个模式下数据的收发，可参考第 1.3 章。 通过 AT+QSSLCLOSE 关闭 SSL 连接。 通 过 AT+QIDEACT 去 激 活 PDP 上 下 文 。 详 细 信 息 可 参 考 《Quectel_LTE_Standard_TCP(IP)_应用指导》。 1.3. 数据访问模式说明 SSL 连接支持以下 3 种数据访问模式：  缓存模式  直吐模式  透传模式 当使用 AT+QSSLOPEN 打开 SSL 连接时，可以通过来指定数据访问模式；SSL 连 接成功创建后，可以通过 AT+QISWTMD 切换数据访问模式。关于 AT+QISWTMD 的详细信息，可参考 《Quectel_LTE_Standard_TCP(IP)_应用指导》。 1. 缓存模式下，可以通过 AT+QSSLSEND 发送数据。从网络接收数据时，模块将上报 URC：+QSSLURC: 'recv',，之后用户可以通过 AT+QSSLRECV 来读取缓存数据。 2. 直吐模式下，可以通过 AT+QSSLSEND 发送数据。从网络接收数据时，数据会以如下格式直接输出到 UART1/USB modem/USB AT 口上：+QSSLURC: 'recv',,。 3. 透传模式下，相应串口会进入独占模式，从网络接收到的数据会从 COM 口直接输出。+++或者 DTR（需 先执行 AT&D1）可用于退出透传模式。若服务器异常断开 SSL 连接，将上报结果码 NO CARRIER。 关 于 AT&D 的 详 细 信 息 ， 可 参 考 《Quectel_EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual》。 上海移远通信技术股份有限公司 9 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导  退出透传模式 用户可以通过+++或者 DTR（需先执行 AT&D1）两种方式退出透传模式，为了防止+++被当成数据发 送，实际操作时必须遵循以下步骤： 1） +++输入前 1 秒或更长时间内不能输入其它任何数据； 2） 必须在 1 秒内输入+++，并且不能输入其它任何数据； 3） +++输入后 1 秒内不能输入其它任何数据； 4） 通过+++或者 DTR（需先执行 AT&D1）方式使模块退出透传模式，直到模块返回 OK。  切换到透传模式 1） 通过执行 AT+QISWTMD：执行命令时，指定为 2，返回 CONNECT，表示成功 切换到透传模式。 2） 通过执行 ATO：若连接访问模式是最近从透传模式中切换过来的，则 ATO 可以用来切换回透传模 式。返回 CONNECT，表示成功切换到透传模式；若连接访问模式之前没有进入过透传模式，那么 执 行 ATO 会 返 回 NO CARRIER 。 关 于 ATO 的 详 细 信 息 ， 可 参 考 《Quectel_EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual》。 1.4. 证书有效性验证 检查证书是否在有效期内，必须对证书进行解析，并将本地时间与证书的'不早于'时间和'不晚于' 时间相比较。如果本地时间早于'不早于'的时间或晚于'不晚于'的时间，则证书将被视为已过期。 若需要进行证书有效性验证（通过 AT+QSSLCFG 设置=0），为避免验证失败，应使 用 AT+CCLK 将 模 块 本 地 时 间 配 置 在 证 书 有 效 期 内 。 关 于 AT+CCLK 的 详 细 信 息 ， 可 参 考 《Quectel_EC2x&EG9x&EG2x-G&EM05_Series_AT_Commands_Manual》。 1.5. 服务器名称指示 客户端期望 SNI（服务器名称指示）提供服务器主机名称信息，以促进与在单个基础网络地址承载多 个'虚拟'服务器的安全连接。该功能仅适用于 TLS 协议。 上海移远通信技术股份有限公司 10 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 2 SSL AT 命令详解 2.1. AT 命令语句 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 4：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 11 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 2.2. SSL 相关 AT 命令描述 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 该命令用于配置 SSL 上下文的 SSL 版本、加密套件、受信任 CA 证书路径、身份验证模式、客户端证 书路径、客户端密钥路径等 SSL 配置。这些参数将在握手过程中使用。 是 SSL 上下文的索引。模块最多支持 6 个 SSL 上下文。可以基于一个 SSL 上下文建立 多个 SSL 连接。SSL 版本和加密套件的设置存储在 SSL 上下文中，并将应用于与该 SSL 上下文关联的新 SSL 连接。 AT+QSSLCFG 配置 SSL 上下文参数 测试命令 AT+QSSLCFG=? 响应 +QSSLCFG: 'sslversion',(支持的范围),(支持 的范围) +QSSLCFG: 'ciphersuite',(支持的范围),(支 持的列表) +QSSLCFG: 'cacert',(支持的范围), +QSSLCFG: 'cacertex',(支持的范围), +QSSLCFG: 'clientcert',(支持的范围), +QSSLCFG: 'clientkey',(支持的范围), +QSSLCFG: 'seclevel',(支持的范围),(支持 的范围) +QSSLCFG: 'ignorelocaltime',(支持的范 围),(支持的范围) +QSSLCFG: 'negotiatetime',(支持的范围), (支持的范围) +QSSLCFG: 'sni',(支持的范围),(支持的列表) +QSSLCFG: 'closetimemode',(支持的范 围),(支持的列表) +QSSLCFG: 'ignoremulticertchainverify',(支持的范围),(支持的列表) +QSSLCFG: 'ignoreinvalidcertsign',(支持的范围),(支持的列表) +QSSLCFG: 'psk',(支持的范围),, +QSSLCFG: 'dtls',(支持的范围),(支持的列表) +QSSLCFG: 'dtlsversion',(支持的范围),(支 持的列表) 上海移远通信技术股份有限公司 12 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 +QSSLCFG: 'session_cache',(支持的范 围),(支持的列表) +QSSLCFG: 'alpn',(支持的范围), +QSSLCFG: 'renegotiation',(支持的范围), (支持的列表) 设置命令 配置指定 SSL 上下文的 SSL 版本： AT+QSSLCFG='sslversion',[,] OK 响应 若省略可选参数，则查询指定 SSL 上下文的 SSL 版本： +QSSLCFG: 'sslversion',, OK 设置命令 配置指定 SSL 上下文的加密套件： AT+QSSLCFG='ciphersuite',[,] 若指定可选参数，则配置指定 SSL 上下文的 SSL 版本： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的加密套件： +QSSLCFG: 'ciphersuite',, OK 设置命令 配置指定 SSL 上下文的受信任 CA 证书路 径： AT+QSSLCFG='cacert',[, ] 若指定可选参数，则配置指定 SSL 指定上下文的加密套件： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的受信任 CA 证书 路径： +QSSLCFG: 'cacert',, OK 若指定可选参数，则配置指定 SSL 上下文的受信任 CA 证书 路径： OK 或者 ERROR 设置命令 响应 配置指定 SSL 上下文的受信任 CA 证书路 若省略全部可选参数，则查询全部 SSL 上下文的受信任 CA 径： 证书路径： AT+QSSLCFG='cacertex'[,<SSL_ctxI +QSSLCFG: 'cacertex',0, 上海移远通信技术股份有限公司 13 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 D>[,]] ….. +QSSLCFG: 'cacertex',5, OK 若只省略，则查询指定 SSL 上下文的受信任 CA 证书路径： +QSSLCFG: 'cacertex',, OK 若指定全部可选参数，则配置指定 SSL 上下文的受信任 CA 证书路径： OK 或者 ERROR 设置命令 响应 配置指定 SSL 上下文的客户端证书路径： 若省略可选参数，则查询指定 SSL 上下文的客户端证书路径： AT+QSSLCFG='clientcert',[,] 'clientcert',, OK 设置命令 配置指定 SSL 上下文的客户端密钥： AT+QSSLCFG='clientkey',[,] 若指定可选参数，则配置指定 SSL 上下文的客户端证书路径： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的客户端密钥： +QSSLCFG: 'clientkey',, OK 设置命令 配置指定 SSL 上下文的身份验证模式： AT+QSSLCFG='seclevel',[,] 若指定可选参数，则配置指定 SSL 上下文的客户端密钥： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的身份验证模式： +QSSLCFG: 'seclevel',, OK 若省略可选参数，则配置指定 SSL 上下文的身份验证模式： 上海移远通信技术股份有限公司 14 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 OK 或者 设置命令 ERROR 响应 配置指定 SSL 上下文是否忽略证书有效性 若省略可选参数，则查询指定 SSL 上下文是否忽略证书有效 验证： 性验证： AT+QSSLCFG='ignorelocaltime',<SS +QSSLCFG: 'ignorelocaltime',,[,] me> OK 若指定可选参数，则配置指定 SSL 上下文是否忽略证书有效 性验证： OK 或者 设置命令 ERROR 响应 配置指定 SSL 上下文在 SSL 协商阶段的最 若省略可选参数，则查询指定 SSL 上下文在 SSL 协商阶段的 大超时时间： 最大超时时间： AT+QSSLCFG='negotiatetime',<SSL_ +QSSLCFG: 'negotiatetime',,[,] me> OK 若指定可选参数，则配置指定 SSL 上下文在 SSL 协商阶段的 最大超时时间： OK 或者 设置命令 ERROR 响应 打开/关闭指定 SSL 上下文的服务器名称 若省略可选参数，则查询指定 SSL 上下文是否打开服务器名 指示功能： 称指示功能： AT+QSSLCFG='sni',[,<S +QSSLCFG: 'sni',, NI>] OK 设置命令 打开/关闭指定 SSL 上下文的 SSL 关闭延 迟时间： 若指定可选参数，则打开/关闭指定 SSL 上下文的服务器名称 指示功能： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文是否开启 SSL 关闭 延迟时间： 上海移远通信技术股份有限公司 15 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 AT+QSSLCFG='closetimemode',<SSL +QSSLCFG: 'closetimemode',,[,] e_mode> OK 若指定可选参数，则打开/关闭指定 SSL 上下文的 SSL 关闭延 迟时间： OK 或者 设置命令 ERROR 响应 配置指定 SSL 上下文是否忽略多级证书链 若省略可选参数，则查询指定 SSL 上下文是否忽略多级证书 验证： 链验证： AT+QSSLCFG='ignoremulticertchainv +QSSLCFG: 'ignoremulticertchainverify',, erify',[,<ignore_multicert chain_verify>] OK 若指定可选参数，则配置指定 SSL 上下文是否忽略多级证书 链验证： OK 或者 ERROR 设置命令 响应 配置指定 SSL 上下文是否忽略无效证书签 若省略可选参数，则查询指定 SSL 上下文是否忽略无效证书 名： 签名： +QSSLCFG='ignoreinvalidcertsign',< +QSSLCFG: 'ignoremulticertchainverify',, SSL_ctxID>[,<ignore_invalid_certsig n>] OK 若省略可选参数，则配置指定 SSL 上下文是否忽略无效证书 签名： OK 或者 设置命令 ERROR 响应 配置指定 SSL 上下文在握手阶段的 PSK： 若省略可选参数，则查询指定 SSL 上下文在握手阶段的 PSK： AT+QSSLCFG='psk',[,<id +QSSLCFG: 'psk',,, entity>,] OK 若指定可选参数，则配置指定 SSL 上下文在握手阶段的 PSK： OK 上海移远通信技术股份有限公司 16 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 或者 ERROR 设置命令 响应 打开/关闭指定 SSL 上下文的 DTLS 功能： 若省略可选参数，则查询指定 SSL 上下文是否打开 DTLS 功 AT+QSSLCFG='dtls',[, +QSSLCFG: 'dtls',, OK 设置命令 配置指定 SSL 上下文的 DTLS 版本： AT+QSSLCFG='dtlsversion',[,] 若指定可选参数，则打开/关闭指定 SSL 上下文的 DTLS 功能： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的 DTLS 版本： +QSSLCFG: 'dtlsversion',, OK 设置命令 打开/关闭指定 SSL 上下文的会话恢复功 能： AT+QSSLCFG='session_cache',[,] 若指定可选参数，则配置指定 SSL 上下文的 DTLS 版本： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文是否打开会话恢复 功能： +QSSLCFG: 'session_cache',, OK 设置命令 配置指定 SSL 上下文的 ALPN 信息： AT+QSSLCFG='alpn',[,< ALPN_name>] 若指定可选参数，则打开/关闭指定 SSL 上下文的会话恢复功 能： OK 或者 ERROR 响应 若省略可选参数，则查询指定 SSL 上下文的 ALPN 信息： +QSSLCFG: 'alpn',, OK 若指定可选参数，则配置指定 SSL 上下文的 ALPN 信息： OK 或者 上海移远通信技术股份有限公司 17 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 设置命令 ERROR 响应 打开/关闭指定 SSL 上下文的 TLS 重新协 若省略可选参数，则查询指定 SSL 上下文是否打开 TLS 重新 商功能： 协商功能： AT+QSSLCFG='renegotiation',<SSL_ +QSSLCFG: 'renegotiation,[,] _enable> OK 最大响应时间 特性说明 若指定可选参数，则打开/关闭指定 SSL 上下文的 TLS 重新协 商功能： OK 或者 ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。SSL 上下文标识符。范围：0~5。 整型。SSL 版本。 0 SSL3.0 1 TLS1.0 2 TLS1.1 3 TLS1.2 4 全部 十六进制数值。SSL 加密套件。 0X0035 TLS_RSA_WITH_AES_256_CBC_SHA 0X002F TLS_RSA_WITH_AES_128_CBC_SHA 0X0005 TLS_RSA_WITH_RC4_128_SHA 0X0004 TLS_RSA_WITH_RC4_128_MD5 0X000A TLS_RSA_WITH_3DES_EDE_CBC_SHA 0X003D TLS_RSA_WITH_AES_256_CBC_SHA256 0XC002 TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0XC003 TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0XC004 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0XC005 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0XC007 TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0XC008 TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0XC009 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0XC00A TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0XC011 TLS_ECDHE_RSA_WITH_RC4_128_SHA 上海移远通信技术股份有限公司 18 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 0XC012 TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0XC013 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0XC014 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC00C TLS_ECDH_RSA_WITH_RC4_128_SHA 0XC00D TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0XC00E TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0XC00F TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0XC023 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC024 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC025 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC026 TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0XC027 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0XC028 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC029 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0XC02A TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0XC02F TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0XFFFF 支持所有加密套件 整型。如何处理过期证书。 0 不忽略证书有效性验证 1 忽略证书有效性验验证 字符串类型。受信任 CA 证书路径。 字符串类型。客户端证书路径。 字符串类型。客户端密钥路径。 字符串类型。身份验证模式。 0 无身份验证模式 1 进行服务器身份验证 2 如果远程服务器要求，则进行服务器和客户端身份验证 整型。表示 SSL 协商阶段的最大超时时间。范围：10~300。默认值：300。单位： 秒。 整型。打开/关闭服务器名称指示功能。 0 关闭 1 打开 整型。打开/关闭 SSL 关闭延迟时间。 0 关闭，此时 SSL 关闭延迟时间的单位为秒 1 打开，此时 SSL 关闭延迟时间的单位为毫秒 整型。表示是否忽略多级证书链验证。 0 不忽略 1 忽略 整型。表示是否忽略无效证书签名。 0 不忽略 1 忽略 字符串类型。PSK 标识符。长度：0~255 字符串类型。PSK 密钥。长度：0~255 整型。打开/关闭 DTLS 功能。 上海移远通信技术股份有限公司 19 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 0 关闭 1 打开 整型。表示 DTLS 版本。该参数仅在=1 时有效。 0 DTLSv1 1 DTLSv1.2 整型。打开/关闭 SSL 会话恢复功能。 0 关闭 1 打开 字符串类型。ALPN（Application Layer Protocol Negotiation）表示应用层协议协商。 该参数用于配置 TLS 拓展 ALPN 协议名称，且当该参数内容为空时（仅指定双引号）， TLS 不携带 ALPN 拓展内容。 整型。打开/关闭 TLS 重新协商功能。 0 关闭 1 打开 2.2.2. AT+QSSLOPEN 打开 SSL Socket 连接远程服务器 该命令用于建立 SSL 连接，即打开 SSL socket 连接远程服务器。在模块和网络协商期间， AT+QSSLCFG 将用于握手过程中的参数配置。与网络成功握手后，模块可以通过此 SSL 连接发送或接收 数据，还可以基于一个 SSL 上下文建立多个 SSL 连接。 根据第 1.2 章中提到的步骤，在执行 AT+QSSLOPEN 之前，应先执行 AT+QIACT 以激活 PDP 上下文。 等待指定的时间（可参考下面的最大响应时间）后将输出 URC +QSSLOPEN: ,。如 果在此期间无法接收到 URC 响应，则可以使用 AT+QSSLCLOSE 关闭 SSL 连接。 AT+QSSLOPEN 打开 SSL Socket 连接远程服务器 测试命令 AT+QSSLOPEN=? 响应 +QSSLOPEN: (支持的范围),(支持的范围),(支持的范围),,[,(支持的范围)] 设置命令 AT+QSSLOPEN=,,,,[,] OK 响应 若=2 并且成功建立 SSL 连接： CONNECT 若有任何错误： ERROR 错误描述可通过 AT+QIGETERROR 获取 若=0/1： OK 上海移远通信技术股份有限公司 20 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 最大响应时间 特性说明 +QSSLOPEN: , 当=0，表示成功打开 SSL socket；否则，表示打开 SSL socket 失败： 若有任何错误： ERROR 错误描述可通过 AT+QIGETERROR 获取 最大网络响应时间为 150 秒，需再加上配置 的时间 该命令立即生效； 参数配置不保存。 参数 整型。PDP 上下文标识符。范围：1~16。 整型。SSL 上下文标识符。范围：0~5。 整型。Socket 索引。范围：0~11。 字符串类型。远程服务器地址。 整型。远程服务器监听端口。 整型。表示 SSL 连接的数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 整型。操作错误码。详细信息可参考第 5 章。 整型。表示 SSL 协商阶段的最大超时时间。范围：10~300。默认值：300。单位： 秒。 2.2.3. AT+QSSLSEND 通过 SSL 连接发送数据 建立 SSL 连接后，模块可以通过该连接发送数据。 AT+QSSLSEND 通过 SSL 连接发送数据 测试命令 AT+QSSLSEND=? 响应 +QSSLSEND: (支持的范围)[,(支持的范 围)] 设置命令 发送不定长数据 AT+QSSLSEND= OK 响应 > 响应>后，输入要发送的数据。点击 CTRL+Z 发送，点击 ESC 取消操作。 上海移远通信技术股份有限公司 21 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 若已建立 SSL 连接且数据发送成功： SEND OK 若已建立 SSL 连接但缓存已满： SEND FAIL 设置命令 发送定长数据 AT+QSSLSEND=, 若 SSL 连接未建立、异常断开或参数错误： ERROR 响应 > 响应>后，输入要发送的数据，直至数据长度达到配 置的长度. 若已建立 SSL 连接且数据发送成功： SEND OK 若已建立 SSL 连接但缓存已满： SEND FAIL 最大响应时间 特性说明 若 SSL 连接未建立、异常断开或参数错误： ERROR 300 毫秒 该命令立即生效 参数 整型。Socket 索引。范围：0~11。 整型。发送数据的长度。范围：1~1460。单位：字节。 备注 发送不定长数据时，数据最大长度为 1460 个字节。 2.2.4. AT+QSSLRECV 通过 SSL 连接接收数据 当 SSL 连接的数据访问模式为缓存模式时，模块收到网络发送的数据时将上报 URC +QSSLURC: 'recv',。可以通过 AT+QSSLRECV 读取缓存的数据。 AT+QSSLRECV 通过 SSL 连接接收数据 测试命令 AT+QSSLRECV=? 响应 +QSSLRECV: (支持的范围),(支持的范 上海移远通信技术股份有限公司 22 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 围) 设置命令 AT+QSSLRECV=, OK 响应 若指定的连接接收到数据： +QSSLRECV: OK 若缓冲区为空： +QSSLRECV: 0 OK 最大响应时间 特性说明 若 SSL 连接未建立、异常断开或参数错误： ERROR 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。Socket 索引。范围：0~11。 整型。需读取数据的最大长度。范围：1~1500。单位：字节。 整型。通过 AT+QSSLRECV 读取数据的实际长度。单位：字节。 实际读取的数据。单位：字节。 2.2.5. AT+QSSLCLOSE 关闭 SSL 连接 该命令用于关闭 SSL 连接。如果基于同一 SSL 上下文的所有 SSL 连接都已关闭，则模块将释放 SSL 上下文。 AT+QSSLCLOSE 关闭 SSL 连接 测试命令 AT+QSSLCLOSE=? 响应 +QSSLCLOSE: (支持的范围),(支持的范围) 设置命令 AT+QSSLCLOSE=[,] OK 响应 如果 SSL 连接成功关闭： OK 上海移远通信技术股份有限公司 23 / 35 最大响应时间 特性说明 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 若发生任何错误： ERROR 取决于配置的时间 该命令立即生效； 参数配置不保存。 Parameter 整型。Socket 索引。范围：0~11。 整型。AT+QSSLCLOSE 执行的超时时间。范围：0~65535。默认值：10。0 表示 立 即 关 闭 执 行 该 命 令 。 的 单 位 取 决 于 AT+QSSLCFG='closetimemode' 的 配 置 ， 若 =0 ， 则 的单位为秒；若=1，则的单 位为毫秒。 2.2.6. AT+QSSLSTATE 查询 Socket 连接状态 该命令用于查询 Socket 连接状态，且仅能查询 SSL 连接状态。 AT+QSSLSTATE 查询 Socket 连接状态 测试命令 响应 AT+QSSLSTATE=? 设置命令 OK 响应 AT+QSSLSTATE= +QSSLSTATE: ,'SSLClient',,,,,,,,, 执行命令 AT+QSSLSTATE OK 响应 (+QSSLSTATE: ,'SSLClient',,,,,,,,,)的列表 最大响应时间 特性说明 OK 300 毫秒 / 参数 整型。Socket 索引。范围：0~11。 字符串类型。远程服务器地址。 上海移远通信技术股份有限公司 24 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 整型。远程服务器端口。范围：0~65535。 整型。本地端口。范围：0~65535。 整型。SSL 连接状态。 0 'Initial' 连接尚未建立 1 'Opening' 客户端正在连接 2 'Connected' 客户端连接已建立 4 'Closing' 连接正在关闭 整型。PDP 上下文标识符。范围：1~16。 整型。此参数为预留参数。 整型。表示 SSL 连接的数据访问模式。 0 缓存模式 1 直吐模式 2 透传模式 整型。COM 端口。 整型。SSL 上下文标识符。范围：0~5。 2.3. URC 详解 2.3.1. +QSSLURC: 'recv' 通知主机接收数据 该 URC 用于通知主机读取从对端接收的数据。 +QSSLURC: 'recv' 通知主机接收数据 +QSSLURC: 'recv', 缓 存 下 接 收 数 据 时 上 报 的 URC 。 SSL 数 据 可 通 过 AT+QSSLRECV 接收。 +QSSLURC: 'recv',, 参数 整型。Socket 索引。范围：0~11。 整型。实际接收的数据长度。 需读取的数据。 2.3.2. +QSSLURC: 'closed' 通知异常断开连接 该 URC 用于通知主机连接已断开。断开连接可能由多种原因引起，例如网络关闭连接或 GPRS PDP 被去激活，指定 socket 的 SSL 连接状态可能为'closing'，此时需执行 AT+QSSLCLOSE=将 SSL 连接状态改为'initial'。 上海移远通信技术股份有限公司 25 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 +QSSLURC: 'closed' 通知异常断开连接 +QSSLURC: 'closed', 基于指定 Socket 的 SSL 连接已关闭。 参数 整型。Socket 标识符。范围：0~11。 上海移远通信技术股份有限公司 26 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 3 举例 3.1. 配置并激活 PDP 上下文 3.1.1. 配置 PDP 上下文 AT+QICSGP=1,1,'UNINET','','',1 OK //配置上下文为 1。'UNINET'表示中国联通。 3.1.2. 激活 PDP 上下文 AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK //激活上下文为 1。 //激活成功。 //查询上下文状态。 3.1.3. 去激活 PDP 上下文 AT+QIDEACT=1 OK //去激活上下文 1。 //去激活成功。 3.2. 配置 SSL 上下文 AT+QSSLCFG='sslversion',1,1 OK AT+QSSLCFG='ciphersuite',1,0X0035 OK AT+QSSLCFG='seclevel',1,1 OK //设置 SSL 上下文标识符和 SSL 版本为 1。 //设置 SSL 上下文标识符为 1，SSL 加密套件为 TLS_RSA_WITH_AES_256_CBC_SHA。 //设置 SSL 上下文标识符为 1，身份验证模式为进行服务器 身份验证。 上海移远通信技术股份有限公司 27 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 AT+QSSLCFG='cacert',1,'RAM:cacert.pem' //设置 SSL 上下文标识符为 1，收信任 CA 证书路径为 RAM:cacert.pem。 OK 3.3. SSL 客户端在缓存模式下工作 3.3.1. 建立 SSL 连接并进入缓存模式 AT+QSSLOPEN=1,1,4,'220.180.239.212',8010,0 OK +QSSLOPEN: 4,0 AT+QSSLSTATE //成功建立 SSL 连接。 //查询所有 SSL 连接的状态。 +QSSLSTATE: 4,'SSLClient','220.180.239.212',8010,65344,2,1,4,0,'usbmodem',1 OK 3.3.2. 缓存模式下发送数据 3.3.2.1. 发送不定长数据 AT+QSSLSEND=4 > Test data from SSL SEND OK //发送定不定长数据。 3.3.2.2. 发送定长数据 AT+QSSLSEND=4,18 > Test data from SSL SEND OK 3.3.3. 缓存模式下接收数据 +QSSLURC: 'recv',4 AT+QSSLRECV=4,1500 +QSSLRECV: 18 上海移远通信技术股份有限公司 //发送定长数据且数据长度为 18 个字节。 //Socket 4（=4）接收到数据。 //读取数据。需读取数据的长度为 1500 个字节。 //实际接收数据长度为18个字节。 28 / 35 Test data from SSL OK AT+QSSLRECV=4,1500 +QSSLRECV: 0 OK EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 //缓存中无数据。 3.3.4. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK //关闭 SSL 连接（=4）。取决于网络，最大响应时间 为 10 秒。 3.4. SSL 客户端在直吐模式下工作 3.4.1. 建立 SSL 连接并进入直吐模式 AT+QSSLOPEN=1,1,4,'220.180.239.212',8011,1 OK +QSSLOPEN: 4,0 AT+QSSLSTATE //成功建立 SSL 连接。 //查询所有 SSL 连接的状态。 +QSSLSTATE: 4,'SSLClient','220.180.239.212',8011,65047,2,1,4,1,'usbmodem',1 OK 3.4.2. 直吐模式下发送数据 AT+QSSLSEND=4 > Test data from SSL SEND OK AT+QSSLSEND=4,18 > Test data from SSL SEND OK //发送不定长数据。 //发送数据且数据长度为 18 个字节。 上海移远通信技术股份有限公司 29 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 3.4.3. 直吐模式下接收数据 +QSSLURC: 'recv',4,18 Test data from SSL 3.4.4. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK //关闭 SSL 连接（=4）。取决于网络，最大响应时间 为 10 秒。 3.5. SSL 客户在透传模式下工作 3.5.1. 建立 SSL 连接并在透传模式下发送数据 AT+QSSLOPEN=1,1,4,'220.180.239.212',8011,2 //建立 SSL 连接。 CONNECT //进入透传模式。 //客户端直接通过 COM 端口向网络发送数据。（该举例中数据不可见） OK //+++或者 DTR（需先执行 AT&D1）可用于退出透传模式。若服务器异 常断开 SSL 连接，将上报结果码 NO CARRIER。 3.5.2. 建立 SSL 连接并在透传模式下接收数据 AT+QSSLOPEN=1,1,4,'220.180.239.212',8011,2 //建立 SSL 连接。 CONNECT //客户端正在读取数据。 OK //通过+++或者 DTR（需先执行 AT&D1）退出透传模式。若服务器断开 SSL 连接，将上报结果码 NO CARRIER。 3.5.3. 关闭 SSL 连接 AT+QSSLCLOSE=4 OK //关闭 SSL 连接（=4）。取决于网络，最大响应时间为 10 秒。 上海移远通信技术股份有限公司 30 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 4 错误处理 4.1. 打开 SSL 连接失败 若打开 SSL 连接失败，请对以下方面进行排查。 1. 通过 AT+QIACT?查询指定 PDP 上下文的状态，检查指定 PDP 上下文是否已被激活。 2. 由于无效的 DNS 服务器无法将域名转换为 IP 地址，若远程服务器地址为域名，还请通过 AT+QIDNSCFG=检查 DNS 服务器地址是否有效。 3. 通过 AT+QSSLCFG 检查 SSL 配置，尤其是 SSL 版本及加密套件以确保在服务器端受支持。若 =1/2，则需通过 AT+QFUPL 上传受信任 CA 证书。若服务器配置了'SSLVerifyClient required'，则需通过 AT+QFUPL 上传客户端证书和客户端密钥。关于证书有效性验证的更多细节， 请参考第 4 章。关于 AT+QFUPL 的详细信息，可参考《Quectel_LTE_Standard_FILE_应用指导》 上海移远通信技术股份有限公司 31 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 5 错误代码 如果在执行 SSL 相关 AT 命令后返回 ERROR，可以通过 AT+QIGETERROR 查询错误的详细信息。 请注意，AT+QIGETERROR 仅返回最后一个 SSL 命令的错误代码。 表 5：错误代码 0 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 错误代码 Operation successful Unknown error Operation blocked Invalid parameter Memory not enough Create socket failed Operation not supported Socket bind failed Socket listen failed Socket write failed Socket read failed Socket accept failed Open PDP context failed Close PDP context failed Socket identity has been used DNS busy DNS parse failed 释义 操作成功 未知错误 操作被阻止 无效参数 内存不足 创建Socket失败 不支持该操作 Socket绑定失败 Socket监听失败 Socket写入失败 Socket读取失败 Socket接受失败 打开PDP上下文失败 关闭PDP上下文失败 Socket标识已被使用 DNS业务繁忙 DNS解析失败 上海移远通信技术股份有限公司 32 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 566 Socket connection failed Socket连接失败 567 Socket has been closed Socket已关闭 568 Operation busy 操作繁忙 569 Operation timeout 操作超时 570 PDP context break down PDP上下文崩溃 571 Cancel send 取消发送 572 Operation not allowed 不允许操作 573 APN not configured 未配置APN 574 Port busy 端口繁忙 上海移远通信技术股份有限公司 33 / 35 EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 6 附录 A 参考文档和术语缩写 表 6：参考文档 序号 文档名称 说明 [1] RFC 2246-The TLS Protocol Version 1.0 [2] GSM 07.07 传输层安全性（TLS）协议。该协议提供了网络 的通信隐私 数字蜂窝通信（第 2+阶段）GSM 移动设备（ME） AT 命令手册 [3] GSM 07.10 支持 GSM 07.10 复用协议 [4] Quectel_LTE_Standard_TCP(IP)_应用指导 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列的 TCP/IP 应用指导 [5] Quectel_LTE_Standard_FILE_应用指导 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 系列的 FILE 应用指导 Quectel_EC2x&EG9x&EG2x-G&EM05_Series 适用于 EC2x 系列、EG9x 系列、EG2x-G 和 EM05 [6] _AT_Commands_Manual 系列的 AT 命令手册 表 7：术语缩写 缩写 ALPN APN CA DNS DTR DTLS PDP SNI SSL 英文全称 Application Layer Protocol Negotiation Access Point Name Certificate Authority Domain Name Server Data Terminal Ready Datagram Transport Layer Security Packet Data Protocol Server Name Indication Security Socket Layer 中文全称 应用层协议协商 接入点名称 证书授权 域名服务器 数据终端就绪 数据包传输层安全协议 分组数据协议 服务器名称指示 安全套接层协议 上海移远通信技术股份有限公司 34 / 35 TCP/IP TLS UART URC USB EC2x&EG9x&EG2x-G&EM05 系列 SSL 应用指导 Transmission Control Protocol/Internet Protocol Transport Layer Security Universal Asynchronous Receiver/Transmitter Unsolicited Result Code Universal Serial Bus 传输控制协议/网际协议 安全传输层协议 通用异步收发机 非请求结果码 通用串行总线 上海移远通信技术股份有限公司 35 / 35

GSM MQTT 应用指导 GSM/GPRS/GNSS 模块系列 版本：GSM_MQTT_应用指导_V1.0 日期：2020-04-26 状态：受控文件 www.quectel.com GSM MQTT 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 28 文档历史 修订记录 版本 1.0 日期 2020-04-26 作者 顾根全/ 赵德胜/ 叶珊珊/ 李家杨 变更表述 初始版本 GSM MQTT 应用指导 上海移远通信技术股份有限公司 2 / 28 GSM MQTT 应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 1.1. 适用模块 ..................................................................................................................................... 5 2 MQTT 数据交互..................................................................................................................................... 6 3 MQTT 相关 AT 命令 .............................................................................................................................. 7 3.1. AT 命令语法................................................................................................................................ 7 3.1.1. 定义 ................................................................................................................................. 7 3.1.2. AT 命令语句..................................................................................................................... 7 3.2. MQTT 相关 AT 命令描述 ............................................................................................................ 8 3.2.1. AT+QMTCFG 配置 MQTT 可选参数............................................................................. 8 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 .................................................................... 12 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 .................................................................. 13 3.2.4. AT+QMTCONN 连接客户端到 MQTT 服务器............................................................. 13 3.2.5. AT+QMTDISC 断开客户端与 MQTT 服务器的连接.................................................... 15 3.2.6. AT+QMTSUB 订阅主题 .............................................................................................. 16 3.2.7. AT+QMTUNS 退订主题 .............................................................................................. 17 3.2.8. AT+QMTPUB 发布消息 .............................................................................................. 18 4 MQTT 相关 URC ................................................................................................................................. 20 4.1. +QMTSTAT 指示 MQTT 链路层状态变化 .............................................................................. 20 4.2. +QMTRECV 通知 Host 读取 MQTT 包数据........................................................................... 21 5 举例 ..................................................................................................................................................... 22 5.1. 非 SSL 模式的 MQTT 操作....................................................................................................... 22 5.2. SSL 模式的 MQTT 操作 ........................................................................................................... 24 6 附录 A 参考文档和术语缩写................................................................................................................ 27 7 附录 B 错误码一览表........................................................................................................................... 28 上海移远通信技术股份有限公司 3 / 28 GSM MQTT 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 5 表 2：AT 命令及响应类型............................................................................................................................. 7 表 3：MQTT 相关的 URC........................................................................................................................... 20 表 4：URC 中的错误码 .............................................................................................................................. 20 表 5：参考文档 ........................................................................................................................................... 27 表 6：术语缩写 ........................................................................................................................................... 27 表 7：错误码一览表.................................................................................................................................... 28 上海移远通信技术股份有限公司 4 / 28 GSM MQTT 应用指导 1 引言 MQTT 是基于代理的发布/订阅模式通讯协议，特点是开放，简单，轻量和易于实现。MQTT 最大优点 在于，可以以极少的代码和有限的网络带宽，为连接远程设备提供实时可靠的消息服务。 该文档主要介绍如何通过 AT 命令使用 GSM 模块的 MQTT 功能。 1.1. 适用模块 本文档主要适用于以下移远通信模块： 表 1：适用模块 模块系列 Mxx MCxx 模块 M26 M35 M25 M35-R M56-R M08-R MC20 MC30 MC25 上海移远通信技术股份有限公司 5 / 28 GSM MQTT 应用指导 2 MQTT 数据交互 本章主要介绍 MQTT 功能的数据交互机制。 MCU Modem Link layer MQTT Server AT+QMTCFG='WILL',,... AT+QMTCFG='TIMEOUT',,... …... AT+QMTOPEN=,'< host_name>', OK TCP-REQ +QMTOPEN: , TCP established AT+QMTCONN AT+QMTCONN=,'< clientID>',... CONN-REQ OK Start timer +QMTCONN: T1, T2 CONN ACK-IND ,[,] Stop T1 or handle Excep1 TCP SYN TCP SYN+ACK TCP ACK Send connect packet Receive connect ACK packet AT+QMTSUB AT+QMTSUB=,,... SUB-REQ () OK Start timer T1 +QMTSUB: SUB ACK-IND () ,, Stop T1 or handle Excep2 AT+QMTUNS AT+QMTUNS=,,... UNS-REQ () OK Start timer T1 +QMTUNS: ,, UNS ACK-IND () Stop T1 or handle Excep2 AT+QMTPUB=,< msgID>,=0,... OK PUB-REQ AT+QMTPUB (qos=1) AT+QMTPUB=,< msgID>,=1,... OK PUB-REQ () Start timer T1 +QMTPUB: PUB ACK-IND () ,, Stop T1 or handle Excep2 AT+QMTPUB (qos=2) AT+QMTPUB=,< msgID>,=2,... OK PUB-REQ () Start timer T1 PUB REC-IND () Stop T1 or handle Excep2 PUB REL-REQ () Start timer T1 +QMTPUB: PUB COMP-IND () ,, Stop T1 or handle Excep2 Send subscribe packet Receive subscribe ACK packet Send unsubscribe packet Receive unsubscribe ACK packet Send publish packet Send publish packet Receive publish ACK packet Send publish packet Receive publish receive packet Send publish release packet Receive publish complete packet T1 is packet transmission timeout. T2 is keep-alive timer. In the absence of a data-related message during the T2 period, the client will send PINGREQ packet. Excep1: disconnect the TCP connection. Excep2: resend packets unless maximum retry times is reached. Retry times is set by AT+QMTCFG. Whether the timeout information is reported can be configured by AT+QMTCFG. Receive PUBLISH message in the form of URC. Receive +QMTRECV: PUB-IND () ,,, PUB ACK/REC-REQ () Reply according to qos . . . AT+QMTDISC= OK +QMTDISC: , DISC-REQ AT+QMTCLOSE= TCP-REQ OK TCP disconnected +QMTCLOSE: , Receive publish packet Send publish reply packet Send disconnect packet TCP disco.n.n.ect request 图 1：MQTT 数据交互机制 上海移远通信技术股份有限公司 6 / 28 GSM MQTT 应用指导 3 MQTT 相关 AT 命令 本章主要介绍与 MQTT 操作的相关 AT 命令。 3.1. AT 命令语法 3.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 3.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应，省略。 表 2：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 7 / 28 GSM MQTT 应用指导 3.2. MQTT 相关 AT 命令描述 3.2.1. AT+QMTCFG 配置 MQTT 可选参数 该命令用于配置 MQTT 参数。 AT+QMTCFG 配置 MQTT 可选参数 测试命令 AT+QMTCFG=? 响应 +QMTCFG: '',(支持的范 围)[,…] 设置命令 配置或查询 Will 信息 AT+QMTCFG='WILL',[,[,,,'','']] OK 响应 若省略、、、' '和''，则查询当前 Will 配置信息： +QMTCFG: [,,,'',''] OK 若指定、、、''和''，则配置 Will 信息： OK 设置命令 配置或查询消息传输超时时间 AT+QMTCFG='TIMEOUT',[,[,[,]]] 若存在与 ME 功能相关的错误： +CME ERROR: 响应 若省略、和， 则查询当前设置的消息传输超时时间： +QMTCFG: ,, OK 若指定、和， 则配置消息传输超时时间： OK 设置命令 配置或查询会话类型 AT+QMTCFG='SESSION',<TCP_con 若存在与 ME 功能相关的错误： +CME ERROR: 响应 若省略，则查询当前会话类型： +QMTCFG: 上海移远通信技术股份有限公司 8 / 28 GSM MQTT 应用指导 nectID>[,] OK 若指定，则配置会话类型： OK 设置命令 配置或查询保活时间 AT+QMTCFG='KEEPALIVE',[,] 若存在与 ME 功能相关的错误： +CME ERROR: 响应 若省略，则查询当前保活时间： +QMTCFG: OK 若指定，则配置保活时间： OK 设置命令 配置 SSL 安全连接 AT+QMTCFG='SSL',[,[,]] 若存在与 ME 功能相关的错误： +CME ERROR: 响应： 若省略，则查询 SSL 信息： +QMTCFG: [,] OK 若指定，则配置 SSL 安全连接： OK 设置命令 配置或查询阿里云设备信息 AT+QMTCFG='ALIAUTH',[,'','',''] 若存在与 ME 功能相关的错误： +CME ERROR: 响应： 若省略''、''和''，则查询设备信息： [+QMTCFG: '','',''] OK 若指定''、''和''，则配置阿里云设备信息： OK 若存在与 ME 功能相关的错误： +CME ERROR: 上海移远通信技术股份有限公司 9 / 28 GSM MQTT 应用指导 设置命令 配置或查询 MQTT 协议版本 AT+QMTCFG='VERSION',[,] 响应 若省略，则查询 MQTT 协议版本： +QMTCFG: OK 若指定，则配置 MQTT 协议版本： OK 最大响应时间 特性说明 若存在与 ME 功能相关的错误： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 字符串型。配置类型。可为以下任一类型： WILL TIMEOUT SESSION KEEPALIVE SSL ALIAUTH VERSION 整型。MQTT socket 标识符。范围：0~5。 MQTT 可选参数的配置值。 整型。配置 Will flag。 0 无需配置 Will flag 1 需要配置 Will flag 整型。发送消息时的 QoS 级别。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。Will 保留标记只适用于 PUBLISH 消息。 0 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者 后，服务器不保留该消息 1 当客户端发布一条 PUBLISH 消息到服务器，且消息成功发送到当前订阅者 后，服务器保留该消息 字符串型。Will 主题名称。 字符串型。当客户端意外断开以后，该参数定义发送到 Will 主题的消息内容，可 为 0 字节。 上海移远通信技术股份有限公司 10 / 28 GSM MQTT 应用指导 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。 整型。数据包传输超时后重发次数。范围：0~10；默认值：3。 整型。传输数据包时是否上报超时消息。 0 不上报 1 上报 整型。配置会话类型。 0 客户端断开连接后，服务器必须存储该客户端的订阅消息 1 服务器必须删除客户端之前保留的任何消息，此时连接状态为 clean 整型。保活时间。范围：0~3600；默认值：120；单位：秒。该参数定义从客户 端接收消息的最大间隔时间，在 1.5 倍的设置时间内，若服务器未从客户端收到 消息，则默认客户端发送了 DISCONNECT 消息，服务器会因此断开客户端连接。 0 表示不断开客户端连接 整型。配置 MQTT SSL 模式。 0 使用正常 TCP 连接 1 使用 SSL TCP 安全连接 整型。SSL 上下文索引号。范围：0~5。 当=0 时，该参数必须省略。 字符串型。阿里云发布的产品密钥。 字符串型。阿里云发布的设备名称。 字符串型。阿里云发布的设备校验凭证。 整型。MQTT 协议版本。 0 MQTT V3.1 1 MQTT V3.1.1 整型。错误码。详情请参考第 7 章。 备注 1. 若参数=1，那么必须指定、、''和''， 否则，以上参数会被省略。 2. 只有当服务器支持保存会话操作时，参数=0 才有效。 3. 若 MQTT 连接配置为 SSL 模式，必须指定参数。用户也需要使用 AT+QSSLCFG 配置 SSL 版本、加密套件、安全等级、CA 证书、客户端证书、客户端密钥以及忽略 RTC 时间，这些配 置都会在 MQTT SSL 握手过程中使用到。 4. 超时时间不要配置过短，以确保消息传输期间不会出现超时现象。 5. AT+QMTCFG='ALIAUTH'仅用于阿里云，若已配置，可以省略 AT+QMTCONN 中的'' 和''。 上海移远通信技术股份有限公司 11 / 28 GSM MQTT 应用指导 3.2.2. AT+QMTOPEN 打开 MQTT 客户端网络 该命令用于为 MQTT 客户端打开网络。 AT+QMTOPEN 测试命令 AT+QMTOPEN=? 打开 MQTT 客户端网络 响应 +QMTOPEN: (支持的范围),'', 查询命令 AT+QMTOPEN? OK 响应 [+QMTOPEN: ,'',] 设置命令 AT+QMTOPEN=,'< host_name>', OK 响应 OK +QMTOPEN: , 最大响应时间 特性说明 若存在与 ME 功能相关的错误： +CME ERROR: 75 秒，受网络状态影响 / 参数 整型。MQTT socket 标识符。范围：0~5。 字符串型。服务器地址，可以是 IP 地址或者域名。最大长度：100 字节。 整型。服务器端口。范围：1~65535。 整型。命令执行结果。 -1 打开网络失败 0 打开网络成功 1 参数错误 2 MQTT 标识符被占用 3 激活 PDP 失败 4 域名解析失败 5 网络断开 整型。错误码。详情请参考第 7 章。 上海移远通信技术股份有限公司 12 / 28 GSM MQTT 应用指导 3.2.3. AT+QMTCLOSE 关闭 MQTT 客户端网络 该命令用于关闭 MQTT 客户端网络。 AT+QMTCLOSE 关闭 MQTT 客户端网络 测试命令 AT+QMTCLOSE=? 响应 +QMTCLOSE: (支持的范围) 设置命令 AT+QMTCLOSE= OK 响应 OK +QMTCLOSE: , 最大响应时间 特性说明 若存在与 ME 功能相关的错误： +CME ERROR: 300 毫秒 / 参数 整型。MQTT socket 标识符。范围：0~5。 整型。命令执行结果。 -1 关闭网络失败 0 关闭网络成功 整型。错误码。详情请参考第 7 章。 3.2.4. AT+QMTCONN 连接客户端到 MQTT 服务器 该命令用于连接客户端到 MQTT 服务器。创建客户端与服务器之间的 TCP/IP socket 连接时，必须使 用 CONNECT 流创建一个协议层会话。 AT+QMTCONN 连接客户端到 MQTT 服务器 测试命令 AT+QMTCONN=? 响应 +QMTCONN: (支持的范围),'' [,''[,'']] 查询命令 AT+QMTCONN? OK 响应 [+QMTCONN: ,] 上海移远通信技术股份有限公司 13 / 28 GSM MQTT 应用指导 OK 设置命令 AT+QMTCONN=,'< clientID>'[,''[,'']] 响应 OK +QMTCONN: ,[,] 最大响应时间 特性说明 若存在与 ME 功能相关的错误： +CME ERROR: × ( + 1) 默认响应时间是 20 秒，实际响应时间受网络状况影响。 / 参数 整型。MQTT socket 标识符。范围：0~5。 字符串型。客户端标识符。 字符串型。客户端用户名。可用来鉴权。 字符串型。客户端用户名对应的密码。可用来鉴权。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。MQTT 连接状态。 1 MQTT 正在初始化 2 MQTT 正在连接 3 MQTT 已经连接成功 4 MQTT 正在断开连接 整型。连接返回码。 0 接受连接 1 拒绝连接：不接受的协议版本 2 拒绝连接：标识符被拒绝 3 拒绝连接：服务器不可用 4 拒绝连接：错误的用户名或密码 5 拒绝连接：未授权 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。 整型。数据包传输超时后重传次数。范围：0~10；默认值：3。 整型。错误码。详情请参考第 7 章。 上海移远通信技术股份有限公司 14 / 28 GSM MQTT 应用指导 备注 若某一个客户端 ID 已经连接服务器端，另一个客户端使用相同 ID 重新连接，服务器必须先断开原来的客 户端连接，而后才能完成新客户端的 CONNECT 流。 3.2.5. AT+QMTDISC 断开客户端与 MQTT 服务器的连接 该命令用于断开客户端与 MQTT 服务器的连接。客户端发送 DISCONNECT 消息到服务器表示即将与 服务器断开 TCP/IP 连接。 AT+QMTDISC 测试命令 AT+QMTDISC=? 断开客户端与 MQTT 服务器连接 响应 +QMTDISC: (支持的范围) 设置命令 AT+QMTDISC= OK 响应 OK +QMTDISC: , 最大响应时间 特性说明 若存在与 ME 功能相关的错误： +CME ERROR: 300 毫秒 / 参数 整型。MQTT socket 标识符。范围：0~5。 整型。命令执行结果。 -1 断开连接失败 0 断开连接成功 整型。错误码。详情请参考第 7 章。 上海移远通信技术股份有限公司 15 / 28 GSM MQTT 应用指导 3.2.6. AT+QMTSUB 订阅主题 该命令用于订阅一个或多个主题。客户端发送 SUBSCRIBE 消息向服务器订阅一个或多个主题，当订 阅主题发布消息时，服务器会把这些消息作为 PUBLISH 消息传输到客户端。 AT+QMTSUB 订阅主题 测试命令 AT+QMTSUB=? 响应 +QMTSUB: (支持的范围),,'',[,'',...] 设置命令 AT+QMTSUB=,< msgID>,'',[,'',…] OK 响应 OK +QMTSUB: ,,[,] 最大响应时间 特性说明 若存在与 ME 功能相关的错误： +CME ERROR: × ( + 1) 默认响应时间是 20 秒，实际响应时间受网络状况影响。 / 参数 整型。MQTT socket 标识符。范围：0~5。 整型。数据包标识符。范围：0~65535。 字符串型。客户端订阅或者退订的主题。 整型。客户端发布消息的 QoS 等级。 0 最多发送一次 1 至少发送一次 2 只发送一次 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。 若=0， 如果服务器接收订阅，则为已确认 QoS 等级的矢量； 如果服务器拒绝订阅，则为 128； 若=1，则表示数据包重传次数； 若=2，则不显示。 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。 上海移远通信技术股份有限公司 16 / 28 GSM MQTT 应用指导 整型。数据包传输超时后重传次数。范围：0~10；默认值：3。 整型。错误码。详情请参考第 7 章。 备注 只有在固定报头中 QoS 位显示 QoS 等级是 1 或者 2 的消息里才显示，特定通信方向的一组飞 行消息中必须唯一。一般来说该参数值根据消息数逐一增加，但实际情况无此要求。 3.2.7. AT+QMTUNS 退订主题 该命令用于退订一个或者多个主题。客户端向服务器发送 UNSUBSCRIBE 消息退订确定的主题。 AT+QMTUNS 退订主题 测试命令 AT+QMTUNS=? 响应 +QMTUNS: (支持的范围),,''[,''...] 设置命令 AT+QMTUNS=,< msgID>,'' [,''…] OK 响应 OK +QMTUNS: ,, 最大响应时间 特性说明 若存在与 ME 功能相关的错误： +CME ERROR: × ( + 1) 默认响应时间是 20 秒，实际响应时间受网络状况影响。 / 参数 整型。MQTT socket 标识符。范围：0~5。 整型。数据包标识符。范围：0~65535。 字符串型。客户端想要订阅或者退订的主题。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK 1 数据包重传 2 数据包发送失败 整型。数据包传输超时时间。范围：1~60；默认值：5；单位：秒。 整型。数据包传输超时后重传次数。范围：0~10；默认值：3。 整型。错误码。详情请参考第 7 章。 上海移远通信技术股份有限公司 17 / 28 GSM MQTT 应用指导 3.2.8. AT+QMTPUB 发布消息 客户端通过该命令发布消息到服务器，再由服务器分配到感兴趣的订阅者。每一个 PUBLISH 消息都关 联一个主题名称，若一个客户端订阅了一个或者多个主题，服务器会把发布到这些主题下的任何消息作为 PUBLISH 消息发送到客户端。 AT+QMTPUB 发布消息 测试命令 AT+QMTPUB=? 响应 +QMTPUB: (支持的范围),,,,'','' 设置命令 发布不定长消息 AT+QMTPUB=,,,,'' OK 响应 > 响应>后，输入待发数据，按 CTRL+Z 发送，按 Esc 取消发送。 OK +QMTPUB: ,,[,] 设置命令 发布定长消息 AT+QMTPUB=,,,,'', 若存在与 ME 功能相关的错误，响应： +CME ERROR: 响应 > 响应>后，输入待发数据，输入长度等于。 OK +QMTPUB: ,,[,] 最大响应时间 特性说明 若存在与 ME 功能相关的错误，响应： +CME ERROR: × ( + 1) 默认响应时间是 20 秒，实际响应时间受网络状况影响。 / 参数 整型。MQTT socket 标识符。范围：0~5。 整型。数据包消息标识符。范围：0~65535。只有当=0 时，该参数值才为 0。 上海移远通信技术股份有限公司 18 / 28 GSM MQTT 应用指导 整型。客户端发送消息的 QoS 等级。 0 最多发送一次 1 最少发送一次 2 只发送一次 整型。消息发送到当前订阅者后，服务器是否保存该消息。 0 不保存 1 保存 字符串型。待发布主题。 字符串型。待发布消息数据。 整型。命令执行结果。 0 数据包发送成功且接收到服务器的 ACK（当=0 时发布了数据，则无需 ACK.） 1 数据包重传 2 数据包发送失败 整型。 若=1，则表示数据包重传次数； 若=0 或者 2，则不显示此参数。 整型。指定的数据长度。范围：1~1548。 整型。数据传输超时时间。范围：1~60；默认值：5；单位：秒。 整型。数据包传输超时后重传次数。范围：0~10；默认值：3。 整型。错误码。详情请参考第 7 章。 备注 1. 若该命令执行成功并响应 OK，客户端可以继续发布新的数据包。传输数据包的最大数量不能大于滑 动窗口的大小（滑动窗口的大小为 5），否则会返回+CME ERROR: 8512。详细信息请参考第 7 章。 2. 该命令执行后，客户端将准备发送数据，该数据将作为有效负载发送。每次输入数据的最大长度为 1548 字节，按 Ctrl+Z 发送数据。 3. 发布者可以发布 PUBLISH 消息到服务器，服务器也可以发布 PUBLISH 消息到订阅者。当服务器发 布消息到订阅者时，会返回 URC +QMTRECV: ,,, 通知 Host 读取 MQTT 服务器发送的数据，关于 URC 描述的详细信息，请参考第 4.2 章。 上海移远通信技术股份有限公司 19 / 28 GSM MQTT 应用指导 4 MQTT 相关 URC 本章主要描述 MQTT 相关的 URC。 表 3：MQTT 相关的 URC 序号 URC 通知 描述 当 MQTT 链路层状态改变，客户端会断开 MQTT [1] +QMTSTAT: , 连接并上报此 URC。 +QMTRECV: ,,< 当客户端接收到 MQTT 服务器的数据包会上报 [2] topic>, 此 URC。 4.1. +QMTSTAT 指示 MQTT 链路层状态变化 该 URC 以+QMTSTAT: 开头；当 MQTT 链路层状态发生变化时，上报该 URC。 +QMTSTAT: 指示 MQTT 链路层状态变化的 URC +QMTSTAT: , 报该 URC。 参数 整型。MQTT socket 标识符。 整型。错误代码。详细信息请参考下表。 表 4：URC 中的错误码 1 描述 连接被服务器断开或者重置 2 发送 PINGREQ 包超时或者失败 解决方法 执行命令 AT+QMTOPEN 重建 MQTT 连 接 首先去激活 PDP，然后再激活 PDP 并重 建 MQTT 连接。 上海移远通信技术股份有限公司 20 / 28 3 4 5 6 7 8~255 GSM MQTT 应用指导 发送 CONNECT 包超时或者失败 接收 CONNACK 包超时或者失败 客户端向服务器发送 DISCONNECT 包，但 是服务器主动断开 MQTT 连接 因为发送数据包总是失败，客户端主动断开 MQTT 连接 1. 查看输入的用户名和密码是否正确。 2. 确保客户端 ID 未被占用。 3. 重建 MQTT 连接，并尝试再次发送 CONNECT 包到服务器。 1. 查看输入的用户名和密码是否正确。 2. 确保客户端 ID 未被占用。 3. 重建 MQTT 连接，并尝试再次发送 CONNECT 包到服务器。 这是正常流程。 1. 确保数据正确。 2. 可能因为网络拥堵或者其他错误，尝 试重建 MQTT 连接。 链路不工作或者服务器不可用 确保当前链路或者服务器可用。 留作将来使用 4.2. +QMTRECV 通知 Host 读取 MQTT 包数据 此 URC 以+QMTRECV：开头，主要用来通知 Host 读取 MQTT 服务器发送的数据包。 +QMTRECV 通知 Host 读取 MQTT 包数据 +QMTRECV: ,,, 参数 整型。MQTT socket 标识符。 整型。数据包的消息标识符。 字符串型。从 MQTT 服务器接收的主题。 字符串型。主题名称相关的有效负载。 上海移远通信技术股份有限公司 21 / 28 GSM MQTT 应用指导 5 举例 本章节主要提供如何使用 MQTT 命令的实例。 5.1. 非 SSL 模式的 MQTT 操作 //配置阿里云设备信息 AT+QMTCFG='ALIAUTH',0,'oyjtmPl5a5j','MQTT_TEST','wN9Y6pZSIIy7Exa5qVzcmigEGO4kAaz Z' OK AT+QMTOPEN=? +QMTOPEN: (0-5), '', OK //MQTT 客户端打开网络 AT+QMTOPEN=0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 OK +QMTOPEN: 0,0 AT+QMTOPEN? +QMTOPEN: 0,'iot-as-mqtt.cn-shanghai.aliyuncs.com',1883 //MQTT 客户端网络成功打开 OK AT+QMTCONN=? +QMTCONN: (0-5), '' [,''[,'']] OK //客户端连接 MQTT 服务器 // 若 已 连 接 阿 里 云 ， 可 使 用 命 令 AT+QMTCFG='ALIAUTH' 提 前 配 置 设 备 信 息 ， 之 后 可 缺 省 参 数 '' 和'' AT+QMTCONN=0,'clientExample' OK +QMTCONN: 0,0,0 //客户端成功连接到 MQTT 服务器 上海移远通信技术股份有限公司 22 / 28 GSM MQTT 应用指导 AT+QMTSUB=? +QMTSUB: (0-5),,'',[,'',...] OK //订阅主题 AT+QMTSUB=0,1,'topic/example',2 OK +QMTSUB: 0,1,0,2 AT+QMTSUB=0,1,'topic/pub',0 OK +QMTSUB: 0,1,0,0 //若客户订阅了其他设备发布到服务器的主题，模块会上报如下信息： +QMTRECV: 0,0, topic/example,This is the payload related to topic //退订主题 AT+QMTUNS=0,2,'topic/example' OK +QMTUNS: 0,2,0 AT+QMTPUB=? +QMTPUB: (0-5),,,,'','' OK //发布消息 AT+QMTPUB=0,0,0,0,'topic/pub' >This is test data, hello MQTT. OK //响应>后，输入并发送 This is test data, hello MQTT. 数据最大长 度是 1548 字节，多出的部分会被忽 略，输入数据后，按 Ctrl+Z 发送数据 +QMTPUB: 0,0,0 //若客户端订阅了名为 topic/pub 的主题，且其他设备向服务器发布了相同主题，模块会上报如下信息： +QMTRECV: 0,0,topic/pub,This is test data, hello MQTT. //断开客户端在 MQTT 服务器的连接 AT+QMTDISC=0 上海移远通信技术股份有限公司 23 / 28 OK +QMTDISC: 0,0 GSM MQTT 应用指导 /连接断开成功 5.2. SSL 模式的 MQTT 操作 //配置 MQTT 会话为 SSL 模式 AT+QMTCFG='SSL',0,1,2 OK //若 SSL 授权方式为 server and client authentication，则存储服务器根 CA 证书到 RAM AT+QSECWRITE='RAM:cacert.pem',1758,100 CONNECT +QSECWRITE: 1758,384a OK //若 SSL 授权方式为 server and client authentication，则存储 CC 证书到 RAM AT+QSECWRITE='RAM:client.pem',1220,100 CONNECT +QSECWRITE: 1220,2d53 OK //若 SSL 授权方式为 server and client authentication，则存储 CK 证书到 RAM AT+QSECWRITE='RAM:user_key.pem',1679,100 CONNECT +QSECWRITE: 1679,335f OK //配置服务器根 CA 证书 AT+QSSLCFG='cacert',2,'RAM:cacert.pem' OK //配置 CC 证书 AT+QSSLCFG='clientcert',2,'RAM:client.pem' OK 上海移远通信技术股份有限公司 24 / 28 GSM MQTT 应用指导 //配置 CK 证书 AT+QSSLCFG='clientkey',2,'RAM:user_key.pem' OK //配置 SSL 参数 AT+QSSLCFG='seclevel',2,2 //SSL 授权方式：server and client authentication OK AT+QSSLCFG='sslversion',2,4 //SSL 授权版本 OK AT+QSSLCFG='ciphersuite',2,'0xFFFF' //加密套件 OK AT+QSSLCFG='ignorertctime',1 //忽略授权时间 OK //开始 MQTT SSL 连接 AT+QMTOPEN=0,'a1zgnxur10j8ux.iot.us-east-1.amazonaws.com',8883 OK +QMTOPEN: 0,0 //连接 MQTT 服务器 AT+QMTCONN=0,'M26_0206' OK +QMTCONN: 0,0,0 //订阅主题 AT+QMTSUB=0,1,'$aws/things/M26_0206/shadow/update/accepted',1 OK +QMTSUB: 0,1,0,1 //发布消息 AT+QMTPUB=0,1,1,0,'$aws/things/M26_0206/shadow/update/accepted' >This is publish data from client OK +QMTPUB: 0,1,0 //若客户端订阅了名为$aws/things/M26_0206/shadow/update/accepted 的主题，其他设备发布了相同主题 的消息到服务器，模块会上报如下信息： +QMTRECV: 0,1,$aws/things/M26_0206/shadow/update/accepted,This is publish data from client //客户端断开 MQTT 服务器 上海移远通信技术股份有限公司 25 / 28 AT+QMTDISC=0 OK +QMTDISC: 0,0 GSM MQTT 应用指导 上海移远通信技术股份有限公司 26 / 28 GSM MQTT 应用指导 6 附录 A 参考文档和术语缩写 表 5：参考文档 序号 [1] 文档名称 MQTT V3.1 Protocol Specification 说明 MQTT 协议规格说明 3.1 版本 表 6：术语缩写 缩写 ACK MQTT QoS RAM SSL TCP URC 英文全称 Acknowledgement Message Queuing Telemetry Transport Quality of Service Random Access Memory Secure Sockets Layer Transmission Control Protocol Unsolicited Result Code 中文全称 确认字符 消息队列遥测传输 服务质量 随机存储器 安全套接层协议 传输控制协议 未经请求的结果码 上海移远通信技术股份有限公司 27 / 28 GSM MQTT 应用指导 7 附录 B 错误码一览表 表示和移动设备或者网络相关的错误，详细信息如下表所示： 表 7：错误码一览表 错误码 8503 8504 8505 8506 8507 8508 8509 8510 8511 8600 8512 英文含义 中文含义 MQTT link error MQTT 连接错误 MQTT illegal packet MQTT 非法数据包 MQTT illegal character MQTT 非法字符 MQTT illegal UTF8 MQTT 非法 UTF8 MQTT invalid parameter MQTT 无效参数 The length of transmitted data exceeds 传输数据长度超出剩余传输缓存空间 the remaining transmission buffer space. MQTT buffer overflow MQTT 缓存溢出 MQTT out of memory MQTT 内存不足 MQTT memory error MQTT 内存错误 MQTT unknown error MQTT 未知错误 MQTT maximum quantity of transmitting MQTT 最大传输数据包数量大于滑动窗 packets exceeds the inflight window size. 口大小 上海移远通信技术股份有限公司 28 / 28

LTE Standard MMS 应用指导 LTE Standard 模块系列 版本：LTE_Standard_MMS_应用指导_V1.0 日期：2020-02-20 状态：受控文件 www.quectel.com LTE_Standard_MM_应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 24 LTE_Standard_MM_应用指导 文档历史 修订记录 版本 1.0 日期 2020-02-20 作者 邓明/ 陶莹莹 变更表述 初始版本 上海移远通信技术股份有限公司 2 / 24 LTE_Standard_MM_应用指导 目录 文档历史 ....................................................................................................................................................... 2 目录 .............................................................................................................................................................. 3 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 1.1. 发送 MMS 消息的过程................................................................................................................ 5 1.2. AT 命令语法 ............................................................................................................................... 6 2 AT 命令详解 .......................................................................................................................................... 7 2.1. AT+QMMSCFG 配置 MMS 的参数 ......................................................................................... 7 2.2. AT+QMMSEDIT 编辑 MMS 消息........................................................................................... 10 2.3. AT+QMMSEND 发送 MMS 消息 ........................................................................................... 12 3 举例 ..................................................................................................................................................... 13 3.1. 添加收件人 ............................................................................................................................... 13 3.2. 添加抄送收件人或密件抄送收件人........................................................................................... 13 3.3. 编辑 MMS 消息标题 ................................................................................................................. 14 3.4. 添加附件 ................................................................................................................................... 14 3.5. 清除 MMS 消息的所有内容 ...................................................................................................... 16 3.6. 发送 MMS 消息......................................................................................................................... 16 4 异常处理 .............................................................................................................................................. 20 4.1. 执行 MMS AT 命令失败............................................................................................................ 20 4.2. PDP 激活失败........................................................................................................................... 20 4.3. AT+QMMSEND 的错误响应..................................................................................................... 20 5 错误代码 .............................................................................................................................................. 21 6 HTTP(s)响应码的描述......................................................................................................................... 23 7 附录 A 参考文档和术语缩写................................................................................................................ 24 上海移远通信技术股份有限公司 3 / 24 LTE_Standard_MM_应用指导 表格索引 表 1：AT 命令类型及其响应......................................................................................................................... 6 表 2：错误代码概览.................................................................................................................................... 21 表 3：错误代码概览.................................................................................................................................... 23 表 4：相关文档 ........................................................................................................................................... 24 表 5：术语及缩写 ....................................................................................................................................... 24 上海移远通信技术股份有限公司 4 / 24 LTE_Standard_MM_应用指导 1 引言 移远通信 LTE Standard 模块提供 MMS 应用程序接口，用于发送包括多媒体对象在内（图像，音频， 富文本等）的消息。本文档为 MMS 定义的所有 AT 命令的应用指导。 本文档适用于以下移远通信 LTE Standard 模块：  EC2x（EC25, EC21, EC20 R2.0 and EC20 R2.1）  EG9x（EG95 和 EG91）  EM05  EG2x（EG25-G 和 EG21-G）  EP200F 1.1. 发送 MMS 消息的过程 步骤一：配置并激活 PDP 上下文。 1） 通过 AT+QICSGP 命令配置、、和 PDP 上下文的其他参数。有 关配置的详细信息，请参阅 Quectel_LTE_Standard_TCP(IP)_应用指导。如果需要更新 QoS 设 置，请通过 AT+CGQMIN、AT+CGEQMIN、AT+CGQREQ 和 AT+CGEQREQ 命令对其进行配 置。有关配置的详细信息，请参阅 Quectel_LTE_Standard_AT_Commands_Manual。 2） 通过 AT+QIACT 命令激活 PDP 场景。 3） 通过 AT+QMMSCFG='contextid',命令配置 MMS 的 PDP 场景 ID。 步骤二：配置 MMSC 的 URL 和代理 1）通过 AT+QMMSCFG='mmsc',命令配置 MMSC 的 URL 2）通过 AT+QMMSCFG='proxy',,命令配置 MMSC 的代理 3）通过 AT+QMMSCFG='sendparam',,,,,命令配置发送 参数。 步骤三：编辑 MMS 消息。 1） 通过 AT+QMMSEDIT=1,1,命令添加收件人的地址。 2） 通过 AT+QMMSEDIT=2,1,命令添加抄送收件人的地址 3） 通过 AT+QMMSEDIT=3,1,命令添加密件抄送件人的地址 4） 通过 AT+QMMSEDIT=4,1,编辑标题，应首先通过 AT+QMMSCFG='character',命令将字符集指定为标题。 5）通过 AT+QMMSEDIT=5,1,命令添加附件。附件可以是 RAM，UFS 或 SD 文件。可以 通过 AT+QFUPL 命令将文件上传到 RAM，UFS 或 SD 卡。成功发送 MMS 消息后，应通过 AT+QFDEL 上海移远通信技术股份有限公司 5 / 24 LTE_Standard_MM_应用指导 命令删除该文件。如果附件是文本文件，则字符集应由 AT+QMMSCFG='character'，指定。 有关更多详细信息，请参阅 Quectel_LTE_Standard_FILE_应用指导。 步骤五：通过 AT+QMMSEND=命令发送 MMS 消息，成功发送 MMS 消息可能需要一些时 间。 在输出 QMMSEND: , [,]前，应再次发送 MMS 消息，表示发送 MMS 消 息的结束。 步骤六：通过 AT+QMMSEDIT=0 清除 MMS 消息的内容，并通过 AT+QFDEL 删除附件。有关更多详 细信息，请参阅 Quectel_LTE_Standard_FILE_应用指导。 可以重复步骤二至步骤五，也可以重复步骤四至步骤五。 1.2. AT 命令语法 表 1：AT 命令类型及其响应 测试命令 查询命令 设置命令 执行命令 AT+=? AT+? AT+= AT+ 返回相应设置命令可设置的参数清单或取值范围。 返回相应设置命令参数的当前设置值。 设置用户可自定义的参数值。 执行无需设置参数值的命令。 上海移远通信技术股份有限公司 6 / 24 LTE_Standard_MM_应用指导 2 AT 命令详解 2.1. AT+QMMSCFG 配置 MMS 的参数 该命令可用于配置 PDP 上下文、MMSC、代理、字符类型等其他 MMS 参数。如果该设置命令仅执行 一个参数，则表示查询当前设置。 AT+QMMSCFG 配置 MMS 的参数 测试命令 AT+QMMSCFG=? 响应 +QMMSCFG: 'contextid',(支持的范 围) +QMMSCFG: 'mmsc', +QMMSCFG: 'proxy',,(支持的 范围) +QMMSCFG: 'character',(支持的列表) +QMMSCFG: 'sendparam'[,( 支 持 的 范 围),(支持的范围),(支持的列表),(支 持的列表),(支持的范围),(支持 的范围)] +QMMSCFG: 'supportfield',( 支 持 的 列 表) +QMMSCFG: 'connecttimeout',(支持的列表) 查询命令 AT+QMMSCFG? 设置命令 AT+QMMSCFG='contextid'[,] OK 响应 OK 响应 如果省略，则查询当前设置： +QMMSCFG: 'contextid', OK 如果未省略，则返回： OK 或者 上海移远通信技术股份有限公司 7 / 24 LTE_Standard_MM_应用指导 设置命令 AT+QMMSCFG='mmsc'[,] +CME ERROR: 响应 如果省略，则查询当前设置： +QMMSCFG: 'mmsc', OK 设置命令 AT+QMMSCFG='proxy'[,,] 如果未省略，则配置 MMSC URL： OK 或者 +CME ERROR: 响应 如果和省略，则查询当前设置： +QMMSCFG: 'proxy',, OK 设置命令 AT+QMMSCFG='character'[,] 如果和未省略，则配置代理网关 和端口： OK 或者 +CME ERROR: 响应 如果省略，则查询当前设置： +QMMSCFG: 'character', OK 设置命令 AT+QMMSCFG='sendparam'[,,,,,,] 如果未省略，则配置字符格式： OK 或者 +CME ERROR: 响应 如果、、、、 和省略，则查询当前设置： +QMMSCFG: 'sendparam',,,,,, OK 如 果 、 、 、 、 和未省略，则配置 sendparam 属 性： 上海移远通信技术股份有限公司 8 / 24 LTE_Standard_MM_应用指导 设置命令 AT+QMMSCFG='supportfield'[,] OK 或者 +CME ERROR: 响应 如果省略，则查询当前设置： +QMMSCFG: 'supportfield', OK 设置命令 AT+QMMSCFG='connecttimeout'[,] 如果未省略，则配置 supportfield 属性： OK 或者 +CME ERROR: 响应 如果< connect_timeout >省略，则查询当前设置： +QMMSCFG:'connecttimeout', OK 特性说明 如果未省略，配置彩信 TCP 握 手的超时时间： OK 或者 +CME ERROR: 该命令立即生效 参数配置不保存 参数 整型。表示 PDP 上下文 ID。范围：1-16；默认值：1。 字符串类型。表示 MMSC 的地址。URL 的最大长度为 100 个字节。 字符串类型。表示 MMS 代理的 IP 地址。网关的最大长度为 50 个字节。 整型。表示 MMS 代理端口。范围：1-65535；默认值：80。 字符串类型。字符集的类型。 'ASCII' US-ASCII 字符集 'UTF8' UTF8 字符集 'UCS2' ISO-10646-UCS-2 字符集，需要指定大端顺序 'GBK' GBK 字符集 整型。MMS 消息的有效期。 0 1 小时 1 12 小时 2 24 小时 上海移远通信技术股份有限公司 9 / 24 LTE_Standard_MM_应用指导 3 2天 4 1周 5 最大 6 取决于网络配置 整型。MMS 消息的优先级 0 低 1 正常 2 高 3 取决于网络配置 整型。是否提供报告。 0 不提供 1 提供 整型。是否读取报告。 0 不读取 1 读取 整型。是否隐藏地址。 0 隐藏任何地址 1 显示所有地址，包括密件抄送地址 2 取决于网络配置 整型。MMS 消息的类别。 0 个人 1 广告 2 信息化 3 自动 4 取决于网络配置 整型。MMS x-up-calling-id 的头选项。 0 不添加 MMS x-up-calling-id 的头选项 1 添加 MMS x-up-calling-id 的头选项 整型。彩信 TCP 握手的超时时间。范围：1-125；默认值：125。单位：秒。 整型。操作的错误代码。请参考第 5 章。 2.2. AT+QMMSEDIT 编辑 MMS 消息 该命令可用于添加收件人地址、编辑标题并添加 MMS 消息的附件。标题或文本文件的字符集由 AT+ QMMSCFG='character',设置。例如，如果文本文件的内容使用 UTF8 字符集，则必须先执行 AT+QMMSCFG='character','UTF8'。 AT+QMMSEDIT 编辑 MMS 消息 测试命令 AT+QMMSEDIT=? 响应 +QMMSEDIT: (支持的范围) (支持的 列表), 上海移远通信技术股份有限公司 10 / 24 LTE_Standard_MM_应用指导 OK 查询命令 AT+QMMSEDIT? 设置命令 AT+QMMSEDIT=[, [,]] 响应 OK 如 果 和 省 略： 当不为 0 时，表示查询的 指定设置： [+QMMSEIDT: ,]列表 OK 或者 +CME ERROR: 当=0 时，删除有关 MMS 消息的所有 内容： OK 或者 +CME ERROR: 如果不省略： 当 =0 时 ， 需 省 略 ，表示删除的指定设置： OK 或者 +CME ERROR: 特性说明 当=1 时，不 可省略，表示设置： OK 或者 +CME ERROR: 该命令立即生效 参数配置不保存 参数 整型。操作功能。 0 删除所有 1 操作 TO 地址 2 操作抄送地址 3 操作密件抄送地址 4 操作标题 5 将文件作为附件操作 整型。使能/关闭功能。 上海移远通信技术股份有限公司 11 / 24 LTE_Standard_MM_应用指导 0 表示删除的指定设置 1 表示设置的指定设置 字符串类型。 如果=1、2 或 3，则为收件人地址。TO 地址、CC 地址和 BCC 地址的最大 数量为 6。地址的最大长度为 50 个字节。 如果=4，则为标题。标题的最大长度为 200 个字节。 如果=5，则为附件的文件名。如果文件名以'RAM'、'UFS'或'SD'开头，则 表示文件分别来自 RAM、UFS 或 SD 卡。强烈建议使用 RAM 中的文件作为附件。文件 名的最大长度为 80 个字节，最大附件数为 12，最大附件大小由操作符限制。 整型。操作的错误代码。请参考第 5 章。 2.3. AT+QMMSEND 发送 MMS 消息 该命令用于发送 MMS 消息。在返回+QMMSEND: ,,之前，客户不得重新 执行 AT+QMMSEND。当达到时，如果 MMS 消息的发送过程尚未完成，则 MMS 发送将被中 断。 AT+QMMSEND 发送 MMS 消息 测试命令 AT+QMMSEND=? 响应 +QMMSEND: (支持的范围) 查询命令 AT+QMMSEND? 设置命令 AT+QMMSEND= OK 响应 OK 响应 OK 特性说明 +QMMSEND: ,[,] 或者 +CME ERROR: 该命令立即生效 参数配置不保存 参数 整型。发送 MMS 消息的最长时间。范围：1-65535；单位：秒。 整型。HTTP(S)的响应码，仅供参考。例如，200 表示 HTTP(S)成功发布数据，有关详 细信息，请参考第 6 章。 字符串类型。MMS 消息发送失败时，来自 MMSC 的响应字符串，仅供参考。 如果 MMS 消息发送成功，则为 0。否则，表示操作的错误码，有关详细信息， 请参考第 5 章。 上海移远通信技术股份有限公司 12 / 24 LTE_Standard_MM_应用指导 3 举例 3.1. 添加收件人 //添加电话号码或电子邮件地址作为收件人。收件人的最大数量为 6。 AT+QMMSEDIT=1,1,'13856122546' //将电话号码添加为收件人。 OK AT+QMMSEDIT=1,1,'recipient .test@quectel.com' OK AT+QMMSEDIT=1 +QMMSEDIT: 1,'13856122546' +QMMSEDIT: 1,'recipient.test@quectel.com' //将电子邮件地址添加为收件人. //查询收件人地址. OK //通过执行 AT+QMMSEDIT=1,0 删除收件人 AT+QMMSEDIT=1,0 OK AT+QMMSEDIT=1 OK //删除收件人 //查询收件人地址 3.2. 添加抄送收件人或密件抄送收件人 //添加 CC 收件人的操作与在值中添加 BCC 收件人操作不同。对于 CC 收件人，值 为 2。对于 BCC 收件人，值为 3。 AT+QMMSEDIT=2,1,'13856122546' //将电话号码添加为抄送收件人 OK AT+QMMSEDIT=2 //查询抄送收件人地址 +QMMSEDIT: 2,'13856122546' OK 通过执行 AT+QMMSEDIT=2,0 删除收件人。 AT+QMMSEDIT=2,0 OK AT+QMMSEDIT=2 //删除抄送收件人 //查询抄送收件人地址 上海移远通信技术股份有限公司 13 / 24 LTE_Standard_MM_应用指导 OK 3.3. 编辑 MMS 消息标题 //标题的字符集由 AT+QMMSCFG='character'，设置。如果为 ASCII，则添加如下 标题： AT+QMMSCFG='character','ASCII' //将字符集设置为'ASCII' OK AT+QMMSEDIT=4,1,'test EM05 mms' //编辑 MMS 消息的标题 OK AT+QMMSEDIT=4 //查询MMS消息的标题 +QMMSEDIT: 4,'ASCII','test EM05 mms' OK //如果不是 ASCII，则输入数据应为十六进制字符串。 AT+QMMSCFG='character', 'UTF8' //将字符集设置为'UTF8'。 OK AT+QMMSEDIT=4,1,'7465737420454D3035206D6D73' //编辑MMS消息标题。 OK '7465737420454D3035206D6D73' 对应UTF8中'test EM05 MMS'的十六进 制字符串。 AT+QMMSEDIT=4 //查询MMS消息的标题。 +QMMSEDIT: 4,'UTF8','7465737420454D3035206D6D73' OK //通过执行 AT+QMMSEDIT=4,0 删除标题 AT+QMMSEDIT=4,0 OK AT+QMMSEDIT=4 //删除 MMS 消息的标题。 //查询MMS消息的标题。 OK 3.4. 添加附件 /客户可以为 MMS 邮件添加附件。附件可以是 RAM、UFS 和 SD 文件，但强烈建议使用 RAM 文件。附件 的最大数为 12，文件名的最大长度为 80 字节。附件的总大小可能会受到运营商的限制。在下面的示例中， 附件是一个 RAM 文本文件： AT+QFUPL='RAM:test_mms.txt',100,200,1 //将文件上传到RAM。该文件将另存为test_mms.txt 文件最大为100字节。200表示超时值，1表示ACK模式 ，有关更多详细信息，请参阅 上海移远通信技术股份有限公司 14 / 24 LTE_Standard_MM_应用指导 CONNECT +QFUPL: 100,0 Quectel_LTE_Standard_FILE_应用指导。 OK AT+QFLST='RAM:*' +QFLST: 'RAM:test_mms.txt',100 //查询RAM的文件列表。 OK AT+QMMSCFG='character','ASCII' OK AT+QMMSEDIT=5,1,'RAM:test_mms.txt' OK AT+QMMSEDIT=5 +QMMSEDIT: 5,'RAM:test_mms.txt' //将 RAM: test_mms.txt 的字符集设置为 ASCII。 //添加 MMS 消息的附件。 //查询附件 OK //在以下示例中，附件是 RAM JPG 文件： AT+QFUPL='RAM:test_pic.jpg',200,300,1 CONNECT +QFUPL: 200,0 //将文件上传到RAM。该文件将另存为test_pic.jpg，文件的 最大大小为200个字节。300表示超时值，1表示ACK模式。 有关更多详细信息，请参阅Quectel_LTE_Standard_ FILE_应用指导。 OK AT+QFLST='RAM:*' +QFLST: 'RAM:test_mms.txt',100 +QFLST: 'RAM:test_pic.jpg',200 //查询RAM的文件列表。 OK AT+QMMSEDIT=5,1,'RAM:test_pic.jpg' OK AT+QMMSEDIT=5 +QMMSEDIT: 5,'RAM:test_mms.txt' +QMMSEDIT: 5,'RAM:test_pic.jpg' //RAM: test_pic.jpg 不是文本文件。无需指定字符集。 //查询附件 OK //通过执行 AT+QMMSEDIT=5,0 删除附件。 AT+QMMSEDIT=5,0 OK AT+QMMSEDIT=5 //删除 MMS 消息的附件。所有附件将被删除。 //查询附件 上海移远通信技术股份有限公司 15 / 24 LTE_Standard_MM_应用指导 OK //成功发送 MMS 消息后，RAM 文件应通过 AT+QFDEL 删除。 AT+QFDEL='RAM:test_mms.txt' //删除 RAM 文件。 OK AT+QFDEL='RAM:test_pic.jpg' //删除 RAM 文件 OK AT+QFLST='RAM:*' //查询RAM的文件列表。 OK 3.5. 清除 MMS 消息的所有内容 //通过 AT+QMMSEDIT=0 删除 MMS 信息的内容、收件人、抄送收件人、密件抄送收件人、标题和附件。. AT+QMMSEDIT=0 //清除 MMS 消息的所有内容。 OK AT+QMMSEDIT=1 //查询收件人 OK AT+QMMSEDIT=2 //查询抄送收件人 OK AT+QMMSEDIT=3 //查询密件抄送收件人 OK AT+QMMSEDIT=4 //查询MMS消息的标题 OK AT+QMMSEDIT=5 //查询附件 OK 3.6. 发送 MMS 消息 //步骤一：配置和激活 PDP 上下文 AT+QICSGP=1,1,'UNIWAP','' ,'',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' OK AT+QMMSCFG='contextid',1 OK 上海移远通信技术股份有限公司 //配置 PDP 上下文 1，中国联通的 APN 为 'UNIWAP'。 //激活 PDP 上下文 1 //激活成功 //查询 PDP 上下文的状态 //将PDP上下文ID设置为1。必须先激活PDP上下文 ID。 16 / 24 LTE_Standard_MM_应用指导 AT+QMMSCFG='contextid' +QMMSCFG: 'contextid',1 //查询PDP上下文ID。 OK //步骤 2：配置 MMSC 的 URL 和代理 AT+QMMSCFG='mmsc','mmsc.myuni.com' OK AT+QMMSCFG='mmsc' +QMMSCFG: 'mmsc','mmsc.myuni.com' //配置 MMSC 的 URL。'mmsc.myuni.com'适用 于中国联通。 //查询MMSC的URL OK AT+QMMSCFG='proxy','10.0.0.172',80 OK AT+QMMSCFG='proxy' +QMMSCFG: 'proxy','10.0.0.172',80 //配置 MMSC 的代理地址和端口。 '10.0.0.172:80'适用于中国联通 //查询 MMSC 的代理地址和端口。 OK //步骤 3：配置发送参数 AT+QMMSCFG='sendparam',6,2,0,0,2,4 OK AT+QMMSCFG='sendparam' +QMMSCFG: 'sendparam',6,2,0,0,2,4 //配置发送参数。 //查询配置参数 OK //步骤 4：编辑 MMS 消息。 AT+QMMSEDIT=1,1,'13856122546' OK AT+QMMSEDIT=2,1,'copy.test@quectel.com' OK AT+QMMSEDIT=3,1,'secret.test@quectel.com' OK AT+QMMSEDIT=1 +QMMSEDIT: 1,'13856122546' //将电话号码添加为收件人。 //添加抄送收件人电子邮件地址。 //添加密件抄送收件人电子邮件地址。 //查询收件人地址 OK AT+QMMSEDIT=2 +QMMSEDIT: 2,'copy.test@quectel.com' //查询抄送收件人地址。 OK AT+QMMSEDIT=3 +QMMSEDIT: 3,'secret.test@quectel.com' //查询密件抄送收件人地址。 上海移远通信技术股份有限公司 17 / 24 LTE_Standard_MM_应用指导 OK AT+QMMSCFG='character','ASCII' OK AT+QMMSEDIT=4,1,'test EM05 mms' OK AT+QMMSEDIT=4 +QMMSEDIT: 4,'ASCII','test EM05 mms' OK //添加附件 AT+QFUPL='RAM:test_ram.txt',100,300,1 CONNECT +QFUPL: 100,0 OK AT+QFLST='RAM:* ' +QFLST: 'RAM:test_ram.txt',100 OK AT+QMMSCFG='character','ASCII' OK AT+QMMSEDIT=5,1,'RAM:test_ram.txt' OK AT+QMMSEDIT=5 +QMMSEDIT: 5,'RAM:test_ram.txt' OK AT+QFUPL='RAM:test_pic.jpg',200,300,1 CONNECT +QFUPL: 200,0 OK AT+QFLST='RAM:*' //将字符类型配置为 ASCII 标题。 //编辑 MMS 消息的标题。 //查询MMS消息的标题。 //将文件上传到RAM。该文件将另存为test_ram.txt， 文件的最大大小为100个字节。300表示超时值，1 表 示 ACK 模 式 。 有 关 更 多 详 细 信 息 ， 请 参 阅 Quectel_LTE_Standard_FILE_应用指导。 //查询RAM的文件列表。 //将 RAM：test_ram.txt 的字符类型配置为 ASCII。 //添加 MMS 消息的附件。test_ram.txt 是一个 RAM 文件。 //查询附件 //将文件上传到RAM。该文件将另存为test_pic.jpg， 文件的最大大小为200个字节。300表示超时值，1 表 示 ACK 模 式 。 有 关 更 多 详 细 信 息 ， 请 参 阅 Quectel_LTE_Standard_应用指导。 上海移远通信技术股份有限公司 18 / 24 +QFLST: 'RAM:test_ram.txt',100 +QFLST: 'RAM:test_pic.jpg',200 OK AT+QMMSEDIT=5,1,'RAM:test_pic.jpg' OK AT+QMMSEDIT=5 +QMMSEDIT: 5,'RAM:test_ram.txt' +QMMSEDIT: 5,'RAM:test_pic.jpg' OK //步骤五：发送MMS消息 AT+QMMSEND=100 OK +QMMSEND: 0,200 //步骤六：清除MMS消息的内容。 AT+QMMSEDIT=0 OK AT+QFDEL='RAM:test_ram.txt' OK AT+QFDEL='RAM:test_pic.jpg' OK LTE_Standard_MM_应用指导 //查询RAM的文件列表。 //RAM: test_pic.jpg 不是文本文件。无需指定字符集。 //查询附件。 //发送 MMS 消息 //表示发送MMS消息的结果。 //清除 MMS 消息的内容 //删除RAM文件 //删除RAM文件 上海移远通信技术股份有限公司 19 / 24 LTE_Standard_MM_应用指导 4 异常处理 4.1. 执行 MMS AT 命令失败 在执行 MMS AT 命令时，如果从模块收到响应 ERROR，请检查是否已插入(U)SIM 卡，并且在执行 AT+CPIN?时是否返回了+CPIN：READY? 4.2. PDP 激活失败 如果通过 AT+QIACT 命令激活 PDP 上下文失败，请检查以下配置： 1. 通过命令 AT+CGATT ?查询是否 PS 域已附着。如果没有，请执行 AT+CGATT=1 附着 PS 域。 2. 通过命令 AT+CGREG?查询 PS 域状态并确保 PS 域已注册。 3. 通过 AT+QICSGP 命令查询 PDP 上下文参数，并确保已设置指定 PDP 上下文的 APN。 4. 确保指定的 PDP 上下文 ID 既不被 PPP 使用，也不被 AT+CGACT 命令激活。 5. 根据 3GPP 规范，模块仅支持同时激活三个 PDP 上下文，因此客户必须确保激活的 PDP 上下文 的数量小于 3。 如果以上所有配置均正确，但是通过 AT+QIACT 命令激活 PDP 上下文仍然失败，请重新启动模块以 解决此问题。重新启动模块后，请检查上述配置至少三次，每次检查间隔为 10 分钟，以避免频繁重启模块。 4.3. AT+QMMSEND 的错误响应 执行 AT+QMMSEND 后将返回+QMMSEND: , [,]。如果不为 0，则 表示 MMS 消息发送失败，请重新发送。如果重新发送仍失败，请通过 AT+QIDEACT 命令停用 PDP 上下 文，然后通过 AT+QIACT 命令重新激活，然后再次发送 MMS 消息。 上海移远通信技术股份有限公司 20 / 24 LTE_Standard_MM_应用指导 5 错误代码 错误代码表示与移动设备或网络有关的错误。下表描述了有关的详细信息。 表 2：错误代码概览 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 含义 Unknown error URL length error URL error Invalid proxy type Proxy address error Invalid parameter Recipient address full CC recipient address full BCC recipient address full Attachments full File error No recipient File not found MMS busy Server response failed Error response of HTTP(S) post Invalid report of HTTP(S) post PDP activation failed 上海移远通信技术股份有限公司 21 / 24 769 PDP deactivated 770 Socket creation failed 771 Socket connection failed 772 Socket read failed 773 Socket write failed 774 Socket closed 775 Timeout 776 Encode data error 777 HTTP(S) decode data error LTE_Standard_MM_应用指导 上海移远通信技术股份有限公司 22 / 24 LTE_Standard_MM_应用指导 6 HTTP(s)响应码的描述 HTTP(S)协议错误码表示 MMSC 响应的错误。有关详情，请参阅 RFC2616（超文本传输 协议-HTTP/1.1）。下表描述了有关的详细信息。 表 3：错误代码概览 200 400 403 404 409 411 500 502 含义 OK Bad request Forbidden Not found Conflict Length required Internal server error Bad gate way 上海移远通信技术股份有限公司 23 / 24 LTE_Standard_MM_应用指导 7 附录 A 参考文档和术语缩写 表 4：相关文档 序号 文档名 备注 [1] Wap-209-mmsencapsulation-20020105-a WAP MMS 协议标准文件包 [2] RFC2616 超文本传输协议-HTTP/1.1 [3] Quectel_LTE_Standard_FILE_应用指导 适用于 LTE Standard 模块的 FILE 应用指导 [4] Quectel_LTE_Standard_TCP(IP)_应用指导 适用于 LTE Standard 模块的 TCP/IP 应用 指导 [5] Quectel_LTE_Standard_AT_Commands_Manual 适用于 LTE Standard 模块的 AT 命令手册 表 5：术语及缩写 缩写 BCC CC HTTP MMS MMSC PDP SD UFS URL 英文全称 中文全称 Blind Carbon Copy 密件抄送 Carbon Copy 抄送 Hypertext Transfer Protocol 超文本传输协议 Multimedia Messaging Service 多媒体信息服务（彩信） Multimedia Messaging Service Center 多媒体信息服务中心 Packet Data Protocol 分组数据协议 Secure Digital 安全数字 User File Storage 用户文件存储 Uniform Resource Locator 统一资源定位符 上海移远通信技术股份有限公司 24 / 24

EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 LTE Standard 模块系列 版本：EC2x&EG9x&EG2x-G&EM05 系列_SMTP_应用指导_V1.0 日期：2020-07-29 状态：受控文件 www.quectel.com EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时联 系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详细信息请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害，上海移远通信技术股份有限公司 不承担任何责任。在未声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 免责声明 上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用，但不排除上述功能 错误或遗漏的可能。除非其他有效协议另有规定，否则上海移远通信技术股份有限公司对开发中功能的使 用不做任何暗示或明示的保证。在适用法律允许的最大范围内，上海移远通信技术股份有限公司不对任何 因使用开发中功能而遭受的损失或损害承担责任，无论此类损失或损害是否可以预见。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责 任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 1 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 文档历史 修订记录 版本 1.0 日期 2020-07-29 作者 刘康康 变更表述 初始版本 上海移远通信技术股份有限公司 1 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 目录 文档历史 ....................................................................................................................................................... 1 目录 .............................................................................................................................................................. 2 表格索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 1.1. SSL 类型介绍 ............................................................................................................................. 5 1.2. 发送邮件的流程 .......................................................................................................................... 6 1.3. 数据模式说明.............................................................................................................................. 7 2 AT 命令详解 .......................................................................................................................................... 8 2.1. AT 命令语句 ............................................................................................................................... 8 2.1.1. 定义 ................................................................................................................................. 8 2.1.2. AT 命令语句.................................................................................................................... 8 2.2. SMTP AT 命令详解 .................................................................................................................... 9 2.2.1. AT+QSMTPCFG 配置 SMTP 服务器参数 .................................................................... 9 2.2.2. AT+QSMTPDST 添加或删除收件人........................................................................... 11 2.2.3. AT+QSMTPSUB 编辑邮件主题.................................................................................. 13 2.2.4. AT+QSMTPBODY 编辑邮件正文 ............................................................................... 14 2.2.5. AT+QSMTPATT 添加或删除邮件附件........................................................................ 16 2.2.6. AT+QSMTPCLR 清除邮件内容 .................................................................................. 17 2.2.7. AT+QSMTPPUT 发送邮件 ......................................................................................... 18 3 示例 ..................................................................................................................................................... 20 3.1. 发送无 SSL 邮件....................................................................................................................... 20 3.2. 发送 SSL 邮件 .......................................................................................................................... 22 3.3. 发送 STARTTLS 邮件 .............................................................................................................. 22 4 错误处理 .............................................................................................................................................. 24 4.1. 执行 SMTP AT 命令失败 .......................................................................................................... 24 4.2. PDP 激活失败........................................................................................................................... 24 4.3. DNS 解析失败 .......................................................................................................................... 24 4.4. AT+QSMTPPUT 错误响应 ....................................................................................................... 25 5 错误代码 .............................................................................................................................................. 26 6 SMTP 协议错误代码 ........................................................................................................................... 28 7 附录 A 参考文档和术语缩写 .............................................................................................................. 30 上海移远通信技术股份有限公司 2 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 5 表 2：AT 命令及响应类型 ............................................................................................................................ 8 表 3：错误码汇总 ....................................................................................................................................... 26 表 4：SMTP 协议错误码汇总 ..................................................................................................................... 28 表 5：参考文档 ........................................................................................................................................... 30 表 6：术语缩写 ........................................................................................................................................... 30 上海移远通信技术股份有限公司 4 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 1 引言 移远通信 EC2x&EG9x&EG2x-G&EM05 系列模块提供 SMTP 接口，可用于从客户开发的应用程序发 送电子邮件。该文档为 SMTP 定义的所有 AT 命令的参考指导。 表 1：适用模块 模块系列 EC2x系列 EG2x-G EG9x系列 EM05系列 模块 EC21系列 EC25系列 EC20 R2.1 EC20-CN EG21-G EG25-G EG91系列 EG95系列 EM05系列 1.1. SSL 类型介绍 SMTP 客户端与 SMTP 服务器之间共有三种连接方式：  无 SSL  SSL  STARTTLS 一些 SMTP 服务器不支持无 SSL 连接方式，而一些 SMTP 服务器则支持以上三种连接方式。可根据 邮件服务商选择连接方式。 上海移远通信技术股份有限公司 5 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 以上三种连接方式可以通过设置 AT+QSMTPCFG='ssltype'中的进行修改。 1. 若为 0，表示'无 SSL'连接方式。在这种情况下，SSL 功能无法使用，邮件在非安 全连接情况下发送。SMTP 服务器端口取决于邮件服务商，通常为端口 25。 2. 若为 1，表示'SSL'连接方式。在这种情况下，邮件通过 SSL/TLS 加密的 SMTP 的 方式进行发送。SMTP 服务器端口取决于邮件服务商，通常为端口 465 或 587。 3. 若为 2，表示'STARTTLS'连接方式。在这种情况下，可以通过 STARTTLS 功能 将常规的不安全连接升级为安全连接，从而发送邮件。SMTP 服务器端口取决于邮件服务商，通常 为端口 25、465 或 587。 1.2. 发送邮件的流程 EC2x&EG9x&EG2x-G&EM05 系列模块支持 SMTP 协议，因此用户可以通过模块 SMTP AT 命令发送 邮件。大致流程如下： 步骤 1：配置并激活 PDP 上下文。 1) 通过 AT+QICSGP 配置 PDP 上下文的、、及其他相关参数。详 细信息可参考文档 [3]。 若 QoS 设置需要更新，可通过 AT+CGQMIN、AT+CGEQMIN、AT+CGQREQ 和 AT+CGEQREQ 进行配置。详细信息可参考文档 [5]、文档 [6]和文档 [7]。 2) 通过 AT+QIACT 激活 PDP 上下文。 3) 通过 AT+QSMTPCFG='contextid',配置 SMTP 的 PDP 上下文 ID。 步骤 2：配置 SMTP 服务器与用户账户。 1) 通 过 AT+QSMTPCFG='ssltype', 配 置 SSL 类 型 。 若 为 SSL 或 STARTTLS ， 可 通 过 AT+QSMTPCFG='sslctxid', 选 择 SSL 上 下 文 ， 并 通 过 AT+QSSLCFG='ciphersuite',,配置。详细信息可参 考文档 [8]。 2) 通过 AT+QSMTPCFG='smtpserver',,配置 SMTP 服务器。和 取决于邮件服务商。 3) 通过 AT+QSMTPCFG='account',,配置账号信息。 4) 通过 AT+QSMTPCFG='sender',,配置账号信息。 步骤 3：编辑邮件内容。 1) 通过 AT+QSMTPDST 配置收件人。 2) 通过 AT+QSMTPSUB 配置邮件主题。 3) 通过 AT+QSMTPBODY 配置邮件正文。 4) 通过 AT+QSMTPATT 添加附件。附件可以为 RAM、UFS 或 SD 文件。且文件可以通过 AT+QFUPL 上传至 RAM、UFS 或 SD 卡。邮件发送成功后，可以通过 AT+QFDEL 删除文件。详细信息可参 考文档 [4]。 上海移远通信技术股份有限公司 6 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 步骤 4：发送邮件。 通过 AT+QSMTPPUT 发送邮件。根据附件的总大小和网络状态，发送邮件需要一些时间。当发送动作 结束后，将会上报+QSMTPPUT: ,。 步骤 5：清除邮件内容。 用户可以通过执行 AT+QSMTPCLR 清除步骤 3 配置的邮件内容，通过执行 AT+QFDEL 删除附件。 有关 AT 命令的详细信息可参考文档 [4]。然后重复步骤 3 和步骤 4。若用户需要修改 SMTP 和用户信息， 需重复如上步骤 2 至步骤 4。 若长时间未发送邮件（例如 30 分钟或更长时间），用户可以通过执行 AT+QIDEACT=去 激活 PDP 上下文。详细信息可参考文档 [3]。 1.3. 数据模式说明 EC2x&EG9x&EG2x-G&EM05 系列模块的 COM 端口有两种工作模式：AT 命令模式、数据模式。AT 命令模式下，通过 COM 端口输入的数据会被当成 AT 命令；而在数据模式下，则输入的数据即被当成数据。 输入+++或上拉 DTR（需先执行 AT&D1）可以使模块退出数据模式。为防止模块将+++误认为数据， 必须遵循以下几点： 1) 输入+++之前，请勿在 1 秒或更长时间内输入任何数据。 2) 必须在 1 秒内输入+++，且不可输入其他数据。 3) 输入+++后的 1 秒内不可输入任何数据。 执行 AT+QSMTPBODY 时，COM 端口将进入数据模式，此时，所有输入的数据将成为邮件的正文。 若输入的数据长度达到或时长达到，端口将自动退出数据模式。若输入的数 据长度小于，在到达时长之前，通过输入+++或拉高 DTR 电平以完成正文编 辑。在这种情况下，COM 端口无法通过执行 ATO 重新进入数据模式。 上海移远通信技术股份有限公司 7 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 2 AT 命令详解 2.1. AT 命令语句 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 2：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 上海移远通信技术股份有限公司 8 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 2.2. SMTP AT 命令详解 2.2.1. AT+QSMTPCFG 配置 SMTP 服务器参数 该命令用于配置 SMTP 服务器、用户名和 SSL。 AT+QSMTPCFG 配置 SMTP 服务器参数 测试命令 AT+QSMTPCFG=? 响应 +QSMTPCFG: 'account',, +QSMTPCFG: 'sender',, +QSMTPCFG: 'smtpserver',, +QSMTPCFG: 'contextid',(支持的范围) +QSMTPCFG: 'sslctxid',(支持的范围) +QSMTPCFG: 'ssltype',(支持的范围) +QSMTPCFG: 'bodyoriginal',(支持的列表) OK 设置命令 AT+QSMTPCFG='account'[,,] 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'account',, OK 设置命令 AT+QSMTPCFG='sender'[,,] 若指定可选参数，则设置用户账号： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'sender',, OK 设置命令 AT+QSMTPCFG='smtpserver'[,,] 若指定可选参数，则设置发件人信息： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'smtpserver',, OK 上海移远通信技术股份有限公司 9 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 若指定可选参数，则设置 SMTP 服务器： OK 或者 +CME ERROR: 设置命令 AT+QSMTPCFG='contextid'[,] 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'contextid', OK 若指定可选参数，则设置 PDP 上下文： OK 或者 +CME ERROR: 设置命令 AT+QSMTPCFG='sslctxid'[,] 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'sslctxid', OK 设置命令 AT+QSMTPCFG='ssltype'[,] 若指定可选参数，则设置 SSL 上下文 ID： OK 或者 +CME ERROR: 响应 若省略可选参数，则查询当前配置： +QSMTPCFG: 'ssltype', OK 若指定可选参数，则设置 SSL 类型： OK 或者 +CME ERROR: 设置命令 响应 AT+QSMTPCFG='bodyoriginal'[,] +QSMTPCFG: 'bodyoriginal', OK 若指定可选参数，则设置是否使能发送无字符集的 SMTP 正 文： OK 上海移远通信技术股份有限公司 10 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 最大响应时间 特性说明 或者 +CME ERROR: 300 毫秒 该命令立即生效； 不保存参数配置。 参数 字符串类型。身份验证用户名。最大长度为 50 字节。 字符串类型。身份验证密码。最大长度为 50 字节。 字符串类型。发件人的邮箱地址。最大长度为 50 字节。 字符串类型。收件人接收邮件时显示的发件人姓名。最大长度为 50 字节。 字符串类型。SMTP 服务器的 IP 地址或域名。最大长度为 50 字节。 整型。SMTP 服务器端口。默认值：25。端口号可能会根据 SMTP 服务器的不同而 变化。详细信息请询问对应的邮件服务商。 整型。PDP 上下文 ID。范围：1~16。默认值：1。请在发送邮件前通过执行 AT+QIACT 激活 PDP 上下文 ID。详细信息可参考文档 [3]。 整型。用于 SMTP 的 SSL 上下文 ID。 范围：0~5。默认值：1。请通过 AT+QSSLCFG 配置 SSL 参数。详细信息可参考文档 [8]。 整型。SSL 类型。因为有些 SMTP 服务器不支持无 SSL 下发送邮件，请根据邮件服 务商选择 SSL 类型。 0 无 SSL 1 SSL 2 STARTTLS 整型。是否使能发送无字符集的 SMTP 正文。 0 禁用发送无字符集的 SMTP 正文 1 使能发送无字符集的 SMTP 正文且发送原始 SMTP 正文 整型。操作错误码。详细信息可参考第 5 章。 2.2.2. AT+QSMTPDST 添加或删除收件人 该命令用于添加或删除收件人。收件人最大数量为 20，其中数量包括抄送及密件抄送收件人。 AT+QSMTPDST 添加或删除收件人 测试命令 AT+QSMTPDST=? 响应 +QSMTPDST: (支持的 mode>列表),(支持的范 围), OK 上海移远通信技术股份有限公司 11 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 查询命令 AT+QSMTPDST? 响应 [+QSMTPDST: ,] [...] OK 设置命令 AT+QSMTPDST=[,[,]] 响应 格式正确且未发送邮件： OK 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 不保存参数配置。 参数 整型。添加或者删除收件人。 0 删除。 1 添加。此时，需指定和。 整型。收件人类型。 1 所有收件人 2 抄送收件人 3 密件抄送收件人 字符串类型。收件人的邮箱地址。最大长度为 50 字节。 整型。操作错误码。详细信息可参考第 5 章。 举例 //新增收件人 AT+QSMTPDST=1,1,'quectel_test@aol.com' OK AT+QSMTPDST=1,2,'quectel_test@21cn.com' OK AT+QSMTPDST? +QSMTPDST: 1,'quectel_test@aol.com' +QSMTPDST: 2,'quectel_test@21cn.com' OK //删除所有收件人。 AT+QSMTPDST=0 OK AT+QSMTPDST? //添加所有收件人。 //添加抄送收件人。 //删除所有收件人。 上海移远通信技术股份有限公司 12 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 OK 2.2.3. AT+QSMTPSUB 编辑邮件主题 该命令用于编辑邮件主题。如果不是 ASCII，输入的数据应为原始主题的十六进制字符串。 AT+QSMTPSUB 编辑邮件主题 测试命令 AT+QSMTPSUB=? 响应 +QSMTPSUB: (支持的范围), 查询命令 AT+QSMTPSUB? OK 响应 +QSMTPSUB: , 设置命令 AT+QSMTPSUB=, OK 响应 OK 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 / 参数 整型。主题的字符集。 0 ASCII 1 UTF-8 2 GB2312 3 BIG5 字符串类型。邮件主题。若为 0，该字符串为邮件的主题；若不 为 0，该参数将转化为十六进制字符串格式，例如，'41'表示十六进制中的 '0x41'。若字符集为 ASCII，的长度为 0~100 字符。若字符集不是 ASCII，的长度为奇数，最大长度为 200 字符。 整型。操作错误码。详细信息可参考第 5 章。 举例 //添加邮件的主题，且为 ASCII。 AT+QSMTPSUB=0,'TEST SMTP' OK AT+QSMTPSUB? //编辑主题且字符集为 ASCII。 //查询邮件主题。 上海移远通信技术股份有限公司 13 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 +QSMTPSUB: 0,'TEST SMTP' OK //添加邮件的主题且为 UTF8。'7465737420534D5450'为'TEST SMTP'的十六进制字符串。 AT+QSMTPSUB=1,'7465737420534D5450' //编辑主题且字符集为 UTF8。 OK AT+QSMTPSUB? //查询邮件主题。 +QSMTPSUB: 1,'7465737420534D5450' OK 2.2.4. AT+QSMTPBODY 编辑邮件正文 该命令用于编辑邮件正文。执行 AT+QSMTPBODY=,[,]时， 模块将进入数据模式。此时输入的所有数据均为邮件正文。若输入的数据长度达到或时长 达到 ，模块将 自动退出数据 模式。 若 输入的数据长 度小于 ， 请在到 达 时长之前，通过输入+++或拉高 DTR 电平以完成正文编辑。邮件正文的最大长度为 10 Kbytes. 正文实际长度为输入的数据长度。 AT+QSMTPBODY 编辑邮件正文 测试命令 AT+QSMTPBODY=? 响应 +QSMTPBODY: (支持的范围),(支持的 范围),(支持的范围) OK 查询命令 响应 AT+QSMTPBODY? OK 设置命令 AT+QSMTPBODY=,[,] 响应 格式正确且未发送邮件，模块将进入数据模式： CONNECT +QSMTPBODY: OK 最大响应时间 特性说明 若出现任何错误： +CME ERROR: 取决于 / 上海移远通信技术股份有限公司 14 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 参数 整型。主题的字符集。 0 ASCII 1 UTF-8 2 GB2312 3 BIG5 整型。指定的正文长度。若输入数据的长度小于指定值，请执行+++退 出数据模式。邮件正文的实际长度为输入的数据长度。范围：1~10240。单位：字节。 整型。输入正文的实际长度。 整型。从 COM 端口上传邮件正文的最大时间。范围：1~65535。默认值：90。单 位：秒。 整型。操作错误码。详细信息可参考第 5 章。 举例 //编辑邮件正文，正文长度为100字节。 AT+QSMTPBODY=0,100,120 CONNECT +QSMTPBODY: 100 //编辑邮件正文。主题字符集为ASCII。最大输入长度为100字节， 且最大输入时间为120秒。 //输入100字符的数据。 OK //若实际输入长度小于指定长度，请输入+++可以完成正文编辑。 AT+QSMTPBODY=0,100,120 //编辑邮件正文。主题字符集为ASCII。最大输入长度为100字 节，且最大输入时间为120秒。 CONNECT //输入+++。 +QSMTPBODY: 90 OK //若实际输入长度小于指定长度，且超过了最大输入时间，模块将会自动停止输入正文。 AT+QSMTPBODY=0,100,120 //编辑邮件正文。主题字符集为ASCII。最大输入长度为100字节， 且最大输入时间为120秒。 CONNECT //120秒后。 +QSMTPBODY: 90 OK 上海移远通信技术股份有限公司 15 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 2.2.5. AT+QSMTPATT 添加或删除邮件附件 通过 AT+QSMTPATT=1 可以添加邮件附件。添加附件时，应指定邮件索引。因此，不同的附件的文件 索引各不相同。附件的最大数量为 10。 附件可为 RAM、UFS 或 SD 文件（强烈推荐使用 RAM 文件）。用户可以通过 AT+QFUPL 将文件上 传至 RAM、UFS 或 SD 卡。邮件成功发送后，RAM、UFS 或 SD 卡内的文件可通过 AT+QFDEL 删除。有 关 AT 命令的详细信息可参考文档 [4]。邮件服务商可能会对单个文件的大小及文件的总大小有一定限制。 AT+QSMTPATT=0 用于删除所有附件。 AT+QSMTPATT 添加或删除邮件附件 测试命令 AT+QSMTPATT=? 响应 +QSMTPATT: (支持的范围),(支持的范 围), 查询命令 AT+QSMTPATT? OK 响应 [+QSMTPATT: ,,] [...] 设置命令 AT+QSMTPATT=[,[,]] OK 响应 OK 或者 +CME ERROR: 最大响应时间 300 毫秒 特性说明 该命令立即生效； 不保存参数配置。 参数 整型。添加或者删除附件。 0 删除。 1 添加。此时，需指定和。 整型。附件索引。范围：1~10。 字符串类型。将要添加的附件的文件名称。最大长度为 50 字节。 整型。附件大小。单位：字节。 整型。操作错误码。详细信息可参考第 5 章。 上海移远通信技术股份有限公司 16 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 举例 //请从 RAM 添加附件。邮件发出后，上传至 RAM 的文件可以通过 AT+QFDEL 删除。详细示例如下： AT+QFUPL='RAM:test.txt',200,300,1 //将文件上传至RAM。文件被另存为'test.txt'，文件最大长 度为200字节。300表示超时时间，1表示ACK模式。详细 信息可参考文档 [4]。 CONNECT +QFUPL: 200,707 OK AT+QFLST='RAM:*' +QFLST: 'RAM:test.txt',200 OK AT+QSMTPATT=1,1,'RAM:test.txt' OK AT+QSMTPATT? +QSMTPATT: 1,'RAM:test.txt',200 //添加邮件附件，附件文件索引为 1。 //查询附件。 OK //删除所有附件。 AT+QSMTPATT=0 OK AT+QSMTPATT? OK //删除邮件所有的附件。 //查询附件。 2.2.6. AT+QSMTPCLR 清除邮件内容 该命令用于清除所有 AT+QSMTPDST、AT+QSMTPSUB、AT+QSMTPBODY 和 AT+QSMTPATT 的 配置。 AT+QSMTPCLR 清除邮件内容 测试命令 AT+QSMTPCLR=? 执行命令 AT+QSMTPCLR 最大响应时间 特性说明 响应 OK 响应 OK 或者 +CME ERROR: 300 毫秒 / 上海移远通信技术股份有限公司 17 / 31 参数 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 整型。操作错误码。详细信息可参考第 5 章。 举例 AT+QSMTPCLR OK AT+QSMTPDST? OK AT+QSMTPSUB? +QSMTPSUB: 0,'' OK AT+QSMTPATT? OK //清除邮件的收件人、主题、正文和附件。 //查询邮件的收件人。 //查询邮件的主题。 //查询邮件附件。 2.2.7. AT+QSMTPPUT 发送邮件 将邮件完全发送出去可能需要一些时间，主要取决于附件大小和网络状况。在收到表示邮件发送结束的 URC +QSMTPPUT: ,前 ， 请 勿 重 复 发 送 邮 件 。 若 不 为 0 ， 可 直 接 执行 AT+QSMTPPUT=重新发送邮件。 AT+QSMTPPUT 发送邮件 测试命令 AT+QSMTPPUT=? 响应 +QSMTPPUT: (支持的范围) 设置命令 AT+QSMTPPUT= OK 响应 格式正确且未发送邮件： OK +QSMTPPUT: , 最大响应时间 特性说明 若出现任何错误： +CME ERROR: 取决于 / 上海移远通信技术股份有限公司 18 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 参数 整型。发送邮件的最大时间。范围：60~65535；单位：秒。 整型。操作错误码。详细信息可参考第 5 章。0 表示操作成功。 整型。仅供参考。表示从 SMTP 协议中定义的 SMTP 服务器的原始错误码。详细信 息可参考第 6 章。0 表示无效。 举例 AT+QSMTPPUT=300 OK +QSMTPPUT: 0,0 //发送邮件，最大长度为 300 秒。 //邮件发送成功。 上海移远通信技术股份有限公司 19 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 3 示例 3.1. 发送无 SSL 邮件 发送无 SSL 邮件表示禁用 SSL 功能，且邮件将在不安全连接的情况下发送出去，例如： //步骤 1：配置并激活 PDP 上下文。 AT+QICSGP=1,1,'UNINET','','',1 OK AT+QIACT=1 OK AT+QIACT? +QIACT: 1,1,1,'10.7.157.1' //配置为 PDP 上下文 1。APN 为'UNINET' 表 示中国联通。 //激活 PDP 上下文 1。 //激活成功。 //查询 PDP 上下文状态。 OK AT+QSMTPCFG='contextid',1 //将PDP上下文ID设置为1。首先PDP上下文ID 需激活。 OK //步骤2：配置SMTP服务器和用户账号。 AT+QSMTPCFG='ssltype',0 //将SSL类型设置为'无SSL。该情况下，禁用 SSL功能，且邮件将在不安全连接的情况下发 送。 AT+QSMTPCFG='smtpserver','smtp.163.com',25 SMTP //设置 IP 地址或域名以及 SMTP 服务器端口。 服务器端口取决于邮件服务商。 OK AT+QSMTPCFG='account','sishen664551','wq664551' //设置用户名和密码。 OK AT+QSMTPCFG='sender','sishen664551','sishen664551@163.com' //设置发件人姓名和地址。邮件 接收后将显示发件人姓名。 OK //步骤3：编辑邮件内容。. AT+QSMTPDST=1,1,'quectel_test@163.com' //添加收件人，收件人类型为所有收件人。 OK AT+QSMTPDST=1,2,'quectel_test@21cn.com' //添加收件人，收件人类型为抄送的收件人。 OK 上海移远通信技术股份有限公司 20 / 31 AT+QSMTPDST? +QSMTPDST: 1,'quectel_test@163.com' +QSMTPDST: 2,'quectel_test@21cn.com' OK AT+QSMTPSUB=0,'TEST SMTP' OK AT+QSMTPSUB? +QSMTPSUB: 0,'TEST SMTP' OK AT+QSMTPBODY=0,100,120 CONNECT +QSMTPBODY: 100 OK AT+QFUPL='RAM:smtp1.txt',100,200,1 CONNECT +QFUPL: 100,707 OK AT+QFLST='RAM:*' +QFLST: 'RAM:smtp1.txt',100 OK AT+QSMTPATT=1,1,'RAM:smtp1.txt' OK AT+QSMTPATT? +QSMTPATT: 1,'RAM:smtp1.txt',100 OK //步骤4：发送邮件。 AT+QSMTPPUT=300 OK //可能需要几分钟时间。 +QSMTPPUT: 0,0 //步骤5：清除邮件内容并去激活PDP上下文。 AT+QSMTPCLR OK EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 //编辑主题，主题的字符集为 ASCII。 //查询邮件主题。 //编辑邮件正文。主题的字符集为ASCII。最大输入 长度为100字节，且最大输入时间为120秒。 //将文件上传至RAM。文件被另存为'smtp1.txt'， 文件最大长度为100字节。200表示超时时间，1表 示ACK模式。详细信息可参考文档 [4]。 //添加邮件附件，附件文件索引为 1。 //查询附件。 //发送邮件，最大发送时间为 300 秒。 //成功发送邮件。 //清除邮件的收件人、主题、正文和附件。 上海移远通信技术股份有限公司 21 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 AT+QFDEL='RAM:smtp.txt' //清除附件文件。 OK //重复步骤3和步骤4，重新发送邮件。也可以重复步骤2至步骤4重新发送邮件。 AT+QIDEACT=1 //去激活PDP上下文。 OK 3.2. 发送 SSL 邮件 发送 SSL 的邮件表示邮件通过 SSL/TLS 加密的 SMTP 的方式进行发送。SMTP 服务器端口取决于邮 件服务商，通常为端口 465 或 587。与无 SSL 相比，SSL 方式发送邮件还需要 SMTP 服务器和用户账号配 置。 //配置 SSL 类型。 AT+QSMTPCFG='ssltype',1 //将 SSL 类型设置为 1，表示通过 SSL 方式发送邮件。 OK AT+QSMTPCFG='sslctxid',1 //为SMTP选择SSL上下文1。 OK AT+QSSLCFG='ciphersuite',1,0xffff //将SSL密码套件类型配置为0xffff，表示支持所有密码套件 类型。 OK AT+QSSLCFG='seclevel',1,0 //将 SSL 安全等级设置为 0，表示不需要 SSL CA 证书。 OK AT+QSSLCFG='sslversion',1,1 //将 SSL 版本配置为 1，表示 TLS1.0。 OK //配置SMTP服务器。 AT+QSMTPCFG='smtpserver','smtp.163.com',25 //设置 SMTP 服务器地址和端口。 OK //由于SMTP服务器的不同，账号信息各不相同，示例如下。 AT+QSMTPCFG='account','sishen664551','wq664551' //设置用户名及密码。 OK AT+QSMTPCFG='sender','sishen664551','sishen664551@163.com' //设置发件人姓名及地址。 OK 3.3. 发送 STARTTLS 邮件 发送 STARTTLS 邮件表示通过 STARTTLS 功能将常规的不安全连接升级为安全连接，从而发送邮件。 在这种情况下，需要配置 SMTP 服务器和用户账号。SMTP 服务器端口取决于邮件服务商，通常为端口 25、 465 或 587。 上海移远通信技术股份有限公司 22 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 //配置SSL类型。 AT+QSMTPCFG='ssltype',2 //将SSL类型设置为2，表示将通过STARTTLS发送邮件。 OK AT+QSMTPCFG='sslctxid',1 //为SMTP选择SSL上下文1。 OK AT+QSSLCFG='ciphersuite',1,0xffff //将SSL密码套件类型配置为0xffff，表示支持所有密码套 件类型。 OK AT+QSSLCFG='seclevel',1,0 //将SSL安全等级设置为0，表示不需要SSL CA证书。 OK AT+QSSLCFG='sslversion',1,1 //将SSL版本配置为1，表示TLS1.0。 OK //配置SMTP服务器。 AT+QSMTPCFG='smtpserver','smtp.163.com',25 //设置SMTP服务器地址和端口。 OK //由于SMTP服务器的不同，账号信息各不相同，示例如下。 AT+QSMTPCFG='account','sishen664551','wq664551' //设置用户名及密码。 OK AT+QSMTPCFG='sender','sishen664551','sishen664551@163.com' //设置发件人姓名及地址。 OK 上海移远通信技术股份有限公司 23 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 4 错误处理 4.1. 执行 SMTP AT 命令失败 执行 SMTP AT 命令时，若收到模块返回的 ERROR，请检查是否已经插入(U)SIM 卡，并检查执行 AT+CPIN?时是否返回+CPIN: READY。若未返回+CPIN: READY，表示(U)SIM 卡未就绪。 4.2. PDP 激活失败 若通过 AT+QIACT 激活 PDP 上下文失败，请检查如下配置： 1. 通过 AT+CGATT?查询是否已附着 PS 域。若没有，请执行 AT+CGATT=1 附着 PS 域。 2. 通过 AT+CGREG?查询 PS 域状态并确保已注册 PS 域。 3. 通过 AT+QICSGP=查询 PDP 上下文参数，并确保已设置指定 PDP 上下文的 APN。 4. 确保 PPP 未使用指定的 PDP 上下文 ID，AT+CGACT 也未激活指定的 PDP 上下文 ID。 5. 根据 3GPP 规范，模块仅支持同时激活三个 PDP 上下文，因此请确保激活的 PDP 上下文的数量 不多于 3。 如果以上所有配置均正确，但依然无法通过 AT+QIACT 成功激活 PDP 上下文，请重启模块。重启模 块后，请至少三次检查上述配置，检查间隔为 10 分钟，以避免频繁重启模块。 4.3. DNS 解析失败 执行 AT+QSMTPPUT 时，如果返回+QSMTPPUT: 653,0，请检查以下几个方面： 1. 确保 SMTP 服务器的域名有效。 2. 通过 AT+QIACT?查询 PDP 上下文的状态并确保指定的 PDP 上下文已成功激活。 上海移远通信技术股份有限公司 24 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 4.4. AT+QSMTPPUT 错误响应 执行 AT+QSMTPPUT 后将返回+QSMTPPUT: ,。 若不为 0，则表示发送失败。请重新发送邮件。若重新发送不成功，请通过 AT+QIDEACT 去激 活 PDP 上下文，然后通过 AT+QIACT 重新激活 PDP 上下文以解决此问题。若激活 PDP 上下文失败，可 参考第 4.2 章以解决该问题。 若不为 0，则表示为 SMTP 服务器回复的错误代码。请根据协议 错误代码检查错误原因。例如，若为 535（身份验证失败），则表明或 可能是错误的。若为 530（拒绝访问），则意表示邮件发送频率过高且 SMTP 服务器拒绝发布邮件。更多详细信息，请参考 RFC2821（简单邮件传输协议）。 上海移远通信技术股份有限公司 25 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 5 错误代码 错误码表示与移动设备或网络相关的错误，错误码信息如下表所示。 表 3：错误码汇总 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 错误代码 释义 Unknown error 未知错误 The SMTP server is busy, such as uploading the body or sending an email. SMTP 服务器正忙，例如上传邮件正文或发 送邮件。 Failed to get IP address according to the domain name. 无法根据域名获取 IP 地址。 Network error, such as failed to activate GPRS/CSD context, failed to establish the TCP connection with the SMTP server or failed to send an email to the SMTP server, etc. 网络错误，例如无法激活 GPRS/CSD 上下文， 无法与 SMTP 服务器建立 TCP 连接或无法向 SMTP 服务器发送邮件等。 Unsupported authentication type 不支持的身份验证类型 The connection for the SMTP server is closed by peer. SMTP 服务器的连接被对端关闭。 GPRS/CSD context is deactivated. GPRS/CSD 被去激活 Timeout 超时 No recipient for the SMTP server SMTP 服务器无收件人 Failed to send an email 发送邮件失败 Failed to open a file 打开文件失败 No enough memory for the attachment 内存不足 Failed to save the attachment 保存附件失败 The input parameter is wrong 输入参数错误 SSL authentication failed SSL 验证失败 上海移远通信技术股份有限公司 26 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 666 Service not available, closing transmission 服务不可用，正在关闭传输信道 channel 667 Requested mail action not taken: mailbox 未执行请求的邮件操作：邮箱不可用 unavailable 668 Requested action aborted: local error in 请求的操作已中止：处理中发生本地错误 processing 669 Requested action not taken: insufficient 未采取要求的操作：系统存储空间不足 system storage 670 Syntax error, command unrecognized 语法错误，命令无法识别 671 Syntax error in parameters or arguments 参数语法错误 672 Command not implemented 命令未实现 673 Bad sequence of commands 命令顺序错误 674 Command parameter not implemented 命令参数未实现 does not accept mail (see 675 RFC1846) 不接受邮件（请参考 RFC1846） 676 Access denied 拒绝访问 677 Authentication failed 验证失败 Requested action not taken: mailbox 678 unavailable 未执行请求的操作：邮箱不可用 679 User not local; please try 用户不在本地；请尝试 680 Requested mail action aborted: exceeded 请求的邮件操作中止：超出了分配存储 storage allocation 681 Requested action not taken: mailbox name 未采取请求的操作：不允许使用邮箱名称 not allowed 682 Transaction failed 交易失败 上海移远通信技术股份有限公司 27 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 6 SMTP 协议错误代码 协议错误代码表示 SMTP 服务器回复的错误。可参考 RFC2821（简单邮件传输协 议）。下表描述了有关协议错误码的详细信息。 表 4：SMTP 协议错误码汇总 错误代码 释义 421 Service not available, closing 服务不可用，正在关闭传输信道 transmission channel 450 Requested mail action not taken: 未执行请求的邮件操作：邮箱不可用 mailbox unavailable 451 Requested action aborted: local error in 请求的操作已中止：处理中发生本地错误 processing 452 Requested action not taken: insufficient 未采取要求的操作：系统存储空间不足 system storage 500 Syntax error, command unrecognized 语法错误，命令无法识别 501 Syntax error in parameters or 参数语法错误 arguments 502 Command not implemented 命令未实现 503 Bad sequence of commands 命令顺序错误 504 Command parameter not implemented 命令参数未实现 does not accept mail (see 不 接 受 邮 件 （ 请 参 考 521 RFC1846) RFC1846） 530 Access denied 拒绝访问 535 Authentication failed 验证失败 550 Requested action not taken: mailbox 未执行请求的操作：邮箱不可用 unavailable 551 User not local; please try <forward- 用户不在本地；请尝试 path> 552 Requested mail action aborted: 请求的邮件操作中止：超出了分配存储 exceeded storage allocation 上海移远通信技术股份有限公司 28 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 553 Requested action not taken: mailbox 未采取请求的操作：不允许使用邮箱名称 name not allowed 554 Transaction failed 交易失败 上海移远通信技术股份有限公司 29 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 7 附录 A 参考文档和术语缩写 表 5：参考文档 序号 文档名称 [1] RFC2821 [2] RFC3207 [3] Quectel_LTE_Standard_TCP(IP)_应用指导 [4] Quectel_LTE_Standard_FILE_应用指导 [5] Quectel_EC25&EC21_AT_Commands_Manual [6] Quectel_EG9x_AT_Commands_Manual [7] Quectel_EM05_AT_Commands_Manual Quectel_EC2x&EG9x&EM05_SSL_AT_Commands_ [8] Manual 备注 简单邮件传输协议 SMTP 服务扩展，用于通过传输层安全 协议的安全 SMTP EC2x&EG9x&EG2x-G&EM05 系列 TCP/IP 应用指导 EC2x&EG9x&EG2x-G&EM05 系列 FILE 应用指导 EC25&EC21 系列 AT 命令手册 EG9x 系列 AT 命令手册 EM05 系列 AT 命令手册 EC2x&EG9x&EM05 系列 SSL AT 命 令手册 表 6：术语缩写 缩写词 英文全称 ACK CSD DNS DTR GPRS PDP PPP Acknowledgement Circuit Switched Data Domain Name Server Data Terminal Ready General Packet Radio Service Packet Data Protocol Point-to-Point Protocol 中文全称 确认 电路交换数据业务 域名系统 数据终端就绪 通用无线分组业务 分组报文协议 点对点协议 上海移远通信技术股份有限公司 30 / 31 EC2x&EG9x&EG2x-G&EM05 系列 SMTP 应用指导 PS RAM SD SMTP SSL TA TCP TLS UFS (U)SIM Packet Switch Random Access Memory Secure Digital Simple Mail Transfer Protocol Security Socket Layer Terminal Adapter Transmission Control Protocol Transport Layer Security Universal Flash Storage (Universal) Subscriber Identity Module 分组交换 随机存取存储器 安全数码 简单邮件传输协议 安全套接层 终端适配器 传输控制协议 安全传输层协议 通用闪存存储 （全球）用户识别卡 上海移远通信技术股份有限公司 31 / 31

MC20 Series GNSS AT Commands Manual GSM/GPRS/GNSS Module Series Rev. MC20_Series_GNSS_AT_Commands_Manual_V1.3 Date: 2017-08-03 www.quectel.com GSM/GPRS/GNSS Module Series MC20 Series GNSS 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 tel GENERAL NOTES QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION c l PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT ue tia 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 Q n CHANGE WITHOUT PRIOR NOTICE. fide COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS n DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS o ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL C OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2017. All rights reserved. MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 1 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual About the Document History Revision 1.0 1.1 1.2 1.3 Date 2016-06-24 l 2016-07-30 cte l 2016-11-11 CQounefidentia 2017-08-03 Author Hyman DING Hyman DING Hyman DING Matt YE Description Initial Added the following new AT commands: AT+QGNSSTS/AT+QGNSSEPO/ AT+QGREFLOC/AT+QGEPOAID Added new AT command: AT+QGEPOF Modified the description and example of AT+QGEPOF MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 2 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 4 1 Introduction ....................................................................................................................................... 5 2 AT Commands for MC20 Series GNSS............................................................................................ 6 2.1. Overview of AT Commands for MC20 Series GNSS ................................................................ 6 2.1.1. AT+QGNSSC Control Power Supply of GNSS Module ............................................... 6 2.1.2. AT+QGNSSRD Read GNSS Navigation Information .................................................. 7 3 4 2.1.3. 2.1.4. 2.1.5. 2.1.6. l 2.1.7. 2.1.8. AT+QGNSSCMD Send Commands to GNSS Module ................................................ 8 AT+QGNSSTS Get Time Synchronization Status for GNSS Module .......................... 8 AT+QGNSSEPO Enable/Disable EPOTM Function ..................................................... 9 AT+QGREFLOC Set Reference Location Information for QuecFastFix Online......... 10 AT+QGEPOAID Trigger EPOTM Function...................................................................11 AT+QGEPOF EPOTM File Operation ..........................................................................11 te Examples ......................................................................................................................................... 14 c l 3.1. AT+QGNSSC ......................................................................................................................... 14 3.2. AT+QGNSSRD ....................................................................................................................... 14 ue tia 3.3. AT+QGNSSCMD.................................................................................................................... 15 3.4. AT+QGNSSTS ....................................................................................................................... 15 3.5. AT+QGNSSEPO .................................................................................................................... 15 Q n 3.6. AT+QGREFLOC..................................................................................................................... 16 3.7. AT+QGEPOAID ...................................................................................................................... 16 e 3.8. AT+QGEPOF.......................................................................................................................... 17 fid 3.9. Complete Example for QuecFastFix Online ........................................................................... 17 Appendix A References .................................................................................................................. 20 4.1. Related Documents ................................................................................................................ 20 n 4.2. Terms and Abbreviations ........................................................................................................ 20 Co 4.3. Summary of CME ERROR Codes Related to GNSS.............................................................. 21 MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 3 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual Table Index TABLE 1: OVERVIEW OF AT COMMANDS FOR MC20 SERIES GNSS........................................................... 6 TABLE 2: RELATED DOCUMENTS .................................................................................................................. 20 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 20 TABLE 4: DIFFERENT CODING SCHEMES OF +CME ERROR RELATED TO GNSS: .................... 21 CQouneficdteenl tial MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 4 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual 1 Introduction GNSS, a featured function embedded in Quectel MC20 series module, can help customers get the current accurate coordinates, high precision time, etc. MC20 series integrates both GNSS and GSM engines which can work as a whole (All-in-one solution) unit or work independently (Stand-alone solution) according to customer demands. In All-in-one solution, the internal GNSS module can be regarded as a peripheral of the whole unit, and is completely controlled by the GSM module, including power supply, UART communication, etc. In Stand-alone solution, the internal GNSS module and the GSM module work independently, and the GNSS has to be controlled separately. l MC20 series module currently includes three variants: te OC: MC20CA-04-STD (supports BT3.0) c l OC: MC20ECA-04-BLE (supports BT4.0) CQounefidentia OC: MC20CA-04-TTS (supports text-to-speech) MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 5 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual 2 AT Commands for MC20 Series GNSS 2.1. Overview of AT Commands for MC20 Series GNSS The commands below are effective only in All-in-one solution. Table 1: Overview of AT Commands for MC20 Series GNSS l Command te AT+QGNSSC c l AT+QGNSSRD ue tia AT+QGNSSCMD AT+QGNSSETS Q n AT+QGNSSEPO e AT+QGREFLOC fid AT+QGEPOAID AT+QGEPOF Description Control power supply of GNSS module Read GNSS navigation information Send commands to GNSS module Get time synchronization status for GNSS module Enable/Disable EPOTM function Set reference location information for QuecFastFix Online Trigger EPOTM function EPOTM file operation Con 2.1.1. AT+QGNSSC Control Power Supply of GNSS Module The command is used to control the power supply of GNSS module. AT+QGNSSC Control Power Supply of GNSS Module Test Command AT+QGNSSC=? Response +QGNSSC: (list of supported s) Read Command AT+QGNSSC? OK Response +QGNSSC: MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 6 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual Write Command AT+QGNSSC= OK Response OK If there is an error related to ME functionality: +CME ERROR: Parameter 0 Power off GNSS module 1 Power on GNSS module NOTE l In Stand-alone solution, the power supply of GNSS is controlled by an external circuit rather than the PIN GNSS_VCC_EN. In such case, command AT+QGNSSC cannot be used and thus can be ignored. cte l 2.1.2. AT+QGNSSRD Read GNSS Navigation Information ue tia The command is used to get the GNSS navigation information. AT+QGNSSRD Read GNSS Navigation Information Q n Test Command e AT+QGNSSRD=? Response +QGNSSRD: (list of supported s) fid Read Command AT+QGNSSRD? OK Response +QGNSSRD: (information of all supported s) on Write Command C AT+QGNSSRD= OK Response +QGNSSRD: (information of s) OK If there is an error related to ME functionality: +CME ERROR: Parameter 'NMEA/GGA': Get GGA sentence 'NMEA/GLL': Get GLL sentence MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 7 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual 'NMEA/GSA': Get GSA sentence 'NMEA/GSV': Get GSV sentence 'NMEA/RMC': Get RMC sentence 'NMEA/VTG': Get VTG sentence 2.1.3. AT+QGNSSCMD Send Commands to GNSS Module The command is used to send commands to GNSS module, which allows customers to optionally use some functions to meet application demands. AT+QGNSSCMD Send Commands to GNSS Module Test Command Response AT+QGNSSCMD=? +QGNSSCMD: (0,1),'cmdString' Write Command l AT+QGNSSCMD=, OK Response OK If there is an error related to ME functionality: +CME ERROR: ue tia Parameter Q n e 0 NMEA style command 1 Hex style command Command string fid NOTE n Currently only =0 is supported. Co 2.1.4. AT+QGNSSTS Get Time Synchronization Status for GNSS Module The command is used to get time synchronization status for GNSS module. Time plays a very important role in EPOTM function. AT+QGNSSTS Get Time Synchronization Status for GNSS Module Test Command AT+QGNSSTS=? Response +QGNSSTS: OK MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 8 / 21 Read Command AT+QGNSSTS? Parameter GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual Response +QGNSSTS: OK 0 Time is not synchronized 1 Time is synchronized successfully NOTE Exact time is very important to EPOTM function. So customers must ensure the time is valid before using EPOTM function. l 2.1.5. AT+QGNSSEPO Enable/Disable EPOTM Function te The command is used to enable or disable EPOTM function. c l AT+QGNSSEPO Enable/Disable EPOTM Function ue tia TestCommand AT+QGNSSEPO=? Response +QGNSSEPO: (list of supported s)[,] Q n Read Command e AT+QGNSSEPO? OK Response +QGNSSEPO: , fid Write Command n AT+QGNSSEPO=[,< Co account_id>] OK Response OK If there is an error related to ME functionality: +CME ERROR: Parameter 0 Disable EPOTM function 1 Enable EPOTM function 2 Set account ID for EPOTM function MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 9 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual NOTES 1. The parameter only supports 2. It can be omitted and 2 will be its default value when it is omitted. 2. The EPOTM function should be enabled after the time is synchronized successfully. 2.1.6. AT+QGREFLOC Set Reference Location Information for QuecFastFix Online The command is used to set reference location information for QuecFastFix Online function. AT+QGREFLOC Set Reference Location Information for QuecFastFix Online Test Command AT+QGREFLOC=? Response +QGREFLOC: , l Read Command AT+QGREFLOC? OK Response +QGREFLOC: , cte l WriteCommand AT+QGREFLOC=, OK Response OK If there is an error related to ME functionality: Q n +CME ERROR: e Parameter fid Latitude information of the reference location Longitude information of the reference location on NOTES C 1. The range of is -90°~90° North Latitude, and the range of is -180°~180°East Longitude. The input format of the parameter should retain 6 decimal places, and the unit is degree. 2. The command works for QuecFastFix Online function and should be set before executing AT+QGNSSEPO=1. MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 10 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual 2.1.7. AT+QGEPOAID Trigger EPOTM Function The command is used to trigger EPOTM function. AT+QGEPOAID Trigger EPOTM Function Test Command AT+QGEPOAID=? Execution Command AT+QEPOAID Response OK Response OK If there is an error related to ME functionality: +CME ERROR: NOTES 1. If GNSS is powered on already, customers could use this command to trigger EPOTM function after l executing AT+QGNSSEPO=1. te 2. If execute AT+QGNSSEPO=1 first and then power on GNSS, executing this command will not trigger EPOTM function. uec tial 2.1.8. AT+QGEPOF EPOTM File Operation The command is used to operate EPOTM related files, including deleting related files, getting file size and Q n querying validity period of EPOTM files. e AT+QGEPOF EPOTM File Operation Test Command fid AT+QGEPOF=? Response +QGEPOF: (list of supported s), (list of supported s) n Write Command AT+QGEPOF=, OK Response If is 0, response: +QGEPOF: ,, OK If is 1, response: OK If is 2, response: +QGEPOF: OK MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 11 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual If there is an error related to ME functionality: +CME ERROR: Parameter Operation mode 0 Get EPOTM file size 1 Delete EPOTM file 2 Query validity period of EPOTM files EPOTM file selection 1 Select the EPOTM file containing 6 hours of data 2 Select the EPOTM file containing the first 3 days of data 3 Select the EPOTM file containing the second 3 days of data 255 Select the above 3 files Integer value. Positive numbers indicate the file size, and negative numbers l indicate failed file operation. te 0-4032 Size of the EPOTM file containing 6 hours of data -9 File not found c l -16 File access denied -19 Path not found ue tia Other negative values Other failed file operation Integer value. Positive numbers indicate the file size, and negative numbers indicate failed file operation. Q n 0-48384 Size of the EPOTM file containing the first 3 days of data e -9 File not found fid -16 File access denied -19 Path not found Other negative values Other failed file operation n Integer value. Positive numbers indicate the file size, and negative numbers indicate failed file operation. o0-48384 Size of the EPOTM file containing the second 3 days of C data -9 File not found -16 File access denied -19 Path not found Other negative values Other failed file operation String type. The queried validity period of EPOTM files The format is 'yyyy-MM-dd hh:mm:ss' (UTC time), and the characters indicate year, month, day, hour, minute and second respectively. -9 File not found -16 File access denied MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 12 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual -19 Path not found Other negative values Other failed file operation NOTES 1. If the EPOTM files are deleted, there is a need to trigger EPOTM function again. For more details, please refer to Quectel_MC20_GNSS_AGPS_Application_Note. 2. If is 2, can be omitted. 3. Commands AT+QGEPOF=1,1, AT+QGEPOF=1,2 and AT+QGEPOF=1,3 are only for testing purpose. Please use AT+QGEPOF=1,255 in the real application. CQouneficdteenl tial MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 13 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual 3 Examples 3.1. AT+QGNSSC AT+QGNSSC? //Query GNSS power status. +QGNSSC: 0 //GNSS is powered off. OK AT+QGNSSC=1 OK //Power on GNSS. tel 3.2. AT+QGNSSRD c l AT+QGNSSRD? //Inquire GNSS NMEA sentence. +QGNSSRD: $GNRMC,033836.000,A,3150.8272,N,11711.9889,E,0.00,140.50,140716,,,D*72 ue tia $GNVTG,140.50,T,,M,0.00,N,0.00,K,D*26 $GNGGA,033836.000,3150.8272,N,11711.9889,E,2,10,0.96,166.6,M,0.0,M,,*4A $GPGSA,A,3,28,16,09,27,08,07,30,,,,,,1.52,0.96,1.17*01 Q n $BDGSA,A,3,04,07,10,,,,,,,,,,1.52,0.96,1.17*1F e $GPGSV,3,1,10,08,64,016,51,07,61,300,28,42,42,134,34,30,34,315,42*7E $GPGSV,3,2,10,27,32,043,45,16,25,085,43,09,17,227,39,28,08,294,30*7D fid $GPGSV,3,3,10,26,02,102,,193,,,*76 $BDGSV,3,1,09,10,76,324,44,08,76,235,,07,73,125,44,15,48,226,28*6A $BDGSV,3,2,09,01,47,141,27,12,41,240,27,02,38,231,,04,32,119,39*69 n $BDGSV,3,3,09,05,18,252,27*5D $GNGLL,3150.8272,N,11711.9889,E,033836.000,A,D*40 Co OK AT+QGNSSRD='NMEA/RMC' //Inquire RMC information. +QGNSSRD: $GNRMC,033837.000,A,3150.8272,N,11711.9889,E,0.00,140.50,140716,,,D*73 OK AT+QGNSSRD='NMEA/GSA' //Inquire GSA information. +QGNSSRD: $GPGSA,A,3,28,16,09,27,08,07,30,,,,,,1.52,0.96,1.17*01 $BDGSA,A,3,04,07,10,,,,,,,,,,1.52,0.96,1.17*1F OK AT+QGNSSRD? //Inquire GNSS NMEA sentence. MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 14 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual +QGNSSRD: $GNRMC,033839.000,A,3150.8272,N,11711.9889,E,0.00,140.50,140716,,,D*7D $GNVTG,140.50,T,,M,0.00,N,0.00,K,D*26 $GNGGA,033839.000,3150.8272,N,11711.9889,E,2,10,0.96,166.6,M,0.0,M,,*45 $GPGSA,A,3,28,16,09,27,08,07,30,,,,,,1.52,0.96,1.17*01 $BDGSA,A,3,04,07,10,,,,,,,,,,1.52,0.96,1.17*1F $GPGSV,3,1,10,08,64,016,51,07,61,300,26,42,42,134,34,30,34,315,42*70 $GPGSV,3,2,10,27,32,043,46,16,25,085,43,09,16,226,39,28,08,294,30*7E $GPGSV,3,3,10,26,02,102,,193,,,*76 $BDGSV,3,1,09,10,76,324,44,08,76,235,,07,73,125,44,15,48,226,28*6A $BDGSV,3,2,09,01,47,141,27,12,41,240,27,02,38,231,,04,32,119,39*69 $BDGSV,3,3,09,05,18,252,27*5D $GNGLL,3150.8272,N,11711.9889,E,033839.000,A,D*4F OK l 3.3. AT+QGNSSCMD te AT+QGNSSCMD=0,'$PMTK605*31' OK //Inquire GNSS version information. uec tial +QGNSSCMD: $PMTK705,AXN_3.82_3333_16051101,0001,MC20-GNSS,1.0*2A Q n 3.4. AT+QGNSSTS e AT+QGNSSTS=? fid +QGNSSTS: (0,1) //Test command OK n AT+QGNSSTS? +QGNSSTS: 1 //Read time synchronization mode and status. //Time is synchronized successfully. Co OK 3.5. AT+QGNSSEPO AT+QGNSSEPO=? //Test command +QGNSSEPO: (0,1)[,] OK AT+CREG?;+CGREG? +CREG: 0,1 //Check network status. MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 15 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual +CGREG: 0,1 OK AT+QGNSSEPO=1 OK AT+QGNSSEPO? +QGNSSEPO: 1,2 OK //Enable EPOTM function. //Read EPOTM status. 3.6. AT+QGREFLOC AT+QGREGLOC=? //Test command +QGREFLOC: , l OK te AT+QGREFLOC=31.507985,117.119750 OK uec tial 3.7. AT+QGEPOAID Q n AT+QGNSSC=1 OK e AT+CREG?;+CGREG? fid +CREG: 0,1 //Power on GNSS. //Check network status. +CGREG: 0,1 n OK o AT+QGNSSTS? C +QGNSSTS: 1 //Inquire time synchronization status. OK AT+QGNSSEPO=1 OK AT+QGEPOAID OK MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 16 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual 3.8. AT+QGEPOF AT+QGEPOF=? //Test command +QGEPOF: (0-2),(1-3,255) OK AT+QGEPOF=0,255 //Get EPOTM file size. +QGEPOF: -9,48384,48384 OK AT+QGEPOF=2 //Query validity period of EPOTM files. +QGEPOF: 2017-02-19 00:00:00 OK AT+QGEPOF=1,255 OK l AT+QGEPOF=0,255 +QGEPOF: -9,-9,-9 //Delete all EPOTM files. te OK c l AT+QGEPOF=2 ue tia +QGEPOF:-9 OK Q en 3.9. Complete Example for QuecFastFix Online fid AT+QGNSSC=1 OK AT+QIFGCNT=2 n OK o AT+QICSGP=1,'CMNET' OK C AT+QGNSSTS? //Power on GNSS. //Read time synchronization status. +QGNSSTS: 0 OK AT+CREG?;+CGREG? +CREG: 0,2 //Check network status. +CGREG: 0,2 OK MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 17 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual AT+CREG?;+CGREG? +CREG: 0,1 //Check network status. +CGREG: 0,1 OK AT+QGNSSTS? +QGNSSTS: 1 //Read time synchronization status. //Time synchronization completed. OK AT+QGREFLOC=31.507985,117.119750 //Set reference location information for QuecFastFix Online. OK AT+QGNSSEPO=1 //Enable EPOTM function. OK AT+QGEPOAID //Trigger EPOTM function. OK l AT+QGNSSRD? +QGNSSRD: $GNRMC,032220.291,V,,,,,0.00,0.00,140716,,,N*5D te $GNVTG,0.00,T,,M,0.00,N,0.00,K,N*2C $GNGGA,032220.291,,,,,0,0,,,M,,M,,*5D c l $GPGSA,A,1,,,,,,,,,,,,,,,*1E ue tia $BDGSA,A,1,,,,,,,,,,,,,,,*0F $GPGSV,2,1,07,23,,,31,08,,,49,30,,,33,16,,,45*7E $GPGSV,2,2,07,07,,,44,27,,,49,26,,,43*72 $BDGSV,1,1,03,10,,,47,04,,,40,07,,,48*62 Q n $GNGLL,,,,,032220.291,V,N*6F e OK fid AT+QGNSSRD? +QGNSSRD: $GNRMC,032221.301,V,,,,,0.00,0.00,140716,,,N*54 $GNVTG,0.00,T,,M,0.00,N,0.00,K,N*2C n $GNGGA,032221.301,,,,,0,0,,,M,,M,,*54 $GPGSA,A,1,,,,,,,,,,,,,,,*1E o $BDGSA,A,1,,,,,,,,,,,,,,,*0F C $GPGSV,2,1,07,23,,,31,08,,,49,30,,,33,16,,,45*7E $GPGSV,2,2,07,07,,,44,27,,,49,26,,,43*72 $BDGSV,1,1,03,10,,,47,04,,,40,07,,,48*62 $GNGLL,,,,,032221.301,V,N*66 OK … AT+QGNSSRD? +QGNSSRD: $GNRMC,032225.306,A,3150.7859,N,11711.9215,E,0.06,204.08,140716,,,A*70 $GNVTG,204.08,T,,M,0.06,N,0.11,K,A*2B MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 18 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual $GNGGA,032225.306,3150.7859,N,11711.9215,E,1,9,1.54,35.0,M,0.0,M,,*40 $GPGSA,A,3,08,30,16,07,27,26,,,,,,,1.75,1.54,0.83*00 $BDGSA,A,3,10,04,07,,,,,,,,,,1.75,1.54,0.83*19 $GPGSV,3,1,09,08,70,004,49,07,55,309,44,42,45,141,,27,38,040,49*7D $GPGSV,3,2,09,16,28,079,45,30,28,317,31,26,06,096,43,193,,,*7C $GPGSV,3,3,09,23,,,28*7B $BDGSV,1,1,03,07,74,113,48,10,74,329,47,04,32,119,40*51 $GNGLL,3150.7859,N,11711.9215,E,032225.306,A,A*4A OK AT+QGNSSRD? +QGNSSRD: $GNRMC,032225.306,A,3150.7859,N,11711.9215,E,0.06,204.08,140716,,,A*70 $GNVTG,204.08,T,,M,0.06,N,0.11,K,A*2B $GNGGA,032225.306,3150.7859,N,11711.9215,E,1,9,1.54,35.0,M,0.0,M,,*40 $GPGSA,A,3,08,30,16,07,27,26,,,,,,,1.75,1.54,0.83*00 $BDGSA,A,3,10,04,07,,,,,,,,,,1.75,1.54,0.83*19 l $GPGSV,3,1,09,08,70,004,49,07,55,309,44,42,45,141,,27,38,040,49*7D $GPGSV,3,2,09,16,28,079,45,30,28,317,31,26,06,096,43,193,,,*7C te $GPGSV,3,3,09,23,,,28*7B $BDGSV,1,1,03,07,74,113,48,10,74,329,47,04,32,119,40*51 c l $GNGLL,3150.7859,N,11711.9215,E,032225.306,A,A*4A CQounefidentia OK MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 19 / 21 GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual 4 Appendix A References 4.1. Related Documents Table 2: Related Documents SN Document Name l [1] NMEA 0183 Version 3.01 te [2] Quectel_MC20_Series_Hardware_Design Remark Standard for Interfacing Marine Electronic Devices MC20 series hardware design c l [3] Quectel_MC20_GNSS_AGPS_Application_Note MC20 GNSS AGPS application note Que ntia 4.2. Terms and Abbreviations fide Table 3: Terms and Abbreviations Abbreviation n GGA Co GLL Description Global Positioning System Fixed Data Geographic Latitude and Longitude GNSS Global Navigation Satellite System GSA GNSS DOP and Active Satellites GSM Global System for Mobile Communication GSV GNSS Satellites in View ID Identification MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 20 / 21 ME NMEA RMC UART UTC VTG GSM/GPRS/GNSS Module Series MC20 Series GNSS AT Commands Manual Mobile Equipment National Marine Electronics Association Recommended Minimum Specific GNSS Data Universal Asynchronous Receiver & Transmitter Coordinated Universal Time Course Over Ground and Ground Speed 4.3. Summary of CME ERROR Codes Related to GNSS l Table 4: Different Coding Schemes of +CME ERROR Related to GNSS: te Code of c l 7101 ue tia 7102 CQonfiden 7103 Meaning Invalid parameter Not supported Operation failed MC20_Series_GNSS_AT_Commands_Manual Confidential / Released 21 / 21

EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 LTE Standard 模块系列 版本：1.2 日期：2023-05-08 状态：受控文件 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登陆网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评估 和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管移远 通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基础上提 供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用于 除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对此 类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作品。 移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标权的许 可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予许可。对 于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为，移远通 信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、商 号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不侵 犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他硬 软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持生产 的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商或 您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况下 保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护和数 据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除非 另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的最大 范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 文档历史 修订记录 版本 1.0 1.1 1.2 日期 2019-10-23 2019-10-23 作者 Don XU Don XU 2020-09-04 Don XU 2023-05-08 Don XU 变更表述 文档创建 受控版本 1. 更新 gpsOneXTRA 二进制文件下载 URL（第 1.4 章）。 2. 修改 AT+QGPSCFG='dpoenable'配置为立即生效且重启 后恢复至默认值（第 2.2.9 章）。 3. 更 新 AT+QGPSCFG='agpsposmode' 命 令 参数描述（第 2.2.14 章）。 4. 更新 AT+QGPS 描述（第 2.4 章）。 5. 更新 AT+QGPSGNMEA 描述（第 2.9 章）。 1. 更新适用模块： ⚫ 新增适用模块 EG21-GL 和 EG25-GL； ⚫ 更新 EC20 R2.1 为 EC20-CE。 2. 新增命令的最大响应时间（第 2.2 章~第 2.12 章）。 3. 更新 AT+QGPSCFG='dpoenable'中的参 数描述（第 2.2.9 章）。 4. 更 新 AT+QGPSCFG='agpsposmode' 中 的参数取值范围和默认值（第 2.2.14 章）。 5. 新增如下命令： ⚫ AT+QGPSCFG='lbsapn'（第 2.2.15 章）。 ⚫ AT+QGPSPPI（第 2.13 章）。 6. 新增有关 NMEA 语句输出频率的备注（第 2.2.17 章）。 7. 新增关于模块断电重启时注意事项的备注（第 3.3 章）。 8. 新增错误代码 509、510 和 511（第 4 章）。 上海移远通信技术股份有限公司 3 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 表格索引 ....................................................................................................................................................... 6 1 引言 ....................................................................................................................................................... 7 1.1. 适用模块 ..................................................................................................................................... 7 1.2. 打开/关闭 GNSS 步骤 ................................................................................................................ 8 1.3. 支持的 NMEA 语句类型.............................................................................................................. 8 1.4. gpsOneXTRA 辅助技术简介 ...................................................................................................... 9 2 AT 命令详解 ........................................................................................................................................ 11 2.1. AT 命令说明 ............................................................................................................................. 11 2.1.1. 定义 ............................................................................................................................... 11 2.1.2. AT 命令语句 .................................................................................................................. 11 2.1.3. AT 示例声明 .................................................................................................................. 11 2.2. AT+QGPSCFG 配置 GNSS .................................................................................................. 12 2.2.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 ................................................ 12 2.2.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句..... 13 2.2.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 ......................... 14 2.2.4. AT+QGPSCFG='glonassnmeatype' 配置 GLONASS NMEA 语句的输出类型......... 15 2.2.5. AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 ................. 16 2.2.6. AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型..................... 16 2.2.7. AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统................................ 17 2.2.8. AT+QGPSCFG='odpcontrol' 配置 ODP 模式............................................................ 18 2.2.9. AT+QGPSCFG='dpoenable' 打开/关闭 DPO 模式.................................................... 19 2.2.10. AT+QGPSCFG='gsvextnmeatype' 启用/禁用 GNSS 扩展 GGSV 语句.................... 19 2.2.11. AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 ................................. 20 2.2.12. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 ................................................. 21 2.2.13. AT+QGPSCFG='suplver' 配置 SUPL 协议版本 ........................................................ 22 2.2.14. AT+QGPSCFG='agpsposmode' 配置 AGPS 定位模式 ............................................ 22 2.2.15. AT+QGPSCFG='lbsapn' 配置 AGNSS 定位 APN..................................................... 24 2.2.16. AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议.......................................... 25 2.2.17. AT+QGPSCFG='fixfreq' 配置 NMEA 输出频率......................................................... 26 2.3. AT+QGPSDEL 删除辅助数据................................................................................................ 27 2.4. AT+QGPS 打开 GNSS .......................................................................................................... 27 2.5. AT+QGPSEND 关闭 GNSS .................................................................................................. 29 2.6. AT+QGPSLOC 获取定位信息 ............................................................................................... 29 2.7. AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL............................................................... 31 2.8. AT+QGPSSUPLCA 导入 SUPL 证书 .................................................................................... 32 2.9. AT+QGPSGNMEA 获取 NMEA 语句 .................................................................................... 33 2.10. AT+QGPSXTRA 启用/禁用 gpsOneXTRA 辅助功能 ............................................................ 35 2.11. AT+QGPSXTRATIME 注入 gpsOneXTRA 时间 ................................................................... 36 2.12. AT+QGPSXTRADATA 注入 gpsOneXTRA 数据文件 ........................................................... 37 上海移远通信技术股份有限公司 4 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.13. AT+QGPSPPI 获取 GNSS 定位辅助信息 ............................................................................. 38 3 举例 ..................................................................................................................................................... 39 3.1. 打开与关闭 GNSS .................................................................................................................... 39 3.2. GNSS 参数的应用 .............................................................................................. 39 3.3. gpsOneXTRA 辅助功能的操作步骤 ......................................................................................... 40 4 错误代码 .............................................................................................................................................. 41 5 附录 参考文档及术语缩写 .................................................................................................................. 43 上海移远通信技术股份有限公司 5 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 表格索引 表 1：适用模块 ............................................................................................................................................. 7 表 2：AT 命令类型 ..................................................................................................................................... 11 表 3：错误代码列表.................................................................................................................................... 41 表 4：参考文档 ........................................................................................................................................... 43 表 5：术语缩写 ........................................................................................................................................... 43 上海移远通信技术股份有限公司 6 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 1 引言 移远通信 LTE Standard EC2x、EG2x、EG9x 和 EM05 系列模块内部集成 GNSS 引擎，支持 GPS、 BDS、Galileo 和 GLONASS 系统以及 gpsOneXTRA 辅助技术。高性能 GNSS 引擎适用于各类有低成本、 精确定位需求的应用场景，并支持在无需任何网络协助下进行位置跟踪。这使 EC2x、EG2x、EG9x 和 EM05 系列模块广泛应用于如下领域：逐向道路导航、资产跟踪、人员跟踪、位置感知游戏以及家庭和车队管理。 1.1. 适用模块 表 1：适用模块 模块系列 EC2x EG2x EG9x - 模块 EC20-CE EC20-CN EC21 系列 EC25 系列 EG21-G EG21-GL EG25-G EG25-GL EG91 系列 EG95 系列 EM05 系列 上海移远通信技术股份有限公司 7 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 1.2. 打开/关闭 GNSS 步骤 EC2x、EG2x、EG9x 和 EM05 系列模块的 GNSS 支持位置计算功能，且无需网络协助。打开或关闭 GNSS 的步骤如下： 步骤 1：通过 AT+QGPSCFG 配置 GNSS 参数。 步骤 2：通过 AT+QGPS 打开 GNSS。 步骤 3：打开 GNSS，定位成功后，可通过以下三种方式获取定位信息： 1) NMEA 语句默认输出至'usbnmea'端口，可以通过读取该端口获取 NMEA 语句。 2) 通过 AT+QGPSLOC 可直接获取定位信息，例如纬度、经度、高度、GNSS 定位模 式、时间、卫星数量等。 3) 通 过 设 置 AT+QGPSCFG='nmeasrc',1 启 用 之 后 ， 可 以 通 过 AT+QGPSGNMEA 获 取 指 定 的 NMEA 语 句 。 如 果 禁 用 ， AT+QGPSGNMEA 将无法使用。 步骤 4：执行 AT+QGPSEND 关闭 GNSS。 1.3. 支持的 NMEA 语句类型 模块默认支持的 NMEA 语句与 NMEA 0183 协议兼容。另外，可以通过四种不同的前缀区分不同卫星 系统的 NMEA 语句，如下所示： GPS NMEA 语句的前缀为'GP'，如下所示： ⚫ GPGGA - 全球定位系统定位数据，如时间、定位等 ⚫ GPRMC - 推荐的最小具体 GNSS 数据 ⚫ GPGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ GPGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GPVTG - 矢量跟踪与对地速度 GLONASS NMEA 语句的前缀为'GL'和'GN'，如下所示： ⚫ GLGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ GNGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 ⚫ GNGNS - GNSS 定位数据 Galileo NMEA 语句的前缀为'GA'，如下所示： ⚫ GAGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 BDS NMEA 语句的前缀为'PQ'，如下所示： ⚫ PQGSV - 可见的 GNSS 卫星，例如可见的卫星数、卫星 ID 号等 ⚫ PQGSA - 参与定位的 GNSS 卫星 ID 号、精度因子等 上海移远通信技术股份有限公司 8 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 1.4. gpsOneXTRA 辅助技术简介 gpsOneXTRA 辅助技术能够提高 GNSS 的性能，提供简化的 GNSS 辅助，包括对 GNSS 引擎的星历、 年历、电离层、UTC、健康方面和粗略时间的辅助。激活 gpsOneXTRA 辅助后，首次定位时间（TTFF）减 少 18~30 秒（信号弱的恶劣环境下减少更多）。从 gpsOneXTRA 辅助网络服务器获取的辅助数据需在过期 前及时更新。 使用此功能前，首先请确保有效的 gpsOneXTRA 辅助数据的可用性，需要从如下所列的 URL 地址中 下载一份新的 gpsOneXTRA 二进制文件，文件中包含某个 gpsOneXTRA 辅助网络服务器的数据。 ⚫ GPS + GLONASS 系统的数据文件后缀名为'xtra2.bin'： http://xtrapath4.izatcloud.net/xtra2.bin http://xtrapath5.izatcloud.net/xtra2.bin http://xtrapath6.izatcloud.net/xtra2.bin ⚫ GPS + GLONASS + BDS 系统的数据文件后缀名为'xtra3grc.bin'： http://xtrapath4.izatcloud.net/xtra3grc.bin http://xtrapath5.izatcloud.net/xtra3grc.bin http://xtrapath6.izatcloud.net/xtra3grc.bin ⚫ GPS + GLONASS + BDS + Galileo 系统的数据文件后缀名为'xtra3grcej.bin'1)： http://xtrapath4.izatcloud.net/xtra3grcej.bin http://xtrapath5.izatcloud.net/xtra3grcej.bin http://xtrapath6.izatcloud.net/xtra3grcej.bin 备注 1) 本文的适用模块并不全部支持后缀名为'xtra3grcej.bin'的 GPS + GLONASS + BDS + Galileo 系统 数据文件。详细信息请联系移远通信技术支持。 gpsOneXTRA 辅 助 数 据 需 定 期 更 新 。 在 更 新 gpsOneXTRA 辅 助 数 据 之 前 ， 可 通 过 AT+QGPSXTRADATA?查询 gpsOneXTRA 数据文件的状态。 gpsOneXTRA 辅助功能的操作步骤如下： 步骤 1：默认关闭 gpsOneXTRA 辅助功能，可通过 AT+QGPSXTRA=1 开启。 步骤 2：通过 AT+QGPSXTRADATA?查询并确认 gpsOneXTR 数据文件的当前有效性。如果数据无 效，请执行步骤 3~步骤 6；如果数据有效，请根据第 1.2 章所述步骤直接打开 GNSS 引擎。 步骤 3：根据上述所列的 URL 地址，将文件名后缀为'xtra2.bin'或'xtra3grc.bin'的文件下载到模 块。 步骤 4：通过 AT+QGPSXTRATIME 向 GNSS 引擎注入正确的 gpsOneXTRA 时间。 上海移远通信技术股份有限公司 9 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 步骤 5：通过 AT+QGPSXTRADATA 向 GNSS 引擎注入有效的 gpsOneXTRA 数据文件。 步骤 6：根据第 1.2 章所述步骤打开 GNSS 引擎。 备注 步骤 1 开始之前，需要确保已经关闭 GNSS 引擎。 有关上述 AT 命令的详细信息，可参考第 2.10、2.11 及 2.12 章。 上海移远通信技术股份有限公司 10 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2 AT 命令详解 2.1. AT 命令说明 2.1.1. 定义 ⚫ 回车符。 ⚫ 换行符。 ⚫ 参数名称。实际命令行中不包含尖括号。 ⚫ […] 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 ⚫ 下划线 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中表现命令和响应的表格中，省略了，仅 显示命令和响应。 表 2：AT 命令类型 AT 命令类型 语句 测试命令 AT+=? 查询命令 AT+? 描述 测试是否存在相应的命令，并返回有关其参数的 类型、值或范围的信息。 查询相应命令的当前参数值。 设置命令 AT+=[,[,[...]]] 设置用户可定义的参数值。 执行命令 AT+ 返回特定的参数信息或执行特定的操作。 2.1.3. AT 示例声明 本文中的示例仅为方便用户了解 AT 命令的使用方法，不构成移远通信对终端流程设计的建议或意见， 也不代表模块应被设置成相应示例中的状态。某些 AT 命令存在多个示例，这些示例之间不存在承接关系或 连续性。 上海移远通信技术股份有限公司 11 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.2. AT+QGPSCFG 配置 GNSS 该命令用于查询和配置 GNSS 不同的设置，包括 NMEA 语句输出端口、NMEA 语句的输出类型等。 AT+QGPSCFG 配置 GNSS 测试命令 AT+QGPSCFG=? 响应 +QGPSCFG: 'outport',(支持的列表) +QGPSCFG: 'nmeasrc',(支持的列表) +QGPSCFG: 'gpsnmeatype',(支持的 范围) +QGPSCFG: 'glonassnmeatype',(支持的范围) +QGPSCFG: 'galileonmeatype',(支持的列表) +QGPSCFG: 'beidounmeatype',(支持的范围) +QGPSCFG: 'gnssconfig',(支持的范围) +QGPSCFG: 'odpcontrol',(支持的范围) +QGPSCFG: 'dpoenable',(支持的范围) +QGPSCFG: 'gsvextnmeatype',(支持的列表) +QGPSCFG: 'plane',(支持的范围) +QGPSCFG: 'autogps',(支持的列表) +QGPSCFG: 'suplver',(支持的列表) +QGPSCFG: 'agpsposmode',(支持的 范围) +QGPSCFG: 'lbsapn',(支持的范围),(支持 的范围),() +QGPSCFG: 'agnssprotocol',(支持的范围), (支持的范围) +QGPSCFG: 'fixfreq',(支持的列表) OK 2.2.1. AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 该命令用于配置 NMEA 语句输出端口。 AT+QGPSCFG='outport' 配置 NMEA 语句输出端口 设置命令 AT+QGPSCFG='outport'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'outport', 上海移远通信技术股份有限公司 12 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 最大响应时间 特性说明 参数 OK 若指定可选参数，则配置 NMEA 语句输出端口： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 字符串类型。配置 NMEA 语句输出端口。 'none' 关闭 NMEA 语句输出 'usbnmea' 通过 USB NMEA 口输出 'uartdebug' 通过 Debug UART 口输出 整型。操作错误码。详细信息可参考第 4 章。 2.2.2. AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 该命令用于启用或禁用通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc' 启用/禁用通过 AT+QGPSGNMEA 获取 NMEA 语句 设置命令 AT+QGPSCFG='nmeasrc'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'nmeasrc', OK 若指定可选参数，则配置是否启用通过 AT+QGPSGNMEA 获 取 NMEA 语句： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 上海移远通信技术股份有限公司 13 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 最大响应时间 特性说明 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。若使能，则可通过 AT+QGPSGNMEA 获取原始的 NMEA 语句。同时，语句 将以命令返回值的形式通过 AT 口输出。 0 禁用 1 启用 整型。操作错误码。详细信息可参考第 4 章。 2.2.3. AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 该命令用于配置 GPS NMEA 语句的输出类型。 AT+QGPSCFG='gpsnmeatype' 配置 GPS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='gpsnmeatype'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gpsnmeatype', OK 若指定可选参数，则配置 GPS NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。异或运算格式的 GPS NMEA 语句类型输出设置。 0 禁用 1 GPGGA 2 GPRMC 上海移远通信技术股份有限公司 14 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 4 GPGSV 8 GPGSA 16 GPVTG 31 输出全部 5 种类型语句 整型。操作错误码。详细信息可参考第 4 章。 2.2.4. AT+QGPSCFG='glonassnmeatype' 配置 GLONASS NMEA 语句的输出类型 该命令用于配置 GLONASS NMEA 语句的输出类型。 AT+QGPSCFG='glonassnmeatype' 配置 GLONASS NMEA 语句的输出类型 设置命令 AT+QGPSCFG='glonassnmeatype'[, ] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'glonassnmeatype', OK 若指定可选参数，则配置 GLONASS NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。异或运算格式的 GLONASS NMEA 语句类型输出设置。 0 禁用 1 GLGSV 2 GNGSA 4 GNGNS 整型。操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 15 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.2.5. AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 该命令用于配置 Galileo NMEA 语句的输出类型。 AT+QGPSCFG='galileonmeatype' 配置 Galileo NMEA 语句的输出类型 设置命令 AT+QGPSCFG='galileonmeatype'[,< Galileo_NMEA_type>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'galileonmeatype', OK 若指定可选参数，则配置 Galileo NMEA 语句的输出类型： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。异或运算格式的 Galileo NMEA 语句类型输出设置。 0 禁用 1 GAGSV 整型。操作错误码。详细信息可参考第 4 章。 2.2.6. AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型 该命令用于配置 BDS NMEA 语句的输出类型。 AT+QGPSCFG='beidounmeatype' 配置 BDS NMEA 语句的输出类型 设置命令 响应 AT+QGPSCFG='beidounmeatype'[, 若省略可选参数，则查询当前配置： ] +QGPSCFG: 'beidounmeatype', OK 若指定可选参数，则配置 BDS NMEA 语句的输出类型： 上海移远通信技术股份有限公司 16 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 最大响应时间 特性说明 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。异或运算格式的 BDS NMEA 语句类型输出设置。 0 禁用 1 PQGSA 2 PQGSV 整型。操作错误码。详细信息可参考第 4 章。 2.2.7. AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统 该命令用于配置支持的 GNSS 卫星导航系统。 AT+QGPSCFG='gnssconfig' 配置支持的 GNSS 卫星导航系统 设置命令 AT+QGPSCFG='gnssconfig'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gnssconfig', OK 若省略可选参数，则配置支持的 GNSS 卫星导航系统： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 上海移远通信技术股份有限公司 17 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 参数 整型。支持的 GNSS 卫星导航系统，始终打开 GPS。 0 关闭 GLONASS/关闭 BDS/关闭 Galileo 1 打开 GLONASS/打开 BDS/打开 Galileo 2 打开 GLONASS/打开 BDS/关闭 Galileo 3 打开 GLONASS/关闭 BDS/打开 Galileo 4 打开 GLONASS/关闭 BDS/关闭 Galileo 5 关闭 GLONASS/打开 BDS/打开 Galileo 6 关闭 GLONASS/关闭 BDS/打开 Galileo 7 关闭 GLONASS/打开 BDS/关闭 Galileo 整型。操作错误码。详细信息可参考第 4 章。 2.2.8. AT+QGPSCFG='odpcontrol' 配置 ODP 模式 该命令用于配置 ODP 模式。 AT+QGPSCFG='odpcontrol' 配置 ODP 模式 设置命令 AT+QGPSCFG='odpcontrol'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'odpcontrol', OK 若指定可选参数，则配置 ODP 模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。设置 ODP 模式。 0 禁用 ODP 1 休眠模式 2 准备就绪模式 上海移远通信技术股份有限公司 18 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 整型。操作错误码。详细信息可参考第 4 章。 2.2.9. AT+QGPSCFG='dpoenable' 打开/关闭 DPO 模式 该命令用于打开或关闭 DPO 模式。 AT+QGPSCFG='dpoenable' 打开/关闭 DPO 模式 设置命令 AT+QGPSCFG='dpoenable'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'dpoenable', OK 若指定可选参数，则配置 DPO 模式： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。启用或禁用 DPO。 0 禁用 DPO 1 使用动态占空比启用 DPO 2 当模块未连接外部电源且仅使用电池运行时，启用 DPO 整型。操作错误码。详细信息可参考第 4 章。 2.2.10. AT+QGPSCFG='gsvextnmeatype' 启用/禁用 GNSS 扩展 GGSV 语句 该命令用于启用或禁用 GNSS 扩展 GGSV 语句。 AT+QGPSCFG='gsvextnmeatype' 启用/禁用 GNSS 扩展 GGSV 语句 设置命令 AT+QGPSCFG='gsvextnmeatype'[,< gsvext_NMEA_type>] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'gsvextnmeatype', 上海移远通信技术股份有限公司 19 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 最大响应时间 特性说明 OK 若指定可选参数，则配置 GNSS 扩展 GGSV 语句： OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。禁用或启用扩展 GGSV 语句。 0 禁用 1 启用 整型。操作错误码。详细信息可参考第 4 章。 2.2.11. AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 该命令用于配置 MO AGPS 会话要使用的平面模式（控制平面或用户平面）。 AT+QGPSCFG='plane' 配置 MO AGPS 会话使用的平面模式 设置命令 AT+QGPSCFG='plane'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'plane', OK 若指定可选参数，则配置 AGPS 平面模式： OK 或者 ERROR 最大响应时间 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 上海移远通信技术股份有限公司 20 / 44 特性说明 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。MO AGPS 会话使用的平面模式。 0 无 SSL 的用户平面 1 具有 SSL 的用户平面 2 控制平面 整型。操作错误码。详细信息可参考第 4 章。 2.2.12. AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 该命令用于配置在设备重启时，是否自动运行 GNSS。 AT+QGPSCFG='autogps' 启用/禁用 GNSS 自启动 设置命令 AT+QGPSCFG='autogps'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'autogps', OK 若指定可选参数，则配置是否启用 GNSS 自动运行： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。模块开机后，启用或禁用 GNSS 自动运行。 0 禁用 GNSS 自动运行 1 启用 GNSS 自动运行 整型。操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 21 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.2.13. AT+QGPSCFG='suplver' 配置 SUPL 协议版本 该命令用于在 SI 会话中配置 SUPL 版本，以及在 NI 会话中配置最可能使用的 SUPL 版本。 AT+QGPSCFG='suplver' 配置 SUPL 协议版本 设置命令 响应 AT+QGPSCFG='suplver'[,] +QGPSCFG: 'suplver', OK 若指定可选参数，则配置 SUPL 协议版本： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。SUPL 协议版本。 1 SUPL V1.0 2 SUPL V2.0 整型。操作错误码。详细信息可参考第 4 章。 2.2.14. AT+QGPSCFG='agpsposmode' 配置 AGPS 定位模式 该命令用于配置 AGPS 定位模式。 AT+QGPSCFG='agpsposmode' 配置 AGPS 定位模式 设置命令 AT+QGPSCFG='agpsposmode'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'agpsposmode', OK 若指定可选参数，则配置 AGPS 模式： 上海移远通信技术股份有限公司 22 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 最大响应时间 特性说明 OK 或者 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。AGPS 定位模式。不同 bit 位代表不同模式，详细信息可见下图。bit 位设 置为 1 即启用相应模式。范围：0~4294967295；默认值：33488767 或 775。 整型。操作错误码。详细信息可参考第 4 章。 备注 当插入中国联通/中国电信/中国移动(U)SIM 卡时，的默认值为 775。当插入其他卡 时，的默认值为 33488767。 上海移远通信技术股份有限公司 23 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.2.15. AT+QGPSCFG='lbsapn' 配置 AGNSS 定位 APN 该命令用于配置 AGNSS 定位 APN。 AT+QGPSCFG='lbsapn' 配置 AGNSS 定位 APN 设置命令 AT+QGPSCFG='lbsapn'[,,,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'lbsapn',,, OK 若指定可选参数，则配置 AGNSS 定位 APN： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。异或运算格式的服务系统类型。范围：0~31。 0 禁用 1 CDMA 2 HDR 4 GSM 8 WCDMA 16 LTE 整型。异或运算格式的 PDP 类型。 0 禁用 1 IPv4 2 IPv6 3 IPv4v6 4 PPP 字符串类型。配置 APN 名称。例如'CMNET'和'CTNET'。默认值：NULL。 整型。操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 24 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.2.16. AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议 该命令用于配置 AGPS LPP 定位协议和 AGLONASS 定位协议。 AT+QGPSCFG='agnssprotocol' 配置 AGNSS 定位协议 设置命令 AT+QGPSCFG='agnssprotocol'[,,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'agnssprotocol',, OK 若指定可选参数，则配置 LPP 协议： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。AGPS LPP 定位协议。异或运算格式。默认值：3。 1 用户平面 LPP 2 控制平面 LPP 整型。AGLOSNASS LPP 定位协议。异或运算格式。默认值：1287。 1 控制平面 RRLP 2 控制平面 RRC 4 控制平面 LPP 256 用户平面 RRLP 1024 用户平面 LPP 整型。操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 25 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.2.17. AT+QGPSCFG='fixfreq' 配置 NMEA 输出频率 该命令用于配置 NMEA 语句输出频率，发送该命令前需要关闭 GNSS 引擎。设置 NMEA 输出频率高 于 1 Hz 后，NMEA 输出会按照设置的频率输出 GGA、RMC、VTG、GSA 语句，GSV 语句输出频率始终 是 1 Hz。 AT+QGPSCFG='fixfreq' 配置 NMEA 输出频率 设置命令 AT+QGPSCFG='fixfreq'[,] 响应 若省略可选参数，则查询当前配置： +QGPSCFG: 'fixfreq', OK 若指定可选参数，则配置 NMEA 输出频率： OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令在模块重启后生效； 参数配置自动保存至 NVRAM。 参数 整型。NMEA 语句输出频率。 1 1 Hz 2 2 Hz 5 5 Hz 10 10 Hz 整型。操作错误码。详细信息可参考第 4 章。 备注 1. 部分模块型号及软件基线不支持该功能，详细信息可咨询移远通信技术支持。 2. 针对'R06'的固件版本，如 EC25JLFAR06A01M4，NMEA 语句输出频率设置为 5 Hz，实际生效 为 4 Hz。 上海移远通信技术股份有限公司 26 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.3. AT+QGPSDEL 删除辅助数据 该命令用于删除辅助数据，以便进行 GNSS 冷启动、热启动和温启动操作，且仅可在 GNSS 关闭时执 行。使用该命令删除辅助数据后，可通过 AT+QGPS 强制对 GNSS 进行冷启动。满足相应的条件时，也可 以进行热/温启动。 AT+QGPSDEL 删除辅助数据 测试命令 AT+QGPSDEL=? 响应 +QGPSDEL: (支持的范围) 设置命令 AT+QGPSDEL= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效。 参数 整型。将要删除的 GNSS 辅助数据类型。 0 删除所有辅助数据。开启 GNSS 后强制冷启动。 1 不删除数据。开启 GNSS 后，条件允许时进行热启动。 2 删除部分相关数据，开启 GNSS 后，条件允许时进行温启动。 3 删除注入 GNSS 引擎的 gpsOneXTRA 辅助数据。 整型。操作错误码。详细信息可参考第 4 章。 2.4. AT+QGPS 打开 GNSS 该命令用于打开 GNSS 功能。当为 0 时，GNSS 引擎将持续定位，用户可以通过 AT+QGPSEND 终止会话；当不为 0 且实际定位次数达到指定值时，GNSS 引擎将自动停止。 AT+QGPS 打开 GNSS 测试命令 AT+QGPS=? 响应 +QGPS: ( 支 持 的 范 围 ),( 支 持 的 上海移远通信技术股份有限公司 27 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 范 围 ),( 支 持 的 范 围 ),( 支 持 的 范围),(支持的范围) OK 查询命令 查询当前 GNSS 会话状态 响应 +QGPS: AT+QGPS? OK 设置命令 响应 AT+QGPS=[,[,[,[,< 或者 fix_rate>]]]] ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。GNSS 状态。 0 GNSS 关闭 1 GNSS 打开 整型。GNSS 工作模式。 1 独立模式 2 MSB 3 MSA 4 快速定位 整型。最长定位时间，包括测量 GNSS 伪距期间的反应时间、GPS 卫星搜索的时 间上限、解调星历数据的时间以及计算位置的时间。范围：1~255；默认值：255； 单位：秒。 整型。定位精度阈值。范围：0~1000；默认值：50；单位：米。 整型。定位次数。范围：0~1000；默认值：0。 0 表示持续定位，其他参数值表示实际定位次数。 整型。第一次与第二次定位的时间间隔。范围：1~65535；默认值：1；单位：秒。 整型。操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 28 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 2.5. AT+QGPSEND 关闭 GNSS 执行 AT+QGPS，打开 GNSS 引擎。当为 0 时，GNSS 引擎将持续定位，可通过 AT+QGPSEND 强制终止定位；当不为 0 且实际定位次数达到指定值时，将会自动终止定位。 AT+QGPSEND 关闭 GNSS 测试命令 AT+QGPSEND=? 查询命令 AT+QGPSEND? 执行命令 AT+QGPSEND 响应 OK 或者 ERROR 响应 OK 或者 ERROR 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效。 参数 整型。操作错误码。详细信息可参考第 4 章。 2.6. AT+QGPSLOC 获取定位信息 该命令用于获取定位信息。执行该命令前，必须通过 AT+QGPS 打开 GNSS。如果定位失败，将根据 对应情况返回+CME ERROR: 。 AT+QGPSLOC 获取定位信息 测试命令 AT+QGPSLOC=? 响应 +QGPSLOC: ,,,,,,,,,, 上海移远通信技术股份有限公司 29 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 设置命令 AT+QGPSLOC= 最大响应时间 特性说明 OK 响应 +QGPSLOC: ,,,,,,,,,, OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。纬度和经度显示格式。 0 ,格式：ddmm.mmmmN/S,dddmm.mmmmE/W 1 ,格式：ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W 2 ,格式：(-)dd.ddddd,(-)ddd.ddddd 字符串类型。UTC 时间。格式：hhmmss.sss（引自 GPGGA 语句）。 字符串类型。纬度。 如果为 0： 格式：ddmm.mmmm N/S（引自 GPGGA 语句） dd 度。范围：00~89 mm.mmm 分。范围：00.0000~59.9999 N/S 北纬/南纬 如果为 1： 格式：ddmm.mmmmmm,N/S（引自 GPGGA 语句） dd 度。范围：00~89 mm.mmmmmm 分。范围：00.000000~59.999999 N/S 北纬/南纬 如果为 2： 格式：(-)dd.ddddd（引自 GPGGA 语句） dd.ddddd 度。范围：-89.99999~89.99999 - 南纬 字符串类型。经度。 如果为 0： 格式：dddmm.mmmmE/W（引自 GPGGA 语句） ddd 度。范围：000~179 上海移远通信技术股份有限公司 30 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 mm.mmmm E/W 分。范围：00.0000~59.9999 东经/西经 如果为 1： 格式：dddmm.mmmmmm,E/W（引自 GPGGA 语句） ddd 度。范围：000~179 mm.mmmmmm 分。范围：00.000000~59.999999 E/W 东经/西经 如果为 2： 格式：(-)ddd.ddddd（引自 GPGGA 语句） ddd.ddddd 度。范围：-179.99999~179.99999 - 西经 水平精度。范围：0.5~99.9（引自 GPGGA 语句）。 天线的海拔高度。单位：米，精确到小数点后一位（引自 GPGGA 语句）。 整型。GNSS 定位模式（引自 GAGSA/GPGSA 语句）。 2 2D 定位 3 3D 定位 字符串类型。以正北方为对地航向。 格式：ddd.mm（引自 GPVTG 语句）。 ddd 度。范围：000~359 mm 分。范围：00~59 对地速度。格式：xxxx.x。单位：千米/时。精确到小数点后一位（引自 GPVTG 语句）。 对地速度。格式：xxxx.x。单位：节。精确到小数点后一位（引自 GPVTG 语句）。 定位时的 UTC 时间。格式：ddmmyy（引自 GPRMC 语句）。 dd 日 mm 月 yy 年 卫星数量。范围：00~12，固定两位数（引自 GPGGA 语句）。 整型。操作错误码。详细信息可参考第 4 章。 2.7. AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL 该命令用于配置 SUPL 服务器地址 URL。 AT+QGPSSUPLURL 设置 SUPL 服务器地址 URL 测试命令 AT+QGPSSUPLURL=? 响应 +QGPSSUPLURL: OK 上海移远通信技术股份有限公司 31 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 查询命令 查询当前 SUPL 服务器地址 AT+QGPSSUPLURL? 设置命令 AT+QGPSSUPLURL= 响应 +QGPSSUPLURL: OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 字符串类型。表示 SUPL 服务器地址。格式为'URL:port_number'（端口号可省略）， 例如'supl.server.com'、'123.123.123.123'或'supl.server.com:7275'。 当端口号省略时，默认端口为 7275。 整型。操作错误码。详细信息可参考第 4 章。 2.8. AT+QGPSSUPLCA 导入 SUPL 证书 该命令用于导入 SUPL 证书。证书文件通过 AT+QFUPL 写入文件系统。关于该 AT 命令的详细信息， 可参考文档 [1]。证书应由运营商或服务器提供商提供。 AT+QGPSSUPLCA 导入 SUPL 证书 测试命令 AT+QGPSSUPLCA=? 响应 +QGPSSUPLCA: 查询命令 AT+QGPSSUPLCA? 设置命令 AT+QGPSSUPLCA= OK 响应 OK 或者 ERROR 响应 OK 或者 上海移远通信技术股份有限公司 32 / 44 最大响应时间 特性说明 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 ERROR 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效。 参数 字符串类型。SUPL 认证名称。 整型。操作错误码。详细信息可参考第 4 章。 2.9. AT+QGPSGNMEA 获取 NMEA 语句 使用该命令前，必须通过 AT+QGPS 打开 GNSS，并将参数设置为 1，然后通过 AT+QGPSGNMEA 获取 NMEA 语句。 用 户 可 以 通 过 AT+QGPSCFG='gpsnmeatype',0 、 AT+QGPSCFG='glonassnmeatype',0 、 AT+QGPSCFG='galileonmeatype',0 和 AT+QGPSCFG='beidounmeatype',0 禁用语句输出。如果禁 用语句输出，依然可以通过 AT+QGPSGNMEA 获取 NMEA 语句，但前提条件是 GNSS 在激活后已经通过 此命令获得了语句。 AT+QGPSGNMEA 获取 NMEA 语句 测试命令 AT+QGPSGNMEA=? 响应 +QGPSGNMEA: (支持的列表) 设置命令 查询 GGA 语句 AT+QGPSGNMEA='GGA' OK 响应 [+QGPSGNMEA: GGA sentence] […] OK 设置命令 查询 RMC 语句 AT+QGPSGNMEA='RMC' 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: RMC sentence] […] 上海移远通信技术股份有限公司 33 / 44 设置命令 查询 GSV 信息 AT+QGPSGNMEA='GSV' 设置命令 查询 GSA 语句 AT+QGPSGNMEA='GSA' 设置命令 查询 VTG 语句 AT+QGPSGNMEA='VTG' 设置命令 查询 GNS 语句 AT+QGPSGNMEA='GNS' 最大响应时间 特性说明 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 OK 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: GSV sentence] […] OK 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: GSA sentence] […] OK 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: VTG sentence] […] OK 若错误与 ME 功能相关： +CME ERROR: 响应 [+QGPSGNMEA: GNS sentence] […] OK 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效。 上海移远通信技术股份有限公司 34 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 参数 字符串类型。NMEA 语句类型。 'GGA' GGA 语句 'RMC' RMC 语句 'GSV' GSV 语句 'GSA' GSA 语句 'VTG' VTG 语句 'GNS' GNS 语句 整型。操作错误码。详细信息可参考第 4 章。 2.10. AT+QGPSXTRA 启用/禁用 gpsOneXTRA 辅助功能 该命令用于启用或禁用 gpsOneXTRA 辅助功能。 AT+QGPSXTRA 启用/禁用 gpsOneXTRA 辅助功能 测试命令 AT+QGPSXTRA=? 响应 +QGPSXTRA: (支持的列表) 查询命令 AT+QGPSXTRA? OK 响应 +QGPSXTRA: 设置命令 AT+QGPSXTRA= OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 整型。启用或禁用 gpsOneXTRA 辅助功能。 0 禁用 gpsOneXTRA 辅助功能 上海移远通信技术股份有限公司 35 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 1 启用 gpsOneXTRA 辅助功能 整型。操作错误码。详细信息可参考第 4 章。 2.11. AT+QGPSXTRATIME 注入 gpsOneXTRA 时间 该命令用于将 gpsOneXTRA 时间注入 GNSS 引擎。使用之前，必须通过 AT+QGPSXTRA=1 启用 gpsOneXTRA 辅助功能。激活该功能后，GNSS 引擎将会请求 gpsOneXTRA 时间和辅助数据文件，另外， 在注入 gpsOneXTRA 数据文件之前，必须通过 AT+QGPSXTRATIME 注入 gpsOneXTRA 时间。 AT+QGPSXTRATIME 注入 gpsOneXTRA 时间 测试命令 AT+QGPSXTRATIME=? 响应 +QGPSXTRATIME: 0,,(支持的列表),(支持 的列表), 设置命令 AT+QGPSXTRATIME=,,,, OK 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效； 参数配置不保存。 参数 整型。注入时间的类型。 0 手动注入 XTRA 时间 字符串类型。当前 UTC 时间。 格式：'yyyy/mm/dd,hh:mm:ss'。例如'2019/01/05,08:30:30'。 整型。参考 UTC/GPS 时间。 0 GPS 时间 1 UTC 时间（推荐使用该值） 整型。是否强制接受数据。 0 不强制接受数据 1 强制接受数据（推荐使用该值） 整型。时间的不确定性，表示向 SNTP 服务器发送请求与从 SNTP 服务器接收响应的时 上海移远通信技术股份有限公司 36 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 间差。默认值：3500；单位：毫秒。 整型。操作错误码。详细信息可参考第 4 章。 2.12. AT+QGPSXTRADATA 注入 gpsOneXTRA 数据文件 该命令用于向 GNSS 引擎注入 gpsOneXTRA 辅助数据文件。执行该命令前，用户需启用 gpsOneXTRA， 将有效的 gpsOneXTRA 数据文件存入模块的 RAM 或 UFS（建议选择 UFS），并将 gpsOneXTRA 时间注 入 GNSS 引擎。该命令执行成功后，可以将 RAM 或 UFS 中的 gpsOneXTRA 数据文件删除。用户可以通 过 AT+QGPSXTRADATA?查询 gpsOneXTRA 数据是否注入成功。 AT+QGPSXTRADATA 注入 gpsOneXTRA 数据文件 测试命令 AT+QGPSXTRADATA=? 响应 +QGPSXTRADATA: 查询命令 查询 gpsOneXTRA 数据文件的状态 AT+QGPSXTRADATA? OK 响应 +QGPSXTRADATA: , OK 设置命令 AT+QGPSXTRADATA= 若错误与 ME 功能相关： +CME ERROR: 响应 OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 1秒 该命令立即生效； 参数配置自动保存至 NVRAM。 参数 字符串类型。gpsOneXTRA 数据文件的文件名称。如：'RAM:xtra2.bin'或者 'RAM:xtra3grc.bin'，其中 RAM 表示实际文件存储区域。 整型。注入 gpsOneXTRA 数据文件的有效时间。单位：分钟。 上海移远通信技术股份有限公司 37 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 0 无 gpsOneXTRA 文件或 gpsOneXTRA 文件过期 1~10080 gpsOneXTRA 文件的有效时间 字符串类型。gpsOneXTRA 数据文件有效时间的开始时间。 格式：'yyyy/mm/dd,hh:mm:ss'，如：'2016/01/03,15:34:50'。 整型。操作错误码。详细信息可参考第 4 章。 2.13. AT+QGPSPPI 获取 GNSS 定位辅助信息 该命令用于获取 GNSS 定位辅助信息。使用该命令前，先通过 AT+QGPS 开启 GNSS，等待定位成功 后才能通过 AT+QGPSPPI 获取 GNSS 定位辅助信息。 AT+QGPSPPI 获取 GNSS 定位辅助信息 测试命令 AT+QGPSPPI=? 响应 +QGPSPPI: (支持的范围) 设置命令 AT+QGPSPPI= OK 响应 +QGPSPPI: OK 或者 ERROR 最大响应时间 特性说明 若错误与 ME 功能相关： +CME ERROR: 300 毫秒 该命令立即生效。 参数 整型。定位辅助数据的类型。 1 圆形水平位置不确定性。单位：米。 2 垂直不确定性。单位：米。 3 水平置信度。单位：百分比。 浮点型。根据得到相应的取值。格式：xxxx.xxx，精确到小数点后三位。 整型。操作错误码。详细信息可参考第 4 章。 上海移远通信技术股份有限公司 38 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 3 举例 3.1. 打开与关闭 GNSS 该示例使用默认参数来打开 GNSS。打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。通过 AT+QGPSEND 可关闭 GNSS。 AT+QGPS=1 //打开 GNSS。 OK //打开 GNSS 后，NMEA 语句默认从'usbnmea'端口输出。 AT+QGPSLOC=0 //获取定位信息 +QGPSLOC: 063416.400,3143.2951N,11713.0655E,0.6,224.9,2,162.57,17.6,9.5,110620,07 OK AT+QGPSEND OK //关闭 GNSS。 3.2. GNSS 参数的应用 打开 GNSS 并将参数设为 1 后，可以直接通过 AT+QGPSGNMEA 获取 NMEA 语句。 AT+QGPSCFG='nmeasrc',1 //将设为 1，使能通过 AT+QGPSGNMEA 获取 NMEA 语句。 OK AT+QGPSGNMEA='GGA' //获取 GGA 语句。 +QGPSGNMEA: $GPGGA,103647.0,3150.721154,N,11711.925873,E,1,02,4.7,59.8,M,-2.0,M,,*77 OK AT+QGPSCFG='nmeasrc',0 OK AT+QGPSGNMEA='GGA' +CME ERROR: 507 //将设为 0，禁用通过 AT+QGPSGNMEA 获取 NMEA 语句。 //禁用通过 AT+QGPSGNMEA 获取 NMEA 语句，因此无法 获取 GGA 语句。 上海移远通信技术股份有限公司 39 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 3.3. gpsOneXTRA 辅助功能的操作步骤 该示例展示了 gpsOneXTRA 辅助功能的操作步骤。 AT+QGPSXTRA=1 //如果 gpsOneXTRA 辅助功能被禁用，先启用 gpsOneXTRA 辅助功能，再按以下步骤操作。 OK //立即激活 gpsOneXTRA 辅助功能。 //如果 gpsOneXTRA 数据文件有效（可通过 AT+QGPSXTRADATA?查询），直接打开 GNSS 引擎。 //如果 gpsOneXTRA 数据文件无效（可通过 AT+QGPSXTRADATA?查询），则执行以下步骤。 //用户可以通过 URL http://xtrapath1.izatcloud.net/xtra2.bin 或第 1.4 章所列的其他 URL 将 gpsOneXTRA 数据文件下载至电脑（或 MCU）。 AT+QFUPL='RAM:xtra2.bin',59748,60 //选择一份 gpsOneXTRA 文件，通过 QCOM 上 传到模块内。有关该 AT 命令和 QCOM 工具的 详细信息，可分别参考文档 [1]和[2]。 OK AT+QGPSXTRATIME=0,'2019/01/05,08:30:30',1,1,3500 //将 gpsOneXTRA 时间注入 GNSS 引擎。 OK AT+QGPSXTRADATA='RAM:xtra2.bin' OK //该 gpsOneXTRA 数据文件已成功注入 GNSS 引擎。 AT+QFDEL='RAM:xtra2.bin' //从 UFS 删除 gpsOneXTRA 数据文件。 OK AT+QGPS=1 //打开 GNSS 引擎。 OK 备注 当模块断电重启时，需要重新注入时间和文件。 上海移远通信技术股份有限公司 40 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 4 错误代码 表示与 GNSS 操作相关的错误，详细的参数值，见下表。 表 3：错误代码列表 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 错误代码 Invalid parameter(s) Operation not supported GNSS subsystem busy Session is ongoing Session not active Operation timeout Function not enabled Time information error XTRA not enabled XTRA file opening failed Bad CRC for XTRA data file Validity time is out of range Internal resource error GNSS locked End by E911 Not fixed now CMUX port is not opened 中文解释 无效参数 操作不支持 GNSS 子系统繁忙 会话仍在进行 会话未激活 操作超时 功能未使能 时间信息错误 XTRA 未使能 XTRA 文件打开失败 XTRA 数据文件 CRC 错误 有效期过期 内部资源错误 GNSS 锁住 由 E911 结束 当前未定位 CMUX 端口为打开 上海移远通信技术股份有限公司 41 / 44 549 Unknown error EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 未知错误 上海移远通信技术股份有限公司 42 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 5 附录 参考文档及术语缩写 表 4：参考文档 文档名称 [1] Quectel_EC2x&EG2x&EG9x&EM05 系列_FILE_应用指导 [2] Quectel_QCOM_User_Guide 表 5：术语缩写 缩写 AGPS APN BDS CDMA CRC DOP DPO Galileo GGA GLONASS 英文全称 Assisted GPS (Global Positioning System) Access Point Name BeiDou Navigation Satellite System Code-Division Multiple Access Cyclic Redundancy Check Dilution of Precision Dynamic Power Optimization Galileo Satellite Navigation System Global Positioning System Fix Data Global Navigation Satellite System GNS New GGA Message For GNSS GNSS GPS Global Navigation Satellite System Global Positioning System 中文全称 辅助全球定位系统 接入点名称 北斗卫星导航系统 码分多址 循环冗余校验 精度因子 动态功率优化 伽利略卫星导航系统 全球定位系统定位数据 格洛纳斯导航卫星系统（俄罗斯） 全球导航卫星系统新的全球定位 系统定位数据（高通命名数据） 全球导航卫星系统 全球定位系统 上海移远通信技术股份有限公司 43 / 44 EC2x&EG2x&EG9x&EM05 系列 GNSS 应用指导 gpsOneXTRA GSA GSM An Auxiliary Positioning Technology Provided by Qualcomm GPS DOP and Active Satellites 高通提供的辅助定位技术 GNSS 精度因子（DOP）与有效 卫星 Global System for Mobile Communications 全球移动通信系统 GSV GNSS Satellites in View 可视的GNSS卫星 HDR High Data Rate 高速数据速率 MCU Micro Control Unit 微型控制单元 ME Mobile Equipment 移动设备 MS NMEA NVRAM Mobile Station 移动台 NMEA (National Marine Electronics Association) NMEA（美国国家海洋电子协会） 0183 Interface Standard 0183 接口标准 Non-Volatile Random Access Memory 非易失性随机访问存储器 ODP On-Demand Positioning 按需定位 PC Personal Computer 私人电脑 PPP Point-to-Point Protocol 点到点协议 RAM Random Access Memory 随机存储器 RMC Recommended Minimum Specific GNSS Data 推荐的最少专用 GNSS 数据 SNR Signal Noise Ratio 信噪比 SNTP Simple Network Time Protocol 简单网络时间协议 TTFF Time to First Fix 首次定位时间 UART Universal Asynchronous Receiver & Transmitter 通用异步收发传输器 UFS User File System 用户文件系统 URL Uniform Resource Locator 资源定位符 USB Universal Serial Bus 通用串行总线 UTC Coordinated Universal Time 协调世界时 VTG Course Over Ground and Ground Speed 对地航向和对地速度 WCDMA Wideband Code Division Multiple Access 宽带码分多址 上海移远通信技术股份有限公司 44 / 44

Lx6&LG77L I2C Application Note GNSS Module Series Version: 1.2 Date: 2021-12-15 Status: Released GNSS Module Series At Quectel, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm. Or email us at: support@quectel.com. Legal Notices We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an 'as available' basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you. Use and Disclosure Restrictions License Agreements Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein. Copyright Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of the material. Lx6&LG77L_I2C_Application_Note 1 / 32 GNSS Module Series Trademarks Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects. Third-Party Rights This document may refer to hardware, software and/or documentation owned by one or more third parties ('third-party materials'). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto. We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all warranties arising from the course of dealing or usage of trade. Privacy Policy To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy. Disclaimer a) We acknowledge no liability for any injury or damage arising from the reliance upon the information. b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein. c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted by law, regardless of whether such loss or damage may have been foreseeable. d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources. Copyright © Quectel Wireless Solutions Co., Ltd. 2021. All rights reserved. Lx6&LG77L_I2C_Application_Note 2 / 32 GNSS Module Series About the Document Document Information Title Subtitle Document Type Document Status Lx6&LG77L I2C Application Note GNSS Module Series Application Note Released Revision History Revision Date 1.0 2016-09-14 1.1 2018-10-16 1.2 2021-12-15 Description Initial Added L96 as an applicable module of this document. Added L26-LB, L76-LB and LG77L as applicable modules of this document. Lx6&LG77L_I2C_Application_Note 3 / 32 GNSS Module Series Contents About the Document .................................................................................................................................. 3 Contents ...................................................................................................................................................... 4 Table Index.................................................................................................................................................. 5 Figure Index .............................................................................................................................................. 6 1 Introduction ......................................................................................................................................... 7 2 NMEA Data Reading via I2C Bus....................................................................................................... 8 2.1. NMEA Data Reading Flow of the Master ................................................................................... 8 2.2. I2C Data Packets ....................................................................................................................... 9 2.2.1. Format of I2C Data Packet ............................................................................................. 9 2.2.2. Three Types of I2C Data Packets ................................................................................. 10 2.2.2.1. Type 1: Valid Data Bytes + Garbage Bytes........................................................ 10 2.2.2.2. Type 2: All Garbage Bytes ................................................................................. 12 2.2.2.3. Type 3: Garbage Bytes + Valid Data Bytes........................................................ 13 2.2.3. How to Extract Valid NMEA Data from Several I2C Packets........................................ 14 3 Sending Messages via I2C Bus ....................................................................................................... 15 4 Procedures for I2C Data Reading and Writing .............................................................................. 16 4.1. Sequence Charts ..................................................................................................................... 16 4.2. Sample Code ........................................................................................................................... 17 5 Procedures for Receiving and Parsing NMEA Sentences ........................................................... 19 5.1. Flow Chart ................................................................................................................................ 19 5.2. Sample Code ........................................................................................................................... 20 6 Appendix References ....................................................................................................................... 32 Lx6&LG77L_I2C_Application_Note 4 / 32 GNSS Module Series Table Index Table 1: Function Description..................................................................................................................... 20 Table 2: Related Document........................................................................................................................ 32 Table 3: Terms and Abbreviations .............................................................................................................. 32 Lx6&LG77L_I2C_Application_Note 5 / 32 GNSS Module Series Figure Index Figure 1: NMEA Data Reading Flow of the Master in Polling Mode............................................................ 9 Figure 2: Format of I2C Data Packet ........................................................................................................... 9 Figure 3: Example of I2C Data Packet Format .......................................................................................... 10 Figure 4: Type 1 (Valid Data Bytes + Garbage Bytes) ................................................................................11 Figure 5: Example of Type 1 (Valid Data Bytes + Garbage Bytes).............................................................11 Figure 6: Type 2 (All Garbage Bytes)......................................................................................................... 12 Figure 7: Example of Type 2 (All Garbage Bytes) ..................................................................................... 12 Figure 8: Type 3 (Garbage Bytes + Valid Data Bytes) ............................................................................... 13 Figure 9: Example of Type 3 (Garbage Bytes + Valid Data Bytes)............................................................ 13 Figure 10: Sequence Chart for Reading Data from I2C Buffer.................................................................. 16 Figure 11: Sequence Chart for Writing Data to I2C Buffer......................................................................... 16 Figure 12: Flow Chart for Receiving and Parsing NMEA Sentences ........................................................ 19 Lx6&LG77L_I2C_Application_Note 6 / 32 GNSS Module Series 1 Introduction This document introduces the I2C function and use. The modules working as slaves provide an I2C interface which outputs NMEA data read by a master (MCU). The modules’ I2C interface includes the following features: ⚫ Supports fast mode, with a bit rate up to 400 kbps. ⚫ Supports 7-bit address. ⚫ Works in slave mode. ⚫ Default slave address values: Write: 0x20, Read: 0x21. ⚫ I2C pins: I2C_SDA and I2C_SCL. This document also provides a detailed introduction as well as a flow chart and sample code to illustrate how the master reads/parses NMEA sentences and sends messages via the I2C bus. This document is applicable to the following Quectel GNSS modules: ⚫ L26-LB ⚫ L76-L ⚫ L76-LB ⚫ L96 ⚫ LG77L NOTE The I2C interface is only supported on firmware versions ending with 'SC'. Lx6&LG77L_I2C_Application_Note 7 / 32 GNSS Module Series 2 NMEA Data Reading via I2C Bus This chapter provides a detailed introduction on how the master reads and parses NMEA data packets via I2C bus. The master can read a 255-byte data packet via I2C bus at a time and the data need to be processed because some of them are garbage bytes which are not useful. 2.1. NMEA Data Reading Flow of the Master The slave’s I2C buffer has a capacity of 255 bytes, which means that the master can read one I2C data packet of a maximum size of 255 bytes at a time. In order to get a complete NMEA packet of one second, the master needs to read several I2C data packets and then extract valid NMEA data from them. After reading one I2C data packet, the master should be set to sleep for 2 ms before it starts to receive the next I2C data packet, as the slave needs 2 ms to upload the new I2C data into the I2C buffer. When the entire NMEA packet of one second is read, the master can sleep for a longer time (e.g., 500 ms) to wait for the entire NMEA packet of the next second to be ready. The NMEA data packet can be read via the I2C bus only in polling mode. To avoid data loss, the master should read the entire NMEA packet of one second in a polling interval. The interval can be configured with PMTK314 according to the GNSS fix interval and it should be shorter than the GNSS fix interval. See document [1] for details on PMTK314. The following figure illustrates how the master reads NMEA data packets via I2C in polling mode. Lx6&LG77L_I2C_Application_Note 8 / 32 GNSS Module Series Master reads one I2C packet: 255 bytes Sleep for 500 ms Sleep for 2 ms YES NO Entire NMEA packet of one second is read or not Figure 1: NMEA Data Reading Flow of the Master in Polling Mode NOTE The figure above assumes that the GNSS fix interval is 1 s, and the recommended polling interval is 500 ms. 2.2. I2C Data Packets 2.2.1. Format of I2C Data Packet The data packet in the slave’s I2C buffer (I2C data packet) includes 254 valid NMEA bytes at most and one end character , so the master can read maximally a 255-byte I2C data packet at a time. The following figure illustrates I2C data packet format. NMEA 0A Valid NMEA data，less than or equal to 254 bytes End Char '0A' Figure 2: Format of I2C Data Packet Lx6&LG77L_I2C_Application_Note 9 / 32 GNSS Module Series There are maximally 254 valid NMEA data bytes and one end character in one I2C data packet, as shown below: Offset 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F ASCII 00000000 24 47 50 47 47 41 2C 31 32 33 36 32 31 2E 30 30 $GPGGA,123621.00 00000010 30 2CV3a3li3d0 N33M32E2AE 3d5a3t0a3b0 y3t3e2sC 4E 2C 31 30 0,3032.5003,N,10 00000020 34 30 34 2E 32 31 33 34 2C 45 2C 31 2C 31 30 2C 404.2134,E,1,10, 00000030 30 2E 38 31 2C 35 38 39 2E 32 2C 4D 2C 2D 33 31 0.81,589.2,M,-31 00000040 2E 39 2C 4D 2C 2C 2A 34 30 OD 0A 24 47 50 47 53 .9,M,,*40ˑˑ$GPGS 00000050 41 2C 41 2C 33 2C 33 32 2C 31 34 2C 31 32 2C 32 A,A,3,32,14,12,2 00000060 39 2C 32 32 2C 32 35 2C 31 39 33 2C 33 31 2C 30 9,22,25,193,31,0 00000070 31 2C 31 38 2C 2C 2C 31 2E 33 37 2C 30 2E 38 31 1,18,,,1.37,0.81 00000080 2C 31 2E 31 31 2A 33 35 0D OA 24 47 50 47 53 56 ,1.11*35ˑˑ$GPGSV 00000090 2C 34 2C 31 2C 31 33 2C 33 31 2C 36 36 2C 33 30 ,4,1,13,31,66,30 000000A0 38 2C 34 36 2C 31 34 2C 35 35 2C 30 35 37 2C 34 8,46,14,55,057,4 000000B0 36 2C 32 35 2C 34 31 2C 30 35 35 2C 34 34 2C 32 6,25,41,055,44,2 000000C0 32 2C 33 38 2C 31 36 34 2C 34 36 2A 37 38 0D 0A 2,38,164,46*78ˑˑ 000000D0 24 47 50 47 53 56 2C 34 2C 32 2C 31 33 2C 33 32 $GPGSV,4,2,13,32 000000E0 2C 33 39 2C 33 31 32 2C 34 34 2C 35 30 2C 33 33 ,38,312,44,50,33 000000F0 2C 31 32 30 2C 33 39 2C 31 39 33 2C 31 33 0A ,120,39,193,13ˑ End char Figure 3: Example of I2C Data Packet Format 2.2.2. Three Types of I2C Data Packets Regardless of whether NMEA data are stored in the I2C buffer, the master can read one I2C data packet (255 bytes) from the slave at a time. There are three types of I2C data packets that the master can read from the slave. 2.2.2.1. Type 1: Valid Data Bytes + Garbage Bytes When the I2C buffer has already stored some data, the master will read the stored data first, and then garbage bytes. If 254 valid NMEA bytes are all stored in the buffer, the last byte will be the end character . Lx6&LG77L_I2C_Application_Note 10 / 32 NMEA GNSS Module Series Garbage bytes '0A' One I2C packet, total 255 bytes Figure 4: Type 1 (Valid Data Bytes + Garbage Bytes) For example, if the slave I2C buffer has stored 202-byte NMEA data, the 255-byte I2C data packet read by the master includes 202 valid data bytes and 53 garbage bytes. An example is shown below: Offset 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 00000000 32 2C 31 32 2C 34 32 2C 33 37 2C 31 32 35 2C 34 00000010 20 2VC a31lid31 N2CM3E1 A35 d2Ca3ta3 3b1y3t7e2sC 34 20 2C 30 00000020 35 2C 33 31 2C 30 35 38 2C 34 32 2C 31 38 2C 32 00000030 35 2C 32 38 30 2C 34 32 2A 37 31 0D 3A 24 47 50 00000040 47 53 56 2C 33 2C 33 2C 31 32 2C 30 32 2C 32 30 00000050 2C 31 32 34 2C 34 34 2C 32 34 2C 31 36 2C 31 36 00000060 32 2C 33 39 2C 30 39 2C 31 30 2C 30 24 37 2C 33 00000070 39 2C 30 38 2C 30 37 2C 30 34 35 2C 33 35 2A 37 00000080 41 0D 0A 24 47 50 52 4D 43 2C 30 36 30 39 35 39 00000090 2E 30 30 30 2C 41 2C 33 30 33 32 2E 35 30 31 38 000000A0 2C 4E 2C 31 30 34 30 34 2E 32 31 33 37 2C 45 2C 000000B0 30 2E 30 30 2C 32 39 35 2E 30 37 2C 32 36 31 32 000000C0 31 33 2C 2C 2C 44 2A 36 43 0D 0A 0A 0A 0A 0A 0A 000000D0 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 000000E0 0A 0A 0AG0Aa0rAba0Ag0eA b0Ayt0eA s0A 0A 0A 0A 0A 0A 0A 000000F0 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A ASCII 2,12,42,37,125,4 0,21,35,317,40,0 5,31,058,42,18,2 5,280,42*71ˑˑ$GP GSV,3,3,12,02,20 ,124,44,24,16,16 2,39,09,10,047,3 9,08,07,045,35*7 Aˑˑ$GPRMC,060957 .000,A,3032.5018 ,N,10404.2137,E, 0.00,295.07,2612 13,,,D*6Cˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ Figure 5: Example of Type 1 (Valid Data Bytes + Garbage Bytes) NOTE Why are garbage bytes ‘0A’? If the slave’s I2C buffer is empty, the slave will repeatedly output the last valid byte until new data are uploaded into the I2C buffer, and ‘0A’ is the last valid byte in the NMEA packet. Lx6&LG77L_I2C_Application_Note 11 / 32 GNSS Module Series 2.2.2.2. Type 2: All Garbage Bytes When the slave I2C buffer is empty, the master will read only garbage bytes. Garbage bytes '0A' One I2C packet, total 255 bytes, all data are garbage bytes '0A' Figure 6: Type 2 (All Garbage Bytes) Offset 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 00000000 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000010 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000020 0A 0A 0A 0A G0Aa0rAb0aAg0eA 0bAy0tAes0A 0A 0A 0A 0A 0A 00000030 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000040 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000050 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000060 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000070 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000080 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000090 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 000000A0 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 000000B0 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 000000C0 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 000000D0 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 000000E0 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 000000F0 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A ASCII ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ Figure 7: Example of Type 2 (All Garbage Bytes) Lx6&LG77L_I2C_Application_Note 12 / 32 GNSS Module Series 2.2.2.3. Type 3: Garbage Bytes + Valid Data Bytes If the slave I2C buffer is empty when the master starts reading, but the slave starts uploading new data into the I2C buffer before the reading is over, the master will read garbage bytes first and then valid NMEA data bytes. Garbage bytes '0A' NMEA One I2C packet, total 255 bytes Figure 8: Type 3 (Garbage Bytes + Valid Data Bytes) Offset 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 00000000 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000010 0A 0A 0GA a0Arb0aA g0Ae 0bAy0tAe0sA 0A 0A 0A 0A 0A 0A 0A 00000020 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000030 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 0A 00000040 0A 0A 0A 0A 0A 0A 0A 0A 24 47 50 47 47 41 2C 30 00000050 37 31 34 33 38 2E 30 30 30 2C 33 30 33 32 2E 35 00000060 30 31 31 2C 4E 2C 31 30 34 30 34 2E 32 31 31 33 00000070 2C 45 V2Ca3l2id2CN3M1 E30A2Cd3a0ta2E b38yt3e5s2C 35 37 35 00000080 2E 34 2C 4D 2D 2D 33 31 2E 39 2C 4D 2C 30 30 30 00000090 30 2C 30 30 30 30 2A 34 38 0D 0A 24 47 50 47 53 000000A0 41 2C 41 2C 33 2C 30 36 2C 31 39 33 2C 32 32 2C 000000B0 30 35 2C 32 36 2C 31 38 2C 31 35 2C 32 31 2C 32 000000C0 34 2C 32 39 2C 2C 2C 31 2E 34 37 2C 30 2E 38 35 000000D0 2C 31 2E 31 39 2A 33 42 OD OA 24 47 50 47 53 56 000000E0 2C 34 2C 31 2C 31 33 2C 31 35 2C 36 35 2C 30 32 000000F0 38 2C 34 36 2C 32 31 2C 36 31 2C 33 31 33 2C ASCII ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑˑ ˑˑˑˑˑˑˑˑ$GPGGA,0 71439.000,3032.5 011,N,10404.2113 ,E,2,10,0.85,575 .4,M,-31.9,M,000 0,0000*48ˑˑ$GPGS A,A,3,06,193,22, 05,26,18,15,21,2 4,29,,,1.47,0.85 ,1.19*3Bˑˑ$GPGSV ,4,1,13,15,65,02 8,46,21,61,313, Figure 9: Example of Type 3 (Garbage Bytes + Valid Data Bytes) Lx6&LG77L_I2C_Application_Note 13 / 32 GNSS Module Series 2.2.3. How to Extract Valid NMEA Data from Several I2C Packets After the master reads sufficient I2C data packets, it needs to parse and extract valid NMEA data from these packets. See Chapter 5.2 for the sample code provided by Quectel to extract the valid data. NOTE When extracting NMEA data from I2C packets, all ‘0A’ characters should be discarded. The ‘0A’ character may come in the form of: 1. End character of an I2C packet. 2. Garbage bytes. 3. End character of an NMEA sentence. If it is discarded, there is no effect on NMEA sentence parsing. Lx6&LG77L_I2C_Application_Note 14 / 32 GNSS Module Series 3 Sending Messages via I2C Bus The master can send messages to the slave via I2C bus. See document [1] for detailed information on the messages. As the slave’s I2C buffer has a maximum capacity of 255 bytes, each message inputted by the master should be 255 bytes at most. The interval between two input messages cannot be shorter than 10 ms as the slave needs 10 ms to process the inputted data. Lx6&LG77L_I2C_Application_Note 15 / 32 GNSS Module Series 4 Procedures for I2C Data Reading and Writing The chapter provides the sequence charts and sample code for I2C data reading and writing. 4.1. Sequence Charts The sequence charts for reading data from and writing data to the I2C buffer are provided below. S T A R T SDA M S B W R I DEVICE T ADDRESS E - 0x21 S T A ONE BYTE OF WORD R ADDRESS - 0x00 T LR A A S/ C C BW K K DEVICE ADDRESS - 0x21 R E A D A C DATA n K DUMMY WRITE S T O P N O A C K Figure 10: Sequence Chart for Reading Data from I2C Buffer S T A DEVICE R ADD RESS T - 0x20 SDA M S B W R I T E LR A S/ C BW K DATA n S T O P A C K Figure 11: Sequence Chart for Writing Data to I2C Buffer Lx6&LG77L_I2C_Application_Note 16 / 32 4.2. Sample Code The sample code for reading data from and writing data to the I2C buffer: #define WRITE_I2C_DATA_ADDRESS 0x20 #define READ_I2C_DATA_ADDRESS 0x21 #define READ_I2C_DATA_LENGTH 255 uint8_t i2c_recive_data[READ_I2C_DATA_LENGTH + 1]; void read_i2c_bytes(uint8_t *buf, uint16_t length) { uint16_t i; IIC_Start(); IIC_Send_Byte(WRITE_I2C_DATA_ADDRESS); if (IIC_Wait_Ack() != 0) { IIC_Stop(); return; } IIC_Send_Byte((uint8_t)0x00); if (IIC_Wait_Ack() != 0) { IIC_Stop(); return ; } IIC_Start(); IIC_Send_Byte(READ_I2C_DATA_ADDRESS); if(IIC_Wait_Ack() != 0) { IIC_Stop(); return; } for (i = 0; i < READ_I2C_DATA_LENGTH; i++) { buf[i] = IIC_Read_Byte(); if (i != READ_I2C_DATA_LENGTH - 1) { IIC_Ack(); GNSS Module Series Lx6&LG77L_I2C_Application_Note 17 / 32 } else { IIC_NAck(); } } IIC_Stop(); } void write_i2c_bytes (uint8_t *buf, uint16_t length) { uint16_t i=0; IIC_Stop(); IIC_Start(); IIC_Send_Byte(WRITE_I2C_DATA_ADDRESS); if (IIC_Wait_Ack() != 0) { return; } for(i = 0; i < length; i++) { IIC_Send_Byte(buf[i]); if (IIC_Wait_Ack() != 0) { return; } } IIC_Stop(); return; } GNSS Module Series Lx6&LG77L_I2C_Application_Note 18 / 32 GNSS Module Series 5 Procedures for Receiving and Parsing NMEA Sentences This chapter provides the flow chart and sample code on how the master receives and parses NMEA sentences via I2C. 5.1. Flow Chart The flow chart on how the master receives and parses NMEA sentences is shown below. Main Thread Init Queue iop_init_pcrx() RX Thread Read I2C package: 255 bytes Application Thread Put received bytes into queue Parser : iop_pcrx_nmea() Wait to receive NMEA event Get available NMEA packet info: iop_inst_avail() Set Event One complete NMEA sentence received Get NMEA sentence: iop_get_inst() (buffer) Ex: $GPGGA *31 in buffer Wait for certain milliseconds (e.g., 500 ms) and read next I2C packet (255 bytes) Figure 12: Flow Chart for Receiving and Parsing NMEA Sentences Lx6&LG77L_I2C_Application_Note 19 / 32 GNSS Module Series 5.2. Sample Code This chapter provides the sample code for receiving and parsing NMEA sentences. The master will parse the received NMEA and debug data so as to discard garbage bytes and extract valid data from multiple data packets. The functions used in the sample code are presented in the following table. Table 1: Function Description Function iop_init_pcrx() iop_inst_avail() iop_get_inst() iop_pcrx_nmea() iop_pcrx_nmea_dbg_hbd_bytes() Description Initializes reception queue. Gets available NMEA sentence information. Gets NMEA sentence data from queue buffer. Processes I2C packets, gets valid NMEA data and discards garbage bytes. Processes I2C packets, gets valid NMEA data, debug log code and discards garbage bytes. The sample code for receiving and parsing I2C NMEA sentences: #define IOP_LF_DATA 0x0A // #define IOP_CR_DATA 0x0D // #define IOP_START_DBG 0x23 //Debug log start char ‘#’ #define IOP_START_NMEA 0x24 //NMEA start char ‘$’ #define IOP_START_HBD1 'H' //HBD debug log start char ‘H’ #define IOP_START_HBD2 'B' #define IOP_START_HBD3 'D' #define NMEA_ID_QUE_SIZE 0x0100 #define NMEA_RX_QUE_SIZE 0x8000 typedef enum { RXS_DAT_HBD, //Receive HBD data RXS_PRM_HBD2, //Receive HBD preamble 2 RXS_PRM_HBD3, //Receive HBD preamble 3 RXS_DAT, //Receive NMEA data RXS_DAT_DBG, //Receive DBG data RXS_ETX, //End-of-packet } RX_SYNC_STATE_T; struct Lx6&LG77L_I2C_Application_Note 20 / 32 GNSS Module Series { short inst_id; //1 - NMEA, 2 - DBG, 3 - HBD short dat_idx; short dat_siz; } id_que[NMEA_ID_QUE_SIZE]; char rx_que[NMEA_RX_QUE_SIZE]; unsigned short id_que_head; unsigned short id_que_tail; unsigned short rx_que_head; RX_SYNC_STATE_T rx_state; unsigned int u4SyncPkt; unsigned int u4OverflowPkt; unsigned int u4PktInQueue; //Queue Functions BOOL iop_init_pcrx( void ) { /*---------------------------------------------------------variables ----------------------------------------------------------*/ short i; /*---------------------------------------------------------initialize queue indexes ----------------------------------------------------------*/ id_que_head = 0; id_que_tail = 0; rx_que_head = 0; /*---------------------------------------------------------initialize identification queue ----------------------------------------------------------*/ for( i=0; i< NMEA_ID_QUE_SIZE; i++) { id_que[i].inst_id = -1; id_que[i].dat_idx = 0; } /*---------------------------------------------------------initialize receiving state ----------------------------------------------------------*/ rx_state = RXS_ETX; /*---------------------------------------------------------initialize statistic information ----------------------------------------------------------*/ u4SyncPkt = 0; u4OverflowPkt = 0; u4PktInQueue = 0; Lx6&LG77L_I2C_Application_Note 21 / 32 GNSS Module Series return TRUE; } /********************************************************************* * PROCEDURE NAME: * iop_inst_avail - Get available NMEA sentence information * * DESCRIPTION: * inst_id - NMEA sentence type * dat_idx - Start data index in queue * dat_siz - NMEA sentence size *********************************************************************/ BOOL iop_inst_avail(short *inst_id, short *dat_idx, short *dat_siz) { /*---------------------------------------------------------variables ----------------------------------------------------------*/ BOOL inst_avail; /*---------------------------------------------------------if packet is available then return id and index ----------------------------------------------------------*/ if ( id_que_tail != id_que_head ) { *inst_id = id_que[ id_que_tail ].inst_id; *dat_idx = id_que[ id_que_tail ].dat_idx; *dat_siz = id_que[ id_que_tail ].dat_siz; id_que[ id_que_tail ].inst_id = -1; id_que_tail = ++id_que_tail & (unsigned short)(NMEA_ID_QUE_SIZE - 1); inst_avail = TRUE; if (u4PktInQueue > 0) { u4PktInQueue--; } } else { inst_avail = FALSE; } return ( inst_avail ); } /* iop_inst_avail() end */ /********************************************************************* * PROCEDURE NAME: * iop_get_inst - Get available NMEA sentence from queue * Lx6&LG77L_I2C_Application_Note 22 / 32 GNSS Module Series * DESCRIPTION: * idx - Start data index in queue * size - NMEA sentence size * data - Data buffer used to save NMEA sentence *********************************************************************/ void iop_get_inst(short idx, short size, void *data) { /*---------------------------------------------------------variables ----------------------------------------------------------*/ short i; unsigned char *ptr; /*---------------------------------------------------------copy data from the receive queue to the data buffer ----------------------------------------------------------*/ ptr = (unsigned char *)data; for (i = 0; i < size; i++) { *ptr = rx_que[idx]; ptr++; idx = ++idx & (unsigned short)(NMEA_RX_QUE_SIZE - 1); } } /* iop_get_inst() end */ /********************************************************************* * PROCEDURE NAME: * iop_pcrx_nmea - Receive NMEA code * * DESCRIPTION: * The procedure fetches the characters between '$' and (including '$' and ). * I.e., and characters are skipped. * And the maximum size of the sentence fetched by this procedure is 256 bytes. * $xxxxxx*AA * *********************************************************************/ void iop_pcrx_nmea( unsigned char data ) { /*---------------------------------------------------------determine the receiving state ----------------------------------------------------------*/ if (data == IOP_LF_DATA){ return; } switch (rx_state) { Lx6&LG77L_I2C_Application_Note 23 / 32 GNSS Module Series case RXS_DAT: switch (data) { case IOP_CR_DATA: //Count total number of sync packets u4SyncPkt += 1; id_que_head = ++id_que_head & (unsigned short)(NMEA_ID_QUE_SIZE - 1); if (id_que_tail == id_que_head) { //Count total number of overflow packets u4OverflowPkt += 1; id_que_tail = ++id_que_tail & (unsigned short)(NMEA_ID_QUE_SIZE - 1); } else { u4PktInQueue++; } rx_state = RXS_ETX; /*---------------------------------------------------------set RxEvent signaled ----------------------------------------------------------*/ SetEvent(hRxEvent); break; case IOP_START_NMEA: { //Restart NMEA sentence collection rx_state = RXS_DAT; id_que[id_que_head].inst_id = 1; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; break; } default: rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; //If NMEA sentence length > 256 bytes, stop NMEA sentence collection. if (id_que[id_que_head].dat_siz == MAX_NMEA_STN_LEN) { id_que[id_que_head].inst_id = -1; rx_state = RXS_ETX; Lx6&LG77L_I2C_Application_Note 24 / 32 GNSS Module Series } break; } break; case RXS_ETX: if (data == IOP_START_NMEA) { rx_state = RXS_DAT; id_que[id_que_head].inst_id = 1; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; } break; default: rx_state = RXS_ETX; break; } } /* iop_pcrx_nmea() end */ /********************************************************************* * PROCEDURE NAME: * void iop_pcrx_nmea_dbg_hbd_bytes(unsigned char aData[], int i4NumByte) * Receive NMEA and debug log code * * DESCRIPTION: * The procedure fetches the characters between '$' and (including '$' and ). * I.e., characters and are skipped. * And the maximum size of the sentence fetched by this procedure is 256 bytes. * $xxxxxx*AA * *********************************************************************/ void iop_pcrx_nmea_dbg_hbd_bytes(unsigned char aData[], int i4NumByte) { int i; unsigned char data; for (i = 0; i < i4NumByte; i++) { data = aData[i]; if (data == IOP_LF_DATA){ continue; } /*---------------------------------------------------------- Lx6&LG77L_I2C_Application_Note 25 / 32 GNSS Module Series determine the receiving state ----------------------------------------------------------*/ switch (rx_state) { case RXS_DAT: switch (data) { case IOP_CR_DATA: //Count total number of sync packets u4SyncPkt += 1; id_que_head = ++id_que_head & (unsigned short)(NMEA_ID_QUE_SIZE - 1); if (id_que_tail == id_que_head) { //Count total number of overflow packets u4OverflowPkt += 1; id_que_tail = ++id_que_tail & (unsigned short)(NMEA_ID_QUE_SIZE - 1); } else { u4PktInQueue++; } rx_state = RXS_ETX; /*---------------------------------------------------------set RxEvent signaled ----------------------------------------------------------*/ SetEvent(hRxEvent); break; case IOP_START_NMEA: { //Restart NMEA sentence collection rx_state = RXS_DAT; id_que[id_que_head].inst_id = 1; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; break; } case IOP_START_DBG: { //Restart DBG sentence collection Lx6&LG77L_I2C_Application_Note 26 / 32 GNSS Module Series rx_state = RXS_DAT_DBG; id_que[id_que_head].inst_id = 2; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; break; } default: rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; //If NMEA sentence bytes > 256, stop NMEA sentence collection. if (id_que[id_que_head].dat_siz == MAX_NMEA_STN_LEN) { id_que[id_que_head].inst_id = -1; rx_state = RXS_ETX; } break; } break; case RXS_DAT_DBG: switch (data) { case IOP_CR_DATA: //Count total number of sync packets u4SyncPkt += 1; id_que_head = ++id_que_head & (unsigned short)(NMEA_ID_QUE_SIZE - 1) if (id_que_tail == id_que_head) { //Count total number of overflow packets u4OverflowPkt += 1; id_que_tail = ++id_que_tail & (unsigned short)(NMEA_ID_QUE_SIZE - 1); } else { u4PktInQueue++; } rx_state = RXS_ETX; /*---------------------------------------------------------set RxEvent signaled ----------------------------------------------------------*/ SetEvent(hRxEvent); Lx6&LG77L_I2C_Application_Note 27 / 32 GNSS Module Series break; case IOP_START_NMEA: { //Restart NMEA sentence collection rx_state = RXS_DAT; id_que[id_que_head].inst_id = 1; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; break; } case IOP_START_DBG: { //Restart DBG sentence collection rx_state = RXS_DAT_DBG; id_que[id_que_head].inst_id = 2; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; break; } default: rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; //If NMEA sentence length > 256 bytes, stop NMEA sentence collection. if (id_que[id_que_head].dat_siz == MAX_NMEA_STN_LEN) { id_que[id_que_head].inst_id = -1; rx_state = RXS_ETX; } break; } break; case RXS_DAT_HBD: switch (data) { case IOP_CR_DATA: Lx6&LG77L_I2C_Application_Note 28 / 32 GNSS Module Series //Count total number of sync packets u4SyncPkt += 1; id_que_head = ++id_que_head & (unsigned short)(NMEA_ID_QUE_SIZE - 1); if (id_que_tail == id_que_head) { //Count total number of overflow packets u4OverflowPkt += 1; id_que_tail = ++id_que_tail & (unsigned short)(NMEA_ID_QUE_SIZE - 1); } else { u4PktInQueue++; } rx_state = RXS_ETX; /*---------------------------------------------------------set RxEvent signaled ----------------------------------------------------------*/ SetEvent(hRxEvent); break; case IOP_START_NMEA: { //Restart NMEA sentence collection rx_state = RXS_DAT; id_que[id_que_head].inst_id = 1; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; break; } case IOP_START_DBG: { //Restart DBG sentence collection rx_state = RXS_DAT_DBG; id_que[id_que_head].inst_id = 2; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; break; } Lx6&LG77L_I2C_Application_Note 29 / 32 GNSS Module Series default: rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; //If NMEA sentence bytes > 256, stop NMEA sentence collection. if (id_que[id_que_head].dat_siz == MAX_NMEA_STN_LEN) { id_que[id_que_head].inst_id = -1; rx_state = RXS_ETX; } break; } break; case RXS_ETX: if (data == IOP_START_NMEA) { rx_state = RXS_DAT; id_que[id_que_head].inst_id = 1; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; } else if (data == IOP_START_DBG) { rx_state = RXS_DAT_DBG; id_que[id_que_head].inst_id = 2; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = data; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; } else if (data == IOP_START_HBD1) { rx_state = RXS_PRM_HBD2; } break; case RXS_PRM_HBD2: if (data == IOP_START_HBD2) { rx_state = RXS_PRM_HBD3; Lx6&LG77L_I2C_Application_Note 30 / 32 GNSS Module Series } else { rx_state = RXS_ETX; } break; case RXS_PRM_HBD3: if (data == IOP_START_HBD3) { rx_state = RXS_DAT_HBD; //Start to collect the packet id_que[id_que_head].inst_id = 3; id_que[id_que_head].dat_idx = rx_que_head; id_que[id_que_head].dat_siz = 0; rx_que[rx_que_head] = IOP_START_HBD1; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; rx_que[rx_que_head] = IOP_START_HBD2; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; rx_que[rx_que_head] = IOP_START_HBD3; rx_que_head = ++rx_que_head & (unsigned short)(NMEA_RX_QUE_SIZE - 1); id_que[id_que_head].dat_siz++; } else { rx_state = RXS_ETX; } break; default: rx_state = RXS_ETX; break; } } } /* iop_pcrx_nmea_dbg_hbd_bytes() end */ Lx6&LG77L_I2C_Application_Note 31 / 32 GNSS Module Series 6 Appendix References Table 2: Related Document Document Name [1] Quectel_Lx0&Lx6L&LC86L&LG77L_GNSS_Protocol_Specification Table 3: Terms and Abbreviations Abbreviation ACK GNSS I2C MCU NMEA SCL SDA Description Acknowledgement Global Navigation Satellite System Inter-Integrated Circuit Microcontroller Unit National Marine Electronics Association Serial Clock Serial Data Lx6&LG77L_I2C_Application_Note 32 / 32

射频 LAYOUT 应用指导 版本：射频 LAYOUT_应用指导_V2.2 日期：2016-02-26 www.quectel.com 射频 LAYOUT 应用指导 移远通信始终以为客户提供最及时、最全面的服务为宗旨，如需任何帮助，请随时联系我司上海总部，联 系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区田州路 99 号 13 幢 501 室电话: +86 21 51086236 邮箱: info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/support/salesupport.aspx 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/support/techsupport.aspx Or Email: Support@quectel.com l 前言 移远通信提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规范，参数来设计其产品。 te 由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未声明前，移远通信有权对 c l 该文档规范进行更新。 ue tia 版权申明 本文档手册版权属于移远通信，任何人未经我公司复制转载该文档将承担法律责任。 Q n 版权所有 ©上海移远通信技术股份有限公司 2016，保留一切权利。 Confide Copyright © Quectel Wireless Solutions Co., Ltd. 2016. 上海移远通信技术股份有限公司 1 / 9 射频 LAYOUT 应用指导 文档历史 修订记录 版本 1.0 2.0 2.1 2.2 日期 2011-08-08 l 2014-10-16 te 2015-04-11 CQouneficdential 2016-02-26 作者 魏 来 王学兵 王学兵 王学兵 变更表述 初始版本 1. 使用新的文档模板 2. 更新模块参考原理图 增加适用模块说明 更新图 6：PCB LAYOUT 实例图 上海移远通信技术股份有限公司 2 / 9 射频 LAYOUT 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 图片索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 2 射频接口原理图建议............................................................................................................................... 6 3 50 欧姆特性阻抗共面波导结构设计 ....................................................................................................... 7 4 共面波导 PCB LAYOUT 实例及注意事项.............................................................................................. 9 CQouneficdteenl tial 上海移远通信技术股份有限公司 3 / 9 射频 LAYOUT 应用指导 图片索引 图 1：模块射频参考原理图 .................................................................................................................................. 6 图 2：共面波导结构示意图 .................................................................................................................................. 7 图 3：两层板 LAYOUT 示意图 ............................................................................................................................. 8 图 4：四层板 LAYOUT 示意图(参考地是第三层) ................................................................................................. 8 图 5：四层板 LAYOUT 示意图(参考地是第四层) ................................................................................................. 8 图 6：PCB LAYOUT 实例图 ................................................................................................................................ 9 CQouneficdteenl tial 上海移远通信技术股份有限公司 4 / 9 射频 LAYOUT 应用指导 1 引言 本文档主要介绍了模块外围射频电路的 PCB 走线注意事项，帮助客户在使用移远模块时，正确进行 RF 部分的 PCB 布线设计，以保证 RF 性能，减少客户的设计周期。 本文档适用于所有 Quectel GSM、WCDMA 和 LTE 模块。 CQouneficdteenl tial 上海移远通信技术股份有限公司 5 / 9 2 射频接口原理图建议 射频 LAYOUT 应用指导 Quectenl tial 图1：模块射频参考原理图 e 其中 C1、R1、C2 为预留的匹配电路，用来优化天线端口性能，默认值为：R1 贴 0R 电阻；C1 不贴； Confid C2不贴。 上海移远通信技术股份有限公司 6 / 9 射频 LAYOUT 应用指导 3 50 欧姆特性阻抗共面波导结构设计 推荐采用共面波导微波传输形式，特性阻抗 50 欧姆，见图 2。 Queficdteenl tial 图2：共面波导结构示意图 n 影响共面波导特性阻抗的主要因素有，基材介电常数（通常为 4.2～4.6，这里取 4.4）、信号层与参考 o 地间距 H、线宽 W、对地间隙 S、铜皮厚度 T。表 1 列出了不同信号层与参考地间距 H 和铜皮厚度 T=0.035mm C 时，50 欧姆特性阻抗对应的线宽 W 及对地间隙 S 推荐值： 表 1：不同信号层与参考地间距所对应的 50 欧姆共面波导线宽及对地间距推荐值 信号层与参考地间距离 H 0.076mm 0.1mm 0.15mm 线宽 W 0.1188mm 0.1623mm 0.24mm 对地间隙 S 0.15mm 0.2mm 0.2mm 上海移远通信技术股份有限公司 7 / 9 射频 LAYOUT 应用指导 0.8mm 1.0mm 1.2mm 1.6mm 2mm 0.8mm 0.8mm 0.8mm 0.8mm 0.8mm 0.18mm 0.17mm 0.16mm 0.15mm 0.14mm 如果是 2 层板，信号层为 Top 层，参考地为 Bottom 层，如下图 3。如果是 4 层板，参考地可以是第 2 层、第 3 层或者第 4 层。若参考地是第 3 层，信号层正下方第 2 层要禁铺，禁铺区域的宽度至少是信号线 宽的 5 倍，如下图 4。若参考地是第 4 层，信号层正下方第 2 层和第 3 层都要禁铺，禁铺区域的宽度至少 是信号线宽的 5 倍，如下图 5。如果是 6 层板以上以此类推。 uectel tial 图3：两层板LAYOUT示意图 CQonfiden 图 4：四层板 LAYOUT 示意图(参考地是第三层) 图 5：四层板 LAYOUT 示意图(参考地是第四层) 上海移远通信技术股份有限公司 8 / 9 射频 LAYOUT 应用指导 4 共面波导 PCB LAYOUT 实例及注意事项 Quecteenl tial 图6：PCBLAYOUT实例图 fid 结合上图数字标志号，共有 6 处需要注意： 1. 控制 50 欧姆共面波导对应的的线宽 W 及间距 S。以常用 PCB 板为 FR4 介质（介电常数为 4.2）， n 敷铜厚度为 35um 为例，不同的信号层与参考地间厚度对应的线宽及对地间隙如表 1。特别提醒 o PCB 板厂需要对线宽 W 及其与两侧地间隙 S 的精度进行控制。 2. 该处地 PIN 不做热焊盘，要和地充分接触。 C 3. 表层稍微禁铺，减少寄生效应。射频线尽量短，而且最好避免直角走线,有拐角的建议走 135 度。 4. 连接器件封装建立时要注意，信号脚离地要保持一定距离，可参考图 6。如果是贴装的焊盘，对应 的信号脚焊盘下要挖地。 5. 保证射频线对应的参考地完整，增加地孔帮助射频回流，地孔和信号线至少保持 2 倍线宽的距离。 保证射频线同层地的接地面积尽量大，其对应的另一面参考地尽量完整，并保证一定量的地孔连 接两层地。 6. 三个元件组成图一所示的 π 型匹配电路。摆放时焊盘要靠近天线放置，如上图所示。如果天线连 接端（SMA）与模块的 RF PIN 脚距离很短，无法放下此 π 形电路的三颗料，可改为 L 形匹配电 路。 上海移远通信技术股份有限公司 9 / 9

WCDMA UGxx Audio Design Note UMTS/HSPA Module Series Rev. WCDMA_UGxx_Audio_Design_Note_V1.2 Date: 2015-12-21 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail:info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_Audio_Design_Note Confidential / Released 1 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note About the Document History Revision 1.0 1.1 1.2 Date 2015-9-7 l 2015-10-23 CQouneficdteential 2015-12-21 Author Felix YIN/ Jun WU Felix YIN Felix YIN Description Initial 1. Updated PCM information in Chapter 2 2. Updated value for AT+QDAC Updated PCM timing in Chapter 2 WCDMA_UGxx_Audio_Design_Note Confidential / Released 2 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 2 PCM Characteristic .............................................................................................................................. 8 3 Audio Circuit Design ......................................................................................................................... 11 3.1. PCM Codec Design Circuit with ALC5616 .............................................................................. 12 4 5 6 3.2. PCM Codec Design Circuit with NAU8814 ............................................................................. 13 3.3. PCM Codec Design Circuit with MAX9860 ............................................................................. 14 3.4. Microphone Interface Design .................................................................................................. 15 3.5. Receiver Interface Design....................................................................................................... 15 l 3.6. Earphone Interface Design ..................................................................................................... 16 te 3.7. Speaker Amplifier Design ........................................................................................................ 16 Design Consideration ........................................................................................................................ 17 c l 4.1. Power Supply for PCM Codec ................................................................................................ 17 ue tia 4.2. Audio Layout ........................................................................................................................... 17 4.3. TDD Noise ............................................................................................................................... 18 4.4. Mechanical Design .................................................................................................................. 18 Q n 4.5. Component of SPK.................................................................................................................. 20 4.6. Components of Microphone .................................................................................................... 22 e Audio Tuning in Different Modes ..................................................................................................... 23 fid 5.1. Speech Call in Handset Mode................................................................................................. 23 5.2. Speech Call in Headset Mode................................................................................................. 24 5.3. Speech Call in Handfree Mode ............................................................................................... 24 n Audio AT Command Description ..................................................................................................... 26 6.1. AT+QDAC Digital Audio Interface Configuration .................................................................. 26 o 6.2. AT+QIIC IIC Read&Write ...................................................................................................... 28 C 6.3. AT+CLVL Loud Speaker Volume Level ................................................................................ 29 6.4. AT+QAUDGAIN Set Gain Offset .......................................................................................... 29 6.5. AT+QMIC Set Uplink(MIC) Volume ...................................................................................... 30 6.6. AT+CMUT Mute Control ....................................................................................................... 31 6.7. AT+QCLKOUT Output Clock Source ................................................................................... 32 6.8. AT+QSIDET Set the Side Tone Gain in the Current Mode .................................................. 33 6.9. AT+QAUDLOOP Enable Audio Loop Test............................................................................ 34 6.10. AT+QAUDMOD Set Audio Mode.......................................................................................... 35 6.11. AT+CRSL Set Ring Tone Volume ......................................................................................... 35 6.12. AT+CALM Mute the Ring Tone ............................................................................................. 36 WCDMA_UGxx_Audio_Design_Note Confidential / Released 3 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6.13. AT+QPCMON Enable PCM Sync & BCLK........................................................................... 37 6.14. AT+QAUDCFG Audio Tuning Process ................................................................................. 38 6.14.1. AT+QAUDCFG='handset/eec' Set Echo Cancellation for Handset ........................ 38 6.14.2. AT+QAUDCFG='headset/eec' Set Echo Cancellation for Headset ........................ 41 6.14.3. AT+QAUDCFG='handfree/eec' Set Echo Cancellation for Handfree ..................... 42 6.14.4. AT+QAUDCFG='handset/nr/ul' Set Uplink Noise Reduction for Handset .............. 43 6.14.5. AT+QAUDCFG='handset/nr/dl' Set Down Link Noise Reduction for Handset ....... 44 6.14.6. AT+QAUDCFG='headset/nr/dl' Set Down Link Noise Reduction for Headset ....... 45 6.14.7. AT+QAUDCFG='headset/nr/ul' Set Uplink Noise Reduction for Headset .............. 46 6.14.8. AT+QAUDCFG='handfree/nr/dl' Set Down Link Noise Reduction for Handfree..... 47 6.14.9. AT+QAUDCFG='handfree/nr/ul' Set Uplink Noise Reduction for Handfree ........... 48 6.14.10. AT+QAUDCFG='nau8814/dlgain' Set Down Link Gain Level for Codec nau8814. 49 7 6.14.11. 6.14.12. 6.14.13. 6.14.14. l 6.14.15. AT+QAUDCFG='nau8814/ulgain' Set Uplink Gain Level for Codec nau8814........ 50 AT+QAUDCFG='alc5616/dlgain' Set Down Link Gain Level for Codec alc5616.... 51 AT+QAUDCFG='alc5616/ulgain' Set Uplink Gain Level for Codec alc5616 .......... 52 AT+QAUDCFG='max9860/dlgain' Set Down Link Gain Level for Codec max986053 AT+QAUDCFG='max9860/ulgain' Set Uplink Gain Level for Codec max9860 ...... 54 CQouneficdteential Appendix ............................................................................................................................................. 56 WCDMA_UGxx_Audio_Design_Note Confidential / Released 4 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Table Index TABLE 1: PIN DEFINITION ................................................................................................................................. 8 TABLE 2: IO CHARACTERISTICS...................................................................................................................... 8 TABLE 3: RELATED DOCUMENTS .................................................................................................................. 56 TABLE 4: TERMS AND ABBREVIATIONS ........................................................................................................ 56 CQouneficdteenl tial WCDMA_UGxx_Audio_Design_Note Confidential / Released 5 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Figure Index FIGURE 1: PCM MASTER MODE TIMING......................................................................................................... 9 FIGURE 2: THE CONNECTION DIAGRAM OF PERIPHERALS, MODULE AND CODEC ............................. 10 FIGURE 3: ALC5616 CODEC DESIGN ............................................................................................................ 12 FIGURE 4: NAU8814 CODEC DESIGN............................................................................................................ 13 FIGURE 5: MAX9860 CODEC DESIGN ........................................................................................................... 14 FIGURE 6: MICROPHONE DESIGN ................................................................................................................ 15 FIGURE 7: RECEIVER DESIGN ....................................................................................................................... 15 FIGURE 8: EARPHONE DESIGN ..................................................................................................................... 16 FIGURE 9: SPEAKER AMPLIFIER DESIGN .................................................................................................... 16 FIGURE 10: AUDIO LAYOUT............................................................................................................................ 17 FIGURE 11: FIVE ECHO PATHS ...................................................................................................................... 19 FIGURE 12: MICROPHONE SOCKET DESIGN .............................................................................................. 19 FIGURE 13: SPEAKER SOCKET DESIGN ...................................................................................................... 20 l FIGURE 14: SPK FREQUENCY RESPONSE .................................................................................................. 21 CQouneficdteential FIGURE 15: SPK THD....................................................................................................................................... 21 WCDMA_UGxx_Audio_Design_Note Confidential / Released 6 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 1 Introduction This document mainly introduces how to use Pulse Code Modulation (PCM) digital interface with Quectel UGxx modules. CQouneficdteenl tial WCDMA_UGxx_Audio_Design_Note Confidential / Released 7 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 2 PCM Characteristic Quectel UGxx modules provide one PCM digital interface for audio design, which supports the following features:  Supports16, 32 bit mode with short frame synchronization, the PCM supports 32 bit mode by default. The default configuration of PCM codec is AT+QDAC=1,0,0,2,0,0. Refer to document [3] for more details.  Supports master and slave mode.  Supports audio sample rate 8 kHz. l The following table shows the pin definition of PCM and I2C interface. te Table 1: Pin Definition uec tial PinName I/O PCM_IN DI Q n PCM_OUT DO e PCM_SYNC DO fid PCM_CLK DO I2C_SCL OD Con I2C_SDA OD Description PCM data input PCM data output PCM data frame sync signal PCM data bit clock I2C serial clock I2C serial data Table 2: IO Characteristics Parameter VIL VIH VOL Description Low-level input voltage High-level input voltage Low-level output voltage Min. -0.3 1.3 0 Max. Unit 0.35 V 1.85 V 0.25 V WCDMA_UGxx_Audio_Design_Note Confidential / Released 8 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note VOH High-level output voltage 1.55 VDD_EXT V NOTE The voltage of VDD_EXT is 1.8V, please refer to document [1] for details. In PCM audio format, the MSB of the channel included in the frame (PCM_SYNC) is clocked on the second CLK rising edge after the PCM_SYNC pulse rising edge. The period of the PCM_SYNC signal (frame) lasts for Data word bit +1 clock pulses. The firmware of module has integrated the configuration on NAU8814/ALC5616/MAX9860 application with I2C interface. AT+QDAC command can be used to configure the external codec chip linked with PCM interface, and refer to document [3] for more details. Data bit is 32 bit and the sampling rate is 8 KHz. The following figure shows the timing of the application with ALC5616 codec. ctel l PCM_SYNC Sampling freq. = 8 KHz ue tia PCM_CLK BCLK = 264 KHz Q en 33 32 31 fid PCM_IN/OUT MSB 32-bit data word 10 ConFigure 1: PCM Master Mode Timing WCDMA_UGxx_Audio_Design_Note Confidential / Released 9 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note For the relations between peripherals, modules and PCM CODEC, please refer to the following figure. 4.7K 4.7K BIAS CLK UART USB 0R_NM R2 PCM_CLK PCM_SYNC UART PCM_OUT PCM_IN 0R CLK_OUT Rs R1 USB I2C_SCL I2C_SDA MICBIAS BCLK LRCLK DACDAT ADCDAT MCLK SCL SDA MIC+ MIC- SPK+ SPK- Peripherals Module CODEC NM VDD_EXT Figure 2: The Connection Diagram of Peripherals, Module and Codec l NOTES te 1. The communication between the module and peripherals can be realized by UART or USB interface. c l 2. The MCLK of codec can be provided by peripherals or module. When the MCLK is provided by module, R1 is mounted and R2 is not mounted. When the MCLK is provided by peripheral, R2 is ue tia mounted and R1 is not mounted. 3. It is recommended to reserve RC (R=22Ω, C=22pF) circuit on the PCM lines, especially for PCM_CLK. Q n 4. UGxx modules provide a digital clock output (CLK_OUT) for an external audio codec, the CLK_OUT function is disabled by default. When CLK_OUT is required, AT command is used to provide the e codec with a 13/26MHz clock generated from the module. A RC (e.g. R=22Ω, C=47pF) circuit is fid recommended to be reserved on CLK_OUT line. Refer to document [3] for details. If unused, keep this pin open. n AT+QPCMON is used to enable PCM_CLK (BCLK) & PCM_SYNC when there is no audio application. The output frequency depends on the settings of AT+QDAC: sync=, Co PCM_CLK(BCLK)= * (+ 1). AT+QDAC=1,0,0,2,0,0 OK AT+QPCMON=1 //Enable PCM SYNC & BCLK, SYNC=8k, BCLK=264K OK AT+QPCMON=0 //Disable PCM SYNC & BCLK OK WCDMA_UGxx_Audio_Design_Note Confidential / Released 10 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 3 Audio Circuit Design Codec ALC5616, NAU8814 and MAX9860 have been approved for PCM application. Pin25 provides a clock ranges from 32k to 26M. This clock can be used to provide MCLK for codec. When ALC5616, NAU8814 or MAX9860 is using, Pin25 will output a 26M clock by default. AT+QPCMCLK is used to enable this clock. AT+QCLKOUT=1, 2 //Output 26M frequency OK l AT+QCLKOUT=0 //Close output te OK CQouneficdential The following chapters will show the audio design circuit with these codec. WCDMA_UGxx_Audio_Design_Note Confidential / Released 11 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 3.1. PCM Codec Design Circuit with ALC5616 The following figure shows PCM application with ALC5616 from Realtek (http://www.realtek.com.tw/), and I2C interface is equipped to configure codec. Queficdteenl tial Figure3:ALC5616CodecDesign on NOTES C 1. The RC filter circuit (R=22ohm, C=22pF) needs to be installed on PCM_CLK line. 2. VDD_3V3 and VDD_1V8 are needed to be supplied externally. 3. Set AT+QDAC=3 to choose ALC5616, MCLK is not needed, and ALC5616 uses internal PLL to generate system clock. WCDMA_UGxx_Audio_Design_Note Confidential / Released 12 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 3.2. PCM Codec Design Circuit with NAU8814 The following figure shows PCM application with NAU8814 from Nuvoton (http://www.nuvoton.com), and I2C interface is equipped to configure codec. uectel tial Figure 4: NAU8814 Codec Design Q n NOTES e 1. The RC filter circuit (R=22ohm, C=22pF) needs to be installed on PCM_CLK line. fid 2. VDD_3V3 is needed to be supplied externally. 3. Set AT+QDAC=2 to choose NAU8814, please provide 2M external crystal for NAU8814. The CLOCK_OUT pin can also provide 26M clock for NAU8814, but the quality of the voice is worse than Con 2M external crystal. WCDMA_UGxx_Audio_Design_Note Confidential / Released 13 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 3.3. PCM Codec Design Circuit with MAX9860 The following figure shows PCM application with MAX9860 from Maxim (http://www.maxim-ic.com), and I2C interface is equipped to configure codec. uectel tial Figure 5: MAX9860 Codec Design Q en NOTES fid 1. The RC filter circuit (R=22ohm, C=22pF) needs to be installed on PCM_CLK line. Con 2. Set AT+QDAC=4 to choose MAX9860, the module will provide 26M MCLK by default. WCDMA_UGxx_Audio_Design_Note Confidential / Released 14 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 3.4. Microphone Interface Design Close to Microphone Differential layout 10pF 33pF MICP_PCM 0R 10pF 33pF MICN_PCM 0R Electret Microphone 10pF 33pF tel Figure 6: Microphone Design c l 3.5. Receiver Interface Design ue tia ClosetoReceiver Q fiden SPKP_PCM n SPKN_PCM Differential layout 0R 10pF 10pF 0R Co 10pF 33pF 33pF 32Ω 33pF Figure 7: Receiver Design WCDMA_UGxx_Audio_Design_Note Confidential / Released 15 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 3.6. Earphone Interface Design The following figure shows the single-ended application for earphone design. MICN_PCM MICP_PCM Differential layout 0R 4.7uF Close to Socket 10pF 33pF l SPKP_PCM 0R 22uF 10pF 33pF Earphone 3 4 2 1 32Ω cte l Figure 8: Earphone Design ue tia 3.7. Speaker Amplifier Design Q n If the 8Ω speaker is applied, it is recommended to add an audio amplifier. eClose to Speaker onfid SPKP_PCM CSPKN_PCM Amplifier circuit Ri Ri 10pF 10pF 33pF 33pF 8Ω 10pF 33pF Figure 9: Speaker Amplifier Design WCDMA_UGxx_Audio_Design_Note Confidential / Released 16 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 4 Design Consideration 4.1. Power Supply for PCM Codec For different PCM codec, the supply voltage is different. It’s better to supply power for PCM codec with dedicated LDO, and not to share this power with other circuits. l 4.2. Audio Layout te Power supply ripple, unbalanced ground and RF burst radiation have negative effect on audio layout. c l Layout of MICP_PCM/MICN_PCM, SPKP_PCM/SPKN_PCM must meet the rule of differential signal. Moreover, these two pairs of signals should be separated from each other by flooding ground to avoid CQounefidentia echo issue from SPK signal to MIC signal. Figure 10 shows an example. Figure 10: Audio Layout WCDMA_UGxx_Audio_Design_Note Confidential / Released 17 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 4.3. TDD Noise It is important to avoid or reduce TDD noise in audio circuit design and layout, some suggestions are listed below: 1. Different capacitors have their own self-resonant frequencies due to the different fabrication processes and materials. Generally, we choose 33pF capacitor (0603 package) to filter GSM900 interference and 10pF capacitor (0603 package) to filter DCS1800 interference on the power and analog audio signal lines. It is strongly recommended to add an electrets-microphone within two capacitors (10pF and 33pF) in handset and hands-free application. These two capacitors could largely suppress coupling TDD noise from RF interference. 2. Capacitors should be placed close to audio components or audio interface, and layout must be short. 3. Flood ground area should be as large as possible to reduce the ground impedance and improve l ground integrality. te 4. Reduce power voltage ripple, especially the power supply in audio circuits. A wide layout is used from power source (like adapter interface, battery connector, or LDO output pin) to audio power supply. c l Good antenna matching is also important to reduce power ripple. ue tia 5. The filtering capacitors and ESD protection devices should be connected to main digital ground. Separate analog ground and digital ground, and connect them at a single point on the PCB by one 0 ohm resistor to reduce digital interference and background noise. Q en 6. Antenna must be stay away from audio components and layout of audio circuit. Antenna should be kept at least 5cm away from microphone. fid 7. Layout of power supply must be stay away from audio and cannot be parallel. Con 4.4. Mechanical Design It is important to consider how to suppress echo in the equipment with hands-free function or in an application of which microphone and speaker are very close to each other. The mechanical structure design has significant impact on echo issue. If it is not properly designed, the echo suppressing arithmetic in software could not make up for echo issue caused by bad mechanical structure, and even force to redesign. Echo issue could be generated by several paths, as shown in Figure 11. WCDMA_UGxx_Audio_Design_Note Confidential / Released 18 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note tel Figure 11: Five Echo Paths uec tial In these five paths, internal air-path and direct air-path are the first influential factors. Other three factors (vibrations through casework, vibrations through PCB, distant echoes) are secondary. Q n To deal with echo issue from internal air-path, you can separate microphone from internal space of chassis by foam or rubber ring which can effectively suppress the inner echo interference. Figure 12 Confide shows recommended design for microphone socket. Figure 12: Microphone Socket Design WCDMA_UGxx_Audio_Design_Note Confidential / Released 19 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTE The best installation way of microphone socket is to encase microphone by silicone cover except for front cavity, and design a cylindrical hole whose center is the exit hole inside the chassis, make the microphone with silicone cover just fit the cylindrical hole, so as to only let voice enter into microphone from the exit hole, and not from leak of chassis interior. Certain air space room should be reserved in the front cavity of microphone as it is necessary for good microphone performance. Figure 13 shows recommended design for speaker socket. Quectenl tial Figure 13: Speaker Socket Design e A good way to suppress the internal echo path is to seal the rear cavity of receiver, which is usually fid expensive. The rear cavity of receiver and speaker is important for good voice quality. A sealed rear cavity with sufficient space could produce a good voice output. An 8Ω speaker is often big and difficult to give an independently sealed rear cavity for it. However, sealing microphone socket in chassis is always useful. n Furthermore, the whole chassis must be sealed as far as possible. If there is any unavoidable leak hole, keep it far away from microphone. If the leak hole is close to microphone, the voice coming from the hole o could be picked up by MIC, and then leads to echo at the far end. If the leak hole is close to speaker, the C output voice quality could be aggravated at certain extent. 4.5. Component of SPK A SPK and receiver with higher sensitivity, flatter frequency response, less THD and impedance of 32Ω (receiver), 16Ω (receiver) or 8Ω (speaker) is recommended. These technical data are often shown in data sheet of SPK and receiver. For SPK, its frequency response and THD performance can be tested by speaker test system. SPK frequency and THD response are shown in Figure 14 and Figure 15. WCDMA_UGxx_Audio_Design_Note Confidential / Released 20 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note l Figure 14: SPK Frequency Response cte l NOTE CQounefidentia Horizontal axis is frequency, longitudinal axis is loudness and unit is dB. Figure 15: SPK THD WCDMA_UGxx_Audio_Design_Note Confidential / Released 21 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTE 1. Horizontal axis is frequency, longitudinal axis is distortion and unit is %. 2. In Figure 15, the three colors represent three venders’ products. After comprehensive comparison, the green one performs the best, and the blue one is worse, and the red one is the worst. 4.6. Components of Microphone It is recommended to use an electret microphone with a sensitivity of -42±3dB/Pa @ 2V (not less than -44±3dB) and impedance of 2.2Kohm. If RF TDD noise is detected at the MIC, please contact MIC vendor for product with better RF suppression capability. Furthermore, the microphone channel circuit can be CQouneficdteenl tial optimizedtodecreaseTDDissueatMICside. WCDMA_UGxx_Audio_Design_Note Confidential / Released 22 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 5 Audio Tuning in Different Modes There are three kinds of common modes: handset, headset, handfree. AT+QAUDMOD is used to choose modes. For each mode, there are some default settings, such as CLVL, CRSL, QSIDET, QMIC and QAUDGAIN. If the audio is not good and AT+QAUDMOD has been executed, please follow the steps below to tune audio: Step 1: Execute AT+CLVL to tune downlink volume. Step 2: Execute AT+QMIC to tune uplink volume. l Step 3: If the volume is a little smaller or higher and you have set QMIC & CLVL, please use AT+QAUDGAIN to tune it. te Step 4: If you use the recommended codec, you can use AT+QAUDCFG to tune the codec volume. Step 5: Execute AT+QSIDET to tune side tone. c l Step 6: If there is echo or noise left, please use AT+QAUDCFG to tune EEC & NR. ue tia NOTE Q n Please do not set the volume too high, otherwise it will influence EEC & NR. e This following examples show how to tune audio in three different modes: nfid 5.1. Speech Call in Handset Mode Co The default mode is set to handset mode. AT+QAUDMOD=0 //=0 is used for handset mode. OK AT+CLVL=80 //Tune downlink volume. OK AT+QMIC=0,12 //Tune uplink volume OK WCDMA_UGxx_Audio_Design_Note Confidential / Released 23 / 56 AT+QAUDGAIN=0,-1,50 OK AT+QSIDET=-100 OK UMTS/HSPA Module Series WCDMA UGxx Audio Design Note //If downlink or uplink volume is a litter lower or higher, please use AT+QAUDGAIN to tune it. //Tune side tone 5.2. Speech Call in Headset Mode Set AT+QAUDMOD=1 to use Headset mode. AT+QAUDMOD=1 OK l AT+CLVL=70 te OK AT+QMIC=1,14 uec tial OK AT+QAUDGAIN=1,60,-1 Q n OK AT+QSIDET=-100 e OK //=1 is used for headset mode. //Tune downlink volume. //Tune uplink volume //If downlink or uplink volume is a litter lower or higher, please use AT+QAUDGAIN to tune it. //Tune side tone nfid 5.3. Speech Call in Handfree Mode Co Set AT+QAUDMOD=2 to use Headset mode. This mode is always used for vehicle-mounted devices. AT+QAUDMOD=2 //=2 is used for handfree mode. OK AT+CLVL=50 //Tune downlink volume. OK AT+QMIC=2,12 //Tune uplink volume OK WCDMA_UGxx_Audio_Design_Note Confidential / Released 24 / 56 AT+QAUDGAIN=2,100,60 OK AT+QSIDET=-450 OK UMTS/HSPA Module Series WCDMA UGxx Audio Design Note //If downlink or uplink volume is a litter lower or higher, please use AT+QAUDGAIN to tune it. //Tune side tone CQouneficdteenl tial WCDMA_UGxx_Audio_Design_Note Confidential / Released 25 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6 Audio AT Command Description This chapter will introduce the common audio related AT commands. For more details, please refer to document [3]. 6.1. AT+QDAC Digital Audio Interface Configuration AT+QDAC is used to configure the digital audio interface. While =1, you can define the PCM interface by yourself; while =2, and the external codec chip linked with PCM interface is the l NAU8814 model through the I2C, the module can be used directly and set by the default configurations. while =3, and the external codec chip linked with PCM interface is the ALC5616 model through the te I2C, the module can be used directly and set by the default configurations. while =4, and the external c l codec chip linked with PCM interface is the MAX9860 model through the I2C, the module can be used directly and set by the default configurations. ue tia AT+QDAC Digital Audio Interface Configuration Test Command Q n AT+QDAC=? Response +QDAC:(1-4),(0,1),(0-8),(0-2),(0,1),(0,1) fide Read Command AT+QDAC? OK Response +QDAC:[,,,,,] nOK o Write Command Response C AT+QDAC=[,,,,,< ERROR data_format>] Maximum Response Time 300ms WCDMA_UGxx_Audio_Design_Note Confidential / Released 26 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Parameter 1 Digital PCM output (customer defined) 2 Analog output (for default audio codec NAU8814) 3 Analog output (for default audio codec ALC5616) 4 Analog output (for default audio codec MAX9860) 0 Master mode 1 Slave mode 0 8K 1 11K 2 12K 3 16k 4 5 6 7 l 8 0 te 2 0 c l 1 ue tia 0 1 22K 24K 32K 44K 48K 16-bit 32-bit Mono Stereo PCM I2S Q n NOTES e 1. Configuration of will be saved to NV immediately by default. 2. The module provides clock, and clock depends on and fid 3. When you select ALC5616, NAU8814 or MAX9860, please do not input other parameters, the PCM interface is set by the default configurations. on Example C AT+QDAC=? //Query the range. +QDAC: (1-4),(0,1),(0,8),(0-2),(0,1),(0,1) OK AT+QDAC? +QDAC: 1,0,0,2,0,0 //Query current interface configuration. OK AT+QDAC=1,0,0,2,0,0 OK AT+QDAC=2 //Set PCM interface to master mode, PCM format. //Select NAU8814. WCDMA_UGxx_Audio_Design_Note Confidential / Released 27 / 56 OK AT+QDAC=3 OK AT+QDAC=4 OK //Select ALC5616. //Select MAX9860. UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6.2. AT+QIIC IIC Read&Write AT+QIIC is used to configure the codec via I2C interface. AT+QIIC IIC Read&Write Test command AT+QIIC=? Response +QIIC: (0,1),(0-FF),(0-FF),(1,2),(0-FFFF) tel Set command AT+QIIC=,,,[,] OK Response OK Response +QIIC: Q n Maximum Response Time OK 300ms fide Parameter n o C 0 1 0-0xFF 0-0xFF 1-2 Write command Read command Device address Register address Read/write bytes 0-0xFFFF Data value NOTE Configuration will be not saved. WCDMA_UGxx_Audio_Design_Note Confidential / Released 28 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6.3. AT+CLVL Loud Speaker Volume Level AT+CLVL is used to select the volume of the internal loudspeaker of the module. AT+CLVL Loud Speaker Volume Level Test Command AT+CLVL=? Response +CLVL: (list of supporteds) Read Command AT+CLVL? OK Response +CLVL: Write Command AT+CLVL= ctel l Maximum Response Time Reference ue tia 3GPPTS27.007 OK Response OK If error is related to ME functionality: +CME ERROR: 300ms Q n Parameter fide Integer type, value (0-100) with manufacturer specific range (Smallest value represents the lowest sound level), the default value of mode 0 is 80, the default value of mode 1 is 70 and the default value of mode 2 is 50. n NOTES Co This parameter will not be saved. 6.4. AT+QAUDGAIN Set Gain Offset This command is to set gain offset to change uplink and downlink volume. AT+QAUDGAIN Set Gain Offset Test Command Response WCDMA_UGxx_Audio_Design_Note Confidential / Released 29 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note AT+QAUDGAIN=? +QAUDGAIN: (0-2),(-600~300),(-600~300) OK Set Command AT+QAUDGAIN=[,,] Response If configuration parameters are omitted: +QAUDGAIN:,, OK If configuration parameters are entered: OK ERROR Maximum Response Time 300ms Parameter tel uec tial Q en Numeric type, audio mode 0 Handset 1 Headset 2 Handfree Numeric type, value: -600~300, indicates uplink gain offset. Default value of mode 0 is -1, the default value of mode 1 is 60, and the default value of mode 2 is 100. Numeric type, value: -600~300, indicates downlink gain offset. Default value of mode 0 is 50, the default value of mode 1 is -1, and the default value of mode 2 is 60. fid NOTE Con This parameter will be saved to NV by default. 6.5. AT+QMIC Set Uplink(MIC) Volume This command is to set MIC gains to change uplink volume. AT+QMIC Set Uplink(MIC) Volume Test Command AT+QMIC=? Response +QMIC: (0-2),(0-15) OK WCDMA_UGxx_Audio_Design_Note Confidential / Released 30 / 56 Read Command AT+QMIC? Set Command AT+QMIC=, Maximum Response Time UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Response +QMIC: ,, OK Response OK ERROR 300ms Parameter tel Numeric type, audio mode 0 Handset 1 Headset 2 Handfree Numeric type, indicates uplink volume, range: 0-15, the default value of mode 0 is 12, the default value of mode 1 is 14, and the default value of mode 2 is 13. uec tial NOTE These parameters will not be saved. Q fiden 6.6. AT+CMUT Mute Control AT+CMUT is used to enable and disable the uplink voice mute during a voice call. on AT+CMUT Mute Control C Test Command Response AT+CMUT=? +CMUT: (0,1) Read Command AT+CMUT? OK Response +CMUT: Write Command AT+CMUT= OK Response OK WCDMA_UGxx_Audio_Design_Note Confidential / Released 31 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Maximum Response Time Reference 3GPP TS 27.007 If error is related to ME functionality: +CME ERROR: 300ms Parameter 0 Mute off 1 Mute on NOTE This parameter will not be saved. ctel l 6.7. AT+QCLKOUT Output Clock Source ue tia AT+QCLKOUT is used to output clock source from pin25. AT+QCLKOUT Output Clock Source Q n Test Command e AT+QCLKOUT=? Response +QCLKOUT: (0,1),(1-4) fid Read Command AT+QCLKOUT? OK Response +QCLKOUT: , Con Write Command OK +CME ERROR: Response AT+QCLKOUT=[,] OK ERROR Maximum Response Time 300ms WCDMA_UGxx_Audio_Design_Note Confidential / Released 32 / 56 Parameter 0 Disable to output clock source. 1 Enable to output clock source. 1 26MHz 2 13MHz 3 6.5MHz 4 32.768KHz UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTES 1. Parameters will not be saved to NV. 2. When Pin25 is busy, it will return CME error. l 6.8. AT+QSIDET Set the Side Tone Gain in the Current Mode te AT+QSIDET is used to set the side tone gain value of the current mode. uec tial AT+QSIDET Set the Side Tone Gain in Current Mode Test Command AT+QSIDET=? Response +QSIDET: (-450~200) Q en Read Command fid AT+QSIDET? OK Response +QSIDET: n Write Command AT+QSIDET= Co Maximum Response Time OK Response OK ERROR 300ms Parameter Numeric type, indicates the configured side tone gain in current mode. Range: -450~200. The default value of mode 0 is -100, the default value of mode 1 is -100, and the default value of mode 2 is -450. WCDMA_UGxx_Audio_Design_Note Confidential / Released 33 / 56 NOTE Parameter will be saved to NV immediately by default. UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6.9. AT+QAUDLOOP Enable Audio Loop Test This command is used to enable audio loop test. AT+QAUDLOOP Enable Audio Loop Test Test Command AT+QAUDLOOP=? Response +QAUDLOOP: (0,1),(0-2) l Read Command te AT+QAUDLOOP? OK Response +QAUDLOOP: , uec tial SetCommand AT+QAUDLOOP=[,] OK Response OK ERROR Q n Maximum Response Time 300ms fide Parameter Con Numeric type; to enable or disable audio loop test 0 Disable audio loop test 1 Enable audio loop test Compatible argument, no effect NOTE These parameters will not be saved. WCDMA_UGxx_Audio_Design_Note Confidential / Released 34 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6.10. AT+QAUDMOD Set Audio Mode AT+QAUDMOD sets the audio mode required for the connected device. AT+QAUDMOD Set Audio Mode Test Command AT+QAUDMOD=? Response +QAUDMOD: (0-2) Read command AT+QAUDMOD? OK Response +QAUDMOD: Write Command AT+QAUDMOD= ctel l Maximum Response Time OK Response OK If error is related to ME functionality: +CME ERROR: 300ms ue tia Parameter Q en Numeric type, indicates the current configured audio mode 0 Echo canceller, noise suppressor, digital gain and calibration parameter for Handset 1 Echo canceller, noise suppressor, digital gain and calibration parameter for Headset 2 Echo canceller, noise suppressor, digital gain and calibration parameter for Speaker fid NOTE Con These parameters will not be saved. 6.11. AT+CRSL Set Ring Tone Volume AT+CRSL can be used to set the volume of ring tone. AT+CRSL Set Ring Tone Volume Test Command AT+CRSL=? Response +CRSL: (list of supported s) WCDMA_UGxx_Audio_Design_Note Confidential / Released 35 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Read Command AT+CRSL? Write Command AT+CRSL= Maximum Response Time OK Response +CRSL: OK Response OK ERROR 300ms Parameter l Numeric type, indicates the configured volume of ring tone. Range: 0-100, the default value of mode 0 is 80, the default value of mode 1 is 50, and the default value of mode 2 is 80. te NOTE c l This parameter will not be saved. Que ntia 6.12. AT+CALM Mute the Ring Tone fide AT+CALM is used to mute the ring tone. There is no ring tone when a call is coming. AT+CALM Mute the Ring Tone n Test Command AT+CALM=? Response +CALM: (list of supported s) Co OK Read Command AT+CALM? Response +CALM: Write Command AT+CALM= Maximum Response Time OK Response OK ERROR 300ms WCDMA_UGxx_Audio_Design_Note Confidential / Released 36 / 56 Parameter Numeric type 0 Ring tone is normal 1 Ring tone is mute NOTE This parameter will not be saved. UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6.13. AT+QPCMON Enable PCM Sync & BCLK l AT+QPCMON is used to enable PCM sync & BCLK. te AT+QPCMON Enable PCM Sync & BCLK Test Command c l AT+QPCMON=? Response +QPCMON: (list of supported s) ue tia ReadCommand Q n AT+QPCMON? OK Response +QPCMON: fide Write Command AT+QPCMON= n Maximum Response Time OK Response OK ERROR 300ms Co Parameter Numeric type 0 Disable PCM sync & BCLK 1 Enable PCM sync & BCLK NOTE This parameter will not be saved. WCDMA_UGxx_Audio_Design_Note Confidential / Released 37 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6.14. AT+QAUDCFG Audio Tuning Process AT+QAUDCFG is used to query and configure various audio settings of UE. AT+QAUDCFG Audio Tuning Process Test Command Response AT+QAUDCFG=? +QAUDCFG: 'handset/eec', (list of supported s) +QAUDCFG: ' headset/eec', (list of supported s) +QAUDCFG: 'handfree/eec', CQouneficdteenl tial MaximumResponseTime (list of supported s) +QAUDCFG: ' handset /nr/ul', (list of supported s) +QAUDCFG: 'headset /nr/ul', (list of supported s) +QAUDCFG: 'handfree/nr/ul', (list of supported s) +QAUDCFG: 'handset/nr/dl', (list of supported s) +QAUDCFG: 'headset /nr/dl ', (list of supported s) +QAUDCFG: 'handfree/nr/dl ', (list of supported s) +QAUDCFG: 'nau8814/dlgain', +QAUDCFG: 'nau8814/ulgain', +QAUDCFG: 'alc5616/dlgain', +QAUDCFG: 'alc5616/ulgain', +QAUDCFG: 'max9860/dlgain', +QAUDCFG: 'max9860/ulgain', OK 300ms 6.14.1. AT+QAUDCFG='handset/eec' Set Echo Cancellation for Handset AT+QAUDCFG='handset/eec' is used to set echo cancellation for handset. AT+QAUDCFG='handset/eec' Set Echo Cancellation for Handset Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'handset/eec', WCDMA_UGxx_Audio_Design_Note Confidential / Released 38 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Write Command AT+QAUDCFG='handset/eec'[,] …… OK Response If configuration parameters are omitted: +QAUDCFG: 'handset/eec', OK If configuration parameters are entered: OK ERROR Parameter List of integers, separated by dot (.) l Par0 Echocancollationcontrol word, 1: enable, 0: disable, default value might be different in different audio modes te Par1 AEC (Acoustic Echo Canceller) control word, 1: enable, 0: disable, default value might be different in different audio modes c l Par2 EC_NrCoeffs_Real, Number of taps in real subband, range: 1-528. Default value ue tia might be different in different audio modes Par3 EC_NrCoeffs_Complex_1, Number of taps in complex subband 1, range: 1-528. Default value might be different in different audio modes Par4 EC_NrCoeffs_Complex_2, Number of taps in complex subband2, range: 1-528. Q n Default value might be different in different audio modes e Par5 EC_NrCoeffs_Complex_3, Number of taps in complex subband3, range: 1-528. Default value might be different in different audio modes fid Par6 EC_NrCoeffs_Complex_4, Number of taps in complex subband4, range: 1-528. Default value might be different in different audio modes Par7 EC_NrCoeffs_Complex_5, Number of taps in complex subband5, range: 1-528. n Default value might be different in different audio modes Par8 EC_Blen, NLMS update block length range: (1,2,4,5,8). Default value might be odifferent in different audio modes CPar9 SER (Spectral Echo Reduction) control word, 1: enable, 0: disable, default value might be different in different audio modes Par10 SER_Beta, Smoothing factor of the echo reduction applied by the SER, range: 0-32767. Default value might be different in different audio modes Par11 SER_Overest, Overestimation factor of the echo estimation, range: 0-32767. Default value might be different in different audio modes Par12 SER_NoiseLevel, Overestimation factor of the noise estimation, range: 0-32767. Default value might be different in different audio modes Par13 SER_MultCtrl, Allowed amplitude of short-term variations of noise estimation, range: 0-32767. Default value might be different in different audio modes WCDMA_UGxx_Audio_Design_Note Confidential / Released 39 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTES Par14 AGC (Automatic Gain Control) control word, 1: enable, 0: disable, default value might be different in different audio modes Par15 RE_LdAddGain, Additionalgain, range: -16384~16384. Default value might be different in different audio modes Par16 RE_LdGainLoLim, Total gain lower limit, range: 0-16384. Default value might be different in different audio modes Par17 RE_LdGainUpLim, Total gain upper limit, range: 0-16384. Default value might be different in different audio modes Par18 RE_NrShliFilt, Shifts for gain smoothing, range: -36~36. Default value might be different in different audio modes Par19 RE_TriggerOffset, AGC trigger offset for the decision logic to allow more double-talk, range: -16384~16384. Default value might be different in different Par20 l Par21 te Par22 uec tial Par23 Q n Par24 fide Par25 Con Par26 audio modes RE_FarPowerCenter, Threshold on far-end power (below which overestimation is Par22, above which estimationisPar23), range: 0-16384. Default value might be different in different audio modes RE_FarPowerDistorted, Threshold on far-end overestimated power (above which overestimated by Par24, to compensate residual echo when strong LS distortion), range: 0-16384. Default value might be different in different audio modes RE_FarOverEstR0, Far-end power overestimation ratio if loudspeaker power is below Par20, range: 0-14666. Default value might be different in different audio modes RE_FarOverEstR1, Far-end power overestimation ratio if loudspeaker power is abovePar20, range: 0-14666. Default value might be different in different audio modes RE_FarOverEstR2, Far-end power overestimation ratio if loudspeaker power is above Par21, range: 0-16384. Default value might be different in different audio modes EDL (Echo Delay Lines) control word, 1: enable, 0: disable, default value might be different in different audio modes Delay in milliseconds in the echo reference path, range: 0-60. Default value might be different in different audio modes 1. Auto save the configuration to NV. The setting is still valid after module restart. 2. If you set Par1 & Par9 & Par14 & Par25 to 0, please set Par0 to 0, otherwise it will return error. When you set Par0 to 0, Par1 & Par9 & Par14 & Par25 will be set to 0 by default. 3. Par2+2*(Par3 Par4+Par5+Par6+Par7) < 2200. Example AT+QAUDCFG='handset/eec','1.1.100.100.100.1.1.1.2.1.32113.16384.2560.4096.1.0.0.5000.0.0.512 0.12288.256.282.307.1.0' //Set configuration to default WCDMA_UGxx_Audio_Design_Note Confidential / Released 40 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note OK AT+QCFG='handset/eec' //Query +QAUDCFG: 'handset/eec','1.1.100.100.100.1.1.1.2.1.32113.16384.2560.4096.1.0.0.5000.0.0.5120.12288.256.282. 307.1.0' OK 6.14.2. AT+QAUDCFG='headset/eec' Set Echo Cancellation for Headset AT+QAUDCFG='headset/eec' is used to set echo cancellation for headset. AT+QAUDCFG='headset/eec' Set Echo Cancellation for Headset Test Command ctel l AT+QAUDCFG=? Response …… +QAUDCFG: 'headset/eec', …… OK ue tia WriteCommand AT+QAUDCFG='headset/eec'[,] Response If configuration parameters are omitted' +QAUDCFG: 'headset/eec', Q n OK e If configuration parameters are entered' fidOK ERROR n Parameter Co List of integers, separated by dot (.), for details, please refer to of AT+QAUDCFG='handset/eec' Example AT+QAUDCFG='headset/eec','1.1.100.100.100.1.1.1.2.1.32113.16384.2560.4096.1.0.0.5000.0.0.512 0.12288.256.282.307.1.0' //Set configuration to default OK AT+QCFG='headset/eec' //Query WCDMA_UGxx_Audio_Design_Note Confidential / Released 41 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note +QAUDCFG: 'headset/eec','1.1.100.100.100.1.1.1.2.1.32113.16384.2560.4096.1.0.0.5000.0.0.5120.12288.256.282. 307.1.0' OK 6.14.3. AT+QAUDCFG='handfree/eec' Set Echo Cancellation for Handfree AT+QAUDCFG='handfree/eec' is used to set echo cancellation for handfree. AT+QAUDCFG='handfree/eec' Set Echo Cancellation for Headfree Test Command Response AT+QAUDCFG=? …… l Write Command uecte tial AT+QAUDCFG='handfree/eec'[,] +QAUDCFG: 'handfree/eec', …… OK Response If configuration parameters are omitted: +QAUDCFG='handfree/eec', OK If configuration parameters are entered: OK ERROR Q en Parameter fid List of integers, separated by dot (.), for more details, please refer to of AT+QAUDCFG='handset/eec'. n Example o AT+QAUDCFG='handfree/eec','1.1.150.150.150.1.1.1.2.1.32113.16384.10240.16384.1.1800.80.8192 C .0.0.6144.12288.256.282.307.1.0' //Set configuration to default OK AT+QCFG='handfree/eec' //Query +QAUDCFG: 'handfree/eec','1.1.150.150.150.1.1.1.2.1.32113.16384.10240.16384.1.1800.80.8192.0.0.6144.12288. 256.282.307.1.0' OK WCDMA_UGxx_Audio_Design_Note Confidential / Released 42 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 6.14.4. AT+QAUDCFG='handset/nr/ul' Set Uplink Noise Reduction for Handset AT+QAUDCFG='handset/nr/ul' is used to set uplink noise reduction for handset. AT+QCFG='handset/nr/ul' Set Uplink Noise Reduction for Handset Test Command AT+QAUDCFG=? Response …… +QAUDCFG: 'handset/nr/ul', …… OK Write Command Response AT+QAUDCFG='handset/nr/ul'[,] If configuration parameters are omitted: +QAUDCFG: 'handset/nr/ul', OK l If configuration parameters are entered: te OK ERROR uec tial Parameter CQonfiden List of integers, separated by dot (.). Par0 Noise Reduction control word, 1: enable, 0: disable, Default value might be different in different audio modes Par1 NR_AttenFactorMinVal, Minimum value of Noise Reduction gain, range: 0-32767. Default value might be different in different audio modes Par2 NR_OvEstFacBandZero, Overestimation factor for Noise Reduction in band 0, range: 0-32767. Default value might be different in different audio modes Par3 NR_OvEstFacBandNoZero, Overestimation factor for Noise Reduction in band 1 to 7, range: 0-32767. Default value might be different in different audio modes Par4 NR_GainFactor, Defines how aggressive the NR is, range: 0-32767. Default value might be different in different audio modes Par5 NR_GainLimit, Maximum gain allow, range: 0-32767. Default value might be different in different audio modes NOTE Auto save the configuration to NV. The setting is still valid after module restart. WCDMA_UGxx_Audio_Design_Note Confidential / Released 43 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Example AT+QAUDCFG='handset/nr/ul', '1.6000.9000.10000.1800.19660' //Set configuration to default OK AT+QAUDCFG='handset/nr/ul' //Query +QAUDCFG: 'handset/nr/ul', '1.6000.9000.10000.1800.19660' OK 6.14.5. AT+QAUDCFG='handset/nr/dl' Set Down Link Noise Reduction for Handset AT+QAUDCFG='handset/nr/dl' is used to set down link noise reduction for handset. AT+QCFG='handset/nr/dl' Set Down Link Noise Reduction for Handset l Test Command cte l AT+QAUDCFG=? Response …… +QAUDCFG: 'handset/nr/dl', …… OK ue tia WriteCommand AT+QAUDCFG='handset/nr/dl'[,] Response If configuration parameters are omitted: +QAUDCFG:'handset/nr/dl', Q n OK fide If configuration parameters are entered: OK ERROR n Parameter Co List of integers, separated by dot (.). For more details, please refer to of AT+ QAUDCFG='handset/nr/ul' NOTE Auto save the configuration to NV. The setting is still valid after module restart. WCDMA_UGxx_Audio_Design_Note Confidential / Released 44 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Example AT+QAUDCFG='handset/nr/dl','1.12000.10000.10000.1000.19660' //Set configuration to default OK AT+QAUDCFG='handset/nr/dl' //Query +QAUDCFG: 'handset/nr/dl','1.12000.10000.10000.1000.19660' OK 6.14.6. AT+QAUDCFG='headset/nr/dl' Set Down Link Noise Reduction for Headset AT+QAUDCFG='headset/nr/dl' is used to set down link noise reduction for headset. AT+QCFG='headset/nr/dl' Set Down Link Noise Reduction for Headset l Test Command cte l AT+QAUDCFG=? Response …… +QAUDCFG: 'headset/nr/dl', …… OK ue tia WriteCommand AT+QAUDCFG='headset/nr/dl'[,] Response If configuration parameters are omitted: +QAUDCFG: 'headset/nr/dl', Q n OK fide If configuration parameters are entered: OK ERROR on Parameter C List of integers, separated by dot (.). For details, please refer to of AT+ QAUDCFG='handset/nr/ul' NOTE Auto save the configuration to NV. The setting is still valid after module restart. WCDMA_UGxx_Audio_Design_Note Confidential / Released 45 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Example AT+QAUDCFG='headset/nr/dl','1.12000.10000.10000.1000.19660' //Set configuration to default OK AT+QAUDCFG='headset/nr/dl' //Query +QAUDCFG: 'headset/nr/dl', '1.12000.10000.10000.1000.19660' OK 6.14.7. AT+QAUDCFG='headset/nr/ul' Set Uplink Noise Reduction for Headset AT+QAUDCFG='headset/nr/ul' is used to set uplink noise reduction for headset. AT+QCFG='headset/nr/ul' Set Uplink Noise Reduction for Headset l Test Command AT+QAUDCFG=? uecte tial WriteCommand AT+QAUDCFG='headset/nr/ul'[,] Response …… +QAUDCFG: 'headset/nr/ul', …… OK Response If configuration parameters are omitted: +QAUDCFG: 'headset/nr/ul', Q n OK fide If configuration parameters are entered: OK ERROR on Parameter C List of integers, separated by dot (.). For details, please refer to of AT+ QAUDCFG='handset/nr/ul' NOTE Auto save the configuration to NV. The setting is still valid after module restart. WCDMA_UGxx_Audio_Design_Note Confidential / Released 46 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Example AT+QAUDCFG='headset/nr/ul','1.6000.9000.10000.1800.19660' OK AT+QAUDCFG='headset/nr/ul' +QAUDCFG: 'headset/nr/ul','1.6000.9000.10000.1800.19660' OK //Set configuration to default //Query 6.14.8. AT+QAUDCFG='handfree/nr/dl' Set Down Link Noise Reduction for Handfree AT+QAUDCFG='handfree/nr/dl' is used to set down link noise reduction for handfree. l AT+QCFG='handfree/nr/dl' Set Down Link Noise Reduction for Handfree te Test Command uec tial AT+QAUDCFG=? Response …… +QAUDCFG: 'handfree/nr/dl', …… OK Write Command Q n AT+QAUDCFG='handfree/nr/dl'[,] Response If configuration parameters are omitted: +QAUDCFG: 'handfree/nr/dl', e OK fidIf configuration parameters are entered: OK n ERROR Co Parameter List of integers, separated by dot (.). For details, please refer to of AT+ QAUDCFG='handset/nr/ul' NOTE Auto save the configuration to NV. The setting is still valid after module restart. WCDMA_UGxx_Audio_Design_Note Confidential / Released 47 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Example AT+QAUDCFG='handfree/nr/dl','1.12000.10000.10000.1000.19660' //Set configuration to default OK AT+QAUDCFG='handfree/nr/dl' //Query +QAUDCFG: 'handfree/nr/dl','1.12000.10000.10000.1000.19660' OK 6.14.9. AT+QAUDCFG='handfree/nr/ul' Set Uplink Noise Reduction for Handfree AT+QAUDCFG='handfree/nr/ul' is used to set uplink reduction for handfree. AT+QCFG='handfree/nr/ul' Set Uplink Noise Reduction for Handfree l Test Command cte l AT+QAUDCFG=? Response …… +QAUDCFG: 'handfree/nr/ul', …… OK ue tia WriteCommand AT+QAUDCFG='handfree/nr/ul'[,] Response If configuration parameters are omitted: +QAUDCFG: 'handfree/nr/ul', Q n OK fide If configuration parameters are entered: OK ERROR on Parameter C List of integers, separated by dot (.). For details, please refer to of AT+ QAUDCFG='handset/nr/ul' NOTE Auto save the configuration to NV. The setting is still valid after module restart. WCDMA_UGxx_Audio_Design_Note Confidential / Released 48 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note Example AT+QAUDCFG='handfree/nr/ul','1.6000.9000.10000.1800.19660' //Set configuration to default OK AT+QAUDCFG='handfree/nr/ul' //Query +QAUDCFG: 'handfree/nr/ul','1.6000.9000.10000.1800.19660' OK 6.14.10. AT+QAUDCFG='nau8814/dlgain' Set Down Link Gain Level for Codec nau8814 AT+QAUDCFG='nau8814/dlgain' is used to set down link gain level for codec nau8814. l AT+QAUDCFG='nau8814/dlgain' Set Down Link Gain Level for Codec nau8814 te Test Command AT+QAUDCFG=? uec tial WriteCommand Q n AT+QAUDCFG='nau8814/dlgain'[,] Response …… +QAUDCFG: 'nau8814/dlgain', …… OK Response If configuration parameters are omitted: (+QAUDCFG='nau8814/dlgain'), fide Return current configuration: +QAUDCFG: 'nau8814/dlgain', OK n If configuration parameters are entered: o OK C ERROR If error is related to ME functionality: +CME ERROR: Parameter Numeric type, indicates the downlink gain of nau8814, range: 0-100, default: 100 WCDMA_UGxx_Audio_Design_Note Confidential / Released 49 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTE This parameter will not be saved. Example AT+QAUDCFG='nau8814/dlgain',85 OK //Set downlink gain to 85 6.14.11. AT+QAUDCFG='nau8814/ulgain' Set Uplink Gain Level for Codec nau8814 AT+QAUDCFG='nau8814/ulgain' is used to set uplink gain level for codec nau8814. AT+QAUDCFG='nau8814/ulgain' Set Uplink Gain Level for Codec nau8814 l Test Command te AT+QAUDCFG=? uec tial WriteCommand AT+QAUDCFG='nau8814/ulgain'[,] Response …… +QAUDCFG: 'nau8814/ulgain', …… OK Response If configuration parameters are omitted: (+QAUDCFG='nau8814/ulgain'), Q en Return current configuration: +QAUDCFG: 'nau8814/ulgain', fidOK If configuration parameters are entered: n OK ERROR Co If error is related to ME functionality: +CME ERROR: Parameter Numeric type, indicates the uplink gain of nau8814, range: 0-100, default: 84 WCDMA_UGxx_Audio_Design_Note Confidential / Released 50 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTE This parameter will not be saved. Example AT+QAUDCFG='nau8814/ulgain',90 OK //Set uplink gain to 90 6.14.12. AT+QAUDCFG='alc5616/dlgain' Set Down Link Gain Level for Codec alc5616 AT+QAUDCFG='alc5616/dlgain' is used to set down link gain level for codec alc5616. l AT+QAUDCFG='alc5616/dlgain' Set Down Link Gain Level for Codec alc5616 te Test Command c l AT+QAUDCFG=? ue tia WriteCommand Q en AT+QAUDCFG='alc5616/dlgain'[,] Response …… +QAUDCFG: 'alc5616/ dlgain', …… OK Response If configuration parameters are omitted: (+QAUDCFG='alc5616/dlgain'), fidReturn current configuration: +QAUDCFG: 'alc5616/dlgain', OK n If configuration parameters are entered: o OK C ERROR If error is related to ME functionality: +CME ERROR: Parameter Numeric type, indicates the downlink gain of alc5616, range: 0-100, default: 100 WCDMA_UGxx_Audio_Design_Note Confidential / Released 51 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTE This parameter will not be saved. Example AT+QAUDCFG='alc5616/dlgain',85 OK //Set downlink gain to 85 6.14.13. AT+QAUDCFG='alc5616/ulgain' Set Uplink Gain Level for Codec alc5616 AT+QAUDCFG='alc5616/ulgain' is used to set uplink gain level for codec alc5616. AT+QAUDCFG='alc5616/ulgain' Set Uplink Gain Level for Codec alc5616 l Test Command te AT+QAUDCFG=? uec tial WriteCommand Q n AT+QAUDCFG='alc5616/ulgain'[,] Response …… +QAUDCFG: 'alc5616/ ulgain', …… OK Response If configuration parameters are omitted: (+QAUDCFG='alc5616/ulgain'), e Return current configuration: +QAUDCFG: 'alc5616/ulgain', fidOK If configuration parameters are entered: n OK ERROR Co If error is related to ME functionality: +CME ERROR: Parameter Numeric type, indicates the uplink gain of alc5616, range: 0-100, default: 74 WCDMA_UGxx_Audio_Design_Note Confidential / Released 52 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTE This parameter will not be saved. Example AT+QAUDCFG='alc5616/ulgain',85 OK //Set uplink gain to 85 6.14.14. AT+QAUDCFG='max9860/dlgain' Set Down Link Gain Level for Codec max9860 AT+QAUDCFG='max9860/dlgain' is used to set down link gain level for codec max9860. l AT+QAUDCFG='max9860/dlgain' Set Down Link Gain Level for Codec max9860 te Test Command c l AT+QAUDCFG=? ue tia WriteCommand Q en AT+QAUDCFG='max9860/dlgain'[,] Response …… +QAUDCFG: 'max9860/dlgain', …… OK Response If configuration parameters are omitted: (+QAUDCFG='max9860/dlgain'), fidReturn current configuration: +QAUDCFG: 'max9860/dlgain', OK n If configuration parameters are entered: o OK C ERROR If error is related to ME functionality: +CME ERROR: Parameter Numeric type, indicates the down link gain of max9860, range: 0-100, default: 87 WCDMA_UGxx_Audio_Design_Note Confidential / Released 53 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTE This parameter will not be saved. Example AT+QAUDCFG='max9860/dlgain',85 //Set downlink gain to 85 OK 6.14.15. AT+QAUDCFG='max9860/ulgain' Set Uplink Gain Level for Codec max9860 AT+QAUDCFG='max9860/ulgain' is used to set uplink gain level for codec max9860. AT+QAUDCFG='max9860/ulgain' Set Uplink Gain Level for Codec max9860 l Test Command te AT+QAUDCFG=? uec tial WriteCommand Q n AT+QAUDCFG='max9860/ulgain'[,] Response …… +QAUDCFG: 'max9860/ulgain', …… OK Response If configuration parameters are omitted: (+QAUDCFG='max9860/ulgain'), e Return current configuration: +QAUDCFG: 'max9860/ulgain', fidOK If configuration parameters are entered: n OK ERROR Co If error is related to ME functionality: +CME ERROR: Parameter Numeric type, indicates the uplink gain of max9860, range: 0-100, default: 80 WCDMA_UGxx_Audio_Design_Note Confidential / Released 54 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note NOTE This parameter will not be saved. Example AT+QAUDCFG='max9860/ulgain',85 //Set uplink gain to 85 OK AUDCFG='handset/nr/dl','1.12000.10000.10000.1000.19660' //Set configuration to default OK AT+QAUDCFG='handset/nr/dl' //Query +QAUDCFG: 'handset/nr/dl','1.12000.10000.10000.1000.19660' CQouneficdteenl tial OK WCDMA_UGxx_Audio_Design_Note Confidential / Released 55 / 56 UMTS/HSPA Module Series WCDMA UGxx Audio Design Note 7 Appendix Table 3: Related Documents SN Document name Remark [1] Quectel_UGxx_Hardware_Design UG95 and UG96 Hardware Design [2] Quectel_UGxx_Reference_Design UG95 and UG96 Reference Design Quectel_WCDMA_UGxx_AT_Commands_ [3] UGxx AT Commands Manual l Manual te Table 4: Terms and Abbreviations c l Abbreviation ue tia LDO Q n ME e NV Confid PCM Description Low Dropout Regulator Mobile Equipment (UG95 and UG96 Module) Non-Volatile Memory Pulse-code Modulation WCDMA_UGxx_Audio_Design_Note Confidential / Released 56 / 56

GNSS Low Power Mode Application Note GNSS Module Series Rev. GNSS_Low_Power_Mode_Application_Note_V2.0 Date: 2016-05-16 www.quectel.com GNSS Module Series GNSS Low Power Mode Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. GNSS_Low_Power_Mode_Application_Note Confidential / Released 1 / 12 GNSS Module Series GNSS Low Power Mode Application Note About the Document History Revision 1.0 2.0 Date 2015-08-21 Author Connie ZHOU CQouneficdteenl tial 2016-05-16 Ziv LIAO Description Initial 1. Changed the document name from Fitness_Low_Power_Application_Note to GNSS_Low_Power_Mode_Application_Note 2. Added GLP mode GNSS_Low_Power_Mode_Application_Note Confidential / Released 2 / 12 GNSS Module Series GNSS Low Power Mode Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 1 Introduction .......................................................................................................................................... 5 2 Power Consumption ............................................................................................................................ 6 3 Quectel NMEA Packet Protocol.......................................................................................................... 7 3.1 Quectel NMEA Packet Format......................................................................................................... 7 3.2 Packet Type: PQBAUD Set NMEA Port Baudrate ........................................................................ 7 3.3 Packet Type: PQFLP Set the Module into FLP Mode................................................................... 8 4 3.4 Packet Type: PQGLP Set the Module into GLP Mode ................................................................. 9 Enter into or Exit from Low Power Mode ........................................................................................ 11 4.1 Enter into/Exit from FLP Mode....................................................................................................... 11 CQouneficdteenl tial 4.2 Enter into/Exit from GLP Mode...................................................................................................... 11 GNSS_Low_Power_Mode_Application_Note Confidential / Released 3 / 12 GNSS Module Series GNSS Low Power Mode Application Note Table Index TABLE 1: AVERAGE CURRENT IN FLP MODE AND NORMAL MODE (L70 MODULE) .......................... 6 TABLE 2: AVERAGE CURRENT IN GLP MODE AND NORMAL MODE (L76 MODULE).......................... 6 CQouneficdteenl tial GNSS_Low_Power_Mode_Application_Note Confidential / Released 4 / 12 GNSS Module Series GNSS Low Power Mode Application Note 1 Introduction Low power mode is an optimized solution for wearable fitness and tracking devices. It provides fitness low power (FLP) mode for Quectel GPS only modules and GNSS low power (GLP) mode for Quectel multi-GNSS modules to reduce power consumption with tiny accuracy trading-off. The low power mode can be easily set by using a specific message. In low power mode, the module has good route consistence in walking and running scenarios, and can switch dynamic duty operation automatically. It will come back to normal mode in difficult environment to keep good accuracy as well, thus realizing maximum performance with the lowest power consumption. CQouneficdteenl tial This document is applicable to Quectel GNSS modules. GNSS_Low_Power_Mode_Application_Note Confidential / Released 5 / 12 GNSS Module Series GNSS Low Power Mode Application Note 2 Power Consumption The average current in FLP/GLP mode is down to 5mA/7.3mA in static receiving, which is about 40% of normal mode. The power consumption may increase a little bit in dynamic scenario. The average current in different open sky scenarios in FLP/GLP mode and normal mode is shown in the table below. Table 1: Average Current in FLP Mode and Normal Mode (L70 Module) Scenario Static l Walking te Running c l Driving In FLP Mode (mA) 5.0 5.4 5.5 8.5 In Normal Mode (mA) 12 12 12 12 ue tia Table 2: Average Current in GLP Mode and Normal Mode (L76 Module) Q n Scenario e Static fid Walking n Running Co Driving In GLP Mode (mA) 7.3 9.2 9.4 17.6 In Normal Mode (mA) 18 18 18 18 GNSS_Low_Power_Mode_Application_Note Confidential / Released 6 / 12 GNSS Module Series GNSS Low Power Mode Application Note 3 Quectel NMEA Packet Protocol This chapter introduces the Quectel NMEA packet protocol which is a set of extension messages of the standard NMEA packet protocol. These messages are used to control the module to enable or disable FLP/GLP mode. The following table shows the structure of a Quectel NMEA packet. 3.1 Quectel NMEA Packet Format Preamble TalkerID PktType DataField * CHK1 CHK2 CR LF tel *The maximum length of each packet is restricted to 255 bytes. c l Packet Contents: ue tia  Preamble: One byte character: ‘$’  TalkerID: Two bytes character string: 'PQ' Q n  PktType: 1-10 bytes character string. An identifier used to tell the decoder how to decode the packet. e  DataField: The DataFileld has variable lengths depending on the packet type. A command symbol ‘,’ must be inserted ahead of each data field to help the decoder to process the DataField. fid  * : 1 byte character. The star symbol is used to mark the end of DataField.  CHK1,CHK2: Two bytes character string. CHK1 and CHK2 are the checksum of the data between n Preamble and ‘*’. Co  : Each NMEA message ends with ‘CR’ and ‘LF’. 3.2 Packet Type: PQBAUD Set NMEA Port Baudrate PQBAUD Set NMEA Port Baudrate Write Command $PQBAUD,W,*Checksu m Response $PQBAUD,W,OK*Checksum If error: GNSS_Low_Power_Mode_Application_Note Confidential / Released 7 / 12 Reference GNSS Module Series GNSS Low Power Mode Application Note $PQBAUD,W,ERROR*Checksum Parameter NMEA port baudrate Could be set to 4800, 9600,14400,19200, 38400, 57600, 115200 Example $PQBAUD,W,115200*43 //Set NMEA port baudrate as 115200 $PQBAUD,W,OK*40 //Set successfully NOTES l 1. The command will be effective immediately after setting. te 2. Parameter is automatically saved. uec tial 3.3 Packet Type: PQFLP Set the Module into FLP Mode Q n PQFLP Set the Module into FLP Mode e Write Command $PQFLP,W,,*Checksu fid m n Read Command o $PQFLP,R, *Checksum Response $PQFLP,W,OK*Checksum If error: $PQFLP,W,ERROR*Checksum Response $PQFLP,R,*Checksum C Reference Parameter Module operation mode 0 Normal mode 1 FLP mode Save operation 0 Parameter is not saved, ineffective after restart GNSS_Low_Power_Mode_Application_Note Confidential / Released 8 / 12 GNSS Module Series GNSS Low Power Mode Application Note 1 Parameter is saved in flash, effective after restart Example $PQFLP,W,1,1*20 $PQFLP,W,OK*08 $PQFLP,R*25 $PQFLP,R,1*38 //Switch to FLP mode //Set successfully //Query the working mode //The module is in FLP mode NOTE The command will be effective immediately after setting. l 3.4 Packet Type: PQGLP Set the Module into GLP Mode cte l PQGLP Set the Module into GLP Mode Write Command ue tia $PQGLP,W,,*ChkSum Q en Read Command $PQGLP,R*ChkSum fid Reference Response $PQGLP,W,OK*ChkSum If error: $PQGLP,W,ERROR*ChkSum Response $PQGLP,R,*ChkSum n Parameter Co Module operation mode 0 Normal mode 1 GLP mode Save operation 0 Parameter is not saved, ineffective after restart 1 Parameter is saved in flash, effective after restart Example $PQGLP,W,1,1*21 $PQGLP,W,OK*09 // Switch to GLP mode // Set successfully GNSS_Low_Power_Mode_Application_Note Confidential / Released 9 / 12 $PQGLP,R*24 $PQGLP,R,1*39 GNSS Module Series GNSS Low Power Mode Application Note // Query the working mode // The module is in GLP mode NOTE The command will be effective immediately after setting. CQouneficdteenl tial GNSS_Low_Power_Mode_Application_Note Confidential / Released 10 / 12 GNSS Module Series GNSS Low Power Mode Application Note 4 Enter into or Exit from Low Power Mode 4.1 Enter into/Exit from FLP Mode You can follow the steps below to enter into or exit from the FLP mode: l 1. Download the firmware that supports FLP mode to the module. te 2. Set NMEA port baudrate to 115200. Command $PQBAUD,W,115200*43 can be used to set the baud rate into 115200. When the module responds $PQBAUD,W,OK*40, the command is executed c l successfully. ue tia 3. Set the module into FLP mode. Command $PQFLP,W,1,1*20 is used to set the module into FLP mode. When the module responds $PQFLP,W,OK*08, the command is executed successfully. 4. Wait for at least 5 minutes to allow the module to completely enter into FLP mode. Q n 5. Make the module exit from FLP mode. Command $PQFLP,W,0,1*21 is used to make the module exit e from FLP mode. When $PQFLP,W,OK*08 is returned, it means the module has exited from FLP fid mode successfully. n 4.2 Enter into/Exit from GLP Mode Co You can follow the steps below to enter into or exit from the GLP mode: 1. Download the firmware that supports GLP mode to the module. 2. Set NMEA port baudrate to 115200. Command $PQBAUD,W,115200*43 can be used to set the baud rate into 115200. When the module responds $PQBAUD,W,OK*40, the command is executed successfully. 3. Set the module into GLP mode. Command $PQGLP,W,1,1*21 is used to set the module into GLP mode. When the module responds $PQGLP,W,OK*09, the command is executed successfully. 4. Wait for at least 5 minutes to allow the module to completely enter into GLP mode; GNSS_Low_Power_Mode_Application_Note Confidential / Released 11 / 12 GNSS Module Series GNSS Low Power Mode Application Note 5. Make the module exit from GLP mode. Command $PQGLP,W,0,0*21 is used to make the module exit from GLP mode. When $PQGLP,W,OK*09 is returned, it means the module has exited from GLP mode successfully. NOTES 1. It is recommended that some necessary commands are set before the module enters into low power mode. If you need to send commands, please exit from low power mode first. 2. When the module enters into low power mode, 1PPS function will not be supported. 3. When the GPS olny module enters into FLP mode, EASY function will be disabled. You can send command to enable EASY function after the module exits from the FLP mode. 4. When the low power mode is enabled, the SBAS will be affected. 5. High dynamic performance will have a little impact on low power mode. 6. The module supports 4800bps~115200bps baud rate and 1Hz-10Hz frequency. It is recommended that 115200bps baud rate and 1HZ frequency are set before the module enters into low power mode. 7. The modules will automatically come back to the normal mode in difficult environment to keep good CQouneficdteenl tial accuracy. GNSS_Low_Power_Mode_Application_Note Confidential / Released 12 / 12

WCDMA UGxx Jamming Detection Application Note UMTS/HSPA Module Series Rev. WCDMA_UGxx_Jamming_Detection_Application_Note_V1.0 Date: 2015-08-20 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 1 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note About the Document History Revision 1.0 Date CQouneficdteenl tial 2015-08-20 Author Jonathan WEN Description Initial WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 2 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 1 Introduction .......................................................................................................................................... 4 2 Jamming Detection Overview............................................................................................................. 5 2.1. Application Overview ................................................................................................................... 5 2.1.1. Report Jamming Status via URC ..................................................................................... 6 2.1.2. Report Jamming Status via URC Periodically.................................................................. 6 2.2. Configure Optimized Detection Parameters ................................................................................ 6 3 4 5 AT Commands Description................................................................................................................. 7 3.1. AT+QJDCFG Jamming Detection Configuration ...................................................................... 7 3.2. AT+QJDR Jamming Detection Report ...................................................................................... 8 3.3. URC Description .......................................................................................................................... 9 l 3.3.1. Disturbed Indicator ........................................................................................................... 9 te 3.3.2. Jammer Removal Indicator .............................................................................................. 9 Example .............................................................................................................................................. 10 c l 4.1. Report Jamming......................................................................................................................... 10 ue tia 4.2. Report Jamming via URC Periodically....................................................................................... 10 4.3. Enable and Disable Jamming Detection.................................................................................... 11 4.4. Configure Jamming Detection ................................................................................................... 11 CQonfiden Appendix A Reference.......................................................................................................................13 WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 3 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note 1 Introduction A Cellular Communication Jammer can totally paralyze all kinds of mobile and portable phones working in the GSM/WCDMA bands. Quectel standard modules offer jamming detection functionality which allows the unit to sense attempts to disrupt the GSM/WCDMA communication by interference with the signal. Quectel module‟s sophisticated jamming detection enables enhanced security features and immediate alarm notification if communication interference is detected. This document gives a detailed explanation on how to use the Jamming Detection function of Quectel standard modules. CQouneficdteenl tial This document is applicable to Quectel UGxx modules. WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 4 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note 2 Jamming Detection Overview Quectel‟s Jamming Detection allows the user to identify active jamming of the GSM/WCDMA network. Many alarm, security and life critical operations rely on the use of GSM/WCDMA mobile communications. Criminals and those that intent on preventing time critical messages may use GSM/WCDMA jammers to interfere with normal network operation. Quectel‟s Jamming Detection can allow Quectel module to detect jamming signals. When jamming is detected, Quectel module sends a notification to MCU, reporting the presence of active jamming of the GSM/WCDMA mobile communication network. Queficdteenl tial Figure 1: Jamming Application Diagram Con 2.1. Application Overview Quectel Jamming Detection supports to report the appearance and disappearance of jamming automatically via URC to notify the MCU. Also you can manually query the jamming status by the QJDR read command (see Chapter 3.2). The following sections describe how to use these functionalities. WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 5 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note 2.1.1. Report Jamming Status via URC After Jamming Detection function is enabled by AT+QJDR=1, the Jamming Detection function can work well with the default settings. If jamming is detected, the module will report '+QJDR: JAMMED' through all ports. If jamming is removed, the module will report '+QJDR: NO JAMMING' through all ports. If URC of this function is not reported, query whether the jamming status is available or not by 'AT+QJDR?'. For detailed details, please refer to Chapter 4.1. 2.1.2. Report Jamming Status via URC Periodically There are two ways to report URC for indicating jamming status. One is reporting URC only once as described in section 2.1.1; the other is reporting URCs periodically. Firstly, enable the Jamming Detection function of Quectel module by AT+QJDR=1, and then set the by AT+QJDCFG. If jamming is detected, the module will report a URC '+QJDR: JAMMED' through all ports every seconds. If jamming is removed, the module will report '+QJDR: NO JAMMING' through all ports. For more details, please refer to Chapter 4.2. tel 2.2. Configure Optimized Detection Parameters uec tial Quectel Jamming Detection supports to optimize the detection conditions by configuring and CQonfiden other parameters of AT+QJDCFG. To detect and report the jamming, some basic conditions are verified. WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 6 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note 3 AT Commands Description Quectel Jamming Detection can be configured by AT+QJDCFG command and activated by AT+QJDR command. If a Cellular Communication Jammer is active in its range, the module can detect and give indication to you via URC. 3.1. AT+QJDCFG Jamming Detection Configuration This command allows module to configure the options of Jamming Detection feature. These options l include the Jamming Detection conditions, the Jamming notification methods, etc. Parameters will be automatically saved into NVRAM after being configured successfully. te AT+QJDCFG Jamming Detection Configuration c l Test Command Que entia AT+QJDCFG=? Response +QJDCFG: 'period',(0-120) +QJDCFG: 'minch',(3-10) +QJDCFG: 'minecno',(0-49) +QJDCFG: 'minsqual',(230-260) +QJDCFG: 'maxsrxlev',(0-63) +QJDCFG: 'maxrxlev',(0-73) fid Read Command Con AT+QJDCFG? OK Response +QJDCFG: 'period', +QJDCFG: 'minch', +QJDCFG: 'minecno', +QJDCFG: 'minsqual', +QJDCFG: 'maxsrxlev', +QJDCFG: 'maxrxlev', Write Command AT+QJDCFG=, OK Response OK or ERROR WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 7 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note Parameters String type, define the name of settings type 'period' Period of URC of auto jamming detection report. When set to „0‟, no periodic reporting. Default value: 0. Range: 0-120, unit: s 'minch' The minimum channel number or ARFCN number which is jammed. Default value: 5. Range: 3-10 'minecno' The mine ECNO threshold (For WCDMA network only). Default value: 10. Range: 0-49 'minsqual' The minimum S_QUAL threshold (For WCDMA network only). Default value: 240. Range: 230-260 'maxsrxlev' The maximum S_RXLEV threshold (For WCDMA network only). Default value: 35. Range: 0-63 'maxrxlev' The maximum RXLEV threshold (FOR GSM network only). Default value: 30. Range: 0-73 Digital type, define the value of type tel 3.2. AT+QJDR Jamming Detection Report c l Jamming Detection can be activated by QJDR command. The parameter will revert to default ue tia value 0 after restart. AT+QJDR Jamming Detection Report Q n Test Command e AT+QJDR=? Response +QJDR: (0,1) fid Read Command Con AT+QJDR? OK Response If was set to '1' which means enable the jamming detection function, return: +QJDR: NO JAMMING or +QJDR: JAMMED OK If was set to '0' which means disable the jamming detection function, return: +QJDR: 0 OK WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 8 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note Write Command AT+QJDR= Response OK or ERROR Parameters Disable or enable the jamming detection function 0 Jamming Detection function is disabled (default is 0) 1 Jamming Detection function is enabled About URC description, please refer to Chapter 3.3 3.3. URC Description l 3.3.1. Disturbed Indicator te If the module detects a Jammer, it will send the URC '+QJDR: JAMMED' to the serial port. c l Indication of Jammer Presence ue tia +QJDR:JAMMED Q n 3.3.2. Jammer Removal Indicator e If the Jammer was removed then it will send the message '+QJDR: NO JAMMING' to the serial port. fid Indication of Jammer Removal Con +QJDR: NO JAMMING WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 9 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note 4 Example 4.1. Report Jamming AT+QJDR=1 //Enable Jamming Detection. OK In normal condition: AT+QJDR? l +QJDR: NO JAMMING OK //Query the current jamming status. //In normal condition, no jamming is detected. cte l In a jamming environment, please refer to Chapter 2.2. +QJDR: JAMMED //The URC will be reported automatically. Jamming has been detected. ue tia AT+QJDR? +QJDR: JAMMED Q n OK //Query the current jamming status. //In a jamming environment, jamming is detected. fide If jammer is removed: +QJDR: NO JAMMING n AT+QJDR? +QJDR: NO JAMMING Co OK //The URC is reported automatically. No jamming is detected. //Query the current jamming status. //No jamming is detected. 4.2. Report Jamming via URC Periodically AT+QJDR=1 OK AT+QJDCFG='period',5 OK //Enable Jamming Detection. //Set the as 5. URC will be reported every 5 seconds. WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 10 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note In a jamming environment, please refer to Chapter 2.2. +QJDR: JAMMED … +QJDR: JAMMED …. //The URC will be reported automatically every 5 seconds. Jamming has been detected. //The URC will be reported automatically every 5 seconds. Jamming has been detected. If jammer is removed: +QJDR: NO JAMMING //The URC is reported automatically. No jamming is detected. AT+QJDCFG='period',0 OK //Disable reporting URC periodically. l 4.3. Enable and Disable Jamming Detection te AT+QJDR=? c l +QJDR: (0,1) //Test mode. ue tia OK AT+QJDR? +QJDR: NO JAMMING //Query the current jamming status. //No jamming detected. Q en OK AT+QJDR=1 fid OK //Turn on jammer. n +QJDR: JAMMED o //Turn off jammer. C +QJDR: NO JAMMING //Enable Jamming Detection function. //The jammer has been detected and then jamming is reported. //Report that the jammer has been removed. AT+QJDR=0 //Disable Jamming Detection function. OK 4.4. Configure Jamming Detection AT+QJDCFG=? //Test command +QJDCFG: 'period',(0-120) +QJDCFG: 'minch',(3-10) WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 11 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note +QJDCFG: 'minecno',(0-49) +QJDCFG: 'minsqual',(230-260) +QJDCFG: 'maxsrxlev',(0-63) +QJDCFG: 'maxrxlev',(0-73) OK AT+QJDCFG? //Query the current parameter configuration. +QJDCFG: 'period',0 //The default value of the is 0. It represents that reporting jamming status via URC periodically is disabled. +QJDCFG: 'minch',5 +QJDCFG: 'minecno',10 +QJDCFG: 'minsqual',240 +QJDCFG: 'maxsrxlev',35 +QJDCFG: 'maxrxlev',30 OK l AT+QJDCFG='period',5 te OK AT+QJDCFG='minch',6 c l OK ue tia AT+QJDR=1 OK //Turn on jammer. Q n +QJDR: JAMMED e //Turn off jammer. fid +QJDR: NO JAMMING AT+QJDR=0 Con OK //Set is 5. It represents that jamming status is reported via URC through serial port every 5 seconds. //Set as 6. //Enable Jamming Detection function. //Jamming has been detected and reported. //Report that the jammer has been removed. //Disable Jamming Detection function. WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 12 / 13 UMTS/HSPA Module Series WCDMA UGxx Jamming Detection Application Note 5 Appendix A Reference Table 1: Terms and Abbreviations Abbreviation Description BSIC Base Station Identity Code RSSI URC MINCH ARFCN Received Signal Strength Indication Unsolicited Result Code l Minimum Channel Number CQouneficdteential Absolute Radio Frequency Channel Number WCDMA_UGxx_Jamming_Detection_Application_Note Confidential / Released 13 / 13

GSM POP3 AT Command Set GSM/GPRS Module Series Rev. POP3_ATC_V3.1 Date: 2015-04-08 www.quectel.com GSM/GPRS Module Series GSM POP3 AT Command Set Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx Or Email: Support@quectel.com tel GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO CHANGE WITHOUT PRIOR NOTICE. fide COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS n DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_POP3_AT_Command_Set Confidential / Released 1 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set About the Document History Revision 3.0 3.1 Date 2013-01-30 CQouneficdteenl tial 2015-04-08 Author Kim JIN Kim JIN Description Initial Added applicable modules GSM_POP3_AT_Command_Set Confidential / Released 2 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 1 Introduction .......................................................................................................................................... 4 2 Description ........................................................................................................................................... 5 2.1. AT Command syntax................................................................................................................... 5 2.2. Description of AT Command ....................................................................................................... 5 2.2.1. AT+QPOP3CFG POP3 Configurations ......................................................................... 5 2.2.2. AT+QPOP3IN Login the POP3 Server.......................................................................... 7 3 4 2.2.3. 2.2.4. 2.2.5. l 2.2.6. 2.2.7. te 2.2.8. 2.2.9. AT+QPOP3NUM Get the Email Number and Total size on POP3 Server.................... 7 AT+QPOP3LIST Get the Size of Every Email on Server .............................................. 8 AT+QPOP3GET Get the Specific Email Info on Server................................................ 9 AT+QPOP3MDEL Mark the Specific Email on Server to Delete ................................ 10 AT+QPOP3RSET Unmark All the Emails that Marked as Delete on Server .............. 11 AT+QPOP3OUT Logout from the POP3 Server ......................................................... 11 AT+QPOP3READ Read the Data of the Email Received........................................... 11 c l Appendix A Reference....................................................................................................................... 13 ue tia Examples ............................................................................................................................................ 15 4.1. Configure POP3 server ............................................................................................................. 15 4.2. Login POP3 server.................................................................................................................... 16 Q n 4.3. Get the Information of Email Number and Size on POP3 Server ............................................ 16 e 4.4. Get the Information of the Specific Email on POP3 Server...................................................... 17 4.5. Mark the Specific Email Deleted on POP3 Server and Reset All ............................................. 17 fid 4.6. Logout from POP3 Server......................................................................................................... 18 Con 4.7. Read the Local Email Info......................................................................................................... 18 GSM_POP3_AT_Command_Set Confidential / Released 3 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 1 Introduction Quectel Modules provide an internal TCP/UDP stack that is driven by AT commands and enables the host application to easily access the internet service. It includes TCP service, UDP service, HTTP service, FTP service, SMTP service and POP3 service, etc. This document is a reference guide to all the AT commands and responses defined for POP3 service. CQouneficdteenl tial This document is applicable to Quectel M35 and M50 modules. GSM_POP3_AT_Command_Set Confidential / Released 4 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 2 Description 2.1. AT Command syntax Test Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. Read Command Write Command l Execution te Command AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the GSM engine uec tial 2.2. Description of AT Command 2.2.1. AT+QPOP3CFG POP3 Configurations Q en AT+QPOP3CFG POP3 Configurations fid Test Command AT+QPOP3CFG=? Response +QPOP3CFG: , n Read Command Co AT+QPOP3CFG? OK Response +QPOP3CFG: , [+QPOP3CFG: , […]] Write Command AT+QPOP3CFG=[, ] OK Response If is not null, and format is right, response OK Else if is null, and format is right, response +QPOP3CFG: , GSM_POP3_AT_Command_Set Confidential / Released 5 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set Reference OK Otherwise response ERROR Parameter The property of POP3 'storage' The local storage where to save the Email downloaded from server. It has three values. RAM RAM file. This is the default storage UFS UFS file in flash SD SD file 'user' The user name for authentication. The maximum size is 50. 'pwd' The password for authentication. The maximum size is 50. 'server' Set the address and port of POP3 server. The address of server can l be IP address or domain name. The format is similar to te '192.168.1.1:110'. 'timeout' The maximum time waited for data from server. If there is no any c l data coming from server within timeout value, it will be timeout and return error code -9. The unit is second. The range is 1-300. The ue tia default value is 90. This timeout value is useful for AT+QPOP3IN/AT+QPOP3NUM/AT+QPOP3LIST/AT+QPOP3GET/ AT+QPOP3MDEL/AT+QPOP3RSET/AT+QPOP3OUT. Q n 'RAM/maxFileSize' Set the maximum allowable Email size in RAM. This e configuration is useful only when 'storage' is RAM. The unit is byte. The value cannot be larger than the free space of RAM. If it is 0, it fid means it will use the real mail size to create file in RAM. If it is larger than 0, it will use this value to create file in RAM. Normally, there is no need to configure this value, only when the mail size provided nfrom mail server is not reliable. CoThe value of the property indicated by . NOTES 1. If is null, AT+QPOP3CFG is used for getting the value of the , otherwise is used for setting its value. 2. 'storage' can be saved through AT&W. GSM_POP3_AT_Command_Set Confidential / Released 6 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 2.2.2. AT+QPOP3IN Login the POP3 Server AT+QPOP3IN Login the POP3 server Test Command AT+QPOP3IN=? Execution Command AT+QPOP3IN Response OK Response If format is right, response OK +QPOP3: Otherwise response Reference ERROR l Parameter cte l A numeric to indicate the result to login the server. If it is 0, it means it is successful to login the server. If it is a negative numeric, it is the same as (Please refer to the chapter 3). ue tia 2.2.3. AT+QPOP3NUM Get the Email Number and Total Size on POP3 Server Q n AT+QPOP3NUM Get the Email Number and Total Size on POP3 Server e Test Command fid AT+QPOP3NUM=? Execution Command n AT+QPOP3NUM Response OK Response If format is right, response +QPOP3NUM: , o OK C Otherwise response ERROR Reference Parameter The Email number on the POP3 server. Total size of all the Emails on POP3 server. GSM_POP3_AT_Command_Set Confidential / Released 7 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 2.2.4. AT+QPOP3LIST Get the Size of Every Email on Server AT+QPOP3LIST Get the Size of Every Email on Server Test Command AT+QPOP3LIST=? Write Command AT+QPOP3LIST= Response OK Response If format is right, response +QPOP3LIST: , OK Otherwise response Execution Command AT+QPOP3LIST Quectenl tial Reference ERROR Response If format is right, response CONNECT , [, […]] +QPOP3LIST: OK Otherwise response ERROR fide Parameter n Co The total number of Emails on POP3 server The total size of Emails on POP3 server The index of Email on server The size of Email A numeric to indicate the result to login the server. If it is 0, it means it is successful to list the Emails on server. If it is a negative numeric, it is the same as (Please refer to the chapter 3). GSM_POP3_AT_Command_Set Confidential / Released 8 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set NOTES 1. If is not null, it will get the specific Email’s size. And if is null, it will list all the Email’s size. 2. In executive mode (AT+QPOP3LIST), if and are both 0, there are two situations. Firstly, there is no mail indeed. Secondly, the server does not support this command to get these total messages. If is greater than 0, but is 0, it means that current POP3 server only supports this command to get , does not support to get . 2.2.5. AT+QPOP3GET Get the Specific Email Info on Server AT+QPOP3GET Get the Specific Email Info on Server Test Command AT+QPOP3GET=? Response +QPOP3GET: ,(0-2) tel Write Command AT+QPOP3GET= c l , OK Response If is 0 and format is right, response +QPOP3GET: ue tia OK Else if is 1 and format is right, response CONNECT Q n e +QPOP3GET: fid OK Else if is 2 and format is right, response n+QPOP3GET: o OK C Otherwise response ERROR Reference Parameter The index of Email on server Which part of data will be get 0 Get the UIDL of the specific Email GSM_POP3_AT_Command_Set Confidential / Released 9 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 1 Get the header of the specific Email 2 Download the specific Email to local folder The data of the part specified by . If is 2, will be null. A numeric to indicate the result to get the data. If it is 0, it means it is successful to get the data on server. If it is a negative numeric, it is the same as (Please refer to the chapter 3). NOTES 1. If is 0, Data will output directly through UART in CMD Mode, and the data was already decoded. 2. If is 1, Data will output directly through UART in Data Mode, and the data was already decoded. 3. And if the is 2, it is used for downloading all the data of specific Email to local folder. These l data will be saved to the storage refer to AT+QPOP3CFG='storage','…', and does not be output through UART. Mail data is stored in the root directory of the current storage, named 'pop3.eml'. If te download new Email to the storage, old mail data will be deleted. c l 2.2.6. AT+QPOP3MDEL Mark the Specific Email on Server to Delete ue tia AT+QPOP3MDEL Mark the Specific Email on Server to Delete Q n Test Command AT+QPOP3MDEL=? Response +QPOP3MDEL: fide Write Command AT+QPOP3MDEL= n Reference OK Response OK ERROR Co Parameter The index of Email on server NOTE The Email marked as Delete will be deleted on server after AT+QPOP3OUT have been executed. GSM_POP3_AT_Command_Set Confidential / Released 10 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 2.2.7. AT+QPOP3RSET Unmark All the Emails that Marked as Delete on Server AT+QPOP3RSET Unmark All the Emails that Marked as Delete on Server Test Command AT+QPOP3RSET=? Execution Command AT+QPOP3RSET Reference Response OK Response OK ERROR NOTE It will unmark all the Emails that have been marked as Delete. tel 2.2.8. AT+QPOP3OUT Logout from the POP3 Server c l AT+QPOP3OUT Logout from the POP3 Server ue tia TestCommand AT+QPOP3OUT=? Write Command Q n AT+QPOP3OUT e Reference Response OK Response OK ERROR fid 2.2.9. AT+QPOP3READ Read the Data of the Email Received n AT+QPOP3READ Read the Data of the Email Received o Test Command C AT+QPOP3READ=? Response +QPOP3READ: (0-2),(0-65535),'FILE_FULL_NAME' Write Command AT+QPOP3READ= [,,] OK Response If read the contents of header or body, and format is right, response CONNECT +QPOP3READ: GSM_POP3_AT_Command_Set Confidential / Released 11 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set OK Else if get the charset of body, and format is right response +QPOP3READ: OK Else response +QPOP3READ: OK Otherwise response ERROR Reference Parameter l cte l Que ntia fide Con Which part of contents want to get 0 Read the Email header 1 Read the body text 2 List attachment content If is 1, this parameter has two values. 0 Get the char set of the Email body 1 Read the body of this Email If is 2, this parameter means the ID of attachments. If is 2 and is null, it is used for getting the attachment numbers of the specific Email. The path to save the specific attachment This parameter is valid only when is 2. This is the data of the Email. And the data was already decoded. A numeric to indicate the result to read data. If it is 0, it means it is successful. If it is a negative numeric, it is the same as (Please refer to the chapter 3). The char set of the Email body NOTES 1. If data of the E-mail’s header or body has been got, data will output to UART in Data mode directly. 2. If AT+QPOP3READ is used for getting the specific attachment to , the data of the attachment will be decoded and saved to . The operation of FILE can be used for getting the data of the attachment. GSM_POP3_AT_Command_Set Confidential / Released 12 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 3 Appendix A Reference Table 1: Description of Different Coding Schemes Code of Meaning 0 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 Executed successfully Unknown error l Wait for the report of bearer info te The pop3 operation is busy uec tial Failed to get IP address according to domain name Network error Q n Unsupported command e The connection for the POP3 server is closed by peer fid CPRS/CSD context is deactivated Timeout nServer reply error CoParse data error -12 Get free space error -13 Free space is not enough -14 Open file failed -15 Read file error GSM_POP3_AT_Command_Set Confidential / Released 13 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set -16 Failed to save data -17 Error when decode data -18 Invalid parameter CQouneficdteenl tial GSM_POP3_AT_Command_Set Confidential / Released 14 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 4 Example 4.1. Configure POP3 server AT+QPOP3CFG=? +QPOP3CFG: , OK AT+QPOP3CFG='storage','UFS' OK l AT+QPOP3CFG='user','test_user@163.com' OK te AT+QPOP3CFG='pwd','password' c l OK AT+QPOP3CFG='timeout',60 ue tia OK AT+QPOP3CFG='server','pop.163.com:110' OK Q n AT+QPOP3CFG? +QPOP3CFG: 'storage','UFS' e +QPOP3CFG: 'user','test_user@163.com' +QPOP3CFG: 'pwd','********' fid +QPOP3CFG: 'server','pop.163.com:110' +QPOP3CFG: 'timeout',60 n OK o AT+QPOP3CFG='storage' C +QPOP3CFG: 'storage','UFS' //Set storage is UFS //Set user //Set password //Set timeout value //Set server name and port //Get storage value OK AT+QPOP3CFG='user' +QPOP3CFG: 'user','test_user@163.com' // Get user value OK AT+QPOP3CFG='pwd' +QPOP3CFG: 'pwd','********' // Get password value OK GSM_POP3_AT_Command_Set Confidential / Released 15 / 19 AT+QPOP3CFG='timeout' +QPOP3CFG: 'timeout',60 OK AT+QPOP3CFG='server' +QPOP3CFG: 'server','pop.163.com:110' OK GSM/GPRS Module Series GSM POP3 AT Command Set // Get timeout value // Get server address and port NOTE Actually, the user name 'test_user@163.com' and password 'password' are not valid. It is just an example. 4.2. Login POP3 server tel If configuration is right and network is ok. c l AT+QPOP3IN OK ue tia +QPOP3:0 Else if server address or port error, login will fail. Q n AT+QPOP3IN OK fide +QPOP3: -5 // Login in POP3 server //Login succeeded // Login in POP3 server //Login failed. Error Id is -5. n 4.3. Get the Information of Email Number and Size on POP3 Server o AT+QPOP3NUM C +QPOP3NUM: 2, 21353 //Inquire the number and total size of Email on Server OK AT+QPOP3LIST CONNECT 2, 21353 1, 4136 2, 17217 //Get the size of every Email on Server +QPOP3LIST: 0 GSM_POP3_AT_Command_Set Confidential / Released 16 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set OK AT+QPOP3LIST=1 +QPOP3LIST: 1, 4136 OK //Get the size of first Email on Server 4.4. Get the Information of the Specific Email on POP3 Server AT+QPOP3GET=1,0 //Get the UIDL of first Email +QPOP3GET: AAAFepdCAAAv60+tksDqrqk3/6ogog+g OK AT+QPOP3GET=1,1 CONNECT l From: 'bluesky' To: 'bhw98' bhw98@sina.com te Cc: bhwang@jlonline.com Subject: Test Email c l Date: Sat, 20 May 2002 10:03:36 +0800 ue tia +QPOP3GET:0 Q n OK AT+QPOP3GET=1,2 e +QPOP3GET: 0 fid OK //Get the head of first Email //Download the first Email to local folder //Get Email data successes n 4.5. Mark the Specific Email Deleted on POP3 Server and Reset All o AT+QPOP3MDEL=1 C OK //Mark the first Email on server for delete AT+QPOP3RSET //Reset all the Emails that marked for delete OK NOTE The Email which be marked for Delete will be delete when logout from the POP3 server. And AT+QPOP3RSET will reset all the Emails that have been marked for delete. GSM_POP3_AT_Command_Set Confidential / Released 17 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set 4.6. Logout from POP3 Server AT+QPOP3OUT OK //Logout from the POP3 server 4.7. Read the Local Email Info AT+QPOP3READ=? +QPOP3READ: (0-2),(0-65535),'FILE_FULL_NAME' OK AT+QPOP3READ=0 CONNECT From: 'bluesky' To: 'bhw98' bhw98@sina.com l Cc: bhwang@jlonline.com Subject: Test Email te Date: Sat, 20 May 2002 10:03:36 +0800 c l +QPOP3READ: 0 ue tia OK AT+QPOP3READ=1,0 Q n +QPOP3READ: UTF-8 e OK AT+QPOP3READ=1,1 fid CONNECT This is the body of test Email. n +QPOP3READ: 0 o OK C AT+QPOP3READ=2 //Read the header of this Email //Get the charset of the body //Read the body of this Email //List the attachments of this Email CONNECT 1,file.txt 2,blue.jpg +QPOP3READ: 0 OK AT+QPOP3READ=2,1,'RAM:file.txt' +QPOP3READ: 0 //Get the first attachment of this Email to 'RAM:file.txt' GSM_POP3_AT_Command_Set Confidential / Released 18 / 19 GSM/GPRS Module Series GSM POP3 AT Command Set OK AT+QFOPEN='RAM:file.txt' +QFOPEN: 12341840 //Open the attachment OK AT+QFREAD=12341840 //Read the attachment CONNECT 10 //The data of 10 bytes will be read out OK AT+QFCLOSE=12341840 //Close the attachment OK AT+QFDEL='RAM:file.txt' CQouneficdteenl tial OK //Delete the attachment GSM_POP3_AT_Command_Set Confidential / Released 19 / 19

GSM PPP Application Note GSM/GPRS Module Series Rev. GSM_PPP_Application_Note_V1.1 Date: 2015-04-08 www.quectel.com GSM/GPRS Module Series GSM PPP Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_PPP_Application_Note Confidential / Released 1 / 29 GSM/GPRS Module Series GSM PPP Application Note About the Document History Revision 1.0 1.1 Date 2013-04-28 CQouneficdteenl tial 2015-04-08 Author Wythe WANG Jelly WANG Wythe WANG Description Initial Added applicable modules. GSM_PPP_Application_Note Confidential / Released 2 / 29 GSM/GPRS Module Series GSM PPP Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 2 1 Introduction .......................................................................................................................................... 3 2 Application Mode ................................................................................................................................. 4 3 Procedure for PPP Setup .................................................................................................................... 5 3.1. General Procedure for PPP Setup.............................................................................................. 5 3.2. Recommended Procedure for PPP Setup .................................................................................. 6 4 5 6 7 UART for PPP Connection .................................................................................................................. 8 4.1. Data Mode and Command Mode................................................................................................ 8 4.1.1. Switch from Data Mode to Command Mode.................................................................... 8 l 4.1.2. Switch from Command Mode to Data Mode.................................................................... 9 4.2. Terminate the Connection ........................................................................................................... 9 te 4.3. Handle URC in Data Mode ....................................................................................................... 10 4.4. Data Carrier Detect (DCD) Function Mode............................................................................... 10 c l Special Handling in PPP.................................................................................................................... 11 ue tia 5.1. Optimize Speed and Success Ratio for PPP Setup ................................................................. 11 5.2. Set Preferred Authentication Type for PPP Setup .................................................................... 11 5.3. Configure ACCM of PPP ........................................................................................................... 11 Q n PPP AT Commands ........................................................................................................................... 12 e 6.1. AT Command Syntax ................................................................................................................ 12 6.2. Related Commands .................................................................................................................. 12 fid 6.2.1. AT+QPPPTIMER Optimize PPP Setup Speed and Success Ratio ............................ 12 6.2.2. AT+QACCM Set the Async-Control-Character of PPP ............................................... 14 6.2.3. AT+QGPAU Define PPP Auth Type............................................................................. 15 n Example of PPP(dial-up) in Windows .............................................................................................. 17 o 7.1. Preparation................................................................................................................................ 17 C 7.2. Modem Configuration................................................................................................................ 17 7.2.1. Add a New Modem......................................................................................................... 17 7.2.2. Configure the Modem Driver .......................................................................................... 21 7.3. Dial-up Network Configuration .................................................................................................. 23 7.3.1. Create a New Connection .............................................................................................. 23 7.3.2. Configure the Connection .............................................................................................. 24 7.3.3. Configure the Dial-up Tool.............................................................................................. 25 7.3.4. Establish the Dial-up Connection................................................................................... 26 8 Appendix A Reference....................................................................................................................... 28 GSM_PPP_Application_Note Confidential / Released 3 / 29 GSM/GPRS Module Series GSM PPP Application Note Table Index TABLE 1: RELATED DOCUMENTS .................................................................................................................. 28 TABLE 2: TERMS AND ABBREVIATIONS ........................................................................................................ 28 CQouneficdteenl tial GSM_PPP_Application_Note Confidential / Released 2 / 29 GSM/GPRS Module Series GSM PPP Application Note 1 Introduction This document gives a brief introduction to PPP function of Quectel standard module, including recommended procedures for PPP set-up, UART mode for PPP connection, special handling and AT commands for PPP. This document is applicable to all Quectel GSM modules. CQouneficdteenl tial GSM_PPP_Application_Note Confidential / Released 3 / 29 GSM/GPRS Module Series GSM PPP Application Note 2 Application Mode Application IP RELAY IP PPP uectel tial UART TXD RXD CTS RTS DTR DCD RING Q n Application PPP TXD RXD CTS RTS DTR DCD RING UART GPRS Bearer Module e Figure 1: PPP Application Mode fid The usage of PPP (Point to Point Protocol) can be described as Figure 1. Module provides a PPP server to application, and application side provides PPP client to module. Besides PPP, application side also has n to provide the following protocols: TCP/IP, HTTP, etc. When PPP connection has been set up, the IP o packet flow from application side will be transmitted to internet by module. C Most standard operating systems (e.g. Windows, Unix/Linux) include the PPP protocol stack. For other operating systems which do not include existing application to set up PPP connection, it is very important to develop a useful application software to accomplish PPP connection first. GSM_PPP_Application_Note Confidential / Released 4 / 29 GSM/GPRS Module Series GSM PPP Application Note 3 Procedure for PPP Setup This chapter gives the recommended procedure of PPP setup for Quectel standard module. If you want to develop PPP application software, please read this chapter before programming. 3.1. General Procedure for PPP Setup l TE MT cte l at+cgreg? ue tia +CGREG:0,1 at+cgdcont=1,'IP','cmnet' Q n OK e atd*99# fid CONNECT Con7E FF 7D 23 C0 21 7D 21 7D …… Figure 2: General Procedure of PPP After module has registered to the GPRS network, the following step is to set APN for PPP by AT+CGDCONT and start PPP setup by command of ATD*99#. When ATD*99# is executed, module enters the procedure of PPP packet interaction. The way of PPP packet interaction which Quectel module uses is on the basis of standard Point to Point Protocol. Description about module’s packet interaction is included in Figure 3. Please get more details about standard Point to Point Protocol from RFC 1661. GSM_PPP_Application_Note Confidential / Released 5 / 29 GSM/GPRS Module Series GSM PPP Application Note 3.2. Recommended Procedure for PPP Setup Recommended Power ON/OFF: 1. Power OFF: Pull Power Key from high to low, then cut off power after 12s. 2. Power ON: Pull Power Key to low within 1s. 3. Pull Power Key back to high when finishing Power OFF or Power ON. Power On the Module 1.Synchronization between TE and TA 2. Fix and save baudrate by AT+IPR=xxx&W N Query SIM Card Status: AT+CPIN/AT+QINISTAT. Reboot module if module failed to detect SIM Card in 10s with AT+CPIN?. Exit the PPP dialing if SIM Card is not ready in 10s AT+CPIN？ Y Query SIM Card Status Connect_Count <5 SIM card ready Exit the PPP dialing if GSM Network： 1. It indicates that module has registered to GSM network when AT+CREG? returns 1 or 5. 2. Reboot the module if it failed to register to GSM network in 30s. module failed to register to GSM network in 30s AT+CREG？ Query GSM network Register to GSM network in 30s GPRS Network： 1. It indicates that module has registered to GPRS network when AT+CGREG? returns 1 or 5. 2. It is able to go to next step l without registering to GPRS network in 30s. te APN configuration： 1. APN must be set by AT+CGDCONT 2. Use AT+CGACT? to check c l whether or not current context has been activated when AT+CGDCONT returns error. AT+CGREG? Query GPRS network 1. Set APN by AT+CGDCONT 2. Start PPP Dialing by ATD*99# Connect_Count++ ue tia PacketInteraction 1. Able to use '+++' to exit the procedure of packet interaction. 2. Module will report NO CARRIER when PPP connection is terminated. Q n LCP Negotiation 1. Ensure the baudrate between MCU and module is same. e 2. If MCU does not want to transfer the character of 0x11 and 0x13, try to use AT+QACCM=0,0. fid AUTH Negotiation 1. Ensure the type of AUTH is one of PAP(0xc023) and CHAP(0xc223). IPCP Negotiation 1. Check whether or not MCU gets n legal IP and DNS address. 2. Check whether no not the amount of DNS MCU got equals to the amount MCU requested. o 3. Terminate PPP connection if IPCP negotiation between TA and TE is not completed in 90s, and C then retry PPP setup. Packet Interaction Start timer when IPCP negotiation begins Return CONNECT LCP Negotiation OK AUTH Negotiation OK IPCP Negotiation Exception Handling N SendCount<5 Y N OK Succeed to negotiate with MCU sends PPP N Terminate- MCU receives Y PPP Terminate- IPCP in 90s Request Ack packet in 3s packet Y SendCount++ N MCU got IP and DNS Exception Handling 1. Check whether or not the PPP Terminate-Request packet is right. 2. Try to use '+++'and ATH to hang up the PPP connection. 3. Reboot module if the steps above do not work. Y Data Transmission Figure 3: Flowchart for PPP Setup When module starts, baud rate of module's UART must be fixed by AT+IPR=115200&W. Before using ATD*99# to start PPP setup, application must check the status of SIM card with AT+CPIN?. When SIM GSM_PPP_Application_Note Confidential / Released 6 / 29 GSM/GPRS Module Series GSM PPP Application Note card is OK, application also needs to check the state of network periodically with AT+CREG? and AT+CGREG? until network condition is ready. NOTES 1. Ensure that MCU and the module are synchronized successfully after rebooting the module. MCU sends 'AT' to module every 100ms until Receive 'OK' from the module. And then MCU fixes and saves baud rate by 'AT+IPR=xxx&W' after synchronization is successfully. 2. Please note that MCU has to wait for the response (for example OK, CME error, CMS error) of the previous AT command before inputting the next AT command. The module can be rebooted if there is no response in 60s. 3. The module cannot be rebooted frequently. You can reboot the module immediately at first, and then reboot the module after 10 minutes, 30 minutes, 1 hour, etc if the module is repeatedly abnormal. 4. If MCU fails to transmit data to network after PPP connection has been set up, please check the CQouneficdteenl tial configuration of PPP and the state of network, and then reboot the module. GSM_PPP_Application_Note Confidential / Released 7 / 29 GSM/GPRS Module Series GSM PPP Application Note 4 UART for PPP Connection 4.1. Data Mode and Command Mode Module communicates information with Application by UART, including AT commands and data. There are two modes for module’s UART. One is data mode and the other is command mode. Module’s UART is in command mode before PPP setup, and module can execute AT commands in this state. When PPP negotiating starts, module’s UART enters data mode. Module will keep in data mode when PPP connection was set up and module can not execute AT commands in data mode. Quectel standard l modules provide convenient methods to switch the UART’s mode. cte l 4.1.1. Switch from Data Mode to Command Mode ue tia 4.1.1.1. Use DTR Level Switch from Data Mode to Command Mode Q n When PPP connection already exists and module is in data mode, setting command of AT&D1 and e switching DTR level from low to high can change module from data mode to command mode. If module’s mode is changed successfully in this way, module will return 'OK'. fid 4.1.1.2. Use Sequence +++ to Switch from Data Mode to Command Mode on Another way to switch module from data mode to command mode is using sequence +++ when PPP C connection has been set up successfully. To prevent the +++ escape sequence from UART being misinterpreted as data, it should be preceded and followed by a pause of at least 500ms. The interval time between each '+' must be less than 1000ms. When such particular sequence +++ is received, module will switch from data mode to command mode and return 'OK' for this kind of operation. NOTE Please make sure above operation is operated after completion of PPP negotiation. If not, above operation will terminate the PPP negotiation and quit from data mode. When UART is changed to command mode after accomplishing PPP negotiation, UART data will be treated as AT command and GSM_PPP_Application_Note Confidential / Released 8 / 29 module still remains PPP connection. GSM/GPRS Module Series GSM PPP Application Note 4.1.2. Switch from Command Mode to Data Mode 4.1.2.1. Use ATO to Switch from Command Mode to Data Mode Example // When PPP connection exists, and module is in command mode ATO CONNECT // Indicates that TA has entered the data mode; inputting commands from UART will be treated as PPP data. tel 4.2. Terminate the Connection c l It is recommended to terminate the connection with LCP Terminate-Request message in PPP protocol. ue tia This method must be operated in data mode. ATH is the method of shutting down connection with AT command, which closes the data connection, Q n deactivates the PDP context. But it is only supported in command mode. e Example fid // When PPP connection exists, and module is in command mode ATH OK // Indicate that the PPP connection has been terminated Con NOTE ATH disconnects existing connections, such as voice call and PPP connection. TA also can terminate the connection with switching of the DTR level. At first, set DTR function with AT&D2. This method can be operated in both data mode and command mode. Example // Before PPP connection has been set, module is still in command mode AT&D2 GSM_PPP_Application_Note Confidential / Released 9 / 29 GSM/GPRS Module Series GSM PPP Application Note OK And then set the disconnection delay time with ATS10. Example // Before PPP connection has been set, module is still in command mode ATS10=5 OK When PPP connection exists already, switch the DTR level from low to high, and keep High level for five seconds which is set by ATS10 as the above example. The data connection will terminate automatically. Module enters command mode after PPP connection is terminated completely. l 4.3. Handle URC in Data Mode te Coming call and short message will not be reported to UART during PPP connection. But the level of module’s RI pin will change from high to low for 120ms as short message indication. And for coming call, c l the level of RI pin will be pulled down and keep low until call ends. MCU can process the call or short ue tia message by switching to command mode according to the status of RI pin. If coming call or message exists, the URC will be output to UART when module is changed to command mode. Q en 4.4. Data Carrier Detect (DCD) Function Mode fid DCD function mode is determined by AT&C. If AT&C0 was set, the status of DCD pin will not be used to indicate the data carrier status. And if AT&C1 was set, the DCD pin will be used to indicate the data n carrier status. The pin will hold on high level when data carrier exists or PPP negotiation begins, otherwise it will keep low level. Co NOTE When switching PPP from data mode to command mode (using +++), the DCD state does not change. GSM_PPP_Application_Note Confidential / Released 10 / 29 GSM/GPRS Module Series GSM PPP Application Note 5 Special Handling in PPP 5.1. Optimize Speed and Success Ratio for PPP Setup On most condition of network, the speed and success ratio of PPP setup is fast and steady. But sometimes, when the situation of network is not so good or even extremely bad, it is able to use AT+QPPPTIMER to optimize the configuration of module to enhance the speed and success ratio for PPP setup. Please get detailed description of AT+QPPPTIMER from next chapter. tel 5.2. Set Preferred Authentication Type for PPP Setup c l Quectel module supports PAP and CHAP in PPP authentication negotiation. The default preferred ue tia authentication protocol which will be negotiated with TE in Quectel module is PAP. Quectel module can be set with AT+QGPAU to switch preferred authentication protocol from PAP to CHAP. Please get detailed description of AT+QGPAU from next chapter. Q fiden 5.3. Configure ACCM of PPP Quectel Module takes 0x11 and 0x13 as asynchronous control characters by default. When 0x11 and n 0x13 are included in the PPP packet data which will be transferred from TE to module, 0x11 should be transformed as 0x7d31 and 0x13 should be transformed as 0x7d33. On the contrary, when module o received 0x7d31 or 0x7d33, module will transform 0x7d31 to 0x11 and transform 0x7d33 to 0x13. In this C case, TE can use AT+QACCM to disable the transformation relationship. Please get detailed description of AT+ QACCM from next chapter. GSM_PPP_Application_Note Confidential / Released 11 / 29 GSM/GPRS Module Series GSM PPP Application Note 6 PPP AT Commands 6.1. AT Command Syntax Test Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. Read Command Write Command l Execution Command AT+? AT+= AT+ This command returns the currently set value of the parameter or parameters. This command sets the user-definable parameter values. This command reads non-variable parameters affected by internal processes in the GSM engine uecte tial 6.2. RelatedCommands 6.2.1. AT+QPPPTIMER Optimize PPP Setup Speed and Success Ratio Q en This command is used to optimize configuration of PPP in module to enhance the speed and success ratio for PPP setup, especially when the situation of network is extremely bad. fid AT+QPPPTIMER n Test Command Co AT+QPPPTIMER=? Optimize PPP Setup Speed and Success Ratio Response +QPPPTIMER: (list of supported s),(list of supported s),, OK Write Command Response AT+QPPPTIMER=,[,<p If =1 and command is successful eriod>,] OK If =0 and command is successful +QPPPTIMER: ,, OK GSM_PPP_Application_Note Confidential / Released 12 / 29 Reference GSM/GPRS Module Series GSM PPP Application Note Parameter The operation mode: 0 Read 1 Write The dial-up retry timer or hang-up retry timer 0 Dial-up retry timer 1 Hang-up retry timer The period for the ,if the mode is 0, this parameter is not needed. The unit is second. The for the timer. If the mode is 0, this parameter is not needed. l NOTES 1. The default of dial-up retry timer is 30s and the is 5. te 2. The default of hang-up retry timer is 8s and the is 5. c l 3. This command cannot be saved, and it needs to be set before ATD*99#. ue tia Example // Configure PPP optimization parameters, as below: Q n AT+QPPPTIMER=1,0,8,5 // Set the period of dial-up retry to 8s, and the retry time is 5 OK e AT+QPPPTIMER=1,1,6,5 // Set the period of hang-up retry to 6s, and the retry time is 5 fid OK ATD*99# n CONNECT …… Co // Enter PPP (dial-up) negotiation // Start PPP dial-up Example // Recover default setting AT+QPPPTIMER=1,0,30,5 OK AT+QPPPTIMER=1,1,8,5 OK // Set the period of dial-up retry to 30s, and the retry time is 5 // Set the period of hang-up retry to 8s, and the retry time is 5 // Read Command AT+QPPPTIMER=0,0 GSM_PPP_Application_Note Confidential / Released 13 / 29 +QPPPTIMER: 0,30,5 OK AT+QPPPTIMER=0,1 +QPPPTIMER: 1,8,5 OK GSM/GPRS Module Series GSM PPP Application Note // The default period of dial-up retry is 30s, the retry time is 5 // The default period of hang-up is 8s, the retry time is 5 6.2.2. AT+QACCM Set the Async-Control-Character of PPP This command is used to enable or disable 0x11 and 0x13 as asynchronous control characters during PPP procedure. AT+QACCM Set the Async-Control-Character of PPP l Test Command te AT+QACCM=? Response +QACCM: (list of supported s),(list of supported s) uec tial ReadCommand AT+QACCM? OK Response +QACCM: , Q n Write Command e AT+QACCM=, fid Reference OK Response OK n Parameter o 0 C655360 No asynchronous control characters when module sends PPP packet data. Enable 0x11 and 0x13 as asynchronous control characters when module sends PPP packet data. 0 No asynchronous control characters when module receives PPP packet data. 655360 Enable 0x11 and 0x13 as asynchronous control characters when module receives PPP packet data. GSM_PPP_Application_Note Confidential / Released 14 / 29 GSM/GPRS Module Series GSM PPP Application Note NOTES 1. The default value of and are both 655360. 2. The result of this command cannot be saved. Example // The default value of and in module are both 0xa0000. In this way, module enables 0x11 and 0x13 as asynchronous control characters by default. AT+QACCM? +QACCM: 0xa0000,0xa0000 // Read current configuration of ACCM OK // When user does not want to use asynchronous control characters, user must set AT+QACCM=0,0 to l disable the asynchronous control characters on module side before ATD*99#. AT+QACCM=0,0 // Disable 0x11 and 0x13 as asynchronous control characters te OK uec tial 6.2.3. AT+QGPAU Define PPP Auth Type This command is used to set the preferred authentication protocol which will be used to negotiate with Q n TE from module side. The default preferred protocol in module is PAP. But for PPP function, module e supports both PAP and CHAP. fid AT+QGPAU Define PPP Auth Type Test Command n AT+QGPAU=? Response +QGPAU: (list of supported s),(list of supported s),(list of supported s) Co OK Read Command Response AT+QGPAU=0, +QGPAU: Execution Command AT+QGPAU=1,, Reference OK Response OK GSM_PPP_Application_Note Confidential / Released 15 / 29 GSM/GPRS Module Series GSM PPP Application Note Parameter 0 Read mode 1 Write mode PDP Context Identifier. It is defined by AT+CGDCONT Negotiation protocol 0 PAP 1 CHAP NOTES 1. The default value of is 0, which means that the default prior negotiation type in module is PAP. 2. This command only defines the priority of negotiation type in module. The final auth type of PPP is negotiated between MCU and the module. l Example te // Read Command, the default value is PAP. (0 equals PAP and 1 equals CHAP) c l AT+QGPAU=0,1 // Read priority of negotiation type on PDP context 1 +QGPAU: 0 ue tia OK // Set Command Q n AT+QGPAU=1,1,1 Confide OK // Set CHAP as the preferred protocol to be used to negotiate with TE on PDP context 1 in module GSM_PPP_Application_Note Confidential / Released 16 / 29 GSM/GPRS Module Series GSM PPP Application Note 7 Example of PPP(dial-up) in Windows 7.1. Preparation It is necessary to finish the following steps before establishing a PPP connection.  Connect the module to PC and enter the PIN code if the SIM card PIN is locked.  Make sure the SIM card can successfully register to the GPRS network. tel 7.2. Modem Configuration c l 7.2.1. Add a New Modem ue tia If there is no 'Standard 19200 bps Modem' has been installed, it needs to add a new standard modem to Q n the modem section of the control panel. e 1. Click button 'Start' -> 'Settings'-> 'Control Panel' -> 'Phone and Modem Options'. Please refer Confid to Figure 4. GSM_PPP_Application_Note Confidential / Released 17 / 29 GSM/GPRS Module Series GSM PPP Application Note tel Figure 4: Open the Control Panel uec tial 2. Double click 'Phone and Modem Options', and select 'Modems'-> 'Add…' to add a new modem. CQonfiden Refer to Figure 5. GSM_PPP_Application_Note Confidential / Released 18 / 29 GSM/GPRS Module Series GSM PPP Application Note CQouneficdteenl tial Figure 5: Add a New Modem 3. Install the new modem, refer to the instructions on the screen, select 'Standard 19200 bps Modem' and a port (COM3) which will be installed, click 'Next' button, till the configuration is finished. Refer to Figure 6, Figure 7 & Figure 8. GSM_PPP_Application_Note Confidential / Released 19 / 29 GSM/GPRS Module Series GSM PPP Application Note CQouneficdteenl tial Figure6:SelectModeloftheModem Figure 7: Select a Port GSM_PPP_Application_Note Confidential / Released 20 / 29 GSM/GPRS Module Series GSM PPP Application Note l Figure 8: Successful Installation te 7.2.2. Configure the Modem Driver uec tial Select the 'Standard 19200 bps Modem' which have been installed, click 'Properties' button, choose 'Maximum Port Speed' as 115200 (default value), then click 'Advanced' to configure 'Extra Settings', CQonfiden input AT command 'AT+CGDCONT=1,'IP','CMNET'' as illustrated in the Figure 9 below. GSM_PPP_Application_Note Confidential / Released 21 / 29 GSM/GPRS Module Series GSM PPP Application Note CQouneficdteenl tial Figure 9: Configure the Modem Driver NOTE In the example above, the settings predefine a PDP context where CID =1, PDP type = IP and APN = CMNET. CMNET is the APN for the network provider China Mobile and it should be replaced with the APN by the network provider. GSM_PPP_Application_Note Confidential / Released 22 / 29 GSM/GPRS Module Series GSM PPP Application Note 7.3. Dial-up Network Configuration 7.3.1. Create a New Connection 1. Open 'Control Panel' and double click 'Network Connections', then click 'Create a new connection' from the right list of network tasks. Refer to Figure 10. CQouneficdteenl tial Figure 10: Create a New Connection 2. Click 'Next' button, choose 'Connect to the network at my workplace'->'Next', then select 'Dial-up connection'. Refer to Figure 11. GSM_PPP_Application_Note Confidential / Released 23 / 29 GSM/GPRS Module Series GSM PPP Application Note Quecteenl tial Figure 11: Set up the New Connection fid 7.3.2. Configure the Connection n Input 'Company Name' as the connection name, for example 'Test', then click 'Next' button, enter Co '*99#' as Phone number. Refer to Figure 12. GSM_PPP_Application_Note Confidential / Released 24 / 29 GSM/GPRS Module Series GSM PPP Application Note Quecteenl tial Figure 12: Configure the Setting fid 7.3.3. Configure the Dial-up Tool n Click 'Properties' button from the popup box and 'Configure…' button to configure the 'Standard o 19200 bps Modem', select 115200 from the maximum speed of the drop-down list. Click 'OK' button to C finish the configuration. Refer to Figure 13. GSM_PPP_Application_Note Confidential / Released 25 / 29 GSM/GPRS Module Series GSM PPP Application Note CQouneficdteenl tial Figure 13: Configure the Dial-up 7.3.4. Establish the Dial-up Connection Right click 'Test' which was created the new connection and click 'Connect'-> 'Dial' from network connections. It is successful to establish the dial-up connection when a prompt box 'test is now connected' popped up. Refer to Figure 14. GSM_PPP_Application_Note Confidential / Released 26 / 29 GSM/GPRS Module Series GSM PPP Application Note CQouneficdteenl tial Figure 14: Establish the Dial-up Connection GSM_PPP_Application_Note Confidential / Released 27 / 29 GSM/GPRS Module Series GSM PPP Application Note 8 Appendix A Reference Table 1: Related Documents SN Document name Remark [1] Mxx_AT_Commands_Manual .pdf AT Commands Manual for Mxx Table 2: Terms and Abbreviations l Abbreviation cte l PPP Que ntia UART fide APN CHAP n DNS Description Point-to-Point Protocol, The Point-to-Point Protocol is designed for simple links which transport packets between two peers. These links provide full-duplex simultaneous bi-directional operation, and are assumed to deliver packets in order. It is intended that PPP provides a common solution for easy connection of a wide variety of hosts, bridges and routers. Universal Asynchronous Receiver Transmitter. Integrated circuit which works with serial ports converting incoming serial data from a serial port into parallel form and parallel data to serial form when sending out data through a serial port (Computers, Electronics). Access Point Name Challenge Handshake Authentication Protocol Domain Name Server Co DTR Data Terminal Ready RI Ring Indicator DCD Data Carrier Detection GPRS GSM IP General Packet Radio Service Global System of Mobile Communication Internet Protocol GSM_PPP_Application_Note Confidential / Released 28 / 29 GSM/GPRS Module Series GSM PPP Application Note IPCP IP Control Protocol LCP Link Control Protocol MCU Micro Control Unit MS Mobile Station PAP Password Authentication Protocol PDP Packet Data Protocol PIN Personal Identification Number SIM TA TE Subscriber Identity Module Terminal Adapter CQouneficdteenl tial TerminalEquipment GSM_PPP_Application_Note Confidential / Released 29 / 29

Quectel Cellular Engine GSM SMTP AT Commands GSM_SMTP_ATC_V1.2 GSM_SMTP_ATC_V1.2 Document Title GSM SMTP AT Commands Version 1.2 Date 2015-04-08 Status Release Document Control ID GSM_SMTP_ATC_V1.2 General Notes Quectel offers this information as a service to its customers, to support application and engineering efforts that use the products designed by Quectel. The information provided is based upon requirements specifically provided to Quectel by the customers. Quectel has not undertaken any independent search for additional relevant information, including any l information that may be in the customer’s possession. Furthermore, system validation of this te product designed by Quectel within a larger electronic system remains the responsibility of the customer or the customer’s system integrator. All specifications supplied herein are c l subject to change. ue tia Copyright This document contains proprietary technical information which is the property of Quectel Limited. The copying of this document, distribution to others, and communication of the Q n contents thereof, are forbidden without express authority. Offenders are liable to the payment e of damages. All rights are reserved in the event of a patent grant or registration of a utility model or design. All specification supplied herein are subject to change without notice at any fid time. Con Copyright © Quectel Wireless Solutions Co., Ltd. 2015 GSM_SMTP_ATC_V1.2 - 1 - GSM_SMTP_ATC_V1.2 Contents 0. Revision history ............................................................................................................................3 1. Introduction...................................................................................................................................4 1.1. Reference.............................................................................................................................4 1.2. Terms and abbreviations......................................................................................................4 2. AT Commands for SMTP Service ................................................................................................5 2.1. Overview of AT commands for SMTP service...................................................................5 2.2. Detailed description of AT commands for SMTP service ..................................................5 2.2.1. AT+QSMTPUSER Set the user name for authentication ...................................5 2.2.2. AT+QSMTPPWD Set the password for authentication......................................6 2.2.3. AT+QSMTPADDR Set the email address of the sender.....................................6 2.2.4. AT+QSMTPNAME Set the sender’s name ........................................................7 2.2.5. AT+QSMTPSRV Set the address and port of SMTP server ...............................8 2.2.6. AT+QSMTPDST Add or delete recipients .........................................................8 l 2.2.7. AT+QSMTPSUB Edit the subject of the email ..................................................9 2.2.8. AT+QSMTPBODY Edit the content of the email.............................................10 te 2.2.9. AT+QSMTPATT Add an attachment for the email...........................................11 c l 2.2.10. AT+QSMTPDATT Delete an attachment .........................................................12 2.2.11. AT+QSMTPCLR Clear all the configurations and contents of the email.........13 ue tia 2.2.12. AT+QSMTPCFG SMTP configurations...........................................................14 2.2.13. AT+QSMTPPUT Send email...........................................................................14 3. Summary of Error Codes ............................................................................................................16 Q n 4. Examples.....................................................................................................................................17 4.1. Configure SMTP server.....................................................................................................17 e 4.2. Configure the information of sender .................................................................................17 fid 4.3. Add recipients....................................................................................................................17 4.4. Edit the content of the email..............................................................................................18 4.5. Add a file in UFS as attachment........................................................................................19 Con 4.6. Send email.........................................................................................................................19 GSM_SMTP_ATC_V1.2 - 2 - GSM_SMTP_ATC_V1.2 0. Revision history Revision 1.00 1.1 1.2 Date Author 2010-04-23 Colin HU 2010-08-03 Colin HU 2015-04-08 Laguna XU Description of change Initial Add the description about how to add the file in UFS or SD or RAM as the attachment. Added applicable modules CQouneficdteenl tial GSM_SMTP_ATC_V1.2 - 3 - GSM_SMTP_ATC_V1.2 1. Introduction Quectel Module provides an internal TCP/IP stack that is driven by AT commands and enables the host application to easily access the internet service. It includes TCP service, UDP service, HTTP service, FTP service and SMTP service, etc. This document is a reference guide to all the AT commands and responses defined for SMTP service. This document is applicable to all Quectel GSM modules. 1.1. Reference Table 1: Reference l SN Document name te [1] Mxx_ATC [2] GSM_TCPIP_AN c l [3] GSM_File_ATC Remark The introduction of AT commands for Quectel Module To introduce how to use the internal TCP/IP stack To introduce the AT commands for the file system ue tia 1.2. Terms and abbreviations Q n Table 2: Terms and abbreviations e Abbreviation fid APN CSD n FTP GPRS o HTTP CSMTP Description Access Point Network Circuit Switched Data File Transfer Protocol General Packet Radio Service Hypertext Transfer Protocol Simple Mail Transfer Protocol TCP Transmission Control Protocol UART Universal Asynchronous Receiver/Transmitter UDP User Datagram Protocol UFS User File Storage. Please refer to [3] GSM_SMTP_ATC_V1.2 - 4 - GSM_SMTP_ATC_V1.2 2. AT Commands for SMTP Service 2.1. Overview of AT commands for SMTP service Command Description AT+QSMTPUSER SET THE USER NAME FOR AUTHENTICATION AT+QSMTPPWD SET THE PASSWORD FOR AUTHENTICATION AT+QSMTPADDR SET THE EMAIL ADDRESS OF THE SENDER AT+QSMTPNAME SET THE SENDER’S NAME AT+QSMTPSRV AT+QSMTPDST AT+QSMTPSUB AT+QSMTPBODY l AT+QSMTPATT te AT+QSMTPDATT AT+QSMTPCLR c l AT+QSMTPCFG ue tia AT+QSMTPPUT SET THE ADDRESS AND PORT OF SMTP SERVER ADD OR DELETE RECIPIENTS EDIT THE SUBJECT OF THE EMAIL EDIT THE CONTENT OF THE EMAIL ADD AN ATTACHMENT FOR THE EMAIL DELETE AN ATTACHMENT CLEAR ALL THE CONFIGURATIONS AND CONTENTS OF THE EMAIL SMTP CONFIGURATIONS SEND EMAIL Q n 2.2. Detailed description of AT commands for SMTP service e 2.2.1. AT+QSMTPUSER Set the user name for authentication fid AT+QSMTPUSER Set the user name for authentication Test Command Response n AT+QSMTPUSE +QSMTPUSER: 'USER' R=? oOK CParameters See Write Command. Read Command Response AT+QSMTPUSE +QSMTPUSER: '' R? OK Parameters See Write Command. Write Command Response AT+QSMTPUSE If format is right and it is not sending a mail, response GSM_SMTP_ATC_V1.2 - 5 - GSM_SMTP_ATC_V1.2 R='' OK Otherwise response ERROR Reference Parameters The user name for the authentication. The maximum size of the parameter is 50. 2.2.2. AT+QSMTPPWD Set the password for authentication AT+QSMTPPWD Set the Password for Authentication Test Command Response AT+QSMTPPW +QSMTPPWD: 'PASSWORD' D=? OK l Parameters te See Write Command. Read Command Response c l AT+QSMTPWD +QSMTPPWD: '' ? ue tia OK Parameters See Write Command. Q n Write Command Response e AT+QSMTPPW If format is right and it is not sending email, response D='' OK fid Otherwise response ERROR n Parameters Co The password for the authentication. The maximum size of the parameter is 50. Mask for the password Reference 2.2.3. AT+QSMTPADDR Set the email address of the sender AT+QSMTPADDR Set the email address of the sender Test Command AT+QSMTPAD DR=? Response +QSMTPADDR: 'ADDRESS' OK GSM_SMTP_ATC_V1.2 - 6 - GSM_SMTP_ATC_V1.2 Parameters See Write Command Read Command Response AT+QSMTADD +QSMTPADDR: '' R? OK Parameters See Write Command Write Command Response AT+QSMTPAD If format is right and it is not sending email, response DR='' OK Otherwise response ERROR tel Reference Parameters The email address of the sender. uec tial 2.2.4. AT+QSMTPNAME Set the sender’s name AT+QSMTPNAME Set the sender’s name Test Command Q n AT+QSMTPNA ME=? fide Read Command n AT+QSMTPNA Co ME? Response +QSMTPNAME: 'NAME' OK Parameters See Write Command Response +QSMTPNAME: '' OK Parameters See Write Command Write Command Response AT+QSMTPNA If format is right and it is not sending email, response ME='' OK Otherwise response ERROR Parameters GSM_SMTP_ATC_V1.2 - 7 - GSM_SMTP_ATC_V1.2 Reference The sender’s name that will be shown when the recipients receive the email. 2.2.5. AT+QSMTPSRV Set the address and port of SMTP server AT+QSMTPSRV Set the address and port of SMTP server Test Command Response AT+QSMTPSRV +QSMTPSRV: 'SERVER',(1-65535) =? OK Parameters See Write Command Read Command Response AT+QSMTPSRV OK ? +QSMTPSRV: '', l Parameters te See Write Command Write Command Response c l AT+QSMTPSRV If format is right and it is not sending email, response ='',< OK ue tia port> Otherwise, response ERROR Q fiden Reference Parameters The IP address or domain name of the SMTP server. The port of the SMTP server. n 2.2.6. AT+QSMTPDST Add or delete recipients AT+QSMTPDST Add or delete recipients o Test Command Response C AT+QSMTPDST +QSMTPDST: (0,1),(1-3),'ADDRESS' =? OK Parameters See Write Command GSM_SMTP_ATC_V1.2 - 8 - GSM_SMTP_ATC_V1.2 Read Command Response AT+QSMTPDST [+QSMTPDST: ,''[…]] ? OK Parameters See Write Command Write Command Response AT+QSMTPDST If format is right and it is not sending email, response =[,[,'']] +QSMTPDST: Otherwise, response Quneficdteenl tial Reference ERROR Parameters A numeric to indicate to add a recipient or delete a recipient. 0 delete 1 add A numeric to indicate the type of the recipient. 1 receiver 2 copy receiver 3 secret receiver The email address of the recipient to add or delete. A numeric to indicate the result of the operation. If it is a negative numeric, it is the type of error (Please refer to the chapter 3). If it is 0, it means the operation is X X successful. Note: If equals 0, i.e. try to delete recipients, then if is default, this command will delete all the recipients whose type is same as what defines, and then if is also default, this command will delete all the recipients. The maximum number of the recipients is 20. Co 2.2.7. AT+QSMTPSUB Edit the subject of the email AT+QSMTPSUB Edit the subject of the email Test Command Response AT+QSMTPSUB +QSMTPSUB: (0-3),'TITLE' =? OK Parameters See Write Command GSM_SMTP_ATC_V1.2 - 9 - GSM_SMTP_ATC_V1.2 Read Command Response AT+QSMTPSUB +QSMTPSUB: ,'' ? OK Parameters See Write Command Write Command Response AT+QSMTPSUB If format is right and it is not sending email, response =,'' Otherwise, response ERROR Quectenl tial Reference Parameters A numeric to indicate the character set of the title. 0 ASCII 1 UTF-8 2 GB2312 3 BIG5 A string as the title of the email. If is 0, this string will be as the title of the email. Otherwise, it is formatted as a hexadecimal number string, e.g. '41' means the HEX value 0x41. The length of is 0-100 if the character set is ASCII. The length of is 0-200 if the character set is not ASCII. e 2.2.8. AT+QSMTPBODY Edit the content of the email fid AT+QSMTPBODY Edit the content of the email Test Command n AT+QSMTPBO Co DY=? Response +QSMTPBODY: (0-3),(1-48000) OK Parameters See Write Command Write Command Response AT+QSMTPBO If format is right and it is not sending email, response DY= OK [,] CONNECT +QSMTPBODY: Otherwise, response GSM_SMTP_ATC_V1.2 - 10 - GSM_SMTP_ATC_V1.2 ERROR Parameters A numeric to indicate the character set of the title. 0 ASCII 1 UTF-8 2 GB2312 3 BIG5 The maximum time to download email body from UART. The unit is second. If it is default, the maximum time is infinite. A numeric to indicate the result to input email body. If l Reference it is a negative numeric, it is the same as (Please refer to the chapter 3). If is not a negative numeric, it X X represents the length of the input email body data. Note: 1. '+++' is used to end downloading email body. 2. The maximum size of the email body is 10 Kbytes. cte l 2.2.9. AT+QSMTPATT Add an attachment for the email AT+QSMTPATT Add an attachment for the email ue tia TestCommand Response AT+QSMTPATT +QSMTPATT: 'FILE NAME',,(1-48000) =? Q n OK Read Command Response e AT+QSMTPATT [+QSMTPATT: ,'', ……] fid ? OK Parameters n See Write Command Write Command Response o AT+QSMTPATT If format is right and it is not sending email, response C =''[, OK ,] If the data of the attachment fill will be input via UART and the UART enters data mode successfully, response CONNECT After the attachment has been attached successfully, response +QSMTPATT: Otherwise, response ERROR GSM_SMTP_ATC_V1.2 - 11 - GSM_SMTP_ATC_V1.2 Parameters The index of the attachment. A string as the file name of the attachment to add. If it is started with '/UFS/', it will get the specified file in UFS as the attachment. And in M33, it is also supported to get the file in the directory of 'Picture' of SD and RAM as the attachment, but it is necessary to add '/SD/' before the file name for the file in the directory 'Picture' of SD card and '/RAM/' before the filename for the file in RAM. the size of the attachment to add. The range is Queficdteenl tial Reference 0-102400. The unit is byte. For the file in UFS or SD or RAM, this parameter is default and the size of the attachment is the real size of the file to attach. the maximum time to download email attachment from UART. The unit is second. If it is default, the maximum time is infinite. The range is 1-48000. The unit is second. For the file in UFS or SD or RAM, this parameter is default. A numeric to indicate the result to input the attachment. If it is a negative numeric, it is the same as (Please refer to the chapter 3). If is not a negative X X numeric, it represents the real length of the attachment. Note: 1. '+++' is used to end downloading attachment 2. The total number of the attachments should be no more than 10. 3. The total size of the attachments should be not greater than 100 Kbytes. This restriction is only the attachments input from UART. 2.2.10. AT+QSMTPDATT Delete an attachment n AT+QSMTPDATT Delete an attachment o Test Command Response C AT+QSMTPDA +QSMTPDATT: (1-10) TT=? OK Execute Response Command If format is right and it is not sending email, response AT+QSMTPDA OK TT +QSMTPDATT: Otherwise, response ERROR GSM_SMTP_ATC_V1.2 - 12 - GSM_SMTP_ATC_V1.2 Write Command AT+QSMTPDA TT= Parameters See Write Command Response If format is right and it is not sending email, response OK +QSMTPDATT: Otherwise, response ERROR Parameters The index of the attachment to delete. Please refer to tel Reference in 2.2.9 X X A numeric to indicate the result to delete the attachment. If it is 0, it means it is successful to delete the attachment. If it is a negative numeric, it is the same as (Please refer to the chapter 3). X X Note: The Execute Command is used to delete all the attachments. c l 2.2.11. AT+QSMTPCLR Clear all the configurations and contents of the email ue tia AT+QSMTPCLR Clear all the configurations and contents of the email Test Command AT+QSMTPCL Q n R=? Response OK Execute e Command fid AT+QSMTPCL R If format is right, response OK Otherwise, response ERROR Con Reference Note: The execute command will clear the following configurations and contents. 1. user name (refer to the command AT+QSMTPUSER) 2. password (refer to the command AT+QSMTPPWD) 3. the sender’s address (refer to the command AT+QSMTPADDR) 4. the sender’s name (refer to the command AT+QSMTPNAME) 5. the address of the SMTP server (refer to the command AT+QSMTPSRV) 6. all the recipients (refer to the command AT+QSMTPDST) 7. the subject (refer to the command AT+QSMTPSUB) 8. the body (refer to the command AT+QSMTPBODY) 9. all the attachments (refer to the command AT+QSMTPATT) GSM_SMTP_ATC_V1.2 - 13 - GSM_SMTP_ATC_V1.2 2.2.12. AT+QSMTPCFG SMTP configurations AT+QSMTPCFG SMTP configurations Test Command Response AT+QSMTPCF +QSMTPCFG: (1) G=? OK Write Command Response AT+QSMTPCF If format is right and is omitted, response G=[,<valu +QSMTPCFG: e>] OK Else If format is right and it is not sending email, response OK Otherwise, response ERROR Queficdteenl tial Reference Parameters A numeric to indicate the parameter to configure. 1 configure whether need authentication the value of the parameter to configure defined by . If == 1 0 don’t need authentication 1 need authentication. This is factory default value. Note: The Write Command with omitted is used to query the value of the corresponding parameter. 2.2.13. AT+QSMTPPUT Send email n AT+QSMTPPUT Send email Test Command o AT+QSMTPPU C T=? Response +QSMTPPUT: (100-48000) OK Execute If format is right and it is not sending email, response Command OK AT+QSMTPPU T +QSMTPPUT: Otherwise, response ERROR Note: This means the module will try to send the email without time GSM_SMTP_ATC_V1.2 - 14 - GSM_SMTP_ATC_V1.2 Write Command AT+QSMTPPU T= restriction. Response If format is right and it is not sending email, response OK +QSMTPPUT: Otherwise, response ERROR Parameters the maximum time to send email. The unit is second. If it is default, the maximum time is infinite. The range is CQouneficdteenl tial Reference 100-48000. A numeric to indicate the result to send the email. If it is 0, it means it is successful to send the mail. If it is a negative numeric, it is the same as (Please refer to the chapter 3). X X GSM_SMTP_ATC_V1.2 - 15 - GSM_SMTP_ATC_V1.2 3. Summary of Error Codes The error code indicates an error related to mobile equipment or network. The detail about is described in the following table. Meaning -1 Unknown error -3 The SMTP service is busy. Such as, downloading body or attachment, sending email -4 Failed to get IP address according to domain name -5 Network error. Such as, failed to activate GPRS/CSD context, failed to -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -421 -450 -451 -452 -500 -501 -502 -503 -504 establish the TCP connection with the SMTP server or failed to send email to the SMTP server, etc. Unsupported authentication type l The connection for the SMTP service is closed by peer. GPRS/CSD context is deactivated te Timeout No recipient for the SMTP service c l Failed to send email ue tia Failed to open file for attachment No enough memory for the attachment Failed to save the attachment Q n The input parameter is wrong Service not available, closing transmission channel e Requested mail action not taken: mailbox unavailable fid Requested action aborted: local error in processing Requested action not taken: insufficient system storage Syntax error, command unrecognized n Syntax error in parameters or arguments Command not implemented oBad sequence of commands CCommand parameter not implemented -521 does not accept mail (see rfc1846) -530 Access denied -535 Authentication failed -550 Requested action not taken: mailbox unavailable -551 User not local; please try -552 Requested mail action aborted: exceeded storage allocation -553 Requested action not taken: mailbox name not allowed -554 Transaction failed GSM_SMTP_ATC_V1.2 - 16 - GSM_SMTP_ATC_V1.2 4. Examples 4.1. Configure SMTP server AT+QSMTPSRV='smtp.163.com', 25 OK // Set SMTP server as 'smtp.163.com' and port as 25 AT+QSMTPUSER='quectel' OK // Set the user name for authentication as 'quectel' AT+QSMTPPWD='test' OK // Set the password for authentication as 'test' l Note: Actually, the user name 'quectel' and password 'test' isn’t a valid account. It is just an te example. uec tial 4.2. Configure the information of sender AT+QSMTPNAME='quectel' Q n OK // Set the name of the sender as 'quectel' e AT+QSMTPADDR='quectel@163.com' // Set the email address of the sender as fid'quectel@163.com' OK n 4.3. Add recipients Co AT+QSMTPDST=1,2,'colin.hu@quectel.com' // Add a recipient 'colin.hu@quectel.com'. And it is a copy receiver which is defined by 2. OK +QSMTPDST: 0 // Successfully add the recipient. By the way, if you find the recipient you added before is wrong and you want to delete it, please execute the following command. AT+QSMTPDST=0,2,'colin.hu@quectel.com' // Delete the recipient GSM_SMTP_ATC_V1.2 - 17 - GSM_SMTP_ATC_V1.2 OK +QSMTPDST: 0 'colin.hu@quectel.com' in the copy recipients list. // Successfully delete the recipient. 4.4. Edit the content of the email AT+QSMTPSUB=0,'SMTP TEST' OK // Set the title of the email as 'SMTP TEST' AT+QSMTPBODY=1, 10 OK // Prepare to input the content of the email from UART. And the character set of the email body is UTF-8 which is defined by 1. l CONNECT te …… c l +++ +QSMTPBODY: 2009 ue tia AT+QSMTPATT='bigfile.txt' OK // Input the data of the email body // Input '+++' to end downloading email body // Successful to download email body and the size of the email body is 2009. // Prepare to download the attachment 'bigfile.txt' Q n CONNECT e …… fid +++ +QSMTPATT: 20090 // Input the data of the attachment // Input '+++' to end downloading the attachment // Successful to download the attachment and the size of the attachment is 20090. n AT+QSMTPATT? Co +QSMTPATT: 1,'bigfile.txt', 20090 // Query the information of all attachments // The first attachment is 'bigfile.txt' and its size is 20090. OK By the way, if you don’t want send the attachment with the email, please delete the attachment by the following command. AT+QSMTPDATT=1 OK // Delete the first attachment +QSMTPDATT: 0 GSM_SMTP_ATC_V1.2 // Successfully delete the attachment - 18 - GSM_SMTP_ATC_V1.2 4.5. Add a file in UFS as attachment It is supported to add a file in UFS as the attachment of the email. And the following is an example to add a file in UFS as the attachment. AT+QSMTPATT='/UFS/attach.txt' // Add the file 'attach.txt' in UFS as attachment. OK +QSMTPATT: 20100 // Successful to add the file 'attach.txt' in UFS as attachment and its size is 20100. AT+QSMTPATT? // Query the information of all attachments +QSMTPATT: 1,'bigfile.txt', 20090 // The first attachment is 'bigfile.txt' and its +QSMTPATT: 2,'/UFS/attach.txt', 20100 size is 20090. // The second attachment is 'attach.txt' in UFS and its size is 20100. l OK te In M33, it is supported to add the files in SD and RAM. And the method to add the file in SD or c l RAM is almost the same as the method to add the file in UFS except replacing '/UFS/' with '/SD/' or '/RAM/'. ue tia 4.6.Sendemail Q n AT+QIFGCNT=0 fide OK AT+QICSGP=1,'CMNET' n OK Co AT+QSMTPPUT=300 // Choose the context 0 to activate GPRS/CSD context for the SMTP service, please refer to [1] and [2] // Choose GPRS mode and set the APN as 'CMNET' // Send the email to the SMTP server and the maximum time allowed to send email is 300 seconds. OK …… // Wait for a moment +QSMTPPUT:0 // Successfully send email. GSM_SMTP_ATC_V1.2 - 19 - Quectel Wireless Solutions Co., Ltd. Room 501, Building 9, No.99, Tianzhou Road, Shanghai, China 200233 Tel: +86 21 5108 2965 Mail: info@quectel.com H H

GSM SMTPS Application Note GSM/GPRS Module Series Rev. GSM_SMTPS_Application_Note_V3.1 Date: 2015-04-08 www.quectel.com GSM/GPRS Module Series GSM SMTPS Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_SMTPS_Application_Note Confidential / Released 1 / 25 GSM/GPRS Module Series GSM SMTPS Application Note About the Document History Revision 3.0 3.1 Date 2013-09-25 CQouneficdteenl tial 2015-04-08 Author Andy CHEN Andy CHEN Description Initial Added applicable modules GSM_SMTPS_Application_Note Confidential / Released 2 / 25 GSM/GPRS Module Series GSM SMTPS Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 1.1. SSL Version and CipherSuite.................................................................................................... 5 1.2. The Usage of SMTP/SMTPS Function ..................................................................................... 6 1.3. Evading Failure of Certificate Verification Due to RTC Time .................................................... 7 1.4. Error Handling ........................................................................................................................... 7 1.4.1. PDP Activation Fails ......................................................................................................... 7 2 3 4 5 1.4.2. DNS Parse Fails............................................................................................................... 8 1.4.3. Error Response of AT+QSMTPPUT ................................................................................ 8 Description of AT Command .............................................................................................................. 9 l 2.1. General Description................................................................................................................... 9 2.2. AT Command Syntax ................................................................................................................ 9 te 2.2.1. AT+QSSLCFG SSL Configuration................................................................................. 9 c l Example about the Usage of SMTP/SMTPS Function.................................................................... 14 3.1. Send Email without SSL.......................................................................................................... 14 ue tia 3.2. Send Email by SSL ................................................................................................................. 16 3.3. Send Email by STARTTLS ...................................................................................................... 19 Q n Summary of Error Code .................................................................................................................... 23 Confide Appendix A Reference.......................................................................................................................25 GSM_SMTPS_Application_Note Confidential / Released 3 / 25 GSM/GPRS Module Series GSM SMTPS Application Note Table Index TABLE 1: SSL VERSION..................................................................................................................................... 5 TABLE 2: SSL CIPHERSUITE............................................................................................................................. 5 TABLE 3: SUMMARY OF ERROR CODES ...................................................................................................... 23 TABLE 4: RELATED DOCUMENTS .................................................................................................................. 25 TABLE 5: TERMS AND ABBREVIATIONS ........................................................................................................ 25 CQouneficdteenl tial GSM_SMTPS_Application_Note Confidential / Released 4 / 25 GSM/GPRS Module Series GSM SMTPS Application Note 1 Introduction This document describes how to use the SMTPS function of Quectel standard module. In some cases, in order to ensure communication privacy, the communication between the server and the client should be in an encrypted way. So that it can prevent the communication data from eavesdropping, tampering, or forging. The SSL function meets these demands. This document is applicable to Quectel M10, M26, M35 and M50 modules. l 1.1. SSL Version and CipherSuite cte l So far, several SSL versions have been released. They are SSL2.0, SSL3.0, TLS1.0, TLS1.1, and TLS1.2. The following versions are supported by Quectel modules. ue tia Table1:SSL Version Q n SSL Version e SSL3.0 fid TLS1.0 n TLS1.1 Co TLS1.2 The following table shows the names of the CipherSuites that Quectel module supports. Please refer to RFC 2246-The TLS Protocol Version 1.0 on the CipherSuite definitions for details. Table 2: SSL CipherSuite CipherSuite Code 0X0035 CipherSuite Name TLS_RSA_WITH_AES_256_CBC_SHA GSM_SMTPS_Application_Note Confidential / Released 5 / 25 0X0005 0X0004 0X000A 0X002F 0X003D GSM/GPRS Module Series GSM SMTPS Application Note TLS_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA256 1.2. The Usage of SMTP/SMTPS Function There are three kinds of connections between SMTP client and SMTP server, which are no SSL, SSL and SSL with STARTTLS. Some SMTP servers support only two kinds and some support all of them, you can l choose one kind according to your needs. The steps of the usage of SMTPS function are briefly listed as below. te Step 1: The command 'AT+QICSGP' is used to configure the APN, username, password of the context c l profile, and so on. ue tia Step 2: The command 'AT+QIREGAPP' is used to register to the TCP/IP stack. Step 3: The command 'AT+QIACT' is used to activate GPRS PDP context. After PDP context is activated, the command 'AT+QILOCIP' is used to query the local IP address. Step 4: The command 'AT+QSSLCFG' is used to configure SSL version, CipherSuite, connection Q n between SMTP client and SMTP server and so on. e Step 5: Execute the command 'AT+QSMTPUSER' and 'AT+QSMTPPWD' to set the user name and password for authentication. fid 1) Execute the command 'AT+QSMTPNAME' and 'AT+QSMTPADDR' to set the name and the email address of the sender. n 2) The command 'AT+QSMTPSRV' is used to set the SMTP server and port. The command 'AT+QSMTPDST' is used to add or delete recipients. o 3) Execute the command 'AT+QSMTPSUB' and 'AT+QSMTPBODY' to edit the subject and the Cbody of the email. Execute the command 'AT+QSMTPATT' and 'AT+QSMTPDATT' to add or delete an attachment for the email. The attachments can be RAM files or UFS files. It is strongly recommended to use RAM file to upload the attachments. Step 6: Step 7: The command 'AT+QSMTPPUT' is used to send email. The command 'AT+QSMTPCLR' is used to clear all email configuration, 'AT+QFDEL' is used to delete the files as attachments, and 'AT+QIDEACT' is used to deactivate GPRS PDP context. GSM_SMTPS_Application_Note Confidential / Released 6 / 25 GSM/GPRS Module Series GSM SMTPS Application Note 'AT+QSMTPCLR' will clear the email configuration in Step 5. Of course, if you want to change the type of SMTP server, the SMTP server address and user information, Step 4 to Step 5 can be repeated. If you have not sent email for a long time, such as 30 minutes or even longer, you should deactivate the PDP context by AT+QIDEACT. NOTES 1. If you want to know the usage of AT commands QICSGP, QIACT, QILOCIP, QIMUX and QIDEACT for details, please refer to Mxx_AT_Commands_Manual. And please refer to GSM_SMTP_AT_Command_Manual_V1.0.pdf on SMTP AT commands for more information. 2. About the usage of QFDEL and other FILE AT commands, please refer to GSM_FILE_ATC_Vx.x. 3. For other AT commands, please refer to the corresponding documentation of the corresponding module. l 1.3. Evading Failure of Certificate Verification Due to RTC Time te In the normal case, the RTC time of module must be within the period of validity of the certificate, c l otherwise the result of verifying certificate will be failure. In order to resolve this problem, the first method is to set a proper time for the module via AT command 'AT+CCLK='. And the second one is to ue tia execute AT command 'AT+QSSLCFG='ignorertctime',1', after configuring value as 1, module will ignore the period of validity of the certificate. Q n NOTE e If you want to know detailed usage of AT commands CCLK, please refer to Mxx_AT_Commands_Manual. Confid 1.4. Error Handling 1.4.1. PDP Activation Fails If you failed to activate PDP context by AT+QIACT command, please check the following aspects: 1. Query whether the PS domain is attached by AT+CGATT? command, if not, execute AT+CGATT=1 to attach PS domain. 2. Query the CGREG status by AT+CGREG? and make sure the PS domain is registered to. 3. Query the PDP context parameters by AT+QIREGAPP command, make sure the APN of specified PDP context is set. GSM_SMTPS_Application_Note Confidential / Released 7 / 25 GSM/GPRS Module Series GSM SMTPS Application Note 4. Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT command. If the result of checking is OK, but the result of executing AT+QIACT command always fails, please reboot the module to resolve this issue. After booting the module, please check the terms mentioned above at least three times and each time at an interval of 10 minutes to avoid frequently rebooting the module. 1.4.2. DNS Parse Fails When executing AT+QSMTPPUT commands, if it responds '+QSMTPPUT: -4', please check following aspects: 1. Make sure the domain name of SMTP server is valid. 2. Execute 'AT+QILOCIP', if it can acquire a valid IP address, it means that the PDP context is activated successfully. Otherwise the PDP context is in a deactivate state. l 1.4.3. Error Response of AT+QSMTPPUT cte l After executing AT+QSMTPPUT, '+QSMTPPUT: ' will be returned to indicate the result of sending ue tia mail, and is an error code. If is 0, it means it is successful to send the mail. If it is a negative numeric, it means sending mail is failed, please resend it. Q n If is not 0, it indicates the sending is failed, please resend it. If resending is not successful, you should deactivate the PDP context by AT+QIDEACT command, and try again. (Please refer to Chapter e 1.4.1.) fid If is a negative numeric, you can refer to Chapter 4 to check the reason of this errorcode. For example, if is -535 (Authentication failed), or may be wrong. If is -530 (Access denied), you may send email too frequently and the SMTP server rejects to post email. Con For details, you can refer to the document RFC2821 (Simple Mail Transfer Protocol). GSM_SMTPS_Application_Note Confidential / Released 8 / 25 GSM/GPRS Module Series GSM SMTPS Application Note 2 Description of AT Command 2.1. General Description This command returns the list of parameters and value ranges Test Command AT+=? set by the corresponding Write Command or internal processes. Read Command Write Command l Execution te Command AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the GSM engine uec tial 2.2. AT Command Syntax Q n 2.2.1. AT+QSSLCFG SSL Configuration fide This AT command is used to configure the SSL version, CipherSuite, secure level, CA certificate, client certificate, client key, ignoring RTC time, HTTP/HTTPS, and SMTP/SMTPS. These parameters will be used in the handshake procedure. n CTX is the abbreviation of the SSL (Secure Socket Layer) context. is the index of the SSL o context. Quectel standard module supports 6 SSL contexts at most. On the basis of a SSL context, C several SSL connections can be established. The settings such as the SSL version and the CipherSuite are stored in the SSL context, and the settings will be applied to the new SSL connection which is associated with the SSL context. AT+QSSLCFG SSL Configuration Test Command AT+QSSLCFG=? Response +QSSLCFG: 'type',(0-5),'value' Query the setting of the context OK +QSSLCFG: ,,, GSM_SMTPS_Application_Note Confidential / Released 9 / 25 GSM/GPRS Module Series GSM SMTPS Application Note AT+QSSLCFG='ctxindex',<ctxindex ,,, > Configure the SSL version AT+QSSLCFG='sslversion',[,] OK Otherwise response ERROR Response OK Otherwise response ERROR If the third parameter is omitted, query the 'sslversion' value. +QSSLCFG: 'sslversion', Configure the CipherSuite AT+QSSLCFG='ciphersuite', l [,<list of supported te s>] OK Response OK Otherwise response ERROR If the third parameter is omitted, query the 'ciphersuite' value. +QSSLCFG: 'ciphersuite', uec tial Configure the authentication mode AT+QSSLCFG='seclevel', Q en [,] OK Response OK Otherwise response ERROR If the third parameter is omitted, query the 'seclevel' value. +QSSLCFG: 'seclevel', fid Configure the path of root certificate n AT+QSSLCFG='cacert',[, Co ] OK Response OK Otherwise response ERROR If the third parameter is omitted, query the 'cacertname' value. +QSSLCFG: 'cacert', Configure the path of client certificate AT+QSSLCFG='clientcert',[,] OK Response OK Otherwise response ERROR GSM_SMTPS_Application_Note Confidential / Released 10 / 25 GSM/GPRS Module Series GSM SMTPS Application Note If the third parameter is omitted, query the 'clientcertname' value. +QSSLCFG: 'clientcert', Configure the path of client key AT+QSSLCFG='clientkey',[,] OK Response OK Otherwise response ERROR If the third parameter is omitted, query the 'clientkeyname' value. +QSSLCFG: 'clientkey', Configure whether to ignore the RTC time l AT+QSSLCFG='ignorertctime'[,] OK Response OK Otherwise response ERROR If the second parameter is omitted, query the 'ignorertctime' value. +QSSLCFG: 'ignorertctime', ue tia Enable/Disable the HTTPS function Q n AT+QSSLCFG='https'[,] OK Response OK Otherwise response ERROR If the second parameter is omitted, query the 'httpsenable' value. +QSSLCFG: 'https', on Configure the SSL context index for HTTPS C AT+QSSLCFG='httpsctxi'[,] ERROR If the second parameter is omitted, query the 'httpsctxindex' value. +QSSLCFG: 'httpsctxi', Configure the type of SMTP/SMTPS AT+QSSLCFG='smtpstyle'[,] OK Response OK Otherwise response GSM_SMTPS_Application_Note Confidential / Released 11 / 25 GSM/GPRS Module Series GSM SMTPS Application Note ERROR If the second parameter is omitted, query the 'smtpstyle' value. +QSSLCFG: 'smtpstyle', OK Configure the SSL context index for Response SMTPS OK AT+QSSLCFG='smtpsctxi'[,< Otherwise response smtpsctxindex>] ERROR If the second parameter is omitted, query the 'smtpsctxindex' value. Reference +QSSLCFG: 'smtpctxi', OK tel Parameter c l ue tia CQonfiden SSL context index 0~5 Configure the SSL version 0 SSL3.0 1 TLS1.0 2 TLS1.1 3 TLS1.2 4 ALL SUPPORT Configure the CipherSuite 0X0035 TLS_RSA_WITH_AES_256_CBC_SHA 0X002F TLS_RSA_WITH_AES_128_CBC_SHA 0X0005 TLS_RSA_WITH_RC4_128_SHA 0X0004 TLS_RSA_WITH_RC4_128_MD5 0X000A TLS_RSA_WITH_3DES_EDE_CBC_SHA 0X003D TLS_RSA_WITH_AES_256_CBC_SHA256 0XFFFF All support Configure the authentication mode 0 No authentication 1 Manage server authentication 2 Manage server and client authentication if requested by the remote server. If no authentication is set, no security data are needed (Client certificate, Server CA certificate and Client private key). String format, configure the server CA certificate GSM_SMTPS_Application_Note Confidential / Released 12 / 25 GSM/GPRS Module Series GSM SMTPS Application Note String format, configure the client certificate String format, configure the client key Configure whether ignore the RTC time 0 Do not ignore the RTC time 1 Ignore the RTC time Enable/disable the HTTPS function 0 Disable HTTPS 1 Enable HTTPS Configure the SSL context for HTTPS Httpsctxindex is the index of SSL context. If the host does not configure the httpsctxindex, the value of httpsctxindex will be -1. 0-5 CQouneficdteenl tial Configure the type of SMTP/SMTPS 0 No SSL 1 SSL 2 SSL with STARTTLS Configure the SSL context for SMTPS smtpsctxindex is the index of SSL context. If the host does not configure the smtpsctxindex, the value of smtpsctxindex will be -1. 0-5 GSM_SMTPS_Application_Note Confidential / Released 13 / 25 GSM/GPRS Module Series GSM SMTPS Application Note 3 Example about the Usage of SMTP/ SMTPS Function 3.1. Send Email without SSL //Step 1: Configure and activate the PDP context. AT+ QIFGCNT=0 OK l AT+ QICSGP=1,'CMNET' te OK c l AT+QIREGAPP OK ue tia AT+QIACT OK AT+QILOCIP Q n 10.1.83.188 //Set context 0 as foreground context. //Set bearer type as GPRS and the APN is 'CMNET' and no user name and password for the APN. //Register to the TCP/IP stack. //Activate GPRS PDP context. //Query the local IP address. e //Step 2: Configure SMTP server without SSL. fid AT+QSSLCFG='smtpstyle',0 OK //The type is No SSL mode. //Step 3: Configure user account and recipients. n AT+QSMTPUSER='quectel_test@aol.com' Co OK //Set the user name for authentication. AT+QSMTPPWD='aol123456***' //Set the password for authentication. OK AT+QSMTPNAME='quectel_company' //Set the name of the sender. OK AT+QSMTPADDR='quectel_test@aol.com ' //Set the email address of the sender. OK AT+QSMTPSRV='smtp.aol.com',25 //Set the SMTP server and port. OK AT+QSMTPDST=1,1,'quectel_xxx@gmail.com' //Add a recipient and the recipient type is 1 which means recipients. GSM_SMTPS_Application_Note Confidential / Released 14 / 25 GSM/GPRS Module Series GSM SMTPS Application Note OK +QSMTPDST: 0 AT+QSMTPDST=1,2,'quectel_xxx@hotmail.com' //Add a recipient and the recipient type is 2 which means CC recipients. OK +QSMTPDST: 0 AT+QSMTPDST=1,3,'quectel_xxx@aol.com' OK //Add a recipient and the recipient type is 3 which means BCC recipients. +QSMTPDST: 0 //Step 4: Edit the email content. AT+QSMTPSUB=0,'about smtp e-mail' l OK AT+QSMTPBODY=1,60 te OK c l CONNECT ue tia +QSMTPBODY:14 AT+QFUPL='RAM:pic.jpg',30000 Q fiden CONNECT //For example, input 14 bytes: Hello, welcome! //Upload a file to RAM, the file will be saved as 'file_test.txt' and the maximum of the size is 30000 bytes. (If you want to know more information about AT command 'AT+QFUPL, AT+QFDEL', please refer to documents GSM_FILE_ATC_XXX.pdf). n +QFUPL: 26977,cea0 o OK C AT+QFUPL='RAM: file_test.txt',100 CONNECT +QFUPL: 100,7159 OK AT+QSMTPATT='RAM:pic.jpg' OK //Add an attachment for the email, pic.jpg is in RAM. GSM_SMTPS_Application_Note Confidential / Released 15 / 25 GSM/GPRS Module Series GSM SMTPS Application Note +QSMTPATT: 26977 AT+QSMTPATT='RAM:file_test.txt' OK //Add an attachment for the email, file_test.txt is in RAM. +QSMTPATT: 100 AT+QSMTPATT? +QSMTPATT: 1, 'RAM:pic.jpg',26977 +QSMTPATT: 2, 'RAM:file_test.txt',100 OK //Step 5: Send email. AT+QSMTPPUT=800 OK //Send email and the maximum time is 800 seconds. l //It may take a few minutes. te +QSMTPPUT: 0 //Send mail successfully. c l //If the host sends mail unsuccessfully, it is no need to do any configuration settings, the host can execute 'AT+QSMTPPUT=800' directly to send mail again. ue tia //Step 6: Clear all of email configuration; delete attachment and deactivate PDP context. AT+QSMTPCLR Q n OK AT+QFDEL='RAM:pic.jpg' e OK fid AT+QFDEL='RAM:file_test.txt' OK //Clear the configuration from step 3 to step 4. //Delete the pic.jpg from RAM. //Delete the file_test.txt from RAM. //If the host wants to send a new email, repeat from step 3 to step 6. n AT+QIDEACT Co DEACT OK //Deactivate GPRS PDP context. 3.2. Send Email by SSL //Step 1: Configure and activate the PDP context. AT+ QIFGCNT=0 OK AT+ QICSGP=1,'CMNET' OK //Set context 0 as foreground context. //Set bearer type as GPRS and the APN is 'CMNET' and no user name and password for the APN. GSM_SMTPS_Application_Note Confidential / Released 16 / 25 GSM/GPRS Module Series GSM SMTPS Application Note AT+QIREGAPP OK AT+QIACT OK AT+QILOCIP 10.1.83.188 //Register to the TCP/IP stack. //Activate GPRS PDP context. //Query the local IP address. //Step 2: Configure SSL for SMTPS AT+QSSLCFG='sslversion',0,1 //Configure SslVersion. OK AT+QSSLCFG='seclevel',0,0 //Configure no authentication mode. OK AT+QSSLCFG='ciphersuite',0,'0XFFFF' OK l AT+QSSLCFG='smtpstyle',1 OK te AT+QSSLCFG='smtpsctxi',0 OK c l AT+QSSLCFG='smtpstyle' ue tia +QSSLCFG: 'smtpstyle',1 //Configure SSL CipherSuite type as 0XFFFF which means support all CipherSuite. //The type is SSL mode. //Select SSL context 0 for SMTPS. //Query the SMTP type. OK AT+QSSLCFG='smtpsctxi' Q n +QSSLCFG: 'smtpsctxi',0 //Query the index of SSL context. e OK fid //Step 3: Configure SMTP server, user account and recipients AT+QSMTPUSER='quecteltestmail@gmail.com' //Set the user name for authentication. n OK AT+QSMTPPWD='yy1234***' //Set the password for authentication. Co OK AT+QSMTPNAME='quectel_company' //Set the name of the sender. OK AT+QSMTPADDR='quecteltestmail@gmail.com' //Set the email address of the sender. OK AT+QSMTPSRV='smtp.gmail.com',465 //Set the SMTPS server and port. OK AT+QSMTPDST=1,1,'quectel_xxx@gmail.com' //Add a recipient and the recipient type is 1 which OK means recipients. GSM_SMTPS_Application_Note Confidential / Released 17 / 25 GSM/GPRS Module Series GSM SMTPS Application Note +QSMTPDST: 0 AT+QSMTPDST=1,2,'quectel_xxx@hotmail.com' //Add a recipient and the recipient type is 2 which means CC recipients. OK +QSMTPDST: 0 AT+QSMTPDST=1,3,'quectel_xxx@aol.com' OK //Add a recipient and the recipient type is 3 which means BCC recipients. +QSMTPDST: 0 //Step 4: Edit the email content. AT+QSMTPSUB=0,'about smtps e-mail' OK l AT+QSMTPBODY=1,60 OK te CONNECT uec tial +QSMTPBODY:14 AT+QFUPL='RAM:pic.jpg',30000 Q en CONNECT //For example, input 14 bytes: Hello, welcome! //Upload a file to RAM, the file will be saved as 'file_test.txt' and the maximum of the size is 30000 bytes.(If you want to know more information about AT command 'AT+QFUPL, AT+QFDEL', please refer to documents GSM_FILE_ATC_XXX.pdf). fid +QFUPL: 26977,cea0 n OK Co AT+QFUPL='RAM: file_test.txt',100 CONNECT +QFUPL: 100,7159 OK AT+QSMTPATT='RAM:pic.jpg' //Add an attachment for the email, pic.jpg is in RAM. OK GSM_SMTPS_Application_Note Confidential / Released 18 / 25 GSM/GPRS Module Series GSM SMTPS Application Note +QSMTPATT: 26977 AT+QSMTPATT='RAM:file_test.txt' OK //Add an attachment for the email, file_test.txt is in RAM. +QSMTPATT: 100 AT+QSMTPATT? +QSMTPATT: 1,'RAM:pic.jpg',26977 +QSMTPATT: 2,'RAM:file_test.txt',100 OK //Step 5: Send email. AT+QSMTPPUT=800 l OK //Send email and the maximum time is 800 seconds. //It may take a few minutes. te +QSMTPPUT: 0 //Send mail successfully. c l //If the host sends mail unsuccessfully, it is no need to do any configuration settings. The host can execute ue tia 'AT+QSMTPPUT=800' directly to send mail again. //Step 6: Clear all of email configuration; delete attachment and deactivate PDP context. Q n AT+QSMTPCLR OK e AT+QFDEL='RAM:pic.jpg' fid OK AT+QFDEL='RAM:file_test.txt' OK //Clear the configuration from step 3 to step 4. //Delete the pic.jpg from RAM. //Delete the file_test.txt from RAM. n //If the host wants to send a new email, repeat from step 3 to step 6. o AT+QIDEACT C DEACT OK //Deactivate GPRS PDP context. 3.3. Send Email by STARTTLS //Step 1: Configure and activate the PDP context. AT+ QIFGCNT=0 OK AT+ QICSGP=1, 'CMNET' //Set context 0 as foreground context. //Set bearer type as GPRS and the APN is 'CMNET' and no user name and password for the APN. GSM_SMTPS_Application_Note Confidential / Released 19 / 25 GSM/GPRS Module Series GSM SMTPS Application Note OK AT+QIREGAPP OK //Register the TCP/IP stack. AT+QIACT OK AT+QILOCIP 10.1.83.188 //Activate GPRS PDP context. //Query the local IP address. //Step 2: Configure SSL for SMTPS AT+QSSLCFG='sslversion',0,1 //Configure SSL Version. OK AT+QSSLCFG='seclevel',0,0 OK AT+QSSLCFG='ciphersuite',0,'0XFFFF' OK l AT+QSSLCFG='smtpstyle',2 OK te AT+QSSLCFG='smtpsctxi',0 OK c l AT+QSSLCFG='smtpstyle' ue tia +QSSLCFG: 'smtpstyle',2 //Configure no authentication mode. //Configure SSL CipherSuite type as 0XFFFF which means support all CipherSuite. //The type is STARTTLS mode. //Select SSL context 0 for SMTPS. //Query the SMTP type. OK AT+QSSLCFG='smtpsctxi' Q n +QSSLCFG: 'smtpsctxi',0 //Query the index of SSL context. e OK fid //Step 3: Configure SMTP server, user account and recipients. AT+QSMTPUSER='quectel_test@hotmail.com' //Set the user name for authentication. n OK AT+QSMTPPWD='abc1234***' //Set the password for authentication. o OK C AT+QSMTPNAME='quectel_company' //Set the name of the sender. OK AT+QSMTPADDR='quectel_test@hotmail.com' //Set the email address of the sender OK AT+QSMTPSRV='smtp.live.com',25 //Set the SMTPS server and mail port. OK AT+QSMTPDST=1,1,'quectel_xxx@hotmail.com' //Add a recipient and the recipient type is 1 which OK means recipients. +QSMTPDST: 0 GSM_SMTPS_Application_Note Confidential / Released 20 / 25 GSM/GPRS Module Series GSM SMTPS Application Note AT+QSMTPDST=1,2,'quectel_xxx@hotmail.com' //Add a recipient and the recipient type is 2 which means CC recipients. OK +QSMTPDST: 0 AT+QSMTPDST=1,3,'quectel_xxx@aol.com' OK //Add a recipient and the recipient type is 3 which means BCC recipients. +QSMTPDST: 0 //Step 4: Edit the email content. AT+QSMTPSUB=0,'about smtps starttls e-mail' OK AT+QSMTPBODY=1,60 OK l CONNECT te +QSMTPBODY: 14 c l AT+QFUPL='RAM:pic.jpg',30000 Que entia CONNECT //For example, input 14 bytes Hello, welcome! //Upload a file to RAM,the file will be saved as 'file_test.txt' and the maximum of the size is 30000 bytes.(If you want to know more information about AT command 'AT+QFUPL, AT+QFDEL', please refer to documents GSM_FILE_ATC_XXX.pdf). fid +QFUPL: 26977,cea0 n OK AT+QFUPL='RAM: file_test.txt',100 Co CONNECT +QFUPL: 100,7159 OK AT+QSMTPATT='RAM:pic.jpg' OK //Add an attachment for the email, pic.jpg is in RAM. +QSMTPATT: 26977 GSM_SMTPS_Application_Note Confidential / Released 21 / 25 GSM/GPRS Module Series GSM SMTPS Application Note AT+QSMTPATT='RAM:file_test.txt' OK //Add an attachment for the email, file_test.txt is in RAM. +QSMTPATT: 100 AT+QSMTPATT? +QSMTPATT: 1,'RAM:pic.jpg',26977 +QSMTPATT: 2,'RAM:file_test.txt',100 OK //Step 5: Send email. AT+QSMTPPUT=800 OK //Send email and the maximum time is 800 seconds. //It may take a few minutes. l +QSMTPPUT: 0 //Send mail successfully. //If the host sends mail unsuccessfully, it is no need to do any configuration settings, the host can execute te 'AT+QSMTPPUT=800' directly to send mail again. c l //Step 6: Clear all of email configuration; delete attachment and deactivate PDP context. ue tia AT+QSMTPCLR OK AT+QFDEL='RAM:pic.jpg' Q n OK AT+QFDEL='RAM:file_test.txt' e OK //Clear the configuration from step 3 to step 4. //Delete the pic.jpg from RAM. //Delete the file_test.txt from RAM. fid //If the host wants to send a new email, repeat from step 3 to step 6. AT+QIDEACT Con DEACT OK //Deactivate GPRS PDP context. GSM_SMTPS_Application_Note Confidential / Released 22 / 25 GSM/GPRS Module Series GSM SMTPS Application Note 4 Summary of Error Code The error code indicates an error related to mobile equipment or network. The detail about is described in the following table. Table 3: Summary of Error Codes errorcode -1 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 Meaning Unknown error l The SMTP service is busy. Such as, downloading body or attachment, sending email te Failed to get IP address according to domain name c l Network error. Such as, failed to activate GPRS/CSD context, failed to establish the TCP connection with the SMTP server or failed to send email to the SMTP server, etc. ue tia Unsupported authentication type The connection for the SMTP service is closed by peer Q en GPRS/CSD context is deactivated fid Timeout No recipient for the SMTP service n Failed to send email Co Failed to open file for attachment No enough memory for the attachment -14 Failed to save the attachment -15 The input parameter is wrong -421 Service not available, closing transmission channel -450 Requested mail action not taken: mailbox unavailable -451 Requested action aborted: local error in processing GSM_SMTPS_Application_Note Confidential / Released 23 / 25 GSM/GPRS Module Series GSM SMTPS Application Note -452 Requested action not taken: insufficient system storage -500 Syntax error, command unrecognized -501 Syntax error in parameters or arguments -502 Command not implemented -503 Bad sequence of commands -504 Command parameter not implemented -521 does not accept mail (see rfc1846) -530 -535 -550 -551 -552 -553 -554 Access denied Authentication failed l Requested action not taken: mailbox unavailable te User not local; please try c l Requested mail action aborted: exceeded storage allocation ue tia Requested action not taken: mailbox name not allowed CQonfiden Transaction failed GSM_SMTPS_Application_Note Confidential / Released 24 / 25 GSM/GPRS Module Series GSM SMTPS Application Note 5 Appendix A Reference Table 4: Related Documents SN Document name Remark Digital cellular telecommunications (Phase 2+); AT [1] GSM 07.07 [2] GSM 07.10 [3] GSM_SMTP_ATC_Vx.x tel [4] GSM_FILE_ATC_Vx.x command set for GSM Mobile Equipment (ME) Support GSM 07.10 multiplexing protocol SMTP document FILE document c l Table 5: Terms and Abbreviations ue tia Abbreviation Q n ME e TA Confid MS Description Mobile Equipment Terminal Adapter Mobile Station GSM_SMTPS_Application_Note Confidential / Released 25 / 25

GSM SSL 应用指导 GSM/GPRS/GNSS 模块系列 版本：GSM_SSL_应用指导_V1.0 日期：2020-04-01 状态：受控文件 www.quectel.com GSM SSL 应用指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2020，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2020. 上海移远通信技术股份有限公司 0 / 34 GSM SSL 应用指导 文档历史 修订记录 版本 1.0 日期 2020-04-01 作者 李家杨/ 林孝川 变更表述 初始版本 上海移远通信技术股份有限公司 1 / 34 GSM SSL 应用指导 目录 文档历史 ....................................................................................................................................................... 1 目录 .............................................................................................................................................................. 2 表格索引 ....................................................................................................................................................... 3 1 引言 ....................................................................................................................................................... 4 1.1. SSL 版本和加密套件 .................................................................................................................. 4 1.2. SSL 功能使用流程...................................................................................................................... 5 1.3. SSL 功能与普通 TCP/IP 会话共存 ............................................................................................. 6 2 SSL AT 命令详解 .................................................................................................................................. 7 2.1. AT 命令语句................................................................................................................................ 7 2.1.1. 定义 ................................................................................................................................. 7 2.1.2. AT 命令语句 .................................................................................................................... 7 2.2. AT 命令详解............................................................................................................................... 7 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 ....................................................................... 7 2.2.2. AT+QSSLOPEN 打开 SSL Socket 连接远程服务器................................................... 12 2.2.3. AT+QSSLSEND 通过 SSL 连接发送数据................................................................... 13 2.2.4. AT+QSSLRECV 通过 SSL 连接接收数据................................................................... 14 2.2.5. AT+QSSLCLOSE 关闭 SSL 连接 ............................................................................... 15 2.2.6. AT+QSSLSTATE 查询 Socket 连接状态..................................................................... 16 2.2.7. AT+QSECWRITE 添加证书或密钥............................................................................. 17 2.2.8. AT+QSECREAD 查询证书或密钥的校验和 ................................................................ 18 2.2.9. AT+QSECDEL 删除证书或密钥.................................................................................. 19 2.2.10. URC 说明....................................................................................................................... 20 2.2.10.1. 通知主机读取数据 .............................................................................................. 20 2.2.10.2. 通知断开连接...................................................................................................... 20 3 举例 ..................................................................................................................................................... 21 3.1. 加载证书和密钥到 RAM 的 SSL 连接....................................................................................... 21 3.2. 加载证书和密钥到 NVRAM 的 SSL 连接.................................................................................. 23 3.3. SSL 功能与普通 TCP/IP 功能共存的示例 ................................................................................ 25 3.4. SSL 功能透传模式示例............................................................................................................. 27 3.4.1. 无认证............................................................................................................................ 27 3.4.2. 服务器及客户端认证...................................................................................................... 29 4 错误处理 .............................................................................................................................................. 32 4.1. PDP 激活失败........................................................................................................................... 32 5 附录 A 参考文档和术语缩写 .............................................................................................................. 33 上海移远通信技术股份有限公司 2 / 34 GSM SSL 应用指导 表格索引 表 1：SSL 版本.................................................................................................................................................... 4 表 2：支持的 SSL 加密套件................................................................................................................................. 4 表 3：AT 命令及响应类型 .................................................................................................................................... 7 表 4：参考文档 .................................................................................................................................................. 33 表 5：术语缩写 .................................................................................................................................................. 33 上海移远通信技术股份有限公司 3 / 34 GSM SSL 应用指导 1 引言 本文档介绍如何使用移远通信 GSM 模块的 SSL 功能。 为确保通信的私密性，在某些情况下，服务器和客户端之间的通信应采用加密方式，以防止在通信过 程中数据被窃听、篡改或伪造。SSL 功能可以满足上述要求。 本文档适用于所有的移远通信 GSM 模块。 1.1. SSL 版本和加密套件 下表为支持的 SSL 版本。 表 1：SSL 版本 SSL 版本 SSL3.0 TLS1.0 TLS1.1 TLS1.2 下表为移远通信 GSM 模块支持的 SSL 加密套件。有关加密套件的详细说明，请参阅 RFC 2246-TLS 协议版本 1.0。 表 2：支持的 SSL 加密套件 加密套件代码 0X0035 0X0005 加密套件名称 TLS_RSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_RC4_128_SHA 上海移远通信技术股份有限公司 4 / 34 0X0004 0X000A 0X002F 0X003D TLS_RSA_WITH_RC4_128_MD5 TLS_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA256 GSM SSL 应用指导 1.2. SSL 功能使用流程 步 骤 1 ： 通 过 AT+QSECWRITE 导 入 证 书 和 密 钥 。 AT+QSECDEL 用 于 删 除 证 书 和 密 钥 ， AT+QSECREAD 用于检查证书和密钥的校验。 步 骤 2 ： 通 过 AT+QIFGCNT 和 AT+QICSGP 配 置 上 下 文 的 APN 、 用 户 名 和 密 码 。 并 通 过 AT+QIREGAPP 启动 TCP/IP 任务。 步骤 3：通过 AT+QIACT 激活 GPRS PDP 上下文。激活上下文后，通过 AT+QILOCIP 查询本地 IP 地 址。 步骤 4：通过 AT+QSSLCFG 配置 SSL 版本、加密套件、服务器认证、客户端认证、服务器根 CA 证 书、客户端证书和客户端密钥。 步骤 5：通过 AT+QSSLOPEN 建立 SSL 连接。如果连接成功，则响应'CONNECT' 或'+QSSLOPEN: ,'。 步骤 6：在非透传模式下，通过 AT+QSSLSEND 发送数据。如果模块从网络接收数据，将上报 URC '+QSSLURC: 'recv',,'，客户可以通过 AT+QSSLRECV 读取接收到的数据。 在透传模式下，数据的发送和接收直接从串行 COM 端口输入和输出。客户可以使用+++或 DTR 退出 数据模式并进入命令模式。如果连接异常，模块将自动退出数据模式。 步骤 7：数据传输完成后，通过 AT+QSSLCLOSE 关闭 SSL 连接。 步骤 8：通过 AT+QIDEACT 去激活 GPRS PDP 上下文。 上海移远通信技术股份有限公司 5 / 34 GSM SSL 应用指导 1.3. SSL 功能与普通 TCP/IP 会话共存 SSL 连接可以与普通 TCP 连接共存，表明客户可以同时建立一个或多个 SSL 和 TCP 正常连接。 在相同的场景上下文中，客户应使用不同的 socket 索引建立 SSL 和普通 TCP 连接。例如，客户可以 使用 socket 连接 1 建立普通的 TCP 连接，并使用 socket 连接 3 建立 SSL 连接。 以下步骤为 SSL 功能如何与普通 TCP 会话一起工作。 步骤 1：通过 AT+QIFGCNT 和 AT+QICSGP 配置上下文的 APN、用户名和密码。 步骤 2：通过 AT+QIMUX=1 启用多个 TCP/IP 会话。 步骤 3：通过 AT+QIREGAPP 启动 TCP/IP 任务。 步骤 4：通过 AT+QIACT 激活 GPRS PDP 上下文。激活上下文后，通过 AT+QILOCIP 查询本地 IP 地 址。 步骤 5：通过 AT+QINDI=1 配置以非透传 Buffer 模式处理接收的 TCP/IP 数据的方法。执行 AT+QIOPEN 建立普通的 TCP 连接，并将指定为 1。成功建立普通的 TCP 连接后，可以通过 AT+QISEND 发送数据并通过 AT+QIRD 接收数据。如果需要关闭连接，请执行 AT+QICLOSE。 步骤 6：通过 AT+QSSLOPEN 建立 SSL 连接，并将指定为 3。成功建立连接后，通过 AT+QSSLSEND 发送数据。当模块从对端接收到数据时，URC '+QSSLURC: 'recv',,'将通 知主机读取数据。主机可以执行 AT+QSSLRECV 来读取数据。数据传输完成后，通过 AT+QSSLCLOSE 关闭 SSL 连接。 步骤 7：通过 AT+QIDEACT 去激活 GPRS PDP 上下文。 备注 有关 AT 命令的详细信息，请参阅文档 [3]。 上海移远通信技术股份有限公司 6 / 34 GSM SSL 应用指导 2 SSL AT 命令详解 2.1. AT 命令语句 2.1.1. 定义     […]  下划线 回车符。 换行符。 参数名称。实际命令行中不包含尖括号。 可选参数或 TA 信息响应的可选部分。实际命令行中不包含方括号。若无特别说明， 配置命令中的可选参数被省略时，将默认使用其之前已设置的值或其默认值。 参数的默认设置。 2.1.2. AT 命令语句 前缀 AT 或 at 必须加在每个命令行的开头。输入 将终止命令行。通常，命令后面跟随形式为 的响应。在本文档中，仅显示响应 ，省略 。 表 3：AT 命令及响应类型 测试命令 查询命令 AT+=? AT+? 返回相应设置命令或内部程序可支持的参数取值 列表或范围。 返回相应设置命令的当前参数设置值。 设置命令 AT+=[,[,[...]]] 设置用户可自定义的参数值。 执行命令 AT+ 主动执行内部程序实现的功能集。 2.2. AT 命令详解 2.2.1. AT+QSSLCFG 配置 SSL 上下文的参数 该命令用于配置 SSL 版本、加密套件、安全级别、服务器根 CA 证书、客户端证书、客户端密钥、是 否忽略 RTC 时间、HTTP/HTTPS 和 SMTP/SMTPS。这些参数将在握手过程中使用。 上海移远通信技术股份有限公司 7 / 34 GSM SSL 应用指导 CTX 是 SSL（安全套接字层）上下文的缩写，而是 SSL 上下文的索引。移远通信 GSM 模 块最多支持 6 个 SSL 上下文。可以基于一个 SSL 上下文建立多个 SSL 连接。SSL 版本和加密套件的设置 存储在 SSL 上下文中，并将应用于与该 SSL 上下文关联的新 SSL 连接。 AT+QSSLCFG 配置 SSL 上下文的参数 测试命令 AT+QSSLCFG=? 响应 +QSSLCFG: 'type',(支持的范围),'value' 设置命令 查询上下文的设置： AT+QSSLCFG='ctxindex', OK 响应 +QSSLCFG: ,,,,,, 设置命令 为指定的 SSL 上下文配置 SSL 版本： AT+QSSLCFG='sslversion',[,] OK 或者 ERROR 响应 如果省略，则为指定的 SSL 上下文查询 SSL 版 本： +QSSLCFG: 'sslversion', OK 如果未省略，则为指定的 SSL 上下文设置 SSL 版本： OK 或者 ERROR 设置命令 响应 为指定的 SSL 上下文配置 SSL 加密套件： 如果省略，则为指定的 SSL 上下文查询 SSL AT+QSSLCFG='ciphersuite',[,] +QSSLCFG: 'ciphersuite', OK 如果未省略，则为指定的 SSL 上下文设置 SSL 加密套件： OK 或者 ERROR 设置命令 响应 为指定的 SSL 上下文配置身份验证模式： 如果省略，则为指定的 SSL 上下文查询身份验证模 AT+QSSLCFG='seclevel', 式： 上海移远通信技术股份有限公司 8 / 34 GSM SSL 应用指导 [,] +QSSLCFG: 'seclevel', OK 设置命令 为指定的 SSL 上下文配置受信任的服务 器根 CA 证书的路径： AT+QSSLCFG='cacert',[,< cacertname>] 如果未省略，则为指定的 SSL 上下文设置验证模 式： OK 或者 ERROR 响应 如果省略，则为指定的 SSL 上下文查询受信任 的服务器根 CA 证书的路径： +QSSLCFG: 'cacert', OK 设置命令 为指定的 SSL 上下文配置客户端证书的 路径： AT+QSSLCFG='clientcert',[,] 如果未省略，为指定的 SSL 上下文设置受信任 的服务器根 CA 证书的路径： OK 或者 ERROR 响应 如果省略，则为指定的 SSL 上下文查询客户 端证书的路径： +QSSLCFG: 'clientcert', OK 设置命令 为指定的 SSL 上下文配置客户端密钥的 路径： AT+QSSLCFG='clientkey',[,] 如果未省略，则为指定的 SSL 上下文设置客 户端证书的路径： OK 或者 ERROR 响应 如果省略，则为指定的 SSL 上下文查询客户 端密钥的路径： +QSSLCFG: 'clientkey', OK 如果未省略，则为指定的 SSL 上下文设置客 户端私钥的路径： OK 或者 上海移远通信技术股份有限公司 9 / 34 GSM SSL 应用指导 ERROR 设置命令 为指定的 SSL 上下文配置是否忽略 RTC 时间： AT+QSSLCFG='ignorertctime'[,] 响应 如果省略，则查询是否为指定的 SSL 上下文 忽略 RTC 时间： +QSSLCFG: 'ignorertctime', OK 设置命令 启用/禁用 HTTPS 功能： AT+QSSLCFG='https'[,] 如果未省略，则为指定的 SSL 上下文设置是 否忽略 RTC 时间： OK 或者 ERROR 响应 如果省略，查询是否启用/禁用 HTTPS 功能： +QSSLCFG: 'https', OK 设置命令 为 HTTPS 配置 SSL 上下文索引： AT+QSSLCFG='httpsctxi'[,] 如果未省略，设置是否启用/禁用 HTTPS 功能： OK 或者 ERROR 响应 如果省略，为 HTTPS 查询 SSL 上下文索引： +QSSLCFG: 'httpsctxi', OK 设置命令 配置 SMTP/SMTPS 的类型： AT+QSSLCFG='smtpstyle'[,] 如果未省略，则为 HTTPS 设置 SSL 上下文 索引： OK 或者 ERROR 响应 如果省略，则查询 SMTP/SMTPS 的类型： +QSSLCFG: 'smtpstyle', OK 如果未省略，则设置 SMTP/SMTPS 的类型： OK 或者 上海移远通信技术股份有限公司 10 / 34 GSM SSL 应用指导 ERROR 设置命令 为 SMTPS 配置 SSL 上下文索引： AT+QSSLCFG='smtpsctxi'[,] 响应 如果省略，为 SMTPS 查询 SSL 上下文索引： +QSSLCFG: 'smtpsctxi', OK 特性说明 如果未省略，则设置 SMTPS 的 SSL 上下文 索引： OK 或者 ERROR 该命令立即生效 参数配置不保存 参数 SSL 上下文索引。范围：0~5。 数字类型。SSL 版本。 0 SSL3.0 1 TLS1.0 2 TLS1.1 3 TLS1.2 4 所有 数字类型。SSL 加密套件。 0X0035 TLS_RSA_WITH_AES_256_CBC_SHA 0X002F TLS_RSA_WITH_AES_128_CBC_SHA 0X0005 TLS_RSA_WITH_RC4_128_SHA 0X0004 TLS_RSA_WITH_RC4_128_MD5 0X000A TLS_RSA_WITH_3DES_EDE_CBC_SHA 0X003D TLS_RSA_WITH_AES_256_CBC_SHA256 0XFFFF 所有 数字类型。认证模式。 0 无需认证 1 管理服务器认证 2 如果远程服务器要求，则管理服务器和客户端认证 字符串类型。受信任的服务器根 CA 证书的路径。 字符串类型。客户端证书路径。 字符串类型。客户端私钥的路径。 数字类型。配置是否忽略 RTC 时间。 0 不忽略 1 忽略 启用/禁用 HTTPS 功能。 上海移远通信技术股份有限公司 11 / 34 GSM SSL 应用指导 0 禁用 1 启用 HTTPS 的 SSL 上下文。 该参数是 SSL 上下文的索引。如果主机未对其进行配置，则其值为-1。范围：0~5。 SMTP/SMTPS 类型。 0 没有 SSL 1 SSL 2 STARTTLS SMTPS 的 SSL 上下文。 该参数是 SSL 上下文的索引。如果主机未对其进行配置，则其值为-1。范围：0~5。 备注 1. 、和的格式如下： 'RAM:filename' 文件已上传到 RAM 'NVRAM:filename' 文件已上传到 NVRAM，支持服务器根 CA 证书，一个客户端证书和一个客户 端私钥。服务器根 CA 证书的文件名必须为 CA0，客户端证书的文件名必须 为 CC0，客户端私钥的文件名必须为 CK0。 CA0 识别服务器根 CA 证书 CC0 识别客户证书 CK0 识别客户端密钥 2. 如果未设置认证，则不需要安全数据。如果已设置服务器认证，则需要配置服务器 CA 证书。如果已 设置服务器和客户端认证，则需要配置客户端证书、服务器 CA 证书和客户端私钥。 2.2.2. AT+QSSLOPEN 打开 SSL Socket 连接远程服务器 该命令用于打开 SSL socket 以连接远程服务器。在模块和对端协商期间，命令 AT+QSSLCFG 将用于 握手过程中的参数配置。与对端成功握手后，模块可以通过此 SSL 连接发送或接收数据。该模块还可以基 于一个 SSL 上下文建立多个 SSL 连接。 主机可以为命令 AT+QSSLOPEN 配置超时。如果在超时时间到期之前模块未完成建立 SSL 连接的操 作，则会上报 URC' +QSSLOPEN: ,'。如果主机未配置超时值，则默认的超时值 为 90 秒。 AT+QSSLOPEN 打开 SSL Socket 连接远程服务器 测试命令 AT+QSSLOPEN=? 响应 +QSSLOPEN: ,,, ,[,] 查询命令 AT+QSSLOPEN? OK 响应 OK 上海移远通信技术股份有限公司 12 / 34 GSM SSL 应用指导 设置命令 AT+QSSLOPEN=,,,,[,] 响应 如果是透传模式并且成功建立 SSL 连接： CONNECT 若有任何错误，响应： ERROR 如果不是透传模式： +QSSLOPEN: , 特性说明 如果未能成功建立 SSL 连接，并且的值不为 0： +QSSLOPEN: , 该命令立即生效 参数配置不保存 参数 数字类型。安全 socket 标识符。范围：0~5。 数字类型。SSL 上下文索引。范围：0~5。 字符串类型。SSL 服务器的 IP 地址或 URL。 远程服务器的端口。 SSL 连接的传输方式。 0 非透传模式 1 透传模式 超时时间。范围：10~300。默认值：90。单位：秒。 连接结果。 0 连接成功 -1 错误 -2 Socket 被占用 2.2.3. AT+QSSLSEND 通过 SSL 连接发送数据 建立 SSL 连接后，模块可以通过该连接发送数据。如果成功发送数据，模块将返回 SEND OK。如果 发送数据的过程被阻止，则模块将返回 SEND FAIL。如果发生其他错误，模块将返回 ERROR。 当接收到 SEND FAIL 时，主机应该延迟一些时间来发送数据。主机收到 ERROR 时，应重新建立 SSL 连接。 AT+QSSLSEND 通过 SSL 连接发送数据 测试命令 AT+QSSLSEND=? 响应 +QSSLSEND: (支持的范围)[,(支持的范围)] OK 上海移远通信技术股份有限公司 13 / 34 GSM SSL 应用指导 查询命令 AT+QSSLSEND? 设置命令 AT+QSSLSEND=[,] 响应>后，输入要发送的数据。点击 CTRL+Z 发送，点击 ESC 取消操作。 响应 OK 响应 > 如果已建立 SSL 连接并且数据发送成功： SEND OK 如果发送数据的过程被阻止： SEND FAIL 特性说明 如果 SSL 连接未建立、断开或发生其他错误： ERROR 该命令立即生效 参数配置不保存 参数 数字类型。安全 socket 标识符。范围：0~5。 数字类型。指示发送数据的长度。范围：1~1460。 2.2.4. AT+QSSLRECV 通过 SSL 连接接收数据 当模块从对等主机接收数据时，可以从缓冲区读取数据。接收到数据后，模块将对其进行缓冲并上报+ QSSLURC: 'recv',, 以通知主机。然后，对等主机可以通过 AT+QSSLRECV 接收数据。 AT+QSSLRECV 通过 SSL 连接接收数据 测试命令 AT+QSSLRECV=? 响应 +QSSLRECV: (支持的范围),(支持的范围),(支持 的范围) 设置命令 AT+QSSLRECV=,, OK 响应 如果已通过指定的连接接收数据： +QSSLRECV: :,TCP, OK 如果缓冲区为空： 上海移远通信技术股份有限公司 14 / 34 特性说明 参数 OK 若发生任何错误： ERROR 该命令立即生效 参数配置不保存 GSM SSL 应用指导 数字类型。场景下文号。范围：0~1。 数字类型。安全 socket 标识符。范围：0~5。 数字类型。要读取的最大数据长度。范围：1~1500。 IP 地址。 远程服务器的端口。 通过 AT+QSSLRECV 获得的实际数据长度。 备注 如果缓冲区不为空，并且模块再次接收数据，则在命令 AT+QSSLRECV 已从缓冲区读取所有接收到的数 据之前，将不会上报 URC '+QSSLURC: 'recv',,'。 2.2.5. AT+QSSLCLOSE 关闭 SSL 连接 该命令用于关闭 SSL 连接。如果基于同一 SSL 上下文的所有 SSL 连接都已关闭，则模块将释放 SSL 上下文。 AT+QSSLCLOSE 关闭 SSL 连接 测试命令 AT+QSSLCLOSE=? 响应 +QSSLCLOSE: (支持的的范围)[,(0,1)] 查询命令 AT+QSSLCLOSE? 设置命令 AT+QSSLCLOSE= OK 响应 OK 响应 如果 SSL 连接成功关闭： CLOSE OK 特性说明 若发生任何错误： ERROR 该命令实际是否生效取决于网络 参数配置不保存 上海移远通信技术股份有限公司 15 / 34 参数 数字类型。安全 socket 标识符。范围：0~5。 GSM SSL 应用指导 2.2.6. AT+QSSLSTATE 查询 Socket 连接状态 该命令用于查询 socket 连接状态。不仅可以查询 SSL 连接的状态，还可以查询普通 TCP/UDP 连接状 态。 AT+QSSLSTATE 查询 Socket 连接状态 测试命令 AT+QSSLSTATE=? 查询命令 AT+QSSLSTATE? 设置命令 AT+QSSLSTATE 响应 OK 响应 OK 响应 如果成功查询 socket 连接状态，响应： +QSSLSTATE: +QSSLSTATE: ,,,,, … OK 若发生任何错误： ERROR 参数 字符串参数。表示连接状态。 'IP INITIAL' TCP/IP 堆栈处于空闲状态 。 'IP START' TCP/IP 堆栈已注册。 'IP CONFIG' 模块已启动以激活 GPRS / CSD 上下文。 'IP IND' 正在激活 GPRS/CSD 上下文。 'IP GPRSACT' GPRS/CSD 上下文已成功激活。 'IP STATUS' 本地 IP 地址已通过 AT+QILOCIP 获得。 'IP PROCESSING' 建立连接。 'PDP DEACT' 由于未知原因，GPRS/CSD 上下文已去激活。 数字类型。Socket 索引。范围：0~5。 连接类型。 'TCP' 'UDP' IP 地址。 上海移远通信技术股份有限公司 16 / 34 端口号。 Socket 状态。 'INITIAL' 'CONNECTING' 'CONNECTED' 'REMOTE CLOSING' 'CLOSING' 'CLOSED' 判断连接是正常的 TCP/UDP 还是 TCP SSL。 0 正常 TCP/UDP 连接 1 TCP SSL 连接 GSM SSL 应用指导 2.2.7. AT+QSECWRITE 添加证书或密钥 该命令用于将用户证书、用户密钥或服务器根 CA 证书添加到 RAM 或 NVRAM。证书和密钥将以加密 方式存储在这些存储器中。将证书和密钥存储在这些存储器中之后，主机将无法从这些存储器中读取数据， 而只能查询数据校验和。请注意，证书或密钥在添加到 RAM 或 NVRAM 中之前，不应存在于相应的存储器 中；如果已经存在，请将其删除，然后将其添加到相应的存储器中。 AT+QSECWRITE 添加证书和密钥 测试命令 AT+QSECWRITE=? 响应 +QSECWRITE: ,[,(支持)的 范围] 查询命令 AT+QSECWRITE? 设置命令 AT+QSECWRITE=, [,] OK 响应 OK 响应 如果 AT 命令格式正确： CONNECT 模块切换到数据模式后，可以输入证书或密钥数据。当输入数 据的大小达到（单位：字节）或模块从 UART 接收 到+++序列时，模块将返回命令模式并响应以下代码。 +QSECWRITE: , OK 特性说明 若发生任何错误： +CME ERROR: 该命令立即生效 参数配置不保存 上海移远通信技术股份有限公司 17 / 34 GSM SSL 应用指导 参数 要存储的文件名，格式如下： 'RAM:filename' 文件已上传到 RAM 'NVRAM:filename' 文件已上传到 NVRAM。支持服务器根 CA 证书，一个客户端证 书和一个客户端私钥。服务器根 CA 证书的文件名必须为 CA0， 客户端证书的文件名必须为 CC0，客户端私钥的文件名必须为 CK0。 CA0 识别服务器根 CA 证书 CC0 识别客户证书 CK0 识别客户端密钥 要上传的文件大小。单位：字节。 如果文件上传到 RAM，最大为 32768 字节，如果文件上传到 NVRAM，最大为 2017 字 节，最小为 1 字节。 等待从 UART 输入数据的时间（单位：秒）。范围：3~200。默认值：100。单位：秒。 实际上传数据的大小。单位：字节。 文件的校验码。 2.2.8. AT+QSECREAD 查询证书或密钥的校验和 该命令用于查询证书或密钥的校验和。如果校验和与用户拥有的原始校验和不同，则会发生错误。 AT+QSECREAD 查询证书或密钥的校验和 测试命令 AT+QSECREAD=? 响应 +QSECREAD: 设置命令 AT+QSECREAD= OK 响应 +QSECREAD: , 特性说明 OK 若发生任何错误： +CME ERROR: 该命令立即生效 参数配置不保存 参数 要存储的文件名。格式如下： 'RAM:filename' 查询 RAM 中存储的文件的校验和 'NVRAM:filename' 查询 NVRAM 中存储的文件的校验和。支持服务器根 CA 证书，一个 客户端证书和一个客户端私钥。服务器根 CA 证书的文件名必须为 上海移远通信技术股份有限公司 18 / 34 GSM SSL 应用指导 CA0，客户端证书的文件名必须为 CC0，客户端私钥的文件名必须为 CK0。 CA0 识别服务器根 CA 证书 CC0 识别客户证书 CK0 识别客户端密钥 表示证书或密钥是否正确。通过 AT+QSECWRITE 上传证书或密钥时，将同时存储证书或 密钥的校验和。执行命令 AT+QSECREAD 后，将再次计算证书或密钥的校验和。然后将 此校验和与 AT+QSECWRITE 存储的校验和进行比较。如果相同，则证书或密钥正确，否 则错误。 0 证书或密钥错误 1 证书或密钥正确 文件的校验码。 2.2.9. AT+QSECDEL 删除证书或密钥 该命令用于删除证书或密钥。 AT+QSECDEL 删除证书或密钥 测试命令 AT+QSECDEL=? 响应 +QSECDEL: 设置命令 AT+QSECDEL= OK 响应 OK 特性说明 若发生任何错误： +CME ERROR: 该命令立即生效 参数配置不保存 参数 要存储的文件名。格式如下： 'RAM:filename' 删除存储在 RAM 中的证书或密钥 'NVRAM:filename' 删除存储在 NVRAM 中的证书或密钥。支持服务器根 CA 证书，一个 客户端证书和一个客户端私钥。服务器根 CA 证书的文件名必须为 CA0，客户端证书的文件名必须为 CC0，客户端私钥的文件名必须为 CK0。 CA0 识别服务器根 CA 证书 CC0 识别客户证书 CK0 识别客户端密钥 上海移远通信技术股份有限公司 19 / 34 GSM SSL 应用指导 2.2.10. URC 说明 SSL URC 的格式为+ QSSLURC:，主要用于通知主机读取已接收的数据或断开连接。 2.2.10.1. 通知主机读取数据 该 URC 用于通知主机从对端读取数据。 通知主机读取数据 +QSSLURC: 'recv',, 这是通知主机读取 SSL 数据的 URC 参数 数字类型。场景上下文编号。范围：0~1。 数字类型。安全 socket 标识符。范围：0~5。 备注 1. 模块具有一个 socket 缓冲区，用于存储接收到的数据。模块从对端接收到数据时，会将数据放入 socket 缓冲区。仅在 socket 缓冲区为空且来自对端的数据到达的情况下，模块才会上报 URC + QSSLURC: 'recv',,以通知主机读取。主机可以使用命令 AT+QSSLRECV 读取数据。当 socket 缓冲区不为空且数据到达时，模块将不会上报 URC。 2. 命令 AT+QSSLRECV=,,用于从模块的 socket 缓冲区读取数据。读取的最大长 度为 1500 字节。如果缓冲区中的数据长度小于 1500 字节，则该命令将读取所有数据。 2.2.10.2. 通知断开连接 该 URC 用于通知主机连接已断开。断开连接可能由多种原因引起，例如对端关闭连接或 GPRS PDP 被去激活。如果上报此 URC，则模块将自动关闭 SSL 连接，并且主机不需要执行命令 AT+QSSLCLOSE 即可关闭 SSL 连接。 通知断开连接 +QSSLURC: 'closed', 基于指定 socket 的 SSL 连接已关闭。 参数 数字类型。安全 socket 标识符。范围：0~5。 上海移远通信技术股份有限公司 20 / 34 GSM SSL 应用指导 3 举例 3.1. 加载证书和密钥到 RAM 的 SSL 连接 这是有关服务器验证和客户端验证的示例，且证书和密钥存储在 RAM 中。说明如何建立 SSL 连接以 及如何实现模块与服务器之间的数据发送和接收。 //步骤 1：将证书和密钥上传到 RAM。 AT+QSECWRITE='RAM:ca_cert.pem',1614,100 //将服务器根 CA 证书上传到 RAM。 CONNECT +QSECWRITE: 1614,4039 OK AT+QSECWRITE='RAM:client_cert.pem',1419,100 //将客户端证书上传到 RAM。 CONNECT +QSECWRITE: 1419,618 OK AT+QSECWRITE='RAM:client_key.pem',1679,100 //将客户端私钥上传到 RAM。 CONNECT +QSECWRITE: 1679,83a7 OK //步骤 2：配置并激活 PDP 上下文。 AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' OK AT+QIREGAPP OK AT+QIACT OK //将上下文 0 设置为场景上下文。 //将承载类型设置为 GPRS，将 APN 设置为 'CMNET'，其中没有用户名和密码。 //注册到 TCP/IP 堆栈。 //激活 GPRS PDP 上下文。 上海移远通信技术股份有限公司 21 / 34 GSM SSL 应用指导 AT+QILOCIP //查询本地 IP 地址 10.1.83.188 //步骤 3：配置 SSL 版本、加密套件、服务器身份验证和客户端身份验证。证书和私钥在 RAM 中。 AT+QSSLCFG='ignorertctime',1 //忽略 RTC 时间。 OK AT+QSSLCFG='sslversion',0,4 //配置 SSL 版本。 OK AT+QSSLCFG='ciphersuite',0,'0XFFFF' //配置加密套件。 OK AT+QSSLCFG='seclevel',0,2 //配置服务器认证和客户端认证。 OK AT+QSECREAD='RAM:ca_cert.pem' //检查 CA 证书是否正确。 +QSECREAD: 1,4039 OK AT+QSECREAD='RAM:client_cert.pem' +QSECREAD: 1,618 //检查客户端证书是否正确。 OK AT+QSECREAD='RAM:client_key.pem' +QSECREAD: 1,83a7 //检查客户端私钥是否正确。 OK AT+QSSLCFG='cacert',0,'RAM:ca_cert.pem' //配置 CA 证书。 OK AT+QSSLCFG='clientcert',0,'RAM:client_cert.pem' //配置客户端证书。 OK AT+QSSLCFG='clientkey',0,'RAM:client_key.pem' //配置客户端密钥。 O //步骤 4：建立 SSL 连接，发送和接收数据。 AT+QSSLOPEN=1,0,'116.247.104.27',465,0 OK +QSSLOPEN: 1,0 AT+QSSLSEND=1,12 > SEND OK AT+QSSLSEND=1 > , SEND OK //建立 socket 连接为 1 的 SSL 连接。连接基于上 下文 0，并且是非透传模式。 //成功建立 SSL 连接。 //以固定长度发送 12 个字节的数据。 //以小于 1460 的任何字节发送数据。 //完成数据输入后，点击 CTRL+Z 进行发送。 +QSSLURC: 'recv',0,1 //通知主机以从服务器获取数据。 上海移远通信技术股份有限公司 22 / 34 GSM SSL 应用指导 AT+QSSLRECV=0,1,1500 +QSSLRECV: 116.247.104.27:465,TCP,7 1234567 //读取数据并将数据输出到 UART。 OK //步骤 5：关闭 SSL 连接，从 RAM 中删除证书和密钥。 AT+QSSLCLOSE=1 //关闭 socket 连接 1。 CLOSE OK AT+QSECDEL='RAM:ca_cert.pem' OK AT+QSECDEL='RAM:client_cert.pem' OK AT+QSECDEL='RAM:client_key.pem' OK AT+QIDEACT //去激活 GPRS PDP 上下文。 DEACT OK 3.2. 加载证书和密钥到 NVRAM 的 SSL 连接 这是有关服务器认证和客户端认证的示例，证书和密钥存储在 NVRAM 中。说明如何建立 SSL 连接， 如何实现模块与服务器之间的数据发送和接收。 //步骤 1：将证书和密钥上传到 NVRAM。 AT+QSECWRITE='NVRAM:CA0',1614,100 CONNECT +QSECWRITE: 1614,4039 //将服务器根 CA 证书上传到 NVRAM。 OK AT+QSECWRITE='NVRAM:CC0',1419,100 CONNECT +QSECWRITE: 1419,618 //将客户端证书上传到 NVRAM。 OK AT+QSECWRITE='NVRAM:CK0',1679,100 CONNECT +QSECWRITE: 1679,83a7 //将客户端私钥上传到 NVRAM。 OK 上海移远通信技术股份有限公司 23 / 34 GSM SSL 应用指导 //步骤 2：配置并激活 PDP 上下文。 AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' OK AT+QIREGAPP OK AT+QIACT OK AT+QILOCIP 10.1.83.188 //将上下文 0 设置为场景上下文。 //将承载类型设置为 GPRS，将 APN 设置为 'CMNET'，该名称没有用户名和密码。 //注册到 TCP/IP 堆栈。 //激活 GPRS PDP 上下文。 //查询本地 IP 地址。 //步骤 3：配置 SSL 版本、加密套件、服务器身份验证和客户端身份验证。证书和私钥在 NVRAM 中。 AT+QSSLCFG='ignorertctime',1 //忽略 RTC 时间。 OK AT+QSSLCFG='sslversion',0,4 //配置 SSL 版本。 OK AT+QSSLCFG='ciphersuite',0,'0XFFFF' //配置加密套件。 OK AT+QSSLCFG='seclevel',0,2 //配置服务器身份验证和客户端身份验证。 OK AT+QSECREAD='NVRAM:CA0' //检查服务器根 CA 证书是否正确。 +QSECREAD: 1,4039 OK AT+QSECREAD='NVRAM:CC0' +QSECREAD: 1,618 //检查客户端证书是否正确。 OK AT+QSECREAD='NVRAM:CK0' +QSECREAD: 1,83a7 //检查客户端私钥是否正确。 OK AT+QSSLCFG='cacert',0,'NVRAM:CA0' OK AT+QSSLCFG='clientcert',0,'NVRAM:CC0' OK AT+QSSLCFG='clientkey',0, 'NVRAM:CK0' OK //配置服务器根 CA 证书。 //配置客户端证书。 //配置客户端密钥。 //步骤 4：建立 SSL 连接，发送和接收数据。 AT+QSSLOPEN =1,0,'116.247.104.27',465,0 //建立 socket 连接为 1 的 SSL 连接。连接基于上下文 上海移远通信技术股份有限公司 24 / 34 OK +QSSLOPEN: 1,0 AT+QSSLSEND=1,12 > SEND OK AT+QSSLSEND=1 > , SEND OK +QSSLURC: 'recv',0,1 AT+QSSLRECV=0,1,1500 +QSSLRECV: 116.247.104.27:465,TCP,7 1234567 OK //步骤 5：关闭 SSL 连接。 AT+QSSLCLOSE=1 CLOSE OK AT+QIDEACT DEACT OK 0,并且为非透传模式。 GSM SSL 应用指导 //成功建立 SSL 连接。 //以固定长度发送 12 个字节的数据。 //以小于 1460 的任何字节发送数据。 //完成数据输入后，点击 CTRL+Z 发送数据。 //通知主机从服务器获取数据。 //读取数据并将数据输出到 UART。 //关闭 socket 连接 1。 //去激活 GPRS PDP 上下文。 3.3. SSL 功能与普通 TCP/IP 功能共存的示例 //步骤 1：配置并激活 PDP 上下文。 AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' OK AT+QIMUX=1 OK AT+QIREGAPP OK AT+QIACT OK AT+QILOCIP 10.1.83.188 //将上下文 0 设置为场景上下文。 //将承载类型设置为 GPRS，将 APN 设置为'CMNET'，其中没 有用户名和密码。 //启用多个 TCP/IP 会话。 //注册到 TCP/IP 堆栈。 //激活 GPRS PDP 上下文。 //查询本地 IP 地址。 //步骤 3：建立正常的 TCP 连接，发送和接收数据。 AT+QINDI=1 //设置处理接收到的 TCP/IP 数据的方法。通过 UART 输出通知语 上海移远通信技术股份有限公司 25 / 34 GSM SSL 应用指导 句+QIRDI: ,,，以通知主机读取接收的 TCP /IP 数据。 OK AT+QIOPEN=1,'TCP','116.247.104.27',6021 //建立正常的 TCP 连接，并将 socket 连接指定为 1。 OK 1, CONNECT OK AT+QISEND=1,10 > SEND OK //成功建立正常的 TCP 连接。 //以固定长度发送 10 个字节的数据。 +QIRDI: 0,1,1 AT+QIRD=0,1,1,1024 +QIRD: 116.247.104.27:6021,TCP,10 ABCDE12345 OK //模块基于代理客户端的上下文 0 接收数据，并且 socket 连接为 1。 //从模块的 socket 缓冲区读取数据。 //要接收的最大长度为 1024。如果缓冲区中的数据长度小 于 1024，请从缓冲区中接收所有数据。 //步骤 3：配置 SSL 版本、加密套件和无身份验证模式，建立 SSL 连接、发送和接收数据。 AT+QSSLCFG='sslversion',0,4 //配置 SSL 版本。 OK AT+QSSLCFG='seclevel',0,0 //配置服务器身份验证和客户端身份验证。 OK AT+QSSLCFG='ciphersuite',0,'0XFFFF' //配置加密套件。 OK AT+QSSLOPEN=3,0,'124.74.41.170',5115,0 //建立 SSL 连接，socket 连接为 3，并且连接基于上下文 0。 OK +QSSLOPEN: 3,0 AT+QSSLSEND=3,12 > SEND OK AT+QSSLSEND=3 > , //成功建立 SSL 连接。 //以固定长度的方式发送 12 个字节的数据。 //输入数据完成后，点击 CTRL+Z 发送数据。 SEND OK +QSSLURC: 'recv',0,3 AT+QSSLRECV=0,3,1000 +QSSLRECV: 124.74.41.170:5115,TCP,7 上海移远通信技术股份有限公司 //通知主机从服务器获取数据的 URC。 //读取数据并将数据输出到 UART。 26 / 34 1234567 OK //步骤 4：关闭正常的 TCP 和 SSL 连接。 AT+QSSLCLOSE=3 CLOSE OK AT+QICLOSE=1 1,CLOSE OK AT+QIDEACT DEACT OK GSM SSL 应用指导 //关闭 SSL 连接，socket 连接为 3。 //关闭普通的 TCP 连接，socket 连接为 1。 //去激活 GPRS PDP 上下文。 3.4. SSL 功能透传模式示例 3.4.1. 无认证 //步骤 1：配置并激活 PDP 上下文。 AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' OK AT+QIREGAPP OK AT+QIACT OK AT+QILOCIP 10.1.83.188 //将上下文 0 设置为前景上下文。 //将承载类型设置为 GPRS，将 APN 设置为'CMNET'， 该名称没有用户名和密码。 //注册到 TCP/IP 堆栈。 //激活 GPRS PDP 上下文。 //查询本地 IP 地址。 //步骤 2：配置 SSL 版本，加密套件和无身份验证模式，建立 SSL 连接、发送和接收数据。 AT+QSSLCFG='sslversion',0,4 //配置 SSL 版本。 OK AT+QSSLCFG='seclevel',0,0 //配置服务器身份验证和客户端身份验证。 OK AT+QSSLCFG='ciphersuite',0,'0XFFFF' //配置加密套件。 OK AT+QSSLOPEN=1,0,'220.180.239.212',8011,1 //建立套接字连接为 1 的 SSL 连接，该连接基于上下 文 0，并且是透传模式。 OK CONNECT GET /processorder.php HTTP/1.1 //成功建立 SSL 连接。 //输入数据。 上海移远通信技术股份有限公司 27 / 34 GSM SSL 应用指导 HOST: 220.180.239.201:8011 Accept: */* User-Agent: QUECTEL_MODULE CONNECT: KEEP-ALIVE //完成数据输入。 HTTP/1.1 200 OK //SSL 服务器将数据响应到模块。 Date: Wed, 07 Sep 2016 08:37:27 GMT Server: Apache/2.4.4 (Win32) OpenSSL/1.0.1e PHP/5.5.33 X-Powered-By: PHP/5.5.33 Content-Length: 264 Content-Type: text/html Quectel's Auto Parts - Order Results Quectel's Auto Parts Order Results Order processed at Your order is as follows: message apple orange //服务器完成发送数据。 //步骤 3：退出或进入透传模式。 +++ OK //输入+++。 //响应 OK。 ATO CONNECT //进入透传模式。 //步骤 4：关闭 SSL 连接。 +++ OK //输入+++。 //响应 OK。 AT+QSSLCLOSE=1 CLOSE OK AT+QIDEACT DEACT OK //关闭 SSL 连接，socket 连接为 1。 //去激活 GPRS PDP 上下文。 上海移远通信技术股份有限公司 28 / 34 GSM SSL 应用指导 3.4.2. 服务器及客户端认证 AT+QSECWRITE='RAM:ca_cert.pem',1614,100 //将服务器根 CA 证书上传到 RAM。 CONNECT +QSECWRITE: 1614,4039 OK AT+QSECWRITE='RAM:client_cert.pem',1419,100 //将客户端证书上传到 RAM。 CONNECT +QSECWRITE: 1419,618 OK AT+QSECWRITE='RAM:client_key.pem',1679,100 //将客户端私钥上传到 RAM。 CONNECT +QSECWRITE: 1679,83a7 OK //步骤 2: 配置和激活 PDP 上下文。 AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' OK AT+QIREGAPP OK AT+QIACT OK AT+QILOCIP 100.119.144.3 //将上下文 0 设置为场景上下文。 //将承载类型设置为 GPRS，将 APN 设置为 CMNET，其中没有用户名和密码。 //注册到 TCP/IP 堆栈。 //激活 GPRS PDP 上下文。 //查询本地 IP 地址。 //步骤 3: 配置 SSL 版本，加密套件，服务器身份验证和客户端身份验证，证书和私钥在 RAM 中。 AT+QSSLCFG='ignorertctime',1 //忽略 RTC 时间。 OK AT+QSSLCFG='sslversion',0,4 //配置 SSL 版本。 OK AT+QSSLCFG='ciphersuite',0,'0XFFFF' //加密套件。 OK AT+QSSLCFG='seclevel',0,2 //配置服务器身份验证和客户端身份验证。 OK 上海移远通信技术股份有限公司 29 / 34 GSM SSL 应用指导 AT+QSECREAD='RAM:ca_cert.pem' +QSECREAD: 1,4039 //检查 CA 证书是否正确。 OK AT+QSECREAD='RAM:client_cert.pem' +QSECREAD: 1,618 //检查客户端证书是否正确。 OK AT+QSECREAD='RAM:client_key.pem' +QSECREAD: 1,83a7 //检查客户端私钥是否正确 OK AT+QSSLCFG='cacert',0,'RAM:ca_cert.pem' //配置服务器根 CA 证书。 OK AT+QSSLCFG='clientcert',0,'RAM:client_cert.pem' //配置客户端证书。 OK AT+QSSLCFG='clientkey',0,'RAM:client_key.pem' //配置客户端密钥。 OK //步骤 4：建立 SSL 连接，发送数据和接收数据 AT+QSSLOPEN =1,0,'220.180.239.212',8011,1 OK //建立 socket 连接索引为 1 的 SSL 连接。该连接 基于上下文 0，并且是透传模式。 CONNECT GET /processorder.php HTTP/1.1 HOST: 220.180.239.201:8011 Accept: */* User-Agent: QUECTEL_MODULE CONNECT: KEEP-ALIVE //成功建立 SSL 连接。 //输入数据。 //完成数据输入。 HTTP/1.1 200 OK //SSL 服务器将数据响应到模块。 Date: Wed, 07 Sep 2016 08:37:27 GMT Server: Apache/2.4.4 (Win32) OpenSSL/1.0.1e PHP/5.5.33 X-Powered-By: PHP/5.5.33 Content-Length: 264 Content-Type: text/html Quectel's Auto Parts - Order Results 上海移远通信技术股份有限公司 30 / 34 GSM SSL 应用指导 Quectel's Auto Parts Order Results Order processed at Your order is as follows: messageapple orange //服务器完成发送数据。 //步骤 6：退出或进入透传模式。 +++ OK //输入+++。 //响应 OK。 ATO CONNECT //进入透传模式。 //步骤 6：关闭 SSL 连接。 +++ OK //输入+++。 //响应 OK。 AT+QSSLCLOSE=1 CLOSE OK AT+QIDEACT DEACT OK //关闭 SSL 连接，socket 连接为 1。 //去激活 GPRS PDP 上下文。 上海移远通信技术股份有限公司 31 / 34 GSM SSL 应用指导 4 错误处理 4.1. PDP 激活失败 如果 AT+QIACT 无法激活 PDP 上下文，请从以下方面进行检查： 1. 通过 AT+CGATT?查询 PS 域是否已附着。如果没有，执行 AT+CGATT=1 附着 PS 域。 2. 通过 AT+CGREG?查询 AT+CGREG 状态并确保 PS 域已注册。 3. 通过 AT+QIREGAPP 查询 PDP 上下文参数，并确保设置了指定 PDP 上下文的 APN。 4. 确保指定的 PDP 上下文 ID 既不被 PPP 使用，也不被 AT+CGACT 激活。 如果检查结果正确，但是执行 AT+QIACT 的结果始终失败，请重新启动模块以解决此问题。重新启动 模块后，至少检查上述步骤 3 次，间隔为 10 分钟，以免频繁重新启动模块。 上海移远通信技术股份有限公司 32 / 34 GSM SSL 应用指导 5 附录 A 参考文档和术语缩写 表 4：参考文档 序号 文件名 [1] GSM 07.07 [2] GSM 07.10 [3] Quectel_Mxx/MCxx_AT_命令手册 [4] Quectel_GSM_TCP/IP_应用指导 备注 数字蜂窝电信（阶段 2+），GSM 移动设备（ME） 的 AT 命令集 支持 GSM 07.10 复用协议 GSM 模块的 AT 命令手册 GSM 模块的 TCP/IP 应用指导 表 5：术语缩写 缩写 CTX GSM ME MS NVRAM ID IP PDP PPP RAM SSL 英文全称 SSL Context Global System for Mobile Communications Mobile Equipment Mobile Station Non-Volatile Random Access Memory Identification Internet Protocol Packet Data Protocol Point-to-Point Protocol Random Access Memory Security Socket Layer 中文全称 SSL 上下文 全球移动通信系统 移动设备 移动站 非易失性随机访问存储器 ID 互联网协议 分组数据协议 点对点协议 随机存取存储器 安全套接层 上海移远通信技术股份有限公司 33 / 34 TA TCP URC Terminal Adapter Transmission Control Protocol Unsolicited Result Code GSM SSL 应用指导 终端适配器 传输控制协议 未经请求的结果代码 上海移远通信技术股份有限公司 34 / 34

蓝牙天线 应用指导 GSM/GPRS 系列 版本：蓝牙天线_应用指导_V1.1 日期：2015-04-11 www.quectel.com 蓝牙天线 应用指导 移远公司始终以为客户提供最及时、最全面的服务为宗旨，如需任何帮助，请随时联系我司上海总部，联 系方式如下： 上海移远通信技术有限公司 上海市徐汇区田州路 99 号 13 幢 501 室 邮箱: info@quectel.com 电话: +86 21 51086236 或联系我司当地办事处，详情请登录： http://www.quectel.com/support/salesupport.aspx 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/support/techsupport.aspx Or Email: Support@quectel.com l 前言 te 移远公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规范，参数来设计其产品。 c l 由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未声明前，移远公司有权对 该文档规范进行更新。 ue tia 版权申明 本文档手册版权属于移远公司，任何人未经我公司复制转载该文档将承担法律责任。 Q en 版权所有 ©上海移远通信技术有限公司 2015，保留一切权利。 Confid Copyright © Quectel Wireless Solutions Co., Ltd. 2015. 上海移远通信技术有限公司 1 / 14 蓝牙天线 应用指导 文档历史 修订记录 版本 1.0 1.1 日期 2014-12-17 CQouneficdteenl tial 2015-04-11 作者 周雨 周雨 变更表述 初始版本 增加适用模块说明 上海移远通信技术有限公司 2 / 14 蓝牙天线 应用指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 图片索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 2 陶瓷（Chip）天线 ................................................................................................................................. 6 3 倒 F 型天线............................................................................................................................................. 8 4 曲流型天线 ........................................................................................................................................... 10 5 6 2.4G 棒状天线 ...................................................................................................................................... 12 CQouneficdteenl tial 附录 ...................................................................................................................................................... 14 上海移远通信技术有限公司 3 / 14 蓝牙天线 应用指导 图片索引 图 1：推荐 PCB 走线设计.................................................................................................................................... 6 图 2：PCB 走线 PAD 尺寸参数............................................................................................................................ 7 图 3：INPAQ 5036 CHIP 天线在 M26 TE-A 上实物图......................................................................................... 7 图 4：倒 F 型天线 PCB 设计图 ............................................................................................................................ 8 图 5：对应尺寸参数 ............................................................................................................................................. 8 图 6：天线实际 PCB 图 ....................................................................................................................................... 9 图 7：典型曲流型天线应用设计参数.................................................................................................................. 10 图 8：曲流型天线在 PCB 中制作成板载天线的应用示范....................................................................................11 图 9：2.4G 棒状天线（SMA 接口） .................................................................................................................. 12 图 10：2.4G 小铜管天线（IPX 座） .................................................................................................................. 12 CQouneficdteenl tial 上海移远通信技术有限公司 4 / 14 蓝牙天线 应用指导 1 引言 目前常见的蓝牙天线有偶极天线（Dipole Antenna）、倒 F 型天线（Planar Inverted-F Antenna）、曲流 线型天线（Meander Line Antenna）、微小型陶瓷天线（Ceramic Antenna）、液晶聚合体天线（Liquid Crystal Polymer Antenna）和棒状天线（Rod Antenna，2.4G 频率专用）等。由于这些具有近似全向性的辐射场型 以及结构简单、制作成本低的优点，所以非常适合嵌入蓝牙技术装置使用。下面主要介绍常用的四种蓝牙 天线的设计方法。 CQouneficdteenl tial 本文档适用于QuectelM26模块。 上海移远通信技术有限公司 5 / 14 蓝牙天线 应用指导 2 陶瓷（Chip）天线 陶瓷天线是一种适合蓝牙装置使用的小型化天线。陶瓷天线虽然尺寸较小，但一般设计较为复杂，尤 其是封装及 PCB 设计，对周围地面积有一定要求，同时要考虑净空问题。各家 Chip 天线外形尺寸各不相 同，设计要求也大为不同，即使完全按照参考设计后，一般也需要精心调试以达到最佳性能。下面以 M26 TE-A 上所使用的 INPAQ 5036 chip 天线为例，参考设计见下图。 CQouneficdteenl tial 图 1：推荐 PCB 走线设计 上海移远通信技术有限公司 6 / 14 蓝牙天线 应用指导 备注 l 图 2：PCB 走线 Pad 尺寸参数 CQouneficdteential 图 3：INPAQ 5036 Chip 天线在 M26 TE-A 上实物图 INPAQ 5036 SPEC 参考文档 [1]，其他厂家陶瓷天线类似，需严格按照参考设计，并在投板后优化调试 天线匹配。 上海移远通信技术有限公司 7 / 14 蓝牙天线 应用指导 3 倒 F 型天线 倒 F 型天线是由于其结构与倒置的英文字母 F 相似而得名。由于倒 F 型天线只需要利用金属导体配合 适当的馈线及天线短路到接地面的位置，故其制作成本低，而且可以直接与 PCB 电路板焊接在一起，一体 化设计。 倒 F 型天线的天线体可以为线状或者片状，图 4 和图 5 给出了一种倒 F 型天线的 PCB 设计封装参数。 CQouneficdteenl tial 图4：倒F型天线PCB设计图 图 5：对应尺寸参数 图 4 中蓝牙天线接入点与模块 BT_ANT 引脚相连接，外轮廓 L 型短边接地，天线接入点介于地和天线 开放端之间。板载 F 型天线一般放在 PCB 顶层，铺地一般放在顶层并位于天线附近，但天线周围务必不能 放置地，周围应是净空区。图 6 给出了倒 F 型天线按照上述参数在 PCB 设计中制作成板载天线的应用示范。 上海移远通信技术有限公司 8 / 14 蓝牙天线 应用指导 图 6：天线实际 PCB 图 备注 CQouneficdteenl tial 以上倒F天线为TI官方文档所推荐，实际需做精心设计与天线匹配调试，详情见文档 [2]。 上海移远通信技术有限公司 9 / 14 蓝牙天线 应用指导 4 曲流型天线 曲流型天线一般是 PCB 封装，即板载天线。和倒 F 型一样一般放在 PCB 顶层，铺地一般放在顶层并 位于天线附近，但天线周围务必不能放置地，周围应是净空区。下图展示了典型曲流型天线其 PCB 封装尺 寸。 CQouneficdteenl tial 图 7：典型曲流型天线应用设计参数 上海移远通信技术有限公司 10 / 14 蓝牙天线 应用指导 图 8：曲流型天线在 PCB 中制作成板载天线的应用示范 备注 CQouneficdteenl tial 以上曲流型天线为TI官方文档所推荐，实际需做精心设计与天线匹配调试，详情见文档 [3] 上海移远通信技术有限公司 11 / 14 蓝牙天线 应用指导 5 2.4G 棒状天线 下图所示为 2.4G 棒状蓝牙天线，该天线体积大，但性能最强，传输距离要强于其他天线。图 10 为 IPX 插座的小铜管天线，较棒装天线体积小很多，性能稍弱。这两款天线应用最为简单，只需模块蓝牙射频输 出到射频接口走线控制为 50 欧姆即可，周围需为净空区，特别注意的是天线本体周围不能有金属物体遮挡。 这两种成品天线市面上大量存在，推荐采购知名天线厂家产品。 CQouneficdteenl tial 图9：2.4G棒状天线（SMA接口） 图 10：2.4G 小铜管天线（IPX 座） 上海移远通信技术有限公司 12 / 14 蓝牙天线 应用指导 从产品应用角度来看，天线对于周围的金属十分敏感，像电路板上的接地面或者金属屏蔽罩都会严重 影响到天线辐射特性，若要确保蓝牙天线良好的工作特性以进一步提高蓝牙产品的传输质量，就必须要在 设计电路的时候就将蓝牙天线的设计以及产品使用环境一并考虑，这样才可以增强后期产品应用的可靠性 和稳定性。 CQouneficdteenl tial 上海移远通信技术有限公司 13 / 14 蓝牙天线 应用指导 6 附录 表 1：参考文档 序号 文件名 [1] ACA-5036-A2-CC-S Application Note [2] [3] DN007 2.4GHz Inverted F Antenna（swru120b.pdf） CQouneficdteenl tial AN043SmallSize2.4GHzPCBAntenna（swra117.pdf） 上海移远通信技术有限公司 14 / 14

GSM 无线通信模块 短消息应用指导 GSM模块短消息应用指导_V1.1 GSM 短消息应用指导 文档标题 版本 日期 状态 GSM 模块短消息应用指导_V1.0 1.1 2015-04-03 正式发布 版权： 版权所有 ©上海移远通信技术有限公司 2015。 保留一切权利。 Copyright © Quectel Wireless Solutions Co. Ltd. 2015 非经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部,并不得 CQouneficdteenl tial 以任何形式传播。 上海移远通信技术有限公司 -1- GSM 短消息应用指导 目录内容 目录内容 .................................................................................................................................................. 2 表格目录 .................................................................................................................................................. 4 0. 修改记录 ............................................................................................................................................. 5 1. 概要 ..................................................................................................................................................... 6 1.1. 参考.............................................................................................................................................. 6 1.2. 概述.............................................................................................................................................. 8 1.2.1. 1.2.2. 1.2.3. 1.2.4. 选择短消息模式 ........................................................................................... 8 选择 TE 字符集 （+CSCS） ........................................................................................ 9 设置短消息服务中心号码 （+CSCA）....................................................................... 9 选择短消息优先存储器 （+CPMS） ........................................................................ 10 l 2. 文本模式短消息................................................................................................................................ 12 te 2.1. 写和发短消息 ............................................................................................................................ 12 2.1.1. 设置文本模式参数 （+CSMP） ................................................................................ 12 c l 2.1.2. 直接发送短消息 （+CMGS）....................................................................................12 2.1.3. 写短消息到存储器 （+CMGW） .............................................................................. 13 ue tia 2.1.4. 从存储器发送短消息（+CMSS） ..............................................................................14 2.2. 接收和读短消息 ........................................................................................................................ 14 2.2.1. 显示文本模式参数（+CSDH） .................................................................................. 14 Q n 2.2.2. 新短消息提示 （+CNMI）.........................................................................................15 e 2.2.3. 读短消息 （+CMGR） ............................................................................................... 17 2.2.4. 读短消息列表 （+CMGL） ....................................................................................... 18 fid 2.3. 短消息状态报告 ........................................................................................................................ 19 2.4. 删除短消息 ................................................................................................................................ 20 2.4.1. 删除单条短消息（+CMGD） ..................................................................................... 20 n 2.4.2. 删除所有短消息（+QMGDA） .................................................................................. 20 2.5. 文本模式示例 ............................................................................................................................ 21 o 2.5.1. 发英文短消息（GSM 编码），不需状态报告............................................................ 21 C2.5.2. 发中文短消息（UCS2 编码），要求状态报告........................................................... 23 3. PDU 模式短消息 ............................................................................................................................... 25 3.1. 写和发短消息 ............................................................................................................................ 25 3.1.1. 直接发送短消息 （+CMGS）.................................................................................... 25 3.1.2. 写短消息到存储器 （+CMGW） .............................................................................. 25 3.2. 接收和读短消息 ........................................................................................................................ 26 3.2.1. 读短消息 （+CMGR） ............................................................................................... 26 3.2.2. 读短消息列表 （+CMGL） ....................................................................................... 26 3.3. 短消息状态报告 ........................................................................................................................ 27 3.4. 删除短消息 ................................................................................................................................ 27 3.5. PDU 格式说明 ............................................................................................................................ 27 上海移远通信技术有限公司 -2- GSM 短消息应用指导 3.5.1. 发送（SMS-Submit）PDU 串结构（MO） ............................................................... 27 3.5.2. 接收（SMS-Deliver） PDU 串结构 （MT） ........................................................... 28 3.5.3. 短消息状态报告 PDU 串结构 ..................................................................................... 28 3.5.4. 基本元素说明 ............................................................................................................... 28 3.6. PDU 模式示例 ............................................................................................................................ 34 3.6.1. 发英文短消息（GSM 编码），不需状态报告............................................................ 34 3.6.2. 发中文短消息（UCS2 编码），需要状态报告........................................................... 36 4. 短消息相关的其他命令.................................................................................................................... 40 4.1. 保存和恢复短消息设置 ............................................................................................................ 40 4.1.1. 保存短消息设置（+CSAS） ....................................................................................... 40 4.1.2. 恢复短消息设置 （+CRES)........................................................................................ 40 4.1.3. 其他短消息设置的保存 ............................................................................................... 40 4.2. 长短消息 Concatenated short message ...................................................................................... 41 4.3. 存储 Class0 短消息（+QCLASS0） ........................................................................................ 42 4.4. 配置短消息编码模式 （+QSMSCODE） .............................................................................. 43 4.5. 短消息满提示 （+QEXTUNSOL） ........................................................................................ 44 l 5. 附录 ................................................................................................................................................... 45 te 5.1. 短消息写和发流程 .................................................................................................................... 45 c l 5.2. 短消息接收流程 ........................................................................................................................46 CQounefidentia 5.3. 默认的 GSM 字母表 .................................................................................................................46 上海移远通信技术有限公司 3 GSM 短消息应用指导 表格目录 表 1：参考文档表................................................................................................................................... 6 表 2：相关 AT 命令................................................................................................................................6 表 3：缩略语 .......................................................................................................................................... 7 表 4：AT+CMGF 语法 .......................................................................................................................... 8 表 5：AT+CSCS 语法 ............................................................................................................................ 9 表 6：AT+CSCA 语法............................................................................................................................9 表 7：AT+CPMS 语法 ......................................................................................................................... 10 表 8：AT+CSMP 文本模式下的语法 ................................................................................................. 12 表 9：AT+CMGS 文本模式下的语法.................................................................................................12 表 10：AT+CMGW 文本模式下的语法 ............................................................................................. 13 表 11：AT+CMSS 文本模式下的语法................................................................................................ 14 表 12：AT+CSDH 文本模式下的语法 ............................................................................................... 14 l 表 13：AT+CNMI 语法 .......................................................................................................................15 te 表 14：AT+CMGR 文本模式下的语法 .............................................................................................. 17 表 15：AT+CMGL 文本模式下的语法...............................................................................................18 c l 表 16：AT+CMGD 语法......................................................................................................................20 表 17：AT+QMGDA 文本模式下的语法 ........................................................................................... 20 ue tia 表 18：AT+CMGS PDU 模式下的语法 ..............................................................................................25 表 19：AT+CMGW PDU 模式下的语法 .............................................................................................25 表 20：AT+CMGR PDU 模式下的语法 ..............................................................................................26 Q n 表 21：AT+CMGL PDU 模式下的语法 ..............................................................................................26 表 22：SMS-SUBMIT PDU 串结构..................................................................................................... 27 e 表 23：SMS-DELIVER PDU 串结构 ..................................................................................................28 fid 表 24：STATUS-REPORT PDU 串结构 ...................................................................................................28 表 25：......................................................................................................................................28 表 26： ...................................................................................................................................... 28 n 表 27：//..................................................................................................................29 表 28：结构 ................................................................................................................................. 29 o 表 29： ....................................................................................................................................... 31 C 表 30： ...................................................................................................................................... 31 表 31： 相对格式 ....................................................................................................................... 32 表 32： .................................................................................................................................... 32 表 33：AT+CSAS 语法........................................................................................................................40 表 34：AT+CRES 语法........................................................................................................................40 表 35：AT+QCLASS0 语法.................................................................................................................42 表 36：AT+QSMSCODE 语法 ............................................................................................................ 43 上海移远通信技术有限公司 4 GSM 短消息应用指导 0. 修改记录 版本 草稿 1.0 1.1 日期 2009-6-25 2010-11-12 2015-04-03 作者 杨中志 李红 王淑娟 修改内容记录 初始版本 增加详细说明 增加适用模块说明 CQouneficdteenl tial 上海移远通信技术有限公司 5 GSM 短消息应用指导 1. 概要 本文档主要介绍移远模块的点对点短消息服务相关 AT 命令及短消息服务相关操作内 容。广播消息服务部分在该文档内不作介绍。 本文档适用于所有 Quectel GSM 模块。 1.1. 参考 表 1：参考文档表 序号 [1] [2] l [3] te [4] [5] c l [6] 文档名 M10 ATC GSM 07.05 GSM 03.38 GSM 03.40 GSM 07.07 GSM 04.11 备注 M10 AT 命令手册 Equipment interface for SMS and CBS Alphabets and language-specific information Technical realization of the Short Message Service AT command set for GSM Mobile Equipment(ME） PP SMS support on mobile radio interface ue tia 表 2：相关AT命令 Q n AT命令 AT+CMGF e AT+CSCS AT+CSCA fid AT+CSMP AT+CNMI AT+CMGW n AT+CMSS o AT+CMGS C AT+CMGR 概述 选择短消息模式 选择 TE 字符集 设置短消息服务中心号码 设置文本模式参数 新短消息提示 写短消息到存储器 从存储器发送短消息 发短消息 读短消息 参考文档 GSM07.05 GSM07.07 GSM07.05 GSM07.05 GSM07.05 GSM07.05 GSM07.05 GSM07.05 GSM07.05 AT+CMGL 读短消息列表 GSM07.05 AT+CMGD 删除单条短消息 GSM07.05 AT+QMGDA 删除所有短消息 Quectel 定义 AT+CSDH 显示文本模式参数 GSM07.05 AT+CSAS 保存短消息设置 GSM07.05 AT+CRES 恢复短消息设置 GSM07.05 AT+CPMS 选择短消息优先存储器 GSM07.05 AT+QCLASS0 存储 Class0 短消息 Quectel 定义 AT+QSMSCODE 配置短消息编码模式 Quectel 定义 上海移远通信技术有限公司 -6- GSM 短消息应用指导 表 3：缩略语 缩略语 描述 SMS Short Message Service 短消息服务 SME Short Message Entity 短消息实体 SMSC/SC Short Message Service Center 短消息服务中心 MO Mobile Originated 移动台发起 MT Mobile Terminated 移动台终止 ME Mobile Equipment 移动设备 MS Mobile Station 移动站,包含 ME 和 SIM 卡 TE Terminal Equipment 终端设备 TA Terminal Adaptor 终端适配器 PDU TP URC TOA l TON NPI te FO c l MR OA ue tia DA RA PID Q n DCS e SCTS DT fid VP VPF UDL n UD UDHI o RP CSRI Protocol Data Unit 协议数据单元 Transfer Layer Protocol 传输层协议 Unsolicited Result Code 非请求结果码，模块主动上报信息 Type of Address 地址类型 Type of Number 号码类型 Numbering Plan Identification 编号方案 First Octet 第一个八位字节 Message Reference 消息参考值 Originator Address 源地址 Destination Address 目标地址 Recipient Address 接收地址 Protocol Identifier 协议标识 Data Coding Scheme 数据编码方案,参考[3]GSM 03.38 Service Center Time Stamp 服务中心时间戳 Discharge Time 丢弃时间 Validity Period 有效期 Validity Period Format 有效期格式 User Data Length 用户数据长度 User Data 用户数据 User Data Header Indicator 用户数据头标识 Reply Path 回复路径 Status Report Indication 状态报告标识 SRR Status Report Request 状态报告要求 SRQ Status Report Qualifier 状态报告类型 RD Reject Duplicate 重复信元丢弃 ST Status 状态 PI 参数 Identifier 参数标识 MTI Message Type Indicator 信息类型指示 MMS More Messages to Send 更多短消息发送 &b Binary format 二进制格式表示 &h Hexadecimal format 十六进制格式表示 &d Decimal format 十进制格式表示 上海移远通信技术有限公司 7 GSM 短消息应用指导 1.2. 概述 短消息服务指通过短消息服务中心中转，在移动站之间传递短消息。短消息服务包括 3 种基本服务：  短消息提交 SMS-Submit（MO）：模块提交短消息到服务中心  短消息接收 SMS-Deliver（MT）：模块从服务中心接收短消息  短消息状态报告：提示用户短消息是否成功被接收 备注：使用超级终端前的准备工作 1. 通过串口将模块 EVB 连接到 PC。 2. 打开电脑上的超级终端程序，设置和模块一致的波特率（模块默认为自适应波特 率）。 3. 确认模块和 SIM 卡正确装配到模块上，然后模块开机。 AT命令类型和返回结果： 命令类型 命令格式 说明 l 测试命令 AT+=? 该命令用于查询设置命令或内部程序设置的参数及 te 其取值范围 查询命令 AT+? 该命令返回参数的当前值 c l 设置命令 AT+= 该命令用于设置用户自定义的参数值  AT 命令本身不区分大小写，但参数可能对大小写敏感。按回车 Enter（）开 ue tia 始执行命令。  在本文档的例子中，蓝色字体表示用户在超级终端中输入的命令和参数，'//'后的 文字是相关描述，其它为命令的返回结果或模块主动上报信息（URC）。 Q n  命令返回结果可能是 ERROR，+CME ERROR: ，或 +CMS ERROR: 。 e 对错误号含义请参考[1]M10_ATC。 fid 1.2.1. 选择短消息模式（+CMGF） 短消息收发、读写时分两种模式：文本模式和 PDU 模式。在文本模式中，用户可以按 n 照普通文本格式写短消息，通过一些命令设置相关的短消息收发参数。在 PDU 模式中，用 o 户按照固定的十六进制格式写短消息 PDU，PDU 串中包含了相关的参数。 C模式设置命令为 AT+CMGF。见下表。 表 4：AT+CMGF 语法 命令 可能的返回结果 示例 备注 AT+CMGF=? AT+CMGF? AT+CMGF= +CMGF: (取值列表) +CMGF: OK +CMGF: (0,1) +CMGF: 0 AT+CMGF=0 AT+CMGF=1 列出允许的取值 返回当前的模式 设置PDU模式。PDU为 默认设置 设置文本模式 本文第 2 节介绍如何在文本模式下收发短消息和状态报告，第 3 节介绍 PDU 模式，第 4 节是和短消息相关的一些其他命令。 上海移远通信技术有限公司 8 GSM 短消息应用指导 1.2.2. 选择 TE 字符集（+CSCS） AT+CSCS 设置 TE 使用的字符集。TA 能据此在 TE 和 ME 之间准确地传送字符 串。字符集的设置将影响到短消息的传送和接收。 表 5：AT+CSCS 语法 命令 可能的返回结果 示例 AT+CSCS=? +CSCS: (取值列表) +CSCS: ('GSM','HEX','IRA','PCCP437','UCS2 AT+CSCS? +CSCS: ','8859-1') +CSCS: 'GSM' (默认) AT+CSCS= OK AT+CSCS='GSM' OK 参数 ： l 'GSM' GSM 缺省符号集，7-bit 编码 （见[3]GSM 03.38 subclause 6.2.1 或本文附录 5.3） te 'HEX' 十六进制数 00 到 FF c l 'IRA' International reference alphabet 国际参考符号集（ITU-T T.50） 'PCCP437' PC 字符集代码页 437 ue tia 'UCS2' UCS2 字符集。16-bit 通用八位字节倍数编码的字符集（ISO/IEC 10646） '8859-1' ISO 8859 拉丁语 1 字符集 Q n 备注:  对英文短消息，建议使用'GSM'作为TE字符集。而其他语言的短消息，最好使用 e 'UCS2'。 fid 1.2.3. 设置短消息服务中心号码（+CSCA） n 短消息服务中心(SMSC)用于短消息的存储和转发。要使用短消息服务，移动站首先要 明确短消息服务中心的号码。SMSC由网络运营商提供，作为出厂设置保存在SIM卡中。强 o 烈建议客户在任何时候都不要更改SMSC号码，而且在发送短消息之前最好确认号码是否正 C 确。 表 6：AT+CSCA 语法 命令 可能的返回结果 AT+CSCA=? OK AT+CSCA? +CSCA: , OK AT+CSCA=[,] +CME ERROR: 参数： 字符型的短消息中心地址 整数型的地址类型。使用十进制格式表示（见[4]GSM 03.40 上海移远通信技术有限公司 9 GSM 短消息应用指导 9.1.2.5 节） 示例: AT+CSCS? +CSCS: 'GSM' OK AT+CSCA? +CSCA: '+8613800210500',145 OK AT+CSCS='UCS2' OK AT+CSCA? +CSCA: '002B0038003600310033003800300030003200310030003500300030',145 OK l 备注: te  为了避免漫游时产生短消息收发问题，建议将所有地址存储成国际号码格式（以'+' 开头）！ c l  请向网络运营商询问正确的短消息中心号码。 ue tia  强烈建议客户在任何时候都不要更改SMSC号码，而且在发送短消息之前最好确认号码 是否正确。 Q n 1.2.4. 选择短消息优先存储器（+CPMS） e AT+CPMS用于选择短消息读、写、收等操作的存储器。 fid 表 7：AT+CPMS 语法 命令 可能的返回结果 n +CPMS: (取值列表),( 取 AT+CPMS=? 值列表) ,( 取值列表) o+CPMS: C AT+CPMS? ,,,,,,,, 50 AT+CPMS= [ , ,] +CPMS: ,,,,, 参数： // 存储器位置： ：读取和删除短消息时使用的存储器 ：写和发送时使用的存储器 上海移远通信技术有限公司 10 GSM 短消息应用指导 // // ：如果没有建立到TE的路由(见+CNMI)，则将接收的 短消息存储在该存储器。 的取值范围包括'SM' (SIM)、'ME'或'MT'(SM+ME)。 中当前已存储的短消息条数 中总共能存储的短消息条数 备注：  M10最多能存储短消息300条，含SIM卡和ME。ME最多存储200条，且SIM卡存储 优先分配。如果当前SIM卡有150条短消息存储容量，那么此时ME最多被分配存储150条短 消息。 CQouneficdteenl tial 上海移远通信技术有限公司 11 GSM 短消息应用指导 2. 文本模式短消息 2.1. 写和发短消息 可以采用两种方式来发送短消息。一种方式是用命令+CMGS直接发送短消息，另一种 方式是先写短消息+CMGW，保存到存储器，然后用+CMSS转发出去。 在文本模 式下，发送短消息之前先要用+CSMP进行一些参数的设置。 2.1.1. 设置文本模式参数（+CSMP） AT +CSMP设置文本模式下发送短消息的参数。 表 8：AT+CSMP 文本模式下的语法 l 命令 可能的返回结果 示例 te AT+CSMP=? +CSMP: (取值列表),( 取值列 +CSMP: 表), (取值列表), (取值列表) (17,49),(0-255),(0-255),(0-255) uec tial AT+CSMP? +CSMP: ,,, AT+CSMP=[[[,pid>[, OK Q n ]]]] e 推荐的文本模式下 和 设置值如下： fid 英文短消息 想要短消息接收时被存储 +CSCS='GSM' =241 n 想要在接收端直接显示短 +CSCS='GSM' 消息内容 =240 Co 备注： +CSMP: 17,167,0,241 其它语言短消息 +CSCS='UCS2' =25 +CSCS='UCS2' =24  写短消息时+CSCS和必须匹配。比如，如果+CSCS选择了'UCS2'，但却用 了7位编码方式，那么收到的短消息将是乱码。  参数,,,的含义及取值和PDU模式是一样的。请参考本文的3.5节PDU 格式说明。他们的区别是文本模式下+CSMP的参数使用十进制的数值表示，PDU模式 下在PDU串中使用十六进制的值表示。 2.1.2. 直接发送短消息（+CMGS） 表 9：AT+CMGS 文本模式下的语法 命令 可能的返回结果 示例 上海移远通信技术有限公司 12 GSM 短消息应用指导 AT+CMGS=? OK 发送英文字符'TEST'到 13795403834: AT+CSCS='GSM' AT+CMGS='13795403834' AT+CMGS=[,] >text is entered +CMGS: +CMS ERROR: >TEST 发送中文字符'测试'到 13795403834: AT+CSCS='UCS2' AT+CMGS=' 00310033003700390035003400 300033003800330034' 参数: l >6D4B8BD5 [4]GSM 03.40 TP-Destination-Address 目标地址，字符型 整数型的地址类型，见 Type Of Address 参考本文的 3.5 节 PDU 格式说明 cte l （同时按Ctrl和Z键）用于结束短消息内容的输入和开始执行命令。Esc键用 于取消命令的执行。 ue tia 备注：  如果AT+CSCS='UCS2'，应该用UCS2格式输入。 Q en 2.1.3. 写短消息到存储器（+CMGW） fid 表 10：AT+CMGW 文本模式下的语法 命令 AT+CMGW=? n AT+CMGW=[,[,]] o > C 可能的返回结果 OK +CMGW: +CMS ERROR: 参数:  和短消息内容格式及含义和+CMGS一样。  ：默认情况下+CMGW写的短消息将以未发送'STO UNSENT'状态保存到 ，但也允许用参数将短消息状态改成已发送'STO SENT'保存。 +CMGW写的短消息将被存储到（查看 +CPMS）。命令执行正确将返回短消 息在的索引号，然后该短消息可以通过下面的命令+CMSS发出。 上海移远通信技术有限公司 13 GSM 短消息应用指导 2.1.4. 从存储器发送短消息（+CMSS） 表 11：AT+CMSS 文本模式下的语法 命令 AT+CMSS=? AT+CMSS=[,[,]] 可能的返回结果 OK +CMSS: OK +CMS ERROR: 示例: AT+CMGW='15021012496' > test +CMGW：54 //写短消息成功，在的索引号为54 OK AT+CMSS=54 l +CMSS：122 //发短消息到+CMGW设置的目标号码'15021012496' te OK AT+CMSS=54,'13795403834' //发短消息到新的目标地址'13795403834' c l +CMSS：123 ue tia OK 备注: Q n  如果在+CMSS中指定了目标地址，该号码将代替和短消息一起保存的号码，也就是 说，短消息将被发送到+CMSS中指定的号码。 e  对+CMSS，PDU模式和文本模式没有什么区别。 fid 2.2. 接收和读短消息 n 收到短消息时如何处理（怎样显示 URC，短消息是否保存，保存到哪里等）将取决于 o +CNMI 的设置和短消息发送时在中定义的短消息类型。用户可以从 URC 获取短消息 C 内容，短消息保存下来的话通过 +CMGR/+CMGL 读取短消息内容。+CSDH 将决定文本模 式下读短消息时显示哪些内容。 2.2.1. 显示文本模式参数（+CSDH） 表 12：AT+CSDH 文本模式下的语法 命令 可能的返回结果 AT+CSDH=? +CSDH: (取值列表) AT+CSDH? +CSDH: AT+CSDH=[] OK 示例 +CSDH: (0, 1) +CSDH: 0 上海移远通信技术有限公司 14 GSM 短消息应用指导 参数 取值： 0 1 不显示 (默认） 显示 决定文本模式下，是否在+CMT、+CMGL、+CMGR 的返回信息中显示下列参 数值：+CSCA 和 +CSMP 中定义的参数（、、、、 、）、 、或 。 备注：  该命令只影响文本模式的显示，PDU 模式不需要该命令。 2.2.2. 新短消息提示（+CNMI） 表 13：AT+CNMI 语法 命令 AT+CNMI=? ctel l AT+CNMI? ue tia AT+CNMI=[[,< mt>[, [,[,]]]]] 可能的返回结果 +CNMI: (取值列表),( 取值列 表),( 取值列表),( 取值列表),( 取 值列表) +CNMI: ,,,, OK ERROR 示例 +CNMI: (0-3), (0-3), (0,2,3), (0,1), (0,1) +CNMI: 2,1,0,0,0 (默认) Q n 当TE处于在用状态（如DTR信号处于'ON'），使用设置命令，可设置新消息如何从网络 e 侧发送到TE。若TE处于待用状态（如DTR信号处于'OFF'），消息接收流程应按照GSM 03.38 fid 的规定。 控制指定的非请求结果码（URC）的处理情况。 n 参数取值：参考下图（见[2]GSM07.05 Section 3 Figure 2） o 0 缓冲URC到TA；如果TA结果码缓存器已满，结果码指示可以缓存在其他存储空间， C或者把最旧的URC丢弃，替换为新收到的指示。不发给TE。 1 当TA-TE间的链路被占用（比如在线数据模式下），丢弃结果码指示，并拒绝接收 新的短消息URC。不被占用时直接转发给TE。 2 当TA-TE间的链路被占用（比如在线数据模式下），缓存URC到TA，当链路释放后 转发给TE。不被占用时直接转发给TE。（建议，默认） 3 直接转发给TE。当TA处于在线数据模式时，TA-TE链路inband技术可以将提示和数 据混合在一起进行传输。 上海移远通信技术有限公司 15 GSM 短消息应用指导 uectel tial 取值： 怎样存储收到的短消息取决于，+CPMS中的设置和这个设置值。 0 没有SMS-DELIVER提示发给TE Q n 1 若SMS-DELIVER存储到ME/TA，用下面的URC来指示存储位置： e +CMTI：, 2 用下面的URC将SMS-DELIVER（除class 2类型）直接转发到TE： fid +CMT：[], （PDU模式） 或 +CMT：, [], n [,,,,,,,] （文本模式 斜 o 体参数请参考+CSDH）。 CClass 2类型短消息同=1设置，即+CMTI 提示。 3 Class 3 SMS-DELIVERs用=2定义的URC直接转发到TE，即+CMT 提示 其他类型短消息通=1，即+CMTI 提示。 设置广播消息，不在本文讨论范围内。 设置是否转发状态报告： 0 SMS-STATUS-REPORTs不被发到TE 1 SMS-STATUS-REPORTs 使用下面的 URC 发到 TE： +CDS: （PDU 模式） 或 上海移远通信技术有限公司 16 GSM 短消息应用指导 +CDS: ,,[],[],,, （文本模式） 取值： 0 当为1~3时，这条命令所定义的TA缓存中的结果码被发送到TE（在发送之前， OK应该被接收到） 1 当为 1~3 时，将清除该命令中定义的 TA 对 URC 的缓冲。 备注：  强烈建议用户将 设成2，以避免短消息提示丢失。这也是模块的默认设置。  对参数，如果用户想保存短消息，将它设为1（AT+CNMI=2,1 默认），那么短消 息到达时有提示 +CMTI: , ，然后可以按照提示读取短消息 AT+CMGR=。 如果用户想直接读短消息内容，将设成2（AT+CNMI=2,2）， 那么短消息内容直接显示在提示+CMT中。  短消息接收流程请参考[2]GSM 07.05 Clause 3 Figure 3 或本文附录5.2。 l 2.2.3. 读短消息（+CMGR） te 表 14：AT+CMGR 文本模式下的语法 c l 命令 可能的返回结果 in 文本模式 AT+CMGR=? OK ue tia AT+CMGR=[,] +CMGR: ,,[],[,,,,,,,] e 在文本模式下显示提交的短消息 SMS-SUBMIT: +CMGR: fid ,,[][,,,,,[],,,] TA 将（+CPMS）中索引号为的短消息内容返回 TE。 on 整型，短消息在相应存储器中的索引号 C普通。如果短消息状态为未读'received unread'，读完后状态将变为已读 0 'received read'。 1 不改变短消息状态 示例: 写和读短消息： AT+CMGW > test +CMGW: 6 AT+CSDH=0 AT+CMGR=6 +CMGR: 'STO UNSENT','','' test AT+CSDH=1 AT+CMGR=6 +CMGR: 'STO UNSENT','','',0,49,0,0,71,'',0,4 test 上海移远通信技术有限公司 17 GSM 短消息应用指导 OK OK OK 收和读短消息： AT+CNMI=2,1,0,0,0 +CMTI: 'SM',3 AT+CMGR=3 +CMGR: 'REC UNREAD','+861502101249 6','','2010/08/18 17:29:12+32' test OK +CMTI: 'SM',4 AT+CMGR=4 +CMGR: 'REC UNREAD','+8615021012496','','2010 /08/18 17:37:23+32',145,4,0,241,'+861380021 0500',145,4 test +CMT: 收和直接显示短消 +CMT: '+8615021012496',,'2010/08/18 息: AT+CNMI=2,2,0,0,0 '+8615021012496',,'2010/08 /18 17:32:02+32' test 17:26:52+32',145,4,0,0,'+86138002105 00',145,4 test 备注： l  PDU 模式下命令格式一样，但返回结果格式和文本模式不一样。 cte l 2.2.4. 读短消息列表（+CMGL） ue tia 表 15：AT+CMGL 文本模式下的语法 AT 命令 可能的返回结果 Q n AT+CMGL=? OK +CMS ERROR: fide AT+CMGL=[,] 对 SMS-SUBMIT 和 SMS-DELIVER: +CMGL: ,,,[],[][,,][ +CMGL: ,,,[],[][,,][...]] Co AT+CMGL 返回中所有状态为的短消息。 参数： 文本模式 PDU 模式 描述 'REC UNREAD' 0 收到的未读短消息（默认） 'REC READ' 'STO UNSENT' 'STO SENT' 'ALL' 0 1 收到的已读短消息 2 存储的未发送短消息 3 存储的已发送短消息 4 所有短消息 普通。如果短消息状态为未读'received unread'， 0 读完后状态将变为已读'received read'。 上海移远通信技术有限公司 18 GSM 短消息应用指导 1 1 不改变短消息状态 示例: AT+CSDH=0 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','15021012496','', test AT+CSDH=1 OK AT+CMGL='ALL' +CMGL: 1,'STO UNSENT','15021012496','',,129,4 test +CMGL: 2,'STO SENT','15021012496','', test +CMGL: 2,'STO SENT','15021012496','',,129,4 test +CMGL: 3,'REC READ','+8615021012496','','2010/08/18 17:29:12+32' l test +CMGL: 3,'REC READ','+8615021012496','','2010/08/18 17:29:12+32',145,4 test te +CMGL: 4,'REC READ','+8615021012496','','2010/08/18 c l 17:37:23+32' ue tia test +CMGL: 4,'REC READ','+8615021012496','','2010/08/18 17:37:23+32',145,4 test OK OK Q n 备注： e  PDU 模式下和文本模式使用不同格式的参数，返回不同格式的结果。 fid 2.3. 短消息状态报告 n 短消息状态报告被用来确认一条短消息发出后是否被目标地址正确接收。如果需要状态 o 报告，在文本模式下需要设置如下两个参数： 1) AT+CNMI=2,1,0,1,0 //第四个参数必须设成 1 C2) AT+CSMP=49,167,0,241 //第一个参数必须等于 49 当短消息被对方收到，发送端会得到以下 URC（文本模式）： +CDS：,,[],[],,, 请参考本文例子 section 2.5。 上海移远通信技术有限公司 19 GSM 短消息应用指导 2.4. 删除短消息 2.4.1. 删除单条短消息（+CMGD） 表 16：AT+CMGD 语法 命令 可能的返回结果 示例 AT+CMGD=? +CMGD:( 中可被 +CMGD: (1-50) 删除的索引号范围) OK AT+CMGD=[,] +CMS ERROR: TA 删除（+CPMS）中索引号为的短消息。 TA 删除 (+CPMS)中的短消息。如果没设置或为 0，将删除索引号为 的短消息。如果有参数，且不为 0，那么 被忽略，一类或多类短消息将被 删除，见下表。 l 参数取值： te 0 或没有设置 删除索引号位的短消息 1 删除所有已读短消息 c l 2 删除所有已读和已发短消息 ue tia 3 删除所有已读、已发和未发短消息 4 删除所有短消息 Q n 备注：  PDU 模式和文本模式对该命令没有区别。 fide 2.4.2. 删除所有短消息（+QMGDA） 表 17：AT+QMGDA 文本模式下的语法 Con 命令 可能的返回结果 示例 文本模式返回: +QMGDA:('DEL READ','DEL UNREAD','DEL SENT','DEL AT+QMGDA=? +QMGDA: (取值列表) UNSENT','DEL INBOX','DEL +CMS ERROR: ALL') PDU 模式返回: +QMGDA:(1-6) OK AT+QMGDA= ERROR +CMS ERROR: TA 删除（+CPMS）中所有类型为的短消息。 上海移远通信技术有限公司 20 GSM 短消息应用指导 参数取值： 文本模式 'DEL READ' 'DEL UNREAD' 'DEL SENT' 'DEL UNSENT' 'DEL INBOX' 'DEL ALL' PDU 模式 1 2 3 4 5 6 描述 删除所有已读短消息 删除所有未读短消息 删除所有已发送短消息 删除所有未发送短消息 删除所有接收到的短消息 删除所有短消息 备注：  PDU 模式下和文本模式使用不同格式的参数。 2.5. 文本模式示例 用户可以参考以下示例在文本模式下收发短消息。 l 2.5.1. 发英文短消息（GSM 编码），不需状态报告 te 示例：发送'Hello' 到 +8613795403834 c l 发送端: +8613651979176 ue tia //步骤1：核对短消息中心号码 AT+CSCS='GSM' //设置 TE 字符集为'GSM' OK Q n AT+CSCA? e //查询短消息中心号。对上海的中国 移动，短消息中心号为 fid '+8613800210500'。如果这个号码 错误，短消息可能发送失败，那么 用命令AT+CSCA=设置正确 n 的短消息中心号1，并用AT+CSAS 保存设置。 o +CSCA: '+8613800210500',145 C OK 接收端: +8613795403834 //步骤 1：核对短消息中心号码 AT+CSCS='GSM' OK AT+CSCA? +CSCA: '+8613800210500',145 OK //步骤 2：文本模式下发送英文短消息的设置 //步骤 2：文本模式下接收英文短消息的设置 AT+CMGF=1 //设置文本模式 AT+CMGF=1 //设置文本模式 OK OK AT+CSCS='GSM' AT+CSCS='GSM' // （可选，因为在步骤 1 中已经设 //设置 TE 字符集为'GSM'。如果设 置过）设置 TE 字符集为'GSM'。 置 为 'UCS2' ， 短 消 息 内 容 将 以 OK UCS2 格式显示。 AT+CSMP=17,167,0,241 OK //设置文本模式下发送短消息的相 AT+CNMI=2,1,0,0,0 关参数：， ，和 //设置新短消息到达时的提示参 上海移远通信技术有限公司 21 GSM 短消息应用指导 2。和+CSCS需要互相匹 数。第二个参数设成1，获取+CMTI 配。对英文短消息，+CSCS设置为 提示。 'GSM'， 设置成GSM 7位编 OK 码方式。 AT+CPMS? OK //核对短消息存储空间是否已满， AT+CNMI=2,1,0,0,0 如果已满，用+CMGD或+QMGDA //不需要短消息报告的设置： = 删除短消息。 17 或者（+CNMI 的第四个参 +CPMS: 'SM',0,50,'SM',0,50,'SM',0,50 数）= 0 OK OK AT+CSDH=1 //设置成1将使读短消息时显示更 OK //步骤 3：发送英文短消息 AT+CMGS='13795403834' l //发送短消息：直接输入短消息接收 号码，返回'>'之后输入短消息内 te 容，同时按Ctrl和Z结束输入。 >Hello c l +CMGS: 140 多的内容。 ue tia OK //步骤 3：接收和读短消息 Q n +CMTI: 'SM',1 AT+CMGR=1 e +CMGR: 'REC UNREAD','+8613651979176','','2010/09/0 fid1 11:11:47+32',145,4,0,241,'+8613800210500', 145,5 n Hello o OK C AT+CSCS='UCS2' //如果+CSCS 设置为'UCS2'，短消 息内容将以UCS2格式显示。 OK AT+CMGR=1 +CMGR: 'REC READ','002B0038003600310033003600350 031003900370039003100370036','','2010/09 /01 11:11:47+32',145,4,0,241,'002B00380036003 1003300380030003000320031003000350030 上海移远通信技术有限公司 22 GSM 短消息应用指导 0030',145,5 00480065006C006C006F OK 备注 1： SMSC 短消息中心号由网络运营商提供，作为出厂设置保存在 SIM 卡中。强烈建议客 户在任何时候都不要更改 SMSC 号码，而且在发送短消息之前最好确认号码是否正确。 备注 2: 参数,,,的含义及取值和PDU模式是一样的。请参考本文的3.5节PDU 格式说明。他们的区别是文本模式下+CSMP的参数使用十进制的数值表示，PDU模式下在 PDU串中使用十六进制的值表示。 = 241&d 表示短消息内容采用GSM缺省的7位编码 方式，要发送到保存。如果等于240&d，表示短消息内容为GSM 7位编码方式， 直接在接收TE显示内容。 2.5.2. 发中文短消息（UCS2 编码），要求状态报告 tel 示例：发送 '您好' （UCS2 编码 '60A8597D'） 到 13795403834 发送端: 13651979176 接收端: 13795403834 c l //步骤 1：核对短消息中心号码 //步骤 1：核对短消息中心号码 AT+CSCS='GSM' AT+CSCS='GSM' ue tia OK OK AT+CSCA? AT+CSCA? +CSCA: '+8613800210500',145 +CSCA: '+8613800210500',145 Q n OK e //步骤 2：文本模式下发送中文短消息的设置 fid AT+CMGF=1 //设置文本模式 OK AT+CSCS='UCS2' n //设置 TE 字符集为'UCS2'。 OK Co AT+CSMP=49,167,0,25 //设置文本模式下发 OK //步骤 2：文本模式下接收中文短消息的设置 AT+CMGF=1 //设置文本模式 OK AT+CNMI=2,2,0,0,0 //设置新短消息到达时的提示参 数。第二个参数设成2，获取带短 消息内容的+CMT提示。 OK 送短消息的相关参数：，， AT+CPMS? 和1。和+CSCS需要 //核对短消息存储空间是否已满， 互相匹配。对中文短消息，+CSCS 如果已满，用+CMGD或+QMGDA 设置为'UCS2'， 设置成 删除短消息。 UCS2 编码方式。 +CPMS: 'SM',1,50,'SM',1,50,'SM',1,50 OK AT+CNMI=2,1,0,1,0 OK //需要短消息报告的设置：=49 AT+CSDH=0 且（+CNMI 第四个参数）=1 //设置成0，读短消息时显示参数少 OK 一些。 OK 上海移远通信技术有限公司 23 GSM 短消息应用指导 //步骤 3：发送中文短消息 AT+CMGS='003100330037003900350034003 00033003800330034' //发送短消息：输入UCS2编码的短 消息接收号码，返回'>'之后输入 UCS2编码的短消息内容，同时按 Ctrl和Z结束输入。 > 60A8597D +CMGS: 141 OK //步骤 3：接收和读短消息 +CMT: '+8613651979176',,'2010/09/01 11:14:52+32' 60A8597D AT+CPMS? //短消息没有被保存 l +CPMS: 'SM',1,50,'SM',1,50,'SM',1,50 te OK //步骤 4：得到状态报告 c l +CDS: ue tia 6,141,'+8613795403834',145,'2010/09/01 11:25:55+32','2010/09/01 11:25:55+32',0 备注 1: Q n 参数,,,的含义及取值和PDU模式是一样的。请参考本文的3.5节PDU 格式说明。他们的区别是文本模式下+CSMP的参数使用十进制的数值表示，PDU模式下在 e PDU串中使用十六进制的值表示。 = 25&d 表示短消息内容采用UCS2编码方式，要发 fid 送到保存。如果等于24&d，表示短消息内容为UCS2编码方式，直接在接收TE Con 显示内容。 上海移远通信技术有限公司 24 GSM 短消息应用指导 3. PDU 模式短消息 3.1. 写和发短消息 3.1.1. 直接发送短消息（+CMGS） 表 18：AT+CMGS PDU 模式下的语法 命令 可能的返回结果 示例 AT+CMGS=? OK AT+CMGS= l PDU is given cte l +CMGS: +CMS ERROR: 发送英文字符'TEST'到 13795403834: AT+CMGS=19 > 0011000D91683197453038F400F10104D4E294 0A 发送中文字符'测试' 到 13795403834: AT+CMGS=19 >0011000D91683197453038F4000801046D4B8 BD5 ue tia 备注：  串中包含了发送短消息所需的所有参数，比如目标地址，地址类型，短消息内容， Q n 文本模式下设置的参数等。结构请参考 3.5.1 发送（SMS-Submit） PDU 串结构（MO）。 e  必须和的实际长度匹配。  等于中去除的字节数。 见 3.5.1 发送（SMS-Submit） PDU 串 fid 结构（MO）。 n 3.1.2. 写短消息到存储器（+CMGW） o 表 19：AT+CMGW PDU 模式下的语法 C 命令 可能的返回结果 AT+CMGW=? OK AT+CMGW=[,] PDU is given +CMGW: +CMS ERROR: 参数和内容和上一个命令相同，但是短消息不会被发送出去， 而是保存到（+CPMS）。 保存的短消息可以用+CMSS 发送出去。这个命令的使用和文本模式相同。 上海移远通信技术有限公司 25 GSM 短消息应用指导 3.2. 接收和读短消息 在 PDU 模式下，+CNMI 和+CMGR 的命令语法和文本模式相同。他们的区别在于 URC +CMTI、+CMT、+CDS 和+CMGR 的返回结果格式。 命令+CSDH 在 PDU 模式下无效。因为各参数都包含在串中。 请参考 3.5.2 接 收（SMS-Deliver）PDU 串结构（MT）。 3.2.1. 读短消息（+CMGR） 表 20：AT+CMGR PDU 模式下的语法 命令 可能的返回结果 示例 AT+CMGR=[,< l mode>] +CMGR: ,[], AT+CMGR=5 +CMGR: 0,,24 0891683108200105F0040D9168512001 2194F600F10180817144302304F4F29 C0E teOK c l 对 PDU 模式下，参数和的取值和含义见下一个命令+CMGL。 ue tia 3.2.2. 读短消息列表（+CMGL） 表 21：AT+CMGL PDU 模式下的语法 Q n 命令 可能的返回结果 e AT+CMGL=? OK +CMS ERROR: fid AT+CMGL=<st +CMGL:,,[], at>[,] +CMGL: ,,[alpha],[...]] n +CMGL 的设置命令返回中所有状态为的短消息。 Co 参数取值： 参数 文本模式 PDU 模式 描述 'REC UNREAD' 0 收到的未读短消息（默认） 'REC READ' 1 收到的已读短消息 'STO UNSENT' 2 存储的未发送短消息 'STO SENT' 3 存储的已发送短消息 'ALL' 4 所有短消息 0 默认。如果短消息状态为未读'received 0 unread'，读完后状态将变为已读'received read'。 1 1 不改变短消息状态 示例: 上海移远通信技术有限公司 26 GSM 短消息应用指导 AT+CMGL=4 +CMGL：1,2,,18 0011FF0B815120012194F600004704F4F29C0E +CMGL：2,3,,18 00117E0B815120012194F600004704F4F29C0E +CMGL：3,1,,24 0891683108200105F0040D91685120012194F600F10180817192212304F4F29C0E +CMGL：4,1,,24 0891683108200105F0040D91685120012194F600F10180817173322304F4F29C0E OK l 3.3. 短消息状态报告 te PDU 模式下，如果需要短消息状态报告，设置如下两个参数： c l 1) AT+CNMI=2,1,0,1,0 //第四个参数必须等于 1 2) 发送 PDU 串中，字段的必须设成 1 ue tia 当短消息被接收，发送端将得到下面的 URC（PDU 模式）： +CDS: Q n 请参考 3.6 PDU 模式示例。 fide 3.4. 删除短消息 和文本模式一样，用户可以通过+CMGD 或+QMGDA 删除短消息。他们的区别只有 n +QMGDA 命令中的参数取值。请参考 2.4 节。 Co 3.5. PDU 格式说明 对元素的详细说明请参考[3]GSM 03.38，其他参数请参考[4]GSM 03.40 subclause 9。 为便于描述，对本文中的数字后加&b/&h/&d 分别表示二进制/十六进制/十进制格式。 3.5.1. 发送（SMS-Submit）PDU 串结构（MO） 表 22：SMS-SUBMIT PDU 串结构 八位字节数 1-12 1 1 2-12 1 上海移远通信技术有限公司 1 0,1 or 7 1 0-140 27 GSM 短消息应用指导 元素 SCA FO MR DA PID DCS VP UDL UD 3.5.2. 接收（SMS-Deliver） PDU 串结构（MT） 表 23：SMS-DELIVER PDU 串结构 八位字节数 元素 1-12 1 2-12 1 1 SCA FO OA PID DCS 7 SCTS 1 UDL 0-140 UD 3.5.3. 短消息状态报告 PDU 串结构 表 24：Status-Report PDU 串结构 八位字 节数 1-12 1 1 2-12 7 7 1 1 1 1 01 140 元素 SC SCA FO MR RA DT ST PI PID DCS UDL UD TS l 从 PI 到 UD 都是可选的。 cte l 3.5.4. 基本元素说明 ue tia 3.5.4.1. Type of Address 地址类型 表 25： Q n &b &h &d e 1 TON NPI 描述 1 000 0001 81 129 未知 fid 1 001 0001 91 145 国际号码，以国际接入号'+'和国家区号开始。 1 010 0001 A1 161 国内号码 n 请参考 GSM 04.08 subclause 10.5.4.7 Called party BCD number for details of TON (Type of Number) and NPI(Numbering plan identification)章节。 Co 3.5.4.2. Service Center Address 短消息中心地址 表 26： 元素 SCA length TOA SCA 示例（&h） 08 91 683108200105F0 上例中的地址是中国移动在上海的短消息中心号'+8613800210500'。 参数说明： SCA length = 8 = 1 （TOA 的字节数） + 7 （SCA 的字节数） TOA = 91：表示该号码为国际号码，相当于在 SCA 号码前加'+'。 SCA = 683108200105F0：短消息服务中心号码。编码格式如下： 上海移远通信技术有限公司 28 GSM 短消息应用指导 1) 一个字节包含两个数字。 2) 如果号码的数字总数为奇数，最后一个数字后加'F&h'补齐。 3) 从头开始依次交换每两个数字。 原始号码 编码后格式 86 13 80 02 10 05 0（F） 68 31 08 20 01 05 F0 备注：  在发送短消息时（SMS-Submit），如果设为'00'，那么命令+CSCA的设置值被使 用。 强烈建议客户在任何时候都不要更改SMSC号码，而且在发送短消息之前最好确 认号码是否正确。 3.5.4.3. Originator/Destination/Recipient Address // 源/目标/接收地址 表 27：// 元素 Address length l 示例（&h） 0D TOA 91 OA/DA/RA 683197453038F4 te 参数说明: Address length = 0D&h = 13&d = //数字的个数（8613795403834） c l //：地址编码格式同 ue tia 备注:  如果 TOA 和号码不匹配，短消息可能发送失败。  为了避免漫游时产生短消息收发问题，建议将所有地址存储成国际号码格式（以'+'开 Q n 头）！ e 3.5.4.4. First Octet 第一个八位字节 fid 第一个八位字节包含短消息的一些参数设置，比如短消息类型（MTI）——是SMS Submit、SMS-Deliver还是短消息报告；发送短消息时是否需要短消息报告（SRR）；是否 有有效期和有效期的格式（VPF）等。 n 表 28：结构 o Bit 7 6 5 4 3 2 1 0 C SMS-Submit RP UDHI SRR VPF RD MTI SMS-Deliver RP UDHI SRI - MMS MTI SMS-Status RP UDHI SRQ - MMS MTI Report 参数取值和描述： 参数 Reply Path 回复路 RP 径 值 （bit） 0 1 含义 没有 Reply Path 有 Reply Path 上海移远通信技术有限公司 29 GSM 短消息应用指导 UDHI User Data Header Indicator 用户数据 头标识 没有用户数据头，即用户数据字段（UD-User Data） 0 只有短消息内容 1 有用户数据头，即 UD 字段包含短消息头信息 Status Report SRI Indication 状态报 告标识 0 状态报告不返回给 SME 1 状态报告返回到 SME Status Report 0 不需要状态报告 SRR Request 状态报告要 求 1 需要状态报告 Status Report 0 该状态报告是短消息提交 SMS-Submit 的结果 SRQ Qualifier 状态报告 类型 1 该状态报告是短消息命令 SMS-Command 的结果 00 没有定义 VP 字段 Validity Period VPF Format 有效期格式 01 加强型的 VP 格式 10 相对 VP 格式，VP 字段包含一个字节 l 11 绝对 VP 格式，VP 字段包含 7 个字节 More Messages to 0 短消息中心有更多消息等待移动台 te MMS Send 更多短消息消 息发送 1 短消息中心没有更多消息等待移动台 c l 通知服务中心接收短消息，即使该短消息和前一条 ue tia RejectDuplicates重 RD 复信元丢弃 0 短消息有相同的 OA，DA 和 MR 通知服务中心丢弃短消息，如果它和前一条短消息 1 有相同的 OA，DA 和 MR。 在这种情况下，适当 Q n 的 FCS 值将返回到 SMS-SUBMIT-REPORT e Message Type MTI Indicator 信息类型 fid 指示 00 SMS-Deliver（从 SC 到 MS） 01 SMS-Submit（从 MS 到 SC） 10 SMS-Status Report（从 SC 到 MS） 10 SMS-Command（从 MS 到 SC） SMS-Submit 的 示例: n 在文本模式中发送短消息时，我们需要在+CSMP中设置为17或49。下面看看他们的含 o 义： Bit 7 6 C&b &h &d 5 4 3 2 1 0 RP UDHI SRR VPF RD MTI 0 0 0 10 0 00010001 11 17 没有用户 不需要状 VP 相对格 数据头 态报告 式 01 SMS-Submit 0 0 1 10 0 00110001 31 49 没有用户 需要状态 VP 相对格 数据头 报告 式 01 SMS-Submit 3.5.4.5. Message Reference 消息参考值 MR是一个0到255的整数，代表移动台提交短消息到服务中心的参考号，以确认接收的 上海移远通信技术有限公司 30 GSM 短消息应用指导 短消息是否重复。 3.5.4.6. Protocol Identifier 协议标识 表 29： value &h &d 00 0 01 1 Protocol SMS 被当成短消息 SMS 被当成电报 3.5.4.7. Data Coding Scheme 数据编码方案 占一个字节，定义用户数据（UD）的编码方式，可指示短消息类型，字符集等。 详细请参考[3]GSM03.38。 表 30： l bit7-4 uecte tial 00xx (general data Q n coding indication) onfide 1111 C(data coding 5 4 3 2 1 0 含义 0 1 0 文本未压缩 文本使用 GSM 标准压缩算法进行压缩 bit 1,0 被保留，没有短消息类型定义 1 bit 1,0 定义短消息类型 0 0 GSM 默认字符集 0 1 8 bit 字符表 1 0 UCS2 （16 bit） 1 1 保留 0 0 class 0 立即显示 0 1 class 1 default meaning: ME specific 1 0 class 2 SIM message 1 1 class 3 default meaning：TE specific 0 保留 0 GSM 默认字符集 1 8 bit 字符表 0 0 class 0 立即显示 message class) 0 1 class 1 default meaning：ME specific 1 0 class 2 SIM specific message 1 1 class 3 default meaning：TE specific 短消息类型指示了短消息被接收时如何存储。Class 0短消息将被直接显示在目标终端， 不存储。如果客户想存储Class 0短消息，可以使用命令+QCLASS0。 GSM默认字符集指示用户数据按照7-bit alphabet进行编码。 示例： &b &h &d 字符编码 短消息类型 上海移远通信技术有限公司 31 GSM 短消息应用指导 00000000 00 00001000 08 00011000 18 00011001 19 11110000 F0 11110001 F1 0 7-bit 8 UCS2 24 UCS2 25 UCS2 240 7-bit 241 7-bit no class no class class 0 （immediate display） class 1 （ME-specific） class 0 （immediate display） class 1 （ME-specific） 在文本模式下，命令+CSMP中的采用对应的十进制数表示。 3.5.4.8. Validity Period 有效期 有效期表示短消息在短消息服务中心能存放多久。它的格式在的中 定义。 当是相对格式时（=10&b），占用一个字节，表示服务中心从收到 短消息到丢弃短消息的最长时间。 l 表 31： 相对格式 te 取值 &h c l 00~8F &d 0 ~ 143 ue tia 90~A7 144~167 A8 ~ C4 C5 ~ FF 168 ~ 196 197 ~ 255 有效期含义 （VP+1)*5 分钟 12 小时 + （VP-143)*30 分 钟 （VP-166)*1 天 （VP-192)*1 周 5 分钟 ~ 12 小时 12.5 小时 ~ 24 小时 2 天 ~ 30 天 5 周 ~ 63 周 Q en 在文本模式下，命令+CSMP中的采用对应的十进制数表示。 fid 当是绝对时间时（=11&b）， 占用7个字节，表示短消息服务中心 丢弃短消息的绝对时间，即到期时间，这个时间的表示形式和TP-SCTS（Service Center Time Stamp）相同。 on 3.5.4.9. Service Centre Time Stamp 服务中心时间戳 C 表示服务中心收到短消息的时间，它用下面的形式表示： 表 32： 年 月 日 时 分 秒 时区 数字（半个字节） 2 2 2 2 2 2 2 示例 01 80 12 41 14 80 23 时 区 表 示 本 地 时 间 和 GMT 时 间 的 四 分 之 一 。 上 面 的 例 子 表 示 的 时 间 为 10-08-21 14:41:08+32, GMT +08。 3.5.4.10. Discharge Time 丢弃时间 在状态报告中使用，指示前面提交的短消息被处理的时间，可能是被成功转交， 上海移远通信技术有限公司 32 GSM 短消息应用指导 或已经尝试转交到目标地址，或被服务中心丢弃。 3.5.4.11. Length of User Data 用户数据长度 UDL 指示 UD 的长度。它取决于的设置。 每个字符占的位 bit 数 SMS UDL 含义 Default（GSM 7 字符数 7-bit） 8-bit data 8 八位字节数 UCS2 16 八位字节数 字符集 见[3]GSM03.38 用户定义 ISO/IEC10646 'Universal Multiple-Octet Coded Character Set （UCS）' 备注： 对 GSM 7-bit 编码，UDL 等于字符数，和八位字节数可能不一致。 l 3.5.4.12. User Data 用户数据 如果 等于 0 （没有头信息），且数据没被压缩，最大的单条短消息内容 te 长度为 160 个 7-bit 编码的字符，140 个 8-bit 编码字符，或者 70 个 16-bit 编码字符，即最 长 1120 bits = 160*7 = 140*8 = 70*16。 uec tial 普通的英文字符都可以在 GSM 默认字符表中找到（见[3]GSM 03.08 subclause 6.2.1 Default alphabet 或本文附录 5.3），因此他们可以用 GSM 7-bit 编码的方式进行编码。而对其 他语言中的字符，比如中文、阿拉伯语、韩语、日语等，必须采用 16-bit 编码的 UCS2 格式。 Q n 对点对点短消息的 7-bit 字符编码请参考[3]GSM 03.08 subclause 6.1.2.1.1。下面举个例 e 子。 fid 示例：短消息 7-bit 字符编码 用户数据：12345678 字符 1 n GSM 编码（hex） 31 o GSM 编码（bit） C 将字符最后几位转移到前一 0110 001 0011 2 32 0110 010 1101 3 33 0110 011 1000 4 34 0110 100 0101 5 35 0110 101 1011 6 36 0110 110 1101 7 37 0110 111 0111 8 38 0111 000 个字符 0001 1001 1100 0110 0011 1101 0000 结果（hex） 31 D9 8C 56 B3 DD 70 因此，用户数据'12345678'被编码后 UD ='31D98C56B3DD70'，UDL=8 （8 个字符， 被编成 7 个字节数据） 3.5.4.13. Status 状态 当需要状态报告时，ST 指示前面提交的短消息 SMS-SUBMIT 的状态。 它占用一个字 节。如果等于'00'&h，表示短消息被成功接收了。 上海移远通信技术有限公司 33 GSM 短消息应用指导 3.6. PDU 模式示例 用户可以根据下面的示例在PDU模式下发送中英文短消息。 3.6.1. 发英文短消息（GSM 编码），不需状态报告 示例：发送'Hello' 到 +8613795403834 发送端: +8613651979176 接收端: +8613795403834 //步骤 1：核对短消息服务中心号 //步骤 1：核对短消息服务中心号 AT+CSCS='GSM' // 设 置 TE 字 符 集 为 AT+CSCS='GSM' 'GSM' OK OK AT+CSCA? AT+CSCA? //查询短消息中心号。对上海的中国 l 移动，短消息中心号为 '+8613800210500'。如果这个号码 te 错误，短消息可能发送失败，那么 用命令AT+CSCA= 设置正确 c l 的短消息中心号，并用AT+CSAS保 存设置。 +CSCA: '+8613800210500',145 OK ue tia +CSCA: '+8613800210500',145 OK //步骤 2：设置 PDU 模式 Q n AT+CMGF=0 //设置PDU模式 e OK //步骤 2：设置 PDU 模式和接收短消息的参 数 AT+CMGF=0 //设置PDU模式 OK fidAT+CNMI=2,1,0,0,0 //设置新短消息到达时的提示参 数。第二个参数设成1，获取+CMTI n 提示。 OK o AT+CPMS? C //核对短消息存储空间是否已满， 如果已满，用+CMGD或+QMGDA 删除短消息。 +CPMS: 'SM',1,50,'SM',1,50,'SM',1,50 OK //步骤 3：发送短消息 AT+CMGS=20 > 0011000D91683197453038F400000105C8329 BFD06 上海移远通信技术有限公司 34 GSM 短消息应用指导 +CMGS: 146 OK //PDU含义见备注1 //步骤 3：接收和读短消息 +CMTI: 'SM',2 AT+CMGR=2 +CMGR: 0,,25 0891683108200105F0040D91683156919771F 600000190102191252305C8329BFD06 OK // PDU含义见备注2 备注 1：SMS-SUBMIT PDU 描述 AT+CMGS=20 > 0011000D91683197453038F400000105C8329BFD06 SMS-SUBMIT PDU: l 八位字节数 1-12 1 1 2-12 te 元素 SCA FO MR DA 0,1 or 1 1 1 7 PID DCS VP UDL 0-140 UD c l 示例 0D916831974 C8329B 00 11 00 00 00 01 05 53038F4 FD06 ue tia 20 = 除（11000D91683197453038F400000105C8329BFD06）的字节数 SCA = 00：短消息服务中心地址在+CSCA中设置 Q n FO = 11&h = 17&d：如下 e Bit 7 6 5 4 3 2 1 0 &b &h &d RP UDHI SRR VPF RD MTI fid 00010001 11 17 0 0 0 10 没有用户 不需要状 VP 相对格 数据头 态报告 式 0 01 SMS-Submit n SRR = 0：不需要状态报告 o VPF = 10，VP = 01：有效期为（VP+1）*5 = 10分钟 C DA = 0D91683197453038F4：接收号码 +8613795403834 DCS = 00： GSM 7-bit编码 UDL = 05：字符'Hello'的长度 UD = C8329BFD06： 字符 H e l l o GSM 编码（hex） 48 65 6C 6C 6F GSM 编码（bit） 1001000 1100101 1101100 1101100 1101111 将字符最后几位转移到前一 个字符 11001000 00110010 10011011 11111101 00000110 结果（hex） C8 32 9B FD 06 上海移远通信技术有限公司 35 GSM 短消息应用指导 备注 2：SMS-Deliver PDU描述 AT+CMGR=2 +CMGR：0,,25 0891683108200105F0040D91683156919771F600000190102191252305C8329BFD06 OK SMS-DELIVER PDU: 八位字节数 1-12 1 2-12 1 1 7 1 0-140 元素 SCA FO OA PID DCS SCTS UDL UD 示例 0891683108 0D9168315 04 00 200105F0 6919771F6 0190102 C8329 00 05 1912523 BFD06 SCA = 0891683108200105F0：短消息中心号为 +8613800210500 OA = 0D91683156919771F6：发送端号码 +8613651979176 FO = 04: l Bit 7 6 5 4 3 2 1 0 SMS-Deliver RP UDHI SRI - MMS MTI te 示例 0 0 0 00 01 00 c l UDHI = 0：没有用户数据头 ue tia 3.6.2. 发中文短消息（UCS2 编码），需要状态报告 Q n 示例：发送'您好' （UCS2 编码'60A8597D'）到 +8613795403834 发送端：+8613651979176 接收端： +8613795403834 e //步骤 1：核对短消息服务中心号 //步骤 1：核对短消息服务中心号 fid AT+CSCS='GSM' AT+CSCS='GSM' OK OK AT+CSCA? AT+CSCA? +CSCA: '+8613800210500',145 +CSCA: '+8613800210500',145 on OK //步骤 2：设置 PDU 模式 C AT+CMGF=0 //设置PDU模式 OK //步骤 2：设置 PDU 模式和接收短消息的参 数 OK AT+CMGF=0 //设置PDU模式 AT+CNMI=2,1,0,1,0 OK //要求状态报告需要设置+CNMI 第 AT+CNMI=2,2,0,0,0 四个参数为 1，短消息 PDU 中 //设置新短消息到达时的提示参数。 字段的必须等于 1 第二个参数设成2，获取带短消息内 OK 容的+CMT提示。 OK AT+CPMS? //核对短消息存储空间是否已满，如 果已满，用+CMGD或+QMGDA删 上海移远通信技术有限公司 36 GSM 短消息应用指导 除短消息。 +CPMS: 'SM',2,50,'SM',2,50,'SM',2,50 OK //步骤 3：发送短消息 AT+CMGS=19 > 0031000D91683197453038F40008010460A8 597D +CMGS: 147 OK // PDU含义见备注1 //步骤 3：接收和读取短消息 +CMT: ,24 0891683108200105F0240D91683156919771F 60008019010314241230460A8597D l// PDU含义见备注2 AT+CPMS? //短消息没被保存 te +CPMS: 'SM',2,50,'SM',2,50,'SM',2,50 c l OK ue tia //步骤4: 获取状态信息 +CDS: 26 0891683108200105F006930D9168319745303 Q n 8F4019010314291230190103142912300 // PDU 含义见备注 3 e 备注 1：SMS-SUBMIT PDU 描述 fid AT+CMGS=19 > 0031000D91683197453038F40008010460A8597D n SMS-SUBMIT PDU: 八位字节数 1-12 1 1 2-12 1 1 0,1 or 7 1 0-140 o 元素 SCA FO MR DA PID DCS VP UDL UD C 示例 0D91683197 60A85 00 31 00 00 08 01 04 453038F4 97D 19 =除（31000D91683197453038F40008010460A8597D）的字节数 SCA = 00：短消息服务中心号在+CSCA设置。 FO = 31&h = 49&d：如下 Bit 7 6 5 &b &h &d RP UDHI SRR 4 3 2 VPF RD 1 0 MTI 0 0 1 10 0 01 00110001 31 49 没有用户 需要状态 数据头 报告 VP 相对格式 SMS-Submit 上海移远通信技术有限公司 37 GSM 短消息应用指导 SRR = 1：要求状态报告 VPF = 10，VP = 01：有效期（VP+1）*5 = 10分钟 DA = 0D91683197453038F4：接收端+8613795403834 DCS = 08： UCS2编码。 UDL = 04：用户数据（'60A8597D'）字节数 UD = 60A8597D： '您好'的UCS2编码 备注 2：SMS-Deliver PDU 描述 +CMT：,24 0891683108200105F0240D91683156919771F60008019010314241230460A8597D SMS-DELIVER PDU: 八位字节数 元素 示例 1-12 1 2-12 1 1 7 SCA FO OA PID DCS SCTS 089168310 0D9168315 24 00 8200105F0 6919771F6 0190103 08 1424123 1 UDL 04 0-140 UD 60A85 97D tel 24 = 除（240D91683156919771F60008019010314241230460A8597D）的字节数 SCA = 0891683108200105F0：短消息服务中心号 +8613800210500 c l OA = 0D91683156919771F6：发送端号码 +8613651979176 FO = 24：如下 ue tia Bit 7 6 5 4 3 2 1 0 SMS-Deliver RP UDHI SRI - MMS MTI 示例 0 0 1 00 01 00 Q en UDHI= 0：没有用户数据头 SRI = 1：一个状态报告将返回 SME fid 备注 3：SMS-Status Report PDU 描述 +CDS：26 n 0891683108200105F006930D91683197453038F4019010314291230190103142912300 o SMS-Status Report PDU: C 八位字节数 1-12 1 1 2-12 7 7 1 元素 SCA FO MR RA SCTS DT ST 示例 0891683108 06 200105F0 0D91683197453 01901031 01901031 93 00 038F4 429123 429123 26 = 除（06930D91683197453038F4019010314291230190103142912300）的字节 数 SCA = 0891683108200105F0：短消息服务中心地址 +8613800210500 MR = 93 &h = 147：消息参考值，和发送命令+CMGS的返回值一致 RA = 0D91683197453038F4：接收号 +8613795403834 ST = 0：短消息已被接收。 上海移远通信技术有限公司 38 GSM 短消息应用指导 FO = 06：如下 Bit 7 SMS-Status RP report 示例 0 6 5 4 3 2 1 0 UDHI SRQ - MMS MTI 0 0 00 01 10 UDHI = 0：没有用户数据头 SRQ = 0：该短消息报告时 SMS-Submit 提交的结果 CQouneficdteenl tial 上海移远通信技术有限公司 39 GSM 短消息应用指导 4. 短消息相关的其他命令 4.1. 保存和恢复短消息设置 设置+CSCA 和+CSMP 可以通过命令 +CSAS 保存到 SIM 卡，通过命令+CRES 恢复。 其它命令保存情况见下节 4.1.3。 4.1.1. 保存短消息设置（+CSAS） 表 33：AT+CSAS 语法 命令 AT+CSAS=? l AT+CSAS=[] 可能的返回结果 +CSAS: (取值列表) OK ERROR 示例 +CSAS: (0-3) cte l 参数： 0-3 设置被保存的配置号，和制造商有关 ue tia 设置命令将以下设置的当前值保存到永久存储器。TA 可以有几个配置号用于 保存设置。 Q n 1） 短消息服务中心号+CSCA 2） +CSMP 的参数 fide 4.1.2. 恢复短消息设置（+CRES) 表 34：AT+CRES 语法 n 命令 o AT+CRES=? C AT+CRES=[] 可能的返回结果 +CRES: (取值列表) OK ERROR 示例 +CRES: (0-3) TA 将永久存储器中指定配置号的短消息设置恢复成当前设置。 4.1.3. 其他短消息设置的保存 +CPMS 被自动保存。 +QCLASS0 和+QSMSCODE 不允许保存。 下列设置可以用 AT&W 保存，用 ATZ 命令恢复，用 AT&F 回到出厂设置： 1） +CMGF 2） +CNMI 3） +CSDH 上海移远通信技术有限公司 40 GSM 短消息应用指导 4） +CSCS 4.2. 长短消息 Concatenated short message 移远模块提供长短消息功能。 在文本模式下，用户可以收发长短消息，长短消息发送 时被拆分成 1~5 条短消息，接收时这几条短消息被合并起来显示。短消息 PDU 将在中 设置 UDHL 为 1，并在 UD 字段加入头信息表示这几条短消息的关系。 详细信息请参考 [4]GSM 03.40 subclause 9.2.3.24.1。 示例： //发送长短消息 AT+CMGF=1 //设置文本模式 OK AT+CSCS='GSM' //设置 TE 字符集为'GSM' OK l AT+CSMP=17,167,0,241 //设置文本模式下发送短消息的参数 OK te AT+CMGS='13795403834' > Focusing on the wireless M2M market sector, Quectel designs and manufactures variety c l wireless modules to fulfill different industrial standards and requirements. The Quectel products have been applied in the wireless M2M sectors like telematics, telemetry, remote ue tia control and monitoring, fleet management, wireless POS, security, healthcare, etc. //短消息长度为 347 个字符，超过了单条短消息长度 152。因此发送时被分成 3 条短消息 （152+152+43）。 Q n +CMGS: 156 e OK fid //接收长短消息 +CMTI: 'SM',3 //收到 3 条短消息，被保存到 SIM 卡。 n +CMTI: 'SM',4 Co +CMTI: 'SM',5 AT+CMGF=1 OK AT+CMGR=3 +CMGR: 'REC UNREAD','+8613651979176','','2010/09/01 15:01:54+32' Focusing on the wireless M2M market sector, Quectel designs and manufactures variety wireless modules to fulfill different industrial standards and requirements. The Quectel products have been applied in the wireless M2M sectors like telematics, telemetry, remote control and monitoring, fleet management, wireless POS, security, healthcare, etc. //读第一个 index 短消息时，三条短消息被合并显示。. OK 上海移远通信技术有限公司 41 GSM 短消息应用指导 AT+CMGR=4 +CMGR: 'REC READ','+8613651979176','','2010/09/01 15:01:52+32' irements. The Quectel products have been applied in the wireless M2M sectors like telematics, telemetry, remote control and monitoring, fleet management //长短消息的第二条，152 个字符 OK AT+CMGR=5 +CMGR: 'REC READ','+8613651979176','','2010/09/01 15:01:54+32' , wireless POS, security, healthcare, etc. //长短消息的第三条，43 个字符 OK AT+CMGD=3 //如果删除了第一个 index 短消息，同属于一条长短消息的三条短消息都被删除 OK AT+CPMS? +CPMS: 'SM',2,50,'SM',2,50,'SM',2,50 l OK cte l 4.3. 存储 Class0 短消息（+QCLASS0） ue tia 一般情况下 class 0（中设置）短消息内容会在终端立即显示。通过命令+QCLASS0 就可以存储 class 0 短消息。 Q n 表 35：AT+QCLASS0 语法 e 命令 可能的返回结果 fid AT+QCLASS0=? +QCLASS0: (0, 1) AT+QCLASS0? n AT+QCLASS0=[] +QCLASS0: OK ERROR o 参数取值： C0 不能将收到的 class0 短消息存储到（默认） 1 允许将收到的 class0 短消息存储到 示例： //发送class 0 短消息 AT+CMGF=1 //设置文本模式 OK AT+CSCS='GSM' //设置 TE 字符集为'GSM' OK AT+CSMP=17,167,0,240 //设置文本模式下发送短消息的参数。 上海移远通信技术有限公司 42 GSM 短消息应用指导 =240 表示短消息类型为 class 0 OK AT+CMGS='13795403834' >TEST CLASS0 MESSAGE +CMGS: 160 OK //当 QCLASS0=0 时接收 class 0 短消息 AT+QCLASS0? +QCLASS0: 0 OK AT+CMGF=1 OK AT+CNMI? l +CNMI: 2,1,0,0,0 te OK c l +CMT: '+8613651979176',,'2010/09/01 15:35:34+32' ue tia TESTCLASS0MESSAGE //短消息内容直接显示，不保存 //当 QCLASS0=1 时接收 class 0 短消息 (发送的短消息和上面相同) AT+QCLASS0=1 Q n OK e +CMTI: 'SM',3 //短消息被保存 fid AT+CMGR=3 +CMGR: 'REC UNREAD','+8613651979176','','2010/09/01 15:37:56+32' TEST CLASS0 MESSAGE Con OK 4.4. 配置短消息编码模式（+QSMSCODE） 有一些特殊字符不包含在 GSM 字符表中。命令+QSMSCODE 用于在文本模式下对特殊 字符进行 GSM 7-bit 编码。 表 36：AT+QSMSCODE 语法 命令 可能的返回结果 AT+QSMSCODE=? +QSMSCODE:(0,1) AT+QSMSCODE? +QSMSCODE: 上海移远通信技术有限公司 43 GSM 短消息应用指导 AT+QSMSCODE= OK ERROR 参数取值： 0 NOKIA 编码模式 1 SIEMENS 编码模式（默认） 备注：  在使用这个命令之前请设置 AT+CMGF=1，AT+CSCS='GSM'， （+CSMP）为 GSM-7-bit 编码。  对发送端和接收端使用相同设置。  该命令还是不能保证所有特殊字符都显示正确。最好使用 UCS2 编码。 4.5. 短消息满提示（+QEXTUNSOL） l AT+QEXTUNSOL 可以用来提供附加的非请求指示。用户可以用这个命令获取短消息 满的提示。 cte l AT+QEXTUNSOL='SM' , 表示附加的短消息信息。 附加信息通过下面的 URC 显示： ue tia +TSMSINFO: 根据 AT+CMEE 的设置显示错误号或错误字符串。 参数： Q n 0 e 1 2 禁用（默认） 启用 查询 fid 示例: AT+QEXTUNSOL='SM',1 n OK AT+CPMS? Co +CPMS: 'SM',49,50,'SM',49,50,'SM',49,50 OK +CMTI: 'SM',50 //短消息满，得到下面提示 +TSMSINFO: 322 //短消息满 //重启模块 +TSMSINFO: 322 //短消息满 +TSMSINFO: 3513 //SIM 卡有未读短消息 上海移远通信技术有限公司 44 GSM 短消息应用指导 5. 附录 5.1. 短消息写和发流程 请参考[2]GSM 07.05 clause 3 Figure 4。 CQouneficdteenl tial 上海移远通信技术有限公司 45 5.2. 短消息接收流程 请参考[2]GSM 07.05 Clause 3 Figure 3。 Quectenl tial 5.3.默认的GSM字母表 Confide 请参考[3]GSM 03.08 subclause 6.2.1 Default alphabet。 上海移远通信技术有限公司 -46- GSM 短消息应用指导 CQouneficdteenl tial 上海移远通信技术有限公司 47 GSM 短消息应用指导 上海移远通信技术有限公司 上海移远通信技术有限公司 上海市田州路 99 号 9 幢 501 室 200233 电话: +86 21 5108 2965 电子邮箱: info@quectel.com 48

Fitness Low Power Application Note GNSS Module Series Rev. Fitness_Low_Power_Application Note_V1.0 Date: 2015-08-21 www.quectel.com GNSS Module Series Fitness Low Power Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. THE INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. Fitness_Low_Power_Application_Note Confidential / Released 1 / 9 GNSS Module Series Fitness Low Power Application Note About the Document History Revision 1.0 Date CQouneficdteenl tial 2015-08-21 Author Connie ZHOU Description Initial Fitness_Low_Power_Application_Note Confidential / Released 2 / 9 GNSS Module Series Fitness Low Power Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 1 Introduction .......................................................................................................................................... 4 2 Power Consumption ............................................................................................................................ 5 3 Quectel NMEA Packet Protocol.......................................................................................................... 6 3.1. Quectel NMEA Packet Format .................................................................................................. 6 3.2. Packet Type: PQBAUD Set NMEA Port Baudrate.................................................................. 6 3.3. Packet Type: PQFLP Set the Module into FLP Mode ............................................................ 7 CQouneficdteenl tial 4 Enter into or Exit from FLP Mode.......................................................................................................9 Fitness_Low_Power_Application_Note Confidential / Released 3 / 9 GNSS Module Series Fitness Low Power Application Note 1 Introduction Fitness low power (FLP) is an optimized solution for wearable, fitness and tracking device. It provides a FLP mode for Quectel GPS modules to reduce power consumption with tiny accuracy trading-off. The FLP mode can be easily set by using a specific message. In FLP mode, the module has good route consistence in walking and running scenarios, and can switch dynamic duty operation automatically. It will come back to normal mode in difficult environment to keep good accuracy as well, thus realizing maximum performance with the lowest power consumption. CQouneficdteenl tial This document is applicable to Quectel GPS modules. Fitness_Low_Power_Application_Note Confidential / Released 4 / 9 GNSS Module Series Fitness Low Power Application Note 2 Power Consumption The average current for FLP mode is only 5mA in static receiving, which is about 40% of normal mode. The power consumption may increase a little bit in dynamic scenario. The average current in different open sky scenarios for FLP mode and normal mode is shown in the table below. Table 1: Average Current for FLP Mode and Normal Mode Scenario Static l Walking te Running CQouneficdential Driving In FLP Mode (mA) 5.036 5.374 5.469 8.479 In Normal Mode (mA) 12.783 12.249 12.975 12.663 Fitness_Low_Power_Application_Note Confidential / Released 5 / 9 GNSS Module Series Fitness Low Power Application Note 3 Quectel NMEA Packet Protocol This chapter introduces the Quectel NMEA packet protocol, which is a set of extension messages of the standard NMEA packet protocol. This message is used to control the module to enable or disable FLP mode. The following table shows the structure of a Quectel NMEA packet. 3.1. Quectel NMEA Packet Format Preamble TalkerID PktType DataField * CHK1 CHK2 CR LF tel *The maximum length of each packet is restricted to 255 bytes. c l Packet Contents: ue tia  Preamble: One byte character: ‘$’  TalkerID: Two bytes character string: 'PQ' Q n  PktType: 1-10 bytes character string. An identifier used to tell the decoder how to decode the packet. e  DataField: The DataFileld has variable length depending on the packet type. A command symbol ‘,’ must be inserted ahead of each data field to help the decoder to process the DataField. fid  * : 1 byte character. The star symbol is used to mark the end of DataField.  CHK1,CHK2: Two bytes character string. CHK1 and CHK2 are the checksum of the data between n Preamble and ‘*’. Co  : Each NMEA message ends with ‘CR’ and ‘LF’. 3.2. Packet Type: PQBAUD Set NMEA Port Baudrate PQBAUD Set NMEA Port Baudrate Write Command $PQBAUD,W,*Checksu m Response $PQBAUD,W,OK*Checksum If error: Fitness_Low_Power_Application_Note Confidential / Released 6 / 9 Reference GNSS Module Series Fitness Low Power Application Note $PQBAUD,W,ERROR*Checksum Parameter NMEA port baudrate Could be set to 4800, 9600,14400,19200, 38400, 57600, 115200 Example $PQBAUD,W,115200*43 //Set NMEA port baudrate as 115200 $PQBAUD,W,OK*40 // Set successfully NOTES l 1. The command will be effective immediately after setting. te 2. Parameter is automatically saved. uec tial 3.3. Packet Type: PQFLP Set the Module into FLP Mode Q n PQFLP Set the Module into FLP Mode e Write Command $PQFLP,W,,*Checksu fid m n Read Command o $PQFLP,R, *Checksum Response $PQFLP,W,OK*Checksum If error: $PQFLP,W,ERROR*Checksum Response $PQFLP,R,*Checksum C Reference Parameter Module operation mode 0 Normal mode 1 FLP mode Save operation 0 Parameter is not saved, ineffective after restart 1 Parameter is saved in flash, effective after restart Fitness_Low_Power_Application_Note Confidential / Released 7 / 9 Example $PQFLP,W,1,1*20 $PQFLP,W,OK*08 $PQFLP,R*25 $PQFLP,R,1*38 GNSS Module Series Fitness Low Power Application Note //Switch to FLP mode //Set successfully //Query the working mode //The modules is in FLP mode NOTE The command will be effective immediately after setting. CQouneficdteenl tial Fitness_Low_Power_Application_Note Confidential / Released 8 / 9 GNSS Module Series Fitness Low Power Application Note 4 Enter into or Exit from FLP Mode You can follow the steps below to enter into or exit from the FLP mode: Step 1: Download new FW to the module, then the module is still in normal mode; Step 2: Send the command $PQBAUD,W,115200*43, and the module responds $PQBAUD,W,OK*40 which indicates the command is executed successfully; Step 3: Send the command $PQFLP,W,1,1*20, and the module responds $PQFLP,W,OK*08 which indicates the command is executed successfully; Step 4: Wait for at least 5 minutes for the module to completely enter into FLP mode; l Step 5: You can send the command $PQFLP,W,0,1*21 and $PQFLP,W,OK*08 is returned, the module te will exit from the FLP mode. c l NOTES ue tia 1. It is recommended that some necessary commands are set before the module enters into FLP mode. If you need to send commands, please exit from FLP mode first. 2. When the module enters into FLP mode, 1PPS function will not be supported. Q n 3. When the module enters into FLP mode, EASY function was disabled. You can send command to e enable EASY function after the module exits from the FLP mode. 4. When the FLP mode is enabled, the SBAS will be affected. fid 5. High dynamic performance will have a little impact on FLP mode. 6. The module supports 4800bps~115200bps baud rate and 1HZ-10HZ frequency. It is recommended that 115200bps baud rate and 1HZ frequency are set before the module enters into FLP mode. n 7. The modules will automatically come back to the normal mode in difficult environment to keep good Co accuracy. Fitness_Low_Power_Application_Note Confidential / Released 9 / 9

Quectel Cellular Engine GSM Multiplexer Application Note GSM_MUX_AN_V1.1 GSM Multiplexer Application Note Document Title Version Date Status Document Control ID GSM Multiplexer Application Note 1.1 2015-04-08 Release GSM_MUX_AN_V1.1 General Notes Quectel offers this information as a service to its customers, to support application and engineering efforts that use the products designed by Quectel. The information provided is based upon requirements specifically provided to Quectel by the customers. Quectel has not undertaken any independent search for additional relevant information, including any l information that may be in the customer’s possession. Furthermore, system validation of this te product designed by Quectel within a larger electronic system remains the responsibility of the customer or the customer’s system integrator. All specifications supplied herein are c l subject to change. ue tia Copyright This document contains proprietary technical information which is the property of Quectel Limited., copying of this document and giving it to others and the using or communication of Q n the contents thereof, are forbidden without express authority. Offenders are liable to the e payment of damages. All rights reserved in the event of grant of a patent or the registration of a utility model or design. All specification supplied herein are subject to change without fid notice at any time. Con Copyright © Shanghai Quectel Wireless Solutions Co., Ltd. 2015 GSM_MUX_AN_V1.1 - 1 - GSM Multiplexer Application Note Contents 0. Revision history ............................................................................................................................5 1. Introduction...................................................................................................................................6 1.1. Reference.............................................................................................................................6 1.2. Terms and abbreviations......................................................................................................7 2. Quectel Multiplexer Design Purpose ............................................................................................8 2.1. Architecture Diagram..........................................................................................................8 2.2. Restrictions..........................................................................................................................9 3. Quectel Multiplexer Protocol......................................................................................................10 3.1. Transmission Frame Structures .........................................................................................10 3.1.1. Opening and Closing Flag Field..............................................................................10 3.1.2. Address Field ..........................................................................................................10 3.1.3. Control Field ........................................................................................................... 11 3.1.4. Length Field ............................................................................................................ 11 3.1.5. Information Field ....................................................................................................12 l 3.2. Frame Type........................................................................................................................12 3.2.1. SABM .....................................................................................................................12 te 3.2.2. UA...........................................................................................................................12 c l 3.2.3. DISC........................................................................................................................13 3.2.4. DM ..........................................................................................................................13 ue tia 3.2.5. UIH..........................................................................................................................13 3.2.6. UI ............................................................................................................................13 3.3. DLC Establishment ...........................................................................................................13 Q n 3.4. Closing Down DLC...........................................................................................................13 3.5. Control channel .................................................................................................................14 e 3.5.1. PSC..........................................................................................................................14 fid 3.5.2. CLD.........................................................................................................................15 3.5.3. Test ..........................................................................................................................15 3.5.4. MSC ........................................................................................................................15 3.5.5. FCoff .......................................................................................................................16 n 3.5.6. FCon........................................................................................................................16 o 3.5.7. PN, NSC, RPN, RLS, SNC .....................................................................................17 3.6. Data Channel.....................................................................................................................17 C3.7. About Flow Control...........................................................................................................17 3.8. Samples for Frame Structure .............................................................................................17 3.9. Transmission bit sequence.................................................................................................18 4. Examples.....................................................................................................................................19 4.1. Establish Channels ............................................................................................................19 4.2. Frame Transmission ..........................................................................................................22 4.3. Power Saving Mode and Wake Up....................................................................................23 4.4. Flow Control .....................................................................................................................24 4.5. Synchronization.................................................................................................................25 4.6. Closing Down Multiplexers ..............................................................................................26 GSM_MUX_AN_V1.1 - 2 - GSM Multiplexer Application Note Table Index TABLE 1: REFERENCE..........................................................................................................................6 TABLE 2: TERMS AND ABBREVIATIONS ......................................................................................... 7 CQouneficdteenl tial GSM_MUX_AN_V1.1 - 3 - GSM Multiplexer Application Note Figure Index FIGURE 1: QUECTEL MULTIPLEXER ARCHITECTURE DIAGRAM ............................................. 8 FIGURE 2: UA FRAME IS THE RESPONSE ...................................................................................... 12 CQouneficdteenl tial GSM_MUX_AN_V1.1 - 4 - GSM Multiplexer Application Note 0. Revision history Revision 1.0 1.1 Date Author 2009-06-27 Jay XIN 2015-04-08 Thomas ZHANG Description of change Initial Added applicable modules CQouneficdteenl tial GSM_MUX_AN_V1.1 - 5 - GSM Multiplexer Application Note 1. Introduction The present document describes the Quectel multiplexer protocol and the technical details of how to make use of it. This document is applicable to all Quectel GSM modules. 1.1. Reference Table 1: Reference SN Document name [1] M10_ATC_V1.00 CQouneficdteenl tial [2] GSM07.10version7.1.0Release1998 Remark GSM_MUX_AN_V1.1 - 6 - GSM Multiplexer Application Note 1.2. Terms and abbreviations Table 2: Terms and abbreviations Abbreviation Description CLD Multiplexer Close Down DISC Disconnect (DISC) command DLC Data Link Connection DLCI Data Link Connection Identifier DM DV FC FCoff FCon IC MS MSC NSC PN PSC RLS RPN RTC RTR SABM SNC TE UA UI UIH Disconnected Mode Data Valid Flow Control Flow Control Off Command Flow Control On Command l Incoming Call Indicator te Mobile Station Modem Status Command c l Non Support Command ue tia ParameterNegotiation Power Saving Control Remote Line Status Command Q n Remote Port Negotiation Ready To Communicate e Ready To Receive Set Asynchronous Balanced Mode fid Service Negotiation Command Terminal Equipment Unnumbered Acknowledgement n Unnumbered Information command and response CoUnnumbered information with header check (UIH) command and response GSM_MUX_AN_V1.1 - 7 - GSM Multiplexer Application Note 2. Quectel Multiplexer Design Purpose A device using GPRS or GSM data may wish to receive and transmit multiple streams of data simultaneously. These are Command data (AT commands), GPRS data and GSM circuit switched data (CSD). These streams are essentially independent to one another. As to the non-multiplexer device, it is so inefficient to deal with only one kind or one channel of data steam during a period of time. Therefore, Quectel multiplexer is designed with GSM0710 standard to separate transmission device layer into several logic channels (DLC) in order to transmit data simultaneously. Each channel has its own buffer management and flow control mechanism. 2.1. Architecture Diagram tel Quectel multiplexer architecture diagram is as following: c l Quectel Multiplexer ue tia D D D D Q n L L L L C C C C e 1 2 3 4 fid Transmission Device Layer (Serial Port) onMultiplexed data C streams Client Application Figure 1: Quectel multiplexer architecture diagram Quectel Multiplexer is established upon system transmission device layer (Commonly serial port). GSM_MUX_AN_V1.1 - 8 - GSM Multiplexer Application Note Data streams are addressed with DLCI value and encapsulated in frames based on GSM 0710 protocol (Chapter 3, Quectel Multiplexer Protocol) and transmitted through interface provided by transmission device layer. 2.2. Restrictions  DC1/XON and DC3/XOFF flow control is not supported.  Error Recovery Mode is not supported.  PN, NSC, RPN, RLS, SNC message frames are not supported.  All the system parameters defined in GSM 0710 are set to default as following table. Parameter Value Comment T1 (Acknowledgement Timer) 100 milliseconds N1 127 l (Maximum Frame Size) te N2 c l (Maximum number of retransmissions) ue tia T2 (Response Timer for multiplexer control channel) Q n T3 e (Response Timer for wake-up procedure) 3 300 milliseconds 10 seconds fid K N/A n (Window Size)  UI Frames are not supported. Co  Only supports GSM 0710 Basic Option. Time that a station will wait for an acknowledgement before resorting to other action Maximum number of octets that that may be contained in an information field Not used Not used Amount of time the transmitting station of a power wake-up command waits before raising an alarm when no response is received Not used GSM_MUX_AN_V1.1 - 9 - GSM Multiplexer Application Note 3. Quectel Multiplexer Protocol Quectel Multiplexer protocol provides a data transmission mechanism by establishing DLC between TE and MS. Several DLC can be set up. Each one is independent to one another and has its own management of buffer and flow control. All information transmitted between the TE and MS is conveyed in frames. 3.1. Transmission Frame Structures The frame structure is composed of an opening and a closing flag, an address field, a control field, a length field, an information field and FCS field. Please see following table. Opening l Flag 1 byte Address Field 1 byte Control Field 1 byte Length Field 1 byte Information FCS Field Field Multi-byte 1 byte Closing Flag 1 byte cte l 3.1.1. Opening and Closing Flag Field ue tia Each frame begins and ends with a flag sequence octet which is defined as a constant bit pattern 0xF9. Q en 3.1.2. Address Field fid The address field consists of a single octet. It contains the Data Link Connection Identifier (DLCI), the C/R bit and the address field extension bit (EA) as following table. on1 2 Bit 3 4 5 67 8 CEA CR DLCI The range of the address field may be extended by use of the EA bit. When the EA bit is set to 1 in an octet, it signifies that this octet is the last octet of the address field. When the EA bit is set to 0, it signifies that another octet of the address field follows. Quectel multiplexer only supports one address octet so the EA bit is always set to 1. The C/R (command/response) bit identifies the frame as either a command or a response. The DLCI is used to identify an individual data stream as well as channels between TE and MS. Multiple DLCIs shall be supported but the number is implementation-specific. The DLCIs are GSM_MUX_AN_V1.1 - 10 - GSM Multiplexer Application Note dynamically assigned. 3.1.3. Control Field The content of the control field defines the type of frame. The control fields of the frames used in the present document are described in the following table. Bit 12 3 4 5 6 7 8 HEX[1] Frame Type Comment Set Asynchronous 1 1 1 1 P/F 1 0 0 0x2F SABM 1 1 0 0 P/F 1 1 0 l 1 1 1 1 P/F 0 0 0 te 1 1 0 0 P/F 0 1 0 0x63 UA 0x0F DM 0x43 DISC c l 1 1 1 1 P/F 1 1 1 0xEF UIH ue tia 1 1 0 0 P/F 0 0 0 0x03 UI Q n Note: Hex value does not count the bit 5 value. Balanced Mode Unnumbered Acknowledgement Disconnected Mode Disconnect Unnumbered Information with Header check Unnumbered Information(Not supported) fide 3.1.4. Length Field n This field is present only in case when basic option is activated. Bit o 1 2 3 4 5 6 7 8 C EA L1 L2 L3 L4 L5 L6 L7 The L1 to L7 bits indicates the length of the following data field. The range of the length field may be extended by use of the EA bit. When the EA bit is set to 1 in an octet, it signifies that this octet is the last octet of the length field. When the EA bit is set to 0, it signifies that a second octet of the length field follows. Quectel multiplexer only supports one length octet so the EA bit is always set to 1. Note: Length field should always be contained in each frame even though information field is empty. GSM_MUX_AN_V1.1 - 11 - GSM Multiplexer Application Note 3.1.5. Information Field The information field is the payload of frame and carries the user data information (e.g. AT Command and PPP data packet). The field is octet structured. The information field is only present in UIH frames. 3.2. Frame Type 3.2.1. SABM SABM is command frame and shall be used to establish DLC between TE and MS. 3.2.2. UA tel UA frame is the response to SABM or DISC frame. Please see following diagram. Quec ential MS fid Quectel Con Multiplexer SABM (Set up DLC 1) UA (Response) DISC (Close DLC 1) TE Client Receiver UA (Response) Figure 2: UA frame is the response GSM_MUX_AN_V1.1 - 12 - GSM Multiplexer Application Note 3.2.3. DISC DISC is command frame and shall be used to close down DLC. Prior to acting the command, the receiving station shall confirm the acceptance of the DISC command by the transmission of a UA response. Please see the diagram above. 3.2.4. DM The DM response frame shall be used to report a status whether the station is logically disconnected from the data link. When in disconnected mode no commands are accepted until the disconnected mode is terminated by the receipt of a SABM command. If a DISC command is received while in disconnected mode a DM response should be sent. l 3.2.5. UIH te The UIH command/response shall be used to send user data at either station. uec tial 3.2.6. UI Not Supported. Q en 3.3. DLC Establishment fid The establishment of a DLC will be initiated by the TE. n TE wishing to establish a DLC transmits a SABM frame with the P-bit set to 1. The address field contains the DLCI value associated with the desired connection. If MS is ready to establish the o connection it will reply with a UA frame with the F-bit set to 1. If MS is not ready or unwilling to C establish the particular DLC it will reply with a DM frame with the F-bit set to 1. 3.4. Closing Down DLC The release of a DLC will be initiated from by the transmission of a DISC frame with the P-bit set to 1. Confirmation of the DLC release is signaled by MS sending a UA frame with the F-bit set to 1. Once the DLC has been released the MS enter disconnected mode for that particular DLC. If MS receiving the DISC command is already in a disconnected mode it will send a DM response. GSM_MUX_AN_V1.1 - 13 - GSM Multiplexer Application Note 3.5. Control channel Multiplexer control channel is the basic channel which is used to establish DLC, launch power saving, wake up from power saving and implement flow control mechanism. Control channel is the first channel established at the initiation of the multiplexer between the TE and MS and it has the DLCI value 0. UIH message frame is transmitted through control channel. All UIH message frame conform to the following format. Type Length Value 1 Value 2 …… Value n Each box in the table represents a field of minimum size one octet. The first type field octet has the following format: 1 2 3 4 5 6 7 8 l EA C/R T1 T2 T3 T4 T5 T6 The EA bit is an extension bit. It is set to 1 in the last octet of the sequence. In other octets EA is te set to 0. Quectel multiplexer only supports one octet is transmitted. So EA is always set to 1. c l The C/R bit indicates whether the message is a command or a response. ue tia The T bits indicate the type coding. Each command has a unique pattern of bit sequence. This means that a single-octet type field can encode 63 different message types. Only single octet Q n message types are defined in the present document. e The length field octet has the following structure: 1 2 3 4 5 6 7 8 fid EA L1 L2 L3 L4 L5 L6 L7 The EA bit is an extension bit. It is set to 1 in the last octet of the sequence. In other octets EA is n set to 0. Quectel multiplexer only supports one octet is transmitted. So EA is always set to 1. o The L bits define the number of value octets that follows. L1 is the LSB and L7 is the MSB; this C permits messages with up to 127 value octets to be constructed. The message frame is divided into following types: 3.5.1. PSC Message type coding octet: 1 2 3 4 5 6 7 8 EA C/R 0 0 0 0 1 0 GSM_MUX_AN_V1.1 - 14 - GSM Multiplexer Application Note Hex value is 0x43(Command), 0x41(Response) The EA bit is always set to 1. The length field in PSC message frame is 0. It has no value octet. 3.5.2. CLD Message type coding octet: 1 2 3 4 5 6 7 8 EA C/R 0 0 0 0 1 1 Hex value is 0xC3 (Command), 0xC1 (Response) The EA bit is always set the 1. l The length field in CLD message frame is 0. It has no value octet. cte l 3.5.3. Test ue tia Message type coding octet: 1 2 3 4 5 6 7 8 Q n EA C/R 0 0 0 1 0 0 Hex value is 0x23 (Command), 0x21 (Response) fide The EA bit is always set the 1. The test command is used to test the connection between MS and the TE. The length byte describes the number of value bytes, which are used as a verification pattern. The opposite entity shall respond Con with exactly the same value bytes. 3.5.4. MSC MSC message frame is designed to convey virtual V.24 control signals. It has one mandatory control signal byte and an optional break signal byte. MSC shall be sent prior to any user data after a creation of a DLC. Message format is: Type Length GSM_MUX_AN_V1.1 DLCI V.24 control signals Break signals (Optional) - 15 - GSM Multiplexer Application Note Message type coding octet: 1 2 3 4 5 6 7 8 EA C/R 0 0 0 1 1 1 Hex value is 0xE3 (Command), 0xE1 (Response) The EA bit is always set the 1. The C/R bit is used to indicate if it is a Modem Status Command or Modem Status Response. In a Modem Status Command it is the status of the sender’s own V.24 signals that shall be sent, but in a Response it is copy of the V.24 signals that are received from the Command frame that shall be returned. The DLCI field identifies the specific DLC to which the command applies. EA bit is always set to 1. l V.24 control signals format is: te 1 2 3 4 5 6 7 8 c l EA FC RTC RTR reserved(0) reserved (0) IC DV ue tia Break signals is set to 0x01. Q n 3.5.5. FCoff e Message type coding octet is: fid 1 2 3 4 5 6 EA C/R 0 0 0 1 Hex value is 0x63 (Command), 0x61 (Response) Con The length byte contains the value 0 and there are no value octets. 7 8 1 0 3.5.6. FCon Message type coding octet is: 1 2 3 4 5 6 EA C/R 0 0 0 1 Hex value is 0xA3 (Command), 0xA1 (Response) The length byte contains the value 0 and there are no value octets. GSM_MUX_AN_V1.1 7 8 0 1 - 16 - GSM Multiplexer Application Note 3.5.7. PN, NSC, RPN, RLS, SNC Not Supported. 3.6. Data Channel Quectel multiplexer data channels shall be used to transmit user data streams such as AT command data, GPRS data and GSM CSD data streams. Data channels shall be established after and only after control channel (DLCI 0) connected. l 3.7. About Flow Control te Quectel multiplexer supports software flow control mechanism. Software flow control is implemented by GSM 0710 MSC, FCoff and FCon message frame. uec tial MS will send MSC message to TE with FC bit set to 1 in V.24 control signals when refuse to accept frames. Whereas, set to 0 to inform recovery of receiving frames. Q n TE will send MSC message to MS with FC bit set to 1 in V.24 control signals when refuses to accept frames. Whereas, set to 0 to inform recovery of receiving frames. When receiving MSC, e MS will feed back MSC response to indicate recover data transmission. fid TE also can send FCoff message to MS when refuses accept anything except control messages on DLC 0. After this, MS will stop sending any frames through all the data channels except control channels. Control channel is still alive and free to send any control message. Whereas, sends FCon n to recover transmission. When receiving FCoff or FCon message, MS will feed back FCoff or o FCon response. C The difference between MSC and FCon, FCoff is that the former only flow controls one of the data channels, and the latter controls all the data channels except controls channel. 3.8. Samples for Frame Structure Sample 1: F9 Opening Flag 03 Address GSM_MUX_AN_V1.1 3F Control Field 01 Length Field 1C F9 FCS Closing Flag - 17 - GSM Multiplexer Application Note Field Header DLCI 0 SABM Frame 0, no information Tail filed This sample is a SABM frame to open DLCI 0. Sample 2: F9 05 EF 09 41 54 49 0D 58 F9 Opening Address Control Length Information FCS Closing Flag Field Field Field Field Flag Header DLC 1 UIH 4 AT Command Tail Frame 'ATI' This sample is a UIH frame to transmit AT command 'ATI'. Sample 3: F9 01 EF 0B E3 07 07 0D 01 79 l Opening Address Control Length Information FCS Flag Field Field Field Field te Header DLC 0 UIH Frame 5 MSC Message, length 3 c l This sample is a MSC message carried in UIH frame to transmit V2.4 signal 0x0D. F9 Closing Flag Tail ue tia 3.9. Transmission bit sequence CQonfiden Transmission is based on 1 start bit, 8 data bits, 1 stop bit, and no parity. GSM_MUX_AN_V1.1 - 18 - GSM Multiplexer Application Note 4. Examples 4.1. Establish Channels Step 1: Launch Multiplexer No Step Data Direction Hex Comment TEMS 1 TE launches MS ——> 61 74 2B 63 6D 75 78 AT+CMUX=0< multiplexer 3D 30 0D 0D 0A 4F LF> function by AT 4B 0D 0A 0D 0A command MS feed back <—— 61 74 2B 63 6D 75 78 AT+CMUX=0< response 3D 30 0D 0D 0A 4F LF>OK< l 4B 0D 0A 0D 0A CR> MS enters <—— F9 F9 F9 F9 Note te multiplexer c l mode and feeds back sync bytes ue tia Note The continuous bytes F9 F9 F9 F9 has the following effects: 1) Indicate MS multiplexer initialization is OK and waiting for further operations (Establish Q n DLC). 2) The byte continuously transmitted by MS after receiving PSC message. e 2) TE or MS uses to wake up the other one. fid 3) The synchronization bytes between TE and MS when synchronization lost. Here, they take the 1) effect. n Step 2: Establish DLC 0 No Step Co 1 TE requests to Data Direction TEMS ——> Hex Comment F9 03 3F 01 1C F9 SABM Frame Establishes control channel DLCI 0, using SABM frame MS feeds back UA for receiving SABM and accepts to create DLCI 0 <—— F9 03 73 01 D7 F9 UA Frame Step3: Establish DLC 1, 2 GSM_MUX_AN_V1.1 - 19 - GSM Multiplexer Application Note No Step Data Direction Hex Comment TEMS 1 TE requests to ——> F9 27 3F 01 0B F9 Note establish DLCI9 using SABM frame MS feeds back DM for F9 07 3F 01 DE F9 establish DLCI1 using SABM frame 3 MS feeds back UA for receiving SABM and accepts to create DLCI 1 l MS sends MSC message te frame c l MS sendsOK ue tia TEsendsMSC message frames Q n MS feeds back MSC response e TE requests to fid establish DLCI2 using SABM frame MS feeds back UA for n receiving SABM and accepts to o create DLCI 2 CMS sends MSC <—— F9 07 73 01 15 F9 <—— F9 01 EF 0B E3 07 07 0D 01 79 F9 F9 05 EF 0D 0D 0A 4F 4B 0D 0A 5F F9 F9 01 EF 0B E3 07 07 0D 01 79 F9 F9 01 EF 0B E1 07 07 0D 01 79 F9 F9 0B 3F 01 59 F9 <—— F9 0B 73 01 92 F9 F9 01 EF 0B E3 07 0B 0D message 01 79 F9 frames MS feeds back MSC <—— F9 01 EF 0B E1 07 0B 0D response 01 79 F9 4 Establishment of DLC 3, 4 are the same as GSM_MUX_AN_V1.1 - 20 - GSM Multiplexer Application Note above 5 By now, 4 channels have come into existence. Multiplexer can work normally Note This SABM is transmitted in order to determine whether MS is using Standard or Embedded Multiplexer. 1) MS is using Standard Multiplexer if responds with DM frame. 2) MS is using Embedded Multiplexer if responds with UA frame. Here is Standard Multiplexer. CQouneficdteenl tial GSM_MUX_AN_V1.1 - 21 - GSM Multiplexer Application Note 4.2. Frame Transmission After establishment of control channel and data channels, TE and MS can transmit data through UIH frames between each other. No Step Data Direction Hex Comment TEMS 1 TE sends AT ——> F9 05 EF 09 41 54 49 0D 58 F9 UIH Frame command 'ATI' 2 3 through DLC 1 MS feeds back through l DLC 1 uecte tial TEsendsAT Q n command e 'AT' through DLC fid 2' MS feeds back through n DLC 2 DLC 3, 4 are Co same as above <—— F9 05 EF 09 41 54 49 0D 58 F9 F9 05 EF 9B 0D 0A 53 49 4D 43 4F 4D 5F 4C 74 64 0D 0A 53 49 4D 43 4F 4D 5F 53 49 4D 33 30 30 0D 0A 52 65 76 69 73 69 6F 6E 3A 53 49 4D 33 30 30 4D 33 32 28 53 50 41 4E 53 49 4F 4E 29 5F 56 31 30 2E 30 2E 38 5F 42 55 49 4C 44 30 33 0D 0A 0D 0A 47 F9 F9 05 EF 09 4F 4B 0D 0A 58 F9 F9 09 EF 07 41 54 0D 35 F9 UIH Frame UIH Frame F9 09 EF 07 41 54 0D 35 F9 F9 09 EF 0D 0D 0A 4F 4B 0D 0A D8 F9 UIH Frame GSM_MUX_AN_V1.1 - 22 - GSM Multiplexer Application Note 4.3. Power Saving Mode and Wake Up Power saving No Step Data Direction Hex Comment TEMS 1 TE sends PSC message ——> F9 03 EF 05 43 01 F2 PSC Command through DLC 0 F9 Frame MS feeds back PSC F9 F9 F9 F9…… mode, sending F9 continuously l Wake up No Step Data Direction Hex Comment te 1 TE send wake up flags c l MS feeds back ue tia 2 MSiswokenup,anddata transmission is recovered TEMS ——> F9 F9 F9 F9 Note <—— F9 F9 F9 F9 Note CQonfiden Both F9 F9 F9 F9 and normal data frames can be used to wake up MS. Here is using the former. GSM_MUX_AN_V1.1 - 23 - GSM Multiplexer Application Note 4.4. Flow Control No Step Data Direction Hex Comment TEMS 1 MS sends MSC message with FC <—— F9 01 EF 0B E3 bit set to 1 07 07 8F 01 79 F9 through control channel DLC 0 to indicate refusing to accept anything on DLC 2 3 4 5 1 MS sends MSC message with FC bit set to 0 through control channel DLC 0 to l indicate te recovery of DLC 1 data transmission c l TE sends MSC message with FC bit set to 1 ue tia through control channel DLC 0 to indicate refusing to accept anything on DLC Q n 1 e TE sends MSC message with FC bit set to 0 fid through control channel DLC 0 to indicate recovery of DLC 1 data n transmission TE sends FCoff message through o DLC 0 Cto indicate refusing to accept ——> ——> F9 01 EF 0B E3 07 07 8D 01 79 F9 F9 01 EF 0B E3 07 07 8F 01 79 F9 F9 01 EF 0B E3 07 07 8D 01 79 F9 F9 01 EF 05 63 01 93 F9 anything on all DLC except DLC 0 6 TE sends FCon message through ——> F9 01 EF 05 A3 DLC 0 01 93 F9 to indicate recovery of data transmission GSM_MUX_AN_V1.1 - 24 - GSM Multiplexer Application Note 4.5. Synchronization After successful establishment of data channels, TE and MS are synchronized and data transmission is normal. Every transmission is implemented by frames which begins with a starting flag (0xF9) and ends with a closing flag (0xF9). So it is called that multiplexer is synchronized with flag 0xF9. Transmitting bytes other than 0xF9 between frames is considered as faulty or synchronization lost and needs re-sync. No Step Data Direction Hex Comment TEMS 1 TE sends hex value 0xF1 ——> F1 Note 1 2 MS feeds back four hex ——> F9 F9 F9 F9 Note 2 value F9 to indicate illegal bytes received and needs re-sync TE sends sync flag to re-sync l with MS ——> F9 F9 F9 F9 3 TE tests AT command te transmission through DLC 1 after re-sync ——> F9 05 EF 07 41 54 0D 06 F9 c l MS feeds back response and ue tia synchronization has been reset to normal <—— F9 05 EF 07 41 54 0D 67 F9 F9 25 EF 0D 0D 0A 4F 4B 0D 0A 8A F9 Note 1 Q n Sending illegal hex byte (other than 0xF9) will lead to synchronization lost situation and can be used to simulate re-sync procedure. e Note 2 fid When receiving illegal hex byte between frames, MS will send four sync flag F9 F9 F9 F9 to indicate synchronization is lost and waits for four sync flag F9 F9 F9 F9 from TE to re-sync with it. Otherwise, any subsequent bytes received will be treated as abnormal and another four sync Con flag F9 F9 F9 F9 will again be feed back until F9 F9 F9 F9 received. GSM_MUX_AN_V1.1 - 25 - GSM Multiplexer Application Note 4.6. Closing Down Multiplexers No Step Data Direction Hex Comment TEMS 1 TE sends DISC frame to request ——> F9 07 53 01 3f F9 closing down DLC 1 MS feeds back UA frame to <—— F9 0b 53 01 B8 F9 F9 0b 73 01 92 F9 F9 0f 53 01 3f F9 F9 0f 73 01 15 F9 F9 13 53 01 3f F9 F9 13 73 01 15 F9 F9 03 EF 05 C3 01 F2 F9 F9 03 EF 05 C1 01 F2 F9 GSM_MUX_AN_V1.1 - 26 - Shanghai Quectel Wireless Solutions Co., Ltd. Room 801, Building E, No.1618, Yishan Road, Shanghai, China 201103 Tel: +86 21 5108 2965 Mail: info@quectel.com

Quectel Cellular Engine GSM STK AT Commands GSM_STK_ATC_V1.1 GSM_STK_ATC_V1.1 Document Title Version Date Status Document Control ID GSM STK AT Commands 1.1 2015-05-11 Release GSM_STK_ATC_V1.1 General Notes Quectel offers this information as a service to its customers, to support application and engineering efforts that use the products designed by Quectel. The information provided is based upon requirements specifically provided to Quectel by the customers. Quectel has not undertaken any independent search for additional relevant information, including any l information that may be in the customer’s possession. Furthermore, system validation of this te product designed by Quectel within a larger electronic system remains the responsibility of the customer or the customer’s system integrator. All specifications supplied herein are c l subject to change. ue tia Copyright This document contains proprietary technical information which is the property of Quectel Limited. The copying of this document, distribution to others, and communication of the Q n contents thereof, are forbidden without express authority. Offenders are liable to the payment e of damages. All rights are reserved in the event of a patent grant or registration of a utility model or design. All specification supplied herein are subject to change without notice at any fid time. Con Copyright © Shanghai Quectel Wireless Solutions Co., Ltd. 2015 GSM_STK_ATC_V1.1 - 1 - GSM_STK_ATC_V1.1 Contents Contents ................................................................................................................................ 2 0. Revision history................................................................................................................ 3 1. Introduction ...................................................................................................................... 4 1.1. Reference ............................................................................................................... 4 1.2. Terms and abbreviations ........................................................................................ 4 2. AT Commands for STK ....................................................................................................5 2.1. Overview of AT Commands for STK support .........................................................5 2.2. Details for AT Commands for STK support ............................................................5 2.2.1. AT+QSTK STK Turn on/off STK function ............................................... 5 2.2.2. AT+STKPD STK profile download .......................................................... 7 2.2.3. AT+STKENV STK Envelope command..................................................8 2.2.4. AT+STKTR STK terminal response........................................................8 2.2.5. AT+STKCALL Trigger STK Call ............................................................ 11 l 2.2.6. AT+STKSMS Trigger STK SMS ........................................................... 11 2.2.7. AT+STKSS Trigger STK SS ................................................................. 12 te 2.2.8. AT+STKUSSD Trigger STK USSD.......................................................13 c l 2.2.9. AT+STKDTMF Trigger STK DTMF.......................................................13 3. +STKPCI STK Proactive Command Indication ............................................................. 14 ue tia 4. Examples .......................................................................................................................15 4.1. SET UP MENU Proactive Command ...................................................................15 4.1.1. Raw data...............................................................................................15 Q n 4.1.2. Parsed data...........................................................................................15 4.2. Menu Selection and Set Up Call .......................................................................... 16 e 4.2.1. Row Data ..............................................................................................16 fid 4.2.2. Parsed Data..........................................................................................17 4.3. Menu Selection, Get input and Send Short Message .......................................... 17 4.3.1. Row Data .............................................................................................. 18 4.3.2. Parsed Data .......................................................................................... 18 n 4.4. Menu Selection, Send USSD and SD ..................................................................24 o 4.4.1. Row Data ..............................................................................................24 C4.4.2. Parsed Data..........................................................................................24 5. Appendix: STK protocol structure................................................................................26 5.1. Structure of SIM Application Toolkit communications........................................... 26 5.2. BER_TLV tag in SIM to ME direction ...................................................................26 5.3. BER_TLV tag in ME to SIM direction ...................................................................26 5.4. Simple TLV objects ...............................................................................................26 5.5. Structure of terminal response ............................................................................. 28 5.6. Structure of envelope for menu selection.............................................................28 GSM_STK_ATC_V1.1 - 2 - GSM_STK_ATC_V1.1 0. Revision history Revision 1.0 1.1 Date 2011-3-14 2015-05-011 Author Joanna LI Thomas ZHANG Description of change Initial Added applicable modules CQouneficdteenl tial GSM_STK_ATC_V1.1 - 3 - GSM_STK_ATC_V1.1 1. Introduction Quectel Module provides AT commands to support STK. This document is a reference guide to all the AT commands and responses defined for STK. The SIM Application Toolkit (SAT/STK) provides mechanisms which allow applications, existing in the SIM, to interact and operate with any ME which supports the specific mechanism(s) required by the application. Please go to GSM 11.14 for more details about STK. Quectel provides AT commands to support profile download (+STKPD), envelope (+STKENV), terminal response (+STKTR), get STK indication (+QSTK) and trigger STK call (+STKCALL), SMS (+STKSMS), SS (+STKSS), USSD (+STKUSSD) and DTMF (+STKDTMF). This document is applicable to all Quectel GSM modules except for GCxx modules. l 1.1. Reference te Table 1: Reference c l SN Document name ue tia [1] M10_ATC.pdf [2] GSM 11.14 Q n [3] GSM 11.11 Remark The introduction of AT commands for M10 Specification of the SIM Application Toolkit for the SIM-ME interface Specification of the SIM-ME interface fide 1.2. Terms and abbreviations n Table 2: Terms and abbreviations o Abbreviation Description C SAT/STK SIM Application Toolkit SIM Subscriber Identity Module ME Mobile Equipment SMS Short Message Service SS Supplementary Service USSD Unstructured Supplementary Service Data BER Basic Encoding Rules of ASN.1 TLV Tag, Length, Value &h Hexadecimal format &d Decimal format GSM_STK_ATC_V1.1 - 4 - GSM_STK_ATC_V1.1 2. AT Commands for STK 2.1. Overview of AT Commands for STK support Command Description AT+QSTK TURN ON/OFF STK FUNCTION AT+STKPD STK PROFILE DOWNLOAD AT+STKENV STK ENVELOPE COMMAND AT+STKTR STK TERMINAL RESPONSE AT+STKCALL AT+STKSMS AT+STKSS AT+STKUSSD l AT+STKDTMF TRIGGER STK CALL TRIGGER STK SMS TRIGGER STK SS TRIGGER STK USSD TRIGGER STK DTMF cte l 2.2. Details for AT Commands for STK support ue tia 2.2.1. AT+QSTK STK Turn on/off STK function Q n AT+QSTK Turn on/off STK function Test Command e AT+QSTK=? Response +QSTK: (0-1) fid Read Command AT+QSTK? OK Response +QSTK : on OK Parameters CSee Write Command Write Command Response AT+QSTK= If format is right, response OK Otherwise response +CME ERROR: Parameter Whether turn on the STK function GSM_STK_ATC_V1.1 - 5 - GSM_STK_ATC_V1.1 Reference 0 Turn off 1 Turn on Note:  Must restart the module and make sure SIM card is unlocked to use STK commands. Example: AT+QSTK=1 OK Restart the module, enter PIN code if SIM card is locked. Then the following indication will come up, including the main menu list: +STKPCI: 0, 'D07A8103012500820281828507804E16754C98CE8F0A018070ED70B963A8 83508F0A028065B095FB8D227ECF8F0A0380554665C552A9624B8F0A0480624B673A7406 8D228F0A058081EA52A9670D52A18F0A06806D41884C77ED4FE18F06078070AB94C38F0 A0880624B673A97F34E508F0A09807CBE5F694E0A6D77' l Parsed Data: Please refer to the appendix in this document for details below. te D0 Proactive SIM command tag c l 7A Length 1. If the length is between 0 and 127 (00 to 7F&h), it's coded onto one byte. For example, '7A' =122&d. ue tia 2. If the length is between 128 and 255 (80 to FF&h), it's coded onto two bytes leading with '81'. For example, '81BA' = 186&d. Q n 8103012500 81 03 01 25 00 Command Length command Type of Command e details tag number command: Qualifier fid Setupmenu 82028182 82 02 81 82 Device Length Souce: Destination: ME nidentity tag SIM 8507804E16754C98CE 85 07 804E16754C98CE oAlpha Length Alpha identifier: C identifier 80: UCS2 coding tag 4E16754C98CE:世界风 8F0A018070ED70B963 8F 0A 01 8070ED70B963A88350 A88350 Item tag Length ID of Text string of item item: 1 80: UCS2 coding 70ED70B963A88350: 热点 推荐 8F0A028065B095FB8D Item 2: 新闻财经 227ECF 8F0A0380554665C552A Item 3: 商旅助手 GSM_STK_ATC_V1.1 - 6 - GSM_STK_ATC_V1.1 9624B 8F0A0480624B673A740 Item 4: 手机理财 68D22 8F0A058081EA52A967 Item 5: 自助服务 0D52A1 8F0A06806D41884C77 Item 6: 流行短信 ED4FE1 8F06078070AB94C3 8F0A0880624B673A97 Item 7: 炫铃 Item 8: 手机音乐 F34E50 8F0A09807CBE5F694E Item 9: 精彩上海 0A6D77 2.2.2. AT+STKPD STK profile download AT+STKPD STK profile download l Test Command Response te AT+STKPD=? OK Execution c l Command AT+STKPD Response Do the profile downloading. OK ue tia ReadCommand AT+STKPD? Response Get the terminal profile setting. +STKPD: Q en OK Confid Reference Parameter HEX string of STK profile. Note:  Profile downloading provides a mechanism for the ME to tell the SIM what it is capable of.  The structure of profile content is specified in GSM 11.14 subclause 5.2 Structure and coding of TERMINAL PROFILE. Example: AT+STKPD? +STKPD: 'FFFFFFFF7F1F007FFF00001F230811060700' OK GSM_STK_ATC_V1.1 - 7 - GSM_STK_ATC_V1.1 2.2.3. AT+STKENV STK Envelope command AT+STKENV STK Envelope command Test Command Response AT+STKENV=? OK Write Command Response AT+STKENV=< This command is used to send STK Envelope command. sat_command> OK Parameters HEX string of STK envelope command Reference Note:  The structure of envelope command is specified in GSM 11.14 clause 7 to clause 11. Below example is to send envelope command for menu selection. l Example: te Select item 4 (Refer to GSM 11.14 subclause 8.2 Structure of ENVELOPE (MENU SELECTION): c l AT+STKENV='D30782020181900104' OK ue tia ParsedData: D3 Menu Selection tag Q n 07 Length e 82020181 82 02 Device identity Length fid tag 900104 90 01 Item identifier Length n tag 01 81 Source device Destination device identity: Keypad identity: SIM 04 ID of item chosen: 04 Co 2.2.4. AT+STKTR STK terminal response AT+STKTR STK terminal response Test Command Response AT+STKTR=? OK Write Command AT+STKTR= Response This command is used to send STK Terminal Response. OK Parameter GSM_STK_ATC_V1.1 - 8 - GSM_STK_ATC_V1.1 HEX string of STK response Reference Note:  The structure of terminal response is specified in GSM 11.14 clause 6.8. Example 1: Terminal response of Selecting item +STKPCI: 0,'D07081030124008202818285098081EA52A9670D52A18F100180004F0054004 1670D52A1630753578F0A02805BA2670D70ED7EBF8F0C0380005600490050540D72478F0 A0480805476DF670D52A18F0A05808BDD8D3967E58BE28F0A068079EF520667E58BE28F 0A07805DF25B9A4E1A52A1' AT+STKTR='810301240082028281830100900105' OK Parsed data for SELECT ITEM proactive command: D0 Proactive SIM command tag l 70 Length te 8103012400 Command details: type of command 24 -- Select Item c l 82028182 85098081EA52A9670D52A1 ue tia 8F100180004F00540041670D52A163075357 8F0A02805BA2670D70ED7EBF 8F0C0380005600490050540D7247 Q n 8F0A0480805476DF670D52A1 8F0A05808BDD8D3967E58BE2 e 8F0A068079EF520667E58BE2 fid 8F0A07805DF25B9A4E1A52A1 Device identity: source SIM > destination ME Alpha identifier: 自助服务 Item 1. OTA 服务指南 Item 2. 客服热线 Item 3. VIP 名片 Item 4. 联盟服务 Item 5. 话费查询 Item 6. 积分查询 Item 7. 已定业务 Parsed data for TERMINAL RESPONSE of SELECT ITEM: n 8103012400 Command details: type of command 24 -- Select Item 82028281 Device identity: source ME > destination SIM o 830100 83 01 00 CResult tag Length General result: 00 command performed successfully 900105 Item identifier: 05 Example 2: Terminal response of Getting input – input short message content +STKPCI: 0,'D01E8103012303820281828D0F08300E8F93516551855BB9003A300F910201 8C' AT+STKTR='8103012303820282818301008D05084F60597D' OK GSM_STK_ATC_V1.1 - 9 - GSM_STK_ATC_V1.1 Parsed data for GET INPUT proactive command: D0 Proactive SIM command tag 1E Length 8103012303 Command details: type of command 23 -- Get input 82028182 Device identity: source SIM > destination ME 8D0F08300E8F935 8D 0F 08 300E8F9351655185 16551855BB9003A 5BB9003A300F 300F9102018C Text string Length Data coding scheme: it is Text string: 『输入 tag coded as for SMS Data 内容:』 coding scheme defined in GSM03.38. It means 'input 08 - UCS2 content' in English. 9102018C 91 Response length tag 02 Length 04 - 8 bit coding 01 Min length: 1 8C Max length: 8C&h=140&d tel Parsed data for TERMINAL RESPONSE of GET INPUT: 8103012303 Command details: type of command 23 -- GET INPUT c l 82028281 Device identity: source ME > destination SIM ue tia 830100 8D05084F60597D Result: 00 command performed successfully Text string: UCS2 '你好' Q n Example 3: Terminal response of Getting input – input target number of short message e +STKPCI: 0,'D01A8103012300820281828D0B088F93516553F77801FF1A91020114' AT+STKTR='8103012300820282818301008D0C043133373634343132313531' fid OK Parsed data: n +STKPCI: text string: '输入号码：', it means 'Input number' in English. o Terminal response: input number '13764412151', 8 bit coding schema. Note: The terminal response is similar as above example 2: using UCS2 coding to input message C content in example 2, while using 8-bit coding to input number here. Example 4: Go backward to the item at higher level AT+STKTR='810301240082028281830111' OK Example 5: Return to the main menu directly AT+STKTR='810301230082028281830110' OK GSM_STK_ATC_V1.1 - 10 - GSM_STK_ATC_V1.1 Parsed data of example 4 and 5: 830111 Result: 11 - Backward move in the proactive SIM session requested by the user 830110 Result: 10 - Proactive SIM session terminated by the user Note: In example 4 and 5, type of command in terminal response should be the same as that in +STKPCI last time. 2.2.5. AT+STKCALL Trigger STK Call AT+STKCALL Trigger STK Call Test Command Response AT+STKCALL= OK ? Write Command Response AT+STKCALL= If format is right, response OK Otherwise, response l ERROR Queficdteential Reference Parameters 0 Trigger modem to send STK CALL SETUP 4 Trigger modem to send STK CALL SETUP but icon cannot be displayed 16 Proactive session terminated by user 18 No response from user 32 ME currently unable to process this command 34 User reject setup call 50 Command data not understood by ME Note:  Type of command value for Setting up call is '10'. on 2.2.6. AT+STKSMS Trigger STK SMS C AT+STKSMS Trigger STK SMS Test Command Response AT+STKSMS=? OK Write Command Response AT+STKSMS=< If format is right, response n> OK Otherwise, response ERROR GSM_STK_ATC_V1.1 - 11 - GSM_STK_ATC_V1.1 Parameters 0 Trigger modem to send STK SMS 4 Trigger modem to send STK SMS but icon cannot be displayed Reference Note:  Type of command value for sending short message is '13'. Example: Send short message +STKPCI: 1,'D0198103011300820281838B0E010005A10180F600040459454358' AT+STKSMS=0 OK Parsed data for Send Short Message proactive command: D0 Proactive SIM command tag 19 Length 8103011300 Command details: type of command 13 - send short message l 82028183 Device identity: source SIM > destination Network te 8B0E010005A1018 8B 0E 010005A10180F600040459454358 0F60004045945435 SMS Length SMS TPDU: c l 8 TPDU tag TA(Target Address): 10086 UD(User Data): 'YECX' (china mobile ue tia provides this code to check balance) Q n 2.2.7. AT+STKSS Trigger STK SS e AT+STKSS Trigger STK SS Test Command fid AT+STKSS=? Response OK Write Command Response n AT+STKSS= If format is right, response OK CoOtherwise, response ERROR Reference Parameters 0 Trigger modem to send STK SS 4 Trigger modem to send STK SS but icon cannot be displayed 50 Command data not understood by ME Note:  Type of command value for sending SS is '11'. GSM_STK_ATC_V1.1 - 12 - GSM_STK_ATC_V1.1 2.2.8. AT+STKUSSD Trigger STK USSD AT+STKUSSD Trigger STK USSD Test Command Response AT+STKUSSD= OK ? Write Command Response AT+STKUSSD= If format is right, response OK Otherwise, response ERROR ctel l Reference Parameters 0 Trigger modem to send STK USSD 4 Trigger modem to send STK USSD but icon cannot be displayed 50 Command data not understood by ME Note:  Type of command value for Sending USSD is '12'. ue tia 2.2.9. AT+STKDTMFTrigger STK DTMF AT+QSTKDTMF Trigger STK DTMF Q n Test Command Response e AT+STKDTMF= OK ? fid Write Command Response AT+STKDTMF= If format is right, response OK on Otherwise, response CERROR Reference Parameters 0 Trigger modem to send STK DTMF 4 Trigger modem to send STK DTMF but icon cannot be displayed 32 ME currently unable to process command Note:  Type of command value for sending DTMF is '14'. GSM_STK_ATC_V1.1 - 13 - GSM_STK_ATC_V1.1 3. +STKPCI STK Proactive Command Indication This unsolicited result code is used to indicate Proactive Command Indication. Format: +STKPCI: < pci_type > [,] < pci_type> 0 The SAT command is handled by TE. 1 The SAT command is handled by ME. 2 No other command (end of session) CQouneficdteenl tial HEX string of STK proactive command, sent when = 0 or 1 GSM_STK_ATC_V1.1 - 14 - GSM_STK_ATC_V1.1 4. Examples 4.1. SET UP MENU Proactive Command Description: An example of SET UP MENU proactive command. 4.1.1. Raw data +STKPCI:0, 'D081C0810301250082028182850B80906050B3670D52D953408F0C02804F86 96FB63A5901A92348F0C0380906050B38CA18A0A901F8F0C04805A1B6A02842C82B17B5 28F0A0580571692344E0B8F098F100780003600380038884C52D5523855468F0C0880958B90 4B90544EBA99288F0E09800036003600365A1B6A027DB28F100A8090FD670375375973804 A59295BA48F100B8054C862C9540D4EBA804A59295BA48F0E0C800038003000374F344F6 l 0884C8F0E0D80906050B35BA2670D5C087DDA' AT+STKTR='810301250082028281830100' cte l 4.1.2. Parseddata ue tia 4.1.2.1. Proactive command SET UPMENU +STKPCI: 0,'D0: proactive SIM command Tag 81C0: length Q n 8103012500: command details e 81: command details tag 03: length fid 01: command number 25: type of command: set up menu 00: command qualifier n 82028182: device id 82: device id tag o02: length C81: source id: SIM 82: destination id: ME 850B80906050B3670D52D95340: alpha id 85: alpha id tag 0B: length 80906050B3670D52D95340: alpha id: 遠傳服務區 8F0C02804F8696FB63A5901A9234: Item 8F: item tag 0C: length 02: item id GSM_STK_ATC_V1.1 - 15 - GSM_STK_ATC_V1.1 804F8696FB63A5901A9234: 來電接通鈴 8F0C0380906050B38CA18A0A901F: 遠傳財訊速 8F0C04805A1B6A02842C82B17B52: 娛樂萬花筒 8F0A0580571692344E0B8F09: 圖鈴下載 8F100780003600380038884C52D552385546: 688行動券商 8F0C0880958B904B90544EBA9928: 開運達人館 8F0E09800036003600365A1B6A027DB2: 666娛樂網 8F100A8090FD670375375973804A59295BA4: 都會男女聊天室 8F100B8054C862C9540D4EBA804A59295BA4: 哈拉名人聊天室 8F0E0C800038003000374F344F60884C: 807伴你行 8F0E0D80906050B35BA2670D5C087DDA': 遠傳客服專線 4.1.2.2. Terminal response of SET UP MENU AT+STKTR= '8103012500: command details (just same as the one in the proactive SIM) l 81: command details tag te 03: length 01: command number c l 25: type of command: set up menu 00: command qualifier ue tia 82028281: device id (source id: ME, destination id: SIM) 82: device id tag 02: length Q n 82: source id: ME 81: destination id: SIM e 830100': result fid 83: result tag 01: length 00: Command perform successfully Con 4.2. Menu Selection and Set Up Call Description: An example of selecting item 1 and being notified by MENU SELECTION envelope command after SET UP MENU proactive command. 4.2.1. Row Data [STK] option: 1, menu item: [0x02] 來電接通鈴 AT+STKENV='D30782020181900102' +STKPCI:1,'D02581030110008202818305158000390030003064A5865F4E2D002E002E0020 002E86038109F0' GSM_STK_ATC_V1.1 - 16 - GSM_STK_ATC_V1.1 AT+STKCALL=0 4.2.2. Parsed Data 4.2.2.1. MENU SELECTION envelope: select item 2 - 來電接通鈴 AT+STKENV=' D3: menu selection tag 07: length 82020181: device id 82: device id tag 02: length 0181: source: Keypad, destination: SIM 900102': Item id 90: item id tag 01: length 02': item id: 2 l 4.2.2.2. SET UP CALL proactive command te +STKPCI:1,'D0: proactive SIM command Tag c l 25: length 8103011000: command details ue tia 81:commanddetailtag 03: length 01: command number Q n 1000: type of command: SET UP CALL, only if not currently busy on another call e 82028183: device id fid 82: device id tag 02: length 8183: source: SIM, destination: network n 05158000390030003064A5865F4E2D002E002E0020002E: alpha id 05: alpha id tag o15: length C8000390030003064A5865F4E2D002E002E0020002E: 900撥號中.. . 86038109F0': address 86: address tag 03: length 81: TON: Unknown NPI: ISDN/telephony numbering plan 09F0': Dialing number string: 900 4.3. Menu Selection, Get input and Send Short Message Description: An example of selecting item 2 and being notified by MENU SELECTION GSM_STK_ATC_V1.1 - 17 - GSM_STK_ATC_V1.1 envelope command after SET UP MENU proactive command. 4.3.1. Row Data [STK] option: 1, menu item: [0x03] 遠傳財訊速 1. AT+STKENV='D30782020181900103' 2. +STKPCI:0,'D052810301240082028182050B80906050B38CA18A0A901F8F0A018053F 0706380A15E028F0A0280570B969B80A15E028F0A038059165E63532F73878F0A04806 71F8CA8630765788F0A05804ECA65E565B0805E' [STK] option: 1, menu item: [0x01] 台灣股市 3. AT+STKTR='810301240082028281830100900101' 4. +STKPCI:0,'D03881030124008202818205098053F0706380A15E028F0A018052A06B0A 630765788F0A02804E0A6AC3630765788F0A0380500B80A1884C60C5' [STK] option: 1, menu item: [0x03] 個股行情 5. AT+STKTR='810301240082028281830100900103' 6. +STKPCI: 0,'D01E8103012300820281828D0F088F38516580A179680031865F78BC910 l 20004' 7. AT+STKTR='8103012300820282818301008D050432343534' te 8. +STKPCI: 0,'D01E8103012300820281828D0F088F38516580A179680032865F78BC910 20004' c l 9. AT+STKTR='8103012300820282818301008D0104' ue tia 10. +STKPCI:1,'D043810301130082028183051180865574064E2D002C00208ACB7A0D5019 0607918896130000998B1C11001481102108906300009900000004A70A2A3132382A32343 53423' Q n 11. AT+STKSMS=0 e 4.3.2. Parsed Data fid 4.3.2.1. MENU SELECTION envelope: select item 3 - 遠傳財訊速 AT+STKENV=' n D3: menu selection tag 07: length o82020181: device id C82: device id tag 02: length 0181: source: Keypad, destination: SIM 900103': item id 90: item id tag 01: length 03: item id 4.3.2.2. SELECT ITEM proactive command +STKPCI:0,'D0: Proactive SIM command tag GSM_STK_ATC_V1.1 - 18 - GSM_STK_ATC_V1.1 52: length 8103012400: command details 81: command details tag 03: length 01: command number 2400: SELECT ITEM, no help information available, no selection preference, presentation type is not specified 82028182: device id 82: device id tag 02: length 8182: source: SIM, destination: ME 050B80906050B38CA18A0A901F: alpha id 05: alpha id tag 0B: length 80906050B38CA18A0A901F: 遠傳財訊速 8F0A018053F0706380A15E02: Item l 8F: item tag 0A: length te 01: item id: 1 8053F0706380A15E02: 台灣股市 c l 8F0A0280570B969B80A15E02: item 2: 國際股市 ue tia 8F0A038059165E63532F7387: item 3: 外幣匯率 8F0A0480671F8CA863076578: item 4: 期貨指數 8F0A05804ECA65E565B0805E': item 5: 今日新聞 Q n 4.3.2.3. Terminal response of SELECT ITEM: select item 1 -台灣股市 e AT+STKTR=' fid 8103012400: command details 81: command details tag 03: length n 01: command number 2400: SELECT ITEM, no help information available, no selection preference, opresentation type is not specified C82028281: device id 82: device id tag 02: length 8281: source: ME, destination: SIM 830100: result 83: result tag 01: length 00: command performed successfully 900101': item id 90: item id tag 01: length GSM_STK_ATC_V1.1 - 19 - GSM_STK_ATC_V1.1 01: item id 4.3.2.4. SELECT ITEM proactive command +STKPCI:0, 'D0: proactive SIM command tag 38: length 8103012400: command details 81: command details tag 03: length 01: command number 2400: SELECT ITEM, no help information available, no selection preference, presentation type is not specified 82028182: device id 82: device id tag 02: length 8182: source: SIM, destination: ME 05098053F0706380A15E02: alpha id 05: alpha id tag l 09: length te 8053F0706380A15E02: 台灣股市 8F0A018052A06B0A63076578: item c l 8F: item tag 0A: length ue tia 01:item1 8052A06B0A63076578: 加權指數 8F0A02804E0A6AC363076578: item 2: 上櫃指數 Q n 8F0A0380500B80A1884C60C5': item 3: 個股行情 e 4.3.2.5. Terminal response of SELECT ITEM: select item 3 -個股行情 fid AT+STKTR=' 8103012400: command details 81: command details tag n 03: length o01: command number C2400: SELECT ITEM, no help information available, no selection preference, presentation type is not specified 82028281: device id 82: device id tag 02: length 8281: source: ME, destination: SIM 830100: result 83: result tag 01: length 00: command performed successfully 900103': item id GSM_STK_ATC_V1.1 - 20 - GSM_STK_ATC_V1.1 90: item id tag 01: length 03: item id 4.3.2.6. GET INPUT proactive command +STKPCI: 0, 'D0: proactive SIM command tag 1E: length 8103012300: command details 81: command details tag 03: length 01: command number 2300: GET INPUT, no help information, user input to be unpacked format, ME may echo user input on the display, SMS default alphabet, digits (0 to 9, *, # and +) only 82028182: device id 82: device id tag l 02: length te 8182: source: SIM, destination: ME 8D0F088F38516580A179680031865F78BC: test string c l 8D: text string tag 0F: length ue tia 08: data coding scheme: UCS2 8F38516580A179680031865F78BC: 輸入股票 1 號碼 91020004': response length Q n 91: response length tag 02: length e 00: min length = 0 fid 04: max length = 4 4.3.2.7. Terminal response of GET INPUT: 輸入股票 1 號碼 n AT+STKTR=' o8103012300: command details C81: command details tag 03: length 01: command number 2300: GET INPUT, no help information, user input to be unpacked format, ME may echo user input on the display, SMS default alphabet, digits (0 to 9, *, # and +) only 82028281: device id 82: device id tag 02: length 8281: source: ME, destination: SIM 830100: result GSM_STK_ATC_V1.1 - 21 - GSM_STK_ATC_V1.1 83: result tag 01: length 00: command performed successfully 8D050432343534': text string 8D: text string tag 05: length 04: data coding scheme: GSM default alphabet 8 bits 32343534: 2454 4.3.2.8. GET INPUT proactive command +STKPCI: 0, 'D0: proactive SIM command tag 1E: length 8103012300: command details 81: command details tag 03: length 01: command number l 2300: GET INPUT, no help information, user input to be unpacked format, te ME may echo user input on the display, SMS default alphabet, digits (0 to 9, *, # and +) only c l 82028182: device id 82: device id tag ue tia 02:length 8182: source: SIM, destination: ME 8D0F088F38516580A179680032865F78BC: text string Q n 8D: text string tag 0F: length e 08: data coding scheme: UCS2 fid 8F38516580A179680032865F78BC: 輸入股票 2 號碼 91020004': response length 91: response length tag n 02: length 00: min length = 0 Co04: max length = 4 4.3.2.9. Terminal response of GET INPUT: 輸入股票 2 號碼 AT+STKTR=' 8103012300: command details 81: command details tag 03: length 01: command number 2300: GET INPUT, no help information, user input to be unpacked format, ME may echo user input on the display, SMS default alphabet, digits (0 to 9, *, # and +) only GSM_STK_ATC_V1.1 - 22 - GSM_STK_ATC_V1.1 82028281: device id 82: device id tag 02: length 8281: source: ME, destination: SIM 830100: result 83: result tag 01: length 00: command performed successfully 8D0104': text string 8D: text string tag 01: length 04: data coding scheme: GSM default alphabet 8 bits 4.3.2.10. SEND SHORT MESSAGE proactive command +STKPCI: 1, 'D0: proacitve SIM command tag 43: length l 8103011300: command details te 81: command details tag 03: length c l 01: command number 1300: SEND SHORT MESSAGE, packing not required ue tia 82028183:deviceid 82: device id tag 02: length Q n 8183: source: SIM destination: Network 051180865574064E2D002C00208ACB7A0D5019: alpha id e 05: alpha id tag fid 11: length 80865574064E2D002C00208ACB7A0D5019: 處理中, 請稍候 060791889613000099: address n 06: address tag 07: length o91: TON: international number, NPI: ISDN/telephony numbering plan C889613000099: dialing number string 8B1C11001481102108906300009900000004A70A2A3132382A3234353423': SMS TPDU 8B: SMS TPDU tag 1C: length 11001481102108906300009900000004A70A2A3132382A3234353423: SMS TPDU GSM_STK_ATC_V1.1 - 23 - GSM_STK_ATC_V1.1 4.4. Menu Selection, Send USSD and SD Description: An example of user selecting item 2 and being notified by MENU SELECTION envelope command after SET UP MENU proactive command. 4.4.1. Row Data [STK] option: 1, menu item: [0x05] 圖鈴下載 AT+STKENV='D30782020181900105' +STKPCI: 1,'D024810301120082028183051180865574064E2D002C00208ACB7A0D50198A 0640AA182D3702' AT+STKUSSD=0 +STKPCI: 1,'D022810301110082028183051180865574064E2D002C00208ACB7A0D501989 04811A94FB' AT+STKSS=0 l 4.4.2. Parsed Data te 4.4.2.1. MENU SELECTION envelope: select item 5 -圖鈴下載 c l AT+STKENV=' D3: menu selection tag ue tia 07:length 82020181: device id 82: device id tag Q n 02: length 0181: source: Keypad, destination: SIM e 900105': item id fid 90: item id tag 01: length 05: item id n 4.4.2.2. SEND USSD proactive command o +STKPCI: 1,'D0: proactive SIM command tag C24: length 8103011200: command details 81: command details tag 03: length 01: command number 1200: SEND USSD 82028183: device id 82: device id tag 02: length 8183: source: SIM destination: Network GSM_STK_ATC_V1.1 - 24 - GSM_STK_ATC_V1.1 051180865574064E2D002C00208ACB7A0D5019: alpha id 05: alpha id tag 11: length 80865574064E2D002C00208ACB7A0D5019: 處理中, 請稍候 8A0640AA182D3702': USSD string 8A: USSD string tag 06: length 40: GSM 7 bit default alphabet, the text is uncompressed, AA182D3702: USSD string content 4.4.2.3. SEND SS proactive command: +STKPCI: 1,'D0: proactive SIM command 22: length 8103011100: command details 81: command details tag 03: length l 01: command number te 1100: SEND SS 82028183: device id c l 82: device id tag 02: length ue tia 8183: source: SIM destination: Network 051180865574064E2D002C00208ACB7A0D5019: alpha id 05: alpha id tag Q n 11: length e 80865574064E2D002C00208ACB7A0D5019: 處理中, 請稍候 8904811A94FB': SS string fid 89: SS string tag 04: length 81: TON: Unknown, NPI: ISDN/telephony numbering plan Con 1A94FB: SS or USSD string content GSM_STK_ATC_V1.1 - 25 - GSM_STK_ATC_V1.1 5. Appendix: STK protocol structure Here list some structures which have been used in this document for better understanding. More details please refer to GSM 11.14. 5.1. Structure of SIM Application Toolkit communications Please refer to GSM 11.14 Annex D. BER-TLV data object: Tag Length Value SIMPLE-TLV data object: Tag Length Value 1..n SIMPLE TLV objects 1..m elements l 5.2. BER_TLV tag in SIM to ME direction te Please refer to GSM 11.14 subclause 13.2. c l Description Proactive SIM command tag Length 1 Value D0 ue tia 5.3. BER_TLV tag in ME to SIM direction Q n Please refer to GSM 11.14 subclause 13.1. e Description SMS-PP download tag fid Cell Broadcast download tag Menu Selection tag Call control tag n MO Short message control tag o Event download tag C Timer expiration Length 1 1 1 1 1 1 1 Value D1 D2 D3 D4 D5 D6 D7 5.4. Simple TLV objects Please refer to GSM 11.14 subclause 13.3 for Simple TLV tag value in both directions. The structure of simple TLV data object is Tag, Length, Value elements. Below table lists tag value and elements. Tag Value Description Value Elements Reference in GSM_STK_ATC_V1.1 - 26 - GSM_STK_ATC_V1.1 GSM 11.14 Command details tag 01 or 81 Command number 12.6 Type of command Command Qualifier Device identity tag 02 or 82 Source device identity 12.7 Destination device identity Result tag 03 or 83 General result 12.12 Alpha identifier tag 05 or 85 Alpha identifier (If the first byte is 12.2 '80', it means UCS2 coding schema) Address tag 06 or 86 TON and NPI 12.1 Dialing number string SS string tag 09 or 89 TON and NPI 12.14 USSD string tag SMS TPDU tag l Text string tag te Item tag uec tial Itemidentifiertag Q n Response length tag 0A or 8A 0B or 8B 0D or 8D 0F or 8F 10 or 90 11 or 91 SS or USSD string Data coding scheme USSD string SMS TPDU Data coding scheme Text string Identifier of item Text string of item (If the first byte is '80', it means UCS2 coding schema) Identifier of item chosen Minimum length of response Maximum length of response 12.17 12.13 12.15 12.9 12.10 12.11 e Type of Command: (Refer to GSM 11.14 subclause 13.4) fid Value Name 10 Set up Call 11 Send SS n 12 Send USSD 13 Send short message o 14 Send DTMF C 21 Display text 23 Get input 24 Select item 25 Set up menu Device identity Value Name 01 Keypad 02 Display 81 SIM GSM_STK_ATC_V1.1 - 27 - GSM_STK_ATC_V1.1 82 ME 83 Network General result: Value Meaning 00 Command performed successfully 10 Proactive SIM session terminated by the user; 11 Backward move in the proactive SIM session requested by the user 5.5. Structure of terminal response Please refer to GSM 11.14 subclause 6.8. Description M/O Command details M l Device identities M Result M te Text string M/O c l Item identifier M/O ue tia 5.6. Structure of envelope for menu selection Q n Please refer to GSM 11.14 subclause 8.2. e Description M/O Menu selection tag='D3' M fid Length M Device identities M Item identifier M Con Help request O GSM_STK_ATC_V1.1 - 28 - Quectel Wireless Solutions Co., Ltd. Room 501, Building 9, No.99, Tianzhou Road, Shanghai, China 200233 Tel: +86 21 5108 2965 Mail: info@quectel.com

GSM STK BIP Application Note GSM/GPRS Module Series Rev. GSM_STK_BIP_Application_Note_V3.2 Date: 2015-05-11 www.quectel.com GSM/GPRS Module Series GSM STK BIP Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx Or Email: Support@quectel.com tel GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO CHANGE WITHOUT PRIOR NOTICE. fide COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS n DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_STK_BIP_Application_Note Confidential / Released 1 / 32 GSM/GPRS Module Series GSM STK BIP Application Note About the document History Revision 3.0 3.1 3.2 Date 2013-02-03 l 2013-11-13 CQouneficdteential 2015-05-11 Author Vicent GAO Vicent GAO Vicent GAO Description Initial Added new chapter: Example of STK BIP Functions Added applicable modules GSM_STK_BIP_Application_Note Confidential / Released 2 / 34 GSM/GPRS Module Series GSM STK BIP Application Note Contents About the document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 1 Introduction .......................................................................................................................................... 6 2 STK BIP Functions............................................................................................................................... 7 2.1. OPEN CHANNEL Related To GPRS .......................................................................................... 7 2.1.1. Command Structure ......................................................................................................... 7 2.1.2. Example And Analysis...................................................................................................... 8 3 2.2. CLOSE CHANNEL...................................................................................................................... 9 2.2.1. Command Structure ......................................................................................................... 9 2.2.2. Example And Analysis.................................................................................................... 10 2.3. RECEIVE DATA ........................................................................................................................ 11 l 2.3.1. Command Structure ....................................................................................................... 11 2.3.2. Example And Analysis.................................................................................................... 11 te 2.4. SEND DATA .............................................................................................................................. 12 2.4.1. Command Structure ....................................................................................................... 12 c l 2.4.2. Example And Analysis.................................................................................................... 13 ue tia STK BIP Functions Procedure.......................................................................................................... 14 3.1. OPEN CHANNEL Related To GPRS ........................................................................................ 14 3.1.1. Common Procedure ....................................................................................................... 14 Q n 3.1.2. Detailed Procedure ........................................................................................................ 15 3.1.3. TERMINAL RESPONSE ................................................................................................ 16 e 3.2. CLOSE CHANNEL.................................................................................................................... 17 fid 3.2.1. Common Procedure ....................................................................................................... 17 3.2.2. Detailed Procedure ........................................................................................................ 17 3.2.3. TERMINAL RESPONSE ................................................................................................ 18 n 3.3. RECEIVE DATA ........................................................................................................................ 19 3.3.1. Common Procedure ....................................................................................................... 19 o 3.3.2. Detailed Procedure ........................................................................................................ 19 C 3.3.3. TERMINAL RESPONSE ................................................................................................ 20 3.4. SEND DATA .............................................................................................................................. 22 3.4.1. Common Procedure ....................................................................................................... 22 3.4.2. Detailed Procedure ........................................................................................................ 22 3.4.3. TERMINAL RESPONSE ................................................................................................ 23 4 Example of STK BIP Functions ........................................................................................................ 25 5 SIMPLE-TLV Data Objects ................................................................................................................ 27 5.1. Bearer Description .................................................................................................................... 27 5.1.1. Bearer Parameters For GPRS/Packet Service.............................................................. 27 5.2. Buffer Size................................................................................................................................. 28 GSM_STK_BIP_Application_Note Confidential / Released 3 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 5.3. Network Access Name .............................................................................................................. 28 5.4. SIM/ME Interface Transport Level ............................................................................................ 29 5.5. Other Address ........................................................................................................................... 29 5.6. Channel Data Length ................................................................................................................ 30 5.7. Channel Data ............................................................................................................................ 31 6 Tag Values .......................................................................................................................................... 32 6.1. SIMPLE-TLV Tags In Both Directions ....................................................................................... 32 6.2. Type Of Command And Next Action Indication......................................................................... 33 7 Appendix A Reference....................................................................................................................... 34 CQouneficdteenl tial GSM_STK_BIP_Application_Note Confidential / Released 4 / 34 GSM/GPRS Module Series GSM STK BIP Application Note Table Index TABLE 1: COMMAND STRUCTURE OF OPEN CHANNEL RELATED TO GPRS ............................................ 7 TABLE 2: COMMAND STRUCTURE OF CLOSE CHANNEL............................................................................. 9 TABLE 3: COMMAND STRUCTURE OF RECEIVE DATA ................................................................................11 TABLE 4: COMMAND STRUCTURE OF SEND DATA ..................................................................................... 12 TABLE 5: TERMINAL RESPONSE STRUCTURE OF OPEN CHANNEL RELATED TO GPRS ...................... 16 TABLE 6: TERMINAL RESPONSE STRUCTURE OF CLOSE CHANNEL ...................................................... 18 TABLE 7: TERMINAL RESPONSE STRUCTURE OF RECEIVE DATA ........................................................... 20 TABLE 8: TERMINAL RESPONSE STRUCTURE OF SEND DATA ................................................................. 23 TABLE 9: STRUCTURE OF BEARER DESCRIPTION..................................................................................... 27 TABLE 10: STRUCTURE OF BUFFER SIZE.................................................................................................... 28 TABLE 11: STRUCTURE OF NETWORK ACCESS NAME .............................................................................. 28 TABLE 12: STRUCTURE OF SIM/ME INTERFACE TRANSPORT LEVEL...................................................... 29 TABLE 13: STRUCTURE OF OTHER ADDRESS ............................................................................................ 29 l TABLE 14: STRUCTURE OF CHANNEL DATA LENGTH ................................................................................ 30 TABLE 15: STRUCTURE OF CHANNEL DATA ................................................................................................ 31 te TABLE 16: STRUCTURE OF CR ...................................................................................................................... 32 TABLE 17: VALUE OF CR................................................................................................................................. 32 c l TABLE 18: LIST OF TAG VALUE ...................................................................................................................... 32 ue tia TABLE 19: TYPE OF COMMAND ..................................................................................................................... 33 TABLE 20: RELATED DOCUMENTS ................................................................................................................ 34 CQonfiden TABLE 21: TERMS AND ABBREVIATIONS...................................................................................................... 34 GSM_STK_BIP_Application_Note Confidential / Released 5 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 1 Introduction This document mainly introduces how to develop functions about STK BIP for AP. Note that the GSM module which the AP uses shall support class 'e'. This document is applicable to all Quectel GSM modules except for GCxx modules. CQouneficdteenl tial GSM_STK_BIP_Application_Note Confidential / Released 6 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 2 STK BIP Functions STK BIP contains four functions for OPEN CHANNEL, CLOSE CHANNEL, RECEIVE DATA, and SEND DATA. The SIM uses STK BIP functions to indicate that the ME has been interacted with the network. This chapter introduces the structure of STK BIP function and gives corresponding example. 2.1. OPEN CHANNEL Related to GPRS l This command is used for SIM to tell AP to activate a PDP context and establish a network connection. cte l 2.1.1. Command Structure ue tia Table 1: Command Structure of OPEN CHANNEL Related to GPRS Description Section M/O Min Q n Proactive SIM command tag 13.2 M Y e Length (A+B+C+D+E+F+G+H+I+J) - M Y fid Command details 12.6 M Y Device identities 12.7 M Y n Alpha identifier Co Icon identifier 12.2 O N 12.31 O N Length 1 1 or 2 A B C D Bearer description 12.52 M Y E Buffer size 12.55 M Y F Network Access Name 12.61 O N G Other address (local address) 12.58 O N H SIM/ME interface transport level 12.59 O N I GSM_STK_BIP_Application_Note Confidential / Released 7 / 34 Data destination address 15.58 GSM/GPRS Module Series GSM STK BIP Application Note O N J 2.1.2. Example and Analysis Original octets: D0348103014001820281820500B50702010403041F0239020200C70E046D326D63087765627472696 16CBC03012EE1BE0521D47B0A1B Analysis result: D0: SIM proactive command tag 34: Length is 52 8103014001: Command detail 81: Command detail tag l 03: Length is 3 01: Command number te 40: Command type, represent for OPEN CHANNEL 01: Command qualifier uec tial 82028182:Device identities 82: Device identities tag 02: Length is 2 Q n 81: Source device identity, represent for SIM 82: Destination device identity, represent for ME e 0500: Alpha identifier fid 05: Alpha identifier tag 00: Length is 00 n B50702010403041F02: Bearer description o B5: Bearer description tag 07: Length is 7 C 02: Bearer type, reserved for GSM/3GPP 01: Precedence class, of +CGQREQ 04: Delay class, of +CGQREQ 03: Reliability class, of +CGQREQ 04: Peak throughput class, of +CGQREQ 1F: Mean throughput class, of +CGQREQ 02: Packet data protocol type, represent for IP, of +CGQREQ 39020200: Buffer size 39: Buffer size tag GSM_STK_BIP_Application_Note Confidential / Released 8 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 02: Length is 2 0200: Buffer size is 512 bytes C70E046D326D6308776562747269616C: Network access name C7: Network access name tag 0E: Length is 14 04: Length of APN network identifier 6D326D63: APN network identifier, represent for m2mc 08: Length of APN operator identifier 776562747269616C: APN operator identifier, represent for webtrial BC03012EE1: SIM/ME interface transport level BC: SIM/ME interface transport level tag 03: Length is 3 01: UDP 2EE1: Port number, represent for 12001 l BE0521D47B0A1B: Data destination te BE: Data destination tag 05: Length is 5 c l 21: Type of address, represent for IPv4 ue tia D47B0A1B: Address, represent for 212.123.10.27 (IP Address) NOTE Q n About how to OPEN CHANNEL with module, please refer to the document e 'GSM_TCPIP_Application_Note_V1.1.pdf'. fid 2.2. CLOSE CHANNEL Con This command is used for SIM to tell AP to close previous opened network connection. 2.2.1. Command Structure Table 2: Command Structure of CLOSE CHANNEL Description Section M/O Proactive SIM command tag 13.2 M Length (A+B+C+D) - M Min Length Y 1 Y 1 or 2 GSM_STK_BIP_Application_Note Confidential / Released 9 / 34 Command details Device identities Alpha identifier Icon identifier 12.6 12.7 12.2 12.31 GSM/GPRS Module Series GSM STK BIP Application Note M Y A M Y B O N C O N D 2.2.2. Example And Analysis Original octets: D00B8103014100820281210500 Analysis result: D0: SIM proactive command tag l 0B: Length is 11 te 8103014100: Command detail c l 81: Command detail tag 03: Length is 3 ue tia 01:Commandnumber 41: Command type, represent for CLOSE CHANNEL 00: Command qualifier Q n 82028121: Device identities e 82: Device identities tag fid 02: Length is 2 81: Source device identity, represent for SIM 21: Destination device identity, represent for CHANNEL 1 n 0500: Alpha identifier o 05: Alpha identifier tag C 00: Length is 00 NOTE About how to CLOSE CHANNEL with module, please refer to the document 'GSM_TCPIP_Application_Note_V1.1.pdf'. GSM_STK_BIP_Application_Note Confidential / Released 10 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 2.3. RECEIVE DATA This command is used for SIM to tell AP to receive data from previous established network connection. 2.3.1. Command Structure Table 3: Command Structure of RECEIVE DATA Description Section M/O Min Length Proactive SIM command tag 13.2 M Y 1 Length (A+B+C+D+E) Command details l Device identities te Alpha identifier c l Icon identifier ue tia Channel datalength 12.6 12.7 12.2 12.31 12.54 Q n 2.3.2. Example and Analysis fide Original octets: D00E8103014200820281210500370120 n Analysis result: D0: SIM proactive command tag Co 0E: Length is 14 M Y 1 or 2 M Y A M Y B O N C O N D M Y E 8103014200: Command detail 81: Command detail tag 03: Length is 3 01: Command number 42: Command type, represent for RECEIVE DATA 00: Command qualifier 82028121: Device identities 82: Device identities tag GSM_STK_BIP_Application_Note Confidential / Released 11 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 02: Length is 2 81: Source device identity, represent for SIM 21: Destination device identity, represent for CHANNEL 1 0500: Alpha identifier 05: Alpha identifier tag 00: Length is 00 370120: Channel data length 37: Channel data length tag 01: Length is 00 20: Channel data length is 32 NOTE About how to RECEIVE DATA with module, please refer to the document l 'GSM_TCPIP_Application_Note_V1.1.pdf'. cte l 2.4. SEND DATA ue tia This command is used for SIM to tell AP to send data to previously established network connection. Q n 2.4.1. Command Structure fide Table 4: Command Structure of SEND DATA Description Section M/O n Proactive SIM command tag 13.2 M Co Length (A+B+C+D+E) - M Min Length Y 1 Y 1 or 2 Command details 12.6 M Y A Device identities 12.7 M Y B Alpha identifier 12.2 O N C Icon identifier 12.31 O N D Channel data 12.53 M Y E GSM_STK_BIP_Application_Note Confidential / Released 12 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 2.4.2. Example and Analysis Original octets: D03D81030143018202812105003630415234202B330829408080005529995A0102340302F4803514FF FFFFFF7F1F00DFFF00001F43081106000000003E0100 Analysis result: D0: SIM proactive command tag 3D: Length is 61 8103014301: Command detail 81: Command detail tag 03: Length is 3 01: Command number 43: Command type, represent for SEND DATA l 01: Command qualifier te 82028121: Device identities 82: Device identities tag c l 02: Length is 2 ue tia 81: Source device identity, represent for SIM 21: Destination device identity, represent for CHANNEL 1 Q n 0500: Alpha identifier 05: Alpha identifier tag e 00: Length is 00 fid 3630415234202B330829408080005529995A0102340302F4803514FFFFFFFF7F1F00DFFF00001 F43081106000000003E0100: Channel data 36: Channel data tag n 30: Length is 48 415234202B330829408080005529995A0102340302F4803514FFFFFFFF7F1F00DFFF00001F430 Co 81106000000003E0100: SDU (Needed send data) NOTE About how to SEND DATA with module, please refer to the document 'GSM_TCPIP_Application_Note_V1.1.pdf'. GSM_STK_BIP_Application_Note Confidential / Released 13 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 3 STK BIP Functions Procedures This chapter introduces the procedures for STK BIP functions and corresponding syntax of TERMINAL RESPONSE. 3.1. OPEN CHANNEL Related to GPRS This command is used for SIM to tell AP to activate a PDP context and establish a network connection. l 3.1.1. Common Procedure cte l SIM AP NW Proactive SIM command: OPEN ue tia CHANNEL Activate a PDP context, then open a Q n network connection fide TERMINAL RESPONSE (command Con performed successfully) Open a network connection successfully Figure 1: OPEN CHANNEL Related to GPRS GSM_STK_BIP_Application_Note Confidential / Released 14 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 3.1.2. Detailed Procedure Upon receiving this command, the ME shall decide if it is able to execute the command. Examples are given below, but the list is not exhaustive:  If immediate PDP context activation is requested and the ME is unable to set-up a channel using the exact parameters provided by the SIM, the ME sets up the channel using the best parameters it can support and informs the SIM of the channel identifier and the modified parameters using TERMINAL RESPONSE (Command performed with modification);  If immediate PDP context activation is requested and the ME is unable to activate the PDP context       with the network using the exact parameters provided by the SIM, the ME informs the SIM using TERMINAL RESPONSE (Network currently unable to process command). The operation is aborted; If on demand link establishment is requested and the ME is unable to set-up a channel using the l exact parameters provided by the SIM, the ME sets up the channel using the best parameters it can support and informs the SIM of the channel identifier and the modified parameters using TERMINAL te RESPONSE (Command performed with modification); c l If the command is rejected because the ME has no channel left with the requested bearer capabilities, ue tia the ME informs the SIM using TERMINAL RESPONSE (Bearer independent protocol error). The operation is aborted; Q n If the user does not accept the channel set-up, the ME informs the SIM using TERMINAL RESPONSE (User did not accept the proactive command). The operation is aborted; e If the user has indicated the need to end the proactive SIM session, the ME informs the SIM using fid TERMINAL RESPONSE (Proactive SIM session terminated by the user). The operation is aborted; If the command is rejected because the class B ME is busy on a call, the ME informs the SIM using n TERMINAL RESPONSE (ME unable to process command - currently busy on call). The operation is aborted; Co If the command is rejected because the class B ME is busy on a SS transaction, the ME informs the SIM using TERMINAL RESPONSE (ME unable to process command - currently busy on SS transaction). The operation is aborted; The ME shall inform the SIM that the command has been successfully executed using TERMINAL RESPONSE:  If immediate PDP context activation is requested, the ME allocates buffers, activates the PDP context and informs the SIM and reports the channel identifier using TERMINAL RESPONSE (Command performed successfully); GSM_STK_BIP_Application_Note Confidential / Released 15 / 34 GSM/GPRS Module Series GSM STK BIP Application Note  If on demand PDP context activation is requested, the ME allocates buffers, informs the SIM and reports the channel identifier using TERMINAL RESPONSE (Command performed successfully); 3.1.3. TERMINAL RESPONSE 3.1.3.1. TERMINAL RESPONSE (Command Performed Successfully) Table 5: TERMINAL RESPONSE Structure of OPEN CHANNEL Related to GPRS Description Section M/O Length (byte) Command details 12.6 M A Device identities 12.7 M B l Result 12.12 M C te Channel status 12.56 M D c l Example and analysis ue tia Originaloctets: 81030140018202828183010038028100 Q n Analysis result: e 8103014001: Command details fid 81: Command details tag 03: Length is 3 01: Command number n 40: Command type, represent for OPEN CHANNEL o 82028281: Device identities C 82: Device identities tag 02: Length is 2 82: Source device identity, represent for ME 81: Destination device identity, represent for SIM 830100: Result 83: Result tag 01: Length is 1 00: Command performed successfully 38028100: Channel status GSM_STK_BIP_Application_Note Confidential / Released 16 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 38: Channel status tag 02: Length is 2 8100: Channel status, represent for channel identifier is 1 and link established or PDP context activated 3.2. CLOSE CHANNEL This command is used for SIM to tell AP to close previously established network connection. 3.2.1. Common Procedure SIM AP NW Proactive SIM command: CLOSE l CHANNEL teClose the network connection Quec ntial TERMINALRESPONSE(command performed successfully) Close the network connection successfully Confide Figure 2: CLOSE CHANNEL 3.2.2. Detailed Procedure Upon receiving this command, the ME shall decide if it is able to execute the command:  If the command is rejected because the channel identifier is not valid, the ME informs the SIM using TERMINAL RESPONSE (Bearer independent protocol error); GSM_STK_BIP_Application_Note Confidential / Released 17 / 34 GSM/GPRS Module Series GSM STK BIP Application Note  If the command is rejected because the requested channel is in error, the ME informs the SIM using TERMINAL RESPONSE (Bearer independent protocol error);  If the ME is able to process the command:  ME shall release the data transfer, discard the remaining data and inform the SIM that the command has been successfully executed, using TERMINAL RESPONSE; 3.2.3. TERMINAL RESPONSE 3.2.3.1. TERMINAL RESPONSE (Command Performed Successfully) Table 6: TERMINAL RESPONSE Structure of CLOSE CHANNEL Description Section M/O l Command details 12.6 M te Device identities 12.7 M c l Result 12.12 M ue tia Example and analysis Q n Original octets: e 81030141018202828183010038028100 fid Analysis result: 8103014101: Command details 81: Command details tag n 03: Length is 3 01: Command number Co 41: Command type, represent for CLOSE CHANNEL Length (byte) A B C 82028281: Device identities 82: Device identities tag 02: Length is 2 82: Source device identity, represent for ME 81: Destination device identity, represent for SIM 830100: Result 83: Result tag 01: Length is 1 GSM_STK_BIP_Application_Note Confidential / Released 18 / 34 00: Command performed successfully GSM/GPRS Module Series GSM STK BIP Application Note 3.3. RECEIVE DATA This command is used for SIM to tell AP to receive data from previously established network connection. 3.3.1. Common Procedure SIM AP NW Proactive SIM command: RECEIVE DATA uectel tial TERMINAL RESPONSE (command performed successfully) Receive data request Received data is here CQonfiden 3.3.2. Detailed Procedure Figure 3: RECEIVE DATA Upon receiving this command, the ME shall return the data available in the Rx buffer corresponding to the Channel identifier. Examples are given below, but the list is not exhaustive: If the ME is unable to process the command:  If the command is rejected because the requested channel is already closed the ME informs the SIM using TERMINAL RESPONSE (Bearer independent protocol error); GSM_STK_BIP_Application_Note Confidential / Released 19 / 34 GSM/GPRS Module Series GSM STK BIP Application Note  If the user has indicated the need to end the proactive SIM session, the ME informs the SIM using TERMINAL RESPONSE (Proactive SIM session terminated by the user). If the ME is able to process the command:  If the requested number of bytes is available in the buffer, the ME shall inform the SIM that the command has been successfully executed, using TERMINAL RESPONSE and return the requested data and the number of bytes remaining in the channel buffer (or FF if more than the maximum bytes remains).  If the requested number of bytes is available in the buffer but the whole requested data cannot be included in the TERMINAL RESPONSE because of APDU size limits, the ME shall return the maximum number of bytes possible according to the length of other TLVs. The ME shall inform the SIM that the command has been successfully executed, using TERMINAL RESPONSE and shall indicate the number of bytes remaining in the channel buffer (or FF if more than the maximum bytes remains). l  If the requested number of bytes is not yet available in the buffer, the ME shall NOT wait for the te requested number of bytes to arrive. The ME shall inform the SIM, using TERMINAL RESPONSE (Command performed with missing information) and returns the data currently available in the c l channel buffer. ue tia  In the case of packet/datagram transmission, the ME shall put in the Rx buffer a complete packet SDU and only one at one time. For example, if UDP datagrams are received by the ME, the latter shall insert only the SDU of each UDP packet received in the Rx buffer. After one SDU has been Q n downloaded by the SIM (using one or several RECEIVE DATA commands), the ME shall insert the e next SDU of UDP datagram, and so on. fid  If the alpha identifier is provided by the SIM, the ME shall use it to inform the user. The ME may also use it to inform the user during data transfer. If an icon is provided by the SIM, the icon indicated in the command may be used by the ME to inform the user, in addition to, or instead of the alpha n identifier, as indicated with the icon qualifier (see sub-clause 6.5.4). Co 3.3.3. TERMINAL RESPONSE 3.3.3.1. TERMINAL RESPONSE (Command Performed Successfully) Table 7: TERMINAL RESPONSE Structure of RECEIVE DATA Description Section M/O Command details 12.6 M Length (byte) A GSM_STK_BIP_Application_Note Confidential / Released 20 / 34 GSM/GPRS Module Series GSM STK BIP Application Note Device identities 12.7 M B Result 12.12 M C Channel data 12.53 M D Channel data length 12.54 M E Example and analysis Original octets: 8103014201820282818301003606313233343536370100 Analysis result: 8103014201: Command details 81: Command details tag l 03: Length is 3 01: Command number te 42: Command type, represent for RECEIVE DATA c l 82028281: Device identities ue tia 82: Device identities tag 02: Length is 2 82: Source device identity, represent for ME 81: Destination device identity, represent for SIM Q en 830100: Result 83: Result tag fid 01: Length is 1 00: Command performed successfully n 3606313233343536: Channel data 36: Channel data tag o 06: Length is 6 C 313233343536: Channel data 370100: Channel data length 37: Channel data length tag 01: Length is 1 00: Channel data length is 0, represent for remain byte in received channel data buffer is 0 GSM_STK_BIP_Application_Note Confidential / Released 21 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 3.4. SEND DATA This command is used for SIM to tell AP to send data to previously established network connection. 3.4.1. Common Procedure SIM AP NW Proactive SIM command: SEND DATA tel TERMINAL RESPONSE (command performed successfully) Send data Queficdential Figure 4: SEND DATA 3.4.2. Detailed Procedure on Upon receiving this command, the ME shall either immediately send data or store provided data into the C Tx buffer corresponding to the Channel identifier. Examples as given below, but the list is not exhaustive: If the ME is unable to process the command:  If the command is rejected because the requested channel is already closed the ME informs the SIM using TERMINAL RESPONSE (Bearer Independent Protocol error – channel identifier not valid);  If the command is rejected because the ME could not establish the link (after OPEN CHANNEL (on demand)) or the link was dropped, the ME informs the SIM using TERMINAL RESPONSE (Bearer Independent Protocol error – channel closed); GSM_STK_BIP_Application_Note Confidential / Released 22 / 34 GSM/GPRS Module Series GSM STK BIP Application Note  If the command is rejected because the channel is temporarily unavailable the ME informs the SIM using TERMINAL RESPONSE (ME currently unable to process command);  If the requested number of bytes of empty space is not yet available in the buffer the ME informs the SIM using TERMINAL RESPONSE (Bearer Independent Protocol error);  If the user has indicated the need to end the proactive SIM session, the ME informs the SIM using TERMINAL RESPONSE (Proactive SIM session terminated by the user). If the ME is able to process the command:  if the requested number of bytes of empty space is available in the buffer the ME shall inform the SIM that the command has been successfully executed, using TERMINAL RESPONSE and return the number of bytes of empty space available in the Tx buffer (or FF if more then 255 bytes are available); l  In the case of packet/datagram transmission, the structure of the SDU sent by the SIM to the ME te shall be fully respected while sending to the ME external interface. The size of the SDU is therefore limited by the size of the packet PDU sent over the ME external interface. In order to send one c l complete SDU, the SAT application may fill the Tx buffer with several SEND DATA commands, if ue tia necessary. Then the ME shall send the complete SDU in one packet PDU;  If the alpha identifier is provided by the SIM, the ME shall use it to inform the user. The ME may also use it to inform the user during data transfer. If an icon is provided by the SIM, the icon indicated in Q n the command may be used by the ME to inform the user, in addition to, or instead of the alpha e identifier, as indicated with the icon qualifier (see sub-clause 6.5.4). fid 3.4.3. TERMINAL RESPONSE n 3.4.3.1. TERMINAL RESPONSE (Command Performed Successfully) Co Table 8: TERMINAL RESPONSE Structure of SEND DATA Description Section M/O Length (byte) Command details 12.6 M A Device identities 12.7 M B Result 12.12 M C Channel data length 12.54 M E GSM_STK_BIP_Application_Note Confidential / Released 23 / 34 GSM/GPRS Module Series GSM STK BIP Application Note Example and analysis Original octets: 8103014301820282818301003701FF Analysis result: 8103014301: Command details 81: Command details tag 03: Length is 3 01: Command number 43: Command type, represent for SEND DATA 82028281: Device identities 82: Device identities tag 02: Length is 2 82: Source device identity, represent for ME l 81: Destination device identity, represent for SIM te 830100: Result 83: Result tag c l 01: Length is 1 ue tia 00: Command performed successfully 3701FF: Channel data length 37: Channel data length tag Q n 01: Length is 1 e 00: Channel data length is 255, represent for bytes of empty send channel data buffer is more than Confid 255 GSM_STK_BIP_Application_Note Confidential / Released 24 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 4 Example of STK BIP Functions This clause only gives a simple example for using STK BIP functions. It may be different from the actual way. // After selecting STK BIP menu item, STK BIP functions begin to run. +STKPCI: 0,'D0348103014001820281820500B50702010403041F0239020200C70E046D326D630877656274726 9616CBC03012EE1BE0521D47B0A1B' // OPEN CHANNEL of STK BIP functions AT+QIOPEN='UDP','212.123.10.27',12001 // Visit the remote UDP server specified in OPEN l CHANNEL OK te CONNECT OK c l AT+QINDI=1 // Set the mode to handle the received data ue tia OK AT+STKTR='81030140018202828183010038028100' // OPEN CHANNEL is ready Q n OK e +STKPCI: 1,'D03D8103014301820281210500360431323334' // SEND DATA of STK BIP functions fid AT+QISEND=4 // Send 4 bytes data specified in SEND DATA to the remote server >1234 n SEND OK o AT+STKTR='8103014301820282818301003701FF' // SEND DATA is ready C OK +STKPCI: 1,'D00E8103014200820281210500370120' // RECEIVE DATA of STK BIP functions +QIRDI: 0,1,0 AT+QIRD=0,1,0,1500 // Received data in the buffer of the connection +QIRD: 212.123.10.27:12001,UDP,4 1234 OK AT+STKTR='8103014201820282818301003606313233343536370100' GSM_STK_BIP_Application_Note Confidential / Released 25 / 34 GSM/GPRS Module Series GSM STK BIP Application Note // RECEIVE DATA is ready OK +STKPCI: 1,' D00B8103014100820281210500 ' // CLOSE CHANNEL of STK BIP functions AT+QICLOSE // Close the session with the remote server CLOSE OK AT+STKTR='81030141018202828183010038028100' // CLOSE CHANNEL is ready OK // Example of STK BIP functions end NOTE About how to OPEN CHANNEL, CLOSE CHANNEL, RECEIVE DATA, SEND DATA, please refer to the CQouneficdteenl tial document 'GSM_TCPIP_Application_Note_V1.1.pdf'. GSM_STK_BIP_Application_Note Confidential / Released 26 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 5 SIMPLE-TLV Data Objects This chapter only lists data objects related to STK BIP functions. 5.1. Bearer Description This sub-clause applies only if class 'e' is supported. l Table 9: Structure of Bearer Description te Byte(s) c l 1 Description Bearer description tag ue tia 2 3 Q n 4 to (3+X) Length (X+1) Bearer type Bearer parameters fide Coding: 00 = User Termination. 01 = Error Termination. Con 5.1.1. Bearer Parameters For GPRS/Packet Service Length 1 1 1 X Contents: parameters describing the Quality of Service (QoS) and the type of PDP. This is an element of the PDP context. The default values of the sub-parameters are manufacturer specific since they depend on the purpose of the device and data services provided by it. Not all combinations and values of these sub-parameters are supported by GSM (refer TS 22.002 [30]). X (length of parameters) = 6. GSM_STK_BIP_Application_Note Confidential / Released 27 / 34 GSM/GPRS Module Series GSM STK BIP Application Note Coding: The following values are as defined in TS 27.007 [27], for the quality of Service profile requested '+CGQREQ' extended command. They are coded in hexadecimal.  Coding of Byte 4 - Precedence class: same as the 'precedence' subparameter, defined in TS 27.007 [27].  Coding of Byte 5 - Delay class: same as the 'delay' subparameter, defined in TS 27.007 [27].  Coding of Byte 6 - Reliability class: same as the 'reliability' subparameter, defined in TS 27.007 [27].  Coding of Byte 7 - Peak throughput class: same as the 'peak' subparameter, defined in TS 27.007 [27].  Coding of Byte 8 - Mean throughput class: same as the 'mean' subparameter, defined in TS 27.007 [27].  Coding of Byte 9 - Packet data protocol type: '02' = IP (Internet Protocol, IETF STD 5); All other values are reserved. l 5.2. Buffer Size te This sub-clause applies only if class 'e' is supported. uec tial Table 10: Structure of Buffer Size Byte(s) Q en 1 fid 2 3 to 4 Description Buffer size tag Length (2) Buffer size Length 1 1 2 n The Buffer size codes the number of bytes requested by the SIM in an OPEN CHANNEL command or Co what the ME can offer the SIM (placed in TERMINAL RESPONSE). 5.3. Network Access Name Table 11: Structure of Network Access Name Byte(s) 1 Description Network Access Name tag Length 1 GSM_STK_BIP_Application_Note Confidential / Released 28 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 2 Length (X) 1 3 to 3+X-1 Network Access Name X Content: The Network Access Name is used to identify the Gateway entity, which provides interworking with an external packet data network. For GPRS, the Network Access Name is an APN. Coding: As defined in TS 23.003 [36]. 5.4. SIM/ME Interface Transport Level This sub-clause applies only if class 'e' is supported. l Table 12: Structure of SIM/ME Interface Transport Level te Byte(s) c l 1 Description SIM/ME interface transport level tag ue tia 2 3 Q n 4to5 Length (X) Transport protocol type Port number fide Transport protocol type coding: 01' : UDP (as defined in RFC 768 [33]) 02' : TCP (as defined in RFC 793 [34]) n All other value are reserved Co Port number coding: integer Length 1 1 1 2 5.5. Other Address Table 13: Structure of Other Address Byte(s) 1 Description Other address tag Length 1 GSM_STK_BIP_Application_Note Confidential / Released 29 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 2 Length (X) 1 3 Type of address 1 4 to (X+2) Address X-1 A null Local address shall be coded with Length = '00', and no Value part. In that case, the ME shall request a dynamic address. Coding of Type of address: according to packet data protocol address in TS 04.08 [8]. '21' = IPv4 address '57' = IPv6 address 'others' = reserved Coding of address: according to packet data protocol address in TS 04.08 [8]. l If type of address indicates IPv4, the Address information in octet 4 to octet 7 contains the IPv4 address. Bit 8 of octet 4 represents the most significant bit of the IP address and bit 1 of octet 7 the least significant te bit . c l If type of address indicates IPv6, the Address information in octet 4 to octet 19 contains the IPv6 address. ue tia Bit 8 of octet 4 represents the most significant bit of the IP address and bit 1 of octet 19 the least significant bit. Q en 5.6. Channel Data Length fid This sub-clause applies only if class 'e' is supported. n Table 14: Structure of Channel Data Length Co Byte(s) Description Length 1 Channel data length tag 1 2 Length (1) 1 3 Channel data length 1 The Channel data length codes: Either the number of bytes that are available in a channel buffer (Tx or Rx buffers negotiated during GSM_STK_BIP_Application_Note Confidential / Released 30 / 34 GSM/GPRS Module Series GSM STK BIP Application Note OPEN CHANNEL) using TERMINAL RESPONSE. Since the Tx or Rx buffer size can be larger than 255 bytes, 'FF' means 'more than 255 bytes are available'. Or the number of bytes that are requested in a RECEIVE DATA command. 5.7. Channel Data This sub-clause applies only if class 'e' is supported. Table 15: Structure of Channel Data Byte(s) 1 Description Channel data tag tel 2 to Y+1 (Y+2) to (Y+X+1) Length (X) Channel data string Length 1 Y X uec tial Contents: The Channel data object contains application data read from or written to a specific channel buffer in the ME. Q n Coding: Confide The Channel data string shall be considered by the ME as binary coded on 8 bits. GSM_STK_BIP_Application_Note Confidential / Released 31 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 6 Tag Values This chapter only lists data objects related to STK BIP functions. 6.1. SIMPLE-TLV Tags In Both Directions Table 16: Structure of CR l 8 7 6 5 4 3 2 1 te CR Tag Value c l CR: Comprehension required for this object. ue tia Unless otherwise stated, for SIMPLE-TLV data objects it is the responsibility of the SIM application and the ME to decide the value of the CR flag for each data object in a given command. Q n Handling of the CR flag at the receiving entity is described in sub-clause 6.10. fide Table 17: Value of CR CR n Comprehension required Co Comprehension not required Value 1 0 Table 18: List of Tag Value Description Bearer description tag Channel data tag Length of tag 1 1 Tag value, bits 1-7 (Range: ‘01’ - ‘7E’) '35' '36' Tag (CR and Tag value) '35' or 'B5' '36' or 'B6' GSM_STK_BIP_Application_Note Confidential / Released 32 / 34 Channel data length tag 1 Buffer size tag 1 SIM/ME interface transport level 1 Other address (data destination 1 address) Network Access Name 1 GSM/GPRS Module Series GSM STK BIP Application Note '37' '37' or 'B7' '39' '39' or 'B9' '3C' '3C' or 'BC' '3E' '3E' or 'BE' ‘47’ '47' or 'C7' 6.2. Type of Command and Next Action Indication The table below shows the values which shall be used for Type of Command coding (see sub-clause 12.6) and Next Action Indicator coding (see sub-clause 12.24). tel Table 19: Type of Command c l Value ue tia ‘40’ ‘41’ Q n ‘42’ Confide ‘43’ Name OPEN CHANNEL CLOSE CHANNEL RECEIVE DATA SEND DATA Used for Type of Command Used for Next Action Indicator coding coding X X X X X X X X GSM_STK_BIP_Application_Note Confidential / Released 33 / 34 GSM/GPRS Module Series GSM STK BIP Application Note 7 Appendix A Reference Table 20: Related Documents SN Document name Remark Digital cellular telecommunications system (Phase 2+); Specification of the SIM Application Toolkit for the [1] ETSI TS 101 267 V8.9.0 (2001-12) Subscriber Identity Module - Mobile Equipment (SIM-ME) interface (3GPP TS 11.14 version 8.9.0 l Release 1999) te 3rd Generation Partnership Project; Technical Specification Group Core Network and c l [2] 3GPP TS 27.007 V9.5.0 (2010-09) Terminals; AT command set for User Equipment (UE) ue tia (Release9) Q n Table 21: Terms and Abbreviations e Abbreviation fid ME SIM n BIP Co AP Description Mobile Equipment Subscriber Identity Module Bearer Independent Protocol Application NW Network TLV Tag Length Value GSM_STK_BIP_Application_Note Confidential / Released 34 / 34

Quectel Cellular Engine GSM UART Port Application Note GSM_UART_AN_V1.2 GSM UART Port Application Note Document Title Version Date Status Document Control ID GSM UART Port Application Note 1.2 2015-04-08 Release GSM_UART_AN_V1.2 General Notes Quectel offers this information as a service to its customers, to support application and engineering efforts that use the products designed by Quectel. The information provided is based upon requirements specifically provided to Quectel by the customers. Quectel has not undertaken any independent search for additional relevant information, including any information that may be in the customer’s possession. Furthermore, system validation of this product designed by Quectel within a larger electronic system remains the responsibility of the customer or the customer’s system integrator. All specifications supplied herein are l subject to change. te Copyright c l This document contains proprietary technical information which is the property of Quectel Limited., copying of this document and giving it to others and the using or communication of ue tia the contents thereof, are forbidden without express authority. Offenders are liable to the payment of damages. All rights reserved in the event of grant of a patent or the registration of a utility model or design. All specification supplied herein are subject to change without Q n notice at any time. Confide Copyright © Shanghai Quectel Wireless Solutions Co., Ltd. 2015 GSM_UART_AN_V1.2 - 1 - GSM UART Port Application Note Contents Contents ............................................................................................................................................2 Table Index........................................................................................................................................3 Figure Index ......................................................................................................................................4 0. Revision history ............................................................................................................................5 1. Introduction...................................................................................................................................6 2. Connection ....................................................................................................................................7 3. Level Shifter..................................................................................................................................8 3.1. Communicate with DTE......................................................................................................8 3.2. Communicate with the RS-232 port of PC..........................................................................9 4. Firmware Upgrade on board .......................................................................................................10 5. Flow control ................................................................................................................................ 11 5.1. Software flow control (XON/XOFF flow control)............................................................ 11 5.2. Hardware flow control (RTS/CTS flow control)............................................................... 11 l 6. Control Signals............................................................................................................................12 6.1. DCD ..................................................................................................................................12 te 6.2. DTR...................................................................................................................................12 c l 6.3. RI.......................................................................................................................................13 7. Baud Rate....................................................................................................................................15 ue tia 7.1. AT+IPR..............................................................................................................................15 CQonfiden 7.2. Autobauding ......................................................................................................................15 GSM_UART_AN_V1.2 - 2 - GSM UART Port Application Note Table Index TABLE 1: LOGIC LEVELS OF THE UART PORT ............................................................................... 8 TABLE 2:THE VOLTAGE OF RS-232 ................................................................................................... 9 TABLE 3: BEHAVIOURS OF THE RI.................................................................................................. 13 CQouneficdteenl tial GSM_UART_AN_V1.2 - 3 - GSM UART Port Application Note Figure Index FIGURE 1: CONNECTING TXD AND RXD ......................................................................................... 7 FIGURE 2: CONNECTING ALL SIGNALS........................................................................................... 7 FIGURE 3: THE REFERENCE LEVEL SHIFTER BY USING OPEN DRAIN .................................... 8 FIGURE 4: THE REFERENCE LEVEL SHIFTER BY USING BIPOLAR TRANSISTOR..................9 FIGURE 5: THE REFERENCE LEVEL SHIFTER BY USING SP3238................................................9 FIGURE 6: BLOCKING TXD OF MCU BY INSERTING A 1KΩ RESISTOR...................................10 FIGURE 7: DTR FOR WAKING UP.....................................................................................................12 FIGURE 8: RI BEHAVIOURS OF VOICE CALLING AS A RECEIVER ........................................... 13 FIGURE 9: RI BEHAVIOURS OF DATA CAKING AS A RECEIVER ............................................... 14 FIGURE 10: RI BEHAVIOURS AS A CALLER...................................................................................14 CQouneficdteenl tial FIGURE 11: RI BEHAVIOURS OF URC OR SMS RECEIVED.........................................................14 GSM_UART_AN_V1.2 - 4 - GSM UART Port Application Note 0. Revision history Revision 1.0 1.1 1.2 Date Author 2009-06-25 Jay XIN / Ken JI 2009-11-16 Doron ZHANG 2015-04-08 Wythe WANG Description of change Initial 1. Added the description of baud rate 2. Modified behavior of RI and Figure 8, 9, 10, 11 3. Modified figure 1, 2, 3, 4, 6. Added applicable modules CQouneficdteenl tial GSM_UART_AN_V1.2 - 5 - GSM UART Port Application Note 1. Introduction This document describes the UART port of Quectel GSM module and how to use it in customer’s application design. This document can help you quickly understand the UART port of the module. This document is applicable to all Quectel GSM modules. Note: AT command can be input through UART port only after module is powered on and the Unsolicited Result Code 'RDY' is output (if the module is set to autobauding mode, 'RDY' is not output. Please refer to Chapter 7 for autobauding description). CQouneficdteenl tial GSM_UART_AN_V1.2 - 6 - GSM UART Port Application Note 2. Connection Data Terminal Equipment (DTE), such as MCU or External controller, can communicates with the module through its main UART port which can implement AT command, GPS transfer, update firmware. The voltage level of UART port interface is 2.8 Volts. If the voltage level of DTE’s UART pins doesn’t match with the module, level shifter circuit should be inserted. The UART pins include transmitting data (TXD), Receiving data (RXD), Request To Send (RTS), Clear To Send (CTS), Data Terminal Ready (DTR). Data Carrier Detect (DCD) and Ring Indicator (RI). Not all UART pins are necessary in customer’s application. If the module is used as a modem, all pins are needed. The modem control signal RI can be used to indicate to the DTE that a call or Unsolicited Result Code (URC) is received. Hardware handshake using the RTS and CTS signals and XON/XOFF software flow control are both supported. l Module (DCE) te Serial Port c l TXD ue tia RXD Q n GND MCU (DTE) Serial Port TXD RXD GND e Figure 1: Connecting TXD and RXD fid Module (DCE) nSerial Port CoTXD MCU (DTE) Serial Port TXD RXD RXD RTS RTS CTS CTS DTR DTR DCD DCD RI RING Figure 2: Connecting all signals GSM_UART_AN_V1.2 - 7 - GSM UART Port Application Note 3. Level Shifter Normally, the voltage of VDD_EXT is 2.8V and the DC characteristics of UART port are listed in Table 1. Table 1: Logic levels of the UART port Symbol MIN MAX Unit VIL 0 0.67 V VIH 1.7 VDD_EXT+0.3 V VOL 0 0.34 V VOH 2.0 VDD_EXT V NOTE: If the voltage level of UART pins in DTE doesn’t match with the module, a level shifter circuit should be inserted. tel 3.1. Communicate with DTE c l It is recommended to design the level shift circuit by choosing open drain output buffer (e.g. NC7WZ07) or discrete transistor. ue tia Note: VDD_EXT is supplied by the module (2.8V). VCC_MCU is the voltage for host MCU UART interface. Q en VDD_EXT fid Module (DCE) Serial port n TXD CoRXD 10K 1K VCC_MCU Level shift IC IN OUT OUT IN 10K MCU (DTE) RXD TXD Figure 3: The reference level shifter by using open drain GSM_UART_AN_V1.2 - 8 - GSM UART Port Application Note Module (DCE) Serial port TXD VDD_EXT 4.7K VCC_MCU 4.7K MCU (DTE) RXD 1K RXD TXD 4.7K VDD_EXT 4.7K VCC_MCU Figure 4: The reference level shifter by using bipolar transistor 3.2. Communicate with the RS-232 port of PC l Table 2: The voltage of RS-232 te Logic level Logic 0 c l Logic1 ue tia Undefined Transmitter capable Receiver capable Unit +5~+15 +3~+25 V -5~-15 -3~-25 V -3~+3 V CQonfiden It is suggested to design the level shifter by using RS-232 transceivers, e.g. SP3238E or MAX3221. Figure 5: The reference level shifter by using SP3238 If only the RXD and TXD pins need to be connected, MAX3221 could be chosen for the level shifter. GSM_UART_AN_V1.2 - 9 - GSM UART Port Application Note 4. Firmware Upgrade on board To upgrade module firmware in the future, it is strongly recommended to reserve 5 test points in host board according to the description in the document of GSM_FW_UPGRADE_AN. In most applications, there is an external MCU controlling the module. In this case, a suitable resistor should be inserted between the TXD of the external MCU and the RXD of the module as shown is Fifure 6. The resistor is used to block the signal of TXD in the external MCU when the firmware upgrade connection is established in a reserved IO connector or the test points. The PWERKEY should be pulled down during firmware upgrade period. If the module to be upgraded can’t be powered by the host board, an external power supply from the VBAT pin of the IO connector or the test points would be required. Module (DCE) Serial port l TXD te RXD c l GND ue tia PWRKEY VBAT MCU (DTE) RXD TXD 1K GND Q en IO Connector or Test Points Confid Figure 6: Blocking TXD of MCU by inserting a 1KΩ resistor GSM_UART_AN_V1.2 - 10 - GSM UART Port Application Note 5. Flow control Flow control is essential to prevent loss of data or avoid errors when, in a data or fax call, the sending device is transferring data faster than the receiving side is ready to accept. When the receiving buffer reaches its capacity, the receiving device should be capable to cause the sending device to pause until it catches up. There are basically two approaches to achieve data flow control: software flow control and hardware flow control. 5.1. Software flow control (XON/XOFF flow control) Software flow control sends different characters to stop (XOFF, decimal 19) and resume (XON, l decimal 17) data flow. It is quite useful in some applications that only use three wires on the serial interface. te The default flow control approach of the module is hardware flow control (RTS/CTS flow control). c l To enable software flow control in the DTE interface and within GSM engine, type the following AT command: ue tia AT+IFC=1,1 This setting is stored volatile. In order to keep this configuration, AT&W should be executed to Q n save the configuration in the user profile. e To use the software control of module, ensure using software flow control in communication fid software package such as ProComm, Hyper Terminal and WinFax Pro. NOTE: n Software Flow control should not be used for data calls where binary data will be transmitted or received (e.g. TCP/IP) as the DTE interface may interpret binary data as flow control Co characters. 5.2. Hardware flow control (RTS/CTS flow control) Hardware flow control achieves the data flow control by controlling the RTS/CTS line. When the data transfer should be suspended at the module side, the CTS line is set inactive until the transfer from the receiving buffer of module has completed. When the receiving buffer is ok to receive more data, CTS goes active once again. To achieve hardware flow control, ensure that the RTS/CTS lines are present on your application platform. GSM_UART_AN_V1.2 - 11 - GSM UART Port Application Note 6. Control Signals 6.1. DCD The DCD pin will be active (low) after establishing a data connection. When the data connection is turned off, the DCD pin will go to inactive (high). 6.2. DTR The module would automatically go into SLEEP mode, if the DTR is set to high level, and 'AT+QSCLK=1' has been already set, and that there is no specific task for the module to handle. In this case, the current consumption of module will reduce to the minimal level. During the SLEEP mode, the module can still receive paging message and SMS normally. If the DTR Pin is pulled l down, the module would exit from SLEEP mode. The UART port will be active if the DTR is changed to low level for 20ms and after the UART port is waited for about 600ms again. cte l DTE can use the DTR pin to control the active or inactive state of the SLEEP mode as shown in Figure 7. ue tia Module(DCE) Serial Port MCU (DTE) Serial Port Q en DTR Level Shift DTR nfid Figure 7: DTR for waking up o The DTR pin can also be used to switch from data mode to command mode. To use this method, C AT&D1 should be set firstly. Depending on the state of the DTR pin, there are 2 ways to implement this function. 1. If the DTR pin is set to low in data mode, setting it to high for about 600ms would result in switching to command mode. 2. If the DTR pin is set to high in data mode, pulling it to low level for about 1000ms and then pulling it up for about 600ms would also switch the module from data mode to command mode. When the module successfully switches from data mode to command mode, a URC 'OK' will be returned to indicate the command mode. GSM_UART_AN_V1.2 - 12 - GSM UART Port Application Note Note: The setting AT&D1 can be stored using AT&W.. 6.3. RI If the module acts as a caller, the RI pin would keep high level except URC or SMS is received. On the other hand, when it is used as a receiver, the timing of the RI is shown in Table 3. Table 3: Behaviours of the RI State RI respond Standby HIGH Voice calling Change to LOW, then: (1) Change to HIGH when call is established. tel Data calling Quec ntial SMS fide URC (2) Use ATH to hang up the call, change to HIGH (3) Calling part hangs up, change to HIGH first, and change to LOW for 120ms indicating 'NO CARRIER' as an URC, then change to HIGH again. (4) Change to HIGH when SMS is received. Change to LOW, then： (1) Change to HIGH when data connection is established. (2) Use ATH to hang up the data calling, change to HIGH (3) Calling part hangs up, change to HIGH first, and change to LOW for 120ms indicating 'NO CARRIER' as an URC, then change to HIGH again. (4) Change to HIGH when SMS is received. When a new SMS comes, the RI changes to LOW and holds low level for about 120 ms, then changes to HIGH. Certain URCs can trigger 120ms low level on RI. For more details of URC, please refer to the AT Commands Set. RI Con HIGH LOW Idle Off-hook by 'ATA'. On-hook by 'ATH'. Ring SMS received Figure 8: RI Behaviours of voice calling as a receiver GSM_UART_AN_V1.2 - 13 - GSM UART Port Application Note RI HIGH LOW Idle Data calling establish. On-hook Ring by 'ATH'. SMS received Figure 9: RI Behaviours of data caking as a receiver RI HIGH . . . l LOW te Idle Calling Talking On-hook Idle c l Figure 10: RI Behaviours as a caller ue tia RI Q n HIGH 120ms fide LOW n Idle or talking URC or SMS Received CoFigure 11: RI Behaviours of URC or SMS received GSM_UART_AN_V1.2 - 14 - GSM UART Port Application Note 7. Baud Rate 7.1. AT+IPR The command AT+IPR can be used to set the TE-TA interface baud rate. The default configuration of AT+IPR is autobauding enabled (AT+IPR=0).  If a fixed baud rate is set, make sure that both TE (DTE, usually external processor) and TA (DCE, Quectel GSM module) are configured to the same rate. If autobauding is enabled, the TA could automatically recognize the baud rate currently used by the TE after receiving 'AT' or 'at' string.  The value of AT+IPR can’t be restored with AT&F and ATZ, but it is still storable with AT&W and visible in AT&V.  In multiplex mode, the baud rate can’t be changed by the write command AT+IPR=, and the setting is invalid and not stored even if AT&W is executed after the write command. l  A selected baud rate takes effect after the write commands is executed and acknowledged by 'OK'. cte l 7.2. Autobauding ue tia To take advantage of autobauding mode, specific attention must be paid to the following requirements:  Autobauding synchronization between TE and TA Q n − Ensure that TE and TA are correctly synchronized and the baud rate used by the TE is detected by the TA. To allow the baud rate to be synchronized simply use an 'AT' or e 'at' string. This is necessary after customer activates autobauding or when customer fid starts up the module with autobauding enabled. − It is recommended to wait for 2 to 3 seconds before sending the first 'AT' or 'at' string after the module is started up with autobauding enabled. Otherwise undefined characters n might be returned.  Restriction on autobauding operation o − The serial interface shall be used with 8 data bits, no parity and 1 stop bit (factory Csetting). − The command 'A/' can’t be used. − Only the string 'AT' or 'at' can be detected (neither 'At' nor 'aT'). − URCs that may be issued before the TA detects a new baud rate by receiving the first AT character, and they will sent message at the previously detected baud rate. − If TE’s baud rate is changed after TA has recognized the earlier baud rate, loss of synchronization between TE and TA would be encountered and an 'AT' or 'at' string must be re-sent by TE to regain synchronization on baud rate. To avoid undefined characters during baud rate re-synchronization and the possible malfunction of resynchronization, it is not recommended to switch TE’s baud rate when autobauding is GSM_UART_AN_V1.2 - 15 - GSM UART Port Application Note enabled. Especially, this operation is forbidden in data mode.  Autobauding and baud rate after restarting. − In the autobauding mode, the detected baud rate is not saved. Therefore, resynchronization is required after restarting the module. − Unless the baud rate is determined, an incoming CSD call can’t be accepted. This must be taken into account when autobauding and auto-answer mode (ATS0 ≠ 0) are enabled at the same time, especially if SIM PIN 1 authentication is done automatically and the setting ATS0 ≠ 0 is stored to the user profile with AT&W. − Until the baud rate is synchronized, URCs after restarting will not be output when autobauding is enabled.  Autobauding and multiplex mode If autobauding is active it is not recommended to switch to multiplex mode.  Autobauding and Windows modem − The baud rate used by Windows modem can be detected while setting up a dial-up GPRS/CSD connection. However, some Windows modem drivers switch TE’s baud rate to default value automatically after the GPRS call is terminated. In order to prevent no l response to the Windows modem when it happens, it is not recommended to establish the dial-up GPRS/CSD connection in autobauding mode. te − Based on the same considerations, it is also not recommended to establish the FAX connection in autobauding mode for PC FAX application, such as WinFax. uec tial Note: To assure reliable communication and avoid any problem caused by undetermined baud rate between DCE and DTE, it is strongly recommended to configure a fixed baud rate and save CQonfiden instead of using autobauding after start-up. GSM_UART_AN_V1.2 - 16 - Shanghai Quectel Wireless Solutions Co., Ltd. Room 801, Building E, No.1618, Yishan Road, Shanghai, China 201103 Tel: +86 21 5108 2965 Mail: info@quectel.com

GSM FTP AT Commands Manual GSM/GPRS Module Series Rev. GSM_FTP_AT_Commands_Manual_V1.5 Date: 2017-11-13 Status: Released www.quectel.com GSM/GPRS Module Series GSM FTP 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. 2017. All rights reserved. GSM_FTP_AT_Commands_Manual 1 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual About the Document History Revision 1.00 1.01 Date 2009-07-27 2010-04-12 1.1 2010-08-03 1.2 2012-08-22 1.3 2012-08-24 1.4 2015-04-08 1.5 2017-11-13 Author Colin HU Joanna LI Colin HU Derrick DAI/ Will SHAO/ Jonathan WEN Jonathan WEN Jonathan WEN Sherlock ZHAO Description Initial Added example for resuming file. 1. Added the notice of hardware flow control when transferring file. 2. Added the description about how to upload a file in UFS or SD or RAM and download a file to UFS or SD or RAM. 1. Added the description about the new AT commands which control the operations of file and file folder on FTP. 2. Modified AT+QFTPGET for RAM file. 3. Added command AT+QFTPLIST & AT+QFTPNLST. Added examples of downloading FTP file to RAM and uploading RAM file to FTP. Added applicable modules Added new parameter values for AT+QFTPCFG to configure transparent mode and create FTP data connection with control connection address in passive mode. GSM_FTP_AT_Commands_Manual 2 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual Contents About the Document ................................................................................................................................ 2 Contents.................................................................................................................................................... 3 Table Index ............................................................................................................................................... 5 1 Introduction ....................................................................................................................................... 6 1.1. AT Command Syntax................................................................................................................. 6 2 Description of FTP AT Commands .................................................................................................. 7 2.1. AT+QFTPOPEN Open an FTP Service to the Given FTP Server ........................................... 7 2.2. AT+QFTPCLOSE Close the FTP Service ............................................................................... 8 2.3. AT+QFTPPUT Upload a File to FTP Server............................................................................ 8 2.4. AT+QFTPGET Download a File from FTP Server................................................................. 10 2.5. AT+QFTPPATH Set the Path in FTP Server to Upload or Download File ..............................11 2.6. AT+QFTPUSER Set User Name of the Account to Open FTP Service................................. 12 2.7. AT+QFTPPASS Set Password of the Account to Open FTP Service.................................... 12 2.8. AT+QFTPCFG Configure Parameters for FTP Server .......................................................... 13 2.9. AT+QFTPSTAT Query the Status of FTP Service ................................................................. 15 2.10. AT+QFTPLEN Query the Real Size of the File Transferred in the Latest Transfer ............... 16 2.11. AT+QFTPRENAME Rename a File or Folder on FTP Server ............................................... 16 2.12. AT+QFTPSIZE Query the Size of Appointed File on FTP Server ......................................... 17 2.13. AT+QFTPDELETE Delete the Appointed File on FTP Server ............................................... 18 2.14. AT+QFTPMKDIR Establish a New Folder on FTP Server .................................................... 18 2.15. AT+QFTPRMDIR Remove a Folder on FTP Server.............................................................. 19 2.16. AT+QFTPLIST List Contents of Directory or File Information on FTP Server ....................... 20 2.17. AT+QFTPNLST List File Names of a Directory on FTP Server............................................. 21 3 Examples ......................................................................................................................................... 23 3.1. Open and Close FTP Service .................................................................................................. 23 3.2. Upload a File to FTP Server .................................................................................................... 24 3.2.1. Upload a File through UART ........................................................................................ 24 3.2.2. Upload a File in UFS.................................................................................................... 24 3.2.3. Upload a File in RAM ................................................................................................... 25 3.2.4. Upload a Specified File in UFS .................................................................................... 25 3.3. Download a File from FTP Server ........................................................................................... 26 3.3.1. Download a File through UART ................................................................................... 26 3.3.2. Download a File into UFS ............................................................................................ 26 3.3.3. Download a File into a Specified File in UFS ............................................................... 27 3.3.4. Download a File into RAM ........................................................................................... 27 3.4. Operate a File or a Folder on FTP Server ............................................................................... 28 3.4.1. Operate a File on FTP Server ...................................................................................... 28 3.4.2. Operate a Folder on FTP Server ................................................................................. 28 3.5. Resume a File at the Resuming Point ..................................................................................... 29 3.5.1. Upload a File to FTP Server from Resuming Point ...................................................... 29 GSM_FTP_AT_Commands_Manual 3 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 3.5.2. Download a File from FTP Server from the Resuming Point ....................................... 30 3.6. Get FTP List ............................................................................................................................ 30 3.7. Get FTP File Name List ........................................................................................................... 31 4 Appendix A Reference .................................................................................................................... 32 5 Appendix B Summary of Error Codes ........................................................................................... 33 GSM_FTP_AT_Commands_Manual 4 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual Table Index TABLE 1: RELATED DOCUMENTS .................................................................................................................. 32 TABLE 2: TERMS AND ABBREVIATIONS ........................................................................................................ 32 TABLE 3: SUMMARY OF ERROR CODES ...................................................................................................... 33 GSM_FTP_AT_Commands_Manual 5 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 1 Introduction Quectel module provides an internal TCP/IP stack that is driven by AT commands and enables the host application to easily access the Internet services which include TCP service, UDP service, HTTP service and FTP service, etc. This document is a reference guide to all the AT commands defined for FTP. This document is applicable to all Quectel GSM modules. 1.1. AT Command Syntax Test Command Read Command Write Command Execution Command AT+=? AT+? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the GSM engine. GSM_FTP_AT_Commands_Manual 6 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 2 Description of FTP AT Commands 2.1. AT+QFTPOPEN Open an FTP Service to the Given FTP Server AT+QFTPOPEN Open an FTP Service to the Given FTP Server Test Command AT+QFTPOPEN=? Response +QFTPOPEN: 'HOST NAME',(list of supported s) Read Command AT+QFTPOPEN? OK Response +QFTPOPEN: '', Write Command AT+QFTPOPEN=, OK Response OK Or ERROR If successfully connected, response: +QFTPOPEN: 0 Maximum Response Time Otherwise, response: +QFTPOPEN: 150s Parameter String type. The IP address or domain name of the FTP server. The maximum size of the parameter is 100. Integer type. The port of the FTP server. The range of the parameter is 1-65535. A negative numeric to indicate the type of error. Please refer to Chapter 5. GSM_FTP_AT_Commands_Manual 7 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual NOTES 1. It is recommended to execute the configuration commands AT+QFTPUSER and AT+QFTPPASS to set the user name and password before opening FTP service. 2. If FTP state is IDLE or CLOSED (Please refer to Chapter 2.9), the fields of host name and port in the response of the read command are empty. 2.2. AT+QFTPCLOSE Close the FTP Service AT+QFTPCLOSE Close the FTP Service Test Command AT+QFTPCLOSE=? Write Command AT+QFTPCLOSE Response OK Response OK If successfully connected, response: +QFTPCLOSE: 0 Maximum Response Time Otherwise, response: +QFTPCLOSE: 60s Parameter A negative numeric to indicate the type of error. Please refer to Chapter 5. 2.3. AT+QFTPPUT Upload a File to FTP Server AT+QFTPPUT Upload a File to FTP Server Test Command AT+QFTPPUT=? Response +QFTPPUT: 'FILE NAME',,(1-65535) Write Command AT+QFTPPUT=,[,< time>] OK Response If format is right, response: OK GSM_FTP_AT_Commands_Manual 8 / 34 Maximum Response Time GSM/GPRS Module Series GSM FTP AT Commands Manual Otherwise, response: ERROR Next, UART enters into data mode and responses: CONNECT Otherwise, response: +QFTPPUT: Finally, if the file is uploaded successfully, response: +QFTPPUT: Otherwise, response: +QFTPPUT: 120s Parameter The name of the file to upload. The maximum size of the parameter is 50. The size of the file to upload. For the file UFS, RAM and SD card, if is set as 0, the file will be uploaded to the server according to the real size of the file. The maximum time allowed to get file data. The default value is 900. Unit: second. The greater the is, the greater the should be set. The actual size of the file uploaded successfully. Theoretically, it should be equal to . A negative numeric to indicate the type of error. Please refer to Chapter 5. NOTES 1. If the length of the input data from UART reaches , or the time to input data reaches , the FTP service will stop receiving data from UART. 2. After CONNECT appears, UART enters into data mode. It is supported to escape data mode by '+++'. Please refer to document [2] for details. 3. For reliable transmission when uploading file, it is strongly recommended to enable hardware flow control in both TA side and TE side. The command AT+IFC=2,2 is used to enable hardware flow control in TA side (Please refer to document [1] for details). GSM_FTP_AT_Commands_Manual 9 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 2.4. AT+QFTPGET Download a File from FTP Server AT+QFTPGET Download a File from FTP Server Test Command AT+QFTPGET=? Response +QFTPGET: 'file name'[,] Write Command AT+QFTPGET=[,] OK Response If format is right, response: OK Otherwise, response: ERROR Next, UART enters into data mode and responses: CONNECT Otherwise, response: +QFTPGET: Finally, if the file is downloaded successfully, response: +QFTPGET: Maximum Response Time Otherwise, response: +QFTPGET: 120s Parameter The name of the file to download. The maximum size of the parameter is 50. The maximum length of the file. The default value is 102400. Unit: byte. It is only used for RAM file. Ignore this parameter if UFS or SD file is used. The actual size of the file downloaded. A negative numeric to indicate the type of error. Please refer to Chapter 5. NOTES 1. After CONNECT appears, UART enters to data mode. It is supported to escape data mode by '+++'. Please refer to document [2] for details. 2. For reliable transmission when downloading file, it is strongly recommended to enable hardware flow control in both TA side and TE side. The command AT+IFC=2,2 is used to enable hardware flow GSM_FTP_AT_Commands_Manual 10 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual control in TA side (Please refer to document [1] for details). 2.5. AT+QFTPPATH Set the Path in FTP Server to Upload or Download File AT+QFTPPATH Set the Path in FTP Server to Upload or Download File Test Command AT+QFTPPATH=? Response +QFTPPATH: 'PATH NAME' Read Command AT+QFTPPATH? OK Response OK Write Command AT+QFTPPATH= +QFTPPATH: '' Response If format is right, response: OK Otherwise, response: ERROR Next, if the path is set successfully, response: +QFTPPATH: 0 Response Time Otherwise, response: +QFTPPATH: 300ms Parameter The name of the path to set. The maximum size of the parameter is 100. A negative numeric to indicate the type of error. Please refer to Chapter 5. GSM_FTP_AT_Commands_Manual 11 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 2.6. AT+QFTPUSER Set User Name of the Account to Open FTP Service AT+QFTPUSER Set User Name of the Account to Open FTP Service Test Command AT+QFTPUSER=? Response +QFTPUSER: 'USER NAME' Read Command AT+QFTPUSER? OK Response +QFTPUSER: '' Write Command AT+QFTPUSER= OK Response If format is right and the FTP service is idle, response: OK Response Time Otherwise, response: ERROR 300ms Parameter The user name of the account. If this value is null, the module will use anonymous account to open FTP service. The maximum size of the parameter is 30. 2.7. AT+QFTPPASS Set Password of the Account to Open FTP Service AT+QFTPPASS Set Password of the Account to Open FTP Service Test Command AT+QFTPPASS=? Response +QFTPPASS: 'PASSWORD' Read Command AT+QFTPPASS? OK Response +QFTPPASS: '' Write Command AT+QFTPPASS='' OK Response If format is right and the FTP service is idle, response: GSM_FTP_AT_Commands_Manual 12 / 34 Response Time GSM/GPRS Module Series GSM FTP AT Commands Manual OK Otherwise, response: ERROR 300ms Parameter The password of the account. The maximum size of the parameter is 30. 2.8. AT+QFTPCFG Configure Parameters for FTP Server AT+QFTPCFG Test Command AT+QFTPCFG=? Configure Parameters for FTP Server Response +QFTPOPEN: (list of supported s) Write Command AT+QFTPCFG=[,] OK Response If format is right, response: OK Otherwise, response: ERROR Next, if the configurable parameter is set successfully, response: +QFTPCFG: 0 Or if is omitted and is legal, this command is used to query the value of the corresponding parameter, and response: +QFTPCFG: Response Time Otherwise, response +QFTPCFG: 300ms GSM_FTP_AT_Commands_Manual 13 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual Parameter The type of the configurable parameter to set. 1 The mode of data connection. 2 The transfer type 3 The resuming point to resume file transfer 4 The local position of the file to transfer 5 FTP non-transparent mode 6 Ignore FTP data link address returned by server in passive mode The value of the parameter to set. The following are the details about . If = 1, 0 Active mode 1 Passive mode If = 2, 0 Set the transfer type as binary 1 Set the transfer type as ASCII If = 3, it is the resuming point to resume file transfer. If = 4, it is a string to indicate the local position of the file to transfer. The following are the detailed description about . '/COM/' The file data to input from UART or output to UART. '/UFS/' The file to upload is a file that is saved in UFS and the received file to be saved in UFS. It is also supported to specify the file name here. For example, '?UFS/filename.txt'. Then, no matter what the parameter is in the command AT+QFTPPUT, it will read the file filename.txt in UFS to upload, and the name of the file in the FTP server is defined by . Likewise, the command AT+QFTPGET gets the file whose name is defined by in the FTP server and saves it in UFS with name 'filename.txt'. '/SD/' The file to transfer is saved in the directory /Picture in SD card. It is also supported to specify the file name after the path as similar as in UFS except that the root directory is /Picture in SD card. This parameter is only supported by GSM modules that support SD card. '/RAM/' The file to transfer is saved in RAM. It is also supported to specify the file name after the path as same as in UFS. For the command AT+QFTPGET, no matter what the size of the file to download is, space of 102400 bytes will be allocated for the file. If = 5, 0 FTP transparent mode 1 FTP non-transparent mode If = 6, 0 Use FTP data link address returned by server in passive mode 1 Ignore FTP data link address returned by server in passive mode A negative numeric to indicate the type of error. Please refer to Chapter 5. GSM_FTP_AT_Commands_Manual 14 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual NOTES 1. The resuming point will be reset as 0 after file transfer is finished. 2. If the FTP service has already been opened, but error code '-425' is got when customers continue other operating, and this may be caused by the wrong data link address returned by FTP server. Command AT+QFTPCFG=6,1 needs to be executed to ignore this address. 2.9. AT+QFTPSTAT Query the Status of FTP Service AT+QFTPSTAT Query the Status of FTP Service Test Command AT+QFTPSTAT=? Response OK Write Command AT+QFTPSTAT Response +QFTPSTAT: Response Time OK 300ms Parameter String type. The current status of FTP service. IDLE No FTP service. OPENING Opening an FTP service. OPENED The FTP service is opened and idle. WORKING Sending FTP commands to the FTP server and receiving response from the FTP server to start data transfer. TRANSFER Transferring data between the module and the FTP server. CLOSING Closing the FTP service. CLOSED The FTP service is closed. GSM_FTP_AT_Commands_Manual 15 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 2.10. AT+QFTPLEN Query the Real Size of the File Transferred in the Latest Transfer AT+QFTPLEN Query the Real Size of the File Transferred in the Latest Transfer Test Command AT+QFTPLEN=? Response OK Write Command AT+QFTPLEN Response +QFTPLEN: Response Time OK 300ms Parameter A numeric to indicate the real size of the file that has been transferred in the latest transfer operation. 2.11. AT+QFTPRENAME Rename a File or Folder on FTP Server AT+QFTPRENAME Rename a File or Folder on FTP Server Test Command AT+QFTPRENAME=? Response +QFTPRENAME: ('SOURCE NAME','TARGET NAME') Write Command AT+QFTPRENAME='','' OK Response If the format is right, response: OK Otherwise, response: ERROR Next, if the file or folder is renamed successfully, response: +QFTPRENAME: 0 Otherwise ,response: +QFTPRENAME: GSM_FTP_AT_Commands_Manual 16 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual Maximum Response Time 150s Parameter The name of the file or folder to rename. The maximum size of the parameter is 50. The target name of the file or folder to change to. The maximum size of the parameter is 50. A negative numeric to indicate the type of error. Please refer to Chapter 5. 2.12. AT+QFTPSIZE Query the Size of Appointed File on FTP Server AT+QFTPSIZE Query the Size of Appointed File on FTP Server Test Command AT+QFTPSIZE=? Response +QFTPSIZE: 'FILE NAME' Write Command AT+QFTPSIZE='' OK Response OK Or just return ERROR Next, if successfully connected, response: +QFTPSIZE: Maximum Response Time Otherwise, response: +QFTPSIZE: 150s Parameter The name of the file on FTP server. The maximum size of the parameter is 50. A negative numeric to indicate the type of error, please refer to Chapter 5. NOTE If customers want to get size of file in sub catalog, the file name should be like '/dir/fileName'. GSM_FTP_AT_Commands_Manual 17 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 2.13. AT+QFTPDELETE Delete the Appointed File on FTP Server AT+QFTPDELETE Delete the Appointed File on FTP Server Test Command AT+QFTPDELETE=? Response +QFTPOPEN: 'FILE NAME' Write Command AT+QFTPDELETE= OK Response OK Or just return ERROR Next, if successfully connected, response: +QFTPDELETE: 0 Maximum Response Time Otherwise, response: +QFTPDELETE: 150s Parameter The name of the file to delete. The maximum size of the parameter is 50. A negative numeric to indicate the type of error, please refer to Chapter 5. NOTE If customers want to delete the file in sub catalog, the file name should be like '/dir/fileName'. 2.14. AT+QFTPMKDIR Establish a New Folder on FTP Server AT+QFTPMKDIR Establish a New Folder on FTP Server Test Command AT+QFTPMKDIR=? Response +QFTPMKDIR: 'PATH NAME' Write Command AT+QFTPMKDIR= OK Response OK GSM_FTP_AT_Commands_Manual 18 / 34 Maximum Response Time GSM/GPRS Module Series GSM FTP AT Commands Manual Or just return ERROR Next, if successfully connected, response: +QFTPMKDIR: 0 Otherwise, response: +QFTPMKDIR: 150s Parameter The name of the folder to establish. The maximum size of the parameter is 100. A negative numeric to indicate the type of error, please refer to Chapter 5. NOTE This command cannot be used to establish sub folder. 2.15. AT+QFTPRMDIR Remove a Folder on FTP Server AT+QFTPRMDIR Remove a Folder on FTP Server Test Command AT+QFTPRMDIR=? Response +QFTPRMDIR: 'PATH NAME' Write Command AT+QFTPRMDIR='' OK Response OK Or just return ERROR Next, if successfully connected, response: +QFTPRMDIR: 0 Maximum Response Time Otherwise, response: +QFTPRMDIR: 150s GSM_FTP_AT_Commands_Manual 19 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual Parameter The name of the folder to remove. The maximum size of the parameter is 100. A negative numeric to indicate the type of error, please refer to Chapter 5. NOTE This command can be only used to remove empty folder. 2.16. AT+QFTPLIST List Contents of Directory or File Information on FTP Server AT+QFTPLIST List Contents of Directory or File Information on FTP Server Test Command AT+QFTPLIST=? Response +QFTPLIST: 'NAME' Write Command AT+QFTPLIST[=] OK Response If format is right, response: OK Otherwise, response: ERROR Next, if the UART successfully enters data mode, response: CONNECT Otherwise, response: +QFTPLIST: Finally, if directory information is listed successfully, response: +QFTPLIST: Maximum Response Time Otherwise, response: +QFTPLIST: 150s GSM_FTP_AT_Commands_Manual 20 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual Parameter String type. The directory name or file name. The maximum size of the parameter is 50. Indicates the result of the command execution 0 Represent no information transferred from FTP 1 List all files under the current path of FTP server A negative numeric to indicate the type of error. Please refer to Chapter 5. NOTES 1. If is a regular file, it will response the information about that file; if the is a directory, it will response the contents of the directory. 2. If is omitted, the contents of the current directory will be listed; else the contents of the file in current directory will be listed. 3. Please make sure the local position is '/COM/' and it can be set by AT+QFTPCFG=4, '/COM/'. 2.17. AT+QFTPNLST List File Names of a Directory on FTP Server AT+QFTPNLST List File Names of a Given Directory on FTP Server Test Command AT+QFTPNLST=? Response +QFTPNLST: 'DIR NAME' Write Command AT+QFTPNLST[=] OK Response If format is right response OK Otherwise response ERROR Next, if the UART successfully enters into data mode, response: CONNECT Otherwise, response +QFTPNLST: Finally, if the directory information is listed successfully, response +QFTPNLST: GSM_FTP_AT_Commands_Manual 21 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual Maximum Response Time Otherwise, response +QFTPNLST: 150s Parameter String type. The directory name. The maximum size of the parameter is 50. Indicates the result of the command execution 0 Represent no information transferred from FTP 1 List all files under the current path of FTP server A negative numeric to indicate the type of error, please refer to Chapter 5. NOTES 1. Just the file names in the given directory will be returned. 2. Please make sure the local position is '/COM/' and it can be set by AT+QFTPCFG=4, '/COM/'. GSM_FTP_AT_Commands_Manual 22 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 3 Examples 3.1. Open and Close FTP Service AT+QIFGCNT=0 OK //Choose the context 0 to activate GPRS/CSD context for the FTP service. Please refer to document [1] and [2] for details. AT+QICSGP=1,'CMNET' OK //Choose GPRS mode and set APN as 'CMNET'. AT+QIREGAPP OK AT+QIACT OK //Optional //Optional //For example, if FTP server is 'quectel.3322.org' and port is 21. AT+QFTPUSER='quectel' //Set the user name as 'quectel'. OK AT+QFTPPASS='123456' OK //Set the password as '123456'. AT+QFTPOPEN='quectel.3322.org',21 OK +QFTPOPEN: 0 //Successfully open the FTP service. AT+QFTPCLOSE OK //Close the connection with FTP. +QFTPCLOSE: 0 //Successfully close the connection. AT+QIDEACT DEACT OK //Deactivate the PDP context. GSM_FTP_AT_Commands_Manual 23 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual NOTE Generally, if the FTP service is not used for a time of period, it will indicate that the FTP service cannot be used. The module will report '+QFTPERROR:-421' for this information. After a moment, the FTP server will close the control connection of the FTP service. And the module will report '+QFTPERROR:-6' for this information. It is recommended to execute the command AT+QFTPCLOSE to close the FTP service after receiving these two report messages from UART. 3.2. Upload a File to FTP Server After the FTP service is opened, a file can be uploaded to FTP server and downloaded from FTP server. The following examples show how to upload a file. 3.2.1. Upload a File through UART AT+QFTPPATH='/' OK //Set the path to upload file as '/'. +QFTPPATH: 0 //Successfully set the path. //Upload the file test.txt via UART and modify its name as sscom.ini in the FTP server, and the size expected to put is 1587. If the read size of the file sscom.ini is less than 1587, it will upload file with the real size. The maximum time to read file data is 200 seconds. AT+QFTPPUT='sscom.ini',1587,200 OK CONNECT +QFTPPUT: 1587 //Open data mode and upload data. //Input data via UART. //Successfully upload the file sscom.ini to the FTP server. The size of the data successfully uploaded is 1587. 3.2.2. Upload a File in UFS AT+QFTPCFG=4,'/UFS/' OK +QFTPCFG: 0 AT+QFTPPATH='/' OK //Set the local position as UFS. //Successfully to set the local file. //Set the path to upload file as '/' GSM_FTP_AT_Commands_Manual 24 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual +QFTPPATH: 0 //Successfully set the path. AT+QFTPPUT='sscom.ini',1587,200 OK +QFTPPUT:1587 //Successfully upload the file sscom.ini to the FTP server. The size of the data successfully uploaded is 1587. 3.2.3. Upload a File in RAM AT+QFTPCFG=4,'/RAM/' OK //Set the local position as RAM. +QFTPCFG: 0 AT+QFTPPATH='/' OK //Set the path to upload file as '/'. +QFTPPATH: 0 //Successfully set the path. AT+QFTPPUT='sscom.ini',1587,200 //Upload the file sscom.ini in RAM.. OK +QFTPPUT: 1587 //Successfully upload the file sscom.ini to the FTP server. The size of the data successfully uploaded is 1587 3.2.4. Upload a Specified File in UFS AT+QFTPCFG=4,'/UFS/test.txt' OK //Set test.txt in UFS as the local file to upload or download. +QFTPCFG: 0 //Successfully set the local file. AT+QFTPPATH='/' OK //Set the path to upload file as '/'. +QFTPPATH: 0 //Successfully set the path. AT+QFTPPUT='sscom.ini',1587,200 OK +QFTPPUT: 1587 //Successfully upload the file sscom.ini to the FTP server. The GSM_FTP_AT_Commands_Manual 25 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual size of the data successfully uploaded is 1587. 3.3. Download a File from FTP Server The following examples explain how to download a file from FTP server. 3.3.1. Download a File through UART AT+QFTPPATH='/' OK //Set the path to download file as '/'. +QFTPPATH: 0 //Successfully set the path. AT+QFTPGET='sscom.ini' OK //Download the file sscom.ini from the FTP server. CONNECT +QFTPGET: 1587 AT OK //Successfully open data connection to download file. //The data of the file sscom.ini is outputted from UART. //Successfully download the file sscom.ini from the FTP server. And the size of the data successfully downloaded is 1587. //There is an OK response for AT, which means the download operation is finished. 3.3.2. Download a File into UFS AT+QFTPCFG=4,'/UFS/' OK //Set the local position as UFS. +QFTPCFG: 0 //Successfully set the local position. AT+QFTPPATH='/' OK //Set the path to download file as '/'. +QFTPPATH: 0 //Successfully set the path. //Download the file sscom.ini from the FTP server and save it in UFS with name sscom.ini. AT+QFTPGET='sscom.ini' OK +QFTPGET: 1587 //Successfully download the file sscom.ini from the FTP server. GSM_FTP_AT_Commands_Manual 26 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual The size of the data successfully downloaded is 1587. 3.3.3. Download a File into a Specified File in UFS AT+QFTPCFG=4,'/UFS/dwl.txt' OK //Set the local position as UFS and the data from server will be saved in the file dwl.txt. +QFTPCFG:0 AT+QFTPPATH='/' OK //Successfully set the local position. //Set the path to download file as '/'. +QFTPPATH:0 //Successfully set the path. AT+QFTPGET='sscom.ini' OK //Download the file sscom.ini from the FTP server and save it in UFS with name 'dwl.txt'. +QFTPGET:1587 //Successfully download the file sscom.ini from the FTP server. The size of the data successfully downloaded is 1587. 3.3.4. Download a File into RAM AT+QFTPCFG=4,'/RAM/dwl.txt' OK //Set the local position as RAM and the data from server will be saved in the file dwl.txt. +QFTPCFG:0 AT+QFTPPATH='/' OK //Successfully set the local position. //Set the path to download file as '/'. +QFTPPATH:0 //Successfully set the path. AT+QFTPGET='sscom.ini',1587 OK //Download the file sscom.ini from the FTP server and save it in RAM with name 'dwl.txt'. The second parameter '1587' means a file is created in RAM and the file size is 1587. If you ignore this parameter '1587', the default size of the parameter is 102400. Please keep this parameter greater than the size of file to download from FTP server. +QFTPGET:1587 //Successfully download the file sscom.ini from the FTP server. The size of the data successfully downloaded is 1587. GSM_FTP_AT_Commands_Manual 27 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 3.4. Operate a File or a Folder on FTP Server 3.4.1. Operate a File on FTP Server AT+QFTPRENAME='sscom.ini','test.txt' OK //Rename the file sscom.ini to test.txt. +QFTPRENAME:0 AT+QFTPSIZE='test.txt' OK +QFTPSIZE:17765 //Successfully rename the file. //Query the size of file test.txt. //Successfully query the file size, and the file size is 17765. AT+QFTPDELETE='test.txt' OK //Delete the renamed file test.txt. +QFTPDELETE:0 //Successfully delete the file. 3.4.2. Operate a Folder on FTP Server AT+QFTPMKDIR='test' OK //Establish a new folder on the FTP server. +QFTPMKDIR:0 AT+QFTPRENAME='test','test1' OK //Successfully make the new folder. //Rename the folder test to test1. +QRENAME:0 AT+QFTPRMDIR='test1' OK //Successfully rename the folder. //Delete the renamed folder test1 +QFTPMKDIR:0 //Successfully remove the folder. NOTE If the file or folder does not exist, error '-550' will be returned. If there are problems on the connection, error '-1' will be returned. GSM_FTP_AT_Commands_Manual 28 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 3.5. Resume a File at the Resuming Point While uploading or downloading a file, the process may be interrupted due to disconnection. At this time, the data that has been transferred is wasted. Quectel module supports to transfer a file at the resuming point if the server supports this function so that it is unnecessary to retransfer the data that has been transferred. And this function makes it possible to split a huge file into several small parts and then upload the file part by part. It is necessary to execute the command 'AT+QFTPCFG=3,' before putting or getting remaining data. Please refer to the following examples. 3.5.1. Upload a File to FTP Server from Resuming Point AT+QFTPPUT='sscom.ini',1587,200 //Upload the file sscom.ini. The total size is 3587, and here just 1587 bytes are uploaded for the first time. The rest data of 2000 bytes can be uploaded later. OK CONNECT +QFTPPUT: 1587 //Successfully open data connection to upload file. //Input the data of the file sscom.ini. AT+QFTPCFG=3,1587 OK //Set the resuming point. +QFTPCFG: 0 AT+QFTPPUT='sscom.ini',2000,200 //Upload the remaining 2000 bytes of the file sscom.ini . OK CONNECT +QFTPPUT: 2000 //Input the rest data of the file sscom.ini from the position 1587. //Successfully upload the rest 2000 bytes NOTE If the file to upload is saved in UFS, SD or RAM, the file will be uploaded from the resuming point. For example: the size of the file to upload is 5120 and the resuming point is set as 1587, then the data from 1587 to 3586 (including it) will be uploaded in the file to upload. If the size of the file is less than 3587, the data from 1587 to the end of the file will be uploaded. GSM_FTP_AT_Commands_Manual 29 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 3.5.2. Download a File from FTP Server from the Resuming Point AT+QFTPCFG=3,1587 OK //Set the resuming point. +QFTPCFG: 0 AT+QFTPGET='sscom.ini' OK //Download the rest data of sscom.ini from the FTP server. CONNECT +QFTPGET: 2000 //The data of the file sscom.ini starts from the position 1587 and is outputted from UART //Successfully download the rest 2000 bytes of the file from the FTP server. 3.6. Get FTP List Get the contents of directory or file information on the FTP server. Please make sure the local position is '/COM/', and it can be set by AT+QFTPCFG=4,'/COM/'. AT+QFTPPATH='/' OK //Set the current path as '/'. +QFTPPATH:0 //Successfully set the path. AT+QFTPCFG=4,'/COM/' OK //Set the local position as '/COM/'. +QFTPCFG:0 //Successfully set the local position. AT+QFTPLIST OK //List the contents of current directory. CONNECT -rw-rw-rwdrw-rw-rw- 1 user 1 user group group 239 Jul 18 15:45 #.dat 0 Jul 16 14:14 tsj +QFTPLIST: 1 AT+QFTPLIST='ANDY' OK //List the contents in the directory andy. GSM_FTP_AT_Commands_Manual 30 / 34 CONNECT -rw-rw-rw-rw-rw-rw- 1 user 1 user +QFTPLIST: 1 +QFTPGET:1587 group group GSM/GPRS Module Series GSM FTP AT Commands Manual 0 Mar 17 17:21 1.text 10 Jun 20 10:18 test.txt //Successfully download the file sscom.ini from the FTP server. And the size of the data successfully downloaded is 1587. 3.7. Get FTP File Name List Get the list of file names in the specified directory. Please make sure the local position is '/COM/', and it can be set by AT+QFTPCFG=4,'/COM/'. AT+QFTPPATH='/' OK //Set the current path as '/'. +QFTPPATH:0 //Successfully set the path. AT+QFTPCFG=4,'/COM/' OK //Set the local position as '/COM/'. +QFTPCFG:0 //Successfully set the local position. AT+QFTPNLST OK //List file names of current directory. CONNECT Aaa.jpg Test.txt +QFTPNLST: 1 AT+QFTPNLST='ANDY' OK //List the file names in the directory andy. CONNECT Mytest.txt Mytest.jpg +QFTPNLST: 1 GSM_FTP_AT_Commands_Manual 31 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 4 Appendix A Reference Table 1: Related Documents SN Document Name Remark [1] Quectel_Mxx_AT_Commands_Manual The introduction of the AT commands for Mxx modules [2] Quectel_GSM_TCP(IP)_Application_Note The introduction of how to use the internal TCP/IP stack for GSM modules The introduction of the AT commands of the file [3] Quectel_GSM_File_AT_Commands_Manual system for GSM modules Table 2: Terms and Abbreviations Abbreviation APN CSD FTP GPRS HTTP RAM TA TCP TE UART UDP UFS Description Access Point Network Circuit Switched Data File Transfer Protocol General Packet Radio Service Hypertext Transfer Protocol Overview Random Access Memory Terminal Adapter, i.e. the module Transmission Control Protocol Terminal Equipment, i.e. the device who control the module via UART Universal Asynchronous Receiver/Transmitter User Datagram Protocol User File Storage GSM_FTP_AT_Commands_Manual 32 / 34 GSM/GPRS Module Series GSM FTP AT Commands Manual 5 Appendix B Summary of Error Codes When no command is executed and some error happens, the FTP service will report the URC '+QFTPERROR:'. The error code indicates an error related to mobile equipment or network. The detail about is described in the following table. Table 3: Summary of Error Codes -1 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -421 -425 -426 -450 Description of Error Codes Unknown error The FTP service is busy. For example, opening FTP service, controlled by another virtual UART, etc. Failed to get IP address according to domain name Network error. For example, failed to activate GPRS/CSD context, failed to establish the TCP connection with the FTP server or failed to send FTP command to the FTP server, etc. The FTP session is closed by the FTP server The data connection of the FTP service is closed by the FTP server GPRS/CSD context is deactivated Timeout The input parameter is illegal The file is not found in the local position, UFS or SD or RAM Failed to get the file in the local position, UFS or SD or RAM. No enough memory for attachment The FTP server cannot support service Failed to open data connection The connection is closed and stop transferring The request for the file is not operated GSM_FTP_AT_Commands_Manual 33 / 34 -452 -500 -501 -502 -530 -532 -550 -551 -552 -553 GSM/GPRS Module Series GSM FTP AT Commands Manual The FTP server has no enough memory The format of the FTP command is wrong The parameter of the FTP command is wrong The FTP command is not operated by the FTP server Not login the FTP server Need the information of account The request is not operated The request is stopped The request of a file is stopped File name is illegal GSM_FTP_AT_Commands_Manual 34 / 34

GSM TCP/IP 应用流程指导 GSM/GPRS 系列 版本：GSM_TCP/IP_应用流程指导_V2.0 日期：2018-11-09 状态：受控文件 www.quectel.com GSM TCP/IP 应用流程指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 邮编：200233 电话：+86 21 51086236 邮箱：info@quectel.com 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2018，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2018. 上海移远通信技术股份有限公司 1 / 20 GSM TCP/IP 应用流程指导 文档历史 修订记录 版本 1.0 1.1 1.2 2.0 日期 2010-10-25 2012-07-08 2015-04-03 2018-11-09 作者 胡孔林 胡志琴 王淑娟 陶亮亮 变更表述 初始版本 增加 TCOUO 设计参考流程图 增加适用模块说明 修改全篇多处细节及描述，请整体阅读 上海移远通信技术股份有限公司 2 / 20 GSM TCP/IP 应用流程指导 目录 文档历史 ........................................................................................................................................................ 2 目录 ............................................................................................................................................................... 3 表格索引 ........................................................................................................................................................ 4 1 引言 ........................................................................................................................................................ 5 2 初始化工作 ............................................................................................................................................. 6 3 建立 TCP/UDP 连接 ............................................................................................................................... 8 3.1. 建立 TCP 连接 ......................................................................................................................... 8 3.2. 建立 UDP 连接......................................................................................................................... 9 4 发送数据 ............................................................................................................................................... 10 4.1. 不指定长度数据发送 .............................................................................................................. 10 4.2. 指定长度数据发送.................................................................................................................. 11 5 接收数据 ............................................................................................................................................... 12 5.1. 数据直接输出到串口 .............................................................................................................. 12 5.2. 通过命令提取接收到的数据 ................................................................................................... 12 6 TCP 连接维持和侦测............................................................................................................................ 14 7 关闭 TCP 连接...................................................................................................................................... 16 8 透传连接 ............................................................................................................................................... 17 8.1. 示例........................................................................................................................................ 17 8.2. 异常处理 ................................................................................................................................ 17 9 TCP/IP 设计参考流程图 ....................................................................................................................... 19 10 附录 A 参考文档 ................................................................................................................................... 20 上海移远通信技术股份有限公司 3 / 20 GSM TCP/IP 应用流程指导 表格索引 表 1：参考文档 .................................................................................................................................................. 20 表 2：术语缩写 .................................................................................................................................................. 20 上海移远通信技术股份有限公司 4 / 20 GSM TCP/IP 应用流程指导 1 引言 本文档主要结合实际示例，介绍移远通信标准 GSM 模块内嵌的 TCP/IP 服务使用方法以及一些异常情 况的处理方案。 本文档适用于移远通信的所有 GSM 模块。 上海移远通信技术股份有限公司 5 / 20 GSM TCP/IP 应用流程指导 2 初始化工作 AT+IPR=115200&W OK AT+CPIN? +CPIN: READY //配置固定波特率为 115200bps //首先要确保(U)SIM 卡的 PIN 码已解 //这表明(U)SIM 卡的 PIN 码已解 OK AT+CREG? +CREG: 0,1 //确认找网成功 //这表明找网成功，模块注册到 CS 业务上；如果没有成功，继续执行 AT+CREG?查询。对于找网成功的判断，也可以通过在开机时执行命令 AT+CREG=1；在网络注册状态变化的时候，上报+CREG: 1 或+CREG: 5 消息。 OK AT+CGATT? +CGATT: 1 OK AT+QIFGCNT=0 OK AT+QICSGP=1,'CMNET' OK //查询 GPRS 附着是否成功 //这表明 GPRS 附着成功，如果没有成功，需要继续执行命令 AT+CGATT? 查询。对于 GPRS 是否附着成功的判断，也可以通过在开机时执行命令 AT+CGREG=1；在 GPRS 附着状态变化的时候，上报+CGREG: 1 或 +CGREG: 5 消息。 //将 Context 0 设为前置 Context。此后的相关操作都是针对 Context 0 进行 操作。 //选择 GPRS 模式，且设置 APN 为'CMNET'。 其他初始化工作的可选设置如下： 1. 设置服务器的地址格式。默认情况下，模块会认为服务器地址是一个 IP 地址。但是，如果服务器 的地址是一个域名，则需要执行命令 AT+QIDNSIP=1 将服务器的地址格式改为域名格式。 2. 设置接收数据的处理方式。目前模块支持两种方式来处理接收到的 TCP/UDP 数据：一种是直接 通过串口输出所有接收到的 TCP/UDP 数据（默认情况下，使用的就是这种方式）；另一种是接 收到数据后，不立即输出，而是输出一个提示，然后需要通过命令提取刚刚收到的数据，如果选 择使用这种方式，则需要执行下面的命令。 AT+QINDI=1 //接收到数据后，输出提示+QIRDI: ,,；然后可以通过 命令 AT+QIRD=,,,提取数据。 上海移远通信技术股份有限公司 6 / 20 GSM TCP/IP 应用流程指导 OK 3. 设置接收到的数据显示格式。当选择通过串口输出接收到的数据时，可能需要通过以下命令设置 接收到的数据的显示格式。下面这些命令都可以根据实际需要取舍。 AT+QIHEAD=1 OK //在接收到的数据之前增加头信息 IPD:。 AT+QISHOWRA=1 OK //在接收到的数据头位置增加数据来源的地址和端口号。增加的信息 的具体的格式为：RECV FROM::。 AT+QISHOWPT=1 OK //在接收到的数据之前增加传输层的协议类型，TCP 或者 UDP。此应 用不常见。 4. 设置透传模式。默认情况下，模块采用非透传方式。下面的 3~7 章节就是介绍这种方式下的 TCP 连接建立、数据发送和数据接收的方法。如果希望采用透传方式则需要执行下面的命令， 关于透传方式的具体应用请参考第 8 章。 AT+QIMODE=1 OK //使用透传方式 AT+QITCFG=3,2,512,1 OK //此处重点要关注中间两个参数'2'和'512'。参数'2'表示模块在收到 串口输入的数据后（如果全部输入的数据长度小于 512 个字节）会 等待 200ms，然后发送已经输入的全部数据。参数'512'表示当模 块从串口接收到的数据长度超过 512 个字节之后，则立即以 512 个 字节的数据为一组发送数据，直到缓冲区中的数据长度小于 512 个 字节。 上海移远通信技术股份有限公司 7 / 20 GSM TCP/IP 应用流程指导 3 建立 TCP/UDP 连接 3.1. 建立 TCP 连接 AT+QIOPEN='TCP','220.180.239.212','8063' OK // 连 接 一 个 远 端 TCP 服 务 器 ， 地 址 是 220.180.239.212:8063。 //命令的语法格式正确并且当前的状态可以建 立 TCP 连接。 其他错误返回的分析及处理： 1. ERROR。这里返回 ERROR 可能有两个原因： 1) 命令格式不对；如果所有命令格式都对，需要看看 AT+QIMUX 是否设置为 0。通过命令 AT+QIMUX? 查 询 ， 如 果 查 询 结 果 为 1 （ 查 询 命 令 返 回 +QIMUX: 1 ） ， 则 需 要 执 行 AT+QIMUX=0。 2) 当前的 TCP/IP 连接状态不是'IP INITIAL'、'IP STATUS'或'IP CLOSE（' 通过命令 AT+QISTAT 查询）。如果当前状态为'TCP CONNECTING'，则需要执行 AT+QICLOSE 关闭当前失败的 TCP 连接；如果是其他状态，则需要执行 AT+QIDEACT 断开当前失败的 GPRS 场景。 2. ALREADY CONNECT。这表明已经存在一个 TCP 连接或 UDP 连接，如果确认需要建立新的连 接，则需要执行命令 AT+QICLOSE 关闭当前连接。 CONNECT OK //TCP 连接成功。 3. CONNECT FAIL。这表明 TCP 连接建立失败，此时正确的处理方法是执行 AT+QISTAT 查询当前 TCP 连接的状态：  如果当前状态为'TCP CONNECTING'，建议通过 AT+QICLOSE 关闭当前失败的连接，这样 可以保持 GPRS 仍然处于激活状态，不用重启 GPRS，以提高程序运行的速度。  如果当前状态不是'TCP CONNECTING'，建议执行命令 AT+QIDEACT 直接关闭当前的 GPRS 场景（因为在这些状态下，通常是因为 GPRS 场景激活失败所致），关于命令 AT+QDEACT 的返回处理，可以参考第 7 章。这条命令理论上最长的等待时间大概在 40 秒 到 45 秒。客户在实际应用中也可以根据实际情况设置一个不超过 40 秒的超时时间，超时后 的处理方法和收到 CONNECT FAIL 之后的处理方法一样。 上海移远通信技术股份有限公司 8 / 20 GSM TCP/IP 应用流程指导 3.2. 建立 UDP 连接 同样，模块也支持 UDP 方式。在使用 UDP 方式之前，先建立 UDP 连接。方式和建立 TCP 连接一样。 AT+QIOPEN='UDP','220.180.239.212','8062' OK // 连 接 一 个 UDP 服 务 器 ， 地 址 是 220.180.239.212:8062。 CONNECT OK //UDP 连接成功，实际上 UDP 方式并不用 建立连接，这里其实只是设置了接下来需 要发送 UDP 数据的目标地址和端口。 上海移远通信技术股份有限公司 9 / 20 GSM TCP/IP 应用流程指导 4 发送数据 4.1. 不指定长度数据发送 AT+QISEND >TEST SEND OK AT+QISACK +QISACK: 4,4,0 OK //准备发送数据。 //发送数据'TEST'，''用来结束输入数据和开始发送所有输入的数 据。注意每次最多可以输入 1460 个字节的数据。在这种方式下，有几个特 殊字符不能发送：'0x08'（意思为 backspace）、'0x1A'（意思为） 和'0x1B'（意思为 ESC）。模块收到字符'0x08'时，将会删除上一个输入的 字符。模块收到字符'0x1A'时，会停止接收后面的字符，并将之前收到的 数据发送出去。模块收到字符'0x1B'时，会退出此次发送操作。 //数据已成功发送至 TCP 协议层。 //检查数据是否已经发送成功。 //第一个参数是已发送的数据长度。第二个参数表示已确认发送成功的数据 长度。最后一个参数'0'是尚未确认发送成功的数据长度；如果这个参数为 0，表明所有数据都已发送成功。该命令在 UDP 方式下没有实际意义，因 为 UDP 本身是无连接的，不能确定数据有没有成功发送，所以在 UDP 方 式下执行该命令，第二个参数将一直为 0。 备注 1. 因为底层 socket 的发送窗口有 7300 字节，因此，不一定要等到所有数据都已经确认（即无需一直等 到命令 AT+QISACK 返回的最后一个参数为 0），再发下一包。考虑到一个 TCP 的最大长度为 1448 字节，建议可以设置一个阀值 3000 字节。如果没有确认的数据长度（命令 AT+QISACK 返回的最后 一个参数）小于 3000 字节，就继续使用命令 AT+QISEND 发送下一段报文；如果超过 3000 字节， 则停止发送，然后每隔 5 秒执行命令 AT+QISACK 查询一次数据长度，直到返回的最后一个参数小 于 3000 字节，就继续发送数据。如果查询到一定次数（例如 20 次，相当于超时 100 秒）后，返回 的最后一个参数一直大于 3000 字节，则可以认为 TCP 连接出现异常。关闭此次连接，重新建立 TCP 连接，继续发送之前一直没有确认的数据和接下来需要发送的数据。 2. 假如想通过非透传的方式发送十六进制的字符时，尤其是 0x08, 0x1A, 0x1B 这三个字符时，建议使 用指定长度的方式发送数据。详细信息，请参考 4.2 章节。 上海移远通信技术股份有限公司 10 / 20 GSM TCP/IP 应用流程指导 4.2. 指定长度数据发送 AT+QISEND=3 >0x080x1A0x1B SEND OK AT+QISACK +QISACK: 17,17,0 OK //指定待发送数据的长度为 3。 //依次发送'0x08'、'0x1A'和'0X1B'这几个特殊字符。实际输入时，一定 要直接输入 0x08、0x1A 和 0x0B 这几个具体数据，而非像例子中那样 输入'0x080x1A0x1B'的字符串，例子中是为了看的清楚一点。 上海移远通信技术股份有限公司 11 / 20 GSM TCP/IP 应用流程指导 5 接收数据 5.1. 数据直接输出到串口 默认情况下，模块接收到的 TCP 数据都是直接通过串口输出，不带任何头信息。为了将 TCP 数据与 AT 命令返回数据或 URC 区分开来，建议增加头信息。增加头信息的具体方法，请参考第 2 章。接收到的 数据到底以什么样的格式显示，最好在 TCP 连接建立之前就设置好。下面是一个接收到的数据的示例。 RECV FROM:220.180.239.212:8063 //模块收到来自远端服务器 220.180.239.212:8063 的数 据。如果在初始化时没有执行命令 AT+QISHOWRA=1，则不会有这一行提示。 IPD36TCP:1234567890abcdefghijklmnopqrstuvwxyz //接收到长度为 36 字节的 TCP 数据。具体的数据是 冒号之后的 36 个字符。如果在初始化时没有执行命 令 AT+QIHEAD=1，则不会有头部 IPD36TCP:。如 果在初始化时没有执行命令 AT+QISHOWPT=1，则 不会有头部 TCP。 备注 在这种数据接收方式下，因为数据是以收到就立即通过串口输出，这有时难免会出现接收到的数据插入 AT 命令中间。在目前的设计中，做了一些超时处理，以避免接收到的数据打断一个完整的 AT 命令或其返 回数据。但是还是不能避免命令和该命令的返回数据被隔开。 5.2. 通过命令提取接收到的数据 在这种方式下，模块接收到 TCP 数据或 UDP 数据，不是立即通过串口输出数据，而是输出一个 URC 通知客户，客户可以随后通过命令提取接收到的 TCP 数据。默认情况下，是不支持这种数据接收方式的。 需要在建立 TCP 连接之前执行命令 AT+QINDI=1 使能这种方式。下面是在这种情况下，模块收到远端数据 时的一个示例。 假设模块收到远端服务器发过来的 TCP 数据 1234567890abcdefghijklmnopqrstuvwxyz。 上海移远通信技术股份有限公司 12 / 20 GSM TCP/IP 应用流程指导 +QIRDI: 0,1,0 //模块接收到基于 Context 0 的数据，并且是以客户端方式。 此时，可以通过下面的命令提取数据 AT+QIRD=0,1,0,1500 //从模块的 socket 缓冲区提取数据。最大提取长度为 1500 字节。如果 缓冲区中的数据不足 1500 字节，则提取所有存于缓冲区中的数据。 +QIRD: 220.180.239.212:8063,TCP,36 1234567890abcdefghijklmnopqrstuvwxyz OK 上海移远通信技术股份有限公司 13 / 20 GSM TCP/IP 应用流程指导 6 TCP 连接维持和侦测 因为大部分模块连接到 Internet 上都是通过 GPRS 网关中转的，GPRS 网关在这里的作用相当于我们 通常局域网里的路由器。每次，模块试图与 Internet 上的某个服务器建立连接的时候，首先需要 GPRS 网 关分配一个端口给我们的模块。通过这个端口，我们的模块和 Internet 建立联系。这样，就引入了一个问 题：GPRS 网关的端口资源是有限的，因此，它对 GPRS 网内的终端使用这些端口就有了一些限制。为达 到端口资源的合理分配，它会释放长时间没有数据交互的端口资源，以供其他连接使用。这样，模块和 Internet 上的服务器之间的连接就被不知不觉的给掐断了。 关于多长时间没有数据交互，就会释放资源，目前来说，没有一个明确的值。我们在上海的测试情况 是只要不超过 10 分钟，基本就可以保持端口资源不会被释放。 为了避免 TCP 连接经常不知不觉地被 GPRS 网关断开的问题，建议每隔一定时间就向远端服务器发 送一个短数据包。通过这个方法，可以维持 TCP 连接和 TCP 连接状态的侦测。 举例如下： 例如，按照目前我们测试得到的结果，将心跳包的发送的时间间隔定为 10 分钟（但是实际上，有些地 区的运营商可能限制 TCP 连接的失效时间为 1 分钟左右）。 AT+QISACK +QISACK: 1448,1448,0 //检查之前数据发送的情况。 //假设之前已经发送 1448 个字节的数据，并且都已 经发送到服务器。 OK AT+QISEND //发送普通数据。 >1234567890abcdefghijklmnopqrstuvwxyz //发送数据。''表明请求发送已输入的数据。 SEND OK //数据已成功发送至 TCP 协议层。 假设在这之后很长一段时间都不用发送数据了，则需要利用心跳包数据维持连接。在发送心跳包维持 连接之前，可以先通过当前这个报文是否能够发送成功来确定 TCP 连接是否正常。比如说，过了两分钟 （每 5 秒查询一次，查询 24 次。），仍然不能确定这个报文发送成功，可以认为目前的 TCP 连接出现异 常。然后执行命令 AT+QICLOSE 关闭当前 TCP 连接，然后再执行命令 AT+QIOPEN 重新建立 TCP 连接。 连接成功后，再重发上面未发送成功的报文。 AT+QISACK +QISACK: 1484,1448,36 //检查数据发送的情况。 //之前已经发送的数据总长度为 1484 字节，但是已经确认发送成 上海移远通信技术股份有限公司 14 / 20 OK …… AT+QISACK +QISACK: 1484,1484,0 OK …… AT+QISEND >Heart01 SEND OK …… AT+QISACK +QISACK: 1491,1491,0 OK GSM TCP/IP 应用流程指导 功的数据长度只有 1448 字节，刚刚发送的 36 个字节还不确认是 否发送成功。等待 5 秒再次查询。 //等待 5 秒钟。 //检查数据发送的情况。 //所有已发送的 1484 个字节的数据都已经确认发送成功。说明到 目前为止，TCP 连接是正常的。 //等待 8 分钟，一直没有数据发送，也没有收到数据。 //向服务器发送心跳数据。 //发送心跳数据'Heart 01'。这个心跳数据可以再简单一点，当然也 需要根据实际情况定义心跳数据格式，以避免服务器误解。 //等待 5 秒，然后看看心跳数据是否发送成功。 //检查数据发送的情况。 //心跳数据已经成功发送到服务器，说明当前 TCP 连接正常。如果 此时返回的结果是心跳数据还没有确认发送成功（也就是最后一个 参数不为 0），则等待 5 秒后再次查询，如此反复，直到确认心跳数 据发送成功或者查询次数超过 24 次。如果查询次数超过 24 次（也 就是超时 2 分钟），则可以认为当前 TCP 连接出现异常。可以考虑 关闭当前 TCP 连接，重新建立 TCP 连接。 上海移远通信技术股份有限公司 15 / 20 GSM TCP/IP 应用流程指导 7 关闭 TCP 连接 AT+QICLOSE CLOSE OK AT+QIDEACT DEACT OK //所有数据都已发送完成后，关闭当前的 TCP 连接。 //如果此后很长一段时间（比如说一个小时以上）都不会使用这个 GPRS 场景，则建议使用 AT+QIDEACT 命令关闭此场景。这条 命令在正常情况下响应时间大约为 2~5 秒。但是在网络很差或其 他异常情况下，最长会有 40 秒的超时。建议在这里根据实际应用 做一个 40 秒的超时限制，如果超过这个时间仍然没有 DEACT OK 返回，则可以考虑直接使用 EMERG OFF 或 PWRKEY 引脚重启 模块。 上海移远通信技术股份有限公司 16 / 20 GSM TCP/IP 应用流程指导 8 透传连接 如果在初始化时执行了命令 AT+QIMODE=1，则模块在建立 TCP/UDP 连接之后会进入数据模式。在 数据模式下，所有从串口输入的数据都会被认为是发送到远端服务器的数据，而所有从串口输出的数据都 是从远端服务器接收到的数据，除了'CLOSED'和'+PDP DEACT'等特殊文本。下面是一个 TCP 透传的示 例。 8.1. 示例 AT+QIOPEN='TCP','220.180.239.212','8063' //连接一个 TCP 服务器。地址是 220.180.239.212:8063。 OK //命令的语法格式正确并且当前的状态可以建立 TCP 连接。这 里的错误返回可以参考第 3 章的介绍。 CONNECT //TCP 连接成功，并且串口已进入数据模式。这里的错误返回 可以参考第 3 章的介绍。 1234567890abcdefghijklmnopqrstuvwxyz // 可 以 发 送 数 据 了 ， 比 如 说 ， 这 里 我 们 输 入 了 1234567890abcdefghijklmnopqrstuvwxyz ， 这 时 输 入 的 数 据，是不会通过串口回显的。由于这段数据的长度小于 512 （见第 2 章的设置），模块会等待 200ms（见第 2 章的设置）， 然后才将这段数据包发送出去。 abcdefghijklmnopqrstuvwxyz1234567890 //接收的来自服务器的数据。. +++ //输入+++序列退出数据模式。 OK //+++序列的返回。说明串口已经成功回退到命令模式。接下 来如果想关闭 TCP 连接，可以参考第 7 章的示例了。 8.2. 异常处理 在数据模式下如果收到'CLOSED'和'+PDP DEACT'字段时，则说明 TCP 连接可能断开或出现异常 了，但是这些字段也有可能是远端服务器发送过来的 TCP 数据。此时，建议首先通过输入+++序列确认当 前是否仍在数据模式下。如果输入+++后，返回 OK，则说明刚刚成功从数据模式退回到命令模式，这也就 说明此前收到的'CLOSED'或'+PDP DEACT'字段是正常的 TCP 数据；否则，如果输入数据+++后，只有 上海移远通信技术股份有限公司 17 / 20 GSM TCP/IP 应用流程指导 +++的回显（回显打开时），没有 OK 返回，则说明此前已经在命令模式下了，这也就是说此前收到的 'CLOSED'或'+PDP DEACT'字段的意思是 TCP 连接断开或 GPRS 场景断开了，这时需要按照下面的步骤 重新建立 TCP 连接。（当然，如果可以确定远端服务器发送的数据中不会包含 'CLOSED'或'+PDP DEACT'字段时，则可以直接重新建立 TCP 连接，而无需使用+++序列进行判断。） AT+QIDEACT DEACT OK //关闭当前的 GPRS 场景。这条命令在正常情况下响应时间大约为 2~5 秒。但是在网络很差或其他异常情况下，最长会有 40 秒的超 时。建议在这里根据实际应用做一个 40 秒的超时限制，如果超过 这个时间仍然没有 DEACT OK 返回，则可以考虑直接使用 EMERG OFF 或 PWRKEY 引脚重启模块。 上海移远通信技术股份有限公司 18 / 20 GSM TCP/IP 应用流程指导 9 TCP/IP 设计参考流程图 建议的开关机方式： 1. 关机：拉低power key 1s 关 机，然后等待12s或更久后断电； 2. 上电，power key拉高再拉低 2s开机后将power key置高 模块开机 1. AT自适应同步 2. AT+IPR=xxx&W固定和存储波特率 1. 基础配置 2. 场景及APN配置： AT+QIFGCNT/AT+QICSGP 查询(U)SIM卡及初始化状态： 执行AT+CPIN或AT+QINISTAT， 10s内通过AT+CPIN?未读到(U)SIM 卡则重启模块。 GSM网络判断： AT+CREG?查询值为1或5为 找网成功，若开机后90s未找到网络 为失败则重启模块。 1. 基础配置 2. TCP/IP配置 AT+CPIN?查询 (U)SIM 卡状态 10s内未读到(U)SIM卡则重启 模块 找卡成功 AT+CREG?查询GSM 网络状态 90s内GSM网络注册失 败则重启 90s内GSM网络注册成功 GPRS网络判断： 1. AT+CGREG?查询为1/5为 找网成功，不然为失败 2. 90s内若干次查询若找网失败则强 制执行下一步 AT+CGREG?查询GPRS网 络状态90s 激活PDP场景： 1. PDP激活场景： AT+QIREGAPP AT+QIACT 2. 查询IP地址： AT+QILOCIP 备注： a) 以上三个命令必须按顺序捆绑 使用 b) AT+QIACT150s内无响应，则 重启模块 c) AT+QIACT连续3次失败，则 重启模块 3. PDP场景关闭AT+QIDEACT 40s内未收到AT响应则重启 建立连接： 1. AT+QIOPEN发起连接5次为一 组，若均失败则AT+QIDEACT重 试； 2. 执行AT+QIOPEN 75s内无返 回，则断开PDP场景。 40s内未收 到命令返 回则重启 模块 关闭场 景成功 执行AT+QIREGAPP AT+QIACT/ AT+QILOCIP/ 激活PDP场景 激活PDP场景失败 激活PDP成功 执行AT+QIDEACT 关闭PDP场景 执行AT+QIOPEN 建立连接 1. 连续5次失败 2. 75s内无返回 连接成功 执行AT+QISEND 发送数据 执行AT+QISACK ACK查询确认 1. 150s内未收到命令返回 则重启 2. AT+QIACT 激活PDP场 景连续3次失败则重启 90s内收到ACK TCP连接维持和检测： 1. 执行AT+QISEND发送数据。 建议定期向远端发送小数据包，以维护和检测 TCP连接。 2. 通过AT+QISACK查询发送的ACK数据。如果 数据包在两分钟后仍然没有得到确认（每5秒查询 一次，共24次），TCP连接可能不正常。 执行AT +QICLOSE关闭当前连接，然后执行 AT+QIOPEN重新建立TCP连接。 90s内未收到ACK 执行AT+QICLOSE 关闭连接 关闭连接成功 300ms内未收到命令返回则重启 TCP/IP流程其他注意事项： 1. 开机后必须有串口自适应AT同步操作处理，每500ms间隔连续发AT同步（15次），同步成功后AT+IPR=xxx&W固定波特率并保存 2. 所有AT命令必须有返回后才能执行下一条AT指令，普通的AT指令可配置60s超时机制，无响应则重启模块 3. TCPIP涉及到的部分网络交互命令需要做超时机制，超时无返回则重启模块，如：AT+QIACT超时配置150s，AT+QICLOSE超时配置300ms， AT+QIDEACT超时配置40s，超时命令无返回则重启模块 4. 重启机制要求：模块不能被连续重启。当出现连续的异常失败（含流程图内的所有重启操作），第一次可以立即重启，后续可为10分钟后重启， 30分钟重启，1小时重启 图 1： TCP/IP 设计参考流程图 上海移远通信技术股份有限公司 19 / 20 GSM TCP/IP 应用流程指导 10 附录 A 参考文档 表 1：参考文档 序号 文档名称 [1] Quectel_Mxx_AT 命令手册 [2] Quectel_GSM_TCP(IP)_Application_Note 备注 移远通信 GSM 模块的 AT 命令手册 The introduction of how to use the internal TCP/IP stack for GSM modules 表 2：术语缩写 术语 APN FGCNT GPRS MUXIP TCP/IP UDP UART 描述 Access Point Network Foreground Context. The internal TCP/IP stack supports to activate two GPRS PDP contexts at the same time and Foreground context is the context controlled by the UART at present General Packet Radio Service The function to visit several servers or listen to multiple clients based on the same GPRS/CSD context Transmission Control Protocol/Internet Protocol User Datagram Protocol Universal Asynchronous Receiver/Transmitter 上海移远通信技术股份有限公司 20 / 20

GSM 无线通信模块 DTMF传输及编解码 应用文档 V1.1 GSM 模块 DTMF 传输及编解码应用文档 文档标题 版本 日期 状态 GSM 模块 DTMF 传输及编解码应用文档 1.1 2015-04-03 正式发布 版权： 版权所有 ©上海移远通信技术有限公司 2015。 保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2015 非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不 CQouneficdteenl tial 得以任何形式传播。 上海移远通信技术有限公司 - 2 - GSM 模块 DTMF 传输及编解码应用文档 目录 0. 修改记录......................................................................................................................................4 1. 概要..............................................................................................................................................5 1.1. 参考文档............................................................................................................................5 1.2. 缩略语................................................................................................................................5 2. DTMF 的产生及发送...................................................................................................................6 2.1. QLDTMF 本地产生音源回环发送....................................................................................6 2.2. QWDTMF 远程直接发送 ..................................................................................................8 2.3. VTS 远程直接发送 ............................................................................................................9 2.4. 外部 DTMF 发生器输入 MICROPHONE......................................................................10 l 2.5. 四种发送方式性能对比.................................................................................................. 11 3. DTMF 的接收及解码.................................................................................................................12 te 3.1. QTONEDET 内置 DTMF 解码........................................................................................12 c l 3.2. Speaker 输出到外部 DTMF 解码器 ................................................................................13 CQounefidentia 4. 附录：DTMF 音频率定义........................................................................................................14 上海移远通信技术有限公司 - 3 - GSM 模块 DTMF 传输及编解码应用文档 0. 修改记录 版本 1.0 1.1 日期 2010-7-26 2015-04-03 作者 张娉婷 张涛 修改内容记录 初始版本 增加适用模块说明 CQouneficdteenl tial 上海移远通信技术有限公司 - 4 - GSM 模块 DTMF 传输及编解码应用文档 1. 概要 在安全监控、无线接入、车辆远程控制等领域，广泛采用 DTMF 序列及特定频率的单 音来传输交互数据及握手控制协议。针对这种应用，Quectel 首创在 GSM/GPRS 模块中内嵌 完整的 DTMF 及特定频率单音的编解码功能，并提供丰富的 DTMF 传输接口方案。 本文档详细介绍了 Quectel GSM/GPRS 模块在客户端应用于 DTMF 远程传输时的接线 框图、参数配置建议以及指令说明。我们提供了多种发送和接收 DTMF 的方式，客户可以 根据自己的产品设计特点，自由地选择一种 DTMF 传输方案。 本文档适用于所有 Quectel GSM 模块。 1.1. 参考文档 序号 [1] 文档名 Mxx_ATC tel 1.2. 缩略语 c l 术语 DTMF ue tia EFR CQonfiden FR 描述 Dual Tone Multi Frequency Enhanced Full Rate Speed Encoding Full Rate Speed Encoding 备注 GSM 模块的 AT 命令集 备注 双音多频 增强型全速率语音编码 全速率语音编码 上海移远通信技术有限公司 - 5 - GSM 模块 DTMF 传输及编解码应用文档 2. DTMF 的产生及发送 Quectel GSM/GPRS 模块提供四种 DTMF 远程发送方式。 发送 DTMF 不能与语音通话同时进行，用户可以在不发送 DTMF 的时候进行通话，在 发送的时候使麦克风静音，下列部分方式在发送 DTMF 的时候设置了较多参数，在转到语 音通话时必须把这些参数都恢复到默认值。 2.1. QLDTMF 本地产生音源回环发送 AT+QLDTMF 可以用来在本端 Speaker 产生 DTMF 音。然后回环到 Microphone，这样 就可以完成 DTMF 产生并发送出去。 但是，将同一通道的 Speaker 和 Microphone 连接起来同时会带来较大的回音。因此 Quectel 模块提供了 AT+QTONEP 命令，用来指定产生 DTMF 音源的音频通道。这样就可以 分别使用一个音频通道产生 DTMF 音源、另一个音频通道作为语音通话，避免了回音。 推荐的外围电路接线如下： uectel tial Signalpk-pk: Q en 400mV 10uF NM 2.2K Local DTMF generate QUECTEL module MIC1P MIC1N SPK2P Far end DTMF decoder fid  AT命令说明 AT+QLDTMF=,'< dtmf_string>'[,] n DTMF 有效音和间隔时间，y 为 1 时 n 的单位是 10ms；y 不设置 时 n 的单位是 100ms Co 播放的DTMF序列，以逗号间隔，有效DTMF音0-9,*,#,A-D 举例： AT+QLDTMF=5,'1,2,3,4,5,6,7,8,9,0',1 ---DTMF 音 1234567890，有效音 50ms，静音间隔 50ms AT+QLDTMF=5,'1,2,3,4,5,6,7,8,9,0' --- DTMF 音 1234567890，有效音 500ms，静音间隔 500ms 注：有效音最小为 44ms。虽然指令中可以设置静音间隔为 50ms，但实际达不到这么短的时 间，静音间隔实际最小值只能达到 76ms。 上海移远通信技术有限公司 - 6 - GSM 模块 DTMF 传输及编解码应用文档  参数配置建议 以下是一组参数配置、然后拨号并发送 DTMF 的 AT 命令序列： AT+QAUDCH=0 //设置 MIC1P 通道发送 AT+QTONEP=1 //选择 SPK2P 通道产生 DTMF 音源 AT+QECHOEX=0,0,0,0,0,0,0,0 AT+QMIC=0,4 AT+CLVL=10 AT+QSIDET=0 AT+QSFR=7 //关闭回音算法 //设置 MIC1P 通道音量 //设置本地 DTMF 音源的音量 //关闭从 Microphone 到 Speaker 通道的侧音 //优先采用 EFR 编码方式* //主叫或被叫建立通话连接 AT+QLDTMF=5,'1,2,3,4,5,6,7,8,9,0,A,B,C,D,*,#',1 //发送 DTMF 音（有效音 44ms，静音 76ms） *说明： l 1. FR 全速率语音编码：GSM 语音编码方式，是一般的 GSM 手机的通信编码方式，可以 获得达到 4.1 左右 QOS 的语音通信质量(国际电联规定语音通信质量 QOS 满分为 5)。 te 2. EFR 增强型全速率语音编码： GSM 语音的编码方式，基于全速率 13Kbps 的语音编码 CQouneficdential 和发送，可以获得更好更清晰的语音质量(接近QOS4.7)。 上海移远通信技术有限公司 - 7 - GSM 模块 DTMF 传输及编解码应用文档 2.2. QWDTMF 远程直接发送 Quectel 模块还能够在通话过程中，由芯片内部产生 DTMF 音，并在内部直接耦合到语 音发送通道上。采用这种方式无需另外接线。  指令说明 AT+QWDTMF=,,',, [,,,[,...]]' 上行音量，0表示静音,最大值7 下行音量，0表示静音,最大值7 播放的DTMF音，有效DTMF音0-9,*,#,A-D,E(1400Hz),F(2300Hz), G(1000Hz) 播放每个DTMF音的时间长度，单位ms 播放每个DTMF音后静音时间，单位ms l 举例： AT+QWDTMF=7,0,'G,30,20,123456789ABCD,50,50' ---播放整串 DTMF 之前先播放 30ms 的 te1KHz 单音（用于启动声音侦测），间隔 c l 20ms 静 音 后 开 始 播 放 DTMF 音 123456789ABCD，有效音 50ms，静音 ue tia 间隔50ms Q n  参数设置建议 以下是一组参数配置、拨号、然后产生直接耦合到语音通道的 DTMF 的 AT 命令序列： e AT+QAUDCH=0 //设置 MIC1P 通道发送 fid AT+QSFR=7 //优先采用 EFR 编码方式 //主叫或被叫建立通话连接 n AT+QWDTMF=7,0,'G,30,20,123456789ABCD*#,50,50' o //发送 DTMF 音，有效音 50ms，静音 50ms C //然后收到+QWDTMF: 5，表示发送成功 AT+QWDTMF=7,0,'E,100,100,F,100,50' //发送 1400Hz 单音 100ms，静音 100ms， 然后发送 2300Hz 单音 100ms，静音 50ms。 上海移远通信技术有限公司 - 8 - GSM 模块 DTMF 传输及编解码应用文档 2.3. VTS 远程直接发送 GSM 规范支持终端发送 DTMF 启动/停止消息到网络端，然后由 GSM 网络产生 DTMF 音并耦合音频通道发送到远端。 由于 DTMF 音是由 GSM 网络产生，并且终端发送的 DTMF 启动和停止消息到达网络 端以及得到网络处理有一定时延，所以 DTMF 有效音的长度和静音间隔的最小值受到各地 GSM 网络端的具体配置和忙闲程度的限制会呈现不同的值。我们在上海中国移动网络下实 测 DTMF 有效音最小为 170ms 左右，静音间隔最小为 200ms 左右。  指令说明 AT+VTS='' 播放的DTMF音串，以逗号间隔，有效DTMF音0-9,*,#,A-D  参数设置建议 AT+QSFR=7 //优先采用 EFR 编码方式 l //主叫或被叫建立通话连接 CQouneficdteential AT+VTS='1,2,3,4,5,6,7,8,9,0,A,B,C,D,*,#' //发送 DTMF 音（在上海中移动网络中，有效 音 145~185ms，静音 157~213ms） 上海移远通信技术有限公司 - 9 - GSM 模块 DTMF 传输及编解码应用文档 2.4. 外部 DTMF 发生器输入 MICROPHONE 在很多已有的安全监控系统中，也有很多采用专门的 DTMF 发生器来产生指定长度的 有效音以及静音间隔。外围电路接线示意图如下： DTMF编码芯片 QUECTEL module 10uF MIC1P AC Signal pk-pk: 1V 2.2k MIC1N 10uF l 采用这种方法，能够产生非常精确的 DTMF 持续长度和静音间隔。但是 GSM 网络传 te 输过程中，仍然需要解决音频噪音、回声、空中传输等带来的失真。Quectel 模块也专门针 对这种应用提供了一组配置参数和调试方法。 c l  参数设置建议 ue tia AT+QAUDCH=0 AT+QSIDET=0 AT+QSFR=7 Q n AT+EADP=1,0,3,3,0 AT+QECHOEX=0,0,0,0,0,0,0,0 e AT+CAGC=0,0 //设置 MIC1P/1N 通道发送 //关闭侧音，默认值 80 //优先采用 EFR 编码方式 //减小 MIC1P/1N 模拟增益，默认值 1,0,3,3,80 //关闭回音算法，默认值 1,1,1,221,1024,16388,849,0 //关闭自动增益控制，默认值 1,1 Confid //主叫或被叫建立通话连接，DTMF 编码芯片发送音源，脉冲宽度取决于编码芯片 上海移远通信技术有限公司 - 10 - GSM 模块 DTMF 传输及编解码应用文档 2.5. 四种发送方式性能对比 QLDTMF 本地回 环 QWDTMF 远程直接 VTS 远程直接 有效音时间 44ms~10s 10ms~80ms 170ms~1.08s* 空闲时间 76ms~10s 10ms~80ms 200ms~25.5s* 方案成本 低 低 低 切 换 通 话 功 通话时参数设回 切换方便，DTMF 使用时通话静音，通话 能 默认值 时不发送 DTMF *说明： 1. 仅为参考，因不同网络配置而差异。 外部 DTMF 输 入 取决于编码芯片 取决于编码芯片 高 通话时参数设回 默认值 CQouneficdteenl tial 上海移远通信技术有限公司 - 11 - GSM 模块 DTMF 传输及编解码应用文档 3. DTMF 的接收及解码 Quectel 内嵌 DTMF 解码功能，有效降低方案成本。以下详细介绍 Quectel 的内置 DTMF 解码以及传统的外接 DTMF 解码芯片两种方式。 3.1. QTONEDET 内置 DTMF 解码 接收端无需任何额外电路。在启动 DTMF 侦测解码功能后，Quectel 模块将智能侦测 DTMF 音，并主动从串口上报识别的 DTMF 对应的 ASCII 码。  指令说明 AT+QTONEDET= 0：关闭 1：打开 l 注：建议远端音源有效音宽度在 60ms 以上，则解码成功率可达到 99%以上。 te  参数设置 AT+QTONEDET=1 c l //AT+QTONEDET=4,1,3,3,65536 AT+QSFR=7 //使能 DTMF 侦测功能 //降低解码侦测的灵敏度* //优先采用 EFR 编码方式 ue tia //主叫或被叫建立通话连接，远端发 DTMF 音源 Q n +QTONEDET: 49 e +QTONEDET: 50 +QTONEDET: 69,100 fid +QTONEDET: 70,400 //侦测到'1'并上报 1 的 ASCII 码 //侦测到'2'并上报 2 的 ASCII 码 //侦测到 100ms 的 1400Hz 单音 //侦测到 400ms 的 2300Hz 单音 *说明： n 1. 为了尽可能减少不同宽度音源解码的丢码、重码率，专门提供一个参数调整解码功能 的灵敏度。 o 2. 对于安防报警系统中大部分音源为 50ms/50ms 的应用，不用设置该参数，默认设置已 C符合应用； 3. 对 于 接 收 远 端 话 机 的 二 次 按 键 ， 音 源 一 般 大 于 100ms/100ms ， 增 加 设 置 AT+ QTONEDET=4,1,3,3,65536 能有效降低重码率 上海移远通信技术有限公司 - 12 - GSM 模块 DTMF 传输及编解码应用文档 3.2. Speaker 输出到外部 DTMF 解码器 传统的 DTMF 解码方式是在 Speaker 输出端接上 DTMF 解码芯片，解码芯片侦测到 DTMF 音后输出中断及 DTMF 编码。 QUECTEL module SPK1P DTMF解码芯片 C1 IN+ C2 SPK1N IN-  参数设置 l AT+QAUDCH=0 te AT+QSFR=7 AT+CLVL=80 //设置 SPK1P/1N 通道接收 //优先采用 EFR 编码方式 //设置输出幅度，根据解码情况设置 60~100 CQouneficdential //主叫或被叫建立通话连接，接收DTMF传给解码芯片 上海移远通信技术有限公司 - 13 - GSM 模块 DTMF 传输及编解码应用文档 4. 附录：DTMF 音频率定义 Quectel模块中的DTMF音频率是采用电话系统标准定义的。具体组合见下表： 低群（Hz） 1209 高群（Hz） 1336 1477 1633 697 1 2 3 A 770 4 5 6 B 852 7 8 9 C CQouneficdteenl tial 941 * 0 # D 上海移远通信技术有限公司 - 14 - CQouneficdteenl tial 上海移远通信技术有限公司 上海市徐汇区田州路 99 号 9 幢 501 室 电话: +86 21 5108 2965 邮箱: info@quectel.com

GSM无线通信模块 TTS应用指导 GSM模块TTS应用指导_V1.2 GSM 模块 TTS 应用指导 文档名 版本 日期 状态 文档受控号 GSM 模块 TTS 应用指导 1.2 2015-05-08 发布 GSM 模块 TTS 应用指导_V1.2 前言 移远公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规范，参数 来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。 在未声明前，移远公司有权对该文档规范进行更新。 tel 版权申明 c l 本文档手册版权属于移远公司，任何人未经我公司复制转载该文档将承担法律责任。 ue tia 版权所有 ©上海移远通信技术有限公司 2015，保留一切权利。 CQonfiden Copyright © Quectel Wireless Solutions Co., Ltd. 2015 上海移远通信技术有限公司 - 1 - GSM 模块 TTS 应用指导 目录内容 目录内容...........................................................................................................................................2 0. 修改记录......................................................................................................................................3 1. 概要..............................................................................................................................................4 1.1 参考文档..............................................................................................................................4 2. TTS 相关命令...............................................................................................................................5 3. TTS 功能操作方法.......................................................................................................................6 3.1 语音播报，输入 Unicode 文本内容 ..................................................................................6 3.2 语音播报，直接输入文本内容 ..........................................................................................6 3.3 停止 TTS 功能.....................................................................................................................6 CQouneficdteenl tial 上海移远通信技术有限公司 - 2 - GSM 模块 TTS 应用指导 0. 修改记录 版本 1.0 1.1 1.2 日期 作者 2010-06-17 杨中志 2011-07-19 徐源 2015-05-08 徐源 修改内容记录 初始版本 改变操作方式，增加 ASCII 播报方式 增加适用模块说明 CQouneficdteenl tial 上海移远通信技术有限公司 - 3 - GSM 模块 TTS 应用指导 1. 概要 该文档主要介绍了如何使用移远标准模块的TTS（用语音播报文本内容）功能。使用该 功能，用户可以将输入的中文文本以语音播报的方式从模块的辅助通道输出。 注意：该功能只适用于提供给客户使用的特殊版本软件。 本文档适用于Quectel M26，M35，GC65-E和M50模块。 1.1 参考文档 表 1: 参考文档表 序号 CQouneficdteenl tial [1] 文档名 Mxx_ATC 备注 AT 命令集简介 上海移远通信技术有限公司 - 4 - GSM 模块 TTS 应用指导 2. TTS 相关命令 AT+QTTS TTS Command Test Command AT+QTTS=? Read Command AT+QTTS? Response: OK Response: 正在播报时status为1，否则为0 +QTTS: OK Write Command Response CQouneficdteenl tial AT+QTTS=, 如果为0，返回： OK 如果为1，返回： OK //开始语音播报 +QTTS:0 If error is related to ME functionality: +CME ERROR: Parameter 开始或停止TTS语音播报，并定义文本 输入格式 0 停止语音播报。参数被忽略。 1 开始语音播报，文本输入UCS2编 码。 2 开始语音播报，直接输入字符。 普通字符采用ASCII码，汉字采用GBK编 码。 需要播报的文本，根据mode采取不同的编 码方式。 最大长度959字节 上海移远通信技术有限公司 - 5 - GSM 模块 TTS 应用指导 3. TTS 功能操作方法 本章节主要描述使用TTS功能具体的操作步骤。 3.1 语音播报，输入 Unicode 文本内容 AT+QTTS=1, '6B228FCE4F7F752879FB8FDC6A215757' //文本采用 UCS2 码对应的十六进制 码，此处文本内容'欢迎使用移远 模块'。需要先将需要播报的内容用 相关工具转化为 UCS2 码。语音播 OK tel +QTTS:0 报时，语音将从模块的辅助通道（耳 机/免提）输出。 //当输入的文本播报结束后，会上报该提示。然后可以使用上面的命令 继续播报其他文本 uec tial 3.2语音播报，直接输入文本内容 AT+QTTS=2, 'hello 你好 thank you' Q en OK //文本可直接输入，普通字符采用 ASCII 码， 汉字采用 GBK 码。语音播报时，语音将从 模块的辅助通道（耳机/免提）输出。 fid +QTTS:0 //当输入的文本播报结束后，会上报该提示。 n 3.3 停止 TTS 功能 Co AT+QTTS=0 //语音播报时，可使用该命令停止语音播报。 OK //停止后提示 OK 上海移远通信技术有限公司 - 6 - 上海移远通信技术有限公司 上海市徐汇区田州路 99 号 13 幢 501 室 电话: +86 21 5108 6236 邮箱: info@quectel.com

GSM Audio Player Application Note GSM/GPRS Module Series Rev. GSM_Audio_Player_Application_Note_V3.2 Date: 2015-05-20 www.quectel.com GSM Module Series GSM Audio Player Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx Or Email: Support@quectel.com tel GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT ue tia 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 Q n RELIANCE UPON THE INFORMATION. THE INFORMATION SUPPLIED HEREIN IS SUBJECT TO CHANGE WITHOUT PRIOR NOTICE. fide COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS n DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_Audio_Player_Application_Note Confidential / Released 1 / 30 GSM Module Series GSM Audio Player Application Note About the Document History Revision Date 3.0 2013-02-19 ctel l 3.1 2013-04-18 CQounefidentia 3.2 2015-05-20 Author Thomas ZHANG Thomas ZHANG Thomas ZHANG Description Initial 1. Modified the sampling rate of audio recording format in Table 2. 2. Modified Figure 1: Audio Playback Overview 3. Renamed 'Receiver' as 'Normal Audio Channel'. 4. Renamed 'Earphone' as 'Headset'. 5. Modified AT Commands: AT+QPLAYRES/ AT+QPSND. Added applicable modules GSM_Audio_Player_Application_Note Confidential / Released 2 / 30 GSM Module Series GSM Audio Player Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 2 Overview ............................................................................................................................................... 6 3 Audio Recording .................................................................................................................................. 7 3.1. Record from Microphone ............................................................................................................ 7 3.2. Record from Voice Call ............................................................................................................... 7 4 5 3.3. Supported Recording Format ..................................................................................................... 7 Audio Playback .................................................................................................................................... 8 4.1. Source of Playback ..................................................................................................................... 9 l 4.1.1. Playback from File System .............................................................................................. 9 4.1.2. Playback from Stream (.bin)............................................................................................. 9 te 4.1.3. Playback from Stream (UART Input)................................................................................ 9 4.2. Type of Playback......................................................................................................................... 9 c l 4.2.1. Playback in Idle State..................................................................................................... 10 ue tia 4.2.2. Playback in Voice Call State .......................................................................................... 10 4.3. Supported Audio Formats ......................................................................................................... 10 Related AT Command Description................................................................................................... 11 Q n 5.1. AT Command Syntax ................................................................................................................ 11 5.2. Description of AT Command ..................................................................................................... 11 e 5.2.1. AT+QAUDRD Record Media File ................................................................................ 11 fid 5.2.2. AT+QAUDPLAY Play Media File ............................................................................... 13 5.2.3. AT+QAUDSTOP Stop Playing Media File ................................................................. 14 5.2.4. AT+QPLAYRES Play Audio Stream from Resource Bin ........................................... 15 n 5.2.5. AT+QSTOPRES Manually Stop the Audio Resource Playing................................... 16 5.2.6. AT+QPRESBG Playback Audio from Resource Bin to the Remote in Call ................ 16 o 5.2.7. AT+QPSND Play Audio File and Send it to the Remote in Call ................................ 18 C 5.2.8. AT+QPCMD Play PCM Stream from UART to the Remote in Call ........................... 19 5.2.9. AT+QMEDVL Set/Get Media Volume Gain ............................................................... 21 6 Appendix A Reference....................................................................................................................... 22 7 Appendix B Error Codes ................................................................................................................... 23 8 Appendix C Audio Resource Generator .......................................................................................... 24 8.1. Overview ................................................................................................................................... 24 8.1.1. Advantages .................................................................................................................... 24 8.1.2. Procedure....................................................................................................................... 24 8.2. Make and Download Bin File .................................................................................................... 25 8.2.1. Make Bin File.................................................................................................................. 25 8.2.2. Download Audio Bin File to Module ............................................................................... 28 GSM_Audio_Player_Application_Note Confidential / Released 3 / 30 GSM Module Series GSM Audio Player Application Note Table Index TABLE 1: SUPPORTED MODULES ................................................................................................................... 6 TABLE 2: RECORDING FORMAT....................................................................................................................... 7 TABLE 3: AT COMMANDS MATRIX.................................................................................................................... 9 TABLE 4: SUPPORTED AUDIO FORMATS ..................................................................................................... 10 TABLE 5: +QAUDRIND CODE.......................................................................................................................... 13 TABLE 6: +QAUDPIND CODE .......................................................................................................................... 14 TABLE 7: RELATED DOCUMENTS .................................................................................................................. 22 TABLE 8: TERMS AND ABBREVIATIONS ........................................................................................................ 22 TABLE 9: DESCRIPTION OF DIFFERENT CODING SCHEMES .................................................................... 23 CQouneficdteenl tial GSM_Audio_Player_Application_Note Confidential / Released 4 / 30 GSM Module Series GSM Audio Player Application Note 1 Introduction This document describes the functions of audio playback and audio recording of Quectel modules. The revolved AT commands are listed in this document. This document is applicable to Quectel M10, M26, M35 and M50 modules. CQouneficdteenl tial GSM_Audio_Player_Application_Note Confidential / Released 5 / 30 GSM Module Series GSM Audio Player Application Note 2 Overview For Quectel modules with audio function, most of them have two analog audio channels at least. Audio could be recorded from microphone or uplink / downlink speech, and stored, in the form of files, into memory, such as flash and SD card. These recorded audio files can also be played back with modules’ DAC and DSP. Besides, playback of audio stream stored in binary or input from UART is supported as well. The functions related to file operation, such as recording, audio file playback, are only available on Quectel modules with UFS (user file storage) function. The UFS function is mostly provided in the module l with enough flash memory, 32Mbit at least. te AT+QPLAYRES and AT+QPRESBG are supported in module with 64Mbit and above flash. AT+QAUDRD, AT+QAUDPLAY, AT+QAUDSTOP and AT+QPSND are supported in module with 32Mbit and above flash. c l AT+QPCMD is supported in module with flash smaller than 32Mbit. ue tia The following table lists the detailed supported modules. Q n Table 1: Supported Modules e AT Commands M10 M26 M35 fid AT+QAUDRD YES YES YES AT+QAUDPLAY NO YES YES n AT+QAUDSTOP NO YES YES o AT+QPLAYRES NO NO NO C AT+QSTOPRES NO NO NO M50 YES YES YES YES YES AT+QPRESBG NO NO NO NO AT+QPSND NO NO NO NO AT+QPCMD YES YES YES YES AT+QMEDVL NO YES YES YES These functions will be described in the next few chapters. GSM_Audio_Player_Application_Note Confidential / Released 6 / 30 GSM Module Series GSM Audio Player Application Note 3 Audio Recording 3.1. Record from Microphone Use the AT+QAUDRD (details in section 5.2.1) can record the sound from microphone. AT+QAUDCH can select which microphone channel to be used. Several media formats are supported, such as WAV_PCM16, WAV_ALAW, WAV_ULAW, WAV_ADPCM and AMR. Refer to Table 2: Recording Format. See the AT commands description for more information. l 3.2. Record from Voice Call te Downlink and uplink speech could be recorded during voice call. Use the same AT+QAUDRD command, c l just after call is established. ue tia 3.3. Supported Recording Format Q en Table 2: Recording Format fid Format Encoding n 3 AMR Sampling Rate 8 KHz o 13 WAV_PCM16 8 KHz C 14 WAV_ALAW 8 KHz Sampling Resolution 13 bit 16 bit 16 bit Encoding Digit 16 bit 8 bit Encode Speed 128 kbps 64 kbps File Size 40 KB/min 960 KB/min 480 KB/min 15 WAV_ULAW 8 KHz 16 bit 8 bit 64 kbps 480 KB/min 16 WAV_ADPCM 8 KHz 16 bit 4 bit 32 kbps 240 KB/min GSM_Audio_Player_Application_Note Confidential / Released 7 / 30 GSM Module Series GSM Audio Player Application Note 4 Audio Playback Two aspects will be described here. One is the source of the playback. Audio can be played back from the file system or from binary stream or even from UART. The other is the type of the playback. Audio can be playback in the voice call state and idle state. Different commands should be used for different combination of these two aspects. See the table below. The formats supported for each command is different either. See Chapter 4.3. See the following figure and table to get an overview of the audio playback. uectel tial UART Module PCM(Linear/A-Law/U-Law) AT+QPCMD Voice Call Q en Flash nfid DAC WAV/AMR Audio Bin Data WAV/AMR AT+QPLAYRES AT+QPRESBG File System oWAV/AMR/MP3 C AT+QAUDPLAY Audio Files WAV/AMR AT+QPSND Figure 1: Audio Playback Overview GSM_Audio_Player_Application_Note Confidential / Released 8 / 30 Table 3: AT Commands Matrix Idle Voice Call File system AT+QAUDPLAY AT+QPSND GSM Module Series GSM Audio Player Application Note Bin AT+QPLAYRES AT+QPRESBG UART AT+QPCMD AT+QPCMD 4.1. Source of Playback Audio data (digital form) to be played back can come from several sources, files stored in file system, data binary (.bin) stored in the flash, and PCM stream input from UART. 4.1.1. Playback from File System l Audio files stored in module’s file system could be played back, either in flash or in memory card. In idle state (no call), AT+QAUDPLAY (section 5.2.2 ) is used to play the audio files. During voice call, te AT+QPSND (section 5.2.7) is used to play the audio files to the other side of the call. uec tial 4.1.2. Playback from Stream (.bin) Audio data could be packed into a binary file (.bin) and downloaded into module’s flash memory, just like module’s firmware. The data is structured into the binary. The PC side tool is provided to generate such Q n bin for production line. See appendix C (Chapter 8 ) for the detailed usage of audio resource bin generator. fide In idle state, AT+QPLAYRES (section 5.2.4) is used to play such audio resource. During voice call, AT+QPRESBG (section 5.2.6) is used to play such audio resource to the other side of the call. n 4.1.3. Playback from Stream (UART Input) o PCM stream input from UART can also be played back. AT+QPCMD (section 5.2.8 ) is used in this C scenario. It should be noticed that only 8 KHz sampling rate is supported. 4.2. Type of Playback The type mentioned here is to play in idle or voice call state. Different type supports the different audio playback format. In general, playback in idle state can support more formats than in voice call state. GSM_Audio_Player_Application_Note Confidential / Released 9 / 30 GSM Module Series GSM Audio Player Application Note 4.2.1. Playback in Idle State Idle state means no call exists. Sound will output to local speakers. AT+QAUDPLAY (section 5.2.2) and AT+QPLAYRES (section 5.2.4) belong to such category. 4.2.2. Playback in Voice Call State The played sound will be mixed into the downlink and uplink speech stream and send to the far end of voice call. AT+QPSND (section 5.2.7 ), AT+QPRESBG (section 5.2.6 ) and AT+QPCMD (section 5.2.8 ) belong to such category. 4.3. Supported Audio Formats The table below shows the formats supported in each command. l Table 4: Supported Audio Formats te Commands c l AT+QAUDPLAY ue tia AT+QPSND AT+QPLAYRES Q n AT+QPRESBG Confide AT+QPCMD Supported Formats WAV (Linear PCM, A-Law, U-Law, ADPCM), AMR, MP3 8 KHz sampling rate WAV, AMR WAV (Linear PCM, A-Law, U-Law, ADPCM), AMR 8 KHz sampling rate WAV (Linear PCM, A-Law, U-Law, ADPCM), AMR 8 KHz sampling rate: raw data of linear PCM, A-Law and U-Law GSM_Audio_Player_Application_Note Confidential / Released 10 / 30 GSM Module Series GSM Audio Player Application Note 5 Related AT Command Description 5.1. AT Command Syntax Test Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. Read Command Write Command l Execution Command AT+? AT+= AT+ This command returns the currently set value of the parameter or parameters. This command sets the user-definable parameter values. This command reads non-variable parameters affected by internal processes in the GSM engine uecte tial 5.2. Description of AT Command 5.2.1. AT+QAUDRD Record Media File Q n Record the uplink and downlink speech during voice call or record sound from local microphone in idle e state and save it to files. fid AT+QAUDRD Record Media File Test Command n AT+QAUDRD=? Response +QAUDRD: (list of supported s),'filename'[,(list of supported s)] Co Read Command OK Response AT+QAUDRD? +QAUDRD: Write Command AT+QAUDRD=[,'filename'[, ]] Reference OK Response OK GSM_Audio_Player_Application_Note Confidential / Released 11 / 30 GSM Module Series GSM Audio Player Application Note Parameter Recording state 0 Module is not in recording 1 Module is in recording 'filename' Name of the file to record, refer to Note 1 Format of the file, refer to Note 2 3 AMR 13 WAV_PCM16 14 WAV_ALAW 15 WAV_ULAW 16 WAV_ADPCM Start to record or stop the recording 0 Stop the recording 1 Start to record l NOTES te 1. 'filename' includes file path, file name and file suffix. File path can be UFS, RAM, SD root directory c l and SD subdirectory. Corresponding examples, 'Example.wav', 'RAM:Example.wav', 'SD: Example.wav' and 'SD:DirectoryExample.wav'. File suffix can be 'wav' or 'amr' when the ue tia is omitted. For 'amr' suffix, file is stored in AMR coding format. For 'wav' suffix, file is stored in WAV_ADPCM coding format in voice call state, and stored in WAV_PCM16 coding format in idle state. Q n 2. When the file suffix is 'amr', the format can only be '3' (AMR). When the file suffix is 'wav', the format can be '13' (WAV_PCM16), '14' (WAV_ALAW), '15' (WAV_ULAW), and '16' (WAV_ADPCM). For e other suffixes, parameter must be provided. Please refer to Table 2: Recording Format. fid 3. If the recording file’s name and format is same with an existed file. Recording data will be appended to the end of the file. 4. Record media file to SD subdirectory, you need to create the subdirectory manually first. 5. Audio channel is decided by AT command: AT+QAUDCH n 6. The recording would be forced to quit in the following cases. o a) Start to record when module is on idle. Make a call or answer a call, the recording would be forced to quit. C b) Start to record when module is on a call. The recording would be forced to quit when the call is hanged up. When the recording is forced to quit, URC +QAUDRIND: 0, would be output through UART. Refer to Table 5: +QAUDRIND Code. 7. Gain of the recording cannot be adjusted by AT command. GSM_Audio_Player_Application_Note Confidential / Released 12 / 30 GSM Module Series GSM Audio Player Application Note Table 5: +QAUDRIND Code Meaning 0 Reserved 1 Unknown error 3 Disk is full 6 Interrupted by other audio task 10 Disk not found 5.2.2. AT+QAUDPLAY Play Media File Play back the audio files in idle mode and output to speakers. l AT+QAUDPLAY Play Media File te Test Command c l AT+QAUDPLAY=? Response +QAUDPLAY: 'filename',(list of supported s),( list of supported s)[,( list of supported s )] ue tia WriteCommand Q n AT+QAUDPLAY= 'filename',,[,] OK Response OK fid Reference n Parameter Co 'filename' Name of the file to play, includes file path, file name and file suffix. File suffix can be AMR,WAV or MP3 Whether to play media file repeatedly 0 Play only one time 1 Play repeatedly Volume level to play media file Range: 0-100 Channel to play media file 0 Normal audio channel 1 Headset GSM_Audio_Player_Application_Note Confidential / Released 13 / 30 2 Loud Speaker GSM Module Series GSM Audio Player Application Note NOTES 1. If the parameter is omitted, channel is decided by AT command: AT+QAUDCH. 2. When the playing is finished or interrupted by other audio tasks, URC +QAUDPIND: 0, would be output through UART. Refer to Table 6: +QAUDPIND code. Table 6: +QAUDPIND code Meaning 5 Playing is finished 6 Interrupted by other audio tasks l 9 Unknown error cte l 5.2.3. AT+QAUDSTOP Stop Playing Media File ue tia Stop the audio file playback triggered by AT+QAUDPLAY. AT+QAUDSTOP Stop Playing Media File Q n Test Command e AT+QAUDSTOP=? Execution Command fid AT+QAUDSTOP Reference Response OK Response OK n Example Co AT+QAUDRD=1,'A.amr',3 // Record a media file in AMR format, store it in UFS. OK // Name it as 'A' AT+QAUDRD=0 OK // Stop the recording. AT+QAUDRD=1,'SD:B.wav' // Record a media file in WAV_PCM16 format, store it in OK SD root directory and Name it as 'B'. AT+QAUDRD=0 // Stop the recording OK // Create a subdirectory named 'picture' before recording AT+QAUDRD=1,'SD:pictureC.wav' // Record a media file, and store it in SD subdirectory, OK // Name it as 'C'. GSM_Audio_Player_Application_Note Confidential / Released 14 / 30 GSM Module Series GSM Audio Player Application Note AT+QAUDRD=0 //Stop the recording OK AT+QAUDPLAY='A.amr',0,100,1 // Play the 'A' media file, not repeat, volume 100, through OK headset. +QAUDPIND: 0,5 // After playing is finished, URC report is output AT+QAUDPLAY='SD:pictureB.wav',0,100,1 // Play the 'B' media file, not repeat, volume 100, OK through Headset. +QAUDPIND: 0,5 //After playing is finished, URC report is output. AT+QAUDPLAY='SD:C.wav',1,80,1 // Play the 'C' media file, repeat, volume 80, through OK headset. AT+QAUDSTOP // Stop the playing OK 5.2.4. AT+QPLAYRES Play Audio Stream from Resource Bin Play back the audio binary (.bin) that is already downloaded into flash in idle mode and output it to l speakers. te AT+QPLAYRES Play Audio Stream from Resource Bin c l Test Command AT+QPLAYRES=? ue tia WriteCommand Q n AT+QPLAYRES='resname',, fide Reference Response +QPLAYRES: 'resname',(list of supported s),(list of supported s) OK Response OK If error is related to ME functionality: +CME ERROR: n Parameter Co 'resname' A string prefixed with 'RES:', followed by the audio ID, like 'RES:0001'. The ID of the Nth audio resource is N. For example, the first is 0001; the second is 0002 and so on. Whether to play media file repeatedly 0 Play only once 1 Play repeatedly Volume level. Range: 0-100 GSM_Audio_Player_Application_Note Confidential / Released 15 / 30 GSM Module Series GSM Audio Player Application Note NOTES 1. If the audio is not found in Bin file, error is returned. 2. Use the audio resource generator to make a bin. See appendix, chapter 8. 5.2.5. AT+QSTOPRES Manually Stop the Audio Resource Playing Stop the audio bin playback triggered by AT+QPLAYRES. AT+QSTOPRES Manually Stop the Audio Resource Playing Test Command Response AT+ QSTOPRES=? Execute Command AT+ QSTOPRES Reference OK Response OK tel Example c l AT+QAUDCH=1 ue tia OK AT+QPLAYERS='RES:0023',0,1 OK Q n +QAUDPIND: 0,0 AT+QPLAYERS='RES:0023',1,1 e OK AT+QSTOPRES fid OK // Set output channel to earphone // Play the 23th audio for once // Playing completes // Play the 23th audio endlessly // Stop playing n 5.2.6. AT+QPRESBG Playback Audio from Resource Bin to the Remote in Call o Play back audio bin that is already downloaded into flash during voice call. The audio will be mixed to the C uplink and downlink speech. AT+QPRESBG Playback Audio from Resource Bin to the Remote in Call Test Command AT+QPRESBG=? Response +QPRESBG: (list of supported s),[(list of supported s),(list of supported s),(list of supported s)[,(0-2)]] OK GSM_Audio_Player_Application_Note Confidential / Released 16 / 30 Write Command AT+QPRESBG=[,,,[,]] Reference Response OK GSM Module Series GSM Audio Player Application Note Parameter Start playback or stop the playback 0 Stop playing. The parameters behind can be omitted 1 Play audio bin resource Sequence number of audio resource in bin file ctel l Range: 1-N (N: integer, total numbers of audio files) Uplink volume Range: 0 - 7 Downlink volume Range: 0 - 7 Audio output channel. It is optional. 0 Normal audio channel 1 Headset 2 Loud Speaker ue tia NOTES Q n 1. URC Report：+QPRESBG: 0, =5: playing finished e =6: playing interrupted fid 2. Audio resource can only be AMR file or 8KHz WAV file. 3. If is not be set in this command, the channel will be controlled by AT+QAUDCH. n Example o AT+QPRESBG=? C +QPRESBG: (0,1),(1-n),(0-7),(0-7)[,(0-2)] OK AT+QPRESBG=1,1,6,7,1 OK AT+QPRESBG=0 OK AT+QAUDCH=0 OK AT+QPRESBG=1,2,6,5 OK // Play the audio which’s sequence number is 1 in bin resource. // Uplink volume is 6; downlink volume is 7, use earphone to play // Stop playback // Set main channel to play audio // Play the audio which’s sequence number is 2 in bin resource. // Use main channel to play GSM_Audio_Player_Application_Note Confidential / Released 17 / 30 GSM Module Series GSM Audio Player Application Note 5.2.7. AT+QPSND Play Audio File and Send it to the Remote in Call Play back the audio files during voice call. The audio will be mixed to the uplink and downlink speech. AT+QPSND Play Audio File and Send it to the Remote in Call Test Command AT+QPSND=? Response +QPSND: (list of supported s),'filename',( list of supported s),( list of supported s)[,( list of supported s)][,( list of supported s)] OK Write Command AT+QPSND =[,'filename', ,[,[,]]] l Reference Response OK If error is related to ME functionality +CME ERROR: cte l Parameter ue tia Q n 'filename' fide n Co Start playback or stop the playback 0 Stop the playback 1 Start playback File name of the audio file. If file is located in UFS, embrace the file name into the quotes, e.g. 'example.wav'; If file is located in SD card, add label 'SD:' ahead of the file name, e.g. 'SD:example.wav'. The audio file must be 8KHz wav file or AMR file. Repeat counts 0 Repeat endless N Repeat N times, Range of N:1-32767 Uplink volume Range: 0 - 7 Downlink volume Range: 0 - 7 Audio output channel of playback 0 Normal audio channel 1 Headset 2 Loudspeaker GSM_Audio_Player_Application_Note Confidential / Released 18 / 30 GSM Module Series GSM Audio Player Application Note NOTES 1. If playback during voice call, the will not take effect, instead, the downlink sound will output from the same speaker with speech. If playback without voice call established, the will take effect. 2. If this parameter is omitted, the output path will be decided by AT+QAUDCH. 3. The audio file must be 8KHz WAV file or AMR file, otherwise, the playback will fail Example AT+QPSND=? +QPSND: (0,1),'filename',(0-32767),(0-7)[,(0-7)][,(0-2)] // Query parameter OK AT+QPSND=1,'rec01.wav',1,7,7 OK l AT+QPSND=0 OK // Start playback // Stop the playback cte l 5.2.8. AT+QPCMD Play PCM Stream from UART to the Remote in Call ue tia Play back PCM stream that is input from UART during voice call. The audio will be mixed to the uplink and downlink speech. Q n AT+QPCMD Play PCM Stream from UART to the Remote in Call Test Command fide AT+QPCMD=? Response +QPCMD: (list of supported s)[,( list of supported s),( list of supported s),( list of supported s)[,( list of supported s)]] n Write Command o AT+QPCMD= C [,,,[,] OK Response if is AT command port, response OK ] CONNECT else response OK If error is related to ME functionality +CME ERROR: Reference GSM_Audio_Player_Application_Note Confidential / Released 19 / 30 GSM Module Series GSM Audio Player Application Note Parameter Start playback or stop the playback 1 Start play PCM stream 0 Stop play PCM stream Uplink volume Range: 0-7 Downlink volume Range: 0-7 Format of PCM stream 0 16-bit linear PCM 1 8-bit linear PCM 2 8-bit a-law 3 8-bit u-law UART port number of PCM stream to input. The default port is AT command port. Range: 1-3 tel NOTES 1. If is 0, other parameters are ignored. c l 2. The format of PCM stream must be PCM raw data and the sample rate must be 8k HZ. ue tia 3. Recommend to set to 0 4. Recommend to open hardware flow control 5. On port, Q n If buffer of UART is full, the following URC will be reported, FULL e If buffer of UART resumes empty, the following URC will be reported, READY fid Example n AT+QPCMD=1,7,0,2 OK // Start to play PCM input from the AT command port Co CONNECT // Enter data mode READY // UART is ready to receive PCM data. FULL // UART buffer is full, recommended to stop send PCM data. READY +++ OK AT+QPCMD=1,7,0,2,2 // UART is ready to receive PCM data. // Input '+++'to exit data mode and stop play PCM. // Start to play PCM data which is input from a different serial port from AT GSM_Audio_Player_Application_Note Confidential / Released 20 / 30 command port OK AT+QPCMD=0 // Stop playing PCM. OK GSM Module Series GSM Audio Player Application Note 5.2.9. AT+QMEDVL Set/Get Media Volume Gain Get or set the volume level of media playback in idle mode. This command controls the volume level of AT+QAUDPLAY and AT+QTTS. Volume gain of uplink/downlink of AT+QPSND, AT+QPRESBG and AT+QPCMD cannot be controlled by this command. AT+QMEDVL Set/Get Media Volume Gain Test Command AT+QMEDVL=? Response +QMEDVL: (list of supported s) tel Read Command AT+ QMEDVL? OK Response +QMEDVL: uec tial WriteCommand AT+QMEDVL= Q n Reference OK Response OK If format is error, response +CME ERROR: fide Parameter Volume level of media playback n Range : 0-100 Co Example AT+QMEDVL=? // Test command +QMEDVL: (0-100) OK AT+QMEDVL? +QMEDVL: 50 // Read command OK AT+QMEDVL=90 OK // Write command GSM_Audio_Player_Application_Note Confidential / Released 21 / 30 GSM Module Series GSM Audio Player Application Note 6 Appendix A Reference Table 7: Related Documents SN Document name Remark [1] Mxx_AT_Commands_Manual AT Commands Manual l Table 8: Terms and Abbreviations te Abbreviation c l ME ue tia TA MS Q n UFS Confide NV Description Mobile Equipment Terminal Adapter Mobile Station User File Storage Non-volatile GSM_Audio_Player_Application_Note Confidential / Released 22 / 30 GSM Module Series GSM Audio Player Application Note 7 Appendix B Error Codes Table 9: Description of Different Coding Schemes Code of Meaning 4300 4302 4303 4304 4305 4306 4401 4402 4403 4404 Wrong format Audio task busy l Create file failed te Additional recording in a different format c l Disc full ue tia Filewriteprotect Play PCM fail Q n Audio device busy e No memory Confid UART buffer full GSM_Audio_Player_Application_Note Confidential / Released 23 / 30 GSM Module Series GSM Audio Player Application Note 8 Appendix C Audio Resource Generator This chapter introduces how to generate the audio resource bin. The PC side tool is provided. 8.1. Overview Audio stream data in wav and AMR files could be packed into a binary file (.bin) with Quectel tool l GenBinFile. Such .bin file could be downloaded into module just like the firmware upgrade, and can be te played back with the AT+QPLAYRES and AT+QPBGRES. c l 8.1.1. Advantages ue tia There are three advantages of using audio bin to play audio:  Do not occupy the space of file system. Q n  Audio Data can be saved to module conveniently e  It is able to play AMR file or wave file to the other side during the voice call fid 8.1.2. Procedure The whole procedure of Audio Bin includes four steps: on Step1: Prepare audio resource. It supports the format of AMR and wav only now. C Step2: Use the tool of GenBinFile to pack the audio resource to a bin file Step3: Use the tool of Firmware_Upgrade_Tool_Lite_GS2_V1.2 to download the bin file to the module Step4: Use AT commands to play audio. GSM_Audio_Player_Application_Note Confidential / Released 24 / 30 GSM Module Series GSM Audio Player Application Note Figure 2: Procedure l The figure above shows that it is needed to make audio bin file and download it to module before playing te audio. Next chapters will describe the method for making and downloading bin file. c l 8.2. Make and Download Bin File ue tia 8.2.1. Make Bin File Q n 8.2.1.1. Prepare Audio Resource fide Audio bin file is made from audio resource file. The format of audio file which is used to make bin file must be AMR or WAV. And the tool of GenBinFile only supports the two formats. When audio resource is ready, Con it must be put into the folder of 'audio' at the same directory of GenBinFile tool. Refer to figure below. Put audio resource in this folder. Figure 3: Prepare Audio Resource File 8.2.1.2. Run GenBinFile Double-click the icon of GenBinFile and open the interface of this tool. Refer to the figure below. GSM_Audio_Player_Application_Note Confidential / Released 25 / 30 GSM Module Series GSM Audio Player Application Note Click this button to select audio resource. Figure 4: Interface of GenBinFile l 8.2.1.3. Select Audio Resource te Click the '…' button and the dialog box window for choosing audio resource will be displayed. The default c l directory showed in this window is the location of GenBinFile tool. Open 'audio' folder and select one or ue tia more audio resource in the interface of dialog window. Refer to the figures below. CQonfiden Open this folder to get audio resource. Figure 5: Open the 'Audio' Folder GSM_Audio_Player_Application_Note Confidential / Released 26 / 30 GSM Module Series GSM Audio Player Application Note Open this folder to get audio resource. Figure 6: Select One or More Audio Resource l 8.2.1.4. Change the Order of Audio Resource te Click 'OK' button on the figure above. The tool will be back to the main interface. The audio resources are c l listed in the box. The audio resource has ranged automatically in an order in this list. The order of audio ue tia resource can be changed by clicking '↑' or '↓' button on the right side of tool. Refer to the figure below. Q fiden Change the order of resource with these Con buttons if needed. Figure 7: Change the Order of Resource 8.2.1.5. Generate the Bin and Scatter file When the order of audio resource is fixed, it begins to generate the audio bin and scatter file. Just click the 'Generate' button on the figure above and the result of generating will be showed in a prompting frame. Refer to the figure below. GSM_Audio_Player_Application_Note Confidential / Released 27 / 30 GSM Module Series GSM Audio Player Application Note Figure 8: Prompt of Generating The prompting frame shows the path of file which has generated successfully. It is going to have two files to be generated: audio_res.bin which is the bin file used to be played and audioSequence.txt which just shows the order of audio resource packed into bin file. After the step of generating, audio bin file has been generated. The bin file is saved in the default folder at the same directory of GenBinFile tool. Refer to the figure below. tel 1. Audio bin and scat file are generated in 'audio bin' folder. c l 2. The text file of audioSequence is generated in the same directory of ue tia GenBinFile tool. Figure 9: Generate the Audio Bin and Sequence File Q en Next, it is just needed to download it to the module and play. fid 8.2.2. Download Audio Bin File to Module 1. Connect the module and PC. n 2. Open the tool of Firmware_Upgrade_Tool_Lite_GS2_V1.2.Configure the tool. Refer to the figure Co below. GSM_Audio_Player_Application_Note Confidential / Released 28 / 30 GSM Module Series GSM Audio Player Application Note l Figure 10: Configure the Firmware te 3. Select the port which is used to connect with module and select 460800 for the Baud Rate. c l 4. Click 'Set Scat' button on the figure above to select the scat file to load the bin file. Scat file is in the CQounefidentia same path of bin file. Refer to the figure below. Figure 11: Select the Scat File GSM_Audio_Player_Application_Note Confidential / Released 29 / 30 GSM Module Series GSM Audio Player Application Note 5. After confirming the scat and audio bin file correctly, click 'start' button and power on the module. The firmware will show the progress bar as the figure below. tel Figure 12: Start to Download CQouneficdential 6. If it is successful to accomplish the downloading, the firmware will prompt as the figure below. Figure 13: Finish Downloading The figure above shows that it is successful to accomplish the downloading of audio bin file. And then, close the Firmware tool and reboot module. It is able to play audio with AT commands now. GSM_Audio_Player_Application_Note Confidential / Released 30 / 30

GSM DTMF Application Note GSM/GPRS Module Series Rev. GSM_DTMF_Application_Note_V1.2 Date: 2015-04-08 www.quectel.com GSM Module Series GSM DTMF Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_DTMF_Application_Note Confidential / Released 1 / 20 GSM Module Series GSM DTMF Application Note About the Document History Revision 1.0 1.1 1.2 Date 2010-04-29 Author Roy CHEN l 2011-12-21 Roy CHEN CQouneficdteential 2015-04-08 RoyCHEN Description Initial 1. Modified AT commands description 2. Added AT+QULDLSPH command in Chapter 2.4 Added applicable modules GSM_DTMF_Application_Note Confidential / Released 2 / 20 GSM Module Series GSM DTMF Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 2 Generate and Transmit DTMF............................................................................................................. 7 2.1. Send DTMF Directly with AT+VTS .......................................................................................... 7 2.2. External DTMF Generator to Microphone ............................................................................... 8 3 4 5 6 2.3. Generate and Send DTMF with AT+QLDTMF ........................................................................ 9 2.4. Send DTMF Directly with AT+QWDTMF ............................................................................... 10 Decode DTMF ..................................................................................................................................... 13 3.1. Speaker to External DTMF Decoder ..................................................................................... 13 l 3.2. Embed DTMF Decoding with AT+QTONEDET..................................................................... 14 te Audio DTMF AT Commands ............................................................................................................. 15 4.1. AT+QWDTMF Send DTMF Tones to Remote Peer ........................................................... 15 c l 4.2. AT+QTDMOD Set DTMF Detection Mode ......................................................................... 16 ue tia 4.3. AT+QTONEDET Enable DTMF Decoding and Set Threshold...........................................17 Appendix A DTMF Tones Definition................................................................................................. 19 CQonfiden Appendix B Reference.......................................................................................................................20 GSM_DTMF_Application_Note Confidential / Released 3 / 20 GSM Module Series GSM DTMF Application Note Table Index TABLE 1: AT+VTS COMMANDS DESCRIPTION ............................................................................................... 7 TABLE 2: AT+QLDTMF/AT+QTONEP COMMAND DESCRIPTION ................................................................... 9 TABLE 3: AT+QWDTMF COMMANDS DESCRIPTION.....................................................................................11 TABLE 4: PERFORMANCE COMPARISON ..................................................................................................... 12 TABLE 5: AT+QTONEDET COMMANDS DESCRIPTION ................................................................................ 14 TABLE 6: DTMF TONES DEFINITION.............................................................................................................. 19 TABLE 7: RELATED DOCUMENTS .................................................................................................................. 20 TABLE 8: TERMS AND ABBREVIATIONS ........................................................................................................ 20 CQouneficdteenl tial GSM_DTMF_Application_Note Confidential / Released 4 / 20 GSM Module Series GSM DTMF Application Note Figure Index FIGURE 1: RECOMMENDED CIRCUIT FOR EXTERNAL DTMF GENERATOR .............................................. 8 FIGURE 2: RECOMMENDED PERIPHERAL CIRCUIT...................................................................................... 9 FIGURE 3: RECOMMENDED CIRCUIT FOR EXTERNAL DTMF DECODER................................................. 13 CQouneficdteenl tial GSM_DTMF_Application_Note Confidential / Released 5 / 20 GSM Module Series GSM DTMF Application Note 1 Introduction The DTMF tones and sine tone special frequency are used widely in the applications of security monitor, wireless communication, vehicle remote control, etc. It is an economical solution to embed the encoding/decoding DTMF and sine tone special frequency in GSM/GPRS module. This document gives a detailed description on the circuit diagram, parameters configuration, and AT commands of Quectel GSM/GPRS modules in DTMF application. The document provides various modes of receiving and transmitting DTMF. Customers can select a suitable scheme according to their product l features. CQouneficdteential This document is applicable to all Quectel GSM modules. GSM_DTMF_Application_Note Confidential / Released 6 / 20 GSM Module Series GSM DTMF Application Note 2 Generate and Transmit DTMF Quectel module offers 4 ways to send DTMF tones to remote peer. DTMF tones can be transmitted after a voice call is established. It is recommended not to operate DTMF transmitting and voice-talking at the same time since the quality of DTMF signal tones will be influenced by the voice. Customers should mute microphone during sending DTMF tones or talk when DTMF tones are not being sent. Several DTMF tones transmit modes are described in the following chapters. tel 2.1. Send DTMF Directly with AT+VTS c l When DTMF messages are sent to GSM network using AT+VTS, the network will generate DTMF tone to ue tia remote peer. The speed of DTMF messages exchanging and handling varies a lot depending on different network configuration and capability, which severely affects the duration of DTMF tone. Therefore, it’s very difficult to precisely control the duration of DTMF tone in this mode. Q n Under the GSM network of China Mobile in Shanghai, we tested that the minimum period of DTMF tones e was about 170ms and the mute period was about 200ms. fid Table 1: AT+VTS Commands Description n AT+VTS= '' Co String type. DTMF characters (single ASCII chars in the set 0-9, #,*,A-D) separated by commas. Recommendation for AT+VTS parameters configuration is below: AT+QSFR=7 //Available for calling. AT+VTS= '1,2,3,4,5,6,7,8,9,0,A,B,C,D,*,#' //Set priority for Enhanced Full Rate encoding. //Send DTMF（Under the network of China Mobile Shanghai, each 50ms/50ms*） GSM_DTMF_Application_Note Confidential / Released 7 / 20 GSM Module Series GSM DTMF Application Note NOTE ‘50ms/50ms’ means the duration of DTMF tone is 50ms and the duration of mute is 50ms.The format appeared in the following chapters has the same meaning just as the example mentioned above. 2.2. External DTMF Generator to Microphone An external DTMF generator is widely adopted in many security monitor systems. DTMF generator 10uF tel AC Signal pk-pk: 1V 2.2k c l 10uF Quectel module MIC1P MIC1N ue tia Figure 1: Recommended Circuit for External DTMF Generator Q n Although precise DTMF tones and mute duration can be controlled in this configuration, a certain level of e distortion which is carried by audio noise; echo or network transmission also needs to be solved. The fid recommend parameters are shown as below. Recommendation for parameters configuration is below: n AT+QAUDCH=0 AT+QSIDET=0 o AT+QSFR=7 C AT+QMIC=0,0 //Select MIC1P as talk channel for sending DTMF. //Close side tone. //Set priority for Enhanced Full Rate encoding. //Reduce MIC1 analog gain. AT+CAGC=0,0 //Disable analog Auto Gain Control. //Available for calling, send DTMF. GSM_DTMF_Application_Note Confidential / Released 8 / 20 GSM Module Series GSM DTMF Application Note 2.3. Generate and Send DTMF with AT+QLDTMF DTMF tones are generated by using AT+QLDTMF, and then are sent from speaker channel (SPK1 or SPK2) to MIC channel (MIC1 or MIC2). An external circuit is required to loop back the tones into microphone. The recommended peripheral circuit is below. uectel tial Figure 2: Recommended Peripheral Circuit Q n It is recommended that DTMF tones are sent from SPK2P to MIC1P since loop-back from SPK1 to MIC1 or from SPK2 to MIC2 will cause echo noise. As shown in Figure 2, voice call and DTMF tones are e transmitted in the different physical channels, using AT+QAUDCH can switch the particular voice channel fid to satisfying different occasion, and AT+QTONEP for DTMF generates path. Table 2: AT+QLDTMF/AT+QTONEP Command Description on AT+QLDTMF=,'< dtmf-string>', [] CA numeric parameter (1-1000) indicates the duration of all DTMF tones in <DTMF -string>. The unit is 1/100 second when is set to 1; or 1/10 second when is not set. A string parameter has a maximum length of 20 DTMF characters. (Single ASCII chars 0-9, #,*, A-D separated by commas.) AT+QTONEP= Set DTMF output path 0 Output DTMF from Normal speaker 1 Output DTMF from Headset speaker 2 Output DTMF from Loud speaker GSM_DTMF_Application_Note Confidential / Released 9 / 20 GSM Module Series GSM DTMF Application Note 3 Auto (Output DTMF from default speak path, consult AT+QAUDCH.) Example AT+QLDTMF=5, '1,2,3,4,5,6,7,8,9,0',1 //DTMF tones 1,2,3…8,9,0. Play for 50ms, mute 50ms. AT+QLDTMF=5, '1,2,3,4,5,6,7,8,9,0' //DTMF tones 1,2,3…8,9,0. Play for 500ms, mute 500ms. NOTE The actual minimum period of playing DTMF tone is 44ms and the minimum period of mute is 76ms though it can be set to 50ms with AT command. Recommendation for parameters configuration is below: l AT+QAUDCH=0 AT+QTONEP=1 //Select MIC1P as talk channel for sending DTMF //Select SPK2P as DTMF generating channel cte l AT+QMIC=0,4 AT+CLVL=10 ue tia AT+QSIDET=0 AT+QSFR=7 AT+CAGC=0,0 //Set volume of MIC1 //Set volume of local DTMF tone //Close side tone //Set priority for Enhanced Full Rate encoding //Disable analog Auto Gain Control Q n //Available for calling. fide AT+QLDTMF=5, '1,2,3,4,5,6,7,8,9,0,A,B,C,D,*,#',1 //DTMF tones 1,2,3…B,C,D, play for 500ms, mute 500ms Con 2.4. Send DTMF Directly with AT+QWDTMF DTMF tones can be generated by AT+QWDTMF and directly coupled to voice uplink channel, which doesn’t need any additional circuits. In order to achieve high performance of DTMF tones sending, AT+QULDLSPH=0,0 is used to mute the MIC uplink voice during DTMF tone playing, so the peer terminal can just receive DTMF tone only. GSM_DTMF_Application_Note Confidential / Released 10 / 20 GSM Module Series GSM DTMF Application Note Table 3: AT+QWDTMF Commands Description AT+QWDTMF=,,',,[,,,[,...]]' Uplink channel of the volume, 0 is mute, 7 is the maximum. Downlink channel of the volume, 0 is mute, 7 is the maximum. Play DTMF tone strings 0-9,*,#, A-D, and sine tone E(1400Hz),F(2300Hz), G(1000Hz). DTMF tones duration, unit is ms. Mute duration, unit is ms. AT+QULDLSPH=(0-1),(0-1) l UPSPH cte l DLSPH 0: Peer terminal can just receive DTMF tone only during DTMF sending. 1: Peer terminal can receive DTMF tone and Voice during DTMF sending. 0: Local terminal can just receive DTMF tone only during DTMF sending. 1: Local terminal can receive DTMF tone and Voice during DTMF sending. ue tia NOTES Q n 1. The AT+QULDLSPH command is available for the version M10R06R07 and M20R05A04 and their later versions. e 2. The default value restores to 1,1 when module re-powers on. fid For more details, please contact with Quectel Technical support. n Example o AT+QWDTMF=7, 0, 'G, 30, 20, 123456789ABCD, 50, 50, E, 100, 50' C //First send 1000Hz sine tone for 30ms and mute 20ms, then send DTMF ‘1’ ‘2’ ‘ 3’… ‘A’‘B’‘C’‘D’ 50ms/50ms in order, and send 1400Hz sine tone for 100ms and mute 50ms. Recommendation for parameters configuration is below: AT+QAUDCH=0 AT+QSFR=7 AT+QULDLSPH=0,0 //Select MIC1 channel to send DTMF to remote peer. //Set priority for Enhanced Full Rate encoding. //Mute MIC voice uplink during DTMF playing. GSM_DTMF_Application_Note Confidential / Released 11 / 20 GSM Module Series GSM DTMF Application Note //Available for calling. AT+QWDTMF=7,0, 'G,30,20,123456789ABCD*#,50,50' //Send DTMF tone at 50ms/50ms. +QWDTMF: 5 AT+QWDTMF=7,0, 'E,100,100,F,100,50' //Receive a response of ‘+QWDTMF: 5’ means sending DTMF tones successfully. //Send 1400Hz for 100ms and mute 100ms; send 2300Hz for 100ms and mute 50ms. Table 4: Performance Comparison External Period of DTMF tone l Period of mute te Manufacture Cost c l Switch back to ue tia voicemode VTS 170ms~1.08s* 200ms~25.5s* Generator Depends on generator Depends on generator QLDTMF 44ms~10s 76ms~10s Low High Low Switch easily. Don’t talk while sending DTMF or don’t send DTMF while talking. Set back to the default parameters before talking. Set back to the default parameters before talking. QWDTMF 10ms~80ms 10ms~80ms Low Switch easily. Improve the DTMF performance by using AT command AT+QULDLSPH=0,0 Q en NOTE Confid This value is only for reference, actual value depends on network status. GSM_DTMF_Application_Note Confidential / Released 12 / 20 GSM Module Series GSM DTMF Application Note 3 Decode DTMF Two decoding methods are fully detailed in the following chapters. One is decoding DTMF with an external DTMF decoding chip. The other is decoding DTMF in the module, which is useful to reduce design cost. 3.1. Speaker to External DTMF Decoder Connecting a DTMF decoder to speaker interface is used in traditional DTMF decoding applications. l DTMF decoding chip will output interrupt signal and DTMF code after detecting a DTMF tones. Recommended periphery circuit is shown below. cte l Quectelmodule ue tia SPK1P Q en SPK1N DTMF decoder C1 IN+ C2 IN- fid Figure 3: Recommended Circuit for External DTMF Decoder on Recommendation for parameters configuration is below: C AT+QAUDCH=0 //Select SPK1 as talk channel for receiving DTMF. AT+QSFR=7 //Set priority for Enhanced Full Rate encoding. AT+CLVL=80 //Set speaker volume, 60~100. //Available for calling，receive DTMF and send to decoder. GSM_DTMF_Application_Note Confidential / Released 13 / 20 GSM Module Series GSM DTMF Application Note 3.2. Embed DTMF Decoding with AT+QTONEDET The module will detect DTMF automatically and output the corresponding ASCII code through UART port when AT+QTONEDET=1. Table 5: AT+QTONEDET Commands Description AT+QTONEDET= 0: close; 1: open NOTE The duration of DTMF tones is recommended to be set more than 60ms.Then the successful rate of l decoding will be above 99 percent. cte l Recommendation for parameters configuration is below: ue tia AT+QTONEDET=1 AT+QTONEDET=4,1,3,3,65536 AT+QSFR=7 //Enable DTMF detection //Reduce code detection sensitivity * //Set priority for Enhanced Full Rate encoding Q n //Established a call, receive DTMF tones from remote peer. e +QTONEDET: 49 fid +QTONEDET: 50 +QTONEDET: 69,100 +QTONEDET: 70,400 //Detected ‘1’ and reported its ASCII code //Detected’2’ and reported its ASCII code //Detected 1400Hz, duration is 100ms //Detected 2300Hz, duration is 400ms Con NOTES 1. In order to minimize losing rate or repeating rate of different periods of source tones, these parameters in AT+QTONEDET are specially used to adjust code detection sensitivity. 2. In security alarm system, most source tones always appear at 50ms/50ms, then these parameters in AT+QTONEDET should not be changed. Default values can satisfy this application. 3. In voice application, DTMF tones are generated by key pressing and the duration is always more than 100ms/100ms. Set AT+QTONEDET=4,1,3,3,65536 to reduce the ratio of code repeating. GSM_DTMF_Application_Note Confidential / Released 14 / 20 GSM Module Series GSM DTMF Application Note 4 Audio DTMF AT Commands 4.1. AT+QWDTMF Send DTMF Tones to Remote Peer AT+QWDTMF Send DTMF Tones to Remote Peer Test Command AT+QWDTMF=? Response +QWDTMF: (0-7),(0-7),(',,') tel Write Command c l AT+QWDTMF=,,(',,') OK Response If emulating fails in an ME error, return: +CME ERROR: If emulating succeeds in an ME: +QWDTMF: 5 OK e Parameter fid Con 0~7, uplink channel of the volume 0~7, downlink channel of the volume, recommend to set 0 The DTMF tone strings '0' DTMF 0 '1' DTMF 1 '2' DTMF 2 '3' DTMF 3 '4' DTMF 4 '5' DTMF 5 '6' DTMF 6 '7' DTMF 7 '8' DTMF 8 '9' DTMF 9 'A' DTMF A 'B' DTMF B GSM_DTMF_Application_Note Confidential / Released 15 / 20 GSM Module Series GSM DTMF Application Note 'C' DTMF C 'D' DTMF D '*' DTMF * '#' DTMF # 'E' Frequency of 1400Hz 'F' Frequency of 2300Hz 'G' Frequency of 1KHz Duration of each DTMF tone, unit is ms Mute time, units is ms Indicate status of sending DTMF If is not 5, it means DTMF sending unsuccessfully. Example Example 1: AT+QWDTMF=7,0, '0,50,50,A,55,50,E,100,50' //Send DTMF ‘0’ for 50ms and mute 50ms; send l DTMF ‘A’ for 55ms and mute 50ms; send 1400HZ for 100ms and mute 50ms. te Example 2: AT+QWDTMF=7, 0, 'G, 100, 50, 123456789ABCD, 50, 50, E, 100, 50' //Send 1400Hz for 100ms and c l mute 50ms; send ‘1’ ‘2’ ue tia ‘3’ …‘B’ ‘C’ ‘D’ for 50ms and mute 50ms in order; send 1400 Hz for 100ms and mute Q n50ms. fide 4.2. AT+QTDMOD Set DTMF Detection Mode AT+QTDMOD Set DTMF Detection Mode n Test Command Co AT+QTDMOD=? Response +QTDMOD: (1,2),(0,1) OK Read Command Response AT+QTDMOD? +QTDMOD: , Write Command AT+QTDMOD=, OK Response OK If emulating fails in an ME error, return: +CME ERROR: GSM_DTMF_Application_Note Confidential / Released 16 / 20 GSM Module Series GSM DTMF Application Note Parameter Operate function 1 Set detection range 2 Set detection mode Function status 0 When =1, detect all DTMF, including 1400 and 2300 handshake signal. When =2, detect DTMF tone by using normal arithmetic. 1 When =1, only detect 1400 and 2300 handshake signal by using optimal arithmetic. When =2, detect long continuous DTMF tone by using optimal arithmetic. Example AT+QTDMOD =1,0 l AT+QTDMOD =1,1 AT+QTDMOD =2,0 te AT+QTDMOD =2,1 //Detect all DTMF, including 1400 and 2300 handshake signal. //Only detect 1400 and 2300 handshake signal by using optimal detect. //Detect DTMF tones by using normal arithmetic. //Detect long continuous DTMF tones by using optimal arithmetic. uec tial 4.3. AT+QTONEDET Enable DTMF Decoding and Set Threshold Q n AT+QTONEDET Enable DTMF Decoding and Set Threshold Test Command e AT+QTONEDET=? Response +QTONEDET: (0,1) fid Write Command n AT+QTONEDET=[, ][,][,][,< Co highthreshold>] OK Response OK If emulating fails in an ME error, return: +CME ERROR: After successful DTMF tones are detected, Open will be reported: +QTONEDET: [,< persistencetime>] Parameter < mode> 0 Disable DTMF decoding 1 Enable DTMF decoding GSM_DTMF_Application_Note Confidential / Released 17 / 20 GSM Module Series GSM DTMF Application Note 2 Configure decoding threshold of 1400Hz or 2300Hz, of which duration is 100ms 3 Configure decoding threshold of 1400Hz or 2300Hz, of which duration is 400ms 4 Configure DTMF decoding threshold Operation value Prefix pause number Low threshold value High threshold value NOTES 1. Available for calling. 2. When in debug mode, report: +QTONEDTD:,,,,,, 3. When reports as follow: +QTONEDET: 50 Detected DTMF 2 l +QTONEDET: 69,100 Detected 100ms of 1400Hz +QTONEDET: 70,100 Detected 100ms of 2300Hz te +QTONEDET: 69,400 Detected 400ms of 1400Hz c l +QTONEDET: 70,400 Detected 400ms of 2300Hz CQounefidentia 4. ConsultAT+QTDMOD GSM_DTMF_Application_Note Confidential / Released 18 / 20 GSM Module Series GSM DTMF Application Note 5 Appendix A DTMF Tones Definition Quectel wireless module adopts the DTMF tones definition conforming to telephone system standard. Please refer to the table below for details: Table 6: DTMF Tones Definition Low（Hz） l 697 te 770 c l 852 CQounefidentia 941 High（Hz） 1209 1 4 7 * 1336 2 5 8 0 1477 3 6 9 # 1633 A B C D GSM_DTMF_Application_Note Confidential / Released 19 / 20 GSM Module Series GSM DTMF Application Note 6 Appendix B Reference Table 7: Related Documents SN Document Name Remark [1] Quectel_Mxx _ATC AT commands set [2] Quectel_GSM_AUDIO_UGD GSM Module Audio Design User Guide l Table 8: Terms and Abbreviations te Abbreviation c l DTMF ue tia EFR* FR* Description Dual Tone Multi Frequency Enhanced Full Rate Full Rate Q en NOTES fid 1. Full Rate or FR or GSM-FR or GSM 06.10 is the first digital speech coding standard used in the GSM digital mobile phone system. The bit rate of the codec is 13kbit/s, or 1.625 bits/audio sample (often padded out to 33 bytes/20ms or 13.2kbit/s). n 2. Enhanced Full Rate or EFR or GSM-EFR or GSM 06.60 is a speech coding standard that was o developed to improve the quality of GSM-Full Rate (FR) codec. Working at 12.2kbit/s, the EFR C provides wire-like quality in any noise free and background noise conditions. GSM_DTMF_Application_Note Confidential / Released 20 / 20

GSM eCall Application Note GSM Module Series Rev. GSM_eCall_Application_Note_V1.3 Date: 2015-04-07 www.quectel.com GSM Module Series GSM eCall Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx Or Email: Support@quectel.com tel GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO CHANGE WITHOUT PRIOR NOTICE. fide COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS n DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_eCall_Application_Note Confidential / Released 1 / 24 GSM Module Series GSM eCall Application Note About the Document History Revision 1.0 1.1 1.2 1.3 Date 2012-02-22 Author Laguna XU tel 2012-03-28 Thomas ZHANG uec tial 2013-01-29 CQonfiden 2015-04-07 Thomas ZHANG Thomas ZHANG Description Initial 1. Restructured the document. 2. Added eCall introduction and eCall test steps. 3. Added AT commands for PSAP simulation. 1. Modified format and names of AT commands and URC. 2. Modified the call flow. Added applicable modules GSM_eCall_Application_Note Confidential / Released 2 / 23 GSM Module Series GSM eCall Application Note Contents GSM Module Series..................................................................................................................................... 0 About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 2 eCall Overview...................................................................................................................................... 6 3 eCall Flows ........................................................................................................................................... 8 3.1. Push Mode .................................................................................................................................. 9 4 5 6 3.2. Pull Mode .................................................................................................................................. 10 3.3. Call Release .............................................................................................................................. 11 eCall Testing....................................................................................................................................... 12 l 4.1. Commands to be Used during the Test .................................................................................... 12 4.2. Test Steps.................................................................................................................................. 13 te eCall AT Commands Description ..................................................................................................... 15 c l 5.1. AT Command Syntax ................................................................................................................ 15 5.2. Description of AT Command ..................................................................................................... 15 ue tia 5.2.1. AT+QECCFG eCall Related Configuration .................................................................15 5.2.2. AT+QECMSD Set the Whole MSD Data..................................................................... 18 5.2.3. AT+QECALL Establish / Release eCall....................................................................... 18 Q n 5.2.4. AT+QECPUSH Push MSD Data to PSAP................................................................... 20 5.2.5. AT+QECPULL Transfer MSD in Pull mode, only for Simulating ................................. 20 e 5.3. Summary of URC ...................................................................................................................... 21 Confid Appendix A Reference....................................................................................................................... 22 GSM_eCall_Application_Note Confidential / Released 3 / 23 GSM Module Series GSM eCall Application Note Table Index TABLE 1: ECALL RELATED URC ..................................................................................................................... 21 TABLE 2: RELATED DOCUMENTS .................................................................................................................. 22 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 22 CQouneficdteenl tial GSM_eCall_Application_Note Confidential / Released 4 / 23 GSM Module Series GSM eCall Application Note 1 Introduction This document mainly introduces how to use the eCall function of Quectel standard module. The aim of this document is not to explain the mechanism of eCall service, which can be looked up in the standard specifications, but the usage of eCall function in Quectel modules. This document is applicable to Quectel M10, M26, M50 and M35 modules. CQouneficdteenl tial GSM_eCall_Application_Note Confidential / Released 5 / 23 GSM Module Series GSM eCall Application Note 2 eCall Overview eCall is defined as a manually or automatically initiated emergency call from a vehicle, supplemented with a minimum set of emergency related data (MSD), as defined under the EU Commission’s eSafety initiative. It can be depicted by the figure below. uectel tial Figure 1: eCall System Overview Q n The architecture of eCall system is described in Figure 2. In Quectel test system, the module has the e ability to act as IVS and also to simulate the PSAP. Thus, eCall testing can be easily performed by preparing two Quectel modules in the circumstance without access to a real PSAP. It will be described in fid the following chapters. Of course, if a real PSAP can be accessed, testing in the real environment is Con preferred. GSM_eCall_Application_Note Confidential / Released 6 / 23 GSM Module Series GSM eCall Application Note In-Vehicle System (IVS) position data MSD Iinformation Source IVS Data Modem Microphone & Speakers Speech Codec GPS Receiver Radio Modem Radio Modem (BTS) PLMN Speech TransCoding (TRAU) Mobile Switching Center (MSC) PSTN/GSTN PSAP Data Modem MSD Display Microphone & Speakers Public-Safety Answering Point (PSAP) CQouneficdteenl tial Figure2:eCallSystemArchitecture GSM_eCall_Application_Note Confidential / Released 7 / 23 GSM Module Series GSM eCall Application Note 3 eCall Flows After an emergency voice call has been (automatically or manually) established, the IVS modem receiver constantly monitors the incoming signal from the speech decoder output. When prompted by a request from the PSAP operator for MSD, the IVS connects the IVS data modem transmitter to the input of the speech coder and mutes any speech from the motorist for the duration of MSD transmission to prevent it from interfering with the eCall data transmission. Alternatively, it can be the IVS that may trigger the MSD transmission. In this case, the IVS asks the PSAP to request an MSD transmission. The first operation mode shall be referred to as the pull mode whereas the latter one is the push mode. Essentially, push mode is realized by a request from the IVS to the PSAP to pull the MSD. CQouneficdteenl tial The following figures show the detailed procedure of each mode. GSM_eCall_Application_Note Confidential / Released 8 / 23 GSM Module Series GSM eCall Application Note 3.1. Push Mode IVS PSAP/Simulator DTE Application AT+QECCFG=1,'DSPMOD',1 Link Layer Link Layer Application DTE Start T1 Stop T1 or handle timeout Start T2 Stop T2 or handle timeout AT+QECMSDDATA / AT+QECMSDCFG AT+QECALL= AT+QECPUSH Push-REQ SF+Initiation(PUSH) ... UL CTRL Sync SF+START SF+START l +QECSTART te +QECNACK c l +QECNACK Que ntia +QECLACK fide +QECHACK: DL Sync SF+START ... START Detected START-IND SF+MSDrv0 NACK-IND NACK MSDrv1 UL MSD Sync NACK-IND NACK ... MSDrvn LLACK-IND Stop Send HLACK-IND LLACK HLACK Data-IND +QECMSDIND: HLACK-REQ ConFigure 3: Push Flow Chart a. In push mode the PSAP Rx starts monitoring the incoming signal immediately after the call has been established. b. IVS Tx continues to send the push message (SF+INITIATION). In the PSAP side, if two correct sync preambles (CONTROL_SYNC) have been detected and a subsequent push message has been identified, PSAP thinks it detected the push message. c. Then PSAP triggers to START state, resets its Rx, and sends the SF+START message continuously until it detected synchronization frames (MSD_SYNC). IVS will detect the synchronization and lock the sync state after receiving two successful syncs, and the '+QECSTART' will be reported to UART. GSM_eCall_Application_Note Confidential / Released 9 / 23 GSM Module Series GSM eCall Application Note After detection of START message, fast modulation mode is chosen, and IVS triggers the MSD SEND state. d. Upon detection of the START message, the IVS starts the transmission of the first MSD message with incremental redundancy version rv0 which is preceded by a synchronization frame. e. The PSAP Rx will demodulate the MSD and send NACK if CRC check failed or send ACK if CRC check passed. The PSAP simulator of current version only sends HLACK but no LLACK. f. If the MSD of one revision is not received correctly, IVS will receive NACK, and send next redundancy revision of the same MSD until it receives LLACK or HLACK. g. If LLACK is received, '+QECLACK' will be reported; If HLACK is received, '+QECHACK: ' will be reported while represents the HLACK data. For the error handling flow, please refer to the 3GPP TS 26.267. The timeout mechanism in the flow chart above is not implemented in modem. It should be implemented by customers. l 3.2. Pull Mode te The pull mode is mostly same with push mode, but only the MSD send is triggered by PSAP. It can be CQouneficdential demonstrated in the figure below. GSM_eCall_Application_Note Confidential / Released 10 / 23 GSM Module Series GSM eCall Application Note IVS DTE Application AT+QECCFG=1,'DSPMOD',1 AT+QECMSDDATA / AT+QECMSDCFG AT+QECALL= Link Layer PSAP/Simulator Link Layer Application DTE Start T1 Stop T1 or handle timeout Start T2 Stop T2 or handle timeout PULL-REQ AT+QECPULL SF+START SF+START SF+START ... DL Sync +QECSTART l +QECNACK te +QECNACK uec tial +QECLACK Q n +QECHACK: START Detected START-IND SF+MSDrv0 NACK-IND NACK MSDrv1 UL MSD Sync NACK-IND NACK ... MSDrvn LLACK-IND Stop Send HLACK-IND LLACK HLACK Data-IND +QECMSDIND: HLACK-REQ Confide Figure 4: Pull Flow Chart 3.3. Call Release Use AT+QECALL=0 or ATH to release the call. AT+QECCFG=1,'DM',0 can be sent to turn off DSP monitoring mode. GSM_eCall_Application_Note Confidential / Released 11 / 23 GSM Module Series GSM eCall Application Note 4 eCall Testing 4.1. Commands to be Used during the Test AT commands maybe used in IVS side includes, AT+QECCFG AT+QECMSD AT+QECALL l AT+QECPUSH // Configure eCall function, such as DSP mode, dial number, etc. // Set the whole MSD data // Establish or release eCall // IVS pushes MSD to PSAP te URC reports include: c l +QECSTART ue tia +QECNACK +QECLACK Q en +QECHACK: // Detected synchronization frame and START message from PSAP, IVS starts to send MSD // IVS received NACK from PSAP // IVS received Link Layer ACK from PSAP. It means data from link layer transfers successfully. // IVS received High Layer ACK from PSAP, with the 4 bit value reported fid To support eCall test, we add several commands so that the module can simulate PSAP. AT commands maybe used in PASP simulator side includes, on AT+QECCFG C AT+QECPULL // Configure DSP mode to simulate PSAP // PSAP triggers MSD pull mode URC report includes, +QECMSDIND: // MSD is received in PSAP simulator side Please refer to Chapter 5 for the detailed information of these AT commands. GSM_eCall_Application_Note Confidential / Released 12 / 23 GSM Module Series GSM eCall Application Note 4.2. Test Steps 1. Prepare two Quectel modules, download the same eCall firmware to the two modules then reset them. 2. Insert SIM card and make sure the two modules have registered to the network and can dial or accept the call. 3. One module is used as IVS, the other simulates PSAP. We will call them M_IVS and M_PSAP in this document. 4. Set DSP monitoring mode and MSD data. On the M_IVS, execute AT commands: AT+QECCFG=1,'DM',1 // Turn on IVS mode, DSP starts monitoring eCall related signal // Set the MSD, hex bytes. This data is just an example. Max data length is 140 bytes, input as 280 l characters in hex string format. AT+QECMSD=c5e165df6a789b4aaaa46ee4a651820daaf625803735d9dfd5c7067927d821a43d4b64b te 74cd2116dc582aabc6f4e45cdf9cbe2f74eb1aaf69cb4ef86cde48f86e02147d6c49ea22587144bbfdaa8 ef92c04afeb0c4e93ba93453561e65acd5065bbe12abde11819d86434039cf4e619124d5f308240ab0ea c l 11635aef2edfc8bc39e77768d784b67f6f7cb603 ue tia On the M_PSAP, executeAT commands: AT+QECCFG=1,'DM',2 // Turn on PSAP simulation mode Q en 5. Establish eCall. fid On the M_IVS, execute AT commands: AT+QECCFG=1, 'DT',1,13888888888 n AT+QECALL=1,0,0 // Set test number of PSAP. Use the actual number of M_PSAP. // Establish the test eCall Co Now, M_PSAP should ring. Accept the call via ATA. 6. Test Pull mode. On the M_PSAP, execute AT commands: AT+QECPULL [Expected results] Regular noise should be heard on the two modules, and finally +QECMSDIND should be reported to the UART with the MSD data. The valid data received should be same as that set in M_IVS. GSM_eCall_Application_Note Confidential / Released 13 / 23 GSM Module Series GSM eCall Application Note For example: +QECMSDIND:C5E165DF6A789B4AAAA46EE4A651820DAAF625803735D9DFD5C7067927D821A4 3D4B64B74CD2116DC582AABC6F4E45CDF9CBE2F74EB1AAF69CB4EF86CDE48F86E02147D6C4 9EA22587144BBFDAA8EF92C04AFEB0C4E93BA93453561E65ACD5065BBE12ABDE11819D86434 039CF4E619124D5F308240AB0EA11635AEF2EDFC8BC39E77768D784B67F6F7CB603 On the M_IVS side, the following URC will be reported: +QECSTART +QECNACK +QECNACK +QECNACK +QECHACK: 5 The PSAP simulator (M_PSAP) will send back the first 4 bits of MSD as the High Layer ACK (HL-ACK) code. This is why '+QECHACK: 5' is reported. In real PSAP, what content is sent is defined by PSAP side. l Please refer to clause 6 of 3GPP TS 26.267 for the HL-ACK code definition. te The LLACK is not reported here, because the PSAP simulator did not send the LLACK actually, but only send the HLACK. A real PSAP should send the LLACK, and then module will detect and report the LLACK. c l The PSAP simulation function may be improved in the future. ue tia 7. TestPushmode. On M_IVS, execute commands: Q en AT+QECPUSH // Push MSD to PSAP fid [Expected Result] Same as the pull mode 8. End test. n Release call, turn off DSP monitoring MSD. Co AT+QECALL=0 //Release call or ATH //Release call On M_IVS, AT+QECCFG=1,'DM',0 // Turn off DSP monitoring MSD On M_PSAP AT+QECCFG=1,'DM',0 //Turn off PSAP simulating GSM_eCall_Application_Note Confidential / Released 14 / 23 GSM Module Series GSM eCall Application Note 5 eCall AT Commands Description 5.1. AT Command Syntax Test Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. Read Command Write Command l Execution Command AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the GSM engine uecte tial 5.2. Description of AT Command 5.2.1. AT+QECCFG eCall Related Configuration Q en AT+QECCFG eCall Related Configuration Test Command fid AT+QECCFG =? Write Command AT+QECCFG=, n [,,…] Response OK Response if is Write, OK o If is Read, C +QECCFG: OK Reference GSM_eCall_Application_Note Confidential / Released 15 / 23 GSM Module Series GSM eCall Application Note Parameter Operation mode 0 Read – query the configuration 1 Write – set the configuration Configuration type [Optional] 'DM' Set the DSP monitoring mode 'DT' Set the dial number type 'EM' Set the eCall mode Values of one configuration If == 'DM', 0 Turn off DSP monitoring mode; Close the IVS / PSAP mode. 1 Turn on IVS mode 2 Turn on PSAP simulation mode, only for testing If == 'DT', 0 Clear both test number and reconfiguration number. Use 112 l (emergency call) or FDN/SDN number (test / reconfiguration eCall) 1[,] is optional. If it’s given, dial the instead of FDN for te test eCall. If is omitted, it means to clear the user defined test number. c l 2[,] is optional. If is assigned, dial the instead ue tia of SDN for reconfiguration eCall. If is omitted, it means to clear the user defined reconfiguration number. If == 'EM', 0 SIM_ECALL_NONE. eCall is not allowed. Q n 1 SIM_ECALL_ONLY. Only emergency call is allowed e 2 SIM_ECALL_AND_NORMAL. Emergency call and normal call are allowed. 3 SIM_ECALL_TEST_DISABLED. In such mode, the mode is decided by fid reading service table in SIM card, but not by AT commands. n NOTES o 1. The logic of which number is used is described as below, If Test or Reconfigure eCall C If test_num/ recfg_num exists, then use them. else if SIM_ECALL_ONLY, then 1st FDN as test num, 2nd FDN as reconfiguration num else if SIM_ECALL_AND_NORMAL, then get from last 2 sdn. 1st as test num, 2nd as recfg num. endif endif else if manually or automatically initiated eCall, then get num from the first customized ecc num: 112 default! endif GSM_eCall_Application_Note Confidential / Released 16 / 23 GSM Module Series GSM eCall Application Note 2. The first step of eCall should be enabling the IVS / PSAP mode; otherwise, other commands may fail. 3. is only needed if is 1. 4. An optional proceeding ‘+' and numbers (0-9) are only allowed in and ; In write mode, if or is omitted, it means to clear the number. 5. In general, there is no need to change the eCall mode, which is configured via SIM card by default. Example AT+QECCFG=1,'DM',1 // Turn on the IVS mode, let the DSP monitor the eCall related signal in speech frames. OK AT+QECCFG=0,'DM' // Query the DSP mode +QECCFG: 1 OK AT+QECCFG=1,'DM',0 l OK AT+QECCFG=0,'DT' te +QECCFG: 1,12345678 c l +QECCFG: 2,+8612345678 // Turn off the IVS or PSAP simulation mode // Query the dial number type // If any number is set, it will be printed. ue tia OK AT+QECCFG=1,'DT',0 OK Q n AT+QECCFG=0,'DT',1 OK e AT+QECCFG=0,'DT',2 OK fid AT+QECCFG=1,'DT',2,+861234567 OK AT+QECCFG=0,'DT',2 n +QECCFG: +861234567 // Clear the test number and reconfiguration number // Query the test number setting // Empty, only OK printed. It means test number is not set. // Query the reconfiguration number setting // Set the reconfiguration number // Query the reconfiguration number // Number printed o OK C AT+QECCFG=1,'DT',2 // Without number. Clear the reconfiguration number. OK AT+QECCFG=0,'DT',2 // Query the reconfiguration number OK // Empty. It means reconfiguration number is not set. GSM_eCall_Application_Note Confidential / Released 17 / 23 5.2.2. AT+QECMSD Set the Whole MSD Data AT+QECMSD Set the Whole MSD Data Test Command AT+QECMSD=? Write Command AT+QECMSD= Response OK Response OK Reference GSM Module Series GSM eCall Application Note Parameter MSD data. Should be hex bytes written in string format, refer to examples below. l NOTES te 1. This command will fail if IVS mode is not enabled. c l 2. Do not include the MSD string in quotes. See examples below. 3. Max length of is 280 hex characters, which can represent 140 bytes of MSD data. ue tia 4. Spaces in are skipped; and characters out of the range ‘0’ ~ ‘f’ will be regarded as ‘0’. 5. The MSD data set in this command will not be saved to NV memory. Q n Example e // Set the 140 bytes of MSD fid AT+QECMSD=c5e165df6a789b4aaaa46ee4a651820daaf625803735d9dfd5c7067927d821a43d4b64b 74cd2116dc582aabc6f4e45cdf9cbe2f74eb1aaf69cb4ef86cde48f86e02147d6c49ea22587144bbfdaa8 ef92c04afeb0c4e93ba93453561e65acd5065bbe12abde11819d86434039cf4e619124d5f308240ab0ea n 11635aef2edfc8bc39e77768d784b67f6f7cb603 Co OK 5.2.3. AT+QECALL Establish / Release eCall AT+QECALL Establish / Release eCall Test Command AT+QECALL=? Response +QECALL: (list of supported s),(list of supported s),(list of s) OK GSM_eCall_Application_Note Confidential / Released 18 / 23 GSM Module Series GSM eCall Application Note Read Command AT+QECALL? Response +QECALL: [,,] Write Command AT+QECALL=[,,] Reference OK Response OK If error is related to ME functionality: +CME ERROR: Parameter l uecte tial Establish / release eCall 0 Release eCall 1 Establish eCall Activation type of eCall 0 Manually initialized eCall 1 Automatically initialized eCall eCall type 0 Test call 1 Emergency call 2 Reconfiguration call Q en NOTES fid 1. If no eCall exists, 'AT+QECALL?' will return '+QECALL: 0'. 2. If is 0, and will be ignored. 3. For manually and automatically initialized eCall ( is 1), the dial number is got from emergency call list. The first item, it is 112 by default. For test / reconfiguration eCall ( n is 0 or 2), if test reconfiguration number is set, it is preferred to be used. If test reconfiguration number o is not set or cancelled, the number will be got from the FDN or SDN. Refer to the notes of C AT+QECCFG. 4. For test and reconfiguration call, it will return ERROR if failed to get dial number or the eCall mode is incorrect. 5. This command is only used in IVS side. Example AT+QECALL=1,0 ,0 OK AT+QECALL? +QECALL: 1,0,0 // Establish a test eCall // Query eCall state GSM_eCall_Application_Note Confidential / Released 19 / 23 GSM Module Series GSM eCall Application Note OK AT+QECALL=1,0,2 OK AT+QECALL=1,0,1 OK AT+QECALL=1,1,1 OK AT+QECALL=0 OK AT+QECALL? +QECALL: 0 // Establish a reconfiguration eCall // Establish a manually initiated eCall // Establish an automatically initiated eCall // In IVS side, release the eCall session, like ATH. // Query eCall state OK 5.2.4. AT+QECPUSH Push MSD Data to PSAP tel AT+QECPUSH Push MSD Data to PSAP c l Test Command AT+QECPUSH =? ue tia ExecutionCommand AT+QECPUSH Response OK Response OK Q n Reference fide Example AT+QECPUSH OK // Transfer MSD in push mode Con 5.2.5. AT+QECPULL Transfer MSD in Pull mode, only for Simulating AT+QECPULL PSAP Pull MSD from IVS, only for Simulating Test Command AT+QECPULL=? Execution Command AT+QECPULL Response OK Response OK Reference GSM_eCall_Application_Note Confidential / Released 20 / 23 NOTE Only applied when PSAP simulating mode is turned on. Example AT+QECPULL OK // Transfer MSD in pull mode GSM Module Series GSM eCall Application Note 5.3. Summary of URC Table 1: eCall Related URC l Index URC display te 1 +QECSTART c l 2 +QECNACK ue tia 3 +QECLACK Q en 4 +QECHACK Confid 5 +QECMSDIND: Meaning Condition Detected synchronization frame and START message from PSAP, IVS starts to send MSD IVS received NACK from PSAP IVS received Link Layer ACK from PSAP, data from link layer transfers successfully. IVS received High Layer ACK from PSAP, with the 4 bit value reported. The MSD data is received by PSAP. Only sent when data from link layer transfers successfully. GSM_eCall_Application_Note Confidential / Released 21 / 23 GSM Module Series GSM eCall Application Note 6 Appendix A Reference Table 2: Related Documents SN Document name Remark [1] Mxx_ATC [2] 3GPP TS 26.267 l [3] 3GPP TS 22.101 te [4] 3GPP TS 26.268 c l [5] CEN EN 15722 Mxx AT commands set eCall Data Transfer; In-band modem solution; General description Service aspects; Service principles eCall Data Transfer; In-band modem solution; ANSI-C reference code Road transport and traffic telematics – eSafety – eCall minimum set of data Que ntia Table 3: Terms and Abbreviations e Abbreviation fid ME TA n MS Co ACK Description Mobile Equipment Terminal Adapter Mobile Station Acknowledgement HL-ACK High Layer ACK LL-ACK Link Layer ACK DTE Data Terminal Equipment IVS In-Vehicle System MSD Minimum Set of Data GSM_eCall_Application_Note Confidential / Released 22 / 23 PSAP URC NV Public Safety Answering Point Unsolicited Response Code Non-volatile GSM Module Series GSM eCall Application Note CQouneficdteenl tial GSM_eCall_Application_Note Confidential / Released 23 / 23

GSM Quectel Cellular Engine GSM FILE AT Commands Manual GSM_FILE _AT_Commands_Manual_V1.5 GSM FILE AT Commands Manual Document Title Version Date Status Document Control ID GSM FILE AT Commands Manual 1.5 2015-05-20 Released GSM_FILE_AT_Commands_Manual_V1.5 General Notes Quectel offers this information as a service to its customers, to support application and engineering efforts that use the products designed by Quectel. The information provided is based upon requirements specifically provided for customers of Quectel. Quectel has not undertaken any independent search for additional information, relevant to any information that may be in the customer’s possession. Furthermore, system validation of this product designed by Quectel within l a larger electronic system remains the responsibility of the customer or the customer’s system te integrator. All specifications supplied herein are subject to change. c l Copyright This document contains proprietary technical information of Quectel Co., Ltd. Copying this ue tia document, distribution to others, and communication of the contents thereof, are forbidden without permission. Offenders are liable to the payment of damages. All rights are reserved in the event of a patent grant or registration of a utility model or design. All specifications supplied herein are Q n subject to change without notice at any time. Confide Copyright © Quectel Wireless Solutions Co., Ltd. 2015. GSM_FILE_AT_Commands_Manual_V1.5 - 1 - GSM FILE AT Commands Manual Contents Contents ............................................................................................................................................2 0. Revision history ............................................................................................................................3 1. Introduction...................................................................................................................................4 1.1. Reference.............................................................................................................................4 1.2. Terms and abbreviations......................................................................................................4 2. AT Commands for File ..................................................................................................................5 2.1. Overview of AT commands for File ...................................................................................5 2.2. Detailed descriptions of commands ....................................................................................5 2.2.1. AT+QFLDS Get data storage size ...........................................................................5 2.2.2. AT+QFLST List files ...............................................................................................6 2.2.3. AT+QFUPL Upload file to storage ..........................................................................7 2.2.4. AT+QFDWL Download file from storage ...............................................................8 2.2.5. AT+QFDEL Delete file in storage ...........................................................................9 l 2.2.6. AT+QFMOV Move file .........................................................................................10 2.2.7. AT+QFOPEN Open file.........................................................................................10 te 2.2.8. AT+QFREAD Read file.........................................................................................12 c l 2.2.9. AT+QFWRITE Write file ......................................................................................12 2.2.10. AT+QFSEEK Seek file ..........................................................................................13 ue tia 2.2.11. AT+QFCLOSE Close file ......................................................................................13 2.2.12. AT+QFPOSITION Get offset of the file pointer ...................................................14 2.2.13. AT+QFFLUSH Force to write data remaining in the file buffer............................14 Q n 2.2.14. AT+QFTUCAT Truncate the specified file from the file pointer...........................14 3. Summary of error codes..............................................................................................................16 e 4. Reliable transmission ..................................................................................................................17 fid 4.1. Calculated checksum to check the file transfer .................................................................17 4.2. ACK mode is enabled to stabilize Uploading ...................................................................18 5. Examples.....................................................................................................................................19 5.1. File uploading and downloading .......................................................................................19 n 5.2. File moving .......................................................................................................................19 o 5.2.1. Move single file .....................................................................................................20 C5.2.2. Move all files of one storage..................................................................................20 5.3. Read/write file ...................................................................................................................21 GSM_FILE_AT_Commands_Manual_V1.5 - 2 - GSM FILE AT Commands Manual 0. Revision history Revision Date Author Description of change 1.0 2010-04-15 Jay XIN Initial 1.1 2010-06-10 Jay XIN Supported SD and RAM Joanna LI 1.2 2010-10-08 Jay XIN 1. Added the ACK mode when uploading files 2. Modified the meaning of parameter in AT+QFUPL command 1.3 1.4 1.5 2011-05-23 l 2011-12-26 cte l 2012-05-18 Gralik WANG Gralik WANG Bonnie ZHAO Added file AT command: QFOPEN, QFREAD,QFWRITE,QFSEEK, QFCLOSE,QFPOSITION,QFFLUSH, QFTUCAT Modified error code and deleted unnecessary space during the AT commands Modified mistakes in Section 5.1 Que ntia 2012-05-22 Confide 2015-05-20 Will SHAO Will SHAO 1. Modified AT command QFOPEN. 2. Added new error code. Added applicable modules GSM_FILE_AT_Commands_Manual_V1.5 - 3 - GSM FILE AT Commands Manual 1. Introduction This document is aimed in providing a detailed specification and a comprehensive listing as a reference for the AT command used for operating files in RAM, flash and SD card. This document is applicable to Quectel M10, M26, M35, M72-D, M50, GC65 and GC65-E modules. Note: M10 module supports to operate files in UFS and RAM, M26, M35, M72-D, GC65 and GC65-E modules only support to operate files in RAM. 1.1. Reference l Table 1: Reference te SN Document name c l [1] Mxx_ATC Remark The introduction of AT commands for Mxx ue tia 1.2. Terms and abbreviations Q n Table 2: Terms and abbreviations e Abbreviation fid UFS file RAM file Con SD file Description File saved in the directory of User File Storage in Module flash File saved in RAM File saved in Picture directory of SD card GSM_FILE_AT_Commands_Manual_V1.5 - 4 - GSM FILE AT Commands Manual 2. AT Commands for File Quectel Module provides AT commands which can operate files in RAM, flash and SD card. And the SD card only supports three file systems: FAT, FAT16 and FAT32. 2.1. Overview of AT commands for File Command Description AT+QFLDS Get storage data size AT+QFLST AT+QFUPL AT+QFDWL AT+QFDEL l AT+QFMOV AT+QFOPEN te AT+QFREAD c l AT+QFWRITE AT+QFSEEK ue tia AT+QFCLOSE AT+QFPOSITION Q n AT+QFFLUSH AT+QFTUCAT List files Upload file to storage Download file from storage Delete file in storage Move file Open file Read file Write file Seek file Close file Get offset of the file pointer Force to write data remaining in the file buffer Truncate the specified file from the file pointer fide 2.2. Detailed descriptions of commands n 2.2.1. AT+QFLDS Get data storage size Co AT+QFLDS Get data storage size Test Command Response AT+QFLDS=? OK Write Command Response AT+QFLDS=<namepattern +QFLDS: ,[,] > OK Parameter Pattern 'UFS' UFS file in flash 'RAM' RAM file GSM_FILE_AT_Commands_Manual_V1.5 - 5 - GSM FILE AT Commands Manual Execution Command AT+QFLDS 'SD' SD file Free data size in Total data size in The maximum size which can be allocated, only valid for RAM file. Response +QFLDS: , OK Returns the UFS information Parameter The size in bytes of all files in UFS Reference The number of files in UFS l 2.2.2. AT+QFLST List files te AT+QFLST List files Test Command c l AT+QFLST=? ue tia WriteCommand AT+QFLST= Response OK Response +QFLST: ,[,] OK Parameter < namepattern > Pattern for filename '*' All UFS file in flash 'RAM:*' All RAM file 'SD:*' All SD file 'filename' Name of UFS file 'RAM:filename' Name of RAM file 'SD:filename' Name of SD file Name of the file Size in bytes of the file Memory size allocated for the file in RAM, only valid for RAM file Execution Command Response AT+QFLST +QFLST: , [+QFLST: , […]] OK GSM_FILE_AT_Commands_Manual_V1.5 - 6 - GSM FILE AT Commands Manual Reference List files in the UFS directory Parameter Name of the file Size in bytes of the file Note: Only list files in the 'Picture' directory of SD card, do not list any directory and any file in the other directories. 2.2.3. AT+QFUPL Upload file to storage AT+QFUPL Upload file to storage Test Command AT+QFUPL=? Response +QFUPL: 'file name', ,(1-65535),(0,1) tel Write Command AT+QFUPL=[, Que ntia [,[,]]] OK Parameter See Write Command. Response CONNECT TA switches to data mode, and the bin data of file can be inputted. When the total size of the input data reaches (unit: byte) or TA receives '+++' sequence from UART, TA returns to command mode and replies the following codes. +QFUPL: , e OK fid Parameter The name of the file to be stored. The maximum size of the file to be uploaded. n Default is 10240. Unit: byte o The size of the actually uploaded data. Unit: byte C The time in seconds to wait for data input from UART. Default is 5. Whether to use acknowledge mode or not 0 Turn off the ACT mode. It’s default. 1 Turn on the ACT mode The checksum of the uploaded data Reference Note:  It is strongly recommended to use DOS 8.3 file name format for .  GSM_FILE_AT_Commands_Manual_V1.5 - 7 - GSM FILE AT Commands Manual 'filename' File is uploaded to the UFS directory 'RAM:filename' File is uploaded to RAM 'SD:filename' File is uploaded to Picture directory in SD card  is 16 bit checksum based on bitwise XOR.  '+++' sequence will cause TA to end the command and switch to command mode; however, data previously entered are still being preserved as the data of the file.  To execute the command, must appear 'CONNECT' before entering the binary data.  The ACT mode is provided to avoid loss of data when uploading large files in case hardware flow control is not available. The ACT mode works as follows: 1) Run command AT+QFUPL = 'file name', filesize, 5,1 to enable the ACK mode; l 2) The module outputs 'CONNECT'; 3) MCU sends 1Kbytes data, and then the module will te respond with a 'A'; 4) MCU receives the ‘A’ and then sends the next c l 1Kbytes data ue tia 5) Repeat step 3) and 4) until the transfer is completed. Q n 2.2.4. AT+QFDWL Download file from storage e AT+QFDWL Download file from storage fid Test Command Response AT+QFDWL=? +QFDWL: 'file name' Con Write Command OK Parameter See Write Command. Response AT+QFDWL= CONNECT TA switches to data mode, and the bin data of the file will be outputted. When the file was read over, TA returns to command mode and replies the following codes: +QFDWL: , OK Parameter The name of the file to be downloaded GSM_FILE_AT_Commands_Manual_V1.5 - 8 - GSM FILE AT Commands Manual The size of the downloaded data The checksum of the downloaded data Reference Note:  'filename' File is uploaded to the UFS directory 'RAM:filename' File is uploaded to RAM (only M33 supports) 'SD:filename' File is uploaded to Picture directory in SD card  '+++' sequence will cause TA to end the command and switch to command mode.  is 16 bit checksum based on bitwise XOR. 2.2.5. AT+QFDEL Delete file in storage l AT+QFDEL Delete file in storage te Test Command Response AT+QFDEL=? +QFDEL: 'file name' Quec ntial WriteCommand Confide AT+QFDEL= OK Parameter See Write Command. Response OK Parameter The name of the file to be deleted '*' Delete all files in UFS directory ( DO not delete the directory) 'RAM:*' Delete all files in RAM 'SD:*' Delete all files in Picture directory of SD card 'filename' Delete the specified file 'filename' in UFS directory 'RAM:filename' Delete the specified file 'filename' in RAM 'SD:filename' Delete the specified file 'filename' in Picture directory of SD card Note: Only delete files in the Picture directory of SD card, do not delete any directory or any file in the other directories. GSM_FILE_AT_Commands_Manual_V1.5 - 9 - GSM FILE AT Commands Manual 2.2.6. AT+QFMOV Move file AT+QFMOV Move file Test Command AT+QFMOV=? Response +QFMOV: 'src filename','dest filename',(0,1),(0,1) OK Parameter See Write Command. Write Command Response AT+QFMOV=,,, Quneficdteenl tial Reference Source file Destination file Whether or not to delete source file after the file is copied 0 Delete source file after file is copied 1 Do not delete source file after file is copied Whether or not to overwrite existed destination file 0 Do not overwrite the destination file if it exists 1 Overwrite the destination file if it exists Note:  This command is supported only in M33.  Cannot move file from UFS or SD card to RAM.  AT+QFMOV='RAM:*','SD:*',1,1 Move all files in RAM to SD card  AT+QFMOV='RAM:filenamea','SD:filenameb',1, 1 Move the file named 'filenamea' in RAM to SD card, and rename it as 'filenameb'. Co 2.2.7. AT+QFOPEN Open file AT+QFOPEN Open file Test Command AT+QFOPEN=? Response +QFOPEN: 'filename'[,(0-2) [,]] Read Command OK Parameter See Write Command. Response GSM_FILE_AT_Commands_Manual_V1.5 - 10 - GSM FILE AT Commands Manual AT+QFOPEN? +QFOPEN: 'filename',, [+QFOPEN: 'filename',, […]] OK Parameter See Write Command. Write Command Response AT+QFOPEN=[, +QFOPEN: [,length]] OK CQouneficdteenl tial Reference Parameter The file needed to be operated The mode of the file opened, default is 0 0 (Default) If the file doesn’t exist, it will be created; if the file exists, it will be opened. And both of them can be read and written 1 If the file exists, it will be created and clear the old file 2 If the file exists, open it and it only can be read. The max length of the file. Default is 10240. Unit: byte. It is only used for RAM file.Ignore this parameter if you use UFS or SD file. Note:  Can open file from UFS、RAM or SD card  AT+QFOPEN='filenameb', 0 Open the file named 'filenameb' in the UFS  AT+QFOPEN='SD:filenameb',0 Open the file named 'filenameb' in the Picture directory of SD card  AT+QFOPEN='RAM:filename',0,1024 Open the file named in RAM. If the file does not exist, then create it, and set the max length of the file with value 1024. If the file exists in RAM, just open it, and ignore the length 1024.  AT+QFOPEN='RAM:filename',1,10240 Create the file named in RAM. If the file already exists, first delete it, then create it, and set the max length of the file with value 10240. GSM_FILE_AT_Commands_Manual_V1.5 - 11 - GSM FILE AT Commands Manual 2.2.8. AT+QFREAD Read file AT+QFREAD Read file Test Command AT+QFREAD=? Response +QFREAD: [,] OK Parameter See Write Command. Write Command Response AT+QFREAD=[ CONNECT < read length > , ] TA switches to data mode. When the total size of the read uectel tial Reference data reaches (unit: byte), TA returns to command mode and then replies the following codes. OK Parameter The handle of the file needed to be operated The length of the file to be read out, the default is the size of the file. The actual length to be read out Q n 2.2.9. AT+QFWRITE Write file e AT+QFWRITE Write file Test Command fid AT+QFWRITE=? Response +QFWRITE: [,[,]] Con Write Command OK Parameter See Write Command. Response AT+QFWRITE= [,[,]] TA switches to data mode. When the total size of the written data reaches (unit: byte) or it is timeout, TA returns to command mode and replies the following codes. +QFWRITE: , OK Parameter GSM_FILE_AT_Commands_Manual_V1.5 The handle of the file needed to be operated - 12 - GSM FILE AT Commands Manual Reference The length of the file needed to be written, the default length is 10K The time in seconds to wait for data input from UART. Default is 5. The actual length to be written The total length of the file 2.2.10. AT+QFSEEK Seek file AT+QFSEEK Seek file Test Command AT+QFSEEK=? Response +QFSEEK: ,[,] tel Write Command AT+QFSEEK=, c l [,] Que entia Reference OK Parameter See Write Command. Response OK Parameter The handle of the file needed to be operated Number of bytes to move the file pointer Pointer movement mode. The default is 0 0 File begin 1 Current position of the pointer 2 File end fid 2.2.11. AT+QFCLOSE Close file n AT+QFCLOSE Close file o Test Command C AT+QFCLOSE=? Response +QFCLOSE: Write Command AT+QFCLOSE= Reference OK Parameter See Write Command. Response OK Parameter The handle of the file needed to be operated GSM_FILE_AT_Commands_Manual_V1.5 - 13 - GSM FILE AT Commands Manual 2.2.12. AT+QFPOSITION Get offset of the file pointer AT+QFPOSITION Get offset of the file pointer Test Command Response AT+QFPOSITION=? +QFPOSITION: OK Parameter See Write Command. Write Command Response AT+QFPOSITION= +QFPOSITION: l Reference OK Parameter The handle of the file needed to be operated The offset from the beginning of the file to the current position cte l 2.2.13. AT+QFFLUSH Force to write data remaining in the file buffer ue tia AT+QFFLUSH Force to write data remaining in the file buffer Test Command Response Q n AT+QFFLUSH=? +QFFLUSH: fide Write Command AT+QFFLUSH= Co Reference OK Parameter See Write Command. Response OK Parameter The handle of the file needed to be operated 2.2.14. AT+QFTUCAT Truncate the specified file from the file pointer AT+QFTUCAT Truncate the specified file from the file pointer Test Command Response AT+QFTUCAT=? +QFTUCAT: OK Parameter GSM_FILE_AT_Commands_Manual_V1.5 - 14 - GSM FILE AT Commands Manual Write Command AT+QFTUCAT= Reference See Write Command. Response OK Parameter The handle of the file needed to be operated CQouneficdteenl tial GSM_FILE_AT_Commands_Manual_V1.5 - 15 - GSM FILE AT Commands Manual 3. Summary of error codes Final result code +CME ERROR: indicates an error related to mobile equipment or network. The operation is similar to ERROR result code. Neither ERROR nor OK result code shall be returned. The listed codes here are just related with File. About other codes, please refer to document [1]. Code of Meaning 3765 Invalid input value 3915 Non-existent address 3916 UFS storage full 3917 3918 3919 3920 3921 3922 3923 3924 3925 4000 4001 4002 4003 4004 4005 4006 4007 4008 4009 4010 4011 Drive full Drive error File not found l Invalid file name File already existed te Failed to create file Failed to write file c l Failed to open file ue tia Failedtoreadfile Exceed max length Open file fail Q n Write file fail Get size fail e Read fail fid List file fail Delete file fail Get Disk info fail nNo space Time out o File not found C File too large 4012 File already exist 4013 Invalid parameter 4014 Driver error 4015 Create fail 4016 Access denied GSM_FILE_AT_Commands_Manual_V1.5 - 16 - GSM FILE AT Commands Manual 4. Reliable transmission 4.1. Calculated checksum to check the file transfer For reliable transmission ， when using 'AT+QFUPL' and 'AT+QFDWL' to upload and download file, it is recommended that users turn on hardware flow control capabilities, while also open MCU hardware flow control function. Open the hardware flow control function for the module via the AT+IFC=2,2 command, which is enabled by default. As general serial transmission is reliable, in order to further reliability, we offer additional ways to verify the data transmission reliability by the command’s response information. When using 'AT+QFUPL= [,]' command to upload a file, the module will report '+QFUPL: , ' information tips at the end of data transmission. l Then MCU can judge whether the data has lost by comparing value of with . te is the data length which the module received. MCU compares the c l with the actual length of the file. If unequal, it means the module lost data. ue tia is calculated by doing XOR for every 2 bytes. Similarly MCU calculates the actual file’s checksum as below example, and then compares this value with which module reports. If not equal, the received data may be problematic. User can re-upload the data. Q en Example for calculating checksum: If the uploaded file data length is 9, the 16 hex values are as follows: fid 0x23 0x13 0x65 0x B6 0x76 0x88 0xA3 0xEF 0x55 So, checksum is calculated as follows: n checksum = 0x2313 XOR 0x65B6 XOR 0x7688 XOR 0xA3EF XOR 0x5500 o Every two data form a group and do XOR with another group. If the last group is less than 2 bytes, C supplement with 0x00. Similarly, the module will report the '+QFDWL: ,' information when command 'AT+QFDWL=' is completed. is the actual size of downloaded data, MCU can calculate received data length, and compare it with . If not equal, the data is lost. MCU also can do checksum calculation and comparison with . If not equal, it is needed to re-download the file. GSM_FILE_AT_Commands_Manual_V1.5 - 17 - GSM FILE AT Commands Manual 4.2. ACK mode is enabled to stabilize Uploading When it is needed to use the AT + QFUPL command to upload large files, and UART hardware flow control is turned off, it is recommended to use the ACK Mode. The ACT mode works as follows: 1) Run command AT+QFUPL = 'file name', filesize, 5,1 to enable the ACK mode; 2) The module outputs 'CONNECT'; 3) MCU sends 1Kbytes data, and then the module will respond with an 'A'; 4) MCU receives the ‘A’ and then sends the next 1Kbytes data; 5) Repeat step 3) and 4) until the transfer is completed. For example: AT+QFUPL='test.txt',3000 CONNECT l A cte l A ue tia +QFUPL: 3000,B34A CQonfiden OK // Upload the text file 'test.txt' to UFS // After receiving 1024bytes data, the module will respond with an 'A', then next 1024 bytes data can be input GSM_FILE_AT_Commands_Manual_V1.5 - 18 - GSM FILE AT Commands Manual 5. Examples 5.1. File uploading and downloading AT+QFUPL='test.txt',3222 CONNECT +QFUPL: 3222,B3E4 // Upload the text file 'test.txt' to UFS OK AT+QFDWL='test.txt' CONNECT l +QFDWL: 3222,B3E4 te OK c l AT+QFUPL='RAM:test2.txt',4222 ue tia CONNECT +QFUPL: 4222,13E4 Q n OK e AT+QFDWL='SD:pic1.jpg',13222 fid CONNECT n +QFDWL: 13222,D5E4 Co OK // Download the file 'test.txt' from UFS // Upload the text file 'test2.txt' to RAM // Download the picture file 'pic1.jpg' from SD card 5.2. File moving User can move file(s) among RAM, UFS and SD card by command 'AT+QFMOV'. Please note that the file cannot be moved from UFS or SD card to RAM. Here list examples of moving single file and all files. GSM_FILE_AT_Commands_Manual_V1.5 - 19 - GSM FILE AT Commands Manual 5.2.1. Move single file AT+QFLST='RAM:*' //RAM has file 'Pic.jpg' +QFLST: 'RAM:Pic.jpg',63388,75000 OK AT+QFLST='*' +QFLST: 'pic.jpg',62076 // UFS also has one file 'pic.jpg', but the file size is different OK AT+QFMOV='RAM:pic.jpg','pic.jpg',1,0 +CME ERROR: 3921 // Move file 'pic.jpg' from RAM to UFS. '1' means NOT deleting source file after file is copied, '0' means Do not overwrite the destination file if it exists. Because the destination file has existed, l so it responds ERROR 3921 (File already existed). The file is not moved. If user confirms the file can be te overwritten, set the last parameter as '1' as below. AT+QFMOV='RAM:pic.jpg','pic.jpg',1,1 //Move file successfully. The source file c l 'pic.jpg' in RAM is not deleted. The ue tia destination file 'pic.jpg' in UFS has been overwritten. OK Q n AT+QFLST='RAM:*' +QFLST: 'RAM:Pic.jpg',63388,75000 e OK fid AT+QFLST='*' +QFLST: 'pic.jpg',63388 n OK Co 5.2.2. Move all files of one storage AT+QFLST='RAM:*' +QFLST: 'RAM:pic0.jpg',59024,75000 +QFLST: 'RAM:pic1.jpg',62592,75000 +QFLST: 'RAM:pic2.jpg',57168,75000 +QFLST: 'RAM:pic3.jpg',63216,75000 GSM_FILE_AT_Commands_Manual_V1.5 - 20 - GSM FILE AT Commands Manual +QFLST: 'RAM:pic4.jpg',64600,75000 +QFLST: 'RAM:pic5.jpg',60284,75000 OK AT+QFLST='SD:*' OK AT+QFMOV='RAM:*','SD:*',0,0 OK // Move all files in RAM to SD, the first '0' means deleting source files after files are copied, the second '0' means Do not overwrite the destination file if it exists. SD has not these files, so the last AT+QFLST='RAM:*' OK AT+QFLST='SD:*' l +QFLST: 'SD:pic0.jpg',59024 te +QFLST: 'SD:pic1.jpg',62592 c l +QFLST: 'SD:pic2.jpg',57168 ue tia +QFLST: 'SD:pic3.jpg',63216 +QFLST: 'SD:pic4.jpg',64600 Q en +QFLST: 'SD:pic5.jpg',60284 fid OK parameter is meaningless in this case. // Source files are deleted. // All files in RAM have been moved to SD card. n 5.3. Read/write file o AT+QFOPEN='test.txt', 0 C +QFOPEN: 12451840 // Open file test.txt OK AT+QFWRITE=12451840, 10 CONNECT +QFWRITE: 10, 10 // Set write length // Input data OK GSM_FILE_AT_Commands_Manual_V1.5 - 21 - GSM FILE AT Commands Manual AT+QFSEEK=12451840, 0, 0 OK AT+QFREAD=12451840 CONNECT 10 OK // Seek to the origination of the file // Read the test.txt // The data of 10 bytes will be read out. CQouneficdteenl tial GSM_FILE_AT_Commands_Manual_V1.5 - 22 - Shanghai Quectel Wireless Solutions Co., Ltd. Room 501, Building 13, No.99, Tianzhou Road, Shanghai, China 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com

GSM Jamming Detection Application Note GSM/GPRS Module Series Rev. GSM_Jamming_Detection_Application_Note_V3.1 Date: 2015-04-08 www.quectel.com a GSM/GPRS Module Series GSM Jamming Detection Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_Jamming_Detection_Application_Note Confidential / Released 1 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note About the document History Revision 3.0 3.1 Date 2013-06-14 CQouneficdteenl tial 2015-04-08 Author Bob DENG Bob DENG Description Initial Added applicable modules GSM_Jamming_Detection_Application_Note Confidential / Released 2 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note Contents About the document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Figure Index ................................................................................................................................................. 4 1 Introduction .......................................................................................................................................... 5 2 Jamming Detection Overview............................................................................................................. 6 2.1. Application Overview ................................................................................................................... 6 2.1.1. Report Jamming Status via URC ..................................................................................... 7 2.1.2. Report Jamming Status via URC Periodically.................................................................. 7 3 4 5 2.1.3. Report Jamming Status via Pin Output ............................................................................ 7 2.2. Configure Optimized Detection Parameters ................................................................................ 8 AT Commands Description................................................................................................................. 9 3.1. AT+QJDCFG Jamming Detection Configuration ...................................................................... 9 l 3.2. AT+QJDR Jamming Detection Report .................................................................................... 10 te 3.3. URC Description ........................................................................................................................ 11 3.3.1. Disturbed Indicator ......................................................................................................... 11 c l 3.3.2. Jammer Removal Indicator ............................................................................................ 11 ue tia Example .............................................................................................................................................. 12 4.1. Report Jamming via URC .......................................................................................................... 12 4.2. Report Jamming via URC Periodically....................................................................................... 13 Q n 4.3. Report Jamming via Pin............................................................................................................. 13 4.4. Start and Stop Jamming Detection ............................................................................................ 14 e 4.5. Configure Jamming Detection ................................................................................................... 14 Confid Appendix A Reference....................................................................................................................... 16 GSM_Jamming_Detection_Application_Note Confidential / Released 3 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note Figure Index FIGURE 1: JAMMING APPLICATION DIAGRAM ............................................................................................... 6 FIGURE 2: OPTIMIZED DETECTION PARAMETER ......................................................................................... 8 CQouneficdteenl tial GSM_Jamming_Detection_Application_Note Confidential / Released 4 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 1 Introduction A Cellular Communication Jammer can totally paralyze all kinds of mobile and portable phones working in the GSM bands. Quectel standard modules offer jamming detection functionality allowing the unit to sense attempts to disrupt the GSM communication by interference with the GSM signal. Quectel module’s sophisticated jamming detection enables enhanced security features and immediate alarm notification if communication interference is detected. This document gives a detailed explanation on how to use the Jamming Detection function of Quectel standard modules. CQouneficdteenl tial This document is applicable to all Quectel GSM modules. GSM_Jamming_Detection_Application_Note Confidential / Released 5 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 2 Jamming Detection Overview Quectel’s Jamming Detection allows the user to identify active jamming of the GSM network. Many alarm, security and life critical operations rely on the use of GSM mobile communications. Criminals and those that intent on preventing time critical messages may use GSM Jammers to interfere with normal network operation. Quectel’s Jamming Detection can allow Quectel module to detect GSM jamming signals. When jamming is detected, Quectel module sends a notification to MCU, reporting the presence of active jamming of the GSM mobile communication network. CQouneficdteenl tial Figure1: JammingApplicationDiagram 2.1. Application Overview Quectel Jamming Detection supports to report the appearance and disappearance of jamming automatically via URC and/or set a hardware pin from low level to high level to notify the MCU. Also user can manually query the jamming status by the QJDR read command (see chapter 3.2). The following sections describe how to use these functionalities. GSM_Jamming_Detection_Application_Note Confidential / Released 6 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 2.1.1. Report Jamming Status via URC After Jamming Detection function is enabled by AT+QJDR=1,the Jamming Detection function can work well with the default settings .If jamming is detected, the module will report '+QJDR: JAMMED' through serial port. If jamming is removed, the module will report '+QJDR: NO JAMMING' through serial port. For detailed examples, please refer to chapter 4.1. 2.1.2. Report Jamming Status via URC Periodically There are two ways to report URC for indicating jamming status. One is reporting URC only once as described in section 2.1.1; the other is reporting URCs periodically as described in this section. Firstly, enable the Jamming Detection function of Quectel module by AT+QJDR=1, and then set the by AT+QJDCFG. If jamming is detected, the module will report a URC '+QJDR: JAMMED' through serial port every seconds. If jamming is removed, the module will report '+QJDR: NO JAMMING' l through serial port. For more examples, please refer to chapter 4.2. cte l 2.1.3. Report Jamming Status via Pin Output ue tia This feature supports that a pin is designed to indicate jamming by outputting different level. When jamming is detected, the PIN will output a HIGH level. In normal conditions (not jammed), the PIN will Q n output a LOW level. If the module detects a Jammer then it will set the hardware output pin from LOW to HIGH level. In this case, the jamming status can be got by the pin status. The parameter of e AT+QJDCFG command can be used to configure a pin of module as a jamming indication pin. For more Confid examples, please refer to chapter 4.3. GSM_Jamming_Detection_Application_Note Confidential / Released 7 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 2.2. Configure Optimized Detection Parameters Quectel Jamming Detection supports to optimize the detection conditions by configuring and parameters of AT+QJDCFG. To detect and report the jamming, the following two basic conditions are verified. One is checking whether RSSI (Received Signal Strength Indication, consistent with the value that AT+CSQ command returns) is greater than the threshold .The other is checking whether the count of disturbed channels is greater than the threshold .The following Figure 2 shows how jamming status is reported according to these two parameters and . The thresholds of and may be modified according to customer’s local network environment. For detailed example, please refer to chapter 4.5. Start l reset disturbed counter te switch channel uec tial measurerssi rssi >= ? Q en N Y N Y disturbed channel? disturbed counter ++ onfid N Call channels ? N counter >= ? Y Y Report jamming End Figure 2: Optimized Detection Parameter GSM_Jamming_Detection_Application_Note Confidential / Released 8 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 3 AT Commands Description Quectel Jamming Detection can be configured by AT+QJDCFG command and activated by AT+QJDR command. If a Cellular Communication Jammer is active in its range, the module can detect and give indication to the user either via URC or by setting a hardware output pin from low to high level. 3.1. AT+QJDCFG Jamming Detection Configuration This command allows module to configure the options of Jamming Detection feature. These options l include the Jamming Detection’s conditions, the Jamming notification methods, etc. Parameters will be te automatically saved into NVRAM after they are configured successfully. c l AT+QJDCFG Jamming Detection Configuration Test Command ue tia AT+QJDCFG=? Response +QJDCFG: ('URC','PERIOD','PIN','MNL','MINCH'),(value) Q n Read Command e AT+QJDCFG? onfid Jamming Detection will be configured to C report jamming status via URC through OK Response +QJDCFG: 'URC', 'PERIOD', 'PIN', 'MNL', 'MINCH', OK Response OK serial port ERROR AT+ QJDCFG='urc', Jamming Detection will be configured to Response report jamming status via URC periodically OK through serial port. ERROR AT+ QJDCFG= 'period', Jamming Detection will be configured to Response report jamming status via the PIN. OK AT+ QJDCFG='pin', ERROR GSM_Jamming_Detection_Application_Note Confidential / Released 9 / 16 a Maximum Received Signal Strength AT+ QJDCFG='mnl', Disturbed Channel Minimum Number. AT+ QJDCFG='minch', Reference GSM/GPRS Module Series GSM Jamming Detection Application Note Response OK ERROR Response OK ERROR Parameters Configure whether to report Jamming status via URC. l Quectential e 0 Disable status reporting via URC through serial port. 1 Enable status reporting via URC through serial port. Configure whether to report Jamming status via URC periodically. 0 Disable Jamming status reporting via URC periodically. 1-N Report Jamming status via URC every seconds. This is a string type parameter to configure which pin is used to report jamming status. '' Disable the function of jamming status reporting via a pin. 'RI' Module’s RI pin is dedicated to report jamming status; the other RI function will be disabled. 'DCD' Module’s DCD pin is dedicated to report jamming status; the other DCD functions will be disabled. Maximum Received Signal Strength. 0-17-31 Please refer to chapter 2.2. Disturbed Channel Minimum Number 0-5-254 Please refer to chapter 2.2. nfid 3.2. AT+QJDR Jamming Detection Report Co Jamming Detection can be activated by QJDR command. Parameters will be automatically saved into NVRAM after they are configured successfully. AT+QJDR Jamming Detection Report Test Command AT+QJDR=? Response +QJDR: (0,1) Read Command AT+QJDR? OK Response +QJDR: NO JAMMING or GSM_Jamming_Detection_Application_Note Confidential / Released 10 / 16 a Write Command AT+ QJDR= Reference GSM/GPRS Module Series GSM Jamming Detection Application Note +QJDR: JAMMED Response OK ERROR Parameters 0 Jamming Detection function is disabled (factory default is 0). 1 Jamming Detection function is enabled. About URC description, please refer to chapter 3.3. l 3.3. URC Description te 3.3.1. Disturbed Indicator uec tial If the module detects a Jammer, it will send the URC '+QJDR: JAMMED' to the serial port. Indication of Jammer Presence Q n +QJDR: JAMMED fide 3.3.2. Jammer Removal Indicator n If the Jammer was removed then it will send the message '+QJDR: NO JAMMING' to the serial port. o Indication of Jammer Removal C +QJDR: NO JAMMING GSM_Jamming_Detection_Application_Note Confidential / Released 11 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 4 Example 4.1. Report Jamming via URC AT+QJDR=1 OK // Enable Jamming Detection. In normal condition AT+QJDR? +QJDR: NO JAMMING l OK // Query the current jamming status. // In normal condition, no jamming is detected. te In a jamming environment, please refer to chapter 2.2. uec tial +QJDR:JAMMED // The URC will be reported automatically. Jamming has been detected. AT+QJDR? Q n +QJDR: JAMMED OK // Query the current jamming status. // In a jamming environment, jamming is detected. fide Jammer removed +QJDR: NO JAMMING n AT+QJDR? +QJDR: NO JAMMING Co OK // The URC is reported automatically. No jamming is detected. // Query the current jamming status. // No jamming is detected. GSM_Jamming_Detection_Application_Note Confidential / Released 12 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 4.2. Report Jamming via URC Periodically AT+QJDR=1 OK // Enable Jamming Detection. AT+QJDCFG='period',5 OK // Set the as 5. URC will be reported every 5 seconds. In a jamming environment, please refer to chapter 2.2. +QJDR: JAMMED // The URC will be reported automatically every 5 seconds. Jamming has been detected. … +QJDR: JAMMED l …. te If Jammer removed +QJDR: NO JAMMING uec tial AT+QJDCFG='period',0 OK // The URC will be reported automatically every 5 seconds. Jamming has been detected. // The URC is reported automatically. No jamming is detected. // Disable reporting URC periodically. Q en 4.3. Report Jamming via Pin fid If Quectel’s module detects a jammer, it will set the hardware output pin from low level to high level. AT+QJDR=1 n OK // Enable Jamming Detection. o AT+QJDCFG='pin','RI' //The jamming status can be reported via RI PIN and RI function is disabled. C OK AT+QJDCFG='pin','' // Disable the function of jamming status reporting via the pin. OK GSM_Jamming_Detection_Application_Note Confidential / Released 13 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 4.4. Start and Stop Jamming Detection AT+QJDR=? +QJDR: (0,1) // Test mode. OK AT+QJDR? +QJDR: NO JAMMING OK // Query the current jamming status. // No jamming detected. AT+QJDR=1 OK //Turn on jammer l +QJDR: JAMMED te //Turn off jammer uec tial +QJDR:NOJAMMING AT+QJDR=0 OK // Enable Jamming Detection function. // The jammer has been detected and then jamming is reported. // Report the jammer have been removed. // Disable Jamming Detection function. Q en 4.5. Configure Jamming Detection fid AT+QJDCFG=? // Test mode. +QJDCFG: ('URC','PERIOD','PIN','MNL','MINCH'),(value) on OK C AT+QJDCFG? // Query the current parameter configuration. +QJDCFG: 'urc',1 // The default configuration of is 1. It represents that reporting jamming status via URC is enabled. +QJDCFG: 'period',0 // The default value of the is 0. It represents that reporting jamming status via URC periodically is disabled. +QJDCFG: 'pin','' // The default value of the is empty. It represents that reporting Jamming status via a pin is disabled. +QJDCFG: 'mnl',17 // The default value of is 17 +QJDCFG: 'minch',5 // The default value of is 5 OK GSM_Jamming_Detection_Application_Note Confidential / Released 14 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note AT+QJDCFG='period',5 // Set is 5. It represents that jamming status is reported via URC through serial port every 5 seconds. OK AT+QJDCFG='mnl',16 // Set as 16. OK AT+QJDCFG='minch',6 // Set as 6. OK AT+QJDR=1 OK // Enable Jamming Detection function. l //Turn on jammer te +QJDR: JAMMED // Jamming has been detected and reported. c l //Turn off jammer ue tia +QLJDR: NO JAMMING // Report the jammer has been removed. AT+QJDR=0 // Disable Jamming Detection function. CQonfiden OK GSM_Jamming_Detection_Application_Note Confidential / Released 15 / 16 a GSM/GPRS Module Series GSM Jamming Detection Application Note 5 Appendix A Reference Table 1: Terms and Abbreviations Abbreviation Description BSIC Base Station Identity Code RSSI URC MNL MINCH Received Signal Strength Indication Unsolicited Result Code l Maximum Noise Level CQouneficdteential Minimum Channel Number GSM_Jamming_Detection_Application_Note Confidential / Released 16 / 16

WCDMA UGxx PPP Application Note UMTS/HSPA Module Series Rev. WCDMA_UGxx_PPP_Application_Note_V1.2 Date: 2015-04-01 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx PPP Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_PPP_Application_Note Confidential / Released 1 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note About the Document History Revision 1.0 1.1 1.2 Date 2014-12-30 l 2015-03-05 CQouneficdteential 2015-04-01 Author Wythe WANG Wythe WANG Wythe WANG Description Initial Changed the document name from 'UG95' to 'UGxx'. Updated applicable modules. WCDMA_UGxx_PPP_Application_Note Confidential / Released 2 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 2 Application Mode ................................................................................................................................. 7 3 Procedure for PPP Setup .................................................................................................................... 8 3.1. General Procedure for PPP Setup ............................................................................................ 8 4 5 6 3.2. Recommended Procedure for PPP Setup................................................................................. 9 UART/USB for PPP Connection ....................................................................................................... 11 4.1. Data Mode and Command Mode ............................................................................................ 11 l 4.1.1. Switch from Data Mode to Command Mode.................................................................. 11 4.1.1.1. Use DTR Level Switch from Data Mode to Command Mode.............................. 11 te 4.1.1.2. Use Sequence +++ to Switch from Data Mode to Command Mode ................... 11 4.1.2. Switch from Command Mode to Data Mode.................................................................. 12 c l 4.1.2.1. Use ATO to Switch from Command Mode to Data Mode .................................... 12 ue tia 4.2. Terminate the Connection........................................................................................................ 12 4.3. Handle URC in Data Mode ...................................................................................................... 13 4.4. Data Carrier Detect (DCD) Function Mode ............................................................................. 13 Q n PPP Dial-up in Windows.................................................................................................................... 14 5.1. Preparation .............................................................................................................................. 14 e 5.2. Modem Configuration .............................................................................................................. 14 fid 5.2.1. Configure the Modem Driver.......................................................................................... 14 5.3. Dial-up Network Configuration ................................................................................................ 15 5.3.1. Set up a New Connection .............................................................................................. 15 n PPP Dial-up in Linux.......................................................................................................................... 19 6.1. Prepare PPPD and CHAT ....................................................................................................... 19 o 6.2. Create Script Files ................................................................................................................... 19 C 6.3. Set up PPP Connection by PPPD ........................................................................................... 21 7 Appendix A Reference....................................................................................................................... 22 WCDMA_UGxx_PPP_Application_Note Confidential / Released 3 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note Table Index TABLE 1: RELATED DOCUMENTS .................................................................................................................. 22 TABLE 2: TERMS AND ABBREVIATIONS ........................................................................................................ 22 CQouneficdteenl tial WCDMA_UGxx_PPP_Application_Note Confidential / Released 4 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note Figure Index FIGURE 1: PPP APPLICATION MODE............................................................................................................... 7 FIGURE 2: GENERAL PROCEDURE FOR PPP SETUP ................................................................................... 8 FIGURE 3: FLOWCHART FOR PPP SETUP ..................................................................................................... 9 FIGURE 4: USB MODEM PORT ....................................................................................................................... 14 FIGURE 5: CONFIGURE THE MODEM DRIVER............................................................................................. 15 FIGURE 6: SET UP A NEW CONNECTION ..................................................................................................... 16 FIGURE 7: SET UP A DIAL-UP CONNECTION................................................................................................ 16 FIGURE 8: TYPE THE INFORMATION FROM YOUR INTERNET SERVICE PROVIDER.............................. 17 FIGURE 9: DIAL-UP CONNECTION IS STARTING ......................................................................................... 17 FIGURE 10: DIAL-UP CONNECTION IS FINISHED ........................................................................................ 18 CQouneficdteenl tial WCDMA_UGxx_PPP_Application_Note Confidential / Released 5 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 1 Introduction This document gives a brief introduction to PPP function of Quectel standard module, including recommended procedures for PPP setup, the mode for PPP connection, and the example for PPP dial-up in Windows and Linux system. This document is applicable to UGxx modules. CQouneficdteenl tial WCDMA_UGxx_PPP_Application_Note Confidential / Released 6 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 2 Application Mode Application IP IP RELAY PPP ctel l UART TXD RXD CTS RTS DTR DCD RING ue tia USB USB_DM USB_DP USB_GN USB_VBUS Q en Application PPP TXD RXD CTS RTS DTR DCD RING UART Radio Bearer USB_DM USB_DP USB_GND USB_VBUS USB Module fid Figure 1: PPP Application Mode n The usage of PPP (Point to Point Protocol) can be described as Figure 1. You can use either UART or o USB to realise PPP connection. Module provides a PPP server to application, and application side C provides PPP client to module. Besides, application side also has to provide the following protocols: TCP/IP, HTTP, etc. When PPP connection has been set up, the IP packet flow from application side will be transmitted to Internet by module. Most standard operating systems (e.g. Windows, Unix/Linux) include the PPP protocol stack. For other operating systems which do not have existing application to set up PPP connection, it is very important to develop an applicable application software to accomplish PPP connection first. WCDMA_UGxx_PPP_Application_Note Confidential / Released 7 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 3 Procedure for PPP Setup This chapter gives the recommended procedure of PPP setup for Quectel standard module. If you want to develop PPP application software, please read this chapter before programming. 3.1. General Procedure for PPP Setup TE MT tel AT+CGREG? c l +CGREG:0,1 ue tia AT+CGDCONT=1,'IP','CMNET' OK Q n ATD*99# e CONNECT fid 7E FF 7D 23 C0 21 7D 21 7D …… ConFigure 2: General Procedure for PPP Setup After module has registered to the GPRS network, you should set APN for PPP by AT+CGDCONT and start PPP setup by command ATD*99#. When ATD*99# is executed, module enters into the procedure of PPP packet interaction. The way of PPP packet interaction which Quectel module uses is on the basis of standard Point to Point Protocol. Description about module’s packet interaction is included in Figure 3. Please get more details about standard Point to Point Protocol from RFC 1661. WCDMA_UGxx_PPP_Application_Note Confidential / Released 8 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 3.2. Recommended Procedure for PPP Setup Recommended Power ON/OFF: 1. Power OFF: Send AT+QPOWD=1, then cut off power after 12s. 2. Power ON: Pull Power Key to low in 1s. Power On the Module 1.Synchronization between TE and TA 2. Fix and save baudrate by AT+IPR=xxx;&W, if USB port is used, this coud be ignored N Query SIM Card Status: AT+CPIN/AT+QINISTAT. Reboot module if module failed to detect SIM card in 10s with AT+CPIN?. Exit from the PPP dialing if SIM Card is not ready in 10s AT+CPIN？ Y Query SIM Card Status Connect_Count <5 SIM card is ready Exit from the PPP dialing Network： 1. It indicates that module has if module failed to register to network in 60s AT+CREG？ registered to network when AT+CREG? returns 1 or 5. 2. Reboot the module if it failed to register to network in 60s. PS Network： 1. It indicates that module has l registered to PS when AT+CGREG? returns 1 or 5. 2. It is able to go to next step without registering to PS in 60s. Query network Register to network in 60s AT+CGREG? Query PS network te APN Configuration： c l 1. APN must be set by AT+CGDCONT 2. Use AT+CGACT? to check whether current context has been ue tia activatedwhenAT+CGDCONT returns error. 1. Set APN by AT+CGDCONT 2. Start PPP Dialing by ATD*99# Connect_Count++ Packet Interaction Q n Packet Interaction 1. Exit from the procedure of Packet Interaction by '+++'. e 2. Module will report NO CARRIER when PPP connection is terminated. fid LCP Negotiation 1. If UART is used, ensure the baudrate between MCU and module is the same. AUTH Negotiation 1. Ensure the type of AUTH is one n of PAP(0xc023) and CHAP(0xc223). o IPCP Negotiation 1. Check if MCU gets legal IP and DNS address. 2. Check whether the amount of C DNS MCU is equal to the amount Start timer when IPCP negotiation begins Return CONNECT LCP Negotiation OK AUTH Negotiation OK IPCP Negotiation Exception Handling N Send Count<5 Y N OK Succeed to negotiate IPCP MCU sends PPP N Terminate- Y MCU receives PPP Terminate- in 90s Request Ack packet in 3s packet Y Send Count++ requested by MCU. 3. Terminate PPP connection if IPCP negotiation between TA and TE is not completed in 90s, and then retry PPP setup. N MCU got IP and DNS Exception Handling 1. Check whether the PPP Terminate-Request packet is right. 2. Reboot module if the steps above Y do not work. Data Transmission Figure 3: Flowchart for PPP Setup WCDMA_UGxx_PPP_Application_Note Confidential / Released 9 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note When you power on module, if you use the UART, baud rate of the UART must be fixed by AT+IPR=115200;&W. Before using ATD*99# to set up PPP, you must check the status of SIM card with AT+CPIN?. When SIM card is OK, you also need to check the state of network periodically with AT+CREG? and AT+CGREG? until network condition is ready. NOTES 1. Ensure that MCU and the module are synchronized successfully after rebooting the module. MCU sends 'AT' to module every 100ms until 'OK' is received from the module. And if the UART is used, MCU fixes and saves baud rate by 'AT+IPR=xxx;&W' after synchronization is successful. 2. Please note that MCU has to wait for the response (for example OK, CME error, CMS error) of the previous AT command before inputting the next AT command. The module can be rebooted if there is no response in 60s. 3. The module cannot be rebooted frequently. When you constantly failed to restart for 3 times, you can restart immediately for the first time after that, if it still fails, you should restart after 10 minutes for the l second time, and restart after 30 minutes for the third time, 1 hour for the fourth time, etc. 4. If MCU fails to transmit data to network after PPP connection has been set up, please check the CQouneficdteential configuration of PPP and the state of network, and then reboot the module. WCDMA_UGxx_PPP_Application_Note Confidential / Released 10 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 4 UART/USB for PPP Connection 4.1. Data Mode and Command Mode Module communicates information with application by UART/USB port, including AT commands and data. There are two modes for module’s port. One is data mode and the other is command mode. Module’s port is in command mode before PPP setup, and module can execute AT commands in this state. When PPP negotiating is started, module’s port will enter into data mode. Module will be kept in data mode when PPP connection was set up and module cannot execute AT commands in data mode. Quectel standard l modules provide convenient methods to switch between the modes. te 4.1.1. Switch from Data Mode to Command Mode uec tial 4.1.1.1. Use DTR Level Switch from Data Mode to Command Mode When PPP connection already exists and module is in data mode, you can change module from data Q n mode to command mode by setting command of AT&D1 and switching DTR level from low to high. If module’s mode is changed successfully in this way, module will return 'OK'. fide 4.1.1.2. Use Sequence +++ to Switch from Data Mode to Command Mode n Another way to switch module from data mode to command mode is using sequence +++ when PPP connection has been set up successfully. To prevent the +++ escape sequence from being misinterpreted Co as data, it should comply with the following sequences:  Do not input any character within 1s or longer,  Input '+++' within 1s, and no other characters can be inputted during this time,  Do not input any character within 1s after '+++' has been inputted. When such particular sequence +++ is received, module will switch from data mode to command mode and return 'OK' for this kind of operation. WCDMA_UGxx_PPP_Application_Note Confidential / Released 11 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note NOTE Please make sure above operation is operated after completion of PPP negotiation. If not, above operation will terminate the PPP negotiation and quit from data mode. When UART/USB is changed to command mode after accomplishing PPP negotiation, the data will be treated as AT command and module still remains PPP connection. 4.1.2. Switch from Command Mode to Data Mode 4.1.2.1. Use ATO to Switch from Command Mode to Data Mode Example //When PPP connection exists, and module is in command mode. l ATO CONNECT 7200000 //Indicates that TA has entered into data mode; inputting te commands from UART will be treated as PPP data. uec tial 4.2. Terminate the Connection It is recommended to terminate the connection with LCP Terminate-Request message in PPP. This Q n method must be operated in data mode. e TA can also terminate the connection by switching the DTR level. You should set DTR function with fid AT&D2 first. This method must be operated in data mode as well. Example n //Module is still in command mode before PPP connection has been set. o AT&D2 C OK When PPP connection exists already, switch the DTR level from low to high, the data connection will terminate automatically. Module enters into command mode after PPP connection is terminated completely. WCDMA_UGxx_PPP_Application_Note Confidential / Released 12 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 4.3. Handle URC in Data Mode Incoming call and short message will not be reported to the port in the data mode during PPP connection. The level of module’s RI pin will change from high to low for 120ms as indication. MCU can process the call or short message by switching to command mode according to the status of RI pin. If incoming call or message exists, the URC will be output to the port when module is changed to command mode. 4.4. Data Carrier Detect (DCD) Function Mode DCD function mode is determined by AT&C. If AT&C0 was set, the status of DCD pin will not be used to indicate the data carrier status. And if AT&C1 was set, the DCD pin will be used to indicate the data carrier status. The pin will hold on low level when data carrier exists or PPP negotiation begins, otherwise it will keep in high level. tel NOTE CQouneficdential When switching PPP from data mode to command mode (using +++), the DCD state does not change. WCDMA_UGxx_PPP_Application_Note Confidential / Released 13 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 5 PPP Dial-up in Windows 5.1. Preparation It is necessary to finish the following steps before establishing a PPP connection. 1. Install the USB driver in Windows for UGxx. 2. Connect the module to PC and enter the PIN code if the SIM card PIN is locked. 3. Make sure the SIM card can successfully register to the GPRS network. tel 5.2. Modem Configuration c l 5.2.1. Configure the Modem Driver ue tia After installing the USB driver for UGxx, a modem device which is named as 'USB Modem Port' would be CQonfiden created in device manager. Figure 4: USB Modem Port WCDMA_UGxx_PPP_Application_Note Confidential / Released 14 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note Select the 'USB Modem Port' which has been installed, right click and choose 'Properties' menu, then click 'Advanced' to configure 'Extra Settings', input AT command 'AT+CGDCONT=1,'IP','CMNET'' as illustrated in the Figure below. Quectenl tial Figure 5: Configure the Modem Driver fide NOTE In the example above, the settings predefine a PDP context whose CID=1, PDP type=IP and n APN=CMNET. CMNET is the APN for the network provider China Mobile and it should be replaced with Co the APN by the network provider. 5.3. Dial-up Network Configuration 5.3.1. Set up a New Connection 1. Open 'Control Panel' and double click 'Network and Sharing Center', then click 'Set up a new connection or network'. Refer to Figure 6. WCDMA_UGxx_PPP_Application_Note Confidential / Released 15 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note ctel l Figure 6: Set up a New Connection CQounefidentia 2. Choose 'Set up a dial-up connection' on the pop-up menu list. Figure 7: Set up a Dial-up Connection WCDMA_UGxx_PPP_Application_Note Confidential / Released 16 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 3. Enter the dial-up phone number, user name and password from the network provider. ctel l Figure 8: Type the Information from your Internet Service Provider CQounefidentia 4. Click 'Connect' button and then the Dial-up Connection will be started. Figure 9: Dial-up Connection is Starting WCDMA_UGxx_PPP_Application_Note Confidential / Released 17 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note CQouneficdteenl tial Figure 10: Dial-up Connection is Finished WCDMA_UGxx_PPP_Application_Note Confidential / Released 18 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 6 PPP Dial-up in Linux 6.1. Prepare PPPD and CHAT In Linux system, PPP dial-up is implemented by PPPD and CHAT, it is necessary to install PPPD and CHAT before establishing PPP connection. 6.2. Create Script Files tel Create three script files, which are named as 'wcdma', 'wcdma-chat-connect', 'wcdma-chat-disconnect' in '/etc/ppp/peers' directory. The content of these three files are shown as follows: c l The content of the file 'wcdma' is shown as below: ue tia nodetach nolock Q n /dev/ttyACM0 e 115200 user '' fid password '' nocrtscts modem n hide-password usepeerdns o noauth C noipdefault //Must be your own device descriptor for UGxx USB Modem Port. //Modify your user name here if necessary, it’s null in example. //Modify your password here if necessary, it’s null in example. novj novjccomp noccp debug defaultroute ipcp-accept-local ipcp-accept-remote connect 'chat -s -v -f /etc/ppp/peers/wcdma-chat-connect' disconnect 'chat -s -v -f /etc/ppp/peers/wcdma-chat-disconnect' WCDMA_UGxx_PPP_Application_Note Confidential / Released 19 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note The content of the file 'wcdma-chat-connect' is shown as below: ABORT 'NO CARRIER' ABORT 'ERROR' ABORT 'NO DIALTONE' ABORT 'BUSY' ABORT 'NO ANSWER' '' AT OK ATE0 OK ATD*99# CONNECT '' The content of the file 'wcdma-chat-disconnect' is shown as below: ABORT OK ABORT BUSY l ABORT DELAYED ABORT 'NO ANSWER' te ABORT 'NO CARRIER' ABORT 'NO DIALTONE' c l ABORT VOICE ue tia ABORT ERROR ABORT RINGING TIMEOUT 12 '' K Q n '' K e '' K '' +++ fid '' +++ '' +++ '' AT+CGACT=0,1 n '' ATZ Co SAY 'nGoodbayn' NOTE Please create these three files and write the content of script manually in Linux system. WCDMA_UGxx_PPP_Application_Note Confidential / Released 20 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 6.3. Set up PPP Connection by PPPD Switch to root account, and type command 'pppd call wcdma' in terminal. If PPP dial-up is established successfully, you can see the new network interface with command 'ifconfig'. ppp0 Link encap:Point-to-Point Protocol inet addr:10.156.235.241 P-t-P:10.64.64.64 Mask:255.255.255.255 UP POINTOPOINT RUNNING NOARP MULTICAST MTU:1500 Metric:1 RX packets:6 errors:0 dropped:0 overruns:0 frame:0 TX packets:4 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:3 CQouneficdteenl tial RXbytes:134(134.0B) TXbytes:58(58.0B) WCDMA_UGxx_PPP_Application_Note Confidential / Released 21 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note 7 Appendix A Reference Table 1: Related Documents SN Document Name Remark [1] Quectel_WCDMA_UGxx_AT_Commands_Manual AT Commands Manual for UGxx Table 2: Terms and Abbreviations l Abbreviation cte l PPP Que ntia UART fide APN CHAP n DNS Co DTR Description Point-to-Point Protocol, The Point-to-Point Protocol is designed for simple links which transport packets between two peers. These links provide full-duplex simultaneous bi-directional operation, and are assumed to deliver packets in order. It is intended that PPP provides a common solution for easy connection of a wide variety of hosts, bridges and routers. Universal Asynchronous Receiver Transmitter. Integrated circuit which works with serial ports converting incoming serial data from a serial port into parallel form and parallel data to serial form when sending out data through a serial port (Computers, Electronics). Access Point Name Challenge Handshake Authentication Protocol Domain Name Server Data Terminal Ready RI Ring Indicator DCD Data Carrier Detection GPRS General Packet Radio Service GSM Global System of Mobile Communication IP Internet Protocol WCDMA_UGxx_PPP_Application_Note Confidential / Released 22 / 23 UMTS/HSPA Module Series WCDMA UGxx PPP Application Note IPCP IP Control Protocol LCP Link Control Protocol MCU Micro Control Unit MS Mobile Station PAP Password Authentication Protocol PDP Packet Data Protocol PIN Personal Identification Number SIM TA TE Subscriber Identity Module Terminal Adapter CQouneficdteenl tial TerminalEquipment WCDMA_UGxx_PPP_Application_Note Confidential / Released 23 / 23

GSM QuecCell AT Commands Manual GSM/GPRS Module Series Rev. GSM_QuecCell_AT_Commands_Manual_V1.1 Date: 2015-04-08 www.quectel.com GSM/GPRS Module Series GSM QuecCell 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. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_QuecCell_AT_Commands_Manual Confidential / Released 1 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual About the Document History Revision 1.0 1.1 Date 2012-09-28 CQouneficdteenl tial 2015-04-08 Author Bob DENG Bob DENG Description Initial Added applicable modules GSM_QuecCell_AT_Commands_Manual Confidential / Released 2 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 1 Introduction .......................................................................................................................................... 5 2 AT Commands for GSM QuecCell...................................................................................................... 6 2.1. Overview of AT Commands for GSM QuecCell .......................................................................... 6 2.1.1. AT+QOPS Scan Basic Station Information ................................................................... 6 2.1.2. AT+QENG Switch on or off Engineering Mode ............................................................. 7 3 4 5 2.1.3. 2.1.4. 2.1.5. 2.1.6. l 2.1.7. AT+QLOCKF Lock the Base Station ........................................................................... 10 AT+QCHINFO Get Channel Information ..................................................................... 10 AT+QLASTTA Get TA Value ........................................................................................ 12 AT+QFORBIDMNC Forbid Operator........................................................................... 12 AT+QSCANF Scan ARFCN Receiving Level .............................................................. 13 te Example .............................................................................................................................................. 15 3.1. AT+QOPS ................................................................................................................................. 15 c l 3.2. AT+QENG ................................................................................................................................. 16 3.3. AT+QLOCKF ............................................................................................................................. 17 ue tia 3.4. AT+QCHINFO ........................................................................................................................... 18 3.5. AT+QLASTTA............................................................................................................................ 19 3.6. AT+QFORBIDMNC ................................................................................................................... 20 Q n 3.7. AT+QSCANF............................................................................................................................. 20 e Appendix A Reference....................................................................................................................... 26 Confid Appendix B Summary of Code...............................................................................................27 GSM_QuecCell_AT_Commands_Manual Confidential / Released 3 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual Table Index TABLE 1: OVERVIEW OF AT COMMANDS FOR GSM QUECCELL ................................................................. 6 TABLE 2: RELATED DOCUMENTS .................................................................................................................. 26 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 26 TABLE 4: DIFFERENT CODING SCHEMES OF +CME ERROR: ....................................................... 27 CQouneficdteenl tial GSM_QuecCell_AT_Commands_Manual Confidential / Released 4 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 1 Introduction QuecCell function is a feature embedded in Quectel modules that can scan the detailed information about the base station, lock the specified GSM frequency, and forbid the specified operator. With this feature, the customer can choose the network they expect in the certain place. This document is applicable to all Quectel GSM modules. CQouneficdteenl tial GSM_QuecCell_AT_Commands_Manual Confidential / Released 5 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 2 AT Commands for GSM QuecCell 2.1. Overview of AT Commands for GSM QuecCell Table 1: Overview of AT Commands for GSM QuecCell Command AT+QOPS l AT+QENG te AT+QLOCKF c l AT+QSCANF ue tia AT+QCHINFO AT+QLASTTA Q n AT+QFORBIDMNC Description Scan Basic Station Information Switch on or off engineering mode Lock the Base Station Scan ARFCN receiving Level Get channel information Get last valid TA value Forbid operator fide 2.1.1. AT+QOPS Scan Basic Station Information The command can scan all the GSM frequencies. After that, the operator with the best network coverage n can be chosen through the results of QuecCellScan. o AT+QOPS Scan Basic Station Information C Read Command Response AT+QOPS? +QOPS:,,, ,,,,, ,,,,, … ,,,,, +QOPS:,,, ,,,,, GSM_QuecCell_AT_Commands_Manual Confidential / Released 6 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual ,,,,, … ,,,,, +QOPS:,,, …. OK If error is related to ME functionality: +CME ERROR: Parameter tel c l ue tia Q n e 0 Unknown 1 Operator available 2 Current Operator 3 Forbidden Operator Operator in long format alphanumeric Operator in short format alphanumeric Operator in numeric format Radio frequency channel number in decimal display, Renumber again under different operator Location Area Code in hex format, 4-byte in fixed width Cell ID in hex format, 4-byte in fixed width Base Station Identity Code in hex format, 2-byte in fixed width Receive level in decimal format, volatile width Absolute Radio Frequency Channel Number in decimal format, volatile width fid NOTES n 1. The maximum index is 10 for each operator. Co 2. Allow to scan all GSM frequency even without SIM card inserted in the module. 2.1.2. AT+QENG Switch on or off Engineering Mode Engineering Mode is designed to report the information of serving cells and the neighboring cells. AT+QENG Switch on or off Engineering Mode Test Command AT+QENG=? Response +QENG: (list of supported s),(list of supported s) OK GSM_QuecCell_AT_Commands_Manual Confidential / Released 7 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual Read Command AT+QENG? Response The type of the cell information URCs is control by parameter: +QENG: , URCs of the serving cell information: +QENG: 0,,,,,,,,,,,,,,,,, URCs of 1-6 the neighboring cell information: tel Write Command Quec ntial AT+QENG=[,] [+QENG: 1,list of (,,,,, ,, ,,)…] URCs of cell frequency list(CA) of the serving cell: [+QENG: 2,list of ()…] OK Response Switch on or off engineering mode. It will report +QENG: (network information) automatically if =2. OK ERROR +CME ERROR: e Parameter fid Con 0 Switch off engineering mode 1 Switch on engineering mode 2 Switch on engineering mode, and activate the URC report of network information 0 Only display the information of serving cell 1 Display the information of serving cell and 1-6 neighboring cells 3 Display the information of serving cell and 1-6 neighboring cell, list of ARFCN and Cell frequency list (CA) of the serving cell Mobile country code Mobile network code Location area code in hex format Cell ID in hex format Absolute Radio Frequency Channel Number of Broadcast Control Channel BCCH Base station identity code Receive signal level in dBm unit C1 value GSM_QuecCell_AT_Commands_Manual Confidential / Released 8 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual C2 value Transmit power maximum access a CCH Receive level access minimum Timeslots MAIO value HSN value ARFCN of TCH, ‘h’ figure hopping Timing Advance, range 0~63 RX quality (sub), range 0-7 RX quality (full), range 0-7 Number of neighboring six cell ID 1~6 Absolute radio frequency channel number NOTES 1. When mode is 2, auto URCs are reported per 5 seconds. l 2. The and parameters in hex format, other parameter is in decimal format. 3. If the cell information is not detected, the parameter is replaced by ‘x’ char. te 4. If the detecting is not expert mode, the , , maio>, , , and c l parameter do not display the value of the parameter and replaced by ‘x’ char. 5. Duration of the network connecting, if the hopping frequency is supported by the network, so the ue tia channel of TCH is instable. Using the ’h’ figure under this mode. 6. Under expert mode, when the and of the serving cell cannot be updated. Using the ‘-1’ figure to display the illegal value. At the same time, the and parameter cannot be Q n updated in a certain condition, all the same holding the value of idle mode. This is because ME cannot be updated in this mode and cannot update the selection of cell and reselection of the e parameter. When the connecting is over, mobile device goes back idle mode and gives out the correct value. fid 7. If TA can report the information of the neighboring cell, the URCs of six neighboring cell should be reported. If some cells cannot be measured, the ‘x’ char will be filled in the parameter of these cells. 8. Under the special mode, the and parameters of the neighboring cell may be measured, n then will report an unmeaning value. When the , , and parameter of the o neighboring cell cannot be measured, the 'x' char will be filled in these parameters of all the six cells. 9. The command does not report the RX level and the RX quality. The AT+CSQ command can be used C to query the values of RX level and RX quality. 10. The AT+QSPCH command can be used to re-query the type of the voice channel during calling (FR, HR, EFR, AMR_FR, AMR_HR). GSM_QuecCell_AT_Commands_Manual Confidential / Released 9 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 2.1.3. AT+QLOCKF Lock the Base Station This command can lock a specified Base Station. AT+QLOCKF Lock the Base Station Test Command AT+QLOCKF=? Response +QLOCKF: (list of supported s), (list of supported s) , (list of supported s) OK Read Command Response AT+QLOCKF? +QLOCKF: Write Command AT+QLOCKF=,, tel [,] [,] OK Response OK ERROR +CME ERROR: c l Parameter ue tia Q n e fid 0 Disable lock frequency 1 Enable lock frequency 0 Not a cell ID of 1900 band 1 Cell ID of 1900 band 0-1024 ARFCN information 0 ME has not locked a certain ARFCN 1 ME has locked a certain ARFCN n NOTE o parameter is overlapped in the DCS1800 and PCS1900 bands, so parameter can C distinguish which Band ARFCN is located. 2.1.4. AT+QCHINFO Get Channel Information This command can report the detailed network information of the serving channel. It can be set as report or query mode. GSM_QuecCell_AT_Commands_Manual Confidential / Released 10 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual AT+QCHINFO Get Channel Information Test Command AT+QCHINFO=? Read Command AT+QCHINFO? Response OK Response +QCHINFO: ,,,,,, OK Write Command Response AT+QCHINFO= Set the module whether automatic report QCHINFO Parameter NOTES OK l 0 Null state te 1 Inactive state 2 Cell select state c l 3 Idle state 4 Access state ue tia 5 Packet transfer state 6 Dedicated state 7 Cell reselect state Q n Frequency e Receiving level in dBm Channel type fid Timing Advance, the value 255 is unavailable Receiving quality (sub), range is 0-7, the same as the parameter of QENG Receiving quality (full), range is 0-7, the same as the parameter of QENG n 0 Automatic report Co 1 Non-automatic report 1. This command is available only when the parameter of the command 'AT+QENG=[,]' is 1 or 2. 2. The parameter will be changed when SMS CALL or GPRS is transmitted. GSM_QuecCell_AT_Commands_Manual Confidential / Released 11 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 2.1.5. AT+QLASTTA Get TA Value This command can get the last valid Time Advance. AT+QLASTTA Get TA Value Test Command AT+QLASTTA=? Execution Command AT+QLASTTA Response OK Response +QLASTTA: OK Parameter Last valid TA value tel NOTES c l This command is available only when the parameter of the command 'AT+QENG=[,]' is 1 or 2. ue tia 2.1.6. AT+QFORBIDMNC Forbid Operator Q n The command can forbid the specified operator and radio bands. Even if the SIM card is not inserted, this e function can also be enabled. fid AT+QFORBIDMNC Forbid Operator Test Command AT+QFORBIDMNC=? Con Execution Command Response +QFORBIDMNC: (list of supported s)[,(list of supported )][ ,(list of supported s)] OK Response AT+QFORBIDMNC=[,line][,for bidden data] OK ERROR +CME ERROR: Parameter 0 Read a line of forbidden data 1 Write a line of forbidden data GSM_QuecCell_AT_Commands_Manual Confidential / Released 12 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 2 Clean a line of forbidden data 3 Clean all forbidden data 4 Read the forbidden data [0] 5 Write the forbidden data [0] The parameter is line number of a forbidden data when is 0, 1 or 2. The parameter is value of data [0] when is 4 or 5. String type in hex format. The detail is: MCC + MNC + Band 0xff, 0xff, 0xff, 0xff, 0x00 ... ------------------- ---- ---- MCC + MNC Band force to zero | | | | | | | | | ----> 0x00 => GSM 850 l | 0x01 => GSM 900 | 0x02 => GSM 1800 te | 0x03 => GSM 1900 | c l -----> 0x00, 0x0f, 0xff => all country ue tia 0x73, 0x2f, 0xff => all networks in MCC=732 0x73, 0x20, 0x1f => MCC=732, MNC=01f Example: CMCC 850 46000f0000, 46002f0000, 46007f0000 Q n CMCC 900 46000f0100, 46002f0100, 46007f0100 e CMCC1800 46000f0200, 46002f00200, 46007f0200 fid NOTES The setting value can be stored in NVRAM automatically. The setting value can take effect when the n module is started next time. Co 2.1.7. AT+QSCANF Scan ARFCN Receiving Level This command can scan the specified frequency or a certain band, then show the list of ARFCN and RxLevel from the strongest signal level to the lowest when CFUN is 0 or 4. AT+QSCANF Scan ARFCN Receiving Level Test Command AT+QSCANF=? Response +QSCANF: (list of supported s),(list of supported s)) GSM_QuecCell_AT_Commands_Manual Confidential / Released 13 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual Write Command AT+ QSCANF=, OK Response OK ERROR +CME ERROR: Parameter 0 GSM900 band 1 DCS1800 band l 2 PCS1900 band 3 GSM850 band 0-1023 ARFCN or 9999 0 ME have not locked a certain ARFCN 1 ME have locked a certain ARFCN cte l NOTES ue tia 1. Scan ARFCN receiving level in dBm when CFUN is 0 or 4. 2. List the receiving level of 20 CHs according to descending in dBm when ARFCN is 9999. CQonfiden 3. AT Command is invalid when AT+CFUN=1. GSM_QuecCell_AT_Commands_Manual Confidential / Released 14 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 3 Example 3.1. AT+QOPS The module can scan all the GSM frequencies and report the detailed information of the Basic Station even without SIM card inserted in it by this command. Two examples are shown as below: With SIM card: l Call Ready //Phonebook initialized. te AT+QOPS? //Query nearby base station information. c l +QOPS: 2,'CHINA MOBILE','CMCC','46000' //Current Operator CMCC. 1,1877,0872,34,60,9 //Discovery of nine CMCC base stations in the vicinity as below. ue tia 2,1877,01C2,18,39,581 3,1877,0013,31,43,22 4,1877,0012,29,33,2 Q n 5,1877,0152,0F,32,24 6,1877,01C3,0B,33,576 e 7,1877,03A3,32,30,583 fid 8,1806,2031,1C,29,26 9,1877,0023,2E,30,16 +QOPS: 3,'CHINA UNICOM GSM','CU-GSM','46001' //Forbidden Operator CU-GSM. n 1,144B,1ACD,18,40,118 //Discovery of seven CU-GSM base stations in the vicinity as below. 2,144B,C097,19,39,119 o 3,144B,CC12,13,31,123 C 4,144B,C096,16,29,111 5,144B,CC13,17,28,115 6,144B,8C52,15,28,716 7,144B,3E65,1B,27,733 OK GSM_QuecCell_AT_Commands_Manual Confidential / Released 15 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual Without SIM card inserted: +CFUN: 1 +CPIN: NOT READY //Without SIM Card inserted. AT+QOPS? //Query nearby base station information. +QOPS: 2,'CHINA MOBILE','CMCC','46000' 1,1877,0872,34,60,9 2,1877,0013,31,40,22 3,1806,20A2,26,38,24 4,1877,01C3,0B,34,576 5,1877,01C2,18,31,581 6,1806,2031,1C,28,26 7,1877,03A3,32,28,583 8,1877,0012,29,30,2 9,1806,2032,2C,28,18 +QOPS: 1,'CHINA UNICOM GSM','CU-GSM','46001' l 1,144B,C097,19,39,119 te 2,144B,1ACD,18,37,118 3,1059,6C8A,21,32,111 c l 4,144B,CC12,13,29,123 5,144B,8C52,15,28,716 ue tia OK Q n 3.2. AT+QENG fide Engineering Mode is designed to allow a field engineer to view and test the network information received by a module, when the module is either in idle mode or dedicated mode (that is: with a call active). In each mode, the engineer is able to view network interaction for the 'serving cell' (the cell the module is n currently registered with) or for the neighboring cells. Example is as the following. o AT+QENG =1,3 C OK //Enable engineering mode 1. AT+QENG? //Display the serving cell information, 1-6 neighboring cell information list of ARFCN and cell frequency list (CA) of the serving cell. +QENG: 1,3 +QENG: 0,460,00,1877,872,9,52,-49,185,185,5,14,x,x,x,x,x,x,x //Base station information of the serving cell, ARFCN of which is 9. +QENG: 1,1,24,-71,15,99,99,460,00,1877,152,2,26,-83,28,52,36,460,00,1806,2031,3,13,-85,42,41,41,460,00,187 GSM_QuecCell_AT_Commands_Manual Confidential / Released 16 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 7,151,4,516,-95,48,12,28,460,00,1806,2081,5,x,x,x,x,x,x,x,x,x,6,x,x,x,x,x,x,x,x,x //The neighboring cell information. +QENG: 2,9,55,64,68,83,94 //Cell frequency list (CA) of the serving cell (ARFCN is 9). OK 3.3. AT+QLOCKF By getting some information of the nearby Base Stations via AT+QOPS or AT+QENG, and locking a certain Base Station using AT+QLOCKF command, the module can work very well. The following is the example on how to lock the base station after querying Base Station information via AT+ QENG. RDY l +CFUN: 1 +CPIN: NOT INSERTED //Without SIM card inserted. te AT+QENG=1,1 c l OK ue tia AT+QENG? +QENG: 1,1 Q n +QENG: 0,460,00,1877,872,9,52,-62,159,159,5,8,x,x,x,x,x,x,x e +QENG: 1,1,22,-73,49,115,115,460,0,1877,13,2,24,-77,15,98,98,460,0,1877,152,3,26,-83,28,57,57,460,0,1806,2 fid 031,4,49,-84,55,71,71,460,0,1877,871,5,583,-86,50,63,63,460,0,1877,3a3,6,15,-88,54,53,53,460,0,1877 ,11 n OK o AT+QLOCKF =1,0,22 C OK //Lock to the base station of 22 and its ARFCN is 22. Since 22 is not belonged to the 1900 band, so the second parameter is 0. AT+QENG? +QENG: 1,1 +QENG: 0,460,00,1877,13,22,49,-76,102,102,5,8,x,x,x,x,x,x,x //Lock to 22 successfully. +QENG: 1,1,x,x,x,x,x,x,x,x,x,2,x,x,x,x,x,x,x,x,x,3,x,x,x,x,x,x,x,x,x,4,x,x,x,x,x,x,x,x,x,5,x,x,x,x,x,x,x,x,x,6,x,x,x, x,x,x,x,x,x GSM_QuecCell_AT_Commands_Manual Confidential / Released 17 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual OK AT+QLOCKF? +QLOCKF: 1 //Whether or not to lock the base station. //Already locked. OK AT+QLOCKF=0 OK AT+QLOCKF? +QLOCKF: 0 //Unlock all. //Whether or not to lock the base station. //Not locked. OK AT+QLOCKF=1,0,26,49,15 OK AT+QENG? //Lock to 26,49,15 three frequency points. l +QENG: 1,1 te +QENG: 0,460,00,1877,871,49,55,-86,64,64,5,8,x,x,x,x,x,x,x uec tial +QENG: 1,1,26,-86,28,47,47,460,0,1806,2031,2,15,-91,54,43,43,460,0,1877,11,3,x,x,x,x,x,x,x,x,x,4,x,x,x,x,x,x,x ,x,x,5,x,x,x,x,x,x,x,x,x,6,x,x,x,x,x,x,x,x,x Q n OK e AT+QLOCKF=0 OK //Unlock all nfid 3.4. AT+QCHINFO o This command can report the detailed network information of the serving channel. It can be set as report C or query mode. The example is as below. AT+QENG=1,3 //Enable engineering mode 1. OK AT+QCHINFO? //Query detailed information of the serving channel. +QCHINFO: 3,9,-50,8,255,255,255 OK ATD15618380236; GSM_QuecCell_AT_Commands_Manual Confidential / Released 18 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual OK AT+QLOCKF=1,0,22 OK AT+QCHINFO? //Query the serving channel information. +QCHINFO: 6,22,-71,27,2,6,4 //TA value changes. OK 3.5. AT+QLASTTA The command can get last valid Time Advance .The example is as below. l AT+QENG=1,1 //Enable engineering mode. te OK AT+QENG? //Query engineering mode information. uec tial +QENG:1,1 +QENG: 0,460,00,1877,872,9,52,-56,182,182,5,8,x,x,x,x,x,x,x //Display the serving cell information. Q n +QENG: 1,1,22,-68,49,135,119,460,0,1877,13,2,24,-69,38,132,116,460,0,1806,20a2,3,583,-76,50,104,88,460,0,1 e 877,3a3,4,26,-77,28,82,66,460,0,1806,2031,5,49,-79,31,89,73,460,0,1877,511,6,584,-86,33,46,62,460,0 ,1806,2081 //The neighboring cell information. fid OK AT+QLOCKF=1,0,22 n OK o ATD15618380236; OK C AT+QLASTTA //Query the last TA value. +QLASTTA: 2 OK GSM_QuecCell_AT_Commands_Manual Confidential / Released 19 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 3.6. AT+QFORBIDMNC The command can forbid the specified operator and radio bands. The operator is CU-GSM. Its MCC is '460' and MNC is '01'. It has two radio bands, one is GSM 900, and the other is PCS 1800. The following example shows how to forbid the operator. RDY +CFUN: 1 +CPIN: NOT READY //Without SIM card inserted. //Forbid CU-GSM AT+QFORBIDMNC=1,1,'46001F0100' //Forbid 46001 in the GSM 900 band. l OK AT+QFORBIDMNC=1,2,'46001F0200' //Forbid 46001 in the PCS 1800 band. te OK c l AT+QFORBIDMNC=0,1 //Read the first forbidden data. ue tia +QFORBIDMNC: '46001F0100' //Forbid 46001 in the GSM 900 band. OK Q n AT+QFORBIDMNC=0,2 //Read the second forbidden data. e +QFORBIDMNC: '46001F0200' //Forbid 46001 in the PCS 1800 band. fid OK n //The above settings will take effect after reboot. //Restart the module. Co //No matter SIM card is inserted or not, the module will not camp on the operator CU-GSM. 3.7. AT+QSCANF This command can scan the specified frequency or a certain band, and then show the list of ARFCN and RxLevel from the strongest signal level to the lowest when CFUN is 0 or 4. GSM_QuecCell_AT_Commands_Manual Confidential / Released 20 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual AT+CFUN=4 //Disable phone both transmitting and receiving RF circuits. OK AT+CFUN? //Query CUFN settings. +CFUN: 4 //The CUFN value is 4. OK AT+QSCANF=? //Test mode of QSCANF. +QSCANF: (0-3),(0-1023,9999) OK AT+QSCANF=0,9999 //List the receiving level of 20 CHs in GSM 900 band according to descending in dBm. +QSCANF: l 1, CH9, -57.2 //The receiving level of channel 9 is -57.2 dBm. te 2, CH22, -66.2 c l 3, CH24, -68.8 ue tia 4,CH28,-70.0 5, CH66, -72.0 Q en 6, CH123, -72.0 fid 7, CH69, -74.5 8, CH8, -74.5 n 9, CH10, -74.5 Co 10, CH47, -75.0 11, CH3, -76.0 12, CH86, -76.5 13, CH55, -77.2 14, CH119, -77.2 GSM_QuecCell_AT_Commands_Manual Confidential / Released 21 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 15, CH115, -77.2 16, CH5, -77.8 17, CH56, -78.2 18, CH2, -78.5 19, CH59, -78.5 20, CH7, -78.5 OK AT+QSCANF=1,9999 //List the receiving level of 20 CHs in DCS 1800 band according to descending in dBm. l +QSCANF: te 1, CH576, -74.0 //The receiving level of channel 576 is -74.0 dBm. c l 2, CH581, -79.5 ue tia 3,CH708,-80.2 4, CH583, -80.2 Q en 5, CH580, -80.5 fid 6, CH713, -81.5 7, CH584, -85.2 n 8, CH724, -85.2 Co 9, CH573, -85.5 10, CH518, -85.8 11, CH548, -86.0 12, CH736, -86.5 13, CH560, -87.0 GSM_QuecCell_AT_Commands_Manual Confidential / Released 22 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 14, CH551, -87.0 15, CH520, -87.5 16, CH720, -88.2 17, CH721, -89.2 18, CH612, -89.5 19, CH577, -89.5 20, CH539, -89.8 OK AT+QSCANF=2,9999 l +QSCANF: //List the receiving level of 20 CHs in PCS 1900 band according to descending in dBm. te 1, CH662, -109.0 uec tial 2,CH663,-109.2 3, CH675, -109.5 Q n 4, CH666, -109.5 e 5, CH665, -109.8 fid 6, CH661, -109.8 n 7, CH667, -109.8 Co 8, CH671, -109.8 9, CH668, -109.8 10, CH664, -110.0 11, CH670, -110.0 12, CH669, -110.2 13, CH679, -110.2 GSM_QuecCell_AT_Commands_Manual Confidential / Released 23 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 14, CH673, -110.2 15, CH672, -110.5 16, CH674, -110.5 17, CH677, -110.5 18, CH678, -110.5 19, CH676, -110.5 20, CH680, -110.8 OK l AT+QSCANF=3,9999 //List the receiving level of 20 CHs in GSM 850 band according to descending in dBm. te +QSCANF: uec tial 1,CH175,-75.0 2, CH135, -75.2 Q n 3, CH173, -76.0 e 4, CH172, -76.0 fid 5, CH176, -76.2 n 6, CH177, -76.8 Co 7, CH174, -77.0 8, CH137, -77.8 9, CH139, -77.8 10, CH144, -77.8 11, CH136, -78.5 12, CH140, -79.0 GSM_QuecCell_AT_Commands_Manual Confidential / Released 24 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 13, CH138, -79.2 14, CH142, -79.2 15, CH165, -80.5 16, CH163, -80.5 17, CH161, -80.5 18, CH162, -80.5 19, CH164, -80.8 20, CH147, -81.5 l OK te AT+QSCANF=0,7 //Scan ARFCN 7 receiving level in dBm. c l +QSCANF: ue tia CH7,-90.2 //The receiving level of channel 7 is -90.2 dBm. CQonfiden OK GSM_QuecCell_AT_Commands_Manual Confidential / Released 25 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 4 Appendix A Reference Table 2: Related Documents SN Document Name Remark [1] Quectel_Mxx_ATC The introduction to AT commands for Mxx Table 3: Terms and Abbreviations l Abbreviation CQouneficdteential ARFCN Description Absolute radio frequency channel number GSM_QuecCell_AT_Commands_Manual Confidential / Released 26 / 27 GSM/GPRS Module Series GSM QuecCell AT Commands Manual 5 Appendix B Summary of Code Table 4: Different Coding Schemes of +CME ERROR: Code of Meaning 0 1 2 3 4 5 Phone failure No connection to phone Phone-adaptor link reserved l Operation not allowed te Operation not supported CQouneficdential PH-SIM PIN required GSM_QuecCell_AT_Commands_Manual Confidential / Released 27 / 27

WCDMA UGxx Power Management Application Note UMTS/HSPA Module Series Rev. WCDMA_UGxx_Power_Management_Application_Note_V1.2 Date: 2015-04-01 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 1 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note About the Document History Revision 1.0 1.1 1.2 Date 2015-01-16 l 2015-03-06 CQouneficdteential 2015-04-01 Author Wythe WANG Wythe WANG Wythe WANG Description Initial Changed the document name from 'UG95' to 'UGxx'. Updated applicable modules. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 2 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 5 Figure Index ................................................................................................................................................. 6 1 Introduction .......................................................................................................................................... 7 2 Hardware Interface............................................................................................................................... 8 2.1. Pin Assignment.......................................................................................................................... 8 2.2. Power Management Pin ............................................................................................................ 9 3 4 2.3. DTR ........................................................................................................................................... 9 2.4. RI ............................................................................................................................................... 9 Introduction to URC ........................................................................................................................... 10 3.1. URC Event .............................................................................................................................. 10 l 3.2. Example of URC Configuration............................................................................................... 10 te Application Scenarios for Power Saving Solutions....................................................................... 12 4.1. Power Saving Solutions Based on UART Port ....................................................................... 12 c l 4.1.1. Requirements ................................................................................................................. 12 ue tia 4.1.2. Hardware Connection Configuration.............................................................................. 12 4.1.3. Software Initialization Configuration............................................................................... 13 4.1.4. Implementation Method.................................................................................................. 13 Q n 4.1.4.1. Module Enters into Power Saving Mode ............................................................... 13 4.1.4.2. Host Wakes up Module.......................................................................................... 13 e 4.1.4.3. Module Wakes up Host.......................................................................................... 13 4.2. Power Saving Solutions Based on USB Remote Wakeup ..................................................... 13 fid 4.2.1. Requirements ................................................................................................................. 13 4.2.2. Hardware Connection Configuration.............................................................................. 14 4.2.3. Software Initialization Configuration............................................................................... 14 n 4.2.4. Implementation Method.................................................................................................. 14 4.2.4.1. Module Enters into Power Saving Mode ............................................................... 14 o 4.2.4.2. Host wakes up Module .......................................................................................... 14 C4.2.4.3. Module Wakes up Host.......................................................................................... 15 4.3. Power Saving Solutions Based on USB Disconnection ......................................................... 15 4.3.1. Requirements ................................................................................................................. 15 4.3.2. Hardware Connection Configuration.............................................................................. 15 4.3.3. Software Initialization Configuration............................................................................... 15 4.3.4. Implementation Method.................................................................................................. 16 4.3.4.1. Module Enters into Power Saving Mode ............................................................... 16 4.3.4.2. Host Wakes up Module.......................................................................................... 16 4.3.4.3. Module Wakes up Host.......................................................................................... 16 4.4. Power Saving Solutions Based on USB Suspend/Resume and RI Pin ................................. 16 WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 3 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 4.4.1. Requirements ................................................................................................................. 16 4.4.2. Hardware Connection Configuration.............................................................................. 16 4.4.3. Software Initialization Configuration............................................................................... 17 4.4.4. Implementation Method.................................................................................................. 17 4.4.4.1. Module Enters into Power Saving Mode ............................................................... 17 4.4.4.2. Host Wakes up Module.......................................................................................... 17 4.4.4.3. Module Wakes up Host.......................................................................................... 17 5 AT Command...................................................................................................................................... 18 5.1. AT+QCFG='uart/power' Turn on/off the UART Port ............................................................ 18 5.2. AT+QCFG='urc/ri/ring' Ring Line Behavior of RING ........................................................... 19 5.3. AT+QCFG='urc/ri/smsincoming' Ring Line Behavior of Incoming SMS ............................. 20 5.4. AT+QCFG='urc/ri/other' Ring Line Behavior of Other URCs .............................................. 21 6 7 5.5. AT+QCFG='urc/delay' Delay URC Indication...................................................................... 22 Software Mechanism ......................................................................................................................... 24 6.1. Module Power Saving Mechanism.......................................................................................... 24 l 6.2. Module Power Saving Process ............................................................................................... 24 6.3. USB Power Saving Mechanism .............................................................................................. 25 te 6.4. Module Wakes up Host ........................................................................................................... 25 6.4.1. Host Wake-up Event ...................................................................................................... 25 c l 6.4.2. USB Remote Wakeup .................................................................................................... 25 CQounefidentia Appendix A Reference.......................................................................................................................27 WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 4 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note Table Index TABLE 1: POWER MANAGEMENT PIN ............................................................................................................. 9 TABLE 2: TERMS AND ABBREVIATIONS ........................................................................................................ 27 CQouneficdteenl tial WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 5 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note Figure Index FIGURE 1: PIN ASSIGNMENT (TOP VIEW)....................................................................................................... 8 FIGURE 2: CONNECTION DIAGRAM BASED ON UART ............................................................................... 12 FIGURE 3: CONNECTION DIAGRAM BASED ON USB REMOTE WAKEUP................................................. 14 FIGURE 4: CONNECTION DIAGRAM BASED ON USB DISCONNECTION .................................................. 15 FIGURE 5: CONNECTION DIAGRAM BASED ON USB SUSPEND/RESUME AND RI PIN........................... 17 FIGURE 6: MODULE POWER SAVING PROCESS ......................................................................................... 24 CQouneficdteenl tial WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 6 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 1 Introduction When the module is embedded into host system, it will increase the whole power consumption of the system. Therefore, Quectel provides several power management solutions on the module for the host to lower the overall power consumption by managing module working mode. This document is applicable to UGxx modules. The module power management solutions mainly consist of the following mechanisms:  Host controls module to enter into power saving mode l  Host wakes up module  The module wakes up host te This document illustrates hardware interface and the URC event in module power management first, and c l then elaborates typical application scenarios about power saving solutions. In the end, it briefly describes CQounefidentia the sleep and wakeup software mechanism of module. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 7 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 2 Hardware Interface The communication between module and host is mainly realized through USB and UART port. Besides, the module also provides other functional pins for host to manage power. 2.1. Pin Assignment GND 62 GND 61 RF_ANT 60 GND 59 GND 58 RESERVED 57 RESERVED 56 GND 55 GND 54 tel RESERVED 1 RESERVED 2 c l GND 3 PCM_CLK 4 ue tia PCM_SYNC 5 PCM_DIN 6 PCM_DOUT 7 Q n USB_VBUS 8 USB_DP 9 e USB_DM 10 fid RESERVED 11 RESERVED 12 RESERVED 13 n RESERVED 14 PWRKEY 15 o PWRDWN_N 16 CRESET_N 17 82 81 80 79 102 101 100 99 63 83 98 78 64 84 97 77 65 85 96 76 66 86 95 75 67 87 94 74 68 88 93 73 89 90 91 92 69 70 71 72 VBAT_RF 53 VBAT_RF 52 VRTC 51 GND 50 49 RESERVED 48 GND 47 USIM_GND 46 USIM_CLK 45 USIM_DATA 44 USIM_RST 43 USIM_VDD 42 USIM_PRESENCE 41 I2C_SDA 40 I2C_SCL 39 RI 38 DCD 37 RTS 36 CTS 35 TXD 34 RXD 33 VBAT_BB RESERVED 18 32 VBAT_BB 31 30 29 28 27 26 25 24 23 22 21 20 19 GND DTR VDD_EXT RESERVED RESERVED RESERVED CLK_OUT RESERVED RESERVED RESERVED NETLIGHT STATUS AP_READY POWER USB UART USIM PCM ANT GND RESERVED OTHERS Figure 1: Pin Assignment (Top View) WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 8 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 2.2. Power Management Pin Table 1: Power Management Pin Pin Name Input/Output Description Used for host to wake up module from power saving mode or allow module to enter into the power saving mode. When it is in high level, DTR IN it means host allows module to enter into power saving mode. When the module is in sleep mode, pulling down DTR will wake up module. DTR has been pulled up by default. Used for module to inform the host there is URC to report. When the module has no URC to report, RI will keep in high level. When there RI OUT is URC to report, RI will output a low pulse. If host is in sleep mode, it will be waked up and process URC. tel 2.3. DTR c l Pulling up DTR indicates the module is allowed to enter into power saving mode (To detect whether the ue tia module has been in power saving mode already, other conditions are needed to be met). If DTR is pulled down, module would not enter into power saving mode. When it has entered into power saving mode, you can pull down DTR to wake it up. Q en 2.4. RI fid When module needs to send URC to host, RI pin of the module will generate a low pulse (It will last 120ms by default, and the time can be configured by AT command) to inform the host. When the host is in n power saving mode, you can wake it up by detecting the low pulse. o Furthermore, in order to ensure the host can handle URC efficiently, you can set to delay URC sending by C AT command. For more details about AT command, please refer to Chapter 5. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 9 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 3 Introduction to URC In normal data interaction process, the module not only responds the request from host, but also takes the initiative to report external events to host, such as incoming call and short message. In general, the unsolicited information reported by the module is called URC (Unsolicited Result Code). The processing of URC is embodied in two aspects: report event information to host actively and generate low pulse on RI pin. In module power management, RI pin can inform the incoming URC to host in the form of pulse after the host enters into sleep mode. For the module supports several types of URC, frequent URC report will repeatedly wake up the host from the sleep mode, which will reduce the power management efficiency of the whole system and reduce the effect of power managing. In order to avoid l this, host should select corresponding URCs based on its own needs. cte l 3.1. URC Event ue tia The module contains various URCs. For example, network status URC is used to report the current network status to host. Short message URC is used to report the new incoming short messages. And Q n phone call URC is used to report the call state. For most URCs, you can configure whether to report them or not by AT command. So host can open or close URC report in different system status according to its e own needs. For instance, when you first start the system, you can set to actively report the URC relevant to network, short message and phone call by AT command. Before the host enters into sleep mode, you fid can forbid the report of URC related to network via AT command, but only report the URC relevant to short message and phone call. After the host has entered into sleep mode, it will only be waked up by URC relevant to short message and phone call. In this way, the basic requirements of the host have been met, Con and the power management efficiency of whole system has been improved as well. 3.2. Example of URC Configuration //The following example shows how to configure the relevant URCs: AT+CREG=1 or AT+CREG=2 OK AT+CREG=0 OK AT+CGREG=1 or AT+CGREG=2 //Enable to actively report the CS network registration status (Disabled by default) //Disable to actively report the CS network registration status //Enable to actively report the PS network registration status WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 10 / 27 OK AT+CGREG=0 OK UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note (Disabled by default) //Disable to actively report the PS network registration status NOTE For more details about AT commands, please refer to Quectel_WCDMA_UGxx_AT_Commands_Manual. CQouneficdteenl tial WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 11 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 4 Application Scenarios for Power Saving Solutions 4.1. Power Saving Solutions Based on UART Port 4.1.1. Requirements When the device is implementing power saving solutions, it is required that both host and module are able to enter into power saving mode. Host is communicated with module by UART port, not by USB port. This chapter illustrates the detailed implementation method based on these requirements. tel 4.1.2. Hardware Connection Configuration c l 1. Host is connected with module by UART port. ue tia 2. Host I/O is connected with module RI pin, and the pin connected with the host must be able to wake up. 3. Host I/O is connected with module DTR pin. Q en Module RXD fid TXD nRI CoDTR Host TXD RXD EINT GPIO GND GND Figure 2: Connection Diagram Based on UART UART port is an important channel for the communication between module and host. Through reusing the DTR functional pin in UART port, host can manage the module power easily. When DTR is in high level, the module will be allowed to enter into power saving mode. When DTR is in low level, the module cannot enter into power saving mode. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 12 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note NOTE The connection in dotted line in Figure 2 indicates that the level match between the two systems should be paid attention to in actual application. The connection in solid line means they can be connected directly. Same as the lines in the following connection diagrams of this chapter. 4.1.3. Software Initialization Configuration 1. Configure AT+QSCLK control variables to enable module to enter into power saving mode by AT+QSCLK=1; 2. Configure AT+QCFG='uart/power',0,0 to set main port on auto-close mode. 4.1.4. Implementation Method l 4.1.4.1. Module Enters into Power Saving Mode te When host enters into sleep mode, pulling up DTR pin enables the module to enter into power saving c l mode. ue tia 4.1.4.2. Host Wakes up Module Q n Host pulls down DTR pin to indicate host is in ready mode now. fide 4.1.4.3. Module Wakes up Host When the module has URC to report, its RI pin will generate a low pulse (Duration time is 120ms by n default, and it can be configured by AT command) to inform the host that URC is coming. When the host is in sleep mode, it is required to ensure that the change of RI pin level can wake up the host itself. After Co host is waked up, DTR pin should be set as low to enable main port. 4.2. Power Saving Solutions Based on USB Remote Wakeup 4.2.1. Requirements When the device is implementing power saving solution, it is required that both host and module are able to enter into power saving mode, and host should support USB suspend/resume and remote wakeup functionality. This chapter illustrates detailed implementation method based on these requirements. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 13 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 4.2.2. Hardware Connection Configuration Module USB_VBUS USB_DP USB_DM Host VDD USB_DP USB_DM GND GND l Figure 3: Connection Diagram Based on USB Remote Wakeup cte l 4.2.3. Software Initialization Configuration ue tia 1. Configure AT+QSCLK control variables to enable module to enter into power saving mode by AT+QSCLK=1; 2. Configure AT+QCFG='uart/power',0,0 to set main port on auto-close mode; 3. Configure the corresponding system and driver settings in host system. (For details, please contact Q n Quectel technical support.) fide 4.2.4. Implementation Method 4.2.4.1. Module Enters into Power Saving Mode Con Host sends suspend command to module on USB BUS, and module enters into power saving mode. 4.2.4.2. Host wakes up Module Host sending data to module through USB will change USB bus from suspend status to resume status to wake up the module. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 14 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 4.2.4.3. Module Wakes up Host When the module has URC to report, module will send remote wake-up signals to host on USB BUS. Host USB should be able to be waked up through these signals. 4.3. Power Saving Solutions Based on USB Disconnection 4.3.1. Requirements When the device is implementing power saving solution, it is required that both host and module are able to enter into power saving mode, and host should not support USB suspend/resume and remote wakeup functionality. So host should disconnect the USB when the device enters into power saving mode. This chapter illustrates detailed implementation method based on these requirements. l 4.3.2. Hardware Connection Configuration te 1. Connect host with module via USB; c l 2. Host I/O is connected with module RI pin, and the pin must be able to suspend wakeup. ue tia Module Q n USB_VBUS e USB_DP fid USB_DM RI ConGND Power Switch Host GPIO VDD USB_DP USB_DM EINT GND Figure 4: Connection Diagram Based on USB Disconnection 4.3.3. Software Initialization Configuration 1. Configure AT+QSCLK control variables to enable module to enter into power saving mode by AT+QSCLK=1; 2. Configure AT+QCFG='uart/power',0,0 to set main port on auto-close mode. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 15 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 4.3.4. Implementation Method 4.3.4.1. Module Enters into Power Saving Mode Host pulls down module’s USB_VBUS. 4.3.4.2. Host Wakes up Module Host pulls up module’s USB_VBUS to wake up the module. Then host begins to send data to the module. 4.3.4.3. Module Wakes up Host When the module has URC to report, RI pin will generate a low pulse (Duration time is 120ms by default, l and it can be set by AT command). Host must be able to be waked up by RI pin. After the host has been te waked up, pull up module’s UAB_VBUS to indicate the module outputs URC to host. uec tial 4.4. Power Saving Solutions Based on USB Suspend/Resume and RI Pin 4.4.1. Requirements Q n When the device is implementing power saving solution, it is required that both host and module are able e to enter into power saving mode. Meanwhile, host should support USB suspend/resume, but need not support USB remote wakeup functionality, and module RI pin should be the external wakeup source of the fid host. So, host should disconnect the USB when the device enters into power saving mode. This chapter illustrates detailed implementation method based on these requirements. n 4.4.2. Hardware Connection Configuration Co 1. Connect host with module via USB; 2. Host I/O is connected with module’s RI pin, and the pin must be able to suspend wakeup. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 16 / 27 Module USB_VBUS USB_DP USB_DM UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note Host VDD USB_DP USB_DM RI EINT GND GND Figure 5: Connection Diagram Based on USB Suspend/Resume and RI Pin l 4.4.3. Software Initialization Configuration te 1. Configure AT+QSCLK control variables to enable module to enter into powering saving mode by c l AT+QSCLK=1; 2. Configure AT+QCFG='uart/power',0,0 to set main port on auto-close mode. ue tia 4.4.4. Implementation Method Q en 4.4.4.1. Module Enters into Power Saving Mode fid Host sends suspend command to module on USB BUS to make module enter into powering saving mode. Con 4.4.4.2. Host Wakes up Module Host sends resume command to module through USB BUS to wake up the module. 4.4.4.3. Module Wakes up Host When the module has URC to report, RI pin will generate a low pulse (Duration time is 120ms by default, and the time can be set by AT command). Host must be able to be waked up by RI pin. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 17 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 5 AT Command 5.1. AT+QCFG='uart/power' Turn on/off the UART Port AT+QCFG='uart/power' Turn on/off the UART Port Test Command AT+QCFG=? l Write Command te AT+QCFG='uart/power'[,] Quec ential Reference Response …… +QCFG: 'uart/power', (0,1),(0-2) …… OK Response If is absent: +QCFG: 'uart/power',, OK If not absent: OK ERROR fid Parameter n Co 0 UART1 1 UART3 0 Auto turn on/off the UART port 1 Turn on the UART port 2 Turn off the UART port NOTE The UART3 does not support mode 0. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 18 / 27 Example AT+QCFG='uart/power',0, 0 OK UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note //Auto turn on/off the UART 1 port 5.2. AT+QCFG='urc/ri/ring' Ring Line Behavior of RING AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other' control the behavior of ring line when URC is reported. These configurations will be stored into NV automatically. The ring line is active low. AT+QCFG='urc/ri/ring' specifies the behavior of ring line when RING is presented to indicate an incoming call. The sum of parameter and determines the interval time of 'RING' indications when a call is coming. l AT+ QCFG='urc/ri/ring' Ring Line Behavior of RING te Write Command c l AT+QCFG='urc/ri/ring'[,[,[,[,[,]]]]] Response If configuration parameters are omitted (+QCFG='urc/ri/ring'), return current configuration: +QCFG: 'urc/ri/ring',,,, ,, Q n OK fide If configuration parameters are entered: OK ERROR Con Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms Parameter The behavior of the ring line when URCs are presented 'off' No change. Ring line keeps inactive 'pulse' Pulse. Pulse width determined by 'always' Change to active. You may restore to inactive by +QRIR 'auto' When 'RING' is presented to indicate an incoming call, ring line changes and keeps active. When ring of the incoming call WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 19 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note ends, either answering or hanging up the incoming call, ring line will change to inactive. 'wave' When 'RING' is presented to indicate an incoming call. The ring line outputs a square wave. Both and are used to set parameters of the square wave. When the ring of incoming call ends, either answering or hanging up the incoming call, ring line will change to inactive. Set the width of pulse. Value ranges from 1 to 2000ms and default is 120ms This parameter is only meaningful when is 'pulse'. If this parameter is not needed, you can set it as null. Set the active duration of the square wave, value ranges from 1 to 10000ms, l Queficdteential and the default is 1000ms.This parameter is only meaningful when is 'wave'. Set the inactive duration of the square wave, value ranges from 1 to 10000ms, and the default is 3000ms. This parameter is only meaningful when is 'wave'. Set whether the ring line behavior could be disturbed. This parameter is only meaningful when is configured to 'auto' or 'wave'. For example, when is configured to 'wave', if you need the square wave not to be disturbed by other URCs (including SMS related URCs), you should set to 'on'. 'off' It can be disturbed by other URCs of which the behavior of ring line is caused by an incoming call ringing. 'on' It cannot be disturbed by other URCs of which the behavior of ring line is caused by an incoming call ringing. The count of pulse. This parameter is only meaningful when is 'pulse'. Value ranges from 1 to 5 and default is 1. The interval time between two pulse is equal to . Con 5.3. AT+QCFG='urc/ri/smsincoming' Ring Line Behavior of Incoming SMS AT+QCFG='urc/ri/smsincoming' specifies the behavior of ring line when related incoming message URCs are presented. Related incoming message URCs list: +CMTI,+CMT,+CDS,+CBM. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 20 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note AT+ QCFG='urc/ri/smsincoming' Ring Line Behavior of Incoming SMS Write Command AT+QCFG='urc/ri/smsincoming'[,[,]] Response If configuration parameters are omitted (+QCFG='urc/ri/smsincoming'), return current configuration: +QCFG: 'urc/ri/smsincoming',,, OK tel Maximum Response Time If configuration parameters are entered: OK ERROR If error is related to ME functionality: +CME ERROR: 300ms uec tial Parameter Q en Confid The behavior of the ring line when URC are presented 'off' No change. Ring line keeps inactive 'pulse' Pulse. Pulse width determined by 'always' Change to active. You should restore to inactive by +QRIR Set the width of pulse. Value ranges from 1 to 2000ms and the default is 120ms. This parameter is only valid when is 'pulse'. The count of pulse. This parameter is only meaningful when is 'pulse'. Value ranges from 1 to 5 and default is 1. The interval time between two pulse is equal to . 5.4. AT+QCFG='urc/ri/other' Ring Line Behavior of Other URCs AT+QCFG='urc/ri/other' specifies the behavior of ring line when other URCs are presented. AT+ QCFG='urc/ri/other' Ring Line Behavior of Other URCs Write Command AT+QCFG='urc/ri/other'[,[,]] Response If configuration parameters are omitted (+QCFG='urc/ri/other'), return current configuration: +QCFG: WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 21 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 'urc/ri/other',,, OK If configuration parameters are entered: OK ERROR Maximum Response Time If error is related to ME functionality: +CME ERROR: 300ms Parameter tel uec tial The behavior of the ring line when URCs are presented 'off' No change. Ring line keeps inactive 'pulse' Pulse. Pulse width determined by Set the width of pulse. Value ranges from 1 to 2000ms and the default is 120ms. This parameter is effect only when is 'pulse'. The count of pulse. This parameter is only meaningful when is 'pulse'. Value ranges from 1 to 5 and default is 1. The interval time between two pulses is equal to . Q en 5.5. AT+QCFG='urc/delay' Delay URC Indication fid AT+QCFG='urc/delay' can delay the output of URC indication until ring line pulse ends. AT+QCFG='urc/delay' Delay URC Indication n Write Command Co AT+QCFG='urc/delay'[,] Response If configuration parameter is omitted: +QCFG: 'urc/delay', OK If configuration parameter is entered: OK ERROR If error is related to ME functionality: +CME ERROR: WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 22 / 27 Reference UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note Parameter 0 1 URC indication will be output when ring line pulse starts URC indication will be output when ring line pulse ends (only the type of ring line is 'pulse', refer to AT+QCFG='urc/ri/ring', AT+QCFG='urc/ri/smsincoming' and AT+QCFG='urc/ri/other') CQouneficdteenl tial WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 23 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 6 Software Mechanism 6.1. Module Power Saving Mechanism There is a lower-priority sleep mission within module, which is used to detect whether module can enter into power saving mode or not. Other service missions (such as RF/USB/UART and so on) and power saving control variables have rights to vote on the power saving mission to decide whether or not the module can enter into power saving mode. When other service missions and power saving control variables both agree module to enter into power saving mode, power saving mission will be executed and l module will enter into power saving mode. It should be noted that when module enters into power saving mode, RF will not be shut down but enter into DRX mode. uecte tial 6.2. Module Power Saving Process Q n Start Service Missions fide QSLCKUSBRF UART and so on Start Power Saving Mission Vote for/against Vote statistics Con Agree/Disagree to No Execute Power Saving Mission Service Missions and Power Saving Control Variables Yes Module enters into Power Saving mode Power Saving mission Figure 6: Module Power Saving Process WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 24 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 6.3. USB Power Saving Mechanism When USB is working normally, root hub in hub or HCD will send SOF package periodically (full speed USB sends one package at an interval of 1ms, high speed USB sends one package at an interval of 125μs). At this time, USB on module will vote against the module entering into power saving mode. According to the description of suspend in USB standard protocol, when the host system sets the port attached with USB device in hub or root hub as suspend, hub or root hub will stop sending SOF package and USB bus will enter into suspend mode. Then USB on module will enter into suspend mode, and vote for the module to enter into power saving mode. NOTES 1. Quectel provides USB suspend solutions of module for different host systems. You can control module to enter into power saving mode on host system by these solutions. l 2. If you use the USB driver developed by your own, the driver should support both global suspend and selective suspend functions. uecte tial 6.4. Module Wakes up Host 6.4.1. Host Wake-up Event Q n Host wake-up event is the event that module takes the initiative to report information to host and wake up e host when host is in sleep mode. Host wakeup event is also called URC. fid 6.4.2. USB Remote Wakeup n When host enters into sleep mode, and host USB bus is in suspend mode, if module has URC to report, it will send remote wakeup signals (duration time>3ms) to inform the host to resume USB. Co The key points of module remote wakeup are listed as follows:  Host USB controller must support remote wakeup, and it can wake up host. If USB controller does not support remote wakeup, it will not process remote wakeup signals received from the module. Similarly, if USB controller cannot wake up the host, then host will not be waked up from sleep mode by USB remote wakeup.  As for host, module’s remote wakeup function can be set by USB standard request. Host can enable remote wakeup function by 'SET_FEATURE' and disable it by 'CLEAR_FEATURE'. Before host enters into sleep mode, module’s remote wakeup function must be enabled. WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 25 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note  When module sends remote wakeup signals to host, host must keep resume signals for at least 20ms. After that, USB bus will enter into idle state. And before USB bus enters into idle state, USB controller must retrieve to send SOF package on USB bus within 3s. Otherwise, the module would enter into suspend mode again. CQouneficdteenl tial WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 26 / 27 UMTS/HSPA Module Series WCDMA UGxx Power Management Application Note 7 Appendix A Reference Table 2: Terms and Abbreviations Abbreviation Description USB URC DRX I/O Universal Serial Bus Unsolicited Result Code Discontinuous Reception CQouneficdteenl tial Input/output WCDMA_UGxx_Power_Management_Application_Note Confidential / Released 27 / 27

WCDMA UGxx Backup And Restore NVRAM User Guide UMTS/HSPA Module Series Rev. WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide_V1.2 Date: 2015-04-01 www.quectel.com UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 1 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide About the Document History Revision 1.0 1.1 1.2 Date 2014-12-24 l 2015-03-04 CQouneficdteential 2015-04-01 Author Alan WANG Alan WANG Alan WANG Description Initial Changed the document name from 'UG95' to 'UGxx'. Updated applicable modules. WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 2 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Figure Index ................................................................................................................................................. 4 1 Introduction .......................................................................................................................................... 5 2 Preparation ........................................................................................................................................... 6 3 NV Backup Procedure ......................................................................................................................... 7 4 Firmware Upgrading Procedure ....................................................................................................... 10 5 6 7 NV Restoring Procedure ................................................................................................................... 11 IMEI Rewriting Procedure ................................................................................................................. 12 CQouneficdteenl tial Recommended Parameters Validating Procedure.........................................................................13 WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 3 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide Figure Index FIGURE 1: UPDATE INFO .................................................................................................................................. 7 FIGURE 2: NVM_EDITOR_GTI .......................................................................................................................... 8 FIGURE 3: BACKUP FILE................................................................................................................................... 9 FIGURE 4: NV_FILE............................................................................................................................................ 9 FIGURE 5: LOAD FILE.......................................................................................................................................11 FIGURE 6: REWRITE IMEI ............................................................................................................................... 12 CQouneficdteenl tial WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 4 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide 1 Introduction When upgrading UGxx firmware to a newer firmware, RF calibration, IMEI and other important data will be lost, thus making the module fails to register to network. This document describes how to backup and restore these parameters when updating the firmware. The main procedure is shown as below: Step 1: Backup the parameters. Step 2: Upgrade the firmware. Step 3: Restore the RF calibration data via backup files and rewrite the IMEI by Phone Tool. CQouneficdteenl tial This document is applicable to UGxx modules. WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 5 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide 2 Preparation The following preparations are needed before backing up and restoring NVRAM: 1. Install Phone Tool via 'PhoneTool_setup.exe'. 2. Install UGxx USB driver. CQouneficdteenl tial WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 6 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide 3 NV Backup Procedure 1. Connect the module to PC with USB or Main UART port, then power on the module. 2. Open Phone Tool, as shown in Figure 1. 3. Choose Modem or UART port in the red box (Some Phone Tools may not need to select the UART or Modem port). Then click the button 'Update Info'. If operating successfully, the Target Details will CQouneficdteenl tial displaythemoduleinformationasbelow. Figure 1: Update Info 4. Choose the 'Modes ->NVM_Editor_GTI' in the menu bar, a new interface will be popped up, as shown in Figure 2 & 3. WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 7 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide CQouneficdteenl tial Figure2:NVM_Editor_GTI WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 8 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide Queficdteenl tial Figure3:BackupFile n 5. Keep 'Parameter Filter' as null and select all NVM groups. o 6. Click the button 'Read Groups', after reading, click the button 'Save File' to save the file and edit C the file name, shown as below. Figure 4: NV_FILE WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 9 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide 4 Firmware Upgrading Procedure Upgrade the firmware by QFlash Tool. About the details, please refer to Quectel_QFlash_User_Guide. CQouneficdteenl tial WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 10 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide 5 NV Restoring Procedure 1. Firstly, enter the NVM Editor GTI via Phone Tool. Please refer to the Chapter 3 for detailed steps. 2. Click the button 'Load File' in the Figure 3, and choose the file to be loaded, as shown in Figure 5. CQouneficdteenl tial Figure5:LoadFile 3. Click the button 'Write Groups' in the Figure 3. During this step, there may be some errors reported, please ignore them. 4. Click the button 'Commit Groups', and then wait for the tool to finish the restoring process. WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 11 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide 6 IMEI Rewriting Procedure 1. Choose the 'Modes ->security' in the menu bar of Phone Tool, as shown in Figure 6. Queficdteenl tial Figure6:RewriteIMEI n 2. Click 'Program default IMEIs and SimLocks', and input IMEI in '14 digit IMEI', then click the Co button 'Program'. NOTE You can get the module’s IMEI value with command 'AT+GSN'. WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 12 / 13 UMTS/HSPA Module Series WCDMA UGxx Backup And Restore NVRAM User Guide 7 Recommended Parameters Validating Procedure After restoring NV and rewriting IMEI, it is necessary to reboot the module and validate the parameters. The recommended validating procedure is shown as below: 1. Reboot module. 2. Query the network registration status by executing the 'AT+CREG?'. 3. Query the GPRS network registration status by executing the 'AT+CGREG?'. CQouneficdteenl tial 4. Query the current operators and their status by executing the 'AT+COPS?'. WCDMA_UGxx_Backup_And_Restore_NVRAM_User_Guide Confidential / Released 13 / 13

GSM BT Application Note GSM/GPRS Module Series Rev. GSM_BT_Application_Note_V1.2 Date: 2015-06-25 www.quectel.com GSM/GPRS Module Series GSM BT Application Note Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Mail: info@quectel.com Or our local office, for more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or Email: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2015. All rights reserved. GSM_BT_Application_Note Confidential / Released 1 / 47 GSM/GPRS Module Series GSM BT Application Note About the Document History Revision Date 1.0 2015-01-13 tel 1.1 2015-03-13 CQouneficdential 1.2 2015-06-25 Author Victor CHEN Victor CHEN Hyman DING/ Ramos ZHANG Description Initial 1. Added independence description of Bluetooth function in Chapter 1.5 2. Added notes for operation in Chapter 2.1 3. Added pairing mode in Chapter 2.5 4. Added AT+QBTCONND in Chapter 3.2.14 1. Added description of HFG in Chapter 3.2.12-3.2.18 2. Added AT+QBTHFGAUDIO in Chapter 3.2.27 3. Added Transparent Access Mode in SPP profile 4. Added example for Transparent Access Mode 5. Added HFP AT command and example GSM_BT_Application_Note Confidential / Released 2 / 47 GSM/GPRS Module Series GSM BT Application Note Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 6 1 Introduction .......................................................................................................................................... 7 1.1. General Introduction................................................................................................................ 7 1.2. BT Profiles ............................................................................................................................... 7 1.3. BT Address .............................................................................................................................. 7 1.4. AT Interface for BT Function ................................................................................................... 8 1.5. Independence of BT................................................................................................................ 8 2 BT Operation ........................................................................................................................................ 9 2.1. Notes for Operation............................................................................................................... 10 2.1.1. Number of Searched Devices ..................................................................................... 10 2.1.2. Number of Paired Devices .......................................................................................... 10 l 2.1.3. Special Function .......................................................................................................... 10 te 2.2. Power On/Off......................................................................................................................... 10 2.3. Attribution Configurations...................................................................................................... 11 c l 2.3.1. Change BT Name........................................................................................................ 11 2.3.2. Set BT Visibility............................................................................................................ 11 ue tia 2.3.3. Read Address.............................................................................................................. 11 2.4. Scan BT Devices................................................................................................................... 11 2.4.1. Scan until Timeout....................................................................................................... 12 Q n 2.4.2. Cancel Scan ................................................................................................................ 12 e 2.5. Pair/Unpair BT Device........................................................................................................... 12 2.5.1. Originated Pair SSP (Numeric Compare Mode) ......................................................... 13 fid 2.5.2. Originated Pair PINCODE........................................................................................... 13 2.5.3. Terminated Pair SSP (Numeric Compare Mode) ........................................................ 13 2.5.4. Terminated Pairing PINCODE..................................................................................... 14 n 2.5.5. Unpair BT Device ........................................................................................................ 14 2.6. Get the Supported Profile ..................................................................................................... 14 o 2.7. Connect/Disconnect .............................................................................................................. 14 C 2.7.1. SPP Connect/Disconnect ............................................................................................ 15 2.7.1.1. Initiate Connection (Buffer Access Mode) ....................................................... 15 2.7.1.2. Initiate Connection (AT Command Mode) ....................................................... 15 2.7.1.3. Initiate Connection (Transparent Access Mode) ............................................. 15 2.7.1.4. Accept Connection (Buffer Access Mode)....................................................... 15 2.7.1.5. Accept Connection (AT Command Mode)....................................................... 16 2.7.1.6. Accept Connection (Transparent Access Mode) ............................................. 16 2.7.1.7. Initiate Disconnection (Buffer Access Mode and AT Command Mode) .......... 16 2.7.1.8. Initiate Disconnection (Transparent Access Mode)......................................... 16 2.7.1.9. Disconnect Indication (Buffer Access Mode and AT Command Mode) .......... 17 2.7.1.10. Disconnect Indication (Transparent Access Mode)......................................... 17 GSM_BT_Application_Note Confidential / Released 3 / 47 GSM/GPRS Module Series GSM BT Application Note 2.7.2. HFP Connect /Disconnect ........................................................................................... 17 2.7.2.1. Initiate Connection with HF Device ................................................................. 17 2.7.2.2. Initiate Connection with AG Device ................................................................. 17 2.7.2.3. Accept Connection .......................................................................................... 17 2.7.2.4. Initiate Disconnection with HF Device ............................................................. 18 2.7.2.5. Disconnect Indication with HF Device............................................................. 18 2.7.2.6. Disconnect Indication with AG device ............................................................. 18 2.7.3. Use BT Device Address to Connect SPP Directly ...................................................... 18 2.8. Query the Device Status Information .................................................................................... 19 2.9. SPP AT Command Mode ...................................................................................................... 20 2.10. SPP Buffer Access Mode ...................................................................................................... 20 2.10.1. Read Data ................................................................................................................... 20 3 2.10.2. Send Data.................................................................................................................... 21 2.11. SPP Transparent Access Mode ............................................................................................ 21 2.12. HFP Connection .................................................................................................................... 23 2.12.1. Module Acts as AG Device .......................................................................................... 23 l 2.12.2. Module Acts as HF Device .......................................................................................... 24 te BT Commands Description............................................................................................................... 25 3.1. AT Command Syntax ............................................................................................................ 25 c l 3.2. Description of AT Command ................................................................................................. 25 3.2.1. AT+QBTPWR Power On/Off BT ............................................................................... 25 ue tia 3.2.2. AT+QBTNAME Read/Write BT Device Local Name ................................................26 3.2.3. AT+QBTADDR Read BT Device Local Address....................................................... 27 3.2.4. AT+QBTVISB Set BT Visibility.................................................................................. 27 Q n 3.2.5. AT+QBTSCAN Scan BT Devices ............................................................................. 28 3.2.6. AT+QBTSCANC Stop Scanning............................................................................... 30 e 3.2.7. AT+QBTPAIR Pair BT Device................................................................................... 30 fid 3.2.8. +QBTIND: 'pair' Pairing Indication........................................................................... 30 3.2.9. AT+QBTPAIRCNF Pair Confirmation ....................................................................... 31 3.2.10. AT+QBTUNPAIR Delete Paired BT Device.............................................................. 32 3.2.11. AT+QBTSTATE Query the Device Status................................................................. 32 n 3.2.12. AT+QBTGPROF Get the Supported Profile ............................................................. 33 o 3.2.13. AT+QBTCONN Connect BT Device ......................................................................... 34 C 3.2.14. AT+QBTCONND Use BT Device Address to Connect SPP Directly ....................... 35 3.2.15. +QBTIND: 'conn' Connecting Indication.................................................................. 37 3.2.16. AT+QBTACPT Accept Connection ........................................................................... 37 3.2.17. AT+QBTDISCONN Disconnect ................................................................................ 38 3.2.18. +QBTIND: 'disc' Disconnect Indication ................................................................... 39 3.2.19. AT+QSPPSEND Send Data ..................................................................................... 39 3.2.20. AT+QSPPREAD Read Data ..................................................................................... 41 3.2.21. +QBTIND: 'recv' Incoming Data Indication.............................................................. 42 3.2.22. +QBTIND: 'ring' Call Indication................................................................................ 42 3.2.23. AT+QBTATA Answer Incoming Call.......................................................................... 43 3.2.24. AT+QBTATH Hung up Voice Call ............................................................................. 43 GSM_BT_Application_Note Confidential / Released 4 / 47 GSM/GPRS Module Series GSM BT Application Note 3.2.25. 3.2.26. 3.2.27. AT+QBTATD Dial Voice Call ..................................................................................... 43 AT+QBTATDL Redial Last Phone Number............................................................... 43 AT+QBTHFGAUDIO Select Audio Output Path While Connecting with HFG Device................................................................................... 44 4 Appendix A Reference....................................................................................................................... 45 5 Appendix B Summary of ............................................................................................. 46 CQouneficdteenl tial GSM_BT_Application_Note Confidential / Released 5 / 47 GSM/GPRS Module Series GSM BT Application Note Table Index TABLE 1: RELATED DOCUMENTS .................................................................................................................. 45 TABLE 2: TERMS AND ABBREVIATIONS ........................................................................................................ 45 TABLE 3: DIFFERENT CODING SCHEMES OF +CME ERROR: ....................................... 46 CQouneficdteenl tial GSM_BT_Application_Note Confidential / Released 6 / 47 GSM/GPRS Module Series GSM BT Application Note 1 Introduction This document mainly introduces how to use the BT (Bluetooth) function of Quectel standard module. This document is applicable to Quectel M26 module. 1.1. General Introduction BT is a proprietary open wireless technology standard for exchanging data over short distances (using l short-wavelength radio transmissions in ISM band from 2400-2480MHz) from fixed and mobile devices, creating personal area networks with high levels of security. BT was standardized as IEEE802.15.1. And te Quectel modules support BT3.0. uec tial 1.2. BTProfiles Q n To use BT wireless technology, a device must be able to interpret certain BT profiles. BT profiles are definitions of possible applications and specify general behavior that BT enables devices to communicate e with other BT devices. There is a wide range of BT profiles describing many different types of applications or use cases for devices. Through the guidance provided by the BT specification, you can create fid applications to work with other BT devices. Besides of all profiles, there are four basic ones: GAP, SDAP, SPP and GOEP profiles. Quectel modules support SPP and HFP. Con 1.3. BT Address Each BT transceiver is allocated with a unique 48-bit BT device address. This address is derived from the IEEE802 standard. This 48-bit address is divided into three fields:  LAP field: lower address consisting of 24 bits  UAP field: upper address consisting of 8 bits  NAP field: non-significant address consisting of 16 bits The LAP and UAP indicates the significant address of the BT device address. Quectel module with BT function will specify an address before it leaves the factory. GSM_BT_Application_Note Confidential / Released 7 / 47 GSM/GPRS Module Series GSM BT Application Note 1.4. AT Interface for BT Function As module solution, we provide a set of AT commands to support basic BT operations, including scanning, pairing, connecting and so on. Our modules support SPP, HFP profile. The SPP profile could be used to communicate between module and others BT device via serial port. And through the HFP profile, the module can act as a HF (Hands-Free Unit) device or AG (Audio Gateway) device. 1.5. Independence of BT CQouneficdteenl tial The Bluetooth function could work without SIM card or in flight mode (AT+CFUN=0/4). GSM_BT_Application_Note Confidential / Released 8 / 47 GSM/GPRS Module Series GSM BT Application Note 2 BT Operation To operate BT function, you should connect the module to a BT device, and turn on BT power by AT commands. The first time using BT device on Quectel module, you need to scan and pair the device with module to ensure the BT device is connected successfully. The following figure shows the detailed operation of BT (SPP profile) by AT commands as an example. External equipment Turn on BT AT+QBTPWR=1 OK Module tel scan AT+QBTSCAN OK +QBTSCAN:1,'BILLHE-PC',065C3A2F40F0 +QBTSCAN:2,'MTKBTDEVICE',8362618A0568 +QBTSCAN:0 uec tial pair AT+QBTPAIR=2 +QBTPAIR: 'MTKBTDEVICE',8362618A0568, 138949 AT+QBTPAIRCNF=1 OK +QBTPAIRCNF:1,1,1,'MTKBTDEVICE',8362618A0568 Q n Check supported profile e (this steps is not necessary) AT+QBTGPROF=1 +QBTGPORF:0,'SPP' +QBTGPORF:3,'OBEX_OBJECT_PUSH_SERVICE' OK fid connect Con Check status AT+QBTCONN=1,0,1 OK +QBTCONN:,,,, AT+QBTSTATE +QBTSTATE:5 +QBTSTATE: 0,1,'MTKBTDEVICE',8362618A0568 +QBTSTATE: 1,1,'MTKBTDEVICE',8362618A0568,'SPP' OK SPP write AT+QSPPSEND=1,10 > 1234567890 OK SPP read +QBTIND: 'recv',1 AT+QSPPREAD=1,1500 +QSPPREAD: 1500 11………xx OK Figure 1: BT (SPP profile) Operation Flow Chat GSM_BT_Application_Note Confidential / Released 9 / 47 GSM/GPRS Module Series GSM BT Application Note 2.1. Notes for Operation 2.1.1. Number of Searched Devices The max number of searched devices is 20 in a single scanning process. 2.1.2. Number of Paired Devices The max number of paired devices stored in your device is 10. If you want to continue to pair new device after the space was full, you must remove the paired devices to free the storage space (by command 'AT+QBTUNPAIR='). 2.1.3. Special Function If you want to use other BT device address and the password (PINCODE Pair) to connect SPP directly l without scanning (pairing process will work internally), you can use the command 'AT+QBTCONND=[,[,]]'. Refer to Chapter 2.7.3 to get more details. uecte tial 2.2. PowerOn/Off To use the BT function, you must power on BT device first. Q n AT+QBTPWR=1 e OK fid AT+QBTPWR? +QBTPWR: 1 //Power on BT device //Check power status //BT device is powered on OK Con Turn off BT device if not used. AT+QBTPWR=0 //Power off the BT device. OK NOTE While BT is turned on, the module is visible by other BT devices. To make the module covered, you need to set it as invisible. GSM_BT_Application_Note Confidential / Released 10 / 47 GSM/GPRS Module Series GSM BT Application Note 2.3. Attribution Configurations 2.3.1. Change BT Name You can change the BT name by executing AT+QBTNAME. AT+QBTNAME='MYBTDEVICE' OK AT+QBTNAME? +QBTNAME: 'MYBTDEVICE' OK 2.3.2. Set BT Visibility l AT+QBTVISB=0 OK te AT+QBTVISB=1 OK c l AT+QBTVISB=2,60 ue tia OK +QBTVISB: 0 Q en 2.3.3. Read Address fid AT+QBTADDR? +QBTADDR: A662616202C3 OK Con 2.4. Scan BT Devices //Invisible //Visible forever //Visible for 60 seconds //Visible time out, invisible now The module scans and displays device ID, name and address of all available BT devices around it. If the device you want to pair with is not in the list, ensure that the device is turned on and visible. You could use AT+QBTSCANC to cancel the scan process and AT+QBTSCAN to restart. GSM_BT_Application_Note Confidential / Released 11 / 47 GSM/GPRS Module Series GSM BT Application Note 2.4.1. Scan until Timeout AT+QBTSCAN OK //Start to scan +QBTSCAN: 1,'BILLHE-PC',065C3A2F40F0 +QBTSCAN: 2,'GAOSHENGHAI',8E1F49F4402C +QBTSCAN: 3,'BTDEVICE',8362618A0568 +QBTSCAN: 4,'QUECTEL-RAMOS',0AB6F27D001A +QBTSCAN: 0 //Complete l 2.4.2. Cancel Scan te AT+QBTSCAN OK //Start to scan c l +QBTSCAN: 1,'M26',8362618A0568 ue tia +QBTSCAN: 2,'QUECTEL-RAMOS',0AB6F27D001A Q n AT+QBTSCANC +QBTSCAN: 0 //Cancel scan fide OK n 2.5. Pair/Unpair BT Device Co The visible devices will be shown in the list with the device ID, name and address. AT+QBTSTATE can be used to query the pairing status. You need to select the device scan ID, and use AT+QBTPAIR= and AT+QBTPAIRCNF=1 to pair and confirm it, then pairing result will be shown. After successfully paired, the module will show the paired device ID. You can also use the AT+QBTSTATE to query the pairing status. Meanwhile, pairing information is saved as non-volatile; you only need to pair the device once. GSM_BT_Application_Note Confidential / Released 12 / 47 GSM/GPRS Module Series GSM BT Application Note Currently, Quectel supports two pairing modes:  PINCODE PIN Code pairing requires both sides of Bluetooth devices input matching password (If both of them have input devices), or one inputs matching password while the other automatic confirms it.  SSP--Numeric Compare Mode (6-bit random password comparison) In SSP (Simple Safe Pair) mode, protocol will generate a digital code, and both sides need to confirm the code. This mode is used between devices which have display function and yes/no enabled function, such as mobile phone or module. In a pairing scene, pairing between A and B depends on the matching mode supported by both sides. If A and B both support SSP, then the two sides pairing mode is SSP. If A and B only support PINCODE, or one is SSP, the other is PINCODE, then the pairing mode will be PINCODE. l 2.5.1. Originated Pair SSP (Numeric Compare Mode) te AT+QBTPAIR=2 c l OK //Use the device ID ue tia +QBTPAIR: 'M26',8362618A0568,138949 AT+QBTPAIRCNF=1 OK //Indicate pairing status //Accept pairing Q n +QBTPAIRCNF: 1,1,1,'M26',8362618A0568 //Pairing result fide 2.5.2. Originated Pair PINCODE AT+QBTPAIR=2 n OK o +QBTPAIR: 'M26',8362618A0568 C AT+QBTPAIRCNF=1,'1234' //Indicate pairing status //Accept pairing with password, double quote is required OK +QBTPAIRCNF: 1,1,1,'M26',8362618A0568 //Pairing result 2.5.3. Terminated Pair SSP (Numeric Compare Mode) +QBTIND: 'pair','btd_left',656261222B10,138949 //Indicate pairing status AT+QBTPAIRCNF=1 //Accept pairing OK GSM_BT_Application_Note Confidential / Released 13 / 47 GSM/GPRS Module Series GSM BT Application Note +QBTPAIRCNF: 1,1,1,'btd_left',656261222B10 //Pairing result 2.5.4. Terminated Pairing PINCODE +QBTIND: 'pair','btd_left',656261222B10 AT+QBTPAIRCNF=1,'1234' OK //Indicate pairing status //Accept pairing with password, double quote is required. +QBTPAIRCNF: 1,1,1,'btd_left',656261222B10 //Pairing result 2.5.5. Unpair BT Device You could use the AT+QBTUNPAIR= to unpair the paired BT device according to l device ID. You can also use the AT+QBTSTATE to query the pairing status. te AT+QBTUNPAIR=1 OK //Unpair the paired BT device according to device ID uec tial 2.6. Get the Supported Profile Q n After being paired, you could use the AT+QBTGPROF= to check the profiles provided e by device. fid AT+QBTGPROF=1 +QBTGPROF: 0,'SPP' //1: paired device ID n +QBTGPROF: 3,'OBEX_OBJECT_PUSH_SERVICE' Co +QBTGPROF: 5,'HF_PROFILE' OK 2.7. Connect/Disconnect You can use the AT+QBTCONN=,[,] to connect the BT device with the paired ID, and AT+QBTDISCONN= to disconnect the BT device with the connected ID. You can also use the AT+QBTSTATE to query the connection state. GSM_BT_Application_Note Confidential / Released 14 / 47 GSM/GPRS Module Series GSM BT Application Note 2.7.1. SPP Connect/Disconnect The following examples mainly introduce how to connection/disconnect SPP. 2.7.1.1. Initiate Connection (Buffer Access Mode) AT+QBTCONN=1,0,1 OK //Initiate SPP connection +QBTCONN: 1,1,'btd_left',656261222B10,'SPP' //After connecting successfully, MCU can send and receive data via AT+QSPPSEND or AT+QSPPREAD 2.7.1.2. Initiate Connection (AT Command Mode) tel AT+QBTCONN=1,0,0 OK //Initiate SPP connection uec tial +QBTCONN: 1,1,'btd_left',656261222B10,'SPP' //After connecting successfully, the data sent by the other side of the device will be treated as AT Command (Remote AT) Q en 2.7.1.3. Initiate Connection (Transparent Access Mode) fid AT+QBTCONN=1,0,2 OK //Initiate SPP connection n +QBTCONN: 1,1,'btd_left',656261222B10,'SPP' o CONNECT C //Enter data transparent access mode now. Read and write data directly 2.7.1.4. Accept Connection (Buffer Access Mode) +QBTIND: 'conn','btd_left',656261222B10,'SPP' //Indicate connection state AT+QBTACPT=1,1 //Accept connection OK +QBTACPT: 1, 2,'btd_left',656261222B10,'SPP' //After connecting successfully, MCU can send and GSM_BT_Application_Note Confidential / Released 15 / 47 GSM/GPRS Module Series GSM BT Application Note receive data via AT+QSPPSEND or AT+QSPPREAD 2.7.1.5. Accept Connection (AT Command Mode) +QBTIND: 'conn','btd_left',656261222B10,'SPP' //Indicate connection state AT+QBTACPT=1,0 //Accept connection OK +QBTACPT: 1, 2,'btd_left',656261222B10,'SPP' //After connecting successfully, the data sent by the other side of the device will be treated as AT Command (Remote AT) 2.7.1.6. Accept Connection (Transparent Access Mode) l +QBTIND: 'conn','btd_left',656261222B10,'SPP' //Indicate connection state te AT+QBTACPT=1,2 //Accept connection OK c l +QBTACPT: 1, 2,'btd_left',656261222B10,'SPP' ue tia CONNECT //Enter data transparent access mode now. Read and write data directly Q en 2.7.1.7. Initiate Disconnection (Buffer Access Mode and AT Command Mode) fid AT+QBTDISCONN=2 OK //2: Connected ID Con +QBTDISCONN: 2,1,'btd_left',656261222B10,'SPP' //Disconnecting result 2.7.1.8. Initiate Disconnection (Transparent Access Mode) AT+QBTDISCONN=2 OK //2: Connected ID CLOSED //Exit from the transparent access mode first +QBTDISCONN: 2,1,'btd_left',656261222B10,'SPP' //Disconnecting result GSM_BT_Application_Note Confidential / Released 16 / 47 GSM/GPRS Module Series GSM BT Application Note 2.7.1.9. Disconnect Indication (Buffer Access Mode and AT Command Mode) +QBTIND: 'disc',1,1,'btd_left',656261222B10,'SPP' //URC, Indicate disconnection state 2.7.1.10. Disconnect Indication (Transparent Access Mode) CLOSED //Exit from the transparent access mode +QBTIND: 'disc',1,1,'btd_left',656261222B10,'SPP' //URC, indicate disconnection state 2.7.2. HFP Connect /Disconnect 2.7.2.1. Initiate Connection with HF Device l AT+QBTCONN=4,6 te OK //4: Paired ID; 6: profile ID c l +QBTCONN: 1,0,'Motorola H270',00241C6743E9,'HFG_PROFILE' ue tia 2.7.2.2. Initiate Connection with AG Device Q n AT+QBTCONN=5,5 e OK //5: Paired ID; 5: profile ID fid +QBTCONN: 1,0,'HUAWEI P6-C00',80717A48820B,'HF_PROFILE' n 2.7.2.3. Accept Connection Co When the module works as AG or HF, the other BT device can connect to the module directly without the need of any accept command. +QBTCONN: 1,0,'HUAWEI P6-C00',80717A48820B,'HF_PROFILE' //AG device connected to the module +QBTCONN: 1,0,'Motorola H270',00241C6743E9,'HFG_PROFILE' //HF device connected to the module GSM_BT_Application_Note Confidential / Released 17 / 47 GSM/GPRS Module Series GSM BT Application Note 2.7.2.4. Initiate Disconnection with HF Device AT+QBTDISCONN=0 OK //0: Connected ID +QBTDISCONN: 0,4,'Motorola H270', 00241C6743E9,'HFG_PROFILE' //Disconnecting result 2.7.2.5. Disconnect Indication with HF Device +QBTIND: 'disc',0,4,'Motorola H270',00241C6743E9,'HFG_PROFILE' //URC, indicate disconnection state. 0: connected ID; 4: paired ID. 2.7.2.6. Disconnect Indication with AG device tel +QBTIND: 'disc',0,5,'HUAWEI P6-C00',80717A48820B,'HF_PROFILE' //URC, indicate disconnection state. 0: connected ID; 5: paired ID. uec tial 2.7.3. Use BT Device Address to Connect SPP Directly If you want to use the other BT device address and the password (PINCODE Pair) to connect SPP directly, Q n you can use the command AT+QBTCONND=[,[,]]. e //After BT is powered on, you can send the AT Command directly. fid AT+QBTCONND=00025BB3A978,1,'0000' //SPP connect buffer access mode. +QBTPAIR: 00025BB3A978,'MPT-II',0 //First time to connect n +QBTPAIRCNF: 1,2,1,'MPT-II',00025BB3A978 Co +QBTCONN: 1,1,'MPT-II',00025BB3A978,'SPP' //Connected successfully OK AT+QSPPSEND=1,94 //Send data to print > !'#$%&'()*+,-./0123456789:;?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[]^_`abcdefghijklmnopqr stuvwxyz{|}~ OK AT+QBTDISCONN //In this condition, you can use this AT command without connected ID GSM_BT_Application_Note Confidential / Released 18 / 47 GSM/GPRS Module Series GSM BT Application Note OK +QBTDISCONN: 1,1,'MPT-II',B3A9785B0002,'SPP' //SPP connected as transparent access mode directly AT+QBTCONND=F0728C0D50AE,2 OK +QBTCONN: 1,1,'GT-e',F0728C0D50AE,'SPP' CONNECT //Enter transparent access mode xxxxxxxxxxxxxxxxxxxxxxxx //Receive data from remote BT device +++ OK l ATO te CONNECT //Send '+++' to exit from transparent access mode //Exit from the transparent access mode, but do not disconnect //ATO command enter the transparent mode //Enter the transparent mode again c l NOTES ue tia 1. There is no need to scan and pair. 2. This connection can only be used for SPP connection. Q en 2.8. Query the Device Status Information fid You could use the AT+QBTSTATE to get the working, pairing and connecting information. Pairing information is non-volatile. You can also use this command to query whether the device has been paired n before. If so, you can directly use the paired information to connect to the device. Meanwhile, you can use this command to check the connection status. Co AT+QBTSTATE +QBTSTATE: 5 +QBTSTATE: 0,1,'M26',8362618A0568 +QBTSTATE: 1,1,'M26',8362618A0568,'SPP' OK GSM_BT_Application_Note Confidential / Released 19 / 47 GSM/GPRS Module Series GSM BT Application Note 2.9. SPP AT Command Mode In AT command mode, the SPP data sent to module will be treated as AT Command (Remote AT) +QBTIND: 'conn','GT-eeeee',F0728C0D50AE,'SPP' AT+QBTACPT=1,0 //Connected as AT command mode OK +QBTCONN: 1,2,'GT-eeeee',F0728C0D50AE,'SPP' //Remote device: ATI ATI Quectel_Ltd Quectel_M26 l Revision: M26FAR01A04 te OK uec tial 2.10. SPP Buffer Access Mode In buffer mode, the SPP data will be buffered. URC will be reported to notify the data arriving. Command Q n is also provided to send and read the SPP data. fide 2.10.1. Read Data In buffer access mode, after receiving data, the module will report URC as +QBTIND: 'recv', to notify the host. Then host can retrieve data by AT+QSPPREAD=,. Notes: if the buffer is not empty, and the module receives data again, it will not report a o new URC until all the received data has been retrieved by AT+QSPPREAD=, from buffer. +QBTIND: 'recv',1 AT+QSPPREAD=1,1500 +QSPPREAD: 1500 11………xx //=1 receives data notification //Read data from =1, max length is 1500 bytes //Read 1500 bytes OK AT+QSPPREAD=1,1500 +QSPPREAD: 500 11………xx //Continue to read //Only 500 GSM_BT_Application_Note Confidential / Released 20 / 47 GSM/GPRS Module Series GSM BT Application Note OK AT+QSPPREAD=1,1500 +QSPPREAD: 0 OK //Continue to read //The buffer is empty, all data has been read out 2.10.2. Send Data AT+QSPPSEND=1,10 //Send 10 bytes to =1 >1234567890 OK AT+QSPPSEND=1,0 +QSPPSEND: 10,10,0 //Query the sent and unacknowledged data OK tel …… AT+QSPPSEND=1,800 c l >1234567890xxxxx… ue tia +CMEERROR:8020 //Send 800 bytes to =1 //The buffer is full and the 800 bytes not send. You can send the data when the buffer has enough space //When the buffer has enough space, you can send the data again Q n AT+QSPPSEND=1,200 >1234567890xxxxx… e OK fid 2.11. SPP Transparent Access Mode on In transparent access mode, the corresponding UART port enters into the exclusive mode. The data C received from UART port will be sent to BT directly, and the received data from BT will be outputted to UART port directly as well. '+++' is used to exit from transparent access mode. When '+++' returns OK, the module will be switched to buffer access mode. ATO can be used to return back to transparent access mode. Note: In transparent mode, host cannot execute AT command. If the BT connection is closed, the module will report CLOSED and exit from the transparent access mode. You can use '+++' or DTR (AT&D1 should be set) to exit from the transparent access mode. To prevent the '+++' from being misinterpreted as data, you should comply with the following sequence: 1) Do not input any character within T1 time (1 second) before inputting '+++'. 2) Input '+++', time gap between each '+' cannot be longer than 20ms, and no other characters can GSM_BT_Application_Note Confidential / Released 21 / 47 GSM/GPRS Module Series GSM BT Application Note be inputted during this time. 3) Do not input any character within T1 time (1 second) after '+++' has been inputted. 4) Exit from transparent access mode, return OK. ATO will change the access mode of connection which exits from transparent access mode lately. If it enters into transparent access mode successfully, CONNECT will be returned. If there is no connection enters into transparent access mode before, ATO will return NO CARRIET. AT+QBTCONN=1,0,2 OK //Connect to the paired device 1, with transparent access mode +QBTCONN: 1,1,'GT-e',F0728C0D50AE,'SPP' CONNECT Aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa //Enter into transparent access mode //Received data from remote BT l +++ te OK c l ATO ue tia CONNECT Bbbbbbbbbbbbbbbbbbb CLOSED //Send '+++' to exit from transparent access mode //Exit from the transparent access mode, but do not disconnect //ATO command enter the transparent mode //Enter the transparent mode again //Received data //Disconnect passively Q n +QBTIND: 'disc',1,1,'GT-e',F0728C0D50AE,'SPP' e /*********************** accept connect ***************************************/ fid +QBTIND: 'conn','GT-e',F0728C0D50AE,'SPP' AT+QBTACPT=1,2 //Accept connection, with transparent access mode OK n +QBTACPT: 1,2,'GT-e',F0728C0D50AE,'SPP' //URC connect successfully Co CONNECT //Transparent access mode +++ //Input '+++' OK //Exit from transparent access mode ATO //ATO command CONNECT //Enter transparent access mode again +++ //Input '+++' OK //Exit from transparent access mode AT+QBTDISCONN=2 //Disconnection initiatively OK GSM_BT_Application_Note Confidential / Released 22 / 47 CLOSED +QBTDISCONN: 2,1,'GT-e',F0728C0D50AE,'SPP' GSM/GPRS Module Series GSM BT Application Note 2.12. HFP Connection 2.12.1. Module Acts as AG Device Quectel module supports HFP profile, the following connection sequence shows how the module acts as an AG device. //Connect to the Bluetooth headset first. AT+QBTSCAN OK l +QBTSCAN: 1,'Motorola H270',00241C6743E9 te AT+QBTSCANC +QBTSCAN: 0 //Found the Bluetooth headset //Stop scanning uec tial OK AT+QBTPAIR=1 OK //Pairing Q n +QBTPAIRCNF: 1,1,0,'Motorola H270',00241C6743E9 e AT+QBTCONN=1,6 OK //Paired successfully //Connect HFG profile fid +QBTCONN: 1,1,'A16S',00241C6743E9,'HFG_PROFILE' //Connected successfully n //If the Bluetooth headset has been paired with the module. Turn on the Bluetooth headset, it will connect Co to the module automatically. +QBTCONN: 1,1,'A16S',00241C6743E9,'HFG_PROFILE' //Connect to the module automatically //When the Bluetooth headset is connected to the module, the speech voice will output by the Bluetooth headset. And you can set the speech voice output path by AT+QBTHFGAUDIO. AT+QBTHFGAUDIO=1 OK //Speech voice output from module side AT+QBTHFGAUDIO=0 OK //Speech voice output from HF device side GSM_BT_Application_Note Confidential / Released 23 / 47 GSM/GPRS Module Series GSM BT Application Note 2.12.2. Module Acts as HF Device The following connection sequence shows how the module acts as a HF device. AT+QBTSCAN OK +QBTSCAN: 1,'GT-e',F0728C0D50AE AT+QBTSCANC +QBTSCAN: 0 //Found the phone device //Stop scanning OK AT+QBTPAIR=1 OK //Pairing +QBTPAIR: 'GT-e',F0728C0D50AE,348531 l AT+QBTPAIRCNF=1 OK te +QBTPAIRCNF: 1,1,1,'GT-e',F0728C0D50AE c l AT+QBTCONN=1,5 //Connect HF profile, module acts as a hand free device ue tia OK +QBTCONN: 1,1,'GT-e',F0728C0D50AE,'HF_PROFILE' //Connected successfully Q n //After connecting to AG device, you can use the following command to control the AG device (phone) e AT+QBTATD=10086 OK //Call the 10086 fid +QBTIND: 'ring',1,1,10086 n +QBTIND: 'ring',4,1,10086 o AT+QBTATH C OK //Hung up voice call +QBTIND: 'ring',0,1,10086 //When a call is coming, the following URC will be output +QBTIND: 'ring',2,1,055165869386 AT+QBTATA OK //A call is coming //Answer the call GSM_BT_Application_Note Confidential / Released 24 / 47 GSM/GPRS Module Series GSM BT Application Note 3 BT Commands Description 3.1. AT Command Syntax Test Command AT+=? This command returns the list of parameters and value ranges set by the corresponding Write Command or internal processes. Read Command Write Command l Execution Command AT+? This command returns the currently set value of the parameter or parameters. AT+= This command sets the user-definable parameter values. AT+ This command reads non-variable parameters affected by internal processes in the GSM engine. cte l 3.2. Description of AT Command ue tia 3.2.1. AT+QBTPWR Power On/Off BT Q n AT+QBTPWR Power On/Off BT e Test Command fid AT+QBTPWR=? Response +QBTPWR: (list of supported s) n Read Command AT+QBTPWR? OK Response +QBTPWR: Co OK +CME ERROR: 100 Write Command Response AT+QBTPWR= OK +CME ERROR: 100 Parameter 0 Off 1 On GSM_BT_Application_Note Confidential / Released 25 / 47 GSM/GPRS Module Series GSM BT Application Note 0 1 Power off Power on Example AT+QBTPWR=1 OK //Power on BT 3.2.2. AT+QBTNAME Read/Write BT Device Local Name AT+QBTNAME Read/Write BT Device Local Name Test Command AT+QBTNAME=? Read Command l AT+QBTNAME? cte l WriteCommand ue tia AT+QBTNAME= Response OK ERROR Response +QBTNAME: OK +CME ERROR: Response OK +CME ERROR: Q n Parameter fide String type, device name n NOTE Co Max length of the device name is 54 bytes. Example AT+QBTNAME? +QBTNAME: 'MYBTDEVICE' OK GSM_BT_Application_Note Confidential / Released 26 / 47 GSM/GPRS Module Series GSM BT Application Note 3.2.3. AT+QBTADDR Read BT Device Local Address AT+QBTADDR Read BT Device Local Address Test Command AT+QBTADDR=? Read Command AT+QBTADDR? Response OK ERROR Response +QBTADDR: OK +CME ERROR: Parameter l Device address (e.g.: A662616202C3, means: LAP: 0xA66261, UAP: 0x62, NAP: 0x02c3) cte l Example AT+QBTADDR? ue tia +QBTADDR:A662616202C3 OK Q en 3.2.4. AT+QBTVISB Set BT Visibility fid AT+QBTVISB Set BT Visibility Test Command on AT+QBTVISB=? Response +QBTVISB: (list of supported s),( list of supported s) C OK Read Command Response AT+QBTVISB? +QBTVISB: Write Command AT+QBTVISB=[,] OK +CME ERROR: Response OK +CME ERROR: GSM_BT_Application_Note Confidential / Released 27 / 47 GSM/GPRS Module Series GSM BT Application Note If =2, response: OK +QBTVISB: 0 Parameter 0 Invisible 1 Visible forever 2 Visibility temporary on, can be discovered by other BT device for some time Integer type, visible time, unit: second 1-255 Visible timer Example AT+QBTVISB=0 l OK te AT+QBTVISB=1 OK c l AT+QBTVISB=2,60 OK ue tia +QBTVISB:0 //Invisible //Become invisible after time out Q n 3.2.5. AT+QBTSCAN Scan BT Devices fide AT+QBTSCAN Scan BT Devices Test Command n AT+QBTSCAN=? Response +QBTSCAN: (list of supported s),(list of supported s),(list of supported s) Co Read Command OK Response AT+QBTSCAN? +QBTSCAN: ,, Write Command AT+QBTSCAN=[,[,]] OK +CME ERROR: Response OK +QBTSCAN: ,, … +QBTSCAN: 0[,] GSM_BT_Application_Note Confidential / Released 28 / 47 GSM/GPRS Module Series GSM BT Application Note Execute Command AT+QBTSCAN +CME ERROR: Response OK +QBTSCAN: ,, … +QBTSCAN: 0[,] +CME ERROR: Parameter l te c l 1-255 The max number of seconds for searching. Default value: 60 (s) 0 Search completed 1-20 Assign an ID for searched device 1-20 The max number of device allowed to search 0-255 The Class of Device/Service (CoD). Refer to BT specification for details String type, device name Device address Refer to Chapter 5 ue tia Example Q n AT+QBTSCAN=60,10,0 OK e +QBTSCAN: 1,'BILLHE-PC',065C3A2F40F0 fid +QBTSCAN: 2,'bt_dev1',016261E65467 n +QBTSCAN: 3,'2233',326261926A88 o AT+QBTSCANC C +QBTSCAN: 0 OK AT+QBTSCAN? +QBTSCAN: 60,10,0 OK GSM_BT_Application_Note Confidential / Released 29 / 47 GSM/GPRS Module Series GSM BT Application Note 3.2.6. AT+QBTSCANC Stop Scanning AT+QBTSCANC Stop Scanning Execute Command AT+QBTSCANC Response OK +CME ERROR: 3.2.7. AT+QBTPAIR Pair BT Device AT+QBTPAIR Pair BT Device Test Command AT+QBTPAIR=? Response +QBTPAIR: (list of supported s) l Write Command te AT+QBTPAIR= OK Response OK c l +QBTPAIR: , [,] +CME ERROR: ue tia Parameter Q n e fid Searched device ID, range: 1-20 String type, device name Device address The 6 bytes random password in Numeric Compare Mode n 3.2.8. +QBTIND: 'pair' Pairing Indication Co +QBTIND: 'pair' Pairing Indication +QBTIND: 'pair',, [,] Parameter String type, device name Device address The 6 bytes random password in Numeric Compare Mode GSM_BT_Application_Note Confidential / Released 30 / 47 GSM/GPRS Module Series GSM BT Application Note NOTE When receiving a pairing indication:  Use AT+QBTPAIRCNF=1 command without passkey if there is a parameter  Use AT+QBTPAIRCNF=1, command with passkey if there is no parameter. 3.2.9. AT+QBTPAIRCNF Pair Confirmation AT+QBTPAIRCNF Pair Confirmation Test Command Response AT+QBTPAIRCNF=? +QBTPAIRCNF: (list of supported s), (list of supported s) l Write Command uecte tial AT+QBTPAIRCNF=[,] OK Response OK +QBTPAIRCNF: ,,, , +CME ERROR: Parameter Q n fide n Co 0 Reject pairing 1 Accept pairing String type, passkey, 4 bytes 0 Failed 1 Success 1-10 The allocated paired device ID Whether it is the first time to pair 0 No 1 Yes String type, device name Device address String type, passkey, 4 bytes GSM_BT_Application_Note Confidential / Released 31 / 47 GSM/GPRS Module Series GSM BT Application Note 3.2.10. AT+QBTUNPAIR Delete Paired BT Device AT+QBTUNPAIR Delete Paired BT Device Test Command AT+QBTUNPAIR=? Response +QBTUNPAIR: (list of supporteds) Write Command AT+QBTUNPAIR= OK Response OK +CME ERROR: Parameter 1-10 Paired device ID tel 3.2.11. AT+QBTSTATE Query the Device Status c l AT+QBTSTATE Query the Device Status ue tia TestCommand AT+QBTSTATE=? Response +QBTSTATE: (list of supported s) Q en Execute Command Confid AT+QBTSTATE OK Response +QBTSTATE: +QBTSTATE: 0, ,, … +QBTSTATE: 1, ,,, … OK +CME ERROR: Parameter 0 Initial on 1 Deactivating 2 Activating 5 Idle 6 Scanning GSM_BT_Application_Note Confidential / Released 32 / 47 GSM/GPRS Module Series GSM BT Application Note 7 Scan result indication 8 Scan cancelling 9 Initiate pairing 12 Connecting 13 Un-pairing 14 Deleting paired device 15 Deleting all 16 Disconnecting 19 Numeric confirm 20 Numeric confirm response 25 Connect accept confirm indication 26 Service refreshing l te Quec ential 29 Device name setting 30 Authentication setting 31 Release all connection 36 Activating profiles 1-10 Paired device ID 0-2 Connected device ID String type, device name Device address String type, profile name 'SPP' 'OBEX_PBA_PROFILE_CLIENT' 'OBEX_PBA_PROFILE' 'OBEX_OBJECT_PUSH_SERVICE' 'OBEX_OBJECT_PUSH_CLIENT' 'HF_PROFILE' 'HFG_PROFILE' fid 3.2.12. AT+QBTGPROF Get the Supported Profile on AT+QBTGPROF Get the Supported Profile C Test Command Response AT+QBTGPROF=? OK ERROR Write Command Response AT+QBTGPROF= +QBTGPROF: , … OK +CME ERROR: GSM_BT_Application_Note Confidential / Released 33 / 47 GSM/GPRS Module Series GSM BT Application Note Parameter 1-10 Paired device ID 0 'SPP',0x1101 1 'OBEX_PBA_PROFILE_CLIENT',0x112E 2 'OBEX_PBA_PROFILE',0x112F 3 'OBEX_OBJECT_PUSH_SERVICE',0x1105 4 'OBEX_OBJECT_PUSH_CLIENT',0xfffd 5 'HF_PROFILE',0x111E 6 'HFG_PROFILE',0x111F String type, profile name 'SPP' 'OBEX_PBA_PROFILE_CLIENT' 'OBEX_PBA_PROFILE' 'OBEX_OBJECT_PUSH_SERVICE' 'OBEX_OBJECT_PUSH_CLIENT' l 'HF_PROFILE' 'HFG_PROFILE' cte l NOTE ue tia It returns the profiles supported by both the local device and the other side device. Q n 3.2.13. AT+QBTCONN Connect BT Device fide AT+QBTCONN Connect BT Device Test Command n AT+QBTCONN=? Response +QBTCONN: (list of supported s), (list of supported s), (list of supported s) Co Write Command OK Response AT+QBTCONN=,[,] +QBTCONN: ,,,, +CME ERROR: Parameter 0 Failed 1 Successful GSM_BT_Application_Note Confidential / Released 34 / 47 GSM/GPRS Module Series GSM BT Application Note 1-10 Paired device ID 0 'SPP',0x1101 1 'OBEX_PBA_PROFILE_CLIENT',0x112E 2 'OBEX_PBA_PROFILE',0x112F 3 'OBEX_OBJECT_PUSH_SERVICE',0x1105 4 'OBEX_OBJECT_PUSH_CLIENT',0xfffd 5 'HF_PROFILE',0x111E 6 'HFG_PROFILE',0x111F Used for SPP connection 0 AT command mode 1 Buffer Access Mode 2 Transparent Access Mode uectel tial 0-2 Connected device ID String type, device name Device address String type, profile name 'SPP' 'OBEX_PBA_PROFILE_CLIENT' 'OBEX_PBA_PROFILE' 'OBEX_OBJECT_PUSH_SERVICE' 'OBEX_OBJECT_PUSH_CLIENT' 'HF_PROFILE' 'HFG_PROFILE' Q n NOTE e Quectel does not support to change the mode when SPP is successfully connected. You have to disconnect SPP first. fid 3.2.14. AT+QBTCONND Use BT Device Address to Connect SPP Directly on AT+QBTCONND Use BT Device Address to Connect SPP Directly C Test Command Response AT+QBTCONND=? +QBTCONND: (list of supported s),(list of supported s), (list of supported s), OK Write Command Response AT+QBTCONND=[,[,]] +QBTCONN: ,,,, +CME ERROR: GSM_BT_Application_Note Confidential / Released 35 / 47 GSM/GPRS Module Series GSM BT Application Note Parameter 0 Failed 1 Successful Used for SPP connection 0 AT command mode 1 Buffer Access Mode 2 Transparent Access Mode 0-2 Connected device ID String type, device name Device address, does not need double quotes. Sequence: Nap,UAP,LAP ctel l String type, the password in PINCODE pair, double quotes are required String type, profile name 'SPP' 'OBEX_PBA_PROFILE_CLIENT' 'OBEX_PBA_PROFILE' 'OBEX_OBJECT_PUSH_SERVICE' 'OBEX_OBJECT_PUSH_CLIENT' 'HF_PROFILE' 'HFG_PROFILE' ue tia NOTE Q n Direct SPP connection will only use the Bluetooth address with the sequence NAP-UAP-LAP. 'Originated PINCODE Pair (with password)' or 'Originated Pair SSP (Numeric Compare Mode)' is internally used in e this connection, so you do not need to scan or concern the pairing process. fid Example AT+QBTADDR? n +QBTADDR: 02C362A66261 Co OK AT+QBTCONND=00025BB3A978,1,'0000' +QBTPAIR:00025BB3A978, 'MPT-II',0 //First time to connect +QBTPAIRCNF:1,2,1,'MPT-II',00025BB3A978 +QBTCONN:1,1, 'MPT-II',00025BB3A978,'SPP' //Connected successfully OK AT+QSPPSEND=1,94 > //Send data to print GSM_BT_Application_Note Confidential / Released 36 / 47 GSM/GPRS Module Series GSM BT Application Note !'#$%&'()*+,-./0123456789:;?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[]^_`abcdefghijklmnopqr stuvwxyz{|}~ OK AT+QBTDISCONN OK //In this condition, you can use this AT Command without connected ID. +QBTDISCONN: 1,1,'MPT-II',B3A9785B0002,'SPP' 3.2.15. +QBTIND: 'conn' Connecting Indication +QBTIND: 'conn' Connecting Indication +QBTIND: 'conn',, , l Parameter te String type, device name c l Device address String type, profile name ue tia 'SPP' 'OBEX_PBA_PROFILE_CLIENT' 'OBEX_PBA_PROFILE' Q n 'OBEX_OBJECT_PUSH_SERVICE' e 'OBEX_OBJECT_PUSH_CLIENT' 'HF_PROFILE' fid 'HFG_PROFILE' n 3.2.16. AT+QBTACPT Accept Connection Co AT+QBTACPT Accept Connection Test Command Response AT+QBTACPT=? +QBTACPT: (list of supporteds) Write Command AT+QBTACPT=[,] OK Response OK +QBTACPT: ,,,, +CME ERROR: GSM_BT_Application_Note Confidential / Released 37 / 47 GSM/GPRS Module Series GSM BT Application Note Parameter 0 Reject connection 1 Accept connection 0 Fail 1 Success Used for SPP connection 0 AT command mode 1 Buffer Access Mode 2 Transparent Access Mode 0-2 Connected device ID String type, device name ctel l Device address String type, profile name 'SPP' 'OBEX_PBA_PROFILE_CLIENT' 'OBEX_PBA_PROFILE' 'OBEX_OBJECT_PUSH_SERVICE' 'OBEX_OBJECT_PUSH_CLIENT' 'HF_PROFILE' 'HFG_PROFILE' ue tia 3.2.17. AT+QBTDISCONN Disconnect Q n AT+QBTDISCONN Disconnect e Test Command fid AT+QBTDISCONN=? Response +QBTDISCONN: (list of supporteds) n Write Command Co AT+QBTDISCONN= OK Response OK +QBTDISCONN: ,， ,, +CME ERROR: Parameter Connected device ID. 0 Connection 0 1 Connection 1 2 Connection 2 The paired device ID GSM_BT_Application_Note Confidential / Released 38 / 47 String type, device name Device address String type, profile name 'SPP' 'OBEX_PBA_PROFILE_CLIENT' 'OBEX_PBA_PROFILE' 'OBEX_OBJECT_PUSH_SERVICE' 'OBEX_OBJECT_PUSH_CLIENT' 'HF_PROFILE' 'HFG_PROFILE' GSM/GPRS Module Series GSM BT Application Note 3.2.18. +QBTIND: 'disc' Disconnect Indication +QBTIND: 'disc' Disconnect Indication +QBTIND: 'disc',,,, te , c l Parameter ue tia Q n Confide The device connected id. The paired device ID String type, device name Device address String type, profile name 'SPP' 'OBEX_PBA_PROFILE_CLIENT' 'OBEX_PBA_PROFILE' 'OBEX_OBJECT_PUSH_SERVICE' 'OBEX_OBJECT_PUSH_CLIENT' 'HF_PROFILE' 'HFG_PROFILE' 3.2.19. AT+QSPPSEND Send Data AT+QSPPSEND Send Data Test Command AT+QSPPSEND=? Response: +QSPPSEND: (list of supported s)[,(list of supported s)] GSM_BT_Application_Note Confidential / Released 39 / 47 GSM/GPRS Module Series GSM BT Application Note OK Write Command Send data with changeable length AT+QSPPSEND= Response '>', then type data to send, tap CTRL+Z to send, tap ESC to cancel the operation Response: > CTRL+Z If connection has been established and sending is successful, response: OK If connection has been established but sending buffer does not have enough space, response: +CME ERROR: 8020 If connection has not been established, abnormally closed, or parameter is incorrect, response: l +CME ERROR: te Write Command c l Send data with fixed length AT+QSPPSEND=, Response '>', type data until the data Q n length is equal to Response: > If connection has been established and sending is successful, response: OK e If connection has been established but sending buffer does fid not have enough space , response: +CME ERROR: 8020 Con Write Command If connection has not been established, abnormally closed, or parameter is incorrect, response: +CME ERROR: Response When is 0, query the sent data If the specified connection has existed, return: AT+QSPPSEND=,0 +QSPPSEND: ,, OK Else, return: +CME ERROR: GSM_BT_Application_Note Confidential / Released 40 / 47 Parameter GSM/GPRS Module Series GSM BT Application Note Connected ID Integer type, the length of data to be sent, which cannot exceed 1460 Integer type, the total length of sent data Integer type, the length of data already sent Integer type, the length of the left data 3.2.20. AT+QSPPREAD Read Data AT+QSPPREAD Read Data Test Command AT+QSPPREAD=? Response: +QSPPREAD: (list of supporteds),(list of supported ) tel Write Command AT+QSPPREAD=, OK Response If the specified channel has received data, response: +QSPPREAD: ue tia OK If no data, return: +QSPPREAD: 0 Q n OK fide Write Command n When is 0, query retrieved data Co AT+QSPPREAD=,0 If connection does not exist, return: +CME ERROR: Response: If the specified connection has existed, return: +QSPPREAD: ,, OK Else, response: +CME ERROR: Parameter Connected ID The maximum length of data to be retrieved, the range is 0-1500 The total length of received data GSM_BT_Application_Note Confidential / Released 41 / 47 The read length of received data The unread length of received data GSM/GPRS Module Series GSM BT Application Note 3.2.21. +QBTIND: 'recv' Incoming Data Indication In buffer access mode, after receiving data, the module will report URC as +QBTIND: 'recv', to notify the host. Then host can retrieve data by AT+QSPPREAD=,. Notes: if the buffer is not empty, and the module receives data again, it will not report a new URC until all the received data has been retrieved by AT+QSPPREAD=, from buffer. +QBTIND: 'recv' Incoming Data Indication +QBTIND: 'recv', The URC of incoming data in buffer access mode. Can receive data by AT+QSPPREAD. l Parameter te Connected ID uec tial 3.2.22. +QBTIND: 'ring' Call Indication +QBTIND: ' ring ' Call Indication Q n +QBTIND: ring',, e , fid Parameter Con < call_state > The call state 0 Idle state 1 Outgoing state 2 Incoming state 4 Active state 8 Hold state The call ID The call number GSM_BT_Application_Note Confidential / Released 42 / 47 GSM/GPRS Module Series GSM BT Application Note 3.2.23. AT+QBTATA Answer Incoming Call AT+QBTATA Answer Incoming Call Execute Command AT+QBTATA Response: OK +CME ERROR: 3.2.24. AT+QBTATH Hung up Voice Call AT+QBTATH Hung up Voice Call Execute Command AT+QBTATH Response: OK +CME ERROR: tel 3.2.25. AT+QBTATD Dial Voice Call c l AT+QBTATD Dial Voice Call ue tia WriteCommand AT+QBTATD= Response: OK +CME ERROR: Q en Parameter fid Phone number Dialing digits: *,#,0-9 n 3.2.26. AT+QBTATDL Redial Last Phone Number Co AT+QBTATDL Redial Last Phone Number Execute Command AT+QBTATDL Response: OK +CME ERROR: GSM_BT_Application_Note Confidential / Released 43 / 47 GSM/GPRS Module Series GSM BT Application Note 3.2.27. AT+QBTHFGAUDIO Select Audio Output Path While Connecting with HFG Device AT+QBTHFGAUDIO Select Audio Output Path While Connecting with HFG Device Test Command AT+QBTHFGAUDIO=? Response: +QBTHFGAUDIO: (list of supporteds) Read Command AT+QBTHFGAUDIO? OK Response: +QBTHFGAUDIO: Write Command tel AT+QBTHFGAUDIO= OK Response OK +CME ERROR: c l Parameter CQounefidentia Audio output path while the module is connecting with HF device 0 Audio output from HF device side 1 Audio output from module side GSM_BT_Application_Note Confidential / Released 44 / 47 GSM/GPRS Module Series GSM BT Application Note 4 Appendix A Reference Table 1: Related Documents SN Document Name Remark Digital cellular telecommunications (Phase 2+); AT [1] GSM 07.07 command set for GSM Mobile Equipment (ME) [2] GSM 07.10 Support GSM 07.10 multiplexing protocol Specification of the Bluetooth Bluetooth Specification from [3] l System - Specification Volume 1 Http://www.bluetooth.com te Table 2: Terms and Abbreviations uec tial Abbreviation SPP Q n URC e BT fid SSP HFP n HF Co AG Description Serial Port Profile Unsolicited Result Code Bluetooth Simple Safe Pair Hands-Free Profile Hands-Free Unit Audio Gateway GSM_BT_Application_Note Confidential / Released 45 / 47 GSM/GPRS Module Series GSM BT Application Note 5 Appendix B Summary of Table 3: Different Coding Schemes of +CME ERROR: Code of Meaning 8002 Device ID invalid 8003 8004 8005 8006 8007 8008 8009 8010 8011 8012 8013 8014 8015 Busy in scanning Param invalid l Busy in pairing te Already paired c l Scan error ue tia Power request failed Set request failed Q n Read addr request failed e Set visible request failed fid Scan request failed Scan cancel request failed nPair request failed CoPair confirm request failed 8016 Unpair request failed 8017 Get profile request failed 8018 Connect request failed 8019 Connect accept request failed 8101 Disconnect request failed GSM_BT_Application_Note Confidential / Released 46 / 47 GSM/GPRS Module Series GSM BT Application Note 8102 Check state request failed 8107 HFATD require failed 8108 HFATA require failed 8109 HFATH require failed 8110 BTCLCC require failed 8111 HFRVC require failed 8020 BT buffer full 8021 8022 8023 8024 8201 4 BT not connect BT memory wrong The data exceeds the specified length l BT disconnected te BT already connected CQouneficdential Operation not supported GSM_BT_Application_Note Confidential / Released 47 / 47

GSM 无线通信模块 GSM模块AT命令 应用指导 GSM 模块 AT 命令应用指导 文档标题 版本 日期 状态 GSM 模块 AT 命令应用指导 1.1 2015-05-04 正式发布 版权： 版权所有 ©上海移远通信技术有限公司 2015。 保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2015 非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不 CQouneficdteenl tial 得以任何形式传播。 上海移远通信技术有限公司 - 1 - GSM 模块 AT 命令应用指导 目录内容 目录内容...........................................................................................................................................2 表格索引...........................................................................................................................................4 0. 修改记录......................................................................................................................................5 1. 概要..............................................................................................................................................6 1.1. 参考文档............................................................................................................................6 2. 模块开关机..................................................................................................................................7 2.1. 开机....................................................................................................................................7 2.2. 命令关机............................................................................................................................7 3. 串口通讯及模块初始化..............................................................................................................8 3.1. 串口通讯............................................................................................................................8 3.2. 模块初始化推荐流程........................................................................................................8 4. 版本及状态查询........................................................................................................................10 4.1. 版本查询..........................................................................................................................10 l 4.2. 查询当前所有设置..........................................................................................................10 4.3. 查询 IMEI 号 ................................................................................................................... 11 te 4.4. 查询 CCID 号 .................................................................................................................. 11 c l 4.5. 查询 IMSI 号 ................................................................................................................... 11 4.6. 恢复出厂设置/保存设置.................................................................................................12 ue tia 5. SIM 卡安全设置.........................................................................................................................13 5.1. 开机 PIN 码设置 .............................................................................................................13 5.2. 更改功能锁密码..............................................................................................................14 Q n 6. 网络查询及设置........................................................................................................................15 6.1. 网络状态信息..................................................................................................................15 e 6.2. 网络注册信息上报..........................................................................................................15 fid 6.3. 网络频段切换..................................................................................................................16 7. 通话............................................................................................................................................17 7.1. 主叫..................................................................................................................................17 7.2. 被叫..................................................................................................................................18 n 7.3. 自动接听..........................................................................................................................18 o 7.4. DTMF 音...........................................................................................................................18 7.5. 呼叫等待..........................................................................................................................19 C7.6. 呼叫转移..........................................................................................................................19 7.7. 呼叫保持及多方通话......................................................................................................19 7.8. 查询通话状态..................................................................................................................20 8. 音频设置....................................................................................................................................22 8.1. 切换主辅通道..................................................................................................................22 8.2. 来电时更改铃音大小......................................................................................................22 8.3. 通话静音..........................................................................................................................22 8.4. 通话时切换音量..............................................................................................................23 8.5. 设置本地 DTMF 音.........................................................................................................23 9. 短消息........................................................................................................................................24 上海移远通信技术有限公司 - 2 - GSM 模块 AT 命令应用指导 9.1. 短信存取位置设置..........................................................................................................24 9.2. 写短消息..........................................................................................................................25 9.3. 发送短消息......................................................................................................................25 9.4. 读短消息..........................................................................................................................26 9.5. 删除短消息......................................................................................................................27 9.6. 短信设置..........................................................................................................................28 9.7. 广播消息..........................................................................................................................28 10. 电话本......................................................................................................................................29 10.1. 电话本设置....................................................................................................................29 10.2. 写电话本........................................................................................................................29 10.3. 读电话本........................................................................................................................29 10.4. 删除电话本....................................................................................................................29 10.5. 查找电话本....................................................................................................................30 10.6. 设置/查询本机号码.......................................................................................................30 10.7. 拨打电话本号码............................................................................................................30 11. GPRS.........................................................................................................................................31 l 11.1. 激活 GPRS 场景 ............................................................................................................31 11.2. 关闭 GPRS 场景 ............................................................................................................31 te 11.3. 拨号上网........................................................................................................................32 12. CSD...........................................................................................................................................33 c l 12.1. 建立 CSD 连接 ..............................................................................................................33 ue tia 13. TCPIP........................................................................................................................................35 14. 多路复用..................................................................................................................................36 15. HTTP.........................................................................................................................................37 16. FTP............................................................................................................................................38 Q n 17. 彩信..........................................................................................................................................39 e 18. 传真..........................................................................................................................................40 19. 时钟/闹铃及其他.....................................................................................................................41 fid 19.1. 查询/设置时钟...............................................................................................................41 19.2. 闹铃设置........................................................................................................................41 19.3. 模块功能设置................................................................................................................42 n 19.4. 网络参数查询................................................................................................................42 Co 19.5. 省电模式设置................................................................................................................43 上海移远通信技术有限公司 - 3 - GSM 模块 AT 命令应用指导 表格索引 表 1: 参考文档表 ....................................................................................................................................6 表 2: 关机相关 AT 命令 .........................................................................................................................7 表 3: 版本及状态查询相关 AT 命令 ...................................................................................................10 表 4: SIM 卡安全设置相关 AT 命令 ....................................................................................................13 表 5: 网络查询及设置相关 AT 命令 ...................................................................................................15 表 6: 通话相关 AT 命令 .......................................................................................................................17 表 7: 音频相关 AT 命令 .......................................................................................................................22 表 8: 短消息相关 AT 命令 ...................................................................................................................24 表 9: 电话本相关 AT 命令 ...................................................................................................................29 表 10: GPRS 相关 AT 命令 ...................................................................................................................31 表 11: CSD 相关 AT 命令......................................................................................................................33 表 12: TCPIP 相关 AT 命令 ..................................................................................................................35 表 13: MUX 相关 AT 命令....................................................................................................................36 l 表 14: HTTP 相关 AT 命令 ...................................................................................................................37 表 15: FTP 相关 AT 命令 ......................................................................................................................38 te 表 16: 彩信相关 AT 命令 .....................................................................................................................39 c l 表 17: 传真相关 AT 命令 .....................................................................................................................40 CQounefidentia 表 18: 时钟/闹铃及其他相关 AT 命令................................................................................................41 上海移远通信技术有限公司 - 4 - GSM 模块 AT 命令应用指导 0. 修改记录 版本 1.0 1.1 日期 2009-12-1 2015-05-04 作者 胡志琴 王淑娟 修改内容记录 初始版本 增加适用模块说明 CQouneficdteenl tial 上海移远通信技术有限公司 - 5 - GSM 模块 AT 命令应用指导 1. 概要 该文档主要描述Quectel GSM 模块软件AT命令及各功能应用推荐操作流程。本文档适用于 所有Quectel GSM模块。 1.1. 参考文档 表 1: 参考文档表 序号 文档名 备注 [1] [2] [3] [4] [5] [6] [7] [8] Mxx_ATC.pdf GSM_TCPIP_AN.pdf GPRS_Startup_UGD.pdf l GSM_MUX_AN.pdf GSM_HTTP_ATC.pdf te GSM_FTP_ ATC..pdf GSM_MMS_ ATC..pdf CQouneficdential FAX_Setup_UGD.pdf GSM 模块 AT 命令集 TCPIP 应用指导 GPRS 配置应用指导 MUX 应用指导 HTTP 相关 AT 命令集及应用指导 FTP 相关 AT 命令集及应用指导 彩信相关 AT 命令集及应用指导 传真配置应用指导 上海移远通信技术有限公司 - 6 - 2. 模块开关机 2.1. 开机 标准模块设备在评估板上的正确开机操作步骤如下（以 M10 及评估板为例）： 1. 将模块安装在评估板上 2. 连接天线 3. 插入 SIM 卡 4. 连接电源适配器，串口线 5. 打开电源开关（5V-SW），按评估板上的 PWRKEY 持续 2 秒及以上，模块开机 6. 确认电源指示灯 D304（持久亮起），网络指示灯 D303 闪烁 警告：评估板上 S201 是 D/L 下载开关，S203 是 VCHG 充电开关，模块正常运作过程中一 直都应只是 OFF。 tel 2.2. 命令关机 c l 表 2: 关机相关 AT 命令 ue tia AT命令 AT+QPOWD 命令说明 关机命令 Q en 2.2.1. 正常关机 fid AT+QPOWD=1 NORMAL POWER DOWN // =1 表示正常关机 // 模块正常关机 n 2.2.2. 立即关机 o AT+QPOWD=0 C OK // =0 表示立即关机 // 模块立即关机 GSM 模块 AT 命令应用指导 3. 串口通讯及模块初始化 3.1. 串口通讯 Quectel所有标准模块软件，其出厂设置均为自适应波特率。标准模块软件在自适应波 特率下使用时，需注意如下几点： （1）确保TE与TA自适应波特率同步，同步成功后，串口通讯正常。同步操作：模块开机后， 向串口输入AT 或者at ，确认返回OK则串口通讯正常。 （2）自适应波特率下，自适应未同步前开机及来电等相关自动上报信息不上报； （3）使用过程中，建议将自适应波特率设置为常用的固定波特率。以下为设置固定波特率 115200bps的操作举例： AT+IPR=115200 // 设置固定波特率为115200 l OK // 成功设置固定波特率 te AT&W OK // 保存波特率设置 uec tial 固定波特率下，开机上报信息： RDY +CFUN: 1 Q en +CPIN:READY // 开机自动上报信息 fid Call Ready // 初始化完成，上报Call Ready信息 n 3.2. 模块初始化推荐流程 o （1）串口通讯（以超级终端为例） C 打开超级终端->新建超级终端->选择连接端口->配置串口通讯波特率（与模块一致），并打 开硬件流控（模块默认打开硬件流控）； （2）模块开机，向串口输入AT 或者at ，返回OK则串口通讯正常； （3）在模块进行其他操作前，需确认SIM卡是否已经注册上网络，操作如下： AT+CSQ // 查询当前网络信号强度 +CSQ: 30,0 // 网络信号强度30，误码率0 OK 上海移远通信技术有限公司 - 8 - GSM 模块 AT 命令应用指导 AT+CREG? +CREG: 0,1 // 查询GSM网络注册状态 // =1 GSM网络已注册上 OK AT+CGREG? +CGREG: 0, 1 // 查询GPRS网络注册状态 // =1 GPRS网络已注册上 OK AT+COPS? // 查询当前SIM卡注册上的营运商 +COPS: 0,0,'CHINA MOBILE' // 当前SIM卡营运商为中国移动 CQouneficdteenl tial OK 上海移远通信技术有限公司 - 9 - GSM 模块 AT 命令应用指导 4. 版本及状态查询 表 3: 版本及状态查询相关 AT 命令 AT 命令 命令说明 ATI 查询版本信息 AT&V 查询所有当前设置 AT&F 恢复出厂设置 AT&W 保存当前设置 AT+GSN/ AT+CGSN 查询 IMEI 号 AT+QCCID 查询 CCID 号 AT+CIMI 查询 IMSI 号 以下小节为相关AT命令操作及部分功能应用举例。 l 4.1. 版本查询 te ATI c l Quectel_Ltd ue tia Quectel_M10 Revision:M10R04A01M32_SST // 查询版本所有信息 // 厂商：Quectel // M10标准模块 // 软件版本：M10R04A01M32_SST Q n OK fide 4.2. 查询当前所有设置 AT&V n ACTIVE PROFILE Co E: 1 // 查询部分出厂设置信息 Q: 0 V: 1 …. // 省略部分信息 +QECHO(NORMAL_AUDIO): 221,1024,16388,849,0 +QECHO(Earphone_AUDIO): 221,1024,0,849,1 +QECHO(LoudSpk_AUDIO): 224,1024,5128,374,2 上海移远通信技术有限公司 - 10 - GSM 模块 AT 命令应用指导 +QSIDET(NORMAL_AUDIO): 80 +QSIDET(HEADSET_AUDIO): 144 +QCLIP: 0 +CSNS: 0 OK // 返回OK，查询数据输出结束 4.3. 查询 IMEI 号 AT+GSN 359231030000010 l OK te AT+CGSN c l 359231030000010 ue tia OK Q n 4.4. 查询 CCID 号 e AT+QCCID fid 898600220909A0206023 OK Con 4.5. 查询 IMSI 号 // 查询IMEI号 // 查询IMEI号 // 查询CCID号 // CCID号为'898600220909A0206023' AT+CIMI 460023210226023 // 查询IMSI号 // IMSI号为'460023210226023' OK 上海移远通信技术有限公司 - 11 - GSM 模块 AT 命令应用指导 4.6. 恢复出厂设置/保存设置 AT&F OK // 恢复出厂设置（注：AT&F不恢复波特率设置） AT&W OK // 保存当前所有设置 注： AT&F可恢复AT&V内显示的所有命令（+IPR设置除外）的出厂设置。 AT&W可保存AT&V内显示的所有命令设置的参数值。 CQouneficdteenl tial 上海移远通信技术有限公司 - 12 - GSM 模块 AT 命令应用指导 5. SIM 卡安全设置 表 4: SIM 卡安全设置相关 AT 命令 AT 命令 AT+CLCK AT+CPIN AT+CPWD 命令说明 功能锁定 PIN 码操作 更改密码 以下小节为相关AT命令操作及部分功能应用举例。 5.1. 开机 PIN 码设置 AT+CLCK='SC',0,'1234' l OK te AT+CLCK='SC',2 +CLCK: 0 uec tial OK AT+CLCK='SC',1,'1234' OK Q en AT+CPIN? +CPIN: SIM PIN fid OK n AT+CPIN='1234' +CPIN: READY Co OK // =0 取消锁PIN码功能 // =2，查询锁PIN状态 // =0，未锁PIN状态 // =1，设置锁PIN码功能 // 返回OK，成功设置锁PIN码功能 // 查询是否需要输入PIN码 // +CPIN: SIM PIN状态，需要输入PIN码 // 输入PIN码'1234' // 输入PIN 码正确，进入+CPIN: READY状态 警告：PIN最多不能输错3次，否则SIM卡会进入PUK状态。PUK不能输错10次，不然该SIM 卡将永久被锁。 +CPIN: SIM PIN AT+CPIN='1111' // 输入错误PIN码 +CME ERROR: 16 AT+CPIN='1111' 上海移远通信技术有限公司 - 13 - GSM 模块 AT 命令应用指导 +CME ERROR: 16 AT+CPIN='1111' +CPIN: SIM PUK +CME ERROR: 12 // 输入错误PIN码3次 // PIN码输入错误3次，SIM卡进入PUK状态 AT+CPIN='26601934','1234' +CPIN: READY // 解PUK操作，'26601934'为PUK码，'1234' 为新设定的PIN码 OK l 5.2. 更改功能锁密码 te 以下操作以更改PIN码为例： c l AT+CPWD='SC','1234','4321' CQounefidentia OK // 将SIM卡PIN码由'1234'更改为'4321' 上海移远通信技术有限公司 - 14 - GSM 模块 AT 命令应用指导 6. 网络查询及设置 表 5: 网络查询及设置相关 AT 命令 AT 命令 命令说明 AT+CSQ 信号强度查询 AT+CREG GSM 网络注册状态查询 AT+CGREG GPRS 网络注册状态查询 AT+COPS 网络选择 AT+CPOL 编辑优先网络列表 AT+COPN 读取营运商名字 AT+QBAND 改变网络频段 以下小节为相关AT命令操作及部分功能应用举例。 l 6.1. 网络状态信息 te AT+CSQ c l +CSQ: 30,0 // 查询当前网络信号强度 // 网络信号强度30，误码率0 ue tia OK Q n AT+CREG? +CREG: 0,1 // 查询GSM网络注册状态 // =1，GSM网络已注册上 e OK fid AT+CGREG? +CGREG: 0,1 // 查询GPRS网络注册状态 // =1，GPRS网络已注册上 Con OK 6.2. 网络注册信息上报 AT+CREG=2 OK AT+CGREG=2 OK +CREG: 1,'1806','2012' 上海移远通信技术有限公司 // =2，打开GSM网络注册信息自动上报功能 // =2，打开GPRS网络注册信息自动上报功能 // 信息自动上报，=1表示注册上GSM 网络 - 15 - GSM 模块 AT 命令应用指导 +CGREG: 1, '1806', '2012' // 信息自动上报，=1表示注册上GPRS 网络 6.3. 网络频段切换 AT+QBAND=? // 查询软件所支持的网络频段 +QBAND:(EGSM_MODE,DCS_MODE,PCS_MODE,EGSM_DCS_MODE,GSM850_PCS_ MODE,GSM850_EGSM_DCS_PCS_MODE) OK AT+QBAND? // 查询当前网络频段 +QBAND: 'GSM850_EGSM_DCS_PCS_MODE' OK l AT+QBAND='DCS_MODE' CQouneficdteential OK // 设置网络频段为'DCS_MODE' 上海移远通信技术有限公司 - 16 - GSM 模块 AT 命令应用指导 7. 通话 表 6: 通话相关 AT 命令 AT 命令 命令说明 ATD 通话呼叫 ATDL 重拨 ATA 呼叫应答 ATH 挂断所有连接 ATS0 设置自动接听功能 AT+COLP 被叫方信息显示 AT+CLIP AT+CCWA AT+CCFC l AT+CLCC AT+CPAS te AT+CEER AT+CHLD c l AT+VTS ue tia AT+CKPD 主叫方信息显示 呼叫等待 呼叫转移 当前呼叫列表 ME 状态 与呼叫有关的错误报告 呼叫保持和多方会议 发送 DTMF 音 键盘控制 以下小节为相关AT命令操作及部分功能应用举例。 Q n 7.1. 主叫 fide 7.1.1. ATD发起语音通话操作 ATD10086; n OK // 发起语音通话呼叫 // 返回OK，发出呼叫成功 Co 7.1.2. 通话建立信息上报 AT+COLP=1 OK // =1 设置通话呼叫连接成功信息提示 // 设置成功 ATD10086; +COLP: '10086',129,'',0 // ATD发起呼叫 // 通话建立连接后，提示主叫号码信息 OK 上海移远通信技术有限公司 - 17 - GSM 模块 AT 命令应用指导 7.2. 被叫 7.2.1. 来电接听 RING RING ATA OK // 新来电，上报RING提示 // ATA接听来电 7.2.2. 设置来电上报来电信息 AT+CLIP=1 OK // =1 设置来电信息上报提示 l RING // 有新来电，上报RING提示 +CLIP: '13764920730',129,'',,'',0 te // 上报来电号码信息提示 uec tial 7.3.自动接听 ATS0=2 Q n OK // =2 设置上报2个RING之后自动接听（默认为0） e RING fid RING // 上报2个RING之后，来电自动接听 AT+CLCC n +CLCC: 1,1,0,0,0,'13764920730',129,'' Co OK // AT+CLCC查询通话状态，=0表示通话连接建立 7.4. DTMF 音 DTMF音一般用于拨打分机或一些自动服务系统，在呼叫建立连接之后，如果要向网络发送 某个号码，就是通过DTMF音实现。下面的例子是拨打02151082965-816。 ATD02151082965; // 拨打总机号码02151082965 OK AT+CLCC 上海移远通信技术有限公司 - 18 - GSM 模块 AT 命令应用指导 +CLCC: 1,0,0,0,0,' 02151082965',129,'' OK // AT+CLCC查询通话状态，=0表示呼叫连接建立 AT+VTS='8,1,6' // 通过发送DTMF音拨打分机号816 OK 注：呼叫总机号码需接通后再发送DTMF音进行拨打分机号操作。 7.5. 呼叫等待 AT+CCWA=1,1 // 开启呼叫等待 OK ATD10086; OK // 发起语音通话呼叫 l +CCWA: '02164011559',129,1 // 设置呼叫等待后，通话中有新来电，上报呼叫等待提示 cte l 7.6.呼叫转移 ue tia AT+CCFC=2,3,'02151082965',129,,,,5 OK // =2，=3表示设置无应答转接 Q en AT+CCFC=2,2 // =2，=2表示查询无应答转接 +CCFC: 1,1,'+862151082965',145,,,5 fid +CCFC: 1,16,'+862151082965',145,,,5 n OK // =5 秒无应答，通话转接至02151082965 o AT+CCFC=2,4 C OK // =2，=4删除所有无应答转接 7.7. 呼叫保持及多方通话 ATD10086; OK ATD10086; OK // 发起第一通语音通话呼叫 // 发起第二通语音通话呼叫 上海移远通信技术有限公司 - 19 - GSM 模块 AT 命令应用指导 AT+CLCC // 查询当前通话状态 +CLCC: 1,0,1,0,0,'10086',129,'' +CLCC: 2,0,0,0,0,'10086',129,'' OK AT+CHLD=2 OK // =2将激活状态的通话保持，保持或等待的通话激活 AT+CLCC // 查询当前通话状态，以确认AT+CHLD操作成功 +CLCC: 1,0,0,0,0,'10086',129,'' +CLCC: 2,0,1,0,0,'10086',129,'' OK // 激活的通话被保持，保持或等待的通话激活 l AT+CHLD=3 te OK // =3将所有保持或等待的通话激活 c l AT+CLCC // 查询当前通话状态，以确认AT+CHLD操作成功 ue tia +CLCC: 1,0,0,0,1,'10086',129,'' +CLCC: 2,0,0,0,1,'10086',129,'' Q n OK // 所有通话均已激活 fide 7.8. 查询通话状态 AT+CPAS n +CPAS: 0 Co OK // 查询ME当前状态 // =0 表示当前ME处空闲状态 ATD10086; OK // 发起语音通话呼叫 AT+CLCC // 查询当前通话状态 +CLCC: 1,0,0,0,0,'10086',129,'' OK AT+CPAS 上海移远通信技术有限公司 // 查询ME当前状态 - 20 - GSM 模块 AT 命令应用指导 +CPAS: 4 OK // =4 表示ME通话中 CQouneficdteenl tial 上海移远通信技术有限公司 - 21 - GSM 模块 AT 命令应用指导 8. 音频设置 表 7: 音频相关 AT 命令 AT 命令 命令说明 AT+QADUCH 切换主辅通道 AT+CLVL 设置听筒音量 AT+CRSL 更改铃音音量大小 AT+CALM 切换铃音模式 AT+CMUT 上行语音静音控制 AT+QMIC 更改麦克风音量大小 AT+QLDTMF 设置本地 DTMF 音 详细音频参数相关设置请参考文档：GSM模块音频设计应用指南.pdf。 l 以下小节为相关AT命令操作及部分功能应用举例。 te 8.1. 切换主辅通道 c l AT+QAUDCH=1 ue tia OK // 切换主辅通道，=1表示切换为辅通道，即耳 机通话 Q n 8.2. 来电时更改铃音大小 fide RING RING n AT+CRSL=100 OK Co AT+CALM=1 // 新来电上报RING提示 // 更改铃音音量大小为100 // =1 开启铃音静音功能 OK 8.3. 通话静音 AT+CLCC +CLCC: 1,0,0,0,0,'15021012496',129,'' // 建立通话 OK 上海移远通信技术有限公司 - 22 - GSM 模块 AT 命令应用指导 AT+CMUT=1 OK // =1 设置上行通话静音，此时对方听不到模块 方声音 8.4. 通话时切换音量 AT+CLCC +CLCC: 1,0,0,0,0,'15021012496',129,'' // 建立通话 OK AT+CLVL=80 OK tel 8.5. 设置本地 DTMF 音 c l AT+QLDTMF=100,'1' ue tia OK AT+QLDTMF CQonfiden OK // 切换音量，此时扬声器音量为80 // 生成本地DTMF音。=100表示DTMF音响10 秒， ='1'表示DTMF音类型 // 返回OK，此时播放DTMF音（AT+QAUDCH=1 时耳机内有播放） // 关闭当前DTMF音的播放 // 成功关闭 上海移远通信技术有限公司 - 23 - GSM 模块 AT 命令应用指导 9. 短消息 表 8: 短消息相关 AT 命令 AT 命令 命令说明 AT+CPMS 选择消息存储器 AT+CSMP 设置文本模式参数 AT+CMGF 选择短消息格式 AT+CSCS 选择 TE 字符类型 AT+CMGW 写短信 AT+CMGR 读短信 AT+CMGL AT+CMGS AT+CMGD AT+QMGDA l AT+CSDH te AT+CSCA AT+CNMI c l AT+CSAS ue tia AT+CRES AT+CSCB 列举短信 发送短信 删除短信 删除指定类型的所有短信 显示文本模式参数 设置短消息服务中心地址 新消息指示 存储短信设置 重新存储短信设置 选择广播消息 Q n 以下小节为相关AT命令操作及部分功能应用举例。 e 9.1. 短信存取位置设置 fid AT+CPMS=? // 查询软件支持的SMS存储器 +CPMS: ('SM', 'ME', 'MT'), ('SM', 'ME', 'MT'), ('SM', 'ME', 'MT') n OK // 'SM'表示存储于SIM卡内, 'ME'表示存储于终端内，'MT' Co表示存储于SIM卡和终端内（优先存储于SIM卡内） AT+CPMS? // 查询当前SMS存储设置 +CPMS: 'SM',8,30,'SM',8,30,'SM',8,30 OK // ='SM' 表示读删短信存储在SIM卡内，=8 表示当前SIM卡内可读删短信为8条，=30 表示SIM卡总 存储容量为30条 上海移远通信技术有限公司 - 24 - GSM 模块 AT 命令应用指导 9.2. 写短消息 9.2.1. 写文本模式短信 AT+CMGF=1 OK // =1 设置文本模式 AT+CSCS='GSM' OK // ='GSM' 设置GSM字符类型 AT+CMGW // 写短信操作 > Hello, Quectel! // 输入短信内容'Hello, Quectel!'，保存编 +CMGW: 18 OK 辑的短信，退出编辑短信状态 // 写入的短信被存储于索引号18位置上 tel 9.2.2. 写 PDU 模式短信 c l AT+CMGF=0 ue tia OK // =0 设置PDU模式 AT+CMGW=43 // 写短信操作（PDU编码） Q n >0011000D91683118876788F30018011C00480065006C006C006F002C0051007500650063007 e 40065006C0021 // 输入短信内容为'Hello, Quectel!'，保存 编辑的短信，退出编辑短信状态 +CMGW: 2 // 写入的短信被存储于索引号2位置上 fid OK Con 9.3. 发送短消息 9.3.1. 发送文本模式短信 AT+CMGF=1 OK // =1 设置文本模式 AT+CSCS='GSM' OK // ='GSM' 设置GSM字符类型 AT+CMGS='15021012496' > Hello,Quectel! 上海移远通信技术有限公司 // 向号码'15021012496'发送文本短信 // 输入短信内容'Hello, Quectel!'，发送编 - 25 - GSM 模块 AT 命令应用指导 +CMGS: 26 OK 辑的短信，退出编辑短信状态 9.3.2. 发送 PDU 模式短信 AT+CMGF=0 OK // =0 设置PDU模式 AT+CMGS=43 // 发送PDU短信 >0011000D91685120012194F60008011C00480065006C006C006F002C0051007500650063007 40065006C0021 +CMGS: 254 tel OK // 发送号码为：8615021012496，短信内容为 'Hello,Quectel!'。发送编辑的短信， 退出编辑短信状态 c l 9.4. 读短消息 ue tia 以下所有读短信相关操作以文本模式为例。 AT+CMGF=1 // =1 设置文本模式 Q n OK e AT+CSCS='GSM' fid OK // ='GSM' 设置GSM字符类型 n 9.4.1. 读取写入的短消息 o AT+CMGW > Hello,Quectel! C +CMGW: 3 // 写短信操作 // 输入短信内容 // 写入的短信被存储于索引号3位置上 OK AT+CMGR=3 +CMGR: 'STO UNSENT','','' Hello,Quectel! // 读取存储于索引号3位置上的短信 OK 上海移远通信技术有限公司 - 26 - GSM 模块 AT 命令应用指导 9.4.2. 读取新到达的短消息 +CMTI: 'SM',4 // 提示新短信，新短信存储在SIM卡索引号4位置上 AT+CMGR=4 // 读取索引号4位置上的短信 +CMGR: 'REC UNREAD','+8615021012496','','2009/10/15 16:32:51+32' Hello,Quectel! OK // 该短信发送方为：+8615021012496 9.4.3. 读取指定类型的所有短消息 AT+CMGL='REC READ' // ='REC READ'读取所有已读短信 注：PDU短信模式下读取所有已读短信=1 +CMGL: 4,'REC READ','+8615021012496','','2009/10/15 11:10:56+32' Hello,Quectel! tel OK c l AT+CMGL='ALL' // ='ALL'读取所有短信 注：PDU短信模式下读取所有已读短信=4 ue tia +CMGL: 1,'STO UNSENT','','', Hello,Quectel! Q n +CMGL: 2,'REC READ','+8615021012496','','2009/11/23 19:48:44+32' Hello,Quectel! fide +CMGL: 3,'REC UNREAD','+8615021012496','','2009/11/23 19:49:03+32' Hello,Quectel! Con OK 9.5. 删除短消息 9.5.1. 删除指定位置短消息 AT+CMGD=1 OK // 删除存储在当前存储器索引号1位置上的短信 上海移远通信技术有限公司 - 27 - GSM 模块 AT 命令应用指导 9.5.2. 删除指定类型所有短消息 AT+QMGDA='DEL ALL' OK // 删除当前存储器内的所有短信 注：PDU短信模式下删除所有已读短信=6 9.6. 短信设置 9.6.1. 短信中心查询及设置 AT+CSCA? // 查询短信中心号码 +CSCA: '+8613800210500',145 // 短信中心号码为'+8613800210500' OK l AT+CSCA='+8613800210500' // 设置短信中心号码为'+8613800210500' te OK 注：强烈建议客户通常不要修改短信中心号码，以免发生SIM卡无法发送短信的现象。 uec tial 9.6.2.短信报告设置 AT+CSMP=49,167,0,241 Q n OK e AT+CNMI=2,1,0,1,0 OK fid AT+CMGS='15021012496' > Hello,Quectel! n +CMGS: 25 Co OK // 设置参数=49，打开短信报告功能 // 设置=1，提示短信报告信息 // 发送短消息 +CDS: 6,25,'15021012496',129,'2009/10/15 17:04:11+32','2009/10/15 17:04:12+32', // 收到短信报告，提示+CDS:信息 9.7. 广播消息 AT+CSCB=0,'50','1' OK // 选择对应广播消息 上海移远通信技术有限公司 - 28 - GSM 模块 AT 命令应用指导 10. 电话本 表 9: 电话本相关 AT 命令 AT 命令 AT+CPBS AT+CPBW AT+CPBR AT+CPBF AT+CNUM 命令说明 电话本存储位置 写/删电话本 读取电话本 查找和电话本姓名匹配的记录 查询/设置本机号码 以下小节为相关AT命令操作及部分功能应用举例。 10.1. 电话本设置 l AT+CPBS='SM' te OK c l AT+CSCS='GSM' ue tia OK // 设置电话本存储类型为'SM'，即操作SIM卡内电话本 // 设置电话本号码及电话本名的输入内容为'GSM'格式 Q n 10.2. 写电话本 e AT+CPBW=1,'15021012496',129,'Quectel' fid OK // 向当前的电话本索引号1位置上写入电话本 n 10.3. 读电话本 o AT+CPBR=1 // 读取当前电话本索引号1位置上的电话本内容 C +CPBR: 1,'15021012496',129,'Quectel' OK 10.4. 删除电话本 AT+CPBW=1 OK // 删除当前电话本索引号1位置上的电话本内容 上海移远通信技术有限公司 - 29 - GSM 模块 AT 命令应用指导 10.5. 查找电话本 AT+CPBF='Quectel' // 查找当前电话本内包含字符为'Quectel'的所有电话本 +CPBF: 1,'15021012496',129,'Quectel' OK 10.6. 设置/查询本机号码 AT+CPBS='ON' // 选择'ON'类型电话本 OK AT+CPBW=1,'13761832100',129,'Own number1' OK // 写入本机号码1 l AT+CPBW=2,'15021012496',129,'Own number2' te OK // 写入本机号码2 c l AT+CNUM // 查询本机号码 ue tia +CNUM: 'Own number1','13761832100',129,7,4 +CNUM: 'Own number2','15021012496',129,7,4 Q n OK fide 10.7. 拨打电话本号码 通过ATD命令可以进行拨打电话本电话号码操作，举例如下： n ATD>1; // 拨打当前电话本索引号1位置上的电话号码 Co OK 上海移远通信技术有限公司 - 30 - GSM 模块 AT 命令应用指导 11. GPRS 表 10: GPRS 相关 AT 命令 AT 命令 命令说明 AT+CGATT 附着/去附着 GPRS 网络 AT+CGDCONT 配置 PDP 场景 AT+CGACT 激活/去激活 PDP 场景 AT+CGQMIN 网络服务质量控制（最低可接受的） AT+CGQREQ 网络服务质量控制（被请求的） AT+CGDATA 进入数据状态 AT+CGPADDR AT+CGCLASS AT+CGEREP AT+CGREG l AT+CGSMS 查询 PDP 地址 GPRS 网络类型 控制 GPRS 事件报告 GPRS 网络注册状态 选择短信优先业务模式 te 以下小节为相关AT命令操作及部分功能应用举例。 uec tial 11.1.激活GPRS场景 AT+CGATT? Q n +CGATT:1 // 查询GPRS网络是否附着 // =1 表示GPRS已附着 e OK fid AT+CGDCONT=1,'IP','CMNET' OK n AT+CGACT=1,1 o OK C AT+CGPADDR =1 // 定义场景1 的PDP内容 // 激活GPRS场景1 // 查询场景1的PDP地址 +CGPADDR: 1,'10.78.195.244' // 场景1的PDP地址为'10.78.195.244' OK 11.2. 关闭 GPRS 场景 AT+CGACT=0,1 // 关闭GPRS场景1 上海移远通信技术有限公司 - 31 - GSM 模块 AT 命令应用指导 NO CARRIER // 场景关闭成功 11.3. 拨号上网 具体步骤及应用参考文档：GPRS_Startup_UGD.pdf。 CQouneficdteenl tial 上海移远通信技术有限公司 - 32 - GSM 模块 AT 命令应用指导 12. CSD 表 11: CSD 相关 AT 命令 AT 命令 ATD AT+CSNS +++ ATO 命令说明 拨号操作 设置数据传输模式 退出数据传输进入 AT 命令状态 AT 命令状态恢复数据传输状态 以下小节为相关AT命令操作及部分功能应用举例。 12.1. 建立 CSD 连接 l 以下是模块A对模块B进行CSD Call呼叫，连接建立后，模块A挂断Call连接举例： te 模块A： ATD15052251387 c l CONNECT 9600 ue tia QUECTELTEST001 Q n OK e ATO fid CONNECT 9600 QUECTEL TEST003 n OK ATH Co OK // StepA1：拨打CSD Call // 响应StepB1：CSD连接建立 // StepA2：向模块B发送数据操作，输入数据 'QUECTEL TEST002' 响应StepB2：接收到模块B发送的数据'QUECTEL TEST001' // StepA3：+++操作，退出数据传输模式，进入命令 模式 // StepA4：ATO操作，进入数据传输模式 // 响应StepB3：接收到模块B发送的数据'QUECTEL TEST003' // StepA5：挂断CSD连接 模块B： AT+CSNS=4 // 设置CSD数据传输模式 OK RING ATA CONNECT 9600 QUECTEL TEST002 // 响应模块StepA1：新来CSD Call // StepB1：接听CSD Call // 响应StepB1：CSD连接建立 // 响应StepA2：接收到模块A发送的数据'QUECTEL TEST002' 上海移远通信技术有限公司 - 33 - GSM 模块 AT 命令应用指导 NO CARRIER StepB2：向模块B发送数据操作，输入数据 'QUECTEL TEST001' StepB3：向模块B发送数据操作，输入数据 'QUECTEL TEST003' // 响应StepA5：CSD 连接挂断 注： M35，M72-D，M26，GC65-E，GC65，M10，M50不支持建立CSD连接。 CQouneficdteenl tial 上海移远通信技术有限公司 - 34 - GSM 模块 AT 命令应用指导 13. TCPIP 表 12: TCPIP 相关 AT 命令 AT命令 命令说明 AT+QIFGCNT 设置前台GPRS/CSD场景 AT+QIMODE 设置TCPIP应用模式 AT+QIMUX 选择多路或非多路TCPIP连接 AT+QISACK 查询已确认和待确认发送的数据大小 AT+QISERVER 建立TCP服务器或UDP服务器 AT+QIOPEN 建立TCP/UDP连接 AT+QICLOSE AT+QISTAT AT+QIDEACT AT+QISEND l AT+QIREGAPP te AT+QIACT AT+QILOCIP c l AT+QILPORT ue tia AT+QIDNSCFG AT+QIDNSGIP AT+QIDNSIP Q n AT+QIHEAD AT+QISHOWRA e AT+QIAUTOS AT+QIPROMPT fid AT+QICSGP AT+QISRVC AT+QISCON n AT+QITCFG o AT+QISHOWPT C AT+QISHOWLA 关闭当前或指定的TCPIP连接 查询当前连接状态 关闭当前GPRS/CSD场景 发送数据 设置APN，用户名密码，初始化TCPIP任务 激活GPRS/CSD连接 获取本地IP地址 设置本地端口，仅用作服务器的监听端口 配置DNS服务器地址 根据域名地址获取IP地址 选择使用域名地址或IP地址形式 设置是否在接受数据开头增加头信息 设置接收数据时是否显示发送方IP地址 设置自动发送数据 设置在发送数据时是否显示'>'以及发送完成后，是否显示SEND OK 选择GPRS或CSD连接模式 选择连接 保存TCPIP应用配置 配置透明传输模式 设置接收数据时是否显示传输层的协议类型 设置接收数据时是否显示本地IP地址 具体步骤及应用参考文档：GSM_TCPIP_AN.pdf。 上海移远通信技术有限公司 - 35 - GSM 模块 AT 命令应用指导 14. 多路复用 表 13: MUX 相关 AT 命令 AT 命令 AT+CMUX 命令说明 设置多路复用模式 具体步骤及应用参考文档：GSM_MUX_AN.pdf。 CQouneficdteenl tial 上海移远通信技术有限公司 - 36 - GSM 模块 AT 命令应用指导 15. HTTP 表 14: HTTP 相关 AT 命令 AT 命令 AT+QHTTPURL AT+QHTTPGET AT+QHTTPREAD AT+QHTTPPOST 命令说明 HTTP URL 配置 发送 HTTP GET 请求 读 HTTP 响应信息 发送 HTTP POST 请求 具体步骤及应用参考文档：GSM_HTTP_ATC.pdf。 CQouneficdteenl tial 上海移远通信技术有限公司 - 37 - GSM 模块 AT 命令应用指导 16. FTP 表 15: FTP 相关 AT 命令 AT 命令 命令说明 AT+QFTPOPEN 建立 FTP 连接 AT+QFTPCLOSE 关闭当前 FTP 连接 AT+QFTPPUT 上传文件 AT+QFTPGET 下载文件 AT+QFTPPATH FTP 工作路径 AT+QFTPUSER FTP 登陆名 AT+QFTPPASS AT+QFTPCFG AT+QFTPSTAT FTP 登陆密码 FTP 参数配置 查询 FTP 连接状态 CQouneficdteenl tial 具体步骤及应用参考文档：GSM_FTP_ATC.pdf。 上海移远通信技术有限公司 - 38 - GSM 模块 AT 命令应用指导 17. 彩信 表 16: 彩信相关 AT 命令 AT 命令 命令说明 AT+QMMURL 设置彩信中心 URL 地址 AT+QMMPROXY 设置彩信代理地址 AT+QMMCFG 彩信参数设置 AT+QFLDS 查询文件存储容量 AT+QFUPL 上传文件 AT+QFDEL 删除文件 AT+QMMSCS AT+QMMSW AT+QMMSEND AT+QMMRM l AT+QMMRR te AT+QMMRECV AT+QMMPRI 设置彩信文本模式 写彩信主题 发送彩信 彩信管理 读收到彩信内容 下载彩信 彩信和通话优先设置 CQouneficdential 具体步骤及应用参考文档：GSM_MMS_ATC.pdf。 上海移远通信技术有限公司 - 39 - GSM 模块 AT 命令应用指导 18. 传真 表 17: 传真相关 AT 命令 AT 命令 AT+FCLASS AT+CSNS 命令说明 设置传真模式 设置数据传输模式 具体步骤及应用参考文档：FAX_Setup.pdf。 CQouneficdteenl tial 上海移远通信技术有限公司 - 40 - GSM 模块 AT 命令应用指导 19. 时钟/闹铃及其他 表 18: 时钟/闹铃及其他相关 AT 命令 AT 命令 命令说明 AT+QALARM 闹铃设置 AT+CCLK 时钟设置 AT+CFUN 模块功能设置 AT+QENG 网络参数查询 ATV 命令应答格式 ATE 回显设置 A/ AT+CMEE AT+QSCLK 重复上一条命令操作 移动设备错误报告 省电模式设置 l 以下小节为相关AT命令操作及部分功能应用举例。 te 19.1. 查询/设置时钟 uec tial AT+CCLK? +CCLK: '08/01/01,06:06:24+00' // 查询模块当前时间 Q n OK e AT+CCLK='09/09/09,12:00:00+00' OK // 设置模块时间为'09/09/09,12:00:00+00' nfid 19.2. 闹铃设置 o 举例一：普通闹铃 C AT+CCLK? // 查询当前时间 +CCLK: '08/01/02,00:04:29+00' OK AT+QALARM=1, '08/01/02,00:06:00+00',0,0 // 设置普通闹铃, =0表示普通闹铃 OK ALARM RING // 闹铃时间到提示 举例二：开机闹铃 上海移远通信技术有限公司 - 41 - GSM 模块 AT 命令应用指导 AT+QALARM=1, '08/01/02,00:06:00+00',0,2 // 设置闹铃关机，=2表示开机闹铃 OK AT+QPOWD=1 NORMAL POWER DOWN // AT命令关机（亦可选择硬件关机） RDY ALARM MODE // 闹铃时间到的提示，自动开机进入闹铃模式 +CFUN: 0 NORMAL POWER DOWN // 进入闹铃模式90S后，模块自动关机 19.3. 模块功能设置 l AT+CFUN=1 te OK // 设置模块全功能模式（默认为1） uec tial 19.4.网络参数查询 AT+QENG=1 Q en OK // =1 开启网络参数监控，不主动上报 信息，可查询 fid AT+QENG? +QENG: 1,0 // 查询服务小区等信息 n +QENG: 0,460,00,1806,2602,64,46,-54,189,189,5,8,x,x,x,x,x,x,x Co OK AT+QENG=2 // =2 开启网络参数监控，且自动上报 信息 OK +QENG: 0,460,00,1806,2602,64,46,-54,190,190,5,8,x,x,x,x,x,x,x AT+QENG=0 OK // =0 关闭网络参数监控 上海移远通信技术有限公司 - 42 - GSM 模块 AT 命令应用指导 19.5. 省电模式设置 AT+QSCLK? +QSCLK: 0 // 查询省电模式设置 // 默认为0，禁止进入省电模式 OK AT+QSCLK=1 OK // =1 允许进入省电模式 AT+QSCLK=0 // =0 禁止进入省电模式 OK CQouneficdteenl tial 上海移远通信技术有限公司 - 43 - Shanghai Quectel Wireless Solutions Co., Ltd. Room 801, Building E, No.1618, Yishan Road, Shanghai, China 201103 Tel: +86 21 5108 2965 Mail: info@quectel.com

GSM无线通信模块 GSM模块MMS命令 应用指导 GSM 模块 MMS 命令应用指导 文档名 版本 日期 状态 GSM 模块 MMS 命令应用指导 1.4 2015-05-04 正式发布 版权： 版权所有 ©上海移远通信技术有限公司 2015。 保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2015 非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不 CQouneficdteenl tial 得以任何形式传播。 上海移远通信技术有限公司 - 1 - GSM 模块 MMS 命令应用指导 目录内容 目录内容...........................................................................................................................................2 0. 修改记录......................................................................................................................................3 1. 概要..............................................................................................................................................4 1.1. 参考文档............................................................................................................................4 2. 模块开关机流程和重启方式......................................................................................................5 2.1. 模块开机流程....................................................................................................................5 2.2. 模块正常运行状态............................................................................................................7 2.3. 模块关机流程....................................................................................................................7 2.4. 模块重启方式....................................................................................................................8 3. 如何稳定的进行文件上下传......................................................................................................9 3.1. 建议打开 UART 硬件流控功能 .......................................................................................9 3.2. 使用 Checksum 值检查文件的上传和下载是否正确 .....................................................9 l 3.3. 建议使用 ACK mode 来上传文件.................................................................................. 11 te 4. 彩信开发过程注意点................................................................................................................12 4.1. 判断网络是否正常..........................................................................................................12 c l 4.2. 删除彩信..........................................................................................................................13 4.3. 发送和下载彩信过程中需要注意的一些问题 ..............................................................13 ue tia 4.3.1. 发送彩信.................................................................................................................13 4.3.2. 在彩信的发送过程中接收到新彩信通知 .............................................................13 4.3.3. 在彩信的下载过程中接收到新彩信通知 .............................................................14 Q n 4.4. 彩信发送和接收流程图..................................................................................................15 4.4.1. 彩信发送流程.........................................................................................................15 e 4.4.2. 彩信接收流程.........................................................................................................17 Confid 4.4.3. 错误号处理.............................................................................................................19 上海移远通信技术有限公司 - 2 - GSM 模块 MMS 命令应用指导 0. 修改记录 版本 1.00 1.01 1.02 1.3 1.4 日期 2009-11-24 2009-12-23 2009-12-29 2010-6-19 2015-05-04 作者 辛健 辛健 辛健 辛健 张涛 修改内容记录 初始版本 修改图 1、图 2 的图片清晰度 修改彩信发送和接收流程中的等待时间 修改硬件流控相关描述 增加适用模块说明 CQouneficdteenl tial 上海移远通信技术有限公司 - 3 - GSM 模块 MMS 命令应用指导 1. 概要 该文档主要描述MCU进行彩信开发过程中需要注意的一些事项。本文档适用于所有 Quectel GSM模块。 1.1. 参考文档 表 1: 参考文档表 序号 文档名 [1] Mxx_ATC [2] GSM_TCPIP_AN l [3] GSM_MMS_ ATC [4] GSM 模块 AT 命令应用指导 te [5] Mxx_HD CQouneficdential [6] GSM_FILE_ATC 备注 AT 命令集简介 TCPIP 应用指导 彩信相关 AT 命令简介及应用指导 AT 命令操作应用指导 模块硬件接口指导文档 文件操作相关命令文档 上海移远通信技术有限公司 - 4 - GSM 模块 MMS 命令应用指导 2. 模块开关机流程和重启方式 2.1. 模块开机流程 模块开机时，需要用户进行一些配置。譬如模块出厂默认串口是自适应波特率 (AT+IPR=0)，同时出厂默认开启了串口的硬件流控功能（AT+IFC=2,2），MCU在启动模 块的过程中，需要按照自己的应用状况来更改这些配置。 MCU启动模块，要求先把'PWRKEY'引脚电平拉高，然后拉低'EMERG_OFF'引脚大 约20ms后，恢复'EMERG_OFF'为高电平，之后拉低'PWRKEY'引脚电平，这时模块将进 入开机状态。开机过程中，MCU需要按照下面的流程进行配置，完成后再把'PWRKEY'引 CQouneficdteenl tial 脚电平恢复到高电平。 上海移远通信技术有限公司 - 5 - GSM 模块 MMS 命令应用指导 CQouneficdteenl tial 图1:MCU启动模块流程图 流程图中，②执行'AT'命令的主要目的是进行串口同步。当串口处于自适应 波特率状态时，是无法输入AT命令的，同时模块也不会输出任何'RDY'等开机信息，需要 先运行'AT'命令，返回'OK'后，才能运行其它AT命令，这个过程称为串口同步。 流程图中，④、⑤的目的是设置固定波特率，通过 'AT+IPR=xxx&W'命令设 置固定波特率，命令中的'xxx'表示MCU使用的波特率，'&W'表示保存设置，使模块下次 启动后就直接工作在固定波特率下了，这样可以使系统更加稳定。另外需要注意的是，模块 只有在固定波特率状态下，模块启动时才会在串口上输出'RDY'等开机信息。 上海移远通信技术有限公司 - 6 - GSM 模块 MMS 命令应用指导 需要提醒是，Quectel模块出厂默认配置是工作在自适应波特率。在模块运行的过程中， 客户虽然通过'AT+IPR=xxx&W'配置了固定波特率。若客户一旦重新下载更新了 模块的Firmware，这些配置会被恢复到出厂默认配置。 关于'⑦'系统异常处理方式，建议客户重启模块。 2.2. 模块正常运行状态 当 模 块 处 于 正 常 运 行 状 态 ， 'EMERG_OFF' 引 脚 必 须 维 持 在 高 电 平 状 态 ， 'EMERG_OFF'引脚上任何电平跌落动作都将导致模块直接关机。而'PWRKEY'引脚电平 原则上要求在高电平状态，注意'PWRKEY'引脚上的一个下降沿电平信号是一个关机通知 信号，而'PWRKEY'引脚上的一个上升沿电平信号不产生任何影响。 2.3. 模块关机流程 tel 当模块处于正常运行状态，此时'EMERG_OFF'引脚必须维持在高电平状态，而 'PWRKEY'引脚电平也要在高电平状态（假如'PWRKEY'引脚处于低电平状态，那么先 c l 把'PWRKEY'引脚电平拉高）。 ue tia 在上述前提下，MCU进行关机动作，推荐下面两种方式进行关机。 第一种关机方式，在模块运行过程中，使用'AT+QPOWD=1'命令进行关机（具 Q n 体可以参考'GSM模块AT命令应用指导'文档）。运行该关机命令后，模块将输出'NORMAL e POWER DOWN'提示进入后续的关机流程，这个关机流程可能要花费一定的时间，当网络 信号差的情况下，甚至可能花费30秒左右。MCU可以通过检测'STATUS'引脚来判断模块 fid 是否完全关闭。 第二种关机方式：在模块运行过程中，拉低'PWRKEY'引脚电平（'PWRKEY'引脚上 n 的一个下降沿电平信号是一个关机通知信号），保持'PWRKEY'引脚电平为低，一段时间 后（请参考硬件相关文档），模块将输出'NORMAL POWER DOWN'提示进入后续的关机 o 流程，这个关机流程可能要花费一定的时间，当网络信号差的情况下，甚至可能花费30秒左 C 右，而在这个过程中，MCU可以提前先把'PWRKEY'引脚电平恢复到高电平状态。MCU 可以通过检测'STATUS'引脚来判断模块是否完全关闭。 假如上述关机动作没有出现'NORMAL POWER DOWN'提示信息，那么MCU可以使 用 'EMERG_OFF'引脚进行强制关机，方式如下，先把'PWRKEY'引脚电平拉高，然后 拉低'EMERG_OFF'引脚大约20ms后，恢复'EMERG_OFF'为高电平就可以直接强制关机 了。 上海移远通信技术有限公司 - 7 - GSM 模块 MMS 命令应用指导 2.4. 模块重启方式 当 模 块 处 于 正 常 运 行 状 态 ， 此 时 'EMERG_OFF' 引 脚 必 须 维 持 在 高 电 平 状 态 ， 而 'PWRKEY'引脚电平也要在高电平状态（假如'PWRKEY'引脚处于低电平状态，那么先 把'PWRKEY'引脚电平拉高）。 在模块运行过程中，建议客户使用下面两种方式重启模块。 第一种重启操作方式：在模块运行过程中，使用'AT+QPOWD=1'命令进行关 机（具体可以参考'GSM模块AT命令应用指导'文档）。运行该关机命令后，模块将输出 'NORMAL POWER DOWN'提示进入关机状态，然后拉低'PWRKEY'引脚的电平，一直 等到主串口上报'RDY' （或者'Call Ready'等信息，注意这些信息仅仅在固定波特率配置 下才会输出）信息，这些信息提示表示模块启动成功了。然后再恢复拉高'PWRKEY'引脚 电平 。注意，当网 络信号差的 情况下，可能 需要等待 30 秒左右的时间 才会在串口 上出现 'RDY' 等 信 息 提 示 ， 假 如 在 这 个 时 间 内 仍 旧 没 有 出 现 这 些 信 息 ， 那 么 请 做 后 面 的 'EMERG_OFF'重启方式。 tel 第二种重启操作方式：在模块运行过程中，把'PWRKEY'引脚从高电平拉低到低电平 （目的是产生一个下降沿信号，同时保持低电平一段时间，具体可以参考Mxx_HD文档）。 c l 模 块 将 输 出 'NORMAL POWER DOWN' 提 示 进 入 关 机 状 态 ， 后 续 一 直 保 持 拉 低 'PWRKEY'，直到串口上报'RDY' （或者'Call Ready'等信息，注意这些信息仅仅在固定 ue tia 波特率配置下才会输出）信息，这些信息表示模块启动成功了。然后再恢复拉高 'PWRKEY' 引脚电平。注意，当网络信号差的情况下，可能需要等待30秒左右才会在串口上出现'RDY' 等字符信息，假如在这个时间内仍旧没有出现这些信息，那么请做后面的'EMERG_OFF' Q n 重启方式。 e 在上面的重启过程中，可能没有出现'NORMAL POWER DOWN'关机提示信息或后续 fid 的'RDY'等开机信息。在这种情况下，要求MCU通过拉低'EMERG_OFF'引脚的方式来强 制关闭模块，拉低'EMERG_OFF'引脚20毫秒（具体可以参考Mxx_HD文档）后，再拉高 'EMERG_OFF' 引 脚 ， 此 时 如 果 'PWRKEY' 引 脚 是 低 电 平 ， 则 接 着 保 持 低 ， 如 果 n 'PWRKEY' 引脚是高电平，则接着拉低'PWRKEY' 引脚，直到在主串口上出现'RDY' 等开机提示。开机配置流程完毕后，建议恢复拉高'PWRKEY'引脚的电平。 Co 有些客户可能不控制'EMERG_OFF'引脚，而是直接给模块断电的方式来进行强制关 机，这也是可行的一个方法，这时要求把'EMERG_OFF'引脚悬空。 上海移远通信技术有限公司 - 8 - GSM 模块 MMS 命令应用指导 3. 如何稳定的进行文件上下传 在 彩 信 的 发 送 或 接 收 过 程 中 ， 客 户 需 要 使 用 'AT+QFUPL' 、 'AT+QFDWL' 、 'AT+QMMRR=6,…'等命令来上下传文件内容。这些命令需要使用一些支持才能在串口上 进行稳定的传输。 3.1. 建议打开 UART 硬件流控功能 MCU在发送彩信前，需要把文本文件或图片文件通过串口和'AT+QFUPL'命令上传给 模块，建议用户启用UART硬件流控功能（即启用模块引脚RTS、CTS进行流控控制，模块 默认出厂设置是开启硬件流控功能的，请参考AT命令'AT+IFC=2,2'）。 l 当用户接收到彩信，使用'AT+QFDWL'或'AT+QMMRR=6,…'命令把文件内容读取到 MCU中时，推荐用户也启用串口的硬件流控功能。原因是MCU在下载文件的过程中，将接 te 收大量的数据，假如MCU来不及处理这些数据，在没有硬件流控的功能下，MCU可能会丢 失数据。 uec tial 3.2. 使用 Checksum 值检查文件的上传和下载是否正确 Q n 客户使用彩信发送或接收文本文件、图片文件、音频文件时，需要使用'AT+QFUPL' 命令上传文件， 使用 'AT+QFDWL'命令下载文件，使用'AT+QMMRR=6,…'命令读取彩 e 信中文件内容。这些命令都提供checksum的方法来保证数据传输的可靠性。 fid 如客户使用'AT+QFUPL=[,]'命令来上传一个文件，当传输结束 时，模块会上报'+QFUPL: < upload size>,'信息提示。其中表示 模块接收到的数据长度。MCU可以判断一下是否与之前上传的数据长度相等。 n 如果不等，那么说明模块丢数据了。 o MCU在上传文件数据的过程中，可以对上传的数据每2个字节异或(XOR)一下，最后和 C 模块报告的值进行比较。如果不等，那么说明模块接收到的数据有问题，需要 重新上传文件。 举例：如果上传的文件数据长度为9，其16进制值如下： 0x23 0x13 0x65 0x B6 0x76 0x88 0xA3 0xEF 0x55 那么，checksum计算如下： checksum = 0x2313 XOR 0x65B6 XOR 0x7688 XOR 0xA3EF XOR 0x5500 每两个数据组成一组和另一组进行异或XOR，最后一组若不满2个字节，那么用0x00进 上海移远通信技术有限公司 - 9 - GSM 模块 MMS 命令应用指导 行补充。 Module Storage Module MCU MCU Storage Create File Success AT+QFUPL=[,] CONNECT Open File Read File One Block Send One Block Binary Data Write Data to File 接收到的数据小于 ，继续 等待接收 +QFUPL:, 文件数据还没 有发送完，继 续读并发送 Check 上传完整性 ctel l 图 2: MCU上传文件参考流程图 ue tia 图2中，简单描述了MCU上传一个文件的参考流程。MCU需要注意的是在发送 'AT+QFUPL'命令后，MCU需等待接收到'CONNECT'后才可以进行下一步文件数据的发 Q n 送。 e 同理，客户使用'AT+QFDWL='命令来下载一个文件。当传输结束时，模 fid 块会上报'+QFDWL: ,'信息，表示模块实际输 出数据的字节数，MCU可以根据实际接收到字节数和进行比较。如果不等， 那么说明数据有丢失。同时MCU对接收到的数据可以进行checksum运算，若运算得出的值 和模块最后上报的checksum值不一致，说明接收的数据存在问题，需要重新下载。 Con 'AT+QMMRR=6,…'命令的使用方法和'AT+QFDWL'命令一致。 上海移远通信技术有限公司 - 10 - GSM 模块 MMS 命令应用指导 3.3. 建议使用 ACK mode 来上传文件 MCU在发送彩信前，需要把文本文件或图片文件通过串口和'AT+QFUPL'命令上传给 模块。 有些客户可能没有启用UART硬件流控功能，在这个状况下，建议客户启用ACK mode 功能来进行文件的上传，在这个功能模式下，文件能比较稳定的上传，避免数据的丢失。 用户可以通过'AT+QFUPL = 'file name', filesize, 5,1'命令的第四个参数来启用ACK mode功能, 然后模块返回'CONNECT'，MCU接收到'CONNECT'后先发1K字节数据，然 后模块回应一个’A’字符，MCU接收到这个’A’字符后，再发送后续1K字节数据，模块再回 应一个’A’字符……以此进行下去，直到传输结束。 假如文件大小不是1K字节的整数倍，在这种情况下没有影响，当上传的总字节数达到 CQouneficdteenl tial filesize，命令自动结束，并返回'+QFUPL: < upload size>,'结束信息。 上海移远通信技术有限公司 - 11 - GSM 模块 MMS 命令应用指导 4. 彩信开发过程注意点 4.1. 判断网络是否正常 进行彩信发送或下载的前提是网络要正常，建议客户使用定时器定时的运行 'AT+CREG? '和'AT+CGREG? '命令来判断当前网络是否正常，在不正 常的条件下，在累积一定时间后，推荐客户重启系统。 CQouneficdteenl tial 上海移远通信技术有限公司 图 3:网络定时检查流程 - 12 - GSM 模块 MMS 命令应用指导 当网络处于无信号区，这时'AT+CREG? '命令可能返回'+CREG: 0,2'，表示 正在搜索网络。当命令返回'+CREG: 0,3'时，这时可能SIM卡已经欠费或其它原因。只有当 'AT+CREG? ' 返回'+CREG: 0,1'（或'+CREG: 0,5'表示漫游）才表示网络正常。 客 户 在 使 用 'AT+CREG? ' 命 令 进 行 查 询 后 ， 也 同 样 要 求 对 'AT+CGREG? '命令检查。 4.2. 删除彩信 MCU在处理完接收到的彩信后，建议及时删除该彩信，从而能够及时'空出'模块的 存储空间。具体的彩信删除操作可参考'AT+QMMRM'命令描述（详见：GSM_MMS_ATC 文档）。 4.3. 发送和下载彩信过程中需要注意的一些问题 l 4.3.1. 发送彩信 te 发送彩信，操作如下： c l MCU：AT+QMMSEND=1 ue tia 模块：OK Q en 模块：+QMMNOTIFY: 1,0,0 // 启动发送当前的编辑彩信 // 网络状况不佳的情况下，返回OK等待时间可能较长，建 议至少等待 3分钟。 // 返回OK表示网络连接成功 // 提示彩信发送成功信息需等待时间可能比较长，因为 模块在这期间需要发送大量数据 // 彩信发送成功提示 fid 4.3.2. 在彩信的发送过程中接收到新彩信通知 n 彩信的发送过程中，各个阶段需等待的时间较长。在等待过程中可能会收到新彩信通知， o 客户在开发时需要注意，不能丢弃这些通知信息，如下： C MCU： AT+QMMSEND=1 // 启动发送当前编辑的彩信 模块： +QMMNOTIFY: 3,2,0 // 在发送彩信返回OK前收到新彩信 模块： OK // 返回OK表示网络连接成功 模块： +QMMNOTIFY: 3,3,0 模块： +QMMNOTIFY: 1,0,0 // 在发送彩信过程中收到新彩信 // 彩信发送成功提示 上海移远通信技术有限公司 - 13 - GSM 模块 MMS 命令应用指导 4.3.3. 在彩信的下载过程中接收到新彩信通知 彩信的下载过程中，各个阶段需等待的时间较长。在等待过程中可能会收到新彩信通知， 客户在开发时需要注意，不能丢弃这些通知信息，如下： MCU： AT+QMMRECV=1,1 模块： +QMMNOTIFY: 3,2,0 模块： OK // 开始下载一个新彩信 // 在下载彩信返回OK前收到新彩信 // 返回OK表示网络连接成功 模块： +QMMNOTIFY: 3,3,0 模块： +QMMNOTIFY: 2,1,0 // 在下载过程中收到新彩信 // 彩信下载成功提示 CQouneficdteenl tial 注：M35，M72-D，M26，GC65-E，M10只支持发送彩信，不支持接受彩信。 上海移远通信技术有限公司 - 14 - GSM 模块 MMS 命令应用指导 4.4. 彩信发送和接收流程图 4.4.1. 彩信发送流程 CQoun图e4:彩f信发ic送流d程图teenl tial 上海移远通信技术有限公司 - 15 - GSM 模块 MMS 命令应用指导 图中标注①的位置，当运行'AT+QMMSEND=1'命令后，客户需要等待'OK' 返回，在网络状况不佳的情况下，等待'OK' 返回的时间可能较长，建议至少等待 3分钟。 并且在某些状况下模块会直接上报'+CME ERROR: xxxx'等错误信息，表示发送失败。 上述'AT+QMMSEND=1'命令返回'OK'后并不表示彩信完全发送成功了，客 户需要等待'+QMMNOTIFY'通知来判定彩信是否发送成功。图中②的位置，客户需要在 Twait分钟内等待'+QMMNOTIFY'通知信息。其中Twait时间如下预估，假如发送大小为 100K字节左右的彩信，网络上行速度假如为每秒1.5K字节左右，那么Twait时间大概设置为 （（100K/1.5K）秒+3分钟），即大约为4分钟7秒以上。 在发送彩信的过程中，可能有时会返回'+QMMNOTIFY:1,0,3935,(135)Message Size Exceeds'这样的错误信息，表示当前发送的彩信过大，超过了彩信中心的处理能力，彩信中 心返回这样的错误信息。 注意不管是在发送彩信成功后还是在发送彩信失败后，都要求运行'AT+QIDEACT'命 令。 CQouneficdteenl tial 流程中的异常处理推荐使用重启模块的方式。 上海移远通信技术有限公司 - 16 - GSM 模块 MMS 命令应用指导 4.4.2. 彩信接收流程 CQouneficdteenl tial 图 5: 彩信接收流程图 图中标注①的位置，当运行'AT+QMMRECV=x,1'命令后，客户需要等待'OK' 返回，在网络状况不佳的情况下，等待'OK' 返回的时间可能较长，建议至少等待 3分钟。 并且在某些状况下模块会直接上报'+CME ERROR: xxxx'等错误信息，表示接收失败。 上述'AT+QMMRECV=x,1'命令返回'OK'后并不表示彩信完全接收成功了， 客户需要等待'+QMMNOTIFY'通知来判定彩信是否接收成功。图中②的位置，客户需要在 Twait分钟内等待'+QMMNOTIFY'通知信息，其中Twait时间如下预估，假如接收大小为 100K字节左右的彩信，网络下行速度假如为每秒4K字节左右，那么Twait时间大概设置为 上海移远通信技术有限公司 - 17 - GSM 模块 MMS 命令应用指导 （（100K/4K）秒+3分钟），即大约为3分钟25秒以上。 注意不管是在下载彩信成功后还是在下载彩信失败后，都要求运行'AT+QIDEACT'命 令。 另外需要注意的是假如一条彩信通知连续重试了几次都下载失败，即使模块重启网络正 常后下载仍旧失败，那么建议用户使用'AT+QMMRM=0,xxx'命令直接把这个彩信通知删除 掉。 流程中的异常处理推荐使用重启模块的方式。 CQouneficdteenl tial 上海移远通信技术有限公司 - 18 - GSM 模块 MMS 命令应用指导 4.4.3. 错误号处理 上述在彩信发送和接收的过程中，针对出现的各种error code错误号，给客户推荐如下 的处理方式。注意，当返回3937错误号时，表示彩信已下载成功，在这个情况下，客户必须 把彩信当作已下载成功的方式来处理。 CQouneficdteenl tial 上海移远通信技术有限公司 图 6: 彩信错误号处理 - 19 - 上海移远通信技术有限公司 上海市田州路 99 号 9 幢 501 室 200233 电话: +86 21 5108 2965 电子邮箱: info@quectel.com

GSM无线通信模块 GSM模块串口软件 流控应用指导 GSM 模块串口软件流控应用指导 文档名 版本 日期 状态 GSM 模块串口软件流控应用指导 1.1 2015-04-02 正式发布 版权： 版权所有 ©上海移远通信技术有限公司 2015。 保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2015 非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不 CQouneficdteenl tial 得以任何形式传播。 上海移远通信技术有限公司 - 1 - GSM 模块串口软件流控应用指导 目录内容 目录内容...........................................................................................................................................2 0. 修改记录......................................................................................................................................3 1. 概要..............................................................................................................................................4 1.1. 参考文档............................................................................................................................4 2. 应用环境的假设..........................................................................................................................5 3. 启动 Quectel 模块软件流控功能 ...............................................................................................6 4. Quectel 软件流控方案 .................................................................................................................7 5. MCU 软件流控处理流程图.........................................................................................................8 CQouneficdteenl tial 6. MCU 软件流控处理流程伪代码...............................................................................................10 上海移远通信技术有限公司 - 2 - GSM 模块串口软件流控应用指导 0. 修改记录 版本 1.0 1.1 日期 2010-10-8 2015-04-02 作者 辛健 张涛 修改内容记录 初始版本 增加适用模块说明 CQouneficdteenl tial 上海移远通信技术有限公司 - 3 - GSM 模块串口软件流控应用指导 1. 概要 在没有启用串口硬件流控功能的情况下，使用模块的一些数据传输功能，在传输的过程 中数据可能会丢失。基于这种无硬件流控的传输需求，Quectel 提供了软件流控方案。该文 档主要描述 Quectel 模块软件流控应用的方法。 本文档适用于所有Quectel GSM模块。 1.1. 参考文档 表 1: 参考文档表 序号 文档名 l [1] Mxx_ATC CQouneficdteential [2] GSM_UART_AN 备注 AT 命令集简介 串口应用说明 上海移远通信技术有限公司 - 4 - GSM 模块串口软件流控应用指导 2. 应用环境的假设 该文档中，客户端的 CPU 我们定义为 MCU，而 Quectel 模块统称为模块。同时假设 MCU 上的 UART 控制器没有软件流控功能和转义功能，所以需要 MCU 去编写代码来仿真 实现软件流控功能。 其他常用开发平台中，通讯串口一般都支持软件流控功能，但当数据流中存在一些数据 和 XON、XOFF 信号值相等时，流控过程就被打乱了。对于这些平台，要求开发者在发送 数据前先进行转义，然后把转义后的数据包进行发送。同样的方式，在接收流程中数据需要 进行转义，来恢复数据。 CQouneficdteenl tial 上海移远通信技术有限公司 - 5 - GSM 模块串口软件流控应用指导 3. 启动 Quectel 模块软件流控功能 使用Quectel模块软件流控功能，首先需要运行AT+IFC=1,1命令来通知模块启动软件流 控功能，用户可以使用AT&W来保存这个配置。 同时建议用户使用AT+IPR命令在串口上设置成固定波特率进行工作。 CQouneficdteenl tial 上海移远通信技术有限公司 - 6 - GSM 模块串口软件流控应用指导 4. Quectel 软件流控方案 Quectel模块软件流控方案中需要使用以下三个特殊字符：XON(0x11)，XOFF(0x13)， ESCAPE(0x77)。下面解释这些字符功能的各自作用。 当MCU通过串口接收大量数据，而MCU来不及处理这些数据时，可以在串口上直接发 送XOFF字符给模块，通知模块暂停数据的发送。 当MCU部分或全部处理完这些数据后，需要在串口上直接发送XON字符给模块，及时 地通知模块继续后续数据的发送。 在用户将要发送的数据中，本身可能包含0x11，0x13， 0x77这三个个字符，那么要求 MCU把这些数据进行转义后才可以发送。否则模块会误解这些数据为XON，XOFF等控制 字符；0x11转义为0x77 0xEE两个字符，0x13转义为0x77 0xEC两个字符，0x77转义为0x77 l 0x88两个字符；当模块接收到这些带ESCAPE(0x77)前导字符的数据后，会'自动'地恢复 te 成原始数据进行处理。 c l 同样，当MCU通过串口发送大量数据给模块，模块来不及处理这些数据时，模块将在 串口上发送XOFF字符给MCU，通知MCU暂停数据的发送；所以，需要注意的是：当MCU ue tia 在串口上不停地发送大量数据给模块的时候，要有能力或办法'监视'串口上模块发给MCU 的数据，用来判断是否含有XOFF，XON等控制字符。 Q n 当模块处理完部分或全部数据后，模块将在串口上发送XON字符给MCU，通知MCU进 行后续数据的发送。 fide 模块发送数据给MCU时，数据本身可能含有0x11，0x13，0x77等三个字符，那么模块 将把这些数据进行转义后再发给MCU，0x11转义为0x77 0xEE两个字符，0x13转义为0x77 0xEC两个字符，0x77转义为0x77 0x88两个字符；当MCU接收到这些带ESCAPE(0x77)前导 Con 字符后，要把这些数据恢复后再提交给MCU的上层应用进行处理。 上海移远通信技术有限公司 - 7 - GSM 模块串口软件流控应用指导 5. MCU 软件流控处理流程图 下面的MCU软件流控处理流程图仅仅是一个参考建议，MCU可以根据自己的平台特色 进行修改。 CQouneficdteenl tial 图 1: 软件流控MCU发送流程 上海移远通信技术有限公司 - 8 - GSM 模块串口软件流控应用指导 CQouneficdteenl tial 图 2: 软件流控MCU接收流程 上海移远通信技术有限公司 - 9 - GSM 模块串口软件流控应用指导 6. MCU 软件流控处理流程伪代码 #define XON_CHAR 0x11 #define XOFF_CHAR 0x13 #define ESCAPE_CHAR 0x77 #define SEGMENTATION_LENGTH 10 #define RECEIVE_FULL_THRESHOLD 10 #define RECEIVE_EMPTY_THRESHOLD 10 static char UART_SW_PEER_STATUS = XON_CHAR; static char UART_SW_SELF_STATUS = XON_CHAR; static bool ESCAPE_CHAR_status = FALSE; tel Application_SendData(Application_Buffer[],Application_Buffer_DataLength) { c l Application_Buffer_pos = 0; ue tia //split Application_Buffer to small segmentation to send for(;Application_Buffer_DataLength>0;) { Q n //check allow send while(!Uart_CheckAllowSend()); fide //split small data to send if(Application_Buffer_DataLength > SEGMENTATION_LENGTH) { n Data_Buffer_DataLength = SEGMENTATION_LENGTH; Application_Buffer_DataLength -= SEGMENTATION_LENGTH; o } Celse { Data_Buffer_DataLength = Application_Buffer_DataLength; Application_Buffer_DataLength = 0; } //convert data Convert_Buffer_DataLength = Convert_Buffer_DataLength = Convert_SendData(Application_Buffer[Application_Buffer_pos],Data_Buffer_DataLength, Convert_Buffer); Application_Buffer_pos += Data_Buffer_DataLength; 上海移远通信技术有限公司 - 10 - GSM 模块串口软件流控应用指导 //uart send Uart_SendData(Convert_Buffer, Convert_Buffer_DataLength); //must check uart send complete while(!Uart_CheckDataCompleteSendOut()); } } int Convert_SendData(Data_Buffer[],Data_Buffer_DataLength, Convert_Buffer[]) { i=0; Convert_pos = 0; for(i=0;i= RECEIVE_FULL_THRESHOLD) && (UART_SW_SELF_STATUS == XON_CHAR)) { l Uart_SendOneByte(XOFF_CHAR); UART_SW_SELF_STATUS = XOFF_CHAR; te } } c l } ue tia //notify application receive data, application copy data to application buffer Application_NotifyDataReceive(); Q en } fid bool Uart_CheckExistData(void) { //Check uart rx fifo exist data n } o char Uart_ReadByte(void) C { //read one data from uart fifo } void Uart_SendOneByte(char sendchar) { //Send one data } Application_MoveDataFromReceiveBuffer() 上海移远通信技术有限公司 - 13 - GSM 模块串口软件流控应用指导 { // //move data from ReceiverBuffer[], and reduce ReceiverBuffer_DataLength //..... // if((ReceiverBuffer_DataLength <= RECEIVE_EMPTY_THRESHOLD) && (UART_SW_SELF_STATUS == XOFF_CHAR)) { Uart_SendOneByte(XON_CHAR); UART_SW_SELF_STATUS = XON_CHAR; } } CQouneficdteenl tial 上海移远通信技术有限公司 - 14 - 上海移远通信技术有限公司 上海市田州路 99 号 9 幢 501 室 200233 电话: +86 21 5108 2965 电子邮箱: info@quectel.com

GSM 模块录音 AT 命令详解 GSM 无线通信模块 GSM 模块录音 AT 命令详解 GSM 模块录音 AT 命令详解_V3.2 上海移远通信技术有限公司 -0- GSM 模块录音 AT 命令详解 文档标题 版本 日期 状态 文档受控号 GSM 模块录音 AT 命令详解 3.2 2015-05-08 发布 GSM 模块录音 AT 命令详解_V3.2 前言 移远公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规范，参数 来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。 在未声明前，移远公司有权对该文档规范进行更新。 tel 版权申明 c l 本文档手册版权属于移远公司，任何人未经我公司复制转载该文档将承担法律责任。 ue tia 版权所有 ©上海移远通信技术有限公司 2015，保留一切权利。 CQonfiden Copyright © Quectel Wireless Solutions Co., Ltd. 2015 上海移远通信技术有限公司 -1- GSM 模块录音 AT 命令详解 目录 目录 ..................................................................................................................................................2 表格索引........................................................................................................................................... 3 0. 修改记录.......................................................................................................................................4 1. 简介..............................................................................................................................................5 2. 录音命令.......................................................................................................................................6 2.1. AT+QAUDRD 录音命令...................................................................................................6 2.2. 支持的录音格式................................................................................................................7 2.3. 状态报告............................................................................................................................7 2.4. 错误值说明........................................................................................................................7 2.5. 录音注意事项....................................................................................................................8 2.6. 录音操作举例....................................................................................................................8 2.6.1. 测试模式，打印语法 ..............................................................................................8 2.6.2. 读模式，查看当前是否在录音中 ..........................................................................9 l 2.6.3. 写模式，开始或停止录音 ......................................................................................9 3. 音频播放..................................................................................................................................... 11 te 3.1. AT+QAUDPLAY 播放音频文件...................................................................................... 11 c l 3.2. AT+QAUDSTOP 停止播放音频文件..............................................................................12 3.3. 状态报告..........................................................................................................................12 CQounefidentia 3.4. 音频播放举例..................................................................................................................12 上海移远通信技术有限公司 -2- GSM 模块录音 AT 命令详解 表格索引 表 1：AT+QAUDRD FORMAT 取值....................................................................................................7 表 2：+QAUDRIND CODE...................................................................................................................7 表 3：AT+QAUDRD 错误列表 ............................................................................................................ 8 表 4：+QAUDPIND CODE ................................................................................................................. 12 CQouneficdteenl tial 上海移远通信技术有限公司 -3- GSM 模块录音 AT 命令详解 0. 修改记录 版本 3.0 3.1 3.2 日期 2012-01-12 2012-07-31 2015-05-08 作者 张涛 张涛 张涛 修改内容记录 初始版本 增加主动状态上报的数值说明，修正语法、 格式错误。 增加适用模块说明 CQouneficdteenl tial 上海移远通信技术有限公司 -4- GSM 模块录音 AT 命令详解 1. 简介 该文档主要描述Quectel GSM模块如何录音，如何播放录制的文件，包括AT命令的格式 描述，操作步骤和注意事项。 本文档适用于Quectel M10，M26，M35，GC65-E和M50模块。 CQouneficdteenl tial 上海移远通信技术有限公司 -5- GSM 模块录音 AT 命令详解 2. 录音命令 2.1. AT+QAUDRD 录音命令 语法 命令 AT+QAUDRD=? 响应 响应 +QAUDRD: (0,1),'filename'[,format] OK AT+QAUDRD? 响应 +QAUDRD: l OK AT+QAUDRD= te [,'filename'>[,]] c l 响应 OK/ERROR If error is related to ME functionality: +CME ERROR: ue tia 参数 Q n e 'filename' fid 0 1 0 1 filename format error code 未进行录音 正在进行录音 停止录音 开始录音 存储录音的文件名,参考备注 1 和备注 2 录音编码格式,参考备注 3 错误号请参考表 3 AT+QAUDRD 错误列表 n 备注: Co 1. ：存储录音的文件名 ，字符串类型（必须包括在引号之内），文件后缀名任 意。如果需要将文件存储在 SD 卡中，需在文件名前添加 'SD:' 前缀。如：'Example.wav' 'DirectoryExample.wav' 'SD: Example.amr' 'SD:DirectoryExample.amr'； 2. 当没有输入参数时，文件后缀名决定录音格式。对于'.amr '后缀名的文件采用 amr 编码格式; 对于'.wav' 后缀名的文件，通话状态下采用 ADPCM 编码格式，非通话 状态采用 WAV_PCM16 编码格式； 3. : 当文件后缀名是'amr', 只支持 3（AMR),当文件后缀名是' .wav', 支持 13(PCM 16 bit), 14(a law), 15(ulaw),16(ADPCM), 任意其它后缀名时 参数必须指定。请参考表 1 AT+QAUDRD format 取值列表。 上海移远通信技术有限公司 -6- GSM 模块录音 AT 命令详解 2.2. 支持的录音格式 表 1：AT+QAUDRD format 取值 format 取值 编码方式 采样位数 采样频率 (bit) 编 码 位 数位速 (bit) (kbps) 文件大小 3 amr 16 1 分钟约 40.8KB 13 WAV_PCM16 16 16 128 文件大小(Byte) = 14 WAV_ALAW 16 8 64 (采样频率(HZ) × 编 8KHZ 15 WAV_ULAW 16 16 WAV_ ADPCM 16 码位数(bit) × 声 8 64 道) × 时间(秒) / 8(bit) 4 32 tel 2.3. 状态报告 c l 以下情况录音会被强制停止： ue tia 1. 非通话状态下开始录音：在接通来电时，或者去电 CALL 时，正在进行的录音会被强制 停止。 Q n 2. 通话状态下开始录音：挂断电话时，正在进行的录音会被强制停止。 以上情况，录音被强制停止后，均会向 UART 发送状态报告：+QAUDRIND: e 0, fid 表 2：+QAUDRIND code Code 值 n 0 o 1 3 C 6 意义 此值保留以后使用(达到录音时限/长度限制) 异常错误 磁盘满 被其他音频任务终止 10 没有找到磁盘 2.4. 错误值说明 AT+QAUDRD 执行中有错误时，上报+CME ERROR: ，下表是错误号的说明。 上海移远通信技术有限公司 -7- GSM 模块录音 AT 命令详解 表 3：AT+QAUDRD 错误列表 错误号 原因 备注 4300 错误的 format 注意与后缀名的对应 4302 音频任务忙 例如：已经在录音时，再发 起录音会返回此错误； 4303 打开或创建文件失败 4304 以不同 format 追加录音到同一个文件 Format 必须与已有音频文件 的 format 一致才可以追加录 音 4305 磁盘已满 4306 文件写保护 4499 未知错误 2.5. 录音注意事项 l 1. 如果录音格式一样，重新录音时名字也一样，将采用追加方式录音，后续录音数据将添 te 加在原来录音文件的后面。 c l 2. 支持 SD 卡录音：如果文件名添加了'SD:'前缀，则存储于 SD 卡中，否则存储于 Flash 文件系统用户区(UFS)中。如果是录到 Flash 中，默认存放于 UFS 文件夹下，访问时直 ue tia 接以文件名访问即可；如果是录到 SD 卡中，默认存放于 SD 卡分区的根目录，访问时 需要添加前缀'SD：'。例如 AT+QAUDRD=1,'SD:test.wav'会在 SD 卡根目录下创建 test.wav. Q n 3. 录音通道：请使用AT+QAUDCH命令改变。 4. 录至子目录：请首先创建好需要的文件夹，再以 'Dirfile.wav' 或 'SD:Dirfile.wav' e 作为文件名录音即可。 fid 5. 注意编码格式(format)与文件后缀名并非一一对应，在以追加方式录音时需要特别注意。 n 2.6. 录音操作举例 Co 2.6.1. 测试模式，打印语法 AT+QAUDRD=? +QAUDRD: (0-1), 'filename'[,format] OK 上海移远通信技术有限公司 -8- GSM 模块录音 AT 命令详解 2.6.2. 读模式，查看当前是否在录音中 AT+QAUDRD? +QAUDRD: 0 OK +QAUDRD: 1 OK // 未录音 // 处于录音中 2.6.3. 写模式，开始或停止录音 AT+QAUDCH=1 l OK te AT+QAUDRD=1,'test.wav' OK uec tial AT+QAUDRD=0 OK Q n AT+QAUDRD=1,'SD:test.abc',15 e OK fid AT+QAUDRD=0 OK n ATD10086; OK Co AT+QAUDRD=1,'test.amr' // 设置音频通道 // 开始录音 // 停止录音 // 开始录音 // 停止录音 OK // 开始录音 AT+QAUDRD=1,'another.wav' +CME ERROR 4302 // 忙，已在录音中 AT+QAUDRD=0 OK // 停止录音 AT+QAUDRD=1,'test.extesion', 14 上海移远通信技术有限公司 -9- GSM 模块录音 AT 命令详解 OK AT+QAUDRD=0 OK // 开始录音 // 停止录音 CQouneficdteenl tial 上海移远通信技术有限公司 -10- GSM 模块录音 AT 命令详解 3. 音频播放 AT+QAUDPLAY 播放音频文件，AT+QAUDSTOP 停止播放。 3.1. AT+QAUDPLAY 播放音频文件 语法 命令 响应 AT+QAUDPLAY=? +QAUDPLAY: 'filename',(0-1),(0-100), [(1-2)] OK AT+QAUDPLAY= 'filename', l ,,[] 响应 OK/ERROR If error is related to ME functionality: +CME ERROR: te 参数 c l ue tia Q n filename 0 1 0-100 1 2 参见备注 1，2 不重复 重复 音量 Headset Loud Speaker e 备注: fid 1. 'filename'：音频文件名 ，字符串类型（必须包括在引号之内）。 如果需要播放 SD 卡 中的音频文件，需在文件名前添加 'SD:' 前缀。 如：'Example.wav' 'SD:Example.amr'. n 2. 文件名需要以.wav，.mp3 或 .amr 结尾。 3. 子文件夹下文件的播放，UFS 下采用'采用夹下文件的播放，r 用夹下文件的形式作为 o 文件名，SD 卡中采用'SD:Direxample.wav'形式作为文件名。 C 4. 省略时，输出通道由 AT+QAUDCH 决定。 上海移远通信技术有限公司 -11- GSM 模块录音 AT 命令详解 3.2. AT+QAUDSTOP 停止播放音频文件 语法 命令 AT+QAUDSTOP =? AT+QAUDSTOP 响应 响应 +QAUDSTOP OK 响应 OK/ERROR If error is related to ME functionality: +CME ERROR: 3.3. 状态报告 l 音 频 播 放 停 止 ( 包 括 播 放 完 成 以 及 被 其 他 音 频 任 务 终 止 等 ) 时 会 上 报 +QAUDPIND:0, te 表 4：+QAUDPIND code c l Code值 ue tia 5 6 9 意义 到达文件结尾 被其他音频任务终止 异常错误 Q en 3.4. 音频播放举例 fid AT+QAUDPLAY='test.wav', 1, 60, 1 OK on AT+QAUDSTOP C OK // 播放录音 // 停止播放 上海移远通信技术有限公司 -12- GSM 模块录音 AT 命令详解 上海移远通信技术有限公司 上海移远通信技术有限公司 上海市徐汇区田州路 99 号 13 幢 501 室 电话: +86 21 5108 6236 邮箱: info@quectel.com -13-

MC20-TE-A User Guide GSM/GPRS/GNSS Module Series Rev. MC20-TE-A_User_Guide_V2.0 Date: 2016-09-27 www.quectel.com GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233 Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/salesupport.aspx For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/techsupport.aspx l Or email to: Support@quectel.com te GENERAL NOTES c l QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION ue tia 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 Q n RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO e CHANGE WITHOUT PRIOR NOTICE. fid COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF n QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT o PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS C ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2016. All rights reserved. MC20-TE-A_User_Guide Confidential / Released 1 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide About the Document History Revision 1.0 2.0 Date 2016-07-22 Author Tiger CHENG CQouneficdteenl tial 2016-09-27 TigerCHENG Description Initial 1. Added figures for reference in Chapter 5. 2. Added using main UART and UART3 to communicate with GNSS part in Chapter 5.3.3. MC20-TE-A_User_Guide Confidential / Released 2 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Safety Information ................................................................................................................... 7 2 Product Concept .................................................................................................................................. 8 2.1. MC20-TE-A Top and Bottom View........................................................................................... 8 3 4 5 6 7 Interface Application of MC20-TE-A ................................................................................................ 10 3.1. SIM2 Card Interface .............................................................................................................. 10 3.2. Test Points ............................................................................................................................. 11 l MC20-TE-A Accessories Assembly ................................................................................................. 13 te Illustration ........................................................................................................................................... 14 5.1. Power on ............................................................................................................................... 14 c l 5.2. Communicate with GSM Part of the Module......................................................................... 15 5.3. Communicate with GNSS Part of the Module....................................................................... 17 ue tia 5.3.1. Use Main UART (All-in-one Solution) ............................................................................ 17 5.3.2. Use UART3 (Stand-alone Solution) ............................................................................... 17 5.3.3. Use Main UART and UART3 ......................................................................................... 19 Q n 5.4. Firmware Upgrade through Main UART Port........................................................................ 20 5.5. Compatible Design and Applications..................................................................................... 20 e 60-pin Assignment............................................................................................................................. 23 Confid Appendix A References..................................................................................................................... 25 MC20-TE-A_User_Guide Confidential / Released 3 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Table Index TABLE 1: PINS OF SIM2 CARD INTERFACE .................................................................................................. 10 TABLE 2: PINS OF TEST POINTS.....................................................................................................................11 TABLE 3: PIN DEFINITION OF THE 60-PIN DIP CONNECTOR ..................................................................... 23 TABLE 4: RELATED DOCUMENTS .................................................................................................................. 25 CQouneficdteenl tial MC20-TE-A_User_Guide Confidential / Released 4 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Figure Index FIGURE 1: MC20-TE-A TOP VIEW ..................................................................................................................... 8 FIGURE 2: MC20-TE-A BOTTOM VIEW............................................................................................................. 9 FIGURE 3: SIM2 CARD INTERFACE ............................................................................................................... 10 FIGURE 4: TEST POINTS..................................................................................................................................11 FIGURE 5: MC20-TE-A TOOLKIT ACCESSORIES .......................................................................................... 13 FIGURE 6: CONNECTION BETWEEN MC20-TE-A AND GNSS/GSM ANTENNA .......................................... 14 FIGURE 7: S101/S102 SWITCH STATUS INDICATION................................................................................... 15 FIGURE 8: S101/S102 SWITCH STATUS ON MAIN UART WHEN COMMUNICATING WITH GSM PART ... 15 FIGURE 9: S101/S102 SWITCH STATUS ON UART3 WHEN COMMUNICATING WITH GSM PART ........... 16 FIGURE 10: S101/S102 SWITCH STATUS ON MAIN UART WHEN COMMUNICATING WITH GNSS PART 17 FIGURE 11: S101/S102 SWITCH STATUS ON UART3 WHEN COMMUNICATING WITH GNSS PART ....... 18 FIGURE 12: USER INTERFACE OF POWERGPS TOOL................................................................................ 18 FIGURE 13: J106 SHORT CIRCUIT CONNECTION........................................................................................ 19 l FIGURE 14: S101/S102 SWITCH STATUS ON MAIN UART&UART3 WHEN COMMUNICATING WITH GNSS PART ................................................................................................................................................................. 19 te FIGURE 15: SWITCH S101/S102 TO ON STATE............................................................................................. 20 FIGURE 16: USING A PASSIVE ANTENNA ..................................................................................................... 21 c l FIGURE 17: USING THE BUILT-IN BLUETOOTH ANTENNA.......................................................................... 21 ue tia FIGURE 18: USING AN EXTERNAL BLUETOOTH ANTENNA........................................................................ 22 CQonfiden FIGURE 19: DIP CONNECTOR OF MC20-TE-A.............................................................................................. 23 MC20-TE-A_User_Guide Confidential / Released 5 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 1 Introduction In order to help customers to develop applications with Quectel MC20 module, Quectel supplies corresponding evaluation board (EVB) kit and TE-A kit to test the module. This document can help customers quickly understand MC20-TE-A interface specifications, electrical and mechanical details and know how to use it. MC20-TE-A is intended to be used in combination with GSM EVB for MC20 module testing and CQouneficdteenl tial evaluation. For detailed description of GSM EVB, please refer to document [4]. MC20-TE-A_User_Guide Confidential / Released 6 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 1.1. Safety Information The following safety precautions must be observed during all phases of the operation, such as usage, service or repair of any cellular terminal or mobile incorporating Quectel module. Manufacturers of the cellular terminal should send the following safety information to users and operating personnel, and incorporate these guidelines into all manuals supplied with the product. If not so, Quectel assumes no liability for customer’s failure to comply with these precautions. Full attention must be given to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. You must comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. Make sure it is switched off. The operation of wireless appliances in an aircraft is forbidden, so as l to prevent interference with communication systems. Consult the airline staff about the use of wireless devices on boarding the aircraft, if your device offers an te Airplane Mode which must be enabled prior to boarding an aircraft. c l Switch off your wireless device when in hospitals, clinics or other health care ue tia facilities. These requests are desinged to prevent possible interference with sensitive medical equipment. Cellular terminals or mobiles operating over radio frequency signal and cellular Q n network cannot be guaranteed to connect in all conditions, for example no mobile fee or with an invalid SIM card. While you are in this condition and need emergent e help, please remember using emergency call. In order to make or receive a call, fid the cellular terminal or mobile must be switched on and in a service area with adequate cellular signal strength. Your cellular terminal or mobile contains a transmitter and receiver. When it is ON, n it receives and transmits radio frequency energy. RF interference can occur if it is oused close to TV set, radio, computer or other electric equipment. CIn locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as your phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders, etc. MC20-TE-A_User_Guide Confidential / Released 7 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 2 Product Concept 2.1. MC20-TE-A Top and Bottom View Qouneficdteenl tial A: Serialselectorswitch C B: GSM antenna interface Figure 1: MC20-TE-A Top View C: GNSS antenna interface D: BT antenna interface E: LED indicator MC20-TE-A_User_Guide Confidential / Released 8 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide uectel tial F: SIM2 card interface G: Test points Figure 2: MC20-TE-A Bottom View Q n NOTES e 1. Some interfaces and test pins are reserved only for engineers to debug some functions which are not fid used for customers. Con 2. Some functions are only supported in certain software versions. MC20-TE-A_User_Guide Confidential / Released 9 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 3 Interface Application of MC20-TE-A 3.1. SIM2 Card Interface Queficdteenl tial Figure3:SIM2CardInterface n Table 1: Pins of SIM2 Card Interface Co Pin Signal I/O Description 1 CD1 Connect to ground 2 CD2 Reserved 3 SIM_DATA I/O SIM card data I/O 4 SIM_CLK O SIM card clock 5 VPP Reserved 6 SIM_RST O SIM card reset MC20-TE-A_User_Guide Confidential / Released 10 / 25 7 GND 8 SIM_VDD 9 GND 10 GND GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Ground Power supply for SIM card Ground Ground 3.2. Test Points CQouneficdteenl tial Table2:PinsofTestPoints Figure 4: Test Points Pin Signal I/O Description 1 PCM_CLK/SPI_CS O PCM clock 2 PCM_SYNC/SPI_MISO O PCM frame synchronization 3 TXD_AUX O Transmit data 4 PCM_IN/SPI_CLK I PCM data input 5 GND Ground MC20-TE-A_User_Guide Confidential / Released 11 / 25 6 GNSS_VCC_EN O 7 PCM_OUT/SPI_MOSI I/O 8 RXD_AUX I 9 I2C_SCL28 10 I2C_SDA28 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide GNSS power enabled General purpose input/output port Receive data Reserved Reserved CQouneficdteenl tial MC20-TE-A_User_Guide Confidential / Released 12 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 4 MC20-TE-A Accessories Assembly Queficdteenl tial Figure5:MC20-TE-AToolkitAccessories A: GNSS antenna n B: CD Co C: GNSS antenna patch lead MC20-TE-A_User_Guide Confidential / Released 13 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 5 Illustration MC20-TE-A kit is intended to be used in combination with GSM EVB for MC20 module testing and evaluation. The connection between MC20-TE-A and GNSS/GSM antenna can refer to the following figure. Quecteenl tial Figure 6: Connection between MC20-TE-A and GNSS/GSM Antenna fid 5.1. Power on on Power on procedure of MC20-TE-A is controlled by GSM EVB. Please refer to document [4] for detailed C power on procedures. MC20-TE-A_User_Guide Confidential / Released 14 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 5.2. Communicate with GSM Part of the Module (1) If the main UART is used for communication with GSM part of MC20 module, please turn the S101 and S102 switch to ON state on MC20-TE-A, and then connect the main UART of EVB to PC’s USB port with the USB to UART converter cable. This is the recommended method. Switch status description is available in the following figures. CQouneficdteenl tial Figure 7: S101/S102 Switch Status Indication Figure 8: S101/S102 Switch Status on Main UART When Communicating with GSM Part If the UART3 is used for communication with the GSM part, please turn the S101 switch to OFF and S102 switch to ON state on MC20-TE-A, and then connect the UART3 on EVB to PC’s USB port with the USB to UART converter cable. Currently, the software does not support this method. MC20-TE-A_User_Guide Confidential / Released 15 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Figure 9: S101/S102 Switch Status on UART3 When Communicating with GSM Part l (2) Open the QCOM (AT command window) on PC. Set appropriate Baud Rate (such as 115200bps) and COM number which can be checked by the Device Manager on PC. te (3) Connect the antenna to the GSM_ANT on MC20-TE-A with an RF cable. c l (4) Insert SIM card into the SIM card socket. ue tia (5) Insert earphone or handset into audio interface. (6) For power on procedure, please refer to document [4]. Q n (7) After waiting for 2~3 seconds, customers should first input 'AT' or 'at' string once or more until e receiving 'OK' from the module in the HyperTerminal. fid The module is set to autobauding mode in default configuration. This operation is to synchronize the baud rate between the computer and the module. Con (8) Input AT command and the module will execute its corresponding functions. MC20-TE-A_User_Guide Confidential / Released 16 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 5.3. Communicate with GNSS Part of the Module 5.3.1. Use Main UART (All-in-one Solution) (1) Turn the S101 and S102 switch to ON state on MC20-TE-A, and then connect the main UART of EVB to PC’s USB port with the USB to UART converter cable. This is the recommended method. ctel l Figure 10: S101/S102 Switch Status on Main UART When Communicating with GNSS Part ue tia (2) Open the QCOM (AT command window) on PC. Set appropriate Baud Rate (such as 115200bps) and COM number which can be checked by the Device Manager on PC. Q n (3) Connect the antenna to the GNSS_ANT on MC20-TE-A with an RF cable. e (4) For power on procedure, please refer to document [4]. fid (5) After waiting for 2~3 seconds, customers should first input 'AT' or 'at' string once or more until receiving 'OK' from the module in the HyperTerminal. n (6) Send corresponding AT commands to power on/off the GNSS part. When GNSS is powered on, the o LED D102 on MC20-TE-A will be lighted and NMEA data will be output. For details of the C corresponding AT commands, please refer to document [1]. 5.3.2. Use UART3 (Stand-alone Solution) (1) Turn the S101 switch to ON and S102 switch to OFF state on MC20-TE-A, and then connect the main UART and UART3 of EVB to PC’s USB ports with the USB to UART converter cables. MC20-TE-A_User_Guide Confidential / Released 17 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide Figure 11: S101/S102 Switch Status on UART3 When Communicating with GNSS Part (2) Connect the antenna to the GNSS_ANT on MC20-TE-A with an RF cable. l (3) Insert the plug of the 5V power adapter. Turn the S202 switch to ON state on the EVB. The LED D503 on the EVB will be lighted. te (4) Send AT+QGNSSC=1 command via main UART to power on the GNSS part, and the LED D102 on c l MC20-TE-A will be lighted. For details of the corresponding AT commands, please refer to document [1]. ue tia (5) NMEA data will be received via UART3 and PMTK commands can be sent via UART3. Q n (6) The PowerGPS tool can be used to view the status of GPS&GLONASS receiver conveniently. When Confide the tool is opened, the user interface as shown below will be displayed. Figure 12: User Interface of PowerGPS Tool MC20-TE-A_User_Guide Confidential / Released 18 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 5.3.3. Use Main UART and UART3 In this solution, customers can send AT commands about GNSS and get the data of GNSS via main UART. At the same time, NMEA data will be received from UART3. (1) Use a short circuit cap to connect the J106. uectel tial Figure 13: J106 Short Circuit Connection Q n (2) Turn the S101 and S102 switch to ON state on MC20-TE-A, and then connect the main UART and Confide UART3 of EVB to PC’s USB ports with the USB to UART converter cables. Figure 14: S101/S102 Switch Status on Main UART&UART3 When Communicating with GNSS Part MC20-TE-A_User_Guide Confidential / Released 19 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide (3) Connect the antenna to the GNSS_ANT on MC20-TE-A with an RF cable. (4) Insert the plug of the 5V power adapter. Turn the S202 switch to ON state on the EVB. The LED D503 on the EVB will be lighted. (5) Send AT+QGNSSC=1 command via main UART to power on the GNSS part, and the LED D102 on MC20-TE-A will be lighted. For details of the corresponding AT commands, please refer to document [1]. (6) Send AT commands about GNSS and get the data of GNSS via main UART. (7) NMEA data will be received via UART3. 5.4. Firmware Upgrade through Main UART Port (1) Switch the S101 and S102 on MC20-TE-A to ON state. Queficdteenl tial Figure 15: Switch S101/S102 to ON State n (2) Start the firmware upgrade tool on PC. Co (3) Press the START button in the firmware upgrade tool. (4) Switch the S201 and S202 on the EVB to ON state. For details, please refer to document [4]. 5.5. Compatible Design and Applications When testing the GNSS function, a passive antenna is recommended to be used. In this case, there is no need to mount resistor R101 (10 ohm, 0805 package). If an active antenna is used, then R101 should be mounted. MC20-TE-A_User_Guide Confidential / Released 20 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide l Figure 16: Using a Passive Antenna te When testing the BT function, the built-in Bluetooth antenna of MC20-TE-A is recommended to be used. In c l this case, resistor R109 (0 ohm, 0402 package) is mounted, while resistor R105 (0 ohm, 0402 package) is not mounted. If an external Bluetooth antenna is used, then R105 should be mounted and R109 should not CQounefidentia be mounted. Figure 17: Using the Built-in Bluetooth Antenna MC20-TE-A_User_Guide Confidential / Released 21 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide CQouneficdteenl tial Figure 18: Using an External Bluetooth Antenna MC20-TE-A_User_Guide Confidential / Released 22 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 6 60-pin Assignment uectel tial Figure 19: DIP Connector of MC20-TE-A Q en Table 3: Pin Definition of the 60-pin DIP Connector fid Pin No. Pin Name I/O 1 VBAT I n 3 VBAT I Co 5 VBAT I Pin No. Pin Name I/O 2 GND 4 GND 6 GND 7 VBAT I 8 GND 9 VBAT I 10 GND 11 12 ADC0 I 13 14 VRTC I/O 15 VDD_EXT O 16 NETLIGHT O 17 PWRKEY I 18 KBR0 O MC20-TE-A_User_Guide Confidential / Released 23 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 19 20 KBR1 O 21 GPIO0 I/O 22 KBR2 O 23 24 TXD3 O 25 SIM1_VDD O 26 RXD3 I 27 SIM1_RST O 28 KBC0 I 29 SIM1_DATA I/O 30 KBC1 I 31 SIM1_CLK O 32 33 35 37 39 41 43 45 47 49 51 53 55 57 59 SIM1_PRESENCE I 34 36 DCD O 38 SD_CMD O l DTR I 40 SD_CLK O te RXD I 42 SD_DATA I/O c l TXD O 44 ue tia RTS I 46 CTS O 48 DBG_RXD I Q n RI O 50 DBG_TXD O e 52 fid SPK1P O 54 MICP I SPK1N O 56 MICN I n SPK2P O 58 MICP I Co 60 MICN I MC20-TE-A_User_Guide Confidential / Released 24 / 25 GSM/GPRS/GNSS Module Series MC20-TE-A User Guide 7 Appendix A References Table 4: Related Documents SN Document Name Remark [1] [2] [3] [4] Quectel_MC20_AT_Commands_Manual Quectel_GSM_UART_Application_Note Quectel_MC20_Hareware_Design CQouneficdteenl tial Quectel_GSM_EVB_User_Guide MC20 AT commands manual Serial port application note MC20 Hardware design GSM EVB user guide MC20-TE-A_User_Guide Confidential / Released 25 / 25

Android GNSS Driver 用户指导 GNSS/GSM/UMTS/LTE 模块系列 版本：Android_GNSS_Driver_用户指导_V1.0 日期：2019-11-25 状态：受控文件 www.quectel.com Android GNSS Driver 用户指导 上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助，请随时 联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 51086236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录： http://www.quectel.com/cn/support/sales.htm 如需技术支持或反馈我司技术文档中的问题，可随时登陆如下网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com 前言 上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规 范、参数来设计其产品。由于客户操作不当而造成的人身伤害或财产损失，本公司不承担任何责任。在未 声明前，上海移远通信技术股份有限公司有权对该文档进行更新。 版权申明 本文档版权属于上海移远通信技术股份有限公司，任何人未经我司允许而复制转载该文档将承担法律责任。 版权所有 ©上海移远通信技术股份有限公司 2019，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2019. 上海移远通信技术股份有限公司 1 / 13 Android GNSS Driver 用户指导 文档历史 修订记录 版本 1.0 日期 2019-11-25 作者 高鹏 变更表述 初始版本 上海移远通信技术股份有限公司 1 / 13 Android GNSS Driver 用户指导 目录 文档历史 ....................................................................................................................................................... 1 目录 .............................................................................................................................................................. 2 表格索引 ....................................................................................................................................................... 3 图片索引 ....................................................................................................................................................... 4 1 引言 ....................................................................................................................................................... 5 2 系统集成 ................................................................................................................................................ 6 2.1. Android GNSS 驱动架构 ............................................................................................................ 6 2.2. GNSS 驱动安装.......................................................................................................................... 7 2.3. 删除不必要的 GNSS 驱动文件................................................................................................... 7 3 获取 GNSS 日志.................................................................................................................................... 8 4 GNSS 驱动测试..................................................................................................................................... 9 5 补充说明 .............................................................................................................................................. 10 5.1. 修改 GNSS 配置文件 ............................................................................................................... 10 5.2. 获取 GNSS 数据失败 ............................................................................................................... 10 6 附录 ..................................................................................................................................................... 13 上海移远通信技术股份有限公司 2 / 13 Android GNSS Driver 用户指导 表格索引 表 1：适用模块 .................................................................................................................................................... 5 表 2：参考文档 .................................................................................................................................................. 13 表 3：术语和缩写............................................................................................................................................... 13 上海移远通信技术股份有限公司 3 / 13 Android GNSS Driver 用户指导 图片索引 图 1：ANDROID GNSS 架构（以 EC25 为例）.................................................................................................. 6 图 2：使用 GPS TEST V1.5.4.APK 的 GNSS 测试效果图 .................................................................................. 9 上海移远通信技术股份有限公司 4 / 13 Android GNSS Driver 用户指导 1 引言 本文档主要介绍如何在 Android 系统中移植移远通信 Android GNSS 驱动、获取 GNSS 相关日志以及 如何调试 GNSS 功能。 本文档适用的模块系列详情见表 1。 表 1：适用模块 GNSS 模块系列 GSM 模块系列 UMTS 模块系列 LTE 模块系列 所有 GNSS 模块系列 MCxx：MC20、MC30、MC25 UC20 AGxx：AG15、AG35 EGxx：EG06、EG12、EG18 EPxx：EP06 EMxx：EM06、EM12 EC2x：EC21、EC25、EC20 R2.0、EC20 R2.1 EG9x：EG91、EG95 EG2x-G：EG25-G、EG21-G EM05 BGxx：BG36、BG77、BG95 BC39 备注 本文档不适用于 EG91-E 和 EG95-E。 上海移远通信技术股份有限公司 5 / 13 Android GNSS Driver 用户指导 2 系统集成 本章节介绍 Android GNSS 驱动架构以及如何将移远通信 GNSS 驱动移植到 Android 系统中。 2.1. Android GNSS 驱动架构 Android GNSS 驱动架构如下图所示，其中下层为上层服务，数据由下至上逐层传递。移远通信 GNSS 驱动在 HAL 层运行。 应用 程序 应用 程序框 架 JNI HAL（EC25 GNSS驱动） Linux Kernel（EC25 USB驱动） GNSS设备（EC25） 图 1：Android GNSS 架构（以 EC25 为例） 上海移远通信技术股份有限公司 6 / 13 Android GNSS Driver 用户指导 2.2. GNSS 驱动安装 将 gps.default.so 与 gps_cfg.inf 按照如下方式放入 Android 系统中。 1. Android 8.0 及以上版本 ⚫ 32 位 Android 系统 gps_cfg.inf → /vendor/etc gps.default.so → /vendor/lib/hw ⚫ 64 位 Android 系统 gps_cfg.inf → /vendor/etc gps.default.so → /vendor/lib64/hw 2. Android 8.0 以下版本 ⚫ 32 位 Android 系统 gps_cfg.inf → /system/etc gps.default.so → /system/lib/hw ⚫ 64 位 Android 系统 gps_cfg.inf → /system/etc gps.default.so → /system/lib64/hw 2.3. 删除不必要的 GNSS 驱动文件 请删除文件夹/systemvendor/lib64lib/hw/下不必要的 gps.*.so 文件，确保系统中仅保留 gps.default.so 文件，以便系统能够识别正确的 GNSS 驱动。 上海移远通信技术股份有限公司 7 / 13 Android GNSS Driver 用户指导 3 获取 GNSS 日志 本章节主要介绍如何获取 GNSS 日志。 1. 执行以下命令，在 Windows/Linux 侧使用 ADB 工具获取 GNSS 日志： adb logcat –s gps_ql –v time 2. 在无人值守的情况下，可执行下列命令在后台获取日志： adb shell logcat –s gps_ql –v time –f & 获取日志后，执行下列命令将 Android 设备上的日志文件导出到本地： adb pull 上海移远通信技术股份有限公司 8 / 13 Android GNSS Driver 用户指导 4 GNSS 驱动测试 驱动与配置文件正确集成到 Android 系统后，选择一个 GNSS 测试应用，例如 GPS TEST v1.5.4.APK， 运行并确认应用工作正常。 图 2：使用 GPS TEST v1.5.4.APK 的 GNSS 测试效果图 备注 图中编号大于 160 的卫星为北斗导航系统。 上海移远通信技术股份有限公司 9 / 13 Android GNSS Driver 用户指导 5 补充说明 5.1. 修改 GNSS 配置文件 移远通信 GNSS 驱动的配置文件是 gps_cfg.inf，需根据具体模块类型做相应修改，具体如下： 1. 修改 NMEA 端口 ⚫ 移远通信 GNSS 模块（例如 L76）： NMEA_PORT_PATH=Serial name BAUD_RATE=115200 ⚫ 移远通信 GSM&UMTS&LTE 模块（例如 UC20、MC20、EC21）： NMEA_PORT_PATH=rild-nmea 2. 对于移远通信 GSM&UMTS&LTE 模块，在集成 Android GNSS 驱动之前还需先集成 Android RIL 驱 动 。 具 体 请 参 考 文 档 《 Quectel_Android_RIL_Driver_ 用 户 指 导 》。 建 议 使 用 Quectel_Android_RIL_Driver_V2.6.8 及以上版本的 RIL 驱动。 5.2. 获取 GNSS 数据失败 若应用获取 GNSS 数据失败，请检查以下条目： ⚫ 确保天线能够接收到 GNSS 信号。 ⚫ 文件夹/systemvendor/lib64lib/hw 中，gps.*.so 格式的文件只有 gps.default.so。 ⚫ gps_cfg.inf 文件根据具体的模块类型修改并放入 Android 系统中指定的位置。 上海移远通信技术股份有限公司 10 / 13 Android GNSS Driver 用户指导 如果系统版本为 Android 8.0 及以上版本，除上述问题之外，还需检查和确认以下文件（以 rk3399 平 台为例）。 1. 如果日志中循环出现'Cannot find entry android.hardware.gnss@1.0::IGnss/default in either framework or device manifest'： ⚫ 检查确认 device/rockchip/rk3399/manifest.xml 中是否包含下图白框中所示的内容。 2. 如 果 日 志 中 循 环 出 现 ' Waited one second for android.hardware.gnss@1.0::IGnss/default. Waiting another... '： ⚫ 检查确认 device/rockchip/rk3399/BoardConfig.mk 中是否包含下图白框中所示的内容。 ⚫ 检查确认 device/rockchip/rk3399/device.mk 中是否包含下图白框中所示的内容。 上海移远通信技术股份有限公司 11 / 13 Android GNSS Driver 用户指导 ⚫ 检查确认 device/rockchip/rk3399/init.rk3399.rc 中是否包含下图白框中所示的内容。 检查完成上述条目之后，若问题仍未解决，请联系移远通信技术支持。 上海移远通信技术股份有限公司 12 / 13 Android GNSS Driver 用户指导 6 附录 表 2：参考文档 序号 [1] 文档名称 Quectel_Android_RIL_Driver_User_Guide 备注 Android RIL 驱动用户指导 表 3：术语和缩写 缩写 ADB GNSS GPS GSM HAL JNI LTE NMEA PIN UMTS USB 英文描述 Android Debug Bridge Global Navigation Satellite System Global Positioning System Global System for Mobile Communications Hardware Abstraction Layer Java Native Interface Long Term Evolution National Marine Electronics Association Personal Identification Number Universal Mobile Telecommunications System Universal Serial Bus 中文描述 Android 调试桥 全球导航卫星系统 全球定位系统 全球移动通信系统 硬件抽象层 Java 本地接口 长期演进 美国国家海洋电子协会 个人识别码 通用移动通信系统 通用串行总线 上海移远通信技术股份有限公司 13 / 13

EC2x&EG2x-G Series PCB Design Guideline LTE Standard Module Series Rev.Quectel_EC2x&EG2x-G_Series_PCB_Design_Guideline_V1.1 Date: 2020-07-24 Status: Released www.quectel.com LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm. For technical support, or to report documentation errors, please visit: http://www.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. DISCLAIMER WHILE QUECTEL HAS MADE EFFORTS TO ENSURE THAT THE FUNCTIONS AND FEATURES UNDER DEVELOPMENT ARE FREE FROM ERRORS, IT IS POSSIBLE THAT THESE FUNCTIONS AND FEATURES COULD CONTAIN ERRORS, INACCURACIES AND OMISSIONS. UNLESS OTHERWISE PROVIDED BY VALID AGREEMENT, QUECTEL MAKES NO WARRANTIES OF ANY KIND, IMPLIED OR EXPRESS, WITH RESPECT TO THE USE OF FEATURES AND FUNCTIONS UNDER DEVELOPMENT. TO THE MAXIMUM EXTENT PERMITTED BY LAW, QUECTEL EXCLUDES ALL LIABILITY FOR ANY LOSS OR DAMAGE SUFFERED IN CONNECTION WITH THE USE OF THE FUNCTIONS AND FEATURES UNDER DEVELOPMENT, REGARDLESS OF WHETHER SUCH LOSS OR DAMAGE MAY HAVE BEEN FORESEEABLE. 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 WITHOUT PERMISSION ARE FORBIDDEN. 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. 2020. All rights reserved. EC2x&EG2x-G_Series_PCB_Design_Guideline 1 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline About the Document Revision History Version Date Author Description 1.0 2020-07-23 Lim PENG Initial 1.1 2020-07-24 Lim PENG Revised few typos. EC2x&EG2x-G_Series_PCB_Design_Guideline 2 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline Contents About the Document .................................................................................................................................. 2 Contents ...................................................................................................................................................... 3 Table Index.................................................................................................................................................. 4 Figure Index ................................................................................................................................................ 5 1 Introduction ......................................................................................................................................... 6 1.1. Applicable Modules .................................................................................................................... 6 1.2. Safety Information ...................................................................................................................... 7 2 PCB Design Overview ........................................................................................................................ 8 2.1. Footprint and Keepout Area....................................................................................................... 8 2.2. Design Priorities and Considerations for PCB Traces............................................................... 9 2.2.1. Design Priorities .............................................................................................................. 9 2.2.2. Design Considerations .................................................................................................... 9 3 Interface Design ................................................................................................................................ 10 3.1. Power Supply ........................................................................................................................... 10 3.1.1. DC-DC Converter .......................................................................................................... 10 3.1.2. VBAT ............................................................................................................................. 11 3.2. PWRKEY & RESET_N ............................................................................................................ 13 3.3. USB Interface........................................................................................................................... 14 3.3.1. USB_DM & USB_DP Signals ....................................................................................... 14 3.3.2. USB_VBUS Signal ........................................................................................................ 16 3.4. Ethernet PHY ........................................................................................................................... 17 3.4.1. SGMII Interface ............................................................................................................. 17 3.4.2. Ethernet Components ................................................................................................... 19 3.5. Audio Interfaces ....................................................................................................................... 20 3.5.1. PCM Interface ............................................................................................................... 20 3.5.2. Codec & Microphone & Speaker .................................................................................. 21 3.6. SD Card Interface .................................................................................................................... 23 3.7. WLAN Interface........................................................................................................................ 25 3.8. (U)SIM Interface....................................................................................................................... 27 3.9. ADC Interface........................................................................................................................... 28 3.10. GPIOs....................................................................................................................................... 29 3.11. Antenna Interfaces ................................................................................................................... 30 3.11.1. PCB Structures of Microstrip And Coplanar Waveguide .............................................. 30 3.11.1.1. PCB Structure of Microstrip Waveguide ............................................................ 30 3.11.1.2. PCB Structure of Coplanar Waveguide ............................................................. 30 3.11.2. Reference Design of RF Layout.................................................................................... 32 3.11.3. PCB Layout Considerations of Coplanar Waveguide................................................... 33 4 Thermal Design ................................................................................................................................. 35 5 Appendix A References.................................................................................................................... 36 EC2x&EG2x-G_Series_PCB_Design_Guideline 3 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline Table Index Table 1: Applicable Modules ........................................................................................................................ 6 Table 2: Recommended Values of W and S for 50 Ω Coplanar Waveguide under Different PCB Structures ............................................................................................................................................................ 31 Table 3: Related Documents...................................................................................................................... 36 Table 4: Terms and Abbreviations ............................................................................................................. 36 EC2x&EG2x-G_Series_PCB_Design_Guideline 4 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline Figure Index Figure 1: Overview of TE-A 1st Layer.......................................................................................................... 8 Figure 2: High-priority Signals to Be Designed (TE-A 1st Layer) ................................................................ 9 Figure 3: DC-DC Converter (EVB 4th Layer) and Module Interfaces On TE-A (EVB 1st Layer).............. 10 Figure 4: VBAT Traces (TE-A 1st Layer) ................................................................................................... 11 Figure 5: Traces of VBAT with Capacitors (TE-A 4th Layer)..................................................................... 11 Figure 6: Traces of VBAT with a TVS (TE-A 4th Layer) ............................................................................ 12 Figure 7: VBAT & Sensitive Signal Traces (TE-A 1st Layer)..................................................................... 12 Figure 8: PWRKEY and RESET_N Traces (TE-A 1st Layer).................................................................... 13 Figure 9: PWRKEY and RESET_N Traces (TE-A 3rd Layer) ................................................................... 13 Figure 10: Overview of USB_DM/DP Signal Traces (EVB 1st Layer)....................................................... 14 Figure 11: Overview of USB_DM/DP Signal Traces (EVB 3rd Layer) ...................................................... 15 Figure 12: Overview of USB_VBUS Signal Trace (EVB 1st Layer) .......................................................... 16 Figure 13: Overview of USB_VBUS Signal Trace (EVB 3rd Layer) .......................................................... 16 Figure 14: Overview of SGMII Signal Traces (TE-A 1st Layer)................................................................. 17 Figure 15: Overview of SGMII Signal Traces (TE-A 3rd Layer) ................................................................ 18 Figure 16: Recommended PCB Layout of SGMII Interface (TE-A 4th Layer)........................................... 19 Figure 17: Recommended Reference PCB Layout of SGMII Interface (EVB 3rd Layer).......................... 19 Figure 18: Layout of Recommended 4.7 μH Inductor, GND and Traces of AR8033 (EVB 1st Layer) ..... 20 Figure 19: Overview of PCM Signal Traces (TE-A 3rd Layer)................................................................... 21 Figure 20: Overview of Codec ALC5616 (EVB 1st Layer)......................................................................... 22 Figure 21: Overview of Analog Audio Signal Traces (EVB 1st Layer) ...................................................... 23 Figure 22: Overview of SD Card Signal Traces (EVB 1st Layer) ............................................................. 24 Figure 23: Overview of SD Card Signal Traces (EVB 3rd Layer) ............................................................. 24 Figure 24: Overview of SDIO Signal Traces (FC20 TE-A 1st Layer) ....................................................... 25 Figure 25: Overview of SDIO Signal Traces (FC20 TE-A 3rd Layer) ....................................................... 26 Figure 26: Overview of (U)SIM Signal Traces (EVB 1st Layer)................................................................ 27 Figure 27: Overview of (U)SIM Signal Traces (EVB 2nd Layer)............................................................... 27 Figure 28: Overview of ADC Signal Traces (EVB 3rd Layer) ................................................................... 28 Figure 29: Overview of GPIO Signal Traces (TE-A without Copper Pouring)........................................... 29 Figure 30: PCB Structure of Microstrip Waveguide................................................................................... 30 Figure 31: PCB Structure of Coplanar Waveguide .................................................................................... 31 Figure 32: Microstrip Design on a 2-layer PCB ......................................................................................... 32 Figure 33: Coplanar Waveguide Design on a 2-layer PCB ....................................................................... 32 Figure 34: Coplanar Waveguide Design on a 4-layer PCB (Layer 3 as Reference Ground).................... 33 Figure 35: Coplanar Waveguide Design on a 4-layer PCB (Layer 4 as Reference Ground).................... 33 Figure 36: Overview of RF Traces (EVB 1st Layer).................................................................................. 34 Figure 37: Overview of RF Traces (EVB 1st and 2nd Layers).................................................................. 34 EC2x&EG2x-G_Series_PCB_Design_Guideline 5 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 1 Introduction This document mainly introduces the PCB reference design for Quectel LTE Standard EC2x&EG2x-G series modules, and it takes EC25-TE-A, FC20-TE-A and UMTS&LTE EVB as examples. 1.1. Applicable Modules Table 1: Applicable Modules Module Series EC2x series EG2x-G Module EC21 series EC25 series EC20 R2.1 EG21-G EG25-G EC2x&EG2x-G_Series_PCB_Design_Guideline 6 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 1.2. Safety Information The following safety precautions must be observed during all phases of operation, such as usage, service or repair of any cellular terminal or mobile incorporating EC2x&EG2x-G series modules. Manufacturers of the cellular terminal should notify users and operating personnel of the following safety information by incorporating these guidelines into all manuals of the product. Otherwise, Quectel assumes no liability for customers’ failure to comply with these precautions. Full attention must be paid to driving at all times in order to reduce the risk of an accident. Using a mobile while driving (even with a handsfree kit) causes distraction and can lead to an accident. Please comply with laws and regulations restricting the use of wireless devices while driving. Switch off the cellular terminal or mobile before boarding an aircraft. The operation of wireless appliances in an aircraft is forbidden to prevent interference with communication systems. If there is an Airplane Mode, it should be enabled prior to boarding an aircraft. Please consult the airline staff for more restrictions on the use of wireless devices on an aircraft. Wireless devices may cause interference on sensitive medical equipment, so please be aware of the restrictions on the use of wireless devices when in hospitals, clinics or other healthcare facilities. Cellular terminals or mobiles operating over radio signals and cellular network cannot be guaranteed to connect in all possible conditions (for example, with unpaid bills or with an invalid (U)SIM card). When emergent help is needed in such conditions, use emergency call. In order to make or receive a call, the cellular terminal or mobile must be switched on in a service area with adequate cellular signal strength. The cellular terminal or mobile contains a transmitter and receiver. When it is ON, it receives and transmits radio frequency signals. RF interference can occur if it is used close to TV set, radio, computer or other electric equipment. In locations with potentially explosive atmospheres, obey all posted signs to turn off wireless devices such as mobile phone or other cellular terminals. Areas with potentially explosive atmospheres include fuelling areas, below decks on boats, fuel or chemical transfer or storage facilities, areas where the air contains chemicals or particles such as grain, dust or metal powders. EC2x&EG2x-G_Series_PCB_Design_Guideline 7 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 2 PCB Design Overview 2.1. Footprint and Keepout Area  A 4-layer PCB is strongly recommended.  First, check whether the module’s footprint is of the latest version provided by Quectel. For specific footprint of each module, please refer to document [1], [2], [3] or [4].  Do not design pads 73–84 and do not route the keepout area with any traces or copper. VBAT Antenna interfaces USB interface Keepout area WLAN interface SD card interface SGMII interface Figure 1: Overview of TE-A 1st Layer EC2x&EG2x-G_Series_PCB_Design_Guideline 8 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 2.2. Design Priorities and Considerations for PCB Traces 2.2.1. Design Priorities Design priorities of PCB traces in order:  Antenna traces.  High-speed signal (SGMII, SDIO and USB) traces.  Power supply (VBAT_BB, VBAT_RF, USIM_VDD, SDIO_VDD, VDD_EXT) traces.  Other traces 2.2.2. Design Considerations  The radiation of PCM interface and power supply could affect RF performance, so keep them away from RF signal traces and components.  Drill as fewer vias as possible for high-speed signal traces (SGMII, SDIO and USB interfaces) since vias will affect the continuity of the impedance. Route the differential pair traces on the same layer.  To minimize the signal return path, the GND vias for signals such as USB, SDIO, SGMII, PWRKEY and RESET_N should be close to the vias when the traces change layers. VBAT Antenna Interfaces High-speed signals (USB interface) Other signals (e.g. WLAN interface) High-speed signals (SD card interface) VDD_EXT USIM_VDD High-speed signals (SGMII interface) Figure 2: High-priority Signals to Be Designed (TE-A 1st Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 9 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3 Interface Design 3.1. Power Supply 3.1.1. DC-DC Converter  DC-DC converter should be away from the sensitive signal traces such as SDIO, USB, SGMII, audio and RF. If possible, shield DC-DC converter with shielding cover and reserve spacing for shielding frame.  Place the capacitor and inductor for the DC-DC converter as close as possible to the corresponding pins of the DC-DC converter to minimize the loop area.  Place output capacitors near input capacitors to share common ground area on outer layers.  Provide adequate thermal relief area at the gound area on outer layers along with any additional inner ground planes. TE-A Interfaces DC-DC Converter Figure 3: DC-DC Converter (EVB 4th Layer) and Module Interfaces On TE-A (EVB 1st Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 10 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.1.2. VBAT  Place 100 μF, 100 nF, 33 pF and 10 pF capacitors for both VBAT_BB and VBAT_RF respectively. The smaller the capacitance is, the closer the compositors are to the two VBAT pins.  The maximum current consumption of VBAT_RF is 1.8 A and its trace width is recommended to be no less than 2 mm. The maximum current consumption of VBAT_BB is 0.8 A and its trace width is recommended to be no less than 1 mm. Moreover, please pay attention to the capability and quantity of vias in the traces. The GND vias of the filter capacitors for VBAT should be drilled down to the nearest main ground. GND ≥ 2 mm VBAT_RF VBAT_BB ≥ 1 mm Vias GND GND Figure 4: VBAT Traces (TE-A 1st Layer) Vias GND Capacitors GND GND Figure 5: Traces of VBAT with Capacitors (TE-A 4th Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 11 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline  TVS for VBAT should be placed close to module’s pin VBAT_BB and VBAT_RF.  VBAT traces should be away from sensitive signal traces such as SDIO, USB, SGMII, USB audio and RF to reduce the risk of cross-talk.  A layer with VBAT traces and reference ground plane is recommended. When a power plane is used, a complete ground plane should be added in adjacent layer as the reference plane. TVS GND Figure 6: Traces of VBAT with a TVS (TE-A 4th Layer) VBAT Antenna Interfaces USB interface Keepout area WLAN interface SD card interface SGMII interface Figure 7: VBAT & Sensitive Signal Traces (TE-A 1st Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 12 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.2. PWRKEY & RESET_N  PWRKEY and RESET_N signal traces are recommended to be surrounded with ground.  If filter capacitors for PWRKEY and RESET_N are required, put them near the two pins. GND PWRKEY GND RESET Figure 8: PWRKEY and RESET_N Traces (TE-A 1st Layer) PWRKEY RESET_N GND GND GND Figure 9: PWRKEY and RESET_N Traces (TE-A 3rd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 13 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.3. USB Interface 3.3.1. USB_DM & USB_DP Signals  The spacing between USB_DP/USB_DM and other signal traces should be greater than 0.5 mm, maintaining the integrity of the reference plane and avoiding crossing with signal lines on adjacent layers.  USB_DP and USB_DM are recommended to be routed on the inner layer, with the differential impedance controlled to 90 Ω. Keep the spacing and length between traces comparatively equal, with the length tolerance less than 2 mm and the total length less than 120 mm.  When a TVS needs to be added for USB_DP and USB_DM signal traces, it should be close to USB connector and the junction capacitance of the TVS should be less than 2 pF. TE-A interface USB_DM/ DP Test points USB connector GND GND GND Figure 10: Overview of USB_DM/DP Signal Traces (EVB 1st Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 14 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline GND GND USB_DM/DP GND Figure 11: Overview of USB_DM/DP Signal Traces (EVB 3rd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 15 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.3.2. USB_VBUS Signal USB_VBUS is a USB detection signal, with maximum current of 1 mA. In general, a trace width of 0.1 mm is sufficient. TE-A interface USB_VBUS Test points GND GND USB connector GND Figure 12: Overview of USB_VBUS Signal Trace (EVB 1st Layer) USB_VBUS GND GND GND Figure 13: Overview of USB_VBUS Signal Trace (EVB 3rd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 16 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.4. Ethernet PHY 3.4.1. SGMII Interface  Signal traces of SGMII_MCLK, SGMII_MDATA, EPHY_RST_N and EPHY_INT_N should be surrounded with ground.  The spacing between SGMII_TX_M/SGMII_TX_P/SGMII_RX_M/SGMII_RX_P lines should be at least 3 times wider than the traces, and that between the SGMII signal trace and other signal traces should also be at least 3 times wider than SGMII traces.  Keep the maximum length of the SGMII signal traces less than 10 inches and the difference between signals of the differential pairs (SGMII_TX_P and SGMII_TX_M, SGMII_RX_P and SGMII_RX_M) less than 20 mil.  The differential impedance of SGMII signal traces is 100 Ω ±10 %, and the reference ground of the area should be complete.  The series capacitors for SGMII_TX_M/SGMII_TX_P should be close to PHY component, while the series capacitors for SGMII_RX_M/SGMII_RX_P should be close to the two pins. SGMII interface Figure 14: Overview of SGMII Signal Traces (TE-A 1st Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 17 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline SGMII_RST SGMII_INT SGMII_DATA SGMII_CLK GND GND GND GND SGMII_TX_M SGMII_TX_P SGMII_RX_P SGMII_RX_M GND Figure 15: Overview of SGMII Signal Traces (TE-A 3rd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 18 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.4.2. Ethernet Components A four-layer PCB should be used when using the SGMII interface to implement the Ethernet function in the application.  The first layer is for non-sensitive traces and 1.1 V power supply traces.  The second layer is strongly recommended for 3.3 V and 2.5 V power supply traces and ground plane.  The third layer should be a reference ground.  The fourth layer is used for main signal traces. GND GND GND GND Keepout area AR8033 Crystals GND SGMII signal traces Figure 16: Recommended PCB Layout of SGMII Interface (TE-A 4th Layer) GND GND GND GND GND SGMII_INT_N SGMII_DATA SGMII_CLK SGMII_RST_N GND Figure 17: Recommended Reference PCB Layout of SGMII Interface (EVB 3rd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 19 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline DVDD_1V1 is output by AR8033’s LX pin through an LC circuit. The 4.7 μH inductor in the LC circuit should be able to provide 1 A current with low direct current resistance. The trace width for the inductor is recommended to be at least 1 mm. Besides, there is a reference ground plane needed for inductance isolation near the 4.7 μH inductor The following figure shows the recommended inductor placement as well as trace routing and trace width for AR8033 pins. RJ45 GND Network transformer GND GND GND GND ≥ 1 mm GND 4.7 μH inductor Figure 18: Layout of Recommended 4.7 μH Inductor, GND and Traces of AR8033 (EVB 1st Layer) 3.5. Audio Interfaces 3.5.1. PCM Interface  The filter capacitors for PCM_CLK/PCM_SYNC should be placed close to the two pins.  The PCM bus is recommended to be routed on inner layers, and it is recommended that each trace be surrounded by ground traces separately. If there are limits of space, at least ensure PCM_CLK is surrounded by ground traces, and other three signal traces can be surrounded together by ground traces.  PCM traces should be kept away from interference sources such as clock, RF, crystals, power supplies, etc. EC2x&EG2x-G_Series_PCB_Design_Guideline 20 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline GND PCM_CLK GND GND PCM_SYNC PCM_OUT PCM_IN GND GND Figure 19: Overview of PCM Signal Traces (TE-A 3rd Layer) 3.5.2. Codec & Microphone & Speaker The codec should be kept away from interference sources such as high-power components, power sources, CPU, DRAM, Flash, PMU, LCD, RF antennas and other high-frequency components, isolated, and close to one of the edges or corners of the board, and could be shielded if there is sufficient space. EC2x&EG2x-G_Series_PCB_Design_Guideline 21 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline GND GND GND ALC5616 GND GND Figure 20: Overview of Codec ALC5616 (EVB 1st Layer)  Keep the traces for microphone and speaker as short as possible. For MIC signals, it is recommended to design differential pairs.  The analog output could only be capable of driving earphone and headset. For larger power loads such as loudspeakers, an audio power amplifier should be added in the design.  All MIC and SPK signal traces should be routed with total grounding and far away from interference sources.  The spacing between MIC_P and MIC_N should be more than 0.25 mm. To avoid cross-talk, the spacing between the differential pair traces should exceed 1.5 mm. To avoid interference between different MIC traces, MIC1 and MIC2 traces should be routed on different layers as much as possible.  For signal traces of speaker, the length should be more than 0.5 mm and requires low impedance.  The reference ground for microphone, speaker and MICBIAS should be analog ground while for PCM interface should be digital ground. Besides, pay attention to the integrity of the analog signal reference plane. EC2x&EG2x-G_Series_PCB_Design_Guideline 22 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline SPK1_M MIC_P MIC_N SPK_L Earphone application AGND SPK1_P Speaker Amplifier MIC1_N MIC1_P SPK2_M SPK2_P Handset Application SPK_R MIC2_P Figure 21: Overview of Analog Audio Signal Traces (EVB 1st Layer) 3.6. SD Card Interface  Keep SDIO signals far away from other sensitive circuits/signals such as RF circuits, analog signals, etc, as well as noisy signals such as clock and DC-DC signals, etc.  Keep the impedance of SDIO signal traces at 50 Ω 10 %, maintaining the integrity of the reference plane. SD_CLK and SD_CMD should be surrounded with ground on the layer and ground planes above and below. If limited by space, the SD_DATA0 to SD_DATA3 could be surrounded with ground together.  The total length of each SDIO signal trace should be less than 50 mm, and the difference between them should be less than 1 mm.  The load capacitance for SD card signals should be less than 15 pF.  If a SD card is applied, a TVS should be placed close to the SD card connector. EC2x&EG2x-G_Series_PCB_Design_Guideline 23 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline SD card connector GND TVS & Capacitors & Resistors SD card traces GND GND GND GND Figure 22: Overview of SD Card Signal Traces (EVB 1st Layer) GND GND SD_CLK SD_CMD GND VDD_SDIO SD_INS_DET GND SD_DATA GND Figure 23: Overview of SD Card Signal Traces (EVB 3rd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 24 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.7. WLAN Interface  Keep SDIO signals far away from other sensitive circuits/signals such as RF circuits, analog signals, etc, as well as noisy signals such as clock and DC-DC signals, etc.  The total length of each SDIO signal trace should be less than 23 mm, and the difference between them should be less than 1 mm.  The load capacitance for SDIO signal traces should be less than 15 pF.  Keep the impedance of SDIO signal traces at 50 Ω 10 %, maintaining the integrity of the reference plane. SD_CLK and SD_CMD should be surrounded with ground on the layer and adjacent ground planes If limited by space, the SD_DATA0 to SD_DATA3 could be surrounded with ground together. VDD_1V8 GND SDIO_VDD SDIO_CMD SDIO_CLK GND SDIO_DATA GND GND GND Figure 24: Overview of SDIO Signal Traces (FC20 TE-A 1st Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 25 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline SD_CLK SD_CMD SD_DATA GND GND VDD_1V8 GND GND GND Figure 25: Overview of SDIO Signal Traces (FC20 TE-A 3rd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 26 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.8. (U)SIM Interface  The total length of each (U)SIM signal trace should be less than 200 mm.  Isolate USIM_CLK and USIM_DAT with ground plane to avoid the interference between each other.  The peripheral components such as TVS, capacitors and resistors should be put near the (U)SIM card connector. GND (U)SIM interface GND TVS & Capacitors & Resistors GND (U)SIM card connector GND GND Figure 26: Overview of (U)SIM Signal Traces (EVB 1st Layer) USIM_VDD USIM_RST USIM_CLK USIM_DATA GND GND USIM_PRESENCE GND GND GND Figure 27: Overview of (U)SIM Signal Traces (EVB 2nd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 27 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.9. ADC Interface All ADC signal traces should be surrounded with ground. GND GND ADC0 ADC1 GND GND Figure 28: Overview of ADC Signal Traces (EVB 3rd Layer) EC2x&EG2x-G_Series_PCB_Design_Guideline 28 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.10. GPIOs  Keep GPIO traces away from interference signals such as clock, RF and power supplies, etc.  Filter capacitors need to be added and be placed close to the module when GPIO is used as input. Figure 29: Overview of GPIO Signal Traces (TE-A without Copper Pouring) EC2x&EG2x-G_Series_PCB_Design_Guideline 29 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.11. Antenna Interfaces 3.11.1. PCB Structures of Microstrip And Coplanar Waveguide 3.11.1.1. PCB Structure of Microstrip Waveguide Figure 30: PCB Structure of Microstrip Waveguide 3.11.1.2. PCB Structure of Coplanar Waveguide Factors affecting impedance include dielectric constant (usually 4.2–4.6, here 4.4), dielectric layer height (H), RF trace width (W), the spacing between RF traces and the ground (S) and copper thickness (T). When T = 0.035 mm, the following table lists the recommended values of W and S for 50 Ω coplanar waveguide under different PCB structures. EC2x&EG2x-G_Series_PCB_Design_Guideline 30 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline Figure 31: PCB Structure of Coplanar Waveguide Table 2: Recommended Values of W and S for 50 Ω Coplanar Waveguide under Different PCB Structures Dielectric Height (H) 0.076 mm 0.1 mm 0.15 mm 0.8 mm 1.0 mm 1.2 mm 1.6 mm 2 mm RF Trace Width (W) 0.1188 0.1623 mm 0.24 mm 0.8 mm 0.8 mm 0.8 mm 0.8 mm 0.8 mm Spacing Between RF Trace and The Ground (S) 0.15 mm 0.2 mm 0.2 mm 0.18 mm 0.17 mm 0.16 mm 0.15 mm 0.14 mm EC2x&EG2x-G_Series_PCB_Design_Guideline 31 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3.11.2. Reference Design of RF Layout For user’s PCB, the characteristic impedance of all RF traces should be controlled to 50 Ω. The impedance of the RF traces is usually determined by the trace width (W), the materials’ dielectric constant, the height from the reference ground to the signal layer (H), and the spacing between RF traces and grounds (S). Microstrip or coplanar waveguide is typically used in RF layout to control characteristic impedance. If there is a 2-layer PCB, the top layer is used for signal trace routing, and the bottom layer should be the reference ground layer, as shown in Figure 32 If there is a 4-layer PCB, the reference ground layer can be the second, the third, or the fourth layer. If the third layer is selected as the ground layer, the second layer should be kept out and the width should be at least 5 times the width of the trace，as shown in Figure 34. The following are reference designs of microstrip and coplanar waveguide with different PCB structures. Figure 32: Microstrip Design on a 2-layer PCB Figure 33: Coplanar Waveguide Design on a 2-layer PCB EC2x&EG2x-G_Series_PCB_Design_Guideline 32 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline Figure 34: Coplanar Waveguide Design on a 4-layer PCB (Layer 3 as Reference Ground) Figure 35: Coplanar Waveguide Design on a 4-layer PCB (Layer 4 as Reference Ground) 3.11.3. PCB Layout Considerations of Coplanar Waveguide There are 6 guidelines of the PCB layout should be taken into consideration. Each guideline is corresponding to the marks in the following two figures respectively. 1. Control the trace width (W) and the spacing between RF traces and grounds (S) corresponding to the 50 Ω coplanar waveguide. Taking common PCB board with FR4 medium (dielectric constant 4.2) and copper thickness of 35 μm as an example, the W and S corresponding to the thickness between different signal layers and reference grounds are shown in Table 2. It is particularly reminded that PCB manufacturers need to control the accuracy of the W and S. 2. Fully contact the GND pin pad next to the RF trace with ground plane and not design it as design thermal relief pad. EC2x&EG2x-G_Series_PCB_Design_Guideline 33 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 3. Leave a small keepout area for the RF traces on the top layer to reduce parasitic effects. Keep the traces as short as possible. Avoid right-angle routing for RF traces and 135 degrees is recommended when traces turn corner. 4. Keep a certain distance between signal pad and ground when packaging the component. If the signal pad is SMD type, pour the copper on the corresponding signal pad. 5. Make sure that reference ground planes corresponding to RF traces are complete. Increase the number of GND vias for current reflow of RF signal, and the spacing between GND vias and RF traces should be more than two times of trace width. Keep the ground plane area for RF traces within the same layer be as large as possible and the reference ground plane in the other layer complete as well. Besides, the number of through vias for those two ground planes should be sufficient. 6. The pads for PI type matching circuit consisting of a resistor and two capacitors should be near the module’s antenna pins. Figure 36: Overview of RF Traces (EVB 1st Layer) Figure 37: Overview of RF Traces (EVB 1st and 2nd Layers) EC2x&EG2x-G_Series_PCB_Design_Guideline 34 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 4 Thermal Design For more details of the thermal design of the PCB, please refer to document [5]. EC2x&EG2x-G_Series_PCB_Design_Guideline 35 / 37 LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline 5 Appendix A References Table 3: Related Documents SN Document Name [1] Quectel_EC21_Footprint&Part [2] Quectel_EC25_Footprint&Part [3] Quectel_EC20_R2.1_Footprint&Part [4] Quectel_EG25-G&EG21-G_Footprint&Part [5] Quectel_LTE_Module_Thermal_Design_Guide Remark EC21 series Footprint&Part EC25 series Footprint&Part EC20 R2.1 Footprint&Part EG25-G&EG21-G Footprint&Part Thermal design guide for LTE standard, LTE-A and Automotive modules Table 4: Terms and Abbreviations Abbreviation ADC Description Analog-to-Digital Converter ESD GPIO I/O Electrostatic Discharge General-Purpose Input/Output Input/Output LTE PCB PCM Long Term Evolution Printed Circuit Board Pulse Code Modulation PHY RF SD Physical Layer Radio Frequency Secure Digital EC2x&EG2x-G_Series_PCB_Design_Guideline 36 / 37 SGMII USB (U)SIM VBAT WLAN LTE Standard Module Series EC2x&EG2x-G Series PCB Design Guideline Serial Gigabit Media Independent Interface Universal Serial Bus (Universal) Subscriber Identity Module Voltage at Battery Wireless Local Area Network EC2x&EG2x-G_Series_PCB_Design_Guideline 37 / 37

Lx6&LC86L&LG77L 固件升级指导 GNSS 模块系列 版本：1.1 日期：2023-12-22 状态：受控文件 Lx6&LC86L&LG77L 固件升级指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 24 Lx6&LC86L&LG77L 固件升级指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 24 Lx6&LC86L&LG77L 固件升级指导 文档历史 文档信息 标题 副标题 文档类别 文档状态 Lx6&LC86L&LG77L 固件升级指导 GNSS 模块系列 固件升级指导 受控文件 修订记录 版本 1.0 1.1 日期 2021-09-09 2022-02-28 2023-12-22 变更表述 文档创建 受控版本 新增使用 QGNSS 工具升级固件示例（第 4 章）。 上海移远通信技术股份有限公司 3 / 24 Lx6&LC86L&LG77L 固件升级指导 目录 文档历史 ....................................................................................................................................................... 3 目录 .............................................................................................................................................................. 4 图片索引 ....................................................................................................................................................... 5 1 引言 ....................................................................................................................................................... 6 2 固件升级过程......................................................................................................................................... 7 2.1. CMD_Start（启动升级程序）..................................................................................................... 7 2.2. CMD_Write（下载 DA 到 SRAM） ............................................................................................ 8 2.3. CMD_Jump（跳转到 DA 起始地址）......................................................................................... 9 2.4. CMD_Sync（上报 Flash 信息） .............................................................................................. 10 2.5. CMD_SetMemBlock（设置 DA 内存块） .................................................................................11 2.6. CMD_WriteData（下载 BIN 文件到模块 Flash）..................................................................... 12 2.7. CMD_Finish（完成固件升级） ................................................................................................ 14 3 固件升级示例....................................................................................................................................... 15 4 使用 QGNSS 工具升级固件示例......................................................................................................... 19 5 附录 术语缩写..................................................................................................................................... 24 上海移远通信技术股份有限公司 4 / 24 Lx6&LC86L&LG77L 固件升级指导 图片索引 图 1：固件升级连接方式 .............................................................................................................................. 6 图 2：启动升级程序的流程........................................................................................................................... 7 图 3：下载 DA 到 SRAM 的流程 .................................................................................................................. 8 图 4：跳转到 DA 起始地址的流程 ................................................................................................................ 9 图 5：上报 Flash 信息的流程 ......................................................................................................................11 图 6：设置 DA 内存块的流程 ..................................................................................................................... 12 图 7：下载 BIN 文件到模块 Flash 的流程 .................................................................................................. 13 图 8：固件升级完成.................................................................................................................................... 14 图 9：设备管理器 ....................................................................................................................................... 19 图 10：设备信息 ......................................................................................................................................... 20 图 11：固件下载 ......................................................................................................................................... 20 图 12：加载固件 ......................................................................................................................................... 21 图 13：选择 DA 文件 .................................................................................................................................. 21 图 14：选择固件包 ..................................................................................................................................... 21 图 15：复位模块 ......................................................................................................................................... 22 图 16：等待升级完成.................................................................................................................................. 22 图 17：固件升级完成.................................................................................................................................. 23 上海移远通信技术股份有限公司 5 / 24 Lx6&LC86L&LG77L 固件升级指导 1 引言 移远通信 GNSS 系列模块支持固件升级功能，此功能可以实现模块固件包的无线升级。本文介绍了通 过 UART 方式进行固件升级的详细过程。 本文档适用于以下移远通信 GNSS 模块： ⚫ L26 ⚫ L26-LB ⚫ L76 ⚫ L76B ⚫ L76-L ⚫ L76-LB ⚫ L86 ⚫ L96 ⚫ LC86L ⚫ LG77L 主机 UART GNSS模块 图 1：固件升级连接方式 上海移远通信技术股份有限公司 6 / 24 Lx6&LC86L&LG77L 固件升级指导 2 固件升级过程 整个固件升级过程分为两个阶段： 阶段 1：将 DA 下载到内部静态随机存储器（SRAM），然后跳转到内部 SRAM 中 DA 的起始地址并执 行 DA。 阶段 2：将 BIN 文件下载到 flash 中，然后跳转到 flash 中 BIN 文件的起始地址并执行该文件。 2.1. CMD_Start（启动升级程序） GNSS 模 块 上 电 后 ， 主 机 依 次 在 7 种 标 准 波 特 率 下 进 行 串 口 通 信 ， 并 在 每 个 波 特 率 下 发 送 NMEA_START_CMD（$PMTK180*3Brn）指令强制模块复位。然后主机将波特率设置为正确的波特率， 建立通信，启动升级程序。 主机 模块 依次在7种标准波特率下发 送NMEA_START_CMD， 然后设置为正确的波特 率。 NMEA_START_CMD(PMTK180) BOOT_ROM_START_CMD1(0xA0) ~BOOT_ROM_START_CMD1(0x5F) BOOT_ROM_START_CMD2(0x0A) ~BOOT_ROM_START_CMD2(0xF5) BOOT_ROM_START_CMD3(0x50) ~BOOT_ROM_START_CMD3(0xAF) BOOT_ROM_START_CMD4(0x05) ~BOOT_ROM_START_CMD4(0xFA) 重复发送直到主机接收到0x5F。 重发间隔为40毫秒。 图 2：启动升级程序的流程 上海移远通信技术股份有限公司 7 / 24 Lx6&LC86L&LG77L 固件升级指导 备注 7 种标准波特率分别是：4800 bps、9600 bps、14400 bps、19200 bps、38400 bps、57600 bps 和 115200 bps。 2.2. CMD_Write（下载 DA 到 SRAM） 在这一过程中，DA 将被下载到 SRAM 中。 下载代理（DA）是允许通过 UART 串口执行 flash 下载的应用程序。DA 成功下载并在目标模块上运行 后会进入待机状态，等待主机通过 UART 串口发送固件升级指令。 主机 模块 BOOT_ROM_WRITE_CMD(0xA1) BOOT_ROM_WRITE_CMD(0xA1) DA_BASE_ADDR(0x00, 0x00, 0x0C, 0x00) DA_BASE_ADDR(0x00, 0x00, 0x0C, 0x00) DA_SIZE_NUM_WORD DA_SIZE_NUM_WORD Send DA with 10 bytes ... ACK with 10 bytes sent Send DA with last bytes ACK with last bytes sent BOOT_ROM_CHECKSUM_CMD(0xA4) BOOT_ROM_CHECKSUM_CMD(0xA4) DA_BASE_ADDR(0x00, 0x00, 0x0C, 0x00) DA_BASE_ADDR(0x00, 0x00, 0x0C, 0x00) DA_SIZE_NUM_WORD DA_SIZE_NUM_WORD DA_CHECKSUM 图 3：下载 DA 到 SRAM 的流程 上海移远通信技术股份有限公司 8 / 24 备注 1. DA_SIZE_NUM_WORD 采用大端模式，占四个字节。 2. DA_CHECKSUM 占两个字节。 Lx6&LC86L&LG77L 固件升级指导 DA 文件生成校验和的示例代码 uint16_t DA_CHECKSUM(const uint8_t *buf, uint32_t buf_len) { uint16_t checksum = 0; if (buf == NULL || buf_len == 0) { return 0; } int i = 0; for (i = 0; i < buf_len / 2; i++) { checksum ^= *(uint16_t *) (buf + i * 2); } if ((buf_len % 2) == 1) { checksum ^= buf[i * 2]; } return checksum; } 2.3. CMD_Jump（跳转到 DA 起始地址） 主机 模块 更新写缓存区 BOOT_ROM_JUMP_CMD(0xA8) BOOT_ROM_JUMP_CMD(0xA8) DA_BASE_ADDR(0x00, 0x00, 0x0C, 0x00) DA_BASE_ADDR(0x00, 0x00, 0x0C, 0x00) 图 4：跳转到 DA 起始地址的流程 上海移远通信技术股份有限公司 9 / 24 Lx6&LC86L&LG77L 固件升级指导 2.4. CMD_Sync（上报 Flash 信息） 下载并执行 DA 时，DA 会主动上报一个字节的 SYNC_CHAR、两个字节的 DA_VERSION、一个字节 的 FLASH_DEVICE_ID 、 四 个 字 节 的 FLASH_SIZE 、 八 个 字 节 的 FLASH_HW_ID 和 四 个 字 节 的 EXT_SRAM_SIZE。 ⚫ SYNC_CHAR 执行 DA 时，DA 将返回 SYNC_CHAR（0xC0）。如果返回的字节不是 SYNC_CHAR，则可能是 DA 下载错误。 ⚫ DA_VERSION 返回 SYNC_CHAR 后，DA 将返回它的版本号，版本号包含两个字节，分别是主版本号和子版本 号。主机中的相关程序需要检查是否支持这个 DA。 ⚫ FLASH_DEVICE_ID 上报 DA 版本后，DA 会自动检测模块上的 flash 类型。 ⚫ FLASH_SIZE Flash 大小，占四个字节。例如，8 Mbits 的 flash 是 0x00100000 字节，DA 将发送 0x00、0x10、 0x00 和 0x00。 ⚫ FLASH_MANUFACTURE_CODE Flash 产品代码，占两个字节。 ⚫ FLASH_DEVICE_CODE Flash 设备代码，占两个字节。 ⚫ FLASH_EXT_DEVICE_CODE1 Flash 扩展设备代码 1，占两个字节。 ⚫ FLASH_EXT_DEVICE_CODE2 Flash 扩展设备代码 2，占两个字节。 ⚫ EXT_SRAM_SIZE 外部 SRAM 大小，占四个字节。例如，512 Mbits 的外部 SRAM 是 0x00010000 字节，DA 将发送 0x00、 0x01、0x00 和 0x00。 上海移远通信技术股份有限公司 10 / 24 Lx6&LC86L&LG77L 固件升级指导 主机 模块 SYNC_CHAR (0xC0) DA_MAJOR_VER(0x04), DA_MINOR_VER(0x00) FLASH_DEVICE_ID(0x01) FLASH_SIZE(0x00, 0x10, 0x00, 0x00) FLASH_MANUFACTURE_CODE(0x00, 0x0C) FLASH_DEVICE_CODE(0x00, 0x22) FLASH_EXT_DEVICE_CODE1(0x00, 0x38) FLASH_EXT_DEVICE_CODE2(0x00, 0x4E) EXT_SRAM_SIZE(0x00, 0x01, 0x00, 0x00) 图 5：上报 Flash 信息的流程 备注 Flash 相关信息是固定的，用于握手授权，不是真实的 flash 信息。 2.5. CMD_SetMemBlock（设置 DA 内存块） 这个指令用于通知 DA 内存块总量和单个内存块的范围。内存块总量表示可下载 BIN 文件的数量；单 个内存块的范围表示每个 BIN 文件的范围。 如果有内存块超过 flash 大小，DA 将返回 NACK（0xA5），表示 DA_MEM_CMD 命令失败。如果所有 下载的内存块都是有效的，DA 将返回 ACK（0x5A）和 UNCHANGED_BLOCK_COUNT（未使用的内存 块数量）。 上海移远通信技术股份有限公司 11 / 24 Lx6&LC86L&LG77L 固件升级指导 主机 模块 DA_MEM_CMD(0xD3) MEM_BLOCK_COUNT(0x01) BLOCK: BEGIN_ADDRESS(0x00000000) 0x00, 0x00, 0x00, 0x00 BLOCK: END_ADDRESS ACK(0x5A) UNCHANGED_BLOCK_COUNT 图 6：设置 DA 内存块的流程 备注 END_ADDRESS = BEGIN_ADDRESS + GNSS BIN 文件大小 - 1 2.6. CMD_WriteData（下载 BIN 文件到模块 Flash） 该指令用于将 BIN 文件的所有数据下载到模块 flash 中。数据包长度固定，即 PACKET_LENGTH 加 上两个字节的校验和。由于最后一个数据包的长度通常是比 PACKET_LENGTH 小，所以主机中的相关程 序需要发送数据的实际长度加上两个字节的校验和。 上海移远通信技术股份有限公司 12 / 24 Lx6&LC86L&LG77L 固件升级指导 主机 模块 DA_WRITE_CMD(0xD5) PACKET_LENGTH(0x00000400)=1024 bytes 0x00, 0x00, 0x04, 0x00 SAVE_UNCHANGEDDATA_ACK(0x5A) ERASE_1st_SECTOR_ACK(0x5A) 下载 BIN文件 PACKET[1024+2]=DATA[1024]+CHECKSUM[2] ... CONT_CHAR[0x69] LAST_PACKET[487+2]=DATA[487]+CHECKSUM[2] CONT_CHAR[0x69] 等待 DA 校验 flash ACK(0x5A) ACK(0x5A) 图 7：下载 BIN 文件到模块 Flash 的流程 生成校验和的示例代码 uint16 DATA_CHECKSUM(const uint8_t *buf, uint32_t buf_len) { uint16 checksum = 0; int i; for(i = 0; i< buf_len; i++) { checksum += *(buf + i); } return checksum; } 上海移远通信技术股份有限公司 13 / 24 Lx6&LC86L&LG77L 固件升级指导 2.7. CMD_Finish（完成固件升级） 该指令用于重启模块并输出 NMEA 语句，完成固件升级。 主机 DA_FINISH_CMD(0xD9) 模块 图 8：固件升级完成 上海移远通信技术股份有限公司 14 / 24 3 固件升级示例 本章节主要介绍固件升级的流程示例。 //图 2：启动升级程序的流程 //主机发送 7 次$PMTK180*3Brn 指令 24 50 4D 54 4B 31 38 30 2A 33 42 0D 0A //主机持续发送 0xA0 A0 A0 A0 … A0 A0 A0 A0 //模块响应 0x5F 5F //主机发送 0x0A 0A //模块响应 0xF5 F5 //主机发送 0x50 50 //模块响应 0xAF AF //主机发送 0x05 05 //模块响应 0xFA FA //图 3：下载 DA 到 SRAM 的流程 //主机发送 0xA1 A1 //模块响应 0xA1 A1 //主机发送 0x00000C00 00 00 0C 00 //模块响应 0x00000C00 上海移远通信技术股份有限公司 Lx6&LC86L&LG77L 固件升级指导 15 / 24 00 00 0C 00 //主机发送 0x0000173A 00 00 17 3A //模块响应 0x0000173A 00 00 17 3A //主机发送 10 字节 00 00 E1 A0 00 00 E1 0F 10 C0 //模块响应 10 字节 00 00 E1 A0 00 00 E1 0F 10 C0 //主机发送 10 字节 E3 A0 00 01 E1 80 F0 00 E1 2F //模块响应 10 字节 E3 A0 00 01 E1 80 F0 00 E1 2F //主机发送 10 字节 10 00 E3 A0 19 02 E2 81 10 04 //模块响应 10 字节 E3 A0 00 01 E1 80 F0 00 E1 2F …… //主机发送 10 字节 00 00 00 00 00 00 00 00 00 00 //模块响应 10 字节 00 00 00 00 00 00 00 00 00 00 //主机发送 10 字节 00 00 00 00 00 00 00 00 00 00 //模块响应 10 字节 00 00 00 00 00 00 00 00 00 00 //主机发送 0x0000 00 00 //模块响应 0x0000 00 00 //主机发送 0xA4 A4 //模块响应 0xA4 A4 //主机发送 0x00000C00 00 00 0C 00 //模块响应 0x00000C00 00 00 0C 00 //主机发送 0x0000173A 00 00 17 3A //模块响应 0x0000173A 00 00 17 3A //模块响应 DA_CHECKSUM 67 8D （DA 文件生成校验和的示例代码） 上海移远通信技术股份有限公司 Lx6&LC86L&LG77L 固件升级指导 16 / 24 Lx6&LC86L&LG77L 固件升级指导 //图 4：跳转到 DA 起始地址的流程 //主机发送 0xA8 A8 //模块响应 0xA8 A8 //主机发送 0x00000C00 00 00 0C 00 //模块响应 0x00000C00 00 00 0C 00 //图 5：上报 Flash 信息的流程 //模块上报 Flash 信息 C0 04 00 01 00 10 00 00 00 0C 00 22 00 38 00 4E 00 01 00 00 //图 6：设置 DA 内存块的流程 //主机发送 0xD301 D3 01 //主机发送 0x00000000 00 00 00 00 //主机发送 0x000A31C7 00 0A 31 C7 //模块响应 0x5A00 5A 00 //图 7：下载 BIN 文件到模块 Flash 的流程 //主机发送 0xD500000400 D5 00 00 04 00 //模块响应 0x5A5A 5A 5A //主机发送固件包（1024 字节）和校验和（2 字节） 18 F0 9F E5 18 F0 9F E5 18 F0 9F E5 18 F0 9F E5 18 F0 9F E5 CF D4 1B 91 14 F0 9F E5 …… 95 75 （生成校验和的示例代码） //模块响应 0x69 69 //主机发送固件包（1024 字节）和校验和（2 字节） FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF …… FC 00 （生成校验和的示例代码） //模块响应 0x69 69 //主机发送固件包（1024 字节）和校验和（2 字节） FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF …… E2 A6（生成校验和的示例代码） //模块响应 0x69 69 上海移远通信技术股份有限公司 17 / 24 Lx6&LC86L&LG77L 固件升级指导 //主机发送固件包（1024 字节）和校验和（2 字节） 90 00 00 EB FE FF FF EA 0E 60 A0 E1 00 40 0F E1 80 40 84 E3 40 40 84 E3 1F 4- C4 E3 …… A9 2D （生成校验和的示例代码） //模块响应 0x69 69 …… //主机发送固件包（1024 字节）和校验和（2 字节） 06 10 A0 E1 05 00 A0 E1 F9 F9 FF EB 07 10 04 E0 00 50 A0 E1 07 00 A0 E1 CF F9 FF …… 99 CE（生成校验和的示例代码） //模块响应 0x69 69 //主机发送固件包（1024 字节）和校验和（2 字节） 1B C0 A0 E3 01 20 A0 D3 02 1A 81 E1 04 F9 FF EA 06 2C 42 E2 02 3B 42 E2 01 30 93 E2 …… 91 E8（生成校验和的示例代码） //模块响应 0x69 69 //模块响应 0x5A5A 5A 5A //图 8：固件升级完成 //主机发送 0xD9 D9 上海移远通信技术股份有限公司 18 / 24 Lx6&LC86L&LG77L 固件升级指导 4 使用 QGNSS 工具升级固件示例 本章节以 L96 模块为例，介绍通过 QGNSS 工具进行固件升级的流程。 注意： 1. 升级固件前，请确保模块已连接 PC 并正常上电。正常连接并上电后，可在'设备管理器'中查看 模块所使用的端口，详见图 9：设备管理器。 2. 推荐使用 QGNSS V1.9 及以上版本。 图 9：设备管理器 固件升级步骤详情如下： 步骤 1 打开 QGNSS 工具，并点击 进入到'Device Information'窗口，详见图 10：设备信息。 步骤 2 选择待升级模块的型号。 步骤 3 选择对应的端口号。 步骤 4 选择通信波特率，默认波特率：9600 bps。 步骤 5 点击'OK'。 上海移远通信技术股份有限公司 19 / 24 Lx6&LC86L&LG77L 固件升级指导 图 10：设备信息 步骤 6 点击工具栏中的'Tools'，详见图 11：固件下载。 步骤 7 点击'Tools'下拉菜单中的'Firmware Download'。 图 11：固件下载 步骤 8 在 新 窗 口 中 点 击 并 选 择 升 级 固 件 的 DA 文 件 ， 详 见 图 12 ： 加 载 固 件 和 图 13：选择 DA 文件。 步骤 9 点击 选择升级使用的固件包，详见图 12：加载固件和图 14：选择固件包。 上海移远通信技术股份有限公司 20 / 24 Lx6&LC86L&LG77L 固件升级指导 图 12：加载固件 图 13：选择 DA 文件 图 14：选择固件包 步骤 10 点击 开始固件升级，根据弹出的新的对话框提示完成升级操作，详见图 15：复位模块。 上海移远通信技术股份有限公司 21 / 24 Lx6&LC86L&LG77L 固件升级指导 步骤 11 等待升级完成。 图 15：复位模块 步骤 12 固件升级完成。 图 16：等待升级完成 上海移远通信技术股份有限公司 22 / 24 Lx6&LC86L&LG77L 固件升级指导 图 17：固件升级完成 上海移远通信技术股份有限公司 23 / 24 Lx6&LC86L&LG77L 固件升级指导 5 附录 术语缩写 表 1：术语缩写 缩写 ACK DA GNSS NACK SRAM UART 英文全称 Acknowledgement Download Agent Global Navigation Satellite System Negative Acknowledgement Static Random Access Memory Universal Asynchronous Receiver/Transmitter 中文全称 确认消息 下载代理 全球导航卫星系统 否定消息 静态随机存储器 通用异步收发传输器 上海移远通信技术股份有限公司 24 / 24

LG69T (AA,AD,AF,AI,AJ,AR) &LC29T (AA)&LC99T (IA) 固件升级指导 GNSS 模块系列 版本：1.1 日期：2023-12-15 状态：受控文件 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 上海移远通信技术股份有限公司（以下简称'移远通信'）始终以为客户提供最及时、最全面的服务为宗旨。 如需任何帮助，请随时联系我司上海总部，联系方式如下： 上海移远通信技术股份有限公司 上海市闵行区田林路 1016 号科技绿洲 3 期（B 区）5 号楼 电话：+86 21 5108 6236 邮箱：info@quectel.com 邮编：200233 或联系我司当地办事处，详情请登录：http://www.quectel.com/cn/support/sales.htm。 如需技术支持或反馈我司技术文档中的问题，请随时登录网址： http://www.quectel.com/cn/support/technical.htm 或发送邮件至：support@quectel.com。 前言 移远通信提供该文档内容以支持客户的产品设计。客户须按照文档中提供的规范、参数来设计产品。同时， 您理解并同意，移远通信提供的参考设计仅作为示例。您同意在设计您目标产品时使用您独立的分析、评 估和判断。在使用本文档所指导的任何硬软件或服务之前，请仔细阅读本声明。您在此承认并同意，尽管 移远通信采取了商业范围内的合理努力来提供尽可能好的体验，但本文档和其所涉及服务是在'可用'基 础上提供给您的。移远通信可在未事先通知的情况下，自行决定随时增加、修改或重述本文档。 使用和披露限制 许可协议 除非移远通信特别授权，否则我司所提供硬软件、材料和文档的接收方须对接收的内容保密，不得将其用 于除本项目的实施与开展以外的任何其他目的。 版权声明 移远通信产品和本协议项下的第三方产品可能包含受移远通信或第三方材料、硬软件和文档版权保护的相 关资料。除非事先得到书面同意，否则您不得获取、使用、向第三方披露我司所提供的文档和信息，或对 此类受版权保护的资料进行复制、转载、抄袭、出版、展示、翻译、分发、合并、修改，或创造其衍生作 品。移远通信或第三方对受版权保护的资料拥有专有权，不授予或转让任何专利、版权、商标或服务商标 权的许可。为避免歧义，除了正常的非独家、免版税的产品使用许可，任何形式的购买都不可被视为授予 许可。对于任何违反保密义务、未经授权使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为， 移远通信有权追究法律责任。 商标 除另行规定，本文档中的任何内容均不授予在广告、宣传或其他方面使用移远通信或第三方的任何商标、 商号及名称，或其缩略语，或其仿冒品的权利。 第三方权利 您理解本文档可能涉及一个或多个属于第三方的硬软件和文档（'第三方材料'）。您对此类第三方材料的使 用应受本文档的所有限制和义务约束。 上海移远通信技术股份有限公司 1 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 移远通信针对第三方材料不做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特 定用途的适用性、平静受益权、系统集成、信息准确性以及与许可技术或被许可人使用许可技术相关的不 侵犯任何第三方知识产权的保证。本协议中的任何内容都不构成移远通信对任何移远通信产品或任何其他 硬软件、设备、工具、信息或产品的开发、增强、修改、分销、营销、销售、提供销售或以其他方式维持 生产的陈述或保证。此外，移远通信免除因交易过程、使用或贸易而产生的任何和所有保证。 隐私声明 为实现移远通信产品功能，特定设备数据将会上传至移远通信或第三方服务器（包括运营商、芯片供应商 或您指定的服务器）。移远通信严格遵守相关法律法规，仅为实现产品功能之目的或在适用法律允许的情况 下保留、使用、披露或以其他方式处理相关数据。当您与第三方进行数据交互前，请自行了解其隐私保护 和数据安全政策。 免责声明 1) 移远通信不承担任何因未能遵守有关操作或设计规范而造成损害的责任。 2) 移远通信不承担因本文档中的任何因不准确、遗漏、或使用本文档中的信息而产生的任何责任。 3) 移远通信尽力确保开发中功能的完整性、准确性、及时性，但不排除上述功能错误或遗漏的可能。除 非另有协议规定，否则移远通信对开发中功能的使用不做任何暗示或法定的保证。在适用法律允许的 最大范围内，移远通信不对任何因使用开发中功能而遭受的损害承担责任，无论此类损害是否可以预 见。 4) 移远通信对第三方网站及第三方资源的信息、内容、广告、商业报价、产品、服务和材料的可访问性、 安全性、准确性、可用性、合法性和完整性不承担任何法律责任。 版权所有 ©上海移远通信技术股份有限公司 2023，保留一切权利。 Copyright © Quectel Wireless Solutions Co., Ltd. 2023. 上海移远通信技术股份有限公司 2 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 关于文档 文档信息 标题 副标题 文档类别 文档状态 LG69T (AA,AD,AF,AI,AJ,AR)&LC29T (AA)&LC99T (IA)固件升级指导 GNSS 模块系列 固件升级指导 受控文件 修订记录 版本 日期 - 2022-11-29 1.0 2023-09-04 1.1 2023-12-15 变更描述 文档创建 受控版本 1. 更新擦除 Flash 程序区和 Flash NVM 区的主机软件超时时间（第 2.2.4 章）。 2. 新增使用 QGNSS 工具升级固件示例（第 4 章）。 上海移远通信技术股份有限公司 3 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 目录 关于文档 ........................................................................................................................................................ 3 目录 ............................................................................................................................................................... 4 表格索引 ........................................................................................................................................................ 5 图片索引 ........................................................................................................................................................ 6 1 引言 ........................................................................................................................................................ 7 1.1. 适用模块 ...................................................................................................................................... 8 2 固件升级流程.......................................................................................................................................... 9 2.1. 概述 ............................................................................................................................................. 9 2.1.1. 正常工作模式下的固件升级 .............................................................................................. 9 2.1.2. 恢复模式下的固件升级 ................................................................................................... 11 2.2. 流程 ........................................................................................................................................... 13 2.2.1. 发送固件升级命令 .......................................................................................................... 13 2.2.2. 同步 ................................................................................................................................ 14 2.2.3. 写入二进制镜像选项....................................................................................................... 15 2.2.4. 擦除 Flash 程序区和 Flash NVM 区 ............................................................................... 17 2.2.5. 发送固件包 ..................................................................................................................... 18 2.2.6. 执行 CRC 校验 ............................................................................................................... 19 3 固件升级示例........................................................................................................................................ 20 4 使用 QGNSS 工具升级固件示例.......................................................................................................... 22 5 附录 A CRC 32 计算 ............................................................................................................................ 28 6 附录 B 术语缩写 .................................................................................................................................. 30 7 附录 C 特殊符号 .................................................................................................................................. 31 上海移远通信技术股份有限公司 4 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 表格索引 表 1：适用模块 ............................................................................................................................................. 8 表 2：常量列表 ........................................................................................................................................... 13 表 3：术语缩写 ........................................................................................................................................... 30 表 4：特殊符号 ........................................................................................................................................... 31 上海移远通信技术股份有限公司 5 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 图片索引 图 1：固件升级连接...................................................................................................................................... 7 图 2：正常工作模式下的固件升级.............................................................................................................. 10 图 3：恢复模式下的固件升级 ..................................................................................................................... 12 图 4：同步 .................................................................................................................................................. 15 图 5：发送二进制镜像选项......................................................................................................................... 16 图 6：擦除 Flash 程序区和 Flash NVM 区 ................................................................................................. 17 图 7：发送固件包 ....................................................................................................................................... 18 图 8：CRC 校验 ......................................................................................................................................... 19 图 9：设备管理器 ....................................................................................................................................... 22 图 10：设备信息 ......................................................................................................................................... 23 图 11：固件下载 ......................................................................................................................................... 23 图 12：设置下载波特率 .............................................................................................................................. 24 图 13：加载固件 ......................................................................................................................................... 25 图 14：选择固件包 ..................................................................................................................................... 25 图 15：等待同步 ......................................................................................................................................... 26 图 16：同步成功 ......................................................................................................................................... 26 图 17：等待升级完成.................................................................................................................................. 27 图 18：升级完成 ......................................................................................................................................... 27 上海移远通信技术股份有限公司 6 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 1 引言 本文档介绍了 Quectel LG69T (AA, AD, AF, AI, AJ, AR)、LC29T (AA)和 LC99T (IA)的固件升级过程。 模块通过 UART 接口连接到主机后，即可启动固件升级流程。 主机 UART GNSS 模块 复位 图 1：固件升级连接 备注 若固件升级失败或用户停止固件升级流程，此时模块内没有可运行的固件，则需要使用恢复模式重新开 始固件升级流程。 上海移远通信技术股份有限公司 7 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 1.1. 适用模块 表 1：适用模块 模块系列 型号 LG69T (AA) LG69T (AD) LG69T LG69T (AF) LG69T (AI) LG69T (AJ) LG69T (AR) LC29T LC29T (AA) LC99T LC99T (IA) 上海移远通信技术股份有限公司 8 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 2 固件升级流程 2.1. 概述 2.1.1. 正常工作模式下的固件升级 在正常工作模式下升级固件时，主机向模块发送$PSTMFWUPGRADE*5B。模块成功响应后，将进入 固件升级模式。详细升级流程如下图所示。 上海移远通信技术股份有限公司 9 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 开始 主机通过 UART接口发送固件升级命令。 N 模块是否响应OK？ Y 模块进入固件升级模式，开始与主机同步 N 模块与主机是否同步成功？ Y 同步成功，主机发送二进制镜像选项。 主机和 模块根据选项配置更新UART接口波特率。 N 是否成功更新UART接口波特率？ Y 波特率更新成功，模块正在擦除Flash程序区。 N Flash程序区是否成功擦除？ Y Flash程序区成功擦除，模块正在擦除Flash NVM 区 N Flash NVM 区是否成功擦除？ Y 主机以多个16 KB的数据块循环发送固件数据 (最后一个数据块的大小等于剩余的字节数)。 N 固件包是否传输完成？ Y 模块计算 CRC 并将其与主机发送的值进行对比 N CRC校验是否成功？ Y 模块验证新固件并重新启动。 结束 主机退出固件升级流程。 升级失败，需要使用恢复模式重 新进行固件升级 图 2：正常工作模式下的固件升级 上海移远通信技术股份有限公司 10 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 2.1.2. 恢复模式下的固件升级 恢复模式用于在不使用 NMEA 语句的情况下升级固件。如，模块仅支持 RTCM 协议或模块因固件异常 无法进行 NMEA 协议交互，则需要使用恢复模式进行强制固件升级。升级开始前，模块处于复位状态或断 电状态。主机开始不断发送 FLASHER_IDENTIFIER 和 FLASHER_RESYNC 至模块直至模块退出复位状 态，或对模块进行上电操作。主机等待模块进入升级就绪状态并返回 FLASHER_SYNC，完成同步。后续 升级过程与正常工作模式下升级过程完全相同。 备注 RTCM 格式的固件升级必须在恢复模式下进行。在 RTCM 格式中，数据通过 UART 接口以二进制格式传 输。 上海移远通信技术股份有限公司 11 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 恢复模式下的固件升级流程如下图所示： 开始 模块与主机同步 N 模块与主机是否同步成功？ Y 同步成功，主机发送二进制镜像选项。 主机和 模块根据选项配置更新UART接口波特率。 N 是否成功更新UART接口波特率？ Y 波特率更新成功，模块正在擦除Flash程序区。 N Flash程序区是否成功擦除？ Y Flash程序区成功擦除，模块正在擦除Flash NVM 区 N Flash NVM 区是否成功擦除？ Y 主机以多个16 KB的数据块循环发送固件数据 (最后一个数据块的大小等于剩余的字节数)。 N 固件包是否传输完成？ Y 模块计算 CRC 并将其与主机发送的值进行对比 N CRC校验是否成功? Y 模块验证新固件并重新启动。 结束 主机退出固件升级流程。 升级失败，需要使用恢复模式重 新进行固件升级。 图 3：恢复模式下的固件升级 上海移远通信技术股份有限公司 12 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 2.2. 流程 除发送$PSTMFWUPGRADE*5B 升级命令外，在正常工作模式下和恢复模式下进行固件升级的步骤基 本相同。 下表定义了本文档中使用的所有常量。 表 2：常量列表 常量名 FLASHER_IDENTIFIER FLASHER_RESYNC FLASHER_SYNC DEVICE_START_COMMUNICATION FLASHER_READY ACK NAK NVM_FLASH_OFFSET NVM_FLASH_ERASE_SIZE 常量值 0xBCD501F4 0xFFFFFFFF 0x83984073 0xA3 0x4A 0xCC 0xDD 对于 2 MB FLASH：0x000FF000 对于 4 MB FLASH：0x001FF000 0x00101000 备注 1. 字节以小端格式传输。 2. 2 MB Flash 模块：LG69T (AA, AD, AI, AJ, AR)； 4 MB Flash 模块：LG69T (AF), LC29T (AA) 和 LC99T (IA)。 2.2.1. 发送固件升级命令 模块连接到主机后，主机会向模块发送$PSTMFWUPGRADE*5B 以在正常工作模式下初始化固件升 级。 类型： 命令 上海移远通信技术股份有限公司 13 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 格式： $PSTMFWUPGRADE* 参数： 无 结果： ⚫ 如果命令执行成功，模块将作出如下响应，表示当前固件将失效且模块将切换到固件升级模式，直至 新固件完成下载并得到验证： $PSTMFWUPGRADEOK ⚫ 如果命令执行失败，模块将作出如下响应，表示如果模块端出错，主机将退出升级： $PSTMFWUPGRADEERROR 备注 命令通过 UART 接口以字符串格式传输。 2.2.2. 同步 在正常工作模式下，模块接收到固件升级命令后进入固件升级模式，然后模块与主机进行同步。同步 阶段主机无延迟地持续发送 FLASHER_IDENTIFIER 和 FLASHER_RESYNC，同时检查模块是否响应 FLASHER_SYNC。如果在 15 秒主机没有收到模块的响应，则主机软件返回同步超时错误。主机收到 FLASHER_SYNC 后，会立即发送 DEVICE_START_COMMUNICATION 并等待模块的 ACK 响应，如果 在 10 秒内主机没有收到模块的响应，则主机软件返回超时错误。 在恢复模式下，升级开始前模块处于复位状态或断电状态。同步阶段主机无延迟地持续发送 FLASHER_IDENTIFIER 和 FLASHER_RESYNC，同时检查模块是否响应 FLASHER_SYNC。模块退出 复位状态或对模块进行上电操作后，若主机在 5 秒未接收到 FLASHER_SYNC，需让模块重新进入复位状 态或断电状态，并重复上述同步操作过程。如果在 3 次循环操作过程中，主机仍没有收到模块的响应，则 主 机 软 件 将 会 上 报 同 步 超 时 错 误 ； 若 主 机 收 到 FLASHER_SYNC ， 会 立 即 发 送 DEVICE_START_COMMUNICATION 并等待模块响应 ACK，如果在 10 秒内主机没有收到模块的响应， 则主机软件将会上报超时错误。 上海移远通信技术股份有限公司 14 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 主机 模块 ... 模块与主机同步成功 图 4：同步 2.2.3. 写入二进制镜像选项 与模块同步后，主机须发送如下所示的二进制镜像选项： //二进制镜像选项 struct ImageOptions { byte eraseNVM; byte programOnly; byte reserved; byte baudRate; int firmwareSize; uint firmwareCRC; int nvmAddressOffset; int nvmSize; }; 最大10秒 上海移远通信技术股份有限公司 15 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 参数： 类型 byte byte byte byte int uint int int 字段 描述 eraseNVM programOnly 升级时是否擦除 Flash NVM。 0 = 不擦除 1 = 擦除 刷新固件后是否擦除 Flash 程序区。 0 = 刷新并擦除 1 = 刷新不擦除 reserved 固定为 0。 baudRate UART 接口用于下载固件的新波特率。 1 = 115200 bps 2 = 230400 bps firmwareSize 固件二进制镜像文件大小（小端格式）；单位：字节。 firmwareCRC CRC32 校验码（小端模式），先基于固件大小（小端模式）计算，再基于整 个固件计算得到该校验码。 nvmAddressOffset 设置为 NVM_FLASH_OFFSET（小端格式）。见表 2：常量列表。 nvmSize 设置为 NVM_FLASH_ERASE_SIZE（小端格式）。见表 2：常量列表。 主机写入二进制镜像选项的流程如下图所示： 主机 发送二进制镜像选项 模块 间隔 500毫秒 最大50次 主机和模块更新UART接口波特率。 FLASH_READY FLASH_READY ... FLASH_READY ACK ACK 图 5：发送二进制镜像选项 上海移远通信技术股份有限公司 16 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 备注 主机波特率应与模块二进制镜像选项中配置的波特率相同。 2.2.4. 擦除 Flash 程序区和 Flash NVM 区 如果 programOnly 字段设置为 0，主机须等待模块响应 ACK，以确认 Flash 程序区已被擦除。 如果 eraseNVM 字段设置为 1，主机须等待模块响应 ACK，以确认 Flash NVM 区已被擦除。 在这两种情况下，主机软件的超时时间均为 60 秒。如果在这个时间段内没有收到模块的响应，主机将 因超时而报错。 主机 模块 等待成功擦除FLash程序区 ACK 最大 60 秒 成功擦除Flash程序区，等待成功 擦除Flash NVM区 ACK 最大 60 秒 成功擦除Flash NVM区 图 6：擦除 Flash 程序区和 Flash NVM 区 上海移远通信技术股份有限公司 17 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 2.2.5. 发送固件包 在此阶段，主机将固件包发送给模块，以便在模块的 Flash 内进行升级。运行在主机上的软件将固件 包（二进制镜像文件）分为多个 16 KB 的数据块。最后一个数据块的大小等于剩余的字节数。每个数据块 发送成功至模块后，模块都会响应 ACK。主机超时时间为 100 秒。如果在这个时间段内主机没有收到模块 的响应，主机将因超时而报错。 主机 主机将固件包分为多个16 KB的数据块 发送至模块 发送第一个数据块 （16 KB） ACK 发送第二个数据块 （16 KB） ACK ... 发送最后一个数据块 （< = 16 KB） ACK 固件包发送完成 模块 最大100秒 最大100秒 最大100秒 图 7：发送固件包 上海移远通信技术股份有限公司 18 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 2.2.6. 执行 CRC 校验 在此阶段，模块的引导加载程序对主机发送的二进制镜像文件执行 CRC 错误检查（约 60 秒）。如果校 验成功，模块将向主机发送 ACK 响应，表明下载的新固件已被验证。如果校验失败，模块将返回 NAK。 在这两种情况下，模块都会重新启动。有关 CRC 代码详情，请参考第 5 章 附录 A CRC 32 计算。 主机 模块对接收到的固件包进行 CRC校验 ACK 模块 最大 60 秒 模块自动重启 图 8：CRC 校验 上海移远通信技术股份有限公司 19 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 3 固件升级示例 本章提供实现固件升级的示例。 //主机发送升级命令：$PSTMFWUPGRADE*5B 24 50 53 54 4D 46 57 55 50 47 52 41 44 45 2A 35 42 0D 0A //模块响应$PSTMFWUPGRADEOK 24 50 53 54 4D 46 57 55 50 47 52 41 44 45 4F 4B 0D 0A //主机持续发送 FLASHER_IDENTIFIER 和 FLASHER_RESYNC F4 01 D5 BC FF FF FF FF F4 01 D5 BC FF FF FF FF … F4 01 D5 BC FF FF FF FF F4 01 D5 BC FF FF FF FF //模块响应 FLASHER_SYNC 73 40 98 83 //主机发送 DEVICE_START_COMMUNICATION A3 //模块响应 ACK CC //主机发送二进制镜像选项将 UART 接口波特率设置为 115200 bps。 2 M Flash：01 00 00 01 3C AD 0D 00 A6 AF 66 C2 00 F0 0F 00 00 10 10 00 4 M Flash：01 00 00 01 E8 EE 0D 00 1D BF 4D 58 00 F0 1F 00 00 10 10 00 //主机和模块更新波特率为 115200 bps。 //主机持续发送 FLASHER_READY，直至模块响应 4A //模块以 115200 波特率响应两个 ACK CC CC //Flash 程序区成功擦除后，模块响应 ACK CC //成功擦除 Flash NVM 区后，模块响应 ACK CC //主机发送第一个数据块（16 KB） 55 55 55 55 00 04 01 00 88 5E 0C 00 BA 47 35 F7 FF FF FF FF FF FF FF FF FF FF FF FF FC … 上海移远通信技术股份有限公司 20 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 //模块响应 ACK CC //主机发送第二个数据块（16 KB） 02 E0 B8 F1 00 0F 06 D0 23 A9 93 A8 41 F8 26 90 40 F8 26 50 26 E0 0D F5 80 50 D0 F8 08 02 … //模块响应 ACK。 CC … //主机发送最后一个数据块 11 D1 28 F4 40 40 A0 F2 53 30 2D 28 4F EA 98 31 01 D8 01 20 00 E0 00 20 28 B1 21 B9 00 98 … //模块响应 ACK CC //若 CRC 校验成功，模块响应 ACK CC //模块自动重启 上海移远通信技术股份有限公司 21 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 4 使用 QGNSS 工具升级固件示例 本章节以 LG69T (AD)模块为例，介绍使用 QGNSS 工具对模块进行固件升级的主要步骤。 注意： 升级固件前，请确保模块已连接 PC 并正常上电。正常连接并上电后，可在'设备管理器'中查看模块 所使用的端口，如下图所示： 图 9：设备管理器 固件升级步骤详情如下： 步骤 1 打开 QGNSS 工具后，点击 进入'Device Information'窗口，详见图 10：设备信息。 步骤 2 选择待升级模块的型号。 步骤 3 选择对应的端口号。 步骤 4 选择通信波特率，默认波特率：460800 bps。 步骤 5 点击'OK'。 上海移远通信技术股份有限公司 22 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 图 10：设备信息 步骤 6 点击工具栏中的'Tools'，详见图 11：固件下载。 步骤 7 点击'Tools'下拉菜单中的'Firmware Download'。 图 11：固件下载 上海移远通信技术股份有限公司 23 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 步骤 8 在新窗口中点击工具栏上的'Settings'，详见图 12：设置下载波特率。 步骤 9 点击'Settings'下拉菜单中的'Download Baudrate'，设置下载波特率。 步骤 10 选择下载的波特率为 115200 bps。 图 12：设置下载波特率 步骤 11 点击 升级模块固件，详见图 13：加载固件。 步骤 12 点击 选择升级使用的固件包，固件包名称后缀为 UPG，详见图 14：选择固件包。 步骤 13 仅 支 持 RTCM 协 议 的 模 块 进 行 固 件 升 级 时 ， 需 勾 选 ' Recovery ' 前 面 的 复 选 框 ， 详 见 图 13：加载固件。支持 NMEA 协议的模块进行固件升级时，可选择勾选或不勾选该复选框。 上海移远通信技术股份有限公司 24 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 步骤 14 点击 开始固件升级： 1. 若在步骤 13 中勾选'Recovery'前面的复选框，则需在 5 秒内重启模块。若未在规定时间 内重启模块，则会出现同步失败的情况，此时可再次操作步骤 14 重新进行固件升级。若在规 定时间内重启模块，则会出现等待模块与 PC 同步信息和进度条，详见图 15：等待同步。 2. 若在步骤 13 中未勾选'Recovery'前面的复选框，则无需重启模块且固件升级后续流程将会 自动进行。 图 13：加载固件 图 14：选择固件包 上海移远通信技术股份有限公司 25 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 图 15：等待同步 步骤 15 同步成功，等待开始固件升级。 图 16：同步成功 上海移远通信技术股份有限公司 26 / 31 步骤 16 等待升级完成。 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 步骤 17 升级完成。 图 17：等待升级完成 上海移远通信技术股份有限公司 图 18：升级完成 27 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 5 附录 A CRC 32 计算 //CRC32 algorithm. const uint32_t crc32_tab[] = { 0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419, 0x706af48f, 0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4, 0xe0d5e91e, 0x97d2d988, 0x09b64c2b, 0x7eb17cbd, 0xe7b82d07, 0x90bf1d91, 0x1db71064, 0x6ab020f2, 0xf3b97148, 0x84be41de, 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7, 0x136c9856, 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9, 0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4, 0xa2677172, 0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b, 0x35b5a8fa, 0x42b2986c, 0xdbbbc9d6, 0xacbcf940, 0x32d86ce3, 0x45df5c75, 0xdcd60dcf, 0xabd13d59, 0x26d930ac, 0x51de003a, 0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423, 0xcfba9599, 0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924, 0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190, 0x01db7106, 0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f, 0x9fbfe4a5, 0xe8b8d433, 0x7807c9a2, 0x0f00f934, 0x9609a88e, 0xe10e9818, 0x7f6a0dbb, 0x086d3d2d, 0x91646c97, 0xe6635c01, 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e, 0x6c0695ed, 0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950, 0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3, 0xfbd44c65, 0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2, 0x4adfa541, 0x3dd895d7, 0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a, 0x346ed9fc, 0xad678846, 0xda60b8d0, 0x44042d73, 0x33031de5, 0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa, 0xbe0b1010, 0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f, 0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17, 0x2eb40d81, 0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6, 0x03b6e20c, 0x74b1d29a, 0xead54739, 0x9dd277af, 0x04db2615, 0x73dc1683, 0xe3630b12, 0x94643b84, 0x0d6d6a3e, 0x7a6a5aa8, 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1, 0xf00f9344, 0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb, 0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a, 0x67dd4acc, 0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5, 0xd6d6a3e8, 0xa1d1937e, 0x38d8c2c4, 0x4fdff252, 0xd1bb67f1, 0xa6bc5767, 0x3fb506dd, 0x48b2364b, 0xd80d2bda, 0xaf0a1b4c, 上海移远通信技术股份有限公司 28 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55, 0x316e8eef, 0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236, 0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe, 0xb2bd0b28, 0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31, 0x2cd99e8b, 0x5bdeae1d, 0x9b64c2b0, 0xec63f226, 0x756aa39c, 0x026d930a, 0x9c0906a9, 0xeb0e363f, 0x72076785, 0x05005713, 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38, 0x92d28e9b, 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242, 0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1, 0x18b74777, 0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c, 0x8f659eff, 0xf862ae69, 0x616bffd3, 0x166ccf45, 0xa00ae278, 0xd70dd2ee, 0x4e048354, 0x3903b3c2, 0xa7672661, 0xd06016f7, 0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc, 0x40df0b66, 0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9, 0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605, 0xcdd70693, 0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8, 0x5d681b02, 0x2a6f2b94, 0xb40bbe37, 0xc30c8ea1, 0x5a05df1b, 0x2d02ef8d }; uint32_t Ql_Check_CRC32(uint32_t Val, const unsigned char *Data, int32_t Offset, int32_t Length) { uint32_t result = Val ^ 0xFFFFFFFF; uint32_t i = 0; for (i = Offset; i < (Offset + Length); i++) { result = crc32_tab[(result ^ Data[i]) & 0xFF] ^ (result >> 8); } return (result ^ 0xFFFFFFFF); } 上海移远通信技术股份有限公司 29 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 6 附录 B 术语缩写 表 3：术语缩写 缩写 英文全称 中文全称 ACK CRC GNSS NAK NMEA NVM RTCM UART Acknowledgement 确认消息 Cyclic Redundancy Check CRC 校验(循环冗余校验) Global Navigation Satellite System 全球卫星导航系统 Negative Acknowledgement 否定应答 NMEA (National Marine Electronics NMEA（美国国家海洋电子协会）0183 接 Association) 0183 Interface Standard 口标准 Non-Volatile Memory 非易失性存储器 Radio Technical Commission for Maritime 海事无线电技术委员会 Services Universal Asynchronous Receiver/Transmitter 通用异步收发传输器 上海移远通信技术股份有限公司 30 / 31 LG69T(AA,AD,AF,AI,AJ,AR)&LC29T(AA)&LC99T(IA)固件升级指导 7 附录 C 特殊符号 表 4：特殊符号 特殊符号 [...] {…} 下划线 描述 回车符 换行符 参数名称（实际命令行中不包含尖括号） 可选参数（实际命令行中不包含中括号） 循环参数（实际命令行中不包含大括号） 参数的默认设置 上海移远通信技术股份有限公司 31 / 31